vident 1.0.0.alpha4 → 1.0.0.beta2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c54754ab99b27a206220aa1838ad87a5d3c20c82ea75e979cf75b9abd22ea399
-  data.tar.gz: 7db37576b0746ad8f341688dfc258372d3c7261309ec7bad09314379cb396283
+  metadata.gz: b6c4ad465075f1a6541193c93ae1d96eb9f714b2d22390c30e1e0335ebec0935
+  data.tar.gz: ecb1718a8c85835afeb6e408f62300e345b94ac03f05f5f9c6b99f40859a3f0c
 SHA512:
-  metadata.gz: abf353b9240cca66d84b837ebb7145511866880565eedc393869aea2bac2951e40ad57a1d00f16d093b35e386c994696ddc83e7ff4bf1a64e1131f956cd9219d
-  data.tar.gz: 6a1126b981c13ced4105c33f224c58c988baf13146e3ed8b97de037cd0e88009040b3331c986540eecc13718250124d5b8c187e51c2446866957a9d969083f77
+  metadata.gz: 5f9d61b1b93ebc7bacee4aab54e82ef3c51211357ab05de0ac4763189dc60304481f2f7b306d03c9a0412b55e26477b4fe0ebb7c6c62f0863d09cea2d91088b3
+  data.tar.gz: 1d5aa67d225c9e2c8e9fee2f4cf355afa660a5b80e639b38edc169e293d694400f8d3aa04fa2178d95c61c4e5a15348695fb0e2da68359d6686f758bd69bf53f

data/CHANGELOG.md

@@ -6,6 +6,26 @@ 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
+
+- `tag(...)` singular stimulus kwargs (e.g. `stimulus_action: [:click, :foo]`) no longer splat `[event, handler]` tuples into two bare handlers (#19).
+- `vident-view_component`'s `tag(...)` now emits void elements (`:input`, `:img`, `:br`, etc.) without a closing tag (#19).
+- `vident-view_component`'s `tag(...)` without a block no longer renders the options hash as element content (#19).
+- `stimulus_targets:` prop now accepts `Array` entries (e.g. `[[controller_path, :name]]`), matching `stimulus_actions:` (#20).
+- `stimulus do ... outlets(...)` DSL now accepts a positional `Hash`, allowing string keys (e.g. stimulus identifiers containing `--`) that cannot be Ruby kwarg keys (#21).
+
 ## [1.0.0.alpha4] - 2025-12-12
 
 - Update to `view_component` 4

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_builder.rb

@@ -46,7 +46,8 @@ module Vident
       self
     end
 
-    def outlets(**outlet_mappings)
+    def outlets(positional = nil, **outlet_mappings)
+      @outlets.merge!(positional) if positional.is_a?(Hash)
       @outlets.merge!(outlet_mappings) unless outlet_mappings.empty?
       self
     end

data/lib/vident/stimulus_component.rb

@@ -49,7 +49,7 @@ module Vident
         end
       end
       prop :stimulus_actions, _Array(_Union(String, Symbol, Array, Hash, StimulusAction, StimulusActionCollection)), default: -> { [] }
-      prop :stimulus_targets, _Array(_Union(String, Symbol, Hash, StimulusTarget, StimulusTargetCollection)), default: -> { [] }
+      prop :stimulus_targets, _Array(_Union(String, Symbol, Array, Hash, StimulusTarget, StimulusTargetCollection)), default: -> { [] }
       prop :stimulus_outlets, _Array(_Union(String, Symbol, StimulusOutlet, StimulusOutletCollection)), default: -> { [] }
       prop :stimulus_outlet_host, _Nilable(Vident::Component) # A component that will host this component as an outlet
       prop :stimulus_values, _Union(_Hash(Symbol, _Any), StimulusValue, StimulusValueCollection), default: -> { {} } # TODO: instead of _Any, is it _Interface(:to_s)?

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.alpha4"
+  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,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: vident
 version: !ruby/object:Gem::Version
-  version: 1.0.0.alpha4
+  version: 1.0.0.beta2
 platform: ruby
 authors:
 - Stephen Ierodiaconou
 bindir: bin
 cert_chain: []
-date: 2025-12-12 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -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
@@ -133,7 +133,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Vident is the base of your design system implementation, which provides helpers
   for working with Stimulus. For component libraries with ViewComponent or Phlex.

data/lib/vident/tag_helper.rb

@@ -1,64 +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)
-      plural || (singular ? Array.wrap(singular) : nil)
-    end
-
-    def generate_tag(tag_name, stimulus_data_attributes, options, &block)
-      raise NoMethodError, "Not implemented"
-    end
-  end
-end