code-auditor-mcp 2.6.2 → 3.0.0

package/dist/languages/typescript/TreeSitterTypeScriptAdapter.js

@@ -0,0 +1,951 @@
+/**
+ * Tree-sitter TypeScript/JavaScript adapter implementing the LanguageAdapter interface.
+ *
+ * Uses web-tree-sitter WASM parsers behind the adapter seam — no TypeScript compiler API.
+ * Supports .ts, .tsx, .js, and .jsx files.
+ */
+import { getParser } from '../tree-sitter/parser.js';
+import { toASTNode, toSourceLocation } from '../tree-sitter/converter.js';
+// ---------------------------------------------------------------------------
+// Source code storage
+// ---------------------------------------------------------------------------
+/**
+ * Source code indexed by AST, so methods that only receive an AST
+ * can recover the original source text.
+ */
+const sourceCodeMap = new WeakMap();
+// ---------------------------------------------------------------------------
+// Adapter implementation
+// ---------------------------------------------------------------------------
+export class TreeSitterTypeScriptAdapter {
+    name = 'typescript';
+    fileExtensions = ['.ts', '.tsx', '.js', '.jsx'];
+    // -- File detection -------------------------------------------------------
+    supportsFile(filePath) {
+        return this.fileExtensions.some((ext) => filePath.endsWith(ext));
+    }
+    // -- Parsing --------------------------------------------------------------
+    async parse(filePath, content) {
+        const isTsx = filePath.endsWith('.tsx') || filePath.endsWith('.jsx');
+        const lang = isTsx ? 'tsx' : filePath.endsWith('.go') ? 'go' : 'typescript';
+        const parser = getParser(lang, isTsx);
+        const tree = parser.parse(content);
+        if (!tree)
+            throw new Error(`Failed to parse file: ${filePath}`);
+        const errors = [];
+        // Collect ERROR nodes as parse errors
+        this.collectErrors(tree.rootNode, errors);
+        const root = toASTNode(tree.rootNode, undefined, lang);
+        const ast = {
+            root,
+            language: lang,
+            filePath,
+            errors,
+        };
+        sourceCodeMap.set(ast, content);
+        return ast;
+    }
+    // -- AST Navigation -------------------------------------------------------
+    findNodes(ast, pattern) {
+        const results = [];
+        this.walk(ast.root, (node) => {
+            if (this.matchesPattern(node, pattern)) {
+                results.push(node);
+            }
+        });
+        return results;
+    }
+    getParent(node) {
+        return node.parent ?? null;
+    }
+    getChildren(node) {
+        return node.children ?? [];
+    }
+    getSiblings(node) {
+        if (!node.parent?.children)
+            return [];
+        return node.parent.children.filter((c) => c !== node);
+    }
+    // -- Node Information -----------------------------------------------------
+    getNodeType(node) {
+        return node.type;
+    }
+    getNodeText(node, sourceCode) {
+        return sourceCode.slice(node.range[0], node.range[1]);
+    }
+    getNodeName(node) {
+        const syntaxNode = node.raw;
+        return this.extractName(syntaxNode);
+    }
+    getNodeLocation(node) {
+        return node.location;
+    }
+    // -- Language-Specific Extraction -----------------------------------------
+    extractFunctions(ast) {
+        const sourceCode = sourceCodeMap.get(ast) ?? '';
+        const functions = [];
+        this.walk(ast.root, (node) => {
+            const syntaxNode = node.raw;
+            const type = syntaxNode.type;
+            if (type === 'function_declaration' ||
+                type === 'generator_function_declaration' ||
+                type === 'function_expression' ||
+                type === 'arrow_function' ||
+                type === 'method_definition') {
+                const fn = this.buildFunctionInfo(syntaxNode, sourceCode);
+                if (fn)
+                    functions.push(fn);
+            }
+        });
+        return functions;
+    }
+    extractClasses(ast) {
+        const sourceCode = sourceCodeMap.get(ast) ?? '';
+        const classes = [];
+        this.walk(ast.root, (node) => {
+            const syntaxNode = node.raw;
+            if (syntaxNode.type === 'class_declaration') {
+                const cls = this.buildClassInfo(syntaxNode, sourceCode);
+                if (cls)
+                    classes.push(cls);
+            }
+        });
+        return classes;
+    }
+    extractImports(ast) {
+        const sourceCode = sourceCodeMap.get(ast) ?? '';
+        const imports = [];
+        this.walk(ast.root, (node) => {
+            const syntaxNode = node.raw;
+            if (syntaxNode.type === 'import_statement') {
+                const imp = this.buildImportInfo(syntaxNode, sourceCode);
+                if (imp)
+                    imports.push(imp);
+            }
+        });
+        return imports;
+    }
+    extractExports(ast) {
+        const sourceCode = sourceCodeMap.get(ast) ?? '';
+        const exports = [];
+        this.walk(ast.root, (node) => {
+            const syntaxNode = node.raw;
+            if (syntaxNode.type === 'export_statement') {
+                const ex = this.buildExportInfo(syntaxNode, sourceCode);
+                if (ex)
+                    exports.push(ex);
+            }
+        });
+        return exports;
+    }
+    // -- Pattern Matching Helpers ---------------------------------------------
+    isClass(node) {
+        const type = node.raw.type;
+        return type === 'class_declaration' || type === 'class_expression';
+    }
+    isFunction(node) {
+        const type = node.raw.type;
+        return (type === 'function_declaration' ||
+            type === 'function_expression' ||
+            type === 'arrow_function' ||
+            type === 'generator_function_declaration' ||
+            type === 'generator_function_expression');
+    }
+    isMethod(node) {
+        return node.raw.type === 'method_definition';
+    }
+    isInterface(node) {
+        return node.raw.type === 'interface_declaration';
+    }
+    isImport(node) {
+        return node.raw.type === 'import_statement';
+    }
+    isExport(node) {
+        return node.raw.type === 'export_statement';
+    }
+    isLoop(node) {
+        const type = node.raw.type;
+        return (type === 'for_statement' ||
+            type === 'for_in_statement' ||
+            type === 'while_statement' ||
+            type === 'do_statement');
+    }
+    isConditional(node) {
+        const type = node.raw.type;
+        return (type === 'if_statement' ||
+            type === 'switch_statement' ||
+            type === 'ternary_expression' ||
+            type === 'switch_case');
+    }
+    isVariableDeclaration(node) {
+        const type = node.raw.type;
+        return (type === 'variable_declaration' ||
+            type === 'lexical_declaration' ||
+            type === 'variable_declarator');
+    }
+    // -- Advanced Features ----------------------------------------------------
+    getTypeInfo(node) {
+        const syntaxNode = node.raw;
+        return this.extractTypeAnnotation(syntaxNode);
+    }
+    getDocumentation(node) {
+        const syntaxNode = node.raw;
+        return this.extractDocumentation(syntaxNode);
+    }
+    getComplexity(node) {
+        const syntaxNode = node.raw;
+        return this.calculateCyclomaticComplexity(syntaxNode);
+    }
+    // -- Optional: Interfaces -------------------------------------------------
+    extractInterfaces(ast) {
+        const sourceCode = sourceCodeMap.get(ast) ?? '';
+        const interfaces = [];
+        this.walk(ast.root, (node) => {
+            const syntaxNode = node.raw;
+            if (syntaxNode.type === 'interface_declaration') {
+                const iface = this.buildInterfaceInfo(syntaxNode, sourceCode);
+                if (iface)
+                    interfaces.push(iface);
+            }
+        });
+        return interfaces;
+    }
+    // -- Optional: Raw imports (static, dynamic, require) ----------------------
+    extractRawImports(_filePath, content) {
+        const results = [];
+        const parser = getParser('typescript');
+        const tree = parser.parse(content);
+        if (!tree)
+            return results;
+        // Static imports
+        this.walkRaw(tree.rootNode, (node) => {
+            if (node.type === 'import_statement') {
+                const source = this.getChildByType(node, 'string');
+                if (source) {
+                    const specifier = source.text.slice(1, -1); // strip quotes
+                    results.push({
+                        moduleSpecifier: specifier,
+                        isStatic: true,
+                        isDynamic: false,
+                        isRequire: false,
+                        line: source.startPosition.row,
+                    });
+                }
+            }
+            // Dynamic import(): import('...')
+            if (node.type === 'call_expression') {
+                const fn = node.firstChild;
+                if (fn?.type === 'import') {
+                    const args = this.getChildByType(node, 'arguments');
+                    if (args) {
+                        const strNode = this.findFirstNamedChild(args, 'string');
+                        if (strNode) {
+                            const specifier = strNode.text.slice(1, -1);
+                            results.push({
+                                moduleSpecifier: specifier,
+                                isStatic: false,
+                                isDynamic: true,
+                                isRequire: false,
+                                line: strNode.startPosition.row,
+                            });
+                        }
+                    }
+                }
+                // require('...')
+                if (fn?.type === 'identifier' && fn.text === 'require') {
+                    const args = this.getChildByType(node, 'arguments');
+                    if (args) {
+                        const strNode = this.findFirstNamedChild(args, 'string');
+                        if (strNode) {
+                            const specifier = strNode.text.slice(1, -1);
+                            results.push({
+                                moduleSpecifier: specifier,
+                                isStatic: false,
+                                isDynamic: false,
+                                isRequire: true,
+                                line: strNode.startPosition.row,
+                            });
+                        }
+                    }
+                }
+            }
+        });
+        return results;
+    }
+    // -- Optional: Exported symbol names --------------------------------------
+    extractExportedSymbols(ast) {
+        const symbols = [];
+        this.walk(ast.root, (astNode) => {
+            const node = astNode.raw;
+            if (node.type === 'export_statement') {
+                // export function foo / export class Foo / export const x
+                const declaration = this.findFirstNamedChild(node, [
+                    'function_declaration',
+                    'class_declaration',
+                    'lexical_declaration',
+                    'variable_declaration',
+                    'interface_declaration',
+                    'type_alias_declaration',
+                    'enum_declaration',
+                ]);
+                if (declaration) {
+                    const name = this.extractName(declaration);
+                    if (name) {
+                        symbols.push({ name, line: declaration.startPosition.row });
+                        return;
+                    }
+                }
+                // export { foo, bar } or export { default }
+                const clause = this.getChildByType(node, 'export_clause');
+                if (clause) {
+                    for (const child of clause.namedChildren) {
+                        if (child.type === 'export_specifier') {
+                            const nameNode = this.getChildByType(child, 'identifier');
+                            if (nameNode) {
+                                symbols.push({
+                                    name: nameNode.text,
+                                    line: nameNode.startPosition.row,
+                                });
+                            }
+                        }
+                    }
+                }
+                // export default <expression>
+                if (node.childForFieldName?.('value')) {
+                    symbols.push({
+                        name: 'default',
+                        line: node.startPosition.row,
+                    });
+                }
+            }
+        });
+        return symbols;
+    }
+    // ---------------------------------------------------------------------------
+    // Internal helpers
+    // ---------------------------------------------------------------------------
+    /** Walk all ASTNodes in a tree (depth-first). */
+    walk(node, visitor) {
+        visitor(node);
+        if (node.children) {
+            for (const child of node.children) {
+                this.walk(child, visitor);
+            }
+        }
+    }
+    /** Walk all TreeSitterNodes in a tree (depth-first). */
+    walkRaw(node, visitor) {
+        visitor(node);
+        for (const child of node.children) {
+            this.walkRaw(child, visitor);
+        }
+    }
+    /** Collect ERROR nodes from tree-sitter's error recovery. */
+    collectErrors(node, errors) {
+        if (node.type === 'ERROR' || node.isError) {
+            errors.push({
+                message: `Parse error near "${node.text.slice(0, 50)}"`,
+                location: toSourceLocation(node),
+                severity: 'error',
+            });
+        }
+        for (const child of node.children) {
+            this.collectErrors(child, errors);
+        }
+    }
+    /** Match an ASTNode against a NodePattern. */
+    matchesPattern(node, pattern) {
+        const syntaxNode = node.raw;
+        // type matching
+        if (pattern.type !== undefined) {
+            const types = Array.isArray(pattern.type) ? pattern.type : [pattern.type];
+            if (!types.includes(syntaxNode.type))
+                return false;
+        }
+        // name matching
+        if (pattern.name !== undefined) {
+            const nodeName = this.extractName(syntaxNode);
+            if (nodeName === null)
+                return false;
+            if (typeof pattern.name === 'string') {
+                if (nodeName !== pattern.name)
+                    return false;
+            }
+            else if (pattern.name instanceof RegExp) {
+                if (!pattern.name.test(nodeName))
+                    return false;
+            }
+        }
+        // hasChild matching
+        if (pattern.hasChild !== undefined) {
+            const childNodes = node.children ?? [];
+            const hasMatch = childNodes.some((c) => this.matchesPattern(c, pattern.hasChild));
+            if (!hasMatch)
+                return false;
+        }
+        // hasParent matching
+        if (pattern.hasParent !== undefined) {
+            if (!node.parent)
+                return false;
+            if (!this.matchesPattern(node.parent, pattern.hasParent))
+                return false;
+        }
+        // custom predicate
+        if (pattern.custom !== undefined) {
+            if (!pattern.custom(node))
+                return false;
+        }
+        return true;
+    }
+    /** Extract the name/identifier from a tree-sitter TreeSitterNode. */
+    extractName(node) {
+        switch (node.type) {
+            case 'function_declaration':
+            case 'generator_function_declaration':
+            case 'class_declaration':
+            case 'interface_declaration':
+            case 'enum_declaration':
+            case 'type_alias_declaration': {
+                const nameNode = node.childForFieldName?.('name');
+                if (nameNode)
+                    return nameNode.text;
+                // Fallback: find first identifier child
+                for (const child of node.namedChildren) {
+                    if (child.type === 'identifier' || child.type === 'type_identifier') {
+                        return child.text;
+                    }
+                }
+                return null;
+            }
+            case 'method_definition':
+            case 'public_field_definition': {
+                const nameNode = node.childForFieldName?.('name');
+                if (nameNode)
+                    return nameNode.text;
+                // property_identifier or string
+                for (const child of node.namedChildren) {
+                    if (child.type === 'property_identifier' ||
+                        child.type === 'string') {
+                        return child.text.replace(/^["']|["']$/g, '');
+                    }
+                }
+                return null;
+            }
+            case 'variable_declarator': {
+                const nameNode = node.childForFieldName?.('name');
+                if (nameNode)
+                    return nameNode.text;
+                return null;
+            }
+            case 'lexical_declaration':
+            case 'variable_declaration': {
+                // Find the declarator child and extract its name
+                for (const child of node.namedChildren) {
+                    if (child.type === 'variable_declarator') {
+                        return this.extractName(child);
+                    }
+                }
+                return null;
+            }
+            case 'arrow_function': {
+                // Check if assigned to a variable: const foo = () => {}
+                const parent = node.parent;
+                if (parent?.type === 'variable_declarator') {
+                    return this.extractName(parent);
+                }
+                return null;
+            }
+            case 'function_expression': {
+                // Might have a name: const foo = function bar() {}
+                const nameNode = node.childForFieldName?.('name');
+                if (nameNode)
+                    return nameNode.text;
+                // Check if assigned to a variable
+                const parent = node.parent;
+                if (parent?.type === 'variable_declarator') {
+                    return this.extractName(parent);
+                }
+                return null;
+            }
+            case 'property_identifier':
+                return node.text;
+            case 'identifier':
+                return node.text;
+            default:
+                return null;
+        }
+    }
+    /** Extract a type annotation string from a node. */
+    extractTypeAnnotation(node) {
+        // Function return type
+        if (node.type === 'function_declaration' ||
+            node.type === 'method_definition' ||
+            node.type === 'arrow_function') {
+            const returnType = node.childForFieldName?.('return_type');
+            if (returnType) {
+                return returnType.text.replace(/^:\s*/, '').trim();
+            }
+        }
+        // Variable / parameter type annotation
+        const typeAnnotation = node.childForFieldName?.('type');
+        if (typeAnnotation) {
+            return typeAnnotation.text.replace(/^:\s*/, '').trim();
+        }
+        // Named children that are type_annotation
+        for (const child of node.namedChildren) {
+            if (child.type === 'type_annotation') {
+                return child.text.replace(/^:\s*/, '').trim();
+            }
+        }
+        return null;
+    }
+    /** Extract JSDoc or leading comment from a node. */
+    extractDocumentation(node) {
+        const parent = node.parent;
+        if (!parent)
+            return null;
+        // Find the node's position among its parent's children and look for
+        // a preceding comment node.
+        const siblings = parent.children;
+        let myIndex = -1;
+        for (let i = 0; i < siblings.length; i++) {
+            if (siblings[i] === node) {
+                myIndex = i;
+                break;
+            }
+        }
+        if (myIndex === -1)
+            return null;
+        // Look backwards through siblings for comment nodes
+        const comments = [];
+        for (let i = myIndex - 1; i >= 0; i--) {
+            const sibling = siblings[i];
+            if (sibling.type === 'comment') {
+                comments.unshift(sibling.text);
+            }
+            else if (sibling.isNamed) {
+                // Stop at the first non-comment, named sibling
+                break;
+            }
+            // Continue past non-named tokens (whitespace, semicolons, etc.)
+        }
+        if (comments.length === 0)
+            return null;
+        const text = comments.join('\n').trim();
+        return this.cleanCommentText(text);
+    }
+    /** Strip comment syntax markers. */
+    cleanCommentText(comment) {
+        // Block comments: /* ... */ or /** ... */
+        if (comment.startsWith('/*')) {
+            let inner = comment.slice(2, -2);
+            // Strip leading asterisks
+            inner = inner
+                .split('\n')
+                .map((line) => line.replace(/^\s*\*\s?/, ''))
+                .join('\n');
+            return inner.trim();
+        }
+        // Line comments: //
+        if (comment.startsWith('//')) {
+            return comment.replace(/^\/\/\s*/, '').trim();
+        }
+        return comment.trim();
+    }
+    /**
+     * Cyclomatic complexity: count decision points + 1.
+     * Decision points: if, for, while, do, switch_case, ternary, &&, ||.
+     */
+    calculateCyclomaticComplexity(node) {
+        let complexity = 1;
+        this.walkRaw(node, (child) => {
+            if (child === node)
+                return; // don't count the root node itself
+            switch (child.type) {
+                case 'if_statement':
+                case 'for_statement':
+                case 'for_in_statement':
+                case 'while_statement':
+                case 'do_statement':
+                case 'switch_case':
+                case 'ternary_expression':
+                case 'catch_clause':
+                    complexity++;
+                    break;
+                case 'binary_expression': {
+                    // && and || create branching paths
+                    const op = this.getOperator(child);
+                    if (op === '&&' || op === '||') {
+                        complexity++;
+                    }
+                    break;
+                }
+            }
+        });
+        return complexity;
+    }
+    /** Get the operator text from a binary expression node. */
+    getOperator(node) {
+        for (const child of node.children) {
+            if (!child.isNamed &&
+                ['&&', '||', '+', '-', '*', '/', '%', '===', '!==', '==', '!='].includes(child.type)) {
+                return child.type;
+            }
+        }
+        return null;
+    }
+    // -- Extraction helpers ----------------------------------------------------
+    buildFunctionInfo(node, sourceCode) {
+        const name = this.extractName(node);
+        if (name === null && node.type !== 'arrow_function')
+            return null;
+        const isAsync = this.hasModifier(node, 'async');
+        const isMethod = node.type === 'method_definition';
+        const isExported = this.isNodeExported(node);
+        const returnType = this.extractTypeAnnotation(node);
+        const jsDoc = this.extractDocumentation(node);
+        const className = isMethod ? this.getEnclosingClassName(node) : undefined;
+        const parameters = this.extractParameters(node, sourceCode);
+        return {
+            name: name ?? '<anonymous>',
+            location: toSourceLocation(node),
+            parameters,
+            returnType: returnType ?? undefined,
+            isAsync,
+            isExported,
+            isMethod,
+            className,
+            jsDoc: jsDoc ?? undefined,
+        };
+    }
+    buildClassInfo(node, sourceCode) {
+        const name = this.extractName(node);
+        if (!name)
+            return null;
+        const isAbstract = this.hasModifier(node, 'abstract');
+        const isExported = this.isNodeExported(node);
+        const jsDoc = this.extractDocumentation(node);
+        // Extract extends
+        let extendsName;
+        const extendsClause = node.childForFieldName?.('extends');
+        if (extendsClause) {
+            const firstTypeChild = extendsClause.namedChildren[0];
+            if (firstTypeChild) {
+                extendsName = firstTypeChild.text;
+            }
+        }
+        // Extract implements
+        let implementsList;
+        const implementsClause = node.childForFieldName?.('implements');
+        if (implementsClause) {
+            implementsList = implementsClause.namedChildren.map((c) => c.text);
+        }
+        // Extract methods
+        const classBody = node.childForFieldName?.('body');
+        const methods = [];
+        const properties = [];
+        if (classBody) {
+            for (const member of classBody.namedChildren) {
+                if (member.type === 'method_definition') {
+                    const fnInfo = this.buildFunctionInfo(member, sourceCode);
+                    if (fnInfo) {
+                        fnInfo.className = name;
+                        fnInfo.isMethod = true;
+                        methods.push(fnInfo);
+                    }
+                }
+                else if (member.type === 'public_field_definition' ||
+                    member.type === 'field_definition') {
+                    const propInfo = this.buildPropertyInfo(member);
+                    if (propInfo)
+                        properties.push(propInfo);
+                }
+            }
+        }
+        return {
+            name,
+            location: toSourceLocation(node),
+            methods,
+            properties,
+            extends: extendsName,
+            implements: implementsList,
+            isAbstract,
+            isExported,
+            jsDoc: jsDoc ?? undefined,
+        };
+    }
+    buildPropertyInfo(node) {
+        const name = this.extractName(node);
+        if (!name)
+            return null;
+        let visibility;
+        if (this.hasModifier(node, 'private'))
+            visibility = 'private';
+        else if (this.hasModifier(node, 'protected'))
+            visibility = 'protected';
+        else if (this.hasModifier(node, 'public'))
+            visibility = 'public';
+        const isStatic = this.hasModifier(node, 'static');
+        const isReadonly = this.hasModifier(node, 'readonly');
+        const type = this.extractTypeAnnotation(node);
+        return {
+            name,
+            type: type ?? undefined,
+            visibility,
+            isStatic,
+            isReadonly,
+        };
+    }
+    buildImportInfo(node, _sourceCode) {
+        // import source
+        const sourceNode = node.childForFieldName?.('source');
+        if (!sourceNode)
+            return null;
+        const source = sourceNode.text.slice(1, -1); // strip quotes
+        const specifiers = [];
+        // import defaultExport from 'module'
+        // import * as namespace from 'module'
+        // import { named } from 'module'
+        for (const child of node.namedChildren) {
+            if (child.type === 'import_specifier') {
+                const nameNode = child.childForFieldName?.('name');
+                const aliasNode = child.childForFieldName?.('alias');
+                if (nameNode) {
+                    specifiers.push({
+                        name: nameNode.text,
+                        alias: aliasNode?.text,
+                        isDefault: false,
+                        isNamespace: false,
+                    });
+                }
+            }
+            else if (child.type === 'namespace_import') {
+                const nameNode = child.childForFieldName?.('name');
+                if (nameNode) {
+                    specifiers.push({
+                        name: nameNode.text,
+                        isDefault: false,
+                        isNamespace: true,
+                    });
+                }
+            }
+            else if (child.type === 'import') {
+                // default import: `import foo from '...'`
+                const nameNode = node.childForFieldName?.('name');
+                if (nameNode) {
+                    specifiers.push({
+                        name: nameNode.text,
+                        isDefault: true,
+                        isNamespace: false,
+                    });
+                }
+            }
+        }
+        return {
+            source,
+            specifiers,
+            location: toSourceLocation(node),
+        };
+    }
+    buildExportInfo(node, _sourceCode) {
+        // export default <expression>
+        const isDefault = this.hasChild(node, 'default');
+        // export { foo, bar } [from '...']
+        const clause = node.childForFieldName?.('clause');
+        if (clause?.type === 'export_clause') {
+            const sourceNode = node.childForFieldName?.('source');
+            const exports = [];
+            for (const spec of clause.namedChildren) {
+                if (spec.type === 'export_specifier') {
+                    const nameNode = spec.childForFieldName?.('name');
+                    if (nameNode) {
+                        exports.push({
+                            name: nameNode.text,
+                            location: toSourceLocation(nameNode),
+                            isDefault: false,
+                            source: sourceNode?.text.slice(1, -1),
+                        });
+                    }
+                }
+            }
+            // Return first (handled by caller iterating export_statement nodes)
+            return exports[0] ?? null;
+        }
+        // export function/class/const/let/var name
+        const declaration = this.findFirstNamedChild(node, [
+            'function_declaration',
+            'class_declaration',
+            'lexical_declaration',
+            'variable_declaration',
+        ]);
+        if (declaration) {
+            const name = this.extractName(declaration);
+            if (name) {
+                return {
+                    name,
+                    location: toSourceLocation(node),
+                    isDefault,
+                    source: node.childForFieldName?.('source')?.text.slice(1, -1),
+                };
+            }
+        }
+        // export default <name> (no declaration)
+        if (isDefault) {
+            const value = node.childForFieldName?.('value');
+            if (value) {
+                return {
+                    name: value.text,
+                    location: toSourceLocation(node),
+                    isDefault: true,
+                };
+            }
+        }
+        return null;
+    }
+    buildInterfaceInfo(node, _sourceCode) {
+        const name = this.extractName(node);
+        if (!name)
+            return null;
+        const isExported = this.isNodeExported(node);
+        // Extends
+        let extendsList;
+        const extendsClause = node.childForFieldName?.('extends');
+        if (extendsClause) {
+            extendsList = extendsClause.namedChildren.map((c) => c.text);
+        }
+        // Members
+        const body = node.childForFieldName?.('body');
+        const members = [];
+        if (body) {
+            for (const member of body.namedChildren) {
+                if (member.type === 'method_signature') {
+                    const memberName = member.childForFieldName?.('name')?.text;
+                    if (memberName) {
+                        members.push({
+                            name: memberName,
+                            type: 'method',
+                            location: toSourceLocation(member),
+                        });
+                    }
+                }
+                else if (member.type === 'property_signature') {
+                    const memberName = member.childForFieldName?.('name')?.text;
+                    if (memberName) {
+                        members.push({
+                            name: memberName,
+                            type: 'property',
+                            location: toSourceLocation(member),
+                        });
+                    }
+                }
+            }
+        }
+        return {
+            name,
+            location: toSourceLocation(node),
+            members,
+            extends: extendsList,
+            isExported,
+        };
+    }
+    // -- Parameter extraction --------------------------------------------------
+    extractParameters(node, sourceCode) {
+        const params = [];
+        const formalParams = node.childForFieldName?.('parameters');
+        if (!formalParams)
+            return params;
+        for (const child of formalParams.namedChildren) {
+            if (child.type === 'required_parameter' || child.type === 'optional_parameter') {
+                const paramNode = child.childForFieldName?.('pattern');
+                const name = paramNode?.text ?? child.firstNamedChild?.text;
+                const isOptional = child.type === 'optional_parameter';
+                const typeNode = child.childForFieldName?.('type');
+                let defaultValue;
+                // Check for a default value
+                const valueNode = child.childForFieldName?.('value');
+                if (valueNode) {
+                    defaultValue = valueNode.text;
+                }
+                if (name) {
+                    params.push({
+                        name,
+                        type: typeNode?.text.replace(/^:\s*/, ''),
+                        optional: isOptional,
+                        defaultValue,
+                    });
+                }
+            }
+        }
+        return params;
+    }
+    // -- Context helpers -------------------------------------------------------
+    /** Check if a node has an `async` modifier keyword. */
+    hasModifier(node, modifier) {
+        for (const child of node.children) {
+            if (!child.isNamed && child.type === modifier)
+                return true;
+            // tree-sitter may represent modifiers as named decorator/modifier nodes
+            if (child.isNamed &&
+                (child.type === modifier ||
+                    child.type === 'accessibility_modifier' ||
+                    child.type === 'override_modifier' ||
+                    child.type === 'readonly' ||
+                    child.type === 'static' ||
+                    child.type === 'abstract')) {
+                if (child.text === modifier)
+                    return true;
+            }
+        }
+        return false;
+    }
+    /** Check if a node is under an export_statement. */
+    isNodeExported(node) {
+        const parent = node.parent;
+        if (parent?.type === 'export_statement')
+            return true;
+        // Also check for `export` keyword on the node itself (TS module syntax)
+        for (const child of node.children) {
+            if (!child.isNamed && child.type === 'export')
+                return true;
+        }
+        return false;
+    }
+    /** Get the enclosing class name for a method. */
+    getEnclosingClassName(node) {
+        let current = node.parent;
+        while (current) {
+            if (current.type === 'class_declaration') {
+                return this.extractName(current) ?? undefined;
+            }
+            current = current.parent ?? null;
+        }
+        return undefined;
+    }
+    // -- Tree traversal helpers ------------------------------------------------
+    /** Find first child of node matching one of the given types. */
+    getChildByType(node, type) {
+        for (const child of node.children) {
+            if (child.type === type)
+                return child;
+        }
+        return null;
+    }
+    /** Find the first named child matching one of the given types. */
+    findFirstNamedChild(node, types) {
+        const typeSet = Array.isArray(types) ? new Set(types) : new Set([types]);
+        for (const child of node.namedChildren) {
+            if (typeSet.has(child.type))
+                return child;
+        }
+        return null;
+    }
+    /** Check if node has a direct child (named or anonymous) with the given text. */
+    hasChild(node, text) {
+        for (const child of node.children) {
+            if (child.text === text || child.type === text)
+                return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=TreeSitterTypeScriptAdapter.js.map