yuku-analyzer 0.5.38 → 0.5.41

package/README.md

@@ -66,6 +66,28 @@ module.resolve("name")   // scope-chain lookup, like the engine does at runtime
 
 Node identity is exact: the node you reach by walking `module.ast` and the node a semantic query returns are the same JavaScript object, so `===` always works.
 
+## Editing the AST
+
+That identity is the payoff. Because the `node` on a symbol or reference _is_ the AST node, a refactor is a plain assignment, and [`yuku-codegen`](https://www.npmjs.com/package/yuku-codegen) prints the mutated tree back to source. No visitor to register, no separate model to translate back.
+
+```js
+import { print } from "yuku-codegen";
+
+const m = analyzer.addFile("util.ts", `const tmp = load();\nexport const data = tmp.value + tmp.size;`);
+const tmp = m.rootScope.find("tmp");
+tmp.declarations[0] === m.ast.body[0].declarations[0].id; // true, literally the same node
+
+tmp.declarations[0].name = "raw"; // rename the binding
+for (const ref of tmp.references) ref.node.name = "raw"; // and every resolved use
+
+// across files, analyzer.referencesOf(symbol) hands back these same live nodes for every use
+print(m.ast).code;
+// const raw = load();
+// export const data = raw.value + raw.size;
+```
+
+The uses come from resolved references, not a name search, so a shadowing inner `tmp` is left untouched: the rename only reaches the identifiers that actually bind to this symbol.
+
 ## Walking with semantic context
 
 `module.walk` is a typed visitor walk where every handler also receives the current scope, symbol, and reference. No manual scope tracking, ever:

package/decode.js

@@ -670,19 +670,20 @@ function decode(buffer, source) {
     if (s === e) return "";
     if (s >= _srcLen) return _poolDecode(s, e);
     if (e <= _firstNa) return _src.slice(s, e);
-    const ss = s < _firstNa ? s : pm[s - _firstNa];
-    return _src.slice(ss, pm[e - _firstNa]);
+    return _src.slice(s < _firstNa ? s : pm[s - _firstNa], pm[e - _firstNa]);
   };
   function nodeArr(s, len) {
-    const r = Array.from({ length: len });
-    for (let j = 0; j < len; j++) r[j] = node(_u32[_extraBase + s + j]);
+    const r = [];
+    const base = _extraBase + s;
+    for (let j = 0; j < len; j++) r.push(node(_u32[base + j]));
     return r;
   }
   function nodeArrHoles(s, len) {
-    const r = Array.from({ length: len });
+    const r = [];
+    const base = _extraBase + s;
     for (let j = 0; j < len; j++) {
-      const x = _u32[_extraBase + s + j];
-      r[j] = x !== NULL ? node(x) : null;
+      const x = _u32[base + j];
+      r.push(x !== NULL ? node(x) : null);
     }
     return r;
   }
@@ -722,11 +723,11 @@ function decode(buffer, source) {
     return r;
   }
   function _decode(i) {
-    const o = _nodesOff + i * 48;
-    const tag = _u8[o];
-    const flags = _u8[o + 2] | (_u8[o + 3] << 8);
-    const f0 = _u8[o + 4] | (_u8[o + 5] << 8);
-    const b = o >> 2;
+    const b = (_nodesOff + i * 48) >> 2;
+    const h0 = _u32[b];
+    const tag = h0 & 255;
+    const flags = h0 >>> 16;
+    const f0 = _u32[b + 1] & 65535;
     const f1 = _u32[b + 2], f2 = _u32[b + 3],
           f3 = _u32[b + 4], f4 = _u32[b + 5],
           f5 = _u32[b + 6], f6 = _u32[b + 7],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuku-analyzer",
-  "version": "0.5.38",
+  "version": "0.5.41",
   "description": "Full JavaScript and TypeScript semantic analysis: scopes, symbols, resolved references, closures, and cross-file module linking, computed natively in Zig and queried as plain JavaScript objects",
   "license": "MIT",
   "repository": {
@@ -21,17 +21,17 @@
     "decode.js"
   ],
   "optionalDependencies": {
-    "@yuku-analyzer/binding-linux-x64-gnu": "0.5.38",
-    "@yuku-analyzer/binding-linux-arm64-gnu": "0.5.38",
-    "@yuku-analyzer/binding-linux-arm-gnu": "0.5.38",
-    "@yuku-analyzer/binding-linux-x64-musl": "0.5.38",
-    "@yuku-analyzer/binding-linux-arm64-musl": "0.5.38",
-    "@yuku-analyzer/binding-linux-arm-musl": "0.5.38",
-    "@yuku-analyzer/binding-darwin-x64": "0.5.38",
-    "@yuku-analyzer/binding-darwin-arm64": "0.5.38",
-    "@yuku-analyzer/binding-win32-x64": "0.5.38",
-    "@yuku-analyzer/binding-win32-arm64": "0.5.38",
-    "@yuku-analyzer/binding-freebsd-x64": "0.5.38"
+    "@yuku-analyzer/binding-linux-x64-gnu": "0.5.41",
+    "@yuku-analyzer/binding-linux-arm64-gnu": "0.5.41",
+    "@yuku-analyzer/binding-linux-arm-gnu": "0.5.41",
+    "@yuku-analyzer/binding-linux-x64-musl": "0.5.41",
+    "@yuku-analyzer/binding-linux-arm64-musl": "0.5.41",
+    "@yuku-analyzer/binding-linux-arm-musl": "0.5.41",
+    "@yuku-analyzer/binding-darwin-x64": "0.5.41",
+    "@yuku-analyzer/binding-darwin-arm64": "0.5.41",
+    "@yuku-analyzer/binding-win32-x64": "0.5.41",
+    "@yuku-analyzer/binding-win32-arm64": "0.5.41",
+    "@yuku-analyzer/binding-freebsd-x64": "0.5.41"
   },
   "keywords": [
     "analyzer",