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

package/dist/debug/api/RaphFacadeSession.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("../path/RaphKernel.cjs"),f=require("../runtime/phases/phase.types.cjs"),l=require("../runtime/RaphRuntime.cjs"),i=require("./errors.cjs"),g=require("./RaphReactivityInstance.cjs");class u{static _runtimeCounter=0;static _reactivityCounter=0;_instances=new Map;_instanceOrder=[];_defaultInstance;_disposed=!1;constructor(){}static create(e){const t=I(e),n=new u,s=[];try{for(const a of t){const o=n._construct(a);n._register(o),a.default&&(n._defaultInstance=o)}return n}catch(a){s.push(a);try{n.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(){return this._defaultInstance?.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}c(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(),c(e),this._instances.get(e)}hasInstance(e){return this.getInstance(e)!==void 0}runtime(e){const t=this.instance(e);if(!(t instanceof l.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 g.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");c(t),this._assertFreeId(t);const n=new l.RaphRuntime({...e,id:t});return this._register(n),n}createReactivity(e={}){this._assertActive();const t=e.id??this._generateId("reactivity");c(t),this._assertFreeId(t);const n=new g.RaphReactivityInstance(t,e);return this._register(n),n}createKernel(e={}){return this._assertActive(),new b.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 n of e)try{n.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 g.RaphReactivityInstance(e.id,{...s.adaptiveDependencyIndex===void 0?{}:{adaptiveDependencyIndex:s.adaptiveDependencyIndex}})}const t=e.config,n=new l.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&&n.definePhases(t.phases),n}catch(s){try{n.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-${u._runtimeCounter++}`:`reactivity-${u._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.")}}function I(r){if(typeof r!="object"||r===null||Array.isArray(r))throw new i.RaphConfigurationError("[Raph] Configure options must be an object.");if(Object.hasOwn(r,"instances")){R(r,new Set(["instances"]),"configure");const s=r.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 y=0;for(const[w,p]of Object.entries(s)){if(typeof p!="object"||p===null||Array.isArray(p))throw new i.RaphConfigurationError(`[Raph] Instance definition "${w}" must be an object.`);const d=p;_(d,!0);const h=d.id??w;if(c(h),o.has(h))throw new i.RaphConfigurationError(`[Raph] Resolved instance id "${h}" is duplicated.`);o.add(h);const v=d.default===!0;v&&y++,a.push({config:d,default:v,id:h,mode:d.mode})}if(y>1)throw new i.RaphConfigurationError("[Raph] Exactly one instance may declare default: true.");return a}const e=r;_(e,!1);const t=e.mode??"runtime",n=e.id??"default";return c(n),[{config:e,default:!0,id:n,mode:t}]}function _(r,e){const t=r.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(R(r,new Set(e?["adaptiveDependencyIndex","default","id","mode"]:["adaptiveDependencyIndex","id","mode"]),"reactivity instance"),m(r.adaptiveDependencyIndex),e&&r.default!==void 0&&typeof r.default!="boolean")throw new i.RaphConfigurationError("[Raph] default must be boolean.");return}if(R(r,new Set(e?["adaptiveDependencyIndex","debug","default","enforceActions","id","kernel","mode","phases","scheduler"]:["adaptiveDependencyIndex","debug","enforceActions","id","kernel","mode","phases","scheduler"]),"runtime instance"),m(r.adaptiveDependencyIndex),e&&r.default!==void 0&&typeof r.default!="boolean")throw new i.RaphConfigurationError("[Raph] default must be boolean.");const n=r;if(n.enforceActions!==void 0&&typeof n.enforceActions!="boolean")throw new i.RaphConfigurationError("[Raph] enforceActions must be boolean.");if(n.kernel!==void 0&&!(n.kernel instanceof b.RaphKernel))throw new i.RaphConfigurationError("[Raph] kernel must be a RaphKernel instance.");if(n.phases!==void 0&&!Array.isArray(n.phases))throw new i.RaphConfigurationError("[Raph] phases must be an array.");if(n.scheduler!==void 0&&!E(n.scheduler))throw new i.RaphConfigurationError(`[Raph] Unsupported scheduler "${String(n.scheduler)}".`);if(n.debug!==void 0&&(typeof n.debug!="object"||n.debug===null))throw new i.RaphConfigurationError("[Raph] debug must be an object.")}function m(r){if(r!==void 0&&typeof r!="boolean")throw new i.RaphConfigurationError("[Raph] adaptiveDependencyIndex must be boolean.")}function R(r,e,t){for(const n of Object.keys(r))if(!e.has(n))throw new i.RaphConfigurationError(`[Raph] Unsupported ${t} option "${n}".`)}function c(r){if(typeof r!="string"||r.length===0||r.trim()!==r)throw new i.RaphConfigurationError("[Raph] Instance id must be a non-empty string without surrounding whitespace.")}function E(r){return r===f.RaphSchedulerType.Sync||r===f.RaphSchedulerType.Microtask||r===f.RaphSchedulerType.AnimationFrame}exports.RaphFacadeSession=u;

package/dist/debug/api/RaphFacadeSession.js

@@ -0,0 +1,302 @@
+import { RaphKernel as R } from "../path/RaphKernel.js";
+import { RaphSchedulerType as p } from "../runtime/phases/phase.types.js";
+import { RaphRuntime as l } from "../runtime/RaphRuntime.js";
+import { RaphDefaultInstanceError as A, RaphConfigurationError as i, RaphCapabilityError as _, RaphFacadeDisposedError as D } from "./errors.js";
+import { RaphReactivityInstance as w } from "./RaphReactivityInstance.js";
+class f {
+  static _runtimeCounter = 0;
+  static _reactivityCounter = 0;
+  _instances = /* @__PURE__ */ new Map();
+  _instanceOrder = [];
+  _defaultInstance;
+  _disposed = !1;
+  constructor() {
+  }
+  // ---------------------------------------------
+  // PUBLIC API
+  // ---------------------------------------------
+  /**
+   * Валидирует всю конфигурацию до construction и атомарно создаёт session.
+   */
+  static create(e) {
+    const t = x(e), n = new f(), r = [];
+    try {
+      for (const a of t) {
+        const o = n._construct(a);
+        n._register(o), a.default && (n._defaultInstance = o);
+      }
+      return n;
+    } catch (a) {
+      r.push(a);
+      try {
+        n.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() {
+    return this._defaultInstance?.id;
+  }
+  /**
+   * Возвращает default либо явно адресованный instance.
+   */
+  instance(e) {
+    if (this._assertActive(), e === void 0) {
+      if (this._defaultInstance === void 0)
+        throw new A("[Raph] Facade session has no default instance.");
+      return this._defaultInstance;
+    }
+    c(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(), c(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 l))
+      throw new _(
+        `[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 w))
+      throw new _(
+        `[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");
+    c(t), this._assertFreeId(t);
+    const n = new l({ ...e, id: t });
+    return this._register(n), n;
+  }
+  /**
+   * Создаёт managed pure-reactivity instance без изменения default pointer.
+   */
+  createReactivity(e = {}) {
+    this._assertActive();
+    const t = e.id ?? this._generateId("reactivity");
+    c(t), this._assertFreeId(t);
+    const n = new w(t, e);
+    return this._register(n), n;
+  }
+  /** Создаёт unmanaged Kernel, сохраняя generation-bound lifecycle check. */
+  createKernel(e = {}) {
+    return this._assertActive(), new R(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 n of e)
+      try {
+        n.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 w(e.id, {
+        ...r.adaptiveDependencyIndex === void 0 ? {} : { adaptiveDependencyIndex: r.adaptiveDependencyIndex }
+      });
+    }
+    const t = e.config, n = new l({
+      ...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 && n.definePhases(t.phases), n;
+    } catch (r) {
+      try {
+        n.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-${f._runtimeCounter++}` : `reactivity-${f._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 D("[Raph] Facade session is disposed.");
+  }
+}
+function x(s) {
+  if (typeof s != "object" || s === null || Array.isArray(s))
+    throw new i("[Raph] Configure options must be an object.");
+  if (Object.hasOwn(s, "instances")) {
+    y(s, /* @__PURE__ */ new Set(["instances"]), "configure");
+    const r = s.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 v = 0;
+    for (const [g, u] of Object.entries(r)) {
+      if (typeof u != "object" || u === null || Array.isArray(u))
+        throw new i(`[Raph] Instance definition "${g}" must be an object.`);
+      const d = u;
+      I(d, !0);
+      const h = d.id ?? g;
+      if (c(h), o.has(h))
+        throw new i(`[Raph] Resolved instance id "${h}" is duplicated.`);
+      o.add(h);
+      const m = d.default === !0;
+      m && v++, a.push({ config: d, default: m, id: h, mode: d.mode });
+    }
+    if (v > 1)
+      throw new i("[Raph] Exactly one instance may declare default: true.");
+    return a;
+  }
+  const e = s;
+  I(e, !1);
+  const t = e.mode ?? "runtime", n = e.id ?? "default";
+  return c(n), [{ config: e, default: !0, id: n, mode: t }];
+}
+function I(s, e) {
+  const t = s.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 (y(s, new Set(e ? ["adaptiveDependencyIndex", "default", "id", "mode"] : ["adaptiveDependencyIndex", "id", "mode"]), "reactivity instance"), b(s.adaptiveDependencyIndex), e && s.default !== void 0 && typeof s.default != "boolean")
+      throw new i("[Raph] default must be boolean.");
+    return;
+  }
+  if (y(s, new Set(e ? ["adaptiveDependencyIndex", "debug", "default", "enforceActions", "id", "kernel", "mode", "phases", "scheduler"] : ["adaptiveDependencyIndex", "debug", "enforceActions", "id", "kernel", "mode", "phases", "scheduler"]), "runtime instance"), b(s.adaptiveDependencyIndex), e && s.default !== void 0 && typeof s.default != "boolean")
+    throw new i("[Raph] default must be boolean.");
+  const n = s;
+  if (n.enforceActions !== void 0 && typeof n.enforceActions != "boolean")
+    throw new i("[Raph] enforceActions must be boolean.");
+  if (n.kernel !== void 0 && !(n.kernel instanceof R))
+    throw new i("[Raph] kernel must be a RaphKernel instance.");
+  if (n.phases !== void 0 && !Array.isArray(n.phases))
+    throw new i("[Raph] phases must be an array.");
+  if (n.scheduler !== void 0 && !k(n.scheduler))
+    throw new i(`[Raph] Unsupported scheduler "${String(n.scheduler)}".`);
+  if (n.debug !== void 0 && (typeof n.debug != "object" || n.debug === null))
+    throw new i("[Raph] debug must be an object.");
+}
+function b(s) {
+  if (s !== void 0 && typeof s != "boolean")
+    throw new i("[Raph] adaptiveDependencyIndex must be boolean.");
+}
+function y(s, e, t) {
+  for (const n of Object.keys(s))
+    if (!e.has(n))
+      throw new i(`[Raph] Unsupported ${t} option "${n}".`);
+}
+function c(s) {
+  if (typeof s != "string" || s.length === 0 || s.trim() !== s)
+    throw new i(
+      "[Raph] Instance id must be a non-empty string without surrounding whitespace."
+    );
+}
+function k(s) {
+  return s === p.Sync || s === p.Microtask || s === p.AnimationFrame;
+}
+export {
+  f as RaphFacadeSession
+};

package/dist/debug/api/RaphReactivityInstance.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("../reactivity/engine.cjs"),r=require("../reactivity/reactive-object.cjs"),a=require("../reactivity/scope.cjs"),o=require("../runtime/errors.cjs");class h{constructor(e,t={}){this.id=e,this.engine=new c.RaphReactivity({adaptiveDependencyIndex:t.adaptiveDependencyIndex??!1}),this.rootScope=new a.ScopeNode(this.engine),r.configureReactiveObjectPolicy(this.engine,{owner:this,assertRead:()=>this._assertAlive(),assertWrite:()=>this._assertAlive(),throwForeign:()=>{throw new TypeError("[Raph] Reactive object belongs to another reactivity instance.")}})}mode="reactivity";engine;rootScope;_disposed=!1;_disposedListeners=new Set;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,i){return this._assertAlive(),this.rootScope.watch(e,t,i)}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(s){e.push(s)}const t=()=>{throw new o.RaphDisposedError(`[Raph] Reactivity instance "${this.id}" is disposed.`)};try{r.disposeReactiveObjectContext(this.engine,{assertRead:t,assertWrite:t,throwForeign:t})}catch(s){e.push(s)}const i=[...this._disposedListeners];this._disposedListeners.clear();for(const s of i)try{s()}catch(n){e.push(n)}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 o.RaphDisposedError(`[Raph] Reactivity instance "${this.id}" is disposed.`)}}exports.RaphReactivityInstance=h;

package/dist/debug/api/RaphReactivityInstance.js

@@ -0,0 +1,146 @@
+import { RaphReactivity as n } from "../reactivity/engine.js";
+import { configureReactiveObjectPolicy as h, disposeReactiveObjectContext as a } from "../reactivity/reactive-object.js";
+import { ScopeNode as c } from "../reactivity/scope.js";
+import { RaphDisposedError as r } from "../runtime/errors.js";
+class u {
+  /**
+   * Создаёт изолированный graph с общим lifecycle owner.
+   */
+  constructor(e, t = {}) {
+    this.id = e, this.engine = new n({
+      adaptiveDependencyIndex: t.adaptiveDependencyIndex ?? !1
+    }), this.rootScope = new c(this.engine), h(this.engine, {
+      owner: this,
+      assertRead: () => this._assertAlive(),
+      assertWrite: () => this._assertAlive(),
+      throwForeign: () => {
+        throw new TypeError("[Raph] Reactive object belongs to another reactivity instance.");
+      }
+    });
+  }
+  mode = "reactivity";
+  engine;
+  rootScope;
+  _disposed = !1;
+  _disposedListeners = /* @__PURE__ */ new Set();
+  // ---------------------------------------------
+  // 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, i) {
+    return this._assertAlive(), this.rootScope.watch(e, t, i);
+  }
+  /**
+   * Группирует 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 (s) {
+      e.push(s);
+    }
+    const t = () => {
+      throw new r(`[Raph] Reactivity instance "${this.id}" is disposed.`);
+    };
+    try {
+      a(this.engine, {
+        assertRead: t,
+        assertWrite: t,
+        throwForeign: t
+      });
+    } catch (s) {
+      e.push(s);
+    }
+    const i = [...this._disposedListeners];
+    this._disposedListeners.clear();
+    for (const s of i)
+      try {
+        s();
+      } catch (o) {
+        e.push(o);
+      }
+    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 r(`[Raph] Reactivity instance "${this.id}" is disposed.`);
+  }
+}
+export {
+  u 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";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _=2e4;class u{static _cache;_canonical;_segments;_exact;_mask;constructor(e,n){this._canonical=e,this._segments=Object.freeze(n.map(i=>Object.freeze({...i})))}static from(e,n){return e instanceof u?e:typeof e=="string"?this.fromString(e,n):this.fromPlain(e)}static fromString(e,n){const i=g(e,n?.vars,!0,n?.wildcardDynamic===!0,!0),s=this._cache??=new Map,r=s.get(i.canonical);if(r!==void 0)return r;s.size>=_&&s.clear();const a=new u(i.canonical,i.segments);return s.set(i.canonical,a),a}static fromPlain(e){const i=(Array.isArray(e.segs)?e.segs:[]).map(N);return new u(m(i),i)}static _parseExactString(e,n){const i=g(e,n?.vars,!1,!1,!0);return{canonical:i.canonical,segments:i.segments}}static _parseMaskString(e){const n=g(e,void 0,!0,!1,!0);for(let r=0;r<n.segments.length-1;r++){const a=n.segments[r];if(a.kind==="wildcard"&&!a.indexed)throw new TypeError(`[Raph] Dot wildcard must be the final mask segment: "${e}".`)}const i=n.segments[n.segments.length-1],s=i?.kind==="wildcard"&&!i.indexed;return{canonical:n.canonical,deep:s,segments:s?n.segments.slice(0,-1):n.segments}}static _renderSegments(e){return m(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:b(this._segments)}}toStringPath(){return this._canonical}toString(){return this._canonical}segments(){return this._segments}static match(e,n){const i=this.from(e)._segments,s=this.from(n)._segments;let r=0;for(;r<i.length;r++){const a=i[r];if(a.kind==="wildcard"&&!a.indexed&&r===i.length-1)return!0;const c=s[r];if(c===void 0||!A(a,c))return!1}return r===s.length}_asExact(){for(const e of this._segments)if(e.kind==="wildcard")throw w(this._canonical);return this._exact??={canonical:this._canonical,segments:this._segments}}_asMask(){for(let n=0;n<this._segments.length-1;n++){const i=this._segments[n];if(i.kind==="wildcard"&&!i.indexed)throw new TypeError(`[Raph] Dot wildcard must be the final mask segment: "${this._canonical}".`)}const e=b(this._segments);return this._mask??={canonical:this._canonical,deep:e,segments:e?this._segments.slice(0,-1):this._segments}}}function g(t,e,n,i=!1,s=!1){const r=t.trim();if(r.length===0){if(s)return{canonical:"",segments:[]};throw new TypeError("[Raph] Data path must not be empty.")}const a=[];let c=0,o=!0;for(;c<r.length;){const y=r[c];if(y==="."){if(o)throw l(t);o=!0,c++;continue}if(y==="["){const x=$(r,c);a.push(v(r.slice(c+1,x),e,n,i)),c=x+1,o=!1;continue}if(!o)throw l(t);let d=c;for(;d<r.length&&r[d]!=="."&&r[d]!=="[";)d++;const f=r.slice(c,d).trim();if(f.length===0)throw l(t);if(f==="*"){if(!n)throw w(t);a.push({kind:"wildcard",indexed:!1})}else i&&f.startsWith("$")&&!h(f.slice(1),e)?a.push({kind:"wildcard",indexed:!1}):a.push({kind:"key",key:P(f,e)});c=d,o=!1}if(o||a.length===0)throw l(t);return{canonical:m(a),segments:a}}function $(t,e){let n,i=1;for(let s=e+1;s<t.length;s++){const r=t[s];if(r==="\\"){s++;continue}if(n!==void 0){r===n&&(n=void 0);continue}if(r==='"'||r==="'"){n=r;continue}if(r==="["){i++;continue}if(r==="]"&&--i===0)return s}throw l(t)}function v(t,e,n,i){const s=t.trim();if(s==="*"){if(!n)throw w(`[${t}]`);return{kind:"wildcard",indexed:!0}}if(/^\d+$/.test(s))return{kind:"index",index:Number(s)};if(/^\$[A-Z_$][\w$]*$/i.test(s)){if(i&&!h(s.slice(1),e))return{kind:"wildcard",indexed:!0};const o=p(s.slice(1),e);if(!Number.isInteger(o)||o<0)throw new TypeError(`[Raph] Index variable "${s}" must be a non-negative integer.`);return{kind:"index",index:o}}const r=S(s);if(r===-1)throw l(`[${t}]`);const a=s.slice(0,r).trim(),c=s.slice(r+1).trim();if(!a||!c)throw l(`[${t}]`);return i&&R(c,e)?{kind:"wildcard",indexed:!0}:{kind:"selector",key:a,value:E(c,e)}}function S(t){let e;for(let n=0;n<t.length;n++){const i=t[n];if(i==="\\"){n++;continue}if(e!==void 0){i===e&&(e=void 0);continue}if(i==='"'||i==="'")e=i;else if(i==="=")return n}return-1}function E(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 T(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 T(t){const e=t[0];if(t.length<2||t[t.length-1]!==e)throw l(t);if(e==='"')try{const i=JSON.parse(t);if(typeof i=="string")return i}catch{throw l(t)}let n="";for(let i=1;i<t.length-1;i++){const s=t[i];if(s==="\\"){if(i++,i>=t.length-1)throw l(t);n+=t[i]}else n+=s}return n}function P(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 i=String(n);if(!i||i.includes(".")||i.includes("[")||i.includes("]"))throw new TypeError(`[Raph] Key variable "${t}" contains path syntax.`);return i}function p(t,e){if(!h(t,e))throw new TypeError(`[Raph] Missing path variable "${t}".`);return e[t]}function h(t,e){return e!==void 0&&Object.hasOwn(e,t)}function R(t,e){for(const n of t.matchAll(/\$([A-Z_$][\w$]*)/gi))if(!h(n[1],e))return!0;return!1}function N(t){if(typeof t!="object"||t===null)throw k();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"&&O(e.pv))return{kind:"selector",key:e.pk,value:e.pv};throw k()}function O(t){return t===null||typeof t=="string"||typeof t=="boolean"||typeof t=="number"&&Number.isFinite(t)}function b(t){const e=t[t.length-1];return e?.kind==="wildcard"&&!e.indexed}function A(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 m(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}=${I(n.value)}]`:e+=n.indexed?"[*]":e?".*":"*";return e}function I(t){return typeof t=="string"?JSON.stringify(t):String(t)}function l(t){return new TypeError(`[Raph] Invalid data path "${t}".`)}function k(){return new TypeError("[Raph] Invalid plain DataPath representation.")}function w(t){return new TypeError(`[Raph] Wildcard is only allowed in watch masks: "${t}".`)}exports.DataPath=u;