@inertiajs/react 2.3.17 → 3.0.0-beta.2

package/dist/server.js

@@ -1,37 +1,6 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
 // src/server.ts
-var server_exports = {};
-__export(server_exports, {
-  default: () => import_server.default
-});
-module.exports = __toCommonJS(server_exports);
-var import_server = __toESM(require("@inertiajs/core/server"), 1);
+import { default as default2 } from "@inertiajs/core/server";
+export {
+  default2 as default
+};
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/server.ts"],
   "sourcesContent": ["export { default as default } from '@inertiajs/core/server'\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAAmC;",
-  "names": []
+  "mappings": ";AAAA,SAAoB,WAAXA,gBAA0B;",
+  "names": ["default"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inertiajs/react",
-  "version": "2.3.17",
+  "version": "3.0.0-beta.2",
   "license": "MIT",
   "description": "The React adapter for Inertia.js",
   "contributors": [
@@ -10,7 +10,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/react"
   },
   "bugs": {
@@ -27,13 +27,11 @@
   "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"
     }
   },
   "typesVersions": {
@@ -55,14 +53,14 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "react": "^16.9.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
-    "react-dom": "^16.9.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
   },
   "dependencies": {
     "@types/lodash-es": "^4.17.12",
-    "laravel-precognition": "^1.0.2",
+    "laravel-precognition": "2.0.0-beta.3",
     "lodash-es": "^4.17.23",
-    "@inertiajs/core": "2.3.17"
+    "@inertiajs/core": "3.0.0-beta.2"
   },
   "scripts": {
     "build": "pnpm clean && ./build.js && tsc",
@@ -71,6 +69,6 @@
     "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"
   }
 }

package/resources/boost/skills/inertia-react-development/SKILL.blade.php

@@ -1,6 +1,6 @@
 ---
 name: inertia-react-development
-description: "Develops Inertia.js v2 React client-side applications. Activates when creating React pages, forms, or navigation; using <Link>, <Form>, useForm, or router; working with deferred props, prefetching, or polling; or when user mentions React with Inertia, React pages, React forms, or React navigation."
+description: "Develops Inertia.js v3 React client-side applications. Activates when creating React pages, forms, or navigation; using <Link>, <Form>, useForm, useHttp, useLayoutProps, or router; working with deferred props, prefetching, optimistic updates, instant visits, or polling; or when user mentions React with Inertia, React pages, React forms, or React navigation."
 license: MIT
 metadata:
   author: laravel
@@ -15,14 +15,14 @@ metadata:
 Activate this skill when:
 
 - Creating or modifying React page components for Inertia
-- Working with forms in React (using `<Form>` or `useForm`)
+- Working with forms in React (using `<Form>`, `useForm`, or `useHttp`)
 - Implementing client-side navigation with `<Link>` or `router`
-- Using v2 features: deferred props, prefetching, WhenVisible, InfiniteScroll, once props, flash data, or polling
+- Using v3 features: deferred props, prefetching, optimistic updates, instant visits, layout props, HTTP requests, WhenVisible, InfiniteScroll, once props, flash data, or polling
 - Building React-specific features with the Inertia protocol
 
 ## Documentation
 
-Use `search-docs` for detailed Inertia v2 React patterns and documentation.
+Use `search-docs` for detailed Inertia v3 React patterns and documentation.
 
 ## Basic Usage
 
@@ -267,7 +267,127 @@ export default function CreateUser() {
 }
 @endboostsnippet
 
-## Inertia v2 Features
+## Inertia v3 Features
+
+### HTTP Requests
+
+Use the `useHttp` hook for standalone HTTP requests that do not trigger Inertia page visits. It provides the same developer experience as `useForm`, but for plain JSON endpoints.
+
+@boostsnippet("useHttp Example", "react")
+import { useHttp } from '@inertiajs/react'
+
+export default function Search() {
+    const { data, setData, get, processing } = useHttp({
+        query: '',
+    })
+
+    function search(e) {
+        setData('query', e.target.value)
+        get('/api/search', {
+            onSuccess: (response) => {
+                console.log(response)
+            },
+        })
+    }
+
+    return (
+        <>
+            <input value={data.query} onChange={search} />
+            {processing && <div>Searching...</div>}
+        </>
+    )
+}
+@endboostsnippet
+
+### Optimistic Updates
+
+Apply data changes instantly before the server responds, with automatic rollback on failure:
+
+@boostsnippet("Optimistic Update with Router", "react")
+import { router } from '@inertiajs/react'
+
+function like(post) {
+    router.optimistic((props) => ({
+        post: {
+            ...props.post,
+            likes: props.post.likes + 1,
+        },
+    })).post(`/posts/${post.id}/like`)
+}
+@endboostsnippet
+
+Optimistic updates also work with `useForm` and the `<Form>` component:
+
+@boostsnippet("Optimistic Update with Form Component", "react")
+import { Form } from '@inertiajs/react'
+
+<Form
+    action="/todos"
+    method="post"
+    optimistic={(props, data) => ({
+        todos: [...props.todos, { id: Date.now(), name: data.name, done: false }],
+    })}
+>
+    <input type="text" name="name" />
+    <button type="submit">Add Todo</button>
+</Form>
+@endboostsnippet
+
+### Instant Visits
+
+Navigate to a new page immediately without waiting for the server response. The target component renders right away with shared props, while page-specific props load in the background.
+
+@verbatim
+@boostsnippet("Instant Visit with Link", "react")
+import { Link } from '@inertiajs/react'
+
+<Link href="/dashboard" component="Dashboard">Dashboard</Link>
+
+<Link
+    href="/posts/1"
+    component="Posts/Show"
+    pageProps={{ post: { id: 1, title: 'My Post' } }}
+>
+    View Post
+</Link>
+@endboostsnippet
+@endverbatim
+
+### Layout Props
+
+Share dynamic data between pages and persistent layouts:
+
+@boostsnippet("Layout Props in Layout", "react")
+import { useLayoutProps } from '@inertiajs/react'
+
+export default function Layout({ children }) {
+    const { title, showSidebar } = useLayoutProps({
+        title: 'My App',
+        showSidebar: true,
+    })
+
+    return (
+        <>
+            <header>{title}</header>
+            {showSidebar && <aside>Sidebar</aside>}
+            <main>{children}</main>
+        </>
+    )
+}
+@endboostsnippet
+
+@boostsnippet("Setting Layout Props from Page", "react")
+import { setLayoutProps } from '@inertiajs/react'
+
+export default function Dashboard() {
+    setLayoutProps({
+        title: 'Dashboard',
+        showSidebar: false,
+    })
+
+    return <h1>Dashboard</h1>
+}
+@endboostsnippet
 
 ### Deferred Props
 
@@ -275,7 +395,6 @@ Use deferred props to load data after initial page render:
 
 @boostsnippet("Deferred Props with Empty State", "react")
 export default function UsersIndex({ users }) {
-    // users will be undefined initially, then populated
     return (
         <div>
             <h1>Users</h1>
@@ -308,7 +427,7 @@ export default function Dashboard({ stats }) {
     useEffect(() => {
         const interval = setInterval(() => {
             router.reload({ only: ['stats'] })
-        }, 5000) // Poll every 5 seconds
+        }, 5000)
 
         return () => clearInterval(interval)
     }, [])
@@ -334,7 +453,6 @@ export default function Dashboard({ stats }) {
         <div>
             <h1>Dashboard</h1>
 
-            {/* stats prop is loaded only when this section scrolls into view */}
             <WhenVisible data="stats" buffer={200} fallback={<div className="animate-pulse">Loading stats...</div>}>
                 {({ fetching }) => (
                     <div>
@@ -360,3 +478,5 @@ Server-side patterns (Inertia::render, props, middleware) are covered in inertia
 - Not handling the `undefined` state of deferred props before data loads
 - Using `<form>` without preventing default submission (use `<Form>` component or `e.preventDefault()`)
 - Forgetting to check if `<Form>` component is available in your Inertia version
+- Using `router.cancel()` instead of `router.cancelAll()` (v3 breaking change)
+- Using `router.on('invalid', ...)` or `router.on('exception', ...)` instead of the renamed `httpException` and `networkError` events

package/types/App.d.ts

@@ -9,12 +9,13 @@ export interface InertiaAppProps<SharedProps extends PageProps = PageProps> {
     }) => ReactNode;
     initialPage: Page<SharedProps>;
     initialComponent?: ReactComponent;
-    resolveComponent?: (name: string) => ReactComponent | Promise<ReactComponent>;
+    resolveComponent?: (name: string, page?: Page) => ReactComponent | Promise<ReactComponent>;
     titleCallback?: HeadManagerTitleCallback;
     onHeadUpdate?: HeadManagerOnUpdateCallback;
+    defaultLayout?: (name: string, page: Page) => unknown;
 }
 export type InertiaApp = FunctionComponent<InertiaAppProps>;
-declare function App<SharedProps extends PageProps = PageProps>({ children, initialPage, initialComponent, resolveComponent, titleCallback, onHeadUpdate, }: InertiaAppProps<SharedProps>): import("react").FunctionComponentElement<import("react").ProviderProps<import("@inertiajs/core").HeadManager | null>>;
+declare function App<SharedProps extends PageProps = PageProps>({ children, initialPage, initialComponent, resolveComponent, titleCallback, onHeadUpdate, defaultLayout, }: InertiaAppProps<SharedProps>): import("react").FunctionComponentElement<import("react").ProviderProps<import("@inertiajs/core").HeadManager | null>>;
 declare namespace App {
     var displayName: string;
 }

package/types/Deferred.d.ts

@@ -1,6 +1,9 @@
 import { ReactNode } from 'react';
+interface DeferredSlotProps {
+    reloading: boolean;
+}
 interface DeferredProps {
-    children: ReactNode | (() => ReactNode);
+    children: ReactNode | ((props: DeferredSlotProps) => ReactNode);
     fallback: ReactNode | (() => ReactNode);
     data: string | string[];
 }

package/types/Form.d.ts

@@ -1,20 +1,11 @@
-import { FormComponentRef, FormComponentSlotProps, FormDataConvertible, Method } from '@inertiajs/core';
+import { FormComponentProps, FormComponentRef, FormComponentSlotProps } from '@inertiajs/core';
 import React, { ReactNode } from 'react';
-declare const Form: React.ForwardRefExoticComponent<Partial<Pick<import("@inertiajs/core").Visit<import("@inertiajs/core").RequestPayload>, "headers" | "errorBag" | "queryStringArrayFormat" | "showProgress" | "invalidateCacheTags"> & Omit<import("@inertiajs/core").VisitCallbacks<import("@inertiajs/core").RequestPayload>, "onPrefetched" | "onPrefetching">> & {
-    method?: Method | Uppercase<Method>;
-    action?: string | import("@inertiajs/core").UrlMethodPair;
-    transform?: (data: Record<string, FormDataConvertible>) => Record<string, FormDataConvertible>;
-    options?: import("@inertiajs/core").FormComponentOptions;
-    onSubmitComplete?: (props: import("@inertiajs/core").FormComponentonSubmitCompleteArguments) => void;
-    disableWhileProcessing?: boolean;
-    resetOnSuccess?: boolean | string[];
-    resetOnError?: boolean | string[];
-    setDefaultsOnSuccess?: boolean;
-    validateFiles?: boolean;
-    validationTimeout?: number;
-    withAllErrors?: boolean | null;
-} & Omit<React.FormHTMLAttributes<HTMLFormElement>, "children" | "method" | "headers" | "errorBag" | "queryStringArrayFormat" | "showProgress" | "invalidateCacheTags" | "onCancelToken" | "onBefore" | "onBeforeUpdate" | "onStart" | "onProgress" | "onFinish" | "onCancel" | "onSuccess" | "onError" | "onFlash" | "withAllErrors" | "options" | "action" | "transform" | "onSubmitComplete" | "disableWhileProcessing" | "resetOnSuccess" | "resetOnError" | "setDefaultsOnSuccess" | "validateFiles" | "validationTimeout"> & Omit<React.AllHTMLAttributes<HTMLFormElement>, "children" | "method" | "headers" | "errorBag" | "queryStringArrayFormat" | "showProgress" | "invalidateCacheTags" | "onCancelToken" | "onBefore" | "onBeforeUpdate" | "onStart" | "onProgress" | "onFinish" | "onCancel" | "onSuccess" | "onError" | "onFlash" | "withAllErrors" | "options" | "action" | "transform" | "onSubmitComplete" | "disableWhileProcessing" | "resetOnSuccess" | "resetOnError" | "setDefaultsOnSuccess" | "validateFiles" | "validationTimeout"> & {
-    children: ReactNode | ((props: FormComponentSlotProps) => ReactNode);
-} & React.RefAttributes<FormComponentSlotProps>>;
-export declare function useFormContext(): FormComponentRef | undefined;
-export default Form;
+type FormProps<TForm extends object = Record<string, any>> = FormComponentProps & Omit<React.FormHTMLAttributes<HTMLFormElement>, keyof FormComponentProps | 'children'> & Omit<React.AllHTMLAttributes<HTMLFormElement>, keyof FormComponentProps | 'children'> & {
+    children: ReactNode | ((props: FormComponentSlotProps<TForm>) => ReactNode);
+};
+export declare function useFormContext<TForm extends object = Record<string, any>>(): FormComponentRef<TForm> | undefined;
+declare const _default: {
+    <TForm extends object = Record<string, any>>(props: FormProps<TForm> & React.RefAttributes<FormComponentRef<TForm>>): React.ReactElement;
+    displayName: string;
+};
+export default _default;

package/types/InfiniteScroll.d.ts

@@ -1,4 +1,4 @@
-import { InfiniteScrollActionSlotProps, InfiniteScrollComponentBaseProps, InfiniteScrollRef, InfiniteScrollSlotProps } from '@inertiajs/core';
+import { InfiniteScrollActionSlotProps, InfiniteScrollComponentBaseProps, InfiniteScrollRef, InfiniteScrollSlotProps, ReloadOptions } from '@inertiajs/core';
 import React from 'react';
 interface ComponentProps extends InfiniteScrollComponentBaseProps, Omit<React.HTMLAttributes<HTMLElement>, keyof InfiniteScrollComponentBaseProps | 'children'> {
     children?: React.ReactNode | ((props: InfiniteScrollSlotProps) => React.ReactNode);
@@ -8,6 +8,7 @@ interface ComponentProps extends InfiniteScrollComponentBaseProps, Omit<React.HT
     previous?: React.ReactNode | ((props: InfiniteScrollActionSlotProps) => React.ReactNode);
     next?: React.ReactNode | ((props: InfiniteScrollActionSlotProps) => React.ReactNode);
     loading?: React.ReactNode | ((props: InfiniteScrollActionSlotProps) => React.ReactNode);
+    params?: ReloadOptions;
     onlyNext?: boolean;
     onlyPrevious?: boolean;
 }

package/types/createInertiaApp.d.ts

@@ -1,4 +1,4 @@
-import { CreateInertiaAppOptionsForCSR, CreateInertiaAppOptionsForSSR, InertiaAppSSRResponse, PageProps } from '@inertiajs/core';
+import { CreateInertiaAppOptions, CreateInertiaAppOptionsForCSR, CreateInertiaAppOptionsForSSR, InertiaAppSSRResponse, Page, PageProps } from '@inertiajs/core';
 import { ReactElement } from 'react';
 import { renderToString } from 'react-dom/server';
 import { InertiaAppProps, type InertiaApp } from './App';
@@ -8,13 +8,24 @@ export type SetupOptions<ElementType, SharedProps extends PageProps> = {
     App: InertiaApp;
     props: InertiaAppProps<SharedProps>;
 };
-type ComponentResolver = (name: string) => ReactComponent | Promise<ReactComponent> | {
+type ComponentResolver = (name: string, page?: Page) => ReactComponent | Promise<ReactComponent> | {
     default: ReactComponent;
-} | unknown;
-type InertiaAppOptionsForCSR<SharedProps extends PageProps> = CreateInertiaAppOptionsForCSR<SharedProps, ComponentResolver, SetupOptions<HTMLElement, SharedProps>, void, ReactInertiaAppConfig>;
+};
+type InertiaAppOptionsForCSR<SharedProps extends PageProps> = CreateInertiaAppOptionsForCSR<SharedProps, ComponentResolver, SetupOptions<HTMLElement, SharedProps>, void, ReactInertiaAppConfig> & {
+    strictMode?: undefined;
+};
 type InertiaAppOptionsForSSR<SharedProps extends PageProps> = CreateInertiaAppOptionsForSSR<SharedProps, ComponentResolver, SetupOptions<null, SharedProps>, ReactElement, ReactInertiaAppConfig> & {
     render: typeof renderToString;
+    strictMode?: undefined;
+};
+type InertiaAppOptionsAuto<SharedProps extends PageProps> = CreateInertiaAppOptions<ComponentResolver, SetupOptions<HTMLElement | null, SharedProps>, ReactElement | void, ReactInertiaAppConfig> & {
+    page?: Page<SharedProps>;
+    render?: undefined;
+    strictMode?: boolean;
 };
+type RenderToString = (element: ReactElement) => string;
+type RenderFunction<SharedProps extends PageProps> = (page: Page<SharedProps>, renderToString: RenderToString) => Promise<InertiaAppSSRResponse>;
 export default function createInertiaApp<SharedProps extends PageProps = PageProps>(options: InertiaAppOptionsForCSR<SharedProps>): Promise<void>;
 export default function createInertiaApp<SharedProps extends PageProps = PageProps>(options: InertiaAppOptionsForSSR<SharedProps>): Promise<InertiaAppSSRResponse>;
+export default function createInertiaApp<SharedProps extends PageProps = PageProps>(options?: InertiaAppOptionsAuto<SharedProps>): Promise<void | RenderFunction<SharedProps>>;
 export {};

package/types/index.d.ts

@@ -1,28 +1,19 @@
-export declare const progress: {
-    hideCount: number;
-    start(): void;
-    reveal(force?: boolean): void;
-    hide(): void;
-    set(status: number): void;
-    finish(): void;
-    reset(): void;
-    remove(): void;
-    isStarted(): boolean;
-    getStatus(): number | null;
-};
-export declare const router: import("@inertiajs/core").Router;
+import type { ReactInertiaAppConfig } from './types';
+export { http, progress, router } from '@inertiajs/core';
 export { default as App } from './App';
 export { default as createInertiaApp } from './createInertiaApp';
 export { default as Deferred } from './Deferred';
 export { default as Form, useFormContext } from './Form';
 export { default as Head } from './Head';
 export { default as InfiniteScroll } from './InfiniteScroll';
+export { resetLayoutProps, setLayoutProps, setLayoutPropsFor, useLayoutProps } from './layoutProps';
 export { InertiaLinkProps, default as Link } from './Link';
 export { ReactComponent as ResolvedComponent } from './types';
-export { InertiaFormProps, InertiaPrecognitiveFormProps, SetDataAction, SetDataByKeyValuePair, SetDataByMethod, SetDataByObject, default as useForm, } from './useForm';
+export { InertiaForm, InertiaFormProps, InertiaPrecognitiveFormProps, SetDataAction, SetDataByKeyValuePair, SetDataByMethod, SetDataByObject, default as useForm, } from './useForm';
+export { default as useHttp } from './useHttp';
 export { default as usePage } from './usePage';
 export { default as usePoll } from './usePoll';
 export { default as usePrefetch } from './usePrefetch';
 export { default as useRemember } from './useRemember';
 export { default as WhenVisible } from './WhenVisible';
-export declare const config: import("@inertiajs/core").Config<import("@inertiajs/core").InertiaAppConfig>;
+export declare const config: import("@inertiajs/core").Config<import("@inertiajs/core").InertiaAppConfig & ReactInertiaAppConfig>;

package/types/layoutProps.d.ts

@@ -0,0 +1,8 @@
+export declare function setLayoutProps(props: Record<string, unknown>): void;
+export declare function setLayoutPropsFor(name: string, props: Record<string, unknown>): void;
+export declare function resetLayoutProps(): void;
+export declare const LayoutPropsContext: import("react").Context<{
+    staticProps: Record<string, unknown>;
+    name?: string;
+}>;
+export declare function useLayoutProps<T extends Record<string, unknown>>(defaults: T): T;

package/types/react.d.ts

@@ -1,3 +1,2 @@
 import { DependencyList, EffectCallback } from 'react';
 export declare function useIsomorphicLayoutEffect(effect: EffectCallback, deps?: DependencyList): void;
-export declare const isReact19: boolean;

package/types/types.d.ts

@@ -8,4 +8,6 @@ export type ReactComponent = ComponentType<any> & {
     layout?: LayoutComponent | LayoutComponent[] | LayoutFunction;
 };
 export type ReactPageHandlerArgs = Parameters<PageHandler<ComponentType>>[0];
-export type ReactInertiaAppConfig = {};
+export type ReactInertiaAppConfig = {
+    strictMode?: boolean;
+};

package/types/useForm.d.ts

@@ -1,13 +1,11 @@
-import { ErrorValue, FormDataErrors, FormDataKeys, FormDataType, FormDataValues, Method, Progress, UrlMethodPair, UseFormSubmitArguments, UseFormSubmitOptions, UseFormTransformCallback, UseFormWithPrecognitionArguments } from '@inertiajs/core';
-import { NamedInputEvent, PrecognitionPath, ValidationConfig, Validator } from 'laravel-precognition';
-export type SetDataByObject<TForm> = (data: Partial<TForm>) => void;
-export type SetDataByMethod<TForm> = (data: (previousData: TForm) => TForm) => void;
-export type SetDataByKeyValuePair<TForm> = <K extends FormDataKeys<TForm>>(key: K, value: FormDataValues<TForm, K>) => void;
-export type SetDataAction<TForm extends Record<any, any>> = SetDataByObject<TForm> & SetDataByMethod<TForm> & SetDataByKeyValuePair<TForm>;
+import { ErrorValue, FormDataErrors, FormDataKeys, FormDataType, FormDataValues, Method, OptimisticCallback, Progress, UrlMethodPair, UseFormSubmitArguments, UseFormSubmitOptions, UseFormTransformCallback, UseFormWithPrecognitionArguments } from '@inertiajs/core';
+import type { NamedInputEvent, PrecognitionPath, ValidationConfig, Validator } from 'laravel-precognition';
+import { SetDataAction, SetDataByKeyValuePair, SetDataByMethod, SetDataByObject } from './useFormState';
+export { SetDataAction, SetDataByKeyValuePair, SetDataByMethod, SetDataByObject };
 type PrecognitionValidationConfig<TKeys> = ValidationConfig & {
     only?: TKeys[] | Iterable<TKeys> | ArrayLike<TKeys>;
 };
-export interface InertiaFormProps<TForm extends object> {
+export interface InertiaFormProps<TForm extends Record<string, any>> {
     data: TForm;
     isDirty: boolean;
     errors: FormDataErrors<TForm>;
@@ -32,15 +30,16 @@ export interface InertiaFormProps<TForm extends object> {
     };
     submit: (...args: UseFormSubmitArguments) => void;
     get: (url: string, options?: UseFormSubmitOptions) => void;
-    patch: (url: string, options?: UseFormSubmitOptions) => void;
     post: (url: string, options?: UseFormSubmitOptions) => void;
     put: (url: string, options?: UseFormSubmitOptions) => void;
+    patch: (url: string, options?: UseFormSubmitOptions) => void;
     delete: (url: string, options?: UseFormSubmitOptions) => void;
     cancel: () => void;
     dontRemember: <K extends FormDataKeys<TForm>>(...fields: K[]) => InertiaFormProps<TForm>;
+    optimistic: <TProps>(callback: OptimisticCallback<TProps>) => InertiaFormProps<TForm>;
     withPrecognition: (...args: UseFormWithPrecognitionArguments) => InertiaPrecognitiveFormProps<TForm>;
 }
-export interface InertiaFormValidationProps<TForm extends object> {
+export interface InertiaFormValidationProps<TForm extends Record<string, any>> {
     invalid: <K extends FormDataKeys<TForm>>(field: K) => boolean;
     setValidationTimeout: (duration: number) => InertiaPrecognitiveFormProps<TForm>;
     touch: <K extends FormDataKeys<TForm>>(field: K | NamedInputEvent | Array<K>, ...fields: K[]) => InertiaPrecognitiveFormProps<TForm>;
@@ -55,11 +54,10 @@ export interface InertiaFormValidationProps<TForm extends object> {
     setErrors: (errors: FormDataErrors<TForm>) => InertiaPrecognitiveFormProps<TForm>;
     forgetError: <K extends FormDataKeys<TForm> | NamedInputEvent>(field: K) => InertiaPrecognitiveFormProps<TForm>;
 }
-export type InertiaForm<TForm extends object> = InertiaFormProps<TForm>;
-export type InertiaPrecognitiveFormProps<TForm extends object> = InertiaFormProps<TForm> & InertiaFormValidationProps<TForm>;
+export type InertiaForm<TForm extends Record<string, any>> = InertiaFormProps<TForm>;
+export type InertiaPrecognitiveFormProps<TForm extends Record<string, any>> = InertiaFormProps<TForm> & InertiaFormValidationProps<TForm>;
 export default function useForm<TForm extends FormDataType<TForm>>(method: Method | (() => Method), url: string | (() => string), data: TForm | (() => TForm)): InertiaPrecognitiveFormProps<TForm>;
 export default function useForm<TForm extends FormDataType<TForm>>(urlMethodPair: UrlMethodPair | (() => UrlMethodPair), data: TForm | (() => TForm)): InertiaPrecognitiveFormProps<TForm>;
 export default function useForm<TForm extends FormDataType<TForm>>(rememberKey: string, data: TForm | (() => TForm)): InertiaFormProps<TForm>;
 export default function useForm<TForm extends FormDataType<TForm>>(data: TForm | (() => TForm)): InertiaFormProps<TForm>;
 export default function useForm<TForm extends FormDataType<TForm>>(): InertiaFormProps<TForm>;
-export {};

package/types/useFormState.d.ts

@@ -0,0 +1,79 @@
+import { ErrorValue, FormDataErrors, FormDataKeys, FormDataValues, Progress, UrlMethodPair, UseFormTransformCallback, UseFormWithPrecognitionArguments } from '@inertiajs/core';
+import { NamedInputEvent, ValidationConfig, Validator } from 'laravel-precognition';
+export type SetDataByObject<TForm> = (data: Partial<TForm>) => void;
+export type SetDataByMethod<TForm> = (data: (previousData: TForm) => TForm) => void;
+export type SetDataByKeyValuePair<TForm> = <K extends FormDataKeys<TForm>>(key: K, value: FormDataValues<TForm, K>) => void;
+export type SetDataAction<TForm extends Record<any, any>> = SetDataByObject<TForm> & SetDataByMethod<TForm> & SetDataByKeyValuePair<TForm>;
+type PrecognitionValidationConfig<TKeys> = ValidationConfig & {
+    only?: TKeys[] | Iterable<TKeys> | ArrayLike<TKeys>;
+};
+export interface FormStateProps<TForm extends object> {
+    data: TForm;
+    isDirty: boolean;
+    errors: FormDataErrors<TForm>;
+    hasErrors: boolean;
+    processing: boolean;
+    progress: Progress | null;
+    wasSuccessful: boolean;
+    recentlySuccessful: boolean;
+    setData: SetDataAction<TForm>;
+    transform: (callback: UseFormTransformCallback<TForm>) => void;
+    setDefaults: {
+        (): void;
+        <T extends FormDataKeys<TForm>>(field: T, value: FormDataValues<TForm, T>): void;
+        (fields: Partial<TForm>): void;
+    };
+    reset: <K extends FormDataKeys<TForm>>(...fields: K[]) => void;
+    clearErrors: <K extends FormDataKeys<TForm>>(...fields: K[]) => void;
+    resetAndClearErrors: <K extends FormDataKeys<TForm>>(...fields: K[]) => void;
+    setError: {
+        <K extends FormDataKeys<TForm>>(field: K, value: ErrorValue): void;
+        (errors: FormDataErrors<TForm>): void;
+    };
+    withPrecognition: (...args: UseFormWithPrecognitionArguments) => FormStateWithPrecognition<TForm>;
+}
+export interface FormStateValidationProps<TForm extends object> {
+    invalid: <K extends FormDataKeys<TForm>>(field: K) => boolean;
+    setValidationTimeout: (duration: number) => FormStateWithPrecognition<TForm>;
+    touch: <K extends FormDataKeys<TForm>>(field: K | NamedInputEvent | Array<K>, ...fields: K[]) => FormStateWithPrecognition<TForm>;
+    touched: <K extends FormDataKeys<TForm>>(field?: K) => boolean;
+    valid: <K extends FormDataKeys<TForm>>(field: K) => boolean;
+    validate: <K extends FormDataKeys<TForm>>(field?: K | NamedInputEvent | PrecognitionValidationConfig<K>, config?: PrecognitionValidationConfig<K>) => FormStateWithPrecognition<TForm>;
+    validateFiles: () => FormStateWithPrecognition<TForm>;
+    validating: boolean;
+    validator: () => Validator;
+    withAllErrors: () => FormStateWithPrecognition<TForm>;
+    withoutFileValidation: () => FormStateWithPrecognition<TForm>;
+    setErrors: (errors: FormDataErrors<TForm>) => FormStateWithPrecognition<TForm>;
+    forgetError: <K extends FormDataKeys<TForm> | NamedInputEvent>(field: K) => FormStateWithPrecognition<TForm>;
+}
+export type FormState<TForm extends object> = FormStateProps<TForm>;
+export type FormStateWithPrecognition<TForm extends object> = FormStateProps<TForm> & FormStateValidationProps<TForm>;
+export interface UseFormStateOptions<TForm extends object> {
+    data: TForm | (() => TForm);
+    precognitionEndpoint?: (() => UrlMethodPair) | null;
+    useDataState?: () => [TForm, React.Dispatch<React.SetStateAction<TForm>>];
+    useErrorsState?: () => [FormDataErrors<TForm>, React.Dispatch<React.SetStateAction<FormDataErrors<TForm>>>];
+}
+export interface UseFormStateReturn<TForm extends object> {
+    form: FormState<TForm>;
+    setDefaultsState: React.Dispatch<React.SetStateAction<TForm>>;
+    transformRef: React.MutableRefObject<UseFormTransformCallback<TForm>>;
+    precognitionEndpointRef: React.MutableRefObject<(() => UrlMethodPair) | null>;
+    dataRef: React.MutableRefObject<TForm>;
+    isMounted: React.MutableRefObject<boolean>;
+    setProcessing: React.Dispatch<React.SetStateAction<boolean>>;
+    setProgress: React.Dispatch<React.SetStateAction<Progress | null>>;
+    markAsSuccessful: () => void;
+    clearErrors: (...fields: string[]) => void;
+    setError: (fieldOrFields: FormDataKeys<TForm> | FormDataErrors<TForm>, maybeValue?: ErrorValue) => void;
+    defaultsCalledInOnSuccessRef: React.MutableRefObject<boolean>;
+    resetBeforeSubmit: () => void;
+    finishProcessing: () => void;
+    withAllErrors: {
+        enabled: () => boolean;
+        enable: () => void;
+    };
+}
+export default function useFormState<TForm extends object>(options: UseFormStateOptions<TForm>): UseFormStateReturn<TForm>;
+export {};