stimulus_table_filter 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd1d293fa4373f23cb2eb542feb797e20b73b994564af5422e1bb69cfb370af4
-  data.tar.gz: 80a795894d382356b03d83ab003727c4dd5e786f81ca140106b33417ecabeab6
+  metadata.gz: 6f91c052d06053053b3a16d10850b67601c6adb56cf6b700e5185754d71113a3
+  data.tar.gz: 2300a0935a51a39f7b3efdb9a43350095e16d9ff5d7c2d07f72e880de28eabc5
 SHA512:
-  metadata.gz: d27af095bbddab3441ed10e65215c2e92c2bdbb2d10111ac4ffee02adc7fc9ee0898087019329b43e2b649d8f5119be42639ab2ba150a427ab5be5e9ce0b17f6
-  data.tar.gz: 8d52a264133b2aed8e2737392b6ba0a86443f35b95be1a0942204e04297cb86b05e5e6100ffcac25a42e81c5a7f122c0632b5cbe8bd8bbdfb7f7d85ad2c577f6
+  metadata.gz: 253a33fc42231ab85a0df2b4e99ccbc557c08f12d15ec8498d5518a165a04a5d7273901f6af6dfa5053909c1233a37895d8ff8d20686c624ce71c1571df5c918
+  data.tar.gz: 4606468cc32babe89d61bbab8729bf211e4c34d9b77a06a4f4eff4f5d706523ce295aa75e13795b1dcf1c0f0cce88d9a965d5b5dcd282fc15896ced0b9577097

data/CHANGELOG.md

@@ -3,6 +3,13 @@
 All notable changes to this project will be documented in this file.
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.1.1] - 2026-08-31
+
+- `table_filter_container_tag` accepts a `search:` option and emits
+  `data-table-filter-search-value`, matching the documented data-attribute contract
+- README: document that `table_filter_footer_tag` wraps its content in a footer element, a
+  `<tr>` and a `<td>`; correct the URL-state and programmatic-API behavior notes
+
 ## [0.1.0] - 2026-08-25
 
 Initial release.
@@ -13,4 +20,5 @@ Initial release.
 - RSpec support: shared examples plus `have_data` / `have_data_target` matchers
 - CI: RuboCop, RSpec and JavaScript tests across Ruby 3.2–3.4 and Rails 7.0–8.1
 
+[0.1.1]: https://github.com/icoluccio/stimulus-table-filter/releases/tag/v0.1.1
 [0.1.0]: https://github.com/icoluccio/stimulus-table-filter/releases/tag/v0.1.0

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    stimulus_table_filter (0.1.0)
+    stimulus_table_filter (0.1.1)
       railties (>= 7.0, < 9)
 
 GEM
@@ -285,7 +285,7 @@ CHECKSUMS
   securerandom (0.4.1) sha256=cc5193d414a4341b6e225f0cb4446aceca8e50d5e1888743fac16987638ea0b1
   sexp_processor (4.17.5) sha256=ae2b48ba98353d5d465ce8759836b7a05f2e12c5879fcd14d7815b026de32f0e
   simplecov (1.1.1) sha256=25825ef13f0b2e74694d769817dad6ab8e90131dabdaa666e522fea105521e78
-  stimulus_table_filter (0.1.0)
+  stimulus_table_filter (0.1.1)
   thor (1.5.0) sha256=e3a9e55fe857e44859ce104a84675ab6e8cd59c650a49106a05f55f136425e73
   tsort (0.2.0) sha256=9650a793f6859a43b6641671278f79cfead60ac714148aabe4e3f0060480089f
   tzinfo (2.0.6) sha256=8daf828cc77bcf7d63b0e3bdb6caa47e2272dcfaf4fbfe46f8c3a9df087a829b

data/README.md

@@ -176,6 +176,7 @@ the controller reads on connect.
 | `page_size:` | `nil` | Rows per page (omit or `0` to disable pagination) |
 | `url_key:` | `nil` | URL param prefix (default `tf`); set per table to namespace multiple tables |
 | `debounce_ms:` | `nil` | Search debounce in ms (default `0` = immediate) |
+| `search:` | `nil` | Initial search text (emits `data-table-filter-search-value`) |
 | `tag:` | `:div` | Wrapping HTML element |
 
 Every helper accepts `**opts` and passes them through to the underlying tag.
@@ -315,6 +316,9 @@ The default footer shows how many rows match the current filter and search, out
 <!-- renders: <span>12</span> of <span>87</span> -->
 ```
 
+The helper wraps the content in the footer element (a `<tfoot>` by default), a `<tr>`, and a
+`<td>`; `colspan:` applies to that cell and `tag:` replaces only the outer element.
+
 Or build your own footer. The block receives the match-count and total-count spans:
 
 ```erb
@@ -399,11 +403,14 @@ Behavior notes:
 - **Footer stats**: the match count covers every row that passes the active filters and search,
   across all pages. Count tags populate with the number of matching rows whose dimension value
   equals the tag's value.
-- **URL state**: every filter dimension, sort, direction, page and search sync to
-  `URLSearchParams` on every change (dimensions as `tf_filter_{dimension}` params) and the
-  controller restores them on connect. Namespace multiple tables with `data-table-filter-url-key-value`.
+- **URL state**: the controller syncs filter dimensions, sort, direction, page and search to
+  `URLSearchParams` when the user changes them (dimensions as `tf_filter_{dimension}` params)
+  and restores them on connect without rewriting the URL. Namespace multiple tables with
+  `data-table-filter-url-key-value`.
 - **Event handling**: the controller delegates all events itself; individual elements
-  need no `data-action`. `setFilter`, `sortBy` and `search` are also callable programmatically.
+  need no `data-action`. Call `search()` programmatically. For filters and sort, set the
+  Stimulus values and refresh, e.g.
+  `controller.filterDimensionsValue = { status: 'active' }; controller.refresh()`.
 
 ### RSpec shared examples
 

data/app/assets/javascripts/stimulus_table_filter/table_filter_controller.js

@@ -38,6 +38,7 @@ export default class extends Controller {
 
   connect() {
     this.#readUrlState()
+    if (this.hasSearchTarget && this.searchValue) this.searchTarget.value = this.searchValue
     this.element.addEventListener("click",  this.#onClick)
     this.element.addEventListener("input",  this.#onInput)
     this.element.addEventListener("change", this.#onChange)

data/lib/stimulus_table_filter/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module StimulusTableFilter
-  VERSION = '0.1.0'
+  VERSION = '0.1.1'
 end

data/lib/stimulus_table_filter/view_helper/container.rb

@@ -3,9 +3,9 @@
 module StimulusTableFilter
   module ViewHelper
     def table_filter_container_tag(sort: 'name', dir: 'asc', page: nil, page_size: nil, url_key: nil,
-                                   debounce_ms: nil, tag: :div, **opts, &)
+                                   debounce_ms: nil, search: nil, tag: :div, **opts, &)
       data = container_data(sort:, dir:, page:, page_size:, url_key:,
-                            debounce_ms:).merge(opts.delete(:data) || {})
+                            debounce_ms:, search:).merge(opts.delete(:data) || {})
       content_tag(tag, data: data, **opts, &)
     end
 
@@ -17,11 +17,12 @@ module StimulusTableFilter
       base
     end
 
-    def container_data(sort:, dir:, page: nil, page_size: nil, url_key: nil, debounce_ms: nil)
+    def container_data(sort:, dir:, page: nil, page_size: nil, url_key: nil, debounce_ms: nil, search: nil)
       base = base_container_data(sort:, dir:, page:)
       base = base.merge(table_filter_page_size_value: page_size.to_s)     if page_size
       base = base.merge(table_filter_url_key_value: url_key.to_s)         if url_key
       base = base.merge(table_filter_debounce_ms_value: debounce_ms.to_s) if debounce_ms
+      base = base.merge(table_filter_search_value: search.to_s)           if search
       base
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stimulus_table_filter
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - icoluccio