@savvy-web/mcp 1.3.5 → 1.4.0

package/content/packages/tsdown-plugins/api/function/buildresolvedtsconfig.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/buildresolvedtsconfig
-title: "buildResolvedTsconfig — tsdown-plugins function"
-summary: "Build the portable absolute-path tsconfig object (ported from rslib writeBundleTempConfig)."
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# buildResolvedTsconfig
-
-Build the portable absolute-path tsconfig object (ported from rslib writeBundleTempConfig).
-
-```ts
-function buildResolvedTsconfig(options: ResolvedTsconfigOptions): ResolvedTsconfig;
-```

package/content/packages/tsdown-plugins/api/function/buildtargetgroups.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/buildtargetgroups
-title: "buildTargetGroups — tsdown-plugins function"
-summary: "Run tsdown.build() per TargetGroup. Composable so the escape hatch gets multi-group too. Each group runs TWO passes to the SAME outDir: 1. JS pass — per-module…"
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# buildTargetGroups
-
-Run tsdown.build() per TargetGroup. Composable so the escape hatch gets multi-group too. Each group runs TWO passes to the SAME outDir: 1. JS pass — per-module JS (`unbundle: true`, `dts: false`), with the `emitManifest` plugin and the `public/` copy. Default `clean: true` gives it a fresh outDir. 2. dts pass — bundled declarations only (`unbundle: false`, `dts: { emitDtsOnly: true }`, `clean: false`). No manifest plugin, no copy, no sourcemaps. `clean: false` is load-bearing: it must NOT wipe the JS the first pass just wrote. Why two passes: tsdown's `unbundle` maps to rolldown `output.preserveModules` for the whole build (JS and the dts plugin share it), so a single pass cannot give per-module JS + bundled dts. Per-module dts breaks type portability (TS2883); bundling the JS re-bundles workspace consumers. The split keeps per-module JS AND rolled-up, self-contained declarations.
-
-```ts
-function buildTargetGroups(options: BuildTargetGroupsOptions): Promise<void>;
-```

package/content/packages/tsdown-plugins/api/function/cjsdefaultinterop.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/cjsdefaultinterop
-title: "cjsDefaultInterop — tsdown-plugins function"
-summary: "Rolldown plugin: append the CJS default-interop footer to ENTRY chunks of the `cjs` format that export a default alongside named exports. Gated tightly so it n…"
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# cjsDefaultInterop
-
-Rolldown plugin: append the CJS default-interop footer to ENTRY chunks of the `cjs` format that export a default alongside named exports. Gated tightly so it never touches the wrong chunk: - format must be `cjs` (ESM is untouched; `import().default` on ESM is already correct); - the chunk must be an ENTRY chunk — never a SHARED chunk. Shared chunks are required by entry chunks via their named bindings (e.g. `require_changesets.changesets_exports.X`); reassigning a shared chunk's `module.exports` to its own default would break those reads (many bundled vendor chunks carry an `exports.default`); - the chunk must export a `default` AND at least one named export. A default-only chunk already gets `module.exports = <default>` from rolldown, and a named-only chunk has no default to promote. The emitted footer is also self-guarded (`module.exports.default !== void 0`), so it is a runtime no-op whenever the static gate is ever too generous.
-
-```ts
-function cjsDefaultInterop(): Plugin;
-```

package/content/packages/tsdown-plugins/api/function/classifydtsexport.md

@@ -1,18 +0,0 @@
----
-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
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# classifyDtsExport
-
-Classify an export value: - `ambient` — a types-only declaration source (bare `.d.ts` string, or `{ types: "*.d.ts" }` with no runtime source). - `mixed` — a declaration `types` AND a compilable runtime source (`import`/`require`/`default` → `.ts`/`.tsx`). - `none` — anything else (normal runtime export, json, etc.).
-
-```ts
-function classifyDtsExport(value: unknown): DtsExportClass;
-```

package/content/packages/tsdown-plugins/api/function/collectexportnames.md

@@ -1,18 +0,0 @@
----
-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
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# collectExportNames
-
-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 strict subset of a base entry, so a stub re-exporting from that base resolves every symbol. Pure parsing — no I/O.
-
-```ts
-function collectExportNames(source: string, fileName?: string): ModuleExportNames;
-```

package/content/packages/tsdown-plugins/api/function/computeexefilename.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/computeexefilename
-title: "computeExeFileName — tsdown-plugins function"
-summary: "The exact filename `@tsdown/exe` emits for a SEA target, mirroring tsdown's `resolveOutputFileName`: base fileName + `-<platform>-<arch>` + `.exe` on win. Sing…"
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# computeExeFileName
-
-The exact filename `@tsdown/exe` emits for a SEA target, mirroring tsdown's `resolveOutputFileName`: base fileName + `-<platform>-<arch>` + `.exe` on win. Single source of truth so the manifest value never drifts from the on-disk file.
-
-```ts
-function computeExeFileName(fileName: string, target: ExeTarget): string;
-```

package/content/packages/tsdown-plugins/api/function/copyambientdts.md

@@ -1,18 +0,0 @@
----
-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
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# copyAmbientDts
-
-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 bundled, so the build owns two fast-fail checks: the source must exist, and it must be self-contained — a relative import/export/reference would not resolve once the file is flattened to the package root. Throws [ConfigValidationError](silk://packages/tsdown-plugins/api/class/configvalidationerror) on a missing source or any relative specifier.
-
-```ts
-function copyAmbientDts(options: CopyAmbientDtsOptions): void;
-```

package/content/packages/tsdown-plugins/api/function/copypublicdir.md

@@ -1,18 +0,0 @@
----
-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
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# copyPublicDir
-
-Copy the CONTENTS of `sourceDir` into `outDir`, additively. Each `sourceDir/<rel>` copies to `outDir/<rel>` — only the `public/` directory itself is dropped; the substructure under it is preserved (`public/tsconfig/ecma.json` becomes `<pkg>/tsconfig/ecma.json`, NOT `<pkg>/ecma.json`). The published manifest mirrors this drop via `transformExports`, which strips a leading `public/` from export values. This function NEVER deletes: `outDir` is the shared package root that the JS/dts passes own, so deleting "files not in source" would wipe the build product. Stale-asset pruning on a non-clean rebuild is therefore out of scope (a full build's `clean: true` handles it). Collision guard: when a destination already exists, identical bytes mean a prior copy of the same asset (skipped); anything else — differing bytes, a directory where a file is needed, or a file where a parent directory is needed — means a built output occupies that path, so it throws [ConfigValidationError](silk://packages/tsdown-plugins/api/class/configvalidationerror) rather than clobbering it or surfacing a raw fs error.
-
-```ts
-function copyPublicDir(sourceDir: string, outDir: string): void;
-```

package/content/packages/tsdown-plugins/api/function/createtimer.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/createtimer
-title: "createTimer — tsdown-plugins function"
-summary: "Create a wall-clock timer. (Date.now is fine in runtime build code.)"
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# createTimer
-
-Create a wall-clock timer. (Date.now is fine in runtime build code.)
-
-```ts
-function createTimer(now?: () => number): Timer;
-```

package/content/packages/tsdown-plugins/api/function/createtsdownlogger.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/createtsdownlogger
-title: "createTsdownLogger — tsdown-plugins function"
-summary: "A tsdown `customLogger` that routes warnings/errors into the BuildCollector instead of the console. Paired with `logLevel: \"silent\"` in the same build config:…"
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# createTsdownLogger
-
-A tsdown `customLogger` that routes warnings/errors into the [BuildCollector](silk://packages/tsdown-plugins/api/class/buildcollector) instead of the console. Paired with `logLevel: "silent"` in the same build config: silent suppresses tsdown's own console output while this logger still receives every message (verified against tsdown 0.22.3). info/success are dropped — file metrics come from the writeBundle plugin and timing from our timer.
-
-```ts
-function createTsdownLogger(collector: BuildCollector, groupId: string): TsdownLogger;
-```

package/content/packages/tsdown-plugins/api/function/declarationext.md

@@ -1,18 +0,0 @@
----
-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
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# declarationExt
-
-The declaration-file extension of a path, or undefined when it is not a declaration file.
-
-```ts
-function declarationExt(p: string): ".d.ts" | ".d.cts" | ".d.mts" | undefined;
-```

package/content/packages/tsdown-plugins/api/function/defaultmanifesttransform.md

@@ -1,20 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/defaultmanifesttransform
-title: "defaultManifestTransform — tsdown-plugins function"
-summary: "The default `transform` applied to every package's manifest when its `savvy.build.ts` does not provide one of its own. Strips the build/dev-only fields in `NON…"
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# defaultManifestTransform
-
-The default `transform` applied to every package's manifest when its `savvy.build.ts` does not provide one of its own. Strips the build/dev-only fields in `NON_PUBLISHED_FIELDS` from the emitted package.json. This is the pattern nearly every package repeated by hand (inherited from rslib-builder); `defineBuild` now applies it automatically so a package needs a `transform` only when it has genuinely custom manifest work to do (e.g. silk promoting workspace deps to peerDependencies). A custom transform REPLACES this default — re-export it and call it from a custom transform to keep the stripping. `targetGroup` is accepted (so this is assignable wherever the full transform signature is expected) but unused; the strip is identical for every group. Pure: the supplied `pkg` is NOT mutated — a shallow copy with the fields removed is returned, so external callers invoking this from a custom transform keep their input intact.
-
-```ts
-function defaultManifestTransform(input: {
-  pkg: Json;
-}): Json;
-```

package/content/packages/tsdown-plugins/api/function/deriveexportpaths.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/deriveexportpaths
-title: "deriveExportPaths — tsdown-plugins function"
-summary: "Map entry names to export paths using the package exports map. index maps to \".\"."
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# deriveExportPaths
-
-Map entry names to export paths using the package exports map. index maps to ".".
-
-```ts
-function deriveExportPaths(entries: Record<string, string>, exportsMap: Record<string, string> | undefined): Record<string, string>;
-```

package/content/packages/tsdown-plugins/api/function/derivetargetgroupoptions.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/derivetargetgroupoptions
-title: "deriveTargetGroupOptions — tsdown-plugins function"
-summary: "Derive the JS-pass tsdown options for one TargetGroup (per-module JS, no dts)."
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# deriveTargetGroupOptions
-
-Derive the JS-pass tsdown options for one TargetGroup (per-module JS, no dts).
-
-```ts
-function deriveTargetGroupOptions(options: DeriveOptions): DerivedTsdownOptions;
-```

package/content/packages/tsdown-plugins/api/function/emitmanifest.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/emitmanifest
-title: "emitManifest — tsdown-plugins function"
-summary: "Rolldown plugin: emit the transformed package.json + LICENSE/README into the output pkg/ root."
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# emitManifest
-
-Rolldown plugin: emit the transformed package.json + LICENSE/README into the output pkg/ root.
-
-```ts
-function emitManifest(options: EmitManifestOptions): Plugin;
-```

package/content/packages/tsdown-plugins/api/function/extractambientdts.md

@@ -1,18 +0,0 @@
----
-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
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# extractAmbientDts
-
-Extract the types-only `.d.ts` exports from a package's `exports` map. Pure. Throws [ConfigValidationError](silk://packages/tsdown-plugins/api/class/configvalidationerror) on a mixed export (Decision 2) or an ambient-vs-ambient output-name collision.
-
-```ts
-function extractAmbientDts(pkg: PackageJsonLike, options?: ExtractAmbientOptions): ReadonlyArray<AmbientDtsEntry>;
-```

package/content/packages/tsdown-plugins/api/function/extractentries.md

@@ -1,16 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/extractentries
-title: "extractEntries — tsdown-plugins function"
-summary: "function extractEntries from @savvy-web/tsdown-plugins."
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# extractEntries
-
-```ts
-function extractEntries(pkg: PackageJsonLike, options?: ExtractOptions): ExtractResult;
-```

package/content/packages/tsdown-plugins/api/function/findrelativespecifiers.md

@@ -1,21 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/findrelativespecifiers
-title: "findRelativeSpecifiers — tsdown-plugins function"
-summary: "function findRelativeSpecifiers from @savvy-web/tsdown-plugins."
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# findRelativeSpecifiers
-
-```ts
-function findRelativeSpecifiers(source: string, fileName?: string): string[];
-```
-
-## Parameters
-
-- `source` `string`
-- `fileName` `string`

package/content/packages/tsdown-plugins/api/function/flattenissues.md

@@ -1,21 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/flattenissues
-title: "flattenIssues — tsdown-plugins function"
-summary: "Flatten a build snapshot into the aggregated, de-duplicated issues artifact. Pure."
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# flattenIssues
-
-Flatten a build snapshot into the aggregated, de-duplicated issues artifact. Pure.
-
-```ts
-function flattenIssues(reports: ReadonlyArray<BuildReport>, opts: {
-  target: "dev" | "prod";
-  generatedAt: string;
-}): BuildIssues;
-```

package/content/packages/tsdown-plugins/api/function/formattime.md

@@ -1,16 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/formattime
-title: "formatTime — tsdown-plugins function"
-summary: "function formatTime from @savvy-web/tsdown-plugins."
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# formatTime
-
-```ts
-function formatTime(ms: number): string;
-```

package/content/packages/tsdown-plugins/api/function/generatemeta.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/generatemeta
-title: "generateMeta — tsdown-plugins function"
-summary: "Generate the api-model meta bundle from already-emitted .d.ts. Writes tsdoc.json (idempotent), runs the extractor per entry, merges if needed, and writes the \"…"
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# generateMeta
-
-Generate the api-model meta bundle from already-emitted .d.ts. Writes tsdoc.json (idempotent), runs the extractor per entry, merges if needed, and writes the "virtual TS env" trio to outMetaDir (`<unscoped>.api.json` + the final `package.json` + a portable `tsconfig.json`), copying that trio into each localPaths dir. The api-extractor `tsdoc-metadata.json` is a published-package artifact and is written into `dtsDir` (the built pkg/), not the meta bundle.
-
-```ts
-function generateMeta(options: GenerateMetaOptions): Promise<MetaResult>;
-```

package/content/packages/tsdown-plugins/api/function/istargetobject.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/istargetobject
-title: "isTargetObject — tsdown-plugins function"
-summary: "True when a target value is the object form (carries registry/name/from)."
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# isTargetObject
-
-True when a target value is the object form (carries registry/name/from).
-
-```ts
-function isTargetObject(value: PublishTargetValue): value is PublishTargetObject;
-```

package/content/packages/tsdown-plugins/api/function/mixeddtsexporterror.md

@@ -1,18 +0,0 @@
----
-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
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# mixedDtsExportError
-
-The shared mixed-export error (Decision 2), used by both the extractor and the manifest transform.
-
-```ts
-function mixedDtsExportError(exportKey: string): ConfigValidationError;
-```

package/content/packages/tsdown-plugins/api/function/nodebuiltindefaultinterop.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/nodebuiltindefaultinterop
-title: "nodeBuiltinDefaultInterop — tsdown-plugins function"
-summary: "Rewrite a default import / default re-export of a Node built-in into the equivalent NAMESPACE form, so rolldown's CJS codegen produces correct interop. Why thi…"
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# nodeBuiltinDefaultInterop
-
-Rewrite a default import / default re-export of a Node built-in into the equivalent NAMESPACE form, so rolldown's CJS codegen produces correct interop. Why this exists — a rolldown 1.1.0 codegen defect (verified against the latest published rolldown 1.1.0 / tsdown 0.22.2, with no newer release to upgrade to): For a default import of an EXTERNAL Node builtin, rolldown emits a bare `require("node:x")` WITHOUT its `__toESM` interop wrapper, yet still accesses `.default` — which is `undefined` on a builtin's CJS export object, so the call throws `Cannot read properties of undefined (reading 'cwd')` at runtime. NAMED imports are unaffected (`(0, node_process.cwd)()` reads a real property), and a NAMESPACE import is handled correctly: rolldown wraps it as `node_process = __toESM(require("node:process"), 1)`, which synthesizes `.default` and copies every own property, so member access works. This transform converts the broken default form into the working namespace form BEFORE codegen, so it is immune to minification and applies identically to per-module and bundled output. rolldown exposes no Rollup-style `output.interop` knob to fix this at the output layer, which is why the correction happens here on the source. Rewrites (the two static forms that occur in practice, anchored to statement start): The namespace binding NAME carries the builtin's named exports (`NAME.cwd`, `NAME.join`, ...), which is exactly how a default import of a builtin is consumed in practice. ESM output is unaffected at runtime (a namespace import of a builtin resolves to the same members), so the plugin is safe to attach to dual builds.
-
-```ts
-function nodeBuiltinDefaultInterop(): Plugin;
-```

package/content/packages/tsdown-plugins/api/function/normalizebinpaths.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/normalizebinpaths
-title: "normalizeBinPaths — tsdown-plugins function"
-summary: "FINAL guard: strip leading ./ from bin paths (npm 11.x drops ./-prefixed bins)."
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# normalizeBinPaths
-
-FINAL guard: strip leading ./ from bin paths (npm 11.x drops ./-prefixed bins).
-
-```ts
-function normalizeBinPaths(bin: unknown): unknown;
-```

package/content/packages/tsdown-plugins/api/function/normalizeexeoptions.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/normalizeexeoptions
-title: "normalizeExeOptions — tsdown-plugins function"
-summary: "Normalize `exe` (object or array) into one fully-resolved spec per binary. Pure function; structural validation (missing fileName, empty targets) lives in the…"
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# normalizeExeOptions
-
-Normalize `exe` (object or array) into one fully-resolved spec per binary. Pure function; structural validation (missing fileName, empty targets) lives in the config-validation layer.
-
-```ts
-function normalizeExeOptions(exe: ExeConfig | ReadonlyArray<ExeConfig>, pkg: PkgOsCpu): ReadonlyArray<NormalizedExe>;
-```

package/content/packages/tsdown-plugins/api/function/normalizeloosefiles.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/normalizeloosefiles
-title: "normalizeLooseFiles — tsdown-plugins function"
-summary: "Resolve a `looseFiles` map into normalized build descriptors. Pure (no filesystem): a missing `source` is surfaced later by tsdown's entry resolution. Throws C…"
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# normalizeLooseFiles
-
-Resolve a `looseFiles` map into normalized build descriptors. Pure (no filesystem): a missing `source` is surfaced later by tsdown's entry resolution. Throws [ConfigValidationError](silk://packages/tsdown-plugins/api/class/configvalidationerror) on any structural problem so the bundler's [ConfigValidator](silk://packages/tsdown-plugins/api/class/configvalidator) surfaces it as a typed, fast-fail config error.
-
-```ts
-function normalizeLooseFiles(files: LooseFiles): ReadonlyArray<NormalizedLooseFile>;
-```

package/content/packages/tsdown-plugins/api/function/normalizemetaoptions.md

@@ -1,21 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/normalizemetaoptions
-title: "normalizeMetaOptions — tsdown-plugins function"
-summary: "Fill defaults so downstream code never branches on undefined."
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# normalizeMetaOptions
-
-Fill defaults so downstream code never branches on undefined.
-
-```ts
-function normalizeMetaOptions(meta: MetaOptions, env?: {
-  CI?: string | undefined;
-  GITHUB_ACTIONS?: string | undefined;
-}): NormalizedMeta;
-```

package/content/packages/tsdown-plugins/api/function/packagejsonentries.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/packagejsonentries
-title: "packageJsonEntries — tsdown-plugins function"
-summary: "Derive a tsdown `entry` record (name to source path) from a package.json."
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# packageJsonEntries
-
-Derive a tsdown `entry` record (name to source path) from a package.json.
-
-```ts
-function packageJsonEntries(options?: PackageJsonEntriesOptions): Record<string, string>;
-```

package/content/packages/tsdown-plugins/api/function/readtsconfigjsx.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/readtsconfigjsx
-title: "readTsconfigJsx — tsdown-plugins function"
-summary: "Read the jsx-relevant compilerOptions from a package's own tsconfig.json (best-effort; returns empty on absence or parse error)."
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# readTsconfigJsx
-
-Read the jsx-relevant compilerOptions from a package's own tsconfig.json (best-effort; returns empty on absence or parse error).
-
-```ts
-function readTsconfigJsx(cwd: string): TsconfigJsx;
-```

package/content/packages/tsdown-plugins/api/function/removedeclarationmaps.md

@@ -1,18 +0,0 @@
----
-id: packages/tsdown-plugins/api/function/removedeclarationmaps
-title: "removeDeclarationMaps — tsdown-plugins function"
-summary: "Remove declaration source-map files (`.d.ts.map` / `.d.cts.map`) from a built `pkg` directory, returning the removed paths. The dts pass emits these next to ea…"
-tier: packages
-source: generated
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# removeDeclarationMaps
-
-Remove declaration source-map files (`.d.ts.map` / `.d.cts.map`) from a built `pkg` directory, returning the removed paths. The dts pass emits these next to each `.d.ts` (the resolved dts tsconfig sets `declarationMap: true`) because API Extractor reads them during meta generation to resolve original-source positions. But they are dead weight in a PUBLISHED package — they reference `.ts` sources the tarball does not ship — and they leak local source paths, so the prod build strips them AFTER meta generation has consumed them. The dev build keeps them (it is never published, and `savvy build --target meta` reads them). Recurses, but skips `node_modules` so it does not traverse a self-contained bundle's vendored tree — only the package's own emitted declarations carry maps worth stripping.
-
-```ts
-function removeDeclarationMaps(pkgDir: string): string[];
-```

package/content/packages/tsdown-plugins/api/function/renderreexportstub.md

@@ -1,22 +0,0 @@
----
-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
-tags: [tsdown-plugins, api]
-priority: 0.3
-related: []
----
-
-# renderReexportStub
-
-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, e.g. `./index.js` for the ESM `.d.ts` or `./index.cjs` for the CJS `.d.cts`). Names are sorted so the output is deterministic. Returns the empty string when there is nothing to re-export.
-
-```ts
-function renderReexportStub(options: {
-  readonly valueNames: ReadonlyArray<string>;
-  readonly typeNames: ReadonlyArray<string>;
-  readonly baseSpecifier: string;
-}): string;
-```