@savvy-web/mcp 1.3.5 → 1.5.0

package/content/packages/bundler/api/function/build.md

@@ -1,18 +0,0 @@
----
-id: packages/bundler/api/function/build
-title: "build — bundler function"
-summary: "Sugar front door: define + run in one call, deriving `cwd`/`argv` from process globals. `cwd` is the directory of the entry script (`process.argv[1]`) — the fa…"
-tier: packages
-source: generated
-tags: [bundler, api]
-priority: 0.3
-related: []
----
-
-# build
-
-Sugar front door: define + run in one call, deriving `cwd`/`argv` from process globals. `cwd` is the directory of the entry script (`process.argv[1]`) — the faithful equivalent of the old `import.meta.dirname`, correct even when invoked by an explicit path from another directory. `argv` is `process.argv.slice(2)`, so `--target` and friends are read internally; the package.json [build](silk://packages/bundler/api/function/build) scripts stay `node savvy.build.ts --target <t>`. `overrides` merges last as the test/advanced IO seam (the same injectables as [RunOptions](silk://packages/bundler/api/interface/runoptions)).
-
-```ts
-function build(input?: BuildConfigInput, overrides?: Partial<RunOptions>): Promise<void>;
-```

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

@@ -1,18 +0,0 @@
----
-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/content/packages/bundler/api/function/parseargs.md

@@ -1,18 +0,0 @@
----
-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](silk://packages/bundler/api/function/build) CLI argv into the normalized target/flags shape.
-
-```ts
-function parseArgs(argv: ReadonlyArray<string>): ParsedArgs;
-```

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

@@ -1,18 +0,0 @@
----
-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](silk://packages/bundler/api/function/build) from a normalized config. Pure orchestration; all IO injectable.
-
-```ts
-function runBuild(config: BuildConfig, options: RunOptions): Promise<void>;
-```

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

@@ -1,147 +0,0 @@
----
-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](silk://packages/bundler/api/function/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](silk://packages/bundler/api/function/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/content/packages/bundler/api/interface/buildconfiginput.md

@@ -1,153 +0,0 @@
----
-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](silk://packages/bundler/api/function/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](silk://packages/bundler/api/function/build). Defaults to esm-only; add "cjs" for a dual-format esm plus cjs [build](silk://packages/bundler/api/function/build). This is the live field; the legacy "formats" field above is not consumed by the [build](silk://packages/bundler/api/function/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](silk://packages/bundler/api/function/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](silk://packages/bundler/api/function/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](silk://packages/bundler/api/function/build) performs — the JS pass, the dts pass, the per-module declarations pass, and each looseFiles pass. Use for [build](silk://packages/bundler/api/function/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](silk://packages/bundler/api/function/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/content/packages/bundler/api/interface/buildentryoverride.md

@@ -1,86 +0,0 @@
----
-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/content/packages/bundler/api/interface/outputconfig.md

@@ -1,34 +0,0 @@
----
-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/content/packages/bundler/api/interface/parsedargs.md

@@ -1,44 +0,0 @@
----
-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](silk://packages/bundler/api/function/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/content/packages/bundler/api/interface/runoptions.md

@@ -1,158 +0,0 @@
----
-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.
-
-### copyAmbientDts
-
-```ts
-readonly copyAmbientDts?: ((o: CopyAmbientDtsOptions) => void) | undefined;
-```
-
-Injectable ambient-.d.ts copier (defaults to copyAmbientDts).
-
-### 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).