vident-phlex 1.0.0.alpha1 → 1.0.0.alpha2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 54ed2508614f1ef6b15cc46ca5b7367ce13b7b391da9c2f36fb6605fa273e20e
-  data.tar.gz: 7f0f214d642cfa83cf4b0ef14e46a5a5c77aadacaa3280abbd821f2eb5ec7c2d
+  metadata.gz: cc97ececf338ced9e9cd73a395c80c804e0ea529b34afa31db131005d7b7fcf9
+  data.tar.gz: 6b40bb7b3618a0fdec455291107d0ef5d5ea62c44d1c12234a1b7f3d843fac82
 SHA512:
-  metadata.gz: 122bd2aefffeb7fa508c765a25166360c503762043f47e1e33609f479b1fd41f50b9e7ab0e3290ae60ba522919333c2ec8ec1f3eed121e1965c38f432239018f
-  data.tar.gz: 490063b45c857b3155b0bc8631daba6d499ea6feab88aa6e35abc5e3be61de1b68e24a40988735392981930ee452b07b040e47b5d2d07159401f4cf2e7f51fe8
+  metadata.gz: f3085a8b4c11321ba8ebf8130cbea930acfc4f49bfe4fa71f9bce52b88b2c62f3b0774c10349e88f7bb9d9729398b08fe49f6561a31da470ff1ec22b81e5b764
+  data.tar.gz: 9cea997b9f59aaf9abc40c812cce5b8f985b5dbe0a79fd56d36eb5cb4056b582ce1d635b6a88a316a5cc288ca3f5d126d4ae8fae8dc65bef43932255f37aa8fd

data/CHANGELOG.md

@@ -5,7 +5,17 @@ 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.alpha1] - 2025-07-04
+
+## [1.0.0.alpha2] - 2025-07-08
+
+### Breaking
+- `nil` values in Stimulus values are ok, but `nil` for an action/target/outlet makes no sense so is ignored.
+
+### Fixed
+
+- `stimulus_scoped_event` must return a Symbol to work with `stimulus_action` and `stimulus_target` methods etc.
+
+## [1.0.0.alpha1] - 2025-07-08
 
 This release is a major overhaul of the Vident library, and introduces a new API for defining components and Stimulus attributes. The new API is designed to be more consistent and easier to use.
 

data/README.md

@@ -90,8 +90,10 @@ class ButtonComponent < Vident::ViewComponent::Base
   end
 
   def call
-    root_element do
-      @text
+    root_element do |component|
+      component.tag(:span, stimulus_target: :status) do
+        @text
+      end
     end
   end
 
@@ -130,14 +132,19 @@ export default class extends Controller {
     loadingDuration: Number 
   }
   static classes = ["loading"]
+  static targets = ["status"]
   
   handleClick(event) {
     // Increment counter
     this.clickedCountValue++
     
+    // Store original text
+    const originalText = this.statusTarget.textContent
+    
     // Add loading state
     this.element.classList.add(this.loadingClass)
     this.element.disabled = true
+    this.statusTarget.textContent = "Loading..."
     
     // Use the loading duration from the component
     setTimeout(() => {
@@ -145,7 +152,7 @@ export default class extends Controller {
       this.element.disabled = false
       
       // Update text to show count
-      this.element.textContent = `${this.element.textContent} (${this.clickedCountValue})`
+      this.statusTarget.textContent = `${originalText} (${this.clickedCountValue})`
     }, this.loadingDurationValue)
   }
 }
@@ -178,7 +185,7 @@ The rendered HTML includes all Stimulus data attributes:
         data-button-component-loading-duration-value="1000"
         data-button-component-loading-class="opacity-50 cursor-wait"
         id="button-component-123">
-  Save
+  <span data-button-component-target="status">Save</span>
 </button>
 
 <!-- Second button with pre-set count -->
@@ -189,7 +196,7 @@ The rendered HTML includes all Stimulus data attributes:
         data-button-component-loading-duration-value="1000"
         data-button-component-loading-class="opacity-50 cursor-wait"
         id="button-component-456">
-  Submit
+  <span data-button-component-target="status">Submit</span>
 </button>
 ```
 
@@ -218,6 +225,29 @@ class CardComponent < Vident::ViewComponent::Base
 end
 ```
 
+### Post-Initialization Hooks
+
+Vident provides a hook for performing actions after component initialization:
+
+```ruby
+class MyComponent < Vident::ViewComponent::Base
+  prop :data, Hash, default: -> { {} }
+  
+  def after_component_initialize
+    @processed_data = process_data(@data)
+  end
+  
+  private
+  
+  def process_data(data)
+    # Your initialization logic here
+    data.transform_values(&:upcase)
+  end
+end
+```
+
+**Important**: If you decide to override Literal's `after_initialize`, you **must** call `super` first to ensure Vident's initialization completes properly. Alternatively, use `after_component_initialize` which doesn't require calling `super`.
+
 ### Built-in Properties
 
 Every Vident component includes these properties:
@@ -389,7 +419,7 @@ Vident provides helper methods to generate scoped event names for dispatching cu
 class MyComponent < Vident::ViewComponent::Base
   stimulus do
     # Define an action that responds to a scoped event
-    actions [stimulus_scoped_event_on_window(:data_loaded), :handle_data_loaded]
+    actions -> { [stimulus_scoped_event_on_window(:data_loaded), :handle_data_loaded] }
   end
   
   def handle_click

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vident-phlex
 version: !ruby/object:Gem::Version
-  version: 1.0.0.alpha1
+  version: 1.0.0.alpha2
 platform: ruby
 authors:
 - Stephen Ierodiaconou
@@ -55,14 +55,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0.alpha1
+        version: 1.0.0.alpha2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0.alpha1
+        version: 1.0.0.alpha2
 - !ruby/object:Gem::Dependency
   name: phlex
   requirement: !ruby/object:Gem::Requirement