@savvy-web/tsdown-plugins 0.7.0 → 0.9.0

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";
@@ -25,12 +28,15 @@ 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 { applySubdirMetaEntries, deriveExportPaths, runMetaPass } from "./meta/run-pass.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 { flattenIssues, serializeIssues, writeIssuesArtifact } from "./report/issues-artifact.js";
 import { EnvironmentDetector } from "./report/services/EnvironmentDetector.js";
 import { EnvironmentDetectorLive } from "./report/layers/EnvironmentDetectorLive.js";
 import { ExecutorResolver } from "./report/services/ExecutorResolver.js";
@@ -40,9 +46,7 @@ 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, resolveNextVersions, resolvePortableTsconfig, resolveTargets, rewriteMetaVersions, 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, 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 };

package/jsx/config.js

@@ -5,6 +5,7 @@ import { existsSync, readFileSync } from "node:fs";
 /**
 * 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
 */
 function resolveJsxConfig(tsconfig, override) {
 	if (override !== void 0) return override.runtime === "automatic" ? {
@@ -21,6 +22,7 @@ function resolveJsxConfig(tsconfig, override) {
 /**
 * Read the jsx-relevant compilerOptions from a package's own tsconfig.json (best-effort;
 * returns empty on absence or parse error).
+* @public
 */
 function readTsconfigJsx(cwd) {
 	const path = join(cwd, "tsconfig.json");

package/manifest/emit-manifest.js

@@ -4,7 +4,11 @@ import { join } from "node:path";
 import { readFile } from "node:fs/promises";
 
 //#region src/manifest/emit-manifest.ts
-/** 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
+*/
 async function buildEmittedManifest(options) {
 	const { pkg, targetGroup, devManifest, transform } = options;
 	const shouldResolve = targetGroup.isProd || devManifest === "resolve";
@@ -24,7 +28,11 @@ async function buildEmittedManifest(options) {
 		exeRewrite: options.exeRewrite
 	});
 }
-/** 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
+*/
 function emitManifest(options) {
 	const sourceDir = options.sourceDir;
 	return {

package/manifest/transform.js

@@ -21,7 +21,7 @@ const NON_PUBLISHED_FIELDS = [
 /**
 * 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
@@ -35,6 +35,7 @@ const NON_PUBLISHED_FIELDS = [
 * 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
 */
 function defaultManifestTransform({ pkg }) {
 	const out = { ...pkg };
@@ -91,6 +92,7 @@ const tsConditions = (exportKey, dual, subdirExports) => ({
 *
 * 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
 */
 function transformExports(exports, dual = false, subdirExports) {
 	if (typeof exports === "string") return isTs(exports) ? tsConditions(".", isDualKey(dual, "."), subdirExports) : exports;
@@ -108,7 +110,11 @@ function transformExports(exports, dual = false, subdirExports) {
 	}
 	return exports;
 }
-/** 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
+*/
 function transformBin(bin) {
 	if (typeof bin === "string") return isTs(bin) ? "bin/cli.js" : stripLeadingDotSlash(bin);
 	if (bin && typeof bin === "object") {
@@ -118,7 +124,11 @@ function transformBin(bin) {
 	}
 	return bin;
 }
-/** 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
+*/
 function normalizeBinPaths(bin) {
 	if (typeof bin === "string") return stripLeadingDotSlash(bin);
 	if (bin && typeof bin === "object") {
@@ -128,7 +138,11 @@ function normalizeBinPaths(bin) {
 	}
 	return bin;
 }
-/** Apply the full standard manifest transform (excluding catalog resolution, done upstream). */
+/**
+* Apply the full standard manifest transform (excluding catalog resolution, done upstream).
+*
+* @public
+*/
 function transformManifest(pkg, options = {}) {
 	const { publishConfig, scripts, ...rest } = pkg;
 	const isPrivate = !(publishConfig?.access === "public");

package/meta/api-extractor.js

@@ -7,6 +7,23 @@ import { TSDocConfigFile } from "@microsoft/tsdoc-config";
 
 //#region src/meta/api-extractor.ts
 const require_ = createRequire(import.meta.url);
+/** messageIds that become a hard build error in CI (they corrupt the .api.json). */
+const CI_FATAL_MESSAGE_IDS = /* @__PURE__ */ new Set(["ae-forgotten-export"]);
+/** 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.messageId !== void 0 ? { code: message.messageId } : {},
+		...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);
@@ -27,7 +44,15 @@ function runApiExtractor(options) {
 				tsdocMetadataFilePath: options.tsdocMetadataPath
 			} } : {},
 			dtsRollup: { enabled: false },
-			apiReport: { enabled: false }
+			apiReport: { enabled: false },
+			messages: {
+				extractorMessageReporting: {
+					default: { logLevel: "warning" },
+					"ae-internal-missing-underscore": { logLevel: "none" },
+					...options.ci === true ? Object.fromEntries([...CI_FATAL_MESSAGE_IDS].map((id) => [id, { logLevel: "error" }])) : {}
+				},
+				tsdocMessageReporting: { default: { logLevel: "warning" } }
+			}
 		},
 		packageJsonFullPath: options.packageJsonPath,
 		configObjectFullPath: void 0,
@@ -39,6 +64,10 @@ function runApiExtractor(options) {
 		showVerboseMessages: false,
 		messageCallback: (message) => {
 			if (suppressor.matches(message.messageId, message.text)) {
+				if (options.onSuppressed !== void 0) {
+					const entry = mapExtractorMessage(message);
+					if (entry !== void 0) options.onSuppressed(entry);
+				}
 				message.logLevel = ExtractorLogLevel.None;
 				message.handled = true;
 				return;
@@ -47,6 +76,17 @@ function runApiExtractor(options) {
 				message.logLevel = ExtractorLogLevel.None;
 				message.handled = true;
 			}
+			if (options.onMessage !== void 0) {
+				const entry = mapExtractorMessage(message);
+				if (entry !== void 0) {
+					const ciFatal = options.ci !== true && entry.level === "warn" && entry.code !== void 0 && CI_FATAL_MESSAGE_IDS.has(entry.code);
+					options.onMessage(ciFatal ? {
+						...entry,
+						ciFatal: true
+					} : entry);
+					message.handled = true;
+				}
+			}
 		}
 	});
 	if (!result.succeeded) throw new MetaGenerationError({

package/meta/config.js

@@ -4,7 +4,11 @@ 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. */
+/**
+* Fill defaults so downstream code never branches on undefined.
+*
+* @public
+*/
 function normalizeMetaOptions(meta, env = process.env) {
 	return {
 		localPaths: meta.localPaths ?? [],

package/meta/generate.js

@@ -16,9 +16,10 @@ function unscopedName(name) {
 * 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
 */
 async function generateMeta(options) {
-	const { cwd, packageName, tsconfigPath, dtsDir, entries, exportPaths, outMetaDir, localPaths, tsdoc, manifestTransform } = options;
+	const { cwd, packageName, tsconfigPath, dtsDir, entries, exportPaths, outMetaDir, localPaths, tsdoc, manifestTransform, onMessage, ci, onSuppressed } = options;
 	const tsdocConfigPath = writeTsdocConfig(cwd, tsdoc);
 	const packageJsonPath = join(cwd, "package.json");
 	mkdirSync(outMetaDir, { recursive: true });
@@ -41,7 +42,10 @@ async function generateMeta(options) {
 			tsdocConfigPath,
 			apiJsonPath: perEntryApiJson,
 			...isMain && !mainEntryDidTsdocMetadata ? { tsdocMetadataPath } : {},
-			suppressWarnings: tsdoc.suppressWarnings
+			suppressWarnings: tsdoc.suppressWarnings,
+			...ci !== void 0 ? { ci } : {},
+			...onMessage !== void 0 ? { onMessage } : {},
+			...onSuppressed !== void 0 ? { onSuppressed } : {}
 		});
 		if (isMain) mainEntryDidTsdocMetadata = true;
 		perEntryModels.set(entryName, JSON.parse(readFileSync(perEntryApiJson, "utf-8")));

package/meta/optimistic.js

@@ -10,6 +10,7 @@ const DEP_FIELDS = [
 * 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
 */
 function rewriteMetaVersions(pkg, versions, selfName) {
 	const out = { ...pkg };

package/meta/run-pass.js

@@ -0,0 +1,75 @@
+import { createEntryName } from "../entry/extract.js";
+import { resolveNextVersions } from "../changesets/next-versions.js";
+import { normalizeMetaOptions } from "./config.js";
+import { generateMeta } from "./generate.js";
+import { rewriteMetaVersions } from "./optimistic.js";
+import { join } from "node:path";
+
+//#region src/meta/run-pass.ts
+/**
+* Meta-pass orchestrator: derives export paths, filters bin/ entries, resolves optimistic
+* next-versions, and calls generateMeta once per publish group.
+* @public
+*/
+async function runMetaPass(o) {
+	const gen = o.generateMeta ?? generateMeta;
+	const norm = normalizeMetaOptions(o.meta);
+	const canonicalId = (o.groups.find((g) => g.name === o.packageName) ?? o.groups[0])?.id ?? "npm";
+	const dtsBasenames = {};
+	const nonBinEntries = {};
+	for (const [name, src] of Object.entries(o.entries)) if (!name.startsWith("bin/")) {
+		dtsBasenames[name] = name;
+		nonBinEntries[name] = src;
+	}
+	const exportPaths = deriveExportPaths(nonBinEntries, o.exportsMap);
+	applySubdirMetaEntries(o.overrides, dtsBasenames, exportPaths);
+	const resolveNext = o.resolveNextVersions ?? resolveNextVersions;
+	const nextVersions = norm.optimistic ? await resolveNext(o.cwd) : void 0;
+	const manifestTransform = nextVersions ? (m) => rewriteMetaVersions(m, nextVersions.versions, o.packageName) : void 0;
+	for (const g of o.groups) await gen({
+		cwd: o.cwd,
+		packageName: o.packageName,
+		tsconfigPath: o.tsconfigPath,
+		dtsDir: join(o.cwd, "dist", "prod", g.id, "pkg"),
+		entries: dtsBasenames,
+		exportPaths,
+		outMetaDir: join(o.cwd, "dist", "prod", g.id, "meta"),
+		localPaths: g.id === canonicalId ? norm.localPaths : [],
+		tsdoc: norm.tsdoc,
+		...manifestTransform !== void 0 ? { manifestTransform } : {},
+		ci: o.ci,
+		onMessage: (e) => e.level === "error" ? o.collector.recordError(g.id, e) : o.collector.recordWarning(g.id, e),
+		onSuppressed: (e) => o.collector.recordSuppressed(g.id, e)
+	});
+}
+/**
+* Map entry names to export paths using the package exports map. index maps to ".".
+*
+* @public
+*/
+function deriveExportPaths(entries, exportsMap) {
+	const out = {};
+	const sourceToKey = /* @__PURE__ */ new Map();
+	if (exportsMap) for (const [key, src] of Object.entries(exportsMap)) sourceToKey.set(src, key);
+	for (const [entryName, src] of Object.entries(entries)) out[entryName] = sourceToKey.get(src) ?? (entryName === "index" ? "." : `./${entryName}`);
+	return out;
+}
+/**
+* For each `outSubdir` override, point its meta entry at the isolated sub-package barrel.
+*
+* @public
+*/
+function applySubdirMetaEntries(overrides, dtsBasenames, exportPaths) {
+	if (overrides === void 0) return;
+	for (const ov of overrides) {
+		if (ov.outSubdir === void 0) continue;
+		const exportPath = ov.entries[0];
+		if (exportPath === void 0) continue;
+		const flatName = createEntryName(exportPath, false);
+		dtsBasenames[flatName] = `${ov.outSubdir}/index`;
+		exportPaths[flatName] = exportPath;
+	}
+}
+
+//#endregion
+export { applySubdirMetaEntries, deriveExportPaths, runMetaPass };

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,49 +131,49 @@ 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"]]);
-	/** Converts a {@link ScriptTarget} enum value to its string form (e.g. `es2023`). */
+	static NEW_LINE_MAP = /* @__PURE__ */ new Map([[NewLineKind.CarriageReturnLineFeed, "crlf"], [NewLineKind.LineFeed, "lf"]]);
+	/** Converts a `ScriptTarget` enum value to its string form (e.g. `es2023`). */
 	static convertScriptTarget(target) {
 		if (target === void 0) return void 0;
 		const mapped = TsconfigResolver.SCRIPT_TARGET_MAP.get(target);
 		if (mapped !== void 0) return mapped;
 		return `es${target}`;
 	}
-	/** 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) {
 		if (module === void 0) return void 0;
 		const mapped = TsconfigResolver.MODULE_KIND_MAP.get(module);
 		if (mapped !== void 0) return mapped;
 		return String(module);
 	}
-	/** 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) {
 		if (resolution === void 0) return void 0;
 		const mapped = TsconfigResolver.MODULE_RESOLUTION_MAP.get(resolution);
 		if (mapped !== void 0) return mapped;
 		return String(resolution);
 	}
-	/** 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) {
 		if (jsx === void 0) return void 0;
 		const mapped = TsconfigResolver.JSX_EMIT_MAP.get(jsx);
 		if (mapped !== void 0) return mapped;
 		return String(jsx);
 	}
-	/** 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) {
 		if (detection === void 0) return void 0;
 		const mapped = TsconfigResolver.MODULE_DETECTION_MAP.get(detection);
 		if (mapped !== void 0) return mapped;
 		return String(detection);
 	}
-	/** 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) {
 		if (newLine === void 0) return void 0;
 		const mapped = TsconfigResolver.NEW_LINE_MAP.get(newLine);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/tsdown-plugins",
-	"version": "0.7.0",
+	"version": "0.9.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",

package/report/collector.js

@@ -0,0 +1,141 @@
+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.
+* @public
+*/
+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: [],
+				suppressed: [],
+				seenPaths: /* @__PURE__ */ new Set(),
+				seenDiagnostics: /* @__PURE__ */ new Set(),
+				seenSuppressed: /* @__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));
+	}
+	recordSuppressed(groupId, entry) {
+		const g = this.group(groupId);
+		const key = diagnosticKey(entry);
+		if (g.seenSuppressed.has(key)) return;
+		g.seenSuppressed.add(key);
+		g.suppressed.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],
+				suppressed: [...g.suppressed],
+				timings: new ReportTimings({ totalMs })
+			}));
+		}
+		return [new BuildReport({
+			package: packageName,
+			targetGroups
+		})];
+	}
+};
+function diagnosticKey(input) {
+	return [
+		input.source,
+		input.level,
+		input.code ?? "",
+		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.code !== void 0 ? { code: input.code } : {},
+		...input.ciFatal !== void 0 ? { ciFatal: input.ciFatal } : {},
+		...input.file !== void 0 ? { file: input.file } : {},
+		...input.line !== void 0 ? { line: input.line } : {},
+		...input.column !== void 0 ? { column: input.column } : {}
+	});
+}
+/** @public */
+var BuildCollectorTag = class extends Context.Tag("@savvy-web/tsdown-plugins/BuildCollector")() {};
+
+//#endregion
+export { BuildCollector, BuildCollectorTag };

package/report/formatters/ci-annotations.js

@@ -1,12 +1,19 @@
 //#region src/report/formatters/ci-annotations.ts
 const esc = (s) => s.replace(/%/g, "%25").replace(/\r/g, "%0D").replace(/\n/g, "%0A");
+/** @public */
 const CiAnnotationsFormatter = {
 	format: "ci-annotations",
 	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/diagnostics.js

@@ -0,0 +1,23 @@
+//#region src/report/formatters/diagnostics.ts
+/** "code ×N, code2 ×M", sorted by count desc then code asc. */
+function suppressedSummary(entries) {
+	const counts = /* @__PURE__ */ new Map();
+	for (const e of entries) {
+		const code = e.code ?? "unknown";
+		counts.set(code, (counts.get(code) ?? 0) + 1);
+	}
+	return [...counts.entries()].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).map(([code, n]) => `${code} ×${n}`).join(", ");
+}
+/** Number of warnings flagged ci-fatal across every group of a package. */
+function ciFatalCountForPackage(report) {
+	let n = 0;
+	for (const g of report.targetGroups) for (const w of g.warnings) if (w.ciFatal === true) n += 1;
+	return n;
+}
+/** The persuasive callout shown when ci-fatal warnings are present locally. */
+function ciFatalCallout(n) {
+	return `⛔ ${n} ${n === 1 ? "issue" : "issues"} here ${n === 1 ? "becomes" : "become"} a hard error in CI and will fail the build. Fix before pushing.`;
+}
+
+//#endregion
+export { ciFatalCallout, ciFatalCountForPackage, suppressedSummary };

package/report/formatters/json.js

@@ -1,4 +1,5 @@
 //#region src/report/formatters/json.ts
+/** @public */
 const JsonFormatter = {
 	format: "json",
 	render: (reports) => [{