@reformer/core 9.0.0 → 9.1.0

package/dist/{core/model/behaviors.d.ts → state/behaviors-value.d.ts}

@@ -48,44 +48,6 @@ export declare function copyFrom<T>(source: ReadonlySignal<T>, target: Signal<T>
 export declare function watchField<T>(source: ReadonlySignal<T>, cb: (value: T) => void, options?: {
     immediate?: boolean;
 }): BehaviorCleanup;
-/**
- * Условное включение поля (state-операция). Резолвит ноду по сигналу-цели через реестр
- * сигнал→нода (заполняется `createForm`) и вызывает `enable()`/`disable()` (+`reset()` при
- * `resetOnDisable`). `condition` реактивен (читает свои сигналы модели).
- *
- * Запись состояния отложена через `runOutsideEffect` (микротаск) для защиты от «Cycle detected».
- * ⚠️ Поле должно быть материализовано в форме (`createForm`) — иначе ноды в реестре нет (например,
- * элемент массива, который строится per-item).
- *
- * @group Model
- * @example
- * ```typescript
- * enableWhen(model.$.propertyValue, () => model.loanType === 'mortgage', { resetOnDisable: true });
- * ```
- */
-export declare function enableWhen(target: ReadonlySignal<unknown>, condition: () => boolean, options?: {
-    resetOnDisable?: boolean;
-}): BehaviorCleanup;
-/**
- * Условное выключение поля (инверсия {@link enableWhen}). Резолвит ноду по сигналу-цели через реестр
- * сигнал→нода и вызывает `disable()`, когда `condition` истинно (+`reset()` при `resetOnDisable`).
- * `condition` реактивен (читает свои сигналы модели).
- *
- * @group Model
- * @param target Сигнал-цель поля (`model.$.<path>`).
- * @param condition Реактивное условие; при `true` поле выключается.
- * @param options.resetOnDisable Сбросить значение при выключении (по умолчанию `false`).
- * @returns Cleanup для отписки.
- *
- * @example
- * ```typescript
- * // Поле скидки недоступно, пока не выбран промо-тариф
- * disableWhen(model.$.discount, () => model.plan !== 'promo', { resetOnDisable: true });
- * ```
- */
-export declare function disableWhen(target: ReadonlySignal<unknown>, condition: () => boolean, options?: {
-    resetOnDisable?: boolean;
-}): BehaviorCleanup;
 /**
  * Трансформация значения поля (идемпотентная): при изменении пишет `transformer(value)` обратно.
  * Запись отложена (`runOutsideEffect`) во избежание «Cycle detected» (эффект читает и пишет один сигнал).

package/dist/{core/utils → state}/derived-registry.d.ts

@@ -6,6 +6,9 @@ import { Signal } from '@preact/signals-core';
  * bulk-сеттеры (`model.set`/`model.patch`, `patchValue`/`setValue`) пропускают это поле, чтобы
  * значение из payload не затирало вычисляемое. Прикладной код напрямую обычно не вызывает.
  *
+ * Идемпотентна на уровне флага: повторные вызовы наращивают счётчик ссылок, чтобы каждый оператор,
+ * пишущий в этот сигнал, был сбалансирован своим {@link unmarkDerived} при dispose.
+ *
  * @param signal - Сигнал значения из {@link FormModel}, которым владеет compute
  *
  * @example
@@ -17,9 +20,35 @@ import { Signal } from '@preact/signals-core';
  * ```
  *
  * @see {@link isDerived} - проверка пометки
+ * @see {@link unmarkDerived} - снять пометку при dispose оператора
  * @group Utilities
  */
 export declare function markDerived(signal: Signal<any>): void;
+/**
+ * Снять пометку производного сигнала (обратная операция к {@link markDerived}).
+ *
+ * Вызывается из очистки (`onDispose`) оператора `compute`/`computeFrom`, когда поведение снимается,
+ * но модель/сигнал продолжают жить (динамическая перекоммутация: удалить под-схему → сохранить модель
+ * → bulk-set). Без этого сигнал остаётся помеченным навсегда, и bulk-сеттеры навсегда пропускают
+ * поле, которое больше ничем не вычисляется.
+ *
+ * Учитывает счётчик ссылок: пометка снимается только когда снят последний владелец. Вызов на
+ * непомеченном сигнале — безопасный no-op.
+ *
+ * @param signal - Сигнал значения из {@link FormModel}, ранее помеченный {@link markDerived}
+ *
+ * @example
+ * ```typescript
+ * import { markDerived, unmarkDerived } from '@reformer/core';
+ *
+ * markDerived(model.$.total);
+ * onDispose(() => unmarkDerived(model.$.total)); // при снятии compute снова разрешаем bulk-set
+ * ```
+ *
+ * @see {@link markDerived} - пометить сигнал производным
+ * @group Utilities
+ */
+export declare function unmarkDerived(signal: Signal<any>): void;
 /**
  * Производный ли сигнал (помечен через {@link markDerived}).
  *

package/dist/state/form-model.d.ts

@@ -0,0 +1,26 @@
+import { FormModel } from './types';
+/**
+ * Создать реактивную модель данных формы (слой M1).
+ *
+ * @group Model
+ * @param initial Начальные значения (объект). Определяют форму данных и initial-снимок.
+ * @returns {@link FormModel} с value-доступом, `$`-сигналами и API (get/set/patch/isDirty/reset/signalAt).
+ *
+ * @example
+ * ```typescript
+ * const model = createModel<{ email: string; profile: { name: string }; tags: string[] }>({
+ *   email: '',
+ *   profile: { name: '' },
+ *   tags: [],
+ * });
+ * model.email = 'a@b.c';
+ * model.$.email.value;          // 'a@b.c' (сигнал)
+ * // вложенная объект-группа — под-модель FormModel (value-доступ + `.$` + API):
+ * model.profile.name = 'Ada';   // value-запись
+ * model.$.profile.name.value;   // 'Ada' (сигнал; ≡ model.profile.$.name у под-модели)
+ * model.profile.get();          // { name: 'Ada' }
+ * model.tags.push('x');
+ * model.get();                  // { email: 'a@b.c', profile: { name: 'Ada' }, tags: ['x'] }
+ * ```
+ */
+export declare function createModel<T extends object>(initial: T): FormModel<T>;

package/dist/state/index.d.ts

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

@@ -0,0 +1,93 @@
+/**
+ * Утилиты для безопасной работы с сигналами в effect контексте
+ *
+ * Эти утилиты решают проблему "Cycle detected" в @preact/signals-core,
+ * которая возникает при модификации сигналов внутри effect.
+ *
+ * Отложенная запись ({@link runOutsideEffect}) откладывается на микротаск и при этом:
+ * - маршрутизирует синхронные throws и async-rejection dev-логгером (logDeferError) вместо того,
+ *   чтобы они всплывали неперехваченными в точке микротаска / тонули как unhandledRejection;
+ * - возвращает отменитель (canceller) для liveness — вызывающий может отменить ещё не выполненную
+ *   запись при dispose, чтобы она не сработала против снесённого узла/формы.
+ *
+ * NB: намеренно НЕ оборачиваем записи в `batch()`. Реципрокные guard'ы слоя данных (например
+ * `syncFields` в модуле state/behaviors-value) держат флаг «идёт синхронизация» и сбрасывают его
+ * в `finally` ПОСЛЕ записи, полагаясь на то, что встречный эффект флашится СИНХРОННО во время записи
+ * (вне batch). `batch()` отложил бы встречный флаш за пределы сброса флага и сломал бы эту защиту
+ * (сходимость осталась бы за peek-guard'ом, но появились бы лишние круги). Коалесинг записей в один
+ * batch — законная оптимизация, но она требует, чтобы эти guard'ы стали batch-aware, поэтому делается
+ * не здесь. См. также `aggregateInto`, где коалесинг реализован на уровне самого оператора.
+ *
+ * @group Utils
+ * @module utils/safe-effect
+ */
+/**
+ * Создает callback, который выполняется вне контекста effect
+ *
+ * Откладывает вызов через {@link runOutsideEffect} — то есть получает маршрутизацию ошибок и
+ * обработку async-rejection «бесплатно».
+ *
+ * @param callback - Функция для выполнения
+ * @returns Обёрнутая функция, безопасная для вызова внутри effect
+ *
+ * @example
+ * ```typescript
+ * // Вместо:
+ * effect(() => {
+ *   queueMicrotask(() => {
+ *     callback(value, context);
+ *   });
+ * });
+ *
+ * // Используем:
+ * effect(() => {
+ *   safeCallback(callback)(value, context);
+ * });
+ * ```
+ */
+export declare function safeCallback<TArgs extends unknown[]>(callback: (...args: TArgs) => void | Promise<void>): (...args: TArgs) => void;
+/**
+ * Выполняет функцию вне контекста effect (отложенная запись на микротаск).
+ *
+ * Сбои fn (синхронный throw и async-rejection) маршрутизируются dev-логгером (logDeferError), а не
+ * всплывают неперехваченными. Возвращает отменитель: вызов до срабатывания микротаска отменяет запись
+ * (liveness-охрана — не писать против снесённого узла при dispose в том же тике).
+ *
+ * @param fn - Функция для выполнения
+ * @returns Отменитель ещё не выполненной записи (no-op, если запись уже выполнена)
+ *
+ * @example
+ * ```typescript
+ * effect(() => {
+ *   const value = signal.value;
+ *   const cancel = runOutsideEffect(() => {
+ *     otherSignal.value = transform(value);
+ *   });
+ *   onDispose(cancel); // отменить ожидающую запись, если узел снесут в этом же тике
+ * });
+ * ```
+ */
+export declare function runOutsideEffect(fn: () => void | Promise<void>): () => void;
+/**
+ * Создает версию callback с поддержкой debounce, безопасную для effect
+ *
+ * `withDebounce` уже откладывает вызов (таймер) — этого достаточно для выхода из effect-контекста,
+ * поэтому дополнительного `queueMicrotask` нет (устранён двойной defer). Сбои callback (в т.ч.
+ * async-rejection) маршрутизируются dev-логгером (logDeferError).
+ *
+ * @param callback - Функция для выполнения
+ * @param withDebounce - Функция debounce обёртки из BehaviorRegistry
+ * @returns Обёрнутая функция
+ *
+ * @example
+ * ```typescript
+ * return effect(() => {
+ *   const value = node.value.value;
+ *   safeDebouncedCallback(
+ *     () => callback(value, context),
+ *     withDebounce
+ *   )();
+ * });
+ * ```
+ */
+export declare function safeDebouncedCallback(callback: () => void | Promise<void>, withDebounce: (fn: () => void) => void): () => void;

package/dist/{core/model → state}/types.d.ts

@@ -26,15 +26,17 @@ type ModelArrayItem<U> = NonNullable<U> extends ReadonlyArray<infer E> ? ModelAr
  * Значение поля в value-доступе модели:
  * - массив → {@link ModelArray}
  * - спец-объект (Date/File/Blob) → как есть
- * - объект → вложенный value-proxy
+ * - объект → под-модель {@link FormModel} (value-доступ + `.$`-сигналы + API get/set/patch/…);
+ *   промоутится рантаймом (`makeFormModel`); сигналы идентичны `model.$.<path>`
  * - примитив → значение
  *
  * @group Model
  */
-export type ModelValue<V> = NonNullable<V> extends ReadonlyArray<infer U> ? ModelArray<U> : NonNullable<V> extends Opaque ? V : NonNullable<V> extends object ? ModelObject<NonNullable<V>> : V;
+export type ModelValue<V> = NonNullable<V> extends ReadonlyArray<infer U> ? ModelArray<U> : NonNullable<V> extends Opaque ? V : NonNullable<V> extends object ? FormModel<NonNullable<V>> : V;
 /**
- * value-proxy объекта: поля доступны как обычные свойства (чтение реактивно
- * внутри `effect`/`computed`, запись — присваиванием).
+ * Карта value-полей объекта (value-половина {@link FormModel}): поля доступны как обычные свойства
+ * (чтение реактивно внутри `effect`/`computed`, запись — присваиванием). Вложенные объекты-поля
+ * резолвятся в под-модели {@link FormModel} (см. {@link ModelValue}), массивы — в {@link ModelArray}.
  *
  * @group Model
  */
@@ -99,7 +101,7 @@ type ModelSignalNode<V> = NonNullable<V> extends ReadonlyArray<infer U> ? {
     readonly [index: number]: ModelSignalNode<U>;
 } : NonNullable<V> extends Opaque ? PathAwareSignal<V> : NonNullable<V> extends object ? ModelSignals<NonNullable<V>> : PathAwareSignal<V>;
 /**
- * API уровня модели (доступно на корне и под-моделях элементов массива).
+ * API уровня модели (доступно на корне, под-моделях вложенных объектов-групп и элементов массива).
  *
  * ⚠️ Имена методов (`$`/`get`/`set`/`patch`/`isDirty`/`reset`/`signalAt`/`captureInitial`)
  * зарезервированы: одноимённое поле формы их затеняет (редкий краевой случай).
@@ -112,12 +114,11 @@ export interface ModelApi<T> {
     /** Снимок значений (без подписки) — для submit. */
     get(): T;
     /**
-     * @deprecated Алиас {@link ModelApi.patch}: `set` выполняет то же частичное **слияние** —
-     *   обновляет только переданные ключи, отсутствующие НЕ трогает (это НЕ полная замена, вопреки
-     *   старому названию). Используйте `patch`; для замены с обнулением лишних полей делайте
-     *   `patch({ ...defaults, ...dto })` явно. Не меняет initial-снимок.
+     * Полная установка значений: принимает объект целиком (все ключи `T`) и записывает их в модель.
+     * Производными полями (цели `compute`) владеет compute — их значения из payload игнорируются.
+     * Не меняет initial-снимок. Для частичного обновления (только переданные ключи) — {@link ModelApi.patch}.
      */
-    set(value: Partial<T>): void;
+    set(value: T): void;
     /**
      * Частичное слияние значений (load/patch с сервера): обновляет только переданные ключи,
      * отсутствующие ключи НЕ трогаются. Не меняет initial-снимок.
@@ -133,7 +134,9 @@ export interface ModelApi<T> {
     signalAt(path: string): PathAwareSignal<unknown> | undefined;
 }
 /**
- * FormModel — value-proxy объекта `T` + {@link ModelApi}.
+ * FormModel — под-модель объекта `T`: value-доступ ({@link ModelObject}) + `.$`-сигналы + {@link ModelApi}
+ * (get/set/patch/isDirty/reset/signalAt). Вложенные объекты-группы модели — тоже {@link FormModel}
+ * (доступны как `model.<group>`), поэтому `model.<group>.$.<field>` эквивалентно `model.$.<group>.<field>`.
  *
  * @group Model
  */

package/dist/state.d.ts

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

package/dist/state.js

@@ -0,0 +1,19 @@
+import { S as s, c as r } from "./form-model-C8Fi83k4.js";
+import { c as o, a as t, i, m as d, r as l, b as m, d as n, e as f, f as u, s as b, t as p, u as k, w as v } from "./behaviors-value-lCpqicfa.js";
+export {
+  s as SubscriptionManager,
+  o as computeFrom,
+  t as copyFrom,
+  r as createModel,
+  i as isDerived,
+  d as markDerived,
+  l as resetWhen,
+  m as revalidateWhen,
+  n as runOutsideEffect,
+  f as safeCallback,
+  u as safeDebouncedCallback,
+  b as syncFields,
+  p as transformValue,
+  k as unmarkDerived,
+  v as watchField
+};

package/dist/validators/email.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/email'
+export * from '../form/validation/validators/email'
 export {}

package/dist/validators/future-date.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/future-date'
+export * from '../form/validation/validators/future-date'
 export {}

package/dist/validators/integer.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/integer'
+export * from '../form/validation/validators/integer'
 export {}

package/dist/validators/is-date.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/is-date'
+export * from '../form/validation/validators/is-date'
 export {}

package/dist/validators/is-number.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/is-number'
+export * from '../form/validation/validators/is-number'
 export {}

package/dist/validators/max-age.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/max-age'
+export * from '../form/validation/validators/max-age'
 export {}

package/dist/validators/max-date.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/max-date'
+export * from '../form/validation/validators/max-date'
 export {}

package/dist/validators/max-length.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/max-length'
+export * from '../form/validation/validators/max-length'
 export {}

package/dist/validators/max.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/max'
+export * from '../form/validation/validators/max'
 export {}

package/dist/validators/min-age.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/min-age'
+export * from '../form/validation/validators/min-age'
 export {}

package/dist/validators/min-date.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/min-date'
+export * from '../form/validation/validators/min-date'
 export {}

package/dist/validators/min-length.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/min-length'
+export * from '../form/validation/validators/min-length'
 export {}

package/dist/validators/min.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/min'
+export * from '../form/validation/validators/min'
 export {}

package/dist/validators/multiple-of.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/multiple-of'
+export * from '../form/validation/validators/multiple-of'
 export {}

package/dist/validators/non-negative.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/non-negative'
+export * from '../form/validation/validators/non-negative'
 export {}

package/dist/validators/non-zero.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/non-zero'
+export * from '../form/validation/validators/non-zero'
 export {}

package/dist/validators/past-date.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/past-date'
+export * from '../form/validation/validators/past-date'
 export {}

package/dist/validators/pattern.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/pattern'
+export * from '../form/validation/validators/pattern'
 export {}

package/dist/validators/pattern.js

@@ -1,10 +1,11 @@
-function n(r, t) {
-  return (e) => e ? r.test(e) ? null : {
+function s(e, r) {
+  const t = new RegExp(e.source, e.flags);
+  return (n) => n ? (t.lastIndex = 0, t.test(n) ? null : {
     code: "pattern",
-    message: t?.message ?? "invalid",
-    params: { pattern: r.source, ...t?.params }
-  } : null;
+    message: r?.message ?? "",
+    params: { pattern: e.source, ...r?.params }
+  }) : null;
 }
 export {
-  n as pattern
+  s as pattern
 };

package/dist/validators/phone.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/phone'
+export * from '../form/validation/validators/phone'
 export {}

package/dist/validators/required.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/required'
+export * from '../form/validation/validators/required'
 export {}

package/dist/validators/required.js

@@ -1,14 +1,10 @@
-function a(r) {
-  return (e) => e == null || e === "" ? {
+function n(e) {
+  return (r) => r == null || r === "" || Array.isArray(r) && r.length === 0 || typeof r == "boolean" && r !== !0 ? {
     code: "required",
-    message: r?.message ?? "invalid",
-    params: r?.params
-  } : typeof e == "boolean" && e !== !0 ? {
-    code: "required",
-    message: r?.message ?? "invalid",
-    params: r?.params
+    message: e?.message ?? "",
+    params: e?.params
   } : null;
 }
 export {
-  a as required
+  n as required
 };

package/dist/validators/url.d.ts

@@ -1,2 +1,2 @@
-export * from '../core/validation/validators/url'
+export * from '../form/validation/validators/url'
 export {}

package/dist/validators.d.ts

@@ -1,6 +1,6 @@
-/**
- * Re-export validators from the main index to ensure single module instance.
- * This prevents static registry isolation issues when consuming the library.
- */
-export { validators as default } from './index';
-export * from './core/validation';
+export * from './form/validators'
+export {}
+import _default from './form/validators'
+export default _default
+export * from './form/validators'
+export {}