@reformer/core 11.0.0-beta.8 → 11.0.0-beta.9

package/dist/loader-BWkigpVe.js

@@ -0,0 +1,52 @@
+import { e as p } from "./locale-CG54AU2Q.js";
+function u(t) {
+  const n = t.messages;
+  return n !== null && typeof n == "object";
+}
+function y(t) {
+  if (t != null) {
+    if (typeof t != "object" || Array.isArray(t))
+      throw new TypeError("источник локали вернул не объект");
+    return u(t) ? t : { messages: t };
+  }
+}
+function g(t) {
+  const n = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map(), r = (e) => {
+    const i = n.get(e);
+    if (i !== void 0) return Promise.resolve(i);
+    const c = o.get(e);
+    if (c !== void 0) return c;
+    const l = Promise.all(t.map(async (s) => y(await s(e)))).then((s) => {
+      let a = { code: e, messages: {} };
+      for (const f of s)
+        f !== void 0 && (a = p(a, f));
+      return a = { ...a, code: e }, n.set(e, a), a;
+    }).finally(() => {
+      o.delete(e);
+    });
+    return o.set(e, l), l;
+  };
+  return Object.assign(r, {
+    peek: (e) => n.get(e),
+    preload: r
+  });
+}
+function h(t, n) {
+  return async (o) => {
+    const r = t(o), e = await fetch(r, n);
+    if (!e.ok)
+      throw new Error(`локаль «${o}»: ${r} ответил ${e.status}`);
+    return await e.json();
+  };
+}
+function d(t) {
+  return (n) => {
+    const o = n.split("-")[0].toLowerCase(), e = (Object.prototype.hasOwnProperty.call(t, n) ? t[n] : void 0) ?? (Object.prototype.hasOwnProperty.call(t, o) ? t[o] : void 0);
+    return e === void 0 ? null : e();
+  };
+}
+export {
+  d as b,
+  g as c,
+  h as f
+};

package/dist/locale/en.js

@@ -1,4 +1,4 @@
-import { m as e } from "../en-CjAqn7h0.js";
+import { m as e } from "../en-HP8XEych.js";
 const o = { code: "en", weekStartsOn: 0, messages: e };
 export {
   o as en

package/dist/locale/en.json

@@ -17,6 +17,8 @@
     "validation.max": "Must be at most {max}",
     "validation.minLength": "Enter at least {minLength, plural, one{# character} other{# characters}}",
     "validation.maxLength": "Enter no more than {maxLength, plural, one{# character} other{# characters}}",
+    "validation.minItems": "At least {minLength, plural, one{# item} other{# items}}",
+    "validation.maxItems": "No more than {maxLength, plural, one{# item} other{# items}}",
     "validation.isNumber": "Enter a number",
     "validation.integer": "Enter a whole number",
     "validation.multipleOf": "Must be a multiple of {multipleOf}",
@@ -37,6 +39,7 @@
     "validation.maxTotalFileSize": "The total size of the files exceeds {maxTotalFileSize}",
     "validation.fileExists": "File {fileName} has already been added",
     "validation.uploadAborted": "Upload cancelled",
-    "validation.uploadFailed": "Failed to upload {fileName}"
+    "validation.uploadFailed": "Failed to upload {fileName}",
+    "validation.ruleFailed": "Could not check this field. Try again"
   }
 }

package/dist/locale/ru.js

@@ -14,6 +14,8 @@ const a = {
   "validation.max": "Не больше {max}",
   "validation.minLength": "Не меньше {minLength, plural, one{# символа} few{# символов} many{# символов} other{# символа}}",
   "validation.maxLength": "Не больше {maxLength, plural, one{# символа} few{# символов} many{# символов} other{# символа}}",
+  "validation.minItems": "Не меньше {minLength, plural, one{# элемента} few{# элементов} many{# элементов} other{# элемента}}",
+  "validation.maxItems": "Не больше {maxLength, plural, one{# элемента} few{# элементов} many{# элементов} other{# элемента}}",
   "validation.isNumber": "Введите число",
   "validation.integer": "Введите целое число",
   "validation.multipleOf": "Число должно быть кратно {multipleOf}",
@@ -34,7 +36,8 @@ const a = {
   "validation.maxTotalFileSize": "Суммарный размер файлов больше {maxTotalFileSize}",
   "validation.fileExists": "Файл {fileName} уже добавлен",
   "validation.uploadAborted": "Загрузка прервана",
-  "validation.uploadFailed": "Не удалось загрузить файл {fileName}"
+  "validation.uploadFailed": "Не удалось загрузить файл {fileName}",
+  "validation.ruleFailed": "Не удалось проверить поле. Повторите попытку"
 }, i = a, e = { code: "ru", weekStartsOn: 1, messages: i };
 export {
   e as ru

package/dist/locale/ru.json

@@ -17,6 +17,8 @@
     "validation.max": "Не больше {max}",
     "validation.minLength": "Не меньше {minLength, plural, one{# символа} few{# символов} many{# символов} other{# символа}}",
     "validation.maxLength": "Не больше {maxLength, plural, one{# символа} few{# символов} many{# символов} other{# символа}}",
+    "validation.minItems": "Не меньше {minLength, plural, one{# элемента} few{# элементов} many{# элементов} other{# элемента}}",
+    "validation.maxItems": "Не больше {maxLength, plural, one{# элемента} few{# элементов} many{# элементов} other{# элемента}}",
     "validation.isNumber": "Введите число",
     "validation.integer": "Введите целое число",
     "validation.multipleOf": "Число должно быть кратно {multipleOf}",
@@ -37,6 +39,7 @@
     "validation.maxTotalFileSize": "Суммарный размер файлов больше {maxTotalFileSize}",
     "validation.fileExists": "Файл {fileName} уже добавлен",
     "validation.uploadAborted": "Загрузка прервана",
-    "validation.uploadFailed": "Не удалось загрузить файл {fileName}"
+    "validation.uploadFailed": "Не удалось загрузить файл {fileName}",
+    "validation.ruleFailed": "Не удалось проверить поле. Повторите попытку"
   }
 }

package/dist/locale-CG54AU2Q.js

@@ -0,0 +1,219 @@
+class v extends Error {
+  name = "MessageSyntaxError";
+}
+const O = (t) => `⟦${t}⟧`, w = 100, L = new RegExp("\\p{Pattern_White_Space}", "u"), _ = /[\p{White_Space}\p{Pattern_Syntax}]/u, $ = /* @__PURE__ */ new Map(), y = /* @__PURE__ */ new Map(), x = /* @__PURE__ */ new Map();
+function E(t) {
+  let e = x.get(t);
+  if (e === void 0) {
+    try {
+      Intl.getCanonicalLocales(t), e = t;
+    } catch {
+      e = "en", process.env.NODE_ENV !== "production" && console.warn(
+        `[@reformer/core/i18n] код языка «${t}» не BCP 47 — числа, даты и формы слов форматируются по en.`
+      );
+    }
+    x.set(t, e);
+  }
+  return e;
+}
+function M(t) {
+  try {
+    return String(t);
+  } catch {
+    return "";
+  }
+}
+function b(t) {
+  let e = 0, n = 0;
+  const r = (s) => {
+    throw new v(`${s} (позиция ${e}) в сообщении: ${t}`);
+  }, i = (s, o) => s === "{" || s === "}" || s === "<" || s === ">" || o && s === "#", l = () => {
+    for (; e < t.length && L.test(t[e]); ) e++;
+  }, m = () => {
+    const s = e;
+    for (; e < t.length && !_.test(t[e]); ) e++;
+    return e === s && r("ожидалось имя"), t.slice(s, e);
+  }, p = (s) => {
+    if (s !== "plural" || t[e] !== "=") return m();
+    const o = e++;
+    (t[e] === "+" || t[e] === "-") && e++;
+    const f = e;
+    for (; e < t.length && t[e] >= "0" && t[e] <= "9"; ) e++;
+    return (e === f || !Number.isSafeInteger(Number(t.slice(f, e)))) && r("после «=» ожидалось целое число"), t.slice(o, e);
+  }, c = (s) => {
+    if (e++, t[e] === "'")
+      return e++, "'";
+    if (!i(t[e], s)) return "'";
+    let o = "";
+    for (; e < t.length; )
+      if (t[e] !== "'") o += t[e++];
+      else if (t[e + 1] === "'")
+        o += "'", e += 2;
+      else
+        return e++, o;
+    return o;
+  }, a = (s, o) => {
+    const f = [];
+    let h = "";
+    const g = () => {
+      h !== "" && (f.push({ kind: "text", value: h }), h = "");
+    };
+    for (; e < t.length; ) {
+      const d = t[e];
+      if (d === "}") {
+        s || r("непарная «}» — литерал пишется как '}'");
+        break;
+      }
+      d === "'" ? h += c(o !== null) : d === "#" && o !== null ? (e++, g(), f.push({ kind: "number", name: o })) : d === "{" ? (g(), f.push(N())) : (h += d, e++);
+    }
+    return g(), f;
+  }, u = (s, o, f) => {
+    const h = /* @__PURE__ */ new Map();
+    for (l(); e < t.length && t[e] !== "}"; ) {
+      const g = p(o);
+      h.has(g) && r(`ветка «${g}» в «${s}, ${o}» повторяется`), l(), t[e] !== "{" && r(`ожидалась «{» после ветки «${g}»`), e++, h.set(g, a(!0, f)), t[e] !== "}" && r(`ветка «${g}» не закрыта`), e++, l();
+    }
+    return t[e] !== "}" && r(`«${s}, ${o}» не закрыт «}»`), e++, h.has("other") || r(`в «${s}, ${o}» нет обязательной ветки other`), h;
+  }, N = () => {
+    n === w && r(`вложенность аргументов глубже ${w} уровней`), n++, e++, l();
+    const s = m();
+    l();
+    let o;
+    if (t[e] === "}")
+      e++, o = { kind: "arg", name: s };
+    else {
+      t[e] !== "," && r(`ожидались «,» или «}» после аргумента «${s}»`), e++, l();
+      const f = m();
+      f !== "plural" && f !== "select" && r(`неизвестный тип «${f}» у «${s}» — поддерживаются plural и select`), l(), t[e] !== "," && r(`ожидалась «,» после «${f}»`), e++, o = {
+        kind: f,
+        name: s,
+        branches: u(s, f, f === "plural" ? s : null)
+      };
+    }
+    return n--, o;
+  };
+  return a(!1, null);
+}
+function j(t, e, n, r = {}) {
+  const i = r.onMissingArgument ?? O, l = (p) => {
+    const c = e[p];
+    return typeof c == "number" && Number.isFinite(c) ? c : null;
+  }, m = (p) => {
+    let c = "";
+    for (const a of p)
+      if (a.kind === "text") c += a.value;
+      else if (a.kind === "arg")
+        c += e[a.name] === void 0 ? i(a.name) : M(e[a.name]);
+      else if (a.kind === "number") {
+        const u = l(a.name);
+        c += u === null ? i(a.name) : A(n).format(u);
+      } else if (a.kind === "plural") {
+        const u = l(a.name);
+        c += u === null ? i(a.name) : m(
+          a.branches.get(`=${u}`) ?? a.branches.get(P(n).select(u)) ?? a.branches.get("other")
+        );
+      } else {
+        const u = e[a.name];
+        c += u === void 0 ? i(a.name) : m(a.branches.get(M(u)) ?? a.branches.get("other"));
+      }
+    return c;
+  };
+  return m(t);
+}
+function P(t) {
+  let e = $.get(t);
+  return e === void 0 && $.set(t, e = new Intl.PluralRules(E(t))), e;
+}
+function A(t) {
+  let e = y.get(t);
+  return e === void 0 && y.set(t, e = new Intl.NumberFormat(E(t))), e;
+}
+function F(t, e = {}) {
+  const n = /* @__PURE__ */ new Map();
+  return (r, i = {}) => {
+    let l = n.get(r);
+    return l === void 0 && n.set(r, l = b(r)), j(l, i, t, e);
+  };
+}
+const I = Object.freeze({
+  code: "en",
+  messages: Object.freeze({})
+});
+function C(t, e) {
+  const { messages: n, ...r } = e;
+  return {
+    ...t,
+    ...r,
+    messages: n === void 0 ? t.messages : { ...t.messages, ...n }
+  };
+}
+function S(t, e) {
+  return Object.prototype.hasOwnProperty.call(t, e);
+}
+function k(t, e = /* @__PURE__ */ new Set()) {
+  for (const n of t)
+    if (n.kind !== "text" && (e.add(n.name), n.kind === "plural" || n.kind === "select"))
+      for (const r of n.branches.values()) k(r, e);
+  return e;
+}
+function D(t, e) {
+  const n = [], r = /* @__PURE__ */ new Map();
+  for (const [i, l] of Object.entries(t)) {
+    if (typeof l != "string") {
+      n.push({ key: i, kind: "syntax", message: "сообщение не является строкой" });
+      continue;
+    }
+    try {
+      r.set(i, b(l));
+    } catch (m) {
+      n.push({
+        key: i,
+        kind: "syntax",
+        message: m instanceof Error ? m.message : String(m)
+      });
+    }
+  }
+  if (e === void 0) return n;
+  for (const i of Object.keys(t))
+    S(e, i) || n.push({ key: i, kind: "extra", message: "ключа нет в образце" });
+  for (const [i, l] of Object.entries(e)) {
+    if (!S(t, i)) {
+      n.push({ key: i, kind: "missing", message: "ключ есть в образце, но не переведён" });
+      continue;
+    }
+    const m = r.get(i);
+    if (m === void 0) continue;
+    let p;
+    try {
+      if (typeof l != "string") throw new TypeError("сообщение не является строкой");
+      p = b(l);
+    } catch (u) {
+      n.push({
+        key: i,
+        kind: "syntax",
+        message: `в образце: ${u instanceof Error ? u.message : String(u)}`
+      });
+      continue;
+    }
+    const c = [...k(p)].sort().join(", "), a = [...k(m)].sort().join(", ");
+    c !== a && n.push({
+      key: i,
+      kind: "arguments",
+      message: `образец ждёт {${c}}, словарь — {${a}}`
+    });
+  }
+  return n;
+}
+export {
+  I as D,
+  v as M,
+  F as c,
+  C as e,
+  j as f,
+  S as h,
+  E as i,
+  k as m,
+  b as p,
+  M as t,
+  D as v
+};

package/dist/locale.js

@@ -1,4 +1,4 @@
-import { b as e } from "./loader-Dv_Hl7JC.js";
+import { b as e } from "./loader-BWkigpVe.js";
 const n = ["en", "ru"], t = e({
   en: () => import("./locale/en.js").then((o) => o.en),
   ru: () => import("./locale/ru.js").then((o) => o.ru)

package/dist/model/behaviors-value.d.ts

@@ -4,6 +4,12 @@ export type BehaviorCleanup = () => void;
 /**
  * Вычисляемое поле: `target = fn(...sourceValues)` при изменении источников.
  *
+ * Примитив модели: цель вычисляемой НЕ помечает. Поэтому массовая запись (`model.set`,
+ * `model.patch`, `model.reset`) её перезаписывает, а `isDirty()` её учитывает — до следующей смены
+ * источников. Оператор поведения `computeFrom` из `@reformer/core/behaviors` цель помечает
+ * (`markDerived`) и защищён от циклов: массовая запись такую цель не трогает. В поведении формы
+ * нужен оператор; примитив — для модели без формы.
+ *
  * @group Model
  * @param sources Сигналы-источники (`model.$.a`, `model.$.b`).
  * @param target Сигнал-цель (`model.$.total`).
@@ -16,7 +22,7 @@ export type BehaviorCleanup = () => void;
  * computeFrom([model.$.price, model.$.qty], model.$.total, (price, qty) => price * qty);
  * ```
  */
-export declare function computeFrom<R>(sources: ReadonlySignal<any>[], target: Signal<R>, fn: (...values: any[]) => R, options?: {
+export declare function computeFrom<R>(sources: ReadonlySignal<any>[], target: Signal<R>, fn: (...values: any[]) => NoInfer<R>, options?: {
     when?: (...values: any[]) => boolean;
 }): BehaviorCleanup;
 /**
@@ -59,6 +65,18 @@ export declare function watchField<T>(source: ReadonlySignal<T>, cb: (value: T)
  * ```
  */
 export declare function transformValue<T>(target: Signal<T>, transformer: (value: T) => T): BehaviorCleanup;
+/**
+ * Опции {@link resetWhen}. Без `resetValue` поле сбрасывается в `null`, поэтому `resetValue`
+ * обязателен, если `null` не входит в тип поля: `resetWhen(model.$.promoCode, cond)` для поля
+ * `string` не компилируется — нужно `{ resetValue: '' }`.
+ *
+ * @group Behaviors
+ */
+export type ResetWhenOptionsArg<T> = null extends T ? [options?: {
+    resetValue?: NoInfer<T>;
+}] : [options: {
+    resetValue: NoInfer<T>;
+}];
 /**
  * Сброс значения поля к `resetValue` (по умолчанию `null`), когда `condition` истинно.
  *
@@ -68,12 +86,12 @@ export declare function transformValue<T>(target: Signal<T>, transformer: (value
  * resetWhen(model.$.cardNumber, () => model.paymentType !== 'card', { resetValue: '' });
  * ```
  */
-export declare function resetWhen<T>(target: Signal<T>, condition: () => boolean, options?: {
-    resetValue?: T;
-}): BehaviorCleanup;
+export declare function resetWhen<T>(target: Signal<T>, condition: () => boolean, ...[options]: ResetWhenOptionsArg<T>): BehaviorCleanup;
 /**
  * Двусторонняя синхронизация двух полей (опционально с трансформом `a → b`).
- * Сходимость обеспечивается peek-guard'ом; флаг предотвращает лишние круги.
+ * Сходимость обеспечивается peek-guard'ом; флаг предотвращает лишние круги. При создании источник —
+ * `a`: `b` получает его значение (через `transform`), обратной записи при создании нет. Записи в
+ * оба поля в одном тике — побеждает последняя.
  *
  * @group Model
  * @example
@@ -81,7 +99,7 @@ export declare function resetWhen<T>(target: Signal<T>, condition: () => boolean
  * syncFields(model.$.field1, model.$.field2);
  * ```
  */
-export declare function syncFields<T>(a: Signal<T>, b: Signal<T>, options?: {
+export declare function syncFields<T>(a: Signal<T>, b: Signal<NoInfer<T>>, options?: {
     transform?: (value: T) => T;
 }): BehaviorCleanup;
 /**

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

@@ -16,7 +16,7 @@ export declare function eachLeafSignal<T>(model: FormModel<T>, visit: (signal: P
  * Обойти ВСЕ ручки значений модели: листья (включая элементы массивов) И сами массивы.
  *
  * Отличие от {@link eachLeafSignal} — узлы-массивы: массив бывает одним значением поля
- * (`{ value: model.$.tags, component }`), и нода такого поля привязана к сигналу массива, а не
+ * (`{ model: model.$.tags, component }`), и нода такого поля привязана к сигналу массива, а не
  * к сигналам элементов. Обходчику, которому нужна именно НОДА поля (стратегия `blur` подписывается
  * на её `touched`), одних листьев мало — он не увидел бы мультивыбор. Так строятся триггеры
  * `change`/`blur` стратегий валидации (см. `createFormValidation`).
@@ -25,7 +25,7 @@ export declare function eachLeafSignal<T>(model: FormModel<T>, visit: (signal: P
  */
 export declare function eachValueSignal<T>(model: FormModel<T>, visit: (signal: PathAwareSignal<unknown>) => void): void;
 /**
- * Создать реактивную модель данных формы (слой M1).
+ * Создать реактивную модель данных формы.
  *
  * @group Model
  * @param initial Начальные значения (объект). Определяют форму данных и initial-снимок.

package/dist/model/derived-registry.d.ts

@@ -3,7 +3,7 @@ import { Signal } from '@preact/signals-core';
  * Пометить сигнал производным (вычисляемым).
  *
  * Вызывается операторами {@link computeFrom}/`compute` для их сигнала-цели. После этого
- * bulk-сеттеры (`model.set`/`model.patch`, `patchValue`/`setValue`) пропускают это поле, чтобы
+ * bulk-сеттеры (`model.set`/`model.patch`, `setValue` группы формы) пропускают это поле, чтобы
  * значение из payload не затирало вычисляемое. Прикладной код напрямую обычно не вызывает.
  *
  * Идемпотентна на уровне флага: повторные вызовы наращивают счётчик ссылок, чтобы каждый оператор,

package/dist/model/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * `@reformer/core/model` — низкоуровневый реактивный субстрат (M1) и barrel модуля `model`.
+ * `@reformer/core/model` — низкоуровневый реактивный субстрат и barrel модуля `model`.
  *
  * Это «прокси-объект с сигналами» и инструментарий для построения доменных модулей поверх него
  * (form, table, …). Модуль СТРОГО реактивный: НИЧЕГО связанного с формами/валидацией/схемами здесь
@@ -19,18 +19,24 @@
  * - **value-операции** (реактивные правила) — `computeFrom`/`copyFrom`/`watchField`/`transformValue`/
  *   `resetWhen`/`syncFields`/`revalidateWhen`;
  * - **producer-owned флаг** — `markDerived`/`isDerived`/`unmarkDerived`;
- * - **утилиты субстрата** — `runOutsideEffect`/`safeCallback`/`safeDebouncedCallback`.
+ * - **утилиты субстрата** — `runOutsideEffect`/`safeCallback`/`safeDebouncedCallback` и
+ *   `deferredWritesSettled` (дождаться отложенных записей текущего тика);
+ * - **сравнение значений** — `deepEqual`, на нём стоят `isDirty` и сверка «модель изменилась».
+ *
+ * Запасной шаблон элемента массива модель принимает от того, кто строит её извне (сборка формы
+ * передаёт `initialValue` узла-массива); что это узел схемы, модель не знает.
  *
  * @group Model
  * @module model
  */
 export { createModel, eachLeafSignal, eachValueSignal } from './create-model';
 export { arrayOf } from './model-nodes';
-export type { FormModel, ModelArray, ModelArraySignals, ModelGroupSignals, ModelObject, ModelValue, ModelSignals, ModelApi, PathAwareSignal, } from './types';
+export type { DeepPartial, FormModel, ModelArray, ModelArraySignals, ModelGroupSignals, ModelObject, ModelValue, ModelSignals, ModelApi, PathAwareSignal, } from './types';
 export { isModelContainerSignal, isValueSignal } from './model-signals-proxy';
 export { modelOf } from './model-value-proxy';
 export type { ModelOf } from './model-value-proxy';
 export { computeFrom, copyFrom, watchField, transformValue, resetWhen, syncFields, revalidateWhen, } from './behaviors-value';
-export type { BehaviorCleanup } from './behaviors-value';
+export type { BehaviorCleanup, ResetWhenOptionsArg } from './behaviors-value';
 export { markDerived, isDerived, unmarkDerived } from './derived-registry';
-export { runOutsideEffect, safeCallback, safeDebouncedCallback } from './safe-effect';
+export { runOutsideEffect, safeCallback, safeDebouncedCallback, deferredWritesSettled, } from './safe-effect';
+export { deepEqual } from './model-nodes';

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

@@ -1,6 +1,19 @@
 import { Signal } from '@preact/signals-core';
 import { PathAwareSignal } from './types';
 export declare const isIndexKey: (key: string) => boolean;
+/**
+ * Глубокое сравнение значений модели: объекты и массивы — по содержимому, даты — по времени,
+ * `NaN` равен себе, остальное (включая файлы) — по ссылке.
+ *
+ * То же сравнение стоит за `isDirty` модели и за сверкой «модель изменилась, пока шла проверка»
+ * при отправке и переходе шага: значение, изменённое и возвращённое, изменением не считается.
+ *
+ * @example
+ * ```typescript
+ * deepEqual({ date: new Date(0), tags: ['a'] }, { date: new Date(0), tags: ['a'] }); // true
+ * ```
+ */
+export declare const deepEqual: (a: unknown, b: unknown) => boolean;
 /** Фабрика нового элемента массива. */
 type Blank = () => unknown;
 /**
@@ -12,7 +25,8 @@ type Shape = () => unknown;
  * Массив модели с шаблоном нового элемента.
  *
  * Шаблон — фабрика значения, которое получает `push()` / `insertAt(i)` без аргумента: кнопка
- * «Добавить» секции массива, `model.items.push()` в поведении. Объявляется там же, где остальные
+ * «Добавить» секции массива, `model.items.push()` в поведении. Частичное значение
+ * (`push({ type: 'house' })`) дополняется из шаблона. Объявляется там же, где остальные
  * начальные значения, — в модели; схеме и JSX знать его не нужно.
  *
  * Возвращает обычный массив: тип поля остаётся `U[]`. Шаблон переживает `set` / `patch` / `reset`
@@ -39,14 +53,18 @@ type Shape = () => unknown;
  *
  * model.coBorrowers.push(); // { name: '', phones: [] }
  * model.coBorrowers.at(0).phones.push(); // { number: '' }
- * model.coBorrowers.push({ name: 'Анна', phones: [] }); // значение целиком — как раньше
+ * model.coBorrowers.push({ name: 'Анна' }); // { name: 'Анна', phones: [] } — остальное из шаблона
  * ```
  *
  * @group Model
  */
 export declare function arrayOf<U>(blank: () => U, items?: readonly U[]): U[];
-export type ModelNode = LeafNode | GroupNode | ArrayNode;
-declare class LeafNode {
+export type ModelNode = ModelLeafNode | ModelGroupNode | ModelArrayNode;
+/** Лист модели, чей это сигнал; `undefined` — сигнал не из модели. @internal */
+export declare function leafOfSignal(handle: object): {
+    reference(): unknown;
+} | undefined;
+declare class ModelLeafNode {
     path: string;
     readonly kind: "leaf";
     readonly signal: PathAwareSignal<unknown>;
@@ -58,29 +76,63 @@ declare class LeafNode {
     /** Нереактивный снимок. */
     peek(): unknown;
     set(value: unknown): void;
+    /**
+     * Вернуть значение к снимку. Производное поле (цель `compute`, поле сервера с `markDerived`)
+     * сброс не пишет — как `set` и `patch`: значением владеет поведение, а снимок такого поля снят
+     * до первого расчёта, и `compute` пересчитал бы его только при смене источников.
+     */
     resetToInitial(): void;
     captureInitial(): void;
+    /** Значение точки отсчёта — копия: правка полученного снимок не трогает. */
+    reference(): unknown;
     dirty(): boolean;
+    /**
+     * Отличается ли значение от снимка. Производное поле отличием не считается: его пишет поведение,
+     * а не пользователь — иначе форма без единой правки была бы «изменённой».
+     */
+    differsFrom(snapshot: unknown): boolean;
 }
-export declare class GroupNode {
+export declare class ModelGroupNode {
     path: string;
     readonly kind: "group";
     readonly children: Map<string, ModelNode>;
     /**
      * @param shape Образец той же группы из шаблона родительского массива: из него вложенные
-     *   массивы берут шаблоны, если значение пришло обычными данными (см. {@link ArrayNode}).
+     *   массивы берут шаблоны, если значение пришло обычными данными (см. {@link ModelArrayNode}).
      */
     constructor(initial: Record<string, unknown>, path: string, shape?: Shape);
     rebase(path: string): void;
     /** Реактивное чтение поддерева (внутри effect/computed подписывает на все листья группы). */
     read(): Record<string, unknown>;
     peek(): Record<string, unknown>;
+    /**
+     * Полная установка: значение ожидается целиком. Ключи, которых в нём нет, остаются прежними —
+     * как у {@link patch}, — но в dev о них сообщает предупреждение: неполный объект в `set` — почти
+     * всегда ошибка вызывающего кода, а не намерение.
+     */
     set(value: unknown): void;
+    /**
+     * Частичное обновление: записываются только переданные ключи. Вложенная группа сливается так
+     * же, массив заменяется целиком.
+     */
+    patch(value: unknown): void;
+    /**
+     * Запись значения по ключам группы. Лишние ключи значения игнорируются, производные поля не
+     * затираются.
+     *
+     * @param missing - Куда складывать пути ключей, для которых значение не пришло. Передаётся при
+     *   полной установке ({@link set}); при частичной ({@link patch}) — `undefined`.
+     * @param partial - Частичное обновление: ключ со значением `undefined` — «не трогать», как в
+     *   частичном значении элемента массива (`DeepPartial` допускает `{ ключ: undefined }`).
+     */
+    private write;
     resetToInitial(): void;
     captureInitial(): void;
     dirty(): boolean;
+    /** Отличается ли группа от снимка её значения (строка массива сверяется со снимком массива). */
+    differsFrom(snapshot: unknown): boolean;
 }
-export declare class ArrayNode {
+export declare class ModelArrayNode {
     path: string;
     private readonly shape?;
     readonly kind: "array";
@@ -89,18 +141,26 @@ export declare class ArrayNode {
     private blank;
     private fallback;
     private sample;
-    /** @param shape Образец того же массива из шаблона родителя (см. {@link GroupNode}). */
+    /** @param shape Образец того же массива из шаблона родителя (см. {@link ModelGroupNode}). */
     constructor(initial: unknown[], path: string, shape?: Shape | undefined);
-    /** Шаблон по старшинству: свой (`arrayOf`) → из шаблона родителя → из схемы. */
+    /** Шаблон по старшинству: свой (`arrayOf`) → из шаблона родителя → запасной извне. */
     private template;
     private readonly itemShape;
     private build;
-    /** Значение нового элемента: переданное либо из шаблона. */
+    /**
+     * Значение нового элемента: из шаблона; переданный объект накладывается поверх шаблона —
+     * недостающие ключи берутся из шаблона, поэтому `push({ type: 'house' })` даёт полный элемент.
+     */
     private fresh;
-    /** Шаблон из схемы (`initialValue` узла-массива) — запасной: шаблон модели главнее. */
+    /** Запасной шаблон извне (сборка формы передаёт `initialValue`): шаблон модели главнее. */
     provideBlank(blank: Blank): void;
     rebase(path: string): void;
     private reindex;
+    /**
+     * Индекс за концом массива — ошибка, а не «в конец»: `splice` молча сдвигал бы элемент на
+     * другой индекс, и вызывающий код получал бы путь, которого не просил.
+     */
+    private beyondEnd;
     push(value?: unknown): void;
     insertAt(index: number, value?: unknown): void;
     removeAt(index: number): void;
@@ -116,8 +176,15 @@ export declare class ArrayNode {
     set(value: unknown): void;
     resetToInitial(): void;
     captureInitial(): void;
+    /** Элементы точки отсчёта — копия: правка полученного снимок не трогает. */
+    reference(): unknown[];
     dirty(): boolean;
+    /**
+     * Отличается ли массив от снимка: другая длина либо отличается элемент. Сверка идёт по узлам, а
+     * не по значению целиком — производные поля строк (цели `compute` поведения строки) не в счёт.
+     */
+    differsFrom(snapshot: unknown): boolean;
 }
-/** Значение `initialValue` узла-массива схемы как шаблон: фабрика — как есть, значение — копией. */
+/** Начальное значение элемента как шаблон: фабрика — как есть, значение — копией. */
 export declare const blankFrom: (initialValue: unknown) => Blank;
 export {};