@liendev/parser 0.39.0

package/dist/ast/languages/registry.js

@@ -0,0 +1,95 @@
+import { extname } from 'path';
+import { typescriptDefinition } from './typescript.js';
+import { javascriptDefinition } from './javascript.js';
+import { phpDefinition } from './php.js';
+import { pythonDefinition } from './python.js';
+import { rustDefinition } from './rust.js';
+/**
+ * All registered language definitions.
+ * To add a new language, create a definition file and add it here.
+ */
+const definitions = [
+    typescriptDefinition,
+    javascriptDefinition,
+    phpDefinition,
+    pythonDefinition,
+    rustDefinition,
+];
+/**
+ * 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 const LANGUAGE_IDS = ['typescript', 'javascript', 'php', 'python', 'rust'];
+/**
+ * Registry keyed by language id.
+ */
+const languageRegistry = new Map();
+const extensionMap = new Map();
+for (const def of definitions) {
+    if (languageRegistry.has(def.id)) {
+        throw new Error(`Duplicate language ID in registry: ${def.id}`);
+    }
+    languageRegistry.set(def.id, def);
+    for (const ext of def.extensions) {
+        if (extensionMap.has(ext)) {
+            throw new Error(`Duplicate extension "${ext}" registered by "${def.id}" (already claimed by "${extensionMap.get(ext)}")`);
+        }
+        extensionMap.set(ext, def.id);
+    }
+}
+// Validate LANGUAGE_IDS has no duplicates and every ID has a definition
+if (new Set(LANGUAGE_IDS).size !== LANGUAGE_IDS.length) {
+    const dupes = [...new Set(LANGUAGE_IDS.filter((id, i) => LANGUAGE_IDS.indexOf(id) !== i))];
+    throw new Error(`LANGUAGE_IDS contains duplicate entries: ${dupes.join(', ')}`);
+}
+for (const id of LANGUAGE_IDS) {
+    if (!languageRegistry.has(id)) {
+        throw new Error(`Language "${id}" is in LANGUAGE_IDS but has no definition in the registry`);
+    }
+}
+/**
+ * Get the full language definition for a supported language.
+ *
+ * @throws Error if language is not registered
+ */
+export function getLanguage(language) {
+    const def = languageRegistry.get(language);
+    if (!def) {
+        throw new Error(`No language definition registered for: ${language}`);
+    }
+    return def;
+}
+/**
+ * Detect which AST-supported language a file belongs to, based on extension.
+ *
+ * @returns SupportedLanguage or null if not AST-supported
+ */
+export function detectLanguage(filePath) {
+    const ext = extname(filePath).slice(1).toLowerCase();
+    return extensionMap.get(ext) ?? null;
+}
+/**
+ * Check if a language is registered (non-throwing).
+ */
+export function languageExists(language) {
+    return languageRegistry.has(language);
+}
+/**
+ * Get all registered language definitions.
+ */
+export function getAllLanguages() {
+    return definitions.slice();
+}
+/**
+ * Get all file extensions supported by registered languages.
+ * Cached after first call.
+ */
+let extensionCache = null;
+export function getSupportedExtensions() {
+    if (!extensionCache) {
+        extensionCache = definitions.flatMap(d => d.extensions);
+    }
+    return extensionCache;
+}
+//# sourceMappingURL=registry.js.map

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

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

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

@@ -0,0 +1,113 @@
+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';
+/**
+ * Rust AST traverser
+ *
+ * Handles Rust AST node types and traversal patterns.
+ * Rust is similar to Python in that functions are always declared with `fn`:
+ * - No variable declarations with functions (unlike JS const x = || {})
+ * - `impl` blocks and `trait` blocks act as containers (like classes)
+ * - Closures exist but are not top-level declarations
+ */
+export declare class RustTraverser 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;
+}
+/**
+ * Rust export extractor
+ *
+ * Rust uses `pub` visibility to mark items as exported. Items with a
+ * `visibility_modifier` child (e.g., `pub`, `pub(crate)`) are considered exports.
+ *
+ * Exportable items:
+ * - pub fn helper() {}
+ * - pub struct User {}
+ * - pub enum Status {}
+ * - pub trait Serialize {}
+ * - pub type Alias = ...
+ * - pub const VALUE: ... = ...
+ * - pub static GLOBAL: ... = ...
+ * - pub mod submodule;
+ * - pub use other::Thing;  (re-exports)
+ */
+export declare class RustExportExtractor implements LanguageExportExtractor {
+    private readonly exportableTypes;
+    extractExports(rootNode: Parser.SyntaxNode): string[];
+    private extractExportName;
+    private hasVisibilityModifier;
+    /**
+     * Extract exported names from a use declaration argument.
+     * Handles both simple patterns and list patterns:
+     * - `pub use crate::auth::AuthService;` -> ["AuthService"]
+     * - `pub use crate::auth::{AuthService, AuthError};` -> ["AuthService", "AuthError"]
+     */
+    private extractUseExportNames;
+}
+/**
+ * Rust import extractor
+ *
+ * Handles all `use` declarations (not just `pub use`).
+ * Every `use` creates a dependency.
+ *
+ * Examples:
+ * - `use crate::auth::AuthService;`
+ * - `use crate::auth::{AuthService, AuthError};`
+ * - `use crate::auth::Service as Auth;`
+ * - `use crate::models::*;`
+ * - `use std::io::Read;` (external - skipped)
+ * - `use super::utils::helper;`
+ */
+export declare class RustImportExtractor implements LanguageImportExtractor {
+    readonly importNodeTypes: string[];
+    extractImportPath(node: Parser.SyntaxNode): string | null;
+    processImportSymbols(node: Parser.SyntaxNode): {
+        importPath: string;
+        symbols: string[];
+    } | null;
+    private processUseArgument;
+    private processScopedIdentifier;
+    private processScopedUseList;
+    private processUseAsClause;
+    private processUseWildcard;
+    /**
+     * Resolve the full path of a use argument for the imports list.
+     * Returns the full `crate::...` path or similar.
+     */
+    private resolveFullPath;
+}
+/**
+ * Rust symbol extractor
+ *
+ * Handles:
+ * - function_item (fn foo() {})
+ * - function_signature_item (fn foo(); in traits)
+ * - impl_item (impl Foo {}) - treated as class equivalent
+ * - trait_item (trait Foo {}) - treated as interface equivalent
+ *
+ * Call sites: call_expression (foo()), macro_invocation (println!())
+ */
+export declare class RustSymbolExtractor 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 extractImplInfo;
+    private extractTraitInfo;
+}
+export declare const rustDefinition: LanguageDefinition;
+//# sourceMappingURL=rust.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rust.d.ts","sourceRoot":"","sources":["../../../src/ast/languages/rust.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;AAYhC;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,iBAAiB;IACrD,eAAe,WAAgD;IAE/D,cAAc,WAA+B;IAE7C,gBAAgB,EAAE,MAAM,EAAE,CAAM;IAEhC,aAAa,WAA0B;IAEvC,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;IAMxD,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,SAAS;IAgBpE,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,GAAG,uBAAuB;CAM7E;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAoB,YAAW,uBAAuB;IACjE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAS7B;IAEH,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,EAAE;IAsBrD,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,qBAAqB;IAQ7B;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CAmB9B;AA2FD;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAoB,YAAW,uBAAuB;IACjE,QAAQ,CAAC,eAAe,WAAuB;IAE/C,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,IAAI;IAQzD,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,GAAG;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI;IAO/F,OAAO,CAAC,kBAAkB;IA+B1B,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,oBAAoB;IAyB5B,OAAO,CAAC,kBAAkB;IA8B1B,OAAO,CAAC,kBAAkB;IAoB1B;;;OAGG;IACH,OAAO,CAAC,eAAe;CA6BxB;AAMD;;;;;;;;;;GAUG;AACH,qBAAa,mBAAoB,YAAW,uBAAuB;IACjE,QAAQ,CAAC,eAAe,WAKtB;IAEF,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAchG,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;IAmC9F,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,gBAAgB;CAYzB;AAMD,eAAO,MAAM,cAAc,EAAE,kBA6G5B,CAAC"}