agent-ide 0.7.5 → 0.8.0

package/dist/plugins/javascript/code-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-analyzer.d.ts","sourceRoot":"","sources":["../../../src/plugins/javascript/code-analyzer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,eAAe,EACf,UAAU,EACX,MAAM,+CAA+C,CAAC;AAEvD;;;GAGG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACG,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAMlF;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAY7E;;OAEG;IACG,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAsBnF;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAKvE;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAK3E;;OAEG;IACG,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA8B/E;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA4CrE;;;;;OAKG;IACG,sBAAsB,CAC1B,OAAO,EAAE,MAAM,EAAE,EACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,OAAO,UAAU,GAC5B,OAAO,CAAC,WAAW,EAAE,CAAC;IAyBzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA0C/B;;OAEG;IACH,OAAO,CAAC,cAAc;IAiCtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgC5B;;OAEG;IACH,OAAO,CAAC,YAAY;CASrB"}

package/dist/plugins/javascript/code-analyzer.js

@@ -0,0 +1,302 @@
+/**
+ * JavaScript 程式碼分析器
+ * 負責程式碼品質分析、安全性檢查、命名規範檢測等功能
+ */
+import { createHash } from 'crypto';
+/**
+ * JavaScript 程式碼分析器
+ * 提供程式碼品質、安全性、命名規範等分析功能
+ */
+export class CodeAnalyzer {
+    /**
+     * 檢測未使用的符號（JavaScript 基本實作）
+     */
+    async detectUnusedSymbols(_ast, _allSymbols) {
+        // JavaScript 版本暫時返回空結果
+        // 未來可以實作類似 TypeScript 的檢測邏輯
+        return [];
+    }
+    /**
+     * 分析程式碼複雜度
+     */
+    async analyzeComplexity(_code, _ast) {
+        // JavaScript 版本暫時返回簡單結果
+        return {
+            cyclomaticComplexity: 1,
+            cognitiveComplexity: 0,
+            evaluation: 'simple',
+            functionCount: 0,
+            averageComplexity: 0,
+            maxComplexity: 0
+        };
+    }
+    /**
+     * 提取程式碼片段（用於重複代碼檢測）
+     */
+    async extractCodeFragments(code, filePath) {
+        const fragments = [];
+        // 1. 提取頂層註解
+        const commentFragments = this.extractTopLevelComments(code, filePath);
+        fragments.push(...commentFragments);
+        // 2. 提取方法
+        const methodFragments = this.extractMethods(code, filePath);
+        fragments.push(...methodFragments);
+        // 3. 提取常數定義
+        const constantFragments = this.extractConstants(code, filePath);
+        fragments.push(...constantFragments);
+        // 4. 提取配置物件
+        const configFragments = this.extractConfigObjects(code, filePath);
+        fragments.push(...configFragments);
+        return fragments;
+    }
+    /**
+     * 檢測樣板模式
+     */
+    async detectPatterns(_code, _ast) {
+        // JavaScript 可以檢測相同的模式
+        return [];
+    }
+    /**
+     * 檢查型別安全問題（JavaScript 無型別系統）
+     */
+    async checkTypeSafety(_code, _ast) {
+        // JavaScript 沒有型別系統
+        return [];
+    }
+    /**
+     * 檢查錯誤處理問題
+     */
+    async checkErrorHandling(code, ast) {
+        const issues = [];
+        const lines = code.split('\n');
+        // 檢測空 catch 區塊
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (/catch\s*\([^)]*\)\s*\{\s*\}/.test(line)) {
+                issues.push({
+                    type: 'empty-catch',
+                    location: { filePath: ast.sourceFile, line: i + 1, column: 0 },
+                    message: '空的 catch 區塊，應該處理錯誤或記錄日誌',
+                    severity: 'warning'
+                });
+            }
+            // 檢測靜默吞錯
+            if (/catch\s*\([^)]*\)\s*\{[^}]*\/\/\s*(ignore|skip|TODO)[^}]*\}/.test(line)) {
+                issues.push({
+                    type: 'silent-error',
+                    location: { filePath: ast.sourceFile, line: i + 1, column: 0 },
+                    message: 'catch 區塊靜默吞錯，只有註解沒有實際處理',
+                    severity: 'warning'
+                });
+            }
+        }
+        return issues;
+    }
+    /**
+     * 檢查安全性問題
+     */
+    async checkSecurity(code, ast) {
+        const issues = [];
+        const lines = code.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // 檢測硬編碼密碼
+            if (/(password|passwd|pwd|secret|apiKey|token)\s*[:=]\s*['"][^'"]{3,}['"]/.test(line)
+                && !/(process\.env|config\.|import|require)/.test(line)) {
+                issues.push({
+                    type: 'hardcoded-secret',
+                    location: { filePath: ast.sourceFile, line: i + 1, column: 0 },
+                    message: '硬編碼的密碼或密鑰，應使用環境變數',
+                    severity: 'critical'
+                });
+            }
+            // 檢測 eval 使用
+            if (/\beval\s*\(/.test(line)) {
+                issues.push({
+                    type: 'unsafe-eval',
+                    location: { filePath: ast.sourceFile, line: i + 1, column: 0 },
+                    message: '使用 eval 可能導致代碼注入風險',
+                    severity: 'high'
+                });
+            }
+            // 檢測 innerHTML
+            if (/\.innerHTML\s*=/.test(line) && !/(DOMPurify|sanitize)/.test(line)) {
+                issues.push({
+                    type: 'xss-vulnerability',
+                    location: { filePath: ast.sourceFile, line: i + 1, column: 0 },
+                    message: '直接設定 innerHTML 可能導致 XSS 攻擊',
+                    severity: 'medium'
+                });
+            }
+        }
+        return issues;
+    }
+    /**
+     * 檢查命名規範問題
+     * @param symbols 符號列表
+     * @param filePath 檔案路徑
+     * @param symbolType SymbolType enum 用於比對
+     */
+    async checkNamingConventions(symbols, filePath, symbolType) {
+        const issues = [];
+        for (const symbol of symbols) {
+            // 檢測底線開頭變數
+            if (symbol.name.startsWith('_') && symbol.type === symbolType.Variable) {
+                issues.push({
+                    type: 'invalid-naming',
+                    symbolName: symbol.name,
+                    symbolType: symbol.type,
+                    location: {
+                        filePath,
+                        line: symbol.location.range.start.line,
+                        column: symbol.location.range.start.column
+                    },
+                    message: `變數 "${symbol.name}" 以底線開頭，違反命名規範`
+                });
+            }
+        }
+        return issues;
+    }
+    // ===== 私有方法 =====
+    /**
+     * 提取頂層註解
+     */
+    extractTopLevelComments(code, filePath) {
+        const fragments = [];
+        const lines = code.split('\n');
+        let commentStart = -1;
+        let inBlockComment = false;
+        for (let i = 0; i < Math.min(50, lines.length); i++) {
+            const line = lines[i].trim();
+            if ((line.startsWith('/**') || line.startsWith('/*')) && commentStart === -1) {
+                commentStart = i;
+                inBlockComment = true;
+            }
+            if (inBlockComment && line.includes('*/')) {
+                const commentEnd = i;
+                const commentCode = lines.slice(commentStart, commentEnd + 1).join('\n');
+                const lineCount = commentEnd - commentStart + 1;
+                if (lineCount >= 3) {
+                    fragments.push({
+                        type: 'comment',
+                        code: commentCode,
+                        tokens: this.tokenizeCode(commentCode, true),
+                        location: { filePath, startLine: commentStart + 1, endLine: commentEnd + 1 },
+                        hash: createHash('md5').update(commentCode).digest('hex')
+                    });
+                }
+                commentStart = -1;
+                inBlockComment = false;
+            }
+            if (!inBlockComment && line && !line.startsWith('//') && !line.startsWith('*')) {
+                break;
+            }
+        }
+        return fragments;
+    }
+    /**
+     * 提取方法
+     */
+    extractMethods(code, filePath) {
+        const fragments = [];
+        const lines = code.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // 匹配方法定義（支援 ES6+）
+            if (/(async\s+)?(function\s+\w+|const\s+\w+\s*=\s*(async\s+)?\([^)]*\)\s*=>|\w+\s*\([^)]*\)\s*{)/.test(line)) {
+                let braceCount = (line.match(/{/g) || []).length - (line.match(/}/g) || []).length;
+                let endLine = i;
+                for (let j = i + 1; j < lines.length && braceCount > 0; j++) {
+                    braceCount += (lines[j].match(/{/g) || []).length;
+                    braceCount -= (lines[j].match(/}/g) || []).length;
+                    endLine = j;
+                }
+                if (endLine > i && (endLine - i + 1) >= 3) {
+                    const methodCode = lines.slice(i, endLine + 1).join('\n');
+                    fragments.push({
+                        type: 'method',
+                        code: methodCode,
+                        tokens: this.tokenizeCode(methodCode, false),
+                        location: { filePath, startLine: i + 1, endLine: endLine + 1 },
+                        hash: createHash('md5').update(methodCode).digest('hex')
+                    });
+                }
+            }
+        }
+        return fragments;
+    }
+    /**
+     * 提取常數定義
+     */
+    extractConstants(code, filePath) {
+        const fragments = [];
+        const lines = code.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // 匹配 const/export const XXX = { ... }
+            if (/(export\s+)?const\s+\w+\s*=\s*{/.test(line)) {
+                let braceCount = 1;
+                let endLine = i;
+                for (let j = i + 1; j < lines.length && braceCount > 0; j++) {
+                    braceCount += (lines[j].match(/{/g) || []).length;
+                    braceCount -= (lines[j].match(/}/g) || []).length;
+                    endLine = j;
+                }
+                if (endLine > i && (endLine - i + 1) >= 3) {
+                    const constantCode = lines.slice(i, endLine + 1).join('\n');
+                    fragments.push({
+                        type: 'constant',
+                        code: constantCode,
+                        tokens: this.tokenizeCode(constantCode, false),
+                        location: { filePath, startLine: i + 1, endLine: endLine + 1 },
+                        hash: createHash('md5').update(constantCode).digest('hex')
+                    });
+                }
+            }
+        }
+        return fragments;
+    }
+    /**
+     * 提取配置物件
+     */
+    extractConfigObjects(code, filePath) {
+        const fragments = [];
+        const lines = code.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (/config|Config|options|Options/.test(line) && /{/.test(line)) {
+                let braceCount = (line.match(/{/g) || []).length - (line.match(/}/g) || []).length;
+                let endLine = i;
+                for (let j = i + 1; j < lines.length && braceCount > 0; j++) {
+                    braceCount += (lines[j].match(/{/g) || []).length;
+                    braceCount -= (lines[j].match(/}/g) || []).length;
+                    endLine = j;
+                }
+                if (endLine > i && (endLine - i + 1) >= 3) {
+                    const configCode = lines.slice(i, endLine + 1).join('\n');
+                    fragments.push({
+                        type: 'config',
+                        code: configCode,
+                        tokens: this.tokenizeCode(configCode, false),
+                        location: { filePath, startLine: i + 1, endLine: endLine + 1 },
+                        hash: createHash('md5').update(configCode).digest('hex')
+                    });
+                }
+            }
+        }
+        return fragments;
+    }
+    /**
+     * 將程式碼 tokenize
+     */
+    tokenizeCode(code, includeComments) {
+        if (includeComments) {
+            return code.split(/\s+/).filter(t => t.length > 0);
+        }
+        const withoutComments = code
+            .replace(/\/\*[\s\S]*?\*\//g, '')
+            .replace(/\/\/.*/g, '');
+        return withoutComments.split(/\s+/).filter(t => t.length > 0);
+    }
+}
+//# sourceMappingURL=code-analyzer.js.map

package/dist/plugins/javascript/code-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-analyzer.js","sourceRoot":"","sources":["../../../src/plugins/javascript/code-analyzer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAapC;;;GAGG;AACH,MAAM,OAAO,YAAY;IACvB;;OAEG;IACH,KAAK,CAAC,mBAAmB,CAAC,IAAS,EAAE,WAAqB;QACxD,uBAAuB;QACvB,4BAA4B;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,KAAa,EAAE,IAAS;QAC9C,wBAAwB;QACxB,OAAO;YACL,oBAAoB,EAAE,CAAC;YACvB,mBAAmB,EAAE,CAAC;YACtB,UAAU,EAAE,QAAQ;YACpB,aAAa,EAAE,CAAC;YAChB,iBAAiB,EAAE,CAAC;YACpB,aAAa,EAAE,CAAC;SACjB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CAAC,IAAY,EAAE,QAAgB;QACvD,MAAM,SAAS,GAAmB,EAAE,CAAC;QAErC,YAAY;QACZ,MAAM,gBAAgB,GAAG,IAAI,CAAC,uBAAuB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACtE,SAAS,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAC;QAEpC,UAAU;QACV,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC5D,SAAS,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;QAEnC,YAAY;QACZ,MAAM,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAChE,SAAS,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC,CAAC;QAErC,YAAY;QACZ,MAAM,eAAe,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAClE,SAAS,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;QAEnC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,KAAa,EAAE,IAAS;QAC3C,uBAAuB;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,KAAa,EAAE,IAAS;QAC5C,oBAAoB;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,IAAY,EAAE,GAAQ;QAC7C,MAAM,MAAM,GAAyB,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE/B,eAAe;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7C,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,aAAa;oBACnB,QAAQ,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;oBAC9D,OAAO,EAAE,yBAAyB;oBAClC,QAAQ,EAAE,SAAS;iBACpB,CAAC,CAAC;YACL,CAAC;YAED,SAAS;YACT,IAAI,6DAA6D,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7E,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,cAAc;oBACpB,QAAQ,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;oBAC9D,OAAO,EAAE,yBAAyB;oBAClC,QAAQ,EAAE,SAAS;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,GAAQ;QACxC,MAAM,MAAM,GAAoB,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAEtB,UAAU;YACV,IACE,sEAAsE,CAAC,IAAI,CAAC,IAAI,CAAC;mBAC9E,CAAC,wCAAwC,CAAC,IAAI,CAAC,IAAI,CAAC,EACvD,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,kBAAkB;oBACxB,QAAQ,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;oBAC9D,OAAO,EAAE,mBAAmB;oBAC5B,QAAQ,EAAE,UAAU;iBACrB,CAAC,CAAC;YACL,CAAC;YAED,aAAa;YACb,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,aAAa;oBACnB,QAAQ,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;oBAC9D,OAAO,EAAE,oBAAoB;oBAC7B,QAAQ,EAAE,MAAM;iBACjB,CAAC,CAAC;YACL,CAAC;YAED,eAAe;YACf,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvE,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,mBAAmB;oBACzB,QAAQ,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;oBAC9D,OAAO,EAAE,4BAA4B;oBACrC,QAAQ,EAAE,QAAQ;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,sBAAsB,CAC1B,OAAiB,EACjB,QAAgB,EAChB,UAA6B;QAE7B,MAAM,MAAM,GAAkB,EAAE,CAAC;QAEjC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,WAAW;YACX,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,QAAQ,EAAE,CAAC;gBACvE,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,gBAAgB;oBACtB,UAAU,EAAE,MAAM,CAAC,IAAI;oBACvB,UAAU,EAAE,MAAM,CAAC,IAAI;oBACvB,QAAQ,EAAE;wBACR,QAAQ;wBACR,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI;wBACtC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM;qBAC3C;oBACD,OAAO,EAAE,OAAO,MAAM,CAAC,IAAI,gBAAgB;iBAC5C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,mBAAmB;IAEnB;;OAEG;IACK,uBAAuB,CAAC,IAAY,EAAE,QAAgB;QAC5D,MAAM,SAAS,GAAmB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE/B,IAAI,YAAY,GAAG,CAAC,CAAC,CAAC;QACtB,IAAI,cAAc,GAAG,KAAK,CAAC;QAE3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAE7B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC7E,YAAY,GAAG,CAAC,CAAC;gBACjB,cAAc,GAAG,IAAI,CAAC;YACxB,CAAC;YAED,IAAI,cAAc,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC1C,MAAM,UAAU,GAAG,CAAC,CAAC;gBACrB,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACzE,MAAM,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,CAAC,CAAC;gBAEhD,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;oBACnB,SAAS,CAAC,IAAI,CAAC;wBACb,IAAI,EAAE,SAAS;wBACf,IAAI,EAAE,WAAW;wBACjB,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC;wBAC5C,QAAQ,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,GAAG,CAAC,EAAE,OAAO,EAAE,UAAU,GAAG,CAAC,EAAE;wBAC5E,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBAC1D,CAAC,CAAC;gBACL,CAAC;gBAED,YAAY,GAAG,CAAC,CAAC,CAAC;gBAClB,cAAc,GAAG,KAAK,CAAC;YACzB,CAAC;YAED,IAAI,CAAC,cAAc,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/E,MAAM;YACR,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,IAAY,EAAE,QAAgB;QACnD,MAAM,SAAS,GAAmB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,kBAAkB;YAClB,IAAI,6FAA6F,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7G,IAAI,UAAU,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnF,IAAI,OAAO,GAAG,CAAC,CAAC;gBAEhB,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC5D,UAAU,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;oBAClD,UAAU,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;oBAClD,OAAO,GAAG,CAAC,CAAC;gBACd,CAAC;gBAED,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC1D,SAAS,CAAC,IAAI,CAAC;wBACb,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,UAAU;wBAChB,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC;wBAC5C,QAAQ,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,EAAE;wBAC9D,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBACzD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,IAAY,EAAE,QAAgB;QACrD,MAAM,SAAS,GAAmB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,sCAAsC;YACtC,IAAI,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjD,IAAI,UAAU,GAAG,CAAC,CAAC;gBACnB,IAAI,OAAO,GAAG,CAAC,CAAC;gBAEhB,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC5D,UAAU,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;oBAClD,UAAU,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;oBAClD,OAAO,GAAG,CAAC,CAAC;gBACd,CAAC;gBAED,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1C,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC5D,SAAS,CAAC,IAAI,CAAC;wBACb,IAAI,EAAE,UAAU;wBAChB,IAAI,EAAE,YAAY;wBAClB,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC;wBAC9C,QAAQ,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,EAAE;wBAC9D,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBAC3D,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,IAAY,EAAE,QAAgB;QACzD,MAAM,SAAS,GAAmB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,+BAA+B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjE,IAAI,UAAU,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnF,IAAI,OAAO,GAAG,CAAC,CAAC;gBAEhB,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC5D,UAAU,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;oBAClD,UAAU,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;oBAClD,OAAO,GAAG,CAAC,CAAC;gBACd,CAAC;gBAED,IAAI,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC1D,SAAS,CAAC,IAAI,CAAC;wBACb,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,UAAU;wBAChB,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC;wBAC5C,QAAQ,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,EAAE;wBAC9D,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBACzD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,IAAY,EAAE,eAAwB;QACzD,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,MAAM,eAAe,GAAG,IAAI;aACzB,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;aAChC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC1B,OAAO,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/plugins/javascript/declaration-analyzer.d.ts

@@ -0,0 +1,58 @@
+/**
+ * JavaScript 宣告分析器
+ * 負責解析宣告範圍、import 宣告、函數簽章和 JSDoc 文件
+ */
+import type { ImportDeclaration, FormattedSignature, Documentation } from '../../infrastructure/parser/index.js';
+import type { Range } from '../../shared/types/index.js';
+/**
+ * JavaScript 宣告分析器
+ * 提供宣告範圍、import 解析、函數簽章和 JSDoc 文件提取功能
+ */
+export declare class DeclarationAnalyzer {
+    /**
+     * 取得符號的完整宣告範圍（包含前導註解）
+     * @param code - 原始程式碼
+     * @param symbolName - 符號名稱
+     * @param symbolType - 符號類型（function, class, variable, constant）
+     * @param startLine - 預期的起始行號
+     * @returns 宣告範圍或 null
+     */
+    getFullDeclarationRange(code: string, symbolName: string, symbolType: string, startLine: number): Range | null;
+    /**
+     * 解析程式碼中的所有 import 宣告
+     * @param code - 原始程式碼
+     * @returns import 宣告陣列或 null
+     */
+    getImportDeclarations(code: string): ImportDeclaration[] | null;
+    /**
+     * 格式化函數簽章
+     * JavaScript 沒有型別標註，型別統一為 'any'
+     * @param code - 原始程式碼
+     * @param functionName - 函數名稱
+     * @param line - 函數所在行號
+     * @returns 格式化後的簽章或 null
+     */
+    formatSignature(code: string, functionName: string, line: number): FormattedSignature | null;
+    /**
+     * 提取符號的 JSDoc 文件註解
+     * @param code - 原始程式碼
+     * @param symbolName - 符號名稱
+     * @param symbolType - 符號類型
+     * @param line - 符號所在行號
+     * @returns JSDoc 文件或 null
+     */
+    getDocumentation(code: string, symbolName: string, symbolType: string, line: number): Documentation | null;
+    /**
+     * 檢查節點行號是否匹配（允許 JSDoc 造成的偏移）
+     */
+    private isNodeLineMatch;
+    /**
+     * 解析單個 Babel import 宣告節點
+     */
+    private parseBabelImportDeclaration;
+    /**
+     * 提取 Babel 函數參數
+     */
+    private extractBabelParametersFromAny;
+}
+//# sourceMappingURL=declaration-analyzer.d.ts.map

package/dist/plugins/javascript/declaration-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration-analyzer.d.ts","sourceRoot":"","sources":["../../../src/plugins/javascript/declaration-analyzer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EACV,iBAAiB,EAEjB,kBAAkB,EAElB,aAAa,EACd,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAMpD;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B;;;;;;;OAOG;IACH,uBAAuB,CACrB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,KAAK,GAAG,IAAI;IAiFf;;;;OAIG;IACH,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,EAAE,GAAG,IAAI;IAwB/D;;;;;;;OAOG;IACH,eAAe,CACb,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,GACX,kBAAkB,GAAG,IAAI;IAqD5B;;;;;;;OAOG;IACH,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,aAAa,GAAG,IAAI;IA2EvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IA6DnC;;OAEG;IACH,OAAO,CAAC,6BAA6B;CAyDtC"}