@xpell/core 2.0.0-alpha.10 → 2.0.0-alpha.11

package/dist/XCommand.d.ts

@@ -42,7 +42,7 @@ export type XCommandData = {
     _object?: string;
     _op: string;
     _params?: {
-        [k: string]: string | number | Function;
+        [k: string]: string | number | boolean | null | object | any[];
     };
 };
 export declare class XCommand {
@@ -62,7 +62,7 @@ export declare class XCommand {
      * command parameters array
      */
     _params?: {
-        [k: string]: string | number | Function;
+        [k: string]: string | number | boolean | null | object | any[];
     };
     /**
      * XCommand create date timestamp

package/dist/XData.d.ts

@@ -48,4 +48,5 @@ export declare class _XData {
 }
 /** Singleton */
 export declare const XData: _XData;
+export declare const _xd: _XData;
 export default XData;

package/dist/XObject.d.ts

@@ -29,7 +29,7 @@ import { XNanoCommandPack, XNanoCommand } from "./XNanoCommands";
 export type wordsList = {
     [k: string]: string;
 };
-export type XValue = string | number | boolean | null | undefined | Function | XValue[] | {
+export type XValue = string | number | boolean | null | undefined | Function | object | any[] | XValue[] | {
     [k: string]: XValue;
 };
 export interface IXData {
@@ -52,6 +52,7 @@ export type XObjectOnEventHandler = (xObject: XObject, data?: any) => void;
 export interface XObjectOnEventIndex {
     [eventName: string]: XObjectOnEventHandler;
 }
+type XObjectHandler = Function | string | XCommandData | XObjectHandler[];
 export type XObjectData = {
     [k: string]: XValue;
     _id?: string;
@@ -61,10 +62,10 @@ export type XObjectData = {
     _data_source?: string;
     _on?: XObjectOnEventIndex;
     _once?: XObjectOnEventIndex;
-    _on_create?: string | Function;
-    _on_mount?: string | Function;
-    _on_frame?: string | Function;
-    _on_data?: string | Function;
+    _on_create?: XObjectHandler;
+    _on_mount?: XObjectHandler;
+    _on_frame?: XObjectHandler;
+    _on_data?: XObjectHandler;
     _process_frame?: boolean;
     _process_data?: boolean;
     _nano_commands?: XNanoCommandPack;
@@ -85,11 +86,11 @@ export declare class XObject {
     _debug?: boolean;
     _on: XObjectOnEventIndex;
     _once: XObjectOnEventIndex;
-    _on_create?: string | Function | undefined;
-    _on_mount?: string | Function | undefined;
-    _on_frame?: string | Function | undefined;
-    _on_data?: string | Function | undefined;
-    _on_event?: string | Function | undefined;
+    _on_create?: XObjectHandler | undefined;
+    _on_mount?: XObjectHandler | undefined;
+    _on_frame?: XObjectHandler | undefined;
+    _on_data?: XObjectHandler | undefined;
+    _on_event?: XObjectHandler | undefined;
     _process_frame: boolean;
     _process_data: boolean;
     protected _xem_options: XEventListenerOptions;
@@ -185,6 +186,7 @@ export declare class XObject {
      *
     */
     onCreate(): Promise<void>;
+    private runCmd;
     protected checkAndRunInternalFunction(func: any, ...params: any): Promise<void>;
     /**
      * Triggers when the object is being mounted to other element

package/dist/Xpell.d.ts

@@ -128,7 +128,7 @@ export declare const Xpell: XpellEngine;
 export default Xpell;
 export { Xpell as _x };
 export { XUtils, XUtils as _xu, _XUtils, type XFrameScheduler } from "./XUtils";
-export { XData, XData as _xd, type XDataStore, _XData } from "./XData";
+export { XData, _xd, type XDataStore, _XData } from "./XData";
 export { XParser } from "./XParser";
 export { XCommand, type XCommandData } from "./XCommand";
 export { XLogger, XLogger as _xlog, _XLogger } from "./XLogger";

package/dist/xpell-core.cjs.js

@@ -1,3 +1,3 @@
-"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});class x{createIgnoreList(t,e){if(!t)return e;const s=t.split(",").map(i=>i.trim()).filter(Boolean);for(const i of s)e[i]="";return e}guid(){const e=globalThis.crypto;if(e&&typeof e.randomUUID=="function")return e.randomUUID();if(e&&typeof e.getRandomValues=="function"){const r=new Uint8Array(16);e.getRandomValues(r),r[6]=r[6]&15|64,r[8]=r[8]&63|128;const a=Array.from(r,_=>_.toString(16).padStart(2,"0"));return a.slice(0,4).join("")+"-"+a.slice(4,6).join("")+"-"+a.slice(6,8).join("")+"-"+a.slice(8,10).join("")+"-"+a.slice(10,16).join("")}const s="0123456789abcdef".split(""),i=[];let n;i[8]=i[13]=i[18]=i[23]="-",i[14]="4";for(let r=0;r<36;r++)i[r]||(n=(0|Math.random()*16)>>>0,i[r]=s[r===19?n&3|8:n&15]);return i.join("")}mergeDefaultsWithData(t,e,s=!1){if(!t)return e;t._id||(t._id=t.id??this.guid());for(const i of Object.keys(e))(!(i in t)||s)&&(t[i]=e[i]);return t}encode(t){const e=globalThis;if(typeof e.btoa=="function"){const s=encodeURIComponent(String(t)).replace(/%([0-9A-F]{2})/g,(i,n)=>String.fromCharCode(parseInt(n,16)));return e.btoa(s)}if(e.Buffer&&typeof e.Buffer.from=="function")return e.Buffer.from(String(t),"utf8").toString("base64");throw new Error("Base64 encode not supported in this environment")}decode(t){const e=globalThis;if(typeof e.atob=="function"){const s=e.atob(String(t)),i=Array.prototype.map.call(s,n=>"%"+n.charCodeAt(0).toString(16).padStart(2,"0")).join("");return decodeURIComponent(i)}if(e.Buffer&&typeof e.Buffer.from=="function")return e.Buffer.from(String(t),"base64").toString("utf8");throw new Error("Base64 decode not supported in this environment")}getRandomInt(t,e){return t=Math.ceil(t),e=Math.floor(e),Math.floor(Math.random()*(e-t+1))+t}getParam(t,e,s=0){return t?._params?.[e]??s}createDefaultScheduler(t){const e=globalThis;if(typeof e.requestAnimationFrame=="function")return n=>e.requestAnimationFrame(n);const s=typeof t=="number"&&isFinite(t)&&t>0?t:60;if(typeof e.setImmediate=="function"&&(!t||t>=60))return n=>e.setImmediate(n);const i=Math.max(1,Math.round(1e3/s));return n=>e.setTimeout(n,i)}}const f=new x;class N{#t=0;#e=0;#s=0;#i;#n;constructor(t=.05,e=1){const s=Number(t);this.#i=Number.isFinite(s)?Math.min(1,Math.max(.001,s)):.05;const i=Number(e);this.#n=Number.isFinite(i)?Math.max(0,Math.floor(i)):1}now(){const t=globalThis.performance;return t&&typeof t.now=="function"?t.now():Date.now()}calc(){const t=this.now();if(this.#s===0)return this.#s=t,this.#t;const e=t-this.#s;if(this.#s=t,!Number.isFinite(e)||e<=0)return this.#t;this.#e===0?this.#e=e:this.#e=(1-this.#i)*this.#e+this.#i*e;const s=1e3/this.#e;if(!Number.isFinite(s)||s<=0)return this.#t;const i=Math.round(s);return this.#t!==0&&this.#n>0&&Math.abs(i-this.#t)<this.#n?this.#t:(this.#t=i,this.#t)}reset(){this.#t=0,this.#e=0,this.#s=0}}class E{constructor(t){this._enabled=!0,this._show_date=!1,this._show_time=!0,this._debug=!1,t&&this.configure(t)}configure(t){typeof t._enabled=="boolean"&&(this._enabled=t._enabled),typeof t._show_date=="boolean"&&(this._show_date=t._show_date),typeof t._show_time=="boolean"&&(this._show_time=t._show_time),typeof t._debug=="boolean"&&(this._debug=t._debug)}_dt(){const t=new Date,e=this._show_date?`${t.getDate()}.${t.getMonth()}.${t.getFullYear()} `:"",s=this._show_time?`${t.getHours()}:${t.getMinutes()}:${t.getSeconds()}.${t.getMilliseconds()}|`:"";return e+s}log(t,...e){this._enabled&&console.log(this._dt(),t,...e)}warn(t,...e){this._enabled&&console.warn(this._dt(),t,...e)}error(t,...e){this._enabled&&console.error(this._dt(),t,...e)}debug(t,...e){!this._enabled||!this._debug||console.debug(this._dt(),t,...e)}}const c=new E,D=typeof process<"u"&&!!process?.env&&process.env.NODE_ENV==="production";D||console.info("[Xpell] _xlog is redirected to console in development mode. Tip: enable 'Show timestamps' in DevTools → Console for timed logs.");const w=D?c:console;class k{constructor(){this._objects={},this._listeners=new Map,this._any_listeners=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={}}get _o(){return!this._compat_writes&&!this._warn_legacy_writes?this._objects:(this._o_proxy||(this._o_proxy=new Proxy(this._objects,{set:(t,e,s)=>{const i=String(e);return this._warn_legacy_writes&&console.warn(`[XData] Legacy write: _o["${i}"] = ... ; prefer XData.set("${i}", value).`),this._compat_writes?this.set(i,s,{source:"legacy:_o"}):t[i]=s,!0},deleteProperty:(t,e)=>{const s=String(e);return this._warn_legacy_writes&&console.warn(`[XData] Legacy delete: delete _o["${s}"] ; prefer XData.delete("${s}").`),this._compat_writes?this.delete(s,{source:"legacy:_o"}):delete t[s],!0}})),this._o_proxy)}get(t){return this._objects[t]}set(t,e,s){const i=this._objects[t];this._objects[t]=e,this._emit({key:t,value:e,prev:i,ts:Date.now(),op:"set",meta:s})}patch(t,e,s){const i=this._objects[t],r={...i&&typeof i=="object"?i:{},...e};this._objects[t]=r,this._emit({key:t,value:r,prev:i,ts:Date.now(),op:"patch",meta:s})}touch(t,e){const s=this._objects[t];this._emit({key:t,value:s,prev:s,ts:Date.now(),op:"touch",meta:e})}has(t){return Object.prototype.hasOwnProperty.call(this._objects,t)}delete(t,e){const s=this._objects[t];delete this._objects[t],this._emit({key:t,value:void 0,prev:s,ts:Date.now(),op:"delete",meta:e})}pick(t,e){const s=this._objects[t];return this.delete(t,e),s}clean(){this._objects={}}on(t,e){let s=this._listeners.get(t);return s||this._listeners.set(t,s=new Set),s.add(e),()=>this.off(t,e)}off(t,e){const s=this._listeners.get(t);s&&(s.delete(e),s.size===0&&this._listeners.delete(t))}onAny(t){return this._any_listeners.add(t),()=>this._any_listeners.delete(t)}_emit(t){this._verbose&&t.meta?.trace&&(t.stack=new Error().stack);const e=this._listeners.get(t.key);if(e)for(const s of e)s(t);for(const s of this._any_listeners)s(t)}}const u=new k;class F{constructor(t){t&&Object.keys(t).forEach(e=>{this[e]=t[e]}),this.d||(this.d=Date.now())}getParam(t,e,s){return this._params?.hasOwnProperty(e)?this._params[e]:this._params?.hasOwnProperty(t)?this._params[t]:s}}const v={type:"_type",children:"_children"},p=class p{static addHtml2XpellMapItem(t,e){p.html2XMap.elements[t]=e}static parse(t,e){const s=t.split(" ");let i=new F;if(e?(i._module=e,i._op=s[0]):(i._module=s[0],i._op=s[1]),i._params={},s.length>1)for(let n=2;n<s.length;++n){const r=s[n];if(r.indexOf(":")>-1){const _=r.split(":");i._params[_[0]]=_[1]}else i._params[n-1]=s[n]}return i}static replaceSpacesInQuotes(t,e="_%20_"){return t.replace(/(['"])(.*?)\1/g,(s,i,n)=>{const r=String(n).replace(/\s/g,e);return`${i}${r}${i}`})}static parseObjectCommand(t,e){t=p.replaceSpacesInQuotes(t);const s=t.trim().split(/\s+/),i=e||s.shift();if(!i)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 r=s.shift();if(!r)throw new Error("Missing operation");const a={};let _=null,h=null;if(s.forEach(l=>{if(h){if(h+=` ${l}`,l.endsWith(h[0])){const b=h.slice(1,-1).replace(/_%20_/g," ");a[_]=b,h=null}return}if(l.startsWith('"')||l.startsWith("'")){if(h=l,l.endsWith(l[0])&&l.length>1){const b=l.slice(1,-1).replace(/_%20_/g," ");a[_]=b,h=null}return}if(l.includes(":")){const b=l.split(":"),$=b[0],R=b.slice(1).join(":").replace(/_%20_/g," ");a[$]=R,_=null;return}_=l.replace(/_%20_/g," ")}),h)throw new Error("Unclosed quoted parameter value");return{_module:i,_object:n,_op:r,_params:a}}static xmlString2Xpell(t){const s=new DOMParser().parseFromString(t,"text/xml");return s.childNodes.length>0?p.xml2Xpell(s.childNodes[0]):{}}static xml2Xpell(t,e){const s=p.html2XMap;let i={};i._children=[];const n=t.nodeName,r=t.nodeName;let a=e;if(e?(i[v.type]="xhtml",i._html_ns="http://www.w3.org/2000/svg"):i._type=s.elements[n]?s.elements[n]:n,t.attributes)for(let _=0;_<t.attributes.length;++_){const h=t.attributes[_],l=s.attributes[h.name]?s.attributes[h.name]:h.name;i[l]=h.value}if(t?.firstChild?.nodeValue&&(i.text=t?.firstChild.nodeValue.trim()),i[v.type]=="xhtml"?i._html_tag=r:i[v.type]=="svg"&&(a=!0,i._html_ns="http://www.w3.org/2000/svg"),t?.childNodes.length>0)for(let _=0;_<t.childNodes.length;++_){const h=t.childNodes[_];h.nodeName.startsWith("#")||i[v.children].push(p.xml2Xpell(h,a))}return i}};p.html2XMap={elements:{div:"view",a:"link",b:"xhtml",h1:"xhtml",h2:"xhtml",h3:"xhtml",h4:"xhtml",h5:"xhtml",p:"xhtml",small:"xhtml",aside:"xhtml",span:"xhtml",table:"xhtml",th:"xhtml",td:"xhtml",tr:"xhtml",thead:"xhtml",tbody:"xhtml",ul:"xhtml",li:"xhtml",ol:"xhtml",canvas:"xhtml",img:"image"},attributes:{id:"_id"}};let m=p;class M{constructor(){this._log_rules={register:!1,remove:!1,fire:!1},this._events={},this._listener_index={}}on(t,e,s={},i){this._events[t]||(this._events[t]=[]);const n=s?._owner??i,r=f.guid(),a={_id:r,_callback:e,_options:s,_owner:n,_tag:s?._tag};return this._events[t].push(a),this._listener_index[r]=t,this._log_rules.register&&w.log("XEM Register",t,r),r}once(t,e,s){return this.on(t,e,{_once:!0,_owner:s})}async fire(t,e){const s=this._events[t];if(!s||s.length===0)return;this._log_rules.fire&&w.log("XEM Fire",t,e);const i=s.slice(),n=[];for(const r of i){try{r&&r._callback&&r._callback(e)}catch(a){w.error(a)}r?._options?._once&&n.push(r._id)}for(const r of n)this.remove(r)}remove(t){const e=this._listener_index[t];if(!e)return;const s=this._events[e];if(s&&s.length){const i=s.findIndex(n=>n?._id===t);i>=0&&s.splice(i,1),s.length===0&&delete this._events[e]}delete this._listener_index[t],this._log_rules.remove&&w.log("XEM Remove",e,t)}removeOwner(t){if(!t)return;const e=[];for(const s of Object.values(this._events))for(const i of s)(i?._owner??i?._options?._owner)===t&&e.push(i._id);e.forEach(s=>this.remove(s))}clear(){this._events={},this._listener_index={}}}const g=new M;class S{#t;#e;#s;constructor(){this.#t={},this.#e={},this.#s={}}get _objects(){return this.#e}hasObject(t){return this.#e.hasOwnProperty(t)}registerObjects(t){Object.keys(t).forEach(s=>this.registerObject(s,t[s]))}registerObject(t,e){this.#t[t]=e}hasObjectClass(t){return this.#t.hasOwnProperty(t)}getObjectClass(t){return this.#t[t]}getAllClasses(){return this.#t}get _classes(){return this.#t}addObject(t){t&&t._id?(this.#e[t._id]=t,(!t._name||t._name.length==0)&&(t._name=t._id),this.#s[t._name]=t._id):c.log("unable to add object")}removeObject(t){const e=this.#e[t];e&&(delete this.#s[e?._name],delete this.#e[t])}getObject(t){return this.#e[t]}go(t){return this.getObject(t)}getObjectByName(t){return this.#s[t]?this.getObject(this.#s[t]):null}}const U={info:(o,t)=>{c.log("XObject id "+t?._id)},log:(o,t)=>{o._params&&o._params[1]?c.log(o._params[1]):c.log(t)},fire:(o,t)=>{o._params&&o._params[1]?g.fire(o._params[1],o._params[2]):o._params&&o._params.event&&g.fire(o._params.event,o._params.data)}},j={_children:"child nodes"};class y{constructor(t,e,s){this._children=[],this._parent=null,this._on={},this._once={},this._process_frame=!0,this._process_data=!0,this._nano_commands={},this._event_listeners_ids={},this._event_parsed=!1,this._mounted=!1,this._xporter={_ignore_fields:["_to_xdata_ignore_fields","_xporter","_children","_on","_once","_on_create","_on_mount","_on_frame","_on_data","_process_frame","_process_data","_parent","_event_listeners_ids","_event_parsed","_mounted","_debug"],_instance_xporters:{}},e&&f.mergeDefaultsWithData(t,e),this._id=t&&t._id?t._id:"xo-"+f.guid(),this._type="object",this._children=[],this._nano_commands={},this.addNanoCommandPack(U),t&&t.hasOwnProperty("_nano_commands")&&t._nano_commands&&(this.addNanoCommandPack(t._nano_commands),delete t._nano_commands),this.addXporterDataIgnoreFields(["_nano_commands"]),this.addXporterInstanceXporter(y,i=>i.toXData()),this._xem_options={},!s&&t&&this.parse(t,j)}log(t,...e){this._debug&&t&&c.log(this._type+"->"+this._id+"]",t,...e)}init(t,e){!e&&t&&this.parse(t,j)}parseEvents(t){if(!this._event_parsed){t||(t=this._xem_options),Object.keys(this._on).forEach(s=>{this.addEventListener(s,this._on[s],t)});const e={};Object.assign(e,t),e._once=!0,Object.keys(this._once).forEach(s=>{this.addEventListener(s,this._once[s],e)}),this._event_parsed=!0}}addEventListener(t,e,s){s||(s=this._xem_options);let i;if(typeof e=="function")i=async r=>{e(this,r)};else if(typeof e=="string")i=async r=>{const a=this._id+" "+e+" event-data='"+JSON.stringify(r).replace(/'/g,"\\'")+"'";await this.run(a)};else throw new Error("event handler must be a function");const n=g.on(t,i,s,this);this._event_listeners_ids[t]||(this._event_listeners_ids[t]=[]),this._event_listeners_ids[t].push(n)}removeEventListener(t){const e=this._event_listeners_ids[t];e&&e.length&&(e.forEach(s=>{g.remove(s)}),delete this._event_listeners_ids[t])}removeAllEventListeners(){Object.keys(this._event_listeners_ids).forEach(e=>this.removeEventListener(e))}append(t){this._children?.push(t),t._parent=this}addNanoCommand(t,e){typeof e=="function"&&(this._nano_commands[t]=e)}addNanoCommandPack(t){t&&Object.keys(t).forEach(e=>{this.addNanoCommand(e,t[e])})}addXporterDataIgnoreFields(t){this._xporter._ignore_fields=this._xporter._ignore_fields.concat(t)}addXporterInstanceXporter(t,e){const s=f.guid();this._xporter._instance_xporters[s]={cls:t,handler:e}}parse(t,e=j){Object.keys(t).forEach(i=>{!e.hasOwnProperty(i)&&t.hasOwnProperty(i)&&(this[i]=t[i])})}parseFieldsFromXDataObject(t,e){Object.keys(e).forEach(i=>{t.hasOwnProperty(i)?this[i]=t[i]:this[i]=e[i]})}parseFields(t,e,s){e.forEach(i=>{if(t.hasOwnProperty(i))this[i]=t[i];else if(s&&i.startsWith("_")){const n=i.substring(1);t.hasOwnProperty(n)&&(this[i]=t[n],this[n]=t[n])}})}async onCreate(){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 checkAndRunInternalFunction(t,...e){if(typeof t=="function")await t(this,...e);else if(typeof t=="string")if(e.length>0){const s=e[0],i=JSON.stringify(s).replace(/'/g,"\\'");await this.run(`${this._id} ${t} data:'${i}'`)}else await this.run(`${this._id} ${t}`)}async onMount(){if(!this._mounted){this.parseEvents(this._xem_options),this._process_data&&typeof this._data_source=="string"&&this._data_source.length>0&&this.bindDataSource(this._data_source,{initial:!0}),this._on_mount?await this.checkAndRunInternalFunction(this._on_mount):this._on&&this._on.mount?await this.checkAndRunInternalFunction(this._on.mount):this._once&&this._once.mount&&await this.checkAndRunInternalFunction(this._once.mount),this._mounted=!0;for(const t of this._children)t.onMount&&typeof t.onMount=="function"&&t.onMount()}}emptyDataSource(){const t=this._data_source;if(typeof t!="string"||t.length===0)return;const e=this._type??this.constructor.name,s=this._id??"no-id";u.delete(t,{source:`${e}#${s}.emptyDataSource`})}async onData(t){this._process_data&&(this._on_data?this.checkAndRunInternalFunction(this._on_data,t):this._on&&this._on.data?this.checkAndRunInternalFunction(this._on.data,t):this._once&&this._once.data&&this.checkAndRunInternalFunction(this._once.data,t))}async onFrame(t){this._process_frame&&(this._on_frame?this.checkAndRunInternalFunction(this._on_frame,t):this._on&&this._on.frame?this.checkAndRunInternalFunction(this._on.frame,t):this._once&&this._once.frame&&this.checkAndRunInternalFunction(this._once.frame,t));for(const e of this._children)e.onFrame&&typeof e.onFrame=="function"&&e.onFrame(t)}async run(t,e=!0){let s=this._cache_cmd_txt&&this._cache_cmd_txt==t?this._cache_jcmd:m.parseObjectCommand(t);e&&(this._cache_cmd_txt=t,this._cache_jcmd=s),await this.execute(s)}async execute(t){if(t._op&&this._nano_commands[t._op])try{await this._nano_commands[t._op](t,this)}catch(e){c.error(this._id+" has error with command name "+t._op+" "+e)}else c.error(this._id+" has no command name "+t._op)}toXData(){const t={};return Object.keys(this).forEach(e=>{if(!this._xporter._ignore_fields.includes(e)&&this.hasOwnProperty(e)&&this[e]!==void 0){const s=this[e];if(typeof s=="function")return;if(typeof s=="object"){const i=Object.keys(this._xporter._instance_xporters);let n=!0;i.forEach(r=>{this._xporter._instance_xporters[r],s instanceof this._xporter._instance_xporters[r].cls&&(t[e]=this._xporter._instance_xporters[r].handler(s),n=!1)}),n&&(t[e]=s)}else t[e]=s}}),t._children=[],this._children.length>0&&this._children.forEach(e=>{typeof e.toXData=="function"&&t._children?.push(e.toXData())}),t}toString(){return JSON.stringify(this.toXData())}clearAttributes(t){t.forEach(e=>{this.hasOwnProperty(e)&&(this[e]=null,delete this[e])})}bindDataSource(t,e){const s=e?.initial??!0,i=t??this._data_source;typeof i!="string"||i.length===0||this._process_data&&(this._xd_bound_key===i&&this._xd_unsub||(this.unbindDataSource(),this._data_source=i,this._xd_bound_key=i,this._type??this.constructor.name,this._id,this._xd_unsub=u.on(i,async n=>{await this.onData(n.value)}),s&&u.has(i)&&this.onData(u.get(i))))}unbindDataSource(){this._xd_unsub?.(),this._xd_unsub=void 0,this._xd_bound_key=void 0}async dispose(){if(this.unbindDataSource(),this._parent){const t=this._parent._children.indexOf(this);t>-1&&this._parent._children.splice(t,1)}this._process_data=!1,this._process_frame=!1,this.removeAllEventListeners(),this.clearAttributes(["_cache_cmd_txt","_cache_jcmd","_nano_commands","_event_listeners_ids","_parent","_on","_once","_xem_options","_xporter"]),this._children&&this._children.forEach(t=>{typeof t.dispose=="function"&&t.dispose()}),this._children=[]}removeChild(t,e=!1){if(e)t.dispose();else{const s=this._children.indexOf(t);s>-1&&this._children.splice(s,1),t._parent=null}}addChild(t){this.append(t)}}class L{static getObjects(){return{object:y}}}const B="engine:module:num-of-objects:";class C{constructor(t){this._log_rules={createObject:!1,removeObject:!1},this.#t=new S,this._name=t._name,this._id=f.guid()}#t;load(){c.log("Module "+this._name+" loaded")}create(t){let e;if(t.hasOwnProperty("_type"))if(this.#t.hasObjectClass(t._type)){let s=this.#t.getObjectClass(t._type);s.hasOwnProperty("defaults")&&f.mergeDefaultsWithData(t,s.defaults),e=new s(t)}else throw"Xpell object '"+t._type+"' not found";else e=new y(t);return this.#t.addObject(e),t._children&&t._children.forEach(s=>{const i=this.create(s);e.append(i)}),e.onCreate(),e}remove(t){const e=this.#t.getObject(t);if(!e)return;const s=[],i=n=>{n?._id&&(s.push(n._id),(n._children??[]).forEach(r=>i(r)))};i(e),typeof e.dispose=="function"&&e.dispose(),s.reverse().forEach(n=>this.#t.removeObject(n))}_info(t){c.log("module info")}async run(t){if(t){let e=t.trim();e.startsWith(this._name)||(e=this._name+" "+e);let s=m.parse(e);return await this.execute(s)}else throw"Unable to parse Xpell Command"}async execute(t){if(!t||!t._op)throw new Error(`Invalid XCommand: missing _op (module: ${this._name})`);const e=t._object;if(e){const n=this.#t.getObject(e);if(!n)throw new Error(`Module '${this._name}' cant find object id: ${e}`);return await n.execute(t)}const s="_"+t._op.replaceAll("-","_"),i=this[s];if(typeof i=="function")return await i.call(this,t);throw new Error(`Module '${this._name}' cant find op: ${t._op}`)}async onFrame(t){const e=this.#t._objects,s=Object.keys(e);s.forEach(i=>{const n=e[i];n&&n.onFrame&&typeof n.onFrame=="function"&&n?.onFrame(t)}),u.set(B+this._id,s.length,{source:"xmodule"})}get om(){return this.#t}get _object_manager(){return this.#t}getObject(t){return this.#t.getObject(t)}get _o(){return this.#t._objects}importObjectPack(t){this.#t.registerObjects(t.getObjects())}importObjects(t){this.importObjectPack(t)}importObject(t,e){this.#t.registerObject(t,e)}async _help(t){const e=t?._params?._op??t?._params?._command??"";return this.help(e)}help(t){return{module:this._name,usage:`${this._name} help`,ops:["help"],note:"No help() implemented for this module."}}}class T{static get(t,e,s){if(!t?._params)return s;const i=t._params[e];return i!==void 0?i:s}static has(t,e){return t?._params&&t._params[e]!==void 0}static str(t,...e){for(const s of e){const i=t?._params?.[s];if(i!=null)return String(i)}}static bool(t,e,s=!1){const i=this.get(t,e,s);if(typeof i=="boolean")return i;if(typeof i=="number")return i!==0;if(typeof i=="string"){const n=i.toLowerCase();if(["1","true","yes","on"].includes(n))return!0;if(["0","false","no","off"].includes(n))return!1}return!!i}static int(t,e,s=0){const i=this.get(t,e,s),n=parseInt(String(i),10);return Number.isFinite(n)?n:s}static json(t,e,s){const i=this.get(t,e,s);if(i==null)return s;if(typeof i=="object")return i;if(typeof i=="string")try{return JSON.parse(i)}catch{return s}return s}}class O extends Error{constructor(t,e,s){super(e),this.name="XError",this._code=t,this._level=s?._level??"error",this._meta=s?._meta,this._cause=s?._cause}toXData(){return{_code:this._code,_level:this._level,_meta:this._meta,_cause:this._cause,name:this.name,message:this.message}}toJSON(){return{...this.toXData(),stack:this.stack}}}class d{constructor(t){this._ok=!1,this._ts=Date.now(),this._pt=0,t&&this.setXData(t)}static create(t){return new d(t)}static ok(t){return new d({_ok:!0,_result:t})}static error(t){if(t instanceof O)return new d({_ok:!1,_result:t.toXData()});const e=new O("E_INTERNAL",t?.message??String(t),{_cause:t});return new d({_ok:!1,_result:e.toXData()})}stopProcessTimeCounter(){this._pt=Date.now()-this._ts}toXData(){return this.stopProcessTimeCounter(),{_ok:this._ok,_ts:this._ts,_pt:this._pt,_result:this._result}}toString(){return JSON.stringify(this.toXData())}setXData(t){t&&("_ok"in t&&(this._ok=!!t._ok),"_ts"in t&&typeof t._ts=="number"&&(this._ts=t._ts),"_pt"in t&&typeof t._pt=="number"&&(this._pt=t._pt),"_result"in t&&(this._result=t._result))}}class W extends d{constructor(t){super(d.error(t).toXData())}}class J extends d{constructor(t){super({_ok:!0,_result:t})}}const I="engine:frame-number",P="engine:fps";class A{constructor(t){this._log_rules={},this._modules={},this._schedule_frame=t?._schedule_frame??f.createDefaultScheduler(t?._target_fps),this._version="0.0.1",this._engine_id=f.guid(),this._frame_number=0,this._fps_calc=new N,this.parser=m,this._modules={},g.fire("xpell-init"),c._enabled=!1}set verbose(t){c._enabled=t}set _verbose(t){c._enabled=t}log(t,...e){c.log(t,...e)}async delay(t){return new Promise(e=>setTimeout(e,t))}loadModule(t){this._modules.hasOwnProperty(t._name)?c.log("Module "+t._name+" already loaded"):(this._modules[t._name]=t,t.load())}loadModules(...t){t.forEach(e=>this.loadModule(e))}info(){c.log(`Xpell information:
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});class k{createIgnoreList(e,t){if(!e)return t;const s=e.split(",").map(i=>i.trim()).filter(Boolean);for(const i of s)t[i]="";return t}guid(){const t=globalThis.crypto;if(t&&typeof t.randomUUID=="function")return t.randomUUID();if(t&&typeof t.getRandomValues=="function"){const r=new Uint8Array(16);t.getRandomValues(r),r[6]=r[6]&15|64,r[8]=r[8]&63|128;const c=Array.from(r,_=>_.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(""),i=[];let n;i[8]=i[13]=i[18]=i[23]="-",i[14]="4";for(let r=0;r<36;r++)i[r]||(n=(0|Math.random()*16)>>>0,i[r]=s[r===19?n&3|8:n&15]);return i.join("")}mergeDefaultsWithData(e,t,s=!1){if(!e)return t;e._id||(e._id=e.id??this.guid());for(const i of Object.keys(t))(!(i in e)||s)&&(e[i]=t[i]);return e}encode(e){const t=globalThis;if(typeof t.btoa=="function"){const s=encodeURIComponent(String(e)).replace(/%([0-9A-F]{2})/g,(i,n)=>String.fromCharCode(parseInt(n,16)));return t.btoa(s)}if(t.Buffer&&typeof t.Buffer.from=="function")return t.Buffer.from(String(e),"utf8").toString("base64");throw new Error("Base64 encode not supported in this environment")}decode(e){const t=globalThis;if(typeof t.atob=="function"){const s=t.atob(String(e)),i=Array.prototype.map.call(s,n=>"%"+n.charCodeAt(0).toString(16).padStart(2,"0")).join("");return decodeURIComponent(i)}if(t.Buffer&&typeof t.Buffer.from=="function")return t.Buffer.from(String(e),"base64").toString("utf8");throw new Error("Base64 decode not supported in this environment")}getRandomInt(e,t){return e=Math.ceil(e),t=Math.floor(t),Math.floor(Math.random()*(t-e+1))+e}getParam(e,t,s=0){return e?._params?.[t]??s}createDefaultScheduler(e){const t=globalThis;if(typeof t.requestAnimationFrame=="function")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 n=>t.setImmediate(n);const i=Math.max(1,Math.round(1e3/s));return n=>t.setTimeout(n,i)}}const f=new k;class L{#e=0;#t=0;#s=0;#i;#n;constructor(e=.05,t=1){const s=Number(e);this.#i=Number.isFinite(s)?Math.min(1,Math.max(.001,s)):.05;const i=Number(t);this.#n=Number.isFinite(i)?Math.max(0,Math.floor(i)):1}now(){const e=globalThis.performance;return e&&typeof e.now=="function"?e.now():Date.now()}calc(){const e=this.now();if(this.#s===0)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.#i)*this.#t+this.#i*t;const s=1e3/this.#t;if(!Number.isFinite(s)||s<=0)return this.#e;const i=Math.round(s);return this.#e!==0&&this.#n>0&&Math.abs(i-this.#e)<this.#n?this.#e:(this.#e=i,this.#e)}reset(){this.#e=0,this.#t=0,this.#s=0}}class F{constructor(e){this._enabled=!0,this._show_date=!1,this._show_time=!0,this._debug=!1,e&&this.configure(e)}configure(e){typeof e._enabled=="boolean"&&(this._enabled=e._enabled),typeof e._show_date=="boolean"&&(this._show_date=e._show_date),typeof e._show_time=="boolean"&&(this._show_time=e._show_time),typeof e._debug=="boolean"&&(this._debug=e._debug)}_dt(){const e=new Date,t=this._show_date?`${e.getDate()}.${e.getMonth()}.${e.getFullYear()} `:"",s=this._show_time?`${e.getHours()}:${e.getMinutes()}:${e.getSeconds()}.${e.getMilliseconds()}|`:"";return t+s}log(e,...t){this._enabled&&console.log(this._dt(),e,...t)}warn(e,...t){this._enabled&&console.warn(this._dt(),e,...t)}error(e,...t){this._enabled&&console.error(this._dt(),e,...t)}debug(e,...t){!this._enabled||!this._debug||console.debug(this._dt(),e,...t)}}const a=new F,S=typeof process<"u"&&!!process?.env&&process.env.NODE_ENV==="production";S||console.info("[Xpell] _xlog is redirected to console in development mode. Tip: enable 'Show timestamps' in DevTools → Console for timed logs.");const w=S?a:console;class M{constructor(){this._objects={},this._listeners=new Map,this._any_listeners=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={}}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 i=String(t);return this._warn_legacy_writes&&console.warn(`[XData] Legacy write: _o["${i}"] = ... ; prefer XData.set("${i}", value).`),this._compat_writes?this.set(i,s,{source:"legacy:_o"}):e[i]=s,!0},deleteProperty:(e,t)=>{const s=String(t);return this._warn_legacy_writes&&console.warn(`[XData] Legacy delete: delete _o["${s}"] ; prefer XData.delete("${s}").`),this._compat_writes?this.delete(s,{source:"legacy:_o"}):delete e[s],!0}})),this._o_proxy)}get(e){return this._objects[e]}set(e,t,s){const i=this._objects[e];this._objects[e]=t,this._emit({key:e,value:t,prev:i,ts:Date.now(),op:"set",meta:s})}patch(e,t,s){const i=this._objects[e],r={...i&&typeof i=="object"?i:{},...t};this._objects[e]=r,this._emit({key:e,value:r,prev:i,ts:Date.now(),op:"patch",meta:s})}touch(e,t){const s=this._objects[e];this._emit({key:e,value:s,prev:s,ts:Date.now(),op:"touch",meta:t})}has(e){return Object.prototype.hasOwnProperty.call(this._objects,e)}delete(e,t){const s=this._objects[e];delete this._objects[e],this._emit({key:e,value:void 0,prev:s,ts:Date.now(),op:"delete",meta:t})}pick(e,t){const s=this._objects[e];return this.delete(e,t),s}clean(){this._objects={}}on(e,t){let s=this._listeners.get(e);return s||this._listeners.set(e,s=new Set),s.add(t),()=>this.off(e,t)}off(e,t){const s=this._listeners.get(e);s&&(s.delete(t),s.size===0&&this._listeners.delete(e))}onAny(e){return this._any_listeners.add(e),()=>this._any_listeners.delete(e)}_emit(e){this._verbose&&e.meta?.trace&&(e.stack=new Error().stack);const t=this._listeners.get(e.key);if(t)for(const s of t)s(e);for(const s of this._any_listeners)s(e)}}const u=new M,P=u;class X{constructor(e){e&&Object.keys(e).forEach(t=>{this[t]=e[t]}),this.d||(this.d=Date.now())}getParam(e,t,s){return this._params?.hasOwnProperty(t)?this._params[t]:this._params?.hasOwnProperty(e)?this._params[e]:s}}const v={type:"_type",children:"_children"},p=class p{static addHtml2XpellMapItem(e,t){p.html2XMap.elements[e]=t}static parse(e,t){const s=e.split(" ");let i=new X;if(t?(i._module=t,i._op=s[0]):(i._module=s[0],i._op=s[1]),i._params={},s.length>1)for(let n=2;n<s.length;++n){const r=s[n];if(r.indexOf(":")>-1){const _=r.split(":");i._params[_[0]]=_[1]}else i._params[n-1]=s[n]}return i}static replaceSpacesInQuotes(e,t="_%20_"){return e.replace(/(['"])(.*?)\1/g,(s,i,n)=>{const r=String(n).replace(/\s/g,t);return`${i}${r}${i}`})}static parseObjectCommand(e,t){e=p.replaceSpacesInQuotes(e);const s=e.trim().split(/\s+/),i=t||s.shift();if(!i)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 r=s.shift();if(!r)throw new Error("Missing operation");const c={};let _=null,h=null;if(s.forEach(l=>{if(h){if(h+=` ${l}`,l.endsWith(h[0])){const b=h.slice(1,-1).replace(/_%20_/g," ");c[_]=b,h=null}return}if(l.startsWith('"')||l.startsWith("'")){if(h=l,l.endsWith(l[0])&&l.length>1){const b=l.slice(1,-1).replace(/_%20_/g," ");c[_]=b,h=null}return}if(l.includes(":")){const b=l.split(":"),U=b[0],C=b.slice(1).join(":").replace(/_%20_/g," ");c[U]=C,_=null;return}_=l.replace(/_%20_/g," ")}),h)throw new Error("Unclosed quoted parameter value");return{_module:i,_object:n,_op:r,_params:c}}static xmlString2Xpell(e){const s=new DOMParser().parseFromString(e,"text/xml");return s.childNodes.length>0?p.xml2Xpell(s.childNodes[0]):{}}static xml2Xpell(e,t){const s=p.html2XMap;let i={};i._children=[];const n=e.nodeName,r=e.nodeName;let c=t;if(t?(i[v.type]="xhtml",i._html_ns="http://www.w3.org/2000/svg"):i._type=s.elements[n]?s.elements[n]:n,e.attributes)for(let _=0;_<e.attributes.length;++_){const h=e.attributes[_],l=s.attributes[h.name]?s.attributes[h.name]:h.name;i[l]=h.value}if(e?.firstChild?.nodeValue&&(i.text=e?.firstChild.nodeValue.trim()),i[v.type]=="xhtml"?i._html_tag=r:i[v.type]=="svg"&&(c=!0,i._html_ns="http://www.w3.org/2000/svg"),e?.childNodes.length>0)for(let _=0;_<e.childNodes.length;++_){const h=e.childNodes[_];h.nodeName.startsWith("#")||i[v.children].push(p.xml2Xpell(h,c))}return i}};p.html2XMap={elements:{div:"view",a:"link",b:"xhtml",h1:"xhtml",h2:"xhtml",h3:"xhtml",h4:"xhtml",h5:"xhtml",p:"xhtml",small:"xhtml",aside:"xhtml",span:"xhtml",table:"xhtml",th:"xhtml",td:"xhtml",tr:"xhtml",thead:"xhtml",tbody:"xhtml",ul:"xhtml",li:"xhtml",ol:"xhtml",canvas:"xhtml",img:"image"},attributes:{id:"_id"}};let m=p;class I{constructor(){this._log_rules={register:!1,remove:!1,fire:!1},this._events={},this._listener_index={}}on(e,t,s={},i){this._events[e]||(this._events[e]=[]);const n=s?._owner??i,r=f.guid(),c={_id:r,_callback:t,_options:s,_owner:n,_tag:s?._tag};return this._events[e].push(c),this._listener_index[r]=e,this._log_rules.register&&w.log("XEM Register",e,r),r}once(e,t,s){return this.on(e,t,{_once:!0,_owner:s})}async fire(e,t){const s=this._events[e];if(!s||s.length===0)return;this._log_rules.fire&&w.log("XEM Fire",e,t);const i=s.slice(),n=[];for(const r of i){try{r&&r._callback&&r._callback(t)}catch(c){w.error(c)}r?._options?._once&&n.push(r._id)}for(const r of n)this.remove(r)}remove(e){const t=this._listener_index[e];if(!t)return;const s=this._events[t];if(s&&s.length){const i=s.findIndex(n=>n?._id===e);i>=0&&s.splice(i,1),s.length===0&&delete this._events[t]}delete this._listener_index[e],this._log_rules.remove&&w.log("XEM Remove",t,e)}removeOwner(e){if(!e)return;const t=[];for(const s of Object.values(this._events))for(const i of s)(i?._owner??i?._options?._owner)===e&&t.push(i._id);t.forEach(s=>this.remove(s))}clear(){this._events={},this._listener_index={}}}const g=new I;class A{#e;#t;#s;constructor(){this.#e={},this.#t={},this.#s={}}get _objects(){return this.#t}hasObject(e){return this.#t.hasOwnProperty(e)}registerObjects(e){Object.keys(e).forEach(s=>this.registerObject(s,e[s]))}registerObject(e,t){this.#e[e]=t}hasObjectClass(e){return this.#e.hasOwnProperty(e)}getObjectClass(e){return this.#e[e]}getAllClasses(){return this.#e}get _classes(){return this.#e}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):a.log("unable to add object")}removeObject(e){const t=this.#t[e];t&&(delete this.#s[t?._name],delete this.#t[e])}getObject(e){return this.#t[e]}go(e){return this.getObject(e)}getObjectByName(e){return this.#s[e]?this.getObject(this.#s[e]):null}}const T=["_nano_commands","_cache_cmd_txt","_cache_jcmd","_xporter","_event_listeners_ids","_parent","_children"];function j(o){return T.includes(o)}function x(o){if(!o||typeof o!="object"||Array.isArray(o))return!1;const e=Object.getPrototypeOf(o);return e===Object.prototype||e===null}const B={info:(o,e)=>{a.log("XObject id "+e?._id)},log:(o,e)=>{o._params&&o._params[1]?a.log(o._params[1]):a.log(e)},fire:(o,e)=>{o._params&&o._params[1]?g.fire(o._params[1],o._params[2]):o._params&&o._params.event&&g.fire(o._params.event,o._params.data)},noop:()=>{},"set-field":(o,e)=>{const t=o._params?.name,s=o._params?.value;if(!(!e||typeof t!="string"||t.length===0)){if(j(t)){a.error(`set-field denied for protected field: ${t}`);return}e[t]=s}},"delete-field":(o,e)=>{const t=o._params?.name;if(!(!e||typeof t!="string"||t.length===0)){if(j(t)){a.error(`delete-field denied for protected field: ${t}`);return}delete e[t]}},"toggle-field":(o,e)=>{const t=o._params?.name;if(!e||typeof t!="string"||t.length===0)return;if(j(t)){a.error(`toggle-field denied for protected field: ${t}`);return}const s=e[t];typeof s=="boolean"?e[t]=!s:s==null?e[t]=!0:e[t]=!1},merge:(o,e)=>{const t=o._params?.name,s=o._params?.value;if(!e||typeof t!="string"||t.length===0)return;if(j(t)){a.error(`merge denied for protected field: ${t}`);return}if(!x(s)){a.error("merge expects _params.value as a plain object");return}const i=e[t];x(i)||(e[t]={}),Object.assign(e[t],s)},"run-seq":async(o,e)=>{if(!e)return;const t=o._params?.seq;if(!Array.isArray(t)){a.error("run-seq expects _params.seq as an array");return}for(const s of t){if(typeof s=="string"){await e.run(`${e._id} ${s}`);continue}if(s&&typeof s=="object"&&s._op){const i=s._object;if(!(i==null||i==="this"||i===e._id)){a.error("run-seq rejected non-self _object target");return}const r={_op:s._op,_params:s._params?{...s._params}:void 0};await e.execute(r);continue}a.error("run-seq skipped invalid step; expected string or object with _op")}}},O={_children:"child nodes"};class y{constructor(e,t,s){this._children=[],this._parent=null,this._on={},this._once={},this._process_frame=!0,this._process_data=!0,this._nano_commands={},this._event_listeners_ids={},this._event_parsed=!1,this._mounted=!1,this._xporter={_ignore_fields:["_to_xdata_ignore_fields","_xporter","_children","_on","_once","_on_create","_on_mount","_on_frame","_on_data","_process_frame","_process_data","_parent","_event_listeners_ids","_event_parsed","_mounted","_debug"],_instance_xporters:{}},t&&f.mergeDefaultsWithData(e,t),this._id=e&&e._id?e._id:"xo-"+f.guid(),this._type="object",this._children=[],this._nano_commands={},this.addNanoCommandPack(B),e&&e.hasOwnProperty("_nano_commands")&&e._nano_commands&&(this.addNanoCommandPack(e._nano_commands),delete e._nano_commands),this.addXporterDataIgnoreFields(["_nano_commands"]),this.addXporterInstanceXporter(y,i=>i.toXData()),this._xem_options={},!s&&e&&this.parse(e,O)}log(e,...t){this._debug&&e&&a.log(this._type+"->"+this._id+"]",e,...t)}init(e,t){!t&&e&&this.parse(e,O)}parseEvents(e){if(!this._event_parsed){e||(e=this._xem_options),Object.keys(this._on).forEach(s=>{this.addEventListener(s,this._on[s],e)});const t={};Object.assign(t,e),t._once=!0,Object.keys(this._once).forEach(s=>{this.addEventListener(s,this._once[s],t)}),this._event_parsed=!0}}addEventListener(e,t,s){s||(s=this._xem_options);let i;if(typeof t=="function")i=async r=>{t(this,r)};else if(typeof t=="string")i=async r=>{const c=this._id+" "+t+" event-data='"+JSON.stringify(r).replace(/'/g,"\\'")+"'";await this.run(c)};else throw new Error("event handler must be a function");const n=g.on(e,i,s,this);this._event_listeners_ids[e]||(this._event_listeners_ids[e]=[]),this._event_listeners_ids[e].push(n)}removeEventListener(e){const t=this._event_listeners_ids[e];t&&t.length&&(t.forEach(s=>{g.remove(s)}),delete this._event_listeners_ids[e])}removeAllEventListeners(){Object.keys(this._event_listeners_ids).forEach(t=>this.removeEventListener(t))}append(e){this._children?.push(e),e._parent=this}addNanoCommand(e,t){typeof t=="function"&&(this._nano_commands[e]=t)}addNanoCommandPack(e){e&&Object.keys(e).forEach(t=>{this.addNanoCommand(t,e[t])})}addXporterDataIgnoreFields(e){this._xporter._ignore_fields=this._xporter._ignore_fields.concat(e)}addXporterInstanceXporter(e,t){const s=f.guid();this._xporter._instance_xporters[s]={cls:e,handler:t}}parse(e,t=O){Object.keys(e).forEach(i=>{!t.hasOwnProperty(i)&&e.hasOwnProperty(i)&&(this[i]=e[i])})}parseFieldsFromXDataObject(e,t){Object.keys(t).forEach(i=>{e.hasOwnProperty(i)?this[i]=e[i]:this[i]=t[i]})}parseFields(e,t,s){t.forEach(i=>{if(e.hasOwnProperty(i))this[i]=e[i];else if(s&&i.startsWith("_")){const n=i.substring(1);e.hasOwnProperty(n)&&(this[i]=e[n],this[n]=e[n])}})}async onCreate(){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 X?e:new X(e);await this.execute(t)}async checkAndRunInternalFunction(e,...t){if(Array.isArray(e)){for(const s of e)await this.checkAndRunInternalFunction(s,...t);return}if(typeof e=="function"){await e(this,...t);return}if(typeof e=="string"){if(t.length>0){const s=t[0],i=JSON.stringify(s).replace(/'/g,"\\'");await this.run(`${this._id} ${e} data:'${i}'`)}else await this.run(`${this._id} ${e}`);return}if(e&&typeof e=="object"&&e._op){const s=e;if((s._object===void 0||s._object===null||s._object==="this"?this._id:s._object)!==this._id){a.error("XObject JSON handler target not supported in core-only patch; expected _object omitted/'this'/"+this._id);return}const n={_op:s._op,_params:s._params?{...s._params}:void 0};t.length>0&&(n._params||(n._params={}),Object.prototype.hasOwnProperty.call(n._params,"data")||(n._params.data=t[0])),this._debug&&a.log(this._type+"->"+this._id+"]","JSON handler executed locally",n),await this.execute(n);return}}async onMount(){if(!this._mounted){this.parseEvents(this._xem_options),this._process_data&&typeof this._data_source=="string"&&this._data_source.length>0&&this.bindDataSource(this._data_source,{initial:!0}),this._on_mount?await this.checkAndRunInternalFunction(this._on_mount):this._on&&this._on.mount?await this.checkAndRunInternalFunction(this._on.mount):this._once&&this._once.mount&&await this.checkAndRunInternalFunction(this._once.mount),this._mounted=!0;for(const e of this._children)e.onMount&&typeof e.onMount=="function"&&e.onMount()}}emptyDataSource(){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";u.delete(e,{source:`${t}#${s}.emptyDataSource`})}async onData(e){this._process_data&&(this._on_data?this.checkAndRunInternalFunction(this._on_data,e):this._on&&this._on.data?this.checkAndRunInternalFunction(this._on.data,e):this._once&&this._once.data&&this.checkAndRunInternalFunction(this._once.data,e))}async onFrame(e){this._process_frame&&(this._on_frame?this.checkAndRunInternalFunction(this._on_frame,e):this._on&&this._on.frame?this.checkAndRunInternalFunction(this._on.frame,e):this._once&&this._once.frame&&this.checkAndRunInternalFunction(this._once.frame,e));for(const t of this._children)t.onFrame&&typeof t.onFrame=="function"&&t.onFrame(e)}async run(e,t=!0){let s=this._cache_cmd_txt&&this._cache_cmd_txt==e?this._cache_jcmd:m.parseObjectCommand(e);t&&(this._cache_cmd_txt=e,this._cache_jcmd=s),await this.execute(s)}async execute(e){if(e._op&&this._nano_commands[e._op])try{await this._nano_commands[e._op](e,this)}catch(t){a.error(this._id+" has error with command name "+e._op+" "+t)}else a.error(this._id+" has no command name "+e._op)}toXData(){const e={};return Object.keys(this).forEach(t=>{if(!this._xporter._ignore_fields.includes(t)&&this.hasOwnProperty(t)&&this[t]!==void 0){const s=this[t];if(typeof s=="function")return;if(typeof s=="object"){const i=Object.keys(this._xporter._instance_xporters);let n=!0;i.forEach(r=>{this._xporter._instance_xporters[r],s instanceof this._xporter._instance_xporters[r].cls&&(e[t]=this._xporter._instance_xporters[r].handler(s),n=!1)}),n&&(e[t]=s)}else e[t]=s}}),e._children=[],this._children.length>0&&this._children.forEach(t=>{typeof t.toXData=="function"&&e._children?.push(t.toXData())}),e}toString(){return JSON.stringify(this.toXData())}clearAttributes(e){e.forEach(t=>{this.hasOwnProperty(t)&&(this[t]=null,delete this[t])})}bindDataSource(e,t){const s=t?.initial??!0,i=e??this._data_source;typeof i!="string"||i.length===0||this._process_data&&(this._xd_bound_key===i&&this._xd_unsub||(this.unbindDataSource(),this._data_source=i,this._xd_bound_key=i,this._type??this.constructor.name,this._id,this._xd_unsub=u.on(i,async n=>{await this.onData(n.value)}),s&&u.has(i)&&this.onData(u.get(i))))}unbindDataSource(){this._xd_unsub?.(),this._xd_unsub=void 0,this._xd_bound_key=void 0}async dispose(){if(this.unbindDataSource(),this._parent){const e=this._parent._children.indexOf(this);e>-1&&this._parent._children.splice(e,1)}this._process_data=!1,this._process_frame=!1,this.removeAllEventListeners(),this.clearAttributes(["_cache_cmd_txt","_cache_jcmd","_nano_commands","_event_listeners_ids","_parent","_on","_once","_xem_options","_xporter"]),this._children&&this._children.forEach(e=>{typeof e.dispose=="function"&&e.dispose()}),this._children=[]}removeChild(e,t=!1){if(t)e.dispose();else{const s=this._children.indexOf(e);s>-1&&this._children.splice(s,1),e._parent=null}}addChild(e){this.append(e)}}class W{static getObjects(){return{object:y}}}const q="engine:module:num-of-objects:";class J{constructor(e){this._log_rules={createObject:!1,removeObject:!1},this.#e=new A,this._name=e._name,this._id=f.guid()}#e;load(){a.log("Module "+this._name+" loaded")}create(e){let t;if(e.hasOwnProperty("_type"))if(this.#e.hasObjectClass(e._type)){let s=this.#e.getObjectClass(e._type);s.hasOwnProperty("defaults")&&f.mergeDefaultsWithData(e,s.defaults),t=new s(e)}else throw"Xpell object '"+e._type+"' not found";else t=new y(e);return this.#e.addObject(t),e._children&&e._children.forEach(s=>{const i=this.create(s);t.append(i)}),t.onCreate(),t}remove(e){const t=this.#e.getObject(e);if(!t)return;const s=[],i=n=>{n?._id&&(s.push(n._id),(n._children??[]).forEach(r=>i(r)))};i(t),typeof t.dispose=="function"&&t.dispose(),s.reverse().forEach(n=>this.#e.removeObject(n))}_info(e){a.log("module info")}async run(e){if(e){let t=e.trim();t.startsWith(this._name)||(t=this._name+" "+t);let s=m.parse(t);return await this.execute(s)}else throw"Unable to parse Xpell Command"}async execute(e){if(!e||!e._op)throw new Error(`Invalid XCommand: missing _op (module: ${this._name})`);const t=e._object;if(t){const n=this.#e.getObject(t);if(!n)throw new Error(`Module '${this._name}' cant find object id: ${t}`);return await n.execute(e)}const s="_"+e._op.replaceAll("-","_"),i=this[s];if(typeof i=="function")return await i.call(this,e);throw new Error(`Module '${this._name}' cant find op: ${e._op}`)}async onFrame(e){const t=this.#e._objects,s=Object.keys(t);s.forEach(i=>{const n=t[i];n&&n.onFrame&&typeof n.onFrame=="function"&&n?.onFrame(e)}),P.set(q+this._id,s.length,{source:"xmodule"})}get om(){return this.#e}get _object_manager(){return this.#e}getObject(e){return this.#e.getObject(e)}get _o(){return this.#e._objects}importObjectPack(e){this.#e.registerObjects(e.getObjects())}importObjects(e){this.importObjectPack(e)}importObject(e,t){this.#e.registerObject(e,t)}async _help(e){const t=e?._params?._op??e?._params?._command??"";return this.help(t)}help(e){return{module:this._name,usage:`${this._name} help`,ops:["help"],note:"No help() implemented for this module."}}}class V{static get(e,t,s){if(!e?._params)return s;const i=e._params[t];return i!==void 0?i:s}static has(e,t){return e?._params&&e._params[t]!==void 0}static str(e,...t){for(const s of t){const i=e?._params?.[s];if(i!=null)return String(i)}}static bool(e,t,s=!1){const i=this.get(e,t,s);if(typeof i=="boolean")return i;if(typeof i=="number")return i!==0;if(typeof i=="string"){const n=i.toLowerCase();if(["1","true","yes","on"].includes(n))return!0;if(["0","false","no","off"].includes(n))return!1}return!!i}static int(e,t,s=0){const i=this.get(e,t,s),n=parseInt(String(i),10);return Number.isFinite(n)?n:s}static json(e,t,s){const i=this.get(e,t,s);if(i==null)return s;if(typeof i=="object")return i;if(typeof i=="string")try{return JSON.parse(i)}catch{return s}return s}}class E extends Error{constructor(e,t,s){super(t),this.name="XError",this._code=e,this._level=s?._level??"error",this._meta=s?._meta,this._cause=s?._cause}toXData(){return{_code:this._code,_level:this._level,_meta:this._meta,_cause:this._cause,name:this.name,message:this.message}}toJSON(){return{...this.toXData(),stack:this.stack}}}class d{constructor(e){this._ok=!1,this._ts=Date.now(),this._pt=0,e&&this.setXData(e)}static create(e){return new d(e)}static ok(e){return new d({_ok:!0,_result:e})}static error(e){if(e instanceof E)return new d({_ok:!1,_result:e.toXData()});const t=new E("E_INTERNAL",e?.message??String(e),{_cause:e});return new d({_ok:!1,_result:t.toXData()})}stopProcessTimeCounter(){this._pt=Date.now()-this._ts}toXData(){return this.stopProcessTimeCounter(),{_ok:this._ok,_ts:this._ts,_pt:this._pt,_result:this._result}}toString(){return JSON.stringify(this.toXData())}setXData(e){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 H extends d{constructor(e){super(d.error(e).toXData())}}class K extends d{constructor(e){super({_ok:!0,_result:e})}}const $="engine:frame-number",R="engine:fps";class N{constructor(e){this._log_rules={},this._modules={},this._schedule_frame=e?._schedule_frame??f.createDefaultScheduler(e?._target_fps),this._version="0.0.1",this._engine_id=f.guid(),this._frame_number=0,this._fps_calc=new L,this.parser=m,this._modules={},g.fire("xpell-init"),a._enabled=!1}set verbose(e){a._enabled=e}set _verbose(e){a._enabled=e}log(e,...t){a.log(e,...t)}async delay(e){return new Promise(t=>setTimeout(t,e))}loadModule(e){this._modules.hasOwnProperty(e._name)?a.log("Module "+e._name+" already loaded"):(this._modules[e._name]=e,e.load())}loadModules(...e){e.forEach(t=>this.loadModule(t))}info(){a.log(`Xpell information:
 - Engine Id: `+this._engine_id+`
-- Version `+this._version)}run(t){if(t?.length>2){let e=m.parse(t);return this.execute(e)}else throw"Unable to parse Xpell command"}execute(t){if(t&&t._module&&this._modules[t._module])return this._modules[t._module].execute(t);throw"Xpell module "+t._module+" not loaded"}onFrame(){this._frame_number++;for(const e of Object.keys(this._modules)){const s=this._modules[e];s?.onFrame&&typeof s.onFrame=="function"&&s.onFrame(this._frame_number)}const t=this._fps_calc.calc();u.set(I,this._frame_number,{source:"engine"}),u.set(P,t,{source:"engine"}),u._compat_legacy_keys&&(u.set("frame-number",this._frame_number,{source:"engine:legacy"}),u.set("fps",t,{source:"engine:legacy"})),this._schedule_frame(()=>this.onFrame())}getModule(t){return this._modules[t]}start(){c.log("Starting Xpell"),this.onFrame()}getParam(t,e){return t in u._o?u._o[t]:e}}const X=new A;exports.XCommand=F;exports.XD_FPS=P;exports.XD_FRAME_NUMBER=I;exports.XData=u;exports.XError=O;exports.XEventManager=g;exports.XLogger=c;exports.XModule=C;exports.XObject=y;exports.XObjectManager=S;exports.XObjectPack=L;exports.XParams=T;exports.XParser=m;exports.XResponse=d;exports.XResponseError=W;exports.XResponseOK=J;exports.XUtils=f;exports.Xpell=X;exports.XpellEngine=A;exports._XData=k;exports._XEventManager=M;exports._XLogger=E;exports._XUtils=x;exports._x=X;exports._xd=u;exports._xem=g;exports._xlog=c;exports._xu=f;exports.default=X;
+- Version `+this._version)}run(e){if(e?.length>2){let t=m.parse(e);return this.execute(t)}else throw"Unable to parse Xpell command"}execute(e){if(e&&e._module&&this._modules[e._module])return this._modules[e._module].execute(e);throw"Xpell module "+e._module+" not loaded"}onFrame(){this._frame_number++;for(const t of Object.keys(this._modules)){const s=this._modules[t];s?.onFrame&&typeof s.onFrame=="function"&&s.onFrame(this._frame_number)}const e=this._fps_calc.calc();u.set($,this._frame_number,{source:"engine"}),u.set(R,e,{source:"engine"}),u._compat_legacy_keys&&(u.set("frame-number",this._frame_number,{source:"engine:legacy"}),u.set("fps",e,{source:"engine:legacy"})),this._schedule_frame(()=>this.onFrame())}getModule(e){return this._modules[e]}start(){a.log("Starting Xpell"),this.onFrame()}getParam(e,t){return e in u._o?u._o[e]:t}}const D=new N;exports.XCommand=X;exports.XD_FPS=R;exports.XD_FRAME_NUMBER=$;exports.XData=u;exports.XError=E;exports.XEventManager=g;exports.XLogger=a;exports.XModule=J;exports.XObject=y;exports.XObjectManager=A;exports.XObjectPack=W;exports.XParams=V;exports.XParser=m;exports.XResponse=d;exports.XResponseError=H;exports.XResponseOK=K;exports.XUtils=f;exports.Xpell=D;exports.XpellEngine=N;exports._XData=M;exports._XEventManager=I;exports._XLogger=F;exports._XUtils=k;exports._x=D;exports._xd=P;exports._xem=g;exports._xlog=a;exports._xu=f;exports.default=D;

package/dist/xpell-core.es.js

@@ -1,4 +1,4 @@
-class X {
+class S {
   /**
    * Create ignore list for parser to ignore spell words
    * @param list - comma-separated list of words
@@ -25,8 +25,8 @@ class X {
     if (e && typeof e.getRandomValues == "function") {
       const r = new Uint8Array(16);
       e.getRandomValues(r), r[6] = r[6] & 15 | 64, r[8] = r[8] & 63 | 128;
-      const a = Array.from(r, (c) => c.toString(16).padStart(2, "0"));
-      return a.slice(0, 4).join("") + "-" + a.slice(4, 6).join("") + "-" + a.slice(6, 8).join("") + "-" + a.slice(8, 10).join("") + "-" + a.slice(10, 16).join("");
+      const c = Array.from(r, (_) => _.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(""), i = [];
     let n;
@@ -106,8 +106,8 @@ class X {
     return (n) => e.setTimeout(n, i);
   }
 }
-const p = new X();
-class k {
+const p = new S();
+class M {
   #t = 0;
   // displayed fps (stable)
   #e = 0;
@@ -143,7 +143,7 @@ class k {
     this.#t = 0, this.#e = 0, this.#s = 0;
   }
 }
-class F {
+class I {
   constructor(t) {
     this._enabled = !0, this._show_date = !1, this._show_time = !0, this._debug = !1, t && this.configure(t);
   }
@@ -167,12 +167,12 @@ class F {
     !this._enabled || !this._debug || console.debug(this._dt(), t, ...e);
   }
 }
-const _ = new F(), x = typeof process < "u" && !!process?.env && process.env.NODE_ENV === "production";
-x || console.info(
+const a = new I(), X = typeof process < "u" && !!process?.env && process.env.NODE_ENV === "production";
+X || console.info(
   "[Xpell] _xlog is redirected to console in development mode. Tip: enable 'Show timestamps' in DevTools → Console for timed logs."
 );
-const y = x ? _ : console;
-class S {
+const y = X ? a : console;
+class A {
   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 = {};
   }
@@ -254,8 +254,8 @@ class S {
     for (const s of this._any_listeners) s(t);
   }
 }
-const u = new S();
-class M {
+const u = new A(), P = u;
+class x {
   constructor(t) {
     t && Object.keys(t).forEach((e) => {
       this[e] = t[e];
@@ -293,13 +293,13 @@ const w = {
    */
   static parse(t, e) {
     const s = t.split(" ");
-    let i = new M();
+    let i = new x();
     if (e ? (i._module = e, i._op = s[0]) : (i._module = s[0], i._op = s[1]), i._params = {}, s.length > 1)
       for (let n = 2; n < s.length; ++n) {
         const r = s[n];
         if (r.indexOf(":") > -1) {
-          const c = r.split(":");
-          i._params[c[0]] = c[1];
+          const _ = r.split(":");
+          i._params[_[0]] = _[1];
         } else
           i._params[n - 1] = s[n];
       }
@@ -320,35 +320,35 @@ const w = {
       throw new Error("Invalid object selector '#'. Use '#<id>'");
     const r = s.shift();
     if (!r) throw new Error("Missing operation");
-    const a = {};
-    let c = null, h = null;
+    const c = {};
+    let _ = null, h = null;
     if (s.forEach((l) => {
       if (h) {
         if (h += ` ${l}`, l.endsWith(h[0])) {
           const m = h.slice(1, -1).replace(/_%20_/g, " ");
-          a[c] = m, h = null;
+          c[_] = m, h = null;
         }
         return;
       }
       if (l.startsWith('"') || l.startsWith("'")) {
         if (h = l, l.endsWith(l[0]) && l.length > 1) {
           const m = l.slice(1, -1).replace(/_%20_/g, " ");
-          a[c] = m, h = null;
+          c[_] = m, h = null;
         }
         return;
       }
       if (l.includes(":")) {
-        const m = l.split(":"), D = m[0], E = m.slice(1).join(":").replace(/_%20_/g, " ");
-        a[D] = E, c = null;
+        const m = l.split(":"), k = m[0], F = m.slice(1).join(":").replace(/_%20_/g, " ");
+        c[k] = F, _ = null;
         return;
       }
-      c = l.replace(/_%20_/g, " ");
+      _ = l.replace(/_%20_/g, " ");
     }), h) throw new Error("Unclosed quoted parameter value");
     return {
       _module: i,
       _object: n,
       _op: r,
-      _params: a
+      _params: c
     };
   }
   /**
@@ -371,16 +371,16 @@ const w = {
     let i = {};
     i._children = [];
     const n = t.nodeName, r = t.nodeName;
-    let a = e;
+    let c = e;
     if (e ? (i[w.type] = "xhtml", i._html_ns = "http://www.w3.org/2000/svg") : i._type = s.elements[n] ? s.elements[n] : n, t.attributes)
-      for (let c = 0; c < t.attributes.length; ++c) {
-        const h = t.attributes[c], l = s.attributes[h.name] ? s.attributes[h.name] : h.name;
+      for (let _ = 0; _ < t.attributes.length; ++_) {
+        const h = t.attributes[_], l = s.attributes[h.name] ? s.attributes[h.name] : h.name;
         i[l] = h.value;
       }
-    if (t?.firstChild?.nodeValue && (i.text = t?.firstChild.nodeValue.trim()), i[w.type] == "xhtml" ? i._html_tag = r : i[w.type] == "svg" && (a = !0, i._html_ns = "http://www.w3.org/2000/svg"), t?.childNodes.length > 0)
-      for (let c = 0; c < t.childNodes.length; ++c) {
-        const h = t.childNodes[c];
-        h.nodeName.startsWith("#") || i[w.children].push(f.xml2Xpell(h, a));
+    if (t?.firstChild?.nodeValue && (i.text = t?.firstChild.nodeValue.trim()), i[w.type] == "xhtml" ? i._html_tag = r : i[w.type] == "svg" && (c = !0, i._html_ns = "http://www.w3.org/2000/svg"), t?.childNodes.length > 0)
+      for (let _ = 0; _ < t.childNodes.length; ++_) {
+        const h = t.childNodes[_];
+        h.nodeName.startsWith("#") || i[w.children].push(f.xml2Xpell(h, c));
       }
     return i;
   }
@@ -416,7 +416,7 @@ f.html2XMap = {
   }
 };
 let g = f;
-class I {
+class $ {
   constructor() {
     this._log_rules = {
       register: !1,
@@ -433,14 +433,14 @@ class I {
    */
   on(t, e, s = {}, i) {
     this._events[t] || (this._events[t] = []);
-    const n = s?._owner ?? i, r = p.guid(), a = {
+    const n = s?._owner ?? i, r = p.guid(), c = {
       _id: r,
       _callback: e,
       _options: s,
       _owner: n,
       _tag: s?._tag
     };
-    return this._events[t].push(a), this._listener_index[r] = t, this._log_rules.register && y.log("XEM Register", t, r), r;
+    return this._events[t].push(c), this._listener_index[r] = t, this._log_rules.register && y.log("XEM Register", t, r), r;
   }
   /**
    * Register a listener that will be removed after first fire.
@@ -459,8 +459,8 @@ class I {
     for (const r of i) {
       try {
         r && r._callback && r._callback(e);
-      } catch (a) {
-        y.error(a);
+      } catch (c) {
+        y.error(c);
       }
       r?._options?._once && n.push(r._id);
     }
@@ -497,8 +497,8 @@ class I {
     this._events = {}, this._listener_index = {};
   }
 }
-const b = new I();
-class P {
+const b = new $();
+class R {
   #t;
   #e;
   #s;
@@ -562,7 +562,7 @@ class P {
    * @param xObject XObject to maintain
    */
   addObject(t) {
-    t && t._id ? (this.#e[t._id] = t, (!t._name || t._name.length == 0) && (t._name = t._id), this.#s[t._name] = t._id) : _.log("unable to add object");
+    t && t._id ? (this.#e[t._id] = t, (!t._name || t._name.length == 0) && (t._name = t._id), this.#s[t._name] = t._id) : a.log("unable to add object");
   }
   /**
    * Remove XObject from the manager 
@@ -597,18 +597,115 @@ class P {
     return this.#s[t] ? this.getObject(this.#s[t]) : null;
   }
 }
-const A = {
+const N = [
+  "_nano_commands",
+  "_cache_cmd_txt",
+  "_cache_jcmd",
+  "_xporter",
+  "_event_listeners_ids",
+  "_parent",
+  "_children"
+];
+function v(o) {
+  return N.includes(o);
+}
+function D(o) {
+  if (!o || typeof o != "object" || Array.isArray(o)) return !1;
+  const t = Object.getPrototypeOf(o);
+  return t === Object.prototype || t === null;
+}
+const C = {
   info: (o, t) => {
-    _.log("XObject id " + t?._id);
+    a.log("XObject id " + t?._id);
   },
   log: (o, t) => {
-    o._params && o._params[1] ? _.log(o._params[1]) : _.log(t);
+    o._params && o._params[1] ? a.log(o._params[1]) : a.log(t);
   },
   fire: (o, t) => {
     o._params && o._params[1] ? b.fire(o._params[1], o._params[2]) : o._params && o._params.event && b.fire(o._params.event, o._params.data);
+  },
+  // no-op utility command for sequence placeholders and explicit "do nothing" steps.
+  noop: () => {
+  },
+  // set a runtime field directly on the object.
+  "set-field": (o, t) => {
+    const e = o._params?.name, s = o._params?.value;
+    if (!(!t || typeof e != "string" || e.length === 0)) {
+      if (v(e)) {
+        a.error(`set-field denied for protected field: ${e}`);
+        return;
+      }
+      t[e] = s;
+    }
+  },
+  // delete a runtime field from the object.
+  "delete-field": (o, t) => {
+    const e = o._params?.name;
+    if (!(!t || typeof e != "string" || e.length === 0)) {
+      if (v(e)) {
+        a.error(`delete-field denied for protected field: ${e}`);
+        return;
+      }
+      delete t[e];
+    }
+  },
+  // toggle a field with boolean-first semantics.
+  "toggle-field": (o, t) => {
+    const e = o._params?.name;
+    if (!t || typeof e != "string" || e.length === 0) return;
+    if (v(e)) {
+      a.error(`toggle-field denied for protected field: ${e}`);
+      return;
+    }
+    const s = t[e];
+    typeof s == "boolean" ? t[e] = !s : s == null ? t[e] = !0 : t[e] = !1;
+  },
+  // shallow-merge a plain object into a target object field.
+  merge: (o, t) => {
+    const e = o._params?.name, s = o._params?.value;
+    if (!t || typeof e != "string" || e.length === 0) return;
+    if (v(e)) {
+      a.error(`merge denied for protected field: ${e}`);
+      return;
+    }
+    if (!D(s)) {
+      a.error("merge expects _params.value as a plain object");
+      return;
+    }
+    const i = t[e];
+    D(i) || (t[e] = {}), Object.assign(t[e], s);
+  },
+  // run a sequence of steps in strict order (await each).
+  "run-seq": async (o, t) => {
+    if (!t) return;
+    const e = o._params?.seq;
+    if (!Array.isArray(e)) {
+      a.error("run-seq expects _params.seq as an array");
+      return;
+    }
+    for (const s of e) {
+      if (typeof s == "string") {
+        await t.run(`${t._id} ${s}`);
+        continue;
+      }
+      if (s && typeof s == "object" && s._op) {
+        const i = s._object;
+        if (!(i == null || i === "this" || i === t._id)) {
+          a.error("run-seq rejected non-self _object target");
+          return;
+        }
+        const r = {
+          _op: s._op,
+          _params: s._params ? { ...s._params } : void 0
+        };
+        await t.execute(r);
+        continue;
+      }
+      a.error("run-seq skipped invalid step; expected string or object with _op");
+    }
   }
-}, j = { _children: "child nodes" };
-class v {
+}, O = { _children: "child nodes" };
+class j {
   /**
    * XObject constructor is creating the object and adding all the data keys to the XObject instance
    * @param data constructor input data (object)
@@ -637,14 +734,14 @@ class v {
         "_debug"
       ],
       _instance_xporters: {}
-    }, e && p.mergeDefaultsWithData(t, e), this._id = t && t._id ? t._id : "xo-" + p.guid(), this._type = "object", this._children = [], this._nano_commands = {}, this.addNanoCommandPack(A), t && t.hasOwnProperty("_nano_commands") && t._nano_commands && (this.addNanoCommandPack(t._nano_commands), delete t._nano_commands), this.addXporterDataIgnoreFields(["_nano_commands"]), this.addXporterInstanceXporter(v, (i) => i.toXData()), this._xem_options = {
+    }, e && p.mergeDefaultsWithData(t, e), this._id = t && t._id ? t._id : "xo-" + p.guid(), this._type = "object", this._children = [], this._nano_commands = {}, this.addNanoCommandPack(C), t && t.hasOwnProperty("_nano_commands") && t._nano_commands && (this.addNanoCommandPack(t._nano_commands), delete t._nano_commands), this.addXporterDataIgnoreFields(["_nano_commands"]), this.addXporterInstanceXporter(j, (i) => i.toXData()), this._xem_options = {
       // _instance:_xem
       // _object: this
       // _support_html: true
-    }, !s && t && this.parse(t, j);
+    }, !s && t && this.parse(t, O);
   }
   log(t, ...e) {
-    this._debug && t && _.log(this._type + "->" + this._id + "]", t, ...e);
+    this._debug && t && a.log(this._type + "->" + this._id + "]", t, ...e);
   }
   /**
    * Initialize the XObject
@@ -653,7 +750,7 @@ class v {
    * @deprecated - use parse method instead
    */
   init(t, e) {
-    !e && t && this.parse(t, j);
+    !e && t && this.parse(t, O);
   }
   parseEvents(t) {
     if (!this._event_parsed) {
@@ -675,8 +772,8 @@ class v {
       };
     else if (typeof e == "string")
       i = async (r) => {
-        const a = this._id + " " + e + " event-data='" + JSON.stringify(r).replace(/'/g, "\\'") + "'";
-        await this.run(a);
+        const c = this._id + " " + e + " event-data='" + JSON.stringify(r).replace(/'/g, "\\'") + "'";
+        await this.run(c);
       };
     else
       throw new Error("event handler must be a function");
@@ -735,7 +832,7 @@ class v {
    * @param data data to parse
    * @param ignore - lis of words to ignore in the parse process
    */
-  parse(t, e = j) {
+  parse(t, e = O) {
     Object.keys(t).forEach((i) => {
       !e.hasOwnProperty(i) && t.hasOwnProperty(i) && (this[i] = t[i]);
     });
@@ -784,15 +881,43 @@ class v {
   async onCreate() {
     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(t) {
+    const e = t instanceof x ? t : new x(t);
+    await this.execute(e);
+  }
   async checkAndRunInternalFunction(t, ...e) {
-    if (typeof t == "function")
+    if (Array.isArray(t)) {
+      for (const s of t)
+        await this.checkAndRunInternalFunction(s, ...e);
+      return;
+    }
+    if (typeof t == "function") {
       await t(this, ...e);
-    else if (typeof t == "string")
+      return;
+    }
+    if (typeof t == "string") {
       if (e.length > 0) {
         const s = e[0], i = JSON.stringify(s).replace(/'/g, "\\'");
         await this.run(`${this._id} ${t} data:'${i}'`);
       } else
         await this.run(`${this._id} ${t}`);
+      return;
+    }
+    if (t && typeof t == "object" && t._op) {
+      const s = t;
+      if ((s._object === void 0 || s._object === null || s._object === "this" ? this._id : s._object) !== this._id) {
+        a.error(
+          "XObject JSON handler target not supported in core-only patch; expected _object omitted/'this'/" + this._id
+        );
+        return;
+      }
+      const n = {
+        _op: s._op,
+        _params: s._params ? { ...s._params } : void 0
+      };
+      e.length > 0 && (n._params || (n._params = {}), Object.prototype.hasOwnProperty.call(n._params, "data") || (n._params.data = e[0])), this._debug && a.log(this._type + "->" + this._id + "]", "JSON handler executed locally", n), await this.execute(n);
+      return;
+    }
   }
   /**
    * Triggers when the object is being mounted to other element
@@ -874,10 +999,10 @@ class v {
       try {
         await this._nano_commands[t._op](t, this);
       } catch (e) {
-        _.error(this._id + " has error with command name " + t._op + " " + e);
+        a.error(this._id + " has error with command name " + t._op + " " + e);
       }
     else
-      _.error(this._id + " has no command name " + t._op);
+      a.error(this._id + " has no command name " + t._op);
   }
   /**
    * Return an IXObjectData JSON representation of the XObject
@@ -957,29 +1082,29 @@ class v {
     this.append(t);
   }
 }
-class B {
+class W {
   /**
    * Get all registered object in this ObjectPack
    * @returns XObject dictionary
    */
   static getObjects() {
     return {
-      object: v
+      object: j
     };
   }
 }
-const $ = "engine:module:num-of-objects:";
-class C {
+const T = "engine:module:num-of-objects:";
+class q {
   //engine: any;  //deprecated remove after spell3d
   constructor(t) {
     this._log_rules = {
       createObject: !1,
       removeObject: !1
-    }, this.#t = new P(), this._name = t._name, this._id = p.guid();
+    }, this.#t = new R(), this._name = t._name, this._id = p.guid();
   }
   #t;
   load() {
-    _.log("Module " + this._name + " loaded");
+    a.log("Module " + this._name + " loaded");
   }
   /**
    * Creates new XObject from data object
@@ -995,7 +1120,7 @@ class C {
       } else
         throw "Xpell object '" + t._type + "' not found";
     else
-      e = new v(t);
+      e = new j(t);
     return this.#t.addObject(e), t._children && t._children.forEach((s) => {
       const i = this.create(s);
       e.append(i);
@@ -1014,7 +1139,7 @@ class C {
     i(e), typeof e.dispose == "function" && e.dispose(), s.reverse().forEach((n) => this.#t.removeObject(n));
   }
   _info(t) {
-    _.log("module info");
+    a.log("module info");
   }
   //xpell interpreter 
   /**
@@ -1063,7 +1188,7 @@ class C {
     s.forEach((i) => {
       const n = e[i];
       n && n.onFrame && typeof n.onFrame == "function" && n?.onFrame(t);
-    }), u.set($ + this._id, s.length, {
+    }), P.set(T + this._id, s.length, {
       source: "xmodule"
     });
   }
@@ -1142,7 +1267,7 @@ class C {
     };
   }
 }
-class L {
+class J {
   /* -------------------------------------------------- */
   /* core helpers                                       */
   /* -------------------------------------------------- */
@@ -1192,7 +1317,7 @@ class L {
     return s;
   }
 }
-class O extends Error {
+class E extends Error {
   constructor(t, e, s) {
     super(e), this.name = "XError", this._code = t, this._level = s?._level ?? "error", this._meta = s?._meta, this._cause = s?._cause;
   }
@@ -1229,12 +1354,12 @@ class d {
     return new d({ _ok: !0, _result: t });
   }
   static error(t) {
-    if (t instanceof O)
+    if (t instanceof E)
       return new d({
         _ok: !1,
         _result: t.toXData()
       });
-    const e = new O(
+    const e = new E(
       "E_INTERNAL",
       t?.message ?? String(t),
       { _cause: t }
@@ -1272,33 +1397,33 @@ class d {
     t && ("_ok" in t && (this._ok = !!t._ok), "_ts" in t && typeof t._ts == "number" && (this._ts = t._ts), "_pt" in t && typeof t._pt == "number" && (this._pt = t._pt), "_result" in t && (this._result = t._result));
   }
 }
-class T extends d {
+class V extends d {
   constructor(t) {
     super(d.error(t).toXData());
   }
 }
-class W extends d {
+class H extends d {
   constructor(t) {
     super({ _ok: !0, _result: t });
   }
 }
-const R = "engine:frame-number", N = "engine:fps";
-class U {
+const U = "engine:frame-number", B = "engine:fps";
+class L {
   constructor(t) {
-    this._log_rules = {}, this._modules = {}, this._schedule_frame = t?._schedule_frame ?? p.createDefaultScheduler(t?._target_fps), this._version = "0.0.1", this._engine_id = p.guid(), this._frame_number = 0, this._fps_calc = new k(), this.parser = g, this._modules = {}, b.fire("xpell-init"), _._enabled = !1;
+    this._log_rules = {}, this._modules = {}, this._schedule_frame = t?._schedule_frame ?? p.createDefaultScheduler(t?._target_fps), this._version = "0.0.1", this._engine_id = p.guid(), this._frame_number = 0, this._fps_calc = new M(), this.parser = g, this._modules = {}, b.fire("xpell-init"), a._enabled = !1;
   }
   /**
    * @deprecated use _verbose instead
    * Enable Xpell logs to console
    */
   set verbose(t) {
-    _._enabled = t;
+    a._enabled = t;
   }
   /**
    * Enable Xpell logs to console
    */
   set _verbose(t) {
-    _._enabled = t;
+    a._enabled = t;
   }
   /**
    * Logs message to console using Xpell logger
@@ -1308,7 +1433,7 @@ class U {
    * @param optionalParams
    */
   log(t, ...e) {
-    _.log(t, ...e);
+    a.log(t, ...e);
   }
   /**
    * Delay the execution of the next command
@@ -1323,7 +1448,7 @@ class U {
    * @param {XModule} xModule 
    */
   loadModule(t) {
-    this._modules.hasOwnProperty(t._name) ? _.log("Module " + t._name + " already loaded") : (this._modules[t._name] = t, t.load());
+    this._modules.hasOwnProperty(t._name) ? a.log("Module " + t._name + " already loaded") : (this._modules[t._name] = t, t.load());
   }
   /**
    * Loads multiple module at ones
@@ -1336,7 +1461,7 @@ class U {
    * Display information about the Xpell engine to the console
    */
   info() {
-    _.log(`Xpell information:
+    a.log(`Xpell information:
 - Engine Id: ` + this._engine_id + `
 - Version ` + this._version);
   }
@@ -1371,7 +1496,7 @@ class U {
       s?.onFrame && typeof s.onFrame == "function" && s.onFrame(this._frame_number);
     }
     const t = this._fps_calc.calc();
-    u.set(R, this._frame_number, { source: "engine" }), u.set(N, t, { source: "engine" }), u._compat_legacy_keys && (u.set("frame-number", this._frame_number, { source: "engine:legacy" }), u.set("fps", t, { source: "engine:legacy" })), this._schedule_frame(() => this.onFrame());
+    u.set(U, this._frame_number, { source: "engine" }), u.set(B, t, { source: "engine" }), u._compat_legacy_keys && (u.set("frame-number", this._frame_number, { source: "engine:legacy" }), u.set("fps", t, { source: "engine:legacy" })), this._schedule_frame(() => this.onFrame());
   }
   /**
    * Gets Xpell module by name
@@ -1385,7 +1510,7 @@ class U {
    * Start Xpell engine for web browsers using requestAnimationFrame
    */
   start() {
-    _.log("Starting Xpell"), this.onFrame();
+    a.log("Starting Xpell"), this.onFrame();
   }
   /**
    * deprecated - use XData._o directly
@@ -1394,35 +1519,35 @@ class U {
     return t in u._o ? u._o[t] : e;
   }
 }
-const J = new U();
+const Q = new L();
 export {
-  M as XCommand,
-  N as XD_FPS,
-  R as XD_FRAME_NUMBER,
+  x as XCommand,
+  B as XD_FPS,
+  U as XD_FRAME_NUMBER,
   u as XData,
-  O as XError,
+  E as XError,
   b as XEventManager,
-  _ as XLogger,
-  C as XModule,
-  v as XObject,
-  P as XObjectManager,
-  B as XObjectPack,
-  L as XParams,
+  a as XLogger,
+  q as XModule,
+  j as XObject,
+  R as XObjectManager,
+  W as XObjectPack,
+  J as XParams,
   g as XParser,
   d as XResponse,
-  T as XResponseError,
-  W as XResponseOK,
+  V as XResponseError,
+  H as XResponseOK,
   p as XUtils,
-  J as Xpell,
-  U as XpellEngine,
-  S as _XData,
-  I as _XEventManager,
-  F as _XLogger,
-  X as _XUtils,
-  J as _x,
-  u as _xd,
+  Q as Xpell,
+  L as XpellEngine,
+  A as _XData,
+  $ as _XEventManager,
+  I as _XLogger,
+  S as _XUtils,
+  Q as _x,
+  P as _xd,
   b as _xem,
-  _ as _xlog,
+  a as _xlog,
   p as _xu,
-  J as default
+  Q as default
 };

package/docs/nano-commands2.md

@@ -0,0 +1,457 @@
+# Nano-Commands v2 (JSON + Sequences) — Xpell 2 Contract
+
+This document is the **canonical contract** for how Xpell 2 executes *nano-commands* from:
+- **DB-stored views**
+- **agent edits**
+- **schema-generated UI**
+- **runtime events** (`_on_click`, `_on_data`, `_on_show`, …)
+
+Goal: **data-only intent** instead of JS functions, while keeping execution **small, deterministic, and auditable**.
+
+---
+
+## Why this matters
+
+Historically, handlers were either:
+- **Functions** (powerful, but not serializable / not DB-safe)
+- **String nano-commands** (simple, but awkward for complex parameters)
+
+Xpell 2 upgrades handlers with two capabilities:
+
+1) **JSON Command Handlers** — structured `XCommandData` (pure data)  
+2) **Sequence Handlers** — arrays of handlers executed **in order** (awaited)
+
+This enables **dynamic views** stored in XDB/files and real-time “vibe coding” without embedding code.
+
+---
+
+## Handler formats (what you can put in object JSON)
+
+A “handler” field (e.g. `_on_click`, `_on_show`, `_on_hide`, `_on_data`, `_on_mount`, `_on_frame`) can be:
+
+### A) Function (dev-only)
+Use only in developer-authored object packs.
+
+```ts
+_on_click: async (obj, e) => {
+  // custom code (NOT DB-safe)
+}
+```
+
+### B) String nano-command (legacy / shorthand)
+For simple actions.
+
+```json
+"_on_click": "hide"
+```
+
+### C) JSON command (canonical)
+For DB-stored, agent-editable views.
+
+```json
+"_on_click": { "_op": "hide" }
+```
+
+Or with parameters:
+
+```json
+"_on_click": { "_op": "set-text", "_params": { "text": "ok" } }
+```
+
+### D) Sequence (canonical composition)
+Multi-step flows as data (no scripting language).
+
+```json
+"_on_click": [
+  { "_op": "hide" },
+  { "_op": "set-text", "_params": { "text": "Hidden" } },
+  { "_op": "show" }
+]
+```
+
+**Sequence semantics:**
+- Execute **in order**
+- Each item is **awaited**
+- Default: **abort on thrown error** (consistent with your runtime error logging)
+
+> If you need shared state between steps, use **XData** keys (recommended).
+
+---
+
+## JSON command format (XCommandData)
+
+A JSON command is the canonical runtime intent shape:
+
+```json
+{
+  "_op": "set-text",
+  "_params": { "text": "hello" }
+}
+```
+
+Optional fields (tooling + future evolution):
+
+```json
+{
+  "_module": "xui",
+  "_object": "this",
+  "_op": "hide",
+  "_params": {}
+}
+```
+
+### Important runtime note (today)
+In current Xpell 2 runtime, command resolution is **object-local**:
+- `XObject.execute()` resolves `_op` against nano-command packs registered on the **target object**
+- `_module` is treated as **semantic metadata** (helpful for tools/agents), not required for execution
+
+### `_object` target rule
+- If `_object` is omitted or `"this"`, the target is the **current object** (recommended for DB-stored handlers)
+- Cross-object targeting may be constrained by policy; keep DB handlers **local by default**
+
+---
+
+## Payload injection (passing data/events into JSON handlers)
+
+When a handler is invoked with a payload (e.g. `onData(data)` or click event `e`), the runtime may inject:
+
+- `cmd._params.data = payload` **only if** `data` is not already provided.
+
+This enables structured value passing without JSON-in-string escaping.
+
+Example:
+
+```json
+"_on_data": { "_op": "set-text-from-data", "_params": { "pattern": "FPS: $data" } }
+```
+
+---
+
+## Examples
+
+### 1) XUIObject — simple click hide (string)
+```json
+{
+  "_id": "btn-close",
+  "_type": "button",
+  "_text": "Close",
+  "_on_click": "hide"
+}
+```
+
+### 2) XUIObject — set text on click (JSON)
+```json
+{
+  "_id": "btn-ok",
+  "_type": "button",
+  "_text": "OK",
+  "_on_click": { "_op": "set-text", "_params": { "text": "ok" } }
+}
+```
+
+### 3) XUIObject — hide then show (sequence)
+```json
+{
+  "_id": "panel",
+  "_type": "view",
+  "_on_click": [
+    { "_op": "hide" },
+    { "_op": "show" }
+  ]
+}
+```
+
+### 4) XObject — onData drives UI (sequence)
+```json
+{
+  "_id": "fps-label",
+  "_type": "label",
+  "_data_source": "engine:fps",
+  "_on_data": [
+    { "_op": "set-text-from-data", "_params": { "pattern": "FPS: $data" } }
+  ]
+}
+```
+
+---
+
+## Design rule: no `run-seq` nano command
+
+Xpell 2 **does not** introduce a `run-seq` nano command.
+
+Sequencing is structural at the handler level:
+- handlers may be arrays
+- each item is executed in order
+
+This keeps nano-commands:
+- **atomic**
+- **auditable**
+- **non-scriptable**
+
+---
+
+## Security notes
+
+This upgrade is explicitly designed to avoid “code in DB”:
+
+- ✅ JSON commands are **whitelisted ops** (`_op` on a known nano-command pack)
+- ✅ parameters are **data**, not executable code
+- ✅ runtime can enforce:
+  - allowed ops
+  - allowed targets
+  - capability checks
+  - rate limits
+- ❌ avoid `eval` / `new Function` / code-in-JSON
+
+**Rule:** if a view is stored in DB and editable by an agent, handlers must be **data-only** (no functions).
+
+---
+
+## Recommended next steps (implementation checklist)
+
+1) Ensure `checkAndRunInternalFunction()` supports:
+   - `XCommandData` objects (`{ _op, _params }`)
+   - sequences (arrays of handlers)
+2) Ensure event dispatch sites call:
+   - `checkAndRunInternalFunction(handler, payload)`
+   for non-function handlers as well.
+3) Add capability/allowlist enforcement at the command runner boundary.
+
+---
+
+## Changelog (conceptual)
+
+- **v1:** strings + dev-only functions
+- **v2:** JSON commands + sequences for DB-stored realtime views
+
+
+-- Commands:
+```md
+# Codex Prompt — Xpell Nano Commands (Authoritative List)
+
+Use **nano commands only** for runtime behavior.
+Do NOT emit JavaScript functions for DB-stored views.
+All actions must map to whitelisted nano commands.
+
+---
+
+## @xpell/core — XObject (available on ALL objects)
+
+### info
+Logs the object id.
+```
+
+info
+
+```
+
+### log
+Logs a value or the object itself.
+```
+
+log 'hello'
+log
+
+```
+
+### fire
+Fires a global event via XEventManager.
+```
+
+fire event:'my-event' data:'payload'
+
+```
+
+### set-attr
+Sets a safe attribute on the object instance.
+```
+
+set-attr name:'_name' value:'test'
+
+```
+
+### delete-attr
+Deletes a safe attribute from the object instance.
+```
+
+delete-attr name:'_name'
+
+```
+
+---
+
+## @xpell/ui — XUIObject (UI-only)
+
+### hide
+Hides the UI object.
+```
+
+hide
+
+```
+
+### show
+Shows the UI object.
+```
+
+show
+
+```
+
+### toggle
+Toggles visibility.
+```
+
+toggle
+
+```
+
+### set-text
+Sets text content.
+```
+
+set-text text:'Hello'
+
+```
+
+### set (legacy alias)
+Sets text if `text` param exists.
+```
+
+set text:'Hello'
+
+```
+
+### set-text-from-data
+Sets text from incoming data payload.
+```
+
+set-text-from-data pattern:'Value: $data'
+
+```
+
+### set-text-from-frame
+Sets text from frame counter.
+```
+
+set-text-from-frame pattern:'Frame $data'
+
+```
+
+### add-class
+Adds a CSS class.
+```
+
+add-class class:'active'
+
+```
+
+### remove-class
+Removes a CSS class.
+```
+
+remove-class class:'active'
+
+```
+
+### toggle-class
+Toggles a CSS class.
+```
+
+toggle-class class:'active'
+
+```
+
+### set-style
+Sets an inline style.
+```
+
+set-style name:'color' value:'red'
+
+```
+
+### set-attr
+Sets a DOM attribute.
+```
+
+set-attr name:'aria-label' value:'Close'
+
+```
+
+### remove-attr
+Removes a DOM attribute.
+```
+
+remove-attr name:'aria-label'
+
+```
+
+---
+
+## @xpell/3d — X3DObject (3D-only)
+
+### rotation
+Sets or increments rotation axes.
+```
+
+rotation x:0.1 y:++0.02 z:--0.01
+
+```
+
+### spin
+Applies continuous rotation via on-frame hook.
+```
+
+spin y:0.01
+
+```
+
+### stop
+Stops on-frame behavior.
+```
+
+stop
+
+```
+
+### follow-joystick
+Moves object using joystick data from XData.
+```
+
+follow-joystick
+
+```
+
+### orbit
+Moves object in an orbit.
+```
+
+orbit radius:2 speed:0.02
+
+````
+
+---
+
+## Sequences (native, no extra command)
+
+Multiple nano commands can be executed in order using arrays:
+
+```json
+[
+  { "_op": "hide" },
+  { "_op": "set-text", "_params": { "text": "Hidden" } },
+  { "_op": "show" }
+]
+```
+
+---
+
+## Rules (MANDATORY)
+
+* Prefer **JSON commands** for DB-stored views
+* Use **strings only for trivial actions**
+* Use **arrays instead of `;` or scripting**
+* Never emit `eval`, `new Function`, or inline JS
+* If output is stored → it MUST be data-only
+
+This list is the **single source of truth** for Codex and agents.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpell/core",
-  "version": "2.0.0-alpha.10",
+  "version": "2.0.0-alpha.11",
   "publishConfig": {
     "access": "public"
   },