@reformer/core 10.2.0 → 11.0.0-beta.1

package/dist/form/form-submitter.d.ts

@@ -118,8 +118,4 @@ export declare class FormSubmitter<T extends object> {
      * ```
      */
     submitWithResult<R>(onSubmit: (values: T) => Promise<R> | R, options?: SubmitOptions): Promise<SubmitResult<R>>;
-    /**
-     * Проверить, идет ли отправка формы
-     */
-    isSubmitting(): boolean;
 }

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

@@ -166,12 +166,12 @@ export interface FieldControlState<T> {
     shouldShowError: boolean;
     /**
      * Пользовательские props для передачи в UI-компоненты.
-     * Устанавливаются через {@link FieldNode.setComponentProps}.
+     * Устанавливаются через {@link FieldNode.updateComponentProps}.
      *
      * @example
      * ```tsx
      * // Установка props
-     * field.setComponentProps({
+     * field.updateComponentProps({
      *   placeholder: 'Enter email...',
      *   maxLength: 100,
      *   autoComplete: 'email'
@@ -234,7 +234,7 @@ export interface FieldControlState<T> {
  *         <PhoneItem
  *           key={item.id}
  *           control={item}
- *           onRemove={() => control.remove(index)}
+ *           onRemove={() => control.removeAt(index)}
  *         />
  *       ))}
  *

package/dist/form/index.d.ts

@@ -24,10 +24,7 @@ export { FormErrorHandler, ErrorStrategy } from './error-handler';
 export { registerSignalNode, getNodeForSignal } from './signal-node-registry';
 export { FormSubmitter } from './form-submitter';
 export type { SubmittableForm, SubmitOptions, SubmitResult } from './form-submitter';
-export { FormStatusMachine } from './status-machine';
-export type { StatusEvent } from './status-machine';
 export { isFormNode, isFieldNode, isGroupNode, isArrayNode, getNodeType } from './type-guards';
-export { uniqueId } from './unique-id';
 export { useFormControl } from './hooks/useFormControl';
 export { useFormControlValue } from './hooks/useFormControlValue';
 export { useArrayLength } from './hooks/useArrayLength';

package/dist/form/nodes/array-node.d.ts

@@ -31,8 +31,6 @@ export declare class ArrayNode<T extends object> extends FormNode<T[]> {
     private disposers;
     /** Array-level validation errors (e.g., "минимум 1 элемент") */
     private readonly _arrayErrors;
-    private validationSchemaFn?;
-    private behaviorSchemaFn?;
     readonly value: ReadonlySignal<T[]>;
     readonly valid: ReadonlySignal<boolean>;
     readonly invalid: ReadonlySignal<boolean>;
@@ -227,88 +225,6 @@ export declare class ArrayNode<T extends object> extends FormNode<T[]> {
      * @param schema - Схема для проверки
      */
     private isGroupSchema;
-    /**
-     * Применить validation schema ко всем элементам массива
-     *
-     * Validation schema будет применена к:
-     * - Всем существующим элементам
-     * - Всем новым элементам, добавляемым через push/insert
-     *
-     * @param schemaFn - Функция валидации для элемента массива
-     *
-     * @example
-     * ```typescript
-     * import { propertyValidation } from './validation/property-validation';
-     *
-     * form.properties.applyValidationSchema(propertyValidation);
-     * ```
-     */
-    applyValidationSchema(schemaFn: unknown): void;
-    /**
-     * Применить behavior schema ко всем элементам ArrayNode
-     *
-     * Автоматически применяется к новым элементам при push/insert.
-     *
-     * @param schemaFn - Behavior schema функция
-     *
-     * @example
-     * ```typescript
-     * import { addressBehavior } from './behaviors/address-behavior';
-     *
-     * form.addresses.applyBehaviorSchema(addressBehavior);
-     * ```
-     */
-    applyBehaviorSchema(schemaFn: unknown): void;
-    /**
-     * Подписка на изменения конкретного поля во всех элементах массива
-     * Срабатывает при изменении значения поля в любом элементе
-     *
-     * @param fieldKey - Ключ поля для отслеживания
-     * @param callback - Функция, вызываемая при изменении, получает массив всех значений и индекс измененного элемента
-     * @returns Функция отписки для cleanup
-     *
-     * @example
-     * ```typescript
-     * // Автоматический пересчет общей стоимости при изменении цен
-     * const dispose = form.existingLoans.watchItems(
-     *   'remainingAmount',
-     *   (amounts) => {
-     *     const totalDebt = amounts.reduce((sum, amount) => sum + (amount || 0), 0);
-     *     form.totalDebt.setValue(totalDebt);
-     *   }
-     * );
-     *
-     * // При изменении любого remainingAmount → пересчитается totalDebt
-     * form.existingLoans.at(0)?.remainingAmount.setValue(500000);
-     *
-     * // Cleanup
-     * useEffect(() => dispose, []);
-     * ```
-     */
-    watchItems<K extends keyof T>(fieldKey: K, callback: (values: Array<T[K] | undefined>) => void | Promise<void>): () => void;
-    /**
-     * Подписка на изменение длины массива
-     * Срабатывает при добавлении/удалении элементов
-     *
-     * @param callback - Функция, вызываемая при изменении длины, получает новую длину
-     * @returns Функция отписки для cleanup
-     *
-     * @example
-     * ```typescript
-     * // Обновление счетчика элементов в UI
-     * const dispose = form.properties.watchLength((length) => {
-     *   console.log(`Количество объектов недвижимости: ${length}`);
-     *   form.propertyCount.setValue(length);
-     * });
-     *
-     * form.properties.push({ title: 'Квартира', value: 5000000 });
-     * // Выведет: "Количество объектов недвижимости: 1"
-     *
-     * // Cleanup
-     * useEffect(() => dispose, []);
-     * ```
-     */
-    watchLength(callback: (length: number) => void | Promise<void>): () => void;
     /**
      * Очистить все ресурсы узла
      * Рекурсивно очищает все subscriptions и элементы массива

package/dist/form/nodes/form-node.d.ts

@@ -7,8 +7,6 @@ import { FieldStatus, ValidationError, ErrorFilterOptions } from '../types/index
 export interface SetValueOptions {
     /** Не вызывать событие изменения (не триггерить валидацию) */
     emitEvent?: boolean;
-    /** Обновить только этот узел, не распространять на родителей */
-    onlySelf?: boolean;
 }
 /**
  * Абстрактный базовый класс для всех узлов формы.
@@ -54,19 +52,11 @@ export declare abstract class FormNode<T> {
      * Computed из _touched для предоставления readonly интерфейса
      */
     readonly touched: ReadonlySignal<boolean>;
-    /**
-     * Пользователь не взаимодействовал с узлом (untouched)
-     */
-    readonly untouched: ReadonlySignal<boolean>;
     /**
      * Значение узла было изменено (dirty)
      * Computed из _dirty для предоставления readonly интерфейса
      */
     readonly dirty: ReadonlySignal<boolean>;
-    /**
-     * Значение узла не было изменено (pristine)
-     */
-    readonly pristine: ReadonlySignal<boolean>;
     /**
      * Текущий статус узла
      * Computed из _status для предоставления readonly интерфейса
@@ -76,10 +66,6 @@ export declare abstract class FormNode<T> {
      * Узел отключен (disabled)
      */
     readonly disabled: ReadonlySignal<boolean>;
-    /**
-     * Узел включен (enabled)
-     */
-    readonly enabled: ReadonlySignal<boolean>;
     /**
      * Текущее значение узла
      * - Для FieldNode: значение поля

package/dist/form/nodes/group-node.d.ts

@@ -131,10 +131,6 @@ export declare class GroupNode<T> extends FormNode<T> {
      * - form.email вместо form.fields.get('email')
      * - form.address.city вместо form.fields.get('address').fields.get('city')
      *
-     * Используется в:
-     * - BehaviorApplicator для доступа к полям в behavior functions
-     * - ValidationApplicator для доступа к форме в tree validators
-     *
      * @returns Proxy-инстанс с типобезопасным доступом к полям или сама форма, если proxy не доступен
      *
      * @example

package/dist/form/status-machine.d.ts

@@ -1,23 +1,5 @@
 import { ReadonlySignal } from '@preact/signals-core';
 import { FieldStatus } from './types/index';
-/**
- * События для State Machine
- */
-export type StatusEvent = {
-    type: 'START_VALIDATION';
-} | {
-    type: 'VALIDATION_SUCCESS';
-} | {
-    type: 'VALIDATION_FAILURE';
-} | {
-    type: 'DISABLE';
-} | {
-    type: 'ENABLE';
-    hasErrors?: boolean;
-} | {
-    type: 'SET_ERRORS';
-    hasErrors: boolean;
-};
 /**
  * FormStatusMachine - управляет состоянием поля формы
  *
@@ -130,24 +112,4 @@ export declare class FormStatusMachine {
      * ```
      */
     enable(hasErrors?: boolean): void;
-    /**
-     * Обработать событие (альтернативный API)
-     *
-     * @param event - Событие для обработки
-     *
-     * @example
-     * ```typescript
-     * statusMachine.dispatch({ type: 'START_VALIDATION' });
-     * statusMachine.dispatch({ type: 'VALIDATION_FAILURE' });
-     * ```
-     */
-    dispatch(event: StatusEvent): void;
-    /**
-     * Получить текущий статус
-     */
-    getStatus(): FieldStatus;
-    /**
-     * Проверить, можно ли начать валидацию
-     */
-    canValidate(): boolean;
 }

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

@@ -19,12 +19,6 @@
 export type FormValue = string | number | boolean | null | undefined | Date | File | FormValue[] | {
     [key: string]: FormValue;
 };
-/**
- * Type-safe alternative to 'any' for unknown form values
- * Requires explicit type checking before use
- * @internal
- */
-export type UnknownFormValue = unknown;
 /**
  * Синхронная функция валидации
  * @group Types

package/dist/form/types/deep-schema.d.ts

@@ -58,15 +58,6 @@ type RequireAtLeastOne<T> = {
  * @internal
  */
 type NonEmptyFieldConfig<T> = RequireAtLeastOne<FieldConfig<T>>;
-/**
- * Конфигурация массива
- * @group Types
- * @category Configuration Types
- */
-export interface ArrayConfig<T extends object> {
-    itemSchema: FormSchema<T>;
-    initial?: Partial<T>[];
-}
 /**
  * **Data-shaped** конфиг формы: ключи повторяют структуру данных `T`, значения — {@link FieldConfig}
  * (или вложенный `FormSchema`). Форма конфига, из которой строится {@link GroupNode}.

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

@@ -1,10 +1,10 @@
 import { FormSchema } from './deep-schema';
 import { FormNode } from '../nodes/form-node';
-export type { FormValue, UnknownFormValue, ValidatorFn, AsyncValidatorOptions, AsyncValidatorFn, ValidationError, ErrorFilterOptions, FieldStatus, } from './contracts';
+export type { FormValue, ValidatorFn, AsyncValidatorOptions, AsyncValidatorFn, ValidationError, ErrorFilterOptions, FieldStatus, } from './contracts';
 export type { FieldConfig } from './deep-schema';
-export type { Validator, AsyncValidator, ConditionFn, ValidateOptions, ValidateAsyncOptions, } from './validation-schema';
-export type { FormSchema, ArrayConfig } from './deep-schema';
-export type { FormSchemaNode, SchemaArrayControl, SchemaValidator } from './schema-node';
+export type { Validator, ValidateOptions } from './validation-schema';
+export type { FormSchema } from './deep-schema';
+export type { FormSchemaNode, SchemaArrayControl } from './schema-node';
 export type { FormControlsProxy, FormProxy, FormArrayProxy } from './form-proxy';
 /**
  * Конфигурация GroupNode.
@@ -25,20 +25,6 @@ export interface GroupNodeConfig<T> {
  * @internal
  */
 export type UnknownRecord = Record<string, unknown>;
-/**
- * Интерфейс для узлов с методом applyValidationSchema
- * @internal
- */
-export interface WithValidationSchema {
-    applyValidationSchema(schemaFn: unknown): void;
-}
-/**
- * Интерфейс для узлов с методом applyBehaviorSchema
- * @internal
- */
-export interface WithBehaviorSchema {
-    applyBehaviorSchema(schemaFn: unknown): void;
-}
 /**
  * Интерфейс для узлов, похожих на ArrayNode (с методом at)
  * Используется для duck typing при обходе путей
@@ -63,29 +49,9 @@ export interface ConfigWithSchema {
 export interface ConfigWithValue {
     value: unknown;
 }
-/**
- * Тип для путей к полям (field paths)
- * Используется в навигации по полям вместо any
- * @internal
- */
-export type FieldPathSegment = {
-    key: string;
-    index?: number;
-};
-/**
- * Тип для коллбэков и обработчиков событий
- * Используется вместо (...args: any[]) => any
- * @internal
- */
-export type UnknownCallback = (...args: unknown[]) => unknown;
 /**
  * Тип для проверки на функцию в conditional types
  * Используется вместо Function для type narrowing
  * @internal
  */
 export type AnyFunction = (...args: never[]) => unknown;
-/**
- * Тип для результатов загрузки ресурсов
- * @internal
- */
-export type ResourceLoadResult = unknown;

package/dist/form/types/schema-node.d.ts

@@ -1,14 +1,5 @@
 import { ElementType } from 'react';
-import { ValidationError } from './contracts';
-/**
- * Валидатор поля схемы (legacy). Дерево-движок, вызывавший `validators` узла как
- * `(value, scope, root)`, удалён — живые правила это `Rule<T>` в `validate(sig, [...])`
- * (`@reformer/core/validation`). Тип остаётся широким по параметрам для совместимости
- * узлов, всё ещё несущих `validators` (гетерогенные контракты `ValidatorFn`/`Validator`).
- *
- * @group Types
- */
-export type SchemaValidator = (value: any, ...rest: any[]) => ValidationError | null | Promise<ValidationError | null>;
+import { Signal } from '../../signals';
 /**
  * Минимальный контракт реактивного массива модели ({@link FormSchemaNode.array}).
  * Совпадает по форме с рантайм-фасадом `model.<array>` (см. `ModelArray`); рендерерский
@@ -55,19 +46,25 @@ export interface FormSchemaNode {
     component?: ElementType;
     /** Props компонента. Также «клапан» для вложенности под-узлов (напр. steps визарда). */
     componentProps?: Record<string, unknown>;
-    validators?: SchemaValidator[];
-    asyncValidators?: SchemaValidator[];
     updateOn?: 'change' | 'blur' | 'submit';
     disabled?: boolean;
     /** Задержка (мс) перед запуском асинхронной валидации. */
     debounce?: number;
     /** Идентификатор узла (для wizard/tabs/renderBehavior). */
     selector?: string;
+    /**
+     * ⚠️ Рантайм этого поля НЕ ЧИТАЕТ — `renderer-react` берёт testId из `componentProps.testId`
+     * (иначе выводит из пути сигнала). Поле оставлено только потому, что `RenderSchemaNode`
+     * рендерера объявляет свой одноимённый; пишите `componentProps: { testId: '…' }`.
+     */
     testId?: string;
-    /** Дочерние узлы (даёт контекстную типизацию вложенным литералам — value/validators/when). */
-    children?: readonly FormSchemaNode[];
-    /** Условие включения поддерева (branch-узел `{ when, children }`). */
-    when?: (scope: any, root: any) => boolean;
+    /**
+     * Содержимое узла: под-узлы (даёт контекстную типизацию вложенным литералам — value/validators/when)
+     * и текстовые части. Текст (литерал, число, сигнал модели) — такой же ребёнок, как узел: core его
+     * не интерпретирует (обход пропускает примитивы и не спускается внутрь сигнала), а рендерер
+     * выводит на своём месте в порядке следования.
+     */
+    children?: readonly (FormSchemaNode | string | number | Signal<any>)[];
     /** Реактивный массив модели (`model.<path>`) — маркер узла-массива (вместе с `item`). */
     array?: SchemaArrayControl;
     /** Схема элемента массива: под-модель элемента → узел поддерева. */

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

@@ -11,22 +11,6 @@ import { FormModel } from '../../state/types';
  * обратной совместимости (`SchemaValidator`-union).
  */
 export type Validator<TForm, TField> = (value: TField, scope: unknown, root: FormModel<TForm>) => ValidationError | null;
-/**
- * Чистый асинхронный валидатор поля. Та же тройка аргументов `(value, scope, root)`, что у
- * {@link Validator}, но возвращает `Promise`.
- *
- * @deprecated Осиротевший остаток удалённого оператора `validateAsync` (Ф7). Рантаймом не
- * потребляется — живой async-путь узла поля использует `AsyncValidatorFn` `(value, { signal })`.
- * Экспортируется только ради обратной совместимости.
- */
-export type AsyncValidator<TForm, TField> = (value: TField, scope: unknown, root: FormModel<TForm>) => Promise<ValidationError | null>;
-/**
- * Функция-предикат `(value) => boolean`.
- *
- * @deprecated Осиротевший остаток удалённого оператора `applyWhen` (Ф7). Рантаймом не
- * потребляется; экспортируется только ради обратной совместимости.
- */
-export type ConditionFn<T> = (value: T) => boolean;
 /**
  * Опции валидатора-фабрики (`required()`/`pattern()`/…). Передаются вторым (или последним)
  * аргументом в фабрику и попадают в возвращаемую {@link ValidationError}.
@@ -38,12 +22,3 @@ export interface ValidateOptions {
     /** Параметры ошибки (подстановка в шаблон сообщения / i18n). */
     params?: Record<string, FormValue>;
 }
-/**
- * @deprecated Осиротевший остаток удалённого оператора `validateAsync` (Ф7): опция `debounce`
- * подключалась тем оператором, которого больше нет. Рантаймом не потребляется; экспортируется
- * только ради обратной совместимости.
- */
-export interface ValidateAsyncOptions extends ValidateOptions {
-    /** Задержка перед выполнением валидации (в мс). */
-    debounce?: number;
-}

package/dist/form/unique-id.d.ts

@@ -25,10 +25,6 @@ export declare const SubscriptionKey: {
     readonly LinkFields: "linkFields";
     /** GroupNode.watchField() */
     readonly WatchField: "watchField";
-    /** ArrayNode.watchItems() */
-    readonly WatchItems: "watchItems";
-    /** ArrayNode.watchLength() */
-    readonly WatchLength: "watchLength";
 };
 export type SubscriptionKeyType = (typeof SubscriptionKey)[keyof typeof SubscriptionKey];
 /**
@@ -37,17 +33,13 @@ export type SubscriptionKeyType = (typeof SubscriptionKey)[keyof typeof Subscrip
  * @param prefix - Префикс для идентификатора (используйте {@link SubscriptionKey}).
  * @returns Уникальный идентификатор в формате `${prefix}-${counter}`.
  *
+ * ⚠️ `SubscriptionKey`/`SubscriptionKeyType` — внутренние: барель `@reformer/core` их не отдаёт,
+ * поэтому вызвать `uniqueId` извне пакета типобезопасно нельзя. Пример ниже — внутрипакетный.
+ *
  * @example
  * ```typescript
- * import { uniqueId, SubscriptionKey } from '@reformer/core';
- *
  * uniqueId(SubscriptionKey.WatchField); // → 'watchField-1'
  * uniqueId(SubscriptionKey.WatchField); // → 'watchField-2'
  * ```
  */
 export declare function uniqueId(prefix: SubscriptionKeyType): string;
-/**
- * Сбросить счётчик (только для тестов)
- * @internal
- */
-export declare function resetUniqueIdCounter(): void;

package/dist/form/validators.d.ts

@@ -1,6 +1,11 @@
 /**
- * Re-export validators from the main index to ensure single module instance.
- * This prevents static registry isolation issues when consuming the library.
+ * Точка входа сабпата `@reformer/core/validators` — все фабрики правил одним импортом.
+ *
+ * Гранулярные сабпаты (`@reformer/core/validators/required` и ещё 21) собираются отдельными
+ * entry для tree-shaking; этот модуль отдаёт полный набор для случаев, когда правил много.
+ *
+ * Ранее здесь был ещё и default-экспорт (`validators` из корневого `index`), заведённый как
+ * часть бандл-фикса «shared static registry». Реестров, ради которых он существовал, в коде
+ * больше нет, чанк-шаринг он не обеспечивал, потребителей не имел — удалён в 7.0.
  */
-export { validators as default } from '../index';
 export * from './validation/index';

package/dist/index.d.ts

@@ -8,4 +8,4 @@ export * from './form/types/index';
 export * from './form/factories/index';
 export * from './state/index';
 export * from './form/index';
-export * as validators from './form/validation/index';
+export { CORE_RUNTIME_TOKEN } from './runtime-token';