@savvy-web/tsdown-plugins 0.7.0 → 0.9.0

package/index.d.ts

@@ -2,25 +2,24 @@ import { CatalogAssemblyError, CatalogResolutionError, ManifestLike, ManifestLik
 import { Plugin } from "rolldown";
 import { Context, Effect, Layer, Schema } from "effect";
 import { JsxEmit, ModuleDetectionKind, ModuleKind, ModuleResolutionKind, NewLineKind, ParsedCommandLine, ScriptTarget } from "typescript";
-import * as Schema$1 from "effect/Schema";
-import * as Effect$1 from "effect/Effect";
-import { Option } from "effect/Option";
-import { Scope } from "effect/Scope";
-import { Sink } from "effect/Sink";
-import { Stream } from "effect/Stream";
-import * as Brand from "effect/Brand";
-import { Tag } from "effect/Context";
-import { JsonSchemaError, JsonSchemaOutput } from "json-schema-effect";
 
 //#region src/jsx/config.d.ts
-/** Resolved JSX transform settings, mirroring the subset of rolldown's JsxOptions the bundler forwards. */
+/**
+ * Resolved JSX transform settings, mirroring the subset of rolldown's JsxOptions the bundler forwards.
+ *
+ * @public
+ */
 interface JsxConfig {
   /** "automatic" auto-imports the JSX factories (react-jsx); "classic" does not (React.createElement). */
   readonly runtime?: "classic" | "automatic" | undefined;
   /** The JSX import source for the automatic runtime (e.g. "react", "preact"). */
   readonly importSource?: string | undefined;
 }
-/** The jsx-relevant slice of a tsconfig's compilerOptions. */
+/**
+ * The jsx-relevant slice of a tsconfig's compilerOptions.
+ *
+ * @public
+ */
 interface TsconfigJsx {
   readonly jsx?: string | undefined;
   readonly jsxImportSource?: string | undefined;
@@ -28,26 +27,30 @@ interface TsconfigJsx {
 /**
  * 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).
+ * @public
  */
 declare function resolveJsxConfig(tsconfig: TsconfigJsx, override: JsxConfig | undefined): JsxConfig | undefined;
 /**
  * Read the jsx-relevant compilerOptions from a package's own tsconfig.json (best-effort;
  * returns empty on absence or parse error).
+ * @public
  */
 declare function readTsconfigJsx(cwd: string): TsconfigJsx;
 //#endregion
 //#region src/manifest/transform.d.ts
+/** @public */
 type Json = Record<string, unknown>;
 /**
  * Which exports get a CJS `require` condition. `true`/`false` apply uniformly to every
  * TS export; a Set marks ONLY the listed export keys (e.g. "./changesets/markdownlint")
  * as dual — used by per-entry format overrides.
+ * @public
  */
 type DualExports = boolean | ReadonlySet<string>;
 /**
  * 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 {@link NON_PUBLISHED_FIELDS} from the emitted package.json.
+ * 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
@@ -61,6 +64,7 @@ type DualExports = boolean | ReadonlySet<string>;
  * 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.
+ * @public
  */
 declare function defaultManifestTransform({
   pkg
@@ -71,6 +75,7 @@ declare function defaultManifestTransform({
  * Describes a SEA binary the bundler compiled for this package. When present,
  * {@link 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.
+ * @public
  */
 interface ExeRewrite {
   /** The exe entry source path (matches exports/bin values to rewrite). */
@@ -90,12 +95,22 @@ interface ExeRewrite {
  *
  * Export keys in `subdirExports` are built into an isolated `<key>/index.*` subdir (e.g. an
  * RSPress `./runtime`), so their conditions gain an `/index` segment.
+ * @public
  */
 declare function transformExports(exports: unknown, dual?: DualExports, subdirExports?: ReadonlySet<string>): unknown;
-/** Rewrite bin: TS targets to bin/[command].js (string to bin/cli.js); strip leading ./ otherwise. */
+/**
+ * Rewrite bin: TS targets to bin/[command].js (string to bin/cli.js); strip leading ./ otherwise.
+ *
+ * @public
+ */
 declare function transformBin(bin: unknown): unknown;
-/** FINAL guard: strip leading ./ from bin paths (npm 11.x drops ./-prefixed bins). */
+/**
+ * FINAL guard: strip leading ./ from bin paths (npm 11.x drops ./-prefixed bins).
+ *
+ * @public
+ */
 declare function normalizeBinPaths(bin: unknown): unknown;
+/** @public */
 interface TransformManifestOptions {
   /** Run after the standard transforms, before the bin final-guard + sort. */
   readonly transform?: ((pkg: Json) => Json) | undefined;
@@ -106,16 +121,22 @@ interface TransformManifestOptions {
   /** When set, rewrite exports/bin values equal to `source` to the SEA path and add it to `files`. */
   readonly exeRewrite?: ExeRewrite | undefined;
 }
-/** Apply the full standard manifest transform (excluding catalog resolution, done upstream). */
+/**
+ * Apply the full standard manifest transform (excluding catalog resolution, done upstream).
+ *
+ * @public
+ */
 declare function transformManifest(pkg: Json, options?: TransformManifestOptions): Json;
 //#endregion
 //#region src/manifest/emit-manifest.d.ts
+/** @public */
 interface TargetGroupRef {
   readonly id: string;
   /** The package.json name this group's manifest carries (the declarative rename). */
   readonly name: string;
   readonly isProd: boolean;
 }
+/** @public */
 interface BuildEmittedManifestOptions {
   readonly pkg: Json;
   readonly targetGroup: TargetGroupRef;
@@ -131,8 +152,13 @@ interface BuildEmittedManifestOptions {
   /** When set, rewrite exports/bin values equal to the exe source to the SEA path and add it to `files`. */
   readonly exeRewrite?: ExeRewrite | undefined;
 }
-/** Compute the final manifest bytes for a TargetGroup (catalog resolution + standard transforms). */
+/**
+ * Compute the final manifest bytes for a TargetGroup (catalog resolution + standard transforms).
+ *
+ * @public
+ */
 declare function buildEmittedManifest(options: BuildEmittedManifestOptions): Promise<Json>;
+/** @public */
 interface EmitManifestOptions {
   readonly targetGroup: TargetGroupRef;
   readonly devManifest?: "preserve" | "resolve" | undefined;
@@ -149,21 +175,218 @@ interface EmitManifestOptions {
   /** When set, rewrite exports/bin values equal to the exe source to the SEA path and add it to `files`. */
   readonly exeRewrite?: ExeRewrite | undefined;
 }
-/** Rolldown plugin: emit the transformed package.json + LICENSE/README into the output pkg/ root. */
+/**
+ * Rolldown plugin: emit the transformed package.json + LICENSE/README into the output pkg/ root.
+ *
+ * @public
+ */
 declare function emitManifest(options: EmitManifestOptions): Plugin;
 //#endregion
+//#region src/report/schema.d.ts
+declare const ReportTimings_base: Schema.Class<ReportTimings, {
+  totalMs: typeof Schema.Number;
+}, Schema.Struct.Encoded<{
+  totalMs: typeof Schema.Number;
+}>, never, {
+  readonly totalMs: number;
+}, {}, {}>;
+/** @public */
+declare class ReportTimings extends ReportTimings_base {}
+declare const DiagnosticEntry_base: Schema.Class<DiagnosticEntry, {
+  source: Schema.Literal<["tsdown", "rolldown", "api-extractor"]>;
+  level: Schema.Literal<["warn", "error"]>;
+  text: typeof Schema.String; /** API Extractor messageId (e.g. "ae-forgotten-export"); used to group suppressed messages by type. */
+  code: Schema.optional<typeof Schema.String>; /** True when shown as `warn` locally but a hard error in CI (drives the "[fails CI]" nudge). */
+  ciFatal: Schema.optional<typeof Schema.Boolean>;
+  file: Schema.optional<typeof Schema.String>;
+  line: Schema.optional<typeof Schema.Number>;
+  column: Schema.optional<typeof Schema.Number>;
+}, Schema.Struct.Encoded<{
+  source: Schema.Literal<["tsdown", "rolldown", "api-extractor"]>;
+  level: Schema.Literal<["warn", "error"]>;
+  text: typeof Schema.String; /** API Extractor messageId (e.g. "ae-forgotten-export"); used to group suppressed messages by type. */
+  code: Schema.optional<typeof Schema.String>; /** True when shown as `warn` locally but a hard error in CI (drives the "[fails CI]" nudge). */
+  ciFatal: Schema.optional<typeof Schema.Boolean>;
+  file: Schema.optional<typeof Schema.String>;
+  line: Schema.optional<typeof Schema.Number>;
+  column: Schema.optional<typeof Schema.Number>;
+}>, never, {
+  readonly text: string;
+} & {
+  readonly source: "tsdown" | "rolldown" | "api-extractor";
+} & {
+  readonly level: "warn" | "error";
+} & {
+  readonly code?: string | undefined;
+} & {
+  readonly ciFatal?: boolean | undefined;
+} & {
+  readonly file?: string | undefined;
+} & {
+  readonly line?: number | undefined;
+} & {
+  readonly column?: number | undefined;
+}, {}, {}>;
+/**
+ * A captured warning or error, from tsdown's logger, rolldown's onLog, or API Extractor.
+ *
+ * @public
+ */
+declare class DiagnosticEntry extends DiagnosticEntry_base {}
+declare const EmittedFile_base: Schema.Class<EmittedFile, {
+  path: typeof Schema.String;
+  bytes: typeof Schema.Number;
+  gzip: Schema.optional<typeof Schema.Number>;
+}, Schema.Struct.Encoded<{
+  path: typeof Schema.String;
+  bytes: typeof Schema.Number;
+  gzip: Schema.optional<typeof Schema.Number>;
+}>, never, {
+  readonly path: string;
+} & {
+  readonly bytes: number;
+} & {
+  readonly gzip?: number | undefined;
+}, {}, {}>;
+/**
+ * One emitted output file with its in-memory byte size (gzip only when --verbose).
+ *
+ * @public
+ */
+declare class EmittedFile extends EmittedFile_base {}
+declare const PassReport_base: Schema.Class<PassReport, {
+  id: Schema.Literal<["js", "dts", "loose", "exe", "meta"]>;
+  files: Schema.Array$<typeof EmittedFile>;
+  ms: typeof Schema.Number;
+}, Schema.Struct.Encoded<{
+  id: Schema.Literal<["js", "dts", "loose", "exe", "meta"]>;
+  files: Schema.Array$<typeof EmittedFile>;
+  ms: typeof Schema.Number;
+}>, never, {
+  readonly ms: number;
+} & {
+  readonly id: "js" | "dts" | "loose" | "exe" | "meta";
+} & {
+  readonly files: readonly EmittedFile[];
+}, {}, {}>;
+/**
+ * One build pass within a target group (js / dts / loose / exe / meta).
+ *
+ * @public
+ */
+declare class PassReport extends PassReport_base {}
+declare const TargetGroupReport_base: Schema.Class<TargetGroupReport, {
+  id: typeof Schema.String;
+  entries: Schema.Array$<typeof Schema.String>;
+  passes: Schema.Array$<typeof PassReport>;
+  warnings: Schema.Array$<typeof DiagnosticEntry>;
+  errors: Schema.Array$<typeof DiagnosticEntry>; /** Messages matched by `suppressWarnings`, kept for accounting and `--verbose` expansion. */
+  suppressed: Schema.Array$<typeof DiagnosticEntry>;
+  timings: typeof ReportTimings;
+}, Schema.Struct.Encoded<{
+  id: typeof Schema.String;
+  entries: Schema.Array$<typeof Schema.String>;
+  passes: Schema.Array$<typeof PassReport>;
+  warnings: Schema.Array$<typeof DiagnosticEntry>;
+  errors: Schema.Array$<typeof DiagnosticEntry>; /** Messages matched by `suppressWarnings`, kept for accounting and `--verbose` expansion. */
+  suppressed: Schema.Array$<typeof DiagnosticEntry>;
+  timings: typeof ReportTimings;
+}>, never, {
+  readonly entries: readonly string[];
+} & {
+  readonly id: string;
+} & {
+  readonly timings: ReportTimings;
+} & {
+  readonly passes: readonly PassReport[];
+} & {
+  readonly warnings: readonly DiagnosticEntry[];
+} & {
+  readonly errors: readonly DiagnosticEntry[];
+} & {
+  readonly suppressed: readonly DiagnosticEntry[];
+}, {}, {}>;
+/** @public */
+declare class TargetGroupReport extends TargetGroupReport_base {}
+declare const BuildReport_base: Schema.Class<BuildReport, {
+  package: typeof Schema.String;
+  targetGroups: Schema.Array$<typeof TargetGroupReport>;
+}, Schema.Struct.Encoded<{
+  package: typeof Schema.String;
+  targetGroups: Schema.Array$<typeof TargetGroupReport>;
+}>, never, {
+  readonly package: string;
+} & {
+  readonly targetGroups: readonly TargetGroupReport[];
+}, {}, {}>;
+/** @public */
+declare class BuildReport extends BuildReport_base {}
+//#endregion
+//#region src/report/collector.d.ts
+/** @public */
+type PassKind = PassReport["id"];
+/** @public */
+interface DiagnosticInput {
+  readonly source: DiagnosticEntry["source"];
+  readonly level: DiagnosticEntry["level"];
+  readonly text: string;
+  readonly code?: string;
+  readonly ciFatal?: boolean;
+  readonly file?: string;
+  readonly line?: number;
+  readonly column?: number;
+}
+/**
+ * Stateful build-event accumulator. The write surface is synchronous so it can be called directly
+ * from tsdown's customLogger and API Extractor's messageCallback (both invoked synchronously).
+ * `snapshot` builds the immutable BuildReport the Effect render pipeline consumes.
+ * @public
+ */
+declare class BuildCollector {
+  private readonly groups;
+  private group;
+  private pass;
+  registerGroup(groupId: string, entries: ReadonlyArray<string>): void;
+  recordEmitted(groupId: string, pass: PassKind, file: EmittedFile): void;
+  recordPassTiming(groupId: string, pass: PassKind, ms: number): void;
+  recordWarning(groupId: string, entry: DiagnosticInput): void;
+  recordError(groupId: string, entry: DiagnosticInput): void;
+  recordSuppressed(groupId: string, entry: DiagnosticInput): void;
+  snapshot(packageName: string): ReadonlyArray<BuildReport>;
+}
+declare const BuildCollectorTag_base: Context.TagClass<BuildCollectorTag, "@savvy-web/tsdown-plugins/BuildCollector", BuildCollector>;
+/** @public */
+declare class BuildCollectorTag extends BuildCollectorTag_base {}
+//#endregion
 //#region src/build/target-groups.d.ts
-/** A build group id: "dev" or any prod byte-variant id (e.g. "npm", "github", a custom key). */
+/**
+ * A build group id: "dev" or any prod byte-variant id (e.g. "npm", "github", a custom key).
+ *
+ * @public
+ */
 type TargetGroupId = string;
-/** An output module format the build can emit. */
+/**
+ * An output module format the build can emit.
+ *
+ * @public
+ */
 type BuildFormat = "esm" | "cjs";
-/** Bundling platform for the JS pass. Defaults to "node". Use "browser" for web runtime partitions. */
+/**
+ * Bundling platform for the JS pass. Defaults to "node". Use "browser" for web runtime partitions.
+ *
+ * @public
+ */
 type BuildPlatform = "node" | "browser" | "neutral";
-/** A prod/dev group to build: its folder id and the resolved package name its manifest carries. */
+/**
+ * A prod/dev group to build: its folder id and the resolved package name its manifest carries.
+ *
+ * @public
+ */
 interface BuildGroupSpec {
   readonly id: TargetGroupId;
   readonly name: string;
 }
+/** @public */
 interface DeriveOptions {
   readonly group: TargetGroupId;
   readonly cwd: string;
@@ -211,6 +434,7 @@ interface DeriveOptions {
  * the JS re-bundles workspace consumers (e.g. silk re-bundling silk-effects crashes at
  * runtime). The split keeps per-module JS (no re-bundle hazard) AND bundled, self-contained
  * declarations (no TS2883).
+ * @public
  */
 interface DerivedTsdownOptions {
   readonly outDir: string;
@@ -262,20 +486,36 @@ interface DerivedTsdownOptions {
   /** JSX transform settings to forward to rolldown's inputOptions. */
   readonly jsx?: JsxConfig | undefined;
 }
-/** Derive the JS-pass tsdown options for one TargetGroup (per-module JS, no dts). */
+/**
+ * Derive the JS-pass tsdown options for one TargetGroup (per-module JS, no dts).
+ *
+ * @public
+ */
 declare function deriveTargetGroupOptions(options: DeriveOptions): DerivedTsdownOptions;
 //#endregion
 //#region src/build/loose-files.d.ts
-/** One standalone bundled output file, declared by its literal output filename. */
+/**
+ * One standalone bundled output file, declared by its literal output filename.
+ *
+ * @public
+ */
 interface LooseFileSpec {
   /** Source module to bundle into the file. */
   readonly source: string;
   /** Module format. Required only for an ambiguous `.js` key; inferred from `.mjs`/`.cjs`. */
   readonly format?: BuildFormat | undefined;
 }
-/** Map of literal output filename to its source (bare string) or a `{ source, format }` spec. */
+/**
+ * Map of literal output filename to its source (bare string) or a `{ source, format }` spec.
+ *
+ * @public
+ */
 type LooseFiles = Record<string, string | LooseFileSpec>;
-/** A loose file resolved to a concrete build descriptor. */
+/**
+ * A loose file resolved to a concrete build descriptor.
+ *
+ * @public
+ */
 interface NormalizedLooseFile {
   /** Literal output filename written into the package dir, e.g. `pnpmfile.mjs`. */
   readonly outFile: string;
@@ -296,16 +536,22 @@ interface NormalizedLooseFile {
  * a missing `source` is surfaced later by tsdown's entry resolution. Throws
  * {@link ConfigValidationError} on any structural problem so the bundler's ConfigValidator
  * surfaces it as a typed, fast-fail config error.
+ * @public
  */
 declare function normalizeLooseFiles(files: LooseFiles): ReadonlyArray<NormalizedLooseFile>;
 //#endregion
 //#region src/build/build-target-groups.d.ts
-/** Signature compatible with tsdown's `build(inlineConfig)`. */
+/**
+ * Signature compatible with tsdown's `build(inlineConfig)`.
+ *
+ * @public
+ */
 type TsdownBuild = (config: Record<string, unknown>) => Promise<unknown>;
 /**
  * CSS handling for a partition's JS pass, forwarded VERBATIM to tsdown's `css` option (consumed
  * by `@tsdown/css`). Structurally typed so tsdown-plugins takes no dependency on `@tsdown/css`.
  * The package whose runtime is built must install `@tsdown/css`; tsdown loads it lazily.
+ * @public
  */
 interface CssOptions {
   readonly modules?: boolean | {
@@ -318,7 +564,8 @@ interface CssOptions {
 /**
  * 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).
+ * build's value. `entry` is a subset of the package's entries (`entryName -> source path`).
+ * @public
  */
 interface EntryOverride {
   readonly entry: Record<string, string>;
@@ -340,6 +587,7 @@ interface EntryOverride {
    */
   readonly outSubdir?: string | undefined;
 }
+/** @public */
 interface BuildTargetGroupsOptions {
   readonly cwd: string;
   readonly version: string;
@@ -377,8 +625,8 @@ interface BuildTargetGroupsOptions {
   /**
    * Force-bundle (inline) these packages into the JS output (tsdown `deps.alwaysBundle`),
    * even declared deps that would otherwise be auto-externalized. The inverse of
-   * `externals`. JS pass only; `alwaysBundle` is allowed alongside our `skipNodeModulesBundle:
-   * false` (the throw only fires when skipNodeModulesBundle is true).
+   * `externals`. JS pass only; `alwaysBundle` is allowed alongside our
+   * `skipNodeModulesBundle: false` (the throw only fires when skipNodeModulesBundle is true).
    */
   readonly bundle?: ReadonlyArray<string> | undefined;
   /** Output formats to emit. Defaults to esm-only when unset. */
@@ -437,6 +685,10 @@ interface BuildTargetGroupsOptions {
   readonly exeRewrite?: ExeRewrite | undefined;
   /** Injectable for tests; defaults to tsdown's build. */
   readonly build?: TsdownBuild;
+  /** When set, muzzle tsdown (silent + customLogger) and capture metrics/timing into this collector. */
+  readonly collector?: BuildCollector | undefined;
+  /** Compute gzip sizes for emitted files (verbose render). Forwarded to the metrics plugin. */
+  readonly verbose?: boolean | undefined;
 }
 /**
  * Run tsdown.build() per TargetGroup. Composable so the escape hatch gets multi-group too.
@@ -452,6 +704,7 @@ interface BuildTargetGroupsOptions {
  * 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.
+ * @public
  */
 declare function buildTargetGroups(options: BuildTargetGroupsOptions): Promise<void>;
 //#endregion
@@ -472,6 +725,7 @@ declare function buildTargetGroups(options: BuildTargetGroupsOptions): Promise<v
  *
  * 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.
+ * @public
  */
 declare function cjsDefaultInterop(): Plugin;
 //#endregion
@@ -483,13 +737,15 @@ declare function cjsDefaultInterop(): Plugin;
  * 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):
  *
- *   // SOURCE (e.g. vfile's lib/minproc.js)
- *   export {default as minproc} from 'node:process'
- *   // ...consumed as minproc.cwd()
+ * ```ts
+ * // SOURCE (e.g. vfile's lib/minproc.js)
+ * export {default as minproc} from 'node:process'
+ * // ...consumed as minproc.cwd()
  *
- *   // rolldown CJS OUTPUT (BROKEN)
- *   let node_process = require("node:process");
- *   node_process.default.cwd()           // <- require("node:process").default is undefined
+ * // rolldown CJS OUTPUT (BROKEN)
+ * let node_process = require("node:process");
+ * node_process.default.cwd()           // <- require("node:process").default is undefined
+ * ```
  *
  * For a default import of an EXTERNAL Node builtin, rolldown emits a bare
  * `require("node:x")` WITHOUT its `__toESM` interop wrapper, yet still accesses
@@ -506,14 +762,18 @@ declare function cjsDefaultInterop(): Plugin;
  * layer, which is why the correction happens here on the source.
  *
  * Rewrites (the two static forms that occur in practice, anchored to statement start):
- *  - `import NAME from "node:x"`            -> `import * as NAME from "node:x"`
- *  - `export { default as NAME } from "node:x"` -> `export * as NAME from "node:x"`
- *  - `import NAME, { a, b } from "node:x"`  -> `import * as NAME from "node:x"; import { a, b } from "node:x"`
+ *
+ * ```ts
+ * import NAME from "node:x"            -> import * as NAME from "node:x"
+ * export { default as NAME } from "node:x" -> export * as NAME from "node:x"
+ * import NAME, { a, b } from "node:x"  -> import * as NAME from "node:x"; import { a, b } from "node:x"
+ * ```
  *
  * 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.
+ * @public
  */
 declare function nodeBuiltinDefaultInterop(): Plugin;
 //#endregion
@@ -531,6 +791,7 @@ declare function nodeBuiltinDefaultInterop(): Plugin;
  *
  * 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.
+ * @public
  */
 declare function removeDeclarationMaps(pkgDir: string): string[];
 //#endregion
@@ -548,6 +809,7 @@ declare function removeDeclarationMaps(pkgDir: string): string[];
  *
  * 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.
+ * @public
  */
 declare function syncPublicDir(sourceDir: string, targetDir: string): void;
 //#endregion
@@ -561,15 +823,20 @@ declare function syncPublicDir(sourceDir: string, targetDir: string): void;
  *
  * Rejects with `CatalogResolutionError` on an unresolvable reference, or
  * `CatalogAssemblyError` if the workspace catalog set cannot be assembled.
+ * @public
  */
 declare function resolveManifest(pkg: ManifestLike$1): Promise<ManifestLike$1>;
 //#endregion
 //#region src/changesets/next-versions.d.ts
-/** Result of resolving next release versions for a workspace. */
+/**
+ * Result of resolving next release versions for a workspace.
+ *
+ * @public
+ */
 interface NextVersions {
   /** Monorepo root containing `.changeset/` (or `cwd` when no workspace was found). */
   readonly root: string;
-  /** Canonical package name -> next release version (current version when unbumped). */
+  /** Canonical package name `->` next release version (current version when unbumped). */
   readonly versions: ReadonlyMap<string, string>;
 }
 /**
@@ -579,6 +846,7 @@ interface NextVersions {
  * 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).
+ * @public
  */
 declare function resolveNextVersions(cwd: string): Promise<NextVersions>;
 //#endregion
@@ -586,7 +854,11 @@ declare function resolveNextVersions(cwd: string): Promise<NextVersions>;
 declare const MetaGenerationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "MetaGenerationError";
 } & Readonly<A>;
-/** API Extractor meta generation failed for an entry. */
+/**
+ * API Extractor meta generation failed for an entry.
+ *
+ * @public
+ */
 declare class MetaGenerationError extends MetaGenerationError_base<{
   readonly entry: string;
   readonly reason: string;
@@ -596,7 +868,11 @@ declare class MetaGenerationError extends MetaGenerationError_base<{
 declare const ConfigValidationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "ConfigValidationError";
 } & Readonly<A>;
-/** A savvy.build.ts or publishConfig.targets config is structurally invalid; raised before any build work. */
+/**
+ * A savvy.build.ts or publishConfig.targets config is structurally invalid; raised before any build work.
+ *
+ * @public
+ */
 declare class ConfigValidationError extends ConfigValidationError_base<{
   readonly path: string;
   readonly reason: string;
@@ -605,26 +881,46 @@ declare class ConfigValidationError extends ConfigValidationError_base<{
 }
 //#endregion
 //#region src/exe/config.d.ts
-/** Default Node runtime embedded in the SEA (parity with the vitest-agent reference). */
+/**
+ * Default Node runtime embedded in the SEA (parity with the vitest-agent reference).
+ *
+ * @public
+ */
 declare const DEFAULT_EXE_NODE_VERSION = "25.9.0";
-/** A resolved per-platform SEA target. `platform` uses the tsdown/\@tsdown/exe token (win, not win32). */
+/**
+ * A resolved per-platform SEA target. `platform` uses the tsdown/\@tsdown/exe token (win, not win32).
+ *
+ * @public
+ */
 interface ExeTarget {
   readonly platform: "darwin" | "linux" | "win";
   readonly arch: "arm64" | "x64";
   readonly nodeVersion: string;
 }
-/** A target before nodeVersion defaulting (platform/arch only). */
+/**
+ * A target before nodeVersion defaulting (platform/arch only).
+ *
+ * @public
+ */
 interface ExeTargetInput {
   readonly platform: "darwin" | "linux" | "win";
   readonly arch: "arm64" | "x64";
 }
-/** SEA seaConfig overrides (subset; the rest are defaulted). */
+/**
+ * SEA seaConfig overrides (subset; the rest are defaulted).
+ *
+ * @public
+ */
 interface ExeSeaConfig {
   readonly disableExperimentalSEAWarning?: boolean | undefined;
   readonly useCodeCache?: boolean | undefined;
   readonly useSnapshot?: boolean | undefined;
 }
-/** One SEA binary to compile. */
+/**
+ * One SEA binary to compile.
+ *
+ * @public
+ */
 interface ExeConfig {
   /** Output binary basename (no extension/suffix). */
   readonly fileName: string;
@@ -637,7 +933,11 @@ interface ExeConfig {
   /** Explicit targets; default inferred from the package os/cpu. */
   readonly targets?: ReadonlyArray<ExeTargetInput> | undefined;
 }
-/** Fully-resolved SEA binary spec (no optionals). */
+/**
+ * Fully-resolved SEA binary spec (no optionals).
+ *
+ * @public
+ */
 interface NormalizedExe {
   readonly fileName: string;
   readonly entry: string;
@@ -648,7 +948,11 @@ interface NormalizedExe {
     readonly useSnapshot: boolean;
   };
 }
-/** The package's own os/cpu fields, used to infer a single platform target. */
+/**
+ * The package's own os/cpu fields, used to infer a single platform target.
+ *
+ * @public
+ */
 interface PkgOsCpu {
   readonly os: ReadonlyArray<string>;
   readonly cpu: ReadonlyArray<string>;
@@ -658,27 +962,44 @@ interface PkgOsCpu {
  *
  * Pure function; structural validation (missing fileName, empty targets) lives in the
  * config-validation layer.
+ * @public
  */
 declare function normalizeExeOptions(exe: ExeConfig | ReadonlyArray<ExeConfig>, pkg: PkgOsCpu): ReadonlyArray<NormalizedExe>;
 //#endregion
 //#region src/meta/config.d.ts
-/** A single TSDoc tag definition (parity with api-extractor's TSDoc config). */
+/**
+ * A single TSDoc tag definition (parity with api-extractor's TSDoc config).
+ *
+ * @public
+ */
 interface TsdocTagDefinition {
   readonly tagName: string;
   readonly syntaxKind: "block" | "inline" | "modifier";
   readonly allowMultiple?: boolean | undefined;
 }
-/** An api-extractor message-suppression rule. messageId is exact-matched; pattern (regex or substring) is AND-matched against the text. */
+/**
+ * An api-extractor message-suppression rule. messageId is exact-matched; pattern (regex or substring) is AND-matched against the text.
+ *
+ * @public
+ */
 interface WarningSuppressionRule {
   readonly messageId: string;
   readonly pattern?: string | undefined;
 }
-/** TSDoc / doc-warning configuration. suppressWarnings is doc functionality, so it lives here. */
+/**
+ * TSDoc / doc-warning configuration. suppressWarnings is doc functionality, so it lives here.
+ *
+ * @public
+ */
 interface TsdocOptions {
   readonly suppressWarnings?: ReadonlyArray<WarningSuppressionRule> | undefined;
   readonly tagDefinitions?: ReadonlyArray<TsdocTagDefinition> | undefined;
 }
-/** The `meta` field on defineBuild. Absent means no api-model generation. */
+/**
+ * The `meta` field on defineBuild. Absent means no api-model generation.
+ *
+ * @public
+ */
 interface MetaOptions {
   /** Directories to copy the canonical group's api-model into after `savvy build --target prod`. */
   readonly localPaths?: ReadonlyArray<string> | undefined;
@@ -690,7 +1011,11 @@ interface MetaOptions {
   readonly optimistic?: "auto" | boolean | undefined;
   readonly tsdoc?: TsdocOptions | undefined;
 }
-/** Fully-resolved meta options (no optionals). */
+/**
+ * Fully-resolved meta options (no optionals).
+ *
+ * @public
+ */
 interface NormalizedMeta {
   readonly localPaths: ReadonlyArray<string>;
   readonly optimistic: boolean;
@@ -699,14 +1024,22 @@ interface NormalizedMeta {
     readonly tagDefinitions: ReadonlyArray<TsdocTagDefinition>;
   };
 }
-/** Fill defaults so downstream code never branches on undefined. */
+/**
+ * Fill defaults so downstream code never branches on undefined.
+ *
+ * @public
+ */
 declare function normalizeMetaOptions(meta: MetaOptions, env?: {
   CI?: string | undefined;
   GITHUB_ACTIONS?: string | undefined;
 }): NormalizedMeta;
 //#endregion
 //#region src/targets/config.d.ts
-/** A single object-form publish target. Uses `from` XOR `name` (never both). */
+/**
+ * A single object-form publish target. Uses `from` XOR `name` (never both).
+ *
+ * @public
+ */
 interface PublishTargetObject {
   /** Registry endpoint. Required for custom keys; defaulted for `npm`/`github`. */
   readonly registry?: string | undefined;
@@ -715,11 +1048,23 @@ interface PublishTargetObject {
   /** Reuse another target's group bytes (deploy them to this registry). Mutually exclusive with `name`. */
   readonly from?: string | undefined;
 }
-/** A `publishConfig.targets` value: `true` (well-known registry, base name), a string (name override), or an object. */
+/**
+ * A `publishConfig.targets` value: `true` (well-known registry, base name), a string (name override), or an object.
+ *
+ * @public
+ */
 type PublishTargetValue = true | string | PublishTargetObject;
-/** The `publishConfig.targets` map, keyed by target id (`npm`, `github`, or a custom key). */
+/**
+ * The `publishConfig.targets` map, keyed by target id (`npm`, `github`, or a custom key).
+ *
+ * @public
+ */
 type PublishTargets = Record<string, PublishTargetValue>;
-/** A distinct byte-variant build group (one per distinct resolved name). */
+/**
+ * A distinct byte-variant build group (one per distinct resolved name).
+ *
+ * @public
+ */
 interface ResolvedGroup {
   /** Folder id; the group's output dir nests this id under dist/prod, with a pkg subfolder. */
   readonly id: string;
@@ -728,7 +1073,11 @@ interface ResolvedGroup {
   /** The group's pkg output dir, relative to the package root. */
   readonly dir: string;
 }
-/** A resolved registry target (one per `publishConfig.targets` key). */
+/**
+ * A resolved registry target (one per `publishConfig.targets` key).
+ *
+ * @public
+ */
 interface ResolvedTarget {
   /** The `publishConfig.targets` key. */
   readonly id: string;
@@ -739,16 +1088,28 @@ interface ResolvedTarget {
   /** The resolved registry endpoint. */
   readonly registry: string;
 }
-/** The full resolution of `publishConfig.targets`: the distinct groups to build, and every target bound to one. */
+/**
+ * The full resolution of `publishConfig.targets`: the distinct groups to build, and every target bound to one.
+ *
+ * @public
+ */
 interface TargetResolution {
   readonly groups: ReadonlyArray<ResolvedGroup>;
   readonly targets: ReadonlyArray<ResolvedTarget>;
 }
-/** True when a target value is the object form (carries registry/name/from). */
+/**
+ * True when a target value is the object form (carries registry/name/from).
+ *
+ * @public
+ */
 declare function isTargetObject(value: PublishTargetValue): value is PublishTargetObject;
 //#endregion
 //#region src/config-validation/ConfigValidator.d.ts
-/** The normalized facts the validator checks, assembled by the bundler before any build work. */
+/**
+ * The normalized facts the validator checks, assembled by the bundler before any build work.
+ *
+ * @public
+ */
 interface ValidationInput {
   readonly baseName: string;
   /** Whether the package declares an exports map (for the model-without-exports cross-field rule). */
@@ -766,14 +1127,23 @@ interface ValidationInput {
 declare const ConfigValidator_base: Context.TagClass<ConfigValidator, "@savvy-web/tsdown-plugins/ConfigValidator", {
   readonly validate: (input: ValidationInput) => Effect.Effect<void, ConfigValidationError>;
 }>;
-/** Fast-fail config validator; runs first in the bundler over the resolved config. */
+/**
+ * Fast-fail config validator; runs first in the bundler over the resolved config.
+ *
+ * @public
+ */
 declare class ConfigValidator extends ConfigValidator_base {}
 //#endregion
 //#region src/config-validation/ConfigValidatorLive.d.ts
-/** Live ConfigValidator: wraps the synchronous rule set, surfacing ConfigValidationError as a typed Effect failure. */
+/**
+ * Live ConfigValidator: wraps the synchronous rule set, surfacing ConfigValidationError as a typed Effect failure.
+ *
+ * @public
+ */
 declare const ConfigValidatorLive: Layer.Layer<ConfigValidator, never, never>;
 //#endregion
 //#region src/dts/resolved-tsconfig.d.ts
+/** @public */
 interface ResolvedTsconfigOptions {
   /** Absolute package root. */
   readonly cwd: string;
@@ -784,26 +1154,38 @@ interface ResolvedTsconfigOptions {
   /** TS `compilerOptions.jsxImportSource` to forward (e.g. "react"). */
   readonly jsxImportSource?: string | undefined;
 }
+/** @public */
 interface ResolvedTsconfig {
   readonly compilerOptions: Record<string, unknown>;
   readonly include: ReadonlyArray<string>;
   readonly exclude: ReadonlyArray<string>;
 }
-/** Build the portable absolute-path tsconfig object (ported from rslib writeBundleTempConfig). */
+/**
+ * Build the portable absolute-path tsconfig object (ported from rslib writeBundleTempConfig).
+ *
+ * @public
+ */
 declare function buildResolvedTsconfig(options: ResolvedTsconfigOptions): ResolvedTsconfig;
-/** Write the resolved tsconfig to a temp file and return its absolute path. */
+/**
+ * Write the resolved tsconfig to a temp file and return its absolute path.
+ *
+ * @public
+ */
 declare function writeResolvedTsconfig(options: ResolvedTsconfigOptions): string;
 //#endregion
 //#region src/entry/extract.d.ts
+/** @public */
 interface PackageJsonLike {
   readonly exports?: unknown;
   readonly bin?: unknown;
 }
+/** @public */
 interface ExtractOptions {
   readonly exportsAsIndexes?: boolean | undefined;
   /** Source paths to NOT turn into JS build entries (e.g. an exe entry compiled as a SEA). */
   readonly excludeSources?: ReadonlyArray<string> | undefined;
 }
+/** @public */
 interface ExtractResult {
   /** entry name to TS source path */
   readonly entries: Record<string, string>;
@@ -821,22 +1203,36 @@ interface ExtractResult {
  * @internal
  */
 declare const createEntryName: (exportKey: string, exportsAsIndexes: boolean) => string;
+/** @public */
 declare function extractEntries(pkg: PackageJsonLike, options?: ExtractOptions): ExtractResult;
 //#endregion
 //#region src/entry/package-json-entries.d.ts
+/** @public */
 interface PackageJsonEntriesOptions extends ExtractOptions {
   /** In-memory package.json. If omitted, reads `<cwd>/package.json`. */
   readonly pkg?: PackageJsonLike;
   /** Working directory for reading package.json. Defaults to process.cwd(). */
   readonly cwd?: string;
 }
-/** Derive a tsdown `entry` record (name to source path) from a package.json. */
+/**
+ * Derive a tsdown `entry` record (name to source path) from a package.json.
+ *
+ * @public
+ */
 declare function packageJsonEntries(options?: PackageJsonEntriesOptions): Record<string, string>;
 //#endregion
 //#region src/exe/build.d.ts
-/** A minimal structural type for tsdown's build, kept loose so this package keeps no tsdown runtime dep (interface-only). */
+/**
+ * A minimal structural type for tsdown's build, kept loose so this package keeps no tsdown runtime dep (interface-only).
+ *
+ * @public
+ */
 type ExeBuild = (config: unknown) => Promise<unknown>;
-/** Options for compiling SEA binaries. */
+/**
+ * Options for compiling SEA binaries.
+ *
+ * @public
+ */
 interface RunExeBuildOptions {
   readonly cwd: string;
   /** Directory the binaries are emitted into (e.g. dist/dev/pkg/bin). */
@@ -845,19 +1241,31 @@ interface RunExeBuildOptions {
   readonly specs: ReadonlyArray<NormalizedExe>;
   /** Injectable tsdown build (defaults to tsdown's build function). */
   readonly build?: ExeBuild | undefined;
+  /** When set with groupId, muzzle tsdown and record an "exe" pass into this collector. */
+  readonly collector?: BuildCollector | undefined;
+  /** Target-group id the exe pass belongs to (required to record into the collector). */
+  readonly groupId?: string | undefined;
+  /** Compute gzip sizes (verbose render). */
+  readonly verbose?: boolean | undefined;
 }
-/** Compile each SEA binary via tsdown's exe mode. One tsdown build per spec. */
-declare function runExeBuild(options: RunExeBuildOptions): Promise<void>;
-//#endregion
+/**
+ * Compile each SEA binary via tsdown's exe mode. One tsdown build per spec.
+ *
+ * @public
+ */
+declare function runExeBuild(options: RunExeBuildOptions): Promise<void>;
+//#endregion
 //#region src/exe/filename.d.ts
 /**
  * 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.
+ * @public
  */
 declare function computeExeFileName(fileName: string, target: ExeTarget): string;
 //#endregion
 //#region src/meta/generate.d.ts
+/** @public */
 interface GenerateMetaOptions {
   readonly cwd: string;
   readonly packageName: string;
@@ -880,7 +1288,14 @@ interface GenerateMetaOptions {
    * rewrite. When omitted, the package.json is copied verbatim.
    */
   readonly manifestTransform?: ((pkg: Record<string, unknown>) => Record<string, unknown>) | undefined;
-}
+  /** When set, API Extractor warnings/errors are routed here (and suppressed from console). */
+  readonly onMessage?: ((entry: DiagnosticInput) => void) | undefined;
+  /** When true (CI), forgotten exports become a hard build error. */
+  readonly ci?: boolean | undefined;
+  /** When set, messages matched by `suppressWarnings` are routed here for accounting. */
+  readonly onSuppressed?: ((entry: DiagnosticInput) => void) | undefined;
+}
+/** @public */
 interface MetaResult {
   readonly apiJsonPath: string;
   readonly apiJsonFilename: string;
@@ -891,6 +1306,7 @@ interface MetaResult {
  * 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.
+ * @public
  */
 declare function generateMeta(options: GenerateMetaOptions): Promise<MetaResult>;
 //#endregion
@@ -900,9 +1316,62 @@ declare function generateMeta(options: GenerateMetaOptions): Promise<MetaResult>
  * 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.
+ * @public
  */
 declare function rewriteMetaVersions(pkg: Record<string, unknown>, versions: ReadonlyMap<string, string>, selfName: string): Record<string, unknown>;
 //#endregion
+//#region src/meta/run-pass.d.ts
+/**
+ * Options for the meta-pass orchestrator.
+ *
+ * @public
+ */
+interface RunMetaPassOptions {
+  readonly cwd: string;
+  readonly packageName: string;
+  readonly tsconfigPath: string;
+  readonly groups: ReadonlyArray<{
+    id: string;
+    name: string;
+  }>;
+  readonly entries: Record<string, string>;
+  readonly exportsMap: Record<string, string> | undefined;
+  readonly overrides?: ReadonlyArray<{
+    entries: ReadonlyArray<string>;
+    outSubdir?: string | undefined;
+  }> | undefined;
+  readonly meta: MetaOptions;
+  readonly collector: BuildCollector;
+  readonly ci: boolean;
+  /** Injectable for tests; defaults to the real generateMeta. */
+  readonly generateMeta?: (o: GenerateMetaOptions) => Promise<MetaResult>;
+  /** Injectable for tests; defaults to the real resolveNextVersions. Only called when optimistic. */
+  readonly resolveNextVersions?: (cwd: string) => Promise<{
+    versions: ReadonlyMap<string, string>;
+  }>;
+}
+/**
+ * Meta-pass orchestrator: derives export paths, filters bin/ entries, resolves optimistic
+ * next-versions, and calls generateMeta once per publish group.
+ * @public
+ */
+declare function runMetaPass(o: RunMetaPassOptions): Promise<void>;
+/**
+ * Map entry names to export paths using the package exports map. index maps to ".".
+ *
+ * @public
+ */
+declare function deriveExportPaths(entries: Record<string, string>, exportsMap: Record<string, string> | undefined): Record<string, string>;
+/**
+ * For each `outSubdir` override, point its meta entry at the isolated sub-package barrel.
+ *
+ * @public
+ */
+declare function applySubdirMetaEntries(overrides: ReadonlyArray<{
+  entries: ReadonlyArray<string>;
+  outSubdir?: string | undefined;
+}> | undefined, dtsBasenames: Record<string, string>, exportPaths: Record<string, string>): void;
+//#endregion
 //#region src/meta/tsconfig-resolver.d.ts
 /**
  * Compiler options with enum values converted to their string equivalents.
@@ -962,17 +1431,17 @@ declare class TsconfigResolver {
   private static readonly MODULE_DETECTION_MAP;
   /** @internal */
   private static readonly NEW_LINE_MAP;
-  /** Converts a {@link ScriptTarget} enum value to its string form (e.g. `es2023`). */
+  /** Converts a `ScriptTarget` enum value to its string form (e.g. `es2023`). */
   static convertScriptTarget(target: ScriptTarget | undefined): string | undefined;
-  /** Converts a {@link ModuleKind} enum value to its string form (e.g. `nodenext`). */
+  /** Converts a `ModuleKind` enum value to its string form (e.g. `nodenext`). */
   static convertModuleKind(module: ModuleKind | undefined): string | undefined;
-  /** Converts a {@link ModuleResolutionKind} enum value to its string form (e.g. `nodenext`). */
+  /** Converts a `ModuleResolutionKind` enum value to its string form (e.g. `nodenext`). */
   static convertModuleResolution(resolution: ModuleResolutionKind | undefined): string | undefined;
-  /** Converts a {@link JsxEmit} enum value to its string form (e.g. `preserve`, `react-jsx`). */
+  /** Converts a `JsxEmit` enum value to its string form (e.g. `preserve`, `react-jsx`). */
   static convertJsxEmit(jsx: JsxEmit | undefined): string | undefined;
-  /** Converts a {@link ModuleDetectionKind} enum value to its string form (e.g. `force`). */
+  /** Converts a `ModuleDetectionKind` enum value to its string form (e.g. `force`). */
   static convertModuleDetection(detection: ModuleDetectionKind | undefined): string | undefined;
-  /** Converts a {@link NewLineKind} enum value to its string form (`lf` or `crlf`). */
+  /** Converts a `NewLineKind` enum value to its string form (`lf` or `crlf`). */
   static convertNewLine(newLine: NewLineKind | undefined): string | undefined;
   /**
    * Converts a lib reference to its canonical short name.
@@ -1012,615 +1481,232 @@ declare class TsconfigResolver {
  */
 declare function resolvePortableTsconfig(cwd: string, fallbackConfigPath?: string): PortableTsconfig;
 //#endregion
-//#region src/report/schema.d.ts
-declare const ReportTimings: Schema.Struct<{
-  totalMs: typeof Schema.Number;
-}>;
-declare const TargetGroupReport: Schema.Struct<{
-  id: typeof Schema.String;
-  entries: Schema.Array$<typeof Schema.String>;
-  emittedFiles: Schema.Array$<typeof Schema.String>;
-  timings: Schema.Struct<{
-    totalMs: typeof Schema.Number;
-  }>;
-  warnings: Schema.Array$<typeof Schema.String>;
-  errors: Schema.Array$<typeof Schema.String>;
-}>;
-declare const BuildReport: Schema.Struct<{
-  package: typeof Schema.String;
-  targetGroups: Schema.Array$<Schema.Struct<{
-    id: typeof Schema.String;
-    entries: Schema.Array$<typeof Schema.String>;
-    emittedFiles: Schema.Array$<typeof Schema.String>;
-    timings: Schema.Struct<{
-      totalMs: typeof Schema.Number;
-    }>;
-    warnings: Schema.Array$<typeof Schema.String>;
-    errors: Schema.Array$<typeof Schema.String>;
-  }>>;
-}>;
-type BuildReport = typeof BuildReport.Type;
-type TargetGroupReport = typeof TargetGroupReport.Type;
-//#endregion
 //#region src/report/formatters/types.d.ts
+/** @public */
 interface RenderedOutput {
   readonly target: "stdout" | "file" | "github-summary";
   readonly content: string;
   readonly contentType: string;
 }
+/** @public */
 interface FormatterContext {
   readonly noColor: boolean;
+  readonly verbose: boolean;
 }
+/** @public */
 interface Formatter {
   readonly format: string;
   readonly render: (reports: ReadonlyArray<BuildReport>, ctx: FormatterContext) => ReadonlyArray<RenderedOutput>;
 }
 //#endregion
 //#region src/report/formatters/ci-annotations.d.ts
+/** @public */
 declare const CiAnnotationsFormatter: Formatter;
 //#endregion
 //#region src/report/formatters/json.d.ts
+/** @public */
 declare const JsonFormatter: Formatter;
 //#endregion
 //#region src/report/formatters/markdown.d.ts
+/** @public */
 declare const MarkdownFormatter: Formatter;
 //#endregion
 //#region src/report/formatters/silent.d.ts
+/** @public */
 declare const SilentFormatter: Formatter;
 //#endregion
 //#region src/report/formatters/terminal.d.ts
+/** @public */
 declare const TerminalFormatter: Formatter;
 //#endregion
+//#region src/report/issues-artifact.d.ts
+/**
+ * A diagnostic flattened to a plain JSON object (only defined fields are present).
+ *
+ * @public
+ */
+interface PlainDiagnostic {
+  source: DiagnosticEntry["source"];
+  level: DiagnosticEntry["level"];
+  text: string;
+  code?: string;
+  ciFatal?: boolean;
+  file?: string;
+  line?: number;
+  column?: number;
+}
+/**
+ * The aggregated build-issues artifact written to `dist/<target>/issues.json`.
+ *
+ * @public
+ */
+interface BuildIssues {
+  generatedAt: string;
+  package: string;
+  target: "dev" | "prod";
+  warnings: PlainDiagnostic[];
+  errors: PlainDiagnostic[];
+  suppressed: PlainDiagnostic[];
+}
+/**
+ * Flatten a build snapshot into the aggregated, de-duplicated issues artifact. Pure.
+ *
+ * @public
+ */
+declare function flattenIssues(reports: ReadonlyArray<BuildReport>, opts: {
+  target: "dev" | "prod";
+  generatedAt: string;
+}): BuildIssues;
+/**
+ * Serialize the issues artifact to pretty JSON with a trailing newline.
+ *
+ * @public
+ */
+declare function serializeIssues(issues: BuildIssues): string;
+/**
+ * Write the aggregated issues artifact to `<cwd>/dist/<target>/issues.json`. Returns the path written.
+ *
+ * @public
+ */
+declare function writeIssuesArtifact(opts: {
+  cwd: string;
+  target: "dev" | "prod";
+  reports: ReadonlyArray<BuildReport>;
+  now?: () => Date;
+}): string;
+//#endregion
 //#region src/report/services/EnvironmentDetector.d.ts
+/** @public */
 type Environment = "agent-shell" | "terminal" | "ci-github" | "ci-generic";
 declare const EnvironmentDetector_base: Context.TagClass<EnvironmentDetector, "@savvy-web/tsdown-plugins/EnvironmentDetector", {
   readonly detect: () => Effect.Effect<Environment>;
 }>;
+/** @public */
 declare class EnvironmentDetector extends EnvironmentDetector_base {}
 //#endregion
 //#region src/report/layers/EnvironmentDetectorLive.d.ts
+/** @public */
 declare const EnvironmentDetectorLive: Layer.Layer<EnvironmentDetector, never, never>;
 //#endregion
 //#region src/report/services/ExecutorResolver.d.ts
+/** @public */
 type Executor = "human" | "agent" | "ci";
 declare const ExecutorResolver_base: Context.TagClass<ExecutorResolver, "@savvy-web/tsdown-plugins/ExecutorResolver", {
   readonly resolve: (env: Environment) => Effect.Effect<Executor>;
 }>;
+/** @public */
 declare class ExecutorResolver extends ExecutorResolver_base {}
 //#endregion
 //#region src/report/layers/ExecutorResolverLive.d.ts
+/** @public */
 declare const ExecutorResolverLive: Layer.Layer<ExecutorResolver, never, never>;
 //#endregion
 //#region src/report/services/FormatSelector.d.ts
+/** @public */
 type OutputFormat = "terminal" | "json" | "markdown" | "ci-annotations" | "silent";
 declare const FormatSelector_base: Context.TagClass<FormatSelector, "@savvy-web/tsdown-plugins/FormatSelector", {
   readonly select: (executor: Executor, explicit?: OutputFormat, env?: Environment) => Effect.Effect<OutputFormat>;
 }>;
+/** @public */
 declare class FormatSelector extends FormatSelector_base {}
 //#endregion
 //#region src/report/layers/FormatSelectorLive.d.ts
+/** @public */
 declare const FormatSelectorLive: Layer.Layer<FormatSelector, never, never>;
 //#endregion
 //#region src/report/services/OutputRenderer.d.ts
 declare const OutputRenderer_base: Context.TagClass<OutputRenderer, "@savvy-web/tsdown-plugins/OutputRenderer", {
   readonly render: (reports: ReadonlyArray<BuildReport>, format: OutputFormat, ctx: FormatterContext) => Effect.Effect<ReadonlyArray<RenderedOutput>>;
 }>;
+/** @public */
 declare class OutputRenderer extends OutputRenderer_base {}
 //#endregion
 //#region src/report/layers/OutputRendererLive.d.ts
+/** @public */
 declare const OutputRendererLive: Layer.Layer<OutputRenderer, never, never>;
 //#endregion
+//#region src/report/metrics-plugin.d.ts
+/**
+ * Rolldown plugin that records emitted-file metrics into the BuildCollector via writeBundle (which
+ * fires for the JS pass AND the emitDtsOnly dts pass — verified against tsdown 0.22.3), plus a
+ * defensive onLog for rolldown-level diagnostics that bypass tsdown's logger. Append it to each
+ * build pass's `plugins` array. `bytes` is taken from the in-memory chunk/asset content (no fs);
+ * `gzip` is computed only when `verbose`.
+ * @public
+ */
+declare function buildMetricsPlugin(collector: BuildCollector, groupId: string, pass: PassKind, verbose: boolean): Plugin;
+//#endregion
 //#region src/report/pipeline.d.ts
+/** @public */
 declare const ReportPipelineLive: Layer.Layer<EnvironmentDetector | ExecutorResolver | FormatSelector | OutputRenderer, never, never>;
+/** @public */
 interface RenderReportOptions {
   readonly explicitFormat?: OutputFormat;
   /** Override env detection (mainly for tests). */
   readonly env?: Environment;
   readonly noColor: boolean;
+  readonly verbose?: boolean;
 }
+/** @public */
 declare const renderReport: (reports: ReadonlyArray<BuildReport>, options: RenderReportOptions) => Effect.Effect<ReadonlyArray<RenderedOutput>, never, EnvironmentDetector | ExecutorResolver | FormatSelector | OutputRenderer>;
 //#endregion
-//#region ../../node_modules/.pnpm/@effect+platform@0.96.1_effect@3.21.3/node_modules/@effect/platform/dist/dts/Error.d.ts
-/**
- * @since 1.0.0
- * @category type id
- */
-declare const TypeId: unique symbol;
-/**
- * @since 1.0.0
- * @category type id
- */
-type TypeId = typeof TypeId;
-declare const BadArgument_base: Schema$1.TaggedErrorClass<BadArgument, "BadArgument", {
-  readonly _tag: Schema$1.tag<"BadArgument">;
-} & {
-  module: Schema$1.Literal<["Clipboard", "Command", "FileSystem", "KeyValueStore", "Path", "Stream", "Terminal"]>;
-  method: typeof Schema$1.String;
-  description: Schema$1.optional<typeof Schema$1.String>;
-  cause: Schema$1.optional<typeof Schema$1.Defect>;
-}>;
-/**
- * @since 1.0.0
- * @category Models
- */
-declare class BadArgument extends BadArgument_base {
-  /**
-   * @since 1.0.0
-   */
-  readonly [TypeId]: typeof TypeId;
-  /**
-   * @since 1.0.0
-   */
-  get message(): string;
-}
-declare const SystemError_base: Schema$1.TaggedErrorClass<SystemError, "SystemError", {
-  readonly _tag: Schema$1.tag<"SystemError">;
-} & {
-  reason: Schema$1.Literal<["AlreadyExists", "BadResource", "Busy", "InvalidData", "NotFound", "PermissionDenied", "TimedOut", "UnexpectedEof", "Unknown", "WouldBlock", "WriteZero"]>;
-  module: Schema$1.Literal<["Clipboard", "Command", "FileSystem", "KeyValueStore", "Path", "Stream", "Terminal"]>;
-  method: typeof Schema$1.String;
-  description: Schema$1.optional<typeof Schema$1.String>;
-  syscall: Schema$1.optional<typeof Schema$1.String>;
-  pathOrDescriptor: Schema$1.optional<Schema$1.Union<[typeof Schema$1.String, typeof Schema$1.Number]>>;
-  cause: Schema$1.optional<typeof Schema$1.Defect>;
-}>;
-/**
- * @since 1.0.0
- * @category models
- */
-declare class SystemError extends SystemError_base {
-  /**
-   * @since 1.0.0
-   */
-  readonly [TypeId]: typeof TypeId;
-  /**
-   * @since 1.0.0
-   */
-  get message(): string;
-}
-/**
- * @since 1.0.0
- * @category Models
- */
-type PlatformError = BadArgument | SystemError;
-/**
- * @since 1.0.0
- * @category Models
- */
-declare const PlatformError: Schema$1.Union<[typeof BadArgument, typeof SystemError]>;
-//#endregion
-//#region ../../node_modules/.pnpm/@effect+platform@0.96.1_effect@3.21.3/node_modules/@effect/platform/dist/dts/FileSystem.d.ts
-/**
- * @since 1.0.0
- * @category model
- */
-interface FileSystem {
-  /**
-   * Check if a file can be accessed.
-   * You can optionally specify the level of access to check for.
-   */
-  readonly access: (path: string, options?: AccessFileOptions) => Effect$1.Effect<void, PlatformError>;
-  /**
-   * Copy a file or directory from `fromPath` to `toPath`.
-   *
-   * Equivalent to `cp -r`.
-   */
-  readonly copy: (fromPath: string, toPath: string, options?: CopyOptions) => Effect$1.Effect<void, PlatformError>;
-  /**
-   * Copy a file from `fromPath` to `toPath`.
-   */
-  readonly copyFile: (fromPath: string, toPath: string) => Effect$1.Effect<void, PlatformError>;
-  /**
-   * Change the permissions of a file.
-   */
-  readonly chmod: (path: string, mode: number) => Effect$1.Effect<void, PlatformError>;
-  /**
-   * Change the owner and group of a file.
-   */
-  readonly chown: (path: string, uid: number, gid: number) => Effect$1.Effect<void, PlatformError>;
-  /**
-   * Check if a path exists.
-   */
-  readonly exists: (path: string) => Effect$1.Effect<boolean, PlatformError>;
-  /**
-   * Create a hard link from `fromPath` to `toPath`.
-   */
-  readonly link: (fromPath: string, toPath: string) => Effect$1.Effect<void, PlatformError>;
-  /**
-   * Create a directory at `path`. You can optionally specify the mode and
-   * whether to recursively create nested directories.
-   */
-  readonly makeDirectory: (path: string, options?: MakeDirectoryOptions) => Effect$1.Effect<void, PlatformError>;
-  /**
-   * Create a temporary directory.
-   *
-   * By default the directory will be created inside the system's default
-   * temporary directory, but you can specify a different location by setting
-   * the `directory` option.
-   *
-   * You can also specify a prefix for the directory name by setting the
-   * `prefix` option.
-   */
-  readonly makeTempDirectory: (options?: MakeTempDirectoryOptions) => Effect$1.Effect<string, PlatformError>;
-  /**
-   * Create a temporary directory inside a scope.
-   *
-   * Functionally equivalent to `makeTempDirectory`, but the directory will be
-   * automatically deleted when the scope is closed.
-   */
-  readonly makeTempDirectoryScoped: (options?: MakeTempDirectoryOptions) => Effect$1.Effect<string, PlatformError, Scope>;
-  /**
-   * Create a temporary file.
-   * The directory creation is functionally equivalent to `makeTempDirectory`.
-   * The file name will be a randomly generated string.
-   */
-  readonly makeTempFile: (options?: MakeTempFileOptions) => Effect$1.Effect<string, PlatformError>;
-  /**
-   * Create a temporary file inside a scope.
-   *
-   * Functionally equivalent to `makeTempFile`, but the file will be
-   * automatically deleted when the scope is closed.
-   */
-  readonly makeTempFileScoped: (options?: MakeTempFileOptions) => Effect$1.Effect<string, PlatformError, Scope>;
-  /**
-   * Open a file at `path` with the specified `options`.
-   *
-   * The file handle will be automatically closed when the scope is closed.
-   */
-  readonly open: (path: string, options?: OpenFileOptions) => Effect$1.Effect<File$1, PlatformError, Scope>;
-  /**
-   * List the contents of a directory.
-   *
-   * You can recursively list the contents of nested directories by setting the
-   * `recursive` option.
-   */
-  readonly readDirectory: (path: string, options?: ReadDirectoryOptions) => Effect$1.Effect<Array<string>, PlatformError>;
-  /**
-   * Read the contents of a file.
-   */
-  readonly readFile: (path: string) => Effect$1.Effect<Uint8Array, PlatformError>;
-  /**
-   * Read the contents of a file.
-   */
-  readonly readFileString: (path: string, encoding?: string) => Effect$1.Effect<string, PlatformError>;
-  /**
-   * Read the destination of a symbolic link.
-   */
-  readonly readLink: (path: string) => Effect$1.Effect<string, PlatformError>;
-  /**
-   * Resolve a path to its canonicalized absolute pathname.
-   */
-  readonly realPath: (path: string) => Effect$1.Effect<string, PlatformError>;
-  /**
-   * Remove a file or directory.
-   */
-  readonly remove: (path: string, options?: RemoveOptions) => Effect$1.Effect<void, PlatformError>;
-  /**
-   * Rename a file or directory.
-   */
-  readonly rename: (oldPath: string, newPath: string) => Effect$1.Effect<void, PlatformError>;
-  /**
-   * Create a writable `Sink` for the specified `path`.
-   */
-  readonly sink: (path: string, options?: SinkOptions) => Sink<void, Uint8Array, never, PlatformError>;
-  /**
-   * Get information about a file at `path`.
-   */
-  readonly stat: (path: string) => Effect$1.Effect<File$1.Info, PlatformError>;
-  /**
-   * Create a readable `Stream` for the specified `path`.
-   *
-   * Changing the `bufferSize` option will change the internal buffer size of
-   * the stream. It defaults to `4`.
-   *
-   * The `chunkSize` option will change the size of the chunks emitted by the
-   * stream. It defaults to 64kb.
-   *
-   * Changing `offset` and `bytesToRead` will change the offset and the number
-   * of bytes to read from the file.
-   */
-  readonly stream: (path: string, options?: StreamOptions) => Stream<Uint8Array, PlatformError>;
-  /**
-   * Create a symbolic link from `fromPath` to `toPath`.
-   */
-  readonly symlink: (fromPath: string, toPath: string) => Effect$1.Effect<void, PlatformError>;
-  /**
-   * Truncate a file to a specified length. If the `length` is not specified,
-   * the file will be truncated to length `0`.
-   */
-  readonly truncate: (path: string, length?: SizeInput) => Effect$1.Effect<void, PlatformError>;
-  /**
-   * Change the file system timestamps of the file at `path`.
-   */
-  readonly utimes: (path: string, atime: Date | number, mtime: Date | number) => Effect$1.Effect<void, PlatformError>;
-  /**
-   * Watch a directory or file for changes.
-   *
-   * By default, only changes to the direct children of the directory are reported.
-   * Set the `recursive` option to `true` to watch for changes in subdirectories as well.
-   *
-   * Note: The `recursive` option behavior depends on the backend implementation:
-   * - When using the default Node.js `fs.watch()` backend: The `recursive`
-   *   option is supported on all platforms (Node.js v20+).
-   * - When using `@parcel/watcher` (via `NodeFileSystem/ParcelWatcher` layer):
-   *   Watching is always recursive on all platforms. This option is ignored.
-   */
-  readonly watch: (path: string, options?: WatchOptions) => Stream<WatchEvent, PlatformError>;
-  /**
-   * Write data to a file at `path`.
-   */
-  readonly writeFile: (path: string, data: Uint8Array, options?: WriteFileOptions) => Effect$1.Effect<void, PlatformError>;
-  /**
-   * Write a string to a file at `path`.
-   */
-  readonly writeFileString: (path: string, data: string, options?: WriteFileStringOptions) => Effect$1.Effect<void, PlatformError>;
+//#region src/report/timer.d.ts
+/** @public */
+declare function formatTime(ms: number): string;
+/** @public */
+interface Timer {
+  readonly elapsed: () => number;
+  readonly format: () => string;
 }
 /**
- * Represents a size in bytes.
+ * Create a wall-clock timer. (Date.now is fine in runtime build code.)
  *
- * @since 1.0.0
- * @category sizes
+ * @public
  */
-type Size = Brand.Branded<bigint, "Size">;
+declare function createTimer(now?: () => number): Timer;
+//#endregion
+//#region src/report/tsdown-logger.d.ts
 /**
- * Represents a size in bytes.
+ * Structural match for tsdown's Logger interface (tsdown 0.22.x).
  *
- * @since 1.0.0
- * @category sizes
- */
-type SizeInput = bigint | number | Size;
-/**
- * @since 1.0.0
- * @category sizes
- */
-declare const Size: (bytes: SizeInput) => Size;
-/**
- * @since 1.0.0
- * @category model
- */
-type OpenFlag = "r" | "r+" | "w" | "wx" | "w+" | "wx+" | "a" | "ax" | "a+" | "ax+";
-/**
- * @since 1.0.0
- * @category options
- */
-interface AccessFileOptions {
-  readonly ok?: boolean;
-  readonly readable?: boolean;
-  readonly writable?: boolean;
-}
-/**
- * @since 1.0.0
- * @category options
- */
-interface MakeDirectoryOptions {
-  readonly recursive?: boolean;
-  readonly mode?: number;
-}
-/**
- * @since 1.0.0
- * @category options
- */
-interface CopyOptions {
-  readonly overwrite?: boolean;
-  readonly preserveTimestamps?: boolean;
-}
-/**
- * @since 1.0.0
- * @category options
- */
-interface MakeTempDirectoryOptions {
-  readonly directory?: string;
-  readonly prefix?: string;
-}
-/**
- * @since 1.0.0
- * @category options
- */
-interface MakeTempFileOptions {
-  readonly directory?: string;
-  readonly prefix?: string;
-  readonly suffix?: string;
-}
-/**
- * @since 1.0.0
- * @category options
- */
-interface OpenFileOptions {
-  readonly flag?: OpenFlag;
-  readonly mode?: number;
-}
-/**
- * @since 1.0.0
- * @category options
- */
-interface ReadDirectoryOptions {
-  readonly recursive?: boolean;
-}
-/**
- * @since 1.0.0
- * @category options
- */
-interface RemoveOptions {
-  /**
-   * When `true`, you can recursively remove nested directories.
-   */
-  readonly recursive?: boolean;
-  /**
-   * When `true`, exceptions will be ignored if `path` does not exist.
-   */
-  readonly force?: boolean;
-}
-/**
- * @since 1.0.0
- * @category options
- */
-interface SinkOptions extends OpenFileOptions {}
-/**
- * @since 1.0.0
- * @category options
- */
-interface StreamOptions {
-  readonly bufferSize?: number;
-  readonly bytesToRead?: SizeInput;
-  readonly chunkSize?: SizeInput;
-  readonly offset?: SizeInput;
-}
-/**
- * @since 1.0.0
- * @category options
- */
-interface WriteFileOptions {
-  readonly flag?: OpenFlag;
-  readonly mode?: number;
-}
-/**
- * @since 1.0.0
- * @category options
- */
-interface WriteFileStringOptions {
-  readonly flag?: OpenFlag;
-  readonly mode?: number;
-}
-/**
- * @since 1.0.0
- * @category options
- */
-interface WatchOptions {
-  /**
-   * When `true`, the watcher will also watch for changes in subdirectories.
-   */
-  readonly recursive?: boolean;
-}
-/**
- * @since 1.0.0
- * @category tag
- */
-declare const FileSystem: Tag<FileSystem, FileSystem>;
-/**
- * @since 1.0.0
- * @category type id
- */
-declare const FileTypeId: unique symbol;
-/**
- * @since 1.0.0
- * @category type id
- */
-type FileTypeId = typeof FileTypeId;
-/**
- * @since 1.0.0
- * @category model
- */
-interface File$1 {
-  readonly [FileTypeId]: FileTypeId;
-  readonly fd: File$1.Descriptor;
-  readonly stat: Effect$1.Effect<File$1.Info, PlatformError>;
-  readonly seek: (offset: SizeInput, from: SeekMode) => Effect$1.Effect<void>;
-  readonly sync: Effect$1.Effect<void, PlatformError>;
-  readonly read: (buffer: Uint8Array) => Effect$1.Effect<Size, PlatformError>;
-  readonly readAlloc: (size: SizeInput) => Effect$1.Effect<Option<Uint8Array>, PlatformError>;
-  readonly truncate: (length?: SizeInput) => Effect$1.Effect<void, PlatformError>;
-  readonly write: (buffer: Uint8Array) => Effect$1.Effect<Size, PlatformError>;
-  readonly writeAll: (buffer: Uint8Array) => Effect$1.Effect<void, PlatformError>;
-}
-/**
- * @since 1.0.0
+ * @public
  */
-declare namespace File$1 {
-  /**
-   * @since 1.0.0
-   * @category model
-   */
-  type Descriptor = Brand.Branded<number, "FileDescriptor">;
-  /**
-   * @since 1.0.0
-   * @category model
-   */
-  type Type = "File" | "Directory" | "SymbolicLink" | "BlockDevice" | "CharacterDevice" | "FIFO" | "Socket" | "Unknown";
-  /**
-   * @since 1.0.0
-   * @category model
-   */
-  interface Info {
-    readonly type: Type;
-    readonly mtime: Option<Date>;
-    readonly atime: Option<Date>;
-    readonly birthtime: Option<Date>;
-    readonly dev: number;
-    readonly ino: Option<number>;
-    readonly mode: number;
-    readonly nlink: Option<number>;
-    readonly uid: Option<number>;
-    readonly gid: Option<number>;
-    readonly rdev: Option<number>;
-    readonly size: Size;
-    readonly blksize: Option<Size>;
-    readonly blocks: Option<number>;
-  }
+interface TsdownLogger {
+  level: "info";
+  info: (...args: unknown[]) => void;
+  warn: (...args: unknown[]) => void;
+  warnOnce: (...args: unknown[]) => void;
+  error: (...args: unknown[]) => void;
+  success: (...args: unknown[]) => void;
+  clearScreen: () => void;
 }
 /**
- * @since 1.0.0
- * @category model
- */
-type SeekMode = "start" | "current";
-/**
- * @since 1.0.0
- * @category model
- */
-type WatchEvent = WatchEvent.Create | WatchEvent.Update | WatchEvent.Remove;
-/**
- * @since 1.0.0
- * @category model
+ * A tsdown `customLogger` that routes warnings/errors into the 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.
+ * @public
  */
-declare namespace WatchEvent {
-  /**
-   * @since 1.0.0
-   * @category model
-   */
-  interface Create {
-    readonly _tag: "Create";
-    readonly path: string;
-  }
-  /**
-   * @since 1.0.0
-   * @category model
-   */
-  interface Update {
-    readonly _tag: "Update";
-    readonly path: string;
-  }
-  /**
-   * @since 1.0.0
-   * @category model
-   */
-  interface Remove {
-    readonly _tag: "Remove";
-    readonly path: string;
-  }
-}
-//#endregion
-//#region src/report/schema-export.d.ts
-/** Generate the SchemaStore-compatible JSON Schema document for BuildReport. */
-declare const generateBuildReportSchema: () => Effect.Effect<JsonSchemaOutput, JsonSchemaError, FileSystem>;
-//#endregion
-//#region src/report/timer.d.ts
-declare function formatTime(ms: number): string;
-interface Timer {
-  readonly elapsed: () => number;
-  readonly format: () => string;
-}
-/** Create a wall-clock timer. (Date.now is fine in runtime build code.) */
-declare function createTimer(now?: () => number): Timer;
+declare function createTsdownLogger(collector: BuildCollector, groupId: string): TsdownLogger;
 //#endregion
 //#region src/targets/binding.d.ts
-/** Write the target-to-group binding to dist/prod/targets.json for the release action to consume. Returns the path. */
+/**
+ * Write the target-to-group binding to dist/prod/targets.json for the release action to consume. Returns the path.
+ *
+ * @public
+ */
 declare function writeTargetsBinding(cwd: string, resolution: TargetResolution): string;
 //#endregion
 //#region src/targets/resolve-targets.d.ts
-/** Resolve a `publishConfig.targets` map into the distinct groups to build and every target bound to one. Pure; throws ConfigValidationError on structurally-invalid config. */
+/**
+ * Resolve a `publishConfig.targets` map into the distinct groups to build and every target bound to one. Pure; throws ConfigValidationError on structurally-invalid config.
+ *
+ * @public
+ */
 declare function resolveTargets(options: {
   targets: PublishTargets;
   baseName: string;
 }): TargetResolution;
 //#endregion
-export { type BuildEmittedManifestOptions, type BuildFormat, type BuildGroupSpec, type BuildPlatform, type BuildReport, BuildReport as BuildReportSchema, type BuildTargetGroupsOptions, CatalogAssemblyError, CatalogResolutionError, CiAnnotationsFormatter, ConfigValidationError, ConfigValidator, ConfigValidatorLive, type CssOptions, DEFAULT_EXE_NODE_VERSION, type DeriveOptions, type DerivedTsdownOptions, type DualExports, type EmitManifestOptions, type EntryOverride, type Environment, EnvironmentDetector, EnvironmentDetectorLive, type ExeBuild, type ExeConfig, type ExeRewrite, type ExeSeaConfig, type ExeTarget, type ExeTargetInput, type Executor, ExecutorResolver, ExecutorResolverLive, type ExtractOptions, type ExtractResult, FormatSelector, FormatSelectorLive, type Formatter, type FormatterContext, type GenerateMetaOptions, type Json, JsonFormatter, type JsxConfig, type LooseFileSpec, type LooseFiles, type ManifestLike, MarkdownFormatter, MetaGenerationError, type MetaOptions, type MetaResult, type NextVersions, type NormalizedExe, type NormalizedLooseFile, type NormalizedMeta, type OutputFormat, OutputRenderer, OutputRendererLive, type PackageJsonEntriesOptions, type PackageJsonLike, type PkgOsCpu, type PortableTsconfig, type PublishTargetObject, type PublishTargetValue, type PublishTargets, type RenderReportOptions, type RenderedOutput, ReportPipelineLive, ReportTimings, type ResolvedCompilerOptions, type ResolvedGroup, type ResolvedTarget, type ResolvedTsconfig, type ResolvedTsconfigOptions, type RunExeBuildOptions, SilentFormatter, type TargetGroupId, type TargetGroupRef, type TargetGroupReport, TargetGroupReport as TargetGroupReportSchema, type TargetResolution, TerminalFormatter, type Timer, type TransformManifestOptions, type TsconfigJsx, TsconfigResolver, type TsdocOptions, type TsdocTagDefinition, type TsdownBuild, type ValidationInput, type WarningSuppressionRule, buildEmittedManifest, buildResolvedTsconfig, buildTargetGroups, cjsDefaultInterop, computeExeFileName, createEntryName, createTimer, defaultManifestTransform, deriveTargetGroupOptions, emitManifest, extractEntries, formatTime, generateBuildReportSchema, generateMeta, isTargetObject, nodeBuiltinDefaultInterop, normalizeBinPaths, normalizeExeOptions, normalizeLooseFiles, normalizeMetaOptions, packageJsonEntries, readTsconfigJsx, removeDeclarationMaps, renderReport, resolveJsxConfig, resolveManifest, resolveNextVersions, resolvePortableTsconfig, resolveTargets, rewriteMetaVersions, runExeBuild, syncPublicDir, transformBin, transformExports, transformManifest, writeResolvedTsconfig, writeTargetsBinding };
+export { BuildCollector, BuildCollectorTag, type BuildEmittedManifestOptions, type BuildFormat, type BuildGroupSpec, type BuildIssues, type BuildPlatform, type BuildReport, BuildReport as BuildReportSchema, type BuildTargetGroupsOptions, CatalogAssemblyError, CatalogResolutionError, CiAnnotationsFormatter, ConfigValidationError, ConfigValidator, ConfigValidatorLive, type CssOptions, DEFAULT_EXE_NODE_VERSION, type DeriveOptions, type DerivedTsdownOptions, type DiagnosticEntry, type DiagnosticInput, type DualExports, type EmitManifestOptions, type EmittedFile, type EntryOverride, type Environment, EnvironmentDetector, EnvironmentDetectorLive, type ExeBuild, type ExeConfig, type ExeRewrite, type ExeSeaConfig, type ExeTarget, type ExeTargetInput, type Executor, ExecutorResolver, ExecutorResolverLive, type ExtractOptions, type ExtractResult, FormatSelector, FormatSelectorLive, type Formatter, type FormatterContext, type GenerateMetaOptions, type Json, JsonFormatter, type JsxConfig, type LooseFileSpec, type LooseFiles, type ManifestLike, MarkdownFormatter, MetaGenerationError, type MetaOptions, type MetaResult, type NextVersions, type NormalizedExe, type NormalizedLooseFile, type NormalizedMeta, type OutputFormat, OutputRenderer, OutputRendererLive, type PackageJsonEntriesOptions, type PackageJsonLike, type PassKind, type PassReport, type PkgOsCpu, type PlainDiagnostic, type PortableTsconfig, type PublishTargetObject, type PublishTargetValue, type PublishTargets, type RenderReportOptions, type RenderedOutput, ReportPipelineLive, ReportTimings, type ResolvedCompilerOptions, type ResolvedGroup, type ResolvedTarget, type ResolvedTsconfig, type ResolvedTsconfigOptions, type RunExeBuildOptions, type RunMetaPassOptions, SilentFormatter, type TargetGroupId, type TargetGroupRef, type TargetGroupReport, TargetGroupReport as TargetGroupReportSchema, type TargetResolution, TerminalFormatter, type Timer, type TransformManifestOptions, type TsconfigJsx, TsconfigResolver, type TsdocOptions, type TsdocTagDefinition, type TsdownBuild, type TsdownLogger, type ValidationInput, type WarningSuppressionRule, applySubdirMetaEntries, buildEmittedManifest, buildMetricsPlugin, buildResolvedTsconfig, buildTargetGroups, cjsDefaultInterop, computeExeFileName, createEntryName, createTimer, createTsdownLogger, defaultManifestTransform, deriveExportPaths, deriveTargetGroupOptions, emitManifest, extractEntries, flattenIssues, formatTime, generateMeta, isTargetObject, nodeBuiltinDefaultInterop, normalizeBinPaths, normalizeExeOptions, normalizeLooseFiles, normalizeMetaOptions, packageJsonEntries, readTsconfigJsx, removeDeclarationMaps, renderReport, resolveJsxConfig, resolveManifest, resolveNextVersions, resolvePortableTsconfig, resolveTargets, rewriteMetaVersions, runExeBuild, runMetaPass, serializeIssues, syncPublicDir, transformBin, transformExports, transformManifest, writeIssuesArtifact, writeResolvedTsconfig, writeTargetsBinding };
 //# sourceMappingURL=index.d.ts.map