@inertiajs/core 2.2.10 → 2.2.11

package/package.json

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

package/types/config.d.ts

@@ -0,0 +1,19 @@
+import { InertiaAppConfig } from './types';
+type ConfigKeys<T> = T extends Function ? never : string extends keyof T ? string : Extract<keyof T, string> | {
+    [Key in Extract<keyof T, string>]: T[Key] extends object ? `${Key}.${ConfigKeys<T[Key]> & string}` : never;
+}[Extract<keyof T, string>];
+type ConfigValue<T, K extends ConfigKeys<T>> = K extends `${infer P}.${infer Rest}` ? P extends keyof T ? Rest extends ConfigKeys<T[P]> ? ConfigValue<T[P], Rest> : never : never : K extends keyof T ? T[K] : never;
+type ConfigSetObject<T> = {
+    [K in ConfigKeys<T>]?: ConfigValue<T, K>;
+};
+export declare class Config<TConfig extends {} = {}> {
+    protected config: Partial<TConfig>;
+    protected defaults: TConfig;
+    constructor(defaults: TConfig);
+    extend<TExtension extends {}>(defaults?: TExtension): Config<TConfig & TExtension>;
+    replace(newConfig: Partial<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;
+}
+export declare const config: Config<InertiaAppConfig>;
+export {};

package/types/index.d.ts

@@ -1,4 +1,6 @@
+import { Config } from './config';
 import { Router } from './router';
+export { config } from './config';
 export { getScrollableParent } from './domUtils';
 export { objectToFormData } from './formData';
 export { formDataToObject } from './formObject';
@@ -9,5 +11,5 @@ export { hide as hideProgress, progress, reveal as revealProgress, default as se
 export { resetFormFields } from './resetFormFields';
 export * from './types';
 export { hrefToUrl, isUrlMethodPair, mergeDataIntoQueryString, urlHasProtocol, urlToString, urlWithoutHash, } from './url';
-export { type Router };
+export { type Config, type Router };
 export declare const router: Router;

package/types/response.d.ts

@@ -26,6 +26,7 @@ export declare class Response {
     protected getDataFromResponse(response: any): any;
     protected shouldSetPage(pageResponse: Page): boolean;
     protected pageUrl(pageResponse: Page): string;
+    protected preserveEqualProps(pageResponse: Page): void;
     protected mergeProps(pageResponse: Page): void;
     protected mergeOrMatchItems(existingItems: any[], newItems: any[], matchProp: string, matchPropsOn: string[], shouldAppend?: boolean): any[];
     protected appendWithMatching(existingItems: any[], newItems: any[], newItemsMap: Map<any, any>, uniqueProperty: string): any[];

package/types/time.d.ts

@@ -1 +1,2 @@
-export declare const timeToMs: (time: string | number) => number;
+import { CacheForOption } from './types';
+export declare const timeToMs: (time: CacheForOption) => number;

package/types/types.d.ts

@@ -278,12 +278,13 @@ export type InternalActiveVisit = ActiveVisit & {
 };
 export type VisitId = unknown;
 export type Component = unknown;
-interface CreateInertiaAppOptions<TComponentResolver, TSetupOptions, TSetupReturn> {
+interface CreateInertiaAppOptions<TComponentResolver, TSetupOptions, TSetupReturn, TAdditionalInertiaAppConfig> {
     resolve: TComponentResolver;
     setup: (options: TSetupOptions) => TSetupReturn;
     title?: HeadManagerTitleCallback;
+    defaults?: Partial<InertiaAppConfig & TAdditionalInertiaAppConfig>;
 }
-export interface CreateInertiaAppOptionsForCSR<SharedProps extends PageProps, TComponentResolver, TSetupOptions, TSetupReturn> extends CreateInertiaAppOptions<TComponentResolver, TSetupOptions, TSetupReturn> {
+export interface CreateInertiaAppOptionsForCSR<SharedProps extends PageProps, TComponentResolver, TSetupOptions, TSetupReturn, TAdditionalInertiaAppConfig> extends CreateInertiaAppOptions<TComponentResolver, TSetupOptions, TSetupReturn, TAdditionalInertiaAppConfig> {
     id?: string;
     page?: Page<SharedProps>;
     progress?: false | {
@@ -294,7 +295,7 @@ export interface CreateInertiaAppOptionsForCSR<SharedProps extends PageProps, TC
     };
     render?: undefined;
 }
-export interface CreateInertiaAppOptionsForSSR<SharedProps extends PageProps, TComponentResolver, TSetupOptions, TSetupReturn> extends CreateInertiaAppOptions<TComponentResolver, TSetupOptions, TSetupReturn> {
+export interface CreateInertiaAppOptionsForSSR<SharedProps extends PageProps, TComponentResolver, TSetupOptions, TSetupReturn, TAdditionalInertiaAppConfig> extends CreateInertiaAppOptions<TComponentResolver, TSetupOptions, TSetupReturn, TAdditionalInertiaAppConfig> {
     id?: undefined;
     page: Page<SharedProps>;
     progress?: undefined;
@@ -316,11 +317,24 @@ export type HeadManager = {
     };
 };
 export type LinkPrefetchOption = 'mount' | 'hover' | 'click';
-export type CacheForOption = number | string;
+export type TimeUnit = 'ms' | 's' | 'm' | 'h' | 'd';
+export type CacheForOption = number | `${number}${TimeUnit}` | string;
 export type PrefetchOptions = {
     cacheFor: CacheForOption | CacheForOption[];
     cacheTags: string | string[];
 };
+export type InertiaAppConfig = {
+    form: {
+        recentlySuccessfulDuration: number;
+    };
+    future: {
+        preserveEqualProps: boolean;
+    };
+    prefetch: {
+        cacheFor: CacheForOption | CacheForOption[];
+    };
+    visitOptions?: (href: string, options: VisitOptions) => VisitOptions;
+};
 export interface LinkComponentBaseProps extends Partial<Pick<Visit<RequestPayload>, 'data' | 'method' | 'replace' | 'preserveScroll' | 'preserveState' | 'preserveUrl' | 'only' | 'except' | 'headers' | 'queryStringArrayFormat' | 'async'> & VisitCallbacks & {
     href: string | UrlMethodPair;
     prefetch: boolean | LinkPrefetchOption | LinkPrefetchOption[];