stimulus_spec 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 31b3ef6e3b0ef09e3f6353d975ee2a65dd7c42dbc4d3be8aa78c7508b88d9ba7
-  data.tar.gz: 5f79191a5baccfabe6a8502fa8708248dc71efe1ba63d87f816a2c882ad5e941
+  metadata.gz: 6b9e26e1184c0d81c9ebcdffd070ab00c4822f76de661fc229178e2989497588
+  data.tar.gz: 91e8c98384c15baba42e7bb5022a47eb14756a236ea6f2b340cf85ecc9bb4db7
 SHA512:
-  metadata.gz: 6b789aa21b411f503223b5c6116507f48168cfd675ea198c4c3a8cf68490754ebcaf0bcdea718c4cf492400cf3df6eba5d0079c41b2e2ce48020165b6b4bb348
-  data.tar.gz: 97623a443042991da1c942449406f0e92c0b8918d8a9bdbd8b001962c0c238db103d0d2cc9d27a3aff05bd75256d65b593686876fd731f883f8a5c0547af9d0d
+  metadata.gz: 3bbf987dbddff7265d933f041e11d2e1223bfd923d855c8836721cc3b5379534b8100e099d7e3952cfba280d26feee50f07000aae6910ccf2c3c86c9cc71eac9
+  data.tar.gz: 2d9372a0337c758b3f41eee17f6b650b285bc38e109b972017b41befdc2462f9bd0a9ac1adbcf8be1da2e7615c1cdfd1c1bf9c3b0ab3e017b4156ec84a5bbc54

data/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.0] - 2026-06-23
+
+### Added
+
+- `bin/benchmark` script for measuring matcher overhead
+- Version spec enforcing semver format on `StimulusSpec::VERSION`
+- `docs/migration_guide.md` for migrating from turbo_rspec's Stimulus matchers
+- Guiding principles section in README
+
 ## [0.7.0] - 2026-06-23
 
 ### Added
@@ -61,7 +70,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.7.0...HEAD
+[Unreleased]: https://github.com/eclectic-coding/stimulus_spec/compare/v0.8.0...HEAD
+[0.8.0]: https://github.com/eclectic-coding/stimulus_spec/releases/tag/v0.8.0
 [0.7.0]: https://github.com/eclectic-coding/stimulus_spec/releases/tag/v0.7.0
 [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

data/ROADMAP.md

@@ -1,8 +1,3 @@
 # stimulus_spec Roadmap
 
-## 1.0.0 — Stable API
-
-- API freeze — public method signatures are part of the semver contract
-- `bin/benchmark` — matcher overhead measurement
-- Version spec (semver format enforced)
-- `docs/migration_guide.md` — migrating from turbo_rspec's Stimulus matchers to stimulus_spec
+All planned milestones through 0.8.0 have been completed. Gathering user feedback before a 1.0.0 release.

data/docs/migration_guide.md

@@ -0,0 +1,84 @@
+# Migrating from turbo_rspec to stimulus_spec
+
+[turbo_rspec](https://github.com/eclectic-coding/turbo_rspec) includes basic Stimulus matchers: `have_stimulus_controller`, `have_stimulus_action`, and `have_stimulus_target`. **stimulus_spec** provides the same three matchers plus `have_stimulus_value`, `have_stimulus_class`, `have_stimulus_outlet`, multi-controller assertions, and scoped matching.
+
+Both gems can coexist — they use separate namespaces (`TurboRspec::Matchers` vs `StimulusSpec::Matchers`) and won't conflict. You can migrate incrementally.
+
+## Step 1: Add stimulus_spec
+
+```ruby
+# Gemfile
+group :test do
+  gem "stimulus_spec"
+end
+```
+
+```bash
+bundle install
+```
+
+With `stimulus-rails` in your bundle, `stimulus_spec` auto-includes its matchers into request, controller, system, and feature specs. No configuration needed.
+
+## Step 2: Verify existing tests pass
+
+Your existing turbo_rspec Stimulus matchers (`TurboRspec::Matchers`) will continue to work alongside `StimulusSpec::Matchers`. Run your test suite to confirm nothing breaks:
+
+```bash
+bundle exec rspec
+```
+
+## Step 3: Switch namespaces (optional)
+
+If you manually include turbo_rspec's Stimulus matchers, update to the stimulus_spec equivalents:
+
+```ruby
+# Before
+config.include TurboRspec::Matchers, type: :request
+
+# After
+config.include StimulusSpec::Matchers, type: :request
+config.include StimulusSpec::Capybara::Matchers, type: :system
+```
+
+If you rely on auto-include (the default for both gems), this step is unnecessary — both sets of matchers are already available.
+
+## Step 4: Use new matchers
+
+With stimulus_spec installed, you now have access to matchers that turbo_rspec doesn't provide:
+
+```ruby
+# Value assertions
+expect(response).to have_stimulus_value("search", "url", "/results")
+
+# CSS class assertions
+expect(response).to have_stimulus_class("search", "loading", "opacity-50")
+
+# Outlet assertions
+expect(response).to have_stimulus_outlet("search", "results", "#results-list")
+
+# Multi-controller on a single element
+expect(response).to have_stimulus_controller("hello", "clipboard")
+
+# Scoped matching
+expect(response).to have_stimulus_controller("search").within(".search-form")
+```
+
+## Matcher comparison
+
+| Matcher | turbo_rspec | stimulus_spec |
+|---|---|---|
+| `have_stimulus_controller` | Single name | Single or multiple names |
+| `have_stimulus_action` | Full or shorthand | Full or shorthand |
+| `have_stimulus_target` | Controller + target | Controller + target |
+| `have_stimulus_value` | — | Existence or equality |
+| `have_stimulus_class` | — | Existence or equality |
+| `have_stimulus_outlet` | — | Existence or selector |
+| `.within(selector)` | — | All matchers |
+| Capybara variants | Controller, action, target | All six matchers |
+| Failure messages | Basic | Shows found values and HTML context |
+
+## Step 5: Remove turbo_rspec Stimulus matchers (optional)
+
+If you want to fully consolidate, you can stop including turbo_rspec's Stimulus matchers. turbo_rspec's Turbo-specific matchers (`have_turbo_frame`, `have_turbo_stream`, etc.) are unaffected — only the Stimulus matchers overlap.
+
+If you use turbo_rspec solely for Turbo matchers, no changes are needed. Both gems coexist cleanly.

data/lib/stimulus_spec/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stimulus_spec
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -45,6 +45,7 @@ files:
 - Rakefile
 - codecov.yml
 - docs/cookbook.md
+- docs/migration_guide.md
 - lib/stimulus_spec.rb
 - lib/stimulus_spec/capybara/matchers.rb
 - lib/stimulus_spec/capybara/matchers/have_stimulus_action.rb