vident-view_component 1.0.1 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 225bfeb157d05dba1d6aa7d4dbbe953603a0f957bbc310bf5b403c364abe19ca
-  data.tar.gz: 7be1253854d4ebe732fefb896471e7d9f51df1b2adb5f27189f8d4ec186b3085
+  metadata.gz: a26bc51182683f0f1c47872ef57ac42c09ae59fa3262054bcfc0b37fd1a47e94
+  data.tar.gz: 83123c45e6c5faede7e27dd379321b6f276a0da31cb06b4d9d7d2cf6bb08a3ac
 SHA512:
-  metadata.gz: 19b8bcf6993c4c4d21ecfaa94ddc5349cb4c6cef29c11494d3cb1f48b4aab35faa08f99dda8801e1a5806d9149918ab836fef8579d39d1ccc5eb295c6c4a8251
-  data.tar.gz: df67b8477332e2742af34589189726dbb440edc3f6645b26e235ec37d6d594bb38aa86840cba0090d8e2e5c79b783c6a989a79bcb54f07eeae0e4f7a04e7de24
+  metadata.gz: 939ca07e39446a0c78ac91c3d12c9510cc8ccbb7b3a21c12e30d9d063522ffad82a99cb0cba0116f47d0c01f084d53dc20e2ede232836bf1e2315078012945ed
+  data.tar.gz: a78683a140e388cc584a5f497a54830ba99cb8b43c96a9691bcbf820e02eb567b33ac1c49aa80f81ffc1a33ae19b85c5b3b1df1596bb4475bf231667ebae6702

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

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/view_component/base.rb

@@ -41,6 +41,13 @@ module Vident
 
       SELF_CLOSING_TAGS = Set[:area, :base, :br, :col, :embed, :hr, :img, :input, :link, :meta, :param, :source, :track, :wbr].freeze
 
+      # ViewComponent lifecycle hook: resolve stimulus DSL procs now that
+      # `@view_context` is set (so `helpers` works inside them).
+      def before_render
+        resolve_stimulus_attributes_at_render_time
+        super
+      end
+
       def root_element(**overrides, &block)
         tag_type = root_element_tag_type
         child_content = view_context.capture(self, &block) if block_given? # Evaluate before generating the outer tag options to ensure DSL methods are executed

metadata

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