bunup 0.5.14 → 0.5.17

package/dist/index.d.cts

@@ -1,84 +1,53 @@
 import _Bun from "bun";
-
-//#region src/helpers/entry.d.ts
 type ProcessableEntry = {
-  fullPath: string;
-  /**
-  * The relative path to the output directory.
-  *
-  * This is the path that will be used to name the output file.
-  *
-  * Examples:
-  * - "src/index.ts" → "index"
-  * - "src/plugins/index.ts" → "plugins/index"
-  * - etc.
-  */
-  outputBasePath: string;
-}; //#endregion
-//#region src/plugins/types.d.ts
-/**
-* Represents a Bun plugin that can be used with Bunup
-*/
+	fullPath: string
+	outputBasePath: string | null
+	dts: boolean
+};
 type BunupBunPlugin = {
-  /** Identifies this as a native Bun plugin */
-  type: "bun";
-  /** Optional name for the plugin */
-  name?: string;
-  /** The actual Bun plugin implementation */
-  plugin: BunPlugin;
+	/** Identifies this as a native Bun plugin */
+	type: "bun"
+	/** Optional name for the plugin */
+	name?: string
+	/** The actual Bun plugin implementation */
+	plugin: BunPlugin
 };
-/**
-* Represents the output of a build operation
-*/
 type BuildOutput = {
-  /** Array of generated files with their paths and contents */
-  files: Array<{
-    /** Path to the generated file */
-    fullPath: string;
-    /** Path to the generated file relative to the root directory */
-    relativePathToRootDir: string;
-  }>;
+	/** Array of generated files with their paths and contents */
+	files: Array<{
+		/** Path to the generated file */
+		fullPath: string
+		/** Path to the generated file relative to the root directory */
+		relativePathToRootDir: string
+	}>
 };
-/**
-* Context provided to build hooks
-*/
 type BuildContext = {
-  /** The build options that were used */
-  options: BuildOptions;
-  /** The output of the build */
-  output: BuildOutput;
+	/** The build options that were used */
+	options: BuildOptions
+	/** The output of the build */
+	output: BuildOutput
 };
-/**
-* Hooks that can be implemented by Bunup plugins
-*/
 type BunupPluginHooks = {
-  /**
-  * Called when a build is successfully completed
-  * @param ctx Build context containing options and output
-  */
-  onBuildDone?: (ctx: BuildContext) => MaybePromise<void>;
-  /**
-  * Called before a build starts
-  * @param options Build options that will be used
-  */
-  onBuildStart?: (options: BuildOptions) => MaybePromise<void>;
+	/**
+	* Called when a build is successfully completed
+	* @param ctx Build context containing options and output
+	*/
+	onBuildDone?: (ctx: BuildContext) => MaybePromise<void>
+	/**
+	* Called before a build starts
+	* @param options Build options that will be used
+	*/
+	onBuildStart?: (options: BuildOptions) => MaybePromise<void>
 };
-/**
-* Represents a Bunup-specific plugin
-*/
 type BunupPlugin = {
-  /** Identifies this as a Bunup-specific plugin */
-  type: "bunup";
-  /** Optional name for the plugin */
-  name?: string;
-  /** The hooks implemented by this plugin */
-  hooks: BunupPluginHooks;
+	/** Identifies this as a Bunup-specific plugin */
+	type: "bunup"
+	/** Optional name for the plugin */
+	name?: string
+	/** The hooks implemented by this plugin */
+	hooks: BunupPluginHooks
 };
-/**
-* Union type representing all supported plugin types
-*/
-type Plugin = BunupBunPlugin | BunupPlugin; //#endregion
-//#region src/options.d.ts
+type Plugin = BunupBunPlugin | BunupPlugin;
 type Loader = NonNullable<BunBuildOptions["loader"]>[string];
 type Define = BunBuildOptions["define"];
 type Sourcemap = BunBuildOptions["sourcemap"];
@@ -88,404 +57,318 @@ type External = (string | RegExp)[];
 type Env = BunBuildOptions["env"] | Record<string, string>;
 type Entry = Arrayable<string> | Record<string, string>;
 type ShimOptions = {
-  /**
-  * Adds __dirname and __filename shims for ESM files when used
-  */
-  dirnameFilename?: boolean;
-  /**
-  * Adds import.meta.url shims for CJS files when used
-  */
-  importMetaUrl?: boolean;
+	/**
+	* Adds __dirname and __filename shims for ESM files when used
+	*/
+	dirnameFilename?: boolean
+	/**
+	* Adds import.meta.url shims for CJS files when used
+	*/
+	importMetaUrl?: boolean
 };
 type Shims = boolean | ShimOptions;
 type DtsResolve = boolean | (string | RegExp)[];
 type DtsOptions = {
-  /**
-  * Entry point files for TypeScript declaration file generation
-  *
-  * This can be:
-  * - A string path to a file
-  * - An array of file paths
-  * - An object where keys are output names and values are input file paths
-  *
-  * The key names are used for the generated declaration files.
-  * For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
-  *
-  * If not specified, the main entry points will be used for declaration file generation.
-  *
-  * If it's a string or an array of strings, the file name (without extension)
-  * will be used as the name for the output declaration file.
-  *
-  * @example
-  * // Using a string path
-  * entry: 'src/index.ts' // Generates index.d.ts
-  *
-  * // Using string paths in an array
-  * entry: ['src/index.ts']  // Generates index.d.ts
-  *
-  * // Using named outputs as an object
-  * entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.d.ts and utils.d.ts
-  *
-  * // Organizing output with subdirectories
-  * entry: { "client/index": "src/client/index.ts", "server/index": "src/server/index.ts" } // Generates client/index.d.ts and server/index.d.ts
-  */
-  entry?: Entry;
-  /**
-  * Resolve external types used in dts files from node_modules
-  */
-  resolve?: DtsResolve;
+	/**
+	* Entry point files for TypeScript declaration file generation
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated declaration files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.d.ts`
+	*
+	* If not specified, the main entry points will be used for declaration file generation.
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output declaration file.
+	*
+	* @see https://bunup.dev/docs/guide/typescript-declarations#custom-entry-points
+	* @see https://bunup.dev/docs/guide/typescript-declarations#named-entries
+	*/
+	entry?: Entry
+	/**
+	* Resolve external types used in dts files from node_modules
+	*/
+	resolve?: DtsResolve
 };
 interface BuildOptions {
-  /**
-  * Name of the build configuration
-  * Used for logging and identification purposes
-  */
-  name?: string;
-  /**
-  * Entry point files for the build
-  *
-  * This can be:
-  * - A string path to a file
-  * - An array of file paths
-  * - An object where keys are output names and values are input file paths
-  *
-  * The key names are used for the generated output files.
-  * For example, `{custom: 'src/index.ts'}` will generate `custom.js`
-  *
-  * If it's a string or an array of strings, the file name (without extension)
-  * will be used as the name for the output file.
-  *
-  * @example
-  * // Using a string path
-  * entry: 'src/index.ts' // Generates index.js
-  *
-  * // Using string paths in an array
-  * entry: ['src/index.ts']  // Generates index.js
-  *
-  * // Using named outputs as an object
-  * entry: { myModule: 'src/index.ts', utils: 'src/utility-functions.ts' } // Generates myModule.js and utils.js
-  */
-  entry: Entry;
-  /**
-  * Output directory for the bundled files
-  * Defaults to 'dist' if not specified
-  */
-  outDir: string;
-  /**
-  * Output formats for the bundle
-  * Can include 'esm', 'cjs', and/or 'iife'
-  * Defaults to ['cjs'] if not specified
-  */
-  format: Format[];
-  /**
-  * Whether to enable all minification options
-  * When true, enables minifyWhitespace, minifyIdentifiers, and minifySyntax
-  */
-  minify?: boolean;
-  /**
-  * Whether to enable code splitting
-  * Defaults to true for ESM format, false for CJS format
-  */
-  splitting?: boolean;
-  /**
-  * Whether to minify whitespace in the output
-  * Removes unnecessary whitespace to reduce file size
-  */
-  minifyWhitespace?: boolean;
-  /**
-  * Whether to minify identifiers in the output
-  * Renames variables and functions to shorter names
-  */
-  minifyIdentifiers?: boolean;
-  /**
-  * Whether to minify syntax in the output
-  * Optimizes code structure for smaller file size
-  */
-  minifySyntax?: boolean;
-  /**
-  * Whether to watch for file changes and rebuild automatically
-  */
-  watch?: boolean;
-  /**
-  * Whether to generate TypeScript declaration files (.d.ts)
-  * When set to true, generates declaration files for all entry points
-  * Can also be configured with DtsOptions for more control
-  */
-  dts?: boolean | DtsOptions;
-  /**
-  * Generate only TypeScript declaration files (.d.ts) without any JavaScript output
-  * When set to true, bunup will skip the JavaScript bundling process entirely
-  * and only generate declaration files for the specified entry points
-  *
-  * This is useful when you want to use bunup's fast declaration file generation
-  * but handle the JavaScript bundling separately or not at all.
-  *
-  * Note: When this option is true, the `dts` option is implicitly set to true
-  * and other bundling-related options are ignored.
-  *
-  * @example
-  * dtsOnly: true
-  */
-  dtsOnly?: boolean;
-  /**
-  * Path to a preferred tsconfig.json file to use for declaration generation
-  *
-  * If not specified, the tsconfig.json in the project root will be used.
-  * This option allows you to use a different TypeScript configuration
-  * specifically for declaration file generation.
-  *
-  * @example
-  * preferredTsconfigPath: './tsconfig.build.json'
-  */
-  preferredTsconfigPath?: string;
-  /**
-  * External packages that should not be bundled
-  * Useful for dependencies that should be kept as external imports
-  */
-  external?: External;
-  /**
-  * Packages that should be bundled even if they are in external
-  * Useful for dependencies that should be included in the bundle
-  */
-  noExternal?: External;
-  /**
-  * The target environment for the bundle
-  * Can be 'browser', 'bun', 'node', etc.
-  * Defaults to 'node' if not specified
-  */
-  target?: Target;
-  /**
-  * Whether to clean the output directory before building
-  * When true, removes all files in the outDir before starting a new build
-  * Defaults to true if not specified
-  */
-  clean?: boolean;
-  /**
-  * Specifies the type of sourcemap to generate
-  * Can be 'none', 'linked', 'external', or 'inline'
-  * Can also be a boolean - when true, it will use 'inline'
-  *
-  * @see https://bun.sh/docs/bundler#sourcemap
-  *
-  * @default 'none'
-  *
-  * @example
-  * sourcemap: 'linked'
-  * // or
-  * sourcemap: true // equivalent to 'inline'
-  */
-  sourcemap?: Sourcemap;
-  /**
-  * Define global constants for the build
-  * These values will be replaced at build time
-  *
-  * @see https://bun.sh/docs/bundler#define
-  *
-  * @example
-  * define: {
-  *   'process.env.NODE_ENV': '"production"',
-  *   'PACKAGE_VERSION': '"1.0.0"'
-  * }
-  */
-  define?: Define;
-  /**
-  * A callback function that runs after the build process completes
-  * This can be used for custom post-build operations like copying files,
-  * running additional tools, or logging build information
-  *
-  * If watch mode is enabled, this callback runs after each rebuild
-  *
-  * @param options The build options that were used
-  */
-  onSuccess?: (options: Partial<BuildOptions>) => MaybePromise<void>;
-  /**
-  * A banner to be added to the final bundle, this can be a directive like "use client" for react or a comment block such as a license for the code.
-  *
-  * @see https://bun.sh/docs/bundler#banner
-  *
-  * @example
-  * banner: '"use client";'
-  */
-  banner?: string;
-  /**
-  * A footer to be added to the final bundle, this can be something like a comment block for a license or just a fun easter egg.
-  *
-  * @see https://bun.sh/docs/bundler#footer
-  *
-  * @example
-  * footer: '// built with love in SF'
-  */
-  footer?: string;
-  /**
-  * Remove function calls from a bundle. For example, `drop: ["console"]` will remove all calls to `console.log`. Arguments to calls will also be removed, regardless of if those arguments may have side effects. Dropping `debugger` will remove all `debugger` statements.
-  *
-  * @see https://bun.sh/docs/bundler#drop
-  *
-  * @example
-  * drop: ["console", "debugger", "anyIdentifier.or.propertyAccess"]
-  */
-  drop?: string[];
-  /**
-  * A map of file extensions to [built-in loader names](https://bun.sh/docs/bundler/loaders#built-in-loaders). This can be used to quickly customize how certain files are loaded.
-  *
-  * @see https://bun.sh/docs/bundler#loader
-  *
-  * @example
-  * loader: {
-  *   ".png": "dataurl",
-  *   ".txt": "file",
-  * }
-  */
-  loader?: Record<string, Loader>;
-  /**
-  * Generate bytecode for the output. This can dramatically improve cold start times, but will make the final output larger and slightly increase memory usage.
-  *
-  * Bytecode is currently only supported for CommonJS (format: "cjs").
-  *
-  * Must be target: "bun"
-  *
-  * @see https://bun.sh/docs/bundler#bytecode
-  *
-  * @default false
-  */
-  bytecode?: boolean;
-  /**
-  * Disable logging during the build process. When set to true, no logs will be printed to the console.
-  *
-  * @default false
-  */
-  silent?: boolean;
-  /**
-  * You can specify a prefix to be added to specific import paths in your bundled code
-  *
-  * Used for assets, external modules, and chunk files when splitting is enabled
-  *
-  * @see https://bunup.dev/docs#public-path for more information
-  *
-  * @example
-  * publicPath: 'https://cdn.example.com/'
-  */
-  publicPath?: string;
-  /**
-  * Inject Node.js compatibility shims for ESM/CJS interoperability
-  *
-  * When set to true, automatically injects all shims when needed
-  * When set to an object, only injects the specified shims
-  *
-  * Available shims:
-  * - dirnameFilename: Adds __dirname and __filename for ESM files when used
-  * - importMetaUrl: Adds import.meta.url for CJS files when used
-  *
-  * @example
-  * // Enable all shims
-  * shims: true
-  *
-  * // Enable only specific shims
-  * shims: { dirnameFilename: true, importMetaUrl: true }
-  */
-  shims?: Shims;
-  /**
-  * Controls how environment variables are handled during bundling.
-  *
-  * Can be one of:
-  * - `"inline"`: Replaces all `process.env.FOO` references in your code with the actual values
-  *   of those environment variables at the time the build runs.
-  * - `"disable"`: Disables environment variable injection entirely, leaving `process.env.*` as-is.
-  * - A string ending in `*`: Only inlines environment variables matching the given prefix.
-  *   For example, `"MY_PUBLIC_*"` will inline variables like `MY_PUBLIC_API_URL`.
-  * - An object of key-value pairs: Replaces both `process.env.KEY` and `import.meta.env.KEY`
-  *   with the provided values, regardless of the runtime environment.
-  *
-  * Note: Values are injected at build time. Secrets or private keys should be excluded
-  * from inlining when targeting browser environments.
-  *
-  * @see https://bun.sh/docs/bundler#env to learn more about inline, disable, prefix, and object modes
-  *
-  * @example
-  * // Inline all environment variables available at build time
-  * env: "inline"
-  *
-  * // Disable all environment variable injection
-  * env: "disable"
-  *
-  * // Only inline environment variables with a specific prefix
-  * env: "PUBLIC_*"
-  *
-  * // Provide specific environment variables manually
-  * env: { API_URL: "https://api.example.com", DEBUG: "false" }
-  */
-  env?: Env;
-  /**
-  * Plugins to extend the build process functionality
-  *
-  * The Plugin type uses a discriminated union pattern with the 'type' field
-  * to support different plugin systems. Currently, only "bun" plugins are supported,
-  * but in the future, this will be extended to include "bunup" plugins as well.
-  *
-  * Each plugin type has its own specific plugin implementation:
-  * - "bun": Uses Bun's native plugin system (BunPlugin)
-  * - "bunup": Will use bunup's own plugin system (coming in future versions)
-  *
-  * This architecture allows for extensibility as more plugin systems are added.
-  *
-  * @example
-  * plugins: [
-  *   {
-  *     type: "bun",
-  *     plugin: myBunPlugin()
-  *   },
-  *   // In the future:
-  *   // {
-  *   //   type: "bunup",
-  *   //   plugin: myBunupPlugin()
-  *   // }
-  * ]
-  */
-  plugins?: Plugin[];
-  /**
-  * Customize the output file extension for each format.
-  *
-  * @param options Contains format, packageType, options, and entry information
-  * @returns Object with js and dts extensions (including the leading dot)
-  *
-  * @example
-  * outputExtension: ({ format, entry }) => ({
-  *   js: entry.outputBasePath === 'worker' ? '.worker.js' : `.${format}.js`,
-  *   dts: `.${format}.d.ts`
-  * })
-  */
-  outputExtension?: (options: {
-    format: Format;
-    packageType: string | undefined;
-    options: BuildOptions;
-    entry: ProcessableEntry;
-  }) => {
-    js: string;
-    dts: string;
-  };
-} //#endregion
-//#region src/types.d.ts
+	/**
+	* Name of the build configuration
+	* Used for logging and identification purposes
+	*/
+	name?: string;
+	/**
+	* Entry point files for the build
+	*
+	* This can be:
+	* - A string path to a file
+	* - An array of file paths
+	* - An object where keys are output names and values are input file paths
+	*
+	* The key names are used for the generated output files.
+	* For example, `{custom: 'src/index.ts'}` will generate `custom.js`
+	*
+	* If it's a string or an array of strings, the file name (without extension)
+	* will be used as the name for the output file.
+	*
+	* @see https://bunup.dev/docs/#entry-points
+	*/
+	entry: Entry;
+	/**
+	* Output directory for the bundled files
+	* Defaults to 'dist' if not specified
+	*/
+	outDir: string;
+	/**
+	* Output formats for the bundle
+	* Can include 'esm', 'cjs', and/or 'iife'
+	* Defaults to ['cjs'] if not specified
+	*/
+	format: Format[];
+	/**
+	* Whether to enable all minification options
+	* When true, enables minifyWhitespace, minifyIdentifiers, and minifySyntax
+	*/
+	minify?: boolean;
+	/**
+	* Whether to enable code splitting
+	* Defaults to true for ESM format, false for CJS format
+	*/
+	splitting?: boolean;
+	/**
+	* Whether to minify whitespace in the output
+	* Removes unnecessary whitespace to reduce file size
+	*/
+	minifyWhitespace?: boolean;
+	/**
+	* Whether to minify identifiers in the output
+	* Renames variables and functions to shorter names
+	*/
+	minifyIdentifiers?: boolean;
+	/**
+	* Whether to minify syntax in the output
+	* Optimizes code structure for smaller file size
+	*/
+	minifySyntax?: boolean;
+	/**
+	* Whether to watch for file changes and rebuild automatically
+	*/
+	watch?: boolean;
+	/**
+	* Whether to generate TypeScript declaration files (.d.ts)
+	* When set to true, generates declaration files for all entry points
+	* Can also be configured with DtsOptions for more control
+	*/
+	dts?: boolean | DtsOptions;
+	/**
+	* Path to a preferred tsconfig.json file to use for declaration generation
+	*
+	* If not specified, the tsconfig.json in the project root will be used.
+	* This option allows you to use a different TypeScript configuration
+	* specifically for declaration file generation.
+	*
+	* @example
+	* preferredTsconfigPath: './tsconfig.build.json'
+	*/
+	preferredTsconfigPath?: string;
+	/**
+	* External packages that should not be bundled
+	* Useful for dependencies that should be kept as external imports
+	*/
+	external?: External;
+	/**
+	* Packages that should be bundled even if they are in external
+	* Useful for dependencies that should be included in the bundle
+	*/
+	noExternal?: External;
+	/**
+	* The target environment for the bundle
+	* Can be 'browser', 'bun', 'node', etc.
+	* Defaults to 'node' if not specified
+	*/
+	target?: Target;
+	/**
+	* Whether to clean the output directory before building
+	* When true, removes all files in the outDir before starting a new build
+	* Defaults to true if not specified
+	*/
+	clean?: boolean;
+	/**
+	* Specifies the type of sourcemap to generate
+	* Can be 'none', 'linked', 'external', or 'inline'
+	* Can also be a boolean - when true, it will use 'inline'
+	*
+	* @see https://bun.sh/docs/bundler#sourcemap
+	*
+	* @default 'none'
+	*
+	* @example
+	* sourcemap: 'linked'
+	* // or
+	* sourcemap: true // equivalent to 'inline'
+	*/
+	sourcemap?: Sourcemap;
+	define?: Define;
+	/**
+	* A callback function that runs after the build process completes
+	* This can be used for custom post-build operations like copying files,
+	* running additional tools, or logging build information
+	*
+	* If watch mode is enabled, this callback runs after each rebuild
+	*
+	* @param options The build options that were used
+	*/
+	onSuccess?: (options: Partial<BuildOptions>) => MaybePromise<void>;
+	banner?: string;
+	/**
+	* A footer to be added to the final bundle, this can be something like a comment block for a license or just a fun easter egg.
+	*
+	* @see https://bun.sh/docs/bundler#footer
+	*
+	* @example
+	* footer: '// built with love in SF'
+	*/
+	footer?: string;
+	/**
+	* Remove function calls from a bundle. For example, `drop: ["console"]` will remove all calls to `console.log`. Arguments to calls will also be removed, regardless of if those arguments may have side effects. Dropping `debugger` will remove all `debugger` statements.
+	*
+	* @see https://bun.sh/docs/bundler#drop
+	*
+	* @example
+	* drop: ["console", "debugger", "anyIdentifier.or.propertyAccess"]
+	*/
+	drop?: string[];
+	/**
+	* A map of file extensions to [built-in loader names](https://bun.sh/docs/bundler/loaders#built-in-loaders). This can be used to quickly customize how certain files are loaded.
+	*
+	* @see https://bun.sh/docs/bundler#loader
+	*
+	* @example
+	* loader: {
+	*   ".png": "dataurl",
+	*   ".txt": "file",
+	* }
+	*/
+	loader?: Record<string, Loader>;
+	/**
+	* Generate bytecode for the output. This can dramatically improve cold start times, but will make the final output larger and slightly increase memory usage.
+	*
+	* Bytecode is currently only supported for CommonJS (format: "cjs").
+	*
+	* Must be target: "bun"
+	*
+	* @see https://bun.sh/docs/bundler#bytecode
+	*
+	* @default false
+	*/
+	bytecode?: boolean;
+	/**
+	* Disable logging during the build process. When set to true, no logs will be printed to the console.
+	*
+	* @default false
+	*/
+	silent?: boolean;
+	/**
+	* You can specify a prefix to be added to specific import paths in your bundled code
+	*
+	* Used for assets, external modules, and chunk files when splitting is enabled
+	*
+	* @see https://bunup.dev/docs#public-path for more information
+	*
+	* @example
+	* publicPath: 'https://cdn.example.com/'
+	*/
+	publicPath?: string;
+	/**
+	* Inject Node.js compatibility shims for ESM/CJS interoperability
+	*
+	* When set to true, automatically injects all shims when needed
+	* When set to an object, only injects the specified shims
+	*
+	* Available shims:
+	* - dirnameFilename: Adds __dirname and __filename for ESM files when used
+	* - importMetaUrl: Adds import.meta.url for CJS files when used
+	*
+	* @example
+	* // Enable all shims
+	* shims: true
+	*
+	* // Enable only specific shims
+	* shims: { dirnameFilename: true, importMetaUrl: true }
+	*/
+	shims?: Shims;
+	/**
+	* Controls how environment variables are handled during bundling.
+	*
+	* Can be one of:
+	* - `"inline"`: Replaces all `process.env.FOO` references in your code with the actual values
+	*   of those environment variables at the time the build runs.
+	* - `"disable"`: Disables environment variable injection entirely, leaving `process.env.*` as-is.
+	* - A string ending in `*`: Only inlines environment variables matching the given prefix.
+	*   For example, `"MY_PUBLIC_*"` will inline variables like `MY_PUBLIC_API_URL`.
+	* - An object of key-value pairs: Replaces both `process.env.KEY` and `import.meta.env.KEY`
+	*   with the provided values, regardless of the runtime environment.
+	*
+	* Note: Values are injected at build time. Secrets or private keys should be excluded
+	* from inlining when targeting browser environments.
+	*
+	* @see https://bun.sh/docs/bundler#env to learn more about inline, disable, prefix, and object modes
+	*
+	* @example
+	* // Inline all environment variables available at build time
+	* env: "inline"
+	*
+	* // Disable all environment variable injection
+	* env: "disable"
+	*
+	* // Only inline environment variables with a specific prefix
+	* env: "PUBLIC_*"
+	*
+	* // Provide specific environment variables manually
+	* env: { API_URL: "https://api.example.com", DEBUG: "false" }
+	*/
+	env?: Env;
+	plugins?: Plugin[];
+	/**
+	* Customize the output file extension for each format.
+	*
+	* @param options Contains format, packageType, options, and entry information
+	* @returns Object with js extension (including the leading dot). If dts is true, the dts file extension will be automatically derived from the js extension
+	*
+	* @example
+	* outputExtension: ({ format, entry }) => ({
+	*   js: entry.outputBasePath === 'worker' ? '.worker.js' : `.${format}.js`
+	*   // For example, if js is '.worker.js', the dts will automatically be '.worker.d.ts'
+	* })
+	*/
+	outputExtension?: (options: {
+		format: Format
+		packageType: string | undefined
+		options: BuildOptions
+		entry: ProcessableEntry
+	}) => {
+		js: string
+	};
+}
 type MaybePromise<T> = Promise<T> | T;
-type WithOptional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+type WithOptional<
+	T,
+	K extends keyof T
+> = Omit<T, K> & Partial<Pick<T, K>>;
 type Arrayable<T> = T | T[];
 type Bun = typeof _Bun;
 type BunBuildOptions = Parameters<Bun["build"]>[0];
 type BunPlugin = Exclude<BunBuildOptions["plugins"], undefined>[number];
 type DefineConfigItem = Omit<WithOptional<BuildOptions, "outDir" | "format">, "watch">;
 type DefineWorkspaceItem = {
-  name: string;
-  root: string;
-  config: DefineConfigItem | DefineConfigItem[];
+	name: string
+	root: string
+	config: DefineConfigItem | DefineConfigItem[]
 };
-
-//#endregion
-//#region src/define.d.ts
 declare function defineConfig(options: Arrayable<DefineConfigItem>): Arrayable<DefineConfigItem>;
 declare function defineWorkspace(options: DefineWorkspaceItem[]): DefineWorkspaceItem[];
-
-//#endregion
-//#region src/build.d.ts
 declare function build(partialOptions: Partial<BuildOptions>, rootDir?: string): Promise<void>;
-
-//#endregion
-export { BuildOptions, DefineConfigItem, DefineWorkspaceItem, Plugin, build, defineConfig, defineWorkspace };
+export { defineWorkspace, defineConfig, build, Plugin, DefineWorkspaceItem, DefineConfigItem, BuildOptions };