stimulus_spec 0.1.0

checksums.yaml

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

data/.github/FUNDING.yml

@@ -0,0 +1,3 @@
+# These are supported funding model platforms
+
+github: [eclectic-coding]

data/.github/workflows/main.yml

@@ -0,0 +1,80 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+
+      - name: Run Rubocop
+        run: bundle exec rubocop
+
+  security:
+    name: Security audit
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+
+      - name: Run bundler-audit
+        run: bundle exec rake bundle:audit:update bundle:audit:check
+
+  test:
+    name: Ruby ${{ matrix.ruby }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby:
+          - "3.3"
+          - "3.4"
+          - "4.0"
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+
+      - name: Run test suite
+        run: bundle exec rake spec
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v5
+        if: matrix.ruby == '3.4'
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: coverage/coverage.json

data/.github/workflows/publish.yml

@@ -0,0 +1,41 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  publish:
+    name: Publish to RubyGems
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.4"
+          bundler-cache: true
+
+      - name: Run test suite
+        run: bundle exec rake
+
+      - name: Create GitHub Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh release create "${{ github.ref_name }}" \
+            --title "${{ github.ref_name }}" \
+            --notes "See [CHANGELOG.md](https://github.com/${{ github.repository }}/blob/main/CHANGELOG.md) for details." \
+            --verify-tag
+
+      - name: Publish to RubyGems
+        uses: rubygems/release-gem@v1
+        

data/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-06-22
+
+### Added
+
+- `StimulusSpec::Configuration` class with `auto_include` attribute (default `true`)
+- `StimulusSpec.configure`, `.configuration`, and `.reset_configuration!` class methods
+- `StimulusSpec.install_rspec_integration` — auto-includes matchers into `type: :request`, `:controller`, `:system`, and `:feature` example groups (gated on `stimulus-rails`)
+- `RSpec.configure` hook at load time (guarded by `defined?(RSpec)`)
+- `have_stimulus_controller(name)` matcher — asserts `[data-controller~="name"]` via Nokogiri
+- `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
+[0.1.0]: https://github.com/eclectic-coding/stimulus_spec/releases/tag/v0.1.0

data/CONTRIBUTING.md

@@ -0,0 +1,65 @@
+# Contributing to stimulus_spec
+
+Bug reports and pull requests are welcome. This guide covers everything you need to get up and running.
+
+## Setup
+
+```bash
+git clone https://github.com/eclectic-coding/stimulus_spec.git
+cd stimulus_spec
+bin/setup          # installs gems
+```
+
+## Running the suite
+
+```bash
+bundle exec rake                        # full suite: lint + tests (what CI runs)
+bundle exec rspec                       # tests only
+bundle exec rspec spec/path/to/foo_spec.rb       # single file
+bundle exec rspec spec/path/to/foo_spec.rb:42    # single example
+bundle exec rubocop                     # lint only
+```
+
+## Branch workflow
+
+Always work on a feature or chore branch — never commit directly to `main`:
+
+```
+feat/short-description    # new matchers, new API
+chore/short-description   # docs, tooling, dependency bumps
+fix/short-description     # bug fixes
+```
+
+## CHANGELOG
+
+Add an entry under `## [Unreleased]` **on your branch before opening a PR**, not after merging. Use these section headers in order (omit any that have no entries):
+
+```markdown
+### Added
+### Changed
+### Fixed
+```
+
+CHANGELOG entries are **user-facing only** — document changes to the public API. Pure internal refactors, docs updates, and CI fixes don't need an entry.
+
+## Pull requests
+
+1. Open a PR against `main`.
+2. All CI checks must pass: lint, security audit, and the full test matrix (Ruby 3.3–4.0).
+3. Link the relevant GitHub issue in the PR description (`Closes #N`).
+
+## Code conventions
+
+- **RuboCop** enforces style — run `bundle exec rubocop -A` to auto-correct before pushing.
+- New public methods need YARD `@param` and `@return` tags, and an entry in `sig/stimulus_spec.rbs`.
+- Private helpers don't need YARD docs.
+
+## Releasing (maintainers only)
+
+Releases are cut from `main` using the release script:
+
+```bash
+bin/release 1.2.0
+```
+
+This bumps the version, updates `CHANGELOG.md` and `Gemfile.lock`, commits, tags, and pushes. CI picks up the tag and publishes to RubyGems via Trusted Publishing.

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Chuck Smith
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,151 @@
+# StimulusSpec
+
+[![CI](https://github.com/eclectic-coding/stimulus_spec/actions/workflows/main.yml/badge.svg)](https://github.com/eclectic-coding/stimulus_spec/actions/workflows/main.yml)
+[![Gem Version](https://img.shields.io/gem/v/stimulus_spec)](https://rubygems.org/gems/stimulus_spec)
+[![Gem Downloads](https://img.shields.io/gem/dt/stimulus_spec)](https://rubygems.org/gems/stimulus_spec)
+[![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.3-ruby)](https://rubygems.org/gems/stimulus_spec)
+[![codecov](https://codecov.io/gh/eclectic-coding/stimulus_spec/branch/main/graph/badge.svg)](https://codecov.io/gh/eclectic-coding/stimulus_spec)
+
+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`
+- **Auto-included** — zero setup required when `stimulus-rails` is in your bundle
+- **Configurable** — disable auto-include when you need manual control
+
+Companion gem to [turbo_rspec](https://github.com/eclectic-coding/turbo_rspec) — together they cover the full Hotwire testing stack.
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Setup](#setup)
+- [Matchers](#matchers)
+  - [have\_stimulus\_controller](#have_stimulus_controller)
+  - [have\_stimulus\_action](#have_stimulus_action)
+  - [have\_stimulus\_target](#have_stimulus_target)
+- [Example](#example)
+- [Relationship to turbo\_rspec](#relationship-to-turbo_rspec)
+- [Contributing](#contributing)
+- [License](#license)
+
+## Installation
+
+Add to your application's `Gemfile`:
+
+```ruby
+group :test do
+  gem "stimulus_spec"
+end
+```
+
+[Back to top](#stimulusspec)
+
+## Setup
+
+### 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.
+
+### Manual include
+
+For non-Rails projects or custom contexts, include the matchers explicitly:
+
+```ruby
+# spec/spec_helper.rb
+RSpec.configure do |config|
+  config.include StimulusSpec::Matchers
+end
+```
+
+### Configuration
+
+```ruby
+# spec/support/stimulus_spec.rb
+StimulusSpec.configure do |config|
+  config.auto_include = false  # disable automatic inclusion
+end
+```
+
+[Back to top](#stimulusspec)
+
+## Matchers
+
+### `have_stimulus_controller`
+
+Assert that rendered HTML contains a `data-controller` attribute with the given controller name.
+
+```ruby
+expect(response).to have_stimulus_controller("hello")
+
+# Works with multiple controllers on a single element
+expect(response).to have_stimulus_controller("clipboard")
+
+# Negation
+expect(response).not_to have_stimulus_controller("missing")
+```
+
+Uses space-separated token matching (`~=`), so it works correctly when multiple controllers are declared on a single element and won't partially match.
+
+### `have_stimulus_action`
+
+Assert that rendered HTML contains a `data-action` attribute with the given action descriptor.
+
+```ruby
+# Full descriptor
+expect(response).to have_stimulus_action("click->hello#greet")
+
+# Shorthand — matches any event
+expect(response).to have_stimulus_action("hello#greet")
+
+# Negation
+expect(response).not_to have_stimulus_action("hello#disconnect")
+```
+
+### `have_stimulus_target`
+
+Assert that rendered HTML contains a `data-{controller}-target` attribute with the given target name.
+
+```ruby
+expect(response).to have_stimulus_target("hello", "name")
+expect(response).to have_stimulus_target("hello", "output")
+
+# Negation
+expect(response).not_to have_stimulus_target("hello", "missing")
+```
+
+[Back to top](#stimulusspec)
+
+## Example
+
+```ruby
+RSpec.describe "Search", type: :request do
+  describe "GET /search" do
+    it "wires up the search controller" do
+      get search_path
+
+      expect(response).to have_stimulus_controller("search")
+      expect(response).to have_stimulus_action("input->search#query")
+      expect(response).to have_stimulus_target("search", "input")
+    end
+  end
+end
+```
+
+[Back to top](#stimulusspec)
+
+## Relationship to turbo_rspec
+
+[turbo_rspec](https://github.com/eclectic-coding/turbo_rspec) includes basic Stimulus matchers (`have_stimulus_controller`, `have_stimulus_action`, `have_stimulus_target`). **stimulus_spec** goes deeper with value, class, and outlet matchers, plus richer failure messages and Stimulus-specific configuration. If you only need basic controller/action/target assertions alongside your Turbo matchers, turbo_rspec has you covered. If you want comprehensive Stimulus testing, use stimulus_spec.
+
+Both gems can coexist — they use separate namespaces and won't conflict.
+
+[Back to top](#stimulusspec)
+
+## Contributing
+
+Bug reports and pull requests are welcome on [GitHub](https://github.com/eclectic-coding/stimulus_spec). See [CONTRIBUTING.md](CONTRIBUTING.md) for setup instructions, branch conventions, CHANGELOG requirements, and the PR checklist.
+
+## License
+
+The gem is available as open source under the [MIT License](https://opensource.org/licenses/MIT).
+
+[Back to top](#stimulusspec)

data/ROADMAP.md

@@ -0,0 +1,55 @@
+# stimulus_spec Roadmap
+
+RSpec matchers for [Stimulus](https://github.com/hotwired/stimulus-rails): controllers, actions, targets, values, classes, and outlets. The goal is to replace hand-rolled `data-controller` assertions with expressive, purpose-built matchers.
+
+## Guiding principles
+
+- **Zero magic by default.** Auto-include only when it's unambiguous (Rails request specs with `stimulus-rails` present). Everything else is opt-in.
+- **Fail loudly with useful output.** A cryptic failure message is a bug. Show what was expected, what was found, and the relevant HTML.
+- **Stay close to Stimulus conventions.** Matcher names and arguments mirror Stimulus's `data-*` attribute conventions so the docs cross-reference naturally.
+- **Pure test helper.** No Rails engine, no generators, no runtime code — just matchers you include in your specs.
+
+---
+
+## 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
+- `docs/cookbook.md` — common patterns: request specs, system specs, multi-controller elements, typed values, outlets
+- Graceful no-op when `stimulus-rails` is not bundled (no `LoadError`)
+
+---
+
+## 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

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "rubocop/rake_task"
+require "bundler/audit/task"
+
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new
+Bundler::Audit::Task.new
+
+task default: ["bundle:audit:update", "bundle:audit:check", :rubocop, :spec]

data/codecov.yml

@@ -0,0 +1,14 @@
+comment:
+  layout: "reach, diff, flags, files"
+  behavior: default
+  # Only post or update the comment if the coverage drops
+  require_changes: "coverage_drop"
+
+coverage:
+  status:
+    project:
+      default:
+        informational: false
+    patch:
+      default:
+        informational: false

data/lib/stimulus_spec/configuration.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module StimulusSpec
+  class Configuration
+    attr_accessor :auto_include
+
+    def initialize
+      @auto_include = true
+    end
+  end
+end

data/lib/stimulus_spec/matchers/have_stimulus_action.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module StimulusSpec
+  module Matchers
+    class HaveStimulusAction
+      def initialize(descriptor)
+        @descriptor = descriptor.to_s
+      end
+
+      def matches?(subject)
+        @body = extract_body(subject)
+        if @descriptor.include?("->")
+          !document.at_css("[data-action~='#{@descriptor}']").nil?
+        else
+          !document.at_css("[data-action*='#{@descriptor}']").nil?
+        end
+      end
+
+      def does_not_match?(subject)
+        !matches?(subject)
+      end
+
+      def failure_message
+        "expected to find an element with data-action=\"#{@descriptor}\" but found none in:\n#{@body}"
+      end
+
+      def failure_message_when_negated
+        "expected not to find an element with data-action=\"#{@descriptor}\" but found one"
+      end
+
+      def description
+        "have Stimulus action \"#{@descriptor}\""
+      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_action(descriptor)
+      HaveStimulusAction.new(descriptor)
+    end
+  end
+end

data/lib/stimulus_spec/matchers/have_stimulus_controller.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module StimulusSpec
+  module Matchers
+    class HaveStimulusController
+      def initialize(name)
+        @name = name.to_s
+      end
+
+      def matches?(subject)
+        @body = extract_body(subject)
+        !document.at_css("[data-controller~='#{@name}']").nil?
+      end
+
+      def does_not_match?(subject)
+        !matches?(subject)
+      end
+
+      def failure_message
+        "expected to find an element with data-controller=\"#{@name}\" but found none in:\n#{@body}"
+      end
+
+      def failure_message_when_negated
+        "expected not to find an element with data-controller=\"#{@name}\" but found one"
+      end
+
+      def description
+        "have Stimulus controller \"#{@name}\""
+      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_controller(name)
+      HaveStimulusController.new(name)
+    end
+  end
+end

data/lib/stimulus_spec/matchers/have_stimulus_target.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module StimulusSpec
+  module Matchers
+    class HaveStimulusTarget
+      def initialize(controller, target)
+        @controller = controller.to_s
+        @target = target.to_s
+      end
+
+      def matches?(subject)
+        @body = extract_body(subject)
+        !document.at_css("[data-#{@controller}-target~='#{@target}']").nil?
+      end
+
+      def does_not_match?(subject)
+        !matches?(subject)
+      end
+
+      def failure_message
+        "expected to find an element with data-#{@controller}-target=\"#{@target}\" but found none in:\n#{@body}"
+      end
+
+      def failure_message_when_negated
+        "expected not to find an element with data-#{@controller}-target=\"#{@target}\" but found one"
+      end
+
+      def description
+        "have Stimulus target \"#{@target}\" for controller \"#{@controller}\""
+      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_target(controller, target)
+      HaveStimulusTarget.new(controller, target)
+    end
+  end
+end

data/lib/stimulus_spec/matchers.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "nokogiri"
+
+require_relative "matchers/have_stimulus_controller"
+require_relative "matchers/have_stimulus_action"
+require_relative "matchers/have_stimulus_target"
+
+module StimulusSpec
+  module Matchers
+  end
+end

data/lib/stimulus_spec/version.rb

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

data/lib/stimulus_spec.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require_relative "stimulus_spec/version"
+require_relative "stimulus_spec/configuration"
+require_relative "stimulus_spec/matchers"
+
+module StimulusSpec
+  class Error < StandardError; end
+
+  def self.configuration
+    @configuration ||= Configuration.new
+  end
+
+  def self.configure
+    yield configuration
+  end
+
+  def self.reset_configuration!
+    @configuration = Configuration.new
+  end
+
+  def self.install_rspec_integration(config)
+    return unless Gem.loaded_specs.key?("stimulus-rails")
+    return unless configuration.auto_include
+
+    %i[request controller system feature].each do |type|
+      config.include StimulusSpec::Matchers, type: type
+    end
+  end
+end
+
+# :nocov:
+if defined?(RSpec)
+  RSpec.configure do |config|
+    StimulusSpec.install_rspec_integration(config)
+  end
+end
+# :nocov:

data/sig/stimulus_spec.rbs

@@ -0,0 +1,47 @@
+module StimulusSpec
+  VERSION: String
+
+  def self.configuration: () -> Configuration
+  def self.configure: () { (Configuration) -> void } -> void
+  def self.reset_configuration!: () -> Configuration
+  def self.install_rspec_integration: (untyped config) -> void
+
+  class Configuration
+    attr_accessor auto_include: bool
+
+    def initialize: () -> void
+  end
+
+  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
+
+    class HaveStimulusController
+      def initialize: (String name) -> 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 HaveStimulusAction
+      def initialize: (String descriptor) -> 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 HaveStimulusTarget
+      def initialize: (String controller, String target) -> 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

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: stimulus_spec
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Chuck Smith
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.13'
+description: 'Drop-in RSpec matchers for hotwired/stimulus-rails: assert Stimulus
+  controllers, actions, targets, values, classes, and outlets in your view and system
+  specs. Includes Capybara matchers for live-page assertions and request-spec matchers
+  for rendered HTML — all auto-included with zero setup.'
+email:
+- eclectic-coding@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/FUNDING.yml"
+- ".github/workflows/main.yml"
+- ".github/workflows/publish.yml"
+- CHANGELOG.md
+- CONTRIBUTING.md
+- LICENSE.txt
+- README.md
+- ROADMAP.md
+- Rakefile
+- codecov.yml
+- lib/stimulus_spec.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_controller.rb
+- lib/stimulus_spec/matchers/have_stimulus_target.rb
+- lib/stimulus_spec/version.rb
+- sig/stimulus_spec.rbs
+homepage: https://github.com/eclectic-coding/stimulus_spec
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/eclectic-coding/stimulus_spec
+  source_code_uri: https://github.com/eclectic-coding/stimulus_spec
+  changelog_uri: https://github.com/eclectic-coding/stimulus_spec/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: RSpec matchers for testing Stimulus controllers in Rails applications.
+test_files: []