forked from evanw/esbuild
-
Notifications
You must be signed in to change notification settings - Fork 0
/
api.go
252 lines (215 loc) · 4.88 KB
/
api.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
// This API exposes esbuild's two main operations: building and transforming.
// It's intended for integrating esbuild into other tools as a library.
//
// If you are just trying to run esbuild from Go without the overhead of
// creating a child process, there is also an API for the command-line
// interface itself: https://godoc.org/github.com/evanw/esbuild/pkg/cli.
//
// Build API
//
// This function runs an end-to-end build operation. It takes an array of file
// paths as entry points, parses them and all of their dependencies, and
// returns the output files to write to the file system. The available options
// roughly correspond to esbuild's command-line flags.
//
// Example usage:
//
// package main
//
// import (
// "fmt"
// "io/ioutil"
//
// "github.com/evanw/esbuild/pkg/api"
// )
//
// func main() {
// result := api.Build(api.BuildOptions{
// EntryPoints: []string{"input.js"},
// Outfile: "output.js",
// Bundle: true,
// })
//
// fmt.Printf("%d errors and %d warnings\n",
// len(result.Errors), len(result.Warnings))
//
// for _, out := range result.OutputFiles {
// ioutil.WriteFile(out.Path, out.Contents, 0644)
// }
// }
//
// Transform API
//
// This function transforms a string of source code into JavaScript. It can be
// used to minify JavaScript, convert TypeScript/JSX to JavaScript, or convert
// newer JavaScript to older JavaScript. The available options roughly
// correspond to esbuild's command-line flags.
//
// Example usage:
//
// package main
//
// import (
// "fmt"
// "os"
//
// "github.com/evanw/esbuild/pkg/api"
// )
//
// func main() {
// jsx := `
// import * as React from 'react'
// import * as ReactDOM from 'react-dom'
//
// ReactDOM.render(
// <h1>Hello, world!</h1>,
// document.getElementById('root')
// );
// `
//
// result := api.Transform(jsx, api.TransformOptions{
// Loader: api.LoaderJSX,
// })
//
// fmt.Printf("%d errors and %d warnings\n",
// len(result.Errors), len(result.Warnings))
//
// os.Stdout.Write(result.JS)
// }
//
package api
type SourceMap uint8
const (
SourceMapNone SourceMap = iota
SourceMapInline
SourceMapLinked
SourceMapExternal
)
type Target uint8
const (
ESNext Target = iota
ES2015
ES2016
ES2017
ES2018
ES2019
ES2020
)
type Loader uint8
const (
LoaderJS Loader = iota
LoaderJSX
LoaderTS
LoaderTSX
LoaderJSON
LoaderText
LoaderBase64
LoaderDataURL
LoaderFile
)
type Platform uint8
const (
PlatformBrowser Platform = iota
PlatformNode
)
type Format uint8
const (
FormatDefault Format = iota
FormatIIFE
FormatCommonJS
FormatESModule
)
type Location struct {
File string
Line int // 1-based
Column int // 0-based, in bytes
Length int // in bytes
LineText string
}
type Message struct {
Text string
Location *Location
}
type StderrColor uint8
const (
ColorIfTerminal StderrColor = iota
ColorNever
ColorAlways
)
type LogLevel uint8
const (
LogLevelSilent LogLevel = iota
LogLevelInfo
LogLevelWarning
LogLevelError
)
type StrictOptions struct {
NullishCoalescing bool
ClassFields bool
}
////////////////////////////////////////////////////////////////////////////////
// Build API
type BuildOptions struct {
Color StderrColor
ErrorLimit int
LogLevel LogLevel
Sourcemap SourceMap
Target Target
Strict StrictOptions
MinifyWhitespace bool
MinifyIdentifiers bool
MinifySyntax bool
JSXFactory string
JSXFragment string
Defines map[string]string
GlobalName string
Bundle bool
Outfile string
Metafile string
Outdir string
Platform Platform
Format Format
Externals []string
Loaders map[string]Loader
ResolveExtensions []string
EntryPoints []string
}
type BuildResult struct {
Errors []Message
Warnings []Message
OutputFiles []OutputFile
}
type OutputFile struct {
Path string
Contents []byte
}
func Build(options BuildOptions) BuildResult {
return buildImpl(options)
}
////////////////////////////////////////////////////////////////////////////////
// Transform API
type TransformOptions struct {
Color StderrColor
ErrorLimit int
LogLevel LogLevel
Sourcemap SourceMap
Target Target
Strict StrictOptions
MinifyWhitespace bool
MinifyIdentifiers bool
MinifySyntax bool
JSXFactory string
JSXFragment string
Defines map[string]string
Sourcefile string
Loader Loader
}
type TransformResult struct {
Errors []Message
Warnings []Message
JS []byte
JSSourceMap []byte
}
func Transform(input string, options TransformOptions) TransformResult {
return transformImpl(input, options)
}