inertiax-svelte 11.0.21 → 11.0.23

package/dist/components/Frame.svelte

@@ -11,6 +11,8 @@
     resolveComponent: ComponentResolver
     defaultLayout?: (name: string, page: Page) => unknown
     renderLayout?: boolean
+    /** When `true`, always makes an HTTP request on mount even if page data exists in the history stack. Defaults to `false`. */
+    skipHistoryRestore?: boolean
     /** Visit options applied to all navigations within this frame. Link/form-level options take precedence. Non-top frames default to `{ replace: true, updateBrowserUrl: false }`, top frame defaults to `{ replace: false, updateBrowserUrl: true }`. */
     visitOptions?: import('inertiax-core').VisitOptions
     /** Called when a plain <a> inside the frame is clicked. Call event.preventDefault() to prevent the default Inertia navigation. */
@@ -41,6 +43,7 @@
     resolveComponent?: InertiaFrameProps['resolveComponent']
     defaultLayout?: InertiaFrameProps['defaultLayout']
     renderLayout?: InertiaFrameProps['renderLayout']
+    skipHistoryRestore?: InertiaFrameProps['skipHistoryRestore']
     visitOptions?: InertiaFrameProps['visitOptions']
     onClickLink?: InertiaFrameProps['onClickLink']
     children?: InertiaFrameProps['children']
@@ -55,6 +58,7 @@
     resolveComponent = undefined,
     defaultLayout,
     renderLayout = undefined,
+    skipHistoryRestore = false,
     visitOptions,
     onClickLink,
     children,
@@ -73,9 +77,10 @@
     return `frame-${Math.random().toString(36).slice(2, 10)}`
   }
 
-  // App passes DEFAULT_FRAME_ID explicitly for the top frame. All other
-  // implicit frames get an isolated generated id.
-  const frameId = id ?? createFrameId()
+  // Use explicit id > src > random UUID.  Using src as the frameId gives
+  // frames a deterministic identity — remounts with the same src share
+  // history state, so the history-restore optimisation works naturally.
+  const frameId = id ?? src ?? createFrameId()
   const shouldRenderLayout = renderLayout ?? frameId === DEFAULT_FRAME_ID
 
   function resolveFrameComponent(name: string, page?: Page) {
@@ -191,6 +196,22 @@
     }
 
     const load = async () => {
+      // Try to restore from history state first — avoids an unnecessary
+      // request when the frame's page data is already in the history stack.
+      if (!skipHistoryRestore) {
+        try {
+          const historyPage = await frameRouter.decryptHistory()
+
+          if (historyPage && historyPage.component) {
+            initRouter(historyPage)
+
+            return
+          }
+        } catch {
+          // No history state available, fall through to HTTP request.
+        }
+      }
+
       const version = page?.version ?? globalPage.version ?? (window as any)?.initialPage?.version ?? null
 
       const response = await http.getClient().request({

package/dist/components/Frame.svelte.d.ts

@@ -9,6 +9,7 @@ export interface InertiaFrameProps<SharedProps extends PageProps = PageProps> {
     resolveComponent: ComponentResolver;
     defaultLayout?: (name: string, page: Page) => unknown;
     renderLayout?: boolean;
+    skipHistoryRestore?: boolean;
     visitOptions?: import('inertiax-core').VisitOptions;
     onClickLink?: (event: MouseEvent, href: string) => void;
     children?: import('svelte').Snippet;
@@ -24,6 +25,7 @@ interface Props {
     resolveComponent?: InertiaFrameProps['resolveComponent'];
     defaultLayout?: InertiaFrameProps['defaultLayout'];
     renderLayout?: InertiaFrameProps['renderLayout'];
+    skipHistoryRestore?: InertiaFrameProps['skipHistoryRestore'];
     visitOptions?: InertiaFrameProps['visitOptions'];
     onClickLink?: InertiaFrameProps['onClickLink'];
     children?: InertiaFrameProps['children'];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "inertiax-svelte",
-  "version": "11.0.21",
+  "version": "11.0.23",
   "license": "MIT",
   "description": "The Svelte adapter for Inertia.js",
   "contributors": [
@@ -55,7 +55,7 @@
   "dependencies": {
     "es-toolkit": "^1.47.1",
     "laravel-precognition": "^2.0.0",
-    "inertiax-core": "11.0.21"
+    "inertiax-core": "11.0.23"
   },
   "scripts": {
     "build": "pnpm package && svelte-check --tsconfig ./tsconfig.json && publint",

package/readme.md

@@ -11,7 +11,7 @@ Each frame manages its own router, history, and component tree.
 
 | Prop | Type | Default | Description |
 |------|------|---------|-------------|
-| `id` | `string` | auto-generated | Frame identifier. Use `"_top"` for the root frame. |
+| `id` | `string` | `src` value, then auto-generated | Frame identifier. Deterministic when derived from `src`. |
 | `src` | `string` | — | URL to load the frame content from. |
 | `router` | `Router` | auto-created | Custom router instance. |
 | `initialComponent` | `ResolvedComponent` | — | Pre-resolved component for SSR/hydration. |
@@ -21,6 +21,7 @@ Each frame manages its own router, history, and component tree.
 | `renderLayout` | `boolean` | `true` for top frame | Whether to wrap content in layouts. |
 | `visitOptions` | `VisitOptions` | `{ replace: true, updateBrowserUrl: false }` (non-top) / `{ replace: false, updateBrowserUrl: true }` (top) | Default visit options applied to all navigations within the frame. Link/form-level options take precedence. |
 | `onClickLink` | `(event, href) => void` | — | Called when a plain `<a>` inside the frame is clicked. Call `event.preventDefault()` to prevent navigation. |
+| `skipHistoryRestore` | `boolean` | `false` | When `true`, always makes an HTTP request on mount instead of restoring from history. |
 | `children` | `Snippet` | — | Fallback content rendered while the frame loads. |
 
 ### Scroll regions