Add from to use_helpers to add macro like syntax

docs/CHANGELOG.md

@@ -18,6 +18,10 @@ nav_order: 5
 
     *Reegan Viljoen*
 
+* Add `from:` option to `use_helpers` to allow for more flexible helper inclusion from modules.
+
+    *Reegan Viljoen*
+
 ## 3.12.1
 
 * Ensure content is rendered correctly for forwarded slots.

docs/guide/helpers.md

@@ -69,6 +69,18 @@ class UseHelpersComponent < ViewComponent::Base
 end
 ```
 
+Methods defined in helper modules that are not available in the component can be included individually using the `from:` keyword:
+
+```ruby
+class UserComponent < ViewComponent::Base
+  use_helpers :icon, from: IconHelper
+
+  def profile_icon
+    icon :user
+  end
+end
+```
+
 ## Nested URL helpers
 
 Rails nested URL helpers implicitly depend on the current `request` in certain cases. Since ViewComponent is built to enable reusing components in different contexts, nested URL helpers should be passed their options explicitly:

lib/view_component/use_helpers.rb

@@ -4,15 +4,35 @@ module ViewComponent::UseHelpers
   extend ActiveSupport::Concern
 
   class_methods do
-    def use_helpers(*args)
+    def use_helpers(*args, from: nil)
+      if from.nil?
+        define_helpers_without_source(*args)
+      else
+        define_helpers_with_source(*args, source: from)
+      end
+    end
+
+    private
+
+    def define_helpers_without_source(*args)
       args.each do |helper_method|
         class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
           def #{helper_method}(*args, &block)
             raise HelpersCalledBeforeRenderError if view_context.nil?
             __vc_original_view_context.#{helper_method}(*args, &block)
           end
         RUBY
+        ruby2_keywords(helper_method) if respond_to?(:ruby2_keywords, true)
+      end
+    end
 
+    def define_helpers_with_source(*args, source:)
+      args.each do |helper_method|
+        class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
+          def #{helper_method}(*args, &block)
+            #{source}.instance_method(:#{helper_method}).bind(self).call(*args, &block)
+          end
+        RUBY
         ruby2_keywords(helper_method) if respond_to?(:ruby2_keywords, true)
       end
     end

test/sandbox/app/components/use_helpers_macro_component.html.erb

@@ -0,0 +1,11 @@
+<div class='helper__message'>
+  <%= message %>
+</div>
+
+<div class='helper__args-message'>
+  <%= message_with_args('macro helper method') %>
+</div>
+
+<div class='helper__kwargs-message'>
+  <%= message_with_kwargs(name: 'macro kwargs helper method') %>
+</div>

test/sandbox/app/components/use_helpers_macro_component.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+class UseHelpersMacroComponent < ViewComponent::Base
+  use_helpers :message, :message_with_args, :message_with_kwargs, from: MacroHelper
+end

test/sandbox/app/helpers/macro_helper.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module MacroHelper
+  def message
+    "Hello helper method"
+  end
+
+  def message_with_args(name)
+    "Hello #{name}"
+  end
+
+  def message_with_kwargs(name:)
+    "Hello #{name}"
+  end
+end

test/sandbox/test/rendering_test.rb

@@ -1121,4 +1121,22 @@ def test_inline_component_renders_without_trailing_whitespace
 
     refute @rendered_content =~ /\s+\z/, "Rendered component contains trailing whitespace"
   end
+
+  def test_use_helper_macros
+    render_inline(UseHelpersMacroComponent.new)
+
+    assert_selector ".helper__message", text: "Hello helper method"
+  end
+
+  def test_use_helper_macros_with_args
+    render_inline(UseHelpersMacroComponent.new)
+
+    assert_selector ".helper__args-message", text: "Hello macro helper method"
+  end
+
+  def test_use_helper_macros_with_kwargs
+    render_inline(UseHelpersMacroComponent.new)
+
+    assert_selector ".helper__kwargs-message", text: "Hello macro kwargs helper method"
+  end
 end