@savvy-web/tsdown-plugins 0.8.0 → 0.9.1

package/index.js

@@ -28,6 +28,7 @@ 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";
@@ -35,6 +36,7 @@ import { JsonFormatter } from "./report/formatters/json.js";
 import { MarkdownFormatter } from "./report/formatters/markdown.js";
 import { SilentFormatter } from "./report/formatters/silent.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";
@@ -44,8 +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 { generateBuildReportSchema } from "./report/schema-export.js";
 import { writeTargetsBinding } from "./targets/binding.js";
 import { CatalogAssemblyError, CatalogResolutionError } from "workspaces-effect";
 
-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 };
+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,8 @@ 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;
@@ -16,6 +18,7 @@ function mapExtractorMessage(message) {
 		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 } : {}
@@ -41,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,
@@ -53,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;
@@ -64,7 +79,11 @@ function runApiExtractor(options) {
 			if (options.onMessage !== void 0) {
 				const entry = mapExtractorMessage(message);
 				if (entry !== void 0) {
-					options.onMessage(entry);
+					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;
 				}
 			}

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, onMessage } = 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 });
@@ -42,7 +43,9 @@ async function generateMeta(options) {
 			apiJsonPath: perEntryApiJson,
 			...isMain && !mainEntryDidTsdocMetadata ? { tsdocMetadataPath } : {},
 			suppressWarnings: tsdoc.suppressWarnings,
-			...onMessage !== void 0 ? { onMessage } : {}
+			...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

@@ -138,42 +138,42 @@ var TsconfigResolver = class TsconfigResolver {
 	]);
 	/** @internal */
 	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`). */
+	/** 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.8.0",
+	"version": "0.9.1",
 	"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

@@ -6,6 +6,7 @@ import { Context } from "effect";
 * 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();
@@ -18,8 +19,10 @@ var BuildCollector = class {
 				passes: /* @__PURE__ */ new Map(),
 				warnings: [],
 				errors: [],
+				suppressed: [],
 				seenPaths: /* @__PURE__ */ new Set(),
-				seenDiagnostics: /* @__PURE__ */ new Set()
+				seenDiagnostics: /* @__PURE__ */ new Set(),
+				seenSuppressed: /* @__PURE__ */ new Set()
 			};
 			this.groups.set(groupId, g);
 		}
@@ -67,6 +70,13 @@ var BuildCollector = class {
 		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()) {
@@ -91,6 +101,7 @@ var BuildCollector = class {
 				passes,
 				warnings: [...g.warnings],
 				errors: [...g.errors],
+				suppressed: [...g.suppressed],
 				timings: new ReportTimings({ totalMs })
 			}));
 		}
@@ -104,6 +115,7 @@ function diagnosticKey(input) {
 	return [
 		input.source,
 		input.level,
+		input.code ?? "",
 		input.text,
 		input.file ?? "",
 		String(input.line ?? ""),
@@ -115,11 +127,14 @@ function toEntry(input) {
 		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

package/report/formatters/ci-annotations.js

@@ -1,5 +1,6 @@
 //#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) => {

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) => [{

package/report/formatters/markdown.js

@@ -1,17 +1,27 @@
+import { ciFatalCallout, ciFatalCountForPackage, suppressedSummary } from "./diagnostics.js";
+
 //#region src/report/formatters/markdown.ts
+/** @public */
 const MarkdownFormatter = {
 	format: "markdown",
-	render: (reports) => {
+	render: (reports, ctx) => {
 		const lines = [];
 		for (const r of reports) {
-			const failing = r.targetGroups.filter((g) => g.errors.length > 0);
-			if (failing.length > 0) {
-				lines.push(`## ❌ ${r.package}`);
-				for (const g of failing) {
-					lines.push(`- **${g.id}**`);
-					for (const e of g.errors) lines.push(`  - ${e.text}`);
-				}
-			} else lines.push(`## ✅ ${r.package}`);
+			const hasErrors = r.targetGroups.some((g) => g.errors.length > 0);
+			const hasWarnings = r.targetGroups.some((g) => g.warnings.length > 0);
+			const hasSuppressed = r.targetGroups.some((g) => g.suppressed.length > 0);
+			const icon = hasErrors ? "❌" : hasWarnings || hasSuppressed ? "⚠️" : "✅";
+			lines.push(`## ${icon} ${r.package}`);
+			for (const g of r.targetGroups) {
+				if (g.errors.length === 0 && g.warnings.length === 0 && g.suppressed.length === 0) continue;
+				lines.push(`- **${g.id}**`);
+				for (const e of g.errors) lines.push(`  - ❌ ${e.text}`);
+				for (const w of g.warnings) lines.push(`  - ⚠️ ${w.text}${w.ciFatal === true ? " [fails CI]" : ""}`);
+				if (g.suppressed.length > 0) if (ctx.verbose) for (const s of g.suppressed) lines.push(`  - 🔇 ${s.code ?? "?"}: ${s.text}`);
+				else lines.push(`  - 🔇 suppressed ${g.suppressed.length}: ${suppressedSummary(g.suppressed)}`);
+			}
+			const fatal = ciFatalCountForPackage(r);
+			if (fatal > 0) lines.push(`> ${ciFatalCallout(fatal)}`);
 		}
 		return [{
 			target: "stdout",

package/report/formatters/silent.js

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

package/report/formatters/terminal.js

@@ -1,4 +1,5 @@
 import { formatTime } from "../timer.js";
+import { ciFatalCallout, ciFatalCountForPackage, suppressedSummary } from "./diagnostics.js";
 import pc from "picocolors";
 
 //#region src/report/formatters/terminal.ts
@@ -7,6 +8,7 @@ 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();
 };
+/** @public */
 const TerminalFormatter = {
 	format: "terminal",
 	render: (reports, ctx) => {
@@ -27,8 +29,15 @@ const TerminalFormatter = {
 					}
 				}
 				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)}`);
+				for (const w of g.warnings) {
+					const tag = w.ciFatal === true ? color(pc.red, " [fails CI]") : "";
+					lines.push(`    ${color(pc.yellow, "warn")} ${diagLine(w)}${tag}`);
+				}
+				if (g.suppressed.length > 0) if (ctx.verbose) for (const s of g.suppressed) lines.push(`    ${color(pc.dim, `suppressed ${s.code ?? "?"}`)} ${diagLine(s)}`);
+				else lines.push(`    ${color(pc.dim, `suppressed ${g.suppressed.length}: ${suppressedSummary(g.suppressed)}`)}`);
 			}
+			const fatal = ciFatalCountForPackage(r);
+			if (fatal > 0) lines.push(`  ${color(pc.red, ciFatalCallout(fatal))}`);
 		}
 		const pkgs = reports.length;
 		if (pkgs > 0) {

package/report/issues-artifact.js

@@ -0,0 +1,88 @@
+import { dirname, join } from "node:path";
+import { mkdirSync, writeFileSync } from "node:fs";
+
+//#region src/report/issues-artifact.ts
+/** Copy a DiagnosticEntry to a plain object, omitting undefined optionals for stable output. */
+function toPlain(d) {
+	const out = {
+		source: d.source,
+		level: d.level,
+		text: d.text
+	};
+	if (d.code !== void 0) out.code = d.code;
+	if (d.ciFatal !== void 0) out.ciFatal = d.ciFatal;
+	if (d.file !== void 0) out.file = d.file;
+	if (d.line !== void 0) out.line = d.line;
+	if (d.column !== void 0) out.column = d.column;
+	return out;
+}
+/** De-duplicate by the identity-bearing fields (registry target-groups carry identical diagnostics). */
+function dedupe(entries) {
+	const seen = /* @__PURE__ */ new Set();
+	const out = [];
+	for (const e of entries) {
+		const key = JSON.stringify([
+			e.source,
+			e.level,
+			e.code ?? "",
+			e.text,
+			e.file ?? "",
+			e.line ?? -1,
+			e.column ?? -1
+		]);
+		if (seen.has(key)) continue;
+		seen.add(key);
+		out.push(e);
+	}
+	return out;
+}
+/**
+* Flatten a build snapshot into the aggregated, de-duplicated issues artifact. Pure.
+*
+* @public
+*/
+function flattenIssues(reports, opts) {
+	const warnings = [];
+	const errors = [];
+	const suppressed = [];
+	for (const report of reports) for (const g of report.targetGroups) {
+		for (const w of g.warnings) warnings.push(toPlain(w));
+		for (const e of g.errors) errors.push(toPlain(e));
+		for (const s of g.suppressed) suppressed.push(toPlain(s));
+	}
+	return {
+		generatedAt: opts.generatedAt,
+		package: reports[0]?.package ?? "unknown",
+		target: opts.target,
+		warnings: dedupe(warnings),
+		errors: dedupe(errors),
+		suppressed: dedupe(suppressed)
+	};
+}
+/**
+* Serialize the issues artifact to pretty JSON with a trailing newline.
+*
+* @public
+*/
+function serializeIssues(issues) {
+	return `${JSON.stringify(issues, null, 2)}\n`;
+}
+/**
+* Write the aggregated issues artifact to `<cwd>/dist/<target>/issues.json`. Returns the path written.
+*
+* @public
+*/
+function writeIssuesArtifact(opts) {
+	const clock = opts.now ?? (() => /* @__PURE__ */ new Date());
+	const issues = flattenIssues(opts.reports, {
+		target: opts.target,
+		generatedAt: clock().toISOString()
+	});
+	const outPath = join(opts.cwd, "dist", opts.target, "issues.json");
+	mkdirSync(dirname(outPath), { recursive: true });
+	writeFileSync(outPath, serializeIssues(issues), "utf8");
+	return outPath;
+}
+
+//#endregion
+export { flattenIssues, serializeIssues, writeIssuesArtifact };

package/report/layers/EnvironmentDetectorLive.js

@@ -4,6 +4,7 @@ import { isAgent, isCI } from "std-env";
 
 //#region src/report/layers/EnvironmentDetectorLive.ts
 const isGitHub = () => process.env.GITHUB_ACTIONS === "true" || process.env.GITHUB_ACTIONS === "1";
+/** @public */
 const EnvironmentDetectorLive = Layer.succeed(EnvironmentDetector, { detect: () => Effect.sync(() => {
 	if (isAgent) return "agent-shell";
 	if (isGitHub()) return "ci-github";

package/report/layers/ExecutorResolverLive.js

@@ -2,6 +2,7 @@ import { ExecutorResolver } from "../services/ExecutorResolver.js";
 import { Effect, Layer } from "effect";
 
 //#region src/report/layers/ExecutorResolverLive.ts
+/** @public */
 const ExecutorResolverLive = Layer.succeed(ExecutorResolver, { resolve: (env) => Effect.succeed(env === "agent-shell" ? "agent" : env === "terminal" ? "human" : "ci") });
 
 //#endregion