@empline/preflight 1.1.0

package/dist/checks/ui/orphaned-table-filters.js

@@ -0,0 +1,289 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Orphaned Table Filters Check Preflight (BLOCKING)
+ *
+ * Detects filter controls and table headers that are not properly contained
+ * within Card components, leading to inconsistent UI.
+ *
+ * WHY THIS MATTERS:
+ * - Filters and tables should be visually grouped in Cards
+ * - Table headers without content look incomplete
+ * - Consistent Card usage improves visual hierarchy
+ * - Empty states should be clean without orphaned headers
+ *
+ * PATTERNS DETECTED:
+ * 1. SearchInput/filters in Box/div outside Card in admin pages
+ * 2. TableContainer/Table directly in page layout without Card wrapper
+ * 3. Table headers visible when table body only contains empty state
+ *
+ * ALLOWED PATTERNS (not flagged):
+ * - Filters inside Card/CardContent/CardHeader
+ * - Tables wrapped in Card components
+ * - Conditional rendering that hides table when empty
+ *
+ * Usage:
+ *   pnpm preflight:orphaned-table-filters
+ *   pnpm preflight:orphaned-table-filters --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;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const file_cache_1 = require("../../shared/file-cache");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "ui/orphaned-table-filters";
+exports.name = "Orphaned Table Filters";
+exports.category = "ui";
+exports.blocking = true;
+exports.description = "Detects filter controls and tables not contained in Card components";
+exports.tags = ["ui", "tables", "filters", "cards", "layout", "design-system"];
+// Filter/search component patterns
+const FILTER_COMPONENTS = [
+    "SearchInput",
+    "TextField.*search",
+    "TextField.*filter",
+];
+// Patterns indicating the content is inside an acceptable container
+const ACCEPTABLE_CONTAINER_PATTERNS = [
+    { open: /<Card[\s>]/g, close: /<\/Card>/g },
+    { open: /<Dialog[\s>]/g, close: /<\/Dialog>/g },
+    { open: /<DetailDialog[\s>]/g, close: /<\/DetailDialog>/g },
+    { open: /<Drawer[\s>]/g, close: /<\/Drawer>/g },
+    { open: /<Modal[\s>]/g, close: /<\/Modal>/g },
+    { open: /<Sheet[\s>]/g, close: /<\/Sheet>/g },
+    { open: /<Accordion[\s>]/g, close: /<\/Accordion>/g },
+    { open: /<Paper[\s>]/g, close: /<\/Paper>/g },
+    { open: /<AlertDialog[\s>]/g, close: /<\/AlertDialog>/g },
+];
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    const verbose = process.argv.includes("--verbose");
+    const warnOnly = process.argv.includes("--warn");
+    console.log(`\n${console_chars_1.emoji.search} Orphaned Table Filters Check${warnOnly ? " (warning mode)" : " (BLOCKING)"}\n`);
+    console.log("Ensures filters and tables are contained within Card components.\n");
+    console.log("Rules:");
+    console.log(`  ${console_chars_1.emoji.error} Filter controls must be inside Card components`);
+    console.log(`  ${console_chars_1.emoji.error} Tables must be wrapped in Card components`);
+    console.log(`  ${console_chars_1.emoji.warning} Table headers should be hidden when showing empty state`);
+    console.log(`  ${console_chars_1.emoji.success} Filters and tables grouped together in Cards\n`);
+    const files = await file_cache_1.fileCache.getAllTsx();
+    const issues = [];
+    for (const file of files) {
+        // Ensure leading slash for consistent matching
+        const normalizedPath = "/" + file.replace(/\\/g, "/").replace(/^\/+/, "");
+        // Only check admin/store/account pages
+        if (!normalizedPath.includes("/app/admin/") &&
+            !normalizedPath.includes("/app/store/") &&
+            !normalizedPath.includes("/app/account/")) {
+            continue;
+        }
+        // Skip certain files
+        if (file.includes(".test.") ||
+            file.includes(".spec.") ||
+            file.includes(".stories.") ||
+            file.includes("layout.tsx") ||
+            file.includes("/components/ui/") ||
+            file.includes("/components/shared/")) {
+            continue;
+        }
+        const content = fs.readFileSync(file, "utf8");
+        const relativePath = path.relative(process.cwd(), file);
+        // Skip if file has preflight-ignore
+        if (content.includes("preflight-ignore:orphaned-table-filters"))
+            continue;
+        // Pattern 1: Find SearchInput components and check if they're in acceptable containers
+        const searchInputPattern = /<SearchInput[\s>]/g;
+        let match;
+        while ((match = searchInputPattern.exec(content)) !== null) {
+            const matchStart = match.index;
+            // Use large context window (10000 chars) to catch wrappers in complex files
+            const contextBefore = content.substring(Math.max(0, matchStart - 10000), matchStart);
+            // Check if inside any acceptable container by counting open vs close tags
+            const isInsideContainer = ACCEPTABLE_CONTAINER_PATTERNS.some(({ open, close }) => {
+                const openTags = (contextBefore.match(open) || []).length;
+                const closeTags = (contextBefore.match(close) || []).length;
+                return openTags > closeTags;
+            });
+            if (!isInsideContainer) {
+                const lineNum = content.substring(0, matchStart).split("\n").length;
+                // Avoid duplicate issues at same line
+                if (!issues.some(i => i.file === relativePath && i.line === lineNum)) {
+                    issues.push({
+                        file: relativePath,
+                        line: lineNum,
+                        type: "error",
+                        pattern: "orphaned-search-filter",
+                        message: "SearchInput filter is not contained within a Card component",
+                        snippet: match[0].substring(0, 60).replace(/\n/g, " ").trim(),
+                        suggestion: "Wrap filters and related table in a Card component",
+                    });
+                }
+            }
+        }
+        // Pattern 2: TableContainer/Table directly in layout without Card
+        const tablePattern = /<TableContainer[^>]*>[\s\S]*?<Table/g;
+        while ((match = tablePattern.exec(content)) !== null) {
+            const matchStart = match.index;
+            // Use large context window (10000 chars) to catch wrappers in complex files
+            const contextBefore = content.substring(Math.max(0, matchStart - 10000), matchStart);
+            // Check if inside any acceptable container by counting open vs close tags
+            const isInsideContainer = ACCEPTABLE_CONTAINER_PATTERNS.some(({ open, close }) => {
+                const openTags = (contextBefore.match(open) || []).length;
+                const closeTags = (contextBefore.match(close) || []).length;
+                return openTags > closeTags;
+            });
+            // Check if TableContainer has component={Card} or component={Paper}
+            const tableContainerLine = match[0].split("\n")[0];
+            const hasCardComponent = /component=\{(?:Card|Paper)\}/.test(tableContainerLine);
+            if (!isInsideContainer && !hasCardComponent) {
+                const lineNum = content.substring(0, matchStart).split("\n").length;
+                if (!issues.some(i => i.file === relativePath && i.line === lineNum)) {
+                    issues.push({
+                        file: relativePath,
+                        line: lineNum,
+                        type: "error",
+                        pattern: "orphaned-table",
+                        message: "Table is not contained within a Card component",
+                        snippet: tableContainerLine.substring(0, 60).trim(),
+                        suggestion: "Wrap table in a Card, or use <TableContainer component={Card}>",
+                    });
+                }
+            }
+        }
+        // Pattern 3: Table with headers always shown but empty state in body
+        // Look for patterns like: <TableHead>...</TableHead><TableBody>{...EmptyState...}</TableBody>
+        // without conditional rendering around the TableHead
+        const tableHeadPattern = /<TableHead>[\s\S]*?<\/TableHead>[\s\S]*?<TableBody>/g;
+        while ((match = tableHeadPattern.exec(content)) !== null) {
+            const matchStart = match.index;
+            // Look for what comes after TableBody opening
+            const afterTableBody = content.substring(matchStart + match[0].length, matchStart + match[0].length + 500);
+            // Check if there's an empty state that's conditionally rendered without hiding headers
+            // Pattern: orders.length === 0 ? <...EmptyState.../> (without conditional around TableHead)
+            const hasEmptyStateInBody = /\.length\s*===?\s*0\s*\?\s*[\s\S]*?(?:EmptyState|empty|no-)/i.test(afterTableBody);
+            if (hasEmptyStateInBody) {
+                // Check if there's a conditional that would hide the whole table
+                const contextBefore = content.substring(Math.max(0, matchStart - 300), matchStart);
+                const hasConditionalWrap = /\{\s*\([^)]*(?:loading|\.length)[^)]*\)\s*\?\s*\(?\s*</.test(contextBefore) ||
+                    /\{\s*(?:loading|[a-zA-Z]+\.length\s*>\s*0)[^}]*&&/.test(contextBefore);
+                if (!hasConditionalWrap) {
+                    const lineNum = content.substring(0, matchStart).split("\n").length;
+                    if (!issues.some(i => i.file === relativePath && i.line === lineNum && i.pattern === "empty-table-headers")) {
+                        issues.push({
+                            file: relativePath,
+                            line: lineNum,
+                            type: "warning",
+                            pattern: "empty-table-headers",
+                            message: "Table headers are shown even when table is empty",
+                            snippet: "<TableHead>...<TableBody>{empty state}",
+                            suggestion: "Hide table (including headers) when empty, show only EmptyState in Card",
+                        });
+                    }
+                }
+            }
+        }
+    }
+    // Print results
+    console.log((0, console_chars_1.createDivider)(70, "light"));
+    if (issues.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} No orphaned table/filter issues found!\n`);
+        process.exit(0);
+    }
+    const errors = issues.filter(i => i.type === "error");
+    const warnings = issues.filter(i => i.type === "warning");
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} ERRORS (${errors.length}):\n`);
+        const toShow = verbose ? errors : errors.slice(0, 10);
+        for (const issue of toShow) {
+            console.log(`  ${issue.file}:${issue.line}`);
+            console.log(`    ${issue.message}`);
+            console.log(`    ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+            if (verbose) {
+                console.log(`    Snippet: ${issue.snippet}`);
+            }
+            console.log();
+        }
+        if (!verbose && errors.length > 10) {
+            console.log(`  ... and ${errors.length - 10} more errors\n`);
+        }
+    }
+    if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning} WARNINGS (${warnings.length}):\n`);
+        const toShow = verbose ? warnings : warnings.slice(0, 5);
+        for (const issue of toShow) {
+            console.log(`  ${issue.file}:${issue.line}`);
+            console.log(`    ${issue.message}`);
+            console.log(`    ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+            console.log();
+        }
+        if (!verbose && warnings.length > 5) {
+            console.log(`  ... and ${warnings.length - 5} more warnings\n`);
+        }
+    }
+    console.log((0, console_chars_1.createDivider)(70, "light"));
+    console.log(`\n${console_chars_1.emoji.hint} Best practices for tables with filters:`);
+    console.log(`   <Card>`);
+    console.log(`     {(loading || data.length > 0) ? (`);
+    console.log(`       <>`);
+    console.log(`         <CardContent>  {/* Filters */}`);
+    console.log(`           <SearchInput ... />`);
+    console.log(`         </CardContent>`);
+    console.log(`         <TableContainer>`);
+    console.log(`           <Table>...</Table>`);
+    console.log(`         </TableContainer>`);
+    console.log(`       </>`);
+    console.log(`     ) : (`);
+    console.log(`       <CardContent>`);
+    console.log(`         <EmptyState />`);
+    console.log(`       </CardContent>`);
+    console.log(`     )}`);
+    console.log(`   </Card>\n`);
+    if (errors.length > 0 && !warnOnly) {
+        console.log(`${console_chars_1.emoji.error} Orphaned Table Filters check FAILED\n`);
+        process.exit(1);
+    }
+    console.log(`${console_chars_1.emoji.warning} Orphaned Table Filters check passed with warnings\n`);
+    process.exit(0);
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=orphaned-table-filters.js.map

package/dist/checks/ui/orphaned-table-filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphaned-table-filters.js","sourceRoot":"","sources":["../../../src/checks/ui/orphaned-table-filters.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CH,kBA+NC;AA3QD,uCAAyB;AACzB,2CAA6B;AAC7B,6DAAiE;AACjE,wDAAoD;AACpD,uFAAwF;AAExF,iBAAiB;AACJ,QAAA,EAAE,GAAG,2BAA2B,CAAC;AACjC,QAAA,IAAI,GAAG,wBAAwB,CAAC;AAChC,QAAA,QAAQ,GAAG,IAAI,CAAC;AAChB,QAAA,QAAQ,GAAG,IAAI,CAAC;AAChB,QAAA,WAAW,GAAG,qEAAqE,CAAC;AACpF,QAAA,IAAI,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;AAYpF,mCAAmC;AACnC,MAAM,iBAAiB,GAAG;IACxB,aAAa;IACb,mBAAmB;IACnB,mBAAmB;CACpB,CAAC;AAEF,oEAAoE;AACpE,MAAM,6BAA6B,GAAG;IACpC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE;IAC3C,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE;IAC/C,EAAE,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,mBAAmB,EAAE;IAC3D,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,EAAE;IAC/C,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE;IAC7C,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE;IAC7C,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,gBAAgB,EAAE;IACrD,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,EAAE;IAC7C,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,kBAAkB,EAAE;CAC1D,CAAC;AAEK,KAAK,UAAU,GAAG;IACvB,MAAM,QAAQ,GAAG,IAAA,6DAA+B,EAAC,YAAI,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAEjD,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,MAAM,gCAAgC,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC;IAC/G,OAAO,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtB,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,KAAK,iDAAiD,CAAC,CAAC;IAC/E,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,KAAK,4CAA4C,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,0DAA0D,CAAC,CAAC;IAC1F,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,iDAAiD,CAAC,CAAC;IAEjF,MAAM,KAAK,GAAG,MAAM,sBAAS,CAAC,SAAS,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,+CAA+C;QAC/C,MAAM,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAE1E,uCAAuC;QACvC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,aAAa,CAAC;YACvC,CAAC,cAAc,CAAC,QAAQ,CAAC,aAAa,CAAC;YACvC,CAAC,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YAC9C,SAAS;QACX,CAAC;QAED,qBAAqB;QACrB,IACE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACvB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACvB,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC1B,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YAChC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EACpC,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;QAExD,oCAAoC;QACpC,IAAI,OAAO,CAAC,QAAQ,CAAC,yCAAyC,CAAC;YAAE,SAAS;QAE1E,uFAAuF;QACvF,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;QAChD,IAAI,KAAK,CAAC;QAEV,OAAO,CAAC,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC3D,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;YAC/B,4EAA4E;YAC5E,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC;YAErF,0EAA0E;YAC1E,MAAM,iBAAiB,GAAG,6BAA6B,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC/E,MAAM,QAAQ,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBAC1D,MAAM,SAAS,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBAC5D,OAAO,QAAQ,GAAG,SAAS,CAAC;YAC9B,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACvB,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;gBAEpE,sCAAsC;gBACtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,CAAC;oBACrE,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,YAAY;wBAClB,IAAI,EAAE,OAAO;wBACb,IAAI,EAAE,OAAO;wBACb,OAAO,EAAE,wBAAwB;wBACjC,OAAO,EAAE,6DAA6D;wBACtE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE;wBAC7D,UAAU,EAAE,oDAAoD;qBACjE,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,kEAAkE;QAClE,MAAM,YAAY,GAAG,sCAAsC,CAAC;QAE5D,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACrD,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;YAC/B,4EAA4E;YAC5E,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC;YAErF,0EAA0E;YAC1E,MAAM,iBAAiB,GAAG,6BAA6B,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC/E,MAAM,QAAQ,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBAC1D,MAAM,SAAS,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBAC5D,OAAO,QAAQ,GAAG,SAAS,CAAC;YAC9B,CAAC,CAAC,CAAC;YAEH,oEAAoE;YACpE,MAAM,kBAAkB,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACnD,MAAM,gBAAgB,GAAG,8BAA8B,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAEjF,IAAI,CAAC,iBAAiB,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;gBAEpE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,CAAC;oBACrE,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,YAAY;wBAClB,IAAI,EAAE,OAAO;wBACb,IAAI,EAAE,OAAO;wBACb,OAAO,EAAE,gBAAgB;wBACzB,OAAO,EAAE,gDAAgD;wBACzD,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;wBACnD,UAAU,EAAE,gEAAgE;qBAC7E,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,qEAAqE;QACrE,8FAA8F;QAC9F,qDAAqD;QACrD,MAAM,gBAAgB,GAAG,sDAAsD,CAAC;QAEhF,OAAO,CAAC,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACzD,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;YAE/B,8CAA8C;YAC9C,MAAM,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;YAE3G,uFAAuF;YACvF,4FAA4F;YAC5F,MAAM,mBAAmB,GAAG,8DAA8D,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAEhH,IAAI,mBAAmB,EAAE,CAAC;gBACxB,iEAAiE;gBACjE,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;gBACnF,MAAM,kBAAkB,GAAG,wDAAwD,CAAC,IAAI,CAAC,aAAa,CAAC;oBAC5E,mDAAmD,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;gBAEnG,IAAI,CAAC,kBAAkB,EAAE,CAAC;oBACxB,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;oBAEpE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,OAAO,KAAK,qBAAqB,CAAC,EAAE,CAAC;wBAC5G,MAAM,CAAC,IAAI,CAAC;4BACV,IAAI,EAAE,YAAY;4BAClB,IAAI,EAAE,OAAO;4BACb,IAAI,EAAE,SAAS;4BACf,OAAO,EAAE,qBAAqB;4BAC9B,OAAO,EAAE,kDAAkD;4BAC3D,OAAO,EAAE,wCAAwC;4BACjD,UAAU,EAAE,yEAAyE;yBACtF,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAExC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,2CAA2C,CAAC,CAAC;QAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAE1D,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,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,OAAO,qBAAK,CAAC,IAAI,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YACrD,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/C,CAAC;YACD,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,MAAM,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAC/D,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,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,OAAO,qBAAK,CAAC,IAAI,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YACrD,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,aAAa,QAAQ,CAAC,MAAM,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,IAAI,0CAA0C,CAAC,CAAC;IACvE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACzB,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACzB,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAE5B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,KAAK,wCAAwC,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,OAAO,sDAAsD,CAAC,CAAC;IACpF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAGD,yBAAyB;AACzB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/dist/checks/ui/overflow-clipping-detection.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env tsx
+/**
+ * Overflow Clipping Detection Preflight
+ *
+ * Detects dangerous patterns where overflow-hidden on parent elements
+ * can clip absolutely/fixed positioned children (dropdowns, modals, tooltips).
+ *
+ * This catches bugs like the mega menu dropdown being invisible because
+ * a parent had overflow-hidden.
+ */
+export declare const id = "ui/overflow-clipping-detection";
+export declare const name = "Overflow Clipping Detection";
+export declare const category = "ui";
+export declare const blocking = true;
+export declare const description = "Overflow Clipping Detection Preflight";
+export declare const tags: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=overflow-clipping-detection.d.ts.map

package/dist/checks/ui/overflow-clipping-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overflow-clipping-detection.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/overflow-clipping-detection.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AASH,eAAO,MAAM,EAAE,mCAAmC,CAAC;AACnD,eAAO,MAAM,IAAI,gCAAgC,CAAC;AAClD,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,0CAA0C,CAAC;AACnE,eAAO,MAAM,IAAI,UAAS,CAAC;AA2H3B,wBAAsB,GAAG,kBAoDxB"}

package/dist/checks/ui/overflow-clipping-detection.js

@@ -0,0 +1,201 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Overflow Clipping Detection Preflight
+ *
+ * Detects dangerous patterns where overflow-hidden on parent elements
+ * can clip absolutely/fixed positioned children (dropdowns, modals, tooltips).
+ *
+ * This catches bugs like the mega menu dropdown being invisible because
+ * a parent had overflow-hidden.
+ */
+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;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "ui/overflow-clipping-detection";
+exports.name = "Overflow Clipping Detection";
+exports.category = "ui";
+exports.blocking = true;
+exports.description = "Overflow Clipping Detection Preflight";
+exports.tags = ["ui"];
+const findings = [];
+// Patterns that indicate overflow clipping risk
+const OVERFLOW_PATTERNS = [
+    /overflow-hidden/,
+    /overflow:\s*hidden/,
+    /overflow-x-hidden/,
+    /overflow-y-hidden/,
+];
+// Patterns that indicate positioned children
+const POSITIONED_CHILD_PATTERNS = [
+    /position:\s*(absolute|fixed)/,
+    /absolute/, // Tailwind class
+    /fixed/, // Tailwind class
+];
+// Components known to have dropdowns/positioned content
+const DROPDOWN_COMPONENTS = [
+    "MegaMenu",
+    "Dropdown",
+    "Popover",
+    "Modal",
+    "Dialog",
+    "Tooltip",
+    "Menu",
+    "Select",
+    "Autocomplete",
+    "Combobox",
+];
+function scanFile(filePath) {
+    const content = fs.readFileSync(filePath, "utf-8");
+    const lines = content.split("\n");
+    const relativePath = path.relative(process.cwd(), filePath);
+    // Check for overflow-hidden in files that render dropdown components
+    const hasDropdownComponent = DROPDOWN_COMPONENTS.some((comp) => content.includes(`<${comp}`) || content.includes(`${comp}>`));
+    lines.forEach((line, idx) => {
+        const lineNum = idx + 1;
+        // Check for overflow-hidden patterns
+        for (const pattern of OVERFLOW_PATTERNS) {
+            if (pattern.test(line)) {
+                // Check if this is in a container that might have positioned children
+                const surroundingLines = lines
+                    .slice(Math.max(0, idx - 10), Math.min(lines.length, idx + 10))
+                    .join("\n");
+                const hasPositionedChild = POSITIONED_CHILD_PATTERNS.some((p) => p.test(surroundingLines));
+                if (hasPositionedChild || hasDropdownComponent) {
+                    findings.push({
+                        file: relativePath,
+                        line: lineNum,
+                        message: `overflow-hidden may clip positioned children (dropdowns, modals). Consider using overflow-visible or moving overflow-hidden to a more specific container.`,
+                        severity: "warning",
+                        code: "OVERFLOW_CLIP_RISK",
+                    });
+                }
+            }
+        }
+        // Specific check: overflow-hidden on nav elements (high risk)
+        if (/overflow-hidden/.test(line) && /<nav/.test(content)) {
+            const isInNav = lines.slice(Math.max(0, idx - 5), idx + 1).some((l) => /<nav/.test(l));
+            if (isInNav) {
+                findings.push({
+                    file: relativePath,
+                    line: lineNum,
+                    message: `overflow-hidden on <nav> element will clip dropdown menus. This is almost always a bug.`,
+                    severity: "error",
+                    code: "NAV_OVERFLOW_HIDDEN",
+                });
+            }
+        }
+        // Check for conditional overflow that might cause issues
+        if (/overflow-hidden.*\?|isScrolled.*overflow|scrolled.*overflow/i.test(line)) {
+            // This is actually the fix pattern - conditional overflow is good
+            // But warn if it's always-on overflow near scroll detection
+        }
+    });
+}
+function getComponentFiles() {
+    const files = [];
+    const scanDir = (dir) => {
+        if (!fs.existsSync(dir))
+            return;
+        if (dir.includes("node_modules") || dir.includes(".next"))
+            return;
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                scanDir(fullPath);
+            }
+            else if (/\.(tsx|jsx)$/.test(entry.name)) {
+                files.push(fullPath);
+            }
+        }
+    };
+    scanDir("components");
+    scanDir("app");
+    scanDir("packages/ui/src");
+    return files;
+}
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    console.log(`${console_chars_1.emoji.search} Checking for overflow clipping risks...\n`);
+    const files = getComponentFiles();
+    for (const file of files) {
+        scanFile(file);
+    }
+    // Deduplicate findings by file+line
+    const uniqueFindings = findings.filter((f, i, arr) => arr.findIndex((x) => x.file === f.file && x.line === f.line) === i);
+    const errors = uniqueFindings.filter((f) => f.severity === "error");
+    const warnings = uniqueFindings.filter((f) => f.severity === "warning");
+    if (errors.length > 0) {
+        console.log(`${console_chars_1.emoji.error} Errors (blocking):`);
+        for (const f of errors) {
+            console.log(`  ${f.file}:${f.line} - ${f.message}`);
+        }
+        console.log("");
+    }
+    if (warnings.length > 0) {
+        console.log(`${console_chars_1.emoji.warning}  Warnings:`);
+        for (const f of warnings.slice(0, 10)) {
+            console.log(`  ${f.file}:${f.line} - ${f.message}`);
+        }
+        if (warnings.length > 10) {
+            console.log(`  ... and ${warnings.length - 10} more warnings`);
+        }
+        console.log("");
+    }
+    // Write findings for SARIF integration
+    const findingsPath = process.env.PREFLIGHT_FINDINGS_PATH;
+    if (findingsPath) {
+        fs.writeFileSync(findingsPath, JSON.stringify(uniqueFindings, null, 2));
+    }
+    console.log(`${console_chars_1.emoji.chart} Scanned ${files.length} files`);
+    console.log(`   Errors: ${errors.length}`);
+    console.log(`   Warnings: ${warnings.length}`);
+    if (errors.length > 0) {
+        process.exit(1);
+    }
+    console.log(`\n${console_chars_1.emoji.success} No critical overflow clipping issues found`);
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=overflow-clipping-detection.js.map

package/dist/checks/ui/overflow-clipping-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overflow-clipping-detection.js","sourceRoot":"","sources":["../../../src/checks/ui/overflow-clipping-detection.ts"],"names":[],"mappings":";;AACA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyIH,kBAoDC;AA3LD,uCAAyB;AACzB,2CAA6B;AAC7B,6DAAkD;AAClD,uFAAwF;AAGxF,iBAAiB;AACJ,QAAA,EAAE,GAAG,gCAAgC,CAAC;AACtC,QAAA,IAAI,GAAG,6BAA6B,CAAC;AACrC,QAAA,QAAQ,GAAG,IAAI,CAAC;AAChB,QAAA,QAAQ,GAAG,IAAI,CAAC;AAChB,QAAA,WAAW,GAAG,uCAAuC,CAAC;AACtD,QAAA,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;AAU3B,MAAM,QAAQ,GAAc,EAAE,CAAC;AAE/B,gDAAgD;AAChD,MAAM,iBAAiB,GAAG;IACxB,iBAAiB;IACjB,oBAAoB;IACpB,mBAAmB;IACnB,mBAAmB;CACpB,CAAC;AAEF,6CAA6C;AAC7C,MAAM,yBAAyB,GAAG;IAChC,8BAA8B;IAC9B,UAAU,EAAE,iBAAiB;IAC7B,OAAO,EAAE,iBAAiB;CAC3B,CAAC;AAEF,wDAAwD;AACxD,MAAM,mBAAmB,GAAG;IAC1B,UAAU;IACV,UAAU;IACV,SAAS;IACT,OAAO;IACP,QAAQ;IACR,SAAS;IACT,MAAM;IACN,QAAQ;IACR,cAAc;IACd,UAAU;CACX,CAAC;AAEF,SAAS,QAAQ,CAAC,QAAgB;IAChC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAE5D,qEAAqE;IACrE,MAAM,oBAAoB,GAAG,mBAAmB,CAAC,IAAI,CACnD,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,GAAG,CAAC,CACvE,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC1B,MAAM,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC;QAExB,qCAAqC;QACrC,KAAK,MAAM,OAAO,IAAI,iBAAiB,EAAE,CAAC;YACxC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvB,sEAAsE;gBACtE,MAAM,gBAAgB,GAAG,KAAK;qBAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;qBAC9D,IAAI,CAAC,IAAI,CAAC,CAAC;gBAEd,MAAM,kBAAkB,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;gBAE3F,IAAI,kBAAkB,IAAI,oBAAoB,EAAE,CAAC;oBAC/C,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,YAAY;wBAClB,IAAI,EAAE,OAAO;wBACb,OAAO,EAAE,2JAA2J;wBACpK,QAAQ,EAAE,SAAS;wBACnB,IAAI,EAAE,oBAAoB;qBAC3B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,8DAA8D;QAC9D,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACzD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACvF,IAAI,OAAO,EAAE,CAAC;gBACZ,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,YAAY;oBAClB,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,yFAAyF;oBAClG,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,qBAAqB;iBAC5B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,yDAAyD;QACzD,IAAI,8DAA8D,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9E,kEAAkE;YAClE,4DAA4D;QAC9D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB;IACxB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,EAAE;QAC9B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO;QAChC,IAAI,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO;QAElE,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,OAAO,CAAC,QAAQ,CAAC,CAAC;YACpB,CAAC;iBAAM,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3C,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CAAC,YAAY,CAAC,CAAC;IACtB,OAAO,CAAC,KAAK,CAAC,CAAC;IACf,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE3B,OAAO,KAAK,CAAC;AACf,CAAC;AAEM,KAAK,UAAU,GAAG;IACvB,MAAM,QAAQ,GAAG,IAAA,6DAA+B,EAAC,YAAI,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,MAAM,4CAA4C,CAAC,CAAC;IAEzE,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IAED,oCAAoC;IACpC,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CACpC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAClF,CAAC;IAEF,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IAExE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,KAAK,qBAAqB,CAAC,CAAC;QACjD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,OAAO,aAAa,CAAC,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,aAAa,QAAQ,CAAC,MAAM,GAAG,EAAE,gBAAgB,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAED,uCAAuC;IACvC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IACzD,IAAI,YAAY,EAAE,CAAC;QACjB,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,KAAK,YAAY,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,gBAAgB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAE/C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,6CAA6C,CAAC,CAAC;AAC/E,CAAC;AAGD,yBAAyB;AACzB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/dist/checks/ui/page-layout-spacing.d.ts

@@ -0,0 +1,30 @@
+#!/usr/bin/env tsx
+/**
+ * Page Layout Spacing Preflight - IRON-CLAD ENFORCEMENT
+ *
+ * Enforces consistent spacing in the layout chain:
+ *
+ * LAYOUT CHAIN:
+ *   NavigationHeader → Breadcrumbs (py-2) → Flex Container → Main Content (gap-3 pt-3 px-3) → PageHeader (mb-0)
+ *
+ * SPACING STANDARDS:
+ *   - Breadcrumbs: paddingTop/Bottom = var(--spacing-2) = 8px
+ *   - Main content Box: gap = var(--spacing-3), paddingTop = var(--spacing-3), paddingX = var(--spacing-3)
+ *   - CRITICAL: paddingTop MUST equal gap for visual consistency above the header
+ *   - PageHeader: marginTop = 0, marginBottom = 0 (gap handles spacing between siblings)
+ *   - Child components: NO margin classes (gap handles all vertical spacing)
+ *
+ * CRITICAL RULE: When a container uses gap for spacing, children must NOT have margin.
+ * Adding margin on top of gap creates doubled/inconsistent spacing.
+ *
+ * Usage:
+ *   pnpm preflight:page-layout-spacing
+ */
+export declare const id = "ui/page-layout-spacing";
+export declare const name = "Page Layout Spacing";
+export declare const category = "ui";
+export declare const blocking = false;
+export declare const description = "Page Layout Spacing Preflight - IRON-CLAD ENFORCEMENT";
+export declare const tags: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=page-layout-spacing.d.ts.map

package/dist/checks/ui/page-layout-spacing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-layout-spacing.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/page-layout-spacing.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AAUH,eAAO,MAAM,EAAE,2BAA2B,CAAC;AAC3C,eAAO,MAAM,IAAI,wBAAwB,CAAC;AAC1C,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,0DAA0D,CAAC;AACnF,eAAO,MAAM,IAAI,UAAS,CAAC;AAikB3B,wBAAsB,GAAG,kBAiExB"}