@reformer/core 8.0.0 → 9.0.0-beta.2

package/dist/core/utils/type-guards.d.ts

@@ -2,7 +2,7 @@ import { FormNode } from '../nodes/form-node';
 import { FieldNode } from '../nodes/field-node';
 import { GroupNode } from '../nodes/group-node';
 import { ArrayNode } from '../nodes/array-node';
-import { FormFields, FormValue } from '../types';
+import { FormValue } from '../types';
 /**
  * Проверить, является ли значение любым FormNode
  *
@@ -61,7 +61,7 @@ export declare function isFieldNode(value: unknown): value is FieldNode<FormValu
  * }
  * ```
  */
-export declare function isGroupNode(value: unknown): value is GroupNode<FormFields>;
+export declare function isGroupNode(value: unknown): value is GroupNode<object>;
 /**
  * Проверить, является ли значение ArrayNode (массив форм)
  *
@@ -80,7 +80,7 @@ export declare function isGroupNode(value: unknown): value is GroupNode<FormFiel
  * }
  * ```
  */
-export declare function isArrayNode(value: unknown): value is ArrayNode<FormFields>;
+export declare function isArrayNode(value: unknown): value is ArrayNode<object>;
 /**
  * Получить тип узла как строку (для отладки)
  *

package/dist/core/validation/validators/date-utils.d.ts

@@ -21,6 +21,10 @@ export declare function getToday(): Date;
  */
 export declare function normalizeDate(date: Date): Date;
 /**
- * Вычисляет возраст на основе даты рождения
+ * Вычисляет полный возраст (в годах) по календарным полям.
+ *
+ * Считаем по годам/месяцам/дням, а не делением миллисекунд на усреднённый год (365.25 дн): усреднение
+ * даёт off-by-one на границе — в день N-летия накопленных реальных дней меньше `N * 365.25`, и `floor`
+ * роняет возраст до `N - 1` (т.е. `minAge(18)` ошибочно отклонял 18-летнего в его день рождения).
  */
 export declare function calculateAge(birthDate: Date): number;

package/dist/core/validation/validators/integer.d.ts

@@ -19,4 +19,4 @@ import { Validator, ValidateOptions } from '../../types/validation-schema';
  * },
  * ```
  */
-export declare function integer<TForm = unknown, TField extends number | undefined = number>(options?: ValidateOptions): Validator<TForm, TField>;
+export declare function integer<TForm = unknown, TField extends number | null | undefined = number>(options?: ValidateOptions): Validator<TForm, TField>;

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

@@ -21,4 +21,4 @@ import { Validator, ValidateOptions } from '../../types/validation-schema';
  * },
  * ```
  */
-export declare function isNumber<TForm = unknown, TField extends number | undefined = number>(options?: ValidateOptions): Validator<TForm, TField>;
+export declare function isNumber<TForm = unknown, TField extends number | null | undefined = number>(options?: ValidateOptions): Validator<TForm, TField>;

package/dist/core/validation/validators/max.d.ts

@@ -22,4 +22,4 @@ import { Validator, ValidateOptions } from '../../types/validation-schema';
  * },
  * ```
  */
-export declare function max<TForm = unknown, TField extends number | undefined = number>(maxValue: number, options?: ValidateOptions): Validator<TForm, TField>;
+export declare function max<TForm = unknown, TField extends number | null | undefined = number>(maxValue: number, options?: ValidateOptions): Validator<TForm, TField>;

package/dist/core/validation/validators/min.d.ts

@@ -22,4 +22,4 @@ import { Validator, ValidateOptions } from '../../types/validation-schema';
  * },
  * ```
  */
-export declare function min<TForm = unknown, TField extends number | undefined = number>(minValue: number, options?: ValidateOptions): Validator<TForm, TField>;
+export declare function min<TForm = unknown, TField extends number | null | undefined = number>(minValue: number, options?: ValidateOptions): Validator<TForm, TField>;

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

@@ -21,4 +21,4 @@ import { Validator, ValidateOptions } from '../../types/validation-schema';
  * },
  * ```
  */
-export declare function multipleOf<TForm = unknown, TField extends number | undefined = number>(divisor: number, options?: ValidateOptions): Validator<TForm, TField>;
+export declare function multipleOf<TForm = unknown, TField extends number | null | undefined = number>(divisor: number, options?: ValidateOptions): Validator<TForm, TField>;

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

@@ -19,4 +19,4 @@ import { Validator, ValidateOptions } from '../../types/validation-schema';
  * },
  * ```
  */
-export declare function nonNegative<TForm = unknown, TField extends number | undefined = number>(options?: ValidateOptions): Validator<TForm, TField>;
+export declare function nonNegative<TForm = unknown, TField extends number | null | undefined = number>(options?: ValidateOptions): Validator<TForm, TField>;

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

@@ -19,4 +19,4 @@ import { Validator, ValidateOptions } from '../../types/validation-schema';
  * },
  * ```
  */
-export declare function nonZero<TForm = unknown, TField extends number | undefined = number>(options?: ValidateOptions): Validator<TForm, TField>;
+export declare function nonZero<TForm = unknown, TField extends number | null | undefined = number>(options?: ValidateOptions): Validator<TForm, TField>;

package/dist/core/validation/validators/required.d.ts

@@ -4,7 +4,8 @@ import { Validator, ValidateOptions } from '../../types/validation-schema';
  *
  * Возвращает чистую функцию-валидатор `(value, control, root)`. Передаётся в `validate()`.
  *
- * Пустыми считаются: `null`, `undefined`, `''` (пустая строка).
+ * Пустыми считаются: `null`, `undefined`, `''` (пустая строка), `[]` (пустой массив —
+ * обязательный multi-select / FormArray без выбранных элементов).
  * Для boolean полей требуется значение `true`.
  *
  * @param options - Опции валидатора ({@link ValidateOptions}): `message`, `params`

package/dist/{date-utils-xUWFslTj.js → date-utils-dTT_x_Be.js}

@@ -1,4 +1,4 @@
-function r(t) {
+function i(t) {
   if (t == null || t === "")
     return null;
   if (t instanceof Date)
@@ -9,21 +9,23 @@ function r(t) {
   }
   return null;
 }
-function e() {
+function s() {
   const t = /* @__PURE__ */ new Date();
   return t.setHours(0, 0, 0, 0), t;
 }
-function o(t) {
+function a(t) {
   const n = new Date(t);
   return n.setHours(0, 0, 0, 0), n;
 }
-function i(t) {
-  const n = e();
-  return Math.floor((n.getTime() - t.getTime()) / (365.25 * 24 * 60 * 60 * 1e3));
+function c(t) {
+  const n = s(), e = a(t);
+  let r = n.getFullYear() - e.getFullYear();
+  const o = n.getMonth() - e.getMonth();
+  return (o < 0 || o === 0 && n.getDate() < e.getDate()) && (r -= 1), r;
 }
 export {
-  i as c,
-  e as g,
-  o as n,
-  r as p
+  c,
+  s as g,
+  a as n,
+  i as p
 };

package/dist/hooks/types.d.ts

@@ -190,7 +190,21 @@ export interface FieldControlState<T> {
      * );
      * ```
      */
-    componentProps: Record<string, any>;
+    componentProps: Record<string, unknown>;
+    /**
+     * Флаг изменения поля.
+     * `true` когда значение поля отличается от начального.
+     *
+     * Реактивный аналог `control.dirty` — паритет с {@link ArrayControlState.dirty}.
+     *
+     * @example
+     * ```tsx
+     * const { dirty } = useFormControl(field);
+     *
+     * return dirty ? <span className="badge">Изменено</span> : null;
+     * ```
+     */
+    dirty: boolean;
 }
 /**
  * Состояние массива формы, возвращаемое хуком {@link useFormControl} для {@link ArrayNode}.
@@ -325,4 +339,20 @@ export interface ArrayControlState<T> {
      * ```
      */
     dirty: boolean;
+    /**
+     * Флаг отключения массива.
+     * `true` когда массив отключён (`ArrayNode.disable()`), в том числе через
+     * распространение disable от родительской группы.
+     *
+     * Используйте для отключения UI-действий добавления/удаления, когда массив
+     * структурно неизменяем.
+     *
+     * @example
+     * ```tsx
+     * const { disabled } = useFormControl(itemsArray);
+     *
+     * return <button disabled={disabled} onClick={() => control.push()}>Add</button>;
+     * ```
+     */
+    disabled: boolean;
 }

package/dist/hooks/useArrayLength.d.ts

@@ -1,5 +1,4 @@
 import { ArrayNode } from '../core/nodes/array-node';
-import { FormFields } from '../core/types';
 /**
  * React-хук для подписки только на длину массива.
  *
@@ -28,4 +27,4 @@ import { FormFields } from '../core/types';
  *
  * @group React Hooks
  */
-export declare function useArrayLength<T extends FormFields>(control: ArrayNode<T>): number;
+export declare function useArrayLength<T extends object>(control: ArrayNode<T>): number;

package/dist/hooks/useFormControl.d.ts

@@ -1,6 +1,6 @@
 import { FieldNode } from '../core/nodes/field-node';
 import { ArrayNode } from '../core/nodes/array-node';
-import { FormValue, FormFields } from '../core/types';
+import { FormValue } from '../core/types';
 import { FieldControlState, ArrayControlState } from './types';
 /**
  * React-хук для подписки на состояние {@link ArrayNode}.
@@ -11,7 +11,7 @@ import { FieldControlState, ArrayControlState } from './types';
  *
  * @group React Hooks
  */
-export declare function useFormControl<T extends FormFields>(control: ArrayNode<T> | undefined): ArrayControlState<T>;
+export declare function useFormControl<T extends object>(control: ArrayNode<T> | undefined): ArrayControlState<T>;
 /**
  * React-хук для подписки на состояние {@link FieldNode}.
  *

package/dist/hooks/useSignalSubscription.d.ts

@@ -14,4 +14,11 @@ export interface SignalConfig<K extends string> {
  * Хук для подписки на набор сигналов с кешированием
  * @internal
  */
-export declare function useSignalSubscription<TSignals extends SignalMap, TSnapshot extends ExtractSignalValues<TSignals>>(signals: TSignals, configs: SignalConfig<Extract<keyof TSignals, string>>[], buildSnapshot: (values: ExtractSignalValues<TSignals>) => TSnapshot): TSnapshot;
+export declare function useSignalSubscription<TSignals extends SignalMap, TSnapshot extends ExtractSignalValues<TSignals>>(signals: TSignals, configs: SignalConfig<Extract<keyof TSignals, string>>[], buildSnapshot: (values: ExtractSignalValues<TSignals>) => TSnapshot, 
+/**
+ * Стабильная идентичность подписки (обычно сам узел-контрол). subscribe/getSnapshot
+ * пересоздаются ТОЛЬКО при её смене, а не на каждом рендере — как у useFormControlValue,
+ * который ключует по `[control]`. Это убирает per-render churn (dispose+recreate preact-effect),
+ * сохраняя реактивность при подмене контрола на другой узел.
+ */
+subscriptionKey?: unknown): TSnapshot;