@codefast/cli 0.3.16-canary.2 → 0.3.16-canary.3

package/README.md

@@ -21,6 +21,10 @@ A small developer CLI for maintenance tasks in a TypeScript monorepo — Tailwin
 - [`mirror sync`](#mirror-sync)
 - [`tag` / `annotate`](#tag--annotate)
 - [Configuration (`codefast.config.*`)](#configuration-codefastconfig)
+  - [Full skeleton](#full-skeleton)
+  - [`mirror` configuration](#mirror-configuration)
+  - [`tag` configuration](#tag-configuration)
+  - [`arrange` configuration](#arrange-configuration)
 - [Lifecycle hooks](#lifecycle-hooks)
 - [Grouping philosophy — Render Pipeline Order](#grouping-philosophy--render-pipeline-order)
 - [Troubleshooting](#troubleshooting)
@@ -228,37 +232,46 @@ What it updates:
 
 ## Configuration (`codefast.config.*`)
 
-Create `codefast.config.js`, `.mjs`, `.cjs`, or `.json` at the repo root. Each command reads its own slice.
+Create a config file at the **monorepo root** (next to `pnpm-workspace.yaml`). Supported names, in priority order:
+
+| File name              | Format                                  |
+| ---------------------- | --------------------------------------- |
+| `codefast.config.mjs`  | ES module — `export default { … }`      |
+| `codefast.config.js`   | ES module (if `"type":"module"`) or CJS |
+| `codefast.config.cjs`  | CommonJS — `module.exports = { … }`     |
+| `codefast.config.json` | Plain JSON (no functions — no hooks)    |
+
+The file is found by walking up from the working directory, so running the CLI from any sub-directory still picks up the root config.
+
+> **Security.** `.js`, `.mjs`, and `.cjs` files are executed via `import()`. Only run `codefast` inside repositories you trust.
+
+---
+
+### Full skeleton
 
 ```javascript
 // codefast.config.mjs
 import { execSync } from "node:child_process";
 
 export default {
+  // ─── mirror ────────────────────────────────────────────────────────────────
+  // Keys are package names (from package.json#name).
+  // Set a package to `false` to skip it entirely.
+  // Omit a package to process it with default settings.
   mirror: {
-    skipPackages: ["@acme/internal"],
-    pathTransformations: {
-      "@acme/ui": { removePrefix: "./components/" },
-    },
-    customExports: {
-      "@acme/ui": {
-        "./css/*": "./src/styles/*",
-      },
-    },
-    cssExports: {
-      // Shorthand: `true` enables default CSS export detection
-      "@acme/theme": true,
-      // Or configure explicitly:
-      "@acme/ui": {
-        enabled: true,
-        forceExportFiles: false,
-        customExports: {
-          "./tokens.css": "./dist/tokens.css",
-        },
-      },
+    "@acme/ui": {
+      strip: "./components/",
+      exports: { "./css/*": "./src/css/*" },
+      source: true, // default: true
+      types: true, // default: true
+      import: true, // default: true
+      css: true,
     },
+    "@acme/internal": false,
+    "@acme/docs": false,
   },
 
+  // ─── tag ───────────────────────────────────────────────────────────────────
   tag: {
     skipPackages: ["@acme/internal"],
     onAfterWrite: ({ files }) => {
@@ -266,6 +279,7 @@ export default {
     },
   },
 
+  // ─── arrange ───────────────────────────────────────────────────────────────
   arrange: {
     onAfterWrite: ({ files }) => {
       execSync(`oxfmt ${files.join(" ")}`, { stdio: "inherit" });
@@ -274,31 +288,177 @@ export default {
 };
 ```
 
-Notes:
+---
+
+### `mirror` configuration
+
+`mirror` is a record keyed by **package name** (the `name` field in the package's `package.json`, e.g. `"@acme/ui"`).
+
+#### Skipping a package
+
+Set a package to `false` to exclude it from `codefast mirror sync` entirely:
+
+```javascript
+mirror: {
+  "@acme/internal": false,
+  "@acme/docs": false,
+}
+```
+
+Packages not mentioned in the config are processed with default settings.
+
+#### Per-package options
+
+Each package entry is an object with the following fields:
+
+| Field      | Type                     | Default | Description                                                                                                                                                                                                                                |
+| ---------- | ------------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `source`   | `boolean \| string`      | `true`  | Add a `source` condition to each export entry pointing to the original `.ts` file. `true` auto-derives the path (`./src/<module>.ts`). Pass a string to set the root-export path explicitly (`"./src/index.tsx"`). Set to `false` to omit. |
+| `types`    | `boolean`                | `true`  | Include the `types` condition when a `.d.ts` file is present. Set to `false` to omit.                                                                                                                                                      |
+| `import`   | `boolean`                | `true`  | Include the `import` condition. Set to `false` to omit (useful for CJS-only packages).                                                                                                                                                     |
+| `strip`    | `string`                 | —       | Strip a leading path segment from generated export specifiers. See below.                                                                                                                                                                  |
+| `exports`  | `Record<string, string>` | —       | Add or override specific export specifiers. See below.                                                                                                                                                                                     |
+| `preserve` | `boolean`                | —       | Keep the existing `package.json#exports` and only fill in missing conditions.                                                                                                                                                              |
+| `css`      | `boolean \| CssConfig`   | —       | Enable CSS export detection. See below.                                                                                                                                                                                                    |
+
+#### `strip`
+
+Removes a fixed prefix from every generated export specifier. Use this when a package's `dist/` mirrors deep directory structure that you want to flatten in the public API.
+
+```javascript
+// Without strip, dist/components/button.mjs → "./components/button"
+// With strip: "./components/", it becomes → "./button"
+"@acme/ui": {
+  strip: "./components/",
+}
+```
+
+The original file path is preserved for sorting — only the public specifier changes.
+
+#### `exports`
 
-- Keys in `mirror.skipPackages` / `pathTransformations` / `customExports` / `cssExports` are **package names** from `package.json#name` (e.g. `@acme/ui`). Path-based keys such as `packages/ui` are deprecated and will be removed.
-- `cssExports[pkg]` accepts a boolean shorthand or the full `{ enabled, customExports, forceExportFiles }` object.
-- `tag.skipPackages` lists package names to skip entirely when `codefast tag` is run without an explicit target.
+Adds or overrides specific specifiers in the final export map. Keys and values are the exact strings written into `package.json#exports`.
 
-> **Security.** `.js`, `.mjs`, and `.cjs` config files are loaded via `import()` — only run `codefast` inside repositories you trust.
+```javascript
+"@acme/ui": {
+  exports: {
+    "./css/*": "./src/css/*",        // wildcard passthrough to sources
+    "./tokens": "./dist/tokens.js",  // explicit extra entry
+  },
+}
+```
+
+Extra entries are merged after auto-generation. They win over anything the scanner would produce for the same specifier. `./package.json` cannot be overridden.
+
+#### `preserve`
+
+Keeps the existing `package.json#exports` map exactly as-is and only fills in missing conditions (`source`, `types`, `import`) for each entry — no `dist/` scan is performed. Use this when you maintain the exports map by hand and only want the CLI to supplement missing conditions.
+
+```javascript
+"@acme/tailwind-variants": {
+  preserve: true,
+}
+```
+
+#### `css`
+
+Controls CSS file export generation. `mirror sync` scans `dist/` for `.css` files and writes wildcard or per-file export entries.
+
+```javascript
+// Shorthand: auto-detect all CSS files in dist/
+"@acme/theme": { css: true }
+
+// Full config:
+"@acme/ui": {
+  css: {
+    enabled: true,
+    // Force individual file entries instead of directory wildcards:
+    forceExportFiles: false,
+    // Manually add or override individual CSS specifiers:
+    customExports: {
+      "./tokens.css": "./dist/tokens.css",
+    },
+  },
+}
+
+// Explicitly disable CSS exports for this package:
+"@acme/legacy": { css: false }
+```
+
+When `css` is omitted, CSS files found in `dist/` are still exported by default.
+
+#### What `mirror sync` writes
+
+For a package with `dist/button.mjs`, `dist/button.d.ts`, and `source: true`, the generated export entry looks like:
+
+```json
+{
+  "./button": {
+    "source": "./src/button.ts",
+    "types": "./dist/button.d.ts",
+    "import": "./dist/button.mjs"
+  }
+}
+```
+
+It also updates the top-level `main`, `module`, and `types` fields from the root (`.`) export, and ensures `"dist"` is listed in `files`.
+
+---
+
+### `tag` configuration
+
+```javascript
+tag: {
+  // Package names to skip when running without an explicit target
+  skipPackages: ["@acme/internal", "@acme/docs"],
+
+  // Called after files are written — use it to format or lint-fix
+  onAfterWrite: ({ files }) => {
+    execSync(`prettier --write ${files.join(" ")}`, { stdio: "inherit" });
+  },
+}
+```
+
+| Field          | Type                                                  | Description                                                                                                                         |
+| -------------- | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `skipPackages` | `string[]`                                            | Package names to skip when `codefast tag` is run without an explicit target. Has no effect when a target path is provided directly. |
+| `onAfterWrite` | `(ctx: { files: string[] }) => void \| Promise<void>` | Lifecycle hook — runs after files are written.                                                                                      |
+
+---
+
+### `arrange` configuration
+
+```javascript
+arrange: {
+  // Called after files are written by `codefast arrange apply`
+  onAfterWrite: ({ files }) => {
+    execSync(`oxfmt ${files.join(" ")}`, { stdio: "inherit" });
+  },
+}
+```
+
+| Field          | Type                                                  | Description                                                                                |
+| -------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------------ |
+| `onAfterWrite` | `(ctx: { files: string[] }) => void \| Promise<void>` | Lifecycle hook — runs after `arrange apply` writes files. Not called by `arrange preview`. |
 
 ---
 
 ## Lifecycle hooks
 
-Both `tag` and `arrange apply` expose an `onAfterWrite` hook so teams can plug in their own formatter, lint-fix step, or codemod without embedding one in the CLI core.
+Both `tag` and `arrange apply` call `onAfterWrite` immediately after writing files to disk. The hook receives the list of written file paths and can run any synchronous or asynchronous work — formatters, linters, codegen, notifications.
 
 ```javascript
 export default {
   tag: {
     onAfterWrite: async ({ files }) => {
-      console.log(`Formatting ${files.length} files…`);
-      // sync or async work
+      // async is supported
+      await runFormatter(files);
     },
   },
   arrange: {
     onAfterWrite: ({ files }) => {
-      /* … */
+      // sync is fine too
+      execSync(`oxfmt ${files.join(" ")}`, { stdio: "inherit" });
     },
   },
 };
@@ -306,10 +466,11 @@ export default {
 
 Contract:
 
-- `tag.onAfterWrite?.({ files })` runs after `codefast tag` writes files.
-- `arrange.onAfterWrite?.({ files })` runs after `codefast arrange apply` writes files.
-- Hooks may be synchronous or asynchronous (`void | Promise<void>`).
-- Hook failures are reported on stderr; both commands exit with code `1` when the hook rejects.
+- `tag.onAfterWrite` fires after `codefast tag` writes JSDoc annotations.
+- `arrange.onAfterWrite` fires after `codefast arrange apply` rewrites class strings.
+- Hook is **not** called on `--dry-run` or `arrange preview`.
+- Hooks may be synchronous or `async` (`void | Promise<void>`).
+- If the hook throws or rejects, the command reports the error on stderr and exits with code `1`.
 
 ---
 

package/dist/core/config/schema.mjs

@@ -1,20 +1,41 @@
 import { z } from "zod";
 //#region src/core/config/schema.ts
 const afterWriteHookSchema = z.custom((value) => typeof value === "function", { message: "Expected a function" });
+const mirrorCssConfigSchema = z.union([z.boolean(), z.object({
+	enabled: z.boolean().optional(),
+	customExports: z.record(z.string(), z.string()).optional(),
+	forceExportFiles: z.boolean().optional()
+}).strict()]);
 /**
+* Per-package mirror configuration. Setting a package to `false` skips it entirely.
+*
+* - `source` — include a `source` condition pointing to the original `.ts` file (default `true`).
+*   Pass a string to override the root-export source path explicitly.
+* - `types` — include the `types` condition when `.d.ts` files exist (default `true`).
+* - `import` — include the `import` condition (default `true`).
+* - `css` — CSS export configuration (wildcard or per-file).
+*
 * @since 0.3.16-canary.0
 */
-const mirrorConfigSchema = z.object({
-	skipPackages: z.array(z.string()).optional(),
-	pathTransformations: z.record(z.string(), z.object({ removePrefix: z.string().optional() }).strict()).optional(),
-	customExports: z.record(z.string(), z.record(z.string(), z.string())).optional(),
-	cssExports: z.record(z.string(), z.union([z.boolean(), z.object({
-		enabled: z.boolean().optional(),
-		customExports: z.record(z.string(), z.string()).optional(),
-		forceExportFiles: z.boolean().optional()
-	}).strict()])).optional()
+const mirrorPackageConfigSchema = z.object({
+	/** Preserve the existing `package.json#exports` map and only add missing conditions
+	*  (`source`, `types`, `import`). No dist/ scan is performed. */
+	preserve: z.boolean().optional(),
+	strip: z.string().optional(),
+	exports: z.record(z.string(), z.string()).optional(),
+	source: z.union([z.boolean(), z.string()]).default(true),
+	types: z.boolean().default(true),
+	import: z.boolean().default(true),
+	css: mirrorCssConfigSchema.optional()
 }).strict();
 /**
+* Mirror config: a record keyed by package name. Set a package to `false` to skip it;
+* omit it entirely to process it with default settings.
+*
+* @since 0.3.16-canary.0
+*/
+const mirrorConfigSchema = z.record(z.string(), z.union([z.literal(false), mirrorPackageConfigSchema]));
+/**
 * @since 0.3.16-canary.0
 */
 const codefastTagConfigSchema = z.object({
@@ -36,4 +57,4 @@ const codefastConfigRootSchema = z.object({
 	arrange: codefastArrangeConfigSchema.optional()
 }).strict();
 //#endregion
-export { codefastArrangeConfigSchema, codefastConfigRootSchema, codefastTagConfigSchema, mirrorConfigSchema };
+export { codefastArrangeConfigSchema, codefastConfigRootSchema, codefastTagConfigSchema, mirrorConfigSchema, mirrorPackageConfigSchema };

package/dist/mirror/domain/exports.mjs

@@ -1,10 +1,6 @@
 import { PACKAGE_JSON_EXPORT, VALID_DTS_EXTENSIONS, VALID_JS_EXTENSIONS } from "./constants.mjs";
 import * as nodePath from "node:path";
 //#region src/mirror/domain/exports.ts
-function resolvePackageScopedConfig(configMap, pkgMeta) {
-	if (!configMap) return;
-	return configMap[pkgMeta.packageName];
-}
 function groupDistFilesByModule(relativeDistFiles) {
 	const distModulesByPath = /* @__PURE__ */ new Map();
 	for (const relativeDistFile of relativeDistFiles) {
@@ -110,14 +106,11 @@ function getExportSortGroup(exportPath, pathTransform) {
 /**
 * @since 0.3.16-canary.0
 */
-function createPathTransform(config, pkgMeta) {
-	const pathConfig = resolvePackageScopedConfig(config?.pathTransformations, pkgMeta);
-	if (!pathConfig) return null;
-	const { removePrefix } = pathConfig;
-	if (!removePrefix) return null;
+function createPathTransform(strip) {
+	if (!strip) return null;
 	return (exportPath) => {
-		if (!exportPath.startsWith(removePrefix)) return exportPath;
-		const trimmedExportPath = exportPath.slice(removePrefix.length);
+		if (!exportPath.startsWith(strip)) return exportPath;
+		const trimmedExportPath = exportPath.slice(strip.length);
 		if (trimmedExportPath && trimmedExportPath !== "." && !trimmedExportPath.startsWith("./")) return `./${trimmedExportPath}`;
 		return trimmedExportPath;
 	};
@@ -174,7 +167,7 @@ async function generateCssExports(fileSystemService, distDir, cssConfig) {
 *
 * @since 0.3.16-canary.0
 */
-async function generateExports(fileSystemService, distDir, pathTransform, cssConfig, customExports) {
+async function generateExports(fileSystemService, distDir, pathTransform, cssConfig, extraExports, options) {
 	const relativeDistFiles = await fileSystemService.listRelativeFilesRecursively(distDir);
 	if (!relativeDistFiles.length) return {
 		exports: { [PACKAGE_JSON_EXPORT]: PACKAGE_JSON_EXPORT },
@@ -197,10 +190,14 @@ async function generateExports(fileSystemService, distDir, pathTransform, cssCon
 		let exportPath = originalExportPath;
 		if (pathTransform) exportPath = pathTransform(exportPath);
 		const exportEntry = {};
+		if (options?.source) if (typeof options.source === "string" && exportPath === ".") exportEntry.source = options.source;
+		else exportEntry.source = (options.resolveSourcePath ?? ((p) => `./src/${p}.ts`))(distModuleEntry.path);
 		const declarationFile = distModuleEntry.files.dts;
-		if (declarationFile) exportEntry.types = `./dist/${declarationFile}`;
-		if (distModuleEntry.files.mjs) exportEntry.import = `./dist/${distModuleEntry.files.mjs}`;
-		else if (distModuleEntry.files.js) exportEntry.import = `./dist/${distModuleEntry.files.js}`;
+		if (declarationFile && options?.types !== false) exportEntry.types = `./dist/${declarationFile}`;
+		if (options?.import !== false) {
+			if (distModuleEntry.files.mjs) exportEntry.import = `./dist/${distModuleEntry.files.mjs}`;
+			else if (distModuleEntry.files.js) exportEntry.import = `./dist/${distModuleEntry.files.js}`;
+		}
 		if (distModuleEntry.files.cjs) exportEntry.require = `./dist/${distModuleEntry.files.cjs}`;
 		moduleExportsBySpecifier[exportPath] = exportEntry;
 		originalPathBySpecifier[exportPath] = originalExportPath;
@@ -210,9 +207,9 @@ async function generateExports(fileSystemService, distDir, pathTransform, cssCon
 	for (const exportKey of sortedSpecifiers) sortedExports[exportKey] = moduleExportsBySpecifier[exportKey];
 	const cssExports = await generateCssExports(fileSystemService, distDir, cssConfig ?? { enabled: true });
 	Object.assign(sortedExports, cssExports);
-	for (const [specifier, mappedPath] of Object.entries(customExports || {})) if (specifier !== "./package.json") sortedExports[specifier] = mappedPath;
+	for (const [specifier, mappedPath] of Object.entries(extraExports || {})) if (specifier !== "./package.json") sortedExports[specifier] = mappedPath;
 	for (const cssSpecifier of Object.keys(cssExports)) if (!(cssSpecifier in originalPathBySpecifier)) originalPathBySpecifier[cssSpecifier] = cssSpecifier;
-	for (const customSpecifier of Object.keys(customExports || {})) if (customSpecifier !== "./package.json" && !(customSpecifier in originalPathBySpecifier)) originalPathBySpecifier[customSpecifier] = customSpecifier;
+	for (const extraSpecifier of Object.keys(extraExports || {})) if (extraSpecifier !== "./package.json" && !(extraSpecifier in originalPathBySpecifier)) originalPathBySpecifier[extraSpecifier] = extraSpecifier;
 	sortedSpecifiers = Object.keys(sortedExports).filter((exportKey) => exportKey !== PACKAGE_JSON_EXPORT).sort((leftSpecifier, rightSpecifier) => compareExportSortKeys(getExportSortKey(leftSpecifier, pathTransform), getExportSortKey(rightSpecifier, pathTransform)));
 	const finalExports = {};
 	for (const exportKey of sortedSpecifiers) finalExports[exportKey] = sortedExports[exportKey];

package/dist/mirror/supplement-exports.mjs

@@ -0,0 +1,114 @@
+import { DIST_DIR } from "./domain/constants.mjs";
+import { writePackageJsonExportsAtomic } from "./write-exports.mjs";
+import path from "node:path";
+//#region src/mirror/supplement-exports.ts
+const DTS_EXTENSIONS = [
+	".d.mts",
+	".d.ts",
+	".d.cts"
+];
+const JS_EXTENSIONS = [".mjs", ".js"];
+/**
+* Infer the dist module path (e.g. `"index"`, `"components/button"`) from an existing
+* conditional export entry. Prefers `import` / `require` values because their extensions
+* are simpler than `.d.mts` etc.
+*/
+function inferModulePath(specifier, entry) {
+	for (const key of ["import", "require"]) {
+		const value = entry[key];
+		if (typeof value === "string" && value.startsWith("./dist/")) {
+			const relative = value.slice(7);
+			for (const ext of JS_EXTENSIONS) if (relative.endsWith(ext)) return relative.slice(0, -ext.length);
+		}
+	}
+	const typesValue = entry.types;
+	if (typeof typesValue === "string" && typesValue.startsWith("./dist/")) {
+		const relative = typesValue.slice(7);
+		for (const ext of DTS_EXTENSIONS) if (relative.endsWith(ext)) return relative.slice(0, -ext.length);
+	}
+	if (specifier === ".") return "index";
+	if (specifier.startsWith("./")) return specifier.slice(2);
+	return specifier;
+}
+function findDtsSpecifier(fs, distDir, modulePath) {
+	for (const ext of DTS_EXTENSIONS) if (fs.existsSync(path.join(distDir, `${modulePath}${ext}`))) return `./dist/${modulePath}${ext}`;
+	return null;
+}
+function findImportSpecifier(fs, distDir, modulePath) {
+	for (const ext of JS_EXTENSIONS) if (fs.existsSync(path.join(distDir, `${modulePath}${ext}`))) return `./dist/${modulePath}${ext}`;
+	return null;
+}
+/**
+* Rebuild an export entry in canonical key order, adding any missing conditions.
+* Key order: source → types → import → require → (remaining original keys).
+*/
+function buildSupplementedEntry(specifier, existing, modulePath, distDir, fs, options) {
+	const result = {};
+	const knownKeys = new Set([
+		"source",
+		"types",
+		"import",
+		"require"
+	]);
+	if ("source" in existing) result.source = existing.source;
+	else if (options.source) if (typeof options.source === "string" && specifier === ".") result.source = options.source;
+	else result.source = options.resolveSourcePath(modulePath);
+	if ("types" in existing) result.types = existing.types;
+	else if (options.types) {
+		const found = findDtsSpecifier(fs, distDir, modulePath);
+		if (found) result.types = found;
+	}
+	if ("import" in existing) result.import = existing.import;
+	else if (options.import) {
+		const found = findImportSpecifier(fs, distDir, modulePath);
+		if (found) result.import = found;
+	}
+	if ("require" in existing) result.require = existing.require;
+	for (const [key, value] of Object.entries(existing)) if (!knownKeys.has(key) && !(key in result)) result[key] = value;
+	return result;
+}
+/**
+* @since 0.3.16-canary.0
+*/
+async function supplementExportsInPackageJson(fs, packageJsonPath, packageDir, options) {
+	const raw = await fs.readFile(packageJsonPath, "utf8");
+	const existingExports = JSON.parse(raw).exports;
+	if (!existingExports || typeof existingExports !== "object" || Array.isArray(existingExports)) return { supplementedSpecifiers: [] };
+	const distDir = path.join(packageDir, DIST_DIR);
+	const supplementedSpecifiers = [];
+	const supplementedExports = {};
+	const originalPathBySpecifier = {};
+	for (const [specifier, entry] of Object.entries(existingExports)) {
+		if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+			supplementedExports[specifier] = entry;
+			originalPathBySpecifier[specifier] = specifier;
+			continue;
+		}
+		const entryRecord = entry;
+		const supplemented = buildSupplementedEntry(specifier, entryRecord, inferModulePath(specifier, entryRecord), distDir, fs, options);
+		if (JSON.stringify(supplemented) !== JSON.stringify(entryRecord)) supplementedSpecifiers.push(specifier);
+		supplementedExports[specifier] = supplemented;
+		originalPathBySpecifier[specifier] = specifier;
+	}
+	await writePackageJsonExportsAtomic(fs, packageJsonPath, {
+		generatedExports: supplementedExports,
+		managedExportSpecifiers: Object.keys(supplementedExports),
+		originalPathBySpecifier
+	});
+	return { supplementedSpecifiers };
+}
+/**
+* Build a `resolveSourcePath` closure that checks the filesystem for `.tsx` before
+* falling back to `.ts`. Mirrors the logic used in normal (non-custom) mode.
+*
+* @since 0.3.16-canary.0
+*/
+function buildSourcePathResolver(fs, packageDir) {
+	const srcDir = path.join(packageDir, "src");
+	return (modulePath) => {
+		const tsxPath = path.join(srcDir, `${modulePath}.tsx`);
+		return fs.existsSync(tsxPath) ? `./src/${modulePath}.tsx` : `./src/${modulePath}.ts`;
+	};
+}
+//#endregion
+export { buildSourcePathResolver, supplementExportsInPackageJson };

package/dist/mirror/sync-reporter.mjs

@@ -65,7 +65,7 @@ var MirrorSyncReporter = class {
 		const breakdown = [];
 		if (generatedDistAssetCounts.jsCount > 0) breakdown.push(this.paint(`${generatedDistAssetCounts.jsCount} modules`, ANSI.green));
 		if (generatedDistAssetCounts.cssCount > 0) breakdown.push(this.paint(`${generatedDistAssetCounts.cssCount} CSS`, ANSI.magenta));
-		if (pkgStats.customExports > 0) breakdown.push(this.paint(`${pkgStats.customExports} custom`, ANSI.yellow));
+		if (pkgStats.extraExports > 0) breakdown.push(this.paint(`${pkgStats.extraExports} custom`, ANSI.yellow));
 		const totalExportsText = this.paint(`${pkgStats.totalExports} exports`, ANSI.brightCyan);
 		if (breakdown.length === 0) logger.out(`  ${this.paint("└─", ANSI.dim)} ${totalExportsText}`);
 		else logger.out(`  ${this.paint("└─", ANSI.dim)} ${breakdown.join(" + ")} = ${totalExportsText}`);

package/dist/mirror/sync-workspace-package.mjs

@@ -4,6 +4,7 @@ import { createPathTransform, generateExports } from "./domain/exports.mjs";
 import { resolvePackageDisplayName } from "./domain/package-display-name.mjs";
 import { writePackageJsonExportsAtomic } from "./write-exports.mjs";
 import { createMirrorDistFilesystem } from "./dist-filesystem-impl.mjs";
+import { buildSourcePathResolver, supplementExportsInPackageJson } from "./supplement-exports.mjs";
 import path from "node:path";
 //#region src/mirror/sync-workspace-package.ts
 /**
@@ -23,7 +24,7 @@ async function syncExportsForWorkspacePackage(fs, rootDir, packagePathStr, confi
 		path: packageDir,
 		jsModules: 0,
 		cssExports: 0,
-		customExports: 0,
+		extraExports: 0,
 		totalExports: 0,
 		hasTransform: false,
 		cssConfigStatus: "",
@@ -49,8 +50,8 @@ async function syncExportsForWorkspacePackage(fs, rootDir, packagePathStr, confi
 		pkgStats.name = folderBasename;
 		packageJsonParseError = caughtError;
 	}
-	const packageMeta = { packageName: pkgStats.name };
-	if (isPackageSkipped(config.skipPackages, packageMeta)) {
+	const pkgConfig = config[pkgStats.name];
+	if (pkgConfig === false) {
 		pkgStats.skipped = true;
 		pkgStats.skipReason = "configured to skip";
 		return pkgStats;
@@ -70,34 +71,39 @@ async function syncExportsForWorkspacePackage(fs, rootDir, packagePathStr, confi
 		return pkgStats;
 	}
 	try {
-		const pathTransform = createPathTransform(config, packageMeta);
-		pkgStats.hasTransform = !!pathTransform;
-		const cssConfig = resolvePackageScopedConfig(config.cssExports, packageMeta);
-		if (cssConfig === false) pkgStats.cssConfigStatus = "disabled";
-		else if (cssConfig !== void 0) pkgStats.cssConfigStatus = "configured";
-		const customExports = resolvePackageScopedConfig(config.customExports, packageMeta) || {};
-		const generatedExports = await generateExports(distFilesystem, distDir, pathTransform, cssConfig, customExports);
-		const { prunedKeys } = await writePackageJsonExportsAtomic(fs, packageJsonPath, {
-			generatedExports: generatedExports.exports,
-			managedExportSpecifiers: Object.keys(generatedExports.exports),
-			originalPathBySpecifier: generatedExports.originalPathBySpecifier
-		});
-		pkgStats.jsModules = generatedExports.jsCount;
-		pkgStats.cssExports = generatedExports.cssCount;
-		pkgStats.customExports = Object.keys(customExports).length;
-		pkgStats.totalExports = Object.keys(generatedExports.exports).length;
-		pkgStats.prunedExportKeys = prunedKeys;
+		const resolveSourcePath = buildSourcePathResolver(fs, packageDir);
+		const exportOptions = {
+			source: pkgConfig?.source ?? true,
+			types: pkgConfig?.types ?? true,
+			import: pkgConfig?.import ?? true,
+			resolveSourcePath
+		};
+		if (pkgConfig?.preserve) {
+			const { supplementedSpecifiers } = await supplementExportsInPackageJson(fs, packageJsonPath, packageDir, exportOptions);
+			pkgStats.totalExports = supplementedSpecifiers.length;
+		} else {
+			const pathTransform = createPathTransform(pkgConfig?.strip);
+			pkgStats.hasTransform = !!pathTransform;
+			const cssConfig = pkgConfig?.css;
+			if (cssConfig === false) pkgStats.cssConfigStatus = "disabled";
+			else if (cssConfig !== void 0) pkgStats.cssConfigStatus = "configured";
+			const extraExports = pkgConfig?.exports ?? {};
+			const generatedExports = await generateExports(distFilesystem, distDir, pathTransform, cssConfig, extraExports, exportOptions);
+			const { prunedKeys } = await writePackageJsonExportsAtomic(fs, packageJsonPath, {
+				generatedExports: generatedExports.exports,
+				managedExportSpecifiers: Object.keys(generatedExports.exports),
+				originalPathBySpecifier: generatedExports.originalPathBySpecifier
+			});
+			pkgStats.jsModules = generatedExports.jsCount;
+			pkgStats.cssExports = generatedExports.cssCount;
+			pkgStats.extraExports = Object.keys(extraExports).length;
+			pkgStats.totalExports = Object.keys(generatedExports.exports).length;
+			pkgStats.prunedExportKeys = prunedKeys;
+		}
 	} catch (caughtError) {
 		pkgStats.error = messageFrom(caughtError);
 	}
 	return pkgStats;
 }
-function resolvePackageScopedConfig(configMap, packageMeta) {
-	if (!configMap) return;
-	return configMap[packageMeta.packageName];
-}
-function isPackageSkipped(skipPackagesList, packageMeta) {
-	return !!skipPackagesList?.includes(packageMeta.packageName);
-}
 //#endregion
 export { syncExportsForWorkspacePackage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codefast/cli",
-  "version": "0.3.16-canary.2",
+  "version": "0.3.16-canary.3",
   "description": "Developer CLI for the Codefast monorepo (arrange, mirror, tag)",
   "keywords": [
     "cli",
@@ -59,17 +59,17 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^25.7.0",
+    "@types/node": "^25.9.1",
     "@types/picomatch": "^4.0.3",
-    "@typescript/native-preview": "7.0.0-dev.20260514.1",
-    "@vitest/coverage-v8": "^4.1.6",
+    "@typescript/native-preview": "7.0.0-dev.20260526.1",
+    "@vitest/coverage-v8": "^4.1.7",
     "tsdown": "^0.22.0",
-    "vite": "^8.0.13",
-    "vitest": "^4.1.6",
-    "@codefast/typescript-config": "0.3.16-canary.2"
+    "vite": "^8.0.14",
+    "vitest": "^4.1.7",
+    "@codefast/typescript-config": "0.3.16-canary.3"
   },
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=24.0.0"
   },
   "scripts": {
     "build": "tsdown",