@vizalice/codegraph 1.5.0

package/dist/extraction/kernel/index.js

@@ -0,0 +1,279 @@
+"use strict";
+/**
+ * Kernel routing — which languages go through the native kernel, and the
+ * single entry point the extraction path calls.
+ *
+ * Routing policy is deliberately TS-side and per-language (migration plan §2):
+ * a language routes to the kernel only after its equivalence gate passes;
+ * everything else stays on the wasm path forever if need be. Rollback per
+ * language = removing it from DEFAULT_ROUTED (or CODEGRAPH_KERNEL=0 for all).
+ *
+ * Routing status: TypeScript/TSX/JavaScript/JSX are default-routed (R3 gate
+ * passed 2026-07-16 — full-index dumps byte-identical on express/excalidraw/
+ * vscode, control repo unchanged; see the migration plan §4a). Override with
+ *   CODEGRAPH_KERNEL_LANGS=<langs|all>  (replaces the default set), or
+ *   CODEGRAPH_KERNEL=0                  (kill switch, everything → wasm).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeExtractBuffers = exports.resetKernelForTests = exports.kernelSupports = exports.getKernel = void 0;
+exports.kernelRoutes = kernelRoutes;
+exports.takeDeferredPreParse = takeDeferredPreParse;
+exports.tryKernelExtractRaw = tryKernelExtractRaw;
+exports.materializeKernelResult = materializeKernelResult;
+exports.tryKernelExtract = tryKernelExtract;
+const languages_1 = require("../languages");
+const loader_1 = require("./loader");
+const decode_1 = require("./decode");
+const layout_1 = require("./layout");
+var loader_2 = require("./loader");
+Object.defineProperty(exports, "getKernel", { enumerable: true, get: function () { return loader_2.getKernel; } });
+Object.defineProperty(exports, "kernelSupports", { enumerable: true, get: function () { return loader_2.kernelSupports; } });
+Object.defineProperty(exports, "resetKernelForTests", { enumerable: true, get: function () { return loader_2.resetKernelForTests; } });
+var decode_2 = require("./decode");
+Object.defineProperty(exports, "decodeExtractBuffers", { enumerable: true, get: function () { return decode_2.decodeExtractBuffers; } });
+/**
+ * Languages routed to the kernel by default (gate-passed only — see the
+ * per-language tracker in docs/design/rust-kernel-migration-plan.md §4).
+ * Per-file safety valve regardless of routing: a file whose parse tree
+ * contains ERRORS defers to the wasm extractor (error recovery differs
+ * between UTF-8 and UTF-16 parsing — wasm's recovery is canonical).
+ */
+const DEFAULT_ROUTED = new Set([
+    'typescript',
+    'tsx',
+    'javascript',
+    'jsx',
+    'java',
+    'python',
+    'go',
+    // R7a (2026-07-17): parity swept 0-diff on redis/git/fmt/protobuf/ALS
+    // (2,389 files compared) + full-init dump-diffs byte-identical; erroring
+    // files defer per-file to wasm (routine for macro-heavy C/C++ — see
+    // scripts/kernel-parity.mjs --max-deferral).
+    'c',
+    'cpp',
+    // R7b (2026-07-20): parity swept 0-diff on ripgrep/tokio/rust-analyzer
+    // (2,108 files byte-parity) + full-init dump-diffs byte-identical. Rust
+    // deferral is ~0% on normal repos; token-macro-table sources (rust-analyzer's
+    // parser crates, 18%) error on BOTH arms — grammar-inherent, not a walker
+    // signal.
+    'rust',
+    // R7b (2026-07-20): parity swept 0-diff on serilog/Newtonsoft.Json/jellyfin
+    // (3,229 files byte-parity) + full-init dump-diffs byte-identical ×3.
+    // Deferral 0.05–3.3% — both-branches-kept `#if` damage that errors on BOTH
+    // arms (the preParse blanking hoist keeps the kernel's input identical).
+    'csharp',
+    // R7b (2026-07-20): parity swept 0-diff on sinatra/jekyll/rails (3,763
+    // files byte-parity, 0 deferrals — ruby error incidence is 0.00%) +
+    // full-init dump-diffs byte-identical ×3. Any deferral on a ruby sweep is
+    // a walker-bug signal, not grammar reality.
+    'ruby',
+    // R7b (2026-07-20): parity swept 0-diff on monolog/laravel-framework/
+    // symfony (13,950 files byte-parity) + full-init dump-diffs byte-identical
+    // ×3. Deferral ≈0–0.1% (genuinely-broken fixtures) — default sweep guard.
+    'php',
+    // R7b (2026-07-20): parity swept 0-diff on Alamofire/vapor/swift-nio (720
+    // clean files byte-parity; Alamofire's 348 #1020 property nodes reproduced
+    // exactly) + full-init dump-diffs byte-identical ×3. Swift error incidence
+    // is structurally 9–27% on BOTH arms (heavy #if conditionalization) —
+    // sweeps run --max-deferral 0.3; a deferral-rate JUMP is the bug signal.
+    'swift',
+    // R7b (2026-07-20): parity swept 0-diff on okio/okhttp/kotlinx.coroutines
+    // (1,861 clean files byte-parity; KMP expect/actual synthesis identical —
+    // 412 edges both arms on kotlinx.coroutines) + full-init dump-diffs
+    // byte-identical ×3. Deferral 4.7–8.5% both-arm grammar reality
+    // (fun-interface misparses + PHANTOM hasError files) — default sweep guard
+    // holds; a JUMP past ~10% is the bug signal.
+    'kotlin',
+    // R7b batch 4 (2026-07-20): parity swept 0-diff on dplyr/ggplot2/shiny +
+    // AnomalyDetection + full-init dump-diffs byte-identical ×3. R error
+    // incidence is ~0% (deferrals 0/0/0/1 across the gate repos — the 1 is a
+    // moustache-template pseudo-R file, both-arm): any deferral on an R sweep
+    // is a walker-bug signal, not grammar reality.
+    'r',
+    // R7b batch 4 (2026-07-20): one walker, two dialects. Parity swept 0-diff
+    // on kong/lazy.nvim/lua-resty-core (lua) + lune/Fusion (luau) + full-init
+    // dump-diffs byte-identical. Lua error incidence ~0% (any deferral is a
+    // walker-bug signal); luau 1.4–7.1% both-arm grammar reality (generic type
+    // packs, default type params) — a JUMP past ~10% is the bug signal.
+    'lua',
+    'luau',
+    // R7b batch 4 (2026-07-20): parity swept 0-diff on os-lib/cats + scala3
+    // compiler/src + library/src + full-init dump-diffs byte-identical.
+    // Error incidence is bimodal: mainstream Scala-2-style repos ~0-2%
+    // (os-lib 0%, cats 1.8%) but scala-3-frontier code runs 10-18% with
+    // PHANTOM-dominated error sets (hasError=true, zero ERROR nodes —
+    // capture-checking `^` types; defer on the FLAG). Sweeps over
+    // scala3-style repos use --max-deferral 0.3 (swift precedent); a
+    // deferral JUMP on cats/os-lib-style code is the bug signal.
+    'scala',
+    // R7b batch 4 (2026-07-20): parity swept 0-diff on shelf/bloc/flutter +
+    // full-init dump-diffs byte-identical. Error incidence 3.4-20.7% both-arm
+    // grammar reality (empty object patterns — the sealed-class idiom — and
+    // unnamed `library;` dominate; flutter sits at ~21%) — sweeps use
+    // --max-deferral 0.3; the RATE, not the count, is the signal (flutter
+    // HEAD drifts).
+    'dart',
+]);
+const POST_PASSES = {
+// (none yet — R2+)
+};
+/**
+ * The preParse hoist (checklist §arch-1): languages with an offset-preserving
+ * `preParse` hook (c/cpp macro blanking, csharp #237, metal #1121, cuda #1172)
+ * apply it HERE, before the kernel call, so both arms parse identical blanked
+ * bytes and none of the blanking logic needs a Rust port. The wasm fallback
+ * path is untouched — TreeSitterExtractor applies the same hook itself on the
+ * RAW source it receives, so a kernel error/defer still extracts identically.
+ * Every blank is an equal-length-space replacement, so offsets, lines, and
+ * columns survive; `filePath` rides along for the extension-gated dialect
+ * blanks (`.metal` attributes; `.cu`/`.cuh` + content-gated CUDA).
+ */
+function preParsedSource(filePath, source, language) {
+    const pre = languages_1.EXTRACTORS[language]?.preParse;
+    return pre ? pre(source, filePath) : source;
+}
+function isRouted(language) {
+    const env = process.env.CODEGRAPH_KERNEL_LANGS;
+    if (env === undefined || env === '')
+        return DEFAULT_ROUTED.has(language);
+    if (env === 'all')
+        return true;
+    return env
+        .split(',')
+        .map((s) => s.trim())
+        .includes(language);
+}
+/** True when `language` would be extracted by the kernel right now. */
+function kernelRoutes(language) {
+    return isRouted(language) && (0, loader_1.kernelSupports)(language);
+}
+/** Warned-once registry so a broken language logs a single line, not one per file. */
+const warned = new Set();
+/**
+ * One-slot defer memo. A file the kernel defers (parse errors → wasm) used to
+ * pay the full pipeline again at every seam: the worker's raw try blanked +
+ * native-parsed it, extractFromSource's kernel try blanked + native-parsed it
+ * AGAIN, and the wasm extractor then re-applied preParse a third time. On a
+ * high-deferral tree (the Linux kernel defers ~79% of files) that waste
+ * dominated the arm's parse phase. The slot remembers the LAST deferred
+ * (file, source, language) so (a) a repeat kernel attempt for the same file
+ * short-circuits to null, and (b) the wasm fallback can reuse the
+ * already-blanked source instead of re-running preParse. Source is matched by
+ * string identity — the worker passes the same string through every seam.
+ */
+let deferSlot = null;
+/** The hoisted preParse output for a just-deferred file, if it matches. */
+function takeDeferredPreParse(filePath, source, language) {
+    if (deferSlot &&
+        deferSlot.filePath === filePath &&
+        deferSlot.source === source &&
+        deferSlot.language === language) {
+        return deferSlot.pre;
+    }
+    return null;
+}
+/**
+ * Extract via the kernel WITHOUT decoding — the bulk-index fast path. The
+ * tables ride to the store boundary as buffers (decoded on the store worker),
+ * so the main thread never materializes per-node objects. Returns null under
+ * exactly the conditions tryKernelExtract does, PLUS when the language has a
+ * registered post() pass (post passes operate on decoded results, so those
+ * languages keep the decoded path).
+ */
+function tryKernelExtractRaw(filePath, source, language) {
+    if (!kernelRoutes(language) || POST_PASSES[language])
+        return null;
+    const kernel = (0, loader_1.getKernel)();
+    if (!kernel)
+        return null;
+    if (takeDeferredPreParse(filePath, source, language) !== null)
+        return null; // already deferred
+    const pre = preParsedSource(filePath, source, language);
+    try {
+        const buffers = kernel.extractFile(filePath, pre, language);
+        const meta = buffers.meta;
+        if (meta.readUInt8(layout_1.META.version) !== layout_1.KERNEL_ABI_VERSION) {
+            throw new Error(`kernel buffer ABI ${meta.readUInt8(0)} != expected ${layout_1.KERNEL_ABI_VERSION}`);
+        }
+        const counts = {
+            nodes: meta.readUInt32LE(layout_1.META.nodeCount),
+            edges: meta.readUInt32LE(layout_1.META.edgeCount),
+            refs: meta.readUInt32LE(layout_1.META.refCount),
+        };
+        let errors = [];
+        const errorsOff = meta.readUInt32LE(layout_1.META.errorsOff);
+        if (errorsOff !== layout_1.NONE) {
+            const errorsLen = meta.readUInt32LE(layout_1.META.errorsLen);
+            errors = JSON.parse(buffers.arena.toString('utf8', errorsOff, errorsOff + errorsLen));
+        }
+        return { buffers, counts, errors };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (message.includes('defer:')) {
+            deferSlot = { filePath, source, language, pre };
+            return null;
+        }
+        if (!warned.has(language)) {
+            warned.add(language);
+            process.stderr.write(`[codegraph-kernel] ${language} extraction failed (${message}) — falling back to the wasm path\n`);
+        }
+        return null;
+    }
+}
+/**
+ * Decode a buffer-carrying result (see ExtractionResult.kernelBuffers) into a
+ * plain, fully-materialized ExtractionResult — the fallback for store paths
+ * that need objects (main-thread store, tests).
+ */
+function materializeKernelResult(result, filePath, language) {
+    if (!result.kernelBuffers)
+        return result;
+    const b = result.kernelBuffers;
+    const asBuf = (u) => Buffer.from(u.buffer, u.byteOffset, u.byteLength);
+    const decoded = (0, decode_1.decodeExtractBuffers)({ meta: asBuf(b.meta), nodes: asBuf(b.nodes), edges: asBuf(b.edges), refs: asBuf(b.refs), arena: asBuf(b.arena) }, filePath, language);
+    decoded.durationMs = result.durationMs;
+    return decoded;
+}
+/**
+ * Extract via the native kernel. Returns null when the kernel doesn't apply
+ * (not routed / not available / kill switch) — the caller falls back to the
+ * wasm TreeSitterExtractor. A kernel ERROR on a routed file also returns
+ * null: per-file fallback keeps indexing correct while a kernel bug costs
+ * only that file's speedup.
+ */
+function tryKernelExtract(filePath, source, language) {
+    if (!kernelRoutes(language))
+        return null;
+    const kernel = (0, loader_1.getKernel)();
+    if (!kernel)
+        return null;
+    if (takeDeferredPreParse(filePath, source, language) !== null)
+        return null; // already deferred
+    const t0 = Date.now();
+    const pre = preParsedSource(filePath, source, language);
+    try {
+        const buffers = kernel.extractFile(filePath, pre, language);
+        const result = (0, decode_1.decodeExtractBuffers)(buffers, filePath, language);
+        POST_PASSES[language]?.(result, source);
+        result.durationMs = Date.now() - t0;
+        return result;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        // `defer:` is the kernel's expected-routing signal (files with parse
+        // errors take the wasm path — its error RECOVERY is the canonical one;
+        // recovery differs between UTF-8 and UTF-16 parsing). Silent by design.
+        if (message.includes('defer:')) {
+            deferSlot = { filePath, source, language, pre };
+            return null;
+        }
+        if (!warned.has(language)) {
+            warned.add(language);
+            process.stderr.write(`[codegraph-kernel] ${language} extraction failed (${message}) — falling back to the wasm path\n`);
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/extraction/kernel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/extraction/kernel/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AA2IH,oCAEC;AAoBD,oDAcC;AAiBD,kDA4CC;AAOD,0DAeC;AASD,4CAkCC;AA1SD,4CAA0C;AAC1C,qCAAqD;AACrD,qCAAgD;AAChD,qCAIkB;AAElB,mCAA0E;AAAjE,mGAAA,SAAS,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAE,6GAAA,mBAAmB,OAAA;AACvD,mCAAgD;AAAvC,8GAAA,oBAAoB,OAAA;AAE7B;;;;;;GAMG;AACH,MAAM,cAAc,GAA0B,IAAI,GAAG,CAAW;IAC9D,YAAY;IACZ,KAAK;IACL,YAAY;IACZ,KAAK;IACL,MAAM;IACN,QAAQ;IACR,IAAI;IACJ,sEAAsE;IACtE,yEAAyE;IACzE,oEAAoE;IACpE,6CAA6C;IAC7C,GAAG;IACH,KAAK;IACL,uEAAuE;IACvE,wEAAwE;IACxE,8EAA8E;IAC9E,0EAA0E;IAC1E,UAAU;IACV,MAAM;IACN,4EAA4E;IAC5E,sEAAsE;IACtE,2EAA2E;IAC3E,yEAAyE;IACzE,QAAQ;IACR,uEAAuE;IACvE,oEAAoE;IACpE,0EAA0E;IAC1E,4CAA4C;IAC5C,MAAM;IACN,sEAAsE;IACtE,2EAA2E;IAC3E,0EAA0E;IAC1E,KAAK;IACL,0EAA0E;IAC1E,2EAA2E;IAC3E,2EAA2E;IAC3E,sEAAsE;IACtE,yEAAyE;IACzE,OAAO;IACP,0EAA0E;IAC1E,0EAA0E;IAC1E,oEAAoE;IACpE,gEAAgE;IAChE,2EAA2E;IAC3E,6CAA6C;IAC7C,QAAQ;IACR,yEAAyE;IACzE,qEAAqE;IACrE,yEAAyE;IACzE,0EAA0E;IAC1E,+CAA+C;IAC/C,GAAG;IACH,0EAA0E;IAC1E,0EAA0E;IAC1E,wEAAwE;IACxE,2EAA2E;IAC3E,oEAAoE;IACpE,KAAK;IACL,MAAM;IACN,wEAAwE;IACxE,oEAAoE;IACpE,mEAAmE;IACnE,oEAAoE;IACpE,kEAAkE;IAClE,8DAA8D;IAC9D,iEAAiE;IACjE,6DAA6D;IAC7D,OAAO;IACP,wEAAwE;IACxE,0EAA0E;IAC1E,wEAAwE;IACxE,kEAAkE;IAClE,sEAAsE;IACtE,gBAAgB;IAChB,MAAM;CACP,CAAC,CAAC;AAUH,MAAM,WAAW,GAA8C;AAC7D,mBAAmB;CACpB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,SAAS,eAAe,CAAC,QAAgB,EAAE,MAAc,EAAE,QAAkB;IAC3E,MAAM,GAAG,GAAG,sBAAU,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC3C,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AAC9C,CAAC;AAED,SAAS,QAAQ,CAAC,QAAkB;IAClC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAC/C,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzE,IAAI,GAAG,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACxB,CAAC;AAED,uEAAuE;AACvE,SAAgB,YAAY,CAAC,QAAkB;IAC7C,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAA,uBAAc,EAAC,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED,sFAAsF;AACtF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;AAEjC;;;;;;;;;;;GAWG;AACH,IAAI,SAAS,GAAiF,IAAI,CAAC;AAEnG,2EAA2E;AAC3E,SAAgB,oBAAoB,CAClC,QAAgB,EAChB,MAAc,EACd,QAAkB;IAElB,IACE,SAAS;QACT,SAAS,CAAC,QAAQ,KAAK,QAAQ;QAC/B,SAAS,CAAC,MAAM,KAAK,MAAM;QAC3B,SAAS,CAAC,QAAQ,KAAK,QAAQ,EAC/B,CAAC;QACD,OAAO,SAAS,CAAC,GAAG,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AASD;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CACjC,QAAgB,EAChB,MAAc,EACd,QAAkB;IAElB,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAClE,MAAM,MAAM,GAAG,IAAA,kBAAS,GAAE,CAAC;IAC3B,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,CAAC,mBAAmB;IAC/F,MAAM,GAAG,GAAG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1B,IAAI,IAAI,CAAC,SAAS,CAAC,aAAW,CAAC,OAAO,CAAC,KAAK,2BAAU,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,2BAAU,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,MAAM,MAAM,GAAG;YACb,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,aAAW,CAAC,SAAS,CAAC;YAC/C,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,aAAW,CAAC,SAAS,CAAC;YAC/C,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,aAAW,CAAC,QAAQ,CAAC;SAC9C,CAAC;QACF,IAAI,MAAM,GAA+B,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,aAAW,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,SAAS,KAAK,aAAW,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,aAAW,CAAC,SAAS,CAAC,CAAC;YAC3D,MAAM,GAAG,IAAI,CAAC,KAAK,CACjB,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC,CACnC,CAAC;QAClC,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,SAAS,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,sBAAsB,QAAQ,uBAAuB,OAAO,qCAAqC,CAClG,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB,CACrC,MAAwB,EACxB,QAAgB,EAChB,QAAkB;IAElB,IAAI,CAAC,MAAM,CAAC,aAAa;QAAE,OAAO,MAAM,CAAC;IACzC,MAAM,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC;IAC/B,MAAM,KAAK,GAAG,CAAC,CAAa,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,IAAA,6BAAoB,EAClC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,EACjH,QAAQ,EACR,QAAQ,CACT,CAAC;IACF,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACvC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAC9B,QAAgB,EAChB,MAAc,EACd,QAAkB;IAElB,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,MAAM,GAAG,IAAA,kBAAS,GAAE,CAAC;IAC3B,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,CAAC,mBAAmB;IAC/F,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,MAAM,GAAG,GAAG,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAA,6BAAoB,EAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACjE,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;QACpC,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,qEAAqE;QACrE,uEAAuE;QACvE,wEAAwE;QACxE,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,SAAS,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,sBAAsB,QAAQ,uBAAuB,OAAO,qCAAqC,CAClG,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/extraction/kernel/layout.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Native-kernel buffer layout — TS mirror of codegraph-kernel/src/buffers.rs.
+ *
+ * The kernel returns five Buffers per file: meta, nodes, edges, refs, arena.
+ * Rows are fixed-width little-endian; strings are (offset, len) pairs into
+ * the UTF-8 arena; `offset === NONE` means "field absent".
+ *
+ * THIS FILE AND buffers.rs MUST MATCH BYTE FOR BYTE. Any layout change bumps
+ * KERNEL_ABI_VERSION on both sides — the loader refuses a version it doesn't
+ * know and the extraction path falls back to wasm.
+ *
+ * NodeKind / EdgeKind / provenance / visibility cross the boundary as indexes
+ * into NODE_KINDS / EDGE_KINDS (src/types.ts) and the small tables below, so
+ * those array orders are part of the contract (append, never reorder). The
+ * loader additionally verifies the kernel's own kind tables against
+ * NODE_KINDS/EDGE_KINDS at load time, so a stale .node degrades to the wasm
+ * path instead of mis-decoding.
+ */
+export declare const KERNEL_ABI_VERSION = 2;
+/** Sentinel for "absent" in u32 slots and string-ref offsets. */
+export declare const NONE = 4294967295;
+export declare const META_SIZE = 36;
+export declare const NODE_ROW_SIZE = 96;
+export declare const EDGE_ROW_SIZE = 44;
+export declare const REF_ROW_SIZE = 40;
+/** meta byte offsets */
+export declare const META: {
+    readonly version: 0;
+    readonly nodeCount: 4;
+    readonly edgeCount: 8;
+    readonly refCount: 12;
+    readonly arenaLen: 16;
+    readonly errorsOff: 20;
+    readonly errorsLen: 24;
+    readonly durationMs: 28;
+};
+/** node row byte offsets */
+export declare const NODE: {
+    readonly kind: 0;
+    readonly visibility: 1;
+    readonly flags: 2;
+    readonly startLine: 4;
+    readonly endLine: 8;
+    readonly startColumn: 12;
+    readonly endColumn: 16;
+    readonly name: 20;
+    readonly qualifiedName: 28;
+    readonly id: 36;
+    readonly docstring: 44;
+    readonly signature: 52;
+    readonly decorators: 60;
+    readonly typeParameters: 68;
+    readonly returnType: 76;
+    readonly extraJson: 84;
+    readonly metrics: 92;
+};
+/** edge row byte offsets */
+export declare const EDGE: {
+    readonly sourceIdx: 0;
+    readonly targetIdx: 4;
+    readonly kind: 8;
+    readonly provenance: 9;
+    readonly line: 12;
+    readonly column: 16;
+    readonly metadataJson: 20;
+    readonly sourceIdStr: 28;
+    readonly targetIdStr: 36;
+};
+/** ref row byte offsets */
+export declare const REF: {
+    readonly fromIdx: 0;
+    readonly kind: 4;
+    readonly flags: 5;
+    readonly line: 8;
+    readonly column: 12;
+    readonly referenceName: 16;
+    readonly candidates: 24;
+    readonly fromIdStr: 32;
+};
+/** ReferenceKind wire code for the internal-only `function_ref` (#756). */
+export declare const FUNCTION_REF_CODE = 200;
+/**
+ * Ref-row flag bits (v2). FILE_PATH: the ref carries `filePath` = the
+ * extracted file — the ruby/php visitNode hooks set `filePath: ctx.filePath`
+ * on their mixin/trait `implements` refs (unlike every other extraction ref,
+ * which the store denormalizes); decode re-attaches its own filePath
+ * parameter, which is byte-identical.
+ */
+export declare const REF_FLAG_FILE_PATH = 1;
+/** Node bool-flag bit pairs: bit(2n) = present, bit(2n+1) = value. */
+export declare const FLAG: {
+    readonly isExported: 0;
+    readonly isAsync: 1;
+    readonly isStatic: 2;
+    readonly isAbstract: 3;
+};
+/** visibility byte values (0 = absent). */
+export declare const VISIBILITIES: readonly [undefined, "public", "private", "protected", "internal"];
+/** provenance byte values (0 = absent). */
+export declare const PROVENANCES: readonly [undefined, "tree-sitter", "scip", "heuristic"];
+//# sourceMappingURL=layout.d.ts.map

package/dist/extraction/kernel/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/extraction/kernel/layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,iEAAiE;AACjE,eAAO,MAAM,IAAI,aAAa,CAAC;AAE/B,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B,wBAAwB;AACxB,eAAO,MAAM,IAAI;;;;;;;;;CASP,CAAC;AAEX,4BAA4B;AAC5B,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;CAkBP,CAAC;AAEX,4BAA4B;AAC5B,eAAO,MAAM,IAAI;;;;;;;;;;CAUP,CAAC;AAEX,2BAA2B;AAC3B,eAAO,MAAM,GAAG;;;;;;;;;CASN,CAAC;AAEX,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,sEAAsE;AACtE,eAAO,MAAM,IAAI;;;;;CAKP,CAAC;AAEX,2CAA2C;AAC3C,eAAO,MAAM,YAAY,oEAAqE,CAAC;AAE/F,2CAA2C;AAC3C,eAAO,MAAM,WAAW,0DAA2D,CAAC"}

package/dist/extraction/kernel/layout.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * Native-kernel buffer layout — TS mirror of codegraph-kernel/src/buffers.rs.
+ *
+ * The kernel returns five Buffers per file: meta, nodes, edges, refs, arena.
+ * Rows are fixed-width little-endian; strings are (offset, len) pairs into
+ * the UTF-8 arena; `offset === NONE` means "field absent".
+ *
+ * THIS FILE AND buffers.rs MUST MATCH BYTE FOR BYTE. Any layout change bumps
+ * KERNEL_ABI_VERSION on both sides — the loader refuses a version it doesn't
+ * know and the extraction path falls back to wasm.
+ *
+ * NodeKind / EdgeKind / provenance / visibility cross the boundary as indexes
+ * into NODE_KINDS / EDGE_KINDS (src/types.ts) and the small tables below, so
+ * those array orders are part of the contract (append, never reorder). The
+ * loader additionally verifies the kernel's own kind tables against
+ * NODE_KINDS/EDGE_KINDS at load time, so a stale .node degrades to the wasm
+ * path instead of mis-decoding.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROVENANCES = exports.VISIBILITIES = exports.FLAG = exports.REF_FLAG_FILE_PATH = exports.FUNCTION_REF_CODE = exports.REF = exports.EDGE = exports.NODE = exports.META = exports.REF_ROW_SIZE = exports.EDGE_ROW_SIZE = exports.NODE_ROW_SIZE = exports.META_SIZE = exports.NONE = exports.KERNEL_ABI_VERSION = void 0;
+exports.KERNEL_ABI_VERSION = 2;
+/** Sentinel for "absent" in u32 slots and string-ref offsets. */
+exports.NONE = 0xffffffff;
+exports.META_SIZE = 36;
+exports.NODE_ROW_SIZE = 96;
+exports.EDGE_ROW_SIZE = 44;
+exports.REF_ROW_SIZE = 40;
+/** meta byte offsets */
+exports.META = {
+    version: 0, // u8
+    nodeCount: 4, // u32
+    edgeCount: 8, // u32
+    refCount: 12, // u32
+    arenaLen: 16, // u32
+    errorsOff: 20, // u32 (NONE = no errors)
+    errorsLen: 24, // u32
+    durationMs: 28, // f64 (kernel-side wall; introspection only)
+};
+/** node row byte offsets */
+exports.NODE = {
+    kind: 0, // u8 — NODE_KINDS index
+    visibility: 1, // u8 — VISIBILITIES index (0 = absent)
+    flags: 2, // u16 — (present, value) bit pairs, see FLAG
+    startLine: 4, // u32
+    endLine: 8, // u32
+    startColumn: 12, // u32
+    endColumn: 16, // u32
+    name: 20, // str
+    qualifiedName: 28, // str
+    id: 36, // str — kernel-computed node id
+    docstring: 44, // str
+    signature: 52, // str
+    decorators: 60, // str — NUL-joined list
+    typeParameters: 68, // str — NUL-joined list
+    returnType: 76, // str
+    extraJson: 84, // str — JSON of any extra Node props (escape hatch)
+    metrics: 92, // u32 — reserved (Arc 3.2 per-node code metrics)
+};
+/** edge row byte offsets */
+exports.EDGE = {
+    sourceIdx: 0, // u32 (NONE → sourceIdStr)
+    targetIdx: 4, // u32 (NONE → targetIdStr)
+    kind: 8, // u8 — EDGE_KINDS index
+    provenance: 9, // u8 — PROVENANCES index (0 = absent)
+    line: 12, // u32 (NONE = absent)
+    column: 16, // u32 (NONE = absent)
+    metadataJson: 20, // str
+    sourceIdStr: 28, // str
+    targetIdStr: 36, // str
+};
+/** ref row byte offsets */
+exports.REF = {
+    fromIdx: 0, // u32 (NONE → fromIdStr)
+    kind: 4, // u8 — EDGE_KINDS index, or FUNCTION_REF_CODE
+    flags: 5, // u8 — REF_FLAGS bits (v2)
+    line: 8, // u32
+    column: 12, // u32
+    referenceName: 16, // str
+    candidates: 24, // str — NUL-joined list
+    fromIdStr: 32, // str
+};
+/** ReferenceKind wire code for the internal-only `function_ref` (#756). */
+exports.FUNCTION_REF_CODE = 200;
+/**
+ * Ref-row flag bits (v2). FILE_PATH: the ref carries `filePath` = the
+ * extracted file — the ruby/php visitNode hooks set `filePath: ctx.filePath`
+ * on their mixin/trait `implements` refs (unlike every other extraction ref,
+ * which the store denormalizes); decode re-attaches its own filePath
+ * parameter, which is byte-identical.
+ */
+exports.REF_FLAG_FILE_PATH = 1;
+/** Node bool-flag bit pairs: bit(2n) = present, bit(2n+1) = value. */
+exports.FLAG = {
+    isExported: 0,
+    isAsync: 1,
+    isStatic: 2,
+    isAbstract: 3,
+};
+/** visibility byte values (0 = absent). */
+exports.VISIBILITIES = [undefined, 'public', 'private', 'protected', 'internal'];
+/** provenance byte values (0 = absent). */
+exports.PROVENANCES = [undefined, 'tree-sitter', 'scip', 'heuristic'];
+//# sourceMappingURL=layout.js.map

package/dist/extraction/kernel/layout.js.map

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

package/dist/extraction/kernel/loader.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Native-kernel loader — finds, loads, and contract-verifies the
+ * codegraph-kernel .node addon.
+ *
+ * The kernel is OPTIONAL everywhere. Every failure mode here (no binary for
+ * this platform, dlopen error, ABI/kind-table mismatch) resolves to `null`
+ * and the extraction path silently keeps using the wasm pipeline — a missing
+ * or stale kernel must never break indexing, only skip the speedup. Set
+ * CODEGRAPH_KERNEL_DEBUG=1 to see why a kernel didn't load.
+ *
+ * Kill switch: CODEGRAPH_KERNEL=0 disables the kernel entirely (checked per
+ * call so tests and embedders can flip it at runtime).
+ *
+ * Search order:
+ *   1. CODEGRAPH_KERNEL_PATH — explicit .node path (dev/testing override)
+ *   2. <up3>/kernel/codegraph-kernel.node — the release bundle layout
+ *      (lib/dist/** next to lib/kernel/; see scripts/build-bundle.sh)
+ *   3. <up3>/codegraph-kernel/prebuilds/<platform>-<arch>/codegraph-kernel.node
+ *      — from-source runs and tests (staged by scripts/build-kernel.sh)
+ *
+ * "up3" = three directories above this file, which is the package root both
+ * from src/extraction/kernel/ and from dist/extraction/kernel/.
+ */
+/** Raw buffer tables for one file — see layout.ts for the byte layout. */
+export interface KernelBuffers {
+    meta: Buffer;
+    nodes: Buffer;
+    edges: Buffer;
+    refs: Buffer;
+    arena: Buffer;
+}
+export interface KernelContractInfo {
+    abiVersion: number;
+    kernelVersion: string;
+    nodeKinds: string[];
+    edgeKinds: string[];
+    languages: string[];
+}
+export interface KernelGrammarInfo {
+    abiVersion: number;
+    nodeKindCount: number;
+    fieldCount: number;
+    nodeKinds: string[];
+    fieldNames: string[];
+}
+/** Input to the cFnPtr extraction sweep: one file's raw text + its struct
+ *  node extents (`endLine ?? startLine` applied by the caller). */
+export interface CfnptrFileIn {
+    text: string;
+    structs: {
+        id: string;
+        startLine: number;
+        endLine: number;
+    }[];
+}
+/** Per-file facts from the native cFnPtr extraction sweep — mirror of the
+ *  Rust `CfnptrFacts` (see codegraph-kernel/src/cfnptr.rs); semantics match
+ *  the JS sweep in src/resolution/c-fnptr-synthesizer.ts. */
+export interface CfnptrFactsOut {
+    fnPtrTypedefs: string[];
+    fnTypeTypedefs: string[];
+    structs: {
+        id: string;
+        parsed: boolean;
+        fields: {
+            name: string;
+            index: number;
+            ptr: boolean;
+            type: string;
+        }[];
+    }[];
+    inlinePtr: boolean;
+    inlineTypes: string[];
+    inlineTags: string[];
+    initTokens: string[];
+    arrayElems: string[];
+    aliasNames: string[];
+    dPairs: string[];
+    dispatchFields: string[];
+    arrayDispatchNames: string[];
+    includes: string[];
+}
+export interface KernelModule {
+    extractFile(filePath: string, content: string, language: string): KernelBuffers;
+    contractInfo(): KernelContractInfo;
+    grammarInfo(language: string): KernelGrammarInfo | null;
+    /** Batched cFnPtr extraction sweep (task #5 step 2). OPTIONAL: absent on
+     *  older binaries — callers feature-detect and keep their JS path. */
+    cfnptrScanFiles?(files: CfnptrFileIn[]): CfnptrFactsOut[];
+    /** Native `stripCommentsForRegex(text, 'c')` — differential-oracle hook. */
+    cfnptrStripC?(text: string): string;
+}
+/**
+ * Load (once per process) and return the kernel module, or null when
+ * unavailable. The kill switch is NOT checked here — callers route through
+ * `kernelAvailable()` / `tryKernelExtract()` which check it per call.
+ */
+export declare function getKernel(): KernelModule | null;
+/** True when the kill switch is off, a verified binary is loaded, and it supports `language`. */
+export declare function kernelSupports(language: string): boolean;
+/** Test hook: forget the loaded module so a changed env is re-evaluated. */
+export declare function resetKernelForTests(): void;
+//# sourceMappingURL=loader.d.ts.map

package/dist/extraction/kernel/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/extraction/kernel/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAQH,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;mEACmE;AACnE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/D;AAED;;6DAE6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,OAAO,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,EAAE,CAAC;IAClH,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC;IAChF,YAAY,IAAI,kBAAkB,CAAC;IACnC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAAC;IACxD;0EACsE;IACtE,eAAe,CAAC,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,cAAc,EAAE,CAAC;IAC1D,4EAA4E;IAC5E,YAAY,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACrC;AAgDD;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,YAAY,GAAG,IAAI,CAuB/C;AAED,iGAAiG;AACjG,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C"}