@reformer/core 9.0.0-beta.2 → 9.1.0

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

@@ -48,59 +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).
- *
- * ⚠️ Если то же поле одновременно является целью `compute`/`computeFrom`, обязательно ограничь
- * compute тем же условием (`when`), что и это `enableWhen`. Механизмы не согласованы: `enableWhen`
- * работает со статус-машиной ноды (enable/disable/reset), а `compute` пишет `target.value` напрямую
- * в сигнал модели и проверяет только собственный `options.when` — состояние `disabled` он НЕ смотрит.
- * Поэтому при выключенном поле любое изменение зависимости compute молча заново заполнит его (а с
- * `resetOnDisable` — перезапишет только что сброшенное значение), и так как `getValue()`/`submit`
- * включают disabled-поля, мусор утечёт в payload. Это аналог правила #13 гайда add-behavior,
- * которое сегодня сформулировано только для `copyFrom`; для `compute` то же ограничение обязательно.
- *
- * @group Model
- * @example
- * ```typescript
- * enableWhen(model.$.propertyValue, () => model.loanType === 'mortgage', { resetOnDisable: true });
- *
- * // Поле-цель compute, которое ТАКЖЕ в resetOnDisable enableWhen: compute обязан нести тот же when,
- * // иначе initialPayment заново заполнится в выключенном состоянии и утечёт в submit.
- * compute(model.$.initialPayment, () => model.propertyValue * 0.2, {
- *   when: () => model.loanType === 'mortgage',
- * });
- * ```
- */
-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/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/{core/utils → state}/safe-effect.d.ts

@@ -5,13 +5,13 @@
  * которая возникает при модификации сигналов внутри effect.
  *
  * Отложенная запись ({@link runOutsideEffect}) откладывается на микротаск и при этом:
- * - маршрутизирует синхронные throws и async-rejection через {@link FormErrorHandler} вместо того,
+ * - маршрутизирует синхронные throws и async-rejection dev-логгером (logDeferError) вместо того,
  *   чтобы они всплывали неперехваченными в точке микротаска / тонули как unhandledRejection;
  * - возвращает отменитель (canceller) для liveness — вызывающий может отменить ещё не выполненную
  *   запись при dispose, чтобы она не сработала против снесённого узла/формы.
  *
  * NB: намеренно НЕ оборачиваем записи в `batch()`. Реципрокные guard'ы слоя данных (например
- * `syncFields` в {@link module:core/model/behaviors}) держат флаг «идёт синхронизация» и сбрасывают его
+ * `syncFields` в модуле state/behaviors-value) держат флаг «идёт синхронизация» и сбрасывают его
  * в `finally` ПОСЛЕ записи, полагаясь на то, что встречный эффект флашится СИНХРОННО во время записи
  * (вне batch). `batch()` отложил бы встречный флаш за пределы сброса флага и сломал бы эту защиту
  * (сходимость осталась бы за peek-guard'ом, но появились бы лишние круги). Коалесинг записей в один
@@ -49,7 +49,7 @@ export declare function safeCallback<TArgs extends unknown[]>(callback: (...args
 /**
  * Выполняет функцию вне контекста effect (отложенная запись на микротаск).
  *
- * Сбои fn (синхронный throw и async-rejection) маршрутизируются через {@link FormErrorHandler}, а не
+ * Сбои fn (синхронный throw и async-rejection) маршрутизируются dev-логгером (logDeferError), а не
  * всплывают неперехваченными. Возвращает отменитель: вызов до срабатывания микротаска отменяет запись
  * (liveness-охрана — не писать против снесённого узла при dispose в том же тике).
  *
@@ -73,7 +73,7 @@ export declare function runOutsideEffect(fn: () => void | Promise<void>): () =>
  *
  * `withDebounce` уже откладывает вызов (таймер) — этого достаточно для выхода из effect-контекста,
  * поэтому дополнительного `queueMicrotask` нет (устранён двойной defer). Сбои callback (в т.ч.
- * async-rejection) маршрутизируются через {@link FormErrorHandler}.
+ * async-rejection) маршрутизируются dev-логгером (logDeferError).
  *
  * @param callback - Функция для выполнения
  * @param withDebounce - Функция debounce обёртки из BehaviorRegistry

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/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/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 {}