@savvy-web/tsdown-plugins 0.7.0 → 0.9.0

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}`);
-				}
-			} 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,20 +1,49 @@
 import { formatTime } from "../timer.js";
+import { ciFatalCallout, ciFatalCountForPackage, suppressedSummary } from "./diagnostics.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();
+};
+/** @public */
 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) {
+					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) {
+			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 === "" ? [] : [{

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

package/report/layers/FormatSelectorLive.js

@@ -2,6 +2,7 @@ import { FormatSelector } from "../services/FormatSelector.js";
 import { Effect, Layer } from "effect";
 
 //#region src/report/layers/FormatSelectorLive.ts
+/** @public */
 const FormatSelectorLive = Layer.succeed(FormatSelector, { select: (executor, explicit, env) => Effect.succeed(explicit ?? (env === "ci-github" && executor === "ci" ? "ci-annotations" : executor === "agent" ? "markdown" : executor === "ci" ? "json" : "terminal")) });
 
 //#endregion

package/report/layers/OutputRendererLive.js

@@ -7,13 +7,14 @@ 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],
 	["ci-annotations", CiAnnotationsFormatter],
 	["silent", SilentFormatter]
 ]);
+/** @public */
 const OutputRendererLive = Layer.succeed(OutputRenderer, { render: (reports, format, ctx) => Effect.sync(() => {
 	const f = formatters.get(format);
 	return f ? f.render(reports, ctx) : [];

package/report/metrics-plugin.js

@@ -0,0 +1,63 @@
+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`.
+* @public
+*/
+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

@@ -9,7 +9,9 @@ import { OutputRendererLive } from "./layers/OutputRendererLive.js";
 import { Effect, Layer } from "effect";
 
 //#region src/report/pipeline.ts
+/** @public */
 const ReportPipelineLive = Layer.mergeAll(EnvironmentDetectorLive, ExecutorResolverLive, FormatSelectorLive, OutputRendererLive);
+/** @public */
 const renderReport = (reports, options) => Effect.gen(function* () {
 	const detector = yield* EnvironmentDetector;
 	const executorResolver = yield* ExecutorResolver;
@@ -18,7 +20,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,61 @@
 import { Schema } from "effect";
 
 //#region src/report/schema.ts
-const ReportTimings = Schema.Struct({ totalMs: Schema.Number }).annotations({ identifier: "ReportTimings" });
-const TargetGroupReport = Schema.Struct({
+/** @public */
+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.
+*
+* @public
+*/
+var DiagnosticEntry = class extends Schema.Class("DiagnosticEntry")({
+	source: Schema.Literal("tsdown", "rolldown", "api-extractor"),
+	level: Schema.Literal("warn", "error"),
+	text: Schema.String,
+	/** API Extractor messageId (e.g. "ae-forgotten-export"); used to group suppressed messages by type. */
+	code: Schema.optional(Schema.String),
+	/** True when shown as `warn` locally but a hard error in CI (drives the "[fails CI]" nudge). */
+	ciFatal: Schema.optional(Schema.Boolean),
+	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).
+*
+* @public
+*/
+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).
+*
+* @public
+*/
+var PassReport = class extends Schema.Class("PassReport")({
+	id: Schema.Literal("js", "dts", "loose", "exe", "meta"),
+	files: Schema.Array(EmittedFile),
+	ms: Schema.Number
+}) {};
+/** @public */
+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),
+	/** Messages matched by `suppressWarnings`, kept for accounting and `--verbose` expansion. */
+	suppressed: Schema.Array(DiagnosticEntry),
+	timings: ReportTimings
+}) {};
+/** @public */
+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/services/EnvironmentDetector.js

@@ -1,6 +1,7 @@
 import { Context } from "effect";
 
 //#region src/report/services/EnvironmentDetector.ts
+/** @public */
 var EnvironmentDetector = class extends Context.Tag("@savvy-web/tsdown-plugins/EnvironmentDetector")() {};
 
 //#endregion

package/report/services/ExecutorResolver.js

@@ -1,6 +1,7 @@
 import { Context } from "effect";
 
 //#region src/report/services/ExecutorResolver.ts
+/** @public */
 var ExecutorResolver = class extends Context.Tag("@savvy-web/tsdown-plugins/ExecutorResolver")() {};
 
 //#endregion

package/report/services/FormatSelector.js

@@ -1,6 +1,7 @@
 import { Context } from "effect";
 
 //#region src/report/services/FormatSelector.ts
+/** @public */
 var FormatSelector = class extends Context.Tag("@savvy-web/tsdown-plugins/FormatSelector")() {};
 
 //#endregion

package/report/services/OutputRenderer.js

@@ -1,6 +1,7 @@
 import { Context } from "effect";
 
 //#region src/report/services/OutputRenderer.ts
+/** @public */
 var OutputRenderer = class extends Context.Tag("@savvy-web/tsdown-plugins/OutputRenderer")() {};
 
 //#endregion

package/report/timer.js

@@ -1,8 +1,13 @@
 //#region src/report/timer.ts
+/** @public */
 function formatTime(ms) {
 	return ms < 1e3 ? `${Math.round(ms)}ms` : `${(ms / 1e3).toFixed(2)}s`;
 }
-/** Create a wall-clock timer. (Date.now is fine in runtime build code.) */
+/**
+* Create a wall-clock timer. (Date.now is fine in runtime build code.)
+*
+* @public
+*/
 function createTimer(now = Date.now) {
 	const start = now();
 	return {

package/report/tsdown-logger.js

@@ -0,0 +1,42 @@
+//#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.
+* @public
+*/
+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 };

package/targets/binding.js

@@ -2,7 +2,11 @@ import { join } from "node:path";
 import { mkdirSync, writeFileSync } from "node:fs";
 
 //#region src/targets/binding.ts
-/** Write the target-to-group binding to dist/prod/targets.json for the release action to consume. Returns the path. */
+/**
+* Write the target-to-group binding to dist/prod/targets.json for the release action to consume. Returns the path.
+*
+* @public
+*/
 function writeTargetsBinding(cwd, resolution) {
 	const dir = join(cwd, "dist", "prod");
 	mkdirSync(dir, { recursive: true });

package/targets/config.js

@@ -1,5 +1,9 @@
 //#region src/targets/config.ts
-/** True when a target value is the object form (carries registry/name/from). */
+/**
+* True when a target value is the object form (carries registry/name/from).
+*
+* @public
+*/
 function isTargetObject(value) {
 	return typeof value === "object" && value !== null;
 }

package/targets/resolve-targets.js

@@ -7,7 +7,11 @@ const DEFAULT_REGISTRIES = {
 	npm: "https://registry.npmjs.org",
 	github: "https://npm.pkg.github.com"
 };
-/** Resolve a `publishConfig.targets` map into the distinct groups to build and every target bound to one. Pure; throws ConfigValidationError on structurally-invalid config. */
+/**
+* Resolve a `publishConfig.targets` map into the distinct groups to build and every target bound to one. Pure; throws ConfigValidationError on structurally-invalid config.
+*
+* @public
+*/
 function resolveTargets(options) {
 	const { targets, baseName } = options;
 	const ids = Object.keys(targets);

package/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.58.9"
+    }
+  ]
+}

package/report/schema-export.js

@@ -1,18 +0,0 @@
-import { BuildReport } from "./schema.js";
-import { Effect } from "effect";
-import { JsonSchemaExporter } from "json-schema-effect";
-
-//#region src/report/schema-export.ts
-const SCHEMA_ID = "https://savvyweb.systems/schemas/build-report.schema.json";
-/** Generate the SchemaStore-compatible JSON Schema document for BuildReport. */
-const generateBuildReportSchema = () => Effect.gen(function* () {
-	return yield* (yield* JsonSchemaExporter).generate({
-		name: "build-report",
-		schema: BuildReport,
-		rootDefName: "BuildReport",
-		$id: SCHEMA_ID
-	});
-}).pipe(Effect.provide(JsonSchemaExporter.Live));
-
-//#endregion
-export { generateBuildReportSchema };