inertia_rails 3.10.0 → 3.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8109050832c842cdc65c514f09a7ab02ce79a0925517fcb1f34eceee8d54130
-  data.tar.gz: 6ce4aaf2b8d4d2615f4e53220a23d712c97c482a2705c70a9423a1ce51b6d1ca
+  metadata.gz: 416af24e523dd32daacb768be83fc88bf5465a87adbf49e8105cb630409e45f9
+  data.tar.gz: 4c1d7c883d6ffc3e3239777bd1b1f400f5a0f69c22093a307225d696551b2da5
 SHA512:
-  metadata.gz: 32e92a9898314ff42c67450acc691513cc7e833eff2d15999bb4d4d642b62a7c1f94bcdff3093a79448f95adda2072d0d2e18d7250f9a8dfcb0a57cbcc3fa633
-  data.tar.gz: 147352323994ef1bc475aee16990581ba6714769ac157f144c5f1bb296b6058a4bcdf9d5f00fef47cfa26a488b91878aea1e046e7bb9b70e74cda4e8a61ef31c
+  metadata.gz: 23f7eeab79b5e54cc12408f6196f946f5cb5ea78086d55ac56d06827ea0243ba96c90e432e7c69583f7531ae7cd2611a026fdce15039219c36f7ef9034888fa6
+  data.tar.gz: c29f0e2d3c88ebc7a4cc6a405219152a3ae5f4428b23b8ec9a82de8e38e98a52c035d15389c51858b1a6534aae47adef1a26ebd179c4892c7a7b0b76427b88b0

data/CHANGELOG.md

@@ -4,6 +4,15 @@ 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.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,9 @@
 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/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/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

@@ -144,7 +144,22 @@ 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|
         if shared_data.respond_to?(:call)

data/lib/inertia_rails/renderer.rb

@@ -90,10 +90,20 @@ 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?
-      end
+      # 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 { |props| props[:_inertia_meta] = meta_tags if meta_tags.present? } # Add meta tags last (never transformed)
+
+      # rubocop:enable Style/MultilineBlockChain
     end
 
     def page

data/lib/inertia_rails/version.rb

@@ -1,3 +1,3 @@
 module InertiaRails
-  VERSION = "3.10.0"
+  VERSION = "3.11.0"
 end

metadata

@@ -1,16 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: inertia_rails
 version: !ruby/object:Gem::Version
-  version: 3.10.0
+  version: 3.11.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-08-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -250,7 +249,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 +263,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: []