@flyingrobots/graft 0.7.1 → 0.8.0

package/dist/parser/outline.js

@@ -1,153 +1,7 @@
 import { detectStructuredFormat } from "./lang.js";
-import { OutlineEntry, JumpEntry } from "./types.js";
-import { parseStructuredTree } from "./runtime.js";
+import { parseStructuredTree, parseStructuredTreeAsync, } from "./runtime.js";
 import { extractMarkdownOutline } from "./markdown.js";
-const MAX_SIGNATURE_LENGTH = 199;
-// ---------------------------------------------------------------------------
-// Signature helpers
-// ---------------------------------------------------------------------------
-/** Compact object-literal default values: `= { ... }` becomes `= {…}`. */
-function compactObjectDefaults(sig) {
-    return sig.replace(/=\s*\{[^}]*\}/g, "= {…}");
-}
-/** Truncate a signature to fit within MAX_SIGNATURE_LENGTH. */
-function boundSignature(raw) {
-    let sig = compactObjectDefaults(raw);
-    if (sig.length >= MAX_SIGNATURE_LENGTH) {
-        sig = sig.slice(0, MAX_SIGNATURE_LENGTH - 1) + "…";
-    }
-    return sig;
-}
-function nodeKind(nodeType) {
-    switch (nodeType) {
-        case "function_declaration":
-        case "generator_function_declaration":
-            return "function";
-        case "class_declaration":
-            return "class";
-        case "method_definition":
-            return "method";
-        case "interface_declaration":
-            return "interface";
-        case "type_alias_declaration":
-            return "type";
-        case "enum_declaration":
-            return "enum";
-        default:
-            return undefined;
-    }
-}
-// ---------------------------------------------------------------------------
-// Tree-sitter extraction helpers
-// ---------------------------------------------------------------------------
-function extractFunctionSignature(node) {
-    const nameNode = node.childForFieldName("name");
-    if (!nameNode)
-        return undefined;
-    const params = node.childForFieldName("parameters");
-    const returnType = node.childForFieldName("return_type");
-    let sig = nameNode.text;
-    if (params) {
-        sig += params.text;
-    }
-    if (returnType) {
-        // return_type node text includes the leading `: ` in some grammars
-        const rt = returnType.text.replace(/^:\s*/, "");
-        sig += ": " + rt;
-    }
-    return boundSignature(sig);
-}
-function extractName(node) {
-    const nameNode = node.childForFieldName("name");
-    return nameNode?.text;
-}
-function extractClassChildren(node) {
-    const body = node.childForFieldName("body");
-    if (!body)
-        return [];
-    const children = [];
-    for (const child of body.namedChildren) {
-        if (child.type === "method_definition") {
-            const name = extractName(child);
-            if (!name)
-                continue;
-            const sig = extractFunctionSignature(child);
-            children.push(new OutlineEntry({
-                kind: "method",
-                name,
-                exported: false,
-                ...(sig !== undefined ? { signature: sig } : {}),
-            }));
-        }
-    }
-    return children;
-}
-function processDeclaration(node, exported) {
-    const kind = nodeKind(node.type);
-    if (!kind)
-        return undefined;
-    const name = extractName(node);
-    if (!name)
-        return undefined;
-    const sig = kind === "function" ? extractFunctionSignature(node) : undefined;
-    const children = kind === "class" ? extractClassChildren(node) : undefined;
-    return new OutlineEntry({
-        kind,
-        name,
-        exported,
-        ...(sig !== undefined ? { signature: sig } : {}),
-        ...(children !== undefined && children.length > 0 ? { children } : {}),
-    });
-}
-function extractArrowSignature(name, arrowNode) {
-    const params = arrowNode.childForFieldName("parameters");
-    const returnType = arrowNode.childForFieldName("return_type");
-    let sig = name;
-    if (params) {
-        sig += params.text;
-    }
-    if (returnType) {
-        const rt = returnType.text.replace(/^:\s*/, "");
-        sig += ": " + rt;
-    }
-    return boundSignature(sig);
-}
-function processLexicalExport(node) {
-    const entries = [];
-    for (const child of node.namedChildren) {
-        if (child.type === "variable_declarator") {
-            const name = extractName(child);
-            if (!name)
-                continue;
-            // Check if the value is an arrow function or function expression
-            const value = child.childForFieldName("value");
-            if (value && (value.type === "arrow_function" || value.type === "function")) {
-                const sig = extractArrowSignature(name, value);
-                entries.push(new OutlineEntry({
-                    kind: "function",
-                    name,
-                    exported: true,
-                    ...(sig !== undefined ? { signature: sig } : {}),
-                }));
-            }
-            else {
-                entries.push(new OutlineEntry({ kind: "export", name, exported: true }));
-            }
-        }
-    }
-    return entries;
-}
-// ---------------------------------------------------------------------------
-// Jump table builder
-// ---------------------------------------------------------------------------
-function buildJumpEntry(name, kind, node) {
-    return new JumpEntry({
-        symbol: name,
-        kind,
-        start: node.startPosition.row + 1,
-        end: node.endPosition.row + 1,
-    });
-}
+import { getExtractor } from "./extractors/index.js";
 // ---------------------------------------------------------------------------
 // Main extraction
 // ---------------------------------------------------------------------------
@@ -163,84 +17,34 @@ export function extractOutline(source, lang = "ts") {
         return extractMarkdownOutline(source);
     }
     const parsed = parseStructuredTree(lang, source);
-    const root = parsed.root;
-    const entries = [];
-    const jumpTable = [];
-    const hasError = root.hasError();
-    for (const child of root.children) {
-        if (child.type === "export_statement") {
-            // export_statement wraps a declaration
-            const inner = child.namedChildren.find((c) => c.type === "function_declaration" ||
-                c.type === "generator_function_declaration" ||
-                c.type === "class_declaration" ||
-                c.type === "interface_declaration" ||
-                c.type === "type_alias_declaration" ||
-                c.type === "enum_declaration");
-            if (inner) {
-                const entry = processDeclaration(inner, true);
-                if (entry) {
-                    entries.push(entry);
-                    jumpTable.push(buildJumpEntry(entry.name, entry.kind, child));
-                }
-                continue;
-            }
-            // Check for lexical declaration (const/let exports)
-            const lexical = child.namedChildren.find((c) => c.type === "lexical_declaration");
-            if (lexical) {
-                const lexEntries = processLexicalExport(lexical);
-                for (const entry of lexEntries) {
-                    entries.push(entry);
-                    jumpTable.push(buildJumpEntry(entry.name, entry.kind, child));
-                }
-                continue;
-            }
-            // Re-exports: export { A, B } from './x'
-            const exportClause = child.namedChildren.find((c) => c.type === "export_clause");
-            if (exportClause) {
-                for (const spec of exportClause.namedChildren) {
-                    if (spec.type === "export_specifier") {
-                        const nameNode = spec.childForFieldName("alias") ?? spec.childForFieldName("name");
-                        if (nameNode) {
-                            entries.push(new OutlineEntry({ kind: "export", name: nameNode.text, exported: true }));
-                            jumpTable.push(buildJumpEntry(nameNode.text, "export", child));
-                        }
-                    }
-                }
-                continue;
-            }
-            // Wildcard re-export: export * from './x'
-            const moduleSpecifier = child.namedChildren.find((c) => c.type === "string");
-            const hasWildcard = child.children.some((c) => c.type === "*" || c.type === "namespace_export");
-            if (hasWildcard && moduleSpecifier) {
-                const name = `* from ${moduleSpecifier.text}`;
-                entries.push(new OutlineEntry({ kind: "export", name, exported: true }));
-                jumpTable.push(buildJumpEntry(name, "export", child));
-                continue;
-            }
-            // Other export forms — skip
-        }
-        else {
-            // Non-exported top-level declaration
-            const kind = nodeKind(child.type);
-            if (kind) {
-                const entry = processDeclaration(child, false);
-                if (entry) {
-                    entries.push(entry);
-                    jumpTable.push(buildJumpEntry(entry.name, entry.kind, child));
-                }
-            }
-        }
+    try {
+        return extractOutlineFromParsedTree(parsed);
     }
-    parsed.delete();
-    const result = {
-        entries,
-        jumpTable,
-    };
-    if (hasError) {
+    finally {
+        parsed.delete();
+    }
+}
+export function extractOutlineFromParsedTree(parsed) {
+    const lang = parsed.format;
+    const extractor = getExtractor(lang);
+    const result = extractor.extract(parsed.root);
+    if (parsed.root.hasError()) {
         result.partial = true;
     }
     return result;
 }
+export async function extractOutlineAsync(source, lang = "ts") {
+    if (lang === "md") {
+        return extractMarkdownOutline(source);
+    }
+    const parsed = await parseStructuredTreeAsync(lang, source);
+    try {
+        return extractOutlineFromParsedTree(parsed);
+    }
+    finally {
+        parsed.delete();
+    }
+}
 export function extractOutlineForFile(filePath, source) {
     const lang = detectStructuredFormat(filePath);
     if (lang === null) {
@@ -248,4 +52,11 @@ export function extractOutlineForFile(filePath, source) {
     }
     return extractOutline(source, lang);
 }
+export async function extractOutlineForFileAsync(filePath, source) {
+    const lang = detectStructuredFormat(filePath);
+    if (lang === null) {
+        return null;
+    }
+    return extractOutlineAsync(source, lang);
+}
 //# sourceMappingURL=outline.js.map

package/dist/parser/outline.js.map

@@ -1 +1 @@
-{"version":3,"file":"outline.js","sourceRoot":"","sources":["../../src/parser/outline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,0EAA0E;AAC1E,SAAS,qBAAqB,CAAC,GAAW;IACxC,OAAO,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,+DAA+D;AAC/D,SAAS,cAAc,CAAC,GAAW;IACjC,IAAI,GAAG,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,GAAG,CAAC,MAAM,IAAI,oBAAoB,EAAE,CAAC;QACvC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IACrD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAcD,SAAS,QAAQ,CAAC,QAAgB;IAChC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,sBAAsB,CAAC;QAC5B,KAAK,gCAAgC;YACnC,OAAO,UAAU,CAAC;QACpB,KAAK,mBAAmB;YACtB,OAAO,OAAO,CAAC;QACjB,KAAK,mBAAmB;YACtB,OAAO,QAAQ,CAAC;QAClB,KAAK,uBAAuB;YAC1B,OAAO,WAAW,CAAC;QACrB,KAAK,wBAAwB;YAC3B,OAAO,MAAM,CAAC;QAChB,KAAK,kBAAkB;YACrB,OAAO,MAAM,CAAC;QAChB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,iCAAiC;AACjC,8EAA8E;AAE9E,SAAS,wBAAwB,CAAC,IAAY;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAEzD,IAAI,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC;IACxB,IAAI,MAAM,EAAE,CAAC;QACX,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,mEAAmE;QACnE,MAAM,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChD,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,QAAQ,EAAE,IAAI,CAAC;AACxB,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;YACvC,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,MAAM,GAAG,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;YAC5C,QAAQ,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC;gBAC7B,IAAI,EAAE,QAAQ;gBACd,IAAI;gBACJ,QAAQ,EAAE,KAAK;gBACf,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjD,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,kBAAkB,CACzB,IAAY,EACZ,QAAiB;IAEjB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAE5B,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAE5B,MAAM,GAAG,GAAG,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,MAAM,QAAQ,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE3E,OAAO,IAAI,YAAY,CAAC;QACtB,IAAI;QACJ,IAAI;QACJ,QAAQ;QACR,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY,EAAE,SAAiB;IAC5D,MAAM,MAAM,GAAG,SAAS,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,SAAS,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAE9D,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,IAAI,MAAM,EAAE,CAAC;QACX,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAChD,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAY;IACxC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,iEAAiE;YACjE,MAAM,KAAK,GAAG,KAAK,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,gBAAgB,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,EAAE,CAAC;gBAC5E,MAAM,GAAG,GAAG,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAC/C,OAAO,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC;oBAC5B,IAAI,EAAE,UAAU;oBAChB,IAAI;oBACJ,QAAQ,EAAE,IAAI;oBACd,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACjD,CAAC,CAAC,CAAC;YACN,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,SAAS,cAAc,CACrB,IAAY,EACZ,IAAY,EACZ,IAAY;IAEZ,OAAO,IAAI,SAAS,CAAC;QACnB,MAAM,EAAE,IAAI;QACZ,IAAI;QACJ,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,GAAG,CAAC;QACjC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,OAAkC,IAAI;IAEtC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IACD,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAEzB,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,SAAS,GAAgB,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAEjC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClC,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;YACtC,uCAAuC;YACvC,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,CACpC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,sBAAsB;gBACjC,CAAC,CAAC,IAAI,KAAK,gCAAgC;gBAC3C,CAAC,CAAC,IAAI,KAAK,mBAAmB;gBAC9B,CAAC,CAAC,IAAI,KAAK,uBAAuB;gBAClC,CAAC,CAAC,IAAI,KAAK,wBAAwB;gBACnC,CAAC,CAAC,IAAI,KAAK,kBAAkB,CAChC,CAAC;YAEF,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBAC9C,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACpB,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;gBAChE,CAAC;gBACD,SAAS;YACX,CAAC;YAED,oDAAoD;YACpD,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,qBAAqB,CACxC,CAAC;YACF,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;gBACjD,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;oBAC/B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACpB,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;gBAChE,CAAC;gBACD,SAAS;YACX,CAAC;YAED,yCAAyC;YACzC,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,CAC3C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CAClC,CAAC;YACF,IAAI,YAAY,EAAE,CAAC;gBACjB,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,aAAa,EAAE,CAAC;oBAC9C,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;wBACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;wBACnF,IAAI,QAAQ,EAAE,CAAC;4BACb,OAAO,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;4BACxF,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;wBACjE,CAAC;oBACH,CAAC;gBACH,CAAC;gBACD,SAAS;YACX,CAAC;YAED,0CAA0C;YAC1C,MAAM,eAAe,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YAC7E,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAAC;YAChG,IAAI,WAAW,IAAI,eAAe,EAAE,CAAC;gBACnC,MAAM,IAAI,GAAG,UAAU,eAAe,CAAC,IAAI,EAAE,CAAC;gBAC9C,OAAO,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACzE,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;gBACtD,SAAS;YACX,CAAC;YAED,4BAA4B;QAC9B,CAAC;aAAM,CAAC;YACN,qCAAqC;YACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAC/C,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACpB,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,CAAC,MAAM,EAAE,CAAC;IAEhB,MAAM,MAAM,GAAkB;QAC5B,OAAO;QACP,SAAS;KACV,CAAC;IAEF,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,MAAc;IAEd,MAAM,IAAI,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"outline.js","sourceRoot":"","sources":["../../src/parser/outline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAGnD,OAAO,EAEL,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,OAAkC,IAAI;IAEtC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjD,IAAI,CAAC;QACH,OAAO,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,MAAM,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAkB;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3B,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,MAAM,GAAkB,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC3B,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc,EACd,OAAkC,IAAI;IAEtC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,OAAO,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,MAAM,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,MAAc;IAEd,MAAM,IAAI,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,QAAgB,EAChB,MAAc;IAEd,MAAM,IAAI,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/parser/runtime.d.ts

@@ -1,5 +1,8 @@
 import Parser from "web-tree-sitter";
 import type { SupportedLang } from "./lang.js";
+export declare class ParserRuntimeNotReadyError extends Error {
+    constructor();
+}
 export interface ParsedTree {
     readonly format: SupportedLang;
     readonly parser: Parser;
@@ -8,6 +11,10 @@ export interface ParsedTree {
     readonly source: string;
     delete(): void;
 }
+export declare function ensureParserReady(): Promise<void>;
+export declare function isParserReady(): boolean;
 export declare function parseStructuredTree(format: SupportedLang, source: string): ParsedTree;
+export declare function parseStructuredTreeAsync(format: SupportedLang, source: string): Promise<ParsedTree>;
 export declare function parseStructuredTreeForFile(filePath: string, source: string): ParsedTree | null;
+export declare function parseStructuredTreeForFileAsync(filePath: string, source: string): Promise<ParsedTree | null>;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/parser/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/parser/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,iBAAiB,CAAC;AAGrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AA2B/C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,MAAM,IAAI,IAAI,CAAC;CAChB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,UAAU,CAiBZ;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,UAAU,GAAG,IAAI,CAMnB"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/parser/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,iBAAiB,CAAC;AAGrC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAoB/C,qBAAa,0BAA2B,SAAQ,KAAK;;CAOpD;AAoHD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,MAAM,IAAI,IAAI,CAAC;CAChB;AAyBD,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvD;AAED,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,UAAU,CAEZ;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,CAAC,CAErB;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,UAAU,GAAG,IAAI,CAMnB;AAED,wBAAsB,+BAA+B,CACnD,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAM5B"}

package/dist/parser/runtime.js

@@ -2,23 +2,93 @@ import Parser from "web-tree-sitter";
 import { createRequire } from "node:module";
 import { detectLang } from "./lang.js";
 const esmRequire = createRequire(import.meta.url);
-await Parser.init();
-const tsLang = await Parser.Language.load(esmRequire.resolve("tree-sitter-wasms/out/tree-sitter-typescript.wasm"));
-const tsxLang = await Parser.Language.load(esmRequire.resolve("tree-sitter-wasms/out/tree-sitter-tsx.wasm"));
-const jsLang = await Parser.Language.load(esmRequire.resolve("tree-sitter-wasms/out/tree-sitter-javascript.wasm"));
-function languageFor(format) {
+let parserRuntime = null;
+let parserRuntimePromise = null;
+export class ParserRuntimeNotReadyError extends Error {
+    constructor() {
+        super("Parser runtime is not ready; await ensureParserReady() before synchronous structured parsing.");
+        this.name = "ParserRuntimeNotReadyError";
+    }
+}
+async function loadParserRuntime() {
+    if (parserRuntime !== null) {
+        return parserRuntime;
+    }
+    if (parserRuntimePromise !== null) {
+        return parserRuntimePromise;
+    }
+    parserRuntimePromise = (async () => {
+        await Parser.init();
+        const [tsLang, tsxLang, jsLang, rustLang, graphqlLang, pythonLang, goLang, jsonLang, tomlLang, yamlLang,] = await Promise.all([
+            Parser.Language.load(esmRequire.resolve("tree-sitter-wasms/out/tree-sitter-typescript.wasm")),
+            Parser.Language.load(esmRequire.resolve("tree-sitter-wasms/out/tree-sitter-tsx.wasm")),
+            Parser.Language.load(esmRequire.resolve("tree-sitter-wasms/out/tree-sitter-javascript.wasm")),
+            Parser.Language.load(esmRequire.resolve("tree-sitter-wasms/out/tree-sitter-rust.wasm")),
+            Parser.Language.load(esmRequire.resolve("tree-sitter-graphql-grammar-wasm/grammar.wasm")),
+            Parser.Language.load(esmRequire.resolve("tree-sitter-wasms/out/tree-sitter-python.wasm")),
+            Parser.Language.load(esmRequire.resolve("tree-sitter-wasms/out/tree-sitter-go.wasm")),
+            Parser.Language.load(esmRequire.resolve("tree-sitter-wasms/out/tree-sitter-json.wasm")),
+            Parser.Language.load(esmRequire.resolve("tree-sitter-wasms/out/tree-sitter-toml.wasm")),
+            Parser.Language.load(esmRequire.resolve("tree-sitter-wasms/out/tree-sitter-yaml.wasm")),
+        ]);
+        return {
+            tsLang,
+            tsxLang,
+            jsLang,
+            rustLang,
+            graphqlLang,
+            pythonLang,
+            goLang,
+            jsonLang,
+            tomlLang,
+            yamlLang,
+        };
+    })();
+    try {
+        parserRuntime = await parserRuntimePromise;
+        return parserRuntime;
+    }
+    catch (error) {
+        parserRuntimePromise = null;
+        throw error;
+    }
+}
+function requireParserRuntime() {
+    if (parserRuntime === null) {
+        void loadParserRuntime().catch(() => {
+            // Best-effort warmup: awaited parser entry points surface init errors.
+        });
+        throw new ParserRuntimeNotReadyError();
+    }
+    return parserRuntime;
+}
+function languageFor(runtime, format) {
     switch (format) {
         case "ts":
-            return tsLang;
+            return runtime.tsLang;
         case "tsx":
-            return tsxLang;
+            return runtime.tsxLang;
         case "js":
-            return jsLang;
+            return runtime.jsLang;
+        case "rust":
+            return runtime.rustLang;
+        case "graphql":
+            return runtime.graphqlLang;
+        case "python":
+            return runtime.pythonLang;
+        case "go":
+            return runtime.goLang;
+        case "json":
+            return runtime.jsonLang;
+        case "toml":
+            return runtime.tomlLang;
+        case "yaml":
+            return runtime.yamlLang;
     }
 }
-export function parseStructuredTree(format, source) {
+function parseStructuredTreeWithRuntime(runtime, format, source) {
     const parser = new Parser();
-    parser.setLanguage(languageFor(format));
+    parser.setLanguage(languageFor(runtime, format));
     const tree = parser.parse(source);
     const root = tree.rootNode;
     return {
@@ -33,6 +103,18 @@ export function parseStructuredTree(format, source) {
         },
     };
 }
+export async function ensureParserReady() {
+    await loadParserRuntime();
+}
+export function isParserReady() {
+    return parserRuntime !== null;
+}
+export function parseStructuredTree(format, source) {
+    return parseStructuredTreeWithRuntime(requireParserRuntime(), format, source);
+}
+export async function parseStructuredTreeAsync(format, source) {
+    return parseStructuredTreeWithRuntime(await loadParserRuntime(), format, source);
+}
 export function parseStructuredTreeForFile(filePath, source) {
     const format = detectLang(filePath);
     if (format === null) {
@@ -40,4 +122,11 @@ export function parseStructuredTreeForFile(filePath, source) {
     }
     return parseStructuredTree(format, source);
 }
+export async function parseStructuredTreeForFileAsync(filePath, source) {
+    const format = detectLang(filePath);
+    if (format === null) {
+        return null;
+    }
+    return parseStructuredTreeAsync(format, source);
+}
 //# sourceMappingURL=runtime.js.map

package/dist/parser/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/parser/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,iBAAiB,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAElD,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;AAEpB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CACvC,UAAU,CAAC,OAAO,CAAC,mDAAmD,CAAC,CACxE,CAAC;AACF,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CACxC,UAAU,CAAC,OAAO,CAAC,4CAA4C,CAAC,CACjE,CAAC;AACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CACvC,UAAU,CAAC,OAAO,CAAC,mDAAmD,CAAC,CACxE,CAAC;AAEF,SAAS,WAAW,CAAC,MAAqB;IACxC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,IAAI;YACP,OAAO,MAAM,CAAC;QAChB,KAAK,KAAK;YACR,OAAO,OAAO,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAWD,MAAM,UAAU,mBAAmB,CACjC,MAAqB,EACrB,MAAc;IAEd,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;IAE3B,OAAO;QACL,MAAM;QACN,MAAM;QACN,IAAI;QACJ,IAAI;QACJ,MAAM;QACN,MAAM;YACJ,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAAgB,EAChB,MAAc;IAEd,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/parser/runtime.ts"],"names":[],"mappings":"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"}

package/dist/parser/types.d.ts

@@ -1,5 +1,5 @@
 /** The kind of a top-level or member declaration. */
-export type EntryKind = "function" | "class" | "method" | "interface" | "type" | "enum" | "export" | "heading";
+export type EntryKind = "function" | "class" | "method" | "interface" | "type" | "enum" | "export" | "object" | "field" | "input" | "input_field" | "scalar" | "union" | "directive" | "operation" | "fragment" | "schema" | "enum_value" | "constant" | "variable" | "package" | "section" | "heading";
 /** A single entry in a file outline. */
 export declare class OutlineEntry {
     /** @internal Brand prevents structural forgery from plain objects. */

package/dist/parser/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/parser/types.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,OAAO,GACP,QAAQ,GACR,WAAW,GACX,MAAM,GACN,MAAM,GACN,QAAQ,GACR,SAAS,CAAC;AAEd,wCAAwC;AACxC,qBAAa,YAAY;IACvB,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;gBAEhC,IAAI,EAAE;QAChB,IAAI,EAAE,SAAS,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;KACpC;CAWF;AAED,qEAAqE;AACrE,qBAAa,SAAS;IACpB,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,IAAI,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb;CAaF;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/parser/types.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,OAAO,GACP,QAAQ,GACR,WAAW,GACX,MAAM,GACN,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,OAAO,GACP,aAAa,GACb,QAAQ,GACR,OAAO,GACP,WAAW,GACX,WAAW,GACX,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,UAAU,GACV,SAAS,GACT,SAAS,GACT,SAAS,CAAC;AAEd,wCAAwC;AACxC,qBAAa,YAAY;IACvB,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;gBAEhC,IAAI,EAAE;QAChB,IAAI,EAAE,SAAS,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;KACpC;CAWF;AAED,qEAAqE;AACrE,qBAAa,SAAS;IACpB,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,IAAI,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb;CAaF;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/parser/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/parser/types.ts"],"names":[],"mappings":"AAWA,wCAAwC;AACxC,MAAM,OAAO,YAAY;IACvB,sEAAsE;IACrD,MAAM,GAAG,cAAuB,CAAC;IACzC,IAAI,CAAY;IAChB,IAAI,CAAS;IACb,SAAS,CAAU;IACnB,QAAQ,CAAU;IAClB,QAAQ,CAA2B;IAE5C,YAAY,IAMX;QACC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAClE,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,OAAO,SAAS;IACpB,sEAAsE;IACrD,MAAM,GAAG,WAAoB,CAAC;IACtC,MAAM,CAAS;IACf,IAAI,CAAS;IACb,KAAK,CAAS,CAAC,eAAe;IAC9B,GAAG,CAAS,CAAC,eAAe;IAErC,YAAY,IAKX;QACC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;CACF"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/parser/types.ts"],"names":[],"mappings":"AA0BA,wCAAwC;AACxC,MAAM,OAAO,YAAY;IACvB,sEAAsE;IACrD,MAAM,GAAG,cAAuB,CAAC;IACzC,IAAI,CAAY;IAChB,IAAI,CAAS;IACb,SAAS,CAAU;IACnB,QAAQ,CAAU;IAClB,QAAQ,CAA2B;IAE5C,YAAY,IAMX;QACC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAClE,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;CACF;AAED,qEAAqE;AACrE,MAAM,OAAO,SAAS;IACpB,sEAAsE;IACrD,MAAM,GAAG,WAAoB,CAAC;IACtC,MAAM,CAAS;IACf,IAAI,CAAS;IACb,KAAK,CAAS,CAAC,eAAe;IAC9B,GAAG,CAAS,CAAC,eAAe;IAErC,YAAY,IAKX;QACC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACpB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;CACF"}

package/dist/ports/provenance-timeline.d.ts

@@ -0,0 +1,10 @@
+export interface ProvenanceTimelinePatch {
+    readonly lamport: number;
+    readonly ops: readonly unknown[];
+}
+export interface ProvenanceTimelinePort {
+    readonly patchesFor: (entityId: string) => Promise<readonly string[]>;
+    readonly loadPatchBySha: (sha: string) => Promise<ProvenanceTimelinePatch>;
+}
+export declare function assertProvenanceTimelinePort(impl: unknown): asserts impl is ProvenanceTimelinePort;
+//# sourceMappingURL=provenance-timeline.d.ts.map

package/dist/ports/provenance-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance-timeline.d.ts","sourceRoot":"","sources":["../../src/ports/provenance-timeline.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,SAAS,OAAO,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IACtE,QAAQ,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC5E;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,IAAI,IAAI,sBAAsB,CAmBxC"}

package/dist/ports/provenance-timeline.js

@@ -0,0 +1,17 @@
+// ---------------------------------------------------------------------------
+// ProvenanceTimeline port - narrow boundary for patch-history reads
+// ---------------------------------------------------------------------------
+export function assertProvenanceTimelinePort(impl) {
+    if (impl === null || typeof impl !== "object") {
+        throw new TypeError(`ProvenanceTimeline adapter must be an object (got ${impl === null ? "null" : typeof impl})`);
+    }
+    const candidate = impl;
+    if (typeof candidate.patchesFor !== "function") {
+        throw new TypeError(`ProvenanceTimeline adapter missing method: patchesFor (got ${typeof candidate.patchesFor})`);
+    }
+    if (typeof candidate.loadPatchBySha !== "function") {
+        throw new TypeError(`ProvenanceTimeline adapter missing method: loadPatchBySha ` +
+            `(got ${typeof candidate.loadPatchBySha})`);
+    }
+}
+//# sourceMappingURL=provenance-timeline.js.map

package/dist/ports/provenance-timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provenance-timeline.js","sourceRoot":"","sources":["../../src/ports/provenance-timeline.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,oEAAoE;AACpE,8EAA8E;AAY9E,MAAM,UAAU,4BAA4B,CAC1C,IAAa;IAEb,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,IAAI,SAAS,CACjB,qDAAqD,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,GAAG,CAC7F,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAA8D,CAAC;IACjF,IAAI,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC/C,MAAM,IAAI,SAAS,CACjB,8DAA8D,OAAO,SAAS,CAAC,UAAU,GAAG,CAC7F,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,SAAS,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QACnD,MAAM,IAAI,SAAS,CACjB,4DAA4D;YAC1D,QAAQ,OAAO,SAAS,CAAC,cAAc,GAAG,CAC7C,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/ports/semantic-enrichment.d.ts

@@ -0,0 +1,47 @@
+export declare const DEFAULT_SEMANTIC_FACT_LIMIT = 64;
+export type SemanticEnrichmentStatus = "not_configured" | "skipped_not_explicit" | "available" | "unavailable";
+export type SemanticEnrichmentLanguage = "ts" | "tsx" | "js" | "rust" | "graphql" | "python" | "go" | "json" | "toml" | "yaml";
+export interface SemanticEnrichmentRequest {
+    readonly repoRoot: string;
+    readonly filePath: string;
+    readonly language: SemanticEnrichmentLanguage;
+    readonly content: string;
+    readonly headSha: string;
+    readonly maxFacts: number;
+}
+export interface SemanticCallFact {
+    readonly kind: "call";
+    readonly fromSymbolId: string;
+    readonly toSymbolId: string;
+}
+export interface SemanticTypeofFact {
+    readonly kind: "typeof";
+    readonly symbolId: string;
+    readonly typeName: string;
+}
+export type SemanticEnrichmentFact = SemanticCallFact | SemanticTypeofFact;
+export interface SemanticEnrichmentAvailableResult {
+    readonly status: "available";
+    readonly facts: readonly SemanticEnrichmentFact[];
+    readonly factsRejected?: number | undefined;
+}
+export interface SemanticEnrichmentUnavailableResult {
+    readonly status: "unavailable";
+    readonly reason: string;
+}
+export type SemanticEnrichmentProviderResult = SemanticEnrichmentAvailableResult | SemanticEnrichmentUnavailableResult;
+export interface SemanticEnrichmentProvider {
+    enrichFile(request: SemanticEnrichmentRequest): SemanticEnrichmentProviderResult | Promise<SemanticEnrichmentProviderResult>;
+}
+export interface SemanticEnrichmentUnavailableFile {
+    readonly filePath: string;
+    readonly reason: string;
+}
+export interface SemanticEnrichmentSummary {
+    readonly status: SemanticEnrichmentStatus;
+    readonly filesAttempted: number;
+    readonly factsAccepted: number;
+    readonly factsRejected: number;
+    readonly unavailable: readonly SemanticEnrichmentUnavailableFile[];
+}
+//# sourceMappingURL=semantic-enrichment.d.ts.map

package/dist/ports/semantic-enrichment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-enrichment.d.ts","sourceRoot":"","sources":["../../src/ports/semantic-enrichment.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,MAAM,MAAM,wBAAwB,GAChC,gBAAgB,GAChB,sBAAsB,GACtB,WAAW,GACX,aAAa,CAAC;AAElB,MAAM,MAAM,0BAA0B,GAClC,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,MAAM,GACN,SAAS,GACT,QAAQ,GACR,IAAI,GACJ,MAAM,GACN,MAAM,GACN,MAAM,CAAC;AAEX,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;AAE3E,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAClD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,gCAAgC,GACxC,iCAAiC,GACjC,mCAAmC,CAAC;AAExC,MAAM,WAAW,0BAA0B;IACzC,UAAU,CACR,OAAO,EAAE,yBAAyB,GACjC,gCAAgC,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAAC;CACjF;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,SAAS,iCAAiC,EAAE,CAAC;CACpE"}

package/dist/ports/semantic-enrichment.js

@@ -0,0 +1,2 @@
+export const DEFAULT_SEMANTIC_FACT_LIMIT = 64;
+//# sourceMappingURL=semantic-enrichment.js.map

package/dist/ports/semantic-enrichment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-enrichment.js","sourceRoot":"","sources":["../../src/ports/semantic-enrichment.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC"}

package/dist/warp/ast-import-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ast-import-resolver.d.ts","sourceRoot":"","sources":["../../src/warp/ast-import-resolver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,KAAK,MAAM,GAAG,OAAO,iBAAiB,EAAE,UAAU,CAAC;AA0LnD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,IAAI,CAWN"}
+{"version":3,"file":"ast-import-resolver.d.ts","sourceRoot":"","sources":["../../src/warp/ast-import-resolver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD,KAAK,MAAM,GAAG,OAAO,iBAAiB,EAAE,UAAU,CAAC;AA0LnD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,IAAI,CAWN"}

package/dist/warp/ast-import-resolver.js

@@ -2,6 +2,7 @@
 // AST Import Resolver — adds cross-file reference edges to the WARP graph
 // ---------------------------------------------------------------------------
 import { createHash } from "node:crypto";
+import { SymIdCodec } from "./sym-id-codec.js";
 function hashId(input) {
     return createHash("sha1").update(input).digest("hex").slice(0, 12);
 }
@@ -57,7 +58,7 @@ function compiledSpecifierSourceCandidates(resolvedImportSource) {
     return [];
 }
 function symNodeId(filePath, symbolName) {
-    return `sym:${filePath}:${symbolName}`;
+    return SymIdCodec.encode(filePath, symbolName);
 }
 function emitAstAnchor(patch, filePath, node) {
     const nodeId = astNodeId(filePath, node);