inertia_rails 3.10.0 → 3.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8109050832c842cdc65c514f09a7ab02ce79a0925517fcb1f34eceee8d54130
-  data.tar.gz: 6ce4aaf2b8d4d2615f4e53220a23d712c97c482a2705c70a9423a1ce51b6d1ca
+  metadata.gz: 95b5901a42397a1ae01678a1101d5d21a6a2f2f33c6afb413a2fbca48f04e064
+  data.tar.gz: a4d04ff25ce45b4392e5ad5c5153530446f83256e2b00452999da0c920751416
 SHA512:
-  metadata.gz: 32e92a9898314ff42c67450acc691513cc7e833eff2d15999bb4d4d642b62a7c1f94bcdff3093a79448f95adda2072d0d2e18d7250f9a8dfcb0a57cbcc3fa633
-  data.tar.gz: 147352323994ef1bc475aee16990581ba6714769ac157f144c5f1bb296b6058a4bcdf9d5f00fef47cfa26a488b91878aea1e046e7bb9b70e74cda4e8a61ef31c
+  metadata.gz: 222ebe8277d96856c05c9d712ad0d0e33cea995e7195dada790cf6423e3ad9f16b970c555c9889a1d7eb9082ad9045ca73a00bc95116fc93912f429fc1ded50f
+  data.tar.gz: f859bfb3d498ae8bc2c146e5bd8d9be8cadb65a6f3a51135c89bd1f3e86c83007f2602b9e6b115179e7f294dc663e3c96ce9073890511b478689ddf99156e1b9

data/CHANGELOG.md

@@ -4,6 +4,22 @@ 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.12.0] - 2025-11-08
+
+* Docs updates (@leenyburger, @skryukov, @bn-l)
+* Reimplement devcontainers (@kieraneglin)
+* Support for Inertia.js infinite scroll components (@skyrukov)
+* New merge options (@skryukov)
+
+## [3.11.0] - 2025-08-29
+
+* Fix Svelte generator (@skryukov)
+* Docs updates for SSR and 2.1.2 (@skryukov)
+* Devcontainers for local dev (@kieraneglin)
+* Add configurable prop transformation (@kieraneglin)
+* Gradual deprecation of null errors because Inertis.js expects an empty object (@skryukov)
+* Allow the more helpful UnknownFormat exception to raise when a static intertia route is requested with a non-HTML format (@skryukov)
+
 ## [3.10.0] - 2025-07-30
 
 * llms.txt in docs (@brandonshar and @skryukov)

data/app/controllers/inertia_rails/static_controller.rb

@@ -1,7 +1,11 @@
+# frozen_string_literal: true
+
 module InertiaRails
   class StaticController < InertiaRails.configuration.parent_controller.constantize
     def static
-      render inertia: params[:component]
+      respond_to do |format|
+        format.html { render inertia: params[:component] }
+      end
     end
   end
 end

data/lib/generators/inertia/install/frameworks.yml

@@ -4,6 +4,7 @@ react:
     - "@vitejs/plugin-react"
     - "react"
     - "react-dom"
+    - "vite@latest"
   packages_ts:
     - "@types/react"
     - "@types/react-dom"
@@ -29,6 +30,7 @@ vue:
   packages:
     - "vue"
     - "@vitejs/plugin-vue"
+    - "vite@latest"
   packages_ts:
     - "typescript@~5.6.2"
     - "vue-tsc"
@@ -52,6 +54,7 @@ svelte4:
   packages:
     - "svelte@4"
     - "@sveltejs/vite-plugin-svelte@3"
+    - "vite@5"
   packages_ts:
     - "@tsconfig/svelte@4"
     - "svelte-check"
@@ -76,7 +79,8 @@ svelte:
   inertia_package: "@inertiajs/svelte"
   packages:
     - "svelte@5"
-    - "@sveltejs/vite-plugin-svelte@4"
+    - "@sveltejs/vite-plugin-svelte"
+    - "vite@latest"
   packages_ts:
     - "@tsconfig/svelte@5"
     - "svelte-check"

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

@@ -128,8 +128,12 @@ module Inertia
         add_dependencies(*FRAMEWORKS[framework]['packages_ts'])
 
         say 'Copying adding scripts to package.json'
-        run 'npm pkg set scripts.check="svelte-check --tsconfig ./tsconfig.json && tsc -p tsconfig.node.json"' if svelte?
-        run 'npm pkg set scripts.check="vue-tsc -p tsconfig.app.json && tsc -p tsconfig.node.json"' if framework == 'vue'
+        if svelte?
+          run 'npm pkg set scripts.check="svelte-check --tsconfig ./tsconfig.json && tsc -p tsconfig.node.json"'
+        end
+        if framework == 'vue'
+          run 'npm pkg set scripts.check="vue-tsc -p tsconfig.app.json && tsc -p tsconfig.node.json"'
+        end
         run 'npm pkg set scripts.check="tsc -p tsconfig.app.json && tsc -p tsconfig.node.json"' if framework == 'react'
       end
 
@@ -262,8 +266,9 @@ module Inertia
       end
 
       def inertia_resolved_version
+        package = "@inertiajs/core@#{options[:inertia_version]}"
         @inertia_resolved_version ||= Gem::Version.new(
-          `npm show @inertiajs/core@#{options[:inertia_version]} version --json | tail -n2 | head -n1 | tr -d '", '`.strip
+          `npm show #{package} version --json | tail -n2 | head -n1 | tr -d '", '`.strip
         )
       end
 

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

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 InertiaRails.configure do |config|
-  config.ssr_enabled = ViteRuby.config.ssr_build_enabled
   config.version = ViteRuby.digest
+  config.encrypt_history = true
+  config.always_include_errors_hash = true
 end

data/lib/generators/inertia/install/templates/svelte/inertia.js

@@ -2,11 +2,6 @@ import { createInertiaApp } from '@inertiajs/svelte'
 import  { mount } from 'svelte';
 
 createInertiaApp({
-  // Set default page title
-  // see https://inertia-rails.dev/guide/title-and-meta
-  //
-  // title: title => title ? `${title} - App` : 'App',
-
   // Disable progress bar
   //
   // see https://inertia-rails.dev/guide/progress-indicators

data/lib/generators/inertia/install/templates/svelte/inertia.ts.tt

@@ -2,11 +2,6 @@ import { createInertiaApp, type ResolvedComponent } from '@inertiajs/svelte'
 import { mount } from 'svelte'
 
 createInertiaApp({
-  // Set default page title
-  // see https://inertia-rails.dev/guide/title-and-meta
-  //
-  // title: title => title ? `${title} - App` : 'App',
-
   // Disable progress bar
   //
   // see https://inertia-rails.dev/guide/progress-indicators
@@ -25,7 +20,7 @@ createInertiaApp({
     // and use the following line.
     // see https://inertia-rails.dev/guide/pages#default-layouts
     //
-    // return { default: page.default, layout: page.layout || Layout }
+    // return { default: page.default, layout: page.layout || Layout } as ResolvedComponent
 
     return page
   },

data/lib/inertia_rails/action_filter.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 #
 # Based on AbstractController::Callbacks::ActionFilter
 # https://github.com/rails/rails/blob/v7.2.0/actionpack/lib/abstract_controller/callbacks.rb#L39
@@ -6,7 +7,7 @@ module InertiaRails
   class ActionFilter
     def initialize(conditional_key, actions)
       @conditional_key = conditional_key
-      @actions = Array(actions).map(&:to_s).to_set
+      @actions = Array(actions).to_set(&:to_s)
     end
 
     def match?(controller)

data/lib/inertia_rails/configuration.rb

@@ -12,6 +12,9 @@ module InertiaRails
       # Allows the user to hook into the default rendering behavior and change it to fit their needs
       component_path_resolver: ->(path:, action:) { "#{path}/#{action}" },
 
+      # A function that transforms the props before they are sent to the client.
+      prop_transformer: ->(props:) { props },
+
       # DEPRECATED: Let Rails decide which layout should be used based on the
       # controller configuration.
       layout: true,
@@ -26,8 +29,11 @@ module InertiaRails
       # Used to detect version drift between server and client.
       version: nil,
 
-      # Allows configuring the base controller for StaticController
+      # Allows configuring the base controller for StaticController.
       parent_controller: '::ApplicationController',
+
+      # Whether to include empty `errors` hash to the props when no errors are present.
+      always_include_errors_hash: nil,
     }.freeze
 
     OPTION_NAMES = DEFAULTS.keys.freeze
@@ -89,6 +95,10 @@ module InertiaRails
       @options[:component_path_resolver].call(path: path, action: action)
     end
 
+    def prop_transformer(props:)
+      @options[:prop_transformer].call(props: props)
+    end
+
     OPTION_NAMES.each do |option|
       unless method_defined?(option)
         define_method(option) do

data/lib/inertia_rails/controller.rb

@@ -1,7 +1,9 @@
-require_relative "inertia_rails"
-require_relative "helper"
-require_relative "action_filter"
-require_relative "meta_tag_builder"
+# frozen_string_literal: true
+
+require_relative 'inertia_rails'
+require_relative 'helper'
+require_relative 'action_filter'
+require_relative 'meta_tag_builder'
 
 module InertiaRails
   module Controller
@@ -21,8 +23,8 @@ module InertiaRails
         return push_to_inertia_share(**(hash || props), &block) if options.empty?
 
         push_to_inertia_share do
-          next unless options[:if].all? { |filter| instance_exec(&filter) } if options[:if]
-          next unless options[:unless].none? { |filter| instance_exec(&filter)  } if options[:unless]
+          next if options[:if] && !options[:if].all? { |filter| instance_exec(&filter) }
+          next if options[:unless]&.any? { |filter| instance_exec(&filter) }
 
           next hash unless block
 
@@ -81,7 +83,9 @@ module InertiaRails
         return options if options.empty?
 
         if props.except(:if, :unless, :only, :except).any?
-          raise ArgumentError, "You must not mix shared data and [:if, :unless, :only, :except] options, pass data as a hash or a block."
+          raise ArgumentError,
+                'You must not mix shared data and [:if, :unless, :only, :except] options, ' \
+                'pass data as a hash or a block.'
         end
 
         transform_inertia_share_option(options, :only, :if)
@@ -110,7 +114,7 @@ module InertiaRails
         when InertiaRails::ActionFilter
           -> { filter.match?(self) }
         else
-          raise ArgumentError, "You must pass a symbol or a proc as a filter."
+          raise ArgumentError, 'You must pass a symbol or a proc as a filter.'
         end
       end
     end
@@ -136,6 +140,7 @@ module InertiaRails
 
     def inertia_view_assigns
       return {} unless @_inertia_instance_props
+
       view_assigns.except(*@_inertia_skip_props)
     end
 
@@ -144,15 +149,30 @@ module InertiaRails
     end
 
     def inertia_shared_data
-      initial_data = session[:inertia_errors].present? ? {errors: session[:inertia_errors]} : {}
+      initial_data =
+        if session[:inertia_errors].present?
+          { errors: session[:inertia_errors] }
+        elsif inertia_configuration.always_include_errors_hash
+          { errors: {} }
+        else
+          if inertia_configuration.always_include_errors_hash.nil?
+            InertiaRails.deprecator.warn(
+              'To comply with the Inertia protocol, an empty errors hash `{errors: {}}` ' \
+              'will be included to all responses by default starting with InertiaRails 4.0. ' \
+              'To opt-in now, set `config.always_include_errors_hash = true`. ' \
+              'To disable this warning, set it to `false`.'
+            )
+          end
+          {}
+        end
 
-      self.class._inertia_shared_data.filter_map { |shared_data|
+      self.class._inertia_shared_data.filter_map do |shared_data|
         if shared_data.respond_to?(:call)
           instance_exec(&shared_data)
         else
           shared_data
         end
-      }.reduce(initial_data, &:merge)
+      end.reduce(initial_data, &:merge)
     end
 
     def inertia_location(url)
@@ -168,7 +188,7 @@ module InertiaRails
           session[:inertia_errors] = inertia_errors.to_hash
         else
           InertiaRails.deprecator.warn(
-            "Object passed to `inertia: { errors: ... }` must respond to `to_hash`. Pass a hash-like object instead."
+            'Object passed to `inertia: { errors: ... }` must respond to `to_hash`. Pass a hash-like object instead.'
           )
           session[:inertia_errors] = inertia_errors
         end

data/lib/inertia_rails/defer_prop.rb

@@ -2,27 +2,16 @@
 
 module InertiaRails
   class DeferProp < IgnoreOnFirstLoadProp
-    DEFAULT_GROUP = 'default'
+    prepend PropMergeable
 
-    attr_reader :group, :match_on
+    DEFAULT_GROUP = 'default'
 
-    def initialize(group: nil, merge: nil, deep_merge: nil, match_on: nil, &block)
-      raise ArgumentError, 'Cannot set both `deep_merge` and `merge` to true' if deep_merge && merge
+    attr_reader :group
 
+    def initialize(**props, &block)
       super(&block)
 
-      @group = group || DEFAULT_GROUP
-      @merge = merge || deep_merge
-      @deep_merge = deep_merge
-      @match_on = match_on.nil? ? nil : Array(match_on)
-    end
-
-    def merge?
-      @merge
-    end
-
-    def deep_merge?
-      @deep_merge
+      @group = props[:group] || DEFAULT_GROUP
     end
   end
 end

data/lib/inertia_rails/engine.rb

@@ -1,13 +1,15 @@
-require_relative "middleware"
-require_relative "controller"
+# frozen_string_literal: true
+
+require_relative 'middleware'
+require_relative 'controller'
 
 module InertiaRails
   class Engine < ::Rails::Engine
-    initializer "inertia_rails.configure_rails_initialization" do |app|
+    initializer 'inertia_rails.configure_rails_initialization' do |app|
       app.middleware.use ::InertiaRails::Middleware
     end
 
-    initializer "inertia_rails.action_controller" do
+    initializer 'inertia_rails.action_controller' do
       ActiveSupport.on_load(:action_controller_base) do
         include ::InertiaRails::Controller
       end

data/lib/inertia_rails/helper.rb

@@ -1,32 +1,36 @@
+# frozen_string_literal: true
+
 require_relative 'inertia_rails'
 
-module InertiaRails::Helper
-  def inertia_ssr_head
-    controller.instance_variable_get("@_inertia_ssr_head")
-  end
+module InertiaRails
+  module Helper
+    def inertia_ssr_head
+      controller.instance_variable_get('@_inertia_ssr_head')
+    end
 
-  def inertia_headers
-    InertiaRails.deprecator.warn(
-      "`inertia_headers` is deprecated and will be removed in InertiaRails 4.0, use `inertia_ssr_head` instead."
-    )
-    inertia_ssr_head
-  end
+    def inertia_headers
+      InertiaRails.deprecator.warn(
+        '`inertia_headers` is deprecated and will be removed in InertiaRails 4.0, use `inertia_ssr_head` instead.'
+      )
+      inertia_ssr_head
+    end
 
-  def inertia_rendering?
-    controller.instance_variable_get("@_inertia_rendering")
-  end
+    def inertia_rendering?
+      controller.instance_variable_get('@_inertia_rendering')
+    end
 
-  def inertia_page
-    controller.instance_variable_get("@_inertia_page")
-  end
+    def inertia_page
+      controller.instance_variable_get('@_inertia_page')
+    end
 
-  def inertia_meta_tags
-    meta_tag_data = (inertia_page || {}).dig(:props, :_inertia_meta) || []
+    def inertia_meta_tags
+      meta_tag_data = (inertia_page || {}).dig(:props, :_inertia_meta) || []
 
-    meta_tags = meta_tag_data.map do |inertia_meta_tag|
-      inertia_meta_tag.to_tag(tag)
-    end
+      meta_tags = meta_tag_data.map do |inertia_meta_tag|
+        inertia_meta_tag.to_tag(tag)
+      end
 
-    safe_join(meta_tags, "\n")
+      safe_join(meta_tags, "\n")
+    end
   end
 end

data/lib/inertia_rails/inertia_rails.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'inertia_rails/prop_mergeable'
 require 'inertia_rails/base_prop'
 require 'inertia_rails/ignore_on_first_load_prop'
 require 'inertia_rails/always_prop'
@@ -7,6 +8,7 @@ require 'inertia_rails/lazy_prop'
 require 'inertia_rails/optional_prop'
 require 'inertia_rails/defer_prop'
 require 'inertia_rails/merge_prop'
+require 'inertia_rails/scroll_prop'
 require 'inertia_rails/configuration'
 require 'inertia_rails/meta_tag'
 
@@ -34,8 +36,8 @@ module InertiaRails
       AlwaysProp.new(&block)
     end
 
-    def merge(match_on: nil, &block)
-      MergeProp.new(match_on: match_on, &block)
+    def merge(...)
+      MergeProp.new(...)
     end
 
     def deep_merge(match_on: nil, &block)
@@ -45,5 +47,9 @@ module InertiaRails
     def defer(group: nil, merge: nil, deep_merge: nil, match_on: nil, &block)
       DeferProp.new(group: group, merge: merge, deep_merge: deep_merge, match_on: match_on, &block)
     end
+
+    def scroll(metadata = nil, **options, &block)
+      ScrollProp.new(metadata: metadata, **options, &block)
+    end
   end
 end

data/lib/inertia_rails/lazy_prop.rb

@@ -10,7 +10,7 @@ module InertiaRails
       )
 
       @value = value
-      @block = block
+      super(&block)
     end
 
     def call(controller)

data/lib/inertia_rails/merge_prop.rb

@@ -2,20 +2,11 @@
 
 module InertiaRails
   class MergeProp < BaseProp
-    attr_reader :match_on
+    prepend PropMergeable
 
-    def initialize(deep_merge: false, match_on: nil, &block)
+    def initialize(**_props, &block)
       super(&block)
-      @deep_merge = deep_merge
-      @match_on = match_on.nil? ? nil : Array(match_on)
-    end
-
-    def merge?
-      true
-    end
-
-    def deep_merge?
-      @deep_merge
+      @merge = true
     end
   end
 end

data/lib/inertia_rails/prop_mergeable.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module InertiaRails
+  module PropMergeable
+    attr_reader :match_on, :appends_at_paths, :prepends_at_paths
+
+    def initialize(**props, &block)
+      raise ArgumentError, 'Cannot set both `deep_merge` and `merge` to true' if props[:deep_merge] && props[:merge]
+
+      @deep_merge = props.fetch(:deep_merge, false)
+      @merge = props[:merge] || @deep_merge
+      @match_on = props[:match_on].nil? ? nil : Array(props[:match_on])
+      @appends_at_paths = []
+      @prepends_at_paths = []
+      @append = true
+
+      append(props[:append]) if props.key?(:append)
+      prepend(props[:prepend]) if props.key?(:prepend)
+
+      super
+    end
+
+    def appends_at_root?
+      @append && merges_at_root?
+    end
+
+    def prepends_at_root?
+      !@append && merges_at_root?
+    end
+
+    def merges_at_root?
+      merge? && appends_at_paths.none? && prepends_at_paths.none?
+    end
+
+    def merge?
+      @merge
+    end
+
+    def deep_merge?
+      @deep_merge
+    end
+
+    private
+
+    def append(path, match_on: nil)
+      case path
+      when TrueClass, FalseClass
+        @append = path
+      when String
+        @appends_at_paths << path
+      when Array
+        @appends_at_paths += path
+      when Hash
+        @match_on ||= []
+        path.each do |key, value|
+          @appends_at_paths << key.to_s
+          @match_on << "#{key}.#{value}" if value
+        end
+      end
+
+      (@match_on ||= []) << "#{path}.#{match_on}" if match_on && path.is_a?(String)
+    end
+
+    def prepend(path, match_on: nil)
+      case path
+      when TrueClass, FalseClass
+        @append = !path
+      when String
+        @prepends_at_paths << path
+      when Array
+        @prepends_at_paths += path
+      when Hash
+        @match_on ||= []
+        path.each do |key, value|
+          @prepends_at_paths << key.to_s
+          @match_on << "#{key}.#{value}" if value
+        end
+      end
+
+      (@match_on ||= []) << "#{path}.#{match_on}" if match_on && path.is_a?(String)
+    end
+  end
+end

data/lib/inertia_rails/renderer.rb

@@ -90,14 +90,27 @@ module InertiaRails
     end
 
     def computed_props
-      merged_props = merge_props(shared_data, props)
-      deep_transform_props(merged_props).tap do |transformed_props|
-        transformed_props[:_inertia_meta] = meta_tags if meta_tags.present?
+      # rubocop:disable Style/MultilineBlockChain
+      merge_props(shared_data, props)
+        .then do |merged_props| # Always keep errors in the props
+          if merged_props.key?(:errors) && !merged_props[:errors].is_a?(BaseProp)
+            errors = merged_props[:errors]
+            merged_props[:errors] = InertiaRails.always { errors }
+          end
+          merged_props
+        end
+        .then { |props| deep_transform_props(props) } # Internal hydration/filtering
+        .then { |props| configuration.prop_transformer(props: props) } # Apply user-defined prop transformer
+        .tap do |props| # Add meta tags last (never transformed)
+        props[:_inertia_meta] = meta_tags if meta_tags.present?
       end
+      # rubocop:enable Style/MultilineBlockChain
     end
 
     def page
-      default_page = {
+      return @page if defined?(@page)
+
+      @page = {
         component: component,
         props: computed_props,
         url: @request.original_fullpath,
@@ -107,21 +120,11 @@ module InertiaRails
       }
 
       deferred_props = deferred_props_keys
-      default_page[:deferredProps] = deferred_props if deferred_props.present?
-
-      deep_merge_props, merge_props = all_merge_props.partition do |_key, prop|
-        prop.deep_merge?
-      end
+      @page[:deferredProps] = deferred_props if deferred_props.present?
+      @page[:scrollProps] = scroll_props if scroll_props.present?
+      @page.merge!(resolve_merge_props)
 
-      match_props_on = all_merge_props.filter_map do |key, prop|
-        prop.match_on.map { |ms| "#{key}.#{ms}" } if prop.match_on.present?
-      end.flatten
-
-      default_page[:mergeProps] = merge_props.map(&:first) if merge_props.present?
-      default_page[:deepMergeProps] = deep_merge_props.map(&:first) if deep_merge_props.present?
-      default_page[:matchPropsOn] = match_props_on if match_props_on.present?
-
-      default_page
+      @page
     end
 
     def deep_transform_props(props, parent_path = [])
@@ -153,10 +156,28 @@ module InertiaRails
       end
     end
 
-    def all_merge_props
-      @all_merge_props ||= @props.select do |key, prop|
+    def resolve_merge_props
+      deep_merge_props, merge_props = all_merge_props.partition do |_key, prop|
+        prop.deep_merge?
+      end
+
+      {
+        mergeProps: append_merge_props(merge_props),
+        prependProps: prepend_merge_props(merge_props),
+        deepMergeProps: deep_merge_props.map!(&:first),
+        matchPropsOn: resolve_match_on_props,
+      }.delete_if { |_, v| v.blank? }
+    end
+
+    def resolve_match_on_props
+      all_merge_props.filter_map do |key, prop|
+        prop.match_on.map! { |ms| "#{key}.#{ms}" } if prop.match_on.present?
+      end.flatten
+    end
+
+    def requested_merge_props
+      @requested_merge_props ||= @props.select do |key, prop|
         next unless prop.try(:merge?)
-        next if reset_keys.include?(key)
         next if rendering_partial_component? && (
           (partial_keys.present? && partial_keys.exclude?(key.name)) ||
             (partial_except_keys.present? && partial_except_keys.include?(key.name))
@@ -166,16 +187,64 @@ module InertiaRails
       end
     end
 
+    def append_merge_props(props)
+      return props if props.empty?
+
+      root_append_props, nested_append_props = props.partition { |_key, prop| prop.appends_at_root? }
+
+      result = Set.new(root_append_props.map!(&:first))
+
+      nested_append_props.each do |key, prop|
+        prop.appends_at_paths.each do |path|
+          result.add("#{key}.#{path}")
+        end
+      end
+
+      result.to_a
+    end
+
+    def prepend_merge_props(props)
+      return props if props.empty?
+
+      root_prepend_props, nested_prepend_props = props.partition { |_key, prop| prop.prepends_at_root? }
+
+      result = Set.new(root_prepend_props.map!(&:first))
+
+      nested_prepend_props.each do |key, prop|
+        prop.prepends_at_paths.each do |path|
+          result.add("#{key}.#{path}")
+        end
+      end
+
+      result.to_a
+    end
+
+    def scroll_props
+      return @scroll_props if defined?(@scroll_props)
+
+      @scroll_props = {}
+      requested_merge_props.each do |key, prop|
+        next unless prop.is_a?(ScrollProp)
+
+        @scroll_props[key] = prop.metadata.merge!(reset: reset_keys.include?(key))
+      end
+      @scroll_props
+    end
+
+    def all_merge_props
+      @all_merge_props ||= requested_merge_props.reject { |key,| reset_keys.include?(key) }
+    end
+
     def partial_keys
-      @partial_keys ||= (@request.headers['X-Inertia-Partial-Data'] || '').split(',').compact
+      @partial_keys ||= (@request.headers['X-Inertia-Partial-Data'] || '').split(',').compact_blank!
     end
 
     def reset_keys
-      (@request.headers['X-Inertia-Reset'] || '').split(',').compact.map(&:to_sym)
+      @reset_keys ||= (@request.headers['X-Inertia-Reset'] || '').split(',').compact_blank!.map!(&:to_sym)
     end
 
     def partial_except_keys
-      (@request.headers['X-Inertia-Partial-Except'] || '').split(',').compact
+      @partial_except_keys ||= (@request.headers['X-Inertia-Partial-Except'] || '').split(',').compact_blank!
     end
 
     def rendering_partial_component?

data/lib/inertia_rails/rspec.rb

@@ -1,30 +1,32 @@
-require "rspec/core"
-require "rspec/matchers"
+# frozen_string_literal: true
+
+require 'rspec/core'
+require 'rspec/matchers'
 
 module InertiaRails
   module RSpec
     class InertiaRenderWrapper
       attr_reader :view_data, :props, :component
-    
+
       def initialize
         @view_data = nil
         @props = nil
         @component = nil
       end
-    
+
       def call(params)
-        set_values(params)
+        assign_locals(params)
         @render_method&.call(params)
       end
-    
+
       def wrap_render(render_method)
         @render_method = render_method
         self
       end
-    
+
       protected
-    
-      def set_values(params)
+
+      def assign_locals(params)
         if params[:locals].present?
           @view_data = params[:locals].except(:page)
           @props = params[:locals][:page][:props]
@@ -33,18 +35,24 @@ module InertiaRails
           # Sequential Inertia request
           @view_data = {}
           json = JSON.parse(params[:json])
-          @props = json["props"]
-          @component = json["component"]
+          @props = json['props']
+          @component = json['component']
         end
       end
     end
 
     module Helpers
       def inertia
-        raise 'Inertia test helpers aren\'t set up! Make sure you add inertia: true to describe blocks using inertia tests.' unless inertia_tests_setup?
+        unless inertia_tests_setup?
+          raise "Inertia test helpers aren't set up! " \
+                'Make sure you add `inertia: true` to describe blocks using inertia tests.'
+        end
 
         if @_inertia_render_wrapper.nil? && !::RSpec.configuration.inertia[:skip_missing_renderer_warnings]
-          warn 'WARNING: the test never created an Inertia renderer. Maybe the code wasn\'t able to reach a `render inertia:` call? If this was intended, or you don\'t want to see this message, set ::RSpec.configuration.inertia[:skip_missing_renderer_warnings] = true'
+          warn 'WARNING: the test never created an Inertia renderer. ' \
+               "Maybe the code wasn't able to reach a `render inertia:` call? If this was intended, " \
+               "or you don't want to see this message, " \
+               'set ::RSpec.configuration.inertia[:skip_missing_renderer_warnings] = true'
         end
         @_inertia_render_wrapper
       end
@@ -57,8 +65,8 @@ module InertiaRails
         @_inertia_render_wrapper = InertiaRenderWrapper.new.wrap_render(render)
       end
 
-      protected 
-      
+      protected
+
       def inertia_tests_setup?
         ::RSpec.current_example.metadata.fetch(:inertia, false)
       end
@@ -67,9 +75,9 @@ module InertiaRails
 end
 
 RSpec.configure do |config|
-  config.include ::InertiaRails::RSpec::Helpers
+  config.include InertiaRails::RSpec::Helpers
   config.add_setting :inertia, default: {
-    skip_missing_renderer_warnings: false
+    skip_missing_renderer_warnings: false,
   }
 
   config.before(:each, inertia: true) do
@@ -106,13 +114,14 @@ RSpec::Matchers.define :render_component do |expected_component|
   end
 
   failure_message do |inertia|
-    "expected rendered inertia component to be #{expected_component}, instead received #{inertia.component || 'nothing'}"
+    "expected rendered inertia component to be #{expected_component}, " \
+      "instead received #{inertia.component || 'nothing'}"
   end
 end
 
 RSpec::Matchers.define :have_exact_view_data do |expected_view_data|
   match do |inertia|
-    expect(inertia.view_data).to eq expected_view_data    
+    expect(inertia.view_data).to eq expected_view_data
   end
 
   failure_message do |inertia|

data/lib/inertia_rails/scroll_metadata.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module InertiaRails
+  module ScrollMetadata
+    class MissingMetadataAdapterError < StandardError; end
+
+    class Props
+      def initialize(page_name:, previous_page:, next_page:, current_page:)
+        @page_name = page_name
+        @previous_page = previous_page
+        @next_page = next_page
+        @current_page = current_page
+      end
+
+      def as_json(_options = nil)
+        {
+          pageName: @page_name,
+          previousPage: @previous_page,
+          nextPage: @next_page,
+          currentPage: @current_page,
+        }
+      end
+    end
+
+    class KaminariAdapter
+      def match?(metadata)
+        defined?(Kaminari) && metadata.is_a?(Kaminari::PageScopeMethods)
+      end
+
+      def call(metadata, **_options)
+        {
+          page_name: (Kaminari.config.param_name || 'page').to_s,
+          previous_page: metadata.prev_page,
+          next_page: metadata.next_page,
+          current_page: metadata.current_page,
+        }
+      end
+    end
+
+    class PagyAdapter
+      def match?(metadata)
+        defined?(Pagy) && metadata.is_a?(Pagy)
+      end
+
+      def call(metadata, **_options)
+        page_name = metadata.respond_to?(:vars) ? metadata.vars.fetch(:page_param) : metadata.options[:page_key]
+        {
+          page_name: page_name.to_s,
+          previous_page: metadata.try(:prev) || metadata.try(:previous),
+          next_page: metadata.next,
+          current_page: metadata.page,
+        }
+      end
+    end
+
+    class HashAdapter
+      def match?(metadata)
+        metadata.is_a?(Hash)
+      end
+
+      def call(metadata, **_options)
+        {
+          page_name: metadata.fetch(:page_name),
+          previous_page: metadata.fetch(:previous_page),
+          next_page: metadata.fetch(:next_page),
+          current_page: metadata.fetch(:current_page),
+        }
+      end
+    end
+
+    class << self
+      attr_accessor :adapters
+
+      def extract(metadata, **options)
+        overrides = options.slice(:page_name, :previous_page, :next_page, :current_page)
+
+        adapters.each do |adapter|
+          next unless adapter.match?(metadata)
+
+          return Props.new(**adapter.call(metadata, **options).merge!(overrides)).as_json
+        end
+
+        begin
+          Props.new(**overrides).as_json
+        rescue ArgumentError
+          raise MissingMetadataAdapterError, "No ScrollMetadata adapter found for #{metadata}"
+        end
+      end
+
+      def register_adapter(adapter)
+        adapters.unshift(adapter.new)
+      end
+    end
+
+    self.adapters = [KaminariAdapter, PagyAdapter, HashAdapter].map(&:new)
+  end
+end

data/lib/inertia_rails/scroll_prop.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require_relative 'scroll_metadata'
+
+module InertiaRails
+  class ScrollProp < BaseProp
+    prepend PropMergeable
+
+    def initialize(**options, &block)
+      super(&block)
+
+      @merge = true
+      @metadata = options.delete(:metadata)
+      @wrapper = options.delete(:wrapper)
+
+      @options = options
+    end
+
+    def call(controller)
+      @value = super
+      configure_merge_intent(controller.request.headers['X-Inertia-Infinite-Scroll-Merge-Intent'])
+      @value
+    end
+
+    def metadata
+      ScrollMetadata.extract(@metadata, **@options)
+    end
+
+    private
+
+    def configure_merge_intent(scroll_intent)
+      scroll_intent == 'prepend' ? prepend(@wrapper || true) : append(@wrapper || true)
+    end
+  end
+end

data/lib/inertia_rails/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module InertiaRails
-  VERSION = "3.10.0"
+  VERSION = '3.12.0'
 end

data/lib/patches/better_errors.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Patch BetterErrors::Middleware to render HTML for Inertia requests
 #
 # Original source:
@@ -7,13 +9,11 @@
 module InertiaRails
   module InertiaBetterErrors
     def text?(env)
-      return false if env["HTTP_X_INERTIA"]
+      return false if env['HTTP_X_INERTIA']
 
       super
     end
   end
 end
 
-if defined?(BetterErrors)
-  BetterErrors::Middleware.include InertiaRails::InertiaBetterErrors
-end
+BetterErrors::Middleware.include InertiaRails::InertiaBetterErrors if defined?(BetterErrors)

data/lib/patches/debug_exceptions.rb

@@ -1,17 +1,34 @@
+# frozen_string_literal: true
+
 # Patch ActionDispatch::DebugExceptions to render HTML for Inertia requests
 #
-# Rails has introduced text rendering for XHR requests with Rails 4.1 and
-# changed the implementation in 4.2, 5.0 and 5.1 (unchanged since then).
-#
 # 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
+# https://github.com/rails/rails/blob/8-0-stable/actionpack/lib/action_dispatch/middleware/debug_exceptions.rb
+#
 
-if defined?(ActionDispatch::DebugExceptions)
-  if ActionPack.version.to_s >= '5.1'
-    require 'patches/debug_exceptions/patch-5-1'
-  elsif ActionPack.version.to_s >= '5.0'
-    require 'patches/debug_exceptions/patch-5-0'
-  else
-    # This gem supports Rails 5 or later
+module InertiaRails
+  module InertiaDebugExceptions
+    def render_for_browser_request(request, wrapper)
+      template = create_template(request, wrapper)
+      file = "rescues/#{wrapper.rescue_template}"
+
+      if request.xhr? && !request.headers['X-Inertia'] # <<<< this line is changed only
+        body = template.render(template: file, layout: false, formats: [:text])
+        format = 'text/plain'
+      else
+        body = template.render(template: file, layout: 'rescues/layout')
+        format = 'text/html'
+      end
+
+      render(wrapper.status_code, body, format)
+    end
   end
 end
+
+if defined?(ActionDispatch::DebugExceptions)
+  ActionDispatch::DebugExceptions.prepend InertiaRails::InertiaDebugExceptions
+end

data/lib/patches/mapper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module InertiaRails
   module InertiaMapper
     def inertia(*args, **options)
@@ -12,7 +14,10 @@ module InertiaRails
       if path.is_a?(Hash)
         path.first
       elsif resource_scope?
-        [path, InertiaRails.configuration.component_path_resolver(path: [@scope[:module], @scope[:controller]].compact.join('/'), action: path)]
+        [path,
+         InertiaRails.configuration.component_path_resolver(
+           path: [@scope[:module], @scope[:controller]].compact.join('/'), action: path
+         )]
       elsif @scope[:module].blank?
         [path, path]
       else

data/lib/patches/request.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module InertiaRails
   module InertiaRequest
     def inertia?

data/lib/tasks/inertia_rails.rake

@@ -1,16 +1,18 @@
+# frozen_string_literal: true
+
 namespace :inertia_rails do
   namespace :install do
-    desc "Installs inertia_rails packages and configurations for a React based app"
-    task :react => :environment do
+    desc 'Installs inertia_rails packages and configurations for a React based app'
+    task react: :environment do
       system 'rails g inertia_rails:install --front_end react'
     end
-    desc "Installs inertia_rails packages and configurations for a Vue based app"
+    desc 'Installs inertia_rails packages and configurations for a Vue based app'
     task vue: :environment do
       system 'rails g inertia_rails:install --front_end vue'
     end
-    desc "Installs inertia_rails packages and configurations for a Svelte based app"
+    desc 'Installs inertia_rails packages and configurations for a Svelte based app'
     task svelte: :environment do
       system 'rails g inertia_rails:install --front_end svelte'
     end
   end
-end
+end

metadata

@@ -1,16 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: inertia_rails
 version: !ruby/object:Gem::Version
-  version: 3.10.0
+  version: 3.12.0
 platform: ruby
 authors:
 - Brian Knoles
 - Brandon Shar
 - Eugene Granovsky
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-30 00:00:00.000000000 Z
+date: 2025-11-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -230,13 +229,14 @@ files:
 - lib/inertia_rails/meta_tag_builder.rb
 - lib/inertia_rails/middleware.rb
 - lib/inertia_rails/optional_prop.rb
+- lib/inertia_rails/prop_mergeable.rb
 - lib/inertia_rails/renderer.rb
 - lib/inertia_rails/rspec.rb
+- lib/inertia_rails/scroll_metadata.rb
+- lib/inertia_rails/scroll_prop.rb
 - lib/inertia_rails/version.rb
 - lib/patches/better_errors.rb
 - lib/patches/debug_exceptions.rb
-- lib/patches/debug_exceptions/patch-5-0.rb
-- lib/patches/debug_exceptions/patch-5-1.rb
 - lib/patches/mapper.rb
 - lib/patches/request.rb
 - lib/tasks/inertia_rails.rake
@@ -250,7 +250,6 @@ metadata:
   homepage_uri: https://github.com/inertiajs/inertia-rails
   source_code_uri: https://github.com/inertiajs/inertia-rails
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -265,8 +264,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Inertia.js adapter for Rails
 test_files: []

data/lib/patches/debug_exceptions/patch-5-0.rb

@@ -1,27 +0,0 @@
-# Patch ActionDispatch::DebugExceptions to render HTML for Inertia requests
-#
-# Original source:
-# https://github.com/rails/rails/blob/5-0-stable/actionpack/lib/action_dispatch/middleware/debug_exceptions.rb
-#
-
-module InertiaRails
-  module InertiaDebugExceptions
-    def render_for_default_application(request, wrapper)
-      template = create_template(request, wrapper)
-      file = "rescues/#{wrapper.rescue_template}"
-
-      if request.xhr? && !request.headers['X-Inertia'] # <<<< this line is changed only
-        body = template.render(template: file, layout: false, formats: [:text])
-        format = "text/plain"
-      else
-        body = template.render(template: file, layout: 'rescues/layout')
-        format = "text/html"
-      end
-      render(wrapper.status_code, body, format)
-    end
-  end
-end
-
-if defined?(ActionDispatch::DebugExceptions)
-  ActionDispatch::DebugExceptions.prepend InertiaRails::InertiaDebugExceptions
-end

data/lib/patches/debug_exceptions/patch-5-1.rb

@@ -1,30 +0,0 @@
-# Patch ActionDispatch::DebugExceptions to render HTML for Inertia requests
-#
-# Original source (unchanged since Rails 5.1):
-# https://github.com/rails/rails/blob/5-1-stable/actionpack/lib/action_dispatch/middleware/debug_exceptions.rb
-# https://github.com/rails/rails/blob/5-2-stable/actionpack/lib/action_dispatch/middleware/debug_exceptions.rb
-# https://github.com/rails/rails/blob/6-0-stable/actionpack/lib/action_dispatch/middleware/debug_exceptions.rb
-#
-
-module InertiaRails
-  module InertiaDebugExceptions
-    def render_for_browser_request(request, wrapper)
-      template = create_template(request, wrapper)
-      file = "rescues/#{wrapper.rescue_template}"
-
-      if request.xhr? && !request.headers['X-Inertia'] # <<<< this line is changed only
-        body = template.render(template: file, layout: false, formats: [:text])
-        format = "text/plain"
-      else
-        body = template.render(template: file, layout: "rescues/layout")
-        format = "text/html"
-      end
-
-      render(wrapper.status_code, body, format)
-    end
-  end
-end
-
-if defined?(ActionDispatch::DebugExceptions)
-  ActionDispatch::DebugExceptions.prepend InertiaRails::InertiaDebugExceptions
-end