react-native-better-html 1.0.11 → 1.0.12

package/dist/index.js

@@ -52,6 +52,7 @@ __export(index_exports, {
   formatPhoneNumber: () => import_react_better_core11.formatPhoneNumber,
   generateAsyncStorage: () => generateAsyncStorage,
   generateRandomString: () => import_react_better_core11.generateRandomString,
+  getFormErrorObject: () => getFormErrorObject,
   getPluralWord: () => import_react_better_core11.getPluralWord,
   lightenColor: () => import_react_better_core11.lightenColor,
   loaderControls: () => import_react_better_core11.loaderControls,
@@ -61,6 +62,7 @@ __export(index_exports, {
   useBooleanState: () => import_react_better_core11.useBooleanState,
   useDebounceState: () => import_react_better_core11.useDebounceState,
   useDevice: () => useDevice,
+  useForm: () => useForm,
   useKeyboard: () => useKeyboard,
   useLoader: () => import_react_better_core11.useLoader,
   useLoaderControls: () => import_react_better_core11.useLoaderControls,
@@ -465,6 +467,128 @@ function useComponentPropsGrouper(props, prefix) {
     };
   }, [props, prefix]);
 }
+function useForm(options) {
+  const { defaultValues, requiredFields, additional, onSubmit, validate } = options;
+  const inputFieldRefs = (0, import_react2.useRef)(
+    {}
+  );
+  const [values, setValues] = (0, import_react2.useState)(defaultValues);
+  const [errors, setErrors] = (0, import_react2.useState)({});
+  const [isSubmitting, setIsSubmitting] = (0, import_react_better_core2.useBooleanState)();
+  const numberOfInputFields = Object.keys(defaultValues).length;
+  const setFieldValue = (0, import_react2.useCallback)(
+    (field, value) => {
+      setValues((oldValue) => ({
+        ...oldValue,
+        [field]: value
+      }));
+      setErrors((oldValue) => ({
+        ...oldValue,
+        [field]: void 0
+      }));
+    },
+    []
+  );
+  const setFieldsValue = (0, import_react2.useCallback)((values2) => {
+    setValues((oldValue) => ({
+      ...oldValue,
+      ...values2
+    }));
+    setErrors((oldValue) => {
+      const newErrors = {};
+      for (const key in values2) newErrors[key] = void 0;
+      return newErrors;
+    });
+  }, []);
+  const focusField = (0, import_react2.useCallback)((field) => {
+    inputFieldRefs.current[field]?.focus();
+  }, []);
+  const validateForm = (0, import_react2.useCallback)(() => {
+    const validationErrors = validate?.(values) || {};
+    setErrors(validationErrors);
+    return validationErrors;
+  }, [validate, values]);
+  const onSubmitFunction = (0, import_react2.useCallback)(
+    async (event) => {
+      event?.preventDefault();
+      setIsSubmitting.setTrue();
+      try {
+        const validationErrors = validateForm();
+        if (Object.keys(validationErrors).length === 0) {
+          await onSubmit?.(values);
+        } else {
+          const firstErrorField = Object.keys(validationErrors)[0];
+          focusField(firstErrorField);
+        }
+      } finally {
+        setIsSubmitting.setFalse();
+      }
+    },
+    [values, validateForm, onSubmit, focusField]
+  );
+  const getInputFieldProps = (0, import_react2.useCallback)(
+    (field) => {
+      const thisInputFieldIndex = Object.keys(values).findIndex((key) => key === field);
+      const isLastInputField = thisInputFieldIndex === numberOfInputFields - 1;
+      return {
+        required: requiredFields?.includes(field),
+        value: values[field]?.toString() ?? "",
+        errorMessage: errors[field],
+        returnKeyLabel: isLastInputField ? additional?.lastInputFieldReturnKeyLabel ?? "done" : "next",
+        onPressEnter: () => {
+          if (isLastInputField) onSubmitFunction();
+          else inputFieldRefs.current[Object.keys(values)[thisInputFieldIndex + 1]]?.focus();
+        },
+        onChange: (value) => {
+          setFieldValue(field, value);
+        },
+        ref: (element) => {
+          if (!element) return;
+          inputFieldRefs.current[field] = element;
+        }
+      };
+    },
+    [values, setFieldValue, errors, requiredFields, additional, onSubmitFunction]
+  );
+  const reset = (0, import_react2.useCallback)(() => {
+    setValues(defaultValues);
+    setErrors({});
+  }, [defaultValues]);
+  const isDirty = (0, import_react2.useMemo)(
+    () => Object.keys(defaultValues).some((key) => defaultValues[key] !== values[key]),
+    [defaultValues, values]
+  );
+  const isValid = (0, import_react2.useMemo)(() => {
+    const validationErrors = validate?.(values) || {};
+    return Object.keys(validationErrors).length === 0;
+  }, [validate, values]);
+  const canSubmit = (0, import_react2.useMemo)(() => {
+    const requiredFieldsHaveValues = requiredFields?.every((field) => values[field] !== void 0 && values[field] !== "") ?? true;
+    return isValid && requiredFieldsHaveValues;
+  }, [isValid, requiredFields]);
+  return {
+    values,
+    errors,
+    isSubmitting,
+    setFieldValue,
+    setFieldsValue,
+    getInputFieldProps,
+    focusField,
+    inputFieldRefs: inputFieldRefs.current,
+    validate: validateForm,
+    onSubmit: onSubmitFunction,
+    reset,
+    requiredFields,
+    isDirty,
+    isValid,
+    canSubmit
+  };
+}
+
+// src/utils/functions.ts
+var getFormErrorObject = (formValues) => {
+  return {};
+};
 
 // src/utils/asyncStorage.ts
 var import_async_storage = __toESM(require("@react-native-async-storage/async-storage"));
@@ -1205,6 +1329,8 @@ var InputFieldComponent = (0, import_react10.forwardRef)(
     fontWeight = 400,
     lineHeight = 20,
     textAlign,
+    required,
+    disabled,
     paddingHorizontal,
     paddingVertical,
     onFocus,
@@ -1261,111 +1387,124 @@ var InputFieldComponent = (0, import_react10.forwardRef)(
       []
     );
     const prefixSuffixBackgroundColor = colorTheme === "light" ? (0, import_react_better_core9.darkenColor)(theme2.colors.backgroundContent, 0.03) : (0, import_react_better_core9.lightenColor)(theme2.colors.backgroundContent, 0.1);
-    return /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(View_default, { flex: 1, gap: theme2.styles.gap / 3, children: [
-      label && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Text_default, { fontSize: 14, color: theme2.colors.textSecondary, children: label }),
-      /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(View_default, { isRow: true, position: "relative", alignItems: "center", flex: 1, height: readyHeight, children: [
-        prefix && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
-          View_default,
-          {
-            isRow: true,
-            height: "100%",
-            backgroundColor: prefixSuffixBackgroundColor,
-            alignItems: "center",
-            borderWidth,
-            borderRightWidth: 0,
-            borderTopLeftRadius: theme2.styles.borderRadius,
-            borderBottomLeftRadius: theme2.styles.borderRadius,
-            borderColor: theme2.colors.border,
-            paddingHorizontal: readyPaddingHorizontal,
-            children: typeof prefix === "string" ? /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Text_default, { fontWeight: 700, children: prefix }) : prefix
-          }
-        ),
-        /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
-          Animate_default.View,
-          {
-            flex: 1,
-            backgroundColor: theme2.colors.backgroundContent,
-            borderTopLeftRadius: prefix ? 0 : theme2.styles.borderRadius,
-            borderBottomLeftRadius: prefix ? 0 : theme2.styles.borderRadius,
-            borderTopRightRadius: suffix ? 0 : theme2.styles.borderRadius,
-            borderBottomRightRadius: suffix ? 0 : theme2.styles.borderRadius,
-            borderWidth,
-            initialBorderColor: theme2.colors.border,
-            animateBorderColor: isFocused ? theme2.colors.primary : isError ? theme2.colors.error : theme2.colors.border,
-            overflow: "hidden",
-            children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
-              import_react_native8.TextInput,
+    return /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(
+      Animate_default.View,
+      {
+        flex: 1,
+        gap: theme2.styles.gap / 3,
+        initialOpacity: 1,
+        animateOpacity: disabled ? 0.6 : 1,
+        children: [
+          label && /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(View_default, { isRow: true, width: "100%", alignItems: "center", gap: 2, children: [
+            /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Text_default, { fontSize: 14, color: theme2.colors.textSecondary, children: label }),
+            required && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Text_default, { color: theme2.colors.error, children: "*" })
+          ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime9.jsxs)(View_default, { isRow: true, position: "relative", alignItems: "center", flex: 1, height: readyHeight, children: [
+            prefix && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+              View_default,
+              {
+                isRow: true,
+                height: "100%",
+                backgroundColor: prefixSuffixBackgroundColor,
+                alignItems: "center",
+                borderWidth,
+                borderRightWidth: 0,
+                borderTopLeftRadius: theme2.styles.borderRadius,
+                borderBottomLeftRadius: theme2.styles.borderRadius,
+                borderColor: theme2.colors.border,
+                paddingHorizontal: readyPaddingHorizontal,
+                children: typeof prefix === "string" ? /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Text_default, { fontWeight: 700, children: prefix }) : prefix
+              }
+            ),
+            /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+              Animate_default.View,
+              {
+                flex: 1,
+                backgroundColor: theme2.colors.backgroundContent,
+                borderTopLeftRadius: prefix ? 0 : theme2.styles.borderRadius,
+                borderBottomLeftRadius: prefix ? 0 : theme2.styles.borderRadius,
+                borderTopRightRadius: suffix ? 0 : theme2.styles.borderRadius,
+                borderBottomRightRadius: suffix ? 0 : theme2.styles.borderRadius,
+                borderWidth,
+                initialBorderColor: theme2.colors.border,
+                animateBorderColor: isFocused ? theme2.colors.primary : isError ? theme2.colors.error : theme2.colors.border,
+                overflow: "hidden",
+                children: /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+                  import_react_native8.TextInput,
+                  {
+                    style: textInputStyle,
+                    value: internalValue,
+                    defaultValue,
+                    autoCapitalize,
+                    autoComplete,
+                    autoCorrect,
+                    autoFocus,
+                    placeholder,
+                    placeholderTextColor: theme2.colors.textSecondary + "80",
+                    enterKeyHint: returnKeyLabel,
+                    returnKeyType,
+                    onSubmitEditing: onPressEnter,
+                    readOnly: !editable || disabled,
+                    textAlign,
+                    editable: !disabled,
+                    keyboardAppearance,
+                    keyboardType,
+                    cursorColor: theme2.colors.primary,
+                    selectionColor: theme2.colors.primary,
+                    secureTextEntry,
+                    onFocus: onFocusElement,
+                    onBlur: onBlurElement,
+                    onChangeText,
+                    onPress,
+                    ref: textInputRef
+                  }
+                )
+              }
+            ),
+            suffix && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+              View_default,
               {
-                style: textInputStyle,
-                value: internalValue,
-                defaultValue,
-                autoCapitalize,
-                autoComplete,
-                autoCorrect,
-                autoFocus,
-                placeholder,
-                placeholderTextColor: theme2.colors.textSecondary + "80",
-                enterKeyHint: returnKeyLabel,
-                returnKeyType,
-                onSubmitEditing: onPressEnter,
-                readOnly: !editable,
-                textAlign,
-                keyboardAppearance,
-                keyboardType,
-                cursorColor: theme2.colors.primary,
-                selectionColor: theme2.colors.primary,
-                secureTextEntry,
-                onFocus: onFocusElement,
-                onBlur: onBlurElement,
-                onChangeText,
-                onPress,
-                ref: textInputRef
+                isRow: true,
+                height: "100%",
+                backgroundColor: prefixSuffixBackgroundColor,
+                alignItems: "center",
+                borderWidth,
+                borderLeftWidth: 0,
+                borderTopRightRadius: theme2.styles.borderRadius,
+                borderBottomRightRadius: theme2.styles.borderRadius,
+                borderColor: theme2.colors.border,
+                paddingHorizontal: readyPaddingHorizontal,
+                children: typeof suffix === "string" ? /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Text_default, { fontWeight: 700, children: suffix }) : suffix
               }
             )
-          }
-        ),
-        suffix && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
-          View_default,
-          {
-            isRow: true,
-            height: "100%",
-            backgroundColor: prefixSuffixBackgroundColor,
-            alignItems: "center",
-            borderWidth,
-            borderLeftWidth: 0,
-            borderTopRightRadius: theme2.styles.borderRadius,
-            borderBottomRightRadius: theme2.styles.borderRadius,
-            borderColor: theme2.colors.border,
-            paddingHorizontal: readyPaddingHorizontal,
-            children: typeof suffix === "string" ? /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(Text_default, { fontWeight: 700, children: suffix }) : suffix
-          }
-        )
-      ] }),
-      infoMessage && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
-        Animate_default.Text,
-        {
-          fontSize: 14,
-          color: theme2.colors.textSecondary,
-          initialHeight: 0,
-          initialOpacity: 0,
-          animateHeight: 17,
-          animateOpacity: 1,
-          children: infoMessage
-        }
-      ),
-      errorMessage && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
-        Animate_default.Text,
-        {
-          fontSize: 14,
-          color: theme2.colors.error,
-          initialHeight: 0,
-          initialOpacity: 0,
-          animateHeight: 17,
-          animateOpacity: 1,
-          children: errorMessage
-        }
-      )
-    ] });
+          ] }),
+          infoMessage && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+            Animate_default.Text,
+            {
+              fontSize: 14,
+              color: theme2.colors.textSecondary,
+              initialHeight: 0,
+              initialOpacity: 0,
+              animateHeight: 17,
+              animateOpacity: 1,
+              children: infoMessage
+            }
+          ),
+          errorMessage && /* @__PURE__ */ (0, import_jsx_runtime9.jsx)(
+            Animate_default.Text,
+            {
+              fontSize: 14,
+              color: theme2.colors.error,
+              initialHeight: 0,
+              initialOpacity: 0,
+              animateHeight: 17,
+              animateOpacity: 1,
+              children: errorMessage
+            }
+          )
+        ]
+      }
+    );
   }
 );
 InputFieldComponent.email = (0, import_react10.forwardRef)(function Email(props, ref) {
@@ -1472,6 +1611,7 @@ var asyncStoragePlugin = (options) => ({
   formatPhoneNumber,
   generateAsyncStorage,
   generateRandomString,
+  getFormErrorObject,
   getPluralWord,
   lightenColor,
   loaderControls,
@@ -1481,6 +1621,7 @@ var asyncStoragePlugin = (options) => ({
   useBooleanState,
   useDebounceState,
   useDevice,
+  useForm,
   useKeyboard,
   useLoader,
   useLoaderControls,