@empline/preflight 1.0.20

package/dist/checks/ui/sibling-spacing-check.js

@@ -0,0 +1,329 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Sibling Spacing Check Preflight
+ *
+ * Detects containers with multiple Card/content children that lack proper gap spacing.
+ * This catches the common issue of sibling elements touching without visual separation.
+ *
+ * PATTERNS DETECTED:
+ * - Flex/grid containers with Card children but no gap
+ * - Box/div with multiple Card siblings without gap-3
+ * - Stack components without spacing prop
+ * - CardContent with p-0 (no internal padding)
+ * - CardContent without any padding class
+ *
+ * Usage:
+ *   pnpm preflight:sibling-spacing
+ *   pnpm preflight:sibling-spacing --verbose
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+const fs = __importStar(require("fs"));
+const console_chars_1 = require("../../utils/console-chars");
+const file_cache_1 = require("../../shared/file-cache");
+const glob_patterns_1 = require("../../shared/glob-patterns");
+// Check metadata
+exports.id = "ui/sibling-spacing-check";
+exports.name = "Sibling Spacing Check";
+exports.category = "ui";
+exports.blocking = false;
+exports.description = "Sibling Spacing Check Preflight";
+exports.tags = ["ui"];
+const EXCLUDED = (0, glob_patterns_1.extendExcludes)(glob_patterns_1.STANDARD_EXCLUDES_WITH_TESTS, [
+    "**/scripts/**",
+    "**/packages/ui/**",
+]);
+// CACHED FILE LISTS - Scan once, use everywhere
+let _cachedAllTsxFiles = null;
+async function getAllTsxFiles() {
+    if (!_cachedAllTsxFiles) {
+        _cachedAllTsxFiles = await file_cache_1.fileCache.getAllTsx();
+    }
+    return _cachedAllTsxFiles;
+}
+async function checkSiblingSpacing() {
+    const verbose = process.argv.includes("--verbose");
+    console.log("\n📐 Sibling Spacing Check Preflight\n");
+    console.log("Detects containers with sibling elements lacking proper gap spacing.\n");
+    const files = await getAllTsxFiles();
+    const issues = [];
+    for (const file of files) {
+        const content = fs.readFileSync(file, "utf8");
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const lineNum = i + 1;
+            // Skip comments
+            const trimmed = line.trim();
+            if (trimmed.startsWith("//") || trimmed.startsWith("/*") || trimmed.startsWith("*"))
+                continue;
+            // Check for preflight-ignore on current line or previous line
+            const prevLine = i > 0 ? lines[i - 1] : "";
+            if (line.includes("preflight-ignore") || prevLine.includes("preflight-ignore"))
+                continue;
+            // Pattern 1: Box/div with flex-col but no gap
+            // Look for: <Box className="... flex flex-col ..." without gap-
+            if (line.match(/<(Box|div)\s+className="[^"]*flex[^"]*flex-col[^"]*"/) &&
+                !line.includes("gap-") &&
+                !line.includes("gap:")) {
+                // Check if next few lines have multiple Card children
+                const nextLines = lines.slice(i, Math.min(i + 20, lines.length)).join("\n");
+                const cardCount = (nextLines.match(/<Card/g) || []).length;
+                if (cardCount >= 2) {
+                    issues.push({
+                        file,
+                        line: lineNum,
+                        type: "warning",
+                        message: "Flex column container with multiple Cards but no gap spacing",
+                        context: line.trim().substring(0, 80),
+                    });
+                }
+            }
+            // Pattern 2: Box with display: flex, flexDirection: column but no gap
+            if (line.match(/<(Box|div)/) && !line.includes("gap-") && !line.includes("gap:")) {
+                const nextLines = lines.slice(i, Math.min(i + 10, lines.length)).join("\n");
+                if (nextLines.includes('flexDirection: "column"') ||
+                    nextLines.includes("flexDirection: 'column'")) {
+                    // Check for multiple Card children
+                    const extendedContext = lines.slice(i, Math.min(i + 30, lines.length)).join("\n");
+                    const cardCount = (extendedContext.match(/<Card/g) || []).length;
+                    if (cardCount >= 2 && !nextLines.includes("gap:") && !nextLines.includes("gap-")) {
+                        issues.push({
+                            file,
+                            line: lineNum,
+                            type: "warning",
+                            message: "Flex column container (style) with multiple Cards but no gap",
+                            context: line.trim().substring(0, 80),
+                        });
+                    }
+                }
+            }
+            // Pattern 3: Stack without spacing prop
+            // EXCEPTIONS:
+            // - Stack with gap-X in className OR gap={X} prop is valid
+            // - Stack with justifyContent="space-between" doesn't need spacing (items are pushed apart)
+            // - Stack with spacing on next line (multi-line JSX)
+            if (line.match(/<Stack(?!\s+spacing)/) &&
+                !line.includes("spacing=") &&
+                !line.includes("spacing={")) {
+                // Check if it has gap in className or as prop (valid alternatives to spacing prop)
+                const hasGapClass = line.match(/className="[^"]*gap-[0-9]/);
+                const hasGapProp = line.includes("gap={") || line.includes("gap=");
+                const hasSpaceBetween = line.includes('justifyContent="space-between"') ||
+                    line.includes("justifyContent='space-between'") ||
+                    line.includes("justify-between");
+                // Check next few lines for spacing prop (multi-line JSX)
+                const nextLines = lines.slice(i, Math.min(i + 5, lines.length)).join("\n");
+                const hasSpacingOnNextLines = nextLines.includes("spacing={") || nextLines.includes("spacing=");
+                if (!hasGapClass && !hasGapProp && !hasSpaceBetween && !hasSpacingOnNextLines) {
+                    // Check if it has children
+                    if (nextLines.includes("</Stack>")) {
+                        issues.push({
+                            file,
+                            line: lineNum,
+                            type: "warning",
+                            message: "Stack component without spacing prop - add spacing={X} or gap-X class",
+                            context: line.trim().substring(0, 80),
+                        });
+                    }
+                }
+            }
+            // Pattern 4: Grid container without gap
+            if (line.match(/<(Box|div)\s+className="[^"]*grid[^"]*"/) &&
+                !line.includes("gap-") &&
+                !line.includes("gap:")) {
+                // Check next few lines for gap in style prop
+                const nextLines = lines.slice(i, Math.min(i + 5, lines.length)).join("\n");
+                const hasGapInStyle = nextLines.includes("gap:") || nextLines.includes("gap =");
+                if (!hasGapInStyle) {
+                    issues.push({
+                        file,
+                        line: lineNum,
+                        type: "warning",
+                        message: "Grid container without gap spacing",
+                        context: line.trim().substring(0, 80),
+                    });
+                }
+            }
+            // Pattern 5: CardContent with p-0 (removes all internal padding)
+            // This causes content to touch card edges - bad UX
+            // EXCEPTIONS:
+            // - Content has its own padding (common pattern for empty states)
+            // - Content is a table/list (tables have their own cell padding)
+            if (line.match(/<CardContent[^>]*className="[^"]*\bp-0\b/)) {
+                // Check if it's not followed by specific padding classes that override p-0
+                if (!line.match(/p-0[^"]*p-[1-9]/) &&
+                    !line.match(/p-0[^"]*px-/) &&
+                    !line.match(/p-0[^"]*py-/)) {
+                    // Check if this is wrapping content with its own padding (common pattern)
+                    const nextLines = lines.slice(i, Math.min(i + 10, lines.length)).join("\n");
+                    const hasInternalPadding = nextLines.includes("paddingTop:") ||
+                        nextLines.includes("paddingBottom:") ||
+                        nextLines.includes("padding:") ||
+                        nextLines.includes("containerPy") ||
+                        nextLines.includes("containerPx");
+                    // Check if wrapping a table or list (valid p-0 use case)
+                    const wrapsTable = nextLines.includes("<Table") ||
+                        nextLines.includes("<TableContainer") ||
+                        nextLines.includes("TableHead") ||
+                        nextLines.includes("<List");
+                    // Check if wrapping items with their own padding
+                    const wrapsItemsWithPadding = nextLines.match(/padding:\s*SPACING/) ||
+                        nextLines.match(/padding:\s*var\(--spacing/) ||
+                        nextLines.includes("NotificationSection") ||
+                        nextLines.includes("NotificationTableHeader");
+                    if (!hasInternalPadding && !wrapsTable && !wrapsItemsWithPadding) {
+                        issues.push({
+                            file,
+                            line: lineNum,
+                            type: "warning",
+                            message: "CardContent with p-0 removes internal padding - content touches card edges",
+                            context: line.trim().substring(0, 80),
+                        });
+                    }
+                }
+            }
+            // Pattern 6: CardContent without any padding specification
+            // Should have p-3, p-4, or specific padding classes
+            if (line.match(/<CardContent/) && !line.includes("preflight-ignore")) {
+                const hasClassName = line.includes("className=");
+                const hasPadding = line.match(/\bp-[0-9]/) ||
+                    line.match(/\bpx-[0-9]/) ||
+                    line.match(/\bpy-[0-9]/) ||
+                    line.match(/\bpt-[0-9]/) ||
+                    line.match(/\bpb-[0-9]/) ||
+                    line.match(/\bpl-[0-9]/) ||
+                    line.match(/\bpr-[0-9]/) ||
+                    line.includes("padding:") ||
+                    line.includes("padding=");
+                // Check next line too for multi-line JSX
+                const nextLine = lines[i + 1] || "";
+                const nextHasPadding = nextLine.match(/\bp-[0-9]/) ||
+                    nextLine.match(/\bpx-[0-9]/) ||
+                    nextLine.match(/\bpy-[0-9]/) ||
+                    nextLine.includes("padding:");
+                if (!hasPadding && !nextHasPadding && !line.includes(">")) {
+                    // Multi-line tag, check if padding is on subsequent lines
+                    const tagContent = lines.slice(i, Math.min(i + 5, lines.length)).join("\n");
+                    const tagHasPadding = tagContent.match(/\bp-[0-9]/) ||
+                        tagContent.match(/\bpx-[0-9]/) ||
+                        tagContent.match(/\bpy-[0-9]/) ||
+                        tagContent.includes("padding:");
+                    if (!tagHasPadding) {
+                        issues.push({
+                            file,
+                            line: lineNum,
+                            type: "warning",
+                            message: "CardContent without padding class - use p-3 or p-4 for consistent internal spacing",
+                            context: line.trim().substring(0, 80),
+                        });
+                    }
+                }
+                else if (!hasPadding && !nextHasPadding && line.includes(">") && hasClassName) {
+                    // Single line with className but no padding
+                    issues.push({
+                        file,
+                        line: lineNum,
+                        type: "warning",
+                        message: "CardContent without padding class - use p-3 or p-4 for consistent internal spacing",
+                        context: line.trim().substring(0, 80),
+                    });
+                }
+            }
+        }
+    }
+    // Report
+    console.log((0, console_chars_1.createDivider)(60, "light"));
+    if (issues.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} No sibling spacing issues found!\n`);
+        return;
+    }
+    const errors = issues.filter((i) => i.type === "error");
+    const warnings = issues.filter((i) => i.type === "warning");
+    if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning}  WARNINGS (${warnings.length}):\n`);
+        if (verbose) {
+            warnings.forEach((w) => {
+                console.log(`  ${w.file}:${w.line}`);
+                console.log(`    ${w.message}`);
+                console.log(`    ${w.context}...`);
+                console.log("");
+            });
+        }
+        else {
+            // Group by file
+            const byFile = new Map();
+            warnings.forEach((w) => {
+                if (!byFile.has(w.file))
+                    byFile.set(w.file, []);
+                byFile.get(w.file).push(w);
+            });
+            let shown = 0;
+            for (const [file, fileIssues] of byFile) {
+                if (shown >= 20) {
+                    console.log(`  ... and ${warnings.length - shown} more warnings`);
+                    break;
+                }
+                console.log(`  ${file}:`);
+                fileIssues.slice(0, 3).forEach((w) => {
+                    console.log(`    L${w.line}: ${w.message}`);
+                    shown++;
+                });
+                if (fileIssues.length > 3) {
+                    console.log(`    ... and ${fileIssues.length - 3} more in this file`);
+                    shown += fileIssues.length - 3;
+                }
+            }
+        }
+    }
+    console.log(`\n${console_chars_1.box.horizontal}`.repeat(60));
+    console.log(`\n${console_chars_1.emoji.chart} Summary:`);
+    console.log(`  Errors: ${errors.length}`);
+    console.log(`  Warnings: ${warnings.length}`);
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} Sibling spacing check FAILED\n`);
+        process.exit(1);
+    }
+    else {
+        console.log(`\n${console_chars_1.emoji.success} Sibling spacing check passed (warnings only)\n`);
+    }
+}
+checkSiblingSpacing().catch((err) => {
+    console.error("Error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=sibling-spacing-check.js.map

package/dist/checks/ui/sibling-spacing-check.js.map

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

package/dist/checks/ui/sidebar-layout-gap.d.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env tsx
+/**
+ * Sidebar Layout Gap Preflight - IRON-CLAD ENFORCEMENT
+ *
+ * Ensures sidebar layouts don't have unwanted gaps above the sidebar.
+ *
+ * RULE: When a page uses a sidebar layout (flex container with sidebar + main content),
+ * the outer flex container should NOT have paddingTop. The sidebar should start
+ * flush with the bottom of the breadcrumbs.
+ *
+ * CORRECT PATTERN:
+ *   <UnifiedBreadcrumbs />
+ *   <div style={{ display: "flex", flex: "1" }}>  ← NO paddingTop
+ *     <div className="sidebar">...</div>
+ *     <div className="main-content pt-3 px-3">...</div>  ← Main content has its own padding
+ *   </div>
+ *
+ * WRONG PATTERN:
+ *   <UnifiedBreadcrumbs />
+ *   <div style={{ display: "flex", flex: "1", paddingTop: "var(--spacing-3)" }}>  ← BAD!
+ *     <div className="sidebar">...</div>  ← Gap appears above sidebar
+ *     ...
+ *   </div>
+ *
+ * Usage:
+ *   pnpm preflight:sidebar-layout-gap
+ */
+export declare const id = "ui/sidebar-layout-gap";
+export declare const name = "Sidebar Layout Gap";
+export declare const category = "ui";
+export declare const blocking = false;
+export declare const description = "Sidebar Layout Gap Preflight - IRON-CLAD ENFORCEMENT";
+export declare const tags: string[];
+//# sourceMappingURL=sidebar-layout-gap.d.ts.map

package/dist/checks/ui/sidebar-layout-gap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-layout-gap.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/sidebar-layout-gap.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AASH,eAAO,MAAM,EAAE,0BAA0B,CAAC;AAC1C,eAAO,MAAM,IAAI,uBAAuB,CAAC;AACzC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,yDAAyD,CAAC;AAClF,eAAO,MAAM,IAAI,UAAS,CAAC"}

package/dist/checks/ui/sidebar-layout-gap.js

@@ -0,0 +1,200 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Sidebar Layout Gap Preflight - IRON-CLAD ENFORCEMENT
+ *
+ * Ensures sidebar layouts don't have unwanted gaps above the sidebar.
+ *
+ * RULE: When a page uses a sidebar layout (flex container with sidebar + main content),
+ * the outer flex container should NOT have paddingTop. The sidebar should start
+ * flush with the bottom of the breadcrumbs.
+ *
+ * CORRECT PATTERN:
+ *   <UnifiedBreadcrumbs />
+ *   <div style={{ display: "flex", flex: "1" }}>  ← NO paddingTop
+ *     <div className="sidebar">...</div>
+ *     <div className="main-content pt-3 px-3">...</div>  ← Main content has its own padding
+ *   </div>
+ *
+ * WRONG PATTERN:
+ *   <UnifiedBreadcrumbs />
+ *   <div style={{ display: "flex", flex: "1", paddingTop: "var(--spacing-3)" }}>  ← BAD!
+ *     <div className="sidebar">...</div>  ← Gap appears above sidebar
+ *     ...
+ *   </div>
+ *
+ * Usage:
+ *   pnpm preflight:sidebar-layout-gap
+ */
+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/sidebar-layout-gap";
+exports.name = "Sidebar Layout Gap";
+exports.category = "ui";
+exports.blocking = false;
+exports.description = "Sidebar Layout Gap Preflight - IRON-CLAD ENFORCEMENT";
+exports.tags = ["ui"];
+const EXCLUDED = [...glob_patterns_1.STANDARD_EXCLUDES];
+// Patterns that indicate a sidebar layout
+const SIDEBAR_LAYOUT_INDICATORS = [
+    "SIDEBAR_WIDTH",
+    "sidebarWidth",
+    "CategoryFilterRenderer",
+    "FilterSidebar",
+    "AdminSidebar",
+    "DashboardSidebar",
+];
+async function checkSidebarLayoutGaps() {
+    const issues = [];
+    // Find all client components
+    const files = await (0, glob_1.glob)("{app,components}/**/*Client.tsx", { ignore: EXCLUDED });
+    for (const file of files) {
+        const content = fs.readFileSync(file, "utf8");
+        const lines = content.split("\n");
+        // Check if this file uses a sidebar layout
+        const hasSidebarIndicator = SIDEBAR_LAYOUT_INDICATORS.some((indicator) => content.includes(indicator));
+        if (!hasSidebarIndicator) {
+            continue;
+        }
+        // Skip files without breadcrumbs (different layout pattern)
+        if (!content.includes("UnifiedBreadcrumbs")) {
+            continue;
+        }
+        let breadcrumbLine = -1;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Track breadcrumb location
+            if (line.includes("<UnifiedBreadcrumbs") && !line.includes("noPadding")) {
+                breadcrumbLine = i;
+            }
+            // Check containers after breadcrumbs (within 15 lines)
+            if (breadcrumbLine !== -1 && i > breadcrumbLine && i <= breadcrumbLine + 15) {
+                // Look for flex containers with paddingTop in style prop
+                if (/<div|<Box/.test(line)) {
+                    // Check this line and next few lines for the style prop
+                    const contextLines = lines.slice(i, Math.min(i + 5, lines.length)).join("\n");
+                    // Check if this is a flex container
+                    const isFlexContainer = /display:\s*["']flex["']/.test(contextLines) || /\bflex\b/.test(contextLines);
+                    if (isFlexContainer) {
+                        // Check for paddingTop in style prop - this is the bug!
+                        const paddingTopMatch = contextLines.match(/paddingTop:\s*["']var\(--spacing-(\d+)\)["']/);
+                        if (paddingTopMatch) {
+                            issues.push({
+                                file,
+                                line: i + 1,
+                                type: "sidebar-layout-has-padding-top",
+                                severity: "error",
+                                message: `Sidebar layout flex container has paddingTop: var(--spacing-${paddingTopMatch[1]}) - creates gap above sidebar`,
+                                suggestion: `Remove paddingTop from the outer flex container. The sidebar should start flush with breadcrumbs. Main content area should have its own pt-3 padding.`,
+                                snippet: line.trim().substring(0, 120),
+                            });
+                        }
+                        // Also check for pt-X class on flex container
+                        const ptClassMatch = contextLines.match(/\bpt-(\d+)\b/);
+                        if (ptClassMatch && parseInt(ptClassMatch[1]) > 0) {
+                            // Check if this is the outer flex container (has flex-1 or similar)
+                            const isOuterFlex = /flex-1|flex:\s*["']1["']|flex:\s*1/.test(contextLines);
+                            if (isOuterFlex) {
+                                issues.push({
+                                    file,
+                                    line: i + 1,
+                                    type: "sidebar-layout-has-pt-class",
+                                    severity: "error",
+                                    message: `Sidebar layout flex container has pt-${ptClassMatch[1]} class - creates gap above sidebar`,
+                                    suggestion: `Remove pt-${ptClassMatch[1]} from the outer flex container. The sidebar should start flush with breadcrumbs.`,
+                                    snippet: line.trim().substring(0, 120),
+                                });
+                            }
+                        }
+                        // Found the flex container, stop checking for this breadcrumb
+                        breadcrumbLine = -1;
+                    }
+                }
+            }
+        }
+    }
+    return issues;
+}
+async function main() {
+    console.log("\n📐 SIDEBAR LAYOUT GAP PREFLIGHT");
+    console.log((0, console_chars_1.createDivider)(70, "double"));
+    console.log("Rule: Sidebar layouts must NOT have paddingTop on outer flex container");
+    console.log("      Sidebar should start flush with breadcrumbs");
+    console.log((0, console_chars_1.createDivider)(70, "double"));
+    const issues = await checkSidebarLayoutGaps();
+    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 sidebar layouts have correct spacing!`);
+        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((0, console_chars_1.createDivider)(70, "double"));
+    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=sidebar-layout-gap.js.map

package/dist/checks/ui/sidebar-layout-gap.js.map

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

package/dist/checks/ui/skeleton-size-consistency.d.ts

@@ -0,0 +1,50 @@
+#!/usr/bin/env tsx
+/**
+ * Skeleton Size Consistency Preflight Check (Enhanced)
+ *
+ * Comprehensive validation that skeleton components match their corresponding
+ * real components to prevent Cumulative Layout Shift (CLS) during loading.
+ *
+ * BLOCKING: No (warning only - helps catch CLS issues before they ship)
+ *
+ * Run: pnpm preflight:skeleton-size
+ *
+ * Checks:
+ * 1. KNOWN MAPPINGS - Validates skeleton heights against expected component heights
+ * 2. STRUCTURAL MAPPINGS - Validates skeleton elements match component structure
+ *    - Detects missing placeholders for component elements
+ *    - Detects stale placeholders for removed elements
+ *    - Compares action button counts between skeleton and component
+ * 3. AUTO-DISCOVERY - Finds skeleton/component pairs by naming convention
+ * 4. RESPONSIVE ANALYSIS - Compares mobile vs desktop height definitions
+ * 5. STRUCTURE MATCHING - Validates loading.tsx structure matches page structure
+ * 6. ELEMENT COUNT - Checks skeleton element counts match actual components
+ * 7. GRID PATTERNS - Validates grid column counts match between skeleton and page
+ * 8. DOCUMENTATION - Ensures skeletons document what they mirror
+ * 9. SPACING TOKENS - Validates consistent spacing between skeleton and component
+ * 10. DESIGN TOKEN CONSISTENCY - Validates CSS variables match between pairs
+ * 11. BORDER/SHADOW CONSISTENCY - Validates visual styling matches
+ * 12. ARIA/ACCESSIBILITY - Validates skeleton has proper aria-labels
+ * 13. ICON PLACEHOLDER VALIDATION - Validates icon placeholders match actual icons
+ */
+export declare const id = "ui/skeleton-size-consistency";
+export declare const name = "Skeleton Size Consistency";
+export declare const category = "ui";
+export declare const blocking = false;
+export declare const description = "Skeleton Size Consistency Preflight Check (Enhanced)";
+export declare const tags: string[];
+interface Issue {
+    file: string;
+    line: number;
+    severity: "error" | "warning" | "info";
+    category: string;
+    message: string;
+    suggestion: string;
+    details?: Record<string, string | number>;
+}
+declare function checkSkeletonSizeConsistency(): Promise<{
+    passed: boolean;
+    issues: Issue[];
+}>;
+export { checkSkeletonSizeConsistency };
+//# sourceMappingURL=skeleton-size-consistency.d.ts.map

package/dist/checks/ui/skeleton-size-consistency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton-size-consistency.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/skeleton-size-consistency.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAUH,eAAO,MAAM,EAAE,iCAAiC,CAAC;AACjD,eAAO,MAAM,IAAI,8BAA8B,CAAC;AAChD,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,yDAAyD,CAAC;AAClF,eAAO,MAAM,IAAI,UAAS,CAAC;AAI3B,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC3C;AAoxCD,iBAAe,4BAA4B,IAAI,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,KAAK,EAAE,CAAA;CAAE,CAAC,CAmG3F;AA0BD,OAAO,EAAE,4BAA4B,EAAE,CAAC"}