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

package/dist/form/validation/index.d.ts

@@ -1,28 +1,23 @@
-export { required } from './validators/required';
-export { min } from './validators/min';
-export { max } from './validators/max';
-export { minLength } from './validators/min-length';
-export { maxLength } from './validators/max-length';
-export { email } from './validators/email';
-export { pattern } from './validators/pattern';
-export { url } from './validators/url';
-export { phone, type PhoneFormat } from './validators/phone';
-export { isNumber } from './validators/is-number';
-export { integer } from './validators/integer';
-export { multipleOf } from './validators/multiple-of';
-export { nonNegative } from './validators/non-negative';
-export { nonZero } from './validators/non-zero';
-export { isDate } from './validators/is-date';
-export { minDate } from './validators/min-date';
-export { maxDate } from './validators/max-date';
-export { pastDate } from './validators/past-date';
-export { futureDate } from './validators/future-date';
-export { minAge } from './validators/min-age';
-export { maxAge } from './validators/max-age';
-export { maxFileSize } from './validators/max-file-size';
-export { minFileSize } from './validators/min-file-size';
-export { fileType } from './validators/file-type';
-export { maxFiles } from './validators/max-files';
-export { minFiles } from './validators/min-files';
-export { maxTotalFileSize } from './validators/max-total-file-size';
-export { isFileLike, matchesFileAccept, toFileArray, type FileLike } from './validators/file-utils';
+/**
+ * Декларативный контракт СХЕМЫ ВАЛИДАЦИИ — `@reformer/core/validation`.
+ *
+ * Схема валидации — обычная функция `(ctx: { model }) => void`. Внутри вызываются свободные операторы
+ * (`validate`/`validateAsync`/`validateWhen`/`cross`/`each`/`apply`), которые САМИ пишут ошибки в ambient-сток
+ * текущего прогона — автор не видит ни коллектора, ни `getNodeForSignal`, ни `.push`. Внешний раннер
+ * {@link validateModel} открывает ambient-окно на время СИНХРОННОГО прогона схемы, дожидается async-правил
+ * и разносит ошибки по нодам формы (`getNodeForSignal(sig).setErrors(...)`), гася поля, ставшие валидными.
+ *
+ * Зеркалит контракт поведения (`@reformer/core/behaviors`): тот же ambient-стиль, но отдельный слой —
+ * валидация НЕ реактивна (прогон по требованию: submit/шаг), поведение — реактивно (живые подписки).
+ *
+ * Модуль разложен по зонам ответственности: `./types` — контракт правил и схемы, `./context` —
+ * ambient-сток прогона, `./operators` — операторы схемы, `./run` — раннер, `./strategy` — КОГДА
+ * запускать (реэкспортируется отсюда, тот же сабпат).
+ *
+ * @group Validation
+ * @module form/validation
+ */
+export type { Rule, AsyncRule, ValidationSchema } from './types';
+export { validate, validateAsync, validateWhen, cross, each, apply } from './operators';
+export { defineValidationSchema, validateModel } from './run';
+export * from './strategy';

package/dist/form/validation/operators.d.ts

@@ -0,0 +1,42 @@
+import { FormModel, ModelArray, PathAwareSignal, ValidationError } from '../../index';
+import { AsyncRule, Rule, ValidationSchema } from './types';
+/**
+ * Синхронные правила поля.
+ *
+ * @example
+ * ```ts
+ * validate(model.$.loanAmount, [required({ message: 'Сумма' }), min(50000)]);
+ * ```
+ */
+export declare function validate<TField>(sig: PathAwareSignal<TField>, rules: Rule<TField>[]): void;
+/**
+ * Асинхронные правила поля (зеркалит движковое разделение `validators` / `asyncValidators`).
+ * Раннер дожидается их и прокидывает `AbortSignal` для отмены устаревших ответов.
+ *
+ * @example
+ * ```ts
+ * validateAsync(model.$.username, [async (v, { signal }) => {
+ *   const r = await fetch(`/api/free?u=${v}`, { signal });
+ *   return (await r.json()).free ? null : { code: 'taken', message: 'Занято' };
+ * }]);
+ * ```
+ */
+export declare function validateAsync<TField>(sig: PathAwareSignal<TField>, rules: AsyncRule<TField>[]): void;
+/**
+ * Условная валидация: правила внутри `cb` активны, только пока `cond()` истинно; иначе их поля
+ * ГАСЯТСЯ (пустой bucket → `setErrors([])`). Не трогает включение/сброс поля — это дело поведения (`enableWhen`).
+ */
+export declare function validateWhen(cond: () => boolean, cb: () => void): void;
+/**
+ * Cross-field правило: `fn` получает СНАПШОТ модели текущего scope (`model.get()`) и вешает ошибку на `sig`.
+ * Для элементов массива / под-моделей захватывайте нужный снапшот в замыкание (`const item = im.get()`),
+ * т.к. `fn` всегда получает модель ТЕКУЩЕГО scope (корень прогона), а не под-модель.
+ */
+export declare function cross<TSnapshot>(sig: PathAwareSignal<unknown>, fn: (form: TSnapshot) => ValidationError | null): void;
+/**
+ * Применить под-правила к КАЖДОМУ элементу текущего массива модели.
+ * `U extends object` — элементы должны быть под-моделями (объектами); для массива примитивов валидируйте лист напрямую.
+ */
+export declare function each<U extends object>(arr: ModelArray<U>, itemFn: (item: FormModel<U>) => void): void;
+/** Композиция под-схем в текущую (над той же моделью scope). Заменяет пошаговую группировку. */
+export declare function apply<T>(...schemas: ValidationSchema<T>[]): void;

package/dist/form/validation/run.d.ts

@@ -0,0 +1,45 @@
+import { FormModel } from '../../index';
+import { ValidationSchema } from './types';
+/**
+ * Тонкая identity-обёртка для типизации/discoverability (как `defineFormBehavior`). Возвращает схему как есть.
+ *
+ * @example
+ * ```ts
+ * export const step1 = defineValidationSchema<LoanForm>(({ model }) => {
+ *   validate(model.$.loanAmount, [required(), min(50000)]);
+ * });
+ * ```
+ */
+export declare function defineValidationSchema<T>(schema: ValidationSchema<T>): ValidationSchema<T>;
+/**
+ * Провалидировать модель ЛЮБОЙ схемой (шаг или вся форма). Открывает ambient-окно на время
+ * синхронного прогона `schema`, дожидается async-правил, разносит ошибки по нодам формы и гасит
+ * поля, ставшие валидными. Возвращает `true`, если нет блокирующих ошибок (`severity:'warning'` не блокирует).
+ *
+ * Гашение — на пару (model, schema): `validateModel(model, step2)` и `validateModel(model, form)` не мешают
+ * друг другу. Устаревший прогон (быстрый повторный вызов той же (model, schema)) отменяется через `AbortSignal`
+ * и возвращает `false` (**fail-closed** — отменённому результату нельзя доверять для submit).
+ *
+ * ⚠️ `schema` должна быть СТАБИЛЬНОЙ ссылкой: отмена устаревших прогонов ключится по идентичности `schema`.
+ * Инлайн-стрелка (`validateModel(model, ({ model }) => …)`) каждый раз создаёт НОВЫЙ прогон без дедупликации —
+ * держите схемы в `const` / `defineValidationSchema`.
+ *
+ * `options.touch` (§6): по завершении помечает `touched` ИМЕННО поля, которые схема проверяла
+ * (не всё поддерево). Ошибки становятся видимыми (`shouldShowError = invalid && (touched||dirty)`)
+ * без ручного `form.markAsTouched()`; при пошаговой валидации следующий шаг не показывается
+ * «тронутым» до ввода. Валидные проверенные поля тоже метятся — это безвредно (ошибка не покажется).
+ *
+ * @param model - Модель данных формы.
+ * @param schema - Схема валидации (стабильная ссылка).
+ * @param options - `{ touch }` — пометить провалидированные поля `touched` для показа ошибок.
+ *
+ * @example
+ * ```ts
+ * const ok = await validateModel(model, step2Validation);              // один шаг
+ * const all = await validateModel(model, formValidation);              // вся форма
+ * const stepOk = await validateModel(model, step2Validation, { touch: true }); // + показать ошибки шага
+ * ```
+ */
+export declare function validateModel<T>(model: FormModel<T>, schema: ValidationSchema<T>, options?: {
+    touch?: boolean;
+}): Promise<boolean>;

package/dist/form/{validation-strategy.d.ts → validation/strategy.d.ts}

@@ -1,6 +1,6 @@
 import { ReadonlySignal } from '@preact/signals-core';
-import { FormModel } from '../index';
-import { ValidationSchema } from './validation-schema';
+import { FormModel } from '../../index';
+import { ValidationSchema } from './types';
 /**
  * Когда запускается schema-валидация:
  * - `submit` (по умолчанию) — только явным вызовом `validate()` (на отправке);

package/dist/form/validation/types.d.ts

@@ -0,0 +1,28 @@
+import { FormModel, ValidationError } from '../../index';
+/**
+ * Внутренний callable-вид правила: value-only фабрики игнорируют 2-й/3-й аргумент.
+ *
+ * @internal
+ */
+export type CallableRule = (value: unknown, model: unknown, root: unknown) => ValidationError | null;
+/**
+ * Синхронное правило поля типа `TField`. Проверяется ТОЛЬКО значение (`value`).
+ *
+ * Позиционные `scope`/`root` помечены `never` намеренно: так встроенные value-only фабрики
+ * (`required()`/`min()`/… — они `(value, model, root) => …`) и inline-правила `(value) => …`
+ * ОБА присваиваются в `Rule<TField>[]` без `any`, при этом сохраняется проверка типа поля
+ * (`validate(model.$.age, [email()])` подсветится — `email` ждёт `string`, поле `number`).
+ * На вызове раннер приводит правило к callable и передаёт `(value, model, model)`.
+ */
+export type Rule<TField> = (value: TField, scope: never, root: never) => ValidationError | null;
+/**
+ * Асинхронное правило поля. Получает `AbortSignal` для отмены устаревших ответов (быстрый повторный
+ * прогон той же схемы отменяет предыдущий). Сетевой сбой не должен блокировать — ловите и возвращайте `null`.
+ */
+export type AsyncRule<TField> = (value: TField, ctx: {
+    signal: AbortSignal;
+}) => Promise<ValidationError | null>;
+/** Схема валидации — обычная функция над (под)моделью. First-class значение (можно `apply`/тестировать/переиспользовать). */
+export type ValidationSchema<T> = (ctx: {
+    model: FormModel<T>;
+}) => void;

package/dist/form/{validation/validators → validators}/date-utils.d.ts

@@ -3,7 +3,7 @@
  *
  * @group Validation
  * @category Validators
- * @module validators/date-utils
+ * @module form/validators/date-utils
  */
 /**
  * Парсит значение в объект Date

package/dist/form/{validation/validators → validators}/email.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора формата email.
  *

package/dist/form/{validation/validators → validators}/file-type.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора типа файла.
  *

package/dist/form/{validation/validators → validators}/file-utils.d.ts

@@ -7,7 +7,7 @@
  *
  * @group Validation
  * @category Validators
- * @module validators/file-utils
+ * @module form/validators/file-utils
  */
 /**
  * Минимальный файлоподобный контракт, с которым работают file-валидаторы:

package/dist/form/{validation/validators → validators}/future-date.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора, проверяющего что дата не в прошлом.
  *

package/dist/form/{validation/validators → validators}/index.d.ts

@@ -1,9 +1,11 @@
 /**
- * Reusable validator factories.
+ * Точка входа сабпата `@reformer/core/validators` — все фабрики правил одним импортом.
  *
- * Все примитивы — фабрики, возвращающие чистый Validator<TForm, TField>.
- * Импортируются из `@reformer/core/validators` и передаются в массив `validators`
- * поля схемы формы: `validators: [required(), min(18)]`.
+ * Все примитивы — фабрики, возвращающие чистый `Validator<TForm, TField>`; передаются в
+ * массив `validators` поля схемы формы: `validators: [required(), min(18)]`.
+ *
+ * Гранулярные сабпаты (`@reformer/core/validators/required` и ещё 20) собираются отдельными
+ * entry для tree-shaking; этот модуль отдаёт полный набор для случаев, когда правил много.
  */
 export { required } from './required';
 export { min } from './min';

package/dist/form/{validation/validators → validators}/integer.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора, проверяющего что число — целое.
  *

package/dist/form/{validation/validators → validators}/is-date.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора, проверяющего что значение — валидная дата.
  *

package/dist/form/{validation/validators → validators}/is-number.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора, проверяющего что значение — конечное число (не NaN, не строка).
  *

package/dist/form/{validation/validators → validators}/max-age.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора максимального возраста (по дате рождения).
  *

package/dist/form/{validation/validators → validators}/max-date.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора максимальной даты (включительно).
  *

package/dist/form/{validation/validators → validators}/max-file-size.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора максимального размера файла.
  *

package/dist/form/{validation/validators → validators}/max-files.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора максимального количества файлов.
  *

package/dist/form/{validation/validators → validators}/max-length.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора максимальной длины строки или массива.
  *

package/dist/form/{validation/validators → validators}/max-total-file-size.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора суммарного размера всех файлов.
  *

package/dist/form/{validation/validators → validators}/max.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора максимального числового значения.
  *

package/dist/form/{validation/validators → validators}/min-age.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора минимального возраста (по дате рождения).
  *

package/dist/form/{validation/validators → validators}/min-date.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора минимальной даты (включительно).
  *

package/dist/form/{validation/validators → validators}/min-file-size.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора минимального размера файла.
  *

package/dist/form/{validation/validators → validators}/min-files.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора минимального количества файлов.
  *

package/dist/form/{validation/validators → validators}/min-length.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора минимальной длины строки или массива.
  *

package/dist/form/{validation/validators → validators}/min.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора минимального числового значения.
  *

package/dist/form/{validation/validators → validators}/multiple-of.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора, проверяющего что число кратно заданному.
  *

package/dist/form/{validation/validators → validators}/non-negative.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора, проверяющего что число неотрицательное (`≥ 0`).
  *

package/dist/form/{validation/validators → validators}/non-zero.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора, проверяющего что число не равно нулю.
  *

package/dist/form/{validation/validators → validators}/past-date.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора, проверяющего что дата не в будущем.
  *

package/dist/form/{validation/validators → validators}/pattern.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора регулярного выражения.
  *

package/dist/form/{validation/validators → validators}/phone.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Формат проверки номера телефона для валидатора {@link phone}.
  *

package/dist/form/{validation/validators → validators}/required.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора обязательного поля.
  *

package/dist/form/{validation/validators → validators}/url.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Опции валидатора {@link url}. Расширяют {@link ValidateOptions} (`message`, `params`)
  * настройками проверки протокола.

package/dist/index.d.ts

@@ -1,11 +1,14 @@
 /**
- * Публичный barrel `@reformer/core` — зонтик над модулями `model` (state) и `form`.
+ * Публичный barrel `@reformer/core` — зонтик над слоями `model`, `form` и `platforms/react`.
  *
- * Состав экспортов НЕ изменился при модуляризации (реорг в src/model + src/form): реализация
- * разложена по модулям, а этот barrel по-прежнему отдаёт единую поверхность.
+ * `model` — реактивная модель данных (сабпат `@reformer/core/model`); `form` — узлы, поведение и
+ * валидация поверх её сигналов; `platforms/react` — биндинги в React, единственный слой с
+ * рантайм-зависимостью от `react`. Состав экспортов зонтика не меняется при реорганизациях:
+ * реализация разложена по слоям, а barrel по-прежнему отдаёт единую поверхность.
  */
 export * from './form/types/index';
 export * from './form/factories/index';
-export * from './state/index';
+export * from './model/index';
 export * from './form/index';
+export * from './platforms/react/index';
 export { CORE_RUNTIME_TOKEN } from './runtime-token';