rolldown 0.12.2 → 0.13.0-snapshot-d24c337-20240904003206

package/dist/types/binding.d.ts

@@ -18,6 +18,7 @@ export declare class BindingModuleInfo {
 
 export declare class BindingOutputAsset {
   get fileName(): string
+  get originalFileName(): string | null
   get source(): BindingAssetSource
   set source(source: BindingAssetSource)
   get name(): string | null
@@ -90,33 +91,80 @@ export interface AliasItem {
 }
 
 export interface ArrowFunctionsBindingOptions {
+  /**
+   * This option enables the following:
+   * * Wrap the generated function in .bind(this) and keeps uses of this inside the function as-is, instead of using a renamed this.
+   * * Add a runtime check to ensure the functions are not instantiated.
+   * * Add names to arrow functions.
+   *
+   * @default false
+   */
   spec?: boolean
 }
 
+export interface BindingAliasPluginAlias {
+  find: BindingStringOrRegex
+  replacement: string
+}
+
+export interface BindingAliasPluginConfig {
+  entries: Array<BindingAliasPluginAlias>
+}
+
 export interface BindingAssetSource {
   inner: string | Uint8Array
 }
 
+export interface BindingBuildImportAnalysisPluginConfig {
+  preloadCode: string
+  insertPreload: boolean
+  optimizeModulePreloadRelativePaths: boolean
+  renderBuiltUrl: boolean
+  isRelativeBase: boolean
+}
+
 export interface BindingBuiltinPlugin {
-  name: BindingBuiltinPluginName
+  __name: BindingBuiltinPluginName
   options?: unknown
 }
 
 export declare enum BindingBuiltinPluginName {
-  WasmPlugin = 0,
-  GlobImportPlugin = 1
+  WasmHelperPlugin = 0,
+  ImportGlobPlugin = 1,
+  DynamicImportVarsPlugin = 2,
+  ModulePreloadPolyfillPlugin = 3,
+  ManifestPlugin = 4,
+  LoadFallbackPlugin = 5,
+  TransformPlugin = 6,
+  WasmFallbackPlugin = 7,
+  AliasPlugin = 8,
+  JsonPlugin = 9,
+  BuildImportAnalysisPlugin = 10,
+  ReplacePlugin = 11
 }
 
 export interface BindingEmittedAsset {
   name?: string
   fileName?: string
+  originalFileName?: string
   source: BindingAssetSource
 }
 
+export interface BindingGeneralHookFilter {
+  include?: Array<BindingStringOrRegex>
+  exclude?: Array<BindingStringOrRegex>
+}
+
+export interface BindingGlobImportPluginConfig {
+  root?: string
+  restoreQueryExtension?: boolean
+}
+
 export interface BindingHookLoadOutput {
   code: string
   sideEffects?: BindingHookSideEffects
   map?: BindingSourcemap
+  moduleType?: string
 }
 
 export interface BindingHookRenderChunkOutput {
@@ -124,7 +172,8 @@ export interface BindingHookRenderChunkOutput {
   map?: BindingSourcemap
 }
 
-export interface BindingHookResolveIdExtraOptions {
+export interface BindingHookResolveIdExtraArgs {
+  custom?: number
   isEntry: boolean
   kind: 'import' | 'dynamic-import' | 'require-call'
 }
@@ -145,6 +194,20 @@ export interface BindingHookTransformOutput {
   code?: string
   sideEffects?: BindingHookSideEffects
   map?: BindingSourcemap
+  moduleType?: string
+}
+
+export interface BindingInjectImportNamed {
+  tagNamed: true
+  imported: string
+  alias?: string
+  from: string
+}
+
+export interface BindingInjectImportNamespace {
+  tagNamespace: true
+  alias: string
+  from: string
 }
 
 export interface BindingInputItem {
@@ -164,6 +227,13 @@ export interface BindingInputOptions {
   cwd: string
   treeshake?: BindingTreeshake
   moduleTypes?: Record<string, string>
+  define?: Array<[string, string]>
+  inject?: Array<BindingInjectImportNamed | BindingInjectImportNamespace>
+}
+
+export interface BindingJsonPluginConfig {
+  stringify?: boolean
+  isBuild?: boolean
 }
 
 export interface BindingJsonSourcemap {
@@ -182,16 +252,32 @@ export declare enum BindingLogLevel {
   Debug = 3
 }
 
+export interface BindingManifestPluginConfig {
+  root: string
+  outPath: string
+}
+
+export interface BindingModulePreloadPolyfillPluginConfig {
+  skip?: boolean
+}
+
 export interface BindingOutputOptions {
   name?: string
-  entryFileNames?: string
-  chunkFileNames?: string
+  entryFileNames?: string | ((chunk: PreRenderedChunk) => string)
+  chunkFileNames?: string | ((chunk: PreRenderedChunk) => string)
   assetFileNames?: string
   banner?: (chunk: RenderedChunk) => MaybePromise<VoidNullable<string>>
   dir?: string
+  esModule?: boolean | 'if-default-prop'
   exports?: 'default' | 'named' | 'none' | 'auto'
+  extend?: boolean
+  externalLiveBindings?: boolean
   footer?: (chunk: RenderedChunk) => MaybePromise<VoidNullable<string>>
   format?: 'es' | 'cjs' | 'iife'
+  globals?: Record<string, string>
+  inlineDynamicImports?: boolean
+  intro?: (chunk: RenderedChunk) => MaybePromise<VoidNullable<string>>
+  outro?: (chunk: RenderedChunk) => MaybePromise<VoidNullable<string>>
   plugins: (BindingBuiltinPlugin | BindingPluginOptions | undefined)[]
   sourcemap?: 'file' | 'inline' | 'hidden'
   sourcemapIgnoreList?: (source: string, sourcemapPath: string) => boolean
@@ -206,24 +292,58 @@ export interface BindingPluginContextResolvedId {
 
 export interface BindingPluginContextResolveOptions {
   importKind?: 'import' | 'dynamic-import' | 'require-call'
+  skipSelf?: boolean
+  custom?: number
+}
+
+export interface BindingPluginHookMeta {
+  order?: BindingPluginOrder
 }
 
 export interface BindingPluginOptions {
   name: string
   buildStart?: (ctx: BindingPluginContext) => MaybePromise<VoidNullable>
-  resolveId?: (ctx: BindingPluginContext, specifier: string, importer: Nullable<string>, options: BindingHookResolveIdExtraOptions) => MaybePromise<VoidNullable<BindingHookResolveIdOutput>>
+  buildStartMeta?: BindingPluginHookMeta
+  resolveId?: (ctx: BindingPluginContext, specifier: string, importer: Nullable<string>, options: BindingHookResolveIdExtraArgs) => MaybePromise<VoidNullable<BindingHookResolveIdOutput>>
+  resolveIdMeta?: BindingPluginHookMeta
+  resolveIdFilter?: BindingGeneralHookFilter
   resolveDynamicImport?: (ctx: BindingPluginContext, specifier: string, importer: Nullable<string>) => MaybePromise<VoidNullable<BindingHookResolveIdOutput>>
+  resolveDynamicImportMeta?: BindingPluginHookMeta
   load?: (ctx: BindingPluginContext, id: string) => MaybePromise<VoidNullable<BindingHookLoadOutput>>
-  transform?: (ctx:  BindingTransformPluginContext, id: string, code: string) => MaybePromise<VoidNullable<BindingHookTransformOutput>>
+  loadMeta?: BindingPluginHookMeta
+  loadFilter?: BindingGeneralHookFilter
+  transform?: (ctx:  BindingTransformPluginContext, id: string, code: string, module_type: BindingTransformHookExtraArgs) => MaybePromise<VoidNullable<BindingHookTransformOutput>>
+  transformMeta?: BindingPluginHookMeta
+  transformFilter?: BindingTransformHookFilter
   moduleParsed?: (ctx: BindingPluginContext, module: BindingModuleInfo) => MaybePromise<VoidNullable>
+  moduleParsedMeta?: BindingPluginHookMeta
   buildEnd?: (ctx: BindingPluginContext, error: Nullable<string>) => MaybePromise<VoidNullable>
+  buildEndMeta?: BindingPluginHookMeta
   renderChunk?: (ctx: BindingPluginContext, code: string, chunk: RenderedChunk) => MaybePromise<VoidNullable<BindingHookRenderChunkOutput>>
+  renderChunkMeta?: BindingPluginHookMeta
   augmentChunkHash?: (ctx: BindingPluginContext, chunk: RenderedChunk) => MaybePromise<void | string>
+  augmentChunkHashMeta?: BindingPluginHookMeta
   renderStart?: (ctx: BindingPluginContext) => void
+  renderStartMeta?: BindingPluginHookMeta
   renderError?: (ctx: BindingPluginContext, error: string) => void
+  renderErrorMeta?: BindingPluginHookMeta
   generateBundle?: (ctx: BindingPluginContext, bundle: BindingOutputs, isWrite: boolean) => MaybePromise<VoidNullable>
+  generateBundleMeta?: BindingPluginHookMeta
   writeBundle?: (ctx: BindingPluginContext, bundle: BindingOutputs) => MaybePromise<VoidNullable>
+  writeBundleMeta?: BindingPluginHookMeta
   banner?: (ctx: BindingPluginContext, chunk: RenderedChunk) => void
+  bannerMeta?: BindingPluginHookMeta
+  footer?: (ctx: BindingPluginContext, chunk: RenderedChunk) => void
+  footerMeta?: BindingPluginHookMeta
+  intro?: (ctx: BindingPluginContext, chunk: RenderedChunk) => void
+  introMeta?: BindingPluginHookMeta
+  outro?: (ctx: BindingPluginContext, chunk: RenderedChunk) => void
+  outroMeta?: BindingPluginHookMeta
+}
+
+export declare enum BindingPluginOrder {
+  Pre = 0,
+  Post = 1
 }
 
 export interface BindingPluginWithIndex {
@@ -235,6 +355,13 @@ export interface BindingRenderedModule {
   code?: string
 }
 
+export interface BindingReplacePluginConfig {
+  values: Record<string, string>
+  delimiters?: [string, string]
+  preventAssignment?: boolean
+  objectGuards?: boolean
+}
+
 export interface BindingResolveOptions {
   alias?: Array<AliasItem>
   aliasFields?: Array<Array<string>>
@@ -252,11 +379,42 @@ export interface BindingSourcemap {
   inner: string | BindingJsonSourcemap
 }
 
+/**
+ * For String, value is the string content, flag is the `None`
+ * For Regex, value is the regular expression, flag is the `Some()`.
+ * Make sure put a `Some("")` in flag even there is no flag in regexp.
+ */
+export interface BindingStringOrRegex {
+  value: string
+  /**
+   * There is a more compact way to represent this, `Option<u8>` with bitflags, but it will be hard
+   * to use(in js side), since construct a `JsRegex` is not used frequently. Optimize it when it is needed.
+   */
+  flag?: string
+}
+
+export interface BindingTransformHookExtraArgs {
+  moduleType: string
+}
+
+export interface BindingTransformHookFilter {
+  code?: BindingGeneralHookFilter
+  moduleType?: Array<string>
+  id?: BindingGeneralHookFilter
+}
+
+export interface BindingTransformPluginConfig {
+  include?: Array<BindingStringOrRegex>
+  exclude?: Array<BindingStringOrRegex>
+  jsxInject?: string
+}
+
 export interface BindingTreeshake {
   moduleSideEffects: string
 }
 
 export interface Es2015BindingOptions {
+  /** Transform arrow functions into function expressions. */
   arrowFunction?: ArrowFunctionsBindingOptions
 }
 
@@ -268,15 +426,97 @@ export interface IsolatedDeclarationsResult {
   errors: Array<string>
 }
 
+export interface PreRenderedChunk {
+  name: string
+  isEntry: boolean
+  isDynamicEntry: boolean
+  facadeModuleId?: string
+  moduleIds: Array<string>
+  exports: Array<string>
+}
+
+/**
+ * Configure how TSX and JSX are transformed.
+ *
+ * @see [@babel/plugin-transform-react-jsx](https://babeljs.io/docs/babel-plugin-transform-react-jsx#options)
+ */
 export interface ReactBindingOptions {
+  /**
+   * Decides which runtime to use.
+   *
+   * - 'automatic' - auto-import the correct JSX factories
+   * - 'classic' - no auto-import
+   *
+   * @default 'automatic'
+   */
   runtime?: 'classic' | 'automatic'
+  /**
+   * Emit development-specific information, such as `__source` and `__self`.
+   *
+   * @default false
+   *
+   * @see [@babel/plugin-transform-react-jsx-development](https://babeljs.io/docs/babel-plugin-transform-react-jsx-development)
+   */
   development?: boolean
+  /**
+   * Toggles whether or not to throw an error if an XML namespaced tag name
+   * is used.
+   *
+   * Though the JSX spec allows this, it is disabled by default since React's
+   * JSX does not currently have support for it.
+   *
+   * @default true
+   */
   throwIfNamespace?: boolean
+  /**
+   * Enables [@babel/plugin-transform-react-pure-annotations](https://babeljs.io/docs/en/babel-plugin-transform-react-pure-annotations).
+   *
+   * It will mark top-level React method calls as pure for tree shaking.
+   *
+   * @default true
+   */
   pure?: boolean
+  /**
+   * Replaces the import source when importing functions.
+   *
+   * @default 'react'
+   */
   importSource?: string
+  /**
+   * Replace the function used when compiling JSX expressions. It should be a
+   * qualified name (e.g. `React.createElement`) or an identifier (e.g.
+   * `createElement`).
+   *
+   * Only used for `classic` {@link runtime}.
+   *
+   * @default 'React.createElement'
+   */
   pragma?: string
+  /**
+   * Replace the component used when compiling JSX fragments. It should be a
+   * valid JSX tag name.
+   *
+   * Only used for `classic` {@link runtime}.
+   *
+   * @default 'React.Fragment'
+   */
   pragmaFrag?: string
+  /**
+   * When spreading props, use `Object.assign` directly instead of an extend helper.
+   *
+   * Only used for `classic` {@link runtime}.
+   *
+   * @default false
+   */
   useBuiltIns?: boolean
+  /**
+   * When spreading props, use inline object with spread elements directly
+   * instead of an extend helper or Object.assign.
+   *
+   * Only used for `classic` {@link runtime}.
+   *
+   * @default false
+   */
   useSpread?: boolean
 }
 
@@ -295,7 +535,7 @@ export interface RenderedChunk {
   dynamicImports: Array<string>
 }
 
-export interface Sourcemap {
+export interface SourceMap {
   file?: string
   mappings?: string
   sourceRoot?: string
@@ -304,28 +544,93 @@ export interface Sourcemap {
   names?: Array<string>
 }
 
+/**
+ * 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.
+ */
 export declare function transform(filename: string, sourceText: string, options?: TransformOptions | undefined | null): TransformResult
 
+/**
+ * Options for transforming a JavaScript or TypeScript file.
+ *
+ * @see {@link transform}
+ */
 export interface TransformOptions {
   sourceType?: 'script' | 'module' | 'unambiguous' | undefined
-  /** Force jsx parsing, */
+  /**
+   * The current working directory. Used to resolve relative paths in other
+   * options.
+   */
+  cwd?: string
+  /**
+   * Force jsx parsing,
+   *
+   * @default false
+   */
   jsx?: boolean
+  /** Configure how TypeScript is transformed. */
   typescript?: TypeScriptBindingOptions
+  /** Configure how TSX and JSX are transformed. */
   react?: ReactBindingOptions
+  /** Enable ES2015 transformations. */
   es2015?: Es2015BindingOptions
   /**
-   * Enable Sourcemap
+   * Enable source map generation.
+   *
+   * When `true`, the `sourceMap` field of transform result objects will be populated.
    *
-   * * `true` to generate a sourcemap for the code and include it in the result object.
+   * @default false
    *
-   * Default: false
+   * @see {@link SourceMap}
    */
   sourcemap?: boolean
 }
 
 export interface TransformResult {
+  /**
+   * The transformed code.
+   *
+   * If parsing failed, this will be an empty string.
+   */
   sourceText: string
-  map?: Sourcemap
+  /**
+   * The source map for the transformed code.
+   *
+   * This will be set if {@link TransformOptions#sourcemap} is `true`.
+   */
+  sourceMap?: SourceMap
+  /**
+   * The `.d.ts` declaration file for the transformed code. Declarations are
+   * only generated if `declaration` is set to `true` and a TypeScript file
+   * is provided.
+   *
+   * If parsing failed and `declaration` is set, this will be an empty string.
+   *
+   * @see {@link TypeScriptBindingOptions#declaration}
+   * @see [declaration tsconfig option](https://www.typescriptlang.org/tsconfig/#declaration)
+   */
+  declaration?: string
+  /**
+   * Declaration source map. Only generated if both
+   * {@link TypeScriptBindingOptions#declaration declaration} and
+   * {@link TransformOptions#sourcemap sourcemap} are set to `true`.
+   */
+  declarationMap?: SourceMap
+  /**
+   * Parse and transformation errors.
+   *
+   * Oxc's parser recovers from common syntax errors, meaning that
+   * transformed code may still be available even if there are errors in this
+   * list.
+   */
   errors: Array<string>
 }
 
@@ -335,5 +640,15 @@ export interface TypeScriptBindingOptions {
   onlyRemoveTypeImports?: boolean
   allowNamespaces?: boolean
   allowDeclareFields?: boolean
+  /**
+   * Also generate a `.d.ts` declaration file for TypeScript files.
+   *
+   * The source file must be compliant with all
+   * [`isolatedDeclarations`](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-5-5.html#isolated-declarations)
+   * requirements.
+   *
+   * @default false
+   */
+  declaration?: boolean
 }
 

package/dist/types/cli/arguments/alias.d.ts

@@ -0,0 +1,8 @@
+import { CliOptions } from './schema';
+export interface OptionConfig {
+    abbreviation?: string;
+    description?: string;
+    default?: string | boolean;
+    hint?: string;
+}
+export declare const alias: Partial<Record<keyof CliOptions, OptionConfig>>;

package/dist/types/cli/arguments/index.d.ts

@@ -0,0 +1,13 @@
+export declare const flattenedSchema: Record<string, import("./types").Schema>;
+export declare const options: {
+    [k: string]: {
+        type: "boolean" | "string";
+        multiple: boolean;
+        short?: string;
+        default?: boolean | string | string[];
+        hint?: string;
+        description?: string;
+    };
+};
+export type ParseArgsOptions = typeof options;
+export declare function parseCliArguments(): import("./normalize").NormalizedCliOptions;

package/dist/types/cli/arguments/normalize.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @description This file is used for normalize the options.
+ * In CLI, the input options and output options are mixed together. We need to tell them apart.
+ */
+import { InputOptions } from '../../options/input-options';
+import { OutputOptions } from '../../options/output-options';
+import { CliOptions } from './schema';
+export interface NormalizedCliOptions {
+    input: InputOptions;
+    output: OutputOptions;
+    help: boolean;
+    config: string;
+    version: boolean;
+}
+export declare function normalizeCliOptions(cliOptions: CliOptions, positionals: string[]): NormalizedCliOptions;