yuku-analyzer 0.5.35 → 0.5.36

package/README.md

@@ -62,6 +62,7 @@ And node-level queries that work directly on AST nodes:
 module.symbolOf(node)    // the symbol a node declares or references
 module.referenceOf(node) // the reference recorded for an identifier
 module.scopeOf(node)     // the innermost scope containing the node
+module.parentOf(node)    // the node that structurally contains it, or null
 module.resolve("name")   // scope-chain lookup, like the engine does at runtime
 ```
 

package/decode.js

@@ -1331,6 +1331,35 @@ function decode(buffer, source) {
       }
     })(progIdx);
   }
+  let _parentArr;
+  function _parents() {
+    if (_parentArr !== undefined) return _parentArr;
+    const p = new Int32Array(nodeCount).fill(-1);
+    (function visit(i, parent) {
+      const o = _nodesOff + i * 48;
+      const tag = _u8[o];
+      if (TAG_TYPES[tag] !== null) { p[i] = parent; parent = i; }
+      const ops = SCAN_CHILDREN[tag];
+      const b = o >> 2;
+      for (let q = 0; q < ops.length; q += 2) {
+        const slot = ops[q + 1];
+        if (ops[q] === 0) {
+          const c = _u32[b + slot];
+          if (c !== NULL) visit(c, parent);
+        } else {
+          const s = _u32[b + slot];
+          const len = ops[q] === 1
+            ? _u32[b + slot + 1]
+            : _u8[o + 4] | (_u8[o + 5] << 8);
+          for (let j = 0; j < len; j++) {
+            const c = _u32[_extraBase + s + j];
+            if (c !== NULL) visit(c, parent);
+          }
+        }
+      }
+    })(progIdx, -1);
+    return (_parentArr = p);
+  }
   let _semView;
   function _semantic() {
     if (_semView !== undefined) return _semView;
@@ -1459,6 +1488,7 @@ function decode(buffer, source) {
     scan,
     nodeOf: node,
     indexOf: (n) => _nodeIndexes.get(n),
+    parentIndex: (i) => _parents()[i],
     startOf, endOf, str,
     get semantic() { return _semantic(); },
   };

package/index.d.ts

@@ -412,6 +412,12 @@ interface Module {
   referenceOf(node: Node): Reference | null;
   /** The innermost scope whose extent contains `node`. */
   scopeOf(node: Node): Scope;
+  /**
+   * The node that structurally contains `node`. Null at the program
+   * root and for a node not part of this module's AST. Lets you walk
+   * upward from a node you already hold, with no ancestor stack.
+   */
+  parentOf(node: Node): Node | null;
   /**
    * Walks the scope chain from `from` (default: the root scope) to
    * find the nearest binding of `name`.

package/module.js

@@ -356,6 +356,15 @@ export class Module {
     return this.scopes[this.#sem.nodeScope(index)];
   }
 
+  // the node that structurally contains `node`, or null at the program
+  // root or for a node not part of this module's AST.
+  parentOf(node) {
+    const index = this.#r.indexOf(node);
+    if (index === undefined) return null;
+    const parent = this.#r.parentIndex(index);
+    return parent < 0 ? null : this.#r.nodeOf(parent);
+  }
+
   resolve(name, from = this.rootScope) {
     for (let s = from; s; s = s.parent) {
       const found = s.find(name);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuku-analyzer",
-  "version": "0.5.35",
+  "version": "0.5.36",
   "description": "High-performance JavaScript/TypeScript semantic analyzer: per-file scopes, symbols, references, and cross-file module linking",
   "license": "MIT",
   "repository": {
@@ -21,17 +21,17 @@
     "decode.js"
   ],
   "optionalDependencies": {
-    "@yuku-analyzer/binding-linux-x64-gnu": "0.5.35",
-    "@yuku-analyzer/binding-linux-arm64-gnu": "0.5.35",
-    "@yuku-analyzer/binding-linux-arm-gnu": "0.5.35",
-    "@yuku-analyzer/binding-linux-x64-musl": "0.5.35",
-    "@yuku-analyzer/binding-linux-arm64-musl": "0.5.35",
-    "@yuku-analyzer/binding-linux-arm-musl": "0.5.35",
-    "@yuku-analyzer/binding-darwin-x64": "0.5.35",
-    "@yuku-analyzer/binding-darwin-arm64": "0.5.35",
-    "@yuku-analyzer/binding-win32-x64": "0.5.35",
-    "@yuku-analyzer/binding-win32-arm64": "0.5.35",
-    "@yuku-analyzer/binding-freebsd-x64": "0.5.35"
+    "@yuku-analyzer/binding-linux-x64-gnu": "0.5.36",
+    "@yuku-analyzer/binding-linux-arm64-gnu": "0.5.36",
+    "@yuku-analyzer/binding-linux-arm-gnu": "0.5.36",
+    "@yuku-analyzer/binding-linux-x64-musl": "0.5.36",
+    "@yuku-analyzer/binding-linux-arm64-musl": "0.5.36",
+    "@yuku-analyzer/binding-linux-arm-musl": "0.5.36",
+    "@yuku-analyzer/binding-darwin-x64": "0.5.36",
+    "@yuku-analyzer/binding-darwin-arm64": "0.5.36",
+    "@yuku-analyzer/binding-win32-x64": "0.5.36",
+    "@yuku-analyzer/binding-win32-arm64": "0.5.36",
+    "@yuku-analyzer/binding-freebsd-x64": "0.5.36"
   },
   "keywords": [
     "analyzer",