vident-phlex 1.0.0 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a941674bbc07885fbd2a26849332fc6e6957a22feb5162b9cee454746d8205c
-  data.tar.gz: '0912a7ad696343c5437056344b51822e4e9af4b2dbca92ea78c805b2e3039567'
+  metadata.gz: 685f521dd022b3123897a08683295cb84787192a4aabecbd3927843a43d6c668
+  data.tar.gz: d25cfb1546470d6736b869d0ed54f310fef6e72dc9ed3018265bb4869dddd713
 SHA512:
-  metadata.gz: 3331181090bf6dc0edf13b515f71881e570b453c7655c991414a3ae1c49965cbaacb40597e5484fe1316ab298e8af4aa6051efd4a4f63c38f6d880200ed8273b
-  data.tar.gz: 85c1212c4e9ee24e021cf9192bbe78134723243da8a5e45d2163eba243abc180f10169a41133dc2a51078f9f289223442d3b1d2c4c6fc89b6471e16fce0aefee
+  metadata.gz: 16be0de4f984e20dc00184a79af7eb3519713c0bee72cae4e7d768434d77cfd6c4aef1241c71a15008634f47b4016b3ec40d7df216f3980880eb261802953e5e
+  data.tar.gz: 13a4a6bfdde8e2f998a46af8cc5084cc5acc388489cbb46784db850b2c346244e3c726acb150eba7639abec0d6e73d1e7e7a5effd33cc80426eecd255d8d9682

data/CHANGELOG.md

@@ -6,6 +6,17 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
 
+## [1.0.2] - 2026-04-21
+
+### Changed
+
+- Stimulus DSL procs (`values foo: -> { ... }`, `actions -> { ... }`, etc.) now resolve at **render time** — Phlex's `before_template` for `Vident::Phlex::HTML`, ViewComponent's `before_render` for `Vident::ViewComponent::Base` — instead of in `after_initialize`. Procs can now reach `helpers` / `view_context`, so they can call Rails helpers (`number_with_precision`, `t`, `l`, url helpers, etc.). Non-proc DSL entries still land in the collections at init time, so `after_component_initialize` mutators and external readers see them in the same order as before.
+
+### Added
+
+- `phlex_helpers :name1, :name2, ...` class macro on `Vident::Phlex::HTML` — opts the component into Phlex's per-helper Rails adapters (`Phlex::Rails::Helpers::<CamelCase>`) so DSL procs can call helpers bare (`number_with_precision(@amount, precision: 2)`) instead of via the deprecated `helpers.<method>`. Unknown helper names raise `ArgumentError` at class definition.
+
+
 ## [1.0.0] - 2026-04-19
 
 ### Breaking
@@ -36,6 +47,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 - `Vident::StimulusController`'s `implied_controller_path` / `implied_controller_name` overrides now raise the same `ArgumentError` as the base when `implied_controller` is nil, instead of a confusing `NoMethodError`.
 - `stimulus_values:` and `stimulus_classes:` props now accept cross-controller entries. The type unions include `Array` (matching `stimulus_actions:`/`stimulus_targets:`), and the collection parsers pass through pre-built `StimulusValue`/`StimulusValueCollection` (and class equivalents) instead of re-wrapping them into the single-value constructor and raising `ArgumentError: Invalid number of arguments` (#23).
 - `Vident::ComponentClassLists#class_list_builder` no longer memoises the `ClassListBuilder` instance. The first caller's `root_element_html_class:` was previously latched into the cached builder, which silently dropped the `class:` argument passed to a later `root_element(class: …)` whenever `class_list_for_stimulus_classes(:name)` ran first. The underlying `TailwindMerge::Merger` is still thread-cached, so the re-construction cost is negligible.
+- `Vident::ComponentClassLists#class_list_for_stimulus_classes` no longer leaks root element classes (component name, `root_element_classes`, etc.) into its return value. It previously reused the shared `class_list_builder`, whose `ClassListBuilder` is initialised with all root-element class sources baked in; `build` always prepends those, so child elements received the full root class soup instead of just the named Stimulus class CSS. Fix: build from a fresh `ClassListBuilder` with no root-element sources.
 
 ## [1.0.0.beta2] - 2026-04-16
 

data/README.md

@@ -415,7 +415,10 @@ class DynamicComponent < Vident::ViewComponent::Base
 end
 ```
 
-Procs have access to instance variables, component methods, and Rails helpers.
+Procs have access to instance variables and component methods. They run at render time (Phlex `before_template` / ViewComponent `before_render`), so they can reach the view context:
+
+- **Phlex**: `helpers` is deprecated in phlex-rails. Opt in per Rails helper by including the matching adapter — e.g. `include Phlex::Rails::Helpers::NumberWithPrecision` — and call the helper bare (`number_with_precision(@amount, precision: 2)`) inside the proc. Vident ships a `phlex_helpers :number_with_precision, :t, :l` class macro on `Vident::Phlex::HTML` that does the right include for each name. See [phlex.fun/rails/helpers](https://www.phlex.fun/rails/helpers) for the full list of adapters.
+- **ViewComponent**: call `helpers.<method>` or `view_context.<method>` directly.
 
 **Important**: Each proc returns a single value for its corresponding stimulus attribute. If a proc returns an array, that entire array is treated as a single value, not multiple separate values. To provide multiple values for an attribute, use multiple procs or mix procs with static values:
 

data/lib/vident/phlex/html.rb

@@ -23,6 +23,25 @@ module Vident
           raise StandardError, "No component source file exists #{path}" unless path && ::File.exist?(path)
           ::File.mtime(path).to_i.to_s
         end
+
+        # Include the matching `Phlex::Rails::Helpers::<CamelCase>` module for
+        # each Rails helper name. Replaces `helpers.foo(...)` with bare `foo(...)`
+        # calls via phlex-rails' adapter macros.
+        #
+        #   class Card < Vident::Phlex::HTML
+        #     phlex_helpers :number_with_precision, :t, :l
+        #   end
+        def phlex_helpers(*helper_names)
+          helper_names.each do |name|
+            mod_name = name.to_s.camelize
+            mod = begin
+              ::Phlex::Rails::Helpers.const_get(mod_name)
+            rescue NameError
+              raise ArgumentError, "No Phlex::Rails::Helpers::#{mod_name} adapter. See https://www.phlex.fun/rails/helpers for the available list."
+            end
+            include(mod)
+          end
+        end
       end
 
       # Helper to create the main element
@@ -39,6 +58,13 @@ module Vident
         end
       end
 
+      # Phlex lifecycle hook: resolve stimulus DSL procs now that the view
+      # context is wired (so `helpers` / `view_context` work inside them).
+      def before_template(&)
+        resolve_stimulus_attributes_at_render_time
+        super
+      end
+
       private
 
       def check_valid_html_tag!(tag_name)

metadata

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