@raphy-js/raph 1.0.0-dev.2

package/dist/debug/runtime/RaphScope.js

@@ -0,0 +1,64 @@
+var o = Object.defineProperty;
+var n = (e, s, t) => s in e ? o(e, s, { enumerable: !0, configurable: !0, writable: !0, value: t }) : e[s] = t;
+var h = (e, s, t) => n(e, typeof s != "symbol" ? s + "" : s, t);
+import { ScopeNode as p } from "../reactivity/scope.js";
+import { RaphDisposedError as u } from "./errors.js";
+class m extends p {
+  /**
+   * Создаёт lifecycle scope внутри указанного runtime.
+   */
+  constructor(t, i) {
+    super(i._getReactivity());
+    // Публикуют identity scope и единственного runtime-owner.
+    h(this, "id");
+    h(this, "runtime");
+    this.id = t, this.runtime = i, i._registerOwner(this);
+  }
+  /**
+   * Создаёт writable signal, принадлежащий указанному owner.
+   */
+  signal(t) {
+    return this._assertAlive(), this.runtime.signal(t, this);
+  }
+  computed(t) {
+    return this._assertAlive(), typeof t == "function" ? this.runtime.computed(t, this) : this.runtime.computed(t, this);
+  }
+  effect(t, i, r) {
+    return this._assertAlive(), typeof t == "string" ? this.runtime.effect(t, i, r, this) : this.runtime.effect(t, this);
+  }
+  /**
+   * Подписывает callback и привязывает disposer к lifecycle scope.
+   */
+  watch(t, i, r) {
+    return this._assertAlive(), this.runtime.watch(t, i, r, this);
+  }
+  /**
+   * Создаёт action, выполнение которой привязано к lifecycle scope.
+   */
+  action(t, i) {
+    return this._assertAlive(), this.runtime.action(t, i, this);
+  }
+  /**
+   * Выполняет runtime cleanup после освобождения scope.
+   */
+  _afterDispose() {
+    this.runtime._unregisterOwner(this);
+  }
+  /**
+   * Возвращает диагностическое сообщение для освобождённого scope.
+   */
+  _disposalMessage() {
+    return `[Raph] Scope "${this.id}" disposal failed.`;
+  }
+  /**
+   * Запрещает операции после начала освобождения scope.
+   * @internal
+   */
+  _assertAlive() {
+    if (this._disposed || this._disposing)
+      throw new u(`[Raph] Owner "${this.id}" is disposed.`);
+  }
+}
+export {
+  m as RaphScope
+};

package/dist/debug/runtime/RuntimeReactivity.cjs

@@ -0,0 +1 @@
+"use strict";var _=Object.defineProperty;var f=(u,e,i)=>e in u?_(u,e,{enumerable:!0,configurable:!0,writable:!0,value:i}):u[e]=i;var a=(u,e,i)=>f(u,typeof e!="symbol"?e+"":e,i);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("../reactivity/engine.cjs");let c;class o{constructor(){a(this,"_active")}bind(e){const i=this._active;if(i===void 0)return{schedule:e,dispose:b};const t=i.binding(e);if(i.initial==="scheduled")return t;let s=!0;return{dispose:t.dispose,schedule:()=>{if(!s){t.schedule();return}s=!1,e()}}}runWith(e,i,t){const s=this._active;this._active=e===void 0?void 0:{binding:e,initial:i};try{return t()}finally{this._active=s}}}class g extends p.RaphReactivity{constructor(i){const t=new o;super({effectScheduler:{bind:t.bind.bind(t)}});a(this,"_bindings");this._lifecycle=i,this._bindings=t}withEffectBinding(i,t,s){return this._bindings.runWith(i,t,s)}untrackedWithOwner(i){const t=c;c=void 0;try{return this.untracked(i)}finally{c=t}}getActiveOwner(){return c==null?void 0:c.owner}runWithOwner(i,t){const s=c;c=i;try{return t()}finally{c=s}}signalForOwner(i,t){const s=this._lifecycle,r=t===void 0?this.signal(i):t._adoptSource(this._ownedSignal(i)),v=s.assertWriteAllowed,h=s.runWrite??y;return v!==void 0?{get(){return l(s),t==null||t._assertAlive(),r.get()},peek(){return n(s),t==null||t._assertAlive(),r.peek()},set(d){t==null||t._assertAlive(),v(),h(()=>r.set(d))}}:{get(){return l(s),t==null||t._assertAlive(),r.get()},peek(){return n(s),t==null||t._assertAlive(),r.peek()},set(d){n(s),t==null||t._assertAlive(),h(()=>r.set(d))}}}computedForOwner(i,t){const s=this._lifecycle,r=t===void 0?this.computed(i):t._adoptSource(this._ownedComputed(i));return{get(){return l(s),t==null||t._assertAlive(),r.get()},peek(){return n(s),t==null||t._assertAlive(),r.peek()}}}}function n(u){u.owner===void 0&&u.throwDisposed()}function l(u){n(u);const e=c;e!==void 0&&e!==u&&u.throwCrossRuntime(e.owner)}function y(u){return u()}function b(){}exports.RuntimeReactivity=g;

package/dist/debug/runtime/RuntimeReactivity.js

@@ -0,0 +1,154 @@
+var p = Object.defineProperty;
+var _ = (c, e, i) => e in c ? p(c, e, { enumerable: !0, configurable: !0, writable: !0, value: i }) : c[e] = i;
+var a = (c, e, i) => _(c, typeof e != "symbol" ? e + "" : e, i);
+import { RaphReactivity as f } from "../reactivity/engine.js";
+let r;
+class o {
+  constructor() {
+    // Хранит binding только на время синхронной регистрации effect.
+    a(this, "_active");
+  }
+  /**
+   * Связывает effect с owner и phase только на время регистрации.
+   */
+  bind(e) {
+    const i = this._active;
+    if (i === void 0)
+      return { schedule: e, dispose: A };
+    const t = i.binding(e);
+    if (i.initial === "scheduled")
+      return t;
+    let s = !0;
+    return {
+      dispose: t.dispose,
+      schedule: () => {
+        if (!s) {
+          t.schedule();
+          return;
+        }
+        s = !1, e();
+      }
+    };
+  }
+  /**
+   * Выполняет операцию с текущим effect binding.
+   */
+  runWith(e, i, t) {
+    const s = this._active;
+    this._active = e === void 0 ? void 0 : { binding: e, initial: i };
+    try {
+      return t();
+    } finally {
+      this._active = s;
+    }
+  }
+}
+class y extends f {
+  /**
+   * Создаёт policy adapter реактивного графа для одного runtime.
+   */
+  constructor(i) {
+    const t = new o();
+    super({
+      effectScheduler: {
+        bind: t.bind.bind(t)
+      }
+    });
+    // Изолирует registration binding от алгоритмов базового reactive graph.
+    a(this, "_bindings");
+    this._lifecycle = i, this._bindings = t;
+  }
+  /**
+   * Создаёт временную registration boundary для runtime effect.
+   */
+  withEffectBinding(i, t, s) {
+    return this._bindings.runWith(i, t, s);
+  }
+  /**
+   * Выполняет untracked-операцию, сохраняя runtime owner context.
+   */
+  untrackedWithOwner(i) {
+    const t = r;
+    r = void 0;
+    try {
+      return this.untracked(i);
+    } finally {
+      r = t;
+    }
+  }
+  /**
+   * Возвращает owner текущего синхронного реактивного контекста.
+   */
+  getActiveOwner() {
+    return r == null ? void 0 : r.owner;
+  }
+  /**
+   * Выполняет операцию с указанным active owner.
+   */
+  runWithOwner(i, t) {
+    const s = r;
+    r = i;
+    try {
+      return t();
+    } finally {
+      r = s;
+    }
+  }
+  /**
+   * Создаёт owned signal с runtime lifecycle policy.
+   */
+  signalForOwner(i, t) {
+    const s = this._lifecycle, u = t === void 0 ? this.signal(i) : t._adoptSource(this._ownedSignal(i)), v = s.assertWriteAllowed, h = s.runWrite ?? g;
+    return v !== void 0 ? {
+      get() {
+        return l(s), t == null || t._assertAlive(), u.get();
+      },
+      peek() {
+        return n(s), t == null || t._assertAlive(), u.peek();
+      },
+      set(d) {
+        t == null || t._assertAlive(), v(), h(() => u.set(d));
+      }
+    } : {
+      get() {
+        return l(s), t == null || t._assertAlive(), u.get();
+      },
+      peek() {
+        return n(s), t == null || t._assertAlive(), u.peek();
+      },
+      set(d) {
+        n(s), t == null || t._assertAlive(), h(() => u.set(d));
+      }
+    };
+  }
+  /**
+   * Создаёт owned computed с runtime lifecycle policy.
+   */
+  computedForOwner(i, t) {
+    const s = this._lifecycle, u = t === void 0 ? this.computed(i) : t._adoptSource(this._ownedComputed(i));
+    return {
+      get() {
+        return l(s), t == null || t._assertAlive(), u.get();
+      },
+      peek() {
+        return n(s), t == null || t._assertAlive(), u.peek();
+      }
+    };
+  }
+}
+function n(c) {
+  c.owner === void 0 && c.throwDisposed();
+}
+function l(c) {
+  n(c);
+  const e = r;
+  e !== void 0 && e !== c && c.throwCrossRuntime(e.owner);
+}
+function g(c) {
+  return c();
+}
+function A() {
+}
+export {
+  y as RuntimeReactivity
+};

package/dist/debug/runtime/RuntimeWatch.cjs

@@ -0,0 +1 @@
+"use strict";var a=Object.defineProperty;var c=(i,t,e)=>t in i?a(i,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):i[t]=e;var p=(i,t,e)=>c(i,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class h{constructor(t){p(this,"_cleanup");p(this,"_stopped",!1);this._runUntracked=t}get stopped(){return this._stopped}deliver(t){const e=[],n=this._cleanup;if(this._cleanup=void 0,n!==void 0&&this._attempt(n,e),!this._stopped){let s=null;try{const r=this._runUntracked(t);typeof r=="function"&&(s=r)}catch(r){e.push(r)}s!==null&&(this._stopped?this._attempt(s,e):this._cleanup=s)}o(e)}stop(t){if(this._stopped)return;this._stopped=!0;const e=[];if(t!==void 0)try{t()}catch(s){e.push(s)}const n=this._cleanup;this._cleanup=void 0,n!==void 0&&this._attempt(n,e),o(e)}_attempt(t,e){try{this._runUntracked(t)}catch(n){e.push(n)}}}function o(i){if(i.length===1)throw i[0];if(i.length>1)throw new AggregateError(i,"[Raph] Runtime watch delivery failed.")}exports.RuntimeWatch=h;

package/dist/debug/runtime/RuntimeWatch.js

@@ -0,0 +1,71 @@
+var o = Object.defineProperty;
+var a = (i, t, e) => t in i ? o(i, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : i[t] = e;
+var p = (i, t, e) => a(i, typeof t != "symbol" ? t + "" : t, e);
+class u {
+  /**
+   * Создаёт runtime-owned watch с явным lifecycle остановки.
+   */
+  constructor(t) {
+    // Хранят cleanup последней доставки и окончательное состояние watcher.
+    p(this, "_cleanup");
+    p(this, "_stopped", !1);
+    this._runUntracked = t;
+  }
+  /**
+   * Показывает, остановлен ли watch.
+   */
+  get stopped() {
+    return this._stopped;
+  }
+  /**
+   * Освобождает предыдущий результат callback и выполняет новую доставку.
+   * Ошибка cleanup не лишает живой watcher текущего события.
+   */
+  deliver(t) {
+    const e = [], s = this._cleanup;
+    if (this._cleanup = void 0, s !== void 0 && this._attempt(s, e), !this._stopped) {
+      let n = null;
+      try {
+        const r = this._runUntracked(t);
+        typeof r == "function" && (n = r);
+      } catch (r) {
+        e.push(r);
+      }
+      n !== null && (this._stopped ? this._attempt(n, e) : this._cleanup = n);
+    }
+    h(e);
+  }
+  /**
+   * Останавливает внешнюю регистрацию и cleanup callback, сохраняя обе ошибки.
+   */
+  stop(t) {
+    if (this._stopped)
+      return;
+    this._stopped = !0;
+    const e = [];
+    if (t !== void 0)
+      try {
+        t();
+      } catch (n) {
+        e.push(n);
+      }
+    const s = this._cleanup;
+    this._cleanup = void 0, s !== void 0 && this._attempt(s, e), h(e);
+  }
+  _attempt(t, e) {
+    try {
+      this._runUntracked(t);
+    } catch (s) {
+      e.push(s);
+    }
+  }
+}
+function h(i) {
+  if (i.length === 1)
+    throw i[0];
+  if (i.length > 1)
+    throw new AggregateError(i, "[Raph] Runtime watch delivery failed.");
+}
+export {
+  u as RuntimeWatch
+};

package/dist/debug/runtime/disposal.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function o(t,e="[Raph] Multiple resource cleanup failures."){if(t.length===1)throw t[0];if(t.length>1)throw new AggregateError(t,e)}exports.throwDisposalErrors=o;

package/dist/debug/runtime/disposal.js

@@ -0,0 +1,9 @@
+function l(t, e = "[Raph] Multiple resource cleanup failures.") {
+  if (t.length === 1)
+    throw t[0];
+  if (t.length > 1)
+    throw new AggregateError(t, e);
+}
+export {
+  l as throwDisposalErrors
+};

package/dist/debug/runtime/errors.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../api/errors.cjs");class o extends r.RaphError{}class s extends r.RaphError{}class a extends r.RaphError{}exports.RaphActionError=o;exports.RaphCrossRuntimeError=a;exports.RaphDisposedError=s;

package/dist/debug/runtime/errors.js

@@ -0,0 +1,12 @@
+import { RaphError as r } from "../api/errors.js";
+class e extends r {
+}
+class a extends r {
+}
+class p extends r {
+}
+export {
+  e as RaphActionError,
+  p as RaphCrossRuntimeError,
+  a as RaphDisposedError
+};

package/dist/debug/runtime/parent-graph.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function t(){return{parentsOf(e){return e.parent===null?new Set:new Set([e.parent])}}}exports.parentGraph=t;

package/dist/debug/runtime/parent-graph.js

@@ -0,0 +1,10 @@
+function n() {
+  return {
+    parentsOf(e) {
+      return e.parent === null ? /* @__PURE__ */ new Set() : /* @__PURE__ */ new Set([e.parent]);
+    }
+  };
+}
+export {
+  n as parentGraph
+};

package/dist/debug/runtime/phase.types.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=Object.freeze({AnimationFrame:"animationFrame",Microtask:"microtask",Sync:"sync"});exports.RaphSchedulerType=e;

package/dist/debug/runtime/phase.types.js

@@ -0,0 +1,8 @@
+const e = Object.freeze({
+  AnimationFrame: "animationFrame",
+  Microtask: "microtask",
+  Sync: "sync"
+});
+export {
+  e as RaphSchedulerType
+};

package/dist/debug/runtime/public.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./errors.cjs"),r=require("./parent-graph.cjs"),t=require("./PathHandle.cjs"),p=require("./phase.types.cjs"),a=require("./RaphNode.cjs"),u=require("./RaphRuntime.cjs"),o=require("./RaphScope.cjs");exports.RaphActionError=e.RaphActionError;exports.RaphCrossRuntimeError=e.RaphCrossRuntimeError;exports.RaphDisposedError=e.RaphDisposedError;exports.parentGraph=r.parentGraph;exports.PathHandle=t.PathHandle;exports.RaphSchedulerType=p.RaphSchedulerType;exports.RaphNode=a.RaphNode;exports.RaphRuntime=u.RaphRuntime;exports.RaphScope=o.RaphScope;

package/dist/debug/runtime/public.js

@@ -0,0 +1,18 @@
+import { RaphActionError as p, RaphCrossRuntimeError as e, RaphDisposedError as t } from "./errors.js";
+import { parentGraph as h } from "./parent-graph.js";
+import { PathHandle as R } from "./PathHandle.js";
+import { RaphSchedulerType as x } from "./phase.types.js";
+import { RaphNode as d } from "./RaphNode.js";
+import { RaphRuntime as s } from "./RaphRuntime.js";
+import { RaphScope as u } from "./RaphScope.js";
+export {
+  R as PathHandle,
+  p as RaphActionError,
+  e as RaphCrossRuntimeError,
+  t as RaphDisposedError,
+  d as RaphNode,
+  s as RaphRuntime,
+  x as RaphSchedulerType,
+  u as RaphScope,
+  h as parentGraph
+};

package/dist/debug/runtime/runtime-reactivity.types.cjs

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

package/dist/debug/runtime/runtime-reactivity.types.js

@@ -0,0 +1 @@
+

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("./debug/path/data-adapter.cjs"),o=require("./debug/path/data-path.cjs"),r=require("./debug/path/derived-strategies.cjs"),t=require("./debug/path/RaphDerivedHandle.cjs"),h=require("./debug/path/RaphKernel.cjs"),u=require("./debug/path/RaphMeta.cjs"),a=require("./debug/runtime/errors.cjs"),i=require("./debug/runtime/parent-graph.cjs"),n=require("./debug/runtime/PathHandle.cjs"),R=require("./debug/runtime/phase.types.cjs"),d=require("./debug/runtime/RaphNode.cjs"),_=require("./debug/runtime/RaphRuntime.cjs"),s=require("./debug/runtime/RaphScope.cjs"),e=require("./debug/api/errors.cjs"),c=require("./debug/api/Raph.cjs");exports.DefaultDataAdapter=p.DefaultDataAdapter;exports.DataPath=o.DataPath;exports.collectionByKey=r.collectionByKey;exports.filterByKey=r.filterByKey;exports.full=r.full;exports.RaphDerivedHandle=t.RaphDerivedHandle;exports.RaphDerivedTargetWriteError=t.RaphDerivedTargetWriteError;exports.RaphKernel=h.RaphKernel;exports.RaphMeta=u.RaphMeta;exports.RaphActionError=a.RaphActionError;exports.RaphCrossRuntimeError=a.RaphCrossRuntimeError;exports.RaphDisposedError=a.RaphDisposedError;exports.parentGraph=i.parentGraph;exports.PathHandle=n.PathHandle;exports.RaphSchedulerType=R.RaphSchedulerType;exports.RaphNode=d.RaphNode;exports.RaphRuntime=_.RaphRuntime;exports.RaphScope=s.RaphScope;exports.RaphConfigurationError=e.RaphConfigurationError;exports.RaphDefaultRuntimeError=e.RaphDefaultRuntimeError;exports.RaphError=e.RaphError;exports.RaphModeError=e.RaphModeError;exports.Raph=c.Raph;

package/dist/index.js

@@ -0,0 +1,40 @@
+import { DefaultDataAdapter as e } from "./debug/path/data-adapter.js";
+import { DataPath as t } from "./debug/path/data-path.js";
+import { collectionByKey as f, filterByKey as h, full as R } from "./debug/path/derived-strategies.js";
+import { RaphDerivedHandle as x, RaphDerivedTargetWriteError as i } from "./debug/path/RaphDerivedHandle.js";
+import { RaphKernel as n } from "./debug/path/RaphKernel.js";
+import { RaphMeta as u } from "./debug/path/RaphMeta.js";
+import { RaphActionError as D, RaphCrossRuntimeError as c, RaphDisposedError as y } from "./debug/runtime/errors.js";
+import { parentGraph as K } from "./debug/runtime/parent-graph.js";
+import { PathHandle as v } from "./debug/runtime/PathHandle.js";
+import { RaphSchedulerType as B } from "./debug/runtime/phase.types.js";
+import { RaphNode as H } from "./debug/runtime/RaphNode.js";
+import { RaphRuntime as P } from "./debug/runtime/RaphRuntime.js";
+import { RaphScope as T } from "./debug/runtime/RaphScope.js";
+import { RaphConfigurationError as N, RaphDefaultRuntimeError as W, RaphError as b, RaphModeError as j } from "./debug/api/errors.js";
+import { Raph as q } from "./debug/api/Raph.js";
+export {
+  t as DataPath,
+  e as DefaultDataAdapter,
+  v as PathHandle,
+  q as Raph,
+  D as RaphActionError,
+  N as RaphConfigurationError,
+  c as RaphCrossRuntimeError,
+  W as RaphDefaultRuntimeError,
+  x as RaphDerivedHandle,
+  i as RaphDerivedTargetWriteError,
+  y as RaphDisposedError,
+  b as RaphError,
+  n as RaphKernel,
+  u as RaphMeta,
+  j as RaphModeError,
+  H as RaphNode,
+  P as RaphRuntime,
+  B as RaphSchedulerType,
+  T as RaphScope,
+  f as collectionByKey,
+  h as filterByKey,
+  R as full,
+  K as parentGraph
+};

package/dist/path/AdapterPathStore.d.ts

@@ -0,0 +1,45 @@
+import { DataAdapter } from './data-adapter';
+import { DataPathDef, PathOptions, PathWatchCallback } from './path.types';
+/**
+ * Связывает events и watchers только для Kernel поверх внешнего DataAdapter.
+ */
+export declare class AdapterPathStore {
+    private readonly _adapter;
+    private readonly _eventHub;
+    /**
+     * Связывает внешний DataAdapter с path events и watchers Kernel.
+     */
+    constructor(_adapter: DataAdapter);
+    /**
+     * Возвращает значение по пути без создания отсутствующих данных.
+     */
+    get<T = unknown>(path: DataPathDef, options?: PathOptions): T | undefined;
+    /**
+     * Читает значение по пути без регистрации реактивной зависимости.
+     */
+    peek<T = unknown>(path: DataPathDef, options?: PathOptions): T | undefined;
+    /**
+     * Проверяет наличие значения по указанному пути.
+     */
+    has(path: DataPathDef, options?: PathOptions): boolean;
+    /**
+     * Записывает значение и публикует соответствующее изменение.
+     */
+    set<T>(path: DataPathDef, value: T, options?: PathOptions): void;
+    /**
+     * Объединяет значение по пути и публикует соответствующее изменение.
+     */
+    merge(path: DataPathDef, value: unknown, options?: PathOptions): void;
+    /**
+     * Удаляет значение по пути и публикует изменение при наличии данных.
+     */
+    delete(path: DataPathDef, options?: PathOptions): void;
+    /**
+     * Выполняет операцию в общей синхронной transaction boundary.
+     */
+    transaction<T>(operation: () => T): T;
+    /**
+     * Подписывает callback на подходящие изменения и возвращает disposer.
+     */
+    watch(maskOrMasks: DataPathDef | readonly DataPathDef[], callback: PathWatchCallback): () => void;
+}

package/dist/path/DerivedRegistry.d.ts

@@ -0,0 +1,67 @@
+import { ParsedDataPath } from './data-path';
+import { CollectionDerivedState, DerivedCollectionKey } from './derived-collection';
+import { RaphDerivedHandle } from './RaphDerivedHandle';
+/**
+ * Владеет регистрациями, routes и pending-state materialized derived.
+ * Вычисление значений остаётся у Kernel, который координирует data-plane.
+ */
+export declare class DerivedRegistry {
+    private _router;
+    private _handles;
+    private _matches;
+    private _pending;
+    private _collections;
+    private _counter;
+    /**
+     * Возвращает число зарегистрированных записей.
+     */
+    get size(): number;
+    /**
+     * Возвращает очередь derived-вычислений, ожидающих стабилизации.
+     */
+    get pending(): Set<RaphDerivedHandle<any, any>> | undefined;
+    /**
+     * Выделяет следующий стабильный идентификатор registry.
+     */
+    nextId(): string;
+    /**
+     * Проверяет наличие derived handle с указанным id.
+     */
+    has(id: string): boolean;
+    /**
+     * Возвращает зарегистрированные derived handles.
+     */
+    values(): IterableIterator<RaphDerivedHandle<any, any>>;
+    /**
+     * Возвращает внутреннее состояние зарегистрированного handle.
+     */
+    state(handle: RaphDerivedHandle<any, any>): CollectionDerivedState | undefined;
+    /**
+     * Регистрирует derived handle и его зависимости.
+     */
+    register(handle: RaphDerivedHandle<any, any>, from: ParsedDataPath, strategy: {
+        readonly kind: 'collection-by-key' | 'filter-by-key';
+        readonly key: string;
+    } | undefined): void;
+    /**
+     * Удаляет регистрацию и связанные pending-записи.
+     */
+    remove(handle: RaphDerivedHandle<any, any>): void;
+    /**
+     * Добавляет derived handle в очередь пересчёта.
+     */
+    queue(path: ParsedDataPath): void;
+    /**
+     * Запоминает полную замену, которую нужно применить при стабилизации.
+     */
+    queueReplacement(path: ParsedDataPath, keys: ReadonlySet<DerivedCollectionKey>): void;
+    /**
+     * Сбрасывает pending-состояние после опустошения очереди.
+     */
+    clearPendingIfEmpty(): void;
+    /**
+     * Освобождает все handles и очищает derived registry.
+     */
+    dispose(): void;
+    private _matching;
+}

package/dist/path/MetaController.d.ts

@@ -0,0 +1,85 @@
+import { RaphMetaEvents, RaphMetaMutationCause, RaphMetaMutationEvent, RaphMetaWatchOptions, RaphMetaWriteOptions } from './meta.types';
+import { DataPathDef } from './path.types';
+import { RaphKernel } from './RaphKernel';
+import { DataPath } from './data-path';
+import { RaphMeta } from './RaphMeta';
+/**
+ * Владеет metadata storage, routing и пакетной публикацией.
+ * Kernel сообщает контроллеру только о lifecycle data-owner.
+ */
+export declare class MetaController {
+    private readonly _kernel;
+    private readonly _ownerExists;
+    private readonly _publicationDeferred;
+    private _facade;
+    private _store;
+    private _router;
+    private _pending;
+    private _publishing;
+    private _watcherCount;
+    private _deferredWatcherCount;
+    /**
+     * Создаёт lifecycle-контроллер metadata для одного Kernel.
+     */
+    constructor(_kernel: RaphKernel, _ownerExists: (path: DataPathDef) => boolean, _publicationDeferred: () => boolean);
+    /**
+     * Возвращает metadata facade, принадлежащий контроллеру.
+     */
+    get facade(): RaphMeta;
+    /**
+     * Возвращает число зарегистрированных записей.
+     */
+    get size(): number;
+    /**
+     * Показывает, есть ли активные синхронные metadata/path watchers.
+     */
+    get hasWatchers(): boolean;
+    /**
+     * Показывает, есть ли watchers с отложенной публикацией.
+     */
+    get hasDeferredWatchers(): boolean;
+    /**
+     * Возвращает значение по пути без создания отсутствующих данных.
+     */
+    get(path: DataPath, namespace?: string): unknown;
+    /**
+     * Проверяет наличие значения по указанному пути.
+     */
+    has(path: DataPath, namespace?: string): boolean;
+    /**
+     * Записывает значение и публикует соответствующее изменение.
+     */
+    set(path: DataPath, namespace: string, value: unknown, options?: RaphMetaWriteOptions): void;
+    /**
+     * Объединяет значение по пути и публикует соответствующее изменение.
+     */
+    merge(path: DataPath, namespace: string, value: unknown, options?: RaphMetaWriteOptions): void;
+    /**
+     * Удаляет значение по пути и публикует изменение при наличии данных.
+     */
+    delete(path: DataPath, namespace?: string, options?: RaphMetaWriteOptions): boolean;
+    /**
+     * Удаляет metadata всего поддерева указанного data-owner.
+     */
+    deleteSubtree(path: DataPath, cause: Extract<RaphMetaMutationCause, 'owner-delete' | 'owner-replaced'>): void;
+    /**
+     * Удаляет metadata, владельцы которой отсутствуют в data tree.
+     */
+    pruneMissing(path: DataPath, cause: Extract<RaphMetaMutationCause, 'owner-delete' | 'owner-replaced'>): void;
+    /**
+     * Подписывает callback на подходящие изменения и возвращает disposer.
+     */
+    watch(maskOrMasks: DataPathDef | readonly DataPathDef[], callback: (payload: RaphMetaEvents) => void, options?: RaphMetaWatchOptions, afterPublish?: (invalidate: boolean) => void): () => void;
+    /**
+     * Добавляет событие в текущую transaction либо публикует его сразу.
+     */
+    record(kind: RaphMetaMutationEvent['kind'], path: DataPath, namespace: string | null, cause: RaphMetaMutationCause, options?: RaphMetaWriteOptions): void;
+    /**
+     * Публикует накопленные metadata-события с учётом watcher mode.
+     */
+    publish(): void;
+    /**
+     * Очищает metadata storage, subscriptions и pending publication state.
+     */
+    dispose(): void;
+}