@inertiajs/core 2.2.20 → 2.3.0

package/dist/index.esm.js

@@ -539,6 +539,14 @@ var PrefetchedRequests = class {
       prefetched.response.then((response) => {
         const pageResponse = response.getPageResponse();
         page.mergeOncePropsIntoResponse(pageResponse, { force: true });
+        for (const [group, deferredProps] of Object.entries(pageResponse.deferredProps ?? {})) {
+          const remaining = deferredProps.filter((prop) => pageResponse.props[prop] === void 0);
+          if (remaining.length > 0) {
+            pageResponse.deferredProps[group] = remaining;
+          } else {
+            delete pageResponse.deferredProps[group];
+          }
+        }
         const oncePropExpiresIn = this.getShortestOncePropTtl(pageResponse);
         if (oncePropExpiresIn === null) {
           return;
@@ -1880,6 +1888,12 @@ var Response = class _Response {
         ...pageResponse.scrollProps || {}
       };
     }
+    if (page.hasOnceProps()) {
+      pageResponse.onceProps = {
+        ...page.get().onceProps || {},
+        ...pageResponse.onceProps || {}
+      };
+    }
   }
   mergeOrMatchItems(existingItems, newItems, matchProp, matchPropsOn, shouldAppend = true) {
     const items = Array.isArray(existingItems) ? existingItems : [];
@@ -2040,7 +2054,12 @@ var Request = class _Request {
     if (page2.version) {
       headers["X-Inertia-Version"] = page2.version;
     }
-    const onceProps = Object.entries(page2.onceProps || {}).filter(([, onceProp]) => !onceProp.expiresAt || onceProp.expiresAt > Date.now()).map(([key]) => key);
+    const onceProps = Object.entries(page2.onceProps || {}).filter(([, onceProp]) => {
+      if (page2.props[onceProp.prop] === void 0) {
+        return false;
+      }
+      return !onceProp.expiresAt || onceProp.expiresAt > Date.now();
+    }).map(([key]) => key);
     if (onceProps.length > 0) {
       headers["X-Inertia-Except-Once-Props"] = onceProps.join(",");
     }
@@ -2450,6 +2469,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) {
@@ -3758,7 +3879,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])];
@@ -3772,7 +3894,7 @@ function resetFormFields(formElement, defaults, fieldNames) {
       }
     }
   });
-  if (hasChanged) {
+  if (hasChanged && resetEntireForm) {
     formElement.dispatchEvent(new Event("reset", { bubbles: true }));
   }
 }
@@ -3780,6 +3902,7 @@ function resetFormFields(formElement, defaults, fieldNames) {
 // src/index.ts
 var router = new Router();
 export {
+  UseFormUtils,
   config,
   createHeadManager,
   formDataToObject,