@empline/preflight 1.0.20

package/dist/checks/ui/feature-page-hero-consistency.js

@@ -0,0 +1,228 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Feature Page Hero Consistency Preflight
+ *
+ * Ensures all feature/info pages linked from the homepage have consistent hero sections:
+ *
+ * REQUIRED PATTERN:
+ *   - pt-12 class on main content wrapper (top gap after header)
+ *   - Icon in circular gradient background with shadow
+ *   - Gradient text for main title using var(--gradient-hero-rainbow)
+ *   - CSS variables for spacing (var(--spacing-*))
+ *
+ * PAGES COVERED:
+ *   - app/features/* (marketplace, ai-recognition, collection, grading)
+ *   - app/shipping/ShippingClient.tsx
+ *   - app/returns/ReturnsClient.tsx
+ *   - app/trust-safety/TrustSafetyPageClient.tsx
+ *   - app/how-it-works/HowItWorksClient.tsx
+ *
+ * Usage:
+ *   pnpm preflight:feature-page-hero
+ */
+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 glob_1 = require("glob");
+const console_chars_1 = require("../../utils/console-chars");
+const glob_patterns_1 = require("../../shared/glob-patterns");
+// Check metadata
+exports.id = "ui/feature-page-hero-consistency";
+exports.name = "Feature Page Hero Consistency";
+exports.category = "ui";
+exports.blocking = false;
+exports.description = "Feature Page Hero Consistency Preflight";
+exports.tags = ["ui"];
+const FEATURE_PAGE_PATTERNS = [
+    "app/features/**/*(Client).tsx",
+    "app/shipping/ShippingClient.tsx",
+    "app/returns/ReturnsClient.tsx",
+    "app/trust-safety/TrustSafetyPageClient.tsx",
+    "app/how-it-works/HowItWorksClient.tsx",
+    "app/faq/FAQClient.tsx",
+];
+const EXCLUDED = [...glob_patterns_1.STANDARD_EXCLUDES];
+// Required hero patterns
+const HERO_REQUIREMENTS = {
+    topPadding: "pt-12",
+    iconCircleBackground: /background:\s*["']var\(--gradient-card-(?:primary|warning|success|info)\)["']/,
+    iconCircleShadow: /boxShadow:\s*["']var\(--shadow-xl\)["']/,
+    gradientTitle: /background:\s*["']var\(--gradient-hero-rainbow\)["']/,
+    webkitClip: /WebkitBackgroundClip:\s*["']text["']/,
+};
+async function checkFeaturePageHero() {
+    const issues = [];
+    // Get all feature page files
+    const files = [];
+    for (const pattern of FEATURE_PAGE_PATTERNS) {
+        const matches = await (0, glob_1.glob)(pattern, { ignore: EXCLUDED });
+        files.push(...matches);
+    }
+    for (const file of files) {
+        if (!fs.existsSync(file))
+            continue;
+        const content = fs.readFileSync(file, "utf8");
+        const lines = content.split("\n");
+        // Skip if not a client component with hero section
+        if (!content.includes('"use client"') && !content.includes("'use client'")) {
+            continue;
+        }
+        // Check for pt-12 top padding
+        const hasPt12 = content.includes('className="pt-12"') ||
+            content.includes("className='pt-12'") ||
+            /className=\{[^}]*pt-12/.test(content);
+        if (!hasPt12) {
+            // Find the main content wrapper line
+            let wrapperLine = 0;
+            for (let i = 0; i < lines.length; i++) {
+                if (/<div|<Box/.test(lines[i]) && /flex:\s*["']1["']/.test(lines[i])) {
+                    wrapperLine = i + 1;
+                    break;
+                }
+            }
+            issues.push({
+                file,
+                line: wrapperLine || 1,
+                type: "missing-top-padding",
+                severity: "error",
+                message: `Missing pt-12 class on main content wrapper`,
+                suggestion: `Add className="pt-12" to the main content wrapper div after UnifiedHeader`,
+            });
+        }
+        // Check for icon in circular gradient background
+        const hasIconCircle = HERO_REQUIREMENTS.iconCircleBackground.test(content);
+        if (!hasIconCircle) {
+            issues.push({
+                file,
+                line: 1,
+                type: "missing-icon-circle",
+                severity: "error",
+                message: `Hero icon missing circular gradient background`,
+                suggestion: `Wrap icon in a div with: background: "var(--gradient-card-primary)", borderRadius: "50%", width/height: "var(--spacing-20)"`,
+            });
+        }
+        // Check for icon circle shadow
+        const hasIconShadow = HERO_REQUIREMENTS.iconCircleShadow.test(content);
+        if (hasIconCircle && !hasIconShadow) {
+            issues.push({
+                file,
+                line: 1,
+                type: "missing-icon-shadow",
+                severity: "warning",
+                message: `Hero icon circle missing shadow`,
+                suggestion: `Add boxShadow: "var(--shadow-xl)" to the icon circle`,
+            });
+        }
+        // Check for gradient title
+        const hasGradientTitle = HERO_REQUIREMENTS.gradientTitle.test(content);
+        if (!hasGradientTitle) {
+            // Find h1 line
+            let h1Line = 0;
+            for (let i = 0; i < lines.length; i++) {
+                if (/<h1|<Typography.*variant=["']h1/.test(lines[i])) {
+                    h1Line = i + 1;
+                    break;
+                }
+            }
+            issues.push({
+                file,
+                line: h1Line || 1,
+                type: "missing-gradient-title",
+                severity: "error",
+                message: `Hero title missing gradient text effect`,
+                suggestion: `Add to h1 style: background: "var(--gradient-hero-rainbow)", WebkitBackgroundClip: "text", WebkitTextFillColor: "transparent"`,
+            });
+        }
+        // Check for webkit clip (required for gradient text)
+        if (hasGradientTitle && !HERO_REQUIREMENTS.webkitClip.test(content)) {
+            issues.push({
+                file,
+                line: 1,
+                type: "missing-webkit-clip",
+                severity: "error",
+                message: `Gradient title missing WebkitBackgroundClip: "text"`,
+                suggestion: `Add WebkitBackgroundClip: "text" and WebkitTextFillColor: "transparent" to make gradient visible`,
+            });
+        }
+    }
+    return issues;
+}
+async function main() {
+    console.log(`\n${console_chars_1.emoji.palette} FEATURE PAGE HERO CONSISTENCY PREFLIGHT`);
+    console.log(`${console_chars_1.box.doubleHorizontal}`.repeat(70));
+    console.log("Checks: pt-12 top gap, icon in gradient circle, gradient title text");
+    console.log("Pages: features/*, shipping, returns, trust-safety, how-it-works, faq");
+    console.log((0, console_chars_1.createDivider)(70, "double"));
+    const issues = await checkFeaturePageHero();
+    const errors = issues.filter((i) => i.severity === "error");
+    const warnings = issues.filter((i) => i.severity === "warning");
+    if (issues.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} All feature page heroes are consistent!`);
+        process.exit(0);
+    }
+    console.log(`\nFound ${errors.length} error(s), ${warnings.length} warning(s):\n`);
+    // Group by file
+    const byFile = new Map();
+    for (const issue of issues) {
+        const existing = byFile.get(issue.file) || [];
+        existing.push(issue);
+        byFile.set(issue.file, existing);
+    }
+    for (const [file, fileIssues] of byFile) {
+        console.log(`${console_chars_1.emoji.folder} ${file}`);
+        for (const issue of fileIssues) {
+            const icon = issue.severity === "error" ? `${console_chars_1.emoji.error}` : `${console_chars_1.emoji.warning}`;
+            console.log(`   ${icon} Line ${issue.line}: ${issue.message}`);
+            console.log(`      ${console_chars_1.chars.arrow} ${issue.suggestion}`);
+            if (issue.snippet) {
+                console.log(`      ${issue.snippet}`);
+            }
+        }
+        console.log();
+    }
+    console.log(`${console_chars_1.box.doubleHorizontal}`.repeat(70));
+    if (errors.length > 0) {
+        console.log(`${console_chars_1.emoji.error} FAILED: ${errors.length} error(s) must be fixed`);
+        process.exit(1);
+    }
+    else {
+        console.log(`${console_chars_1.emoji.warning} PASSED with ${warnings.length} warning(s)`);
+        process.exit(0);
+    }
+}
+main().catch(console.error);
+//# sourceMappingURL=feature-page-hero-consistency.js.map

package/dist/checks/ui/feature-page-hero-consistency.js.map

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

package/dist/checks/ui/filter-loading-states.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Preflight: Filter Loading States Validation
+ *
+ * RULE: Core filter section builders (Year, Brand, Player, Set, Team) must ALWAYS
+ * return a FilterSection object, never null. They should use the `loading` property
+ * to indicate when data is not yet available.
+ *
+ * This prevents layout shift and provides better UX during page load.
+ *
+ * @blocking true
+ * @category ui
+ */
+export declare const id = "ui/filter-loading-states";
+export declare const name = "Filter Loading States";
+export declare const category = "ui";
+export declare const blocking = true;
+export declare const description = "Preflight: Filter Loading States Validation";
+export declare const tags: string[];
+//# sourceMappingURL=filter-loading-states.d.ts.map

package/dist/checks/ui/filter-loading-states.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-loading-states.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/filter-loading-states.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,eAAO,MAAM,EAAE,6BAA6B,CAAC;AAC7C,eAAO,MAAM,IAAI,0BAA0B,CAAC;AAC5C,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,gDAAgD,CAAC;AACzE,eAAO,MAAM,IAAI,UAAS,CAAC"}

package/dist/checks/ui/filter-loading-states.js

@@ -0,0 +1,193 @@
+"use strict";
+/**
+ * Preflight: Filter Loading States Validation
+ *
+ * RULE: Core filter section builders (Year, Brand, Player, Set, Team) must ALWAYS
+ * return a FilterSection object, never null. They should use the `loading` property
+ * to indicate when data is not yet available.
+ *
+ * This prevents layout shift and provides better UX during page load.
+ *
+ * @blocking true
+ * @category ui
+ */
+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 path = __importStar(require("path"));
+// Check metadata
+exports.id = "ui/filter-loading-states";
+exports.name = "Filter Loading States";
+exports.category = "ui";
+exports.blocking = true;
+exports.description = "Preflight: Filter Loading States Validation";
+exports.tags = ["ui"];
+const FILTER_SECTIONS_PATH = "components/filters/config/filterSections.ts";
+// Core filter builders that must NEVER return null
+const CORE_FILTER_BUILDERS = [
+    "buildYearSection",
+    "buildBrandSection",
+    "buildPlayerSection",
+    "buildSeriesSection",
+    "buildTeamSection",
+];
+// Builders that are allowed to return null (non-core filters)
+const NULLABLE_BUILDERS = [
+    "buildPriceRangeSection", // Can return null when no listings
+    "buildSellerSection", // Optional filter
+];
+function validateFilterSections() {
+    const errors = [];
+    const filePath = path.resolve(process.cwd(), FILTER_SECTIONS_PATH);
+    if (!fs.existsSync(filePath)) {
+        return {
+            passed: false,
+            errors: [
+                {
+                    builder: "N/A",
+                    line: 0,
+                    message: `Filter sections file not found: ${FILTER_SECTIONS_PATH}`,
+                },
+            ],
+        };
+    }
+    const content = fs.readFileSync(filePath, "utf-8");
+    const lines = content.split("\n");
+    for (const builder of CORE_FILTER_BUILDERS) {
+        // Find the function definition
+        const funcRegex = new RegExp(`export function ${builder}\\s*\\(`);
+        const funcIndex = lines.findIndex((line) => funcRegex.test(line));
+        if (funcIndex === -1) {
+            errors.push({
+                builder,
+                line: 0,
+                message: `Core filter builder "${builder}" not found in ${FILTER_SECTIONS_PATH}`,
+            });
+            continue;
+        }
+        // Check return type - should be FilterSection, not FilterSection | null
+        const returnTypeRegex = new RegExp(`${builder}[^:]*:\\s*FilterSection\\s*\\|\\s*null`);
+        const hasNullableReturn = lines.some((line) => returnTypeRegex.test(line));
+        if (hasNullableReturn) {
+            errors.push({
+                builder,
+                line: funcIndex + 1,
+                message: `Core filter builder "${builder}" has nullable return type. Core filters must ALWAYS return a FilterSection with loading: true when no data.`,
+            });
+        }
+        // Check for early return null patterns
+        const funcStartIndex = funcIndex;
+        let braceCount = 0;
+        let funcEndIndex = funcIndex;
+        let foundFuncStart = false;
+        for (let i = funcIndex; i < lines.length; i++) {
+            const line = lines[i];
+            braceCount += (line.match(/{/g) || []).length;
+            braceCount -= (line.match(/}/g) || []).length;
+            if (braceCount > 0) {
+                foundFuncStart = true;
+            }
+            if (foundFuncStart && braceCount === 0) {
+                funcEndIndex = i;
+                break;
+            }
+        }
+        // Check for "return null" within the function
+        for (let i = funcStartIndex; i <= funcEndIndex; i++) {
+            const line = lines[i];
+            if (/return\s+null\s*;/.test(line)) {
+                errors.push({
+                    builder,
+                    line: i + 1,
+                    message: `Core filter builder "${builder}" returns null at line ${i + 1}. Use loading: true instead.`,
+                });
+            }
+        }
+        // Check that loading property is used
+        const funcContent = lines.slice(funcStartIndex, funcEndIndex + 1).join("\n");
+        if (!funcContent.includes("loading:")) {
+            errors.push({
+                builder,
+                line: funcIndex + 1,
+                message: `Core filter builder "${builder}" does not use the loading property. Add loading: !hasData to indicate loading state.`,
+            });
+        }
+    }
+    return {
+        passed: errors.length === 0,
+        errors,
+    };
+}
+function main() {
+    console.log("🔍 Validating filter loading states...\n");
+    const { passed, errors } = validateFilterSections();
+    if (passed) {
+        console.log("✅ All core filter builders properly handle loading states\n");
+        console.log("   Core filters checked:");
+        CORE_FILTER_BUILDERS.forEach((builder) => {
+            console.log(`   ✓ ${builder}`);
+        });
+        process.exit(0);
+    }
+    else {
+        console.log("❌ Filter loading state validation failed\n");
+        console.log("   Errors found:\n");
+        errors.forEach((error) => {
+            console.log(`   ❌ ${error.builder} (line ${error.line})`);
+            console.log(`      ${error.message}\n`);
+        });
+        console.log("\n   📋 RULE: Core filter builders must:");
+        console.log("      1. NEVER return null");
+        console.log("      2. Return FilterSection with loading: true when no data");
+        console.log("      3. Show skeleton UI while loading\n");
+        console.log("   Example fix:");
+        console.log("   ```typescript");
+        console.log("   export function buildYearSection(options): FilterSection {");
+        console.log("     const hasData = options.length > 0;");
+        console.log("     return {");
+        console.log("       id: 'year',");
+        console.log("       label: 'Year',");
+        console.log("       options: hasData ? options : [{ value: 'All', label: 'All Years' }],");
+        console.log("       loading: !hasData,  // <-- Shows skeleton when no data");
+        console.log("       visible: true,");
+        console.log("     };");
+        console.log("   }");
+        console.log("   ```\n");
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=filter-loading-states.js.map

package/dist/checks/ui/filter-loading-states.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-loading-states.js","sourceRoot":"","sources":["../../../src/checks/ui/filter-loading-states.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAG7B,iBAAiB;AACJ,QAAA,EAAE,GAAG,0BAA0B,CAAC;AAChC,QAAA,IAAI,GAAG,uBAAuB,CAAC;AAC/B,QAAA,QAAQ,GAAG,IAAI,CAAC;AAChB,QAAA,QAAQ,GAAG,IAAI,CAAC;AAChB,QAAA,WAAW,GAAG,6CAA6C,CAAC;AAC5D,QAAA,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;AAE3B,MAAM,oBAAoB,GAAG,6CAA6C,CAAC;AAE3E,mDAAmD;AACnD,MAAM,oBAAoB,GAAG;IAC3B,kBAAkB;IAClB,mBAAmB;IACnB,oBAAoB;IACpB,oBAAoB;IACpB,kBAAkB;CACnB,CAAC;AAEF,8DAA8D;AAC9D,MAAM,iBAAiB,GAAG;IACxB,wBAAwB,EAAE,mCAAmC;IAC7D,oBAAoB,EAAE,kBAAkB;CACzC,CAAC;AAQF,SAAS,sBAAsB;IAC7B,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,oBAAoB,CAAC,CAAC;IAEnE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,MAAM,EAAE,KAAK;YACb,MAAM,EAAE;gBACN;oBACE,OAAO,EAAE,KAAK;oBACd,IAAI,EAAE,CAAC;oBACP,OAAO,EAAE,mCAAmC,oBAAoB,EAAE;iBACnE;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,KAAK,MAAM,OAAO,IAAI,oBAAoB,EAAE,CAAC;QAC3C,+BAA+B;QAC/B,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,mBAAmB,OAAO,SAAS,CAAC,CAAC;QAClE,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAElE,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO;gBACP,IAAI,EAAE,CAAC;gBACP,OAAO,EAAE,wBAAwB,OAAO,kBAAkB,oBAAoB,EAAE;aACjF,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,wEAAwE;QACxE,MAAM,eAAe,GAAG,IAAI,MAAM,CAAC,GAAG,OAAO,wCAAwC,CAAC,CAAC;QACvF,MAAM,iBAAiB,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAE3E,IAAI,iBAAiB,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO;gBACP,IAAI,EAAE,SAAS,GAAG,CAAC;gBACnB,OAAO,EAAE,wBAAwB,OAAO,8GAA8G;aACvJ,CAAC,CAAC;QACL,CAAC;QAED,uCAAuC;QACvC,MAAM,cAAc,GAAG,SAAS,CAAC;QACjC,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,YAAY,GAAG,SAAS,CAAC;QAC7B,IAAI,cAAc,GAAG,KAAK,CAAC;QAE3B,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,UAAU,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YAC9C,UAAU,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YAE9C,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;gBACnB,cAAc,GAAG,IAAI,CAAC;YACxB,CAAC;YAED,IAAI,cAAc,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;gBACvC,YAAY,GAAG,CAAC,CAAC;gBACjB,MAAM;YACR,CAAC;QACH,CAAC;QAED,8CAA8C;QAC9C,KAAK,IAAI,CAAC,GAAG,cAAc,EAAE,CAAC,IAAI,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,MAAM,CAAC,IAAI,CAAC;oBACV,OAAO;oBACP,IAAI,EAAE,CAAC,GAAG,CAAC;oBACX,OAAO,EAAE,wBAAwB,OAAO,0BAA0B,CAAC,GAAG,CAAC,8BAA8B;iBACtG,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,sCAAsC;QACtC,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO;gBACP,IAAI,EAAE,SAAS,GAAG,CAAC;gBACnB,OAAO,EAAE,wBAAwB,OAAO,uFAAuF;aAChI,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC3B,MAAM;KACP,CAAC;AACJ,CAAC;AAED,SAAS,IAAI;IACX,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IAExD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,sBAAsB,EAAE,CAAC;IAEpD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;QAC3E,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QACxC,oBAAoB,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACvC,OAAO,CAAC,GAAG,CAAC,QAAQ,OAAO,EAAE,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAElC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACvB,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,CAAC,OAAO,UAAU,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;QAC7E,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QAEzD,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;QAC7E,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;QAC3F,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;QAC7E,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAExB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/checks/ui/flex-icon-text-gap.d.ts

@@ -0,0 +1,30 @@
+#!/usr/bin/env tsx
+/**
+ * Flex Icon-Text Gap Preflight (BLOCKING)
+ *
+ * Detects flex containers with icon + text patterns that are missing gap spacing.
+ * This catches the common issue where icons touch their adjacent text labels.
+ *
+ * PATTERNS DETECTED:
+ * 1. Flex containers with icon (lucide-react, Icon component) + Typography/text without gap
+ * 2. Flex row containers with multiple stat/metric boxes without gap
+ * 3. Flex containers with alignItems: "flex-start" or "center" but no gap
+ *
+ * VALID PATTERNS (not flagged):
+ * - Flex containers with gap-X class
+ * - Flex containers with gap: "var(--spacing-X)" style
+ * - Flex containers with space-x-X or space-y-X classes
+ * - Single-child flex containers (centering)
+ *
+ * Usage:
+ *   pnpm preflight:flex-icon-text-gap
+ *   pnpm preflight:flex-icon-text-gap --verbose
+ *   pnpm preflight:flex-icon-text-gap --fix (shows suggestions)
+ */
+export declare const id = "ui/flex-icon-text-gap";
+export declare const name = "Flex Icon Text Gap";
+export declare const category = "ui";
+export declare const blocking = true;
+export declare const description = "Flex Icon-Text Gap Preflight (BLOCKING)";
+export declare const tags: string[];
+//# sourceMappingURL=flex-icon-text-gap.d.ts.map

package/dist/checks/ui/flex-icon-text-gap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flex-icon-text-gap.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/flex-icon-text-gap.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;GAqBG;AASH,eAAO,MAAM,EAAE,0BAA0B,CAAC;AAC1C,eAAO,MAAM,IAAI,uBAAuB,CAAC;AACzC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,4CAA4C,CAAC;AACrE,eAAO,MAAM,IAAI,UAAS,CAAC"}