@raphy-js/raph 1.0.0-dev.2

package/dist/debug/reactivity/scope.cjs

@@ -0,0 +1 @@
+"use strict";var d=Object.defineProperty;var l=(t,e,s)=>e in t?d(t,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):t[e]=s;var o=(t,e,s)=>l(t,typeof e!="symbol"?e+"":e,s);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class _{constructor(e){o(this,"scopeFirstChild");o(this,"scopeLastChild");o(this,"_resourceCount",0);o(this,"_sourceFinalizers");o(this,"_disposed",!1);o(this,"_disposing",!1);this.reactivity=e}get disposed(){return this._disposed}get active(){return!this._disposed&&!this._disposing}signal(e){this._assertAlive();const s=this._adoptSource(this.reactivity._ownedSignal(e));return{get:()=>(this._assertAlive(),s.get()),peek:()=>(this._assertAlive(),s.peek()),set:i=>{this._assertAlive(),s.set(i)}}}computed(e){this._assertAlive();const s=typeof e=="function"?e:e.get,i=this._adoptSource(this.reactivity._ownedComputed(s)),r={get:()=>(this._assertAlive(),i.get()),peek:()=>(this._assertAlive(),i.peek())};if(typeof e=="function")return r;let c=e.set;this._own(()=>{c=void 0});const n=r;return n.set=a=>{this._assertAlive(),c(a)},n}effect(e){return this._assertAlive(),this._adoptResource(this.reactivity.effect(e))}watch(e,s,i){return this._assertAlive(),this._adoptResource(this.reactivity.watch(e,s,i))}own(e){return this.active?this._own(e):(e(),v)}_debugResourceCount(){return this._resourceCount}_debugSourceCount(){var e;return((e=this._sourceFinalizers)==null?void 0:e.size)??0}dispose(){if(this._disposed)return;this._disposed=!0,this._disposing=!0;const e=[];try{for(;this.scopeLastChild!==void 0;)try{this.scopeLastChild.dispose()}catch(s){e.push(s)}this._finalizeSources(e)}finally{this._disposing=!1;try{this._afterDispose()}catch(s){e.push(s)}}p(e,this._disposalMessage())}_own(e){this._assertAlive();let s=e;const i={scopeParent:void 0,scopePrevious:void 0,scopeNext:void 0,dispose:()=>{const r=s;r!==void 0&&(s=void 0,h(i),--this._resourceCount,r())}};return u(this,i),++this._resourceCount,i.dispose}_adoptResource(e){try{return this._own(e)}catch(s){try{e()}catch(i){throw new AggregateError([s,i],"Resource registration and cleanup failed.")}throw s}}_adoptSource(e){try{this._ownSource(e.dispose)}catch(s){try{e.dispose()}catch(i){throw new AggregateError([s,i],"Source registration and cleanup failed.")}throw s}return e.source}_ownSource(e){this._assertAlive(),this._sourceFinalizers===void 0&&(this._sourceFinalizers=new Set),this._sourceFinalizers.add(e)}_assertAlive(){if(this._disposed||this._disposing)throw new Error("ScopeNode is disposed.")}_afterDispose(){}_disposalMessage(){return"ScopeNode disposal failed."}_finalizeSources(e){const s=this._sourceFinalizers;if(this._sourceFinalizers=void 0,s===void 0)return;let i=[...s].reverse();for(s.clear();i.length>0;){const r=[];let c=!1;for(const n of i)try{n()?c=!0:r.push(n)}catch(a){e.push(a),c=!0}if(!c)return;i=r}}}function u(t,e){const s=t.scopeLastChild;e.scopeParent=t,e.scopePrevious=s,e.scopeNext=void 0,s===void 0?t.scopeFirstChild=e:s.scopeNext=e,t.scopeLastChild=e}function h(t){const e=t.scopeParent;if(e===void 0)return;const s=t.scopePrevious,i=t.scopeNext;s===void 0?e.scopeFirstChild=i:s.scopeNext=i,i===void 0?e.scopeLastChild=s:i.scopePrevious=s,t.scopeParent=void 0,t.scopePrevious=void 0,t.scopeNext=void 0}function p(t,e){if(t.length===1)throw t[0];if(t.length>1)throw new AggregateError(t,e)}function v(){}exports.ScopeNode=_;exports.appendScopeChild=u;exports.detachScopeChild=h;exports.throwScopeErrors=p;

package/dist/debug/reactivity/scope.js

@@ -0,0 +1,274 @@
+var u = Object.defineProperty;
+var h = (t, e, s) => e in t ? u(t, e, { enumerable: !0, configurable: !0, writable: !0, value: s }) : t[e] = s;
+var o = (t, e, s) => h(t, typeof e != "symbol" ? e + "" : e, s);
+class f {
+  /**
+   * Связывает владельца с реактивным экземпляром без создания нового графа.
+   * @param reactivity Экземпляр, в котором создаются owned-ресурсы.
+   */
+  constructor(e) {
+    /**
+     * Первый зарегистрированный ресурс; не является ребёнком execution-дерева.
+     * @internal
+     */
+    o(this, "scopeFirstChild");
+    /**
+     * Последний ресурс, с которого начинается освобождение владельца.
+     * @internal
+     */
+    o(this, "scopeLastChild");
+    // Число активных записей owned-ресурсов; финализаторы источников считаются отдельно.
+    o(this, "_resourceCount", 0);
+    // Лениво создаваемое множество финализаторов owned-источников.
+    o(this, "_sourceFinalizers");
+    // Окончательное состояние владельца; устанавливается до пользовательских cleanup.
+    o(this, "_disposed", !1);
+    // Признак выполняющегося освобождения для проверок lifetime и наследников.
+    o(this, "_disposing", !1);
+    this.reactivity = e;
+  }
+  /**
+   * Показывает, началось ли окончательное освобождение владельца.
+   */
+  get disposed() {
+    return this._disposed;
+  }
+  /**
+   * Разрешает регистрацию и доступ только до начала освобождения.
+   */
+  get active() {
+    return !this._disposed && !this._disposing;
+  }
+  /**
+   * Создаёт owned signal и регистрирует его финализатор.
+   * Все методы возвращённого handle проверяют, что владелец ещё активен.
+   */
+  signal(e) {
+    this._assertAlive();
+    const s = this._adoptSource(this.reactivity._ownedSignal(e));
+    return {
+      get: () => (this._assertAlive(), s.get()),
+      peek: () => (this._assertAlive(), s.peek()),
+      set: (i) => {
+        this._assertAlive(), s.set(i);
+      }
+    };
+  }
+  /**
+   * Создаёт owned computed; getter освобождается при dispose владельца.
+   * Для writable computed отдельно освобождает захваченный setter.
+   */
+  computed(e) {
+    this._assertAlive();
+    const s = typeof e == "function" ? e : e.get, i = this._adoptSource(this.reactivity._ownedComputed(s)), r = {
+      get: () => (this._assertAlive(), i.get()),
+      peek: () => (this._assertAlive(), i.peek())
+    };
+    if (typeof e == "function")
+      return r;
+    let c = e.set;
+    this._own(() => {
+      c = void 0;
+    });
+    const n = r;
+    return n.set = (a) => {
+      this._assertAlive(), c(a);
+    }, n;
+  }
+  /**
+   * Создаёт эффект и принимает его disposer во владение.
+   * Если владелец уничтожен во время синхронного запуска, немедленно останавливает эффект.
+   */
+  effect(e) {
+    return this._assertAlive(), this._adoptResource(this.reactivity.effect(e));
+  }
+  /**
+   * Создаёт watch и регистрирует окончательную остановку у владельца.
+   */
+  watch(e, s, i) {
+    return this._assertAlive(), this._adoptResource(this.reactivity.watch(e, s, i));
+  }
+  /**
+   * Принимает произвольный cleanup и возвращает однократный disposer.
+   * Если владелец уже неактивен, выполняет cleanup сразу и возвращает пустой disposer.
+   */
+  own(e) {
+    return this.active ? this._own(e) : (e(), _);
+  }
+  /**
+   * Возвращает число ещё не освобождённых записей ресурсов.
+   * @internal
+   */
+  _debugResourceCount() {
+    return this._resourceCount;
+  }
+  /**
+   * Возвращает число зарегистрированных финализаторов источников.
+   * @internal
+   */
+  _debugSourceCount() {
+    var e;
+    return ((e = this._sourceFinalizers) == null ? void 0 : e.size) ?? 0;
+  }
+  /**
+   * Освобождает ресурсы в обратном порядке, затем финализирует источники.
+   * Повторный вызов безопасен. Ошибки cleanup и завершающего hook собираются
+   * и передаются только после завершения остальных стадий.
+   */
+  dispose() {
+    if (this._disposed)
+      return;
+    this._disposed = !0, this._disposing = !0;
+    const e = [];
+    try {
+      for (; this.scopeLastChild !== void 0; )
+        try {
+          this.scopeLastChild.dispose();
+        } catch (s) {
+          e.push(s);
+        }
+      this._finalizeSources(e);
+    } finally {
+      this._disposing = !1;
+      try {
+        this._afterDispose();
+      } catch (s) {
+        e.push(s);
+      }
+    }
+    l(e, this._disposalMessage());
+  }
+  /**
+   * Регистрирует ресурс только у активного владельца.
+   * Дочерняя запись отсоединяется до вызова cleanup, включая ошибочный и вложенный stop.
+   * В отличие от own(), не принимает регистрацию после dispose.
+   * @internal
+   */
+  _own(e) {
+    this._assertAlive();
+    let s = e;
+    const i = {
+      scopeParent: void 0,
+      scopePrevious: void 0,
+      scopeNext: void 0,
+      dispose: () => {
+        const r = s;
+        r !== void 0 && (s = void 0, d(i), --this._resourceCount, r());
+      }
+    };
+    return p(this, i), ++this._resourceCount, i.dispose;
+  }
+  /**
+   * Принимает уже созданный ресурс и не оставляет его без владельца при ошибке регистрации.
+   * При неудачной очистке сохраняет и ошибку регистрации, и ошибку освобождения.
+   * @internal
+   */
+  _adoptResource(e) {
+    try {
+      return this._own(e);
+    } catch (s) {
+      try {
+        e();
+      } catch (i) {
+        throw new AggregateError([s, i], "Resource registration and cleanup failed.");
+      }
+      throw s;
+    }
+  }
+  /**
+   * Регистрирует финализатор owned-источника и возвращает его handle.
+   * Если владелец уже недоступен, освобождает источник до передачи ошибки.
+   * @internal
+   */
+  _adoptSource(e) {
+    try {
+      this._ownSource(e.dispose);
+    } catch (s) {
+      try {
+        e.dispose();
+      } catch (i) {
+        throw new AggregateError([s, i], "Source registration and cleanup failed.");
+      }
+      throw s;
+    }
+    return e.source;
+  }
+  /**
+   * Добавляет финализатор источника. Возвращённый им false означает повторную попытку
+   * после прогресса других финализаторов, а не успешное освобождение.
+   * @internal
+   */
+  _ownSource(e) {
+    this._assertAlive(), this._sourceFinalizers === void 0 && (this._sourceFinalizers = /* @__PURE__ */ new Set()), this._sourceFinalizers.add(e);
+  }
+  /**
+   * Запрещает операции после начала освобождения владельца.
+   * Текст существующей ошибки сохранён для совместимости вызывающих слоёв.
+   * @internal
+   */
+  _assertAlive() {
+    if (this._disposed || this._disposing)
+      throw new Error("ScopeNode is disposed.");
+  }
+  /**
+   * Завершающий hook для наследников после ресурсов и источников.
+   * Базовая реализация ничего не делает; исключение наследника попадёт в общий результат.
+   */
+  _afterDispose() {
+  }
+  /**
+   * Возвращает сообщение для AggregateError при нескольких ошибках освобождения.
+   */
+  _disposalMessage() {
+    return "ScopeNode disposal failed.";
+  }
+  /**
+   * Освобождает источники в обратном порядке регистрации с повторными попытками.
+   * Если в проходе не было прогресса, прекращает обход, сохраняя существующий контракт.
+   * Исключение одного финализатора не блокирует остальные.
+   */
+  _finalizeSources(e) {
+    const s = this._sourceFinalizers;
+    if (this._sourceFinalizers = void 0, s === void 0)
+      return;
+    let i = [...s].reverse();
+    for (s.clear(); i.length > 0; ) {
+      const r = [];
+      let c = !1;
+      for (const n of i)
+        try {
+          n() ? c = !0 : r.push(n);
+        } catch (a) {
+          e.push(a), c = !0;
+        }
+      if (!c)
+        return;
+      i = r;
+    }
+  }
+}
+function p(t, e) {
+  const s = t.scopeLastChild;
+  e.scopeParent = t, e.scopePrevious = s, e.scopeNext = void 0, s === void 0 ? t.scopeFirstChild = e : s.scopeNext = e, t.scopeLastChild = e;
+}
+function d(t) {
+  const e = t.scopeParent;
+  if (e === void 0)
+    return;
+  const s = t.scopePrevious, i = t.scopeNext;
+  s === void 0 ? e.scopeFirstChild = i : s.scopeNext = i, i === void 0 ? e.scopeLastChild = s : i.scopePrevious = s, t.scopeParent = void 0, t.scopePrevious = void 0, t.scopeNext = void 0;
+}
+function l(t, e) {
+  if (t.length === 1)
+    throw t[0];
+  if (t.length > 1)
+    throw new AggregateError(t, e);
+}
+function _() {
+}
+export {
+  f as ScopeNode,
+  p as appendScopeChild,
+  d as detachScopeChild,
+  l as throwScopeErrors
+};

package/dist/debug/reactivity/types.cjs

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

package/dist/debug/reactivity/types.js

@@ -0,0 +1 @@
+

package/dist/debug/reactivity/watch.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g=require("./scope.cjs");function A(t,e,i,d,v={},f){const s=W(i);let l=!1,u,o,a=!1;function h(){if(a)return;a=!0;const n=o;o=void 0,n!==void 0&&e(n)}return t(()=>{if(a)return;const n=f===void 0?s():f(s),p=!l;if(!p&&m(n,u))return;const b=u;if(u=n,l=!0,p&&!v.immediate)return;const y=o;o=void 0;let c;if(y!==void 0)try{e(y)}catch(r){c=[r]}if(!a)try{const r=w(e(()=>d(n,b)));a?r!==void 0&&e(r):o=r}catch(r){c??(c=[]),c.push(r)}c!==void 0&&g.throwScopeErrors(c,"Watch callback and cleanup failed.")},h)}function W(t){if(Array.isArray(t))return()=>t.map(S);const e=t;return typeof e=="function"?e:()=>e.get()}function S(t){return typeof t=="function"?t():t.get()}function m(t,e){if(!Array.isArray(t)||!Array.isArray(e))return Object.is(t,e);if(t.length!==e.length)return!1;for(let i=0;i<t.length;i++)if(!Object.is(t[i],e[i]))return!1;return!0}function w(t){return typeof t=="function"?t:void 0}exports.watchWithReactivity=A;

package/dist/debug/reactivity/watch.js

@@ -0,0 +1,64 @@
+import { throwScopeErrors as m } from "./scope.js";
+function C(t, e, i, y, h = {}, u) {
+  const l = W(i);
+  let s = !1, c, o, a = !1;
+  function v() {
+    if (a)
+      return;
+    a = !0;
+    const n = o;
+    o = void 0, n !== void 0 && e(n);
+  }
+  return t(() => {
+    if (a)
+      return;
+    const n = u === void 0 ? l() : u(l), p = !s;
+    if (!p && g(n, c))
+      return;
+    const A = c;
+    if (c = n, s = !0, p && !h.immediate)
+      return;
+    const d = o;
+    o = void 0;
+    let f;
+    if (d !== void 0)
+      try {
+        e(d);
+      } catch (r) {
+        f = [r];
+      }
+    if (!a)
+      try {
+        const r = w(e(() => y(n, A)));
+        a ? r !== void 0 && e(r) : o = r;
+      } catch (r) {
+        f ?? (f = []), f.push(r);
+      }
+    f !== void 0 && m(f, "Watch callback and cleanup failed.");
+  }, v);
+}
+function W(t) {
+  if (Array.isArray(t))
+    return () => t.map(b);
+  const e = t;
+  return typeof e == "function" ? e : () => e.get();
+}
+function b(t) {
+  return typeof t == "function" ? t() : t.get();
+}
+function g(t, e) {
+  if (!Array.isArray(t) || !Array.isArray(e))
+    return Object.is(t, e);
+  if (t.length !== e.length)
+    return !1;
+  for (let i = 0; i < t.length; i++)
+    if (!Object.is(t[i], e[i]))
+      return !1;
+  return !0;
+}
+function w(t) {
+  return typeof t == "function" ? t : void 0;
+}
+export {
+  C as watchWithReactivity
+};

package/dist/debug/runtime/PathHandle.cjs

@@ -0,0 +1 @@
+"use strict";var p=Object.defineProperty;var c=(r,s,t)=>s in r?p(r,s,{enumerable:!0,configurable:!0,writable:!0,value:t}):r[s]=t;var e=(r,s,t)=>c(r,typeof s!="symbol"?s+"":s,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const v=require("../path/data-path.cjs"),u=require("./disposal.cjs"),k=require("./errors.cjs");class w{constructor(s,t,h,a,i,_,d,n,l){e(this,"path");e(this,"options");e(this,"_revision");e(this,"_disposeRevision");e(this,"_isTracking");e(this,"_store");e(this,"_release");e(this,"_masks");e(this,"_assertOwnerAlive");e(this,"_assertTrackedRead");e(this,"_assertWriteAllowed");e(this,"_runWrite");e(this,"_stop");e(this,"_disposed",!1);const o=i._ownedSignal(0);this._store=s,this._revision=o.source,this._disposeRevision=o.dispose,this._isTracking=i._isTracking,this.path=t.canonical,this.options=h,this._release=a,this._masks=v.pathRelationMasks(t),this._assertOwnerAlive=_,this._assertTrackedRead=d,this._assertWriteAllowed=n,this._runWrite=l}get disposed(){return this._disposed}get(){var s;return this._assertAlive(),(s=this._assertTrackedRead)==null||s.call(this),this._isTracking()?this._readTracked():this._store.peek(this.path)}peek(){return this._assertAlive(),this._store.peek(this.path)}set(s){var t;this._assertAlive(),(t=this._assertWriteAllowed)==null||t.call(this),this._write(()=>this._store.set(this.path,s))}merge(s){var t;this._assertAlive(),(t=this._assertWriteAllowed)==null||t.call(this),this._write(()=>this._store.merge(this.path,s))}delete(){var s;this._assertAlive(),(s=this._assertWriteAllowed)==null||s.call(this),this._write(()=>this._store.delete(this.path))}has(){return this._assertAlive(),this._store.has(this.path)}dispose(){if(this._disposed)return;this._disposed=!0;const s=[],t=this._stop;this._stop=void 0;const h=this._disposeRevision;this._disposeRevision=void 0;const a=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;try{t==null||t()}catch(i){s.push(i)}try{h==null||h()}catch(i){s.push(i)}try{a==null||a(this)}catch(i){s.push(i)}u.throwDisposalErrors(s,`[Raph] Path handle "${this.path}" disposal failed.`)}_getTracked(){var s;return this._assertAlive(),(s=this._assertTrackedRead)==null||s.call(this),this._readTracked()}_readTracked(){return this._observe(),this._revision.get(),this._store.get(this.path)}_observe(){this._stop??(this._stop=this._store.watch(this._masks,()=>{this._revision.set(this._revision.peek()+1)}))}_write(s){const t=this._runWrite;t===void 0?s():t(s)}_assertAlive(){var s;if(this._disposed)throw new k.RaphDisposedError(`[Raph] Path handle "${this.path}" is disposed.`);(s=this._assertOwnerAlive)==null||s.call(this)}}exports.PathHandle=w;

package/dist/debug/runtime/PathHandle.js

@@ -0,0 +1,139 @@
+var l = Object.defineProperty;
+var v = (r, s, t) => s in r ? l(r, s, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[s] = t;
+var e = (r, s, t) => v(r, typeof s != "symbol" ? s + "" : s, t);
+import { pathRelationMasks as c } from "../path/data-path.js";
+import { throwDisposalErrors as k } from "./disposal.js";
+import { RaphDisposedError as w } from "./errors.js";
+class R {
+  /**
+   * Создаёт internal path handle и связывает его с runtime lifecycle.
+   * @internal
+   */
+  constructor(s, t, h, o, i, _, d, n, p) {
+    // Публикуют canonical path и нормализованные параметры handle.
+    e(this, "path");
+    e(this, "options");
+    // Связывают path revision с runtime reactivity и owning Kernel.
+    e(this, "_revision");
+    e(this, "_disposeRevision");
+    e(this, "_isTracking");
+    e(this, "_store");
+    e(this, "_release");
+    e(this, "_masks");
+    // Применяют runtime lifecycle и write policy к операциям handle.
+    e(this, "_assertOwnerAlive");
+    e(this, "_assertTrackedRead");
+    e(this, "_assertWriteAllowed");
+    e(this, "_runWrite");
+    // Хранят активную Kernel subscription и окончательное состояние handle.
+    e(this, "_stop");
+    e(this, "_disposed", !1);
+    const a = i._ownedSignal(0);
+    this._store = s, this._revision = a.source, this._disposeRevision = a.dispose, this._isTracking = i._isTracking, this.path = t.canonical, this.options = h, this._release = o, this._masks = c(t), this._assertOwnerAlive = _, this._assertTrackedRead = d, this._assertWriteAllowed = n, this._runWrite = p;
+  }
+  /**
+   * Показывает, освобождён ли path handle.
+   */
+  get disposed() {
+    return this._disposed;
+  }
+  /**
+   * Читает path с регистрацией реактивной зависимости.
+   */
+  get() {
+    var s;
+    return this._assertAlive(), (s = this._assertTrackedRead) == null || s.call(this), 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) {
+    var t;
+    this._assertAlive(), (t = this._assertWriteAllowed) == null || t.call(this), this._write(() => this._store.set(this.path, s));
+  }
+  /**
+   * Объединяет значение path через runtime write policy.
+   */
+  merge(s) {
+    var t;
+    this._assertAlive(), (t = this._assertWriteAllowed) == null || t.call(this), this._write(() => this._store.merge(this.path, s));
+  }
+  /**
+   * Удаляет значение path через runtime write policy.
+   */
+  delete() {
+    var s;
+    this._assertAlive(), (s = this._assertWriteAllowed) == null || s.call(this), 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;
+    this._disposed = !0;
+    const s = [], t = this._stop;
+    this._stop = void 0;
+    const h = this._disposeRevision;
+    this._disposeRevision = void 0;
+    const o = 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;
+    try {
+      t == null || t();
+    } catch (i) {
+      s.push(i);
+    }
+    try {
+      h == null || h();
+    } catch (i) {
+      s.push(i);
+    }
+    try {
+      o == null || o(this);
+    } catch (i) {
+      s.push(i);
+    }
+    k(s, `[Raph] Path handle "${this.path}" disposal failed.`);
+  }
+  /**
+   * Читает path с регистрацией runtime reactive dependency.
+   * @internal
+   */
+  _getTracked() {
+    var s;
+    return this._assertAlive(), (s = this._assertTrackedRead) == null || s.call(this), this._readTracked();
+  }
+  _readTracked() {
+    return this._observe(), this._revision.get(), this._store.get(this.path);
+  }
+  _observe() {
+    this._stop ?? (this._stop = this._store.watch(this._masks, () => {
+      this._revision.set(this._revision.peek() + 1);
+    }));
+  }
+  _write(s) {
+    const t = this._runWrite;
+    t === void 0 ? s() : t(s);
+  }
+  _assertAlive() {
+    var s;
+    if (this._disposed)
+      throw new w(`[Raph] Path handle "${this.path}" is disposed.`);
+    (s = this._assertOwnerAlive) == null || s.call(this);
+  }
+}
+export {
+  R as PathHandle
+};

package/dist/debug/runtime/RaphDebug.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./RaphNode.cjs");function c(e){const d=e instanceof t.RaphNode?e.children.map(c):[];return Object.freeze({id:e.id,kind:e instanceof t.RaphNode?"node":"scope",disposed:e.disposed,resources:e._debugResourceCount(),sources:e._debugSourceCount(),children:Object.freeze(d)})}exports.createOwnerSnapshot=c;

package/dist/debug/runtime/RaphDebug.js

@@ -0,0 +1,15 @@
+import { RaphNode as c } from "./RaphNode.js";
+function s(e) {
+  const d = e instanceof c ? e.children.map(s) : [];
+  return Object.freeze({
+    id: e.id,
+    kind: e instanceof c ? "node" : "scope",
+    disposed: e.disposed,
+    resources: e._debugResourceCount(),
+    sources: e._debugSourceCount(),
+    children: Object.freeze(d)
+  });
+}
+export {
+  s as createOwnerSnapshot
+};

package/dist/debug/runtime/RaphFrameLoop.cjs

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

package/dist/debug/runtime/RaphFrameLoop.js

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

package/dist/debug/runtime/RaphNode.cjs

@@ -0,0 +1 @@
+"use strict";var d=Object.defineProperty;var _=(s,i,e)=>i in s?d(s,i,{enumerable:!0,configurable:!0,writable:!0,value:e}):s[i]=e;var n=(s,i,e)=>_(s,typeof i!="symbol"?i+"":i,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("./disposal.cjs"),c=require("./errors.cjs"),m=require("./RaphScope.cjs");let y=0;class h extends m.RaphScope{constructor(e,t={},o){const a=o??(e instanceof h?e.runtime:e??void 0);if(a===void 0)throw new Error("[RaphNode] A root node requires an explicit runtime.");const r=e instanceof h?e:(e==null?void 0:e.root)??null;super(t.id??`node-${y++}`,a);n(this,"priority");n(this,"_parent");n(this,"_children",[]);n(this,"api");n(this,"meta");n(this,"type");if(r!==null&&r.runtime!==a)throw super.dispose(),new c.RaphCrossRuntimeError("[Raph] Parent belongs to another runtime.");try{r==null||r._assertAlive()}catch(p){throw super.dispose(),p}const u=t.priority??0;l(u),this.priority=u,this._parent=r,this.meta={...t.meta},this.type=t.type??"default",this.api=Object.freeze({}),r==null||r._children.push(this)}get parent(){return this._parent}get children(){return this._children}addChild(e){if(this._assertAlive(),e._assertAlive(),e.runtime!==this.runtime)throw new c.RaphCrossRuntimeError("[Raph] Child belongs to another runtime.");if(this===e)throw new Error("[Raph] A node cannot become its own ancestor.");for(let t=this._parent;t!==null;t=t.parent)if(t===e)throw new Error("[Raph] A node cannot become its own ancestor.");if(e.parent===this)return!0;if(e._parent!==null){const t=e._parent._children,o=t.indexOf(e);o>=0&&t.splice(o,1)}return e._parent=this,this._children.push(e),!0}options(e){this._assertAlive(),e.meta!==void 0&&(this.meta={...e.meta}),e.priority!==void 0&&(l(e.priority),this.priority=e.priority),e.type!==void 0&&(this.type=e.type)}dirty(e){this._assertAlive(),this.runtime.invalidateNode(this,e)}remove(){this.dispose()}dispose(){if(this._disposed||this._disposing)return;this._disposing=!0;const e=[];for(const t of[...this._children])try{t.dispose()}catch(o){e.push(o)}if(this._children.length=0,this._parent!==null){const t=this._parent._children.indexOf(this);t>=0&&this._parent._children.splice(t,1)}this._parent=null;try{super.dispose()}catch(t){e.push(t)}f.throwDisposalErrors(e,`[Raph] Node "${this.id}" disposal failed.`)}observeData(e,t){return this._assertAlive(),this.runtime.observeData(this,e,t)}track(e,t={}){return this._assertAlive(),this.runtime.track(this,e,t)}_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})}}function l(s){if(!Number.isFinite(s))throw new TypeError("[Raph] Node priority must be finite.")}exports.RaphNode=h;