@opensip-cli/tree-sitter 0.1.7 → 0.1.8

package/README.md

@@ -23,8 +23,8 @@ This package is published for the CLI and advanced plugin authors; most users sh
 ## Documentation
 
 - 📚 Project docs: https://opensip.ai/docs/opensip-cli/
-- 🧭 Package catalog (what every package does): https://github.com/opensip-ai/opensip-cli/blob/v0.1.7/docs/public/70-reference/02-package-catalog.md
-- 📦 Source: https://github.com/opensip-ai/opensip-cli/tree/v0.1.7/packages/tree-sitter
+- 🧭 Package catalog (what every package does): https://github.com/opensip-ai/opensip-cli/blob/v0.1.8/docs/public/70-reference/02-package-catalog.md
+- 📦 Source: https://github.com/opensip-ai/opensip-cli/tree/v0.1.8/packages/tree-sitter
 
 ## License
 

package/dist/lifecycle.d.ts

@@ -15,7 +15,13 @@
  * adapter's own top-level `await loadGrammar(<wasm>)`.
  */
 import { Parser, Language, type Tree } from 'web-tree-sitter';
-/** Load a tree-sitter grammar from a `.wasm` path (adapter module top level). */
+/**
+ * Load a tree-sitter grammar from a `.wasm` path (adapter module top level).
+ *
+ * @throws {Error} When the web-tree-sitter runtime failed to initialize (the
+ *   contained `Parser.init()` above) — lang-* adapters catch this and degrade
+ *   that language to "unavailable" rather than crashing the CLI.
+ */
 export declare function loadGrammar(wasmPath: string): Promise<Language>;
 /**
  * Create a parser bound to `grammar`. Adapters create one per grammar at

package/dist/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAO9D,iFAAiF;AACjF,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAItD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEvE"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAmB9D;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAIrE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAItD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEvE"}

package/dist/lifecycle.js

@@ -18,9 +18,31 @@ import { Parser, Language } from 'web-tree-sitter';
 // One-time WASM runtime init. Top-level await — every consumer statically
 // imports this module — guarantees the runtime is ready before any adapter's
 // `loadGrammar(<wasm>)` (which also runs at module top level).
-await Parser.init();
-/** Load a tree-sitter grammar from a `.wasm` path (adapter module top level). */
+// Contained: if the WASM runtime fails to initialize (a broken/incompatible
+// web-tree-sitter build), this module still LOADS — `loadGrammar` then throws,
+// and each lang-* adapter degrades its language to "unavailable" rather than
+// crashing the whole CLI on import.
+let runtimeReady = false;
+/* v8 ignore start -- runtime-init failure is environment-dependent; not reproducible under the test runner */
+try {
+    await Parser.init();
+    runtimeReady = true;
+}
+catch {
+    /* @swallow-ok runtime init failed → loadGrammar throws → adapters degrade per-language */
+}
+/* v8 ignore stop */
+/**
+ * Load a tree-sitter grammar from a `.wasm` path (adapter module top level).
+ *
+ * @throws {Error} When the web-tree-sitter runtime failed to initialize (the
+ *   contained `Parser.init()` above) — lang-* adapters catch this and degrade
+ *   that language to "unavailable" rather than crashing the CLI.
+ */
 export async function loadGrammar(wasmPath) {
+    /* v8 ignore next -- only reachable when Parser.init() failed above */
+    if (!runtimeReady)
+        throw new Error('web-tree-sitter runtime is not initialized');
     return Language.load(wasmPath);
 }
 /**

package/dist/lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAa,MAAM,iBAAiB,CAAC;AAE9D,0EAA0E;AAC1E,6EAA6E;AAC7E,+DAA+D;AAC/D,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;AAEpB,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,OAAO,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,OAAiB;IAC5C,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,MAAc;IACxD,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAa,MAAM,iBAAiB,CAAC;AAE9D,0EAA0E;AAC1E,6EAA6E;AAC7E,+DAA+D;AAC/D,4EAA4E;AAC5E,+EAA+E;AAC/E,6EAA6E;AAC7E,oCAAoC;AACpC,IAAI,YAAY,GAAG,KAAK,CAAC;AACzB,8GAA8G;AAC9G,IAAI,CAAC;IACH,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACpB,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC;AAAC,MAAM,CAAC;IACP,0FAA0F;AAC5F,CAAC;AACD,oBAAoB;AAEpB;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,sEAAsE;IACtE,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACjF,OAAO,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,OAAiB;IAC5C,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,MAAc;IACxD,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opensip-cli/tree-sitter",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "license": "Apache-2.0",
   "description": "Grammar-agnostic tree-sitter substrate (parser lifecycle + node accessors) shared by lang-* and the graph adapters",
   "keywords": [