@empline/preflight 1.0.20

package/dist/checks/react/component-best-practices.js

@@ -0,0 +1,273 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * React Component Best Practices Preflight
+ *
+ * Validates React components follow performance and maintainability best practices:
+ *
+ * - useMemo/useCallback for expensive computations
+ * - Proper key usage in lists
+ * - No inline object/array creation in JSX props
+ * - Proper dependency arrays in hooks
+ * - No state updates in render
+ *
+ * Usage:
+ *   pnpm preflight:react-best-practices
+ *   pnpm preflight:react-best-practices --verbose
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.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 = "react/component-best-practices";
+exports.name = "Component Best Practices";
+exports.category = "react";
+exports.blocking = false;
+exports.description = "React Component Best Practices Preflight";
+exports.tags = ["react"];
+const isVerbose = process.argv.includes("--verbose");
+console.log(`${console_chars_1.emoji.gear}  React Component Best Practices Preflight`);
+console.log((0, console_chars_1.createDivider)(60, "heavy"));
+const issues = [];
+// Best practice checks
+const CHECKS = [
+    {
+        name: "duplicate-jsx-attribute",
+        // Matches elements with duplicate className, style, or other common attributes
+        // Pattern: <Element attr="..." ... attr="..." or <Element attr={...} ... attr={...}
+        pattern: /<\w+[^>]*\s\b(className|style|id|key|ref|onClick|onChange|onSubmit)(?:=["'{][^"'}]*["'}]|=\{[^}]*\})[^<>]*\s\b\1(?:=["'{]|=\{)/g,
+        message: "Duplicate JSX attribute detected. Only the last value will be used, causing silent bugs.",
+        type: "error",
+    },
+    {
+        name: "inline-object-props",
+        // Matches style={{...}} or similar inline objects in JSX
+        pattern: /(?:style|sx|className)=\{\{[^}]+\}\}/g,
+        message: "Inline object in JSX prop causes re-renders. Extract to useMemo or constant.",
+        type: "warning",
+        // Skip if it's a simple static object
+        skipIf: (match) => {
+            const content = match.replace(/\s+/g, "");
+            // Skip simple static values like style={{display:'flex'}}
+            return (content.split(",").length <= 2 && !content.includes("props") && !content.includes("state"));
+        },
+    },
+    {
+        name: "inline-array-props",
+        // Matches prop={[...]} inline arrays
+        pattern: /\w+=\{\[[^\]]{20,}\]\}/g,
+        message: "Inline array in JSX prop causes re-renders. Extract to useMemo or constant.",
+        type: "warning",
+    },
+    {
+        name: "inline-function-props",
+        // Matches onClick={() => ...} with complex logic
+        pattern: /on\w+=\{\(\)\s*=>\s*\{[^}]{50,}\}\}/g,
+        message: "Complex inline function in event handler. Consider useCallback.",
+        type: "info",
+    },
+    {
+        name: "missing-key-in-map",
+        // Matches .map( without key= nearby
+        pattern: /\.map\(\s*\([^)]*\)\s*=>\s*(?:<\w+(?![^>]*\bkey=))/g,
+        message: "List item may be missing key prop. Add unique key to mapped elements.",
+        type: "error",
+    },
+    {
+        name: "index-as-key",
+        // Matches key={index} or key={i}
+        pattern: /key=\{(?:index|i|idx)\}/g,
+        message: "Using array index as key can cause issues with reordering. Use unique ID.",
+        type: "warning",
+    },
+    {
+        name: "state-in-render",
+        // Matches setState outside of useEffect/handlers
+        pattern: /(?<!useEffect\([^)]*|on\w+\s*=\s*\{[^}]*)set\w+\([^)]+\)(?![^{]*\})/g,
+        message: "Possible state update during render. Move to useEffect or event handler.",
+        type: "error",
+        // This is complex to detect accurately, so we'll be conservative
+        skipIf: () => true, // Disabled for now - too many false positives
+    },
+    {
+        name: "missing-deps-comment",
+        // Matches useEffect/useMemo/useCallback with empty deps and no comment
+        pattern: /use(?:Effect|Memo|Callback)\([^,]+,\s*\[\]\s*\)(?!\s*\/\/)/g,
+        message: "Empty dependency array without comment. Add // eslint-disable or explain why.",
+        type: "info",
+    },
+    {
+        name: "large-component",
+        // Check component size (handled separately)
+        pattern: null,
+        message: "Component exceeds 300 lines. Consider splitting into smaller components.",
+        type: "warning",
+    },
+    {
+        name: "no-memo-expensive",
+        // Matches expensive operations without useMemo
+        pattern: /(?<!useMemo\(\s*\(\)\s*=>\s*)(?:\.filter\(|\.map\(|\.reduce\(|\.sort\(|Object\.keys\(|Object\.values\(|JSON\.parse\()/g,
+        message: "Expensive operation may benefit from useMemo.",
+        type: "info",
+        // Only flag if in component body, not in hooks
+        contextCheck: (content, matchIndex) => {
+            const before = content.substring(Math.max(0, matchIndex - 200), matchIndex);
+            // Skip if inside useEffect, useMemo, useCallback, or event handler
+            return !/(useEffect|useMemo|useCallback|on\w+\s*=\s*\{)\s*\([^)]*$/s.test(before);
+        },
+    },
+];
+// CACHED FILE LISTS - Scan once, use everywhere
+let _cachedAppComponentsTsxFiles = null;
+async function getAppComponentsTsxFiles() {
+    if (!_cachedAppComponentsTsxFiles) {
+        _cachedAppComponentsTsxFiles = await file_cache_1.fileCache.getAppAndComponentsTSX();
+    }
+    return _cachedAppComponentsTsxFiles;
+}
+async function main() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(path.basename(__filename, ".ts"));
+    // Find all React component files
+    const files = await getAppComponentsTsxFiles();
+    console.log(`\n${console_chars_1.emoji.search} Checking ${files.length} React components...\n`);
+    for (const file of files) {
+        const content = fs.readFileSync(file, "utf-8");
+        const lines = content.split("\n");
+        const relativePath = path.relative(process.cwd(), file);
+        // Skip non-component files
+        if (!content.includes("React") && !content.includes("use") && !content.includes("export")) {
+            continue;
+        }
+        if (isVerbose) {
+            console.log(`${console_chars_1.emoji.file} ${relativePath}`);
+        }
+        // Check component size
+        if (lines.length > 300) {
+            issues.push({
+                file: relativePath,
+                line: 1,
+                type: "warning",
+                rule: "large-component",
+                message: `Component has ${lines.length} lines. Consider splitting.`,
+            });
+        }
+        // Run pattern checks
+        for (const check of CHECKS) {
+            if (!check.pattern)
+                continue;
+            let match;
+            const regex = new RegExp(check.pattern.source, check.pattern.flags);
+            while ((match = regex.exec(content)) !== null) {
+                // Skip if skipIf returns true
+                if (check.skipIf && check.skipIf(match[0])) {
+                    continue;
+                }
+                // Skip if contextCheck returns false
+                if (check.contextCheck && !check.contextCheck(content, match.index)) {
+                    continue;
+                }
+                const lineNum = content.substring(0, match.index).split("\n").length;
+                issues.push({
+                    file: relativePath,
+                    line: lineNum,
+                    type: check.type,
+                    rule: check.name,
+                    message: check.message,
+                });
+            }
+        }
+    }
+    // Report results
+    const errors = issues.filter((i) => i.type === "error");
+    const warnings = issues.filter((i) => i.type === "warning");
+    const infos = issues.filter((i) => i.type === "info");
+    if (issues.length === 0) {
+        console.log(`${console_chars_1.emoji.success} All components follow best practices`);
+        process.exit(0);
+    }
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`${console_chars_1.emoji.clipboard} Best Practice Issues:`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    // Group by rule
+    const byRule = new Map();
+    for (const issue of issues) {
+        const existing = byRule.get(issue.rule) || [];
+        existing.push(issue);
+        byRule.set(issue.rule, existing);
+    }
+    for (const [rule, ruleIssues] of byRule) {
+        const icon = ruleIssues[0].type === "error"
+            ? `${console_chars_1.emoji.error}`
+            : ruleIssues[0].type === "warning"
+                ? `${console_chars_1.emoji.warning}`
+                : `${console_chars_1.emoji.info}`;
+        console.log(`\n${icon} ${rule} (${ruleIssues.length} occurrences)`);
+        console.log(`   ${ruleIssues[0].message}`);
+        if (isVerbose) {
+            for (const issue of ruleIssues.slice(0, 10)) {
+                console.log(`   - ${issue.file}:${issue.line}`);
+            }
+            if (ruleIssues.length > 10) {
+                console.log(`   ... and ${ruleIssues.length - 10} more`);
+            }
+        }
+    }
+    console.log("\n" + (0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`${console_chars_1.emoji.chart} Summary:`);
+    console.log(`   Errors:   ${errors.length}`);
+    console.log(`   Warnings: ${warnings.length}`);
+    console.log(`   Info:     ${infos.length}`);
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} FAILED: Critical best practice violations found`);
+        process.exit(1);
+    }
+    if (warnings.length > 0) {
+        console.log(`\n${console_chars_1.emoji.warning}  PASSED with warnings`);
+    }
+    else {
+        console.log(`\n${console_chars_1.emoji.success} PASSED`);
+    }
+    process.exit(0);
+}
+main().catch((error) => {
+    console.error("Error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=component-best-practices.js.map

package/dist/checks/react/component-best-practices.js.map

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

package/dist/checks/react/error-boundary-coverage.d.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env tsx
+/**
+ * Error Boundary Coverage Preflight (BLOCKING)
+ *
+ * Ensures all page routes and critical components have error boundaries.
+ * Prevents unhandled React errors from crashing the entire application.
+ *
+ * Checks for:
+ * - All page.tsx files have corresponding error.tsx
+ * - Critical feature directories have error boundaries
+ * - Layout files handle errors appropriately
+ * - Suspense boundaries for async components
+ *
+ * Usage:
+ *   pnpm preflight:error-boundary-coverage
+ *   pnpm preflight:error-boundary-coverage --verbose
+ *
+ * @since 2026-01-03
+ */
+export declare const id = "react/error-boundary-coverage";
+export declare const name = "Error Boundary Coverage";
+export declare const category = "react";
+export declare const blocking = true;
+export declare const description = "Error Boundary Coverage Preflight (BLOCKING)";
+export declare const tags: string[];
+//# sourceMappingURL=error-boundary-coverage.d.ts.map

package/dist/checks/react/error-boundary-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary-coverage.d.ts","sourceRoot":"","sources":["../../../src/checks/react/error-boundary-coverage.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;GAiBG;AASH,eAAO,MAAM,EAAE,kCAAkC,CAAC;AAClD,eAAO,MAAM,IAAI,4BAA4B,CAAC;AAC9C,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,iDAAiD,CAAC;AAC1E,eAAO,MAAM,IAAI,UAAY,CAAC"}

package/dist/checks/react/error-boundary-coverage.js

@@ -0,0 +1,304 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Error Boundary Coverage Preflight (BLOCKING)
+ *
+ * Ensures all page routes and critical components have error boundaries.
+ * Prevents unhandled React errors from crashing the entire application.
+ *
+ * Checks for:
+ * - All page.tsx files have corresponding error.tsx
+ * - Critical feature directories have error boundaries
+ * - Layout files handle errors appropriately
+ * - Suspense boundaries for async components
+ *
+ * Usage:
+ *   pnpm preflight:error-boundary-coverage
+ *   pnpm preflight:error-boundary-coverage --verbose
+ *
+ * @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.tags = exports.description = exports.blocking = exports.category = exports.name = exports.id = void 0;
+const fs = __importStar(require("fs"));
+const glob_1 = require("glob");
+const path = __importStar(require("path"));
+const console_chars_1 = require("../../utils/console-chars");
+// Check metadata
+exports.id = "react/error-boundary-coverage";
+exports.name = "Error Boundary Coverage";
+exports.category = "react";
+exports.blocking = true;
+exports.description = "Error Boundary Coverage Preflight (BLOCKING)";
+exports.tags = ["react"];
+const isVerbose = process.argv.includes("--verbose");
+// Routes that MUST have error boundaries (BLOCKING)
+const CRITICAL_ROUTES = [
+    "app/(main)",
+    "app/(auth)",
+    "app/store",
+    "app/cart",
+    "app/checkout",
+    "app/account",
+    "app/seller",
+    "app/admin",
+    "app/api",
+];
+// Routes where missing error.tsx is a warning, not error
+const OPTIONAL_ERROR_ROUTES = ["app/(marketing)", "app/legal", "app/help"];
+async function getPageDirectories() {
+    const pages = await (0, glob_1.glob)("app/**/page.tsx", {
+        ignore: ["node_modules/**", ".next/**"],
+    });
+    // Get unique directories
+    const directories = new Set();
+    for (const page of pages) {
+        directories.add(path.dirname(page));
+    }
+    return Array.from(directories);
+}
+async function getLayoutDirectories() {
+    const layouts = await (0, glob_1.glob)("app/**/layout.tsx", {
+        ignore: ["node_modules/**", ".next/**"],
+    });
+    return layouts.map((l) => path.dirname(l));
+}
+function hasFile(dir, filename) {
+    const filePath = path.join(dir, filename);
+    return fs.existsSync(filePath);
+}
+// Check if file exists in this directory or any parent up to app/
+function hasFileOrParent(dir, filename) {
+    let currentDir = path.resolve(dir);
+    const appDir = path.resolve("app");
+    while (currentDir.length >= appDir.length) {
+        if (fs.existsSync(path.join(currentDir, filename))) {
+            return true;
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir)
+            break;
+        currentDir = parentDir;
+    }
+    return false;
+}
+function isCriticalRoute(route) {
+    const normalized = route.replace(/\\/g, "/");
+    return CRITICAL_ROUTES.some((critical) => normalized.startsWith(critical));
+}
+function isOptionalRoute(route) {
+    const normalized = route.replace(/\\/g, "/");
+    return OPTIONAL_ERROR_ROUTES.some((optional) => normalized.startsWith(optional));
+}
+function checkRouteErrorBoundary(route) {
+    const hasError = hasFile(route, "error.tsx");
+    const hasGlobalError = hasFile(route, "global-error.tsx") || fs.existsSync("app/global-error.tsx");
+    if (!hasError && !hasGlobalError) {
+        const isCritical = isCriticalRoute(route);
+        const isOptional = isOptionalRoute(route);
+        return {
+            type: "missing-error",
+            route: route.replace(/\\/g, "/"),
+            message: `Missing error.tsx in ${route}`,
+            severity: isCritical ? "error" : isOptional ? "warning" : "warning",
+        };
+    }
+    return null;
+}
+function checkAsyncComponents(route) {
+    const issues = [];
+    // Check if page has async components that need Suspense
+    const pagePath = path.join(route, "page.tsx");
+    if (!fs.existsSync(pagePath))
+        return issues;
+    try {
+        const content = fs.readFileSync(pagePath, "utf-8");
+        // Check for async component patterns that need loading states
+        const hasAsyncPatterns = content.includes("async function") ||
+            content.includes("await ") ||
+            content.includes("Suspense");
+        // Check for loading.tsx in this route or parent routes (Next.js cascades)
+        const hasLoading = hasFileOrParent(route, "loading.tsx");
+        if (hasAsyncPatterns && !hasLoading && isCriticalRoute(route)) {
+            issues.push({
+                type: "missing-loading",
+                route: route.replace(/\\/g, "/"),
+                message: `Route has async operations but no loading.tsx: ${route}`,
+                severity: "warning",
+            });
+        }
+        // Check for dynamic routes that should have not-found
+        const isDynamicRoute = route.includes("[") && route.includes("]");
+        const hasNotFound = hasFileOrParent(route, "not-found.tsx");
+        if (isDynamicRoute && !hasNotFound && isCriticalRoute(route)) {
+            issues.push({
+                type: "missing-not-found",
+                route: route.replace(/\\/g, "/"),
+                message: `Dynamic route missing not-found.tsx: ${route}`,
+                severity: "warning",
+            });
+        }
+    }
+    catch {
+        // Skip unreadable files
+    }
+    return issues;
+}
+function checkLayoutErrorHandling(layoutDir) {
+    const layoutPath = path.join(layoutDir, "layout.tsx");
+    if (!fs.existsSync(layoutPath))
+        return null;
+    try {
+        const content = fs.readFileSync(layoutPath, "utf-8");
+        // Check if layout wraps children in error boundary for client components
+        const hasClientDirective = content.includes('"use client"');
+        const hasErrorBoundary = content.includes("ErrorBoundary") ||
+            content.includes("error-boundary") ||
+            hasFile(layoutDir, "error.tsx");
+        if (hasClientDirective && !hasErrorBoundary && isCriticalRoute(layoutDir)) {
+            return {
+                type: "missing-error",
+                route: layoutDir.replace(/\\/g, "/"),
+                message: `Client layout missing ErrorBoundary wrapper: ${layoutDir}`,
+                severity: "warning",
+            };
+        }
+    }
+    catch {
+        // Skip unreadable files
+    }
+    return null;
+}
+async function main() {
+    console.log(`\n${console_chars_1.emoji.shield} Error Boundary Coverage Check`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`Critical routes: ${CRITICAL_ROUTES.length}\n`);
+    const allIssues = [];
+    // Check for global error boundary
+    if (!fs.existsSync("app/global-error.tsx")) {
+        console.log(`${console_chars_1.emoji.warning} Missing app/global-error.tsx (root error boundary)`);
+        allIssues.push({
+            type: "missing-error",
+            route: "app",
+            message: "Missing global-error.tsx - root level error boundary",
+            severity: "error",
+        });
+    }
+    else {
+        console.log(`${console_chars_1.emoji.success} Found app/global-error.tsx`);
+    }
+    // Get all page directories
+    const pageDirectories = await getPageDirectories();
+    console.log(`\n${console_chars_1.emoji.search} Checking ${pageDirectories.length} page routes...\n`);
+    // Check each route for error boundaries
+    let coveredRoutes = 0;
+    let uncoveredRoutes = 0;
+    for (const route of pageDirectories) {
+        const errorIssue = checkRouteErrorBoundary(route);
+        if (errorIssue) {
+            allIssues.push(errorIssue);
+            uncoveredRoutes++;
+        }
+        else {
+            coveredRoutes++;
+        }
+        // Check async component coverage
+        const asyncIssues = checkAsyncComponents(route);
+        allIssues.push(...asyncIssues);
+    }
+    // Check layouts
+    const layoutDirectories = await getLayoutDirectories();
+    for (const layoutDir of layoutDirectories) {
+        const layoutIssue = checkLayoutErrorHandling(layoutDir);
+        if (layoutIssue) {
+            allIssues.push(layoutIssue);
+        }
+    }
+    // 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");
+    const coveragePercent = Math.round((coveredRoutes / pageDirectories.length) * 100);
+    if (allIssues.length === 0) {
+        console.log(`${console_chars_1.emoji.success} All routes have error boundary coverage!`);
+    }
+    else {
+        if (errors.length > 0) {
+            console.log(`\n${console_chars_1.emoji.error} CRITICAL - Missing Error Boundaries (${errors.length}):`);
+            for (const issue of errors) {
+                console.log(`   ${issue.route}`);
+                console.log(`   ${console_chars_1.chars.treeCorner} ${issue.message}\n`);
+            }
+        }
+        if (warnings.length > 0 && isVerbose) {
+            console.log(`\n${console_chars_1.emoji.warning} Warnings (${warnings.length}):`);
+            for (const issue of warnings) {
+                console.log(`   ${issue.route}`);
+                console.log(`   ${console_chars_1.chars.treeCorner} ${issue.message}`);
+            }
+        }
+        else if (warnings.length > 0) {
+            console.log(`\n${console_chars_1.emoji.warning} ${warnings.length} warnings (use --verbose to see all)`);
+        }
+        console.log("\n" + (0, console_chars_1.createDivider)(60, "light"));
+        console.log("To add error boundaries:");
+        console.log("   1. Create error.tsx in route directory:");
+        console.log(`      'use client'`);
+        console.log(`      export default function Error({ error, reset }) { ... }`);
+        console.log("   2. For global errors, create app/global-error.tsx");
+        console.log("   3. For loading states, create loading.tsx");
+    }
+    console.log("\n" + (0, console_chars_1.createDivider)(60, "heavy"));
+    console.log(`${console_chars_1.emoji.chart} Error Boundary Coverage Summary`);
+    console.log(`   Total routes: ${pageDirectories.length}`);
+    console.log(`   Covered: ${coveredRoutes} (${coveragePercent}%)`);
+    console.log(`   Uncovered: ${uncoveredRoutes}`);
+    console.log(`   ${console_chars_1.emoji.error} Errors: ${errors.length}`);
+    console.log(`   ${console_chars_1.emoji.warning} Warnings: ${warnings.length}`);
+    console.log((0, console_chars_1.createDivider)(60, "heavy"));
+    if (errors.length > 0) {
+        console.log(`\n${console_chars_1.emoji.error} ERROR BOUNDARY COVERAGE CHECK FAILED`);
+        console.log("   Add error.tsx to critical routes before deploying.");
+        process.exit(1);
+    }
+    console.log(`\n${console_chars_1.emoji.success} ERROR BOUNDARY COVERAGE CHECK PASSED`);
+    process.exit(0);
+}
+main().catch((err) => {
+    console.error(`${console_chars_1.emoji.error} Fatal error:`, err);
+    process.exit(1);
+});
+//# sourceMappingURL=error-boundary-coverage.js.map

package/dist/checks/react/error-boundary-coverage.js.map

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

package/dist/checks/react/memory-leak-detection.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env tsx
+/**
+ * React Memory Leak Detection Preflight (BLOCKING)
+ *
+ * Detects common patterns that cause memory leaks in React:
+ * - setInterval/setTimeout without cleanup
+ * - Event listeners without removeEventListener
+ * - Subscriptions without unsubscribe
+ * - WebSocket connections without close
+ * - AbortController not used for fetch
+ *
+ * Usage:
+ *   pnpm preflight:memory-leaks
+ *   pnpm preflight:memory-leaks:verbose
+ */
+export declare const id = "react/memory-leak-detection";
+export declare const name = "Memory Leak Detection";
+export declare const category = "react";
+export declare const blocking = true;
+export declare const description = "React Memory Leak Detection Preflight (BLOCKING)";
+export declare const tags: string[];
+//# sourceMappingURL=memory-leak-detection.d.ts.map

package/dist/checks/react/memory-leak-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-leak-detection.d.ts","sourceRoot":"","sources":["../../../src/checks/react/memory-leak-detection.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG;AAWH,eAAO,MAAM,EAAE,gCAAgC,CAAC;AAChD,eAAO,MAAM,IAAI,0BAA0B,CAAC;AAC5C,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,WAAW,qDAAqD,CAAC;AAC9E,eAAO,MAAM,IAAI,UAAY,CAAC"}