stimulus_spec 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed3850b553fca15bb450d8ad6e0f50d37593c90bd440d26c6cbf0a8eb99882ea
-  data.tar.gz: a0b96c0888a87a93ef3db2e783d747642f09f863003c3f9a8fc43cc04ca4f392
+  metadata.gz: f9f2064cf807ad376e2e9098aa7a400986c40f2fff504d7e4f2db7450ef02154
+  data.tar.gz: 0c221ae06953f2ce8e74663b2500ee452e30fee9acfbf08edf02a35c99ea4cb5
 SHA512:
-  metadata.gz: 0ee41b07ee4796f9670ec0a805ff0b6f52179fddc5cec9169f8272d65bc1bf6c7b114fc173093a091e2f468b42c1a6e06d1d0d3bd6b7c837ceb2b47686c96388
-  data.tar.gz: fe153dd036e2c7ab6d27b9e22a3bdc88f30f9d16b73cae11d7fbd146bb7b5567faa4f0331e83bb3f1fb2fde8bba94d9674b45ce99011b3cf6e84d7ee02ad711c
+  metadata.gz: c06ffeb2e5a16290a59ee122a7dd40a7933a840dd1899e006755184c172a92ff472260976b0fc08f29522bd78c961d5315ab98471867785342099aef49503646
+  data.tar.gz: a6d8f79f021f954e00c7c2aec8e5c14c972ced90b1e143324fc47b75bc8b5d6f641e9d33efdf95e348600573df5271a43586f4bdaed3145ac567ff0b24b24672

data/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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 +46,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.4.0...HEAD
+[Unreleased]: https://github.com/eclectic-coding/stimulus_spec/compare/v0.5.0...HEAD
+[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
 

data/ROADMAP.md

@@ -11,7 +11,14 @@ RSpec matchers for [Stimulus](https://github.com/hotwired/stimulus-rails): contr
 
 ---
 
-## 0.5.0 — Documentation and Polish
+## 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
 - `docs/cookbook.md` — common patterns: request specs, system specs, multi-controller elements, typed values, outlets

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

@@ -0,0 +1,57 @@
+# 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 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 class \"#{@name}\" with \"#{@expected}\" for controller \"#{@controller}\""
+          else
+            "have Stimulus class \"#{@name}\" for controller \"#{@controller}\""
+          end
+        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_outlet.rb

@@ -0,0 +1,57 @@
+# 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 matches?(page)
+          @page = page
+          element = page.first("[#{@attr}]", 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
+      end
+
+      def have_stimulus_outlet(controller, outlet, selector = nil)
+        HaveStimulusOutlet.new(controller, outlet, selector)
+      end
+    end
+  end
+end

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/version.rb

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

data/sig/stimulus_spec.rbs

@@ -81,6 +81,8 @@ module StimulusSpec
       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
@@ -117,6 +119,24 @@ module StimulusSpec
         def failure_message_when_negated: () -> String
         def description: () -> String
       end
+
+      class HaveStimulusClass
+        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
+
+      class HaveStimulusOutlet
+        def initialize: (String controller, String outlet, ?String? selector) -> 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.4.0
+  version: 0.5.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