tag => child_element helper rename. Bump beta2

Author: stevegeek

CHANGELOG.md

@@ -6,6 +6,16 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
 
+## [1.0.0.beta2] - 2026-04-16
+
+### Breaking
+
+- Renamed the `tag(...)` helper to `child_element(...)` (and the internal `Vident::TagHelper` module to `Vident::ChildElementHelper`). The old name shadowed Rails' own `tag(name, options)` positional API, which breaks Rails helpers like `hidden_field_tag` and `image_tag` when called inside vident components. Rename any `component.tag(...)` calls to `component.child_element(...)`.
+
+### Fixed
+
+- `stimulus_outlet` parser now accepts `(String, String)` arguments so string-keyed outlets produced by the DSL actually render.
+
 ## [1.0.0.beta1] - 2026-04-16
 
 ### Fixed

README.md

@@ -93,7 +93,7 @@ class ButtonComponent < Vident::ViewComponent::Base
   def call
     root_element do |component|
       # Wire up targets etc
-      component.tag(:span, stimulus_target: :status) do
+      component.child_element(:span, stimulus_target: :status) do
         @text
       end
     end
@@ -483,13 +483,13 @@ or you can use tag helpers to generate HTML with Stimulus attributes:
   <% end %>
   <%= content_tag(:span, class: "...", data: {**greeter.stimulus_target(:output)}) %>
 
-  <%# OR use the vident tag helper  %>
+  <%# OR use the vident child_element helper  %>
 
-  <%= greeter.tag(:input, stimulus_target: :name, type: "text", class: "...") %>
-  <%= greeter.tag(:button, stimulus_action: [:click, :greet], class: "...") do %>
+  <%= greeter.child_element(:input, stimulus_target: :name, type: "text", class: "...") %>
+  <%= greeter.child_element(:button, stimulus_action: [:click, :greet], class: "...") do %>
     <%= @cta %>
   <% end %>
-  <%= greeter.tag(:span, stimulus_target: :output, class: "...") %>
+  <%= greeter.child_element(:span, stimulus_target: :output, class: "...") %>
 ```
 
 or in your Phlex templates:
@@ -498,7 +498,7 @@ or in your Phlex templates:
 root_element do |greeter|
   input(type: "text", data: {**greeter.stimulus_target(:name)}, class: %(...))
   trigger_or_default(greeter)
-  greeter.tag(:span, stimulus_target: :output, class: "ml-4 #{greeter.class_list_for_stimulus_classes(:pre_click)}") do
+  greeter.child_element(:span, stimulus_target: :output, class: "ml-4 #{greeter.class_list_for_stimulus_classes(:pre_click)}") do
     plain %( ... )
   end
 end

context/1_overview.md

@@ -288,7 +288,7 @@ def view_template
   root do |component|
     div(data: component.stimulus_target(:name).to_h) { "Content" }
     button(data: {**component.stimulus_actions(:click)}) { "Click" }
-    component.tag(:span, stimulus_target: :output, class: "ml-4")
+    component.child_element(:span, stimulus_target: :output, class: "ml-4")
   end
 end
 ```

context/5_examples.md

@@ -60,7 +60,7 @@ end
       <%= form.label :advanced_mode, "Show advanced options" %>
     </div>
     
-    <%= component.tag(stimulus_targets: [:advanced_section]) do %> 
+    <%= component.child_element(stimulus_targets: [:advanced_section]) do %> 
          class="<%= @show_advanced ? 'block' : 'hidden' %> p-4 bg-gray-50 rounded mb-4">
       <!-- Advanced fields -->
       <%= form.label :preferences, class: "block text-sm font-medium text-gray-700" %>

lib/vident.rb

@@ -38,7 +38,7 @@
 require "vident/stimulus_attributes"
 require "vident/stimulus_data_attribute_builder"
 
-require "vident/tag_helper"
+require "vident/child_element_helper"
 require "vident/stable_id"
 require "vident/class_list_builder"
 

lib/vident/child_element_helper.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Vident
+  module ChildElementHelper
+    def child_element(
+      tag_name,
+      stimulus_controllers: nil,
+      stimulus_targets: nil,
+      stimulus_actions: nil,
+      stimulus_outlets: nil,
+      stimulus_values: nil,
+      stimulus_classes: nil,
+      stimulus_controller: nil,
+      stimulus_target: nil,
+      stimulus_action: nil,
+      stimulus_outlet: nil,
+      stimulus_value: nil,
+      stimulus_class: nil,
+      **options,
+      &block
+    )
+      child_element_attribute_must_be_collection!(stimulus_controllers, "stimulus_controllers")
+      child_element_attribute_must_be_collection!(stimulus_targets, "stimulus_targets")
+      child_element_attribute_must_be_collection!(stimulus_actions, "stimulus_actions")
+      child_element_attribute_must_be_collection!(stimulus_outlets, "stimulus_outlets")
+      child_element_attribute_must_be_collection!(stimulus_values, "stimulus_values")
+      child_element_attribute_must_be_collection!(stimulus_classes, "stimulus_classes")
+
+      stimulus_controllers_collection = send(:stimulus_controllers, *child_element_wrap_single_stimulus_attribute(stimulus_controllers, stimulus_controller))
+      stimulus_targets_collection = send(:stimulus_targets, *child_element_wrap_single_stimulus_attribute(stimulus_targets, stimulus_target))
+      stimulus_actions_collection = send(:stimulus_actions, *child_element_wrap_single_stimulus_attribute(stimulus_actions, stimulus_action))
+      stimulus_outlets_collection = send(:stimulus_outlets, *child_element_wrap_single_stimulus_attribute(stimulus_outlets, stimulus_outlet))
+      stimulus_values_collection = send(:stimulus_values, stimulus_values || stimulus_value)
+      stimulus_classes_collection = send(:stimulus_classes, stimulus_classes || stimulus_class)
+
+      stimulus_data_attributes = StimulusDataAttributeBuilder.new(
+        controllers: stimulus_controllers_collection,
+        actions: stimulus_actions_collection,
+        targets: stimulus_targets_collection,
+        outlets: stimulus_outlets_collection,
+        values: stimulus_values_collection,
+        classes: stimulus_classes_collection
+      ).build
+      generate_child_element(tag_name, stimulus_data_attributes, options, &block)
+    end
+
+    private
+
+    def child_element_attribute_must_be_collection!(collection, name)
+      return unless collection
+      raise ArgumentError, "'#{name}:' must be an enumerable. Did you mean '#{name.to_s.singularize}:'?" unless collection.is_a?(Enumerable)
+    end
+
+    def child_element_wrap_single_stimulus_attribute(plural, singular)
+      return plural if plural
+      singular.nil? ? nil : [singular]
+    end
+
+    def generate_child_element(tag_name, stimulus_data_attributes, options, &block)
+      raise NoMethodError, "Not implemented"
+    end
+  end
+end

lib/vident/component.rb

@@ -27,7 +27,7 @@ def prop_names
     include ComponentClassLists
     include ComponentAttributeResolver
 
-    include TagHelper
+    include ChildElementHelper
     include Tailwind
     include StimulusHelper
 

lib/vident/phlex/html.rb

@@ -51,7 +51,7 @@ def check_valid_html_tag!(tag_name)
         end
       end
 
-      def generate_tag(tag_type, stimulus_data_attributes, options, &block)
+      def generate_child_element(tag_type, stimulus_data_attributes, options, &block)
         options[:data] ||= {}
         options[:data].merge!(stimulus_data_attributes)
         check_valid_html_tag!(tag_type)

lib/vident/tag_helper.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Vident
-  VERSION = "1.0.0.beta1"
+  VERSION = "1.0.0.beta2"
 
   # Shared version for all vident gems
   def self.version