@liendev/parser 0.39.0

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

@@ -0,0 +1,96 @@
+import type Parser from 'tree-sitter';
+import type { SymbolInfo } from '../types.js';
+import type { LanguageDefinition } from './types.js';
+import type { LanguageTraverser, DeclarationFunctionInfo } from '../traversers/types.js';
+import type { LanguageExportExtractor, LanguageImportExtractor, LanguageSymbolExtractor } from '../extractors/types.js';
+/**
+ * Python AST traverser
+ *
+ * Handles Python AST node types and traversal patterns.
+ * Python has a simpler structure than TypeScript/JavaScript:
+ * - Functions are defined with 'def' or 'async def'
+ * - No variable declarations with functions (unlike JS const x = () => {})
+ * - Classes contain methods (which are just functions)
+ */
+export declare class PythonTraverser implements LanguageTraverser {
+    targetNodeTypes: string[];
+    containerTypes: string[];
+    declarationTypes: string[];
+    functionTypes: string[];
+    shouldExtractChildren(node: Parser.SyntaxNode): boolean;
+    isDeclarationWithFunction(_node: Parser.SyntaxNode): boolean;
+    getContainerBody(node: Parser.SyntaxNode): Parser.SyntaxNode | null;
+    shouldTraverseChildren(node: Parser.SyntaxNode): boolean;
+    findParentContainerName(node: Parser.SyntaxNode): string | undefined;
+    findFunctionInDeclaration(_node: Parser.SyntaxNode): DeclarationFunctionInfo;
+}
+/**
+ * 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(): ...
+ */
+export declare class PythonExportExtractor implements LanguageExportExtractor {
+    private readonly exportableTypes;
+    private extractExportName;
+    extractExports(rootNode: Parser.SyntaxNode): string[];
+    private findModulePathIndex;
+    private extractReExportNames;
+}
+/**
+ * Python import extractor
+ *
+ * Handles:
+ * - import os
+ * - import os as system
+ * - from utils.validate import validateEmail, validatePhone
+ * - from typing import Optional as Opt
+ */
+export declare class PythonImportExtractor implements LanguageImportExtractor {
+    readonly importNodeTypes: string[];
+    extractImportPath(node: Parser.SyntaxNode): string | null;
+    processImportSymbols(node: Parser.SyntaxNode): {
+        importPath: string;
+        symbols: string[];
+    } | null;
+    private processSimpleImport;
+    private processAliasedImport;
+    /**
+     * Process Python regular import statement.
+     * e.g., "import os", "import os as system"
+     */
+    private processPythonImport;
+    private findModulePath;
+    private collectImportedSymbols;
+    /**
+     * Process Python from...import statement.
+     * e.g., "from utils.validate import validateEmail, validatePhone"
+     */
+    private processPythonFromImport;
+}
+/**
+ * Python symbol extractor
+ *
+ * Handles:
+ * - function_definition (def foo():)
+ * - async_function_definition (async def foo():)
+ * - class_definition (class Foo:)
+ *
+ * Call sites: call (foo(), obj.method())
+ */
+export declare class PythonSymbolExtractor implements LanguageSymbolExtractor {
+    readonly symbolNodeTypes: string[];
+    extractSymbol(node: Parser.SyntaxNode, content: string, parentClass?: string): SymbolInfo | null;
+    extractCallSite(node: Parser.SyntaxNode): {
+        symbol: string;
+        line: number;
+        key: string;
+    } | null;
+    private extractFunctionInfo;
+    private extractClassInfo;
+}
+export declare const pythonDefinition: LanguageDefinition;
+//# sourceMappingURL=python.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"python.d.ts","sourceRoot":"","sources":["../../../src/ast/languages/python.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,wBAAwB,CAAC;AA+BhC;;;;;;;;GAQG;AACH,qBAAa,eAAgB,YAAW,iBAAiB;IACvD,eAAe,WAAwD;IAEvE,cAAc,WAEZ;IAEF,gBAAgB,EAAE,MAAM,EAAE,CAAM;IAEhC,aAAa,WAAwD;IAErE,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO;IAIvD,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO;IAI5D,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,GAAG,IAAI;IAOnE,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO;IAIxD,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,SAAS;IAYpE,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,GAAG,uBAAuB;CAM7E;AAMD;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,YAAW,uBAAuB;IACnE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAI7B;IAEH,OAAO,CAAC,iBAAiB;IAgBzB,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,EAAE;IA8BrD,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,oBAAoB;CAgB7B;AAMD;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,YAAW,uBAAuB;IACnE,QAAQ,CAAC,eAAe,WAAiD;IAEzE,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI;IAKzD,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI;IAU/F,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,oBAAoB;IAc5B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,sBAAsB;IAgB9B;;;OAGG;IACH,OAAO,CAAC,uBAAuB;CAWhC;AAMD;;;;;;;;;GASG;AACH,qBAAa,qBAAsB,YAAW,uBAAuB;IACnE,QAAQ,CAAC,eAAe,WAItB;IAEF,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAYhG,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAuB9F,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,gBAAgB;CAYzB;AAMD,eAAO,MAAM,gBAAgB,EAAE,kBA8G9B,CAAC"}

package/dist/ast/languages/python.js

@@ -0,0 +1,448 @@
+import Python from 'tree-sitter-python';
+import { extractSignature, extractParameters } from '../extractors/symbol-helpers.js';
+import { calculateComplexity } from '../complexity/index.js';
+// =============================================================================
+// SHARED HELPERS
+// =============================================================================
+/**
+ * Extract the effective symbol name from a Python aliased_import node.
+ * Returns the alias if present, otherwise the original name.
+ */
+function extractAliasedSymbolName(node) {
+    const identifiers = node.namedChildren.filter(c => c.type === 'identifier');
+    if (identifiers.length >= 2) {
+        return identifiers[identifiers.length - 1].text;
+    }
+    if (identifiers.length === 1) {
+        return identifiers[0].text;
+    }
+    const dottedName = node.namedChildren.find(c => c.type === 'dotted_name');
+    return dottedName?.text ?? null;
+}
+// =============================================================================
+// TRAVERSER
+// =============================================================================
+/**
+ * Python AST traverser
+ *
+ * Handles Python AST node types and traversal patterns.
+ * Python has a simpler structure than TypeScript/JavaScript:
+ * - Functions are defined with 'def' or 'async def'
+ * - No variable declarations with functions (unlike JS const x = () => {})
+ * - Classes contain methods (which are just functions)
+ */
+export class PythonTraverser {
+    targetNodeTypes = ['function_definition', 'async_function_definition'];
+    containerTypes = [
+        'class_definition', // We extract methods, not the class itself
+    ];
+    declarationTypes = [];
+    functionTypes = ['function_definition', 'async_function_definition'];
+    shouldExtractChildren(node) {
+        return this.containerTypes.includes(node.type);
+    }
+    isDeclarationWithFunction(_node) {
+        return false;
+    }
+    getContainerBody(node) {
+        if (node.type === 'class_definition') {
+            return node.childForFieldName('body');
+        }
+        return null;
+    }
+    shouldTraverseChildren(node) {
+        return node.type === 'module' || node.type === 'block';
+    }
+    findParentContainerName(node) {
+        let current = node.parent;
+        while (current) {
+            if (current.type === 'class_definition') {
+                const nameNode = current.childForFieldName('name');
+                return nameNode?.text;
+            }
+            current = current.parent;
+        }
+        return undefined;
+    }
+    findFunctionInDeclaration(_node) {
+        return {
+            hasFunction: false,
+            functionNode: null,
+        };
+    }
+}
+// =============================================================================
+// EXPORT EXTRACTOR
+// =============================================================================
+/**
+ * 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(): ...
+ */
+export class PythonExportExtractor {
+    exportableTypes = new Set([
+        'class_definition',
+        'function_definition',
+        'async_function_definition',
+    ]);
+    extractExportName(node) {
+        if (node.type === 'decorated_definition') {
+            const definition = node.childForFieldName('definition');
+            if (definition && this.exportableTypes.has(definition.type)) {
+                return definition.childForFieldName('name')?.text ?? null;
+            }
+            return null;
+        }
+        if (this.exportableTypes.has(node.type)) {
+            return node.childForFieldName('name')?.text ?? null;
+        }
+        return null;
+    }
+    extractExports(rootNode) {
+        const exports = [];
+        const seen = new Set();
+        const addExport = (name) => {
+            if (name && !seen.has(name)) {
+                seen.add(name);
+                exports.push(name);
+            }
+        };
+        for (let i = 0; i < rootNode.namedChildCount; i++) {
+            const child = rootNode.namedChild(i);
+            if (!child)
+                continue;
+            const name = this.extractExportName(child);
+            if (name) {
+                addExport(name);
+                continue;
+            }
+            // Re-exports via `from .module import Symbol`
+            if (child.type === 'import_from_statement') {
+                this.extractReExportNames(child, addExport);
+            }
+        }
+        return exports;
+    }
+    findModulePathIndex(node) {
+        for (let i = 0; i < node.namedChildCount; i++) {
+            const type = node.namedChild(i)?.type;
+            if (type === 'relative_import' || type === 'dotted_name') {
+                return i;
+            }
+        }
+        return -1;
+    }
+    extractReExportNames(node, addExport) {
+        const startIndex = this.findModulePathIndex(node);
+        if (startIndex === -1)
+            return;
+        for (let i = startIndex + 1; i < node.namedChildCount; i++) {
+            const child = node.namedChild(i);
+            if (!child)
+                continue;
+            if (child.type === 'dotted_name') {
+                addExport(child.text);
+            }
+            else if (child.type === 'aliased_import') {
+                const name = extractAliasedSymbolName(child);
+                if (name)
+                    addExport(name);
+            }
+        }
+    }
+}
+// =============================================================================
+// IMPORT EXTRACTOR
+// =============================================================================
+/**
+ * Python import extractor
+ *
+ * Handles:
+ * - import os
+ * - import os as system
+ * - from utils.validate import validateEmail, validatePhone
+ * - from typing import Optional as Opt
+ */
+export class PythonImportExtractor {
+    importNodeTypes = ['import_statement', 'import_from_statement'];
+    extractImportPath(node) {
+        // Return the raw text for Python imports (used in the imports list)
+        return node.text.split('\n')[0];
+    }
+    processImportSymbols(node) {
+        if (node.type === 'import_statement') {
+            return this.processPythonImport(node);
+        }
+        if (node.type === 'import_from_statement') {
+            return this.processPythonFromImport(node);
+        }
+        return null;
+    }
+    processSimpleImport(child) {
+        return {
+            importPath: child.text,
+            symbols: [child.text],
+        };
+    }
+    processAliasedImport(child) {
+        const dottedName = child.namedChildren.find(c => c.type === 'dotted_name');
+        const identifiers = child.namedChildren.filter(c => c.type === 'identifier');
+        const moduleName = dottedName?.text || identifiers[0]?.text;
+        const aliasName = identifiers.length >= 2 ? identifiers[identifiers.length - 1]?.text : identifiers[0]?.text;
+        if (!moduleName || !aliasName)
+            return null;
+        return { importPath: moduleName, symbols: [aliasName] };
+    }
+    /**
+     * Process Python regular import statement.
+     * e.g., "import os", "import os as system"
+     */
+    processPythonImport(node) {
+        for (let i = 0; i < node.namedChildCount; i++) {
+            const child = node.namedChild(i);
+            if (!child)
+                continue;
+            if (child.type === 'dotted_name' || child.type === 'identifier') {
+                return this.processSimpleImport(child);
+            }
+            if (child.type === 'aliased_import') {
+                return this.processAliasedImport(child);
+            }
+        }
+        return null;
+    }
+    findModulePath(node) {
+        for (let i = 0; i < node.namedChildCount; i++) {
+            const child = node.namedChild(i);
+            if (child?.type === 'dotted_name') {
+                return { path: child.text, startIndex: i };
+            }
+        }
+        return null;
+    }
+    collectImportedSymbols(node, startIndex) {
+        const symbols = [];
+        for (let i = startIndex + 1; i < node.namedChildCount; i++) {
+            const child = node.namedChild(i);
+            if (!child)
+                continue;
+            if (child.type === 'dotted_name') {
+                symbols.push(child.text);
+            }
+            else if (child.type === 'aliased_import') {
+                const symbolName = extractAliasedSymbolName(child);
+                if (symbolName)
+                    symbols.push(symbolName);
+            }
+        }
+        return symbols;
+    }
+    /**
+     * Process Python from...import statement.
+     * e.g., "from utils.validate import validateEmail, validatePhone"
+     */
+    processPythonFromImport(node) {
+        const moduleInfo = this.findModulePath(node);
+        if (!moduleInfo)
+            return null;
+        const symbols = this.collectImportedSymbols(node, moduleInfo.startIndex);
+        if (symbols.length === 0)
+            return null;
+        return { importPath: moduleInfo.path, symbols };
+    }
+}
+// =============================================================================
+// SYMBOL EXTRACTOR
+// =============================================================================
+/**
+ * Python symbol extractor
+ *
+ * Handles:
+ * - function_definition (def foo():)
+ * - async_function_definition (async def foo():)
+ * - class_definition (class Foo:)
+ *
+ * Call sites: call (foo(), obj.method())
+ */
+export class PythonSymbolExtractor {
+    symbolNodeTypes = [
+        'function_definition',
+        'async_function_definition',
+        'class_definition',
+    ];
+    extractSymbol(node, content, parentClass) {
+        switch (node.type) {
+            case 'function_definition':
+            case 'async_function_definition':
+                return this.extractFunctionInfo(node, content, parentClass);
+            case 'class_definition':
+                return this.extractClassInfo(node);
+            default:
+                return null;
+        }
+    }
+    extractCallSite(node) {
+        if (node.type !== 'call')
+            return null;
+        const line = node.startPosition.row + 1;
+        const funcNode = node.childForFieldName('function');
+        if (!funcNode)
+            return null;
+        // Direct function call: foo()
+        if (funcNode.type === 'identifier') {
+            return { symbol: funcNode.text, line, key: `${funcNode.text}:${line}` };
+        }
+        // Attribute access: obj.method() - extract 'method'
+        if (funcNode.type === 'attribute') {
+            const attrNode = funcNode.childForFieldName('attribute');
+            if (attrNode?.type === 'identifier') {
+                return { symbol: attrNode.text, line, key: `${attrNode.text}:${line}` };
+            }
+        }
+        return null;
+    }
+    extractFunctionInfo(node, content, parentClass) {
+        const nameNode = node.childForFieldName('name');
+        if (!nameNode)
+            return null;
+        return {
+            name: nameNode.text,
+            type: parentClass ? 'method' : 'function',
+            startLine: node.startPosition.row + 1,
+            endLine: node.endPosition.row + 1,
+            parentClass,
+            signature: extractSignature(node, content),
+            parameters: extractParameters(node, content),
+            complexity: calculateComplexity(node),
+        };
+    }
+    extractClassInfo(node) {
+        const nameNode = node.childForFieldName('name');
+        if (!nameNode)
+            return null;
+        return {
+            name: nameNode.text,
+            type: 'class',
+            startLine: node.startPosition.row + 1,
+            endLine: node.endPosition.row + 1,
+            signature: `class ${nameNode.text}`,
+        };
+    }
+}
+// =============================================================================
+// LANGUAGE DEFINITION
+// =============================================================================
+export const pythonDefinition = {
+    id: 'python',
+    extensions: ['py'],
+    grammar: Python,
+    traverser: new PythonTraverser(),
+    exportExtractor: new PythonExportExtractor(),
+    importExtractor: new PythonImportExtractor(),
+    symbolExtractor: new PythonSymbolExtractor(),
+    complexity: {
+        decisionPoints: [
+            'if_statement',
+            'while_statement',
+            'for_statement',
+            'switch_case',
+            'catch_clause',
+            'ternary_expression',
+            'binary_expression',
+            'elif_clause',
+            'except_clause',
+            'conditional_expression',
+        ],
+        nestingTypes: ['if_statement', 'for_statement', 'while_statement', 'except_clause'],
+        nonNestingTypes: ['elif_clause', 'conditional_expression'],
+        lambdaTypes: ['lambda'],
+        operatorSymbols: new Set([
+            '+',
+            '-',
+            '*',
+            '/',
+            '%',
+            '**',
+            '//',
+            '==',
+            '!=',
+            '<',
+            '>',
+            '<=',
+            '>=',
+            '=',
+            '+=',
+            '-=',
+            '*=',
+            '/=',
+            '%=',
+            '**=',
+            '//=',
+            '&=',
+            '|=',
+            '^=',
+            '<<=',
+            '>>=',
+            '&',
+            '|',
+            '^',
+            '~',
+            '<<',
+            '>>',
+            '.',
+            ':',
+            '->',
+            '@',
+            '(',
+            ')',
+            '[',
+            ']',
+            '{',
+            '}',
+        ]),
+        operatorKeywords: new Set([
+            'if',
+            'elif',
+            'else',
+            'for',
+            'while',
+            'match',
+            'case',
+            'return',
+            'raise',
+            'try',
+            'except',
+            'finally',
+            'and',
+            'or',
+            'not',
+            'is',
+            'in',
+            'await',
+            'yield',
+            'break',
+            'continue',
+            'pass',
+            'def',
+            'class',
+            'lambda',
+            'async',
+            'import',
+            'from',
+            'as',
+            'with',
+            'global',
+            'nonlocal',
+            'del',
+            'assert',
+        ]),
+    },
+    symbols: {
+        callExpressionTypes: ['call'],
+    },
+};
+//# sourceMappingURL=python.js.map

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

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

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

@@ -0,0 +1,30 @@
+import type { LanguageDefinition } from './types.js';
+/**
+ * Canonical list of supported language IDs.
+ * SupportedLanguage type is derived from this array.
+ * To add a new language: add its ID here, then add its definition to `definitions` below.
+ */
+export declare const LANGUAGE_IDS: readonly ["typescript", "javascript", "php", "python", "rust"];
+export type SupportedLanguage = (typeof LANGUAGE_IDS)[number];
+/**
+ * Get the full language definition for a supported language.
+ *
+ * @throws Error if language is not registered
+ */
+export declare function getLanguage(language: SupportedLanguage): LanguageDefinition;
+/**
+ * Detect which AST-supported language a file belongs to, based on extension.
+ *
+ * @returns SupportedLanguage or null if not AST-supported
+ */
+export declare function detectLanguage(filePath: string): SupportedLanguage | null;
+/**
+ * Check if a language is registered (non-throwing).
+ */
+export declare function languageExists(language: string): boolean;
+/**
+ * Get all registered language definitions.
+ */
+export declare function getAllLanguages(): readonly LanguageDefinition[];
+export declare function getSupportedExtensions(): string[];
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/ast/languages/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAmBrD;;;;GAIG;AACH,eAAO,MAAM,YAAY,gEAAiE,CAAC;AAC3F,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAmC9D;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,iBAAiB,GAAG,kBAAkB,CAM3E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAGzE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,SAAS,kBAAkB,EAAE,CAE/D;AAQD,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAKjD"}