mindweave 0.0.1 → 2.1.2

package/dist/alternator/chassis/treesitter.js

@@ -0,0 +1,608 @@
+/**
+ * treesitter.ts — the universal extraction tier.
+ *
+ * Parses any supported language with tree-sitter (WASM, in-process) and pulls out
+ * definitions and references via tag queries. This is the
+ * always-available layer: it needs no language server, just a bundled grammar.
+ * Facts from here are `name-level` (matched by name, not resolved), which the
+ * graph records so the model knows to defer to grep/read when it matters.
+ *
+ * Grammars come from `tree-sitter-wasms`; the runtime from `web-tree-sitter`.
+ */
+import { readFile } from "node:fs/promises";
+import { createRequire } from "node:module";
+import { dirname, extname, join } from "node:path";
+import Parser from "web-tree-sitter";
+import { pickNearest } from "../../tools/spanCore.js";
+import { extractDomRefs } from "./domRefs.js";
+import { IN_WORKER, isolatedExtract, isolatedSpan } from "./isolation.js";
+// Inside the isolation worker every grammar runs in-process ON PURPOSE — that is where
+// a fatal compile, and the memory a parse retains, are allowed to accumulate and die.
+// `IN_WORKER` (owned by isolation.ts) is what breaks the recursion.
+// web-tree-sitter is pinned to the 0.20.x era to match tree-sitter-wasms' grammar
+// ABI (its grammars are built with tree-sitter-cli 0.20.8). Newer runtimes use a
+// dynamic-linking loader that rejects these grammars. This is the proven combo.
+const require = createRequire(import.meta.url);
+const WASM_DIR = join(dirname(require.resolve("tree-sitter-wasms/package.json")), "out");
+const TS_QUERY = `
+(function_declaration name: (identifier) @definition.function)
+(method_definition name: (property_identifier) @definition.method)
+(class_declaration name: (type_identifier) @definition.class)
+(interface_declaration name: (type_identifier) @definition.interface)
+(type_alias_declaration name: (type_identifier) @definition.type)
+(enum_declaration name: (identifier) @definition.enum)
+(variable_declarator name: (identifier) @definition.function value: [(arrow_function) (function_expression)])
+(public_field_definition name: (property_identifier) @definition.field)
+(call_expression function: (identifier) @reference)
+(call_expression function: (member_expression property: (property_identifier) @reference))
+(new_expression constructor: (identifier) @reference)
+(import_statement source: (string) @import)
+(export_statement source: (string) @import)
+`;
+const JS_QUERY = `
+(function_declaration name: (identifier) @definition.function)
+(method_definition name: (property_identifier) @definition.method)
+(class_declaration name: (identifier) @definition.class)
+(variable_declarator name: (identifier) @definition.function value: [(arrow_function) (function_expression)])
+(call_expression function: (identifier) @reference)
+(call_expression function: (member_expression property: (property_identifier) @reference))
+(new_expression constructor: (identifier) @reference)
+(import_statement source: (string) @import)
+(export_statement source: (string) @import)
+`;
+const PY_QUERY = `
+(function_definition name: (identifier) @definition.function)
+(class_definition name: (identifier) @definition.class)
+(call function: (identifier) @reference)
+(call function: (attribute attribute: (identifier) @reference))
+(import_from_statement module_name: (dotted_name) @import)
+(import_statement name: (dotted_name) @import)
+`;
+// ── The broad language set (validated against each real grammar wasm) ───────────
+// Every query below was probed against tree-sitter-wasms' actual grammar so it both
+// COMPILES (a bad node name throws at load) and extracts real defs/refs. Adding a
+// language here is all it takes — the graph, outline, ranking, and read_symbol all
+// flow from these captures.
+const GO_QUERY = `
+(function_declaration name: (identifier) @definition.function)
+(method_declaration name: (field_identifier) @definition.method)
+(type_declaration (type_spec name: (type_identifier) @definition.type))
+(call_expression function: (identifier) @reference)
+(call_expression function: (selector_expression field: (field_identifier) @reference))
+`;
+const RUST_QUERY = `
+(function_item name: (identifier) @definition.function)
+(struct_item name: (type_identifier) @definition.struct)
+(enum_item name: (type_identifier) @definition.enum)
+(trait_item name: (type_identifier) @definition.trait)
+(mod_item name: (identifier) @definition.module)
+(call_expression function: (identifier) @reference)
+(call_expression function: (field_expression field: (field_identifier) @reference))
+(macro_invocation macro: (identifier) @reference)
+`;
+const JAVA_QUERY = `
+(class_declaration name: (identifier) @definition.class)
+(interface_declaration name: (identifier) @definition.interface)
+(enum_declaration name: (identifier) @definition.enum)
+(method_declaration name: (identifier) @definition.method)
+(constructor_declaration name: (identifier) @definition.method)
+(method_invocation name: (identifier) @reference)
+(object_creation_expression type: (type_identifier) @reference)
+`;
+const C_QUERY = `
+(function_definition declarator: (function_declarator declarator: (identifier) @definition.function))
+(struct_specifier name: (type_identifier) @definition.struct)
+(enum_specifier name: (type_identifier) @definition.enum)
+(type_definition declarator: (type_identifier) @definition.type)
+(call_expression function: (identifier) @reference)
+`;
+const CPP_QUERY = `
+(function_definition declarator: (function_declarator declarator: (identifier) @definition.function))
+(class_specifier name: (type_identifier) @definition.class)
+(struct_specifier name: (type_identifier) @definition.struct)
+(enum_specifier name: (type_identifier) @definition.enum)
+(call_expression function: (identifier) @reference)
+(call_expression function: (field_expression field: (field_identifier) @reference))
+`;
+const CSHARP_QUERY = `
+(class_declaration name: (identifier) @definition.class)
+(interface_declaration name: (identifier) @definition.interface)
+(struct_declaration name: (identifier) @definition.struct)
+(enum_declaration name: (identifier) @definition.enum)
+(method_declaration name: (identifier) @definition.method)
+(invocation_expression function: (identifier) @reference)
+(invocation_expression function: (member_access_expression name: (identifier) @reference))
+`;
+const PHP_QUERY = `
+(function_definition name: (name) @definition.function)
+(method_declaration name: (name) @definition.method)
+(class_declaration name: (name) @definition.class)
+(interface_declaration name: (name) @definition.interface)
+(trait_declaration name: (name) @definition.trait)
+(function_call_expression function: (name) @reference)
+(member_call_expression name: (name) @reference)
+`;
+const LUA_QUERY = `
+(function_definition_statement (identifier) @definition.function)
+(local_function_definition_statement (identifier) @definition.function)
+(call (variable (identifier) @reference))
+`;
+const SCALA_QUERY = `
+(function_definition name: (identifier) @definition.function)
+(class_definition name: (identifier) @definition.class)
+(object_definition name: (identifier) @definition.module)
+(trait_definition name: (identifier) @definition.trait)
+(call_expression function: (identifier) @reference)
+`;
+const BASH_QUERY = `
+(function_definition name: (word) @definition.function)
+(command name: (command_name) @reference)
+`;
+const OCAML_QUERY = `
+(value_definition (let_binding pattern: (value_name) @definition.function))
+(type_definition (type_binding name: (type_constructor) @definition.type))
+`;
+const ZIG_QUERY = `
+(function_declaration name: (identifier) @definition.function)
+`;
+const SOLIDITY_QUERY = `
+(contract_declaration name: (identifier) @definition.class)
+(function_definition name: (identifier) @definition.function)
+`;
+const SWIFT_QUERY = `
+(function_declaration name: (simple_identifier) @definition.function)
+(class_declaration name: (type_identifier) @definition.class)
+(protocol_declaration name: (type_identifier) @definition.interface)
+(call_expression (simple_identifier) @reference)
+`;
+/**
+ * The JSX half, appended to the TS/JS query for the grammars that have JSX nodes.
+ *
+ * A component file's render body has no DECLARATIONS in it, so a declaration-only query
+ * goes silent over exactly the part most likely to be edited: measured on a 1,381-line
+ * React component, the outline's last entry was L1128 and the entire render — 18% of the
+ * file, and where the change actually had to go — did not exist in the graph at all. The
+ * model had nothing to navigate by, guessed an offset, missed, and read again.
+ *
+ * The whole attribute node is captured and read in JS rather than matched by grammar
+ * sub-node names, the same choice `markup.ts` makes and for the same reason: the shape
+ * of a `jsx_attribute` differs between grammars and versions, its text does not.
+ */
+const JSX_QUERY = `
+(jsx_attribute) @jsx.attribute
+`;
+const KOTLIN_QUERY = `
+(function_declaration (simple_identifier) @definition.function)
+(class_declaration (type_identifier) @definition.class)
+(object_declaration (type_identifier) @definition.class)
+(call_expression (simple_identifier) @reference)
+`;
+const LANGS = {
+    ".ts": { grammar: "tree-sitter-typescript.wasm", query: TS_QUERY },
+    ".mts": { grammar: "tree-sitter-typescript.wasm", query: TS_QUERY },
+    ".cts": { grammar: "tree-sitter-typescript.wasm", query: TS_QUERY },
+    ".tsx": { grammar: "tree-sitter-tsx.wasm", query: TS_QUERY + JSX_QUERY },
+    ".js": { grammar: "tree-sitter-javascript.wasm", query: JS_QUERY },
+    ".mjs": { grammar: "tree-sitter-javascript.wasm", query: JS_QUERY },
+    ".cjs": { grammar: "tree-sitter-javascript.wasm", query: JS_QUERY },
+    ".jsx": { grammar: "tree-sitter-javascript.wasm", query: JS_QUERY + JSX_QUERY },
+    ".py": { grammar: "tree-sitter-python.wasm", query: PY_QUERY },
+    ".pyi": { grammar: "tree-sitter-python.wasm", query: PY_QUERY },
+    ".go": { grammar: "tree-sitter-go.wasm", query: GO_QUERY },
+    ".rs": { grammar: "tree-sitter-rust.wasm", query: RUST_QUERY },
+    ".java": { grammar: "tree-sitter-java.wasm", query: JAVA_QUERY },
+    ".c": { grammar: "tree-sitter-c.wasm", query: C_QUERY },
+    ".h": { grammar: "tree-sitter-c.wasm", query: C_QUERY },
+    ".cpp": { grammar: "tree-sitter-cpp.wasm", query: CPP_QUERY },
+    ".cc": { grammar: "tree-sitter-cpp.wasm", query: CPP_QUERY },
+    ".cxx": { grammar: "tree-sitter-cpp.wasm", query: CPP_QUERY },
+    ".hpp": { grammar: "tree-sitter-cpp.wasm", query: CPP_QUERY },
+    ".hh": { grammar: "tree-sitter-cpp.wasm", query: CPP_QUERY },
+    ".hxx": { grammar: "tree-sitter-cpp.wasm", query: CPP_QUERY },
+    ".cs": { grammar: "tree-sitter-c_sharp.wasm", query: CSHARP_QUERY },
+    ".php": { grammar: "tree-sitter-php.wasm", query: PHP_QUERY },
+    ".lua": { grammar: "tree-sitter-lua.wasm", query: LUA_QUERY },
+    ".scala": { grammar: "tree-sitter-scala.wasm", query: SCALA_QUERY },
+    ".sc": { grammar: "tree-sitter-scala.wasm", query: SCALA_QUERY },
+    ".sh": { grammar: "tree-sitter-bash.wasm", query: BASH_QUERY },
+    ".bash": { grammar: "tree-sitter-bash.wasm", query: BASH_QUERY },
+    ".ml": { grammar: "tree-sitter-ocaml.wasm", query: OCAML_QUERY },
+    ".mli": { grammar: "tree-sitter-ocaml.wasm", query: OCAML_QUERY },
+    ".zig": { grammar: "tree-sitter-zig.wasm", query: ZIG_QUERY },
+    ".sol": { grammar: "tree-sitter-solidity.wasm", query: SOLIDITY_QUERY },
+    ".swift": { grammar: "tree-sitter-swift.wasm", query: SWIFT_QUERY },
+    ".kt": { grammar: "tree-sitter-kotlin.wasm", query: KOTLIN_QUERY },
+    ".kts": { grammar: "tree-sitter-kotlin.wasm", query: KOTLIN_QUERY },
+};
+/** Extensions we can extract from (used by the lane to decide what to parse). */
+export function isSupported(absPath) {
+    return extname(absPath).toLowerCase() in LANGS;
+}
+/** The directory holding the grammar wasm files. Exported so the language tests can
+ *  weigh a grammar without duplicating how it is located. */
+export const GRAMMAR_DIR = WASM_DIR;
+/** The grammar wasm filename a path would load, or null if unsupported. */
+export function grammarFileFor(absPath) {
+    return LANGS[extname(absPath).toLowerCase()]?.grammar ?? null;
+}
+/** The JS/TS family — these also carry DOM references to markup names. */
+const JS_TS_EXTS = new Set([".js", ".jsx", ".mjs", ".cjs", ".ts", ".tsx", ".mts", ".cts"]);
+let initPromise;
+const parser = { current: null };
+const langCache = new Map();
+async function ensureInit() {
+    if (!initPromise) {
+        initPromise = Parser.init().then(() => {
+            parser.current = new Parser();
+        });
+    }
+    return initPromise;
+}
+const grammarCache = new Map();
+/** Load a grammar wasm by filename (cached). Shared by the code tier (which also
+ *  compiles a query) and the markup tier (which walks the tree directly). */
+async function loadGrammar(grammarFile) {
+    const cached = grammarCache.get(grammarFile);
+    if (cached)
+        return cached;
+    const bytes = await readFile(join(WASM_DIR, grammarFile));
+    const language = await Parser.Language.load(new Uint8Array(bytes));
+    grammarCache.set(grammarFile, language);
+    return language;
+}
+async function loadLang(def) {
+    const cached = langCache.get(def.grammar);
+    if (cached)
+        return cached;
+    const language = await loadGrammar(def.grammar);
+    const query = language.query(def.query);
+    const entry = { language, query };
+    langCache.set(def.grammar, entry);
+    return entry;
+}
+/**
+ * Parse `code` with a named grammar wasm and return the tree (or null on failure).
+ * The caller OWNS the tree and must `tree.delete()` it. Used by the markup tier to
+ * parse HTML/CSS, which don't fit the code tier's def/ref tag-query shape.
+ */
+export async function parseTree(grammarFile, code) {
+    try {
+        await ensureInit();
+        const language = await loadGrammar(grammarFile);
+        parser.current.setLanguage(language);
+        return parser.current.parse(code);
+    }
+    catch {
+        return null;
+    }
+}
+// Node types that ARE a definition (the smallest enclosing one of these, climbed
+// from a captured name node, is the symbol's full body). Broad across grammars so
+// the tree-sitter fallback works for TS/JS/Python and degrades gracefully elsewhere.
+const DECL_TYPES = new Set([
+    // JS / TS / Python
+    "function_declaration",
+    "function_definition",
+    "function_expression",
+    "generator_function_declaration",
+    "arrow_function",
+    "method_definition",
+    "method_declaration",
+    "class_declaration",
+    "class_definition",
+    "interface_declaration",
+    "type_alias_declaration",
+    "enum_declaration",
+    "variable_declarator",
+    "public_field_definition",
+    "field_definition",
+    // Rust
+    "function_item",
+    "struct_item",
+    "enum_item",
+    "trait_item",
+    "impl_item",
+    "mod_item",
+    // Go
+    "type_declaration",
+    "type_spec",
+    // Java / C#
+    "constructor_declaration",
+    "struct_declaration",
+    // C / C++
+    "struct_specifier",
+    "class_specifier",
+    "enum_specifier",
+    "type_definition",
+    // PHP
+    "trait_declaration",
+    // Lua
+    "function_definition_statement",
+    "local_function_definition_statement",
+    // Scala
+    "object_definition",
+    "trait_definition",
+    // OCaml
+    "value_definition",
+    // Solidity / Swift / Kotlin
+    "contract_declaration",
+    "protocol_declaration",
+    "object_declaration",
+]);
+// Wrappers that belong WITH the definition (so the span includes `export`/decorators).
+const WRAPPER_TYPES = new Set(["export_statement", "decorated_definition", "decorator"]);
+/** Climb from a captured name node to the line span of its whole definition. */
+function enclosingSpan(nameNode) {
+    let node = nameNode.parent;
+    let decl = null;
+    while (node) {
+        if (DECL_TYPES.has(node.type)) {
+            decl = node;
+            break;
+        }
+        node = node.parent;
+    }
+    let top = decl ?? nameNode;
+    // Swallow an `export`/decorator wrapper so the header line isn't left behind.
+    while (top.parent && WRAPPER_TYPES.has(top.parent.type))
+        top = top.parent;
+    return { start: top.startPosition.row + 1, end: top.endPosition.row + 1 };
+}
+/**
+ * The full line span of a symbol named `name` in `code`, from the AST. Structural
+ * (the span IS an AST node), but `name-level` in confidence because the MATCH is by
+ * name — the tree-sitter fallback used when no language server can answer. `nearLine`
+ * disambiguates when the name is defined more than once. Null when it can't be found.
+ */
+export async function treeSitterSpan(absPath, code, name, nearLine) {
+    const def = LANGS[extname(absPath).toLowerCase()];
+    if (!def)
+        return null;
+    // NO grammar parses in this process. See treeSitterExtract for why the old
+    // size-based exemption was wrong.
+    if (!IN_WORKER)
+        return isolatedSpan(def.grammar, absPath, code, name, nearLine);
+    try {
+        await ensureInit();
+        const { language, query } = await loadLang(def);
+        parser.current.setLanguage(language);
+        const tree = parser.current.parse(code);
+        if (!tree)
+            return null;
+        const spans = [];
+        for (const cap of query.captures(tree.rootNode)) {
+            if (!cap.name.startsWith("definition."))
+                continue;
+            if (cap.node.text !== name)
+                continue;
+            spans.push(enclosingSpan(cap.node));
+        }
+        tree.delete();
+        return pickNearest(spans, nearLine);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The first line of a symbol's documentation, if any — a JSDoc/`//` block just
+ * ABOVE the definition (JS/TS/most languages) or a `"""`/`'''` docstring just
+ * BELOW it (Python). Pure and line-based (exported for tests); returns a short,
+ * clean sentence or undefined. Best-effort intent, not a full doc parser.
+ */
+export function extractDoc(lines, defLine1) {
+    // ── comment block immediately above (skip blanks + decorators) ──
+    let i = defLine1 - 2; // 0-based index of the line above the definition
+    while (i >= 0 && (lines[i].trim() === "" || lines[i].trim().startsWith("@")))
+        i--;
+    const above = [];
+    if (i >= 0 && lines[i].includes("*/")) {
+        // A block comment: gather upward to its opening `/*` / `/**`.
+        while (i >= 0) {
+            above.unshift(lines[i]);
+            if (lines[i].includes("/*"))
+                break;
+            i--;
+        }
+    }
+    else {
+        while (i >= 0 && lines[i].trim().startsWith("//")) {
+            above.unshift(lines[i]);
+            i--;
+        }
+    }
+    const fromAbove = firstDocSentence(above);
+    if (fromAbove)
+        return fromAbove;
+    // ── Python docstring on the first line(s) of the body ──
+    let j = defLine1; // 0-based index of the line after the definition
+    while (j < lines.length && lines[j].trim() === "")
+        j++;
+    const m = /^[rbuRBU]*("""|''')(.*)$/.exec(lines[j]?.trim() ?? "");
+    if (m) {
+        const rest = m[2];
+        const close = rest.indexOf(m[1]);
+        const text = (close >= 0 ? rest.slice(0, close) : rest).trim();
+        return clipDoc(text);
+    }
+    return undefined;
+}
+/** Strip comment markers from a gathered block and return its first sentence,
+ *  skipping section dividers (`// ── queries ──`) and tag-only lines (`@param`). */
+function firstDocSentence(block) {
+    for (const raw of block) {
+        const cleaned = raw
+            .replace(/^\s*\/\*\*?/, "")
+            .replace(/\*\/\s*$/, "")
+            .replace(/^\s*\*\s?/, "")
+            .replace(/^\s*\/\/+/, "")
+            .trim();
+        if (cleaned && !cleaned.startsWith("@") && !isDivider(cleaned))
+            return clipDoc(cleaned);
+    }
+    return undefined;
+}
+/** A section divider (`──── queries ────`, `====`, `####`) — not real prose. */
+function isDivider(s) {
+    const dashes = (s.match(/[─\-=*#~_]/g) ?? []).length;
+    const letters = (s.match(/[a-zA-Z]/g) ?? []).length;
+    return dashes >= 4 && dashes >= letters;
+}
+function clipDoc(text) {
+    const one = text.replace(/\s+/g, " ").trim();
+    if (!one)
+        return undefined;
+    // Prefer up to the first sentence end, then hard-cap.
+    const dot = one.search(/[.!?](\s|$)/);
+    const sentence = dot >= 0 ? one.slice(0, dot + 1) : one;
+    return sentence.length > 140 ? `${sentence.slice(0, 139)}…` : sentence;
+}
+const KIND_OF = {
+    function: "function",
+    method: "method",
+    class: "class",
+    interface: "interface",
+    type: "type",
+    enum: "enum",
+    field: "field",
+    variable: "variable",
+    struct: "struct",
+    trait: "trait",
+    module: "module",
+    constant: "constant",
+};
+/** Extract defs + refs from one file. Returns null when the language is
+ *  unsupported or anything fails (the caller degrades to grep/read). */
+export async function treeSitterExtract(absPath, code) {
+    const def = LANGS[extname(absPath).toLowerCase()];
+    if (!def)
+        return null;
+    // NO grammar parses in this process.
+    //
+    // This used to exempt anything under 4.5 MB of grammar wasm, on the theory that only
+    // the oversized grammars were dangerous. Measurement killed that theory: a parse
+    // RETAINS memory that `tree.delete()` does not return, roughly 57-70 MB for one 54 KB
+    // JSX file, and tsx (2.41 MB) and typescript (2.34 MB) sat comfortably under the
+    // threshold while being the two most-used grammars in the product. Grammar file size
+    // predicts the cost of COMPILING a grammar; it says nothing about what a parse keeps.
+    // Indexing 120 ordinary files under the old rule peaked at 1.9 GB in the main
+    // process, where there is nothing to contain it.
+    if (!IN_WORKER)
+        return isolatedExtract(def.grammar, absPath, code);
+    try {
+        await ensureInit();
+        const { language, query } = await loadLang(def);
+        parser.current.setLanguage(language);
+        const tree = parser.current.parse(code);
+        if (!tree)
+            return null;
+        const lines = code.split("\n");
+        const defs = [];
+        const refs = [];
+        const imports = [];
+        // One per FILE: a landmark named twice in the same component is one symbol.
+        const jsxSeen = new Set();
+        for (const cap of query.captures(tree.rootNode)) {
+            const name = cap.node.text;
+            const line = cap.node.startPosition.row + 1;
+            if (cap.name === "import") {
+                const spec = unquote(cap.node.text);
+                if (spec)
+                    imports.push({ spec, line });
+                continue;
+            }
+            if (cap.name.startsWith("definition.")) {
+                const kind = KIND_OF[cap.name.slice("definition.".length)] ?? "other";
+                const span = enclosingSpan(cap.node);
+                defs.push({
+                    name,
+                    kind,
+                    line,
+                    endLine: span.end,
+                    signature: (lines[line - 1] ?? "").trim().slice(0, 200),
+                    doc: extractDoc(lines, line),
+                });
+            }
+            else if (cap.name === "jsx.attribute") {
+                // A JSX landmark: `className="sidebar-header"` / `id="editor"`. The FIRST place a
+                // name appears in the file is its definition (so it lands in the outline and the
+                // render body stops being a blank stretch), every later one a reference — the
+                // same rule the stylesheet tier uses, so a class defined in CSS and used in JSX
+                // meet on the graph's name key and `references` finds both sides.
+                for (const landmark of jsxLandmarks(cap.node.text)) {
+                    const key = `${landmark.kind}:${landmark.name}`;
+                    if (jsxSeen.has(key)) {
+                        refs.push({ name: landmark.name, line });
+                        continue;
+                    }
+                    jsxSeen.add(key);
+                    defs.push({
+                        name: landmark.name,
+                        kind: "element",
+                        line,
+                        endLine: jsxElementEnd(cap.node),
+                        signature: (lines[line - 1] ?? "").trim().slice(0, 200),
+                    });
+                }
+            }
+            else if (cap.name === "reference") {
+                refs.push({ name, line });
+            }
+        }
+        tree.delete();
+        // JS/TS also wire markup by DOM name (getElementById/querySelector/classList):
+        // record those as name-level refs so a standalone script links to a CSS/HTML id.
+        if (JS_TS_EXTS.has(extname(absPath).toLowerCase())) {
+            for (const d of extractDomRefs(code))
+                refs.push({ name: d.name, line: d.line });
+        }
+        return { defs, refs, imports };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The last line of the JSX element an attribute belongs to.
+ *
+ * `enclosingSpan` is for declarations and climbs to the nearest one, which from inside a
+ * render body is the whole component — it reported a 227-line span for a single `<div>`'s
+ * opening tag, which would then be what `read_symbol` handed back. The element's own
+ * extent is the honest answer, and it is one or two parents up.
+ */
+function jsxElementEnd(attribute) {
+    let node = attribute.parent;
+    while (node) {
+        if (node.type === "jsx_element" || node.type === "jsx_self_closing_element") {
+            return node.endPosition.row + 1;
+        }
+        // Stop at the opening tag's own boundary rather than climbing into the component.
+        if (node.type !== "jsx_opening_element")
+            break;
+        node = node.parent;
+    }
+    return attribute.endPosition.row + 1;
+}
+/**
+ * The navigable names in one JSX attribute, or none.
+ *
+ * Only `className` and `id` with a plain string value: those are what a person searches
+ * for and what a stylesheet names, so they are the landmarks worth putting on the map.
+ * `className={cx(...)}` and every other attribute are deliberately skipped — capturing
+ * every `<div>` would bury the outline it is supposed to make readable.
+ */
+function jsxLandmarks(attributeText) {
+    const m = /^(className|id)\s*=\s*["']([^"'{}]+)["']$/.exec(attributeText.trim());
+    if (!m)
+        return [];
+    const kind = m[1] === "id" ? "id" : "class";
+    return m[2]
+        .split(/\s+/)
+        .filter(Boolean)
+        .map((name) => ({ name, kind }));
+}
+/** Strip surrounding quotes from a captured string-literal node's text. */
+function unquote(raw) {
+    return raw.replace(/^["'`]|["'`]$/g, "").trim();
+}
+//# sourceMappingURL=treesitter.js.map

package/dist/alternator/chassis/treesitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"treesitter.js","sourceRoot":"","sources":["../../../src/alternator/chassis/treesitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,MAAM,MAAM,iBAAiB,CAAC;AAErC,OAAO,EAAE,WAAW,EAAiB,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE1E,uFAAuF;AACvF,sFAAsF;AACtF,oEAAoE;AAEpE,kFAAkF;AAClF,iFAAiF;AACjF,gFAAgF;AAChF,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAiCzF,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;CAchB,CAAC;AAEF,MAAM,QAAQ,GAAG;;;;;;;;;;CAUhB,CAAC;AAEF,MAAM,QAAQ,GAAG;;;;;;;CAOhB,CAAC;AAEF,mFAAmF;AACnF,oFAAoF;AACpF,kFAAkF;AAClF,mFAAmF;AACnF,4BAA4B;AAE5B,MAAM,QAAQ,GAAG;;;;;;CAMhB,CAAC;AAEF,MAAM,UAAU,GAAG;;;;;;;;;CASlB,CAAC;AAEF,MAAM,UAAU,GAAG;;;;;;;;CAQlB,CAAC;AAEF,MAAM,OAAO,GAAG;;;;;;CAMf,CAAC;AAEF,MAAM,SAAS,GAAG;;;;;;;CAOjB,CAAC;AAEF,MAAM,YAAY,GAAG;;;;;;;;CAQpB,CAAC;AAEF,MAAM,SAAS,GAAG;;;;;;;;CAQjB,CAAC;AAEF,MAAM,SAAS,GAAG;;;;CAIjB,CAAC;AAEF,MAAM,WAAW,GAAG;;;;;;CAMnB,CAAC;AAEF,MAAM,UAAU,GAAG;;;CAGlB,CAAC;AAEF,MAAM,WAAW,GAAG;;;CAGnB,CAAC;AAEF,MAAM,SAAS,GAAG;;CAEjB,CAAC;AAEF,MAAM,cAAc,GAAG;;;CAGtB,CAAC;AAEF,MAAM,WAAW,GAAG;;;;;CAKnB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,SAAS,GAAG;;CAEjB,CAAC;AAEF,MAAM,YAAY,GAAG;;;;;CAKpB,CAAC;AAEF,MAAM,KAAK,GAA4B;IACrC,KAAK,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,KAAK,EAAE,QAAQ,EAAE;IAClE,MAAM,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,KAAK,EAAE,QAAQ,EAAE;IACnE,MAAM,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,KAAK,EAAE,QAAQ,EAAE;IACnE,MAAM,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,QAAQ,GAAG,SAAS,EAAE;IACxE,KAAK,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,KAAK,EAAE,QAAQ,EAAE;IAClE,MAAM,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,KAAK,EAAE,QAAQ,EAAE;IACnE,MAAM,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,KAAK,EAAE,QAAQ,EAAE;IACnE,MAAM,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,KAAK,EAAE,QAAQ,GAAG,SAAS,EAAE;IAC/E,KAAK,EAAE,EAAE,OAAO,EAAE,yBAAyB,EAAE,KAAK,EAAE,QAAQ,EAAE;IAC9D,MAAM,EAAE,EAAE,OAAO,EAAE,yBAAyB,EAAE,KAAK,EAAE,QAAQ,EAAE;IAC/D,KAAK,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,KAAK,EAAE,QAAQ,EAAE;IAC1D,KAAK,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE,KAAK,EAAE,UAAU,EAAE;IAC9D,OAAO,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE,KAAK,EAAE,UAAU,EAAE;IAChE,IAAI,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAO,EAAE;IACvD,IAAI,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAO,EAAE;IACvD,MAAM,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,SAAS,EAAE;IAC7D,KAAK,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,SAAS,EAAE;IAC5D,MAAM,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,SAAS,EAAE;IAC7D,MAAM,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,SAAS,EAAE;IAC7D,KAAK,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,SAAS,EAAE;IAC5D,MAAM,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,SAAS,EAAE;IAC7D,KAAK,EAAE,EAAE,OAAO,EAAE,0BAA0B,EAAE,KAAK,EAAE,YAAY,EAAE;IACnE,MAAM,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,SAAS,EAAE;IAC7D,MAAM,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,SAAS,EAAE;IAC7D,QAAQ,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,WAAW,EAAE;IACnE,KAAK,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,WAAW,EAAE;IAChE,KAAK,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE,KAAK,EAAE,UAAU,EAAE;IAC9D,OAAO,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE,KAAK,EAAE,UAAU,EAAE;IAChE,KAAK,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,WAAW,EAAE;IAChE,MAAM,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,WAAW,EAAE;IACjE,MAAM,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,KAAK,EAAE,SAAS,EAAE;IAC7D,MAAM,EAAE,EAAE,OAAO,EAAE,2BAA2B,EAAE,KAAK,EAAE,cAAc,EAAE;IACvE,QAAQ,EAAE,EAAE,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,WAAW,EAAE;IACnE,KAAK,EAAE,EAAE,OAAO,EAAE,yBAAyB,EAAE,KAAK,EAAE,YAAY,EAAE;IAClE,MAAM,EAAE,EAAE,OAAO,EAAE,yBAAyB,EAAE,KAAK,EAAE,YAAY,EAAE;CACpE,CAAC;AAEF,iFAAiF;AACjF,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC;AACjD,CAAC;AAED;6DAC6D;AAC7D,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;AAEpC,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC;AAChE,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAK3F,IAAI,WAAsC,CAAC;AAC3C,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,IAAqB,EAAE,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAgD,CAAC;AAE1E,KAAK,UAAU,UAAU;IACvB,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;YACpC,MAAM,CAAC,OAAO,GAAG,IAAI,MAAM,EAAE,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,YAAY,GAAG,IAAI,GAAG,EAAoB,CAAC;AAEjD;6EAC6E;AAC7E,KAAK,UAAU,WAAW,CAAC,WAAmB;IAC5C,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC7C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,YAAY,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACxC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,GAAY;IAClC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAClC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,WAAmB,EAAE,IAAY;IAC/D,IAAI,CAAC;QACH,MAAM,UAAU,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,CAAC,OAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACtC,OAAO,MAAM,CAAC,OAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,kFAAkF;AAClF,qFAAqF;AACrF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,mBAAmB;IACnB,sBAAsB;IACtB,qBAAqB;IACrB,qBAAqB;IACrB,gCAAgC;IAChC,gBAAgB;IAChB,mBAAmB;IACnB,oBAAoB;IACpB,mBAAmB;IACnB,kBAAkB;IAClB,uBAAuB;IACvB,wBAAwB;IACxB,kBAAkB;IAClB,qBAAqB;IACrB,yBAAyB;IACzB,kBAAkB;IAClB,OAAO;IACP,eAAe;IACf,aAAa;IACb,WAAW;IACX,YAAY;IACZ,WAAW;IACX,UAAU;IACV,KAAK;IACL,kBAAkB;IAClB,WAAW;IACX,YAAY;IACZ,yBAAyB;IACzB,oBAAoB;IACpB,UAAU;IACV,kBAAkB;IAClB,iBAAiB;IACjB,gBAAgB;IAChB,iBAAiB;IACjB,MAAM;IACN,mBAAmB;IACnB,MAAM;IACN,+BAA+B;IAC/B,qCAAqC;IACrC,QAAQ;IACR,mBAAmB;IACnB,kBAAkB;IAClB,QAAQ;IACR,kBAAkB;IAClB,4BAA4B;IAC5B,sBAAsB;IACtB,sBAAsB;IACtB,oBAAoB;CACrB,CAAC,CAAC;AAEH,uFAAuF;AACvF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,kBAAkB,EAAE,sBAAsB,EAAE,WAAW,CAAC,CAAC,CAAC;AAEzF,gFAAgF;AAChF,SAAS,aAAa,CAAC,QAA2B;IAChD,IAAI,IAAI,GAA6B,QAAQ,CAAC,MAAM,CAAC;IACrD,IAAI,IAAI,GAA6B,IAAI,CAAC;IAC1C,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,IAAI,GAAG,IAAI,CAAC;YACZ,MAAM;QACR,CAAC;QACD,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IACD,IAAI,GAAG,GAAG,IAAI,IAAI,QAAQ,CAAC;IAC3B,8EAA8E;IAC9E,OAAO,GAAG,CAAC,MAAM,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;IAC1E,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,aAAa,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAe,EACf,IAAY,EACZ,IAAY,EACZ,QAAiB;IAEjB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,2EAA2E;IAC3E,kCAAkC;IAClC,IAAI,CAAC,SAAS;QAAE,OAAO,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAChF,IAAI,CAAC;QACH,MAAM,UAAU,EAAE,CAAC;QACnB,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,CAAC,OAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,MAAM,KAAK,GAAe,EAAE,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;gBAAE,SAAS;YAClD,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI;gBAAE,SAAS;YACrC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAe,EAAE,QAAgB;IAC1D,mEAAmE;IACnE,IAAI,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,iDAAiD;IACvE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAAE,CAAC,EAAE,CAAC;IACpF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,8DAA8D;QAC9D,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACd,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;YACzB,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,MAAM;YACpC,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;YACzB,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IACD,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAEhC,0DAA0D;IAC1D,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,iDAAiD;IACnE,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,CAAC,EAAE,CAAC;IACxD,MAAM,CAAC,GAAG,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,IAAI,CAAC,EAAE,CAAC;QACN,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/D,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;oFACoF;AACpF,SAAS,gBAAgB,CAAC,KAAe;IACvC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,GAAG;aAChB,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;aAC1B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;aACvB,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;aACxB,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;aACxB,IAAI,EAAE,CAAC;QACV,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,gFAAgF;AAChF,SAAS,SAAS,CAAC,CAAS;IAC1B,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACrD,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACpD,OAAO,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,OAAO,CAAC;AAC1C,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,sDAAsD;IACtD,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACxD,OAAO,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;AACzE,CAAC;AAED,MAAM,OAAO,GAA+B;IAC1C,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF;wEACwE;AACxE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAe,EAAE,IAAY;IACnE,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,qCAAqC;IACrC,EAAE;IACF,qFAAqF;IACrF,iFAAiF;IACjF,sFAAsF;IACtF,iFAAiF;IACjF,qFAAqF;IACrF,sFAAsF;IACtF,8EAA8E;IAC9E,iDAAiD;IACjD,IAAI,CAAC,SAAS;QAAE,OAAO,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACnE,IAAI,CAAC;QACH,MAAM,UAAU,EAAE,CAAC;QACnB,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,CAAC,OAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QAEvB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAmB,EAAE,CAAC;QAChC,MAAM,IAAI,GAAmB,EAAE,CAAC;QAChC,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,4EAA4E;QAC5E,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,GAAG,CAAC,CAAC;YAC5C,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpC,IAAI,IAAI;oBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvC,SAAS;YACX,CAAC;YACD,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBACvC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC;gBACtE,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACrC,IAAI,CAAC,IAAI,CAAC;oBACR,IAAI;oBACJ,IAAI;oBACJ,IAAI;oBACJ,OAAO,EAAE,IAAI,CAAC,GAAG;oBACjB,SAAS,EAAE,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;oBACvD,GAAG,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC;iBAC7B,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBACxC,kFAAkF;gBAClF,iFAAiF;gBACjF,8EAA8E;gBAC9E,gFAAgF;gBAChF,kEAAkE;gBAClE,KAAK,MAAM,QAAQ,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnD,MAAM,GAAG,GAAG,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;oBAChD,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBACrB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;wBACzC,SAAS;oBACX,CAAC;oBACD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACjB,IAAI,CAAC,IAAI,CAAC;wBACR,IAAI,EAAE,QAAQ,CAAC,IAAI;wBACnB,IAAI,EAAE,SAAS;wBACf,IAAI;wBACJ,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;wBAChC,SAAS,EAAE,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;qBACxD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACpC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,+EAA+E;QAC/E,iFAAiF;QACjF,IAAI,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YACnD,KAAK,MAAM,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,aAAa,CAAC,SAA4B;IACjD,IAAI,IAAI,GAA6B,SAAS,CAAC,MAAM,CAAC;IACtD,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,IAAI,IAAI,CAAC,IAAI,KAAK,0BAA0B,EAAE,CAAC;YAC5E,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC;QAClC,CAAC;QACD,kFAAkF;QAClF,IAAI,IAAI,CAAC,IAAI,KAAK,qBAAqB;YAAE,MAAM;QAC/C,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IACD,OAAO,SAAS,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,YAAY,CAAC,aAAqB;IACzC,MAAM,CAAC,GAAG,2CAA2C,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC;IACjF,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAClB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5C,OAAO,CAAC,CAAC,CAAC,CAAE;SACT,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,2EAA2E;AAC3E,SAAS,OAAO,CAAC,GAAW;IAC1B,OAAO,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC"}

package/dist/alternator/chassis/types.js

@@ -0,0 +1,24 @@
+/**
+ * types.ts — the typed contract for the chassis (Mindweave's code map).
+ *
+ * The whole point of doing this in TypeScript instead of a loosely-typed graph
+ * is that the compiler enforces the invariants:
+ *
+ *  - **Branded ids** (`FileId`, `SymbolId`) are nominally distinct from plain
+ *    strings and from each other, so you cannot pass a file path where a symbol
+ *    id is expected — a whole class of graph-corruption bugs becomes a type error.
+ *  - **Discriminated unions** + exhaustive `switch` (via `assertNever`) mean
+ *    adding a symbol kind or source fails to compile until it's handled everywhere.
+ *  - **`Confidence` is in the result type**, so every consumer is forced to know
+ *    whether an answer is compiler-`resolved` (LSP) or `name-level` (tree-sitter)
+ *    and defer to grep/read accordingly. The "graph is an assistant, not an
+ *    authority" rule is a contract here, not a comment.
+ */
+export const asFileId = (abs) => abs.split("\\").join("/");
+export const makeSymbolId = (file, name, line) => `${file}#${name}@${line}`;
+/** Exhaustiveness helper: a `default: assertNever(x)` fails to compile if a new
+ *  union member is added but not handled. */
+export function assertNever(x) {
+    throw new Error(`Unhandled case: ${JSON.stringify(x)}`);
+}
+//# sourceMappingURL=types.js.map

package/dist/alternator/chassis/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/alternator/chassis/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAW,CAAC;AACrF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,IAAY,EAAY,EAAE,CACjF,GAAG,IAAI,IAAI,IAAI,IAAI,IAAI,EAAc,CAAC;AAmJxC;6CAC6C;AAC7C,MAAM,UAAU,WAAW,CAAC,CAAQ;IAClC,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC"}