vident 3.0.0 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad2b06ce20d99e816db5362f70a9ef4e068c9f6452d629253eb2283efc7e4b7e
-  data.tar.gz: 5d91a89eef5349d1ba7922875cef900c696684d2a627a5c958a7f5ed5d237ba9
+  metadata.gz: 8273577ce2815171e9bfbf610942f55aa5a898bd99501120337d984ca2aa69a6
+  data.tar.gz: 419e5282ed761f30d81173126985a9438be98575f130100f29279bfcbfbfca79
 SHA512:
-  metadata.gz: 19e30e85766415738689f4a746ade4c21fe4d649b83212f2f8cfeb829e93a4b7109d625ad46fb3391446afb9e7b6865a9542a78bac1be4f2cfca3644769b7902
-  data.tar.gz: f4f93452b54d1971ea135a39eb079f4a3e559b5057400154dbaf5998a2e22c072c70f6dd7cf786c14648de891ebeca2b959a5a9be670b7c8ea70a5249e91e207
+  metadata.gz: a009432e990316030f91efc0762a6a1a3b575061fd600c75eb046a8cdc8ffb2e1b1d5422b040fde2dccb861029d933bb1d762cf3943e7fc2cde6309301a42acc
+  data.tar.gz: 7d1f36e57e431b895ebd7bbd5175940aad3ef80651a6401fc7d17fcb624f01ad8e4d4953a68ff85e87685f66d86c8d8da7c81bb1f6cdaabd1b5bf0890636ee4f

data/CHANGELOG.md

@@ -6,6 +6,13 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
 
+## [3.1.0] - 2026-05-26
+
+### Added
+
+- Cross-controller parser forms accept a component class (or instance) wherever they accept a controller-path String — e.g. `stimulus_target: [Row, :summary]`, `stimulus_controllers: [Row]`, `stimulus_action: [:click, Row, :toggle]` — so references to another component's controller stay refactor-safe instead of hard-coded identifier strings. The same holds for the class-level builders (`Parent.stimulus_target(Row, :summary)`); the String cross-controller form is still rejected there.
+
+
 ## [3.0.0] - 2026-05-04
 
 A bare `String` now means the same thing across every Stimulus primitive — a controller path. The 2.x ambiguity where a `String` could variously mean controller path, outlet name, CSS selector, or fully-qualified action descriptor (depending on primitive and position) is gone, closing a class of silent-failure footguns. See `UPGRADING.md` "Upgrading to Vident 3.0" for symptom → fix on each breaking change.

data/README.md

@@ -602,7 +602,7 @@ class CustomComponent < Vident::ViewComponent::Base
 end
 ```
 
-All stimulus props accept Symbol paths as well as Strings (e.g. `stimulus_controllers: [:custom, :"admin/users"]`). `stimulus_values:` and `stimulus_classes:` additionally accept Array entries (for cross-controller: `[["admin/users", :name, "value"]]`) and pre-built `Vident::Stimulus::Value` / `Vident::Stimulus::ClassMap` instances, so you can compose attribute sets outside the component and pass them in.
+All stimulus props accept Symbol paths as well as Strings (e.g. `stimulus_controllers: [:custom, :"admin/users"]`). `stimulus_values:` and `stimulus_classes:` additionally accept Array entries (for cross-controller: `[["admin/users", :name, "value"]]`) and pre-built `Vident::Stimulus::Value` / `Vident::Stimulus::ClassMap` instances, so you can compose attribute sets outside the component and pass them in. Anywhere a controller-path String is accepted in a cross-controller slot you may pass the component class (or instance) instead — `[OtherComponent, :name, "value"]`, `stimulus_controllers: [OtherComponent]`, `stimulus_target: [OtherComponent, :row]` — which keeps the reference refactor-safe rather than a hard-coded identifier string.
 
 or you can use tag helpers to generate HTML with Stimulus attributes:
 

data/lib/vident/stimulus/action.rb

@@ -40,13 +40,13 @@ module Vident
             method_name: Naming.js_name(method_sym),
             event: event.to_s
           )
-        in [String => ctrl_path, Symbol => method_sym]
+        in [ctrl_path, Symbol => method_sym] if Controller.path_arg?(ctrl_path)
           new(
             controller: Controller.parse(ctrl_path, implied: implied),
             method_name: Naming.js_name(method_sym),
             event: nil
           )
-        in [Symbol => event, String => ctrl_path, Symbol => method_sym]
+        in [Symbol => event, ctrl_path, Symbol => method_sym] if Controller.path_arg?(ctrl_path)
           new(
             controller: Controller.parse(ctrl_path, implied: implied),
             method_name: Naming.js_name(method_sym),

data/lib/vident/stimulus/class_map.rb

@@ -22,7 +22,7 @@ module Vident
             name: name_sym.to_s.dasherize,
             css: normalize_css(css_input)
           )
-        in [String => ctrl_path, Symbol => name_sym, css_input]
+        in [ctrl_path, Symbol => name_sym, css_input] if Controller.path_arg?(ctrl_path)
           new(
             controller: Controller.parse(ctrl_path, implied: implied),
             name: name_sym.to_s.dasherize,

data/lib/vident/stimulus/controller.rb

@@ -18,13 +18,25 @@ module Vident
           new(path: implied.path, name: implied.name, alias_name: as)
         when 1
           raw = args[0]
-          path = raw.to_s
-          new(path: path, name: Naming.stimulize_path(path), alias_name: as)
+          if raw.respond_to?(:stimulus_identifier)
+            name = raw.stimulus_identifier
+            path = raw.respond_to?(:stimulus_identifier_path) ? raw.stimulus_identifier_path : name
+            new(path: path, name: name, alias_name: as)
+          else
+            path = raw.to_s
+            new(path: path, name: Naming.stimulize_path(path), alias_name: as)
+          end
         else
           raise ::Vident::ParseError, "Controller.parse: expected 0 or 1 positional args, got #{args.size}"
         end
       end
 
+      # Whether `value` is accepted in a cross-controller path slot: a path
+      # String, or a Vident component (class or instance) that names itself.
+      def self.path_arg?(value)
+        value.is_a?(String) || value.respond_to?(:stimulus_identifier)
+      end
+
       def identifier = name
 
       def to_s = name

data/lib/vident/stimulus/outlet.rb

@@ -34,14 +34,14 @@ module Vident
           new(controller: implied, name: sym.to_s.dasherize, selector: sel.css)
         in [String => str, Selector => sel]
           new(controller: implied, name: Naming.stimulize_path(str), selector: sel.css)
-        in [String => parent_path, Symbol => child_sym]
+        in [parent_path, Symbol => child_sym] if Controller.path_arg?(parent_path)
           child_name = child_sym.to_s.dasherize
           new(
             controller: Controller.parse(parent_path, implied: implied),
             name: child_name,
             selector: auto_selector(child_name, component_id: component_id)
           )
-        in [String => parent_path, Symbol => child_sym, Selector => sel]
+        in [parent_path, Symbol => child_sym, Selector => sel] if Controller.path_arg?(parent_path)
           new(
             controller: Controller.parse(parent_path, implied: implied),
             name: child_sym.to_s.dasherize,

data/lib/vident/stimulus/param.rb

@@ -24,7 +24,7 @@ module Vident
             name: name_sym.to_s.dasherize,
             serialized: serialize(raw)
           )
-        in [String => ctrl_path, Symbol => name_sym, raw]
+        in [ctrl_path, Symbol => name_sym, raw] if Controller.path_arg?(ctrl_path)
           new(
             controller: Controller.parse(ctrl_path, implied: implied),
             name: name_sym.to_s.dasherize,

data/lib/vident/stimulus/target.rb

@@ -16,7 +16,7 @@ module Vident
         case args
         in [Symbol => sym]
           new(controller: implied, name: Naming.js_name(sym))
-        in [String => ctrl_path, Symbol => sym]
+        in [ctrl_path, Symbol => sym] if Controller.path_arg?(ctrl_path)
           new(
             controller: Controller.parse(ctrl_path, implied: implied),
             name: Naming.js_name(sym)

data/lib/vident/stimulus/value.rb

@@ -25,7 +25,7 @@ module Vident
             name: name_sym.to_s.dasherize,
             serialized: serialize(raw)
           )
-        in [String => ctrl_path, Symbol => name_sym, raw]
+        in [ctrl_path, Symbol => name_sym, raw] if Controller.path_arg?(ctrl_path)
           new(
             controller: Controller.parse(ctrl_path, implied: implied),
             name: name_sym.to_s.dasherize,

data/lib/vident/version.rb

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

data/skills/vident/SKILL.md

@@ -67,7 +67,7 @@ class DropdownComponent < ApplicationComponent
 end
 ```
 
-Cross-controller references elsewhere (actions/targets/values/classes/outlets) use the `"path/to/controller"` **string** form — Vident stimulizes it for you.
+Cross-controller references elsewhere (actions/targets/values/classes/outlets) take the controller in one of two forms: a `"path/to/controller"` **string** (Vident stimulizes it for you), or the **component class/instance** itself in that slot — `OtherComponent` in place of `"other_component"`. The component form is refactor-safe: rename the class and the reference follows, with no identifier string to drift.
 
 ### 1.2 Actions
 
@@ -118,6 +118,7 @@ The alias resolves at render time — unknown aliases raise `Vident::Declaration
 | `:my_thing`                                 | `implied#myThing` (no explicit event)              |
 | `[:click, :my_thing]`                       | `click->implied#myThing`                           |
 | `[:click, "other/ctrl", :my_thing]`         | `click->other--ctrl#myThing`                       |
+| `[:click, OtherCtrl, :my_thing]`            | same, via the component class (refactor-safe)      |
 | `"click->other--ctrl#myThing"`              | pass-through, parsed into its parts                |
 | `{event: :click, method: :submit, options: [:once, :prevent]}` | `click:once:prevent->implied#submit` |
 | `-> { [:click, :my_thing] if @editable }`   | proc, evaluated in component instance; `nil`/`false` returns drop the entry |
@@ -179,6 +180,7 @@ Vident `targets` DSL:
 | ------------------------------ | -------------------------------------------------- |
 | `:button`                      | `data-implied-target="button"` on the root         |
 | `["other/ctrl", :row]`         | `data-other--ctrl-target="row"` on the root        |
+| `[OtherCtrl, :row]`            | same, via the component class (refactor-safe)      |
 | Same shapes on `child_element` | `data-implied-target="..."` on the child           |
 
 ```ruby
@@ -224,6 +226,7 @@ end
 stimulus_values: [
   [:foo, "bar"],                        # implied-foo-value="bar"
   ["other/ctrl", :baz, 42],             # other--ctrl-baz-value="42"
+  [OtherCtrl, :baz, 42],                # same, via the component class
 ]
 ```
 

metadata

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