@empline/preflight 1.0.20

package/dist/checks/architecture/component-consolidation-opportunities.js

@@ -0,0 +1,338 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * Component Consolidation Opportunities Preflight
+ *
+ * Scans the codebase for patterns that suggest shared components should be used.
+ *
+ * BLOCKING ERRORS (will fail build):
+ * - Array map using index as key (React anti-pattern)
+ * - Inline empty state when UnifiedEmptyState exists
+ * - Button with loading logic when LoadingButton exists
+ * - Link wrapping Button (should use asChild)
+ *
+ * WARNINGS (informational):
+ * - Patterns that could use new shared components
+ * - Repeated styling patterns
+ * - State patterns that could use hooks
+ *
+ * Run: pnpm preflight:consolidation-opportunities
+ *
+ * @since 2025-12-29
+ */
+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 console_chars_1 = require("../../utils/console-chars");
+// Check metadata
+exports.id = "architecture/component-consolidation-opportunities";
+exports.name = "Component Consolidation Opportunities";
+exports.category = "architecture";
+exports.blocking = false;
+exports.description = "Component Consolidation Opportunities Preflight";
+exports.tags = ["architecture"];
+// Configuration
+const CONFIG = {
+    minOccurrences: 3,
+    includeDirs: ["app", "components"],
+    maxFiles: 500,
+};
+const JSX_PATTERNS = [
+    {
+        name: "EmptyStateInline",
+        regex: /\{[^}]*\.length\s*===?\s*0[^}]*\?\s*\([^)]*<(?:div|Box|Stack)[^>]*(?:flex|center|justify)[^>]*>[\s\S]*?(?:No\s+\w+|Empty|Nothing)/gi,
+        description: "Inline empty state conditional",
+        suggestedName: "Use UnifiedEmptyState from @/components/shared",
+        blocking: false, // Recommendation, not blocking
+    },
+    {
+        name: "LoadingSpinner",
+        // Match loading spinner with text message pattern
+        // Exclude: inline button spinners, overlay spinners
+        regex: /<(?:div|Box)[^>]*(?:flex[^>]*items-center|items-center[^>]*flex)[^>]*>[\s\S]{0,100}?<(?:CircularProgress|Spinner|Loader2)[^/]*\/?>[\s\S]{0,50}?(?:Loading|Please wait|Searching)/gi,
+        description: "Loading spinner with text",
+        suggestedName: "Use LoadingState from @/components/shared",
+        blocking: false,
+        location: "components/shared/",
+    },
+];
+const PROP_PATTERNS = [
+    {
+        name: "ButtonWithLoading",
+        // Match Button with disabled={loading} or disabled={isLoading} (boolean state, not string comparison)
+        // AND has inline loading text like {loading ? "Loading..." : "Submit"}
+        // Exclude string-based loading states like isLoading === "cancel"
+        regex: /<Button[^>]*disabled=\{(?:loading|isLoading|submitting|isSubmitting)\}[^>]*>[\s\S]*?\{(?:loading|isLoading|submitting|isSubmitting)\s*\?\s*["'][^"']+["']\s*:\s*["'][^"']+["']\}/gi,
+        description: "Button with inline loading state logic",
+        suggestedName: "Use LoadingButton from @/components/shared",
+        blocking: false, // Recommendation, not blocking
+    },
+    {
+        name: "LinkAsButton",
+        regex: /<Link[^>]*href[^>]*>[\s\S]{0,50}?<Button[^>]*(?!asChild)[^>]*>/gi,
+        description: "Link wrapping Button (should use asChild)",
+        suggestedName: "Use <Button asChild><Link>...</Link></Button>",
+        blocking: false, // Recommendation, not blocking
+    },
+    {
+        name: "ConditionalTooltip",
+        // Match pattern where same content is rendered with OR without tooltip
+        // e.g., {condition ? <Tooltip><Content/></Tooltip> : <Content/>}
+        // NOT {condition ? <Tooltip><Content/></Tooltip> : null}
+        regex: /\{[^}]*\?\s*<Tooltip[^>]*>[\s\S]*?<\/Tooltip>\s*:\s*<[A-Z]/g,
+        description: "Conditional tooltip rendering (same content with/without tooltip)",
+        suggestedName: "Use ConditionalTooltip from @/components/shared",
+        blocking: false,
+        location: "components/shared/",
+    },
+];
+const LOGIC_PATTERNS = [
+    {
+        name: "ArrayMapWithIndex",
+        // More precise: only match when key={index} or key={i} or key={idx} directly
+        // Not when index is used elsewhere in the JSX
+        regex: /\.map\s*\(\s*\([^,)]+,\s*(index|i|idx)\s*\)\s*=>\s*(?:\(|\{)[\s\S]{0,100}?key=\{\s*\1\s*\}/gi,
+        description: "Array map using index as key (React anti-pattern)",
+        suggestedName: "Use unique ID as key instead of array index",
+        blocking: true, // TRUE ANTI-PATTERN - blocks build
+    },
+    {
+        name: "ErrorBoundaryInline",
+        // Match inline error display that doesn't use UnifiedStatus
+        // Exclude files that already import UnifiedStatus
+        regex: /\{[^}]*(?:error|isError)\s*(?:\?\s*\(|&&\s*\()[^)]*<(?:Alert|div|Box)[^>]*(?:error|danger|destructive)/gi,
+        description: "Inline error display logic",
+        suggestedName: "Use UnifiedStatus from @/components/shared",
+        blocking: false,
+        location: "components/shared/",
+    },
+];
+const STATE_PATTERNS = [
+    {
+        name: "DebounceState",
+        // More precise: match useState followed by setTimeout with the same state variable
+        regex: /const\s+\[(\w+),\s*set\w+\]\s*=\s*useState[^;]*;[\s\S]*?setTimeout\s*\([^)]*set\w+/gi,
+        description: "State with debounce logic",
+        suggestedName: "Use useDebounce from @/hooks",
+        blocking: false,
+        location: "hooks/",
+    },
+    {
+        name: "LocalStorageState",
+        // More precise: match useState + useEffect with localStorage.getItem for the same key
+        regex: /useState[\s\S]{0,100}?useEffect\s*\(\s*\(\)\s*=>\s*\{[\s\S]{0,200}?localStorage\.getItem\s*\(\s*["'][^"']+["']\s*\)[\s\S]{0,200}?localStorage\.setItem/gi,
+        description: "State synced with localStorage",
+        suggestedName: "Use useLocalStorage from @/hooks",
+        blocking: false,
+        location: "hooks/",
+    },
+];
+// Detection Functions
+function detectPatterns(files, patterns, type) {
+    const opportunities = [];
+    const patternMatches = new Map();
+    for (const [filePath, content] of files) {
+        for (const pattern of patterns) {
+            // Reset regex lastIndex for global patterns
+            pattern.regex.lastIndex = 0;
+            const matches = content.matchAll(pattern.regex);
+            for (const match of matches) {
+                const lineNumber = content.substring(0, match.index).split("\n").length;
+                if (!patternMatches.has(pattern.name)) {
+                    patternMatches.set(pattern.name, []);
+                }
+                patternMatches.get(pattern.name).push({
+                    file: filePath,
+                    line: lineNumber,
+                    snippet: match[0].substring(0, 80).replace(/\s+/g, " ") + "...",
+                });
+            }
+        }
+    }
+    for (const pattern of patterns) {
+        const matches = patternMatches.get(pattern.name) || [];
+        const uniqueFiles = new Set(matches.map((m) => m.file));
+        if (uniqueFiles.size >= CONFIG.minOccurrences) {
+            let priority;
+            if (pattern.blocking) {
+                priority = "error";
+            }
+            else if (uniqueFiles.size >= 5) {
+                priority = "high";
+            }
+            else {
+                priority = "medium";
+            }
+            opportunities.push({
+                type,
+                description: pattern.description,
+                occurrences: matches.slice(0, 5),
+                suggestedName: pattern.suggestedName,
+                suggestedLocation: pattern.location,
+                priority,
+                blocking: pattern.blocking,
+            });
+        }
+    }
+    return opportunities;
+}
+// Main Runner
+async function main() {
+    const startTime = Date.now();
+    const args = process.argv.slice(2);
+    const verbose = args.includes("--verbose") || args.includes("-v");
+    const jsonOutput = args.includes("--json");
+    console.log(`\n${console_chars_1.emoji.search} Component Consolidation Opportunities\n`);
+    console.log((0, console_chars_1.createDivider)(70, "light"));
+    // Gather files
+    const files = new Map();
+    for (const dir of CONFIG.includeDirs) {
+        const pattern = `${dir}/**/*.tsx`;
+        const matches = await (0, glob_1.glob)(pattern, {
+            ignore: [
+                "**/node_modules/**",
+                "**/.next/**",
+                "**/components/shared/**",
+                "**/components/ui/**",
+                "**/tests/**",
+                "**/__mocks__/**",
+            ],
+            cwd: process.cwd(),
+        });
+        for (const file of matches.slice(0, CONFIG.maxFiles)) {
+            try {
+                const content = fs.readFileSync(file, "utf-8");
+                files.set(file, content);
+            }
+            catch {
+                // Skip unreadable files
+            }
+        }
+    }
+    console.log(`${console_chars_1.emoji.folder} Scanned ${files.size} files\n`);
+    console.log(`${console_chars_1.emoji.search} Detecting patterns...`);
+    // Run detectors
+    const allOpportunities = [
+        ...detectPatterns(files, JSX_PATTERNS, "jsx-structure"),
+        ...detectPatterns(files, PROP_PATTERNS, "prop-pattern"),
+        ...detectPatterns(files, LOGIC_PATTERNS, "inline-logic"),
+        ...detectPatterns(files, STATE_PATTERNS, "state-pattern"),
+    ];
+    // Sort by priority
+    const priorityOrder = { error: 0, high: 1, medium: 2, low: 3 };
+    allOpportunities.sort((a, b) => priorityOrder[a.priority] - priorityOrder[b.priority]);
+    // Output
+    if (jsonOutput) {
+        console.log(JSON.stringify(allOpportunities, null, 2));
+        return;
+    }
+    console.log((0, console_chars_1.createDivider)(70, "light"));
+    if (allOpportunities.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} No consolidation opportunities detected\n`);
+        console.log(`   Your codebase is well-organized!\n`);
+        process.exit(0);
+    }
+    const errors = allOpportunities.filter((o) => o.priority === "error");
+    const highPriority = allOpportunities.filter((o) => o.priority === "high");
+    const mediumPriority = allOpportunities.filter((o) => o.priority === "medium");
+    const lowPriority = allOpportunities.filter((o) => o.priority === "low");
+    console.log(`\n${console_chars_1.emoji.chart} Found ${allOpportunities.length} consolidation opportunities\n`);
+    // BLOCKING ERRORS
+    if (errors.length > 0) {
+        console.log(`${console_chars_1.emoji.error} BLOCKING ERRORS (must fix before build):\n`);
+        for (const opp of errors) {
+            printOpportunity(opp, verbose);
+        }
+    }
+    // HIGH PRIORITY (non-blocking)
+    if (highPriority.length > 0) {
+        console.log(`${console_chars_1.emoji.warning} HIGH PRIORITY (5+ occurrences):\n`);
+        for (const opp of highPriority) {
+            printOpportunity(opp, verbose);
+        }
+    }
+    // MEDIUM PRIORITY
+    if (mediumPriority.length > 0 && verbose) {
+        console.log(`${console_chars_1.emoji.info} MEDIUM PRIORITY (3-4 occurrences):\n`);
+        for (const opp of mediumPriority) {
+            printOpportunity(opp, verbose);
+        }
+    }
+    // Summary
+    console.log((0, console_chars_1.createDivider)(70, "heavy"));
+    console.log(`\n${console_chars_1.emoji.hint} Summary:`);
+    console.log(`   ${console_chars_1.emoji.error} Blocking Errors: ${errors.length}`);
+    console.log(`   ${console_chars_1.emoji.warning} High Priority: ${highPriority.length}`);
+    console.log(`   ${console_chars_1.emoji.info} Medium/Low: ${mediumPriority.length + lowPriority.length}`);
+    if (!verbose && (mediumPriority.length > 0 || lowPriority.length > 0)) {
+        console.log(`\n   Run with --verbose to see all details`);
+    }
+    const elapsed = Date.now() - startTime;
+    console.log(`\n${console_chars_1.emoji.clock} Completed in ${elapsed}ms\n`);
+    // Exit with error if blocking issues found
+    if (errors.length > 0) {
+        console.log(`${console_chars_1.emoji.error} BUILD BLOCKED: Fix ${errors.length} blocking error(s) above\n`);
+        process.exit(1);
+    }
+    process.exit(0);
+}
+function printOpportunity(opp, verbose) {
+    const typeEmoji = {
+        "jsx-structure": "🧩",
+        "prop-pattern": `${console_chars_1.emoji.wrench}`,
+        "state-pattern": `${console_chars_1.emoji.lightning}`,
+        "styling-pattern": `${console_chars_1.emoji.palette}`,
+        "inline-logic": "🔀",
+    };
+    const prefix = opp.blocking ? `${console_chars_1.emoji.error}` : typeEmoji[opp.type];
+    console.log(`  ${prefix} ${opp.description}`);
+    console.log(`     ${console_chars_1.emoji.hint} Fix: ${opp.suggestedName}`);
+    if (opp.suggestedLocation) {
+        console.log(`     ${console_chars_1.emoji.folder} Location: ${opp.suggestedLocation}`);
+    }
+    console.log(`     ${console_chars_1.emoji.file} Found in ${opp.occurrences.length}+ locations:`);
+    const filesToShow = verbose ? opp.occurrences : opp.occurrences.slice(0, 3);
+    for (const match of filesToShow) {
+        console.log(`        - ${match.file}:${match.line}`);
+    }
+    if (!verbose && opp.occurrences.length > 3) {
+        console.log(`        ... and ${opp.occurrences.length - 3} more`);
+    }
+    console.log();
+}
+main().catch(console.error);
+//# sourceMappingURL=component-consolidation-opportunities.js.map

package/dist/checks/architecture/component-consolidation-opportunities.js.map

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

package/dist/checks/architecture/orphaned-pages-detection.d.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env tsx
+/**
+ * Orphaned Pages Detection Preflight (WARNING - will become BLOCKING)
+ *
+ * Detects pages in app/ that are not reachable from any navigation:
+ * - Not linked via <Link> or <a> tags
+ * - Not referenced in navigation menus (href:, path:, to: properties)
+ * - Not in sitemap.ts
+ * - Not dynamically routed to via router.push
+ *
+ * Why: Orphaned pages waste build time, confuse developers, and may contain
+ * stale/broken code that goes unnoticed until someone stumbles upon it.
+ *
+ * Exclusions:
+ * - API routes (app/api/**)
+ * - Dev/debug pages (app/dev/**)
+ * - Dynamic route segments ([param]) - checked via pattern matching
+ * - Legal/marketing route groups ((legal), (marketing), (shop))
+ * - Error/loading/layout files (not actual pages)
+ *
+ * Status: WARNING (will become BLOCKING once orphaned pages are addressed)
+ *
+ * Commands:
+ *   pnpm preflight:orphaned-pages          # Run detection (warning mode by default)
+ *   pnpm preflight:orphaned-pages:verbose  # Detailed output
+ *   pnpm preflight:orphaned-pages:warn     # Explicit warning mode (exit 0)
+ */
+export declare const id = "architecture/orphaned-pages-detection";
+export declare const name = "Orphaned Pages Detection";
+export declare const category = "architecture";
+export declare const blocking = false;
+export declare const description = "Orphaned Pages Detection Preflight (WARNING - will become BLOCKING)";
+export declare const tags: string[];
+//# sourceMappingURL=orphaned-pages-detection.d.ts.map

package/dist/checks/architecture/orphaned-pages-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphaned-pages-detection.d.ts","sourceRoot":"","sources":["../../../src/checks/architecture/orphaned-pages-detection.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AASH,eAAO,MAAM,EAAE,0CAA0C,CAAC;AAC1D,eAAO,MAAM,IAAI,6BAA6B,CAAC;AAC/C,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AACvC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,wEAAwE,CAAC;AACjG,eAAO,MAAM,IAAI,UAAmB,CAAC"}