stimulus_spec 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f9f2064cf807ad376e2e9098aa7a400986c40f2fff504d7e4f2db7450ef02154
-  data.tar.gz: 0c221ae06953f2ce8e74663b2500ee452e30fee9acfbf08edf02a35c99ea4cb5
+  metadata.gz: 016bc15660c32251a12c1c9129fa88c86a3e2ac1059949535a67cdd5d64448ce
+  data.tar.gz: 76277d4b548369259e6ae9f28b8ad2b4d22637659f7c13a938e5cf2fd95127e5
 SHA512:
-  metadata.gz: c06ffeb2e5a16290a59ee122a7dd40a7933a840dd1899e006755184c172a92ff472260976b0fc08f29522bd78c961d5315ab98471867785342099aef49503646
-  data.tar.gz: a6d8f79f021f954e00c7c2aec8e5c14c972ced90b1e143324fc47b75bc8b5d6f641e9d33efdf95e348600573df5271a43586f4bdaed3145ac567ff0b24b24672
+  metadata.gz: 8502635e782f3c870ee6aa638e09cba1bbc054c731d1c4599e5b23a31551bd0fb5dce9fc71eaa3d2ca8d3713b2ab8ba26591749a59b9bcd51bb09d871d11a2cc
+  data.tar.gz: 300a7bc9351bb8d0dbcc3f70122094d03705fd876322f36187c587daa0bf44446477a57df6e2130252d3501577b1e410bd1510836e70c97729b430b7dd5a6f33

data/CHANGELOG.md

@@ -7,6 +7,13 @@ 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
@@ -46,7 +53,8 @@ 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.5.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

data/README.md

@@ -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,13 +11,6 @@ RSpec matchers for [Stimulus](https://github.com/hotwired/stimulus-rails): contr
 
 ---
 
-## 0.6.0 — Multi-Controller and Scoped Matching
-
-- `have_stimulus_controller("hello", "clipboard")` — assert multiple controllers on a single element
-- Scoped matching — assert Stimulus attributes within a specific CSS selector (e.g., within a form or component root)
-
----
-
 ## 0.7.0 — Documentation and Polish
 
 - Full YARD documentation on all public methods and classes

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

@@ -11,9 +11,14 @@ module StimulusSpec
           @attr = "data-#{@controller}-#{@name}-class"
         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 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)

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

@@ -11,9 +11,14 @@ module StimulusSpec
           @attr = "data-#{@controller}-#{@outlet}-outlet"
         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 @selector
@@ -47,6 +52,13 @@ module StimulusSpec
             "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)

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/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.5.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,7 +83,7 @@ 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
@@ -85,7 +91,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 page) -> bool
         def does_not_match?: (untyped page) -> bool
         def failure_message: () -> String
@@ -95,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
@@ -104,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
@@ -113,6 +122,7 @@ 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
@@ -122,6 +132,7 @@ module StimulusSpec
 
       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
@@ -131,6 +142,7 @@ module StimulusSpec
 
       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
@@ -139,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.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Chuck Smith