@plebeiantech/lat.md 0.12.3-fork.17 → 0.12.3-fork.20

package/dist/src/source-parser.js

@@ -1,1749 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { dirname, join } from 'node:path';
-import { createRequire } from 'node:module';
-import { performance } from 'node:perf_hooks';
-import { PARSER_CACHE_VERSION, hashParserContent, parsedCachePath, parserCacheIdentity, readParsedCache, writeParsedCache, } from './parser-cache.js';
-import { Parser, Language, } from 'web-tree-sitter';
-import { sourceFileExtension, } from './source-formats.js';
-// Lazy singleton for the parser
-let parserReady = null;
-let parserInstance = null;
-const languages = new Map();
-function wasmDir() {
-    const require = createRequire(import.meta.url);
-    const pkgPath = require.resolve('@repomix/tree-sitter-wasms/package.json');
-    return join(dirname(pkgPath), 'out');
-}
-async function ensureParser() {
-    if (!parserReady) {
-        parserReady = Parser.init();
-    }
-    await parserReady;
-    if (!parserInstance) {
-        parserInstance = new Parser();
-    }
-    return parserInstance;
-}
-/** Every supported source extension must declare a tree-sitter grammar. */
-const grammarMap = {
-    '.c': 'tree-sitter-c.wasm',
-    '.dart': 'tree-sitter-dart.wasm',
-    '.erb': 'tree-sitter-ruby.wasm',
-    '.go': 'tree-sitter-go.wasm',
-    '.h': 'tree-sitter-c.wasm',
-    '.java': 'tree-sitter-java.wasm',
-    '.js': 'tree-sitter-javascript.wasm',
-    '.jsx': 'tree-sitter-javascript.wasm',
-    '.php': 'tree-sitter-php.wasm',
-    '.py': 'tree-sitter-python.wasm',
-    '.rake': 'tree-sitter-ruby.wasm',
-    '.rb': 'tree-sitter-ruby.wasm',
-    '.rs': 'tree-sitter-rust.wasm',
-    '.ts': 'tree-sitter-typescript.wasm',
-    '.tsx': 'tree-sitter-tsx.wasm',
-};
-async function getLanguage(ext) {
-    const wasmFile = grammarMap[ext];
-    // Ensure WASM runtime is initialized before loading languages
-    await ensureParser();
-    if (!languages.has(wasmFile)) {
-        const wasmPath = join(wasmDir(), wasmFile);
-        const lang = await Language.load(wasmPath);
-        languages.set(wasmFile, lang);
-    }
-    return languages.get(wasmFile);
-}
-function extractName(node) {
-    const nameNode = node.childForFieldName('name');
-    return nameNode ? nameNode.text : null;
-}
-function extractTsSymbols(tree) {
-    const symbols = [];
-    const root = tree.rootNode;
-    for (let i = 0; i < root.childCount; i++) {
-        let node = root.child(i);
-        // Unwrap export_statement to get the inner declaration
-        const isExport = node.type === 'export_statement';
-        if (isExport) {
-            const inner = node.namedChildren.find((c) => c.type === 'function_declaration' ||
-                c.type === 'class_declaration' ||
-                c.type === 'lexical_declaration' ||
-                c.type === 'type_alias_declaration' ||
-                c.type === 'interface_declaration' ||
-                c.type === 'abstract_class_declaration');
-            if (inner)
-                node = inner;
-        }
-        const startLine = node.startPosition.row + 1;
-        const endLine = node.endPosition.row + 1;
-        if (node.type === 'function_declaration' ||
-            node.type === 'generator_function_declaration') {
-            const name = extractName(node);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'function',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-        }
-        else if (node.type === 'class_declaration' ||
-            node.type === 'abstract_class_declaration') {
-            const name = extractName(node);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'class',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-                // Extract methods
-                const body = node.childForFieldName('body');
-                if (body) {
-                    extractClassMethods(body, name, symbols);
-                }
-            }
-        }
-        else if (node.type === 'lexical_declaration') {
-            // const/let declarations
-            for (const decl of node.namedChildren) {
-                if (decl.type === 'variable_declarator') {
-                    const name = extractName(decl);
-                    if (name) {
-                        symbols.push({
-                            name,
-                            kind: 'const',
-                            startLine,
-                            endLine,
-                            signature: firstLine(node.text),
-                        });
-                    }
-                }
-            }
-        }
-        else if (node.type === 'type_alias_declaration') {
-            const name = extractName(node);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'type',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-        }
-        else if (node.type === 'interface_declaration') {
-            const name = extractName(node);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'interface',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-        }
-    }
-    return symbols;
-}
-function extractClassMethods(body, className, symbols) {
-    for (let i = 0; i < body.namedChildCount; i++) {
-        const member = body.namedChild(i);
-        if (member.type === 'method_definition' ||
-            member.type === 'public_field_definition') {
-            const name = extractName(member);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'method',
-                    parent: className,
-                    startLine: member.startPosition.row + 1,
-                    endLine: member.endPosition.row + 1,
-                    signature: firstLine(member.text),
-                });
-            }
-        }
-    }
-}
-function extractPySymbols(tree) {
-    const symbols = [];
-    const root = tree.rootNode;
-    for (let i = 0; i < root.childCount; i++) {
-        const node = root.child(i);
-        const startLine = node.startPosition.row + 1;
-        const endLine = node.endPosition.row + 1;
-        // Unwrap decorated_definition to get the inner function/class
-        const inner = node.type === 'decorated_definition'
-            ? node.childForFieldName('definition')
-            : node;
-        if (!inner)
-            continue;
-        if (inner.type === 'function_definition') {
-            const name = extractName(inner);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'function',
-                    startLine,
-                    endLine,
-                    signature: firstLine(inner.text),
-                });
-            }
-        }
-        else if (inner.type === 'class_definition') {
-            const name = extractName(inner);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'class',
-                    startLine,
-                    endLine,
-                    signature: firstLine(inner.text),
-                });
-                // Extract methods
-                const body = inner.childForFieldName('body');
-                if (body) {
-                    for (let j = 0; j < body.namedChildCount; j++) {
-                        let member = body.namedChild(j);
-                        // Unwrap decorated methods
-                        if (member.type === 'decorated_definition') {
-                            member = member.childForFieldName('definition') ?? member;
-                        }
-                        if (member.type === 'function_definition') {
-                            const methodName = extractName(member);
-                            if (methodName) {
-                                symbols.push({
-                                    name: methodName,
-                                    kind: 'method',
-                                    parent: name,
-                                    startLine: member.startPosition.row + 1,
-                                    endLine: member.endPosition.row + 1,
-                                    signature: firstLine(member.text),
-                                });
-                            }
-                        }
-                    }
-                }
-            }
-        }
-        else if (inner.type === 'expression_statement' &&
-            inner.namedChildCount === 1 &&
-            inner.namedChild(0).type === 'assignment') {
-            // Top-level assignment: FOO = ...
-            const assign = inner.namedChild(0);
-            const left = assign.childForFieldName('left');
-            if (left && left.type === 'identifier') {
-                symbols.push({
-                    name: left.text,
-                    kind: 'variable',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-        }
-    }
-    return symbols;
-}
-function collectRubyScope(scope, parent, symbols) {
-    for (const node of scope.namedChildren) {
-        const startLine = node.startPosition.row + 1;
-        const endLine = node.endPosition.row + 1;
-        const signature = firstLine(node.text);
-        if (node.type === 'class' || node.type === 'module') {
-            const nameNode = node.childForFieldName('name');
-            if (nameNode) {
-                let childPart;
-                let parentPart;
-                if (nameNode.type === 'scope_resolution' &&
-                    nameNode.namedChildren.length === 2) {
-                    parentPart = nameNode.namedChildren[0].text;
-                    childPart = nameNode.namedChildren[1].text;
-                    symbols.push({
-                        name: childPart,
-                        kind: 'class',
-                        startLine,
-                        endLine,
-                        signature,
-                    });
-                    symbols.push({
-                        name: childPart,
-                        kind: 'class',
-                        parent: parentPart,
-                        startLine,
-                        endLine,
-                        signature,
-                    });
-                }
-                else {
-                    childPart = nameNode.text;
-                    symbols.push({
-                        name: childPart,
-                        kind: 'class',
-                        startLine,
-                        endLine,
-                        signature,
-                    });
-                    if (parent) {
-                        symbols.push({
-                            name: childPart,
-                            kind: 'class',
-                            parent,
-                            startLine,
-                            endLine,
-                            signature,
-                        });
-                    }
-                }
-                const body = node.childForFieldName('body');
-                if (body) {
-                    collectRubyScope(body, childPart, symbols);
-                }
-            }
-        }
-        else if (node.type === 'method' || node.type === 'singleton_method') {
-            const name = extractName(node);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: parent ? 'method' : 'function',
-                    ...(parent ? { parent } : {}),
-                    startLine,
-                    endLine,
-                    signature,
-                });
-            }
-        }
-        else if (node.type === 'assignment') {
-            const left = node.childForFieldName('left');
-            if (left) {
-                if (left.type === 'scope_resolution' &&
-                    left.namedChildren.length === 2) {
-                    const parentPart = left.namedChildren[0].text;
-                    const childPart = left.namedChildren[1].text;
-                    symbols.push({
-                        name: childPart,
-                        kind: 'const',
-                        startLine,
-                        endLine,
-                        signature,
-                    });
-                    symbols.push({
-                        name: childPart,
-                        kind: 'const',
-                        parent: parentPart,
-                        startLine,
-                        endLine,
-                        signature,
-                    });
-                }
-                else if (left.type === 'constant' ||
-                    (left.type === 'identifier' && /^[A-Z]/.test(left.text))) {
-                    const name = left.text;
-                    symbols.push({
-                        name,
-                        kind: 'const',
-                        startLine,
-                        endLine,
-                        signature,
-                    });
-                    if (parent) {
-                        symbols.push({
-                            name,
-                            kind: 'const',
-                            parent,
-                            startLine,
-                            endLine,
-                            signature,
-                        });
-                    }
-                }
-            }
-        }
-        else if (node.type === 'call') {
-            const methodNode = node.childForFieldName('method');
-            const methodName = methodNode?.text;
-            if (methodName === 'task' ||
-                methodName === 'multitask' ||
-                methodName === 'file') {
-                const name = extractRubyRakeName(node);
-                if (name) {
-                    symbols.push({
-                        name,
-                        kind: parent ? 'method' : 'function',
-                        ...(parent ? { parent } : {}),
-                        startLine,
-                        endLine,
-                        signature,
-                    });
-                }
-            }
-            else if (methodName === 'namespace') {
-                const name = extractRubyRakeName(node);
-                if (name) {
-                    symbols.push({
-                        name,
-                        kind: 'class',
-                        startLine,
-                        endLine,
-                        signature,
-                    });
-                    if (parent) {
-                        symbols.push({
-                            name,
-                            kind: 'class',
-                            parent,
-                            startLine,
-                            endLine,
-                            signature,
-                        });
-                    }
-                    const block = node.childForFieldName('block') ??
-                        node.namedChildren.find((n) => n.type === 'do_block' || n.type === 'block');
-                    if (block) {
-                        const body = block.childForFieldName('body') ??
-                            block.namedChildren.find((n) => n.type === 'body_statement' || n.type === 'block_body') ??
-                            block;
-                        collectRubyScope(body, name, symbols);
-                    }
-                }
-            }
-        }
-    }
-}
-function extractRubyRakeName(node) {
-    const args = node.childForFieldName('arguments');
-    if (!args || args.namedChildren.length === 0)
-        return null;
-    let first = args.namedChildren[0];
-    if (first.type === 'pair') {
-        first = first.childForFieldName('key') ?? first.namedChildren[0];
-    }
-    if (!first)
-        return null;
-    if (first.type === 'simple_symbol') {
-        return first.text.replace(/^:/, '');
-    }
-    if (first.type === 'hash_key_symbol') {
-        return first.text.replace(/:$/, '');
-    }
-    if (first.type === 'string') {
-        const content = first.namedChildren.find((c) => c.type === 'string_content');
-        return content ? content.text : first.text.replace(/^['"]|['"]$/g, '');
-    }
-    if (first.type === 'identifier') {
-        return first.text;
-    }
-    return null;
-}
-function extractRubySymbols(tree) {
-    const symbols = [];
-    collectRubyScope(tree.rootNode, undefined, symbols);
-    return symbols;
-}
-function dartDirectChild(node, type) {
-    return node.namedChildren.find((child) => child.type === type) ?? null;
-}
-function dartDefinitionName(node) {
-    const fieldName = extractName(node);
-    if (fieldName)
-        return fieldName;
-    if (node.type === 'class_definition') {
-        const alias = dartDirectChild(node, 'mixin_application_class');
-        return alias ? (dartDirectChild(alias, 'identifier')?.text ?? null) : null;
-    }
-    if (node.type === 'type_alias') {
-        return dartDirectChild(node, 'type_identifier')?.text ?? null;
-    }
-    return dartDirectChild(node, 'identifier')?.text ?? null;
-}
-function dartCallableNode(node) {
-    if (node.type !== 'method_signature' && node.type !== 'declaration') {
-        return node;
-    }
-    return (node.namedChildren.find((child) => [
-        'constructor_signature',
-        'factory_constructor_signature',
-        'function_signature',
-        'getter_signature',
-        'operator_signature',
-        'redirecting_factory_constructor_signature',
-        'setter_signature',
-    ].includes(child.type)) ?? null);
-}
-function dartCallableName(node, parent) {
-    const callable = dartCallableNode(node);
-    if (!callable)
-        return null;
-    if (callable.type === 'operator_signature') {
-        const operator = callable.namedChildren.find((child) => child.type.endsWith('_operator'));
-        return operator ? `operator ${operator.text}` : null;
-    }
-    if (callable.type === 'constructor_signature' ||
-        callable.type === 'factory_constructor_signature' ||
-        callable.type === 'redirecting_factory_constructor_signature') {
-        const names = callable.namedChildren
-            .filter((child) => child.type === 'identifier')
-            .map((child) => child.text);
-        if (names.length === 0)
-            return null;
-        if (names.length === 1)
-            return names[0];
-        return names[0] === parent ? names[1] : names.at(-1);
-    }
-    return extractName(callable);
-}
-function dartAnnotatedStart(siblings, index) {
-    let start = siblings[index];
-    for (let i = index - 1; i >= 0 && siblings[i].type === 'annotation'; i--) {
-        start = siblings[i];
-    }
-    return start;
-}
-function dartDefinitionEnd(siblings, index) {
-    return siblings[index + 1]?.type === 'function_body'
-        ? siblings[index + 1]
-        : siblings[index];
-}
-function dartSignature(sourceLines, node) {
-    return sourceLines[node.startPosition.row]?.trim() ?? '';
-}
-function pushDartSymbol(sourceLines, symbols, name, kind, node, options = {}) {
-    symbols.push({
-        name,
-        kind,
-        ...(options.parent ? { parent: options.parent } : {}),
-        startLine: (options.start ?? node).startPosition.row + 1,
-        endLine: (options.end ?? node).endPosition.row + 1,
-        signature: dartSignature(sourceLines, node),
-    });
-}
-function dartVariableKind(siblings, index, container) {
-    if (container?.namedChildren.some((child) => child.type === 'const_builtin')) {
-        return 'const';
-    }
-    const row = siblings[index].startPosition.row;
-    for (let i = index - 1; i >= 0 && siblings[i].endPosition.row === row; i--) {
-        if (siblings[i].type === 'const_builtin')
-            return 'const';
-    }
-    return 'variable';
-}
-function extractDartVariables(sourceLines, symbols, node, kind, parent) {
-    const lists = node.type === 'initialized_identifier_list' ||
-        node.type === 'static_final_declaration_list'
-        ? [node]
-        : node.namedChildren.filter((child) => child.type === 'initialized_identifier_list' ||
-            child.type === 'static_final_declaration_list');
-    for (const list of lists) {
-        for (const declaration of list.namedChildren) {
-            if (declaration.type !== 'initialized_identifier' &&
-                declaration.type !== 'static_final_declaration') {
-                continue;
-            }
-            const name = dartDirectChild(declaration, 'identifier')?.text;
-            if (name) {
-                pushDartSymbol(sourceLines, symbols, name, kind, node, { parent });
-            }
-        }
-    }
-}
-function extractDartMembers(sourceLines, body, parent, symbols) {
-    const children = body.namedChildren;
-    for (let i = 0; i < children.length; i++) {
-        const node = children[i];
-        if (node.type === 'method_signature') {
-            const name = dartCallableName(node, parent);
-            if (name) {
-                pushDartSymbol(sourceLines, symbols, name, 'method', node, {
-                    parent,
-                    start: dartAnnotatedStart(children, i),
-                    end: dartDefinitionEnd(children, i),
-                });
-            }
-        }
-        else if (node.type === 'declaration') {
-            const name = dartCallableName(node, parent);
-            if (name) {
-                pushDartSymbol(sourceLines, symbols, name, 'method', node, { parent });
-            }
-            extractDartVariables(sourceLines, symbols, node, dartVariableKind(children, i, node), parent);
-        }
-        else if (node.type === 'enum_constant') {
-            const name = extractName(node);
-            if (name) {
-                pushDartSymbol(sourceLines, symbols, name, 'const', node, { parent });
-            }
-        }
-    }
-}
-function extractDartSymbols(tree) {
-    const symbols = [];
-    const children = tree.rootNode.namedChildren;
-    const sourceLines = tree.rootNode.text.split('\n');
-    for (let i = 0; i < children.length; i++) {
-        const node = children[i];
-        const start = dartAnnotatedStart(children, i);
-        if (node.type === 'function_signature' ||
-            node.type === 'getter_signature' ||
-            node.type === 'setter_signature') {
-            const name = dartCallableName(node);
-            if (name) {
-                pushDartSymbol(sourceLines, symbols, name, 'function', node, {
-                    start,
-                    end: dartDefinitionEnd(children, i),
-                });
-            }
-        }
-        else if (node.type === 'class_definition') {
-            const name = dartDefinitionName(node);
-            if (!name)
-                continue;
-            pushDartSymbol(sourceLines, symbols, name, 'class', node, { start });
-            const body = node.childForFieldName('body');
-            if (body)
-                extractDartMembers(sourceLines, body, name, symbols);
-        }
-        else if (node.type === 'mixin_declaration') {
-            const name = dartDefinitionName(node);
-            if (!name)
-                continue;
-            pushDartSymbol(sourceLines, symbols, name, 'interface', node, { start });
-            const body = dartDirectChild(node, 'class_body');
-            if (body)
-                extractDartMembers(sourceLines, body, name, symbols);
-        }
-        else if (node.type === 'extension_declaration') {
-            const name = extractName(node);
-            if (!name)
-                continue;
-            pushDartSymbol(sourceLines, symbols, name, 'class', node, { start });
-            const body = node.childForFieldName('body');
-            if (body)
-                extractDartMembers(sourceLines, body, name, symbols);
-        }
-        else if (node.type === 'enum_declaration') {
-            const name = extractName(node);
-            if (!name)
-                continue;
-            pushDartSymbol(sourceLines, symbols, name, 'class', node, { start });
-            const body = node.childForFieldName('body');
-            if (body)
-                extractDartMembers(sourceLines, body, name, symbols);
-        }
-        else if (node.type === 'extension_type_declaration') {
-            const name = extractName(node);
-            if (!name)
-                continue;
-            pushDartSymbol(sourceLines, symbols, name, 'type', node, { start });
-            const representation = node.childForFieldName('representation');
-            const representationName = representation?.childForFieldName('name');
-            if (representation && representationName) {
-                pushDartSymbol(sourceLines, symbols, representationName.text, 'variable', representation, { parent: name });
-            }
-            const body = node.childForFieldName('body');
-            if (body)
-                extractDartMembers(sourceLines, body, name, symbols);
-        }
-        else if (node.type === 'type_alias') {
-            const name = dartDefinitionName(node);
-            if (name) {
-                pushDartSymbol(sourceLines, symbols, name, 'type', node, { start });
-            }
-        }
-        else if (node.type === 'initialized_identifier_list' ||
-            node.type === 'static_final_declaration_list') {
-            extractDartVariables(sourceLines, symbols, node, dartVariableKind(children, i));
-        }
-    }
-    return symbols;
-}
-const javaTypeKinds = {
-    annotation_type_declaration: 'interface',
-    class_declaration: 'class',
-    enum_declaration: 'class',
-    interface_declaration: 'interface',
-    record_declaration: 'class',
-};
-function javaSignature(sourceLines, node) {
-    const declarator = node.namedChildren.find((child) => child.type === 'variable_declarator');
-    const name = node.childForFieldName('name') ?? declarator?.childForFieldName('name');
-    return sourceLines[(name ?? node).startPosition.row]?.trim() ?? '';
-}
-function pushJavaSymbol(sourceLines, symbols, name, kind, node, parent) {
-    const symbol = {
-        name,
-        kind,
-        ...(parent ? { parent } : {}),
-        startLine: node.startPosition.row + 1,
-        endLine: node.endPosition.row + 1,
-        signature: javaSignature(sourceLines, node),
-    };
-    symbols.push(symbol);
-    return symbol;
-}
-function extractJavaVariables(sourceLines, symbols, node, parent) {
-    const kind = node.type === 'constant_declaration' ? 'const' : 'variable';
-    for (const declarator of node.namedChildren) {
-        if (declarator.type !== 'variable_declarator')
-            continue;
-        const name = extractName(declarator);
-        if (name) {
-            pushJavaSymbol(sourceLines, symbols, name, kind, node, parent);
-        }
-    }
-}
-function collectJavaScope(sourceLines, scope, parent, symbols) {
-    for (const node of scope.namedChildren) {
-        const typeKind = javaTypeKinds[node.type];
-        if (typeKind) {
-            const name = extractName(node);
-            if (!name)
-                continue;
-            const symbol = pushJavaSymbol(sourceLines, symbols, name, typeKind, node);
-            if (parent)
-                symbols.push({ ...symbol, parent });
-            if (node.type === 'record_declaration') {
-                const parameters = node.childForFieldName('parameters');
-                for (const parameter of parameters?.namedChildren ?? []) {
-                    const component = extractName(parameter);
-                    if (component) {
-                        pushJavaSymbol(sourceLines, symbols, component, 'variable', parameter, name);
-                    }
-                }
-            }
-            const body = node.childForFieldName('body');
-            if (body)
-                collectJavaScope(sourceLines, body, name, symbols);
-            continue;
-        }
-        if (!parent)
-            continue;
-        if (node.type === 'method_declaration' ||
-            node.type === 'constructor_declaration' ||
-            node.type === 'compact_constructor_declaration' ||
-            node.type === 'annotation_type_element_declaration') {
-            const name = extractName(node);
-            if (name) {
-                pushJavaSymbol(sourceLines, symbols, name, 'method', node, parent);
-            }
-        }
-        else if (node.type === 'field_declaration' ||
-            node.type === 'constant_declaration') {
-            extractJavaVariables(sourceLines, symbols, node, parent);
-        }
-        else if (node.type === 'enum_constant') {
-            const name = extractName(node);
-            if (name) {
-                pushJavaSymbol(sourceLines, symbols, name, 'const', node, parent);
-            }
-        }
-        else if (node.type === 'enum_body_declarations') {
-            collectJavaScope(sourceLines, node, parent, symbols);
-        }
-    }
-}
-function extractJavaSymbols(tree) {
-    const symbols = [];
-    const sourceLines = tree.rootNode.text.split('\n');
-    collectJavaScope(sourceLines, tree.rootNode, undefined, symbols);
-    return symbols;
-}
-function phpSignature(sourceLines, node) {
-    const declaration = node.namedChildren.find((child) => child.type !== 'attribute_list');
-    return sourceLines[(declaration ?? node).startPosition.row]?.trim() ?? '';
-}
-function phpName(node) {
-    const nameNode = node.childForFieldName('name');
-    if (nameNode?.type === 'by_ref') {
-        return (nameNode.namedChildren
-            .find((child) => child.type === 'variable_name')
-            ?.text.replace(/^\$/, '') ?? null);
-    }
-    const name = extractName(node) ??
-        node.namedChildren.find((child) => child.type === 'name')?.text ??
-        null;
-    return name?.replace(/^\$/, '') ?? null;
-}
-function pushPhpSymbol(sourceLines, symbols, node, name, kind, parent) {
-    symbols.push({
-        name,
-        kind,
-        ...(parent ? { parent } : {}),
-        startLine: node.startPosition.row + 1,
-        endLine: node.endPosition.row + 1,
-        signature: phpSignature(sourceLines, node),
-    });
-}
-function extractPhpVariables(sourceLines, symbols, node, parent) {
-    const kind = node.type === 'const_declaration' ? 'const' : 'variable';
-    for (const child of node.namedChildren) {
-        if (child.type !== 'const_element' && child.type !== 'property_element') {
-            continue;
-        }
-        const name = phpName(child);
-        if (name)
-            pushPhpSymbol(sourceLines, symbols, node, name, kind, parent);
-    }
-}
-const phpTypeKinds = {
-    class_declaration: 'class',
-    interface_declaration: 'interface',
-    trait_declaration: 'interface',
-    enum_declaration: 'class',
-};
-// Recurse through declaration containers, not arbitrary expressions: anonymous
-// classes and closures must not leak their members into the enclosing scope.
-const phpScopeContainers = new Set([
-    'namespace_definition',
-    'compound_statement',
-    'declaration_list',
-    'enum_declaration_list',
-    'if_statement',
-    'else_if_clause',
-    'else_clause',
-    'switch_statement',
-    'switch_block',
-    'case_statement',
-    'default_statement',
-    'while_statement',
-    'do_statement',
-    'for_statement',
-    'foreach_statement',
-    'try_statement',
-    'catch_clause',
-    'finally_clause',
-    'declare_statement',
-]);
-function collectPhpScope(sourceLines, scope, symbols, parent) {
-    for (const node of scope.namedChildren) {
-        const typeKind = phpTypeKinds[node.type];
-        if (typeKind) {
-            const name = phpName(node);
-            if (!name)
-                continue;
-            pushPhpSymbol(sourceLines, symbols, node, name, typeKind);
-            const body = node.childForFieldName('body');
-            if (body)
-                collectPhpScope(sourceLines, body, symbols, name);
-            continue;
-        }
-        if (node.type === 'function_definition' && !parent) {
-            const name = phpName(node);
-            if (name)
-                pushPhpSymbol(sourceLines, symbols, node, name, 'function');
-        }
-        else if (node.type === 'method_declaration' && parent) {
-            const name = phpName(node);
-            if (name)
-                pushPhpSymbol(sourceLines, symbols, node, name, 'method', parent);
-            if (name?.toLowerCase() === '__construct') {
-                const parameters = node.childForFieldName('parameters');
-                for (const parameter of parameters?.namedChildren ?? []) {
-                    if (parameter.type !== 'property_promotion_parameter')
-                        continue;
-                    const propertyName = phpName(parameter);
-                    if (!propertyName)
-                        continue;
-                    pushPhpSymbol(sourceLines, symbols, parameter, propertyName, 'variable', parent);
-                }
-            }
-        }
-        else if (node.type === 'const_declaration' ||
-            node.type === 'property_declaration') {
-            extractPhpVariables(sourceLines, symbols, node, parent);
-        }
-        else if (node.type === 'enum_case' && parent) {
-            const name = phpName(node);
-            if (name)
-                pushPhpSymbol(sourceLines, symbols, node, name, 'const', parent);
-        }
-        else if (phpScopeContainers.has(node.type)) {
-            collectPhpScope(sourceLines, node, symbols, parent);
-        }
-    }
-}
-function extractPhpSymbols(tree) {
-    const symbols = [];
-    collectPhpScope(tree.rootNode.text.split('\n'), tree.rootNode, symbols);
-    return symbols;
-}
-function extractRustSymbols(tree) {
-    const symbols = [];
-    const root = tree.rootNode;
-    for (let i = 0; i < root.childCount; i++) {
-        const node = root.child(i);
-        const startLine = node.startPosition.row + 1;
-        const endLine = node.endPosition.row + 1;
-        if (node.type === 'function_item') {
-            const name = extractName(node);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'function',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-        }
-        else if (node.type === 'struct_item') {
-            const name = extractName(node);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'class',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-        }
-        else if (node.type === 'enum_item') {
-            const name = extractName(node);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'class',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-        }
-        else if (node.type === 'trait_item') {
-            const name = extractName(node);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'interface',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-        }
-        else if (node.type === 'impl_item') {
-            // impl Type { ... } or impl Trait for Type { ... }
-            const typeName = node.childForFieldName('type')?.text;
-            if (!typeName)
-                continue;
-            const body = node.childForFieldName('body');
-            if (!body)
-                continue;
-            for (let j = 0; j < body.namedChildCount; j++) {
-                const member = body.namedChild(j);
-                if (member.type === 'function_item') {
-                    const name = extractName(member);
-                    if (name) {
-                        symbols.push({
-                            name,
-                            kind: 'method',
-                            parent: typeName,
-                            startLine: member.startPosition.row + 1,
-                            endLine: member.endPosition.row + 1,
-                            signature: firstLine(member.text),
-                        });
-                    }
-                }
-            }
-        }
-        else if (node.type === 'const_item') {
-            const name = extractName(node);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'const',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-        }
-        else if (node.type === 'static_item') {
-            const name = extractName(node);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'variable',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-        }
-        else if (node.type === 'type_item') {
-            const name = extractName(node);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'type',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-        }
-    }
-    return symbols;
-}
-/**
- * Extract the receiver type name from a Go method declaration's receiver node.
- * Handles both value receivers (Greeter) and pointer receivers (*Greeter).
- */
-function goReceiverType(receiverNode) {
-    const param = receiverNode.namedChild(0);
-    if (!param)
-        return null;
-    const typeNode = param.childForFieldName('type');
-    if (!typeNode)
-        return null;
-    // pointer_type -> child is the actual type name
-    if (typeNode.type === 'pointer_type') {
-        return typeNode.namedChild(0)?.text ?? null;
-    }
-    return typeNode.text;
-}
-function extractGoSymbols(tree) {
-    const symbols = [];
-    const root = tree.rootNode;
-    for (let i = 0; i < root.childCount; i++) {
-        const node = root.child(i);
-        const startLine = node.startPosition.row + 1;
-        const endLine = node.endPosition.row + 1;
-        if (node.type === 'function_declaration') {
-            const name = extractName(node);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'function',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-        }
-        else if (node.type === 'method_declaration') {
-            const name = extractName(node);
-            const receiver = node.childForFieldName('receiver');
-            const typeName = receiver ? goReceiverType(receiver) : null;
-            if (name && typeName) {
-                symbols.push({
-                    name,
-                    kind: 'method',
-                    parent: typeName,
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-        }
-        else if (node.type === 'type_declaration') {
-            for (let j = 0; j < node.namedChildCount; j++) {
-                const spec = node.namedChild(j);
-                if (spec.type !== 'type_spec')
-                    continue;
-                const name = spec.childForFieldName('name')?.text;
-                if (!name)
-                    continue;
-                const typeNode = spec.childForFieldName('type');
-                const kind = typeNode?.type === 'interface_type' ? 'interface' : 'class';
-                symbols.push({
-                    name,
-                    kind,
-                    startLine: spec.startPosition.row + 1,
-                    endLine: spec.endPosition.row + 1,
-                    signature: firstLine(node.text),
-                });
-            }
-        }
-        else if (node.type === 'const_declaration') {
-            for (let j = 0; j < node.namedChildCount; j++) {
-                const spec = node.namedChild(j);
-                if (spec.type !== 'const_spec')
-                    continue;
-                const name = spec.childForFieldName('name')?.text;
-                if (name) {
-                    symbols.push({
-                        name,
-                        kind: 'const',
-                        startLine: spec.startPosition.row + 1,
-                        endLine: spec.endPosition.row + 1,
-                        signature: firstLine(node.text),
-                    });
-                }
-            }
-        }
-        else if (node.type === 'var_declaration') {
-            for (let j = 0; j < node.namedChildCount; j++) {
-                const spec = node.namedChild(j);
-                if (spec.type !== 'var_spec')
-                    continue;
-                const name = spec.childForFieldName('name')?.text;
-                if (name) {
-                    symbols.push({
-                        name,
-                        kind: 'variable',
-                        startLine: spec.startPosition.row + 1,
-                        endLine: spec.endPosition.row + 1,
-                        signature: firstLine(node.text),
-                    });
-                }
-            }
-        }
-    }
-    return symbols;
-}
-/**
- * Extract the declarator name from a C function_declarator node.
- * Handles plain identifiers and pointer declarators (*name).
- */
-function cFuncName(declarator) {
-    // Unwrap pointer_declarator layers (for functions returning pointers,
-    // e.g. `JSRuntime *JS_NewRuntime(void)` → pointer_declarator > function_declarator)
-    let node = declarator;
-    while (node.type === 'pointer_declarator') {
-        const child = node.childForFieldName('declarator');
-        if (!child)
-            return null;
-        node = child;
-    }
-    if (node.type === 'function_declarator') {
-        const inner = node.childForFieldName('declarator');
-        if (!inner)
-            return null;
-        if (inner.type === 'identifier')
-            return inner.text;
-        if (inner.type === 'pointer_declarator') {
-            // *name — dig through pointer layers
-            let cur = inner;
-            while (cur.type === 'pointer_declarator') {
-                const child = cur.childForFieldName('declarator');
-                if (!child)
-                    return null;
-                cur = child;
-            }
-            return cur.type === 'identifier' ? cur.text : null;
-        }
-    }
-    return null;
-}
-/**
- * Extract the variable name from a C init_declarator or plain declarator.
- * Handles pointers like `*DEFAULT_NAME = "World"`.
- */
-function cVarName(declarator) {
-    let node = declarator;
-    // Unwrap init_declarator to get the declarator part
-    if (node.type === 'init_declarator') {
-        const inner = node.childForFieldName('declarator');
-        if (!inner)
-            return null;
-        node = inner;
-    }
-    // Unwrap array_declarator (e.g. `char js_version[]`)
-    if (node.type === 'array_declarator') {
-        const inner = node.childForFieldName('declarator');
-        if (!inner)
-            return null;
-        node = inner;
-    }
-    if (node.type === 'identifier')
-        return node.text;
-    if (node.type === 'pointer_declarator') {
-        let cur = node;
-        while (cur.type === 'pointer_declarator') {
-            const child = cur.childForFieldName('declarator');
-            if (!child)
-                return null;
-            cur = child;
-        }
-        return cur.type === 'identifier' ? cur.text : null;
-    }
-    return null;
-}
-function extractCSymbols(tree) {
-    const symbols = [];
-    collectCNodes(tree.rootNode, symbols);
-    return symbols;
-}
-/**
- * Walk C AST nodes, collecting symbols. Recurses into preprocessor
- * conditional blocks (ifdef/ifndef/if), linkage specifications
- * (extern "C" { ... }), and declaration lists so that include guards
- * and conditional compilation don't hide declarations.
- *
- * For #if/#ifdef/#ifndef, only the "then" branch is traversed —
- * preproc_else and preproc_elif children are skipped.
- */
-function collectCNodes(parent, symbols) {
-    for (let i = 0; i < parent.childCount; i++) {
-        const node = parent.child(i);
-        const startLine = node.startPosition.row + 1;
-        const endLine = node.endPosition.row + 1;
-        if (node.type === 'function_definition') {
-            const declarator = node.childForFieldName('declarator');
-            const name = declarator ? cFuncName(declarator) : null;
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'function',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-        }
-        else if (node.type === 'struct_specifier') {
-            const name = extractName(node);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'class',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-                collectCStructFields(node, name, symbols);
-            }
-        }
-        else if (node.type === 'enum_specifier') {
-            const name = extractName(node);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'class',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-            collectCEnumMembers(node, symbols, name ?? undefined);
-        }
-        else if (node.type === 'type_definition') {
-            let declarator = node.childForFieldName('declarator');
-            // Unwrap pointer_declarator for pointer typedefs
-            // e.g. `typedef struct __JSValue *JSValue;`
-            while (declarator?.type === 'pointer_declarator') {
-                declarator = declarator.childForFieldName('declarator') ?? null;
-            }
-            const name = declarator?.type === 'type_identifier' ? declarator.text : null;
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'type',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-            for (const child of node.namedChildren) {
-                if (child.type === 'enum_specifier') {
-                    collectCEnumMembers(child, symbols, name ?? extractName(child) ?? undefined);
-                }
-                else if (child.type === 'struct_specifier' && name) {
-                    collectCStructFields(child, name, symbols);
-                }
-            }
-        }
-        else if (node.type === 'declaration') {
-            const declarator = node.childForFieldName('declarator');
-            // Try as function declaration first (e.g. `void greet(const char *name);`
-            // in headers), then fall back to variable.
-            const funcName = declarator ? cFuncName(declarator) : null;
-            if (funcName) {
-                symbols.push({
-                    name: funcName,
-                    kind: 'function',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-            else {
-                const name = declarator ? cVarName(declarator) : null;
-                if (name) {
-                    symbols.push({
-                        name,
-                        kind: 'variable',
-                        startLine,
-                        endLine,
-                        signature: firstLine(node.text),
-                    });
-                }
-            }
-        }
-        else if (node.type === 'preproc_def' ||
-            node.type === 'preproc_function_def') {
-            const name = extractName(node);
-            if (name) {
-                symbols.push({
-                    name,
-                    kind: 'const',
-                    startLine,
-                    endLine,
-                    signature: firstLine(node.text),
-                });
-            }
-        }
-        else if (node.type === 'preproc_ifdef' ||
-            node.type === 'preproc_ifndef' ||
-            node.type === 'preproc_if') {
-            // Recurse into conditional blocks (then-branch only).
-            // preproc_else / preproc_elif children are skipped.
-            collectCNodes(node, symbols);
-        }
-        else if (node.type === 'linkage_specification' ||
-            node.type === 'declaration_list') {
-            // extern "C" { ... } wraps declarations in linkage_specification
-            // containing a declaration_list — recurse through both.
-            collectCNodes(node, symbols);
-        }
-        else if (node.type === 'preproc_else' || node.type === 'preproc_elif') {
-            // Skip else/elif branches of preprocessor conditionals.
-        }
-    }
-}
-function collectCEnumMembers(enumSpecifier, symbols, enumName) {
-    for (const child of enumSpecifier.namedChildren) {
-        if (child.type !== 'enumerator_list')
-            continue;
-        for (const enumerator of child.namedChildren) {
-            if (enumerator.type !== 'enumerator')
-                continue;
-            const name = extractName(enumerator);
-            if (!name)
-                continue;
-            const sym = {
-                name,
-                kind: 'const',
-                startLine: enumerator.startPosition.row + 1,
-                endLine: enumerator.endPosition.row + 1,
-                signature: firstLine(enumerator.text),
-            };
-            // Emit without parent (standalone lookup like #GREEN)
-            symbols.push(sym);
-            // Also emit with parent so #Color#GREEN works
-            if (enumName) {
-                symbols.push({ ...sym, parent: enumName });
-            }
-        }
-    }
-}
-/**
- * Extract struct field/member names from a struct_specifier and emit
- * them as symbols with `parent` set to the struct name.
- * Handles plain identifiers, pointers, arrays, bitfields, and
- * anonymous union/struct members (recurses into them).
- */
-function collectCStructFields(structNode, structName, symbols) {
-    for (const child of structNode.namedChildren) {
-        if (child.type !== 'field_declaration_list')
-            continue;
-        collectFieldsFromList(child, structName, symbols);
-    }
-}
-function collectFieldsFromList(fieldList, structName, symbols) {
-    for (const field of fieldList.namedChildren) {
-        if (field.type !== 'field_declaration')
-            continue;
-        const declarator = field.childForFieldName('declarator');
-        if (declarator) {
-            const name = cFieldName(declarator);
-            if (!name)
-                continue;
-            symbols.push({
-                name,
-                kind: 'variable',
-                parent: structName,
-                startLine: field.startPosition.row + 1,
-                endLine: field.endPosition.row + 1,
-                signature: firstLine(field.text),
-            });
-        }
-        else {
-            // Anonymous union/struct member — recurse into its field list
-            for (const inner of field.namedChildren) {
-                if ((inner.type === 'union_specifier' ||
-                    inner.type === 'struct_specifier') &&
-                    !extractName(inner)) {
-                    for (const sub of inner.namedChildren) {
-                        if (sub.type === 'field_declaration_list') {
-                            collectFieldsFromList(sub, structName, symbols);
-                        }
-                    }
-                }
-            }
-        }
-    }
-}
-/**
- * Extract the field name from a C struct field declarator.
- * Handles field_identifier, pointer_declarator, array_declarator,
- * and bitfield_clause (e.g. `uint8_t extensible : 1`).
- */
-function cFieldName(declarator) {
-    let node = declarator;
-    // Unwrap pointer_declarator layers (e.g. `JSShape *shape`)
-    while (node.type === 'pointer_declarator') {
-        const child = node.childForFieldName('declarator');
-        if (!child)
-            return null;
-        node = child;
-    }
-    // Unwrap array_declarator (e.g. `char name[32]`)
-    if (node.type === 'array_declarator') {
-        const inner = node.childForFieldName('declarator');
-        if (!inner)
-            return null;
-        node = inner;
-    }
-    if (node.type === 'field_identifier')
-        return node.text;
-    return null;
-}
-function firstLine(text) {
-    const nl = text.indexOf('\n');
-    return nl === -1 ? text : text.slice(0, nl);
-}
-/** Every supported source extension must declare a symbol extractor. */
-const symbolExtractors = {
-    '.c': extractCSymbols,
-    '.dart': extractDartSymbols,
-    '.erb': extractRubySymbols,
-    '.go': extractGoSymbols,
-    '.h': extractCSymbols,
-    '.java': extractJavaSymbols,
-    '.js': extractTsSymbols,
-    '.jsx': extractTsSymbols,
-    '.php': extractPhpSymbols,
-    '.py': extractPySymbols,
-    '.rake': extractRubySymbols,
-    '.rb': extractRubySymbols,
-    '.rs': extractRustSymbols,
-    '.ts': extractTsSymbols,
-    '.tsx': extractTsSymbols,
-};
-function preprocessErb(content) {
-    let result = '';
-    let inRuby = false;
-    let inComment = false;
-    let i = 0;
-    while (i < content.length) {
-        if (!inRuby && !inComment) {
-            if (content.startsWith('<%%', i)) {
-                result += '   ';
-                i += 3;
-            }
-            else if (content.startsWith('<%#', i)) {
-                inComment = true;
-                result += '   ';
-                i += 3;
-            }
-            else if (content.startsWith('<%', i)) {
-                inRuby = true;
-                let tagLen = 2;
-                while (i + tagLen < content.length &&
-                    ['=', '-', '~'].includes(content[i + tagLen])) {
-                    tagLen++;
-                }
-                result += ' '.repeat(tagLen);
-                i += tagLen;
-            }
-            else {
-                const ch = content[i];
-                result += ch === '\n' ? '\n' : ' ';
-                i++;
-            }
-        }
-        else if (inComment) {
-            if (content.startsWith('%>', i)) {
-                inComment = false;
-                result += '  ';
-                i += 2;
-            }
-            else if (content.startsWith('-%>', i) || content.startsWith('~%>', i)) {
-                inComment = false;
-                result += '   ';
-                i += 3;
-            }
-            else {
-                const ch = content[i];
-                result += ch === '\n' ? '\n' : ' ';
-                i++;
-            }
-        }
-        else {
-            if (content.startsWith('%%>', i)) {
-                result += '   ';
-                i += 3;
-            }
-            else if (content.startsWith('%>', i)) {
-                inRuby = false;
-                result += '  ';
-                i += 2;
-            }
-            else if (content.startsWith('-%>', i) || content.startsWith('~%>', i)) {
-                inRuby = false;
-                result += '   ';
-                i += 3;
-            }
-            else {
-                result += content[i];
-                i++;
-            }
-        }
-    }
-    return result;
-}
-export async function parseSourceSymbols(filePath, content) {
-    const ext = sourceFileExtension(filePath);
-    if (!ext)
-        return [];
-    const lang = await getLanguage(ext);
-    const p = await ensureParser();
-    p.setLanguage(lang);
-    const parsedContent = ext === '.erb' && content.includes('<%') ? preprocessErb(content) : content;
-    const tree = p.parse(parsedContent);
-    if (!tree)
-        return [];
-    try {
-        return symbolExtractors[ext](tree);
-    }
-    finally {
-        tree.delete();
-    }
-}
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-const sourceSymbolKinds = new Set([
-    'function',
-    'class',
-    'const',
-    'type',
-    'interface',
-    'method',
-    'variable',
-]);
-function isSourceSymbol(value) {
-    if (!isRecord(value))
-        return false;
-    return (typeof value.name === 'string' &&
-        typeof value.kind === 'string' &&
-        sourceSymbolKinds.has(value.kind) &&
-        (value.parent === undefined || typeof value.parent === 'string') &&
-        Number.isInteger(value.startLine) &&
-        value.startLine > 0 &&
-        Number.isInteger(value.endLine) &&
-        value.endLine >= value.startLine &&
-        typeof value.signature === 'string');
-}
-function cachedSourceAnalysis(entry, contentHash, identity, timings) {
-    if (!entry ||
-        entry.version !== PARSER_CACHE_VERSION ||
-        entry.contentHash !== contentHash ||
-        !isRecord(entry.value) ||
-        entry.value.path !== identity ||
-        !Array.isArray(entry.value.symbols) ||
-        !entry.value.symbols.every(isSourceSymbol)) {
-        return null;
-    }
-    return {
-        path: identity,
-        symbols: entry.value.symbols,
-        timings: {
-            ...timings,
-            cacheStatus: 'hit',
-            cacheWriteMs: 0,
-            parseMs: 0,
-        },
-    };
-}
-/** Request-scoped owner for in-flight and completed source parser work. */
-export class SourceParserRuntime {
-    analyses = new Map();
-    symbols = new Map();
-    clear() {
-        this.analyses.clear();
-        this.symbols.clear();
-    }
-}
-const defaultSourceParserRuntime = new SourceParserRuntime();
-/** Return the parser cache path for one project source file. */
-export function sourceAnalysisCachePath(latDir, projectRoot, absolutePath) {
-    return parsedCachePath(latDir, parserCacheIdentity(absolutePath, projectRoot));
-}
-/** Analyze source content through the shared versioned persistent cache. */
-export async function analyzeSourceSymbols(filePath, content, latDir, options = {}) {
-    const identity = (options.identity ?? filePath)
-        .replaceAll('\\', '/')
-        .normalize('NFC');
-    const hashStarted = performance.now();
-    const contentHash = hashParserContent(content);
-    const hashMs = performance.now() - hashStarted;
-    const cache = options.cache !== false;
-    const cachePath = parsedCachePath(latDir, identity);
-    const promiseKey = `${cache ? 'cache' : 'direct'}\0${cachePath}\0${contentHash}`;
-    const runtime = options.runtime ?? defaultSourceParserRuntime;
-    let analysis = runtime.analyses.get(promiseKey);
-    if (!analysis) {
-        analysis = (async () => {
-            const cacheStarted = performance.now();
-            const entry = cache ? await readParsedCache(cachePath) : null;
-            const cacheReadMs = cache ? performance.now() - cacheStarted : 0;
-            const timings = {
-                readMs: options.readMs ?? 0,
-                hashMs,
-                cacheReadMs,
-                cacheStatus: cache ? 'miss' : 'disabled',
-            };
-            const cached = cache
-                ? cachedSourceAnalysis(entry, contentHash, identity, timings)
-                : null;
-            if (cached)
-                return cached;
-            const parseStarted = performance.now();
-            const symbols = await parseSourceSymbols(filePath, content);
-            const result = {
-                path: identity,
-                symbols,
-                timings: {
-                    ...timings,
-                    cacheWriteMs: 0,
-                    parseMs: performance.now() - parseStarted,
-                },
-            };
-            if (!cache)
-                return result;
-            const writeStarted = performance.now();
-            try {
-                await writeParsedCache(cachePath, contentHash, result);
-            }
-            catch {
-                // The cache is a disposable optimization; parsing must work read-only.
-            }
-            result.timings.cacheWriteMs = performance.now() - writeStarted;
-            return result;
-        })();
-        runtime.analyses.set(promiseKey, analysis);
-    }
-    return analysis;
-}
-/** Clear the symbol cache. Call between top-level operations. */
-export function clearSymbolCache() {
-    defaultSourceParserRuntime.clear();
-}
-/**
- * Check whether a source file path (relative to projectRoot) has a given symbol.
- * Used by lat check to validate source code wiki links lazily.
- */
-export async function resolveSourceSymbol(filePath, symbolPath, projectRoot, options = {}) {
-    const absPath = join(projectRoot, filePath);
-    const latDir = options.latDir ?? join(projectRoot, 'lat.md');
-    const cacheKey = `${latDir}\0${absPath}`;
-    const runtime = options.runtime ?? defaultSourceParserRuntime;
-    let cachedPromise = runtime.symbols.get(cacheKey);
-    const created = !cachedPromise;
-    if (!cachedPromise) {
-        cachedPromise = (async () => {
-            const readStarted = performance.now();
-            let content;
-            try {
-                content = await readFile(absPath, 'utf-8');
-            }
-            catch {
-                return { symbols: [] };
-            }
-            const readMs = performance.now() - readStarted;
-            try {
-                const analysis = await analyzeSourceSymbols(filePath, content, latDir, {
-                    cache: options.cache,
-                    identity: parserCacheIdentity(absPath, projectRoot),
-                    readMs,
-                    runtime,
-                });
-                return { symbols: analysis.symbols, analysis };
-            }
-            catch (err) {
-                return {
-                    symbols: [],
-                    error: `failed to parse "${filePath}": ${err instanceof Error ? err.message : String(err)}`,
-                };
-            }
-        })();
-        runtime.symbols.set(cacheKey, cachedPromise);
-    }
-    const cached = await cachedPromise;
-    if (created && cached.analysis)
-        options.onFileAnalyzed?.(cached.analysis);
-    if (cached.error) {
-        return { found: false, symbols: cached.symbols, error: cached.error };
-    }
-    const { symbols } = cached;
-    const parts = symbolPath.split('#');
-    if (parts.length === 1) {
-        // Simple symbol: getConfigDir
-        const found = symbols.some((s) => s.name === parts[0] && !s.parent);
-        return { found, symbols };
-    }
-    if (parts.length === 2) {
-        // Nested symbol: MyClass#myMethod
-        const found = symbols.some((s) => s.name === parts[1] && s.parent === parts[0]);
-        return { found, symbols };
-    }
-    return { found: false, symbols };
-}
-/**
- * Convert source symbols to Section objects for uniform handling.
- */
-export function sourceSymbolsToSections(symbols, filePath) {
-    const sections = [];
-    const classMap = new Map();
-    const parentNames = new Set(symbols.flatMap((symbol) => (symbol.parent ? [symbol.parent] : [])));
-    for (const sym of symbols) {
-        if (sym.parent)
-            continue; // Handle methods after their class
-        const section = {
-            id: `${filePath}#${sym.name}`,
-            heading: sym.name,
-            depth: 1,
-            file: filePath,
-            filePath,
-            children: [],
-            startLine: sym.startLine,
-            endLine: sym.endLine,
-            firstParagraph: sym.signature,
-        };
-        sections.push(section);
-        if (parentNames.has(sym.name)) {
-            classMap.set(sym.name, section);
-        }
-    }
-    // Add methods as children
-    for (const sym of symbols) {
-        if (!sym.parent)
-            continue;
-        const parentSection = classMap.get(sym.parent);
-        if (!parentSection)
-            continue;
-        const section = {
-            id: `${filePath}#${sym.parent}#${sym.name}`,
-            heading: sym.name,
-            depth: 2,
-            file: filePath,
-            filePath,
-            children: [],
-            startLine: sym.startLine,
-            endLine: sym.endLine,
-            firstParagraph: sym.signature,
-        };
-        parentSection.children.push(section);
-    }
-    return sections;
-}