bunup 0.5.9 → 0.5.11

package/dist/plugins.d.ts

@@ -1,23 +1,21 @@
 import _Bun from "bun";
 
-//#region \0dts:/home/runner/work/bunup/bunup/packages/bunup/src/helpers/entry.d.ts
+//#region packages/bunup/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 \0dts:/home/runner/work/bunup/bunup/packages/bunup/src/types.d.ts
+  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 packages/bunup/src/types.d.ts
 type MaybePromise<T> = Promise<T> | T;
 type Arrayable<T> = T | T[];
 type Bun = typeof _Bun;
@@ -25,7 +23,7 @@ type BunBuildOptions = Parameters<Bun["build"]>[0];
 type BunPlugin = Exclude<BunBuildOptions["plugins"], undefined>[number];
 
 //#endregion
-//#region \0dts:/home/runner/work/bunup/bunup/packages/bunup/src/options.d.ts
+//#region packages/bunup/src/options.d.ts
 type Loader = NonNullable<BunBuildOptions["loader"]>[string];
 type Define = BunBuildOptions["define"];
 type Sourcemap = BunBuildOptions["sourcemap"];
@@ -35,467 +33,443 @@ 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.
+  *
+  * @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;
 };
 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 \0dts:/home/runner/work/bunup/bunup/packages/bunup/src/plugins/types.d.ts
-/**
-* Represents a Bun plugin that can be used with Bunup
-*/
+  /**
+  * 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 packages/bunup/src/plugins/types.d.ts
 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 \0dts:/home/runner/work/bunup/bunup/packages/bunup/src/plugins/built-in/report.d.ts
+//#region packages/bunup/src/plugins/built-in/report.d.ts
 type ReportPluginOptions = {
-	/**
-	* The maximum bundle size in bytes.
-	* If the bundle size exceeds this limit, a error will be logged without failing the build.
-	*/
-	maxBundleSize?: number
-	/**
-	* Whether to show gzip sizes in the report.
-	* When enabled, the report will include an additional column with the gzip size of each file.
-	* @default true
-	*/
-	gzip?: boolean
+  /**
+  * The maximum bundle size in bytes.
+  * If the bundle size exceeds this limit, a error will be logged without failing the build.
+  */
+  maxBundleSize?: number;
+  /**
+  * Whether to show gzip sizes in the report.
+  * When enabled, the report will include an additional column with the gzip size of each file.
+  * @default true
+  */
+  gzip?: boolean;
 };
-/**
-* A plugin that logs a report of the bundle size.
-* @param options - The options for the report plugin.
-*/
 declare function report(options?: ReportPluginOptions): BunupPlugin;
 
 //#endregion