adaptform 2.0.5 → 2.1.0

package/dist/{Form-Be3I6LX0.d.ts → Form-kPYL4f-n.d.ts}

@@ -14,10 +14,11 @@ declare class ArrayField<T = any> {
     protected options: ArrayFieldOptions;
     protected _items: Field<T>[];
     protected _errors: string[];
+    private _hasValidationResult;
     isTouched: boolean;
-    constructor(factory: (value?: T) => Field<T>, options?: ArrayFieldOptions, initial?: T[]);
-    set itemsValue(items: T[]);
-    get itemsValue(): T[];
+    constructor(factory: (value?: T) => Field<T>, options?: ArrayFieldOptions, initial?: (T | null)[]);
+    set itemsValue(items: (T | null)[]);
+    get itemsValue(): (T | null)[];
     get items(): Field<T>[];
     add(value?: T, force_check?: boolean): Field<T>;
     remove(index: number): void;
@@ -37,12 +38,14 @@ declare class ArrayFormField<T extends Form = Form> {
     private options;
     private _forms;
     private _errors;
+    private _hasValidationResult;
     isTouched: boolean;
-    constructor(FormConstructor: new () => T, options?: ArrayFormFieldOptions, initial?: any[]);
-    set forms(forms: any[]);
-    get forms(): Form[];
-    get formsFieldsValue(): any[];
-    add(data?: any, force_check?: boolean): T;
+    constructor(FormConstructor: new () => T, options?: ArrayFormFieldOptions, initial?: unknown[]);
+    set forms(forms: unknown[]);
+    setForms(forms: unknown[], validate?: boolean): void;
+    get forms(): T[];
+    get formsFieldsValue(): FormFieldsValue<T>[];
+    add(data?: unknown, force_check?: boolean): T;
     remove(index: number): void;
     clear(): void;
     reset(): void;
@@ -181,10 +184,12 @@ declare class Field<T = any, O extends FieldOptions = FieldOptions> {
     set options(options: O);
     get rawValue(): T | null;
     set rawValue(input: any);
+    setRawValue(input: any, validate?: boolean): void;
+    private assignRawValue;
     get errors(): string[];
     get error(): string;
     set error(message: string | null);
-    get valueClear(): any;
+    get valueClear(): T | null;
     private isRequired;
     checkValid(form?: Form): boolean;
     checkAndSetValid(form?: Form): boolean;
@@ -192,92 +197,108 @@ declare class Field<T = any, O extends FieldOptions = FieldOptions> {
     reset(): void;
 }
 
+type ErrorFieldMapping = string | ((errorValue: any) => string);
 interface ParsedError {
     fieldName: string;
     message: string;
     sourceKey: string;
     matchedBy: 'static' | 'dynamic' | 'fallback';
 }
+interface DynamicRule {
+    pattern: RegExp;
+    mapping: ErrorFieldMapping | ((match: RegExpMatchArray, value?: any) => string);
+    priority: number;
+}
 declare class ErrorsSchema {
     private _staticRules;
     private _dynamicRules;
     private _fallbackHandler?;
     private _valueTransformers;
     /**
-     * Добавляет статическое правило - точное соответствие ключа ошибки
-     * @param errorKey - точный ключ ошибки из ответа сервера
-     * @param fieldName - имя поля в форме или функция для динамического определения
+     * Add a static rule that matches an exact error key.
+     * @param errorKey - Exact error key returned by the server.
+     * @param fieldName - Form field name or a function that resolves it dynamically.
      */
     staticKey(errorKey: string, fieldName: string | ((errorValue: any) => string)): this;
     /**
-     * Добавляет динамическое правило с регулярным выражением
-     * @param pattern - регулярное выражение для сопоставления ключа ошибки
-     * @param mapping - имя поля или функция для извлечения имени поля из совпадения
-     * @param options - дополнительные опции (приоритет и т.д.)
+     * Add a dynamic rule using a regular expression.
+     * @param pattern - Regular expression used to match an error key.
+     * @param mapping - Field name or function that derives it from the match.
+     * @param options - Additional options, such as rule priority.
      */
-    dynamicKey(pattern: RegExp, mapping: string | ((match: RegExpMatchArray) => string), options?: {
+    dynamicKey(pattern: RegExp, mapping: string | ((match: RegExpMatchArray, value?: any) => string), options?: {
         priority?: number;
     }): this;
     /**
-     * Устанавливает обработчик для ошибок, которые не подошли ни под одно правило
+     * Set a handler for errors that do not match any rule.
      */
     fallback(handler: (key: string, value: any) => string | null): this;
     /**
-     * Добавляет трансформер для значений ошибок
-     * Полезно для нормализации сообщений (например, если сервер возвращает массив ошибок)
+     * Add a transformer for error values.
+     * Useful for normalizing messages, such as server responses containing arrays.
      */
     transformValue(transformer: (value: any) => any): this;
     /**
-     * Быстрый метод для создания схемы из простого объекта маппинга
+     * Create a schema from a simple mapping object.
      */
     static fromObject(mapping: Record<string, string>): ErrorsSchema;
     /**
-     * Создает схему для массива однотипных форм
+     * Create a schema for an array of similarly structured forms.
      */
     static forArray(itemSchema: ErrorsSchema, arrayFieldName: string, indexExtractor?: (key: string) => number): ErrorsSchema;
     /**
-     * Основной метод парсинга ошибок с поддержкой трансформеров
-     * Поддерживает вложенные структуры через точечную нотацию
+     * Parse errors while applying configured value transformers.
+     * Supports nested structures using dot notation.
      */
     parseErrors(errors: Record<string, any>, prefix?: string): Record<string, string>;
     /**
-     * Парсит ошибки сервера и возвращает расширенную информацию
+     * Parse server errors and return detailed metadata.
      */
     parseErrorsDetailed(errors: Record<string, any>, prefix?: string): Record<string, ParsedError>;
     /**
-     * Создает схему для вложенной формы
+     * Create a schema for a nested form.
      */
     nest(prefix: string): ErrorsSchema;
     /**
-     * Клонирует текущую схему
+     * Clone the current schema.
      */
     clone(): ErrorsSchema;
     /**
-     * Объединяет текущую схему с другой
+     * Merge the current schema with another schema.
      */
     merge(other: ErrorsSchema): ErrorsSchema;
     private isNestedObject;
     private findMappingDetailed;
     private findMapping;
 }
+/**
+ * Default base schema.
+ */
+declare const DefaultErrorsSchema: ErrorsSchema;
 
+type FormFieldValue<TField> = TField extends Field<infer TValue, infer _Options> ? TValue | null : TField extends ArrayField<infer TValue> ? (TValue | null)[] : TField extends ArrayFormField<infer TForm> ? TForm extends Form ? FormFieldsValue<TForm>[] : unknown[] : never;
+type FormFieldsValue<TForm extends Form> = {
+    [K in keyof TForm as TForm[K] extends Field<infer _Value, infer _Options> | ArrayField<infer _ArrayValue> | ArrayFormField<infer _NestedForm> ? K : never]: FormFieldValue<TForm[K]>;
+};
 declare abstract class Form {
     private _globalErrors;
     errorsShema: ErrorsSchema;
     protected get _fields(): Record<string, Field<any> | ArrayField<any> | ArrayFormField<any>>;
     checkValid(form?: this): boolean;
-    get fieldsValue(): Record<string, any>;
-    set fields(data: Record<string, any>);
+    get fieldsValue(): FormFieldsValue<this>;
+    set fields(data: Record<string, unknown>);
+    setFields(data: Record<string, unknown>, validate?: boolean): void;
     get allErrors(): Record<string, string[]>;
     /**
-     * Рекурсивно собирает все ошибки из ArrayFormField
+     * Recursively collect all errors from an ArrayFormField.
      */
     private collectArrayFormErrors;
     get globalErrors(): Record<string, string>;
-    set errors(errors: Record<string, any>);
+    set errors(errors: Record<string, unknown>);
+    private clearErrorsRecursively;
     /**
-     * Применяет ошибку к соответствующему полю
-     * Поддерживает вложенные поля через точечную нотацию
+     * Apply an error to the corresponding field.
+     * Supports nested fields using dot notation.
      */
     private applyErrorToField;
     private applyNestedError;
@@ -287,7 +308,8 @@ declare abstract class Form {
     get isTouched(): boolean;
     get isValid(): boolean;
     toFormData(): FormData;
-    toJSON(): Record<string, any>;
+    toJSON(): Record<string, unknown>;
+    private serializeJsonValue;
 }
 
-export { ArrayField as A, BasePlugin as B, type DecimalOptions as D, Field as F, type MaskPluginOptions as M, type NumberOptions as N, type PluginOptions as P, type StringOptions as S, FieldType as a, type BooleanOptions as b, type DateOptions as c, type ArrayFieldOptions as d, ArrayFormField as e, type ArrayFormFieldOptions as f, type FieldOptions as g, type FieldPlugin as h, Form as i, type messagesArrayFormFieldOptions as j, type messagesBooleanOptions as k, type messagesDateOptions as l, type messagesArrayFieldOptions as m, type messagesDecimalOptions as n, type messagesNumberOptions as o, type messagesOptions as p, type messagesStringOptions as q };
+export { ArrayField as A, BasePlugin as B, type DecimalOptions as D, ErrorsSchema as E, Field as F, type MaskPluginOptions as M, type NumberOptions as N, type PluginOptions as P, type StringOptions as S, FieldType as a, type BooleanOptions as b, type DateOptions as c, type ArrayFieldOptions as d, ArrayFormField as e, type ArrayFormFieldOptions as f, DefaultErrorsSchema as g, type DynamicRule as h, type FieldOptions as i, type FieldPlugin as j, Form as k, type FormFieldValue as l, type FormFieldsValue as m, type ParsedError as n, type messagesArrayFieldOptions as o, type messagesArrayFormFieldOptions as p, type messagesBooleanOptions as q, type messagesDateOptions as r, type messagesDecimalOptions as s, type messagesNumberOptions as t, type messagesOptions as u, type messagesStringOptions as v };