@inertiajs/core 2.2.14 → 2.2.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inertiajs/core",
-  "version": "2.2.14",
+  "version": "2.2.16",
   "license": "MIT",
   "description": "A framework for creating server-driven single page apps.",
   "contributors": [
@@ -45,7 +45,7 @@
   },
   "dependencies": {
     "@types/lodash-es": "^4.17.12",
-    "axios": "^1.12.2",
+    "axios": "^1.13.2",
     "lodash-es": "^4.17.21",
     "qs": "^6.14.0"
   },
@@ -55,8 +55,8 @@
     "@types/nprogress": "^0.2.3",
     "@types/qs": "^6.14.0",
     "es-check": "^9.4.4",
-    "esbuild": "^0.25.11",
-    "esbuild-node-externals": "^1.18.0",
+    "esbuild": "^0.25.12",
+    "esbuild-node-externals": "^1.19.1",
     "typescript": "^5.9.3"
   },
   "scripts": {

package/types/config.d.ts

@@ -6,12 +6,17 @@ type ConfigValue<T, K extends ConfigKeys<T>> = K extends `${infer P}.${infer Res
 type ConfigSetObject<T> = {
     [K in ConfigKeys<T>]?: ConfigValue<T, K>;
 };
+type FirstLevelOptional<T> = {
+    [K in keyof T]?: T[K] extends object ? {
+        [P in keyof T[K]]?: T[K][P];
+    } : T[K];
+};
 export declare class Config<TConfig extends {} = {}> {
-    protected config: Partial<TConfig>;
+    protected config: FirstLevelOptional<TConfig>;
     protected defaults: TConfig;
     constructor(defaults: TConfig);
     extend<TExtension extends {}>(defaults?: TExtension): Config<TConfig & TExtension>;
-    replace(newConfig: Partial<TConfig>): void;
+    replace(newConfig: FirstLevelOptional<TConfig>): void;
     get<K extends ConfigKeys<TConfig>>(key: K): ConfigValue<TConfig, K>;
     set<K extends ConfigKeys<TConfig>>(keyOrValues: K | Partial<ConfigSetObject<TConfig>>, value?: ConfigValue<TConfig, K>): void;
 }

package/types/domUtils.d.ts

@@ -1,2 +1,3 @@
 export declare const getScrollableParent: (element: HTMLElement | null) => HTMLElement | null;
-export declare const getElementsInViewportFromCollection: (referenceElement: HTMLElement, elements: HTMLElement[]) => HTMLElement[];
+export declare const getElementsInViewportFromCollection: (elements: HTMLElement[], referenceElement?: HTMLElement) => HTMLElement[];
+export declare const requestAnimationFrame: (cb: () => void, times?: number) => void;

package/types/files.d.ts

@@ -1,2 +1,3 @@
 import { FormDataConvertible, RequestPayload } from './types';
+export declare const isFile: (value: unknown) => boolean;
 export declare function hasFiles(data: RequestPayload | FormDataConvertible): boolean;

package/types/formData.d.ts

@@ -1,3 +1,3 @@
-import { FormDataConvertible } from './types';
+import type { FormDataConvertible, QueryStringArrayFormatOption } from './types';
 export declare const isFormData: (value: any) => value is FormData;
-export declare function objectToFormData(source: Record<string, FormDataConvertible>, form?: FormData, parentKey?: string | null): FormData;
+export declare function objectToFormData(source: Record<string, FormDataConvertible>, form?: FormData, parentKey?: string | null, queryStringArrayFormat?: QueryStringArrayFormatOption): FormData;

package/types/router.d.ts

@@ -11,7 +11,7 @@ export declare class Router {
     delete<T extends RequestPayload = RequestPayload>(url: URL | string | UrlMethodPair, options?: Omit<VisitOptions<T>, 'method'>): void;
     reload<T extends RequestPayload = RequestPayload>(options?: ReloadOptions<T>): void;
     remember(data: unknown, key?: string): void;
-    restore(key?: string): unknown;
+    restore<T = unknown>(key?: string): T | undefined;
     on<TEventName extends GlobalEventNames>(type: TEventName, callback: (event: GlobalEvent<TEventName>) => GlobalEventResult<TEventName>): VoidFunction;
     cancel(): void;
     cancelAll(): void;

package/types/types.d.ts

@@ -41,10 +41,21 @@ export type FormDataConvertible = Array<FormDataConvertible> | {
 export type FormDataType<T extends object> = {
     [K in keyof T]: T[K] extends infer U ? U extends FormDataConvertibleValue ? U : U extends (...args: unknown[]) => unknown ? never : U extends object | Array<unknown> ? FormDataType<U> : never : never;
 };
-export type FormDataKeys<T> = T extends Function | FormDataConvertibleValue ? never : T extends Array<unknown> ? number extends T['length'] ? `${number}` | (0 extends 1 & T[number] ? never : `${number}.${FormDataKeys<T[number]>}`) : Extract<keyof T, `${number}`> | {
-    [Key in Extract<keyof T, `${number}`>]: 0 extends 1 & T[Key & string] ? never : `${Key & string}.${FormDataKeys<T[Key & string]> & string}`;
-}[Extract<keyof T, `${number}`>] : string extends keyof T ? string : Extract<keyof T, string> | {
-    [Key in Extract<keyof T, string>]: 0 extends 1 & T[Key] ? never : `${Key}.${FormDataKeys<T[Key]> & string}`;
+/**
+ * Uses `0 extends 1 & T` to detect `any` type and prevent infinite recursion.
+ */
+export type FormDataKeys<T> = T extends Function | FormDataConvertibleValue ? never : T extends unknown[] ? ArrayFormDataKeys<T> : T extends Record<string, unknown> ? ObjectFormDataKeys<T> : never;
+/**
+ * Helper type for array form data keys
+ */
+type ArrayFormDataKeys<T extends unknown[]> = number extends T['length'] ? `${number}` | (0 extends 1 & T[number] ? never : T[number] extends FormDataConvertibleValue ? never : `${number}.${FormDataKeys<T[number]>}`) : Extract<keyof T, `${number}`> | {
+    [Key in Extract<keyof T, `${number}`>]: 0 extends 1 & T[Key] ? never : T[Key] extends FormDataConvertibleValue ? never : `${Key & string}.${FormDataKeys<T[Key & string] & string>}`;
+}[Extract<keyof T, `${number}`>];
+/**
+ * Helper type for object form data keys
+ */
+type ObjectFormDataKeys<T extends Record<string, unknown>> = string extends keyof T ? string : Extract<keyof T, string> | {
+    [Key in Extract<keyof T, string>]: 0 extends 1 & T[Key] ? never : T[Key] extends FormDataConvertibleValue ? never : T[Key] extends any[] ? `${Key}.${FormDataKeys<T[Key]> & string}` : T[Key] extends Record<string, any> ? `${Key}.${FormDataKeys<T[Key]> & string}` : never;
 }[Extract<keyof T, string>];
 type PartialFormDataErrors<T> = {
     [K in string extends keyof T ? string : Extract<keyof FormDataError<T>, string>]?: ErrorValue;
@@ -110,6 +121,7 @@ export type PageHandler<ComponentType = Component> = ({ component, page, preserv
     preserveState: boolean;
 }) => Promise<unknown>;
 export type PreserveStateOption = boolean | 'errors' | ((page: Page) => boolean);
+export type QueryStringArrayFormatOption = 'indices' | 'brackets';
 export type Progress = AxiosProgressEvent;
 export type LocationVisit = {
     preserveScroll: boolean;
@@ -129,7 +141,7 @@ export type Visit<T extends RequestPayload = RequestPayload> = {
     headers: Record<string, string>;
     errorBag: string | null;
     forceFormData: boolean;
-    queryStringArrayFormat: 'indices' | 'brackets';
+    queryStringArrayFormat: QueryStringArrayFormatOption;
     async: boolean;
     showProgress: boolean;
     prefetch: boolean;
@@ -280,11 +292,16 @@ export type InternalActiveVisit = ActiveVisit & {
 };
 export type VisitId = unknown;
 export type Component = unknown;
+type FirstLevelOptional<T> = {
+    [K in keyof T]?: T[K] extends object ? {
+        [P in keyof T[K]]?: T[K][P];
+    } : T[K];
+};
 interface CreateInertiaAppOptions<TComponentResolver, TSetupOptions, TSetupReturn, TAdditionalInertiaAppConfig> {
     resolve: TComponentResolver;
     setup: (options: TSetupOptions) => TSetupReturn;
     title?: HeadManagerTitleCallback;
-    defaults?: Partial<InertiaAppConfig & TAdditionalInertiaAppConfig>;
+    defaults?: FirstLevelOptional<InertiaAppConfig & TAdditionalInertiaAppConfig>;
 }
 export interface CreateInertiaAppOptionsForCSR<SharedProps extends PageProps, TComponentResolver, TSetupOptions, TSetupReturn, TAdditionalInertiaAppConfig> extends CreateInertiaAppOptions<TComponentResolver, TSetupOptions, TSetupReturn, TAdditionalInertiaAppConfig> {
     id?: string;
@@ -331,12 +348,13 @@ export type InertiaAppConfig = {
         recentlySuccessfulDuration: number;
     };
     future: {
-        preserveEqualProps?: boolean;
-        useDataInertiaHeadAttribute?: boolean;
-        useDialogForErrorModal?: boolean;
+        preserveEqualProps: boolean;
+        useDataInertiaHeadAttribute: boolean;
+        useDialogForErrorModal: boolean;
     };
     prefetch: {
         cacheFor: CacheForOption | CacheForOption[];
+        hoverDelay: number;
     };
     visitOptions?: (href: string, options: VisitOptions) => VisitOptions;
 };

package/types/url.d.ts

@@ -1,8 +1,8 @@
-import { FormDataConvertible, Method, RequestPayload, UrlMethodPair, VisitOptions } from './types';
+import type { FormDataConvertible, Method, QueryStringArrayFormatOption, RequestPayload, UrlMethodPair, VisitOptions } from './types';
 export declare function hrefToUrl(href: string | URL): URL;
 export declare const transformUrlAndData: (href: string | URL, data: RequestPayload, method: Method, forceFormData: VisitOptions["forceFormData"], queryStringArrayFormat: VisitOptions["queryStringArrayFormat"]) => [URL, RequestPayload];
 type MergeDataIntoQueryStringDataReturnType<T extends RequestPayload> = T extends Record<string, FormDataConvertible> ? Record<string, FormDataConvertible> : RequestPayload;
-export declare function mergeDataIntoQueryString<T extends RequestPayload>(method: Method, href: URL | string, data: T, qsArrayFormat?: 'indices' | 'brackets'): [string, MergeDataIntoQueryStringDataReturnType<T>];
+export declare function mergeDataIntoQueryString<T extends RequestPayload>(method: Method, href: URL | string, data: T, qsArrayFormat?: QueryStringArrayFormatOption): [string, MergeDataIntoQueryStringDataReturnType<T>];
 export declare function urlWithoutHash(url: URL | Location): URL;
 export declare const setHashIfSameUrl: (originUrl: URL | Location, destinationUrl: URL | Location) => void;
 export declare const isSameUrlWithoutHash: (url1: URL | Location, url2: URL | Location) => boolean;