@empline/preflight 1.1.4 → 1.1.5

package/dist/checks/tailwind/undefined-tailwind-utilities.d.ts

@@ -0,0 +1,29 @@
+#!/usr/bin/env tsx
+/**
+ * Undefined Tailwind Utilities Preflight (BLOCKING)
+ *
+ * Detects Tailwind utility classes that reference undefined CSS variables.
+ * This prevents invisible UI elements caused by missing theme tokens.
+ *
+ * Common issue detected:
+ * - `bg-background` used when theme defines `--bg-primary` instead of `--background`
+ * - Other utility classes that expect shadcn-style CSS variables
+ *
+ * Why this matters:
+ * - Using undefined CSS variables results in invisible elements
+ * - Components may appear broken (e.g., toggle thumbs not visible)
+ * - These issues are hard to detect visually until specific states are reached
+ *
+ * Usage:
+ *   pnpm preflight:undefined-tailwind-utilities
+ *   pnpm preflight:undefined-tailwind-utilities --verbose
+ */
+export declare const id = "tailwind/undefined-tailwind-utilities";
+export declare const name = "Undefined Tailwind Utilities";
+export declare const category = "tailwind";
+export declare const blocking = true;
+export declare const description = "Detects Tailwind classes using undefined CSS variables (BLOCKING)";
+export declare const tags: string[];
+export declare const requires: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=undefined-tailwind-utilities.d.ts.map

package/dist/checks/tailwind/undefined-tailwind-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undefined-tailwind-utilities.d.ts","sourceRoot":"","sources":["../../../src/checks/tailwind/undefined-tailwind-utilities.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG;AASH,eAAO,MAAM,EAAE,0CAA0C,CAAC;AAC1D,eAAO,MAAM,IAAI,iCAAiC,CAAC;AACnD,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,sEAAsE,CAAC;AAC/F,eAAO,MAAM,IAAI,UAAiD,CAAC;AACnE,eAAO,MAAM,QAAQ,UAAkB,CAAC;AAoLxC,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAuHzC"}

package/dist/checks/tailwind/undefined-tailwind-utilities.js

@@ -0,0 +1,337 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Undefined Tailwind Utilities Preflight (BLOCKING)
+ *
+ * Detects Tailwind utility classes that reference undefined CSS variables.
+ * This prevents invisible UI elements caused by missing theme tokens.
+ *
+ * Common issue detected:
+ * - `bg-background` used when theme defines `--bg-primary` instead of `--background`
+ * - Other utility classes that expect shadcn-style CSS variables
+ *
+ * Why this matters:
+ * - Using undefined CSS variables results in invisible elements
+ * - Components may appear broken (e.g., toggle thumbs not visible)
+ * - These issues are hard to detect visually until specific states are reached
+ *
+ * Usage:
+ *   pnpm preflight:undefined-tailwind-utilities
+ *   pnpm preflight:undefined-tailwind-utilities --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.requires = exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const file_cache_1 = require("../../shared/file-cache");
+const glob_patterns_1 = require("../../shared/glob-patterns");
+const console_chars_1 = require("../../utils/console-chars");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "tailwind/undefined-tailwind-utilities";
+exports.name = "Undefined Tailwind Utilities";
+exports.category = "tailwind";
+exports.blocking = true;
+exports.description = "Detects Tailwind classes using undefined CSS variables (BLOCKING)";
+exports.tags = ["tailwind", "css-variables", "theming", "ui"];
+exports.requires = ["tailwindcss"];
+const EXCLUDED = (0, glob_patterns_1.extendExcludes)(glob_patterns_1.STANDARD_EXCLUDES, [
+    "**/test-results/**",
+    "**/*.test.tsx",
+    "**/*.spec.tsx",
+    "**/*.stories.tsx",
+]);
+/**
+ * Tailwind utility classes that rely on CSS variables not defined in our theme.
+ * These often come from copying shadcn/ui components that expect different variable names.
+ *
+ * Patterns use (?:\/\d+)? to optionally match opacity modifiers like /20, /50, etc.
+ *
+ * Format: { pattern, name, message, suggestion, severity }
+ */
+const UNDEFINED_UTILITIES = [
+    {
+        // shadcn expects --background, we use --bg-primary
+        pattern: /\bbg-background(?:\/\d+)?\b/g,
+        name: "bg-background",
+        message: "bg-background uses undefined --background CSS variable",
+        suggestion: "Use bg-white, bg-[var(--bg-primary)], or appropriate color class",
+        severity: "error",
+    },
+    {
+        // shadcn expects --foreground, we use --text-primary
+        pattern: /\btext-foreground(?:\/\d+)?\b/g,
+        name: "text-foreground",
+        message: "text-foreground uses undefined --foreground CSS variable",
+        suggestion: "Use text-[var(--text-primary)] or appropriate color class",
+        severity: "error",
+    },
+    {
+        // shadcn expects --muted, we use --text-secondary or --bg-tertiary
+        // Matches: bg-muted, bg-muted/20, bg-muted/50, etc.
+        pattern: /\bbg-muted(?:\/\d+)?\b/g,
+        name: "bg-muted",
+        message: "bg-muted uses undefined --muted CSS variable",
+        suggestion: "Use bg-[var(--bg-tertiary)] or bg-[var(--bg-tertiary)]/20 for opacity",
+        severity: "error",
+    },
+    {
+        // Matches: text-muted-foreground, text-muted-foreground/70, etc.
+        pattern: /\btext-muted-foreground(?:\/\d+)?\b/g,
+        name: "text-muted-foreground",
+        message: "text-muted-foreground uses undefined --muted-foreground CSS variable",
+        suggestion: "Use text-[var(--text-secondary)] or text-[var(--text-secondary)]/70 for opacity",
+        severity: "error",
+    },
+    {
+        // shadcn expects --card, we use --bg-primary
+        pattern: /\bbg-card(?:\/\d+)?\b/g,
+        name: "bg-card",
+        message: "bg-card uses undefined --card CSS variable",
+        suggestion: "Use bg-[var(--bg-primary)] or appropriate color class",
+        severity: "error",
+    },
+    {
+        // shadcn expects --popover
+        pattern: /\bbg-popover(?:\/\d+)?\b/g,
+        name: "bg-popover",
+        message: "bg-popover uses undefined --popover CSS variable",
+        suggestion: "Use bg-[var(--bg-primary)] or bg-white for popover backgrounds",
+        severity: "error",
+    },
+    {
+        // shadcn expects --accent
+        pattern: /\bbg-accent(?:\/\d+)?\b/g,
+        name: "bg-accent",
+        message: "bg-accent uses undefined --accent CSS variable",
+        suggestion: "Use bg-[var(--color-primary-light)] or appropriate accent color",
+        severity: "warning",
+    },
+    {
+        pattern: /\btext-accent-foreground(?:\/\d+)?\b/g,
+        name: "text-accent-foreground",
+        message: "text-accent-foreground uses undefined --accent-foreground CSS variable",
+        suggestion: "Use text-[var(--color-primary)] or appropriate color class",
+        severity: "warning",
+    },
+    {
+        // shadcn expects --border, we use --border-color
+        pattern: /\bborder-border(?:\/\d+)?\b/g,
+        name: "border-border",
+        message: "border-border uses undefined --border CSS variable",
+        suggestion: "Use border-[var(--border-color)] instead",
+        severity: "error",
+    },
+    {
+        // shadcn expects --input
+        pattern: /\bbg-input(?:\/\d+)?\b/g,
+        name: "bg-input",
+        message: "bg-input uses undefined --input CSS variable",
+        suggestion: "Use bg-[var(--bg-secondary)] or bg-white for input backgrounds",
+        severity: "warning",
+    },
+    {
+        // shadcn expects --ring
+        pattern: /\bring-ring(?:\/\d+)?\b/g,
+        name: "ring-ring",
+        message: "ring-ring uses undefined --ring CSS variable",
+        suggestion: "Use ring-[var(--color-primary)] for focus rings",
+        severity: "warning",
+    },
+    {
+        // shadcn expects --destructive
+        pattern: /\bbg-destructive(?:\/\d+)?\b/g,
+        name: "bg-destructive",
+        message: "bg-destructive uses undefined --destructive CSS variable",
+        suggestion: "Use bg-[var(--error-main)] for destructive/error backgrounds",
+        severity: "warning",
+    },
+    {
+        pattern: /\btext-destructive(?:\/\d+)?\b/g,
+        name: "text-destructive",
+        message: "text-destructive uses undefined --destructive CSS variable",
+        suggestion: "Use text-[var(--error-main)] for error text",
+        severity: "warning",
+    },
+];
+function checkFile(filePath, content) {
+    const issues = [];
+    const lines = content.split("\n");
+    for (const utility of UNDEFINED_UTILITIES) {
+        let match;
+        // Reset lastIndex for global regex
+        utility.pattern.lastIndex = 0;
+        while ((match = utility.pattern.exec(content)) !== null) {
+            // Find line number
+            let lineNumber = 1;
+            let charCount = 0;
+            for (let i = 0; i < lines.length; i++) {
+                charCount += lines[i].length + 1;
+                if (charCount > match.index) {
+                    lineNumber = i + 1;
+                    break;
+                }
+            }
+            issues.push({
+                file: filePath,
+                line: lineNumber,
+                type: utility.name,
+                severity: utility.severity,
+                message: utility.message,
+                suggestion: utility.suggestion,
+                snippet: lines[lineNumber - 1]?.trim().substring(0, 100),
+                match: match[0],
+            });
+        }
+    }
+    return issues;
+}
+// CACHED FILE LISTS
+let _cachedComponentFiles = null;
+async function getComponentFiles() {
+    if (!_cachedComponentFiles) {
+        _cachedComponentFiles = await file_cache_1.fileCache.getComponentFiles();
+    }
+    return _cachedComponentFiles;
+}
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    const args = process.argv.slice(2);
+    const verbose = args.includes("--verbose") || args.includes("-v");
+    const warnOnly = args.includes("--warn") || args.includes("-w");
+    console.log(`\n${console_chars_1.emoji.palette} Undefined Tailwind Utilities Preflight`);
+    console.log((0, console_chars_1.createDivider)(80, "heavy"));
+    if (warnOnly) {
+        console.log(`${console_chars_1.emoji.warning}  Running in warning mode - not blocking.\n`);
+    }
+    const startTime = Date.now();
+    const allIssues = [];
+    // Find all component files
+    const files = await getComponentFiles();
+    let filesScanned = 0;
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(file, "utf-8");
+            filesScanned++;
+            allIssues.push(...checkFile(file, content));
+        }
+        catch (error) {
+            if (verbose) {
+                console.error(`${console_chars_1.emoji.warning}  Error reading ${file}: ${error.message}`);
+            }
+        }
+    }
+    const duration = Date.now() - startTime;
+    // Report results
+    console.log(`\n${console_chars_1.emoji.chart} Scan Summary:`);
+    console.log(`   Files scanned: ${filesScanned}`);
+    console.log(`   Duration: ${duration}ms`);
+    const errors = allIssues.filter((i) => i.severity === "error");
+    const warnings = allIssues.filter((i) => i.severity === "warning");
+    const infos = allIssues.filter((i) => i.severity === "info");
+    if (allIssues.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} No undefined Tailwind utility classes found`);
+        console.log(`   All CSS variable references are valid.`);
+        process.exit(0);
+    }
+    // Group by type
+    const byType = new Map();
+    for (const issue of allIssues) {
+        const existing = byType.get(issue.type) || [];
+        existing.push(issue);
+        byType.set(issue.type, existing);
+    }
+    console.log(`\n${console_chars_1.emoji.clipboard} Issues Found:`);
+    console.log(`   ${console_chars_1.emoji.error} Errors: ${errors.length}`);
+    console.log(`   ${console_chars_1.emoji.warning}  Warnings: ${warnings.length}`);
+    console.log(`   ${console_chars_1.emoji.info}  Info: ${infos.length}`);
+    // Print issues by type
+    for (const [type, issues] of byType) {
+        const icon = issues[0].severity === "error"
+            ? `${console_chars_1.emoji.error}`
+            : issues[0].severity === "warning"
+                ? `${console_chars_1.emoji.warning}`
+                : `${console_chars_1.emoji.info}`;
+        console.log(`\n${icon} ${type} (${issues.length} occurrences)`);
+        if (verbose) {
+            for (const issue of issues.slice(0, 5)) {
+                console.log(`   ${issue.file}:${issue.line}`);
+                console.log(`   ${issue.message}`);
+                console.log(`   ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+                if (issue.snippet) {
+                    console.log(`   ${console_chars_1.emoji.memo} ${issue.snippet}`);
+                }
+                console.log("");
+            }
+            if (issues.length > 5) {
+                console.log(`   ... and ${issues.length - 5} more`);
+            }
+        }
+        else {
+            console.log(`   ${issues[0].message}`);
+            console.log(`   ${console_chars_1.emoji.hint} ${issues[0].suggestion}`);
+        }
+    }
+    // Print background info
+    console.log(`\n${console_chars_1.emoji.docs} Background:`);
+    console.log(`   This project uses custom CSS variable names (--bg-primary,`);
+    console.log(`   --text-primary, etc.) instead of shadcn defaults (--background,`);
+    console.log(`   --foreground, etc.). Using shadcn-style classes results in`);
+    console.log(`   undefined colors and invisible UI elements.`);
+    console.log("");
+    console.log(`${console_chars_1.emoji.hint} Common fixes:`);
+    console.log(`   • bg-background   → bg-white or bg-[var(--bg-primary)]`);
+    console.log(`   • text-foreground → text-[var(--text-primary)]`);
+    console.log(`   • bg-muted        → bg-[var(--bg-tertiary)]`);
+    console.log(`   • border-border   → border-[var(--border-color)]`);
+    // Exit code
+    if (warnOnly) {
+        console.log(`\n${console_chars_1.emoji.warning}  Running in warning mode - not blocking`);
+        process.exit(0);
+    }
+    if (errors.length > 0) {
+        console.log(`\n⛔ ${errors.length} blocking issue(s) found. Fix before deploying.`);
+        console.log(`   These will cause invisible or broken UI elements.`);
+        process.exit(1);
+    }
+    console.log(`\n${console_chars_1.emoji.success} No blocking issues (warnings/info only)`);
+    process.exit(0);
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=undefined-tailwind-utilities.js.map

package/dist/checks/tailwind/undefined-tailwind-utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"undefined-tailwind-utilities.js","sourceRoot":"","sources":["../../../src/checks/tailwind/undefined-tailwind-utilities.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;;;;;;;GAkBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmMH,kBAuHC;AAxTD,uCAAyB;AACzB,wDAAoD;AACpD,8DAA+E;AAC/E,6DAAiE;AACjE,uFAAwF;AAExF,iBAAiB;AACJ,QAAA,EAAE,GAAG,uCAAuC,CAAC;AAC7C,QAAA,IAAI,GAAG,8BAA8B,CAAC;AACtC,QAAA,QAAQ,GAAG,UAAU,CAAC;AACtB,QAAA,QAAQ,GAAG,IAAI,CAAC;AAChB,QAAA,WAAW,GAAG,mEAAmE,CAAC;AAClF,QAAA,IAAI,GAAG,CAAC,UAAU,EAAE,eAAe,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AACtD,QAAA,QAAQ,GAAG,CAAC,aAAa,CAAC,CAAC;AAaxC,MAAM,QAAQ,GAAG,IAAA,8BAAc,EAAC,iCAAiB,EAAE;IACjD,oBAAoB;IACpB,eAAe;IACf,eAAe;IACf,kBAAkB;CACnB,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,mBAAmB,GAAG;IAC1B;QACE,mDAAmD;QACnD,OAAO,EAAE,8BAA8B;QACvC,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,wDAAwD;QACjE,UAAU,EAAE,kEAAkE;QAC9E,QAAQ,EAAE,OAAgB;KAC3B;IACD;QACE,qDAAqD;QACrD,OAAO,EAAE,gCAAgC;QACzC,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,0DAA0D;QACnE,UAAU,EAAE,2DAA2D;QACvE,QAAQ,EAAE,OAAgB;KAC3B;IACD;QACE,mEAAmE;QACnE,oDAAoD;QACpD,OAAO,EAAE,yBAAyB;QAClC,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,8CAA8C;QACvD,UAAU,EAAE,uEAAuE;QACnF,QAAQ,EAAE,OAAgB;KAC3B;IACD;QACE,iEAAiE;QACjE,OAAO,EAAE,sCAAsC;QAC/C,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,sEAAsE;QAC/E,UAAU,EAAE,iFAAiF;QAC7F,QAAQ,EAAE,OAAgB;KAC3B;IACD;QACE,6CAA6C;QAC7C,OAAO,EAAE,wBAAwB;QACjC,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,4CAA4C;QACrD,UAAU,EAAE,uDAAuD;QACnE,QAAQ,EAAE,OAAgB;KAC3B;IACD;QACE,2BAA2B;QAC3B,OAAO,EAAE,2BAA2B;QACpC,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,kDAAkD;QAC3D,UAAU,EAAE,gEAAgE;QAC5E,QAAQ,EAAE,OAAgB;KAC3B;IACD;QACE,0BAA0B;QAC1B,OAAO,EAAE,0BAA0B;QACnC,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,gDAAgD;QACzD,UAAU,EAAE,iEAAiE;QAC7E,QAAQ,EAAE,SAAkB;KAC7B;IACD;QACE,OAAO,EAAE,uCAAuC;QAChD,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,wEAAwE;QACjF,UAAU,EAAE,4DAA4D;QACxE,QAAQ,EAAE,SAAkB;KAC7B;IACD;QACE,iDAAiD;QACjD,OAAO,EAAE,8BAA8B;QACvC,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,oDAAoD;QAC7D,UAAU,EAAE,0CAA0C;QACtD,QAAQ,EAAE,OAAgB;KAC3B;IACD;QACE,yBAAyB;QACzB,OAAO,EAAE,yBAAyB;QAClC,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,8CAA8C;QACvD,UAAU,EAAE,gEAAgE;QAC5E,QAAQ,EAAE,SAAkB;KAC7B;IACD;QACE,wBAAwB;QACxB,OAAO,EAAE,0BAA0B;QACnC,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,8CAA8C;QACvD,UAAU,EAAE,iDAAiD;QAC7D,QAAQ,EAAE,SAAkB;KAC7B;IACD;QACE,+BAA+B;QAC/B,OAAO,EAAE,+BAA+B;QACxC,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,0DAA0D;QACnE,UAAU,EAAE,8DAA8D;QAC1E,QAAQ,EAAE,SAAkB;KAC7B;IACD;QACE,OAAO,EAAE,iCAAiC;QAC1C,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,4DAA4D;QACrE,UAAU,EAAE,6CAA6C;QACzD,QAAQ,EAAE,SAAkB;KAC7B;CACF,CAAC;AAEF,SAAS,SAAS,CAAC,QAAgB,EAAE,OAAe;IAClD,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,KAAK,MAAM,OAAO,IAAI,mBAAmB,EAAE,CAAC;QAC1C,IAAI,KAAK,CAAC;QACV,mCAAmC;QACnC,OAAO,CAAC,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;QAE9B,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACxD,mBAAmB;YACnB,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,IAAI,SAAS,GAAG,CAAC,CAAC;YAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;gBACjC,IAAI,SAAS,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;oBAC5B,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC;oBACnB,MAAM;gBACR,CAAC;YACH,CAAC;YAED,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,OAAO,EAAE,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;gBACxD,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,oBAAoB;AACpB,IAAI,qBAAqB,GAAoB,IAAI,CAAC;AAClD,KAAK,UAAU,iBAAiB;IAC9B,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC3B,qBAAqB,GAAG,MAAM,sBAAS,CAAC,iBAAiB,EAAE,CAAC;IAC9D,CAAC;IACD,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAEM,KAAK,UAAU,GAAG;IACvB,MAAM,QAAQ,GAAG,IAAA,6DAA+B,EAAC,YAAI,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEhE,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,yCAAyC,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAExC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,OAAO,6CAA6C,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAY,EAAE,CAAC;IAE9B,2BAA2B;IAC3B,MAAM,KAAK,GAAG,MAAM,iBAAiB,EAAE,CAAC;IACxC,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC/C,YAAY,EAAE,CAAC;YAEf,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,KAAK,CAAC,GAAG,qBAAK,CAAC,OAAO,mBAAmB,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAExC,iBAAiB;IACjB,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,KAAK,gBAAgB,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,qBAAqB,YAAY,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,gBAAgB,QAAQ,IAAI,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC;IAE7D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,8CAA8C,CAAC,CAAC;QAC9E,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,gBAAgB;IAChB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9C,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,SAAS,gBAAgB,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,MAAM,qBAAK,CAAC,KAAK,YAAY,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,MAAM,qBAAK,CAAC,OAAO,eAAe,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,MAAM,qBAAK,CAAC,IAAI,WAAW,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAEvD,uBAAuB;IACvB,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACpC,MAAM,IAAI,GACR,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO;YAC5B,CAAC,CAAC,GAAG,qBAAK,CAAC,KAAK,EAAE;YAClB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS;gBAChC,CAAC,CAAC,GAAG,qBAAK,CAAC,OAAO,EAAE;gBACpB,CAAC,CAAC,GAAG,qBAAK,CAAC,IAAI,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,IAAI,KAAK,MAAM,CAAC,MAAM,eAAe,CAAC,CAAC;QAEhE,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACvC,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC9C,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACnC,OAAO,CAAC,GAAG,CAAC,MAAM,qBAAK,CAAC,IAAI,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;gBACpD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oBAClB,OAAO,CAAC,GAAG,CAAC,MAAM,qBAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACnD,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClB,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YACvC,OAAO,CAAC,GAAG,CAAC,MAAM,qBAAK,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,IAAI,cAAc,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,IAAI,gBAAgB,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IAEnE,YAAY;IACZ,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,0CAA0C,CAAC,CAAC;QAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,OAAO,MAAM,CAAC,MAAM,iDAAiD,CAAC,CAAC;QACnF,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,0CAA0C,CAAC,CAAC;IAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,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/turbopack/map-closure-safety.d.ts

@@ -0,0 +1,37 @@
+#!/usr/bin/env tsx
+/**
+ * Turbopack Map Closure Safety Preflight (BLOCKING)
+ *
+ * Detects patterns that cause Turbopack closure bugs where property access
+ * on mapped items gets mangled (e.g., `product.stock_quantity` becomes
+ * `_product_stock_quantity` and fails at runtime).
+ *
+ * Problem Pattern:
+ *   {items.map((item) => (
+ *     <div>{item.property}</div>  // Turbopack may mangle this
+ *   ))}
+ *
+ * Safe Pattern:
+ *   {items.map((item) => {
+ *     const property = item.property;  // Extract first
+ *     return <div>{property}</div>;    // Use local variable
+ *   })}
+ *
+ * Why this matters:
+ * - Turbopack's minification can break closure scope for mapped items
+ * - Results in runtime ReferenceError: _item_property is not defined
+ * - Only happens in development with Turbopack, not in production builds
+ *
+ * Usage:
+ *   pnpm preflight:turbopack-map-closure
+ *   pnpm preflight:turbopack-map-closure --verbose
+ */
+export declare const id = "turbopack/map-closure-safety";
+export declare const name = "Turbopack Map Closure Safety";
+export declare const category = "turbopack";
+export declare const blocking = false;
+export declare const description = "Detects map callbacks that may cause Turbopack closure bugs";
+export declare const tags: string[];
+export declare const requires: any[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=map-closure-safety.d.ts.map

package/dist/checks/turbopack/map-closure-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-closure-safety.d.ts","sourceRoot":"","sources":["../../../src/checks/turbopack/map-closure-safety.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AASH,eAAO,MAAM,EAAE,iCAAiC,CAAC;AACjD,eAAO,MAAM,IAAI,iCAAiC,CAAC;AACnD,eAAO,MAAM,QAAQ,cAAc,CAAC;AACpC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,gEAAgE,CAAC;AACzF,eAAO,MAAM,IAAI,UAA6C,CAAC;AAC/D,eAAO,MAAM,QAAQ,OAAK,CAAC;AAuH3B,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAsGzC"}

package/dist/checks/turbopack/map-closure-safety.js

@@ -0,0 +1,261 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Turbopack Map Closure Safety Preflight (BLOCKING)
+ *
+ * Detects patterns that cause Turbopack closure bugs where property access
+ * on mapped items gets mangled (e.g., `product.stock_quantity` becomes
+ * `_product_stock_quantity` and fails at runtime).
+ *
+ * Problem Pattern:
+ *   {items.map((item) => (
+ *     <div>{item.property}</div>  // Turbopack may mangle this
+ *   ))}
+ *
+ * Safe Pattern:
+ *   {items.map((item) => {
+ *     const property = item.property;  // Extract first
+ *     return <div>{property}</div>;    // Use local variable
+ *   })}
+ *
+ * Why this matters:
+ * - Turbopack's minification can break closure scope for mapped items
+ * - Results in runtime ReferenceError: _item_property is not defined
+ * - Only happens in development with Turbopack, not in production builds
+ *
+ * Usage:
+ *   pnpm preflight:turbopack-map-closure
+ *   pnpm preflight:turbopack-map-closure --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.requires = exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const file_cache_1 = require("../../shared/file-cache");
+const glob_patterns_1 = require("../../shared/glob-patterns");
+const console_chars_1 = require("../../utils/console-chars");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "turbopack/map-closure-safety";
+exports.name = "Turbopack Map Closure Safety";
+exports.category = "turbopack";
+exports.blocking = false; // Warning for now, can be elevated
+exports.description = "Detects map callbacks that may cause Turbopack closure bugs";
+exports.tags = ["turbopack", "runtime", "closure", "map"];
+exports.requires = [];
+const EXCLUDED = (0, glob_patterns_1.extendExcludes)(glob_patterns_1.STANDARD_EXCLUDES, [
+    "**/test-results/**",
+    "**/*.test.tsx",
+    "**/*.spec.tsx",
+    "**/*.stories.tsx",
+]);
+/**
+ * Detects risky patterns in .map() callbacks where:
+ * 1. The callback uses parentheses (implicit return) instead of braces
+ * 2. Multiple property accesses on the mapped item in JSX
+ *
+ * These patterns are prone to Turbopack closure issues.
+ */
+function checkFile(filePath, content) {
+    const issues = [];
+    const lines = content.split("\n");
+    // Pattern: .map((paramName) => (
+    // This is the risky implicit return pattern
+    const mapImplicitReturnPattern = /\.map\s*\(\s*\((\w+)\)\s*=>\s*\(/g;
+    let match;
+    while ((match = mapImplicitReturnPattern.exec(content)) !== null) {
+        const paramName = match[1];
+        const mapStartIndex = match.index;
+        // Find the line number
+        let lineNumber = 1;
+        let charCount = 0;
+        for (let i = 0; i < lines.length; i++) {
+            charCount += lines[i].length + 1;
+            if (charCount > mapStartIndex) {
+                lineNumber = i + 1;
+                break;
+            }
+        }
+        // Look ahead to find property accesses on the param in JSX
+        // We'll check the next ~50 lines or until we find the closing
+        const searchEndIndex = Math.min(content.length, mapStartIndex + 5000);
+        const mapBlock = content.substring(mapStartIndex, searchEndIndex);
+        // Count property accesses on the mapped item
+        // Pattern: paramName.property (where property contains underscore - common DB fields)
+        const propertyAccessPattern = new RegExp(`\\b${paramName}\\.(\\w+_\\w+|stock_quantity|linked\\w+|created\\w+|updated\\w+)`, "g");
+        const propertyMatches = mapBlock.match(propertyAccessPattern) || [];
+        // If we find properties with underscores being accessed directly, it's risky
+        if (propertyMatches.length >= 2) {
+            issues.push({
+                file: filePath,
+                line: lineNumber,
+                severity: "warning",
+                message: `Map callback with implicit return accesses ${propertyMatches.length} underscore properties on '${paramName}'`,
+                suggestion: `Convert to block syntax { } and extract properties: const ${paramName}Prop = ${paramName}.prop;`,
+                snippet: lines[lineNumber - 1]?.trim().substring(0, 80),
+                paramName,
+            });
+        }
+    }
+    // Also check for the dangerous pattern of nested property access in JSX
+    // Pattern: {item.foo.bar} or {item.prop ?? "default"} inside map
+    const nestedPropertyInMapPattern = /\.map\s*\(\s*\((\w+)\)\s*=>\s*[^{]*\{\s*\1\.[\w.]+\s*(?:\?\?|&&|\|\|)/g;
+    while ((match = nestedPropertyInMapPattern.exec(content)) !== null) {
+        const paramName = match[1];
+        const mapStartIndex = match.index;
+        let lineNumber = 1;
+        let charCount = 0;
+        for (let i = 0; i < lines.length; i++) {
+            charCount += lines[i].length + 1;
+            if (charCount > mapStartIndex) {
+                lineNumber = i + 1;
+                break;
+            }
+        }
+        issues.push({
+            file: filePath,
+            line: lineNumber,
+            severity: "info",
+            message: `Nullish coalescing/logical operators on mapped item '${paramName}' in JSX`,
+            suggestion: `Consider extracting: const value = ${paramName}.prop ?? default; before JSX`,
+            snippet: lines[lineNumber - 1]?.trim().substring(0, 80),
+            paramName,
+        });
+    }
+    return issues;
+}
+// CACHED FILE LISTS
+let _cachedComponentFiles = null;
+async function getComponentFiles() {
+    if (!_cachedComponentFiles) {
+        _cachedComponentFiles = await file_cache_1.fileCache.getComponentFiles();
+    }
+    return _cachedComponentFiles;
+}
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    const args = process.argv.slice(2);
+    const verbose = args.includes("--verbose") || args.includes("-v");
+    const strict = args.includes("--strict") || args.includes("-s");
+    console.log(`\n${console_chars_1.emoji.palette} Turbopack Map Closure Safety Preflight`);
+    console.log((0, console_chars_1.createDivider)(80, "heavy"));
+    const startTime = Date.now();
+    const allIssues = [];
+    // Find all component files
+    const files = await getComponentFiles();
+    let filesScanned = 0;
+    for (const file of files) {
+        // Only check TSX files (JSX components)
+        if (!file.endsWith(".tsx"))
+            continue;
+        try {
+            const content = fs.readFileSync(file, "utf-8");
+            filesScanned++;
+            allIssues.push(...checkFile(file, content));
+        }
+        catch (error) {
+            if (verbose) {
+                console.error(`${console_chars_1.emoji.warning}  Error reading ${file}: ${error.message}`);
+            }
+        }
+    }
+    const duration = Date.now() - startTime;
+    // Report results
+    console.log(`\n${console_chars_1.emoji.chart} Scan Summary:`);
+    console.log(`   Files scanned: ${filesScanned}`);
+    console.log(`   Duration: ${duration}ms`);
+    const warnings = allIssues.filter((i) => i.severity === "warning");
+    const infos = allIssues.filter((i) => i.severity === "info");
+    if (allIssues.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} No risky map closure patterns detected`);
+        console.log(`   All mapped item property accesses appear safe.`);
+        process.exit(0);
+    }
+    console.log(`\n${console_chars_1.emoji.clipboard} Issues Found:`);
+    console.log(`   ${console_chars_1.emoji.warning}  Warnings: ${warnings.length}`);
+    console.log(`   ${console_chars_1.emoji.info}  Info: ${infos.length}`);
+    if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning}  WARNINGS (may cause Turbopack runtime errors):`);
+        console.log((0, console_chars_1.createDivider)(60, "light"));
+        for (const issue of warnings.slice(0, verbose ? 20 : 5)) {
+            console.log(`   ${issue.file}:${issue.line}`);
+            console.log(`   ${issue.message}`);
+            console.log(`   ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+            if (issue.snippet) {
+                console.log(`   ${console_chars_1.emoji.memo} ${issue.snippet}`);
+            }
+            console.log("");
+        }
+        if (warnings.length > (verbose ? 20 : 5)) {
+            console.log(`   ... and ${warnings.length - (verbose ? 20 : 5)} more`);
+        }
+    }
+    if (verbose && infos.length > 0) {
+        console.log(`\n${console_chars_1.emoji.info}  INFO:`);
+        console.log((0, console_chars_1.createDivider)(60, "light"));
+        for (const issue of infos.slice(0, 10)) {
+            console.log(`   ${issue.file}:${issue.line}`);
+            console.log(`   ${issue.message}`);
+            console.log("");
+        }
+    }
+    // Print fix guidance
+    console.log(`\n${console_chars_1.emoji.docs} How to fix:`);
+    console.log(`   Convert implicit return map callbacks to block syntax:`);
+    console.log("");
+    console.log(`   // BEFORE (risky):`);
+    console.log(`   {items.map((item) => (`);
+    console.log(`     <div>{item.stock_quantity}</div>`);
+    console.log(`   ))}`);
+    console.log("");
+    console.log(`   // AFTER (safe):`);
+    console.log(`   {items.map((item) => {`);
+    console.log(`     const stockQuantity = item.stock_quantity;`);
+    console.log(`     return <div>{stockQuantity}</div>;`);
+    console.log(`   })}`);
+    // Exit code
+    if (strict && warnings.length > 0) {
+        console.log(`\n⛔ ${warnings.length} warning(s) found in strict mode.`);
+        process.exit(1);
+    }
+    console.log(`\n${console_chars_1.emoji.success} Preflight complete (warnings only, not blocking)`);
+    process.exit(0);
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=map-closure-safety.js.map

package/dist/checks/turbopack/map-closure-safety.js.map

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

package/dist/core/categories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/core/categories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA6BnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,UAAoD,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAAc,EA6D5C,CAAC;AAEF;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAc7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC"}
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/core/categories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA+CnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,UAAoD,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAAc,EA2F5C,CAAC;AAEF;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAc7E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC"}

package/dist/core/categories.js

@@ -40,6 +40,18 @@ exports.CATEGORY_FILTERS = {
     seo: "SEO|Hardcoded URLs|Missing Metadata",
     // Framework compatibility
     framework: "Compatibility|Next\\.js|Prisma|React|Zod|TanStack|Tailwind",
+    // System/infrastructure checks
+    system: "Script Path|Orphaned Script|Preflight|System|Broken|Validation|Sync Check",
+    // Turbopack-specific checks
+    turbopack: "Turbopack|Map Closure|Zod Turbopack",
+    // Card processing (trading card system)
+    "card-processing": "Card|Dimension|Edge Detection|Front.Back|Deskew|Image Processing|Filename",
+    // Data integrity
+    data: "Constants|Crockford|Geographic|Hardcoded Options|Product Slug|Schema|FK Defaults|League Data",
+    // Integration platform checks
+    integrations: "Integration|Platform Feed|WooCommerce|Amazon|eBay|Etsy|Walmart|TikTok|Whatnot|Shopify",
+    // AI/ML checks
+    ai: "Recognition Pipeline|Series Subset|AI|ML",
 };
 /**
  * Quick mode categories - runs only fast, critical checks
@@ -109,6 +121,36 @@ exports.CATEGORY_CONFIGS = [
         pattern: exports.CATEGORY_FILTERS.framework,
         description: "Framework compatibility: Next.js, React, Prisma",
     },
+    {
+        name: "system",
+        pattern: exports.CATEGORY_FILTERS.system,
+        description: "System checks: script paths, orphaned files, preflight health",
+    },
+    {
+        name: "turbopack",
+        pattern: exports.CATEGORY_FILTERS.turbopack,
+        description: "Turbopack-specific: closure safety, Zod ESM compatibility",
+    },
+    {
+        name: "card-processing",
+        pattern: exports.CATEGORY_FILTERS["card-processing"],
+        description: "Card processing: dimensions, edge detection, image processing",
+    },
+    {
+        name: "data",
+        pattern: exports.CATEGORY_FILTERS.data,
+        description: "Data integrity: constants, geographic, schema validation",
+    },
+    {
+        name: "integrations",
+        pattern: exports.CATEGORY_FILTERS.integrations,
+        description: "Integration platforms: eBay, Amazon, Etsy, WooCommerce, etc.",
+    },
+    {
+        name: "ai",
+        pattern: exports.CATEGORY_FILTERS.ai,
+        description: "AI/ML checks: recognition pipeline, series hierarchy",
+    },
 ];
 /**
  * Build filter regex from category names

package/dist/core/categories.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@empline/preflight",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "description": "Distributable preflight validation system with app-specific plugin support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",