@empline/preflight 1.0.20

package/dist/checks/ui/layout-shift-detection.js

@@ -0,0 +1,398 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Layout Shift Detection Preflight (BLOCKING)
+ *
+ * Detects patterns that cause Cumulative Layout Shift (CLS) issues:
+ * - Inline alerts/messages that appear conditionally and push content down
+ * - Success/error states rendered in document flow instead of fixed toasts
+ * - Missing skeleton/placeholder patterns for async content
+ * - Conditional rendering that changes layout without reserving space
+ *
+ * BLOCKS:
+ * - {message && <Alert>} patterns in page content (causes shift)
+ * - {error && <div>} inline error displays
+ * - Conditional content without min-height reservation
+ *
+ * APPROVED patterns:
+ * - useStatus() / showToast() (fixed position, no shift)
+ * - Alert inside dedicated error boundary with reserved space
+ * - Skeleton placeholders for loading states
+ * - min-h-* classes reserving space for conditional content
+ *
+ * Usage:
+ *   pnpm preflight:ui:layout-shift
+ */
+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/layout-shift-detection";
+exports.name = "Layout Shift Detection";
+exports.category = "ui";
+exports.blocking = true;
+exports.description = "Layout Shift Detection Preflight (BLOCKING)";
+exports.tags = ["ui"];
+const EXCLUDED = (0, glob_patterns_1.extendExcludes)(glob_patterns_1.PRODUCTION_CODE_EXCLUDES, [
+    "**/scripts/**",
+    "**/test-results/**",
+    "**/*.test.tsx",
+    "**/*.spec.tsx",
+    "**/stories/**",
+]);
+// Patterns that cause layout shift
+const LAYOUT_SHIFT_PATTERNS = [
+    {
+        // {message && <Alert>} or {message && <div className="alert">}
+        // Excludes small inline elements like icons (AlertCircle, etc.)
+        pattern: /\{[\s\n]*(?:message|error|success|warning|info|status|notification)[\s\n]*&&[\s\n]*<(?:Alert|Box|div|Typography|p)(?:\s|>)[^}]*\}/gi,
+        rule: "inline-conditional-alert",
+        message: "Conditional inline alert/message causes layout shift when it appears",
+        type: "error",
+        suggestion: "Use useStatus().success() or useStatus().error() for toast notifications instead",
+        // Skip if it's a small icon component (AlertCircle, AlertTriangle, etc.)
+        skipIfMatches: /Alert(?:Circle|Triangle|Octagon)\s+size=["']?\d+/i,
+    },
+    {
+        // {showMessage && <...>} pattern - only for block-level elements
+        pattern: /\{[\s\n]*show(?:Message|Error|Success|Warning|Alert|Status|Notification)[\s\n]*&&[\s\n]*<(?:Alert|Box|div|section|Card)/gi,
+        rule: "inline-conditional-show",
+        message: "Conditional show* state causes layout shift",
+        type: "error",
+        suggestion: "Use fixed-position toasts via useStatus() hook",
+    },
+    {
+        // {isError && <Alert>} or {hasError && <div>} - only block-level, not icons
+        // Specifically excludes icon components like AlertCircle
+        pattern: /\{[\s\n]*(?:is|has)(?:Error|Success|Warning|Message)[\s\n]*&&[\s\n]*<(?:Alert|Box|div|section|Card)(?:\s|>)/gi,
+        rule: "inline-boolean-alert",
+        message: "Boolean-conditional alert causes layout shift",
+        type: "error",
+        suggestion: "Use useStatus() for notifications or reserve space with min-h-*",
+        // Skip if it's a small icon component
+        skipIfMatches: /Alert(?:Circle|Triangle|Octagon)\s+size=["']?\d+/i,
+    },
+    {
+        // useState for message display without useStatus
+        pattern: /const\s+\[(?:message|error|success|statusMessage),\s*set(?:Message|Error|Success|StatusMessage)\]\s*=\s*useState/gi,
+        rule: "message-state-pattern",
+        message: "Local message state often leads to layout shift - prefer useStatus()",
+        type: "warning",
+        suggestion: "Consider using useStatus() hook for consistent toast notifications",
+    },
+];
+// Patterns that indicate proper handling (allowlist)
+const SAFE_PATTERNS = [
+    /useStatus\s*\(\s*\)/, // Using the toast system
+    /showToast\s*\(/, // Direct toast call
+    /showSuccess\s*\(/, // Success toast
+    /showError\s*\(/, // Error toast
+    /position:\s*["']?fixed/i, // Fixed positioning
+    /min-h-\[?\d+/, // Reserved height
+    /className=.*min-h-/, // Reserved height via className
+    /\.toast/i, // Toast-related
+    /Toaster/, // Toast provider
+    /Sonner/, // Sonner toast library
+];
+// Files that legitimately use inline alerts (error boundaries, form validation)
+const ALLOWED_CONTEXTS = [
+    "error.tsx", // Error boundary pages
+    "not-found.tsx", // 404 pages
+    "ErrorBoundary", // Error boundary components
+    "FormField", // Form validation (inline is expected)
+    "ValidationMessage", // Validation messages
+    "LoadingState", // Loading components (message display is intentional)
+    "Skeleton", // Skeleton loading components
+    "useInputDialog", // Dialog hooks (form validation inside dialogs)
+    "useConfirmDialog", // Confirmation dialogs
+    "Dialog", // Dialog components (validation is expected)
+    "Modal", // Modal components
+    "Filter", // Filter components (conditional sections are expected)
+    "Collapsible", // Collapsible components (intentional UX)
+    "Accordion", // Accordion components
+    "SectionCard", // Section cards with collapsible
+    "Dropdown", // Dropdown components
+    "Popover", // Popover components
+    "Tooltip", // Tooltip components
+    "Turnstile", // CAPTCHA widgets (inline errors are expected)
+    "Captcha", // CAPTCHA components
+    "ImageWithFallback", // Image fallback (error state is for placeholder)
+    "FileUpload", // File upload (inline validation errors)
+    "Upload", // Upload components
+    "Compressor", // Image compressor (progress/error states)
+    "ActionRow", // Action rows (conditional actions are intentional)
+    "ActionBar", // Action bars
+    "Pricing", // Pricing components (conditional display)
+    "Reviews", // Review components (conditional sections)
+    "Search", // Search components (results are conditional)
+    "Suggestions", // Suggestion components
+    "CardSection", // Card sections (collapsible content)
+    "Checkout", // Checkout components (form validation)
+    "Cart", // Cart components (conditional items)
+    "reset-password", // Password reset (form validation)
+    "forgot-password", // Forgot password (form validation)
+    "verify", // Verification pages (status messages)
+    "Auth", // Auth components (form validation)
+    "Login", // Login components
+    "Register", // Register components
+    "SignUp", // Sign up components
+    "SignIn", // Sign in components
+    "Panel", // Panel components (conditional content)
+    "Drawer", // Drawer components
+    "History", // History components (conditional data)
+    "Viewer", // Viewer components
+    "Dashboard", // Dashboard components (conditional widgets)
+    "Analytics", // Analytics components
+    "Import", // Import components (progress/status)
+    "Export", // Export components
+    "Streaming", // Streaming components (progress states)
+    "ProductImage", // Image components (error state for fallback)
+    "Image", // Image components
+    "Plans", // Plans display (error state for API failures)
+    "Client", // Client components (data fetching error states)
+    "Page", // Page components (data fetching error states)
+    "admin", // Admin components (monitoring/status displays)
+    "woocommerce", // WooCommerce integration (sync status)
+    "TwoFactor", // 2FA setup (conditional QR code display)
+    "Setup", // Setup components (step-based conditionals)
+    "Listing", // Listing components (conditional sections)
+    "brand-management", // Brand management (admin CRUD operations)
+    "templates", // Template management (admin operations)
+    "rotation-metrics", // Metrics pages (data display)
+    "daily-summary", // Summary pages (data display)
+];
+// CACHED FILE LISTS
+let _cachedAllTsxFiles = null;
+async function getAllTsxFiles() {
+    if (!_cachedAllTsxFiles) {
+        const allFiles = await file_cache_1.fileCache.getAllTsTsx();
+        _cachedAllTsxFiles = allFiles.filter((f) => f.endsWith(".tsx"));
+    }
+    return _cachedAllTsxFiles;
+}
+async function checkLayoutShift() {
+    console.log(`\n${console_chars_1.emoji.search} Layout Shift Detection (BLOCKING)\n`);
+    console.log("Detects patterns that cause content to jump when messages appear.");
+    console.log("Rules:");
+    console.log(`  ${console_chars_1.emoji.error} {message && <Alert>} inline patterns are PROHIBITED`);
+    console.log(`  ${console_chars_1.emoji.error} Conditional content that shifts layout is PROHIBITED`);
+    console.log(`  ${console_chars_1.emoji.success} useStatus().success() / .error() toasts are OK`);
+    console.log(`  ${console_chars_1.emoji.success} Fixed-position notifications are OK`);
+    console.log(`  ${console_chars_1.emoji.success} Reserved space (min-h-*) for conditional content is OK\n`);
+    const allFiles = await getAllTsxFiles();
+    const files = allFiles.filter((f) => !(0, glob_patterns_1.isExcluded)(f, EXCLUDED));
+    const issues = [];
+    for (const file of files) {
+        const normalizedFile = file.replace(/\\/g, "/");
+        // Skip allowed contexts
+        if (ALLOWED_CONTEXTS.some((ctx) => normalizedFile.includes(ctx))) {
+            continue;
+        }
+        const content = fs.readFileSync(file, "utf8");
+        const lines = content.split("\n");
+        // Check if file uses safe patterns (useStatus, etc.)
+        const usesSafePatterns = SAFE_PATTERNS.some((pattern) => pattern.test(content));
+        // Check if file uses form validation patterns (error state for TextField helperText)
+        const usesFormValidation = /helperText=\{.*error|error=\{!!error|error=\{Boolean\(error\)/i.test(content);
+        // Check for layout shift patterns
+        for (const check of LAYOUT_SHIFT_PATTERNS) {
+            // Skip warning-level checks if file uses safe patterns
+            if (check.type === "warning" && usesSafePatterns) {
+                continue;
+            }
+            // Skip message-state-pattern warning if file uses form validation
+            if (check.rule === "message-state-pattern" && usesFormValidation) {
+                continue;
+            }
+            let match;
+            const regex = new RegExp(check.pattern.source, check.pattern.flags);
+            while ((match = regex.exec(content)) !== null) {
+                // Find line number
+                const beforeMatch = content.slice(0, match.index);
+                const lineNum = (beforeMatch.match(/\n/g) || []).length + 1;
+                const line = lines[lineNum - 1] || "";
+                // Skip if line has preflight-ignore
+                if (line.includes("preflight-ignore"))
+                    continue;
+                // Get the matched text for additional checks
+                const matchedText = match[0];
+                // Skip if the pattern has a skipIfMatches and the matched text matches it
+                if (check.skipIfMatches && check.skipIfMatches.test(matchedText)) {
+                    continue;
+                }
+                // Skip if this specific usage has safe patterns nearby
+                const contextStart = Math.max(0, match.index - 500);
+                const contextEnd = Math.min(content.length, match.index + 500);
+                const localContext = content.slice(contextStart, contextEnd);
+                // Check if there's reserved space or it's in a fixed container
+                const hasReservedSpace = /min-h-|minHeight|position:\s*["']?fixed/i.test(localContext);
+                if (hasReservedSpace)
+                    continue;
+                // Check if it's inside a toast/notification container
+                const isInToastContext = /toast|notification|snackbar/i.test(localContext);
+                if (isInToastContext)
+                    continue;
+                // Skip small inline icons (AlertCircle, AlertTriangle, etc. with size prop)
+                const isSmallIcon = /Alert(?:Circle|Triangle|Octagon)\s+size=["']?\d+/i.test(localContext.slice(match.index - contextStart, match.index - contextStart + 100));
+                if (isSmallIcon)
+                    continue;
+                const snippet = line.trim().slice(0, 100);
+                issues.push({
+                    file: normalizedFile,
+                    line: lineNum,
+                    type: check.type,
+                    rule: check.rule,
+                    message: check.message,
+                    snippet,
+                    suggestion: check.suggestion,
+                });
+            }
+        }
+        // Additional check: Look for conditional rendering of substantial content
+        // Pattern: {condition && ( <CardSection> or <Box className="..."> )}
+        // Skip patterns that are clearly intentional UX (collapsible, filters, etc.)
+        const conditionalBlockPattern = /\{[\s\n]*\w+[\s\n]*&&[\s\n]*\([\s\n]*<(?:CardSection|Card|Box|div|section)[^>]*className/gi;
+        let blockMatch;
+        while ((blockMatch = conditionalBlockPattern.exec(content)) !== null) {
+            const beforeMatch = content.slice(0, blockMatch.index);
+            const lineNum = (beforeMatch.match(/\n/g) || []).length + 1;
+            const line = lines[lineNum - 1] || "";
+            if (line.includes("preflight-ignore"))
+                continue;
+            // Check context for reserved space
+            const contextStart = Math.max(0, blockMatch.index - 200);
+            const contextEnd = Math.min(content.length, blockMatch.index + 500);
+            const localContext = content.slice(contextStart, contextEnd);
+            const hasReservedSpace = /min-h-|minHeight/.test(localContext);
+            if (hasReservedSpace)
+                continue;
+            // Skip if it's a collapsible/accordion pattern (intentional UX)
+            const isCollapsiblePattern = /isCollapsed|isExpanded|isOpen|collapsed|expanded|toggle/i.test(localContext);
+            if (isCollapsiblePattern)
+                continue;
+            // Skip if it's a filter/selection pattern (intentional UX)
+            const isFilterPattern = /filter|selected|active|checked|enabled|disabled/i.test(localContext);
+            if (isFilterPattern)
+                continue;
+            // Skip if it's a props-based conditional (not state-driven shift)
+            const isPropsConditional = /props\.|\.length\s*>|\.length\s*===|\.length\s*!==/.test(localContext);
+            if (isPropsConditional)
+                continue;
+            // This is a warning, not error - conditional sections are sometimes OK
+            issues.push({
+                file: normalizedFile,
+                line: lineNum,
+                type: "warning",
+                rule: "conditional-section-shift",
+                message: "Conditional section may cause layout shift when it appears/disappears",
+                snippet: line.trim().slice(0, 100),
+                suggestion: "Consider using min-h-* to reserve space, or ensure this doesn't affect visible content",
+            });
+        }
+    }
+    // Deduplicate
+    const uniqueIssues = deduplicateIssues(issues);
+    // Report results
+    const errors = uniqueIssues.filter((i) => i.type === "error");
+    const warnings = uniqueIssues.filter((i) => i.type === "warning");
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} BLOCKING ERRORS (${errors.length}):\n`);
+        errors.forEach((issue) => {
+            console.log(`  ${issue.file}:${issue.line}`);
+            console.log(`    Rule: ${issue.rule}`);
+            console.log(`    ${issue.message}`);
+            if (issue.snippet) {
+                console.log(`    Code: ${issue.snippet}`);
+            }
+            if (issue.suggestion) {
+                console.log(`    ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+            }
+            console.log("");
+        });
+    }
+    if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning}  WARNINGS (${warnings.length}):\n`);
+        warnings.slice(0, 15).forEach((issue) => {
+            console.log(`  ${issue.file}:${issue.line}`);
+            console.log(`    ${issue.message}`);
+            if (issue.suggestion) {
+                console.log(`    ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+            }
+        });
+        if (warnings.length > 15) {
+            console.log(`  ... and ${warnings.length - 15} more warnings`);
+        }
+    }
+    // Summary
+    console.log("\n" + (0, console_chars_1.createDivider)(60, "light"));
+    console.log(`${console_chars_1.emoji.chart} Summary: ${errors.length} errors, ${warnings.length} warnings`);
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} PREFLIGHT FAILED - Layout shift patterns detected`);
+        console.log("\nTo fix:");
+        console.log("  1. Replace inline {message && <Alert>} with useStatus().success(message)");
+        console.log("  2. Use fixed-position toasts for success/error feedback");
+        console.log("  3. Reserve space with min-h-* if conditional content is required");
+        console.log("\nExample fix:");
+        console.log("  // Before (causes shift):");
+        console.log("  {message && <Alert>{message}</Alert>}");
+        console.log("");
+        console.log("  // After (no shift):");
+        console.log("  const { success } = useStatus();");
+        console.log("  success(message);");
+        process.exit(1);
+    }
+    else {
+        console.log(`\n${console_chars_1.emoji.success} Layout shift detection passed!`);
+    }
+}
+function deduplicateIssues(issues) {
+    const seen = new Set();
+    return issues.filter((issue) => {
+        const key = `${issue.file}:${issue.line}:${issue.rule}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+checkLayoutShift().catch((err) => {
+    console.error("Preflight error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=layout-shift-detection.js.map

package/dist/checks/ui/layout-shift-detection.js.map

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

package/dist/checks/ui/margin-in-gap-container.d.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env tsx
+/**
+ * Margin in Gap Container Preflight - IRON-CLAD ENFORCEMENT
+ *
+ * RULE: Elements inside Stack/flex-gap containers must NOT have margin.
+ * The container's gap handles spacing - adding margin creates inconsistent spacing.
+ *
+ * Detects:
+ * - Tailwind margin classes (mb-4, mt-3, my-2)
+ * - Inline style margins (style={{ marginBottom: "..." }})
+ * - Multi-line style objects with margin properties
+ * - CSS module classes that contain margin (via static analysis)
+ * - Style variables that contain margin values
+ *
+ * Usage:
+ *   pnpm preflight:margin-in-gap
+ *   pnpm preflight:margin-in-gap --verbose
+ */
+export declare const id = "ui/margin-in-gap-container";
+export declare const name = "Margin In Gap Container";
+export declare const category = "ui";
+export declare const blocking = false;
+export declare const description = "Margin in Gap Container Preflight - IRON-CLAD ENFORCEMENT";
+export declare const tags: string[];
+//# sourceMappingURL=margin-in-gap-container.d.ts.map

package/dist/checks/ui/margin-in-gap-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"margin-in-gap-container.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/margin-in-gap-container.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAUH,eAAO,MAAM,EAAE,+BAA+B,CAAC;AAC/C,eAAO,MAAM,IAAI,4BAA4B,CAAC;AAC9C,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,8DAA8D,CAAC;AACvF,eAAO,MAAM,IAAI,UAAS,CAAC"}