stimulus_spec 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b3c093ad148d096d99e96b88f18c7f90814878425dc7c531c4aba4af4149cd81
-  data.tar.gz: 3e938ad72982b139830f45815c1cc6d4c457f9e8f60af4d1bf362a7cbb641fb6
+  metadata.gz: ffe129c9b92bcc3dfe29e7dd6e9be508fd7c14b99603ca7524f964679fe42b6c
+  data.tar.gz: a254bb73a1d5e275637e477a333e3bea6ab4248b7555e1d1d3f4bf74de9f213c
 SHA512:
-  metadata.gz: 50ff8b23e522757c5bc8387a27b00299db7c7f23b1134cbe6fbe204bebf005b825ba1e621546c681c47eaa6f7ec28e7418b17672e87fea7c01dcf5bea6425910
-  data.tar.gz: cd08d477efb9bab97f956c943f30e88ebbfc5362d73fe9ede1af2d448e0125c00fe67a6b601361abf37396a996ccdb9fe2c550d0f346dc884f8caa647e9caa00
+  metadata.gz: '038f5d80f4a0b38bc9e0664bb3d476db0af508580bc6476095d2791fe65cb7f515e06d1116fecdc8570f559aaf77331fac6c06e5fa2e0b41b7616b6eb652e069'
+  data.tar.gz: cc7ed0ded4e4db2426532aeef9a2dcf2ab92aee3b27bf5af792921a70e3ccdfefc84cb679a7004e0231b385a1c6c3254178a5142eccc499dadc31b947711f73a

data/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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 +28,6 @@ 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.3.0...HEAD
+[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,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`
+- **Request/controller specs** — `have_stimulus_controller`, `have_stimulus_action`, `have_stimulus_target`, `have_stimulus_value`, `have_stimulus_class`
 - **Auto-included** — zero setup required when `stimulus-rails` is in your bundle
 - **Configurable** — disable auto-include when you need manual control
 
@@ -22,6 +22,8 @@ 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)
 - [Example](#example)
 - [Relationship to turbo\_rspec](#relationship-to-turbo_rspec)
 - [Contributing](#contributing)
@@ -112,6 +114,36 @@ 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")
+```
+
 [Back to top](#stimulusspec)
 
 ## Example

data/ROADMAP.md

@@ -11,23 +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
 

data/lib/stimulus_spec/matchers/have_stimulus_class.rb

@@ -0,0 +1,65 @@
+# 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)
+        element = document.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}\""
+        else
+          "expected to find an element with #{@attr} but found none in:\n#{@body}"
+        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 document
+        Nokogiri::HTML5.fragment(@body)
+      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_value.rb

@@ -0,0 +1,65 @@
+# 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)
+        element = document.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}\""
+        else
+          "expected to find an element with #{@attr} but found none in:\n#{@body}"
+        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 document
+        Nokogiri::HTML5.fragment(@body)
+      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,8 @@ 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"
 
 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.3.0"
 end

data/sig/stimulus_spec.rbs

@@ -16,6 +16,8 @@ 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
 
     class HaveStimulusController
       def initialize: (String name) -> void
@@ -43,5 +45,23 @@ 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
   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.3.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -47,8 +47,10 @@ files:
 - 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_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