view_component 2.53.0 → 2.54.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d505afaa4cb16810628e814c69bb2d00bc76498f6c681173d7811f44cd87c8e
-  data.tar.gz: 2bc859d6034fed19e34739cf1844679bcf83332c7e227c487ddb7364e8166f4b
+  metadata.gz: b4b1f5b50f3ff33ba025588ac11f83362684484dae4aafea6b3be2a866944b3c
+  data.tar.gz: bdc4bf615413d7b3ab8e936c6df0ffd12b8915e03f44c5a8f6ad6989eb5fb5b5
 SHA512:
-  metadata.gz: 75dcf204fd8e3dfad8a1da18de6d96d43fd779f1c9a73ca66b76f0db1ac7be04cf04447c9eaa901d32bc674d7eb7fa79fd5572bff08652a892a7e96f5186faaa
-  data.tar.gz: 7be68adaa9de981a4fb12451ebcc19875f5754fa4798eef60f98702b1c7396bb598a1f6ae77b768bbe55e5b4f77c33f6b9db7156fa18f04c0a63075c54fdd7cc
+  metadata.gz: 98ce9d4ac6888dd6b6fed5987f2a6a95b6589c12930886bb35ec1009cdf385f507d3b199e63d27bd93f2125294cc5b8f7e085de27fd67ed6e45c613534bc41cb
+  data.tar.gz: '058bdd0c93a6af548eb77feaafb432fe5a6fa9ded2730b4576b7e87c713a403c81e6db5340aa70a78444b4ce8b9b95f729294391e98ff946ecc50f4c86837d48'

data/app/controllers/concerns/view_component/preview_actions.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module ViewComponent
+  module PreviewActions
+    extend ActiveSupport::Concern
+
+    included do
+      prepend_view_path File.expand_path("../../../views", __dir__)
+
+      around_action :set_locale, only: :previews
+      before_action :find_preview, only: :previews
+      before_action :require_local!, unless: :show_previews?
+
+      if respond_to?(:content_security_policy)
+        content_security_policy(false)
+      end
+    end
+
+    def index
+      @previews = ViewComponent::Preview.all
+      @page_title = "Component Previews"
+      render "view_components/index", **determine_layout
+    end
+
+    def previews
+      if params[:path] == @preview.preview_name
+        @page_title = "Component Previews for #{@preview.preview_name}"
+        render "view_components/previews", **determine_layout
+      else
+        prepend_application_view_paths
+        prepend_preview_examples_view_path
+        @example_name = File.basename(params[:path])
+        @render_args = @preview.render_args(@example_name, params: params.permit!)
+        layout = determine_layout(@render_args[:layout], prepend_views: false)[:layout]
+        locals = @render_args[:locals]
+        opts = {}
+        opts[:layout] = layout if layout.present? || layout == false
+        opts[:locals] = locals if locals.present?
+        render "view_components/preview", opts # rubocop:disable GitHub/RailsControllerRenderLiteral
+      end
+    end
+
+    private
+
+    def default_preview_layout # :doc:
+      ViewComponent::Base.default_preview_layout
+    end
+
+    def show_previews? # :doc:
+      ViewComponent::Base.show_previews
+    end
+
+    def find_preview # :doc:
+      candidates = []
+      params[:path].to_s.scan(%r{/|$}) { candidates << $` }
+      preview = candidates.detect { |candidate| ViewComponent::Preview.exists?(candidate) }
+
+      if preview
+        @preview = ViewComponent::Preview.find(preview)
+      else
+        raise AbstractController::ActionNotFound, "Component preview '#{params[:path]}' not found."
+      end
+    end
+
+    def set_locale
+      I18n.with_locale(params[:locale] || I18n.default_locale) do
+        yield
+      end
+    end
+
+    # Returns either {} or {layout: value} depending on configuration
+    def determine_layout(layout_override = nil, prepend_views: true)
+      return {} unless defined?(Rails.root)
+
+      layout_declaration = {}
+
+      if !layout_override.nil?
+        # Allow component-level override, even if false (thus no layout rendered)
+        layout_declaration[:layout] = layout_override
+      elsif default_preview_layout.present?
+        layout_declaration[:layout] = default_preview_layout
+      end
+
+      prepend_application_view_paths if layout_declaration[:layout].present? && prepend_views
+
+      layout_declaration
+    end
+
+    def prepend_application_view_paths
+      prepend_view_path Rails.root.join("app/views") if defined?(Rails.root)
+    end
+
+    def prepend_preview_examples_view_path
+      prepend_view_path(ViewComponent::Base.preview_paths)
+    end
+  end
+end

data/app/controllers/view_components_controller.rb

@@ -3,91 +3,5 @@
 require "rails/application_controller"
 
 class ViewComponentsController < Rails::ApplicationController # :nodoc:
-  prepend_view_path File.expand_path("../views", __dir__)
-
-  around_action :set_locale, only: :previews
-  before_action :find_preview, only: :previews
-  before_action :require_local!, unless: :show_previews?
-
-  if respond_to?(:content_security_policy)
-    content_security_policy(false)
-  end
-
-  def index
-    @previews = ViewComponent::Preview.all
-    @page_title = "Component Previews"
-    render "view_components/index", **determine_layout
-  end
-
-  def previews
-    if params[:path] == @preview.preview_name
-      @page_title = "Component Previews for #{@preview.preview_name}"
-      render "view_components/previews", **determine_layout
-    else
-      prepend_application_view_paths
-      prepend_preview_examples_view_path
-      @example_name = File.basename(params[:path])
-      @render_args = @preview.render_args(@example_name, params: params.permit!)
-      layout = determine_layout(@render_args[:layout], prepend_views: false)[:layout]
-      locals = @render_args[:locals]
-      opts = {}
-      opts[:layout] = layout if layout.present? || layout == false
-      opts[:locals] = locals if locals.present?
-      render "view_components/preview", opts # rubocop:disable GitHub/RailsControllerRenderLiteral
-    end
-  end
-
-  private
-
-  def default_preview_layout # :doc:
-    ViewComponent::Base.default_preview_layout
-  end
-
-  def show_previews? # :doc:
-    ViewComponent::Base.show_previews
-  end
-
-  def find_preview # :doc:
-    candidates = []
-    params[:path].to_s.scan(%r{/|$}) { candidates << $` }
-    preview = candidates.detect { |candidate| ViewComponent::Preview.exists?(candidate) }
-
-    if preview
-      @preview = ViewComponent::Preview.find(preview)
-    else
-      raise AbstractController::ActionNotFound, "Component preview '#{params[:path]}' not found."
-    end
-  end
-
-  def set_locale
-    I18n.with_locale(params[:locale] || I18n.default_locale) do
-      yield
-    end
-  end
-
-  # Returns either {} or {layout: value} depending on configuration
-  def determine_layout(layout_override = nil, prepend_views: true)
-    return {} unless defined?(Rails.root)
-
-    layout_declaration = {}
-
-    if !layout_override.nil?
-      # Allow component-level override, even if false (thus no layout rendered)
-      layout_declaration[:layout] = layout_override
-    elsif default_preview_layout.present?
-      layout_declaration[:layout] = default_preview_layout
-    end
-
-    prepend_application_view_paths if layout_declaration[:layout].present? && prepend_views
-
-    layout_declaration
-  end
-
-  def prepend_application_view_paths
-    prepend_view_path Rails.root.join("app/views") if defined?(Rails.root)
-  end
-
-  def prepend_preview_examples_view_path
-    prepend_view_path(ViewComponent::Base.preview_paths)
-  end
+  include ViewComponent::PreviewActions
 end

data/docs/CHANGELOG.md

@@ -9,6 +9,24 @@ title: Changelog
 
 ## main
 
+## 2.54.0
+
+* Add `with_*` slot API for defining slots. Note: we plan to deprecate the non `with_*` API for slots in an upcoming release.
+
+    *Blake Williams*
+
+* Add QuickNode to list of companies that heavily rely on ViewComponent.
+
+    *Luc Castera*
+
+* Include the `Translatable` module by default.
+
+    *Elia Schito*
+
+* Update docs dependencies.
+
+    *Joel Hawksley*
+
 ## 2.53.0
 
 * Add support for relative I18n scopes to translations.
@@ -160,6 +178,10 @@ title: Changelog
 
     *Peter Goldstein*
 
+* Move preview logic to module for easier app integration.
+
+    *Sammy Henningsson*
+
 ## 2.48.0
 
 * Correct path in example test command in Contributing docs.

data/lib/view_component/base.rb

@@ -17,6 +17,7 @@ module ViewComponent
     include ViewComponent::ContentAreas
     include ViewComponent::Previewable
     include ViewComponent::SlotableV2
+    include ViewComponent::Translatable
     include ViewComponent::WithContentHelper
 
     ViewContextCalledBeforeRenderError = Class.new(StandardError)

data/lib/view_component/compiler.rb

@@ -77,6 +77,7 @@ module ViewComponent
 
         define_render_template_for
 
+        component_class.build_i18n_backend
         component_class._after_compile
 
         CompileCache.register(component_class)

data/lib/view_component/polymorphic_slots.rb

@@ -45,10 +45,16 @@ module ViewComponent
               "#{slot_name}_#{poly_type}"
             end
 
+          # Deprecated: Will be removed in 3.0
           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)
+
+          define_method("with_#{setter_name}") do |*args, &block|
+            set_polymorphic_slot(slot_name, poly_type, *args, &block)
+          end
+          ruby2_keywords(:"with_#{setter_name}") if respond_to?(:ruby2_keywords, true)
         end
 
         self.registered_slots[slot_name] = {

data/lib/view_component/slotable_v2.rb

@@ -61,20 +61,26 @@ module ViewComponent
       # = 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.
+      # helper method with the same name as the slot prefixed with `with_`.
       #
       #   <%= render_inline(MyComponent.new) do |component| %>
-      #     <% component.header(classes: "Foo") do %>
+      #     <% component.with_header(classes: "Foo") do %>
       #       <p>Bar</p>
       #     <% end %>
       #   <% end %>
       def renders_one(slot_name, callable = nil)
         validate_singular_slot_name(slot_name)
 
+        define_method :"with_#{slot_name}" do |*args, &block|
+          set_slot(slot_name, nil, *args, &block)
+        end
+        ruby2_keywords(:"with_#{slot_name}") if respond_to?(:ruby2_keywords, true)
+
         define_method slot_name do |*args, &block|
           if args.empty? && block.nil?
             get_slot(slot_name)
           else
+            # Deprecated: Will remove in 3.0
             set_slot(slot_name, nil, *args, &block)
           end
         end
@@ -112,15 +118,15 @@ module ViewComponent
       # = 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.
+      # helper method with the same name as the slot prefixed with `with_`. The
+      # method can be called multiple times to append to the slot.
       #
       #   <%= render_inline(MyComponent.new) do |component| %>
-      #     <% component.item(name: "Foo") do %>
+      #     <% component.with_item(name: "Foo") do %>
       #       <p>One</p>
       #     <% end %>
       #
-      #     <% component.item(name: "Bar") do %>
+      #     <% component.with_item(name: "Bar") do %>
       #       <p>two</p>
       #     <% end %>
       #   <% end %>
@@ -132,17 +138,32 @@ module ViewComponent
         # Define setter for singular names
         # for example `renders_many :items` allows fetching all tabs with
         # `component.tabs` and setting a tab with `component.tab`
+        #
+        # Deprecated: Will remove in 3.0
         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)
 
+        define_method :"with_#{singular_name}" do |*args, &block|
+          set_slot(slot_name, nil, *args, &block)
+        end
+        ruby2_keywords(:"with_#{singular_name}") if respond_to?(:ruby2_keywords, true)
+
+        define_method :"with_#{slot_name}" do |collection_args = nil, &block|
+          collection_args.map do |args|
+            set_slot(slot_name, nil, **args, &block)
+          end
+        end
+        ruby2_keywords(:"with_#{slot_name}") 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
+            # Deprecated: Will remove in 3.0
             collection_args.map do |args|
               set_slot(slot_name, nil, **args, &block)
             end

data/lib/view_component/translatable.rb

@@ -20,9 +20,7 @@ module ViewComponent
         @i18n_scope ||= virtual_path.sub(%r{^/}, "").gsub(%r{/_?}, ".")
       end
 
-      def _after_compile
-        super
-
+      def build_i18n_backend
         return if CompileCache.compiled? self
 
         if (translation_files = _sidecar_files(%w[yml yaml])).any?

data/lib/view_component/version.rb

@@ -3,7 +3,7 @@
 module ViewComponent
   module VERSION
     MAJOR = 2
-    MINOR = 53
+    MINOR = 54
     PATCH = 0
 
     STRING = [MAJOR, MINOR, PATCH].join(".")

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: view_component
 version: !ruby/object:Gem::Version
-  version: 2.53.0
+  version: 2.54.0
 platform: ruby
 authors:
 - GitHub Open Source
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-04-20 00:00:00.000000000 Z
+date: 2022-05-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -293,6 +293,7 @@ files:
 - README.md
 - app/assets/vendor/prism.css
 - app/assets/vendor/prism.min.js
+- app/controllers/concerns/view_component/preview_actions.rb
 - app/controllers/view_components_controller.rb
 - app/helpers/preview_helper.rb
 - app/views/test_mailer/test_email.html.erb