@formality-ui/react 0.2.0 → 0.2.2

package/dist/index.cjs

@@ -181,6 +181,8 @@ function Form({
   const pendingChangedFields = react.useRef(/* @__PURE__ */ new Set());
   const pendingAffectedFields = react.useRef(/* @__PURE__ */ new Set());
   const executionVersionRef = react.useRef(0);
+  const fieldDebouncersRef = react.useRef(/* @__PURE__ */ new Map());
+  const getOrCreateDebouncedRef = react.useRef();
   const registerField = react.useCallback((name) => {
     fieldRegistry.current.add(name);
     setRegisteredFields(new Set(fieldRegistry.current));
@@ -281,8 +283,11 @@ function Form({
         for (const field of affected) {
           pendingAffectedFields.current.add(field);
         }
-        if (inputConfig?.debounce === false) {
+        const fieldDebounce = inputConfig?.debounce;
+        if (fieldDebounce === false) {
           executeAutoSaveRef.current?.();
+        } else if (typeof fieldDebounce === "number") {
+          getOrCreateDebouncedRef.current?.(fieldDebounce)();
         } else {
           debouncedSubmitRef.current?.();
         }
@@ -423,53 +428,67 @@ function Form({
         return;
       }
     }
-    const formState = methods.formState;
-    if (Object.keys(formState.errors).length > 0) {
-      return;
-    }
     const values = methods.getValues();
     await handleSubmit(values);
   }, [methods, handleSubmit, waitForFieldValidation]);
   executeAutoSaveRef.current = executeAutoSave;
+  const getOrCreateDebounced = react.useCallback(
+    (ms) => {
+      const cached = fieldDebouncersRef.current.get(ms);
+      if (cached) return cached;
+      const debouncedFn = lodashEs.debounce(() => {
+        executeAutoSaveRef.current?.();
+      }, ms);
+      const fn = Object.assign(debouncedFn, {
+        pending: () => false
+        // lodash debounce tracks pending internally
+      });
+      fieldDebouncersRef.current.set(ms, fn);
+      return fn;
+    },
+    []
+  );
+  getOrCreateDebouncedRef.current = getOrCreateDebounced;
   react.useEffect(() => {
+    return () => {
+      fieldDebouncersRef.current.forEach((fn) => fn.cancel());
+      fieldDebouncersRef.current.clear();
+    };
+  }, [getOrCreateDebounced]);
+  const debouncedSubmit = react.useMemo(() => {
     if (debounceMs === false) {
-      const immediateFn = Object.assign(
+      return Object.assign(
         () => {
-          executeAutoSave();
+          executeAutoSaveRef.current?.();
         },
         {
           cancel: () => {
           },
           // No-op for immediate function
-          flush: () => executeAutoSave(),
+          flush: () => executeAutoSaveRef.current?.(),
           // Execute immediately on flush
           pending: () => false
           // Never pending when immediate
         }
       );
-      debouncedSubmitRef.current = immediateFn;
-      return () => {
-      };
     }
     const debouncedFn = lodashEs.debounce(() => {
-      executeAutoSave();
+      executeAutoSaveRef.current?.();
     }, debounceMs);
-    const fn = Object.assign(debouncedFn, {
+    return Object.assign(debouncedFn, {
       pending: () => false
       // lodash debounce handles this internally
     });
-    debouncedSubmitRef.current = fn;
+  }, [debounceMs]);
+  debouncedSubmitRef.current = debouncedSubmit;
+  react.useEffect(() => {
     return () => {
-      debouncedFn.cancel();
+      debouncedSubmit.cancel();
     };
-  }, [executeAutoSave, debounceMs]);
+  }, [debouncedSubmit]);
   const submitImmediate = react.useCallback(() => {
-    if (debouncedSubmitRef.current?.flush) {
-      debouncedSubmitRef.current.flush();
-    } else {
-      executeAutoSave();
-    }
-  }, [executeAutoSave]);
+    debouncedSubmitRef.current?.flush();
+  }, []);
   const unusedFields = react.useMemo(() => {
     const allFields = Object.keys(config);
     return allFields.filter((name) => !registeredFields.has(name));
@@ -508,7 +527,7 @@ function Form({
       setFieldValidating,
       getFormState,
       onSubmit,
-      debouncedSubmit: debouncedSubmitRef.current,
+      debouncedSubmit,
       submitImmediate,
       unusedFields,
       methods
@@ -527,6 +546,7 @@ function Form({
       setFieldValidating,
       getFormState,
       onSubmit,
+      debouncedSubmit,
       submitImmediate,
       unusedFields,
       methods
@@ -562,11 +582,18 @@ function useInferredInputs(options) {
     selectProps,
     formDefaultFieldProps,
     providerDefaultFieldProps,
-    conditions = [],
-    subscribesTo = []
+    conditions,
+    subscribesTo
   } = options;
+  const signature = JSON.stringify({
+    selectProps,
+    formDefaultFieldProps,
+    providerDefaultFieldProps,
+    conditions,
+    subscribesTo
+  });
   return react.useMemo(() => {
-    const inferred = [...subscribesTo];
+    const inferred = [...subscribesTo ?? []];
     if (providerDefaultFieldProps) {
       inferred.push(...core.inferFieldsFromDescriptor(providerDefaultFieldProps));
     }
@@ -576,17 +603,11 @@ function useInferredInputs(options) {
     if (selectProps) {
       inferred.push(...core.inferFieldsFromDescriptor(selectProps));
     }
-    if (conditions.length > 0) {
+    if (conditions && conditions.length > 0) {
       inferred.push(...core.inferFieldsFromConditions(conditions));
     }
     return [...new Set(inferred)];
-  }, [
-    providerDefaultFieldProps,
-    formDefaultFieldProps,
-    selectProps,
-    conditions,
-    subscribesTo
-  ]);
+  }, [signature]);
 }
 
 // src/hooks/useConditions.ts
@@ -1121,17 +1142,29 @@ function Field({
           }
         });
         const Component = inputConfig.component;
+        const isHostComponent = typeof inputConfig.component === "string";
         const template = inputConfig.template ?? providerConfig.inputTemplates[type] ?? providerConfig.defaultInputTemplate;
         const TemplateComponent = template;
-        const renderedField = TemplateComponent ? /* @__PURE__ */ jsxRuntime.jsx(
-          TemplateComponent,
-          {
-            Field: Component,
-            fieldProps: finalProps,
-            fieldState,
-            formState
-          }
-        ) : /* @__PURE__ */ jsxRuntime.jsx(Component, { ...finalProps });
+        let renderedField;
+        if (TemplateComponent) {
+          renderedField = /* @__PURE__ */ jsxRuntime.jsx(
+            TemplateComponent,
+            {
+              Field: Component,
+              fieldProps: finalProps,
+              fieldState,
+              formState
+            }
+          );
+        } else if (isHostComponent) {
+          const { forwardRef: hostRef, ...restHostProps } = finalProps;
+          renderedField = react.createElement(inputConfig.component, {
+            ...restHostProps,
+            ref: hostRef
+          });
+        } else {
+          renderedField = /* @__PURE__ */ jsxRuntime.jsx(Component, { ...finalProps });
+        }
         if (typeof children === "function") {
           const result = children({
             fieldState,