vident 1.0.0.beta1 → 1.0.0

data/lib/vident/stimulus_data_attribute_builder.rb

@@ -1,90 +1,31 @@
 # frozen_string_literal: true
 
 module Vident
-  # Builds a hash of Stimulus data attributes from collections of stimulus objects
-  # Handles merging multiple actions, targets, outlets, values, and classes
-  # into the final data-* attributes needed for HTML elements
   class StimulusDataAttributeBuilder
-    def initialize(controllers: [], actions: [], targets: [], outlets: [], values: [], classes: [])
-      @controllers = Array(controllers)
-      @actions = Array(actions)
-      @targets = Array(targets)
-      @outlets = Array(outlets)
-      @values = Array(values)
-      @classes = Array(classes)
+    def initialize(**collections_by_name)
+      unknown = collections_by_name.keys - Stimulus.names
+      raise ArgumentError, "Unknown stimulus primitive(s) #{unknown.inspect}" if unknown.any?
+
+      @collections_by_name = collections_by_name.transform_values { |v| Array(v) }
     end
 
-    # Build the final data attributes hash
     def build
-      {
-        **merged_controllers,
-        **merged_actions,
-        **merged_targets,
-        **merged_outlets,
-        **merged_values,
-        **merged_classes
-      }.transform_keys(&:to_s).compact
+      Stimulus::PRIMITIVES.each_with_object({}) do |primitive, attrs|
+        attrs.merge!(merge_collection(primitive.collection_class, @collections_by_name[primitive.name] || []))
+      end.transform_keys(&:to_s).compact
     end
 
     private
 
-    def merged_controllers
-      return {} if @controllers.empty?
-
-      if @controllers.first.is_a?(StimulusControllerCollection)
-        StimulusControllerCollection.merge(*@controllers).to_h
-      else
-        StimulusControllerCollection.new(@controllers).to_h
-      end
-    end
-
-    def merged_actions
-      return {} if @actions.empty?
-
-      if @actions.first.is_a?(StimulusActionCollection)
-        StimulusActionCollection.merge(*@actions).to_h
-      else
-        StimulusActionCollection.new(@actions).to_h
-      end
-    end
-
-    def merged_targets
-      return {} if @targets.empty?
-
-      if @targets.first.is_a?(StimulusTargetCollection)
-        StimulusTargetCollection.merge(*@targets).to_h
-      else
-        StimulusTargetCollection.new(@targets).to_h
-      end
-    end
-
-    def merged_outlets
-      return {} if @outlets.empty?
-
-      if @outlets.first.is_a?(StimulusOutletCollection)
-        StimulusOutletCollection.merge(*@outlets).to_h
-      else
-        StimulusOutletCollection.new(@outlets).to_h
-      end
-    end
-
-    def merged_values
-      return {} if @values.empty?
-
-      if @values.first.is_a?(StimulusValueCollection)
-        StimulusValueCollection.merge(*@values).to_h
-      else
-        StimulusValueCollection.new(@values).to_h
-      end
-    end
-
-    def merged_classes
-      return {} if @classes.empty?
+    # Items are either pre-built collections (DSL / resolver path) or raw value
+    # objects (child_element path). Merge-or-wrap accordingly.
+    def merge_collection(collection_class, items)
+      return {} if items.empty?
 
-      if @classes.first.is_a?(StimulusClassCollection)
-        StimulusClassCollection.merge(*@classes).to_h
+      if items.first.is_a?(collection_class)
+        collection_class.merge(*items).to_h
       else
-        StimulusClassCollection.new(@classes).to_h
+        collection_class.new(items).to_h
       end
     end
   end

data/lib/vident/stimulus_helper.rb

@@ -47,28 +47,20 @@ module Vident
 
       protected
 
-      def stimulus_dsl_builder
-        @stimulus_builder
-      end
+      def stimulus_dsl_builder = @stimulus_builder
     end
 
     # Instance method to get DSL attributes for this component instance
-    def stimulus_dsl_attributes
-      self.class.stimulus_dsl_attributes(self)
-    end
+    def stimulus_dsl_attributes = self.class.stimulus_dsl_attributes(self)
 
     # Instance method to resolve prop-mapped values at runtime
     def resolve_values_from_props(prop_names)
       return {} if prop_names.empty?
 
-      resolved = {}
-      prop_names.each do |name|
+      prop_names.each_with_object({}) do |name, resolved|
         # Map from instance variable if it exists
-        if instance_variable_defined?("@#{name}")
-          resolved[name] = instance_variable_get("@#{name}")
-        end
+        resolved[name] = instance_variable_get("@#{name}") if instance_variable_defined?("@#{name}")
       end
-      resolved
     end
   end
 end

data/lib/vident/stimulus_null.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Vident
+  # Sentinel: emits the literal string "null" as the data attribute value.
+  # For Stimulus `Object` and `Array` value types this is JSON-parsed to JS `null`;
+  # other value types will read it as garbage ("null" string / NaN / truthy), so only
+  # use this with nullable Object/Array values.
+  #
+  # A bare `nil` (static or returned from a proc) omits the attribute entirely so
+  # Stimulus uses its per-type default. Reach for this sentinel only when you need
+  # an explicit JS `null`.
+  StimulusNull = Object.new
+  def StimulusNull.inspect
+    "Vident::StimulusNull"
+  end
+
+  def StimulusNull.to_s
+    "null"
+  end
+  StimulusNull.freeze
+end

data/lib/vident/stimulus_outlet.rb

@@ -9,17 +9,11 @@ module Vident
       super(*args, implied_controller: implied_controller)
     end
 
-    def to_s
-      @selector
-    end
+    def to_s = @selector
 
-    def data_attribute_name
-      "#{@controller}-#{@outlet_name}-outlet"
-    end
+    def data_attribute_name = "#{@controller}-#{@outlet_name}-outlet"
 
-    def data_attribute_value
-      @selector
-    end
+    def data_attribute_value = @selector
 
     private
 
@@ -67,8 +61,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/stimulus_outlet_collection.rb

@@ -5,11 +5,7 @@ module Vident
     def to_h
       return {} if items.empty?
 
-      merged = {}
-      items.each do |outlet|
-        merged.merge!(outlet.to_h)
-      end
-      merged
+      items.each_with_object({}) { |outlet, merged| merged.merge!(outlet.to_h) }
     end
   end
 end

data/lib/vident/stimulus_param.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Vident
+  # `data-<controller>-<name>-param="..."` — readable on the JS side as
+  # `event.params.<camelName>`. Element-scoped: every action on the element
+  # sees the same params.
+  class StimulusParam < StimulusAttributeBase
+    attr_reader :controller, :param_name, :value
+
+    def to_s = @value.to_s
+
+    def data_attribute_name = "#{@controller}-#{@param_name}-param"
+
+    def data_attribute_value = @value
+
+    private
+
+    def parse_arguments(*args)
+      case args.size
+      when 2 then parse_two_arguments(*args)
+      when 3 then parse_three_arguments(*args)
+      else raise ArgumentError, "Invalid number of arguments: #{args.size} (#{args.inspect}). Did you pass an array of hashes?"
+      end
+    end
+
+    def parse_two_arguments(param_name, value)
+      raise ArgumentError, "Invalid argument types: #{param_name.class}, #{value.class}" unless param_name.is_a?(Symbol)
+      @controller = implied_controller_name
+      @param_name = param_name.to_s.dasherize
+      @value = serialize_value(value)
+    end
+
+    def parse_three_arguments(controller, param_name, value)
+      unless controller.is_a?(String) && param_name.is_a?(Symbol)
+        raise ArgumentError, "Invalid argument types: #{controller.class}, #{param_name.class}, #{value.class}"
+      end
+      @controller = stimulize_path(controller)
+      @param_name = param_name.to_s.dasherize
+      @value = serialize_value(value)
+    end
+  end
+end

data/lib/vident/stimulus_param_collection.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Vident
+  class StimulusParamCollection < StimulusCollectionBase
+    def to_h
+      return {} if items.empty?
+
+      items.each_with_object({}) { |param, merged| merged.merge!(param.to_h) }
+    end
+  end
+end

data/lib/vident/stimulus_target.rb

@@ -4,19 +4,13 @@ module Vident
   class StimulusTarget < StimulusAttributeBase
     attr_reader :controller, :name
 
-    def to_s
-      @name
-    end
+    def to_s = @name
 
     # Returns the data attribute name for this target
-    def data_attribute_name
-      "#{@controller}-target"
-    end
+    def data_attribute_name = "#{@controller}-target"
 
     # Returns the target name value for the data attribute
-    def data_attribute_value
-      @name
-    end
+    def data_attribute_value = @name
 
     private
 
@@ -33,14 +27,10 @@ module Vident
 
     def parse_single_argument(arg)
       @controller = implied_controller_name
-      if arg.is_a?(Symbol)
-        # 1 symbol arg, name of target on implied controller
-        @name = js_name(arg)
-      elsif arg.is_a?(String)
-        # 1 string arg, assume it's a target name on implied controller
-        @name = arg
-      else
-        raise ArgumentError, "Invalid argument type: #{arg.class}"
+      @name = case arg
+      when Symbol then js_name(arg)  # name of target on implied controller
+      when String then arg           # target name on implied controller
+      else raise ArgumentError, "Invalid argument type: #{arg.class}"
       end
     end
 

data/lib/vident/stimulus_target_collection.rb

@@ -8,12 +8,8 @@ module Vident
       merged = {}
       items.each do |target|
         target.to_h.each do |key, value|
-          merged[key] = if merged.key?(key)
-            # Merge space-separated values for same target attribute
-            "#{merged[key]} #{value}"
-          else
-            value
-          end
+          # Merge space-separated values for same target attribute
+          merged[key] = merged.key?(key) ? "#{merged[key]} #{value}" : value
         end
       end
       merged

data/lib/vident/stimulus_value.rb

@@ -1,69 +1,39 @@
 # frozen_string_literal: true
 
-require "json"
-
 module Vident
   class StimulusValue < StimulusAttributeBase
     attr_reader :controller, :value_name, :value
 
-    def to_s
-      @value.to_s
-    end
+    def to_s = @value.to_s
 
-    def data_attribute_name
-      "#{@controller}-#{@value_name}-value"
-    end
+    def data_attribute_name = "#{@controller}-#{@value_name}-value"
 
-    def data_attribute_value
-      @value
-    end
+    def data_attribute_value = @value
 
     private
 
     def parse_arguments(*args)
       case args.size
-      when 2
-        parse_two_arguments(args[0], args[1])
-      when 3
-        parse_three_arguments(args[0], args[1], args[2])
-      else
-        raise ArgumentError, "Invalid number of arguments: #{args.size} (#{args.inspect}). Did you pass an array of hashes?"
+      when 2 then parse_two_arguments(*args)
+      when 3 then parse_three_arguments(*args)
+      else raise ArgumentError, "Invalid number of arguments: #{args.size} (#{args.inspect}). Did you pass an array of hashes?"
       end
     end
 
     def parse_two_arguments(value_name, value)
-      if value_name.is_a?(Symbol)
-        # value name on implied controller + value
-        @controller = implied_controller_name
-        @value_name = value_name.to_s.dasherize
-        @value = serialize_value(value)
-      else
-        raise ArgumentError, "Invalid argument types: #{value_name.class}, #{value.class}"
-      end
+      raise ArgumentError, "Invalid argument types: #{value_name.class}, #{value.class}" unless value_name.is_a?(Symbol)
+      @controller = implied_controller_name
+      @value_name = value_name.to_s.dasherize
+      @value = serialize_value(value)
     end
 
     def parse_three_arguments(controller, value_name, value)
-      if controller.is_a?(String) && value_name.is_a?(Symbol)
-        # controller + value name + value
-        @controller = stimulize_path(controller)
-        @value_name = value_name.to_s.dasherize
-        @value = serialize_value(value)
-      else
+      unless controller.is_a?(String) && value_name.is_a?(Symbol)
         raise ArgumentError, "Invalid argument types: #{controller.class}, #{value_name.class}, #{value.class}"
       end
-    end
-
-    def serialize_value(value)
-      case value
-      when Array, Hash
-        value.to_json
-      when TrueClass, FalseClass
-        value.to_s
-      when Numeric
-        value.to_s
-      else
-        value.to_s
-      end
+      @controller = stimulize_path(controller)
+      @value_name = value_name.to_s.dasherize
+      @value = serialize_value(value)
     end
   end
 end

data/lib/vident/stimulus_value_collection.rb

@@ -5,11 +5,7 @@ module Vident
     def to_h
       return {} if items.empty?
 
-      merged = {}
-      items.each do |value|
-        merged.merge!(value.to_h)
-      end
-      merged
+      items.each_with_object({}) { |value, merged| merged.merge!(value.to_h) }
     end
   end
 end

data/lib/vident/tailwind.rb

@@ -16,8 +16,6 @@ module Vident
     # Check if TailwindMerge gem is available
     def tailwind_merge_available?
       defined?(::TailwindMerge::Merger) && ::TailwindMerge::Merger.respond_to?(:new)
-    rescue NameError
-      false
     end
   end
 end

data/lib/vident/version.rb

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

data/lib/vident.rb

@@ -1,17 +1,5 @@
 # frozen_string_literal: true
 
-if ENV["COVERAGE"]
-  require "simplecov"
-  SimpleCov.command_name "Vident"
-  SimpleCov.root File.expand_path("..", __dir__)
-  SimpleCov.start do
-    add_filter "/test/"
-    add_filter "/tmp/"
-    add_filter "/bin/"
-    add_filter "/lib/vident/engine.rb"
-  end
-end
-
 require "active_support"
 require "active_support/concern"
 require "literal"
@@ -19,12 +7,14 @@ require "literal"
 require "vident/version"
 require "vident/tailwind"
 
+require "vident/stimulus_null"
 require "vident/stimulus_attribute_base"
 require "vident/stimulus_controller"
 require "vident/stimulus_action"
 require "vident/stimulus_target"
 require "vident/stimulus_outlet"
 require "vident/stimulus_value"
+require "vident/stimulus_param"
 require "vident/stimulus_class"
 
 require "vident/stimulus_collection_base"
@@ -33,12 +23,17 @@ require "vident/stimulus_action_collection"
 require "vident/stimulus_target_collection"
 require "vident/stimulus_outlet_collection"
 require "vident/stimulus_value_collection"
+require "vident/stimulus_param_collection"
 require "vident/stimulus_class_collection"
 
+require "vident/stimulus/primitive"
+require "vident/stimulus/naming"
+require "vident/stimulus"
+
 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"