inertia_rails 3.15.0 → 3.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2460d1f62147b4360786f5caba3ed7525d0539da9b61acc65dd9c93f925d7e7b
-  data.tar.gz: 741b89dd90fbf8b2fe212ef48ddd1e723ef69d9d13ffa5c35a3cc61d82443743
+  metadata.gz: dde0b293a9be9f560b828392e23a40cfb5ecb72f6c912e48660660640c211c9a
+  data.tar.gz: f72cce31fc538e2985f0be5c938c603ecfaeb03d0b6bafc682d32049c05f514f
 SHA512:
-  metadata.gz: 06a2bca60142ca5d450b4640fe6fe4df5000b15da57b8830c7993563d827b6d9abec3c3cf036d6ca33cf931a745e40ca81a52706598293e0e619bc4ed5bcb207
-  data.tar.gz: ee907ff350208d0e415aac873cc38b971d9a5fc8964b96dc502d031acd2af6ac5f6ab848163c2e56e60e3b855a1a7c95dc52fda1abbda5e1959a96cb00b068ac
+  metadata.gz: b4b064f174ceb0122be41945f045234d7caba21327bc750b9dd9bae49f5c14b17839a707e463b34f9ccaf0646f93f55b71d76fd22b1d31a11a6e12c324ed9afe
+  data.tar.gz: b38aa3f36e089e46a1f4d827ef32f9e1e12234e5490490cdc179cf90200bb2c6a7b7cbc66492d83df2a7d990b955ccf5e641f8718808a0391c1342ffa5256e1d

data/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.16.0] - 2025-12-30
+
+* Fix optional once props (@skryukov)
+* Support for new Flash API in Inertia.js page object (@skryukov)
+* Generator improvements (@skryukov)
+* Fix debug exceptions patch for Rails 8.2 (@crobbo)
+
 ## [3.15.0] - 2025-12-11
 
 * Support for rendering initial page data in a script tag (@skryukov)

data/lib/generators/inertia/install/helpers.rb

@@ -31,6 +31,15 @@ module Inertia
         File.join(destination_root, *relative_path)
       end
 
+      def update_package_json
+        package_json_path = file_path('package.json')
+        package_json = JSON.parse(File.read(package_json_path))
+
+        yield package_json
+
+        File.write(package_json_path, "#{JSON.pretty_generate(package_json)}\n")
+      end
+
       # Interactivity Helpers
       def ask(*)
         unless options[:interactive]

data/lib/generators/inertia/install/install_generator.rb

@@ -49,11 +49,6 @@ module Inertia
       def install
         say "Installing Inertia's Rails adapter"
 
-        if inertia_resolved_version.version == '0'
-          say_error "Could not find the Inertia.js package version #{options[:inertia_version]}.", :red
-          exit(false)
-        end
-
         install_vite unless ruby_vite_installed?
 
         install_typescript if typescript?
@@ -137,14 +132,6 @@ module Inertia
 
       def install_typescript
         say 'Adding TypeScript support'
-        if svelte? && inertia_resolved_version.release < Gem::Version.new('1.3.0')
-          say 'WARNING: @inertiajs/svelte < 1.3.0 does not support TypeScript ' \
-              "(resolved version: #{inertia_resolved_version}).",
-              :yellow
-          say 'Skipping TypeScript support for @inertiajs/svelte', :yellow
-          @typescript = false
-          return
-        end
 
         add_dependencies(*FRAMEWORKS[framework]['packages_ts'])
 
@@ -165,12 +152,16 @@ module Inertia
         end
 
         say 'Adding TypeScript check scripts to package.json'
-        if svelte?
-          run 'npm pkg set scripts.check="svelte-check --tsconfig ./tsconfig.json && tsc -p tsconfig.node.json"'
-        elsif react?
-          run 'npm pkg set scripts.check="tsc -p tsconfig.app.json && tsc -p tsconfig.node.json"'
-        elsif vue?
-          run 'npm pkg set scripts.check="vue-tsc -p tsconfig.app.json && tsc -p tsconfig.node.json"'
+        update_package_json do |package_json|
+          package_json['scripts'] ||= {}
+          package_json['scripts']['check'] =
+            if svelte?
+              'svelte-check --tsconfig ./tsconfig.json && tsc -p tsconfig.node.json'
+            elsif react?
+              'tsc -p tsconfig.app.json && tsc -p tsconfig.node.json'
+            elsif vue?
+              'vue-tsc -p tsconfig.app.json && tsc -p tsconfig.node.json'
+            end
         end
       end
 
@@ -225,6 +216,7 @@ module Inertia
             end
             if (capture = run('bundle exec vite install', capture: !verbose?))
               rename_application_js_to_ts if typescript?
+              run('bundle binstub vite_ruby', capture: !verbose?) if File.exist?(file_path('bin/vite'))
               say 'Vite Rails successfully installed', :green
             else
               say capture
@@ -325,13 +317,6 @@ module Inertia
         "#{tag} #{filename}"
       end
 
-      def inertia_resolved_version
-        package = "@inertiajs/core@#{options[:inertia_version]}"
-        @inertia_resolved_version ||= Gem::Version.new(
-          `npm show #{package} version --json | tail -n2 | head -n1 | tr -d '", '`.strip
-        )
-      end
-
       def verbose?
         options[:verbose]
       end

data/lib/generators/inertia/install/templates/inertia_controller.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
 class InertiaController < ApplicationController
-  inertia_share flash: -> { flash.to_hash }
+  # Share data with all Inertia responses
+  # see https://inertia-rails.dev/guide/shared-data
+  #   inertia_share user: -> { Current.user&.as_json(only: [:id, :name, :email]) }
 end

data/lib/generators/inertia/install/templates/react/types/globals.d.ts

@@ -1,8 +1,9 @@
-import type { SharedProps } from '@/types'
+import type { FlashData, SharedProps } from '@/types'
 
 declare module '@inertiajs/core' {
   export interface InertiaConfig {
     sharedPageProps: SharedProps
+    flashDataType: FlashData
     errorValueType: string[]
   }
 }

data/lib/generators/inertia/install/templates/react/types/index.ts

@@ -1,8 +1,6 @@
-export type Flash = {
+export type FlashData = {
   notice?: string
   alert?: string
 }
 
-export type SharedProps = {
-  flash: Flash
-}
+export type SharedProps = {}

data/lib/generators/inertia/install/templates/svelte/types/globals.d.ts

@@ -1,8 +1,9 @@
-import type { SharedProps } from '@/types'
+import type { FlashData, SharedProps } from '@/types'
 
 declare module '@inertiajs/core' {
   export interface InertiaConfig {
     sharedPageProps: SharedProps
+    flashDataType: FlashData
     errorValueType: string[]
   }
 }

data/lib/generators/inertia/install/templates/svelte/types/index.ts

@@ -1,8 +1,6 @@
-export type Flash = {
+export type FlashData = {
   notice?: string
   alert?: string
 }
 
-export type SharedProps = {
-  flash: Flash
-}
+export type SharedProps = {}

data/lib/generators/inertia/install/templates/vue/types/globals.d.ts

@@ -1,8 +1,9 @@
-import type { SharedProps } from '@/types'
+import type { FlashData, SharedProps } from '@/types'
 
 declare module '@inertiajs/core' {
   export interface InertiaConfig {
     sharedPageProps: SharedProps
+    flashDataType: FlashData
     errorValueType: string[]
   }
 }

data/lib/generators/inertia/install/templates/vue/types/index.ts

@@ -1,8 +1,6 @@
-export type Flash = {
+export type FlashData = {
   notice?: string
   alert?: string
 }
 
-export type SharedProps = {
-  flash: Flash
-}
+export type SharedProps = {}

data/lib/generators/inertia/scaffold_controller/templates/controller.rb.tt

@@ -5,10 +5,6 @@ class <%= controller_class_name %>Controller < <%= parent_controller %>
 <% if regular_class_path.any? -%>
   wrap_parameters :<%= singular_table_name %>
 
-<% end -%>
-<% if parent_controller != 'InertiaController' -%>
-  inertia_share flash: -> { flash.to_hash }
-
 <% end -%>
   # GET <%= route_url %>
   def index

data/lib/generators/inertia_templates/scaffold/templates/react/index.jsx.tt

@@ -1,7 +1,9 @@
-import { Head, Link } from '@inertiajs/react'
+import { Head, Link, usePage } from '@inertiajs/react'
 import <%= inertia_component_name %> from './<%= singular_name %>'
 
-export default function Index({ <%= plural_table_name %>, flash }) {
+export default function Index({ <%= plural_table_name %> }) {
+  const { flash } = usePage()
+
   return (
     <>
       <Head title="<%= human_name.pluralize %>" />

data/lib/generators/inertia_templates/scaffold/templates/react/index.tsx.tt

@@ -1,13 +1,14 @@
-import { Head, Link } from '@inertiajs/react'
+import { Head, Link, usePage } from '@inertiajs/react'
 import <%= inertia_component_name %> from './<%= singular_name %>'
 import { <%= inertia_model_type %> } from './types'
 
 interface IndexProps {
   <%= plural_table_name %>: <%= inertia_model_type %>[]
-  flash: { notice?: string }
 }
 
-export default function Index({ <%= plural_table_name %>, flash }: IndexProps) {
+export default function Index({ <%= plural_table_name %> }: IndexProps) {
+  const { flash } = usePage()
+
   return (
     <>
       <Head title="<%= human_name.pluralize %>" />

data/lib/generators/inertia_templates/scaffold/templates/react/show.jsx.tt

@@ -1,7 +1,9 @@
-import { Head, Link } from '@inertiajs/react'
+import { Head, Link, usePage } from '@inertiajs/react'
 import <%= inertia_component_name %> from './<%= singular_name %>'
 
-export default function Show({ <%= singular_table_name %>, flash }) {
+export default function Show({ <%= singular_table_name %> }) {
+  const { flash } = usePage()
+
   return (
     <>
       <Head title={`<%= human_name %> #${<%= singular_table_name %>.id}`} />

data/lib/generators/inertia_templates/scaffold/templates/react/show.tsx.tt

@@ -1,13 +1,14 @@
-import { Head, Link } from '@inertiajs/react'
+import { Head, Link, usePage } from '@inertiajs/react'
 import <%= inertia_component_name %> from './<%= singular_name %>'
 import { <%= inertia_model_type %> } from './types'
 
 interface ShowProps {
   <%= singular_table_name %>: <%= inertia_model_type %>
-  flash: { notice?: string }
 }
 
-export default function Show({ <%= singular_table_name %>, flash }: ShowProps) {
+export default function Show({ <%= singular_table_name %> }: ShowProps) {
+  const { flash } = usePage()
+
   return (
     <>
       <Head title={`<%= human_name %> #${<%= singular_table_name %>.id}`} />

data/lib/generators/inertia_templates/scaffold/templates/svelte/index.svelte.tt

@@ -1,16 +1,16 @@
 <script>
-  import { Link } from '@inertiajs/svelte'
+  import { Link, page } from '@inertiajs/svelte'
   import <%= inertia_component_name %> from './<%= singular_name %>.svelte'
 
-  let { <%= plural_table_name %>, flash } = $props()
+  let { <%= plural_table_name %> } = $props()
 </script>
 
 <svelte:head>
   <title><%= human_name.pluralize %></title>
 </svelte:head>
 
-{#if flash.notice}
-  <p class="notice">{flash.notice}</p>
+{#if $page.flash.notice}
+  <p class="notice">{$page.flash.notice}</p>
 {/if}
 
 <h1><%= human_name.pluralize %></h1>

data/lib/generators/inertia_templates/scaffold/templates/svelte/index.ts.svelte.tt

@@ -1,11 +1,10 @@
 <script lang="ts">
-  import { Link } from '@inertiajs/svelte'
+  import { Link, page } from '@inertiajs/svelte'
   import <%= inertia_component_name %> from './<%= singular_name %>.svelte'
   import type { <%= inertia_model_type %> } from './types'
 
-  let { <%= plural_table_name %>, flash } = $props<{
+  let { <%= plural_table_name %> } = $props<{
     <%= plural_table_name %>: <%= inertia_model_type %>[]
-    flash: { notice?: string }
   }>()
 </script>
 
@@ -13,8 +12,8 @@
   <title><%= human_name.pluralize %></title>
 </svelte:head>
 
-{#if flash.notice}
-  <p class="notice">{flash.notice}</p>
+{#if $page.flash.notice}
+  <p class="notice">{$page.flash.notice}</p>
 {/if}
 
 <h1><%= human_name.pluralize %></h1>

data/lib/generators/inertia_templates/scaffold/templates/svelte/show.svelte.tt

@@ -1,16 +1,16 @@
 <script>
-  import { Link } from '@inertiajs/svelte'
+  import { Link, page } from '@inertiajs/svelte'
   import <%= inertia_component_name %> from './<%= singular_name %>.svelte'
 
-  let { <%= singular_table_name %>, flash } = $props()
+  let { <%= singular_table_name %> } = $props()
 </script>
 
 <svelte:head>
   <title><%= human_name %> #{<%= singular_table_name %>.id}</title>
 </svelte:head>
 
-{#if flash.notice}
-  <p class="notice">{flash.notice}</p>
+{#if $page.flash.notice}
+  <p class="notice">{$page.flash.notice}</p>
 {/if}
 
 <h1><%= human_name %> #{<%= singular_table_name %>.id}</h1>

data/lib/generators/inertia_templates/scaffold/templates/svelte/show.ts.svelte.tt

@@ -1,11 +1,10 @@
 <script lang="ts">
-  import { Link } from '@inertiajs/svelte'
+  import { Link, page } from '@inertiajs/svelte'
   import <%= inertia_component_name %> from './<%= singular_name %>.svelte'
   import type { <%= inertia_model_type %> } from './types'
 
-  let { <%= singular_table_name %>, flash } = $props<{
+  let { <%= singular_table_name %> } = $props<{
     <%= singular_table_name %>: <%= inertia_model_type %>
-    flash: { notice?: string }
   }>()
 </script>
 
@@ -13,8 +12,8 @@
   <title><%= human_name %> #{<%= singular_table_name %>.id}</title>
 </svelte:head>
 
-{#if flash.notice}
-  <p class="notice">{flash.notice}</p>
+{#if $page.flash.notice}
+  <p class="notice">{$page.flash.notice}</p>
 {/if}
 
 <h1><%= human_name %> #{<%= singular_table_name %>.id}</h1>

data/lib/generators/inertia_templates/scaffold/templates/vue/index.ts.vue.tt

@@ -18,14 +18,14 @@
 </template>
 
 <script setup lang="ts">
-import { Head, Link } from '@inertiajs/vue3'
+import { Head, Link, usePage } from '@inertiajs/vue3'
 import <%= inertia_component_name %> from './<%= singular_name %>.vue'
 import { <%= inertia_model_type %> } from './types'
 
-const { <%= plural_table_name %>, flash } = defineProps<{
+defineProps<{
   <%= plural_table_name %>: <%= inertia_model_type %>[]
-  flash: { notice?: string }
 }>()
+const { flash } = usePage()
 </script>
 
 <style scoped>

data/lib/generators/inertia_templates/scaffold/templates/vue/index.vue.tt

@@ -18,10 +18,11 @@
 </template>
 
 <script setup>
-import { Head, Link } from '@inertiajs/vue3'
+import { Head, Link, usePage } from '@inertiajs/vue3'
 import <%= inertia_component_name %> from './<%= singular_name %>.vue'
 
-const { <%= plural_table_name %>, flash } = defineProps(['<%= plural_table_name %>', 'flash'])
+defineProps(['<%= plural_table_name %>'])
+const { flash } = usePage()
 </script>
 
 <style scoped>

data/lib/generators/inertia_templates/scaffold/templates/vue/show.ts.vue.tt

@@ -24,14 +24,14 @@
 </template>
 
 <script setup lang="ts">
-import { Head, Link } from '@inertiajs/vue3'
+import { Head, Link, usePage } from '@inertiajs/vue3'
 import <%= inertia_component_name %> from './<%= singular_name %>.vue'
 import { <%= inertia_model_type %> } from './types'
 
-const { <%= singular_table_name %>, flash } = defineProps<{
+defineProps<{
   <%= singular_table_name %>: <%= inertia_model_type %>
-  flash: { notice?: string }
 }>()
+const { flash } = usePage()
 </script>
 
 <style scoped>

data/lib/generators/inertia_templates/scaffold/templates/vue/show.vue.tt

@@ -24,10 +24,11 @@
 </template>
 
 <script setup>
-import { Head, Link } from '@inertiajs/vue3'
+import { Head, Link, usePage } from '@inertiajs/vue3'
 import <%= inertia_component_name %> from './<%= singular_name %>.vue'
 
-const { <%= singular_table_name %>, flash } = defineProps(['<%= singular_table_name %>', 'flash'])
+defineProps(['<%= singular_table_name %>'])
+const { flash } = usePage()
 </script>
 
 <style scoped>

data/lib/generators/inertia_tw_templates/scaffold/templates/react/edit.jsx.tt

@@ -11,12 +11,12 @@ export default function Edit({ <%= singular_table_name %> }) {
 
         <Form
           <%= singular_table_name %>={<%= singular_table_name %>}
-            action={`<%= js_resource_path %>`}
+          action={`<%= js_resource_path %>`}
 <% if attributes.any?(&:attachments?) -%>
-            method="post"
-            headers={{ 'X-HTTP-METHOD-OVERRIDE': 'patch' }}
+          method="post"
+          headers={{ 'X-HTTP-METHOD-OVERRIDE': 'patch' }}
 <% else -%>
-            method="patch"
+          method="patch"
 <% end -%>
           submitText="Update <%= human_name %>"
         />

data/lib/generators/inertia_tw_templates/scaffold/templates/react/edit.tsx.tt

@@ -16,12 +16,12 @@ export default function Edit({ <%= singular_table_name %> }: EditProps) {
 
         <Form
           <%= singular_table_name %>={<%= singular_table_name %>}
-            action={`<%= js_resource_path %>`}
+          action={`<%= js_resource_path %>`}
 <% if attributes.any?(&:attachments?) -%>
-            method="post"
-            headers={{ 'X-HTTP-METHOD-OVERRIDE': 'patch' }}
+          method="post"
+          headers={{ 'X-HTTP-METHOD-OVERRIDE': 'patch' }}
 <% else -%>
-            method="patch"
+          method="patch"
 <% end -%>
           submitText="Update <%= human_name %>"
         />

data/lib/generators/inertia_tw_templates/scaffold/templates/react/index.jsx.tt

@@ -1,8 +1,10 @@
-import { Head, Link } from '@inertiajs/react'
+import { Head, Link, usePage } from '@inertiajs/react'
 import { Fragment } from 'react'
 import <%= inertia_component_name %> from './<%= singular_name %>'
 
-export default function Index({ <%= plural_table_name %>, flash }) {
+export default function Index({ <%= plural_table_name %> }) {
+  const { flash } = usePage()
+
   return (
     <>
       <Head title="<%= human_name.pluralize %>" />

data/lib/generators/inertia_tw_templates/scaffold/templates/react/index.tsx.tt

@@ -1,14 +1,15 @@
-import { Head, Link } from '@inertiajs/react'
+import { Head, Link, usePage } from '@inertiajs/react'
 import { Fragment } from 'react'
 import <%= inertia_component_name %> from './<%= singular_name %>'
 import { <%= inertia_model_type %> } from './types'
 
 interface IndexProps {
   <%= plural_table_name %>: <%= inertia_model_type %>[]
-  flash: { notice?: string }
 }
 
-export default function Index({ <%= plural_table_name %>, flash }: IndexProps) {
+export default function Index({ <%= plural_table_name %> }: IndexProps) {
+  const { flash } = usePage()
+
   return (
     <>
       <Head title="<%= human_name.pluralize %>" />

data/lib/generators/inertia_tw_templates/scaffold/templates/react/show.jsx.tt

@@ -1,7 +1,9 @@
-import { Head, Link } from '@inertiajs/react'
+import { Head, Link, usePage } from '@inertiajs/react'
 import <%= inertia_component_name %> from './<%= singular_name %>'
 
-export default function Show({ <%= singular_table_name %>, flash }) {
+export default function Show({ <%= singular_table_name %> }) {
+  const { flash } = usePage()
+
   return (
     <>
       <Head title={`<%= human_name %> #${<%= singular_table_name %>.id}`} />

data/lib/generators/inertia_tw_templates/scaffold/templates/react/show.tsx.tt

@@ -1,13 +1,14 @@
-import { Head, Link } from '@inertiajs/react'
+import { Head, Link, usePage } from '@inertiajs/react'
 import <%= inertia_component_name %> from './<%= singular_name %>'
 import { <%= inertia_model_type %> } from './types'
 
 interface ShowProps {
   <%= singular_table_name %>: <%= inertia_model_type %>
-  flash: { notice?: string }
 }
 
-export default function Show({ <%= singular_table_name %>, flash }: ShowProps) {
+export default function Show({ <%= singular_table_name %> }: ShowProps) {
+  const { flash } = usePage()
+
   return (
     <>
       <Head title={`<%= human_name %> #${<%= singular_table_name %>.id}`} />

data/lib/generators/inertia_tw_templates/scaffold/templates/svelte/index.svelte.tt

@@ -1,8 +1,8 @@
 <script>
-  import { Link } from '@inertiajs/svelte'
+  import { Link, page } from '@inertiajs/svelte'
   import <%= inertia_component_name %> from './<%= singular_name %>.svelte'
 
-  let { <%= plural_table_name %>, flash } = $props()
+  let { <%= plural_table_name %> } = $props()
 </script>
 
 <svelte:head>
@@ -10,9 +10,9 @@
 </svelte:head>
 
 <div class="mx-auto md:w-2/3 w-full px-8 pt-8">
-  {#if flash.notice}
+  {#if $page.flash.notice}
     <p class="py-2 px-3 bg-green-50 mb-5 text-green-500 font-medium rounded-lg inline-block">
-      {flash.notice}
+      {$page.flash.notice}
     </p>
   {/if}
 

data/lib/generators/inertia_tw_templates/scaffold/templates/svelte/index.ts.svelte.tt

@@ -1,11 +1,10 @@
 <script lang="ts">
-  import { Link } from '@inertiajs/svelte'
+  import { Link, page } from '@inertiajs/svelte'
   import <%= inertia_component_name %> from './<%= singular_name %>.svelte'
   import type { <%= inertia_model_type %> } from './types'
 
-  let { <%= plural_table_name %>, flash } = $props<{
+  let { <%= plural_table_name %> } = $props<{
     <%= plural_table_name %>: <%= inertia_model_type %>[]
-    flash: { notice?: string }
   }>()
 </script>
 
@@ -14,9 +13,9 @@
 </svelte:head>
 
 <div class="mx-auto md:w-2/3 w-full px-8 pt-8">
-  {#if flash.notice}
+  {#if $page.flash.notice}
     <p class="py-2 px-3 bg-green-50 mb-5 text-green-500 font-medium rounded-lg inline-block">
-      {flash.notice}
+      {$page.flash.notice}
     </p>
   {/if}
 

data/lib/generators/inertia_tw_templates/scaffold/templates/svelte/show.svelte.tt

@@ -1,8 +1,8 @@
 <script>
-  import { Link } from '@inertiajs/svelte'
+  import { Link, page } from '@inertiajs/svelte'
   import <%= inertia_component_name %> from './<%= singular_name %>.svelte'
 
-  let { <%= singular_table_name %>, flash } = $props()
+  let { <%= singular_table_name %> } = $props()
 </script>
 
 <svelte:head>
@@ -11,9 +11,9 @@
 
 <div class="mx-auto md:w-2/3 w-full px-8 pt-8">
   <div class="mx-auto">
-    {#if flash.notice}
+    {#if $page.flash.notice}
       <p class="py-2 px-3 bg-green-50 mb-5 text-green-500 font-medium rounded-lg inline-block">
-        {flash.notice}
+        {$page.flash.notice}
       </p>
     {/if}
 

data/lib/generators/inertia_tw_templates/scaffold/templates/svelte/show.ts.svelte.tt

@@ -1,11 +1,10 @@
 <script lang="ts">
-  import { Link } from '@inertiajs/svelte'
+  import { Link, page } from '@inertiajs/svelte'
   import <%= inertia_component_name %> from './<%= singular_name %>.svelte'
   import type { <%= inertia_model_type %> } from './types'
 
-  let { <%= singular_table_name %>, flash } = $props<{
+  let { <%= singular_table_name %> } = $props<{
     <%= singular_table_name %>: <%= inertia_model_type %>
-    flash: { notice?: string }
   }>()
 </script>
 
@@ -15,9 +14,9 @@
 
 <div class="mx-auto md:w-2/3 w-full px-8 pt-8">
   <div class="mx-auto">
-    {#if flash.notice}
+    {#if $page.flash.notice}
       <p class="py-2 px-3 bg-green-50 mb-5 text-green-500 font-medium rounded-lg inline-block">
-        {flash.notice}
+        {$page.flash.notice}
       </p>
     {/if}
 

data/lib/generators/inertia_tw_templates/scaffold/templates/vue/index.ts.vue.tt

@@ -36,12 +36,12 @@
 </template>
 
 <script setup lang="ts">
-import { Head, Link } from '@inertiajs/vue3'
+import { Head, Link, usePage } from '@inertiajs/vue3'
 import <%= inertia_component_name %> from './<%= singular_name %>.vue'
 import { <%= inertia_model_type %> } from './types'
 
-const { <%= plural_table_name %>, flash } = defineProps<{
+defineProps<{
   <%= plural_table_name %>: <%= inertia_model_type %>[]
-  flash: { notice?: string }
 }>()
+const { flash } = usePage()
 </script>

data/lib/generators/inertia_tw_templates/scaffold/templates/vue/index.vue.tt

@@ -36,8 +36,9 @@
 </template>
 
 <script setup>
-import { Head, Link } from '@inertiajs/vue3'
+import { Head, Link, usePage } from '@inertiajs/vue3'
 import <%= inertia_component_name %> from './<%= singular_name %>.vue'
 
-const { <%= plural_table_name %>, flash } = defineProps(['<%= plural_table_name %>', 'flash'])
+defineProps(['<%= plural_table_name %>'])
+const { flash } = usePage()
 </script>

data/lib/generators/inertia_tw_templates/scaffold/templates/vue/show.ts.vue.tt

@@ -42,12 +42,12 @@
 </template>
 
 <script setup lang="ts">
-import { Head, Link } from '@inertiajs/vue3'
+import { Head, Link, usePage } from '@inertiajs/vue3'
 import <%= inertia_component_name %> from './<%= singular_name %>.vue'
 import { <%= inertia_model_type %> } from './types'
 
-const { <%= singular_table_name %>, flash } = defineProps<{
+defineProps<{
   <%= singular_table_name %>: <%= inertia_model_type %>
-  flash: { notice?: string }
 }>()
+const { flash } = usePage()
 </script>

data/lib/generators/inertia_tw_templates/scaffold/templates/vue/show.vue.tt

@@ -42,8 +42,9 @@
 </template>
 
 <script setup>
-import { Head, Link } from '@inertiajs/vue3'
+import { Head, Link, usePage } from '@inertiajs/vue3'
 import <%= inertia_component_name %> from './<%= singular_name %>.vue'
 
-const { <%= singular_table_name %>, flash } = defineProps(['<%= singular_table_name %>', 'flash'])
+defineProps(['<%= singular_table_name %>'])
+const { flash } = usePage()
 </script>

data/lib/inertia_rails/configuration.rb

@@ -40,6 +40,10 @@ module InertiaRails
 
       # DOM id to use for the root Inertia.js element.
       root_dom_id: 'app',
+
+      # Flash keys from Rails flash to expose to frontend.
+      # Set to nil to disable Rails flash integration (use only flash.inertia).
+      flash_keys: %i[notice alert].freeze,
     }.freeze
 
     OPTION_NAMES = DEFAULTS.keys.freeze

data/lib/inertia_rails/controller.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative 'inertia_rails'
+require_relative 'flash_extension'
 require_relative 'helper'
 require_relative 'action_filter'
 require_relative 'meta_tag_builder'
@@ -180,6 +181,17 @@ module InertiaRails
       head :conflict
     end
 
+    def inertia_collect_flash_data
+      flash_data = flash.to_hash
+
+      allowed_keys = inertia_configuration.flash_keys
+      result = allowed_keys ? flash_data.slice(*allowed_keys.map(&:to_s)) : {}
+
+      result.merge!(flash_data['inertia'].transform_keys(&:to_s)) if flash_data['inertia'].is_a?(Hash)
+
+      result.symbolize_keys
+    end
+
     def capture_inertia_session_options(options)
       return unless (inertia = options[:inertia])
 
@@ -192,7 +204,6 @@ module InertiaRails
           )
           session[:inertia_errors] = inertia_errors
         end
-
       end
 
       session[:inertia_clear_history] = inertia[:clear_history] if inertia[:clear_history]

data/lib/inertia_rails/engine.rb

@@ -2,6 +2,7 @@
 
 require_relative 'middleware'
 require_relative 'controller'
+require_relative 'flash_extension'
 
 module InertiaRails
   class Engine < ::Rails::Engine
@@ -14,5 +15,10 @@ module InertiaRails
         include ::InertiaRails::Controller
       end
     end
+
+    initializer 'inertia_rails.flash_extension' do
+      ActionDispatch::Flash::FlashHash.prepend ::InertiaRails::FlashExtension
+      ActionDispatch::Flash::FlashNow.prepend ::InertiaRails::FlashExtension
+    end
   end
 end

data/lib/inertia_rails/flash_extension.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module InertiaRails
+  # Provides a scoped interface for Inertia flash data within Rails' flash.
+  # Uses native hash storage: flash[:inertia] = { key: value }
+  # Tracks .now keys separately in @inertia_now_keys for session filtering.
+  module FlashExtension
+    INERTIA_KEY = 'inertia'
+
+    def inertia
+      @inertia ||= InertiaFlashScope.new(self)
+    end
+
+    # Keys set via flash.now.inertia that should not persist to session
+    def inertia_now_keys
+      @inertia_now_keys ||= Set.new
+    end
+
+    # Clear .now tracking when user explicitly keeps :inertia or all flash
+    def keep(key = nil)
+      @inertia_now_keys&.clear if key.nil? || key.to_s == INERTIA_KEY
+      super
+    end
+
+    # Override to filter .now keys from nested inertia hash before session persistence
+    def to_session_value
+      inertia_hash = self[INERTIA_KEY]
+      if inertia_hash.is_a?(Hash) && @inertia_now_keys&.any?
+        @inertia_now_keys.each { |k| inertia_hash.delete(k.to_s) }
+        delete(INERTIA_KEY) if inertia_hash.empty?
+      end
+
+      super
+    end
+
+    class InertiaFlashScope
+      def initialize(flash_or_now)
+        if flash_or_now.respond_to?(:flash)
+          @flash = flash_or_now.flash
+          @now = true
+        else
+          @flash = flash_or_now
+          @now = false
+        end
+      end
+
+      def []=(key, value)
+        @flash[INERTIA_KEY] ||= {}
+        @flash[INERTIA_KEY][key.to_s] = value
+        @flash.inertia_now_keys.add(key.to_s) if @now
+      end
+
+      def [](key)
+        @flash[INERTIA_KEY]&.[](key.to_s)
+      end
+
+      def to_hash
+        @flash[INERTIA_KEY]&.dup || {}
+      end
+      alias to_h to_hash
+    end
+  end
+end

data/lib/inertia_rails/generators/helper.rb

@@ -87,14 +87,6 @@ module InertiaRails
         route_url
       end
 
-      def inertia_js_version
-        @inertia_js_version ||= Gem::Version.new(
-          JSON.parse(`npm ls @inertiajs/core --json`).then do |json|
-            json['dependencies'].values.first['version']
-          end
-        )
-      end
-
       def ts_type(attribute)
         case attribute.type
         when :float, :decimal, :integer

data/lib/inertia_rails/inertia_rails.rb

@@ -30,8 +30,8 @@ module InertiaRails
       LazyProp.new(value, &block)
     end
 
-    def optional(&block)
-      OptionalProp.new(&block)
+    def optional(...)
+      OptionalProp.new(...)
     end
 
     def always(&block)

data/lib/inertia_rails/middleware.rb

@@ -21,7 +21,7 @@ module InertiaRails
         status, headers, body = @app.call(@env)
         request = ActionDispatch::Request.new(@env)
 
-        # Inertia errors are added to the session via redirect_to
+        # Inertia session data is added via redirect_to
         unless keep_inertia_session_options?(status)
           request.session.delete(:inertia_errors)
           request.session.delete(:inertia_clear_history)

data/lib/inertia_rails/renderer.rb

@@ -125,6 +125,9 @@ module InertiaRails
         clearHistory: @clear_history,
       }
 
+      flash_data = @controller.__send__(:inertia_collect_flash_data)
+      @page[:flash] = flash_data if flash_data.present?
+
       deferred_props = deferred_props_keys
       @page[:deferredProps] = deferred_props if deferred_props.present?
       @page[:scrollProps] = scroll_props if scroll_props.present?

data/lib/inertia_rails/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module InertiaRails
-  VERSION = '3.15.0'
+  VERSION = '3.16.0'
 end

data/lib/patches/debug_exceptions.rb

@@ -5,18 +5,22 @@
 # The original source needs to be patched, so that Inertia requests are
 # NOT responded with plain text, but with HTML.
 #
-# Original source (unchanged since Rails 5.1):
-# https://github.com/rails/rails/blob/5-1-stable/actionpack/lib/action_dispatch/middleware/debug_exceptions.rb
+# Original source:
 # https://github.com/rails/rails/blob/8-0-stable/actionpack/lib/action_dispatch/middleware/debug_exceptions.rb
+# https://github.com/rails/rails/blob/main/actionpack/lib/action_dispatch/middleware/debug_exceptions.rb
 #
 
 module InertiaRails
   module InertiaDebugExceptions
-    def render_for_browser_request(request, wrapper)
+    # Rails 8.2+ passes content_type as third argument
+    def render_for_browser_request(request, wrapper, content_type = nil)
       template = create_template(request, wrapper)
       file = "rescues/#{wrapper.rescue_template}"
 
-      if request.xhr? && !request.headers['X-Inertia'] # <<<< this line is changed only
+      if content_type == Mime[:md]
+        body = template.render(template: file, layout: false, formats: [:text])
+        format = 'text/markdown'
+      elsif request.xhr? && !request.headers['X-Inertia']
         body = template.render(template: file, layout: false, formats: [:text])
         format = 'text/plain'
       else

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: inertia_rails
 version: !ruby/object:Gem::Version
-  version: 3.15.0
+  version: 3.16.0
 platform: ruby
 authors:
 - Brian Knoles
@@ -9,7 +9,7 @@ authors:
 - Eugene Granovsky
 bindir: bin
 cert_chain: []
-date: 2025-12-12 00:00:00.000000000 Z
+date: 2025-12-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -189,6 +189,7 @@ files:
 - lib/inertia_rails/controller.rb
 - lib/inertia_rails/defer_prop.rb
 - lib/inertia_rails/engine.rb
+- lib/inertia_rails/flash_extension.rb
 - lib/inertia_rails/generators/controller_template_base.rb
 - lib/inertia_rails/generators/helper.rb
 - lib/inertia_rails/generators/scaffold_template_base.rb