@codefast/cli 0.3.16-canary.2 → 0.4.0-canary.4

package/dist/core/source-text-edit.mjs

@@ -47,7 +47,7 @@ function endAfterOptionalCommaFollowingInSource(source, tokenEnd) {
 * @since 0.3.16-canary.0
 */
 function applyEditsDescending(sourceText, edits) {
-	const sorted = [...edits].sort((editA, editB) => editB.start - editA.start);
+	const sorted = [...edits].toSorted((editA, editB) => editB.start - editA.start);
 	let out = sourceText;
 	for (const edit of sorted) out = out.slice(0, edit.start) + edit.replacement + out.slice(edit.end);
 	return out;

package/dist/core/workspace/resolver.mjs

@@ -92,13 +92,13 @@ async function readWorkspaceYaml(rootDir, fs) {
 	try {
 		raw = await fs.readFile(workspaceYamlPath, "utf8");
 	} catch (caughtReadError) {
-		throw new Error(`Failed to read ${wf}: ${messageFrom(caughtReadError)}`);
+		throw new Error(`Failed to read ${wf}: ${messageFrom(caughtReadError)}`, { cause: caughtReadError });
 	}
 	let doc;
 	try {
 		doc = parse(raw);
 	} catch (caughtYamlParseError) {
-		throw new Error(`Failed to parse ${wf}: ${messageFrom(caughtYamlParseError)}`);
+		throw new Error(`Failed to parse ${wf}: ${messageFrom(caughtYamlParseError)}`, { cause: caughtYamlParseError });
 	}
 	if (doc === null || doc === void 0) throw new Error(`${wf} must define a mapping at the document root`);
 	return {
@@ -153,7 +153,7 @@ async function listWorkspacePackageDirectories(rootDirectoryPathAbsolute, fs, su
 				if (!suppressGlobPermissionDiagnostics) logger.out(`⚠ Skipping workspace glob "${pattern}" (${messageFrom(caughtGlobError)})`);
 				continue;
 			}
-			throw new Error(`Invalid workspace glob "${pattern}": ${messageFrom(caughtGlobError)}`);
+			throw new Error(`Invalid workspace glob "${pattern}": ${messageFrom(caughtGlobError)}`, { cause: caughtGlobError });
 		}
 		for (const matchedPath of matches) {
 			const posix = toPosix(matchedPath);

package/dist/mirror/cli-result.mjs

@@ -9,10 +9,11 @@ function exitCodeForMirrorSyncResult(stats) {
 /**
 * @since 0.3.16-canary.0
 */
-function formatMirrorSyncJsonOutput(stats, elapsedSeconds) {
+function formatMirrorSyncJsonOutput(stats, elapsedSeconds, write = true) {
 	return JSON.stringify({
 		schemaVersion: 1,
 		ok: stats.packagesErrored === 0,
+		write,
 		elapsedSeconds,
 		stats
 	});

package/dist/mirror/cli-schema.mjs

@@ -6,7 +6,8 @@ import { z } from "zod";
 const mirrorSyncRunRequestSchema = z.object({
 	rootDir: z.string().min(1),
 	packageFilter: z.string().optional(),
-	config: z.unknown().optional()
+	config: z.unknown().optional(),
+	write: z.boolean().optional()
 });
 //#endregion
 export { mirrorSyncRunRequestSchema };

package/dist/mirror/command.mjs

@@ -1,14 +1,14 @@
-import { parseWithSchema } from "../core/schema-parse.mjs";
 import { logger } from "../core/logger.mjs";
+import { readOptionalPositionalArg } from "../core/cli/positional.mjs";
 import { consumeCliAppError } from "../core/cli/result-handle.mjs";
 import { nodeFilesystem } from "../core/filesystem/node.mjs";
-import { readOptionalPositionalArg } from "../core/cli/positional.mjs";
+import { parseWithSchema } from "../core/schema-parse.mjs";
 import { globalCliCommanderOptionsSchema } from "../core/cli/global-options.mjs";
-import { prepareMirrorSync } from "./prepare.mjs";
-import { runMirrorSync } from "./sync.mjs";
-import { mirrorSyncRunRequestSchema } from "./cli-schema.mjs";
 import { exitCodeForMirrorSyncResult, formatMirrorSyncJsonOutput } from "./cli-result.mjs";
+import { mirrorSyncRunRequestSchema } from "./cli-schema.mjs";
 import { MirrorSyncProgressPresenter } from "./output.mjs";
+import { prepareMirrorSync } from "./prepare.mjs";
+import { runMirrorSync } from "./sync.mjs";
 import process from "node:process";
 import { Command } from "commander";
 //#region src/mirror/command.ts
@@ -16,8 +16,7 @@ import { Command } from "commander";
 * @since 0.3.16-canary.0
 */
 function createMirrorCommand() {
-	const cmd = new Command("mirror").description("Keep package manifests aligned with what you ship");
-	cmd.command("sync").description("Write package.json exports from dist/ for workspace packages").argument("[package]", "Optional package path relative to repo root (e.g. packages/ui)").option("-v, --verbose", "Print extra diagnostics", false).option("--json", "Print one JSON summary on stdout (suppresses human progress)", false).action(async (packageArg, opts, command) => {
+	return new Command("mirror").description("Write package.json exports from dist/ for workspace packages").argument("[package]", "Optional package path relative to repo root (e.g. packages/ui)").option("--dry-run", "Report what would change without writing package.json", false).option("-v, --verbose", "Print extra diagnostics", false).option("--json", "Print one JSON summary on stdout (suppresses human progress)", false).action(async (packageArg, opts, command) => {
 		const globalOptionsOutcome = parseWithSchema(globalCliCommanderOptionsSchema, command.optsWithGlobals?.() ?? command.opts());
 		if (!consumeCliAppError(globalOptionsOutcome)) return;
 		const prelude = await prepareMirrorSync(nodeFilesystem, {
@@ -26,11 +25,13 @@ function createMirrorCommand() {
 			globals: globalOptionsOutcome.value
 		});
 		if (!consumeCliAppError(prelude)) return;
+		const write = !opts.dryRun;
 		const { rootDir, config, packageFilter } = prelude.value;
 		const parsed = parseWithSchema(mirrorSyncRunRequestSchema, {
 			rootDir,
 			config: config.mirror ?? {},
-			packageFilter
+			packageFilter,
+			write
 		});
 		if (!consumeCliAppError(parsed)) return;
 		const json = !!opts.json;
@@ -40,7 +41,8 @@ function createMirrorCommand() {
 		const listener = json ? void 0 : progressPresenter;
 		if (!json) progressPresenter.configure({
 			noColor,
-			verbose
+			verbose,
+			dryRun: !write
 		});
 		const startTime = performance.now();
 		const outcome = await runMirrorSync(nodeFilesystem, {
@@ -48,10 +50,9 @@ function createMirrorCommand() {
 			listener
 		});
 		if (!consumeCliAppError(outcome)) return;
-		if (json) logger.out(formatMirrorSyncJsonOutput(outcome.value, (performance.now() - startTime) / 1e3));
+		if (json) logger.out(formatMirrorSyncJsonOutput(outcome.value, (performance.now() - startTime) / 1e3, write));
 		process.exitCode = exitCodeForMirrorSyncResult(outcome.value);
 	});
-	return cmd;
 }
 //#endregion
 export { createMirrorCommand };

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,23 +190,27 @@ 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;
 	}
-	let sortedSpecifiers = Object.keys(moduleExportsBySpecifier).sort((leftSpecifier, rightSpecifier) => compareExportSortKeys(getExportSortKey(leftSpecifier, pathTransform), getExportSortKey(rightSpecifier, pathTransform)));
+	let sortedSpecifiers = Object.keys(moduleExportsBySpecifier).toSorted((leftSpecifier, rightSpecifier) => compareExportSortKeys(getExportSortKey(leftSpecifier, pathTransform), getExportSortKey(rightSpecifier, pathTransform)));
 	const sortedExports = {};
 	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;
-	sortedSpecifiers = Object.keys(sortedExports).filter((exportKey) => exportKey !== PACKAGE_JSON_EXPORT).sort((leftSpecifier, rightSpecifier) => compareExportSortKeys(getExportSortKey(leftSpecifier, pathTransform), getExportSortKey(rightSpecifier, pathTransform)));
+	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).toSorted((leftSpecifier, rightSpecifier) => compareExportSortKeys(getExportSortKey(leftSpecifier, pathTransform), getExportSortKey(rightSpecifier, pathTransform)));
 	const finalExports = {};
 	for (const exportKey of sortedSpecifiers) finalExports[exportKey] = sortedExports[exportKey];
 	finalExports[PACKAGE_JSON_EXPORT] = PACKAGE_JSON_EXPORT;

package/dist/mirror/output.mjs

@@ -8,12 +8,15 @@ const cliLogger = logger;
 var MirrorSyncProgressPresenter = class {
 	reporter = new MirrorSyncReporter();
 	verbose = false;
+	dryRun = false;
 	configure(options) {
 		this.verbose = options.verbose;
+		this.dryRun = options.dryRun;
 		this.reporter.configureMirrorColors(options.noColor);
 	}
 	onBanner() {
 		this.reporter.mirrorBanner(cliLogger);
+		if (this.dryRun) this.reporter.mirrorDryRunNotice(cliLogger);
 	}
 	onProcessingMode(mode) {
 		this.reporter.mirrorProcessingMode(cliLogger, mode);

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, write = true) {
+	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
+	}, write);
+	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

@@ -14,7 +14,7 @@ const ANSI = {
 	brightCyan: "\x1B[96m"
 };
 /**
-* Console implementation: ANSI styling and layout for mirror sync.
+* Console implementation: ANSI styling and layout for the mirror command.
 *
 * @since 0.3.16-canary.0
 */
@@ -27,6 +27,9 @@ var MirrorSyncReporter = class {
 		logger.out(`\n${this.paint("📦 Mirror — package exports", ANSI.bold + ANSI.cyan)}`);
 		logger.out(`${this.paint("═".repeat(60), ANSI.dim)}\n`);
 	}
+	mirrorDryRunNotice(logger) {
+		logger.out(`${this.paint("Dry run — no files will be written.", ANSI.yellow)}\n`);
+	}
 	mirrorProcessingMode(logger, mode) {
 		if (mode.kind === "single") {
 			logger.out(`${this.paint("Processing single package...", ANSI.dim)}\n`);
@@ -65,7 +68,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

@@ -1,15 +1,16 @@
 import { messageFrom } from "../core/errors.mjs";
+import { createMirrorDistFilesystem } from "./dist-filesystem-impl.mjs";
 import { DIST_DIR, PACKAGE_JSON } from "./domain/constants.mjs";
 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
 /**
 * @since 0.3.16-canary.0
 */
-async function syncExportsForWorkspacePackage(fs, rootDir, packagePathStr, config) {
+async function syncExportsForWorkspacePackage(fs, rootDir, packagePathStr, config, write = true) {
 	const pathJoin = path.join;
 	const pathResolve = path.resolve;
 	const pathBasename = path.basename;
@@ -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, write);
+			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
+			}, write);
+			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/dist/mirror/sync.mjs

@@ -12,6 +12,7 @@ import path from "node:path";
 async function runMirrorSync(fs, input) {
 	const config = input.config ?? {};
 	const { listener } = input;
+	const write = input.write ?? true;
 	listener?.onBanner();
 	const startTime = performance.now();
 	try {
@@ -47,7 +48,7 @@ async function runMirrorSync(fs, input) {
 		}
 		let ordinal = 1;
 		for (const pkgPath of targetPackages) {
-			const pkgStats = await syncExportsForWorkspacePackage(fs, input.rootDir, pkgPath, config);
+			const pkgStats = await syncExportsForWorkspacePackage(fs, input.rootDir, pkgPath, config, write);
 			stats.packageDetails.push(pkgStats);
 			listener?.onPackageComplete(pkgStats, ordinal, targetPackages.length);
 			ordinal++;

package/dist/mirror/write-exports.mjs

@@ -8,7 +8,7 @@ import { MirrorError, MirrorErrorCode } from "./domain/errors.mjs";
 *
 * @since 0.3.16-canary.0
 */
-async function writePackageJsonExportsAtomic(fs, packageJsonPath, mergeInput) {
+async function writePackageJsonExportsAtomic(fs, packageJsonPath, mergeInput, write = true) {
 	function containsDistTarget(value) {
 		if (typeof value === "string") return value.startsWith("./dist/");
 		if (Array.isArray(value)) return value.some((entryValue) => containsDistTarget(entryValue));
@@ -76,7 +76,8 @@ async function writePackageJsonExportsAtomic(fs, packageJsonPath, mergeInput) {
 	} else packageJson.files = ["dist"];
 	const sortedExportMap = {};
 	const hasCatchAllWildcard = "./*" in mergedExportMap;
-	for (const exportSpecifier of Object.keys(mergedExportMap).sort((leftSpecifier, rightSpecifier) => compareExportSpecifiers(leftSpecifier, rightSpecifier, originalPathBySpecifier, hasCatchAllWildcard))) sortedExportMap[exportSpecifier] = mergedExportMap[exportSpecifier];
+	for (const exportSpecifier of Object.keys(mergedExportMap).toSorted((leftSpecifier, rightSpecifier) => compareExportSpecifiers(leftSpecifier, rightSpecifier, originalPathBySpecifier, hasCatchAllWildcard))) sortedExportMap[exportSpecifier] = mergedExportMap[exportSpecifier];
+	if (!write) return { prunedKeys };
 	packageJson.exports = sortedExportMap;
 	const serialized = JSON.stringify(packageJson, null, 2) + "\n";
 	const tmpPath = `${packageJsonPath}.tmp`;

package/dist/tag/command.mjs

@@ -1,13 +1,13 @@
-import { parseWithSchema } from "../core/schema-parse.mjs";
 import { logger } from "../core/logger.mjs";
+import { readOptionalPositionalArg } from "../core/cli/positional.mjs";
 import { consumeCliAppError } from "../core/cli/result-handle.mjs";
 import { nodeFilesystem } from "../core/filesystem/node.mjs";
-import { readOptionalPositionalArg } from "../core/cli/positional.mjs";
-import { prepareTagSync } from "./prepare.mjs";
-import { runTagSync } from "./sync.mjs";
-import { tagSyncRunRequestSchema } from "./cli-schema.mjs";
+import { parseWithSchema } from "../core/schema-parse.mjs";
 import { exitCodeForTagSyncResult } from "./cli-result.mjs";
+import { tagSyncRunRequestSchema } from "./cli-schema.mjs";
 import { TagSyncProgressPresenter, presentTagSyncResult } from "./output.mjs";
+import { prepareTagSync } from "./prepare.mjs";
+import { runTagSync } from "./sync.mjs";
 import process from "node:process";
 import { Command } from "commander";
 //#region src/tag/command.ts
@@ -15,7 +15,7 @@ import { Command } from "commander";
 * @since 0.3.16-canary.0
 */
 function createTagCommand() {
-	return new Command("tag").description("Add @since <version> JSDoc tags to exported declarations").alias("annotate").argument("[target]", "Directory or file to annotate (default: auto-discover workspace packages)").option("--dry-run", "Show summary without writing files", false).option("--json", "Print one JSON summary on stdout (suppresses human progress)", false).action(async (target, opts) => {
+	return new Command("tag").description("Add @since <version> JSDoc tags to exported declarations").argument("[target]", "Directory or file to tag (default: auto-discover workspace packages)").option("--dry-run", "Show summary without writing files", false).option("--json", "Print one JSON summary on stdout (suppresses human progress)", false).action(async (target, opts) => {
 		const prelude = await prepareTagSync(nodeFilesystem, {
 			currentWorkingDirectory: process.cwd(),
 			rawTarget: readOptionalPositionalArg(target)

package/dist/tag/output.mjs

@@ -1,5 +1,5 @@
-import "../core/exit-codes.mjs";
 import { logger } from "../core/logger.mjs";
+import "../core/exit-codes.mjs";
 import { exitCodeForTagSyncResult } from "./cli-result.mjs";
 //#region src/tag/output.ts
 /**

package/dist/tag/sync.mjs

@@ -20,7 +20,7 @@ async function runTagSync(fs, input) {
 		const modifiedFiles = allFileResults.filter((entry) => entry.changed).map((entry) => entry.filePath);
 		const hookError = input.write && modifiedFiles.length > 0 ? await runTagOnAfterWriteHook(tagConfig?.onAfterWrite, modifiedFiles) : null;
 		const versionsSet = extractDistinctVersions(targetExecutionResults);
-		const distinctVersions = [...versionsSet].sort((left, right) => left.localeCompare(right));
+		const distinctVersions = [...versionsSet].toSorted((left, right) => left.localeCompare(right));
 		return ok({
 			mode: input.write ? "applied" : "dry-run",
 			selectedTargets,

package/dist/tag/target-runner.mjs

@@ -1,6 +1,6 @@
 import { walkTsxFiles } from "../core/workspace/typescript-walk.mjs";
-import { resolveNearestPackageVersion } from "./version-resolver.mjs";
 import { TagSinceWriter } from "./since-writer.mjs";
+import { resolveNearestPackageVersion } from "./version-resolver.mjs";
 import path from "node:path";
 //#region src/tag/target-runner.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codefast/cli",
-  "version": "0.3.16-canary.2",
+  "version": "0.4.0-canary.4",
   "description": "Developer CLI for the Codefast monorepo (arrange, mirror, tag)",
   "keywords": [
     "cli",
@@ -51,7 +51,7 @@
     "access": "public"
   },
   "dependencies": {
-    "commander": "^14.0.3",
+    "commander": "^15.0.0",
     "jiti": "^2.7.0",
     "picomatch": "^4.0.4",
     "typescript": "^6.0.3",
@@ -59,17 +59,17 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^25.7.0",
+    "@types/node": "^25.9.2",
     "@types/picomatch": "^4.0.3",
-    "@typescript/native-preview": "7.0.0-dev.20260514.1",
-    "@vitest/coverage-v8": "^4.1.6",
-    "tsdown": "^0.22.0",
-    "vite": "^8.0.13",
-    "vitest": "^4.1.6",
-    "@codefast/typescript-config": "0.3.16-canary.2"
+    "@typescript/native-preview": "7.0.0-dev.20260604.1",
+    "@vitest/coverage-v8": "^4.1.8",
+    "tsdown": "^0.22.2",
+    "vite": "^8.0.16",
+    "vitest": "^4.1.8",
+    "@codefast/typescript-config": "0.4.0-canary.4"
   },
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=24.0.0"
   },
   "scripts": {
     "build": "tsdown",