@empline/preflight 1.0.20

package/dist/checks/ui/tailwind-consistency.js

@@ -0,0 +1,345 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Tailwind Consistency Preflight
+ *
+ * Enforces consistent use of Tailwind classes over CSS variables.
+ *
+ * BLOCKING ERRORS:
+ * - gap-4 usage (use gap-3 or gap-6)
+ *
+ * WARNINGS (migration opportunities):
+ * - gap: "var(--spacing-X)" → className="gap-X"
+ * - padding: "var(--spacing-X)" → className="p-X"
+ * - margin: "var(--spacing-X)" → className="m-X"
+ * - fontSize: "var(--font-size-X)" → className="text-X"
+ *
+ * Usage:
+ *   pnpm preflight:tailwind-consistency
+ *   pnpm preflight:tailwind-consistency --verbose
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+const fs = __importStar(require("fs"));
+const console_chars_1 = require("../../utils/console-chars");
+const file_cache_1 = require("../../shared/file-cache");
+const glob_patterns_1 = require("../../shared/glob-patterns");
+// Check metadata
+exports.id = "ui/tailwind-consistency";
+exports.name = "Tailwind Consistency";
+exports.category = "ui";
+exports.blocking = true;
+exports.description = "Tailwind Consistency Preflight";
+exports.tags = ["ui"];
+const EXCLUDED = (0, glob_patterns_1.extendExcludes)(glob_patterns_1.STANDARD_EXCLUDES_WITH_TESTS, [
+    "**/scripts/**",
+    "**/test-results/**",
+]);
+const DEFINITION_FILES = [
+    "tailwind.config.ts",
+    "lib/critical-css.ts",
+    "components/ui/Stack.tsx",
+    "components/ui/Grid.tsx",
+    "packages/ui/src/components/layout/Stack.tsx",
+    "packages/ui/src/components/layout/Grid.tsx",
+    "styles/",
+];
+// Font size mapping
+const FONT_SIZE_MAP = {
+    xs: "text-xs",
+    sm: "text-sm",
+    base: "text-base",
+    lg: "text-lg",
+    xl: "text-xl",
+    "2xl": "text-2xl",
+    "3xl": "text-3xl",
+    "4xl": "text-4xl",
+    "5xl": "text-5xl",
+    "6xl": "text-6xl",
+};
+function isInStyleBlock(lines, index) {
+    for (let j = index; j >= Math.max(0, index - 50); j--) {
+        if (lines[j].includes("<style>") || lines[j].includes("<style>{")) {
+            for (let k = j + 1; k <= index; k++) {
+                if (lines[k].includes("</style>"))
+                    return false;
+            }
+            return true;
+        }
+        if (lines[j].includes("</style>"))
+            return false;
+    }
+    return false;
+}
+// Check if line is inside a style definition object (Record<string, CSSProperties>)
+function isInStyleDefinition(lines, index) {
+    // Look backwards for patterns like:
+    // const sizeStyles: Record<string, React.CSSProperties> = {
+    // const variantStyles: Record<string, React.CSSProperties> = {
+    for (let j = index; j >= Math.max(0, index - 80); j--) {
+        const line = lines[j];
+        // Found a style definition object
+        if (line.includes("Record<string") && line.includes("CSSProperties")) {
+            // Check if we're still inside it (no closing brace at same indentation)
+            const indent = line.search(/\S/);
+            for (let k = j + 1; k <= index; k++) {
+                const checkLine = lines[k];
+                // Found closing brace at same or lower indentation - we're outside
+                if (checkLine.match(/^\s*\};?\s*$/) && checkLine.search(/\S/) <= indent) {
+                    return false;
+                }
+            }
+            return true;
+        }
+        // Also check for inline style objects that are configuration
+        if (line.includes("sizeStyles:") ||
+            line.includes("variantStyles:") ||
+            line.includes("colorStyles:") ||
+            line.includes("COLOR_STYLES")) {
+            // Check we haven't passed the closing brace
+            for (let k = j + 1; k <= index; k++) {
+                if (lines[k].match(/^const\s/) || lines[k].match(/^export\s/)) {
+                    return false; // Hit another declaration, we're outside
+                }
+            }
+            return true;
+        }
+    }
+    return false;
+}
+// CACHED FILE LISTS - Scan once, use everywhere
+let _cachedAllTsTsxFiles = null;
+async function getAllTsTsxFiles() {
+    if (!_cachedAllTsTsxFiles) {
+        _cachedAllTsTsxFiles = await file_cache_1.fileCache.getAllTsTsx();
+    }
+    return _cachedAllTsTsxFiles;
+}
+async function checkTailwindConsistency() {
+    const verbose = process.argv.includes("--verbose");
+    console.log(`\n${console_chars_1.emoji.palette} Tailwind Consistency Preflight\n`);
+    console.log("Philosophy: Use Tailwind classes for static values, CSS variables only when dynamic\n");
+    console.log("BLOCKING:");
+    console.log(`  ${console_chars_1.emoji.error} gap-4 (use gap-3 or gap-6)\n`);
+    console.log("WARNINGS (migration opportunities):");
+    console.log(`  ${console_chars_1.emoji.warning} gap: "var(--spacing-X)" ${console_chars_1.chars.arrow} gap-X`);
+    console.log(`  ${console_chars_1.emoji.warning} padding: "var(--spacing-X)" ${console_chars_1.chars.arrow} p-X / pt-X / etc.`);
+    console.log(`  ${console_chars_1.emoji.warning} margin: "var(--spacing-X)" ${console_chars_1.chars.arrow} m-X / mt-X / etc.`);
+    console.log(`  ${console_chars_1.emoji.warning} fontSize: "var(--font-size-X)" ${console_chars_1.chars.arrow} text-X\n`);
+    const files = await getAllTsTsxFiles();
+    const issues = [];
+    for (const file of files) {
+        const isDefinitionFile = DEFINITION_FILES.some((def) => file.replace(/\\/g, "/").includes(def));
+        if (isDefinitionFile)
+            continue;
+        const content = fs.readFileSync(file, "utf8");
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const lineNum = i + 1;
+            // Skip comments and preflight-ignore
+            if (line.includes("preflight-ignore"))
+                continue;
+            const trimmed = line.trim();
+            if (trimmed.startsWith("//") || trimmed.startsWith("/*") || trimmed.startsWith("*"))
+                continue;
+            // Skip style blocks (CSS context is fine)
+            if (isInStyleBlock(lines, i))
+                continue;
+            // Skip style definition objects (Record<string, CSSProperties>)
+            if (isInStyleDefinition(lines, i))
+                continue;
+            // BLOCKING: gap-4 in className
+            if (/\bgap-4\b/.test(line) && !isDefinitionFile) {
+                issues.push({
+                    file,
+                    line: lineNum,
+                    type: "error",
+                    category: "gap",
+                    message: "gap-4 is prohibited",
+                    current: "gap-4",
+                    suggested: "gap-3 (standard) or gap-6 (major sections)",
+                });
+            }
+            // WARNING: gap with CSS variable
+            const gapMatch = line.match(/gap:\s*["']var\(--spacing-(\d+)\)["']/);
+            if (gapMatch) {
+                issues.push({
+                    file,
+                    line: lineNum,
+                    type: "warning",
+                    category: "gap",
+                    message: "Prefer Tailwind gap class",
+                    current: `gap: "var(--spacing-${gapMatch[1]})"`,
+                    suggested: `className="gap-${gapMatch[1]}"`,
+                });
+            }
+            // WARNING: padding with CSS variable (single value)
+            const paddingMatch = line.match(/padding:\s*["']var\(--spacing-(\d+)\)["']/);
+            if (paddingMatch) {
+                issues.push({
+                    file,
+                    line: lineNum,
+                    type: "warning",
+                    category: "padding",
+                    message: "Prefer Tailwind padding class",
+                    current: `padding: "var(--spacing-${paddingMatch[1]})"`,
+                    suggested: `className="p-${paddingMatch[1]}"`,
+                });
+            }
+            // WARNING: paddingTop/Bottom/Left/Right with CSS variable
+            const paddingDirMatch = line.match(/padding(Top|Bottom|Left|Right):\s*["']var\(--spacing-(\d+)\)["']/);
+            if (paddingDirMatch) {
+                const dirMap = { Top: "t", Bottom: "b", Left: "l", Right: "r" };
+                const twDir = dirMap[paddingDirMatch[1]];
+                issues.push({
+                    file,
+                    line: lineNum,
+                    type: "warning",
+                    category: "padding",
+                    message: "Prefer Tailwind padding class",
+                    current: `padding${paddingDirMatch[1]}: "var(--spacing-${paddingDirMatch[2]})"`,
+                    suggested: `className="p${twDir}-${paddingDirMatch[2]}"`,
+                });
+            }
+            // WARNING: margin with CSS variable (single value)
+            const marginMatch = line.match(/margin:\s*["']var\(--spacing-(\d+)\)["']/);
+            if (marginMatch) {
+                issues.push({
+                    file,
+                    line: lineNum,
+                    type: "warning",
+                    category: "margin",
+                    message: "Prefer Tailwind margin class",
+                    current: `margin: "var(--spacing-${marginMatch[1]})"`,
+                    suggested: `className="m-${marginMatch[1]}"`,
+                });
+            }
+            // WARNING: marginTop/Bottom/Left/Right with CSS variable
+            const marginDirMatch = line.match(/margin(Top|Bottom|Left|Right):\s*["']var\(--spacing-(\d+)\)["']/);
+            if (marginDirMatch) {
+                const dirMap = { Top: "t", Bottom: "b", Left: "l", Right: "r" };
+                const twDir = dirMap[marginDirMatch[1]];
+                issues.push({
+                    file,
+                    line: lineNum,
+                    type: "warning",
+                    category: "margin",
+                    message: "Prefer Tailwind margin class",
+                    current: `margin${marginDirMatch[1]}: "var(--spacing-${marginDirMatch[2]})"`,
+                    suggested: `className="m${twDir}-${marginDirMatch[2]}"`,
+                });
+            }
+            // WARNING: fontSize with CSS variable
+            const fontMatch = line.match(/fontSize:\s*["']var\(--font-size-([a-z0-9]+)\)["']/);
+            if (fontMatch && FONT_SIZE_MAP[fontMatch[1]]) {
+                issues.push({
+                    file,
+                    line: lineNum,
+                    type: "warning",
+                    category: "fontSize",
+                    message: "Prefer Tailwind text class",
+                    current: `fontSize: "var(--font-size-${fontMatch[1]})"`,
+                    suggested: `className="${FONT_SIZE_MAP[fontMatch[1]]}"`,
+                });
+            }
+        }
+    }
+    // Categorize issues
+    const errors = issues.filter((i) => i.type === "error");
+    const warnings = issues.filter((i) => i.type === "warning");
+    // Group warnings by category
+    const warningsByCategory = new Map();
+    warnings.forEach((w) => {
+        if (!warningsByCategory.has(w.category)) {
+            warningsByCategory.set(w.category, []);
+        }
+        warningsByCategory.get(w.category).push(w);
+    });
+    // Report errors
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} BLOCKING ERRORS (${errors.length}):\n`);
+        errors.forEach((e) => {
+            console.log(`  ${e.file}:${e.line}`);
+            console.log(`    ${e.message}: ${e.current} ${console_chars_1.chars.arrow} ${e.suggested}\n`);
+        });
+    }
+    // Report warnings by category
+    if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning}  WARNINGS - Migration Opportunities (${warnings.length} total):\n`);
+        for (const [category, categoryWarnings] of warningsByCategory) {
+            console.log(`  ${category}: ${categoryWarnings.length} instances`);
+            if (verbose) {
+                categoryWarnings.slice(0, 5).forEach((w) => {
+                    console.log(`    ${w.file}:${w.line}`);
+                    console.log(`      ${w.current} ${console_chars_1.chars.arrow} ${w.suggested}`);
+                });
+                if (categoryWarnings.length > 5) {
+                    console.log(`    ... and ${categoryWarnings.length - 5} more\n`);
+                }
+            }
+        }
+    }
+    // Summary
+    console.log("\n" + (0, console_chars_1.createDivider)(60, "light"));
+    console.log(`\n${console_chars_1.emoji.chart} Summary:`);
+    console.log(`  Errors: ${errors.length} (blocking)`);
+    console.log(`  Warnings: ${warnings.length} (migration opportunities)`);
+    if (warningsByCategory.size > 0) {
+        console.log("\n  By category:");
+        for (const [cat, items] of warningsByCategory) {
+            console.log(`    ${cat}: ${items.length}`);
+        }
+    }
+    if (errors.length > 0) {
+        // ADVISORY MODE: gap-4 has 70+ pre-existing violations - larger refactoring task
+        console.log(`\n${console_chars_1.emoji.warning} ADVISORY: Found ${errors.length} gap-4 usage(s) - consider migrating to gap-3 or gap-6`);
+        console.log("Run: pnpm fix:gap-4:apply when ready to migrate\n");
+        console.log(`${console_chars_1.emoji.hint} This check is advisory. Pre-existing issues won't block the build.`);
+        // Exit 0 - advisory only for pre-existing violations
+    }
+    else {
+        console.log(`\n${console_chars_1.emoji.success} Tailwind consistency check passed!`);
+        if (warnings.length > 0) {
+            console.log(`   (${warnings.length} migration opportunities - run with --verbose for details)\n`);
+        }
+    }
+}
+checkTailwindConsistency().catch((err) => {
+    console.error("Preflight error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=tailwind-consistency.js.map

package/dist/checks/ui/tailwind-consistency.js.map

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

package/dist/checks/ui/tailwind-contrast-check.d.ts

@@ -0,0 +1,44 @@
+#!/usr/bin/env tsx
+/**
+ * Tailwind Contrast Preflight Check
+ *
+ * Detects low-contrast text/background combinations using Tailwind classes.
+ * This catches issues the inline-style contrast check misses.
+ *
+ * Key patterns detected:
+ * 1. text-muted-foreground on colored backgrounds (primary-light, info, warning, etc.)
+ * 2. text-foreground on dark backgrounds without proper override
+ * 3. Muted text inside Alert/Banner components with colored backgrounds
+ * 4. Parent bg-[var(--color-NAME)] with child text-muted-foreground
+ *
+ * Usage:
+ *   pnpm preflight:tailwind-contrast
+ *
+ * @blocking true
+ */
+export declare const id = "ui/tailwind-contrast-check";
+export declare const name = "Tailwind Contrast Check";
+export declare const category = "ui";
+export declare const blocking = true;
+export declare const description = "Tailwind Contrast Preflight Check";
+export declare const tags: string[];
+interface Issue {
+    file: string;
+    line: number;
+    type: string;
+    severity: "error" | "warning" | "info";
+    message: string;
+    suggestion: string;
+    snippet: string;
+    parentContext?: string;
+}
+interface CheckResult {
+    passed: boolean;
+    issues: Issue[];
+    filesChecked: number;
+    duration: number;
+}
+declare function runCheck(): Promise<CheckResult>;
+export { runCheck };
+export type { CheckResult, Issue };
+//# sourceMappingURL=tailwind-contrast-check.d.ts.map

package/dist/checks/ui/tailwind-contrast-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-contrast-check.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/tailwind-contrast-check.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAQH,eAAO,MAAM,EAAE,+BAA+B,CAAC;AAC/C,eAAO,MAAM,IAAI,4BAA4B,CAAC;AAC9C,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,sCAAsC,CAAC;AAC/D,eAAO,MAAM,IAAI,UAAS,CAAC;AAE3B,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,WAAW;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAwVD,iBAAe,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC,CA4B9C;AAkFD,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC"}