@dcyfr/ai-code-gen 0.1.0

package/dist/ai/code-gen.js

@@ -0,0 +1,164 @@
+/**
+ * @dcyfr/ai-code-gen - AI Code Generator
+ *
+ * High-level AI-powered code generation combining prompts with providers.
+ */
+import { createAIProvider, MockAIProvider } from './provider.js';
+import { reviewCodePrompt, refactorCodePrompt, generateDocsPrompt } from './prompts.js';
+/** AI code generation service */
+export class AICodeGenerator {
+    provider;
+    constructor(config) {
+        this.provider = config ? createAIProvider(config) : new MockAIProvider();
+    }
+    /**
+     * Generate code from a request.
+     */
+    async generateCode(request) {
+        return this.provider.generate(request);
+    }
+    /**
+     * Review code and return findings.
+     */
+    async reviewCode(options) {
+        const start = Date.now();
+        const prompt = reviewCodePrompt(options);
+        const response = await this.provider.complete(prompt);
+        // For mock provider, return sample findings
+        const findings = this.parseFindingsOrDefault(response, options.code);
+        const score = this.calculateScore(findings);
+        return {
+            findings,
+            summary: `Found ${findings.length} issues (score: ${score}/100)`,
+            score,
+            durationMs: Date.now() - start,
+        };
+    }
+    /**
+     * Suggest refactorings for code.
+     */
+    async suggestRefactoring(options) {
+        const prompt = refactorCodePrompt(options);
+        const response = await this.provider.complete(prompt);
+        return this.parseSuggestionsOrDefault(response, options.code);
+    }
+    /**
+     * Generate documentation for code.
+     */
+    async generateDocs(options) {
+        const prompt = generateDocsPrompt(options);
+        return this.provider.complete(prompt);
+    }
+    /**
+     * Parse findings from AI response, or return heuristic defaults.
+     */
+    parseFindingsOrDefault(response, code) {
+        try {
+            const parsed = JSON.parse(response);
+            if (Array.isArray(parsed))
+                return parsed;
+        }
+        catch {
+            // If response isn't valid JSON, generate heuristic findings
+        }
+        return this.generateHeuristicFindings(code);
+    }
+    /**
+     * Generate basic heuristic findings from code patterns.
+     */
+    generateHeuristicFindings(code) {
+        const findings = [];
+        // Check for console.log
+        const consoleMatches = code.match(/console\.(log|warn|error)/g);
+        if (consoleMatches) {
+            findings.push({
+                severity: 'info',
+                message: `Found ${consoleMatches.length} console statement(s). Consider using a structured logger.`,
+                category: 'style',
+            });
+        }
+        // Check for any type
+        if (code.includes(': any') || code.includes('<any>')) {
+            findings.push({
+                severity: 'warning',
+                message: 'Usage of "any" type detected. Consider using more specific types.',
+                category: 'correctness',
+            });
+        }
+        // Check for TODO comments
+        const todoMatches = code.match(/\/\/\s*TODO/gi);
+        if (todoMatches) {
+            findings.push({
+                severity: 'info',
+                message: `Found ${todoMatches.length} TODO comment(s).`,
+                category: 'maintainability',
+            });
+        }
+        // Check for long lines
+        const longLines = code.split('\n').filter((l) => l.length > 120);
+        if (longLines.length > 0) {
+            findings.push({
+                severity: 'info',
+                message: `${longLines.length} line(s) exceed 120 characters.`,
+                category: 'style',
+            });
+        }
+        return findings;
+    }
+    /**
+     * Parse refactoring suggestions from AI response, or return defaults.
+     */
+    parseSuggestionsOrDefault(response, code) {
+        try {
+            const parsed = JSON.parse(response);
+            if (Array.isArray(parsed))
+                return parsed;
+        }
+        catch {
+            // Return default suggestions
+        }
+        const suggestions = [];
+        // Check for long functions
+        const fnMatches = code.match(/function\s+\w+/g);
+        if (fnMatches && fnMatches.length > 5) {
+            suggestions.push({
+                description: 'Consider extracting related functions into separate modules',
+                original: `${fnMatches.length} functions in single file`,
+                refactored: 'Split into focused modules',
+                rationale: 'Smaller modules are easier to test and maintain',
+                impact: 'medium',
+            });
+        }
+        return suggestions;
+    }
+    /**
+     * Calculate a quality score from findings.
+     */
+    calculateScore(findings) {
+        let score = 100;
+        for (const finding of findings) {
+            switch (finding.severity) {
+                case 'error':
+                    score -= 15;
+                    break;
+                case 'warning':
+                    score -= 5;
+                    break;
+                case 'info':
+                    score -= 1;
+                    break;
+                case 'suggestion':
+                    score -= 0;
+                    break;
+            }
+        }
+        return Math.max(0, Math.min(100, score));
+    }
+}
+/**
+ * Create an AI code generator with configuration.
+ */
+export function createAICodeGenerator(config) {
+    return new AICodeGenerator(config);
+}
+//# sourceMappingURL=code-gen.js.map

package/dist/ai/code-gen.js.map

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

package/dist/ai/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @dcyfr/ai-code-gen - AI module exports
+ */
+export { AICodeGenerator, createAICodeGenerator } from './code-gen.js';
+export { MockAIProvider, createAIProvider } from './provider.js';
+export type { AIProvider } from './provider.js';
+export { generateCodePrompt, reviewCodePrompt, refactorCodePrompt, generateDocsPrompt, } from './prompts.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC"}

package/dist/ai/index.js

@@ -0,0 +1,7 @@
+/**
+ * @dcyfr/ai-code-gen - AI module exports
+ */
+export { AICodeGenerator, createAICodeGenerator } from './code-gen.js';
+export { MockAIProvider, createAIProvider } from './provider.js';
+export { generateCodePrompt, reviewCodePrompt, refactorCodePrompt, generateDocsPrompt, } from './prompts.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC"}

package/dist/ai/prompts.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @dcyfr/ai-code-gen - AI Prompt Templates
+ *
+ * Structured prompts for LLM-powered code generation, review, and refactoring.
+ */
+/** Prompt template for code generation */
+export declare function generateCodePrompt(options: {
+    description: string;
+    language: string;
+    framework?: string;
+    constraints?: string[];
+    context?: string;
+}): string;
+/** Prompt template for code review */
+export declare function reviewCodePrompt(options: {
+    code: string;
+    language: string;
+    focus?: string[];
+}): string;
+/** Prompt template for refactoring suggestions */
+export declare function refactorCodePrompt(options: {
+    code: string;
+    language: string;
+    goals?: string[];
+}): string;
+/** Prompt template for documentation generation */
+export declare function generateDocsPrompt(options: {
+    code: string;
+    language: string;
+    style?: 'jsdoc' | 'tsdoc' | 'markdown';
+}): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/ai/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/ai/prompts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,0CAA0C;AAC1C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAoCT;AAED,sCAAsC;AACtC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,GAAG,MAAM,CAoCT;AAED,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,GAAG,MAAM,CAsCT;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;CACxC,GAAG,MAAM,CAmBT"}

package/dist/ai/prompts.js

@@ -0,0 +1,96 @@
+/**
+ * @dcyfr/ai-code-gen - AI Prompt Templates
+ *
+ * Structured prompts for LLM-powered code generation, review, and refactoring.
+ */
+/** Prompt template for code generation */
+export function generateCodePrompt(options) {
+    const parts = [
+        `Generate ${options.language} code for the following:`,
+        '',
+        `Description: ${options.description}`,
+        '',
+        `Language: ${options.language}`,
+    ];
+    if (options.framework) {
+        parts.push(`Framework: ${options.framework}`);
+    }
+    if (options.constraints && options.constraints.length > 0) {
+        parts.push('', 'Constraints:');
+        for (const constraint of options.constraints) {
+            parts.push(`- ${constraint}`);
+        }
+    }
+    if (options.context) {
+        parts.push('', 'Existing code context:', '```', options.context, '```');
+    }
+    parts.push('', 'Requirements:', '- Write clean, well-documented code', '- Include proper TypeScript types', '- Follow best practices for the specified language/framework', '- Include error handling where appropriate', '', 'Return ONLY the code, no explanations.');
+    return parts.join('\n');
+}
+/** Prompt template for code review */
+export function reviewCodePrompt(options) {
+    const parts = [
+        `Review the following ${options.language} code:`,
+        '',
+        '```',
+        options.code,
+        '```',
+        '',
+        'Analyze for:',
+        '1. Security vulnerabilities',
+        '2. Performance issues',
+        '3. Code style and readability',
+        '4. Correctness and edge cases',
+        '5. Maintainability',
+    ];
+    if (options.focus && options.focus.length > 0) {
+        parts.push('', 'Focus areas:');
+        for (const area of options.focus) {
+            parts.push(`- ${area}`);
+        }
+    }
+    parts.push('', 'For each finding, provide:', '- Severity: error | warning | info | suggestion', '- Category: security | performance | style | correctness | maintainability', '- Message: description of the issue', '- Line: approximate line number', '- Suggested fix: how to resolve the issue', '', 'Return findings as a JSON array.');
+    return parts.join('\n');
+}
+/** Prompt template for refactoring suggestions */
+export function refactorCodePrompt(options) {
+    const parts = [
+        `Suggest refactoring for the following ${options.language} code:`,
+        '',
+        '```',
+        options.code,
+        '```',
+    ];
+    if (options.goals && options.goals.length > 0) {
+        parts.push('', 'Refactoring goals:');
+        for (const goal of options.goals) {
+            parts.push(`- ${goal}`);
+        }
+    }
+    else {
+        parts.push('', 'Goals:', '- Reduce complexity', '- Improve readability', '- Extract reusable patterns', '- Apply SOLID principles');
+    }
+    parts.push('', 'For each suggestion, provide:', '- Description: what to refactor', '- Original: the original code snippet', '- Refactored: the improved code', '- Rationale: why this improves the code', '- Impact: low | medium | high', '', 'Return suggestions as a JSON array.');
+    return parts.join('\n');
+}
+/** Prompt template for documentation generation */
+export function generateDocsPrompt(options) {
+    const style = options.style ?? 'jsdoc';
+    return [
+        `Generate ${style} documentation for the following ${options.language} code:`,
+        '',
+        '```',
+        options.code,
+        '```',
+        '',
+        'Requirements:',
+        `- Use ${style} format`,
+        '- Document all exported functions, classes, and interfaces',
+        '- Include @param, @returns, and @example tags',
+        '- Be concise but thorough',
+        '- Include edge cases in @example sections',
+        '',
+        'Return the documented code.',
+    ].join('\n');
+}
+//# sourceMappingURL=prompts.js.map

package/dist/ai/prompts.js.map

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

package/dist/ai/provider.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @dcyfr/ai-code-gen - AI Provider Interface
+ *
+ * Abstraction layer for LLM providers with a mock provider for testing.
+ */
+import type { AIProviderConfig, AICodeRequest, AICodeResponse } from '../types/index.js';
+import { generateCodePrompt } from './prompts.js';
+/** AI provider interface */
+export interface AIProvider {
+    /** Provider name */
+    readonly name: string;
+    /** Generate code from a request */
+    generate(request: AICodeRequest): Promise<AICodeResponse>;
+    /** Generate a raw completion from a prompt */
+    complete(prompt: string): Promise<string>;
+}
+/**
+ * Mock AI provider for testing and offline development.
+ * Generates deterministic placeholder code based on the request.
+ */
+export declare class MockAIProvider implements AIProvider {
+    readonly name = "mock";
+    generate(request: AICodeRequest): Promise<AICodeResponse>;
+    complete(prompt: string): Promise<string>;
+    private generateMockCode;
+    private generateTypeScriptMock;
+}
+/**
+ * Create an AI provider from configuration.
+ * Currently supports 'mock' provider; real providers can be added later.
+ */
+export declare function createAIProvider(config: AIProviderConfig): AIProvider;
+export { generateCodePrompt };
+//# sourceMappingURL=provider.d.ts.map

package/dist/ai/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/ai/provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,4BAA4B;AAC5B,MAAM,WAAW,UAAU;IACzB,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1D,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,QAAQ,CAAC,IAAI,UAAU;IAEjB,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAgBzD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/C,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,sBAAsB;CA6B/B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CAerE;AAGD,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/ai/provider.js

@@ -0,0 +1,76 @@
+/**
+ * @dcyfr/ai-code-gen - AI Provider Interface
+ *
+ * Abstraction layer for LLM providers with a mock provider for testing.
+ */
+import { generateCodePrompt } from './prompts.js';
+/**
+ * Mock AI provider for testing and offline development.
+ * Generates deterministic placeholder code based on the request.
+ */
+export class MockAIProvider {
+    name = 'mock';
+    async generate(request) {
+        const code = this.generateMockCode(request);
+        return {
+            code,
+            explanation: `Mock-generated ${request.language} code for: ${request.prompt}`,
+            language: request.language,
+            confidence: 0.85,
+            usage: {
+                promptTokens: request.prompt.length,
+                completionTokens: code.length,
+                totalTokens: request.prompt.length + code.length,
+            },
+        };
+    }
+    async complete(prompt) {
+        return `// Mock completion for prompt (${prompt.length} chars)\n// TODO: Replace with real AI provider\n`;
+    }
+    generateMockCode(request) {
+        const lang = request.language.toLowerCase();
+        if (lang === 'typescript' || lang === 'ts') {
+            return this.generateTypeScriptMock(request);
+        }
+        return `// ${request.language} code for: ${request.prompt}\n// Generated by mock provider\n`;
+    }
+    generateTypeScriptMock(request) {
+        const lines = [
+            `/**`,
+            ` * ${request.prompt}`,
+            ` * `,
+            ` * @generated by @dcyfr/ai-code-gen (mock)`,
+            ` */`,
+            ``,
+        ];
+        if (request.framework) {
+            lines.push(`// Framework: ${request.framework}`);
+        }
+        if (request.constraints && request.constraints.length > 0) {
+            lines.push(`// Constraints: ${request.constraints.join(', ')}`);
+        }
+        lines.push(``, `export function generatedFunction(): void {`, `  // TODO: Implement ${request.prompt}`, `  console.log('Generated code placeholder');`, `}`, ``);
+        return lines.join('\n');
+    }
+}
+/**
+ * Create an AI provider from configuration.
+ * Currently supports 'mock' provider; real providers can be added later.
+ */
+export function createAIProvider(config) {
+    switch (config.provider) {
+        case 'mock':
+            return new MockAIProvider();
+        case 'openai':
+        case 'anthropic':
+        case 'local':
+            // Return mock with a warning for unsupported providers
+            console.warn(`AI provider '${config.provider}' is not yet implemented. Using mock provider.`);
+            return new MockAIProvider();
+        default:
+            throw new Error(`Unknown AI provider: ${config.provider}`);
+    }
+}
+// Re-export for convenience
+export { generateCodePrompt };
+//# sourceMappingURL=provider.js.map

package/dist/ai/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/ai/provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAYlD;;;GAGG;AACH,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,MAAM,CAAC;IAEvB,KAAK,CAAC,QAAQ,CAAC,OAAsB;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAE5C,OAAO;YACL,IAAI;YACJ,WAAW,EAAE,kBAAkB,OAAO,CAAC,QAAQ,cAAc,OAAO,CAAC,MAAM,EAAE;YAC7E,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,IAAI;YAChB,KAAK,EAAE;gBACL,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;gBACnC,gBAAgB,EAAE,IAAI,CAAC,MAAM;gBAC7B,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM;aACjD;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,OAAO,kCAAkC,MAAM,CAAC,MAAM,mDAAmD,CAAC;IAC5G,CAAC;IAEO,gBAAgB,CAAC,OAAsB;QAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAE5C,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC9C,CAAC;QAED,OAAO,MAAM,OAAO,CAAC,QAAQ,cAAc,OAAO,CAAC,MAAM,mCAAmC,CAAC;IAC/F,CAAC;IAEO,sBAAsB,CAAC,OAAsB;QACnD,MAAM,KAAK,GAAG;YACZ,KAAK;YACL,MAAM,OAAO,CAAC,MAAM,EAAE;YACtB,KAAK;YACL,4CAA4C;YAC5C,KAAK;YACL,EAAE;SACH,CAAC;QAEF,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1D,KAAK,CAAC,IAAI,CAAC,mBAAmB,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,KAAK,CAAC,IAAI,CACR,EAAE,EACF,6CAA6C,EAC7C,wBAAwB,OAAO,CAAC,MAAM,EAAE,EACxC,8CAA8C,EAC9C,GAAG,EACH,EAAE,CACH,CAAC;QAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,MAAM;YACT,OAAO,IAAI,cAAc,EAAE,CAAC;QAC9B,KAAK,QAAQ,CAAC;QACd,KAAK,WAAW,CAAC;QACjB,KAAK,OAAO;YACV,uDAAuD;YACvD,OAAO,CAAC,IAAI,CACV,gBAAgB,MAAM,CAAC,QAAQ,gDAAgD,CAChF,CAAC;YACF,OAAO,IAAI,cAAc,EAAE,CAAC;QAC9B;YACE,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,4BAA4B;AAC5B,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/ast/analyzer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @dcyfr/ai-code-gen - Code Analyzer
+ *
+ * Static analysis utilities for TypeScript source code.
+ */
+import type { CodeMetrics } from '../types/index.js';
+/** Analysis issue */
+export interface AnalysisIssue {
+    type: 'dead-code' | 'complexity' | 'naming' | 'missing-jsdoc' | 'large-file';
+    severity: 'info' | 'warning' | 'error';
+    message: string;
+    node?: string;
+    line?: number;
+}
+/** Full analysis report */
+export interface AnalysisReport {
+    filePath: string;
+    issues: AnalysisIssue[];
+    metrics: CodeMetrics;
+    summary: string;
+}
+/**
+ * Analyze source code and produce a report with issues and metrics.
+ */
+export declare function analyzeCode(source: string, filePath?: string): AnalysisReport;
+/**
+ * Compare two source files and identify structural differences.
+ */
+export declare function compareStructure(sourceA: string, sourceB: string): {
+    added: string[];
+    removed: string[];
+    modified: string[];
+};
+//# sourceMappingURL=analyzer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../src/ast/analyzer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAA2B,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAG9E,qBAAqB;AACrB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,eAAe,GAAG,YAAY,CAAC;IAC7E,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAc,GAAG,cAAc,CAUlF;AAsID;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd;IACD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAsBA"}

package/dist/ast/analyzer.js

@@ -0,0 +1,159 @@
+/**
+ * @dcyfr/ai-code-gen - Code Analyzer
+ *
+ * Static analysis utilities for TypeScript source code.
+ */
+import { parseSource } from './parser.js';
+/**
+ * Analyze source code and produce a report with issues and metrics.
+ */
+export function analyzeCode(source, filePath = 'source.ts') {
+    const result = parseSource(source, filePath);
+    const issues = detectIssues(result);
+    return {
+        filePath,
+        issues,
+        metrics: result.metrics,
+        summary: generateSummary(result, issues),
+    };
+}
+/**
+ * Detect code issues from an analysis result.
+ */
+function detectIssues(result) {
+    const issues = [];
+    // Check for large files
+    if (result.metrics.linesOfCode > 500) {
+        issues.push({
+            type: 'large-file',
+            severity: 'warning',
+            message: `File has ${result.metrics.linesOfCode} lines. Consider splitting into smaller modules.`,
+        });
+    }
+    // Check cyclomatic complexity
+    if (result.metrics.cyclomaticComplexity > 20) {
+        issues.push({
+            type: 'complexity',
+            severity: 'warning',
+            message: `High cyclomatic complexity: ${result.metrics.cyclomaticComplexity}. Consider refactoring.`,
+        });
+    }
+    // Check for missing JSDoc on exported items
+    for (const node of result.nodes) {
+        checkNodeIssues(node, issues);
+    }
+    // Check for unused imports (heuristic: if named import not found in exports/nodes)
+    for (const imp of result.imports) {
+        if (imp.isTypeOnly)
+            continue; // Type imports are fine
+        for (const named of imp.namedImports) {
+            const isUsed = result.nodes.some((n) => n.name === named ||
+                JSON.stringify(n.metadata).includes(named) ||
+                n.children.some((c) => c.name === named));
+            if (!isUsed) {
+                issues.push({
+                    type: 'dead-code',
+                    severity: 'info',
+                    message: `Import '${named}' from '${imp.moduleSpecifier}' may be unused`,
+                    node: named,
+                });
+            }
+        }
+    }
+    return issues;
+}
+/**
+ * Check a single AST node for issues.
+ */
+function checkNodeIssues(node, issues) {
+    // Missing JSDoc on exported declarations
+    if (node.isExported && !node.jsdoc) {
+        if (node.kind === 'function' || node.kind === 'class' || node.kind === 'interface') {
+            issues.push({
+                type: 'missing-jsdoc',
+                severity: 'info',
+                message: `Exported ${node.kind} '${node.name}' is missing JSDoc documentation`,
+                node: node.name,
+                line: node.startLine,
+            });
+        }
+    }
+    // Check naming conventions
+    if (node.kind === 'class' || node.kind === 'interface') {
+        if (!/^[A-Z]/.test(node.name) && node.name !== '<anonymous>') {
+            issues.push({
+                type: 'naming',
+                severity: 'warning',
+                message: `${node.kind} '${node.name}' should start with an uppercase letter`,
+                node: node.name,
+                line: node.startLine,
+            });
+        }
+    }
+    if (node.kind === 'function' || node.kind === 'variable') {
+        if (/^[A-Z]/.test(node.name) && node.name !== '<anonymous>') {
+            // Exception: React components (functions starting with uppercase are valid)
+            // Only flag if it doesn't look like a React component or constant
+            const isConstant = /^[A-Z_]+$/.test(node.name);
+            if (!isConstant && node.kind === 'variable') {
+                // Variable starting with uppercase could be a React component or constant - skip
+            }
+            else if (node.kind === 'function') {
+                // Functions starting with uppercase could be React components - skip
+            }
+        }
+    }
+    // Check children recursively
+    for (const child of node.children) {
+        checkNodeIssues(child, issues);
+    }
+}
+/**
+ * Generate a human-readable summary of the analysis.
+ */
+function generateSummary(result, issues) {
+    const m = result.metrics;
+    const errorCount = issues.filter((i) => i.severity === 'error').length;
+    const warningCount = issues.filter((i) => i.severity === 'warning').length;
+    const infoCount = issues.filter((i) => i.severity === 'info').length;
+    const parts = [
+        `${m.linesOfCode} LOC`,
+        `${m.functionCount} functions`,
+        `${m.classCount} classes`,
+        `${m.importCount} imports`,
+        `${m.exportCount} exports`,
+        `complexity: ${m.cyclomaticComplexity}`,
+    ];
+    const issueStr = [
+        errorCount > 0 ? `${errorCount} errors` : null,
+        warningCount > 0 ? `${warningCount} warnings` : null,
+        infoCount > 0 ? `${infoCount} info` : null,
+    ]
+        .filter(Boolean)
+        .join(', ');
+    return `${parts.join(', ')}${issueStr ? ` | Issues: ${issueStr}` : ' | No issues'}`;
+}
+/**
+ * Compare two source files and identify structural differences.
+ */
+export function compareStructure(sourceA, sourceB) {
+    const resultA = parseSource(sourceA, 'a.ts');
+    const resultB = parseSource(sourceB, 'b.ts');
+    const namesA = new Set(resultA.nodes.map((n) => `${n.kind}:${n.name}`));
+    const namesB = new Set(resultB.nodes.map((n) => `${n.kind}:${n.name}`));
+    const added = [...namesB].filter((n) => !namesA.has(n));
+    const removed = [...namesA].filter((n) => !namesB.has(n));
+    // Nodes present in both but with different line counts (rough heuristic)
+    const common = [...namesA].filter((n) => namesB.has(n));
+    const modified = common.filter((key) => {
+        const nodeA = resultA.nodes.find((n) => `${n.kind}:${n.name}` === key);
+        const nodeB = resultB.nodes.find((n) => `${n.kind}:${n.name}` === key);
+        if (!nodeA || !nodeB)
+            return false;
+        const sizeA = nodeA.endLine - nodeA.startLine;
+        const sizeB = nodeB.endLine - nodeB.startLine;
+        return Math.abs(sizeA - sizeB) > 2;
+    });
+    return { added, removed, modified };
+}
+//# sourceMappingURL=analyzer.js.map