@raphy-js/raph 1.0.0-dev.18

package/dist/debug/runtime/ownership/RaphNode.js

@@ -0,0 +1,206 @@
+var y = Object.defineProperty;
+var b = (o, h, t) => h in o ? y(o, h, { enumerable: !0, configurable: !0, writable: !0, value: t }) : o[h] = t;
+var l = (o, h, t) => b(o, typeof h != "symbol" ? h + "" : h, t);
+import { RaphCrossRuntimeError as a } from "../errors.js";
+import { RaphScope as w } from "./RaphScope.js";
+import { throwDisposalErrors as v } from "./throwDisposalErrors.js";
+let g = 0;
+const _ = Symbol("RaphProvisionalNode");
+class c extends w {
+  constructor(t, e = {}, i, r) {
+    const s = i ?? (t instanceof c ? t.runtime : t ?? void 0);
+    if (s === void 0)
+      throw new Error("[RaphNode] A root node requires an explicit runtime.");
+    const n = t instanceof c ? t : (t == null ? void 0 : t.root) ?? null;
+    if (n !== null && n.runtime !== s)
+      throw new a("[Raph] Parent belongs to another runtime.");
+    n == null || n._assertAlive();
+    const d = e.priority ?? 0;
+    p(d);
+    super(e.id ?? `node-${g++}`, s);
+    l(this, "priority");
+    l(this, "_parent");
+    l(this, "_children", []);
+    l(this, "_published");
+    l(this, "api");
+    l(this, "meta");
+    l(this, "type");
+    /** Distinguishes a subtree granule from the node's self granule. @internal */
+    l(this, "_subtreeSourceIdentity", Object.freeze({}));
+    this.priority = d, this._parent = n, this.meta = { ...e.meta }, this.type = e.type ?? "default", this.api = Object.freeze({});
+    const f = r === _;
+    if (this._published = n === null || !f && n._published, n !== null) {
+      const m = n._children.length;
+      if (n._children.push(this), !this._published)
+        return;
+      s._notifyNodeStructure(this, {
+        node: this,
+        newIndex: m,
+        newParent: n
+      }, [], u(this)), this._assertAlive();
+    }
+  }
+  get node() {
+    return this;
+  }
+  get parent() {
+    return this._parent;
+  }
+  get children() {
+    return this._children;
+  }
+  addChild(t) {
+    if (this._assertAlive(), t._assertAlive(), t.runtime !== this.runtime)
+      throw new a("[Raph] Child belongs to another runtime.");
+    if (this === t)
+      throw new Error("[Raph] A node cannot become its own ancestor.");
+    if (!t._published || !this._published)
+      throw new Error("[Raph] A provisional node cannot be reparented before setup commits.");
+    for (let e = this; e !== null; e = e.parent)
+      if (e === t)
+        throw new Error("[Raph] A node cannot become its own ancestor.");
+    return t.parent === this ? !0 : this.runtime._runNodeMutation(() => {
+      this.runtime._assertNodeReparentAllowed(t, this);
+      const e = u(t), i = t._parent, r = i == null ? void 0 : i._children.indexOf(t);
+      i !== null && r !== void 0 && r >= 0 && i._children.splice(r, 1), t._parent = this;
+      const s = this._children.length;
+      return this._children.push(t), this.runtime._notifyNodeStructure(t, {
+        node: t,
+        ...i === null ? {} : { oldParent: i },
+        ...r === void 0 || r < 0 ? {} : { oldIndex: r },
+        newParent: this,
+        newIndex: s
+      }, e, u(t)), !0;
+    });
+  }
+  reorderChildren(t) {
+    if (this._assertAlive(), t.length !== this._children.length || new Set(t).size !== t.length)
+      throw new Error("[Raph] Child order must contain every direct child exactly once.");
+    for (const e of t)
+      if (e._assertAlive(), e._parent !== this)
+        throw new Error("[Raph] Child order can contain only direct children of the node.");
+    this.runtime._runNodeMutation(() => {
+      const e = new Map(this._children.map((i, r) => [i, r]));
+      this._children.splice(0, this._children.length, ...t);
+      for (let i = 0; i < t.length; i++) {
+        const r = t[i], s = e.get(r);
+        if (s === i)
+          continue;
+        const n = u(r);
+        this.runtime._notifyNodeStructure(r, {
+          node: r,
+          oldParent: this,
+          newParent: this,
+          oldIndex: s,
+          newIndex: i
+        }, n, n);
+      }
+    });
+  }
+  options(t) {
+    this._assertAlive(), t.meta !== void 0 && (this.meta = { ...t.meta }), t.priority !== void 0 && (p(t.priority), this.priority = t.priority), t.type !== void 0 && (this.type = t.type), this.touch(Object.freeze({ options: Object.freeze({ ...t }) }));
+  }
+  /** Invalidates coarse self/subtree/runtime granules for non-reactive state. */
+  touch(t) {
+    this._assertAlive(), this.runtime._runNodeMutation(() => this.runtime._notifyNodeTouch(this, t));
+  }
+  remove() {
+    this.dispose();
+  }
+  dispose() {
+    if (this._disposed || this._disposing)
+      return;
+    this._disposing = !0, this.runtime._beginOwnerDisposal();
+    const t = [];
+    try {
+      for (const s of [...this._children])
+        try {
+          s.dispose();
+        } catch (n) {
+          t.push(n);
+        }
+      this._children.length = 0;
+      const e = this._parent, i = u(this), r = e == null ? void 0 : e._children.indexOf(this);
+      if (e !== null && r !== void 0 && r >= 0 && e._children.splice(r, 1), this._parent = null, this._published)
+        try {
+          this.runtime._notifyNodeStructure(this, {
+            node: this,
+            ...e === null ? {} : { oldParent: e },
+            ...r === void 0 || r < 0 ? {} : { oldIndex: r }
+          }, i, []);
+        } catch (s) {
+          t.push(s);
+        }
+      try {
+        super.dispose();
+      } catch (s) {
+        t.push(s);
+      }
+      this._published = !1;
+      try {
+        this.runtime._releaseNode(this);
+      } catch (s) {
+        t.push(s);
+      }
+    } finally {
+      try {
+        this.runtime._endOwnerDisposal();
+      } catch (e) {
+        t.push(e);
+      }
+    }
+    v(t, `[Raph] Node "${this.id}" disposal failed.`);
+  }
+  /** @internal */
+  _setApi(t) {
+    const e = typeof t == "object" && t !== null ? Object.freeze(t) : t;
+    Object.defineProperty(this, "api", {
+      configurable: !1,
+      enumerable: !0,
+      value: e,
+      writable: !1
+    });
+  }
+  /** Publishes a fully initialized provisional subtree. @internal */
+  _publishCreation() {
+    if (this._published)
+      return;
+    const t = this._parent;
+    if (t === null || !t._published)
+      return;
+    this._published = !0;
+    const e = t._children.indexOf(this);
+    try {
+      this.runtime._notifyNodeStructure(this, {
+        node: this,
+        newIndex: e,
+        newParent: t
+      }, [], u(this));
+      for (const i of this._children)
+        i._publishCreation();
+    } catch (i) {
+      throw this._published = !1, i;
+    }
+  }
+  /** @internal */
+  _isPublished() {
+    return this._published;
+  }
+}
+function O(o, h, t) {
+  return new c(o, h, t, _);
+}
+function u(o) {
+  const h = [];
+  for (let t = o; t !== null; t = t.parent)
+    h.push(t);
+  return h;
+}
+function p(o) {
+  if (!Number.isFinite(o))
+    throw new TypeError("[Raph] Node priority must be finite.");
+}
+export {
+  c as RaphNode,
+  O as createProvisionalNode
+};

package/dist/debug/runtime/ownership/RaphScope.cjs

@@ -0,0 +1 @@
+"use strict";var u=Object.defineProperty;var n=(i,s,e)=>s in i?u(i,s,{enumerable:!0,configurable:!0,writable:!0,value:e}):i[s]=e;var r=(i,s,e)=>n(i,typeof s!="symbol"?s+"":s,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("../../reactivity/scope.cjs"),c=require("../errors.cjs"),d=require("./throwDisposalErrors.cjs");class _{constructor(s,e){r(this,"id");r(this,"runtime");r(this,"_resources");r(this,"_disposed",!1);r(this,"_disposing",!1);this.id=s,this.runtime=e,this._resources=new h.ScopeNode(e._getReactivity()),e._registerOwner(this)}get disposed(){return this._disposed}get active(){return!this._disposed&&!this._disposing}get node(){}signal(s){return this._assertAlive(),this.runtime.signal(s,this)}computed(s){return this._assertAlive(),typeof s=="function"?this.runtime.computed(s,this):this.runtime.computed(s,this)}effect(s,e,t){return this._assertAlive(),this.runtime.effect(this,s,e,t)}watch(s,e,t,o){return this._assertAlive(),this.runtime.watch(this,s,e,t,o)}aggregate(s){return this._assertAlive(),this.runtime.aggregate(this,s)}action(s,e){return this._assertAlive(),typeof s=="function"?this.runtime.action(s,this):this.runtime.action(s,e,this)}own(s){return this.active?this._resources._own(s):(s(),a)}dispose(){if(this._disposed)return;this._disposed=!0,this._disposing=!0;const s=!this.runtime._ownerDisposalActive();s&&this.runtime._beginOwnerDisposal();const e=[];try{try{this._resources.dispose()}catch(t){e.push(t)}}finally{this._disposing=!1;try{this.runtime._unregisterOwner(this)}catch(t){e.push(t)}if(s)try{this.runtime._endOwnerDisposal()}catch(t){e.push(t)}}d.throwDisposalErrors(e,`[Raph] Scope "${this.id}" disposal failed.`)}_adoptResource(s){return this._assertAlive(),this._resources._adoptResource(s)}_adoptSource(s){return this._assertAlive(),this._resources._adoptSource(s)}_debugResourceCount(){return this._resources._debugResourceCount()}_debugSourceCount(){return this._resources._debugSourceCount()}_assertAlive(){if(this._disposed||this._disposing)throw new c.RaphDisposedError(`[Raph] Owner "${this.id}" is disposed.`)}}function a(){}exports.RaphScope=_;

package/dist/debug/runtime/ownership/RaphScope.js

@@ -0,0 +1,101 @@
+var h = Object.defineProperty;
+var u = (i, s, t) => s in i ? h(i, s, { enumerable: !0, configurable: !0, writable: !0, value: t }) : i[s] = t;
+var r = (i, s, t) => u(i, typeof s != "symbol" ? s + "" : s, t);
+import { ScopeNode as n } from "../../reactivity/scope.js";
+import { RaphDisposedError as c } from "../errors.js";
+import { throwDisposalErrors as d } from "./throwDisposalErrors.js";
+class f {
+  constructor(s, t) {
+    r(this, "id");
+    r(this, "runtime");
+    r(this, "_resources");
+    r(this, "_disposed", !1);
+    r(this, "_disposing", !1);
+    this.id = s, this.runtime = t, this._resources = new n(t._getReactivity()), t._registerOwner(this);
+  }
+  get disposed() {
+    return this._disposed;
+  }
+  get active() {
+    return !this._disposed && !this._disposing;
+  }
+  /** Stable selector for process ordering; plain scopes are not tree nodes. */
+  get node() {
+  }
+  signal(s) {
+    return this._assertAlive(), this.runtime.signal(s, this);
+  }
+  computed(s) {
+    return this._assertAlive(), typeof s == "function" ? this.runtime.computed(s, this) : this.runtime.computed(s, this);
+  }
+  effect(s, t, e) {
+    return this._assertAlive(), this.runtime.effect(this, s, t, e);
+  }
+  watch(s, t, e, o) {
+    return this._assertAlive(), this.runtime.watch(this, s, t, e, o);
+  }
+  aggregate(s) {
+    return this._assertAlive(), this.runtime.aggregate(this, s);
+  }
+  action(s, t) {
+    return this._assertAlive(), typeof s == "function" ? this.runtime.action(s, this) : this.runtime.action(s, t, this);
+  }
+  own(s) {
+    return this.active ? this._resources._own(s) : (s(), _);
+  }
+  dispose() {
+    if (this._disposed)
+      return;
+    this._disposed = !0, this._disposing = !0;
+    const s = !this.runtime._ownerDisposalActive();
+    s && this.runtime._beginOwnerDisposal();
+    const t = [];
+    try {
+      try {
+        this._resources.dispose();
+      } catch (e) {
+        t.push(e);
+      }
+    } finally {
+      this._disposing = !1;
+      try {
+        this.runtime._unregisterOwner(this);
+      } catch (e) {
+        t.push(e);
+      }
+      if (s)
+        try {
+          this.runtime._endOwnerDisposal();
+        } catch (e) {
+          t.push(e);
+        }
+    }
+    d(t, `[Raph] Scope "${this.id}" disposal failed.`);
+  }
+  /** @internal */
+  _adoptResource(s) {
+    return this._assertAlive(), this._resources._adoptResource(s);
+  }
+  /** @internal */
+  _adoptSource(s) {
+    return this._assertAlive(), this._resources._adoptSource(s);
+  }
+  /** @internal */
+  _debugResourceCount() {
+    return this._resources._debugResourceCount();
+  }
+  /** @internal */
+  _debugSourceCount() {
+    return this._resources._debugSourceCount();
+  }
+  /** @internal */
+  _assertAlive() {
+    if (this._disposed || this._disposing)
+      throw new c(`[Raph] Owner "${this.id}" is disposed.`);
+  }
+}
+function _() {
+}
+export {
+  f as RaphScope
+};

package/dist/debug/runtime/ownership/parent-graph.types.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/debug/runtime/ownership/parent-graph.types.js

@@ -0,0 +1 @@
+

package/dist/debug/runtime/ownership/parentGraph.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function t(){return{parentsOf(e){return e.parent===null?new Set:new Set([e.parent])}}}exports.parentGraph=t;

package/dist/debug/runtime/ownership/parentGraph.js

@@ -0,0 +1,10 @@
+function n() {
+  return {
+    parentsOf(e) {
+      return e.parent === null ? /* @__PURE__ */ new Set() : /* @__PURE__ */ new Set([e.parent]);
+    }
+  };
+}
+export {
+  n as parentGraph
+};

package/dist/debug/runtime/ownership/throwDisposalErrors.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function o(t,e="[Raph] Multiple resource cleanup failures."){if(t.length===1)throw t[0];if(t.length>1)throw new AggregateError(t,e)}exports.throwDisposalErrors=o;

package/dist/debug/runtime/ownership/throwDisposalErrors.js

@@ -0,0 +1,9 @@
+function l(t, e = "[Raph] Multiple resource cleanup failures.") {
+  if (t.length === 1)
+    throw t[0];
+  if (t.length > 1)
+    throw new AggregateError(t, e);
+}
+export {
+  l as throwDisposalErrors
+};

package/dist/debug/runtime/phases/RaphFrameLoop.cjs

@@ -0,0 +1 @@
+"use strict";var a=Object.defineProperty;var r=(n,e,i)=>e in n?a(n,e,{enumerable:!0,configurable:!0,writable:!0,value:i}):n[e]=i;var s=(n,e,i)=>r(n,typeof e!="symbol"?e+"":e,i);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class l{constructor(e){s(this,"_leases",new Map);s(this,"_frameHandle");s(this,"_frameHandleKind");s(this,"_scheduleToken",0);s(this,"_running",!1);s(this,"_manual",!1);this._tick=e}get running(){return this._running}acquire(e){this._leases.set(e,(this._leases.get(e)??0)+1),this._ensureRunning();let i=!0;return{owner:e,release:()=>{if(!i)return;i=!1;const t=this._leases.get(e)??0;t<=1?this._leases.delete(e):this._leases.set(e,t-1),this._reconcile()}}}start(){this._manual=!0,this._ensureRunning()}stop(){this._manual=!1,this._reconcile()}dispose(){this._manual=!1,this._leases.clear(),this._stop()}_debugState(){let e=0;for(const i of this._leases.values())e+=i;return{running:this._running,manual:this._manual,leases:e}}_onFrame(e){if(!(!this._running||e!==this._scheduleToken)){this._frameHandle=void 0,this._frameHandleKind=void 0;try{this._tick()}catch(i){throw this._running=!1,i}this._running&&this._schedule()}}_ensureRunning(){this._running||(this._running=!0,this._schedule())}_schedule(){const e=++this._scheduleToken;if(typeof globalThis.requestAnimationFrame=="function"){this._frameHandleKind="animation-frame",this._frameHandle=globalThis.requestAnimationFrame(()=>this._onFrame(e));return}this._frameHandleKind="timeout",this._frameHandle=setTimeout(()=>this._onFrame(e),16)}_reconcile(){if(this._manual||this._leases.size!==0){this._ensureRunning();return}this._stop()}_stop(){var e;this._running=!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}}exports.RaphFrameLoop=l;

package/dist/debug/runtime/phases/RaphFrameLoop.js

@@ -0,0 +1,106 @@
+var a = Object.defineProperty;
+var r = (n, e, i) => e in n ? a(n, e, { enumerable: !0, configurable: !0, writable: !0, value: i }) : n[e] = i;
+var s = (n, e, i) => r(n, typeof e != "symbol" ? e + "" : e, i);
+class h {
+  /**
+   * Создаёт frame-loop, который запрашивает выполнение runtime pipeline.
+   */
+  constructor(e) {
+    // Хранят leases и текущую browser/timeout frame registration.
+    s(this, "_leases", /* @__PURE__ */ new Map());
+    s(this, "_frameHandle");
+    s(this, "_frameHandleKind");
+    s(this, "_scheduleToken", 0);
+    // Различают фактический loop lifecycle и ручной lease.
+    s(this, "_running", !1);
+    s(this, "_manual", !1);
+    this._tick = e;
+  }
+  /**
+   * Показывает, выполняется ли автоматический frame-loop.
+   */
+  get running() {
+    return this._running;
+  }
+  /**
+   * Получает lease, удерживающий автоматический frame-loop активным.
+   */
+  acquire(e) {
+    this._leases.set(e, (this._leases.get(e) ?? 0) + 1), this._ensureRunning();
+    let i = !0;
+    return {
+      owner: e,
+      release: () => {
+        if (!i)
+          return;
+        i = !1;
+        const t = this._leases.get(e) ?? 0;
+        t <= 1 ? this._leases.delete(e) : this._leases.set(e, t - 1), this._reconcile();
+      }
+    };
+  }
+  /**
+   * Запускает manual lease frame-loop.
+   */
+  start() {
+    this._manual = !0, this._ensureRunning();
+  }
+  /**
+   * Останавливает manual lease, не затрагивая внешние leases.
+   */
+  stop() {
+    this._manual = !1, this._reconcile();
+  }
+  /**
+   * Снимает все leases и отменяет запланированный frame callback.
+   */
+  dispose() {
+    this._manual = !1, this._leases.clear(), this._stop();
+  }
+  /**
+   * Возвращает внутреннее состояние frame-loop для диагностики.
+   * @internal
+   */
+  _debugState() {
+    let e = 0;
+    for (const i of this._leases.values())
+      e += i;
+    return { running: this._running, manual: this._manual, leases: e };
+  }
+  _onFrame(e) {
+    if (!(!this._running || e !== this._scheduleToken)) {
+      this._frameHandle = void 0, this._frameHandleKind = void 0;
+      try {
+        this._tick();
+      } catch (i) {
+        throw this._running = !1, i;
+      }
+      this._running && this._schedule();
+    }
+  }
+  _ensureRunning() {
+    this._running || (this._running = !0, this._schedule());
+  }
+  _schedule() {
+    const e = ++this._scheduleToken;
+    if (typeof globalThis.requestAnimationFrame == "function") {
+      this._frameHandleKind = "animation-frame", this._frameHandle = globalThis.requestAnimationFrame(() => this._onFrame(e));
+      return;
+    }
+    this._frameHandleKind = "timeout", this._frameHandle = setTimeout(() => this._onFrame(e), 16);
+  }
+  _reconcile() {
+    if (this._manual || this._leases.size !== 0) {
+      this._ensureRunning();
+      return;
+    }
+    this._stop();
+  }
+  _stop() {
+    var e;
+    this._running = !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;
+  }
+}
+export {
+  h as RaphFrameLoop
+};

package/dist/debug/runtime/phases/RaphPhasePipeline.cjs

@@ -0,0 +1 @@
+"use strict";var q=Object.defineProperty;var D=(l,e,s)=>e in l?q(l,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):l[e]=s;var d=(l,e,s)=>D(l,typeof e!="symbol"?e+"":e,s);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const v=require("../errors.cjs"),g=Object.freeze([]),k=Object.freeze({now:0,delta:0,elapsed:0,frame:0}),A=1e4,R=1e4,E=Symbol("RaphPhaseTaskRecord");class x{constructor(e,s,t,i=()=>!1,n){d(this,"_phases",[]);d(this,"_phaseByName",new Map);d(this,"_phaseBindings",new Map);d(this,"_queues",new Map);d(this,"_deferred",new Set);d(this,"_idleWaiters",new Set);d(this,"_taskSequence",0);d(this,"_scheduled",!1);d(this,"_scheduleToken",0);d(this,"_frameHandle");d(this,"_frameHandleKind");d(this,"_configurationLocked",!1);d(this,"_running",!1);d(this,"_disposed",!1);d(this,"_firstFrameAt");d(this,"_lastFrameAt");d(this,"_frameNumber",0);d(this,"_frame",k);this._scheduler=e,this._runUntracked=s,this._resolveCause=t,this._deferSync=i,this._tracePhase=n}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=[];for(const i of e){const n=i.name.trim();if(!n)throw new Error("[Raph] Phase name must not be empty.");if(s.has(n))throw new Error(`[Raph] Duplicate phase name "${n}".`);if(i.process!==void 0&&typeof i.process!="function")throw new TypeError(`[Raph] Phase "${n}" process must be a function.`);const a=Object.freeze({name:n,...i.process===void 0?{}:{process:i.process}}),r={index:t.length,phase:a};t.push(r),s.set(n,r)}this._assertRetainedPhases(s),this._phases=t,this._phaseByName=s}addPhase(e){this.definePhases([...this.phases,e])}clearPhases(){this.definePhases([])}requirePhase(e){if(this._assertAlive(),!this._phaseByName.has(e))throw new Error(`[Raph] Phase "${e}" is not defined.`)}bindTask(e,s,t,i,n){const a=e.trim();if(this.requirePhase(a),!Number.isFinite(i))throw new TypeError("[Raph] Effect priority must be finite.");this._phaseBindings.set(a,(this._phaseBindings.get(a)??0)+1);const r={},h=this._createTask(r);Object.assign(r,{active:!0,paused:!1,pending:!1,deferred:!1,inDelivery:!1,discardAcknowledged:!1,requested:!1,resolution:"unresolved",deferCount:0,sequence:0,phase:a,priority:i,consumerOwner:s,effect:t,runner:n,task:h,deliveryCauses:g,frame:k});const f={dependencyOwner:s,allowScheduleDuringRun:!0,task:h,notify:o=>{const _=this._resolveCause(o);if(_!==void 0){const c=_.kind==="structure"?_.source:o;this._appendCause(r,_,c)}},schedule:()=>this._queue(r),enqueue:(o,_=o.source,c=!0)=>{this._appendCause(r,o,_),this._queue(r,c)},pause:()=>this._pauseTask(r),resume:()=>this._resumeTask(r),dispose:()=>this._disposeTask(r)};return r.binding=f,f}request(){this._assertAlive(),this._hasQueued()&&this._schedule()}afterFlush(){return this._assertAlive(),!this._running&&!this._scheduled&&!this._hasPending()?Promise.resolve():new Promise((e,s)=>{this._idleWaiters.add({reject:s,resolve:e})})}flush(){var n,a,r;if(this._assertAlive(),this._cancelScheduled(),this._running)return;if(!this._hasQueued()&&this._deferred.size!==0&&this._activateDeferred(),!this._hasQueued()){this._settleIdleWaiters(void 0,!1);return}this._configurationLocked=!0,this._running=!0;const e=[],s=this._nextFrame();let t=0;try{for(;this._hasQueued();){if(++t>A){const h=this._describeQueued();this._cancelAllQueued(!0,e),e.push(new Error(`[Raph] Phase flush exceeded 10000 passes.${h?` Pending: ${h}.`:""}`));break}for(const h of this._phases){if(this._disposed)break;const f=this._takePhase(h.phase.name);if(f.length===0)continue;const o=e.length;(n=this._tracePhase)==null||n.call(this,h.phase.name,"start");let _=0,c=!0,p;for(const u of f){if(u.pending=!1,!u.active||u.consumerOwner.disposed){this._disposeTask(u);continue}this._beginDelivery(u,s),p!==void 0&&(u.priority>p.priority||u.priority===p.priority&&u.sequence<p.sequence)&&(c=!1),p=u,f[_++]=u}if(f.length=_,f.length===0)continue;c||f.sort(K);const P=h.phase.process;if(P===void 0)for(const u of f)try{this._runDelivery(u)}catch(m){e.push(m)}else{const u=[];for(const w of f)u.push(w.task);const m=Object.freeze({phase:h.phase.name,frame:s,tasks:Object.freeze(u)});try{this._runUntracked(()=>P(m))}catch(w){e.push(w)}}let y=0;for(const u of f){if(u.resolution==="unresolved"){y++;try{this._deferDelivery(u)}catch(m){u.resolution="cancel",this._acknowledgeDiscard(u,!0,e),e.push(m)}}try{this._finishDelivery(u)}catch(m){u.resolution!=="run"&&this._acknowledgeDiscard(u,!0,e),u.resolution="cancel",u.inDelivery=!1,u.deliveryFirstCauseKey=void 0,u.deliveryExtraCauseKeys=void 0,u.deliveryCauses=g,e.push(m)}}y!==0&&e.push(new v.RaphPhaseProcessError(`[Raph] Phase "${h.phase.name}" left ${y} task(s) unresolved; they were deferred.`)),e.length===o?(a=this._tracePhase)==null||a.call(this,h.phase.name,"end"):(r=this._tracePhase)==null||r.call(this,h.phase.name,"error",e[e.length-1])}}}catch(h){e.push(h),this._cancelAllQueued(!0,e),this._cancelAllDeferred(!0,e)}finally{this._running=!1}try{this._deferred.size!==0&&this._scheduleDeferredTurn()}catch(h){e.push(h)}const i=e.length===1?e[0]:e.length>1?new AggregateError(e,"[Raph] Multiple phase tasks failed."):void 0;if(i!==void 0)throw this._settleIdleWaiters(i,!0),i;this._settleIdleWaiters(void 0,!1)}dispose(){if(this._disposed)return;this._disposed=!0,this._cancelScheduled(),this._cancelAllQueued(!1);const e=[...this._deferred];this._cancelAllDeferred(!1);for(const t of e)t.active=!1;this._phaseBindings.clear(),this._phases=[],this._phaseByName.clear();const s=new v.RaphDisposedError("[Raph] Phase pipeline is disposed.");this._settleIdleWaiters(s,!0)}_debugPending(){return this._scheduled||this._running||this._hasPending()}_describeQueued(){var s;const e=[];for(const t of this._phases){const i=((s=this._queues.get(t.phase.name))==null?void 0:s.filter(a=>a.active&&!a.consumerOwner.disposed))??[];if(i.length===0)continue;const n=i.slice(0,3).map(a=>{var c,p;const r=a.consumerOwner.node,h=r===void 0?void 0:r.componentId,f=r===void 0?a.consumerOwner.id:`${a.consumerOwner.id}/${r.constructor.name}/${r.type}${typeof h=="string"?`/${h}`:""}`,o=(p=(c=a.firstCause)==null?void 0:c.sourceOwner)==null?void 0:p.node,_=o===void 0?"":`<=${o.id}/${o.constructor.name}`;return`${f}${a.firstCause?`:${a.firstCause.kind}${_}`:""}`}).join(", ");e.push(`${t.phase.name}=${i.length}${n?` [${n}]`:""}`)}return e.join("; ")}_createTask(e){const s={get phase(){return e.phase},get consumerOwner(){return e.consumerOwner},get effect(){return e.effect},get causes(){return e.deliveryCauses},get frame(){return e.frame},get priority(){return e.priority},get sequence(){return e.sequence},run:()=>this._runDelivery(e),defer:()=>this._deferDelivery(e),cancel:()=>this._cancelDelivery(e)};return Object.defineProperty(s,E,{value:e}),Object.freeze(s)}_beginDelivery(e,s){e.pending=!1,e.inDelivery=!0,e.discardAcknowledged=!1,e.requested=!1,e.resolution="unresolved",e.frame=s;const t=e.firstCause;if(t===void 0){e.deliveryFirstCauseKey=void 0,e.deliveryExtraCauseKeys=void 0,e.deliveryCauses=g;return}const i=e.extraCauses;if(e.deliveryFirstCauseKey=e.firstCauseKey,e.firstCause=void 0,e.firstCauseKey=void 0,e.extraCauses=void 0,i===void 0||i.size===0){e.deliveryExtraCauseKeys=void 0,e.deliveryCauses=Object.freeze([t]);return}e.deliveryExtraCauseKeys=Object.freeze([...i.keys()]),e.deliveryCauses=Object.freeze([t,...i.values()])}_runDelivery(e){if(!e.active||e.paused||e.consumerOwner.disposed){e.resolution="cancel";return}this._assertDelivery(e),e.resolution="run",e.deferCount=0,this._runUntracked(e.runner)}_deferDelivery(e){if(!e.active||e.paused||e.consumerOwner.disposed){e.resolution="cancel";return}if(this._assertDelivery(e),e.resolution="defer",++e.deferCount>R){e.resolution="cancel";const s=[];throw this._acknowledgeDiscard(e,!0,s),s.length!==0?new AggregateError([new v.RaphPhaseProcessError(`[Raph] Phase task in "${e.phase}" exceeded 10000 deferred deliveries.`),...s],"[Raph] Phase task defer limit and recovery failed."):new v.RaphPhaseProcessError(`[Raph] Phase task in "${e.phase}" exceeded 10000 deferred deliveries.`)}}_cancelDelivery(e){if(!e.active||e.consumerOwner.disposed){e.resolution="cancel";return}this._assertDelivery(e);const s=[];if(this._acknowledgeDiscard(e,!1,s),s.length!==0)throw s.length===1?s[0]:new AggregateError(s,"[Raph] Phase task cancellation failed.");e.discardAcknowledged&&(e.requested=C(e)),e.resolution="cancel",e.deferCount=0}_finishDelivery(e){var t;if(!e.inDelivery)return;const s=e.resolution;if(e.inDelivery=!1,!e.active||e.consumerOwner.disposed){e.deliveryFirstCauseKey=void 0,e.deliveryExtraCauseKeys=void 0,e.deliveryCauses=g;return}if(e.paused){s!=="run"&&!(s==="cancel"&&e.discardAcknowledged)&&(this._restoreDeliveryCausesBeforePending(e),e.requested=!0),e.deliveryFirstCauseKey=void 0,e.deliveryExtraCauseKeys=void 0,e.deliveryCauses=g;return}if(s==="defer"&&(this._restoreDeliveryCausesBeforePending(e),e.deferred=!0,this._deferred.add(e)),e.deliveryFirstCauseKey=void 0,e.deliveryExtraCauseKeys=void 0,e.deliveryCauses=g,s!=="defer"&&(e.requested||C(e))){const i=(t=e.binding)==null?void 0:t.rearmPending;i===void 0?this._queue(e):i()}}_appendCause(e,s,t){if(!e.active)return;const i=e.firstCause;if(i===void 0){e.firstCause=s,e.firstCauseKey=t;return}if(e.firstCauseKey===t){e.firstCause=b(i,s);return}const n=e.extraCauses??(e.extraCauses=new Map),a=n.get(t);n.set(t,a===void 0?s:b(a,s))}_queue(e,s=!0){if(!e.active||e.consumerOwner.disposed||this._disposed)return;if(e.paused){e.requested=!0;return}if(e.inDelivery){e.requested=!0;return}if(e.pending){s&&this._schedule();return}if(e.deferred)return;e.discardAcknowledged=!1,e.pending=!0,e.sequence=this._taskSequence++;let t=this._queues.get(e.phase);t===void 0&&(t=[],this._queues.set(e.phase,t)),t.push(e),s&&this._schedule()}_disposeTask(e){var i;if(!e.active)return;e.active=!1,e.binding!==void 0&&(delete e.binding.cancelPending,delete e.binding.rearmPending,delete e.binding.abort,delete e.binding),e.pending=!1,e.deferred=!1,e.inDelivery&&(e.resolution="cancel"),e.firstCause=void 0,e.firstCauseKey=void 0,(i=e.extraCauses)==null||i.clear(),e.extraCauses=void 0,e.deliveryFirstCauseKey=void 0,e.deliveryExtraCauseKeys=void 0,e.deliveryCauses=g,this._deferred.delete(e);const s=this._queues.get(e.phase);if(s!==void 0){const n=s.indexOf(e);n>=0&&s.splice(n,1),s.length===0&&this._queues.delete(e.phase)}const t=(this._phaseBindings.get(e.phase)??1)-1;t===0?this._phaseBindings.delete(e.phase):this._phaseBindings.set(e.phase,t),this._hasPending()||this._cancelScheduled(),this._settleIdleWaiters(void 0,!1)}_pauseTask(e){if(!e.active||e.paused)return;e.paused=!0,e.requested=e.requested||e.pending||e.deferred||e.inDelivery&&e.resolution!=="run"&&!(e.resolution==="cancel"&&e.discardAcknowledged),e.pending=!1,e.deferred&&(e.deferred=!1,this._deferred.delete(e));const s=this._queues.get(e.phase);if(s!==void 0){const t=s.indexOf(e);t>=0&&s.splice(t,1),s.length===0&&this._queues.delete(e.phase)}this._hasPending()||this._cancelScheduled(),this._settleIdleWaiters(void 0,!1)}_resumeTask(e){!e.active||!e.paused||e.consumerOwner.disposed||(e.paused=!1,(e.requested||C(e))&&(e.requested=!1,this._queue(e)))}_restoreDeliveryCausesBeforePending(e){const s=e.deliveryCauses;if(s.length===0)return;const t=e.firstCause,i=e.firstCauseKey,n=e.extraCauses;e.firstCause=void 0,e.firstCauseKey=void 0,e.extraCauses=void 0,this._appendCause(e,s[0],e.deliveryFirstCauseKey);const a=e.deliveryExtraCauseKeys;for(let r=1;r<s.length;r++)this._appendCause(e,s[r],a[r-1]);if(t!==void 0&&(this._appendCause(e,t,i),n!==void 0))for(const[r,h]of n)this._appendCause(e,h,r)}_takePhase(e){const s=this._queues.get(e);return s===void 0?[]:(this._queues.delete(e),s)}_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))}_scheduleDeferredTurn(){if(this._scheduled||this._disposed)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._activateDeferred(),this._hasQueued()?this.flush():this._settleIdleWaiters(void 0,!1))};this._scheduler==="animationFrame"?typeof globalThis.requestAnimationFrame=="function"?(this._frameHandleKind="animation-frame",this._frameHandle=globalThis.requestAnimationFrame(s)):(this._frameHandleKind="timeout",this._frameHandle=setTimeout(s,16)):queueMicrotask(s)}_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)}_activateDeferred(){const e=[...this._deferred];this._deferred.clear();for(const s of e)s.deferred=!1,this._queue(s,!1)}_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}_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._queues.keys())if(!e.has(s))throw new Error(`[Raph] Cannot remove phase "${s}" while it has pending work.`)}_assertDelivery(e){if(!e.active||!e.inDelivery||e.resolution!=="unresolved")throw new v.RaphPhaseProcessError("[Raph] Phase task delivery is already resolved.")}_hasQueued(){for(const e of this._queues.values())if(e.some(s=>s.active&&s.pending))return!0;return!1}_hasPending(){return this._hasQueued()||this._deferred.size!==0}_cancelAllQueued(e,s=[]){const t=new Set;for(const i of this._queues.values())for(const n of i)t.add(n);this._queues.clear();for(const i of t)i.pending=!1,e&&this._acknowledgeDiscard(i,!0,s),this._clearPendingDelivery(i)}_cancelAllDeferred(e,s=[]){const t=[...this._deferred];this._deferred.clear();for(const i of t)i.deferred=!1,e&&this._acknowledgeDiscard(i,!0,s),this._clearPendingDelivery(i)}_acknowledgeDiscard(e,s,t){if(e.discardAcknowledged)return;const i=e.binding,n=i==null?void 0:i.cancelPending;if(n===void 0){e.discardAcknowledged=!0;return}try{if(n()){e.discardAcknowledged=!0;return}if(!s){t.push(new v.RaphPhaseProcessError(`[Raph] Initial effect delivery in "${e.phase}" cannot be cancelled before dependency collection.`));return}const a=i==null?void 0:i.abort;if(a===void 0){t.push(new v.RaphPhaseProcessError(`[Raph] Initial effect delivery in "${e.phase}" could not be aborted safely.`));return}a(),e.discardAcknowledged=!0}catch(a){t.push(a)}}_clearPendingDelivery(e){var s;e.requested=!1,e.firstCause=void 0,e.firstCauseKey=void 0,(s=e.extraCauses)==null||s.clear(),e.extraCauses=void 0}_settleIdleWaiters(e,s){if(!s&&(this._running||this._scheduled||this._hasPending()))return;const t=[...this._idleWaiters];this._idleWaiters.clear();for(const i of t)e===void 0?i.resolve():i.reject(e)}_assertAlive(){if(this._disposed)throw new v.RaphDisposedError("[Raph] Phase pipeline is disposed.")}}function K(l,e){return e.priority-l.priority||l.sequence-e.sequence}function C(l){return l.firstCause!==void 0}function b(l,e){const s=l.events===void 0?e.events:e.events===void 0?l.events:Object.freeze([...l.events,...e.events]),t=l.structure===void 0?e.structure:e.structure===void 0?l.structure:Object.freeze({node:e.structure.node,oldParent:l.structure.oldParent,oldIndex:l.structure.oldIndex,newParent:e.structure.newParent,newIndex:e.structure.newIndex});return Object.freeze({...e,previous:l.previous,...s===void 0?{}:{events:s},...t===void 0?{}:{structure:t}})}exports.RaphPhasePipeline=x;