@codefast/cli 0.7.0 → 0.8.1

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

@@ -18,24 +18,8 @@ function exitCodeForAppError(error) {
     }
 }
 /**
- * @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.
+ *
  * @since 0.3.16-canary.0
  */
 export function consumeCliAppError(outcome, options) {
@@ -56,6 +40,8 @@ export function consumeCliAppError(outcome, options) {
     return true;
 }
 /**
+ * Awaits a `Result`, hands a success to `onSuccess`, and records the returned exit code on the process.
+ *
  * @since 0.3.16-canary.0
  */
 export async function runCliResultAsync(outcomePromise, onSuccess) {
@@ -65,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

@@ -72,6 +72,8 @@ async function loadOnce(startDir, fs) {
     return { config, warnings, configPath };
 }
 /**
+ * Loads and caches the config payload for a directory, sharing one load per resolved path.
+ *
  * @since 0.3.16-canary.0
  */
 export function loadConfigPayload(startDir, fs) {
@@ -84,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. */
@@ -49,18 +49,22 @@ export const mirrorPackageConfigSchema = z
  */
 export const mirrorConfigSchema = z.record(z.string(), z.union([z.literal(false), mirrorPackageConfigSchema]));
 /**
+ * Zod schema for the `tag` command's configuration.
+ *
  * @since 0.3.16-canary.0
  */
-export const codefastTagConfigSchema = z
+const codefastTagConfigSchema = z
     .object({
     skipPackages: z.array(z.string()).optional(),
     onAfterWrite: afterWriteHookSchema.optional(),
 })
     .strict();
 /**
+ * Zod schema for the `arrange` command's configuration.
+ *
  * @since 0.3.16-canary.0
  */
-export const codefastArrangeConfigSchema = z
+const codefastArrangeConfigSchema = z
     .object({
     onAfterWrite: afterWriteHookSchema.optional(),
 })
@@ -70,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(),
@@ -83,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(),
@@ -94,20 +98,35 @@ 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(),
 })
     .strict();
 /**
+ * React import-policy audit defaults — the scan always starts at the repo root, so only
+ * exceptions are configured.
+ *
+ * @since 0.8.0
+ */
+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();
+/**
+ * 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(),
 })
     .strict();
 /**
@@ -122,5 +141,4 @@ export const codefastConfigRootSchema = z
     arrange: codefastArrangeConfigSchema.optional(),
     audit: codefastAuditConfigSchema.optional(),
 })
-    .strict();
-//# sourceMappingURL=schema.js.map
+    .strict();

package/dist/core/config/warnings.js

@@ -2,11 +2,12 @@ import { logger } from "#/core/logger";
 const yellowAnsi = "\x1b[33m";
 const resetAnsi = "\x1b[0m";
 /**
+ * Prints each config schema warning as a highlighted line.
+ *
  * @since 0.3.16-canary.0
  */
 export function reportSchemaWarnings(warnings) {
     for (const warningMessage of warnings) {
         logger.out(`${yellowAnsi}⚠ ${warningMessage}${resetAnsi}`);
     }
-}
-//# sourceMappingURL=warnings.js.map
+}

package/dist/core/config.js

@@ -3,6 +3,8 @@ import { reportSchemaWarnings } from "#/core/config/warnings";
 import { AppError, messageFrom } from "#/core/errors";
 import { err, ok } from "#/core/result";
 /**
+ * Loads the `codefast.config.js` for a workspace root, reporting schema warnings along the way.
+ *
  * @since 0.3.16-canary.0
  */
 export async function loadCodefastConfig(rootDir, fs) {
@@ -14,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

@@ -5,6 +5,8 @@
  * @since 0.3.16-canary.0
  */
 /**
+ * A coded application error carried in `Result` values rather than thrown.
+ *
  * @since 0.3.16-canary.0
  */
 export class AppError {
@@ -54,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

@@ -5,11 +5,14 @@
  */
 export const CLI_EXIT_SUCCESS = 0;
 /**
+ * The exit code for a run that failed for any reason other than bad usage.
+ *
  * @since 0.3.16-canary.0
  */
 export const CLI_EXIT_GENERAL_ERROR = 1;
 /**
+ * The exit code for invalid arguments or configuration.
+ *
  * @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

@@ -2,6 +2,8 @@ import fsSync from "node:fs";
 import fsPromises from "node:fs/promises";
 import path from "node:path";
 /**
+ * The `FilesystemPort` implementation backed by Node's real filesystem.
+ *
  * @since 0.3.16-canary.0
  */
 export const nodeFilesystem = {
@@ -29,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

@@ -1,5 +1,7 @@
 import process from "node:process";
 /**
+ * The CLI's line-oriented writer for stdout and stderr.
+ *
  * @since 0.3.16-canary.0
  */
 export const logger = {
@@ -9,5 +11,4 @@ export const logger = {
     err(line) {
         process.stderr.write(`${line}\n`);
     },
-};
-//# sourceMappingURL=logger.js.map
+};

package/dist/core/result.js

@@ -2,15 +2,18 @@
  * Lightweight functional Result type for CLI boundaries.
  */
 /**
+ * Wraps a value in a success `Result`.
+ *
  * @since 0.3.16-canary.0
  */
 export function ok(value) {
     return { ok: true, value };
 }
 /**
+ * Wraps an error in a failure `Result`.
+ *
  * @since 0.3.16-canary.0
  */
 export function err(error) {
     return { ok: false, error };
-}
-//# sourceMappingURL=result.js.map
+}

package/dist/core/schema-parse.js

@@ -9,6 +9,8 @@ function formatSchemaIssues(issues) {
         .join("; ");
 }
 /**
+ * Parses an input against a Zod schema and returns a `Result` with the value or a validation `AppError`.
+ *
  * @since 0.3.16-canary.0
  */
 export function parseWithSchema(schema, input) {
@@ -17,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

@@ -7,6 +7,8 @@ function lineStartIndexContaining(source, pos) {
     return prevLineBreak === -1 ? 0 : prevLineBreak + 1;
 }
 /**
+ * Returns the leading whitespace of the line containing a position.
+ *
  * @since 0.3.16-canary.0
  */
 export function indentOfLineContaining(source, pos) {
@@ -24,6 +26,8 @@ export function indentOfLineContaining(source, pos) {
     return indentMatch?.[0] ?? "";
 }
 /**
+ * Returns the text from the start of a position's line up to that position.
+ *
  * @since 0.3.16-canary.0
  */
 export function textPrefixFromLineStartToPosition(source, pos) {
@@ -31,6 +35,8 @@ export function textPrefixFromLineStartToPosition(source, pos) {
     return source.slice(lineStartIndexContaining(source, searchPos), searchPos);
 }
 /**
+ * Extends a token's end position past any whitespace-separated trailing comma.
+ *
  * @since 0.3.16-canary.0
  */
 export function endAfterOptionalCommaFollowingInSource(source, tokenEnd) {
@@ -49,6 +55,8 @@ export function endAfterOptionalCommaFollowingInSource(source, tokenEnd) {
     return tokenEnd;
 }
 /**
+ * Applies non-overlapping text edits from the highest offset down and returns the edited source.
+ *
  * @since 0.3.16-canary.0
  */
 export function applyEditsDescending(sourceText, edits) {
@@ -58,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

@@ -1,9 +1,10 @@
 import process from "node:process";
 /**
+ * Reports whether the `CODEFAST_VERBOSE` environment variable enables verbose diagnostics.
+ *
  * @since 0.3.16-canary.0
  */
 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

@@ -0,0 +1,24 @@
+import path from "node:path";
+/**
+ * Finds the `version` of the nearest enclosing `package.json`, or null when the first
+ * one found declares none (the private workspace root is version-less by design).
+ *
+ * @since 0.8.0
+ */
+function findNearestPackageVersion(fs, targetPath) {
+    const resolved = path.resolve(targetPath);
+    let current = fs.statSync(resolved).isDirectory() ? resolved : path.dirname(resolved);
+    while (true) {
+        const packageJsonPath = path.join(current, "package.json");
+        if (fs.existsSync(packageJsonPath)) {
+            const version = JSON.parse(fs.readFileSync(packageJsonPath, "utf8")).version;
+            return typeof version === "string" && version.length > 0 ? version : null;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+export { findNearestPackageVersion };

package/dist/core/workspace/resolver.js

@@ -125,6 +125,8 @@ async function readWorkspaceYaml(rootDir, fs) {
     return { exists: true, doc };
 }
 /**
+ * Lists the workspace's package directories per `pnpm-workspace.yaml`, falling back to default patterns.
+ *
  * @since 0.3.16-canary.0
  */
 export async function listWorkspacePackageDirectories(rootDirectoryPathAbsolute, fs, suppressGlobPermissionDiagnostics) {
@@ -204,5 +206,4 @@ export async function listWorkspacePackageDirectories(rootDirectoryPathAbsolute,
         layoutSource,
         hasPnpmWorkspaceYamlFile,
     };
-}
-//# sourceMappingURL=resolver.js.map
+}

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

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

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

@@ -41,5 +41,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

@@ -1,6 +1,8 @@
 import path from "node:path";
 import { defaultSkipDirectoryNames } from "#/core/workspace/skip-directories";
 /**
+ * Recursively collects the `.ts`/`.tsx` file paths under a root, skipping `.d.ts` and skip-listed directories.
+ *
  * @since 0.3.16-canary.0
  */
 export function walkTsxFiles(rootDirectoryPath, fs) {
@@ -25,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

@@ -1,11 +1,15 @@
 import { CLI_EXIT_GENERAL_ERROR, CLI_EXIT_SUCCESS } from "#/core/exit-codes";
 /**
+ * Maps a mirror run's stats to the process exit code.
+ *
  * @since 0.3.16-canary.0
  */
 export function exitCodeForMirrorSyncResult(stats) {
     return stats.packagesErrored > 0 ? CLI_EXIT_GENERAL_ERROR : CLI_EXIT_SUCCESS;
 }
 /**
+ * Serializes a mirror run's stats as the single-line JSON summary printed under `--json`.
+ *
  * @since 0.3.16-canary.0
  */
 export function formatMirrorSyncJsonOutput(stats, elapsedSeconds, write = true) {
@@ -16,5 +20,4 @@ export function formatMirrorSyncJsonOutput(stats, elapsedSeconds, write = true)
         elapsedSeconds,
         stats,
     });
-}
-//# sourceMappingURL=cli-result.js.map
+}

package/dist/mirror/cli-schema.js

@@ -1,5 +1,7 @@
 import { z } from "zod";
 /**
+ * Zod schema validating a `MirrorSyncRunRequest`.
+ *
  * @since 0.3.16-canary.0
  */
 export const mirrorSyncRunRequestSchema = z.object({
@@ -7,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

@@ -12,6 +12,8 @@ import { MirrorSyncProgressPresenter } from "#/mirror/output";
 import { prepareMirrorSync } from "#/mirror/prepare";
 import { runMirrorSync } from "#/mirror/sync";
 /**
+ * Creates the `mirror` subcommand, which writes `package.json#exports` from `dist/`.
+ *
  * @since 0.3.16-canary.0
  */
 export function createMirrorCommand() {
@@ -69,5 +71,4 @@ export function createMirrorCommand() {
         process.exitCode = exitCodeForMirrorSyncResult(outcome.value);
     });
     return cmd;
-}
-//# sourceMappingURL=command.js.map
+}

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

@@ -2,6 +2,8 @@ import path from "node:path";
 import { isDirentList } from "#/mirror/domain/dirent-guard";
 import { normalizePath } from "#/mirror/domain/path-normalizer";
 /**
+ * Creates the `DistFilesystem` the mirror scan uses, backed by a `FilesystemPort`.
+ *
  * @since 0.3.16-canary.0
  */
 export function createMirrorDistFilesystem(fs) {
@@ -49,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

@@ -1,21 +1,30 @@
 /**
+ * The build output directory the mirror scan reads.
+ *
  * @since 0.3.16-canary.0
  */
 export const DIST_DIR = "dist";
 /**
+ * The manifest file name the mirror rewrites.
+ *
  * @since 0.3.16-canary.0
  */
 export const PACKAGE_JSON = "package.json";
 /**
+ * The JavaScript extensions accepted as runtime entries in `dist/`.
+ *
  * @since 0.3.16-canary.0
  */
 export const VALID_JS_EXTENSIONS = new Set([".js", ".mjs", ".cjs"]);
 /**
+ * The declaration-file extensions accepted as type entries in `dist/`.
+ *
  * @since 0.3.16-canary.0
  */
 export const VALID_DTS_EXTENSIONS = new Set([".d.ts", ".d.mts", ".d.cts"]);
 /**
+ * The `package.json` self-export specifier every generated map includes.
+ *
  * @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

@@ -1,4 +1,6 @@
 /**
+ * The error codes a mirror run can fail with.
+ *
  * @since 0.3.16-canary.0
  */
 export const MirrorErrorCode = {
@@ -6,6 +8,8 @@ export const MirrorErrorCode = {
     PACKAGE_WRITE: "PACKAGE_WRITE",
 };
 /**
+ * An `Error` carrying a `MirrorErrorCode` for mirror-specific failures.
+ *
  * @since 0.3.16-canary.0
  */
 export class MirrorError extends Error {
@@ -15,5 +19,4 @@ export class MirrorError extends Error {
         this.name = "MirrorError";
         this.code = code;
     }
-}
-//# sourceMappingURL=errors.js.map
+}

package/dist/mirror/domain/exports.js

@@ -91,6 +91,8 @@ function getExportSortGroup(exportPath, pathTransform) {
     return [group, subpath, EXPORT_GROUP_ORDER[group] ?? 700, 1];
 }
 /**
+ * Creates a transform that strips a configured prefix from export paths, or `null` when none is set.
+ *
  * @since 0.3.16-canary.0
  */
 export function createPathTransform(strip) {
@@ -217,6 +219,8 @@ function createExcludeMatcher(patterns) {
     };
 }
 /**
+ * Generates a package's `package.json#exports` map from its `dist/` contents.
+ *
  * @since 0.5.0-canary.8
  */
 export async function generateExports(fileSystemService, distDir, pathTransform, cssConfig, extraExports, options) {
@@ -316,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

@@ -1,8 +1,9 @@
 import path from "node:path";
 /**
+ * Converts a path's separators to forward slashes.
+ *
  * @since 0.3.16-canary.0
  */
 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

@@ -2,6 +2,8 @@ import { logger } from "#/core/logger";
 import { MirrorSyncReporter } from "#/mirror/sync-reporter";
 const cliLogger = logger;
 /**
+ * A progress listener that renders mirror run events through the CLI reporter.
+ *
  * @since 0.3.16-canary.0
  */
 export class MirrorSyncProgressPresenter {
@@ -43,5 +45,4 @@ export class MirrorSyncProgressPresenter {
         this.reporter.mirrorSummarySeparator(cliLogger);
         this.reporter.mirrorSummary(cliLogger, stats, elapsedSeconds);
     }
-}
-//# sourceMappingURL=output.js.map
+}