@juantroconisf/lib 3.5.3 → 3.5.4

package/dist/index.d.mts

@@ -69,6 +69,15 @@ interface FormChangeState<O extends StateType> {
         [key in keyof O]?: ValidatorErrorMessage;
     };
 }
+interface FormOptions<O extends StateType> {
+    state: O;
+    validations?: {
+        [key in keyof O]?: ValidatorParams;
+    };
+    errorMessages?: {
+        [key in keyof O]?: ValidatorErrorMessage;
+    };
+}
 type TouchedType<O extends StateType> = Record<keyof O, boolean>;
 type ValueChangeFunc<O extends StateType, K extends keyof O> = (id: K, value: O[K]) => void;
 type BlurFunc<O extends StateType> = (id: keyof O) => void;
@@ -78,7 +87,12 @@ interface ComponentInputProps<O extends StateType> {
     isInvalid: boolean;
     errorMessage: string;
 }
+type UXProps<O extends StateType> = Record<keyof O, {
+    isInvalid: boolean;
+    errorMessage: string;
+}>;
 type RegisterHandleFunc<O extends StateType> = (id: keyof O) => ComponentInputProps<O>;
+type ValidateInputFunc<O extends StateType> = (id: keyof O, value: O[keyof O]) => any;
 interface InputRegisterProps<O extends StateType, K extends keyof O, V extends unknown = string> extends ComponentInputProps<O> {
     onValueChange: (value: O[K]) => void;
     value: V;
@@ -116,4 +130,6 @@ interface UseFormChangeResponse<O extends StateType> {
 
 declare function useFormChange<O extends StateType>({ state: initialState, validations, errorMessages, }: FormChangeState<O>): UseFormChangeResponse<O>;
 
-export { type BlurFunc, type ComponentInputProps, type FormChangeState, type GetNestedValueByKey, type GetValidationFunc, type GetValidationResponse, type MapValidator, type NXErrorFunc, type NestedChangeProps, NextUIError, type PreservedKeys, type RegisterFunc, type RegisterHandleFunc, type RequiredValidationFunc, type StateType, type TouchedType, type UseFormChangeResponse, type UseValidationFunc, type Validator, type ValidatorErrorMessage$1 as ValidatorErrorMessage, type ValidatorFunction, type ValidatorParams$1 as ValidatorParams, type ValidatorTypes, type ValueChangeFunc, useFormChange };
+declare function useForm<O extends StateType>(initialState: O, { validations, errorMessages }: FormOptions<O>): UseFormChangeResponse<O>;
+
+export { type BlurFunc, type ComponentInputProps, type FormChangeState, type FormOptions, type GetNestedValueByKey, type GetValidationFunc, type GetValidationResponse, type MapValidator, type NXErrorFunc, type NestedChangeProps, NextUIError, type PreservedKeys, type RegisterFunc, type RegisterHandleFunc, type RequiredValidationFunc, type StateType, type TouchedType, type UXProps, type UseFormChangeResponse, type UseValidationFunc, type ValidateInputFunc, type Validator, type ValidatorErrorMessage$1 as ValidatorErrorMessage, type ValidatorFunction, type ValidatorParams$1 as ValidatorParams, type ValidatorTypes, type ValueChangeFunc, useForm, useFormChange };

package/dist/index.d.ts

@@ -69,6 +69,15 @@ interface FormChangeState<O extends StateType> {
         [key in keyof O]?: ValidatorErrorMessage;
     };
 }
+interface FormOptions<O extends StateType> {
+    state: O;
+    validations?: {
+        [key in keyof O]?: ValidatorParams;
+    };
+    errorMessages?: {
+        [key in keyof O]?: ValidatorErrorMessage;
+    };
+}
 type TouchedType<O extends StateType> = Record<keyof O, boolean>;
 type ValueChangeFunc<O extends StateType, K extends keyof O> = (id: K, value: O[K]) => void;
 type BlurFunc<O extends StateType> = (id: keyof O) => void;
@@ -78,7 +87,12 @@ interface ComponentInputProps<O extends StateType> {
     isInvalid: boolean;
     errorMessage: string;
 }
+type UXProps<O extends StateType> = Record<keyof O, {
+    isInvalid: boolean;
+    errorMessage: string;
+}>;
 type RegisterHandleFunc<O extends StateType> = (id: keyof O) => ComponentInputProps<O>;
+type ValidateInputFunc<O extends StateType> = (id: keyof O, value: O[keyof O]) => any;
 interface InputRegisterProps<O extends StateType, K extends keyof O, V extends unknown = string> extends ComponentInputProps<O> {
     onValueChange: (value: O[K]) => void;
     value: V;
@@ -116,4 +130,6 @@ interface UseFormChangeResponse<O extends StateType> {
 
 declare function useFormChange<O extends StateType>({ state: initialState, validations, errorMessages, }: FormChangeState<O>): UseFormChangeResponse<O>;
 
-export { type BlurFunc, type ComponentInputProps, type FormChangeState, type GetNestedValueByKey, type GetValidationFunc, type GetValidationResponse, type MapValidator, type NXErrorFunc, type NestedChangeProps, NextUIError, type PreservedKeys, type RegisterFunc, type RegisterHandleFunc, type RequiredValidationFunc, type StateType, type TouchedType, type UseFormChangeResponse, type UseValidationFunc, type Validator, type ValidatorErrorMessage$1 as ValidatorErrorMessage, type ValidatorFunction, type ValidatorParams$1 as ValidatorParams, type ValidatorTypes, type ValueChangeFunc, useFormChange };
+declare function useForm<O extends StateType>(initialState: O, { validations, errorMessages }: FormOptions<O>): UseFormChangeResponse<O>;
+
+export { type BlurFunc, type ComponentInputProps, type FormChangeState, type FormOptions, type GetNestedValueByKey, type GetValidationFunc, type GetValidationResponse, type MapValidator, type NXErrorFunc, type NestedChangeProps, NextUIError, type PreservedKeys, type RegisterFunc, type RegisterHandleFunc, type RequiredValidationFunc, type StateType, type TouchedType, type UXProps, type UseFormChangeResponse, type UseValidationFunc, type ValidateInputFunc, type Validator, type ValidatorErrorMessage$1 as ValidatorErrorMessage, type ValidatorFunction, type ValidatorParams$1 as ValidatorParams, type ValidatorTypes, type ValueChangeFunc, useForm, useFormChange };

package/dist/index.js

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   NextUIError: () => NextUIError,
+  useForm: () => useForm,
   useFormChange: () => useFormChange
 });
 module.exports = __toCommonJS(index_exports);
@@ -55,8 +56,8 @@ function handleNestedChange({
   current[propertyDepth[propertyDepth.length - 1]] = value;
   return { ...newValues };
 }
-var allToValue = (obj, bool) => Object.keys(obj).reduce((acc, key) => {
-  acc[key] = bool;
+var allToValue = (obj, value) => Object.keys(obj).reduce((acc, key) => {
+  acc[key] = value;
   return acc;
 }, {});
 var nxError = (bool, msg) => new NextUIError(bool, msg);
@@ -286,8 +287,125 @@ function useFormChange({
     realErrors
   };
 }
+
+// src/hooks/useForm.tsx
+var import_react2 = require("react");
+function useForm(initialState, { validations, errorMessages }) {
+  const [state, setState] = (0, import_react2.useState)(initialState), falseState = allToValue(state, false), touched = (0, import_react2.useRef)(falseState), errors2 = (0, import_react2.useRef)({ ...falseState }), realErrors = (0, import_react2.useRef)({ ...falseState }), { getValidation } = useValidation(), ux = (0, import_react2.useRef)(
+    allToValue(state, { isInvalid: false, errorMessage: "" })
+  );
+  const validateInput = (id, value) => {
+    const isTouched = touched.current[id], requirements = validations?.[id];
+    const [uiErrors] = [
+      {
+        ref: errors2,
+        touched: isTouched
+      },
+      {
+        ref: realErrors,
+        touched: true
+      }
+    ].map((item) => {
+      const req = getValidation(
+        value,
+        item.touched,
+        requirements,
+        errorMessages?.[id]
+      );
+      item.ref.current = handleNestedChange({
+        state: item.ref.current,
+        id,
+        value: !req.isValid
+      });
+      return req;
+    });
+    if (requirements === void 0) return;
+    ux.current[id] = {
+      isInvalid: !uiErrors.isValid,
+      errorMessage: uiErrors.validationProps.errorMessage
+    };
+  };
+  const onBlur = (id) => {
+    touched.current = handleNestedChange({
+      state: touched.current,
+      id,
+      value: true
+    });
+  }, onValueChange = (id, value) => {
+    setState((prev) => handleNestedChange({ state: prev, id, value }));
+    validateInput(id, value);
+  }, onSelectionChange = (id, value) => {
+    const fixedValue = typeof value === "string" || value === null ? value : Array.from(value);
+    setState(
+      (prev) => handleNestedChange({
+        state: prev,
+        id,
+        value: fixedValue
+      })
+    );
+    validateInput(id, fixedValue);
+  };
+  return {
+    onBlur,
+    onValueChange,
+    onSelectionChange,
+    state,
+    setState,
+    register: {
+      input: (id) => ({
+        ...ux.current[id],
+        id,
+        onBlur: () => onBlur(id),
+        onValueChange: (v) => onValueChange(id, v),
+        value: state[id]
+      }),
+      select: (id) => {
+        const isString = typeof state[id] === "string" || state[id] === null;
+        return {
+          ...ux.current[id],
+          id,
+          onBlur: () => onBlur(id),
+          onSelectionChange: (v) => onSelectionChange(
+            id,
+            !isString ? v : Array.from(v)[0] || null
+          ),
+          selectedKeys: state[id] === null ? [] : isString ? [state[id]] : state[id]
+        };
+      },
+      autocomplete: (id) => ({
+        ...ux.current[id],
+        id,
+        onBlur: () => onBlur(id),
+        onSelectionChange: (v) => onSelectionChange(id, v),
+        selectedKey: state[id]
+      })
+    },
+    hasInvalidValues: () => {
+      touched.current = allToValue(initialState, true);
+      return JSON.stringify(realErrors.current).includes(":true");
+    },
+    touched: touched.current,
+    resetForm: (preservedKeys) => {
+      const val = allToValue(initialState, false);
+      touched.current = val;
+      errors2.current = val;
+      setState(
+        preservedKeys === void 0 ? initialState : preservedKeys.reduce(
+          (acc, key) => ({
+            ...acc,
+            [key]: state[key]
+          }),
+          initialState
+        )
+      );
+    },
+    errors: errors2,
+    realErrors
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   NextUIError,
+  useForm,
   useFormChange
 });

package/dist/index.mjs

@@ -36,8 +36,8 @@ function handleNestedChange({
   current[propertyDepth[propertyDepth.length - 1]] = value;
   return { ...newValues };
 }
-var allToValue = (obj, bool) => Object.keys(obj).reduce((acc, key) => {
-  acc[key] = bool;
+var allToValue = (obj, value) => Object.keys(obj).reduce((acc, key) => {
+  acc[key] = value;
   return acc;
 }, {});
 var nxError = (bool, msg) => new NextUIError(bool, msg);
@@ -267,7 +267,124 @@ function useFormChange({
     realErrors
   };
 }
+
+// src/hooks/useForm.tsx
+import { useState as useState2, useRef as useRef2 } from "react";
+function useForm(initialState, { validations, errorMessages }) {
+  const [state, setState] = useState2(initialState), falseState = allToValue(state, false), touched = useRef2(falseState), errors2 = useRef2({ ...falseState }), realErrors = useRef2({ ...falseState }), { getValidation } = useValidation(), ux = useRef2(
+    allToValue(state, { isInvalid: false, errorMessage: "" })
+  );
+  const validateInput = (id, value) => {
+    const isTouched = touched.current[id], requirements = validations?.[id];
+    const [uiErrors] = [
+      {
+        ref: errors2,
+        touched: isTouched
+      },
+      {
+        ref: realErrors,
+        touched: true
+      }
+    ].map((item) => {
+      const req = getValidation(
+        value,
+        item.touched,
+        requirements,
+        errorMessages?.[id]
+      );
+      item.ref.current = handleNestedChange({
+        state: item.ref.current,
+        id,
+        value: !req.isValid
+      });
+      return req;
+    });
+    if (requirements === void 0) return;
+    ux.current[id] = {
+      isInvalid: !uiErrors.isValid,
+      errorMessage: uiErrors.validationProps.errorMessage
+    };
+  };
+  const onBlur = (id) => {
+    touched.current = handleNestedChange({
+      state: touched.current,
+      id,
+      value: true
+    });
+  }, onValueChange = (id, value) => {
+    setState((prev) => handleNestedChange({ state: prev, id, value }));
+    validateInput(id, value);
+  }, onSelectionChange = (id, value) => {
+    const fixedValue = typeof value === "string" || value === null ? value : Array.from(value);
+    setState(
+      (prev) => handleNestedChange({
+        state: prev,
+        id,
+        value: fixedValue
+      })
+    );
+    validateInput(id, fixedValue);
+  };
+  return {
+    onBlur,
+    onValueChange,
+    onSelectionChange,
+    state,
+    setState,
+    register: {
+      input: (id) => ({
+        ...ux.current[id],
+        id,
+        onBlur: () => onBlur(id),
+        onValueChange: (v) => onValueChange(id, v),
+        value: state[id]
+      }),
+      select: (id) => {
+        const isString = typeof state[id] === "string" || state[id] === null;
+        return {
+          ...ux.current[id],
+          id,
+          onBlur: () => onBlur(id),
+          onSelectionChange: (v) => onSelectionChange(
+            id,
+            !isString ? v : Array.from(v)[0] || null
+          ),
+          selectedKeys: state[id] === null ? [] : isString ? [state[id]] : state[id]
+        };
+      },
+      autocomplete: (id) => ({
+        ...ux.current[id],
+        id,
+        onBlur: () => onBlur(id),
+        onSelectionChange: (v) => onSelectionChange(id, v),
+        selectedKey: state[id]
+      })
+    },
+    hasInvalidValues: () => {
+      touched.current = allToValue(initialState, true);
+      return JSON.stringify(realErrors.current).includes(":true");
+    },
+    touched: touched.current,
+    resetForm: (preservedKeys) => {
+      const val = allToValue(initialState, false);
+      touched.current = val;
+      errors2.current = val;
+      setState(
+        preservedKeys === void 0 ? initialState : preservedKeys.reduce(
+          (acc, key) => ({
+            ...acc,
+            [key]: state[key]
+          }),
+          initialState
+        )
+      );
+    },
+    errors: errors2,
+    realErrors
+  };
+}
 export {
   NextUIError,
+  useForm,
   useFormChange
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juantroconisf/lib",
-  "version": "3.5.3",
+  "version": "3.5.4",
   "description": "A state and validation library for HeroUI.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",