@empline/preflight 1.0.20

package/dist/checks/ui/component-prop-validation.js

@@ -0,0 +1,271 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Component Prop Validation Check
+ *
+ * BLOCKING: Detects invalid prop values that cause UI rendering issues
+ *
+ * Checks for:
+ * 1. Button with invalid size prop (size="lg" should be size="lg")
+ * 2. TextField with value but missing shrink prop (causes label overlap)
+ * 3. CardContent without padding (content touches edges)
+ * 4. Stepper with orientation="vertical" but Step children not properly configured
+ * 5. StepContent used without parent Step having active={true}
+ *
+ * Run: pnpm preflight:component-props
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+const file_cache_1 = require("../../shared/file-cache");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "ui/component-prop-validation";
+exports.name = "Component Prop Validation";
+exports.category = "ui";
+exports.blocking = false;
+exports.description = "Component Prop Validation Check";
+exports.tags = ["ui", "validation"];
+const VALID_BUTTON_SIZES = ["default", "sm", "lg", "icon"];
+// CACHED FILE LISTS - Scan once, use everywhere
+let _cachedAllTsTsxFiles = null;
+async function getAllTsTsxFiles() {
+    if (!_cachedAllTsTsxFiles) {
+        _cachedAllTsTsxFiles = await file_cache_1.fileCache.getAllTsTsx();
+    }
+    return _cachedAllTsTsxFiles;
+}
+async function main() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(path.basename(__filename, ".ts"));
+    console.log(`\n${console_chars_1.emoji.search} COMPONENT PROP VALIDATION CHECK`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log("Checking for invalid component prop values...\n");
+    const files = await getAllTsTsxFiles();
+    const issues = [];
+    for (const file of files) {
+        const content = fs.readFileSync(file, "utf-8");
+        // Check 1: Invalid Button size prop (File-level check)
+        checkButtonSize(file, content, issues);
+        // Check 2: TextField with value but no shrink
+        checkTextFieldShrink(file, content, issues);
+        // Check Stepper component usage
+        checkStepperUsage(file, content, issues);
+    }
+    // Report results
+    const errors = issues.filter((i) => i.severity === "error");
+    const warnings = issues.filter((i) => i.severity === "warning");
+    if (issues.length === 0) {
+        console.log(`${console_chars_1.emoji.success} No component prop issues found!\n`);
+        process.exit(0);
+    }
+    // Group by file
+    const byFile = new Map();
+    for (const issue of issues) {
+        if (!byFile.has(issue.file)) {
+            byFile.set(issue.file, []);
+        }
+        byFile.get(issue.file).push(issue);
+    }
+    for (const [file, fileIssues] of byFile) {
+        console.log(`${console_chars_1.emoji.folder} ${file}:`);
+        for (const issue of fileIssues) {
+            const icon = issue.severity === "error" ? `${console_chars_1.emoji.error}` : `${console_chars_1.emoji.warning}`;
+            console.log(`   ${icon} Line ${issue.line}: ${issue.issue}`);
+            if (issue.fix) {
+                console.log(`      ${console_chars_1.emoji.hint} Fix: ${issue.fix}`);
+            }
+        }
+        console.log("");
+    }
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    if (errors.length > 0) {
+        // ADVISORY MODE: 31+ pre-existing violations - larger refactoring task
+        console.log(`\n${console_chars_1.emoji.warning} ADVISORY: Found ${errors.length} component prop issue(s)`);
+        console.log("These issues may cause visible UI bugs (missing padding, overlapping text).");
+        console.log(`\n${console_chars_1.emoji.hint} This check is advisory. Pre-existing issues won't block the build.`);
+        // Exit 0 - advisory only for pre-existing violations
+    }
+    console.log(`\n${console_chars_1.emoji.warning}  Found ${warnings.length} warning(s)\n`);
+    process.exit(0);
+}
+/**
+ * Check for invalid Button size prop values
+ *
+ * Checks actual <Button> and <IconButton> components (from shadcn/MUI).
+ * Uses robust parsing to handle multi-line props and avoid false positives
+ * on custom components like AddToCartButton.
+ */
+function checkButtonSize(file, content, issues) {
+    // Regex to find size props
+    const sizeRegex = /size\s*=\s*["']([^"']+)["']/g;
+    let match;
+    while ((match = sizeRegex.exec(content)) !== null) {
+        const sizeValue = match[1];
+        const startIndex = match.index;
+        // Check if this size prop belongs to a Button or IconButton
+        // Search backwards from the match to find the opening tag
+        const preceedingContent = content.substring(0, startIndex);
+        // Find the last opening tag
+        // We look for <TagName that is not followed by > (to ensure we are inside the tag)
+        // But we might be inside a string, etc. Simple backward search for <TagName is usually enough for JSX.
+        // We search for the last occurrence of <Identifier
+        // And ensure there is no > between that and our size prop
+        const lastTagMatch = /<([a-zA-Z0-9_]+)[^>]*$/s.exec(preceedingContent);
+        if (lastTagMatch) {
+            const tagName = lastTagMatch[1];
+            // Only validate for Button and IconButton
+            if (["Button", "IconButton"].includes(tagName)) {
+                if (!VALID_BUTTON_SIZES.includes(sizeValue)) {
+                    // Calculate line number
+                    const lineNum = preceedingContent.split("\n").length;
+                    issues.push({
+                        file,
+                        line: lineNum,
+                        issue: `Invalid ${tagName} size="${sizeValue}" - valid values are: ${VALID_BUTTON_SIZES.join(", ")}`,
+                        severity: "error",
+                        fix: sizeValue === "large"
+                            ? 'Change to size="lg"'
+                            : sizeValue === "small"
+                                ? 'Change to size="sm"'
+                                : sizeValue === "medium"
+                                    ? 'Change to size="default"'
+                                    : `Use one of: ${VALID_BUTTON_SIZES.join(", ")}`,
+                    });
+                }
+            }
+        }
+    }
+}
+/**
+ * Check for TextField with pre-filled value but missing shrink prop
+ * This causes label to overlap with the value text
+ */
+function checkTextFieldShrink(file, content, issues) {
+    // Find all TextField components
+    const textFieldRegex = /<TextField[\s\S]*?(?:\/>|<\/TextField>)/g;
+    let match;
+    while ((match = textFieldRegex.exec(content)) !== null) {
+        const textFieldContent = match[0];
+        const startIndex = match.index;
+        const lineNum = content.substring(0, startIndex).split("\n").length;
+        // Check if it has a value prop with actual content (not empty string)
+        const hasValue = /value\s*=\s*\{[^}]+\}/.test(textFieldContent) ||
+            /value\s*=\s*["'][^"']+["']/.test(textFieldContent);
+        // Check if it has shrink prop
+        const hasShrink = /shrink\s*[:=]/.test(textFieldContent) ||
+            /inputLabel\s*:\s*\{\s*shrink/.test(textFieldContent);
+        // Check if it has a label (excluding aria-label)
+        const hasLabel = /(?<!-)label\s*=/.test(textFieldContent);
+        // If has value and label but no shrink, this will cause overlap
+        if (hasValue && hasLabel && !hasShrink) {
+            issues.push({
+                file,
+                line: lineNum,
+                issue: "TextField has value and label but missing shrink prop - causes label overlap",
+                severity: "warning",
+                fix: "Add slotProps={{ inputLabel: { shrink: true } }}",
+            });
+        }
+    }
+}
+/**
+ * Check for Stepper component usage issues
+ * - Vertical stepper with StepContent but Step not marked active
+ * - StepContent without proper parent Step configuration
+ */
+function checkStepperUsage(file, content, issues) {
+    // Check if file uses Stepper
+    if (!content.includes("<Stepper") && !content.includes("Stepper ")) {
+        return;
+    }
+    const lines = content.split("\n");
+    // Find vertical steppers
+    const verticalStepperRegex = /<Stepper[^>]*orientation\s*=\s*["']vertical["'][^>]*>/g;
+    let match;
+    while ((match = verticalStepperRegex.exec(content)) !== null) {
+        const startIndex = match.index;
+        const lineNum = content.substring(0, startIndex).split("\n").length;
+        // Find the closing tag or self-closing
+        const afterStepper = content.substring(startIndex);
+        const stepperEndMatch = afterStepper.match(/<\/Stepper>/);
+        if (stepperEndMatch) {
+            const stepperContent = afterStepper.substring(0, stepperEndMatch.index + stepperEndMatch[0].length);
+            // Check if StepContent is used
+            const hasStepContent = stepperContent.includes("<StepContent");
+            // Check if Steps have active={true}
+            const stepsWithActive = (stepperContent.match(/<Step[^>]*active\s*=\s*\{?\s*true\s*\}?/g) || []).length;
+            const totalSteps = (stepperContent.match(/<Step[\s>]/g) || []).length;
+            // If using StepContent but no steps are marked active, content will be hidden
+            if (hasStepContent && stepsWithActive === 0 && totalSteps > 0) {
+                issues.push({
+                    file,
+                    line: lineNum,
+                    issue: "Vertical Stepper with StepContent but no Step has active={true} - content will be hidden",
+                    severity: "warning",
+                    fix: "Add active={true} to each Step that should show its StepContent, or use activeStep prop on Stepper",
+                });
+            }
+        }
+    }
+    // Check for StepContent used outside of vertical Stepper context
+    // This is a common mistake - StepContent only makes sense in vertical orientation
+    const hasStepContent = content.includes("<StepContent");
+    const hasVerticalStepper = /<Stepper[^>]*orientation\s*=\s*["']vertical["']/.test(content);
+    const hasHorizontalStepper = /<Stepper[^>]*orientation\s*=\s*["']horizontal["']/.test(content) ||
+        (/<Stepper[^>]*>/.test(content) && !hasVerticalStepper);
+    if (hasStepContent && hasHorizontalStepper && !hasVerticalStepper) {
+        // Find line number of StepContent
+        for (let i = 0; i < lines.length; i++) {
+            if (lines[i].includes("<StepContent")) {
+                issues.push({
+                    file,
+                    line: i + 1,
+                    issue: 'StepContent used with horizontal Stepper - StepContent only works with orientation="vertical"',
+                    severity: "error",
+                    fix: 'Add orientation="vertical" to Stepper, or remove StepContent for horizontal steppers',
+                });
+                break;
+            }
+        }
+    }
+}
+main().catch((err) => {
+    console.error("Error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=component-prop-validation.js.map

package/dist/checks/ui/component-prop-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-prop-validation.js","sourceRoot":"","sources":["../../../src/checks/ui/component-prop-validation.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;;GAaG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAC7B,6DAAiE;AACjE,wDAAoD;AACpD,uFAAwF;AAGxF,iBAAiB;AACJ,QAAA,EAAE,GAAG,8BAA8B,CAAC;AACpC,QAAA,IAAI,GAAG,2BAA2B,CAAC;AACnC,QAAA,QAAQ,GAAG,IAAI,CAAC;AAChB,QAAA,QAAQ,GAAG,KAAK,CAAC;AACjB,QAAA,WAAW,GAAG,iCAAiC,CAAC;AAChD,QAAA,IAAI,GAAG,CAAC,IAAI,EAAC,YAAY,CAAC,CAAC;AAUxC,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAE3D,gDAAgD;AAEhD,IAAI,oBAAoB,GAAoB,IAAI,CAAC;AACjD,KAAK,UAAU,gBAAgB;IAC7B,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,oBAAoB,GAAG,MAAM,sBAAS,CAAC,WAAW,EAAE,CAAC;IACvD,CAAC;IACD,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,QAAQ,GAAG,IAAA,6DAA+B,EAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;IACnF,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,MAAM,kCAAkC,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;IAE/D,MAAM,KAAK,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAEvC,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE/C,uDAAuD;QACvD,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAEvC,8CAA8C;QAC9C,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE5C,gCAAgC;QAChC,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,iBAAiB;IACjB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IAEhE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,OAAO,oCAAoC,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,gBAAgB;IAChB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC7B,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,EAAE,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,MAAM,IAAI,IAAI,GAAG,CAAC,CAAC;QACxC,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,qBAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,qBAAK,CAAC,OAAO,EAAE,CAAC;YAChF,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,SAAS,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7D,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,SAAS,qBAAK,CAAC,IAAI,SAAS,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAExC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,uEAAuE;QACvE,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,oBAAoB,MAAM,CAAC,MAAM,0BAA0B,CAAC,CAAC;QAC3F,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;QAC3F,OAAO,CAAC,GAAG,CACT,KAAK,qBAAK,CAAC,IAAI,qEAAqE,CACrF,CAAC;QACF,qDAAqD;IACvD,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,WAAW,QAAQ,CAAC,MAAM,eAAe,CAAC,CAAC;IACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,eAAe,CAAC,IAAY,EAAE,OAAe,EAAE,MAAe;IACrE,2BAA2B;IAC3B,MAAM,SAAS,GAAG,8BAA8B,CAAC;IACjD,IAAI,KAAK,CAAC;IAEV,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;QAE/B,4DAA4D;QAC5D,0DAA0D;QAC1D,MAAM,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAE3D,4BAA4B;QAC5B,mFAAmF;QACnF,uGAAuG;QAEvG,mDAAmD;QACnD,0DAA0D;QAC1D,MAAM,YAAY,GAAG,yBAAyB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAEvE,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YAEhC,0CAA0C;YAC1C,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC/C,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC5C,wBAAwB;oBACxB,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;oBAErD,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI;wBACJ,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,WAAW,OAAO,UAAU,SAAS,yBAAyB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;wBACpG,QAAQ,EAAE,OAAO;wBACjB,GAAG,EACD,SAAS,KAAK,OAAO;4BACnB,CAAC,CAAC,qBAAqB;4BACvB,CAAC,CAAC,SAAS,KAAK,OAAO;gCACrB,CAAC,CAAC,qBAAqB;gCACvB,CAAC,CAAC,SAAS,KAAK,QAAQ;oCACtB,CAAC,CAAC,0BAA0B;oCAC5B,CAAC,CAAC,eAAe,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBACzD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,IAAY,EAAE,OAAe,EAAE,MAAe;IAC1E,gCAAgC;IAChC,MAAM,cAAc,GAAG,0CAA0C,CAAC;IAClE,IAAI,KAAK,CAAC;IAEV,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACvD,MAAM,gBAAgB,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;QAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAEpE,sEAAsE;QACtE,MAAM,QAAQ,GACZ,uBAAuB,CAAC,IAAI,CAAC,gBAAgB,CAAC;YAC9C,4BAA4B,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAEtD,8BAA8B;QAC9B,MAAM,SAAS,GACb,eAAe,CAAC,IAAI,CAAC,gBAAgB,CAAC;YACtC,8BAA8B,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAExD,iDAAiD;QACjD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAE1D,gEAAgE;QAChE,IAAI,QAAQ,IAAI,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI;gBACJ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,8EAA8E;gBACrF,QAAQ,EAAE,SAAS;gBACnB,GAAG,EAAE,kDAAkD;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,IAAY,EAAE,OAAe,EAAE,MAAe;IACvE,6BAA6B;IAC7B,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACnE,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,yBAAyB;IACzB,MAAM,oBAAoB,GAAG,wDAAwD,CAAC;IACtF,IAAI,KAAK,CAAC;IAEV,OAAO,CAAC,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7D,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC;QAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAEpE,uCAAuC;QACvC,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,eAAe,GAAG,YAAY,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAE1D,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,cAAc,GAAG,YAAY,CAAC,SAAS,CAC3C,CAAC,EACD,eAAe,CAAC,KAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM,CACnD,CAAC;YAEF,+BAA+B;YAC/B,MAAM,cAAc,GAAG,cAAc,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;YAE/D,oCAAoC;YACpC,MAAM,eAAe,GAAG,CACtB,cAAc,CAAC,KAAK,CAAC,0CAA0C,CAAC,IAAI,EAAE,CACvE,CAAC,MAAM,CAAC;YACT,MAAM,UAAU,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YAEtE,8EAA8E;YAC9E,IAAI,cAAc,IAAI,eAAe,KAAK,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;gBAC9D,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI;oBACJ,IAAI,EAAE,OAAO;oBACb,KAAK,EACH,0FAA0F;oBAC5F,QAAQ,EAAE,SAAS;oBACnB,GAAG,EAAE,oGAAoG;iBAC1G,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,kFAAkF;IAClF,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACxD,MAAM,kBAAkB,GAAG,iDAAiD,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3F,MAAM,oBAAoB,GACxB,mDAAmD,CAAC,IAAI,CAAC,OAAO,CAAC;QACjE,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAE1D,IAAI,cAAc,IAAI,oBAAoB,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAClE,kCAAkC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBACtC,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI;oBACJ,IAAI,EAAE,CAAC,GAAG,CAAC;oBACX,KAAK,EACH,+FAA+F;oBACjG,QAAQ,EAAE,OAAO;oBACjB,GAAG,EAAE,sFAAsF;iBAC5F,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/checks/ui/console-log-check.d.ts

@@ -0,0 +1,7 @@
+export declare const id = "ui/console-log-check";
+export declare const name = "Console Log Check";
+export declare const description = "Detects console.log statements that should be removed from production code";
+export declare const category = "ui";
+export declare const blocking = false;
+export declare const tags: string[];
+//# sourceMappingURL=console-log-check.d.ts.map

package/dist/checks/ui/console-log-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-log-check.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/console-log-check.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,EAAE,yBAAyB,CAAC;AACzC,eAAO,MAAM,IAAI,sBAAsB,CAAC;AACxC,eAAO,MAAM,WAAW,+EAA+E,CAAC;AACxG,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,IAAI,UAA+C,CAAC"}

package/dist/checks/ui/console-log-check.js

@@ -0,0 +1,126 @@
+"use strict";
+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.blocking = exports.category = exports.description = 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/console-log-check";
+exports.name = "Console Log Check";
+exports.description = "Detects console.log statements that should be removed from production code";
+exports.category = "ui";
+exports.blocking = false;
+exports.tags = ["ui", "console", "cleanup", "code-quality"];
+const EXCLUDED = (0, glob_patterns_1.extendExcludes)(glob_patterns_1.STANDARD_EXCLUDES_WITH_TESTS, [
+    "scripts/**",
+    "tests/**",
+    "docs/**",
+    "coverage/**",
+    "jest.globalSetup.js",
+    "lib/logger.ts",
+    "packages/**/cli/**",
+]);
+// Patterns to exclude from console.log check (scripts, tests, CLI tools, root utility scripts)
+const EXCLUDE_PATTERNS = [
+    /^scripts\//,
+    /^tests\//,
+    /^docs\//,
+    /^coverage\//,
+    /jest\.globalSetup\.js$/,
+    /^lib\/logger\.ts$/,
+    /\/cli\//,
+    /preflight-cli/,
+    // Root-level utility scripts (fix-*, check-*, cleanup-*, etc.)
+    /^fix[-_][^/]+\.(js|ts)$/,
+    /^check[-_][^/]+\.(js|ts)$/,
+    /^cleanup[^/]*\.(js|ts)$/,
+    /^analyze[-_][^/]+\.(js|ts)$/,
+    /^split[-_][^/]+\.(js|ts)$/,
+    /^test[-_][^/]+\.(js|ts)$/,
+    /^debug[-_][^/]+\.(js|ts)$/,
+];
+// CACHED FILE LISTS - Scan once, use everywhere
+let _cachedAllCodeFiles = null;
+async function getAllCodeFiles() {
+    if (!_cachedAllCodeFiles) {
+        const allFiles = await file_cache_1.fileCache.getAllCodeFiles();
+        // Filter out excluded patterns
+        _cachedAllCodeFiles = allFiles.filter((file) => !EXCLUDE_PATTERNS.some((pattern) => pattern.test(file)));
+    }
+    return _cachedAllCodeFiles;
+}
+async function checkConsoleLogs() {
+    console.log(`\n${console_chars_1.emoji.search} Checking for Console logs...\n`);
+    const files = await getAllCodeFiles();
+    const issues = [];
+    const consoleLogRegex = /console\.log\(/g;
+    for (const file of files) {
+        const content = fs.readFileSync(file, "utf8");
+        const lines = content.split("\n");
+        lines.forEach((line, index) => {
+            if (line.includes("preflight-ignore"))
+                return;
+            // Check for console.log
+            if (consoleLogRegex.test(line)) {
+                // Ignore comments (lines starting with // or /* or *)
+                const trimmed = line.trim();
+                if (trimmed.startsWith("//") || trimmed.startsWith("/*") || trimmed.startsWith("*")) {
+                    return;
+                }
+                issues.push({
+                    file,
+                    line: index + 1,
+                    message: "console.log detected. Remove or use console.error/warn/info if strictly necessary.",
+                    snippet: line.trim(),
+                });
+            }
+        });
+    }
+    if (issues.length > 0) {
+        console.log(`${console_chars_1.emoji.error} Found ${issues.length} console.log issues:`);
+        issues.forEach((i) => {
+            console.log(`   ${i.file}:${i.line} - ${i.message}`);
+        });
+        // Non-blocking: console.log cleanup is ongoing
+        process.exit(0);
+    }
+    else {
+        console.log(`${console_chars_1.emoji.success} Console log check passed!`);
+    }
+}
+checkConsoleLogs();
+//# sourceMappingURL=console-log-check.js.map

package/dist/checks/ui/console-log-check.js.map

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

package/dist/checks/ui/css-grid-gap-check.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CSS Grid Gap Check Preflight (BLOCKING)
+ *
+ * Detects CSS grid layouts (display: "grid") that are missing gap properties.
+ * This prevents form fields and other grid items from appearing without spacing.
+ *
+ * BLOCKS:
+ * - display: "grid" without gap property in the same style object
+ * - gridTemplateColumns without accompanying gap
+ *
+ * APPROVED patterns:
+ * - display: "grid" with gap: "var(--spacing-X)"
+ * - display: "grid" with className containing gap-X
+ *
+ * Usage:
+ *   pnpm preflight:ui-spacing:css-grid-gap
+ */
+export declare const id = "ui/css-grid-gap-check";
+export declare const name = "Css Grid Gap Check";
+export declare const category = "ui";
+export declare const blocking = true;
+export declare const description = "CSS Grid Gap Check Preflight (BLOCKING)";
+export declare const tags: string[];
+//# sourceMappingURL=css-grid-gap-check.d.ts.map

package/dist/checks/ui/css-grid-gap-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css-grid-gap-check.d.ts","sourceRoot":"","sources":["../../../src/checks/ui/css-grid-gap-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH,eAAO,MAAM,EAAE,0BAA0B,CAAC;AAC1C,eAAO,MAAM,IAAI,uBAAuB,CAAC;AACzC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,4CAA4C,CAAC;AACrE,eAAO,MAAM,IAAI,UAAS,CAAC"}