bunup 0.14.8 → 0.14.10

package/README.md

@@ -5,42 +5,84 @@
 <div align="center">
 
   <!-- markdownlint-disable-next-line no-alt-text -->
+  ![Logo](/docs/public/logo.svg)
 
+  ![Bunup](/assets/bunup-title.svg)
 
-![Logo](https://raw.githubusercontent.com/bunup/bunup/refs/heads/main/docs/public/logo.svg)
+  [![NPM Version](https://img.shields.io/npm/v/bunup?logo=npm&logoColor=212121&label=version&labelColor=ffc44e&color=212121)](https://npmjs.com/package/bunup)
+  [![Built with Bun](https://img.shields.io/badge/Built_with-Bun-fbf0df?logo=bun&labelColor=212121)](https://bun.sh)
+  [![sponsor](https://img.shields.io/badge/sponsor-EA4AAA?logo=githubsponsors&labelColor=FAFAFA)](https://github.com/sponsors/arshad-yaseen)
 
-![Bunup](https://raw.githubusercontent.com/bunup/bunup/refs/heads/main/assets/bunup-title.svg)
+  Bunup helps you ship TypeScript/React libraries faster with great DX — built on Bun.
+</div>
+<!-- markdownlint-restore -->
 
-[![NPM Version](https://img.shields.io/npm/v/bunup?logo=npm&logoColor=212121&label=version&labelColor=ffc44e&color=212121)](https://npmjs.com/package/bunup) [![Built with Bun](https://img.shields.io/badge/Built_with-Bun-fbf0df?logo=bun&labelColor=212121)](https://bun.sh) [![sponsor](https://img.shields.io/badge/sponsor-EA4AAA?logo=githubsponsors&labelColor=FAFAFA)](https://github.com/sponsors/arshad-yaseen)
+## Performance
 
-Bunup is the **blazing-fast build tool** for TypeScript libraries, designed for flawless developer experience and speed, **powered by Bun**.
+Instant builds by design. With Bun’s native speed, builds and rebuilds are extremely quick, even in monorepos. Faster feedback loops, higher productivity, calmer flow.
 
-</div>
-<!-- markdownlint-restore -->
+## 🚀 Quick Start
 
-## Features
+Create a TypeScript file:
 
-- ⚡ **Instant Builds**: Instant builds and rebuilds by default.
-- 📝 **Top-Notch TypeScript Declarations**: Clean, minimal, accurate `.d.ts` files generated automatically.
-- 📦 **ESM by Default**: Modern ESM output by default.
-- 🪓 **[Declaration Splitting](https://bunup.dev/docs/guide/typescript-declarations#declaration-splitting)**: Splits shared types for smaller, cleaner `.d.ts` files.
-- 🔥 **[Declaration Minification](https://bunup.dev/docs/guide/typescript-declarations#minification)**: Aggressively minifies and shortens type names while preserving public API.
-- 🔋 **Batteries Included**: Auto-generates package exports, detects unused dependencies, and more.
-- 🏗️ **[Workspace](https://bunup.dev/docs/guide/workspaces) Ready**: Builds multiple packages from one config and command.
+```ts
+// src/index.ts
+export function greet(name: string): string {
+  return `Hello, ${name}!`;
+}
+```
 
-## 📚 Documentation
+Build it instantly:
 
-To get started, visit the [documentation](https://bunup.dev).
+```bash
+bunx bunup
+```
 
-## ❤️ Contributing
+Outputs to `dist/` with ESM and `.d.ts` types.
+
+Need CommonJS too?
+
+```bash
+bunx bunup --format esm,cjs
+```
+
+Want to generate and sync package exports automatically?
+
+```bash
+bunx bunup --exports
+```
+
+## Scaffold
 
-For guidelines on contributing, please read the [contributing guide](CONTRIBUTING.md).
+Spin up a modern, ready-to-publish TypeScript or React component library (or a basic starter) in ~10 seconds:
 
-We welcome contributions from the community to enhance Bunup's capabilities and make it even more powerful.
+```bash
+bunx @bunup/cli@latest create
+```
 
-![Sponsors](https://cdn.jsdelivr.net/gh/arshad-yaseen/static/sponsors.svg)
+See more in [Scaffold with Bunup](./docs/scaffold-with-bunup.md).
+
+## Features
+
+- ⚡ **Instant builds** — lightning-fast by default
+- 🎨 **CSS support out of the box** — import CSS directly, with built-in CSS Modules support.
+- 📝 **TypeScript declarations** — clean, accurate `.d.ts` files
+- 🪓 **[Declaration splitting](https://bunup.dev/docs/guide/typescript-declarations#declaration-splitting)** — smaller, cleaner type bundles
+- 🔋 **Batteries included** — auto-exports, unused dependency detection, and more
+- 🏗️ **[Workspace-ready](https://bunup.dev/docs/guide/workspaces)** — build multiple packages from one config and one command
+
+For more, see the full documentation: https://bunup.dev
+
+## ❤️ Contributing
+
+We welcome contributions! Please read the [contributing guide](CONTRIBUTING.md).
 
 <div align="center">
 
-  ![______ 🐈‍⬛ _____________](assets/cat-footer.svg)
+  <img src="https://cdn.jsdelivr.net/gh/arshad-yaseen/static/sponsors.svg" alt="Sponsors" />
+
+  <br /><br />
+
+  <img src="assets/cat-footer.svg" alt="______ 🐈‍⬛ _____________" />
+
 </div>

package/dist/cli/index.js

@@ -5,7 +5,7 @@ import {
   printBuildReport,
   processLoadedConfigs,
   resolveBuildOptions
-} from "../shared/bunup-yt7y3w4v.js";
+} from "../shared/bunup-nsnkrmw3.js";
 import {
   BunupCLIError,
   BunupWatchError,
@@ -18,13 +18,13 @@ import {
   logTime,
   logger,
   parseErrorMessage
-} from "../shared/bunup-r5agr54b.js";
+} from "../shared/bunup-er5nnjqp.js";
 
 // packages/bunup/src/cli/index.ts
 import { loadConfig } from "coffi";
 import pc3 from "picocolors";
 // packages/bunup/package.json
-var version = "0.14.8";
+var version = "0.14.10";
 
 // packages/bunup/src/watch.ts
 import path from "path";
@@ -94,18 +94,19 @@ async function watch(userOptions, rootDir) {
 // packages/bunup/src/cli/options.ts
 import pc2 from "picocolors";
 import { cli, z } from "zlye";
-var program = cli().name("bunup").version(version).description("A blazing-fast build tool for your TypeScript/React libraries \u2014 built on Bun").with({
+var program = cli().name("bunup").version(version).description("A blazing-fast build tool for your TypeScript/React libraries - built on Bun").with({
   ignoreOptionDefaultValue: true
 }).example([
-  pc2.gray(`${pc2.blue("bunup src/index.ts")}                            # Basic build`),
+  pc2.gray(`${pc2.blue("bunup")}                            # Basic build`),
+  pc2.gray(`${pc2.blue("bunup src/index.ts")}               # Single entry file`),
   pc2.gray(`${pc2.blue("bunup src/**/*.ts")}                             # Glob pattern for multiple files`),
-  pc2.gray(`${pc2.blue("bunup src/index.ts --watch")}                    # Watch mode`),
-  pc2.gray(`${pc2.blue("bunup src/index.ts --format cjs,esm")}           # Multiple formats`),
-  pc2.gray(`${pc2.blue("bunup src/index.ts --target bun")}               # Bun target`),
-  pc2.gray(`${pc2.blue("bunup src/index.ts src/cli.ts")}                 # Multiple entries`),
-  pc2.gray(`${pc2.blue("bunup src/index.ts --dts.splitting")}            # Declaration splitting`),
-  pc2.gray(`${pc2.blue("bunup src/index.ts --no-clean")}                 # Disable cleaning output directory before build`)
-]).option("entry", z.union(z.string().describe("Entry file or glob pattern"), z.array(z.string()).describe("Multiple entry files or globs")).alias("e").optional()).option("config", z.string().describe("Path to configuration file").alias("c").example("./configs/custom.bunup.config.js").optional()).option("filter", z.array(z.string()).describe("Filter workspace packages by name").optional()).option("name", z.string().describe("Name of the build configuration (for logging and identification)").example("my-library").optional()).option("out-dir", z.string().describe("Output directory for bundled files").alias("o").default("dist")).option("format", z.union(z.string().choices(["esm", "cjs", "iife"]).describe("Single output format"), z.array(z.string().choices(["esm", "cjs", "iife"])).describe("Multiple output formats")).alias("f").default("esm")).option("minify", z.boolean().describe("Enable all minification options (whitespace, identifiers, syntax)").optional()).option("minify-whitespace", z.boolean().describe("Minify whitespace in the output to reduce file size").optional()).option("minify-identifiers", z.boolean().describe("Minify identifiers by renaming variables to shorter names").optional()).option("minify-syntax", z.boolean().describe("Minify syntax by optimizing code structure").optional()).option("watch", z.boolean().describe("Watch for file changes and rebuild automatically").optional()).option("clean", z.boolean().describe("Clean the output directory before building").default(true)).option("silent", z.boolean().describe("Disable logging during the build process").alias("q").optional()).option("splitting", z.boolean().describe("Enable code splitting").default(true, "enabled by default for ESM format")).option("conditions", z.array(z.string()).describe("Package.json export conditions for import resolution").optional()).option("target", z.string().choices(["bun", "node", "browser"]).describe("Target environment for the bundle").alias("t").default("node")).option("external", z.array(z.string()).describe("External packages that should not be bundled").optional()).option("no-external", z.array(z.string()).describe("Packages that should be bundled even if listed in external").optional()).option("shims", z.boolean().describe("Enable shims for Node.js globals and ESM/CJS interoperability").optional()).option("report", z.object({
+  pc2.gray(`${pc2.blue("bunup --watch")}                    # Watch mode`),
+  pc2.gray(`${pc2.blue("bunup --format cjs,esm")}           # Multiple formats`),
+  pc2.gray(`${pc2.blue("bunup --target bun")}               # Bun target`),
+  pc2.gray(`${pc2.blue("bunup src/cli.ts")}                 # Multiple entries`),
+  pc2.gray(`${pc2.blue("bunup --dts.splitting")}            # Declaration splitting`),
+  pc2.gray(`${pc2.blue("bunup --no-clean")}                 # Disable cleaning output directory before build`)
+]).option("entry", z.union(z.string().describe("Entry file or glob pattern"), z.array(z.string()).describe("Multiple entry files or globs")).alias("e").optional()).option("config", z.union(z.string().describe("Path to a custom configuration file").alias("c").example("./configs/custom.bunup.config.js"), z.boolean().describe("Whether to use a configuration file").default(true)).optional()).option("filter", z.array(z.string()).describe("Filter workspace packages by name").optional()).option("name", z.string().describe("Name of the build configuration (for logging and identification)").example("my-library").optional()).option("out-dir", z.string().describe("Output directory for bundled files").alias("o").default("dist")).option("format", z.union(z.string().choices(["esm", "cjs", "iife"]).describe("Single output format"), z.array(z.string().choices(["esm", "cjs", "iife"])).describe("Multiple output formats")).alias("f").default("esm")).option("minify", z.boolean().describe("Enable all minification options (whitespace, identifiers, syntax)").optional()).option("minify-whitespace", z.boolean().describe("Minify whitespace in the output to reduce file size").optional()).option("minify-identifiers", z.boolean().describe("Minify identifiers by renaming variables to shorter names").optional()).option("minify-syntax", z.boolean().describe("Minify syntax by optimizing code structure").optional()).option("watch", z.boolean().describe("Watch for file changes and rebuild automatically").optional()).option("clean", z.boolean().describe("Clean the output directory before building").default(true)).option("silent", z.boolean().describe("Disable logging during the build process").alias("q").optional()).option("splitting", z.boolean().describe("Enable code splitting").default(true, "enabled by default for ESM format")).option("conditions", z.array(z.string()).describe("Package.json export conditions for import resolution").optional()).option("target", z.string().choices(["bun", "node", "browser"]).describe("Target environment for the bundle").alias("t").default("node")).option("external", z.array(z.string()).describe("External packages that should not be bundled").optional()).option("no-external", z.array(z.string()).describe("Packages that should be bundled even if listed in external").optional()).option("shims", z.boolean().describe("Enable shims for Node.js globals and ESM/CJS interoperability").optional()).option("report", z.object({
   gzip: z.boolean().describe("Enable gzip compression size calculation").default(true),
   brotli: z.boolean().describe("Enable brotli compression size calculation").optional(),
   "max-bundle-size": z.number().describe("Maximum bundle size in bytes. Will warn if exceeded").optional()
@@ -127,8 +128,19 @@ var program = cli().name("bunup").version(version).description("A blazing-fast b
   "text",
   "css",
   "html"
-])).describe("File extension to loader mapping").example("--loader.'.css'=text --loader.'.txt'=file").optional()).option("public-path", z.string().describe("Public path prefix for assets and chunk files").example("https://cdn.example.com/").optional()).option("ignore-dce-annotations", z.boolean().describe("Ignore dead code elimination annotations (@__PURE__, sideEffects)")).option("emit-dce-annotations", z.boolean().describe("Force emit @__PURE__ annotations even with minification")).option("on-success", z.string().describe("Command to run after successful build").optional()).option("css", z.object({
-  "typed-modules": z.boolean().describe("Generate TypeScript definitions for CSS modules").default(true)
+])).describe("File extension to loader mapping").example("--loader.'.css'=text --loader.'.txt'=file").optional()).option("public-path", z.string().describe("Public path prefix for assets and chunk files").example("https://cdn.example.com/").optional()).option("ignore-dce-annotations", z.boolean().describe("Ignore dead code elimination annotations (@__PURE__, sideEffects)")).option("emit-dce-annotations", z.boolean().describe("Force emit @__PURE__ annotations even with minification")).option("on-success", z.string().describe("Command to run after successful build").optional()).option("exports", z.union(z.boolean(), z.object({
+  exclude: z.array(z.string()).describe("Entry points to exclude from exports field").optional(),
+  "exclude-css": z.boolean().describe("Whether to exclude CSS files from exports field").optional(),
+  "include-package-json": z.boolean().describe('Whether to include "./package.json" in exports field').default(true),
+  all: z.boolean().describe("Whether to add wildcard export for deep imports").optional()
+})).describe("Configure automatic package.json exports generation").optional()).option("unused", z.union(z.boolean(), z.object({
+  level: z.string().choices(["warn", "error"]).describe("The level of reporting for unused dependencies").default("warn"),
+  ignore: z.array(z.string()).describe("Dependencies to ignore when checking for unused dependencies").optional()
+})).describe("Detect and report unused dependencies").optional()).option("css", z.object({
+  "typed-modules": z.boolean().describe("Generate TypeScript definitions for CSS modules").default(true),
+  inject: z.union(z.boolean(), z.object({
+    minify: z.boolean().describe("Whether to minify the styles being injected").optional()
+  })).describe("Inject CSS styles into document head at runtime").optional()
 }).optional()).rest("entries", z.string().describe("Entry point files to bundle"));
 var parseCliOptions = (argv) => {
   const result = program.parse(argv);
@@ -147,13 +159,17 @@ var parseCliOptions = (argv) => {
 async function main(args = Bun.argv.slice(2)) {
   const cliOptions = parseCliOptions(args);
   const cwd = process.cwd();
-  const { config, filepath } = await loadConfig({
-    name: "bunup.config",
-    extensions: [".ts", ".js", ".mjs", ".cjs"],
-    maxDepth: 1,
-    preferredPath: cliOptions.config,
-    packageJsonProperty: "bunup"
-  });
+  let loadedConfig;
+  if (cliOptions.config !== false) {
+    loadedConfig = await loadConfig({
+      name: "bunup.config",
+      extensions: [".ts", ".js", ".mjs", ".cjs"],
+      maxDepth: 1,
+      preferredPath: typeof cliOptions.config === "string" ? cliOptions.config : undefined,
+      packageJsonProperty: "bunup"
+    });
+  }
+  const { config, filepath } = loadedConfig ?? {};
   const configsToProcess = !config ? [{ rootDir: cwd, options: cliOptions }] : await processLoadedConfigs(config, cwd, cliOptions.filter);
   const shouldSilent = cliOptions.watch || cliOptions.silent || configsToProcess.some((c) => ensureArray(c.options).some((o) => o.silent));
   if (shouldSilent) {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Arrayable, BuildContext, BuildMeta, BuildOptions, BuildOutput, BuildOutputFile, BunupPlugin, DefineConfigItem, DefineWorkspaceItem, WithOptional } from "./shared/bunup-s6gfzz2v";
+import { Arrayable, BuildContext, BuildMeta, BuildOptions, BuildOutput, BuildOutputFile, BunupPlugin, DefineConfigItem, DefineWorkspaceItem, WithOptional } from "./shared/bunup-zenttvjh";
 declare function build(userOptions: Partial<BuildOptions>, rootDir?: string): Promise<BuildOutput>;
 declare function defineConfig(options: Arrayable<DefineConfigItem>): Arrayable<DefineConfigItem>;
 declare function defineWorkspace(options: WithOptional<DefineWorkspaceItem, "config">[], sharedOptions?: Partial<DefineConfigItem>): DefineWorkspaceItem[];

package/dist/index.js

@@ -1,8 +1,8 @@
 // @bun
 import {
   build
-} from "./shared/bunup-yt7y3w4v.js";
-import"./shared/bunup-r5agr54b.js";
+} from "./shared/bunup-nsnkrmw3.js";
+import"./shared/bunup-er5nnjqp.js";
 // packages/bunup/src/define.ts
 function defineConfig(options) {
   return options;

package/dist/plugins.d.ts

@@ -1,13 +1,40 @@
-import { BuildContext, BunupPlugin, BunupPluginHooks, MaybePromise } from "./shared/bunup-s6gfzz2v";
+import { BuildOptions, BunupPlugin, BunupPluginHooks, exports, injectStyles, unused } from "./shared/bunup-zenttvjh";
 type CopyOptions = {
 	/** Whether to follow symbolic links when copying files. */
 	followSymlinks?: boolean
 	/** Whether to exclude dotfiles (files starting with a dot) from being copied. */
 	excludeDotfiles?: boolean
+	/** Whether to override existing files. Default: true */
+	override?: boolean
+	/**
+	* Behavior in watch mode:
+	* - 'changed': Only copy files that have changed (default)
+	* - 'always': Always copy all files on each build
+	* - 'skip': Skip copying in watch mode
+	*/
+	watchMode?: "changed" | "always" | "skip"
+};
+type TransformContext = {
+	/** The file content */
+	content: string | ArrayBuffer
+	/** The source file path */
+	path: string
+	/** The destination file path */
+	destination: string
+	/** Build options */
+	options: BuildOptions
 };
+type TransformResult = string | ArrayBuffer | {
+	content: string | ArrayBuffer
+	filename: string
+};
+type TransformFunction = (context: TransformContext) => TransformResult | Promise<TransformResult>;
 /**
 * A plugin that copies files and directories to the output directory.
 *
+* @warning When copying large files or directories, this may impact build performance.
+* Consider using symlinks for very large files when appropriate.
+*
 * @see https://bunup.dev/docs/builtin-plugins/copy
 */
 declare function copy(pattern: string | string[]): BunupPlugin & CopyBuilder;
@@ -15,6 +42,8 @@ declare class CopyBuilder {
 	private _patterns;
 	private _destination?;
 	private _options?;
+	private _transform?;
+	private _fileCache;
 	constructor(pattern: string | string[]);
 	/**
 	* Sets the destination directory or file path where files will be copied.
@@ -25,118 +54,18 @@ declare class CopyBuilder {
 	* Sets additional options for the copy operation.
 	*/
 	with(options: CopyOptions): this;
-	get name(): string;
-	get hooks(): BunupPluginHooks;
-}
-type CustomExports = Record<string, string | Record<string, string | Record<string, string>>>;
-type Exclude = ((ctx: BuildContext) => string[] | undefined) | string[];
-interface ExportsPluginOptions {
-	/**
-	* Additional export fields to preserve alongside automatically generated exports
-	*
-	* @see https://bunup.dev/docs/builtin-plugins/exports#customexports
-	*/
-	customExports?: (ctx: BuildContext) => CustomExports | undefined;
 	/**
-	* Entry points to exclude from the exports field
-	*
-	* @see https://bunup.dev/docs/builtin-plugins/exports#exclude
+	* Transforms file contents during copy operation.
+	* Useful for modifying files on the fly (e.g., replacing tokens, minifying, etc.)
 	*/
-	exclude?: Exclude;
-	/**
-	* Whether to exclude CSS files from being added to the exports field
-	*
-	* @default false
-	*/
-	excludeCss?: boolean;
-	/**
-	* Whether to include "./package.json": "./package.json" in the exports field
-	*
-	* @default true
-	* @see https://bunup.dev/docs/builtin-plugins/exports#includepackagejson
-	*/
-	includePackageJson?: boolean;
-	/**
-	* Whether to add a wildcard export that allows deep imports
-	*
-	* When true, adds "./*": "./*" to exports, making all files accessible
-	* When false (default), only explicit exports are accessible
-	*
-	* @default false
-	* @see https://bunup.dev/docs/builtin-plugins/exports#all
-	*/
-	all?: boolean;
+	transform(fn: TransformFunction): this;
+	get name(): string;
+	get hooks(): BunupPluginHooks;
+	private copyFileWithTransform;
 }
-/**
-* A plugin that generates the exports field in the package.json file automatically.
-*
-* @see https://bunup.dev/docs/builtin-plugins/exports
-*/
-declare function exports(options?: ExportsPluginOptions): BunupPlugin;
 import { BunPlugin } from "bun";
-type InjectStylesPluginOptions = {
-	/**
-	* Custom function to inject CSS into the document head.
-	*
-	* By default, bunup uses its own `injectStyle` function that creates a `<style>`
-	* tag and appends it to the document head. You can provide your own injection
-	* logic to customize how styles are applied to the document.
-	*
-	* @param css - The processed CSS string (already JSON stringified)
-	* @param filePath - The original file path of the CSS file being processed
-	* @returns JavaScript code that will inject the styles when executed
-	*
-	* @example
-	* ```ts
-	* injectStyles({
-	*   inject: (css, filePath) => {
-	*     return `
-	*       const style = document.createElement('style');
-	*       style.setAttribute('data-source', '${filePath}');
-	*       style.textContent = ${css};
-	*       document.head.appendChild(style);
-	*     `;
-	*   }
-	* })
-	* ```
-	*
-	* The default injection handles cases like when `document` is undefined (e.g., server-side rendering) and compatibility with older browsers. Consider these when implementing custom injection logic.
-	*/
-	inject?: (css: string, filePath: string) => MaybePromise<string>
-	/**
-	* Whether to minify the styles being injected.
-	*
-	* @default true
-	*/
-	minify?: boolean
-};
-/**
-* A plugin that injects styles into the document head at runtime instead of bundling them to the build output.
-*
-* @see https://bunup.dev/docs/builtin-plugins/inject-styles
-*/
-declare function injectStyles(options?: InjectStylesPluginOptions): BunPlugin;
-import { BunPlugin as BunPlugin2 } from "bun";
 /**
 * A plugin that provides shims for Node.js globals and ESM/CJS interoperability.
 */
-declare function shims(): BunPlugin2;
-interface UnusedOptions {
-	/**
-	* The level of reporting for unused dependencies
-	* @default 'warn'
-	*/
-	level?: "warn" | "error";
-	/**
-	* Dependencies to ignore when checking for unused dependencies
-	* @default []
-	*/
-	ignore?: string[];
-}
-/**
-* A plugin that detects and reports unused dependencies.
-*
-* @see https://bunup.dev/docs/builtin-plugins/unused
-*/
-declare function unused(options?: UnusedOptions): BunupPlugin;
+declare function shims(): BunPlugin;
 export { unused, shims, injectStyles, exports, copy };