vident 0.10.0 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95a2b00a3176fdc3fbd06569b20665b3e1d1bc8032758b0945d2dc58990d2fa5
-  data.tar.gz: e946108732b2abd5af47e5437b13e72983838cad032fb6b5c4c460504dc4cf8c
+  metadata.gz: ea398d33c180c2198ac689bd70d6f830dc625f9e70fd17bd94cb1acbaa7ec690
+  data.tar.gz: 86b1e7379929fbbe3e5b83b9356debfa18490a9cca60599a1a7ecbd9537d97f7
 SHA512:
-  metadata.gz: 3fd4da39749c72675965bf507287db253b305a2203c29a323a6342fa593709c06480ce1a3671e6044b562503853b78c56ca9a698e5962217a4a1becf23a29722
-  data.tar.gz: 11e8f9e658bb2ff4459719a205ae13bcecb7f2c65b1e4d89edb718879d5a54fe947922c0328cf5c15b19f066d46695250a935599fa37fcfd8de0fbfb9e2975af
+  metadata.gz: 3e36f069043b62f9d300993e7be4d2cc8666aac6f782ee4ba04fd5efeaffe9ebd28ace5dbfd1022f90f515b253b9778d1123e516606fc20255b0d1bcb5a7bfe5
+  data.tar.gz: abf930b3b049e617544a8fe274b0c7deac1ad4f8226642d88fe120246fa0935b90cbcd3206480604290e2f2b9ff540dbf234ab72df8fb4051d8b6838cbecbc11

data/CHANGELOG.md

@@ -14,6 +14,23 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ### Fixed
 
+
+## [0.11.0] - 2024-02-21
+
+### Added
+
+- `outlet_host` DSL method to support components hooking themselves into a host component's outlets
+
+
+
+## [0.10.1] - 2024-02-21
+
+### Added
+
+- `outlets` option now accepts either a string stimulus controller identifier, a component instance, or a tuple of 
+  identifier and CSS selector for the outlet.
+
+
 ## [0.10.0] - 2024-02-21
 
 ### Added

data/lib/vident/base.rb

@@ -80,6 +80,11 @@ module Vident
       @id.presence || random_id
     end
 
+    # If connecting an outlet to this specific component instance, use this ID
+    def outlet_id
+      @outlet_id ||= [stimulus_identifier, "##{id}"]
+    end
+
     # Methods to use in component views
     # ---------------------------------
 
@@ -146,6 +151,7 @@ module Vident
         actions: attribute(:actions) + Array.wrap(options[:actions]),
         targets: attribute(:targets) + Array.wrap(options[:targets]),
         outlets: attribute(:outlets) + Array.wrap(options[:outlets]),
+        outlet_host: attribute(:outlet_host),
         named_classes: merge_stimulus_option(options, :named_classes),
         data_maps: prepare_stimulus_option(options, :data_maps)
       }
@@ -185,7 +191,7 @@ module Vident
     end
 
     def random_id
-      @random_id ||= "#{self.class.component_name}-#{StableId.next_id_in_sequence}"
+      @random_id ||= "#{component_class_name}-#{StableId.next_id_in_sequence}"
     end
 
     CLASSNAME_SEPARATOR = " "

data/lib/vident/component.rb

@@ -17,6 +17,7 @@ module Vident
       attribute :actions, default: [], delegates: false
       attribute :targets, default: [], delegates: false
       attribute :outlets, default: [], delegates: false
+      attribute :outlet_host, delegates: false
       attribute :data_maps, default: [], delegates: false
       attribute :named_classes, delegates: false
     end

data/lib/vident/root_component.rb

@@ -7,6 +7,7 @@ module Vident
       actions: nil,
       targets: nil,
       outlets: nil,
+      outlet_host: nil,
       named_classes: nil, # https://stimulus.hotwired.dev/reference/css-classes
       data_maps: nil,
       element_tag: nil,
@@ -23,6 +24,13 @@ module Vident
       @named_classes = named_classes
       @data_map_kvs = {}
       @data_maps = data_maps
+
+      outlet_host.connect_outlet(self) if outlet_host.respond_to?(:connect_outlet)
+    end
+
+    def connect_outlet(outlet)
+      @outlets ||= []
+      @outlets << outlet
     end
 
     # The view component's helpers for setting stimulus data-* attributes on this component.
@@ -61,6 +69,15 @@ module Vident
       build_target_data_attributes([target(name)])
     end
 
+    def outlet(css_selector: nil)
+      controller = implied_controller_name
+      if css_selector.nil?
+        [controller, "[data-controller~=#{controller}]"]
+      else
+        [controller, css_selector]
+      end
+    end
+
     # Getter for a named classes list so can be used in view to set initial state on SSR
     # Returns a String of classes that can be used in a `class` attribute.
     def named_classes(*names)
@@ -133,7 +150,21 @@ module Vident
 
     def outlet_list
       return {} unless @outlets&.size&.positive?
-      @outlets.each_with_object({}) { |o, obj| obj["#{implied_controller_name}-#{o.stimulus_identifier}-outlet"] = "[data-controller~=#{o.stimulus_identifier}]" }
+
+      @outlets.each_with_object({}) do |outlet_config, obj|
+        identifier, css_selector = if outlet_config.is_a?(String)
+          [outlet_config, "[data-controller~=#{outlet_config}]"]
+        elsif outlet_config.is_a?(Array)
+          outlet_config[..1]
+        elsif outlet_config.respond_to?(:stimulus_identifier) # Is a Component
+          [outlet_config.stimulus_identifier, "[data-controller~=#{outlet_config.stimulus_identifier}]"]
+        elsif outlet_config.send(:implied_controller_name) # Is a RootComponent ?
+          [outlet_config.send(:implied_controller_name), "[data-controller~=#{outlet_config.send(:implied_controller_name)}]"]
+        else
+          raise ArgumentError, "Invalid outlet config: #{outlet_config}"
+        end
+        obj[:"#{implied_controller_name}-#{identifier}-outlet"] = css_selector
+      end
     end
 
     # Actions can be specified as a symbol, in which case they imply an action on the primary
@@ -189,7 +220,7 @@ module Vident
     end
 
     def parse_attributes(attrs, controller = nil)
-      attrs.transform_keys { |k| "#{controller || implied_controller_name}-#{k}" }
+      attrs.transform_keys { |k| :"#{controller || implied_controller_name}-#{k}" }
     end
 
     def data_map_attributes
@@ -219,7 +250,7 @@ module Vident
 
     def build_named_classes_data_attributes(named_classes)
       parse_named_classes_hash(named_classes)
-        .map { |c| ["#{c[:controller]}-#{c[:name]}-class", c[:classes]] }
+        .map { |c| [:"#{c[:controller]}-#{c[:name]}-class", c[:classes]] }
         .to_h
     end
 

data/lib/vident/stable_id.rb

@@ -1,23 +1,32 @@
 # frozen_string_literal: true
 
+require "random/formatter"
+
 module Vident
   class StableId
     class << self
       def set_current_sequence_generator
         ::Thread.current[:vident_number_sequence_generator] = id_sequence_generator
       end
+      alias_method :new_current_sequence_generator, :set_current_sequence_generator
+
+      def clear_current_sequence_generator
+        ::Thread.current[:vident_number_sequence_generator] = nil
+      end
 
       def next_id_in_sequence
         generator = ::Thread.current[:vident_number_sequence_generator]
-        return "?" unless generator
+        # When no generator exists, use a random value. This means we loose the stability of the ID sequence but
+        # at least generate unique IDs for the current render.
+        return Random.hex(16) unless generator
         generator.next.join("-")
       end
 
       private
 
       def id_sequence_generator
-        number_generator = Random.new(296_865_628_524)
-        Enumerator.produce { number_generator.rand(10_000_000) }.with_index
+        number_generator = Random.new(42)
+        Enumerator.produce { number_generator.hex(16) }.with_index
       end
     end
   end

data/lib/vident/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Vident
-  VERSION = "0.10.0"
+  VERSION = "0.11.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vident
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.11.0
 platform: ruby
 authors:
 - Stephen Ierodiaconou