@savvy-web/tsdown-plugins 0.8.0 → 0.9.0

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

@@ -14,6 +14,7 @@ const formatters = /* @__PURE__ */ new Map([
 	["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

@@ -16,6 +16,7 @@ function byteLength(content) {
 * 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 {

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;

package/report/schema.js

@@ -1,36 +1,57 @@
 import { Schema } from "effect";
 
 //#region src/report/schema.ts
+/** @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. */
+/**
+* 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). */
+/**
+* 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). */
+/**
+* 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),
 	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)

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

@@ -6,6 +6,7 @@ const join = (args) => args.map((a) => String(a)).join(" ").replace(ANSI, "").tr
 * 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();

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 };