@rolldown/browser 1.0.0-beta.49 → 1.0.0-beta.51

package/dist/shared/{binding-B4uTNiw2.d.mts → binding-lSvYApx7.d.mts}

@@ -73,6 +73,8 @@ interface CompressOptions {
   dropLabels?: Array<string>;
   /** Limit the maximum number of iterations for debugging purpose. */
   maxIterations?: number;
+  /** Treeshake options. */
+  treeshake?: TreeShakeOptions;
 }
 interface CompressOptionsKeepNames {
   /**
@@ -122,10 +124,14 @@ interface MangleOptionsKeepNames {
    */
   class: boolean;
 }
-/** Minify synchronously. */
-declare function minify(filename: string, sourceText: string, options?: MinifyOptions | undefined | null): MinifyResult;
+/**
+ * Minify asynchronously.
+ *
+ * Note: This function can be slower than `minifySync` due to the overhead of spawning a thread.
+ */
+declare function minify(filename: string, sourceText: string, options?: MinifyOptions | undefined | null): Promise<MinifyResult>;
 interface MinifyOptions {
-  /** Use when minifying an ES6 module. */
+  /** Use when minifying an ES module. */
   module?: boolean;
   compress?: boolean | CompressOptions;
   mangle?: boolean | MangleOptions;
@@ -137,6 +143,41 @@ interface MinifyResult {
   map?: SourceMap;
   errors: Array<OxcError>;
 }
+/** Minify synchronously. */
+declare function minifySync(filename: string, sourceText: string, options?: MinifyOptions | undefined | null): MinifyResult;
+interface TreeShakeOptions {
+  /**
+   * Whether to respect the pure annotations.
+   *
+   * Pure annotations are comments that mark an expression as pure.
+   * For example: @__PURE__ or #__NO_SIDE_EFFECTS__.
+   *
+   * @default true
+   */
+  annotations?: boolean;
+  /**
+   * Whether to treat this function call as pure.
+   *
+   * This function is called for normal function calls, new calls, and
+   * tagged template calls.
+   */
+  manualPureFunctions?: Array<string>;
+  /**
+   * Whether property read accesses have side effects.
+   *
+   * @default 'always'
+   */
+  propertyReadSideEffects?: boolean | 'always';
+  /**
+   * Whether accessing a global variable has side effects.
+   *
+   * Accessing a non-existing global variable will throw an error.
+   * Global variable may be a getter that has side effects.
+   *
+   * @default true
+   */
+  unknownGlobalSideEffects?: boolean;
+}
 interface Comment {
   type: 'Line' | 'Block';
   value: string;
@@ -235,7 +276,7 @@ type ImportNameKind = /** `import { x } from "mod"` */
  *
  * Note: This function can be slower than `parseSync` due to the overhead of spawning a thread.
  */
-declare function parseAsync(filename: string, sourceText: string, options?: ParserOptions | undefined | null): Promise<ParseResult>;
+declare function parse(filename: string, sourceText: string, options?: ParserOptions | undefined | null): Promise<ParseResult>;
 interface ParserOptions {
   /** Treat the source text as `js`, `jsx`, `ts`, `tsx` or `dts`. */
   lang?: 'js' | 'jsx' | 'ts' | 'tsx' | 'dts';
@@ -732,8 +773,12 @@ type HelperMode =
 interface Helpers {
   mode?: HelperMode;
 }
-/** TypeScript Isolated Declarations for Standalone DTS Emit */
-declare function isolatedDeclaration(filename: string, sourceText: string, options?: IsolatedDeclarationsOptions | undefined | null): IsolatedDeclarationsResult;
+/**
+ * TypeScript Isolated Declarations for Standalone DTS Emit (async)
+ *
+ * Note: This function can be slower than `isolatedDeclarationSync` due to the overhead of spawning a thread.
+ */
+declare function isolatedDeclaration(filename: string, sourceText: string, options?: IsolatedDeclarationsOptions | undefined | null): Promise<IsolatedDeclarationsResult>;
 interface IsolatedDeclarationsOptions {
   /**
    * Do not emit declarations for code that has an @internal annotation in its JSDoc comment.
@@ -751,6 +796,8 @@ interface IsolatedDeclarationsResult {
   map?: SourceMap;
   errors: Array<OxcError>;
 }
+/** TypeScript Isolated Declarations for Standalone DTS Emit */
+declare function isolatedDeclarationSync(filename: string, sourceText: string, options?: IsolatedDeclarationsOptions | undefined | null): IsolatedDeclarationsResult;
 /**
  * Configure how TSX and JSX are transformed.
  *
@@ -787,7 +834,7 @@ interface JsxOptions {
   /**
    * Enables `@babel/plugin-transform-react-pure-annotations`.
    *
-   * It will mark top-level React method calls as pure for tree shaking.
+   * It will mark JSX elements and top-level React method calls as pure for tree shaking.
    *
    * @see {@link https://babeljs.io/docs/en/babel-plugin-transform-react-pure-annotations}
    *
@@ -856,9 +903,11 @@ interface JsxOptions {
  * @returns an object containing the transformed code, source maps, and any
  * errors that occurred during parsing or transformation.
  *
+ * Note: This function can be slower than `moduleRunnerTransformSync` due to the overhead of spawning a thread.
+ *
  * @deprecated Only works for Vite.
  */
-declare function moduleRunnerTransform(filename: string, sourceText: string, options?: ModuleRunnerTransformOptions | undefined | null): ModuleRunnerTransformResult;
+declare function moduleRunnerTransform(filename: string, sourceText: string, options?: ModuleRunnerTransformOptions | undefined | null): Promise<ModuleRunnerTransformResult>;
 interface ModuleRunnerTransformOptions {
   /**
    * Enable source map generation.
@@ -897,6 +946,7 @@ interface ModuleRunnerTransformResult {
 }
 interface PluginsOptions {
   styledComponents?: StyledComponentsOptions;
+  taggedTemplateEscape?: boolean;
 }
 interface ReactRefreshOptions {
   /**
@@ -992,18 +1042,20 @@ interface StyledComponentsOptions {
   topLevelImportPaths?: Array<string>;
 }
 /**
- * Transpile a JavaScript or TypeScript into a target ECMAScript version.
+ * Transpile a JavaScript or TypeScript into a target ECMAScript version, asynchronously.
+ *
+ * Note: This function can be slower than `transform` due to the overhead of spawning a thread.
  *
  * @param filename The name of the file being transformed. If this is a
- * relative path, consider setting the {@link TransformOptions#cwd} option..
+ * relative path, consider setting the {@link TransformOptions#cwd} option.
  * @param sourceText the source code itself
  * @param options The options for the transformation. See {@link
  * TransformOptions} for more information.
  *
- * @returns an object containing the transformed code, source maps, and any
- * errors that occurred during parsing or transformation.
+ * @returns a promise that resolves to an object containing the transformed code,
+ * source maps, and any errors that occurred during parsing or transformation.
  */
-declare function transform(filename: string, sourceText: string, options?: TransformOptions | undefined | null): TransformResult;
+declare function transform(filename: string, sourceText: string, options?: TransformOptions | undefined | null): Promise<TransformResult>;
 /**
  * Options for transforming a JavaScript or TypeScript file.
  *
@@ -1112,6 +1164,19 @@ interface TransformResult {
    */
   errors: Array<OxcError>;
 }
+/**
+ * Transpile a JavaScript or TypeScript into a target ECMAScript version.
+ *
+ * @param filename The name of the file being transformed. If this is a
+ * relative path, consider setting the {@link TransformOptions#cwd} option..
+ * @param sourceText the source code itself
+ * @param options The options for the transformation. See {@link
+ * TransformOptions} for more information.
+ *
+ * @returns an object containing the transformed code, source maps, and any
+ * errors that occurred during parsing or transformation.
+ */
+declare function transformSync(filename: string, sourceText: string, options?: TransformOptions | undefined | null): TransformResult;
 interface TypeScriptOptions {
   jsxPragma?: string;
   jsxPragmaFrag?: string;
@@ -1212,6 +1277,32 @@ declare class BindingMagicString {
   relocate(start: number, end: number, to: number): void;
   indent(indentor?: string | undefined | null): void;
 }
+declare class BindingOutputAsset {
+  dropInner(): ExternalMemoryStatus;
+  getFileName(): string;
+  getOriginalFileName(): string | null;
+  getOriginalFileNames(): Array<string>;
+  getSource(): BindingAssetSource;
+  getName(): string | null;
+  getNames(): Array<string>;
+}
+declare class BindingOutputChunk {
+  dropInner(): ExternalMemoryStatus;
+  getIsEntry(): boolean;
+  getIsDynamicEntry(): boolean;
+  getFacadeModuleId(): string | null;
+  getModuleIds(): Array<string>;
+  getExports(): Array<string>;
+  getFileName(): string;
+  getModules(): BindingModules;
+  getImports(): Array<string>;
+  getDynamicImports(): Array<string>;
+  getCode(): string;
+  getMap(): string | null;
+  getSourcemapFileName(): string | null;
+  getPreliminaryFileName(): string;
+  getName(): string;
+}
 declare class BindingRenderedChunk {
   get name(): string;
   get isEntry(): boolean;
@@ -1249,43 +1340,14 @@ declare class BindingWatcherEvent {
   bundleEventKind(): string;
   bundleErrorData(): BindingBundleErrorEventData;
 }
-interface BindingAssetPluginConfig {
-  isLib: boolean;
-  isSsr: boolean;
-  isWorker: boolean;
-  urlBase: string;
-  publicDir: string;
-  decodedBase: string;
-  isSkipAssets: boolean;
-  assetsInclude: Array<BindingStringOrRegex>;
-  assetInlineLimit: number | ((file: string, content: Buffer) => boolean | undefined);
-  renderBuiltUrl?: (filename: string, type: BindingRenderBuiltUrlConfig) => undefined | string | BindingRenderBuiltUrlRet;
-}
-interface BindingBuildImportAnalysisPluginConfig {
-  preloadCode: string;
-  insertPreload: boolean;
-  optimizeModulePreloadRelativePaths: boolean;
-  renderBuiltUrl: boolean;
-  isRelativeBase: boolean;
-  v2?: BindingBuildImportAnalysisPluginV2Config;
+interface BindingAssetSource {
+  inner: string | Uint8Array;
 }
-interface BindingBuildImportAnalysisPluginV2Config {
-  isSsr: boolean;
-  urlBase: string;
-  decodedBase: string;
-  modulePreload: false | BindingModulePreloadOptions;
-  renderBuiltUrl?: (filename: string, type: BindingRenderBuiltUrlConfig) => undefined | string | BindingRenderBuiltUrlRet;
-}
-type BindingBuiltinPluginName = 'builtin:alias' | 'builtin:asset' | 'builtin:asset-import-meta-url' | 'builtin:build-import-analysis' | 'builtin:dynamic-import-vars' | 'builtin:esm-external-require' | 'builtin:html-inline-proxy' | 'builtin:import-glob' | 'builtin:isolated-declaration' | 'builtin:json' | 'builtin:load-fallback' | 'builtin:manifest' | 'builtin:module-preload-polyfill' | 'builtin:react-refresh-wrapper' | 'builtin:reporter' | 'builtin:replace' | 'builtin:transform' | 'builtin:vite-css' | 'builtin:vite-css-post' | 'builtin:vite-html' | 'builtin:vite-resolve' | 'builtin:wasm-fallback' | 'builtin:wasm-helper' | 'builtin:web-worker-post';
+type BindingBuiltinPluginName = 'builtin:esm-external-require' | 'builtin:isolated-declaration' | 'builtin:replace' | 'builtin:vite-alias' | 'builtin:vite-asset' | 'builtin:vite-asset-import-meta-url' | 'builtin:vite-build-import-analysis' | 'builtin:vite-css' | 'builtin:vite-css-post' | 'builtin:vite-dynamic-import-vars' | 'builtin:vite-html' | 'builtin:vite-html-inline-proxy' | 'builtin:vite-import-glob' | 'builtin:vite-json' | 'builtin:vite-load-fallback' | 'builtin:vite-manifest' | 'builtin:vite-module-preload-polyfill' | 'builtin:vite-react-refresh-wrapper' | 'builtin:vite-reporter' | 'builtin:vite-resolve' | 'builtin:vite-transform' | 'builtin:vite-wasm-fallback' | 'builtin:vite-wasm-helper' | 'builtin:vite-web-worker-post';
 interface BindingClientHmrUpdate {
   clientId: string;
   update: BindingHmrUpdate;
 }
-interface BindingDynamicImportVarsPluginConfig {
-  include?: Array<BindingStringOrRegex>;
-  exclude?: Array<BindingStringOrRegex>;
-  resolver?: (id: string, importer: string) => MaybePromise<string | undefined>;
-}
 type BindingError = {
   type: 'JsError';
   field0: Error;
@@ -1328,19 +1390,9 @@ interface BindingHookResolveIdExtraArgs {
    */
   kind: 'import-statement' | 'dynamic-import' | 'require-call' | 'import-rule' | 'url-token' | 'new-url' | 'hot-accept';
 }
-interface BindingImportGlobPluginConfig {
-  root?: string;
-  restoreQueryExtension?: boolean;
-}
 interface BindingIsolatedDeclarationPluginConfig {
   stripInternal?: boolean;
 }
-interface BindingJsonPluginConfig {
-  minify?: boolean;
-  namedExports?: boolean;
-  stringify?: BindingJsonPluginStringify;
-}
-type BindingJsonPluginStringify = boolean | string;
 interface BindingJsonSourcemap {
   file?: string;
   mappings?: string;
@@ -1351,12 +1403,6 @@ interface BindingJsonSourcemap {
   debugId?: string;
   x_google_ignoreList?: Array<number>;
 }
-interface BindingManifestPluginConfig {
-  root: string;
-  outPath: string;
-  isLegacy?: () => boolean;
-  cssEntries: () => Record<string, string>;
-}
 interface BindingModulePreloadOptions {
   polyfill: boolean;
   resolveDependencies?: (filename: string, deps: string[], context: {
@@ -1364,19 +1410,13 @@ interface BindingModulePreloadOptions {
     hostType: 'html' | 'js';
   }) => string[];
 }
-interface BindingModulePreloadPolyfillPluginConfig {
-  isServer?: boolean;
-}
 interface BindingModules {
   values: Array<BindingRenderedModule>;
   keys: Array<string>;
 }
-interface BindingReactRefreshWrapperPluginConfig {
-  cwd: string;
-  include?: Array<BindingStringOrRegex>;
-  exclude?: Array<BindingStringOrRegex>;
-  jsxImportSource: string;
-  reactRefreshHost: string;
+interface BindingOutputs {
+  chunks: Array<BindingOutputChunk>;
+  assets: Array<BindingOutputAsset>;
 }
 declare enum BindingRebuildStrategy {
   Always = 0,
@@ -1400,31 +1440,42 @@ interface BindingReplacePluginConfig {
   objectGuards?: boolean;
   sourcemap?: boolean;
 }
-interface BindingReporterPluginConfig {
-  isTty: boolean;
-  isLib: boolean;
-  assetsDir: string;
-  chunkLimit: number;
-  shouldLogInfo: boolean;
-  warnLargeChunks: boolean;
-  reportCompressedSize: boolean;
-}
 interface BindingSourcemap {
   inner: string | BindingJsonSourcemap;
 }
 interface BindingTransformHookExtraArgs {
   moduleType: string;
 }
-interface BindingTransformPluginConfig {
-  include?: Array<BindingStringOrRegex>;
-  exclude?: Array<BindingStringOrRegex>;
-  jsxRefreshInclude?: Array<BindingStringOrRegex>;
-  jsxRefreshExclude?: Array<BindingStringOrRegex>;
-  isServerConsumer?: boolean;
-  jsxInject?: string;
-  transformOptions?: TransformOptions;
+interface BindingViteAssetPluginConfig {
+  root: string;
+  isLib: boolean;
+  isSsr: boolean;
+  isWorker: boolean;
+  urlBase: string;
+  publicDir: string;
+  decodedBase: string;
+  isSkipAssets: boolean;
+  assetsInclude: Array<BindingStringOrRegex>;
+  assetInlineLimit: number | ((file: string, content: Buffer) => boolean | undefined);
+  renderBuiltUrl?: (filename: string, type: BindingRenderBuiltUrlConfig) => undefined | string | BindingRenderBuiltUrlRet;
+}
+interface BindingViteBuildImportAnalysisPluginConfig {
+  preloadCode: string;
+  insertPreload: boolean;
+  optimizeModulePreloadRelativePaths: boolean;
+  renderBuiltUrl: boolean;
+  isRelativeBase: boolean;
+  v2?: BindingViteBuildImportAnalysisPluginV2Config;
+}
+interface BindingViteBuildImportAnalysisPluginV2Config {
+  isSsr: boolean;
+  urlBase: string;
+  decodedBase: string;
+  modulePreload: false | BindingModulePreloadOptions;
+  renderBuiltUrl?: (filename: string, type: BindingRenderBuiltUrlConfig) => undefined | string | BindingRenderBuiltUrlRet;
 }
 interface BindingViteCssPluginConfig {
+  root: string;
   isLib: boolean;
   publicDir: string;
   compileCSS: (url: string, importer: string, resolver: BindingUrlResolver) => Promise<{
@@ -1437,6 +1488,7 @@ interface BindingViteCssPluginConfig {
   assetInlineLimit: number | ((file: string, content: Buffer) => boolean | undefined);
 }
 interface BindingViteCssPostPluginConfig {
+  root: string;
   isLib: boolean;
   isSsr: boolean;
   isWorker: boolean;
@@ -1451,7 +1503,16 @@ interface BindingViteCssPostPluginConfig {
   cssMinify?: (css: string) => Promise<string>;
   renderBuiltUrl?: (filename: string, type: BindingRenderBuiltUrlConfig) => undefined | string | BindingRenderBuiltUrlRet;
 }
+interface BindingViteDynamicImportVarsPluginConfig {
+  include?: Array<BindingStringOrRegex>;
+  exclude?: Array<BindingStringOrRegex>;
+  resolver?: (id: string, importer: string) => MaybePromise<string | undefined>;
+}
+interface BindingViteHtmlInlineProxyPluginConfig {
+  root: string;
+}
 interface BindingViteHtmlPluginConfig {
+  root: string;
   isLib: boolean;
   isSsr: boolean;
   urlBase: string;
@@ -1461,6 +1522,44 @@ interface BindingViteHtmlPluginConfig {
   modulePreload: false | BindingModulePreloadOptions;
   assetInlineLimit: number | ((file: string, content: Buffer) => boolean | undefined);
   renderBuiltUrl?: (filename: string, type: BindingRenderBuiltUrlConfig) => undefined | string | BindingRenderBuiltUrlRet;
+  transformIndexHtml: (html: string, path: string, filename: string, hook: 'transform' | 'generateBundle', output?: BindingOutputs, chunk?: BindingOutputChunk) => Promise<string>;
+}
+interface BindingViteImportGlobPluginConfig {
+  root?: string;
+  restoreQueryExtension?: boolean;
+}
+interface BindingViteJsonPluginConfig {
+  minify?: boolean;
+  namedExports?: boolean;
+  stringify?: BindingViteJsonPluginStringify;
+}
+type BindingViteJsonPluginStringify = boolean | string;
+interface BindingViteManifestPluginConfig {
+  root: string;
+  outPath: string;
+  isEnableV2?: boolean;
+  isLegacy?: () => boolean;
+  cssEntries: () => Record<string, string>;
+}
+interface BindingViteModulePreloadPolyfillPluginConfig {
+  isServer?: boolean;
+}
+interface BindingViteReactRefreshWrapperPluginConfig {
+  cwd: string;
+  include?: Array<BindingStringOrRegex>;
+  exclude?: Array<BindingStringOrRegex>;
+  jsxImportSource: string;
+  reactRefreshHost: string;
+}
+interface BindingViteReporterPluginConfig {
+  root: string;
+  isTty: boolean;
+  isLib: boolean;
+  assetsDir: string;
+  chunkLimit: number;
+  shouldLogInfo: boolean;
+  warnLargeChunks: boolean;
+  reportCompressedSize: boolean;
 }
 interface BindingViteResolvePluginConfig {
   resolveOptions: BindingViteResolvePluginResolveOptions;
@@ -1494,7 +1593,17 @@ interface BindingViteResolvePluginResolveOptions {
   preserveSymlinks: boolean;
   tsconfigPaths: boolean;
 }
-interface BindingWasmHelperPluginConfig {
+interface BindingViteTransformPluginConfig {
+  root: string;
+  include?: Array<BindingStringOrRegex>;
+  exclude?: Array<BindingStringOrRegex>;
+  jsxRefreshInclude?: Array<BindingStringOrRegex>;
+  jsxRefreshExclude?: Array<BindingStringOrRegex>;
+  isServerConsumer?: boolean;
+  jsxInject?: string;
+  transformOptions?: TransformOptions;
+}
+interface BindingViteWasmHelperPluginConfig {
   decodedBase: string;
 }
 interface ExternalMemoryStatus {
@@ -1515,4 +1624,4 @@ interface PreRenderedChunk {
   exports: Array<string>;
 }
 //#endregion
-export { IsolatedDeclarationsOptions as A, ResolverFactory as B, BindingViteCssPostPluginConfig as C, BindingWatcherBundler as D, BindingWasmHelperPluginConfig as E, NapiResolveOptions as F, moduleRunnerTransform as G, TransformResult as H, ParseResult as I, transform as J, parseAsync as K, ParserOptions as L, JsxOptions as M, MinifyOptions as N, BindingWatcherEvent as O, MinifyResult as P, PreRenderedChunk as R, BindingViteCssPluginConfig as S, BindingViteResolvePluginConfig as T, isolatedDeclaration as U, TransformOptions as V, minify as W, BindingReplacePluginConfig as _, BindingDynamicImportVarsPluginConfig as a, BindingTransformPluginConfig as b, BindingImportGlobPluginConfig as c, BindingMagicString as d, BindingManifestPluginConfig as f, BindingRenderedChunk as g, BindingRebuildStrategy as h, BindingClientHmrUpdate as i, IsolatedDeclarationsResult as j, ExternalMemoryStatus as k, BindingIsolatedDeclarationPluginConfig as l, BindingReactRefreshWrapperPluginConfig as m, BindingBuildImportAnalysisPluginConfig as n, BindingEsmExternalRequirePluginConfig as o, BindingModulePreloadPolyfillPluginConfig as p, parseSync as q, BindingBuiltinPluginName as r, BindingHookResolveIdExtraArgs as s, BindingAssetPluginConfig as t, BindingJsonPluginConfig as u, BindingReporterPluginConfig as v, BindingViteHtmlPluginConfig as w, BindingUrlResolver as x, BindingTransformHookExtraArgs as y, ResolveResult as z };
+export { ExternalMemoryStatus as A, ResolveResult as B, BindingViteReactRefreshWrapperPluginConfig as C, BindingViteWasmHelperPluginConfig as D, BindingViteTransformPluginConfig as E, MinifyResult as F, isolatedDeclarationSync as G, TransformOptions as H, NapiResolveOptions as I, moduleRunnerTransform as J, minify as K, ParseResult as L, IsolatedDeclarationsResult as M, JsxOptions as N, BindingWatcherBundler as O, MinifyOptions as P, transformSync as Q, ParserOptions as R, BindingViteModulePreloadPolyfillPluginConfig as S, BindingViteResolvePluginConfig as T, TransformResult as U, ResolverFactory as V, isolatedDeclaration as W, parseSync as X, parse as Y, transform as Z, BindingViteHtmlInlineProxyPluginConfig as _, BindingIsolatedDeclarationPluginConfig as a, BindingViteJsonPluginConfig as b, BindingRenderedChunk as c, BindingUrlResolver as d, BindingViteAssetPluginConfig as f, BindingViteDynamicImportVarsPluginConfig as g, BindingViteCssPostPluginConfig as h, BindingHookResolveIdExtraArgs as i, IsolatedDeclarationsOptions as j, BindingWatcherEvent as k, BindingReplacePluginConfig as l, BindingViteCssPluginConfig as m, BindingClientHmrUpdate as n, BindingMagicString as o, BindingViteBuildImportAnalysisPluginConfig as p, minifySync as q, BindingEsmExternalRequirePluginConfig as r, BindingRebuildStrategy as s, BindingBuiltinPluginName as t, BindingTransformHookExtraArgs as u, BindingViteHtmlPluginConfig as v, BindingViteReporterPluginConfig as w, BindingViteManifestPluginConfig as x, BindingViteImportGlobPluginConfig as y, PreRenderedChunk as z };