stimulus_spec 0.1.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b3c093ad148d096d99e96b88f18c7f90814878425dc7c531c4aba4af4149cd81
-  data.tar.gz: 3e938ad72982b139830f45815c1cc6d4c457f9e8f60af4d1bf362a7cbb641fb6
+  metadata.gz: ed3850b553fca15bb450d8ad6e0f50d37593c90bd440d26c6cbf0a8eb99882ea
+  data.tar.gz: a0b96c0888a87a93ef3db2e783d747642f09f863003c3f9a8fc43cc04ca4f392
 SHA512:
-  metadata.gz: 50ff8b23e522757c5bc8387a27b00299db7c7f23b1134cbe6fbe204bebf005b825ba1e621546c681c47eaa6f7ec28e7418b17672e87fea7c01dcf5bea6425910
-  data.tar.gz: cd08d477efb9bab97f956c943f30e88ebbfc5362d73fe9ede1af2d448e0125c00fe67a6b601361abf37396a996ccdb9fe2c550d0f346dc884f8caa647e9caa00
+  metadata.gz: 0ee41b07ee4796f9670ec0a805ff0b6f52179fddc5cec9169f8272d65bc1bf6c7b114fc173093a091e2f468b42c1a6e06d1d0d3bd6b7c837ceb2b47686c96388
+  data.tar.gz: fe153dd036e2c7ab6d27b9e22a3bdc88f30f9d16b73cae11d7fbd146bb7b5567faa4f0331e83bb3f1fb2fde8bba94d9674b45ce99011b3cf6e84d7ee02ad711c

data/CHANGELOG.md

@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-06-22
+
+### Added
+
+- `have_stimulus_outlet(controller, outlet)` matcher — asserts `data-{controller}-{outlet}-outlet` exists
+- `have_stimulus_outlet(controller, outlet, selector)` matcher — asserts attribute equals the CSS selector value
+- Capybara matchers: `have_stimulus_controller`, `have_stimulus_action`, `have_stimulus_target` for system/feature specs
+- Auto-include `StimulusSpec::Capybara::Matchers` into `type: :system` and `type: :feature` (gated on `capybara`)
+- Capybara `have_stimulus_value` matcher (existence and equality modes)
+- Enhanced failure messages: controller mismatch lists all found controllers, value/class/outlet mismatch shows actual vs expected with element HTML, all matchers include relevant HTML snippets
+
+## [0.3.0] - 2026-06-22
+
+### Added
+
+- `have_stimulus_value(controller, name)` matcher — asserts `data-{controller}-{name}-value` exists
+- `have_stimulus_value(controller, name, expected)` matcher — asserts attribute equals expected value
+- `have_stimulus_class(controller, name)` matcher — asserts `data-{controller}-{name}-class` exists
+- `have_stimulus_class(controller, name, expected)` matcher — asserts attribute equals expected class
+
 ## [0.1.0] - 2026-06-22
 
 ### Added
@@ -19,5 +39,7 @@ 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.1.0...HEAD
+[Unreleased]: https://github.com/eclectic-coding/stimulus_spec/compare/v0.4.0...HEAD
+[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

@@ -8,7 +8,8 @@
 
 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`
+- **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`
 - **Auto-included** — zero setup required when `stimulus-rails` is in your bundle
 - **Configurable** — disable auto-include when you need manual control
 
@@ -22,6 +23,9 @@ Companion gem to [turbo_rspec](https://github.com/eclectic-coding/turbo_rspec)
   - [have\_stimulus\_controller](#have_stimulus_controller)
   - [have\_stimulus\_action](#have_stimulus_action)
   - [have\_stimulus\_target](#have_stimulus_target)
+  - [have\_stimulus\_value](#have_stimulus_value)
+  - [have\_stimulus\_class](#have_stimulus_class)
+  - [have\_stimulus\_outlet](#have_stimulus_outlet)
 - [Example](#example)
 - [Relationship to turbo\_rspec](#relationship-to-turbo_rspec)
 - [Contributing](#contributing)
@@ -43,7 +47,10 @@ end
 
 ### Rails + stimulus-rails (automatic)
 
-No setup needed. When `stimulus-rails` is in your bundle, `StimulusSpec::Matchers` is automatically included in `type: :request`, `:controller`, `:system`, and `:feature` example groups.
+No setup needed. When `stimulus-rails` is in your bundle:
+
+- `StimulusSpec::Matchers` is automatically included in `type: :request` and `type: :controller` example groups
+- `StimulusSpec::Capybara::Matchers` is automatically included in `type: :system` and `type: :feature` example groups when `capybara` is also present
 
 ### Manual include
 
@@ -52,7 +59,8 @@ For non-Rails projects or custom contexts, include the matchers explicitly:
 ```ruby
 # spec/spec_helper.rb
 RSpec.configure do |config|
-  config.include StimulusSpec::Matchers
+  config.include StimulusSpec::Matchers                 # request/controller specs
+  config.include StimulusSpec::Capybara::Matchers       # system/feature specs
 end
 ```
 
@@ -112,6 +120,51 @@ expect(response).to have_stimulus_target("hello", "output")
 expect(response).not_to have_stimulus_target("hello", "missing")
 ```
 
+### `have_stimulus_value`
+
+Assert that rendered HTML contains a `data-{controller}-{name}-value` attribute, optionally with a specific value.
+
+```ruby
+# Assert the value attribute exists
+expect(response).to have_stimulus_value("search", "url")
+
+# Assert a specific value
+expect(response).to have_stimulus_value("search", "url", "/results")
+
+# Negation
+expect(response).not_to have_stimulus_value("search", "url")
+```
+
+### `have_stimulus_class`
+
+Assert that rendered HTML contains a `data-{controller}-{name}-class` attribute, optionally with a specific class.
+
+```ruby
+# Assert the class attribute exists
+expect(response).to have_stimulus_class("search", "loading")
+
+# Assert a specific class value
+expect(response).to have_stimulus_class("search", "loading", "opacity-50")
+
+# Negation
+expect(response).not_to have_stimulus_class("search", "loading")
+```
+
+### `have_stimulus_outlet`
+
+Assert that rendered HTML contains a `data-{controller}-{outlet}-outlet` attribute with a CSS selector.
+
+```ruby
+# Assert the outlet attribute exists
+expect(response).to have_stimulus_outlet("search", "results")
+
+# Assert a specific selector
+expect(response).to have_stimulus_outlet("search", "results", "#results-list")
+
+# Negation
+expect(response).not_to have_stimulus_outlet("search", "results")
+```
+
 [Back to top](#stimulusspec)
 
 ## Example
@@ -130,6 +183,20 @@ RSpec.describe "Search", type: :request do
 end
 ```
 
+### Example: system spec
+
+```ruby
+RSpec.describe "Search", type: :system do
+  it "has the search controller wired up" do
+    visit search_path
+
+    expect(page).to have_stimulus_controller("search")
+    expect(page).to have_stimulus_action("input->search#query")
+    expect(page).to have_stimulus_target("search", "input")
+  end
+end
+```
+
 [Back to top](#stimulusspec)
 
 ## Relationship to turbo_rspec

data/ROADMAP.md

@@ -11,34 +11,6 @@ RSpec matchers for [Stimulus](https://github.com/hotwired/stimulus-rails): contr
 
 ---
 
-## 0.2.0 — Values and Classes
-
-- `have_stimulus_value("search", "url")` — assert `data-search-url-value` attribute exists
-- `have_stimulus_value("search", "url", "/results")` — assert attribute equals expected value
-- `have_stimulus_class("search", "loading")` — assert `data-search-loading-class` exists
-- `have_stimulus_class("search", "loading", "opacity-50")` — assert attribute equals expected class
-
----
-
-## 0.3.0 — Outlets and Capybara Foundation
-
-- `have_stimulus_outlet("search", "results")` — assert `data-search-results-outlet` exists
-- `have_stimulus_outlet("search", "results", "#results-list")` — assert selector value
-- Capybara matchers: `have_stimulus_controller`, `have_stimulus_action`, `have_stimulus_target` using `has_css?` / `has_no_css?` with `wait: 0`
-- Auto-include `StimulusSpec::Capybara::Matchers` into `type: :system` and `type: :feature` (gated on `capybara`)
-
----
-
-## 0.4.0 — Capybara Values and Rich Failures
-
-- Capybara `have_stimulus_value` matcher
-- Enhanced failure messages across all matchers:
-  - List all `data-controller` values found in the document on controller mismatch
-  - Show actual vs expected value on value/class/outlet mismatch
-  - Include relevant HTML snippet for context
-
----
-
 ## 0.5.0 — Documentation and Polish
 
 - Full YARD documentation on all public methods and classes

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

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module StimulusSpec
+  module Capybara
+    module Matchers
+      class HaveStimulusAction
+        def initialize(descriptor)
+          @descriptor = descriptor.to_s
+        end
+
+        def matches?(page)
+          @page = page
+          page.has_css?(css_selector, wait: 0)
+        end
+
+        def does_not_match?(page)
+          page.has_no_css?(css_selector, wait: 0)
+        end
+
+        def failure_message
+          "expected to find an element with data-action=\"#{@descriptor}\" on the page"
+        end
+
+        def failure_message_when_negated
+          "expected not to find an element with data-action=\"#{@descriptor}\" on the page"
+        end
+
+        def description
+          "have Stimulus action \"#{@descriptor}\""
+        end
+
+        private
+
+        def css_selector
+          if @descriptor.include?("->")
+            "[data-action~='#{@descriptor}']"
+          else
+            "[data-action*='#{@descriptor}']"
+          end
+        end
+      end
+
+      def have_stimulus_action(descriptor)
+        HaveStimulusAction.new(descriptor)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module StimulusSpec
+  module Capybara
+    module Matchers
+      class HaveStimulusController
+        def initialize(name)
+          @name = name.to_s
+        end
+
+        def matches?(page)
+          @page = page
+          page.has_css?("[data-controller~='#{@name}']", wait: 0)
+        end
+
+        def does_not_match?(page)
+          page.has_no_css?("[data-controller~='#{@name}']", wait: 0)
+        end
+
+        def failure_message
+          "expected to find an element with data-controller=\"#{@name}\" on the page"
+        end
+
+        def failure_message_when_negated
+          "expected not to find an element with data-controller=\"#{@name}\" on the page"
+        end
+
+        def description
+          "have Stimulus controller \"#{@name}\""
+        end
+      end
+
+      def have_stimulus_controller(name)
+        HaveStimulusController.new(name)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module StimulusSpec
+  module Capybara
+    module Matchers
+      class HaveStimulusTarget
+        def initialize(controller, target)
+          @controller = controller.to_s
+          @target = target.to_s
+        end
+
+        def matches?(page)
+          @page = page
+          page.has_css?("[data-#{@controller}-target~='#{@target}']", wait: 0)
+        end
+
+        def does_not_match?(page)
+          page.has_no_css?("[data-#{@controller}-target~='#{@target}']", wait: 0)
+        end
+
+        def failure_message
+          "expected to find an element with data-#{@controller}-target=\"#{@target}\" on the page"
+        end
+
+        def failure_message_when_negated
+          "expected not to find an element with data-#{@controller}-target=\"#{@target}\" on the page"
+        end
+
+        def description
+          "have Stimulus target \"#{@target}\" for controller \"#{@controller}\""
+        end
+      end
+
+      def have_stimulus_target(controller, target)
+        HaveStimulusTarget.new(controller, target)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module StimulusSpec
+  module Capybara
+    module Matchers
+      class HaveStimulusValue
+        def initialize(controller, name, expected = nil)
+          @controller = controller.to_s
+          @name = name.to_s
+          @expected = expected
+          @attr = "data-#{@controller}-#{@name}-value"
+        end
+
+        def matches?(page)
+          @page = page
+          element = page.first("[#{@attr}]", 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 value \"#{@name}\" with \"#{@expected}\" for controller \"#{@controller}\""
+          else
+            "have Stimulus value \"#{@name}\" for controller \"#{@controller}\""
+          end
+        end
+      end
+
+      def have_stimulus_value(controller, name, expected = nil)
+        HaveStimulusValue.new(controller, name, expected)
+      end
+    end
+  end
+end

data/lib/stimulus_spec/capybara/matchers.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative "matchers/have_stimulus_controller"
+require_relative "matchers/have_stimulus_action"
+require_relative "matchers/have_stimulus_target"
+require_relative "matchers/have_stimulus_value"
+
+module StimulusSpec
+  module Capybara
+    module Matchers
+    end
+  end
+end

data/lib/stimulus_spec/matchers/have_stimulus_action.rb

@@ -9,10 +9,11 @@ module StimulusSpec
 
       def matches?(subject)
         @body = extract_body(subject)
+        @doc = Nokogiri::HTML5.fragment(@body)
         if @descriptor.include?("->")
-          !document.at_css("[data-action~='#{@descriptor}']").nil?
+          !@doc.at_css("[data-action~='#{@descriptor}']").nil?
         else
-          !document.at_css("[data-action*='#{@descriptor}']").nil?
+          !@doc.at_css("[data-action*='#{@descriptor}']").nil?
         end
       end
 
@@ -21,7 +22,11 @@ module StimulusSpec
       end
 
       def failure_message
-        "expected to find an element with data-action=\"#{@descriptor}\" but found none in:\n#{@body}"
+        found_actions = @doc.css("[data-action]").flat_map { |el| el["data-action"].split }
+        msg = "expected to find an element with data-action=\"#{@descriptor}\""
+        msg += "\n  found actions: #{found_actions.uniq.map { |a| "\"#{a}\"" }.join(", ")}" if found_actions.any?
+        msg += "\n  in:\n#{snippet}"
+        msg
       end
 
       def failure_message_when_negated
@@ -38,8 +43,11 @@ module StimulusSpec
         subject.respond_to?(:body) ? subject.body : subject.to_s
       end
 
-      def document
-        Nokogiri::HTML5.fragment(@body)
+      def snippet
+        elements = @doc.css("[data-action]")
+        return @body if elements.empty?
+
+        elements.map(&:to_html).join("\n")
       end
     end
 

data/lib/stimulus_spec/matchers/have_stimulus_class.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module StimulusSpec
+  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 matches?(subject)
+        @body = extract_body(subject)
+        @doc = Nokogiri::HTML5.fragment(@body)
+        @element = @doc.at_css("[#{@attr}]")
+        return false unless @element
+
+        if @expected
+          @actual = @element[@attr]
+          @actual == @expected.to_s
+        else
+          true
+        end
+      end
+
+      def does_not_match?(subject)
+        !matches?(subject)
+      end
+
+      def failure_message
+        if @expected && @actual
+          "expected #{@attr} to be \"#{@expected}\" but was \"#{@actual}\"\n  on: #{@element.to_html}"
+        else
+          "expected to find an element with #{@attr} but found none in:\n#{snippet}"
+        end
+      end
+
+      def failure_message_when_negated
+        "expected not to find an element with #{@attr} but found one"
+      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 extract_body(subject)
+        subject.respond_to?(:body) ? subject.body : subject.to_s
+      end
+
+      def snippet
+        elements = @doc.css("[data-controller]")
+        return @body if elements.empty?
+
+        elements.map(&:to_html).join("\n")
+      end
+    end
+
+    def have_stimulus_class(controller, name, expected = nil)
+      HaveStimulusClass.new(controller, name, expected)
+    end
+  end
+end

data/lib/stimulus_spec/matchers/have_stimulus_controller.rb

@@ -9,7 +9,9 @@ module StimulusSpec
 
       def matches?(subject)
         @body = extract_body(subject)
-        !document.at_css("[data-controller~='#{@name}']").nil?
+        @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?
       end
 
       def does_not_match?(subject)
@@ -17,7 +19,12 @@ module StimulusSpec
       end
 
       def failure_message
-        "expected to find an element with data-controller=\"#{@name}\" but found none in:\n#{@body}"
+        msg = "expected to find an element with data-controller=\"#{@name}\""
+        if @found_controllers.any?
+          msg += "\n  found controllers: #{@found_controllers.uniq.map { |c| "\"#{c}\"" }.join(", ")}"
+        end
+        msg += "\n  in:\n#{snippet}"
+        msg
       end
 
       def failure_message_when_negated
@@ -34,8 +41,11 @@ module StimulusSpec
         subject.respond_to?(:body) ? subject.body : subject.to_s
       end
 
-      def document
-        Nokogiri::HTML5.fragment(@body)
+      def snippet
+        elements = @doc.css("[data-controller]")
+        return @body if elements.empty?
+
+        elements.map(&:to_html).join("\n")
       end
     end
 

data/lib/stimulus_spec/matchers/have_stimulus_outlet.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module StimulusSpec
+  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 matches?(subject)
+        @body = extract_body(subject)
+        @doc = Nokogiri::HTML5.fragment(@body)
+        @element = @doc.at_css("[#{@attr}]")
+        return false unless @element
+
+        if @selector
+          @actual = @element[@attr]
+          @actual == @selector.to_s
+        else
+          true
+        end
+      end
+
+      def does_not_match?(subject)
+        !matches?(subject)
+      end
+
+      def failure_message
+        if @selector && @actual
+          "expected #{@attr} to be \"#{@selector}\" but was \"#{@actual}\"\n  on: #{@element.to_html}"
+        else
+          "expected to find an element with #{@attr} but found none in:\n#{snippet}"
+        end
+      end
+
+      def failure_message_when_negated
+        "expected not to find an element with #{@attr} but found one"
+      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 extract_body(subject)
+        subject.respond_to?(:body) ? subject.body : subject.to_s
+      end
+
+      def snippet
+        elements = @doc.css("[data-controller]")
+        return @body if elements.empty?
+
+        elements.map(&:to_html).join("\n")
+      end
+    end
+
+    def have_stimulus_outlet(controller, outlet, selector = nil)
+      HaveStimulusOutlet.new(controller, outlet, selector)
+    end
+  end
+end

data/lib/stimulus_spec/matchers/have_stimulus_target.rb

@@ -6,11 +6,13 @@ module StimulusSpec
       def initialize(controller, target)
         @controller = controller.to_s
         @target = target.to_s
+        @attr = "data-#{@controller}-target"
       end
 
       def matches?(subject)
         @body = extract_body(subject)
-        !document.at_css("[data-#{@controller}-target~='#{@target}']").nil?
+        @doc = Nokogiri::HTML5.fragment(@body)
+        !@doc.at_css("[#{@attr}~='#{@target}']").nil?
       end
 
       def does_not_match?(subject)
@@ -18,11 +20,15 @@ module StimulusSpec
       end
 
       def failure_message
-        "expected to find an element with data-#{@controller}-target=\"#{@target}\" but found none in:\n#{@body}"
+        found_targets = @doc.css("[#{@attr}]").flat_map { |el| el[@attr].split }
+        msg = "expected to find an element with #{@attr}=\"#{@target}\""
+        msg += "\n  found targets: #{found_targets.uniq.map { |t| "\"#{t}\"" }.join(", ")}" if found_targets.any?
+        msg += "\n  in:\n#{snippet}"
+        msg
       end
 
       def failure_message_when_negated
-        "expected not to find an element with data-#{@controller}-target=\"#{@target}\" but found one"
+        "expected not to find an element with #{@attr}=\"#{@target}\" but found one"
       end
 
       def description
@@ -35,8 +41,11 @@ module StimulusSpec
         subject.respond_to?(:body) ? subject.body : subject.to_s
       end
 
-      def document
-        Nokogiri::HTML5.fragment(@body)
+      def snippet
+        elements = @doc.css("[#{@attr}]")
+        return @body if elements.empty?
+
+        elements.map(&:to_html).join("\n")
       end
     end
 

data/lib/stimulus_spec/matchers/have_stimulus_value.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+module StimulusSpec
+  module Matchers
+    class HaveStimulusValue
+      def initialize(controller, name, expected = nil)
+        @controller = controller.to_s
+        @name = name.to_s
+        @expected = expected
+        @attr = "data-#{@controller}-#{@name}-value"
+      end
+
+      def matches?(subject)
+        @body = extract_body(subject)
+        @doc = Nokogiri::HTML5.fragment(@body)
+        @element = @doc.at_css("[#{@attr}]")
+        return false unless @element
+
+        if @expected
+          @actual = @element[@attr]
+          @actual == @expected.to_s
+        else
+          true
+        end
+      end
+
+      def does_not_match?(subject)
+        !matches?(subject)
+      end
+
+      def failure_message
+        if @expected && @actual
+          "expected #{@attr} to be \"#{@expected}\" but was \"#{@actual}\"\n  on: #{@element.to_html}"
+        else
+          "expected to find an element with #{@attr} but found none in:\n#{snippet}"
+        end
+      end
+
+      def failure_message_when_negated
+        "expected not to find an element with #{@attr} but found one"
+      end
+
+      def description
+        if @expected
+          "have Stimulus value \"#{@name}\" with \"#{@expected}\" for controller \"#{@controller}\""
+        else
+          "have Stimulus value \"#{@name}\" for controller \"#{@controller}\""
+        end
+      end
+
+      private
+
+      def extract_body(subject)
+        subject.respond_to?(:body) ? subject.body : subject.to_s
+      end
+
+      def snippet
+        elements = @doc.css("[data-controller]")
+        return @body if elements.empty?
+
+        elements.map(&:to_html).join("\n")
+      end
+    end
+
+    def have_stimulus_value(controller, name, expected = nil)
+      HaveStimulusValue.new(controller, name, expected)
+    end
+  end
+end

data/lib/stimulus_spec/matchers.rb

@@ -5,6 +5,9 @@ require "nokogiri"
 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 Matchers

data/lib/stimulus_spec/version.rb

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

data/lib/stimulus_spec.rb

@@ -3,6 +3,7 @@
 require_relative "stimulus_spec/version"
 require_relative "stimulus_spec/configuration"
 require_relative "stimulus_spec/matchers"
+require_relative "stimulus_spec/capybara/matchers"
 
 module StimulusSpec
   class Error < StandardError; end
@@ -23,9 +24,15 @@ module StimulusSpec
     return unless Gem.loaded_specs.key?("stimulus-rails")
     return unless configuration.auto_include
 
-    %i[request controller system feature].each do |type|
+    %i[request controller].each do |type|
       config.include StimulusSpec::Matchers, type: type
     end
+
+    return unless Gem.loaded_specs.key?("capybara")
+
+    %i[system feature].each do |type|
+      config.include StimulusSpec::Capybara::Matchers, type: type
+    end
   end
 end
 

data/sig/stimulus_spec.rbs

@@ -16,6 +16,9 @@ module StimulusSpec
     def have_stimulus_controller: (String name) -> 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
@@ -43,5 +46,77 @@ module StimulusSpec
       def failure_message_when_negated: () -> String
       def description: () -> String
     end
+
+    class HaveStimulusValue
+      def initialize: (String controller, String name, ?String? expected) -> void
+      def matches?: (untyped subject) -> bool
+      def does_not_match?: (untyped subject) -> 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 matches?: (untyped subject) -> bool
+      def does_not_match?: (untyped subject) -> 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 matches?: (untyped subject) -> bool
+      def does_not_match?: (untyped subject) -> bool
+      def failure_message: () -> String
+      def failure_message_when_negated: () -> String
+      def description: () -> String
+    end
+  end
+
+  module Capybara
+    module Matchers
+      def have_stimulus_controller: (String name) -> 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
+
+      class HaveStimulusController
+        def initialize: (String name) -> void
+        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 HaveStimulusAction
+        def initialize: (String descriptor) -> void
+        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 HaveStimulusTarget
+        def initialize: (String controller, String target) -> void
+        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 HaveStimulusValue
+        def initialize: (String controller, String name, ?String? expected) -> void
+        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
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stimulus_spec
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -44,11 +44,19 @@ files:
 - Rakefile
 - codecov.yml
 - 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_controller.rb
+- lib/stimulus_spec/capybara/matchers/have_stimulus_target.rb
+- lib/stimulus_spec/capybara/matchers/have_stimulus_value.rb
 - lib/stimulus_spec/configuration.rb
 - lib/stimulus_spec/matchers.rb
 - lib/stimulus_spec/matchers/have_stimulus_action.rb
+- lib/stimulus_spec/matchers/have_stimulus_class.rb
 - lib/stimulus_spec/matchers/have_stimulus_controller.rb
+- lib/stimulus_spec/matchers/have_stimulus_outlet.rb
 - lib/stimulus_spec/matchers/have_stimulus_target.rb
+- lib/stimulus_spec/matchers/have_stimulus_value.rb
 - lib/stimulus_spec/version.rb
 - sig/stimulus_spec.rbs
 homepage: https://github.com/eclectic-coding/stimulus_spec