turbo_rspec 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7341e9dfd6be8235a2269e94ef9923e470aa5da675ccd52f8d507f42c3950398
-  data.tar.gz: 65f4f2bb0aa32c4032d4ba2daad8c9442e20d056b3a455b0937eaeaf380f924a
+  metadata.gz: cdd85fcc9f87814d171569e835ad85de4767daf48642d5797f15ac02decf4641
+  data.tar.gz: a92c047884633fd146aa6806dc350edef72bd18747c39e3da618feb12223a29e
 SHA512:
-  metadata.gz: b433e046578d5f3914a95cd443ed32020bff526bddf3bf79eea34ef7bc52a7ce06823ac25714f309842c357d97e0e70edd208b75a85c8e0a118e7d8b86b36c9f
-  data.tar.gz: 44d25746b61d50d932f74f92b2f6a07c50c70a6d320c452f302693b507617da38facf8fca1d0ac61f66cf01a49187e8288a20c6182b27cbe4ab91db42fe28ec5
+  metadata.gz: 7ecdc1dc0c21c083a32270e7ab085e31e5fd4e6afde0193c9f58a967e7d79aaf543387e874d8cc2fd4f1afdcb0b56a2b2b53b6c6a230f3d80a41736b68c5c01e
+  data.tar.gz: b12927d25812f2991d889a7cedc37fe02cf4feb439adc76555dcfc8d6fd31151f9dd5cd80257ec82057d350c52e607cc2206e924bf3b159257453de9fad4ced5

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [1.3.0] - 2026-06-02
+
+### Added
+
+- `have_stimulus_controller(name)` — Capybara matcher asserting `data-controller` contains the given controller name
+- `have_stimulus_action(descriptor)` — Capybara matcher asserting `data-action` contains the descriptor; accepts a full descriptor (`click->hello#greet`) or shorthand without event (`hello#greet`)
+- `have_stimulus_target(controller, target)` — Capybara matcher asserting `data-{controller}-target` contains the target name
+
 ## [1.2.0] - 2026-06-01
 
 ### Added

data/README.md

@@ -10,7 +10,7 @@ Drop-in test matchers for [hotwired/turbo-rails](https://github.com/hotwired/tur
 
 - **Request/controller specs** — `have_turbo_stream`, `have_turbo_frame`, `have_turbo_streams`
 - **Broadcast specs** — `have_broadcasted_turbo_stream_to` with count qualifiers
-- **System/feature specs** — Capybara matchers: `have_turbo_frame`, `have_turbo_stream_tag`, `within_turbo_frame`
+- **System/feature specs** — Capybara matchers: `have_turbo_frame`, `have_turbo_stream_tag`, `within_turbo_frame`, `have_stimulus_controller`, `have_stimulus_action`, `have_stimulus_target`
 - **Minitest** — `assert_turbo_stream`, `refute_turbo_stream`, `assert_turbo_frame`, `refute_turbo_frame`
 - **Factory helpers** — `turbo_stream_html`, `turbo_frame_html`
 - **Shared examples** — `it_behaves_like "a turbo stream response"`
@@ -236,6 +236,29 @@ within_turbo_frame("messages") do
 end
 ```
 
+### Stimulus matchers
+
+Assert Stimulus controller, action, and target attributes on the page (Capybara).
+
+```ruby
+# Controller — data-controller contains "hello"
+expect(page).to have_stimulus_controller("hello")
+
+# Action — full descriptor
+expect(page).to have_stimulus_action("click->hello#greet")
+
+# Action — shorthand without event (matches any event prefix)
+expect(page).to have_stimulus_action("hello#greet")
+
+# Target — data-hello-target contains "name"
+expect(page).to have_stimulus_target("hello", "name")
+
+# Negation
+expect(page).not_to have_stimulus_controller("missing")
+```
+
+All three matchers use space-separated token matching (`~=`), so they work correctly when multiple controllers, actions, or targets are declared on a single element.
+
 ### `have_turbo_stream_tag`
 
 Assert that a `<turbo-stream-source>` subscription element is on the page.

data/ROADMAP.md

@@ -4,10 +4,6 @@ RSpec matchers for [Turbo](https://github.com/hotwired/turbo-rails): Turbo Strea
 
 ---
 
-## 1.3 — Stimulus companion
-
-- **Stimulus matchers** — `have_stimulus_controller`, `have_stimulus_action`, `have_stimulus_target` Capybara matchers. turbo-rails ships with Stimulus; teams using both already test Stimulus behavior manually. This is the natural next surface area for a complete Hotwire testing toolkit.
-
 ## 1.4 — Tooling
 
 - **RuboCop cop** — flag request specs that assert `response.body` with a raw string match or `include "<turbo-stream"` instead of using the gem's matchers. Useful for migration and incremental adoption.

data/lib/turbo_rspec/capybara/matchers/have_stimulus_action.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module TurboRspec
+  module Capybara
+    module Matchers
+      # Capybara matcher asserting that an element with the given Stimulus
+      # action descriptor is present on the page (+data-action+ contains the
+      # descriptor as a space-separated token).
+      #
+      # Accepts either a full descriptor (+click->hello#greet+) or a shorthand
+      # without an event (+hello#greet+), which matches any event prefix.
+      #
+      # @example Full descriptor
+      #   expect(page).to have_stimulus_action("click->hello#greet")
+      #
+      # @example Shorthand (any event)
+      #   expect(page).to have_stimulus_action("hello#greet")
+      class HaveStimulusAction
+        def initialize(action_descriptor)
+          @action_descriptor = action_descriptor.to_s
+        end
+
+        def matches?(page_or_node)
+          page_or_node.has_css?(selector, wait: 0)
+        end
+
+        def does_not_match?(page_or_node)
+          page_or_node.has_no_css?(selector, wait: 0)
+        end
+
+        def failure_message
+          "expected page to have Stimulus action #{@action_descriptor.inspect}"
+        end
+
+        def failure_message_when_negated
+          "expected page not to have Stimulus action #{@action_descriptor.inspect}"
+        end
+
+        def description
+          "have Stimulus action #{@action_descriptor.inspect}"
+        end
+
+        private
+
+        def selector
+          if @action_descriptor.include?("->")
+            "[data-action~='#{@action_descriptor}']"
+          else
+            "[data-action*='#{@action_descriptor}']"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/turbo_rspec/capybara/matchers/have_stimulus_controller.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module TurboRspec
+  module Capybara
+    module Matchers
+      # Capybara matcher asserting that an element with the given Stimulus
+      # controller is present on the page (+data-controller+ contains the name
+      # as a space-separated token).
+      #
+      # @example
+      #   expect(page).to have_stimulus_controller("hello")
+      #   expect(page).not_to have_stimulus_controller("missing")
+      class HaveStimulusController
+        def initialize(controller_name)
+          @controller_name = controller_name.to_s
+        end
+
+        def matches?(page_or_node)
+          page_or_node.has_css?(selector, wait: 0)
+        end
+
+        def does_not_match?(page_or_node)
+          page_or_node.has_no_css?(selector, wait: 0)
+        end
+
+        def failure_message
+          "expected page to have Stimulus controller #{@controller_name.inspect}"
+        end
+
+        def failure_message_when_negated
+          "expected page not to have Stimulus controller #{@controller_name.inspect}"
+        end
+
+        def description
+          "have Stimulus controller #{@controller_name.inspect}"
+        end
+
+        private
+
+        def selector
+          "[data-controller~='#{@controller_name}']"
+        end
+      end
+    end
+  end
+end

data/lib/turbo_rspec/capybara/matchers/have_stimulus_target.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module TurboRspec
+  module Capybara
+    module Matchers
+      # Capybara matcher asserting that an element with the given Stimulus
+      # target is present on the page. Checks +data-{controller}-target+
+      # contains the target name as a space-separated token.
+      #
+      # @example
+      #   expect(page).to have_stimulus_target("hello", "name")
+      #   expect(page).not_to have_stimulus_target("hello", "missing")
+      class HaveStimulusTarget
+        def initialize(controller_name, target_name)
+          @controller_name = controller_name.to_s
+          @target_name = target_name.to_s
+        end
+
+        def matches?(page_or_node)
+          page_or_node.has_css?(selector, wait: 0)
+        end
+
+        def does_not_match?(page_or_node)
+          page_or_node.has_no_css?(selector, wait: 0)
+        end
+
+        def failure_message
+          "expected page to have Stimulus target #{@target_name.inspect} for controller #{@controller_name.inspect}"
+        end
+
+        def failure_message_when_negated
+          "expected page not to have Stimulus target #{@target_name.inspect} for controller #{@controller_name.inspect}"
+        end
+
+        def description
+          "have Stimulus target #{@target_name.inspect} for #{@controller_name.inspect}"
+        end
+
+        private
+
+        def selector
+          "[data-#{@controller_name}-target~='#{@target_name}']"
+        end
+      end
+    end
+  end
+end

data/lib/turbo_rspec/capybara/matchers.rb

@@ -2,6 +2,9 @@
 
 require_relative "matchers/have_turbo_frame"
 require_relative "matchers/have_turbo_stream_tag"
+require_relative "matchers/have_stimulus_controller"
+require_relative "matchers/have_stimulus_action"
+require_relative "matchers/have_stimulus_target"
 
 module TurboRspec
   module Capybara
@@ -14,6 +17,18 @@ module TurboRspec
         HaveTurboStreamTag.new(signed_stream_name: signed_stream_name)
       end
 
+      def have_stimulus_controller(controller_name)
+        HaveStimulusController.new(controller_name)
+      end
+
+      def have_stimulus_action(action_descriptor)
+        HaveStimulusAction.new(action_descriptor)
+      end
+
+      def have_stimulus_target(controller_name, target_name)
+        HaveStimulusTarget.new(controller_name, target_name)
+      end
+
       # :nocov:
       def within_turbo_frame(id, &block)
         page.within("turbo-frame##{id}", &block)

data/lib/turbo_rspec/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TurboRspec
-  VERSION = "1.2.0"
+  VERSION = "1.3.0"
 end

data/sig/turbo_rspec.rbs

@@ -127,6 +127,9 @@ module TurboRspec
     module Matchers
       def have_turbo_frame: (String id) -> HaveTurboFrame
       def have_turbo_stream_tag: (?String? signed_stream_name) -> HaveTurboStreamTag
+      def have_stimulus_controller: (String controller_name) -> HaveStimulusController
+      def have_stimulus_action: (String action_descriptor) -> HaveStimulusAction
+      def have_stimulus_target: (String controller_name, String target_name) -> HaveStimulusTarget
       def within_turbo_frame: (String id) { () -> void } -> void
 
       class HaveTurboFrame
@@ -146,6 +149,33 @@ module TurboRspec
         def description: () -> String
       end
 
+      class HaveStimulusController
+        def initialize: (String controller_name) -> void
+        def matches?: (untyped page_or_node) -> bool
+        def does_not_match?: (untyped page_or_node) -> bool
+        def failure_message: () -> String
+        def failure_message_when_negated: () -> String
+        def description: () -> String
+      end
+
+      class HaveStimulusAction
+        def initialize: (String action_descriptor) -> void
+        def matches?: (untyped page_or_node) -> bool
+        def does_not_match?: (untyped page_or_node) -> bool
+        def failure_message: () -> String
+        def failure_message_when_negated: () -> String
+        def description: () -> String
+      end
+
+      class HaveStimulusTarget
+        def initialize: (String controller_name, String target_name) -> void
+        def matches?: (untyped page_or_node) -> bool
+        def does_not_match?: (untyped page_or_node) -> bool
+        def failure_message: () -> String
+        def failure_message_when_negated: () -> String
+        def description: () -> String
+      end
+
       class HaveTurboStreamTag
         def initialize: (?signed_stream_name: String?) -> void
         def matches?: (untyped page_or_node) -> bool

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: turbo_rspec
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -54,6 +54,9 @@ files:
 - lib/turbo_rspec.rb
 - lib/turbo_rspec/assertions.rb
 - lib/turbo_rspec/capybara/matchers.rb
+- lib/turbo_rspec/capybara/matchers/have_stimulus_action.rb
+- lib/turbo_rspec/capybara/matchers/have_stimulus_controller.rb
+- lib/turbo_rspec/capybara/matchers/have_stimulus_target.rb
 - lib/turbo_rspec/capybara/matchers/have_turbo_frame.rb
 - lib/turbo_rspec/capybara/matchers/have_turbo_stream_tag.rb
 - lib/turbo_rspec/configuration.rb