@savvy-web/tsdown-plugins 0.11.0 → 0.12.0

package/build/build-target-groups.js

@@ -1,3 +1,5 @@
+import { analyzeReexportBarrel, collectExportNames, renderReexportStub } from "../dts/reexport-stub.js";
+import { writeDtsEmitTsconfig } from "../dts/resolved-tsconfig.js";
 import { emitManifest } from "../manifest/emit-manifest.js";
 import { buildMetricsPlugin } from "../report/metrics-plugin.js";
 import { createTimer } from "../report/timer.js";
@@ -6,10 +8,17 @@ import { cjsDefaultInterop } from "./cjs-default-interop.js";
 import { nodeBuiltinDefaultInterop } from "./node-builtin-default-interop.js";
 import { syncPublicDir } from "./sync-public.js";
 import { deriveDeclarationsPassOptions, deriveDtsPassOptions, deriveTargetGroupOptions, outDirFor } from "./target-groups.js";
-import { dirname, join } from "node:path";
+import { readFileSync, writeFileSync } from "node:fs";
+import { dirname, isAbsolute, join } from "node:path";
 
 //#region src/build/build-target-groups.ts
 /**
+* Entry name of the conventional primary (".") export, which `createEntryName` maps to "index". It is
+* the re-export-stub base: a secondary entry that re-exports a subset of it gets a thin stub pointing
+* here instead of a self-contained rollup.
+*/
+const STUB_BASE_ENTRY = "index";
+/**
 * Run tsdown.build() per TargetGroup. Composable so the escape hatch gets multi-group too.
 *
 * Each group runs TWO passes to the SAME outDir:
@@ -28,6 +37,7 @@ import { dirname, join } from "node:path";
 async function buildTargetGroups(options) {
 	const build = options.build ?? (await import("tsdown")).build;
 	const publicDir = join(options.cwd, "public");
+	const dtsEmitTsconfigPath = writeDtsEmitTsconfig(options.tsconfigPath);
 	const collector = options.collector;
 	const verbose = options.verbose ?? false;
 	const instrument = (groupId) => collector === void 0 ? {} : {
@@ -68,13 +78,12 @@ async function buildTargetGroups(options) {
 				cwd: options.cwd,
 				version: options.version,
 				entry: part.entry,
-				tsconfigPath: options.tsconfigPath,
+				tsconfigPath: dtsEmitTsconfigPath,
 				devManifest: options.devManifest,
 				...partExternals !== void 0 ? { externals: partExternals } : {},
 				...partBundledPackages !== void 0 ? { bundledPackages: partBundledPackages } : {},
 				...part.format !== void 0 ? { format: part.format } : {},
 				...options.minify !== void 0 ? { minify: options.minify } : {},
-				...options.jsx !== void 0 ? { jsx: options.jsx } : {},
 				...options.define !== void 0 ? { define: options.define } : {},
 				...part.platform !== void 0 ? { platform: part.platform } : {}
 			};
@@ -124,7 +133,6 @@ async function buildTargetGroups(options) {
 					...partBundleNodeModules ? { skipNodeModulesBundle: false } : {}
 				} } : {},
 				...js.cjsDefault !== void 0 ? { cjsDefault: js.cjsDefault } : {},
-				...js.jsx !== void 0 ? { inputOptions: { jsx: js.jsx } } : {},
 				plugins: [
 					...manifestPlugin ? [manifestPlugin] : [],
 					...js.format.includes("cjs") ? [nodeBuiltinDefaultInterop(), cjsDefaultInterop()] : [],
@@ -135,37 +143,91 @@ async function buildTargetGroups(options) {
 			if (isBase) syncPublicDir(publicDir, join(js.outDir, "public"));
 			const dtsNeverBundle = [...partExternals ?? [], ...partDtsExternals ?? []];
 			if (Object.keys(dts.entry).length === 0) continue;
-			await timed(group.id, "dts", () => build({
-				config: false,
-				cwd: options.cwd,
-				entry: dts.entry,
-				outDir: partOutDir,
-				format: dts.format,
-				platform: dts.platform,
-				sourcemap: dts.sourcemap,
-				unbundle: dts.unbundle,
-				clean: false,
-				fixedExtension: dts.fixedExtension,
-				dts: dts.dts,
-				define: dts.define,
-				...instrument(group.id),
-				...dtsNeverBundle.length > 0 || partBundleNodeModules || dts.bundledPackages ? { deps: {
-					...dtsNeverBundle.length > 0 ? { neverBundle: dtsNeverBundle } : {},
-					...partBundleNodeModules ? {
-						skipNodeModulesBundle: false,
-						...dts.bundledPackages ? { dts: { alwaysBundle: dts.bundledPackages } } : {}
-					} : dts.bundledPackages ? {
-						skipNodeModulesBundle: true,
-						dts: { alwaysBundle: dts.bundledPackages }
-					} : {}
-				} } : {},
-				...dts.jsx !== void 0 ? { inputOptions: { jsx: dts.jsx } } : {},
-				plugins: [
-					...dts.format.includes("cjs") ? [nodeBuiltinDefaultInterop(), cjsDefaultInterop()] : [],
-					...options.extraPlugins ?? [],
-					...metricsPlugins(group.id, "dts")
-				]
-			}));
+			const dtsDeps = dtsNeverBundle.length > 0 || partBundleNodeModules || dts.bundledPackages ? { deps: {
+				...dtsNeverBundle.length > 0 ? { neverBundle: dtsNeverBundle } : {},
+				...partBundleNodeModules ? {
+					skipNodeModulesBundle: false,
+					...dts.bundledPackages ? { dts: { alwaysBundle: dts.bundledPackages } } : {}
+				} : dts.bundledPackages ? {
+					skipNodeModulesBundle: true,
+					dts: { alwaysBundle: dts.bundledPackages }
+				} : {}
+			} } : {};
+			const stubEntries = /* @__PURE__ */ new Map();
+			const readSource = (src) => {
+				try {
+					return readFileSync(isAbsolute(src) ? src : join(options.cwd, src), "utf-8");
+				} catch {
+					return;
+				}
+			};
+			const baseSrc = dts.entry[STUB_BASE_ENTRY];
+			if (baseSrc !== void 0 && Object.keys(dts.entry).length > 1) {
+				const baseSource = readSource(baseSrc);
+				const base = baseSource !== void 0 ? collectExportNames(baseSource) : void 0;
+				if (base?.complete === true) for (const [entryName, entrySource] of Object.entries(dts.entry)) {
+					if (entryName === STUB_BASE_ENTRY || entryName.includes("/")) continue;
+					const source = readSource(entrySource);
+					if (source === void 0) continue;
+					const analysis = analyzeReexportBarrel(source);
+					if (!analysis.isPureNamedReexportBarrel) continue;
+					const all = [...analysis.valueNames, ...analysis.typeNames];
+					if (all.length === 0 || !all.every((n) => base.names.has(n))) continue;
+					stubEntries.set(entryName, {
+						valueNames: analysis.valueNames,
+						typeNames: analysis.typeNames
+					});
+				}
+			}
+			await timed(group.id, "dts", async () => {
+				for (const [entryName, entrySource] of Object.entries(dts.entry)) {
+					const stub = stubEntries.get(entryName);
+					if (stub !== void 0) {
+						const variants = [{
+							file: `${entryName}.d.ts`,
+							spec: `./${STUB_BASE_ENTRY}.js`
+						}];
+						if (dts.format.includes("cjs")) variants.push({
+							file: `${entryName}.d.cts`,
+							spec: `./${STUB_BASE_ENTRY}.cjs`
+						});
+						for (const variant of variants) {
+							const content = renderReexportStub({
+								valueNames: stub.valueNames,
+								typeNames: stub.typeNames,
+								baseSpecifier: variant.spec
+							});
+							writeFileSync(join(partOutDir, variant.file), content, "utf-8");
+							collector?.recordEmitted(group.id, "dts", {
+								path: variant.file,
+								bytes: Buffer.byteLength(content)
+							});
+						}
+						continue;
+					}
+					await build({
+						config: false,
+						cwd: options.cwd,
+						entry: { [entryName]: entrySource },
+						outDir: partOutDir,
+						format: dts.format,
+						platform: dts.platform,
+						sourcemap: dts.sourcemap,
+						unbundle: dts.unbundle,
+						clean: false,
+						fixedExtension: dts.fixedExtension,
+						dts: dts.dts,
+						define: dts.define,
+						...instrument(group.id),
+						...dtsDeps,
+						plugins: [
+							...dts.format.includes("cjs") ? [nodeBuiltinDefaultInterop(), cjsDefaultInterop()] : [],
+							...options.extraPlugins ?? [],
+							...metricsPlugins(group.id, "dts")
+						]
+					});
+				}
+			});
 			if (js.isProd && options.emitDeclarations === true && Object.keys(decl.entry).length > 0) {
 				const partDeclDir = part.outSubdir !== void 0 ? join(decl.outDir, part.outSubdir) : decl.outDir;
 				try {
@@ -193,7 +255,6 @@ async function buildTargetGroups(options) {
 								dts: { alwaysBundle: decl.bundledPackages }
 							} : {}
 						} } : {},
-						...decl.jsx !== void 0 ? { inputOptions: { jsx: decl.jsx } } : {},
 						...options.extraPlugins !== void 0 ? { plugins: [...options.extraPlugins] } : {}
 					});
 				} catch (err) {

package/build/strip-maps.js

@@ -1,5 +1,5 @@
-import { join } from "node:path";
 import { readdirSync, rmSync } from "node:fs";
+import { join } from "node:path";
 
 //#region src/build/strip-maps.ts
 /**

package/build/sync-public.js

@@ -1,5 +1,5 @@
-import { dirname, join, relative } from "node:path";
 import { copyFileSync, cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
 
 //#region src/build/sync-public.ts
 /** Recursively collect every file path under `dir`, relative to `base`. */

package/build/target-groups.js

@@ -34,8 +34,7 @@ function deriveTargetGroupOptions(options) {
 			...options.define
 		},
 		isProd,
-		...hasCjs ? { cjsDefault: true } : {},
-		...options.jsx !== void 0 ? { jsx: options.jsx } : {}
+		...hasCjs ? { cjsDefault: true } : {}
 	};
 }
 /** Derive the dts-pass tsdown options for one TargetGroup (bundled declarations only). */
@@ -61,7 +60,6 @@ function deriveDtsPassOptions(options) {
 			...options.define
 		},
 		isProd,
-		...options.jsx !== void 0 ? { jsx: options.jsx } : {},
 		...options.bundledPackages !== void 0 ? { bundledPackages: options.bundledPackages } : {}
 	};
 }
@@ -90,8 +88,7 @@ function deriveDeclarationsPassOptions(options) {
 			"process.env.__PACKAGE_VERSION__": JSON.stringify(options.version),
 			...options.define
 		},
-		...options.bundledPackages !== void 0 ? { bundledPackages: options.bundledPackages } : {},
-		...options.jsx !== void 0 ? { jsx: options.jsx } : {}
+		...options.bundledPackages !== void 0 ? { bundledPackages: options.bundledPackages } : {}
 	};
 }
 

package/config-validation/ConfigValidatorLive.js

@@ -3,8 +3,8 @@ import { normalizeLooseFiles } from "../build/loose-files.js";
 import { ConfigValidator } from "./ConfigValidator.js";
 import { normalizeExeOptions } from "../exe/config.js";
 import { resolveTargets } from "../targets/resolve-targets.js";
-import { Effect, Layer } from "effect";
 import { existsSync, statSync } from "node:fs";
+import { Effect, Layer } from "effect";
 
 //#region src/config-validation/ConfigValidatorLive.ts
 const VALID_SYNTAX_KINDS = /* @__PURE__ */ new Set([

package/dts/reexport-stub.js

@@ -0,0 +1,92 @@
+import ts from "typescript";
+
+//#region src/dts/reexport-stub.ts
+function parse(source, fileName) {
+	return ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, false, ts.ScriptKind.TS);
+}
+/**
+* Analyze an entry source as a candidate pure re-export barrel: classify its re-exported names into
+* value vs type-only and report whether it is expressible as a thin stub. Pure parsing — no I/O.
+*
+* @public
+*/
+function analyzeReexportBarrel(source, fileName = "entry.ts") {
+	const sf = parse(source, fileName);
+	const valueNames = [];
+	const typeNames = [];
+	let pure = true;
+	for (const stmt of sf.statements) {
+		if (ts.isExportDeclaration(stmt) && stmt.moduleSpecifier !== void 0) {
+			const clause = stmt.exportClause;
+			if (clause !== void 0 && ts.isNamedExports(clause)) {
+				for (const el of clause.elements) (stmt.isTypeOnly || el.isTypeOnly ? typeNames : valueNames).push(el.name.text);
+				continue;
+			}
+			pure = false;
+			continue;
+		}
+		pure = false;
+	}
+	return {
+		valueNames,
+		typeNames,
+		isPureNamedReexportBarrel: pure
+	};
+}
+/**
+* Collect every name a module exports (named re-exports, namespace re-exports, and local `export`
+* declarations). Used to test whether a barrel's re-exports are a strict subset of a base entry, so
+* a stub re-exporting from that base resolves every symbol. Pure parsing — no I/O.
+*
+* @public
+*/
+function collectExportNames(source, fileName = "entry.ts") {
+	const sf = parse(source, fileName);
+	const names = /* @__PURE__ */ new Set();
+	let complete = true;
+	const addBindingName = (name) => {
+		if (ts.isIdentifier(name)) names.add(name.text);
+		else for (const el of name.elements) if (ts.isBindingElement(el)) addBindingName(el.name);
+	};
+	for (const stmt of sf.statements) {
+		if (ts.isExportDeclaration(stmt)) {
+			const clause = stmt.exportClause;
+			if (clause === void 0) {
+				if (stmt.moduleSpecifier !== void 0) complete = false;
+				continue;
+			}
+			if (ts.isNamespaceExport(clause)) {
+				names.add(clause.name.text);
+				continue;
+			}
+			for (const el of clause.elements) names.add(el.name.text);
+			continue;
+		}
+		if (!(ts.canHaveModifiers(stmt) ? (ts.getModifiers(stmt) ?? []).some((m) => m.kind === ts.SyntaxKind.ExportKeyword) : false)) continue;
+		if (ts.isVariableStatement(stmt)) for (const decl of stmt.declarationList.declarations) addBindingName(decl.name);
+		else if ((ts.isFunctionDeclaration(stmt) || ts.isClassDeclaration(stmt) || ts.isInterfaceDeclaration(stmt) || ts.isTypeAliasDeclaration(stmt) || ts.isEnumDeclaration(stmt) || ts.isModuleDeclaration(stmt)) && stmt.name !== void 0 && ts.isIdentifier(stmt.name)) names.add(stmt.name.text);
+	}
+	return {
+		names,
+		complete
+	};
+}
+/**
+* Render a thin re-export-stub `.d.ts`/`.d.cts` body: named re-exports of `valueNames` and
+* `typeNames` from `baseSpecifier` (the published file of the base entry, e.g. `./index.js` for the
+* ESM `.d.ts` or `./index.cjs` for the CJS `.d.cts`). Names are sorted so the output is
+* deterministic. Returns the empty string when there is nothing to re-export.
+*
+* @public
+*/
+function renderReexportStub(options) {
+	const sortedValues = [...options.valueNames].sort();
+	const sortedTypes = [...options.typeNames].sort();
+	const lines = [];
+	if (sortedValues.length > 0) lines.push(`export { ${sortedValues.join(", ")} } from "${options.baseSpecifier}";`);
+	if (sortedTypes.length > 0) lines.push(`export type { ${sortedTypes.join(", ")} } from "${options.baseSpecifier}";`);
+	return lines.length > 0 ? `${lines.join("\n")}\n` : "";
+}
+
+//#endregion
+export { analyzeReexportBarrel, collectExportNames, renderReexportStub };

package/dts/resolved-tsconfig.js

@@ -1,5 +1,5 @@
-import { join } from "node:path";
-import { writeFileSync } from "node:fs";
+import { existsSync, writeFileSync } from "node:fs";
+import { isAbsolute, join, resolve } from "node:path";
 import { tmpdir } from "node:os";
 
 //#region src/dts/resolved-tsconfig.ts
@@ -47,6 +47,33 @@ function writeResolvedTsconfig(options) {
 	writeFileSync(path, `${JSON.stringify(cfg, null, "	")}\n`, "utf-8");
 	return path;
 }
+/**
+* Derive a dts-EMIT variant of an already-written resolved tsconfig that adds
+* `stableTypeOrdering: true`, and return its path. This makes the TypeScript declaration emitter
+* (rolldown-plugin-dts on `typescript@6`) order union/type members deterministically, so a
+* multi-union `.d.ts` (e.g. an Effect `Layer.Layer<…>` requirement channel) does not flip member
+* order across otherwise-identical builds (#156). It is kept in a SEPARATE file from the
+* api-extractor tsconfig on purpose: `@microsoft/api-extractor` pins `typescript ~5.9`, which
+* predates the flag and hard-errors on the unknown compiler option — so only the emit passes
+* (which run on TS6) ever see it, while the api-extractor compile reads the original clean config.
+*
+* Best-effort: if the base tsconfig cannot be read or parsed (e.g. a synthetic test path that was
+* never written), the original path is returned unchanged — the emit then simply keeps TS's
+* default ordering rather than aborting the build at this layer.
+*
+* @public
+*/
+function writeDtsEmitTsconfig(resolvedTsconfigPath) {
+	const absBase = isAbsolute(resolvedTsconfigPath) ? resolvedTsconfigPath : resolve(resolvedTsconfigPath);
+	if (!existsSync(absBase)) return resolvedTsconfigPath;
+	const cfg = {
+		extends: absBase,
+		compilerOptions: { stableTypeOrdering: true }
+	};
+	const path = join(tmpdir(), `tsconfig-dts-emit-${process.pid}-${absBase.replace(/[^\w]/g, "_")}.json`);
+	writeFileSync(path, `${JSON.stringify(cfg, null, "	")}\n`, "utf-8");
+	return path;
+}
 
 //#endregion
-export { buildResolvedTsconfig, writeResolvedTsconfig };
+export { buildResolvedTsconfig, writeDtsEmitTsconfig, writeResolvedTsconfig };

package/entry/package-json-entries.js

@@ -1,6 +1,6 @@
 import { extractEntries } from "./extract.js";
-import { resolve } from "node:path";
 import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
 
 //#region src/entry/package-json-entries.ts
 /**

package/exe/build.js

@@ -1,8 +1,8 @@
 import { buildMetricsPlugin } from "../report/metrics-plugin.js";
 import { createTimer } from "../report/timer.js";
 import { createTsdownLogger } from "../report/tsdown-logger.js";
-import { join } from "node:path";
 import { mkdtempSync, rmSync } from "node:fs";
+import { join } from "node:path";
 import { tmpdir } from "node:os";
 
 //#region src/exe/build.ts

package/index.d.ts

@@ -3,40 +3,6 @@ import { Plugin } from "rolldown";
 import { Context, Effect, Layer, Schema } from "effect";
 import { JsxEmit, ModuleDetectionKind, ModuleKind, ModuleResolutionKind, NewLineKind, ParsedCommandLine, ScriptTarget } from "typescript";
 
-//#region src/jsx/config.d.ts
-/**
- * Resolved JSX transform settings, mirroring the subset of rolldown's JsxOptions the bundler forwards.
- *
- * @public
- */
-interface JsxConfig {
-  /** "automatic" auto-imports the JSX factories (react-jsx); "classic" does not (React.createElement). */
-  readonly runtime?: "classic" | "automatic" | undefined;
-  /** The JSX import source for the automatic runtime (e.g. "react", "preact"). */
-  readonly importSource?: string | undefined;
-}
-/**
- * The jsx-relevant slice of a tsconfig's compilerOptions.
- *
- * @public
- */
-interface TsconfigJsx {
-  readonly jsx?: string | undefined;
-  readonly jsxImportSource?: string | undefined;
-}
-/**
- * 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
- */
-declare function resolveJsxConfig(tsconfig: TsconfigJsx, override: JsxConfig | undefined): JsxConfig | undefined;
-/**
- * Read the jsx-relevant compilerOptions from a package's own tsconfig.json (best-effort;
- * returns empty on absence or parse error).
- * @public
- */
-declare function readTsconfigJsx(cwd: string): TsconfigJsx;
-//#endregion
 //#region src/manifest/transform.d.ts
 /** @public */
 type Json = Record<string, unknown>;
@@ -211,21 +177,21 @@ declare const DiagnosticEntry_base: Schema.Class<DiagnosticEntry, {
   line: Schema.optional<typeof Schema.Number>;
   column: Schema.optional<typeof Schema.Number>;
 }>, never, {
-  readonly text: string;
-} & {
-  readonly source: "tsdown" | "rolldown" | "api-extractor";
-} & {
-  readonly level: "warn" | "error";
+  readonly ciFatal?: boolean | undefined;
 } & {
   readonly code?: string | undefined;
 } & {
-  readonly ciFatal?: boolean | undefined;
+  readonly column?: number | undefined;
 } & {
   readonly file?: string | undefined;
 } & {
   readonly line?: number | undefined;
 } & {
-  readonly column?: number | undefined;
+  readonly level: "error" | "warn";
+} & {
+  readonly source: "api-extractor" | "rolldown" | "tsdown";
+} & {
+  readonly text: string;
 }, {}, {}>;
 /**
  * A captured warning or error, from tsdown's logger, rolldown's onLog, or API Extractor.
@@ -242,11 +208,11 @@ declare const EmittedFile_base: Schema.Class<EmittedFile, {
   bytes: typeof Schema.Number;
   gzip: Schema.optional<typeof Schema.Number>;
 }>, never, {
-  readonly path: string;
+  readonly gzip?: number | undefined;
 } & {
   readonly bytes: number;
 } & {
-  readonly gzip?: number | undefined;
+  readonly path: string;
 }, {}, {}>;
 /**
  * One emitted output file with its in-memory byte size (gzip only when --verbose).
@@ -263,11 +229,11 @@ declare const PassReport_base: Schema.Class<PassReport, {
   files: Schema.Array$<typeof EmittedFile>;
   ms: typeof Schema.Number;
 }>, never, {
-  readonly ms: number;
+  readonly files: readonly EmittedFile[];
 } & {
-  readonly id: "js" | "dts" | "loose" | "exe" | "meta";
+  readonly id: "dts" | "exe" | "js" | "loose" | "meta";
 } & {
-  readonly files: readonly EmittedFile[];
+  readonly ms: number;
 }, {}, {}>;
 /**
  * One build pass within a target group (js / dts / loose / exe / meta).
@@ -294,17 +260,17 @@ declare const TargetGroupReport_base: Schema.Class<TargetGroupReport, {
 }>, never, {
   readonly entries: readonly string[];
 } & {
-  readonly id: string;
+  readonly errors: readonly DiagnosticEntry[];
 } & {
-  readonly timings: ReportTimings;
+  readonly id: string;
 } & {
   readonly passes: readonly PassReport[];
 } & {
-  readonly warnings: readonly DiagnosticEntry[];
+  readonly suppressed: readonly DiagnosticEntry[];
 } & {
-  readonly errors: readonly DiagnosticEntry[];
+  readonly timings: ReportTimings;
 } & {
-  readonly suppressed: readonly DiagnosticEntry[];
+  readonly warnings: readonly DiagnosticEntry[];
 }, {}, {}>;
 /** @public */
 declare class TargetGroupReport extends TargetGroupReport_base {}
@@ -401,8 +367,6 @@ interface DeriveOptions {
   readonly format?: ReadonlyArray<BuildFormat> | undefined;
   /** Minify prod output (prod groups only; dev is never minified). Defaults to false. */
   readonly minify?: boolean | undefined;
-  /** JSX transform settings to forward to rolldown's inputOptions. */
-  readonly jsx?: JsxConfig | undefined;
   /**
    * Compile-time global replacements forwarded to the build `define`. Merged AFTER the
    * auto-injected `process.env.__PACKAGE_VERSION__` so a user key of the same name wins.
@@ -483,8 +447,6 @@ interface DerivedTsdownOptions {
    *   default untouched and stay byte-identical to before.
    */
   readonly cjsDefault?: boolean | undefined;
-  /** JSX transform settings to forward to rolldown's inputOptions. */
-  readonly jsx?: JsxConfig | undefined;
 }
 /**
  * Derive the JS-pass tsdown options for one TargetGroup (per-module JS, no dts).
@@ -651,8 +613,6 @@ interface BuildTargetGroupsOptions {
    * firing exactly once should guard the second invocation.
    */
   readonly extraPlugins?: ReadonlyArray<Plugin>;
-  /** JSX transform settings forwarded to rolldown's inputOptions. */
-  readonly jsx?: JsxConfig | undefined;
   /**
    * Compile-time global replacements forwarded to BOTH the JS and dts passes' `define`.
    * Build-wide (shared by every entry partition); merged after the auto-injected
@@ -1149,6 +1109,69 @@ declare class ConfigValidator extends ConfigValidator_base {}
  */
 declare const ConfigValidatorLive: Layer.Layer<ConfigValidator, never, never>;
 //#endregion
+//#region src/dts/reexport-stub.d.ts
+/**
+ * The analysis of an entry source treated as a candidate re-export barrel.
+ *
+ * @public
+ */
+interface ReexportBarrelAnalysis {
+  /** Value (non-type-only) names the module re-exports, after `as` aliasing. */
+  readonly valueNames: ReadonlyArray<string>;
+  /** Type-only names the module re-exports (`export type { … }`), after `as` aliasing. */
+  readonly typeNames: ReadonlyArray<string>;
+  /**
+   * True iff EVERY top-level statement is a NAMED re-export `from` another module
+   * (`export { … } from "…"` / `export type { … } from "…"`). A module that declares anything
+   * locally, re-exports a namespace (`export * as NS from`), star-re-exports (`export * from`), or
+   * has a bare `export { … }` without `from` is NOT a pure named barrel and cannot be expressed as
+   * a thin re-export stub of another entry.
+   */
+  readonly isPureNamedReexportBarrel: boolean;
+}
+/**
+ * The set of names a module exports, plus whether that set is fully known.
+ *
+ * @public
+ */
+interface ModuleExportNames {
+  readonly names: ReadonlySet<string>;
+  /**
+   * False when the module contains a star re-export (`export * from "…"`) whose target exports
+   * cannot be enumerated from this source alone — the name set is then a lower bound, not complete,
+   * so callers must not use it for a strict subset decision.
+   */
+  readonly complete: boolean;
+}
+/**
+ * Analyze an entry source as a candidate pure re-export barrel: classify its re-exported names into
+ * value vs type-only and report whether it is expressible as a thin stub. Pure parsing — no I/O.
+ *
+ * @public
+ */
+declare function analyzeReexportBarrel(source: string, fileName?: string): ReexportBarrelAnalysis;
+/**
+ * Collect every name a module exports (named re-exports, namespace re-exports, and local `export`
+ * declarations). Used to test whether a barrel's re-exports are a strict subset of a base entry, so
+ * a stub re-exporting from that base resolves every symbol. Pure parsing — no I/O.
+ *
+ * @public
+ */
+declare function collectExportNames(source: string, fileName?: string): ModuleExportNames;
+/**
+ * Render a thin re-export-stub `.d.ts`/`.d.cts` body: named re-exports of `valueNames` and
+ * `typeNames` from `baseSpecifier` (the published file of the base entry, e.g. `./index.js` for the
+ * ESM `.d.ts` or `./index.cjs` for the CJS `.d.cts`). Names are sorted so the output is
+ * deterministic. Returns the empty string when there is nothing to re-export.
+ *
+ * @public
+ */
+declare function renderReexportStub(options: {
+  readonly valueNames: ReadonlyArray<string>;
+  readonly typeNames: ReadonlyArray<string>;
+  readonly baseSpecifier: string;
+}): string;
+//#endregion
 //#region src/dts/resolved-tsconfig.d.ts
 /** @public */
 interface ResolvedTsconfigOptions {
@@ -1179,6 +1202,23 @@ declare function buildResolvedTsconfig(options: ResolvedTsconfigOptions): Resolv
  * @public
  */
 declare function writeResolvedTsconfig(options: ResolvedTsconfigOptions): string;
+/**
+ * Derive a dts-EMIT variant of an already-written resolved tsconfig that adds
+ * `stableTypeOrdering: true`, and return its path. This makes the TypeScript declaration emitter
+ * (rolldown-plugin-dts on `typescript@6`) order union/type members deterministically, so a
+ * multi-union `.d.ts` (e.g. an Effect `Layer.Layer<…>` requirement channel) does not flip member
+ * order across otherwise-identical builds (#156). It is kept in a SEPARATE file from the
+ * api-extractor tsconfig on purpose: `@microsoft/api-extractor` pins `typescript ~5.9`, which
+ * predates the flag and hard-errors on the unknown compiler option — so only the emit passes
+ * (which run on TS6) ever see it, while the api-extractor compile reads the original clean config.
+ *
+ * Best-effort: if the base tsconfig cannot be read or parsed (e.g. a synthetic test path that was
+ * never written), the original path is returned unchanged — the emit then simply keeps TS's
+ * default ordering rather than aborting the build at this layer.
+ *
+ * @public
+ */
+declare function writeDtsEmitTsconfig(resolvedTsconfigPath: string): string;
 //#endregion
 //#region src/entry/extract.d.ts
 /** @public */
@@ -1271,6 +1311,42 @@ declare function runExeBuild(options: RunExeBuildOptions): Promise<void>;
  */
 declare function computeExeFileName(fileName: string, target: ExeTarget): string;
 //#endregion
+//#region src/jsx/config.d.ts
+/**
+ * Resolved JSX transform settings. The shape mirrors the subset of rolldown's JsxOptions, but the
+ * bundler consumes it to populate the generated dts tsconfig's `jsx`/`jsxImportSource`, not by
+ * forwarding it into rolldown's input options.
+ *
+ * @public
+ */
+interface JsxConfig {
+  /** "automatic" auto-imports the JSX factories (react-jsx); "classic" does not (React.createElement). */
+  readonly runtime?: "classic" | "automatic" | undefined;
+  /** The JSX import source for the automatic runtime (e.g. "react", "preact"). */
+  readonly importSource?: string | undefined;
+}
+/**
+ * The jsx-relevant slice of a tsconfig's compilerOptions.
+ *
+ * @public
+ */
+interface TsconfigJsx {
+  readonly jsx?: string | undefined;
+  readonly jsxImportSource?: string | undefined;
+}
+/**
+ * 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
+ */
+declare function resolveJsxConfig(tsconfig: TsconfigJsx, override: JsxConfig | undefined): JsxConfig | undefined;
+/**
+ * Read the jsx-relevant compilerOptions from a package's own tsconfig.json (best-effort;
+ * returns empty on absence or parse error).
+ * @public
+ */
+declare function readTsconfigJsx(cwd: string): TsconfigJsx;
+//#endregion
 //#region src/meta/generate.d.ts
 /** @public */
 interface GenerateMetaOptions {
@@ -1722,5 +1798,5 @@ declare function resolveTargets(options: {
   baseName: string;
 }): TargetResolution;
 //#endregion
-export { BuildCollector, BuildCollectorTag, type BuildEmittedManifestOptions, type BuildFormat, type BuildGroupSpec, type BuildIssues, type BuildPlatform, type BuildReport, BuildReport as BuildReportSchema, type BuildTargetGroupsOptions, CatalogAssemblyError, CatalogResolutionError, CiAnnotationsFormatter, ConfigValidationError, ConfigValidator, ConfigValidatorLive, type CssOptions, DEFAULT_EXE_NODE_VERSION, type DeriveOptions, type DerivedTsdownOptions, type DiagnosticEntry, type DiagnosticInput, type DualExports, type EmitManifestOptions, type EmittedFile, type EntryOverride, type Environment, EnvironmentDetector, EnvironmentDetectorLive, type ExeBuild, type ExeConfig, type ExeRewrite, type ExeSeaConfig, type ExeTarget, type ExeTargetInput, type Executor, ExecutorResolver, ExecutorResolverLive, type ExtractOptions, type ExtractResult, FormatSelector, FormatSelectorLive, type Formatter, type FormatterContext, type GenerateMetaOptions, type Json, JsonFormatter, type JsxConfig, type LooseFileSpec, type LooseFiles, type ManifestLike, MarkdownFormatter, MetaGenerationError, type MetaOptions, type MetaResult, type NextVersions, type NormalizedExe, type NormalizedLooseFile, type NormalizedMeta, type OutputFormat, OutputRenderer, OutputRendererLive, type PackageJsonEntriesOptions, type PackageJsonLike, type PassKind, type PassReport, type PkgOsCpu, type PlainDiagnostic, type PortableTsconfig, type PublishTargetObject, type PublishTargetValue, type PublishTargets, type RenderReportOptions, type RenderedOutput, ReportPipelineLive, ReportTimings, type ResolvedCompilerOptions, type ResolvedGroup, type ResolvedTarget, type ResolvedTsconfig, type ResolvedTsconfigOptions, type RunExeBuildOptions, type RunMetaPassOptions, SilentFormatter, type TargetGroupId, type TargetGroupRef, type TargetGroupReport, TargetGroupReport as TargetGroupReportSchema, type TargetResolution, TerminalFormatter, type Timer, type TransformManifestOptions, type TsconfigJsx, TsconfigResolver, type TsdocOptions, type TsdocTagDefinition, type TsdownBuild, type TsdownLogger, type ValidationInput, type WarningSuppressionRule, 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 };
+export { BuildCollector, BuildCollectorTag, type BuildEmittedManifestOptions, type BuildFormat, type BuildGroupSpec, type BuildIssues, type BuildPlatform, type BuildReport, BuildReport as BuildReportSchema, type BuildTargetGroupsOptions, CatalogAssemblyError, CatalogResolutionError, CiAnnotationsFormatter, ConfigValidationError, ConfigValidator, ConfigValidatorLive, type CssOptions, DEFAULT_EXE_NODE_VERSION, type DeriveOptions, type DerivedTsdownOptions, type DiagnosticEntry, type DiagnosticInput, type DualExports, type EmitManifestOptions, type EmittedFile, type EntryOverride, type Environment, EnvironmentDetector, EnvironmentDetectorLive, type ExeBuild, type ExeConfig, type ExeRewrite, type ExeSeaConfig, type ExeTarget, type ExeTargetInput, type Executor, ExecutorResolver, ExecutorResolverLive, type ExtractOptions, type ExtractResult, FormatSelector, FormatSelectorLive, type Formatter, type FormatterContext, type GenerateMetaOptions, type Json, JsonFormatter, type JsxConfig, type LooseFileSpec, type LooseFiles, type ManifestLike, MarkdownFormatter, MetaGenerationError, type MetaOptions, type MetaResult, type ModuleExportNames, type NextVersions, type NormalizedExe, type NormalizedLooseFile, type NormalizedMeta, type OutputFormat, OutputRenderer, OutputRendererLive, type PackageJsonEntriesOptions, type PackageJsonLike, type PassKind, type PassReport, type PkgOsCpu, type PlainDiagnostic, type PortableTsconfig, type PublishTargetObject, type PublishTargetValue, type PublishTargets, type ReexportBarrelAnalysis, type RenderReportOptions, type RenderedOutput, ReportPipelineLive, ReportTimings, type ResolvedCompilerOptions, type ResolvedGroup, type ResolvedTarget, type ResolvedTsconfig, type ResolvedTsconfigOptions, type RunExeBuildOptions, type RunMetaPassOptions, SilentFormatter, type TargetGroupId, type TargetGroupRef, type TargetGroupReport, TargetGroupReport as TargetGroupReportSchema, type TargetResolution, TerminalFormatter, type Timer, type TransformManifestOptions, type TsconfigJsx, TsconfigResolver, type TsdocOptions, type TsdocTagDefinition, type TsdownBuild, type TsdownLogger, type ValidationInput, type WarningSuppressionRule, analyzeReexportBarrel, applySubdirMetaEntries, buildEmittedManifest, buildMetricsPlugin, buildResolvedTsconfig, buildTargetGroups, cjsDefaultInterop, collectExportNames, computeExeFileName, createEntryName, createTimer, createTsdownLogger, defaultManifestTransform, deriveExportPaths, deriveTargetGroupOptions, emitManifest, extractEntries, flattenIssues, formatTime, generateMeta, isTargetObject, nodeBuiltinDefaultInterop, normalizeBinPaths, normalizeExeOptions, normalizeLooseFiles, normalizeMetaOptions, packageJsonEntries, readTsconfigJsx, removeDeclarationMaps, renderReexportStub, renderReport, resolveJsxConfig, resolveManifest, resolveNextVersions, resolvePortableTsconfig, resolveTargets, rewriteMetaVersions, runExeBuild, runMetaPass, serializeIssues, syncPublicDir, transformBin, transformExports, transformManifest, writeDtsEmitTsconfig, writeIssuesArtifact, writeResolvedTsconfig, writeTargetsBinding };
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -1,3 +1,5 @@
+import { analyzeReexportBarrel, collectExportNames, renderReexportStub } from "./dts/reexport-stub.js";
+import { buildResolvedTsconfig, writeDtsEmitTsconfig, writeResolvedTsconfig } from "./dts/resolved-tsconfig.js";
 import { resolveManifest } from "./catalog/resolve-catalogs.js";
 import { createEntryName, extractEntries } from "./entry/extract.js";
 import { defaultManifestTransform, normalizeBinPaths, transformBin, transformExports, transformManifest } from "./manifest/transform.js";
@@ -19,7 +21,6 @@ import { DEFAULT_EXE_NODE_VERSION, normalizeExeOptions } from "./exe/config.js";
 import { isTargetObject } from "./targets/config.js";
 import { resolveTargets } from "./targets/resolve-targets.js";
 import { ConfigValidatorLive } from "./config-validation/ConfigValidatorLive.js";
-import { buildResolvedTsconfig, writeResolvedTsconfig } from "./dts/resolved-tsconfig.js";
 import { packageJsonEntries } from "./entry/package-json-entries.js";
 import { runExeBuild } from "./exe/build.js";
 import { computeExeFileName } from "./exe/filename.js";
@@ -49,4 +50,4 @@ import { ReportPipelineLive, renderReport } from "./report/pipeline.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, 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 };
+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, analyzeReexportBarrel, applySubdirMetaEntries, buildEmittedManifest, buildMetricsPlugin, buildResolvedTsconfig, buildTargetGroups, cjsDefaultInterop, collectExportNames, computeExeFileName, createEntryName, createTimer, createTsdownLogger, defaultManifestTransform, deriveExportPaths, deriveTargetGroupOptions, emitManifest, extractEntries, flattenIssues, formatTime, generateMeta, isTargetObject, nodeBuiltinDefaultInterop, normalizeBinPaths, normalizeExeOptions, normalizeLooseFiles, normalizeMetaOptions, packageJsonEntries, readTsconfigJsx, removeDeclarationMaps, renderReexportStub, renderReport, resolveJsxConfig, resolveManifest, resolveNextVersions, resolvePortableTsconfig, resolveTargets, rewriteMetaVersions, runExeBuild, runMetaPass, serializeIssues, syncPublicDir, transformBin, transformExports, transformManifest, writeDtsEmitTsconfig, writeIssuesArtifact, writeResolvedTsconfig, writeTargetsBinding };

package/jsx/config.js

@@ -1,5 +1,5 @@
-import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
 
 //#region src/jsx/config.ts
 /**

package/meta/api-extractor.js

@@ -43,7 +43,8 @@ function runApiExtractor(options) {
 			compiler: { tsconfigFilePath: options.tsconfigPath },
 			docModel: options.emitDocModel === false ? { enabled: false } : {
 				enabled: true,
-				apiJsonFilePath: options.apiJsonPath
+				apiJsonFilePath: options.apiJsonPath,
+				includeForgottenExports: true
 			},
 			...options.tsdocMetadataPath !== void 0 ? { tsdocMetadata: {
 				enabled: true,
@@ -102,4 +103,4 @@ function runApiExtractor(options) {
 }
 
 //#endregion
-export { runApiExtractor };
+export { mapExtractorMessage, runApiExtractor };

package/meta/generate.js

@@ -2,8 +2,8 @@ import { runApiExtractor } from "./api-extractor.js";
 import { mergeApiModels } from "./merge-models.js";
 import { resolvePortableTsconfig } from "./tsconfig-resolver.js";
 import { writeTsdocConfig } from "./tsdoc-config.js";
-import { join } from "node:path";
 import { copyFileSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
 
 //#region src/meta/generate.ts
 function unscopedName(name) {

package/meta/tsconfig-resolver.js

@@ -1,5 +1,5 @@
-import { join } from "node:path";
 import { existsSync } from "node:fs";
+import { join } from "node:path";
 import { JsxEmit, ModuleDetectionKind, ModuleKind, ModuleResolutionKind, NewLineKind, ScriptTarget, flattenDiagnosticMessageText, getParsedCommandLineOfConfigFile, sys } from "typescript";
 
 //#region src/meta/tsconfig-resolver.ts

package/meta/tsdoc-config.js

@@ -1,5 +1,5 @@
-import { join } from "node:path";
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
 import { StandardTags } from "@microsoft/tsdoc";
 import deepEqual from "deep-equal";
 
@@ -44,4 +44,4 @@ function writeTsdocConfig(cwd, tsdoc) {
 }
 
 //#endregion
-export { writeTsdocConfig };
+export { buildTsdocConfig, writeTsdocConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/tsdown-plugins",
-	"version": "0.11.0",
+	"version": "0.12.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/issues-artifact.js

@@ -1,5 +1,5 @@
-import { dirname, join } from "node:path";
 import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
 
 //#region src/report/issues-artifact.ts
 /** Copy a DiagnosticEntry to a plain object, omitting undefined optionals for stable output. */

package/targets/binding.js

@@ -1,5 +1,5 @@
-import { join } from "node:path";
 import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
 
 //#region src/targets/binding.ts
 /**