@mohamed_fadl/reactlens 1.2.0-beta.1

package/README.md

@@ -0,0 +1,104 @@
+# ReactLens: Advanced Architectural Analysis Engine
+
+ReactLens is a high-performance, deterministic tool designed for deep architectural auditing of React and Next.js applications. It leverages static AST analysis and graph theory to extract actionable intelligence from complex codebases.
+
+## System Prerequisites
+
+To use the visual graph generation features (`graph` command), you must have **Graphviz** installed on your system:
+
+- **Windows:** `winget install graphviz`
+- **macOS:** `brew install graphviz`
+- **Linux:** `sudo apt install graphviz`
+
+*Note: The core analysis engine (`analyze`) works without Graphviz.*
+
+## Installation
+
+```bash
+npm install -g react-lens
+```
+
+## Usage & Commands
+
+### 1. Project Analysis
+Analyze your project's architectural health, complexity, and dependencies.
+
+```bash
+react-lens analyze [path] [options]
+```
+
+**Options:**
+- `-j, --json [file]` : Output report in JSON format. If no file is provided, it prints to stdout.
+- `-s, --silent` : Suppress the visual terminal report (ideal for piping JSON).
+- `--fail-under <score>` : Exit with code 1 if the Architectural Score is below the threshold.
+
+### 2. Dependency Graph
+Generate a visual representation of your project's module relationships.
+
+```bash
+react-lens graph [path] --output <file.svg|file.dot>
+```
+
+## Logical Flow and Architecture
+
+```mermaid
+graph TD
+    A[Project Root] --> B[FileScanner]
+    B --> C{Framework Detection}
+    C -->|Next.js| D[App Router Analysis]
+    C -->|React/Vite| E[Basic Component Analysis]
+    C -->|Node CLI| F[CLI Tool Analysis]
+    
+    B --> G[Babel AST Parser]
+    G --> H[ComponentAnalyzer]
+    H --> I[Extraction: Props/Hooks/Client-Directives]
+    H --> J[Prop Drilling Detection]
+    
+    B --> K[Madge Dependency Engine]
+    K --> L[Graph Theory Resolution]
+    L --> M[Cycle & Zombie Detection]
+    
+    I --> N[Insight Engine]
+    J --> N
+    M --> N
+    N --> O[Mathematical Scoring Model]
+    O --> P[Terminal/JSON/Silent Reporting]
+```
+
+## Technical Implementation & Algorithms
+
+### 1. Semantic AST Traversal & Prop Drilling
+ReactLens utilizes the `@babel/parser` for Abstract Syntax Tree (AST) generation. The `ComponentAnalyzer` implements:
+- **Functional Components:** Identified via function signatures returning JSX.
+- **Prop Drilling Heuristic:** Detects properties passed down to children without local usage within the component body.
+- **Hook Signatures:** Detected through the `use` prefix heuristic.
+
+### 2. Dependency Graph Theory
+The `DependencyAnalyzer` constructs a Directed Acyclic Graph (DAG) using **Madge**.
+- **Cycle Detection:** Utilizes DFS to identify circular imports.
+- **Zombie Analysis:** Identifies "Zombie Components" (unreachable nodes) by excluding test files and entry points.
+
+## Mathematical Scoring Model (Weighted)
+
+The Architectural Integrity Score ($S$) is calculated using weighted health sections:
+
+$$S = \text{round}(0.4 \cdot S_{comp} + 0.4 \cdot S_{coup} + 0.2 \cdot S_{zom})$$
+
+- **Complexity ($S_{comp}$):** Penalties for large components ($>300$ lines), high prop counts, and detected prop drilling.
+- **Coupling ($S_{coup}$):** Penalties for circular dependencies (15% per cycle).
+- **Zombies ($S_{zom}$):** Penalties for unused modules (2% per instance).
+
+## Strategic Roadmap
+
+- **v1.0 - v1.2: Advanced Intelligence (Current)**
+  AST Analysis, Weighted Scoring, Prop Drilling Detection, JSON Stdout, and Dedicated Graph CLI.
+- **v1.5: HTML Interactive Dashboard**
+  Visual exploration of the architecture with real-time filtering.
+- **v1.8: Direct Refactoring AI Integration**
+  Automated code transformation suggestions.
+- **v2.0: Multi-Framework Meta-Analysis**
+  Unified quality standards for Vue, Svelte, and Angular.
+
+---
+
+Technical Reference - ReactLens Engineering Team.

package/dist/analyzer/componentAnalyzer.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview ComponentAnalyzer
+ * Engine responsible for analyzing JS/TS file contents.
+ * Uses Babel AST to discover React components and calculate size/complexity.
+ */
+/**
+ * Represents analysis metrics for a single component
+ */
+export interface ComponentMetrics {
+    name: string;
+    lineCount: number;
+    type: 'functional' | 'class';
+    isLarge: boolean;
+    propCount: number;
+    props: string[];
+    hookCount: number;
+    hooks: string[];
+    isClientComponent: boolean;
+    drilledProps: string[];
+}
+export declare class ComponentAnalyzer {
+    private readonly SIZE_THRESHOLD;
+    /**
+     * Analyzes a single file and extracts component information
+     * @param filePath Path of the file to analyze
+     */
+    analyzeFile(filePath: string): Promise<ComponentMetrics[]>;
+    /**
+     * Extracts hook names used within a component
+     * @param componentPath Babel path of the component
+     */
+    private extractHooks;
+    /**
+     * Extracts prop names from function parameters
+     * @param params Babel AST function parameters
+     */
+    private extractProps;
+    /**
+     * Simple rule to identify component name (starts with uppercase)
+     * @param name Name of the identifier
+     */
+    private isComponentName;
+    /**
+     * Identifies props that are passed down to children without being used locally
+     * Heuristic for V1.2
+     */
+    private detectPropDrilling;
+}
+//# sourceMappingURL=componentAnalyzer.d.ts.map

package/dist/analyzer/componentAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analyzer/componentAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAO;IAEtC;;;OAGG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAgEhE;;;OAGG;IACH,OAAO,CAAC,YAAY;IAqBpB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAoBpB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAKvB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAyB3B"}

package/dist/analyzer/componentAnalyzer.js

@@ -0,0 +1,156 @@
+/**
+ * @fileoverview ComponentAnalyzer
+ * Engine responsible for analyzing JS/TS file contents.
+ * Uses Babel AST to discover React components and calculate size/complexity.
+ */
+import { promises as fs } from 'fs';
+import * as parser from '@babel/parser';
+import _traverse from '@babel/traverse';
+const traverse = _traverse.default || _traverse;
+export class ComponentAnalyzer {
+    SIZE_THRESHOLD = 300;
+    /**
+     * Analyzes a single file and extracts component information
+     * @param filePath Path of the file to analyze
+     */
+    async analyzeFile(filePath) {
+        try {
+            const code = await fs.readFile(filePath, 'utf-8');
+            const ast = parser.parse(code, {
+                sourceType: 'module',
+                plugins: ['typescript', 'jsx'],
+            });
+            const components = [];
+            const hasUseClient = ast.program.directives.some(d => d.value.value === 'use client');
+            traverse(ast, {
+                // Detect function declarations (Functional Components)
+                FunctionDeclaration: (path) => {
+                    const name = path.node.id?.name;
+                    if (this.isComponentName(name)) {
+                        const props = this.extractProps(path.node.params);
+                        const hooks = this.extractHooks(path);
+                        components.push({
+                            name,
+                            lineCount: path.node.loc.end.line - path.node.loc.start.line + 1,
+                            type: 'functional',
+                            isLarge: (path.node.loc.end.line - path.node.loc.start.line + 1) > this.SIZE_THRESHOLD,
+                            propCount: props.length,
+                            props,
+                            hookCount: hooks.length,
+                            hooks,
+                            isClientComponent: hasUseClient,
+                            drilledProps: this.detectPropDrilling(path, props)
+                        });
+                    }
+                },
+                // Detect variable-assigned functions (Arrow Functions)
+                VariableDeclarator: (path) => {
+                    if (path.node.id.type === 'Identifier') {
+                        const name = path.node.id.name;
+                        const init = path.node.init;
+                        if (this.isComponentName(name) &&
+                            (init?.type === 'ArrowFunctionExpression' || init?.type === 'FunctionExpression')) {
+                            const props = this.extractProps(init.params);
+                            const hooks = this.extractHooks(path.get('init'));
+                            components.push({
+                                name,
+                                lineCount: init.loc.end.line - init.loc.start.line + 1,
+                                type: 'functional',
+                                isLarge: (init.loc.end.line - init.loc.start.line + 1) > this.SIZE_THRESHOLD,
+                                propCount: props.length,
+                                props,
+                                hookCount: hooks.length,
+                                hooks,
+                                isClientComponent: hasUseClient,
+                                drilledProps: this.detectPropDrilling(path.get('init'), props)
+                            });
+                        }
+                    }
+                }
+            });
+            return components;
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    /**
+     * Extracts hook names used within a component
+     * @param componentPath Babel path of the component
+     */
+    extractHooks(componentPath) {
+        const hooks = [];
+        componentPath.traverse({
+            CallExpression(path) {
+                const callee = path.node.callee;
+                let hookName = null;
+                if (callee.type === 'Identifier' && callee.name.startsWith('use')) {
+                    hookName = callee.name;
+                }
+                else if (callee.type === 'MemberExpression' && callee.property.type === 'Identifier' && callee.property.name.startsWith('use')) {
+                    hookName = callee.property.name;
+                }
+                if (hookName) {
+                    hooks.push(hookName);
+                }
+            }
+        });
+        return hooks;
+    }
+    /**
+     * Extracts prop names from function parameters
+     * @param params Babel AST function parameters
+     */
+    extractProps(params) {
+        if (params.length === 0)
+            return [];
+        const firstParam = params[0];
+        // Case 1: Destructured props ({ name, age })
+        if (firstParam.type === 'ObjectPattern') {
+            return firstParam.properties
+                .filter((p) => p.type === 'ObjectProperty' && p.key.type === 'Identifier')
+                .map((p) => p.key.name);
+        }
+        // Case 2: Single props object (props)
+        if (firstParam.type === 'Identifier') {
+            return [firstParam.name];
+        }
+        return [];
+    }
+    /**
+     * Simple rule to identify component name (starts with uppercase)
+     * @param name Name of the identifier
+     */
+    isComponentName(name) {
+        if (!name)
+            return false;
+        return /^[A-Z]/.test(name);
+    }
+    /**
+     * Identifies props that are passed down to children without being used locally
+     * Heuristic for V1.2
+     */
+    detectPropDrilling(componentPath, props) {
+        const drilled = [];
+        const usedLocally = new Set();
+        props.forEach(prop => {
+            // Find all usages of this prop identifier
+            componentPath.traverse({
+                Identifier(path) {
+                    if (path.node.name === prop) {
+                        // Check if it's a JSXAttribute value (passing it down)
+                        const isPassingDown = path.findParent((p) => p.isJSXAttribute());
+                        if (!isPassingDown) {
+                            usedLocally.add(prop);
+                        }
+                    }
+                }
+            });
+            if (!usedLocally.has(prop)) {
+                drilled.push(prop);
+            }
+        });
+        return drilled;
+    }
+}
+//# sourceMappingURL=componentAnalyzer.js.map

package/dist/analyzer/componentAnalyzer.js.map

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

package/dist/analyzer/dependencyAnalyzer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview DependencyAnalyzer
+ * Responsible for analyzing file relationships and structural issues.
+ * Uses Madge library to identify circular dependencies, unused modules, and coupling.
+ */
+/**
+ * Represents dependency metrics for the project
+ */
+export interface DependencyMetrics {
+    circular: string[][];
+    totalModules: number;
+    zombieComponents: string[];
+    couplingMap: Record<string, number>;
+    internalModules: string[];
+    externalModules: string[];
+}
+export declare class DependencyAnalyzer {
+    private madgeInstance;
+    /**
+     * Analyzes the project and detects circular dependencies, zombies, and coupling
+     * @param rootPath Project root path
+     * @param entryPoint Optional entry point to help identify unused files (e.g., src/cli/index.ts)
+     */
+    analyze(rootPath: string, entryPoint?: string): Promise<DependencyMetrics>;
+    /**
+     * Exports the dependency graph to a visual format
+     * @param outputPath Path where the graph will be saved
+     */
+    exportGraph(outputPath: string): Promise<string>;
+}
+//# sourceMappingURL=dependencyAnalyzer.d.ts.map

package/dist/analyzer/dependencyAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencyAnalyzer.d.ts","sourceRoot":"","sources":["../../src/analyzer/dependencyAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,aAAa,CAAa;IAElC;;;;OAIG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA2DhF;;;OAGG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAYvD"}

package/dist/analyzer/dependencyAnalyzer.js

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview DependencyAnalyzer
+ * Responsible for analyzing file relationships and structural issues.
+ * Uses Madge library to identify circular dependencies, unused modules, and coupling.
+ */
+import madge from 'madge';
+export class DependencyAnalyzer {
+    madgeInstance = null;
+    /**
+     * Analyzes the project and detects circular dependencies, zombies, and coupling
+     * @param rootPath Project root path
+     * @param entryPoint Optional entry point to help identify unused files (e.g., src/cli/index.ts)
+     */
+    async analyze(rootPath, entryPoint) {
+        try {
+            this.madgeInstance = await madge(rootPath, {
+                fileExtensions: ['js', 'jsx', 'ts', 'tsx'],
+                excludeRegExp: [/node_modules/, /dist/, /.next/, /__tests__/, /\.test\./, /\.spec\./, /vitest\.config/, /jest\.config/],
+            });
+            const circular = this.madgeInstance.circular();
+            const obj = this.madgeInstance.obj();
+            const totalModules = Object.keys(obj).length;
+            // Calculate coupling and modules
+            const couplingMap = {};
+            const internalModules = Object.keys(obj);
+            const externalSet = new Set();
+            internalModules.forEach(module => {
+                couplingMap[module] = 0;
+            });
+            Object.values(obj).forEach((deps) => {
+                deps.forEach((dep) => {
+                    // If it's not in our internal modules, it might be an external lib
+                    // Note: Madge with default config might not list all npm packages unless configured.
+                    // But we can infer external ones if they don't match our file paths or are explicitly listed.
+                    if (couplingMap[dep] !== undefined) {
+                        couplingMap[dep]++;
+                    }
+                    else {
+                        externalSet.add(dep);
+                    }
+                });
+            });
+            const zombieComponents = internalModules.filter(module => {
+                if (entryPoint && module.includes(entryPoint))
+                    return false;
+                return couplingMap[module] === 0;
+            });
+            return {
+                circular,
+                totalModules,
+                zombieComponents,
+                couplingMap,
+                internalModules,
+                externalModules: Array.from(externalSet)
+            };
+        }
+        catch (error) {
+            console.error('Error during dependency analysis:', error);
+            return {
+                circular: [],
+                totalModules: 0,
+                zombieComponents: [],
+                couplingMap: {},
+                internalModules: [],
+                externalModules: []
+            };
+        }
+    }
+    /**
+     * Exports the dependency graph to a visual format
+     * @param outputPath Path where the graph will be saved
+     */
+    async exportGraph(outputPath) {
+        if (!this.madgeInstance)
+            throw new Error('You must run analyze() before exporting a graph.');
+        const ext = outputPath.split('.').pop()?.toLowerCase();
+        if (ext === 'svg') {
+            return await this.madgeInstance.image(outputPath);
+        }
+        else {
+            // Default to DOT format which is robust
+            return await this.madgeInstance.dot(outputPath);
+        }
+    }
+}
+//# sourceMappingURL=dependencyAnalyzer.js.map

package/dist/analyzer/dependencyAnalyzer.js.map

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

package/dist/analyzer/insightEngine.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview InsightEngine
+ * Responsible for generating actionable recommendations and calculating advanced scores.
+ * Transforms raw metrics into architectural insights.
+ */
+import { ComponentMetrics } from '../analyzer/componentAnalyzer.js';
+import { DependencyMetrics } from '../analyzer/dependencyAnalyzer.js';
+export interface Recommendation {
+    level: 'info' | 'warning' | 'error';
+    target: string;
+    message: string;
+    suggestion: string;
+}
+export interface ArchitectureReport {
+    score: number;
+    breakdown: {
+        complexity: number;
+        coupling: number;
+        zombies: number;
+    };
+    recommendations: Recommendation[];
+}
+export declare class InsightEngine {
+    private readonly TRESHOLDS;
+    /**
+     * Generates a comprehensive architectural insight report
+     * @param componentMetrics List of metrics for all components
+     * @param dependencyMetrics Results from dependency analysis
+     */
+    generateReport(componentMetrics: ComponentMetrics[], dependencyMetrics: DependencyMetrics): ArchitectureReport;
+    /**
+     * Removes duplicate recommendations for the same target and message
+     */
+    private deduplicateRecommendations;
+    /**
+     * Advanced Scoring v2 - Weighs different architectural issues
+     */
+    private calculateAdvancedScore;
+    /**
+     * Checks for Next.js specific boundary violations or optimizations
+     */
+    private checkNextJsBoundaries;
+}
+//# sourceMappingURL=insightEngine.d.ts.map

package/dist/analyzer/insightEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insightEngine.d.ts","sourceRoot":"","sources":["../../src/analyzer/insightEngine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE;QACT,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,eAAe,EAAE,cAAc,EAAE,CAAC;CACnC;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAIxB;IAEF;;;;OAIG;IACH,cAAc,CACZ,gBAAgB,EAAE,gBAAgB,EAAE,EACpC,iBAAiB,EAAE,iBAAiB,GACnC,kBAAkB;IAqFrB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAUlC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiC9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAkB9B"}

package/dist/analyzer/insightEngine.js

@@ -0,0 +1,153 @@
+/**
+ * @fileoverview InsightEngine
+ * Responsible for generating actionable recommendations and calculating advanced scores.
+ * Transforms raw metrics into architectural insights.
+ */
+export class InsightEngine {
+    TRESHOLDS = {
+        LARGE_COMPONENT: 300,
+        HIGH_PROP_COUNT: 5,
+        HIGH_HOOK_COUNT: 4,
+    };
+    /**
+     * Generates a comprehensive architectural insight report
+     * @param componentMetrics List of metrics for all components
+     * @param dependencyMetrics Results from dependency analysis
+     */
+    generateReport(componentMetrics, dependencyMetrics) {
+        const recommendations = [];
+        // Analyze components for recommendations
+        componentMetrics.forEach(c => {
+            if (c.isLarge) {
+                recommendations.push({
+                    level: 'warning',
+                    target: c.name,
+                    message: `Oversized component detected (${c.lineCount} lines).`,
+                    suggestion: 'Break this component into smaller, more focused sub-components.'
+                });
+            }
+            if (c.propCount > this.TRESHOLDS.HIGH_PROP_COUNT) {
+                recommendations.push({
+                    level: 'info',
+                    target: c.name,
+                    message: `High prop count (${c.propCount} props).`,
+                    suggestion: 'Consider grouping related props or using a React Context.'
+                });
+            }
+            if (c.hookCount > this.TRESHOLDS.HIGH_HOOK_COUNT) {
+                recommendations.push({
+                    level: 'info',
+                    target: c.name,
+                    message: `Complexity warning: High hook count (${c.hookCount} hooks).`,
+                    suggestion: 'Extract some logic into a Custom Hook to simplify the component.'
+                });
+            }
+            if (c.drilledProps.length > 0) {
+                recommendations.push({
+                    level: 'info',
+                    target: c.name,
+                    message: `Potential Prop Drilling: ${c.drilledProps.join(', ')} passed down without local usage.`,
+                    suggestion: 'Consider using React Context or a State Management library for deeply nested data.'
+                });
+            }
+            if (c.isClientComponent) {
+                recommendations.push({
+                    level: 'info',
+                    target: c.name,
+                    message: 'Client-side component identified.',
+                    suggestion: 'Ensure heavy logic is moved to server components if possible to improve performance.'
+                });
+            }
+        });
+        // Analyze dependencies for recommendations
+        dependencyMetrics.circular.forEach((cycle, i) => {
+            recommendations.push({
+                level: 'error',
+                target: `Cycle ${i + 1}`,
+                message: `Circular dependency detected: ${cycle.join(' -> ')}`,
+                suggestion: 'Create a shared/core module to break the dependency cycle.'
+            });
+        });
+        dependencyMetrics.zombieComponents.forEach(z => {
+            recommendations.push({
+                level: 'warning',
+                target: z,
+                message: 'Unused module (Zombie Component).',
+                suggestion: 'Safely remove this file if it is no longer needed.'
+            });
+        });
+        // Next.js Boundary Checks
+        this.checkNextJsBoundaries(componentMetrics, dependencyMetrics, recommendations);
+        // Deduplicate recommendations
+        const uniqueRecommendations = this.deduplicateRecommendations(recommendations);
+        const { score, breakdown } = this.calculateAdvancedScore(componentMetrics, dependencyMetrics);
+        return {
+            score,
+            breakdown,
+            recommendations: uniqueRecommendations
+        };
+    }
+    /**
+     * Removes duplicate recommendations for the same target and message
+     */
+    deduplicateRecommendations(recs) {
+        const seen = new Set();
+        return recs.filter(r => {
+            const key = `${r.level}-${r.target}-${r.message}`;
+            if (seen.has(key))
+                return false;
+            seen.add(key);
+            return true;
+        });
+    }
+    /**
+     * Advanced Scoring v2 - Weighs different architectural issues
+     */
+    calculateAdvancedScore(components, deps) {
+        let complexityPenalty = 0;
+        let couplingPenalty = 0;
+        let zombiePenalty = 0;
+        // Complexity penalties
+        components.forEach(c => {
+            if (c.isLarge)
+                complexityPenalty += 5;
+            if (c.propCount > 7)
+                complexityPenalty += 3;
+            if (c.hookCount > 6)
+                complexityPenalty += 3;
+            if (c.drilledProps.length > 0)
+                complexityPenalty += (c.drilledProps.length * 2);
+        });
+        // Coupling/Graph penalties
+        couplingPenalty += (deps.circular.length * 15);
+        // Zombie penalties
+        zombiePenalty += (deps.zombieComponents.length * 2);
+        const scores = {
+            complexity: Math.max(0, 100 - complexityPenalty),
+            coupling: Math.max(0, 100 - couplingPenalty),
+            zombies: Math.max(0, 100 - zombiePenalty),
+        };
+        const totalScore = Math.round((scores.complexity * 0.4) + (scores.coupling * 0.4) + (scores.zombies * 0.2));
+        return {
+            score: totalScore,
+            breakdown: scores
+        };
+    }
+    /**
+     * Checks for Next.js specific boundary violations or optimizations
+     */
+    checkNextJsBoundaries(components, deps, recommendations) {
+        const clientComponents = components.filter(c => c.isClientComponent);
+        const serverComponents = components.filter(c => !c.isClientComponent);
+        // Insight: Balance check
+        if (clientComponents.length > serverComponents.length && components.length > 5) {
+            recommendations.push({
+                level: 'info',
+                target: 'Project Structure',
+                message: 'High ratio of Client Components detected.',
+                suggestion: 'In Next.js, try to keep the majority of your components as Server Components for better performance.'
+            });
+        }
+    }
+}
+//# sourceMappingURL=insightEngine.js.map

package/dist/analyzer/insightEngine.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview CLI Entry Point
+ * Central entry point for running the tool via command line.
+ * Sets up commands and delegates execution to specific analyzers.
+ */
+/**
+ * Main bootstrap function to initialize CLI commands
+ */
+export declare function bootstrap(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAkBH;;GAEG;AACH,wBAAsB,SAAS,kBA6H9B"}

package/dist/cli/index.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview CLI Entry Point
+ * Central entry point for running the tool via command line.
+ * Sets up commands and delegates execution to specific analyzers.
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { FileScanner } from '../scanners/fileScanner.js';
+import { ComponentAnalyzer } from '../analyzer/componentAnalyzer.js';
+import { DependencyAnalyzer } from '../analyzer/dependencyAnalyzer.js';
+import { TerminalReporter } from '../reporters/terminalReporter.js';
+import { InsightEngine } from '../analyzer/insightEngine.js';
+// MetaAuditScanner is now imported dynamically in the audit command 
+// to ensure it can be safely stripped from the production NPM build.
+import { promises as fs } from 'fs';
+import { fileURLToPath } from 'url';
+import path from 'path';
+const program = new Command();
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * Main bootstrap function to initialize CLI commands
+ */
+export async function bootstrap() {
+    program
+        .name('react-lens')
+        .description('CLI tool for analyzing React/Next project architecture')
+        .version('1.0.0');
+    program
+        .command('analyze')
+        .description('Analyze the project architecture')
+        .argument('[path]', 'path to the project', '.')
+        .option('-j, --json [file]', 'output report in JSON format (optional path to save to file)')
+        .option('-s, --silent', 'suppress terminal report (best for piping JSON)')
+        .option('-g, --graph <file>', 'output dependency graph to file (dot/svg)')
+        .option('--fail-under <score>', 'exit with error if score is below this value')
+        .action(async (projectPath, options) => {
+        const isSilent = options.silent || (options.json === true);
+        if (!isSilent) {
+            console.log(chalk.cyan('Starting architectural analysis...'));
+        }
+        try {
+            // 1. File Scanning
+            const scanner = new FileScanner();
+            const projectInfo = await scanner.scan(projectPath);
+            if (projectInfo.files.length === 0) {
+                console.log(chalk.yellow('Warning: No relevant files found in common directories.'));
+                return;
+            }
+            // 2. Component Analysis (AST)
+            const componentAnalyzer = new ComponentAnalyzer();
+            let allComponentMetrics = [];
+            for (const file of projectInfo.files) {
+                const metrics = await componentAnalyzer.analyzeFile(file);
+                allComponentMetrics = [...allComponentMetrics, ...metrics];
+            }
+            // 3. Dependency Analysis
+            const dependencyAnalyzer = new DependencyAnalyzer();
+            const dependencyMetrics = await dependencyAnalyzer.analyze(projectInfo.rootPath, 'index.ts');
+            // 4. Intelligence Insight Engine
+            const insightEngine = new InsightEngine();
+            const insightReport = insightEngine.generateReport(allComponentMetrics, dependencyMetrics);
+            // 5. Reporting
+            if (!isSilent) {
+                const reporter = new TerminalReporter();
+                reporter.report(projectInfo, allComponentMetrics, dependencyMetrics, insightReport);
+            }
+            // 6. JSON Export / Stdout
+            if (options.json) {
+                const fullReport = {
+                    project: projectInfo,
+                    components: allComponentMetrics,
+                    dependencies: dependencyMetrics,
+                    insights: insightReport,
+                    timestamp: new Date().toISOString()
+                };
+                const jsonString = JSON.stringify(fullReport, null, 2);
+                if (typeof options.json === 'string') {
+                    await fs.writeFile(options.json, jsonString);
+                    if (!isSilent) {
+                        console.log(chalk.green(`\nReport saved to: ${options.json}`));
+                    }
+                }
+                else {
+                    // Direct stdout for piping
+                    console.log(jsonString);
+                }
+            }
+            // 7. Graph Export
+            if (options.graph) {
+                try {
+                    await dependencyAnalyzer.exportGraph(options.graph);
+                    console.log(chalk.green(`\nDependency graph exported to: ${options.graph}`));
+                }
+                catch (err) {
+                    console.warn(chalk.yellow(`\nWarning: Could not export graph. Ensure Graphviz is installed for SVG/Images.`), err);
+                }
+            }
+            // 8. CI/CD Guard
+            if (options.failUnder) {
+                const threshold = parseInt(options.failUnder, 10);
+                if (insightReport.score < threshold) {
+                    console.error(chalk.red(`\nBuild Failed: Architecture score ${insightReport.score}% is below threshold ${threshold}%`));
+                    process.exit(1);
+                }
+            }
+        }
+        catch (error) {
+            console.error(chalk.red('\nAnalysis failed:'), error);
+            process.exit(1);
+        }
+    });
+    program
+        .command('audit')
+        .description('Run internal security audit (Development only)')
+        .option('--self', 'run audit on react-lens itself')
+        .action(async (options) => {
+        if (options.self) {
+            try {
+                // Dynamic import allows this module to be stripped from NPM
+                // @ts-ignore
+                const { MetaAuditScanner } = await import('../audit/scanner.js');
+                const projectRoot = path.join(__dirname, '../../');
+                const scanner = new MetaAuditScanner(projectRoot);
+                const passed = await scanner.runAudit();
+                if (!passed)
+                    process.exit(1);
+            }
+            catch (error) {
+                console.error(chalk.red('\n[ERROR] Security Audit module is only available in Development/Source mode.'));
+                process.exit(1);
+            }
+        }
+        else {
+            console.log(chalk.yellow('Please use --self to audit the tool itself.'));
+        }
+    });
+    program.parse(process.argv);
+}
+// Start only if file is executed directly
+const isMain = process.argv[1] === fileURLToPath(import.meta.url) || process.argv[1]?.endsWith('index.ts');
+if (isMain) {
+    bootstrap().catch((err) => {
+        console.error(chalk.red('Fatal Error during execution:'), err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/reporters/terminalReporter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview TerminalReporter
+ * Responsible for formatting and displaying results to the user in the CLI.
+ * Uses Chalk for aesthetic styling and informative colors.
+ */
+import { ProjectInfo } from '../scanners/fileScanner.js';
+import { ComponentMetrics } from '../analyzer/componentAnalyzer.js';
+import { DependencyMetrics } from '../analyzer/dependencyAnalyzer.js';
+import { ArchitectureReport } from '../analyzer/insightEngine.js';
+export declare class TerminalReporter {
+    /**
+     * Displays the final report in a formatted and attractive way
+     * @param projectInfo Basic scanning information
+     * @param componentsMetrics Component analysis results
+     * @param dependencyMetrics Dependency analysis results
+     * @param insightReport Advanced insights and scoring
+     */
+    report(projectInfo: ProjectInfo, componentsMetrics: ComponentMetrics[], dependencyMetrics: DependencyMetrics, insightReport: ArchitectureReport): void;
+    private getLevelColor;
+    /**
+     * Determines color based on score value
+     * @param score Numerical score from 0-100
+     */
+    private getScoreColor;
+}
+//# sourceMappingURL=terminalReporter.d.ts.map

package/dist/reporters/terminalReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalReporter.d.ts","sourceRoot":"","sources":["../../src/reporters/terminalReporter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAkB,MAAM,8BAA8B,CAAC;AAElF,qBAAa,gBAAgB;IAC3B;;;;;;OAMG;IACH,MAAM,CACJ,WAAW,EAAE,WAAW,EACxB,iBAAiB,EAAE,gBAAgB,EAAE,EACrC,iBAAiB,EAAE,iBAAiB,EACpC,aAAa,EAAE,kBAAkB;IA4DnC,OAAO,CAAC,aAAa;IAMrB;;;OAGG;IACH,OAAO,CAAC,aAAa;CAKtB"}

package/dist/reporters/terminalReporter.js

@@ -0,0 +1,84 @@
+/**
+ * @fileoverview TerminalReporter
+ * Responsible for formatting and displaying results to the user in the CLI.
+ * Uses Chalk for aesthetic styling and informative colors.
+ */
+import chalk from 'chalk';
+export class TerminalReporter {
+    /**
+     * Displays the final report in a formatted and attractive way
+     * @param projectInfo Basic scanning information
+     * @param componentsMetrics Component analysis results
+     * @param dependencyMetrics Dependency analysis results
+     * @param insightReport Advanced insights and scoring
+     */
+    report(projectInfo, componentsMetrics, dependencyMetrics, insightReport) {
+        const border = '━'.repeat(45);
+        const subBorder = '─'.repeat(45);
+        console.log('\n' + chalk.cyan(border));
+        console.log(chalk.cyan.bold('  ReactLens Architecture Report'));
+        console.log(chalk.cyan(border) + '\n');
+        // Stats
+        const typeLabel = projectInfo.type === 'node-cli' ? 'Node CLI Tool' : projectInfo.type.toUpperCase();
+        console.log(chalk.bold('General Statistics'));
+        console.log(`${chalk.dim('• Project Type:')} ${chalk.green(typeLabel)}`);
+        console.log(`${chalk.dim('• Modules:')}      ${chalk.blue(dependencyMetrics.internalModules.length)} internal / ${chalk.blue(dependencyMetrics.externalModules.length)} external`);
+        console.log(`${chalk.dim('• Components:')}   ${chalk.blue(componentsMetrics.length)}`);
+        // Score Breakdown
+        console.log('\n' + chalk.bold('Health Breakdown'));
+        console.log(`${chalk.dim('• Complexity:')} ${this.getScoreColor(insightReport.breakdown.complexity)(insightReport.breakdown.complexity + '%')}`);
+        console.log(`${chalk.dim('• Coupling:')}   ${this.getScoreColor(insightReport.breakdown.coupling)(insightReport.breakdown.coupling + '%')}`);
+        console.log(`${chalk.dim('• Zombies:')}    ${this.getScoreColor(insightReport.breakdown.zombies)(insightReport.breakdown.zombies + '%')}`);
+        console.log(chalk.dim(subBorder));
+        // Insights
+        if (insightReport.recommendations.length > 0) {
+            console.log('\n' + chalk.bold('Actionable Insights'));
+            const sortedRecs = [...insightReport.recommendations].sort((a, b) => {
+                const order = { error: 0, warning: 1, info: 2 };
+                return order[a.level] - order[b.level];
+            });
+            sortedRecs.forEach(rec => {
+                let label = '[INFO]';
+                let color = chalk.blue;
+                if (rec.level === 'error') {
+                    label = '[ERROR]';
+                    color = chalk.red.bold;
+                }
+                else if (rec.level === 'warning') {
+                    label = '[WARN]';
+                    color = chalk.yellow.bold;
+                }
+                console.log(`\n${color(label)} ${chalk.bold(rec.target)}`);
+                console.log(`  ${chalk.white(rec.message)}`);
+                console.log(`  ${chalk.dim('↳')} ${chalk.green(rec.suggestion)}`);
+            });
+        }
+        else {
+            console.log('\n' + chalk.green('[OK] Architecture is healthy. No issues found.'));
+        }
+        // Final Score
+        console.log('\n' + chalk.dim(subBorder));
+        const scoreColor = this.getScoreColor(insightReport.score);
+        console.log(`${chalk.bold('Overall Architecture Score:')} ${scoreColor.bold(insightReport.score + '%')}`);
+        console.log(chalk.cyan(border) + '\n');
+    }
+    getLevelColor(level) {
+        if (level === 'error')
+            return chalk.red;
+        if (level === 'warning')
+            return chalk.yellow;
+        return chalk.cyan;
+    }
+    /**
+     * Determines color based on score value
+     * @param score Numerical score from 0-100
+     */
+    getScoreColor(score) {
+        if (score > 80)
+            return chalk.green;
+        if (score > 50)
+            return chalk.yellow;
+        return chalk.red;
+    }
+}
+//# sourceMappingURL=terminalReporter.js.map

package/dist/reporters/terminalReporter.js.map

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

package/dist/scanners/fileScanner.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview FileScanner
+ * Responsible for discovering project files and identifying the framework (React, Next, Vue).
+ * Supports automatic detection of JavaScript and TypeScript files.
+ */
+/**
+ * Represents discovered project information
+ */
+export interface ProjectInfo {
+    type: 'react' | 'next' | 'vue' | 'node-cli' | 'unknown';
+    rootPath: string;
+    files: string[];
+}
+export declare class FileScanner {
+    /**
+     * Starts project scanning from a given path
+     * @param targetPath The path where search begins
+     */
+    scan(targetPath: string): Promise<ProjectInfo>;
+    /**
+     * Scans package.json to determine the framework used
+     * @param rootPath Project root path
+     */
+    private detectProjectType;
+    /**
+     * Uses fast-glob to search for supported file extensions (js, ts, jsx, tsx)
+     * @param rootPath Search root path
+     */
+    private discoverFiles;
+}
+//# sourceMappingURL=fileScanner.d.ts.map

package/dist/scanners/fileScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileScanner.d.ts","sourceRoot":"","sources":["../../src/scanners/fileScanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,CAAC;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,qBAAa,WAAW;IACtB;;;OAGG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAYpD;;;OAGG;YACW,iBAAiB;IAqB/B;;;OAGG;YACW,aAAa;CA0B5B"}

package/dist/scanners/fileScanner.js

@@ -0,0 +1,78 @@
+/**
+ * @fileoverview FileScanner
+ * Responsible for discovering project files and identifying the framework (React, Next, Vue).
+ * Supports automatic detection of JavaScript and TypeScript files.
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+import fg from 'fast-glob';
+export class FileScanner {
+    /**
+     * Starts project scanning from a given path
+     * @param targetPath The path where search begins
+     */
+    async scan(targetPath) {
+        const rootPath = path.resolve(targetPath);
+        const projectType = await this.detectProjectType(rootPath);
+        const files = await this.discoverFiles(rootPath);
+        return {
+            type: projectType,
+            rootPath,
+            files
+        };
+    }
+    /**
+     * Scans package.json to determine the framework used
+     * @param rootPath Project root path
+     */
+    async detectProjectType(rootPath) {
+        try {
+            const packageJsonPath = path.join(rootPath, 'package.json');
+            const content = await fs.readFile(packageJsonPath, 'utf-8');
+            const pkg = JSON.parse(content);
+            const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+            if (deps['next'])
+                return 'next';
+            if (deps['vue'])
+                return 'vue';
+            if (deps['react'])
+                return 'react';
+            // Detection of CLI Tools
+            if (pkg.bin)
+                return 'node-cli';
+            return 'unknown';
+        }
+        catch {
+            return 'unknown';
+        }
+    }
+    /**
+     * Uses fast-glob to search for supported file extensions (js, ts, jsx, tsx)
+     * @param rootPath Search root path
+     */
+    async discoverFiles(rootPath) {
+        const patterns = [
+            'src/**/*.{js,jsx,ts,tsx}',
+            'app/**/*.{js,jsx,ts,tsx}', // Support for Next.js App Router
+            'components/**/*.{js,jsx,ts,tsx}',
+            'pages/**/*.{js,jsx,ts,tsx}'
+        ];
+        const files = await fg(patterns, {
+            cwd: rootPath,
+            absolute: true,
+            ignore: [
+                '**/node_modules/**',
+                '**/dist/**',
+                '**/.next/**',
+                '**/__tests__/**',
+                '**/*.test.{js,ts,jsx,tsx}',
+                '**/*.spec.{js,ts,jsx,tsx}',
+                'vitest.config.{js,ts,mjs}',
+                'jest.config.{js,ts}',
+                'tsconfig.json'
+            ]
+        });
+        return files;
+    }
+}
+//# sourceMappingURL=fileScanner.js.map

package/dist/scanners/fileScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileScanner.js","sourceRoot":"","sources":["../../src/scanners/fileScanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,WAAW,CAAC;AAW3B,MAAM,OAAO,WAAW;IACtB;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,UAAkB;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC3D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QAEjD,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,QAAQ;YACR,KAAK;SACN,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,iBAAiB,CAAC,QAAgB;QAC9C,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;YAC5D,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAEhC,MAAM,IAAI,GAAG,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC;YAE7D,IAAI,IAAI,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAC;YAChC,IAAI,IAAI,CAAC,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC9B,IAAI,IAAI,CAAC,OAAO,CAAC;gBAAE,OAAO,OAAO,CAAC;YAElC,yBAAyB;YACzB,IAAI,GAAG,CAAC,GAAG;gBAAE,OAAO,UAAU,CAAC;YAE/B,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,aAAa,CAAC,QAAgB;QAC1C,MAAM,QAAQ,GAAG;YACf,0BAA0B;YAC1B,0BAA0B,EAAE,iCAAiC;YAC7D,iCAAiC;YACjC,4BAA4B;SAC7B,CAAC;QAEF,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC/B,GAAG,EAAE,QAAQ;YACb,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE;gBACN,oBAAoB;gBACpB,YAAY;gBACZ,aAAa;gBACb,iBAAiB;gBACjB,2BAA2B;gBAC3B,2BAA2B;gBAC3B,2BAA2B;gBAC3B,qBAAqB;gBACrB,eAAe;aAChB;SACF,CAAC,CAAC;QAEH,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@mohamed_fadl/reactlens",
+  "version": "1.2.0-beta.1",
+  "description": "Intelligent architectural analysis tool for React and Next.js applications.",
+  "main": "./dist/cli/index.js",
+  "bin": {
+    "reactlens": "./dist/cli/index.js"
+  },
+  "keywords": [
+    "react",
+    "nextjs",
+    "architecture",
+    "analysis",
+    "dependencies",
+    "circular-dependencies",
+    "zombie-components",
+    "refactoring"
+  ],
+  "author": "ReactLens Team",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/react-lens/reactlens.git"
+  },
+  "bugs": {
+    "url": "https://github.com/react-lens/reactlens/issues"
+  },
+  "homepage": "https://github.com/react-lens/reactlens#readme",
+  "scripts": {
+    "dev": "tsx src/cli/index.ts analyze",
+    "build": "tsc",
+    "audit:self": "tsx src/cli/index.ts audit --self",
+    "prepublishOnly": "npm run audit:self && npm run build && npm test",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "coverage": "vitest run --coverage"
+  },
+  "devDependencies": {
+    "@types/babel__traverse": "^7.28.0",
+    "@types/madge": "^5.0.3",
+    "@types/node": "^25.5.0",
+    "@vitest/coverage-v8": "^4.1.0",
+    "eslint-plugin-security": "^4.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  },
+  "dependencies": {
+    "@babel/parser": "^7.29.0",
+    "@babel/traverse": "^7.29.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "fast-glob": "^3.3.3",
+    "madge": "^8.0.0"
+  }
+}