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

package/dist/debug/api/RaphFacadeSession.cjs

@@ -0,0 +1 @@
+"use strict";var A=Object.defineProperty;var C=(n,e,t)=>e in n?A(n,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):n[e]=t;var c=(n,e,t)=>C(n,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const E=require("../path/RaphKernel.cjs"),l=require("../runtime/phases/phase.types.cjs"),g=require("../runtime/RaphRuntime.cjs"),i=require("./errors.cjs"),R=require("./RaphReactivityInstance.cjs"),d=class d{constructor(){c(this,"_instances",new Map);c(this,"_instanceOrder",[]);c(this,"_defaultInstance");c(this,"_disposed",!1)}static create(e){const t=D(e),r=new d,s=[];try{for(const a of t){const o=r._construct(a);r._register(o),a.default&&(r._defaultInstance=o)}return r}catch(a){s.push(a);try{r.dispose()}catch(o){o instanceof AggregateError?s.push(...o.errors):s.push(o)}throw s.length===1?a:new AggregateError(s,"[Raph] Facade configuration and cleanup failed.")}}get disposed(){return this._disposed}get defaultInstanceId(){var e;return(e=this._defaultInstance)==null?void 0:e.id}instance(e){if(this._assertActive(),e===void 0){if(this._defaultInstance===void 0)throw new i.RaphDefaultInstanceError("[Raph] Facade session has no default instance.");return this._defaultInstance}h(e);const t=this._instances.get(e);if(t===void 0)throw new i.RaphConfigurationError(`[Raph] Instance "${e}" is not registered.`);return t}getInstance(e){return this._assertActive(),h(e),this._instances.get(e)}hasInstance(e){return this.getInstance(e)!==void 0}runtime(e){const t=this.instance(e);if(!(t instanceof g.RaphRuntime))throw new i.RaphCapabilityError(`[Raph] Instance "${t.id}" uses reactivity mode and has no Runtime capabilities.`);return t}reactivity(e){const t=this.instance(e);if(!(t instanceof R.RaphReactivityInstance))throw new i.RaphCapabilityError(`[Raph] Instance "${t.id}" uses runtime mode and is not a pure reactivity instance.`);return t}createRuntime(e={}){this._assertActive();const t=e.id??this._generateId("runtime");h(t),this._assertFreeId(t);const r=new g.RaphRuntime({...e,id:t});return this._register(r),r}createReactivity(e={}){this._assertActive();const t=e.id??this._generateId("reactivity");h(t),this._assertFreeId(t);const r=new R.RaphReactivityInstance(t,e);return this._register(r),r}createKernel(e={}){return this._assertActive(),new E.RaphKernel(e)}disposeInstance(e){const t=this.getInstance(e);return t===void 0?!1:(t.dispose(),!0)}dispose(){if(this._disposed)return;this._disposed=!0;const e=[...this._instanceOrder].reverse();this._instances.clear(),this._instanceOrder.length=0,this._defaultInstance=void 0;const t=[];for(const r of e)try{r.dispose()}catch(s){t.push(s)}if(t.length===1)throw t[0];if(t.length>1)throw new AggregateError(t,"[Raph] Facade session reset failed.")}_construct(e){if(e.mode==="reactivity"){const s=e.config;return new R.RaphReactivityInstance(e.id,{...s.adaptiveDependencyIndex===void 0?{}:{adaptiveDependencyIndex:s.adaptiveDependencyIndex}})}const t=e.config,r=new g.RaphRuntime({...t.adaptiveDependencyIndex===void 0?{}:{adaptiveDependencyIndex:t.adaptiveDependencyIndex},...t.debug===void 0?{}:{debug:t.debug},...t.enforceActions===void 0?{}:{enforceActions:t.enforceActions},...t.kernel===void 0?{}:{kernel:t.kernel},...t.scheduler===void 0?{}:{scheduler:t.scheduler},id:e.id});try{return t.phases!==void 0&&r.definePhases(t.phases),r}catch(s){try{r.dispose()}catch(a){throw new AggregateError([s,a],`[Raph] Runtime "${e.id}" construction and cleanup failed.`)}throw s}}_register(e){this._assertFreeId(e.id),this._instances.set(e.id,e),this._instanceOrder.push(e),e._onDisposed(()=>this._forget(e))}_forget(e){this._instances.get(e.id)===e&&this._instances.delete(e.id);const t=this._instanceOrder.indexOf(e);t>=0&&this._instanceOrder.splice(t,1),this._defaultInstance===e&&(this._defaultInstance=void 0)}_generateId(e){let t;do t=e==="runtime"?`runtime-${d._runtimeCounter++}`:`reactivity-${d._reactivityCounter++}`;while(this._instances.has(t));return t}_assertFreeId(e){if(this._instances.has(e))throw new i.RaphConfigurationError(`[Raph] Instance id "${e}" is already registered.`)}_assertActive(){if(this._disposed)throw new i.RaphFacadeDisposedError("[Raph] Facade session is disposed.")}};c(d,"_runtimeCounter",0),c(d,"_reactivityCounter",0);let y=d;function D(n){if(typeof n!="object"||n===null||Array.isArray(n))throw new i.RaphConfigurationError("[Raph] Configure options must be an object.");if(Object.hasOwn(n,"instances")){w(n,new Set(["instances"]),"configure");const s=n.instances;if(typeof s!="object"||s===null||Array.isArray(s))throw new i.RaphConfigurationError("[Raph] instances must be an object.");const a=[],o=new Set;let v=0;for(const[_,f]of Object.entries(s)){if(typeof f!="object"||f===null||Array.isArray(f))throw new i.RaphConfigurationError(`[Raph] Instance definition "${_}" must be an object.`);const u=f;b(u,!0);const p=u.id??_;if(h(p),o.has(p))throw new i.RaphConfigurationError(`[Raph] Resolved instance id "${p}" is duplicated.`);o.add(p);const m=u.default===!0;m&&v++,a.push({config:u,default:m,id:p,mode:u.mode})}if(v>1)throw new i.RaphConfigurationError("[Raph] Exactly one instance may declare default: true.");return a}const e=n;b(e,!1);const t=e.mode??"runtime",r=e.id??"default";return h(r),[{config:e,default:!0,id:r,mode:t}]}function b(n,e){const t=n.mode??(e?void 0:"runtime");if(t!=="runtime"&&t!=="reactivity")throw new i.RaphConfigurationError(e?"[Raph] Every instances entry must declare mode.":"[Raph] Unsupported instance mode.");if(t==="reactivity"){if(w(n,new Set(e?["adaptiveDependencyIndex","default","id","mode"]:["adaptiveDependencyIndex","id","mode"]),"reactivity instance"),I(n.adaptiveDependencyIndex),e&&n.default!==void 0&&typeof n.default!="boolean")throw new i.RaphConfigurationError("[Raph] default must be boolean.");return}if(w(n,new Set(e?["adaptiveDependencyIndex","debug","default","enforceActions","id","kernel","mode","phases","scheduler"]:["adaptiveDependencyIndex","debug","enforceActions","id","kernel","mode","phases","scheduler"]),"runtime instance"),I(n.adaptiveDependencyIndex),e&&n.default!==void 0&&typeof n.default!="boolean")throw new i.RaphConfigurationError("[Raph] default must be boolean.");const r=n;if(r.enforceActions!==void 0&&typeof r.enforceActions!="boolean")throw new i.RaphConfigurationError("[Raph] enforceActions must be boolean.");if(r.kernel!==void 0&&!(r.kernel instanceof E.RaphKernel))throw new i.RaphConfigurationError("[Raph] kernel must be a RaphKernel instance.");if(r.phases!==void 0&&!Array.isArray(r.phases))throw new i.RaphConfigurationError("[Raph] phases must be an array.");if(r.scheduler!==void 0&&!x(r.scheduler))throw new i.RaphConfigurationError(`[Raph] Unsupported scheduler "${String(r.scheduler)}".`);if(r.debug!==void 0&&(typeof r.debug!="object"||r.debug===null))throw new i.RaphConfigurationError("[Raph] debug must be an object.")}function I(n){if(n!==void 0&&typeof n!="boolean")throw new i.RaphConfigurationError("[Raph] adaptiveDependencyIndex must be boolean.")}function w(n,e,t){for(const r of Object.keys(n))if(!e.has(r))throw new i.RaphConfigurationError(`[Raph] Unsupported ${t} option "${r}".`)}function h(n){if(typeof n!="string"||n.length===0||n.trim()!==n)throw new i.RaphConfigurationError("[Raph] Instance id must be a non-empty string without surrounding whitespace.")}function x(n){return n===l.RaphSchedulerType.Sync||n===l.RaphSchedulerType.Microtask||n===l.RaphSchedulerType.AnimationFrame}exports.RaphFacadeSession=y;

package/dist/debug/api/RaphFacadeSession.js

@@ -0,0 +1,306 @@
+var x = Object.defineProperty;
+var k = (n, e, t) => e in n ? x(n, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : n[e] = t;
+var c = (n, e, t) => k(n, typeof e != "symbol" ? e + "" : e, t);
+import { RaphKernel as D } from "../path/RaphKernel.js";
+import { RaphSchedulerType as l } from "../runtime/phases/phase.types.js";
+import { RaphRuntime as w } from "../runtime/RaphRuntime.js";
+import { RaphDefaultInstanceError as E, RaphConfigurationError as i, RaphCapabilityError as I, RaphFacadeDisposedError as $ } from "./errors.js";
+import { RaphReactivityInstance as y } from "./RaphReactivityInstance.js";
+const d = class d {
+  constructor() {
+    c(this, "_instances", /* @__PURE__ */ new Map());
+    c(this, "_instanceOrder", []);
+    c(this, "_defaultInstance");
+    c(this, "_disposed", !1);
+  }
+  // ---------------------------------------------
+  // PUBLIC API
+  // ---------------------------------------------
+  /**
+   * Валидирует всю конфигурацию до construction и атомарно создаёт session.
+   */
+  static create(e) {
+    const t = j(e), s = new d(), r = [];
+    try {
+      for (const a of t) {
+        const o = s._construct(a);
+        s._register(o), a.default && (s._defaultInstance = o);
+      }
+      return s;
+    } catch (a) {
+      r.push(a);
+      try {
+        s.dispose();
+      } catch (o) {
+        o instanceof AggregateError ? r.push(...o.errors) : r.push(o);
+      }
+      throw r.length === 1 ? a : new AggregateError(r, "[Raph] Facade configuration and cleanup failed.");
+    }
+  }
+  /**
+   * Показывает, завершен ли lifecycle session.
+   */
+  get disposed() {
+    return this._disposed;
+  }
+  /**
+   * Возвращает ID default instance без создания fallback.
+   */
+  get defaultInstanceId() {
+    var e;
+    return (e = this._defaultInstance) == null ? void 0 : e.id;
+  }
+  /**
+   * Возвращает default либо явно адресованный instance.
+   */
+  instance(e) {
+    if (this._assertActive(), e === void 0) {
+      if (this._defaultInstance === void 0)
+        throw new E("[Raph] Facade session has no default instance.");
+      return this._defaultInstance;
+    }
+    h(e);
+    const t = this._instances.get(e);
+    if (t === void 0)
+      throw new i(`[Raph] Instance "${e}" is not registered.`);
+    return t;
+  }
+  /**
+   * Читает registry без ошибки для неизвестного ID.
+   */
+  getInstance(e) {
+    return this._assertActive(), h(e), this._instances.get(e);
+  }
+  /**
+   * Проверяет наличие managed instance.
+   */
+  hasInstance(e) {
+    return this.getInstance(e) !== void 0;
+  }
+  /**
+   * Возвращает Runtime или сообщает о capability mismatch.
+   */
+  runtime(e) {
+    const t = this.instance(e);
+    if (!(t instanceof w))
+      throw new I(
+        `[Raph] Instance "${t.id}" uses reactivity mode and has no Runtime capabilities.`
+      );
+    return t;
+  }
+  /**
+   * Возвращает pure-reactivity instance или сообщает о capability mismatch.
+   */
+  reactivity(e) {
+    const t = this.instance(e);
+    if (!(t instanceof y))
+      throw new I(
+        `[Raph] Instance "${t.id}" uses runtime mode and is not a pure reactivity instance.`
+      );
+    return t;
+  }
+  /**
+   * Создаёт managed Runtime без неявного изменения default pointer.
+   */
+  createRuntime(e = {}) {
+    this._assertActive();
+    const t = e.id ?? this._generateId("runtime");
+    h(t), this._assertFreeId(t);
+    const s = new w({ ...e, id: t });
+    return this._register(s), s;
+  }
+  /**
+   * Создаёт managed pure-reactivity instance без изменения default pointer.
+   */
+  createReactivity(e = {}) {
+    this._assertActive();
+    const t = e.id ?? this._generateId("reactivity");
+    h(t), this._assertFreeId(t);
+    const s = new y(t, e);
+    return this._register(s), s;
+  }
+  /** Создаёт unmanaged Kernel, сохраняя generation-bound lifecycle check. */
+  createKernel(e = {}) {
+    return this._assertActive(), new D(e);
+  }
+  /**
+   * Освобождает managed instance и сразу удаляет его из registry.
+   */
+  disposeInstance(e) {
+    const t = this.getInstance(e);
+    return t === void 0 ? !1 : (t.dispose(), !0);
+  }
+  /**
+   * Освобождает managed instances в обратном порядке construction.
+   */
+  dispose() {
+    if (this._disposed)
+      return;
+    this._disposed = !0;
+    const e = [...this._instanceOrder].reverse();
+    this._instances.clear(), this._instanceOrder.length = 0, this._defaultInstance = void 0;
+    const t = [];
+    for (const s of e)
+      try {
+        s.dispose();
+      } catch (r) {
+        t.push(r);
+      }
+    if (t.length === 1)
+      throw t[0];
+    if (t.length > 1)
+      throw new AggregateError(t, "[Raph] Facade session reset failed.");
+  }
+  // ---------------------------------------------
+  // PRIVATE
+  // ---------------------------------------------
+  /**
+   * Создаёт instance из заранее проверенного definition.
+   */
+  _construct(e) {
+    if (e.mode === "reactivity") {
+      const r = e.config;
+      return new y(e.id, {
+        ...r.adaptiveDependencyIndex === void 0 ? {} : { adaptiveDependencyIndex: r.adaptiveDependencyIndex }
+      });
+    }
+    const t = e.config, s = new w({
+      ...t.adaptiveDependencyIndex === void 0 ? {} : { adaptiveDependencyIndex: t.adaptiveDependencyIndex },
+      ...t.debug === void 0 ? {} : { debug: t.debug },
+      ...t.enforceActions === void 0 ? {} : { enforceActions: t.enforceActions },
+      ...t.kernel === void 0 ? {} : { kernel: t.kernel },
+      ...t.scheduler === void 0 ? {} : { scheduler: t.scheduler },
+      id: e.id
+    });
+    try {
+      return t.phases !== void 0 && s.definePhases(t.phases), s;
+    } catch (r) {
+      try {
+        s.dispose();
+      } catch (a) {
+        throw new AggregateError(
+          [r, a],
+          `[Raph] Runtime "${e.id}" construction and cleanup failed.`
+        );
+      }
+      throw r;
+    }
+  }
+  /**
+   * Регистрирует единственный managed owner и его terminal cleanup.
+   */
+  _register(e) {
+    this._assertFreeId(e.id), this._instances.set(e.id, e), this._instanceOrder.push(e), e._onDisposed(() => this._forget(e));
+  }
+  /**
+   * Удаляет точную identity после её terminal disposal.
+   */
+  _forget(e) {
+    this._instances.get(e.id) === e && this._instances.delete(e.id);
+    const t = this._instanceOrder.indexOf(e);
+    t >= 0 && this._instanceOrder.splice(t, 1), this._defaultInstance === e && (this._defaultInstance = void 0);
+  }
+  /**
+   * Формирует свободный ID для dynamic factory.
+   */
+  _generateId(e) {
+    let t;
+    do
+      t = e === "runtime" ? `runtime-${d._runtimeCounter++}` : `reactivity-${d._reactivityCounter++}`;
+    while (this._instances.has(t));
+    return t;
+  }
+  /**
+   * Отклоняет duplicate resolved ID до registration.
+   */
+  _assertFreeId(e) {
+    if (this._instances.has(e))
+      throw new i(`[Raph] Instance id "${e}" is already registered.`);
+  }
+  /**
+   * Запрещает stale typed/global handle после reset.
+   */
+  _assertActive() {
+    if (this._disposed)
+      throw new $("[Raph] Facade session is disposed.");
+  }
+};
+c(d, "_runtimeCounter", 0), c(d, "_reactivityCounter", 0);
+let b = d;
+function j(n) {
+  if (typeof n != "object" || n === null || Array.isArray(n))
+    throw new i("[Raph] Configure options must be an object.");
+  if (Object.hasOwn(n, "instances")) {
+    v(n, /* @__PURE__ */ new Set(["instances"]), "configure");
+    const r = n.instances;
+    if (typeof r != "object" || r === null || Array.isArray(r))
+      throw new i("[Raph] instances must be an object.");
+    const a = [], o = /* @__PURE__ */ new Set();
+    let g = 0;
+    for (const [m, p] of Object.entries(r)) {
+      if (typeof p != "object" || p === null || Array.isArray(p))
+        throw new i(`[Raph] Instance definition "${m}" must be an object.`);
+      const u = p;
+      R(u, !0);
+      const f = u.id ?? m;
+      if (h(f), o.has(f))
+        throw new i(`[Raph] Resolved instance id "${f}" is duplicated.`);
+      o.add(f);
+      const _ = u.default === !0;
+      _ && g++, a.push({ config: u, default: _, id: f, mode: u.mode });
+    }
+    if (g > 1)
+      throw new i("[Raph] Exactly one instance may declare default: true.");
+    return a;
+  }
+  const e = n;
+  R(e, !1);
+  const t = e.mode ?? "runtime", s = e.id ?? "default";
+  return h(s), [{ config: e, default: !0, id: s, mode: t }];
+}
+function R(n, e) {
+  const t = n.mode ?? (e ? void 0 : "runtime");
+  if (t !== "runtime" && t !== "reactivity")
+    throw new i(
+      e ? "[Raph] Every instances entry must declare mode." : "[Raph] Unsupported instance mode."
+    );
+  if (t === "reactivity") {
+    if (v(n, new Set(e ? ["adaptiveDependencyIndex", "default", "id", "mode"] : ["adaptiveDependencyIndex", "id", "mode"]), "reactivity instance"), A(n.adaptiveDependencyIndex), e && n.default !== void 0 && typeof n.default != "boolean")
+      throw new i("[Raph] default must be boolean.");
+    return;
+  }
+  if (v(n, new Set(e ? ["adaptiveDependencyIndex", "debug", "default", "enforceActions", "id", "kernel", "mode", "phases", "scheduler"] : ["adaptiveDependencyIndex", "debug", "enforceActions", "id", "kernel", "mode", "phases", "scheduler"]), "runtime instance"), A(n.adaptiveDependencyIndex), e && n.default !== void 0 && typeof n.default != "boolean")
+    throw new i("[Raph] default must be boolean.");
+  const s = n;
+  if (s.enforceActions !== void 0 && typeof s.enforceActions != "boolean")
+    throw new i("[Raph] enforceActions must be boolean.");
+  if (s.kernel !== void 0 && !(s.kernel instanceof D))
+    throw new i("[Raph] kernel must be a RaphKernel instance.");
+  if (s.phases !== void 0 && !Array.isArray(s.phases))
+    throw new i("[Raph] phases must be an array.");
+  if (s.scheduler !== void 0 && !O(s.scheduler))
+    throw new i(`[Raph] Unsupported scheduler "${String(s.scheduler)}".`);
+  if (s.debug !== void 0 && (typeof s.debug != "object" || s.debug === null))
+    throw new i("[Raph] debug must be an object.");
+}
+function A(n) {
+  if (n !== void 0 && typeof n != "boolean")
+    throw new i("[Raph] adaptiveDependencyIndex must be boolean.");
+}
+function v(n, e, t) {
+  for (const s of Object.keys(n))
+    if (!e.has(s))
+      throw new i(`[Raph] Unsupported ${t} option "${s}".`);
+}
+function h(n) {
+  if (typeof n != "string" || n.length === 0 || n.trim() !== n)
+    throw new i(
+      "[Raph] Instance id must be a non-empty string without surrounding whitespace."
+    );
+}
+function O(n) {
+  return n === l.Sync || n === l.Microtask || n === l.AnimationFrame;
+}
+export {
+  b as RaphFacadeSession
+};

package/dist/debug/api/RaphReactivityInstance.cjs

@@ -0,0 +1 @@
+"use strict";var h=Object.defineProperty;var d=(s,e,t)=>e in s?h(s,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):s[e]=t;var i=(s,e,t)=>d(s,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("../reactivity/engine.cjs"),n=require("../reactivity/reactive-object.cjs"),u=require("../reactivity/scope.cjs"),c=require("../runtime/errors.cjs");class v{constructor(e,t={}){i(this,"mode","reactivity");i(this,"engine");i(this,"rootScope");i(this,"_disposed",!1);i(this,"_disposedListeners",new Set);this.id=e,this.engine=new p.RaphReactivity({adaptiveDependencyIndex:t.adaptiveDependencyIndex??!1}),this.rootScope=new u.ScopeNode(this.engine),n.configureReactiveObjectPolicy(this.engine,{owner:this,assertRead:()=>this._assertAlive(),assertWrite:()=>this._assertAlive(),throwForeign:()=>{throw new TypeError("[Raph] Reactive object belongs to another reactivity instance.")}})}get disposed(){return this._disposed}signal(e){return this._assertAlive(),this.rootScope.signal(e)}reactive(e){return this._assertAlive(),this.engine.reactive(e)}computed(e){return this._assertAlive(),typeof e=="function"?this.rootScope.computed(e):this.rootScope.computed(e)}effect(e){return this._assertAlive(),this.rootScope.effect(e)}watch(e,t,o){return this._assertAlive(),this.rootScope.watch(e,t,o)}batch(e){return this._assertAlive(),this.engine.batch(e)}untracked(e){return this._assertAlive(),this.engine.untracked(e)}scope(){this._assertAlive();const e=this.engine.scope();return this.rootScope.own(()=>e.dispose()),e}dispose(){if(this._disposed)return;this._disposed=!0;const e=[];try{this.rootScope.dispose()}catch(r){e.push(r)}const t=()=>{throw new c.RaphDisposedError(`[Raph] Reactivity instance "${this.id}" is disposed.`)};try{n.disposeReactiveObjectContext(this.engine,{assertRead:t,assertWrite:t,throwForeign:t})}catch(r){e.push(r)}const o=[...this._disposedListeners];this._disposedListeners.clear();for(const r of o)try{r()}catch(a){e.push(a)}if(e.length===1)throw e[0];if(e.length>1)throw new AggregateError(e,`[Raph] Reactivity instance "${this.id}" disposal failed.`)}_onDisposed(e){return this._disposed?(e(),()=>{}):(this._disposedListeners.add(e),()=>{this._disposedListeners.delete(e)})}_assertAlive(){if(this._disposed)throw new c.RaphDisposedError(`[Raph] Reactivity instance "${this.id}" is disposed.`)}}exports.RaphReactivityInstance=v;

package/dist/debug/api/RaphReactivityInstance.js

@@ -0,0 +1,149 @@
+var a = Object.defineProperty;
+var c = (s, e, t) => e in s ? a(s, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : s[e] = t;
+var i = (s, e, t) => c(s, typeof e != "symbol" ? e + "" : e, t);
+import { RaphReactivity as d } from "../reactivity/engine.js";
+import { configureReactiveObjectPolicy as p, disposeReactiveObjectContext as v } from "../reactivity/reactive-object.js";
+import { ScopeNode as l } from "../reactivity/scope.js";
+import { RaphDisposedError as n } from "../runtime/errors.js";
+class R {
+  /**
+   * Создаёт изолированный graph с общим lifecycle owner.
+   */
+  constructor(e, t = {}) {
+    i(this, "mode", "reactivity");
+    i(this, "engine");
+    i(this, "rootScope");
+    i(this, "_disposed", !1);
+    i(this, "_disposedListeners", /* @__PURE__ */ new Set());
+    this.id = e, this.engine = new d({
+      adaptiveDependencyIndex: t.adaptiveDependencyIndex ?? !1
+    }), this.rootScope = new l(this.engine), p(this.engine, {
+      owner: this,
+      assertRead: () => this._assertAlive(),
+      assertWrite: () => this._assertAlive(),
+      throwForeign: () => {
+        throw new TypeError("[Raph] Reactive object belongs to another reactivity instance.");
+      }
+    });
+  }
+  // ---------------------------------------------
+  // PUBLIC API
+  // ---------------------------------------------
+  /**
+   * Показывает, завершён ли lifecycle instance.
+   */
+  get disposed() {
+    return this._disposed;
+  }
+  /**
+   * Создаёт signal, принадлежащий root scope instance.
+   */
+  signal(e) {
+    return this._assertAlive(), this.rootScope.signal(e);
+  }
+  /**
+   * Создаёт deep reactive Proxy в изолированном graph instance.
+   */
+  reactive(e) {
+    return this._assertAlive(), this.engine.reactive(e);
+  }
+  computed(e) {
+    return this._assertAlive(), typeof e == "function" ? this.rootScope.computed(e) : this.rootScope.computed(e);
+  }
+  /**
+   * Создаёт синхронный effect в root scope instance.
+   */
+  effect(e) {
+    return this._assertAlive(), this.rootScope.effect(e);
+  }
+  /**
+   * Создаёт value watch в root scope instance.
+   */
+  watch(e, t, o) {
+    return this._assertAlive(), this.rootScope.watch(e, t, o);
+  }
+  /**
+   * Группирует propagation одного reactive graph.
+   */
+  batch(e) {
+    return this._assertAlive(), this.engine.batch(e);
+  }
+  /**
+   * Выполняет операцию без dependency tracking.
+   */
+  untracked(e) {
+    return this._assertAlive(), this.engine.untracked(e);
+  }
+  /**
+   * Создаёт дочерний resource scope, освобождаемый вместе с instance.
+   */
+  scope() {
+    this._assertAlive();
+    const e = this.engine.scope();
+    return this.rootScope.own(() => e.dispose()), e;
+  }
+  /**
+   * Освобождает owned resources и делает retained reactive proxies терминальными.
+   */
+  dispose() {
+    if (this._disposed)
+      return;
+    this._disposed = !0;
+    const e = [];
+    try {
+      this.rootScope.dispose();
+    } catch (r) {
+      e.push(r);
+    }
+    const t = () => {
+      throw new n(`[Raph] Reactivity instance "${this.id}" is disposed.`);
+    };
+    try {
+      v(this.engine, {
+        assertRead: t,
+        assertWrite: t,
+        throwForeign: t
+      });
+    } catch (r) {
+      e.push(r);
+    }
+    const o = [...this._disposedListeners];
+    this._disposedListeners.clear();
+    for (const r of o)
+      try {
+        r();
+      } catch (h) {
+        e.push(h);
+      }
+    if (e.length === 1)
+      throw e[0];
+    if (e.length > 1)
+      throw new AggregateError(e, `[Raph] Reactivity instance "${this.id}" disposal failed.`);
+  }
+  // ---------------------------------------------
+  // INTERNAL
+  // ---------------------------------------------
+  /**
+   * Привязывает registry cleanup к lifecycle managed instance.
+   * @internal
+   */
+  _onDisposed(e) {
+    return this._disposed ? (e(), () => {
+    }) : (this._disposedListeners.add(e), () => {
+      this._disposedListeners.delete(e);
+    });
+  }
+  // ---------------------------------------------
+  // PRIVATE
+  // ---------------------------------------------
+  /**
+   * Запрещает операции после завершения lifecycle.
+   */
+  _assertAlive() {
+    if (this._disposed)
+      throw new n(`[Raph] Reactivity instance "${this.id}" is disposed.`);
+  }
+}
+export {
+  R as RaphReactivityInstance
+};

package/dist/debug/api/errors.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class o extends Error{}class e extends o{}class a extends e{}class t extends e{}exports.RaphConfigurationError=e;exports.RaphDefaultRuntimeError=t;exports.RaphError=o;exports.RaphModeError=a;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class e extends Error{}class a extends e{}class s extends a{}class o extends a{}class t extends a{}exports.RaphCapabilityError=s;exports.RaphConfigurationError=a;exports.RaphDefaultInstanceError=o;exports.RaphError=e;exports.RaphFacadeDisposedError=t;

package/dist/debug/api/errors.js

@@ -1,14 +1,17 @@
-class s extends Error {
+class a extends Error {
+}
+class s extends a {
 }
 class e extends s {
 }
-class a extends e {
+class o extends s {
 }
-class o extends e {
+class t extends s {
 }
 export {
-  e as RaphConfigurationError,
-  o as RaphDefaultRuntimeError,
-  s as RaphError,
-  a as RaphModeError
+  e as RaphCapabilityError,
+  s as RaphConfigurationError,
+  o as RaphDefaultInstanceError,
+  a as RaphError,
+  t as RaphFacadeDisposedError
 };

package/dist/debug/path/DataPath.cjs

@@ -0,0 +1 @@
+"use strict";var v=Object.defineProperty;var S=(t,e,n)=>e in t?v(t,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):t[e]=n;var f=(t,e,n)=>S(t,typeof e!="symbol"?e+"":e,n);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const E=2e4,u=class u{constructor(e,n){f(this,"_canonical");f(this,"_segments");f(this,"_exact");f(this,"_mask");this._canonical=e,this._segments=Object.freeze(n.map(r=>Object.freeze({...r})))}static from(e,n){return e instanceof u?e:typeof e=="string"?this.fromString(e,n):this.fromPlain(e)}static fromString(e,n){const r=m(e,n==null?void 0:n.vars,!0,(n==null?void 0:n.wildcardDynamic)===!0,!0),s=this._cache??(this._cache=new Map),i=s.get(r.canonical);if(i!==void 0)return i;s.size>=E&&s.clear();const c=new u(r.canonical,r.segments);return s.set(r.canonical,c),c}static fromPlain(e){const r=(Array.isArray(e.segs)?e.segs:[]).map(M);return new u(y(r),r)}static _parseExactString(e,n){const r=m(e,n==null?void 0:n.vars,!1,!1,!0);return{canonical:r.canonical,segments:r.segments}}static _parseMaskString(e){const n=m(e,void 0,!0,!1,!0);for(let i=0;i<n.segments.length-1;i++){const c=n.segments[i];if(c.kind==="wildcard"&&!c.indexed)throw new TypeError(`[Raph] Dot wildcard must be the final mask segment: "${e}".`)}const r=n.segments[n.segments.length-1],s=(r==null?void 0:r.kind)==="wildcard"&&!r.indexed;return{canonical:n.canonical,deep:s,segments:s?n.segments.slice(0,-1):n.segments}}static _renderSegments(e){return y(e)}toPlain(){return{segs:this._segments.map(e=>e.kind==="key"?{t:"key",k:e.key}:e.kind==="index"?{t:"idx",i:e.index}:e.kind==="selector"?{t:"param",pk:e.key,pv:e.value}:{t:"wc",indexed:e.indexed}),deepOnTail:_(this._segments)}}toStringPath(){return this._canonical}toString(){return this._canonical}segments(){return this._segments}static match(e,n){const r=this.from(e)._segments,s=this.from(n)._segments;let i=0;for(;i<r.length;i++){const c=r[i];if(c.kind==="wildcard"&&!c.indexed&&i===r.length-1)return!0;const a=s[i];if(a===void 0||!q(c,a))return!1}return i===s.length}_asExact(){for(const e of this._segments)if(e.kind==="wildcard")throw x(this._canonical);return this._exact??(this._exact={canonical:this._canonical,segments:this._segments})}_asMask(){for(let n=0;n<this._segments.length-1;n++){const r=this._segments[n];if(r.kind==="wildcard"&&!r.indexed)throw new TypeError(`[Raph] Dot wildcard must be the final mask segment: "${this._canonical}".`)}const e=_(this._segments);return this._mask??(this._mask={canonical:this._canonical,deep:e,segments:e?this._segments.slice(0,-1):this._segments})}};f(u,"_cache");let w=u;function m(t,e,n,r=!1,s=!1){const i=t.trim();if(i.length===0){if(s)return{canonical:"",segments:[]};throw new TypeError("[Raph] Data path must not be empty.")}const c=[];let a=0,l=!0;for(;a<i.length;){const b=i[a];if(b==="."){if(l)throw d(t);l=!0,a++;continue}if(b==="["){const k=T(i,a);c.push(P(i.slice(a+1,k),e,n,r)),a=k+1,l=!1;continue}if(!l)throw d(t);let o=a;for(;o<i.length&&i[o]!=="."&&i[o]!=="[";)o++;const h=i.slice(a,o).trim();if(h.length===0)throw d(t);if(h==="*"){if(!n)throw x(t);c.push({kind:"wildcard",indexed:!1})}else r&&h.startsWith("$")&&!g(h.slice(1),e)?c.push({kind:"wildcard",indexed:!1}):c.push({kind:"key",key:A(h,e)});a=o,l=!1}if(l||c.length===0)throw d(t);return{canonical:y(c),segments:c}}function T(t,e){let n,r=1;for(let s=e+1;s<t.length;s++){const i=t[s];if(i==="\\"){s++;continue}if(n!==void 0){i===n&&(n=void 0);continue}if(i==='"'||i==="'"){n=i;continue}if(i==="["){r++;continue}if(i==="]"&&--r===0)return s}throw d(t)}function P(t,e,n,r){const s=t.trim();if(s==="*"){if(!n)throw x(`[${t}]`);return{kind:"wildcard",indexed:!0}}if(/^\d+$/.test(s))return{kind:"index",index:Number(s)};if(/^\$[A-Z_$][\w$]*$/i.test(s)){if(r&&!g(s.slice(1),e))return{kind:"wildcard",indexed:!0};const l=p(s.slice(1),e);if(!Number.isInteger(l)||l<0)throw new TypeError(`[Raph] Index variable "${s}" must be a non-negative integer.`);return{kind:"index",index:l}}const i=R(s);if(i===-1)throw d(`[${t}]`);const c=s.slice(0,i).trim(),a=s.slice(i+1).trim();if(!c||!a)throw d(`[${t}]`);return r&&I(a,e)?{kind:"wildcard",indexed:!0}:{kind:"selector",key:c,value:N(a,e)}}function R(t){let e;for(let n=0;n<t.length;n++){const r=t[n];if(r==="\\"){n++;continue}if(e!==void 0){r===e&&(e=void 0);continue}if(r==='"'||r==="'")e=r;else if(r==="=")return n}return-1}function N(t,e){if(/^\$[A-Z_$][\w$]*$/i.test(t)){const n=p(t.slice(1),e);if(n===null||typeof n=="string"||typeof n=="boolean"||typeof n=="number"&&Number.isFinite(n))return n;throw new TypeError(`[Raph] Selector variable "${t}" must be scalar.`)}if(t[0]==='"'||t[0]==="'")return O(t);if(/^-?(?:\d+(?:\.\d*)?|\.\d+)$/.test(t)){const n=Number(t);if(Number.isFinite(n))return n}return t==="true"?!0:t==="false"?!1:t==="null"?null:t}function O(t){const e=t[0];if(t.length<2||t[t.length-1]!==e)throw d(t);if(e==='"')try{const r=JSON.parse(t);if(typeof r=="string")return r}catch{throw d(t)}let n="";for(let r=1;r<t.length-1;r++){const s=t[r];if(s==="\\"){if(r++,r>=t.length-1)throw d(t);n+=t[r]}else n+=s}return n}function A(t,e){if(!t.startsWith("$"))return t;const n=p(t.slice(1),e);if(typeof n!="string"&&typeof n!="number")throw new TypeError(`[Raph] Key variable "${t}" must be a string or number.`);const r=String(n);if(!r||r.includes(".")||r.includes("[")||r.includes("]"))throw new TypeError(`[Raph] Key variable "${t}" contains path syntax.`);return r}function p(t,e){if(!g(t,e))throw new TypeError(`[Raph] Missing path variable "${t}".`);return e[t]}function g(t,e){return e!==void 0&&Object.hasOwn(e,t)}function I(t,e){for(const n of t.matchAll(/\$([A-Z_$][\w$]*)/gi))if(!g(n[1],e))return!0;return!1}function M(t){if(typeof t!="object"||t===null)throw $();const e=t;if(e.t==="key"&&typeof e.k=="string")return{kind:"key",key:e.k};if(e.t==="idx"&&typeof e.i=="number"&&Number.isInteger(e.i)&&e.i>=0)return{kind:"index",index:e.i};if(e.t==="wc")return{kind:"wildcard",indexed:e.indexed===!0};if(e.t==="param"&&typeof e.pk=="string"&&j(e.pv))return{kind:"selector",key:e.pk,value:e.pv};throw $()}function j(t){return t===null||typeof t=="string"||typeof t=="boolean"||typeof t=="number"&&Number.isFinite(t)}function _(t){const e=t[t.length-1];return(e==null?void 0:e.kind)==="wildcard"&&!e.indexed}function q(t,e){return t.kind==="wildcard"?!t.indexed||e.kind==="index"||e.kind==="selector":t.kind!==e.kind?!1:t.kind==="key"?t.key===e.key:t.kind==="index"?t.index===e.index:t.key===e.key&&Object.is(t.value,e.value)}function y(t){let e="";for(const n of t)n.kind==="key"?e+=e?`.${n.key}`:n.key:n.kind==="index"?e+=`[${n.index}]`:n.kind==="selector"?e+=`[${n.key}=${D(n.value)}]`:e+=n.indexed?"[*]":e?".*":"*";return e}function D(t){return typeof t=="string"?JSON.stringify(t):String(t)}function d(t){return new TypeError(`[Raph] Invalid data path "${t}".`)}function $(){return new TypeError("[Raph] Invalid plain DataPath representation.")}function x(t){return new TypeError(`[Raph] Wildcard is only allowed in watch masks: "${t}".`)}exports.DataPath=w;