@milaboratories/pl-model-common 1.13.7 → 1.14.0

package/dist/index.mjs

@@ -1,28 +1,28 @@
-var I = Object.defineProperty;
-var $ = (n, t, e) => t in n ? I(n, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : n[t] = e;
-var m = (n, t, e) => $(n, typeof t != "symbol" ? t + "" : t, e);
+var $ = Object.defineProperty;
+var I = (n, e, t) => e in n ? $(n, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : n[e] = t;
+var l = (n, e, t) => I(n, typeof e != "symbol" ? e + "" : e, t);
 import h from "canonicalize";
-import { z as y } from "zod";
+import { z as p } from "zod";
 function dn(n) {
   return n !== void 0 && n.startsWith("log+live://log/");
 }
 function w(n) {
   throw new Error("Unexpected object: " + n);
 }
-const S = "upload://upload/", E = "index://index/";
+const E = "upload://upload/", S = "index://index/";
 function D(n) {
-  return n.startsWith(S);
+  return n.startsWith(E);
 }
 function L(n) {
-  return n.startsWith(E);
+  return n.startsWith(S);
 }
 function V(n) {
   if (L(n)) {
-    const t = n.slice(E.length);
-    return JSON.parse(decodeURIComponent(t)).path;
+    const e = n.slice(S.length);
+    return JSON.parse(decodeURIComponent(e)).path;
   } else if (D(n)) {
-    const t = n.slice(S.length);
-    return JSON.parse(decodeURIComponent(t)).localPath;
+    const e = n.slice(E.length);
+    return JSON.parse(decodeURIComponent(e)).localPath;
   }
   w(n);
 }
@@ -35,44 +35,44 @@ function pn(n) {
 function mn(n) {
   if (!n || typeof n != "object")
     return !1;
-  const t = n;
-  if (!("type" in t))
+  const e = n;
+  if (!("type" in e))
     return !1;
-  switch (t.type) {
+  switch (e.type) {
     case "Json":
-      return typeof t.keyLength == "number" && t.data !== void 0 && typeof t.data == "object";
+      return typeof e.keyLength == "number" && e.data !== void 0 && typeof e.data == "object";
     case "JsonPartitioned":
-      return typeof t.partitionKeyLength == "number" && t.parts !== void 0 && typeof t.parts == "object";
+      return typeof e.partitionKeyLength == "number" && e.parts !== void 0 && typeof e.parts == "object";
     case "BinaryPartitioned":
-      return typeof t.partitionKeyLength == "number" && t.parts !== void 0 && typeof t.parts == "object";
+      return typeof e.partitionKeyLength == "number" && e.parts !== void 0 && typeof e.parts == "object";
     default:
       return !1;
   }
 }
-function yn(n, t) {
+function ln(n, e) {
   if (n !== void 0)
     switch (n.type) {
       case "Json":
         return n;
       case "JsonPartitioned": {
-        const e = {};
+        const t = {};
         for (const [r, o] of Object.entries(n.parts))
-          e[r] = t(o);
+          t[r] = e(o);
         return {
           ...n,
-          parts: e
+          parts: t
         };
       }
       case "BinaryPartitioned": {
-        const e = {};
+        const t = {};
         for (const [r, o] of Object.entries(n.parts))
-          e[r] = {
-            index: t(o.index),
-            values: t(o.values)
+          t[r] = {
+            index: e(o.index),
+            values: e(o.values)
           };
         return {
           ...n,
-          parts: e
+          parts: t
         };
       }
     }
@@ -80,47 +80,47 @@ function yn(n, t) {
 function j(n) {
   if (!n || typeof n != "object")
     return !1;
-  const t = n;
-  if (!("type" in t))
+  const e = n;
+  if (!("type" in e))
     return !1;
-  switch (t.type) {
+  switch (e.type) {
     case "Json":
-      return typeof t.keyLength == "number" && Array.isArray(t.data);
+      return typeof e.keyLength == "number" && Array.isArray(e.data);
     case "JsonPartitioned":
-      return typeof t.partitionKeyLength == "number" && Array.isArray(t.parts);
+      return typeof e.partitionKeyLength == "number" && Array.isArray(e.parts);
     case "BinaryPartitioned":
-      return typeof t.partitionKeyLength == "number" && Array.isArray(t.parts);
+      return typeof e.partitionKeyLength == "number" && Array.isArray(e.parts);
     default:
       return !1;
   }
 }
-function ln(n) {
+function yn(n) {
   return j(n) ? n.type === "JsonPartitioned" || n.type === "BinaryPartitioned" : !1;
 }
 function hn(n) {
   switch (n.type) {
     case "Json": {
-      const t = Object.entries(n.data).map(([e, r]) => ({ key: JSON.parse(e), value: r }));
+      const e = Object.entries(n.data).map(([t, r]) => ({ key: JSON.parse(t), value: r }));
       return {
         type: "Json",
         keyLength: n.keyLength,
-        data: t
+        data: e
       };
     }
     case "JsonPartitioned": {
-      const t = Object.entries(n.parts).map(([e, r]) => ({ key: JSON.parse(e), value: r }));
+      const e = Object.entries(n.parts).map(([t, r]) => ({ key: JSON.parse(t), value: r }));
       return {
         type: "JsonPartitioned",
         partitionKeyLength: n.partitionKeyLength,
-        parts: t
+        parts: e
       };
     }
     case "BinaryPartitioned": {
-      const t = Object.entries(n.parts).map(([e, r]) => ({ key: JSON.parse(e), value: r }));
+      const e = Object.entries(n.parts).map(([t, r]) => ({ key: JSON.parse(t), value: r }));
       return {
         type: "BinaryPartitioned",
         partitionKeyLength: n.partitionKeyLength,
-        parts: t
+        parts: e
       };
     }
   }
@@ -128,70 +128,70 @@ function hn(n) {
 function gn(n) {
   switch (n.type) {
     case "Json": {
-      const t = {};
-      for (const e of n.data)
-        t[JSON.stringify(e.key)] = e.value;
+      const e = {};
+      for (const t of n.data)
+        e[JSON.stringify(t.key)] = t.value;
       return {
         type: "Json",
         keyLength: n.keyLength,
-        data: t
+        data: e
       };
     }
     case "JsonPartitioned": {
-      const t = {};
-      for (const e of n.parts)
-        t[JSON.stringify(e.key)] = e.value;
+      const e = {};
+      for (const t of n.parts)
+        e[JSON.stringify(t.key)] = t.value;
       return {
         type: "JsonPartitioned",
         partitionKeyLength: n.partitionKeyLength,
-        parts: t
+        parts: e
       };
     }
     case "BinaryPartitioned": {
-      const t = {};
-      for (const e of n.parts)
-        t[JSON.stringify(e.key)] = e.value;
+      const e = {};
+      for (const t of n.parts)
+        e[JSON.stringify(t.key)] = t.value;
       return {
         type: "BinaryPartitioned",
         partitionKeyLength: n.partitionKeyLength,
-        parts: t
+        parts: e
       };
     }
   }
 }
-function bn(n, t) {
+function bn(n, e) {
   if (n !== void 0)
     switch (n.type) {
       case "Json":
         return n;
       case "JsonPartitioned": {
-        const e = n.parts.map((r) => ({
+        const t = n.parts.map((r) => ({
           key: r.key,
-          value: t(r.value)
+          value: e(r.value)
         }));
         return {
           ...n,
-          parts: e
+          parts: t
         };
       }
       case "BinaryPartitioned": {
-        const e = n.parts.map((r) => ({
+        const t = n.parts.map((r) => ({
           key: r.key,
           value: {
-            index: t(r.value.index),
-            values: t(r.value.values)
+            index: e(r.value.index),
+            values: e(r.value.values)
           }
         }));
         return {
           ...n,
-          parts: e
+          parts: t
         };
       }
     }
 }
 const F = -2147483648, P = -9007199254740991n, wn = NaN, Pn = NaN, U = null, K = null;
-function g(n, t) {
-  switch (t) {
+function g(n, e) {
+  switch (e) {
     case "Int":
       return n === F;
     case "Long":
@@ -205,18 +205,18 @@ function g(n, t) {
     case "Bytes":
       return n === K;
     default:
-      throw Error(`unsupported data type: ${t}`);
+      throw Error(`unsupported data type: ${e}`);
   }
 }
 function xn(n) {
   if (!R(n)) throw new Error(`Expected not-NA PValue, got ${n}`);
   return n;
 }
-function R(n, t) {
-  if (!t)
+function R(n, e) {
+  if (!e)
     return typeof n == "string" || typeof n == "number" && isFinite(n) || typeof n == "bigint";
-  if (g(n, t)) return !1;
-  switch (t) {
+  if (g(n, e)) return !1;
+  switch (e) {
     case "Int":
       return typeof n == "number";
     case "Long":
@@ -230,14 +230,14 @@ function R(n, t) {
     case "Bytes":
       throw Error("Bytes not yet supported");
     default:
-      throw Error(`unsupported data type: ${t}`);
+      throw Error(`unsupported data type: ${e}`);
   }
 }
-function M(n, t) {
-  if (!t)
+function _(n, e) {
+  if (!e)
     return n === null || typeof n == "string" || typeof n == "number" || typeof n == "bigint";
-  if (g(n, t)) return !0;
-  switch (t) {
+  if (g(n, e)) return !0;
+  switch (e) {
     case "Int":
       return typeof n == "number";
     case "Long":
@@ -251,7 +251,7 @@ function M(n, t) {
     case "Bytes":
       throw Error("Bytes not yet supported");
     default:
-      throw Error(`unsupported data type: ${t}`);
+      throw Error(`unsupported data type: ${e}`);
   }
 }
 function An(n) {
@@ -259,25 +259,25 @@ function An(n) {
   if (typeof n == "bigint") return { bigint: n.toString() };
   throw new Error(`Type ${typeof n} (value ${n}) not yet supported.`);
 }
-function T(n, t) {
+function M(n, e) {
   if (n === null || typeof n == "string" || typeof n == "number" || typeof n == "bigint") {
-    if (t && !g(n, t) && !M(n, t))
-      throw new Error(`Unexpected value type, got ${typeof n}, expected ${t}`);
+    if (e && !g(n, e) && !_(n, e))
+      throw new Error(`Unexpected value type, got ${typeof n}, expected ${e}`);
     return n;
   }
   if (typeof n == "object" && n !== null && "bigint" in n && typeof n.bigint == "string") {
-    if (t && t !== "Long")
-      throw new Error(`Unexpected value type, got serialized bigint, expected ${t}`);
+    if (e && e !== "Long")
+      throw new Error(`Unexpected value type, got serialized bigint, expected ${e}`);
     return BigInt(n.bigint);
   }
   throw new Error(`Unsupported type ${typeof n} (value ${n}).`);
 }
 function kn(n) {
-  if (n = v(n), n === null) throw new Error("Value is null");
+  if (n = T(n), n === null) throw new Error("Value is null");
   return n;
 }
-function v(n) {
-  if (n = T(n), n === null) return null;
+function T(n) {
+  if (n = M(n), n === null) return null;
   if (typeof n == "string") return n;
   if (typeof n == "number") {
     if (!isFinite(n)) throw new Error(`Value is not finite (${n})`);
@@ -287,19 +287,19 @@ function v(n) {
     return Number(n);
   throw new Error(`Unexpected value type: ${typeof n}`);
 }
-function _(n, t) {
-  const e = Math.floor(t / 8), r = 1 << 7 - t % 8;
-  return (n[e] & r) > 0;
+function v(n, e) {
+  const t = Math.floor(e / 8), r = 1 << 7 - e % 8;
+  return (n[t] & r) > 0;
 }
-const H = { type: "absent" }, W = null;
+const H = { type: "absent" }, q = null;
 function Nn(n) {
   return typeof n == "object" && n !== null && n.type === "absent";
 }
-function Sn(n, t, e = {}) {
-  if (_(n.absent, t))
-    return e.absent === void 0 ? H : e.absent;
-  const r = n.data[t], o = n.type;
-  if (g(r, o)) return e.na === void 0 ? W : e.na;
+function En(n, e, t = {}) {
+  if (v(n.absent, e))
+    return t.absent === void 0 ? H : t.absent;
+  const r = n.data[e], o = n.type;
+  if (g(r, o)) return t.na === void 0 ? q : t.na;
   switch (o) {
     case "Int":
       return r;
@@ -317,14 +317,14 @@ function Sn(n, t, e = {}) {
       throw Error(`unsupported data type: ${o}`);
   }
 }
-function En(n) {
+function Sn(n) {
   return {
     kind: n.kind,
     valueType: n.valueType,
     name: n.name,
     domain: n.domain,
     parentAxes: n.parentAxes,
-    axesId: z(n.axesSpec)
+    axesId: W(n.axesSpec)
   };
 }
 function Cn(n) {
@@ -333,40 +333,40 @@ function Cn(n) {
     spec: n.spec
   };
 }
-function p(n) {
-  const { type: t, name: e, domain: r } = n;
-  return { type: t, name: e, ...r && { domain: r } };
+function m(n) {
+  const { type: e, name: t, domain: r } = n;
+  return { type: e, name: t, ...r && { domain: r } };
 }
-function z(n) {
-  return n.map(p);
+function W(n) {
+  return n.map(m);
 }
 function Jn(n) {
-  return h(p(n));
+  return h(m(n));
 }
-function X(n, t) {
-  if (n === void 0) return t === void 0;
-  if (t === void 0) return !0;
-  for (const e in t)
-    if (n[e] !== t[e]) return !1;
+function z(n, e) {
+  if (n === void 0) return e === void 0;
+  if (e === void 0) return !0;
+  for (const t in e)
+    if (n[t] !== e[t]) return !1;
   return !0;
 }
-function G(n, t) {
-  return n.name === t.name && X(n.domain, t.domain);
+function X(n, e) {
+  return n.name === e.name && z(n.domain, e.domain);
 }
-function On(n, t) {
-  return { ...n, src: l(n.src, t) };
+function On(n, e) {
+  return { ...n, src: y(n.src, e) };
 }
-function l(n, t) {
+function y(n, e) {
   switch (n.type) {
     case "column":
       return {
         type: "column",
-        column: t(n.column)
+        column: e(n.column)
       };
     case "slicedColumn":
       return {
         type: "slicedColumn",
-        column: t(n.column),
+        column: e(n.column),
         newId: n.newId,
         axisFilters: n.axisFilters
       };
@@ -374,51 +374,51 @@ function l(n, t) {
     case "full":
       return {
         type: n.type,
-        entries: n.entries.map((e) => l(e, t))
+        entries: n.entries.map((t) => y(t, e))
       };
     case "outer":
       return {
         type: "outer",
-        primary: l(n.primary, t),
-        secondary: n.secondary.map((e) => l(e, t))
+        primary: y(n.primary, e),
+        secondary: n.secondary.map((t) => y(t, e))
       };
     default:
       w(n);
   }
 }
-function Q(n) {
+function G(n) {
   return h(n);
 }
-function In(n) {
+function $n(n) {
   return JSON.parse(n);
 }
 function x(n) {
-  return h(p(n));
+  return h(m(n));
 }
-function A(n, t) {
-  return JSON.stringify([n, t]);
+function A(n, e) {
+  return JSON.stringify([n, e]);
 }
-class $n {
+class In {
   /**
    * Creates a new anchor context from a set of anchor column specifications
    * @param anchors Record of anchor column specifications indexed by anchor ID
    */
-  constructor(t) {
-    m(this, "domains", /* @__PURE__ */ new Map());
-    m(this, "axes", /* @__PURE__ */ new Map());
+  constructor(e) {
+    l(this, "domains", /* @__PURE__ */ new Map());
+    l(this, "axes", /* @__PURE__ */ new Map());
     /**
      * Domain packs are used to group domain keys that can be anchored to the same anchor
      * This is used to optimize the lookup of domain anchors
      */
-    m(this, "domainPacks", []);
+    l(this, "domainPacks", []);
     /**
      * Maps domain packs to anchors
      */
-    m(this, "domainPackToAnchor", /* @__PURE__ */ new Map());
-    this.anchors = t;
-    const e = Object.entries(t);
-    e.sort((r, o) => r[0].localeCompare(o[0]));
-    for (const [r, o] of e) {
+    l(this, "domainPackToAnchor", /* @__PURE__ */ new Map());
+    this.anchors = e;
+    const t = Object.entries(e);
+    t.sort((r, o) => r[0].localeCompare(o[0]));
+    for (const [r, o] of t) {
       for (let s = 0; s < o.axesSpec.length; s++) {
         const a = o.axesSpec[s], i = x(a);
         this.axes.set(i, { anchor: r, idx: s });
@@ -436,18 +436,18 @@ class $n {
   /**
    * Implementation of derive method
    */
-  derive(t, e) {
+  derive(e, t) {
     const r = {
-      name: t.name,
+      name: e.name,
       axes: []
     };
     let o;
-    if (t.domain !== void 0)
+    if (e.domain !== void 0)
       n:
         for (const a of this.domainPacks) {
           const i = [];
           for (const c of a) {
-            const d = t.domain[c];
+            const d = e.domain[c];
             if (d !== void 0)
               i.push([c, d]);
             else
@@ -459,26 +459,26 @@ class $n {
             break;
           }
         }
-    for (const [a, i] of Object.entries(t.domain ?? {})) {
+    for (const [a, i] of Object.entries(e.domain ?? {})) {
       if (o !== void 0 && o.has(a))
         continue;
       const u = A(a, i), c = this.domains.get(u);
       r.domain ?? (r.domain = {}), r.domain[a] = c ? { anchor: c } : i;
     }
-    if (r.axes = t.axesSpec.map((a) => {
+    if (r.axes = e.axesSpec.map((a) => {
       const i = x(a), u = this.axes.get(i);
-      return u === void 0 ? p(a) : u;
-    }), !e || e.length === 0)
+      return u === void 0 ? m(a) : u;
+    }), !t || t.length === 0)
       return r;
     const s = [];
-    for (const a of e) {
+    for (const a of t) {
       const [i, u] = a;
       if (typeof i == "number") {
-        if (i < 0 || i >= t.axesSpec.length)
-          throw new Error(`Axis index ${i} is out of bounds (0-${t.axesSpec.length - 1})`);
+        if (i < 0 || i >= e.axesSpec.length)
+          throw new Error(`Axis index ${i} is out of bounds (0-${e.axesSpec.length - 1})`);
         s.push([i, u]);
       } else {
-        const c = t.axesSpec.findIndex((d) => d.name === i);
+        const c = e.axesSpec.findIndex((d) => d.name === i);
         if (c === -1)
           throw new Error(`Axis with name "${i}" not found in the column specification`);
         s.push([c, u]);
@@ -495,12 +495,12 @@ class $n {
    * @param axisFilters Optional axis filters to apply to the column
    * @returns A canonicalized string representation of the anchored column identifier
    */
-  deriveS(t, e) {
-    return Q(this.derive(t, e));
+  deriveS(e, t) {
+    return G(this.derive(e, t));
   }
 }
-function Dn(n, t, e) {
-  const r = { ...t }, o = (e == null ? void 0 : e.ignoreMissingDomains) ?? !1;
+function Dn(n, e, t) {
+  const r = { ...e }, o = (t == null ? void 0 : t.ignoreMissingDomains) ?? !1;
   if (r.domainAnchor !== void 0) {
     const s = n[r.domainAnchor];
     if (!s)
@@ -526,36 +526,36 @@ function Dn(n, t, e) {
       }
     r.domain = s;
   }
-  return r.axes && (r.axes = r.axes.map((s) => Y(n, s))), r;
+  return r.axes && (r.axes = r.axes.map((s) => Q(n, s))), r;
 }
-function Y(n, t) {
-  if (!Z(t))
-    return t;
-  const e = t.anchor, r = n[e];
+function Q(n, e) {
+  if (!Y(e))
+    return e;
+  const t = e.anchor, r = n[t];
   if (!r)
-    throw new Error(`Anchor "${e}" not found for axis reference`);
-  if ("idx" in t) {
-    if (t.idx < 0 || t.idx >= r.axesSpec.length)
-      throw new Error(`Axis index ${t.idx} out of bounds for anchor "${e}"`);
-    return r.axesSpec[t.idx];
-  } else if ("name" in t) {
-    const o = r.axesSpec.filter((s) => s.name === t.name);
+    throw new Error(`Anchor "${t}" not found for axis reference`);
+  if ("idx" in e) {
+    if (e.idx < 0 || e.idx >= r.axesSpec.length)
+      throw new Error(`Axis index ${e.idx} out of bounds for anchor "${t}"`);
+    return r.axesSpec[e.idx];
+  } else if ("name" in e) {
+    const o = r.axesSpec.filter((s) => s.name === e.name);
     if (o.length > 1)
-      throw new Error(`Multiple axes with name "${t.name}" found in anchor "${e}"`);
+      throw new Error(`Multiple axes with name "${e.name}" found in anchor "${t}"`);
     if (o.length === 0)
-      throw new Error(`Axis with name "${t.name}" not found in anchor "${e}"`);
+      throw new Error(`Axis with name "${e.name}" not found in anchor "${t}"`);
     return o[0];
-  } else if ("id" in t) {
-    const o = r.axesSpec.filter((s) => G(t.id, p(s)));
+  } else if ("id" in e) {
+    const o = r.axesSpec.filter((s) => X(e.id, m(s)));
     if (o.length > 1)
-      throw new Error(`Multiple matching axes found for matcher in anchor "${e}"`);
+      throw new Error(`Multiple matching axes found for matcher in anchor "${t}"`);
     if (o.length === 0)
-      throw new Error(`No matching axis found for matcher in anchor "${e}"`);
+      throw new Error(`No matching axis found for matcher in anchor "${t}"`);
     return o[0];
   }
   throw new Error("Unsupported axis reference type");
 }
-function Z(n) {
+function Y(n) {
   return typeof n == "object" && "anchor" in n;
 }
 function Ln(n) {
@@ -564,7 +564,7 @@ function Ln(n) {
 function f(n) {
   return n.kind === "PColumn";
 }
-function q(n) {
+function Z(n) {
   return f(n.spec);
 }
 function Vn(n) {
@@ -574,65 +574,65 @@ function Bn(n) {
   return f(n.obj.spec);
 }
 function jn(n) {
-  if (!q(n)) throw new Error(`not a PColumn (kind = ${n.spec.kind})`);
+  if (!Z(n)) throw new Error(`not a PColumn (kind = ${n.spec.kind})`);
   return n;
 }
-function Fn(n, t) {
+function Fn(n, e) {
   return n === void 0 ? void 0 : {
     ...n,
-    data: t(n.data)
+    data: e(n.data)
   };
 }
 function Un(n) {
-  const t = /* @__PURE__ */ new Map(), e = (r) => {
+  const e = /* @__PURE__ */ new Map(), t = (r) => {
     switch (r.type) {
       case "column":
-        t.set(r.column.id, r.column);
+        e.set(r.column.id, r.column);
         return;
       case "slicedColumn":
-        t.set(r.column.id, r.column);
+        e.set(r.column.id, r.column);
         return;
       case "full":
       case "inner":
-        for (const o of r.entries) e(o);
+        for (const o of r.entries) t(o);
         return;
       case "outer":
-        e(r.primary);
-        for (const o of r.secondary) e(o);
+        t(r.primary);
+        for (const o of r.secondary) t(o);
         return;
       default:
         w(r);
     }
   };
-  return e(n), [...t.values()];
+  return t(n), [...e.values()];
 }
 function nn(n) {
   throw new Error("Unexpected object: " + n);
 }
-function b(n, t) {
+function b(n, e) {
   switch (n.type) {
     case "and":
-      for (const e of n.operands)
-        if (!b(e, t)) return !1;
+      for (const t of n.operands)
+        if (!b(t, e)) return !1;
       return !0;
     case "or":
-      for (const e of n.operands)
-        if (b(e, t)) return !0;
+      for (const t of n.operands)
+        if (b(t, e)) return !0;
       return !1;
     case "not":
-      return !b(n.operand, t);
+      return !b(n.operand, e);
     case "name":
-      return f(t) && t.name === n.name;
+      return f(e) && e.name === n.name;
     case "name_pattern":
-      return f(t) && !!t.name.match(n.pattern);
+      return f(e) && !!e.name.match(n.pattern);
     case "annotation":
-      return f(t) && t.annotations !== void 0 && t.annotations[n.annotation] === n.value;
+      return f(e) && e.annotations !== void 0 && e.annotations[n.annotation] === n.value;
     case "annotation_pattern":
-      return f(t) && t.annotations !== void 0 && t.annotations[n.annotation] !== void 0 && !!t.annotations[n.annotation].match(n.pattern);
+      return f(e) && e.annotations !== void 0 && e.annotations[n.annotation] !== void 0 && !!e.annotations[n.annotation].match(n.pattern);
     case "has_axes":
-      return f(t) && n.axes.every(
-        (e) => t.axesSpec.some(
-          (r) => (e.type === void 0 || e.type === r.type) && (e.name === void 0 || e.name === r.name) && (e.domain === void 0 || Object.keys(e.domain).length === 0 || r.domain !== void 0 && Object.entries(e.domain).every(
+      return f(e) && n.axes.every(
+        (t) => e.axesSpec.some(
+          (r) => (t.type === void 0 || t.type === r.type) && (t.name === void 0 || t.name === r.name) && (t.domain === void 0 || Object.keys(t.domain).length === 0 || r.domain !== void 0 && Object.entries(t.domain).every(
             ([o, s]) => r.domain[o] === s
           ))
         )
@@ -641,64 +641,64 @@ function b(n, t) {
       nn(n);
   }
 }
-function k(n, t) {
-  if (n.name !== void 0 && n.name !== t.name)
+function k(n, e) {
+  if (n.name !== void 0 && n.name !== e.name)
     return !1;
   if (n.type !== void 0) {
     if (Array.isArray(n.type)) {
-      if (!n.type.includes(t.type))
+      if (!n.type.includes(e.type))
         return !1;
-    } else if (n.type !== t.type)
+    } else if (n.type !== e.type)
       return !1;
   }
   if (n.domain !== void 0) {
-    const e = t.domain || {};
+    const t = e.domain || {};
     for (const [r, o] of Object.entries(n.domain))
-      if (e[r] !== o)
+      if (t[r] !== o)
         return !1;
   }
   return !0;
 }
-function N(n, t) {
-  if (t.name !== void 0 && n.name !== t.name || t.namePattern !== void 0 && !new RegExp(t.namePattern).test(n.name))
+function N(n, e) {
+  if (e.name !== void 0 && n.name !== e.name || e.namePattern !== void 0 && !new RegExp(e.namePattern).test(n.name))
     return !1;
-  if (t.type !== void 0) {
-    if (Array.isArray(t.type)) {
-      if (!t.type.includes(n.valueType))
+  if (e.type !== void 0) {
+    if (Array.isArray(e.type)) {
+      if (!e.type.includes(n.valueType))
         return !1;
-    } else if (t.type !== n.valueType)
+    } else if (e.type !== n.valueType)
       return !1;
   }
-  if (t.domain !== void 0) {
-    const e = n.domain || {};
-    for (const [r, o] of Object.entries(t.domain))
-      if (e[r] !== o)
+  if (e.domain !== void 0) {
+    const t = n.domain || {};
+    for (const [r, o] of Object.entries(e.domain))
+      if (t[r] !== o)
         return !1;
   }
-  if (t.axes !== void 0) {
-    const e = n.axesSpec.map(p);
-    if (t.partialAxesMatch) {
-      for (const r of t.axes)
-        if (!e.some((o) => k(r, o)))
+  if (e.axes !== void 0) {
+    const t = n.axesSpec.map(m);
+    if (e.partialAxesMatch) {
+      for (const r of e.axes)
+        if (!t.some((o) => k(r, o)))
           return !1;
     } else {
-      if (e.length !== t.axes.length)
+      if (t.length !== e.axes.length)
         return !1;
-      for (let r = 0; r < t.axes.length; r++)
-        if (!k(t.axes[r], e[r]))
+      for (let r = 0; r < e.axes.length; r++)
+        if (!k(e.axes[r], t[r]))
           return !1;
     }
   }
-  if (t.annotations !== void 0) {
-    const e = n.annotations || {};
-    for (const [r, o] of Object.entries(t.annotations))
-      if (e[r] !== o)
+  if (e.annotations !== void 0) {
+    const t = n.annotations || {};
+    for (const [r, o] of Object.entries(e.annotations))
+      if (t[r] !== o)
         return !1;
   }
-  if (t.annotationPatterns !== void 0) {
-    const e = n.annotations || {};
-    for (const [r, o] of Object.entries(t.annotationPatterns)) {
-      const s = e[r];
+  if (e.annotationPatterns !== void 0) {
+    const t = n.annotations || {};
+    for (const [r, o] of Object.entries(e.annotationPatterns)) {
+      const s = t[r];
       if (s === void 0 || !new RegExp(o).test(s))
         return !1;
     }
@@ -706,25 +706,49 @@ function N(n, t) {
   return !0;
 }
 function Kn(n) {
-  return Array.isArray(n) ? (t) => n.some((e) => f(t) && N(t, e)) : (t) => f(t) && N(t, n);
+  return Array.isArray(n) ? (e) => n.some((t) => f(e) && N(e, t)) : (e) => f(e) && N(e, n);
 }
-const Rn = { href: "/" }, Mn = y.object({
-  __isRef: y.literal(!0).describe("Crucial marker for the block dependency tree reconstruction"),
-  blockId: y.string().describe("Upstream block id"),
-  name: y.string().describe("Name of the output provided to the upstream block's output context")
+const Rn = { href: "/" }, _n = p.object({
+  __isRef: p.literal(!0).describe("Crucial marker for the block dependency tree reconstruction"),
+  blockId: p.string().describe("Upstream block id"),
+  name: p.string().describe("Name of the output provided to the upstream block's output context"),
+  requireEnrichments: p.literal(!0).optional().describe("True if current block that stores this reference in its args, may need enrichments for the references value originating from the blocks in between current and referenced block")
 }).describe(
   "Universal reference type, allowing to set block connections. It is crucial that {@link __isRef} is present and equal to true, internal logic relies on this marker to build block dependency trees."
-).strict().readonly();
-function Tn(n) {
+).readonly();
+function Mn(n) {
   return typeof n == "object" && n !== null && "__isRef" in n && n.__isRef === !0 && "blockId" in n && "name" in n;
 }
-function vn(n, t) {
-  return n.blockId === t.blockId && n.name === t.name;
+function Tn(n, e, t = !1) {
+  return t ? {
+    __isRef: !0,
+    blockId: n,
+    name: e,
+    requireEnrichments: !0
+  } : {
+    __isRef: !0,
+    blockId: n,
+    name: e
+  };
 }
-function _n(n, t) {
-  return n.ok ? { ok: !0, value: t(n.value) } : n;
+function vn(n, e = !0) {
+  if (e)
+    return {
+      ...n,
+      requireEnrichments: !0
+    };
+  {
+    const { requireEnrichments: t, ...r } = n;
+    return r;
+  }
+}
+function Hn(n, e, t = !1) {
+  return n.blockId === e.blockId && n.name === e.name && (t || n.requireEnrichments === e.requireEnrichments);
 }
-function tn(n) {
+function qn(n, e) {
+  return n.ok ? { ok: !0, value: e(n.value) } : n;
+}
+function en(n) {
   if (n instanceof Int8Array || n instanceof Uint8Array || n instanceof Uint8ClampedArray)
     return new DataView(n.buffer, n.byteOffset, n.byteLength);
   if (n instanceof ArrayBuffer) return new DataView(n);
@@ -732,14 +756,14 @@ function tn(n) {
     "Expected `data` to be an ArrayBuffer, Buffer, Int8Array, Uint8Array or Uint8ClampedArray"
   );
 }
-const en = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567", rn = "0123456789ABCDEFGHIJKLMNOPQRSTUV", on = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
-function C(n, t, e) {
-  e = e || {};
+const tn = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567", rn = "0123456789ABCDEFGHIJKLMNOPQRSTUV", on = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+function C(n, e, t) {
+  t = t || {};
   let r, o;
-  switch (t) {
+  switch (e) {
     case "RFC3548":
     case "RFC4648":
-      r = en, o = !0;
+      r = tn, o = !0;
       break;
     case "RFC4648-HEX":
       r = rn, o = !0;
@@ -748,9 +772,9 @@ function C(n, t, e) {
       r = on, o = !1;
       break;
     default:
-      throw new Error("Unknown base32 variant: " + String(t));
+      throw new Error("Unknown base32 variant: " + String(e));
   }
-  const s = e.padding !== void 0 ? e.padding : o, a = tn(n);
+  const s = t.padding !== void 0 ? t.padding : o, a = en(n);
   let i = 0, u = 0, c = "";
   for (let d = 0; d < a.byteLength; d++)
     for (u = u << 8 | a.getUint8(d), i += 8; i >= 5; )
@@ -760,8 +784,8 @@ function C(n, t, e) {
       c += "=";
   return c;
 }
-const J = 15, sn = 24, O = y.string().length(sn).regex(/[ABCDEFGHIJKLMNOPQRSTUVWXYZ234567]/).brand("PlId");
-function Hn() {
+const J = 15, sn = 24, O = p.string().length(sn).regex(/[ABCDEFGHIJKLMNOPQRSTUVWXYZ234567]/).brand("PlId");
+function Wn() {
   const n = new Uint8Array(J);
   return crypto.getRandomValues(n), O.parse(C(n, "RFC4648"));
 }
@@ -769,24 +793,24 @@ function an(n) {
   if (n.length !== J) throw new Error(`Wrong number of bytes: ${n.length}`);
   return O.parse(C(n, "RFC4648"));
 }
-async function Wn(n) {
-  const t = new TextEncoder(), e = await crypto.subtle.digest("SHA-256", t.encode(n));
-  return an(new Uint8Array(e.slice(0, 15)));
+async function zn(n) {
+  const e = new TextEncoder(), t = await crypto.subtle.digest("SHA-256", e.encode(n));
+  return an(new Uint8Array(t.slice(0, 15)));
 }
-function zn(n) {
+function Xn(n) {
   return JSON.stringify(n);
 }
-function Xn(n) {
+function Gn(n) {
   return h(n);
 }
-function Gn(n) {
+function Qn(n) {
   return JSON.parse(n);
 }
 export {
-  $n as AnchoredIdDeriver,
+  In as AnchoredIdDeriver,
   Rn as DefaultNavigationState,
   H as PTableAbsent,
-  W as PTableNA,
+  q as PTableNA,
   K as PValueBytesNA,
   Pn as PValueDoubleNA,
   wn as PValueFloatNA,
@@ -796,22 +820,23 @@ export {
   O as PlId,
   J as PlIdBytes,
   sn as PlIdLength,
-  Mn as PlRef,
+  _n as PlRef,
   Jn as canonicalizeAxisId,
-  Xn as canonicalizeJson,
+  Gn as canonicalizeJson,
+  Tn as createPlRef,
   hn as dataInfoToEntries,
-  Wn as digestPlId,
+  zn as digestPlId,
   xn as ensureNotNAPValue,
   jn as ensurePColumn,
   gn as entriesToDataInfo,
   b as executePSpecPredicate,
   Un as extractAllColumns,
-  z as getAxesId,
-  p as getAxisId,
+  W as getAxesId,
+  m as getAxisId,
   Cn as getColumnIdAndSpec,
   pn as getFileNameFromHandle,
   V as getFilePathFromHandle,
-  En as getPColumnSpecId,
+  Sn as getPColumnSpecId,
   mn as isDataInfo,
   j as isDataInfoEntries,
   Ln as isFilteredPColumn,
@@ -819,38 +844,39 @@ export {
   D as isImportFileHandleUpload,
   dn as isLiveLog,
   R as isNotNAPValue,
-  q as isPColumn,
+  Z as isPColumn,
   Bn as isPColumnResult,
   f as isPColumnSpec,
   Vn as isPColumnSpecResult,
   Nn as isPTableAbsent,
-  M as isPValue,
-  ln as isPartitionedDataInfoEntries,
-  Tn as isPlRef,
-  _ as isValueAbsent,
+  _ as isPValue,
+  yn as isPartitionedDataInfoEntries,
+  Mn as isPlRef,
+  v as isValueAbsent,
   g as isValueNA,
-  yn as mapDataInfo,
+  ln as mapDataInfo,
   bn as mapDataInfoEntries,
-  l as mapJoinEntry,
+  y as mapJoinEntry,
   Fn as mapPObjectData,
   On as mapPTableDef,
-  _n as mapValueInVOE,
+  qn as mapValueInVOE,
   k as matchAxis,
-  G as matchAxisId,
+  X as matchAxisId,
   N as matchPColumn,
-  Sn as pTableValue,
+  En as pTableValue,
   kn as pValueToStringOrNumber,
-  v as pValueToStringOrNumberOrNull,
-  In as parseColumnId,
-  Gn as parseJson,
+  T as pValueToStringOrNumberOrNull,
+  $n as parseColumnId,
+  Qn as parseJson,
   an as plId,
-  vn as plRefsEqual,
+  Hn as plRefsEqual,
   Dn as resolveAnchors,
-  T as safeConvertToPValue,
+  M as safeConvertToPValue,
   Kn as selectorsToPredicate,
-  Q as stringifyColumnId,
-  zn as stringifyJson,
+  G as stringifyColumnId,
+  Xn as stringifyJson,
   An as toJsonSafePValue,
-  Hn as uniquePlId
+  Wn as uniquePlId,
+  vn as withEnrichments
 };
 //# sourceMappingURL=index.mjs.map