@codefast/cli 0.8.0 → 0.9.0

package/dist/core/cli/result-handle.js

@@ -17,26 +17,6 @@ function exitCodeForAppError(error) {
         }
     }
 }
-/**
- * Narrows a `Result` by invoking `onSuccess` on success, or reporting the error and setting the exit code.
- *
- * @since 0.3.16-canary.0
- */
-export function handleResult(outcome, onSuccess) {
-    if (!outcome.ok) {
-        logger.err(formatAppError(outcome.error));
-        if (isVerboseCliDiagnostics() &&
-            outcome.error.code === "INFRA_FAILURE" &&
-            outcome.error.cause instanceof Error &&
-            outcome.error.cause.stack !== undefined) {
-            logger.err(outcome.error.cause.stack);
-        }
-        process.exitCode = exitCodeForAppError(outcome.error);
-        return false;
-    }
-    onSuccess(outcome.value);
-    return true;
-}
 /**
  * Narrows a `Result`, reporting a failure and setting the exit code, or logging an optional success message.
  *
@@ -71,5 +51,4 @@ export async function runCliResultAsync(outcomePromise, onSuccess) {
     }
     const exit = await onSuccess(outcome.value);
     process.exitCode = exit === undefined ? 0 : exit;
-}
-//# sourceMappingURL=result-handle.js.map
+}

package/dist/core/config/loader.js

@@ -86,5 +86,4 @@ export function loadConfigPayload(startDir, fs) {
         throw new Error("config loader cache invariant violated");
     }
     return cached;
-}
-//# sourceMappingURL=loader.js.map
+}

package/dist/core/config/schema.js

@@ -23,7 +23,7 @@ const mirrorCssConfigSchema = z.union([
  *
  * @since 0.3.16-canary.0
  */
-export const mirrorPackageConfigSchema = z
+const mirrorPackageConfigSchema = z
     .object({
     /** Preserve the existing `package.json#exports` map and only add missing conditions
      *  (`source`, `types`, `import`). No dist/ scan is performed. */
@@ -53,7 +53,7 @@ export const mirrorConfigSchema = z.record(z.string(), z.union([z.literal(false)
  *
  * @since 0.3.16-canary.0
  */
-export const codefastTagConfigSchema = z
+const codefastTagConfigSchema = z
     .object({
     skipPackages: z.array(z.string()).optional(),
     onAfterWrite: afterWriteHookSchema.optional(),
@@ -64,7 +64,7 @@ export const codefastTagConfigSchema = z
  *
  * @since 0.3.16-canary.0
  */
-export const codefastArrangeConfigSchema = z
+const codefastArrangeConfigSchema = z
     .object({
     onAfterWrite: afterWriteHookSchema.optional(),
 })
@@ -74,7 +74,7 @@ export const codefastArrangeConfigSchema = z
  *
  * @since 0.3.16-canary.0
  */
-export const codefastAuditRtlConfigSchema = z
+const codefastAuditRtlConfigSchema = z
     .object({
     /** Directory or file to scan when no CLI target is passed. */
     target: z.string().optional(),
@@ -87,7 +87,7 @@ export const codefastAuditRtlConfigSchema = z
  *
  * @since 0.5.0
  */
-export const codefastAuditLinksConfigSchema = z
+const codefastAuditLinksConfigSchema = z
     .object({
     /** Bare link targets or `repo/relative/doc.md:target` entries to ignore. */
     allowlist: z.array(z.string()).optional(),
@@ -98,7 +98,7 @@ export const codefastAuditLinksConfigSchema = z
  *
  * @since 0.6.0
  */
-export const codefastAuditCommentsConfigSchema = z
+const codefastAuditCommentsConfigSchema = z
     .object({
     /** Divider lines as written, or `repo/relative/path.ts:<divider>` entries, to ignore. */
     allowlist: z.array(z.string()).optional(),
@@ -110,23 +110,33 @@ export const codefastAuditCommentsConfigSchema = z
  *
  * @since 0.8.0
  */
-export const codefastAuditReactConfigSchema = z
+const codefastAuditReactConfigSchema = z
     .object({
     /** Offending source text as written, or `repo/relative/path.tsx:<text>` entries, to ignore. */
     allowlist: z.array(z.string()).optional(),
 })
     .strict();
+/**
+ * Display-name audit defaults — the scan always starts at the repo root, so only exceptions are configured.
+ */
+const codefastAuditDisplayNamesConfigSchema = z
+    .object({
+    /** Offending calls as written, or `repo/relative/path.ts:<call>` entries, to ignore. */
+    allowlist: z.array(z.string()).optional(),
+})
+    .strict();
 /**
  * Zod schema grouping the per-audit configurations under `audit`.
  *
  * @since 0.3.16-canary.0
  */
-export const codefastAuditConfigSchema = z
+const codefastAuditConfigSchema = z
     .object({
     rtl: codefastAuditRtlConfigSchema.optional(),
     links: codefastAuditLinksConfigSchema.optional(),
     comments: codefastAuditCommentsConfigSchema.optional(),
     react: codefastAuditReactConfigSchema.optional(),
+    displayNames: codefastAuditDisplayNamesConfigSchema.optional(),
 })
     .strict();
 /**
@@ -141,5 +151,4 @@ export const codefastConfigRootSchema = z
     arrange: codefastArrangeConfigSchema.optional(),
     audit: codefastAuditConfigSchema.optional(),
 })
-    .strict();
-//# sourceMappingURL=schema.js.map
+    .strict();

package/dist/core/config/warnings.js

@@ -10,5 +10,4 @@ export function reportSchemaWarnings(warnings) {
     for (const warningMessage of warnings) {
         logger.out(`${yellowAnsi}⚠ ${warningMessage}${resetAnsi}`);
     }
-}
-//# sourceMappingURL=warnings.js.map
+}

package/dist/core/config.js

@@ -16,5 +16,4 @@ export async function loadCodefastConfig(rootDir, fs) {
     catch (caughtError) {
         return err(new AppError("INFRA_FAILURE", messageFrom(caughtError), caughtError));
     }
-}
-//# sourceMappingURL=config.js.map
+}

package/dist/core/errors.js

@@ -56,5 +56,4 @@ export function messageFrom(value) {
         // Circular structure, BigInt in tree, etc.
     }
     return "[unserializable non-Error value]";
-}
-//# sourceMappingURL=errors.js.map
+}

package/dist/core/exit-codes.js

@@ -15,5 +15,4 @@ export const CLI_EXIT_GENERAL_ERROR = 1;
  *
  * @since 0.3.16-canary.0
  */
-export const CLI_EXIT_USAGE = 2;
-//# sourceMappingURL=exit-codes.js.map
+export const CLI_EXIT_USAGE = 2;

package/dist/core/filesystem/node.js

@@ -31,5 +31,4 @@ export const nodeFilesystem = {
     },
     rename: (oldPath, newPath) => fsPromises.rename(oldPath, newPath),
     unlink: (filePath) => fsPromises.unlink(filePath),
-};
-//# sourceMappingURL=node.js.map
+};

package/dist/core/filesystem/port.js

@@ -1,2 +1 @@
-export {};
-//# sourceMappingURL=port.js.map
+export {};

package/dist/core/glob.js

@@ -16,5 +16,4 @@ export function createAnyGlobMatcher(patterns, options) {
     }
     const matchers = patterns.map((pattern) => picomatch(pattern, options));
     return (value) => matchers.some((isMatch) => isMatch(value));
-}
-//# sourceMappingURL=glob.js.map
+}

package/dist/core/logger.js

@@ -11,5 +11,4 @@ export const logger = {
     err(line) {
         process.stderr.write(`${line}\n`);
     },
-};
-//# sourceMappingURL=logger.js.map
+};

package/dist/core/result.js

@@ -16,5 +16,4 @@ export function ok(value) {
  */
 export function err(error) {
     return { ok: false, error };
-}
-//# sourceMappingURL=result.js.map
+}

package/dist/core/schema-parse.js

@@ -19,5 +19,4 @@ export function parseWithSchema(schema, input) {
         return err(new AppError("VALIDATION_ERROR", formatSchemaIssues(parsed.error.issues)));
     }
     return ok(parsed.data);
-}
-//# sourceMappingURL=schema-parse.js.map
+}

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

@@ -66,5 +66,4 @@ export function applyEditsDescending(sourceText, edits) {
         out = out.slice(0, edit.start) + edit.replacement + out.slice(edit.end);
     }
     return out;
-}
-//# sourceMappingURL=source-text-edit.js.map
+}

package/dist/core/verbose-diagnostics.js

@@ -7,5 +7,4 @@ import process from "node:process";
 export function isVerboseCliDiagnostics() {
     const raw = process.env.CODEFAST_VERBOSE;
     return raw === "1" || raw === "true";
-}
-//# sourceMappingURL=verbose-diagnostics.js.map
+}

package/dist/core/workspace/markdown-walk.js

@@ -24,5 +24,4 @@ function visitMarkdownPaths(result, entryPath, fs) {
     if (entryPath.endsWith(".md")) {
         result.push(entryPath);
     }
-}
-//# sourceMappingURL=markdown-walk.js.map
+}

package/dist/core/workspace/package-version.js

@@ -21,5 +21,4 @@ function findNearestPackageVersion(fs, targetPath) {
         current = parent;
     }
 }
-export { findNearestPackageVersion };
-//# sourceMappingURL=package-version.js.map
+export { findNearestPackageVersion };

package/dist/core/workspace/resolver.js

@@ -206,5 +206,4 @@ export async function listWorkspacePackageDirectories(rootDirectoryPathAbsolute,
         layoutSource,
         hasPnpmWorkspaceYamlFile,
     };
-}
-//# sourceMappingURL=resolver.js.map
+}

package/dist/core/workspace/skip-directories.js

@@ -17,5 +17,4 @@ export const defaultSkipDirectoryNames = new Set([
     ".output",
     ".tanstack",
     ".nitro",
-]);
-//# sourceMappingURL=skip-directories.js.map
+]);

package/dist/core/workspace/source-walk.js

@@ -1,7 +1,15 @@
 import path from "node:path";
 import { defaultSkipDirectoryNames } from "#/core/workspace/skip-directories";
+// Ignore files carry the divider convention over `#` comments — the content rules stay code-only.
+const ignoreFileNames = new Set([
+    ".gitignore",
+    ".dockerignore",
+    ".npmignore",
+    ".prettierignore",
+    ".eslintignore",
+]);
 /**
- * Every hand-written source file a comment convention applies to — `.ts`, `.tsx`, and `.css`.
+ * Every hand-written source file a comment convention applies to — `.ts`, `.tsx`, `.css`, and ignore files.
  *
  * @remarks Emitted declarations are excluded: they carry whatever the compiler copied over,
  * and rewriting them would be undone by the next build.
@@ -25,7 +33,10 @@ export function sourceCommentLanguage(filePath) {
     if (filePath.endsWith(".ts") || filePath.endsWith(".tsx")) {
         return "js";
     }
-    return filePath.endsWith(".css") ? "css" : null;
+    if (filePath.endsWith(".css")) {
+        return "css";
+    }
+    return ignoreFileNames.has(path.basename(filePath)) ? "ignore" : null;
 }
 function visitSourcePaths(result, entryPath, fs) {
     const entryStats = fs.statSync(entryPath);
@@ -41,5 +52,4 @@ function visitSourcePaths(result, entryPath, fs) {
     if (sourceCommentLanguage(entryPath) !== null) {
         result.push(entryPath);
     }
-}
-//# sourceMappingURL=source-walk.js.map
+}

package/dist/core/workspace/typescript-walk.js

@@ -27,5 +27,4 @@ function visitTsxPaths(result, entryPath, fs) {
     if (entryPath.endsWith(".tsx") || entryPath.endsWith(".ts")) {
         result.push(entryPath);
     }
-}
-//# sourceMappingURL=typescript-walk.js.map
+}

package/dist/mirror/cli-result.js

@@ -20,5 +20,4 @@ export function formatMirrorSyncJsonOutput(stats, elapsedSeconds, write = true)
         elapsedSeconds,
         stats,
     });
-}
-//# sourceMappingURL=cli-result.js.map
+}

package/dist/mirror/cli-schema.js

@@ -9,5 +9,4 @@ export const mirrorSyncRunRequestSchema = z.object({
     packageFilter: z.string().optional(),
     config: z.unknown().optional(),
     write: z.boolean().optional(),
-});
-//# sourceMappingURL=cli-schema.js.map
+});

package/dist/mirror/command.js

@@ -71,5 +71,4 @@ export function createMirrorCommand() {
         process.exitCode = exitCodeForMirrorSyncResult(outcome.value);
     });
     return cmd;
-}
-//# sourceMappingURL=command.js.map
+}

package/dist/mirror/dist-filesystem-impl.js

@@ -51,5 +51,4 @@ function isKnownReadDirError(caughtError) {
         caughtError !== null &&
         "code" in caughtError &&
         (caughtError.code === "ENOENT" || caughtError.code === "EACCES"));
-}
-//# sourceMappingURL=dist-filesystem-impl.js.map
+}

package/dist/mirror/domain/constants.js

@@ -27,5 +27,4 @@ export const VALID_DTS_EXTENSIONS = new Set([".d.ts", ".d.mts", ".d.cts"]);
  *
  * @since 0.3.16-canary.0
  */
-export const PACKAGE_JSON_EXPORT = "./package.json";
-//# sourceMappingURL=constants.js.map
+export const PACKAGE_JSON_EXPORT = "./package.json";

package/dist/mirror/domain/dirent-guard.js

@@ -12,5 +12,4 @@ export function isDirentList(x) {
     }
     const first = x[0];
     return typeof first === "object" && first !== null && "isFile" in first && "isDirectory" in first;
-}
-//# sourceMappingURL=dirent-guard.js.map
+}

package/dist/mirror/domain/dist-filesystem.js

@@ -1,2 +1 @@
-export {};
-//# sourceMappingURL=dist-filesystem.js.map
+export {};

package/dist/mirror/domain/errors.js

@@ -19,5 +19,4 @@ export class MirrorError extends Error {
         this.name = "MirrorError";
         this.code = code;
     }
-}
-//# sourceMappingURL=errors.js.map
+}

package/dist/mirror/domain/exports.js

@@ -320,5 +320,4 @@ export async function generateExports(fileSystemService, distDir, pathTransform,
         jsCount: Object.keys(moduleExportsBySpecifier).length,
         cssCount: Object.keys(cssExports).length,
     };
-}
-//# sourceMappingURL=exports.js.map
+}

package/dist/mirror/domain/package-display-name.js

@@ -6,5 +6,4 @@
 export function resolvePackageDisplayName(packageJson, folderBasename) {
     const declaredName = packageJson.name;
     return typeof declaredName === "string" && declaredName.length > 0 ? declaredName : folderBasename;
-}
-//# sourceMappingURL=package-display-name.js.map
+}

package/dist/mirror/domain/path-normalizer.js

@@ -6,5 +6,4 @@ import path from "node:path";
  */
 export function normalizePath(pathString) {
     return pathString.split(path.sep).join("/").replace(/\\/g, "/");
-}
-//# sourceMappingURL=path-normalizer.js.map
+}

package/dist/mirror/domain/types.js

@@ -1,2 +1 @@
-export {};
-//# sourceMappingURL=types.js.map
+export {};

package/dist/mirror/output.js

@@ -45,5 +45,4 @@ export class MirrorSyncProgressPresenter {
         this.reporter.mirrorSummarySeparator(cliLogger);
         this.reporter.mirrorSummary(cliLogger, stats, elapsedSeconds);
     }
-}
-//# sourceMappingURL=output.js.map
+}

package/dist/mirror/package-path.js

@@ -40,5 +40,4 @@ export function resolvePackageFilterUnderRoot(fs, rootDir, packageFilter) {
         return err(new AppError("VALIDATION_ERROR", `Package path must be a subdirectory under monorepo root: ${rootDir}`));
     }
     return ok(normalized);
-}
-//# sourceMappingURL=package-path.js.map
+}

package/dist/mirror/prepare.js

@@ -35,5 +35,4 @@ export async function prepareMirrorSync(fs, args) {
         config: loadedOutcome.value.config,
         packageFilter: filterOutcome.value,
     });
-}
-//# sourceMappingURL=prepare.js.map
+}

package/dist/mirror/supplement-exports.js

@@ -155,5 +155,4 @@ export function buildSourcePathResolver(fs, packageDir) {
         const tsxPath = path.join(srcDir, `${modulePath}.tsx`);
         return fs.existsSync(tsxPath) ? `./src/${modulePath}.tsx` : `./src/${modulePath}.ts`;
     };
-}
-//# sourceMappingURL=supplement-exports.js.map
+}

package/dist/mirror/sync-reporter.js

@@ -121,5 +121,4 @@ export class MirrorSyncReporter {
         }
         return `${openSequence}${text}${ANSI.reset}`;
     }
-}
-//# sourceMappingURL=sync-reporter.js.map
+}

package/dist/mirror/sync-types.js

@@ -1,2 +1 @@
-export {};
-//# sourceMappingURL=sync-types.js.map
+export {};

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

@@ -116,5 +116,4 @@ export async function syncExportsForWorkspacePackage(fs, rootDir, packagePathStr
         pkgStats.error = messageFrom(caughtError);
     }
     return pkgStats;
-}
-//# sourceMappingURL=sync-workspace-package.js.map
+}

package/dist/mirror/sync.js

@@ -88,5 +88,4 @@ function mirrorTargetsFromWorkspaceLayout(rootDir, layoutOutcome) {
         .filter((relativePath) => relativePath.length > 0);
     relPaths.sort((left, right) => left.localeCompare(right));
     return { relPaths, multiSource };
-}
-//# sourceMappingURL=sync.js.map
+}

package/dist/mirror/write-exports.js

@@ -141,5 +141,4 @@ export async function writePackageJsonExportsAtomic(fs, packageJsonPath, mergeIn
         throw new MirrorError(MirrorErrorCode.PACKAGE_WRITE, `Failed to atomically update ${packageJsonPath}: ${messageFrom(caughtRenameError)}`, caughtRenameError instanceof Error ? { cause: caughtRenameError } : undefined);
     }
     return { prunedKeys };
-}
-//# sourceMappingURL=write-exports.js.map
+}

package/dist/pack-slim/cli-result.js

@@ -0,0 +1,23 @@
+import { CLI_EXIT_GENERAL_ERROR, CLI_EXIT_SUCCESS } from "#/core/exit-codes";
+/**
+ * Maps a pack-slim run's stats to the process exit code.
+ *
+ * @since 0.8.1
+ */
+export function exitCodeForPackSlimResult(stats) {
+    return stats.packagesErrored > 0 ? CLI_EXIT_GENERAL_ERROR : CLI_EXIT_SUCCESS;
+}
+/**
+ * Serializes a pack-slim run's stats as the single-line JSON summary printed under `--json`.
+ *
+ * @since 0.8.1
+ */
+export function formatPackSlimJsonOutput(stats, elapsedSeconds, write = true) {
+    return JSON.stringify({
+        schemaVersion: 1,
+        ok: stats.packagesErrored === 0,
+        write,
+        elapsedSeconds,
+        stats,
+    });
+}

package/dist/pack-slim/cli-schema.js

@@ -0,0 +1,11 @@
+import { z } from "zod";
+/**
+ * Zod schema validating the serializable inputs of a pack-slim run.
+ *
+ * @since 0.8.1
+ */
+export const packSlimRunRequestSchema = z.object({
+    rootDir: z.string().min(1),
+    packageFilter: z.string().optional(),
+    write: z.boolean().optional(),
+});

package/dist/pack-slim/command.js

@@ -0,0 +1,80 @@
+import process from "node:process";
+import { Command } from "commander";
+import { globalCliCommanderOptionsSchema } from "#/core/cli/global-options";
+import { readOptionalPositionalArg } from "#/core/cli/positional";
+import { consumeCliAppError } from "#/core/cli/result-handle";
+import { AppError, messageFrom } from "#/core/errors";
+import { nodeFilesystem } from "#/core/filesystem/node";
+import { logger } from "#/core/logger";
+import { err } from "#/core/result";
+import { parseWithSchema } from "#/core/schema-parse";
+import { findRepoRoot } from "#/core/workspace/resolver";
+import { exitCodeForPackSlimResult, formatPackSlimJsonOutput } from "#/pack-slim/cli-result";
+import { packSlimRunRequestSchema } from "#/pack-slim/cli-schema";
+import { PackSlimProgressPresenter } from "#/pack-slim/output";
+import { runPackSlim } from "#/pack-slim/sync";
+import { ensureWorkingTreeClean } from "#/pack-slim/working-tree";
+/**
+ * Creates the `pack-slim` subcommand, which slims published packages down to what a consumer reads before publish.
+ *
+ * @since 0.8.1
+ */
+export function createPackSlimCommand() {
+    const cmd = new Command("pack-slim")
+        .description("Strip src, source conditions, unshipped imports, dev-only scripts, devDependencies, and dist source maps from " +
+        "published packages before publish")
+        .argument("[package]", "Optional package path relative to repo root (e.g. packages/ui)")
+        .option("--dry-run", "Report what would change without touching any file", false)
+        .option("--force", "Run even if the git working tree has uncommitted tracked changes", false)
+        .option("--json", "Print one JSON summary on stdout (suppresses human progress)", false)
+        .action(async (packageArg, opts, command) => {
+        const globalsOptionCarrier = command.optsWithGlobals?.() ??
+            command.opts();
+        const globalOptionsOutcome = parseWithSchema(globalCliCommanderOptionsSchema, globalsOptionCarrier);
+        if (!consumeCliAppError(globalOptionsOutcome)) {
+            return;
+        }
+        let rootDir;
+        try {
+            rootDir = findRepoRoot(process.cwd(), nodeFilesystem);
+        }
+        catch (caughtError) {
+            consumeCliAppError(err(new AppError("INFRA_FAILURE", messageFrom(caughtError), caughtError)));
+            return;
+        }
+        const write = !opts.dryRun;
+        // A destructive slim must never land on a developer's uncommitted work; --dry-run writes nothing, so it is exempt.
+        if (write && !opts.force) {
+            const cleanCheck = ensureWorkingTreeClean(rootDir);
+            if (!consumeCliAppError(cleanCheck)) {
+                return;
+            }
+        }
+        const parsed = parseWithSchema(packSlimRunRequestSchema, {
+            rootDir,
+            packageFilter: readOptionalPositionalArg(packageArg),
+            write,
+        });
+        if (!consumeCliAppError(parsed)) {
+            return;
+        }
+        const json = !!opts.json;
+        const presenter = new PackSlimProgressPresenter();
+        if (!json) {
+            presenter.configure({ dryRun: !write });
+        }
+        const startTime = performance.now();
+        const outcome = await runPackSlim(nodeFilesystem, {
+            ...parsed.value,
+            listener: json ? undefined : presenter,
+        });
+        if (!consumeCliAppError(outcome)) {
+            return;
+        }
+        if (json) {
+            logger.out(formatPackSlimJsonOutput(outcome.value, (performance.now() - startTime) / 1000, write));
+        }
+        process.exitCode = exitCodeForPackSlimResult(outcome.value);
+    });
+    return cmd;
+}