@empline/preflight 1.1.0

package/dist/checks/react/sort-state-consolidation.js

@@ -0,0 +1,261 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Sort State Consolidation Preflight
+ *
+ * Detects manual sort state management in table components that should
+ * use a consolidated hook pattern.
+ *
+ * Anti-patterns detected:
+ * - Multiple useState for sortField + sortDirection/sortOrder
+ * - Manual sort state with inline toggle logic
+ * - Duplicated sort handling across table components
+ *
+ * Best practices:
+ * - useSort() or useTableState() hook encapsulating sort logic
+ * - Single state object: { field: string, direction: 'asc' | 'desc' }
+ * - Consistent sort API with toggle function
+ *
+ * Usage:
+ *   npx preflight react/sort-state-consolidation
+ */
+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.blocking = exports.category = exports.description = exports.name = exports.id = void 0;
+exports.run = run;
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+const console_chars_1 = require("../../utils/console-chars");
+const fs = __importStar(require("fs"));
+const glob_1 = require("glob");
+// METADATA
+exports.id = "react/sort-state-consolidation";
+exports.name = "Sort State Consolidation";
+exports.description = "Detects manual sort state - use consolidated hook instead";
+exports.category = "react";
+exports.blocking = false;
+exports.tags = ["react", "sorting", "hooks", "state", "tables", "refactor"];
+exports.requires = ["react"];
+// Sort-related useState patterns
+const SORT_STATE_PATTERNS = [
+    { pattern: /const\s+\[\s*sortBy\s*,\s*setSortBy\s*\]\s*=\s*useState/, name: "sortBy" },
+    { pattern: /const\s+\[\s*sortField\s*,\s*setSortField\s*\]\s*=\s*useState/, name: "sortField" },
+    { pattern: /const\s+\[\s*sortColumn\s*,\s*setSortColumn\s*\]\s*=\s*useState/, name: "sortColumn" },
+    { pattern: /const\s+\[\s*sortDirection\s*,\s*setSortDirection\s*\]\s*=\s*useState/, name: "sortDirection" },
+    { pattern: /const\s+\[\s*sortOrder\s*,\s*setSortOrder\s*\]\s*=\s*useState/, name: "sortOrder" },
+    { pattern: /const\s+\[\s*orderBy\s*,\s*setOrderBy\s*\]\s*=\s*useState/, name: "orderBy" },
+    { pattern: /const\s+\[\s*order\s*,\s*setOrder\s*\]\s*=\s*useState\s*[<(]?\s*["'](?:asc|desc)["']/, name: "order" },
+];
+// Manual sort toggle patterns
+const MANUAL_SORT_PATTERNS = [
+    {
+        pattern: /sortDirection\s*===?\s*["']asc["']\s*\?\s*["']desc["']\s*:\s*["']asc["']/,
+        name: "manual-toggle",
+        message: "Manual sort direction toggle",
+        suggestion: "Encapsulate sort toggling in a hook: useSort() or useTableState()",
+    },
+    {
+        pattern: /order\s*===?\s*["']asc["']\s*\?\s*["']desc["']\s*:\s*["']asc["']/,
+        name: "manual-order-toggle",
+        message: "Manual order toggle",
+        suggestion: "Use a sort hook that provides a toggle function",
+    },
+];
+// Good patterns
+const GOOD_PATTERNS = [
+    /useSort\s*\(/,
+    /useTableState\s*\(/,
+    /useSortBy\s*\(/,
+    /useTableSort\s*\(/,
+    /useSorting\s*\(/,
+    /import.*useSort/,
+    /import.*useTableState/,
+    // TanStack Table patterns
+    /useSortingState/,
+    /getSortedRowModel/,
+];
+async function findTableComponents() {
+    const patterns = [
+        "app/**/*Client.tsx",
+        "app/**/*Table*.tsx",
+        "app/**/*List*.tsx",
+        "src/app/**/*Client.tsx",
+        "src/app/**/*Table*.tsx",
+        "components/**/*Table*.tsx",
+        "components/**/*List*.tsx",
+        "src/components/**/*Table*.tsx",
+        "src/components/**/*List*.tsx",
+    ];
+    const allFiles = [];
+    for (const pattern of patterns) {
+        const matches = await (0, glob_1.glob)(pattern, {
+            ignore: [
+                "**/node_modules/**",
+                "**/*.test.tsx",
+                "**/*.spec.tsx",
+                "**/*.stories.tsx",
+                "**/useSort.ts*",
+                "**/useTableState.ts*",
+            ],
+        });
+        allFiles.push(...matches);
+    }
+    return [...new Set(allFiles)];
+}
+function checkFile(filePath, content) {
+    const issues = [];
+    const lines = content.split("\n");
+    // Check for good patterns
+    const hasGoodPattern = GOOD_PATTERNS.some((pattern) => pattern.test(content));
+    if (hasGoodPattern) {
+        return { file: filePath, issues: [] };
+    }
+    // Count sort-related useState hooks
+    const foundStates = [];
+    for (const { pattern, name } of SORT_STATE_PATTERNS) {
+        if (pattern.test(content)) {
+            foundStates.push(name);
+        }
+    }
+    // If 2+ sort states found without hook
+    if (foundStates.length >= 2) {
+        issues.push({
+            file: filePath,
+            line: 1,
+            severity: foundStates.length >= 3 ? "warning" : "info",
+            message: `Manual sort state: ${foundStates.join(", ")}`,
+            suggestion: "Create a useSort() or useTableState() hook to consolidate sort logic",
+            code: "manual-sort-state",
+        });
+    }
+    // Check for manual sort toggle patterns
+    for (const sortPattern of MANUAL_SORT_PATTERNS) {
+        const match = content.match(sortPattern.pattern);
+        if (match) {
+            let lineNumber = 1;
+            let charCount = 0;
+            for (let i = 0; i < lines.length; i++) {
+                charCount += lines[i].length + 1;
+                if (charCount > (match.index || 0)) {
+                    lineNumber = i + 1;
+                    break;
+                }
+            }
+            issues.push({
+                file: filePath,
+                line: lineNumber,
+                severity: "info",
+                message: sortPattern.message,
+                suggestion: sortPattern.suggestion,
+                code: sortPattern.name,
+            });
+        }
+    }
+    return { file: filePath, issues };
+}
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    const verbose = process.argv.includes("--verbose") || process.argv.includes("-v");
+    console.log(`${console_chars_1.emoji.search} Sort State Consolidation Preflight`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    const files = await findTableComponents();
+    if (files.length === 0) {
+        console.log(`${console_chars_1.emoji.info}  No table/list component files found`);
+        console.log(`${console_chars_1.emoji.success} Check passed (no files to validate)`);
+        return true;
+    }
+    console.log(`Scanning ${files.length} table/list component files...\n`);
+    const allIssues = [];
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(file, "utf-8");
+            const result = checkFile(file, content);
+            allIssues.push(...result.issues);
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    const warnings = allIssues.filter((i) => i.severity === "warning");
+    const info = allIssues.filter((i) => i.severity === "info");
+    if (warnings.length > 0) {
+        console.log(`${console_chars_1.emoji.warning}  WARNINGS:`);
+        console.log((0, console_chars_1.createDivider)(60, "light"));
+        for (const issue of warnings) {
+            console.log(`  ${issue.file}:${issue.line}`);
+            console.log(`    ${issue.message}`);
+            if (verbose) {
+                console.log(`    ${console_chars_1.emoji.hint} ${issue.suggestion}`);
+            }
+            console.log("");
+        }
+    }
+    if (verbose && info.length > 0) {
+        console.log(`${console_chars_1.emoji.info}  INFO:`);
+        console.log((0, console_chars_1.createDivider)(60, "light"));
+        for (const issue of info) {
+            console.log(`  ${issue.file}:${issue.line}`);
+            console.log(`    ${issue.message}`);
+            console.log("");
+        }
+    }
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`Files scanned: ${files.length}`);
+    console.log(`Warnings: ${warnings.length}`);
+    console.log(`Info: ${info.length}`);
+    if (warnings.length === 0 && info.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} Sort state patterns are consistent`);
+    }
+    console.log(`\n${console_chars_1.emoji.docs} Recommended hook:`);
+    console.log(`   ${console_chars_1.chars.bullet} function useSort(defaultField, defaultDir = 'asc') {`);
+    console.log(`       const [sort, setSort] = useState({ field: defaultField, direction: defaultDir });`);
+    console.log(`       const toggle = (field) => setSort(prev => ({`);
+    console.log(`         field,`);
+    console.log(`         direction: prev.field === field && prev.direction === 'asc' ? 'desc' : 'asc'`);
+    console.log(`       }));`);
+    console.log(`       return { sort, toggle, setSort };`);
+    console.log(`     }`);
+    // Non-blocking
+    return true;
+}
+// Allow direct execution
+if (require.main === module) {
+    run().then((passed) => {
+        process.exit(passed ? 0 : 1);
+    }).catch((error) => {
+        console.error("Preflight error:", error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=sort-state-consolidation.js.map

package/dist/checks/react/sort-state-consolidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-state-consolidation.js","sourceRoot":"","sources":["../../../src/checks/react/sort-state-consolidation.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;;;;;;;GAkBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiKH,kBA4EC;AA3OD,uFAAwF;AACxF,6DAAwE;AACxE,uCAAyB;AAEzB,+BAA4B;AAE5B,WAAW;AACE,QAAA,EAAE,GAAG,gCAAgC,CAAC;AACtC,QAAA,IAAI,GAAG,0BAA0B,CAAC;AAClC,QAAA,WAAW,GAAG,2DAA2D,CAAC;AAC1E,QAAA,QAAQ,GAAG,OAAO,CAAC;AACnB,QAAA,QAAQ,GAAG,KAAK,CAAC;AACjB,QAAA,IAAI,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;AACpE,QAAA,QAAQ,GAAG,CAAC,OAAO,CAAC,CAAC;AAgBlC,iCAAiC;AACjC,MAAM,mBAAmB,GAAG;IAC1B,EAAE,OAAO,EAAE,yDAAyD,EAAE,IAAI,EAAE,QAAQ,EAAE;IACtF,EAAE,OAAO,EAAE,+DAA+D,EAAE,IAAI,EAAE,WAAW,EAAE;IAC/F,EAAE,OAAO,EAAE,iEAAiE,EAAE,IAAI,EAAE,YAAY,EAAE;IAClG,EAAE,OAAO,EAAE,uEAAuE,EAAE,IAAI,EAAE,eAAe,EAAE;IAC3G,EAAE,OAAO,EAAE,+DAA+D,EAAE,IAAI,EAAE,WAAW,EAAE;IAC/F,EAAE,OAAO,EAAE,2DAA2D,EAAE,IAAI,EAAE,SAAS,EAAE;IACzF,EAAE,OAAO,EAAE,sFAAsF,EAAE,IAAI,EAAE,OAAO,EAAE;CACnH,CAAC;AAEF,8BAA8B;AAC9B,MAAM,oBAAoB,GAAG;IAC3B;QACE,OAAO,EAAE,0EAA0E;QACnF,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,8BAA8B;QACvC,UAAU,EAAE,mEAAmE;KAChF;IACD;QACE,OAAO,EAAE,kEAAkE;QAC3E,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,qBAAqB;QAC9B,UAAU,EAAE,iDAAiD;KAC9D;CACF,CAAC;AAEF,gBAAgB;AAChB,MAAM,aAAa,GAAG;IACpB,cAAc;IACd,oBAAoB;IACpB,gBAAgB;IAChB,mBAAmB;IACnB,iBAAiB;IACjB,iBAAiB;IACjB,uBAAuB;IACvB,0BAA0B;IAC1B,iBAAiB;IACjB,mBAAmB;CACpB,CAAC;AAEF,KAAK,UAAU,mBAAmB;IAChC,MAAM,QAAQ,GAAG;QACf,oBAAoB;QACpB,oBAAoB;QACpB,mBAAmB;QACnB,wBAAwB;QACxB,wBAAwB;QACxB,2BAA2B;QAC3B,0BAA0B;QAC1B,+BAA+B;QAC/B,8BAA8B;KAC/B,CAAC;IAEF,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,MAAM,IAAA,WAAI,EAAC,OAAO,EAAE;YAClC,MAAM,EAAE;gBACN,oBAAoB;gBACpB,eAAe;gBACf,eAAe;gBACf,kBAAkB;gBAClB,gBAAgB;gBAChB,sBAAsB;aACvB;SACF,CAAC,CAAC;QACH,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB,EAAE,OAAe;IAClD,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,0BAA0B;IAC1B,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9E,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACxC,CAAC;IAED,oCAAoC;IACpC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,mBAAmB,EAAE,CAAC;QACpD,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,IAAI,WAAW,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC;YACP,QAAQ,EAAE,WAAW,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;YACtD,OAAO,EAAE,sBAAsB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACvD,UAAU,EAAE,sEAAsE;YAClF,IAAI,EAAE,mBAAmB;SAC1B,CAAC,CAAC;IACL,CAAC;IAED,wCAAwC;IACxC,KAAK,MAAM,WAAW,IAAI,oBAAoB,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,KAAK,EAAE,CAAC;YACV,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,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,CAAC;oBACnC,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,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,UAAU,EAAE,WAAW,CAAC,UAAU;gBAClC,IAAI,EAAE,WAAW,CAAC,IAAI;aACvB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACpC,CAAC;AAEM,KAAK,UAAU,GAAG;IACvB,MAAM,QAAQ,GAAG,IAAA,6DAA+B,EAAC,YAAI,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAElF,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,MAAM,qCAAqC,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAE1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,IAAI,uCAAuC,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,MAAM,kCAAkC,CAAC,CAAC;IAExE,MAAM,SAAS,GAAY,EAAE,CAAC;IAE9B,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,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACxC,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC;IAE5D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,OAAO,aAAa,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;QACxC,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACpC,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,GAAG,CAAC,OAAO,qBAAK,CAAC,IAAI,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;YACvD,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,IAAI,SAAS,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;QACxC,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7C,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,IAAA,6BAAa,EAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,aAAa,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAEpC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,IAAI,oBAAoB,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,MAAM,qBAAK,CAAC,MAAM,uDAAuD,CAAC,CAAC;IACvF,OAAO,CAAC,GAAG,CAAC,0FAA0F,CAAC,CAAC;IACxG,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,uFAAuF,CAAC,CAAC;IACrG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEtB,eAAe;IACf,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yBAAyB;AACzB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QACpB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACjB,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/checks/react/useeffect-loop-detector.d.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env tsx
+/**
+ * useEffect Infinite Loop Detector
+ *
+ * Detects common patterns that cause infinite re-render loops:
+ * 1. useEffect that calls a callback prop WITH that callback in dependencies
+ * 2. Embedded mode syncing local state to parent without value comparison
+ * 3. State setters called unconditionally in effects with state in deps
+ *
+ * BLOCKING: Yes - infinite loops crash applications
+ *
+ * Safe patterns (not flagged):
+ * - Callback in effect but NOT in dependency array (intentional design)
+ * - Callback with explicit value comparison guard
+ * - State changes inside conditionals
+ */
+import { PreflightCheckResult } from "../../core/types";
+export declare const id = "react/useeffect-loop-detector";
+export declare const name = "useEffect Infinite Loop Detector";
+export declare const description = "Detects common patterns that cause infinite re-render loops in useEffect hooks";
+export declare const category = "react";
+export declare const blocking = true;
+export declare const tags: string[];
+export declare const requires: string[];
+export declare function run(): Promise<PreflightCheckResult>;
+//# sourceMappingURL=useeffect-loop-detector.d.ts.map

package/dist/checks/react/useeffect-loop-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useeffect-loop-detector.d.ts","sourceRoot":"","sources":["../../../src/checks/react/useeffect-loop-detector.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EAAE,oBAAoB,EAAoB,MAAM,kBAAkB,CAAC;AAS1E,eAAO,MAAM,EAAE,kCAAkC,CAAC;AAClD,eAAO,MAAM,IAAI,qCAAqC,CAAC;AACvD,eAAO,MAAM,WAAW,mFAAmF,CAAC;AAC5G,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,IAAI,UAAkE,CAAC;AACpF,eAAO,MAAM,QAAQ,UAAY,CAAC;AAsHlC,wBAAsB,GAAG,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAoCzD"}

package/dist/checks/react/useeffect-loop-detector.js

@@ -0,0 +1,219 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * useEffect Infinite Loop Detector
+ *
+ * Detects common patterns that cause infinite re-render loops:
+ * 1. useEffect that calls a callback prop WITH that callback in dependencies
+ * 2. Embedded mode syncing local state to parent without value comparison
+ * 3. State setters called unconditionally in effects with state in deps
+ *
+ * BLOCKING: Yes - infinite loops crash applications
+ *
+ * Safe patterns (not flagged):
+ * - Callback in effect but NOT in dependency array (intentional design)
+ * - Callback with explicit value comparison guard
+ * - State changes inside conditionals
+ */
+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.blocking = exports.category = exports.description = exports.name = exports.id = void 0;
+exports.run = run;
+const fs = __importStar(require("node:fs"));
+const console_chars_1 = require("../../utils/console-chars");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+const glob_1 = require("glob");
+// =============================================================================
+// METADATA
+// =============================================================================
+exports.id = "react/useeffect-loop-detector";
+exports.name = "useEffect Infinite Loop Detector";
+exports.description = "Detects common patterns that cause infinite re-render loops in useEffect hooks";
+exports.category = "react";
+exports.blocking = true;
+exports.tags = ["react", "hooks", "useEffect", "performance", "infinite-loop"];
+exports.requires = ["react"];
+// =============================================================================
+// DETECTION PATTERNS
+// =============================================================================
+// High-risk: callback in deps AND called directly without guard
+const HIGH_RISK_PATTERNS = [
+    {
+        // useEffect with callback in body AND in dependency array
+        regex: /useEffect\s*\(\s*\(\)\s*=>\s*\{\s*\n?\s*(on[A-Z]\w+)\s*\([^)]*\)\s*;?\s*\n?\s*\}\s*,\s*\[([^\]]*)\]\s*\)/g,
+        name: "callback-in-deps",
+        message: "useEffect calls callback that's also in dependency array - HIGH RISK of infinite loop",
+        severity: "error",
+        validate: (match) => {
+            const callbackName = match[1];
+            const deps = match[2];
+            return deps.includes(callbackName);
+        },
+    },
+];
+// =============================================================================
+// ANALYSIS FUNCTIONS
+// =============================================================================
+function analyzeFile(filePath, issues) {
+    const content = fs.readFileSync(filePath, "utf-8");
+    // Skip if no useEffect
+    if (!content.includes("useEffect")) {
+        return;
+    }
+    // Check high-risk patterns
+    for (const pattern of HIGH_RISK_PATTERNS) {
+        const matches = content.matchAll(new RegExp(pattern.regex.source, "g"));
+        for (const match of matches) {
+            const lineNumber = content.substring(0, match.index).split("\n").length;
+            // Run custom validation if provided
+            if (pattern.validate && !pattern.validate(match)) {
+                continue;
+            }
+            // Check if there's a conditional guard nearby
+            const contextStart = Math.max(0, match.index - 100);
+            const contextEnd = Math.min(content.length, match.index + match[0].length + 200);
+            const context = content.substring(contextStart, contextEnd);
+            // Skip if there's an obvious guard or intentional comment
+            if (context.includes("hasChanged") ||
+                context.includes("!==") ||
+                context.includes("!= ") ||
+                context.includes("JSON.stringify") ||
+                context.includes("prevent infinite") ||
+                (context.includes("removed") && context.includes("from deps"))) {
+                continue;
+            }
+            issues.push({
+                file: filePath,
+                line: lineNumber,
+                pattern: pattern.name,
+                message: pattern.message,
+                severity: pattern.severity,
+                context: match[0].substring(0, 100),
+            });
+        }
+    }
+    // Check for embedded mode syncing pattern
+    const embeddedPattern = /useEffect\s*\(\s*\(\)\s*=>\s*\{[^}]*if\s*\(\s*embedded\s*\)\s*\{?\s*\n?\s*(on\w+Change)\s*\([^)]+\)[^}]*\}\s*,\s*\[([^\]]+)\]/g;
+    const embeddedMatches = content.matchAll(embeddedPattern);
+    for (const match of embeddedMatches) {
+        const callbackName = match[1];
+        const deps = match[2];
+        if (!deps.includes(callbackName)) {
+            continue;
+        }
+        const lineNumber = content.substring(0, match.index).split("\n").length;
+        const contextEnd = Math.min(content.length, match.index + match[0].length + 300);
+        const context = content.substring(match.index, contextEnd);
+        if (!context.includes("hasChanged") && !context.includes("!==") && !context.includes("!= ")) {
+            issues.push({
+                file: filePath,
+                line: lineNumber,
+                pattern: "embedded-sync-no-guard",
+                message: "Embedded mode sync calls callback in deps without value comparison - infinite loop risk",
+                severity: "error",
+            });
+        }
+    }
+}
+// =============================================================================
+// MAIN RUN FUNCTION
+// =============================================================================
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    const startTime = Date.now();
+    const issues = [];
+    const files = await (0, glob_1.glob)("**/*.{tsx,ts}", {
+        ignore: [
+            "node_modules/**",
+            ".next/**",
+            "dist/**",
+            "build/**",
+            "coverage/**",
+            "**/*.test.{ts,tsx}",
+            "**/*.spec.{ts,tsx}",
+        ],
+    });
+    for (const file of files) {
+        analyzeFile(file, issues);
+    }
+    const findings = issues.map((issue) => ({
+        level: issue.severity === "error" ? "error" : "warning",
+        message: `[${issue.pattern}] ${issue.message}`,
+        file: issue.file,
+        startLine: issue.line,
+    }));
+    const errors = issues.filter((i) => i.severity === "error");
+    const passed = errors.length === 0;
+    return {
+        passed,
+        findings,
+        duration: Date.now() - startTime,
+    };
+}
+// =============================================================================
+// CLI ENTRY POINT
+// =============================================================================
+async function main() {
+    console.log(`${console_chars_1.emoji.search} Scanning for useEffect infinite loop patterns...\n`);
+    const result = await run();
+    if (result.passed) {
+        console.log(`${console_chars_1.emoji.success} No risky useEffect patterns detected\n`);
+        const warnings = result.findings?.filter((f) => f.level === "warning") || [];
+        if (warnings.length > 0) {
+            console.log(`${console_chars_1.emoji.warning} ${warnings.length} warning(s) found:\n`);
+            for (const warning of warnings) {
+                console.log(`  ${console_chars_1.chars.warning} ${warning.file}:${warning.startLine}`);
+                console.log(`    ${warning.message}\n`);
+            }
+        }
+        process.exit(0);
+    }
+    const errors = result.findings?.filter((f) => f.level === "error") || [];
+    console.log(`${console_chars_1.emoji.error} ${errors.length} HIGH RISK pattern(s) found:\n`);
+    for (const error of errors) {
+        console.log(`  ${console_chars_1.chars.cross} ${error.file}:${error.startLine}`);
+        console.log(`    ${error.message}\n`);
+    }
+    console.log(`\n${console_chars_1.emoji.memo} To fix infinite loop patterns:`);
+    console.log(`  1. Remove callback from dependency array if not needed`);
+    console.log(`  2. Add value comparison guard (if/!== check) before calling callback`);
+    console.log(`  3. Use useCallback to stabilize callback reference`);
+    process.exit(1);
+}
+// Only run main() if executed directly
+if (require.main === module) {
+    main();
+}
+//# sourceMappingURL=useeffect-loop-detector.js.map

package/dist/checks/react/useeffect-loop-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useeffect-loop-detector.js","sourceRoot":"","sources":["../../../src/checks/react/useeffect-loop-detector.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0IH,kBAoCC;AA5KD,4CAA8B;AAI9B,6DAAyD;AACzD,uFAAwF;AACxF,+BAA4B;AAE5B,gFAAgF;AAChF,WAAW;AACX,gFAAgF;AAEnE,QAAA,EAAE,GAAG,+BAA+B,CAAC;AACrC,QAAA,IAAI,GAAG,kCAAkC,CAAC;AAC1C,QAAA,WAAW,GAAG,gFAAgF,CAAC;AAC/F,QAAA,QAAQ,GAAG,OAAO,CAAC;AACnB,QAAA,QAAQ,GAAG,IAAI,CAAC;AAChB,QAAA,IAAI,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;AACvE,QAAA,QAAQ,GAAG,CAAC,OAAO,CAAC,CAAC;AAelC,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF,gEAAgE;AAChE,MAAM,kBAAkB,GAAG;IACzB;QACE,0DAA0D;QAC1D,KAAK,EAAE,2GAA2G;QAClH,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,uFAAuF;QAChG,QAAQ,EAAE,OAAgB;QAC1B,QAAQ,EAAE,CAAC,KAAuB,EAAE,EAAE;YACpC,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACrC,CAAC;KACF;CACF,CAAC;AAEF,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF,SAAS,WAAW,CAAC,QAAgB,EAAE,MAAe;IACpD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEnD,uBAAuB;IACvB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACnC,OAAO;IACT,CAAC;IAED,2BAA2B;IAC3B,KAAK,MAAM,OAAO,IAAI,kBAAkB,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;QACxE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YAExE,oCAAoC;YACpC,IAAI,OAAO,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,SAAS;YACX,CAAC;YAED,8CAA8C;YAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAM,GAAG,GAAG,CAAC,CAAC;YACrD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,KAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;YAClF,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;YAE5D,0DAA0D;YAC1D,IACE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBACvB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAClC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;gBACpC,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,EAC9D,CAAC;gBACD,SAAS;YACX,CAAC;YAED,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,OAAO,CAAC,IAAI;gBACrB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;aACpC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,MAAM,eAAe,GAAG,gIAAgI,CAAC;IACzJ,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAE1D,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;QACpC,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEtB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QACxE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,KAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QAClF,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,KAAM,EAAE,UAAU,CAAC,CAAC;QAE5D,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5F,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,wBAAwB;gBACjC,OAAO,EAAE,yFAAyF;gBAClG,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEzE,KAAK,UAAU,GAAG;IACvB,MAAM,QAAQ,GAAG,IAAA,6DAA+B,EAAC,YAAI,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,MAAM,KAAK,GAAG,MAAM,IAAA,WAAI,EAAC,eAAe,EAAE;QACxC,MAAM,EAAE;YACN,iBAAiB;YACjB,UAAU;YACV,SAAS;YACT,UAAU;YACV,aAAa;YACb,oBAAoB;YACpB,oBAAoB;SACrB;KACF,CAAC,CAAC;IAEH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,QAAQ,GAAuB,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1D,KAAK,EAAE,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;QACvD,OAAO,EAAE,IAAI,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE;QAC9C,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,KAAK,CAAC,IAAI;KACtB,CAAC,CAAC,CAAC;IAEJ,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;IAEnC,OAAO;QACL,MAAM;QACN,QAAQ;QACR,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;KACjC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,KAAK,UAAU,IAAI;IACjB,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,MAAM,qDAAqD,CAAC,CAAC;IAElF,MAAM,MAAM,GAAG,MAAM,GAAG,EAAE,CAAC;IAE3B,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,OAAO,yCAAyC,CAAC,CAAC;QAEvE,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;QAC7E,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,OAAO,IAAI,QAAQ,CAAC,MAAM,sBAAsB,CAAC,CAAC;YACvE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;gBACvE,OAAO,CAAC,GAAG,CAAC,OAAO,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,GAAG,qBAAK,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,gCAAgC,CAAC,CAAC;IAE7E,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,qBAAK,CAAC,IAAI,iCAAiC,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;IACxE,OAAO,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;IACtF,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;IAEpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,uCAAuC;AACvC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/checks/runtime/client-process-env-usage.d.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env tsx
+/**
+ * Preflight: Disallow process.env usage in client code
+ *
+ * Next.js 16+ (Turbopack) client bundles may not provide a runtime `process` shim.
+ * Direct `process.env.*` usage in client components/hooks can crash the browser.
+ *
+ * Rule:
+ * - For any file that is a client component (has "use client" in the first ~10 lines),
+ *   disallow any `process.env` usage.
+ * - For any file under hooks/, disallow any `process.env` usage (hooks run client-side).
+ *
+ * Use `publicEnv` from `lib/public-env.ts` instead.
+ *
+ * Opt-out per file (rare): add `preflight:allow-process-env` anywhere in the file.
+ */
+export declare const id = "runtime/client-process-env-usage";
+export declare const name = "Client Process Env Usage";
+export declare const category = "runtime";
+export declare const blocking = false;
+export declare const description = "Preflight: Disallow process.env usage in client code";
+export declare const tags: string[];
+export declare const requires: string[];
+export declare function run(): Promise<{
+    errors: number;
+    warnings: number;
+}>;
+//# sourceMappingURL=client-process-env-usage.d.ts.map

package/dist/checks/runtime/client-process-env-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-process-env-usage.d.ts","sourceRoot":"","sources":["../../../src/checks/runtime/client-process-env-usage.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG;AAYH,eAAO,MAAM,EAAE,qCAAqC,CAAC;AACrD,eAAO,MAAM,IAAI,6BAA6B,CAAC;AAC/C,eAAO,MAAM,QAAQ,YAAY,CAAC;AAClC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,yDAAyD,CAAC;AAClF,eAAO,MAAM,IAAI,UAAc,CAAC;AAChC,eAAO,MAAM,QAAQ,UAAW,CAAC;AAsHjC,wBAAsB,GAAG,IAAI,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAsCzE"}