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

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

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

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

@@ -0,0 +1,287 @@
+import { RaphNode as c } from "../ownership/RaphNode.js";
+const o = Object.freeze([
+  "action",
+  "machine",
+  "error"
+]), u = 1024;
+class p {
+  _capacity = u;
+  _context = "none";
+  _guards = "failed";
+  _include = new Set(o);
+  _enabled = !1;
+  _events;
+  _eventStart = 0;
+  _eventSize = 0;
+  _sequence = 0;
+  _operationSequence = 0;
+  _machines;
+  trace;
+  machines;
+  /**
+   * Создаёт controller; ring buffer появляется только при включённом trace.
+   */
+  constructor(e) {
+    const s = e?.trace;
+    s !== void 0 && s !== !1 && (this._applyOptions(s), this._enabled = !0, this._ensureBuffer()), this.trace = Object.freeze({
+      clear: () => this.clear(),
+      read: (t) => this.read(t),
+      start: (t) => this.start(t),
+      status: () => this.status(),
+      stop: () => this.stop()
+    }), this.machines = Object.freeze({
+      list: () => this.listMachines(),
+      snapshot: (t) => this.machineSnapshot(t)
+    });
+  }
+  // ---------------------------------------------
+  // 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() {
+    this._events?.fill(void 0), this._eventStart = 0, this._eventSize = 0;
+  }
+  /**
+   * Формирует immutable chronological copy ring buffer.
+   */
+  read(e = {}) {
+    const s = e.since ?? -1, t = e.limit ?? Number.POSITIVE_INFINITY;
+    if (!Number.isFinite(t) && t !== Number.POSITIVE_INFINITY)
+      throw new TypeError("[Raph] Trace limit must be a positive integer.");
+    if (t !== Number.POSITIVE_INFINITY && (!Number.isInteger(t) || t < 0))
+      throw new TypeError("[Raph] Trace limit must be a positive integer.");
+    const a = this._events;
+    if (a === void 0 || this._eventSize === 0 || t === 0)
+      return Object.freeze([]);
+    const n = [];
+    for (let r = 0; r < this._eventSize; r++) {
+      const d = a[(this._eventStart + r) % this._capacity];
+      if (!(d === void 0 || d.sequence <= s) && (n.push(d), n.length >= t))
+        break;
+    }
+    return Object.freeze(n);
+  }
+  /**
+   * Возвращает текущую конфигурацию и заполнение 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 s = 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()
+    }), t = this._ensureBuffer();
+    if (this._eventSize < this._capacity) {
+      t[(this._eventStart + this._eventSize++) % this._capacity] = s;
+      return;
+    }
+    t[this._eventStart] = s, this._eventStart = (this._eventStart + 1) % this._capacity;
+  }
+  /**
+   * Регистрирует read-only machine projection без импорта machine engine в Runtime.
+   * @internal
+   */
+  registerMachine(e) {
+    const s = this._machines ??= /* @__PURE__ */ new Map();
+    if (s.has(e.id))
+      throw new Error(`[Raph] Machine diagnostic id "${e.id}" is already registered.`);
+    return s.set(e.id, e), () => {
+      s.get(e.id) === e && s.delete(e.id), s.size === 0 && this._machines === s && (this._machines = void 0);
+    };
+  }
+  /**
+   * Проверяет diagnostic identity без создания public snapshot.
+   *
+   * @internal
+   */
+  hasMachine(e) {
+    return this._machines?.has(e) ?? !1;
+  }
+  /**
+   * Возвращает compact machine summaries без выполнения guards.
+   */
+  listMachines() {
+    const e = [];
+    for (const s of this._machines?.values() ?? []) {
+      const t = s.snapshot();
+      e.push(Object.freeze({
+        active: t.active,
+        id: t.id,
+        modelId: t.modelId,
+        ownerId: t.ownerId,
+        ...t.parentId === void 0 ? {} : { parentId: t.parentId },
+        revision: t.revision,
+        status: t.status
+      }));
+    }
+    return Object.freeze(e);
+  }
+  /**
+   * Читает готовый machine snapshot; transition selection и guards не вызываются.
+   */
+  machineSnapshot(e) {
+    return this._machines?.get(e)?.snapshot();
+  }
+  /**
+   * Возвращает число зарегистрированных machines.
+   * @internal
+   */
+  get machineCount() {
+    return this._machines?.size ?? 0;
+  }
+  /**
+   * Возвращает число текущих trace events.
+   * @internal
+   */
+  get traceSize() {
+    return this._eventSize;
+  }
+  /** Возвращает число child actors по уже готовым snapshots. @internal */
+  get actorCount() {
+    let e = 0;
+    for (const s of this._machines?.values() ?? [])
+      e += s.snapshot().actors.length;
+    return e;
+  }
+  /** Группирует machine/actor ветви по фактическому lifecycle owner. @internal */
+  machineTreeNodesByOwner() {
+    const e = [...this._machines?.values() ?? []], s = new Map(e.map((n) => [n.id, n])), t = /* @__PURE__ */ new Map();
+    for (const n of e) {
+      if (n.parentId === void 0 || !s.has(n.parentId))
+        continue;
+      const r = t.get(n.parentId) ?? [];
+      r.push(n), t.set(n.parentId, r);
+    }
+    const a = /* @__PURE__ */ new Map();
+    for (const n of e) {
+      if (n.parentId !== void 0 && s.has(n.parentId))
+        continue;
+      const r = a.get(n.ownerId) ?? [];
+      r.push(h(n, t, !1)), a.set(n.ownerId, r);
+    }
+    return new Map([...a].map(([n, r]) => [n, Object.freeze(r)]));
+  }
+  // ---------------------------------------------
+  // 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 s = /* @__PURE__ */ new Set();
+      for (const t of e.include) {
+        if (t !== "action" && t !== "machine" && t !== "phase" && t !== "error")
+          throw new TypeError(`[Raph] Unsupported trace kind "${String(t)}".`);
+        s.add(t);
+      }
+      this._include = s;
+    }
+  }
+  _ensureBuffer() {
+    return this._events ??= new Array(this._capacity);
+  }
+}
+function f(i) {
+  const e = i instanceof c ? i.children.map(f) : [];
+  return Object.freeze({
+    children: Object.freeze(e),
+    disposed: i.disposed,
+    id: i.id,
+    kind: i instanceof c ? "node" : "scope",
+    resources: i._debugResourceCount(),
+    sources: i._debugSourceCount()
+  });
+}
+function _(i, e = /* @__PURE__ */ new Map()) {
+  const s = i instanceof c ? i.children.map((a) => _(a, e)) : [], t = i._debugResourceCount();
+  return t !== 0 && s.push(Object.freeze({
+    children: Object.freeze([]),
+    count: t,
+    id: `${i.id}:resources`,
+    kind: "resource"
+  })), s.push(...e.get(i.id) ?? []), Object.freeze({
+    children: Object.freeze(s),
+    disposed: i.disposed,
+    id: i.id,
+    kind: i instanceof c ? "node" : "scope"
+  });
+}
+function h(i, e, s) {
+  const t = i.snapshot();
+  return Object.freeze({
+    children: Object.freeze((e.get(i.id) ?? []).map((a) => h(a, e, !0))),
+    id: t.id,
+    kind: s ? "actor" : "machine",
+    status: t.status
+  });
+}
+export {
+  p as RaphDebugController,
+  f as createOwnerSnapshot,
+  _ 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";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("../errors.cjs"),_=16;class c{constructor(s,e=null){if(this._owner=s,s._assertAlive(),e?.disposed===!0)throw new u.RaphDisposedError("[Raph] Parent effect scope is disposed.");if(e!==null&&e._owner.runtime!==s.runtime)throw new TypeError("[Raph] Parent effect scope belongs to another runtime.");this._parent=e,e?._addChild(this),this._ancestorPauses=e?.paused===!0?1:0,this._releaseOwner=s.own(()=>this.dispose())}_registrations;_pruneAt=_;_children;_selfPaused=!1;_ancestorPauses=0;_disposed=!1;_releaseOwner;_parent;get paused(){return this._selfPaused||this._ancestorPauses!==0}get disposed(){return this._disposed}fork(s){return this._assertAlive(),new c(s,this)}effect(s,e,t){return this._assertAlive(),this._add(this._owner.runtime._effectRegistration(this._owner,s,e,t,this.paused))}bindEffect(s,e,t){this._assertAlive(),this._track(this._owner.runtime._effectRegistration(this._owner,s,e,t,this.paused,!0))}effectGroup(s,e,t,r,i){this._assertAlive();const o=this._owner.runtime._effectGroupRegistration(this._owner,s,e,t,r,i,this.paused);return this._track(o),o}watch(s,e,t,r){return this._assertAlive(),this._add(this._owner.runtime._watchRegistration(this._owner,s,e,t,r,this.paused))}_registerEffect(s,e,t,r,i,o){this._assertAlive();const h=this._owner.runtime._effectRegistration(this._owner,s,e,t,this.paused,r,i,o);o?.()||this._track(h)}_registerWatch(s,e,t,r,i,o){this._assertAlive();const h=this._owner.runtime._watchRegistration(this._owner,s,e,t,r,this.paused,i,o);o?.()||this._track(h)}_registerEffectGroup(s,e,t,r,i){this._assertAlive();const o=this._owner.runtime._effectGroupRegistration(this._owner,s,e,t,r,i,this.paused);return this._track(o),o}pause(){this._assertAlive(),this._owner.runtime._runPhaseTransition(()=>this._pause())}resume(){this._assertAlive(),this._owner.runtime._runPhaseTransition(()=>this._resume())}_pause(){if(this._selfPaused)return;const s=this.paused;if(this._selfPaused=!0,s)return;const e=[];for(const t of this._registrations??[])try{t.registration.pause()}catch(r){e.push(r)}for(const t of this._children??[])try{t._changeAncestorPause(1)}catch(r){e.push(r)}n(e,"[Raph] Pausable effect scope pause failed.")}_resume(){if(!this._selfPaused||(this._selfPaused=!1,this.paused))return;const s=[];for(const e of this._registrations??[])try{e.registration.resume()}catch(t){s.push(t)}for(const e of this._children??[])try{e._changeAncestorPause(-1)}catch(t){s.push(t)}n(s,"[Raph] Pausable effect scope resume failed.")}dispose(){if(this._disposed)return;this._disposed=!0;const s=this._owner.disposed,e=[];for(const t of[...this._children??[]])try{t.dispose()}catch(r){e.push(r)}this._children?.clear(),this._children=void 0;for(const t of this._registrations??[])if(t.active=!1,!s)try{t.registration.dispose()}catch(r){e.push(r)}if(this._registrations?.clear(),this._registrations=void 0,this._parent?._children?.delete(this),!s)try{this._releaseOwner()}catch(t){e.push(t)}n(e,"[Raph] Pausable effect scope disposal failed.")}_add(s){const e=this._track(s);return e===void 0?d:()=>{e.active&&(e.active=!1,this._registrations?.delete(e),e.registration.dispose())}}_track(s){if(this._disposed||this._owner.disposed){s.dispose();return}const e={active:!0,registration:s},t=this._registrations??=new Set;return t.add(e),t.size>=this._pruneAt&&this._prune(t),e}_prune(s){for(const e of s)e.registration.active||(e.active=!1,s.delete(e));this._pruneAt=Math.max(_,s.size*2)}_assertAlive(){if(this._disposed||this._owner.disposed)throw new u.RaphDisposedError("[Raph] Pausable effect scope is disposed.")}_addChild(s){(this._children??=new Set).add(s)}_changeAncestorPause(s){if(this._disposed)return;const e=this.paused;if(this._ancestorPauses+=s,this._ancestorPauses<0)throw this._ancestorPauses=0,new Error("[Raph] Effect scope ancestor pause state is unbalanced.");if(e===this.paused)return;const t=[];for(const r of this._registrations??[])try{this.paused?r.registration.pause():r.registration.resume()}catch(i){t.push(i)}for(const r of this._children??[])try{r._changeAncestorPause(s)}catch(i){t.push(i)}n(t,"[Raph] Pausable effect scope ancestor transition failed.")}}function n(a,s){if(a.length===1)throw a[0];if(a.length>1)throw new AggregateError(a,s)}function d(){}exports.RaphEffectScope=c;

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

@@ -0,0 +1,304 @@
+import { RaphDisposedError as c } from "../errors.js";
+const u = 16;
+class _ {
+  constructor(s, e = null) {
+    if (this._owner = s, s._assertAlive(), e?.disposed === !0)
+      throw new c("[Raph] Parent effect scope is disposed.");
+    if (e !== null && e._owner.runtime !== s.runtime)
+      throw new TypeError("[Raph] Parent effect scope belongs to another runtime.");
+    this._parent = e, e?._addChild(this), this._ancestorPauses = e?.paused === !0 ? 1 : 0, this._releaseOwner = s.own(() => this.dispose());
+  }
+  _registrations;
+  // Число регистраций, при котором группа в следующий раз забывает остановленные.
+  _pruneAt = u;
+  _children;
+  _selfPaused = !1;
+  _ancestorPauses = 0;
+  _disposed = !1;
+  _releaseOwner;
+  _parent;
+  get paused() {
+    return this._selfPaused || this._ancestorPauses !== 0;
+  }
+  get disposed() {
+    return this._disposed;
+  }
+  fork(s) {
+    return this._assertAlive(), new _(s, this);
+  }
+  effect(s, e, t) {
+    return this._assertAlive(), this._add(this._owner.runtime._effectRegistration(
+      this._owner,
+      s,
+      e,
+      t,
+      this.paused
+    ));
+  }
+  /**
+   * Регистрирует в этой группе phase effect без task и без disposer: тело
+   * вызывается без аргументов, а binding живёт до освобождения группы или её
+   * владельца. Pause и resume группы действуют на него так же, как на effect,
+   * зарегистрированный через `effect()`.
+   *
+   * Binding, зарегистрированный внутри тела другого effect, останавливает ещё и
+   * перезапуск этого effect. Остановленный binding больше не исполняется и не
+   * реагирует на pause и resume; группа забывает его не сразу, а когда число её
+   * регистраций удваивается, поэтому остановленных регистраций в группе не
+   * больше, чем действующих, либо меньше `PRUNE_FLOOR`.
+   */
+  bindEffect(s, e, t) {
+    this._assertAlive(), this._track(this._owner.runtime._effectRegistration(
+      this._owner,
+      s,
+      e,
+      t,
+      this.paused,
+      !0
+    ));
+  }
+  /**
+   * Регистрирует в этой группе регистраций группу из `count` phase effects на
+   * одном binding, как `owner.effectGroup()`: без task и без disposer, с
+   * отдельным набором зависимостей у каждого slot и с запуском slots через
+   * `start()` возвращённой группы. Pause и resume действуют на все slots
+   * сразу; slots, запущенные или изменившиеся за время pause, исполняются
+   * одной доставкой после resume. Binding живёт до освобождения этой группы
+   * регистраций или её владельца.
+   *
+   * Pause изнутри тела slot останавливает доставку: оставшиеся slots
+   * исполняются после resume, и причины прерванной доставки приходят в
+   * `causes` следующей целиком, вместе с причинами уже исполненных slots.
+   *
+   * Освобождение отличается от отдельных bindings этой же группы регистраций:
+   * slots останавливаются в порядке, обратном порядку номеров, а не в порядке
+   * регистрации, и несколько сбоев их cleanup приходят одним вложенным
+   * `AggregateError` с сообщением `[Raph] Effect group disposal failed.`.
+   *
+   * @typeParam Context — значение, которое получает тело каждого slot.
+   * @param phase Имя объявленной phase.
+   * @param count Число slots: целое от 1 до 4294967293, иначе `RangeError`.
+   * @param runSlot Тело slot: получает запуск с `context` и номером slot.
+   * @param context Значение, которое группа передаёт телу каждого slot.
+   * @param options `priority` task группы, как у `effect()`.
+   */
+  effectGroup(s, e, t, r, i) {
+    this._assertAlive();
+    const o = this._owner.runtime._effectGroupRegistration(
+      this._owner,
+      s,
+      e,
+      t,
+      r,
+      i,
+      this.paused
+    );
+    return this._track(o), o;
+  }
+  watch(s, e, t, r) {
+    return this._assertAlive(), this._add(this._owner.runtime._watchRegistration(
+      this._owner,
+      s,
+      e,
+      t,
+      r,
+      this.paused
+    ));
+  }
+  /**
+   * Внутренний путь renderer сохраняет pause ancestry и late-disposal tracking.
+   * Возвращаемый disposer renderer не использует; регистрация остаётся у scope.
+   * @internal
+   */
+  _registerEffect(s, e, t, r, i, o) {
+    this._assertAlive();
+    const h = this._owner.runtime._effectRegistration(
+      this._owner,
+      s,
+      e,
+      t,
+      this.paused,
+      r,
+      i,
+      o
+    );
+    o?.() || this._track(h);
+  }
+  /** @internal */
+  _registerWatch(s, e, t, r, i, o) {
+    this._assertAlive();
+    const h = this._owner.runtime._watchRegistration(
+      this._owner,
+      s,
+      e,
+      t,
+      r,
+      this.paused,
+      i,
+      o
+    );
+    o?.() || this._track(h);
+  }
+  /** @internal */
+  _registerEffectGroup(s, e, t, r, i) {
+    this._assertAlive();
+    const o = this._owner.runtime._effectGroupRegistration(
+      this._owner,
+      s,
+      e,
+      t,
+      r,
+      i,
+      this.paused
+    );
+    return this._track(o), o;
+  }
+  pause() {
+    this._assertAlive(), this._owner.runtime._runPhaseTransition(() => this._pause());
+  }
+  resume() {
+    this._assertAlive(), this._owner.runtime._runPhaseTransition(() => this._resume());
+  }
+  _pause() {
+    if (this._selfPaused)
+      return;
+    const s = this.paused;
+    if (this._selfPaused = !0, s)
+      return;
+    const e = [];
+    for (const t of this._registrations ?? [])
+      try {
+        t.registration.pause();
+      } catch (r) {
+        e.push(r);
+      }
+    for (const t of this._children ?? [])
+      try {
+        t._changeAncestorPause(1);
+      } catch (r) {
+        e.push(r);
+      }
+    n(e, "[Raph] Pausable effect scope pause failed.");
+  }
+  _resume() {
+    if (!this._selfPaused || (this._selfPaused = !1, this.paused))
+      return;
+    const s = [];
+    for (const e of this._registrations ?? [])
+      try {
+        e.registration.resume();
+      } catch (t) {
+        s.push(t);
+      }
+    for (const e of this._children ?? [])
+      try {
+        e._changeAncestorPause(-1);
+      } catch (t) {
+        s.push(t);
+      }
+    n(s, "[Raph] Pausable effect scope resume failed.");
+  }
+  dispose() {
+    if (this._disposed)
+      return;
+    this._disposed = !0;
+    const s = this._owner.disposed, e = [];
+    for (const t of [...this._children ?? []])
+      try {
+        t.dispose();
+      } catch (r) {
+        e.push(r);
+      }
+    this._children?.clear(), this._children = void 0;
+    for (const t of this._registrations ?? [])
+      if (t.active = !1, !s)
+        try {
+          t.registration.dispose();
+        } catch (r) {
+          e.push(r);
+        }
+    if (this._registrations?.clear(), this._registrations = void 0, this._parent?._children?.delete(this), !s)
+      try {
+        this._releaseOwner();
+      } catch (t) {
+        e.push(t);
+      }
+    n(e, "[Raph] Pausable effect scope disposal failed.");
+  }
+  _add(s) {
+    const e = this._track(s);
+    return e === void 0 ? d : () => {
+      e.active && (e.active = !1, this._registrations?.delete(e), e.registration.dispose());
+    };
+  }
+  /**
+   * Вносит регистрацию в группу и возвращает её элемент либо `undefined`,
+   * когда группа уже освобождена. Disposer здесь не создаётся: его строит
+   * только `_add()`, поэтому `bindEffect()` обходится без closure.
+   */
+  _track(s) {
+    if (this._disposed || this._owner.disposed) {
+      s.dispose();
+      return;
+    }
+    const e = { active: !0, registration: s }, t = this._registrations ??= /* @__PURE__ */ new Set();
+    return t.add(e), t.size >= this._pruneAt && this._prune(t), e;
+  }
+  /**
+   * Забывает регистрации, которые уже остановлены не через disposer группы:
+   * binding, вложенный в тело другого effect, останавливает engine при
+   * перезапуске этого effect, а у `bindEffect()` нет disposer, который убрал бы
+   * его отсюда. Без этого группа держала бы тело каждого такого binding до
+   * собственного освобождения.
+   *
+   * Проход выполняется, когда число регистраций достигает порога, и ставит
+   * следующий порог вдвое выше числа оставшихся: цена регистрации остаётся
+   * постоянной в среднем.
+   */
+  _prune(s) {
+    for (const e of s)
+      e.registration.active || (e.active = !1, s.delete(e));
+    this._pruneAt = Math.max(u, s.size * 2);
+  }
+  _assertAlive() {
+    if (this._disposed || this._owner.disposed)
+      throw new c("[Raph] Pausable effect scope is disposed.");
+  }
+  _addChild(s) {
+    (this._children ??= /* @__PURE__ */ new Set()).add(s);
+  }
+  _changeAncestorPause(s) {
+    if (this._disposed)
+      return;
+    const e = this.paused;
+    if (this._ancestorPauses += s, this._ancestorPauses < 0)
+      throw this._ancestorPauses = 0, new Error("[Raph] Effect scope ancestor pause state is unbalanced.");
+    if (e === this.paused)
+      return;
+    const t = [];
+    for (const r of this._registrations ?? [])
+      try {
+        this.paused ? r.registration.pause() : r.registration.resume();
+      } catch (i) {
+        t.push(i);
+      }
+    for (const r of this._children ?? [])
+      try {
+        r._changeAncestorPause(s);
+      } catch (i) {
+        t.push(i);
+      }
+    n(t, "[Raph] Pausable effect scope ancestor transition failed.");
+  }
+}
+function n(a, s) {
+  if (a.length === 1)
+    throw a[0];
+  if (a.length > 1)
+    throw new AggregateError(a, s);
+}
+function d() {
+}
+export {
+  _ as RaphEffectScope
+};

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

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("../../reactivity/disposal.cjs"),b=require("../errors.cjs"),S=require("../reactivity/RaphWorkGraph.cjs"),w=require("./RaphScope.cjs");let x=0;const C=Symbol("RaphProvisionalNode"),A=Object.freeze({}),O="[Raph] Child order must contain every direct child exactly once.",p="[Raph] Child order can contain only direct children of the node.";let f,c;class u extends w.RaphScope{#i;constructor(i,t={},e,r){const s=e??(i instanceof u?i.runtime:i??void 0);if(s===void 0)throw new Error("[RaphNode] A root node requires an explicit runtime.");const n=i instanceof u?i:i?.root??null;if(n!==null&&n.runtime!==s)throw new b.RaphCrossRuntimeError("[Raph] Parent belongs to another runtime.");const l=t.priority??0,h=t.id,a=t.meta,y=a===void 0?void 0:{...a},g=t.type??"default";n?._assertAlive(),v(l),super(h??x++,s);const m=r===C;if(this.priority=l,this._parent=n,this._prevSibling=null,this._nextSibling=null,this._firstChild=null,this._lastChild=null,this._childCount=0,this._childArray=void 0,this._published=n===null||!m&&n._published,this.#i=A,new.target!==u&&Object.defineProperty(this,"api",{configurable:!0,enumerable:!0,value:this.#i,writable:!0}),this._meta=y,this.type=g,this._subtreeIdentity=void 0,n!==null){if(n._appendChild(this),!this._published)return;s._hasNodeStructureDemand(this)?s._notifyNodeStructure(this,{node:this,newIndex:n._childCount-1,newParent:n},[],d(this)):s._touchMutationBoundary(),this._assertAlive()}else s._addTopOwner(this)}get id(){const i=this._id;return typeof i=="string"?i:this._id=`node-${i}`}get meta(){return this._meta??={}}set meta(i){this._meta=i}get api(){return this.#i}get _subtreeSourceIdentity(){return this._subtreeIdentity??=Object.freeze({})}get node(){return this}get parent(){return this._parent}get children(){return this._childArray??this._materializeChildren()}addChild(i){if(this._assertAlive(),i._assertAlive(),i.runtime!==this.runtime)throw new b.RaphCrossRuntimeError("[Raph] Child belongs to another runtime.");if(this===i)throw new Error("[Raph] A node cannot become its own ancestor.");if(!i._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===i)throw new Error("[Raph] A node cannot become its own ancestor.");return i.parent===this?!0:this.runtime._runNodeMutation(()=>{const t=this.runtime;t._assertNodeReparentAllowed(i,this);const e=i._parent;if(!t._hasNodeStructureDemand(i))return e!==null&&i._unlinkFrom(e,-1),i._parent=this,this._appendChild(i),e===null&&t._removeTopOwner(i),!0;const r=d(i),s=e===null?-1:i._indexIn(e);e!==null&&i._unlinkFrom(e,s),i._parent=this;const n=this._childCount;return this._appendChild(i),e===null&&t._removeTopOwner(i),t._notifyNodeStructure(i,{node:i,...e===null?{}:{oldParent:e},...s<0?{}:{oldIndex:s},newParent:this,newIndex:n},r,d(i)),!0})}reorderChildren(i){this._assertAlive(),this._applyChildOrder(i)||this._rejectChildOrder(i)}moveChild(i,t){if(this._assertAlive(),i._assertAlive(),t!==null&&t._assertAlive(),i._parent!==this||t!==null&&t._parent!==this)throw new Error(p);const e=this.runtime;if(i===t||i._nextSibling===t){e._touchMutationBoundary();return}const r=e._hasNodeSubscribers()?this._indexChildren():void 0;if(this._relinkBefore(i,t),r!==void 0){this._publishChildOrder(r);return}this._childArray=void 0,e._touchMutationBoundary()}_swapChildren(i,t){if(this._assertAlive(),i._assertAlive(),t._assertAlive(),i._parent!==this||t._parent!==this)throw new Error(p);const e=this.runtime;if(i===t){e._touchMutationBoundary();return}const r=e._hasNodeSubscribers()?this._indexChildren():void 0,s=i._nextSibling,n=t._nextSibling;if(s===t?this._relinkBefore(t,i):n===i?this._relinkBefore(i,t):(this._relinkBefore(i,n),this._relinkBefore(t,s)),r!==void 0){this._publishChildOrder(r);return}this._childArray=void 0,e._touchMutationBoundary()}_disposeChildren(i,t=0,e=i===void 0?0:i.length){let r=i;if(r===void 0&&(r=this._childArray??this._collectChildren(),e=r.length),t>=e)return;const s=this._childArray;s!==void 0&&(s===r||this._firstChild===r[t].node)&&(this._childArray=void 0);const n=this.runtime;let l;n._beginOwnerDisposal();for(let h=t;h<e;h++)try{r[h].node.dispose()}catch(a){(l??=[]).push(a)}try{n._endOwnerDisposal()}catch(h){(l??=[]).push(h)}return l}options(i){this._assertAlive(),i.meta!==void 0&&(this._meta={...i.meta}),i.priority!==void 0&&(v(i.priority),this.priority=i.priority),i.type!==void 0&&(this.type=i.type),this.touch(Object.freeze({options:Object.freeze({...i})}))}touch(i){this._assertAlive(),this.runtime._runNodeMutation(()=>this.runtime._notifyNodeTouch(this,i))}remove(){this.dispose()}dispose(){o.throwDisposalFailure(c.call(this))}_disposeForOwner(){try{const i=this.dispose;if(i===f)return c.call(this);i.call(this);return}catch(i){return o.unroutedDisposalFailure(i)}}_disposeWithOutcome(){if(this._disposed||this._disposing)return;this._disposing=!0;const i=this.runtime;i._beginOwnerDisposal(this);let t;try{if(this._firstChild!==null){const r=this._takeChildSnapshot();for(let s=0;s<r.length;s++){const n=r[s];try{const l=n.dispose;if(l===f){const h=c.call(n);h!==void 0&&(t??=[]).push(h)}else l.call(n)}catch(l){(t??=[]).push(o.unroutedDisposalFailure(l))}}this._resetChildList(r)}const e=this._parent;if(this._published&&i._hasNodeStructureDemand(this)){const r=d(this),s=e===null?-1:this._indexIn(e);e!==null&&(this._unlinkFrom(e,s),this._parent=null);try{i._notifyNodeStructure(this,{node:this,...e===null?{}:{oldParent:e},...s<0?{}:{oldIndex:s}},r,[])}catch(n){(t??=[]).push(o.unroutedDisposalFailure(n))}}else if(e!==null&&(this._unlinkFrom(e,-1),this._parent=null),this._published)try{i._touchMutationBoundary()}catch(r){(t??=[]).push(o.unroutedDisposalFailure(r))}try{const r=super._disposeScopeForOwner(super.dispose);r!==void 0&&(t??=[]).push(r)}catch(r){(t??=[]).push(o.unroutedDisposalFailure(r))}e===null&&i._removeTopOwner(this),this._published=!1;try{i._releaseNode(this)}catch(r){(t??=[]).push(o.unroutedDisposalFailure(r))}}finally{try{i._endOwnerDisposal()}catch(e){(t??=[]).push(o.unroutedDisposalFailure(e))}}if(t!==void 0)return o.combineDisposalFailures(t,`[Raph] Node "${this.id}" disposal failed.`)}_setApi(i){this.#i=typeof i=="object"&&i!==null&&!(i instanceof S.RaphProducer)?Object.freeze(i):i,Object.hasOwn(this,"api")&&Object.defineProperty(this,"api",{configurable:!1,enumerable:!0,value:this.#i,writable:!1})}_publishCreation(){if(this._published)return;const i=this._parent;if(!(i===null||!i._published)){this._published=!0;try{const t=this.runtime;t._hasNodeStructureDemand(this)?t._notifyNodeStructure(this,{node:this,newIndex:this._indexIn(i),newParent:i},[],d(this)):t._touchMutationBoundary();for(let e=this._firstChild;e!==null;e=e._nextSibling)e._publishCreation()}catch(t){throw this._published=!1,t}}}_isPublished(){return this._published}_isLinked(){const i=this._parent;return i!==null&&(this._prevSibling!==null||i._firstChild===this)}_collectDescendants(i){let t=this;for(;;){let e=t._firstChild;for(;e===null;){if(t===this)return;e=t._nextSibling,e===null&&(t=t._parent)}t=e,i.push(t)}}_countSubtree(i){let t=this;for(;;){i.resources+=t._debugResourceCount(),i.sources+=t._debugSourceCount();let e=t._firstChild;for(;e===null;){if(t===this)return;e=t._nextSibling,e===null&&(t=t._parent)}t=e}}_findNode(i){let t=this;for(;;){if(t.id===i)return t;let e=t._lastChild;for(;e===null;){if(t===this)return;e=t._prevSibling,e===null&&(t=t._parent)}t=e}}_applyChildOrder(i){const t=i.length;if(t!==this._childCount)return!1;const e=[];for(let l=0;l<t;l++)e.push(i[l]);if(t!==this._childCount)return!1;const r=this.runtime,s=r._hasNodeSubscribers()?this._indexChildren():void 0;if(!this._relinkChildren(e))return!1;const n=this._childArray;if(n!==void 0&&n!==i)for(let l=0;l<t;l++)n[l]=e[l];return s===void 0?r._touchMutationBoundary():this._notifyChildOrder(e,s),!0}_relinkChildren(i){for(let n=this._firstChild;n!==null;n=n._nextSibling)n._prevSibling=this;const t=i.length;let e=null,r=0;try{for(;r<t;r++){const n=i[r];if(n?._parent!==this||n._prevSibling!==this||n._disposing)break;n._prevSibling=e,e=n}}finally{if(r!==t){let n=null;for(let l=this._firstChild;l!==null;l=l._nextSibling)l._prevSibling=n,n=l}}if(r!==t)return!1;let s=null;for(let n=e;n!==null;n=n._prevSibling)n._nextSibling=s,s=n;return this._firstChild=s,this._lastChild=e,!0}_rejectChildOrder(i){if(i.length===this._childCount&&new Set(i).size===i.length){for(const t of i)if(t._assertAlive(),t._parent!==this)throw new Error(p)}throw new Error(O)}_indexChildren(){const i=new Map;let t=0;for(let e=this._firstChild;e!==null;e=e._nextSibling)i.set(e,t++);return i}_publishChildOrder(i){let t=this._childArray;if(t===void 0)t=this._materializeChildren();else{let e=0;for(let r=this._firstChild;r!==null;r=r._nextSibling)t[e++]=r}this._notifyChildOrder(t,i)}_notifyChildOrder(i,t){const e=this.runtime;e._runNodeMutation(()=>{for(let r=0;r<i.length;r++){const s=i[r],n=t.get(s);if(n===r)continue;const l=d(s);e._notifyNodeStructure(s,{node:s,oldParent:this,newParent:this,oldIndex:n,newIndex:r},l,l)}})}_relinkBefore(i,t){const e=i._prevSibling,r=i._nextSibling;e===null?this._firstChild=r:e._nextSibling=r,r===null?this._lastChild=e:r._prevSibling=e;const s=t===null?this._lastChild:t._prevSibling;i._prevSibling=s,i._nextSibling=t,s===null?this._firstChild=i:s._nextSibling=i,t===null?this._lastChild=i:t._prevSibling=i}_materializeChildren(){return this._childArray=this._collectChildren()}_collectChildren(){const i=[];for(let t=this._firstChild;t!==null;t=t._nextSibling)i.push(t);return i}_clearChildArray(){const i=this._childArray;i!==void 0&&(i.length=0,this._childArray=void 0)}_appendChild(i){const t=this._lastChild;i._prevSibling=t,t===null?this._firstChild=i:t._nextSibling=i,this._lastChild=i,this._childCount++;const e=this._childArray;e!==void 0&&e.push(i)}_indexIn(i){return this._prevSibling===null?i._firstChild===this?0:-1:i._lastChild===this?i._childCount-1:(i._childArray??i._materializeChildren()).indexOf(this)}_unlinkFrom(i,t){const e=this._prevSibling,r=this._nextSibling;if(e===null){if(i._firstChild!==this)return;i._firstChild=r}else e._nextSibling=r,this._prevSibling=null;r===null?i._lastChild=e:(r._prevSibling=e,this._nextSibling=null),i._childCount--;const s=i._childArray;if(s!==void 0)if(r===null)s.pop();else if(t<0&&!i._disposing&&!this.runtime._hasNodeSubscribers())i._childArray=void 0;else if(e===null)s.shift();else{const n=t>=0?t:s.indexOf(this);n>=0?s.splice(n,1):i._childArray=void 0}}_takeChildSnapshot(){const i=this._childArray;return i===void 0?this._collectChildren():(this._childArray=void 0,i)}_resetChildList(i){i.length=0,this._clearChildArray();let t=this._firstChild;for(;t!==null;){const e=t._nextSibling;t._prevSibling=null,t._nextSibling=null,t=e}this._firstChild=null,this._lastChild=null,this._childCount=0}}function N(_,i,t){return new u(_,i,t,C)}u.prototype._isNode=!0;function d(_){const i=[];for(let t=_;t!==null;t=t.parent)i.push(t);return i}function v(_){if(!Number.isFinite(_))throw new TypeError("[Raph] Node priority must be finite.")}f=u.prototype.dispose;c=u.prototype._disposeWithOutcome;exports.RaphNode=u;exports.createProvisionalNode=N;