@raphy-js/raph 1.0.0-dev.2 → 1.0.1-dev.20

package/dist/debug/runtime/RaphNode.cjs

@@ -1 +0,0 @@
-"use strict";var d=Object.defineProperty;var _=(s,i,e)=>i in s?d(s,i,{enumerable:!0,configurable:!0,writable:!0,value:e}):s[i]=e;var n=(s,i,e)=>_(s,typeof i!="symbol"?i+"":i,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("./disposal.cjs"),c=require("./errors.cjs"),m=require("./RaphScope.cjs");let y=0;class h extends m.RaphScope{constructor(e,t={},o){const a=o??(e instanceof h?e.runtime:e??void 0);if(a===void 0)throw new Error("[RaphNode] A root node requires an explicit runtime.");const r=e instanceof h?e:(e==null?void 0:e.root)??null;super(t.id??`node-${y++}`,a);n(this,"priority");n(this,"_parent");n(this,"_children",[]);n(this,"api");n(this,"meta");n(this,"type");if(r!==null&&r.runtime!==a)throw super.dispose(),new c.RaphCrossRuntimeError("[Raph] Parent belongs to another runtime.");try{r==null||r._assertAlive()}catch(p){throw super.dispose(),p}const u=t.priority??0;l(u),this.priority=u,this._parent=r,this.meta={...t.meta},this.type=t.type??"default",this.api=Object.freeze({}),r==null||r._children.push(this)}get parent(){return this._parent}get children(){return this._children}addChild(e){if(this._assertAlive(),e._assertAlive(),e.runtime!==this.runtime)throw new c.RaphCrossRuntimeError("[Raph] Child belongs to another runtime.");if(this===e)throw new Error("[Raph] A node cannot become its own ancestor.");for(let t=this._parent;t!==null;t=t.parent)if(t===e)throw new Error("[Raph] A node cannot become its own ancestor.");if(e.parent===this)return!0;if(e._parent!==null){const t=e._parent._children,o=t.indexOf(e);o>=0&&t.splice(o,1)}return e._parent=this,this._children.push(e),!0}options(e){this._assertAlive(),e.meta!==void 0&&(this.meta={...e.meta}),e.priority!==void 0&&(l(e.priority),this.priority=e.priority),e.type!==void 0&&(this.type=e.type)}dirty(e){this._assertAlive(),this.runtime.invalidateNode(this,e)}remove(){this.dispose()}dispose(){if(this._disposed||this._disposing)return;this._disposing=!0;const e=[];for(const t of[...this._children])try{t.dispose()}catch(o){e.push(o)}if(this._children.length=0,this._parent!==null){const t=this._parent._children.indexOf(this);t>=0&&this._parent._children.splice(t,1)}this._parent=null;try{super.dispose()}catch(t){e.push(t)}f.throwDisposalErrors(e,`[Raph] Node "${this.id}" disposal failed.`)}observeData(e,t){return this._assertAlive(),this.runtime.observeData(this,e,t)}track(e,t={}){return this._assertAlive(),this.runtime.track(this,e,t)}_setApi(e){const t=typeof e=="object"&&e!==null?Object.freeze(e):e;Object.defineProperty(this,"api",{configurable:!1,enumerable:!0,value:t,writable:!1})}}function l(s){if(!Number.isFinite(s))throw new TypeError("[Raph] Node priority must be finite.")}exports.RaphNode=h;

package/dist/debug/runtime/RaphNode.js

@@ -1,143 +0,0 @@
-var d = Object.defineProperty;
-var f = (s, r, t) => r in s ? d(s, r, { enumerable: !0, configurable: !0, writable: !0, value: t }) : s[r] = t;
-var h = (s, r, t) => f(s, typeof r != "symbol" ? r + "" : r, t);
-import { throwDisposalErrors as m } from "./disposal.js";
-import { RaphCrossRuntimeError as p } from "./errors.js";
-import { RaphScope as _ } from "./RaphScope.js";
-let y = 0;
-class a extends _ {
-  /**
-   * Создаёт node внутри ownership tree указанного runtime.
-   */
-  constructor(t, i = {}, n) {
-    const o = n ?? (t instanceof a ? t.runtime : t ?? void 0);
-    if (o === void 0)
-      throw new Error("[RaphNode] A root node requires an explicit runtime.");
-    const e = t instanceof a ? t : (t == null ? void 0 : t.root) ?? null;
-    super(i.id ?? `node-${y++}`, o);
-    // Описывают положение и порядок node в ownership tree.
-    h(this, "priority");
-    h(this, "_parent");
-    h(this, "_children", []);
-    // Публикуют прикладной API и диагностические атрибуты node.
-    h(this, "api");
-    h(this, "meta");
-    h(this, "type");
-    if (e !== null && e.runtime !== o)
-      throw super.dispose(), new p("[Raph] Parent belongs to another runtime.");
-    try {
-      e == null || e._assertAlive();
-    } catch (u) {
-      throw super.dispose(), u;
-    }
-    const l = i.priority ?? 0;
-    c(l), this.priority = l, this._parent = e, this.meta = { ...i.meta }, this.type = i.type ?? "default", this.api = Object.freeze({}), e == null || e._children.push(this);
-  }
-  /**
-   * Возвращает текущего родителя node либо null для root.
-   */
-  get parent() {
-    return this._parent;
-  }
-  /**
-   * Возвращает снимок непосредственных дочерних nodes.
-   */
-  get children() {
-    return this._children;
-  }
-  /**
-   * Перемещает node внутри ownership tree одного Runtime.
-   */
-  addChild(t) {
-    if (this._assertAlive(), t._assertAlive(), t.runtime !== this.runtime)
-      throw new p("[Raph] Child belongs to another runtime.");
-    if (this === t)
-      throw new Error("[Raph] A node cannot become its own ancestor.");
-    for (let i = this._parent; i !== null; i = i.parent)
-      if (i === t)
-        throw new Error("[Raph] A node cannot become its own ancestor.");
-    if (t.parent === this)
-      return !0;
-    if (t._parent !== null) {
-      const i = t._parent._children, n = i.indexOf(t);
-      n >= 0 && i.splice(n, 1);
-    }
-    return t._parent = this, this._children.push(t), !0;
-  }
-  /**
-   * Обновляет изменяемые priority, meta и type node.
-   */
-  options(t) {
-    this._assertAlive(), t.meta !== void 0 && (this.meta = { ...t.meta }), t.priority !== void 0 && (c(t.priority), this.priority = t.priority), t.type !== void 0 && (this.type = t.type);
-  }
-  /**
-   * Показывает, ожидает ли node выполнения.
-   */
-  dirty(t) {
-    this._assertAlive(), this.runtime.invalidateNode(this, t);
-  }
-  /**
-   * Отсоединяет node от ownership tree с заданной lifecycle-семантикой.
-   */
-  remove() {
-    this.dispose();
-  }
-  /**
-   * Освобождает node вместе с дочерними owners и registrations.
-   */
-  dispose() {
-    if (this._disposed || this._disposing)
-      return;
-    this._disposing = !0;
-    const t = [];
-    for (const i of [...this._children])
-      try {
-        i.dispose();
-      } catch (n) {
-        t.push(n);
-      }
-    if (this._children.length = 0, this._parent !== null) {
-      const i = this._parent._children.indexOf(this);
-      i >= 0 && this._parent._children.splice(i, 1);
-    }
-    this._parent = null;
-    try {
-      super.dispose();
-    } catch (i) {
-      t.push(i);
-    }
-    m(t, `[Raph] Node "${this.id}" disposal failed.`);
-  }
-  /**
-   * Регистрирует path observer в phase pipeline.
-   */
-  observeData(t, i) {
-    return this._assertAlive(), this.runtime.observeData(this, t, i);
-  }
-  /**
-   * Регистрирует tracked executor указанной phase.
-   */
-  track(t, i = {}) {
-    return this._assertAlive(), this.runtime.track(this, t, i);
-  }
-  /**
-   * Однократно устанавливает immutable API, принадлежащий node.
-   * @internal
-   */
-  _setApi(t) {
-    const i = typeof t == "object" && t !== null ? Object.freeze(t) : t;
-    Object.defineProperty(this, "api", {
-      configurable: !1,
-      enumerable: !0,
-      value: i,
-      writable: !1
-    });
-  }
-}
-function c(s) {
-  if (!Number.isFinite(s))
-    throw new TypeError("[Raph] Node priority must be finite.");
-}
-export {
-  a as RaphNode
-};

package/dist/debug/runtime/RaphPhasePipeline.cjs

@@ -1 +0,0 @@
-"use strict";var w=Object.defineProperty;var k=(d,e,s)=>e in d?w(d,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):d[e]=s;var h=(d,e,s)=>k(d,typeof e!="symbol"?e+"":e,s);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("../path/data-path.cjs"),v=require("../path/path-router.cjs"),b=1e4,y=()=>{};class P{constructor(e,s,t,n,a=()=>!1){h(this,"_observerRouter");h(this,"_phaseRouter",new v.PathRouter);h(this,"_observers");h(this,"_stopKernel");h(this,"_phases",[]);h(this,"_phaseByName",new Map);h(this,"_pending",new Map);h(this,"_tasks",new Map);h(this,"_phaseBindings",new Map);h(this,"_taskSequence",0);h(this,"_scheduled",!1);h(this,"_scheduleToken",0);h(this,"_frameHandle");h(this,"_frameHandleKind");h(this,"_configurationLocked",!1);h(this,"_running",!1);h(this,"_disposed",!1);h(this,"_firstFrameAt");h(this,"_lastFrameAt");h(this,"_frameNumber",0);h(this,"_frame",Object.freeze({now:0,delta:0,elapsed:0,frame:0}));this._kernel=e,this._root=s,this._scheduler=t,this._runUntracked=n,this._deferSync=a}get frame(){return this._frame}get phases(){return this._phases.map(e=>e.phase)}definePhases(e){if(this._assertAlive(),this._configurationLocked||this._firstFrameAt!==void 0)throw new Error("[Raph] Cannot redefine phases after phase pipeline execution has started.");const s=new Map,t=new v.PathRouter,n=[];for(const a of e){const r=a.name.trim();if(!r)throw new Error("[Raph] Phase name must not be empty.");if(s.has(r))throw new Error(`[Raph] Duplicate phase name "${r}".`);if(!R(a.traversal))throw new Error(`[Raph] Unsupported phase traversal "${String(a.traversal)}".`);if(!A(a.mode))throw new Error(`[Raph] Unsupported phase mode "${String(a.mode)}".`);if(a.each!==void 0&&typeof a.each!="function")throw new TypeError(`[Raph] Phase "${r}" each executor must be a function.`);if(a.all!==void 0&&typeof a.all!="function")throw new TypeError(`[Raph] Phase "${r}" all executor must be a function.`);if(a.each!==void 0&&a.all!==void 0)throw new TypeError(`[Raph] Phase "${r}" cannot define both each and all executors.`);const i=Object.freeze({...a,name:r,mode:a.mode??"dirty",routes:Object.freeze([...a.routes??[]])}),o={phase:i};n.push(o),s.set(r,o);for(const l of i.routes)t.add(m.DataPath.from(l)._asMask(),o)}this._assertRetainedPhases(s),this._phases=n,this._phaseByName=s,this._phaseRouter=t}addPhase(e){this.definePhases([...this._phases.map(s=>s.phase),e])}clearPhases(){this.definePhases([])}requirePhase(e){if(this._assertAlive(),!this._phaseByName.has(e))throw new Error(`[Raph] Phase "${e}" is not defined.`)}lockConfiguration(){this._assertAlive(),this._configurationLocked=!0}retainPhase(e){this.requirePhase(e),this._phaseBindings.set(e,(this._phaseBindings.get(e)??0)+1);let s=!0;return()=>{if(!s)return;s=!1;const t=(this._phaseBindings.get(e)??1)-1;t===0?this._phaseBindings.delete(e):this._phaseBindings.set(e,t)}}phaseMode(e){this._assertAlive();const s=this._phaseByName.get(e);if(s===void 0)throw new Error(`[Raph] Phase "${e}" is not defined.`);return s.phase.mode??"dirty"}registerEffect(e){return this.requirePhase(e),y}bindEffect(e,s,t,n){const a=this.registerEffect(e),r={active:!0,pending:!1,persistent:!0,priority:s,sequence:0,run:t,node:n};return{schedule:()=>{if(!r.active||r.pending||this._disposed||n!=null&&n.disposed)return;r.pending=!0,r.sequence=this._taskSequence++;let i=this._tasks.get(e);i===void 0&&(i=[],this._tasks.set(e,i)),i.push(r),this._schedule()},dispose:()=>{if(!r.active)return;r.active=!1,r.pending=!1,a();const i=this._tasks.get(e);if(i!==void 0){const o=i.indexOf(r);o!==-1&&i.splice(o,1),i.length===0&&this._tasks.delete(e)}this._hasPending()||this._cancelScheduled()}}}queueEffect(e,s,t,n=!0){this.requirePhase(e);const a={active:!0,pending:!0,persistent:!1,priority:s,sequence:this._taskSequence++,run:t};let r=this._tasks.get(e);return r===void 0&&(r=[],this._tasks.set(e,r)),r.push(a),n&&this._schedule(),()=>{if(!a.active)return;a.active=!1;const i=this._tasks.get(e);if(i!==void 0){const o=i.indexOf(a);o>=0&&i.splice(o,1),i.length===0&&this._tasks.delete(e)}this._hasPending()||this._cancelScheduled()}}request(){this._assertAlive(),this._hasPending()&&this._schedule()}requestAlwaysPhases(){this._assertAlive();for(const e of this._phases){const s=e.phase;if(s.mode!=="always"||s.traversal!=="all"||s.all===void 0)continue;let t=this._pending.get(s.name);t===void 0&&(t=new Map,this._pending.set(s.name,t)),u(t,this._root,[])}this._pending.size!==0&&this._schedule()}observeData(e,s,t){const n=t.phase.trim();if(!this._phaseByName.has(n))throw new Error(`[Raph] Phase "${n}" is not defined.`);return this._addObserver(e,s,n,t)}track(e,s,t){return this._addObserver(e,s,void 0,t)}invalidate(e,s){this.requirePhase(s);let t=this._pending.get(s);t===void 0&&(t=new Map,this._pending.set(s,t)),u(t,e,[]),this._schedule()}flush(){var n;if(this._assertAlive(),this._cancelScheduled(),this._running||!this._hasPending())return;this._running=!0;const e=[],s=this._nextFrame();let t=0;try{for(;this._hasPending()&&!this._disposed;){if(++t>b){this._pending.clear();for(const i of this._tasks.values())for(const o of i)o.active=!1;throw this._tasks.clear(),new Error("[Raph] Phase flush exceeded 10000 passes.")}const a=this._pending;this._pending=new Map;const r=this._tasks;this._tasks=new Map;for(const i of this._phases){if(this._disposed)break;const o=i.phase.name,l=a.get(o);if(l!==void 0&&l.size!==0){const f=this._expandContexts(i.phase,l,s);if(i.phase.each!==void 0)for(const c of f){if(this._disposed)break;if(!c.node.disposed)try{this._runUntracked(()=>i.phase.each(c))}catch(p){e.push(p)}}else if(i.phase.all!==void 0&&!this._disposed)try{this._runUntracked(()=>i.phase.all(f))}catch(c){e.push(c)}}if(this._disposed)break;const _=r.get(o);if(!(_===void 0||_.length===0)){_.length>1&&_.sort((f,c)=>c.priority-f.priority||f.sequence-c.sequence);for(const f of _){if(this._disposed)break;if(!(!f.active||!f.pending||(n=f.node)!=null&&n.disposed)){f.pending=!1,f.persistent||(f.active=!1);try{f.run()}catch(c){e.push(c)}}}}}}}finally{this._running=!1}if(e.length===1)throw e[0];if(e.length>1)throw new AggregateError(e,"[Raph] Multiple phase executors failed.")}dispose(){var e;if(!this._disposed){this._disposed=!0,this._cancelScheduled(),this._pending.clear();for(const s of this._tasks.values())for(const t of s)t.active=!1;if(this._tasks.clear(),this._phaseBindings.clear(),(e=this._stopKernel)==null||e.call(this),this._stopKernel=void 0,this._observers!==void 0){for(const s of this._observers){s.active=!1;for(const t of s.removeRoutes)t()}this._observers.clear(),this._observers=void 0}this._observerRouter=void 0,this._phases=[],this._phaseByName.clear(),this._phaseRouter=new v.PathRouter}}_debugPending(){return this._scheduled||this._running||this._hasPending()}_addObserver(e,s,t,n){this._assertAlive();const a=Array.isArray(s)?s:[s];if(a.length===0)throw new TypeError("[Raph] Phase observer requires at least one mask.");const r=new Map;for(const c of a){const p=m.DataPath.from(c,n)._asMask();r.set(p.canonical,p)}const i=this._observerRouter??(this._observerRouter=new v.PathRouter),o={active:!0,node:e,...t===void 0?{}:{phase:t},removeRoutes:[]},l=[...r.values()].map(c=>i.add(c,o));o.removeRoutes=l;const _=this._observers??(this._observers=new Set);_.add(o),this._ensureKernelWatch();let f=!0;return()=>{var c;if(f){f=!1,o.active=!1;for(const p of o.removeRoutes)p();_.delete(o),_.size===0&&(this._observers=void 0,this._observerRouter=void 0,(c=this._stopKernel)==null||c.call(this),this._stopKernel=void 0)}}}_ensureKernelWatch(){this._stopKernel??(this._stopKernel=this._kernel.watch("*",({events:e})=>{this._receive(e)}))}_assertRetainedPhases(e){for(const s of this._phaseBindings.keys())if(!e.has(s))throw new Error(`[Raph] Cannot remove phase "${s}" while it is still bound.`);for(const s of this._observers??[]){const t=s.phase;if(s.active&&t!==void 0&&!e.has(t))throw new Error(`[Raph] Cannot remove phase "${t}" while it is still observed.`)}for(const s of this._pending.keys())if(!e.has(s))throw new Error(`[Raph] Cannot remove phase "${s}" while it has pending work.`);for(const s of this._tasks.keys())if(!e.has(s))throw new Error(`[Raph] Cannot remove phase "${s}" while it has queued effects.`)}_receive(e){if(this._disposed)return;const s=this._observerRouter;if(s!==void 0){for(const t of e){const n=t.path==="",a=n?void 0:m.parseDataPath(t.path),r=n?s.matchAll():s.match(a.segments);for(const i of r){if(!i.active||i.node.disposed)continue;if(i.phase!==void 0){this._queue(i.phase,i.node,t);continue}const o=n?this._phaseRouter.matchAll():this._phaseRouter.match(a.segments);for(const l of o)this._queue(l.phase.name,i.node,t)}}this._pending.size!==0&&this._schedule()}}_queue(e,s,t){if(!this._phaseByName.has(e))return;let n=this._pending.get(e);n===void 0&&(n=new Map,this._pending.set(e,n)),u(n,s,[t])}_schedule(){if(this._running||this._scheduled||this._disposed)return;if(this._scheduler==="sync"){if(this._deferSync())return;this.flush();return}this._scheduled=!0;const e=++this._scheduleToken,s=()=>{this._disposed||!this._scheduled||e!==this._scheduleToken||(this._scheduled=!1,this._frameHandle=void 0,this._frameHandleKind=void 0,this.flush())};if(this._scheduler==="microtask"){queueMicrotask(s);return}typeof globalThis.requestAnimationFrame=="function"?(this._frameHandleKind="animation-frame",this._frameHandle=globalThis.requestAnimationFrame(s)):(this._frameHandleKind="timeout",this._frameHandle=setTimeout(s,16))}_cancelScheduled(){var e;this._scheduled&&(this._scheduled=!1,this._scheduleToken++,this._frameHandleKind==="animation-frame"&&this._frameHandle!==void 0?(e=globalThis.cancelAnimationFrame)==null||e.call(globalThis,this._frameHandle):this._frameHandleKind==="timeout"&&this._frameHandle!==void 0&&clearTimeout(this._frameHandle),this._frameHandle=void 0,this._frameHandleKind=void 0)}_nextFrame(){var t;const e=((t=globalThis.performance)==null?void 0:t.now())??Date.now();if(this._firstFrameAt===void 0||this._lastFrameAt===void 0)return this._firstFrameAt=e,this._lastFrameAt=e,this._frame=Object.freeze({now:e,delta:0,elapsed:0,frame:0});this._frameNumber++;const s=Object.freeze({now:e,delta:Math.min(Math.max(e-this._lastFrameAt,0),100),elapsed:Math.max(e-this._firstFrameAt,0),frame:this._frameNumber});return this._lastFrameAt=e,this._frame=s}_hasPending(){return this._pending.size!==0||this._tasks.size!==0}_expandContexts(e,s,t){const n=[...s.entries()].filter(([r])=>!r.disposed).sort(([r],[i])=>i.priority-r.priority),a=new Map;if(e.traversal==="dirty-only")for(const[r,i]of n)u(a,r,i.events);else if(e.traversal==="dirty-and-down")for(const[r,i]of n)g(r,o=>u(a,o,i.events));else if(e.traversal==="dirty-and-up")for(const[r,i]of n){let o=r;for(;o!==null&&o!==this._root;)u(a,o,i.events),o=o.parent}else{const r=[],i=new Set;for(const o of s.values())for(const l of o.events)i.has(l)||(i.add(l),r.push(l));for(const o of this._root.children)g(o,l=>u(a,l,r))}return[...a].filter(([r])=>{var i;return((i=e.nodes)==null?void 0:i.call(e,r))??!0}).map(([r,i])=>({events:i.events,frame:t,node:r,phase:e.name}))}_assertAlive(){if(this._disposed)throw new Error("[Raph] Phase pipeline is disposed.")}}function u(d,e,s){let t=d.get(e);t===void 0&&(t={events:[],seen:new Set},d.set(e,t));for(const n of s)t.seen.has(n)||(t.seen.add(n),t.events.push(n))}function g(d,e){e(d);for(const s of d.children)g(s,e)}function R(d){return d==="dirty-only"||d==="dirty-and-down"||d==="dirty-and-up"||d==="all"}function A(d){return d===void 0||d==="dirty"||d==="always"}exports.RaphPhasePipeline=P;