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

package/dist/debug/runtime/diagnostics/RaphDebug.cjs

@@ -0,0 +1 @@
+"use strict";var f=Object.defineProperty;var l=(i,e,t)=>e in i?f(i,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):i[e]=t;var a=(i,e,t)=>l(i,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("../ownership/RaphNode.cjs"),p=Object.freeze(["action","machine","error"]),v=1024;class b{constructor(e){a(this,"_capacity",v);a(this,"_context","none");a(this,"_guards","failed");a(this,"_include",new Set(p));a(this,"_enabled",!1);a(this,"_events");a(this,"_eventStart",0);a(this,"_eventSize",0);a(this,"_sequence",0);a(this,"_operationSequence",0);a(this,"_machines");a(this,"trace");a(this,"machines");const t=e==null?void 0:e.trace;t!==void 0&&t!==!1&&(this._applyOptions(t),this._enabled=!0,this._ensureBuffer()),this.trace=Object.freeze({clear:()=>this.clear(),read:s=>this.read(s),start:s=>this.start(s),status:()=>this.status(),stop:()=>this.stop()}),this.machines=Object.freeze({list:()=>this.listMachines(),snapshot:s=>this.machineSnapshot(s)})}start(e){e!==void 0&&this._applyOptions(e),this._enabled=!0,this._ensureBuffer()}stop(){this._enabled=!1}clear(){var e;(e=this._events)==null||e.fill(void 0),this._eventStart=0,this._eventSize=0}read(e={}){const t=e.since??-1,s=e.limit??Number.POSITIVE_INFINITY;if(!Number.isFinite(s)&&s!==Number.POSITIVE_INFINITY)throw new TypeError("[Raph] Trace limit must be a positive integer.");if(s!==Number.POSITIVE_INFINITY&&(!Number.isInteger(s)||s<0))throw new TypeError("[Raph] Trace limit must be a positive integer.");const n=this._events;if(n===void 0||this._eventSize===0||s===0)return Object.freeze([]);const d=[];for(let r=0;r<this._eventSize;r++){const c=n[(this._eventStart+r)%this._capacity];if(!(c===void 0||c.sequence<=t)&&(d.push(c),d.length>=s))break}return Object.freeze(d)}status(){return Object.freeze({capacity:this._capacity,context:this._context,enabled:this._enabled,guards:this._guards,include:Object.freeze([...this._include]),size:this._eventSize})}nextOperationId(e){if(!(!this._enabled||!this._include.has(e)))return++this._operationSequence}traces(e){return this._enabled&&this._include.has(e)}record(e){if(!this._enabled||!this._include.has(e.kind)||e.guard!==void 0&&(this._guards==="none"||this._guards==="failed"&&e.guard!=="failed"))return;const t=Object.freeze({...e.causeId===void 0?{}:{causeId:e.causeId},...e.context===void 0||this._context==="none"?{}:{contextKeys:Object.freeze(Object.keys(e.context))},...e.details===void 0?{}:{details:Object.freeze({...e.details})},...e.guard===void 0?{}:{guard:e.guard},...e.operationId===void 0?{}:{operationId:e.operationId},...e.status===void 0?{}:{status:e.status},kind:e.kind,name:e.name,sequence:++this._sequence,timestamp:Date.now()}),s=this._ensureBuffer();if(this._eventSize<this._capacity){s[(this._eventStart+this._eventSize++)%this._capacity]=t;return}s[this._eventStart]=t,this._eventStart=(this._eventStart+1)%this._capacity}registerMachine(e){const t=this._machines??(this._machines=new Map);if(t.has(e.id))throw new Error(`[Raph] Machine diagnostic id "${e.id}" is already registered.`);return t.set(e.id,e),()=>{t.get(e.id)===e&&t.delete(e.id),t.size===0&&this._machines===t&&(this._machines=void 0)}}hasMachine(e){var t;return((t=this._machines)==null?void 0:t.has(e))??!1}listMachines(){var t;const e=[];for(const s of((t=this._machines)==null?void 0:t.values())??[]){const n=s.snapshot();e.push(Object.freeze({active:n.active,id:n.id,modelId:n.modelId,ownerId:n.ownerId,...n.parentId===void 0?{}:{parentId:n.parentId},revision:n.revision,status:n.status}))}return Object.freeze(e)}machineSnapshot(e){var t,s;return(s=(t=this._machines)==null?void 0:t.get(e))==null?void 0:s.snapshot()}get machineCount(){var e;return((e=this._machines)==null?void 0:e.size)??0}get traceSize(){return this._eventSize}get actorCount(){var t;let e=0;for(const s of((t=this._machines)==null?void 0:t.values())??[])e+=s.snapshot().actors.length;return e}machineTreeNodesByOwner(){var d;const e=[...((d=this._machines)==null?void 0:d.values())??[]],t=new Map(e.map(r=>[r.id,r])),s=new Map;for(const r of e){if(r.parentId===void 0||!t.has(r.parentId))continue;const c=s.get(r.parentId)??[];c.push(r),s.set(r.parentId,c)}const n=new Map;for(const r of e){if(r.parentId!==void 0&&t.has(r.parentId))continue;const c=n.get(r.ownerId)??[];c.push(_(r,s,!1)),n.set(r.ownerId,c)}return new Map([...n].map(([r,c])=>[r,Object.freeze(c)]))}_applyOptions(e){if(e.capacity!==void 0){if(!Number.isInteger(e.capacity)||e.capacity<=0)throw new TypeError("[Raph] Trace capacity must be a positive integer.");e.capacity!==this._capacity&&(this._capacity=e.capacity,this._events=void 0,this._eventStart=0,this._eventSize=0)}if(e.context!==void 0){if(e.context!=="none"&&e.context!=="keys")throw new TypeError('[Raph] Trace context must be "none" or "keys".');this._context=e.context}if(e.guards!==void 0){if(e.guards!=="none"&&e.guards!=="failed"&&e.guards!=="all")throw new TypeError('[Raph] Trace guards must be "none", "failed" or "all".');this._guards=e.guards}if(e.include!==void 0){const t=new Set;for(const s of e.include){if(s!=="action"&&s!=="machine"&&s!=="phase"&&s!=="error")throw new TypeError(`[Raph] Unsupported trace kind "${String(s)}".`);t.add(s)}this._include=t}}_ensureBuffer(){return this._events??(this._events=new Array(this._capacity))}}function o(i){const e=i instanceof h.RaphNode?i.children.map(o):[];return Object.freeze({children:Object.freeze(e),disposed:i.disposed,id:i.id,kind:i instanceof h.RaphNode?"node":"scope",resources:i._debugResourceCount(),sources:i._debugSourceCount()})}function u(i,e=new Map){const t=i instanceof h.RaphNode?i.children.map(n=>u(n,e)):[],s=i._debugResourceCount();return s!==0&&t.push(Object.freeze({children:Object.freeze([]),count:s,id:`${i.id}:resources`,kind:"resource"})),t.push(...e.get(i.id)??[]),Object.freeze({children:Object.freeze(t),disposed:i.disposed,id:i.id,kind:i instanceof h.RaphNode?"node":"scope"})}function _(i,e,t){const s=i.snapshot();return Object.freeze({children:Object.freeze((e.get(i.id)??[]).map(n=>_(n,e,!0))),id:s.id,kind:t?"actor":"machine",status:s.status})}exports.RaphDebugController=b;exports.createOwnerSnapshot=o;exports.createOwnerTree=u;

package/dist/debug/runtime/diagnostics/RaphDebug.js

@@ -0,0 +1,297 @@
+var u = Object.defineProperty;
+var f = (i, e, t) => e in i ? u(i, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : i[e] = t;
+var a = (i, e, t) => f(i, typeof e != "symbol" ? e + "" : e, t);
+import { RaphNode as h } from "../ownership/RaphNode.js";
+const _ = Object.freeze([
+  "action",
+  "machine",
+  "error"
+]), l = 1024;
+class I {
+  /**
+   * Создаёт controller; ring buffer появляется только при включённом trace.
+   */
+  constructor(e) {
+    a(this, "_capacity", l);
+    a(this, "_context", "none");
+    a(this, "_guards", "failed");
+    a(this, "_include", new Set(_));
+    a(this, "_enabled", !1);
+    a(this, "_events");
+    a(this, "_eventStart", 0);
+    a(this, "_eventSize", 0);
+    a(this, "_sequence", 0);
+    a(this, "_operationSequence", 0);
+    a(this, "_machines");
+    a(this, "trace");
+    a(this, "machines");
+    const t = e == null ? void 0 : e.trace;
+    t !== void 0 && t !== !1 && (this._applyOptions(t), this._enabled = !0, this._ensureBuffer()), this.trace = Object.freeze({
+      clear: () => this.clear(),
+      read: (s) => this.read(s),
+      start: (s) => this.start(s),
+      status: () => this.status(),
+      stop: () => this.stop()
+    }), this.machines = Object.freeze({
+      list: () => this.listMachines(),
+      snapshot: (s) => this.machineSnapshot(s)
+    });
+  }
+  // ---------------------------------------------
+  // PUBLIC API
+  // ---------------------------------------------
+  /**
+   * Включает trace с текущими или явно переданными настройками.
+   */
+  start(e) {
+    e !== void 0 && this._applyOptions(e), this._enabled = !0, this._ensureBuffer();
+  }
+  /**
+   * Останавливает запись, сохраняя уже накопленные events.
+   */
+  stop() {
+    this._enabled = !1;
+  }
+  /**
+   * Удаляет все накопленные events, не меняя status trace.
+   */
+  clear() {
+    var e;
+    (e = this._events) == null || e.fill(void 0), this._eventStart = 0, this._eventSize = 0;
+  }
+  /**
+   * Формирует immutable chronological copy ring buffer.
+   */
+  read(e = {}) {
+    const t = e.since ?? -1, s = e.limit ?? Number.POSITIVE_INFINITY;
+    if (!Number.isFinite(s) && s !== Number.POSITIVE_INFINITY)
+      throw new TypeError("[Raph] Trace limit must be a positive integer.");
+    if (s !== Number.POSITIVE_INFINITY && (!Number.isInteger(s) || s < 0))
+      throw new TypeError("[Raph] Trace limit must be a positive integer.");
+    const n = this._events;
+    if (n === void 0 || this._eventSize === 0 || s === 0)
+      return Object.freeze([]);
+    const d = [];
+    for (let r = 0; r < this._eventSize; r++) {
+      const c = n[(this._eventStart + r) % this._capacity];
+      if (!(c === void 0 || c.sequence <= t) && (d.push(c), d.length >= s))
+        break;
+    }
+    return Object.freeze(d);
+  }
+  /**
+   * Возвращает текущую конфигурацию и заполнение buffer.
+   */
+  status() {
+    return Object.freeze({
+      capacity: this._capacity,
+      context: this._context,
+      enabled: this._enabled,
+      guards: this._guards,
+      include: Object.freeze([...this._include]),
+      size: this._eventSize
+    });
+  }
+  /**
+   * Выделяет operation ID только когда trace активен для этого kind.
+   * @internal
+   */
+  nextOperationId(e) {
+    if (!(!this._enabled || !this._include.has(e)))
+      return ++this._operationSequence;
+  }
+  /**
+   * Проверяет active trace path без выделения operation ID.
+   *
+   * @internal
+   */
+  traces(e) {
+    return this._enabled && this._include.has(e);
+  }
+  /**
+   * Записывает одно событие без allocations/timestamp на disabled path.
+   * @internal
+   */
+  record(e) {
+    if (!this._enabled || !this._include.has(e.kind) || e.guard !== void 0 && (this._guards === "none" || this._guards === "failed" && e.guard !== "failed"))
+      return;
+    const t = Object.freeze({
+      ...e.causeId === void 0 ? {} : { causeId: e.causeId },
+      ...e.context === void 0 || this._context === "none" ? {} : { contextKeys: Object.freeze(Object.keys(e.context)) },
+      ...e.details === void 0 ? {} : { details: Object.freeze({ ...e.details }) },
+      ...e.guard === void 0 ? {} : { guard: e.guard },
+      ...e.operationId === void 0 ? {} : { operationId: e.operationId },
+      ...e.status === void 0 ? {} : { status: e.status },
+      kind: e.kind,
+      name: e.name,
+      sequence: ++this._sequence,
+      timestamp: Date.now()
+    }), s = this._ensureBuffer();
+    if (this._eventSize < this._capacity) {
+      s[(this._eventStart + this._eventSize++) % this._capacity] = t;
+      return;
+    }
+    s[this._eventStart] = t, this._eventStart = (this._eventStart + 1) % this._capacity;
+  }
+  /**
+   * Регистрирует read-only machine projection без импорта machine engine в Runtime.
+   * @internal
+   */
+  registerMachine(e) {
+    const t = this._machines ?? (this._machines = /* @__PURE__ */ new Map());
+    if (t.has(e.id))
+      throw new Error(`[Raph] Machine diagnostic id "${e.id}" is already registered.`);
+    return t.set(e.id, e), () => {
+      t.get(e.id) === e && t.delete(e.id), t.size === 0 && this._machines === t && (this._machines = void 0);
+    };
+  }
+  /**
+   * Проверяет diagnostic identity без создания public snapshot.
+   *
+   * @internal
+   */
+  hasMachine(e) {
+    var t;
+    return ((t = this._machines) == null ? void 0 : t.has(e)) ?? !1;
+  }
+  /**
+   * Возвращает compact machine summaries без выполнения guards.
+   */
+  listMachines() {
+    var t;
+    const e = [];
+    for (const s of ((t = this._machines) == null ? void 0 : t.values()) ?? []) {
+      const n = s.snapshot();
+      e.push(Object.freeze({
+        active: n.active,
+        id: n.id,
+        modelId: n.modelId,
+        ownerId: n.ownerId,
+        ...n.parentId === void 0 ? {} : { parentId: n.parentId },
+        revision: n.revision,
+        status: n.status
+      }));
+    }
+    return Object.freeze(e);
+  }
+  /**
+   * Читает готовый machine snapshot; transition selection и guards не вызываются.
+   */
+  machineSnapshot(e) {
+    var t, s;
+    return (s = (t = this._machines) == null ? void 0 : t.get(e)) == null ? void 0 : s.snapshot();
+  }
+  /**
+   * Возвращает число зарегистрированных machines.
+   * @internal
+   */
+  get machineCount() {
+    var e;
+    return ((e = this._machines) == null ? void 0 : e.size) ?? 0;
+  }
+  /**
+   * Возвращает число текущих trace events.
+   * @internal
+   */
+  get traceSize() {
+    return this._eventSize;
+  }
+  /** Возвращает число child actors по уже готовым snapshots. @internal */
+  get actorCount() {
+    var t;
+    let e = 0;
+    for (const s of ((t = this._machines) == null ? void 0 : t.values()) ?? [])
+      e += s.snapshot().actors.length;
+    return e;
+  }
+  /** Группирует machine/actor ветви по фактическому lifecycle owner. @internal */
+  machineTreeNodesByOwner() {
+    var d;
+    const e = [...((d = this._machines) == null ? void 0 : d.values()) ?? []], t = new Map(e.map((r) => [r.id, r])), s = /* @__PURE__ */ new Map();
+    for (const r of e) {
+      if (r.parentId === void 0 || !t.has(r.parentId))
+        continue;
+      const c = s.get(r.parentId) ?? [];
+      c.push(r), s.set(r.parentId, c);
+    }
+    const n = /* @__PURE__ */ new Map();
+    for (const r of e) {
+      if (r.parentId !== void 0 && t.has(r.parentId))
+        continue;
+      const c = n.get(r.ownerId) ?? [];
+      c.push(o(r, s, !1)), n.set(r.ownerId, c);
+    }
+    return new Map([...n].map(([r, c]) => [r, Object.freeze(c)]));
+  }
+  // ---------------------------------------------
+  // PRIVATE
+  // ---------------------------------------------
+  _applyOptions(e) {
+    if (e.capacity !== void 0) {
+      if (!Number.isInteger(e.capacity) || e.capacity <= 0)
+        throw new TypeError("[Raph] Trace capacity must be a positive integer.");
+      e.capacity !== this._capacity && (this._capacity = e.capacity, this._events = void 0, this._eventStart = 0, this._eventSize = 0);
+    }
+    if (e.context !== void 0) {
+      if (e.context !== "none" && e.context !== "keys")
+        throw new TypeError('[Raph] Trace context must be "none" or "keys".');
+      this._context = e.context;
+    }
+    if (e.guards !== void 0) {
+      if (e.guards !== "none" && e.guards !== "failed" && e.guards !== "all")
+        throw new TypeError('[Raph] Trace guards must be "none", "failed" or "all".');
+      this._guards = e.guards;
+    }
+    if (e.include !== void 0) {
+      const t = /* @__PURE__ */ new Set();
+      for (const s of e.include) {
+        if (s !== "action" && s !== "machine" && s !== "phase" && s !== "error")
+          throw new TypeError(`[Raph] Unsupported trace kind "${String(s)}".`);
+        t.add(s);
+      }
+      this._include = t;
+    }
+  }
+  _ensureBuffer() {
+    return this._events ?? (this._events = new Array(this._capacity));
+  }
+}
+function p(i) {
+  const e = i instanceof h ? i.children.map(p) : [];
+  return Object.freeze({
+    children: Object.freeze(e),
+    disposed: i.disposed,
+    id: i.id,
+    kind: i instanceof h ? "node" : "scope",
+    resources: i._debugResourceCount(),
+    sources: i._debugSourceCount()
+  });
+}
+function v(i, e = /* @__PURE__ */ new Map()) {
+  const t = i instanceof h ? i.children.map((n) => v(n, e)) : [], s = i._debugResourceCount();
+  return s !== 0 && t.push(Object.freeze({
+    children: Object.freeze([]),
+    count: s,
+    id: `${i.id}:resources`,
+    kind: "resource"
+  })), t.push(...e.get(i.id) ?? []), Object.freeze({
+    children: Object.freeze(t),
+    disposed: i.disposed,
+    id: i.id,
+    kind: i instanceof h ? "node" : "scope"
+  });
+}
+function o(i, e, t) {
+  const s = i.snapshot();
+  return Object.freeze({
+    children: Object.freeze((e.get(i.id) ?? []).map((n) => o(n, e, !0))),
+    id: s.id,
+    kind: t ? "actor" : "machine",
+    status: s.status
+  });
+}
+export {
+  I as RaphDebugController,
+  p as createOwnerSnapshot,
+  v as createOwnerTree
+};

package/dist/debug/runtime/errors.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../api/errors.cjs");class o extends r.RaphError{}class s extends r.RaphError{}class a extends r.RaphError{}exports.RaphActionError=o;exports.RaphCrossRuntimeError=a;exports.RaphDisposedError=s;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../api/errors.cjs");class e extends r.RaphError{}class o extends r.RaphError{}class a extends r.RaphError{}class p extends r.RaphError{}exports.RaphActionError=e;exports.RaphCrossRuntimeError=a;exports.RaphDisposedError=o;exports.RaphPhaseProcessError=p;

package/dist/debug/runtime/errors.js

@@ -1,12 +1,15 @@
 import { RaphError as r } from "../api/errors.js";
-class e extends r {
+class o extends r {
 }
 class a extends r {
 }
 class p extends r {
 }
+class t extends r {
+}
 export {
-  e as RaphActionError,
+  o as RaphActionError,
   p as RaphCrossRuntimeError,
-  a as RaphDisposedError
+  a as RaphDisposedError,
+  t as RaphPhaseProcessError
 };

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

@@ -0,0 +1 @@
+"use strict";var f=Object.defineProperty;var l=(i,e,s)=>e in i?f(i,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):i[e]=s;var o=(i,e,s)=>l(i,typeof e!="symbol"?e+"":e,s);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _=require("../errors.cjs");class d{constructor(e,s=null){o(this,"_registrations");o(this,"_children");o(this,"_selfPaused",!1);o(this,"_ancestorPauses",0);o(this,"_disposed",!1);o(this,"_releaseOwner");o(this,"_parent");if(this._owner=e,e._assertAlive(),(s==null?void 0:s.disposed)===!0)throw new _.RaphDisposedError("[Raph] Parent effect scope is disposed.");if(s!==null&&s._owner.runtime!==e.runtime)throw new TypeError("[Raph] Parent effect scope belongs to another runtime.");this._parent=s,s==null||s._addChild(this),this._ancestorPauses=(s==null?void 0:s.paused)===!0?1:0,this._releaseOwner=e.own(()=>this.dispose())}get paused(){return this._selfPaused||this._ancestorPauses!==0}get disposed(){return this._disposed}fork(e){return this._assertAlive(),new d(e,this)}effect(e,s,t){return this._assertAlive(),this._add(this._owner.runtime._effectRegistration(this._owner,e,s,t,this.paused))}watch(e,s,t,r){return this._assertAlive(),this._add(this._owner.runtime._watchRegistration(this._owner,e,s,t,r,this.paused))}pause(){this._assertAlive(),this._owner.runtime._runPhaseTransition(()=>this._pause())}resume(){this._assertAlive(),this._owner.runtime._runPhaseTransition(()=>this._resume())}_pause(){if(this._selfPaused)return;const e=this.paused;if(this._selfPaused=!0,e)return;const s=[];for(const t of this._registrations??[])try{t.registration.pause()}catch(r){s.push(r)}for(const t of this._children??[])try{t._changeAncestorPause(1)}catch(r){s.push(r)}n(s,"[Raph] Pausable effect scope pause failed.")}_resume(){if(!this._selfPaused||(this._selfPaused=!1,this.paused))return;const e=[];for(const s of this._registrations??[])try{s.registration.resume()}catch(t){e.push(t)}for(const s of this._children??[])try{s._changeAncestorPause(-1)}catch(t){e.push(t)}n(e,"[Raph] Pausable effect scope resume failed.")}dispose(){var t,r,a,u;if(this._disposed)return;this._disposed=!0;const e=this._owner.disposed,s=[];for(const h of[...this._children??[]])try{h.dispose()}catch(c){s.push(c)}(t=this._children)==null||t.clear(),this._children=void 0;for(const h of this._registrations??[])if(h.active=!1,!e)try{h.registration.dispose()}catch(c){s.push(c)}if((r=this._registrations)==null||r.clear(),this._registrations=void 0,(u=(a=this._parent)==null?void 0:a._children)==null||u.delete(this),!e)try{this._releaseOwner()}catch(h){s.push(h)}n(s,"[Raph] Pausable effect scope disposal failed.")}_add(e){if(this._disposed||this._owner.disposed)return e.dispose(),p;const s={active:!0,registration:e};return(this._registrations??(this._registrations=new Set)).add(s),()=>{var t;s.active&&(s.active=!1,(t=this._registrations)==null||t.delete(s),e.dispose())}}_assertAlive(){if(this._disposed||this._owner.disposed)throw new _.RaphDisposedError("[Raph] Pausable effect scope is disposed.")}_addChild(e){(this._children??(this._children=new Set)).add(e)}_changeAncestorPause(e){if(this._disposed)return;const s=this.paused;if(this._ancestorPauses+=e,this._ancestorPauses<0)throw this._ancestorPauses=0,new Error("[Raph] Effect scope ancestor pause state is unbalanced.");if(s===this.paused)return;const t=[];for(const r of this._registrations??[])try{this.paused?r.registration.pause():r.registration.resume()}catch(a){t.push(a)}for(const r of this._children??[])try{r._changeAncestorPause(e)}catch(a){t.push(a)}n(t,"[Raph] Pausable effect scope ancestor transition failed.")}}function n(i,e){if(i.length===1)throw i[0];if(i.length>1)throw new AggregateError(i,e)}function p(){}exports.RaphEffectScope=d;

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

@@ -0,0 +1,171 @@
+var f = Object.defineProperty;
+var l = (r, e, s) => e in r ? f(r, e, { enumerable: !0, configurable: !0, writable: !0, value: s }) : r[e] = s;
+var o = (r, e, s) => l(r, typeof e != "symbol" ? e + "" : e, s);
+import { RaphDisposedError as u } from "../errors.js";
+class _ {
+  constructor(e, s = null) {
+    o(this, "_registrations");
+    o(this, "_children");
+    o(this, "_selfPaused", !1);
+    o(this, "_ancestorPauses", 0);
+    o(this, "_disposed", !1);
+    o(this, "_releaseOwner");
+    o(this, "_parent");
+    if (this._owner = e, e._assertAlive(), (s == null ? void 0 : s.disposed) === !0)
+      throw new u("[Raph] Parent effect scope is disposed.");
+    if (s !== null && s._owner.runtime !== e.runtime)
+      throw new TypeError("[Raph] Parent effect scope belongs to another runtime.");
+    this._parent = s, s == null || s._addChild(this), this._ancestorPauses = (s == null ? void 0 : s.paused) === !0 ? 1 : 0, this._releaseOwner = e.own(() => this.dispose());
+  }
+  get paused() {
+    return this._selfPaused || this._ancestorPauses !== 0;
+  }
+  get disposed() {
+    return this._disposed;
+  }
+  fork(e) {
+    return this._assertAlive(), new _(e, this);
+  }
+  effect(e, s, t) {
+    return this._assertAlive(), this._add(this._owner.runtime._effectRegistration(
+      this._owner,
+      e,
+      s,
+      t,
+      this.paused
+    ));
+  }
+  watch(e, s, t, i) {
+    return this._assertAlive(), this._add(this._owner.runtime._watchRegistration(
+      this._owner,
+      e,
+      s,
+      t,
+      i,
+      this.paused
+    ));
+  }
+  pause() {
+    this._assertAlive(), this._owner.runtime._runPhaseTransition(() => this._pause());
+  }
+  resume() {
+    this._assertAlive(), this._owner.runtime._runPhaseTransition(() => this._resume());
+  }
+  _pause() {
+    if (this._selfPaused)
+      return;
+    const e = this.paused;
+    if (this._selfPaused = !0, e)
+      return;
+    const s = [];
+    for (const t of this._registrations ?? [])
+      try {
+        t.registration.pause();
+      } catch (i) {
+        s.push(i);
+      }
+    for (const t of this._children ?? [])
+      try {
+        t._changeAncestorPause(1);
+      } catch (i) {
+        s.push(i);
+      }
+    n(s, "[Raph] Pausable effect scope pause failed.");
+  }
+  _resume() {
+    if (!this._selfPaused || (this._selfPaused = !1, this.paused))
+      return;
+    const e = [];
+    for (const s of this._registrations ?? [])
+      try {
+        s.registration.resume();
+      } catch (t) {
+        e.push(t);
+      }
+    for (const s of this._children ?? [])
+      try {
+        s._changeAncestorPause(-1);
+      } catch (t) {
+        e.push(t);
+      }
+    n(e, "[Raph] Pausable effect scope resume failed.");
+  }
+  dispose() {
+    var t, i, h, d;
+    if (this._disposed)
+      return;
+    this._disposed = !0;
+    const e = this._owner.disposed, s = [];
+    for (const a of [...this._children ?? []])
+      try {
+        a.dispose();
+      } catch (c) {
+        s.push(c);
+      }
+    (t = this._children) == null || t.clear(), this._children = void 0;
+    for (const a of this._registrations ?? [])
+      if (a.active = !1, !e)
+        try {
+          a.registration.dispose();
+        } catch (c) {
+          s.push(c);
+        }
+    if ((i = this._registrations) == null || i.clear(), this._registrations = void 0, (d = (h = this._parent) == null ? void 0 : h._children) == null || d.delete(this), !e)
+      try {
+        this._releaseOwner();
+      } catch (a) {
+        s.push(a);
+      }
+    n(s, "[Raph] Pausable effect scope disposal failed.");
+  }
+  _add(e) {
+    if (this._disposed || this._owner.disposed)
+      return e.dispose(), p;
+    const s = { active: !0, registration: e };
+    return (this._registrations ?? (this._registrations = /* @__PURE__ */ new Set())).add(s), () => {
+      var t;
+      s.active && (s.active = !1, (t = this._registrations) == null || t.delete(s), e.dispose());
+    };
+  }
+  _assertAlive() {
+    if (this._disposed || this._owner.disposed)
+      throw new u("[Raph] Pausable effect scope is disposed.");
+  }
+  _addChild(e) {
+    (this._children ?? (this._children = /* @__PURE__ */ new Set())).add(e);
+  }
+  _changeAncestorPause(e) {
+    if (this._disposed)
+      return;
+    const s = this.paused;
+    if (this._ancestorPauses += e, this._ancestorPauses < 0)
+      throw this._ancestorPauses = 0, new Error("[Raph] Effect scope ancestor pause state is unbalanced.");
+    if (s === this.paused)
+      return;
+    const t = [];
+    for (const i of this._registrations ?? [])
+      try {
+        this.paused ? i.registration.pause() : i.registration.resume();
+      } catch (h) {
+        t.push(h);
+      }
+    for (const i of this._children ?? [])
+      try {
+        i._changeAncestorPause(e);
+      } catch (h) {
+        t.push(h);
+      }
+    n(t, "[Raph] Pausable effect scope ancestor transition failed.");
+  }
+}
+function n(r, e) {
+  if (r.length === 1)
+    throw r[0];
+  if (r.length > 1)
+    throw new AggregateError(r, e);
+}
+function p() {
+}
+export {
+  _ as RaphEffectScope
+};

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

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