@reformer/core 11.0.0-beta.3 → 11.0.0-beta.4

package/dist/index.js

@@ -1,13 +1,14 @@
-import { a as G, c as ee } from "./form-model-DhW2HZOB.js";
-import { i as Ke, m as He, u as Ye } from "./form-model-DhW2HZOB.js";
-import { c as Je, a as Qe, r as Xe, b as Ze, d as et, e as tt, f as st, s as rt, t as it, w as nt } from "./behaviors-value-C7dSEhCc.js";
-import { S as L } from "./subscription-manager-705bls97.js";
+import { c as ee } from "./create-model-Dxh9cfLp.js";
+import { e as Ke } from "./create-model-Dxh9cfLp.js";
+import { a as G } from "./model-signals-proxy-mV3WGdlO.js";
+import { i as ze, m as Ye, u as Je } from "./model-signals-proxy-mV3WGdlO.js";
+import { c as Xe, a as Ze, r as et, b as tt, d as st, e as rt, f as it, s as nt, t as at, w as ot } from "./behaviors-value-C7dSEhCc.js";
 import { signal as g, computed as m, effect as _, batch as te, Signal as j } from "@preact/signals-core";
 import { r as se } from "./signal-node-registry-tiwel-TV.js";
-import { g as ot } from "./signal-node-registry-tiwel-TV.js";
-import { defineValidationSchema as re, createFormValidation as D, validateModel as ie, apply as ne } from "./validation.js";
-import Y, { useState as ae, useEffect as z, useRef as V, useCallback as E, useMemo as oe } from "react";
-import { d as ut, e as dt } from "./behaviors-node-DGEFMTQu.js";
+import { g as ut } from "./signal-node-registry-tiwel-TV.js";
+import { f as re, h as D, g as ie, d as ne } from "./strategy-DA3JwxsR.js";
+import { d as ct, e as ht } from "./node-DGEFMTQu.js";
+import z, { useRef as k, useCallback as E, useMemo as ae, useEffect as Y, useState as oe } from "react";
 class M {
   // ============================================================================
   // Protected состояние (для Template Method паттерна)
@@ -273,6 +274,174 @@ class M {
   onEnable() {
   }
 }
+class L {
+  /**
+   * Хранилище подписок
+   * Ключ: уникальный идентификатор подписки
+   * Значение: функция отписки (dispose)
+   */
+  subscriptions = /* @__PURE__ */ new Map();
+  /**
+   * Добавляет подписку
+   *
+   * Если подписка с таким ключом уже существует, отписывается от неё
+   * и заменяет новой. Это предотвращает утечки памяти при повторной
+   * регистрации подписки с тем же ключом.
+   *
+   * @param key Уникальный ключ подписки
+   * @param dispose Функция отписки (обычно возвращаемая из effect())
+   * @returns Функция для отписки от этой конкретной подписки
+   *
+   * @example
+   * ```typescript
+   * const manager = new SubscriptionManager();
+   *
+   * // Добавление подписки
+   * const unsubscribe = manager.add('mySubscription', () => {
+   *   console.log('Disposing subscription');
+   * });
+   *
+   * // Отписка через возвращаемую функцию
+   * unsubscribe();
+   *
+   * // Или через manager.remove()
+   * manager.add('anotherSub', disposeFn);
+   * manager.remove('anotherSub');
+   * ```
+   */
+  add(e, t) {
+    return this.subscriptions.has(e) && (process.env.NODE_ENV !== "production" && console.warn(`[SubscriptionManager] Subscription "${e}" already exists, replacing`), this.subscriptions.get(e)?.()), this.subscriptions.set(e, t), () => this.remove(e);
+  }
+  /**
+   * Удаляет подписку по ключу
+   *
+   * Вызывает функцию отписки и удаляет подписку из хранилища.
+   * Если подписка с таким ключом не найдена, ничего не делает.
+   *
+   * @param key Ключ подписки
+   * @returns true, если подписка была удалена, false если не найдена
+   *
+   * @example
+   * ```typescript
+   * const manager = new SubscriptionManager();
+   * manager.add('mySub', disposeFn);
+   *
+   * // Удаление подписки
+   * const removed = manager.remove('mySub'); // true
+   *
+   * // Попытка удалить несуществующую подписку
+   * const removed2 = manager.remove('nonExistent'); // false
+   * ```
+   */
+  remove(e) {
+    const t = this.subscriptions.get(e);
+    return t ? (t(), this.subscriptions.delete(e), !0) : !1;
+  }
+  /**
+   * Очищает все подписки
+   *
+   * Вызывает функции отписки для всех активных подписок
+   * и очищает хранилище. Обычно используется при dispose узла формы.
+   *
+   * @example
+   * ```typescript
+   * class FieldNode {
+   *   private subscriptions = new SubscriptionManager();
+   *
+   *   dispose() {
+   *     // Отписываемся от всех effect
+   *     this.subscriptions.clear();
+   *   }
+   * }
+   * ```
+   */
+  clear() {
+    this.subscriptions.forEach((e) => {
+      e();
+    }), this.subscriptions.clear();
+  }
+  /**
+   * Возвращает количество активных подписок
+   *
+   * Полезно для отладки утечек памяти. Если количество подписок
+   * растет без ограничений, это может указывать на то, что
+   * компоненты не отписываются должным образом.
+   *
+   * @returns Количество активных подписок
+   *
+   * @example
+   * ```typescript
+   * const manager = new SubscriptionManager();
+   * console.log(manager.size()); // 0
+   *
+   * manager.add('sub1', disposeFn1);
+   * manager.add('sub2', disposeFn2);
+   * console.log(manager.size()); // 2
+   *
+   * manager.clear();
+   * console.log(manager.size()); // 0
+   * ```
+   */
+  size() {
+    return this.subscriptions.size;
+  }
+  /**
+   * Проверяет, есть ли подписка с данным ключом
+   *
+   * @param key Ключ подписки
+   * @returns true, если подписка существует
+   *
+   * @example
+   * ```typescript
+   * const manager = new SubscriptionManager();
+   * manager.add('mySub', disposeFn);
+   *
+   * console.log(manager.has('mySub')); // true
+   * console.log(manager.has('nonExistent')); // false
+   * ```
+   */
+  has(e) {
+    return this.subscriptions.has(e);
+  }
+  /**
+   * Возвращает список всех ключей активных подписок
+   *
+   * Полезно для отладки: можно увидеть, какие подписки активны.
+   *
+   * @returns Массив ключей всех активных подписок
+   *
+   * @example
+   * ```typescript
+   * const manager = new SubscriptionManager();
+   * manager.add('watch-value', disposeFn1);
+   * manager.add('watch-errors', disposeFn2);
+   *
+   * console.log(manager.getKeys()); // ['watch-value', 'watch-errors']
+   * ```
+   */
+  getKeys() {
+    return Array.from(this.subscriptions.keys());
+  }
+  /**
+   * Отписывается от всех подписок (алиас для clear())
+   *
+   * Используется при dispose() узла формы для совместимости с ожидаемым API.
+   *
+   * @example
+   * ```typescript
+   * class FieldNode {
+   *   private subscriptions = new SubscriptionManager();
+   *
+   *   dispose() {
+   *     this.subscriptions.dispose();
+   *   }
+   * }
+   * ```
+   */
+  dispose() {
+    this.clear();
+  }
+}
 const O = {
   /** FieldNode.watch() */
   Watch: "watch",
@@ -284,11 +453,11 @@ const O = {
   WatchField: "watchField"
 };
 let le = 0;
-function F(s) {
+function N(s) {
   return `${s}-${++le}`;
 }
 var S = /* @__PURE__ */ ((s) => (s.THROW = "throw", s.LOG = "log", s.CONVERT = "convert", s))(S || {});
-class k {
+class V {
   static handle(e, t, r = "throw") {
     const i = this.extractMessage(e);
     switch (process.env.NODE_ENV !== "production" && console.error(`[${t}]`, e), r) {
@@ -712,7 +881,7 @@ class de extends M {
             } catch (u) {
               if (u instanceof DOMException && u.name === "AbortError")
                 throw u;
-              return k.handle(
+              return V.handle(
                 u,
                 "FieldNode AsyncValidator",
                 S.CONVERT
@@ -859,7 +1028,7 @@ class de extends M {
     const t = new AbortController(), r = _(() => {
       const n = this.value.value;
       e(n, t.signal);
-    }), i = F(O.Watch);
+    }), i = N(O.Watch);
     return this.disposers.add(i, () => {
       t.abort(), r();
     });
@@ -890,7 +1059,7 @@ class de extends M {
     const r = _(() => {
       const n = e.map((l) => l.value), a = t(...n);
       this.setValue(a, { emitEvent: !1 });
-    }), i = F(O.ComputeFrom);
+    }), i = N(O.ComputeFrom);
     return this.disposers.add(i, r);
   }
   /**
@@ -1411,7 +1580,7 @@ class A extends M {
     const a = _(() => {
       const d = i.value.value, u = r ? r(d) : d;
       n.setValue(u, { emitEvent: !1 });
-    }), l = F(O.LinkFields);
+    }), l = N(O.LinkFields);
     return this.disposers.add(l, a);
   }
   /**
@@ -1448,7 +1617,7 @@ class A extends M {
       throw new Error(`GroupNode.watchField: field "${e}" not found`);
     const i = _(() => {
       t(r.value.value);
-    }), n = F(O.WatchField);
+    }), n = N(O.WatchField);
     return this.disposers.add(n, i);
   }
   /**
@@ -1461,7 +1630,7 @@ class A extends M {
       throw new Error(`GroupNode.watchFieldByPath: field "${e}" not found`);
     const i = _(() => {
       t(r.value.value);
-    }), n = F(O.WatchField);
+    }), n = N(O.WatchField);
     return this.disposers.add(n, i);
   }
   /**
@@ -1561,7 +1730,7 @@ class W extends M {
    */
   removeAt(e) {
     if (e < 0 || e >= this.items.value.length) {
-      k.handle(
+      V.handle(
         new Error(
           `ArrayNode.removeAt: index ${e} out of bounds (length: ${this.items.value.length})`
         ),
@@ -1580,7 +1749,7 @@ class W extends M {
    */
   insert(e, t) {
     if (e < 0 || e > this.items.value.length) {
-      k.handle(
+      V.handle(
         new Error(
           `ArrayNode.insert: index ${e} out of bounds (length: ${this.items.value.length})`
         ),
@@ -1611,7 +1780,7 @@ class W extends M {
   move(e, t) {
     const r = this.items.value.length;
     if (e < 0 || e >= r || t < 0 || t >= r) {
-      k.handle(
+      V.handle(
         new Error(`ArrayNode.move: index out of bounds (from=${e}, to=${t}, length=${r})`),
         "ArrayNode.move",
         S.LOG
@@ -1639,7 +1808,7 @@ class W extends M {
   swap(e, t) {
     const r = this.items.value.length;
     if (e < 0 || e >= r || t < 0 || t >= r) {
-      k.handle(
+      V.handle(
         new Error(`ArrayNode.swap: index out of bounds (a=${e}, b=${t}, length=${r})`),
         "ArrayNode.swap",
         S.LOG
@@ -1680,7 +1849,7 @@ class W extends M {
   }
   setValue(e, t) {
     this.clear(), e.forEach((r) => this.push(r)), t?.emitEvent !== !1 && this.validate().catch((r) => {
-      k.handle(r, "ArrayNode.setValue", S.LOG);
+      V.handle(r, "ArrayNode.setValue", S.LOG);
     });
   }
   patchValue(e) {
@@ -2413,10 +2582,6 @@ function Ie(s) {
   }), r = be(e, s.validation), i = { model: e, form: t, ...r ? { validation: r } : {} };
   return s.setup?.(i), i;
 }
-function Le(s) {
-  const [e] = ae(s), t = e.validation?.controller;
-  return z(() => t?.start(), [t]), e;
-}
 function x(s) {
   return s == null ? !1 : typeof s == "object" && "value" in s && "setValue" in s && "getValue" in s && "validate" in s;
 }
@@ -2435,15 +2600,15 @@ function Se(s) {
   typeof s.push == "function" && // eslint-disable-next-line @typescript-eslint/no-explicit-any
   typeof s.removeAt == "function";
 }
-function Re(s) {
+function Le(s) {
   return Ee(s) ? "FieldNode" : _e(s) ? "GroupNode" : Se(s) ? "ArrayNode" : x(s) ? "FormNode" : "Unknown";
 }
-var N = { exports: {} }, P = {};
+var F = { exports: {} }, P = {};
 var q;
 function Ae() {
   if (q) return P;
   q = 1;
-  var s = Y;
+  var s = z;
   function e(o, f) {
     return o === f && (o !== 0 || 1 / o === 1 / f) || o !== o && f !== f;
   }
@@ -2530,16 +2695,16 @@ function we() {
       return v();
     }
     typeof __REACT_DEVTOOLS_GLOBAL_HOOK__ < "u" && typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart == "function" && __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart(Error());
-    var i = Y, n = typeof Object.is == "function" ? Object.is : s, a = i.useState, l = i.useEffect, d = i.useLayoutEffect, u = i.useDebugValue, h = !1, o = !1, f = typeof window > "u" || typeof window.document > "u" || typeof window.document.createElement > "u" ? r : e;
+    var i = z, n = typeof Object.is == "function" ? Object.is : s, a = i.useState, l = i.useEffect, d = i.useLayoutEffect, u = i.useDebugValue, h = !1, o = !1, f = typeof window > "u" || typeof window.document > "u" || typeof window.document.createElement > "u" ? r : e;
     T.useSyncExternalStore = i.useSyncExternalStore !== void 0 ? i.useSyncExternalStore : f, typeof __REACT_DEVTOOLS_GLOBAL_HOOK__ < "u" && typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStop == "function" && __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStop(Error());
   })()), T;
 }
 var H;
-function ke() {
-  return H || (H = 1, process.env.NODE_ENV === "production" ? N.exports = Ae() : N.exports = we()), N.exports;
+function Ve() {
+  return H || (H = 1, process.env.NODE_ENV === "production" ? F.exports = Ae() : F.exports = we()), F.exports;
 }
-var C = ke();
-function Ve(s, e) {
+var C = Ve();
+function ke(s, e) {
   if (s === e) return !0;
   if (s.length !== e.length) return !1;
   for (let t = 0; t < s.length; t++)
@@ -2547,11 +2712,11 @@ function Ve(s, e) {
   return !0;
 }
 function $(s, e, t, r) {
-  const i = V(null), n = V(s);
+  const i = k(null), n = k(s);
   n.current = s;
-  const a = V(e);
+  const a = k(e);
   a.current = e;
-  const l = V(t);
+  const l = k(t);
   if (l.current = t, i.current === null) {
     const h = {};
     for (const o in s)
@@ -2572,6 +2737,11 @@ function $(s, e, t, r) {
         h();
       });
     },
+    // subscriptionKey намеренно не читается в теле — он здесь КЛЮЧ ИДЕНТИЧНОСТИ подписки (см. JSDoc
+    // параметра). Убрать его (как предлагает автофикс) значит получить subscribe, созданный один раз
+    // навсегда: подмена контрола на другой узел перестанет пересоздавать effect. Тот же приём ниже
+    // у getSnapshot.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
     [r]
   ), u = E(() => {
     const h = i.current, o = n.current, f = {};
@@ -2581,7 +2751,7 @@ function $(s, e, t, r) {
     for (const v of a.current) {
       const { key: p, useShallowArrayEqual: b } = v, y = f[p], w = h[p];
       if (b) {
-        if (!Ve(w, y)) {
+        if (!ke(w, y)) {
           c = !0;
           break;
         }
@@ -2638,7 +2808,7 @@ function Oe(s) {
   );
   return $(e, t, r, s);
 }
-function Fe(s) {
+function Ne(s) {
   const e = {
     value: s.value,
     length: s.length,
@@ -2675,7 +2845,7 @@ function Fe(s) {
   );
   return $(e, t, r, s);
 }
-function Ne() {
+function Fe() {
   const s = E(
     () => ({
       value: [],
@@ -2692,12 +2862,12 @@ function Ne() {
   );
   return $({}, [], s);
 }
-function $e(s) {
+function Re(s) {
   const e = s && "length" in s && "map" in s;
-  return s ? e ? Fe(s) : Oe(s) : Ne();
+  return s ? e ? Ne(s) : Oe(s) : Fe();
 }
-function Ge(s) {
-  const e = V({ value: s.value.value }), t = E(
+function $e(s) {
+  const e = k({ value: s.value.value }), t = E(
     (i) => {
       let n = !0;
       return _(() => {
@@ -2715,8 +2885,8 @@ function Ge(s) {
   }, [s]);
   return C.useSyncExternalStore(t, r, r);
 }
-function je(s) {
-  const e = V({ length: s.length.value }), t = E(
+function Ge(s) {
+  const e = k({ length: s.length.value }), t = E(
     (i) => {
       let n = !0;
       return _(() => {
@@ -2734,12 +2904,12 @@ function je(s) {
   }, [s]);
   return C.useSyncExternalStore(t, r, r);
 }
-function Be(s) {
-  const { model: e, schema: t, strategy: r, debounce: i, liveAfterSubmit: n } = s, a = oe(
+function je(s) {
+  const { model: e, schema: t, strategy: r, debounce: i, liveAfterSubmit: n } = s, a = ae(
     () => D(e, t, { strategy: r, debounce: i, liveAfterSubmit: n }),
     [e, t, r, i, n]
   );
-  z(() => a.start(), [a]);
+  Y(() => a.start(), [a]);
   const l = C.useSyncExternalStore(
     E((u) => a.validating.subscribe(u), [a]),
     () => a.validating.peek(),
@@ -2748,13 +2918,17 @@ function Be(s) {
   ), d = E(() => a.validate(), [a]);
   return { submit: d, validate: d, isValidating: l };
 }
+function Be(s) {
+  const [e] = oe(s), t = e.validation?.controller;
+  return Y(() => t?.start(), [t]), e;
+}
 const Ue = Object.freeze({ runtime: "reformer-core", v: 1 });
 export {
   W as ArrayNode,
   Ue as CORE_RUNTIME_TOKEN,
   S as ErrorStrategy,
   de as FieldNode,
-  k as FormErrorHandler,
+  V as FormErrorHandler,
   M as FormNode,
   he as FormSubmitter,
   A as GroupNode,
@@ -2762,36 +2936,37 @@ export {
   ve as NodeFactory,
   L as SubscriptionManager,
   be as buildValidation,
-  Je as computeFrom,
-  Qe as copyFrom,
+  Xe as computeFrom,
+  Ze as copyFrom,
   Ie as createCoreForm,
   ye as createForm,
   Z as createFormFromModel,
   ee as createModel,
-  ut as disableWhen,
-  dt as enableWhen,
-  ot as getNodeForSignal,
-  Re as getNodeType,
+  ct as disableWhen,
+  Ke as eachLeafSignal,
+  ht as enableWhen,
+  ut as getNodeForSignal,
+  Le as getNodeType,
   Se as isArrayNode,
   G as isDerived,
   Ee as isFieldNode,
   x as isFormNode,
   _e as isGroupNode,
-  Ke as isModelContainerSignal,
-  He as markDerived,
+  ze as isModelContainerSignal,
+  Ye as markDerived,
   se as registerSignalNode,
-  Xe as resetWhen,
-  Ze as revalidateWhen,
-  et as runOutsideEffect,
-  tt as safeCallback,
-  st as safeDebouncedCallback,
-  rt as syncFields,
-  it as transformValue,
-  Ye as unmarkDerived,
-  je as useArrayLength,
-  Le as useFormBundle,
-  $e as useFormControl,
-  Ge as useFormControlValue,
-  Be as useFormValidation,
-  nt as watchField
+  et as resetWhen,
+  tt as revalidateWhen,
+  st as runOutsideEffect,
+  rt as safeCallback,
+  it as safeDebouncedCallback,
+  nt as syncFields,
+  at as transformValue,
+  Je as unmarkDerived,
+  Ge as useArrayLength,
+  Be as useFormBundle,
+  Re as useFormControl,
+  $e as useFormControlValue,
+  je as useFormValidation,
+  ot as watchField
 };

package/dist/{state/form-model.d.ts → model/create-model.d.ts}

@@ -1,18 +1,4 @@
 import { FormModel, PathAwareSignal } from './types';
-/**
- * Узел дерева `model.$` — контейнер (группа/массив), а не лист?
- *
- * Контейнерный узел структурно совместим с `ReadonlySignal` (`peek`/`value`/`subscribe`), поэтому
- * duck-typing «есть `peek` ⇒ это лист» на нём даёт ложное срабатывание. Этот guard — надёжный
- * способ различить: обходчикам дерева нужно спускаться в контейнер, а не читать его целиком.
- *
- * @group Model
- * @example
- * ```typescript
- * const isLeaf = (v: unknown) => isSignalLike(v) && !isModelContainerSignal(v);
- * ```
- */
-export declare function isModelContainerSignal(value: unknown): boolean;
 /**
  * Обойти ВСЕ листовые сигналы модели (включая элементы массивов), вызвав `visit` на каждом.
  *

package/dist/{state → model}/index.d.ts

@@ -1,32 +1,31 @@
 /**
- * `@reformer/core/state` — низкоуровневый реактивный **state-субстрат** (M1) и barrel модуля `state`.
+ * `@reformer/core/model` — низкоуровневый реактивный субстрат (M1) и barrel модуля `model`.
  *
  * Это «прокси-объект с сигналами» и инструментарий для построения доменных модулей поверх него
  * (form, table, …). Модуль СТРОГО реактивный: НИЧЕГО связанного с формами/валидацией/схемами здесь
- * нет — только модель, value-операции, producer-флаг и утилиты субстрата. Граница state⇏form
- * зафиксирована ESLint-правилом (`no-restricted-imports` на `src/state/**`).
+ * нет — только модель, value-операции, producer-флаг и утилиты субстрата. Граница model⇏form
+ * зафиксирована ESLint-правилом (`no-restricted-imports` на `src/model/**`).
  *
  * Реактивный рантайм (`signal/computed/effect/…`) живёт в отдельном subpath `@reformer/core/signals`
  * (единый владелец `@preact/signals-core`) — импортируй его оттуда; здесь он НЕ реэкспортируется,
  * чтобы зонтичный barrel `.` не разрастался рантаймом.
  *
- * Состав (реэкспорты — из тех же файлов, что использует зонтик `.`, поэтому `.` и `/state` — один
+ * Состав (реэкспорты — из тех же файлов, что использует зонтик `.`, поэтому `.` и `/model` — один
  * module-инстанс: общий `derived`-WeakMap, единая идентичность `Signal`):
  * - **модель** — `createModel` + типы `FormModel`/`ModelArray`/… + `PathAwareSignal`;
+ * - **обход листьев** — `eachLeafSignal` (подписка «любое поле изменилось»);
  * - **value-операции** (реактивные правила) — `computeFrom`/`copyFrom`/`watchField`/`transformValue`/
  *   `resetWhen`/`syncFields`/`revalidateWhen`;
  * - **producer-owned флаг** — `markDerived`/`isDerived`/`unmarkDerived`;
- * - **утилиты субстрата** — `runOutsideEffect`/`safeCallback`/`safeDebouncedCallback`,
- *   `SubscriptionManager`.
+ * - **утилиты субстрата** — `runOutsideEffect`/`safeCallback`/`safeDebouncedCallback`.
  *
- * @group State
- * @module state
+ * @group Model
+ * @module model
  */
-export { createModel } from './form-model';
+export { createModel, eachLeafSignal } from './create-model';
 export type { FormModel, ModelArray, ModelArraySignals, ModelGroupSignals, ModelObject, ModelValue, ModelSignals, ModelApi, PathAwareSignal, } from './types';
-export { isModelContainerSignal } from './form-model';
+export { isModelContainerSignal } from './model-signals-proxy';
 export { computeFrom, copyFrom, watchField, transformValue, resetWhen, syncFields, revalidateWhen, } from './behaviors-value';
 export type { BehaviorCleanup } from './behaviors-value';
 export { markDerived, isDerived, unmarkDerived } from './derived-registry';
 export { runOutsideEffect, safeCallback, safeDebouncedCallback } from './safe-effect';
-export { SubscriptionManager } from './subscription-manager';

package/dist/model/model-nodes.d.ts

@@ -0,0 +1,60 @@
+import { Signal } from '@preact/signals-core';
+import { PathAwareSignal } from './types';
+export declare const isIndexKey: (key: string) => boolean;
+export type ModelNode = LeafNode | GroupNode | ArrayNode;
+declare class LeafNode {
+    path: string;
+    readonly kind: "leaf";
+    readonly signal: PathAwareSignal<unknown>;
+    private initial;
+    constructor(initial: unknown, path: string);
+    rebase(path: string): void;
+    /** Реактивное чтение (внутри effect/computed создаёт зависимость). */
+    read(): unknown;
+    /** Нереактивный снимок. */
+    peek(): unknown;
+    set(value: unknown): void;
+    resetToInitial(): void;
+    captureInitial(): void;
+    dirty(): boolean;
+}
+export declare class GroupNode {
+    path: string;
+    readonly kind: "group";
+    readonly children: Map<string, ModelNode>;
+    constructor(initial: Record<string, unknown>, path: string);
+    rebase(path: string): void;
+    /** Реактивное чтение поддерева (внутри effect/computed подписывает на все листья группы). */
+    read(): Record<string, unknown>;
+    peek(): Record<string, unknown>;
+    set(value: unknown): void;
+    resetToInitial(): void;
+    captureInitial(): void;
+    dirty(): boolean;
+}
+export declare class ArrayNode {
+    path: string;
+    readonly kind: "array";
+    readonly items: Signal<ModelNode[]>;
+    private initial;
+    constructor(initial: unknown[], path: string);
+    rebase(path: string): void;
+    private reindex;
+    push(value: unknown): void;
+    insertAt(index: number, value: unknown): void;
+    removeAt(index: number): void;
+    move(from: number, to: number): void;
+    swap(a: number, b: number): void;
+    clear(): void;
+    /**
+     * Реактивное чтение массива. Читаем `items.value` (а не `.peek()`) — внутри effect/computed это
+     * подписка на СОСТАВ массива, поэтому push/removeAt/move ретригерят наравне с правкой элемента.
+     */
+    read(): unknown[];
+    peek(): unknown[];
+    set(value: unknown): void;
+    resetToInitial(): void;
+    captureInitial(): void;
+    dirty(): boolean;
+}
+export {};