@inertiajs/core 2.2.18 → 2.2.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inertiajs/core",
-  "version": "2.2.18",
+  "version": "2.2.20",
   "license": "MIT",
   "description": "A framework for creating server-driven single page apps.",
   "contributors": [
@@ -54,9 +54,9 @@
     "@types/node": "^18.19.130",
     "@types/nprogress": "^0.2.3",
     "@types/qs": "^6.14.0",
-    "es-check": "^9.4.4",
+    "es-check": "^9.4.5",
     "esbuild": "^0.25.12",
-    "esbuild-node-externals": "^1.19.1",
+    "esbuild-node-externals": "^1.20.1",
     "typescript": "^5.9.3"
   },
   "scripts": {

package/types/domUtils.d.ts

@@ -1,3 +1,4 @@
 export declare const getScrollableParent: (element: HTMLElement | null) => HTMLElement | null;
 export declare const getElementsInViewportFromCollection: (elements: HTMLElement[], referenceElement?: HTMLElement) => HTMLElement[];
 export declare const requestAnimationFrame: (cb: () => void, times?: number) => void;
+export declare const getInitialPageFromDOM: <T>(id: string, useScriptElement?: boolean) => T | null;

package/types/index.d.ts

@@ -1,7 +1,7 @@
 import { Config } from './config';
 import { Router } from './router';
 export { config } from './config';
-export { getScrollableParent } from './domUtils';
+export { getInitialPageFromDOM, getScrollableParent } from './domUtils';
 export { objectToFormData } from './formData';
 export { formDataToObject } from './formObject';
 export { default as createHeadManager } from './head';

package/types/page.d.ts

@@ -24,6 +24,7 @@ declare class CurrentPage {
     clear(): void;
     isCleared(): boolean;
     get(): Page;
+    hasOnceProps(): boolean;
     merge(data: Partial<Page>): void;
     setUrlHash(hash: string): void;
     remember(data: Page['rememberedState']): void;
@@ -37,6 +38,9 @@ declare class CurrentPage {
     isTheSame(page: Page): boolean;
     on(event: PageEvent, callback: VoidFunction): VoidFunction;
     fireEventsFor(event: PageEvent): void;
+    mergeOncePropsIntoResponse(response: Page, { force }?: {
+        force?: boolean;
+    }): void;
 }
 export declare const page: CurrentPage;
 export {};

package/types/prefetched.d.ts

@@ -1,5 +1,5 @@
 import { Response } from './response';
-import { ActiveVisit, CacheForOption, InFlightPrefetch, InternalActiveVisit, PrefetchedResponse, PrefetchOptions, PrefetchRemovalTimer } from './types';
+import { ActiveVisit, CacheForOption, InFlightPrefetch, InternalActiveVisit, Page, PrefetchedResponse, PrefetchOptions, PrefetchRemovalTimer } from './types';
 declare class PrefetchedRequests {
     protected cached: PrefetchedResponse[];
     protected inFlightRequests: InFlightPrefetch[];
@@ -21,6 +21,8 @@ declare class PrefetchedRequests {
     findInFlight(params: ActiveVisit): InFlightPrefetch | null;
     protected withoutPurposePrefetchHeader(params: ActiveVisit): ActiveVisit;
     protected paramsAreEqual(params1: ActiveVisit, params2: ActiveVisit): boolean;
+    updateCachedOncePropsFromCurrentPage(): void;
+    protected getShortestOncePropTtl(page: Page): number | null;
 }
 export declare const prefetchedRequests: PrefetchedRequests;
 export {};

package/types/requestParams.d.ts

@@ -12,6 +12,7 @@ export declare class RequestParams {
     data(): import("./types").RequestPayload | null;
     queryParams(): import("./types").RequestPayload;
     isPartial(): boolean;
+    isDeferredPropsRequest(): boolean;
     onCancelToken(cb: VoidFunction): void;
     markAsFinished(): void;
     markAsCancelled({ cancelled, interrupted }: {

package/types/response.d.ts

@@ -12,6 +12,7 @@ export declare class Response {
     handle(): Promise<void>;
     process(): Promise<boolean | void>;
     mergeParams(params: ActiveVisit): void;
+    getPageResponse(): Page;
     protected handleNonInertiaResponse(): Promise<boolean | void>;
     protected isInertiaResponse(): boolean;
     protected hasStatus(status: number): boolean;

package/types/router.d.ts

@@ -1,8 +1,10 @@
+import Queue from './queue';
 import { RequestStream } from './requestStream';
 import { ActiveVisit, ClientSideVisitOptions, Component, GlobalEvent, GlobalEventNames, GlobalEventResult, InFlightPrefetch, Page, PendingVisit, PendingVisitOptions, PollOptions, PrefetchedResponse, PrefetchOptions, ReloadOptions, RequestPayload, RouterInitParams, UrlMethodPair, VisitCallbacks, VisitHelperOptions, VisitOptions } from './types';
 export declare class Router {
     protected syncRequestStream: RequestStream;
     protected asyncRequestStream: RequestStream;
+    protected clientVisitQueue: Queue<Promise<void>>;
     init<ComponentType = Component>({ initialPage, resolveComponent, swapComponent, }: RouterInitParams<ComponentType>): void;
     get<T extends RequestPayload = RequestPayload>(url: URL | string | UrlMethodPair, data?: T, options?: VisitHelperOptions<T>): void;
     post<T extends RequestPayload = RequestPayload>(url: URL | string | UrlMethodPair, data?: T, options?: VisitHelperOptions<T>): void;
@@ -10,6 +12,9 @@ export declare class Router {
     patch<T extends RequestPayload = RequestPayload>(url: URL | string | UrlMethodPair, data?: T, options?: VisitHelperOptions<T>): void;
     delete<T extends RequestPayload = RequestPayload>(url: URL | string | UrlMethodPair, options?: Omit<VisitOptions<T>, 'method'>): void;
     reload<T extends RequestPayload = RequestPayload>(options?: ReloadOptions<T>): void;
+    protected doReload<T extends RequestPayload = RequestPayload>(options?: ReloadOptions<T> & {
+        deferredProps?: boolean;
+    }): void;
     remember(data: unknown, key?: string): void;
     restore<T = unknown>(key?: string): T | undefined;
     on<TEventName extends GlobalEventNames>(type: TEventName, callback: (event: GlobalEvent<TEventName>) => GlobalEventResult<TEventName>): VoidFunction;
@@ -37,6 +42,9 @@ export declare class Router {
     protected clientVisit<TProps = Page['props']>(params: ClientSideVisitOptions<TProps>, { replace }?: {
         replace?: boolean;
     }): void;
+    protected performClientVisit<TProps = Page['props']>(params: ClientSideVisitOptions<TProps>, { replace }?: {
+        replace?: boolean;
+    }): Promise<void>;
     protected getPrefetchParams(href: string | URL | UrlMethodPair, options: VisitOptions): ActiveVisit;
     protected getPendingVisit(href: string | URL | UrlMethodPair, options: VisitOptions, pendingVisitOptions?: Partial<PendingVisitOptions>): PendingVisit;
     protected getVisitEvents(options: VisitOptions): VisitCallbacks;

package/types/scroll.d.ts

@@ -3,6 +3,7 @@ export declare class Scroll {
     static save(): void;
     protected static regions(): NodeListOf<Element>;
     static reset(): void;
+    static scrollToAnchor(): void;
     static restore(scrollRegions: ScrollRegion[]): void;
     static restoreScrollRegions(scrollRegions: ScrollRegion[]): void;
     static restoreDocument(): void;

package/types/types.d.ts

@@ -44,7 +44,7 @@ export type FormDataType<T extends object> = {
 /**
  * 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;
+export type FormDataKeys<T> = T extends Function | FormDataConvertibleValue ? never : T extends unknown[] ? ArrayFormDataKeys<T> : T extends object ? ObjectFormDataKeys<T> : never;
 /**
  * Helper type for array form data keys
  */
@@ -54,8 +54,8 @@ type ArrayFormDataKeys<T extends unknown[]> = number extends T['length'] ? `${nu
 /**
  * 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;
+type ObjectFormDataKeys<T extends object> = 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}` : Exclude<T[Key], null | undefined> extends any[] ? never : Exclude<T[Key], null | undefined> extends Record<string, any> ? `${Key}.${FormDataKeys<Exclude<T[Key], null | undefined>> & string}` : never;
 }[Extract<keyof T, string>];
 type PartialFormDataErrors<T> = {
     [K in string extends keyof T ? string : Extract<keyof FormDataError<T>, string>]?: ErrorValue;
@@ -93,6 +93,10 @@ export interface Page<SharedProps extends PageProps = PageProps> {
     deepMergeProps?: string[];
     matchPropsOn?: string[];
     scrollProps?: Record<keyof PageProps, ScrollProp>;
+    onceProps?: Record<string, {
+        prop: keyof PageProps;
+        expiresAt?: number | null;
+    }>;
     /** @internal */
     rememberedState: Record<string, unknown>;
 }
@@ -289,6 +293,7 @@ export type ActiveVisit<T extends RequestPayload = RequestPayload> = PendingVisi
 export type InternalActiveVisit = ActiveVisit & {
     onPrefetchResponse?: (response: Response) => void;
     onPrefetchError?: (error: Error) => void;
+    deferredProps?: boolean;
 };
 export type VisitId = unknown;
 export type Component = unknown;
@@ -352,6 +357,7 @@ export type InertiaAppConfig = {
         preserveEqualProps: boolean;
         useDataInertiaHeadAttribute: boolean;
         useDialogForErrorModal: boolean;
+        useScriptElementForInitialPage: boolean;
     };
     prefetch: {
         cacheFor: CacheForOption | CacheForOption[];
@@ -381,6 +387,7 @@ export type PrefetchCancellationToken = {
 export type PrefetchedResponse = PrefetchObject & {
     staleTimestamp: number;
     timestamp: number;
+    expiresAt: number;
     singleUse: boolean;
     inFlight: false;
     tags: string[];
@@ -423,8 +430,8 @@ export type FormComponentProps = Partial<Pick<Visit, 'headers' | 'queryStringArr
 export type FormComponentMethods = {
     clearErrors: (...fields: string[]) => void;
     resetAndClearErrors: (...fields: string[]) => void;
-    setError(field: string, value: string): void;
-    setError(errors: Record<string, string>): void;
+    setError(field: string, value: ErrorValue): void;
+    setError(errors: Record<string, ErrorValue>): void;
     reset: (...fields: string[]) => void;
     submit: () => void;
     defaults: () => void;
@@ -433,7 +440,7 @@ export type FormComponentMethods = {
 };
 export type FormComponentonSubmitCompleteArguments = Pick<FormComponentMethods, 'reset' | 'defaults'>;
 export type FormComponentState = {
-    errors: Record<string, string>;
+    errors: Record<string, ErrorValue>;
     hasErrors: boolean;
     processing: boolean;
     progress: Progress | null;