@savvy-web/tsdown-plugins 2.9.3 → 2.10.0

package/meta/generate.js

@@ -10,7 +10,7 @@ import { join } from "node:path";
 import { Effect } from "effect";
 import { TSDOCTOR_MANIFEST_FILENAME, encodeBundleManifest } from "@tsdoctor/manifest";
 
-//#region src/meta/generate.ts
+// src/meta/generate.ts
 function unscopedName(name) {
 	const slash = name.lastIndexOf("/");
 	return slash >= 0 ? name.slice(slash + 1) : name;
@@ -55,12 +55,19 @@ async function generateMeta(options) {
 		...e.code !== void 0 ? { code: e.code } : {},
 		...e.ciFatal !== void 0 ? { ciFatal: e.ciFatal } : {}
 	});
+	const exportPathFor = (entryName) => exportPaths[entryName] ?? (entryName === "index" ? "." : `./${entryName}`);
+	const selfReferencePaths = {};
+	if (splitDiagnostics) for (const name of entryNames) {
+		const exportPath = exportPathFor(name);
+		const specifier = exportPath === "." ? packageName : packageName + exportPath.slice(1);
+		selfReferencePaths[specifier] = [join(aeInputDir, `${entries[name]}.d.ts`)];
+	}
 	for (const entryName of entryNames) {
 		const modelEntryDts = join(dtsDir, `${entries[entryName]}.d.ts`);
 		const safeEntry = entryName.replace(/[\\/]/g, "__");
 		const perEntryApiJson = join(outMetaDir, `${safeEntry}.entry.api.json`);
 		intermediateApiJsons.push(perEntryApiJson);
-		const isMain = (exportPaths[entryName] ?? (entryName === "index" ? "." : `./${entryName}`)) === ".";
+		const isMain = exportPathFor(entryName) === ".";
 		const captureRollupOnlyFatal = splitDiagnostics && onMessage !== void 0 && ci !== true;
 		const rollupFatal = [];
 		const runBReported = /* @__PURE__ */ new Set();
@@ -98,6 +105,7 @@ async function generateMeta(options) {
 					tsdocConfigPath,
 					apiJsonPath: perEntryApiJson,
 					emitDocModel: false,
+					selfReferencePaths,
 					suppressWarnings: tsdoc.suppressWarnings,
 					...runBOnMessage !== void 0 ? { onMessage: runBOnMessage } : {},
 					...onSuppressed !== void 0 ? { onSuppressed } : {}
@@ -106,6 +114,7 @@ async function generateMeta(options) {
 				if (onMessage !== void 0) onMessage({
 					source: "api-extractor",
 					level: "warn",
+					code: "diagnostics-harvest-failed",
 					text: `Could not harvest per-module source locations for "${entryName}": ${String(err)}`
 				});
 			}
@@ -208,5 +217,4 @@ async function generateMeta(options) {
 	};
 }
 
-//#endregion
 export { generateMeta };

package/meta/merge-models.js

@@ -1,4 +1,4 @@
-//#region src/meta/merge-models.ts
+// src/meta/merge-models.ts
 /** Rewrite every nested member canonicalReference that starts with originalPrefix to use newPrefix. Skips the EntryPoint node itself. */
 function rewriteCanonicalReferences(node, originalPrefix, newPrefix) {
 	if (!node || typeof node !== "object") return;
@@ -40,5 +40,4 @@ function mergeApiModels(options) {
 	return merged;
 }
 
-//#endregion
 export { mergeApiModels };

package/meta/message-suppressor.js

@@ -1,4 +1,4 @@
-//#region src/meta/message-suppressor.ts
+// src/meta/message-suppressor.ts
 function compileRule(rule) {
 	if (rule.pattern === void 0) return {
 		messageId: rule.messageId,
@@ -33,5 +33,4 @@ function createMessageSuppressor(rules) {
 	} };
 }
 
-//#endregion
 export { createMessageSuppressor };

package/meta/og-image.js

@@ -4,7 +4,7 @@ import { Data, Effect, Layer, Option, Result, Schema } from "effect";
 import * as NodeServices from "@effect/platform-node/NodeServices";
 import { ImageBackend, ImageCache, ImageCacheKey } from "@effected/images/cache";
 
-//#region src/meta/og-image.ts
+// src/meta/og-image.ts
 /**
 * A configured `openGraph.generate` renderer threw, returned no bytes, or returned bytes that are
 * not an image. Fails the build: a half-written OG image is worse than none.
@@ -103,5 +103,4 @@ async function writeGeneratedOgImage(options) {
 	};
 }
 
-//#endregion
 export { OgGenerateError, resolveOgCacheSalt, writeGeneratedOgImage };

package/meta/optimistic.js

@@ -1,4 +1,4 @@
-//#region src/meta/optimistic.ts
+// src/meta/optimistic.ts
 /** Dependency map fields whose workspace-sibling versions get the optimistic bump. */
 const DEP_FIELDS = [
 	"dependencies",
@@ -29,5 +29,4 @@ function rewriteMetaVersions(pkg, versions, selfName) {
 	return out;
 }
 
-//#endregion
 export { rewriteMetaVersions };

package/meta/run-pass.js

@@ -9,7 +9,7 @@ import { rewriteMetaVersions } from "./optimistic.js";
 import { TsdoctorSourceError, loadTsdoctorSources } from "./tsdoctor-source.js";
 import { join } from "node:path";
 
-//#region src/meta/run-pass.ts
+// 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.
@@ -125,5 +125,4 @@ function applySubdirMetaEntries(overrides, dtsBasenames, exportPaths) {
 	}
 }
 
-//#endregion
 export { applySubdirMetaEntries, deriveExportPaths, runMetaPass };

package/meta/tsconfig-resolver.js

@@ -3,7 +3,7 @@ import { existsSync } from "node:fs";
 import * as nodePath from "node:path";
 import { PortableTsconfig, TsconfigLoaderSync } from "@effected/tsconfig-json";
 
-//#region src/meta/tsconfig-resolver.ts
+// src/meta/tsconfig-resolver.ts
 /**
 * JSON schema URL for tsconfig.json files.
 * @internal
@@ -52,5 +52,4 @@ function resolvePortableTsconfig(cwd, fallbackConfigPath) {
 	}
 }
 
-//#endregion
 export { resolvePortableTsconfig };

package/meta/tsdoc-config.js

@@ -3,7 +3,7 @@ import { join } from "node:path";
 import { isDeepStrictEqual } from "node:util";
 import { StandardTags } from "@microsoft/tsdoc";
 
-//#region src/meta/tsdoc-config.ts
+// src/meta/tsdoc-config.ts
 const TSDOC_SCHEMA = "https://developer.microsoft.com/json-schemas/tsdoc/v0/tsdoc.schema.json";
 const SYNTAX_KIND_MAP = {
 	block: "block",
@@ -44,5 +44,4 @@ function writeTsdocConfig(cwd, tsdoc) {
 	return path;
 }
 
-//#endregion
 export { buildTsdocConfig, writeTsdocConfig };

package/meta/tsdoctor-manifest.js

@@ -1,6 +1,6 @@
 import { MANIFEST_SPEC } from "@tsdoctor/manifest";
 
-//#region src/meta/tsdoctor-manifest.ts
+// src/meta/tsdoctor-manifest.ts
 const first = (...values) => values.find((v) => v !== void 0);
 /**
 * `owner/repo` from any of the GitHub URL spellings a `repository.url` carries (https, `git+https`,
@@ -131,5 +131,4 @@ function ogImageInfoOf(input) {
 	};
 }
 
-//#endregion
 export { composeTsdoctorManifest, githubOwnerRepo, ogImageInfoOf, registriesFromTargets };

package/meta/tsdoctor-source.js

@@ -6,7 +6,7 @@ import * as NodePath from "@effect/platform-node/NodePath";
 import { WorkspaceDiscovery, WorkspaceRootNotFoundError, Workspaces } from "@effected/workspaces";
 import { TSDOCTOR_MANIFEST_FILENAME, decodeManifestSource } from "@tsdoctor/manifest";
 
-//#region src/meta/tsdoctor-source.ts
+// src/meta/tsdoctor-source.ts
 /**
 * A present `tsdoctor.json` source file that could not be parsed or decoded. Absence is never
 * this error — a missing source tier is the normal case.
@@ -90,5 +90,4 @@ async function loadTsdoctorSources(cwd) {
 	};
 }
 
-//#endregion
 export { TsdoctorSourceError, loadTsdoctorSources };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/tsdown-plugins",
-	"version": "2.9.3",
+	"version": "2.10.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",
@@ -30,24 +30,24 @@
 	},
 	"dependencies": {
 		"@changesets/get-release-plan": "^5.0.2",
-		"@effect/platform-node": "^4.0.4",
-		"@effected/glob": "^0.12.0",
-		"@effected/images": "^0.3.0",
-		"@effected/jsonc": "^0.17.0",
-		"@effected/npm": "^0.22.0",
-		"@effected/package-json": "^0.22.0",
-		"@effected/semver": "^0.13.0",
-		"@effected/tsconfig-json": "^0.15.0",
-		"@effected/walker": "^0.17.0",
-		"@effected/workspaces": "^0.34.0",
+		"@effect/platform-node": "^4.0.6",
+		"@effected/glob": "^0.14.0",
+		"@effected/images": "^0.5.0",
+		"@effected/jsonc": "^0.19.0",
+		"@effected/npm": "^0.25.0",
+		"@effected/package-json": "^0.24.1",
+		"@effected/semver": "^0.15.0",
+		"@effected/tsconfig-json": "^0.17.0",
+		"@effected/walker": "^0.19.0",
+		"@effected/workspaces": "^0.36.1",
 		"@microsoft/api-extractor": "7.59.1",
 		"@microsoft/tsdoc": "~0.16.0",
 		"@microsoft/tsdoc-config": "0.18.1",
-		"@tsdoctor/manifest": "^0.2.8",
-		"effect": "^4.0.4",
+		"@tsdoctor/manifest": "^0.2.10",
+		"effect": "^4.0.6",
 		"picocolors": "^1.1.1",
 		"std-env": "^4.3.0",
-		"tsdown": "^0.23.0",
+		"tsdown": "^0.23.1",
 		"typescript": "^6.0.3"
 	}
 }

package/report/collector.js

@@ -1,7 +1,7 @@
 import { BuildReport, DiagnosticEntry, EmittedFile, PassReport, ReportTimings, TargetGroupReport } from "./schema.js";
 import { Context } from "effect";
 
-//#region src/report/collector.ts
+// 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).
@@ -137,5 +137,4 @@ function toEntry(input) {
 /** @public */
 var BuildCollectorTag = class extends Context.Service()("@savvy-web/tsdown-plugins/BuildCollector") {};
 
-//#endregion
 export { BuildCollector, BuildCollectorTag };

package/report/formatters/ci-annotations.js

@@ -1,4 +1,4 @@
-//#region src/report/formatters/ci-annotations.ts
+// src/report/formatters/ci-annotations.ts
 const esc = (s) => s.replace(/%/g, "%25").replace(/\r/g, "%0D").replace(/\n/g, "%0A");
 /** @public */
 const CiAnnotationsFormatter = {
@@ -23,5 +23,4 @@ const CiAnnotationsFormatter = {
 	}
 };
 
-//#endregion
 export { CiAnnotationsFormatter };

package/report/formatters/diagnostics.js

@@ -1,4 +1,4 @@
-//#region src/report/formatters/diagnostics.ts
+// src/report/formatters/diagnostics.ts
 /** "code ×N, code2 ×M", sorted by count desc then code asc. */
 function suppressedSummary(entries) {
 	const counts = /* @__PURE__ */ new Map();
@@ -19,5 +19,4 @@ 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,4 @@
-//#region src/report/formatters/json.ts
+// src/report/formatters/json.ts
 /** @public */
 const JsonFormatter = {
 	format: "json",
@@ -9,5 +9,4 @@ const JsonFormatter = {
 	}]
 };
 
-//#endregion
 export { JsonFormatter };

package/report/formatters/markdown.js

@@ -1,6 +1,6 @@
 import { ciFatalCallout, ciFatalCountForPackage, suppressedSummary } from "./diagnostics.js";
 
-//#region src/report/formatters/markdown.ts
+// src/report/formatters/markdown.ts
 /** @public */
 const MarkdownFormatter = {
 	format: "markdown",
@@ -33,5 +33,4 @@ const MarkdownFormatter = {
 	}
 };
 
-//#endregion
 export { MarkdownFormatter };

package/report/formatters/silent.js

@@ -1,9 +1,8 @@
-//#region src/report/formatters/silent.ts
+// src/report/formatters/silent.ts
 /** @public */
 const SilentFormatter = {
 	format: "silent",
 	render: () => []
 };
 
-//#endregion
 export { SilentFormatter };

package/report/formatters/terminal.js

@@ -2,7 +2,7 @@ import { formatTime } from "../timer.js";
 import { ciFatalCallout, ciFatalCountForPackage, suppressedSummary } from "./diagnostics.js";
 import pc from "picocolors";
 
-//#region src/report/formatters/terminal.ts
+// 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) => {
@@ -56,5 +56,4 @@ const TerminalFormatter = {
 	}
 };
 
-//#endregion
 export { TerminalFormatter };

package/report/issues-artifact.js

@@ -1,7 +1,7 @@
 import { mkdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 
-//#region src/report/issues-artifact.ts
+// src/report/issues-artifact.ts
 /** Copy a DiagnosticEntry to a plain object, omitting undefined optionals for stable output. */
 function toPlain(d) {
 	const out = {
@@ -114,5 +114,4 @@ function writeIssuesArtifact(opts) {
 	return outPath;
 }
 
-//#endregion
 export { flattenIssues, serializeIssues, writeIssuesArtifact };

package/report/metrics-plugin.js

@@ -1,6 +1,6 @@
 import { gzipSync } from "node:zlib";
 
-//#region src/report/metrics-plugin.ts
+// src/report/metrics-plugin.ts
 function contentOf(chunk) {
 	const c = chunk;
 	if (c.type === "chunk") return c.code;
@@ -73,5 +73,4 @@ function buildMetricsPlugin(collector, groupId, pass, verbose, suppressMixedExpo
 	};
 }
 
-//#endregion
 export { buildMetricsPlugin };

package/report/pipeline.js

@@ -4,7 +4,7 @@ import { FormatSelector } from "./services/FormatSelector.js";
 import { OutputRenderer } from "./services/OutputRenderer.js";
 import { Effect, Layer } from "effect";
 
-//#region src/report/pipeline.ts
+// src/report/pipeline.ts
 /** @public */
 const ReportPipeline = Layer.mergeAll(EnvironmentDetector.layer, ExecutorResolver.layer, FormatSelector.layer, OutputRenderer.layer);
 /** @public */
@@ -22,5 +22,4 @@ const renderReport = (reports, options) => Effect.gen(function* () {
 	});
 });
 
-//#endregion
 export { ReportPipeline, renderReport };

package/report/schema.js

@@ -1,11 +1,12 @@
 import { Schema } from "effect";
 
-//#region src/report/schema.ts
+// 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, API Extractor, or the meta
-* pass's own sidecar work (`tsdoctor.json` sources, Open Graph generation).
+* A captured warning or error, from tsdown's logger, rolldown's onLog, API Extractor, the meta
+* pass's own sidecar work (`tsdoctor.json` sources, Open Graph generation), or an advisory finding
+* about the build config itself (`config`, e.g. a `publishConfig.targets` set no final release reaches).
 *
 * @public
 */
@@ -14,7 +15,8 @@ var DiagnosticEntry = class extends Schema.Class("DiagnosticEntry")({
 		"tsdown",
 		"rolldown",
 		"api-extractor",
-		"meta"
+		"meta",
+		"config"
 	]),
 	level: Schema.Literals(["warn", "error"]),
 	text: Schema.String,
@@ -72,5 +74,4 @@ var BuildReport = class extends Schema.Class("BuildReport")({
 	targetGroups: Schema.Array(TargetGroupReport)
 }) {};
 
-//#endregion
 export { BuildReport, DiagnosticEntry, EmittedFile, PassReport, ReportTimings, TargetGroupReport };

package/report/services/EnvironmentDetector.js

@@ -1,7 +1,7 @@
 import { Context, Effect, Layer } from "effect";
 import { isAgent, isCI } from "std-env";
 
-//#region src/report/services/EnvironmentDetector.ts
+// src/report/services/EnvironmentDetector.ts
 const isGitHub = () => process.env.GITHUB_ACTIONS === "true" || process.env.GITHUB_ACTIONS === "1";
 /** @public */
 var EnvironmentDetector = class extends Context.Service()("@savvy-web/tsdown-plugins/EnvironmentDetector") {
@@ -13,5 +13,4 @@ var EnvironmentDetector = class extends Context.Service()("@savvy-web/tsdown-plu
 	}) });
 };
 
-//#endregion
 export { EnvironmentDetector };

package/report/services/ExecutorResolver.js

@@ -1,10 +1,9 @@
 import { Context, Effect, Layer } from "effect";
 
-//#region src/report/services/ExecutorResolver.ts
+// src/report/services/ExecutorResolver.ts
 /** @public */
 var ExecutorResolver = class extends Context.Service()("@savvy-web/tsdown-plugins/ExecutorResolver") {
 	static layer = Layer.succeed(this, { resolve: (env) => Effect.succeed(env === "agent-shell" ? "agent" : env === "terminal" ? "human" : "ci") });
 };
 
-//#endregion
 export { ExecutorResolver };

package/report/services/FormatSelector.js

@@ -1,10 +1,9 @@
 import { Context, Effect, Layer } from "effect";
 
-//#region src/report/services/FormatSelector.ts
+// src/report/services/FormatSelector.ts
 /** @public */
 var FormatSelector = class extends Context.Service()("@savvy-web/tsdown-plugins/FormatSelector") {
 	static layer = Layer.succeed(this, { select: (executor, explicit, env) => Effect.succeed(explicit ?? (env === "ci-github" && executor === "ci" ? "ci-annotations" : executor === "agent" ? "markdown" : executor === "ci" ? "json" : "terminal")) });
 };
 
-//#endregion
 export { FormatSelector };

package/report/services/OutputRenderer.js

@@ -5,7 +5,7 @@ import { SilentFormatter } from "../formatters/silent.js";
 import { TerminalFormatter } from "../formatters/terminal.js";
 import { Context, Effect, Layer } from "effect";
 
-//#region src/report/services/OutputRenderer.ts
+// src/report/services/OutputRenderer.ts
 const formatters = /* @__PURE__ */ new Map([
 	["terminal", TerminalFormatter],
 	["json", JsonFormatter],
@@ -21,5 +21,4 @@ var OutputRenderer = class extends Context.Service()("@savvy-web/tsdown-plugins/
 	}) });
 };
 
-//#endregion
 export { OutputRenderer };

package/report/timer.js

@@ -1,4 +1,4 @@
-//#region src/report/timer.ts
+// src/report/timer.ts
 /** @public */
 function formatTime(ms) {
 	return ms < 1e3 ? `${Math.round(ms)}ms` : `${(ms / 1e3).toFixed(2)}s`;
@@ -16,5 +16,4 @@ function createTimer(now = Date.now) {
 	};
 }
 
-//#endregion
 export { createTimer, formatTime };

package/report/tsdown-logger.js

@@ -1,4 +1,4 @@
-//#region src/report/tsdown-logger.ts
+// 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();
 /**
@@ -38,5 +38,4 @@ function createTsdownLogger(collector, groupId) {
 	};
 }
 
-//#endregion
 export { createTsdownLogger };

package/targets/binding.js

@@ -1,7 +1,7 @@
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
-//#region src/targets/binding.ts
+// src/targets/binding.ts
 /**
 * Write the target-to-group binding to dist/prod/targets.json for the release action to consume. Returns the path.
 *
@@ -15,5 +15,4 @@ function writeTargetsBinding(cwd, resolution) {
 	return path;
 }
 
-//#endregion
 export { writeTargetsBinding };

package/targets/config.js

@@ -1,4 +1,14 @@
-//#region src/targets/config.ts
+// src/targets/config.ts
+/**
+* Every {@link ReleaseChannel} value, in declaration order.
+*
+* @public
+*/
+const RELEASE_CHANNELS = [
+	"all",
+	"stable",
+	"prerelease"
+];
 /**
 * True when a target value is the object form (carries registry/name/from).
 *
@@ -8,5 +18,4 @@ function isTargetObject(value) {
 	return typeof value === "object" && value !== null;
 }
 
-//#endregion
-export { isTargetObject };
+export { RELEASE_CHANNELS, isTargetObject };

package/targets/resolve-targets.js

@@ -1,7 +1,7 @@
 import { ConfigValidationError } from "../errors.js";
-import { isTargetObject } from "./config.js";
+import { RELEASE_CHANNELS, isTargetObject } from "./config.js";
 
-//#region src/targets/resolve-targets.ts
+// src/targets/resolve-targets.ts
 /** Default registry endpoints for the well-known target keys. */
 const DEFAULT_REGISTRIES = {
 	npm: "https://registry.npmjs.org",
@@ -29,6 +29,22 @@ function resolveTargets(options) {
 		});
 		return registry;
 	};
+	const optionsFor = (id, value) => {
+		if (!isTargetObject(value)) return { releases: "all" };
+		const { releases, provenance } = value;
+		if (releases !== void 0 && !RELEASE_CHANNELS.includes(releases)) throw new ConfigValidationError({
+			path: `publishConfig.targets.${id}.releases`,
+			reason: `Target "${id}" has releases "${String(releases)}"; expected one of ${RELEASE_CHANNELS.map((c) => `"${c}"`).join(", ")}`
+		});
+		if (provenance !== void 0 && typeof provenance !== "boolean") throw new ConfigValidationError({
+			path: `publishConfig.targets.${id}.provenance`,
+			reason: `Target "${id}" has a non-boolean provenance; expected true or false`
+		});
+		return {
+			releases: releases ?? "all",
+			...provenance !== void 0 ? { provenance } : {}
+		};
+	};
 	const groups = /* @__PURE__ */ new Map();
 	const addGroup = (id, name) => {
 		if (!groups.has(id)) groups.set(id, {
@@ -56,7 +72,8 @@ function resolveTargets(options) {
 				id,
 				group: gid,
 				name: baseName,
-				registry: registryFor(id, void 0)
+				registry: registryFor(id, void 0),
+				...optionsFor(id, value)
 			});
 		} else if (typeof value === "string") {
 			if (DEFAULT_REGISTRIES[id] === void 0) throw new ConfigValidationError({
@@ -68,7 +85,8 @@ function resolveTargets(options) {
 				id,
 				group: id,
 				name: value,
-				registry: registryFor(id, void 0)
+				registry: registryFor(id, void 0),
+				...optionsFor(id, value)
 			});
 		} else if (isTargetObject(value)) {
 			if (value.from !== void 0 && value.name !== void 0) throw new ConfigValidationError({
@@ -85,7 +103,8 @@ function resolveTargets(options) {
 					id,
 					group: id,
 					name: value.name,
-					registry: registryFor(id, value.registry)
+					registry: registryFor(id, value.registry),
+					...optionsFor(id, value)
 				});
 			} else {
 				addGroup(id, baseName);
@@ -93,7 +112,8 @@ function resolveTargets(options) {
 					id,
 					group: id,
 					name: baseName,
-					registry: registryFor(id, value.registry)
+					registry: registryFor(id, value.registry),
+					...optionsFor(id, value)
 				});
 			}
 		}
@@ -117,7 +137,8 @@ function resolveTargets(options) {
 			id,
 			group: ref.group,
 			name: ref.name,
-			registry: registryFor(id, obj.registry)
+			registry: registryFor(id, obj.registry),
+			...optionsFor(id, obj)
 		});
 	}
 	return {
@@ -125,6 +146,20 @@ function resolveTargets(options) {
 		targets: resolved
 	};
 }
+/**
+* Advisory warnings for a resolved target set that is valid but probably not what was meant.
+*
+* @remarks
+* Today the only one is a set whose every target is `releases: "prerelease"`, which leaves final
+* versions with nowhere to publish. A warning rather than a {@link ConfigValidationError}, since a
+* prerelease-only package is a legitimate if unusual setup. Pure; returns one message per finding.
+*
+* @public
+*/
+function releaseWarnings(resolution) {
+	const { targets } = resolution;
+	if (targets.length > 0 && targets.every((t) => t.releases === "prerelease")) return [`Every publish target sets releases: "prerelease", so final versions publish nowhere; set "all" or "stable" on at least one target`];
+	return [];
+}
 
-//#endregion
-export { resolveTargets };
+export { releaseWarnings, resolveTargets };

package/tsconfig/sync-options.js

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync } from "node:fs";
 import * as nodePath from "node:path";
 
-//#region src/tsconfig/sync-options.ts
+// src/tsconfig/sync-options.ts
 /**
 * The consumer-supplied sync operations backing every `TsconfigLoaderSync` call in this
 * package: Node's `existsSync`/`readFileSync` satisfy the loader's `SyncFileSystem`, and
@@ -17,5 +17,4 @@ const tsconfigSyncOptions = {
 	path: nodePath
 };
 
-//#endregion
 export { tsconfigSyncOptions };