@savvy-web/tsdown-plugins 0.5.0 → 0.6.0

package/build/build-target-groups.js

@@ -78,7 +78,8 @@ async function buildTargetGroups(options) {
 				transform: options.transform,
 				sourceDir: options.cwd,
 				dual: options.dualExports ?? js.format.includes("cjs"),
-				...options.subdirExports !== void 0 ? { subdirExports: options.subdirExports } : {}
+				...options.subdirExports !== void 0 ? { subdirExports: options.subdirExports } : {},
+				...options.exeRewrite !== void 0 ? { exeRewrite: options.exeRewrite } : {}
 			}) : void 0;
 			await build({
 				config: false,

package/entry/extract.js

@@ -30,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 = ".";
 		}
@@ -42,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];
@@ -53,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
@@ -90,6 +103,8 @@ interface TransformManifestOptions {
   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;
@@ -113,6 +128,8 @@ interface BuildEmittedManifestOptions {
   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>;
@@ -129,6 +146,8 @@ interface EmitManifestOptions {
   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;
@@ -414,6 +433,8 @@ interface BuildTargetGroupsOptions {
   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;
 }
@@ -752,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 */
@@ -798,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;
@@ -1548,5 +1579,5 @@ declare function resolveTargets(options: {
   baseName: string;
 }): TargetResolution;
 //#endregion
-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 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

@@ -20,7 +20,8 @@ async function buildEmittedManifest(options) {
 			targetGroup
 		}) : void 0,
 		dual: options.dual ?? false,
-		subdirExports: options.subdirExports
+		subdirExports: options.subdirExports,
+		exeRewrite: options.exeRewrite
 	});
 }
 /** Rolldown plugin: emit the transformed package.json + LICENSE/README into the output pkg/ root. */
@@ -35,7 +36,8 @@ function emitManifest(options) {
 				devManifest: options.devManifest ?? "preserve",
 				transform: options.transform,
 				dual: options.dual,
-				subdirExports: options.subdirExports
+				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
@@ -116,6 +136,21 @@ 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, options.subdirExports);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/tsdown-plugins",
-	"version": "0.5.0",
+	"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",