@ekz/formix 2.1.1 → 2.1.2

package/lib/esnext/index.js

@@ -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';
+//# sourceMappingURL=index.js.map

package/lib/esnext/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/main/web/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE5E,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAErF,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE1F,OAAO,EACH,4BAA4B,EAC5B,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,EACrB,MAAM,qBAAqB,CAAC"}

package/lib/esnext/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/esnext/references.js

@@ -0,0 +1,29 @@
+import { List, Seq } from 'immutable';
+import FieldStateImpl from './FieldState';
+class FieldRefImpl {
+    initialState;
+    constructor(initialValue, initialDisabled) {
+        this.initialState = new FieldStateImpl(initialValue, initialDisabled, false, false);
+    }
+}
+export function defineField(initialValue, initialDisabled = false) {
+    return new FieldRefImpl(initialValue, initialDisabled);
+}
+export function isFieldRef(field) {
+    return field instanceof FieldRefImpl;
+}
+class ArrayFieldRefImpl extends FieldRefImpl {
+    itemTemplate;
+    constructor(initialItems, itemTemplate, initialDisabled) {
+        super(initialItems, initialDisabled);
+        this.itemTemplate = itemTemplate;
+        this.itemTemplate = itemTemplate;
+    }
+}
+export function defineArrayField(initialItems, itemTemplate, initialDisabled = false) {
+    return new ArrayFieldRefImpl(Seq(initialItems).map(itemTemplate).toList(), itemTemplate, initialDisabled);
+}
+export function isArrayFieldRef(field) {
+    return field instanceof ArrayFieldRefImpl;
+}
+//# sourceMappingURL=references.js.map

package/lib/esnext/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../src/main/web/references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,cAAc,MAAM,cAAc,CAAC;AAG1C,MAAM,YAAY;IACL,YAAY,CAAgB;IAErC,YAAY,YAAe,EAAE,eAAwB;QACjD,IAAI,CAAC,YAAY,GAAG,IAAI,cAAc,CAAC,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACxF,CAAC;CACJ;AAED,MAAM,UAAU,WAAW,CAAI,YAAe,EAAE,eAAe,GAAG,KAAK;IACnE,OAAO,IAAI,YAAY,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACrC,OAAO,KAAK,YAAY,YAAY,CAAC;AACzC,CAAC;AAED,MAAM,iBACF,SAAQ,YAAqB;IAKhB;IAFb,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,MAAM,UAAU,gBAAgB,CAC5B,YAAyB,EACzB,YAA6B,EAC7B,eAAe,GAAG,KAAK;IAEvB,OAAO,IAAI,iBAAiB,CACxB,GAAG,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAC5C,YAAY,EACZ,eAAe,CAClB,CAAC;AACN,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,iBAAiB,CAAC;AAC9C,CAAC"}

package/lib/esnext/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/esnext/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/esnext/types.js.map

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

package/lib/esnext/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;

package/lib/esnext/validation/fields.js

@@ -0,0 +1,107 @@
+import * as React from 'react';
+import { useForm } from '../form';
+export function useFieldValidation(fieldRef, validate, deps) {
+    const { getValues, registerValidation } = useForm();
+    const value = getValues(fieldRef);
+    const dependentValues = React.useMemo(() => {
+        return (deps ?? []).map(getValues);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [getValues, ...(deps ?? [])]);
+    const error = React.useMemo(() => {
+        return validate(value, dependentValues);
+        // validate should not be considered for changes
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [value, ...dependentValues]);
+    const validation = React.useMemo(() => ({
+        fieldRef,
+        error,
+        pending: false
+    }), [fieldRef, error]);
+    React.useLayoutEffect(() => registerValidation(validation), [registerValidation, validation]);
+}
+function useAsyncValidationResult(validate, debounceMs, deps) {
+    const [result, setResult] = React.useState({
+        pending: false,
+        error: null
+    });
+    React.useEffect(() => {
+        let mounted = true;
+        setResult((previous) => ({ pending: true, error: previous.error }));
+        const timeoutId = setTimeout(() => {
+            validate()
+                .then((error) => {
+                if (mounted) {
+                    setResult({ pending: false, error: error });
+                }
+            })
+                .catch((error) => {
+                if (mounted) {
+                    setResult({ pending: false, error: 'Unexpected error' });
+                }
+                console.warn('[Unhandled Validation Error]', error);
+                console.warn('An async validator should never throw, but it should resolve with the validation result.');
+            });
+        }, debounceMs);
+        return () => {
+            mounted = false;
+            clearTimeout(timeoutId);
+        };
+        // validate should not be considered for changes
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [debounceMs, ...deps]);
+    return result;
+}
+export function useAsyncFieldValidation(fieldRef, validate, deps, debounceMs = 200) {
+    const { getValues, registerValidation } = useForm();
+    const value = getValues(fieldRef);
+    const dependentValues = React.useMemo(() => {
+        return (deps ?? []).map(getValues);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [getValues, ...(deps ?? [])]);
+    const result = useAsyncValidationResult(() => {
+        return validate(value, dependentValues);
+    }, debounceMs, [value, ...dependentValues]);
+    const validation = React.useMemo(() => ({
+        fieldRef,
+        error: result.error,
+        pending: result.pending
+    }), [fieldRef, result.error, result.pending]);
+    React.useLayoutEffect(() => registerValidation(validation), [registerValidation, validation]);
+}
+export function useFieldStateValidation(fieldRef, validate, deps) {
+    const { getStates, registerValidation } = useForm();
+    const fieldState = getStates(fieldRef);
+    const dependentStates = React.useMemo(() => {
+        return (deps ?? []).map(getStates);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [getStates, ...(deps ?? [])]);
+    const error = React.useMemo(() => {
+        return validate(fieldState, dependentStates);
+        // validate should not be considered for changes
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [fieldState, ...dependentStates]);
+    const validation = React.useMemo(() => ({
+        fieldRef,
+        error,
+        pending: false
+    }), [fieldRef, error]);
+    React.useLayoutEffect(() => registerValidation(validation), [registerValidation, validation]);
+}
+export function useAsyncFieldStateValidation(fieldRef, validate, deps, debounceMs = 200) {
+    const { getStates, registerValidation } = useForm();
+    const fieldState = getStates(fieldRef);
+    const dependentValues = React.useMemo(() => {
+        return (deps ?? []).map(getStates);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [getStates, ...(deps ?? [])]);
+    const result = useAsyncValidationResult(() => {
+        return validate(fieldState, dependentValues);
+    }, debounceMs, [fieldState, ...dependentValues]);
+    const validation = React.useMemo(() => ({
+        fieldRef,
+        error: result.error,
+        pending: result.pending
+    }), [fieldRef, result.error, result.pending]);
+    React.useLayoutEffect(() => registerValidation(validation), [registerValidation, validation]);
+}
+//# sourceMappingURL=fields.js.map

package/lib/esnext/validation/fields.js.map

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

package/lib/esnext/validation/form.d.ts

@@ -0,0 +1,2 @@
+import type { FormApi, FormValidationApi } from '../types';
+export declare function useFormValidation(getFieldState: FormApi['getFieldState']): FormValidationApi;

package/lib/esnext/validation/form.js

@@ -0,0 +1,58 @@
+import { Seq, List, Map, OrderedSet } from 'immutable';
+import * as React from 'react';
+import { isArrayFieldRef, isFieldRef } from '../references';
+export function useFormValidation(getFieldState) {
+    const [validations, setValidations] = React.useState(Map);
+    const registerValidation = React.useCallback((validation) => {
+        setValidations((previous) => previous.update(validation.fieldRef, OrderedSet(), (validations) => validations.add(validation)));
+        return () => setValidations((previous) => previous.update(validation.fieldRef, OrderedSet(), (validations) => validations.remove(validation)));
+    }, []);
+    const getValidationResult = React.useCallback((fieldRef) => {
+        const result = validations.get(fieldRef, OrderedSet()).reduce((result, validation) => ({
+            error: result.error || validation.error,
+            pending: result.pending || validation.pending
+        }), EmptyValidationResult);
+        // The reduce allocates a fresh object even for a passing field, which makes every
+        // `useField` on a validated field unstable across renders. Collapse the no-error,
+        // no-pending case back to the frozen singleton so identity stays stable.
+        return result.error == null && !result.pending ? EmptyValidationResult : result;
+    }, [validations]);
+    const isFieldValid = React.useCallback((fieldRef) => {
+        function flatten(field) {
+            if (isArrayFieldRef(field)) {
+                return getFieldState(field).value.flatMap(flatten);
+            }
+            else if (isFieldRef(field)) {
+                return List.of(field);
+            }
+            else {
+                return Seq.Keyed(field).valueSeq().flatMap(flatten).toList();
+            }
+        }
+        const fields = flatten(fieldRef).toSet();
+        return validations
+            .filter((_, field) => fields.has(field))
+            .valueSeq()
+            .flatMap((v) => v)
+            .every((v) => v.error == null && !v.pending);
+    }, [getFieldState, validations]);
+    const pending = React.useMemo(() => {
+        return validations
+            .valueSeq()
+            .flatMap((v) => v)
+            .some((v) => v.pending);
+    }, [validations]);
+    const valid = React.useMemo(() => {
+        return (!pending &&
+            validations
+                .valueSeq()
+                .flatMap((v) => v)
+                .every((v) => v.error == null));
+    }, [pending, validations]);
+    return { registerValidation, getValidationResult, isFieldValid, valid, pending };
+}
+const EmptyValidationResult = Object.freeze({
+    error: null,
+    pending: false
+});
+//# sourceMappingURL=form.js.map

package/lib/esnext/validation/form.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekz/formix",
-  "version": "2.1.1",
+  "version": "2.1.2",
   "license": "MIT",
   "description": "Type-safe React form to be used with Typescript",
   "homepage": "https://docs.ekz.io/formix/",
@@ -37,7 +37,7 @@
     "type-safe"
   ],
   "peerDependencies": {
-    "@ekz/option": "^2.0.1",
+    "@ekz/option": "^2.0.2",
     "immutable": "^4 || ^5",
     "react": "^16.8.0 || ^17 || ^18 || ^19",
     "typescript": "^4 || ^5 || ^6 "
@@ -71,7 +71,7 @@
     "dev": "yarn compile:esm --watch",
     "test": "yarn typecheck:tests && jest",
     "typecheck:tests": "tsc -p tsconfig.test.json",
-    "prepublish": "yarn clean && yarn test --ci --no-watchman && yarn lint && yarn compile"
+    "prepack": "yarn clean && yarn test --ci --no-watchman && yarn lint && yarn compile"
   },
   "jest": {
     "preset": "ts-jest/presets/default",