@empline/preflight 1.0.20

package/dist/checks/ui/accessibility-critical.js

@@ -0,0 +1,357 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Accessibility Critical Preflight
+ *
+ * Checks for critical accessibility issues that should block deployment:
+ * - Missing alt text on images
+ * - Missing ARIA labels on interactive elements
+ * - Color contrast issues (via class patterns)
+ * - Focus trap issues
+ * - Missing form labels
+ */
+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"));
+const console_chars_1 = require("../../utils/console-chars");
+// Check metadata
+exports.id = "ui/accessibility-critical";
+exports.name = "Accessibility Critical";
+exports.category = "ui";
+exports.blocking = true;
+exports.description = "Accessibility Critical Preflight";
+exports.tags = ["ui"];
+const findings = [];
+function scanFile(filePath) {
+    const content = fs.readFileSync(filePath, "utf-8");
+    const lines = content.split("\n");
+    const relativePath = path.relative(process.cwd(), filePath);
+    lines.forEach((line, idx) => {
+        const lineNum = idx + 1;
+        // Skip lines with preflight-ignore comment (check current and previous line)
+        const prevLine = idx > 0 ? lines[idx - 1] : "";
+        if (/preflight-ignore/.test(line) || /preflight-ignore/.test(prevLine)) {
+            return;
+        }
+        // Check for images without alt text
+        // Skip if this is a component definition (has alt as a prop with default)
+        if (/<img\s/i.test(line) && !/alt\s*=/.test(line)) {
+            // Check next few lines for alt
+            const nextLines = lines.slice(idx, idx + 3).join(" ");
+            if (!/alt\s*=/.test(nextLines)) {
+                findings.push({
+                    file: relativePath,
+                    line: lineNum,
+                    message: 'Image missing alt attribute. Add alt="" for decorative images or descriptive text for meaningful images.',
+                    severity: "error",
+                    code: "IMG_NO_ALT",
+                });
+            }
+        }
+        // Check for Next.js Image without alt
+        // Skip Lucide icons (they have color= or size= props, or are self-closing without src)
+        // Also skip if it's inside a string (selector like 'button[aria-haspopup="true"]')
+        if (/<Image\s/i.test(line) && !/alt\s*=/.test(line)) {
+            // Skip if this looks like a Lucide icon (has color=, size=, or no src/image props)
+            const isLucideIcon = /color\s*=/.test(line) ||
+                (/size\s*=/.test(line) && !/src\s*=/.test(line)) ||
+                /<Image\s*\/>/.test(line);
+            if (!isLucideIcon) {
+                const nextLines = lines.slice(idx, idx + 5).join(" ");
+                // Check if it has src= (Next.js Image) and no alt=
+                if (/src\s*=/.test(nextLines) && !/alt\s*=/.test(nextLines)) {
+                    findings.push({
+                        file: relativePath,
+                        line: lineNum,
+                        message: "Next.js Image missing alt attribute.",
+                        severity: "error",
+                        code: "NEXT_IMG_NO_ALT",
+                    });
+                }
+            }
+        }
+        // Check for IconButton without accessible names
+        // Only check actual IconButton components, not regular buttons with icons
+        if (/<IconButton\b/i.test(line)) {
+            // Look at next 25 lines to find all props - IconButton can span many lines
+            // due to complex icon={<Component />} props with ternaries
+            const nextLines = lines.slice(idx, Math.min(idx + 25, lines.length));
+            let buttonBlock = "";
+            for (const l of nextLines) {
+                buttonBlock += " " + l;
+                // Check if this line closes the IconButton
+                // Look for /> at the end of a line where we're not inside a JSX expression
+                if (/<\/IconButton>/.test(l)) {
+                    break;
+                }
+                // Check for self-closing /> - but only if braces AND parens are balanced
+                // This handles ternaries like: icon={condition ? (<A />) : (<B />)}
+                if (/\/>\s*$/.test(l.trim())) {
+                    const openBraces = (buttonBlock.match(/{/g) || []).length;
+                    const closeBraces = (buttonBlock.match(/}/g) || []).length;
+                    const openParens = (buttonBlock.match(/\(/g) || []).length;
+                    const closeParens = (buttonBlock.match(/\)/g) || []).length;
+                    // If both braces and parens are balanced, this /> closes the IconButton
+                    if (openBraces === closeBraces && openParens === closeParens) {
+                        break;
+                    }
+                }
+            }
+            // Check for accessible name props using word boundaries
+            const hasAccessibleName = /aria-label\s*=/.test(buttonBlock) ||
+                /aria-labelledby\s*=/.test(buttonBlock) ||
+                /\blabel\s*=/.test(buttonBlock) ||
+                /\btitle\s*=/.test(buttonBlock);
+            if (!hasAccessibleName) {
+                findings.push({
+                    file: relativePath,
+                    line: lineNum,
+                    message: "IconButton missing accessible name. Add label=, aria-label=, or title=.",
+                    severity: "error",
+                    code: "ICON_BTN_NO_LABEL",
+                });
+            }
+        }
+        // Check for form inputs without labels
+        if (/<input\s/i.test(line) && !/type\s*=\s*["']hidden["']/.test(line)) {
+            const inputBlock = lines.slice(Math.max(0, idx - 5), idx + 5).join(" ");
+            const hasLabel = /aria-label\s*=/.test(inputBlock) ||
+                /aria-labelledby\s*=/.test(inputBlock) ||
+                /<label/.test(inputBlock) ||
+                (/id\s*=/.test(line) && /htmlFor/.test(inputBlock));
+            if (!hasLabel && !/placeholder/.test(line)) {
+                findings.push({
+                    file: relativePath,
+                    line: lineNum,
+                    message: "Form input may be missing associated label. Add aria-label or <label htmlFor>.",
+                    severity: "warning",
+                    code: "INPUT_NO_LABEL",
+                });
+            }
+        }
+        // Check for onClick on non-interactive elements
+        if (/onClick\s*=/.test(line)) {
+            const element = line.match(/<(\w+)/)?.[1];
+            const nonInteractive = ["div", "span", "p", "li", "td", "tr"];
+            if (element && nonInteractive.includes(element.toLowerCase())) {
+                const hasRole = /role\s*=\s*["'](button|link|menuitem)["']/.test(line);
+                const hasTabIndex = /tabIndex\s*=/.test(line);
+                const hasKeyHandler = /onKeyDown|onKeyPress|onKeyUp/.test(line);
+                if (!hasRole) {
+                    findings.push({
+                        file: relativePath,
+                        line: lineNum,
+                        message: `onClick on <${element}> without role="button". Non-interactive elements with click handlers need role and keyboard support.`,
+                        severity: "warning",
+                        code: "CLICK_NO_ROLE",
+                    });
+                }
+                if (!hasTabIndex && !hasRole) {
+                    findings.push({
+                        file: relativePath,
+                        line: lineNum,
+                        message: `onClick on <${element}> without tabIndex. Element won't be keyboard accessible.`,
+                        severity: "warning",
+                        code: "CLICK_NO_TABINDEX",
+                    });
+                }
+            }
+        }
+        // Check for missing aria-expanded on toggles
+        // Look at surrounding lines (before AND after) since aria-expanded often comes before aria-haspopup
+        // Skip if this is inside a string (like a querySelector selector)
+        if (/aria-haspopup\s*=/.test(line) && !/aria-expanded\s*=/.test(line)) {
+            // Skip if this looks like a string selector (has quotes around the attribute)
+            const isStringSelector = /['"].*aria-haspopup.*['"]/.test(line) ||
+                /closest\s*\(/.test(line) ||
+                /querySelector/.test(line);
+            if (!isStringSelector) {
+                const surroundingLines = lines.slice(Math.max(0, idx - 3), idx + 4).join(" ");
+                if (!/aria-expanded\s*=/.test(surroundingLines)) {
+                    findings.push({
+                        file: relativePath,
+                        line: lineNum,
+                        message: "Element with aria-haspopup missing aria-expanded. Screen readers need to know if popup is open.",
+                        severity: "error",
+                        code: "POPUP_NO_EXPANDED",
+                    });
+                }
+            }
+        }
+        // Check for autoFocus (can be disorienting)
+        if (/autoFocus/.test(line)) {
+            findings.push({
+                file: relativePath,
+                line: lineNum,
+                message: "autoFocus can be disorienting for screen reader users. Consider managing focus programmatically.",
+                severity: "warning",
+                code: "AUTOFOCUS_USED",
+            });
+        }
+        // Check for positive tabIndex (breaks natural tab order)
+        if (/tabIndex\s*=\s*{?\s*[1-9]/.test(line)) {
+            findings.push({
+                file: relativePath,
+                line: lineNum,
+                message: "Positive tabIndex breaks natural tab order. Use tabIndex={0} or tabIndex={-1} instead.",
+                severity: "error",
+                code: "POSITIVE_TABINDEX",
+            });
+        }
+        // Check for text-foreground on colored backgrounds (poor contrast)
+        // This catches cases where text-foreground is used inside a colored container
+        // Common bad patterns: text-foreground on bg-[var(--color-primary-light)] or similar
+        // Skip neutral backgrounds like bg-muted, bg-secondary, bg-tertiary, bg-background
+        if (/text-foreground(?!\/|\s*\/)/.test(line)) {
+            // Look at surrounding context (parent elements) for colored backgrounds
+            const contextLines = lines.slice(Math.max(0, idx - 15), idx + 1).join(" ");
+            // Check for colored backgrounds (not neutral ones)
+            const hasColoredBg = /bg-\[var\(--color-primary/.test(contextLines) ||
+                /bg-\[var\(--color-success/.test(contextLines) ||
+                /bg-\[var\(--color-warning/.test(contextLines) ||
+                /bg-\[var\(--color-error/.test(contextLines) ||
+                /bg-\[var\(--color-info/.test(contextLines) ||
+                /bg-primary(?![/-])/.test(contextLines) ||
+                /bg-blue-[4-9]00/.test(contextLines) ||
+                /bg-green-[4-9]00/.test(contextLines) ||
+                /bg-red-[4-9]00/.test(contextLines) ||
+                /bg-yellow-[4-9]00/.test(contextLines);
+            // Skip if it's on a neutral background (these have good contrast with text-foreground)
+            const hasNeutralBg = /bg-muted/.test(contextLines) ||
+                /bg-secondary/.test(contextLines) ||
+                /bg-tertiary/.test(contextLines) ||
+                /bg-background/.test(contextLines) ||
+                /bg-card/.test(contextLines) ||
+                /bg-\[var\(--bg-/.test(contextLines);
+            if (hasColoredBg && !hasNeutralBg) {
+                findings.push({
+                    file: relativePath,
+                    line: lineNum,
+                    message: "text-foreground on colored background may have poor contrast. Use text-white or appropriate contrast color instead.",
+                    severity: "error",
+                    code: "TEXT_FOREGROUND_ON_COLOR",
+                });
+            }
+        }
+        // Check for outline:none without focus-visible alternative
+        if (/outline:\s*none|outline:\s*0|outline-none/.test(line)) {
+            const hasRing = /ring-|focus-visible|focus:ring/.test(line);
+            if (!hasRing) {
+                findings.push({
+                    file: relativePath,
+                    line: lineNum,
+                    message: "outline:none removes focus indicator. Add focus-visible styles for keyboard users.",
+                    severity: "warning",
+                    code: "OUTLINE_NONE",
+                });
+            }
+        }
+    });
+}
+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 main() {
+    console.log(`${console_chars_1.emoji.search} Checking accessibility...\n`);
+    const files = getComponentFiles();
+    for (const file of files) {
+        scanFile(file);
+    }
+    // Deduplicate
+    const uniqueFindings = findings.filter((f, i, arr) => arr.findIndex((x) => x.file === f.file && x.line === f.line && x.code === f.code) === 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} Accessibility Errors (blocking):`);
+        for (const f of errors.slice(0, 15)) {
+            console.log(`  ${f.file}:${f.line} [${f.code}]`);
+            console.log(`    ${f.message}`);
+        }
+        if (errors.length > 15) {
+            console.log(`  ... and ${errors.length - 15} more errors`);
+        }
+        console.log("");
+    }
+    if (warnings.length > 0) {
+        console.log(`${console_chars_1.emoji.warning}  Accessibility Warnings:`);
+        for (const f of warnings.slice(0, 10)) {
+            console.log(`  ${f.file}:${f.line} [${f.code}]`);
+        }
+        if (warnings.length > 10) {
+            console.log(`  ... and ${warnings.length - 10} more warnings`);
+        }
+        console.log("");
+    }
+    // Write findings
+    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) {
+        console.log(`\n${console_chars_1.emoji.error} Accessibility check failed`);
+        process.exit(1);
+    }
+    console.log(`\n${console_chars_1.emoji.success} Accessibility check passed`);
+}
+main().catch((err) => {
+    console.error("Preflight error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=accessibility-critical.js.map

package/dist/checks/ui/accessibility-critical.js.map

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

package/dist/checks/ui/alert-button-gap.d.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env tsx
+/**
+ * Alert/Status Button Gap Preflight (BLOCKING)
+ *
+ * Detects UnifiedStatus or Alert components that are direct siblings with Button
+ * components without proper gap spacing between them.
+ *
+ * PATTERNS DETECTED:
+ * - UnifiedStatus followed directly by Button without mb-X class on status
+ * - Alert followed directly by Button without mb-X class on alert
+ *
+ * FALSE POSITIVES AVOIDED:
+ * - Buttons inside CardSection headerActions (different structural context)
+ * - Buttons in separate Box/div containers
+ * - Component names containing "Notification" (e.g., SellerNotificationHistoryClient)
+ *
+ * Usage:
+ *   pnpm preflight:alert-button-gap
+ */
+export declare const id = "ui/alert-button-gap";
+export declare const name = "Alert Button Gap";
+export declare const category = "ui";
+export declare const blocking = true;
+export declare const description = "Alert/Status Button Gap Preflight (BLOCKING)";
+export declare const tags: string[];
+//# sourceMappingURL=alert-button-gap.d.ts.map

package/dist/checks/ui/alert-button-gap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-button-gap.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/alert-button-gap.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;GAiBG;AAQH,eAAO,MAAM,EAAE,wBAAwB,CAAC;AACxC,eAAO,MAAM,IAAI,qBAAqB,CAAC;AACvC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,iDAAiD,CAAC;AAC1E,eAAO,MAAM,IAAI,UAAS,CAAC"}

package/dist/checks/ui/alert-button-gap.js

@@ -0,0 +1,215 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Alert/Status Button Gap Preflight (BLOCKING)
+ *
+ * Detects UnifiedStatus or Alert components that are direct siblings with Button
+ * components without proper gap spacing between them.
+ *
+ * PATTERNS DETECTED:
+ * - UnifiedStatus followed directly by Button without mb-X class on status
+ * - Alert followed directly by Button without mb-X class on alert
+ *
+ * FALSE POSITIVES AVOIDED:
+ * - Buttons inside CardSection headerActions (different structural context)
+ * - Buttons in separate Box/div containers
+ * - Component names containing "Notification" (e.g., SellerNotificationHistoryClient)
+ *
+ * Usage:
+ *   pnpm preflight:alert-button-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 console_chars_1 = require("../../utils/console-chars");
+const file_cache_1 = require("../../shared/file-cache");
+// Check metadata
+exports.id = "ui/alert-button-gap";
+exports.name = "Alert Button Gap";
+exports.category = "ui";
+exports.blocking = true;
+exports.description = "Alert/Status Button Gap Preflight (BLOCKING)";
+exports.tags = ["ui"];
+// Components that are alerts/status indicators (actual JSX components only)
+const ALERT_COMPONENTS = ["UnifiedStatus", "Alert"];
+async function checkAlertButtonGap() {
+    console.log(`\n${console_chars_1.emoji.search} Alert/Status Button Gap Check (BLOCKING)\n`);
+    console.log("Detects alert/status components followed by buttons without gap spacing.\n");
+    const files = await file_cache_1.fileCache.getAllTsx();
+    const issues = [];
+    for (const file of files) {
+        // Skip test files and scripts
+        if (file.includes("/tests/") || file.includes("/scripts/") || file.includes("__tests__")) {
+            continue;
+        }
+        const content = fs.readFileSync(file, "utf8");
+        const lines = content.split("\n");
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const lineNum = i + 1;
+            // Skip comments and preflight-ignore
+            const trimmed = line.trim();
+            if (trimmed.startsWith("//") || trimmed.startsWith("/*") || trimmed.startsWith("*"))
+                continue;
+            if (line.includes("preflight-ignore"))
+                continue;
+            // Check for alert components (must be actual JSX tag, not part of a name)
+            for (const alertComponent of ALERT_COMPONENTS) {
+                // Match <UnifiedStatus or <Alert but not <AlertCircle or similar
+                const alertRegex = new RegExp(`<${alertComponent}(?:\\s|>|$)`);
+                if (!alertRegex.test(line))
+                    continue;
+                // Check if this alert has margin-bottom spacing
+                const hasMarginBottom = line.includes("mb-") || line.includes("marginBottom") || line.includes("margin-bottom");
+                if (hasMarginBottom)
+                    continue;
+                // Find the closing of this component
+                let closingLineIdx = i;
+                let depth = 0;
+                let foundSelfClosing = false;
+                // Check if self-closing on same line
+                if (line.includes("/>")) {
+                    foundSelfClosing = true;
+                    closingLineIdx = i;
+                }
+                else {
+                    // Look for closing tag
+                    for (let j = i; j < Math.min(i + 20, lines.length); j++) {
+                        const searchLine = lines[j];
+                        if (searchLine.includes(`<${alertComponent}`))
+                            depth++;
+                        if (searchLine.includes(`</${alertComponent}>`)) {
+                            depth--;
+                            if (depth === 0) {
+                                closingLineIdx = j;
+                                break;
+                            }
+                        }
+                        if (j === i && searchLine.includes("/>")) {
+                            foundSelfClosing = true;
+                            closingLineIdx = j;
+                            break;
+                        }
+                    }
+                }
+                // Now look for Button immediately after (within 3 lines of closing)
+                let buttonFound = false;
+                let buttonLineNum = -1;
+                for (let j = closingLineIdx + 1; j < Math.min(closingLineIdx + 4, lines.length); j++) {
+                    const nextLine = lines[j].trim();
+                    // Skip empty lines and comments
+                    if (!nextLine || nextLine.startsWith("//") || nextLine.startsWith("/*"))
+                        continue;
+                    // If we hit a structural element first, no issue
+                    if (nextLine.startsWith("</") ||
+                        nextLine.startsWith("<Box") ||
+                        nextLine.startsWith("<div") ||
+                        nextLine.startsWith("<Stack") ||
+                        nextLine.startsWith("<Card") ||
+                        nextLine.startsWith("{/*")) {
+                        break;
+                    }
+                    // Check for Button
+                    if (nextLine.match(/^<Button/) || nextLine.match(/^\{.*<Button/)) {
+                        buttonFound = true;
+                        buttonLineNum = j + 1;
+                        break;
+                    }
+                    // If we hit any other JSX element that's not Button, stop
+                    if (nextLine.startsWith("<") && !nextLine.startsWith("</")) {
+                        break;
+                    }
+                }
+                if (buttonFound) {
+                    // Check if parent container has gap
+                    const parentContext = lines.slice(Math.max(0, i - 10), i).join("\n");
+                    const hasParentGap = parentContext.includes("gap-") ||
+                        parentContext.includes("gap:") ||
+                        parentContext.includes("space-y-") ||
+                        parentContext.includes("flex-col gap");
+                    if (!hasParentGap) {
+                        issues.push({
+                            file,
+                            line: lineNum,
+                            type: "error",
+                            message: `${alertComponent} followed by Button without gap spacing`,
+                            context: line.trim().substring(0, 80),
+                            suggestion: `Add mb-4 class to ${alertComponent} or gap-4 to parent container`,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    // Deduplicate issues (same file + line)
+    const seen = new Set();
+    const uniqueIssues = issues.filter((issue) => {
+        const key = `${issue.file}:${issue.line}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+    // Report
+    console.log((0, console_chars_1.createDivider)(60, "light"));
+    if (uniqueIssues.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} No alert/button gap issues found!\n`);
+        return;
+    }
+    const errors = uniqueIssues.filter((i) => i.type === "error");
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} ERRORS (${errors.length}):\n`);
+        errors.slice(0, 20).forEach((issue) => {
+            console.log(`  ${issue.file}:${issue.line}`);
+            console.log(`    ${issue.message}`);
+            console.log(`    ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+            console.log("");
+        });
+        if (errors.length > 20) {
+            console.log(`  ... and ${errors.length - 20} more errors\n`);
+        }
+    }
+    console.log(`\n${console_chars_1.emoji.chart} Summary: ${errors.length} errors`);
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} Alert/button gap check FAILED\n`);
+        process.exit(1);
+    }
+}
+checkAlertButtonGap().catch((err) => {
+    console.error("Error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=alert-button-gap.js.map

package/dist/checks/ui/alert-button-gap.js.map

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

package/dist/checks/ui/breadcrumb-consistency.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Breadcrumb Consistency Preflight Check
+ *
+ * Ensures all pages use UnifiedBreadcrumbs consistently:
+ * 1. Breadcrumbs must be rendered at full-width (not inside padded containers)
+ * 2. Breadcrumbs must use the default variant (with background)
+ * 3. Breadcrumbs should NOT use noPadding when rendered at page level
+ * 4. Layout components should render breadcrumbs before content containers
+ *
+ * Run: pnpm preflight:breadcrumb-consistency
+ */
+export declare const id = "ui/breadcrumb-consistency";
+export declare const name = "Breadcrumb Consistency";
+export declare const category = "ui";
+export declare const blocking = false;
+export declare const description = "Breadcrumb Consistency Preflight Check";
+export declare const tags: string[];
+//# sourceMappingURL=breadcrumb-consistency.d.ts.map

package/dist/checks/ui/breadcrumb-consistency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb-consistency.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/breadcrumb-consistency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,eAAO,MAAM,EAAE,8BAA8B,CAAC;AAC9C,eAAO,MAAM,IAAI,2BAA2B,CAAC;AAC7C,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,2CAA2C,CAAC;AACpE,eAAO,MAAM,IAAI,UAAS,CAAC"}