@savvy-web/mcp 1.3.4 → 1.3.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Savvy Web Strategy, LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/{public/content → content}/manifest.json

@@ -52,6 +52,19 @@
 			"related": ["packages/mcp/resource-taxonomy"],
 			"uri": "silk://guides/llm-friendly-json-schemas"
 		},
+		{
+			"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",
+			"status": "stable",
+			"tags": ["bundler", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/bundler/api/function/build"
+		},
 		{
 			"id": "packages/bundler/api/function/definebuild",
 			"title": "defineBuild — bundler function",
@@ -172,7 +185,7 @@
 		{
 			"id": "packages/bundler/api",
 			"title": "@savvy-web/bundler — API reference",
-			"summary": "@savvy-web/bundler API reference: 9 documented symbols.",
+			"summary": "@savvy-web/bundler API reference: 10 documented symbols.",
 			"tier": "packages",
 			"source": "generated",
 			"status": "stable",
@@ -6162,6 +6175,19 @@
 			"related": ["packages/silk-effects/"],
 			"uri": "silk://packages/mcp/resource-taxonomy"
 		},
+		{
+			"id": "packages/rspress-builder/api/function/build",
+			"title": "build — rspress-builder function",
+			"summary": "Front door for building an RSPress plugin. Applies the definePlugin preset and runs the build, deriving `cwd` and `argv` from `process.argv`. For advanced use,…",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["rspress-builder", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/rspress-builder/api/function/build"
+		},
 		{
 			"id": "packages/rspress-builder/api/function/defineplugin",
 			"title": "definePlugin — rspress-builder function",
@@ -6204,7 +6230,7 @@
 		{
 			"id": "packages/rspress-builder/api",
 			"title": "@savvy-web/rspress-builder — API reference",
-			"summary": "@savvy-web/rspress-builder API reference: 3 documented symbols.",
+			"summary": "@savvy-web/rspress-builder API reference: 4 documented symbols.",
 			"tier": "packages",
 			"source": "generated",
 			"status": "stable",
@@ -8467,6 +8493,32 @@
 			"related": [],
 			"uri": "silk://packages/tsdown-plugins/api/class/tsconfigresolver"
 		},
+		{
+			"id": "packages/tsdown-plugins/api/function/ambientoutname",
+			"title": "ambientOutName — tsdown-plugins function",
+			"summary": "Output basename (including the preserved declaration extension) for an ambient export, derived from the export KEY — consistent with how JS entries are named.",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/function/ambientoutname"
+		},
+		{
+			"id": "packages/tsdown-plugins/api/function/analyzereexportbarrel",
+			"title": "analyzeReexportBarrel — tsdown-plugins function",
+			"summary": "Analyze an entry source as a candidate pure re-export barrel: classify its re-exported names into value vs type-only and report whether it is expressible as a…",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/function/analyzereexportbarrel"
+		},
 		{
 			"id": "packages/tsdown-plugins/api/function/applysubdirmetaentries",
 			"title": "applySubdirMetaEntries — tsdown-plugins function",
@@ -8480,6 +8532,19 @@
 			"related": [],
 			"uri": "silk://packages/tsdown-plugins/api/function/applysubdirmetaentries"
 		},
+		{
+			"id": "packages/tsdown-plugins/api/function/assertnoentrycollisions",
+			"title": "assertNoEntryCollisions — tsdown-plugins function",
+			"summary": "Throw ConfigValidationError if any ambient output name collides with a JS build-entry name. The JS entry names carry no extension, so each ambient `outName` is…",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/function/assertnoentrycollisions"
+		},
 		{
 			"id": "packages/tsdown-plugins/api/function/buildemittedmanifest",
 			"title": "buildEmittedManifest — tsdown-plugins function",
@@ -8545,6 +8610,32 @@
 			"related": [],
 			"uri": "silk://packages/tsdown-plugins/api/function/cjsdefaultinterop"
 		},
+		{
+			"id": "packages/tsdown-plugins/api/function/classifydtsexport",
+			"title": "classifyDtsExport — tsdown-plugins function",
+			"summary": "Classify an export value: - `ambient` — a types-only declaration source (bare `.d.ts` string, or `{ types: \"*.d.ts\" }` with no runtime source). - `mixed` — a d…",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/function/classifydtsexport"
+		},
+		{
+			"id": "packages/tsdown-plugins/api/function/collectexportnames",
+			"title": "collectExportNames — tsdown-plugins function",
+			"summary": "Collect every name a module exports (named re-exports, namespace re-exports, and local `export` declarations). Used to test whether a barrel's re-exports are a…",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/function/collectexportnames"
+		},
 		{
 			"id": "packages/tsdown-plugins/api/function/computeexefilename",
 			"title": "computeExeFileName — tsdown-plugins function",
@@ -8558,6 +8649,32 @@
 			"related": [],
 			"uri": "silk://packages/tsdown-plugins/api/function/computeexefilename"
 		},
+		{
+			"id": "packages/tsdown-plugins/api/function/copyambientdts",
+			"title": "copyAmbientDts — tsdown-plugins function",
+			"summary": "Copy each ambient `.d.ts` export's source verbatim into `outDir/<outName>`, byte-stable (an unchanged file keeps its timestamp). The copy is NOT compiled or bu…",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/function/copyambientdts"
+		},
+		{
+			"id": "packages/tsdown-plugins/api/function/copypublicdir",
+			"title": "copyPublicDir — tsdown-plugins function",
+			"summary": "Copy the CONTENTS of `sourceDir` into `outDir`, additively. Each `sourceDir/<rel>` copies to `outDir/<rel>` — only the `public/` directory itself is dropped; t…",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/function/copypublicdir"
+		},
 		{
 			"id": "packages/tsdown-plugins/api/function/createtimer",
 			"title": "createTimer — tsdown-plugins function",
@@ -8584,6 +8701,19 @@
 			"related": [],
 			"uri": "silk://packages/tsdown-plugins/api/function/createtsdownlogger"
 		},
+		{
+			"id": "packages/tsdown-plugins/api/function/declarationext",
+			"title": "declarationExt — tsdown-plugins function",
+			"summary": "The declaration-file extension of a path, or undefined when it is not a declaration file.",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/function/declarationext"
+		},
 		{
 			"id": "packages/tsdown-plugins/api/function/defaultmanifesttransform",
 			"title": "defaultManifestTransform — tsdown-plugins function",
@@ -8636,6 +8766,19 @@
 			"related": [],
 			"uri": "silk://packages/tsdown-plugins/api/function/emitmanifest"
 		},
+		{
+			"id": "packages/tsdown-plugins/api/function/extractambientdts",
+			"title": "extractAmbientDts — tsdown-plugins function",
+			"summary": "Extract the types-only `.d.ts` exports from a package's `exports` map. Pure. Throws ConfigValidationError on a mixed export (Decision 2) or an ambient-vs-ambie…",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/function/extractambientdts"
+		},
 		{
 			"id": "packages/tsdown-plugins/api/function/extractentries",
 			"title": "extractEntries — tsdown-plugins function",
@@ -8649,6 +8792,19 @@
 			"related": [],
 			"uri": "silk://packages/tsdown-plugins/api/function/extractentries"
 		},
+		{
+			"id": "packages/tsdown-plugins/api/function/findrelativespecifiers",
+			"title": "findRelativeSpecifiers — tsdown-plugins function",
+			"summary": "function findRelativeSpecifiers from @savvy-web/tsdown-plugins.",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/function/findrelativespecifiers"
+		},
 		{
 			"id": "packages/tsdown-plugins/api/function/flattenissues",
 			"title": "flattenIssues — tsdown-plugins function",
@@ -8701,6 +8857,19 @@
 			"related": [],
 			"uri": "silk://packages/tsdown-plugins/api/function/istargetobject"
 		},
+		{
+			"id": "packages/tsdown-plugins/api/function/mixeddtsexporterror",
+			"title": "mixedDtsExportError — tsdown-plugins function",
+			"summary": "The shared mixed-export error (Decision 2), used by both the extractor and the manifest transform.",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/function/mixeddtsexporterror"
+		},
 		{
 			"id": "packages/tsdown-plugins/api/function/nodebuiltindefaultinterop",
 			"title": "nodeBuiltinDefaultInterop — tsdown-plugins function",
@@ -8805,6 +8974,19 @@
 			"related": [],
 			"uri": "silk://packages/tsdown-plugins/api/function/removedeclarationmaps"
 		},
+		{
+			"id": "packages/tsdown-plugins/api/function/renderreexportstub",
+			"title": "renderReexportStub — tsdown-plugins function",
+			"summary": "Render a thin re-export-stub `.d.ts`/`.d.cts` body: named re-exports of `valueNames` and `typeNames` from `baseSpecifier` (the published file of the base entry…",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/function/renderreexportstub"
+		},
 		{
 			"id": "packages/tsdown-plugins/api/function/renderreport",
 			"title": "renderReport — tsdown-plugins function",
@@ -8935,19 +9117,6 @@
 			"related": [],
 			"uri": "silk://packages/tsdown-plugins/api/function/serializeissues"
 		},
-		{
-			"id": "packages/tsdown-plugins/api/function/syncpublicdir",
-			"title": "syncPublicDir — tsdown-plugins function",
-			"summary": "Mirror `sourceDir` into `targetDir`, idempotently. Replaces tsdown's built-in `copy`, whose non-recursive mkdir throws `EEXIST` when the target already exists…",
-			"tier": "packages",
-			"source": "generated",
-			"status": "stable",
-			"tags": ["tsdown-plugins", "api"],
-			"audience": ["assistant"],
-			"priority": 0.3,
-			"related": [],
-			"uri": "silk://packages/tsdown-plugins/api/function/syncpublicdir"
-		},
 		{
 			"id": "packages/tsdown-plugins/api/function/transformbin",
 			"title": "transformBin — tsdown-plugins function",
@@ -8987,6 +9156,19 @@
 			"related": [],
 			"uri": "silk://packages/tsdown-plugins/api/function/transformmanifest"
 		},
+		{
+			"id": "packages/tsdown-plugins/api/function/writedtsemittsconfig",
+			"title": "writeDtsEmitTsconfig — tsdown-plugins function",
+			"summary": "Derive a dts-EMIT variant of an already-written resolved tsconfig that adds `stableTypeOrdering: true`, and return its path. This makes the TypeScript declarat…",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/function/writedtsemittsconfig"
+		},
 		{
 			"id": "packages/tsdown-plugins/api/function/writeissuesartifact",
 			"title": "writeIssuesArtifact — tsdown-plugins function",
@@ -9026,6 +9208,19 @@
 			"related": [],
 			"uri": "silk://packages/tsdown-plugins/api/function/writetargetsbinding"
 		},
+		{
+			"id": "packages/tsdown-plugins/api/interface/ambientdtsentry",
+			"title": "AmbientDtsEntry — tsdown-plugins interface",
+			"summary": "One ambient `.d.ts` export resolved for copy + manifest.",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/interface/ambientdtsentry"
+		},
 		{
 			"id": "packages/tsdown-plugins/api/interface/buildemittedmanifestoptions",
 			"title": "BuildEmittedManifestOptions — tsdown-plugins interface",
@@ -9078,6 +9273,19 @@
 			"related": [],
 			"uri": "silk://packages/tsdown-plugins/api/interface/buildtargetgroupsoptions"
 		},
+		{
+			"id": "packages/tsdown-plugins/api/interface/copyambientdtsoptions",
+			"title": "CopyAmbientDtsOptions — tsdown-plugins interface",
+			"summary": "interface CopyAmbientDtsOptions from @savvy-web/tsdown-plugins.",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/interface/copyambientdtsoptions"
+		},
 		{
 			"id": "packages/tsdown-plugins/api/interface/cssoptions",
 			"title": "CssOptions — tsdown-plugins interface",
@@ -9221,6 +9429,19 @@
 			"related": [],
 			"uri": "silk://packages/tsdown-plugins/api/interface/exetargetinput"
 		},
+		{
+			"id": "packages/tsdown-plugins/api/interface/extractambientoptions",
+			"title": "ExtractAmbientOptions — tsdown-plugins interface",
+			"summary": "interface ExtractAmbientOptions from @savvy-web/tsdown-plugins.",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/interface/extractambientoptions"
+		},
 		{
 			"id": "packages/tsdown-plugins/api/interface/extractoptions",
 			"title": "ExtractOptions — tsdown-plugins interface",
@@ -9289,7 +9510,7 @@
 		{
 			"id": "packages/tsdown-plugins/api/interface/jsxconfig",
 			"title": "JsxConfig — tsdown-plugins interface",
-			"summary": "Resolved JSX transform settings, mirroring the subset of rolldown's JsxOptions the bundler forwards.",
+			"summary": "Resolved JSX transform settings. The shape mirrors the subset of rolldown's JsxOptions, but the bundler consumes it to populate the generated dts tsconfig's `j…",
 			"tier": "packages",
 			"source": "generated",
 			"status": "stable",
@@ -9338,6 +9559,19 @@
 			"related": [],
 			"uri": "silk://packages/tsdown-plugins/api/interface/metaresult"
 		},
+		{
+			"id": "packages/tsdown-plugins/api/interface/moduleexportnames",
+			"title": "ModuleExportNames — tsdown-plugins interface",
+			"summary": "The set of names a module exports, plus whether that set is fully known.",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/interface/moduleexportnames"
+		},
 		{
 			"id": "packages/tsdown-plugins/api/interface/nextversions",
 			"title": "NextVersions — tsdown-plugins interface",
@@ -9468,6 +9702,19 @@
 			"related": [],
 			"uri": "silk://packages/tsdown-plugins/api/interface/publishtargetobject"
 		},
+		{
+			"id": "packages/tsdown-plugins/api/interface/reexportbarrelanalysis",
+			"title": "ReexportBarrelAnalysis — tsdown-plugins interface",
+			"summary": "The analysis of an entry source treated as a candidate re-export barrel.",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/interface/reexportbarrelanalysis"
+		},
 		{
 			"id": "packages/tsdown-plugins/api/interface/renderedoutput",
 			"title": "RenderedOutput — tsdown-plugins interface",
@@ -9741,6 +9988,19 @@
 			"related": [],
 			"uri": "silk://packages/tsdown-plugins/api/type/buildplatform"
 		},
+		{
+			"id": "packages/tsdown-plugins/api/type/dtsexportclass",
+			"title": "DtsExportClass — tsdown-plugins type",
+			"summary": "Classification of a single export value for ambient-.d.ts handling.",
+			"tier": "packages",
+			"source": "generated",
+			"status": "stable",
+			"tags": ["tsdown-plugins", "api"],
+			"audience": ["assistant"],
+			"priority": 0.3,
+			"related": [],
+			"uri": "silk://packages/tsdown-plugins/api/type/dtsexportclass"
+		},
 		{
 			"id": "packages/tsdown-plugins/api/type/dualexports",
 			"title": "DualExports — tsdown-plugins type",
@@ -10056,7 +10316,7 @@
 		{
 			"id": "packages/tsdown-plugins/api",
 			"title": "@savvy-web/tsdown-plugins — API reference",
-			"summary": "@savvy-web/tsdown-plugins API reference: 138 documented symbols.",
+			"summary": "@savvy-web/tsdown-plugins API reference: 156 documented symbols.",
 			"tier": "packages",
 			"source": "generated",
 			"status": "stable",

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

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

@@ -11,7 +11,7 @@ related: []
 
 # parseArgs
 
-Parse the build CLI argv into the normalized target/flags shape.
+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/{public/content → content}/packages/bundler/api/function/runbuild.md

@@ -11,7 +11,7 @@ related: []
 
 # runBuild
 
-Run a build from a normalized config. Pure orchestration; all IO injectable.
+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/{public/content → content}/packages/bundler/api/interface/buildconfig.md

@@ -47,7 +47,7 @@ Force-bundle node_modules (and workspace) JS dependencies that are not externali
 readonly define?: Record<string, string> | undefined;
 ```
 
-Compile-time global replacements forwarded to the build `define` (merged with the auto-version).
+Compile-time global replacements forwarded to the [build](silk://packages/bundler/api/function/build) `define` (merged with the auto-version).
 
 ### devManifest
 
@@ -81,7 +81,7 @@ readonly externals: ReadonlyArray<string>;
 readonly format?: ReadonlyArray<BuildFormat> | undefined;
 ```
 
-Output module formats forwarded to the tsdown build (esm-only by default; add "cjs" for dual-format).
+Output module formats forwarded to the tsdown [build](silk://packages/bundler/api/function/build) (esm-only by default; add "cjs" for dual-format).
 
 ### formats
 

package/{public/content → content}/packages/bundler/api/interface/buildconfiginput.md

@@ -47,7 +47,7 @@ Force-bundle node_modules (and workspace) JS dependencies that are not externali
 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.
+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
 
@@ -81,7 +81,7 @@ readonly externals?: ReadonlyArray<string>;
 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.
+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
 
@@ -117,7 +117,7 @@ API-model (meta) generation. Tri-state: omit it (or `undefined`) to generate wit
 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.
+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
 
@@ -131,7 +131,7 @@ readonly output?: OutputConfig;
 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`).
+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
 
@@ -139,7 +139,7 @@ Per-entry format/bundling overrides. Each group pins its `entries` (export paths
 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.
+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
 
@@ -150,4 +150,4 @@ readonly transform?: (args: {
   }) => 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.
+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/{public/content → content}/packages/bundler/api/interface/parsedargs.md

@@ -23,7 +23,7 @@ interface ParsedArgs
 readonly noExe: boolean;
 ```
 
-Skip the SEA compile step of a dev/prod build (the manifest is still programmed). Used by `prepare`.
+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
 

package/{public/content → content}/packages/bundler/api/interface/runoptions.md

@@ -31,6 +31,14 @@ 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

package/{public/content → content}/packages/bundler/api.md

@@ -1,7 +1,7 @@
 ---
 id: packages/bundler/api
 title: "@savvy-web/bundler — API reference"
-summary: "@savvy-web/bundler API reference: 9 documented symbols."
+summary: "@savvy-web/bundler API reference: 10 documented symbols."
 tier: packages
 source: generated
 tags: [bundler, api]
@@ -13,6 +13,7 @@ related: []
 
 ## function
 
+- [`build`](silk://packages/bundler/api/function/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 scripts stay `node savvy.build.ts --target <t>`. `overrides` merges last as the test/advanced IO seam (the same injectables as RunOptions).
 - [`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.

package/{public/content → content}/packages/github-action-builder/api/variable/applayer.md

@@ -14,7 +14,7 @@ related: []
 Combined layer providing all services.
 
 ```ts
-AppLayer: Layer.Layer<ConfigService | ValidationService | BuildService | PersistLocalService, never, never>
+AppLayer: Layer.Layer<BuildService | ConfigService | PersistLocalService | ValidationService, never, never>
 ```
 
 ## Examples

package/{public/content → content}/packages/github-action-effects/api/function/attesttestfulllayer.md

@@ -14,6 +14,6 @@ related: []
 Composed layer that provides `Attest` plus every dependency it declares (`SigstoreSigner`, `OidcTokenIssuer`, `Sbom`, and `GitHubClient`). Use this when you just want to call into `Attest` from a test without wiring four layers by hand.
 
 ```ts
-AttestTestFullLayer: (state?: AttestTestState) => Layer.Layer<Attest | SigstoreSigner |
-  OidcTokenIssuer | GitHubClient | Sbom, never, never>
+AttestTestFullLayer: (state?: AttestTestState) => Layer.Layer<Attest | GitHubClient |
+  OidcTokenIssuer | Sbom | SigstoreSigner, never, never>
 ```