@dinyangetoh/codeplug-cli 0.1.0

package/dist/core/analyzer/AstAnalyzer.js

@@ -0,0 +1,95 @@
+import { join, extname } from 'node:path';
+import { readFile } from 'node:fs/promises';
+const SUPPORTED_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs']);
+const BATCH_SIZE = 50;
+export class AstAnalyzer {
+    projectRoot;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    async analyze() {
+        const start = Date.now();
+        const { globby } = await import('globby');
+        const files = await globby(['**/*.{ts,tsx,js,jsx,mjs,cjs}'], {
+            cwd: this.projectRoot,
+            gitignore: true,
+            ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.codeplug/**'],
+            absolute: false,
+        });
+        const sourceFiles = files.filter((f) => SUPPORTED_EXTENSIONS.has(extname(f)));
+        const { PatternAggregator } = await import('./PatternAggregator.js');
+        const aggregator = new PatternAggregator();
+        for await (const batch of this.processBatches(sourceFiles)) {
+            aggregator.ingest(batch);
+        }
+        const folderStructure = this.buildFolderTree(sourceFiles);
+        aggregator.ingestStructure(folderStructure);
+        return {
+            fileCount: sourceFiles.length,
+            durationMs: Date.now() - start,
+            patterns: aggregator.getPatterns(),
+            folderStructure,
+        };
+    }
+    async *processBatches(files) {
+        for (let i = 0; i < files.length; i += BATCH_SIZE) {
+            const batch = files.slice(i, i + BATCH_SIZE);
+            const results = await Promise.all(batch.map((f) => this.parseFile(f)));
+            yield results.filter((r) => r !== null);
+        }
+    }
+    async parseFile(filePath) {
+        try {
+            const absolutePath = join(this.projectRoot, filePath);
+            const code = await readFile(absolutePath, 'utf-8');
+            const { parse } = await import('@babel/parser');
+            const ast = parse(code, {
+                sourceType: 'module',
+                plugins: [
+                    'typescript',
+                    'jsx',
+                    'decorators-legacy',
+                    'classProperties',
+                    'optionalChaining',
+                    'nullishCoalescingOperator',
+                    'dynamicImport',
+                ],
+                errorRecovery: true,
+            });
+            return { filePath, code, ast };
+        }
+        catch {
+            return null;
+        }
+    }
+    buildFolderTree(files) {
+        const root = {
+            name: '.',
+            path: '.',
+            children: [],
+            fileCount: 0,
+        };
+        for (const file of files) {
+            const parts = file.split('/');
+            let current = root;
+            current.fileCount++;
+            for (let i = 0; i < parts.length - 1; i++) {
+                const dirName = parts[i];
+                let child = current.children.find((c) => c.name === dirName);
+                if (!child) {
+                    child = {
+                        name: dirName,
+                        path: parts.slice(0, i + 1).join('/'),
+                        children: [],
+                        fileCount: 0,
+                    };
+                    current.children.push(child);
+                }
+                child.fileCount++;
+                current = child;
+            }
+        }
+        return root;
+    }
+}
+//# sourceMappingURL=AstAnalyzer.js.map

package/dist/core/analyzer/AstAnalyzer.js.map

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

package/dist/core/analyzer/ConventionDetector.d.ts

@@ -0,0 +1,6 @@
+import type { AnalysisResult, ConventionCandidate } from '../../config/types.js';
+export declare class ConventionDetector {
+    detect(analysis: AnalysisResult): Promise<ConventionCandidate[]>;
+    private generateId;
+}
+//# sourceMappingURL=ConventionDetector.d.ts.map

package/dist/core/analyzer/ConventionDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConventionDetector.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/ConventionDetector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAuB,MAAM,uBAAuB,CAAC;AActG,qBAAa,kBAAkB;IACvB,MAAM,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAmBtE,OAAO,CAAC,UAAU;CAQnB"}

package/dist/core/analyzer/ConventionDetector.js

@@ -0,0 +1,38 @@
+const SEVERITY_MAP = {
+    naming: 'medium',
+    structure: 'high',
+    component: 'medium',
+    testing: 'medium',
+    'error-handling': 'high',
+    imports: 'low',
+    git: 'low',
+    state: 'medium',
+    api: 'medium',
+};
+export class ConventionDetector {
+    async detect(analysis) {
+        const candidates = [];
+        for (const pattern of analysis.patterns) {
+            if (pattern.confidence < 60)
+                continue;
+            candidates.push({
+                id: this.generateId(pattern.dimension, pattern.pattern),
+                dimension: pattern.dimension,
+                rule: pattern.pattern,
+                confidence: pattern.confidence,
+                examples: pattern.examples.slice(0, 5),
+                severity: SEVERITY_MAP[pattern.dimension] ?? 'medium',
+            });
+        }
+        return candidates.sort((a, b) => b.confidence - a.confidence);
+    }
+    generateId(dimension, pattern) {
+        const slug = pattern
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-|-$/g, '')
+            .slice(0, 40);
+        return `${dimension}-${slug}`;
+    }
+}
+//# sourceMappingURL=ConventionDetector.js.map

package/dist/core/analyzer/ConventionDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConventionDetector.js","sourceRoot":"","sources":["../../../src/core/analyzer/ConventionDetector.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAyC;IACzD,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,MAAM;IACjB,SAAS,EAAE,QAAQ;IACnB,OAAO,EAAE,QAAQ;IACjB,gBAAgB,EAAE,MAAM;IACxB,OAAO,EAAE,KAAK;IACd,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,QAAQ;IACf,GAAG,EAAE,QAAQ;CACd,CAAC;AAEF,MAAM,OAAO,kBAAkB;IAC7B,KAAK,CAAC,MAAM,CAAC,QAAwB;QACnC,MAAM,UAAU,GAA0B,EAAE,CAAC;QAE7C,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACxC,IAAI,OAAO,CAAC,UAAU,GAAG,EAAE;gBAAE,SAAS;YAEtC,UAAU,CAAC,IAAI,CAAC;gBACd,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC;gBACvD,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,IAAI,EAAE,OAAO,CAAC,OAAO;gBACrB,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBACtC,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,QAAQ;aACtD,CAAC,CAAC;QACL,CAAC;QAED,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IAChE,CAAC;IAEO,UAAU,CAAC,SAAiB,EAAE,OAAe;QACnD,MAAM,IAAI,GAAG,OAAO;aACjB,WAAW,EAAE;aACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;aAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;aACrB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChB,OAAO,GAAG,SAAS,IAAI,IAAI,EAAE,CAAC;IAChC,CAAC;CACF"}

package/dist/core/analyzer/PatternAggregator.d.ts

@@ -0,0 +1,11 @@
+import type { ParsedFile } from './AstAnalyzer.js';
+import type { DetectedPattern, FolderNode } from '../../config/types.js';
+export declare class PatternAggregator {
+    private accumulators;
+    private visitors;
+    ingest(files: ParsedFile[]): void;
+    ingestStructure(tree: FolderNode): void;
+    getPatterns(): DetectedPattern[];
+    private addStructurePattern;
+}
+//# sourceMappingURL=PatternAggregator.d.ts.map

package/dist/core/analyzer/PatternAggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PatternAggregator.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/PatternAggregator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAa,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAepF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,YAAY,CAAyC;IAC7D,OAAO,CAAC,QAAQ,CAMd;IAEF,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI;IA2BjC,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAyBvC,WAAW,IAAI,eAAe,EAAE;IAqBhC,OAAO,CAAC,mBAAmB;CAU5B"}

package/dist/core/analyzer/PatternAggregator.js

@@ -0,0 +1,94 @@
+import { NamingVisitor } from './visitors/NamingVisitor.js';
+import { ComponentVisitor } from './visitors/ComponentVisitor.js';
+import { TestVisitor } from './visitors/TestVisitor.js';
+import { ErrorHandlingVisitor } from './visitors/ErrorHandlingVisitor.js';
+import { ImportVisitor } from './visitors/ImportVisitor.js';
+export class PatternAggregator {
+    accumulators = new Map();
+    visitors = [
+        new NamingVisitor(),
+        new ComponentVisitor(),
+        new TestVisitor(),
+        new ErrorHandlingVisitor(),
+        new ImportVisitor(),
+    ];
+    ingest(files) {
+        for (const file of files) {
+            for (const visitor of this.visitors) {
+                const findings = visitor.visit(file);
+                for (const f of findings) {
+                    const key = `${f.dimension}:${f.pattern}`;
+                    const existing = this.accumulators.get(key);
+                    if (existing) {
+                        existing.count += f.count;
+                        existing.total += f.total;
+                        if (existing.examples.length < 5 && f.example) {
+                            existing.examples.push(f.example);
+                        }
+                    }
+                    else {
+                        this.accumulators.set(key, {
+                            dimension: f.dimension,
+                            pattern: f.pattern,
+                            count: f.count,
+                            total: f.total,
+                            examples: f.example ? [f.example] : [],
+                        });
+                    }
+                }
+            }
+        }
+    }
+    ingestStructure(tree) {
+        const topDirs = tree.children.map((c) => c.name);
+        const featureLike = ['features', 'modules', 'domains', 'pages'];
+        const mvcLike = ['models', 'views', 'controllers'];
+        const layeredLike = ['controllers', 'services', 'repositories', 'entities'];
+        const isFeatureBased = featureLike.some((d) => topDirs.includes(d));
+        const isMvc = mvcLike.filter((d) => topDirs.includes(d)).length >= 2;
+        const isLayered = layeredLike.filter((d) => topDirs.includes(d)).length >= 2;
+        if (isFeatureBased) {
+            this.addStructurePattern('Feature-based folder structure', topDirs);
+        }
+        else if (isMvc) {
+            this.addStructurePattern('MVC folder structure', topDirs);
+        }
+        else if (isLayered) {
+            this.addStructurePattern('Layered architecture folder structure', topDirs);
+        }
+        const hasSrcDir = topDirs.includes('src');
+        if (hasSrcDir) {
+            this.addStructurePattern('src/ root directory convention', ['src/']);
+        }
+    }
+    getPatterns() {
+        const results = [];
+        for (const acc of this.accumulators.values()) {
+            if (acc.total === 0)
+                continue;
+            const confidence = Math.round((acc.count / acc.total) * 100);
+            if (confidence < 50)
+                continue;
+            results.push({
+                dimension: acc.dimension,
+                pattern: acc.pattern,
+                frequency: acc.count,
+                total: acc.total,
+                confidence,
+                examples: acc.examples,
+            });
+        }
+        return results.sort((a, b) => b.confidence - a.confidence);
+    }
+    addStructurePattern(pattern, examples) {
+        const key = `structure:${pattern}`;
+        this.accumulators.set(key, {
+            dimension: 'structure',
+            pattern,
+            count: 1,
+            total: 1,
+            examples,
+        });
+    }
+}
+//# sourceMappingURL=PatternAggregator.js.map

package/dist/core/analyzer/PatternAggregator.js.map

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

package/dist/core/analyzer/visitors/ComponentVisitor.d.ts

@@ -0,0 +1,6 @@
+import type { AstVisitor, VisitorFinding } from './types.js';
+import type { ParsedFile } from '../AstAnalyzer.js';
+export declare class ComponentVisitor implements AstVisitor {
+    visit(file: ParsedFile): VisitorFinding[];
+}
+//# sourceMappingURL=ComponentVisitor.d.ts.map

package/dist/core/analyzer/visitors/ComponentVisitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentVisitor.d.ts","sourceRoot":"","sources":["../../../../src/core/analyzer/visitors/ComponentVisitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD,qBAAa,gBAAiB,YAAW,UAAU;IACjD,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,EAAE;CAgF1C"}

package/dist/core/analyzer/visitors/ComponentVisitor.js

@@ -0,0 +1,80 @@
+import traverse from '@babel/traverse';
+import { extname } from 'node:path';
+export class ComponentVisitor {
+    visit(file) {
+        const ext = extname(file.filePath);
+        if (ext !== '.tsx' && ext !== '.jsx')
+            return [];
+        const findings = [];
+        let hasFunctionalComponent = false;
+        let hasClassComponent = false;
+        let hasHooks = false;
+        try {
+            // @ts-expect-error -- @babel/traverse CJS default export not resolved under NodeNext
+            traverse(file.ast, {
+                FunctionDeclaration(path) {
+                    if (returnsJSX(path.node.body))
+                        hasFunctionalComponent = true;
+                },
+                ArrowFunctionExpression(path) {
+                    if (path.node.body.type === 'JSXElement' ||
+                        path.node.body.type === 'JSXFragment' ||
+                        (path.node.body.type === 'BlockStatement' && returnsJSX(path.node.body))) {
+                        hasFunctionalComponent = true;
+                    }
+                },
+                ClassDeclaration(path) {
+                    const sc = path.node.superClass;
+                    if (sc &&
+                        ((sc.type === 'Identifier' && sc.name === 'Component') ||
+                            (sc.type === 'MemberExpression' && sc.property?.name === 'Component'))) {
+                        hasClassComponent = true;
+                    }
+                },
+                CallExpression(path) {
+                    if (path.node.callee.type === 'Identifier' &&
+                        /^use[A-Z]/.test(path.node.callee.name ?? '')) {
+                        hasHooks = true;
+                    }
+                },
+                noScope: true,
+            });
+        }
+        catch {
+            return findings;
+        }
+        if (hasFunctionalComponent) {
+            findings.push({
+                dimension: 'component',
+                pattern: 'Functional components',
+                count: 1,
+                total: 1,
+                example: file.filePath,
+            });
+        }
+        if (hasClassComponent) {
+            findings.push({
+                dimension: 'component',
+                pattern: 'Class components',
+                count: 1,
+                total: 1,
+                example: file.filePath,
+            });
+        }
+        if (hasHooks) {
+            findings.push({
+                dimension: 'component',
+                pattern: 'Hooks composition pattern',
+                count: 1,
+                total: 1,
+                example: file.filePath,
+            });
+        }
+        return findings;
+    }
+}
+function returnsJSX(body) {
+    return body.body?.some((stmt) => stmt.type === 'ReturnStatement' &&
+        (stmt.argument?.type === 'JSXElement' || stmt.argument?.type === 'JSXFragment')) ?? false;
+}
+//# sourceMappingURL=ComponentVisitor.js.map

package/dist/core/analyzer/visitors/ComponentVisitor.js.map

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

package/dist/core/analyzer/visitors/ErrorHandlingVisitor.d.ts

@@ -0,0 +1,6 @@
+import type { AstVisitor, VisitorFinding } from './types.js';
+import type { ParsedFile } from '../AstAnalyzer.js';
+export declare class ErrorHandlingVisitor implements AstVisitor {
+    visit(file: ParsedFile): VisitorFinding[];
+}
+//# sourceMappingURL=ErrorHandlingVisitor.d.ts.map

package/dist/core/analyzer/visitors/ErrorHandlingVisitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorHandlingVisitor.d.ts","sourceRoot":"","sources":["../../../../src/core/analyzer/visitors/ErrorHandlingVisitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,qBAAa,oBAAqB,YAAW,UAAU;IACrD,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,EAAE;CA6C1C"}

package/dist/core/analyzer/visitors/ErrorHandlingVisitor.js

@@ -0,0 +1,48 @@
+import traverse from '@babel/traverse';
+export class ErrorHandlingVisitor {
+    visit(file) {
+        const findings = [];
+        let tryCatchCount = 0;
+        let asyncFnCount = 0;
+        try {
+            // @ts-expect-error -- @babel/traverse CJS default export not resolved under NodeNext
+            traverse(file.ast, {
+                TryStatement() {
+                    tryCatchCount++;
+                },
+                FunctionDeclaration(path) {
+                    if (path.node.async)
+                        asyncFnCount++;
+                },
+                ArrowFunctionExpression(path) {
+                    if (path.node.async)
+                        asyncFnCount++;
+                },
+                noScope: true,
+            });
+        }
+        catch {
+            return findings;
+        }
+        if (tryCatchCount > 0) {
+            findings.push({
+                dimension: 'error-handling',
+                pattern: 'Try/catch error handling',
+                count: tryCatchCount,
+                total: Math.max(tryCatchCount, asyncFnCount),
+                example: file.filePath,
+            });
+        }
+        if (asyncFnCount > 0) {
+            findings.push({
+                dimension: 'api',
+                pattern: 'Async/await pattern',
+                count: asyncFnCount,
+                total: asyncFnCount,
+                example: file.filePath,
+            });
+        }
+        return findings;
+    }
+}
+//# sourceMappingURL=ErrorHandlingVisitor.js.map

package/dist/core/analyzer/visitors/ErrorHandlingVisitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorHandlingVisitor.js","sourceRoot":"","sources":["../../../../src/core/analyzer/visitors/ErrorHandlingVisitor.ts"],"names":[],"mappings":"AAEA,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AAEvC,MAAM,OAAO,oBAAoB;IAC/B,KAAK,CAAC,IAAgB;QACpB,MAAM,QAAQ,GAAqB,EAAE,CAAC;QACtC,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,IAAI,CAAC;YACH,qFAAqF;YACrF,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE;gBACjB,YAAY;oBACV,aAAa,EAAE,CAAC;gBAClB,CAAC;gBACD,mBAAmB,CAAC,IAAkC;oBACpD,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK;wBAAE,YAAY,EAAE,CAAC;gBACtC,CAAC;gBACD,uBAAuB,CAAC,IAAkC;oBACxD,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK;wBAAE,YAAY,EAAE,CAAC;gBACtC,CAAC;gBACD,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;YACtB,QAAQ,CAAC,IAAI,CAAC;gBACZ,SAAS,EAAE,gBAAgB;gBAC3B,OAAO,EAAE,0BAA0B;gBACnC,KAAK,EAAE,aAAa;gBACpB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,YAAY,CAAC;gBAC5C,OAAO,EAAE,IAAI,CAAC,QAAQ;aACvB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,QAAQ,CAAC,IAAI,CAAC;gBACZ,SAAS,EAAE,KAAK;gBAChB,OAAO,EAAE,qBAAqB;gBAC9B,KAAK,EAAE,YAAY;gBACnB,KAAK,EAAE,YAAY;gBACnB,OAAO,EAAE,IAAI,CAAC,QAAQ;aACvB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/core/analyzer/visitors/ImportVisitor.d.ts

@@ -0,0 +1,6 @@
+import type { AstVisitor, VisitorFinding } from './types.js';
+import type { ParsedFile } from '../AstAnalyzer.js';
+export declare class ImportVisitor implements AstVisitor {
+    visit(file: ParsedFile): VisitorFinding[];
+}
+//# sourceMappingURL=ImportVisitor.d.ts.map

package/dist/core/analyzer/visitors/ImportVisitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImportVisitor.d.ts","sourceRoot":"","sources":["../../../../src/core/analyzer/visitors/ImportVisitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD,qBAAa,aAAc,YAAW,UAAU;IAC9C,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,EAAE;CAsE1C"}

package/dist/core/analyzer/visitors/ImportVisitor.js

@@ -0,0 +1,68 @@
+import traverse from '@babel/traverse';
+import { basename } from 'node:path';
+export class ImportVisitor {
+    visit(file) {
+        const findings = [];
+        let namedImportCount = 0;
+        let defaultImportCount = 0;
+        let totalImports = 0;
+        let barrelImportCount = 0;
+        try {
+            // @ts-expect-error -- @babel/traverse CJS default export not resolved under NodeNext
+            traverse(file.ast, {
+                ImportDeclaration(path) {
+                    totalImports++;
+                    const specs = path.node.specifiers;
+                    const hasDefault = specs.some((s) => s.type === 'ImportDefaultSpecifier');
+                    const hasNamed = specs.some((s) => s.type === 'ImportSpecifier');
+                    if (hasDefault)
+                        defaultImportCount++;
+                    if (hasNamed)
+                        namedImportCount++;
+                    const src = path.node.source.value;
+                    if (src.endsWith('/index') || /^\.\.?\/[^/]+$/.test(src)) {
+                        const base = basename(src);
+                        if (base === 'index' || !base.includes('.')) {
+                            barrelImportCount++;
+                        }
+                    }
+                },
+                noScope: true,
+            });
+        }
+        catch {
+            return findings;
+        }
+        if (totalImports > 0) {
+            if (namedImportCount > defaultImportCount) {
+                findings.push({
+                    dimension: 'imports',
+                    pattern: 'Prefer named imports over default imports',
+                    count: namedImportCount,
+                    total: totalImports,
+                    example: file.filePath,
+                });
+            }
+            else if (defaultImportCount > 0) {
+                findings.push({
+                    dimension: 'imports',
+                    pattern: 'Default imports prevalent',
+                    count: defaultImportCount,
+                    total: totalImports,
+                    example: file.filePath,
+                });
+            }
+            if (barrelImportCount > 0) {
+                findings.push({
+                    dimension: 'imports',
+                    pattern: 'Barrel imports (index re-exports)',
+                    count: barrelImportCount,
+                    total: totalImports,
+                    example: file.filePath,
+                });
+            }
+        }
+        return findings;
+    }
+}
+//# sourceMappingURL=ImportVisitor.js.map

package/dist/core/analyzer/visitors/ImportVisitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImportVisitor.js","sourceRoot":"","sources":["../../../../src/core/analyzer/visitors/ImportVisitor.ts"],"names":[],"mappings":"AAEA,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,IAAgB;QACpB,MAAM,QAAQ,GAAqB,EAAE,CAAC;QACtC,IAAI,gBAAgB,GAAG,CAAC,CAAC;QACzB,IAAI,kBAAkB,GAAG,CAAC,CAAC;QAC3B,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAE1B,IAAI,CAAC;YACH,qFAAqF;YACrF,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE;gBACjB,iBAAiB,CAAC,IAKjB;oBACC,YAAY,EAAE,CAAC;oBACf,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;oBACnC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,wBAAwB,CAAC,CAAC;oBAC1E,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC;oBAEjE,IAAI,UAAU;wBAAE,kBAAkB,EAAE,CAAC;oBACrC,IAAI,QAAQ;wBAAE,gBAAgB,EAAE,CAAC;oBAEjC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;oBACnC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;wBACzD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;wBAC3B,IAAI,IAAI,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;4BAC5C,iBAAiB,EAAE,CAAC;wBACtB,CAAC;oBACH,CAAC;gBACH,CAAC;gBACD,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACrB,IAAI,gBAAgB,GAAG,kBAAkB,EAAE,CAAC;gBAC1C,QAAQ,CAAC,IAAI,CAAC;oBACZ,SAAS,EAAE,SAAS;oBACpB,OAAO,EAAE,2CAA2C;oBACpD,KAAK,EAAE,gBAAgB;oBACvB,KAAK,EAAE,YAAY;oBACnB,OAAO,EAAE,IAAI,CAAC,QAAQ;iBACvB,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,kBAAkB,GAAG,CAAC,EAAE,CAAC;gBAClC,QAAQ,CAAC,IAAI,CAAC;oBACZ,SAAS,EAAE,SAAS;oBACpB,OAAO,EAAE,2BAA2B;oBACpC,KAAK,EAAE,kBAAkB;oBACzB,KAAK,EAAE,YAAY;oBACnB,OAAO,EAAE,IAAI,CAAC,QAAQ;iBACvB,CAAC,CAAC;YACL,CAAC;YAED,IAAI,iBAAiB,GAAG,CAAC,EAAE,CAAC;gBAC1B,QAAQ,CAAC,IAAI,CAAC;oBACZ,SAAS,EAAE,SAAS;oBACpB,OAAO,EAAE,mCAAmC;oBAC5C,KAAK,EAAE,iBAAiB;oBACxB,KAAK,EAAE,YAAY;oBACnB,OAAO,EAAE,IAAI,CAAC,QAAQ;iBACvB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/core/analyzer/visitors/NamingVisitor.d.ts

@@ -0,0 +1,7 @@
+import type { AstVisitor, VisitorFinding } from './types.js';
+import type { ParsedFile } from '../AstAnalyzer.js';
+export declare class NamingVisitor implements AstVisitor {
+    visit(file: ParsedFile): VisitorFinding[];
+    private visitConstants;
+}
+//# sourceMappingURL=NamingVisitor.d.ts.map

package/dist/core/analyzer/visitors/NamingVisitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NamingVisitor.d.ts","sourceRoot":"","sources":["../../../../src/core/analyzer/visitors/NamingVisitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AASpD,qBAAa,aAAc,YAAW,UAAU;IAC9C,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,EAAE;IA+CzC,OAAO,CAAC,cAAc;CAoCvB"}

package/dist/core/analyzer/visitors/NamingVisitor.js

@@ -0,0 +1,88 @@
+import traverse from '@babel/traverse';
+import { basename, extname } from 'node:path';
+const PASCAL_CASE = /^[A-Z][a-zA-Z0-9]*$/;
+const CAMEL_CASE = /^[a-z][a-zA-Z0-9]*$/;
+const SCREAMING_SNAKE = /^[A-Z][A-Z0-9_]*$/;
+const HOOK_PREFIX = /^use[A-Z]/;
+export class NamingVisitor {
+    visit(file) {
+        const findings = [];
+        const fileName = basename(file.filePath, extname(file.filePath));
+        const ext = extname(file.filePath);
+        const isComponent = ext === '.tsx' || ext === '.jsx';
+        if (isComponent) {
+            findings.push({
+                dimension: 'naming',
+                pattern: 'React components use PascalCase file names',
+                count: PASCAL_CASE.test(fileName) ? 1 : 0,
+                total: 1,
+                example: file.filePath,
+            });
+        }
+        else if (ext === '.ts' || ext === '.js') {
+            if (HOOK_PREFIX.test(fileName)) {
+                findings.push({
+                    dimension: 'naming',
+                    pattern: 'Hooks use "use" prefix with camelCase',
+                    count: CAMEL_CASE.test(fileName) ? 1 : 0,
+                    total: 1,
+                    example: file.filePath,
+                });
+            }
+            else if (PASCAL_CASE.test(fileName)) {
+                findings.push({
+                    dimension: 'naming',
+                    pattern: 'Class/service files use PascalCase',
+                    count: 1,
+                    total: 1,
+                    example: file.filePath,
+                });
+            }
+            else if (CAMEL_CASE.test(fileName)) {
+                findings.push({
+                    dimension: 'naming',
+                    pattern: 'Utility files use camelCase',
+                    count: 1,
+                    total: 1,
+                    example: file.filePath,
+                });
+            }
+        }
+        this.visitConstants(file, findings);
+        return findings;
+    }
+    visitConstants(file, findings) {
+        try {
+            let screamingCount = 0;
+            let constCount = 0;
+            // @ts-expect-error -- @babel/traverse CJS default export not resolved under NodeNext
+            traverse(file.ast, {
+                VariableDeclarator(path) {
+                    const { node } = path;
+                    if (node.id.type === 'Identifier' &&
+                        node.init &&
+                        (node.init.type === 'StringLiteral' || node.init.type === 'NumericLiteral')) {
+                        constCount++;
+                        if (SCREAMING_SNAKE.test(node.id.name)) {
+                            screamingCount++;
+                        }
+                    }
+                },
+                noScope: true,
+            });
+            if (constCount > 0) {
+                findings.push({
+                    dimension: 'naming',
+                    pattern: 'Constants use SCREAMING_SNAKE_CASE',
+                    count: screamingCount,
+                    total: constCount,
+                    example: file.filePath,
+                });
+            }
+        }
+        catch {
+            // traverse may fail on some files
+        }
+    }
+}
+//# sourceMappingURL=NamingVisitor.js.map

package/dist/core/analyzer/visitors/NamingVisitor.js.map

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

package/dist/core/analyzer/visitors/StructureVisitor.d.ts

@@ -0,0 +1,6 @@
+import type { AstVisitor, VisitorFinding } from './types.js';
+import type { ParsedFile } from '../AstAnalyzer.js';
+export declare class StructureVisitor implements AstVisitor {
+    visit(_file: ParsedFile): VisitorFinding[];
+}
+//# sourceMappingURL=StructureVisitor.d.ts.map