vident 1.0.0.beta1 → 1.0.0.beta2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: afda27d62ee5246fc8fdd81ab6f53720ec58ebbd8ca42099b120f7c388788688
-  data.tar.gz: c2ddd4762e650cd0ce63ff01662bb691cb76943c3f538eb490348dd211c98a1a
+  metadata.gz: b6c4ad465075f1a6541193c93ae1d96eb9f714b2d22390c30e1e0335ebec0935
+  data.tar.gz: ecb1718a8c85835afeb6e408f62300e345b94ac03f05f5f9c6b99f40859a3f0c
 SHA512:
-  metadata.gz: 00fb4a976875313eed41e49f235417a6dd6d5d42a7d0aeed572d62eb3bca61636cbd6cf14c4483f34e95744772375cdcdbc1c9ad889e9c18e8a0dcf9d061b0f8
-  data.tar.gz: 995ba08626a953e7212b16d4bea31a18277bf764e327b02498ac0893599a050fcbe9be5c88c71bbff264b5822d9b59d41781dc7f940fa039ffcd9b176bea2159
+  metadata.gz: 5f9d61b1b93ebc7bacee4aab54e82ef3c51211357ab05de0ac4763189dc60304481f2f7b306d03c9a0412b55e26477b4fe0ebb7c6c62f0863d09cea2d91088b3
+  data.tar.gz: 1d5aa67d225c9e2c8e9fee2f4cf355afa660a5b80e639b38edc169e293d694400f8d3aa04fa2178d95c61c4e5a15348695fb0e2da68359d6686f758bd69bf53f

data/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

data/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

data/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

data/lib/vident/component.rb

@@ -27,7 +27,7 @@ module Vident
     include ComponentClassLists
     include ComponentAttributeResolver
 
-    include TagHelper
+    include ChildElementHelper
     include Tailwind
     include StimulusHelper
 

data/lib/vident/stimulus_outlet.rb

@@ -67,8 +67,7 @@ module Vident
     end
 
     def parse_two_arguments(arg1, arg2)
-      if arg1.is_a?(Symbol) && arg2.is_a?(String)
-        # outlet name on implied controller + custom selector
+      if (arg1.is_a?(Symbol) || arg1.is_a?(String)) && arg2.is_a?(String)
         @controller = implied_controller_name
         @outlet_name = arg1.to_s.dasherize
         @selector = arg2

data/lib/vident/version.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

data/lib/vident.rb

@@ -38,7 +38,7 @@ require "vident/stimulus_class_collection"
 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"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vident
 version: !ruby/object:Gem::Version
-  version: 1.0.0.beta1
+  version: 1.0.0.beta2
 platform: ruby
 authors:
 - Stephen Ierodiaconou
@@ -84,6 +84,7 @@ files:
 - README.md
 - lib/vident.rb
 - lib/vident/caching.rb
+- lib/vident/child_element_helper.rb
 - lib/vident/class_list_builder.rb
 - lib/vident/component.rb
 - lib/vident/component_attribute_resolver.rb
@@ -109,7 +110,6 @@ files:
 - lib/vident/stimulus_target_collection.rb
 - lib/vident/stimulus_value.rb
 - lib/vident/stimulus_value_collection.rb
-- lib/vident/tag_helper.rb
 - lib/vident/tailwind.rb
 - lib/vident/version.rb
 homepage: https://github.com/stevegeek/vident

data/lib/vident/tag_helper.rb

@@ -1,65 +0,0 @@
-# frozen_string_literal: true
-
-module Vident
-  module TagHelper
-    # Generate a tag with the given name and options, including stimulus data attributes
-    def tag(
-      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
-    )
-      # Ensure the plural attributes are actually enumerables
-      tag_attribute_must_be_collection!(stimulus_controllers, "stimulus_controllers")
-      tag_attribute_must_be_collection!(stimulus_targets, "stimulus_targets")
-      tag_attribute_must_be_collection!(stimulus_actions, "stimulus_actions")
-      tag_attribute_must_be_collection!(stimulus_outlets, "stimulus_outlets")
-      tag_attribute_must_be_collection!(stimulus_values, "stimulus_values")
-      tag_attribute_must_be_collection!(stimulus_classes, "stimulus_classes")
-
-      stimulus_controllers_collection = send(:stimulus_controllers, *tag_wrap_single_stimulus_attribute(stimulus_controllers, stimulus_controller))
-      stimulus_targets_collection = send(:stimulus_targets, *tag_wrap_single_stimulus_attribute(stimulus_targets, stimulus_target))
-      stimulus_actions_collection = send(:stimulus_actions, *tag_wrap_single_stimulus_attribute(stimulus_actions, stimulus_action))
-      stimulus_outlets_collection = send(:stimulus_outlets, *tag_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_tag(tag_name, stimulus_data_attributes, options, &block)
-    end
-
-    private
-
-    def tag_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 tag_wrap_single_stimulus_attribute(plural, singular)
-      return plural if plural
-      singular.nil? ? nil : [singular]
-    end
-
-    def generate_tag(tag_name, stimulus_data_attributes, options, &block)
-      raise NoMethodError, "Not implemented"
-    end
-  end
-end