@savvy-web/tsdown-plugins 0.4.2 → 0.6.0

package/README.md

@@ -47,7 +47,7 @@ export default defineConfig({
 - **Executable binaries** — `normalizeExeOptions` fills the SEA defaults and infers targets from the package's `os`/`cpu`; `runExeBuild` drives `@tsdown/exe` to compile the binaries.
 - **Config validation** — the `ConfigValidator` Effect service (with `ConfigValidatorLive`) fast-fails on a bad `publishConfig.targets`, `exe` or `meta` config, raising the typed `ConfigValidationError`.
 - **dts tsconfig port** — `buildResolvedTsconfig` and `writeResolvedTsconfig` write a temp tsconfig with absolute paths so type declarations emit cleanly under pnpm symlinks.
-- **Per-target build loop** — `deriveTargetGroupOptions` and `buildTargetGroups` map a target to its `tsdown` options and run the build once per target, exposed as a helper so the escape hatch gets multi-target builds too. A `format` of `["esm", "cjs"]` (the `BuildFormat` type) derives a dual-format build — a require-able CJS output with default-export interop and `.d.cts` declarations alongside the ESM one. The `bundleNodeModules`, `bundledPackages` and `dtsExternals` options thread the dependency-bundling posture into both the JS and declaration passes. The `define` option forwards compile-time global replacements to both passes, merged with an auto-injected `process.env.__PACKAGE_VERSION__` constant.
+- **Per-target build loop** — `deriveTargetGroupOptions` and `buildTargetGroups` map a target to its `tsdown` options and run the build once per target, exposed as a helper so the escape hatch gets multi-target builds too. A `format` of `["esm", "cjs"]` (the `BuildFormat` type) derives a dual-format build — a require-able CJS output with default-export interop and `.d.cts` declarations alongside the ESM one. The `bundleNodeModules`, `bundledPackages` and `dtsExternals` options thread the dependency-bundling posture into both the JS and declaration passes. A per-entry override partition can also set `platform` (the JS-pass target, `"browser"` for a client bundle), `css` (forwarded to tsdown's `css` option for `@tsdown/css`) and `outSubdir` (build the partition into an isolated `<group>/pkg/<subdir>/` sub-package). The `define` option forwards compile-time global replacements to both passes, merged with an auto-injected `process.env.__PACKAGE_VERSION__` constant.
 - **Loose files** — `normalizeLooseFiles` resolves a `LooseFiles` map of literal output filenames to `NormalizedLooseFile` descriptors, inferring the module format from each `.mjs`/`.cjs` key and raising `ConfigValidationError` on a path separator, an unsupported extension or an ambiguous `.js`. `buildTargetGroups` takes the normalized form as its `looseFiles` option and emits one extra single-entry, bundled, declaration-free and manifest-free pass per file per target group, inheriting the group's bundling posture so each file is self-contained.
 - **Bundled declarations** — each target runs two `tsdown` passes: a JavaScript pass that preserves per-module output, then a declaration-only pass that rolls every re-exported type into a single `.d.ts` per public entry (`deriveDtsPassOptions`). Per-module JavaScript stays intact while consumers keep reaching re-exported types through your published subpaths.
 - **API Extractor meta** — `generateMeta` runs [API Extractor](https://api-extractor.com/) over a package's emitted `.d.ts` to write an api-model bundle (`.api.json`, `tsdoc-metadata.json`, resolved `tsconfig.json`); `normalizeMetaOptions` fills the `MetaOptions` defaults that drive it.

package/build/build-target-groups.js

@@ -3,7 +3,7 @@ import { cjsDefaultInterop } from "./cjs-default-interop.js";
 import { nodeBuiltinDefaultInterop } from "./node-builtin-default-interop.js";
 import { syncPublicDir } from "./sync-public.js";
 import { deriveDtsPassOptions, deriveTargetGroupOptions, outDirFor } from "./target-groups.js";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
 
 //#region src/build/build-target-groups.ts
 /**
@@ -55,27 +55,37 @@ async function buildTargetGroups(options) {
 				...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 } : {}
+				...options.define !== void 0 ? { define: options.define } : {},
+				...part.platform !== void 0 ? { platform: part.platform } : {}
 			};
 			const js = deriveTargetGroupOptions(deriveInput);
 			const dts = deriveDtsPassOptions(deriveInput);
+			const partOutDir = part.outSubdir !== void 0 ? join(js.outDir, part.outSubdir) : js.outDir;
 			const targetGroup = {
 				id: group.id,
 				name: group.name,
 				isProd: js.isProd
 			};
+			const srcDir = dirname(Object.values(part.entry)[0] ?? "");
+			const jsEntry = part.outSubdir !== void 0 ? [
+				`${srcDir}/**/*.{ts,tsx,mts,cts}`,
+				`!${srcDir}/**/*.{test,spec}.{ts,tsx,mts,cts}`,
+				`!${srcDir}/**/*.d.{ts,cts,mts}`
+			] : js.entry;
 			const manifestPlugin = isBase ? emitManifest({
 				targetGroup,
 				devManifest: options.devManifest,
 				transform: options.transform,
 				sourceDir: options.cwd,
-				dual: options.dualExports ?? js.format.includes("cjs")
+				dual: options.dualExports ?? js.format.includes("cjs"),
+				...options.subdirExports !== void 0 ? { subdirExports: options.subdirExports } : {},
+				...options.exeRewrite !== void 0 ? { exeRewrite: options.exeRewrite } : {}
 			}) : void 0;
 			await build({
 				config: false,
 				cwd: options.cwd,
-				entry: js.entry,
-				outDir: js.outDir,
+				entry: jsEntry,
+				outDir: partOutDir,
 				format: js.format,
 				platform: js.platform,
 				sourcemap: js.sourcemap,
@@ -85,6 +95,7 @@ async function buildTargetGroups(options) {
 				fixedExtension: js.fixedExtension,
 				dts: js.dts,
 				define: js.define,
+				...part.css !== void 0 ? { css: part.css } : {},
 				...partExternals?.length || partBundleNodeModules || partBundle?.length ? { deps: {
 					...partExternals?.length ? { neverBundle: partExternals } : {},
 					...partBundle?.length ? { alwaysBundle: partBundle } : {},
@@ -104,7 +115,7 @@ async function buildTargetGroups(options) {
 				config: false,
 				cwd: options.cwd,
 				entry: dts.entry,
-				outDir: dts.outDir,
+				outDir: partOutDir,
 				format: dts.format,
 				platform: dts.platform,
 				sourcemap: dts.sourcemap,

package/build/target-groups.js

@@ -15,7 +15,7 @@ function deriveTargetGroupOptions(options) {
 		format,
 		unbundle: true,
 		clean: true,
-		platform: "node",
+		platform: options.platform ?? "node",
 		fixedExtension: false,
 		entry: options.entry,
 		dts: false,

package/entry/extract.js

@@ -1,5 +1,6 @@
 //#region src/entry/extract.ts
-const isTypeScriptFile = (p) => p.endsWith(".ts") || p.endsWith(".tsx");
+const isDeclarationFile = (p) => p.endsWith(".d.ts") || p.endsWith(".d.cts") || p.endsWith(".d.mts");
+const isTypeScriptFile = (p) => !isDeclarationFile(p) && (p.endsWith(".ts") || p.endsWith(".tsx"));
 /** /dist/*.js to /src/*.ts; otherwise unchanged. */
 const resolveToTypeScript = (p) => p.endsWith(".js") && p.includes("/dist/") ? p.replace("/dist/", "/src/").replace(/\.js$/, ".ts") : p;
 /** Resolve an export value to a source path: import || default || types (NOT require). */
@@ -29,9 +30,12 @@ function extractEntries(pkg, options = {}) {
 	const entries = {};
 	const exportPaths = {};
 	const exportsAsIndexes = options.exportsAsIndexes ?? false;
+	const stripDot = (p) => p.replace(/^\.\//, "");
+	const excluded = new Set((options.excludeSources ?? []).map(stripDot));
+	const isExcluded = (src) => excluded.has(stripDot(src));
 	const exports = pkg.exports;
 	if (typeof exports === "string") {
-		if (isTypeScriptFile(exports)) {
+		if (isTypeScriptFile(exports) && !isExcluded(exports)) {
 			entries.index = exports;
 			exportPaths.index = ".";
 		}
@@ -41,6 +45,7 @@ function extractEntries(pkg, options = {}) {
 		if (!sourcePath) continue;
 		const resolved = resolveToTypeScript(sourcePath);
 		if (!isTypeScriptFile(resolved)) continue;
+		if (isExcluded(sourcePath) || isExcluded(resolved)) continue;
 		const name = createEntryName(key, exportsAsIndexes);
 		if (name in entries) {
 			const previousKey = exportPaths[name];
@@ -52,10 +57,11 @@ function extractEntries(pkg, options = {}) {
 	const bin = pkg.bin;
 	if (typeof bin === "string") {
 		const resolved = resolveToTypeScript(bin);
-		if (isTypeScriptFile(resolved)) entries["bin/cli"] = resolved;
+		if (isTypeScriptFile(resolved) && !isExcluded(bin) && !isExcluded(resolved)) entries["bin/cli"] = resolved;
 	} else if (bin && typeof bin === "object") for (const [command, p] of Object.entries(bin)) {
 		if (typeof p !== "string") continue;
 		const resolved = resolveToTypeScript(p);
+		if (isExcluded(p) || isExcluded(resolved)) continue;
 		if (isTypeScriptFile(resolved)) entries[`bin/${command}`] = resolved;
 	}
 	return {

package/entry/package-json-entries.js

@@ -5,7 +5,10 @@ import { readFileSync } from "node:fs";
 //#region src/entry/package-json-entries.ts
 /** Derive a tsdown `entry` record (name to source path) from a package.json. */
 function packageJsonEntries(options = {}) {
-	return extractEntries(options.pkg ?? JSON.parse(readFileSync(resolve(options.cwd ?? process.cwd(), "package.json"), "utf-8")), { exportsAsIndexes: options.exportsAsIndexes }).entries;
+	return extractEntries(options.pkg ?? JSON.parse(readFileSync(resolve(options.cwd ?? process.cwd(), "package.json"), "utf-8")), {
+		exportsAsIndexes: options.exportsAsIndexes,
+		excludeSources: options.excludeSources
+	}).entries;
 }
 
 //#endregion

package/exe/build.js

@@ -1,22 +1,37 @@
+import { join } from "node:path";
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+
 //#region src/exe/build.ts
 /** Compile each SEA binary via tsdown's exe mode. One tsdown build per spec. */
 async function runExeBuild(options) {
 	const build = options.build ?? (await import("tsdown")).build;
-	for (const spec of options.specs) await build({
-		cwd: options.cwd,
-		config: false,
-		entry: [spec.entry],
-		format: "esm",
-		platform: "node",
-		clean: false,
-		deps: { alwaysBundle: (id) => !id.startsWith("node:") },
-		exe: {
-			fileName: spec.fileName,
-			outDir: options.outDir,
-			seaConfig: spec.seaConfig,
-			targets: spec.targets
+	for (const spec of options.specs) {
+		const scratch = mkdtempSync(join(tmpdir(), "savvy-exe-"));
+		try {
+			await build({
+				cwd: options.cwd,
+				config: false,
+				entry: [spec.entry],
+				format: "esm",
+				platform: "node",
+				clean: false,
+				outDir: scratch,
+				deps: { alwaysBundle: (id) => !id.startsWith("node:") },
+				exe: {
+					fileName: spec.fileName,
+					outDir: options.outDir,
+					seaConfig: spec.seaConfig,
+					targets: spec.targets
+				}
+			});
+		} finally {
+			rmSync(scratch, {
+				recursive: true,
+				force: true
+			});
 		}
-	});
+	}
 }
 
 //#endregion

package/exe/filename.js

@@ -0,0 +1,12 @@
+//#region src/exe/filename.ts
+/**
+* The exact filename `@tsdown/exe` emits for a SEA target, mirroring tsdown's
+* `resolveOutputFileName`: base fileName + `-<platform>-<arch>` + `.exe` on win.
+* Single source of truth so the manifest value never drifts from the on-disk file.
+*/
+function computeExeFileName(fileName, target) {
+	return `${fileName}${`-${target.platform}-${target.arch}`}${target.platform === "win" ? ".exe" : ""}`;
+}
+
+//#endregion
+export { computeExeFileName };

package/index.d.ts

@@ -67,6 +67,19 @@ declare function defaultManifestTransform({
 }: {
   pkg: Json;
 }): Json;
+/**
+ * Describes a SEA binary the bundler compiled for this package. When present,
+ * {@link transformManifest} rewrites every `exports`/`bin` value equal to `source`
+ * to the emitted binary path and adds it to `files` so it ships in the tarball.
+ */
+interface ExeRewrite {
+  /** The exe entry source path (matches exports/bin values to rewrite). */
+  readonly source: string;
+  /** The emitted SEA filename (already suffixed, incl. .exe on win). */
+  readonly fileName: string;
+  /** Relative dir the binary is emitted into (e.g. "bin"). */
+  readonly dir: string;
+}
 /**
  * Rewrite an exports map: TS string targets become a types/import conditions object.
  * Each TS condition also gets a `require` entry when `dual` is `true` (uniform) or when
@@ -74,8 +87,11 @@ declare function defaultManifestTransform({
  *
  * The output path is derived from the export KEY via the shared entry-name function,
  * never from the source path, so the manifest target always matches the emitted file.
+ *
+ * Export keys in `subdirExports` are built into an isolated `<key>/index.*` subdir (e.g. an
+ * RSPress `./runtime`), so their conditions gain an `/index` segment.
  */
-declare function transformExports(exports: unknown, dual?: DualExports): unknown;
+declare function transformExports(exports: unknown, dual?: DualExports, subdirExports?: ReadonlySet<string>): unknown;
 /** Rewrite bin: TS targets to bin/[command].js (string to bin/cli.js); strip leading ./ otherwise. */
 declare function transformBin(bin: unknown): unknown;
 /** FINAL guard: strip leading ./ from bin paths (npm 11.x drops ./-prefixed bins). */
@@ -85,6 +101,10 @@ interface TransformManifestOptions {
   readonly transform?: ((pkg: Json) => Json) | undefined;
   /** Which exports emit dual import/require conditions. boolean = uniform; Set = per-export-key. */
   readonly dual?: DualExports | undefined;
+  /** Export keys built into a `<key>/index.*` subdir (e.g. an RSPress `./runtime`). */
+  readonly subdirExports?: ReadonlySet<string> | undefined;
+  /** When set, rewrite exports/bin values equal to `source` to the SEA path and add it to `files`. */
+  readonly exeRewrite?: ExeRewrite | undefined;
 }
 /** Apply the full standard manifest transform (excluding catalog resolution, done upstream). */
 declare function transformManifest(pkg: Json, options?: TransformManifestOptions): Json;
@@ -106,6 +126,10 @@ interface BuildEmittedManifestOptions {
   }) => Json) | undefined;
   /** Which exports emit dual import/require conditions. boolean (uniform) or a Set of export keys (per-entry). */
   readonly dual?: DualExports | undefined;
+  /** Export keys built into a `<key>/index.*` subdir (e.g. an RSPress `./runtime`). */
+  readonly subdirExports?: ReadonlySet<string> | undefined;
+  /** When set, rewrite exports/bin values equal to the exe source to the SEA path and add it to `files`. */
+  readonly exeRewrite?: ExeRewrite | undefined;
 }
 /** Compute the final manifest bytes for a TargetGroup (catalog resolution + standard transforms). */
 declare function buildEmittedManifest(options: BuildEmittedManifestOptions): Promise<Json>;
@@ -120,6 +144,10 @@ interface EmitManifestOptions {
   readonly sourceDir: string;
   /** Which exports emit dual import/require conditions. boolean (uniform) or a Set of export keys (per-entry). */
   readonly dual?: DualExports | undefined;
+  /** Export keys built into a `<key>/index.*` subdir (e.g. an RSPress `./runtime`). */
+  readonly subdirExports?: ReadonlySet<string> | undefined;
+  /** When set, rewrite exports/bin values equal to the exe source to the SEA path and add it to `files`. */
+  readonly exeRewrite?: ExeRewrite | undefined;
 }
 /** Rolldown plugin: emit the transformed package.json + LICENSE/README into the output pkg/ root. */
 declare function emitManifest(options: EmitManifestOptions): Plugin;
@@ -129,6 +157,8 @@ declare function emitManifest(options: EmitManifestOptions): Plugin;
 type TargetGroupId = string;
 /** An output module format the build can emit. */
 type BuildFormat = "esm" | "cjs";
+/** Bundling platform for the JS pass. Defaults to "node". Use "browser" for web runtime partitions. */
+type BuildPlatform = "node" | "browser" | "neutral";
 /** A prod/dev group to build: its folder id and the resolved package name its manifest carries. */
 interface BuildGroupSpec {
   readonly id: TargetGroupId;
@@ -142,6 +172,8 @@ interface DeriveOptions {
   readonly tsconfigPath: string;
   readonly devManifest: "preserve" | "resolve";
   readonly externals?: ReadonlyArray<string>;
+  /** JS-pass platform. Defaults to "node"; set "browser" for an RSPress runtime partition. */
+  readonly platform?: BuildPlatform | undefined;
   /** Output formats to emit. Defaults to esm-only when unset. */
   readonly format?: ReadonlyArray<BuildFormat> | undefined;
   /** Minify prod output (prod groups only; dev is never minified). Defaults to false. */
@@ -188,7 +220,7 @@ interface DerivedTsdownOptions {
   readonly unbundle: true;
   /** JS pass starts fresh; it owns the outDir before the dts pass appends to it. */
   readonly clean: true;
-  readonly platform: "node";
+  readonly platform: BuildPlatform;
   /**
    * Controls output file extensions. Always false for this builder.
    *
@@ -270,6 +302,19 @@ declare function normalizeLooseFiles(files: LooseFiles): ReadonlyArray<Normalize
 //#region src/build/build-target-groups.d.ts
 /** Signature compatible with tsdown's `build(inlineConfig)`. */
 type TsdownBuild = (config: Record<string, unknown>) => Promise<unknown>;
+/**
+ * CSS handling for a partition's JS pass, forwarded VERBATIM to tsdown's `css` option (consumed
+ * by `@tsdown/css`). Structurally typed so tsdown-plugins takes no dependency on `@tsdown/css`.
+ * The package whose runtime is built must install `@tsdown/css`; tsdown loads it lazily.
+ */
+interface CssOptions {
+  readonly modules?: boolean | {
+    readonly localsConvention?: string;
+    readonly namedExport?: boolean;
+    readonly [k: string]: unknown;
+  };
+  readonly [k: string]: unknown;
+}
 /**
  * One entry partition built with its own format + bundling posture, layered into the
  * SAME outDir as the base build (clean:false). Anything omitted falls back to the base
@@ -283,6 +328,17 @@ interface EntryOverride {
   readonly bundleNodeModules?: boolean | undefined;
   readonly bundledPackages?: ReadonlyArray<string> | undefined;
   readonly dtsExternals?: ReadonlyArray<string> | undefined;
+  /** JS-pass platform for this partition. Defaults to the base "node". Use "browser" for a web runtime. */
+  readonly platform?: BuildPlatform | undefined;
+  /** CSS handling forwarded to tsdown's `css` option (JS pass only). Enables `@tsdown/css`. */
+  readonly css?: CssOptions | undefined;
+  /**
+   * Build this partition into `<groupOutDir>/<outSubdir>/` instead of the shared group root.
+   * Isolates a sub-package (e.g. an RSPress `./runtime`) so its bundleless per-file output cannot
+   * collide with the base partition's output and its barrel path is deterministic. The partition's
+   * entry should be `{ index: <barrel source> }` so it emits `<outSubdir>/index.js` + `<outSubdir>/index.d.ts`.
+   */
+  readonly outSubdir?: string | undefined;
 }
 interface BuildTargetGroupsOptions {
   readonly cwd: string;
@@ -375,6 +431,10 @@ interface BuildTargetGroupsOptions {
    * `format`-includes-cjs behavior.
    */
   readonly dualExports?: DualExports | undefined;
+  /** Export keys built into a `<key>/index.*` subdir (e.g. an RSPress `./runtime`). */
+  readonly subdirExports?: ReadonlySet<string> | undefined;
+  /** When set, rewrite the emitted manifest's exports/bin values equal to the exe source to the SEA path and add it to `files`. */
+  readonly exeRewrite?: ExeRewrite | undefined;
   /** Injectable for tests; defaults to tsdown's build. */
   readonly build?: TsdownBuild;
 }
@@ -713,6 +773,8 @@ interface PackageJsonLike {
 }
 interface ExtractOptions {
   readonly exportsAsIndexes?: boolean | undefined;
+  /** Source paths to NOT turn into JS build entries (e.g. an exe entry compiled as a SEA). */
+  readonly excludeSources?: ReadonlyArray<string> | undefined;
 }
 interface ExtractResult {
   /** entry name to TS source path */
@@ -759,6 +821,14 @@ interface RunExeBuildOptions {
 /** Compile each SEA binary via tsdown's exe mode. One tsdown build per spec. */
 declare function runExeBuild(options: RunExeBuildOptions): Promise<void>;
 //#endregion
+//#region src/exe/filename.d.ts
+/**
+ * The exact filename `@tsdown/exe` emits for a SEA target, mirroring tsdown's
+ * `resolveOutputFileName`: base fileName + `-<platform>-<arch>` + `.exe` on win.
+ * Single source of truth so the manifest value never drifts from the on-disk file.
+ */
+declare function computeExeFileName(fileName: string, target: ExeTarget): string;
+//#endregion
 //#region src/meta/generate.d.ts
 interface GenerateMetaOptions {
   readonly cwd: string;
@@ -998,7 +1068,7 @@ declare class OutputRenderer extends OutputRenderer_base {}
 declare const OutputRendererLive: Layer.Layer<OutputRenderer, never, never>;
 //#endregion
 //#region src/report/pipeline.d.ts
-declare const ReportPipelineLive: Layer.Layer<FormatSelector | EnvironmentDetector | ExecutorResolver | OutputRenderer, never, never>;
+declare const ReportPipelineLive: Layer.Layer<EnvironmentDetector | ExecutorResolver | FormatSelector | OutputRenderer, never, never>;
 interface RenderReportOptions {
   readonly explicitFormat?: OutputFormat;
   /** Override env detection (mainly for tests). */
@@ -1509,5 +1579,5 @@ declare function resolveTargets(options: {
   baseName: string;
 }): TargetResolution;
 //#endregion
-export { type BuildEmittedManifestOptions, type BuildFormat, type BuildGroupSpec, type BuildReport, BuildReport as BuildReportSchema, type BuildTargetGroupsOptions, CatalogAssemblyError, CatalogResolutionError, CiAnnotationsFormatter, ConfigValidationError, ConfigValidator, ConfigValidatorLive, DEFAULT_EXE_NODE_VERSION, type DeriveOptions, type DerivedTsdownOptions, type DualExports, type EmitManifestOptions, type EntryOverride, type Environment, EnvironmentDetector, EnvironmentDetectorLive, type ExeBuild, type ExeConfig, 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 NormalizedExe, type NormalizedLooseFile, type NormalizedMeta, type OutputFormat, OutputRenderer, OutputRendererLive, type PackageJsonEntriesOptions, type PackageJsonLike, type PkgOsCpu, 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, 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 ValidationInput, type WarningSuppressionRule, buildEmittedManifest, buildResolvedTsconfig, buildTargetGroups, cjsDefaultInterop, createEntryName, createTimer, defaultManifestTransform, deriveTargetGroupOptions, emitManifest, extractEntries, formatTime, generateBuildReportSchema, generateMeta, isTargetObject, nodeBuiltinDefaultInterop, normalizeBinPaths, normalizeExeOptions, normalizeLooseFiles, normalizeMetaOptions, packageJsonEntries, readTsconfigJsx, removeDeclarationMaps, renderReport, resolveJsxConfig, resolveManifest, resolvePortableTsconfig, resolveTargets, runExeBuild, syncPublicDir, transformBin, transformExports, transformManifest, writeResolvedTsconfig, writeTargetsBinding };
+export { type BuildEmittedManifestOptions, type BuildFormat, type BuildGroupSpec, 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 DualExports, type EmitManifestOptions, 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 NormalizedExe, type NormalizedLooseFile, type NormalizedMeta, type OutputFormat, OutputRenderer, OutputRendererLive, type PackageJsonEntriesOptions, type PackageJsonLike, type PkgOsCpu, 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, 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 ValidationInput, type WarningSuppressionRule, buildEmittedManifest, buildResolvedTsconfig, buildTargetGroups, cjsDefaultInterop, computeExeFileName, createEntryName, createTimer, defaultManifestTransform, deriveTargetGroupOptions, emitManifest, extractEntries, formatTime, generateBuildReportSchema, generateMeta, isTargetObject, nodeBuiltinDefaultInterop, normalizeBinPaths, normalizeExeOptions, normalizeLooseFiles, normalizeMetaOptions, packageJsonEntries, readTsconfigJsx, removeDeclarationMaps, renderReport, resolveJsxConfig, resolveManifest, resolvePortableTsconfig, resolveTargets, runExeBuild, syncPublicDir, transformBin, transformExports, transformManifest, writeResolvedTsconfig, writeTargetsBinding };
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -18,6 +18,7 @@ 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";
 import { readTsconfigJsx, resolveJsxConfig } from "./jsx/config.js";
 import { normalizeMetaOptions } from "./meta/config.js";
 import { TsconfigResolver, resolvePortableTsconfig } from "./meta/tsconfig-resolver.js";
@@ -42,4 +43,4 @@ import { generateBuildReportSchema } from "./report/schema-export.js";
 import { writeTargetsBinding } from "./targets/binding.js";
 import { CatalogAssemblyError, CatalogResolutionError } from "workspaces-effect";
 
-export { BuildReport as BuildReportSchema, CatalogAssemblyError, CatalogResolutionError, CiAnnotationsFormatter, ConfigValidationError, ConfigValidator, ConfigValidatorLive, DEFAULT_EXE_NODE_VERSION, EnvironmentDetector, EnvironmentDetectorLive, ExecutorResolver, ExecutorResolverLive, FormatSelector, FormatSelectorLive, JsonFormatter, MarkdownFormatter, MetaGenerationError, OutputRenderer, OutputRendererLive, ReportPipelineLive, ReportTimings, SilentFormatter, TargetGroupReport as TargetGroupReportSchema, TerminalFormatter, TsconfigResolver, buildEmittedManifest, buildResolvedTsconfig, buildTargetGroups, cjsDefaultInterop, createEntryName, createTimer, defaultManifestTransform, deriveTargetGroupOptions, emitManifest, extractEntries, formatTime, generateBuildReportSchema, generateMeta, isTargetObject, nodeBuiltinDefaultInterop, normalizeBinPaths, normalizeExeOptions, normalizeLooseFiles, normalizeMetaOptions, packageJsonEntries, readTsconfigJsx, removeDeclarationMaps, renderReport, resolveJsxConfig, resolveManifest, resolvePortableTsconfig, resolveTargets, runExeBuild, syncPublicDir, transformBin, transformExports, transformManifest, writeResolvedTsconfig, writeTargetsBinding };
+export { BuildReport as BuildReportSchema, CatalogAssemblyError, CatalogResolutionError, CiAnnotationsFormatter, ConfigValidationError, ConfigValidator, ConfigValidatorLive, DEFAULT_EXE_NODE_VERSION, EnvironmentDetector, EnvironmentDetectorLive, ExecutorResolver, ExecutorResolverLive, FormatSelector, FormatSelectorLive, JsonFormatter, MarkdownFormatter, MetaGenerationError, OutputRenderer, OutputRendererLive, ReportPipelineLive, ReportTimings, SilentFormatter, TargetGroupReport as TargetGroupReportSchema, TerminalFormatter, TsconfigResolver, buildEmittedManifest, buildResolvedTsconfig, buildTargetGroups, cjsDefaultInterop, computeExeFileName, createEntryName, createTimer, defaultManifestTransform, deriveTargetGroupOptions, emitManifest, extractEntries, formatTime, generateBuildReportSchema, generateMeta, isTargetObject, nodeBuiltinDefaultInterop, normalizeBinPaths, normalizeExeOptions, normalizeLooseFiles, normalizeMetaOptions, packageJsonEntries, readTsconfigJsx, removeDeclarationMaps, renderReport, resolveJsxConfig, resolveManifest, resolvePortableTsconfig, resolveTargets, runExeBuild, syncPublicDir, transformBin, transformExports, transformManifest, writeResolvedTsconfig, writeTargetsBinding };

package/manifest/emit-manifest.js

@@ -19,7 +19,9 @@ async function buildEmittedManifest(options) {
 			pkg: p,
 			targetGroup
 		}) : void 0,
-		dual: options.dual ?? false
+		dual: options.dual ?? false,
+		subdirExports: options.subdirExports,
+		exeRewrite: options.exeRewrite
 	});
 }
 /** Rolldown plugin: emit the transformed package.json + LICENSE/README into the output pkg/ root. */
@@ -33,7 +35,9 @@ function emitManifest(options) {
 				targetGroup: options.targetGroup,
 				devManifest: options.devManifest ?? "preserve",
 				transform: options.transform,
-				dual: options.dual
+				dual: options.dual,
+				subdirExports: options.subdirExports,
+				exeRewrite: options.exeRewrite
 			});
 			this.emitFile({
 				type: "asset",

package/manifest/transform.js

@@ -42,6 +42,26 @@ function defaultManifestTransform({ pkg }) {
 	return out;
 }
 const stripLeadingDotSlash = (p) => p.startsWith("./") ? p.slice(2) : p;
+const sameSource = (a, b) => stripLeadingDotSlash(a) === stripLeadingDotSlash(b);
+/** The export-path ("./bin/<file>") and files-entry ("bin/<file>") forms for a SEA. */
+const exeRelPath = (r) => {
+	const filesEntry = `${r.dir}/${r.fileName}`;
+	return {
+		exportPath: `./${filesEntry}`,
+		filesEntry
+	};
+};
+/** Rewrite exports values that equal the exe source to a plain SEA-path string. */
+const rewriteExeExports = (exports, r) => {
+	const { exportPath } = exeRelPath(r);
+	if (typeof exports === "string") return sameSource(exports, r.source) ? exportPath : exports;
+	if (exports && typeof exports === "object") {
+		const out = {};
+		for (const [key, value] of Object.entries(exports)) out[key] = typeof value === "string" && sameSource(value, r.source) ? exportPath : value;
+		return out;
+	}
+	return exports;
+};
 /**
 * Built .js output basename for an export, derived from the entry NAME (the basename
 * the build actually emits) rather than the source path. The entry namer flattens
@@ -50,15 +70,16 @@ const stripLeadingDotSlash = (p) => p.startsWith("./") ? p.slice(2) : p;
 * always matches the file tsdown emits. The build never sets exportsAsIndexes, so the
 * manifest mirrors the flat (false) naming here.
 */
-const toBuiltJs = (exportKey) => `./${createEntryName(exportKey, false)}.js`;
-const toBuiltDts = (exportKey) => toBuiltJs(exportKey).replace(/\.js$/, ".d.ts");
-const toBuiltCjs = (exportKey) => toBuiltJs(exportKey).replace(/\.js$/, ".cjs");
-const isTs = (p) => p.endsWith(".ts") || p.endsWith(".tsx");
+const toBuiltJs = (exportKey, subdirExports) => subdirExports?.has(exportKey) ? `./${createEntryName(exportKey, false)}/index.js` : `./${createEntryName(exportKey, false)}.js`;
+const toBuiltDts = (exportKey, subdirExports) => toBuiltJs(exportKey, subdirExports).replace(/\.js$/, ".d.ts");
+const toBuiltCjs = (exportKey, subdirExports) => toBuiltJs(exportKey, subdirExports).replace(/\.js$/, ".cjs");
+const isDeclarationFile = (p) => p.endsWith(".d.ts") || p.endsWith(".d.cts") || p.endsWith(".d.mts");
+const isTs = (p) => !isDeclarationFile(p) && (p.endsWith(".ts") || p.endsWith(".tsx"));
 /** Build the conditions object for a TS export target (adds require when dual-format). */
-const tsConditions = (exportKey, dual) => ({
-	types: toBuiltDts(exportKey),
-	import: toBuiltJs(exportKey),
-	...dual ? { require: toBuiltCjs(exportKey) } : {}
+const tsConditions = (exportKey, dual, subdirExports) => ({
+	types: toBuiltDts(exportKey, subdirExports),
+	import: toBuiltJs(exportKey, subdirExports),
+	...dual ? { require: toBuiltCjs(exportKey, subdirExports) } : {}
 });
 /**
 * Rewrite an exports map: TS string targets become a types/import conditions object.
@@ -67,9 +88,12 @@ const tsConditions = (exportKey, dual) => ({
 *
 * The output path is derived from the export KEY via the shared entry-name function,
 * never from the source path, so the manifest target always matches the emitted file.
+*
+* Export keys in `subdirExports` are built into an isolated `<key>/index.*` subdir (e.g. an
+* RSPress `./runtime`), so their conditions gain an `/index` segment.
 */
-function transformExports(exports, dual = false) {
-	if (typeof exports === "string") return isTs(exports) ? tsConditions(".", isDualKey(dual, ".")) : exports;
+function transformExports(exports, dual = false, subdirExports) {
+	if (typeof exports === "string") return isTs(exports) ? tsConditions(".", isDualKey(dual, "."), subdirExports) : exports;
 	if (exports && typeof exports === "object") {
 		const out = {};
 		for (const [key, value] of Object.entries(exports)) {
@@ -77,8 +101,8 @@ function transformExports(exports, dual = false) {
 				out[key] = value;
 				continue;
 			}
-			if (typeof value === "string" && isTs(value)) out[key] = tsConditions(key, isDualKey(dual, key));
-			else out[key] = transformExports(value, dual);
+			if (typeof value === "string" && isTs(value)) out[key] = tsConditions(key, isDualKey(dual, key), subdirExports);
+			else out[key] = transformExports(value, dual, subdirExports);
 		}
 		return out;
 	}
@@ -112,9 +136,24 @@ function transformManifest(pkg, options = {}) {
 		...rest,
 		private: isPrivate
 	};
+	if (options.exeRewrite) {
+		const r = options.exeRewrite;
+		const { exportPath, filesEntry } = exeRelPath(r);
+		if (result.exports !== void 0 && result.exports !== null) result.exports = rewriteExeExports(result.exports, r);
+		if (typeof result.bin === "string") {
+			if (sameSource(result.bin, r.source)) result.bin = exportPath;
+		} else if (result.bin && typeof result.bin === "object") {
+			const nextBin = {};
+			for (const [cmd, val] of Object.entries(result.bin)) nextBin[cmd] = sameSource(val, r.source) ? exportPath : val;
+			result.bin = nextBin;
+		}
+		const files = Array.isArray(result.files) ? result.files.slice() : [];
+		if (!files.includes(filesEntry)) files.push(filesEntry);
+		result.files = files;
+	}
 	if (result.exports !== void 0 && result.exports !== null) {
 		const original = result.exports;
-		const transformed = transformExports(original, options.dual ?? false);
+		const transformed = transformExports(original, options.dual ?? false, options.subdirExports);
 		const asMap = typeof original === "string" ? { ".": transformed } : { ...transformed };
 		if (!("./package.json" in asMap)) asMap["./package.json"] = "./package.json";
 		result.exports = asMap;

package/meta/tsconfig-resolver.js

@@ -97,6 +97,7 @@ var TsconfigResolver = class TsconfigResolver {
 		[ScriptTarget.ES2022, "es2022"],
 		[ScriptTarget.ES2023, "es2023"],
 		[ScriptTarget.ES2024, "es2024"],
+		[ScriptTarget.ES2025, "es2025"],
 		[ScriptTarget.ESNext, "esnext"],
 		[ScriptTarget.JSON, "json"]
 	]);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/tsdown-plugins",
-	"version": "0.4.2",
+	"version": "0.6.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",
@@ -33,7 +33,7 @@
 		"@microsoft/tsdoc": "^0.16.0",
 		"@microsoft/tsdoc-config": "^0.18.1",
 		"deep-equal": "^2.2.3",
-		"json-schema-effect": "^0.2.2",
+		"json-schema-effect": "^0.2.4",
 		"picocolors": "^1.1.1",
 		"sort-package-json": "^4.0.0",
 		"std-env": "^4.1.0",