@savvy-web/mcp 1.3.3 → 1.3.4

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

@@ -0,0 +1,18 @@
+---
+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/public/content/packages/tsdown-plugins/api/function/normalizeloosefiles.md

@@ -0,0 +1,18 @@
+---
+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/public/content/packages/tsdown-plugins/api/function/normalizemetaoptions.md

@@ -0,0 +1,21 @@
+---
+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/public/content/packages/tsdown-plugins/api/function/packagejsonentries.md

@@ -0,0 +1,18 @@
+---
+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/public/content/packages/tsdown-plugins/api/function/readtsconfigjsx.md

@@ -0,0 +1,18 @@
+---
+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/public/content/packages/tsdown-plugins/api/function/removedeclarationmaps.md

@@ -0,0 +1,18 @@
+---
+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/public/content/packages/tsdown-plugins/api/function/renderreport.md

@@ -0,0 +1,17 @@
+---
+id: packages/tsdown-plugins/api/function/renderreport
+title: "renderReport — tsdown-plugins function"
+summary: "function renderReport from @savvy-web/tsdown-plugins."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# renderReport
+
+```ts
+renderReport: (reports: ReadonlyArray<BuildReport>, options: RenderReportOptions) => Effect.Effect<ReadonlyArray<RenderedOutput>, never, EnvironmentDetector |
+  ExecutorResolver | FormatSelector | OutputRenderer>
+```

package/public/content/packages/tsdown-plugins/api/function/resolvejsxconfig.md

@@ -0,0 +1,18 @@
+---
+id: packages/tsdown-plugins/api/function/resolvejsxconfig
+title: "resolveJsxConfig — tsdown-plugins function"
+summary: "Resolve the effective JSX config: an explicit override wins; otherwise infer from the tsconfig values. Returns undefined when no JSX transform is needed (prese…"
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# resolveJsxConfig
+
+Resolve the effective JSX config: an explicit override wins; otherwise infer from the tsconfig values. Returns undefined when no JSX transform is needed (preserve/none).
+
+```ts
+function resolveJsxConfig(tsconfig: TsconfigJsx, override: JsxConfig | undefined): JsxConfig | undefined;
+```

package/public/content/packages/tsdown-plugins/api/function/resolvemanifest.md

@@ -0,0 +1,18 @@
+---
+id: packages/tsdown-plugins/api/function/resolvemanifest
+title: "resolveManifest — tsdown-plugins function"
+summary: "Resolve every `catalog:`/`workspace:` specifier in a manifest to a concrete spec, delegating to workspaces-effect's CatalogResolver. The resolver discovers the…"
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# resolveManifest
+
+Resolve every `catalog:`/`workspace:` specifier in a manifest to a concrete spec, delegating to workspaces-effect's CatalogResolver. The resolver discovers the workspace root from `process.cwd()` (run this from inside the target workspace) and assembles catalogs durably (inline + config-dependency hook-replay + lockfile), so no transient `.pnpm-workspace-state-v1.json` is required. Rejects with `CatalogResolutionError` on an unresolvable reference, or `CatalogAssemblyError` if the workspace catalog set cannot be assembled.
+
+```ts
+function resolveManifest(pkg: ManifestLike$1): Promise<ManifestLike$1>;
+```

package/public/content/packages/tsdown-plugins/api/function/resolvenextversions.md

@@ -0,0 +1,18 @@
+---
+id: packages/tsdown-plugins/api/function/resolvenextversions
+title: "resolveNextVersions — tsdown-plugins function"
+summary: "Resolve the next release version of every workspace package from pending changesets. Walks up from `cwd` to the monorepo root via `@manypkg/get-packages`, seed…"
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# resolveNextVersions
+
+Resolve the next release version of every workspace package from pending changesets. Walks up from `cwd` to the monorepo root via `@manypkg/get-packages`, seeds the map with each package's CURRENT version, then overlays `newVersion` for changeset-affected packages via `@changesets/get-release-plan`. Never rejects: any failure (not a workspace, missing `.changeset/config.json`, parse error) degrades to current versions (or an empty map).
+
+```ts
+function resolveNextVersions(cwd: string): Promise<NextVersions>;
+```

package/public/content/packages/tsdown-plugins/api/function/resolveportabletsconfig.md

@@ -0,0 +1,27 @@
+---
+id: packages/tsdown-plugins/api/function/resolveportabletsconfig
+title: "resolvePortableTsconfig — tsdown-plugins function"
+summary: "Resolves the package's effective compiler options (following `extends`) into a portable, JSON-serializable tsconfig for the meta release bundle."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# resolvePortableTsconfig
+
+Resolves the package's effective compiler options (following `extends`) into a portable, JSON-serializable tsconfig for the meta release bundle.
+
+```ts
+function resolvePortableTsconfig(cwd: string, fallbackConfigPath?: string): PortableTsconfig;
+```
+
+## Parameters
+
+- `cwd` `string` — Absolute package root.
+- `fallbackConfigPath` `string` — Optional resolved tsconfig to use when the package has no own one.
+
+## Returns
+
+The portable tsconfig object.

package/public/content/packages/tsdown-plugins/api/function/resolvetargets.md

@@ -0,0 +1,21 @@
+---
+id: packages/tsdown-plugins/api/function/resolvetargets
+title: "resolveTargets — tsdown-plugins function"
+summary: "Resolve a `publishConfig.targets` map into the distinct groups to build and every target bound to one. Pure; throws ConfigValidationError on structurally-inval…"
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# resolveTargets
+
+Resolve a `publishConfig.targets` map into the distinct groups to build and every target bound to one. Pure; throws [ConfigValidationError](silk://packages/tsdown-plugins/api/class/configvalidationerror) on structurally-invalid config.
+
+```ts
+function resolveTargets(options: {
+  targets: PublishTargets;
+  baseName: string;
+}): TargetResolution;
+```

package/public/content/packages/tsdown-plugins/api/function/rewritemetaversions.md

@@ -0,0 +1,18 @@
+---
+id: packages/tsdown-plugins/api/function/rewritemetaversions
+title: "rewriteMetaVersions — tsdown-plugins function"
+summary: "Rewrite a meta `package.json` so the package's own `version` and any workspace-sibling dependency version reflect their NEXT release version from `versions`. P…"
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# rewriteMetaVersions
+
+Rewrite a meta `package.json` so the package's own `version` and any workspace-sibling dependency version reflect their NEXT release version from `versions`. Pure: returns a new object, never mutates the input. External/catalog-resolved deps (names absent from `versions`) are left as-is.
+
+```ts
+function rewriteMetaVersions(pkg: Record<string, unknown>, versions: ReadonlyMap<string, string>, selfName: string): Record<string, unknown>;
+```

package/public/content/packages/tsdown-plugins/api/function/runexebuild.md

@@ -0,0 +1,18 @@
+---
+id: packages/tsdown-plugins/api/function/runexebuild
+title: "runExeBuild — tsdown-plugins function"
+summary: "Compile each SEA binary via tsdown's exe mode. One tsdown build per spec."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# runExeBuild
+
+Compile each SEA binary via tsdown's exe mode. One tsdown build per spec.
+
+```ts
+function runExeBuild(options: RunExeBuildOptions): Promise<void>;
+```

package/public/content/packages/tsdown-plugins/api/function/runmetapass.md

@@ -0,0 +1,18 @@
+---
+id: packages/tsdown-plugins/api/function/runmetapass
+title: "runMetaPass — tsdown-plugins function"
+summary: "Meta-pass orchestrator: derives export paths, filters bin/ entries, resolves optimistic next-versions, and calls generateMeta once per publish group."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# runMetaPass
+
+Meta-pass orchestrator: derives export paths, filters bin/ entries, resolves optimistic next-versions, and calls [generateMeta](silk://packages/tsdown-plugins/api/function/generatemeta) once per publish group.
+
+```ts
+function runMetaPass(o: RunMetaPassOptions): Promise<void>;
+```

package/public/content/packages/tsdown-plugins/api/function/serializeissues.md

@@ -0,0 +1,18 @@
+---
+id: packages/tsdown-plugins/api/function/serializeissues
+title: "serializeIssues — tsdown-plugins function"
+summary: "Serialize the issues artifact to pretty JSON with a trailing newline."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# serializeIssues
+
+Serialize the issues artifact to pretty JSON with a trailing newline.
+
+```ts
+function serializeIssues(issues: BuildIssues): string;
+```

package/public/content/packages/tsdown-plugins/api/function/syncpublicdir.md

@@ -0,0 +1,18 @@
+---
+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
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# syncPublicDir
+
+Mirror `sourceDir` into `targetDir`, idempotently. Replaces tsdown's built-in `copy`, whose non-recursive mkdir throws `EEXIST` when the target already exists (re-builds, `prepare`-on-install, concurrent turbo invocations). Behavior: - source absent: no-op. - target absent: copy `sourceDir` wholesale. - target present: copy only files that are new or whose bytes differ, then delete target files that no longer exist in the source and prune the directories left empty. The byte-diff keeps unchanged files (and their timestamps) untouched, so a large copied asset tree — e.g. the mcp markdown corpus — is not rewritten on every build.
+
+```ts
+function syncPublicDir(sourceDir: string, targetDir: string): void;
+```

package/public/content/packages/tsdown-plugins/api/function/transformbin.md

@@ -0,0 +1,18 @@
+---
+id: packages/tsdown-plugins/api/function/transformbin
+title: "transformBin — tsdown-plugins function"
+summary: "Rewrite bin: TS targets to bin/[command].js (string to bin/cli.js); strip leading ./ otherwise."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# transformBin
+
+Rewrite bin: TS targets to bin/[command].js (string to bin/cli.js); strip leading ./ otherwise.
+
+```ts
+function transformBin(bin: unknown): unknown;
+```

package/public/content/packages/tsdown-plugins/api/function/transformexports.md

@@ -0,0 +1,18 @@
+---
+id: packages/tsdown-plugins/api/function/transformexports
+title: "transformExports — tsdown-plugins function"
+summary: "Rewrite an exports map: TS string targets become a types/import conditions object. Each TS condition also gets a `require` entry when `dual` is `true` (uniform…"
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# transformExports
+
+Rewrite an exports map: TS string targets become a types/import conditions object. Each TS condition also gets a `require` entry when `dual` is `true` (uniform) or when the export key is in the `dual` Set (per-entry). The output path is derived from the export KEY via the shared entry-name function, never from the source path, so the manifest target always matches the emitted file. Export keys in `subdirExports` are built into an isolated `<key>/index.*` subdir (e.g. an RSPress `./runtime`), so their conditions gain an `/index` segment.
+
+```ts
+function transformExports(exports: unknown, dual?: DualExports, subdirExports?: ReadonlySet<string>): unknown;
+```

package/public/content/packages/tsdown-plugins/api/function/transformmanifest.md

@@ -0,0 +1,18 @@
+---
+id: packages/tsdown-plugins/api/function/transformmanifest
+title: "transformManifest — tsdown-plugins function"
+summary: "Apply the full standard manifest transform (excluding catalog resolution, done upstream)."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# transformManifest
+
+Apply the full standard manifest transform (excluding catalog resolution, done upstream).
+
+```ts
+function transformManifest(pkg: Json, options?: TransformManifestOptions): Json;
+```

package/public/content/packages/tsdown-plugins/api/function/writeissuesartifact.md

@@ -0,0 +1,23 @@
+---
+id: packages/tsdown-plugins/api/function/writeissuesartifact
+title: "writeIssuesArtifact — tsdown-plugins function"
+summary: "Write the aggregated issues artifact to `<cwd>/dist/<target>/issues.json`. Returns the path written."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# writeIssuesArtifact
+
+Write the aggregated issues artifact to `<cwd>/dist/<target>/issues.json`. Returns the path written.
+
+```ts
+function writeIssuesArtifact(opts: {
+  cwd: string;
+  target: "dev" | "prod";
+  reports: ReadonlyArray<BuildReport>;
+  now?: () => Date;
+}): string;
+```

package/public/content/packages/tsdown-plugins/api/function/writeresolvedtsconfig.md

@@ -0,0 +1,18 @@
+---
+id: packages/tsdown-plugins/api/function/writeresolvedtsconfig
+title: "writeResolvedTsconfig — tsdown-plugins function"
+summary: "Write the resolved tsconfig to a temp file and return its absolute path."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# writeResolvedTsconfig
+
+Write the resolved tsconfig to a temp file and return its absolute path.
+
+```ts
+function writeResolvedTsconfig(options: ResolvedTsconfigOptions): string;
+```

package/public/content/packages/tsdown-plugins/api/function/writetargetsbinding.md

@@ -0,0 +1,18 @@
+---
+id: packages/tsdown-plugins/api/function/writetargetsbinding
+title: "writeTargetsBinding — tsdown-plugins function"
+summary: "Write the target-to-group binding to dist/prod/targets.json for the release action to consume. Returns the path."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# writeTargetsBinding
+
+Write the target-to-group binding to dist/prod/targets.json for the release action to consume. Returns the path.
+
+```ts
+function writeTargetsBinding(cwd: string, resolution: TargetResolution): string;
+```

package/public/content/packages/tsdown-plugins/api/interface/buildemittedmanifestoptions.md

@@ -0,0 +1,69 @@
+---
+id: packages/tsdown-plugins/api/interface/buildemittedmanifestoptions
+title: "BuildEmittedManifestOptions — tsdown-plugins interface"
+summary: "interface BuildEmittedManifestOptions from @savvy-web/tsdown-plugins."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# BuildEmittedManifestOptions
+
+```ts
+interface BuildEmittedManifestOptions
+```
+
+## Members
+
+### devManifest
+
+```ts
+readonly devManifest: "preserve" | "resolve";
+```
+
+### 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`.
+
+### pkg
+
+```ts
+readonly pkg: Json;
+```
+
+### 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/public/content/packages/tsdown-plugins/api/interface/buildgroupspec.md

@@ -0,0 +1,32 @@
+---
+id: packages/tsdown-plugins/api/interface/buildgroupspec
+title: "BuildGroupSpec — tsdown-plugins interface"
+summary: "A prod/dev group to build: its folder id and the resolved package name its manifest carries."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# BuildGroupSpec
+
+A prod/dev group to build: its folder id and the resolved package name its manifest carries.
+
+```ts
+interface BuildGroupSpec
+```
+
+## Members
+
+### id
+
+```ts
+readonly id: TargetGroupId;
+```
+
+### name
+
+```ts
+readonly name: string;
+```

package/public/content/packages/tsdown-plugins/api/interface/buildissues.md

@@ -0,0 +1,56 @@
+---
+id: packages/tsdown-plugins/api/interface/buildissues
+title: "BuildIssues — tsdown-plugins interface"
+summary: "The aggregated build-issues artifact written to `dist/<target>/issues.json`."
+tier: packages
+source: generated
+tags: [tsdown-plugins, api]
+priority: 0.3
+related: []
+---
+
+# BuildIssues
+
+The aggregated build-issues artifact written to `dist/<target>/issues.json`.
+
+```ts
+interface BuildIssues
+```
+
+## Members
+
+### errors
+
+```ts
+errors: PlainDiagnostic[];
+```
+
+### generatedAt
+
+```ts
+generatedAt: string;
+```
+
+### package
+
+```ts
+package: string;
+```
+
+### suppressed
+
+```ts
+suppressed: PlainDiagnostic[];
+```
+
+### target
+
+```ts
+target: "dev" | "prod";
+```
+
+### warnings
+
+```ts
+warnings: PlainDiagnostic[];
+```