@wuyanbin/ai-code-review-cli-remote 1.0.36 → 1.2.0

package/dist/core/symbols.js

@@ -0,0 +1,1018 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_TYPE_LINES = void 0;
+exports.classifyNode = classifyNode;
+exports.enclosingDeclaration = enclosingDeclaration;
+exports.goPackageNameCandidates = goPackageNameCandidates;
+exports.collectImports = collectImports;
+exports.packageName = packageName;
+exports.collectReferences = collectReferences;
+exports.findDeclaration = findDeclaration;
+exports.renderRanges = renderRanges;
+exports.findDeclarationByRegex = findDeclarationByRegex;
+const tree_sitter_1 = require("./tree-sitter");
+/** 类型 / 值 / 类成员清单的渲染行数上限 */
+exports.MAX_TYPE_LINES = 40;
+function field(node, name) {
+    try {
+        return node.childForFieldName(name);
+    }
+    catch {
+        return null;
+    }
+}
+function firstChild(node, ...types) {
+    return (0, tree_sitter_1.namedChildren)(node).find((c) => types.includes(c.type)) ?? null;
+}
+function hasAnonymousChild(node, type) {
+    return node.children.some((c) => c !== null && c.type === type);
+}
+function stripQuotes(text) {
+    return text.trim().replace(/^['"`]/, "").replace(/['"`]$/, "");
+}
+function samePosition(a, b) {
+    return (a.startPosition.row === b.startPosition.row &&
+        a.startPosition.column === b.startPosition.column &&
+        a.endPosition.row === b.endPosition.row &&
+        a.endPosition.column === b.endPosition.column);
+}
+function makeDeclaration(stmt, kind, name, body) {
+    const start = (0, tree_sitter_1.startLine)(stmt);
+    const header = body ? Math.max(start, (0, tree_sitter_1.startLine)(body)) : start;
+    return {
+        name,
+        kind,
+        startLine: start,
+        endLine: (0, tree_sitter_1.endLine)(stmt),
+        headerEndLine: Math.min(header, (0, tree_sitter_1.endLine)(stmt)),
+        node: stmt,
+    };
+}
+/** `export function f` / `export const x`：把范围放大到 export 语句本身 */
+function liftExport(stmt) {
+    return stmt.parent?.type === "export_statement" ? stmt.parent : stmt;
+}
+const TS_FUNCTION_STATEMENTS = new Set([
+    "function_declaration",
+    "generator_function_declaration",
+    "method_definition",
+]);
+const TS_FUNCTION_EXPRESSIONS = new Set([
+    "arrow_function",
+    "function_expression",
+    "generator_function",
+    "function",
+]);
+const TS_CLASS_LIKE = new Set(["class_declaration", "abstract_class_declaration"]);
+/** 形状类声明：整体呈现（封顶 MAX_TYPE_LINES），不按成员拆分 */
+const TS_TYPE_LIKE = new Set([
+    "interface_declaration",
+    "enum_declaration",
+    "internal_module",
+    "type_alias_declaration",
+]);
+const GO_FUNCTION = new Set(["function_declaration", "method_declaration"]);
+const GO_VALUE = new Set(["const_declaration", "var_declaration"]);
+const JAVA_FUNCTION = new Set([
+    "method_declaration",
+    "constructor_declaration",
+]);
+const JAVA_CLASS_LIKE = new Set(["class_declaration", "record_declaration"]);
+const JAVA_TYPE_LIKE = new Set([
+    "interface_declaration",
+    "enum_declaration",
+    "annotation_type_declaration",
+]);
+/** 顶层按名字查找时，class 与 type 两类都算「类型声明」 */
+const JAVA_TOP_LEVEL_TYPES = new Set([...JAVA_CLASS_LIKE, ...JAVA_TYPE_LIKE]);
+/** Kotlin：class_declaration 同时覆盖 class / interface，靠匿名关键字与 class_modifier 区分形状类 */
+const KOTLIN_FUNCTION = new Set([
+    "function_declaration",
+    "secondary_constructor",
+    "anonymous_initializer",
+]);
+const KOTLIN_OBJECT_LIKE = new Set(["object_declaration", "companion_object"]);
+const KOTLIN_BODIES = ["class_body", "enum_class_body"];
+/** Swift：class_declaration 同时覆盖 class / struct / enum / actor / extension */
+const SWIFT_FUNCTION = new Set([
+    "function_declaration",
+    "init_declaration",
+    "deinit_declaration",
+    "subscript_declaration",
+    "protocol_function_declaration",
+]);
+const SWIFT_TYPE_LIKE = new Set(["protocol_declaration", "typealias_declaration"]);
+const COMMENT_TYPES = new Set(["comment", "line_comment", "block_comment", "multiline_comment"]);
+function anonymousChildren(node) {
+    return node.children
+        .filter((c) => c !== null && !c.isNamed)
+        .map((c) => c.type);
+}
+function isTopLevel(node) {
+    return node.parent?.type === "source_file";
+}
+function isCommentNode(node) {
+    return COMMENT_TYPES.has(node.type);
+}
+/** Kotlin 属性名：`val x` / `val (a, b)` / 扩展属性 `val String.x`（只取声明侧标识符） */
+function kotlinPropertyNames(node) {
+    const names = [];
+    for (const child of (0, tree_sitter_1.namedChildren)(node)) {
+        if (child.type === "variable_declaration") {
+            const id = firstChild(child, "identifier");
+            if (id)
+                names.push(id.text);
+        }
+        else if (child.type === "multi_variable_declaration") {
+            for (const part of (0, tree_sitter_1.namedChildren)(child)) {
+                const id = part.type === "variable_declaration"
+                    ? firstChild(part, "identifier")
+                    : part.type === "identifier"
+                        ? part
+                        : null;
+                if (id)
+                    names.push(id.text);
+            }
+        }
+    }
+    return names;
+}
+/** Swift 属性名：`name: pattern → bound_identifier`，元组模式可能有多个 */
+function swiftPropertyNames(node) {
+    const names = [];
+    const visit = (n) => {
+        if (n.type === "simple_identifier") {
+            names.push(n.text);
+            return;
+        }
+        for (const c of (0, tree_sitter_1.namedChildren)(n))
+            visit(c);
+    };
+    for (const child of (0, tree_sitter_1.namedChildren)(node)) {
+        if (child.type === "pattern")
+            visit(child);
+    }
+    return names;
+}
+function isTsLike(language) {
+    return (language === "typescript" || language === "tsx" || language === "javascript");
+}
+/**
+ * 判断节点本身是否是一个声明；回调形式的函数表达式返回 null，让调用方继续向上找
+ * 真正的外层函数。
+ */
+function classifyNode(node, language) {
+    if (isTsLike(language)) {
+        if (TS_FUNCTION_STATEMENTS.has(node.type)) {
+            return makeDeclaration(liftExport(node), "function", field(node, "name")?.text ?? null, field(node, "body"));
+        }
+        if (TS_FUNCTION_EXPRESSIONS.has(node.type) || node.type === "class") {
+            const parent = node.parent;
+            if (!parent)
+                return null;
+            const kind = node.type === "class" ? "class" : "function";
+            const body = field(node, "body");
+            if (parent.type === "variable_declarator") {
+                const stmt = parent.parent ?? parent;
+                return makeDeclaration(liftExport(stmt), kind, field(parent, "name")?.text ?? null, body);
+            }
+            if (parent.type === "pair") {
+                return makeDeclaration(parent, kind, field(parent, "key")?.text ?? null, body);
+            }
+            if (parent.type === "assignment_expression") {
+                const stmt = parent.parent?.type === "expression_statement" ? parent.parent : parent;
+                return makeDeclaration(stmt, kind, field(parent, "left")?.text ?? null, body);
+            }
+            if (parent.type === "public_field_definition") {
+                return makeDeclaration(parent, kind, field(parent, "name")?.text ?? null, body);
+            }
+            return null;
+        }
+        if (TS_CLASS_LIKE.has(node.type)) {
+            return makeDeclaration(liftExport(node), "class", field(node, "name")?.text ?? null, field(node, "body"));
+        }
+        if (TS_TYPE_LIKE.has(node.type)) {
+            return makeDeclaration(liftExport(node), "type", field(node, "name")?.text ?? null, null);
+        }
+        return null;
+    }
+    if (language === "go") {
+        if (GO_FUNCTION.has(node.type)) {
+            return makeDeclaration(node, "function", field(node, "name")?.text ?? null, field(node, "body"));
+        }
+        if (node.type === "type_declaration") {
+            const spec = firstChild(node, "type_spec", "type_alias");
+            return makeDeclaration(node, "type", spec ? field(spec, "name")?.text ?? null : null, null);
+        }
+        if (GO_VALUE.has(node.type) && node.parent?.type === "source_file") {
+            const spec = firstChild(node, "const_spec", "var_spec");
+            return makeDeclaration(node, "value", spec ? field(spec, "name")?.text ?? null : null, null);
+        }
+        return null;
+    }
+    if (language === "java") {
+        if (JAVA_FUNCTION.has(node.type)) {
+            return makeDeclaration(node, "function", field(node, "name")?.text ?? null, field(node, "body"));
+        }
+        if (JAVA_CLASS_LIKE.has(node.type)) {
+            return makeDeclaration(node, "class", field(node, "name")?.text ?? null, field(node, "body"));
+        }
+        if (JAVA_TYPE_LIKE.has(node.type)) {
+            return makeDeclaration(node, "type", field(node, "name")?.text ?? null, null);
+        }
+        return null;
+    }
+    if (language === "kotlin") {
+        if (KOTLIN_FUNCTION.has(node.type)) {
+            const name = node.type === "secondary_constructor"
+                ? "constructor"
+                : node.type === "anonymous_initializer"
+                    ? "init"
+                    : field(node, "name")?.text ?? null;
+            return makeDeclaration(node, "function", name, firstChild(node, "function_body", "block"));
+        }
+        if (node.type === "class_declaration") {
+            const body = firstChild(node, ...KOTLIN_BODIES);
+            const name = field(node, "name")?.text ?? null;
+            // 无类体（data class / value class / 空类）：顶层的整体呈现，嵌套的交给外层类
+            if (!body)
+                return isTopLevel(node) ? makeDeclaration(node, "type", name, null) : null;
+            const modifiers = firstChild(node, "modifiers");
+            const classModifiers = modifiers
+                ? (0, tree_sitter_1.namedChildren)(modifiers).filter((m) => m.type === "class_modifier").map((m) => m.text)
+                : [];
+            const shapeLike = anonymousChildren(node).includes("interface") ||
+                body.type === "enum_class_body" ||
+                classModifiers.includes("enum") ||
+                classModifiers.includes("annotation");
+            return makeDeclaration(node, shapeLike ? "type" : "class", name, shapeLike ? null : body);
+        }
+        if (KOTLIN_OBJECT_LIKE.has(node.type)) {
+            const body = firstChild(node, "class_body");
+            const name = field(node, "name")?.text ?? (node.type === "companion_object" ? "Companion" : null);
+            if (!body)
+                return isTopLevel(node) ? makeDeclaration(node, "type", name, null) : null;
+            return makeDeclaration(node, "class", name, body);
+        }
+        if (node.type === "type_alias") {
+            const name = field(node, "type")?.text ?? firstChild(node, "identifier")?.text ?? null;
+            return makeDeclaration(node, "type", name, null);
+        }
+        if (node.type === "property_declaration") {
+            // 带 getter / setter 的属性像函数：签名 + 访问器体；普通成员属性交给外层类；顶层属性整体呈现
+            const accessor = firstChild(node, "getter", "setter");
+            const name = kotlinPropertyNames(node)[0] ?? null;
+            if (accessor)
+                return makeDeclaration(node, "function", name, accessor);
+            return isTopLevel(node) ? makeDeclaration(node, "value", name, null) : null;
+        }
+        return null;
+    }
+    if (language === "swift") {
+        if (SWIFT_FUNCTION.has(node.type)) {
+            const name = node.type === "init_declaration"
+                ? "init"
+                : node.type === "deinit_declaration"
+                    ? "deinit"
+                    : node.type === "subscript_declaration"
+                        ? "subscript"
+                        : field(node, "name")?.text ?? null;
+            const body = field(node, "body") ?? firstChild(node, "function_body", "computed_property");
+            return makeDeclaration(node, "function", name, body);
+        }
+        if (node.type === "class_declaration") {
+            // extension 的 name 是 user_type，text 仍是类型名
+            const name = field(node, "name")?.text ?? null;
+            if (anonymousChildren(node).includes("enum"))
+                return makeDeclaration(node, "type", name, null);
+            return makeDeclaration(node, "class", name, field(node, "body"));
+        }
+        if (SWIFT_TYPE_LIKE.has(node.type)) {
+            return makeDeclaration(node, "type", field(node, "name")?.text ?? null, null);
+        }
+        if (node.type === "property_declaration") {
+            // 计算属性（SwiftUI 的 body）与 didSet 块像函数：签名 + 计算体；存储属性交给外层类型；顶层整体呈现
+            const computed = field(node, "computed_value") ?? firstChild(node, "computed_property", "willset_didset_block");
+            const name = swiftPropertyNames(node)[0] ?? null;
+            if (computed)
+                return makeDeclaration(node, "function", name, computed);
+            return isTopLevel(node) ? makeDeclaration(node, "value", name, null) : null;
+        }
+        return null;
+    }
+    return null;
+}
+/** 找包含指定行（1-based）的最内层声明；顶层语句、import 等返回 null */
+function enclosingDeclaration(root, language, line, lineLength = 0) {
+    const row = line - 1;
+    if (row < 0 || row > root.endPosition.row)
+        return null;
+    let node = null;
+    try {
+        node =
+            root.descendantForPosition({ row, column: 0 }, { row, column: Math.max(0, lineLength) }) ?? root.descendantForPosition({ row, column: 0 });
+    }
+    catch {
+        return null;
+    }
+    for (let current = node; current; current = current.parent) {
+        const decl = classifyNode(current, language);
+        if (decl)
+            return decl;
+    }
+    return null;
+}
+/** Go 包名缺省取路径末段；`/v2` 版本段跳过；带连字符的目录再给两个常见变体 */
+function goPackageNameCandidates(importPath) {
+    const segments = importPath.split("/").filter(Boolean);
+    let last = segments.pop() ?? importPath;
+    if (/^v\d+$/.test(last) && segments.length > 0)
+        last = segments.pop() ?? last;
+    const variants = new Set([
+        last,
+        last.replace(/^go-/, ""),
+        last.replace(/-go$/, ""),
+        last.replace(/-/g, ""),
+        last.replace(/[-.]/g, "_"),
+    ]);
+    return [...variants].filter(Boolean);
+}
+function collectImports(root, language) {
+    const bindings = [];
+    if (isTsLike(language)) {
+        for (const stmt of (0, tree_sitter_1.namedChildren)(root)) {
+            if (stmt.type === "import_statement") {
+                const sourceNode = field(stmt, "source");
+                if (!sourceNode)
+                    continue;
+                const source = stripQuotes(sourceNode.text);
+                const clause = firstChild(stmt, "import_clause");
+                if (!clause)
+                    continue;
+                for (const part of (0, tree_sitter_1.namedChildren)(clause)) {
+                    if (part.type === "identifier") {
+                        bindings.push({ local: part.text, imported: "default", source, kind: "default" });
+                    }
+                    else if (part.type === "namespace_import") {
+                        const id = firstChild(part, "identifier");
+                        if (id)
+                            bindings.push({ local: id.text, imported: null, source, kind: "namespace" });
+                    }
+                    else if (part.type === "named_imports") {
+                        for (const spec of (0, tree_sitter_1.namedChildren)(part)) {
+                            if (spec.type !== "import_specifier")
+                                continue;
+                            const name = field(spec, "name")?.text;
+                            if (!name)
+                                continue;
+                            const alias = field(spec, "alias")?.text;
+                            bindings.push({ local: alias ?? name, imported: name, source, kind: "named" });
+                        }
+                    }
+                }
+                continue;
+            }
+            if (stmt.type === "lexical_declaration" || stmt.type === "variable_declaration") {
+                for (const declarator of (0, tree_sitter_1.namedChildren)(stmt)) {
+                    if (declarator.type !== "variable_declarator")
+                        continue;
+                    const value = field(declarator, "value");
+                    if (!value || value.type !== "call_expression")
+                        continue;
+                    if (field(value, "function")?.text !== "require")
+                        continue;
+                    const args = field(value, "arguments");
+                    const str = args ? (0, tree_sitter_1.namedChildren)(args)[0] : null;
+                    if (!str || str.type !== "string")
+                        continue;
+                    const source = stripQuotes(str.text);
+                    const nameNode = field(declarator, "name");
+                    if (!nameNode)
+                        continue;
+                    if (nameNode.type === "identifier") {
+                        bindings.push({ local: nameNode.text, imported: null, source, kind: "namespace" });
+                    }
+                    else if (nameNode.type === "object_pattern") {
+                        for (const prop of (0, tree_sitter_1.namedChildren)(nameNode)) {
+                            if (prop.type === "shorthand_property_identifier_pattern") {
+                                bindings.push({ local: prop.text, imported: prop.text, source, kind: "named" });
+                            }
+                            else if (prop.type === "pair_pattern") {
+                                const key = field(prop, "key")?.text;
+                                const local = field(prop, "value")?.text;
+                                if (key && local)
+                                    bindings.push({ local, imported: key, source, kind: "named" });
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        return bindings;
+    }
+    if (language === "go") {
+        const specs = [];
+        for (const decl of (0, tree_sitter_1.namedChildren)(root)) {
+            if (decl.type !== "import_declaration")
+                continue;
+            for (const child of (0, tree_sitter_1.namedChildren)(decl)) {
+                if (child.type === "import_spec")
+                    specs.push(child);
+                else if (child.type === "import_spec_list") {
+                    specs.push(...(0, tree_sitter_1.namedChildren)(child).filter((c) => c.type === "import_spec"));
+                }
+            }
+        }
+        for (const spec of specs) {
+            const pathNode = field(spec, "path");
+            if (!pathNode)
+                continue;
+            const source = stripQuotes(pathNode.text);
+            const alias = field(spec, "name")?.text;
+            if (alias === "_" || alias === ".")
+                continue;
+            const locals = alias ? [alias] : goPackageNameCandidates(source);
+            for (const local of locals) {
+                bindings.push({ local, imported: null, source, kind: "package" });
+            }
+        }
+        return bindings;
+    }
+    if (language === "java") {
+        for (const decl of (0, tree_sitter_1.namedChildren)(root)) {
+            if (decl.type !== "import_declaration")
+                continue;
+            if (hasAnonymousChild(decl, "static"))
+                continue;
+            const scoped = firstChild(decl, "scoped_identifier", "identifier");
+            if (!scoped)
+                continue;
+            const source = scoped.text;
+            if (hasAnonymousChild(decl, "asterisk")) {
+                bindings.push({ local: "*", imported: null, source, kind: "wildcard" });
+            }
+            else {
+                const last = source.split(".").pop() ?? source;
+                bindings.push({ local: last, imported: last, source, kind: "class" });
+            }
+        }
+        return bindings;
+    }
+    if (language === "kotlin") {
+        // 当前语法：顶层 `import` 节点；兼容其他版本的 import_list / import_header 包装
+        const imports = [];
+        const collect = (node) => {
+            for (const c of (0, tree_sitter_1.namedChildren)(node)) {
+                if (c.type === "import" || c.type === "import_header")
+                    imports.push(c);
+                else if (c.type === "import_list")
+                    collect(c);
+            }
+        };
+        collect(root);
+        for (const decl of imports) {
+            const qualified = firstChild(decl, "qualified_identifier", "identifier");
+            if (!qualified)
+                continue;
+            const source = qualified.text;
+            const wildcard = decl.children.some((c) => c !== null && !c.isNamed && c.type.includes("*"));
+            if (wildcard) {
+                bindings.push({ local: "*", imported: null, source, kind: "wildcard" });
+                continue;
+            }
+            // `import a.b.Util as U`：别名是紧随的 identifier（或 import_alias 包装）
+            const aliasNode = (0, tree_sitter_1.namedChildren)(decl).find((c) => c !== qualified && c.type === "identifier") ??
+                firstChild(decl, "import_alias");
+            const alias = aliasNode?.type === "import_alias" ? firstChild(aliasNode, "identifier")?.text : aliasNode?.text;
+            const last = source.split(".").pop() ?? source;
+            bindings.push({ local: alias ?? last, imported: last, source, kind: "class" });
+        }
+        return bindings;
+    }
+    if (language === "swift") {
+        // Swift 的 import 是模块级的，映射不到文件；只记录模块名供了解
+        for (const stmt of (0, tree_sitter_1.namedChildren)(root)) {
+            if (stmt.type !== "import_declaration")
+                continue;
+            const id = firstChild(stmt, "identifier");
+            if (!id)
+                continue;
+            const source = id.text;
+            const last = source.split(".").pop() ?? source;
+            bindings.push({ local: last, imported: null, source, kind: "package" });
+        }
+        return bindings;
+    }
+    return bindings;
+}
+/** Go 的 package 名 / Java 的 package 路径；TS 无此概念返回 null */
+function packageName(root, language) {
+    if (language === "go") {
+        const clause = firstChild(root, "package_clause");
+        return clause ? firstChild(clause, "package_identifier")?.text ?? null : null;
+    }
+    if (language === "java") {
+        const decl = firstChild(root, "package_declaration");
+        return decl ? firstChild(decl, "scoped_identifier", "identifier")?.text ?? null : null;
+    }
+    if (language === "kotlin") {
+        const header = firstChild(root, "package_header");
+        return header ? firstChild(header, "qualified_identifier", "identifier")?.text ?? null : null;
+    }
+    return null;
+}
+const IDENTIFIER_TYPES = {
+    typescript: new Set(["identifier", "type_identifier", "property_identifier", "shorthand_property_identifier"]),
+    tsx: new Set(["identifier", "type_identifier", "property_identifier", "shorthand_property_identifier"]),
+    javascript: new Set(["identifier", "property_identifier", "shorthand_property_identifier"]),
+    go: new Set(["identifier", "type_identifier", "field_identifier", "package_identifier"]),
+    java: new Set(["identifier", "type_identifier"]),
+    kotlin: new Set(["identifier"]),
+    swift: new Set(["simple_identifier", "type_identifier"]),
+};
+/** 限定引用的父节点：[对象侧字段名, 成员侧字段名]；字段名为 null 时按首/末子节点 */
+const QUALIFIED_PARENTS = {
+    member_expression: ["object", "property"],
+    nested_type_identifier: ["module", "name"],
+    nested_identifier: [null, null],
+    selector_expression: ["operand", "field"],
+    qualified_type: ["package", "name"],
+    field_access: ["object", "field"],
+    method_invocation: ["object", "name"],
+    scoped_type_identifier: [null, null],
+    scoped_identifier: [null, null],
+    // Kotlin：`Foo.BAR` → (navigation_expression (identifier) (identifier))，无字段名
+    navigation_expression: [null, null],
+};
+/** 沿最右侧子节点下钻到叶子；叶子是标识符则返回其文本 */
+function rightmostIdentifier(node, identifierTypes) {
+    let current = node;
+    for (;;) {
+        if (identifierTypes.has(current.type))
+            return current.text;
+        const kids = (0, tree_sitter_1.namedChildren)(current);
+        if (kids.length === 0)
+            return null;
+        current = kids[kids.length - 1];
+    }
+}
+/**
+ * Swift：该标识符是否是某个 navigation_expression 目标的最右叶子、且后缀是标识符
+ * （`Foo.bar` 里的 Foo，或 `(a + Foo).bar` 里的 Foo）——这类对象侧引用由成员侧覆盖。
+ */
+function isSwiftNavigationBase(node, identifierTypes) {
+    let current = node;
+    while (current.parent) {
+        const parent = current.parent;
+        if (parent.type === "navigation_suffix")
+            return false;
+        if (parent.type === "navigation_expression") {
+            const target = field(parent, "target");
+            if (!target || !samePosition(target, current))
+                return false;
+            const suffix = field(parent, "suffix");
+            const suffixId = suffix ? (0, tree_sitter_1.namedChildren)(suffix)[0] : null;
+            return suffixId !== null && suffixId !== undefined && identifierTypes.has(suffixId.type);
+        }
+        const kids = (0, tree_sitter_1.namedChildren)(parent);
+        const last = kids[kids.length - 1];
+        if (!last || !samePosition(last, current))
+            return false;
+        current = parent;
+    }
+    return false;
+}
+/** 收集落在给定行（1-based）上的标识符引用；只下探与目标行相交的子树 */
+function collectReferences(root, language, lines) {
+    if (lines.size === 0)
+        return [];
+    const rows = [...lines].map((l) => l - 1);
+    const minRow = Math.min(...rows);
+    const maxRow = Math.max(...rows);
+    const identifierTypes = IDENTIFIER_TYPES[language];
+    const seen = new Set();
+    const refs = [];
+    const push = (name, qualifier) => {
+        if (!name)
+            return;
+        const key = `${qualifier ?? ""}.${name}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        refs.push({ name, qualifier });
+    };
+    // 显式栈而不是递归：5000 层括号嵌套这种病态输入会撑爆调用栈，而异常一旦
+    // 逸出就会中断整次评审；先序、从左到右的顺序与递归版一致
+    const stack = [root];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (node.endPosition.row < minRow || node.startPosition.row > maxRow)
+            continue;
+        const children = (0, tree_sitter_1.namedChildren)(node);
+        if (children.length > 0) {
+            for (let i = children.length - 1; i >= 0; i--)
+                stack.push(children[i]);
+            continue;
+        }
+        if (!identifierTypes.has(node.type) || !lines.has(node.startPosition.row + 1))
+            continue;
+        const parent = node.parent;
+        if (language === "swift") {
+            // `Foo.bar`：成员在 navigation_suffix 里，限定符是外层 navigation_expression 的 target。
+            // 该语法会把 `a + Foo.bar` 解析成 `(a + Foo).bar`，所以限定符取 target 的最右叶子标识符
+            if (parent?.type === "navigation_suffix") {
+                const target = parent.parent ? field(parent.parent, "target") : null;
+                push(node.text, target ? rightmostIdentifier(target, identifierTypes) : null);
+                continue;
+            }
+            // 对象侧（`Foo.bar` 里的 Foo，含上述被吞进二元表达式的形态）由成员侧那条限定引用覆盖
+            if (isSwiftNavigationBase(node, identifierTypes))
+                continue;
+            push(node.text, null);
+            continue;
+        }
+        const spec = parent ? QUALIFIED_PARENTS[parent.type] : undefined;
+        if (parent && spec) {
+            const siblings = (0, tree_sitter_1.namedChildren)(parent);
+            const object = spec[0] ? field(parent, spec[0]) : siblings[0] ?? null;
+            const member = spec[1] ? field(parent, spec[1]) : siblings[siblings.length - 1] ?? null;
+            if (member && samePosition(member, node) && object && identifierTypes.has(object.type)) {
+                push(node.text, object.text);
+                continue;
+            }
+            // 对象侧（`Foo.BAZ` 里的 Foo）由成员侧那条限定引用覆盖，不再单独产出
+            if (object && samePosition(object, node) && member && identifierTypes.has(member.type)) {
+                continue;
+            }
+        }
+        push(node.text, null);
+    }
+    return refs;
+}
+function declaratorNames(node) {
+    return (0, tree_sitter_1.namedChildren)(node)
+        .filter((c) => c.type === "identifier" || c.type === "type_identifier")
+        .map((c) => c.text);
+}
+/** TS 顶层语句里按名字找声明（含 export 包装、const 箭头函数、default 导出） */
+function findTsTopLevel(root, language, name) {
+    for (const stmt of (0, tree_sitter_1.namedChildren)(root)) {
+        const isExport = stmt.type === "export_statement";
+        const target = isExport ? field(stmt, "declaration") ?? field(stmt, "value") : stmt;
+        if (!target)
+            continue;
+        if (name === "default") {
+            if (!isExport || !hasAnonymousChild(stmt, "default"))
+                continue;
+            if (target.type === "identifier")
+                return findTsTopLevel(root, language, target.text);
+            const decl = classifyNode(target, language);
+            return decl ?? makeDeclaration(stmt, "value", "default", null);
+        }
+        if (target.type === "lexical_declaration" || target.type === "variable_declaration") {
+            for (const declarator of (0, tree_sitter_1.namedChildren)(target)) {
+                if (declarator.type !== "variable_declarator")
+                    continue;
+                if (field(declarator, "name")?.text !== name)
+                    continue;
+                const value = field(declarator, "value");
+                if (value && (TS_FUNCTION_EXPRESSIONS.has(value.type) || value.type === "class")) {
+                    return classifyNode(value, language) ?? makeDeclaration(liftExport(target), "value", name, null);
+                }
+                return makeDeclaration(liftExport(target), "value", name, null);
+            }
+            continue;
+        }
+        if (field(target, "name")?.text === name) {
+            const decl = classifyNode(target, language);
+            if (decl)
+                return decl;
+        }
+    }
+    return null;
+}
+function findGoTopLevel(root, name) {
+    for (const stmt of (0, tree_sitter_1.namedChildren)(root)) {
+        if (stmt.type === "function_declaration" && field(stmt, "name")?.text === name) {
+            return classifyNode(stmt, "go");
+        }
+        if (stmt.type === "type_declaration") {
+            for (const spec of (0, tree_sitter_1.namedChildren)(stmt)) {
+                if ((spec.type === "type_spec" || spec.type === "type_alias") && field(spec, "name")?.text === name) {
+                    const node = (0, tree_sitter_1.namedChildren)(stmt).length > 1 ? spec : stmt;
+                    return makeDeclaration(node, "type", name, null);
+                }
+            }
+            continue;
+        }
+        if (GO_VALUE.has(stmt.type)) {
+            for (const spec of (0, tree_sitter_1.namedChildren)(stmt)) {
+                if (spec.type !== "const_spec" && spec.type !== "var_spec")
+                    continue;
+                if (declaratorNames(spec).includes(name)) {
+                    return makeDeclaration(spec, "value", name, null);
+                }
+            }
+        }
+    }
+    return null;
+}
+function javaMemberName(member) {
+    if (member.type === "field_declaration") {
+        return (0, tree_sitter_1.namedChildren)(member)
+            .filter((c) => c.type === "variable_declarator")
+            .map((c) => field(c, "name")?.text ?? "")
+            .filter(Boolean);
+    }
+    if (member.type === "enum_constant") {
+        return [field(member, "name")?.text ?? (0, tree_sitter_1.namedChildren)(member)[0]?.text ?? ""].filter(Boolean);
+    }
+    const name = field(member, "name")?.text;
+    return name ? [name] : [];
+}
+function javaBodyMembers(body) {
+    const members = [];
+    for (const child of (0, tree_sitter_1.namedChildren)(body)) {
+        if (child.type === "enum_body_declarations")
+            members.push(...(0, tree_sitter_1.namedChildren)(child));
+        else
+            members.push(child);
+    }
+    return members;
+}
+/** 类成员的名字（一个成员可能声明多个名字：Java 字段列表、Kotlin 解构、Swift 多 case） */
+function memberNames(member, language) {
+    if (language === "java")
+        return javaMemberName(member);
+    if (language === "kotlin") {
+        switch (member.type) {
+            case "property_declaration":
+                return kotlinPropertyNames(member);
+            case "enum_entry": {
+                const id = firstChild(member, "identifier");
+                return id ? [id.text] : [];
+            }
+            case "companion_object":
+                return [field(member, "name")?.text ?? "Companion"];
+            case "secondary_constructor":
+                return ["constructor"];
+            case "anonymous_initializer":
+                return ["init"];
+            case "type_alias": {
+                const name = field(member, "type")?.text ?? firstChild(member, "identifier")?.text;
+                return name ? [name] : [];
+            }
+            default: {
+                const name = field(member, "name")?.text;
+                return name ? [name] : [];
+            }
+        }
+    }
+    if (language === "swift") {
+        switch (member.type) {
+            case "property_declaration":
+            case "protocol_property_declaration":
+                return swiftPropertyNames(member);
+            case "enum_entry":
+                return (0, tree_sitter_1.namedChildren)(member)
+                    .filter((c) => c.type === "simple_identifier")
+                    .map((c) => c.text);
+            case "init_declaration":
+                return ["init"];
+            case "deinit_declaration":
+                return ["deinit"];
+            case "subscript_declaration":
+                return ["subscript"];
+            default: {
+                const name = field(member, "name")?.text;
+                return name ? [name] : [];
+            }
+        }
+    }
+    return [field(member, "name")?.text ?? ""];
+}
+/** 类体里的成员列表；Kotlin 把 companion object 的成员一并展开（`Outer.member` 可直接引用） */
+function bodyMembers(body, language) {
+    if (language === "java")
+        return javaBodyMembers(body);
+    if (language === "kotlin") {
+        const members = [];
+        for (const child of (0, tree_sitter_1.namedChildren)(body)) {
+            members.push(child);
+            if (child.type === "companion_object") {
+                const inner = firstChild(child, "class_body");
+                if (inner)
+                    members.push(...(0, tree_sitter_1.namedChildren)(inner));
+            }
+        }
+        return members;
+    }
+    return (0, tree_sitter_1.namedChildren)(body);
+}
+/** 类声明的类体节点：TS / Java / Swift 有 body 字段，Kotlin 靠子节点类型 */
+function classBodyOf(decl) {
+    const classNode = decl.node.type === "export_statement" ? field(decl.node, "declaration") ?? decl.node : decl.node;
+    return (field(classNode, "body") ??
+        firstChild(classNode, "class_body", "enum_class_body", "protocol_body"));
+}
+function findJavaTopLevel(root, name) {
+    for (const stmt of (0, tree_sitter_1.namedChildren)(root)) {
+        if (JAVA_TOP_LEVEL_TYPES.has(stmt.type) && field(stmt, "name")?.text === name) {
+            return classifyNode(stmt, "java");
+        }
+    }
+    return null;
+}
+/** Kotlin 顶层：class / interface / object / fun / val / typealias 都按名字匹配 */
+function findKotlinTopLevel(root, name) {
+    for (const stmt of (0, tree_sitter_1.namedChildren)(root)) {
+        if (isCommentNode(stmt) || !memberNames(stmt, "kotlin").includes(name))
+            continue;
+        return classifyNode(stmt, "kotlin") ?? makeDeclaration(stmt, "value", name, null);
+    }
+    return null;
+}
+/**
+ * Swift 顶层：同一文件可能同时有主声明与若干 extension；有成员名时优先含该成员的声明，
+ * 否则主声明优先于 extension。
+ */
+function findSwiftTopLevel(root, name, member) {
+    let primary = null;
+    let extension = null;
+    for (const stmt of (0, tree_sitter_1.namedChildren)(root)) {
+        if (isCommentNode(stmt) || !memberNames(stmt, "swift").includes(name))
+            continue;
+        const decl = classifyNode(stmt, "swift") ?? makeDeclaration(stmt, "value", name, null);
+        if (member && decl.kind === "class" && memberOf(decl, "swift", member))
+            return decl;
+        const isExtension = stmt.type === "class_declaration" && anonymousChildren(stmt).includes("extension");
+        if (isExtension) {
+            if (!extension)
+                extension = decl;
+        }
+        else if (!primary) {
+            primary = decl;
+        }
+    }
+    return primary ?? extension;
+}
+function memberOf(decl, language, member) {
+    const classBody = classBodyOf(decl);
+    if (!classBody)
+        return null;
+    for (const m of bodyMembers(classBody, language)) {
+        if (isCommentNode(m))
+            continue;
+        if (!memberNames(m, language).includes(member))
+            continue;
+        const classified = classifyNode(m, language);
+        if (classified)
+            return classified;
+        return makeDeclaration(m, "value", member, null);
+    }
+    return null;
+}
+/** 在目标文件的语法树里按名字找顶层声明；member 用于 `Foo.BAR` 这类类成员引用 */
+function findDeclaration(root, language, name, member) {
+    let decl = null;
+    if (isTsLike(language))
+        decl = findTsTopLevel(root, language, name);
+    else if (language === "go")
+        decl = findGoTopLevel(root, name);
+    else if (language === "java")
+        decl = findJavaTopLevel(root, name);
+    else if (language === "kotlin")
+        decl = findKotlinTopLevel(root, name);
+    else
+        decl = findSwiftTopLevel(root, name, member);
+    if (!decl)
+        return null;
+    const memberDecl = member && decl.kind === "class" ? memberOf(decl, language, member) : null;
+    return { decl, member: memberDecl };
+}
+function isPublicMember(member, language) {
+    if (language === "java") {
+        if (member.type === "enum_constant")
+            return true;
+        const modifiers = firstChild(member, "modifiers")?.text ?? "";
+        if (/\bprivate\b|\bprotected\b/.test(modifiers))
+            return false;
+        return /\bpublic\b/.test(modifiers) || modifiers === "";
+    }
+    if (language === "kotlin" || language === "swift") {
+        if (member.type === "enum_entry")
+            return true;
+        const modifiers = firstChild(member, "modifiers");
+        if (!modifiers)
+            return true;
+        for (const mod of (0, tree_sitter_1.namedChildren)(modifiers)) {
+            if (mod.type !== "visibility_modifier")
+                continue;
+            // Swift 的 `private(set)` 只限制写入，读仍是公开的
+            const text = mod.text.replace(/\s+/g, "");
+            if (language === "kotlin" && /^(private|protected)$/.test(text))
+                return false;
+            if (language === "swift" && /^(private|fileprivate)$/.test(text))
+                return false;
+        }
+        return true;
+    }
+    const accessibility = member.children.find((c) => c !== null && c.type === "accessibility_modifier");
+    if (accessibility && /private|protected/.test(accessibility.text))
+        return false;
+    const name = field(member, "name")?.text ?? "";
+    return !name.startsWith("#");
+}
+/**
+ * 决定渲染哪些行（1-based 闭区间，已排序不重叠）：
+ *   函数 → 签名；类型/值 → 整体但封顶 MAX_TYPE_LINES；
+ *   类 → 类头 + 被引用成员的签名（无具体成员时列公开成员签名），封顶 MAX_TYPE_LINES。
+ */
+function renderRanges(found, language) {
+    const { decl, member } = found;
+    if (decl.kind === "function")
+        return [[decl.startLine, decl.headerEndLine]];
+    if (decl.kind !== "class") {
+        return [[decl.startLine, Math.min(decl.endLine, decl.startLine + exports.MAX_TYPE_LINES - 1)]];
+    }
+    const ranges = [[decl.startLine, decl.headerEndLine]];
+    let used = decl.headerEndLine - decl.startLine + 1;
+    const pushRange = (start, end) => {
+        const last = ranges[ranges.length - 1];
+        if (start <= last[1])
+            return; // 已在类头范围内
+        const capped = Math.min(end, start + Math.max(0, exports.MAX_TYPE_LINES - used) - 1);
+        if (capped < start)
+            return;
+        ranges.push([start, capped]);
+        used += capped - start + 1;
+    };
+    if (member) {
+        pushRange(member.startLine, member.headerEndLine);
+        return ranges;
+    }
+    const body = classBodyOf(decl);
+    if (!body)
+        return ranges;
+    for (const m of bodyMembers(body, language)) {
+        if (used >= exports.MAX_TYPE_LINES)
+            break;
+        if (isCommentNode(m))
+            continue;
+        if (!isPublicMember(m, language))
+            continue;
+        const classified = classifyNode(m, language);
+        const end = classified ? classified.headerEndLine : Math.min((0, tree_sitter_1.endLine)(m), (0, tree_sitter_1.startLine)(m));
+        pushRange((0, tree_sitter_1.startLine)(m), end);
+    }
+    return ranges;
+}
+/**
+ * 语法树不可用（超大文件解析超时、运行时缺失）时的兜底：按行正则找声明头。
+ * 只认「行首就是声明」的常见形态，找不到就返回空。
+ */
+function findDeclarationByRegex(lines, language, name) {
+    const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const patterns = isTsLike(language)
+        ? [
+            new RegExp(`^\\s*(export\\s+)?(default\\s+)?(declare\\s+)?(abstract\\s+)?(async\\s+)?(function\\*?\\s+${escaped}\\b|class\\s+${escaped}\\b|interface\\s+${escaped}\\b|type\\s+${escaped}\\b|enum\\s+${escaped}\\b|(const|let|var)\\s+${escaped}\\b)`),
+        ]
+        : language === "go"
+            ? [
+                new RegExp(`^\\s*func\\s+(\\([^)]*\\)\\s*)?${escaped}\\s*[\\[(]`),
+                new RegExp(`^\\s*type\\s+${escaped}\\b`),
+                new RegExp(`^\\s*(const|var)\\s+${escaped}\\b`),
+                new RegExp(`^\\s*${escaped}\\b[^=]*=`),
+            ]
+            : language === "java"
+                ? [
+                    new RegExp(`^\\s*((public|private|protected|static|final|abstract|sealed|non-sealed)\\s+)*(class|interface|enum|record|@interface)\\s+${escaped}\\b`),
+                ]
+                : language === "kotlin"
+                    ? [
+                        // 修饰符 / 注解前缀宽松匹配；fun 可带类型参数与接收者（`fun <T> List<T>.foo`）
+                        new RegExp(`^\\s*(?:[\\w@:.()"']+\\s+)*(?:class|interface|object|typealias|val|var|fun)(?:\\s*<[^>]*>)?(?:\\s+[\\w.<>?]+\\.)?\\s*\`?${escaped}\`?\\b`),
+                    ]
+                    : [
+                        // swift
+                        new RegExp(`^\\s*(?:@\\w+(?:\\([^)]*\\))?\\s+)*(?:(?:public|private|fileprivate|internal|open|final|indirect|static|class|dynamic|override|mutating|lazy|weak|unowned|nonisolated|package|convenience|required)(?:\\([^)]*\\))?\\s+)*(?:class|struct|enum|protocol|actor|typealias|extension|func|let|var|case|init)\\s+${escaped}\\b`),
+                    ];
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (!line.includes(name))
+            continue;
+        if (!patterns.some((p) => p.test(line)))
+            continue;
+        let end = i;
+        if (!/[{;=]/.test(line)) {
+            for (let j = i + 1; j < Math.min(lines.length, i + 5); j++) {
+                end = j;
+                if (/[{;]/.test(lines[j]))
+                    break;
+            }
+        }
+        return [[i + 1, end + 1]];
+    }
+    return [];
+}
+//# sourceMappingURL=symbols.js.map