@empline/preflight 1.1.20 → 1.1.22

package/dist/checks/architecture/jsx-structure-duplication.d.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env tsx
+/**
+ * JSX Structure Duplication Detection Preflight
+ *
+ * Detects duplicate JSX structures across files that should be extracted
+ * into shared components. Unlike component-consolidation-opportunities which
+ * uses predefined patterns, this check discovers arbitrary duplicate structures.
+ *
+ * How it works:
+ * 1. Parses JSX from files and extracts structural blocks
+ * 2. Creates normalized fingerprints (ignoring variable names, values)
+ * 3. Groups similar structures across files
+ * 4. Reports structures that appear 3+ times as consolidation candidates
+ *
+ * Usage:
+ *   pnpm preflight:jsx-duplication
+ *   npx tsx src/checks/architecture/jsx-structure-duplication.ts --verbose
+ */
+export declare const id = "architecture/jsx-structure-duplication";
+export declare const name = "JSX Structure Duplication Detection";
+export declare const category = "architecture";
+export declare const blocking = false;
+export declare const description = "Detects duplicate JSX structures that should be extracted into shared components";
+export declare const tags: string[];
+export declare function run(): Promise<void>;
+//# sourceMappingURL=jsx-structure-duplication.d.ts.map

package/dist/checks/architecture/jsx-structure-duplication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-structure-duplication.d.ts","sourceRoot":"","sources":["../../../src/checks/architecture/jsx-structure-duplication.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAWH,eAAO,MAAM,EAAE,2CAA2C,CAAC;AAC3D,eAAO,MAAM,IAAI,wCAAwC,CAAC;AAC1D,eAAO,MAAM,QAAQ,iBAAiB,CAAC;AACvC,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,WAAW,qFAC4D,CAAC;AACrF,eAAO,MAAM,IAAI,UAA6E,CAAC;AAgR/F,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAsDzC"}

package/dist/checks/architecture/jsx-structure-duplication.js

@@ -0,0 +1,343 @@
+#!/usr/bin/env tsx
+"use strict";
+/**
+ * JSX Structure Duplication Detection Preflight
+ *
+ * Detects duplicate JSX structures across files that should be extracted
+ * into shared components. Unlike component-consolidation-opportunities which
+ * uses predefined patterns, this check discovers arbitrary duplicate structures.
+ *
+ * How it works:
+ * 1. Parses JSX from files and extracts structural blocks
+ * 2. Creates normalized fingerprints (ignoring variable names, values)
+ * 3. Groups similar structures across files
+ * 4. Reports structures that appear 3+ times as consolidation candidates
+ *
+ * Usage:
+ *   pnpm preflight:jsx-duplication
+ *   npx tsx src/checks/architecture/jsx-structure-duplication.ts --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;
+exports.run = run;
+const fs = __importStar(require("fs"));
+const crypto = __importStar(require("crypto"));
+const glob_1 = require("glob");
+const console_chars_1 = require("../../utils/console-chars");
+const universal_progress_reporter_1 = require("../system/universal-progress-reporter");
+const glob_patterns_1 = require("../../shared/glob-patterns");
+// Check metadata
+exports.id = "architecture/jsx-structure-duplication";
+exports.name = "JSX Structure Duplication Detection";
+exports.category = "architecture";
+exports.blocking = false;
+exports.description = "Detects duplicate JSX structures that should be extracted into shared components";
+exports.tags = ["architecture", "duplication", "shared-components", "jsx", "refactoring"];
+// Configuration
+const CONFIG = {
+    // Minimum occurrences to report as duplicate
+    minOccurrences: 3,
+    // Minimum lines for a JSX block to be considered
+    minBlockLines: 5,
+    // Maximum lines for a JSX block (too large = probably not a reusable component)
+    maxBlockLines: 50,
+    // Directories to scan
+    includeDirs: ["app", "components"],
+    // File patterns to exclude
+    excludePatterns: [
+        ...glob_patterns_1.CORE_EXCLUDES,
+        "**/components/shared/**", // Already shared
+        "**/components/ui/**", // Primitive components
+        "**/*.test.tsx",
+        "**/*.spec.tsx",
+        "**/*.stories.tsx",
+    ],
+};
+// JSX Block Detection
+/**
+ * Extract JSX blocks from file content.
+ * Looks for multi-line JSX structures wrapped in parentheses or fragments.
+ */
+function extractJSXBlocks(content, filePath) {
+    const blocks = [];
+    const lines = content.split("\n");
+    // Pattern to detect start of JSX blocks:
+    // - Opening tag with attributes spanning multiple lines
+    // - Fragment openings
+    // - Conditional JSX: {condition && (<JSX>...)}
+    // - Ternary JSX: {condition ? (<JSX>...) : ...}
+    const jsxStartPatterns = [
+        // Conditional rendering with opening paren
+        /\{[^}]*&&\s*\(\s*$/,
+        /\{[^}]*\?\s*\(\s*$/,
+        // Return statement with JSX
+        /return\s*\(\s*$/,
+        // Variable assignment with JSX
+        /=\s*\(\s*$/,
+        // Opening Card/Box/Stack/div with className
+        /<(?:Card|Box|Stack|div|Paper|Container)[^>]*className[^>]*>\s*$/,
+    ];
+    let blockStart = null;
+    let depth = 0;
+    let currentBlock = [];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        // Check if this starts a new JSX block
+        if (blockStart === null) {
+            for (const pattern of jsxStartPatterns) {
+                if (pattern.test(line)) {
+                    blockStart = i;
+                    depth = 1;
+                    currentBlock = [line];
+                    break;
+                }
+            }
+            continue;
+        }
+        // We're inside a block, track depth
+        currentBlock.push(line);
+        // Count opening/closing parens and tags
+        const openParens = (line.match(/\(/g) || []).length;
+        const closeParens = (line.match(/\)/g) || []).length;
+        depth += openParens - closeParens;
+        // Also track JSX tag depth for self-contained components
+        const openTags = (line.match(/<[A-Z][^/>]*(?<!\/)\s*>/g) || []).length;
+        const closeTags = (line.match(/<\/[A-Z][^>]*>/g) || []).length;
+        const selfClosing = (line.match(/<[A-Z][^>]*\/>/g) || []).length;
+        // Check if block is complete
+        if (depth <= 0 || (trimmed.startsWith("</") && closeTags > openTags)) {
+            const blockLines = currentBlock.length;
+            if (blockLines >= CONFIG.minBlockLines && blockLines <= CONFIG.maxBlockLines) {
+                const raw = currentBlock.join("\n");
+                const normalized = normalizeJSX(raw);
+                const fingerprint = hashString(normalized);
+                blocks.push({
+                    file: filePath,
+                    startLine: blockStart + 1, // 1-indexed
+                    endLine: i + 1,
+                    raw,
+                    normalized,
+                    fingerprint,
+                    context: currentBlock[0].trim().substring(0, 60),
+                });
+            }
+            blockStart = null;
+            depth = 0;
+            currentBlock = [];
+        }
+    }
+    return blocks;
+}
+/**
+ * Normalize JSX for comparison by removing variable specifics
+ * while preserving structure.
+ */
+function normalizeJSX(jsx) {
+    return (jsx
+        // Remove all whitespace
+        .replace(/\s+/g, " ")
+        // Normalize string values
+        .replace(/"[^"]*"/g, '"STRING"')
+        .replace(/'[^']*'/g, '"STRING"')
+        // Normalize variable names in expressions
+        .replace(/\{[a-z_][a-zA-Z0-9_]*\}/gi, "{VAR}")
+        // Normalize function calls
+        .replace(/\{[a-z_][a-zA-Z0-9_]*\([^)]*\)\}/gi, "{FUNC()}")
+        // Normalize property access
+        .replace(/\{[a-z_][a-zA-Z0-9_]*\.[a-zA-Z0-9_.]+\}/gi, "{VAR.PROP}")
+        // Normalize numbers
+        .replace(/\{[0-9]+\}/g, "{NUM}")
+        // Normalize conditional expressions but keep structure
+        .replace(/\{[^}]+\s*\?\s*/g, "{COND ? ")
+        .replace(/\s*:\s*[^}]+\}/g, " : ALT}")
+        // Normalize onClick/onChange handlers
+        .replace(/on[A-Z][a-zA-Z]*=\{[^}]+\}/g, "onEVENT={HANDLER}")
+        // Normalize className values but keep the attribute
+        .replace(/className="[^"]+"/g, 'className="CLASSES"')
+        // Normalize key props
+        .replace(/key=\{[^}]+\}/g, "key={KEY}")
+        // Trim
+        .trim());
+}
+/**
+ * Create a hash of the normalized JSX for grouping
+ */
+function hashString(str) {
+    return crypto.createHash("md5").update(str).digest("hex").substring(0, 12);
+}
+/**
+ * Extract a suggested component name from the JSX structure
+ */
+function suggestComponentName(blocks) {
+    // Look for common patterns in the JSX
+    const sample = blocks[0].raw;
+    // Check for common UI patterns
+    if (/Resume.*Import/i.test(sample))
+        return "ResumeImportPrompt";
+    if (/Empty.*State/i.test(sample))
+        return "EmptyStateCard";
+    if (/Loading.*Spinner/i.test(sample))
+        return "LoadingIndicator";
+    if (/Confirm.*Dialog/i.test(sample))
+        return "ConfirmationCard";
+    if (/Error.*Message/i.test(sample))
+        return "ErrorDisplay";
+    if (/Success.*Message/i.test(sample))
+        return "SuccessDisplay";
+    if (/Filter.*Bar/i.test(sample))
+        return "FilterBar";
+    if (/Search.*Input/i.test(sample))
+        return "SearchBar";
+    if (/Stat.*Card/i.test(sample))
+        return "StatCard";
+    if (/Progress.*Bar/i.test(sample))
+        return "ProgressIndicator";
+    // Check for the root component type
+    const rootMatch = sample.match(/<([A-Z][a-zA-Z]+)/);
+    if (rootMatch) {
+        return `Shared${rootMatch[1]}`;
+    }
+    return "SharedComponent";
+}
+/**
+ * Generate a preview of the structure for display
+ */
+function generateStructurePreview(block) {
+    const lines = block.raw.split("\n").slice(0, 8);
+    return lines.map((l) => "  " + l.trim()).join("\n") + (block.raw.split("\n").length > 8 ? "\n  ..." : "");
+}
+// Main Detection Logic
+async function detectDuplicates() {
+    const allBlocks = [];
+    // Gather all files
+    const files = [];
+    for (const dir of CONFIG.includeDirs) {
+        const matches = await (0, glob_1.glob)(`${dir}/**/*.tsx`, {
+            ignore: CONFIG.excludePatterns,
+            cwd: process.cwd(),
+        });
+        files.push(...matches);
+    }
+    console.log(`${console_chars_1.emoji.folder} Scanning ${files.length} files for JSX structures...`);
+    // Extract blocks from each file
+    for (const file of files) {
+        try {
+            const content = fs.readFileSync(file, "utf-8");
+            const blocks = extractJSXBlocks(content, file);
+            allBlocks.push(...blocks);
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    console.log(`${console_chars_1.emoji.search} Found ${allBlocks.length} JSX blocks to analyze`);
+    // Group by fingerprint
+    const groups = new Map();
+    for (const block of allBlocks) {
+        if (!groups.has(block.fingerprint)) {
+            groups.set(block.fingerprint, []);
+        }
+        groups.get(block.fingerprint).push(block);
+    }
+    // Filter to duplicates (3+ occurrences in different files)
+    const duplicates = [];
+    for (const [fingerprint, blocks] of groups) {
+        // Get unique files
+        const uniqueFiles = new Set(blocks.map((b) => b.file));
+        if (uniqueFiles.size >= CONFIG.minOccurrences) {
+            duplicates.push({
+                fingerprint,
+                blocks: blocks.slice(0, 5), // Limit to 5 examples
+                suggestedName: suggestComponentName(blocks),
+                structurePreview: generateStructurePreview(blocks[0]),
+            });
+        }
+    }
+    // Sort by number of occurrences (most duplicated first)
+    duplicates.sort((a, b) => b.blocks.length - a.blocks.length);
+    return duplicates;
+}
+// Main Runner
+async function run() {
+    const reporter = (0, universal_progress_reporter_1.createUniversalProgressReporter)(exports.name);
+    const startTime = Date.now();
+    const args = process.argv.slice(2);
+    const verbose = args.includes("--verbose") || args.includes("-v");
+    console.log(`\n${console_chars_1.emoji.search} JSX Structure Duplication Detection`);
+    console.log((0, console_chars_1.createDivider)(70, "heavy"));
+    console.log(`${console_chars_1.emoji.info} Looking for duplicate JSX structures that should be shared components\n`);
+    const duplicates = await detectDuplicates();
+    console.log((0, console_chars_1.createDivider)(70, "light"));
+    if (duplicates.length === 0) {
+        console.log(`\n${console_chars_1.emoji.success} No duplicate JSX structures detected`);
+        console.log(`   Your codebase has good component reuse!\n`);
+        process.exit(0);
+    }
+    console.log(`\n${console_chars_1.emoji.warning} Found ${duplicates.length} duplicate JSX structure(s)\n`);
+    console.log(`These patterns appear in 3+ files and should be extracted to shared components:\n`);
+    for (const group of duplicates) {
+        const fileCount = new Set(group.blocks.map((b) => b.file)).size;
+        console.log(`${console_chars_1.emoji.components} ${group.suggestedName} (found in ${fileCount} files)`);
+        console.log(`   Fingerprint: ${group.fingerprint}`);
+        console.log(`   Suggested location: components/shared/${group.suggestedName}.tsx\n`);
+        if (verbose) {
+            console.log(`   Structure preview:`);
+            console.log(group.structurePreview);
+            console.log();
+        }
+        console.log(`   Found in:`);
+        for (const block of group.blocks) {
+            console.log(`     - ${block.file}:${block.startLine}-${block.endLine}`);
+        }
+        console.log();
+    }
+    console.log((0, console_chars_1.createDivider)(70, "heavy"));
+    console.log(`\n${console_chars_1.emoji.hint} Recommendations:`);
+    console.log(`  1. Create shared components for the patterns above`);
+    console.log(`  2. Use props to handle variations between usages`);
+    console.log(`  3. Export from components/shared/index.ts`);
+    console.log(`  4. Update all files to use the new shared component\n`);
+    const elapsed = Date.now() - startTime;
+    console.log(`${console_chars_1.emoji.clock} Completed in ${(elapsed / 1000).toFixed(1)}s`);
+    console.log(`${console_chars_1.emoji.info} This check is non-blocking (advisory only)\n`);
+    process.exit(0);
+}
+// Allow direct execution
+if (require.main === module) {
+    run().catch(console.error);
+}
+//# sourceMappingURL=jsx-structure-duplication.js.map

package/dist/checks/architecture/jsx-structure-duplication.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@empline/preflight",
-  "version": "1.1.20",
+  "version": "1.1.22",
   "description": "Distributable preflight validation system with app-specific plugin support",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -19,13 +19,15 @@
   },
   "scripts": {
     "build": "tsc",
-    "prebuild": "npm run check:hygiene",
+    "prebuild": "npm run check:hygiene && npm run check:metadata && npm run check:broken",
     "dev": "tsc --watch",
     "preflight": "tsx src/bin/preflight.ts",
-    "check:all": "tsx src/checks/**/*.ts",
-    "check:security": "tsx src/checks/security/*.ts",
-    "check:business": "tsx src/checks/business/*.ts",
+    "check:system": "tsx src/bin/preflight.ts --category system",
+    "check:security": "tsx src/bin/preflight.ts --category security",
+    "check:business": "tsx src/bin/preflight.ts --category business",
     "check:hygiene": "tsx scripts/maintenance/module-boundary-validator.ts",
+    "check:metadata": "tsx src/checks/system/preflight-metadata-validator.ts",
+    "check:broken": "tsx src/checks/system/broken-preflight-detection.ts",
     "check:hygiene:all": "tsx scripts/maintenance/module-boundary-validator.ts && tsx scripts/maintenance/workflow-composition-validator.ts && tsx scripts/maintenance/canonical-import-enforcer.ts",
     "lint": "eslint src/",
     "test": "vitest",