@raphy-js/raph 1.0.0-dev.2

package/dist/debug/runtime/RaphNode.js

@@ -0,0 +1,143 @@
+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

@@ -0,0 +1 @@
+"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;

package/dist/debug/runtime/RaphPhasePipeline.js

@@ -0,0 +1,526 @@
+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);
+import { DataPath as g, parseDataPath as b } from "../path/data-path.js";
+import { PathRouter as v } from "../path/path-router.js";
+const y = 1e4, P = () => {
+};
+class M {
+  /**
+   * Создаёт phase pipeline для runtime и его root node.
+   */
+  constructor(e, s, t, n, a = () => !1) {
+    // Индексируют data observers и phase definitions.
+    h(this, "_observerRouter");
+    h(this, "_phaseRouter", new v());
+    h(this, "_observers");
+    h(this, "_stopKernel");
+    h(this, "_phases", []);
+    h(this, "_phaseByName", /* @__PURE__ */ new Map());
+    // Хранят pending nodes, effect tasks и registration counters.
+    h(this, "_pending", /* @__PURE__ */ new Map());
+    h(this, "_tasks", /* @__PURE__ */ new Map());
+    h(this, "_phaseBindings", /* @__PURE__ */ new Map());
+    h(this, "_taskSequence", 0);
+    // Управляют выбранным scheduler и текущим flush lifecycle.
+    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);
+    // Формируют immutable frame context для phase callbacks.
+    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;
+  }
+  /**
+   * Возвращает последний frame context pipeline.
+   */
+  get frame() {
+    return this._frame;
+  }
+  /**
+   * Возвращает текущее упорядоченное определение phases.
+   */
+  get phases() {
+    return this._phases.map((e) => e.phase);
+  }
+  /**
+   * Заменяет полное определение phase pipeline до его первого выполнения.
+   */
+  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 = /* @__PURE__ */ new Map(), t = new v(), 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(g.from(l)._asMask(), o);
+    }
+    this._assertRetainedPhases(s), this._phases = n, this._phaseByName = s, this._phaseRouter = t;
+  }
+  /**
+   * Добавляет phase до первого выполнения pipeline.
+   */
+  addPhase(e) {
+    this.definePhases([...this._phases.map((s) => s.phase), e]);
+  }
+  /**
+   * Удаляет пользовательские phases до первого выполнения pipeline.
+   */
+  clearPhases() {
+    this.definePhases([]);
+  }
+  /**
+   * Возвращает phase либо отклоняет неизвестное имя.
+   */
+  requirePhase(e) {
+    if (this._assertAlive(), !this._phaseByName.has(e))
+      throw new Error(`[Raph] Phase "${e}" is not defined.`);
+  }
+  /**
+   * Фиксирует phase definitions перед синхронным выполнением вне flush.
+   */
+  lockConfiguration() {
+    this._assertAlive(), this._configurationLocked = !0;
+  }
+  /**
+   * Удерживает определение фазы для idle registrations вне data observer/effect.
+   */
+  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);
+    };
+  }
+  /**
+   * Возвращает scheduler mode указанной phase.
+   */
+  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";
+  }
+  /**
+   * Связывает реактивный effect с phase scheduler.
+   */
+  registerEffect(e) {
+    return this.requirePhase(e), P;
+  }
+  /**
+   * Один раз связывает watcher с task и callback.
+   * Повторные invalidations используют ту же task без hot-path поиска node и phase.
+   */
+  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();
+      }
+    };
+  }
+  /**
+   * Ставит уже зарегистрированный effect в очередь его phase.
+   */
+  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();
+    };
+  }
+  /**
+   * Запрашивает выполнение pipeline согласно scheduler mode.
+   */
+  request() {
+    this._assertAlive(), this._hasPending() && this._schedule();
+  }
+  /**
+   * Ставит frame-driven обход всего дерева в очередь даже без reactive effect.
+   */
+  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 = /* @__PURE__ */ new Map(), this._pending.set(s.name, t)), u(t, this._root, []);
+    }
+    this._pending.size !== 0 && this._schedule();
+  }
+  /**
+   * Регистрирует path observer в phase pipeline.
+   */
+  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);
+  }
+  /**
+   * Регистрирует tracked executor указанной phase.
+   */
+  track(e, s, t) {
+    return this._addObserver(e, s, void 0, t);
+  }
+  /**
+   * Помечает node и зависимых владельцев как требующих выполнения.
+   */
+  invalidate(e, s) {
+    this.requirePhase(s);
+    let t = this._pending.get(s);
+    t === void 0 && (t = /* @__PURE__ */ new Map(), this._pending.set(s, t)), u(t, e, []), this._schedule();
+  }
+  /**
+   * Синхронно выполняет все готовые очереди pipeline.
+   */
+  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 > y) {
+          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 = /* @__PURE__ */ new Map();
+        const r = this._tasks;
+        this._tasks = /* @__PURE__ */ 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.");
+  }
+  /**
+   * Останавливает scheduler и удаляет observers, tasks и phase definitions.
+   */
+  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();
+    }
+  }
+  /**
+   * Показывает наличие запланированной или выполняемой работы pipeline.
+   * @internal
+   */
+  _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 = /* @__PURE__ */ new Map();
+    for (const c of a) {
+      const p = g.from(c, n)._asMask();
+      r.set(p.canonical, p);
+    }
+    const i = this._observerRouter ?? (this._observerRouter = new v()), 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 = /* @__PURE__ */ 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 : b(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 = /* @__PURE__ */ 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 = /* @__PURE__ */ 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)
+        m(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 = /* @__PURE__ */ 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)
+        m(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: /* @__PURE__ */ new Set() }, d.set(e, t));
+  for (const n of s)
+    t.seen.has(n) || (t.seen.add(n), t.events.push(n));
+}
+function m(d, e) {
+  e(d);
+  for (const s of d.children)
+    m(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";
+}
+export {
+  M as RaphPhasePipeline
+};