@empline/preflight 1.1.3 → 1.1.5

package/dist/checks/data/schema-fk-defaults-validation.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * Schema FK Defaults Validation Preflight
+ *
+ * Ensures Prisma schema @default values for foreign key fields match
+ * the IDs in seed data. Prevents FK constraint violations at runtime.
+ *
+ * Example issue this catches:
+ *   Schema: language String @default("ENGLISH")  <- uppercase
+ *   Seed:   { id: "english", ... }               <- lowercase
+ *   Result: FK constraint violation at runtime (P2003)
+ *
+ * Run: pnpm preflight:schema-fk-defaults
+ */
+export declare const id = "data/schema-fk-defaults-validation";
+export declare const name = "Schema FK Defaults Validation";
+export declare const description = "Ensures schema defaults match seed data for FK fields";
+export declare const category = "data";
+export declare const blocking = true;
+export declare const tags: string[];
+//# sourceMappingURL=schema-fk-defaults-validation.d.ts.map

package/dist/checks/data/schema-fk-defaults-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-fk-defaults-validation.d.ts","sourceRoot":"","sources":["../../../src/checks/data/schema-fk-defaults-validation.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AAGH,eAAO,MAAM,EAAE,uCAAuC,CAAC;AACvD,eAAO,MAAM,IAAI,kCAAkC,CAAC;AACpD,eAAO,MAAM,WAAW,0DAA0D,CAAC;AACnF,eAAO,MAAM,QAAQ,SAAS,CAAC;AAC/B,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,IAAI,UAA8C,CAAC"}

package/dist/checks/data/schema-fk-defaults-validation.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Schema FK Defaults Validation Preflight
+ *
+ * Ensures Prisma schema @default values for foreign key fields match
+ * the IDs in seed data. Prevents FK constraint violations at runtime.
+ *
+ * Example issue this catches:
+ *   Schema: language String @default("ENGLISH")  <- uppercase
+ *   Seed:   { id: "english", ... }               <- lowercase
+ *   Result: FK constraint violation at runtime (P2003)
+ *
+ * Run: pnpm preflight:schema-fk-defaults
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.blocking = exports.category = exports.description = exports.name = exports.id = void 0;
+// METADATA - Required for plugin loader discovery
+exports.id = "data/schema-fk-defaults-validation";
+exports.name = "Schema FK Defaults Validation";
+exports.description = "Ensures schema defaults match seed data for FK fields";
+exports.category = "data";
+exports.blocking = true;
+exports.tags = ["data", "schema", "prisma", "foreign-key"];
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const colors = {
+    reset: "\x1b[0m",
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    cyan: "\x1b[36m",
+};
+console.log(`${colors.cyan}${console_chars_1.emoji.search} Schema FK Defaults Validation Preflight${colors.reset}\n`);
+const SCHEMA_PATH = "prisma/schema.prisma";
+// Configuration: FK fields to validate
+const FK_VALIDATIONS = [
+    {
+        name: "language",
+        schemaPattern: /language\s+String\s+@default\("([^"]+)"\)/g,
+        seedFile: "lib/seed-data/reference-data.ts",
+        seedArrayName: "languages",
+        idField: "id",
+    },
+];
+let hasErrors = false;
+const errors = [];
+/**
+ * Extract array data from a TypeScript seed file
+ */
+function extractSeedIds(seedFile, arrayName, idField) {
+    const fullPath = path_1.default.resolve(seedFile);
+    if (!fs_1.default.existsSync(fullPath)) {
+        return { error: `Seed file not found: ${seedFile}`, ids: [] };
+    }
+    const content = fs_1.default.readFileSync(fullPath, "utf-8");
+    // Find the array definition
+    const arrayRegex = new RegExp(`export\\s+const\\s+${arrayName}\\s*=\\s*\\[([\\s\\S]*?)\\];`, "m");
+    const match = content.match(arrayRegex);
+    if (!match) {
+        return { error: `Array "${arrayName}" not found in ${seedFile}`, ids: [] };
+    }
+    // Extract all id values from the array
+    const arrayContent = match[1];
+    const idRegex = new RegExp(`${idField}:\\s*["']([^"']+)["']`, "g");
+    const ids = [];
+    let idMatch;
+    while ((idMatch = idRegex.exec(arrayContent)) !== null) {
+        ids.push(idMatch[1]);
+    }
+    return { ids, error: null };
+}
+/**
+ * Find line number for a position in content
+ */
+function getLineNumber(content, position) {
+    return content.substring(0, position).split("\n").length;
+}
+/**
+ * Find model name for a position in schema
+ */
+function getModelName(schemaContent, position) {
+    const beforePosition = schemaContent.substring(0, position);
+    const modelMatches = [...beforePosition.matchAll(/model\s+(\w+)\s*\{/g)];
+    if (modelMatches.length === 0)
+        return "Unknown";
+    return modelMatches[modelMatches.length - 1][1];
+}
+// Read schema
+if (!fs_1.default.existsSync(SCHEMA_PATH)) {
+    console.error(`${console_chars_1.emoji.error} Schema file not found: ${SCHEMA_PATH}`);
+    process.exit(1);
+}
+const schemaContent = fs_1.default.readFileSync(SCHEMA_PATH, "utf-8");
+for (const validation of FK_VALIDATIONS) {
+    console.log(`${colors.blue}${console_chars_1.emoji.clipboard} Checking ${validation.name} defaults...${colors.reset}`);
+    // Get valid IDs from seed data
+    const { ids: validIds, error } = extractSeedIds(validation.seedFile, validation.seedArrayName, validation.idField);
+    if (error) {
+        console.warn(`   ${console_chars_1.emoji.warning} ${error}`);
+        continue;
+    }
+    console.log(`   Found ${validIds.length} valid IDs in seed data: ${validIds.slice(0, 5).join(", ")}${validIds.length > 5 ? "..." : ""}`);
+    // Get defaults from schema
+    const defaults = [];
+    let match;
+    validation.schemaPattern.lastIndex = 0;
+    while ((match = validation.schemaPattern.exec(schemaContent)) !== null) {
+        defaults.push({
+            value: match[1],
+            position: match.index,
+            fullMatch: match[0],
+        });
+    }
+    console.log(`   Found ${defaults.length} @default declarations in schema`);
+    // Check each default against valid IDs
+    for (const def of defaults) {
+        if (!validIds.includes(def.value)) {
+            const lineNum = getLineNumber(schemaContent, def.position);
+            const modelName = getModelName(schemaContent, def.position);
+            // Check for case mismatch specifically
+            const lowerValue = def.value.toLowerCase();
+            const caseMatch = validIds.find(id => id.toLowerCase() === lowerValue);
+            hasErrors = true;
+            errors.push({
+                field: validation.name,
+                model: modelName,
+                line: lineNum,
+                defaultValue: def.value,
+                validIds: validIds.slice(0, 5),
+                suggestion: caseMatch || validIds[0],
+                isCaseMismatch: !!caseMatch,
+            });
+        }
+    }
+}
+// Report results
+console.log("");
+if (!hasErrors) {
+    console.log(`${colors.green}${console_chars_1.emoji.success} All schema @default values match seed data!${colors.reset}\n`);
+    process.exit(0);
+}
+console.log(`${colors.red}${console_chars_1.emoji.error} Found ${errors.length} mismatched default(s):${colors.reset}\n`);
+for (const issue of errors) {
+    console.log(`   ${issue.model}.${issue.field} (line ${issue.line})`);
+    console.log(`      Current:  @default("${issue.defaultValue}")`);
+    console.log(`      Expected: @default("${issue.suggestion}")`);
+    if (issue.isCaseMismatch) {
+        console.log(`      ${colors.yellow}${console_chars_1.emoji.warning} Case mismatch detected!${colors.reset}`);
+    }
+    console.log(`      Valid IDs: ${issue.validIds.join(", ")}${issue.validIds.length >= 5 ? "..." : ""}`);
+    console.log("");
+}
+console.log((0, console_chars_1.createDivider)(60, "light"));
+console.log(`\n${console_chars_1.emoji.clipboard} How to fix:\n`);
+console.log("1. Update the @default value in prisma/schema.prisma to match seed data");
+console.log("2. Run: pnpm db:generate");
+console.log("3. If adding a new reference value, add it to the seed data first\n");
+console.log(`${colors.yellow}Why this matters:${colors.reset}`);
+console.log("   Schema defaults that don't exist in ref_* tables cause");
+console.log("   FK constraint violations at runtime (P2003 errors).\n");
+process.exit(1);
+//# sourceMappingURL=schema-fk-defaults-validation.js.map

package/dist/checks/data/schema-fk-defaults-validation.js.map

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

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":"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"}

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"}