@empline/preflight 1.1.0

package/dist/checks/react/memory-leak-patterns.js

@@ -0,0 +1,330 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Memory Leak Patterns Detection Preflight (BLOCKING)
+ *
+ * Detects common memory leak patterns in React/Next.js applications.
+ * Goes beyond just event listeners to catch:
+ * - Uncleared intervals/timeouts
+ * - Unsubscribed observables/subscriptions
+ * - Unclosed WebSocket connections
+ * - Retained DOM references in closures
+ * - Missing AbortController cleanup
+ * - Async state updates after unmount
+ *
+ * Usage:
+ *   pnpm preflight:memory-leak-patterns
+ *   pnpm preflight:memory-leak-patterns --verbose
+ *   pnpm preflight:memory-leak-patterns --blocking
+ *
+ * @since 2026-01-03
+ */
+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 console_chars_1 = require("../../utils/console-chars");
+const file_cache_1 = require("../../shared/file-cache");
+const exclusions_1 = require("../../shared/exclusions");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+// Check metadata
+exports.id = "react/memory-leak-patterns";
+exports.name = "Memory Leak Patterns";
+exports.category = "react";
+exports.blocking = true;
+exports.description = "Memory Leak Patterns Detection Preflight (BLOCKING)";
+exports.tags = ["react"];
+exports.requires = ["react"];
+const isVerbose = process.argv.includes("--verbose");
+const isBlocking = process.argv.includes("--blocking");
+// Memory leak patterns to detect
+const LEAK_PATTERNS = [
+    // Interval without cleanup
+    {
+        pattern: /setInterval\s*\(/g,
+        cleanupPattern: /clearInterval/,
+        type: "uncleaned-interval",
+        message: "setInterval without matching clearInterval in cleanup",
+        suggestion: "Store interval ID and call clearInterval in useEffect cleanup or component unmount",
+        severity: "error",
+    },
+    // Timeout that updates state
+    {
+        pattern: /setTimeout\s*\([^)]*set\w+\s*\(/g,
+        cleanupPattern: /clearTimeout/,
+        type: "uncleaned-timeout-state",
+        message: "setTimeout updating state without cleanup - may cause 'setState on unmounted component'",
+        suggestion: "Use clearTimeout in cleanup, or use a ref to track mounted state",
+        severity: "warning",
+    },
+    // WebSocket without close
+    {
+        pattern: /new\s+WebSocket\s*\(/g,
+        cleanupPattern: /\.close\s*\(|ws\.close|socket\.close|websocket\.close/i,
+        type: "unclosed-websocket",
+        message: "WebSocket created without visible close() in cleanup",
+        suggestion: "Call websocket.close() in useEffect cleanup",
+        severity: "error",
+    },
+    // EventSource without close
+    {
+        pattern: /new\s+EventSource\s*\(/g,
+        cleanupPattern: /\.close\s*\(/,
+        type: "unclosed-eventsource",
+        message: "EventSource created without close() in cleanup",
+        suggestion: "Call eventSource.close() in useEffect cleanup",
+        severity: "error",
+    },
+    // Observer without disconnect
+    {
+        pattern: /new\s+(?:Mutation|Intersection|Resize)Observer\s*\(/g,
+        cleanupPattern: /\.disconnect\s*\(/,
+        type: "undisconnected-observer",
+        message: "Observer created without disconnect() in cleanup",
+        suggestion: "Call observer.disconnect() in useEffect cleanup",
+        severity: "error",
+    },
+    // Subscription without unsubscribe (RxJS/Observable patterns)
+    {
+        pattern: /\.subscribe\s*\(/g,
+        cleanupPattern: /\.unsubscribe\s*\(|subscription\.unsubscribe/,
+        type: "unsubscribed-observable",
+        message: "Observable subscribed without unsubscribe in cleanup",
+        suggestion: "Store subscription and call unsubscribe() in cleanup, or use takeUntil pattern",
+        severity: "warning",
+    },
+    // Fetch without AbortController in useEffect
+    {
+        pattern: /useEffect\s*\(\s*(?:async\s*)?\(\s*\)\s*=>\s*\{[^}]*fetch\s*\(/gs,
+        cleanupPattern: /AbortController|signal\s*:|isMounted|let\s+mounted/,
+        type: "fetch-without-abort",
+        message: "fetch in useEffect without AbortController - requests may complete after unmount",
+        suggestion: "Use AbortController and pass signal to fetch, abort in cleanup",
+        severity: "warning",
+    },
+    // Async state update without mounted check
+    // Only flag in useEffect context, not in event handlers
+    {
+        pattern: /useEffect\s*\([^]*?await\s+[^;]+;\s*set\w+\s*\(/gs,
+        cleanupPattern: /isMounted|mountedRef|aborted|signal\.aborted|AbortController/,
+        type: "async-state-update",
+        message: "Async operation in useEffect followed by setState without mounted/aborted check",
+        suggestion: "Check if component is still mounted before updating state, or use AbortController",
+        severity: "warning",
+    },
+    // Global event listener in component (window/document)
+    {
+        pattern: /(?:window|document)\.addEventListener\s*\(/g,
+        cleanupPattern: /(?:window|document)\.removeEventListener/,
+        type: "global-event-listener",
+        message: "Global event listener without removeEventListener in cleanup",
+        suggestion: "Add removeEventListener in useEffect cleanup with same handler reference",
+        severity: "error",
+    },
+    // Storing DOM refs in module scope
+    {
+        pattern: /^(?:let|var)\s+\w+Element\s*(?::|=)/gm,
+        cleanupPattern: /= null|= undefined/,
+        type: "module-dom-ref",
+        message: "DOM element stored in module-level variable - potential memory leak",
+        suggestion: "Use useRef for DOM references, or ensure cleanup sets to null",
+        severity: "warning",
+    },
+];
+// Essential default exclusions (the rest come from app config)
+const EXCLUDE_PATTERNS = [
+    "node_modules",
+    "__mocks__",
+    ".next",
+    "dist",
+    "coverage",
+];
+let appExclusions = [];
+function shouldSkip(filePath) {
+    const normalized = filePath.replace(/\\/g, "/");
+    // Check app-configured exclusions first
+    if ((0, exclusions_1.shouldExcludeFile)(normalized, appExclusions)) {
+        return true;
+    }
+    return EXCLUDE_PATTERNS.some((pattern) => {
+        if (pattern.startsWith("*")) {
+            return normalized.endsWith(pattern.slice(1));
+        }
+        return normalized.includes(pattern);
+    });
+}
+function scanFileForLeaks(filePath) {
+    const issues = [];
+    if (shouldSkip(filePath))
+        return issues;
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        const lines = content.split("\n");
+        // Only check React components (files with hooks or JSX)
+        const isReactComponent = content.includes("useEffect") ||
+            content.includes("useState") ||
+            content.includes("React.Component") ||
+            content.includes("extends Component");
+        if (!isReactComponent)
+            return issues;
+        for (const leak of LEAK_PATTERNS) {
+            const patternRegex = new RegExp(leak.pattern.source, leak.pattern.flags);
+            let match;
+            while ((match = patternRegex.exec(content)) !== null) {
+                const beforeMatch = content.slice(0, match.index);
+                const lineNumber = beforeMatch.split("\n").length;
+                const line = lines[lineNumber - 1] || "";
+                // Skip if in a comment
+                if (line.trim().startsWith("//") || line.trim().startsWith("*")) {
+                    continue;
+                }
+                // Skip if suppressed
+                if (line.includes("memory-leak-ok") ||
+                    line.includes("@cleanup-handled") ||
+                    content.includes("// memory-leak-ok")) {
+                    continue;
+                }
+                // Look for cleanup pattern in the same file
+                const hasCleanup = leak.cleanupPattern.test(content);
+                // For more precise checking, look for cleanup in nearby useEffect return
+                let hasNearbyCleanup = false;
+                // Find the useEffect that contains this pattern
+                const useEffectRegex = /useEffect\s*\(\s*(?:async\s*)?\([^)]*\)\s*=>\s*\{([\s\S]*?)\}\s*,\s*\[/g;
+                let effectMatch;
+                while ((effectMatch = useEffectRegex.exec(content)) !== null) {
+                    const effectBody = effectMatch[1];
+                    const effectStart = effectMatch.index;
+                    const effectEnd = effectStart + effectMatch[0].length;
+                    // Check if our pattern is within this useEffect
+                    if (match.index >= effectStart && match.index <= effectEnd) {
+                        // Check if there's a cleanup function (return statement)
+                        const hasReturnCleanup = /return\s*(?:\(\s*\)\s*=>|\(\s*function|=>)/.test(effectBody);
+                        if (hasReturnCleanup && leak.cleanupPattern.test(effectBody)) {
+                            hasNearbyCleanup = true;
+                        }
+                    }
+                }
+                if (!hasCleanup && !hasNearbyCleanup) {
+                    issues.push({
+                        type: leak.type,
+                        file: filePath.replace(/\\/g, "/"),
+                        line: lineNumber,
+                        message: leak.message,
+                        severity: leak.severity,
+                        suggestion: leak.suggestion,
+                    });
+                }
+            }
+        }
+    }
+    catch {
+        // Skip unreadable files
+    }
+    return issues;
+}
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    console.log(`\n${console_chars_1.emoji.warning} Memory Leak Patterns Detection`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`Checking for ${LEAK_PATTERNS.length} memory leak patterns\n`);
+    appExclusions = await (0, exclusions_1.getExclusions)(exports.id);
+    const allIssues = [];
+    // Get all component files
+    const files = await file_cache_1.fileCache.getComponentFiles();
+    console.log(`${console_chars_1.emoji.search} Scanning ${files.length} component files...\n`);
+    for (const file of files) {
+        const issues = scanFileForLeaks(file);
+        allIssues.push(...issues);
+    }
+    // Group by type for better reporting
+    const byType = new Map();
+    for (const issue of allIssues) {
+        const existing = byType.get(issue.type) || [];
+        existing.push(issue);
+        byType.set(issue.type, existing);
+    }
+    // Report results
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    const errors = allIssues.filter((i) => i.severity === "error");
+    const warnings = allIssues.filter((i) => i.severity === "warning");
+    if (allIssues.length === 0) {
+        console.log(`${console_chars_1.emoji.success} No memory leak patterns detected`);
+    }
+    else {
+        for (const [type, issues] of byType) {
+            const severity = issues[0].severity;
+            const icon = severity === "error" ? console_chars_1.emoji.error : console_chars_1.emoji.warning;
+            console.log(`\n${icon} ${type.toUpperCase()} (${issues.length}):`);
+            for (const issue of issues.slice(0, isVerbose ? issues.length : 3)) {
+                console.log(`   ${issue.file}:${issue.line}`);
+                console.log(`   ${console_chars_1.chars.treeCorner} ${issue.message}`);
+                console.log(`      Fix: ${issue.suggestion}\n`);
+            }
+            if (!isVerbose && issues.length > 3) {
+                console.log(`   ... and ${issues.length - 3} more\n`);
+            }
+        }
+    }
+    console.log("\n" + (0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`${console_chars_1.emoji.chart} Memory Leak Detection Summary`);
+    console.log(`   Files scanned: ${files.length}`);
+    console.log(`   ${console_chars_1.emoji.error} Errors: ${errors.length}`);
+    console.log(`   ${console_chars_1.emoji.warning} Warnings: ${warnings.length}`);
+    if (allIssues.length > 0) {
+        console.log("\n   Issue types:");
+        for (const [type, issues] of byType) {
+            console.log(`   • ${type}: ${issues.length}`);
+        }
+    }
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    if (isBlocking && errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} MEMORY LEAK DETECTION FAILED`);
+        console.log("   Fix memory leak patterns before deploying.");
+        process.exit(1);
+    }
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning} MEMORY LEAK PATTERNS DETECTED (non-blocking)`);
+        console.log("   Run with --blocking to enforce.");
+        process.exit(0);
+    }
+    console.log(`\n${console_chars_1.emoji.success} MEMORY LEAK DETECTION PASSED`);
+    process.exit(0);
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=memory-leak-patterns.js.map

package/dist/checks/react/memory-leak-patterns.js.map

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

package/dist/checks/react/pagination-state-consolidation.d.ts

@@ -0,0 +1,29 @@
+#!/usr/bin/env tsx
+/**
+ * Pagination State Consolidation Preflight
+ *
+ * Detects manual pagination state management that should use a custom hook
+ * for consistency and reduced boilerplate.
+ *
+ * Anti-patterns detected:
+ * - Manual useState for page + totalPages + pageSize together
+ * - Inline Math.ceil(total / pageSize) calculations
+ * - Manual page boundary calculations and offset computation
+ *
+ * Best practices:
+ * - usePagination() hook encapsulating page, pageSize, totalPages, offset
+ * - Derived state for calculations (totalPages, offset)
+ * - Consistent pagination API across components
+ *
+ * Usage:
+ *   npx preflight react/pagination-state-consolidation
+ */
+export declare const id = "react/pagination-state-consolidation";
+export declare const name = "Pagination State Consolidation";
+export declare const description = "Detects manual pagination state - use consolidated hook instead";
+export declare const category = "react";
+export declare const blocking = false;
+export declare const tags: string[];
+export declare const requires: string[];
+export declare function run(): Promise<boolean>;
+//# sourceMappingURL=pagination-state-consolidation.d.ts.map

package/dist/checks/react/pagination-state-consolidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-state-consolidation.d.ts","sourceRoot":"","sources":["../../../src/checks/react/pagination-state-consolidation.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG;AASH,eAAO,MAAM,EAAE,yCAAyC,CAAC;AACzD,eAAO,MAAM,IAAI,mCAAmC,CAAC;AACrD,eAAO,MAAM,WAAW,oEAAoE,CAAC;AAC7F,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,IAAI,UAAwD,CAAC;AAC1E,eAAO,MAAM,QAAQ,UAAY,CAAC;AAiJlC,wBAAsB,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CA0E5C"}

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

@@ -0,0 +1,258 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Pagination State Consolidation Preflight
+ *
+ * Detects manual pagination state management that should use a custom hook
+ * for consistency and reduced boilerplate.
+ *
+ * Anti-patterns detected:
+ * - Manual useState for page + totalPages + pageSize together
+ * - Inline Math.ceil(total / pageSize) calculations
+ * - Manual page boundary calculations and offset computation
+ *
+ * Best practices:
+ * - usePagination() hook encapsulating page, pageSize, totalPages, offset
+ * - Derived state for calculations (totalPages, offset)
+ * - Consistent pagination API across components
+ *
+ * Usage:
+ *   npx preflight react/pagination-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/pagination-state-consolidation";
+exports.name = "Pagination State Consolidation";
+exports.description = "Detects manual pagination state - use consolidated hook instead";
+exports.category = "react";
+exports.blocking = false;
+exports.tags = ["react", "pagination", "hooks", "state", "refactor"];
+exports.requires = ["react"];
+// Pagination-related useState patterns
+const PAGINATION_STATE_PATTERNS = [
+    { pattern: /const\s+\[\s*(?:current)?[Pp]age\s*,/, name: "page" },
+    { pattern: /const\s+\[\s*total[Pp]ages?\s*,/, name: "totalPages" },
+    { pattern: /const\s+\[\s*page[Ss]ize\s*,/, name: "pageSize" },
+    { pattern: /const\s+\[\s*(?:per[Pp]age|limit)\s*,/, name: "perPage" },
+    { pattern: /const\s+\[\s*offset\s*,/, name: "offset" },
+    { pattern: /const\s+\[\s*skip\s*,/, name: "skip" },
+];
+// Manual calculation patterns
+const MANUAL_CALC_PATTERNS = [
+    {
+        pattern: /Math\.ceil\s*\(\s*(?:total|count|\w+)\s*\/\s*(?:pageSize|limit|perPage|\d+)\s*\)/,
+        name: "manual-total-pages",
+        message: "Manual totalPages calculation",
+        suggestion: "Use a pagination hook that derives totalPages automatically",
+    },
+    {
+        pattern: /\(\s*(?:page|currentPage)\s*-\s*1\s*\)\s*\*\s*(?:pageSize|limit)/,
+        name: "manual-offset",
+        message: "Manual offset calculation",
+        suggestion: "Use a pagination hook that provides offset automatically",
+    },
+    {
+        pattern: /(?:page|currentPage)\s*\*\s*(?:pageSize|limit)/,
+        name: "manual-skip",
+        message: "Manual skip/offset calculation",
+        suggestion: "Encapsulate this calculation in a pagination hook",
+    },
+];
+// Good patterns
+const GOOD_PATTERNS = [
+    /usePagination\s*\(/,
+    /useUnifiedPagination\s*\(/,
+    /usePaginatedQuery\s*\(/,
+    /useInfiniteQuery\s*\(/,
+    /useSWRInfinite\s*\(/,
+    /from\s+["'].*usePagination["']/,
+    /import.*usePagination/,
+];
+async function findComponentFiles() {
+    const patterns = [
+        "app/**/*.tsx",
+        "src/app/**/*.tsx",
+        "components/**/*.tsx",
+        "src/components/**/*.tsx",
+        "pages/**/*.tsx",
+        "src/pages/**/*.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",
+                "**/usePagination.ts*",
+                "**/Pagination.tsx",
+            ],
+        });
+        allFiles.push(...matches);
+    }
+    return 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 pagination-related useState hooks
+    const foundStates = [];
+    for (const { pattern, name } of PAGINATION_STATE_PATTERNS) {
+        if (pattern.test(content)) {
+            foundStates.push(name);
+        }
+    }
+    // If 2+ pagination states found without hook
+    if (foundStates.length >= 2) {
+        issues.push({
+            file: filePath,
+            line: 1,
+            severity: foundStates.length >= 3 ? "warning" : "info",
+            message: `Manual pagination state: ${foundStates.join(", ")}`,
+            suggestion: "Create a usePagination() hook to consolidate pagination logic",
+            code: "manual-pagination-state",
+        });
+    }
+    // Check for manual calculations
+    for (const calc of MANUAL_CALC_PATTERNS) {
+        const match = content.match(calc.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: calc.message,
+                suggestion: calc.suggestion,
+                code: calc.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} Pagination State Consolidation Preflight`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    const files = await findComponentFiles();
+    if (files.length === 0) {
+        console.log(`${console_chars_1.emoji.info}  No component files found`);
+        console.log(`${console_chars_1.emoji.success} Check passed (no files to validate)`);
+        return true;
+    }
+    console.log(`Scanning ${files.length} 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} Pagination patterns are consistent`);
+    }
+    console.log(`\n${console_chars_1.emoji.docs} Recommended hook:`);
+    console.log(`   ${console_chars_1.chars.bullet} function usePagination({ total, pageSize = 10 }) {`);
+    console.log(`       const [page, setPage] = useState(1);`);
+    console.log(`       const totalPages = Math.ceil(total / pageSize);`);
+    console.log(`       const offset = (page - 1) * pageSize;`);
+    console.log(`       return { page, setPage, totalPages, offset, pageSize };`);
+    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=pagination-state-consolidation.js.map

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

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

package/dist/checks/react/react19-compatibility.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env tsx
+/**
+ * React 19+ Compatibility Preflight (BLOCKING)
+ *
+ * Ensures codebase is ready for React 19 and future versions.
+ * Detects deprecated patterns and enforces new APIs.
+ */
+export declare const id = "react/react19-compatibility";
+export declare const name = "React19 Compatibility";
+export declare const category = "react";
+export declare const blocking = true;
+export declare const description = "React 19+ Compatibility Preflight (BLOCKING)";
+export declare const tags: string[];
+export declare const requires: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=react19-compatibility.d.ts.map