vident-phlex 1.0.0.alpha2 → 1.0.0.alpha3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc97ececf338ced9e9cd73a395c80c804e0ea529b34afa31db131005d7b7fcf9
-  data.tar.gz: 6b40bb7b3618a0fdec455291107d0ef5d5ea62c44d1c12234a1b7f3d843fac82
+  metadata.gz: 690fe9845d80be2c5204bd6ca64df999e7969d89e9c7c5ca9be48c5d8641a625
+  data.tar.gz: d5499b956b2c5433144fc33a98a3212d5285706487d57ac39772d704d0058f17
 SHA512:
-  metadata.gz: f3085a8b4c11321ba8ebf8130cbea930acfc4f49bfe4fa71f9bce52b88b2c62f3b0774c10349e88f7bb9d9729398b08fe49f6561a31da470ff1ec22b81e5b764
-  data.tar.gz: 9cea997b9f59aaf9abc40c812cce5b8f985b5dbe0a79fd56d36eb5cb4056b582ce1d635b6a88a316a5cc288ca3f5d126d4ae8fae8dc65bef43932255f37aa8fd
+  metadata.gz: 80d00c3523e9ec7fcbc5a412201f011ecee809cb31df470e5f84d63e7409174817cc507941e149242ef5a9fbe7b20c86e09d6f53d95e69841c3e718c7cd13922
+  data.tar.gz: 2b7b789d4233806eb1b036da69054d307df7450e6930d1302557b1a70d7437cb253f61271b096fcdf3c77a4c8dcab0f492b34631618458fd14edecb1fb063a51

data/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## [1.0.0.alpha3] - 2025-07-21
+
+### Breaking
+- `element_classes` is now `root_element_classes` to make more consistent with the other root element methods.
+
+### Added
+
+-`.prop_names` and `#prop_values` methods to `Vident::Component` to return the names and values of the component's properties.
 
 ## [1.0.0.alpha2] - 2025-07-08
 

data/README.md

@@ -76,21 +76,23 @@ class ButtonComponent < Vident::ViewComponent::Base
   
   # Configure Stimulus integration
   stimulus do
-    actions [:click, :handle_click]
-    # Static values
-    values loading_duration: 1000
+    # Setup actions, including with proc to evaluate on instance 
+    actions [:click, :handle_click], 
+            -> { [stimulus_scoped_event(:my_custom_event), :handle_this] if should_handle_this? }
     # Map the clicked_count prop as a Stimulus value
     values_from_props :clicked_count
     # Dynamic values using procs (evaluated in component context)
-    values item_count: -> { @items.count }
-    values api_url: -> { Rails.application.routes.url_helpers.api_items_path }
+    values item_count: -> { @items.count },
+           api_url: -> { Rails.application.routes.url_helpers.api_items_path },
+           loading_duration: 1000 # or set static values
     # Static and dynamic classes
-    classes loading: "opacity-50 cursor-wait"
-    classes size: -> { @items.count > 10 ? "large" : "small" }
+    classes loading: "opacity-50 cursor-wait",
+            size: -> { @items.count > 10 ? "large" : "small" }
   end
 
   def call
     root_element do |component|
+      # Wire up targets etc
       component.tag(:span, stimulus_target: :status) do
         @text
       end
@@ -99,6 +101,7 @@ class ButtonComponent < Vident::ViewComponent::Base
 
   private
 
+  # Configure your components root HTML element
   def root_element_attributes
     {
       element_tag: @url ? :a : :button,
@@ -106,7 +109,8 @@ class ButtonComponent < Vident::ViewComponent::Base
     }
   end
 
-  def element_classes
+  # optionally add logic to determine initial classes
+  def root_element_classes
     base_classes = "btn"
     case @style
     when :primary
@@ -263,7 +267,7 @@ The `root_element` helper method renders your component's root element with all
 
 ```ruby
 # In your component class
-def element_classes
+def root_element_classes
   ["card", featured? ? "card-featured" : nil]
 end
 
@@ -619,7 +623,7 @@ class StyledComponent < Vident::ViewComponent::Base
   private
   
   # Classes on the root element
-  def element_classes
+  def root_element_classes
     ["base-class", variant_class]
   end
   
@@ -653,7 +657,7 @@ class TailwindComponent < Vident::ViewComponent::Base
   
   private
   
-  def element_classes
+  def root_element_classes
     # Conflicts with size_class will be resolved automatically
     "p-2 text-sm #{size_class}"
   end

data/lib/vident/phlex/html.rb

@@ -26,20 +26,20 @@ module Vident
       end
 
       # Helper to create the main element
-      def root_element(&block)
+      def root_element(**overrides, &block)
         tag_type = root_element_tag_type
         check_valid_html_tag!(tag_type)
         # Evaluate before generating the outer tag options to ensure DSL methods are executed
         if block_given?
           content = capture(self, &block).html_safe
-          options = root_element_tag_options
+          options = resolve_root_element_attributes_before_render(overrides)
           if content
             send(tag_type, **options) { content }
           else
             send(tag_type, **options)
           end
         else
-          send(tag_type, **root_element_tag_options)
+          send(tag_type, **resolve_root_element_attributes_before_render(overrides))
         end
       end
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: vident-phlex
 version: !ruby/object:Gem::Version
-  version: 1.0.0.alpha2
+  version: 1.0.0.alpha3
 platform: ruby
 authors:
 - Stephen Ierodiaconou
 bindir: bin
 cert_chain: []
-date: 2025-07-08 00:00:00.000000000 Z
+date: 2025-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties
@@ -55,14 +55,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0.alpha2
+        version: 1.0.0.alpha3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0.alpha2
+        version: 1.0.0.alpha3
 - !ruby/object:Gem::Dependency
   name: phlex
   requirement: !ruby/object:Gem::Requirement