@codefast/cli 1.0.0-canary.6 → 1.0.0-canary.7

package/dist/audit/domain/audit-file.js

@@ -0,0 +1,101 @@
+import { DIRECTION_RESOLVED_VARIANT, PHYSICAL_SIDE_VARIANT, RTL_MAPPINGS, RTL_REVERSE_MAPPINGS, RTL_SWAP_MAPPINGS, RTL_TRANSLATE_X_MAPPINGS, SLIDE_PREFIXES, } from "#/audit/domain/mappings";
+import { collectTokens } from "#/audit/domain/tokenize";
+/**
+ * A token satisfies an "rtl companion" requirement when the same file has a
+ * token whose variants include `rtl` and whose value matches. Variant order
+ * differs between authors, so this stays deliberately loose.
+ *
+ * @since 1.0.0-canary.7
+ */
+export function hasRtlCompanion(fileTokens, expectedValue) {
+    return fileTokens.some(({ variant, value }) => {
+        if (!variant) {
+            return false;
+        }
+        const variants = variant.split(":");
+        if (!variants.includes("rtl")) {
+            return false;
+        }
+        return value === expectedValue || value.startsWith(expectedValue);
+    });
+}
+/**
+ * Detect physical-direction Tailwind classes that should be logical or rtl:-paired.
+ *
+ * @since 1.0.0-canary.7
+ */
+export function auditFileContent(content) {
+    const tokens = collectTokens(content);
+    const violations = [];
+    for (const { raw, token, variant, value, line } of tokens) {
+        if (token.startsWith("rtl:") || token.startsWith("ltr:")) {
+            continue;
+        }
+        const variants = variant ? variant.split(":") : [];
+        if (variants.includes("rtl") || variants.includes("ltr")) {
+            continue;
+        }
+        const isPhysicalSideVariant = variant !== null && PHYSICAL_SIDE_VARIANT.test(variant);
+        if (isPhysicalSideVariant) {
+            continue;
+        }
+        const translateMapping = RTL_TRANSLATE_X_MAPPINGS.find(([physical]) => value.startsWith(physical));
+        if (translateMapping) {
+            // ±0 is direction-neutral — negating it changes nothing.
+            if (/^-?translate-x-0$/.test(value)) {
+                continue;
+            }
+            const expected = value.replace(translateMapping[0], translateMapping[1]);
+            if (!hasRtlCompanion(tokens, expected)) {
+                violations.push({
+                    line,
+                    raw,
+                    suggestion: `add rtl:${expected} (or rtl:…:${expected})`,
+                });
+            }
+            continue;
+        }
+        const reverseMapping = RTL_REVERSE_MAPPINGS.find(([prefix]) => value.startsWith(prefix) || value.startsWith(`-${prefix}`));
+        if (reverseMapping) {
+            if (value.includes("reverse")) {
+                continue;
+            }
+            if (!hasRtlCompanion(tokens, reverseMapping[1])) {
+                violations.push({ line, raw, suggestion: `add rtl:${reverseMapping[1]}` });
+            }
+            continue;
+        }
+        const swapMapping = RTL_SWAP_MAPPINGS.find(([physical]) => value === physical);
+        if (swapMapping) {
+            if (!hasRtlCompanion(tokens, swapMapping[1])) {
+                violations.push({ line, raw, suggestion: `add rtl:${swapMapping[1]}` });
+            }
+            continue;
+        }
+        if (SLIDE_PREFIXES.some((prefix) => value.startsWith(prefix))) {
+            if (variant && DIRECTION_RESOLVED_VARIANT.test(variant)) {
+                continue;
+            }
+            violations.push({
+                line,
+                raw,
+                suggestion: "check: physical slide outside a side/motion context",
+            });
+            continue;
+        }
+        for (const [physical, logical] of RTL_MAPPINGS) {
+            if (!value.startsWith(physical)) {
+                continue;
+            }
+            // Bare patterns (no trailing dash) must match exactly so border-ring
+            // doesn't match border-r.
+            if (!physical.endsWith("-") && value !== physical) {
+                continue;
+            }
+            violations.push({ line, raw, suggestion: value.replace(physical, logical) });
+            break;
+        }
+    }
+    return violations;
+}
+//# sourceMappingURL=audit-file.js.map

package/dist/audit/domain/audit-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-file.js","sourceRoot":"","sources":["../../../src/audit/domain/audit-file.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,wBAAwB,EACxB,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,UAAwC,EAAE,aAAqB;IAC7F,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,KAAK,KAAK,aAAa,IAAI,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,UAAU,GAAwB,EAAE,CAAC;IAE3C,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,MAAM,EAAE,CAAC;QAC1D,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACzD,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,SAAS;QACX,CAAC;QAED,MAAM,qBAAqB,GAAG,OAAO,KAAK,IAAI,IAAI,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtF,IAAI,qBAAqB,EAAE,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnG,IAAI,gBAAgB,EAAE,CAAC;YACrB,yDAAyD;YACzD,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpC,SAAS;YACX,CAAC;YACD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;YACzE,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;gBACvC,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI;oBACJ,GAAG;oBACH,UAAU,EAAE,WAAW,QAAQ,cAAc,QAAQ,GAAG;iBACzD,CAAC,CAAC;YACL,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,cAAc,GAAG,oBAAoB,CAAC,IAAI,CAC9C,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,MAAM,EAAE,CAAC,CACzE,CAAC;QACF,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC9B,SAAS;YACX,CAAC;YACD,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChD,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,WAAW,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7E,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC;QAC/E,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7C,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,WAAW,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1E,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YAC9D,IAAI,OAAO,IAAI,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxD,SAAS;YACX,CAAC;YACD,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI;gBACJ,GAAG;gBACH,UAAU,EAAE,qDAAqD;aAClE,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,YAAY,EAAE,CAAC;YAC/C,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChC,SAAS;YACX,CAAC;YACD,qEAAqE;YACrE,0BAA0B;YAC1B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAClD,SAAS;YACX,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YAC7E,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/audit/domain/mappings.js

@@ -0,0 +1,103 @@
+/**
+ * Physical → logical replacements. Order matters: negative before positive,
+ * specific corners before general edges, with-value before bare.
+ *
+ * @since 1.0.0-canary.7
+ */
+export const RTL_MAPPINGS = [
+    ["-ml-", "-ms-"],
+    ["-mr-", "-me-"],
+    ["ml-", "ms-"],
+    ["mr-", "me-"],
+    ["pl-", "ps-"],
+    ["pr-", "pe-"],
+    ["-left-", "-start-"],
+    ["-right-", "-end-"],
+    ["left-", "start-"],
+    ["right-", "end-"],
+    ["inset-l-", "inset-inline-start-"],
+    ["inset-r-", "inset-inline-end-"],
+    ["rounded-tl-", "rounded-ss-"],
+    ["rounded-tr-", "rounded-se-"],
+    ["rounded-bl-", "rounded-es-"],
+    ["rounded-br-", "rounded-ee-"],
+    ["rounded-l-", "rounded-s-"],
+    ["rounded-r-", "rounded-e-"],
+    ["rounded-tl", "rounded-ss"],
+    ["rounded-tr", "rounded-se"],
+    ["rounded-bl", "rounded-es"],
+    ["rounded-br", "rounded-ee"],
+    ["rounded-l", "rounded-s"],
+    ["rounded-r", "rounded-e"],
+    ["border-l-", "border-s-"],
+    ["border-r-", "border-e-"],
+    ["border-l", "border-s"],
+    ["border-r", "border-e"],
+    ["text-left", "text-start"],
+    ["text-right", "text-end"],
+    ["scroll-ml-", "scroll-ms-"],
+    ["scroll-mr-", "scroll-me-"],
+    ["scroll-pl-", "scroll-ps-"],
+    ["scroll-pr-", "scroll-pe-"],
+    ["float-left", "float-start"],
+    ["float-right", "float-end"],
+    ["clear-left", "clear-start"],
+    ["clear-right", "clear-end"],
+    ["origin-top-left", "origin-top-start"],
+    ["origin-top-right", "origin-top-end"],
+    ["origin-bottom-left", "origin-bottom-start"],
+    ["origin-bottom-right", "origin-bottom-end"],
+    ["origin-left", "origin-start"],
+    ["origin-right", "origin-end"],
+];
+/**
+ * translate-x has no logical equivalent — it needs an rtl:-negated twin.
+ *
+ * @since 1.0.0-canary.7
+ */
+export const RTL_TRANSLATE_X_MAPPINGS = [
+    ["-translate-x-", "translate-x-"],
+    ["translate-x-", "-translate-x-"],
+];
+/**
+ * Classes that need an rtl:*-reverse companion.
+ *
+ * @since 1.0.0-canary.7
+ */
+export const RTL_REVERSE_MAPPINGS = [
+    ["space-x-", "space-x-reverse"],
+    ["divide-x-", "divide-x-reverse"],
+];
+/**
+ * Classes that need an rtl: companion with the swapped value.
+ *
+ * @since 1.0.0-canary.7
+ */
+export const RTL_SWAP_MAPPINGS = [
+    ["cursor-w-resize", "cursor-e-resize"],
+    ["cursor-e-resize", "cursor-w-resize"],
+];
+/**
+ * Anything anchored to a physical side variant stays physical: Radix resolves
+ * `side` per direction, and a border/position/slide tied to that side must follow it.
+ *
+ * @since 1.0.0-canary.7
+ */
+export const PHYSICAL_SIDE_VARIANT = /data-side-(?:left|right)|data-\[side=(?:left|right)\]|\[data-side=(?:left|right)\]/;
+/**
+ * Slide animations under direction-resolved contexts are correct as-is:
+ * Radix flips `side`/`motion` values itself under DirectionProvider.
+ *
+ * @since 1.0.0-canary.7
+ */
+export const DIRECTION_RESOLVED_VARIANT = /data-\[motion[=^]/;
+/**
+ * @since 1.0.0-canary.7
+ */
+export const SLIDE_PREFIXES = [
+    "slide-in-from-left",
+    "slide-in-from-right",
+    "slide-out-to-left",
+    "slide-out-to-right",
+];
+//# sourceMappingURL=mappings.js.map

package/dist/audit/domain/mappings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappings.js","sourceRoot":"","sources":["../../../src/audit/domain/mappings.ts"],"names":[],"mappings":"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"}

package/dist/audit/domain/tokenize.js

@@ -0,0 +1,83 @@
+/**
+ * Split a class token into [variant, value, modifier], colon/slash-aware of
+ * brackets and parens (arbitrary values like data-[side=left] or calc(...)).
+ *
+ * @since 1.0.0-canary.7
+ */
+export function splitClassName(token) {
+    const segments = [];
+    let current = "";
+    let depth = 0;
+    for (const char of token) {
+        if (char === "[" || char === "(") {
+            depth++;
+        }
+        else if (char === "]" || char === ")") {
+            depth--;
+        }
+        if (char === ":" && depth === 0) {
+            segments.push(current);
+            current = "";
+        }
+        else {
+            current += char;
+        }
+    }
+    segments.push(current);
+    let value = segments.pop() ?? "";
+    const variant = segments.length > 0 ? segments.join(":") : null;
+    let modifier = null;
+    depth = 0;
+    let slashIndex = -1;
+    for (let index = 0; index < value.length; index++) {
+        const char = value[index];
+        if (char === "[" || char === "(") {
+            depth++;
+        }
+        else if (char === "]" || char === ")") {
+            depth--;
+        }
+        else if (char === "/" && depth === 0) {
+            slashIndex = index;
+        }
+    }
+    if (slashIndex !== -1) {
+        modifier = value.slice(slashIndex + 1);
+        value = value.slice(0, slashIndex);
+    }
+    return [variant, value, modifier];
+}
+/**
+ * Extract string/template literal contents with their line numbers.
+ *
+ * @since 1.0.0-canary.7
+ */
+export function* stringLiterals(content) {
+    const pattern = /"([^"\n]*)"|'([^'\n]*)'|`([^`]*)`/g;
+    for (const match of content.matchAll(pattern)) {
+        const text = match[1] ?? match[2] ?? match[3] ?? "";
+        const line = content.slice(0, match.index).split("\n").length;
+        yield { text, line };
+    }
+}
+/**
+ * @since 1.0.0-canary.7
+ */
+export function collectTokens(content) {
+    const tokens = [];
+    for (const { text, line } of stringLiterals(content)) {
+        for (const raw of text.split(/\s+/)) {
+            if (!raw || raw.includes("${")) {
+                continue;
+            }
+            const token = raw.endsWith("!") ? raw.slice(0, -1) : raw;
+            const [variant, value, modifier] = splitClassName(token);
+            if (!value) {
+                continue;
+            }
+            tokens.push({ raw, token, variant, value, modifier, line });
+        }
+    }
+    return tokens;
+}
+//# sourceMappingURL=tokenize.js.map

package/dist/audit/domain/tokenize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenize.js","sourceRoot":"","sources":["../../../src/audit/domain/tokenize.ts"],"names":[],"mappings":"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"}

package/dist/audit/domain/types.js

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

package/dist/audit/domain/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/audit/domain/types.ts"],"names":[],"mappings":""}

package/dist/audit/output.js

@@ -0,0 +1,44 @@
+import { CLI_EXIT_GENERAL_ERROR, CLI_EXIT_SUCCESS } from "#/core/exit-codes";
+import { logger } from "#/core/logger";
+/**
+ * Exit `1` when any non-allowlisted violation remains.
+ *
+ * @since 1.0.0-canary.7
+ */
+export function exitCodeForRtlAuditResult(result) {
+    return result.violationCount > 0 ? CLI_EXIT_GENERAL_ERROR : CLI_EXIT_SUCCESS;
+}
+/**
+ * Human-readable RTL audit report (matches the former packages/ui script shape).
+ *
+ * @since 1.0.0-canary.7
+ */
+export function presentRtlAuditResult(result) {
+    for (const file of result.files) {
+        logger.out(`\n${file.relativePath}`);
+        for (const { line, raw, suggestion } of file.violations) {
+            logger.out(`  ${line}: ${raw} → ${suggestion}`);
+        }
+    }
+    const allowlistSuffix = result.allowlistedCount > 0 ? ` (${result.allowlistedCount} allowlisted)` : "";
+    if (result.violationCount > 0) {
+        logger.out(`\n✖ ${result.violationCount} RTL violation(s)${allowlistSuffix}`);
+    }
+    else {
+        logger.out(`✓ No physical-direction classes outside the allowlist${allowlistSuffix}`);
+    }
+}
+/**
+ * Machine-readable RTL audit summary for `--json`.
+ *
+ * @since 1.0.0-canary.7
+ */
+export function formatRtlAuditJsonOutput(result, rootDir) {
+    return JSON.stringify({
+        schemaVersion: 1,
+        ok: result.violationCount === 0,
+        cwd: rootDir,
+        result,
+    });
+}
+//# sourceMappingURL=output.js.map

package/dist/audit/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/audit/output.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAsB;IAC9D,OAAO,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,gBAAgB,CAAC;AAC/E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAsB;IAC1D,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QACrC,KAAK,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACxD,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,KAAK,GAAG,MAAM,UAAU,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,gBAAgB,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAEvG,IAAI,MAAM,CAAC,cAAc,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC,OAAO,MAAM,CAAC,cAAc,oBAAoB,eAAe,EAAE,CAAC,CAAC;IAChF,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,GAAG,CAAC,wDAAwD,eAAe,EAAE,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAsB,EAAE,OAAe;IAC9E,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,aAAa,EAAE,CAAU;QACzB,EAAE,EAAE,MAAM,CAAC,cAAc,KAAK,CAAC;QAC/B,GAAG,EAAE,OAAO;QACZ,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}

package/dist/audit/prepare.js

@@ -0,0 +1,42 @@
+import { resolveRepoRelativePath } from "#/audit/cli-schema";
+import { loadCodefastConfig } from "#/core/config";
+import { AppError, messageFrom } from "#/core/errors";
+import { err, ok } from "#/core/result";
+import { findRepoRoot } from "#/core/workspace/resolver";
+/**
+ * Load config and resolve the scan target for `audit rtl`.
+ *
+ * @since 1.0.0-canary.7
+ */
+export async function prepareRtlAudit(fs, args) {
+    let rootDir;
+    try {
+        // Realpath so allowlist keys (`path.relative(rootDir, file)`) stay stable when cwd is a symlink.
+        rootDir = fs.canonicalPathSync(findRepoRoot(args.currentWorkingDirectory, fs));
+    }
+    catch (caughtError) {
+        return err(new AppError("INFRA_FAILURE", messageFrom(caughtError), caughtError));
+    }
+    const loadedOutcome = await loadCodefastConfig(rootDir, fs);
+    if (!loadedOutcome.ok) {
+        return loadedOutcome;
+    }
+    const { config } = loadedOutcome.value;
+    const rtlConfig = config.audit?.rtl ?? {};
+    const targetFromCli = args.rawTarget;
+    const targetFromConfig = rtlConfig.target;
+    const resolvedTargetInput = targetFromCli ?? targetFromConfig;
+    if (resolvedTargetInput === undefined) {
+        return err(new AppError("VALIDATION_ERROR", "Missing scan target: pass a path argument or set audit.rtl.target in codefast.config"));
+    }
+    const targetPath = resolveRepoRelativePath(targetFromCli !== undefined ? args.currentWorkingDirectory : rootDir, resolvedTargetInput);
+    if (!fs.existsSync(targetPath)) {
+        return err(new AppError("NOT_FOUND", `Not found: ${targetPath}`));
+    }
+    return ok({
+        rootDir,
+        targetPath: fs.canonicalPathSync(targetPath),
+        allowlist: rtlConfig.allowlist ?? [],
+    });
+}
+//# sourceMappingURL=prepare.js.map

package/dist/audit/prepare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.js","sourceRoot":"","sources":["../../src/audit/prepare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGtD,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAazD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,EAAkB,EAClB,IAGC;IAED,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,iGAAiG;QACjG,OAAO,GAAG,EAAE,CAAC,iBAAiB,CAAC,YAAY,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC,CAAC;IACjF,CAAC;IAAC,OAAO,WAAoB,EAAE,CAAC;QAC9B,OAAO,GAAG,CAAC,IAAI,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC5D,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC;QACtB,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC;IACvC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC;IAE1C,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC;IACrC,MAAM,gBAAgB,GAAG,SAAS,CAAC,MAAM,CAAC;IAC1C,MAAM,mBAAmB,GAAG,aAAa,IAAI,gBAAgB,CAAC;IAC9D,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,GAAG,CACR,IAAI,QAAQ,CACV,kBAAkB,EAClB,sFAAsF,CACvF,CACF,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,uBAAuB,CACxC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAC,OAAO,EACpE,mBAAmB,CACpB,CAAC;IACF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC,IAAI,QAAQ,CAAC,WAAW,EAAE,cAAc,UAAU,EAAE,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,EAAE,CAAC;QACR,OAAO;QACP,UAAU,EAAE,EAAE,CAAC,iBAAiB,CAAC,UAAU,CAAC;QAC5C,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,EAAE;KACrC,CAAC,CAAC;AACL,CAAC"}

package/dist/audit/run.js

@@ -0,0 +1,57 @@
+import path from "node:path";
+import { auditFileContent } from "#/audit/domain/audit-file";
+import { AppError, messageFrom } from "#/core/errors";
+import { err, ok } from "#/core/result";
+import { walkTsxFiles } from "#/core/workspace/typescript-walk";
+/**
+ * Scan a target path for physical-direction Tailwind class violations.
+ *
+ * @since 1.0.0-canary.7
+ */
+export function runRtlAudit(fs, args) {
+    try {
+        const allowlist = new Set(args.allowlist);
+        // Caller passes canonical roots (prepareRtlAudit realpaths them) so relative() keys stay stable.
+        const { rootDir, targetPath } = args;
+        const filesToScan = collectScanPaths(fs, targetPath);
+        const files = [];
+        let violationCount = 0;
+        let allowlistedCount = 0;
+        for (const absolutePath of filesToScan) {
+            const relativePath = toPosixPath(path.relative(rootDir, absolutePath));
+            const content = fs.readFileSync(absolutePath, "utf8");
+            const remaining = auditFileContent(content).filter(({ raw }) => {
+                const isAllowed = allowlist.has(raw) || allowlist.has(`${relativePath}:${raw}`);
+                if (isAllowed) {
+                    allowlistedCount++;
+                }
+                return !isAllowed;
+            });
+            if (remaining.length === 0) {
+                continue;
+            }
+            violationCount += remaining.length;
+            files.push({ relativePath, violations: remaining });
+        }
+        return ok({
+            files,
+            violationCount,
+            allowlistedCount,
+            scannedFileCount: filesToScan.length,
+        });
+    }
+    catch (caughtError) {
+        return err(new AppError("INFRA_FAILURE", messageFrom(caughtError), caughtError));
+    }
+}
+function collectScanPaths(fs, targetPath) {
+    const stats = fs.statSync(targetPath);
+    if (stats.isFile()) {
+        return [targetPath];
+    }
+    return walkTsxFiles(targetPath, fs);
+}
+function toPosixPath(filePath) {
+    return filePath.split(path.sep).join("/");
+}
+//# sourceMappingURL=run.js.map

package/dist/audit/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/audit/run.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGtD,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,EAAkB,EAClB,IAIC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1C,iGAAiG;QACjG,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QACrC,MAAM,WAAW,GAAG,gBAAgB,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACrD,MAAM,KAAK,GAA6B,EAAE,CAAC;QAC3C,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,IAAI,gBAAgB,GAAG,CAAC,CAAC;QAEzB,KAAK,MAAM,YAAY,IAAI,WAAW,EAAE,CAAC;YACvC,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;YACvE,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YACtD,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;gBAC7D,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,YAAY,IAAI,GAAG,EAAE,CAAC,CAAC;gBAChF,IAAI,SAAS,EAAE,CAAC;oBACd,gBAAgB,EAAE,CAAC;gBACrB,CAAC;gBACD,OAAO,CAAC,SAAS,CAAC;YACpB,CAAC,CAAC,CAAC;YACH,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,SAAS;YACX,CAAC;YACD,cAAc,IAAI,SAAS,CAAC,MAAM,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,EAAE,CAAC;YACR,KAAK;YACL,cAAc;YACd,gBAAgB;YAChB,gBAAgB,EAAE,WAAW,CAAC,MAAM;SACrC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,WAAoB,EAAE,CAAC;QAC9B,OAAO,GAAG,CAAC,IAAI,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;IACnF,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAkB,EAAE,UAAkB;IAC9D,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACtC,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QACnB,OAAO,CAAC,UAAU,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,YAAY,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,WAAW,CAAC,QAAgB;IACnC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC"}

package/dist/{bin.mjs → bin.js}

@@ -1,8 +1,6 @@
 #!/usr/bin/env node
-import { runCli } from "./cli.mjs";
 import process from "node:process";
-//#region src/bin.ts
+import { runCli } from "#/cli";
 const code = await runCli(process.argv);
 process.exit(code);
-//#endregion
-export {};
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE/B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACxC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

package/dist/cli.js

@@ -0,0 +1,45 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+import { Command } from "commander";
+import { createArrangeCommand } from "#/arrange/command";
+import { createAuditCommand } from "#/audit/command";
+import { createMirrorCommand } from "#/mirror/command";
+import { createTagCommand } from "#/tag/command";
+function readVersion() {
+    try {
+        const dir = path.dirname(fileURLToPath(import.meta.url));
+        const pkgPath = path.join(dir, "..", "package.json");
+        const raw = readFileSync(pkgPath, "utf-8");
+        const pkgVersion = JSON.parse(raw).version;
+        return typeof pkgVersion === "string" && pkgVersion.length > 0 ? pkgVersion : "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+/**
+ * @since 0.3.16-canary.0
+ */
+export async function runCli(argv) {
+    const program = new Command();
+    program
+        .name("codefast")
+        .description("Codefast monorepo developer CLI")
+        .version(readVersion())
+        .option("--no-color", "Disable ANSI color output")
+        // Required so options after a subcommand bind to that subcommand rather than
+        // the program — e.g. `arrange inspect <target> --json` (see arrange/command.ts).
+        .enablePositionalOptions()
+        .configureHelp({ sortSubcommands: true })
+        .showHelpAfterError("(use --help for usage)");
+    program.addCommand(createArrangeCommand());
+    program.addCommand(createAuditCommand());
+    program.addCommand(createMirrorCommand());
+    program.addCommand(createTagCommand());
+    await program.parseAsync(argv, { from: "node" });
+    const code = process.exitCode ?? 0;
+    return typeof code === "number" ? code : Number(code) || 0;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACrD,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAA2B,CAAC,OAAO,CAAC;QACtE,OAAO,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAmB;IAC9C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAC9B,OAAO;SACJ,IAAI,CAAC,UAAU,CAAC;SAChB,WAAW,CAAC,iCAAiC,CAAC;SAC9C,OAAO,CAAC,WAAW,EAAE,CAAC;SACtB,MAAM,CAAC,YAAY,EAAE,2BAA2B,CAAC;QAClD,6EAA6E;QAC7E,iFAAiF;SAChF,uBAAuB,EAAE;SACzB,aAAa,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;SACxC,kBAAkB,CAAC,wBAAwB,CAAC,CAAC;IAEhD,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAEvC,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IACnC,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7D,CAAC"}

package/dist/core/cli/format-error.js

@@ -0,0 +1,19 @@
+/**
+ * @since 0.3.16-canary.0
+ */
+export function formatAppError(error) {
+    const { code, message } = error;
+    switch (code) {
+        case "NOT_FOUND":
+            return `[NOT_FOUND] ${message}`;
+        case "VALIDATION_ERROR":
+            return `[VALIDATION_ERROR] ${message}`;
+        case "INFRA_FAILURE":
+            return `[INFRA_FAILURE] ${message}`;
+        default: {
+            const exhaustive = code;
+            return `Unhandled error code: ${String(exhaustive)}`;
+        }
+    }
+}
+//# sourceMappingURL=format-error.js.map

package/dist/core/cli/format-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-error.js","sourceRoot":"","sources":["../../../src/core/cli/format-error.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAe;IAC5C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAChC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,WAAW;YACd,OAAO,eAAe,OAAO,EAAE,CAAC;QAClC,KAAK,kBAAkB;YACrB,OAAO,sBAAsB,OAAO,EAAE,CAAC;QACzC,KAAK,eAAe;YAClB,OAAO,mBAAmB,OAAO,EAAE,CAAC;QACtC,SAAS,CAAC;YACR,MAAM,UAAU,GAAU,IAAI,CAAC;YAC/B,OAAO,yBAAyB,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACvD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/core/cli/global-options.js

@@ -0,0 +1,10 @@
+import { z } from "zod";
+/**
+ * Commander global opts shape validated before mirror prelude (`color` from `--no-color`).
+ *
+ * @since 0.3.16-canary.0
+ */
+export const globalCliCommanderOptionsSchema = z.object({
+    color: z.boolean().optional(),
+});
+//# sourceMappingURL=global-options.js.map

package/dist/core/cli/global-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-options.js","sourceRoot":"","sources":["../../../src/core/cli/global-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC"}

package/dist/core/cli/positional.js

@@ -0,0 +1,9 @@
+/**
+ * Coerce a raw Commander positional argument to a string, or undefined when absent.
+ *
+ * @since 0.3.16-canary.0
+ */
+export function readOptionalPositionalArg(candidate) {
+    return typeof candidate === "string" ? candidate : undefined;
+}
+//# sourceMappingURL=positional.js.map

package/dist/core/cli/positional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"positional.js","sourceRoot":"","sources":["../../../src/core/cli/positional.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,SAAkB;IAC1D,OAAO,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/D,CAAC"}