stimulus_spec 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed3850b553fca15bb450d8ad6e0f50d37593c90bd440d26c6cbf0a8eb99882ea
-  data.tar.gz: a0b96c0888a87a93ef3db2e783d747642f09f863003c3f9a8fc43cc04ca4f392
+  metadata.gz: 016bc15660c32251a12c1c9129fa88c86a3e2ac1059949535a67cdd5d64448ce
+  data.tar.gz: 76277d4b548369259e6ae9f28b8ad2b4d22637659f7c13a938e5cf2fd95127e5
 SHA512:
-  metadata.gz: 0ee41b07ee4796f9670ec0a805ff0b6f52179fddc5cec9169f8272d65bc1bf6c7b114fc173093a091e2f468b42c1a6e06d1d0d3bd6b7c837ceb2b47686c96388
-  data.tar.gz: fe153dd036e2c7ab6d27b9e22a3bdc88f30f9d16b73cae11d7fbd146bb7b5567faa4f0331e83bb3f1fb2fde8bba94d9674b45ce99011b3cf6e84d7ee02ad711c
+  metadata.gz: 8502635e782f3c870ee6aa638e09cba1bbc054c731d1c4599e5b23a31551bd0fb5dce9fc71eaa3d2ca8d3713b2ab8ba26591749a59b9bcd51bb09d871d11a2cc
+  data.tar.gz: 300a7bc9351bb8d0dbcc3f70122094d03705fd876322f36187c587daa0bf44446477a57df6e2130252d3501577b1e410bd1510836e70c97729b430b7dd5a6f33

data/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-06-23
+
+### Added
+
+- Multi-controller assertion: `have_stimulus_controller("hello", "clipboard")` asserts multiple controllers on a single element
+- Scoped matching via `.within(selector)` on all matchers (request-spec and Capybara)
+
+## [0.5.0] - 2026-06-23
+
+### Added
+
+- Capybara `have_stimulus_class` matcher (existence and equality modes) for system/feature specs
+- Capybara `have_stimulus_outlet` matcher (existence and selector modes) for system/feature specs
+
 ## [0.4.0] - 2026-06-22
 
 ### Added
@@ -39,7 +53,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `have_stimulus_action(descriptor)` matcher — full descriptor (`~=`) and shorthand without event (`*=`)
 - `have_stimulus_target(controller, target)` matcher — asserts `[data-{controller}-target~="target"]`
 
-[Unreleased]: https://github.com/eclectic-coding/stimulus_spec/compare/v0.4.0...HEAD
+[Unreleased]: https://github.com/eclectic-coding/stimulus_spec/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/eclectic-coding/stimulus_spec/releases/tag/v0.6.0
+[0.5.0]: https://github.com/eclectic-coding/stimulus_spec/releases/tag/v0.5.0
 [0.4.0]: https://github.com/eclectic-coding/stimulus_spec/releases/tag/v0.4.0
 [0.3.0]: https://github.com/eclectic-coding/stimulus_spec/releases/tag/v0.3.0
 [0.1.0]: https://github.com/eclectic-coding/stimulus_spec/releases/tag/v0.1.0

data/README.md

@@ -9,7 +9,7 @@
 Drop-in RSpec matchers for [hotwired/stimulus-rails](https://github.com/hotwired/stimulus-rails) — stop hand-rolling `data-controller` assertions and test your Stimulus wiring with expressive, purpose-built matchers.
 
 - **Request/controller specs** — `have_stimulus_controller`, `have_stimulus_action`, `have_stimulus_target`, `have_stimulus_value`, `have_stimulus_class`, `have_stimulus_outlet`
-- **System/feature specs** — Capybara matchers: `have_stimulus_controller`, `have_stimulus_action`, `have_stimulus_target`, `have_stimulus_value`
+- **System/feature specs** — Capybara matchers: `have_stimulus_controller`, `have_stimulus_action`, `have_stimulus_target`, `have_stimulus_value`, `have_stimulus_class`, `have_stimulus_outlet`
 - **Auto-included** — zero setup required when `stimulus-rails` is in your bundle
 - **Configurable** — disable auto-include when you need manual control
 
@@ -26,6 +26,7 @@ Companion gem to [turbo_rspec](https://github.com/eclectic-coding/turbo_rspec)
   - [have\_stimulus\_value](#have_stimulus_value)
   - [have\_stimulus\_class](#have_stimulus_class)
   - [have\_stimulus\_outlet](#have_stimulus_outlet)
+  - [Scoped matching with `.within`](#scoped-matching-with-within)
 - [Example](#example)
 - [Relationship to turbo\_rspec](#relationship-to-turbo_rspec)
 - [Contributing](#contributing)
@@ -84,8 +85,8 @@ Assert that rendered HTML contains a `data-controller` attribute with the given
 ```ruby
 expect(response).to have_stimulus_controller("hello")
 
-# Works with multiple controllers on a single element
-expect(response).to have_stimulus_controller("clipboard")
+# Assert multiple controllers on a single element
+expect(response).to have_stimulus_controller("hello", "clipboard")
 
 # Negation
 expect(response).not_to have_stimulus_controller("missing")
@@ -165,6 +166,20 @@ expect(response).to have_stimulus_outlet("search", "results", "#results-list")
 expect(response).not_to have_stimulus_outlet("search", "results")
 ```
 
+### Scoped matching with `.within`
+
+All matchers support `.within(selector)` to restrict matching to a specific part of the page:
+
+```ruby
+# Request/controller specs — search within a CSS selector
+expect(response).to have_stimulus_controller("search").within(".search-form")
+expect(response).to have_stimulus_action("click->search#query").within(".search-form")
+expect(response).to have_stimulus_target("search", "input").within(".search-form")
+
+# System/feature specs — same API
+expect(page).to have_stimulus_controller("search").within(".search-form")
+```
+
 [Back to top](#stimulusspec)
 
 ## Example

data/ROADMAP.md

@@ -11,7 +11,7 @@ RSpec matchers for [Stimulus](https://github.com/hotwired/stimulus-rails): contr
 
 ---
 
-## 0.5.0 — Documentation and Polish
+## 0.7.0 — Documentation and Polish
 
 - Full YARD documentation on all public methods and classes
 - `docs/cookbook.md` — common patterns: request specs, system specs, multi-controller elements, typed values, outlets

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

@@ -8,13 +8,18 @@ module StimulusSpec
           @descriptor = descriptor.to_s
         end
 
+        def within(selector)
+          @scope = selector
+          self
+        end
+
         def matches?(page)
           @page = page
-          page.has_css?(css_selector, wait: 0)
+          page.has_css?(scoped_selector, wait: 0)
         end
 
         def does_not_match?(page)
-          page.has_no_css?(css_selector, wait: 0)
+          page.has_no_css?(scoped_selector, wait: 0)
         end
 
         def failure_message
@@ -31,12 +36,13 @@ module StimulusSpec
 
         private
 
-        def css_selector
-          if @descriptor.include?("->")
-            "[data-action~='#{@descriptor}']"
-          else
-            "[data-action*='#{@descriptor}']"
-          end
+        def scoped_selector
+          base = if @descriptor.include?("->")
+                   "[data-action~='#{@descriptor}']"
+                 else
+                   "[data-action*='#{@descriptor}']"
+                 end
+          @scope ? "#{@scope} #{base}" : base
         end
       end
 

data/lib/stimulus_spec/capybara/matchers/have_stimulus_class.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module StimulusSpec
+  module Capybara
+    module Matchers
+      class HaveStimulusClass
+        def initialize(controller, name, expected = nil)
+          @controller = controller.to_s
+          @name = name.to_s
+          @expected = expected
+          @attr = "data-#{@controller}-#{@name}-class"
+        end
+
+        def within(selector)
+          @scope = selector
+          self
+        end
+
+        def matches?(page)
+          @page = page
+          element = page.first(scoped_selector, minimum: 0, wait: 0)
+          return false unless element
+
+          if @expected
+            @actual = element[@attr]
+            @actual == @expected.to_s
+          else
+            true
+          end
+        end
+
+        def does_not_match?(page)
+          !matches?(page)
+        end
+
+        def failure_message
+          if @expected && @actual
+            "expected #{@attr} to be \"#{@expected}\" but was \"#{@actual}\""
+          else
+            "expected to find an element with #{@attr} on the page"
+          end
+        end
+
+        def failure_message_when_negated
+          "expected not to find an element with #{@attr} on the page"
+        end
+
+        def description
+          if @expected
+            "have Stimulus class \"#{@name}\" with \"#{@expected}\" for controller \"#{@controller}\""
+          else
+            "have Stimulus class \"#{@name}\" for controller \"#{@controller}\""
+          end
+        end
+
+        private
+
+        def scoped_selector
+          base = "[#{@attr}]"
+          @scope ? "#{@scope} #{base}" : base
+        end
+      end
+
+      def have_stimulus_class(controller, name, expected = nil)
+        HaveStimulusClass.new(controller, name, expected)
+      end
+    end
+  end
+end

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

@@ -4,34 +4,50 @@ module StimulusSpec
   module Capybara
     module Matchers
       class HaveStimulusController
-        def initialize(name)
-          @name = name.to_s
+        def initialize(*names)
+          @names = names.map(&:to_s)
+        end
+
+        def within(selector)
+          @scope = selector
+          self
         end
 
         def matches?(page)
           @page = page
-          page.has_css?("[data-controller~='#{@name}']", wait: 0)
+          page.has_css?(scoped_selector, wait: 0)
         end
 
         def does_not_match?(page)
-          page.has_no_css?("[data-controller~='#{@name}']", wait: 0)
+          page.has_no_css?(scoped_selector, wait: 0)
         end
 
         def failure_message
-          "expected to find an element with data-controller=\"#{@name}\" on the page"
+          "expected to find an element with data-controller=#{label} on the page"
         end
 
         def failure_message_when_negated
-          "expected not to find an element with data-controller=\"#{@name}\" on the page"
+          "expected not to find an element with data-controller=#{label} on the page"
         end
 
         def description
-          "have Stimulus controller \"#{@name}\""
+          "have Stimulus controller #{label}"
+        end
+
+        private
+
+        def label
+          @names.map { |n| "\"#{n}\"" }.join(", ")
+        end
+
+        def scoped_selector
+          selector = @names.map { |n| "[data-controller~='#{n}']" }.join
+          @scope ? "#{@scope} #{selector}" : selector
         end
       end
 
-      def have_stimulus_controller(name)
-        HaveStimulusController.new(name)
+      def have_stimulus_controller(*names)
+        HaveStimulusController.new(*names)
       end
     end
   end

data/lib/stimulus_spec/capybara/matchers/have_stimulus_outlet.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module StimulusSpec
+  module Capybara
+    module Matchers
+      class HaveStimulusOutlet
+        def initialize(controller, outlet, selector = nil)
+          @controller = controller.to_s
+          @outlet = outlet.to_s
+          @selector = selector
+          @attr = "data-#{@controller}-#{@outlet}-outlet"
+        end
+
+        def within(selector)
+          @scope = selector
+          self
+        end
+
+        def matches?(page)
+          @page = page
+          element = page.first(scoped_selector, minimum: 0, wait: 0)
+          return false unless element
+
+          if @selector
+            @actual = element[@attr]
+            @actual == @selector.to_s
+          else
+            true
+          end
+        end
+
+        def does_not_match?(page)
+          !matches?(page)
+        end
+
+        def failure_message
+          if @selector && @actual
+            "expected #{@attr} to be \"#{@selector}\" but was \"#{@actual}\""
+          else
+            "expected to find an element with #{@attr} on the page"
+          end
+        end
+
+        def failure_message_when_negated
+          "expected not to find an element with #{@attr} on the page"
+        end
+
+        def description
+          if @selector
+            "have Stimulus outlet \"#{@outlet}\" with \"#{@selector}\" for controller \"#{@controller}\""
+          else
+            "have Stimulus outlet \"#{@outlet}\" for controller \"#{@controller}\""
+          end
+        end
+
+        private
+
+        def scoped_selector
+          base = "[#{@attr}]"
+          @scope ? "#{@scope} #{base}" : base
+        end
+      end
+
+      def have_stimulus_outlet(controller, outlet, selector = nil)
+        HaveStimulusOutlet.new(controller, outlet, selector)
+      end
+    end
+  end
+end

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

@@ -9,13 +9,18 @@ module StimulusSpec
           @target = target.to_s
         end
 
+        def within(selector)
+          @scope = selector
+          self
+        end
+
         def matches?(page)
           @page = page
-          page.has_css?("[data-#{@controller}-target~='#{@target}']", wait: 0)
+          page.has_css?(scoped_selector, wait: 0)
         end
 
         def does_not_match?(page)
-          page.has_no_css?("[data-#{@controller}-target~='#{@target}']", wait: 0)
+          page.has_no_css?(scoped_selector, wait: 0)
         end
 
         def failure_message
@@ -29,6 +34,13 @@ module StimulusSpec
         def description
           "have Stimulus target \"#{@target}\" for controller \"#{@controller}\""
         end
+
+        private
+
+        def scoped_selector
+          base = "[data-#{@controller}-target~='#{@target}']"
+          @scope ? "#{@scope} #{base}" : base
+        end
       end
 
       def have_stimulus_target(controller, target)

data/lib/stimulus_spec/capybara/matchers/have_stimulus_value.rb

@@ -11,9 +11,14 @@ module StimulusSpec
           @attr = "data-#{@controller}-#{@name}-value"
         end
 
+        def within(selector)
+          @scope = selector
+          self
+        end
+
         def matches?(page)
           @page = page
-          element = page.first("[#{@attr}]", minimum: 0, wait: 0)
+          element = page.first(scoped_selector, minimum: 0, wait: 0)
           return false unless element
 
           if @expected
@@ -47,6 +52,13 @@ module StimulusSpec
             "have Stimulus value \"#{@name}\" for controller \"#{@controller}\""
           end
         end
+
+        private
+
+        def scoped_selector
+          base = "[#{@attr}]"
+          @scope ? "#{@scope} #{base}" : base
+        end
       end
 
       def have_stimulus_value(controller, name, expected = nil)

data/lib/stimulus_spec/capybara/matchers.rb

@@ -4,6 +4,8 @@ require_relative "matchers/have_stimulus_controller"
 require_relative "matchers/have_stimulus_action"
 require_relative "matchers/have_stimulus_target"
 require_relative "matchers/have_stimulus_value"
+require_relative "matchers/have_stimulus_class"
+require_relative "matchers/have_stimulus_outlet"
 
 module StimulusSpec
   module Capybara

data/lib/stimulus_spec/matchers/have_stimulus_action.rb

@@ -7,13 +7,21 @@ module StimulusSpec
         @descriptor = descriptor.to_s
       end
 
+      def within(selector)
+        @scope = selector
+        self
+      end
+
       def matches?(subject)
         @body = extract_body(subject)
         @doc = Nokogiri::HTML5.fragment(@body)
+        root = search_root
+        return false unless root
+
         if @descriptor.include?("->")
-          !@doc.at_css("[data-action~='#{@descriptor}']").nil?
+          !root.at_css("[data-action~='#{@descriptor}']").nil?
         else
-          !@doc.at_css("[data-action*='#{@descriptor}']").nil?
+          !root.at_css("[data-action*='#{@descriptor}']").nil?
         end
       end
 
@@ -43,8 +51,15 @@ module StimulusSpec
         subject.respond_to?(:body) ? subject.body : subject.to_s
       end
 
+      def search_root
+        return @doc unless @scope
+
+        @doc.at_css(@scope)
+      end
+
       def snippet
-        elements = @doc.css("[data-action]")
+        root = search_root || @doc
+        elements = root.css("[data-action]")
         return @body if elements.empty?
 
         elements.map(&:to_html).join("\n")

data/lib/stimulus_spec/matchers/have_stimulus_class.rb

@@ -10,18 +10,21 @@ module StimulusSpec
         @attr = "data-#{@controller}-#{@name}-class"
       end
 
+      def within(selector)
+        @scope = selector
+        self
+      end
+
       def matches?(subject)
         @body = extract_body(subject)
         @doc = Nokogiri::HTML5.fragment(@body)
-        @element = @doc.at_css("[#{@attr}]")
+        @element = search_root&.at_css("[#{@attr}]")
         return false unless @element
 
-        if @expected
-          @actual = @element[@attr]
-          @actual == @expected.to_s
-        else
-          true
-        end
+        return true unless @expected
+
+        @actual = @element[@attr]
+        @actual == @expected.to_s
       end
 
       def does_not_match?(subject)
@@ -54,8 +57,15 @@ module StimulusSpec
         subject.respond_to?(:body) ? subject.body : subject.to_s
       end
 
+      def search_root
+        return @doc unless @scope
+
+        @doc.at_css(@scope)
+      end
+
       def snippet
-        elements = @doc.css("[data-controller]")
+        root = search_root || @doc
+        elements = root.css("[data-controller]")
         return @body if elements.empty?
 
         elements.map(&:to_html).join("\n")

data/lib/stimulus_spec/matchers/have_stimulus_controller.rb

@@ -3,15 +3,24 @@
 module StimulusSpec
   module Matchers
     class HaveStimulusController
-      def initialize(name)
-        @name = name.to_s
+      def initialize(*names)
+        @names = names.map(&:to_s)
+      end
+
+      def within(selector)
+        @scope = selector
+        self
       end
 
       def matches?(subject)
         @body = extract_body(subject)
         @doc = Nokogiri::HTML5.fragment(@body)
-        @found_controllers = @doc.css("[data-controller]").flat_map { |el| el["data-controller"].split }
-        !@doc.at_css("[data-controller~='#{@name}']").nil?
+        root = search_root
+        return false unless root
+
+        @found_controllers = root.css("[data-controller]").flat_map { |el| el["data-controller"].split }
+        selector = @names.map { |n| "[data-controller~='#{n}']" }.join
+        !root.at_css(selector).nil?
       end
 
       def does_not_match?(subject)
@@ -19,8 +28,9 @@ module StimulusSpec
       end
 
       def failure_message
-        msg = "expected to find an element with data-controller=\"#{@name}\""
-        if @found_controllers.any?
+        label = @names.map { |n| "\"#{n}\"" }.join(", ")
+        msg = "expected to find an element with data-controller=#{label}"
+        if @found_controllers&.any?
           msg += "\n  found controllers: #{@found_controllers.uniq.map { |c| "\"#{c}\"" }.join(", ")}"
         end
         msg += "\n  in:\n#{snippet}"
@@ -28,11 +38,13 @@ module StimulusSpec
       end
 
       def failure_message_when_negated
-        "expected not to find an element with data-controller=\"#{@name}\" but found one"
+        label = @names.map { |n| "\"#{n}\"" }.join(", ")
+        "expected not to find an element with data-controller=#{label} but found one"
       end
 
       def description
-        "have Stimulus controller \"#{@name}\""
+        label = @names.map { |n| "\"#{n}\"" }.join(", ")
+        "have Stimulus controller #{label}"
       end
 
       private
@@ -41,16 +53,23 @@ module StimulusSpec
         subject.respond_to?(:body) ? subject.body : subject.to_s
       end
 
+      def search_root
+        return @doc unless @scope
+
+        @doc.at_css(@scope)
+      end
+
       def snippet
-        elements = @doc.css("[data-controller]")
+        root = search_root || @doc
+        elements = root.css("[data-controller]")
         return @body if elements.empty?
 
         elements.map(&:to_html).join("\n")
       end
     end
 
-    def have_stimulus_controller(name)
-      HaveStimulusController.new(name)
+    def have_stimulus_controller(*names)
+      HaveStimulusController.new(*names)
     end
   end
 end

data/lib/stimulus_spec/matchers/have_stimulus_outlet.rb

@@ -10,18 +10,21 @@ module StimulusSpec
         @attr = "data-#{@controller}-#{@outlet}-outlet"
       end
 
+      def within(selector)
+        @scope = selector
+        self
+      end
+
       def matches?(subject)
         @body = extract_body(subject)
         @doc = Nokogiri::HTML5.fragment(@body)
-        @element = @doc.at_css("[#{@attr}]")
+        @element = search_root&.at_css("[#{@attr}]")
         return false unless @element
 
-        if @selector
-          @actual = @element[@attr]
-          @actual == @selector.to_s
-        else
-          true
-        end
+        return true unless @selector
+
+        @actual = @element[@attr]
+        @actual == @selector.to_s
       end
 
       def does_not_match?(subject)
@@ -54,8 +57,15 @@ module StimulusSpec
         subject.respond_to?(:body) ? subject.body : subject.to_s
       end
 
+      def search_root
+        return @doc unless @scope
+
+        @doc.at_css(@scope)
+      end
+
       def snippet
-        elements = @doc.css("[data-controller]")
+        root = search_root || @doc
+        elements = root.css("[data-controller]")
         return @body if elements.empty?
 
         elements.map(&:to_html).join("\n")

data/lib/stimulus_spec/matchers/have_stimulus_target.rb

@@ -9,10 +9,18 @@ module StimulusSpec
         @attr = "data-#{@controller}-target"
       end
 
+      def within(selector)
+        @scope = selector
+        self
+      end
+
       def matches?(subject)
         @body = extract_body(subject)
         @doc = Nokogiri::HTML5.fragment(@body)
-        !@doc.at_css("[#{@attr}~='#{@target}']").nil?
+        root = search_root
+        return false unless root
+
+        !root.at_css("[#{@attr}~='#{@target}']").nil?
       end
 
       def does_not_match?(subject)
@@ -41,8 +49,15 @@ module StimulusSpec
         subject.respond_to?(:body) ? subject.body : subject.to_s
       end
 
+      def search_root
+        return @doc unless @scope
+
+        @doc.at_css(@scope)
+      end
+
       def snippet
-        elements = @doc.css("[#{@attr}]")
+        root = search_root || @doc
+        elements = root.css("[#{@attr}]")
         return @body if elements.empty?
 
         elements.map(&:to_html).join("\n")

data/lib/stimulus_spec/matchers/have_stimulus_value.rb

@@ -10,18 +10,21 @@ module StimulusSpec
         @attr = "data-#{@controller}-#{@name}-value"
       end
 
+      def within(selector)
+        @scope = selector
+        self
+      end
+
       def matches?(subject)
         @body = extract_body(subject)
         @doc = Nokogiri::HTML5.fragment(@body)
-        @element = @doc.at_css("[#{@attr}]")
+        @element = search_root&.at_css("[#{@attr}]")
         return false unless @element
 
-        if @expected
-          @actual = @element[@attr]
-          @actual == @expected.to_s
-        else
-          true
-        end
+        return true unless @expected
+
+        @actual = @element[@attr]
+        @actual == @expected.to_s
       end
 
       def does_not_match?(subject)
@@ -54,8 +57,15 @@ module StimulusSpec
         subject.respond_to?(:body) ? subject.body : subject.to_s
       end
 
+      def search_root
+        return @doc unless @scope
+
+        @doc.at_css(@scope)
+      end
+
       def snippet
-        elements = @doc.css("[data-controller]")
+        root = search_root || @doc
+        elements = root.css("[data-controller]")
         return @body if elements.empty?
 
         elements.map(&:to_html).join("\n")

data/lib/stimulus_spec/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module StimulusSpec
-  VERSION = "0.4.0"
+  VERSION = "0.6.0"
 end

data/sig/stimulus_spec.rbs

@@ -13,7 +13,7 @@ module StimulusSpec
   end
 
   module Matchers
-    def have_stimulus_controller: (String name) -> HaveStimulusController
+    def have_stimulus_controller: (*String names) -> HaveStimulusController
     def have_stimulus_action: (String descriptor) -> HaveStimulusAction
     def have_stimulus_target: (String controller, String target) -> HaveStimulusTarget
     def have_stimulus_value: (String controller, String name, ?String? expected) -> HaveStimulusValue
@@ -21,7 +21,8 @@ module StimulusSpec
     def have_stimulus_outlet: (String controller, String outlet, ?String? selector) -> HaveStimulusOutlet
 
     class HaveStimulusController
-      def initialize: (String name) -> void
+      def initialize: (*String names) -> void
+      def within: (String selector) -> self
       def matches?: (untyped subject) -> bool
       def does_not_match?: (untyped subject) -> bool
       def failure_message: () -> String
@@ -31,6 +32,7 @@ module StimulusSpec
 
     class HaveStimulusAction
       def initialize: (String descriptor) -> void
+      def within: (String selector) -> self
       def matches?: (untyped subject) -> bool
       def does_not_match?: (untyped subject) -> bool
       def failure_message: () -> String
@@ -40,6 +42,7 @@ module StimulusSpec
 
     class HaveStimulusTarget
       def initialize: (String controller, String target) -> void
+      def within: (String selector) -> self
       def matches?: (untyped subject) -> bool
       def does_not_match?: (untyped subject) -> bool
       def failure_message: () -> String
@@ -49,6 +52,7 @@ module StimulusSpec
 
     class HaveStimulusValue
       def initialize: (String controller, String name, ?String? expected) -> void
+      def within: (String selector) -> self
       def matches?: (untyped subject) -> bool
       def does_not_match?: (untyped subject) -> bool
       def failure_message: () -> String
@@ -58,6 +62,7 @@ module StimulusSpec
 
     class HaveStimulusClass
       def initialize: (String controller, String name, ?String? expected) -> void
+      def within: (String selector) -> self
       def matches?: (untyped subject) -> bool
       def does_not_match?: (untyped subject) -> bool
       def failure_message: () -> String
@@ -67,6 +72,7 @@ module StimulusSpec
 
     class HaveStimulusOutlet
       def initialize: (String controller, String outlet, ?String? selector) -> void
+      def within: (String selector) -> self
       def matches?: (untyped subject) -> bool
       def does_not_match?: (untyped subject) -> bool
       def failure_message: () -> String
@@ -77,13 +83,16 @@ module StimulusSpec
 
   module Capybara
     module Matchers
-      def have_stimulus_controller: (String name) -> HaveStimulusController
+      def have_stimulus_controller: (*String names) -> HaveStimulusController
       def have_stimulus_action: (String descriptor) -> HaveStimulusAction
       def have_stimulus_target: (String controller, String target) -> HaveStimulusTarget
       def have_stimulus_value: (String controller, String name, ?String? expected) -> HaveStimulusValue
+      def have_stimulus_class: (String controller, String name, ?String? expected) -> HaveStimulusClass
+      def have_stimulus_outlet: (String controller, String outlet, ?String? selector) -> HaveStimulusOutlet
 
       class HaveStimulusController
-        def initialize: (String name) -> void
+        def initialize: (*String names) -> void
+        def within: (String selector) -> self
         def matches?: (untyped page) -> bool
         def does_not_match?: (untyped page) -> bool
         def failure_message: () -> String
@@ -93,6 +102,7 @@ module StimulusSpec
 
       class HaveStimulusAction
         def initialize: (String descriptor) -> void
+        def within: (String selector) -> self
         def matches?: (untyped page) -> bool
         def does_not_match?: (untyped page) -> bool
         def failure_message: () -> String
@@ -102,6 +112,7 @@ module StimulusSpec
 
       class HaveStimulusTarget
         def initialize: (String controller, String target) -> void
+        def within: (String selector) -> self
         def matches?: (untyped page) -> bool
         def does_not_match?: (untyped page) -> bool
         def failure_message: () -> String
@@ -111,6 +122,27 @@ module StimulusSpec
 
       class HaveStimulusValue
         def initialize: (String controller, String name, ?String? expected) -> void
+        def within: (String selector) -> self
+        def matches?: (untyped page) -> bool
+        def does_not_match?: (untyped page) -> bool
+        def failure_message: () -> String
+        def failure_message_when_negated: () -> String
+        def description: () -> String
+      end
+
+      class HaveStimulusClass
+        def initialize: (String controller, String name, ?String? expected) -> void
+        def within: (String selector) -> self
+        def matches?: (untyped page) -> bool
+        def does_not_match?: (untyped page) -> bool
+        def failure_message: () -> String
+        def failure_message_when_negated: () -> String
+        def description: () -> String
+      end
+
+      class HaveStimulusOutlet
+        def initialize: (String controller, String outlet, ?String? selector) -> void
+        def within: (String selector) -> self
         def matches?: (untyped page) -> bool
         def does_not_match?: (untyped page) -> bool
         def failure_message: () -> String
@@ -119,4 +151,4 @@ module StimulusSpec
       end
     end
   end
-end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stimulus_spec
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -46,7 +46,9 @@ files:
 - lib/stimulus_spec.rb
 - lib/stimulus_spec/capybara/matchers.rb
 - lib/stimulus_spec/capybara/matchers/have_stimulus_action.rb
+- lib/stimulus_spec/capybara/matchers/have_stimulus_class.rb
 - lib/stimulus_spec/capybara/matchers/have_stimulus_controller.rb
+- lib/stimulus_spec/capybara/matchers/have_stimulus_outlet.rb
 - lib/stimulus_spec/capybara/matchers/have_stimulus_target.rb
 - lib/stimulus_spec/capybara/matchers/have_stimulus_value.rb
 - lib/stimulus_spec/configuration.rb