@xpell/core 2.0.2 → 2.0.3

package/dist/xpell-core.es.js

@@ -1,8 +1,8 @@
 var B = (o) => {
   throw TypeError(o);
 };
-var J = (o, e, t) => e.has(o) || B("Cannot " + t);
-var f = (o, e, t) => (J(o, e, "read from private field"), t ? t.call(o) : e.get(o)), V = (o, e, t) => e.has(o) ? B("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(o) : e.set(o, t), z = (o, e, t, s) => (J(o, e, "write to private field"), s ? s.call(o, t) : e.set(o, t), t);
+var z = (o, e, t) => e.has(o) || B("Cannot " + t);
+var f = (o, e, t) => (z(o, e, "read from private field"), t ? t.call(o) : e.get(o)), J = (o, e, t) => e.has(o) ? B("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(o) : e.set(o, t), V = (o, e, t, s) => (z(o, e, "write to private field"), s ? s.call(o, t) : e.set(o, t), t);
 class Y {
   /**
    * Create ignore list for parser to ignore spell words
@@ -11,8 +11,8 @@ class Y {
    */
   createIgnoreList(e, t) {
     if (!e) return t;
-    const s = e.split(",").map((n) => n.trim()).filter(Boolean);
-    for (const n of s) t[n] = "";
+    const s = e.split(",").map((r) => r.trim()).filter(Boolean);
+    for (const r of s) t[r] = "";
     return t;
   }
   /**
@@ -33,12 +33,12 @@ class Y {
       const c = Array.from(i, (a) => a.toString(16).padStart(2, "0"));
       return c.slice(0, 4).join("") + "-" + c.slice(4, 6).join("") + "-" + c.slice(6, 8).join("") + "-" + c.slice(8, 10).join("") + "-" + c.slice(10, 16).join("");
     }
-    const s = "0123456789abcdef".split(""), n = [];
-    let r;
-    n[8] = n[13] = n[18] = n[23] = "-", n[14] = "4";
+    const s = "0123456789abcdef".split(""), r = [];
+    let n;
+    r[8] = r[13] = r[18] = r[23] = "-", r[14] = "4";
     for (let i = 0; i < 36; i++)
-      n[i] || (r = (0 | Math.random() * 16) >>> 0, n[i] = s[i === 19 ? r & 3 | 8 : r & 15]);
-    return n.join("");
+      r[i] || (n = (0 | Math.random() * 16) >>> 0, r[i] = s[i === 19 ? n & 3 | 8 : n & 15]);
+    return r.join("");
   }
   /**
    * Merge defaults into data object (mutates data)
@@ -49,10 +49,20 @@ class Y {
   mergeDefaultsWithData(e, t, s = !1) {
     if (!e) return t;
     e._id || (e._id = e.id ?? this.guid());
-    for (const n of Object.keys(t))
-      (!(n in e) || s) && (e[n] = t[n]);
+    for (const r of Object.keys(t))
+      (!(r in e) || s) && (e[r] = t[r]);
     return e;
   }
+  deepMergeDefaults(e, t) {
+    if (!e || typeof e != "object" || Array.isArray(e))
+      return structuredClone(t);
+    const s = structuredClone(t);
+    for (const r of Object.keys(e)) {
+      const n = e[r], i = t?.[r];
+      n && typeof n == "object" && !Array.isArray(n) && i && typeof i == "object" && !Array.isArray(i) ? s[r] = this.deepMergeDefaults(n, i) : s[r] = n;
+    }
+    return s;
+  }
   /**
    * Encode string to Base64 (UTF-8 safe, cross-platform)
    */
@@ -61,7 +71,7 @@ class Y {
     if (typeof t.btoa == "function") {
       const s = encodeURIComponent(String(e)).replace(
         /%([0-9A-F]{2})/g,
-        (n, r) => String.fromCharCode(parseInt(r, 16))
+        (r, n) => String.fromCharCode(parseInt(n, 16))
       );
       return t.btoa(s);
     }
@@ -75,8 +85,8 @@ class Y {
   decode(e) {
     const t = globalThis;
     if (typeof t.atob == "function") {
-      const s = t.atob(String(e)), n = Array.prototype.map.call(s, (r) => "%" + r.charCodeAt(0).toString(16).padStart(2, "0")).join("");
-      return decodeURIComponent(n);
+      const s = t.atob(String(e)), r = Array.prototype.map.call(s, (n) => "%" + n.charCodeAt(0).toString(16).padStart(2, "0")).join("");
+      return decodeURIComponent(r);
     }
     if (t.Buffer && typeof t.Buffer.from == "function")
       return t.Buffer.from(String(e), "base64").toString("utf8");
@@ -103,12 +113,12 @@ class Y {
   createDefaultScheduler(e) {
     const t = globalThis;
     if (typeof t.requestAnimationFrame == "function")
-      return (r) => t.requestAnimationFrame(r);
+      return (n) => t.requestAnimationFrame(n);
     const s = typeof e == "number" && isFinite(e) && e > 0 ? e : 60;
     if (typeof t.setImmediate == "function" && (!e || e >= 60))
-      return (r) => t.setImmediate(r);
-    const n = Math.max(1, Math.round(1e3 / s));
-    return (r) => t.setTimeout(r, n);
+      return (n) => t.setImmediate(n);
+    const r = Math.max(1, Math.round(1e3 / s));
+    return (n) => t.setTimeout(n, r);
   }
   to_iso_now() {
     return (/* @__PURE__ */ new Date()).toISOString();
@@ -116,11 +126,28 @@ class Y {
   is_plain_object(e) {
     return typeof e == "object" && e !== null && !Array.isArray(e);
   }
+  ensure_object(e, t) {
+    if (!this.is_plain_object(e))
+      throw new Error(`Invalid '${t}'`);
+    return e;
+  }
   ensure_string(e, t) {
     if (typeof e != "string" || !e.trim())
       throw new Error(`Invalid '${t}'`);
     return e.trim();
   }
+  ensure_boolean(e, t) {
+    if (typeof e == "boolean") return e;
+    if (e === "true") return !0;
+    if (e === "false") return !1;
+    throw new Error(`Invalid '${t}'`);
+  }
+  ensure_number(e, t) {
+    const s = Number(e);
+    if (isNaN(s))
+      throw new Error(`Invalid '${t}'`);
+    return s;
+  }
   ensure_params(e) {
     return this.is_plain_object(e) ? e : {};
   }
@@ -130,9 +157,9 @@ class Y {
    */
   addIfNotNull(e, t, s) {
     if (!(!e || !t || !Array.isArray(s)))
-      for (const n of s) {
-        const r = e[n];
-        r != null && (t[n] = r);
+      for (const r of s) {
+        const n = e[r];
+        n != null && (t[r] = n);
       }
   }
   /**
@@ -175,21 +202,252 @@ class Y {
   calculateExpiration(e) {
     const s = String(e ?? "").trim().match(/^(\d+)([hdy])$/);
     if (!s) throw new Error("Invalid expiration format. Use: 1h | 2d | 3y");
-    const n = Number.parseInt(s[1], 10), r = s[2], i = Date.now();
+    const r = Number.parseInt(s[1], 10), n = s[2], i = Date.now();
     let c = 0;
-    switch (r) {
+    switch (n) {
       case "h":
-        c = n * 60 * 60 * 1e3;
+        c = r * 60 * 60 * 1e3;
         break;
       case "d":
-        c = n * 24 * 60 * 60 * 1e3;
+        c = r * 24 * 60 * 60 * 1e3;
         break;
       case "y":
-        c = n * 365 * 24 * 60 * 60 * 1e3;
+        c = r * 365 * 24 * 60 * 60 * 1e3;
         break;
     }
     return i + c;
   }
+  // ============================================================================
+  // AI / Runtime Primitive Helpers
+  // ============================================================================
+  normalize_prompt(e) {
+    return String(e ?? "").normalize("NFKC").replace(/\s+/g, " ").trim();
+  }
+  normalize_prompt_key(e) {
+    return this.normalize_prompt(e).toLowerCase().replace(/[_/]+/g, " ");
+  }
+  is_non_empty_string(e) {
+    return typeof e == "string" && e.trim().length > 0;
+  }
+  has_value(e) {
+    return e == null ? !1 : Array.isArray(e) ? e.length > 0 : typeof e == "object" ? Object.keys(e).length > 0 : !0;
+  }
+  ensure_array(e) {
+    return Array.isArray(e) ? e : e == null ? [] : [e];
+  }
+  to_record(e) {
+    return this.is_plain_object(e) ? e : {};
+  }
+  safe_json_parse(e, t) {
+    if (typeof e != "string") return t;
+    try {
+      return JSON.parse(e);
+    } catch {
+      return t;
+    }
+  }
+  safe_json_stringify(e, t = "{}") {
+    try {
+      return JSON.stringify(e);
+    } catch {
+      return t;
+    }
+  }
+  clone_json(e) {
+    return this.safe_json_parse(
+      this.safe_json_stringify(e, "null"),
+      e
+    );
+  }
+  get_path(e, t, s) {
+    const r = Array.isArray(t) ? t : String(t ?? "").split(".").filter(Boolean);
+    let n = e;
+    for (const i of r) {
+      if (n == null) return s;
+      n = n[i];
+    }
+    return n === void 0 ? s : n;
+  }
+  set_path(e, t, s) {
+    const r = Array.isArray(t) ? t : String(t ?? "").split(".").filter(Boolean);
+    if (!r.length) return e;
+    let n = e;
+    for (let i = 0; i < r.length - 1; i++) {
+      const c = r[i];
+      this.is_plain_object(n[c]) || (n[c] = {}), n = n[c];
+    }
+    return n[r[r.length - 1]] = s, e;
+  }
+  pick_defined(e, t) {
+    const s = {};
+    if (!this.is_plain_object(e) || !Array.isArray(t)) return s;
+    for (const r of t) {
+      const n = e[r];
+      n != null && (s[r] = n);
+    }
+    return s;
+  }
+  omit_undefined(e) {
+    const t = {};
+    if (!this.is_plain_object(e)) return t;
+    for (const [s, r] of Object.entries(e))
+      r !== void 0 && (t[s] = r);
+    return t;
+  }
+  escape_regexp(e) {
+    return e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  }
+  matches_keyword(e, t) {
+    const s = /^[a-z0-9]+$/.test(t) ? "s?" : "";
+    return new RegExp(
+      `(^|[^a-z0-9])${this.escape_regexp(t)}${s}($|[^a-z0-9])`
+    ).test(e);
+  }
+  match_keywords(e, t) {
+    return t.filter((s) => this.matches_keyword(e, s));
+  }
+  contains_keyword(e, t) {
+    return this.match_keywords(e, t).length > 0;
+  }
+  read_optional_string(e, t) {
+    if (e != null) {
+      if (typeof e != "string" || e.trim().length === 0)
+        throw new Error(`Invalid '${t}': expected non-empty string`);
+      return e.trim();
+    }
+  }
+  read_optional_boolean(e, t) {
+    if (e != null) {
+      if (typeof e != "boolean")
+        throw new Error(`Invalid '${t}': expected boolean`);
+      return e;
+    }
+  }
+  read_optional_number(e, t) {
+    if (e != null) {
+      if (typeof e != "number" || !isFinite(e))
+        throw new Error(`Invalid '${t}': expected finite number`);
+      return e;
+    }
+  }
+  read_optional_object(e, t) {
+    if (e != null) {
+      if (!this.is_plain_object(e))
+        throw new Error(`Invalid '${t}': expected plain object`);
+      return e;
+    }
+  }
+  /**
+  * Returns unique string values while preserving insertion order.
+  *
+  * Example:
+  * ["a", "b", "a"] -> ["a", "b"]
+  */
+  unique_strings(e) {
+    return Array.from(new Set(e));
+  }
+  /**
+   * Normalizes IDs (trim + lowercase) and removes duplicates.
+   *
+   * Example:
+   * [" User ", "user", "ADMIN"] -> ["user", "admin"]
+   */
+  unique_normalized_ids(e) {
+    return Array.from(
+      new Set(
+        e.map((t) => t.trim().toLowerCase()).filter((t) => t.length > 0)
+      )
+    );
+  }
+  /**
+   * Truncates long text while preserving the beginning.
+   * Appends a truncation marker when the text exceeds max_chars.
+   */
+  truncate_text(e, t) {
+    return e.length <= t ? e : `${e.slice(0, Math.max(0, t - 18))}
+...[truncated]`;
+  }
+  /**
+   * Serializes a value as formatted JSON and truncates the result
+   * when it exceeds the specified character limit.
+   */
+  compact_json(e, t = 5e3) {
+    return this.truncate_text(
+      JSON.stringify(e, null, 2),
+      t
+    );
+  }
+  /**
+   * Serializes a value as compact single-line JSON and truncates
+   * the result when it exceeds the specified character limit.
+   */
+  compact_inline_json(e, t = 5e3) {
+    return this.truncate_text(
+      JSON.stringify(e),
+      t
+    );
+  }
+  /**
+   * Safe version of compact_inline_json().
+   * Returns an empty string when serialization fails.
+   */
+  safe_compact_inline_json(e, t = 5e3) {
+    try {
+      return this.compact_inline_json(e, t);
+    } catch {
+      return "";
+    }
+  }
+  /**
+   * Returns the first max_items items from an array.
+   * Returns an empty array for non-array values.
+   */
+  compact_array(e, t = 20) {
+    return Array.isArray(e) ? e.slice(0, t) : [];
+  }
+  /**
+   * Normalizes arbitrary text into a stable identifier.
+   *
+   * Example:
+   * "User Profile" -> "user-profile"
+   * "user_profile" -> "user-profile"
+   */
+  normalize_id(e) {
+    if (typeof e != "string") return;
+    const t = e.toLowerCase().trim().replace(/[_\s]+/gu, "-").replace(/[^a-z0-9-]+/gu, "-").replace(/-+/gu, "-").replace(/^-|-$/gu, "");
+    return t.length > 0 ? t : void 0;
+  }
+  /**
+   * Normalizes an array of identifiers and removes duplicates.
+   *
+   * Example:
+   * ["User Profile", "user-profile"]
+   * -> ["user-profile"]
+   */
+  normalize_id_array(e) {
+    return Array.isArray(e) ? e.map((t) => this.normalize_id(t)).filter((t) => typeof t == "string").filter((t, s, r) => r.indexOf(t) === s) : [];
+  }
+  /**
+   * @deprecated Use normalize_id_array().
+   */
+  normalize_string_array(e) {
+    return this.normalize_id_array(e);
+  }
+  /**
+   * Returns only plain object items from an array.
+   * Non-object values, nulls, and arrays are ignored.
+   */
+  ensure_object_array(e) {
+    return Array.isArray(e) ? e.filter(
+      (t) => this.is_plain_object(t)
+    ) : [];
+  }
+  /**
+   * @deprecated Use ensure_object_array().
+   */
+  read_object_array(e) {
+    return this.ensure_object_array(e);
+  }
 }
 const Z = new Y(), u = Z;
 class ee {
@@ -198,15 +456,15 @@ class ee {
   #t = 0;
   // EMA of ms/frame
   #s = 0;
-  #n;
-  // weight of new samples (0..1)
   #r;
+  // weight of new samples (0..1)
+  #n;
   // minimum integer change to update displayed fps
   constructor(e = 0.05, t = 1) {
     const s = Number(e);
-    this.#n = Number.isFinite(s) ? Math.min(1, Math.max(1e-3, s)) : 0.05;
-    const n = Number(t);
-    this.#r = Number.isFinite(n) ? Math.max(0, Math.floor(n)) : 1;
+    this.#r = Number.isFinite(s) ? Math.min(1, Math.max(1e-3, s)) : 0.05;
+    const r = Number(t);
+    this.#n = Number.isFinite(r) ? Math.max(0, Math.floor(r)) : 1;
   }
   now() {
     const e = globalThis.performance;
@@ -218,11 +476,11 @@ class ee {
       return this.#s = e, this.#e;
     const t = e - this.#s;
     if (this.#s = e, !Number.isFinite(t) || t <= 0) return this.#e;
-    this.#t === 0 ? this.#t = t : this.#t = (1 - this.#n) * this.#t + this.#n * t;
+    this.#t === 0 ? this.#t = t : this.#t = (1 - this.#r) * this.#t + this.#r * t;
     const s = 1e3 / this.#t;
     if (!Number.isFinite(s) || s <= 0) return this.#e;
-    const n = Math.round(s);
-    return this.#e !== 0 && this.#r > 0 && Math.abs(n - this.#e) < this.#r ? this.#e : (this.#e = n, this.#e);
+    const r = Math.round(s);
+    return this.#e !== 0 && this.#n > 0 && Math.abs(r - this.#e) < this.#n ? this.#e : (this.#e = r, this.#e);
   }
   reset() {
     this.#e = 0, this.#t = 0, this.#s = 0;
@@ -252,11 +510,11 @@ class te {
     !this._enabled || !this._debug || console.debug(this._dt(), e, ...t);
   }
 }
-const l = new te(), Q = typeof process < "u" && !!process?.env && process.env.NODE_ENV === "production";
+const h = new te(), Q = typeof process < "u" && !!process?.env && process.env.NODE_ENV === "production";
 Q || console.info(
   "[Xpell] _xlog is redirected to console in development mode. Tip: enable 'Show timestamps' in DevTools → Console for timed logs."
 );
-const v = Q ? l : console;
+const x = Q ? h : console;
 class se {
   constructor() {
     this._objects = {}, this._listeners = /* @__PURE__ */ new Map(), this._any_listeners = /* @__PURE__ */ new Set(), this._compat_writes = !0, this._warn_legacy_writes = !0, this._verbose = !1, this._compat_legacy_keys = !0, this._o_proxy = null, this._objects = {};
@@ -269,10 +527,10 @@ class se {
   get _o() {
     return !this._compat_writes && !this._warn_legacy_writes ? this._objects : (this._o_proxy || (this._o_proxy = new Proxy(this._objects, {
       set: (e, t, s) => {
-        const n = String(t);
+        const r = String(t);
         return this._warn_legacy_writes && console.warn(
-          `[XData] Legacy write: _o["${n}"] = ... ; prefer XData.set("${n}", value).`
-        ), this._compat_writes ? this.set(n, s, { source: "legacy:_o" }) : e[n] = s, !0;
+          `[XData] Legacy write: _o["${r}"] = ... ; prefer XData.set("${r}", value).`
+        ), this._compat_writes ? this.set(r, s, { source: "legacy:_o" }) : e[r] = s, !0;
       },
       deleteProperty: (e, t) => {
         const s = String(t);
@@ -288,13 +546,13 @@ class se {
   }
   /** Preferred write API */
   set(e, t, s) {
-    const n = this._objects[e];
-    this._objects[e] = t, this._emit({ key: e, value: t, prev: n, ts: Date.now(), op: "set", meta: s });
+    const r = this._objects[e];
+    this._objects[e] = t, this._emit({ key: e, value: t, prev: r, ts: Date.now(), op: "set", meta: s });
   }
   /** Shallow merge helper (nice for state objects) */
   patch(e, t, s) {
-    const n = this._objects[e], i = { ...n && typeof n == "object" ? n : {}, ...t };
-    this._objects[e] = i, this._emit({ key: e, value: i, prev: n, ts: Date.now(), op: "patch", meta: s });
+    const r = this._objects[e], i = { ...r && typeof r == "object" ? r : {}, ...t };
+    this._objects[e] = i, this._emit({ key: e, value: i, prev: r, ts: Date.now(), op: "patch", meta: s });
   }
   /** In-place mutation notifier */
   touch(e, t) {
@@ -339,8 +597,8 @@ class se {
     for (const s of this._any_listeners) s(e);
   }
 }
-const D = new se(), m = D;
-class R {
+const v = new se(), m = v;
+class N {
   constructor(e) {
     e && Object.keys(e).forEach((t) => {
       this[t] = e[t];
@@ -360,17 +618,17 @@ class R {
     return this._params?.hasOwnProperty(t) ? this._params[t] : this._params?.hasOwnProperty(e) ? this._params[e] : s;
   }
 }
-const A = {
+const E = {
   type: "_type",
   children: "_children"
-}, y = class y {
+}, j = class j {
   /**
    * Adds HTML-Xpell Mapping item
    * @param htmlElement HTML element to change from
    * @param xpellElement Xpell element to change to 
    */
   static addHtml2XpellMapItem(e, t) {
-    y.html2XMap.elements[e] = t;
+    j.html2XMap.elements[e] = t;
   }
   /**
    * convert text command to Xpell json command
@@ -378,60 +636,60 @@ const A = {
    */
   static parse(e, t) {
     const s = e.split(" ");
-    let n = new R();
-    if (t ? (n._module = t, n._op = s[0]) : (n._module = s[0], n._op = s[1]), n._params = {}, s.length > 1)
-      for (let r = 2; r < s.length; ++r) {
-        const i = s[r];
+    let r = new N();
+    if (t ? (r._module = t, r._op = s[0]) : (r._module = s[0], r._op = s[1]), r._params = {}, s.length > 1)
+      for (let n = 2; n < s.length; ++n) {
+        const i = s[n];
         if (i.indexOf(":") > -1) {
           const a = i.split(":");
-          n._params[a[0]] = a[1];
+          r._params[a[0]] = a[1];
         } else
-          n._params[r - 1] = s[r];
+          r._params[n - 1] = s[n];
       }
-    return n;
+    return r;
   }
   static replaceSpacesInQuotes(e, t = "_%20_") {
-    return e.replace(/(['"])(.*?)\1/g, (s, n, r) => {
-      const i = String(r).replace(/\s/g, t);
-      return `${n}${i}${n}`;
+    return e.replace(/(['"])(.*?)\1/g, (s, r, n) => {
+      const i = String(n).replace(/\s/g, t);
+      return `${r}${i}${r}`;
     });
   }
   static parseObjectCommand(e, t) {
-    e = y.replaceSpacesInQuotes(e);
-    const s = e.trim().split(/\s+/), n = t || s.shift();
-    if (!n) throw new Error("Missing module name");
-    let r;
-    if (s[0]?.startsWith("#") && (r = s.shift().slice(1), !r))
+    e = j.replaceSpacesInQuotes(e);
+    const s = e.trim().split(/\s+/), r = t || s.shift();
+    if (!r) throw new Error("Missing module name");
+    let n;
+    if (s[0]?.startsWith("#") && (n = s.shift().slice(1), !n))
       throw new Error("Invalid object selector '#'. Use '#<id>'");
     const i = s.shift();
     if (!i) throw new Error("Missing operation");
     const c = {};
     let a = null, _ = null;
-    if (s.forEach((h) => {
+    if (s.forEach((l) => {
       if (_) {
-        if (_ += ` ${h}`, h.endsWith(_[0])) {
-          const p = _.slice(1, -1).replace(/_%20_/g, " ");
-          c[a] = p, _ = null;
+        if (_ += ` ${l}`, l.endsWith(_[0])) {
+          const d = _.slice(1, -1).replace(/_%20_/g, " ");
+          c[a] = d, _ = null;
         }
         return;
       }
-      if (h.startsWith('"') || h.startsWith("'")) {
-        if (_ = h, h.endsWith(h[0]) && h.length > 1) {
-          const p = h.slice(1, -1).replace(/_%20_/g, " ");
-          c[a] = p, _ = null;
+      if (l.startsWith('"') || l.startsWith("'")) {
+        if (_ = l, l.endsWith(l[0]) && l.length > 1) {
+          const d = l.slice(1, -1).replace(/_%20_/g, " ");
+          c[a] = d, _ = null;
         }
         return;
       }
-      if (h.includes(":")) {
-        const p = h.split(":"), x = p[0], j = p.slice(1).join(":").replace(/_%20_/g, " ");
-        c[x] = j, a = null;
+      if (l.includes(":")) {
+        const d = l.split(":"), y = d[0], g = d.slice(1).join(":").replace(/_%20_/g, " ");
+        c[y] = g, a = null;
         return;
       }
-      a = h.replace(/_%20_/g, " ");
+      a = l.replace(/_%20_/g, " ");
     }), _) throw new Error("Unclosed quoted parameter value");
     return {
-      _module: n,
-      _object: r,
+      _module: r,
+      _object: n,
       _op: i,
       _params: c
     };
@@ -443,7 +701,7 @@ const A = {
    */
   static xmlString2Xpell(e) {
     const s = new DOMParser().parseFromString(e, "text/xml");
-    return s.childNodes.length > 0 ? y.xml2Xpell(s.childNodes[0]) : {};
+    return s.childNodes.length > 0 ? j.xml2Xpell(s.childNodes[0]) : {};
   }
   /**
    * Converts XML/HTML Document to Xpell JSON
@@ -452,25 +710,25 @@ const A = {
    * @returns {} Xpell JSON
    */
   static xml2Xpell(e, t) {
-    const s = y.html2XMap;
-    let n = {};
-    n._children = [];
-    const r = e.nodeName, i = e.nodeName;
+    const s = j.html2XMap;
+    let r = {};
+    r._children = [];
+    const n = e.nodeName, i = e.nodeName;
     let c = t;
-    if (t ? (n[A.type] = "xhtml", n._html_ns = "http://www.w3.org/2000/svg") : n._type = s.elements[r] ? s.elements[r] : r, e.attributes)
+    if (t ? (r[E.type] = "xhtml", r._html_ns = "http://www.w3.org/2000/svg") : r._type = s.elements[n] ? s.elements[n] : n, e.attributes)
       for (let a = 0; a < e.attributes.length; ++a) {
-        const _ = e.attributes[a], h = s.attributes[_.name] ? s.attributes[_.name] : _.name;
-        n[h] = _.value;
+        const _ = e.attributes[a], l = s.attributes[_.name] ? s.attributes[_.name] : _.name;
+        r[l] = _.value;
       }
-    if (e?.firstChild?.nodeValue && (n.text = e?.firstChild.nodeValue.trim()), n[A.type] == "xhtml" ? n._html_tag = i : n[A.type] == "svg" && (c = !0, n._html_ns = "http://www.w3.org/2000/svg"), e?.childNodes.length > 0)
+    if (e?.firstChild?.nodeValue && (r.text = e?.firstChild.nodeValue.trim()), r[E.type] == "xhtml" ? r._html_tag = i : r[E.type] == "svg" && (c = !0, r._html_ns = "http://www.w3.org/2000/svg"), e?.childNodes.length > 0)
       for (let a = 0; a < e.childNodes.length; ++a) {
         const _ = e.childNodes[a];
-        _.nodeName.startsWith("#") || n[A.children].push(y.xml2Xpell(_, c));
+        _.nodeName.startsWith("#") || r[E.children].push(j.xml2Xpell(_, c));
       }
-    return n;
+    return r;
   }
 };
-y.html2XMap = {
+j.html2XMap = {
   elements: {
     div: "view",
     a: "link",
@@ -500,8 +758,8 @@ y.html2XMap = {
     id: "_id"
   }
 };
-let w = y;
-class ne {
+let O = j;
+class re {
   #e;
   #t;
   #s;
@@ -569,7 +827,7 @@ class ne {
    * @param xObject XObject to maintain
    */
   addObject(e) {
-    e && e._id ? (this.#t[e._id] = e, (!e._name || e._name.length == 0) && (e._name = e._id), this.#s[e._name] = e._id) : l.log("unable to add object");
+    e && e._id ? (this.#t[e._id] = e, (!e._name || e._name.length == 0) && (e._name = e._id), this.#s[e._name] = e._id) : h.log("unable to add object");
   }
   /**
    * Remove XObject from the manager 
@@ -604,7 +862,7 @@ class ne {
     return this.#s[e] ? this.getObject(this.#s[e]) : null;
   }
 }
-class fe {
+class pe {
   constructor() {
     this._log_rules = {
       register: !1,
@@ -619,16 +877,16 @@ class fe {
    * - Canonical: on(name, cb, { _once, _owner, _tag })
    * - Legacy:   on(name, cb, { _once }, owner)
    */
-  on(e, t, s = {}, n) {
+  on(e, t, s = {}, r) {
     this._events[e] || (this._events[e] = []);
-    const r = s?._owner ?? n, i = u.guid(), c = {
+    const n = s?._owner ?? r, i = u.guid(), c = {
       _id: i,
       _callback: t,
       _options: s,
-      _owner: r,
+      _owner: n,
       _tag: s?._tag
     };
-    return this._events[e].push(c), this._listener_index[i] = e, this._log_rules.register && v.log("XEM Register", e, i), i;
+    return this._events[e].push(c), this._listener_index[i] = e, this._log_rules.register && x.log("XEM Register", e, i), i;
   }
   /**
    * Register a listener that will be removed after first fire.
@@ -642,17 +900,17 @@ class fe {
   async fire(e, t) {
     const s = this._events[e];
     if (!s || s.length === 0) return;
-    this._log_rules.fire && v.log("XEM Fire", e, t);
-    const n = s.slice(), r = [];
-    for (const i of n) {
+    this._log_rules.fire && x.log("XEM Fire", e, t);
+    const r = s.slice(), n = [];
+    for (const i of r) {
       try {
         i && i._callback && i._callback(t);
       } catch (c) {
-        v.error(c);
+        x.error(c);
       }
-      i?._options?._once && r.push(i._id);
+      i?._options?._once && n.push(i._id);
     }
-    for (const i of r) this.remove(i);
+    for (const i of n) this.remove(i);
   }
   /**
    * Remove a listener by id.
@@ -662,10 +920,10 @@ class fe {
     if (!t) return;
     const s = this._events[t];
     if (s && s.length) {
-      const n = s.findIndex((r) => r?._id === e);
-      n >= 0 && s.splice(n, 1), s.length === 0 && delete this._events[t];
+      const r = s.findIndex((n) => n?._id === e);
+      r >= 0 && s.splice(r, 1), s.length === 0 && delete this._events[t];
     }
-    delete this._listener_index[e], this._log_rules.remove && v.log("XEM Remove", t, e);
+    delete this._listener_index[e], this._log_rules.remove && x.log("XEM Remove", t, e);
   }
   /**
    * Remove all listeners for a given owner reference.
@@ -674,8 +932,8 @@ class fe {
     if (!e) return;
     const t = [];
     for (const s of Object.values(this._events))
-      for (const n of s)
-        (n?._owner ?? n?._options?._owner) === e && t.push(n._id);
+      for (const r of s)
+        (r?._owner ?? r?._options?._owner) === e && t.push(r._id);
     t.forEach((s) => this.remove(s));
   }
   /**
@@ -685,16 +943,16 @@ class fe {
     this._events = {}, this._listener_index = {};
   }
 }
-let N;
-function pe(o) {
-  N = o;
+let R;
+function fe(o) {
+  R = o;
 }
-function E() {
-  if (!N)
+function X() {
+  if (!R)
     throw new Error("XEventManager not set");
-  return N;
+  return R;
 }
-const re = [
+const ne = [
   "_nano_commands",
   "_cache_cmd_txt",
   "_cache_jcmd",
@@ -703,21 +961,21 @@ const re = [
   "_parent",
   "_children"
 ];
-function F(o) {
-  return re.includes(o);
+function $(o) {
+  return ne.includes(o);
 }
 function K(o) {
   if (!o || typeof o != "object" || Array.isArray(o)) return !1;
   const e = Object.getPrototypeOf(o);
   return e === Object.prototype || e === null;
 }
-function g(o, e) {
+function b(o, e) {
   return o._skill = e, o.getSkill = () => e, o;
 }
 const G = {
-  info: g(
+  info: b(
     (o, e) => {
-      l.log("XObject id " + e?._id);
+      h.log("XObject id " + e?._id);
     },
     {
       _name: "info",
@@ -725,9 +983,9 @@ const G = {
       _description: "Logs the current object's id."
     }
   ),
-  log: g(
+  log: b(
     (o, e) => {
-      o._params && o._params[1] ? l.log(o._params[1]) : l.log(e);
+      o._params && o._params[1] ? h.log(o._params[1]) : h.log(e);
     },
     {
       _name: "log",
@@ -738,12 +996,12 @@ const G = {
       }
     }
   ),
-  fire: g(
+  fire: b(
     (o, e) => {
-      o._params && o._params[1] ? E().fire(
+      o._params && o._params[1] ? X().fire(
         String(o._params[1]),
         o._params[2]
-      ) : o._params && o._params.event && E().fire(
+      ) : o._params && o._params.event && X().fire(
         String(o._params.event),
         o._params.data
       );
@@ -769,7 +1027,7 @@ const G = {
       }
     }
   ),
-  noop: g(
+  noop: b(
     () => {
     },
     {
@@ -778,12 +1036,12 @@ const G = {
       _description: "No-op command. Useful as a placeholder in sequences."
     }
   ),
-  "set-field": g(
+  "set-field": b(
     (o, e) => {
       const t = o._params?.name, s = o._params?.value;
       if (!(!e || typeof t != "string" || t.length === 0)) {
-        if (F(t)) {
-          l.error(`set-field denied for protected field: ${t}`);
+        if ($(t)) {
+          h.error(`set-field denied for protected field: ${t}`);
           return;
         }
         e[t] = s;
@@ -806,12 +1064,12 @@ const G = {
       }
     }
   ),
-  "delete-field": g(
+  "delete-field": b(
     (o, e) => {
       const t = o._params?.name;
       if (!(!e || typeof t != "string" || t.length === 0)) {
-        if (F(t)) {
-          l.error(`delete-field denied for protected field: ${t}`);
+        if ($(t)) {
+          h.error(`delete-field denied for protected field: ${t}`);
           return;
         }
         delete e[t];
@@ -826,12 +1084,12 @@ const G = {
       }
     }
   ),
-  "toggle-field": g(
+  "toggle-field": b(
     (o, e) => {
       const t = o._params?.name;
       if (!e || typeof t != "string" || t.length === 0) return;
-      if (F(t)) {
-        l.error(`toggle-field denied for protected field: ${t}`);
+      if ($(t)) {
+        h.error(`toggle-field denied for protected field: ${t}`);
         return;
       }
       const s = e[t];
@@ -846,20 +1104,20 @@ const G = {
       }
     }
   ),
-  merge: g(
+  merge: b(
     (o, e) => {
       const t = o._params?.name, s = o._params?.value;
       if (!e || typeof t != "string" || t.length === 0) return;
-      if (F(t)) {
-        l.error(`merge denied for protected field: ${t}`);
+      if ($(t)) {
+        h.error(`merge denied for protected field: ${t}`);
         return;
       }
       if (!K(s)) {
-        l.error("merge expects _params.value as a plain object");
+        h.error("merge expects _params.value as a plain object");
         return;
       }
-      const n = e[t];
-      K(n) || (e[t] = {}), Object.assign(e[t], s);
+      const r = e[t];
+      K(r) || (e[t] = {}), Object.assign(e[t], s);
     },
     {
       _name: "merge",
@@ -871,12 +1129,12 @@ const G = {
       }
     }
   ),
-  "run-seq": g(
+  "run-seq": b(
     async (o, e) => {
       if (!e) return;
       const t = o._params?.seq;
       if (!Array.isArray(t)) {
-        l.error("run-seq expects _params.seq as an array");
+        h.error("run-seq expects _params.seq as an array");
         return;
       }
       for (const s of t) {
@@ -885,9 +1143,9 @@ const G = {
           continue;
         }
         if (s && typeof s == "object" && s._op) {
-          const n = s._object;
-          if (!(n == null || n === "this" || n === e._id)) {
-            l.error("run-seq rejected non-self _object target");
+          const r = s._object;
+          if (!(r == null || r === "this" || r === e._id)) {
+            h.error("run-seq rejected non-self _object target");
             return;
           }
           const i = {
@@ -897,7 +1155,7 @@ const G = {
           await e.execute(i);
           continue;
         }
-        l.error(
+        h.error(
           "run-seq skipped invalid step; expected string or object with _op"
         );
       }
@@ -993,7 +1251,7 @@ const U = {
     "Runtime methods include parse, append, run, execute, bindDataSource, unbindDataSource, toXData, dispose, and removeChild.",
     "Most prompts should use this skill as a compact dependency summary, not full context."
   ]
-}, $ = { _children: "child nodes" }, X = class X {
+}, P = { _children: "child nodes" }, A = class A {
   /**
    * XObject constructor is creating the object and adding all the data keys to the XObject instance
    * @param data constructor input data (object)
@@ -1022,11 +1280,11 @@ const U = {
         "_debug"
       ],
       _instance_xporters: {}
-    }, t && u.mergeDefaultsWithData(e, t), this._id = e && e._id ? e._id : "xo-" + u.guid(), this._type = "object", this._children = [], this._nano_commands = {}, this.addNanoCommandPack(G), e && e.hasOwnProperty("_nano_commands") && e._nano_commands && (this.addNanoCommandPack(e._nano_commands), delete e._nano_commands), this.addXporterDataIgnoreFields(["_nano_commands"]), this.addXporterInstanceXporter(X, (n) => n.toXData()), this._xem_options = {
+    }, t && u.mergeDefaultsWithData(e, t), this._id = e && e._id ? e._id : "xo-" + u.guid(), this._type = "object", this._children = [], this._nano_commands = {}, this.addNanoCommandPack(G), e && e.hasOwnProperty("_nano_commands") && e._nano_commands && (this.addNanoCommandPack(e._nano_commands), delete e._nano_commands), this.addXporterDataIgnoreFields(["_nano_commands"]), this.addXporterInstanceXporter(A, (r) => r.toXData()), this._xem_options = {
       // _instance:_xem
       // _object: this
       // _support_html: true
-    }, !s && e && this.parse(e, $);
+    }, !s && e && this.parse(e, P);
   }
   static getOwnSkill() {
     const e = this, t = e._skill ?? U;
@@ -1064,8 +1322,8 @@ const U = {
     return "canonical";
   }
   static generateArtifact(e = {}) {
-    const t = this.getOwnSkill?.(), s = t?._canonical_examples?.[0], n = s ? this.cloneArtifact(s) : { _type: this._xtype ?? t?._id ?? "object" };
-    return this.applyArtifactIntent(n, e);
+    const t = this.getOwnSkill?.(), s = t?._canonical_examples?.[0], r = s ? this.cloneArtifact(s) : { _type: this._xtype ?? t?._id ?? "object" };
+    return this.applyArtifactIntent(r, e);
   }
   static cloneArtifact(e) {
     return typeof structuredClone == "function" ? structuredClone(e) : JSON.parse(JSON.stringify(e));
@@ -1085,7 +1343,7 @@ const U = {
     };
   }
   log(e, ...t) {
-    this._debug && e && l.log(this._type + "->" + this._id + "]", e, ...t);
+    this._debug && e && h.log(this._type + "->" + this._id + "]", e, ...t);
   }
   /**
    * Initialize the XObject
@@ -1094,7 +1352,7 @@ const U = {
    * @deprecated - use parse method instead
    */
   init(e, t) {
-    !t && e && this.parse(e, $);
+    !t && e && this.parse(e, P);
   }
   parseEvents(e) {
     if (!this._event_parsed) {
@@ -1109,10 +1367,10 @@ const U = {
   }
   addEventListener(e, t, s) {
     s || (s = this._xem_options);
-    const n = async (i) => {
+    const r = async (i) => {
       await this.checkAndRunInternalFunction(t, i);
-    }, r = E().on(e, n, s, this);
-    return this._event_listeners_ids[e] || (this._event_listeners_ids[e] = []), this._event_listeners_ids[e].push(r), r;
+    }, n = X().on(e, r, s, this);
+    return this._event_listeners_ids[e] || (this._event_listeners_ids[e] = []), this._event_listeners_ids[e].push(n), n;
   }
   removeEventListener(e) {
     const t = this._event_listeners_ids;
@@ -1120,9 +1378,9 @@ const U = {
       this._event_listeners_ids = {};
       return;
     }
-    (Array.isArray(t[e]) ? [...t[e]] : []).forEach((n) => {
+    (Array.isArray(t[e]) ? [...t[e]] : []).forEach((r) => {
       try {
-        E().remove(n);
+        X().remove(r);
       } catch {
       }
     }), delete t[e];
@@ -1133,9 +1391,9 @@ const U = {
       this._event_listeners_ids = {};
       return;
     }
-    (e ? [e] : Object.keys(t)).forEach((n) => {
+    (e ? [e] : Object.keys(t)).forEach((r) => {
       try {
-        this.removeEventListener(n);
+        this.removeEventListener(r);
       } catch {
       }
     });
@@ -1183,9 +1441,9 @@ const U = {
    * @param data data to parse
    * @param ignore - lis of words to ignore in the parse process
    */
-  parse(e, t = $) {
-    Object.keys(e).forEach((n) => {
-      !t.hasOwnProperty(n) && e.hasOwnProperty(n) && (this[n] = e[n]);
+  parse(e, t = P) {
+    Object.keys(e).forEach((r) => {
+      !t.hasOwnProperty(r) && e.hasOwnProperty(r) && (this[r] = e[r]);
     });
   }
   /**
@@ -1199,8 +1457,8 @@ const U = {
    * }
    */
   parseFieldsFromXDataObject(e, t) {
-    Object.keys(t).forEach((n) => {
-      e.hasOwnProperty(n) ? this[n] = e[n] : this[n] = t[n];
+    Object.keys(t).forEach((r) => {
+      e.hasOwnProperty(r) ? this[r] = e[r] : this[r] = t[r];
     });
   }
   /**
@@ -1210,12 +1468,12 @@ const U = {
    * @param checkNonXParams - also check non Xpell fields (fields that not starting with "_" sign)
    */
   parseFields(e, t, s) {
-    t.forEach((n) => {
-      if (e.hasOwnProperty(n))
-        this[n] = e[n];
-      else if (s && n.startsWith("_")) {
-        const r = n.substring(1);
-        e.hasOwnProperty(r) && (this[n] = e[r], this[r] = e[r]);
+    t.forEach((r) => {
+      if (e.hasOwnProperty(r))
+        this[r] = e[r];
+      else if (s && r.startsWith("_")) {
+        const n = r.substring(1);
+        e.hasOwnProperty(n) && (this[r] = e[n], this[n] = e[n]);
       }
     });
   }
@@ -1233,41 +1491,91 @@ const U = {
     this._on_create ? this.checkAndRunInternalFunction(this._on_create) : this._on && this._on.create ? this.checkAndRunInternalFunction(this._on.create) : this._once && this._once.create && this.checkAndRunInternalFunction(this._once.create);
   }
   async runCmd(e) {
-    const t = e instanceof R ? e : new R(e);
+    const t = e instanceof N ? e : new N(e);
     await this.execute(t);
   }
   async checkAndRunInternalFunction(e, ...t) {
     const s = (i, c) => {
       const a = c.split(".");
       let _ = i;
-      for (const h of a) {
+      for (const l of a) {
         if (_ == null) return;
-        _ = _[h];
+        _ = _[l];
       }
       return _;
-    }, n = (i, c) => {
-      if (typeof i == "string")
-        return i === "$prev" ? c : i.startsWith("$prev.") ? s(c, i.slice(6)) : i === "$event" ? t[0] : i.startsWith("$event.") ? s(t[0], i.slice(7)) : i === "$data" ? t[0] : i.startsWith("$data.") ? s(t[0], i.slice(6)) : i;
+    }, r = (i, c, a) => {
+      if (typeof i == "string") {
+        if (i === "$prev") return c;
+        if (i.startsWith("$prev."))
+          return s(
+            c,
+            i.slice(6)
+          );
+        if (i === "$event") return t[0];
+        if (i.startsWith("$event."))
+          return s(
+            t[0],
+            i.slice(7)
+          );
+        if (i === "$data") return t[0];
+        if (i.startsWith("$data."))
+          return s(
+            t[0],
+            i.slice(6)
+          );
+        if (i.startsWith("$xdata:") || i.startsWith("$xdata.")) {
+          const l = (i.startsWith("$xdata:"), i.slice(7)).split(".");
+          for (let d = l.length; d > 0; d--) {
+            const y = l.slice(0, d).join(".");
+            if (v.has(y)) {
+              const g = v.get(y), w = l.slice(d).join(".");
+              return w ? u.get_path(g, w) : g;
+            }
+          }
+          return;
+        }
+        if (i.startsWith("$") && a && typeof a == "object") {
+          const _ = i.slice(1), l = _.indexOf("."), d = l === -1 ? _ : _.slice(0, l), y = l === -1 ? "" : _.slice(l + 1);
+          if (Object.prototype.hasOwnProperty.call(
+            a,
+            d
+          )) {
+            const g = a[d];
+            return y ? s(g, y) : g;
+          }
+        }
+        return i;
+      }
       if (Array.isArray(i))
-        return i.map((a) => n(a, c));
+        return i.map(
+          (_) => r(
+            _,
+            c,
+            a
+          )
+        );
       if (i && typeof i == "object") {
-        const a = {};
-        for (const _ of Object.keys(i))
-          a[_] = n(i[_], c);
-        return a;
+        const _ = {};
+        for (const l of Object.keys(i))
+          _[l] = r(
+            i[l],
+            c,
+            a
+          );
+        return _;
       }
       return i;
-    }, r = async (i, c) => {
+    }, n = async (i, c) => {
       if (Array.isArray(i)) {
         let a;
         for (const _ of i)
-          a = await r(_, a);
+          a = await n(_, a);
         return a;
       }
       if (typeof i == "function")
         return await i(this, ...t);
       if (typeof i == "string") {
-        const a = w.parseObjectCommand(
+        const a = O.parseObjectCommand(
           `${this._id} ${i}`
         );
         if (t.length > 0) {
@@ -1278,72 +1586,73 @@ const U = {
         return await this.execute(a);
       }
       if (i && typeof i == "object" && Array.isArray(i._commands)) {
-        const a = i, _ = typeof a._mode == "string" ? a._mode : "sequence", h = a._stop_on_error !== !1, p = a._commands;
+        const a = i, _ = typeof a._mode == "string" ? a._mode : "sequence", l = a._stop_on_error !== !1, d = a._commands;
         if (_ === "parallel") {
-          const j = await Promise.allSettled(
-            p.map(
-              (P) => r(P, c)
+          const g = await Promise.allSettled(
+            d.map(
+              (M) => n(M, c)
             )
-          ), S = j.find(
-            (P) => P.status === "rejected"
+          ), w = g.find(
+            (M) => M.status === "rejected"
           );
-          if (S && h)
-            throw S.reason;
-          return j;
+          if (w && l)
+            throw w.reason;
+          return g;
         }
-        let x = c;
-        for (const j of p)
+        let y = c;
+        for (const g of d)
           try {
-            x = await r(
-              j,
-              _ === "chain" ? x : c
+            y = await n(
+              g,
+              _ === "chain" ? y : c
             );
-          } catch (S) {
-            if (l.error(
+          } catch (w) {
+            if (h.error(
               this._type + "->" + this._id + "] command sequence failed",
-              S
-            ), h)
-              throw S;
+              w
+            ), l)
+              throw w;
           }
-        return x;
+        return y;
       }
       if (i && typeof i == "object" && i._op) {
         const a = i;
         if ((a._object === void 0 || a._object === null || a._object === "this" ? this._id : a._object) !== this._id) {
-          l.error(
+          h.error(
             "XObject JSON handler target not supported; expected _object omitted/'this'/" + this._id
           );
           return;
         }
-        const h = {
+        const l = {
           ...a,
           _params: a._params ? { ...a._params } : {}
         };
         if (t.length > 0) {
-          const p = t[0];
+          const d = t[0];
           Object.prototype.hasOwnProperty.call(
-            h._params,
+            l._params,
             "data"
-          ) || (h._params.data = p), Object.prototype.hasOwnProperty.call(
-            h._params,
+          ) || (l._params.data = d), Object.prototype.hasOwnProperty.call(
+            l._params,
             "_event"
-          ) || (h._params._event = p);
+          ) || (l._params._event = d);
         }
-        return h._params = n(
-          h._params,
-          c
-        ), this._debug && l.log(
+        return l._params = r(
+          l._params,
+          c,
+          this._context
+        ), this._debug && h.log(
           this._type + "->" + this._id + "]",
           "JSON handler executed locally",
-          h
-        ), await this.execute(h);
+          l
+        ), await this.execute(l);
       }
-      l.error(
+      h.error(
         this._type + "->" + this._id + "] invalid handler in checkAndRunInternalFunction",
         i
       );
     };
-    return await r(e);
+    return await n(e);
   }
   /**
    * Triggers when the object is being mounted to other element
@@ -1365,7 +1674,7 @@ const U = {
     const e = this._data_source;
     if (typeof e != "string" || e.length === 0) return;
     const t = this._type ?? this.constructor.name, s = this._id ?? "no-id";
-    D.delete(e, { source: `${t}#${s}.emptyDataSource` });
+    v.delete(e, { source: `${t}#${s}.emptyDataSource` });
   }
   /**
    * Triggers when new data is being received from the data source
@@ -1406,7 +1715,7 @@ const U = {
    * @param cache - cache last command to prevent multiple parsing on the same command
    */
   async run(e, t = !0) {
-    let s = this._cache_cmd_txt && this._cache_cmd_txt == e ? this._cache_jcmd : w.parseObjectCommand(e);
+    let s = this._cache_cmd_txt && this._cache_cmd_txt == e ? this._cache_jcmd : O.parseObjectCommand(e);
     t && (this._cache_cmd_txt = e, this._cache_jcmd = s), await this.execute(s);
   }
   /**
@@ -1423,40 +1732,40 @@ const U = {
   async execute(e) {
     const t = e?._op, s = typeof t == "string" && t.startsWith("_") && t.length > 1 ? t.slice(1) : t;
     if (!s) {
-      l.error(this._id + " missing _op in command");
+      h.error(this._id + " missing _op in command");
       return;
     }
-    const n = e?._module;
-    if (n)
+    const r = e?._module;
+    if (r)
       try {
         return await oe().execute({
           ...e,
-          _module: n,
+          _module: r,
           _op: s
         });
-      } catch (r) {
-        l.error(
-          this._id + " module execution failed: " + n + "." + s + " " + r
+      } catch (n) {
+        h.error(
+          this._id + " module execution failed: " + r + "." + s + " " + n
         );
         return;
       }
     if (this._nano_commands[s])
       try {
-        const r = {
+        const n = {
           ...e,
           _op: s
         };
         return await this._nano_commands[s](
-          r,
+          n,
           this
         );
-      } catch (r) {
-        l.error(
-          this._id + " has error with command name " + s + " " + r
+      } catch (n) {
+        h.error(
+          this._id + " has error with command name " + s + " " + n
         );
         return;
       }
-    l.error(this._id + " has no command name " + s);
+    h.error(this._id + " has no command name " + s);
   }
   /**
    * Return an IXObjectData JSON representation of the XObject
@@ -1470,11 +1779,11 @@ const U = {
         if (typeof s == "function")
           return;
         if (typeof s == "object") {
-          const n = Object.keys(this._xporter._instance_xporters);
-          let r = !0;
-          n.forEach((i) => {
-            this._xporter._instance_xporters[i], s instanceof this._xporter._instance_xporters[i].cls && (e[t] = this._xporter._instance_xporters[i].handler(s), r = !1);
-          }), r && (e[t] = s);
+          const r = Object.keys(this._xporter._instance_xporters);
+          let n = !0;
+          r.forEach((i) => {
+            this._xporter._instance_xporters[i], s instanceof this._xporter._instance_xporters[i].cls && (e[t] = this._xporter._instance_xporters[i].handler(s), n = !1);
+          }), n && (e[t] = s);
         } else
           e[t] = s;
       }
@@ -1495,10 +1804,10 @@ const U = {
     });
   }
   bindDataSource(e, t) {
-    const s = t?.initial ?? !0, n = e ?? this._data_source;
-    typeof n != "string" || n.length === 0 || this._process_data && (this._xd_bound_key === n && this._xd_unsub || (this.unbindDataSource(), this._data_source = n, this._xd_bound_key = n, this._type ?? this.constructor.name, this._id, this._xd_unsub = D.on(n, async (r) => {
-      await this.onData(r.value);
-    }), s && D.has(n) && this.onData(D.get(n))));
+    const s = t?.initial ?? !0, r = e ?? this._data_source;
+    typeof r != "string" || r.length === 0 || this._process_data && (this._xd_bound_key === r && this._xd_unsub || (this.unbindDataSource(), this._data_source = r, this._xd_bound_key = r, this._type ?? this.constructor.name, this._id, this._xd_unsub = v.on(r, async (n) => {
+      await this.onData(n.value);
+    }), s && v.has(r) && this.onData(v.get(r))));
   }
   unbindDataSource() {
     this._xd_unsub?.(), this._xd_unsub = void 0, this._xd_bound_key = void 0;
@@ -1536,8 +1845,8 @@ const U = {
     this.append(e);
   }
 };
-X._xtype = "object", X._skill = U;
-let C = X;
+A._xtype = "object", A._skill = U;
+let C = A;
 class me {
   /**
    * Get all registered object in this ObjectPack
@@ -1549,7 +1858,7 @@ class me {
     };
   }
 }
-const ae = "engine:module:num-of-objects:", q = {
+const ae = "engine:module:num-of-objects:", W = {
   _id: "xmodule",
   _title: "XModule Runtime Contract",
   _version: "1.0.0",
@@ -1564,14 +1873,14 @@ const ae = "engine:module:num-of-objects:", q = {
     "Do not mutate another module's objects directly."
   ]
 };
-var d;
-const M = class M {
+var p;
+const I = class I {
   constructor(e) {
-    V(this, d);
+    J(this, p);
     this._loaded = !1, this._loading = !1, this._log_rules = {
       createObject: !1,
       removeObject: !1
-    }, z(this, d, new ne()), this._name = e._name, this._id = u.guid();
+    }, V(this, p, new re()), this._name = e._name, this._id = u.guid();
   }
   static getOwnSkillBase() {
     return {
@@ -1579,7 +1888,7 @@ const M = class M {
     };
   }
   getOwnSkill() {
-    const t = this.constructor._skill ?? q;
+    const t = this.constructor._skill ?? W;
     return {
       ...t,
       _exports: {
@@ -1600,23 +1909,23 @@ const M = class M {
   }
   getObjectSkills() {
     const e = [], t = /* @__PURE__ */ new Set();
-    for (const s of Object.values(f(this, d).getObjectClasses())) {
+    for (const s of Object.values(f(this, p).getObjectClasses())) {
       if (typeof s.getOwnSkill != "function") continue;
-      const n = s.getOwnSkill();
-      n?._id && (t.has(n._id) || (t.add(n._id), e.push(n)));
+      const r = s.getOwnSkill();
+      r?._id && (t.has(r._id) || (t.add(r._id), e.push(r)));
     }
     return e;
   }
   getCommandSkills() {
     const e = Object.getPrototypeOf(this), s = this.constructor._ops ?? {};
     return Object.getOwnPropertyNames(e).filter(
-      (n) => n.startsWith("_") && !n.startsWith("__") && typeof this[n] == "function"
-    ).map((n) => {
-      const r = n.slice(1).replaceAll("_", "-");
-      return s[r] ?? {
-        _name: r,
+      (r) => r.startsWith("_") && !r.startsWith("__") && typeof this[r] == "function"
+    ).map((r) => {
+      const n = r.slice(1).replaceAll("_", "-");
+      return s[n] ?? {
+        _name: n,
         _scope: "module",
-        _description: `Runtime module command: ${r}`
+        _description: `Runtime module command: ${n}`
       };
     });
   }
@@ -1624,7 +1933,7 @@ const M = class M {
     if (!(this._loaded || this._loading)) {
       this._loading = !0;
       try {
-        await this.onLoad(), this._loaded = !0, l.log("Module " + this._name + " loaded");
+        await this.onLoad(), this._loaded = !0, h.log("Module " + this._name + " loaded");
       } finally {
         this._loading = !1;
       }
@@ -1638,22 +1947,22 @@ const M = class M {
    * @return {XObject|*}
    */
   create(e) {
-    e._debug && l.log("Creating object with data", e);
+    e._debug && h.log("Creating object with data", e);
     let t;
     if (e.hasOwnProperty("_type")) {
-      e._debug && l.log("Object type is", e._type, this.hasObject(e._type) ? "found" : "not found", "in module", this._name);
-      const s = String(e._type), n = f(this, d).getObjectClass(s);
-      if (!n)
+      e._debug && h.log("Object type is", e._type, this.hasObject(e._type) ? "found" : "not found", "in module", this._name);
+      const s = String(e._type), r = f(this, p).getObjectClass(s);
+      if (!r)
         throw `Xpell object '${s}' not found in module '${this._name}'`;
-      typeof n == "function" && n.hasOwnProperty("defaults") && u.mergeDefaultsWithData(
+      typeof r == "function" && r.hasOwnProperty("defaults") && u.mergeDefaultsWithData(
         e,
-        n.defaults
-      ), t = new n(e);
+        r.defaults
+      ), t = new r(e);
     } else
       t = new C(e);
-    return f(this, d).addObject(t), e._children && e._children.forEach((s) => {
-      const n = this.create(s);
-      t.append(n);
+    return f(this, p).addObject(t), e._children && e._children.forEach((s) => {
+      const r = this.create(s);
+      t.append(r);
     }), t.onCreate(), t;
   }
   /**
@@ -1661,15 +1970,15 @@ const M = class M {
    * @param objectId op
    */
   remove(e) {
-    const t = f(this, d).getObject(e);
+    const t = f(this, p).getObject(e);
     if (!t) return;
-    const s = [], n = (r) => {
-      r?._id && (s.push(r._id), (r._children ?? []).forEach((i) => n(i)));
+    const s = [], r = (n) => {
+      n?._id && (s.push(n._id), (n._children ?? []).forEach((i) => r(i)));
     };
-    n(t), typeof t.dispose == "function" && t.dispose(), s.reverse().forEach((r) => f(this, d).removeObject(r));
+    r(t), typeof t.dispose == "function" && t.dispose(), s.reverse().forEach((n) => f(this, p).removeObject(n));
   }
   _info(e) {
-    l.log("module info");
+    h.log("module info");
   }
   //xpell interpreter 
   /**
@@ -1682,7 +1991,7 @@ const M = class M {
     if (e) {
       let t = e.trim();
       t.startsWith(this._name) || (t = this._name + " " + t);
-      let s = w.parse(t);
+      let s = O.parse(t);
       return await this.execute(s);
     } else
       throw "Unable to parse Xpell Command";
@@ -1698,12 +2007,12 @@ const M = class M {
       throw new Error(`Invalid XCommand: missing _op (module: ${this._name})`);
     const t = e._object;
     if (t) {
-      const c = f(this, d).getObject(t);
+      const c = f(this, p).getObject(t);
       if (!c)
         throw new Error(`Module '${this._name}' cant find object id: ${t}`);
       return await c.execute(e);
     }
-    const s = e._op, r = "_" + (s.startsWith("_") && s.length > 1 ? s.slice(1) : s).replaceAll("-", "_"), i = this[r];
+    const s = e._op, n = "_" + (s.startsWith("_") && s.length > 1 ? s.slice(1) : s).replaceAll("-", "_"), i = this[n];
     if (typeof i == "function")
       return await i.call(this, e);
     throw new Error(`Module '${this._name}' cant find op: ${e._op}`);
@@ -1714,10 +2023,10 @@ const M = class M {
    * @param frameNumber Current frame number
    */
   async onFrame(e) {
-    const t = f(this, d)._objects, s = Object.keys(t);
-    s.forEach((n) => {
-      const r = t[n];
-      r && r.onFrame && typeof r.onFrame == "function" && r?.onFrame(e);
+    const t = f(this, p)._objects, s = Object.keys(t);
+    s.forEach((r) => {
+      const n = t[r];
+      n && n.onFrame && typeof n.onFrame == "function" && n?.onFrame(e);
     }), m.set(ae + this._id, s.length, {
       source: "xmodule"
     });
@@ -1733,10 +2042,10 @@ const M = class M {
    * getObject directly on the module instead of om.getObject 
    */
   get om() {
-    return f(this, d);
+    return f(this, p);
   }
   get _object_manager() {
-    return f(this, d);
+    return f(this, p);
   }
   /**
    * Returns the XObject instance from the module Object Manager
@@ -1744,10 +2053,10 @@ const M = class M {
    * @returns XObject
    */
   getObject(e) {
-    return f(this, d).getObject(e);
+    return f(this, p).getObject(e);
   }
   hasObject(e) {
-    return f(this, d).hasObjectClass(e);
+    return f(this, p).hasObjectClass(e);
   }
   /**
    * Returns the XObject instance from the module Object Manager
@@ -1755,7 +2064,7 @@ const M = class M {
    * xmodule._o["object-id"] is equivalent to xmodule.getObject("object-id")
    */
   get _o() {
-    return f(this, d)._objects;
+    return f(this, p)._objects;
   }
   /**
    * Imports external object pack to the engine
@@ -1763,7 +2072,7 @@ const M = class M {
    * @param {XObjects} xObjectPack 
    */
   importObjectPack(e) {
-    f(this, d).registerObjects(e.getObjects());
+    f(this, p).registerObjects(e.getObjects());
   }
   /**
    * Imports external object pack to the engine
@@ -1780,7 +2089,7 @@ const M = class M {
    * @param xObject 
    */
   importObject(e, t) {
-    f(this, d).registerObject(e, t);
+    f(this, p).registerObject(e, t);
   }
   // In XModule
   async _help(e) {
@@ -1800,7 +2109,7 @@ const M = class M {
     };
   }
 };
-d = new WeakMap(), M._skill = q, M._ops = {
+p = new WeakMap(), I._skill = W, I._ops = {
   help: {
     _name: "help",
     _scope: "module",
@@ -1812,7 +2121,7 @@ d = new WeakMap(), M._skill = q, M._ops = {
     _description: "Log basic module information."
   }
 };
-let I = M;
+let F = I;
 const ce = {
   _id: "xdata",
   _title: "XData Runtime State Contract",
@@ -1832,9 +2141,9 @@ const ce = {
     _data_source: "XData key used by XObject/XUIObject for reactive data binding.",
     "$xdata.key": "Runtime payload reference to an XData value."
   }
-}, k = class k extends I {
+}, S = class S extends F {
   constructor() {
-    super({ _name: k._name });
+    super({ _name: S._name });
   }
   async _get(e) {
     const t = u.ensure_params(e?._params), s = u.ensure_string(t.key, "key");
@@ -1845,7 +2154,7 @@ const ce = {
   }
   async _set(e) {
     const t = u.ensure_params(e?._params), s = u.ensure_string(t.key, "key");
-    return t._debug && v.log("XD SET", { key: s, value: t.value }), m.set(s, t.value, {
+    return t._debug && x.log("XD SET", { key: s, value: t.value }), m.set(s, t.value, {
       source: t.source ?? "xd:set"
     }), {
       _ok: !0,
@@ -1888,8 +2197,41 @@ const ce = {
       _result: m.has(s)
     };
   }
+  async _get_path(e) {
+    const t = u.ensure_params(e?._params), s = u.ensure_string(t.key, "key"), r = u.ensure_string(t.path, "path"), n = m.get(s);
+    return {
+      _ok: !0,
+      _result: u.get_path(
+        n,
+        r,
+        t.fallback
+      )
+    };
+  }
+  async _log(e) {
+    const t = u.ensure_params(e?._params), s = u.ensure_string(t.key, "key"), r = m.get(s), n = u.read_optional_string(
+      t.path,
+      "path"
+    ), i = n ? u.get_path(
+      r,
+      n,
+      t.fallback
+    ) : r;
+    return x.log("XDATA LOG", {
+      key: s,
+      path: n,
+      value: i
+    }), {
+      _ok: !0,
+      _result: {
+        key: s,
+        path: n,
+        value: i
+      }
+    };
+  }
 };
-k._name = "xd", k._skill = ce, k._ops = {
+S._name = "xd", S._skill = ce, S._ops = {
   get: {
     _name: "get",
     _scope: "module",
@@ -1943,9 +2285,19 @@ k._name = "xd", k._skill = ce, k._ops = {
     _params: {
       key: "XData key."
     }
+  },
+  get_path: {
+    _name: "get_path",
+    _scope: "module",
+    _description: "Get nested value from an XData value.",
+    _params: {
+      key: "XData key.",
+      path: "Nested path inside the stored value.",
+      fallback: "Optional fallback value."
+    }
   }
 };
-let T = k;
+let q = S;
 const _e = {
   _id: "xem",
   _title: "XEventManager Runtime Event Bus",
@@ -1971,16 +2323,16 @@ const _e = {
     "XEM is process-wide and listener order should not be assumed.",
     "Event payloads should be JSON/data-only."
   ]
-}, O = class O extends I {
+}, D = class D extends F {
   constructor() {
-    super({ _name: O._name });
+    super({ _name: D._name });
   }
   async _fire(e) {
-    const t = u.ensure_params(e?._params), s = u.ensure_string(t.event, "event"), n = t.data;
-    t._debug && v.log("xem fire 🔥 ", s, n), await E().fire(s, n);
+    const t = u.ensure_params(e?._params), s = u.ensure_string(t.event, "event"), r = t.data;
+    t._debug && x.log("xem fire 🔥 ", s, r), await X().fire(s, r);
   }
 };
-O._name = "xem", O._skill = _e, O._ops = {
+D._name = "xem", D._skill = _e, D._ops = {
   fire: {
     _name: "fire",
     _scope: "module",
@@ -2002,51 +2354,51 @@ O._name = "xem", O._skill = _e, O._ops = {
     }
   }
 };
-let W = O;
+let T = D;
 class ge {
   /* -------------------------------------------------- */
   /* core helpers                                       */
   /* -------------------------------------------------- */
   static get(e, t, s) {
-    const r = (e?._params ?? e)?.[t];
-    return r !== void 0 ? r : s;
+    const n = (e?._params ?? e)?.[t];
+    return n !== void 0 ? n : s;
   }
   static has(e, t) {
     return (e?._params ?? e)[t] !== void 0;
   }
   static str(e, ...t) {
     const s = e?._params ?? e;
-    for (const n of t) {
-      const r = s?.[n];
-      if (r != null)
-        return String(r);
+    for (const r of t) {
+      const n = s?.[r];
+      if (n != null)
+        return String(n);
     }
   }
   /* -------------------------------------------------- */
   /* typed params                                       */
   /* -------------------------------------------------- */
   static bool(e, t, s = !1) {
-    const n = e?._params ?? e, r = this.get(n, t, s);
-    if (typeof r == "boolean") return r;
-    if (typeof r == "number") return r !== 0;
-    if (typeof r == "string") {
-      const i = r.toLowerCase();
+    const r = e?._params ?? e, n = this.get(r, t, s);
+    if (typeof n == "boolean") return n;
+    if (typeof n == "number") return n !== 0;
+    if (typeof n == "string") {
+      const i = n.toLowerCase();
       if (["1", "true", "yes", "on"].includes(i)) return !0;
       if (["0", "false", "no", "off"].includes(i)) return !1;
     }
-    return !!r;
+    return !!n;
   }
   static int(e, t, s = 0) {
-    const n = e?._params ?? e, r = this.get(n, t, s), i = parseInt(String(r), 10);
+    const r = e?._params ?? e, n = this.get(r, t, s), i = parseInt(String(n), 10);
     return Number.isFinite(i) ? i : s;
   }
   static json(e, t, s) {
-    const n = e?._params ?? e, r = this.get(n, t, s);
-    if (r == null) return s;
-    if (typeof r == "object") return r;
-    if (typeof r == "string")
+    const r = e?._params ?? e, n = this.get(r, t, s);
+    if (n == null) return s;
+    if (typeof n == "object") return n;
+    if (typeof n == "string")
       try {
-        return JSON.parse(r);
+        return JSON.parse(n);
       } catch {
         return s;
       }
@@ -2076,7 +2428,7 @@ class H extends Error {
     };
   }
 }
-class b {
+class k {
   constructor(e) {
     this._ok = !1, this._ts = Date.now(), this._pt = 0, e && this.setXData(e);
   }
@@ -2084,14 +2436,14 @@ class b {
   // Factories
   // ---------------------------------------------------------------------------
   static create(e) {
-    return new b(e);
+    return new k(e);
   }
   static ok(e) {
-    return new b({ _ok: !0, _result: e });
+    return new k({ _ok: !0, _result: e });
   }
   static error(e) {
     if (e instanceof H)
-      return new b({
+      return new k({
         _ok: !1,
         _result: e.toXData()
       });
@@ -2100,7 +2452,7 @@ class b {
       e?.message ?? String(e),
       { _cause: e }
     );
-    return new b({
+    return new k({
       _ok: !1,
       _result: t.toXData()
     });
@@ -2133,12 +2485,12 @@ class b {
     e && ("_ok" in e && (this._ok = !!e._ok), "_ts" in e && typeof e._ts == "number" && (this._ts = e._ts), "_pt" in e && typeof e._pt == "number" && (this._pt = e._pt), "_result" in e && (this._result = e._result));
   }
 }
-class ye extends b {
+class ye extends k {
   constructor(e) {
-    super(b.error(e).toXData());
+    super(k.error(e).toXData());
   }
 }
-class be extends b {
+class be extends k {
   constructor(e) {
     super({ _ok: !0, _result: e });
   }
@@ -2146,20 +2498,20 @@ class be extends b {
 const le = "engine:frame-number", he = "engine:fps";
 class ue {
   constructor(e) {
-    this._log_rules = {}, this._modules = {}, this._schedule_frame = e?._schedule_frame ?? u.createDefaultScheduler(e?._target_fps), this._version = "0.0.1", this._engine_id = u.guid(), this._frame_number = 0, this._fps_calc = new ee(), this.parser = w, this._modules = {}, l._enabled = !1, ie(this);
+    this._log_rules = {}, this._modules = {}, this._schedule_frame = e?._schedule_frame ?? u.createDefaultScheduler(e?._target_fps), this._version = "0.0.1", this._engine_id = u.guid(), this._frame_number = 0, this._fps_calc = new ee(), this.parser = O, this._modules = {}, h._enabled = !1, ie(this);
   }
   /**
    * @deprecated use _verbose instead
    * Enable Xpell logs to console
    */
   set verbose(e) {
-    l._enabled = e;
+    h._enabled = e;
   }
   /**
    * Enable Xpell logs to console
    */
   set _verbose(e) {
-    l._enabled = e;
+    h._enabled = e;
   }
   /**
    * Logs message to console using Xpell logger
@@ -2169,7 +2521,7 @@ class ue {
    * @param optionalParams
    */
   log(e, ...t) {
-    l.log(e, ...t);
+    h.log(e, ...t);
   }
   /**
    * Delay the execution of the next command
@@ -2186,7 +2538,7 @@ class ue {
    * Use loadModuleAsync() for deterministic startup. 
   */
   addModule(e) {
-    return this._modules.hasOwnProperty(e._name) ? (l.log("Module " + e._name + " already loaded"), !1) : (this._modules[e._name] = e, !0);
+    return this._modules.hasOwnProperty(e._name) ? (h.log("Module " + e._name + " already loaded"), !1) : (this._modules[e._name] = e, !0);
   }
   /**
    * Loads Xpell module into the engine
@@ -2213,7 +2565,7 @@ class ue {
    * Display information about the Xpell engine to the console
    */
   info() {
-    l.log(`Xpell information:
+    h.log(`Xpell information:
 - Engine Id: ` + this._engine_id + `
 - Version ` + this._version);
   }
@@ -2223,7 +2575,7 @@ class ue {
   */
   run(e) {
     if (e?.length > 2) {
-      let t = w.parse(e);
+      let t = O.parse(e);
       return this.execute(t);
     } else
       throw "Unable to parse Xpell command";
@@ -2262,11 +2614,11 @@ class ue {
    * Start Xpell engine for web browsers using requestAnimationFrame
    */
   start() {
-    l.log("Loading Xpell core modules...[xd, xem]"), this.loadModule(new T()), this.loadModule(new W()), l.log("Starting Xpell"), this.onFrame();
+    h.log("Loading Xpell core modules...[xd, xem]"), this.loadModule(new q()), this.loadModule(new T()), h.log("Starting Xpell"), this.onFrame();
   }
   getCoreSkills() {
     return [
-      q,
+      W,
       U
     ];
   }
@@ -2292,36 +2644,36 @@ class ue {
 }
 const we = new ue();
 export {
-  R as XCommand,
+  N as XCommand,
   he as XD_FPS,
   le as XD_FRAME_NUMBER,
-  D as XData,
-  T as XDataModule,
+  v as XData,
+  q as XDataModule,
   H as XError,
-  W as XEventManagerModule,
-  l as XLogger,
-  I as XModule,
+  T as XEventManagerModule,
+  h as XLogger,
+  F as XModule,
   C as XObject,
-  ne as XObjectManager,
+  re as XObjectManager,
   me as XObjectPack,
   ge as XParams,
-  w as XParser,
-  b as XResponse,
+  O as XParser,
+  k as XResponse,
   ye as XResponseError,
   be as XResponseOK,
   Z as XUtils,
   we as Xpell,
   ue as XpellEngine,
   se as _XData,
-  fe as _XEventManager,
+  pe as _XEventManager,
   te as _XLogger,
   Y as _XUtils,
   we as _x,
   m as _xd,
-  l as _xlog,
+  h as _xlog,
   u as _xu,
-  g as createNanoCommandWithSkill,
+  b as createNanoCommandWithSkill,
   we as default,
-  E as getXEventManager,
-  pe as setXEventManager
+  X as getXEventManager,
+  fe as setXEventManager
 };