@savvy-web/tsdown-plugins 0.6.0 → 0.8.0

package/build/build-target-groups.js

@@ -1,4 +1,7 @@
 import { emitManifest } from "../manifest/emit-manifest.js";
+import { buildMetricsPlugin } from "../report/metrics-plugin.js";
+import { createTimer } from "../report/timer.js";
+import { createTsdownLogger } from "../report/tsdown-logger.js";
 import { cjsDefaultInterop } from "./cjs-default-interop.js";
 import { nodeBuiltinDefaultInterop } from "./node-builtin-default-interop.js";
 import { syncPublicDir } from "./sync-public.js";
@@ -24,7 +27,23 @@ import { dirname, join } from "node:path";
 async function buildTargetGroups(options) {
 	const build = options.build ?? (await import("tsdown")).build;
 	const publicDir = join(options.cwd, "public");
+	const collector = options.collector;
+	const verbose = options.verbose ?? false;
+	const instrument = (groupId) => collector === void 0 ? {} : {
+		logLevel: "silent",
+		customLogger: createTsdownLogger(collector, groupId)
+	};
+	const metricsPlugins = (groupId, pass) => collector === void 0 ? [] : [buildMetricsPlugin(collector, groupId, pass, verbose)];
+	const timed = async (groupId, pass, run) => {
+		const timer = createTimer();
+		try {
+			await run();
+		} finally {
+			if (collector !== void 0) collector.recordPassTiming(groupId, pass, timer.elapsed());
+		}
+	};
 	for (const group of options.groups) {
+		if (collector !== void 0) collector.registerGroup(group.id, Object.keys(options.entry));
 		const partitions = [{
 			entry: options.entry,
 			...options.format !== void 0 ? { format: options.format } : {},
@@ -81,7 +100,7 @@ async function buildTargetGroups(options) {
 				...options.subdirExports !== void 0 ? { subdirExports: options.subdirExports } : {},
 				...options.exeRewrite !== void 0 ? { exeRewrite: options.exeRewrite } : {}
 			}) : void 0;
-			await build({
+			await timed(group.id, "js", () => build({
 				config: false,
 				cwd: options.cwd,
 				entry: jsEntry,
@@ -95,6 +114,7 @@ async function buildTargetGroups(options) {
 				fixedExtension: js.fixedExtension,
 				dts: js.dts,
 				define: js.define,
+				...instrument(group.id),
 				...part.css !== void 0 ? { css: part.css } : {},
 				...partExternals?.length || partBundleNodeModules || partBundle?.length ? { deps: {
 					...partExternals?.length ? { neverBundle: partExternals } : {},
@@ -106,12 +126,14 @@ async function buildTargetGroups(options) {
 				plugins: [
 					...manifestPlugin ? [manifestPlugin] : [],
 					...js.format.includes("cjs") ? [nodeBuiltinDefaultInterop(), cjsDefaultInterop()] : [],
-					...options.extraPlugins ?? []
+					...options.extraPlugins ?? [],
+					...metricsPlugins(group.id, "js")
 				]
-			});
+			}));
 			if (isBase) syncPublicDir(publicDir, join(js.outDir, "public"));
 			const dtsNeverBundle = [...partExternals ?? [], ...partDtsExternals ?? []];
-			await build({
+			if (Object.keys(dts.entry).length === 0) continue;
+			await timed(group.id, "dts", () => build({
 				config: false,
 				cwd: options.cwd,
 				entry: dts.entry,
@@ -124,6 +146,7 @@ async function buildTargetGroups(options) {
 				fixedExtension: dts.fixedExtension,
 				dts: dts.dts,
 				define: dts.define,
+				...instrument(group.id),
 				...dtsNeverBundle.length > 0 || partBundleNodeModules || dts.bundledPackages ? { deps: {
 					...dtsNeverBundle.length > 0 ? { neverBundle: dtsNeverBundle } : {},
 					...partBundleNodeModules ? {
@@ -135,8 +158,12 @@ async function buildTargetGroups(options) {
 					} : {}
 				} } : {},
 				...dts.jsx !== void 0 ? { inputOptions: { jsx: dts.jsx } } : {},
-				plugins: [...dts.format.includes("cjs") ? [nodeBuiltinDefaultInterop(), cjsDefaultInterop()] : [], ...options.extraPlugins ?? []]
-			});
+				plugins: [
+					...dts.format.includes("cjs") ? [nodeBuiltinDefaultInterop(), cjsDefaultInterop()] : [],
+					...options.extraPlugins ?? [],
+					...metricsPlugins(group.id, "dts")
+				]
+			}));
 		}
 		const looseOutDir = outDirFor(options.cwd, group.id);
 		const isProdGroup = group.id !== "dev";
@@ -147,7 +174,7 @@ async function buildTargetGroups(options) {
 		};
 		for (const lf of options.looseFiles ?? []) {
 			const hasCjs = lf.format === "cjs";
-			await build({
+			await timed(group.id, "loose", () => build({
 				config: false,
 				cwd: options.cwd,
 				entry: { [lf.entryName]: lf.source },
@@ -164,10 +191,15 @@ async function buildTargetGroups(options) {
 					"process.env.__PACKAGE_VERSION__": JSON.stringify(options.version),
 					...options.define
 				},
+				...instrument(group.id),
 				...Object.keys(looseDeps).length > 0 ? { deps: looseDeps } : {},
 				...hasCjs ? { cjsDefault: true } : {},
-				plugins: [...hasCjs ? [nodeBuiltinDefaultInterop(), cjsDefaultInterop()] : [], ...options.extraPlugins ?? []]
-			});
+				plugins: [
+					...hasCjs ? [nodeBuiltinDefaultInterop(), cjsDefaultInterop()] : [],
+					...options.extraPlugins ?? [],
+					...metricsPlugins(group.id, "loose")
+				]
+			}));
 		}
 	}
 }

package/build/target-groups.js

@@ -32,6 +32,7 @@ function deriveTargetGroupOptions(options) {
 function deriveDtsPassOptions(options) {
 	const isProd = options.group !== "dev";
 	const format = options.format ?? ["esm"];
+	const entry = Object.fromEntries(Object.entries(options.entry).filter(([name]) => !name.startsWith("bin/")));
 	return {
 		outDir: outDirFor(options.cwd, options.group),
 		sourcemap: false,
@@ -40,7 +41,7 @@ function deriveDtsPassOptions(options) {
 		clean: false,
 		platform: "node",
 		fixedExtension: false,
-		entry: options.entry,
+		entry,
 		dts: {
 			tsconfig: options.tsconfigPath,
 			emitDtsOnly: true

package/changesets/next-versions.js

@@ -0,0 +1,42 @@
+import getReleasePlan from "@changesets/get-release-plan";
+import { getPackages } from "@manypkg/get-packages";
+
+//#region src/changesets/next-versions.ts
+/**
+* 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).
+*/
+async function resolveNextVersions(cwd) {
+	try {
+		const packages = await getPackages(cwd);
+		if (packages.tool === "root") return {
+			root: packages.root.dir,
+			versions: /* @__PURE__ */ new Map()
+		};
+		const versions = /* @__PURE__ */ new Map();
+		for (const p of packages.packages) {
+			const { name, version } = p.packageJson;
+			if (name && version) versions.set(name, version);
+		}
+		try {
+			const plan = await getReleasePlan(packages.root.dir);
+			for (const r of plan.releases) versions.set(r.name, r.newVersion);
+		} catch {}
+		return {
+			root: packages.root.dir,
+			versions
+		};
+	} catch {
+		return {
+			root: cwd,
+			versions: /* @__PURE__ */ new Map()
+		};
+	}
+}
+
+//#endregion
+export { resolveNextVersions };

package/config-validation/ConfigValidatorLive.js

@@ -7,7 +7,7 @@ import { Effect, Layer } from "effect";
 import { existsSync, statSync } from "node:fs";
 
 //#region src/config-validation/ConfigValidatorLive.ts
-const VALID_SYNTAX_KINDS = new Set([
+const VALID_SYNTAX_KINDS = /* @__PURE__ */ new Set([
 	"block",
 	"inline",
 	"modifier"

package/exe/build.js

@@ -1,3 +1,6 @@
+import { buildMetricsPlugin } from "../report/metrics-plugin.js";
+import { createTimer } from "../report/timer.js";
+import { createTsdownLogger } from "../report/tsdown-logger.js";
 import { join } from "node:path";
 import { mkdtempSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
@@ -8,6 +11,14 @@ async function runExeBuild(options) {
 	const build = options.build ?? (await import("tsdown")).build;
 	for (const spec of options.specs) {
 		const scratch = mkdtempSync(join(tmpdir(), "savvy-exe-"));
+		const collector = options.collector;
+		const groupId = options.groupId;
+		const instrument = collector !== void 0 && groupId !== void 0 ? {
+			logLevel: "silent",
+			customLogger: createTsdownLogger(collector, groupId)
+		} : {};
+		const plugins = collector !== void 0 && groupId !== void 0 ? [buildMetricsPlugin(collector, groupId, "exe", options.verbose ?? false)] : [];
+		const timer = createTimer();
 		try {
 			await build({
 				cwd: options.cwd,
@@ -23,9 +34,12 @@ async function runExeBuild(options) {
 					outDir: options.outDir,
 					seaConfig: spec.seaConfig,
 					targets: spec.targets
-				}
+				},
+				...instrument,
+				...plugins.length > 0 ? { plugins } : {}
 			});
 		} finally {
+			if (collector !== void 0 && groupId !== void 0) collector.recordPassTiming(groupId, "exe", timer.elapsed());
 			rmSync(scratch, {
 				recursive: true,
 				force: true

package/index.d.ts

@@ -152,6 +152,148 @@ interface EmitManifestOptions {
 /** Rolldown plugin: emit the transformed package.json + LICENSE/README into the output pkg/ root. */
 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;
+}, {}, {}>;
+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;
+  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;
+  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 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. */
+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). */
+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). */
+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>;
+  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>;
+  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[];
+}, {}, {}>;
+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[];
+}, {}, {}>;
+declare class BuildReport extends BuildReport_base {}
+//#endregion
+//#region src/report/collector.d.ts
+type PassKind = PassReport["id"];
+interface DiagnosticInput {
+  readonly source: DiagnosticEntry["source"];
+  readonly level: DiagnosticEntry["level"];
+  readonly text: string;
+  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.
+ */
+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;
+  snapshot(packageName: string): ReadonlyArray<BuildReport>;
+}
+declare const BuildCollectorTag_base: Context.TagClass<BuildCollectorTag, "@savvy-web/tsdown-plugins/BuildCollector", BuildCollector>;
+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). */
 type TargetGroupId = string;
@@ -437,6 +579,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.
@@ -564,6 +710,24 @@ declare function syncPublicDir(sourceDir: string, targetDir: string): void;
  */
 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. */
+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). */
+  readonly versions: ReadonlyMap<string, string>;
+}
+/**
+ * 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).
+ */
+declare function resolveNextVersions(cwd: string): Promise<NextVersions>;
+//#endregion
 //#region src/errors.d.ts
 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";
@@ -662,20 +826,30 @@ interface TsdocOptions {
 }
 /** The `meta` field on defineBuild. Absent means no api-model generation. */
 interface MetaOptions {
-  /** Directories to copy the api-model into on `savvy build --target meta`. */
+  /** Directories to copy the canonical group's api-model into after `savvy build --target prod`. */
   readonly localPaths?: ReadonlyArray<string> | undefined;
+  /**
+   * Forward-look the meta bundle's own `version` and workspace-sibling dep versions to their
+   * NEXT release version from pending changesets. `"auto"` (default) is `false` under CI
+   * (`CI`/`GITHUB_ACTIONS` set) and `true` locally, so a local bundle matches the CI release build.
+   */
+  readonly optimistic?: "auto" | boolean | undefined;
   readonly tsdoc?: TsdocOptions | undefined;
 }
 /** Fully-resolved meta options (no optionals). */
 interface NormalizedMeta {
   readonly localPaths: ReadonlyArray<string>;
+  readonly optimistic: boolean;
   readonly tsdoc: {
     readonly suppressWarnings: ReadonlyArray<WarningSuppressionRule>;
     readonly tagDefinitions: ReadonlyArray<TsdocTagDefinition>;
   };
 }
 /** Fill defaults so downstream code never branches on undefined. */
-declare function normalizeMetaOptions(meta: MetaOptions): NormalizedMeta;
+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). */
@@ -817,6 +991,12 @@ 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>;
@@ -846,6 +1026,14 @@ interface GenerateMetaOptions {
   /** Directories (relative to cwd) to copy the meta bundle into. */
   readonly localPaths: ReadonlyArray<string>;
   readonly tsdoc: NormalizedMeta["tsdoc"];
+  /**
+   * Optional transform applied to the bundle `package.json` (read from `dtsDir`) before it is
+   * written to `outMetaDir` and copied into `localPaths`. Used for the optimistic next-version
+   * rewrite. When omitted, the package.json is copied verbatim.
+   */
+  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;
 }
 interface MetaResult {
   readonly apiJsonPath: string;
@@ -860,6 +1048,15 @@ interface MetaResult {
  */
 declare function generateMeta(options: GenerateMetaOptions): Promise<MetaResult>;
 //#endregion
+//#region src/meta/optimistic.d.ts
+/**
+ * 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.
+ */
+declare function rewriteMetaVersions(pkg: Record<string, unknown>, versions: ReadonlyMap<string, string>, selfName: string): Record<string, unknown>;
+//#endregion
 //#region src/meta/tsconfig-resolver.d.ts
 /**
  * Compiler options with enum values converted to their string equivalents.
@@ -969,36 +1166,6 @@ 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
 interface RenderedOutput {
   readonly target: "stdout" | "file" | "github-summary";
@@ -1007,6 +1174,7 @@ interface RenderedOutput {
 }
 interface FormatterContext {
   readonly noColor: boolean;
+  readonly verbose: boolean;
 }
 interface Formatter {
   readonly format: string;
@@ -1067,6 +1235,16 @@ declare class OutputRenderer extends OutputRenderer_base {}
 //#region src/report/layers/OutputRendererLive.d.ts
 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`.
+ */
+declare function buildMetricsPlugin(collector: BuildCollector, groupId: string, pass: PassKind, verbose: boolean): Plugin;
+//#endregion
 //#region src/report/pipeline.d.ts
 declare const ReportPipelineLive: Layer.Layer<EnvironmentDetector | ExecutorResolver | FormatSelector | OutputRenderer, never, never>;
 interface RenderReportOptions {
@@ -1074,6 +1252,7 @@ interface RenderReportOptions {
   /** Override env detection (mainly for tests). */
   readonly env?: Environment;
   readonly noColor: boolean;
+  readonly verbose?: boolean;
 }
 declare const renderReport: (reports: ReadonlyArray<BuildReport>, options: RenderReportOptions) => Effect.Effect<ReadonlyArray<RenderedOutput>, never, EnvironmentDetector | ExecutorResolver | FormatSelector | OutputRenderer>;
 //#endregion
@@ -1568,6 +1747,25 @@ interface Timer {
 /** Create a wall-clock timer. (Date.now is fine in runtime build code.) */
 declare function createTimer(now?: () => number): Timer;
 //#endregion
+//#region src/report/tsdown-logger.d.ts
+/** Structural match for tsdown's Logger interface (tsdown 0.22.x). */
+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;
+}
+/**
+ * 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.
+ */
+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. */
 declare function writeTargetsBinding(cwd: string, resolution: TargetResolution): string;
@@ -1579,5 +1777,5 @@ declare function resolveTargets(options: {
   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 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, resolvePortableTsconfig, resolveTargets, runExeBuild, syncPublicDir, transformBin, transformExports, transformManifest, writeResolvedTsconfig, writeTargetsBinding };
+export { BuildCollector, BuildCollectorTag, 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 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 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 TsdownLogger, type ValidationInput, type WarningSuppressionRule, buildEmittedManifest, buildMetricsPlugin, buildResolvedTsconfig, buildTargetGroups, cjsDefaultInterop, computeExeFileName, createEntryName, createTimer, createTsdownLogger, 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 };
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -2,6 +2,9 @@ import { resolveManifest } from "./catalog/resolve-catalogs.js";
 import { createEntryName, extractEntries } from "./entry/extract.js";
 import { defaultManifestTransform, normalizeBinPaths, transformBin, transformExports, transformManifest } from "./manifest/transform.js";
 import { buildEmittedManifest, emitManifest } from "./manifest/emit-manifest.js";
+import { buildMetricsPlugin } from "./report/metrics-plugin.js";
+import { createTimer, formatTime } from "./report/timer.js";
+import { createTsdownLogger } from "./report/tsdown-logger.js";
 import { cjsDefaultInterop } from "./build/cjs-default-interop.js";
 import { nodeBuiltinDefaultInterop } from "./build/node-builtin-default-interop.js";
 import { syncPublicDir } from "./build/sync-public.js";
@@ -10,6 +13,7 @@ import { buildTargetGroups } from "./build/build-target-groups.js";
 import { ConfigValidationError, MetaGenerationError } from "./errors.js";
 import { normalizeLooseFiles } from "./build/loose-files.js";
 import { removeDeclarationMaps } from "./build/strip-maps.js";
+import { resolveNextVersions } from "./changesets/next-versions.js";
 import { ConfigValidator } from "./config-validation/ConfigValidator.js";
 import { DEFAULT_EXE_NODE_VERSION, normalizeExeOptions } from "./exe/config.js";
 import { isTargetObject } from "./targets/config.js";
@@ -23,11 +27,13 @@ import { readTsconfigJsx, resolveJsxConfig } from "./jsx/config.js";
 import { normalizeMetaOptions } from "./meta/config.js";
 import { TsconfigResolver, resolvePortableTsconfig } from "./meta/tsconfig-resolver.js";
 import { generateMeta } from "./meta/generate.js";
+import { rewriteMetaVersions } from "./meta/optimistic.js";
+import { BuildReport, ReportTimings, TargetGroupReport } from "./report/schema.js";
+import { BuildCollector, BuildCollectorTag } from "./report/collector.js";
 import { CiAnnotationsFormatter } from "./report/formatters/ci-annotations.js";
 import { JsonFormatter } from "./report/formatters/json.js";
 import { MarkdownFormatter } from "./report/formatters/markdown.js";
 import { SilentFormatter } from "./report/formatters/silent.js";
-import { createTimer, formatTime } from "./report/timer.js";
 import { TerminalFormatter } from "./report/formatters/terminal.js";
 import { EnvironmentDetector } from "./report/services/EnvironmentDetector.js";
 import { EnvironmentDetectorLive } from "./report/layers/EnvironmentDetectorLive.js";
@@ -38,9 +44,8 @@ import { FormatSelectorLive } from "./report/layers/FormatSelectorLive.js";
 import { OutputRenderer } from "./report/services/OutputRenderer.js";
 import { OutputRendererLive } from "./report/layers/OutputRendererLive.js";
 import { ReportPipelineLive, renderReport } from "./report/pipeline.js";
-import { BuildReport, ReportTimings, TargetGroupReport } from "./report/schema.js";
 import { generateBuildReportSchema } from "./report/schema-export.js";
 import { writeTargetsBinding } from "./targets/binding.js";
 import { CatalogAssemblyError, CatalogResolutionError } from "workspaces-effect";
 
-export { BuildReport as BuildReportSchema, CatalogAssemblyError, CatalogResolutionError, CiAnnotationsFormatter, ConfigValidationError, ConfigValidator, ConfigValidatorLive, DEFAULT_EXE_NODE_VERSION, EnvironmentDetector, EnvironmentDetectorLive, ExecutorResolver, ExecutorResolverLive, FormatSelector, FormatSelectorLive, JsonFormatter, MarkdownFormatter, MetaGenerationError, OutputRenderer, OutputRendererLive, ReportPipelineLive, ReportTimings, SilentFormatter, TargetGroupReport as TargetGroupReportSchema, TerminalFormatter, TsconfigResolver, 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, resolvePortableTsconfig, resolveTargets, runExeBuild, syncPublicDir, transformBin, transformExports, transformManifest, writeResolvedTsconfig, writeTargetsBinding };
+export { BuildCollector, BuildCollectorTag, BuildReport as BuildReportSchema, CatalogAssemblyError, CatalogResolutionError, CiAnnotationsFormatter, ConfigValidationError, ConfigValidator, ConfigValidatorLive, DEFAULT_EXE_NODE_VERSION, EnvironmentDetector, EnvironmentDetectorLive, ExecutorResolver, ExecutorResolverLive, FormatSelector, FormatSelectorLive, JsonFormatter, MarkdownFormatter, MetaGenerationError, OutputRenderer, OutputRendererLive, ReportPipelineLive, ReportTimings, SilentFormatter, TargetGroupReport as TargetGroupReportSchema, TerminalFormatter, TsconfigResolver, buildEmittedManifest, buildMetricsPlugin, buildResolvedTsconfig, buildTargetGroups, cjsDefaultInterop, computeExeFileName, createEntryName, createTimer, createTsdownLogger, 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 };

package/meta/api-extractor.js

@@ -7,6 +7,20 @@ import { TSDocConfigFile } from "@microsoft/tsdoc-config";
 
 //#region src/meta/api-extractor.ts
 const require_ = createRequire(import.meta.url);
+/** Map an API Extractor message to a collector DiagnosticInput, or undefined if not warn/error. */
+function mapExtractorMessage(message) {
+	const isError = message.logLevel === ExtractorLogLevel.Error;
+	const isWarning = message.logLevel === ExtractorLogLevel.Warning;
+	if (!isError && !isWarning) return void 0;
+	return {
+		source: "api-extractor",
+		level: isError ? "error" : "warn",
+		text: message.text,
+		...message.sourceFilePath !== void 0 ? { file: message.sourceFilePath } : {},
+		...message.sourceFileLine !== void 0 ? { line: message.sourceFileLine } : {},
+		...message.sourceFileColumn !== void 0 ? { column: message.sourceFileColumn } : {}
+	};
+}
 /** Run API Extractor over a single entry's .d.ts, writing the .api.json (and optionally tsdoc-metadata.json). Throws on failure. */
 function runApiExtractor(options) {
 	const suppressor = createMessageSuppressor(options.suppressWarnings);
@@ -47,6 +61,13 @@ function runApiExtractor(options) {
 				message.logLevel = ExtractorLogLevel.None;
 				message.handled = true;
 			}
+			if (options.onMessage !== void 0) {
+				const entry = mapExtractorMessage(message);
+				if (entry !== void 0) {
+					options.onMessage(entry);
+					message.handled = true;
+				}
+			}
 		}
 	});
 	if (!result.succeeded) throw new MetaGenerationError({

package/meta/config.js

@@ -1,8 +1,14 @@
 //#region src/meta/config.ts
+/** Resolve `"auto"` against the environment; explicit booleans pass through. */
+function resolveOptimistic(value, env) {
+	if (value === true || value === false) return value;
+	return !(env.CI || env.GITHUB_ACTIONS);
+}
 /** Fill defaults so downstream code never branches on undefined. */
-function normalizeMetaOptions(meta) {
+function normalizeMetaOptions(meta, env = process.env) {
 	return {
 		localPaths: meta.localPaths ?? [],
+		optimistic: resolveOptimistic(meta.optimistic, env),
 		tsdoc: {
 			suppressWarnings: meta.tsdoc?.suppressWarnings ?? [],
 			tagDefinitions: meta.tsdoc?.tagDefinitions ?? []

package/meta/generate.js

@@ -18,7 +18,7 @@ function unscopedName(name) {
 * published-package artifact and is written into `dtsDir` (the built pkg/), not the meta bundle.
 */
 async function generateMeta(options) {
-	const { cwd, packageName, tsconfigPath, dtsDir, entries, exportPaths, outMetaDir, localPaths, tsdoc } = options;
+	const { cwd, packageName, tsconfigPath, dtsDir, entries, exportPaths, outMetaDir, localPaths, tsdoc, manifestTransform, onMessage } = options;
 	const tsdocConfigPath = writeTsdocConfig(cwd, tsdoc);
 	const packageJsonPath = join(cwd, "package.json");
 	mkdirSync(outMetaDir, { recursive: true });
@@ -41,7 +41,8 @@ async function generateMeta(options) {
 			tsdocConfigPath,
 			apiJsonPath: perEntryApiJson,
 			...isMain && !mainEntryDidTsdocMetadata ? { tsdocMetadataPath } : {},
-			suppressWarnings: tsdoc.suppressWarnings
+			suppressWarnings: tsdoc.suppressWarnings,
+			...onMessage !== void 0 ? { onMessage } : {}
 		});
 		if (isMain) mainEntryDidTsdocMetadata = true;
 		perEntryModels.set(entryName, JSON.parse(readFileSync(perEntryApiJson, "utf-8")));
@@ -55,7 +56,9 @@ async function generateMeta(options) {
 	writeFileSync(apiJsonPath, `${JSON.stringify(finalModel, null, 2)}\n`, "utf-8");
 	for (const intermediate of intermediateApiJsons) rmSync(intermediate, { force: true });
 	const bundlePackageJson = join(outMetaDir, "package.json");
-	copyFileSync(join(dtsDir, "package.json"), bundlePackageJson);
+	const builtPkg = JSON.parse(readFileSync(join(dtsDir, "package.json"), "utf-8"));
+	const finalPkg = manifestTransform ? manifestTransform(builtPkg) : builtPkg;
+	writeFileSync(bundlePackageJson, `${JSON.stringify(finalPkg, null, 2)}\n`, "utf-8");
 	const bundleTsconfig = join(outMetaDir, "tsconfig.json");
 	const portableTsconfig = resolvePortableTsconfig(cwd, tsconfigPath);
 	writeFileSync(bundleTsconfig, `${JSON.stringify(portableTsconfig, null, 2)}\n`, "utf-8");

package/meta/optimistic.js

@@ -0,0 +1,32 @@
+//#region src/meta/optimistic.ts
+/** Dependency map fields whose workspace-sibling versions get the optimistic bump. */
+const DEP_FIELDS = [
+	"dependencies",
+	"peerDependencies",
+	"optionalDependencies"
+];
+/**
+* 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.
+*/
+function rewriteMetaVersions(pkg, versions, selfName) {
+	const out = { ...pkg };
+	const selfNext = versions.get(selfName);
+	if (selfNext !== void 0) out.version = selfNext;
+	for (const field of DEP_FIELDS) {
+		const deps = pkg[field];
+		if (deps === null || typeof deps !== "object") continue;
+		const next = { ...deps };
+		for (const depName of Object.keys(next)) {
+			const v = versions.get(depName);
+			if (v !== void 0) next[depName] = v;
+		}
+		out[field] = next;
+	}
+	return out;
+}
+
+//#endregion
+export { rewriteMetaVersions };

package/meta/tsconfig-resolver.js

@@ -85,7 +85,7 @@ const PRESERVED_STRING_OPTIONS = [
 */
 var TsconfigResolver = class TsconfigResolver {
 	/** @internal */
-	static SCRIPT_TARGET_MAP = new Map([
+	static SCRIPT_TARGET_MAP = /* @__PURE__ */ new Map([
 		[ScriptTarget.ES5, "es5"],
 		[ScriptTarget.ES2015, "es2015"],
 		[ScriptTarget.ES2016, "es2016"],
@@ -102,7 +102,7 @@ var TsconfigResolver = class TsconfigResolver {
 		[ScriptTarget.JSON, "json"]
 	]);
 	/** @internal */
-	static MODULE_KIND_MAP = new Map([
+	static MODULE_KIND_MAP = /* @__PURE__ */ new Map([
 		[ModuleKind.CommonJS, "commonjs"],
 		[ModuleKind.ES2015, "es2015"],
 		[ModuleKind.ES2020, "es2020"],
@@ -115,14 +115,14 @@ var TsconfigResolver = class TsconfigResolver {
 		[ModuleKind.Preserve, "preserve"]
 	]);
 	/** @internal */
-	static MODULE_RESOLUTION_MAP = new Map([
+	static MODULE_RESOLUTION_MAP = /* @__PURE__ */ new Map([
 		[ModuleResolutionKind.Node10, "node10"],
 		[ModuleResolutionKind.Node16, "node16"],
 		[ModuleResolutionKind.NodeNext, "nodenext"],
 		[ModuleResolutionKind.Bundler, "bundler"]
 	]);
 	/** @internal */
-	static JSX_EMIT_MAP = new Map([
+	static JSX_EMIT_MAP = /* @__PURE__ */ new Map([
 		[JsxEmit.None, "none"],
 		[JsxEmit.Preserve, "preserve"],
 		[JsxEmit.React, "react"],
@@ -131,13 +131,13 @@ var TsconfigResolver = class TsconfigResolver {
 		[JsxEmit.ReactJSXDev, "react-jsxdev"]
 	]);
 	/** @internal */
-	static MODULE_DETECTION_MAP = new Map([
+	static MODULE_DETECTION_MAP = /* @__PURE__ */ new Map([
 		[ModuleDetectionKind.Legacy, "legacy"],
 		[ModuleDetectionKind.Auto, "auto"],
 		[ModuleDetectionKind.Force, "force"]
 	]);
 	/** @internal */
-	static NEW_LINE_MAP = new Map([[NewLineKind.CarriageReturnLineFeed, "crlf"], [NewLineKind.LineFeed, "lf"]]);
+	static NEW_LINE_MAP = /* @__PURE__ */ new Map([[NewLineKind.CarriageReturnLineFeed, "crlf"], [NewLineKind.LineFeed, "lf"]]);
 	/** Converts a {@link ScriptTarget} enum value to its string form (e.g. `es2023`). */
 	static convertScriptTarget(target) {
 		if (target === void 0) return void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/tsdown-plugins",
-	"version": "0.6.0",
+	"version": "0.8.0",
 	"private": false,
 	"description": "Interface-only tsdown/rolldown plugin pack powering @savvy-web/bundler",
 	"homepage": "https://github.com/savvy-web/systems/tree/main/packages/tsdown-plugins",
@@ -28,7 +28,9 @@
 		"./package.json": "./package.json"
 	},
 	"dependencies": {
+		"@changesets/get-release-plan": "^4.0.16",
 		"@effect/platform-node": "^0.107.0",
+		"@manypkg/get-packages": "^1.1.3",
 		"@microsoft/api-extractor": "^7.58.9",
 		"@microsoft/tsdoc": "^0.16.0",
 		"@microsoft/tsdoc-config": "^0.18.1",

package/report/collector.js

@@ -0,0 +1,126 @@
+import { BuildReport, DiagnosticEntry, EmittedFile, PassReport, ReportTimings, TargetGroupReport } from "./schema.js";
+import { Context } from "effect";
+
+//#region src/report/collector.ts
+/**
+* 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.
+*/
+var BuildCollector = class {
+	groups = /* @__PURE__ */ new Map();
+	group(groupId) {
+		let g = this.groups.get(groupId);
+		if (g === void 0) {
+			g = {
+				id: groupId,
+				entries: [],
+				passes: /* @__PURE__ */ new Map(),
+				warnings: [],
+				errors: [],
+				seenPaths: /* @__PURE__ */ new Set(),
+				seenDiagnostics: /* @__PURE__ */ new Set()
+			};
+			this.groups.set(groupId, g);
+		}
+		return g;
+	}
+	pass(groupId, pass) {
+		const g = this.group(groupId);
+		let p = g.passes.get(pass);
+		if (p === void 0) {
+			p = {
+				files: [],
+				ms: 0
+			};
+			g.passes.set(pass, p);
+		}
+		return p;
+	}
+	registerGroup(groupId, entries) {
+		this.group(groupId).entries = [...entries];
+	}
+	recordEmitted(groupId, pass, file) {
+		const g = this.group(groupId);
+		if (g.seenPaths.has(file.path)) return;
+		g.seenPaths.add(file.path);
+		this.pass(groupId, pass).files.push({
+			path: file.path,
+			bytes: file.bytes,
+			...file.gzip !== void 0 ? { gzip: file.gzip } : {}
+		});
+	}
+	recordPassTiming(groupId, pass, ms) {
+		this.pass(groupId, pass).ms += ms;
+	}
+	recordWarning(groupId, entry) {
+		const g = this.group(groupId);
+		const key = diagnosticKey(entry);
+		if (g.seenDiagnostics.has(key)) return;
+		g.seenDiagnostics.add(key);
+		g.warnings.push(toEntry(entry));
+	}
+	recordError(groupId, entry) {
+		const g = this.group(groupId);
+		const key = diagnosticKey(entry);
+		if (g.seenDiagnostics.has(key)) return;
+		g.seenDiagnostics.add(key);
+		g.errors.push(toEntry(entry));
+	}
+	snapshot(packageName) {
+		const targetGroups = [];
+		for (const g of this.groups.values()) {
+			const passes = [];
+			let totalMs = 0;
+			for (const [id, p] of g.passes) {
+				const files = p.files.map((f) => new EmittedFile({
+					path: f.path,
+					bytes: f.bytes,
+					...f.gzip !== void 0 ? { gzip: f.gzip } : {}
+				}));
+				passes.push(new PassReport({
+					id,
+					files,
+					ms: p.ms
+				}));
+				totalMs += p.ms;
+			}
+			targetGroups.push(new TargetGroupReport({
+				id: g.id,
+				entries: [...g.entries],
+				passes,
+				warnings: [...g.warnings],
+				errors: [...g.errors],
+				timings: new ReportTimings({ totalMs })
+			}));
+		}
+		return [new BuildReport({
+			package: packageName,
+			targetGroups
+		})];
+	}
+};
+function diagnosticKey(input) {
+	return [
+		input.source,
+		input.level,
+		input.text,
+		input.file ?? "",
+		String(input.line ?? ""),
+		String(input.column ?? "")
+	].join("\0");
+}
+function toEntry(input) {
+	return new DiagnosticEntry({
+		source: input.source,
+		level: input.level,
+		text: input.text,
+		...input.file !== void 0 ? { file: input.file } : {},
+		...input.line !== void 0 ? { line: input.line } : {},
+		...input.column !== void 0 ? { column: input.column } : {}
+	});
+}
+var BuildCollectorTag = class extends Context.Tag("@savvy-web/tsdown-plugins/BuildCollector")() {};
+
+//#endregion
+export { BuildCollector, BuildCollectorTag };

package/report/formatters/ci-annotations.js

@@ -5,8 +5,14 @@ const CiAnnotationsFormatter = {
 	render: (reports) => {
 		const lines = [];
 		for (const r of reports) for (const g of r.targetGroups) {
-			for (const e of g.errors) lines.push(`::error title=${esc(r.package)} (${esc(g.id)})::${esc(e)}`);
-			for (const w of g.warnings) lines.push(`::warning title=${esc(r.package)} (${esc(g.id)})::${esc(w)}`);
+			for (const e of g.errors) {
+				const loc = e.file !== void 0 ? ` file=${esc(e.file)}${e.line !== void 0 ? `,line=${e.line}` : ""}` : "";
+				lines.push(`::error title=${esc(r.package)} (${esc(g.id)})${loc}::${esc(e.text)}`);
+			}
+			for (const w of g.warnings) {
+				const loc = w.file !== void 0 ? ` file=${esc(w.file)}${w.line !== void 0 ? `,line=${w.line}` : ""}` : "";
+				lines.push(`::warning title=${esc(r.package)} (${esc(g.id)})${loc}::${esc(w.text)}`);
+			}
 		}
 		return lines.length === 0 ? [] : [{
 			target: "stdout",

package/report/formatters/markdown.js

@@ -9,7 +9,7 @@ const MarkdownFormatter = {
 				lines.push(`## ❌ ${r.package}`);
 				for (const g of failing) {
 					lines.push(`- **${g.id}**`);
-					for (const e of g.errors) lines.push(`  - ${e}`);
+					for (const e of g.errors) lines.push(`  - ${e.text}`);
 				}
 			} else lines.push(`## ✅ ${r.package}`);
 		}

package/report/formatters/terminal.js

@@ -2,20 +2,40 @@ import { formatTime } from "../timer.js";
 import pc from "picocolors";
 
 //#region src/report/formatters/terminal.ts
+const fmtBytes = (n) => n < 1024 ? `${n} B` : `${(n / 1024).toFixed(2)} kB`;
+const fileCount = (g) => g.passes.reduce((sum, p) => sum + p.files.length, 0);
+const diagLine = (d) => {
+	return `${d.file !== void 0 ? ` ${d.file}${d.line !== void 0 ? `:${d.line}` : ""}` : ""} ${d.text}`.trim();
+};
 const TerminalFormatter = {
 	format: "terminal",
 	render: (reports, ctx) => {
 		const color = (fn, s) => ctx.noColor ? s : fn(s);
 		const lines = [];
+		let totalMs = 0;
 		for (const r of reports) {
 			lines.push(color(pc.bold, r.package));
 			for (const g of r.targetGroups) {
 				const status = g.errors.length ? color(pc.red, "✗") : color(pc.green, "✓");
-				lines.push(`  ${status} ${g.id} — ${g.emittedFiles.length} files (${formatTime(g.timings.totalMs)})`);
-				for (const e of g.errors) lines.push(`    ${color(pc.red, "error")}: ${e}`);
-				for (const w of g.warnings) lines.push(`    ${color(pc.yellow, "warn")}: ${w}`);
+				lines.push(`  ${status} ${g.id}  ${fileCount(g)} files · ${formatTime(g.timings.totalMs)}`);
+				totalMs += g.timings.totalMs;
+				if (ctx.verbose) for (const p of g.passes) {
+					lines.push(`    ${color(pc.dim, `${p.id} (${formatTime(p.ms)})`)}`);
+					for (const f of p.files) {
+						const gz = f.gzip !== void 0 ? ` │ gzip ${fmtBytes(f.gzip)}` : "";
+						lines.push(`      ${f.path}  ${fmtBytes(f.bytes)}${gz}`);
+					}
+				}
+				for (const e of g.errors) lines.push(`    ${color(pc.red, "error")} ${diagLine(e)}`);
+				for (const w of g.warnings) lines.push(`    ${color(pc.yellow, "warn")} ${diagLine(w)}`);
 			}
 		}
+		const pkgs = reports.length;
+		if (pkgs > 0) {
+			const pkgLabel = `${pkgs} package${pkgs === 1 ? "" : "s"}`;
+			const hasErrors = reports.some((r) => r.targetGroups.some((g) => g.errors.length > 0));
+			lines.push(hasErrors ? `${color(pc.red, "✗")} build failed · ${pkgLabel} · ${formatTime(totalMs)}` : `${color(pc.green, "✔")} build complete · ${pkgLabel} · ${formatTime(totalMs)}`);
+		}
 		const content = lines.join("\n");
 		return content === "" ? [] : [{
 			target: "stdout",

package/report/layers/OutputRendererLive.js

@@ -7,7 +7,7 @@ import { OutputRenderer } from "../services/OutputRenderer.js";
 import { Effect, Layer } from "effect";
 
 //#region src/report/layers/OutputRendererLive.ts
-const formatters = new Map([
+const formatters = /* @__PURE__ */ new Map([
 	["terminal", TerminalFormatter],
 	["json", JsonFormatter],
 	["markdown", MarkdownFormatter],

package/report/metrics-plugin.js

@@ -0,0 +1,62 @@
+import { gzipSync } from "node:zlib";
+
+//#region src/report/metrics-plugin.ts
+function contentOf(chunk) {
+	const c = chunk;
+	if (c.type === "chunk") return c.code;
+	if (c.type === "asset") return c.source;
+	return c.code ?? c.source;
+}
+function byteLength(content) {
+	return typeof content === "string" ? Buffer.byteLength(content) : content.byteLength;
+}
+/**
+* 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`.
+*/
+function buildMetricsPlugin(collector, groupId, pass, verbose) {
+	return {
+		name: "savvy:build-metrics",
+		writeBundle(_outputOptions, bundle) {
+			for (const [key, chunk] of Object.entries(bundle)) {
+				const content = contentOf(chunk);
+				if (content === void 0) continue;
+				const bytes = byteLength(content);
+				collector.recordEmitted(groupId, pass, {
+					path: key,
+					bytes,
+					...verbose ? { gzip: gzipSync(typeof content === "string" ? Buffer.from(content) : content).length } : {}
+				});
+			}
+		},
+		onLog(level, log) {
+			const l = log;
+			const entry = {
+				text: l.message ?? String(log),
+				...l.id !== void 0 ? { file: l.id } : {},
+				...l.loc?.line !== void 0 ? { line: l.loc.line } : {},
+				...l.loc?.column !== void 0 ? { column: l.loc.column } : {}
+			};
+			if (level === "error") {
+				collector.recordError(groupId, {
+					source: "rolldown",
+					level: "error",
+					...entry
+				});
+				return;
+			}
+			if (level === "warn") collector.recordWarning(groupId, {
+				source: "rolldown",
+				level: "warn",
+				...entry
+			});
+			return false;
+		}
+	};
+}
+
+//#endregion
+export { buildMetricsPlugin };

package/report/pipeline.js

@@ -18,7 +18,10 @@ const renderReport = (reports, options) => Effect.gen(function* () {
 	const env = options.env ?? (yield* detector.detect());
 	const executor = yield* executorResolver.resolve(env);
 	const format = yield* formatSelector.select(executor, options.explicitFormat, env);
-	return yield* renderer.render(reports, format, { noColor: options.noColor });
+	return yield* renderer.render(reports, format, {
+		noColor: options.noColor,
+		verbose: options.verbose ?? false
+	});
 });
 
 //#endregion

package/report/schema.js

@@ -1,19 +1,40 @@
 import { Schema } from "effect";
 
 //#region src/report/schema.ts
-const ReportTimings = Schema.Struct({ totalMs: Schema.Number }).annotations({ identifier: "ReportTimings" });
-const TargetGroupReport = Schema.Struct({
+var ReportTimings = class extends Schema.Class("ReportTimings")({ totalMs: Schema.Number }) {};
+/** A captured warning or error, from tsdown's logger, rolldown's onLog, or API Extractor. */
+var DiagnosticEntry = class extends Schema.Class("DiagnosticEntry")({
+	source: Schema.Literal("tsdown", "rolldown", "api-extractor"),
+	level: Schema.Literal("warn", "error"),
+	text: Schema.String,
+	file: Schema.optional(Schema.String),
+	line: Schema.optional(Schema.Number),
+	column: Schema.optional(Schema.Number)
+}) {};
+/** One emitted output file with its in-memory byte size (gzip only when --verbose). */
+var EmittedFile = class extends Schema.Class("EmittedFile")({
+	path: Schema.String,
+	bytes: Schema.Number,
+	gzip: Schema.optional(Schema.Number)
+}) {};
+/** One build pass within a target group (js / dts / loose / exe / meta). */
+var PassReport = class extends Schema.Class("PassReport")({
+	id: Schema.Literal("js", "dts", "loose", "exe", "meta"),
+	files: Schema.Array(EmittedFile),
+	ms: Schema.Number
+}) {};
+var TargetGroupReport = class extends Schema.Class("TargetGroupReport")({
 	id: Schema.String,
 	entries: Schema.Array(Schema.String),
-	emittedFiles: Schema.Array(Schema.String),
-	timings: ReportTimings,
-	warnings: Schema.Array(Schema.String),
-	errors: Schema.Array(Schema.String)
-}).annotations({ identifier: "TargetGroupReport" });
-const BuildReport = Schema.Struct({
+	passes: Schema.Array(PassReport),
+	warnings: Schema.Array(DiagnosticEntry),
+	errors: Schema.Array(DiagnosticEntry),
+	timings: ReportTimings
+}) {};
+var BuildReport = class extends Schema.Class("BuildReport")({
 	package: Schema.String,
 	targetGroups: Schema.Array(TargetGroupReport)
-}).annotations({ identifier: "BuildReport" });
+}) {};
 
 //#endregion
-export { BuildReport, ReportTimings, TargetGroupReport };
+export { BuildReport, DiagnosticEntry, EmittedFile, PassReport, ReportTimings, TargetGroupReport };

package/report/tsdown-logger.js

@@ -0,0 +1,41 @@
+//#region src/report/tsdown-logger.ts
+const ANSI = new RegExp(`${String.fromCharCode(27)}\\[[0-9;]*m`, "g");
+const join = (args) => args.map((a) => String(a)).join(" ").replace(ANSI, "").trim();
+/**
+* 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.
+*/
+function createTsdownLogger(collector, groupId) {
+	const seenOnce = /* @__PURE__ */ new Set();
+	return {
+		level: "info",
+		info: () => {},
+		success: () => {},
+		clearScreen: () => {},
+		warn: (...args) => collector.recordWarning(groupId, {
+			source: "tsdown",
+			level: "warn",
+			text: join(args)
+		}),
+		warnOnce: (...args) => {
+			const text = join(args);
+			if (seenOnce.has(text)) return;
+			seenOnce.add(text);
+			collector.recordWarning(groupId, {
+				source: "tsdown",
+				level: "warn",
+				text
+			});
+		},
+		error: (...args) => collector.recordError(groupId, {
+			source: "tsdown",
+			level: "error",
+			text: join(args)
+		})
+	};
+}
+
+//#endregion
+export { createTsdownLogger };