@ekz/formix 2.1.1 → 2.1.2

package/lib/cjs/FieldState.d.ts

@@ -0,0 +1,17 @@
+import type { FieldMetadata, FieldValue, FieldState as IFieldState } from './types';
+export default class FieldState<T> implements IFieldState<T> {
+    readonly value: T;
+    readonly disabled: boolean;
+    readonly active: boolean;
+    readonly touched: boolean;
+    constructor(value: T, disabled: boolean, active: boolean, touched: boolean);
+    updated(fields: Partial<FieldValue<T> & FieldMetadata>): FieldState<T>;
+    /**
+     * `equals` only takes the value and disabled properties into consideration.
+     */
+    equals(other: FieldState<T> | null | undefined): boolean;
+    /**
+     * `hashCode` only takes the value and disabled properties into consideration.
+     */
+    hashCode(): number;
+}

package/lib/cjs/FieldState.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const immutable_1 = require("immutable");
+class FieldState {
+    constructor(value, disabled, active, touched) {
+        this.value = value;
+        this.disabled = disabled;
+        this.active = active;
+        this.touched = touched;
+        this.value = value;
+        this.disabled = disabled;
+        this.active = active;
+        this.touched = touched;
+    }
+    updated(fields) {
+        const o = { value: this.value, ...fields };
+        return new FieldState(o.value, fields.disabled ?? this.disabled, fields.active ?? this.active, fields.touched ?? this.touched);
+    }
+    /**
+     * `equals` only takes the value and disabled properties into consideration.
+     */
+    equals(other) {
+        return other != null && (0, immutable_1.is)(this.value, other.value) && this.disabled === other.disabled;
+    }
+    /**
+     * `hashCode` only takes the value and disabled properties into consideration.
+     */
+    hashCode() {
+        return (0, immutable_1.hash)(this.value) & (0, immutable_1.hash)(this.disabled);
+    }
+}
+exports.default = FieldState;
+//# sourceMappingURL=FieldState.js.map

package/lib/cjs/FieldState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldState.js","sourceRoot":"","sources":["../../src/main/web/FieldState.ts"],"names":[],"mappings":";;AAAA,yCAAqC;AAIrC,MAAqB,UAAU;IAC3B,YACoB,KAAQ,EACR,QAAiB,EACjB,MAAe,EACf,OAAgB;QAHhB,UAAK,GAAL,KAAK,CAAG;QACR,aAAQ,GAAR,QAAQ,CAAS;QACjB,WAAM,GAAN,MAAM,CAAS;QACf,YAAO,GAAP,OAAO,CAAS;QAEhC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,MAA8C;QAClD,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC;QAC3C,OAAO,IAAI,UAAU,CACjB,CAAC,CAAC,KAAK,EACP,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAChC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,EAC5B,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CACjC,CAAC;IACN,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAuC;QAC1C,OAAO,KAAK,IAAI,IAAI,IAAI,IAAA,cAAE,EAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,CAAC;IAC5F,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,OAAO,IAAA,gBAAI,EAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAA,gBAAI,EAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;CACJ;AApCD,6BAoCC"}

package/lib/cjs/fields.d.ts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+import type { ArrayField, ArrayFieldRef, Field, FieldRef, GenericFieldRef } from './types';
+export declare function useField<T>(fieldRef: FieldRef<T>): Field<T>;
+export declare function useArrayField<T extends GenericFieldRef, V>(fieldRef: ArrayFieldRef<T, V>): ArrayField<T, V>;
+type UseFieldProps<T> = {
+    field: FieldRef<T>;
+    render(field: Field<T>): React.ReactNode;
+};
+export declare function UseField<T>(props: UseFieldProps<T>): React.ReactElement;
+type UseArrayFieldProps<T extends GenericFieldRef, V> = {
+    field: ArrayFieldRef<T, V>;
+    render(field: ArrayField<T, V>): React.ReactNode;
+};
+export declare function UseArrayField<T extends GenericFieldRef, V>(props: UseArrayFieldProps<T, V>): React.ReactElement;
+export {};

package/lib/cjs/fields.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useField = useField;
+exports.useArrayField = useArrayField;
+exports.UseField = UseField;
+exports.UseArrayField = UseArrayField;
+const tslib_1 = require("tslib");
+const jsx_runtime_1 = require("react/jsx-runtime");
+const React = tslib_1.__importStar(require("react"));
+const form_1 = require("./form");
+function useField(fieldRef) {
+    const { getFieldState, setFieldState, getValidationResult } = (0, form_1.useForm)();
+    const fieldState = getFieldState(fieldRef);
+    const validationResult = getValidationResult(fieldRef);
+    const setValue = React.useCallback((value) => {
+        setFieldState(fieldRef, (previousState) => {
+            const nextValue = 
+            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+            // @ts-ignore
+            typeof value === 'function' ? value(previousState.value) : value;
+            return previousState.value === nextValue
+                ? previousState
+                : previousState.updated({
+                    value: nextValue,
+                    touched: true
+                });
+        });
+    }, [fieldRef, setFieldState]);
+    const setDisabled = React.useCallback((disabled) => setFieldState(fieldRef, (state) => state.updated({ disabled })), [fieldRef, setFieldState]);
+    const onFocus = React.useCallback(() => setFieldState(fieldRef, (state) => state.updated({ active: true, touched: true })), [fieldRef, setFieldState]);
+    const onBlur = React.useCallback(() => setFieldState(fieldRef, (state) => state.updated({ active: false })), [fieldRef, setFieldState]);
+    return React.useMemo(() => ({
+        value: fieldState.value,
+        ...validationResult,
+        disabled: fieldState.disabled,
+        active: fieldState.active,
+        touched: fieldState.touched,
+        setValue,
+        setDisabled,
+        onFocus,
+        onBlur
+    }), [fieldState, validationResult, setValue, setDisabled, onFocus, onBlur]);
+}
+function useArrayField(fieldRef) {
+    const { getValidationResult } = (0, form_1.useForm)();
+    const { value: items, setValue, disabled, active, touched, setDisabled, onBlur, onFocus } = useField(fieldRef);
+    const validationResult = getValidationResult(fieldRef);
+    const unshift = React.useCallback((value) => {
+        const item = fieldRef.itemTemplate(value);
+        setValue((previous) => previous.unshift(item));
+        return item;
+    }, [setValue, fieldRef]);
+    const push = React.useCallback((value) => {
+        const item = fieldRef.itemTemplate(value);
+        setValue((previous) => previous.push(item));
+        return item;
+    }, [setValue, fieldRef]);
+    const insert = React.useCallback((index, value) => {
+        const item = fieldRef.itemTemplate(value);
+        setValue((items) => items.insert(index, item));
+        return item;
+    }, [setValue, fieldRef]);
+    const remove = React.useCallback((value) => {
+        setValue((previous) => {
+            const index = previous.indexOf(value);
+            return index !== -1 ? previous.remove(index) : previous;
+        });
+    }, [setValue]);
+    const swap = React.useCallback((indexA, indexB) => {
+        setValue((previous) => {
+            const itemA = previous.get(indexA);
+            const itemB = previous.get(indexB);
+            if (itemA == null || itemB == null) {
+                throw new Error('Invalid element access');
+            }
+            return previous
+                .remove(indexA)
+                .insert(indexA, itemB)
+                .remove(indexB)
+                .insert(indexB, itemA);
+        });
+    }, [setValue]);
+    return React.useMemo(() => ({
+        items,
+        ...validationResult,
+        unshift,
+        push,
+        insert,
+        remove,
+        swap,
+        disabled,
+        active,
+        touched,
+        setDisabled,
+        onBlur,
+        onFocus
+    }), [
+        items,
+        validationResult,
+        unshift,
+        push,
+        insert,
+        remove,
+        swap,
+        disabled,
+        active,
+        touched,
+        setDisabled,
+        onBlur,
+        onFocus
+    ]);
+}
+function UseField(props) {
+    const field = useField(props.field);
+    return (0, jsx_runtime_1.jsx)(React.Fragment, { children: props.render(field) });
+}
+function UseArrayField(props) {
+    const field = useArrayField(props.field);
+    return (0, jsx_runtime_1.jsx)(React.Fragment, { children: props.render(field) });
+}
+//# sourceMappingURL=fields.js.map

package/lib/cjs/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../src/main/web/fields.tsx"],"names":[],"mappings":"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"}

package/lib/cjs/form.d.ts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+import type { GenericFieldRef, FormApi, FormWithFields } from './types';
+export declare function FormProvider(props: {
+    children: React.ReactNode;
+}): React.ReactElement;
+export declare function useForm(): FormApi;
+export declare function useFormWithFields<Deps extends unknown[], F extends GenericFieldRef>(fieldsCreator: (...deps: [...Deps]) => F, deps: [...Deps]): FormWithFields<F>;
+export declare function withForm<Props>(Component: React.ComponentType<Props>): React.ComponentType<Props>;
+type UseFormProps = {
+    children: (form: FormApi) => React.ReactNode;
+};
+export declare function UseForm(props: UseFormProps): React.ReactElement;
+export {};

package/lib/cjs/form.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FormProvider = FormProvider;
+exports.useForm = useForm;
+exports.useFormWithFields = useFormWithFields;
+exports.withForm = withForm;
+exports.UseForm = UseForm;
+const tslib_1 = require("tslib");
+const jsx_runtime_1 = require("react/jsx-runtime");
+const immutable_1 = require("immutable");
+const React = tslib_1.__importStar(require("react"));
+const references_1 = require("./references");
+const form_1 = require("./validation/form");
+function useFormApi() {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const [fieldStates, setFieldStates] = React.useState(immutable_1.Map);
+    const getFieldState = React.useCallback(function getFieldState(fieldRef) {
+        return fieldStates.get(fieldRef, fieldRef.initialState);
+    }, [fieldStates]);
+    const getFieldValue = React.useCallback((fieldRef) => getFieldState(fieldRef).value, [getFieldState]);
+    const setFieldState = React.useCallback(function setFieldState(fieldRef, state) {
+        setFieldStates((xs) => typeof state === 'function'
+            ? xs.update(fieldRef, fieldRef.initialState, state)
+            : xs.set(fieldRef, state));
+    }, []);
+    const extract = React.useCallback((fields, type) => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        function extractField(field) {
+            if ((0, references_1.isArrayFieldRef)(field)) {
+                return getFieldState(field).value.map(extractField);
+            }
+            else if ((0, references_1.isFieldRef)(field)) {
+                const state = getFieldState(field);
+                return type === 'value' ? state.value : state;
+            }
+            else {
+                return immutable_1.Seq.Keyed(field)
+                    .map((value) => extractField(value))
+                    .toObject();
+            }
+        }
+        return extractField(fields);
+    }, [getFieldState]);
+    const getStates = React.useCallback((fields) => extract(fields, 'state'), [extract]);
+    const getValues = React.useCallback((fields) => extract(fields, 'value'), [extract]);
+    const reset = React.useCallback(() => setFieldStates((0, immutable_1.Map)()), [setFieldStates]);
+    const modified = React.useMemo(() => {
+        return fieldStates.some((state, fieldRef) => !state.equals(fieldRef.initialState));
+    }, [fieldStates]);
+    const formValidation = (0, form_1.useFormValidation)(getFieldState);
+    return React.useMemo(() => ({
+        getFieldState,
+        getFieldValue,
+        setFieldState,
+        getStates,
+        getValues,
+        reset,
+        modified,
+        ...formValidation
+    }), [
+        getFieldState,
+        getFieldValue,
+        setFieldState,
+        getStates,
+        getValues,
+        reset,
+        modified,
+        formValidation
+    ]);
+}
+function noop() {
+    throw new Error('Cannot call method on empty context. Did you forget <Form />?');
+}
+const FormContext = React.createContext({
+    getFieldState: noop,
+    getFieldValue: noop,
+    setFieldState: noop,
+    getStates: noop,
+    getValues: noop,
+    getValidationResult: noop,
+    registerValidation: noop,
+    isFieldValid: noop,
+    reset: noop,
+    pending: false,
+    valid: false,
+    modified: false
+});
+function FormProvider(props) {
+    const api = useFormApi();
+    return (0, jsx_runtime_1.jsx)(FormContext.Provider, { value: api, children: props.children });
+}
+function useForm() {
+    return React.useContext(FormContext);
+}
+function useFormWithFields(fieldsCreator, deps) {
+    const { reset, ...form } = useForm();
+    const fields = React.useMemo(() => {
+        return fieldsCreator(...deps);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, deps);
+    React.useLayoutEffect(() => {
+        reset();
+    }, [reset, fields]);
+    return React.useMemo(() => ({
+        ...form,
+        reset,
+        fields
+    }), [form, reset, fields]);
+}
+function withForm(Component) {
+    return function WithForm(props) {
+        return ((0, jsx_runtime_1.jsx)(FormProvider, { children: (0, jsx_runtime_1.jsx)(Component, { ...props }) }));
+    };
+}
+function UseForm(props) {
+    const form = useForm();
+    return (0, jsx_runtime_1.jsx)(React.Fragment, { children: props.children(form) });
+}
+//# sourceMappingURL=form.js.map

package/lib/cjs/form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.js","sourceRoot":"","sources":["../../src/main/web/form.tsx"],"names":[],"mappings":"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"}

package/lib/cjs/index.d.ts

@@ -0,0 +1,5 @@
+export { useField, useArrayField, UseField, UseArrayField } from './fields';
+export { FormProvider, UseForm, useForm, useFormWithFields, withForm } from './form';
+export { defineField, isFieldRef, defineArrayField, isArrayFieldRef } from './references';
+export { useAsyncFieldStateValidation, useAsyncFieldValidation, useFieldStateValidation, useFieldValidation } from './validation/fields';
+export type { GenericFieldRef, FieldRef, ArrayFieldRef, Field, ArrayField, FieldValue, FieldState, FieldMetadata, FieldMetadataUpdaters, FormStates, FieldRefStates, FormValues, FieldRefValues, FormApi, FormWithFields, ValidationError, ValidationResult, FieldValidation, FormValidationApi, FormValidations } from './types';

package/lib/cjs/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFieldValidation = exports.useFieldStateValidation = exports.useAsyncFieldValidation = exports.useAsyncFieldStateValidation = exports.isArrayFieldRef = exports.defineArrayField = exports.isFieldRef = exports.defineField = exports.withForm = exports.useFormWithFields = exports.useForm = exports.UseForm = exports.FormProvider = exports.UseArrayField = exports.UseField = exports.useArrayField = exports.useField = void 0;
+var fields_1 = require("./fields");
+Object.defineProperty(exports, "useField", { enumerable: true, get: function () { return fields_1.useField; } });
+Object.defineProperty(exports, "useArrayField", { enumerable: true, get: function () { return fields_1.useArrayField; } });
+Object.defineProperty(exports, "UseField", { enumerable: true, get: function () { return fields_1.UseField; } });
+Object.defineProperty(exports, "UseArrayField", { enumerable: true, get: function () { return fields_1.UseArrayField; } });
+var form_1 = require("./form");
+Object.defineProperty(exports, "FormProvider", { enumerable: true, get: function () { return form_1.FormProvider; } });
+Object.defineProperty(exports, "UseForm", { enumerable: true, get: function () { return form_1.UseForm; } });
+Object.defineProperty(exports, "useForm", { enumerable: true, get: function () { return form_1.useForm; } });
+Object.defineProperty(exports, "useFormWithFields", { enumerable: true, get: function () { return form_1.useFormWithFields; } });
+Object.defineProperty(exports, "withForm", { enumerable: true, get: function () { return form_1.withForm; } });
+var references_1 = require("./references");
+Object.defineProperty(exports, "defineField", { enumerable: true, get: function () { return references_1.defineField; } });
+Object.defineProperty(exports, "isFieldRef", { enumerable: true, get: function () { return references_1.isFieldRef; } });
+Object.defineProperty(exports, "defineArrayField", { enumerable: true, get: function () { return references_1.defineArrayField; } });
+Object.defineProperty(exports, "isArrayFieldRef", { enumerable: true, get: function () { return references_1.isArrayFieldRef; } });
+var fields_2 = require("./validation/fields");
+Object.defineProperty(exports, "useAsyncFieldStateValidation", { enumerable: true, get: function () { return fields_2.useAsyncFieldStateValidation; } });
+Object.defineProperty(exports, "useAsyncFieldValidation", { enumerable: true, get: function () { return fields_2.useAsyncFieldValidation; } });
+Object.defineProperty(exports, "useFieldStateValidation", { enumerable: true, get: function () { return fields_2.useFieldStateValidation; } });
+Object.defineProperty(exports, "useFieldValidation", { enumerable: true, get: function () { return fields_2.useFieldValidation; } });
+//# sourceMappingURL=index.js.map

package/lib/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/main/web/index.ts"],"names":[],"mappings":";;;AAAA,mCAA4E;AAAnE,kGAAA,QAAQ,OAAA;AAAE,uGAAA,aAAa,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAAE,uGAAA,aAAa,OAAA;AAEzD,+BAAqF;AAA5E,oGAAA,YAAY,OAAA;AAAE,+FAAA,OAAO,OAAA;AAAE,+FAAA,OAAO,OAAA;AAAE,yGAAA,iBAAiB,OAAA;AAAE,gGAAA,QAAQ,OAAA;AAEpE,2CAA0F;AAAjF,yGAAA,WAAW,OAAA;AAAE,wGAAA,UAAU,OAAA;AAAE,8GAAA,gBAAgB,OAAA;AAAE,6GAAA,eAAe,OAAA;AAEnE,8CAK6B;AAJzB,sHAAA,4BAA4B,OAAA;AAC5B,iHAAA,uBAAuB,OAAA;AACvB,iHAAA,uBAAuB,OAAA;AACvB,4GAAA,kBAAkB,OAAA"}

package/lib/cjs/references.d.ts

@@ -0,0 +1,5 @@
+import type { ArrayFieldRef, FieldRef, GenericFieldRef } from './types';
+export declare function defineField<V>(initialValue: V, initialDisabled?: boolean): FieldRef<V>;
+export declare function isFieldRef(field: unknown): field is FieldRef<unknown>;
+export declare function defineArrayField<T extends GenericFieldRef, V>(initialItems: Iterable<V>, itemTemplate: (value: V) => T, initialDisabled?: boolean): ArrayFieldRef<T, V>;
+export declare function isArrayFieldRef(field: unknown): field is ArrayFieldRef<GenericFieldRef, unknown>;

package/lib/cjs/references.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineField = defineField;
+exports.isFieldRef = isFieldRef;
+exports.defineArrayField = defineArrayField;
+exports.isArrayFieldRef = isArrayFieldRef;
+const tslib_1 = require("tslib");
+const immutable_1 = require("immutable");
+const FieldState_1 = tslib_1.__importDefault(require("./FieldState"));
+class FieldRefImpl {
+    constructor(initialValue, initialDisabled) {
+        this.initialState = new FieldState_1.default(initialValue, initialDisabled, false, false);
+    }
+}
+function defineField(initialValue, initialDisabled = false) {
+    return new FieldRefImpl(initialValue, initialDisabled);
+}
+function isFieldRef(field) {
+    return field instanceof FieldRefImpl;
+}
+class ArrayFieldRefImpl extends FieldRefImpl {
+    constructor(initialItems, itemTemplate, initialDisabled) {
+        super(initialItems, initialDisabled);
+        this.itemTemplate = itemTemplate;
+        this.itemTemplate = itemTemplate;
+    }
+}
+function defineArrayField(initialItems, itemTemplate, initialDisabled = false) {
+    return new ArrayFieldRefImpl((0, immutable_1.Seq)(initialItems).map(itemTemplate).toList(), itemTemplate, initialDisabled);
+}
+function isArrayFieldRef(field) {
+    return field instanceof ArrayFieldRefImpl;
+}
+//# sourceMappingURL=references.js.map

package/lib/cjs/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../src/main/web/references.ts"],"names":[],"mappings":";;AAaA,kCAEC;AAED,gCAEC;AAgBD,4CAUC;AAED,0CAEC;;AAjDD,yCAAsC;AAEtC,sEAA0C;AAG1C,MAAM,YAAY;IAGd,YAAY,YAAe,EAAE,eAAwB;QACjD,IAAI,CAAC,YAAY,GAAG,IAAI,oBAAc,CAAC,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACxF,CAAC;CACJ;AAED,SAAgB,WAAW,CAAI,YAAe,EAAE,eAAe,GAAG,KAAK;IACnE,OAAO,IAAI,YAAY,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;AAC3D,CAAC;AAED,SAAgB,UAAU,CAAC,KAAc;IACrC,OAAO,KAAK,YAAY,YAAY,CAAC;AACzC,CAAC;AAED,MAAM,iBACF,SAAQ,YAAqB;IAG7B,YACI,YAAqB,EACZ,YAA6B,EACtC,eAAwB;QAExB,KAAK,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;QAH5B,iBAAY,GAAZ,YAAY,CAAiB;QAItC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACrC,CAAC;CACJ;AAED,SAAgB,gBAAgB,CAC5B,YAAyB,EACzB,YAA6B,EAC7B,eAAe,GAAG,KAAK;IAEvB,OAAO,IAAI,iBAAiB,CACxB,IAAA,eAAG,EAAC,YAAY,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAC5C,YAAY,EACZ,eAAe,CAClB,CAAC;AACN,CAAC;AAED,SAAgB,eAAe,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,iBAAiB,CAAC;AAC9C,CAAC"}

package/lib/cjs/types.d.ts

@@ -0,0 +1,111 @@
+import type { Map, List, OrderedSet } from 'immutable';
+export type GenericFieldRef = ArrayFieldRef<GenericFieldRef, unknown> | FieldRef<unknown> | {
+    [key: string]: GenericFieldRef;
+};
+export interface FieldRef<T> {
+    readonly initialState: FieldState<T>;
+}
+export interface ArrayFieldRef<T extends GenericFieldRef, V> extends FieldRef<List<T>> {
+    itemTemplate(value: V): T;
+}
+/**
+ * `FieldState` represents the state of a `FieldRef`
+ */
+export interface FieldState<T> extends FieldValue<T>, FieldMetadata {
+    /**
+     * Value of the field
+     */
+    readonly value: T;
+    /**
+     * `true` when field is disabled
+     */
+    readonly disabled: boolean;
+    /**
+     * `true` when field is focused
+     */
+    readonly active: boolean;
+    /**
+     * `true` when field has been focused once
+     */
+    readonly touched: boolean;
+    updated(fields: Partial<FieldValue<T> & FieldMetadata>): FieldState<T>;
+    /**
+     * `equals` only takes the value and disabled properties into consideration.
+     */
+    equals(other: FieldState<T> | null | undefined): boolean;
+    /**
+     * `hashCode` only takes the value and disabled properties into consideration.
+     */
+    hashCode(): number;
+}
+export interface FieldValue<T> {
+    readonly value: T;
+}
+export interface FieldMetadata {
+    readonly disabled: boolean;
+    readonly active: boolean;
+    readonly touched: boolean;
+}
+export interface FieldMetadataUpdaters {
+    setDisabled(disabled: boolean): void;
+    onFocus(): void;
+    onBlur(): void;
+}
+export interface Field<T> extends FieldValue<T>, FieldMetadata, FieldMetadataUpdaters, ValidationResult {
+    setValue(value: React.SetStateAction<T>): void;
+}
+export interface ArrayField<T extends GenericFieldRef, V> extends FieldMetadata, FieldMetadataUpdaters, ValidationResult {
+    readonly items: List<T>;
+    unshift(value: V): T;
+    push(value: V): T;
+    insert(index: number, value: V): T;
+    remove(item: T): void;
+    swap(indexA: number, indexB: number): void;
+}
+export type FormStates<F> = F extends ArrayFieldRef<infer T, unknown> ? List<FormStates<T>> : F extends FieldRef<infer T> ? FieldState<T> : F extends {
+    [K: string]: GenericFieldRef;
+} ? {
+    [K in keyof F]: FormStates<F[K]>;
+} : never;
+export type FieldRefStates<T extends GenericFieldRef[]> = {
+    [K in keyof T]: FormStates<T[K]>;
+};
+export type FormValues<F> = F extends ArrayFieldRef<infer T, unknown> ? List<FormValues<T>> : F extends FieldRef<infer T> ? T : F extends {
+    [K: string]: GenericFieldRef;
+} ? {
+    [K in keyof F]: FormValues<F[K]>;
+} : never;
+export type FieldRefValues<T extends GenericFieldRef[]> = {
+    [K in keyof T]: FormValues<T[K]>;
+};
+export interface FormApi extends FormValidationApi {
+    getFieldState<T>(fieldRef: FieldRef<T>): FieldState<T>;
+    getFieldValue<T>(fieldRef: FieldRef<T>): T;
+    setFieldState<T>(fieldRef: FieldRef<T>, state: React.SetStateAction<FieldState<T>>): void;
+    getStates<F extends GenericFieldRef>(fields: F): FormStates<F>;
+    getValues<F extends GenericFieldRef>(fields: F): FormValues<F>;
+    reset(): void;
+    modified: boolean;
+}
+export interface FormWithFields<F extends GenericFieldRef> extends FormApi {
+    fields: F;
+}
+/**
+ * A ReactElement or a string represent an error message, and null represents no errors.
+ */
+export type ValidationError = React.ReactElement | string | null;
+export interface ValidationResult {
+    readonly error: ValidationError;
+    readonly pending: boolean;
+}
+export interface FieldValidation<T> extends ValidationResult {
+    readonly fieldRef: FieldRef<T>;
+}
+export type FormValidations = Map<FieldRef<unknown>, OrderedSet<FieldValidation<unknown>>>;
+export interface FormValidationApi {
+    registerValidation(validation: FieldValidation<unknown>): () => void;
+    getValidationResult(fieldRef: FieldRef<unknown>): ValidationResult;
+    isFieldValid(fieldRef: GenericFieldRef): boolean;
+    valid: boolean;
+    pending: boolean;
+}

package/lib/cjs/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/cjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/main/web/types.ts"],"names":[],"mappings":""}

package/lib/cjs/validation/fields.d.ts

@@ -0,0 +1,5 @@
+import type { GenericFieldRef, FormValues, FormStates, FieldRef, FieldRefValues, FieldRefStates, ValidationError } from '../types';
+export declare function useFieldValidation<F extends FieldRef<unknown>, D extends GenericFieldRef[] = []>(fieldRef: F, validate: (value: FormValues<F>, ds: [...FieldRefValues<D>]) => ValidationError, deps?: [...D]): void;
+export declare function useAsyncFieldValidation<F extends FieldRef<unknown>, D extends GenericFieldRef[] = []>(fieldRef: F, validate: (value: FormValues<F>, ds: [...FieldRefValues<D>]) => Promise<ValidationError>, deps?: [...D], debounceMs?: number): void;
+export declare function useFieldStateValidation<F extends FieldRef<unknown>, D extends GenericFieldRef[] = []>(fieldRef: F, validate: (fieldState: FormStates<F>, dependentFieldStates: [...FieldRefStates<D>]) => ValidationError, deps?: [...D]): void;
+export declare function useAsyncFieldStateValidation<F extends FieldRef<unknown>, D extends GenericFieldRef[] = []>(fieldRef: F, validate: (fieldState: FormStates<F>, ds: [...FieldRefStates<D>]) => Promise<ValidationError>, deps?: [...D], debounceMs?: number): void;