@inertiajs/react 3.0.0-beta.1 → 3.0.0-beta.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inertiajs/react",
-  "version": "3.0.0-beta.1",
+  "version": "3.0.0-beta.2",
   "license": "MIT",
   "description": "The React adapter for Inertia.js",
   "contributors": [
@@ -58,9 +58,9 @@
   },
   "dependencies": {
     "@types/lodash-es": "^4.17.12",
-    "laravel-precognition": "2.0.0-beta.2",
+    "laravel-precognition": "2.0.0-beta.3",
     "lodash-es": "^4.17.23",
-    "@inertiajs/core": "3.0.0-beta.1"
+    "@inertiajs/core": "3.0.0-beta.2"
   },
   "scripts": {
     "build": "pnpm clean && ./build.js && tsc",

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