@inertiajs/core 2.2.21 → 2.3.0

package/dist/index.js

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  UseFormUtils: () => UseFormUtils,
   config: () => config,
   createHeadManager: () => createHeadManager,
   formDataToObject: () => formDataToObject,
@@ -2525,6 +2526,108 @@ var Router = class {
   }
 };
 
+// src/useFormUtils.ts
+var UseFormUtils = class {
+  /**
+   * Creates a callback that returns a UrlMethodPair.
+   *
+   * createWayfinderCallback(urlMethodPair)
+   * createWayfinderCallback(method, url)
+   * createWayfinderCallback(() => urlMethodPair)
+   * createWayfinderCallback(() => method, () => url)
+   */
+  static createWayfinderCallback(...args) {
+    return () => {
+      if (args.length === 1) {
+        return isUrlMethodPair(args[0]) ? args[0] : args[0]();
+      }
+      return {
+        method: typeof args[0] === "function" ? args[0]() : args[0],
+        url: typeof args[1] === "function" ? args[1]() : args[1]
+      };
+    };
+  }
+  /**
+   * Parses all useForm() arguments into { rememberKey, data, precognitionEndpoint }.
+   *
+   * useForm(data)
+   * useForm(rememberKey, data)
+   * useForm(method, url, data)
+   * useForm(urlMethodPair, data)
+   *
+   */
+  static parseUseFormArguments(...args) {
+    if (args.length === 1) {
+      return {
+        rememberKey: null,
+        data: args[0],
+        precognitionEndpoint: null
+      };
+    }
+    if (args.length === 2) {
+      if (typeof args[0] === "string") {
+        return {
+          rememberKey: args[0],
+          data: args[1],
+          precognitionEndpoint: null
+        };
+      }
+      return {
+        rememberKey: null,
+        data: args[1],
+        precognitionEndpoint: this.createWayfinderCallback(args[0])
+      };
+    }
+    return {
+      rememberKey: null,
+      data: args[2],
+      precognitionEndpoint: this.createWayfinderCallback(args[0], args[1])
+    };
+  }
+  /**
+   * Parses all submission arguments into { method, url, options }.
+   * It uses the Precognition endpoint if no explicit method/url are provided.
+   *
+   * form.submit(method, url)
+   * form.submit(method, url, options)
+   * form.submit(urlMethodPair)
+   * form.submit(urlMethodPair, options)
+   * form.submit()
+   * form.submit(options)
+   */
+  static parseSubmitArguments(args, precognitionEndpoint) {
+    if (args.length === 3 || args.length === 2 && typeof args[0] === "string") {
+      return { method: args[0], url: args[1], options: args[2] ?? {} };
+    }
+    if (isUrlMethodPair(args[0])) {
+      return { ...args[0], options: args[1] ?? {} };
+    }
+    return { ...precognitionEndpoint(), options: args[0] ?? {} };
+  }
+  /**
+   * Merges headers into the Precognition validate() arguments.
+   */
+  static mergeHeadersForValidation(field, config2, headers) {
+    const merge = (config3) => {
+      config3.headers = {
+        ...headers ?? {},
+        ...config3.headers ?? {}
+      };
+      return config3;
+    };
+    if (field && typeof field === "object" && !("target" in field)) {
+      field = merge(field);
+    } else if (config2 && typeof config2 === "object") {
+      config2 = merge(config2);
+    } else if (typeof field === "string") {
+      config2 = merge(config2 ?? {});
+    } else {
+      field = merge(field ?? {});
+    }
+    return [field, config2];
+  }
+};
+
 // src/domUtils.ts
 var elementInViewport = (el) => {
   if (el.offsetParent === null) {
@@ -3833,7 +3936,8 @@ function resetFormFields(formElement, defaults, fieldNames) {
   if (!formElement) {
     return;
   }
-  if (!fieldNames || fieldNames.length === 0) {
+  const resetEntireForm = !fieldNames || fieldNames.length === 0;
+  if (resetEntireForm) {
     const formData = new FormData(formElement);
     const formElementNames = Array.from(formElement.elements).map((el) => isFormElement(el) ? el.name : "").filter(Boolean);
     fieldNames = [.../* @__PURE__ */ new Set([...defaults.keys(), ...formData.keys(), ...formElementNames])];
@@ -3847,7 +3951,7 @@ function resetFormFields(formElement, defaults, fieldNames) {
       }
     }
   });
-  if (hasChanged) {
+  if (hasChanged && resetEntireForm) {
     formElement.dispatchEvent(new Event("reset", { bubbles: true }));
   }
 }