@vinaes/succ 1.3.19

package/dist/lib/tree-sitter/parser.js

@@ -0,0 +1,354 @@
+/**
+ * Tree-sitter parser infrastructure.
+ *
+ * Handles:
+ * - web-tree-sitter WASM runtime initialization
+ * - Lazy grammar download to ~/.succ/grammars/
+ * - Parser instance caching per language
+ * - Graceful fallback when grammars are unavailable
+ */
+import fs from 'fs';
+import path from 'path';
+import { getLanguageForExtension, getWasmFileForLanguage } from './types.js';
+// State — lazily initialized
+let ParserClass = null;
+let LanguageClass = null;
+let initialized = false;
+let initPromise = null;
+/** Cache of loaded Language objects by language name */
+const languageCache = new Map();
+/** Per-language parser instances (avoids race conditions with shared parser) */
+const parserPool = new Map();
+const GRAMMAR_CDN_SOURCES = [
+    {
+        // @vscode/tree-sitter-wasm — 16 languages, dylink.0
+        baseUrl: 'https://cdn.jsdelivr.net/npm/@vscode/tree-sitter-wasm@0.3.0/wasm',
+        transformName: (name) => name.replace(/_/g, '-'), // c_sharp → c-sharp
+    },
+    {
+        // @repomix/tree-sitter-wasms — 17 languages, dylink.0
+        baseUrl: 'https://cdn.jsdelivr.net/npm/@repomix/tree-sitter-wasms@0.1.16/out',
+        transformName: (name) => name, // uses same c_sharp naming as us
+    },
+];
+/**
+ * Get the grammars directory path.
+ * Defaults to ~/.succ/grammars/
+ */
+export function getGrammarsDir() {
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    return path.join(home, '.succ', 'grammars');
+}
+/**
+ * Initialize the web-tree-sitter runtime.
+ * This must be called once before any parsing. Safe to call multiple times.
+ */
+export async function initTreeSitter() {
+    if (initialized)
+        return true;
+    if (initPromise) {
+        await initPromise;
+        return initialized;
+    }
+    initPromise = (async () => {
+        try {
+            // Dynamic import — web-tree-sitter is an ESM module with named exports
+            const mod = await import('web-tree-sitter');
+            ParserClass = mod.Parser;
+            LanguageClass = mod.Language;
+            // Locate the WASM file shipped with web-tree-sitter
+            const wasmPath = getTreeSitterWasmPath();
+            await ParserClass.init({
+                locateFile: () => wasmPath,
+            });
+            initialized = true;
+        }
+        catch {
+            initialized = false;
+        }
+    })();
+    await initPromise;
+    return initialized;
+}
+/**
+ * Find the web-tree-sitter.wasm file path.
+ * It ships inside the web-tree-sitter npm package.
+ */
+function getTreeSitterWasmPath() {
+    // ESM-compatible: use import.meta.url to resolve relative to this file
+    try {
+        const thisDir = path.dirname(new URL(import.meta.url).pathname.replace(/^\/([A-Z]:)/, '$1'));
+        const fromThisFile = path.join(thisDir, '..', '..', '..', 'node_modules', 'web-tree-sitter', 'web-tree-sitter.wasm');
+        if (fs.existsSync(fromThisFile))
+            return fromThisFile;
+    }
+    catch {
+        // import.meta.url may not resolve correctly in all environments
+    }
+    // Fallback: look relative to cwd node_modules
+    const fromCwd = path.join(process.cwd(), 'node_modules', 'web-tree-sitter', 'web-tree-sitter.wasm');
+    if (fs.existsSync(fromCwd))
+        return fromCwd;
+    // Last resort — let emscripten try to find it
+    return 'web-tree-sitter.wasm';
+}
+/**
+ * Get (or create) a parser for the given language.
+ * Downloads the grammar WASM if not cached locally.
+ *
+ * @returns Parser instance with language set, or null if unavailable
+ */
+export async function getParserForLanguage(language) {
+    if (!initialized) {
+        const ok = await initTreeSitter();
+        if (!ok)
+            return null;
+    }
+    const lang = await loadLanguage(language);
+    if (!lang)
+        return null;
+    // Use per-language parser to avoid race conditions with concurrent parses
+    let parser = parserPool.get(language);
+    if (!parser && ParserClass) {
+        parser = new ParserClass();
+        parser.setLanguage(lang);
+        parserPool.set(language, parser);
+    }
+    if (!parser)
+        return null;
+    return parser;
+}
+/**
+ * Get a parser for a file by its path (uses extension to detect language).
+ *
+ * @returns [parser, languageName] tuple, or [null, undefined] if unavailable
+ */
+export async function getParserForFile(filePath) {
+    const ext = filePath.split('.').pop() || '';
+    const language = getLanguageForExtension(ext);
+    if (!language)
+        return [null, undefined];
+    const parser = await getParserForLanguage(language);
+    return [parser, language];
+}
+/**
+ * Load a tree-sitter Language object, downloading its grammar if needed.
+ * Results are cached in memory.
+ */
+export async function loadLanguage(language) {
+    // Check memory cache
+    const cached = languageCache.get(language);
+    if (cached)
+        return cached;
+    // Ensure runtime is initialized
+    if (!initialized) {
+        const ok = await initTreeSitter();
+        if (!ok)
+            return null;
+    }
+    if (!LanguageClass)
+        return null;
+    const wasmFileName = getWasmFileForLanguage(language);
+    if (!wasmFileName)
+        return null;
+    // Check if grammar is cached on disk
+    const grammarsDir = getGrammarsDir();
+    const localPath = path.join(grammarsDir, wasmFileName);
+    if (fs.existsSync(localPath)) {
+        try {
+            const lang = await LanguageClass.load(localPath);
+            languageCache.set(language, lang);
+            return lang;
+        }
+        catch {
+            // Corrupted file — delete and re-download
+            try {
+                fs.unlinkSync(localPath);
+            }
+            catch {
+                // intentional
+            }
+        }
+    }
+    // Try to download grammar
+    const downloaded = await downloadGrammar(wasmFileName, localPath);
+    if (!downloaded)
+        return null;
+    try {
+        const lang = await LanguageClass.load(localPath);
+        languageCache.set(language, lang);
+        return lang;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Try to find the grammar WASM in locally installed packages.
+ * Checks @vscode/tree-sitter-wasm and @repomix/tree-sitter-wasms.
+ * Returns the path if found, null otherwise.
+ */
+function findLocalGrammar(wasmFileName) {
+    const vscodeFileName = wasmFileName.replace(/_/g, '-');
+    const roots = [process.cwd()];
+    try {
+        const thisDir = path.dirname(new URL(import.meta.url).pathname.replace(/^\/([A-Z]:)/, '$1'));
+        roots.push(path.resolve(thisDir, '..', '..', '..'));
+    }
+    catch {
+        // import.meta.url may not work in all contexts
+    }
+    for (const root of roots) {
+        const nm = path.join(root, 'node_modules');
+        const candidates = [
+            path.join(nm, '@vscode', 'tree-sitter-wasm', 'wasm', vscodeFileName),
+            path.join(nm, '@repomix', 'tree-sitter-wasms', 'out', wasmFileName),
+            path.join(nm, 'tree-sitter-wasms', 'out', wasmFileName),
+        ];
+        for (const candidate of candidates) {
+            if (fs.existsSync(candidate))
+                return candidate;
+        }
+    }
+    return null;
+}
+/**
+ * Download a grammar WASM file from CDN.
+ * Tries jsdelivr CDN with fallback.
+ * Also checks for locally installed tree-sitter-wasms package first.
+ * Saves to ~/.succ/grammars/{filename}.
+ */
+async function downloadGrammar(wasmFileName, destPath) {
+    // Ensure grammars directory exists
+    const dir = path.dirname(destPath);
+    fs.mkdirSync(dir, { recursive: true });
+    // Strategy 1: Copy from locally installed tree-sitter-wasms package
+    const localPath = findLocalGrammar(wasmFileName);
+    if (localPath) {
+        try {
+            fs.copyFileSync(localPath, destPath);
+            return true;
+        }
+        catch {
+            // Fall through to CDN download
+        }
+    }
+    // Strategy 2: Download from CDN (try each source in order)
+    for (const source of GRAMMAR_CDN_SOURCES) {
+        const remoteFileName = source.transformName(wasmFileName);
+        const url = `${source.baseUrl}/${remoteFileName}`;
+        try {
+            const response = await fetch(url, {
+                redirect: 'follow',
+                signal: AbortSignal.timeout(30_000),
+            });
+            if (!response.ok)
+                continue;
+            const buffer = Buffer.from(await response.arrayBuffer());
+            // Validate WASM magic bytes (\0asm)
+            if (buffer.length < 4 ||
+                buffer[0] !== 0x00 ||
+                buffer[1] !== 0x61 ||
+                buffer[2] !== 0x73 ||
+                buffer[3] !== 0x6d) {
+                continue; // Not a valid WASM file
+            }
+            fs.writeFileSync(destPath, buffer);
+            return true;
+        }
+        catch {
+            // Try next source
+            continue;
+        }
+    }
+    return false;
+}
+/**
+ * Parse source code using tree-sitter.
+ *
+ * @param code - Source code string
+ * @param language - Tree-sitter language name (e.g. "typescript", "python")
+ * @returns Parse tree, or null if parser/grammar unavailable
+ */
+export async function parseCode(code, language) {
+    const parser = await getParserForLanguage(language);
+    if (!parser)
+        return null;
+    try {
+        return parser.parse(code);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse a file by its path.
+ *
+ * @returns [tree, languageName] tuple, or [null, undefined] if unavailable
+ */
+export async function parseFile(filePath, content) {
+    const [parser, language] = await getParserForFile(filePath);
+    if (!parser || !language)
+        return [null, undefined];
+    try {
+        const tree = parser.parse(content);
+        return [tree, language];
+    }
+    catch {
+        return [null, undefined];
+    }
+}
+/**
+ * Check if a grammar is available locally (already downloaded).
+ */
+export function isGrammarCached(language) {
+    const wasmFileName = getWasmFileForLanguage(language);
+    if (!wasmFileName)
+        return false;
+    return fs.existsSync(path.join(getGrammarsDir(), wasmFileName));
+}
+/**
+ * List all locally cached grammars.
+ */
+export function listCachedGrammars() {
+    const dir = getGrammarsDir();
+    if (!fs.existsSync(dir))
+        return [];
+    return fs
+        .readdirSync(dir)
+        .filter((f) => f.endsWith('.wasm'))
+        .map((f) => f.replace('tree-sitter-', '').replace('.wasm', ''));
+}
+/**
+ * Clear all cached grammars.
+ */
+export function clearGrammarCache() {
+    const dir = getGrammarsDir();
+    if (!fs.existsSync(dir))
+        return;
+    for (const file of fs.readdirSync(dir)) {
+        if (file.endsWith('.wasm')) {
+            fs.unlinkSync(path.join(dir, file));
+        }
+    }
+}
+/**
+ * Reset the parser state (useful for testing).
+ */
+export function resetParserState() {
+    for (const parser of parserPool.values()) {
+        try {
+            parser.delete();
+        }
+        catch {
+            // intentional
+        }
+    }
+    parserPool.clear();
+    languageCache.clear();
+    initialized = false;
+    initPromise = null;
+    ParserClass = null;
+    LanguageClass = null;
+}
+//# sourceMappingURL=parser.js.map

package/dist/lib/tree-sitter/parser.js.map

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

package/dist/lib/tree-sitter/public.d.ts

@@ -0,0 +1,28 @@
+/**
+ * High-level tree-sitter API for external consumers (plugins, integrations).
+ *
+ * Wraps low-level parser + extractor into single-call functions.
+ */
+import type { SymbolInfo, SymbolType } from './types.js';
+export interface ExtractSymbolsOptions {
+    /** Filter by symbol type */
+    type?: SymbolType | 'all';
+}
+export interface ExtractSymbolsResult {
+    symbols: SymbolInfo[];
+    language: string;
+    file: string;
+}
+/**
+ * Extract AST symbols from a source file.
+ *
+ * Single-call API: reads file, detects language, parses with tree-sitter,
+ * extracts symbols, and cleans up. Supports 13 languages.
+ *
+ * @param filePath - Absolute or relative path to the source file
+ * @param options - Optional filters (type)
+ * @returns Extracted symbols with metadata
+ * @throws Error if file not found, unsupported language, or parse failure
+ */
+export declare function extractSymbolsFromFile(filePath: string, options?: ExtractSymbolsOptions): Promise<ExtractSymbolsResult>;
+//# sourceMappingURL=public.d.ts.map

package/dist/lib/tree-sitter/public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/lib/tree-sitter/public.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGzD,MAAM,WAAW,qBAAqB;IACpC,4BAA4B;IAC5B,IAAI,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CAoC/B"}

package/dist/lib/tree-sitter/public.js

@@ -0,0 +1,50 @@
+/**
+ * High-level tree-sitter API for external consumers (plugins, integrations).
+ *
+ * Wraps low-level parser + extractor into single-call functions.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { parseCode } from './parser.js';
+import { extractSymbols } from './extractor.js';
+import { getLanguageForExtension } from './types.js';
+import { NotFoundError, ValidationError } from '../errors.js';
+/**
+ * Extract AST symbols from a source file.
+ *
+ * Single-call API: reads file, detects language, parses with tree-sitter,
+ * extracts symbols, and cleans up. Supports 13 languages.
+ *
+ * @param filePath - Absolute or relative path to the source file
+ * @param options - Optional filters (type)
+ * @returns Extracted symbols with metadata
+ * @throws Error if file not found, unsupported language, or parse failure
+ */
+export async function extractSymbolsFromFile(filePath, options = {}) {
+    const absolutePath = path.resolve(filePath);
+    if (!fs.existsSync(absolutePath)) {
+        throw new NotFoundError(`File not found: ${filePath}`);
+    }
+    const content = fs.readFileSync(absolutePath, 'utf-8');
+    const ext = absolutePath.split('.').pop() || '';
+    const language = getLanguageForExtension(ext);
+    if (!language) {
+        throw new ValidationError(`Unsupported language for extension .${ext}. Supported: ts, js, py, go, rs, java, kt, c, cpp, cs, php, rb, swift`);
+    }
+    const tree = await parseCode(content, language);
+    if (!tree) {
+        throw new ValidationError(`Failed to parse ${filePath} — tree-sitter grammar not available for ${language}`);
+    }
+    try {
+        let symbols = await extractSymbols(tree, content, language);
+        const filterType = options.type ?? 'all';
+        if (filterType !== 'all') {
+            symbols = symbols.filter((s) => s.type === filterType);
+        }
+        return { symbols, language, file: filePath };
+    }
+    finally {
+        tree.delete();
+    }
+}
+//# sourceMappingURL=public.js.map

package/dist/lib/tree-sitter/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/lib/tree-sitter/public.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAa9D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAgB,EAChB,UAAiC,EAAE;IAEnC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,aAAa,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAChD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAE9C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,eAAe,CACvB,uCAAuC,GAAG,uEAAuE,CAClH,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,eAAe,CACvB,mBAAmB,QAAQ,4CAA4C,QAAQ,EAAE,CAClF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,IAAI,OAAO,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAE5D,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC;QACzC,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;YACzB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC/C,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/lib/tree-sitter/queries.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tree-sitter S-expression queries for symbol extraction.
+ *
+ * Each language has a query string that captures:
+ * - @definition.function / @definition.method — function/method definitions
+ * - @definition.class — class definitions
+ * - @definition.interface — interface/trait/protocol definitions
+ * - @definition.type — type aliases, enums, structs
+ * - @name — the identifier name within each definition
+ * - @doc — doc comments adjacent to definitions
+ *
+ * These queries are used by extractor.ts to pull structured metadata from AST.
+ */
+/**
+ * Query definitions per language.
+ * Key = tree-sitter language name (matches EXTENSION_TO_LANGUAGE values).
+ */
+export declare const LANGUAGE_QUERIES: Record<string, string>;
+/**
+ * Get the query string for a given language.
+ * Returns undefined if no query is defined for that language.
+ */
+export declare function getQueryForLanguage(language: string): string | undefined;
+/**
+ * Get all languages that have query definitions.
+ */
+export declare function getSupportedQueryLanguages(): string[];
+//# sourceMappingURL=queries.d.ts.map

package/dist/lib/tree-sitter/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/lib/tree-sitter/queries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA2WnD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAErD"}