@savvy-web/mcp 1.3.3 → 1.3.5

package/content/packages/tsdown-plugins/api/interface/emitmanifestoptions.md

@@ -0,0 +1,71 @@
+---
+id: packages/tsdown-plugins/api/interface/emitmanifestoptions
+title: "EmitManifestOptions — tsdown-plugins interface"
+summary: "interface EmitManifestOptions from @savvy-web/tsdown-plugins."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# EmitManifestOptions
+
+```ts
+interface EmitManifestOptions
+```
+
+## Members
+
+### devManifest
+
+```ts
+readonly devManifest?: "preserve" | "resolve" | undefined;
+```
+
+### dual
+
+```ts
+readonly dual?: DualExports | undefined;
+```
+
+Which exports emit dual import/require conditions. boolean (uniform) or a Set of export keys (per-entry).
+
+### exeRewrite
+
+```ts
+readonly exeRewrite?: ExeRewrite | undefined;
+```
+
+When set, rewrite exports/bin values equal to the exe source to the SEA path and add it to `files`.
+
+### sourceDir
+
+```ts
+readonly sourceDir: string;
+```
+
+Source package dir to read package.json/LICENSE/README from.
+
+### subdirExports
+
+```ts
+readonly subdirExports?: ReadonlySet<string> | undefined;
+```
+
+Export keys built into a `<key>/index.*` subdir (e.g. an RSPress `./runtime`).
+
+### targetGroup
+
+```ts
+readonly targetGroup: TargetGroupRef;
+```
+
+### transform
+
+```ts
+readonly transform?: ((args: {
+    pkg: Json;
+    targetGroup: TargetGroupRef;
+  }) => Json) | undefined;
+```

package/content/packages/tsdown-plugins/api/interface/entryoverride.md

@@ -0,0 +1,86 @@
+---
+id: packages/tsdown-plugins/api/interface/entryoverride
+title: "EntryOverride — tsdown-plugins interface"
+summary: "One entry partition built with its own format + bundling posture, layered into the SAME outDir as the base build (clean:false). Anything omitted falls back to…"
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# EntryOverride
+
+One entry partition built with its own format + bundling posture, layered into the SAME outDir as the base build (clean:false). Anything omitted falls back to the base build's value. `entry` is a subset of the package's entries (`entryName -> source path`).
+
+```ts
+interface EntryOverride
+```
+
+## 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;
+```
+
+### entry
+
+```ts
+readonly entry: Record<string, string>;
+```
+
+### externals
+
+```ts
+readonly externals?: ReadonlyArray<string> | undefined;
+```
+
+### format
+
+```ts
+readonly format?: ReadonlyArray<BuildFormat> | undefined;
+```
+
+### outSubdir
+
+```ts
+readonly outSubdir?: string | undefined;
+```
+
+Build this partition into `<groupOutDir>/<outSubdir>/` instead of the shared group root. Isolates a sub-package (e.g. an RSPress `./runtime`) so its bundleless per-file output cannot collide with the base partition's output and its barrel path is deterministic. The partition's entry should be `{ index: <barrel source> }` so it emits `<outSubdir>/index.js` + `<outSubdir>/index.d.ts`.
+
+### platform
+
+```ts
+readonly platform?: BuildPlatform | undefined;
+```
+
+JS-pass platform for this partition. Defaults to the base "node". Use "browser" for a web runtime.

package/content/packages/tsdown-plugins/api/interface/execonfig.md

@@ -0,0 +1,60 @@
+---
+id: packages/tsdown-plugins/api/interface/execonfig
+title: "ExeConfig — tsdown-plugins interface"
+summary: "One SEA binary to compile."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# ExeConfig
+
+One SEA binary to compile.
+
+```ts
+interface ExeConfig
+```
+
+## Members
+
+### entry
+
+```ts
+readonly entry?: string | undefined;
+```
+
+Bin entry; defaults to ./src/bin.ts.
+
+### fileName
+
+```ts
+readonly fileName: string;
+```
+
+Output binary basename (no extension/suffix).
+
+### nodeVersion
+
+```ts
+readonly nodeVersion?: string | undefined;
+```
+
+Node runtime to embed; defaults to [DEFAULT_EXE_NODE_VERSION](silk://packages/tsdown-plugins/api/variable/default_exe_node_version).
+
+### seaConfig
+
+```ts
+readonly seaConfig?: ExeSeaConfig | undefined;
+```
+
+seaConfig overrides merged over the defaults.
+
+### targets
+
+```ts
+readonly targets?: ReadonlyArray<ExeTargetInput> | undefined;
+```
+
+Explicit targets; default inferred from the package os/cpu.

package/content/packages/tsdown-plugins/api/interface/exerewrite.md

@@ -0,0 +1,44 @@
+---
+id: packages/tsdown-plugins/api/interface/exerewrite
+title: "ExeRewrite — tsdown-plugins interface"
+summary: "Describes a SEA binary the bundler compiled for this package. When present, transformManifest rewrites every `exports`/`bin` value equal to `source` to the emi…"
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# ExeRewrite
+
+Describes a SEA binary the bundler compiled for this package. When present, [transformManifest](silk://packages/tsdown-plugins/api/function/transformmanifest) rewrites every `exports`/`bin` value equal to `source` to the emitted binary path and adds it to `files` so it ships in the tarball.
+
+```ts
+interface ExeRewrite
+```
+
+## Members
+
+### dir
+
+```ts
+readonly dir: string;
+```
+
+Relative dir the binary is emitted into (e.g. "bin").
+
+### fileName
+
+```ts
+readonly fileName: string;
+```
+
+The emitted SEA filename (already suffixed, incl. .exe on win).
+
+### source
+
+```ts
+readonly source: string;
+```
+
+The exe entry source path (matches exports/bin values to rewrite).

package/content/packages/tsdown-plugins/api/interface/exeseaconfig.md

@@ -0,0 +1,38 @@
+---
+id: packages/tsdown-plugins/api/interface/exeseaconfig
+title: "ExeSeaConfig — tsdown-plugins interface"
+summary: "SEA seaConfig overrides (subset; the rest are defaulted)."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# ExeSeaConfig
+
+SEA seaConfig overrides (subset; the rest are defaulted).
+
+```ts
+interface ExeSeaConfig
+```
+
+## Members
+
+### disableExperimentalSEAWarning
+
+```ts
+readonly disableExperimentalSEAWarning?: boolean | undefined;
+```
+
+### useCodeCache
+
+```ts
+readonly useCodeCache?: boolean | undefined;
+```
+
+### useSnapshot
+
+```ts
+readonly useSnapshot?: boolean | undefined;
+```

package/content/packages/tsdown-plugins/api/interface/exetarget.md

@@ -0,0 +1,38 @@
+---
+id: packages/tsdown-plugins/api/interface/exetarget
+title: "ExeTarget — tsdown-plugins interface"
+summary: "A resolved per-platform SEA target. `platform` uses the tsdown/tsdown/exe token (win, not win32)."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# ExeTarget
+
+A resolved per-platform SEA target. `platform` uses the tsdown/tsdown/exe token (win, not win32).
+
+```ts
+interface ExeTarget
+```
+
+## Members
+
+### arch
+
+```ts
+readonly arch: "arm64" | "x64";
+```
+
+### nodeVersion
+
+```ts
+readonly nodeVersion: string;
+```
+
+### platform
+
+```ts
+readonly platform: "darwin" | "linux" | "win";
+```

package/content/packages/tsdown-plugins/api/interface/exetargetinput.md

@@ -0,0 +1,32 @@
+---
+id: packages/tsdown-plugins/api/interface/exetargetinput
+title: "ExeTargetInput — tsdown-plugins interface"
+summary: "A target before nodeVersion defaulting (platform/arch only)."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# ExeTargetInput
+
+A target before nodeVersion defaulting (platform/arch only).
+
+```ts
+interface ExeTargetInput
+```
+
+## Members
+
+### arch
+
+```ts
+readonly arch: "arm64" | "x64";
+```
+
+### platform
+
+```ts
+readonly platform: "darwin" | "linux" | "win";
+```

package/content/packages/tsdown-plugins/api/interface/extractambientoptions.md

@@ -0,0 +1,24 @@
+---
+id: packages/tsdown-plugins/api/interface/extractambientoptions
+title: "ExtractAmbientOptions — tsdown-plugins interface"
+summary: "interface ExtractAmbientOptions from @savvy-web/tsdown-plugins."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# ExtractAmbientOptions
+
+```ts
+interface ExtractAmbientOptions
+```
+
+## Members
+
+### exportsAsIndexes
+
+```ts
+readonly exportsAsIndexes?: boolean | undefined;
+```

package/content/packages/tsdown-plugins/api/interface/extractoptions.md

@@ -0,0 +1,32 @@
+---
+id: packages/tsdown-plugins/api/interface/extractoptions
+title: "ExtractOptions — tsdown-plugins interface"
+summary: "interface ExtractOptions from @savvy-web/tsdown-plugins."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# ExtractOptions
+
+```ts
+interface ExtractOptions
+```
+
+## Members
+
+### excludeSources
+
+```ts
+readonly excludeSources?: ReadonlyArray<string> | undefined;
+```
+
+Source paths to NOT turn into JS build entries (e.g. an exe entry compiled as a SEA).
+
+### exportsAsIndexes
+
+```ts
+readonly exportsAsIndexes?: boolean | undefined;
+```

package/content/packages/tsdown-plugins/api/interface/extractresult.md

@@ -0,0 +1,34 @@
+---
+id: packages/tsdown-plugins/api/interface/extractresult
+title: "ExtractResult — tsdown-plugins interface"
+summary: "interface ExtractResult from @savvy-web/tsdown-plugins."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# ExtractResult
+
+```ts
+interface ExtractResult
+```
+
+## Members
+
+### entries
+
+```ts
+readonly entries: Record<string, string>;
+```
+
+entry name to TS source path
+
+### exportPaths
+
+```ts
+readonly exportPaths: Record<string, string>;
+```
+
+entry name to original export key (for downstream output-map alignment)

package/content/packages/tsdown-plugins/api/interface/formatter.md

@@ -0,0 +1,30 @@
+---
+id: packages/tsdown-plugins/api/interface/formatter
+title: "Formatter — tsdown-plugins interface"
+summary: "interface Formatter from @savvy-web/tsdown-plugins."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# Formatter
+
+```ts
+interface Formatter
+```
+
+## Members
+
+### format
+
+```ts
+readonly format: string;
+```
+
+### render
+
+```ts
+readonly render: (reports: ReadonlyArray<BuildReport>, ctx: FormatterContext) => ReadonlyArray<RenderedOutput>;
+```

package/content/packages/tsdown-plugins/api/interface/formattercontext.md

@@ -0,0 +1,30 @@
+---
+id: packages/tsdown-plugins/api/interface/formattercontext
+title: "FormatterContext — tsdown-plugins interface"
+summary: "interface FormatterContext from @savvy-web/tsdown-plugins."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# FormatterContext
+
+```ts
+interface FormatterContext
+```
+
+## Members
+
+### noColor
+
+```ts
+readonly noColor: boolean;
+```
+
+### verbose
+
+```ts
+readonly verbose: boolean;
+```

package/content/packages/tsdown-plugins/api/interface/generatemetaoptions.md

@@ -0,0 +1,124 @@
+---
+id: packages/tsdown-plugins/api/interface/generatemetaoptions
+title: "GenerateMetaOptions — tsdown-plugins interface"
+summary: "interface GenerateMetaOptions from @savvy-web/tsdown-plugins."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# GenerateMetaOptions
+
+```ts
+interface GenerateMetaOptions
+```
+
+## Members
+
+### aeInputDir
+
+```ts
+readonly aeInputDir?: string | undefined;
+```
+
+Per-module declarations dir used ONLY for a second, diagnostics-only API Extractor run that resolves accurate per-file source locations. The shipped api-model is still produced from `dtsDir` (the bundled dts), so it is unchanged. When omitted or equal to `dtsDir`, a single run over `dtsDir` produces both model and diagnostics (legacy behavior).
+
+### ci
+
+```ts
+readonly ci?: boolean | undefined;
+```
+
+When true (CI), forgotten exports become a hard build error.
+
+### cwd
+
+```ts
+readonly cwd: string;
+```
+
+### dtsDir
+
+```ts
+readonly dtsDir: string;
+```
+
+Directory holding the tsdown-emitted per-file .d.ts (e.g. dist/dev/pkg).
+
+### entries
+
+```ts
+readonly entries: Record<string, string>;
+```
+
+Map of entry name to the .d.ts basename (without extension) inside dtsDir.
+
+### exportPaths
+
+```ts
+readonly exportPaths: Record<string, string>;
+```
+
+Map of entry name to its export path (".", "./sub").
+
+### localPaths
+
+```ts
+readonly localPaths: ReadonlyArray<string>;
+```
+
+Directories (relative to cwd) to copy the meta bundle into.
+
+### manifestTransform
+
+```ts
+readonly manifestTransform?: ((pkg: Record<string, unknown>) => Record<string, unknown>) | undefined;
+```
+
+Optional transform applied to the bundle `package.json` (read from `dtsDir`) before it is written to `outMetaDir` and copied into `localPaths`. Used for the optimistic next-version rewrite. When omitted, the package.json is copied verbatim.
+
+### onMessage
+
+```ts
+readonly onMessage?: ((entry: DiagnosticInput) => void) | undefined;
+```
+
+When set, API Extractor warnings/errors are routed here (and suppressed from console).
+
+### onSuppressed
+
+```ts
+readonly onSuppressed?: ((entry: DiagnosticInput) => void) | undefined;
+```
+
+When set, messages matched by `suppressWarnings` are routed here for accounting.
+
+### outMetaDir
+
+```ts
+readonly outMetaDir: string;
+```
+
+Where to write the meta bundle (.api.json + package.json + tsconfig.json).
+
+### packageName
+
+```ts
+readonly packageName: string;
+```
+
+### tsconfigPath
+
+```ts
+readonly tsconfigPath: string;
+```
+
+Resolved tsconfig (from [writeResolvedTsconfig](silk://packages/tsdown-plugins/api/function/writeresolvedtsconfig)) for the api-extractor compiler.
+
+### tsdoc
+
+```ts
+readonly tsdoc: NormalizedMeta["tsdoc"];
+```

package/content/packages/tsdown-plugins/api/interface/jsxconfig.md

@@ -0,0 +1,36 @@
+---
+id: packages/tsdown-plugins/api/interface/jsxconfig
+title: "JsxConfig — tsdown-plugins interface"
+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
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# JsxConfig
+
+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 `jsx`/`jsxImportSource`, not by forwarding it into rolldown's input options.
+
+```ts
+interface JsxConfig
+```
+
+## Members
+
+### importSource
+
+```ts
+readonly importSource?: string | undefined;
+```
+
+The JSX import source for the automatic runtime (e.g. "react", "preact").
+
+### runtime
+
+```ts
+readonly runtime?: "classic" | "automatic" | undefined;
+```
+
+"automatic" auto-imports the JSX factories (react-jsx); "classic" does not (React.createElement).