esbuild 0.17.0 → 0.17.2

package/bin/esbuild

@@ -198,7 +198,7 @@ for your current platform.`);
         "node_modules",
         ".cache",
         "esbuild",
-        `pnpapi-${pkg.replace("/", "-")}-${"0.17.0"}-${path.basename(subpath)}`
+        `pnpapi-${pkg.replace("/", "-")}-${"0.17.2"}-${path.basename(subpath)}`
       );
       if (!fs.existsSync(binTargetPath)) {
         fs.mkdirSync(path.dirname(binTargetPath), { recursive: true });

package/install.js

@@ -126,8 +126,8 @@ which means the "esbuild" binary executable can't be run. You can either:
     }
     throw err;
   }
-  if (stdout !== "0.17.0") {
-    throw new Error(`Expected ${JSON.stringify("0.17.0")} but got ${JSON.stringify(stdout)}`);
+  if (stdout !== "0.17.2") {
+    throw new Error(`Expected ${JSON.stringify("0.17.2")} but got ${JSON.stringify(stdout)}`);
   }
 }
 function isYarn() {
@@ -179,7 +179,7 @@ function installUsingNPM(pkg, subpath, binPath) {
   try {
     fs2.writeFileSync(path2.join(installDir, "package.json"), "{}");
     child_process.execSync(
-      `npm install --loglevel=error --prefer-offline --no-audit --progress=false ${pkg}@${"0.17.0"}`,
+      `npm install --loglevel=error --prefer-offline --no-audit --progress=false ${pkg}@${"0.17.2"}`,
       { cwd: installDir, stdio: "pipe", env }
     );
     const installedBinPath = path2.join(installDir, "node_modules", pkg, subpath);
@@ -230,7 +230,7 @@ function maybeOptimizePackage(binPath) {
   }
 }
 async function downloadDirectlyFromNPM(pkg, subpath, binPath) {
-  const url = `https://registry.npmjs.org/${pkg}/-/${pkg.replace("@esbuild/", "")}-${"0.17.0"}.tgz`;
+  const url = `https://registry.npmjs.org/${pkg}/-/${pkg.replace("@esbuild/", "")}-${"0.17.2"}.tgz`;
   console.error(`[esbuild] Trying to download ${JSON.stringify(url)}`);
   try {
     fs2.writeFileSync(binPath, extractFileFromTarGzip(await fetch(url), subpath));

package/lib/main.d.ts

@@ -1,235 +1,235 @@
-export type Platform = 'browser' | 'node' | 'neutral';
-export type Format = 'iife' | 'cjs' | 'esm';
-export type Loader = 'base64' | 'binary' | 'copy' | 'css' | 'dataurl' | 'default' | 'empty' | 'file' | 'js' | 'json' | 'jsx' | 'text' | 'ts' | 'tsx';
-export type LogLevel = 'verbose' | 'debug' | 'info' | 'warning' | 'error' | 'silent';
-export type Charset = 'ascii' | 'utf8';
-export type Drop = 'console' | 'debugger';
+export type Platform = 'browser' | 'node' | 'neutral'
+export type Format = 'iife' | 'cjs' | 'esm'
+export type Loader = 'base64' | 'binary' | 'copy' | 'css' | 'dataurl' | 'default' | 'empty' | 'file' | 'js' | 'json' | 'jsx' | 'text' | 'ts' | 'tsx'
+export type LogLevel = 'verbose' | 'debug' | 'info' | 'warning' | 'error' | 'silent'
+export type Charset = 'ascii' | 'utf8'
+export type Drop = 'console' | 'debugger'
 
 interface CommonOptions {
   /** Documentation: https://esbuild.github.io/api/#sourcemap */
-  sourcemap?: boolean | 'linked' | 'inline' | 'external' | 'both';
+  sourcemap?: boolean | 'linked' | 'inline' | 'external' | 'both'
   /** Documentation: https://esbuild.github.io/api/#legal-comments */
-  legalComments?: 'none' | 'inline' | 'eof' | 'linked' | 'external';
+  legalComments?: 'none' | 'inline' | 'eof' | 'linked' | 'external'
   /** Documentation: https://esbuild.github.io/api/#source-root */
-  sourceRoot?: string;
+  sourceRoot?: string
   /** Documentation: https://esbuild.github.io/api/#sources-content */
-  sourcesContent?: boolean;
+  sourcesContent?: boolean
 
   /** Documentation: https://esbuild.github.io/api/#format */
-  format?: Format;
+  format?: Format
   /** Documentation: https://esbuild.github.io/api/#global-name */
-  globalName?: string;
+  globalName?: string
   /** Documentation: https://esbuild.github.io/api/#target */
-  target?: string | string[];
+  target?: string | string[]
   /** Documentation: https://esbuild.github.io/api/#supported */
-  supported?: Record<string, boolean>;
+  supported?: Record<string, boolean>
   /** Documentation: https://esbuild.github.io/api/#platform */
-  platform?: Platform;
+  platform?: Platform
 
   /** Documentation: https://esbuild.github.io/api/#mangle-props */
-  mangleProps?: RegExp;
+  mangleProps?: RegExp
   /** Documentation: https://esbuild.github.io/api/#mangle-props */
-  reserveProps?: RegExp;
+  reserveProps?: RegExp
   /** Documentation: https://esbuild.github.io/api/#mangle-props */
-  mangleQuoted?: boolean;
+  mangleQuoted?: boolean
   /** Documentation: https://esbuild.github.io/api/#mangle-props */
-  mangleCache?: Record<string, string | false>;
+  mangleCache?: Record<string, string | false>
   /** Documentation: https://esbuild.github.io/api/#drop */
-  drop?: Drop[];
+  drop?: Drop[]
   /** Documentation: https://esbuild.github.io/api/#minify */
-  minify?: boolean;
+  minify?: boolean
   /** Documentation: https://esbuild.github.io/api/#minify */
-  minifyWhitespace?: boolean;
+  minifyWhitespace?: boolean
   /** Documentation: https://esbuild.github.io/api/#minify */
-  minifyIdentifiers?: boolean;
+  minifyIdentifiers?: boolean
   /** Documentation: https://esbuild.github.io/api/#minify */
-  minifySyntax?: boolean;
+  minifySyntax?: boolean
   /** Documentation: https://esbuild.github.io/api/#charset */
-  charset?: Charset;
+  charset?: Charset
   /** Documentation: https://esbuild.github.io/api/#tree-shaking */
-  treeShaking?: boolean;
+  treeShaking?: boolean
   /** Documentation: https://esbuild.github.io/api/#ignore-annotations */
-  ignoreAnnotations?: boolean;
+  ignoreAnnotations?: boolean
 
   /** Documentation: https://esbuild.github.io/api/#jsx */
-  jsx?: 'transform' | 'preserve' | 'automatic';
+  jsx?: 'transform' | 'preserve' | 'automatic'
   /** Documentation: https://esbuild.github.io/api/#jsx-factory */
-  jsxFactory?: string;
+  jsxFactory?: string
   /** Documentation: https://esbuild.github.io/api/#jsx-fragment */
-  jsxFragment?: string;
+  jsxFragment?: string
   /** Documentation: https://esbuild.github.io/api/#jsx-import-source */
-  jsxImportSource?: string;
+  jsxImportSource?: string
   /** Documentation: https://esbuild.github.io/api/#jsx-development */
-  jsxDev?: boolean;
+  jsxDev?: boolean
   /** Documentation: https://esbuild.github.io/api/#jsx-side-effects */
-  jsxSideEffects?: boolean;
+  jsxSideEffects?: boolean
 
   /** Documentation: https://esbuild.github.io/api/#define */
-  define?: { [key: string]: string };
+  define?: { [key: string]: string }
   /** Documentation: https://esbuild.github.io/api/#pure */
-  pure?: string[];
+  pure?: string[]
   /** Documentation: https://esbuild.github.io/api/#keep-names */
-  keepNames?: boolean;
+  keepNames?: boolean
 
   /** Documentation: https://esbuild.github.io/api/#color */
-  color?: boolean;
+  color?: boolean
   /** Documentation: https://esbuild.github.io/api/#log-level */
-  logLevel?: LogLevel;
+  logLevel?: LogLevel
   /** Documentation: https://esbuild.github.io/api/#log-limit */
-  logLimit?: number;
+  logLimit?: number
   /** Documentation: https://esbuild.github.io/api/#log-override */
-  logOverride?: Record<string, LogLevel>;
+  logOverride?: Record<string, LogLevel>
 }
 
 export interface BuildOptions extends CommonOptions {
   /** Documentation: https://esbuild.github.io/api/#bundle */
-  bundle?: boolean;
+  bundle?: boolean
   /** Documentation: https://esbuild.github.io/api/#splitting */
-  splitting?: boolean;
+  splitting?: boolean
   /** Documentation: https://esbuild.github.io/api/#preserve-symlinks */
-  preserveSymlinks?: boolean;
+  preserveSymlinks?: boolean
   /** Documentation: https://esbuild.github.io/api/#outfile */
-  outfile?: string;
+  outfile?: string
   /** Documentation: https://esbuild.github.io/api/#metafile */
-  metafile?: boolean;
+  metafile?: boolean
   /** Documentation: https://esbuild.github.io/api/#outdir */
-  outdir?: string;
+  outdir?: string
   /** Documentation: https://esbuild.github.io/api/#outbase */
-  outbase?: string;
+  outbase?: string
   /** Documentation: https://esbuild.github.io/api/#external */
-  external?: string[];
+  external?: string[]
   /** Documentation: https://esbuild.github.io/api/#packages */
-  packages?: 'external';
+  packages?: 'external'
   /** Documentation: https://esbuild.github.io/api/#alias */
-  alias?: Record<string, string>;
+  alias?: Record<string, string>
   /** Documentation: https://esbuild.github.io/api/#loader */
-  loader?: { [ext: string]: Loader };
+  loader?: { [ext: string]: Loader }
   /** Documentation: https://esbuild.github.io/api/#resolve-extensions */
-  resolveExtensions?: string[];
+  resolveExtensions?: string[]
   /** Documentation: https://esbuild.github.io/api/#main-fields */
-  mainFields?: string[];
+  mainFields?: string[]
   /** Documentation: https://esbuild.github.io/api/#conditions */
-  conditions?: string[];
+  conditions?: string[]
   /** Documentation: https://esbuild.github.io/api/#write */
-  write?: boolean;
+  write?: boolean
   /** Documentation: https://esbuild.github.io/api/#allow-overwrite */
-  allowOverwrite?: boolean;
+  allowOverwrite?: boolean
   /** Documentation: https://esbuild.github.io/api/#tsconfig */
-  tsconfig?: string;
+  tsconfig?: string
   /** Documentation: https://esbuild.github.io/api/#out-extension */
-  outExtension?: { [ext: string]: string };
+  outExtension?: { [ext: string]: string }
   /** Documentation: https://esbuild.github.io/api/#public-path */
-  publicPath?: string;
+  publicPath?: string
   /** Documentation: https://esbuild.github.io/api/#entry-names */
-  entryNames?: string;
+  entryNames?: string
   /** Documentation: https://esbuild.github.io/api/#chunk-names */
-  chunkNames?: string;
+  chunkNames?: string
   /** Documentation: https://esbuild.github.io/api/#asset-names */
-  assetNames?: string;
+  assetNames?: string
   /** Documentation: https://esbuild.github.io/api/#inject */
-  inject?: string[];
+  inject?: string[]
   /** Documentation: https://esbuild.github.io/api/#banner */
-  banner?: { [type: string]: string };
+  banner?: { [type: string]: string }
   /** Documentation: https://esbuild.github.io/api/#footer */
-  footer?: { [type: string]: string };
+  footer?: { [type: string]: string }
   /** Documentation: https://esbuild.github.io/api/#entry-points */
-  entryPoints?: string[] | Record<string, string>;
+  entryPoints?: string[] | Record<string, string> | { in: string, out: string }[]
   /** Documentation: https://esbuild.github.io/api/#stdin */
-  stdin?: StdinOptions;
+  stdin?: StdinOptions
   /** Documentation: https://esbuild.github.io/plugins/ */
-  plugins?: Plugin[];
+  plugins?: Plugin[]
   /** Documentation: https://esbuild.github.io/api/#working-directory */
-  absWorkingDir?: string;
+  absWorkingDir?: string
   /** Documentation: https://esbuild.github.io/api/#node-paths */
   nodePaths?: string[]; // The "NODE_PATH" variable from Node.js
 }
 
 export interface StdinOptions {
-  contents: string | Uint8Array;
-  resolveDir?: string;
-  sourcefile?: string;
-  loader?: Loader;
+  contents: string | Uint8Array
+  resolveDir?: string
+  sourcefile?: string
+  loader?: Loader
 }
 
 export interface Message {
-  id: string;
-  pluginName: string;
-  text: string;
-  location: Location | null;
-  notes: Note[];
+  id: string
+  pluginName: string
+  text: string
+  location: Location | null
+  notes: Note[]
 
   /**
    * Optional user-specified data that is passed through unmodified. You can
    * use this to stash the original error, for example.
    */
-  detail: any;
+  detail: any
 }
 
 export interface Note {
-  text: string;
-  location: Location | null;
+  text: string
+  location: Location | null
 }
 
 export interface Location {
-  file: string;
-  namespace: string;
+  file: string
+  namespace: string
   /** 1-based */
-  line: number;
+  line: number
   /** 0-based, in bytes */
-  column: number;
+  column: number
   /** in bytes */
-  length: number;
-  lineText: string;
-  suggestion: string;
+  length: number
+  lineText: string
+  suggestion: string
 }
 
 export interface OutputFile {
-  path: string;
+  path: string
   /** "text" as bytes */
-  contents: Uint8Array;
+  contents: Uint8Array
   /** "contents" as text (changes automatically with "contents") */
-  readonly text: string;
+  readonly text: string
 }
 
 export interface BuildResult<SpecificOptions extends BuildOptions = BuildOptions> {
-  errors: Message[];
-  warnings: Message[];
+  errors: Message[]
+  warnings: Message[]
   /** Only when "write: false" */
-  outputFiles: OutputFile[] | (SpecificOptions['write'] extends false ? never : undefined);
+  outputFiles: OutputFile[] | (SpecificOptions['write'] extends false ? never : undefined)
   /** Only when "metafile: true" */
-  metafile: Metafile | (SpecificOptions['metafile'] extends true ? never : undefined);
+  metafile: Metafile | (SpecificOptions['metafile'] extends true ? never : undefined)
   /** Only when "mangleCache" is present */
-  mangleCache: Record<string, string | false> | (SpecificOptions['mangleCache'] extends Object ? never : undefined);
+  mangleCache: Record<string, string | false> | (SpecificOptions['mangleCache'] extends Object ? never : undefined)
 }
 
 export interface BuildFailure extends Error {
-  errors: Message[];
-  warnings: Message[];
+  errors: Message[]
+  warnings: Message[]
 }
 
 /** Documentation: https://esbuild.github.io/api/#serve-arguments */
 export interface ServeOptions {
-  port?: number;
-  host?: string;
-  servedir?: string;
+  port?: number
+  host?: string
+  servedir?: string
   keyfile?: string
   certfile?: string
-  onRequest?: (args: ServeOnRequestArgs) => void;
+  onRequest?: (args: ServeOnRequestArgs) => void
 }
 
 export interface ServeOnRequestArgs {
-  remoteAddress: string;
-  method: string;
-  path: string;
-  status: number;
+  remoteAddress: string
+  method: string
+  path: string
+  status: number
   /** The time to generate the response, not to send it */
-  timeInMS: number;
+  timeInMS: number
 }
 
 /** Documentation: https://esbuild.github.io/api/#serve-return-values */
 export interface ServeResult {
-  port: number;
-  host: string;
+  port: number
+  host: string
 }
 
 export interface TransformOptions extends CommonOptions {
@@ -245,46 +245,59 @@ export interface TransformOptions extends CommonOptions {
       target?: string,
       useDefineForClassFields?: boolean,
     },
-  };
+  }
 
-  sourcefile?: string;
-  loader?: Loader;
-  banner?: string;
-  footer?: string;
+  sourcefile?: string
+  loader?: Loader
+  banner?: string
+  footer?: string
 }
 
 export interface TransformResult<SpecificOptions extends TransformOptions = TransformOptions> {
-  code: string;
-  map: string;
-  warnings: Message[];
+  code: string
+  map: string
+  warnings: Message[]
   /** Only when "mangleCache" is present */
-  mangleCache: Record<string, string | false> | (SpecificOptions['mangleCache'] extends Object ? never : undefined);
+  mangleCache: Record<string, string | false> | (SpecificOptions['mangleCache'] extends Object ? never : undefined)
   /** Only when "legalComments" is "external" */
-  legalComments: string | (SpecificOptions['legalComments'] extends 'external' ? never : undefined);
+  legalComments: string | (SpecificOptions['legalComments'] extends 'external' ? never : undefined)
 }
 
 export interface TransformFailure extends Error {
-  errors: Message[];
-  warnings: Message[];
+  errors: Message[]
+  warnings: Message[]
 }
 
 export interface Plugin {
-  name: string;
-  setup: (build: PluginBuild) => (void | Promise<void>);
+  name: string
+  setup: (build: PluginBuild) => (void | Promise<void>)
 }
 
 export interface PluginBuild {
-  initialOptions: BuildOptions;
-  resolve(path: string, options?: ResolveOptions): Promise<ResolveResult>;
+  /** Documentation: https://esbuild.github.io/plugins/#build-options */
+  initialOptions: BuildOptions
+
+  /** Documentation: https://esbuild.github.io/plugins/#resolve */
+  resolve(path: string, options?: ResolveOptions): Promise<ResolveResult>
 
+  /** Documentation: https://esbuild.github.io/plugins/#on-start */
   onStart(callback: () =>
-    (OnStartResult | null | void | Promise<OnStartResult | null | void>)): void;
+    (OnStartResult | null | void | Promise<OnStartResult | null | void>)): void
+
+  /** Documentation: https://esbuild.github.io/plugins/#on-end */
   onEnd(callback: (result: BuildResult) =>
-    (OnEndResult | null | void | Promise<OnEndResult | null | void>)): void;
+    (OnEndResult | null | void | Promise<OnEndResult | null | void>)): void
+
+  /** Documentation: https://esbuild.github.io/plugins/#on-resolve */
   onResolve(options: OnResolveOptions, callback: (args: OnResolveArgs) =>
-    (OnResolveResult | null | undefined | Promise<OnResolveResult | null | undefined>)): void;
+    (OnResolveResult | null | undefined | Promise<OnResolveResult | null | undefined>)): void
+
+  /** Documentation: https://esbuild.github.io/plugins/#on-load */
   onLoad(options: OnLoadOptions, callback: (args: OnLoadArgs) =>
-    (OnLoadResult | null | undefined | Promise<OnLoadResult | null | undefined>)): void;
+    (OnLoadResult | null | undefined | Promise<OnLoadResult | null | undefined>)): void
+
+  /** Documentation: https://esbuild.github.io/plugins/#on-dispose */
+  onDispose(callback: () => void): void
 
   // This is a full copy of the esbuild library in case you need it
   esbuild: {
@@ -299,52 +312,56 @@ export interface PluginBuild {
     analyzeMetafileSync: typeof analyzeMetafileSync,
     initialize: typeof initialize,
     version: typeof version,
-  };
+  }
 }
 
+/** Documentation: https://esbuild.github.io/plugins/#resolve-options */
 export interface ResolveOptions {
-  pluginName?: string;
-  importer?: string;
-  namespace?: string;
-  resolveDir?: string;
-  kind?: ImportKind;
-  pluginData?: any;
+  pluginName?: string
+  importer?: string
+  namespace?: string
+  resolveDir?: string
+  kind?: ImportKind
+  pluginData?: any
 }
 
+/** Documentation: https://esbuild.github.io/plugins/#resolve-results */
 export interface ResolveResult {
-  errors: Message[];
-  warnings: Message[];
+  errors: Message[]
+  warnings: Message[]
 
-  path: string;
-  external: boolean;
-  sideEffects: boolean;
-  namespace: string;
-  suffix: string;
-  pluginData: any;
+  path: string
+  external: boolean
+  sideEffects: boolean
+  namespace: string
+  suffix: string
+  pluginData: any
 }
 
 export interface OnStartResult {
-  errors?: PartialMessage[];
-  warnings?: PartialMessage[];
+  errors?: PartialMessage[]
+  warnings?: PartialMessage[]
 }
 
 export interface OnEndResult {
-  errors?: PartialMessage[];
-  warnings?: PartialMessage[];
+  errors?: PartialMessage[]
+  warnings?: PartialMessage[]
 }
 
+/** Documentation: https://esbuild.github.io/plugins/#on-resolve-options */
 export interface OnResolveOptions {
-  filter: RegExp;
-  namespace?: string;
+  filter: RegExp
+  namespace?: string
 }
 
+/** Documentation: https://esbuild.github.io/plugins/#on-resolve-arguments */
 export interface OnResolveArgs {
-  path: string;
-  importer: string;
-  namespace: string;
-  resolveDir: string;
-  kind: ImportKind;
-  pluginData: any;
+  path: string
+  importer: string
+  namespace: string
+  resolveDir: string
+  kind: ImportKind
+  pluginData: any
 }
 
 export type ImportKind =
@@ -360,64 +377,69 @@ export type ImportKind =
   | 'import-rule'
   | 'url-token'
 
+/** Documentation: https://esbuild.github.io/plugins/#on-resolve-results */
 export interface OnResolveResult {
-  pluginName?: string;
+  pluginName?: string
 
-  errors?: PartialMessage[];
-  warnings?: PartialMessage[];
+  errors?: PartialMessage[]
+  warnings?: PartialMessage[]
 
-  path?: string;
-  external?: boolean;
-  sideEffects?: boolean;
-  namespace?: string;
-  suffix?: string;
-  pluginData?: any;
+  path?: string
+  external?: boolean
+  sideEffects?: boolean
+  namespace?: string
+  suffix?: string
+  pluginData?: any
 
-  watchFiles?: string[];
-  watchDirs?: string[];
+  watchFiles?: string[]
+  watchDirs?: string[]
 }
 
+/** Documentation: https://esbuild.github.io/plugins/#on-load-options */
 export interface OnLoadOptions {
-  filter: RegExp;
-  namespace?: string;
+  filter: RegExp
+  namespace?: string
 }
 
+/** Documentation: https://esbuild.github.io/plugins/#on-load-arguments */
 export interface OnLoadArgs {
-  path: string;
-  namespace: string;
-  suffix: string;
-  pluginData: any;
+  path: string
+  namespace: string
+  suffix: string
+  pluginData: any
 }
 
+/** Documentation: https://esbuild.github.io/plugins/#on-load-results */
 export interface OnLoadResult {
-  pluginName?: string;
+  pluginName?: string
 
-  errors?: PartialMessage[];
-  warnings?: PartialMessage[];
+  errors?: PartialMessage[]
+  warnings?: PartialMessage[]
 
-  contents?: string | Uint8Array;
-  resolveDir?: string;
-  loader?: Loader;
-  pluginData?: any;
+  contents?: string | Uint8Array
+  resolveDir?: string
+  loader?: Loader
+  pluginData?: any
 
-  watchFiles?: string[];
-  watchDirs?: string[];
+  watchFiles?: string[]
+  watchDirs?: string[]
 }
 
 export interface PartialMessage {
-  id?: string;
-  pluginName?: string;
-  text?: string;
-  location?: Partial<Location> | null;
-  notes?: PartialNote[];
-  detail?: any;
+  id?: string
+  pluginName?: string
+  text?: string
+  location?: Partial<Location> | null
+  notes?: PartialNote[]
+  detail?: any
 }
 
 export interface PartialNote {
-  text?: string;
-  location?: Partial<Location> | null;
+  text?: string
+  location?: Partial<Location> | null
 }
 
+/** Documentation: https://esbuild.github.io/api/#metafile */
 export interface Metafile {
   inputs: {
     [path: string]: {
@@ -452,23 +474,30 @@ export interface Metafile {
 }
 
 export interface FormatMessagesOptions {
-  kind: 'error' | 'warning';
-  color?: boolean;
-  terminalWidth?: number;
+  kind: 'error' | 'warning'
+  color?: boolean
+  terminalWidth?: number
 }
 
 export interface AnalyzeMetafileOptions {
-  color?: boolean;
-  verbose?: boolean;
+  color?: boolean
+  verbose?: boolean
 }
 
 export interface WatchOptions {
 }
 
 export interface BuildContext<SpecificOptions extends BuildOptions = BuildOptions> {
+  /** Documentation: https://esbuild.github.io/api/#rebuild */
   rebuild(): Promise<BuildResult<SpecificOptions>>
-  watch(options?: WatchOptions): void
+
+  /** Documentation: https://esbuild.github.io/api/#watch */
+  watch(options?: WatchOptions): Promise<void>
+
+  /** Documentation: https://esbuild.github.io/api/#serve */
   serve(options?: ServeOptions): Promise<ServeResult>
+
+  cancel(): Promise<void>
   dispose(): Promise<void>
 }
 
@@ -480,10 +509,10 @@ export interface BuildContext<SpecificOptions extends BuildOptions = BuildOption
  * - Works in node: yes
  * - Works in browser: yes
  *
- * Documentation: https://esbuild.github.io/api/#build-api
+ * Documentation: https://esbuild.github.io/api/#build
  */
-export declare function build<SpecificOptions extends BuildOptions>(options: SpecificOptions): Promise<BuildResult<SpecificOptions>>;
-export declare function build(options: BuildOptions): Promise<BuildResult>;
+export declare function build<SpecificOptions extends BuildOptions>(options: SpecificOptions): Promise<BuildResult<SpecificOptions>>
+export declare function build(options: BuildOptions): Promise<BuildResult>
 
 /**
  * This is the advanced long-running form of "build" that supports additional
@@ -492,10 +521,10 @@ export declare function build(options: BuildOptions): Promise<BuildResult>;
  * - Works in node: yes
  * - Works in browser: no
  *
- * Documentation: https://esbuild.github.io/api/#context-api
+ * Documentation: https://esbuild.github.io/api/#build
  */
-export declare function context<T extends BuildOptions>(options: T): Promise<BuildContext<T>>;
-export declare function context(options: BuildOptions): Promise<BuildContext>;
+export declare function context<T extends BuildOptions>(options: T): Promise<BuildContext<T>>
+export declare function context(options: BuildOptions): Promise<BuildContext>
 
 /**
  * This function transforms a single JavaScript file. It can be used to minify
@@ -506,10 +535,10 @@ export declare function context(options: BuildOptions): Promise<BuildContext>;
  * - Works in node: yes
  * - Works in browser: yes
  *
- * Documentation: https://esbuild.github.io/api/#transform-api
+ * Documentation: https://esbuild.github.io/api/#transform
  */
-export declare function transform<SpecificOptions extends TransformOptions>(input: string | Uint8Array, options?: SpecificOptions): Promise<TransformResult<SpecificOptions>>;
-export declare function transform(input: string | Uint8Array, options?: TransformOptions): Promise<TransformResult>;
+export declare function transform<SpecificOptions extends TransformOptions>(input: string | Uint8Array, options?: SpecificOptions): Promise<TransformResult<SpecificOptions>>
+export declare function transform(input: string | Uint8Array, options?: TransformOptions): Promise<TransformResult>
 
 /**
  * Converts log messages to formatted message strings suitable for printing in
@@ -519,7 +548,7 @@ export declare function transform(input: string | Uint8Array, options?: Transfor
  * - Works in node: yes
  * - Works in browser: yes
  */
-export declare function formatMessages(messages: PartialMessage[], options: FormatMessagesOptions): Promise<string[]>;
+export declare function formatMessages(messages: PartialMessage[], options: FormatMessagesOptions): Promise<string[]>
 
 /**
  * Pretty-prints an analysis of the metafile JSON to a string. This is just for
@@ -531,7 +560,7 @@ export declare function formatMessages(messages: PartialMessage[], options: Form
  *
  * Documentation: https://esbuild.github.io/api/#analyze
  */
-export declare function analyzeMetafile(metafile: Metafile | string, options?: AnalyzeMetafileOptions): Promise<string>;
+export declare function analyzeMetafile(metafile: Metafile | string, options?: AnalyzeMetafileOptions): Promise<string>
 
 /**
  * A synchronous version of "build".
@@ -539,10 +568,10 @@ export declare function analyzeMetafile(metafile: Metafile | string, options?: A
  * - Works in node: yes
  * - Works in browser: no
  *
- * Documentation: https://esbuild.github.io/api/#build-api
+ * Documentation: https://esbuild.github.io/api/#build
  */
-export declare function buildSync<SpecificOptions extends BuildOptions>(options: SpecificOptions): BuildResult<SpecificOptions>;
-export declare function buildSync(options: BuildOptions): BuildResult;
+export declare function buildSync<SpecificOptions extends BuildOptions>(options: SpecificOptions): BuildResult<SpecificOptions>
+export declare function buildSync(options: BuildOptions): BuildResult
 
 /**
  * A synchronous version of "transform".
@@ -550,10 +579,10 @@ export declare function buildSync(options: BuildOptions): BuildResult;
  * - Works in node: yes
  * - Works in browser: no
  *
- * Documentation: https://esbuild.github.io/api/#transform-api
+ * Documentation: https://esbuild.github.io/api/#transform
  */
-export declare function transformSync<SpecificOptions extends TransformOptions>(input: string, options?: SpecificOptions): TransformResult<SpecificOptions>;
-export declare function transformSync(input: string | Uint8Array, options?: TransformOptions): TransformResult;
+export declare function transformSync<SpecificOptions extends TransformOptions>(input: string, options?: SpecificOptions): TransformResult<SpecificOptions>
+export declare function transformSync(input: string | Uint8Array, options?: TransformOptions): TransformResult
 
 /**
  * A synchronous version of "formatMessages".
@@ -561,7 +590,7 @@ export declare function transformSync(input: string | Uint8Array, options?: Tran
  * - Works in node: yes
  * - Works in browser: no
  */
-export declare function formatMessagesSync(messages: PartialMessage[], options: FormatMessagesOptions): string[];
+export declare function formatMessagesSync(messages: PartialMessage[], options: FormatMessagesOptions): string[]
 
 /**
  * A synchronous version of "analyzeMetafile".
@@ -571,7 +600,7 @@ export declare function formatMessagesSync(messages: PartialMessage[], options:
  *
  * Documentation: https://esbuild.github.io/api/#analyze
  */
-export declare function analyzeMetafileSync(metafile: Metafile | string, options?: AnalyzeMetafileOptions): string;
+export declare function analyzeMetafileSync(metafile: Metafile | string, options?: AnalyzeMetafileOptions): string
 
 /**
  * This configures the browser-based version of esbuild. It is necessary to
@@ -581,9 +610,9 @@ export declare function analyzeMetafileSync(metafile: Metafile | string, options
  * - Works in node: yes
  * - Works in browser: yes ("options" is required)
  *
- * Documentation: https://esbuild.github.io/api/#running-in-the-browser
+ * Documentation: https://esbuild.github.io/api/#browser
  */
-export declare function initialize(options: InitializeOptions): Promise<void>;
+export declare function initialize(options: InitializeOptions): Promise<void>
 
 export interface InitializeOptions {
   /**
@@ -610,4 +639,4 @@ export interface InitializeOptions {
   worker?: boolean
 }
 
-export let version: string;
+export let version: string

package/lib/main.js

@@ -231,8 +231,8 @@ var mustBeInteger = (value) => typeof value === "number" && value === (value | 0
 var mustBeFunction = (value) => typeof value === "function" ? null : "a function";
 var mustBeArray = (value) => Array.isArray(value) ? null : "an array";
 var mustBeObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value) ? null : "an object";
+var mustBeEntryPoints = (value) => typeof value === "object" && value !== null ? null : "an array or an object";
 var mustBeWebAssemblyModule = (value) => value instanceof WebAssembly.Module ? null : "a WebAssembly.Module";
-var mustBeArrayOrRecord = (value) => typeof value === "object" && value !== null ? null : "an array or an object";
 var mustBeObjectOrNull = (value) => typeof value === "object" && !Array.isArray(value) ? null : "an object or null";
 var mustBeStringOrBoolean = (value) => typeof value === "string" || typeof value === "boolean" ? null : "a string or a boolean";
 var mustBeStringOrObject = (value) => typeof value === "string" || typeof value === "object" && value !== null && !Array.isArray(value) ? null : "a string or an object";
@@ -447,7 +447,7 @@ function flagsForBuildOptions(callName, options, isTTY2, logLevelDefault, writeD
   let inject = getFlag(options, keys, "inject", mustBeArray);
   let banner = getFlag(options, keys, "banner", mustBeObject);
   let footer = getFlag(options, keys, "footer", mustBeObject);
-  let entryPoints = getFlag(options, keys, "entryPoints", mustBeArrayOrRecord);
+  let entryPoints = getFlag(options, keys, "entryPoints", mustBeEntryPoints);
   let absWorkingDir = getFlag(options, keys, "absWorkingDir", mustBeString);
   let stdin = getFlag(options, keys, "stdin", mustBeObject);
   let write = (_a2 = getFlag(options, keys, "write", mustBeBoolean)) != null ? _a2 : writeDefault;
@@ -558,8 +558,21 @@ function flagsForBuildOptions(callName, options, isTTY2, logLevelDefault, writeD
   }
   if (entryPoints) {
     if (Array.isArray(entryPoints)) {
-      for (let entryPoint of entryPoints) {
-        entries.push(["", validateStringValue(entryPoint, "entry point")]);
+      for (let i = 0, n = entryPoints.length; i < n; i++) {
+        let entryPoint = entryPoints[i];
+        if (typeof entryPoint === "object" && entryPoint !== null) {
+          let entryPointKeys = /* @__PURE__ */ Object.create(null);
+          let input = getFlag(entryPoint, entryPointKeys, "in", mustBeString);
+          let output = getFlag(entryPoint, entryPointKeys, "out", mustBeString);
+          checkForInvalidFlags(entryPoint, entryPointKeys, "in entry point at index " + i);
+          if (input === void 0)
+            throw new Error('Missing property "in" for entry point at index ' + i);
+          if (output === void 0)
+            throw new Error('Missing property "out" for entry point at index ' + i);
+          entries.push([output, input]);
+        } else {
+          entries.push(["", validateStringValue(entryPoint, "entry point at index " + i)]);
+        }
       }
     } else {
       for (let key in entryPoints) {
@@ -722,8 +735,8 @@ function createChannel(streamIn) {
     if (isFirstPacket) {
       isFirstPacket = false;
       let binaryVersion = String.fromCharCode(...bytes);
-      if (binaryVersion !== "0.17.0") {
-        throw new Error(`Cannot start service: Host version "${"0.17.0"}" does not match binary version ${quote(binaryVersion)}`);
+      if (binaryVersion !== "0.17.2") {
+        throw new Error(`Cannot start service: Host version "${"0.17.2"}" does not match binary version ${quote(binaryVersion)}`);
       }
       return;
     }
@@ -967,7 +980,7 @@ function buildOrContextImpl(callName, buildKey, sendRequest, sendResponse, refs,
         if (!result.ok)
           return handleError(result.error, result.pluginName);
         try {
-          buildOrContextContinue(result.requestPlugins, result.runOnEndCallbacks);
+          buildOrContextContinue(result.requestPlugins, result.runOnEndCallbacks, result.scheduleOnDisposeCallbacks);
         } catch (e) {
           handleError(e, "");
         }
@@ -977,11 +990,12 @@ function buildOrContextImpl(callName, buildKey, sendRequest, sendResponse, refs,
     return;
   }
   try {
-    buildOrContextContinue(null, (result, done) => done([], []));
+    buildOrContextContinue(null, (result, done) => done([], []), () => {
+    });
   } catch (e) {
     handleError(e, "");
   }
-  function buildOrContextContinue(requestPlugins, runOnEndCallbacks) {
+  function buildOrContextContinue(requestPlugins, runOnEndCallbacks, scheduleOnDisposeCallbacks) {
     const writeDefault = streamIn.hasFS;
     const {
       entries,
@@ -1058,7 +1072,10 @@ function buildOrContextImpl(callName, buildKey, sendRequest, sendResponse, refs,
       if (error)
         return callback(new Error(error), null);
       if (!isContext) {
-        return buildResponseToResult(response, callback);
+        return buildResponseToResult(response, (err, res) => {
+          scheduleOnDisposeCallbacks();
+          return callback(err, res);
+        });
       }
       if (response.errors.length > 0) {
         return callback(failureErrorWithLog("Context failed", response.errors, response.warnings), null);
@@ -1146,15 +1163,28 @@ function buildOrContextImpl(callName, buildKey, sendRequest, sendResponse, refs,
             resolve(response2);
           });
         }),
+        cancel: () => new Promise((resolve) => {
+          if (didDispose)
+            return resolve();
+          const request2 = {
+            command: "cancel",
+            key: buildKey
+          };
+          sendRequest(refs, request2, () => {
+            resolve();
+          });
+        }),
         dispose: () => new Promise((resolve) => {
           if (didDispose)
             return resolve();
+          didDispose = true;
           const request2 = {
             command: "dispose",
             key: buildKey
           };
           sendRequest(refs, request2, () => {
             resolve();
+            scheduleOnDisposeCallbacks();
             refs.unref();
           });
         })
@@ -1169,6 +1199,7 @@ var handlePlugins = async (buildKey, sendRequest, sendResponse, refs, streamIn,
   let onEndCallbacks = [];
   let onResolveCallbacks = {};
   let onLoadCallbacks = {};
+  let onDisposeCallbacks = [];
   let nextCallbackID = 0;
   let i = 0;
   let requestPlugins = [];
@@ -1286,6 +1317,9 @@ var handlePlugins = async (buildKey, sendRequest, sendResponse, refs, streamIn,
           onLoadCallbacks[id] = { name, callback, note: registeredNote };
           plugin.onLoad.push({ id, filter: filter.source, namespace: namespace || "" });
         },
+        onDispose(callback) {
+          onDisposeCallbacks.push(callback);
+        },
         esbuild: streamIn.esbuild
       });
       if (promise)
@@ -1479,11 +1513,17 @@ var handlePlugins = async (buildKey, sendRequest, sendResponse, refs, streamIn,
       })();
     };
   }
+  let scheduleOnDisposeCallbacks = () => {
+    for (const cb of onDisposeCallbacks) {
+      setTimeout(() => cb(), 0);
+    }
+  };
   isSetupDone = true;
   return {
     ok: true,
     requestPlugins,
-    runOnEndCallbacks
+    runOnEndCallbacks,
+    scheduleOnDisposeCallbacks
   };
 };
 function createObjectStash() {
@@ -1864,7 +1904,7 @@ for your current platform.`);
         "node_modules",
         ".cache",
         "esbuild",
-        `pnpapi-${pkg.replace("/", "-")}-${"0.17.0"}-${path.basename(subpath)}`
+        `pnpapi-${pkg.replace("/", "-")}-${"0.17.2"}-${path.basename(subpath)}`
       );
       if (!fs.existsSync(binTargetPath)) {
         fs.mkdirSync(path.dirname(binTargetPath), { recursive: true });
@@ -1899,7 +1939,7 @@ if (process.env.ESBUILD_WORKER_THREADS !== "0") {
   }
 }
 var _a;
-var isInternalWorkerThread = ((_a = worker_threads == null ? void 0 : worker_threads.workerData) == null ? void 0 : _a.esbuildVersion) === "0.17.0";
+var isInternalWorkerThread = ((_a = worker_threads == null ? void 0 : worker_threads.workerData) == null ? void 0 : _a.esbuildVersion) === "0.17.2";
 var esbuildCommandAndArgs = () => {
   if ((!ESBUILD_BINARY_PATH || false) && (path2.basename(__filename) !== "main.js" || path2.basename(__dirname) !== "lib")) {
     throw new Error(
@@ -1966,7 +2006,7 @@ var fsAsync = {
     }
   }
 };
-var version = "0.17.0";
+var version = "0.17.2";
 var build = (options) => ensureServiceIsRunning().build(options);
 var context = (buildOptions) => ensureServiceIsRunning().context(buildOptions);
 var transform = (input, options) => ensureServiceIsRunning().transform(input, options);
@@ -2076,7 +2116,7 @@ var ensureServiceIsRunning = () => {
   if (longLivedService)
     return longLivedService;
   let [command, args] = esbuildCommandAndArgs();
-  let child = child_process.spawn(command, args.concat(`--service=${"0.17.0"}`, "--ping"), {
+  let child = child_process.spawn(command, args.concat(`--service=${"0.17.2"}`, "--ping"), {
     windowsHide: true,
     stdio: ["pipe", "pipe", "inherit"],
     cwd: defaultWD
@@ -2176,7 +2216,7 @@ var runServiceSync = (callback) => {
     esbuild: node_exports
   });
   callback(service);
-  let stdout = child_process.execFileSync(command, args.concat(`--service=${"0.17.0"}`), {
+  let stdout = child_process.execFileSync(command, args.concat(`--service=${"0.17.2"}`), {
     cwd: defaultWD,
     windowsHide: true,
     input: stdin,
@@ -2196,7 +2236,7 @@ var workerThreadService = null;
 var startWorkerThreadService = (worker_threads2) => {
   let { port1: mainPort, port2: workerPort } = new worker_threads2.MessageChannel();
   let worker = new worker_threads2.Worker(__filename, {
-    workerData: { workerPort, defaultWD, esbuildVersion: "0.17.0" },
+    workerData: { workerPort, defaultWD, esbuildVersion: "0.17.2" },
     transferList: [workerPort],
     // From node's documentation: https://nodejs.org/api/worker_threads.html
     //

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "esbuild",
-  "version": "0.17.0",
+  "version": "0.17.2",
   "description": "An extremely fast JavaScript and CSS bundler and minifier.",
   "repository": "https://github.com/evanw/esbuild",
   "scripts": {
@@ -15,28 +15,28 @@
     "esbuild": "bin/esbuild"
   },
   "optionalDependencies": {
-    "@esbuild/android-arm": "0.17.0",
-    "@esbuild/android-arm64": "0.17.0",
-    "@esbuild/android-x64": "0.17.0",
-    "@esbuild/darwin-arm64": "0.17.0",
-    "@esbuild/darwin-x64": "0.17.0",
-    "@esbuild/freebsd-arm64": "0.17.0",
-    "@esbuild/freebsd-x64": "0.17.0",
-    "@esbuild/linux-arm": "0.17.0",
-    "@esbuild/linux-arm64": "0.17.0",
-    "@esbuild/linux-ia32": "0.17.0",
-    "@esbuild/linux-loong64": "0.17.0",
-    "@esbuild/linux-mips64el": "0.17.0",
-    "@esbuild/linux-ppc64": "0.17.0",
-    "@esbuild/linux-riscv64": "0.17.0",
-    "@esbuild/linux-s390x": "0.17.0",
-    "@esbuild/linux-x64": "0.17.0",
-    "@esbuild/netbsd-x64": "0.17.0",
-    "@esbuild/openbsd-x64": "0.17.0",
-    "@esbuild/sunos-x64": "0.17.0",
-    "@esbuild/win32-arm64": "0.17.0",
-    "@esbuild/win32-ia32": "0.17.0",
-    "@esbuild/win32-x64": "0.17.0"
+    "@esbuild/android-arm": "0.17.2",
+    "@esbuild/android-arm64": "0.17.2",
+    "@esbuild/android-x64": "0.17.2",
+    "@esbuild/darwin-arm64": "0.17.2",
+    "@esbuild/darwin-x64": "0.17.2",
+    "@esbuild/freebsd-arm64": "0.17.2",
+    "@esbuild/freebsd-x64": "0.17.2",
+    "@esbuild/linux-arm": "0.17.2",
+    "@esbuild/linux-arm64": "0.17.2",
+    "@esbuild/linux-ia32": "0.17.2",
+    "@esbuild/linux-loong64": "0.17.2",
+    "@esbuild/linux-mips64el": "0.17.2",
+    "@esbuild/linux-ppc64": "0.17.2",
+    "@esbuild/linux-riscv64": "0.17.2",
+    "@esbuild/linux-s390x": "0.17.2",
+    "@esbuild/linux-x64": "0.17.2",
+    "@esbuild/netbsd-x64": "0.17.2",
+    "@esbuild/openbsd-x64": "0.17.2",
+    "@esbuild/sunos-x64": "0.17.2",
+    "@esbuild/win32-arm64": "0.17.2",
+    "@esbuild/win32-ia32": "0.17.2",
+    "@esbuild/win32-x64": "0.17.2"
   },
   "license": "MIT"
 }