adaptform 2.1.0 → 2.2.0

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

@@ -1,3 +1,47 @@
+/** Shared mutation boundary; subclasses only describe state and their mutations. */
+declare abstract class ObservableNode<TSnapshot> {
+    private readonly _stateStore;
+    protected abstract captureState(): TSnapshot;
+    protected stateChildren(): readonly ObservableNode<unknown>[];
+    private contains;
+    protected validateAfterMutation(callback: () => unknown): void;
+    protected batchUpdate<TResult>(callback: () => TResult, validate: () => unknown): TResult;
+    subscribe(listener: () => void): () => void;
+    getSnapshot(): TSnapshot;
+    protected update<TResult>(callback: () => TResult): TResult;
+}
+
+/** Snapshots contain data only: mutable built-ins and opaque instances are described. */
+type SnapshotValue = null | undefined | string | number | boolean | bigint | readonly SnapshotValue[] | {
+    readonly [key: string]: SnapshotValue;
+};
+interface NodeSnapshot {
+    readonly isValid: boolean | null;
+    readonly isTouched: boolean;
+    readonly isDirty: boolean;
+}
+interface FieldSnapshot extends NodeSnapshot {
+    readonly rawValue: SnapshotValue;
+    readonly valueClear: SnapshotValue;
+    readonly errors: readonly string[];
+}
+interface FormSnapshot extends NodeSnapshot {
+    readonly fieldsValue: Readonly<Record<string, SnapshotValue>>;
+    readonly allErrors: Readonly<Record<string, readonly string[]>>;
+    readonly globalErrors: Readonly<Record<string, string>>;
+    readonly fields: Readonly<Record<string, FieldSnapshot | ArrayFieldSnapshot | ArrayFormSnapshot>>;
+}
+interface ArrayFieldSnapshot extends NodeSnapshot {
+    readonly itemsValue: readonly SnapshotValue[];
+    readonly errors: readonly string[];
+    readonly items: readonly FieldSnapshot[];
+}
+interface ArrayFormSnapshot extends NodeSnapshot {
+    readonly formsFieldsValue: readonly Readonly<Record<string, SnapshotValue>>[];
+    readonly errors: readonly string[];
+    readonly forms: readonly FormSnapshot[];
+}
+
 interface FieldPlugin<T = any> {
     pluginOptions?: PluginOptions;
     init?(field: Field<T>): void;
@@ -9,15 +53,23 @@ declare abstract class BasePlugin<T = any> implements FieldPlugin<T> {
     constructor(pluginOptions?: PluginOptions);
 }
 
-declare class ArrayField<T = any> {
+declare class ArrayField<T = any> extends ObservableNode<ArrayFieldSnapshot> {
     protected factory: (value?: T) => Field<T>;
+    protected captureState(): ArrayFieldSnapshot;
     protected options: ArrayFieldOptions;
     protected _items: Field<T>[];
     protected _errors: string[];
+    protected stateChildren(): readonly ObservableNode<unknown>[];
+    private _baseline;
     private _hasValidationResult;
-    isTouched: boolean;
+    private _isTouched;
+    get isTouched(): boolean;
+    set isTouched(value: boolean);
     constructor(factory: (value?: T) => Field<T>, options?: ArrayFieldOptions, initial?: (T | null)[]);
+    get isDirty(): boolean;
+    commitBaseline(): void;
     set itemsValue(items: (T | null)[]);
+    setItemsValue(items: (T | null)[], validate?: boolean): void;
     get itemsValue(): (T | null)[];
     get items(): Field<T>[];
     add(value?: T, force_check?: boolean): Field<T>;
@@ -33,14 +85,21 @@ declare class ArrayField<T = any> {
     reset(): void;
 }
 
-declare class ArrayFormField<T extends Form = Form> {
+declare class ArrayFormField<T extends Form = Form> extends ObservableNode<ArrayFormSnapshot> {
     private FormConstructor;
     private options;
+    protected captureState(): ArrayFormSnapshot;
     private _forms;
     private _errors;
+    protected stateChildren(): readonly ObservableNode<unknown>[];
+    private _baseline;
     private _hasValidationResult;
-    isTouched: boolean;
+    private _isTouched;
+    get isTouched(): boolean;
+    set isTouched(value: boolean);
     constructor(FormConstructor: new () => T, options?: ArrayFormFieldOptions, initial?: unknown[]);
+    get isDirty(): boolean;
+    commitBaseline(): void;
     set forms(forms: unknown[]);
     setForms(forms: unknown[], validate?: boolean): void;
     get forms(): T[];
@@ -170,15 +229,21 @@ declare abstract class FieldType<T, O extends FieldOptions = FieldOptions> {
 }
 
 type FieldTypeConstructor<T, O extends FieldOptions = FieldOptions> = new (options: O) => FieldType<T, O>;
-declare class Field<T = any, O extends FieldOptions = FieldOptions> {
+declare class Field<T = any, O extends FieldOptions = FieldOptions> extends ObservableNode<FieldSnapshot> {
     protected _rawValue: any;
     protected _valueClear: T | null;
     protected fieldType: FieldType<T, O>;
     protected defaultValue: T | null;
+    private _baseline;
     protected _errors: string[];
-    isValid: boolean | null;
-    isTouched: boolean;
+    private _isValid;
+    get isValid(): boolean | null;
+    set isValid(value: boolean | null);
+    private _isTouched;
+    get isTouched(): boolean;
+    set isTouched(value: boolean);
     constructor(TypeConstructor: FieldTypeConstructor<T, O>, defaultValue?: T | null, options?: O | null);
+    protected captureState(): FieldSnapshot;
     protected get plugins(): FieldPlugin<any>[];
     get options(): O;
     set options(options: O);
@@ -190,6 +255,8 @@ declare class Field<T = any, O extends FieldOptions = FieldOptions> {
     get error(): string;
     set error(message: string | null);
     get valueClear(): T | null;
+    get isDirty(): boolean;
+    commitBaseline(): void;
     private isRequired;
     checkValid(form?: Form): boolean;
     checkAndSetValid(form?: Form): boolean;
@@ -280,7 +347,10 @@ type FormFieldValue<TField> = TField extends Field<infer TValue, infer _Options>
 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 {
+declare abstract class Form extends ObservableNode<FormSnapshot> {
+    protected captureState(): FormSnapshot;
+    protected stateChildren(): readonly ObservableNode<unknown>[];
+    batch<TResult>(callback: () => TResult & (TResult extends PromiseLike<unknown> ? never : unknown)): TResult;
     private _globalErrors;
     errorsShema: ErrorsSchema;
     protected get _fields(): Record<string, Field<any> | ArrayField<any> | ArrayFormField<any>>;
@@ -305,6 +375,8 @@ declare abstract class Form {
     setGlobalError(key: string, message: string): void;
     clearGlobalErrors(): void;
     reset(): void;
+    get isDirty(): boolean;
+    commitBaseline(): void;
     get isTouched(): boolean;
     get isValid(): boolean;
     toFormData(): FormData;
@@ -312,4 +384,4 @@ declare abstract class Form {
     private serializeJsonValue;
 }
 
-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 };
+export { ArrayField as A, BasePlugin as B, type messagesOptions as C, type DecimalOptions as D, ErrorsSchema as E, Field as F, type messagesStringOptions as G, 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, type ArrayFieldSnapshot as e, ArrayFormField as f, type ArrayFormFieldOptions as g, type ArrayFormSnapshot as h, DefaultErrorsSchema as i, type DynamicRule as j, type FieldOptions as k, type FieldPlugin as l, type FieldSnapshot as m, Form as n, type FormFieldValue as o, type FormFieldsValue as p, type FormSnapshot as q, type NodeSnapshot as r, type ParsedError as s, type SnapshotValue as t, type messagesArrayFieldOptions as u, type messagesArrayFormFieldOptions as v, type messagesBooleanOptions as w, type messagesDateOptions as x, type messagesDecimalOptions as y, type messagesNumberOptions as z };