@savvy-web/bundler 0.9.2 → 0.11.0

package/README.md

@@ -59,7 +59,8 @@ The bundler ships its shared TypeScript base as a subpath export. Extend it from
 
 ```json
 {
-  "extends": ["@savvy-web/bundler/ecma.json"]
+ "$schema": "https://json.schemastore.org/tsconfig",
+ "extends": ["@savvy-web/bundler/tsconfig/ecma.json"]
 }
 ```
 
@@ -227,6 +228,26 @@ const config = defineBuild({
 
 Each key is the literal output filename written into the package root; each value is a source path (a bare string) or a `{ source, format }` object. The format is inferred from the key extension — `.mjs` is ESM, `.cjs` is CJS — so the example above bundles the one source into both an ESM and a CJS file from a single config. A `.js` key is format-ambiguous and needs an explicit `format`. Pair `looseFiles` with `bundleNodeModules` so each file is self-contained, since a config dependency cannot resolve runtime `dependencies` of its own.
 
+## Plugins
+
+Pass your own tsdown/rolldown plugins with the `plugins` field. They are forwarded to every tsdown pass the build performs — the JavaScript pass, the bundled-declaration pass, the per-module declarations pass and each `looseFiles` pass — so a plugin's `resolveId`/`load` hooks are available everywhere your source is compiled. The use case is build-time codegen and virtual modules: a plugin can serve a module that exists only at build time, and any of your sources can `import` it.
+
+```ts
+import { defineBuild } from "@savvy-web/bundler";
+import { PnpmConfigPlugin } from "pnpm-config-builder";
+
+const config = defineBuild({
+  plugins: [PnpmConfigPlugin()],
+  bundleNodeModules: true,
+  looseFiles: {
+    "pnpmfile.mjs": "./src/pnpmfile.ts",
+    "pnpmfile.cjs": "./src/pnpmfile.ts",
+  },
+});
+```
+
+Because the plugins run on the `looseFiles` pass too, a `pnpmfile` source can `import` a virtual module the plugin resolves — here a config-dependency plugin serves the module the pnpmfile needs, and the pnpmfile lands at the package root as a self-contained bundle. Plugins are a rolldown concept; the supplied plugin objects are passed through to tsdown untouched.
+
 ## Minified output
 
 Prod output is not minified by default. This builder targets Node libraries, where readable output matters more than bundle size — minified code degrades stack traces and trips some security scanners. Set `minify` to opt back in:
@@ -288,6 +309,7 @@ const config = defineBuild({
 - **Dependency bundling** — declared dependencies stay external by default; `bundle`, `bundleNodeModules`, `bundledPackages` and `dtsExternals` force-inline specific packages or all node_modules into the output, inline select declarations into the `.d.ts` or hold a package out of the declaration bundle when its types cannot be inlined.
 - **Per-entry overrides** — `overrides` pins a subset of export entries to their own format and bundling, so one entry can ship dual-format CJS in an otherwise ESM-only package without changing the rest; partition-only `platform`, `css` and `outSubdir` fields also let an entry build for the browser with CSS modules into its own sub-package.
 - **Loose files** — `looseFiles` emits standalone bundled files at literal output paths outside the exports/declaration/api-model graph, with the format inferred from the key extension; pair with `bundleNodeModules` for self-contained pnpm config-dependency pnpmfiles.
+- **Custom plugins** — `plugins` forwards your own rolldown plugins to every tsdown pass, including the `looseFiles` pass, so build-time codegen and virtual modules resolve everywhere your source is compiled.
 - **Readable prod output** — prod output is unminified by default to keep stack traces legible and pass security scanners; `minify` opts back in.
 - **Default manifest stripping** — the published `package.json` drops build- and dev-only fields automatically; a custom `transform` replaces the default and can re-apply it via `defaultManifestTransform`.
 - **Build-time constants** — the package version is injected as `process.env.__PACKAGE_VERSION__`, and the `define` field adds your own verbatim compile-time replacements.
@@ -298,7 +320,7 @@ const config = defineBuild({
 
 ## API
 
-- `defineBuild(input)` — normalizes a build config (`externals`, `bundle`, `bundleNodeModules`, `bundledPackages`, `dtsExternals`, `minify`, `devManifest`, `transform`, `output`, `meta`, `jsx`, `exe`, `format`, `overrides`, `looseFiles`, `define`), applying defaults. The `format` field controls the output module formats forwarded to tsdown (esm-only by default; add `"cjs"` for a dual-format esm+cjs build). `minify` defaults to false, `transform` defaults to a manifest stripper, and `overrides` pins a subset of entries to their own format and bundling. Pure; it does not run the build.
+- `defineBuild(input)` — normalizes a build config (`externals`, `bundle`, `bundleNodeModules`, `bundledPackages`, `dtsExternals`, `minify`, `devManifest`, `transform`, `output`, `meta`, `jsx`, `exe`, `format`, `overrides`, `looseFiles`, `define`, `plugins`), applying defaults. The `format` field controls the output module formats forwarded to tsdown (esm-only by default; add `"cjs"` for a dual-format esm+cjs build). `minify` defaults to false, `transform` defaults to a manifest stripper, and `overrides` pins a subset of entries to their own format and bundling. Pure; it does not run the build.
 - `runBuild(config, options)` — the orchestrator. Parses `--target`/`--watch`/`--verbose` from `options.argv`, reads `package.json` at `options.cwd`, derives entries, drives the build for the selected target and renders a report. `--verbose` expands the report to a per-file table; the report is quiet by default. Every IO dependency on `options` is injectable for tests.
 - `parseArgs(argv)` — the argument parser behind `runBuild`, exported for embedding.
 

package/config.js

@@ -24,7 +24,8 @@ function defineBuild(input = {}) {
 		format: input.format,
 		overrides: input.overrides,
 		looseFiles: input.looseFiles,
-		define: input.define
+		define: input.define,
+		plugins: input.plugins
 	};
 }
 /** Parse the build CLI argv into the normalized target/flags shape. @public */

package/index.d.ts

@@ -1,4 +1,5 @@
 import { BuildFormat, BuildPlatform, BuildReport, BuildTargetGroupsOptions, CssOptions, ExeConfig, GenerateMetaOptions, Json, JsxConfig, LooseFiles, MetaOptions, MetaResult, NextVersions, PublishTargets, RenderedOutput, RunExeBuildOptions, TargetGroupRef, TargetResolution, TsconfigJsx, defaultManifestTransform } from "@savvy-web/tsdown-plugins";
+import { Plugin, Plugin as Plugin$1 } from "rolldown";
 
 //#region src/config.d.ts
 /** @public */
@@ -125,6 +126,14 @@ interface BuildConfigInput {
    * `process.env.__PACKAGE_VERSION__` define; a user key of the same name wins.
    */
   readonly define?: Record<string, string> | undefined;
+  /**
+   * Custom tsdown/rolldown plugins forwarded to EVERY tsdown run the build
+   * performs — the JS pass, the dts pass, the per-module declarations pass, and
+   * each looseFiles pass. Use for build-time codegen / virtual modules (e.g. a
+   * pnpm config-dependency plugin). Plugins run after the builder's internal
+   * interop plugins and before its metrics instrumentation.
+   */
+  readonly plugins?: ReadonlyArray<Plugin$1> | undefined;
 }
 /** @public */
 interface BuildConfig {
@@ -172,6 +181,8 @@ interface BuildConfig {
   readonly looseFiles?: LooseFiles | undefined;
   /** Compile-time global replacements forwarded to the build `define` (merged with the auto-version). */
   readonly define?: Record<string, string> | undefined;
+  /** Custom tsdown/rolldown plugins forwarded to every tsdown run (JS, dts, per-module declarations, looseFiles). */
+  readonly plugins?: ReadonlyArray<Plugin$1> | undefined;
 }
 /**
  * Normalize + validate a defineBuild config. Pure when imported; self-runs when entry (see run.ts).
@@ -235,5 +246,5 @@ interface RunOptions {
 /** Run a build from a normalized config. Pure orchestration; all IO injectable. @public */
 declare function runBuild(config: BuildConfig, options: RunOptions): Promise<void>;
 //#endregion
-export { type BuildConfig, type BuildConfigInput, type BuildEntryOverride, type OutputConfig, type ParsedArgs, type RunOptions, defaultManifestTransform, defineBuild, parseArgs, runBuild };
+export { type BuildConfig, type BuildConfigInput, type BuildEntryOverride, type OutputConfig, type ParsedArgs, type Plugin, type RunOptions, defaultManifestTransform, defineBuild, parseArgs, runBuild };
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/bundler",
-	"version": "0.9.2",
+	"version": "0.11.0",
 	"private": false,
 	"description": "Zero-config tsdown-based bundler for Silk Suite TypeScript packages",
 	"homepage": "https://github.com/savvy-web/systems/tree/main/packages/bundler",
@@ -29,9 +29,10 @@
 		"./package.json": "./package.json"
 	},
 	"dependencies": {
-		"@savvy-web/tsdown-plugins": "0.9.2",
+		"@savvy-web/tsdown-plugins": "0.11.0",
 		"@tsdown/exe": "^0.22.1",
 		"effect": "^3.21.4",
+		"rolldown": "^1.1.2",
 		"tsdown": "^0.22.3"
 	},
 	"peerDependencies": {

package/run.js

@@ -224,7 +224,9 @@ async function runBuild(config, options) {
 			...dualExports !== void 0 ? { dualExports } : {},
 			...subdirExports.size > 0 ? { subdirExports } : {},
 			...looseFiles !== void 0 ? { looseFiles } : {},
+			...config.plugins !== void 0 ? { extraPlugins: config.plugins } : {},
 			...exeRewrite !== void 0 ? { exeRewrite } : {},
+			...target === "prod" ? { emitDeclarations: true } : {},
 			collector,
 			verbose
 		});