@formality-ui/react 0.2.4 → 0.2.5

package/dist/index.d.cts

@@ -593,6 +593,14 @@ interface FormProps<TFieldValues extends FieldValues = FieldValues> {
      * (`false` for immediate, or a number for a per-field delay).
      */
     debounce?: number | false;
+    /**
+     * React Hook Form validation trigger `mode`, forwarded to `useForm({ mode })`.
+     * One of `'onChange'` (default) | `'onBlur'` | `'onSubmit'` | `'onTouched'` |
+     * `'all'`. Honored as-is — auto-save is mode-agnostic: its validity gates
+     * trigger validation of the touched fields themselves via `methods.trigger`
+     * (which ignores `mode`), so it works under any mode. See PRD §12.
+     */
+    mode?: "onChange" | "onBlur" | "onSubmit" | "onTouched" | "all";
     /** Form-level validation */
     validate?: (values: Partial<TFieldValues>) => Record<string, string> | Promise<Record<string, string>>;
 }
@@ -644,7 +652,7 @@ interface FormRenderAPI<TFieldValues extends FieldValues = FieldValues> {
  * </Form>
  * ```
  */
-declare function Form<TFieldValues extends FieldValues = FieldValues>({ children, config, formConfig, onSubmit, record, autoSave, debounce: debounceMs, validate, }: FormProps<TFieldValues>): JSX.Element;
+declare function Form<TFieldValues extends FieldValues = FieldValues>({ children, config, formConfig, onSubmit, record, autoSave, debounce: debounceMs, mode, validate, }: FormProps<TFieldValues>): JSX.Element;
 
 /**
  * Field component props.

package/dist/index.d.ts

@@ -593,6 +593,14 @@ interface FormProps<TFieldValues extends FieldValues = FieldValues> {
      * (`false` for immediate, or a number for a per-field delay).
      */
     debounce?: number | false;
+    /**
+     * React Hook Form validation trigger `mode`, forwarded to `useForm({ mode })`.
+     * One of `'onChange'` (default) | `'onBlur'` | `'onSubmit'` | `'onTouched'` |
+     * `'all'`. Honored as-is — auto-save is mode-agnostic: its validity gates
+     * trigger validation of the touched fields themselves via `methods.trigger`
+     * (which ignores `mode`), so it works under any mode. See PRD §12.
+     */
+    mode?: "onChange" | "onBlur" | "onSubmit" | "onTouched" | "all";
     /** Form-level validation */
     validate?: (values: Partial<TFieldValues>) => Record<string, string> | Promise<Record<string, string>>;
 }
@@ -644,7 +652,7 @@ interface FormRenderAPI<TFieldValues extends FieldValues = FieldValues> {
  * </Form>
  * ```
  */
-declare function Form<TFieldValues extends FieldValues = FieldValues>({ children, config, formConfig, onSubmit, record, autoSave, debounce: debounceMs, validate, }: FormProps<TFieldValues>): JSX.Element;
+declare function Form<TFieldValues extends FieldValues = FieldValues>({ children, config, formConfig, onSubmit, record, autoSave, debounce: debounceMs, mode, validate, }: FormProps<TFieldValues>): JSX.Element;
 
 /**
  * Field component props.

package/dist/index.js

@@ -147,6 +147,7 @@ function Form({
   record,
   autoSave = false,
   debounce: debounceMs = 1e3,
+  mode,
   validate
 }) {
   const providerConfig = useConfigContext();
@@ -164,7 +165,7 @@ function Form({
     return resolveAllInitialValues(config, mergedInputs, record ?? {});
   }, [config, mergedInputs, record]);
   const methods = useForm({
-    mode: "onChange",
+    mode: mode ?? "onChange",
     defaultValues,
     values: record
   });
@@ -404,9 +405,20 @@ function Form({
     if (!validationsComplete || executionVersionRef.current !== executionVersion) {
       return;
     }
-    for (const fieldName of changedFields) {
-      const fieldState = methods.getFieldState(fieldName);
-      if (fieldState.error) {
+    const changedArray = [...changedFields];
+    if (changedArray.length > 0) {
+      const changedValid = await methods.trigger(changedArray);
+      if (executionVersionRef.current !== executionVersion) {
+        return;
+      }
+      if (!changedValid) {
+        return;
+      }
+      const changedValidationsComplete = await waitForFieldValidation(
+        changedArray,
+        executionVersion
+      );
+      if (!changedValidationsComplete || executionVersionRef.current !== executionVersion) {
         return;
       }
     }