@inertiajs/core 2.2.19 → 2.2.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inertiajs/core",
-  "version": "2.2.19",
+  "version": "2.2.20",
   "license": "MIT",
   "description": "A framework for creating server-driven single page apps.",
   "contributors": [

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/types.d.ts

@@ -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[];