@liendev/core 0.24.0 → 0.28.0

package/dist/indexer/ast/extractors/index.js

@@ -0,0 +1,49 @@
+import { JavaScriptExportExtractor, TypeScriptExportExtractor } from './javascript.js';
+import { PHPExportExtractor } from './php.js';
+import { PythonExportExtractor } from './python.js';
+/**
+ * Registry of language export extractors
+ *
+ * Maps each supported language to its export extractor implementation.
+ * When adding a new language:
+ * 1. Create a new extractor class implementing LanguageExportExtractor
+ * 2. Add it to this registry
+ * 3. Update SupportedLanguage type in ../types.ts
+ */
+const extractorRegistry = {
+    typescript: new TypeScriptExportExtractor(),
+    javascript: new JavaScriptExportExtractor(),
+    php: new PHPExportExtractor(),
+    python: new PythonExportExtractor(),
+};
+/**
+ * Get the export extractor for a specific language
+ *
+ * @param language - Programming language
+ * @returns Language-specific export extractor
+ * @throws Error if language is not supported (defensive check for runtime safety)
+ *
+ * Note: While TypeScript's type system guarantees all SupportedLanguage values
+ * have corresponding extractors, this runtime check provides defense against:
+ * - Type system bypasses (e.g., `as any` casting elsewhere)
+ * - JavaScript consumers without type checking
+ * - Future refactoring errors during registry modifications
+ */
+export function getExtractor(language) {
+    const extractor = extractorRegistry[language];
+    // Defensive runtime check - see function documentation
+    if (!extractor) {
+        throw new Error(`No export extractor available for language: ${language}`);
+    }
+    return extractor;
+}
+/**
+ * Check if a language has an export extractor implementation
+ *
+ * @param language - Programming language
+ * @returns True if extractor exists
+ */
+export function hasExtractor(language) {
+    return language in extractorRegistry;
+}
+//# sourceMappingURL=index.js.map

package/dist/indexer/ast/extractors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/indexer/ast/extractors/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAIpD;;;;;;;;GAQG;AACH,MAAM,iBAAiB,GAAuD;IAC5E,UAAU,EAAE,IAAI,yBAAyB,EAAE;IAC3C,UAAU,EAAE,IAAI,yBAAyB,EAAE;IAC3C,GAAG,EAAE,IAAI,kBAAkB,EAAE;IAC7B,MAAM,EAAE,IAAI,qBAAqB,EAAE;CACpC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,QAA2B;IACtD,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAE9C,uDAAuD;IACvD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,+CAA+C,QAAQ,EAAE,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAA2B;IACtD,OAAO,QAAQ,IAAI,iBAAiB,CAAC;AACvC,CAAC"}

package/dist/indexer/ast/extractors/javascript.d.ts

@@ -0,0 +1,32 @@
+import type Parser from 'tree-sitter';
+import type { LanguageExportExtractor } from './types.js';
+/**
+ * JavaScript/TypeScript export extractor
+ *
+ * Handles explicit export statements:
+ * - Named exports: export { foo, bar }
+ * - Declaration exports: export function foo() {}, export const bar = ...
+ * - Default exports: export default ...
+ * - Re-exports: export { foo } from './module'
+ */
+export declare class JavaScriptExportExtractor implements LanguageExportExtractor {
+    extractExports(rootNode: Parser.SyntaxNode): string[];
+    /**
+     * Extract symbols from a single export statement
+     */
+    private extractExportStatementSymbols;
+    /**
+     * Extract exported names from a declaration (function, const, class, interface)
+     */
+    private extractDeclarationExports;
+    /**
+     * Extract symbol names from export clause: export { foo, bar as baz }
+     */
+    private extractExportClauseSymbols;
+}
+/**
+ * TypeScript uses the same export extraction as JavaScript
+ */
+export declare class TypeScriptExportExtractor extends JavaScriptExportExtractor {
+}
+//# sourceMappingURL=javascript.d.ts.map

package/dist/indexer/ast/extractors/javascript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"javascript.d.ts","sourceRoot":"","sources":["../../../../src/indexer/ast/extractors/javascript.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;;;;;GAQG;AACH,qBAAa,yBAA0B,YAAW,uBAAuB;IACvE,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,EAAE;IAsBrD;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAsBrC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAsBjC;;OAEG;IACH,OAAO,CAAC,0BAA0B;CAcnC;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,yBAAyB;CAAG"}

package/dist/indexer/ast/extractors/javascript.js

@@ -0,0 +1,97 @@
+/**
+ * JavaScript/TypeScript export extractor
+ *
+ * Handles explicit export statements:
+ * - Named exports: export { foo, bar }
+ * - Declaration exports: export function foo() {}, export const bar = ...
+ * - Default exports: export default ...
+ * - Re-exports: export { foo } from './module'
+ */
+export class JavaScriptExportExtractor {
+    extractExports(rootNode) {
+        const exports = [];
+        const seen = new Set();
+        const addExport = (name) => {
+            if (name && !seen.has(name)) {
+                seen.add(name);
+                exports.push(name);
+            }
+        };
+        // Process only top-level export statements
+        for (let i = 0; i < rootNode.namedChildCount; i++) {
+            const child = rootNode.namedChild(i);
+            if (child?.type === 'export_statement') {
+                this.extractExportStatementSymbols(child, addExport);
+            }
+        }
+        return exports;
+    }
+    /**
+     * Extract symbols from a single export statement
+     */
+    extractExportStatementSymbols(node, addExport) {
+        // Check for default export
+        const defaultKeyword = node.children.find(c => c.type === 'default');
+        if (defaultKeyword) {
+            addExport('default');
+        }
+        // Check for declaration (export function/const/class)
+        const declaration = node.childForFieldName('declaration');
+        if (declaration) {
+            this.extractDeclarationExports(declaration, addExport);
+        }
+        // Check for export clause (export { foo, bar })
+        for (let i = 0; i < node.namedChildCount; i++) {
+            const child = node.namedChild(i);
+            if (child?.type === 'export_clause') {
+                this.extractExportClauseSymbols(child, addExport);
+            }
+        }
+    }
+    /**
+     * Extract exported names from a declaration (function, const, class, interface)
+     */
+    extractDeclarationExports(node, addExport) {
+        // function/class/interface declaration
+        const nameNode = node.childForFieldName('name');
+        if (nameNode) {
+            addExport(nameNode.text);
+            return;
+        }
+        // lexical_declaration: const/let declarations
+        if (node.type === 'lexical_declaration' || node.type === 'variable_declaration') {
+            for (let i = 0; i < node.namedChildCount; i++) {
+                const child = node.namedChild(i);
+                if (child?.type === 'variable_declarator') {
+                    const varName = child.childForFieldName('name');
+                    if (varName) {
+                        addExport(varName.text);
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Extract symbol names from export clause: export { foo, bar as baz }
+     */
+    extractExportClauseSymbols(node, addExport) {
+        for (let i = 0; i < node.namedChildCount; i++) {
+            const child = node.namedChild(i);
+            if (child?.type === 'export_specifier') {
+                // Use alias if present, otherwise use the name
+                const aliasNode = child.childForFieldName('alias');
+                const nameNode = child.childForFieldName('name');
+                const exported = aliasNode?.text || nameNode?.text;
+                if (exported) {
+                    addExport(exported);
+                }
+            }
+        }
+    }
+}
+/**
+ * TypeScript uses the same export extraction as JavaScript
+ */
+export class TypeScriptExportExtractor extends JavaScriptExportExtractor {
+}
+//# sourceMappingURL=javascript.js.map

package/dist/indexer/ast/extractors/javascript.js.map

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

package/dist/indexer/ast/extractors/php.d.ts

@@ -0,0 +1,34 @@
+import type Parser from 'tree-sitter';
+import type { LanguageExportExtractor } from './types.js';
+/**
+ * PHP export extractor
+ *
+ * PHP doesn't have explicit export syntax. All top-level declarations are
+ * considered exported (accessible via `use` statements):
+ * - Classes: class User {}
+ * - Traits: trait HasTimestamps {}
+ * - Interfaces: interface Repository {}
+ * - Functions: function helper() {}
+ * - Namespaced declarations are also tracked
+ */
+export declare class PHPExportExtractor implements LanguageExportExtractor {
+    /**
+     * Node types that represent exportable PHP declarations
+     */
+    private readonly exportableTypes;
+    extractExports(rootNode: Parser.SyntaxNode): string[];
+    /**
+     * Extract PHP exports from a single AST node
+     * Handles both direct declarations and namespace definitions
+     */
+    private extractExportsFromNode;
+    /**
+     * Extract exports from within a PHP namespace definition
+     */
+    private extractExportsFromNamespace;
+    /**
+     * Extract the name from a PHP exportable declaration (class, trait, interface, function)
+     */
+    private extractExportableDeclaration;
+}
+//# sourceMappingURL=php.d.ts.map

package/dist/indexer/ast/extractors/php.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"php.d.ts","sourceRoot":"","sources":["../../../../src/indexer/ast/extractors/php.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,qBAAa,kBAAmB,YAAW,uBAAuB;IAChE;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAK7B;IAEH,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,EAAE;IAoBrD;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAS9B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAiBnC;;OAEG;IACH,OAAO,CAAC,4BAA4B;CAQrC"}

package/dist/indexer/ast/extractors/php.js

@@ -0,0 +1,79 @@
+/**
+ * PHP export extractor
+ *
+ * PHP doesn't have explicit export syntax. All top-level declarations are
+ * considered exported (accessible via `use` statements):
+ * - Classes: class User {}
+ * - Traits: trait HasTimestamps {}
+ * - Interfaces: interface Repository {}
+ * - Functions: function helper() {}
+ * - Namespaced declarations are also tracked
+ */
+export class PHPExportExtractor {
+    /**
+     * Node types that represent exportable PHP declarations
+     */
+    exportableTypes = new Set([
+        'class_declaration',
+        'trait_declaration',
+        'interface_declaration',
+        'function_definition',
+    ]);
+    extractExports(rootNode) {
+        const exports = [];
+        const seen = new Set();
+        for (let i = 0; i < rootNode.namedChildCount; i++) {
+            const child = rootNode.namedChild(i);
+            if (!child)
+                continue;
+            const childExports = this.extractExportsFromNode(child);
+            childExports.forEach(exp => {
+                if (exp && !seen.has(exp)) {
+                    seen.add(exp);
+                    exports.push(exp);
+                }
+            });
+        }
+        return exports;
+    }
+    /**
+     * Extract PHP exports from a single AST node
+     * Handles both direct declarations and namespace definitions
+     */
+    extractExportsFromNode(node) {
+        if (node.type === 'namespace_definition') {
+            return this.extractExportsFromNamespace(node);
+        }
+        const name = this.extractExportableDeclaration(node);
+        return name ? [name] : [];
+    }
+    /**
+     * Extract exports from within a PHP namespace definition
+     */
+    extractExportsFromNamespace(node) {
+        const exports = [];
+        const body = node.childForFieldName('body');
+        if (body) {
+            for (let i = 0; i < body.namedChildCount; i++) {
+                const child = body.namedChild(i);
+                if (child) {
+                    const name = this.extractExportableDeclaration(child);
+                    if (name)
+                        exports.push(name);
+                }
+            }
+        }
+        return exports;
+    }
+    /**
+     * Extract the name from a PHP exportable declaration (class, trait, interface, function)
+     */
+    extractExportableDeclaration(node) {
+        if (this.exportableTypes.has(node.type)) {
+            const nameNode = node.childForFieldName('name');
+            return nameNode ? nameNode.text : null;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=php.js.map

package/dist/indexer/ast/extractors/php.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"php.js","sourceRoot":"","sources":["../../../../src/indexer/ast/extractors/php.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,kBAAkB;IAC7B;;OAEG;IACc,eAAe,GAAG,IAAI,GAAG,CAAC;QACzC,mBAAmB;QACnB,mBAAmB;QACnB,uBAAuB;QACvB,qBAAqB;KACtB,CAAC,CAAC;IAEH,cAAc,CAAC,QAA2B;QACxC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,KAAK;gBAAE,SAAS;YAErB,MAAM,YAAY,GAAG,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;YACxD,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;gBACzB,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACd,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;OAGG;IACK,sBAAsB,CAAC,IAAuB;QACpD,IAAI,IAAI,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,2BAA2B,CAAC,IAAuB;QACzD,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAE5C,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;gBACjC,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,IAAI,GAAG,IAAI,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC;oBACtD,IAAI,IAAI;wBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,4BAA4B,CAAC,IAAuB;QAC1D,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAChD,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACzC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/indexer/ast/extractors/python.d.ts

@@ -0,0 +1,22 @@
+import type Parser from 'tree-sitter';
+import type { LanguageExportExtractor } from './types.js';
+/**
+ * Python export extractor
+ *
+ * Python doesn't have explicit export syntax. All module-level (top-level)
+ * declarations are considered exported (importable by other modules):
+ * - Classes: class User: ...
+ * - Functions: def helper(): ...
+ * - Async functions: async def fetch_data(): ...
+ *
+ * Note: Only top-level definitions are tracked. Nested functions/classes
+ * inside other functions are not considered exports.
+ */
+export declare class PythonExportExtractor implements LanguageExportExtractor {
+    /**
+     * Node types that represent exportable Python declarations
+     */
+    private readonly exportableTypes;
+    extractExports(rootNode: Parser.SyntaxNode): string[];
+}
+//# sourceMappingURL=python.d.ts.map

package/dist/indexer/ast/extractors/python.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../../../src/indexer/ast/extractors/python.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;;;;;;;;GAWG;AACH,qBAAa,qBAAsB,YAAW,uBAAuB;IACnE;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAI7B;IAEH,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,EAAE;CAoCtD"}

package/dist/indexer/ast/extractors/python.js

@@ -0,0 +1,57 @@
+/**
+ * Python export extractor
+ *
+ * Python doesn't have explicit export syntax. All module-level (top-level)
+ * declarations are considered exported (importable by other modules):
+ * - Classes: class User: ...
+ * - Functions: def helper(): ...
+ * - Async functions: async def fetch_data(): ...
+ *
+ * Note: Only top-level definitions are tracked. Nested functions/classes
+ * inside other functions are not considered exports.
+ */
+export class PythonExportExtractor {
+    /**
+     * Node types that represent exportable Python declarations
+     */
+    exportableTypes = new Set([
+        'class_definition',
+        'function_definition',
+        'async_function_definition',
+    ]);
+    extractExports(rootNode) {
+        const exports = [];
+        const seen = new Set();
+        const addExport = (name) => {
+            if (name && !seen.has(name)) {
+                seen.add(name);
+                exports.push(name);
+            }
+        };
+        // Process only top-level nodes (module-level definitions)
+        for (let i = 0; i < rootNode.namedChildCount; i++) {
+            const child = rootNode.namedChild(i);
+            if (!child)
+                continue;
+            // Handle decorated definitions (@dataclass, @property, etc.)
+            // Decorators wrap the actual definition in a 'decorated_definition' node
+            if (child.type === 'decorated_definition') {
+                const definition = child.childForFieldName('definition');
+                if (definition && this.exportableTypes.has(definition.type)) {
+                    const nameNode = definition.childForFieldName('name');
+                    if (nameNode)
+                        addExport(nameNode.text);
+                }
+                continue;
+            }
+            // Extract name from exportable node types
+            if (this.exportableTypes.has(child.type)) {
+                const nameNode = child.childForFieldName('name');
+                if (nameNode)
+                    addExport(nameNode.text);
+            }
+        }
+        return exports;
+    }
+}
+//# sourceMappingURL=python.js.map

package/dist/indexer/ast/extractors/python.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python.js","sourceRoot":"","sources":["../../../../src/indexer/ast/extractors/python.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,qBAAqB;IAChC;;OAEG;IACc,eAAe,GAAG,IAAI,GAAG,CAAC;QACzC,kBAAkB;QAClB,qBAAqB;QACrB,2BAA2B;KAC5B,CAAC,CAAC;IAEH,cAAc,CAAC,QAA2B;QACxC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAE/B,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,EAAE;YACjC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC;QAEF,0DAA0D;QAC1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,KAAK;gBAAE,SAAS;YAErB,6DAA6D;YAC7D,yEAAyE;YACzE,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;gBAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;gBACzD,IAAI,UAAU,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC5D,MAAM,QAAQ,GAAG,UAAU,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;oBACtD,IAAI,QAAQ;wBAAE,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACzC,CAAC;gBACD,SAAS;YACX,CAAC;YAED,0CAA0C;YAC1C,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;gBACjD,IAAI,QAAQ;oBAAE,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/indexer/ast/extractors/types.d.ts

@@ -0,0 +1,52 @@
+import type Parser from 'tree-sitter';
+/**
+ * Language-specific export extraction strategy
+ *
+ * Each language has different export semantics:
+ * - JavaScript/TypeScript: Explicit export statements
+ * - PHP: All top-level declarations are implicitly exported
+ * - Python: All module-level declarations are implicitly exported
+ *
+ * This interface allows us to implement language-specific export extraction
+ * while keeping the core symbol extraction logic language-agnostic.
+ *
+ * @example JavaScript/TypeScript
+ * ```typescript
+ * export function validateEmail() {}  // Explicit export
+ * export { foo, bar }                 // Named exports
+ * export default App                  // Default export
+ * ```
+ *
+ * @example PHP
+ * ```php
+ * class User {}        // Implicitly exported
+ * function helper() {} // Implicitly exported
+ * ```
+ *
+ * @example Python
+ * ```python
+ * class User:          # Implicitly exported
+ *     pass
+ * def helper():        # Implicitly exported
+ *     pass
+ * ```
+ */
+export interface LanguageExportExtractor {
+    /**
+     * Extract exported symbol names from an AST root node
+     *
+     * For JavaScript/TypeScript: Processes explicit export statements
+     * For PHP/Python: Processes top-level declarations (implicitly exported)
+     *
+     * @param rootNode - AST root node (typically 'program' or similar)
+     * @returns Array of exported symbol names (deduplicated)
+     *
+     * @example
+     * ```typescript
+     * // For: export { foo, bar }; export default App;
+     * extractExports(rootNode) // => ['foo', 'bar', 'default']
+     * ```
+     */
+    extractExports(rootNode: Parser.SyntaxNode): string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/indexer/ast/extractors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/indexer/ast/extractors/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC;CACvD"}

package/dist/indexer/ast/extractors/types.js

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

package/dist/indexer/ast/extractors/types.js.map

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

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

@@ -1,5 +1,5 @@
 import type Parser from 'tree-sitter';
-import type { SymbolInfo } from './types.js';
+import type { SymbolInfo, SupportedLanguage } from './types.js';
 /**
  * Extract symbol information from an AST node using specialized extractors
  *
@@ -14,4 +14,75 @@ export declare function extractSymbolInfo(node: Parser.SyntaxNode, content: stri
  * Extract import statements from a file
  */
 export declare function extractImports(rootNode: Parser.SyntaxNode): string[];
+/**
+ * Extract imported symbols mapped to their source paths.
+ *
+ * Returns a map like: { './validate': ['validateEmail', 'validatePhone'] }
+ *
+ * Handles various import styles across languages:
+ *
+ * TypeScript/JavaScript:
+ * - Named imports: import { foo, bar } from './module'
+ * - Default imports: import foo from './module'
+ * - Namespace imports: import * as utils from './module'
+ *
+ * Python:
+ * - from module import foo, bar
+ * - import module (module name as symbol)
+ *
+ * PHP:
+ * - use App\Models\User (class name as symbol)
+ * - use App\Services\AuthService as Auth (aliased imports)
+ *
+ * Note: Only top-level static import statements are processed. Dynamic imports
+ * (e.g., `await import('./module')`) and non-top-level imports are not tracked.
+ * TypeScript/JavaScript side-effect imports without imported symbols (e.g.,
+ * `import './styles.css'`) are also not tracked and will not appear in
+ * `importedSymbols`.
+ */
+export declare function extractImportedSymbols(rootNode: Parser.SyntaxNode): 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())
+ * - PHP: function_call_expression, member_call_expression, scoped_call_expression
+ * - Python: call (similar to JS call_expression)
+ */
+export declare function extractCallSites(node: Parser.SyntaxNode): Array<{
+    symbol: string;
+    line: number;
+}>;
 //# sourceMappingURL=symbols.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../src/indexer/ast/symbols.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA2M7C;;;;;;;;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,CASnB;AAkED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,EAAE,CAoCpE"}
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../src/indexer/ast/symbols.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA4MhE;;;;;;;;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,CASnB;AAkED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,EAAE,CA2CpE;AA+CD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CA0C5F;AAkRD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAKlG;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAMjG"}