@massa-ai/core 1.2.1

package/dist/services/structural/native-lock-identities.js

@@ -0,0 +1,192 @@
+/**
+ * Canonical native grammar identity pins shared by the offline verifier
+ * (`scripts/verify-tree-sitter-grammars.ts`) and the runtime load-time
+ * integrity check (`grammar-integrity.ts`).
+ *
+ * Keep this module free of filesystem, crypto, and runtime-only imports so the
+ * pinned data has exactly one owner and both the verifier script and the
+ * structural runtime import from the same source of truth.
+ *
+ * ABI-rebuild safety: the runtime integrity basis is `sourceIntegrity`, a
+ * sha512 over the installed package's ABI-independent source files
+ * (`package.json`, root `grammar.js`, and `src/**`). The compiled `.node`
+ * artifacts under `prebuilds/`, `build/`, and `bindings/node/build` are
+ * intentionally excluded so a legitimate Bun/Node ABI rebuild cannot flip the
+ * hash; only a change to the grammar source itself (a real version drift or
+ * tampering) fails the check.
+ */
+export const TREE_SITTER_PATCH = Object.freeze({
+    package: "tree-sitter@0.25.0",
+    path: "patches/tree-sitter@0.25.0.patch",
+    sha256: "cd957e559b88dfe54219b77ab25f4dfd1d5a24c64afe0db6f2d4e6868f49b6e8",
+});
+export const NATIVE_DEPENDENCIES = {
+    "@tree-sitter-grammars/tree-sitter-kotlin": "1.1.0",
+    "@tree-sitter-grammars/tree-sitter-lua": "0.4.1",
+    "@tree-sitter-grammars/tree-sitter-markdown": "0.3.2",
+    "@tree-sitter-grammars/tree-sitter-yaml": "0.7.1",
+    "@tree-sitter-grammars/tree-sitter-zig": "1.1.2",
+    "tree-sitter": "0.25.0",
+    "tree-sitter-c": "0.24.1",
+    "tree-sitter-c-sharp": "0.23.5",
+    "tree-sitter-clojure-orchard": "0.2.5",
+    "tree-sitter-cpp": "0.23.4",
+    "tree-sitter-dart": "github:UserNobody14/tree-sitter-dart#be07cf7118d3dba06236a3f19541685a68209934",
+    "tree-sitter-elixir": "0.3.5",
+    "tree-sitter-erlang": "github:WhatsApp/tree-sitter-erlang#836aa2b6c3af2c7cef3f84049b0ed6d44485a870",
+    "tree-sitter-go": "0.25.0",
+    "tree-sitter-haskell": "0.23.1",
+    "tree-sitter-html": "0.23.2",
+    "tree-sitter-java": "0.23.5",
+    "tree-sitter-javascript": "0.25.0",
+    "tree-sitter-json": "0.24.8",
+    "tree-sitter-ocaml": "0.24.2",
+    "tree-sitter-php": "0.24.2",
+    "tree-sitter-python": "0.25.0",
+    "tree-sitter-ruby": "0.23.1",
+    "tree-sitter-rust": "0.24.0",
+    "tree-sitter-scala": "0.24.0",
+    "tree-sitter-swift": "0.7.1",
+    "tree-sitter-typescript": "0.23.2",
+};
+export const NATIVE_LOCK_IDENTITIES = {
+    "@tree-sitter-grammars/tree-sitter-kotlin": {
+        resolved: "@tree-sitter-grammars/tree-sitter-kotlin@1.1.0",
+        sri: "sha512-vlVXaxEE8t2kpJgfZpa8XVvxcnKw9AYtRTgy7KWjsDmAsadk06RxAT80IXOgGQnmM9i/orQn1nD84gPNUHu6DQ==",
+        sourceIntegrity: "sha512-TvnLKtoe1ADOLljHufwXbjtJpAOdW+p6BhSZDHBQYFIX3uoeMx3v0ta1CI2ShSuTSHrF17xINpVcd0ZeSg+ETA==",
+    },
+    "@tree-sitter-grammars/tree-sitter-lua": {
+        resolved: "@tree-sitter-grammars/tree-sitter-lua@0.4.1",
+        sri: "sha512-EwagFaU6ZveVk18/Y8qUhZkkiBKnQ7dSCHbm//TUroLVKy3i1rOYGy/cNHtSkAb1eDvS1HhCLybH2S541Cya/g==",
+        sourceIntegrity: "sha512-JZV4+hyBcF5yF6K+fQGaiibgz5v1O4VhQYypEoor9NStjKxNTC4zmHXm3ZyqgwXrR+JsbLzk1haiVW+QUkB++g==",
+    },
+    "@tree-sitter-grammars/tree-sitter-markdown": {
+        resolved: "@tree-sitter-grammars/tree-sitter-markdown@0.3.2",
+        sri: "sha512-hQXCcDVvg2t4E8cn7zz6jjIBerzk9E9ZlHxJp5IrUOpY4s1YVpXJbMeWZks2/V7lmkPRnnkM8IrTbQ5ltwEOnA==",
+        sourceIntegrity: "sha512-Np1hV4aWXhgplr2Gu1imYtXA/uxWfbXnLiCB4iZ6QS61IOaYtMts8ae8CbecdY0s9AuMlntqKazB8LKIElsq6g==",
+    },
+    "@tree-sitter-grammars/tree-sitter-yaml": {
+        resolved: "@tree-sitter-grammars/tree-sitter-yaml@0.7.1",
+        sri: "sha512-AynBwkIoQCTgjDR33bDUp9Mqq+YTco0is3n5hRApMqG9of/6A4eQsfC1/uSEeHSUyMQSYawcAWamsexnVpIP4Q==",
+        sourceIntegrity: "sha512-GpLXgnJq8NziRqAbm8BzHCK/1qaOnj675z3bRxK6X8FbnrUnBzUDeIt++bq6CEvhbsBt5/Jet2W2LRPDcJc4yQ==",
+    },
+    "@tree-sitter-grammars/tree-sitter-zig": {
+        resolved: "@tree-sitter-grammars/tree-sitter-zig@1.1.2",
+        sri: "sha512-J0L31HZ2isy3F5zb2g5QWQOv2r/pbruQNL9ADhuQv2pn5BQOzxt80WcEJaYXBeuJ8GHxVT42slpCna8k1c8LOw==",
+        sourceIntegrity: "sha512-CJiu42fWL+cvrzdmVuYiV/qOJrZaLKneIIb9bKamGtb+IYQnanGaNBNnEi+JtlW6CvUkLJ8B9NaQYJOrmx1Yvg==",
+    },
+    "tree-sitter": {
+        resolved: "tree-sitter@0.25.0",
+        sri: "sha512-PGZZzFW63eElZJDe/b/R/LbsjDDYJa5UEjLZJB59RQsMX+fo0j54fqBPn1MGKav/QNa0JR0zBiVaikYDWCj5KQ==",
+        sourceIntegrity: "sha512-dUm5bDgJETEMVMtAUPyBm8gz30K2RT8GJV9cu/2iF6snKW8mtS2oCLEiBKq9xqtHl/iiOOgfzu1BGWZ39Us4bw==",
+    },
+    "tree-sitter-c": {
+        resolved: "tree-sitter-c@0.24.1",
+        sri: "sha512-lkYwWN3SRecpvaeqmFKkuPNR3ZbtnvHU+4XAEEkJdrp3JfSp2pBrhXOtvfsENUneye76g889Y0ddF2DM0gEDpA==",
+        sourceIntegrity: "sha512-hKT8TxIgML0Yc2NYIvCipU0vcwkD2NGHSMhpUvxuXskovoHKc/gEN8Pj76k0jcCllRBeEKT854gMd/bwBA/p4Q==",
+    },
+    "tree-sitter-c-sharp": {
+        resolved: "tree-sitter-c-sharp@0.23.5",
+        sri: "sha512-xJGOeXPMmld0nES5+080N/06yY6LQi+KWGWV4LfZaZe6srJPtUtfhIbRSN7EZN6IaauzW28v6W4QHFwmeUW6HQ==",
+        sourceIntegrity: "sha512-bm2VaW3ckRz9ghTEka7q7se4jgYtDSev6YaTVs8JwT+QOInkpiFpRhgKM7DWCvsXOY+YLDSevMTrCXL/KsSIKQ==",
+    },
+    "tree-sitter-clojure-orchard": {
+        resolved: "tree-sitter-clojure-orchard@0.2.5",
+        sri: "sha512-X+JaSnqY9hNYDA/hsQ40My47qoG+J26y11VAZ4YUzH3u8ggs+b9sFRQuxE6pNnlgwqWtJUycxnB0cOomtOIvAw==",
+        sourceIntegrity: "sha512-B5tgKfWIsWd2nPTS6kDBg7F38zAv9833qcPzXKd2nMQ3mr9E+xfZ1sbEOYOn/lWjzQJP9mSh3Ai1Ud9wzcqZbA==",
+    },
+    "tree-sitter-cpp": {
+        resolved: "tree-sitter-cpp@0.23.4",
+        sri: "sha512-qR5qUDyhZ5jJ6V8/umiBxokRbe89bCGmcq/dk94wI4kN86qfdV8k0GHIUEKaqWgcu42wKal5E97LKpLeVW8sKw==",
+        sourceIntegrity: "sha512-DWHKvc7tze4NMM+aJSMCECv5sKvOqK9346ljeQVl6Tc6dQTBSai5VkBaH6+QksTaK/GBxGOzLSLvI93v3W+ERA==",
+    },
+    "tree-sitter-dart": {
+        resolved: "tree-sitter-dart@github:UserNobody14/tree-sitter-dart#be07cf7",
+        gitIdentity: "UserNobody14-tree-sitter-dart-be07cf7",
+        sourceIntegrity: "sha512-8kUB+x7poKS1aS+yMAbQL8+vWq+IereTjcAA77fKHNq/lsAOdoOeXsX2JyWHQfk9tZCJVFN5Dt/hbD8BihAiZw==",
+    },
+    "tree-sitter-elixir": {
+        resolved: "tree-sitter-elixir@0.3.5",
+        sri: "sha512-xozQMvYK0aSolcQZAx2d84Xe/YMWFuRPYFlLVxO01bM2GITh5jyiIp0TqPCQa8754UzRAI7A83hZmfiYub5TZQ==",
+        sourceIntegrity: "sha512-ZcnD5J31m+fCl/pVDXmAYsQL/J3d7Q1y7RRp+gNaWgVAgN1f8bMSs9t1oDCQhxkxXERVVKP3cmqyedSKY5okHA==",
+    },
+    "tree-sitter-erlang": {
+        resolved: "tree-sitter-erlang@github:WhatsApp/tree-sitter-erlang#836aa2b",
+        gitIdentity: "WhatsApp-tree-sitter-erlang-836aa2b",
+        sourceIntegrity: "sha512-Kv7J8TouuOzxrdRD83vNbPjhMC1wpVbsfWWtRqDU/PySDVI8EwuV6OjfQ5fTLZZ6eDBKVQHs2n1GQPaQPARNmw==",
+    },
+    "tree-sitter-go": {
+        resolved: "tree-sitter-go@0.25.0",
+        sri: "sha512-APBc/Dq3xz/e35Xpkhb1blu5UgW+2E3RyGWawZSCNcbGwa7jhSQPS8KsUupuzBla8PCo8+lz9W/JDJjmfRa2tw==",
+        sourceIntegrity: "sha512-SStrwJmN+tGdgfO5yTohmMuN5qTjOsvYWfFOdm3lefQpEu0j4mNP+yQv/VbXxmoWhRwG+FB4g/Es4HVU3YeaPA==",
+    },
+    "tree-sitter-haskell": {
+        resolved: "tree-sitter-haskell@0.23.1",
+        sri: "sha512-qG4CYhejveu9DLMLEGBz/n9/TTeGSFLC6wniwOgG6m8/v7Dng8qR0ob0EVG7+XH+9WiOxohpGA23EhceWuxY4w==",
+        sourceIntegrity: "sha512-yyNNWjAVvKgj3ZuCfuhzpRYSfWkwasJ36eNtMrsYXwSZ6LWBiQzvBoR4Y+iqM8NoyGPYvpGkoVjiz2I5xXsbtA==",
+    },
+    "tree-sitter-html": {
+        resolved: "tree-sitter-html@0.23.2",
+        sri: "sha512-TN+l+7cCeLx9db/1RhRSqMAZO/266Oh2BHb8J8hMSSFLuzYvFTYP/UnD3S0mny5awzw05KzFNgu2vnwzN9wVJg==",
+        sourceIntegrity: "sha512-tiBblp/EAaBuHhP8DhA9oVZGJkim6RPspQkh19BPR+d8WX0sdioL4WItc2RDQe8PBxtVRZpi1txl3Yd84tBDQg==",
+    },
+    "tree-sitter-java": {
+        resolved: "tree-sitter-java@0.23.5",
+        sri: "sha512-Yju7oQ0Xx7GcUT01mUglPP+bYfvqjNCGdxqigTnew9nLGoII42PNVP3bHrYeMxswiCRM0yubWmN5qk+zsg0zMA==",
+        sourceIntegrity: "sha512-FCkFiXqyvIBdOHdo/liD2gg/NtnJvOW2SwbE6wp+4nUmKpiruAW20DOSq/nLPCF2abQdQnHvYKcX4+uNcDOxbQ==",
+    },
+    "tree-sitter-javascript": {
+        resolved: "tree-sitter-javascript@0.25.0",
+        sri: "sha512-1fCbmzAskZkxcZzN41sFZ2br2iqTYP3tKls1b/HKGNPQUVOpsUxpmGxdN/wMqAk3jYZnYBR1dd/y/0avMeU7dw==",
+        sourceIntegrity: "sha512-LAttNiBUFECGQ/d+lOTczdoQF07VOAXhWoTJq88ZCjGsMrFt9GpZDe18ERGpgW6iT5cI6+cZsBwu9mkSoBY6/A==",
+    },
+    "tree-sitter-json": {
+        resolved: "tree-sitter-json@0.24.8",
+        sri: "sha512-Tc9ZZYwHyWZ3Tt1VEw7Pa2scu1YO7/d2BCBbKTx5hXwig3UfdQjsOPkPyLpDJOn/m1UBEWYAtSdGAwCSyagBqQ==",
+        sourceIntegrity: "sha512-7doz1LNnVoIzxrnAK3siRBE0MpIvS+vipXqIJSSj1Fh5LW/FZO55vRCu8sRWrazU0Dj2MjjQQ8veoYmFNsVXhA==",
+    },
+    "tree-sitter-ocaml": {
+        resolved: "tree-sitter-ocaml@0.24.2",
+        sri: "sha512-H0RAeCepIyXyTPCQra6yMd7Bn5ZBYkIaddzdLNwVZpM9mCe2e8av+3O6Ojl7Z8YHrV/kYsfHvI2y+Hh7qzcYQQ==",
+        sourceIntegrity: "sha512-OTHuD87aafwG71eAp64fBaB4oKf1Z5fC9zhDo3tGKY7PzQh2n7gRHLnoFyJevAcikVPsI9CrekefIZjuflcROw==",
+    },
+    "tree-sitter-php": {
+        resolved: "tree-sitter-php@0.24.2",
+        sri: "sha512-zwgAePc/HozNaWOOfwRAA+3p8yhuehRw8Fb7vn5qd2XjiIc93uJPryDTMYTSjBRjVIUg/KY6pM3rRzs8dSwKfw==",
+        sourceIntegrity: "sha512-OZqmUAF8wVSNBjuEBZ+x8yE+3YBu7fdaMH2xPBrscq9NDGuQ7olM1LXGiUxCpUy3tZjkj/xaV+7vJrdUW/oqiQ==",
+    },
+    "tree-sitter-python": {
+        resolved: "tree-sitter-python@0.25.0",
+        sri: "sha512-eCmJx6zQa35GxaCtQD+wXHOhYqBxEL+bp71W/s3fcDMu06MrtzkVXR437dRrCrbrDbyLuUDJpAgycs7ncngLXw==",
+        sourceIntegrity: "sha512-rQtq2NOV1WgE+wSeeMQP5i9EIcCz/eOchf6OUn0kPCLAVc92U/n/tpgSjj7XFXBiPXM3OXHr6BiphIjcDzkTGQ==",
+    },
+    "tree-sitter-ruby": {
+        resolved: "tree-sitter-ruby@0.23.1",
+        sri: "sha512-d9/RXgWjR6HanN7wTYhS5bpBQLz1VkH048Vm3CodPGyJVnamXMGb8oEhDypVCBq4QnHui9sTXuJBBP3WtCw5RA==",
+        sourceIntegrity: "sha512-5waH6SaHBtS+kdHNyDKD/1R/+QcEf60//1+38igZIoeAIpdqLStAqKfllYFqPWhMHk3jDeHicytNEZQ9tjxrQA==",
+    },
+    "tree-sitter-rust": {
+        resolved: "tree-sitter-rust@0.24.0",
+        sri: "sha512-NWemUDf629Tfc90Y0Z55zuwPCAHkLxWnMf2RznYu4iBkkrQl2o/CHGB7Cr52TyN5F1DAx8FmUnDtCy9iUkXZEQ==",
+        sourceIntegrity: "sha512-Vkk40DHkyu+HfTJ7E/MuP0UFI+1bKzZWtIMDhvtCxvIuegon05ZG4SVA8S+EKznXp9goPqi1y7cbT6/XoLuVzA==",
+    },
+    "tree-sitter-scala": {
+        resolved: "tree-sitter-scala@0.24.0",
+        sri: "sha512-vkMuAUrBZ1zZz2XcGDQk18Kz73JkpgaeXzbNVobPke0G35sd9jH32aUxG6OLRKM7et0TbsfqkWf4DeJoGk4K1g==",
+        sourceIntegrity: "sha512-aAR0VCFVGZTb4wNZxT3wSY/DIqGBAri6P/W4+l0hUm9lb5R121qA86ZBzhtM2WOlHjXCJoTB9B8DcaIWvt4opQ==",
+    },
+    "tree-sitter-swift": {
+        resolved: "tree-sitter-swift@0.7.1",
+        sri: "sha512-pneKVTuGamaBsqqqfB9BvNQjktzh/0IVPR54jLB5Fq/JTDQwYHd0Wo6pVyZ5jAYpbztzq+rJ/rpL9ruxTmSoKw==",
+        sourceIntegrity: "sha512-+ecUvgXX/f5IuzKyr2GeCEkfvg/ZSz12z3UzsBZgbwPGp7C1BM/ANeX1rQdXsTEKxUNfeFAyh3KyK2cOogtBEw==",
+    },
+    "tree-sitter-typescript": {
+        resolved: "tree-sitter-typescript@0.23.2",
+        sri: "sha512-e04JUUKxTT53/x3Uq1zIL45DoYKVfHH4CZqwgZhPg5qYROl5nQjV+85ruFzFGZxu+QeFVbRTPDRnqL9UbU4VeA==",
+        sourceIntegrity: "sha512-fW0nTaW2eLU+hG5GvVQbQ4S8lg4d7ksXt0Df8oBP2XvPZGkM5kGnjRn7gFg16PfHHp4Cae7+RC6UubvsIyhsIw==",
+    },
+};
+export const TRUSTED_NATIVE_PACKAGES = Object.freeze(Object.keys(NATIVE_DEPENDENCIES).sort());
+/** Count of pinned identities; used to guard drift against the dependency set. */
+export const NATIVE_LOCK_IDENTITY_COUNT = TRUSTED_NATIVE_PACKAGES.length;
+//# sourceMappingURL=native-lock-identities.js.map

package/dist/services/structural/native-lock-identities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-lock-identities.js","sourceRoot":"","sources":["../../../src/services/structural/native-lock-identities.ts"],"names":[],"mappings":"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"}

package/dist/services/structural/native-node-helpers.d.ts

@@ -0,0 +1,16 @@
+import type { NativeQueryNode } from "./grammar-loaders.js";
+import { SourceIndex } from "./source-span.js";
+declare function text(source: Buffer, node: NativeQueryNode): string;
+declare function frozenSpan(index: SourceIndex, startByte: number, endByte: number): Readonly<{
+    start: Readonly<import("./types.js").SourcePoint>;
+    end: Readonly<import("./types.js").SourcePoint>;
+    startByte: number;
+    endByte: number;
+}>;
+declare function field(node: NativeQueryNode, name: string): NativeQueryNode | null;
+declare function descendants(node: NativeQueryNode): readonly NativeQueryNode[];
+declare function symbolName(source: Buffer, node: NativeQueryNode): string | null;
+declare function ancestor(node: NativeQueryNode | null | undefined, type: string): NativeQueryNode | undefined;
+declare function unquote(value: string): string;
+export { text, frozenSpan, field, descendants, symbolName, ancestor, unquote };
+//# sourceMappingURL=native-node-helpers.d.ts.map

package/dist/services/structural/native-node-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-node-helpers.d.ts","sourceRoot":"","sources":["../../../src/services/structural/native-node-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,iBAAS,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM,CAE3D;AAED,iBAAS,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;;;;;GAOzE;AAED,iBAAS,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAE1E;AAED,iBAAS,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,eAAe,EAAE,CAUtE;AAED,iBAAS,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CA6FxE;AAED,iBAAS,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAOrG;AAED,iBAAS,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtC;AAED,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC"}

package/dist/services/structural/native-node-helpers.js

@@ -0,0 +1,145 @@
+function text(source, node) {
+    return source.subarray(node.startIndex, node.endIndex).toString("utf8");
+}
+function frozenSpan(index, startByte, endByte) {
+    const span = index.span(startByte, endByte);
+    return Object.freeze({
+        ...span,
+        start: Object.freeze(span.start),
+        end: Object.freeze(span.end),
+    });
+}
+function field(node, name) {
+    return node.childForFieldName?.(name) ?? null;
+}
+function descendants(node) {
+    const result = [];
+    const visit = (current) => {
+        for (const child of current.namedChildren ?? []) {
+            result.push(child);
+            visit(child);
+        }
+    };
+    visit(node);
+    return result;
+}
+function symbolName(source, node) {
+    if (["pair", "block_mapping_pair", "flow_pair"].includes(node.type)) {
+        const key = field(node, "key");
+        return key ? unquote(text(source, key)).normalize("NFC") : null;
+    }
+    if (["atx_heading", "setext_heading"].includes(node.type)) {
+        const content = field(node, "heading_content") ?? node.namedChildren?.find((child) => !child.type.includes("marker") && !child.type.includes("underline"));
+        return content ? text(source, content).trim().normalize("NFC") : null;
+    }
+    const nameNode = field(node, "name") ?? field(node, "property") ?? field(node, "left");
+    if (nameNode) {
+        const raw = text(source, nameNode);
+        return (raw.startsWith("#") ? `%23${raw.slice(1)}` : raw).normalize("NFC");
+    }
+    if (node.type === "call") {
+        const target = field(node, "target");
+        const targetText = target ? text(source, target) : "";
+        if (["defmodule", "defprotocol", "def", "defp", "defmacro", "defmacrop"].includes(targetText)) {
+            const argumentsNode = node.namedChildren?.find((child) => child.type === "arguments");
+            const candidate = argumentsNode?.namedChildren?.[0];
+            if (candidate) {
+                const head = candidate.type === "call" ? field(candidate, "target") : candidate;
+                if (head)
+                    return text(source, head).normalize("NFC");
+            }
+        }
+    }
+    if (node.type === "list_lit") {
+        const values = (node.namedChildren ?? []).filter((child) => child.type !== "comment");
+        return values[1] ? text(source, values[1]).normalize("NFC") : null;
+    }
+    if (["module_definition", "value_definition", "type_definition", "class_definition"].includes(node.type)) {
+        const candidate = descendants(node).find((child) => [
+            "module_name", "value_name", "type_constructor", "class_name",
+        ].includes(child.type));
+        if (candidate)
+            return text(source, candidate).normalize("NFC");
+    }
+    if (node.type === "fun_decl") {
+        const clause = descendants(node).find((child) => child.type === "function_clause");
+        const nestedName = clause ? field(clause, "name") : null;
+        if (nestedName)
+            return text(source, nestedName).normalize("NFC");
+    }
+    if (node.type === "module" || node.type === "header") {
+        const moduleNode = node.type === "module" ? node : descendants(node).find((child) => child.type === "module");
+        if (moduleNode)
+            return text(source, moduleNode).normalize("NFC");
+    }
+    if (["function_definition", "type_definition"].includes(node.type)) {
+        let declarator = field(node, "declarator");
+        while (declarator) {
+            if (["identifier", "field_identifier", "type_identifier"].includes(declarator.type)) {
+                return text(source, declarator).normalize("NFC");
+            }
+            declarator = field(declarator, "declarator");
+        }
+    }
+    if (node.type === "variable_declaration") {
+        const identifier = node.namedChildren?.find((child) => child.type === "identifier");
+        return identifier ? text(source, identifier).normalize("NFC") : null;
+    }
+    if (node.type === "class_declaration" && text(source, node).trimStart().startsWith("enum "))
+        return "enum";
+    if (node.type === "init_declaration")
+        return "init";
+    if (node.type === "secondary_constructor")
+        return "constructor";
+    if (["primary_constructor", "class_parameters"].includes(node.type)) {
+        const owner = ancestor(node, "class_declaration") ?? ancestor(node, "class_definition");
+        const ownerName = owner ? field(owner, "name") : null;
+        return ownerName ? text(source, ownerName).normalize("NFC") : "constructor";
+    }
+    if (node.type === "function_definition" && symbolName(source, node) === "this")
+        return "constructor";
+    if (["property_declaration", "field_declaration", "val_definition", "var_definition", "initialized_identifier", "initialized_variable_definition", "class_parameter"].includes(node.type)) {
+        const identifier = descendants(node).find((child) => ["variable_declarator", "initialized_identifier", "initialized_variable_definition"].includes(child.type)) ??
+            descendants(node).find((child) => ["simple_identifier", "identifier"].includes(child.type));
+        if (identifier) {
+            const nested = field(identifier, "name") ?? identifier.namedChildren?.find((child) => ["identifier", "simple_identifier"].includes(child.type));
+            return text(source, nested ?? identifier).normalize("NFC");
+        }
+    }
+    if (["function_signature", "method_signature"].includes(node.type)) {
+        const nestedName = descendants(node).map((child) => field(child, "name")).find((child) => Boolean(child));
+        if (nestedName)
+            return text(source, nestedName).normalize("NFC");
+    }
+    if (node.type === "type_parameter") {
+        const identifier = node.namedChildren?.find((child) => child.type === "type_identifier" || child.type === "identifier");
+        return identifier ? text(source, identifier).normalize("NFC") : null;
+    }
+    if (node.type === "export_statement") {
+        const declaration = field(node, "declaration") ?? node.namedChildren?.find((child) => child.type.endsWith("_declaration") || child.type === "lexical_declaration");
+        const nestedName = declaration ? field(declaration, "name") : null;
+        if (nestedName)
+            return text(source, nestedName).normalize("NFC");
+        const value = text(source, node);
+        return value.startsWith("export default") ? "default" : null;
+    }
+    return null;
+}
+function ancestor(node, type) {
+    let current = node?.parent ?? undefined;
+    while (current) {
+        if (current.type === type)
+            return current;
+        current = current.parent ?? undefined;
+    }
+    return undefined;
+}
+function unquote(value) {
+    const trimmed = value.trim();
+    if (trimmed.length >= 2 && "'\"`".includes(trimmed[0]) && trimmed.at(-1) === trimmed[0]) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+export { text, frozenSpan, field, descendants, symbolName, ancestor, unquote };
+//# sourceMappingURL=native-node-helpers.js.map

package/dist/services/structural/native-node-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-node-helpers.js","sourceRoot":"","sources":["../../../src/services/structural/native-node-helpers.ts"],"names":[],"mappings":"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"}

package/dist/services/structural/parser-pool.d.ts

@@ -0,0 +1,34 @@
+import type { NativeParserInstance } from "./grammar-loaders.js";
+export declare const DEFAULT_STRUCTURAL_PARSER_CAPACITY = 4;
+export declare const MAX_STRUCTURAL_PARSER_CAPACITY = 32;
+export declare const DEFAULT_STRUCTURAL_ACQUIRE_TIMEOUT_MS = 5000;
+export declare const MAX_STRUCTURAL_ACQUIRE_TIMEOUT_MS = 60000;
+export interface ParserLease {
+    readonly key: string;
+    parse(source: Buffer): ReturnType<NativeParserInstance["parse"]>;
+    release(): void;
+}
+export interface ParserPoolOptions {
+    capacity?: number;
+    acquireTimeoutMs?: number;
+    createParser: () => NativeParserInstance;
+    scheduleTimeout?: (callback: () => void, timeoutMs: number) => unknown;
+    cancelTimeout?: (timer: unknown) => void;
+}
+export declare class ParserAcquireTimeoutError extends Error {
+    readonly key: string;
+    readonly timeoutMs: number;
+    readonly code = "PARSER_ACQUIRE_TIMEOUT";
+    constructor(key: string, timeoutMs: number);
+}
+/** Globally FIFO, bounded parser ownership with safe idle retargeting. */
+export declare class StructuralParserPool {
+    #private;
+    readonly capacity: number;
+    readonly acquireTimeoutMs: number;
+    constructor(options: ParserPoolOptions);
+    get size(): number;
+    get waiting(): number;
+    acquire(key: string, language: unknown): Promise<ParserLease>;
+}
+//# sourceMappingURL=parser-pool.d.ts.map

package/dist/services/structural/parser-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-pool.d.ts","sourceRoot":"","sources":["../../../src/services/structural/parser-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,eAAO,MAAM,kCAAkC,IAAI,CAAC;AACpD,eAAO,MAAM,8BAA8B,KAAK,CAAC;AACjD,eAAO,MAAM,qCAAqC,OAAQ,CAAC;AAC3D,eAAO,MAAM,iCAAiC,QAAS,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;IACjE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,oBAAoB,CAAC;IACzC,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACvE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1C;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAGtC,QAAQ,CAAC,GAAG,EAAE,MAAM;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM;IAF5D,QAAQ,CAAC,IAAI,4BAA4B;gBAEpB,GAAG,EAAE,MAAM,EAAW,SAAS,EAAE,MAAM;CAI7D;AAwBD,0EAA0E;AAC1E,qBAAa,oBAAoB;;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;gBAOtB,OAAO,EAAE,iBAAiB;IAgBtC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;CAiG9D"}

package/dist/services/structural/parser-pool.js

@@ -0,0 +1,148 @@
+export const DEFAULT_STRUCTURAL_PARSER_CAPACITY = 4;
+export const MAX_STRUCTURAL_PARSER_CAPACITY = 32;
+export const DEFAULT_STRUCTURAL_ACQUIRE_TIMEOUT_MS = 5_000;
+export const MAX_STRUCTURAL_ACQUIRE_TIMEOUT_MS = 60_000;
+export class ParserAcquireTimeoutError extends Error {
+    key;
+    timeoutMs;
+    code = "PARSER_ACQUIRE_TIMEOUT";
+    constructor(key, timeoutMs) {
+        super(`Timed out acquiring structural parser for ${key} after ${timeoutMs}ms`);
+        this.key = key;
+        this.timeoutMs = timeoutMs;
+        this.name = "ParserAcquireTimeoutError";
+    }
+}
+function positiveInteger(value, name, maximum) {
+    if (!Number.isInteger(value) || value < 1 || value > maximum) {
+        throw new RangeError(`${name} must be an integer between 1 and ${maximum}`);
+    }
+    return value;
+}
+/** Globally FIFO, bounded parser ownership with safe idle retargeting. */
+export class StructuralParserPool {
+    capacity;
+    acquireTimeoutMs;
+    #createParser;
+    #scheduleTimeout;
+    #cancelTimeout;
+    #slots = [];
+    #waiters = [];
+    constructor(options) {
+        this.capacity = positiveInteger(options.capacity ?? DEFAULT_STRUCTURAL_PARSER_CAPACITY, "parser capacity", MAX_STRUCTURAL_PARSER_CAPACITY);
+        this.acquireTimeoutMs = positiveInteger(options.acquireTimeoutMs ?? DEFAULT_STRUCTURAL_ACQUIRE_TIMEOUT_MS, "parser acquisition timeout", MAX_STRUCTURAL_ACQUIRE_TIMEOUT_MS);
+        this.#createParser = options.createParser;
+        this.#scheduleTimeout = options.scheduleTimeout ?? setTimeout;
+        this.#cancelTimeout = options.cancelTimeout ?? ((timer) => clearTimeout(timer));
+    }
+    get size() {
+        return this.#slots.length;
+    }
+    get waiting() {
+        return this.#waiters.length;
+    }
+    acquire(key, language) {
+        if (!key)
+            throw new Error("parser key must not be empty");
+        // Once contention exists, all newcomers join the same global FIFO queue.
+        if (this.#waiters.length === 0) {
+            try {
+                const slot = this.#claimSlot(key, language);
+                if (slot)
+                    return Promise.resolve(this.#lease(slot));
+            }
+            catch (error) {
+                return Promise.reject(error);
+            }
+        }
+        return new Promise((resolve, reject) => {
+            const waiter = {
+                key,
+                language,
+                resolve,
+                reject,
+                timer: undefined,
+            };
+            waiter.timer = this.#scheduleTimeout(() => {
+                const index = this.#waiters.indexOf(waiter);
+                if (index < 0)
+                    return;
+                this.#waiters.splice(index, 1);
+                reject(new ParserAcquireTimeoutError(key, this.acquireTimeoutMs));
+                this.#dispatch();
+            }, this.acquireTimeoutMs);
+            this.#waiters.push(waiter);
+            this.#dispatch();
+        });
+    }
+    #claimSlot(key, language) {
+        let slot = this.#slots.find((candidate) => !candidate.busy && candidate.key === key);
+        let requiresLanguage = false;
+        if (!slot && this.#slots.length < this.capacity) {
+            slot = { parser: this.#createParser(), key, language, busy: false };
+            this.#slots.push(slot);
+            requiresLanguage = true;
+        }
+        // Retarget an idle wrong-key slot when at capacity. Without this branch,
+        // skewed traffic can wait forever even though a parser is idle.
+        slot ??= this.#slots.find((candidate) => !candidate.busy);
+        if (!slot)
+            return undefined;
+        if (slot.key !== key || slot.language !== language) {
+            requiresLanguage = true;
+        }
+        try {
+            if (requiresLanguage)
+                slot.parser.setLanguage(language);
+        }
+        catch (error) {
+            // setLanguage may partially mutate a native parser before throwing.
+            // Never return that slot to the idle pool, whether new or retargeted.
+            this.#slots.splice(this.#slots.indexOf(slot), 1);
+            throw error;
+        }
+        slot.key = key;
+        slot.language = language;
+        slot.busy = true;
+        return slot;
+    }
+    #lease(slot) {
+        let released = false;
+        return Object.freeze({
+            key: slot.key,
+            parse(source) {
+                if (released)
+                    throw new Error("Parser lease has been released");
+                return slot.parser.parse(source.toString("utf8"));
+            },
+            release: () => {
+                if (released)
+                    return;
+                released = true;
+                slot.busy = false;
+                this.#dispatch();
+            },
+        });
+    }
+    #dispatch() {
+        while (this.#waiters.length > 0) {
+            const waiter = this.#waiters[0];
+            let slot;
+            try {
+                slot = this.#claimSlot(waiter.key, waiter.language);
+            }
+            catch (error) {
+                this.#waiters.shift();
+                this.#cancelTimeout(waiter.timer);
+                waiter.reject(error instanceof Error ? error : new Error(String(error)));
+                continue;
+            }
+            if (!slot)
+                return;
+            this.#waiters.shift();
+            this.#cancelTimeout(waiter.timer);
+            waiter.resolve(this.#lease(slot));
+        }
+    }
+}
+//# sourceMappingURL=parser-pool.js.map

package/dist/services/structural/parser-pool.js.map

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

package/dist/services/structural/parser-readiness.d.ts

@@ -0,0 +1,30 @@
+import { type LoadedNativeGrammarSet } from "./grammar-loaders.js";
+import type { GrammarArtifact } from "./types.js";
+export type ParserReadinessStatus = "pending" | "validating" | "ready" | "failed";
+export interface ParserReadinessDiagnostic {
+    code: string;
+    message: string;
+}
+export interface ParserReadinessSnapshot {
+    status: ParserReadinessStatus;
+    requiredExtensions: number;
+    validatedExtensions: number;
+    errors: readonly ParserReadinessDiagnostic[];
+    checkedAt?: string;
+}
+export declare class ParserReadinessError extends Error {
+    readonly readiness: ParserReadinessSnapshot;
+    readonly code = "PARSER_NOT_READY";
+    constructor(readiness: ParserReadinessSnapshot);
+}
+type GrammarLoader = (artifacts: readonly GrammarArtifact[]) => Promise<LoadedNativeGrammarSet>;
+/** Idempotently validate every required extension in one process-wide flight. */
+export declare function validateAllGrammars(): Promise<ParserReadinessSnapshot>;
+export declare function getParserReadiness(): ParserReadinessSnapshot;
+/** Return the startup-validated immutable grammar cache; never loads modules. */
+export declare function getValidatedNativeGrammarSet(): LoadedNativeGrammarSet;
+export declare function assertParserReadyForIndexing(): Promise<void>;
+/** Isolated-test seam; production code never calls this. */
+export declare function resetParserReadinessForTests(loader?: GrammarLoader): void;
+export {};
+//# sourceMappingURL=parser-readiness.d.ts.map

package/dist/services/structural/parser-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-readiness.d.ts","sourceRoot":"","sources":["../../../src/services/structural/parser-readiness.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,qBAAqB,GAC7B,SAAS,GACT,YAAY,GACZ,OAAO,GACP,QAAQ,CAAC;AAEb,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAGjC,QAAQ,CAAC,SAAS,EAAE,uBAAuB;IAFvD,QAAQ,CAAC,IAAI,sBAAsB;gBAEd,SAAS,EAAE,uBAAuB;CAKxD;AAyCD,KAAK,aAAa,GAAG,CACnB,SAAS,EAAE,SAAS,eAAe,EAAE,KAClC,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAyHrC,iFAAiF;AACjF,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAOtE;AAED,wBAAgB,kBAAkB,IAAI,uBAAuB,CAE5D;AAED,iFAAiF;AACjF,wBAAgB,4BAA4B,IAAI,sBAAsB,CAKrE;AAED,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,IAAI,CAAC,CAElE;AAED,4DAA4D;AAC5D,wBAAgB,4BAA4B,CAC1C,MAAM,GAAE,aAAoC,GAC3C,IAAI,CAWN"}