bunup 0.8.56 → 0.8.58

package/dist/plugins.d.ts

@@ -1,4 +1,344 @@
-import { BuildContext, BunupPlugin, MaybePromise, Plugin } from "./chunk-w6swmckt";
+import { BunPlugin } from "bun";
+import { GenerateDtsOptions } from "typeroll";
+type Loader = "js" | "jsx" | "ts" | "tsx" | "json" | "toml" | "file" | "napi" | "wasm" | "text" | "css" | "html";
+type Define = Record<string, string>;
+type Sourcemap = "none" | "linked" | "inline" | "external" | "linked" | boolean;
+type Format = "esm" | "cjs" | "iife";
+type Target = "bun" | "node" | "browser";
+type External = (string | RegExp)[];
+type Env = "inline" | "disable" | `${string}*` | Record<string, string>;
+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
+	*
+	* @see https://bunup.dev/docs/#entry-points
+	*/
+	entry: string | string[];
+	/**
+	* 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 | (Pick<GenerateDtsOptions, "resolve" | "splitting" | "minify"> & {
+		entry?: string | string[]
+	});
+	/**
+	* 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.
+	*
+	* Bun target is for generating bundles that are intended to be run by the Bun runtime. In many cases,
+	* it isn't necessary to bundle server-side code; you can directly execute the source code
+	* without modification. However, bundling your server code can reduce startup times and
+	* improve running performance.
+	*
+	* All bundles generated with `target: "bun"` are marked with a special `// @bun` pragma, which
+	* indicates to the Bun runtime that there's no need to re-transpile the file before execution.
+	*/
+	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;
+	/**\\n\\t* Define global constants for the build\\n\\t* These values will be replaced at build time\\n\\t*\\n\\t* @see https://bun.sh/docs/bundler#define\\n\\t*\\n\\t* @example\\n\\t* define: {\\n\\t*   'process.env.NODE_ENV': '"production"',\\n\\t*   'PACKAGE_VERSION': '"1.0.0"'\\n\\t* }\\n\\t*/
+	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>;
+	/**\\n\\t* 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.\\n\\t*\\n\\t* @see https://bun.sh/docs/bundler#banner\\n\\t*\\n\\t* @example\\n\\t* banner: '"use client";'\\n\\t*/
+	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?: { [k in 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;
+	/**
+	* 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;
+	/**
+	* Ignore dead code elimination/tree-shaking annotations such as @__PURE__ and package.json
+	* "sideEffects" fields. This should only be used as a temporary workaround for incorrect
+	* annotations in libraries.
+	*/
+	ignoreDCEAnnotations?: boolean;
+	/**
+	* Force emitting @__PURE__ annotations even if minify.whitespace is true.
+	*/
+	emitDCEAnnotations?: boolean;
+	/**\\n\\t* Plugins to extend the build process functionality\\n\\t*\\n\\t* The Plugin type uses a discriminated union pattern with the 'type' field\\n\\t* to support different plugin systems. Both "bun" and "bunup" plugins are supported.\\n\\t*\\n\\t* Each plugin type has its own specific plugin implementation:\\n\\t* - "bun": Uses Bun's native plugin system (BunPlugin)\\n\\t* - "bunup": Uses bunup's own plugin system with lifecycle hooks\\n\\t*\\n\\t* This architecture allows for extensibility as more plugin systems are added.\\n\\t*\\n\\t* @see https://bunup.dev/docs/advanced/plugin-development for more information on plugins\\n\\t*\\n\\t* @example\\n\\t* plugins: [\\n\\t*   {\\n\\t*     type: "bun",\\n\\t*     plugin: myBunPlugin()\\n\\t*   },\\n\\t*   {\\n\\t*     type: "bunup",\\n\\t*     hooks: {\\n\\t*       onBuildStart: (options) => {\\n\\t*         console.log('Build started with options:', options)\\n\\t*       },\\n\\t*       onBuildDone: ({ options, output }) => {\\n\\t*         console.log('Build completed with output:', output)\\n\\t*       }\\n\\t*     }\\n\\t*   }\\n\\t* ]\\n\\t*/
+	plugins?: Plugin[];
+}
+type MaybePromise<T> = Promise<T> | T;
+type PackageJson = {
+	/** The parsed content of the package.json file */
+	data: Record<string, any> | null
+	/** The path to the package.json file */
+	path: string | null
+};
+/**
+* Represents a Bun plugin that can be used with Bunup
+*/
+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
+};
+/**
+* Represents the meta data of the build
+*/
+type BuildMeta = {
+	/** The package.json file */
+	packageJson: PackageJson
+	/** The root directory of the build */
+	rootDir: string
+};
+type BuildOutputFile = {
+	/**
+	* The entry point for which this file was generated
+	*
+	* Undefined for non-entry point files (e.g., assets, sourcemaps, chunks)
+	*/
+	entrypoint: string | undefined
+	/** The kind of the file */
+	kind: "entry-point" | "chunk" | "asset" | "sourcemap" | "bytecode"
+	/** Path to the generated file */
+	fullPath: string
+	/** Path to the generated file relative to the root directory */
+	relativePathToRootDir: string
+	/** Path to the generated file relative to the output directory */
+	relativePathToOutputDir: string
+	/** Whether the file is a dts file */
+	dts: boolean
+	/** The format of the output file */
+	format: Format
+};
+/**
+* Represents the output of a build operation
+*/
+type BuildOutput = {
+	/** Array of generated files with their paths and contents */
+	files: BuildOutputFile[]
+};
+/**
+* Context provided to build hooks
+*/
+type BuildContext = {
+	/** The build options that were used */
+	options: BuildOptions
+	/** The output of the build */
+	output: BuildOutput
+	/** The meta data of the build */
+	meta: BuildMeta
+};
+/**
+* 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>
+};
+/**
+* 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
+};
+/**
+* Union type representing all supported plugin types
+*/
+type Plugin = BunupBunPlugin | BunupPlugin;
 /**
 * A plugin that copies files and directories to the output directory.
 *
@@ -8,7 +348,7 @@ import { BuildContext, BunupPlugin, MaybePromise, Plugin } from "./chunk-w6swmck
 */
 declare function copy(patterns: string[], outPath?: string): BunupPlugin;
 type CustomExports = Record<string, string | Record<string, string | Record<string, string>>>;
-type Exclude = ((ctx: BuildContext) => string[] | undefined) | string[];
+type Exclude2 = ((ctx: BuildContext) => string[] | undefined) | string[];
 interface ExportsPluginOptions {
 	/**
 	* Additional export fields to preserve alongside automatically generated exports
@@ -21,7 +361,7 @@ interface ExportsPluginOptions {
 	*
 	* @see https://bunup.dev/docs/plugins/exports#exclude
 	*/
-	exclude?: Exclude;
+	exclude?: Exclude2;
 }
 /**
 * A plugin that generates the exports field in the package.json file automatically.

package/dist/plugins.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   getPackageForPlugin
-} from "./chunk-zpjpa5th.js";
+} from "./chunk-0j56xynx.js";
 import {
   CSS_RE,
   JS_DTS_RE,
@@ -9,7 +9,7 @@ import {
   cleanPath,
   isDirectoryPath,
   logger
-} from "./chunk-cakmscpb.js";
+} from "./chunk-2g0gpaee.js";
 
 // src/plugins/built-in/copy.ts
 import { basename, join } from "path";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bunup",
   "description": "⚡ A blazing-fast build tool for your libraries built with Bun.",
-  "version": "0.8.56",
+  "version": "0.8.58",
   "type": "module",
   "files": [
     "dist"
@@ -53,7 +53,7 @@
     "picocolors": "^1.1.1",
     "replace-in-file": "^8.3.0",
     "tinyexec": "^1.0.1",
-    "typeroll": "^0.6.15"
+    "typeroll": "^0.6.16"
   },
   "devDependencies": {
     "@babel/types": "^7.27.7",