@inertiajs/core 2.3.17 → 3.0.0-beta.1

package/dist/ssrErrors.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/ssrErrors.ts"],
+  "sourcesContent": ["/**\n * SSR Error Classification\n *\n * This module detects common SSR errors and provides helpful hints\n * to developers on how to fix them. The most common issue is using\n * browser-specific APIs (like window, document) that don't exist\n * in the Node.js server environment.\n */\n\nexport type SSRErrorType = 'browser-api' | 'component-resolution' | 'render' | 'unknown'\n\ntype SourceMapResolver = (\n  file: string,\n  line: number,\n  column: number,\n) => { file: string; line: number; column: number } | null\n\nlet sourceMapResolver: SourceMapResolver | null = null\n\nexport function setSourceMapResolver(resolver: SourceMapResolver | null): void {\n  sourceMapResolver = resolver\n}\n\nexport interface ClassifiedSSRError {\n  error: string\n  type: SSRErrorType\n  component?: string\n  url?: string\n  browserApi?: string\n  hint: string\n  stack?: string\n  sourceLocation?: string\n  timestamp: string\n}\n\nconst BROWSER_APIS: Record<string, string> = {\n  // Global objects\n  window: 'The global window object',\n  document: 'The DOM document object',\n  navigator: 'The navigator object',\n  location: 'The location object',\n  history: 'The browser history API',\n  screen: 'The screen object',\n  localStorage: 'Browser local storage',\n  sessionStorage: 'Browser session storage',\n\n  // Viewport properties (accessed via window.X)\n  innerWidth: 'Browser viewport width',\n  innerHeight: 'Browser viewport height',\n  outerWidth: 'Browser window width',\n  outerHeight: 'Browser window height',\n  scrollX: 'Horizontal scroll position',\n  scrollY: 'Vertical scroll position',\n  devicePixelRatio: 'The device pixel ratio',\n  matchMedia: 'The matchMedia function',\n\n  // Observers (commonly instantiated at module level)\n  IntersectionObserver: 'The IntersectionObserver API',\n  ResizeObserver: 'The ResizeObserver API',\n  MutationObserver: 'The MutationObserver API',\n\n  // Timing functions (commonly called at module level)\n  requestAnimationFrame: 'The requestAnimationFrame function',\n  requestIdleCallback: 'The requestIdleCallback function',\n\n  // Constructors that might be used at module level\n  Image: 'The Image constructor',\n  Audio: 'The Audio constructor',\n  Worker: 'The Worker constructor',\n  BroadcastChannel: 'The BroadcastChannel constructor',\n\n  // Network (older Node.js versions)\n  fetch: 'The fetch API',\n  XMLHttpRequest: 'The XMLHttpRequest API',\n}\n\nfunction detectBrowserApi(error: Error): string | null {\n  const message = error.message.toLowerCase()\n\n  for (const api of Object.keys(BROWSER_APIS)) {\n    const patterns = [\n      `${api.toLowerCase()} is not defined`,\n      `'${api.toLowerCase()}' is not defined`,\n      `\"${api.toLowerCase()}\" is not defined`,\n      `cannot read properties of undefined (reading '${api.toLowerCase()}')`,\n      `cannot read property '${api.toLowerCase()}'`,\n    ]\n\n    if (patterns.some((pattern) => message.includes(pattern))) {\n      return api\n    }\n  }\n\n  return null\n}\n\nfunction isComponentResolutionError(error: Error): boolean {\n  const message = error.message.toLowerCase()\n\n  return (\n    message.includes('cannot find module') ||\n    message.includes('failed to resolve') ||\n    message.includes('module not found') ||\n    message.includes('could not resolve')\n  )\n}\n\nconst LIFECYCLE_HOOKS = 'onMounted/useEffect/onMount'\n\nfunction getBrowserApiHint(api: string): string {\n  const apiDescription = BROWSER_APIS[api] || `The \"${api}\" object`\n\n  if (['localStorage', 'sessionStorage'].includes(api)) {\n    return (\n      `${apiDescription} doesn't exist in Node.js. ` +\n      `Check \"typeof ${api} !== 'undefined'\" before using it, ` +\n      `or move the code to a ${LIFECYCLE_HOOKS} lifecycle hook.`\n    )\n  }\n\n  if (['window', 'document'].includes(api)) {\n    return (\n      `${apiDescription} doesn't exist in Node.js. ` +\n      `Wrap browser-specific code in a ${LIFECYCLE_HOOKS} lifecycle hook, ` +\n      `or check \"typeof ${api} !== 'undefined'\" before using it.`\n    )\n  }\n\n  if (['IntersectionObserver', 'ResizeObserver', 'MutationObserver'].includes(api)) {\n    return (\n      `${apiDescription} doesn't exist in Node.js. ` +\n      `Create observers inside a ${LIFECYCLE_HOOKS} lifecycle hook, not at the module level.`\n    )\n  }\n\n  if (['fetch', 'XMLHttpRequest'].includes(api)) {\n    return (\n      `${apiDescription} may not be available in all Node.js versions. ` +\n      `For SSR, ensure data fetching happens on the server (in your controller) ` +\n      `and is passed as props, or use a ${LIFECYCLE_HOOKS} hook for client-side fetching.`\n    )\n  }\n\n  return (\n    `${apiDescription} doesn't exist in Node.js. ` +\n    `Move this code to a ${LIFECYCLE_HOOKS} lifecycle hook, or guard it with ` +\n    `\"typeof ${api} !== 'undefined'\".`\n  )\n}\n\nfunction getComponentResolutionHint(component?: string): string {\n  const componentPart = component ? ` \"${component}\"` : ''\n\n  return (\n    `Could not resolve component${componentPart}. ` +\n    `Check that the file exists and the path is correct. ` +\n    `Ensure the component name matches the file name exactly (case-sensitive).`\n  )\n}\n\nfunction getRenderErrorHint(): string {\n  return (\n    'An error occurred while rendering the component. ' +\n    'Check the component for browser-specific code that runs during initialization. ' +\n    'Move any code that accesses browser APIs to a lifecycle hook.'\n  )\n}\n\nfunction extractSourceLocation(stack?: string): string | undefined {\n  if (!stack) {\n    return undefined\n  }\n\n  for (const line of stack.split('\\n')) {\n    if (!line.includes('at ')) {\n      continue\n    }\n\n    if (line.includes('node_modules') || line.includes('node:')) {\n      continue\n    }\n\n    let match = line.match(/\\(([^)]+):(\\d+):(\\d+)\\)/)\n\n    if (!match) {\n      match = line.match(/at\\s+(?:file:\\/\\/)?(.+):(\\d+):(\\d+)\\s*$/)\n    }\n\n    if (match) {\n      const file = match[1].replace(/^file:\\/\\//, '')\n      const lineNum = parseInt(match[2], 10)\n      const colNum = parseInt(match[3], 10)\n\n      if (sourceMapResolver) {\n        const resolved = sourceMapResolver(file, lineNum, colNum)\n\n        if (resolved) {\n          return `${resolved.file}:${resolved.line}:${resolved.column}`\n        }\n      }\n\n      return `${file}:${lineNum}:${colNum}`\n    }\n  }\n\n  return undefined\n}\n\nexport function classifySSRError(error: Error, component?: string, url?: string): ClassifiedSSRError {\n  const timestamp = new Date().toISOString()\n  const base = {\n    error: error.message,\n    component,\n    url,\n    stack: error.stack,\n    sourceLocation: extractSourceLocation(error.stack),\n    timestamp,\n  }\n\n  const browserApi = detectBrowserApi(error)\n\n  if (browserApi) {\n    return {\n      ...base,\n      type: 'browser-api',\n      browserApi,\n      hint: getBrowserApiHint(browserApi),\n    }\n  }\n\n  if (isComponentResolutionError(error)) {\n    return {\n      ...base,\n      type: 'component-resolution',\n      hint: getComponentResolutionHint(component),\n    }\n  }\n\n  return {\n    ...base,\n    type: 'render',\n    hint: getRenderErrorHint(),\n  }\n}\n\nconst colors = {\n  reset: '\\x1b[0m',\n  red: '\\x1b[31m',\n  yellow: '\\x1b[33m',\n  cyan: '\\x1b[36m',\n  dim: '\\x1b[2m',\n  bold: '\\x1b[1m',\n  bgRed: '\\x1b[41m',\n  white: '\\x1b[37m',\n}\n\nfunction makeRelative(path: string, root?: string): string {\n  const base = root ?? process.cwd()\n\n  if (path.startsWith(base + '/')) {\n    return path.slice(base.length + 1)\n  }\n\n  return path\n}\n\nexport function formatConsoleError(\n  classified: ClassifiedSSRError,\n  root?: string,\n  handleErrors: boolean = true,\n  suppressedWarnings: string[] = [],\n): string {\n  if (!handleErrors) {\n    const component = classified.component ? `[${classified.component}]` : ''\n    return `SSR Error ${component}: ${classified.error}`\n  }\n\n  const componentPart = classified.component ? `  ${colors.cyan}${classified.component}${colors.reset}` : ''\n\n  const lines = [\n    '',\n    `  ${colors.bgRed}${colors.white}${colors.bold} SSR ERROR ${colors.reset}${componentPart}`,\n    '',\n    `  ${classified.error}`,\n  ]\n\n  if (classified.sourceLocation) {\n    const relativePath = makeRelative(classified.sourceLocation, root)\n    lines.push(`  ${colors.dim}Source: ${relativePath}${colors.reset}`)\n  }\n\n  if (classified.url) {\n    lines.push(`  ${colors.dim}URL: ${classified.url}${colors.reset}`)\n  }\n\n  lines.push('', `  ${colors.yellow}Hint${colors.reset}  ${classified.hint}`, '')\n\n  if (classified.stack) {\n    lines.push(`  ${colors.dim}${classified.stack.split('\\n').join('\\n  ')}${colors.reset}`, '')\n  }\n\n  if (suppressedWarnings.length > 0) {\n    lines.push(`  ${colors.dim}Suppressed ${suppressedWarnings.length} framework warning(s).${colors.reset}`, '')\n  }\n\n  return lines.join('\\n')\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inertiajs/core",
-  "version": "2.3.17",
+  "version": "3.0.0-beta.1",
   "license": "MIT",
   "description": "A framework for creating server-driven single page apps.",
   "contributors": [
@@ -11,7 +11,7 @@
   "homepage": "https://inertiajs.com/",
   "repository": {
     "type": "git",
-    "url": "https://github.com/inertiajs/inertia.git",
+    "url": "git+https://github.com/inertiajs/inertia.git",
     "directory": "packages/inertia"
   },
   "bugs": {
@@ -27,36 +27,49 @@
   "exports": {
     ".": {
       "types": "./types/index.d.ts",
-      "import": "./dist/index.esm.js",
-      "require": "./dist/index.js"
+      "import": "./dist/index.js"
     },
     "./server": {
       "types": "./types/server.d.ts",
-      "import": "./dist/server.esm.js",
-      "require": "./dist/server.js"
+      "import": "./dist/server.js"
+    },
+    "./ssrErrors": {
+      "types": "./types/ssrErrors.d.ts",
+      "import": "./dist/ssrErrors.js"
     }
   },
   "typesVersions": {
     "*": {
       "server": [
         "types/server.d.ts"
+      ],
+      "ssrErrors": [
+        "types/ssrErrors.d.ts"
       ]
     }
   },
   "dependencies": {
+    "@jridgewell/trace-mapping": "^0.3.31",
     "@types/lodash-es": "^4.17.12",
-    "axios": "^1.13.5",
-    "laravel-precognition": "^1.0.2",
-    "lodash-es": "^4.17.23",
-    "qs": "^6.15.0"
+    "laravel-precognition": "2.0.0-beta.2",
+    "lodash-es": "^4.17.23"
+  },
+  "peerDependencies": {
+    "axios": "^1.13.2"
+  },
+  "peerDependenciesMeta": {
+    "axios": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "@types/node": "^18.19.130",
-    "@types/qs": "^6.14.0",
+    "@types/node": "^24.10.13",
+    "axios": "^1.13.5",
     "es-check": "^9.6.1",
     "esbuild": "^0.27.3",
     "esbuild-node-externals": "^1.20.1",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
   },
   "scripts": {
     "build": "pnpm clean && ./build.js && tsc",
@@ -65,6 +78,7 @@
     "dev": "pnpx concurrently -c \"#ffcf00,#3178c6\" \"pnpm dev:build\" \"pnpm dev:types\" --names build,types",
     "dev:build": "./build.js --watch",
     "dev:types": "tsc --watch --preserveWatchOutput",
-    "es2020-check": "pnpm build:with-deps && es-check es2020 \"dist/index.esm.js\" --checkFeatures --module --noCache --verbose"
+    "es2020-check": "pnpm build:with-deps && es-check es2020 \"dist/index.js\" --checkFeatures --module --noCache --verbose",
+    "test": "vitest run"
   }
 }

package/types/axiosHttpClient.d.ts

@@ -0,0 +1,16 @@
+import type { AxiosInstance } from 'axios';
+import { HttpClient, HttpRequestConfig, HttpResponse } from './types';
+/**
+ * HTTP client implementation using Axios
+ */
+export declare class AxiosHttpClient implements HttpClient {
+    private axios?;
+    constructor(instance?: AxiosInstance);
+    private getAxios;
+    request(config: HttpRequestConfig): Promise<HttpResponse>;
+    protected doRequest(config: HttpRequestConfig): Promise<HttpResponse>;
+}
+/**
+ * Create an Axios HTTP client adapter
+ */
+export declare function axiosAdapter(instance?: AxiosInstance): HttpClient;

package/types/dialog.d.ts

@@ -1,4 +1,8 @@
 declare const _default: {
+    createIframeAndPage(html: Record<string, unknown> | string): {
+        iframe: HTMLIFrameElement;
+        page: HTMLElement;
+    };
     show(html: Record<string, unknown> | string): void;
 };
 export default _default;

package/types/domUtils.d.ts

@@ -1,4 +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;
+export declare const getInitialPageFromDOM: <T>(id: string) => T | null;

package/types/events.d.ts

@@ -1,9 +1,9 @@
 import { GlobalEventTrigger } from './types';
 export declare const fireBeforeEvent: GlobalEventTrigger<'before'>;
 export declare const fireErrorEvent: GlobalEventTrigger<'error'>;
-export declare const fireExceptionEvent: GlobalEventTrigger<'exception'>;
+export declare const fireNetworkErrorEvent: GlobalEventTrigger<'networkError'>;
 export declare const fireFinishEvent: GlobalEventTrigger<'finish'>;
-export declare const fireInvalidEvent: GlobalEventTrigger<'invalid'>;
+export declare const fireHttpExceptionEvent: GlobalEventTrigger<'httpException'>;
 export declare const fireBeforeUpdateEvent: GlobalEventTrigger<'beforeUpdate'>;
 export declare const fireNavigateEvent: GlobalEventTrigger<'navigate'>;
 export declare const fireProgressEvent: GlobalEventTrigger<'progress'>;

package/types/http.d.ts

@@ -0,0 +1,38 @@
+import { HttpClient, HttpClientOptions } from './types';
+export declare const http: {
+    /**
+     * Get the current HTTP client
+     */
+    getClient(): HttpClient;
+    /**
+     * Set the HTTP client to use for all Inertia requests
+     */
+    setClient(clientOrOptions: HttpClient | HttpClientOptions): void;
+    /**
+     * Register a request handler that runs before each request
+     */
+    onRequest: (handler: import("./types").HttpRequestHandler) => () => void;
+    /**
+     * Register a response handler that runs after each successful response
+     */
+    onResponse: (handler: import("./types").HttpResponseHandler) => () => void;
+    /**
+     * Register an error handler that runs when a request fails
+     */
+    onError: (handler: import("./types").HttpErrorHandler) => () => void;
+    /**
+     * Process a request config through all registered request handlers.
+     * For use by custom HttpClient implementations.
+     */
+    processRequest: (config: import("./types").HttpRequestConfig) => Promise<import("./types").HttpRequestConfig>;
+    /**
+     * Process a response through all registered response handlers.
+     * For use by custom HttpClient implementations.
+     */
+    processResponse: (response: import("./types").HttpResponse) => Promise<import("./types").HttpResponse>;
+    /**
+     * Process an error through all registered error handlers.
+     * For use by custom HttpClient implementations.
+     */
+    processError: (error: import("./httpErrors").HttpResponseError | import("./httpErrors").HttpNetworkError | import("./httpErrors").HttpCancelledError) => Promise<void>;
+};

package/types/httpErrors.d.ts

@@ -0,0 +1,16 @@
+import { HttpResponse } from './types';
+export declare class HttpResponseError extends Error {
+    readonly response: HttpResponse;
+    readonly url?: string;
+    constructor(message: string, response: HttpResponse, url?: string);
+}
+export declare class HttpCancelledError extends Error {
+    readonly url?: string;
+    constructor(message?: string, url?: string);
+}
+export declare class HttpNetworkError extends Error {
+    readonly cause?: Error;
+    readonly code = "ERR_NETWORK";
+    readonly url?: string;
+    constructor(message: string, url?: string, cause?: Error);
+}

package/types/httpHandlers.d.ts

@@ -0,0 +1,15 @@
+import { HttpCancelledError, HttpNetworkError, HttpResponseError } from './httpErrors';
+import { HttpErrorHandler, HttpRequestConfig, HttpRequestHandler, HttpResponse, HttpResponseHandler } from './types';
+declare class HttpHandlers {
+    protected requestHandlers: HttpRequestHandler[];
+    protected responseHandlers: HttpResponseHandler[];
+    protected errorHandlers: HttpErrorHandler[];
+    onRequest(handler: HttpRequestHandler): () => void;
+    onResponse(handler: HttpResponseHandler): () => void;
+    onError(handler: HttpErrorHandler): () => void;
+    processRequest(config: HttpRequestConfig): Promise<HttpRequestConfig>;
+    processResponse(response: HttpResponse): Promise<HttpResponse>;
+    processError(error: HttpResponseError | HttpNetworkError | HttpCancelledError): Promise<void>;
+}
+export declare const httpHandlers: HttpHandlers;
+export {};

package/types/index.d.ts

@@ -1,16 +1,23 @@
 import { Config } from './config';
 import { Router } from './router';
 export { UseFormUtils } from './useFormUtils';
+export { axiosAdapter } from './axiosHttpClient';
 export { config } from './config';
 export { getInitialPageFromDOM, getScrollableParent } from './domUtils';
+export { hasFiles } from './files';
 export { objectToFormData } from './formData';
 export { formDataToObject } from './formObject';
 export { default as createHeadManager } from './head';
+export { http } from './http';
+export { HttpCancelledError, HttpNetworkError, HttpResponseError } from './httpErrors';
 export { default as useInfiniteScroll } from './infiniteScroll';
+export { createLayoutPropsStore, mergeLayoutProps, normalizeLayouts, type LayoutDefinition, type LayoutPropsStore, } from './layout';
 export { shouldIntercept, shouldNavigate } from './navigationEvents';
-export { hide as hideProgress, progress, reveal as revealProgress, default as setupProgress } from './progress';
+export { progress, default as setupProgress } from './progress';
 export { FormComponentResetSymbol, resetFormFields } from './resetFormFields';
+export { buildSSRBody } from './ssrUtils';
 export * from './types';
-export { hrefToUrl, isUrlMethodPair, mergeDataIntoQueryString, urlHasProtocol, urlToString, urlWithoutHash, } from './url';
+export { hrefToUrl, isSameUrlWithoutQueryOrHash, isUrlMethodPair, mergeDataIntoQueryString, resolveUrlMethodPairComponent, urlHasProtocol, urlToString, urlWithoutHash, } from './url';
+export { XhrHttpClient, xhrHttpClient } from './xhrHttpClient';
 export { type Config, type Router };
 export declare const router: Router;

package/types/layout.d.ts

@@ -0,0 +1,38 @@
+export interface LayoutDefinition<Component> {
+    component: Component;
+    props: Record<string, unknown>;
+    name?: string;
+}
+export interface LayoutPropsStore {
+    set(props: Record<string, unknown>): void;
+    setFor(name: string, props: Record<string, unknown>): void;
+    get(): {
+        shared: Record<string, unknown>;
+        named: Record<string, Record<string, unknown>>;
+    };
+    reset(): void;
+    subscribe(callback: () => void): () => void;
+}
+export declare function createLayoutPropsStore(): LayoutPropsStore;
+/**
+ * Merges layout props from three sources with priority: dynamic > static > defaults.
+ * Only keys present in `defaults` are included in the result.
+ *
+ * @example
+ * ```ts
+ * mergeLayoutProps(
+ *   { title: 'Default', showSidebar: true },  // defaults declared in useLayoutProps()
+ *   { title: 'My Page', color: 'blue' },       // static props from layout definition
+ *   { showSidebar: false, fontSize: 16 },       // dynamic props from setLayoutProps()
+ * )
+ * // => { title: 'My Page', showSidebar: false }
+ * // 'color' and 'fontSize' are excluded because they're not declared in defaults
+ * ```
+ */
+export declare function mergeLayoutProps<T extends Record<string, unknown>>(defaults: T, staticProps: Record<string, unknown>, dynamicProps: Record<string, unknown>): T;
+type ComponentCheck<T> = (value: unknown) => value is T;
+/**
+ * Normalizes layout definitions into a consistent structure.
+ */
+export declare function normalizeLayouts<T>(layout: unknown, isComponent: ComponentCheck<T>, isRenderFunction?: (value: unknown) => boolean): LayoutDefinition<T>[];
+export {};

package/types/page.d.ts

@@ -29,6 +29,7 @@ declare class CurrentPage {
     getWithoutFlashData(): Page;
     hasOnceProps(): boolean;
     merge(data: Partial<Page>): void;
+    setPropsQuietly(props: Page['props']): Promise<unknown>;
     setFlash(flash: FlashData): void;
     setUrlHash(hash: string): void;
     remember(data: Page['rememberedState']): void;
@@ -38,7 +39,9 @@ declare class CurrentPage {
         preserveState: boolean;
         viewTransition: Visit['viewTransition'];
     }): Promise<unknown>;
-    resolve(component: string): Promise<Component>;
+    resolve(component: string, page?: Page): Promise<Component>;
+    recordOptimisticUpdate(keys: string[], updatedAt: number): void;
+    shouldPreserveOptimistic(key: string, updatedAt: number): boolean;
     isTheSame(page: Page): boolean;
     on(event: PageEvent, callback: VoidFunction): VoidFunction;
     fireEventsFor(event: PageEvent): void;

package/types/progress.d.ts

@@ -1,3 +1,4 @@
+import { ProgressOptions } from './types';
 declare class Progress {
     hideCount: number;
     start(): void;
@@ -11,12 +12,5 @@ declare class Progress {
     getStatus(): number | null;
 }
 export declare const progress: Progress;
-export declare const reveal: (force?: boolean) => void;
-export declare const hide: () => void;
-export default function setupProgress({ delay, color, includeCSS, showSpinner, }?: {
-    delay?: number | undefined;
-    color?: string | undefined;
-    includeCSS?: boolean | undefined;
-    showSpinner?: boolean | undefined;
-}): void;
+export default function setupProgress({ delay, color, includeCSS, showSpinner, popover, }?: ProgressOptions): void;
 export {};

package/types/queryString.d.ts

@@ -0,0 +1,13 @@
+import type { QueryStringArrayFormatOption } from './types';
+/**
+ * Returns true if the given URL query string contains indexed array parameters.
+ */
+export declare function hasIndices(url: URL): boolean;
+/**
+ * Parse a query string into a nested object.
+ */
+export declare function parse(query: string): Record<string, unknown>;
+/**
+ * Convert an object to a query string.
+ */
+export declare function stringify(data: Record<string, unknown>, arrayFormat: QueryStringArrayFormatOption): string;

package/types/request.d.ts

@@ -1,16 +1,23 @@
-import { type AxiosProgressEvent, type AxiosRequestConfig } from 'axios';
 import { RequestParams } from './requestParams';
 import { Response } from './response';
 import type { ActiveVisit, Page } from './types';
+import { HttpProgressEvent, HttpRequestHeaders } from './types';
 export declare class Request {
     protected page: Page;
     protected response: Response;
     protected cancelToken: AbortController;
     protected requestParams: RequestParams;
     protected requestHasFinished: boolean;
-    constructor(params: ActiveVisit, page: Page);
-    static create(params: ActiveVisit, page: Page): Request;
+    protected optimistic: boolean;
+    constructor(params: ActiveVisit, page: Page, { optimistic }?: {
+        optimistic?: boolean;
+    });
+    static create(params: ActiveVisit, page: Page, options?: {
+        optimistic?: boolean;
+    }): Request;
     isPrefetch(): boolean;
+    isOptimistic(): boolean;
+    isPendingOptimistic(): boolean;
     send(): Promise<void | undefined>;
     protected finish(): void;
     protected fireFinishEvents(): void;
@@ -18,6 +25,6 @@ export declare class Request {
         cancelled?: boolean;
         interrupted?: boolean;
     }): void;
-    protected onProgress(progress: AxiosProgressEvent): void;
-    protected getHeaders(): AxiosRequestConfig['headers'];
+    protected onProgress(progress: HttpProgressEvent): void;
+    protected getHeaders(): HttpRequestHeaders;
 }

package/types/requestParams.d.ts

@@ -1,6 +1,5 @@
-import { AxiosRequestConfig } from 'axios';
 import { Response } from './response';
-import { ActiveVisit, InternalActiveVisit, Page, PreserveStateOption, VisitCallbacks } from './types';
+import { ActiveVisit, HttpRequestHeaders, InternalActiveVisit, Page, PreserveStateOption, VisitCallbacks } from './types';
 export declare class RequestParams {
     protected callbacks: {
         name: keyof VisitCallbacks;
@@ -27,7 +26,7 @@ export declare class RequestParams {
     onPrefetchResponse(response: Response): void;
     onPrefetchError(error: Error): void;
     all(): InternalActiveVisit;
-    headers(): AxiosRequestConfig['headers'];
+    headers(): HttpRequestHeaders;
     setPreserveOptions(page: Page): void;
     runCallbacks(): void;
     merge(toMerge: Partial<ActiveVisit>): void;

package/types/requestStream.d.ts

@@ -9,12 +9,14 @@ export declare class RequestStream {
     });
     send(request: Request): void;
     interruptInFlight(): void;
-    cancelInFlight({ prefetch }?: {
+    cancelInFlight({ prefetch, optimistic }?: {
         prefetch?: boolean | undefined;
+        optimistic?: boolean | undefined;
     }): void;
     protected cancel({ cancelled, interrupted }?: {
         cancelled?: boolean | undefined;
         interrupted?: boolean | undefined;
     }, force?: boolean): void;
     protected shouldCancel(): boolean;
+    hasPendingOptimistic(): boolean;
 }

package/types/response.d.ts

@@ -1,13 +1,14 @@
-import { AxiosResponse } from 'axios';
 import { RequestParams } from './requestParams';
-import { ActiveVisit, ErrorBag, Errors, Page } from './types';
+import { ActiveVisit, ErrorBag, Errors, HttpResponse, Page, PageProps } from './types';
 export declare class Response {
     protected requestParams: RequestParams;
-    protected response: AxiosResponse;
+    protected response: HttpResponse;
     protected originatingPage: Page;
     protected wasPrefetched: boolean;
-    constructor(requestParams: RequestParams, response: AxiosResponse, originatingPage: Page);
-    static create(params: RequestParams, response: AxiosResponse, originatingPage: Page): Response;
+    protected processed: boolean;
+    constructor(requestParams: RequestParams, response: HttpResponse, originatingPage: Page);
+    static create(params: RequestParams, response: HttpResponse, originatingPage: Page): Response;
+    isProcessed(): boolean;
     handlePrefetch(): Promise<void>;
     handle(): Promise<void>;
     process(): Promise<boolean | void>;
@@ -18,6 +19,7 @@ export declare class Response {
     protected hasStatus(status: number): boolean;
     protected getHeader(header: string): string;
     protected hasHeader(header: string): boolean;
+    protected isInertiaRedirect(): boolean;
     protected isLocationVisit(): boolean;
     /**
      * @link https://inertiajs.com/redirects#external-redirects
@@ -27,8 +29,18 @@ export declare class Response {
     protected getDataFromResponse(response: any): any;
     protected shouldSetPage(pageResponse: Page): boolean;
     protected pageUrl(pageResponse: Page): string;
+    protected preserveOptimisticProps(pageResponse: Page): void;
     protected preserveEqualProps(pageResponse: Page): void;
     protected mergeProps(pageResponse: Page): void;
+    /**
+     * By default, the Laravel adapter shares validation errors via Inertia::always(),
+     * so responses always include errors, even when empty. Components like
+     * InfiniteScroll and WhenVisible, as well as loading deferred props,
+     * perform async requests that should practically never reset errors.
+     */
+    protected shouldPreserveErrors(pageResponse: Page): boolean;
+    protected isObject(item: any): boolean;
+    protected deepMergeObjects(target: PageProps, source: PageProps): PageProps;
     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[];
     protected prependWithMatching(existingItems: any[], newItems: any[], newItemsMap: Map<any, any>, uniqueProperty: string): any[];

package/types/router.d.ts

@@ -1,11 +1,13 @@
 import Queue from './queue';
 import { RequestStream } from './requestStream';
-import { ActiveVisit, ClientSideVisitOptions, Component, FlashData, GlobalEvent, GlobalEventNames, GlobalEventResult, InFlightPrefetch, Page, PageFlashData, PendingVisit, PendingVisitOptions, PollOptions, PrefetchedResponse, PrefetchOptions, ReloadOptions, RequestPayload, RouterInitParams, UrlMethodPair, VisitCallbacks, VisitHelperOptions, VisitOptions } from './types';
+import { ActiveVisit, ClientSideVisitOptions, Component, FlashData, GlobalEvent, GlobalEventNames, GlobalEventResult, InFlightPrefetch, OptimisticCallback, Page, PageFlashData, PendingVisit, 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>>;
+    protected pendingOptimisticCallback: OptimisticCallback | undefined;
     init<ComponentType = Component>({ initialPage, resolveComponent, swapComponent, onFlash, }: RouterInitParams<ComponentType>): void;
+    optimistic<TProps>(callback: OptimisticCallback<TProps>): this;
     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;
     put<T extends RequestPayload = RequestPayload>(url: URL | string | UrlMethodPair, data?: T, options?: VisitHelperOptions<T>): void;
@@ -22,6 +24,7 @@ export declare class Router {
      * @deprecated Use cancelAll() instead.
      */
     cancel(): void;
+    hasPendingOptimistic(): boolean;
     cancelAll({ async, prefetch, sync }?: {
         async?: boolean | undefined;
         prefetch?: boolean | undefined;
@@ -40,7 +43,7 @@ export declare class Router {
     prefetch(href: string | URL | UrlMethodPair, options?: VisitOptions, prefetchOptions?: Partial<PrefetchOptions>): void;
     clearHistory(): void;
     decryptHistory(): Promise<Page>;
-    resolveComponent(component: string): Promise<Component>;
+    resolveComponent(component: string, page?: Page): Promise<Component>;
     replace<TProps = Page['props']>(params: ClientSideVisitOptions<TProps>): void;
     replaceProp<TProps = Page['props']>(name: string, value: unknown | ((oldValue: unknown, props: TProps) => unknown), options?: Pick<ClientSideVisitOptions, 'onError' | 'onFinish' | 'onSuccess'>): void;
     appendToProp<TProps = Page['props']>(name: string, value: unknown | unknown[] | ((oldValue: unknown, props: TProps) => unknown | unknown[]), options?: Pick<ClientSideVisitOptions, 'onError' | 'onFinish' | 'onSuccess'>): void;
@@ -53,8 +56,10 @@ export declare class Router {
     protected performClientVisit<TProps = Page['props']>(params: ClientSideVisitOptions<TProps>, { replace }?: {
         replace?: boolean;
     }): Promise<void>;
+    protected performInstantSwap(visit: PendingVisit): Promise<void>;
     protected getPrefetchParams(href: string | URL | UrlMethodPair, options: VisitOptions): ActiveVisit;
-    protected getPendingVisit(href: string | URL | UrlMethodPair, options: VisitOptions, pendingVisitOptions?: Partial<PendingVisitOptions>): PendingVisit;
+    protected getPendingVisit(href: string | URL | UrlMethodPair, options: VisitOptions): PendingVisit;
     protected getVisitEvents(options: VisitOptions): VisitCallbacks;
+    protected applyOptimisticUpdate(optimistic: OptimisticCallback, events: VisitCallbacks): void;
     protected loadDeferredProps(deferred: Page['deferredProps']): void;
 }

package/types/server.d.ts

@@ -3,7 +3,8 @@ type AppCallback = (page: Page) => InertiaAppResponse;
 type ServerOptions = {
     port?: number;
     cluster?: boolean;
+    handleErrors?: boolean;
 };
 type Port = number;
-declare const _default: (render: AppCallback, options?: Port | ServerOptions) => void;
+declare const _default: (render: AppCallback, options?: Port | ServerOptions) => AppCallback;
 export default _default;

package/types/ssrErrors.d.ts

@@ -0,0 +1,29 @@
+/**
+ * SSR Error Classification
+ *
+ * This module detects common SSR errors and provides helpful hints
+ * to developers on how to fix them. The most common issue is using
+ * browser-specific APIs (like window, document) that don't exist
+ * in the Node.js server environment.
+ */
+export type SSRErrorType = 'browser-api' | 'component-resolution' | 'render' | 'unknown';
+type SourceMapResolver = (file: string, line: number, column: number) => {
+    file: string;
+    line: number;
+    column: number;
+} | null;
+export declare function setSourceMapResolver(resolver: SourceMapResolver | null): void;
+export interface ClassifiedSSRError {
+    error: string;
+    type: SSRErrorType;
+    component?: string;
+    url?: string;
+    browserApi?: string;
+    hint: string;
+    stack?: string;
+    sourceLocation?: string;
+    timestamp: string;
+}
+export declare function classifySSRError(error: Error, component?: string, url?: string): ClassifiedSSRError;
+export declare function formatConsoleError(classified: ClassifiedSSRError, root?: string, handleErrors?: boolean, suppressedWarnings?: string[]): string;
+export {};

package/types/ssrUtils.d.ts

@@ -0,0 +1,2 @@
+import type { Page } from './types';
+export declare function buildSSRBody(id: string, page: Page, html: string): string;