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

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

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=Object.freeze([]),c=Object.freeze({now:0,delta:0,elapsed:0,frame:0}),o=1,_=2,E=4,p=8,d=16,T=32,l=64,A=128,u=256,f=1536,R=0,D=512,v=1024,K=1536,C=2048,O=0,U=1,P=2;class S{constructor(e){this._record=e,Object.freeze(this)}get phase(){return this._record.phaseState.name}get consumerOwner(){return this._record.consumerOwner}get effect(){return this._record.effect}get causes(){return this._record.causes}get frame(){return this._record.frame}get priority(){return this._record.priority}get sequence(){return this._record.sequence}run(){const e=this._record;e.phaseState.pipeline._runDelivery(e)}defer(){const e=this._record;e.phaseState.pipeline._deferDelivery(e)}cancel(){const e=this._record;e.phaseState.pipeline._cancelDelivery(e)}}class a{constructor(){this.extraCauses=void 0,this.deliveryFirstCause=void 0,this.deliveryFirstCauseKey=void 0,this.deliveryExtraCauses=void 0,this.deliveryCauses=void 0,this.deferCount=0}}a._shapeAnchor=new a;class y{constructor(e,t,s,i){this.state=o,this.sequence=0,this.phaseState=e,this.priority=t,this.consumerOwner=s,this.effect=i,this.node=void 0,this.watch=void 0,this.group=void 0,this.scopeParent=void 0,this.scopePrevious=void 0,this.scopeNext=void 0,this.firstCause=void 0,this.firstCauseKey=void 0,this.frame=c,this.facade=void 0,this.detail=void 0}get phase(){return this.phaseState.name}get dependencyOwner(){return this.consumerOwner}get allowScheduleDuringRun(){return!0}get active(){return(this.state&o)!==0}get causes(){const e=this.detail;if(e!==void 0){const r=e.deliveryCauses;if(r!==void 0)return r}let t,s;if(this.state&u?(t=this.firstCause,e!==void 0&&(s=e.extraCauses)):e!==void 0&&(t=e.deliveryFirstCause,s=e.deliveryExtraCauses),t===void 0)return h;const i=[Object.freeze(t)];if(s!==void 0)for(const r of s.values())i.push(Object.freeze(r));return this.detailed().deliveryCauses=Object.freeze(i)}get task(){let e=this.facade;return e===void 0&&(this.state&d&&(this.frame=this.phaseState.pipeline.frame),this.facade=e=new S(this)),e}detailed(){return this.detail??=new a}notify(e){this.phaseState.pipeline._notifyTask(this,e)}schedule(){this.phaseState.pipeline._queue(this,!0)}enqueue(e,t=e.source,s=!0){const i=this.phaseState.pipeline;i._appendCause(this,e,t),i._queue(this,s)}start(e,t="scheduled"){this.consumerOwner.runtime._startGroupSlot(this,e,t)}_start(e,t,s){this.consumerOwner.runtime._startGroupSlot(this,e,t,s)}pause(){this.phaseState.pipeline._pauseTask(this)}resume(){this.phaseState.pipeline._resumeTask(this)}dispose(){this.phaseState.pipeline._disposeBinding(this)}}exports.EMPTY_CAUSES=h;exports.EMPTY_FRAME=c;exports.GROUP_CONTEXT=O;exports.GROUP_CURSOR=U;exports.GROUP_NODES=P;exports.RaphPhaseTaskDetail=a;exports.RaphPhaseTaskHandle=S;exports.RaphPhaseTaskRecord=y;exports.TASK_ACTIVE=o;exports.TASK_CANCEL=K;exports.TASK_CAUSES_DELIVERED=u;exports.TASK_DEFER=v;exports.TASK_DEFERRED=p;exports.TASK_DISCARD_ACKNOWLEDGED=T;exports.TASK_EXECUTED=A;exports.TASK_IN_DELIVERY=d;exports.TASK_PAUSED=_;exports.TASK_PENDING=E;exports.TASK_REQUESTED=l;exports.TASK_RESOLUTION=f;exports.TASK_RUN=D;exports.TASK_TASKLESS=C;exports.TASK_UNRESOLVED=R;

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

@@ -0,0 +1,176 @@
+const h = Object.freeze([]), c = Object.freeze({ now: 0, delta: 0, elapsed: 0, frame: 0 }), n = 1, l = 2, _ = 4, S = 8, u = 16, f = 32, v = 64, E = 128, d = 256, T = 1536, A = 0, C = 512, O = 1024, D = 1536, R = 2048, y = 0, K = 1, m = 2;
+class p {
+  constructor(e) {
+    this._record = e, Object.freeze(this);
+  }
+  get phase() {
+    return this._record.phaseState.name;
+  }
+  get consumerOwner() {
+    return this._record.consumerOwner;
+  }
+  get effect() {
+    return this._record.effect;
+  }
+  get causes() {
+    return this._record.causes;
+  }
+  get frame() {
+    return this._record.frame;
+  }
+  get priority() {
+    return this._record.priority;
+  }
+  get sequence() {
+    return this._record.sequence;
+  }
+  run() {
+    const e = this._record;
+    e.phaseState.pipeline._runDelivery(e);
+  }
+  defer() {
+    const e = this._record;
+    e.phaseState.pipeline._deferDelivery(e);
+  }
+  cancel() {
+    const e = this._record;
+    e.phaseState.pipeline._cancelDelivery(e);
+  }
+}
+class a {
+  constructor() {
+    this.extraCauses = void 0, this.deliveryFirstCause = void 0, this.deliveryFirstCauseKey = void 0, this.deliveryExtraCauses = void 0, this.deliveryCauses = void 0, this.deferCount = 0;
+  }
+}
+a._shapeAnchor = new a();
+class g {
+  constructor(e, t, s, i) {
+    this.state = n, this.sequence = 0, this.phaseState = e, this.priority = t, this.consumerOwner = s, this.effect = i, this.node = void 0, this.watch = void 0, this.group = void 0, this.scopeParent = void 0, this.scopePrevious = void 0, this.scopeNext = void 0, this.firstCause = void 0, this.firstCauseKey = void 0, this.frame = c, this.facade = void 0, this.detail = void 0;
+  }
+  get phase() {
+    return this.phaseState.name;
+  }
+  get dependencyOwner() {
+    return this.consumerOwner;
+  }
+  get allowScheduleDuringRun() {
+    return !0;
+  }
+  /**
+   * Становится false, когда binding остановлен: так запись видят effect scopes,
+   * которым она передана как pausable-регистрация.
+   */
+  get active() {
+    return (this.state & n) !== 0;
+  }
+  /**
+   * Причины текущей доставки в том виде, в каком их получает callback или
+   * `process`. Массив строится при первом чтении в доставке и до её конца
+   * остаётся тем же объектом; доставка, причины которой никто не прочитал, не
+   * создаёт ни массива, ни заморозки. Вне доставки и для доставки без причин
+   * это общий пустой массив.
+   *
+   * Это единственное место, где причины выходят наружу, поэтому здесь же они
+   * становятся неизменяемыми: WorkGraph создаёт причину без заморозки, а
+   * замораживает её первое чтение.
+   */
+  get causes() {
+    const e = this.detail;
+    if (e !== void 0) {
+      const r = e.deliveryCauses;
+      if (r !== void 0)
+        return r;
+    }
+    let t, s;
+    if (this.state & d ? (t = this.firstCause, e !== void 0 && (s = e.extraCauses)) : e !== void 0 && (t = e.deliveryFirstCause, s = e.deliveryExtraCauses), t === void 0)
+      return h;
+    const i = [Object.freeze(t)];
+    if (s !== void 0)
+      for (const r of s.values())
+        i.push(Object.freeze(r));
+    return this.detailed().deliveryCauses = Object.freeze(i);
+  }
+  /**
+   * One facade per record: created on first exposure, then reused.
+   *
+   * Запись начинает вести frame с появлением facade. Facade создаётся внутри
+   * открытой доставки своей записи — его запрашивают только тело binding и
+   * `process` — и получает её frame; frame каждой следующей доставки
+   * записывает её открытие.
+   */
+  get task() {
+    let e = this.facade;
+    return e === void 0 && (this.state & u && (this.frame = this.phaseState.pipeline.frame), this.facade = e = new p(this)), e;
+  }
+  /** Возвращает редкое состояние записи и создаёт его при первом обращении. */
+  detailed() {
+    return this.detail ??= new a();
+  }
+  notify(e) {
+    this.phaseState.pipeline._notifyTask(this, e);
+  }
+  schedule() {
+    this.phaseState.pipeline._queue(this, !0);
+  }
+  enqueue(e, t = e.source, s = !0) {
+    const i = this.phaseState.pipeline;
+    i._appendCause(this, e, t), i._queue(this, s);
+  }
+  /**
+   * Запускает slot группы effects; у записи одиночного effect и watch ничего
+   * не делает. Запись группы сама является handle, который возвращает
+   * `effectGroup`.
+   */
+  start(e, t = "scheduled") {
+    this.consumerOwner.runtime._startGroupSlot(this, e, t);
+  }
+  /**
+   * Внутренний initial invocation renderer; публичный start не меняет signature.
+   * Continuation не сохраняется в записи и не вызывается при последующих runs.
+   * @internal
+   */
+  _start(e, t, s) {
+    this.consumerOwner.runtime._startGroupSlot(this, e, t, s);
+  }
+  pause() {
+    this.phaseState.pipeline._pauseTask(this);
+  }
+  resume() {
+    this.phaseState.pipeline._resumeTask(this);
+  }
+  /**
+   * Полностью освобождает binding; безопасен для повторного и вложенного вызова:
+   * снимает запись со списка владельца, останавливает engine effect или watch
+   * lifecycle и сбрасывает состояние pipeline. Engine вызывает его как task hook
+   * остановленного effect, владелец — как элемент списка ресурсов, а
+   * пользователь — через disposer.
+   */
+  dispose() {
+    this.phaseState.pipeline._disposeBinding(this);
+  }
+}
+export {
+  h as EMPTY_CAUSES,
+  c as EMPTY_FRAME,
+  y as GROUP_CONTEXT,
+  K as GROUP_CURSOR,
+  m as GROUP_NODES,
+  a as RaphPhaseTaskDetail,
+  p as RaphPhaseTaskHandle,
+  g as RaphPhaseTaskRecord,
+  n as TASK_ACTIVE,
+  D as TASK_CANCEL,
+  d as TASK_CAUSES_DELIVERED,
+  O as TASK_DEFER,
+  S as TASK_DEFERRED,
+  f as TASK_DISCARD_ACKNOWLEDGED,
+  E as TASK_EXECUTED,
+  u as TASK_IN_DELIVERY,
+  l as TASK_PAUSED,
+  _ as TASK_PENDING,
+  v as TASK_REQUESTED,
+  T as TASK_RESOLUTION,
+  C as TASK_RUN,
+  R as TASK_TASKLESS,
+  A as TASK_UNRESOLVED
+};

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

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("../reactivity/RuntimeWatch.cjs");class a extends o.RuntimeWatch{constructor(t,e){super(t,e),this.source=void 0,this.record=void 0}}function s(r,t){const e=new a(r,()=>{const c=e.record;return c===void 0?void 0:c.effect(c.task)});return e.record=t,e}exports.RaphPhaseWatch=a;exports.createPhaseWatch=s;

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

@@ -0,0 +1,20 @@
+import { RuntimeWatch as c } from "../reactivity/RuntimeWatch.js";
+class s extends c {
+  /**
+   * Создаёт lifecycle без подписки и без binding; оба поля задаёт регистрация.
+   */
+  constructor(e, t) {
+    super(e, t), this.source = void 0, this.record = void 0;
+  }
+}
+function a(o, e) {
+  const t = new s(o, () => {
+    const r = t.record;
+    return r === void 0 ? void 0 : r.effect(r.task);
+  });
+  return t.record = e, t;
+}
+export {
+  s as RaphPhaseWatch,
+  a as createPhaseWatch
+};

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

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function u(o,r){const i=r.direction??"parents-first",s=o.map(n=>{const t=r.node(n);return{node:t,path:t==null?void 0:k(t),task:n}}),e=l(s);return s.sort((n,t)=>{if(n.path===void 0||t.path===void 0)return n.path!==t.path?n.path===void 0?1:-1:t.task.priority-n.task.priority||n.task.sequence-t.task.sequence;const c=d(n.path,t.path,e,i==="children-first");return c!==0?c:t.task.priority-n.task.priority||n.task.sequence-t.task.sequence}),s.map(n=>n.task)}function d(o,r,i,s){if(o[o.length-1]===r[r.length-1])return 0;let e=0;const n=Math.min(o.length,r.length);for(;e<n&&o[e]===r[e];)e++;if(e===o.length)return s?1:-1;if(e===r.length)return s?-1:1;const t=o[e],c=r[e];if(t.priority!==c.priority)return c.priority-t.priority;const a=i.get(t),p=i.get(c);return a!==void 0&&p!==void 0?a-p:t.id.localeCompare(c.id)}function l(o){const r=new Set;for(const s of o){const e=s.path;if(e!==void 0)for(let n=0;n+1<e.length;n++)r.add(e[n])}const i=new Map;for(const s of r){const e=s.children;for(let n=0;n<e.length;n++)i.set(e[n],n)}return i}function k(o){const r=[];for(let i=o;i!==null;i=i.parent)r.push(i);return r.reverse(),r}exports.orderPhaseTasks=u;

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

@@ -0,0 +1,59 @@
+function k(o, r) {
+  const i = r.direction ?? "parents-first", s = o.map((n) => {
+    const t = r.node(n);
+    return { node: t, path: t == null ? void 0 : l(t), task: n };
+  }), e = d(s);
+  return s.sort((n, t) => {
+    if (n.path === void 0 || t.path === void 0)
+      return n.path !== t.path ? n.path === void 0 ? 1 : -1 : t.task.priority - n.task.priority || n.task.sequence - t.task.sequence;
+    const c = u(
+      n.path,
+      t.path,
+      e,
+      i === "children-first"
+    );
+    return c !== 0 ? c : t.task.priority - n.task.priority || n.task.sequence - t.task.sequence;
+  }), s.map((n) => n.task);
+}
+function u(o, r, i, s) {
+  if (o[o.length - 1] === r[r.length - 1])
+    return 0;
+  let e = 0;
+  const n = Math.min(o.length, r.length);
+  for (; e < n && o[e] === r[e]; )
+    e++;
+  if (e === o.length)
+    return s ? 1 : -1;
+  if (e === r.length)
+    return s ? -1 : 1;
+  const t = o[e], c = r[e];
+  if (t.priority !== c.priority)
+    return c.priority - t.priority;
+  const a = i.get(t), p = i.get(c);
+  return a !== void 0 && p !== void 0 ? a - p : t.id.localeCompare(c.id);
+}
+function d(o) {
+  const r = /* @__PURE__ */ new Set();
+  for (const s of o) {
+    const e = s.path;
+    if (e !== void 0)
+      for (let n = 0; n + 1 < e.length; n++)
+        r.add(e[n]);
+  }
+  const i = /* @__PURE__ */ new Map();
+  for (const s of r) {
+    const e = s.children;
+    for (let n = 0; n < e.length; n++)
+      i.set(e[n], n);
+  }
+  return i;
+}
+function l(o) {
+  const r = [];
+  for (let i = o; i !== null; i = i.parent)
+    r.push(i);
+  return r.reverse(), r;
+}
+export {
+  k as orderPhaseTasks
+};

package/dist/debug/runtime/reactivity/PathHandle.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("../../path/data-path.utils.cjs"),l=require("../errors.cjs"),p=require("../ownership/throwDisposalErrors.cjs");class u{path;options;_revision;_disposeRevision;_isTracking;_store;_release;_masks;_assertOwnerAlive;_assertTrackedRead;_assertWriteAllowed;_runWrite;_notifyEvents;_hasRevisionSubscribers;_stop;_activationLeases=0;_trackedActivation=!1;_disposed=!1;constructor(s,t,r,e,i,o,a,_,n,d,v){const h=i._ownedSignal(0,d);this._store=s,this._revision=h.source,this._disposeRevision=h.dispose,this._isTracking=i._isTracking,this.path=t.canonical,this.options=r,this._release=e,this._masks=c.pathRelationMasks(t),this._assertOwnerAlive=o,this._assertTrackedRead=a,this._assertWriteAllowed=_,this._runWrite=n,this._notifyEvents=v,this._hasRevisionSubscribers=h.hasSubscribers}get disposed(){return this._disposed}get(){return this._assertAlive(),this._assertTrackedRead?.(),this._isTracking()?this._readTracked():this._store.peek(this.path)}peek(){return this._assertAlive(),this._store.peek(this.path)}set(s){this._assertAlive(),this._assertWriteAllowed?.(),this._write(()=>this._store.set(this.path,s))}merge(s){this._assertAlive(),this._assertWriteAllowed?.(),this._write(()=>this._store.merge(this.path,s))}delete(){this._assertAlive(),this._assertWriteAllowed?.(),this._write(()=>this._store.delete(this.path))}has(){return this._assertAlive(),this._store.has(this.path)}dispose(){if(this._disposed)return;const s=this._runWrite;s===void 0?this._disposeNow():s(()=>this._disposeNow())}_disposeNow(){if(this._disposed)return;this._disposed=!0;const s=[],t=this._stop;this._stop=void 0;const r=this._disposeRevision;this._disposeRevision=void 0;const e=this._release;this._release=void 0,this._revision=void 0,this._isTracking=void 0,this._store=void 0,this._assertOwnerAlive=void 0,this._assertTrackedRead=void 0,this._assertWriteAllowed=void 0,this._runWrite=void 0,this._notifyEvents=void 0,this._hasRevisionSubscribers=void 0,this._activationLeases=0,this._trackedActivation=!1;try{t?.()}catch(i){s.push(i)}try{r?.()}catch(i){s.push(i)}try{e?.(this)}catch(i){s.push(i)}p.throwDisposalErrors(s,`[Raph] Path handle "${this.path}" disposal failed.`)}_getTracked(){return this._assertAlive(),this._assertTrackedRead?.(),this._readTracked()}_activate(){this._assertAlive(),this._activationLeases++;try{this._observe()}catch(t){throw this._activationLeases--,t}let s=!0;return()=>{s&&(s=!1,this._activationLeases!==0&&this._activationLeases--,this._releaseObserverIfIdle())}}_readTracked(){return this._trackedActivation=!0,this._observe(),this._revision.get(),this._store.get(this.path)}_observe(){this._stop??=this._store.watch(this._masks,s=>{const t=()=>{if(this._disposed)return;const e=this._revision;e!==void 0&&(this._notifyEvents?.(s,this._hasRevisionSubscribers?.()??!1),!(this._disposed||this._revision!==e)&&e.set(e.peek()+1))},r=this._runWrite;r===void 0?t():r(t)})}_releaseObserverIfIdle(){if(this._disposed||this._trackedActivation||this._activationLeases!==0)return;const s=this._stop;this._stop=void 0,s?.()}_write(s){const t=this._runWrite;t===void 0?s():t(s)}_assertAlive(){if(this._disposed)throw new l.RaphDisposedError(`[Raph] Path handle "${this.path}" is disposed.`);this._assertOwnerAlive?.()}}exports.PathHandle=u;

package/dist/debug/runtime/reactivity/PathHandle.js

@@ -0,0 +1,165 @@
+import { pathRelationMasks as c } from "../../path/data-path.utils.js";
+import { RaphDisposedError as p } from "../errors.js";
+import { throwDisposalErrors as l } from "../ownership/throwDisposalErrors.js";
+class A {
+  // Публикуют canonical path и нормализованные параметры handle.
+  path;
+  options;
+  // Связывают path revision с runtime reactivity и owning Kernel.
+  _revision;
+  _disposeRevision;
+  _isTracking;
+  _store;
+  _release;
+  _masks;
+  // Применяют runtime lifecycle и write policy к операциям handle.
+  _assertOwnerAlive;
+  _assertTrackedRead;
+  _assertWriteAllowed;
+  _runWrite;
+  _notifyEvents;
+  _hasRevisionSubscribers;
+  // Хранят активную Kernel subscription и окончательное состояние handle.
+  _stop;
+  _activationLeases = 0;
+  _trackedActivation = !1;
+  _disposed = !1;
+  /**
+   * Создаёт internal path handle и связывает его с runtime lifecycle.
+   * @internal
+   */
+  constructor(s, t, r, i, e, o, a, _, n, d, v) {
+    const h = e._ownedSignal(0, d);
+    this._store = s, this._revision = h.source, this._disposeRevision = h.dispose, this._isTracking = e._isTracking, this.path = t.canonical, this.options = r, this._release = i, this._masks = c(t), this._assertOwnerAlive = o, this._assertTrackedRead = a, this._assertWriteAllowed = _, this._runWrite = n, this._notifyEvents = v, this._hasRevisionSubscribers = h.hasSubscribers;
+  }
+  /**
+   * Показывает, освобождён ли path handle.
+   */
+  get disposed() {
+    return this._disposed;
+  }
+  /**
+   * Читает path с регистрацией реактивной зависимости.
+   */
+  get() {
+    return this._assertAlive(), this._assertTrackedRead?.(), this._isTracking() ? this._readTracked() : this._store.peek(this.path);
+  }
+  /**
+   * Читает path без регистрации реактивной зависимости.
+   */
+  peek() {
+    return this._assertAlive(), this._store.peek(this.path);
+  }
+  /**
+   * Записывает значение path через runtime write policy.
+   */
+  set(s) {
+    this._assertAlive(), this._assertWriteAllowed?.(), this._write(() => this._store.set(this.path, s));
+  }
+  /**
+   * Объединяет значение path через runtime write policy.
+   */
+  merge(s) {
+    this._assertAlive(), this._assertWriteAllowed?.(), this._write(() => this._store.merge(this.path, s));
+  }
+  /**
+   * Удаляет значение path через runtime write policy.
+   */
+  delete() {
+    this._assertAlive(), this._assertWriteAllowed?.(), this._write(() => this._store.delete(this.path));
+  }
+  /**
+   * Проверяет наличие значения path.
+   */
+  has() {
+    return this._assertAlive(), this._store.has(this.path);
+  }
+  /**
+   * Отсоединяет Kernel subscription и освобождает reactive revision handle.
+   */
+  dispose() {
+    if (this._disposed)
+      return;
+    const s = this._runWrite;
+    s === void 0 ? this._disposeNow() : s(() => this._disposeNow());
+  }
+  _disposeNow() {
+    if (this._disposed)
+      return;
+    this._disposed = !0;
+    const s = [], t = this._stop;
+    this._stop = void 0;
+    const r = this._disposeRevision;
+    this._disposeRevision = void 0;
+    const i = this._release;
+    this._release = void 0, this._revision = void 0, this._isTracking = void 0, this._store = void 0, this._assertOwnerAlive = void 0, this._assertTrackedRead = void 0, this._assertWriteAllowed = void 0, this._runWrite = void 0, this._notifyEvents = void 0, this._hasRevisionSubscribers = void 0, this._activationLeases = 0, this._trackedActivation = !1;
+    try {
+      t?.();
+    } catch (e) {
+      s.push(e);
+    }
+    try {
+      r?.();
+    } catch (e) {
+      s.push(e);
+    }
+    try {
+      i?.(this);
+    } catch (e) {
+      s.push(e);
+    }
+    l(s, `[Raph] Path handle "${this.path}" disposal failed.`);
+  }
+  /**
+   * Читает path с регистрацией runtime reactive dependency.
+   * @internal
+   */
+  _getTracked() {
+    return this._assertAlive(), this._assertTrackedRead?.(), this._readTracked();
+  }
+  /** Activates the lazy Kernel observer for an explicit granular watch. @internal */
+  _activate() {
+    this._assertAlive(), this._activationLeases++;
+    try {
+      this._observe();
+    } catch (t) {
+      throw this._activationLeases--, t;
+    }
+    let s = !0;
+    return () => {
+      s && (s = !1, this._activationLeases !== 0 && this._activationLeases--, this._releaseObserverIfIdle());
+    };
+  }
+  _readTracked() {
+    return this._trackedActivation = !0, this._observe(), this._revision.get(), this._store.get(this.path);
+  }
+  _observe() {
+    this._stop ??= this._store.watch(this._masks, (s) => {
+      const t = () => {
+        if (this._disposed)
+          return;
+        const i = this._revision;
+        i !== void 0 && (this._notifyEvents?.(s, this._hasRevisionSubscribers?.() ?? !1), !(this._disposed || this._revision !== i) && i.set(i.peek() + 1));
+      }, r = this._runWrite;
+      r === void 0 ? t() : r(t);
+    });
+  }
+  _releaseObserverIfIdle() {
+    if (this._disposed || this._trackedActivation || this._activationLeases !== 0)
+      return;
+    const s = this._stop;
+    this._stop = void 0, s?.();
+  }
+  _write(s) {
+    const t = this._runWrite;
+    t === void 0 ? s() : t(s);
+  }
+  _assertAlive() {
+    if (this._disposed)
+      throw new p(`[Raph] Path handle "${this.path}" is disposed.`);
+    this._assertOwnerAlive?.();
+  }
+}
+export {
+  A as PathHandle
+};

package/dist/debug/runtime/reactivity/RaphMetaSource.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("../../path/DataPath.cjs"),d=require("../errors.cjs");class a{constructor(e,t,s,r,i){this.owner=e,this._start=r,this._release=i;const o=Object.freeze({...s,...s.vars===void 0?{}:{vars:Object.freeze({...s.vars})}});this.options=o,this.masks=Array.isArray(t)?Object.freeze(t.map(c=>n.DataPath.from(c,o))):n.DataPath.from(t,o)}masks;options;_stop;_activationLeases=0;_disposed=!1;_releaseOwner;static _create(e,t,s,r,i){return new a(e,t,s,r,i)}get runtime(){return this.owner.runtime}get disposed(){return this._disposed}dispose(){if(this._disposed)return;const e=this.runtime,t=!e._ownerDisposalActive();t&&e._beginOwnerDisposal();const s=[];try{const r=this._releaseOwner;r!==void 0?(this._releaseOwner=void 0,r()):this._disposeOwned()}catch(r){s.push(r)}finally{if(t)try{e._endOwnerDisposal()}catch(r){s.push(r)}}if(s.length===1)throw s[0];if(s.length>1)throw new AggregateError(s,"[Raph] Meta source disposal failed.")}_bindOwner(e){this._releaseOwner=e}_disposeOwned(){if(this._disposed)return;this._disposed=!0,this._releaseOwner=void 0;const e=[];try{this._stop?.()}catch(t){e.push(t)}this._stop=void 0,this._activationLeases=0;try{this._release()}catch(t){e.push(t)}if(this._start=_,this._release=h,e.length===1)throw e[0];if(e.length>1)throw new AggregateError(e,"[Raph] Meta source disposal failed.")}_activate(){this._assertAlive(),this._activationLeases++;try{this._stop??=this._start()}catch(t){throw this._activationLeases--,t}let e=!0;return()=>{if(!e||(e=!1,this._activationLeases!==0&&this._activationLeases--,this._disposed||this._activationLeases!==0))return;const t=this._stop;this._stop=void 0,t?.()}}_assertAlive(){if(this._disposed||this.owner.disposed)throw new d.RaphDisposedError("[Raph] Meta source is disposed.")}}function h(){}function _(){return h}exports.RaphMetaSource=a;

package/dist/debug/runtime/reactivity/RaphMetaSource.js

@@ -0,0 +1,108 @@
+import { DataPath as a } from "../../path/DataPath.js";
+import { RaphDisposedError as c } from "../errors.js";
+class n {
+  /** @internal */
+  constructor(e, s, t, r, i) {
+    this.owner = e, this._start = r, this._release = i;
+    const o = Object.freeze({
+      ...t,
+      ...t.vars === void 0 ? {} : { vars: Object.freeze({ ...t.vars }) }
+    });
+    this.options = o, this.masks = Array.isArray(s) ? Object.freeze(s.map((p) => a.from(p, o))) : a.from(s, o);
+  }
+  masks;
+  options;
+  _stop;
+  _activationLeases = 0;
+  _disposed = !1;
+  _releaseOwner;
+  /** @internal */
+  static _create(e, s, t, r, i) {
+    return new n(e, s, t, r, i);
+  }
+  get runtime() {
+    return this.owner.runtime;
+  }
+  get disposed() {
+    return this._disposed;
+  }
+  dispose() {
+    if (this._disposed)
+      return;
+    const e = this.runtime, s = !e._ownerDisposalActive();
+    s && e._beginOwnerDisposal();
+    const t = [];
+    try {
+      const r = this._releaseOwner;
+      r !== void 0 ? (this._releaseOwner = void 0, r()) : this._disposeOwned();
+    } catch (r) {
+      t.push(r);
+    } finally {
+      if (s)
+        try {
+          e._endOwnerDisposal();
+        } catch (r) {
+          t.push(r);
+        }
+    }
+    if (t.length === 1)
+      throw t[0];
+    if (t.length > 1)
+      throw new AggregateError(t, "[Raph] Meta source disposal failed.");
+  }
+  /** @internal */
+  _bindOwner(e) {
+    this._releaseOwner = e;
+  }
+  /** @internal */
+  _disposeOwned() {
+    if (this._disposed)
+      return;
+    this._disposed = !0, this._releaseOwner = void 0;
+    const e = [];
+    try {
+      this._stop?.();
+    } catch (s) {
+      e.push(s);
+    }
+    this._stop = void 0, this._activationLeases = 0;
+    try {
+      this._release();
+    } catch (s) {
+      e.push(s);
+    }
+    if (this._start = d, this._release = h, e.length === 1)
+      throw e[0];
+    if (e.length > 1)
+      throw new AggregateError(e, "[Raph] Meta source disposal failed.");
+  }
+  /** @internal */
+  _activate() {
+    this._assertAlive(), this._activationLeases++;
+    try {
+      this._stop ??= this._start();
+    } catch (s) {
+      throw this._activationLeases--, s;
+    }
+    let e = !0;
+    return () => {
+      if (!e || (e = !1, this._activationLeases !== 0 && this._activationLeases--, this._disposed || this._activationLeases !== 0))
+        return;
+      const s = this._stop;
+      this._stop = void 0, s?.();
+    };
+  }
+  /** @internal */
+  _assertAlive() {
+    if (this._disposed || this.owner.disposed)
+      throw new c("[Raph] Meta source is disposed.");
+  }
+}
+function h() {
+}
+function d() {
+  return h;
+}
+export {
+  n as RaphMetaSource
+};

package/dist/debug/runtime/reactivity/RaphSelector.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g=32,a=32;class f{constructor(e,s,t,r){this.select=u(this),this._previousSource=void 0,this._trackedKey=void 0,this._owner=e,this._reactivity=s,this._source=t,this._equals=r,this._dense=[],this._denseBase=0,this._denseCount=0,this._triggers=void 0,this._scanning=!1,this._objectHooks=l(this,t),this._growthLimit=1,this._sweptAt=0,this._sweepStride=0,this._disposed=!1,this._tapSlot=-1,this._sweepSlot=-1,this._sweepDue=0,t._addWriteTap(this)}get[Symbol.toStringTag](){return"RaphSelector"}toJSON(){return{owner:this._owner.id,triggers:this._size(),disposed:this._disposed}}get _tapOwner(){return this._owner}_debugTriggerCount(){return this._size()}_test(e){const s=this._owner,t=this._reactivity;t._assertTrackedRead(s),s._assertAlive(),this._track(e,t);const r=this._source.peek(),i=this._equals;return i!==void 0?i(e,r):e===r||typeof e=="number"&&typeof r=="number"&&Object.is(e,r)}_observesWrites(){return this._size()!==0}_afterSourceWrite(e,s){if(this._size()===0)return;const t=this._reactivity,r=this._equals;if(r===void 0){if(Object.is(e,s))return;this._wakePair(e,s,t);return}let i;const n=this._scanning;this._scanning=!0;const o=this._dense;for(let _=0;_<o.length;_++){const d=o[_];if(d!==void 0){if(!t._signalNodeHasSubscribers(d)){o[_]=void 0,this._denseCount--;continue}i=this._wakeChanged(this._denseBase+_,d,e,s,r,i)}}const h=this._triggers;if(h!==void 0)for(const[_,d]of h){if(!t._signalNodeHasSubscribers(d)){h.delete(_);continue}i=this._wakeChanged(_,d,e,s,r,i)}if(this._scanning=n,this._settleDense(),i!==void 0)throw i.length===1?i[0]:new AggregateError(i,"[Raph] Selector notification failed.")}_afterOwnerDisposals(e){const s=this._size(),t=this._sweepStride,r=this._sweptAt+(t>s?t:s);if(e<r)return r;this._sweep(e);const i=this._size();if(i===0)return this._sweepStride=0,this._growthLimit=1,0;if(i!==s)return this._sweepStride=0,e+i;const n=(t>i?t:i)*2;return this._sweepStride=n,e+n}_edgeDetached(e){if(this._disposed)return;const s=this._triggers,t=s.get(e);t!==void 0&&this._reactivity._hasSingleSubscriber(t)&&s.delete(e)}_findConsumerOwner(e,s){const t=this._reactivity,r=this._dense;for(let n=0;n<r.length;n++){const o=r[n];if(o===void 0)continue;const h=t._findSubscriberOwner(o,e,s);if(h!==void 0)return h}const i=this._triggers;if(i!==void 0)for(const n of i.values()){const o=t._findSubscriberOwner(n,e,s);if(o!==void 0)return o}}_finalizeSource(){if(this._disposed)return!0;this._disposed=!0,this._equals=void 0,this._source._removeWriteTap(this),this._sweepSlot!==-1&&this._owner.runtime._removeDisposalSweeper(this);const e=this._reactivity;let s;const t=this._dense;for(let i=0;i<t.length;i++){const n=t[i];if(n!==void 0)try{e._releaseSignalNode(n)}catch(o){(s??=[]).push(o)}}t.length=0,this._denseCount=0;const r=this._triggers;if(r!==void 0){for(const i of r.values())try{e._releaseSignalNode(i)}catch(n){(s??=[]).push(n)}r.clear()}if(s!==void 0)throw s.length===1?s[0]:new AggregateError(s,"[Raph] Selector disposal failed.");return!0}_sweep(e=this._owner.runtime._ownerDisposalCount()){this._sweptAt=e;const s=this._size();if(s===0)return;const t=this._dense,r=this._triggers,i=this._reactivity,n=i._countObserved(t,r);if(n===s){t.length!==this._denseCount&&this._settleDense();return}if(n===0){t.length=0,this._denseCount=0,r!==void 0&&r.clear();return}this._denseCount=i._dropUnobserved(t,r),this._settleDense()}_size(){const e=this._triggers;return e===void 0?this._denseCount:this._denseCount+e.size}_track(e,s){if(typeof e=="number"){const n=this._dense,o=n.length;if(o===0){if(Number.isInteger(e)){this._trackDense(e,0,s);return}}else{const h=this._denseBase,_=e-h;if(_>=0&&_<=o&&_===(_|0)&&h+_===e){const d=_<o?n[_]:void 0;d!==void 0?s._readSignalNode(d):this._trackDense(e,_,s);return}}}const t=this._triggers,r=t===void 0?void 0:t.get(e);if(typeof e=="object"?e!==null:typeof e=="function"){this._trackObject(e,r,s);return}if(r!==void 0){s._readSignalNode(r);return}const i=s._trackCounterNode(this._source);i!==void 0&&(t===void 0?this._triggers=new Map().set(e,i):t.set(e,i),this._size()>=this._growthLimit&&this._grow())}_trackDense(e,s,t){const r=this._triggers;if(r!==void 0&&r.size!==0){const o=r.get(e);if(o!==void 0){t._readSignalNode(o);return}}const i=t._trackCounterNode(this._source);if(i===void 0)return;const n=this._dense;s===n.length?(s===0&&(this._denseBase=e+0),n.push(i)):n[s]=i,this._denseCount++,this._size()>=this._growthLimit&&this._grow()}_trackObject(e,s,t){if(this._trackedKey=e,s!==void 0)t._readSignalNode(s);else{const r=t._trackCounterNode(this._objectHooks);if(r!==void 0){const i=this._triggers;i===void 0?this._triggers=new Map().set(e,r):i.set(e,r),this._size()>=this._growthLimit&&this._grow()}}this._trackedKey=void 0}_grow(){const e=this._owner.runtime,s=e._ownerDisposalCount();this._sweep(s);const t=this._size();this._growthLimit=t*2>g?t*2:g,this._sweepSlot===-1&&(this._sweepStride=0,e._addDisposalSweeper(this,s+t))}_wakePair(e,s,t){let r=!1,i;const n=this._find(e);if(n!==void 0)try{this._bump(e,n,t)}catch(h){r=!0,i=h}const o=this._find(s);if(o!==void 0)try{this._bump(s,o,t)}catch(h){throw r?new AggregateError([i,h],"[Raph] Selector notification failed."):h}if(r)throw i}_bump(e,s,t){t._bumpSignalNode(s)||this._forget(e)}_wakeChanged(e,s,t,r,i,n){let o=!0;try{o=i(e,t)!==i(e,r)}catch(h){(n??=[]).push(h)}if(o)try{this._bump(e,s,this._reactivity)}catch(h){(n??=[]).push(h)}return n}_find(e){if(typeof e=="number"){const t=this._dense,r=this._denseBase,i=e-r;if(i>=0&&i<t.length&&i===(i|0)&&r+i===e)return t[i]}const s=this._triggers;return s===void 0?void 0:s.get(e)}_forget(e){if(typeof e=="number"){const t=this._dense,r=this._denseBase,i=e-r;if(i>=0&&i<t.length&&i===(i|0)&&r+i===e){if(t[i]!==void 0){t[i]=void 0;const n=--this._denseCount;(n===0||t.length>(n*2+a)*2)&&this._settleDense()}return}}const s=this._triggers;s!==void 0&&s.delete(e)}_settleDense(){if(this._scanning)return;const e=this._dense,s=this._denseCount;if(s===0){e.length=0;return}let t=e.length,r=0;for(;r<t&&e[r]===void 0;)r++;for(;t>r&&e[t-1]===void 0;)t--;if(t-r>s*2+a){const i=this._denseBase,n=this._triggers??=new Map;for(let o=r;o<t;o++){const h=e[o];h!==void 0&&n.set(i+o,h)}e.length=0,this._denseCount=0;return}r!==0&&(e.copyWithin(0,r,t),this._denseBase+=r),e.length=t-r}}function u(c){return e=>c._test(e)}function l(c,e){return{token:e,onDependency:()=>{const s=c._trackedKey;return()=>{c._edgeDetached(s)}}}}exports.RuntimeSelector=f;