inertia_rails 3.9.0 → 3.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b7d385cab4b5bdd84cc50c1c9e22d838ce8f77fc680542ba1b0a11d17c95674
-  data.tar.gz: 472113f1732205c105f10a069070fb1c6b226ffdf176e57fb15fc66cf7a0bdd2
+  metadata.gz: a8109050832c842cdc65c514f09a7ab02ce79a0925517fcb1f34eceee8d54130
+  data.tar.gz: 6ce4aaf2b8d4d2615f4e53220a23d712c97c482a2705c70a9423a1ce51b6d1ca
 SHA512:
-  metadata.gz: b18d7f00080810908560268ad97da13079b3c89d7fee8aee3b4edcb45d011aae7d16fdff8f9697b953fa7e4e76034eb9d9e9afa1cf79ca6f946cb7810222b83e
-  data.tar.gz: 80805ac8753cdc1469de52a6f92fceb186e735070d1cc81b44ce93fc62218bea6fc7e515a2950a06f5fb1951aaa6dc2fc6fd40c6b958e5b453be6a2470c3103d
+  metadata.gz: 32e92a9898314ff42c67450acc691513cc7e833eff2d15999bb4d4d642b62a7c1f94bcdff3093a79448f95adda2072d0d2e18d7250f9a8dfcb0a57cbcc3fa633
+  data.tar.gz: 147352323994ef1bc475aee16990581ba6714769ac157f144c5f1bb296b6058a4bcdf9d5f00fef47cfa26a488b91878aea1e046e7bb9b70e74cda4e8a61ef31c

data/CHANGELOG.md

@@ -4,6 +4,12 @@ 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.10.0] - 2025-07-30
+
+* llms.txt in docs (@brandonshar and @skryukov)
+* Add support for deep merging merge props (@skryukov)
+* Server managed meta tags (@bknoles and @skryukov)
+
 ## [3.9.0] - 2025-06-18
 
 * Docs updates

data/lib/inertia_rails/controller.rb

@@ -1,6 +1,7 @@
 require_relative "inertia_rails"
 require_relative "helper"
 require_relative "action_filter"
+require_relative "meta_tag_builder"
 
 module InertiaRails
   module Controller
@@ -127,6 +128,10 @@ module InertiaRails
       super
     end
 
+    def inertia_meta
+      @inertia_meta ||= InertiaRails::MetaTagBuilder.new(self)
+    end
+
     private
 
     def inertia_view_assigns

data/lib/inertia_rails/defer_prop.rb

@@ -4,9 +4,9 @@ module InertiaRails
   class DeferProp < IgnoreOnFirstLoadProp
     DEFAULT_GROUP = 'default'
 
-    attr_reader :group
+    attr_reader :group, :match_on
 
-    def initialize(group: nil, merge: nil, deep_merge: nil, &block)
+    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
 
       super(&block)
@@ -14,6 +14,7 @@ module InertiaRails
       @group = group || DEFAULT_GROUP
       @merge = merge || deep_merge
       @deep_merge = deep_merge
+      @match_on = match_on.nil? ? nil : Array(match_on)
     end
 
     def merge?

data/lib/inertia_rails/generators/controller_template_base.rb

@@ -7,11 +7,12 @@ module InertiaRails
   module Generators
     class ControllerTemplateBase < Rails::Generators::NamedBase
       include Helper
+
       class_option :frontend_framework, required: true, desc: 'Frontend framework to generate the views for.',
                                         default: Helper.guess_the_default_framework
 
       class_option :typescript, type: :boolean, desc: 'Whether to use TypeScript',
-                                default: Helper.guess_typescript
+                                default: Helper.uses_typescript?
 
       argument :actions, type: :array, default: [], banner: 'action action'
 

data/lib/inertia_rails/generators/helper.rb

@@ -23,7 +23,7 @@ module InertiaRails
           end
         end
 
-        def guess_typescript
+        def uses_typescript?
           Rails.root.join('tsconfig.json').exist?
         end
 

data/lib/inertia_rails/helper.rb

@@ -15,4 +15,18 @@ module InertiaRails::Helper
   def inertia_rendering?
     controller.instance_variable_get("@_inertia_rendering")
   end
+
+  def inertia_page
+    controller.instance_variable_get("@_inertia_page")
+  end
+
+  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
+
+    safe_join(meta_tags, "\n")
+  end
 end

data/lib/inertia_rails/inertia_rails.rb

@@ -8,6 +8,7 @@ require 'inertia_rails/optional_prop'
 require 'inertia_rails/defer_prop'
 require 'inertia_rails/merge_prop'
 require 'inertia_rails/configuration'
+require 'inertia_rails/meta_tag'
 
 module InertiaRails
   class << self
@@ -33,16 +34,16 @@ module InertiaRails
       AlwaysProp.new(&block)
     end
 
-    def merge(&block)
-      MergeProp.new(&block)
+    def merge(match_on: nil, &block)
+      MergeProp.new(match_on: match_on, &block)
     end
 
-    def deep_merge(&block)
-      MergeProp.new(deep_merge: true, &block)
+    def deep_merge(match_on: nil, &block)
+      MergeProp.new(deep_merge: true, match_on: match_on, &block)
     end
 
-    def defer(group: nil, merge: nil, deep_merge: nil, &block)
-      DeferProp.new(group: group, merge: merge, deep_merge: deep_merge, &block)
+    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
   end
 end

data/lib/inertia_rails/merge_prop.rb

@@ -2,9 +2,12 @@
 
 module InertiaRails
   class MergeProp < BaseProp
-    def initialize(deep_merge: false, &block)
+    attr_reader :match_on
+
+    def initialize(deep_merge: false, match_on: nil, &block)
       super(&block)
       @deep_merge = deep_merge
+      @match_on = match_on.nil? ? nil : Array(match_on)
     end
 
     def merge?

data/lib/inertia_rails/meta_tag.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+
+module InertiaRails
+  class MetaTag
+    # See https://github.com/rails/rails/blob/v8.0.0/actionview/lib/action_view/helpers/tag_helper.rb#L84-L97
+    UNARY_TAGS = %i[
+      area base br col embed hr img input keygen link meta source track wbr
+    ].freeze
+
+    LD_JSON_TYPE = 'application/ld+json'
+    DEFAULT_SCRIPT_TYPE = 'text/plain'
+
+    GENERATABLE_HEAD_KEY_PROPERTIES = %i[name property http_equiv].freeze
+
+    def initialize(tag_name: nil, head_key: nil, allow_duplicates: false, type: nil, **tag_data)
+      if shortened_title_tag?(tag_name, tag_data)
+        @tag_name = :title
+        @tag_data = { inner_content: tag_data[:title] }
+      else
+        @tag_name = tag_name.nil? ? :meta : tag_name.to_sym
+        @tag_data = tag_data.symbolize_keys
+      end
+      @tag_type = determine_tag_type(type)
+      @allow_duplicates = allow_duplicates
+      @head_key = @tag_name == :title ? 'title' : (head_key || generate_head_key)
+    end
+
+    def as_json(_options = nil)
+      {
+        tagName: @tag_name,
+        headKey: @head_key,
+        type: @tag_type,
+      }.tap do |result|
+        result.merge!(@tag_data.transform_keys { |k| k.to_s.camelize(:lower).to_sym })
+        result.compact_blank!
+      end
+    end
+
+    def to_tag(tag_helper)
+      data = @tag_data.merge(type: @tag_type, inertia: @head_key)
+
+      inner_content =
+        if @tag_name == :script
+          tag_script_inner_content(data.delete(:inner_content))
+        else
+          data.delete(:inner_content)
+        end
+
+      if UNARY_TAGS.include? @tag_name
+        tag_helper.public_send(@tag_name, **data.transform_keys { |k| k.to_s.tr('_', '-').to_sym })
+      else
+        tag_helper.public_send(@tag_name, inner_content, **data.transform_keys { |k| k.to_s.tr('_', '-').to_sym })
+      end
+    end
+
+    def [](key)
+      key = key.to_sym
+      return @tag_name if key == :tag_name
+      return @head_key if key == :head_key
+      return @tag_type if key == :type
+
+      @tag_data[key]
+    end
+
+    private
+
+    def tag_script_inner_content(content)
+      case content
+      when Hash, Array
+        ERB::Util.json_escape(content.to_json).html_safe
+      else
+        content
+      end
+    end
+
+    def shortened_title_tag?(tag_name, tag_data)
+      tag_name.nil? && tag_data.keys == [:title]
+    end
+
+    def determine_tag_type(type)
+      return type unless @tag_name == :script
+
+      type == LD_JSON_TYPE ? LD_JSON_TYPE : DEFAULT_SCRIPT_TYPE
+    end
+
+    def generate_head_key
+      generate_meta_head_key || "#{@tag_name}-#{tag_digest}"
+    end
+
+    def tag_digest
+      signature = @tag_data.sort.map { |k, v| "#{k}=#{v}" }.join('&')
+      Digest::MD5.hexdigest(signature)[0, 8]
+    end
+
+    def generate_meta_head_key
+      return unless @tag_name == :meta
+      return 'meta-charset' if @tag_data.key?(:charset)
+
+      GENERATABLE_HEAD_KEY_PROPERTIES.each do |key|
+        next unless @tag_data.key?(key)
+
+        return [
+          'meta',
+          key,
+          @tag_data[key].parameterize,
+          @allow_duplicates ? tag_digest : nil
+        ].compact.join('-')
+      end
+
+      nil
+    end
+  end
+end

data/lib/inertia_rails/meta_tag_builder.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module InertiaRails
+  class MetaTagBuilder
+    def initialize(controller)
+      @controller = controller
+      @meta_tags = {}
+    end
+
+    def meta_tags
+      @meta_tags.values
+    end
+
+    def add(meta_tag)
+      if meta_tag.is_a?(Array)
+        meta_tag.each { |tag| add(tag) }
+      elsif meta_tag.is_a?(Hash)
+        add_new_tag(meta_tag)
+      else
+        raise ArgumentError, 'Meta tag must be a Hash or Array of Hashes'
+      end
+
+      self
+    end
+
+    def remove(head_key = nil, &block)
+      raise ArgumentError, 'Cannot provide both head_key and a block' if head_key && block_given?
+      raise ArgumentError, 'Must provide either head_key or a block' if head_key.nil? && !block_given?
+
+      if head_key
+        @meta_tags.delete(head_key)
+      else
+        @meta_tags.reject! { |_, tag| block.call(tag) }
+      end
+
+      self
+    end
+
+    def clear
+      @meta_tags.clear
+
+      self
+    end
+
+    private
+
+    def add_new_tag(new_tag_data)
+      new_tag = InertiaRails::MetaTag.new(**new_tag_data)
+      @meta_tags[new_tag[:head_key]] = new_tag
+    end
+  end
+end

data/lib/inertia_rails/renderer.rb

@@ -16,9 +16,8 @@ module InertiaRails
       :clear_history
     )
 
-    def initialize(component, controller, request, response, render_method, props: nil, view_data: nil,
-                   deep_merge: nil, encrypt_history: nil, clear_history: nil)
-      if component.is_a?(Hash) && !props.nil?
+    def initialize(component, controller, request, response, render_method, **options)
+      if component.is_a?(Hash) && options.key?(:props)
         raise ArgumentError,
               'Parameter `props` is not allowed when passing a Hash as the first argument'
       end
@@ -29,12 +28,13 @@ module InertiaRails
       @request = request
       @response = response
       @render_method = render_method
-      @props = props || (component.is_a?(Hash) ? component : controller.__send__(:inertia_view_assigns))
-      @view_data = view_data || {}
-      @deep_merge = deep_merge.nil? ? configuration.deep_merge_shared_data : deep_merge
-      @encrypt_history = encrypt_history.nil? ? configuration.encrypt_history : encrypt_history
-      @clear_history = clear_history || controller.session[:inertia_clear_history] || false
+      @props = options.fetch(:props, component.is_a?(Hash) ? component : controller.__send__(:inertia_view_assigns))
+      @view_data = options.fetch(:view_data, {})
+      @deep_merge = options.fetch(:deep_merge, configuration.deep_merge_shared_data)
+      @encrypt_history = options.fetch(:encrypt_history, configuration.encrypt_history)
+      @clear_history = options.fetch(:clear_history, controller.session[:inertia_clear_history] || false)
       @controller.instance_variable_set('@_inertia_rendering', true)
+      controller.inertia_meta.add(options[:meta]) if options[:meta]
     end
 
     def render
@@ -52,6 +52,7 @@ module InertiaRails
         rescue StandardError
           nil
         end
+        controller.instance_variable_set('@_inertia_page', page)
         @render_method.call template: 'inertia', layout: layout, locals: view_data.merge(page: page)
       end
     end
@@ -90,7 +91,9 @@ module InertiaRails
 
     def computed_props
       merged_props = merge_props(shared_data, props)
-      deep_transform_props(merged_props)
+      deep_transform_props(merged_props).tap do |transformed_props|
+        transformed_props[:_inertia_meta] = meta_tags if meta_tags.present?
+      end
     end
 
     def page
@@ -106,14 +109,17 @@ module InertiaRails
       deferred_props = deferred_props_keys
       default_page[:deferredProps] = deferred_props if deferred_props.present?
 
-      all_merge_props = merge_props_keys
-
-      deep_merge_props, merge_props = all_merge_props.partition do |key|
-        @props[key].deep_merge?
+      deep_merge_props, merge_props = all_merge_props.partition do |_key, prop|
+        prop.deep_merge?
       end
 
-      default_page[:mergeProps] = merge_props if merge_props.present?
-      default_page[:deepMergeProps] = deep_merge_props if deep_merge_props.present?
+      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
     end
@@ -147,9 +153,16 @@ module InertiaRails
       end
     end
 
-    def merge_props_keys
-      @props.each_with_object([]) do |(key, prop), result|
-        result << key if prop.try(:merge?) && reset_keys.exclude?(key)
+    def all_merge_props
+      @all_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))
+        )
+
+        true
       end
     end
 
@@ -180,7 +193,7 @@ module InertiaRails
     def keep_prop?(prop, path)
       return true if prop.is_a?(AlwaysProp)
 
-      if rendering_partial_component?
+      if rendering_partial_component? && (partial_keys.present? || partial_except_keys.present?)
         path_with_prefixes = path_prefixes(path)
         return false if excluded_by_only_partial_keys?(path_with_prefixes)
         return false if excluded_by_except_partial_keys?(path_with_prefixes)
@@ -205,5 +218,9 @@ module InertiaRails
     def excluded_by_except_partial_keys?(path_with_prefixes)
       partial_except_keys.present? && (path_with_prefixes & partial_except_keys).any?
     end
+
+    def meta_tags
+      controller.inertia_meta.meta_tags
+    end
   end
 end

data/lib/inertia_rails/rspec.rb

@@ -75,7 +75,7 @@ RSpec.configure do |config|
   config.before(:each, inertia: true) do
     new_renderer = InertiaRails::Renderer.method(:new)
     allow(InertiaRails::Renderer).to receive(:new) do |component, controller, request, response, render, named_args|
-      new_renderer.call(component, controller, request, response, inertia_wrap_render(render), **named_args)
+      new_renderer.call(component, controller, request, response, inertia_wrap_render(render), **(named_args || {}))
     end
   end
 end

data/lib/inertia_rails/version.rb

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

data/lib/inertia_rails.rb

@@ -15,11 +15,7 @@ ActionController::Renderers.add :inertia do |component, options|
     request,
     response,
     method(:render),
-    props: options[:props],
-    view_data: options[:view_data],
-    deep_merge: options[:deep_merge],
-    encrypt_history: options[:encrypt_history],
-    clear_history: options[:clear_history]
+    **options
   ).render
 end
 

metadata

@@ -1,15 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: inertia_rails
 version: !ruby/object:Gem::Version
-  version: 3.9.0
+  version: 3.10.0
 platform: ruby
 authors:
 - Brian Knoles
 - Brandon Shar
 - Eugene Granovsky
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-06-18 00:00:00.000000000 Z
+date: 2025-07-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -225,6 +226,8 @@ files:
 - lib/inertia_rails/inertia_rails.rb
 - lib/inertia_rails/lazy_prop.rb
 - lib/inertia_rails/merge_prop.rb
+- lib/inertia_rails/meta_tag.rb
+- lib/inertia_rails/meta_tag_builder.rb
 - lib/inertia_rails/middleware.rb
 - lib/inertia_rails/optional_prop.rb
 - lib/inertia_rails/renderer.rb
@@ -247,6 +250,7 @@ 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
@@ -261,7 +265,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Inertia.js adapter for Rails
 test_files: []