@savvy-web/bundler 0.3.0 → 0.4.0

package/README.md

@@ -202,6 +202,22 @@ const config = defineBuild({
 
 Each override carries the same `format`, `bundle`, `externals`, `bundleNodeModules`, `bundledPackages` and `dtsExternals` fields as the base config. An override does not inherit the base `externals` — list what that partition needs. The build errors if an override names an export path the package does not declare.
 
+## Loose files
+
+Every output above lands at a path the package's `exports` map addresses. Some files have to sit at a fixed name the runtime resolves by convention, outside that graph — a pnpm config dependency, for one, forbids runtime `dependencies` and resolves its `pnpmfile.mjs`/`pnpmfile.cjs` by filename at the package root. Use `looseFiles` to emit a standalone bundled file at a literal output path, with no exports entry, no declaration and no api-model:
+
+```ts
+const config = defineBuild({
+  bundleNodeModules: true,
+  looseFiles: {
+    "pnpmfile.mjs": "./src/pnpmfile.ts",
+    "pnpmfile.cjs": "./src/pnpmfile.ts",
+  },
+});
+```
+
+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.
+
 ## 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:
@@ -262,6 +278,7 @@ const config = defineBuild({
 - **Dual-format output** — esm-only by default; set `format` to `["esm", "cjs"]` for a require-able CJS output with default-export interop, `.d.cts` declarations and dual `import`/`require` export conditions.
 - **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.
+- **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.
 - **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.
@@ -272,7 +289,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`, `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`), 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` from `options.argv`, reads `package.json` at `options.cwd`, derives entries, drives the build for the selected target and renders a report. Every IO dependency on `options` is injectable for tests.
 - `parseArgs(argv)` — the argument parser behind `runBuild`, exported for embedding.
 

package/config.js

@@ -19,6 +19,7 @@ function defineBuild(input = {}) {
 		exe: input.exe,
 		format: input.format,
 		overrides: input.overrides,
+		looseFiles: input.looseFiles,
 		define: input.define
 	};
 }

package/index.d.ts

@@ -1,4 +1,4 @@
-import { BuildFormat, BuildTargetGroupsOptions, ExeConfig, GenerateMetaOptions, Json, JsxConfig, MetaOptions, MetaResult, PublishTargets, RenderedOutput, RunExeBuildOptions, TargetGroupRef, TargetResolution, TsconfigJsx, defaultManifestTransform } from "@savvy-web/tsdown-plugins";
+import { BuildFormat, BuildTargetGroupsOptions, ExeConfig, GenerateMetaOptions, Json, JsxConfig, LooseFiles, MetaOptions, MetaResult, PublishTargets, RenderedOutput, RunExeBuildOptions, TargetGroupRef, TargetResolution, TsconfigJsx, defaultManifestTransform } from "@savvy-web/tsdown-plugins";
 
 //#region src/config.d.ts
 interface BuildEntryOverride {
@@ -96,6 +96,14 @@ interface BuildConfigInput {
    * an otherwise ESM-only package (e.g. silk's `./changesets/markdownlint`).
    */
   readonly overrides?: ReadonlyArray<BuildEntryOverride> | undefined;
+  /**
+   * Standalone bundled output files emitted at literal paths (e.g. pnpm config-dependency
+   * pnpmfiles), outside the exports/dts/meta graph. Keys are literal output filenames; values
+   * are a source path (bare string) or `{ source, format }`. Format is inferred from a
+   * `.mjs`/`.cjs` key and required for an ambiguous `.js` key. Pair with `bundleNodeModules`
+   * to make each file self-contained.
+   */
+  readonly looseFiles?: LooseFiles | undefined;
   /**
    * Compile-time global replacements forwarded to the tsdown/rolldown build `define`.
    * Values are inserted VERBATIM, so string literals must be quoted:
@@ -145,6 +153,8 @@ interface BuildConfig {
   /** Output module formats forwarded to the tsdown build (esm-only by default; add "cjs" for dual-format). */
   readonly format?: ReadonlyArray<BuildFormat> | undefined;
   readonly overrides?: ReadonlyArray<BuildEntryOverride> | undefined;
+  /** Standalone bundled output files emitted at literal paths, outside the exports/dts/meta graph. */
+  readonly looseFiles?: LooseFiles | undefined;
   /** Compile-time global replacements forwarded to the build `define` (merged with the auto-version). */
   readonly define?: Record<string, string> | undefined;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/bundler",
-	"version": "0.3.0",
+	"version": "0.4.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",
@@ -28,7 +28,7 @@
 		"./package.json": "./package.json"
 	},
 	"dependencies": {
-		"@savvy-web/tsdown-plugins": "0.3.0",
+		"@savvy-web/tsdown-plugins": "0.4.0",
 		"@tsdown/exe": "^0.22.1",
 		"tsdown": "^0.22.2"
 	},

package/run.js

@@ -1,5 +1,5 @@
 import { parseArgs } from "./config.js";
-import { ConfigValidator, ConfigValidatorLive, ReportPipelineLive, buildTargetGroups, createEntryName, generateMeta, normalizeExeOptions, normalizeMetaOptions, packageJsonEntries, readTsconfigJsx, removeDeclarationMaps, renderReport, resolveJsxConfig, resolveTargets, runExeBuild, writeResolvedTsconfig, writeTargetsBinding } from "@savvy-web/tsdown-plugins";
+import { ConfigValidator, ConfigValidatorLive, ReportPipelineLive, buildTargetGroups, createEntryName, generateMeta, normalizeExeOptions, normalizeLooseFiles, normalizeMetaOptions, packageJsonEntries, readTsconfigJsx, removeDeclarationMaps, renderReport, resolveJsxConfig, resolveTargets, runExeBuild, writeResolvedTsconfig, writeTargetsBinding } from "@savvy-web/tsdown-plugins";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { Effect } from "effect";
@@ -73,7 +73,8 @@ async function runBuild(config, options) {
 		...publishTargets !== void 0 ? { targets: publishTargets } : {},
 		...config.exe !== void 0 ? { exe: config.exe } : {},
 		osCpu: osCpuForValidate,
-		...config.meta !== void 0 && config.meta !== false ? { meta: config.meta } : {}
+		...config.meta !== void 0 && config.meta !== false ? { meta: config.meta } : {},
+		...config.looseFiles !== void 0 ? { looseFiles: config.looseFiles } : {}
 	})).pipe(Effect.provide(ConfigValidatorLive)));
 	if (target === "meta") {
 		if (config.meta === false) {
@@ -160,6 +161,7 @@ async function runBuild(config, options) {
 		baseEntries = onlyBase;
 		dualExports = dualExportKeys;
 	}
+	const looseFiles = config.looseFiles !== void 0 ? normalizeLooseFiles(config.looseFiles) : void 0;
 	const startMs = Date.now();
 	const { groups, resolution } = target === "dev" ? {
 		groups: [{
@@ -186,7 +188,8 @@ async function runBuild(config, options) {
 		...config.format !== void 0 ? { format: config.format } : {},
 		...config.define !== void 0 ? { define: config.define } : {},
 		...overridePartitions.length > 0 ? { overrides: overridePartitions } : {},
-		...dualExports !== void 0 ? { dualExports } : {}
+		...dualExports !== void 0 ? { dualExports } : {},
+		...looseFiles !== void 0 ? { looseFiles } : {}
 	});
 	if (target === "prod" && resolution !== void 0) writeBinding(cwd, resolution);
 	if (target === "prod" && config.meta !== false) {