view_component 2.49.1 → 3.23.2

data/lib/view_component/content_areas.rb

@@ -1,57 +0,0 @@
-# frozen_string_literal: true
-
-require "active_support/concern"
-
-require "view_component/slot"
-
-# DEPRECATED - ContentAreas is deprecated and will be removed in v3.0.0
-module ViewComponent
-  module ContentAreas
-    extend ActiveSupport::Concern
-
-    # Assign the provided content to the content area accessor
-    #
-    # @private
-    def with(area, content = nil, &block)
-      unless content_areas.include?(area)
-        raise ArgumentError.new(
-          "Unknown content_area '#{area}' for #{self} - expected one of '#{content_areas}'.\n\n" \
-          "To fix this issue, add `with_content_area :#{area}` to #{self} or reference " \
-          "a valid content area."
-        )
-      end
-
-      if block_given?
-        content = view_context.capture(&block)
-      end
-
-      instance_variable_set("@#{area}".to_sym, content)
-      nil
-    end
-
-    class_methods do
-      def with_content_areas(*areas)
-        ActiveSupport::Deprecation.warn(
-          "`with_content_areas` is deprecated and will be removed in ViewComponent v3.0.0.\n\n" \
-          "Use slots (https://viewcomponent.org/guide/slots.html) instead."
-        )
-
-        if areas.include?(:content)
-          raise ArgumentError.new(
-            "#{self} defines a content area called :content, which is a reserved name. \n\n" \
-            "To fix this issue, use another name, such as `:body`."
-          )
-        end
-
-        areas.each do |area|
-          define_method area.to_sym do
-            content unless content_evaluated? # ensure content is loaded so content_areas will be defined
-            instance_variable_get(:"@#{area}") if instance_variable_defined?(:"@#{area}")
-          end
-        end
-
-        self.content_areas = areas
-      end
-    end
-  end
-end

data/lib/view_component/polymorphic_slots.rb

@@ -1,73 +0,0 @@
-# frozen_string_literal: true
-
-module ViewComponent
-  module PolymorphicSlots
-    # In older rails versions, using a concern isn't a good idea here because they appear to not work with
-    # Module#prepend and class methods.
-    def self.included(base)
-      base.singleton_class.prepend(ClassMethods)
-      base.include(InstanceMethods)
-    end
-
-    module ClassMethods
-      def renders_one(slot_name, callable = nil)
-        return super unless callable.is_a?(Hash) && callable.key?(:types)
-
-        validate_singular_slot_name(slot_name)
-        register_polymorphic_slot(slot_name, callable[:types], collection: false)
-      end
-
-      def renders_many(slot_name, callable = nil)
-        return super unless callable.is_a?(Hash) && callable.key?(:types)
-
-        validate_plural_slot_name(slot_name)
-        register_polymorphic_slot(slot_name, callable[:types], collection: true)
-      end
-
-      def register_polymorphic_slot(slot_name, types, collection:)
-        renderable_hash = types.each_with_object({}) do |(poly_type, poly_callable), memo|
-          memo[poly_type] = define_slot(
-            "#{slot_name}_#{poly_type}", collection: collection, callable: poly_callable
-          )
-
-          getter_name = slot_name
-          setter_name =
-            if collection
-              "#{ActiveSupport::Inflector.singularize(slot_name)}_#{poly_type}"
-            else
-              "#{slot_name}_#{poly_type}"
-            end
-
-          define_method(getter_name) do
-            get_slot(slot_name)
-          end
-
-          define_method(setter_name) do |*args, &block|
-            set_polymorphic_slot(slot_name, poly_type, *args, &block)
-          end
-          ruby2_keywords(setter_name.to_sym) if respond_to?(:ruby2_keywords, true)
-        end
-
-        self.registered_slots[slot_name] = {
-          collection: collection,
-          renderable_hash: renderable_hash
-        }
-      end
-    end
-
-    module InstanceMethods
-      def set_polymorphic_slot(slot_name, poly_type = nil, *args, &block)
-        slot_definition = self.class.registered_slots[slot_name]
-
-        if !slot_definition[:collection] && get_slot(slot_name)
-          raise ArgumentError, "content for slot '#{slot_name}' has already been provided"
-        end
-
-        poly_def = slot_definition[:renderable_hash][poly_type]
-
-        set_slot(slot_name, poly_def, *args, &block)
-      end
-      ruby2_keywords(:set_polymorphic_slot) if respond_to?(:ruby2_keywords, true)
-    end
-  end
-end

data/lib/view_component/preview_template_error.rb

@@ -1,6 +0,0 @@
-# frozen_string_literal: true
-
-module ViewComponent
-  class PreviewTemplateError < StandardError
-  end
-end

data/lib/view_component/previewable.rb

@@ -1,62 +0,0 @@
-# frozen_string_literal: true
-
-require "active_support/concern"
-
-module ViewComponent
-  module Previewable
-    extend ActiveSupport::Concern
-
-    included do
-      # Enable or disable component previews:
-      #
-      #     config.view_component.show_previews = true
-      #
-      # Defaults to `true` in development.
-      #
-      mattr_accessor :show_previews, instance_writer: false
-
-      # Enable or disable source code previews in component previews:
-      #
-      #     config.view_component.show_previews_source = true
-      #
-      # Defaults to `false`.
-      #
-      mattr_accessor :show_previews_source, instance_writer: false, default: false
-
-      # Set a custom default layout used for preview index and individual previews:
-      #
-      #     config.view_component.default_preview_layout = "component_preview"
-      #
-      mattr_accessor :default_preview_layout, instance_writer: false
-
-      # Set the location of component previews:
-      #
-      #     config.view_component.preview_paths << "#{Rails.root}/lib/component_previews"
-      #
-      mattr_accessor :preview_paths, instance_writer: false
-
-      # @deprecated Use `preview_paths` instead. Will be removed in v3.0.0.
-      mattr_accessor :preview_path, instance_writer: false
-
-      # Set the entry route for component previews:
-      #
-      #     config.view_component.preview_route = "/previews"
-      #
-      # Defaults to `/rails/view_components` when `show_previews` is enabled.
-      #
-      mattr_accessor :preview_route, instance_writer: false do
-        "/rails/view_components"
-      end
-
-      # Set the controller used for previewing components:
-      #
-      #     config.view_component.preview_controller = "MyPreviewController"
-      #
-      # Defaults to `ViewComponentsController`.
-      #
-      mattr_accessor :preview_controller, instance_writer: false do
-        "ViewComponentsController"
-      end
-    end
-  end
-end

data/lib/view_component/slot_v2.rb

@@ -1,104 +0,0 @@
-# frozen_string_literal: true
-
-require "view_component/with_content_helper"
-
-module ViewComponent
-  class SlotV2
-    include ViewComponent::WithContentHelper
-
-    attr_writer :__vc_component_instance, :__vc_content_block, :__vc_content
-
-    def initialize(parent)
-      @parent = parent
-    end
-
-    # Used to render the slot content in the template
-    #
-    # There's currently 3 different values that may be set, that we can render.
-    #
-    # If the slot renderable is a component, the string class name of a
-    # component, or a function that returns a component, we render that
-    # component instance, returning the string.
-    #
-    # If the slot renderable is a function and returns a string, it's
-    # set as `@__vc_content` and is returned directly.
-    #
-    # If there is no slot renderable, we evaluate the block passed to
-    # the slot and return it.
-    def to_s
-      return @content if defined?(@content)
-
-      view_context = @parent.send(:view_context)
-
-      if defined?(@__vc_content_block) && defined?(@__vc_content_set_by_with_content)
-        raise ArgumentError.new(
-          "It looks like a block was provided after calling `with_content` on #{self.class.name}, " \
-          "which means that ViewComponent doesn't know which content to use.\n\n" \
-          "To fix this issue, use either `with_content` or a block."
-        )
-      end
-
-      @content =
-        if defined?(@__vc_component_instance)
-          @__vc_component_instance.__vc_original_view_context = @parent.__vc_original_view_context
-
-          if defined?(@__vc_content_set_by_with_content)
-            @__vc_component_instance.with_content(@__vc_content_set_by_with_content)
-
-            view_context.capture do
-              @__vc_component_instance.render_in(view_context)
-            end
-          elsif defined?(@__vc_content_block)
-            view_context.capture do
-              # render_in is faster than `parent.render`
-              @__vc_component_instance.render_in(view_context, &@__vc_content_block)
-            end
-          else
-            view_context.capture do
-              @__vc_component_instance.render_in(view_context)
-            end
-          end
-        elsif defined?(@__vc_content)
-          @__vc_content
-        elsif defined?(@__vc_content_block)
-          view_context.capture(&@__vc_content_block)
-        elsif defined?(@__vc_content_set_by_with_content)
-          @__vc_content_set_by_with_content
-        end
-
-      @content = @content.to_s
-    end
-
-    # Allow access to public component methods via the wrapper
-    #
-    # for example
-    #
-    # calling `header.name` (where `header` is a slot) will call `name`
-    # on the `HeaderComponent` instance.
-    #
-    # Where the component may look like:
-    #
-    # class MyComponent < ViewComponent::Base
-    #   has_one :header, HeaderComponent
-    #
-    #   class HeaderComponent < ViewComponent::Base
-    #     def name
-    #       @name
-    #     end
-    #   end
-    # end
-    #
-    def method_missing(symbol, *args, &block)
-      @__vc_component_instance.public_send(symbol, *args, &block)
-    end
-    ruby2_keywords(:method_missing) if respond_to?(:ruby2_keywords, true)
-
-    def html_safe?
-      to_s.html_safe?
-    end
-
-    def respond_to_missing?(symbol, include_all = false)
-      defined?(@__vc_component_instance) && @__vc_component_instance.respond_to?(symbol, include_all)
-    end
-  end
-end

data/lib/view_component/slotable_v2.rb

@@ -1,307 +0,0 @@
-# frozen_string_literal: true
-
-require "active_support/concern"
-require "view_component/slot_v2"
-
-module ViewComponent
-  module SlotableV2
-    extend ActiveSupport::Concern
-
-    # Setup component slot state
-    included do
-      # Hash of registered Slots
-      class_attribute :registered_slots
-      self.registered_slots = {}
-    end
-
-    class_methods do
-      ##
-      # Registers a sub-component
-      #
-      # = Example
-      #
-      #   renders_one :header -> (classes:) do
-      #     HeaderComponent.new(classes: classes)
-      #   end
-      #
-      #   # OR
-      #
-      #   renders_one :header, HeaderComponent
-      #
-      #   where `HeaderComponent` is defined as:
-      #
-      #   class HeaderComponent < ViewComponent::Base
-      #     def initialize(classes:)
-      #       @classes = classes
-      #     end
-      #   end
-      #
-      #   and has the following template:
-      #
-      #   <header class="<%= @classes %>">
-      #     <%= content %>
-      #   </header>
-      #
-      # = Rendering sub-component content
-      #
-      # The component's sidecar template can access the sub-component by calling a
-      # helper method with the same name as the sub-component.
-      #
-      #   <h1>
-      #     <%= header do %>
-      #       My header title
-      #     <% end %>
-      #   </h1>
-      #
-      # = Setting sub-component content
-      #
-      # Consumers of the component can render a sub-component by calling a
-      # helper method with the same name as the slot.
-      #
-      #   <%= render_inline(MyComponent.new) do |component| %>
-      #     <% component.header(classes: "Foo") do %>
-      #       <p>Bar</p>
-      #     <% end %>
-      #   <% end %>
-      def renders_one(slot_name, callable = nil)
-        validate_singular_slot_name(slot_name)
-
-        define_method slot_name do |*args, &block|
-          if args.empty? && block.nil?
-            get_slot(slot_name)
-          else
-            set_slot(slot_name, nil, *args, &block)
-          end
-        end
-        ruby2_keywords(slot_name.to_sym) if respond_to?(:ruby2_keywords, true)
-
-        register_slot(slot_name, collection: false, callable: callable)
-      end
-
-      ##
-      # Registers a collection sub-component
-      #
-      # = Example
-      #
-      #   render_many :items, -> (name:) { ItemComponent.new(name: name }
-      #
-      #   # OR
-      #
-      #   render_many :items, ItemComponent
-      #
-      # = Rendering sub-components
-      #
-      # The component's sidecar template can access the slot by calling a
-      # helper method with the same name as the slot.
-      #
-      #   <h1>
-      #     <% items.each do |item| %>
-      #       <%= item %>
-      #     <% end %>
-      #   </h1>
-      #
-      # = Setting sub-component content
-      #
-      # Consumers of the component can set the content of a slot by calling a
-      # helper method with the same name as the slot. The method can be
-      # called multiple times to append to the slot.
-      #
-      #   <%= render_inline(MyComponent.new) do |component| %>
-      #     <% component.item(name: "Foo") do %>
-      #       <p>One</p>
-      #     <% end %>
-      #
-      #     <% component.item(name: "Bar") do %>
-      #       <p>two</p>
-      #     <% end %>
-      #   <% end %>
-      def renders_many(slot_name, callable = nil)
-        validate_plural_slot_name(slot_name)
-
-        singular_name = ActiveSupport::Inflector.singularize(slot_name)
-
-        # Define setter for singular names
-        # for example `renders_many :items` allows fetching all tabs with
-        # `component.tabs` and setting a tab with `component.tab`
-        define_method singular_name do |*args, &block|
-          set_slot(slot_name, nil, *args, &block)
-        end
-        ruby2_keywords(singular_name.to_sym) if respond_to?(:ruby2_keywords, true)
-
-        # Instantiates and and adds multiple slots forwarding the first
-        # argument to each slot constructor
-        define_method slot_name do |collection_args = nil, &block|
-          if collection_args.nil? && block.nil?
-            get_slot(slot_name)
-          else
-            collection_args.map do |args|
-              set_slot(slot_name, nil, **args, &block)
-            end
-          end
-        end
-
-        register_slot(slot_name, collection: true, callable: callable)
-      end
-
-      def slot_type(slot_name)
-        registered_slot = registered_slots[slot_name]
-        if registered_slot
-          registered_slot[:collection] ? :collection : :single
-        else
-          plural_slot_name = ActiveSupport::Inflector.pluralize(slot_name).to_sym
-          plural_registered_slot = registered_slots[plural_slot_name]
-          plural_registered_slot&.fetch(:collection) ? :collection_item : nil
-        end
-      end
-
-      # Clone slot configuration into child class
-      # see #test_slots_pollution
-      def inherited(child)
-        child.registered_slots = self.registered_slots.clone
-        super
-      end
-
-      private
-
-      def register_slot(slot_name, **kwargs)
-        self.registered_slots[slot_name] = define_slot(slot_name, **kwargs)
-      end
-
-      def define_slot(slot_name, collection:, callable:)
-        # Setup basic slot data
-        slot = {
-          collection: collection,
-        }
-        return slot unless callable
-
-        # If callable responds to `render_in`, we set it on the slot as a renderable
-        if callable.respond_to?(:method_defined?) && callable.method_defined?(:render_in)
-          slot[:renderable] = callable
-        elsif callable.is_a?(String)
-          # If callable is a string, we assume it's referencing an internal class
-          slot[:renderable_class_name] = callable
-        elsif callable.respond_to?(:call)
-          # If slot doesn't respond to `render_in`, we assume it's a proc,
-          # define a method, and save a reference to it to call when setting
-          method_name = :"_call_#{slot_name}"
-          define_method method_name, &callable
-          slot[:renderable_function] = instance_method(method_name)
-        else
-          raise(
-            ArgumentError,
-            "invalid slot definition. Please pass a class, string, or callable (i.e. proc, lambda, etc)"
-          )
-        end
-
-        slot
-      end
-
-      def validate_plural_slot_name(slot_name)
-        if slot_name.to_sym == :contents
-          raise ArgumentError.new(
-            "#{self} 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."
-          )
-        end
-
-        raise_if_slot_registered(slot_name)
-      end
-
-      def validate_singular_slot_name(slot_name)
-        if slot_name.to_sym == :content
-          raise ArgumentError.new(
-            "#{self} 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."
-          )
-        end
-
-        raise_if_slot_registered(slot_name)
-      end
-
-      def raise_if_slot_registered(slot_name)
-        if self.registered_slots.key?(slot_name)
-          # TODO remove? This breaks overriding slots when slots are inherited
-          raise ArgumentError.new(
-            "#{self} declares the #{slot_name} slot multiple times.\n\n" \
-            "To fix this issue, choose a different slot name."
-          )
-        end
-      end
-    end
-
-    def get_slot(slot_name)
-      content unless content_evaluated? # ensure content is loaded so slots will be defined
-
-      slot = self.class.registered_slots[slot_name]
-      @__vc_set_slots ||= {}
-
-      if @__vc_set_slots[slot_name]
-        return @__vc_set_slots[slot_name]
-      end
-
-      if slot[:collection]
-        []
-      else
-        nil
-      end
-    end
-
-    def set_slot(slot_name, slot_definition = nil, *args, &block)
-      slot_definition ||= self.class.registered_slots[slot_name]
-      slot = SlotV2.new(self)
-
-      # Passing the block to the sub-component wrapper like this has two
-      # benefits:
-      #
-      # 1. If this is a `content_area` style sub-component, we will render the
-      # block via the `slot`
-      #
-      # 2. Since we've to pass block content to components when calling
-      # `render`, evaluating the block here would require us to call
-      # `view_context.capture` twice, which is slower
-      slot.__vc_content_block = block if block_given?
-
-      # If class
-      if slot_definition[:renderable]
-        slot.__vc_component_instance = slot_definition[:renderable].new(*args)
-      # If class name as a string
-      elsif slot_definition[:renderable_class_name]
-        slot.__vc_component_instance =
-          self.class.const_get(slot_definition[:renderable_class_name]).new(*args)
-      # If passed a lambda
-      elsif slot_definition[:renderable_function]
-        # Use `bind(self)` to ensure lambda is executed in the context of the
-        # current component. This is necessary to allow the lambda to access helper
-        # methods like `content_tag` as well as parent component state.
-        renderable_function = slot_definition[:renderable_function].bind(self)
-        renderable_value =
-          if block_given?
-            renderable_function.call(*args) do |*args|
-              view_context.capture(*args, &block)
-            end
-          else
-            renderable_function.call(*args)
-          end
-
-        # Function calls can return components, so if it's a component handle it specially
-        if renderable_value.respond_to?(:render_in)
-          slot.__vc_component_instance = renderable_value
-        else
-          slot.__vc_content = renderable_value
-        end
-      end
-
-      @__vc_set_slots ||= {}
-
-      if slot_definition[:collection]
-        @__vc_set_slots[slot_name] ||= []
-        @__vc_set_slots[slot_name].push(slot)
-      else
-        @__vc_set_slots[slot_name] = slot
-      end
-
-      slot
-    end
-    ruby2_keywords(:set_slot) if respond_to?(:ruby2_keywords, true)
-  end
-end

data/lib/view_component/template_error.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-module ViewComponent
-  class TemplateError < StandardError
-    def initialize(errors)
-      super(errors.join(", "))
-    end
-  end
-end

data/lib/yard/mattr_accessor_handler.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-module YARD
-  # YARD Handler to parse `mattr_accessor` calls.
-  class MattrAccessorHandler < YARD::Handlers::Ruby::Base
-    handles method_call(:mattr_accessor)
-    namespace_only
-
-    process do
-      name = statement.parameters.first.jump(:tstring_content, :ident).source
-      object = YARD::CodeObjects::MethodObject.new(namespace, name)
-      register(object)
-      parse_block(statement.last, owner: object)
-
-      object.dynamic = true
-      object[:mattr_accessor] = true
-    end
-  end
-end