@reformer/core 10.2.0 → 11.0.0-beta.10

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.d.ts

@@ -0,0 +1,2 @@
+import { FormLocale } from '../i18n/locale';
+export declare const en: FormLocale;

package/dist/locale/en.js

@@ -0,0 +1,5 @@
+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

@@ -0,0 +1,45 @@
+{
+  "code": "en",
+  "weekStartsOn": 0,
+  "messages": {
+    "format.fileSize.b": "{value} B",
+    "format.fileSize.kb": "{value} KB",
+    "format.fileSize.mb": "{value} MB",
+    "format.fileSize.gb": "{value} GB",
+    "format.fileSize.tb": "{value} TB",
+    "validation.required": "This field is required",
+    "validation.pattern": "Invalid format",
+    "validation.email": "Enter a valid email address",
+    "validation.url": "Enter a valid URL",
+    "validation.url_protocol": "The URL must use one of these protocols: {allowedProtocols}",
+    "validation.phone": "Enter a valid phone number",
+    "validation.min": "Must be at least {min}",
+    "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}",
+    "validation.nonNegative": "Must not be negative",
+    "validation.nonZero": "Must not be zero",
+    "validation.date_invalid": "Enter a valid date",
+    "validation.date_min": "The date must not be earlier than {minDate}",
+    "validation.date_max": "The date must not be later than {maxDate}",
+    "validation.date_past": "The date must not be in the past",
+    "validation.date_future": "The date must not be in the future",
+    "validation.date_min_age": "Age must be at least {minAge}",
+    "validation.date_max_age": "Age must be at most {maxAge}",
+    "validation.fileType": "File {fileName} has a type that is not allowed. Allowed: {accept}",
+    "validation.maxFileSize": "File {fileName} is larger than {maxFileSize}",
+    "validation.minFileSize": "File {fileName} is smaller than {minFileSize}",
+    "validation.maxFiles": "No more than {maxFiles, plural, one{# file} other{# files}}",
+    "validation.minFiles": "At least {minFiles, plural, one{# file} other{# files}}",
+    "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.ruleFailed": "Could not check this field. Try again"
+  }
+}

package/dist/locale/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Подпуть `@reformer/core/locale` — загрузчик встроенных локалей ядра (тексты ошибок валидации,
+ * единицы размера файла). Приложению с ui-kit он не нужен: `loadKitLocale` из
+ * `@reformer/ui-kit/locale` уже включает словари ядра и cdk.
+ *
+ * @module locale
+ */
+/** Языки, которые ядро поставляет само. */
+export declare const CORE_LOCALES: readonly string[];
+/**
+ * Источник локалей ядра для `createLocaleLoader`: чанк нужного языка по запросу.
+ *
+ * @example
+ * ```ts
+ * const loadLocale = createLocaleLoader([loadCoreLocale, fetchMessages((code) => `/locales/${code}.json`)]);
+ * ```
+ */
+export declare const loadCoreLocale: import('../i18n').LocaleSource;

package/dist/locale/ru.d.ts

@@ -0,0 +1,2 @@
+import { FormLocale } from '../i18n/locale';
+export declare const ru: FormLocale;

package/dist/locale/ru.js

@@ -0,0 +1,44 @@
+const a = {
+  "format.fileSize.b": "{value} Б",
+  "format.fileSize.kb": "{value} КБ",
+  "format.fileSize.mb": "{value} МБ",
+  "format.fileSize.gb": "{value} ГБ",
+  "format.fileSize.tb": "{value} ТБ",
+  "validation.required": "Обязательное поле",
+  "validation.pattern": "Неверный формат",
+  "validation.email": "Введите корректный email",
+  "validation.url": "Введите корректный адрес (URL)",
+  "validation.url_protocol": "Адрес должен начинаться с одного из протоколов: {allowedProtocols}",
+  "validation.phone": "Введите корректный номер телефона",
+  "validation.min": "Не меньше {min}",
+  "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}",
+  "validation.nonNegative": "Число не может быть отрицательным",
+  "validation.nonZero": "Число не может быть нулём",
+  "validation.date_invalid": "Введите корректную дату",
+  "validation.date_min": "Дата не раньше {minDate}",
+  "validation.date_max": "Дата не позже {maxDate}",
+  "validation.date_past": "Дата не может быть в прошлом",
+  "validation.date_future": "Дата не может быть в будущем",
+  "validation.date_min_age": "Возраст не меньше {minAge, plural, one{# года} few{# лет} many{# лет} other{# года}}",
+  "validation.date_max_age": "Возраст не больше {maxAge, plural, one{# года} few{# лет} many{# лет} other{# года}}",
+  "validation.fileType": "Недопустимый тип файла {fileName}. Разрешено: {accept}",
+  "validation.maxFileSize": "Файл {fileName} больше {maxFileSize}",
+  "validation.minFileSize": "Файл {fileName} меньше {minFileSize}",
+  "validation.maxFiles": "Не больше {maxFiles, plural, one{# файла} few{# файлов} many{# файлов} other{# файла}}",
+  "validation.minFiles": "Не меньше {minFiles, plural, one{# файла} few{# файлов} many{# файлов} other{# файла}}",
+  "validation.maxTotalFileSize": "Суммарный размер файлов больше {maxTotalFileSize}",
+  "validation.fileExists": "Файл {fileName} уже добавлен",
+  "validation.uploadAborted": "Загрузка прервана",
+  "validation.uploadFailed": "Не удалось загрузить файл {fileName}",
+  "validation.ruleFailed": "Не удалось проверить поле. Повторите попытку"
+}, i = a, e = { code: "ru", weekStartsOn: 1, messages: i };
+export {
+  e as ru
+};

package/dist/locale/ru.json

@@ -0,0 +1,45 @@
+{
+  "code": "ru",
+  "weekStartsOn": 1,
+  "messages": {
+    "format.fileSize.b": "{value} Б",
+    "format.fileSize.kb": "{value} КБ",
+    "format.fileSize.mb": "{value} МБ",
+    "format.fileSize.gb": "{value} ГБ",
+    "format.fileSize.tb": "{value} ТБ",
+    "validation.required": "Обязательное поле",
+    "validation.pattern": "Неверный формат",
+    "validation.email": "Введите корректный email",
+    "validation.url": "Введите корректный адрес (URL)",
+    "validation.url_protocol": "Адрес должен начинаться с одного из протоколов: {allowedProtocols}",
+    "validation.phone": "Введите корректный номер телефона",
+    "validation.min": "Не меньше {min}",
+    "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}",
+    "validation.nonNegative": "Число не может быть отрицательным",
+    "validation.nonZero": "Число не может быть нулём",
+    "validation.date_invalid": "Введите корректную дату",
+    "validation.date_min": "Дата не раньше {minDate}",
+    "validation.date_max": "Дата не позже {maxDate}",
+    "validation.date_past": "Дата не может быть в прошлом",
+    "validation.date_future": "Дата не может быть в будущем",
+    "validation.date_min_age": "Возраст не меньше {minAge, plural, one{# года} few{# лет} many{# лет} other{# года}}",
+    "validation.date_max_age": "Возраст не больше {maxAge, plural, one{# года} few{# лет} many{# лет} other{# года}}",
+    "validation.fileType": "Недопустимый тип файла {fileName}. Разрешено: {accept}",
+    "validation.maxFileSize": "Файл {fileName} больше {maxFileSize}",
+    "validation.minFileSize": "Файл {fileName} меньше {minFileSize}",
+    "validation.maxFiles": "Не больше {maxFiles, plural, one{# файла} few{# файлов} many{# файлов} other{# файла}}",
+    "validation.minFiles": "Не меньше {minFiles, plural, one{# файла} few{# файлов} many{# файлов} other{# файла}}",
+    "validation.maxTotalFileSize": "Суммарный размер файлов больше {maxTotalFileSize}",
+    "validation.fileExists": "Файл {fileName} уже добавлен",
+    "validation.uploadAborted": "Загрузка прервана",
+    "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.d.ts

@@ -0,0 +1,2 @@
+export * from './locale/index'
+export {}

package/dist/locale.js

@@ -0,0 +1,9 @@
+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)
+});
+export {
+  n as CORE_LOCALES,
+  t as loadCoreLocale
+};

package/dist/{state → 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/{state/form-model.d.ts → model/create-model.d.ts}

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

package/dist/{state → 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

@@ -0,0 +1,42 @@
+/**
+ * `@reformer/core/model` — низкоуровневый реактивный субстрат и barrel модуля `model`.
+ *
+ * Это «прокси-объект с сигналами» и инструментарий для построения доменных модулей поверх него
+ * (form, table, …). Модуль СТРОГО реактивный: НИЧЕГО связанного с формами/валидацией/схемами здесь
+ * нет — только модель, value-операции, producer-флаг и утилиты субстрата. Граница model⇏form
+ * зафиксирована ESLint-правилом (`no-restricted-imports` на `src/model/**`).
+ *
+ * Реактивный рантайм (`signal/computed/effect/…`) живёт в отдельном subpath `@reformer/core/signals`
+ * (единый владелец `@preact/signals-core`) — импортируй его оттуда; здесь он НЕ реэкспортируется,
+ * чтобы зонтичный barrel `.` не разрастался рантаймом.
+ *
+ * Состав (реэкспорты — из тех же файлов, что использует зонтик `.`, поэтому `.` и `/model` — один
+ * module-инстанс: общий `derived`-WeakMap, единая идентичность `Signal`):
+ * - **модель** — `createModel` + типы `FormModel`/`ModelArray`/… + `PathAwareSignal`;
+ * - **шаблон элемента массива** — `arrayOf(blank)`: что кладёт `push()` без значения;
+ * - **обход значений** — `eachLeafSignal` (листья) и `eachValueSignal` (листья и массивы целиком);
+ * - **ручка → фасад** — `modelOf(model.$.<группа | массив>)`: под-модель или фасад массива;
+ * - **value-операции** (реактивные правила) — `computeFrom`/`copyFrom`/`watchField`/`transformValue`/
+ *   `resetWhen`/`syncFields`/`revalidateWhen`;
+ * - **producer-owned флаг** — `markDerived`/`isDerived`/`unmarkDerived`;
+ * - **утилиты субстрата** — `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 { 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, ResetWhenOptionsArg } from './behaviors-value';
+export { markDerived, isDerived, unmarkDerived } from './derived-registry';
+export { runOutsideEffect, safeCallback, safeDebouncedCallback, deferredWritesSettled, } from './safe-effect';
+export { deepEqual } from './model-nodes';