view_component 4.12.0 → 4.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b2f1a7d34956fc9ae629c0f0e710f4a7335b33ebc99f1c3eccafc41d19713524
-  data.tar.gz: efd4bec7d2425da171f89f28fbc1bfaf9f2cba94fd0f2a9cbce674830281938e
+  metadata.gz: aaf81704d1bb151178b288ef446a657e2d8ac0158768ffee8db3c3e2c530aa29
+  data.tar.gz: 4e2192552574c18ff0dfc4613d797204abe98cd26b6343712c7edb7a4cba65bd
 SHA512:
-  metadata.gz: 5d0f5024d419a56b5e178f0cce3d77ac4a1ae2d4d3efc0ac5334e7b55a4dcb6cc7460aa4d60a47bce63918b0a452b53c5425297ef03da2ce074793407acef570
-  data.tar.gz: be1d649efec64995de234eb70998001d42cd9b0197bdce00ec5011d68cb2a2784925abf283b3f51c3986a55a446db3ba0c17cedf406c919e31b178ece2be6b51
+  metadata.gz: c06fd1d045b7c78a32cc66d1db448df80b1c2543d6cf9e44ab5bfa4e92c5cfe3d6151f80b24b345168e62dde6b8b400dfb7c28006716494b9e33366376f8cb9d
+  data.tar.gz: ddf8a61600fb66a0e2ae8ce4095e1d9398355ff2c5b19a16e79d8adeaff3da896dc4ecd948c4a13eaac8683df811fb0b578147486e7bfc609773f41532964466

data/docs/CHANGELOG.md

@@ -10,6 +10,52 @@ nav_order: 6
 
 ## main
 
+## 4.13.0
+
+* Add support for Turbo-streaming ViewComponents.
+
+    *Ben Sheldon*, *Joel Hawksley*
+
+* Reduce allocations and avoid redundant compiler work when rendering components and collections.
+
+    *Joel Hawksley*
+
+* Stabilize rendering allocation tests with explicit warmups and exact expectations by Rails and Ruby.
+
+    *Joel Hawksley*
+
+* Replace the custom memory allocation test helper with `minitest-memory`, preserving Ruby-version-specific allocation thresholds while improving failure diagnostics.
+
+    *Joel Hawksley*
+
+* Add zizmor security analysis for GitHub Actions workflows to CI.
+
+    *Joel Hawksley*
+
+* Remove the `$PROGRAM_NAME` version-printing line from `version.rb` so the file no longer reads a global variable (unshareable across Ractors). The version is still available via `ViewComponent::VERSION::STRING`.
+
+    *Joel Hawksley*
+
+* Fix intermittent template compilation failures where line-number offsets and annotation stripping were decided when a template object was created instead of when it was compiled, so later changes to coverage or annotation settings produced off-by-one backtraces or blank output.
+
+    *Joel Hawksley*
+
+* Freeze `ViewComponent::VERSION::STRING` so the version constant is immutable and Ractor-shareable.
+
+    *Joel Hawksley*
+
+* Add [audition](https://github.com/yaroslav/audition) Ractor-readiness checks to CI. Applied safe `.freeze` auto-fixes to string constants in `ViewComponent::Errors` and baselined existing findings so the gate fails only on new Ractor-isolation violations.
+
+    *Joel Hawksley*
+
+* Update link to GOV.UK Components library in resources list to govuk-components.x-govuk.org
+
+    *Peter Yates*
+
+* Fix `NoMethodError: undefined method 'template_handler_extensions'` when gathering sidecar templates on Rails main. Action View removed the `ActionView::Template.template_handler_extensions` method in newer versions; the compiler now reads the registered extensions through `ActionView::Template::Handlers.extensions`, which is the supported read-path API across all supported Rails versions (7.1+).
+
+    *Luiz Kowalski*
+
 ## 4.12.0
 
 * Fix stale render context on reused component instances. A `ViewComponent::Base` instance memoized its controller, helpers, request, view context, lookup context, view flow, and requested format details on first render via `||=`. Rendering the same instance a second time (intentionally or via aliasing) reused that stale context, which could leak data across requests, sessions, or users. `#render_in` now resets these ivars on every call so each render derives its context from the current view.

data/lib/view_component/active_job_serializer.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require "active_job/serializers"
+
+module ViewComponent
+  class ActiveJobSerializer < ActiveJob::Serializers::ObjectSerializer
+    def klass
+      ViewComponent::Serializable::Proxy
+    end
+
+    def serialize?(argument)
+      argument.is_a?(ViewComponent::Serializable::Proxy)
+    end
+
+    def serialize(proxy)
+      super(proxy.serialize)
+    end
+
+    def deserialize(hash)
+      ViewComponent::Serializable::Proxy.deserialize(hash)
+    end
+  end
+end

data/lib/view_component/base.rb

@@ -103,8 +103,8 @@ module ViewComponent
     # Returns HTML that has been escaped by the respective template handler.
     #
     # @return [String]
-    def render_in(view_context, **_, &block)
-      self.class.__vc_compile(raise_errors: true)
+    def render_in(view_context, **, &block)
+      self.class.__vc_compile(raise_errors: true) unless self.class.__vc_compiled?
 
       __vc_reset_render_state!
 
@@ -469,12 +469,14 @@ module ViewComponent
     # `@__vc_content_set_by_with_content`) is intentionally preserved because it
     # is populated by callers _before_ `render_in` runs (e.g. via `with_*`
     # slot setters or `with_content`).
+    RENDER_STATE_IVARS = %i[
+      @__vc_controller
+      @__vc_helpers
+      @__vc_request
+    ].freeze
+
     def __vc_reset_render_state!
-      %i[
-        @__vc_controller
-        @__vc_helpers
-        @__vc_request
-      ].each do |ivar|
+      RENDER_STATE_IVARS.each do |ivar|
         remove_instance_variable(ivar) if instance_variable_defined?(ivar)
       end
     end

data/lib/view_component/collection.rb

@@ -13,7 +13,7 @@ module ViewComponent
     delegate :size, to: :@collection
 
     def render_in(view_context, **_, &block)
-      rendered = components.map do |component|
+      rendered = components.map! do |component|
         component.render_in(view_context, &block)
       end
       safe_join(rendered, rendered_spacer(view_context))
@@ -63,11 +63,12 @@ module ViewComponent
     end
 
     def component_options(item, iterator)
-      item_options = {component.__vc_collection_parameter => item}
+      item_options = @options.dup
+      item_options[component.__vc_collection_parameter] = item
       item_options[component.__vc_collection_counter_parameter] = iterator.index if component.__vc_counter_argument_present?
       item_options[component.__vc_collection_iteration_parameter] = iterator.dup if component.__vc_iteration_argument_present?
 
-      @options.merge(item_options)
+      item_options
     end
 
     # Render the spacer through a fresh `dup` so a collection rendered multiple

data/lib/view_component/compiler.rb

@@ -115,11 +115,11 @@ module ViewComponent
           .tally
           .select { |_, count| count > 1 }
           .each do |tally|
-            variant, this_format = tally.first
+          variant, this_format = tally.first
 
-            variant_string = " for variant `#{variant}`" if variant.present?
+          variant_string = " for variant `#{variant}`" if variant.present?
 
-            errors << "More than one #{this_format.upcase} template found#{variant_string} for #{@component}. "
+          errors << "More than one #{this_format.upcase} template found#{variant_string} for #{@component}. "
         end
 
         default_template_types = @templates.each_with_object(Set.new) do |template, memo|
@@ -177,7 +177,7 @@ module ViewComponent
         else
           path_parser = ActionView::Resolver::PathParser.new
           templates = @component.sidecar_files(
-            ActionView::Template.template_handler_extensions
+            ActionView::Template::Handlers.extensions
           ).map do |path|
             details = path_parser.parse(path).details
             Template::File.new(component: @component, path: path, details: details)
@@ -190,11 +190,11 @@ module ViewComponent
           ).flat_map { |ancestor| ancestor.instance_methods(false).grep(/^call(_|$)/) }
             .uniq
             .each do |method_name|
-              templates << Template::InlineCall.new(
-                component: @component,
-                method_name: method_name,
-                defined_on_self: component_instance_methods_on_self.include?(method_name)
-              )
+            templates << Template::InlineCall.new(
+              component: @component,
+              method_name: method_name,
+              defined_on_self: component_instance_methods_on_self.include?(method_name)
+            )
           end
 
           templates

data/lib/view_component/engine.rb

@@ -77,6 +77,13 @@ module ViewComponent
       end
     end
 
+    initializer "view_component.serializable" do
+      ActiveSupport.on_load(:active_job) do
+        require "view_component/active_job_serializer"
+        ActiveJob::Serializers.add_serializers(ViewComponent::ActiveJobSerializer)
+      end
+    end
+
     initializer "view_component.eager_load_actions" do
       ActiveSupport.on_load(:after_initialize) do
         if Rails.application.config.eager_load

data/lib/view_component/errors.rb

@@ -9,7 +9,7 @@ module ViewComponent
     MESSAGE =
       "It looks like a block was provided after calling `with_content` on COMPONENT, " \
       "which means that ViewComponent doesn't know which content to use.\n\n" \
-      "To fix this issue, use either `with_content` or a block."
+      "To fix this issue, use either `with_content` or a block.".freeze
 
     def initialize(klass_name)
       super(MESSAGE.gsub("COMPONENT", klass_name.to_s))
@@ -25,13 +25,13 @@ module ViewComponent
   end
 
   class MultipleInlineTemplatesError < BaseError
-    MESSAGE = "Inline templates can only be defined once per-component."
+    MESSAGE = "Inline templates can only be defined once per-component.".freeze
   end
 
   class MissingPreviewTemplateError < StandardError
     MESSAGE =
       "A preview template for example EXAMPLE doesn't exist.\n\n" \
-      "To fix this issue, create a template for the example."
+      "To fix this issue, create a template for the example.".freeze
 
     def initialize(example)
       super(MESSAGE.gsub("EXAMPLE", example))
@@ -41,7 +41,7 @@ module ViewComponent
   class MissingTemplateError < StandardError
     MESSAGE =
       "No templates for COMPONENT match the request DETAIL.\n\n" \
-      "To fix this issue, provide a suitable template."
+      "To fix this issue, provide a suitable template.".freeze
 
     def initialize(component, request_detail)
       detail = {
@@ -58,7 +58,7 @@ module ViewComponent
     MESSAGE =
       "It looks like a block was provided after calling `with_content` on COMPONENT, " \
       "which means that ViewComponent doesn't know which content to use.\n\n" \
-      "To fix this issue, use either `with_content` or a block."
+      "To fix this issue, use either `with_content` or a block.".freeze
 
     def initialize(klass_name)
       super(MESSAGE.gsub("COMPONENT", klass_name.to_s))
@@ -70,7 +70,7 @@ module ViewComponent
       "The initializer for COMPONENT doesn't accept the parameter `PARAMETER`, " \
       "which is required to render it as a collection.\n\n" \
       "To fix this issue, update the initializer to accept `PARAMETER`.\n\n" \
-      "See [the collections docs](https://viewcomponent.org/guide/collections.html) for more information on rendering collections."
+      "See [the collections docs](https://viewcomponent.org/guide/collections.html) for more information on rendering collections.".freeze
 
     def initialize(klass_name, parameter)
       super(MESSAGE.gsub("COMPONENT", klass_name.to_s).gsub("PARAMETER", parameter.to_s))
@@ -80,7 +80,7 @@ module ViewComponent
   class ReservedParameterError < StandardError
     MESSAGE =
       "COMPONENT initializer can't accept the parameter `PARAMETER`, as it will override a " \
-      "public ViewComponent method. To fix this issue, rename the parameter."
+      "public ViewComponent method. To fix this issue, rename the parameter.".freeze
 
     def initialize(klass_name, parameter)
       super(MESSAGE.gsub("COMPONENT", klass_name.to_s).gsub("PARAMETER", parameter.to_s))
@@ -90,14 +90,14 @@ module ViewComponent
   class InvalidCollectionArgumentError < BaseError
     MESSAGE =
       "The value of the first argument passed to `with_collection` isn't a valid collection. " \
-      "Make sure it responds to `to_ary`."
+      "Make sure it responds to `to_ary`.".freeze
   end
 
   class ContentSlotNameError < StandardError
     MESSAGE =
       "COMPONENT declares a slot named content, which is a reserved word in ViewComponent.\n\n" \
       "Content passed to a ViewComponent as a block is captured and assigned to the `content` accessor without having to create an explicit slot.\n\n" \
-      "To fix this issue, either use the `content` accessor directly or choose a different slot name."
+      "To fix this issue, either use the `content` accessor directly or choose a different slot name.".freeze
 
     def initialize(klass_name)
       super(MESSAGE.gsub("COMPONENT", klass_name.to_s))
@@ -107,7 +107,7 @@ module ViewComponent
   class InvalidSlotDefinitionError < BaseError
     MESSAGE =
       "Invalid slot definition. Please pass a class, " \
-      "string, or callable (that is proc, lambda, etc)"
+      "string, or callable (that is proc, lambda, etc)".freeze
   end
 
   class InvalidSlotNameError < StandardError
@@ -118,7 +118,7 @@ module ViewComponent
       "COMPONENT declares a slot named SLOT_NAME, which ends with a question mark.\n\n" \
       "This isn't allowed because the ViewComponent framework already provides predicate " \
       "methods ending in `?`.\n\n" \
-      "To fix this issue, choose a different name."
+      "To fix this issue, choose a different name.".freeze
 
     def initialize(klass_name, slot_name)
       super(MESSAGE.gsub("COMPONENT", klass_name.to_s).gsub("SLOT_NAME", slot_name.to_s))
@@ -128,7 +128,7 @@ module ViewComponent
   class RedefinedSlotError < StandardError
     MESSAGE =
       "COMPONENT declares the SLOT_NAME slot multiple times.\n\n" \
-      "To fix this issue, choose a different slot name."
+      "To fix this issue, choose a different slot name.".freeze
 
     def initialize(klass_name, slot_name)
       super(MESSAGE.gsub("COMPONENT", klass_name.to_s).gsub("SLOT_NAME", slot_name.to_s))
@@ -138,7 +138,7 @@ module ViewComponent
   class ReservedSingularSlotNameError < InvalidSlotNameError
     MESSAGE =
       "COMPONENT declares a slot named SLOT_NAME, which is a reserved word in the ViewComponent framework.\n\n" \
-      "To fix this issue, choose a different name."
+      "To fix this issue, choose a different name.".freeze
 
     def initialize(klass_name, slot_name)
       super(MESSAGE.gsub("COMPONENT", klass_name.to_s).gsub("SLOT_NAME", slot_name.to_s))
@@ -148,7 +148,7 @@ module ViewComponent
   class ReservedPluralSlotNameError < InvalidSlotNameError
     MESSAGE =
       "COMPONENT declares a slot named SLOT_NAME, which is a reserved word in the ViewComponent framework.\n\n" \
-      "To fix this issue, choose a different name."
+      "To fix this issue, choose a different name.".freeze
 
     def initialize(klass_name, slot_name)
       super(MESSAGE.gsub("COMPONENT", klass_name.to_s).gsub("SLOT_NAME", slot_name.to_s))
@@ -158,7 +158,7 @@ module ViewComponent
   class UncountableSlotNameError < InvalidSlotNameError
     MESSAGE =
       "COMPONENT declares a slot named SLOT_NAME, which is an uncountable word\n\n" \
-      "To fix this issue, choose a different name."
+      "To fix this issue, choose a different name.".freeze
 
     def initialize(klass_name, slot_name)
       super(MESSAGE.gsub("COMPONENT", klass_name.to_s).gsub("SLOT_NAME", slot_name.to_s))
@@ -166,7 +166,7 @@ module ViewComponent
   end
 
   class ContentAlreadySetForPolymorphicSlotError < StandardError
-    MESSAGE = "Content for slot SLOT_NAME has already been provided."
+    MESSAGE = "Content for slot SLOT_NAME has already been provided.".freeze
 
     def initialize(slot_name)
       super(MESSAGE.gsub("SLOT_NAME", slot_name.to_s))
@@ -176,7 +176,7 @@ module ViewComponent
   class NilWithContentError < BaseError
     MESSAGE =
       "No content provided to `#with_content` for #{self}.\n\n" \
-      "To fix this issue, pass a value."
+      "To fix this issue, pass a value.".freeze
   end
 
   class TranslateCalledBeforeRenderError < BaseError
@@ -185,7 +185,7 @@ module ViewComponent
       "on the view context that only exists once a ViewComponent is passed to " \
       "the Rails render pipeline.\n\n" \
       "It's sometimes possible to fix this issue by moving code dependent on " \
-      "`#translate` to a [`#before_render` method](https://viewcomponent.org/api.html#before_render--void)."
+      "`#translate` to a [`#before_render` method](https://viewcomponent.org/api.html#before_render--void).".freeze
   end
 
   class HelpersCalledBeforeRenderError < BaseError
@@ -194,7 +194,7 @@ module ViewComponent
       "on the view context that only exists once a ViewComponent is passed to " \
       "the Rails render pipeline.\n\n" \
       "It's sometimes possible to fix this issue by moving code dependent on " \
-      "`#helpers` to a [`#before_render` method](https://viewcomponent.org/api.html#before_render--void)."
+      "`#helpers` to a [`#before_render` method](https://viewcomponent.org/api.html#before_render--void).".freeze
   end
 
   class ControllerCalledBeforeRenderError < BaseError
@@ -203,17 +203,17 @@ module ViewComponent
       "on the view context that only exists once a ViewComponent is passed to " \
       "the Rails render pipeline.\n\n" \
       "It's sometimes possible to fix this issue by moving code dependent on " \
-      "`#controller` to a [`#before_render` method](https://viewcomponent.org/api.html#before_render--void)."
+      "`#controller` to a [`#before_render` method](https://viewcomponent.org/api.html#before_render--void).".freeze
   end
 
   class SystemTestControllerNefariousPathError < BaseError
-    MESSAGE = "ViewComponent SystemTest controller attempted to load a file outside of the expected directory."
+    MESSAGE = "ViewComponent SystemTest controller attempted to load a file outside of the expected directory.".freeze
   end
 
   class AlreadyDefinedPolymorphicSlotSetterError < StandardError
     MESSAGE =
       "A method called 'SETTER_METHOD_NAME' already exists and would be overwritten by the 'SETTER_NAME' polymorphic " \
-      "slot setter.\n\nPlease choose a different setter name."
+      "slot setter.\n\nPlease choose a different setter name.".freeze
 
     def initialize(setter_method_name, setter_name)
       super(MESSAGE.gsub("SETTER_METHOD_NAME", setter_method_name.to_s).gsub("SETTER_NAME", setter_name.to_s))

data/lib/view_component/instrumentation.rb

@@ -8,7 +8,7 @@ module ViewComponent # :nodoc:
       mod.prepend(self) unless self <= ViewComponent::Instrumentation
     end
 
-    def render_in(view_context, **_, &block)
+    def render_in(...)
       return super if !Rails.application.config.view_component.instrumentation_enabled.present?
 
       payload = {

data/lib/view_component/request_details.rb

@@ -11,6 +11,8 @@ module ViewComponent
   # We're exposing it to the compiler via `refine` so that ViewComponent
   # can match Rails' template picking logic.
   module RequestDetails
+    EMPTY_DETAILS = {}.freeze
+
     refine ActionView::LookupContext do
       # Return an abstraction for matching and sorting available templates
       # based on the current lookup context details.
@@ -18,7 +20,7 @@ module ViewComponent
       # @return ActionView::TemplateDetails::Requested
       # @see ActionView::LookupContext#detail_args_for
       # @see ActionView::FileSystemResolver#_find_all
-      def vc_requested_details(user_details = {})
+      def vc_requested_details(user_details = EMPTY_DETAILS)
         # The hash `user_details` would normally be the standard arguments that
         # `render` accepts, but there's currently no mechanism for users to
         # provide these when calling render on a ViewComponent.

data/lib/view_component/serializable/proxy.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+module ViewComponent
+  module Serializable
+    # A proxy that wraps a component class and its initialization arguments, deferring
+    # component instantiation until render time. This allows slot calls and other
+    # post-initialize configuration to be captured and replayed, and enables the
+    # proxy itself (rather than a live component instance) to be serialized for
+    # background jobs (e.g. ActiveJob / Turbo Streams).
+    class Proxy
+      # Rebuilds a Proxy from a serialized hash produced by +serialize+
+      def self.deserialize(hash)
+        klass = hash["component_class"].safe_constantize
+        raise ArgumentError, "Cannot deserialize unknown component: #{hash["component_class"]}" unless klass
+
+        args = ActiveJob::Arguments.deserialize(hash["initialize_args"] || [])
+        proxy = new(klass, *args)
+
+        Array(hash["slot_calls"]).each do |call|
+          method_name = call["method"].to_sym
+          slot_args = ActiveJob::Arguments.deserialize(call["args"])
+          proxy.public_send(method_name, *slot_args)
+        end
+
+        proxy
+      end
+
+      attr_reader :component_class, :initialize_args, :slot_calls
+
+      def initialize(component_class, *args)
+        if component_class.name.nil?
+          raise UnserializableError, "Cannot serialize anonymous component class #{component_class.inspect}"
+        end
+
+        @component_class = component_class
+        @initialize_args = args
+        @slot_calls = []
+      end
+      ruby2_keywords :initialize
+
+      # Implements the Rails renderable interface
+      def render_in(view_context, &block)
+        if block
+          raise UnserializableError, "Cannot serialize render_in with a block"
+        end
+        build_component.render_in(view_context)
+      end
+
+      def method_missing(method_name, *args, &block)
+        if slot_method?(method_name)
+          capture_slot_call(method_name, args, &block)
+        else
+          super
+        end
+      end
+      ruby2_keywords :method_missing
+
+      def respond_to_missing?(method_name, include_private = false)
+        slot_method?(method_name) || super
+      end
+
+      # Returns a hash that can be rebuilt into a Proxy instance using +deserialize+
+      def serialize
+        serialized_slot_calls = @slot_calls.map do |call|
+          {
+            "method" => call[:method].to_s,
+            "args" => ActiveJob::Arguments.serialize(call[:args])
+          }
+        end
+
+        {
+          "component_class" => @component_class.name,
+          "initialize_args" => ActiveJob::Arguments.serialize(@initialize_args),
+          "slot_calls" => serialized_slot_calls
+        }
+      end
+
+      if defined?(Rails::VERSION) && Rails::VERSION::MAJOR == 7 && Rails::VERSION::MINOR == 1
+        # Rails expects us to define `format` on all renderables,
+        # but we do not know the `format` of a ViewComponent until runtime.
+        def format
+          nil
+        end
+      end
+
+      private
+
+      def slot_method?(method_name)
+        method_name.to_s.start_with?("with_") && @component_class.method_defined?(method_name)
+      end
+
+      def capture_slot_call(method_name, args, &block)
+        if block
+          raise UnserializableError, "Cannot serialize slot call '#{method_name}' with a block"
+        end
+
+        @slot_calls << {method: method_name, args: args}
+        self
+      end
+
+      def build_component
+        @component_class.new(*@initialize_args).tap do |instance|
+          @slot_calls.each do |call|
+            instance.public_send(call[:method], *call[:args])
+          end
+        end
+      end
+    end
+  end
+end

data/lib/view_component/serializable.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "active_support/concern"
+require "view_component/serializable/proxy"
+
+module ViewComponent
+  module Serializable
+    extend ActiveSupport::Concern
+
+    class UnserializableError < ArgumentError; end
+
+    class_methods do
+      # Returns a Proxy that captures this class and its initialization arguments,
+      # deferring instantiation until render time. The proxy is renderable and
+      # serializable for ActiveJob (e.g. Turbo Streams). Slot calls made on the
+      # proxy are captured and replayed at render time. Blocks are not supported.
+      #
+      #   MyComponent.render_later("title", size: :large).with_item(label: "One")
+      def render_later(*args, &block)
+        raise UnserializableError, "Cannot serialize render_later with a block" if block
+
+        ViewComponent::Serializable::Proxy.new(self, *args)
+      end
+      ruby2_keywords :render_later
+    end
+  end
+end

data/lib/view_component/template.rb

@@ -5,7 +5,7 @@ module ViewComponent
     DEFAULT_FORMAT = :html
     private_constant :DEFAULT_FORMAT
 
-    DataWithSource = Struct.new(:format, :identifier, :short_identifier, :type, keyword_init: true)
+    DataWithSource = Struct.new(:format, :identifier, :short_identifier, :type)
 
     attr_reader :details, :path
 
@@ -28,33 +28,7 @@ module ViewComponent
           details = ActionView::TemplateDetails.new(details.locale, details.handler, DEFAULT_FORMAT, details.variant)
         end
 
-        @strip_annotation_line = false
-
-        # Rails 8.1 added a newline to compiled ERB output (rails/rails#53731).
-        # Use -1 to compensate for correct line numbers in stack traces.
-        # However, negative line numbers cause segfaults when Ruby's coverage
-        # is enabled (bugs.ruby-lang.org/issues/19363). In that case, strip the
-        # annotation line from compiled source instead.
-        lineno =
-          if Rails::VERSION::MAJOR >= 8 && Rails::VERSION::MINOR > 0 && details.handler == :erb
-            if coverage_running?
-              # Can't use negative lineno with coverage (causes segfault on Linux).
-              # Strip annotation line if enabled to preserve correct line numbers.
-              @strip_annotation_line = ActionView::Base.annotate_rendered_view_with_filenames
-              0
-            else
-              -1
-            end
-          else
-            0
-          end
-
-        super(
-          component: component,
-          details: details,
-          path: path,
-          lineno: lineno
-        )
+        super
       end
 
       def type
@@ -68,11 +42,36 @@ module ViewComponent
 
       private
 
+      # Rails 8.1 added a newline to compiled ERB output (rails/rails#53731).
+      # Use -1 to compensate for correct line numbers in stack traces.
+      # However, negative line numbers cause segfaults when Ruby's coverage
+      # is enabled (bugs.ruby-lang.org/issues/19363). In that case, strip the
+      # annotation line from compiled source instead.
+      #
+      # Computed at compile time rather than at initialization because both
+      # coverage and annotation settings can change between the two.
+      def lineno
+        return 0 unless erb_newline_compensation_needed?
+
+        # Can't use negative lineno with coverage (causes segfault on Linux).
+        coverage_running? ? 0 : -1
+      end
+
+      # Strip the annotation line to maintain correct line numbers when coverage
+      # is running (avoids segfault from negative lineno)
+      def strip_annotation_line?
+        erb_newline_compensation_needed? &&
+          coverage_running? &&
+          ActionView::Base.annotate_rendered_view_with_filenames
+      end
+
+      def erb_newline_compensation_needed?
+        Rails::VERSION::MAJOR >= 8 && Rails::VERSION::MINOR > 0 && details.handler == :erb
+      end
+
       def compiled_source
         result = super
-        # Strip the annotation line to maintain correct line numbers when coverage
-        # is running (avoids segfault from negative lineno)
-        result = result.partition(";").last if @strip_annotation_line
+        result = result.partition(";").last if strip_annotation_line?
         result
       end
     end
@@ -147,7 +146,7 @@ module ViewComponent
       @component.silence_redefinition_of_method(call_method_name)
 
       # rubocop:disable Style/EvalWithLocation
-      @component.class_eval <<~RUBY, @path, @lineno
+      @component.class_eval <<~RUBY, @path, lineno
         def #{call_method_name}
           #{compiled_source}
         end
@@ -195,6 +194,8 @@ module ViewComponent
 
     private
 
+    attr_reader :lineno
+
     def compiled_source
       handler = details.handler_class
       this_source = source

data/lib/view_component/version.rb

@@ -3,12 +3,10 @@
 module ViewComponent
   module VERSION
     MAJOR = 4
-    MINOR = 12
+    MINOR = 13
     PATCH = 0
     PRE = nil
 
-    STRING = [MAJOR, MINOR, PATCH, PRE].compact.join(".")
+    STRING = [MAJOR, MINOR, PATCH, PRE].compact.join(".").freeze
   end
 end
-
-puts ViewComponent::VERSION::STRING if __FILE__ == $PROGRAM_NAME

data/lib/view_component.rb

@@ -15,6 +15,7 @@ module ViewComponent
   autoload :InlineTemplate
   autoload :Instrumentation
   autoload :Preview
+  autoload :Serializable
   autoload :Translatable
 
   if defined?(Rails.env) && Rails.env.test?

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: view_component
 version: !ruby/object:Gem::Version
-  version: 4.12.0
+  version: 4.13.0
 platform: ruby
 authors:
 - ViewComponent Team
@@ -89,6 +89,7 @@ files:
 - lib/generators/view_component/test_unit/templates/component_test.rb.tt
 - lib/generators/view_component/test_unit/test_unit_generator.rb
 - lib/view_component.rb
+- lib/view_component/active_job_serializer.rb
 - lib/view_component/base.rb
 - lib/view_component/collection.rb
 - lib/view_component/compile_cache.rb
@@ -102,6 +103,8 @@ files:
 - lib/view_component/instrumentation.rb
 - lib/view_component/preview.rb
 - lib/view_component/request_details.rb
+- lib/view_component/serializable.rb
+- lib/view_component/serializable/proxy.rb
 - lib/view_component/slot.rb
 - lib/view_component/slotable.rb
 - lib/view_component/system_spec_helpers.rb
@@ -135,7 +138,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.16
 specification_version: 4
 summary: A framework for building reusable, testable & encapsulated view components
   in Ruby on Rails.