indicator-ui 1.1.41 → 1.1.43

package/dist/index.js

@@ -15956,15 +15956,15 @@ function iie(r = {}) {
     const be = await W(oe);
     return T(), be;
   }, me = async (oe) => {
-    let be = !0;
+    let be = !1;
     for (const $e of oe) {
       const Xe = await W($e);
-      be &&= Xe;
+      be ||= Xe;
     }
     return T(), be;
   }, H = async () => {
     const oe = await x().validateAllFields();
-    return g().setErrors(oe), T(), oe.length === 0;
+    return g().setErrors(oe), T(), oe.length > 0;
   }, Z = (oe) => x().isValid(oe), ee = async (oe) => {
     let be = !0;
     for (const $e of oe)

package/dist/types/src/hooks/forms/lib/createFormServices.d.ts

@@ -27,4 +27,4 @@ export declare function createFormServices<T, F = Nullable<Undefinable<T>>>(deps
     highlightField: <P extends ExtendFormPath<F>>(path: P) => Promise<boolean>;
     highlightFields: (paths: ExtendFormPath<F>[]) => Promise<boolean>;
     highlightFormErrors: () => Promise<boolean>;
-}): UseFormServices<T, F>;
+}): UseFormServices<T>;

package/dist/types/src/hooks/forms/types/scheme.d.ts

@@ -67,7 +67,7 @@ export type ArrayFieldValidators = Partial<{
     /** Максимальное количество элементов в массиве */
     maxItemCount: number;
 }>;
-export type FormValidateCustomFunType<T, F> = (value: F | undefined, services: UseFormServices<T>) => Promise<FormErrorType> | FormErrorType;
+export type FormValidateCustomFunType<T, F> = (value: F | null | undefined, services: UseFormServices<T>) => Promise<FormErrorType> | FormErrorType;
 export type BaseFieldValidators<T, F> = Partial<{
     /** Поле обязательное */
     required: ValidatorOption<boolean>;

package/dist/types/src/hooks/forms/types/services.d.ts

@@ -1,7 +1,7 @@
 import { ExtendFormPath, FormErrorsType, FormErrorType, FormPath, FormValue } from './formTypes';
 import { Form } from '../classes';
 import { Nullable, Undefinable } from '../../../types';
-export type UseFormServices<T, F = Nullable<Undefinable<T>>> = {
+export type UseFormServices<T> = Nullable<Undefinable<T>> extends infer F ? {
     /** Работа с данными формы */
     form: {
         /** Получить актуальные данные формы */
@@ -56,4 +56,4 @@ export type UseFormServices<T, F = Nullable<Undefinable<T>>> = {
         /** Подсветить все ошибки формы */
         form: () => Promise<boolean>;
     };
-};
+} : never;

package/dist/types/src/hooks/forms/useForm.d.ts

@@ -9,212 +9,19 @@ type PropsType<Form, T> = {
     useInstanceRefApi?: boolean;
     initFormData?: T;
     scheme?: FormSchemeType<T>;
-    onSubmit?: (data: Form, event: React.SubmitEvent<HTMLFormElement>, services: UseFormServices<Form, T>) => void | Promise<void>;
+    onSubmit?: (data: Form, event: React.SubmitEvent<HTMLFormElement>, services: UseFormServices<Form>) => void | Promise<void>;
     /** Callback при ошибки валидации полей */
     onSubmitError?: (event: {
         errors: FormErrorsType<T>;
-    }, services: UseFormServices<Form, T>) => void;
-    onSubmitAttempt?: (data: T | undefined | null, event: React.SubmitEvent<HTMLFormElement>, services: UseFormServices<Form, T>) => void;
+    }, services: UseFormServices<Form>) => void;
+    onSubmitAttempt?: (data: T | undefined | null, event: React.SubmitEvent<HTMLFormElement>, services: UseFormServices<Form>) => void;
     watch?: FormWatchType<Form>;
     /** Отключить вызов watch-коллбэков для родительских путей при изменении вложенного поля */
     offWatchDeep?: boolean;
     /** Debounce в мс для реактивной ревалидации при изменении поля с ошибкой. Полезно при async-валидаторах */
     revalidateDebounce?: number;
 };
-/**
- * `useForm` — типобезопасный хук для управления состоянием и валидации форм.
- *
- * Предоставляет:
- * - централизованное управление данными формы;
- * - декларативную регистрацию полей;
- * - схемную и кастомную валидацию;
- * - контролируемый submit lifecycle;
- * - безопасный императивный API (`services`) для бизнес-логики.
- *
- * ---
- * ## 🧠 Основная идея
- *
- * Хук полностью управляет состоянием формы и ошибками,
- * а наружу отдаёт:
- * - **декларативный API** (`register`, `registerForm`);
- * - **императивные команды** (clear, validate, highlight);
- * - **изолированные сервисы** для submit-логики.
- *
- * ---
- * ## 🔁 Submit lifecycle
- *
- * Порядок вызова callbacks при submit:
- *
- * 1. `onSubmitAttempt` — всегда
- * 2. Валидация формы
- * 3. `onSubmit` — если форма валидна
- * 4. `onSubmitError` — если есть ошибки
- *
- * ---
- * ## 🔌 Callbacks
- *
- * Все callbacks получают объект `services` —
- * стабильный набор команд для работы с формой
- * (без реактивных значений и возможности вызвать submit повторно).
- *
- * ---
- * ## 📥 Входные параметры
- *
- * | Параметр | Тип | Описание |
- * |---------|-----|----------|
- * | `initFormData` | `T` | Начальные данные формы |
- * | `scheme` | `FormSchemeType<T>` | Схема валидации |
- * | `onSubmitAttempt` | `(data, event, services) => void` | Вызывается при любой попытке submit |
- * | `onSubmit` | `(data, event, services) => void \| Promise<void>` | Вызывается при успешной валидации |
- * | `onSubmitError` | `({ errors }, services) => void` | Вызывается при ошибках валидации |
- *
- * ---
- * ## 📤 Возвращаемое API
- *
- * | Поле | Тип | Назначение |
- * |------|-----|------------|
- * | `formData` | `T` | Реактивные данные формы |
- * | `errors` | `FormErrorsType<T>` | Реактивные ошибки |
- * | `register` | `(path, config?) => FieldProps` | Регистрация поля |
- * | `registerForm` | `() => form props` | Подключение `<form>` |
- * | `setFormData` | `(data) => void` | Полная замена данных формы |
- * | `getFormData` | `() => T` | Получить актуальные данные |
- * | `getField` | `(path) => value` | Получить значение поля |
- * | `getFieldSync` | `(path) => value` | Получить актуальное значение поля |
- * | `setField` | `(path, value) => void` | Установить значение поля |
- * | `getError` | `(path) => error` | Получить ошибку поля |
- * | `setError` | `(path, error) => void` | Установить ошибку поля |
- * | `clearField` | `(path \| paths) => void` | Очистить поле(я) |
- * | `clearForm` | `() => void` | Очистить форму |
- * | `clearErrors` | `() => void` | Очистить все ошибки |
- * | `highlightField` | `(path) => Promise<boolean>` | Валидировать поле с ошибками |
- * | `highlightFields` | `(paths) => Promise<boolean>` | Валидировать несколько полей |
- * | `highlightFormErrors` | `() => Promise<boolean>` | Валидировать всю форму |
- * | `isFieldValid` | `(path) => Promise<boolean>` | Проверка поля без ошибок |
- * | `areFieldsValid` | `(paths) => Promise<boolean>` | Проверка полей без ошибок |
- * | `isFormValid` | `() => Promise<boolean>` | Проверка формы без ошибок |
- * | `getValidForm` | `() => Promise<T \| null>` | Получить форму, если валидна |
- * | `submitForm` | `() => void` | Программный submit |
- * | `resetForm` | `() => void` | Программный reset |
- *
- * ---
- * ## 🛠 `services`
- *
- * `services` доступны **только внутри submit-callbacks**
- * и предоставляют императивный API:
- *
- * - `form` — чтение и замена данных формы;
- * - `fields` — работа с полями;
- * - `errors` — управление ошибками;
- * - `validation` — проверки без side-effects;
- * - `highlight` — валидация с обновлением ошибок.
- *
- * ---
- ;
- * @example
- *
- * ```tsx
- * type FormType = {
- *   phone: string;
- *   message: string;
- *   selects: {
- *     category: 'a' | 'b' | 'c';
- *     tags: ('a' | 'b' | 'c')[];
- *   };
- *   settings: [
- *     { enabled: boolean },
- *     { mode: { value: string } },
- *   ];
- * };
- *
- * const scheme: FormSchemeType<FormType> = {
- *   phone: {
- *     required: { setting: true, message: 'Обязательное поле' },
- *     custom: value =>
- *       value && value.length > 5 ? false : 'Некорректный номер',
- *   },
- *
- *   message: {
- *     noSpace: true,
- *     custom: (value, options) => {
- *       const enabled = options.getField('settings[0].enabled');
- *       return enabled && !value
- *         ? 'Сообщение обязательно'
- *         : false;
- *     },
- *   },
- *
- *   'selects.category': {
- *     required: true,
- *   },
- * };
- *
- * export function ExampleForm() {
- *   const {
- *     formData,
- *     register,
- *     registerForm,
- *     highlightField,
- *     isFormValid,
- *   } = useForm<FormType>({
- *     scheme,
- *
- *     onSubmitAttempt: (data, event, services) => {
- *       console.log('Submit attempt:', data);
- *     },
- *
- *     onSubmit: async (data, event, services) => {
- *       // бизнес-валидация без UI-эффектов
- *       const isValid = await services.validation.isFormValid();
- *       if (!isValid) return;
- *
- *       console.log('Submit success:', data);
- *     },
- *
- *     onSubmitError: ({ errors }, services) => {
- *       // UI-валидация с подсветкой
- *       services.highlight.form();
- *       console.log('Submit errors:', errors);
- *     },
- *   });
- *
- *   return (
- *     <form {...registerForm()}>
- *
- *       <input {...register('phone')} />
- *
- *       <textarea {...register('message')} />
- *
- *       <select {...register('selects.category')}>
- *         <option value="a">A</option>
- *         <option value="b">B</option>
- *         <option value="c">C</option>
- *       </select>
- *
- *       <input
- *         type="checkbox"
- *         {...register('settings[0].enabled')}
- *       />
- *
- *       <input {...register('settings[1].mode.value')} />
- *
- *       <button type="button" onClick={() => highlightField('phone')}>
- *         Validate phone
- *       </button>
- *
- *       <button type="submit">Submit</button>
- *
- *       <pre>{JSON.stringify(formData, null, 2)}</pre>
- *
- *     </form>
- *   );
- * }
- * ```
- *
- * ---
- * @template Form Полный тип формы
- * @template T Тип начальных данных
- */
+/** @see {@link UseFormDocs} */
 export declare function useForm<TForm, TFormNullable extends Nullable<Undefinable<TForm>> = Nullable<Undefinable<TForm>>>(props?: PropsType<TForm, TFormNullable>): {
     formData: TFormNullable | undefined;
     setFormData: (formData: TFormNullable) => void;

package/dist/types/src/hooks/forms/useForm.docs.d.ts

@@ -0,0 +1,191 @@
+/**
+ * `useForm` — типобезопасный хук для управления состоянием и валидации форм.
+ *
+ * Предоставляет:
+ * - централизованное управление данными формы;
+ * - декларативную регистрацию полей;
+ * - схемную и кастомную валидацию;
+ * - контролируемый submit lifecycle;
+ * - безопасный императивный API (`services`) для бизнес-логики.
+ *
+ * ---
+ * ## Основная идея
+ *
+ * Хук полностью управляет состоянием формы и ошибками,
+ * а наружу отдаёт:
+ * - **декларативный API** (`register`, `registerForm`);
+ * - **императивные команды** (clear, validate, highlight);
+ * - **изолированные сервисы** для submit-логики.
+ *
+ * ---
+ * ## Submit lifecycle
+ *
+ * Порядок вызова callbacks при submit:
+ *
+ * 1. `onSubmitAttempt` — всегда
+ * 2. Валидация формы
+ * 3. `onSubmit` — если форма валидна
+ * 4. `onSubmitError` — если есть ошибки
+ *
+ * ---
+ * ## Callbacks
+ *
+ * Все callbacks получают объект `services` —
+ * стабильный набор команд для работы с формой
+ * (без реактивных значений и возможности вызвать submit повторно).
+ *
+ * ---
+ * ## Входные параметры
+ *
+ * | Параметр | Тип | Описание |
+ * |---------|-----|----------|
+ * | `initFormData` | `T` | Начальные данные формы |
+ * | `scheme` | `FormSchemeType<T>` | Схема валидации |
+ * | `onSubmitAttempt` | `(data, event, services) => void` | Вызывается при любой попытке submit |
+ * | `onSubmit` | `(data, event, services) => void \| Promise<void>` | Вызывается при успешной валидации |
+ * | `onSubmitError` | `({ errors }, services) => void` | Вызывается при ошибках валидации |
+ *
+ * ---
+ * ## Возвращаемое API
+ *
+ * | Поле | Тип | Назначение |
+ * |------|-----|------------|
+ * | `formData` | `T` | Реактивные данные формы |
+ * | `errors` | `FormErrorsType<T>` | Реактивные ошибки |
+ * | `register` | `(path, config?) => FieldProps` | Регистрация поля |
+ * | `registerForm` | `() => form props` | Подключение `<form>` |
+ * | `setFormData` | `(data) => void` | Полная замена данных формы |
+ * | `getFormData` | `() => T` | Получить актуальные данные |
+ * | `getField` | `(path) => value` | Получить значение поля |
+ * | `getFieldSync` | `(path) => value` | Получить актуальное значение поля |
+ * | `setField` | `(path, value) => void` | Установить значение поля |
+ * | `getError` | `(path) => error` | Получить ошибку поля |
+ * | `setError` | `(path, error) => void` | Установить ошибку поля |
+ * | `clearField` | `(path \| paths) => void` | Очистить поле(я) |
+ * | `clearForm` | `() => void` | Очистить форму |
+ * | `clearErrors` | `() => void` | Очистить все ошибки |
+ * | `highlightField` | `(path) => Promise<boolean>` | Валидировать поле с ошибками |
+ * | `highlightFields` | `(paths) => Promise<boolean>` | Валидировать несколько полей |
+ * | `highlightFormErrors` | `() => Promise<boolean>` | Валидировать всю форму |
+ * | `isFieldValid` | `(path) => Promise<boolean>` | Проверка поля без ошибок |
+ * | `areFieldsValid` | `(paths) => Promise<boolean>` | Проверка полей без ошибок |
+ * | `isFormValid` | `() => Promise<boolean>` | Проверка формы без ошибок |
+ * | `getValidForm` | `() => Promise<T \| null>` | Получить форму, если валидна |
+ * | `submitForm` | `() => void` | Программный submit |
+ * | `resetForm` | `() => void` | Программный reset |
+ *
+ * ---
+ * ## `services`
+ *
+ * `services` доступны **только внутри submit-callbacks**
+ * и предоставляют императивный API:
+ *
+ * - `form` — чтение и замена данных формы;
+ * - `fields` — работа с полями;
+ * - `errors` — управление ошибками;
+ * - `validation` — проверки без side-effects;
+ * - `highlight` — валидация с обновлением ошибок.
+ *
+ * ---
+ * @example
+ *
+ * ```tsx
+ * type FormType = {
+ *   phone: string;
+ *   message: string;
+ *   selects: {
+ *     category: 'a' | 'b' | 'c';
+ *     tags: ('a' | 'b' | 'c')[];
+ *   };
+ *   settings: [
+ *     { enabled: boolean },
+ *     { mode: { value: string } },
+ *   ];
+ * };
+ *
+ * const scheme: FormSchemeType<FormType> = {
+ *   phone: {
+ *     required: { setting: true, message: 'Обязательное поле' },
+ *     custom: value =>
+ *       value && value.length > 5 ? false : 'Некорректный номер',
+ *   },
+ *
+ *   message: {
+ *     noSpace: true,
+ *     custom: (value, options) => {
+ *       const enabled = options.getField('settings[0].enabled');
+ *       return enabled && !value
+ *         ? 'Сообщение обязательно'
+ *         : false;
+ *     },
+ *   },
+ *
+ *   'selects.category': {
+ *     required: true,
+ *   },
+ * };
+ *
+ * export function ExampleForm() {
+ *   const {
+ *     formData,
+ *     register,
+ *     registerForm,
+ *     highlightField,
+ *     isFormValid,
+ *   } = useForm<FormType>({
+ *     scheme,
+ *
+ *     onSubmitAttempt: (data, event, services) => {
+ *       console.log('Submit attempt:', data);
+ *     },
+ *
+ *     onSubmit: async (data, event, services) => {
+ *       const isValid = await services.validation.isFormValid();
+ *       if (!isValid) return;
+ *
+ *       console.log('Submit success:', data);
+ *     },
+ *
+ *     onSubmitError: ({ errors }, services) => {
+ *       services.highlight.form();
+ *       console.log('Submit errors:', errors);
+ *     },
+ *   });
+ *
+ *   return (
+ *     <form {...registerForm()}>
+ *
+ *       <input {...register('phone')} />
+ *
+ *       <textarea {...register('message')} />
+ *
+ *       <select {...register('selects.category')}>
+ *         <option value="a">A</option>
+ *         <option value="b">B</option>
+ *         <option value="c">C</option>
+ *       </select>
+ *
+ *       <input
+ *         type="checkbox"
+ *         {...register('settings[0].enabled')}
+ *       />
+ *
+ *       <input {...register('settings[1].mode.value')} />
+ *
+ *       <button type="button" onClick={() => highlightField('phone')}>
+ *         Validate phone
+ *       </button>
+ *
+ *       <button type="submit">Submit</button>
+ *
+ *       <pre>{JSON.stringify(formData, null, 2)}</pre>
+ *
+ *     </form>
+ *   );
+ * }
+ * ```
+ *
+ * @template Form Полный тип формы
+ * @template T Тип начальных данных
+ */
+export type UseFormDocs = never;

package/package.json

@@ -11,7 +11,7 @@
     "react-components",
     "ui-kit"
   ],
-  "version": "1.1.41",
+  "version": "1.1.43",
   "exports": {
     ".": {
       "types": "./dist/types/index.d.ts",