@liendev/parser 0.39.0

package/dist/ast/languages/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/ast/languages/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;GAGG;AAEH,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,EAAE,EAAE,iBAAiB,CAAC;IAEtB,yDAAyD;IACzD,UAAU,EAAE,MAAM,EAAE,CAAC;IAErB,6CAA6C;IAC7C,OAAO,EAAE,kBAAkB,CAAC;IAE5B,+CAA+C;IAC/C,SAAS,EAAE,iBAAiB,CAAC;IAE7B,kDAAkD;IAClD,eAAe,EAAE,uBAAuB,CAAC;IAEzC,yFAAyF;IACzF,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAE1C,yFAAyF;IACzF,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAE1C,sCAAsC;IACtC,UAAU,EAAE;QACV,gEAAgE;QAChE,cAAc,EAAE,MAAM,EAAE,CAAC;QAEzB,2EAA2E;QAC3E,YAAY,EAAE,MAAM,EAAE,CAAC;QAEvB,+DAA+D;QAC/D,eAAe,EAAE,MAAM,EAAE,CAAC;QAE1B,sEAAsE;QACtE,WAAW,EAAE,MAAM,EAAE,CAAC;QAEtB,4DAA4D;QAC5D,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAE7B,4DAA4D;QAC5D,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;KAC/B,CAAC;IAEF,sCAAsC;IACtC,OAAO,EAAE;QACP,wDAAwD;QACxD,mBAAmB,EAAE,MAAM,EAAE,CAAC;KAC/B,CAAC;CACH"}

package/dist/ast/languages/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/ast/languages/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/ast/languages/types.ts"],"names":[],"mappings":""}

package/dist/ast/languages/typescript.d.ts

@@ -0,0 +1,3 @@
+import type { LanguageDefinition } from './types.js';
+export declare const typescriptDefinition: LanguageDefinition;
+//# sourceMappingURL=typescript.d.ts.map

package/dist/ast/languages/typescript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.d.ts","sourceRoot":"","sources":["../../../src/ast/languages/typescript.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAQrD,eAAO,MAAM,oBAAoB,EAAE,kBAoIlC,CAAC"}

package/dist/ast/languages/typescript.js

@@ -0,0 +1,134 @@
+import TypeScript from 'tree-sitter-typescript';
+import { TypeScriptTraverser, TypeScriptExportExtractor, TypeScriptImportExtractor, TypeScriptSymbolExtractor, } from './javascript.js';
+export const typescriptDefinition = {
+    id: 'typescript',
+    extensions: ['ts', 'tsx'],
+    grammar: TypeScript.typescript,
+    traverser: new TypeScriptTraverser(),
+    exportExtractor: new TypeScriptExportExtractor(),
+    importExtractor: new TypeScriptImportExtractor(),
+    symbolExtractor: new TypeScriptSymbolExtractor(),
+    complexity: {
+        decisionPoints: [
+            'if_statement',
+            'while_statement',
+            'for_statement',
+            'switch_case',
+            'catch_clause',
+            'ternary_expression',
+            'binary_expression',
+            'do_statement',
+            'for_in_statement',
+            'for_of_statement',
+        ],
+        nestingTypes: [
+            'if_statement',
+            'for_statement',
+            'while_statement',
+            'switch_statement',
+            'catch_clause',
+            'do_statement',
+            'for_in_statement',
+            'for_of_statement',
+        ],
+        nonNestingTypes: ['else_clause', 'ternary_expression'],
+        lambdaTypes: ['arrow_function', 'function_expression'],
+        operatorSymbols: new Set([
+            '+',
+            '-',
+            '*',
+            '/',
+            '%',
+            '**',
+            '==',
+            '===',
+            '!=',
+            '!==',
+            '<',
+            '>',
+            '<=',
+            '>=',
+            '&&',
+            '||',
+            '!',
+            '??',
+            '=',
+            '+=',
+            '-=',
+            '*=',
+            '/=',
+            '%=',
+            '**=',
+            '&&=',
+            '||=',
+            '??=',
+            '&',
+            '|',
+            '^',
+            '~',
+            '<<',
+            '>>',
+            '>>>',
+            '&=',
+            '|=',
+            '^=',
+            '<<=',
+            '>>=',
+            '>>>=',
+            '?',
+            ':',
+            '.',
+            '?.',
+            '++',
+            '--',
+            '...',
+            '=>',
+            '(',
+            ')',
+            '[',
+            ']',
+            '{',
+            '}',
+        ]),
+        operatorKeywords: new Set([
+            'if',
+            'else',
+            'for',
+            'while',
+            'do',
+            'switch',
+            'case',
+            'default',
+            'return',
+            'throw',
+            'try',
+            'catch',
+            'finally',
+            'new',
+            'delete',
+            'typeof',
+            'instanceof',
+            'in',
+            'of',
+            'await',
+            'yield',
+            'break',
+            'continue',
+            'const',
+            'let',
+            'var',
+            'function',
+            'class',
+            'extends',
+            'implements',
+            'import',
+            'export',
+            'from',
+            'as',
+        ]),
+    },
+    symbols: {
+        callExpressionTypes: ['call_expression', 'new_expression'],
+    },
+};
+//# sourceMappingURL=typescript.js.map

package/dist/ast/languages/typescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.js","sourceRoot":"","sources":["../../../src/ast/languages/typescript.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,wBAAwB,CAAC;AAEhD,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,CAAC,MAAM,oBAAoB,GAAuB;IACtD,EAAE,EAAE,YAAY;IAChB,UAAU,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC;IACzB,OAAO,EAAE,UAAU,CAAC,UAAU;IAC9B,SAAS,EAAE,IAAI,mBAAmB,EAAE;IACpC,eAAe,EAAE,IAAI,yBAAyB,EAAE;IAChD,eAAe,EAAE,IAAI,yBAAyB,EAAE;IAChD,eAAe,EAAE,IAAI,yBAAyB,EAAE;IAEhD,UAAU,EAAE;QACV,cAAc,EAAE;YACd,cAAc;YACd,iBAAiB;YACjB,eAAe;YACf,aAAa;YACb,cAAc;YACd,oBAAoB;YACpB,mBAAmB;YACnB,cAAc;YACd,kBAAkB;YAClB,kBAAkB;SACnB;QACD,YAAY,EAAE;YACZ,cAAc;YACd,eAAe;YACf,iBAAiB;YACjB,kBAAkB;YAClB,cAAc;YACd,cAAc;YACd,kBAAkB;YAClB,kBAAkB;SACnB;QACD,eAAe,EAAE,CAAC,aAAa,EAAE,oBAAoB,CAAC;QACtD,WAAW,EAAE,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;QACtD,eAAe,EAAE,IAAI,GAAG,CAAC;YACvB,GAAG;YACH,GAAG;YACH,GAAG;YACH,GAAG;YACH,GAAG;YACH,IAAI;YACJ,IAAI;YACJ,KAAK;YACL,IAAI;YACJ,KAAK;YACL,GAAG;YACH,GAAG;YACH,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,GAAG;YACH,IAAI;YACJ,GAAG;YACH,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,GAAG;YACH,GAAG;YACH,GAAG;YACH,GAAG;YACH,IAAI;YACJ,IAAI;YACJ,KAAK;YACL,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,KAAK;YACL,KAAK;YACL,MAAM;YACN,GAAG;YACH,GAAG;YACH,GAAG;YACH,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,KAAK;YACL,IAAI;YACJ,GAAG;YACH,GAAG;YACH,GAAG;YACH,GAAG;YACH,GAAG;YACH,GAAG;SACJ,CAAC;QACF,gBAAgB,EAAE,IAAI,GAAG,CAAC;YACxB,IAAI;YACJ,MAAM;YACN,KAAK;YACL,OAAO;YACP,IAAI;YACJ,QAAQ;YACR,MAAM;YACN,SAAS;YACT,QAAQ;YACR,OAAO;YACP,KAAK;YACL,OAAO;YACP,SAAS;YACT,KAAK;YACL,QAAQ;YACR,QAAQ;YACR,YAAY;YACZ,IAAI;YACJ,IAAI;YACJ,OAAO;YACP,OAAO;YACP,OAAO;YACP,UAAU;YACV,OAAO;YACP,KAAK;YACL,KAAK;YACL,UAAU;YACV,OAAO;YACP,SAAS;YACT,YAAY;YACZ,QAAQ;YACR,QAAQ;YACR,MAAM;YACN,IAAI;SACL,CAAC;KACH;IAED,OAAO,EAAE;QACP,mBAAmB,EAAE,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;KAC3D;CACF,CAAC"}

package/dist/ast/parser.d.ts

@@ -0,0 +1,29 @@
+import { detectLanguage as registryDetectLanguage } from './languages/registry.js';
+import type { SupportedLanguage } from './languages/registry.js';
+import type { ASTParseResult } from './types.js';
+/**
+ * Detect language from file extension.
+ * Re-exported from the language registry for backwards compatibility.
+ */
+export declare const detectLanguage: typeof registryDetectLanguage;
+/**
+ * Check if a file is supported for AST parsing
+ */
+export declare function isASTSupported(filePath: string): boolean;
+/**
+ * Parse source code into an AST using Tree-sitter
+ *
+ * **Known Limitation:** Tree-sitter may throw "Invalid argument" errors on very large files
+ * (1000+ lines). This is a limitation of Tree-sitter's internal buffer handling. When this
+ * occurs, callers should fall back to line-based chunking (handled automatically by chunker.ts).
+ *
+ * @param content - Source code to parse
+ * @param language - Programming language
+ * @returns Parse result with tree or error
+ */
+export declare function parseAST(content: string, language: SupportedLanguage): ASTParseResult;
+/**
+ * Clear parser cache (useful for testing)
+ */
+export declare function clearParserCache(): void;
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/ast/parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,cAAc,IAAI,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAChG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAsBjD;;;GAGG;AACH,eAAO,MAAM,cAAc,+BAAyB,CAAC;AAErD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,cAAc,CAoBrF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/ast/parser.js

@@ -0,0 +1,67 @@
+import Parser from 'tree-sitter';
+import { getLanguage, detectLanguage as registryDetectLanguage } from './languages/registry.js';
+/**
+ * Cache for parser instances to avoid recreating them
+ */
+const parserCache = new Map();
+/**
+ * Get or create a cached parser instance for a language
+ */
+function getParser(language) {
+    if (!parserCache.has(language)) {
+        const parser = new Parser();
+        const grammar = getLanguage(language).grammar;
+        parser.setLanguage(grammar);
+        parserCache.set(language, parser);
+    }
+    return parserCache.get(language);
+}
+/**
+ * Detect language from file extension.
+ * Re-exported from the language registry for backwards compatibility.
+ */
+export const detectLanguage = registryDetectLanguage;
+/**
+ * Check if a file is supported for AST parsing
+ */
+export function isASTSupported(filePath) {
+    return detectLanguage(filePath) !== null;
+}
+/**
+ * Parse source code into an AST using Tree-sitter
+ *
+ * **Known Limitation:** Tree-sitter may throw "Invalid argument" errors on very large files
+ * (1000+ lines). This is a limitation of Tree-sitter's internal buffer handling. When this
+ * occurs, callers should fall back to line-based chunking (handled automatically by chunker.ts).
+ *
+ * @param content - Source code to parse
+ * @param language - Programming language
+ * @returns Parse result with tree or error
+ */
+export function parseAST(content, language) {
+    try {
+        const parser = getParser(language);
+        const tree = parser.parse(content);
+        // Check for parse errors (hasError is a property, not a method)
+        if (tree.rootNode.hasError) {
+            return {
+                tree,
+                error: 'Parse completed with errors',
+            };
+        }
+        return { tree };
+    }
+    catch (error) {
+        return {
+            tree: null,
+            error: error instanceof Error ? error.message : 'Unknown parse error',
+        };
+    }
+}
+/**
+ * Clear parser cache (useful for testing)
+ */
+export function clearParserCache() {
+    parserCache.clear();
+}
+//# sourceMappingURL=parser.js.map

package/dist/ast/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/ast/parser.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,cAAc,IAAI,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAIhG;;GAEG;AACH,MAAM,WAAW,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEzD;;GAEG;AACH,SAAS,SAAS,CAAC,QAA2B;IAC5C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;QAE9C,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC5B,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAErD;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,cAAc,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,QAA2B;IACnE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEnC,gEAAgE;QAChE,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC3B,OAAO;gBACL,IAAI;gBACJ,KAAK,EAAE,6BAA6B;aACrC,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB;SACtE,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,WAAW,CAAC,KAAK,EAAE,CAAC;AACtB,CAAC"}

package/dist/ast/symbols.d.ts

@@ -0,0 +1,74 @@
+import type Parser from 'tree-sitter';
+import type { SymbolInfo, SupportedLanguage } from './types.js';
+/**
+ * Extract symbol information from an AST node using language-specific extractors.
+ *
+ * @param node - AST node to extract info from
+ * @param content - Source code content
+ * @param parentClass - Parent class name if this is a method
+ * @param language - Programming language
+ * @returns Symbol information or null
+ */
+export declare function extractSymbolInfo(node: Parser.SyntaxNode, content: string, parentClass?: string, language?: string): SymbolInfo | null;
+/**
+ * Extract import statements from a file.
+ *
+ * When a language is provided, uses the language-specific import extractor.
+ * Falls back to legacy behavior for backwards compatibility.
+ */
+export declare function extractImports(rootNode: Parser.SyntaxNode, language?: SupportedLanguage): string[];
+/**
+ * Extract imported symbols mapped to their source paths.
+ *
+ * Returns a map like: { './validate': ['validateEmail', 'validatePhone'] }
+ *
+ * When a language is provided, uses the language-specific import extractor.
+ * Falls back to legacy behavior for backwards compatibility.
+ */
+export declare function extractImportedSymbols(rootNode: Parser.SyntaxNode, language?: SupportedLanguage): Record<string, string[]>;
+/**
+ * Extract exported symbols from a file.
+ *
+ * Returns array of exported symbol names like: ['validateEmail', 'validatePhone', 'default']
+ *
+ * Language-specific behavior:
+ *
+ * **JavaScript/TypeScript:**
+ * - Named exports: export { foo, bar }
+ * - Declaration exports: export function foo() {}, export const bar = ...
+ * - Default exports: export default ...
+ * - Re-exports: export { foo } from './module'
+ *
+ * **PHP:**
+ * - All top-level classes, traits, interfaces, and functions are considered exported
+ * - PHP doesn't have explicit export syntax - all public declarations are accessible
+ *
+ * **Python:**
+ * - All module-level classes and functions are considered exported
+ * - Python doesn't have explicit export syntax - module-level names are importable
+ *
+ * Limitations:
+ * - Only static, top-level declarations are processed (direct children of the root node).
+ * - Dynamic or conditional exports/declarations are not detected.
+ *
+ * @param rootNode - AST root node
+ * @param language - Programming language (defaults to 'javascript' for backwards compatibility)
+ * @returns Array of exported symbol names
+ */
+export declare function extractExports(rootNode: Parser.SyntaxNode, language?: SupportedLanguage): string[];
+/**
+ * Extract call sites within a function/method body.
+ *
+ * Returns array of function calls made within the node.
+ *
+ * Supported languages:
+ * - TypeScript/JavaScript: call_expression (foo(), obj.method()), new_expression (new Foo())
+ * - PHP: function_call_expression, member_call_expression, scoped_call_expression
+ * - Python: call (similar to JS call_expression)
+ * - Rust: call_expression (foo(), obj.method()), macro_invocation (println!())
+ */
+export declare function extractCallSites(node: Parser.SyntaxNode, language?: SupportedLanguage): Array<{
+    symbol: string;
+    line: number;
+}>;
+//# sourceMappingURL=symbols.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../src/ast/symbols.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAKhE;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,UAAU,EACvB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,UAAU,GAAG,IAAI,CAQnB;AAyBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,CAAC,UAAU,EAC3B,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,MAAM,EAAE,CAGV;AA2CD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,CAAC,UAAU,EAC3B,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAG1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,CAAC,UAAU,EAC3B,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,MAAM,EAAE,CAKV;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,CAAC,UAAU,EACvB,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAazC"}

package/dist/ast/symbols.js

@@ -0,0 +1,171 @@
+import { getExtractor, getImportExtractor, getSymbolExtractor } from './extractors/index.js';
+import { getLanguage } from './languages/registry.js';
+/**
+ * Extract symbol information from an AST node using language-specific extractors.
+ *
+ * @param node - AST node to extract info from
+ * @param content - Source code content
+ * @param parentClass - Parent class name if this is a method
+ * @param language - Programming language
+ * @returns Symbol information or null
+ */
+export function extractSymbolInfo(node, content, parentClass, language) {
+    if (language) {
+        const extractor = getSymbolExtractor(language);
+        if (extractor) {
+            return extractor.extractSymbol(node, content, parentClass);
+        }
+    }
+    return null;
+}
+/**
+ * Extract import paths using the language-specific extractor.
+ */
+function extractImportPaths(rootNode, importExtractor) {
+    if (!importExtractor)
+        return [];
+    const imports = [];
+    const nodeTypeSet = new Set(importExtractor.importNodeTypes);
+    for (let i = 0; i < rootNode.namedChildCount; i++) {
+        const child = rootNode.namedChild(i);
+        if (!child || !nodeTypeSet.has(child.type))
+            continue;
+        const result = importExtractor.extractImportPath(child);
+        if (result)
+            imports.push(result);
+    }
+    return imports;
+}
+/**
+ * Extract import statements from a file.
+ *
+ * When a language is provided, uses the language-specific import extractor.
+ * Falls back to legacy behavior for backwards compatibility.
+ */
+export function extractImports(rootNode, language) {
+    if (!language)
+        return [];
+    return extractImportPaths(rootNode, getImportExtractor(language));
+}
+/**
+ * Add symbols to the import map, merging with existing entries.
+ */
+function addSymbolsToMap(map, importPath, symbols) {
+    const existing = map[importPath];
+    if (existing) {
+        existing.push(...symbols);
+    }
+    else {
+        map[importPath] = symbols;
+    }
+}
+/**
+ * Extract symbols using the language-specific extractor.
+ */
+function extractSymbolsWithExtractor(rootNode, importExtractor) {
+    if (!importExtractor)
+        return {};
+    const importedSymbols = {};
+    const nodeTypeSet = new Set(importExtractor.importNodeTypes);
+    for (let i = 0; i < rootNode.namedChildCount; i++) {
+        const node = rootNode.namedChild(i);
+        if (!node || !nodeTypeSet.has(node.type))
+            continue;
+        const result = importExtractor.processImportSymbols(node);
+        if (result) {
+            addSymbolsToMap(importedSymbols, result.importPath, result.symbols);
+        }
+    }
+    return importedSymbols;
+}
+/**
+ * Extract imported symbols mapped to their source paths.
+ *
+ * Returns a map like: { './validate': ['validateEmail', 'validatePhone'] }
+ *
+ * When a language is provided, uses the language-specific import extractor.
+ * Falls back to legacy behavior for backwards compatibility.
+ */
+export function extractImportedSymbols(rootNode, language) {
+    if (!language)
+        return {};
+    return extractSymbolsWithExtractor(rootNode, getImportExtractor(language));
+}
+/**
+ * Extract exported symbols from a file.
+ *
+ * Returns array of exported symbol names like: ['validateEmail', 'validatePhone', 'default']
+ *
+ * Language-specific behavior:
+ *
+ * **JavaScript/TypeScript:**
+ * - Named exports: export { foo, bar }
+ * - Declaration exports: export function foo() {}, export const bar = ...
+ * - Default exports: export default ...
+ * - Re-exports: export { foo } from './module'
+ *
+ * **PHP:**
+ * - All top-level classes, traits, interfaces, and functions are considered exported
+ * - PHP doesn't have explicit export syntax - all public declarations are accessible
+ *
+ * **Python:**
+ * - All module-level classes and functions are considered exported
+ * - Python doesn't have explicit export syntax - module-level names are importable
+ *
+ * Limitations:
+ * - Only static, top-level declarations are processed (direct children of the root node).
+ * - Dynamic or conditional exports/declarations are not detected.
+ *
+ * @param rootNode - AST root node
+ * @param language - Programming language (defaults to 'javascript' for backwards compatibility)
+ * @returns Array of exported symbol names
+ */
+export function extractExports(rootNode, language) {
+    // Default to JavaScript if no language specified (for backwards compatibility)
+    const lang = language ?? 'javascript';
+    const extractor = getExtractor(lang);
+    return extractor.extractExports(rootNode);
+}
+/**
+ * Extract call sites within a function/method body.
+ *
+ * Returns array of function calls made within the node.
+ *
+ * Supported languages:
+ * - TypeScript/JavaScript: call_expression (foo(), obj.method()), new_expression (new Foo())
+ * - PHP: function_call_expression, member_call_expression, scoped_call_expression
+ * - Python: call (similar to JS call_expression)
+ * - Rust: call_expression (foo(), obj.method()), macro_invocation (println!())
+ */
+export function extractCallSites(node, language) {
+    if (!language)
+        return [];
+    const langDef = getLanguage(language);
+    const extractor = langDef.symbolExtractor;
+    if (!extractor)
+        return [];
+    const callExprTypes = new Set(langDef.symbols.callExpressionTypes);
+    const callSites = [];
+    const seen = new Set();
+    traverseForCallSites(node, callSites, seen, callExprTypes, extractor);
+    return callSites;
+}
+/**
+ * Recursively traverse AST to find call expressions.
+ */
+function traverseForCallSites(node, callSites, seen, callExprTypes, extractor) {
+    if (callExprTypes.has(node.type)) {
+        const callSite = extractor.extractCallSite(node);
+        if (callSite && !seen.has(callSite.key)) {
+            seen.add(callSite.key);
+            callSites.push({ symbol: callSite.symbol, line: callSite.line });
+        }
+    }
+    // Recurse into named children to skip punctuation and other non-semantic nodes
+    for (let i = 0; i < node.namedChildCount; i++) {
+        const child = node.namedChild(i);
+        if (child)
+            traverseForCallSites(child, callSites, seen, callExprTypes, extractor);
+    }
+}
+//# sourceMappingURL=symbols.js.map

package/dist/ast/symbols.js.map

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

package/dist/ast/traversers/index.d.ts

@@ -0,0 +1,19 @@
+import type { SupportedLanguage } from '../types.js';
+import type { LanguageTraverser } from './types.js';
+export type { LanguageTraverser, DeclarationFunctionInfo } from './types.js';
+/**
+ * Get the traverser for a specific language.
+ * Delegates to the language registry.
+ *
+ * @param language - Programming language
+ * @returns Language-specific traverser
+ */
+export declare function getTraverser(language: SupportedLanguage): LanguageTraverser;
+/**
+ * Check if a language has a traverser implementation
+ *
+ * @param language - Programming language
+ * @returns True if traverser exists
+ */
+export declare function hasTraverser(language: string): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/ast/traversers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ast/traversers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGpD,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE7E;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,iBAAiB,GAAG,iBAAiB,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/ast/traversers/index.js

@@ -0,0 +1,21 @@
+import { getLanguage, languageExists } from '../languages/registry.js';
+/**
+ * Get the traverser for a specific language.
+ * Delegates to the language registry.
+ *
+ * @param language - Programming language
+ * @returns Language-specific traverser
+ */
+export function getTraverser(language) {
+    return getLanguage(language).traverser;
+}
+/**
+ * Check if a language has a traverser implementation
+ *
+ * @param language - Programming language
+ * @returns True if traverser exists
+ */
+export function hasTraverser(language) {
+    return languageExists(language);
+}
+//# sourceMappingURL=index.js.map

package/dist/ast/traversers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ast/traversers/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAIvE;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,QAA2B;IACtD,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC"}