@savvy-web/mcp 1.3.3 → 1.3.4

package/public/content/packages/bundler/api/function/definebuild.md

@@ -0,0 +1,18 @@
+---
+id: packages/bundler/api/function/definebuild
+title: "defineBuild — bundler function"
+summary: "Normalize + validate a defineBuild config. Pure when imported; self-runs when entry (see run.ts)."
+tier: packages
+source: generated
+tags: [bundler, api]
+priority: 0.3
+related: []
+---
+
+# defineBuild
+
+Normalize + validate a [defineBuild](silk://packages/bundler/api/function/definebuild) config. Pure when imported; self-runs when entry (see run.ts).
+
+```ts
+function defineBuild(input?: BuildConfigInput): BuildConfig;
+```

package/public/content/packages/bundler/api/function/parseargs.md

@@ -0,0 +1,18 @@
+---
+id: packages/bundler/api/function/parseargs
+title: "parseArgs — bundler function"
+summary: "Parse the build CLI argv into the normalized target/flags shape."
+tier: packages
+source: generated
+tags: [bundler, api]
+priority: 0.3
+related: []
+---
+
+# parseArgs
+
+Parse the build CLI argv into the normalized target/flags shape.
+
+```ts
+function parseArgs(argv: ReadonlyArray<string>): ParsedArgs;
+```

package/public/content/packages/bundler/api/function/runbuild.md

@@ -0,0 +1,18 @@
+---
+id: packages/bundler/api/function/runbuild
+title: "runBuild — bundler function"
+summary: "Run a build from a normalized config. Pure orchestration; all IO injectable."
+tier: packages
+source: generated
+tags: [bundler, api]
+priority: 0.3
+related: []
+---
+
+# runBuild
+
+Run a build from a normalized config. Pure orchestration; all IO injectable.
+
+```ts
+function runBuild(config: BuildConfig, options: RunOptions): Promise<void>;
+```

package/public/content/packages/bundler/api/interface/buildconfig.md

@@ -0,0 +1,147 @@
+---
+id: packages/bundler/api/interface/buildconfig
+title: "BuildConfig — bundler interface"
+summary: "interface BuildConfig from @savvy-web/bundler."
+tier: packages
+source: generated
+tags: [bundler, api]
+priority: 0.3
+related: []
+---
+
+# BuildConfig
+
+```ts
+interface BuildConfig
+```
+
+## Members
+
+### bundle
+
+```ts
+readonly bundle?: ReadonlyArray<string> | undefined;
+```
+
+Force-bundle (inline) these packages into the JS output (tsdown `deps.alwaysBundle`). Inverse of `externals`.
+
+### bundledPackages
+
+```ts
+readonly bundledPackages?: ReadonlyArray<string> | undefined;
+```
+
+External packages whose type declarations are inlined into the bundled dts (the rslib `dtsBundledPackages` equivalent). Only these node_modules packages are rolled into the emitted `.d.ts`; all other deps stay external.
+
+### bundleNodeModules
+
+```ts
+readonly bundleNodeModules?: boolean | undefined;
+```
+
+Force-bundle node_modules (and workspace) JS dependencies that are not externalized into the package output (rslib parity). Threads tsdown `deps.skipNodeModulesBundle: false` into BOTH the JS output and the bundled declarations — the dts posture tracks the JS posture, inlining node_modules types into the `.d.ts`. Defaults to false.
+
+### define
+
+```ts
+readonly define?: Record<string, string> | undefined;
+```
+
+Compile-time global replacements forwarded to the build `define` (merged with the auto-version).
+
+### devManifest
+
+```ts
+readonly devManifest: "preserve" | "resolve";
+```
+
+### dtsExternals
+
+```ts
+readonly dtsExternals?: ReadonlyArray<string> | undefined;
+```
+
+Packages externalized in the dts pass ONLY — referenced via `import` in the emitted `.d.ts` rather than inlined — while the JS pass still bundles them per `bundleNodeModules`. Use when a dependency's types cannot be safely inlined (e.g. effect's cross-module `declare module` augmentations). Declare these as package dependencies so consumers can resolve the emitted type imports.
+
+### exe
+
+```ts
+readonly exe?: ExeConfig | ReadonlyArray<ExeConfig> | undefined;
+```
+
+### externals
+
+```ts
+readonly externals: ReadonlyArray<string>;
+```
+
+### format
+
+```ts
+readonly format?: ReadonlyArray<BuildFormat> | undefined;
+```
+
+Output module formats forwarded to the tsdown build (esm-only by default; add "cjs" for dual-format).
+
+### formats
+
+```ts
+readonly formats: ReadonlyArray<"esm">;
+```
+
+### jsx
+
+```ts
+readonly jsx?: JsxConfig | undefined;
+```
+
+### looseFiles
+
+```ts
+readonly looseFiles?: LooseFiles | undefined;
+```
+
+Standalone bundled output files emitted at literal paths, outside the exports/dts/meta graph.
+
+### meta
+
+```ts
+readonly meta?: MetaOptions | false | undefined;
+```
+
+### minify
+
+```ts
+readonly minify?: boolean | undefined;
+```
+
+Minify prod output (prod groups only; dev is never minified). [defineBuild](silk://packages/bundler/api/function/definebuild) defaults this to false.
+
+### output
+
+```ts
+readonly output?: OutputConfig | undefined;
+```
+
+### overrides
+
+```ts
+readonly overrides?: ReadonlyArray<BuildEntryOverride> | undefined;
+```
+
+### plugins
+
+```ts
+readonly plugins?: ReadonlyArray<Plugin$1> | undefined;
+```
+
+Custom tsdown/rolldown plugins forwarded to every tsdown run (JS, dts, per-module declarations, looseFiles).
+
+### transform
+
+```ts
+readonly transform?: ((args: {
+    pkg: Json;
+    targetGroup: TargetGroupRef;
+  }) => Json) | undefined;
+```

package/public/content/packages/bundler/api/interface/buildconfiginput.md

@@ -0,0 +1,153 @@
+---
+id: packages/bundler/api/interface/buildconfiginput
+title: "BuildConfigInput — bundler interface"
+summary: "interface BuildConfigInput from @savvy-web/bundler."
+tier: packages
+source: generated
+tags: [bundler, api]
+priority: 0.3
+related: []
+---
+
+# BuildConfigInput
+
+```ts
+interface BuildConfigInput
+```
+
+## Members
+
+### bundle
+
+```ts
+readonly bundle?: ReadonlyArray<string> | undefined;
+```
+
+Force-bundle (inline) these packages into the JS output, even ones declared in package.json that would otherwise be auto-externalized. The inverse of `externals`; maps to tsdown `deps.alwaysBundle`. Accepts package names. Use when you declare a dependency for metadata/types but want its code inlined. Declarations are NOT inlined by this option — use `bundledPackages` to also roll a package's types into the emitted `.d.ts`.
+
+### bundledPackages
+
+```ts
+readonly bundledPackages?: ReadonlyArray<string> | undefined;
+```
+
+External packages whose type declarations are inlined into the bundled dts (the rslib `dtsBundledPackages` equivalent). Only these node_modules packages are rolled into the emitted `.d.ts`; all other deps stay external.
+
+### bundleNodeModules
+
+```ts
+readonly bundleNodeModules?: boolean | undefined;
+```
+
+Force-bundle node_modules (and workspace) JS dependencies that are not externalized into the package output, restoring the self-contained bundle the rslib builder produced. Threads tsdown `deps.skipNodeModulesBundle: false` into BOTH the JS output and the bundled declarations: the dts posture tracks the JS posture, so node_modules types are inlined into the `.d.ts` and the published package needs no extra declared deps for them. Defaults to false.
+
+### define
+
+```ts
+readonly define?: Record<string, string> | undefined;
+```
+
+Compile-time global replacements forwarded to the tsdown/rolldown build `define`. Values are inserted VERBATIM, so string literals must be quoted: `{ "process.env.FLAG": JSON.stringify("on") }`. Merged with the auto-injected `process.env.__PACKAGE_VERSION__` define; a user key of the same name wins.
+
+### devManifest
+
+```ts
+readonly devManifest?: "preserve" | "resolve";
+```
+
+### dtsExternals
+
+```ts
+readonly dtsExternals?: ReadonlyArray<string> | undefined;
+```
+
+Packages externalized in the dts pass ONLY — referenced via `import` in the emitted `.d.ts` rather than inlined — while the JS pass still bundles them per `bundleNodeModules`. Use when a dependency's types cannot be safely inlined, for example effect's cross-module `declare module` augmentations, which inline into conflicting interface-extension errors in consumers. Declare these as package dependencies so consumers can resolve the emitted type imports.
+
+### exe
+
+```ts
+readonly exe?: ExeConfig | ReadonlyArray<ExeConfig> | undefined;
+```
+
+### externals
+
+```ts
+readonly externals?: ReadonlyArray<string>;
+```
+
+### format
+
+```ts
+readonly format?: ReadonlyArray<BuildFormat> | undefined;
+```
+
+Output module formats forwarded to the tsdown build. Defaults to esm-only; add "cjs" for a dual-format esm plus cjs build. This is the live field; the legacy "formats" field above is not consumed by the build.
+
+### formats
+
+```ts
+readonly formats?: ReadonlyArray<"esm">;
+```
+
+### jsx
+
+```ts
+readonly jsx?: JsxConfig | undefined;
+```
+
+### looseFiles
+
+```ts
+readonly looseFiles?: LooseFiles | 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.
+
+### meta
+
+```ts
+readonly meta?: MetaOptions | false;
+```
+
+API-model (meta) generation. Tri-state: omit it (or `undefined`) to generate with DEFAULT options; `--target prod` emits the meta release asset for every prod group and copies the canonical group's bundle into `localPaths`. Pass an object to override defaults (`localPaths`, `tsdoc`, `optimistic`). Pass `false` to opt OUT (the prod meta asset becomes a no-op). NOTE: `--target meta` is deprecated and now a no-op; meta is a function of `--target prod`.
+
+### minify
+
+```ts
+readonly minify?: boolean | undefined;
+```
+
+Minify the prod build output. Applies ONLY to prod target groups (dev is never minified) and defaults to false: this builder targets Node libraries, where readable output matters more than bundle size — minified/obfuscated code trips security/SCA scanners and degrades stack traces. Set true to opt back in.
+
+### output
+
+```ts
+readonly output?: OutputConfig;
+```
+
+### overrides
+
+```ts
+readonly overrides?: ReadonlyArray<BuildEntryOverride> | undefined;
+```
+
+Per-entry format/bundling overrides. Each group pins its `entries` (export paths) to its own format and bundling, layered onto the base build. Use to keep one entry CJS in an otherwise ESM-only package (e.g. silk's `./changesets/markdownlint`).
+
+### plugins
+
+```ts
+readonly plugins?: ReadonlyArray<Plugin$1> | 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.
+
+### transform
+
+```ts
+readonly transform?: (args: {
+    pkg: Json;
+    targetGroup: TargetGroupRef;
+  }) => Json;
+```
+
+Final mutation of the emitted package.json, run after the declarative `publishConfig.targets` rename. Defaults to `defaultManifestTransform`, which strips build/dev-only fields (devDependencies, scripts, publishConfig, etc.). Supplying your own REPLACES that default — import and call `defaultManifestTransform` from it if you still want the stripping.

package/public/content/packages/bundler/api/interface/buildentryoverride.md

@@ -0,0 +1,86 @@
+---
+id: packages/bundler/api/interface/buildentryoverride
+title: "BuildEntryOverride — bundler interface"
+summary: "interface BuildEntryOverride from @savvy-web/bundler."
+tier: packages
+source: generated
+tags: [bundler, api]
+priority: 0.3
+related: []
+---
+
+# BuildEntryOverride
+
+```ts
+interface BuildEntryOverride
+```
+
+## Members
+
+### bundle
+
+```ts
+readonly bundle?: ReadonlyArray<string> | undefined;
+```
+
+### bundledPackages
+
+```ts
+readonly bundledPackages?: ReadonlyArray<string> | undefined;
+```
+
+### bundleNodeModules
+
+```ts
+readonly bundleNodeModules?: boolean | undefined;
+```
+
+### css
+
+```ts
+readonly css?: CssOptions | undefined;
+```
+
+CSS handling forwarded to tsdown's `css` option (JS pass only). Enables `@tsdown/css`.
+
+### dtsExternals
+
+```ts
+readonly dtsExternals?: ReadonlyArray<string> | undefined;
+```
+
+### entries
+
+```ts
+readonly entries: ReadonlyArray<string>;
+```
+
+Export paths to pin to this partition, e.g. "./changesets/markdownlint" (or "." for root).
+
+### externals
+
+```ts
+readonly externals?: ReadonlyArray<string> | undefined;
+```
+
+### format
+
+```ts
+readonly format?: ReadonlyArray<BuildFormat> | undefined;
+```
+
+### outSubdir
+
+```ts
+readonly outSubdir?: string | undefined;
+```
+
+Build this entry's partition into a `<group>/pkg/<outSubdir>/` subdir as an isolated sub-package (e.g. an RSPress `./runtime`). The export's built path becomes `./<outSubdir>/index.{js,d.ts}`. Exactly ONE export path may be pinned per `outSubdir` override.
+
+### platform
+
+```ts
+readonly platform?: BuildPlatform | undefined;
+```
+
+JS-pass platform for this partition (default "node"). Use "browser" for an RSPress runtime.

package/public/content/packages/bundler/api/interface/outputconfig.md

@@ -0,0 +1,34 @@
+---
+id: packages/bundler/api/interface/outputconfig
+title: "OutputConfig — bundler interface"
+summary: "interface OutputConfig from @savvy-web/bundler."
+tier: packages
+source: generated
+tags: [bundler, api]
+priority: 0.3
+related: []
+---
+
+# OutputConfig
+
+```ts
+interface OutputConfig
+```
+
+## Members
+
+### console
+
+```ts
+readonly console?: {
+    readonly human?: boolean;
+    readonly agent?: boolean;
+    readonly ci?: boolean;
+  };
+```
+
+### format
+
+```ts
+readonly format?: "terminal" | "json" | "markdown" | "ci-annotations" | "silent";
+```

package/public/content/packages/bundler/api/interface/parsedargs.md

@@ -0,0 +1,44 @@
+---
+id: packages/bundler/api/interface/parsedargs
+title: "ParsedArgs — bundler interface"
+summary: "interface ParsedArgs from @savvy-web/bundler."
+tier: packages
+source: generated
+tags: [bundler, api]
+priority: 0.3
+related: []
+---
+
+# ParsedArgs
+
+```ts
+interface ParsedArgs
+```
+
+## Members
+
+### noExe
+
+```ts
+readonly noExe: boolean;
+```
+
+Skip the SEA compile step of a dev/prod build (the manifest is still programmed). Used by `prepare`.
+
+### target
+
+```ts
+readonly target: "dev" | "prod" | "meta" | "exe";
+```
+
+### verbose
+
+```ts
+readonly verbose: boolean;
+```
+
+### watch
+
+```ts
+readonly watch: boolean;
+```

package/public/content/packages/bundler/api/interface/runoptions.md

@@ -0,0 +1,150 @@
+---
+id: packages/bundler/api/interface/runoptions
+title: "RunOptions — bundler interface"
+summary: "interface RunOptions from @savvy-web/bundler."
+tier: packages
+source: generated
+tags: [bundler, api]
+priority: 0.3
+related: []
+---
+
+# RunOptions
+
+```ts
+interface RunOptions
+```
+
+## Members
+
+### argv
+
+```ts
+readonly argv: ReadonlyArray<string>;
+```
+
+### buildTargetGroups
+
+```ts
+readonly buildTargetGroups?: (o: BuildTargetGroupsOptions) => Promise<void>;
+```
+
+Injectable for tests.
+
+### cwd
+
+```ts
+readonly cwd: string;
+```
+
+### generateMeta
+
+```ts
+readonly generateMeta?: (o: GenerateMetaOptions) => Promise<MetaResult>;
+```
+
+Injectable for tests.
+
+### readExports
+
+```ts
+readonly readExports?: () => Record<string, string> | undefined;
+```
+
+Injectable for tests: returns the package.json `exports` map.
+
+### readOsCpu
+
+```ts
+readonly readOsCpu?: (() => {
+    os: ReadonlyArray<string>;
+    cpu: ReadonlyArray<string>;
+  }) | undefined;
+```
+
+Injectable for tests: returns the package os/cpu arrays.
+
+### readPackageName
+
+```ts
+readonly readPackageName?: () => string;
+```
+
+Injectable for tests: returns the package name.
+
+### readPublishTargets
+
+```ts
+readonly readPublishTargets?: (() => PublishTargets | undefined) | undefined;
+```
+
+Injectable for tests: returns package.json publishConfig.targets, or undefined.
+
+### readTsconfigJsx
+
+```ts
+readonly readTsconfigJsx?: (() => TsconfigJsx) | undefined;
+```
+
+Injectable for tests: reads the jsx-relevant tsconfig compilerOptions slice.
+
+### readVersion
+
+```ts
+readonly readVersion?: () => string;
+```
+
+Injectable for tests: returns the package version string.
+
+### resolveNextVersions
+
+```ts
+readonly resolveNextVersions?: ((cwd: string) => Promise<NextVersions>) | undefined;
+```
+
+Injectable for tests: resolves next release versions for the optimistic meta rewrite.
+
+### runExeBuild
+
+```ts
+readonly runExeBuild?: ((o: RunExeBuildOptions) => Promise<void>) | undefined;
+```
+
+Injectable for tests.
+
+### writeIssues
+
+```ts
+readonly writeIssues?: (opts: {
+    cwd: string;
+    target: "dev" | "prod";
+    reports: ReadonlyArray<BuildReport>;
+    now?: () => Date;
+  }) => string | undefined;
+```
+
+Injectable issues-artifact writer (defaults to writeIssuesArtifact).
+
+### writeOutput
+
+```ts
+readonly writeOutput?: (output: RenderedOutput) => void;
+```
+
+Injectable for tests: consumes rendered output (defaults to process.stdout.write).
+
+### writeTargetsBinding
+
+```ts
+readonly writeTargetsBinding?: ((cwd: string, resolution: TargetResolution) => string) | undefined;
+```
+
+Injectable for tests: writes the target binding artifact.
+
+### writeTsconfig
+
+```ts
+readonly writeTsconfig?: (cwd: string) => string;
+```
+
+Injectable for tests: writes the resolved tsconfig and returns its path (defaults to writeResolvedTsconfig, which writes to the OS temp dir).

package/public/content/packages/bundler/api.md

@@ -0,0 +1,27 @@
+---
+id: packages/bundler/api
+title: "@savvy-web/bundler — API reference"
+summary: "@savvy-web/bundler API reference: 9 documented symbols."
+tier: packages
+source: generated
+tags: [bundler, api]
+priority: 0.4
+related: []
+---
+
+# @savvy-web/bundler — API reference
+
+## function
+
+- [`defineBuild`](silk://packages/bundler/api/function/definebuild) — Normalize + validate a defineBuild config. Pure when imported; self-runs when entry (see run.ts).
+- [`parseArgs`](silk://packages/bundler/api/function/parseargs) — Parse the build CLI argv into the normalized target/flags shape.
+- [`runBuild`](silk://packages/bundler/api/function/runbuild) — Run a build from a normalized config. Pure orchestration; all IO injectable.
+
+## interface
+
+- [`BuildConfig`](silk://packages/bundler/api/interface/buildconfig)
+- [`BuildConfigInput`](silk://packages/bundler/api/interface/buildconfiginput)
+- [`BuildEntryOverride`](silk://packages/bundler/api/interface/buildentryoverride)
+- [`OutputConfig`](silk://packages/bundler/api/interface/outputconfig)
+- [`ParsedArgs`](silk://packages/bundler/api/interface/parsedargs)
+- [`RunOptions`](silk://packages/bundler/api/interface/runoptions)