@empline/preflight 1.0.20

package/dist/checks/ui/css-token-syntax.js

@@ -0,0 +1,386 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * CSS Token Syntax & Validation Preflight (BLOCKING)
+ *
+ * Comprehensive validation of CSS design tokens in UI components.
+ * Ensures consistent use of the design system and catches common mistakes.
+ *
+ * CHECKS PERFORMED:
+ * 1. Invalid syntax: underscores instead of hyphens (e.g., --spacing-1_5)
+ * 2. Non-existent tokens: typos or made-up token names
+ * 3. Common typos: catches frequent mistakes with suggestions
+ *
+ * Usage:
+ *   pnpm preflight:css-token-syntax
+ */
+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");
+// Check metadata
+exports.id = "ui/css-token-syntax";
+exports.name = "Css Token Syntax";
+exports.category = "ui";
+exports.blocking = true;
+exports.description = "CSS Token Syntax & Validation Preflight (BLOCKING)";
+exports.tags = ["ui"];
+// Valid spacing tokens from tokens.css (including extended tokens from lib/theme.ts)
+const VALID_SPACING_TOKENS = new Set([
+    "--spacing-0",
+    "--spacing-0-5",
+    "--spacing-1",
+    "--spacing-1-5",
+    "--spacing-2",
+    "--spacing-2-5",
+    "--spacing-3",
+    "--spacing-3-5",
+    "--spacing-4",
+    "--spacing-5",
+    "--spacing-6",
+    "--spacing-8",
+    "--spacing-9",
+    "--spacing-10",
+    "--spacing-12",
+    "--spacing-16",
+    "--spacing-18",
+    "--spacing-20",
+    "--spacing-24",
+    "--spacing-32",
+    "--spacing-36",
+    "--spacing-40",
+    "--spacing-48",
+    "--spacing-56",
+    "--spacing-64",
+    "--spacing-72",
+    "--spacing-80",
+    "--spacing-96",
+]);
+// Valid font-size tokens (including responsive variants)
+const VALID_FONT_SIZE_TOKENS = new Set([
+    "--font-size-2xs",
+    "--font-size-xs",
+    "--font-size-sm",
+    "--font-size-base",
+    "--font-size-lg",
+    "--font-size-xl",
+    "--font-size-2xl",
+    "--font-size-3xl",
+    "--font-size-4xl",
+    "--font-size-5xl",
+    "--font-size-6xl",
+    // Responsive variants
+    "--font-size-responsive-xs",
+    "--font-size-responsive-sm",
+    "--font-size-responsive-md",
+    "--font-size-responsive-lg",
+    "--font-size-responsive-xl",
+    "--font-size-responsive-2xl",
+    "--font-size-responsive-3xl",
+]);
+// Valid radius tokens
+const VALID_RADIUS_TOKENS = new Set([
+    "--radius-none",
+    "--radius-sm",
+    "--radius-md",
+    "--radius-lg",
+    "--radius-xl",
+    "--radius-2xl",
+    "--radius-full",
+]);
+// Valid z-index tokens
+const VALID_Z_INDEX_TOKENS = new Set([
+    "--z-base",
+    "--z-content-low",
+    "--z-content-mid",
+    "--z-content-overlay",
+    "--z-content-controls",
+    "--z-header",
+    "--z-appbar",
+    "--z-sidebar",
+    "--z-navigation",
+    "--z-sticky",
+    "--z-fixed",
+    "--z-dropdown",
+    "--z-header-dropdown",
+    "--z-drawer",
+    "--z-fab",
+    "--z-backdrop",
+    "--z-modal-backdrop",
+    "--z-modal",
+    "--z-popover",
+    "--z-tooltip",
+    "--z-notification",
+    "--z-toast",
+]);
+// Common typos and their corrections
+const COMMON_TYPOS = {
+    "--spacing-05": "--spacing-0-5",
+    "--spacing-15": "--spacing-1-5",
+    "--spacing-25": "--spacing-2-5",
+    "--spacing-35": "--spacing-3-5",
+    "--font-xs": "--font-size-xs",
+    "--font-sm": "--font-size-sm",
+    "--font-md": "--font-size-base",
+    "--font-lg": "--font-size-lg",
+    "--font-xl": "--font-size-xl",
+    "--radius-small": "--radius-sm",
+    "--radius-medium": "--radius-md",
+    "--radius-large": "--radius-lg",
+    "--z-index-modal": "--z-modal",
+    "--z-index-dropdown": "--z-dropdown",
+    "--z-index-tooltip": "--z-tooltip",
+};
+async function checkCssTokenSyntax() {
+    console.log(`\n${console_chars_1.emoji.search} CSS Token Syntax & Validation Check (BLOCKING)\n`);
+    console.log("Validates CSS design tokens for syntax errors and existence.\n");
+    const tsxFiles = await file_cache_1.fileCache.getAllTsTsx();
+    const cssFiles = await file_cache_1.fileCache.getCSSFiles();
+    const files = [...tsxFiles, ...cssFiles];
+    const issues = [];
+    // Patterns
+    const underscoreInVarPattern = /var\(--[a-zA-Z0-9-]*_[a-zA-Z0-9_-]*\)/g;
+    const spacingVarPattern = /var\((--spacing-[a-zA-Z0-9_-]+)\)/g;
+    const fontSizeVarPattern = /var\((--font-size-[a-zA-Z0-9-]+)\)/g;
+    const radiusVarPattern = /var\((--radius-[a-zA-Z0-9-]+)\)/g;
+    const zIndexVarPattern = /var\((--z-[a-zA-Z0-9-]+)\)/g;
+    for (const file of files) {
+        // Skip test files, node_modules, tokens definition, and scripts (contain examples)
+        if (file.includes("__tests__") ||
+            file.includes("node_modules") ||
+            file.includes(".test.") ||
+            file.includes(".spec.") ||
+            file.includes("/tests/") ||
+            file.includes("tokens.css") ||
+            file.includes("/scripts/") ||
+            file.includes("\\scripts\\") ||
+            file.includes("scripts/active/")) {
+            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;
+            const trimmed = line.trim();
+            if (trimmed.startsWith("//") || trimmed.startsWith("/*") || trimmed.startsWith("*"))
+                continue;
+            if (line.includes("preflight-ignore"))
+                continue;
+            // Check 1: Underscore in CSS variable names
+            const underscoreMatches = line.match(underscoreInVarPattern);
+            if (underscoreMatches) {
+                for (const match of underscoreMatches) {
+                    const varName = match.replace("var(", "").replace(")", "");
+                    const correctedName = varName.replace(/_/g, "-");
+                    issues.push({
+                        file,
+                        line: lineNum,
+                        type: "error",
+                        category: "Invalid Syntax",
+                        message: `Invalid CSS variable syntax: ${match}`,
+                        context: line.trim().substring(0, 100),
+                        suggestion: `Use hyphens instead of underscores: var(${correctedName})`,
+                    });
+                }
+            }
+            // Check 2: Non-existent spacing tokens
+            let spacingMatch;
+            spacingVarPattern.lastIndex = 0;
+            while ((spacingMatch = spacingVarPattern.exec(line)) !== null) {
+                const tokenName = spacingMatch[1];
+                if (tokenName.includes("_"))
+                    continue;
+                if (!VALID_SPACING_TOKENS.has(tokenName)) {
+                    const typoFix = COMMON_TYPOS[tokenName];
+                    issues.push({
+                        file,
+                        line: lineNum,
+                        type: "error",
+                        category: "Invalid Token",
+                        message: `Non-existent spacing token: var(${tokenName})`,
+                        context: line.trim().substring(0, 100),
+                        suggestion: typoFix
+                            ? `Did you mean var(${typoFix})?`
+                            : `Valid: 0, 0-5, 1, 1-5, 2, 2-5, 3, 3-5, 4, 5, 6, 8, 9, 10, 12, 16, 18, 20, 24, 36`,
+                    });
+                }
+            }
+            // Check 3: Non-existent font-size tokens
+            let fontMatch;
+            fontSizeVarPattern.lastIndex = 0;
+            while ((fontMatch = fontSizeVarPattern.exec(line)) !== null) {
+                const tokenName = fontMatch[1];
+                if (!VALID_FONT_SIZE_TOKENS.has(tokenName)) {
+                    issues.push({
+                        file,
+                        line: lineNum,
+                        type: "warning",
+                        category: "Invalid Token",
+                        message: `Non-existent font-size token: var(${tokenName})`,
+                        context: line.trim().substring(0, 100),
+                        suggestion: `Valid: xs, sm, base, lg, xl, 2xl, 3xl, 4xl, 5xl, 6xl`,
+                    });
+                }
+            }
+            // Check 4: Non-existent radius tokens
+            let radiusMatch;
+            radiusVarPattern.lastIndex = 0;
+            while ((radiusMatch = radiusVarPattern.exec(line)) !== null) {
+                const tokenName = radiusMatch[1];
+                if (!VALID_RADIUS_TOKENS.has(tokenName)) {
+                    const typoFix = COMMON_TYPOS[tokenName];
+                    issues.push({
+                        file,
+                        line: lineNum,
+                        type: "warning",
+                        category: "Invalid Token",
+                        message: `Non-existent radius token: var(${tokenName})`,
+                        context: line.trim().substring(0, 100),
+                        suggestion: typoFix
+                            ? `Did you mean var(${typoFix})?`
+                            : `Valid: none, sm, md, lg, xl, 2xl, full`,
+                    });
+                }
+            }
+            // Check 5: Non-existent z-index tokens
+            let zMatch;
+            zIndexVarPattern.lastIndex = 0;
+            while ((zMatch = zIndexVarPattern.exec(line)) !== null) {
+                const tokenName = zMatch[1];
+                if (!VALID_Z_INDEX_TOKENS.has(tokenName)) {
+                    const typoFix = COMMON_TYPOS[tokenName];
+                    issues.push({
+                        file,
+                        line: lineNum,
+                        type: "warning",
+                        category: "Invalid Token",
+                        message: `Non-existent z-index token: var(${tokenName})`,
+                        context: line.trim().substring(0, 100),
+                        suggestion: typoFix
+                            ? `Did you mean var(${typoFix})?`
+                            : `Valid: base, content-low, sticky, modal, dropdown, tooltip, etc.`,
+                    });
+                }
+            }
+            // Check 6: Common typos
+            for (const [typo, correction] of Object.entries(COMMON_TYPOS)) {
+                if (line.includes(`var(${typo})`)) {
+                    issues.push({
+                        file,
+                        line: lineNum,
+                        type: "error",
+                        category: "Typo",
+                        message: `Likely typo in CSS variable: var(${typo})`,
+                        context: line.trim().substring(0, 100),
+                        suggestion: `Did you mean var(${correction})?`,
+                    });
+                }
+            }
+        }
+    }
+    // Deduplicate
+    const seen = new Set();
+    const uniqueIssues = issues.filter((issue) => {
+        const key = `${issue.file}:${issue.line}:${issue.message}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+    // Report
+    console.log((0, console_chars_1.createDivider)(60, "light"));
+    if (uniqueIssues.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} No CSS token issues found!\n`);
+        console.log(`Checked: syntax, spacing, font-size, radius, z-index tokens\n`);
+        return;
+    }
+    const errors = uniqueIssues.filter((i) => i.type === "error");
+    const warnings = uniqueIssues.filter((i) => i.type === "warning");
+    // Group by category
+    const byCategory = new Map();
+    for (const issue of uniqueIssues) {
+        const existing = byCategory.get(issue.category) || [];
+        existing.push(issue);
+        byCategory.set(issue.category, existing);
+    }
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} ERRORS (${errors.length}):\n`);
+        for (const [category, categoryIssues] of byCategory) {
+            const categoryErrors = categoryIssues.filter((i) => i.type === "error");
+            if (categoryErrors.length === 0)
+                continue;
+            console.log(`  ${console_chars_1.emoji.folder} ${category} (${categoryErrors.length}):`);
+            categoryErrors.slice(0, 10).forEach((issue) => {
+                console.log(`    ${issue.file}:${issue.line}`);
+                console.log(`      ${issue.message}`);
+                console.log(`      ${console_chars_1.emoji.hint} ${issue.suggestion}\n`);
+            });
+            if (categoryErrors.length > 10) {
+                console.log(`    ... and ${categoryErrors.length - 10} more\n`);
+            }
+        }
+    }
+    if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning} WARNINGS (${warnings.length}):\n`);
+        for (const [category, categoryIssues] of byCategory) {
+            const categoryWarnings = categoryIssues.filter((i) => i.type === "warning");
+            if (categoryWarnings.length === 0)
+                continue;
+            console.log(`  ${console_chars_1.emoji.folder} ${category} (${categoryWarnings.length}):`);
+            categoryWarnings.slice(0, 5).forEach((issue) => {
+                console.log(`    ${issue.file}:${issue.line}`);
+                console.log(`      ${issue.message}`);
+                console.log(`      ${console_chars_1.emoji.hint} ${issue.suggestion}\n`);
+            });
+            if (categoryWarnings.length > 5) {
+                console.log(`    ... and ${categoryWarnings.length - 5} more\n`);
+            }
+        }
+    }
+    console.log(`\n${console_chars_1.emoji.chart} Summary: ${errors.length} errors, ${warnings.length} warnings`);
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} CSS token syntax check FAILED\n`);
+        process.exit(1);
+    }
+    console.log(`\n${console_chars_1.emoji.success} CSS token syntax check PASSED (with warnings)\n`);
+}
+checkCssTokenSyntax().catch((err) => {
+    console.error("Error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=css-token-syntax.js.map

package/dist/checks/ui/css-token-syntax.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-token-syntax.js","sourceRoot":"","sources":["../../../src/checks/ui/css-token-syntax.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;;GAaG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,6DAAiE;AACjE,wDAAoD;AAGpD,iBAAiB;AACJ,QAAA,EAAE,GAAG,qBAAqB,CAAC;AAC3B,QAAA,IAAI,GAAG,kBAAkB,CAAC;AAC1B,QAAA,QAAQ,GAAG,IAAI,CAAC;AAChB,QAAA,QAAQ,GAAG,IAAI,CAAC;AAChB,QAAA,WAAW,GAAG,oDAAoD,CAAC;AACnE,QAAA,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;AAY3B,qFAAqF;AACrF,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,aAAa;IACb,eAAe;IACf,aAAa;IACb,eAAe;IACf,aAAa;IACb,eAAe;IACf,aAAa;IACb,eAAe;IACf,aAAa;IACb,aAAa;IACb,aAAa;IACb,aAAa;IACb,aAAa;IACb,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;IACd,cAAc;CACf,CAAC,CAAC;AAEH,yDAAyD;AACzD,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,kBAAkB;IAClB,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;IACjB,iBAAiB;IACjB,iBAAiB;IACjB,iBAAiB;IACjB,sBAAsB;IACtB,2BAA2B;IAC3B,2BAA2B;IAC3B,2BAA2B;IAC3B,2BAA2B;IAC3B,2BAA2B;IAC3B,4BAA4B;IAC5B,4BAA4B;CAC7B,CAAC,CAAC;AAEH,sBAAsB;AACtB,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,eAAe;IACf,aAAa;IACb,aAAa;IACb,aAAa;IACb,aAAa;IACb,cAAc;IACd,eAAe;CAChB,CAAC,CAAC;AAEH,uBAAuB;AACvB,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,UAAU;IACV,iBAAiB;IACjB,iBAAiB;IACjB,qBAAqB;IACrB,sBAAsB;IACtB,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,gBAAgB;IAChB,YAAY;IACZ,WAAW;IACX,cAAc;IACd,qBAAqB;IACrB,YAAY;IACZ,SAAS;IACT,cAAc;IACd,oBAAoB;IACpB,WAAW;IACX,aAAa;IACb,aAAa;IACb,kBAAkB;IAClB,WAAW;CACZ,CAAC,CAAC;AAEH,qCAAqC;AACrC,MAAM,YAAY,GAA2B;IAC3C,cAAc,EAAE,eAAe;IAC/B,cAAc,EAAE,eAAe;IAC/B,cAAc,EAAE,eAAe;IAC/B,cAAc,EAAE,eAAe;IAC/B,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,kBAAkB;IAC/B,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,gBAAgB;IAC7B,gBAAgB,EAAE,aAAa;IAC/B,iBAAiB,EAAE,aAAa;IAChC,gBAAgB,EAAE,aAAa;IAC/B,iBAAiB,EAAE,WAAW;IAC9B,oBAAoB,EAAE,cAAc;IACpC,mBAAmB,EAAE,aAAa;CACnC,CAAC;AAEF,KAAK,UAAU,mBAAmB;IAChC,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,MAAM,mDAAmD,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAAC;IAE9E,MAAM,QAAQ,GAAG,MAAM,sBAAS,CAAC,WAAW,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAG,MAAM,sBAAS,CAAC,WAAW,EAAE,CAAC;IAC/C,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC;IACzC,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,WAAW;IACX,MAAM,sBAAsB,GAAG,wCAAwC,CAAC;IACxE,MAAM,iBAAiB,GAAG,oCAAoC,CAAC;IAC/D,MAAM,kBAAkB,GAAG,qCAAqC,CAAC;IACjE,MAAM,gBAAgB,GAAG,kCAAkC,CAAC;IAC5D,MAAM,gBAAgB,GAAG,6BAA6B,CAAC;IAEvD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,mFAAmF;QACnF,IACE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC1B,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACvB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACvB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;YACxB,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC1B,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAChC,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;YACtB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAE5B,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC9F,IAAI,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC;gBAAE,SAAS;YAEhD,4CAA4C;YAC5C,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;YAC7D,IAAI,iBAAiB,EAAE,CAAC;gBACtB,KAAK,MAAM,KAAK,IAAI,iBAAiB,EAAE,CAAC;oBACtC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;oBAC3D,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;oBACjD,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI;wBACJ,IAAI,EAAE,OAAO;wBACb,IAAI,EAAE,OAAO;wBACb,QAAQ,EAAE,gBAAgB;wBAC1B,OAAO,EAAE,gCAAgC,KAAK,EAAE;wBAChD,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;wBACtC,UAAU,EAAE,2CAA2C,aAAa,GAAG;qBACxE,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,uCAAuC;YACvC,IAAI,YAAY,CAAC;YACjB,iBAAiB,CAAC,SAAS,GAAG,CAAC,CAAC;YAChC,OAAO,CAAC,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC9D,MAAM,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;gBAClC,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAAE,SAAS;gBACtC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;oBACzC,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;oBACxC,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI;wBACJ,IAAI,EAAE,OAAO;wBACb,IAAI,EAAE,OAAO;wBACb,QAAQ,EAAE,eAAe;wBACzB,OAAO,EAAE,mCAAmC,SAAS,GAAG;wBACxD,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;wBACtC,UAAU,EAAE,OAAO;4BACjB,CAAC,CAAC,oBAAoB,OAAO,IAAI;4BACjC,CAAC,CAAC,kFAAkF;qBACvF,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,yCAAyC;YACzC,IAAI,SAAS,CAAC;YACd,kBAAkB,CAAC,SAAS,GAAG,CAAC,CAAC;YACjC,OAAO,CAAC,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC5D,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;gBAC/B,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC3C,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI;wBACJ,IAAI,EAAE,OAAO;wBACb,IAAI,EAAE,SAAS;wBACf,QAAQ,EAAE,eAAe;wBACzB,OAAO,EAAE,qCAAqC,SAAS,GAAG;wBAC1D,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;wBACtC,UAAU,EAAE,sDAAsD;qBACnE,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,sCAAsC;YACtC,IAAI,WAAW,CAAC;YAChB,gBAAgB,CAAC,SAAS,GAAG,CAAC,CAAC;YAC/B,OAAO,CAAC,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC5D,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;gBACjC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;oBACxC,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;oBACxC,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI;wBACJ,IAAI,EAAE,OAAO;wBACb,IAAI,EAAE,SAAS;wBACf,QAAQ,EAAE,eAAe;wBACzB,OAAO,EAAE,kCAAkC,SAAS,GAAG;wBACvD,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;wBACtC,UAAU,EAAE,OAAO;4BACjB,CAAC,CAAC,oBAAoB,OAAO,IAAI;4BACjC,CAAC,CAAC,wCAAwC;qBAC7C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,uCAAuC;YACvC,IAAI,MAAM,CAAC;YACX,gBAAgB,CAAC,SAAS,GAAG,CAAC,CAAC;YAC/B,OAAO,CAAC,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBACvD,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC5B,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;oBACzC,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;oBACxC,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI;wBACJ,IAAI,EAAE,OAAO;wBACb,IAAI,EAAE,SAAS;wBACf,QAAQ,EAAE,eAAe;wBACzB,OAAO,EAAE,mCAAmC,SAAS,GAAG;wBACxD,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;wBACtC,UAAU,EAAE,OAAO;4BACjB,CAAC,CAAC,oBAAoB,OAAO,IAAI;4BACjC,CAAC,CAAC,kEAAkE;qBACvE,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,wBAAwB;YACxB,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC9D,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,GAAG,CAAC,EAAE,CAAC;oBAClC,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI;wBACJ,IAAI,EAAE,OAAO;wBACb,IAAI,EAAE,OAAO;wBACb,QAAQ,EAAE,MAAM;wBAChB,OAAO,EAAE,oCAAoC,IAAI,GAAG;wBACpD,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;wBACtC,UAAU,EAAE,oBAAoB,UAAU,IAAI;qBAC/C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,cAAc;IACd,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3C,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAC3D,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,SAAS;IACT,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAExC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;QAC7E,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAElE,oBAAoB;IACpB,MAAM,UAAU,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC9C,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,KAAK,YAAY,MAAM,CAAC,MAAM,MAAM,CAAC,CAAC;QAC7D,KAAK,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,IAAI,UAAU,EAAE,CAAC;YACpD,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;YACxE,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,MAAM,IAAI,QAAQ,KAAK,cAAc,CAAC,MAAM,IAAI,CAAC,CAAC;YACzE,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC5C,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC/C,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,SAAS,qBAAK,CAAC,IAAI,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;YAC3D,CAAC,CAAC,CAAC;YACH,IAAI,cAAc,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;gBAC/B,OAAO,CAAC,GAAG,CAAC,eAAe,cAAc,CAAC,MAAM,GAAG,EAAE,SAAS,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,cAAc,QAAQ,CAAC,MAAM,MAAM,CAAC,CAAC;QACnE,KAAK,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,IAAI,UAAU,EAAE,CAAC;YACpD,MAAM,gBAAgB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;YAC5E,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,MAAM,IAAI,QAAQ,KAAK,gBAAgB,CAAC,MAAM,IAAI,CAAC,CAAC;YAC3E,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC7C,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC/C,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,SAAS,qBAAK,CAAC,IAAI,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC;YAC3D,CAAC,CAAC,CAAC;YACH,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,eAAe,gBAAgB,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,KAAK,aAAa,MAAM,CAAC,MAAM,YAAY,QAAQ,CAAC,MAAM,WAAW,CAAC,CAAC;IAE9F,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,KAAK,kCAAkC,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,kDAAkD,CAAC,CAAC;AACpF,CAAC;AAED,mBAAmB,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAClC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/checks/ui/dark-mode-support.d.ts

@@ -0,0 +1,95 @@
+#!/usr/bin/env tsx
+/**
+ * Dark Mode Support Preflight
+ *
+ * Detects components that don't properly support dark mode theming:
+ *
+ * 1. Hardcoded light-only colors (bg-white, bg-gray-*, text-gray-*)
+ * 2. Hardcoded color values without dark: variants
+ * 3. Inline styles with hardcoded colors that won't respond to theme
+ * 4. Card/container components with hardcoded shadows (should use CSS variables)
+ *
+ * Note: CSS variable-based styling (var(--shadow-*), var(--bg-*)) automatically
+ * handles dark mode and doesn't need explicit dark: variants.
+ *
+ * Usage:
+ *   pnpm preflight:dark-mode              # All checks
+ *   pnpm preflight:dark-mode tailwind     # Tailwind classes only
+ *   pnpm preflight:dark-mode inline       # Inline styles only
+ *   pnpm preflight:dark-mode cards        # Card dark mode only
+ *   pnpm preflight:dark-mode --strict     # Treat warnings as errors
+ *
+ * @blocking false (warnings only, use --strict for blocking)
+ */
+export declare const id = "ui/dark-mode-support";
+export declare const name = "Dark Mode Support";
+export declare const category = "ui";
+export declare const blocking = false;
+export declare const description = "Dark Mode Support Preflight";
+export declare const tags: string[];
+interface Issue {
+    file: string;
+    line: number;
+    type: string;
+    severity: "error" | "warning" | "info";
+    message: string;
+    suggestion: string;
+    snippet: string;
+}
+interface CheckResult {
+    name: string;
+    passed: boolean;
+    blocking: boolean;
+    issues: Issue[];
+    duration: number;
+}
+declare class DarkModeSupportModule {
+    private verbose;
+    private strict;
+    constructor(options?: {
+        verbose?: boolean;
+        strict?: boolean;
+    });
+    /**
+     * Check 1: Tailwind classes without dark: variants
+     */
+    checkTailwindDarkMode(): Promise<CheckResult>;
+    /**
+     * Check 2: Inline styles with hardcoded colors
+     */
+    checkInlineStyleColors(): Promise<CheckResult>;
+    /**
+     * Check 3: Components using non-themed color tokens
+     * Detects patterns like bg-white that should use semantic tokens
+     */
+    checkSemanticTokenUsage(): Promise<CheckResult>;
+    /**
+     * Check 4: Card/Container components with dark mode issues
+     * Ensures Card, Paper, Modal etc have proper dark mode styling
+     *
+     * Note: CSS variable shadows (shadow-[var(--shadow-NAME)]) are already dark-mode-ready
+     * and don't need explicit dark: variants.
+     */
+    checkCardDarkMode(): Promise<CheckResult>;
+    /**
+     * Check 5: Focus/hover states without dark variants
+     */
+    checkInteractiveStateDarkMode(): Promise<CheckResult>;
+    runAll(): Promise<{
+        module: string;
+        passed: boolean;
+        totalDuration: number;
+        checks: CheckResult[];
+        summary: {
+            total: number;
+            passed: number;
+            failed: number;
+            errors: number;
+            warnings: number;
+            infos: number;
+        };
+    }>;
+    private printResults;
+}
+export { DarkModeSupportModule };
+//# sourceMappingURL=dark-mode-support.d.ts.map

package/dist/checks/ui/dark-mode-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dark-mode-support.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/dark-mode-support.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAWH,eAAO,MAAM,EAAE,yBAAyB,CAAC;AACzC,eAAO,MAAM,IAAI,sBAAsB,CAAC;AACxC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,gCAAgC,CAAC;AACzD,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;CACjB;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAkHD,cAAM,qBAAqB;IACzB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAU;gBAEZ,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO;IAKjE;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,WAAW,CAAC;IAqInD;;OAEG;IACG,sBAAsB,IAAI,OAAO,CAAC,WAAW,CAAC;IA2CpD;;;OAGG;IACG,uBAAuB,IAAI,OAAO,CAAC,WAAW,CAAC;IA8FrD;;;;;;OAMG;IACG,iBAAiB,IAAI,OAAO,CAAC,WAAW,CAAC;IA6F/C;;OAEG;IACG,6BAA6B,IAAI,OAAO,CAAC,WAAW,CAAC;IAqDrD,MAAM,IAAI,OAAO,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,MAAM,EAAE,WAAW,EAAE,CAAC;QACtB,OAAO,EAAE;YACP,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,CAAC;YACf,QAAQ,EAAE,MAAM,CAAC;YACjB,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;IAqCF,OAAO,CAAC,YAAY;CA4DrB;AAuED,OAAO,EAAE,qBAAqB,EAAE,CAAC"}