@omgbase/core 0.27.0 → 0.27.1

package/dist/src/oqx-js/context.js

@@ -5,8 +5,8 @@
 // store's raw column objects, tagged with their target; `get` routes field /
 // intrinsic / relation resolution per target, lazily querying the store for
 // relations. Domain functions (text/semantic/under_*/…) are row-scoped, so they
-// arrive via `callMethod` on a synthetic `$self` receiver (see run.ts's AST
-// rewrite) rather than as free functions (which see no row).
+// arrive via `callMethod` on the row as receiver — run.ts's AST rewrite turns
+// them into `$it.fn(…)` — rather than as free functions (which see no row).
 //
 // This is the correctness tier: N+1 queries, materialized collections — fine for
 // the corpus and the differential baseline. The tier-3 SQLite planner (planner.ts)
@@ -612,13 +612,10 @@ export function makeStoreContext(store, repoId, opts = {}) {
             return row[key];
         }
         const r = row;
-        // `$self` = the current row: run.ts rewrites row-scoped domain functions
-        // (text/semantic/under_*/…) to `$self.fn(…)` so they arrive via callMethod
-        // with the row as receiver (a free function sees no row). Any other `$`
-        // name is OQX's (resolved by the engine before the row) or unknown — never
-        // an omgbase attribute.
-        if (key === "$self")
-            return r;
+        // A `$` name is OQX's (`$it`, `$key`, … — resolved by the engine before
+        // the row) or unknown — never an omgbase attribute. Row-scoped domain
+        // functions (text/semantic/under_*/…) never arrive here: run.ts rewrites
+        // them to `$it.fn(…)`, so they reach callMethod with the row as receiver.
         // engine attributes win on collision (the name rule above).
         if (ATTRIBUTES[t].has(key))
             return attribute(r, t, key);
@@ -670,7 +667,7 @@ export function makeStoreContext(store, repoId, opts = {}) {
             return jattr(r, key);
         return undefined;
     };
-    // ---- domain functions (row-scoped, via callMethod on $self) ---------------
+    // ---- domain functions (row-scoped, via callMethod on `$it`) ---------------
     const method = (name, recv, args) => {
         const r = recv;
         const t = r?.[TARGET];

package/dist/src/oqx-js/run.js

@@ -17,7 +17,8 @@ import { referencePath } from "../core/paths.js";
 import { canonicalJson } from "../mutate/canonical.js";
 // Row-scoped domain functions: authored as free calls (`text("x")`) that
 // implicitly reference the current row. `@omgbase/oqx` free functions receive no
-// row, so we rewrite them to `$self.fn(…)` (a method whose receiver is the row)
+// row, so we rewrite them to `$it.fn(…)` (a method whose receiver is the row —
+// `$it` is the language's own name for the scope's row, spec/oqx SEMANTICS §2)
 // — one `transform` over the AST (spec/oqx/AST.md §5), every block included.
 // `refs(x)` is NOT here: it reads no row (its argument is the value), so it stays
 // a free function served by the context's `callFunction`. The planner treats
@@ -118,7 +119,7 @@ export function foldDates(e) {
     return build.lit(dateMethod(e.name, e.recv.value, args).value);
 }
 function rewriteQuery(q) {
-    return transform(q, (e) => (e.kind === "call" && e.recv === null && ROW_FNS.has(e.name) ? { ...e, recv: build.ident("$self") } : foldDates(rootPathLiterals(e))));
+    return transform(q, (e) => (e.kind === "call" && e.recv === null && ROW_FNS.has(e.name) ? { ...e, recv: build.ident("$it") } : foldDates(rootPathLiterals(e))));
 }
 // A top-level `limit`/`offset` on the collect path is applied by the runner (see
 // oqxRunInner), so it must be a plain number literal here — there is no row to
@@ -232,7 +233,7 @@ const VALUE_KEY = "__oqx_value";
 // Rows as values (spec/surface §1.4, 1.2). The engine hands back store rows
 // wherever the projection made a row a VALUE — a nested `collect { }` /
 // `first { }` / `single { }` with an empty projection ("the row itself",
-// spec/oqx §12), a `values` projection of `$it`/`$self`, a field bound to a
+// spec/oqx §12), a `values` projection of `$it`, a field bound to a
 // row — and a store row is not a wire shape (column names, `attrs` as a JSON
 // string, the `__path` join column, Buffers). Walk the projected value and
 // render every tagged row as `{ id, path }` — the hit envelope's own keys

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omgbase/core",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "Open Markdown Graph Base — embedded engine",
   "license": "MIT",
   "repository": {