@reformer/core 9.1.1 → 10.0.0-beta.2

package/dist/form/validation/validators/phone.d.ts

@@ -38,4 +38,4 @@ export interface PhoneValidatorOptions extends ValidateOptions {
  * },
  * ```
  */
-export declare function phone<TForm = unknown, TField extends string | undefined = string>(options?: PhoneValidatorOptions): Validator<TForm, TField>;
+export declare function phone<TForm = unknown, TField extends string | null | undefined = string>(options?: PhoneValidatorOptions): Validator<TForm, TField>;

package/dist/form/validation/validators/url.d.ts

@@ -40,4 +40,4 @@ export interface UrlValidatorOptions extends ValidateOptions {
  * },
  * ```
  */
-export declare function url<TForm = unknown, TField extends string | undefined = string>(options?: UrlValidatorOptions): Validator<TForm, TField>;
+export declare function url<TForm = unknown, TField extends string | null | undefined = string>(options?: UrlValidatorOptions): Validator<TForm, TField>;

package/dist/form/validation-schema.d.ts

@@ -0,0 +1,93 @@
+import { FormModel, ModelArray, PathAwareSignal, ValidationError } from '../index';
+/**
+ * Синхронное правило поля типа `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;
+/**
+ * Синхронные правила поля.
+ *
+ * @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;
+/**
+ * Тонкая 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`.
+ *
+ * @example
+ * ```ts
+ * const ok = await validateModel(model, step2Validation);   // один шаг
+ * const all = await validateModel(model, formValidation);   // вся форма
+ * ```
+ */
+export declare function validateModel<T>(model: FormModel<T>, schema: ValidationSchema<T>): Promise<boolean>;