stimulus_plumbers 0.2.7 → 0.2.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c89886ba431e3857285faa6f16e80f5f54cb4b2bf9fb69582be6f8c1395ddd67
-  data.tar.gz: 66f92918cfcb2c729047555955b17570a94574bc7512d1ba65e68515e447163a
+  metadata.gz: d76429866edf575ec9095b3e73a601255f68195aacba6db0dc40c3215786e8e7
+  data.tar.gz: 3e1051dd9edc8f3bfc4f2d4881f1e94f76c9af700fbf142c703f53efbaf6e511
 SHA512:
-  metadata.gz: d1ae00ceb5a566aff19e6ac1cc81232fff4783dfe2729174b8ba19e578f90b324c09882101cd55bd380053f1f5498e05829d457b3aea1d52cb8cc31bb0fc6298
-  data.tar.gz: 0b8ce29fe76ee4bf93ba709ec1714c0cd191dab7352136123b807c03b1ba50d355d6475d88274694c2e05e17ef56255da6ea1eb09cafac4b4f014c759f290c6f
+  metadata.gz: def84ab70ce388aaeb0267be2def55739fe9bd94ecb68d69327ea9061180cde93b8a4e68d3d54959aa7af995f67d22ead8eb70d6cf09f2de85a3a9a7735124d7
+  data.tar.gz: fd1bec2e6d8a28bb0f90390ddb7c32785e8ff24e7ec0c60bb3b5128625d8997904167282e58ac28493eee05b5a23f5a51d948d0a16a0af8b604c06dc88b2784d

data/CHANGELOG.md

@@ -0,0 +1,59 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. See [conventional commits](https://www.conventionalcommits.org/) for commit guidelines.
+
+---
+## [0.2.9](https://github.com/ryancyq/stimulus-plumbers/compare/stimulus-plumbers-rails/v0.2.8..stimulus-plumbers-rails/v0.2.9) - 2026-05-15
+
+### Bug Fixes
+
+- combobox options + theme ([#53](https://github.com/ryancyq/stimulus-plumbers/issues/53)) - ([38b8f56](https://github.com/ryancyq/stimulus-plumbers/commit/38b8f5632fd62ed62947d62567e704a0b8b46f74)) - Ryan Chang
+- update broken ruby action bindings ([#55](https://github.com/ryancyq/stimulus-plumbers/issues/55)) - ([f2259df](https://github.com/ryancyq/stimulus-plumbers/commit/f2259dfd8f2369bb588ee24fec3d9e8a8f854093)) - Ryan Chang
+
+### Documentation
+
+- update form input ([#49](https://github.com/ryancyq/stimulus-plumbers/issues/49)) - ([dd35b7f](https://github.com/ryancyq/stimulus-plumbers/commit/dd35b7fdadf5ffb8808b00c0c5b75542bcde4d02)) - Ryan Chang
+- update theme to align with implementation ([#57](https://github.com/ryancyq/stimulus-plumbers/issues/57)) - ([0645cfa](https://github.com/ryancyq/stimulus-plumbers/commit/0645cfa9896aa65082b7f2fd9e619d2216c13f75)) - Ryan Chang
+
+### Features
+
+- form input search ([#50](https://github.com/ryancyq/stimulus-plumbers/issues/50)) - ([130b966](https://github.com/ryancyq/stimulus-plumbers/commit/130b9666a644a54b94da5ba23f5d0b32a0458f53)) - Ryan Chang
+
+### Tests
+
+- code coverage report ([#48](https://github.com/ryancyq/stimulus-plumbers/issues/48)) - ([78950e6](https://github.com/ryancyq/stimulus-plumbers/commit/78950e603ac7e003b5c6361ab6016796caca3397)) - Ryan Chang
+
+---
+## [0.2.8](https://github.com/ryancyq/stimulus-plumbers/compare/stimulus-plumbers-rails/v0.2.7..stimulus-plumbers-rails/v0.2.8) - 2026-05-10
+
+### Features
+
+- input group ([#46](https://github.com/ryancyq/stimulus-plumbers/issues/46)) - ([a5e24f6](https://github.com/ryancyq/stimulus-plumbers/commit/a5e24f6dbc8b740822333164ceeefd7d20367f1b)) - Ryan Chang
+
+### Tests
+
+- theme coverage ([#45](https://github.com/ryancyq/stimulus-plumbers/issues/45)) - ([cc86565](https://github.com/ryancyq/stimulus-plumbers/commit/cc86565fd65a5b9dc390e838d379de75576d60ba)) - Ryan Chang
+
+---
+## [0.2.2] - 2026-04-14
+
+### Dependencies
+
+- migrate from rspec to minitest ([#16](https://github.com/ryancyq/stimulus-plumbers/issues/16)) - ([b183919](https://github.com/ryancyq/stimulus-plumbers/commit/b1839196235a7462d58bb2d3f9532388ffd916c2)) - Ryan Chang
+
+### Documentation
+
+- update claude.md - ([2b36f6d](https://github.com/ryancyq/stimulus-plumbers/commit/2b36f6dcf7ce7c9154c187b011c2f8cf4cc5b9f9)) - Ryan Chang
+
+### Features
+
+- stimulus plumbers rails gem ([#4](https://github.com/ryancyq/stimulus-plumbers/issues/4)) - ([e492e0f](https://github.com/ryancyq/stimulus-plumbers/commit/e492e0f910a6331328d52725f1931d9cd86c9563)) - Ryan Chang
+- stimulus-rails UI components ([#15](https://github.com/ryancyq/stimulus-plumbers/issues/15)) - ([8e8b58c](https://github.com/ryancyq/stimulus-plumbers/commit/8e8b58c661a7cd8c79d7e65b729e3ea077e596b9)) - Ryan Chang
+- form builder ([#21](https://github.com/ryancyq/stimulus-plumbers/issues/21)) - ([21aa9a6](https://github.com/ryancyq/stimulus-plumbers/commit/21aa9a634eca340e712f922f43ceb7383b56daee)) - Ryan Chang
+
+### Tests
+
+- a11y ([#17](https://github.com/ryancyq/stimulus-plumbers/issues/17)) - ([4109a8a](https://github.com/ryancyq/stimulus-plumbers/commit/4109a8af8be8aab06ddbcff35e870556a6205852)) - Ryan Chang
+- update rake test task to include system test - ([aa215b0](https://github.com/ryancyq/stimulus-plumbers/commit/aa215b0a84a36f32083327b4e7f03a646187cee9)) - Ryan Chang
+
+<!-- generated by git-cliff -->

data/README.md

@@ -1,75 +1,94 @@
-# Stimulus Plumbers
+# stimulus-plumbers-rails
 
-A library of semantically correct, accessible UI components for Rails 8.0+ using ViewComponent and Stimulus.
+[![Version][rubygems_badge]][rubygems]
+[![CI][ci_badge]][ci]
+[![Coverage][coverage_badge]][coverage]
 
-## Installation
+Rails helpers for accessible, WCAG 2.1 AA compliant UI components built on [Stimulus](https://stimulus.hotwired.dev/). Pairs with the [`@stimulus-plumbers/controllers`](../stimulus-plumbers) npm package.
+
+## Requirements
 
-Add this line to your application's Gemfile:
+- Ruby >= 3.0
+- Rails >= 6.1
+- `@stimulus-plumbers/controllers` registered in your Stimulus app
+
+## Installation
 
 ```ruby
-gem 'stimulus_plumbers'
+# Gemfile
+gem "stimulus_plumbers"
 ```
 
-And then execute:
-
 ```bash
 bundle install
 ```
 
-## Usage
+Include the helpers in your `ApplicationHelper`:
 
-Stimulus Plumbers provides ready-to-use ViewComponent components that render semantically correct, accessible HTML. Each component is designed with accessibility as a core requirement, not an afterthought.
+```ruby
+module ApplicationHelper
+  include StimulusPlumbers::Helpers::ComboboxHelper
+  include StimulusPlumbers::Helpers::PopoverHelper
+  include StimulusPlumbers::Helpers::CalendarHelper
+end
+```
 
-### Basic Example
+Or use the form builder globally:
 
-```erb
-<%# In your Rails view %>
-<%= render ButtonComponent.new(url: root_path) do %>
-  Click me
-<% end %>
+```ruby
+# config/application.rb
+config.action_view.default_form_builder = StimulusPlumbers::Form::Builder
 ```
 
-### Available Components
+## Components
 
-- **ActionList**: Accessible lists with items and sections
-- **Avatar**: User avatar component
-- **Button**: Semantic button with optional prefix/suffix
-- **Card**: Card component with sections
-- **Calendar**: Date calendar with navigation
-- **Container**: Layout container
-- **Divider**: Semantic divider/separator
-- **Dropdown**: Accessible dropdown menus
-- **Navigation**: Navigation bars, tabs, and lists
-- **Popover**: Accessible popover component
+| Component | Helper(s) | Docs |
+|-----------|-----------|------|
+| Combobox — date | `sp_combobox_date` | [docs/component/combobox.md](docs/component/combobox.md#sp_combobox_date) |
+| Combobox — dropdown | `sp_combobox_dropdown` | [docs/component/combobox.md](docs/component/combobox.md#sp_combobox_dropdown) |
+| Combobox — autocomplete | `sp_combobox_autocomplete` | [docs/component/combobox.md](docs/component/combobox.md#sp_combobox_autocomplete) |
+| Combobox — time | `sp_combobox_time` | [docs/component/combobox.md](docs/component/combobox.md#sp_combobox_time) |
+| Calendar | `sp_calendar_month` | [docs/component/calendar.md](docs/component/calendar.md) |
+| Popover | `sp_popover` | [docs/component/popover.md](docs/component/popover.md) |
+| Modal | — (JS only) | [docs/component/modal.md](docs/component/modal.md) |
 
-## Component Philosophy
+## Form Builder
 
-All components in this library follow these principles:
+`StimulusPlumbers::Form::Builder` wraps all components as model-aware form fields with automatic label, name/id, error, and ARIA wiring.
 
-1. **Accessibility First**: WCAG 2.1 Level AA minimum
-2. **Semantic HTML**: Use native elements before ARIA
-3. **Keyboard Navigation**: Full keyboard support
-4. **Screen Reader Friendly**: Proper announcements and labels
-5. **Focus Management**: Visible focus indicators and logical tab order
+→ [docs/component/form_builder.md](docs/component/form_builder.md)
 
-## Development
+## Theming
+
+Includes a Tailwind CSS theme out of the box. Supports custom themes by subclassing `Themes::Base`.
 
-After checking out the repo, run:
+→ [docs/component/theme.md](docs/component/theme.md)
+
+## Development
 
 ```bash
 bundle install
+
+bundle exec rake test:unit    # unit tests
+bundle exec rake test:system  # accessibility system tests
+bundle exec rake rubocop      # lint
 ```
 
-Run the test suite with:
+Test against a specific Rails version:
 
 ```bash
-bundle exec rspec
+BUNDLE_GEMFILE=gemfiles/rails_8.0.gemfile bundle exec rake test:unit
 ```
 
-## Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/ryancyq/stimulus-plumbers.
+Available appraisals: `rails_6.1`, `rails_7.0`, `rails_7.1`, `rails_7.2`, `rails_8.0`, `rails_8.1`, `rails_edge`.
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+[MIT](https://opensource.org/licenses/MIT)
+
+[rubygems_badge]: https://img.shields.io/gem/v/stimulus_plumbers.svg
+[rubygems]: https://rubygems.org/gems/stimulus_plumbers
+[ci_badge]: https://github.com/ryancyq/stimulus-plumbers/actions/workflows/ci-rails.yml/badge.svg
+[ci]: https://github.com/ryancyq/stimulus-plumbers/actions/workflows/ci-rails.yml
+[coverage_badge]: https://codecov.io/gh/ryancyq/stimulus-plumbers/graph/badge.svg?token=Z77H6M5GER&flag=ruby
+[coverage]: https://codecov.io/gh/ryancyq/stimulus-plumbers