@savvy-web/tsdown-plugins 0.2.0 → 0.3.0

package/README.md

@@ -40,14 +40,14 @@ export default defineConfig({
 ## Features
 
 - **Entry detection** — `packageJsonEntries` and `extractEntries` derive build entries from a package's `exports` and `bin`, matching the rules used across the Silk Suite builders.
-- **Manifest transforms** — `transformManifest`, `transformExports`, `transformBin` and `normalizeBinPaths` rewrite a source `package.json` into a publishable one; `emitManifest` is the rolldown plugin that writes it. A dual-format build emits both `import` and `require` export conditions.
+- **Manifest transforms** — `transformManifest`, `transformExports`, `transformBin` and `normalizeBinPaths` rewrite a source `package.json` into a publishable one; `emitManifest` is the rolldown plugin that writes it. A dual-format build emits both `import` and `require` export conditions, and a `"./package.json": "./package.json"` entry is added to the exports map so consumers can `import "<pkg>/package.json"`.
 - **Catalog resolution** — `resolveManifest` resolves `catalog:` and `workspace:` specifiers against the workspace, delegating to `workspaces-effect`'s `CatalogResolver`.
 - **Multi-target resolution** — `resolveTargets` turns a `publishConfig.targets` map into the distinct byte-variant groups to build and the registry bindings for each; `writeTargetsBinding` persists that resolution as `dist/prod/targets.json` for the release step.
 - **JSX resolution** — `resolveJsxConfig` and `readTsconfigJsx` derive the effective JSX transform from a package's tsconfig, with an explicit override winning.
 - **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.
+- **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.
 - **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.
 - **Output reporter** — `renderReport` plus the `BuildReport` schema and a set of formatters (terminal, JSON, markdown, CI annotations, silent) render a build report for humans, agents or CI.

package/build/build-target-groups.js

@@ -54,7 +54,8 @@ async function buildTargetGroups(options) {
 				...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.jsx !== void 0 ? { jsx: options.jsx } : {},
+				...options.define !== void 0 ? { define: options.define } : {}
 			};
 			const js = deriveTargetGroupOptions(deriveInput);
 			const dts = deriveDtsPassOptions(deriveInput);

package/build/target-groups.js

@@ -18,7 +18,10 @@ function deriveTargetGroupOptions(options) {
 		fixedExtension: false,
 		entry: options.entry,
 		dts: false,
-		define: { __PACKAGE_VERSION__: JSON.stringify(options.version) },
+		define: {
+			"process.env.__PACKAGE_VERSION__": JSON.stringify(options.version),
+			...options.define
+		},
 		isProd,
 		...hasCjs ? { cjsDefault: true } : {},
 		...options.jsx !== void 0 ? { jsx: options.jsx } : {}
@@ -41,7 +44,10 @@ function deriveDtsPassOptions(options) {
 			tsconfig: options.tsconfigPath,
 			emitDtsOnly: true
 		},
-		define: { __PACKAGE_VERSION__: JSON.stringify(options.version) },
+		define: {
+			"process.env.__PACKAGE_VERSION__": JSON.stringify(options.version),
+			...options.define
+		},
 		isProd,
 		...options.jsx !== void 0 ? { jsx: options.jsx } : {},
 		...options.bundledPackages !== void 0 ? { bundledPackages: options.bundledPackages } : {}

package/index.d.ts

@@ -148,6 +148,12 @@ interface DeriveOptions {
   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.
+   * Values are inserted verbatim (string literals must already be quoted).
+   */
+  readonly define?: Record<string, string> | undefined;
   /**
    * External packages whose declarations should be INLINED into the bundled dts
    * (the rslib `dtsBundledPackages` equivalent). Maps to tsdown's `deps.onlyBundle`
@@ -309,6 +315,12 @@ interface BuildTargetGroupsOptions {
   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
+   * `process.env.__PACKAGE_VERSION__` so a user key of the same name wins.
+   */
+  readonly define?: Record<string, string> | undefined;
   /**
    * Entry partitions with their own format/bundling, built into the same outDir after
    * the base entries. Used for per-entry format overrides (e.g. one CJS entry in an

package/manifest/transform.js

@@ -112,7 +112,13 @@ function transformManifest(pkg, options = {}) {
 		...rest,
 		private: isPrivate
 	};
-	if (result.exports) result.exports = transformExports(result.exports, options.dual ?? false);
+	if (result.exports !== void 0 && result.exports !== null) {
+		const original = result.exports;
+		const transformed = transformExports(original, options.dual ?? false);
+		const asMap = typeof original === "string" ? { ".": transformed } : { ...transformed };
+		if (!("./package.json" in asMap)) asMap["./package.json"] = "./package.json";
+		result.exports = asMap;
+	}
 	if (result.bin) result.bin = transformBin(result.bin);
 	if (options.transform) result = options.transform(result);
 	if (result.bin) result.bin = normalizeBinPaths(result.bin);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/tsdown-plugins",
-	"version": "0.2.0",
+	"version": "0.3.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",
@@ -24,7 +24,8 @@
 		".": {
 			"types": "./index.d.ts",
 			"import": "./index.js"
-		}
+		},
+		"./package.json": "./package.json"
 	},
 	"dependencies": {
 		"@effect/platform-node": "^0.106.0",
@@ -34,7 +35,7 @@
 		"deep-equal": "^2.2.3",
 		"json-schema-effect": "^0.2.1",
 		"picocolors": "^1.1.1",
-		"sort-package-json": "^3.6.1",
+		"sort-package-json": "^4.0.0",
 		"std-env": "^4.1.0",
 		"typescript": "^6.0.3",
 		"workspaces-effect": "^1.2.0"