stimulus_plumbers 0.4.8 → 0.4.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b138245a7a9711414d5c7bf052dbd55d42006f5e785626fd94bce96ffab6281d
-  data.tar.gz: e2e15e550f5678eecbfc7310628759590212fae21aa42c7eab60d7c049f2a47f
+  metadata.gz: 8be63032403e88984349219e9e9e04c838a59cdc1f44788e1f9969464a6d3798
+  data.tar.gz: 346503ca2ab321ad122aa7e713cc12af068adc0470a5e88a4e65733851849b34
 SHA512:
-  metadata.gz: 624a411ff21cb32deebdde9a3c68c0d0c43fed7ade306cc7299fdaadca7604a3053a2f9251df1608af393fc0129bffd75b6e244b9fd9e0477a4df72f859e0ddb
-  data.tar.gz: 8176752b32e5e730e7c8a47ba5aa44d96b591a38c44d0a71ad6d2d147404227b02aa581b00db36711da357cda872b96260187b62749e74f652acb2bd1a26a970
+  metadata.gz: 32ee19bb45ed9e0cbe7e18bca963c14f3abda9bb2eaf0600a661766a8543c889ce488e7fd35224e1217a8720057cbed34e63e7adfbaf610eef7db2f545a97e2e
+  data.tar.gz: 2a26e5c8e76e6b86485f873b0116877aed755a55bb77a4d8e298333ea2d33cbf6172803572194649bc7647e7e63f566d4a0dc572777d540e1c813c7b0876c650

data/CHANGELOG.md

@@ -2,6 +2,45 @@
 
 All notable changes to this project will be documented in this file. See [conventional commits](https://www.conventionalcommits.org/) for commit guidelines.
 
+---
+## [0.4.9](https://github.com/ryancyq/stimulus-plumbers/compare/stimulus-plumbers-rails/v0.4.8..stimulus-plumbers-rails/v0.4.9) - 2026-07-18
+
+### Bug Fixes
+
+- css source + token in generator ([#163](https://github.com/ryancyq/stimulus-plumbers/issues/163)) - ([69165f5](https://github.com/ryancyq/stimulus-plumbers/commit/69165f523242e27cae5075f635c7e66c40a862ab)) - Ryan Chang
+- update default color palette - ([0d6199a](https://github.com/ryancyq/stimulus-plumbers/commit/0d6199a9748e9f9221079689034e94940a7de7fc)) - Ryan Chang
+
+### Documentation
+
+- update missing documentation ([#164](https://github.com/ryancyq/stimulus-plumbers/issues/164)) - ([edcd79d](https://github.com/ryancyq/stimulus-plumbers/commit/edcd79df3dd1739521641274863a50a32b5fcb36)) - Ryan Chang
+- align code example/instructions in doc and remove stale reference ([#167](https://github.com/ryancyq/stimulus-plumbers/issues/167)) - ([b1ace4d](https://github.com/ryancyq/stimulus-plumbers/commit/b1ace4da5117b70f4f22403f727655c1586606e1)) - Ryan Chang
+- update component documentation ([#173](https://github.com/ryancyq/stimulus-plumbers/issues/173)) - ([27240bc](https://github.com/ryancyq/stimulus-plumbers/commit/27240bc85265b249adba5186fd34b9c26423daa3)) - Ryan Chang
+
+### Features
+
+- reorderable ([#165](https://github.com/ryancyq/stimulus-plumbers/issues/165)) - ([53277c5](https://github.com/ryancyq/stimulus-plumbers/commit/53277c584bc6f54581315028d401c64761ee8474)) - Ryan Chang
+- ordered list ([#166](https://github.com/ryancyq/stimulus-plumbers/issues/166)) - ([cda05b5](https://github.com/ryancyq/stimulus-plumbers/commit/cda05b589e2f99ba992785fdb672b0ecef026046)) - Ryan Chang
+- progress ring/bar/meter ([#170](https://github.com/ryancyq/stimulus-plumbers/issues/170)) - ([b43087c](https://github.com/ryancyq/stimulus-plumbers/commit/b43087cec2b40fd8b3dced65215afdbbdfc2c435)) - Ryan Chang
+- status indicator ([#171](https://github.com/ryancyq/stimulus-plumbers/issues/171)) - ([ad3f330](https://github.com/ryancyq/stimulus-plumbers/commit/ad3f330bc8d999b4977f8aeaafc8c4763229a448)) - Ryan Chang
+- horizontal grouped timeline ([#172](https://github.com/ryancyq/stimulus-plumbers/issues/172)) - ([fe9b9ab](https://github.com/ryancyq/stimulus-plumbers/commit/fe9b9abfb8c3c211fe9a7282d2940326678328dc)) - Ryan Chang
+- checklist ([#174](https://github.com/ryancyq/stimulus-plumbers/issues/174)) - ([35dca2a](https://github.com/ryancyq/stimulus-plumbers/commit/35dca2af29955f6f2c85fffc4efc39711ed5bb99)) - Ryan Chang
+
+---
+## [0.4.8](https://github.com/ryancyq/stimulus-plumbers/compare/stimulus-plumbers-rails/v0.4.5..stimulus-plumbers-rails/v0.4.8) - 2026-07-03
+
+### Bug Fixes
+
+- tailwind install generator ([#154](https://github.com/ryancyq/stimulus-plumbers/issues/154)) - ([db4bda0](https://github.com/ryancyq/stimulus-plumbers/commit/db4bda0b899a463e0608229927c65326233dd3a4)) - Ryan Chang
+- plumber slots should yield proc/block via template capture instead of ruby call ([#156](https://github.com/ryancyq/stimulus-plumbers/issues/156)) - ([5b9039c](https://github.com/ryancyq/stimulus-plumbers/commit/5b9039cf7c88222cfae4865e4b7373c8b5e3c010)) - Ryan Chang
+- tailwind theme registration + activation (rails only) ([#157](https://github.com/ryancyq/stimulus-plumbers/issues/157)) - ([5998854](https://github.com/ryancyq/stimulus-plumbers/commit/5998854ed2a6ca9c67aa225f3c397e4f7bca7a51)) - Ryan Chang
+- reorganize mcp resources + tools ([#161](https://github.com/ryancyq/stimulus-plumbers/issues/161)) - ([2a63580](https://github.com/ryancyq/stimulus-plumbers/commit/2a635800ac439173b5c2eeeb2dc268dc3136f415)) - Ryan Chang
+- mcp doc update + new tools validations ([#162](https://github.com/ryancyq/stimulus-plumbers/issues/162)) - ([beed1bb](https://github.com/ryancyq/stimulus-plumbers/commit/beed1bb14cbfcb8ec6f757145dc6a461d357c060)) - Ryan Chang
+
+### Features
+
+- **(mcp)** add Aria plugin exposing aria://reference ([#159](https://github.com/ryancyq/stimulus-plumbers/issues/159)) - ([15d730d](https://github.com/ryancyq/stimulus-plumbers/commit/15d730d51ce8a956d5ba7c3172a5883ad072d219)) - Ryan Chang
+- add StimulusControllerDocs plugin exposing stimulus://docs/{name} ([#160](https://github.com/ryancyq/stimulus-plumbers/issues/160)) - ([beef823](https://github.com/ryancyq/stimulus-plumbers/commit/beef823f2c694623b714823a0dacf8f3c89341e9)) - Ryan Chang
+
 ---
 ## [0.4.5](https://github.com/ryancyq/stimulus-plumbers/compare/stimulus-plumbers-rails/v0.4.4..stimulus-plumbers-rails/v0.4.5) - 2026-07-01
 

data/README.md

@@ -42,19 +42,13 @@ Or use the form builder globally:
 config.action_view.default_form_builder = StimulusPlumbers::Form::Builder
 ```
 
-Run the install generator once to inject the `tokens.css` import into your CSS entry file:
+Run the install generator once to copy `tokens.css` to `app/assets/stylesheets/stimulus_plumbers/tokens.css` and inject its relative import into your CSS entry file — see [docs/guide.md#css-entry-file-detection](docs/guide.md#css-entry-file-detection) for how the entry file is found/overridden:
 
 ```bash
 bin/rails generate stimulus_plumbers:install
 ```
 
-The generator checks these files in order:
-
-- `app/assets/stylesheets/application.tailwind.css`
-- `app/assets/stylesheets/application.css`
-- `app/javascript/entrypoints/application.css`
-
-Override the detected file with `STIMULUS_PLUMBERS_CSS_FILE=/path/to/entry.css`. After the initial install, the import stays current automatically — the engine hooks `stimulus_plumbers:install` as a prerequisite of `assets:precompile`.
+The engine re-runs the installer before `assets:precompile` to restore a missing copy and migrate legacy gem-path imports. Existing app-owned CSS is preserved, so update it intentionally when you want newer token defaults.
 
 ## Components
 
@@ -65,17 +59,21 @@ Override the detected file with `STIMULUS_PLUMBERS_CSS_FILE=/path/to/entry.css`.
 | Calendar | `sp_calendar_month` | [docs/component/calendar.md](docs/component/calendar.md) |
 | Calendar (Turbo) | `sp_calendar_turbo`, `sp_calendar_turbo_month`, `sp_calendar_turbo_year`, `sp_calendar_turbo_decade` | [docs/component/calendar.md](docs/component/calendar.md) |
 | Card | `sp_card` | [docs/component/card.md](docs/component/card.md) |
+| Checklist | `sp_checklist` | [docs/component/checklist.md](docs/component/checklist.md) |
 | 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 — typeahead | `sp_combobox_typeahead` | [docs/component/combobox.md](docs/component/combobox.md#sp_combobox_typeahead) |
 | Combobox — time | `sp_combobox_time` | [docs/component/combobox.md](docs/component/combobox.md#sp_combobox_time) |
 | Divider | `sp_divider` | [docs/component/divider.md](docs/component/divider.md) |
 | Icon | `sp_icon` | [docs/component/icon.md](docs/component/icon.md) |
+| Indicator | `sp_indicator` | [docs/component/indicator.md](docs/component/indicator.md) |
 | Link | `sp_link` | [docs/component/link.md](docs/component/link.md) |
 | List | `sp_list` | [docs/component/list.md](docs/component/list.md) |
 | Modal | — (JS only) | [docs/component/modal.md](docs/component/modal.md) |
+| OrderedList | `sp_ordered_list` | [docs/component/ordered_list.md](docs/component/ordered_list.md) |
 | Popover | `sp_popover` | [docs/component/popover.md](docs/component/popover.md) |
-| Timeline | `sp_timeline` | [docs/component/timeline.md](docs/component/timeline.md) |
+| Progress | `sp_progress_bar`, `sp_progress_ring`, `sp_progress_meter` | [docs/component/progress.md](docs/component/progress.md) |
+| Timeline | `sp_timeline`, `sp_timeline_group` | [docs/component/timeline.md](docs/component/timeline.md) |
 
 ## Form Builder
 

data/app/assets/javascripts/stimulus-plumbers/controllers.manifest.json

@@ -26,14 +26,39 @@
       }
     },
     "outlets": [],
-    "classes": []
+    "classes": [],
+    "actions": [
+      "attach",
+      "constructor",
+      "detach",
+      "drawGrid",
+      "handle",
+      "if",
+      "navigate",
+      "navigated",
+      "step"
+    ],
+    "dispatches": [
+      "selected",
+      "selecting"
+    ]
   },
   "calendar-decade-selector": {
     "identifier": "calendar-decade-selector",
     "targets": [],
     "values": {},
     "outlets": [],
-    "classes": []
+    "classes": [],
+    "actions": [
+      "attach",
+      "constructor",
+      "detach",
+      "handle"
+    ],
+    "dispatches": [
+      "selected",
+      "selecting"
+    ]
   },
   "calendar-month": {
     "identifier": "calendar-month",
@@ -87,6 +112,25 @@
       "dayOfMonth",
       "dayOfOtherMonth",
       "row"
+    ],
+    "actions": [
+      "_scheduleNavigate",
+      "attach",
+      "constructor",
+      "createDayElement",
+      "detach",
+      "drawDaysOfMonth",
+      "drawDaysOfWeek",
+      "handle",
+      "if",
+      "navigate",
+      "navigated",
+      "select",
+      "step"
+    ],
+    "dispatches": [
+      "selected",
+      "selecting"
     ]
   },
   "calendar-month-selector": {
@@ -94,7 +138,17 @@
     "targets": [],
     "values": {},
     "outlets": [],
-    "classes": []
+    "classes": [],
+    "actions": [
+      "attach",
+      "constructor",
+      "detach",
+      "handle"
+    ],
+    "dispatches": [
+      "selected",
+      "selecting"
+    ]
   },
   "calendar-year": {
     "identifier": "calendar-year",
@@ -131,14 +185,56 @@
       }
     },
     "outlets": [],
-    "classes": []
+    "classes": [],
+    "actions": [
+      "attach",
+      "constructor",
+      "detach",
+      "drawGrid",
+      "handle",
+      "if",
+      "navigate",
+      "navigated",
+      "step"
+    ],
+    "dispatches": [
+      "selected",
+      "selecting"
+    ]
   },
   "calendar-year-selector": {
     "identifier": "calendar-year-selector",
     "targets": [],
     "values": {},
     "outlets": [],
-    "classes": []
+    "classes": [],
+    "actions": [
+      "attach",
+      "constructor",
+      "detach",
+      "handle"
+    ],
+    "dispatches": [
+      "selected",
+      "selecting"
+    ]
+  },
+  "checklist": {
+    "identifier": "checklist",
+    "targets": [
+      "master",
+      "item"
+    ],
+    "values": {},
+    "outlets": [],
+    "classes": [],
+    "actions": [
+      "enabledItems",
+      "onChange",
+      "recompute",
+      "toggleAll"
+    ],
+    "dispatches": []
   },
   "clipboard": {
     "identifier": "clipboard",
@@ -152,7 +248,16 @@
       }
     },
     "outlets": [],
-    "classes": []
+    "classes": [],
+    "actions": [
+      "copy",
+      "onPaste"
+    ],
+    "dispatches": [
+      "copied",
+      "copy-failed",
+      "pasted"
+    ]
   },
   "combobox-date": {
     "identifier": "combobox-date",
@@ -194,7 +299,29 @@
       "calendar-year",
       "calendar-decade"
     ],
-    "classes": []
+    "classes": [],
+    "actions": [
+      "calendarMonthOutletConnected",
+      "draw",
+      "drawDay",
+      "drawMonth",
+      "drawView",
+      "drawViewTitle",
+      "drawYear",
+      "if",
+      "next",
+      "onDaySelect",
+      "onMonthSelect",
+      "onYearSelect",
+      "previous",
+      "stepArgs",
+      "syncOutletValues",
+      "viewTitleLabel",
+      "zoomOut"
+    ],
+    "dispatches": [
+      "selected"
+    ]
   },
   "combobox-dropdown": {
     "identifier": "combobox-dropdown",
@@ -218,7 +345,19 @@
       }
     },
     "outlets": [],
-    "classes": []
+    "classes": [],
+    "actions": [
+      "filter",
+      "onNavigate",
+      "onSelect",
+      "select",
+      "setEmpty",
+      "setLoading",
+      "showAll"
+    ],
+    "dispatches": [
+      "selected"
+    ]
   },
   "combobox-time": {
     "identifier": "combobox-time",
@@ -229,7 +368,18 @@
     ],
     "values": {},
     "outlets": [],
-    "classes": []
+    "classes": [],
+    "actions": [
+      "onNavigate",
+      "onSelect",
+      "select",
+      "selectedValue",
+      "step",
+      "toH24"
+    ],
+    "dispatches": [
+      "selected"
+    ]
   },
   "dismisser": {
     "identifier": "dismisser",
@@ -238,7 +388,9 @@
     ],
     "values": {},
     "outlets": [],
-    "classes": []
+    "classes": [],
+    "actions": [],
+    "dispatches": []
   },
   "flipper": {
     "identifier": "flipper",
@@ -261,7 +413,9 @@
       }
     },
     "outlets": [],
-    "classes": []
+    "classes": [],
+    "actions": [],
+    "dispatches": []
   },
   "input-clearable": {
     "identifier": "input-clearable",
@@ -271,7 +425,13 @@
     ],
     "values": {},
     "outlets": [],
-    "classes": []
+    "classes": [],
+    "actions": [
+      "clear",
+      "draw",
+      "handleEscape"
+    ],
+    "dispatches": []
   },
   "input-combobox": {
     "identifier": "input-combobox",
@@ -291,17 +451,64 @@
     "outlets": [
       "combobox-dropdown"
     ],
-    "classes": []
+    "classes": [],
+    "actions": [
+      "onInput",
+      "onSelect"
+    ],
+    "dispatches": [
+      "changed"
+    ]
   },
   "input-formatter": {
     "identifier": "input-formatter",
     "targets": [
       "input",
-      "toggle"
+      "toggle",
+      "cell"
     ],
-    "values": {},
+    "values": {
+      "format": {
+        "type": "String",
+        "default": "plain"
+      },
+      "options": {
+        "type": "Object",
+        "default": {}
+      },
+      "revealed": {
+        "type": "Boolean",
+        "default": false
+      },
+      "groups": {
+        "type": "Array",
+        "default": []
+      }
+    },
     "outlets": [],
-    "classes": []
+    "classes": [],
+    "actions": [
+      "attachCells",
+      "cellsValue",
+      "detachCells",
+      "drawCells",
+      "drawToggle",
+      "format",
+      "isFull",
+      "onBlur",
+      "onChange",
+      "onFocus",
+      "onFormatting",
+      "onInput",
+      "onPaste",
+      "primeFilledState",
+      "readValue",
+      "toggle"
+    ],
+    "dispatches": [
+      "filled",
+      "formatted"
+    ]
   },
   "modal": {
     "identifier": "modal",
@@ -311,7 +518,12 @@
     ],
     "values": {},
     "outlets": [],
-    "classes": []
+    "classes": [],
+    "actions": [
+      "close",
+      "open"
+    ],
+    "dispatches": []
   },
   "panner": {
     "identifier": "panner",
@@ -320,7 +532,9 @@
     ],
     "values": {},
     "outlets": [],
-    "classes": []
+    "classes": [],
+    "actions": [],
+    "dispatches": []
   },
   "popover": {
     "identifier": "popover",
@@ -359,10 +573,114 @@
       }
     },
     "outlets": [],
-    "classes": [
-      "hidden"
+    "classes": [],
+    "actions": [
+      "canLoad",
+      "close",
+      "closeOnSelect",
+      "contentLoaded",
+      "contentLoader",
+      "contentLoading",
+      "dismissed",
+      "getContentNode",
+      "hidden",
+      "open",
+      "shown",
+      "toggle"
+    ],
+    "dispatches": []
+  },
+  "progress": {
+    "identifier": "progress",
+    "targets": [
+      "fill",
+      "meter"
+    ],
+    "values": {
+      "variant": {
+        "type": "String",
+        "default": "bar"
+      },
+      "current": {
+        "type": "Number",
+        "default": 0
+      },
+      "min": {
+        "type": "Number",
+        "default": 0
+      },
+      "max": {
+        "type": "Number",
+        "default": 100
+      },
+      "indeterminate": {
+        "type": "Boolean",
+        "default": false
+      },
+      "indeterminateFraction": {
+        "type": "Number",
+        "default": 0.25
+      },
+      "optimum": {
+        "type": "Number"
+      },
+      "low": {
+        "type": "Number"
+      },
+      "high": {
+        "type": "Number"
+      }
+    },
+    "outlets": [],
+    "classes": [],
+    "actions": [
+      "clamp",
+      "percent",
+      "render",
+      "renderBar",
+      "renderMeter",
+      "renderRing",
+      "setCircumference",
+      "setValue"
+    ],
+    "dispatches": [
+      "changed"
     ]
   },
+  "reorderable": {
+    "identifier": "reorderable",
+    "targets": [
+      "item",
+      "handle",
+      "trigger"
+    ],
+    "values": {
+      "moveKey": {
+        "type": "String",
+        "default": "Alt"
+      },
+      "editing": {
+        "type": "Boolean",
+        "default": false
+      },
+      "orientation": {
+        "type": "String",
+        "default": "vertical"
+      }
+    },
+    "outlets": [],
+    "classes": [],
+    "actions": [
+      "enterEditing",
+      "exitEditing",
+      "moved",
+      "onPointerDown",
+      "onPointerMove",
+      "onPointerUp",
+      "toggleEditing"
+    ],
+    "dispatches": []
+  },
   "timeline": {
     "identifier": "timeline",
     "targets": [
@@ -370,9 +688,30 @@
       "detail",
       "time"
     ],
-    "values": {},
+    "values": {
+      "dateFormat": {
+        "type": "Object",
+        "default": {}
+      }
+    },
     "outlets": [],
-    "classes": []
+    "classes": [],
+    "actions": [
+      "collapse",
+      "collapseItem",
+      "expand",
+      "expandItem",
+      "format",
+      "normalize",
+      "toggle",
+      "validate"
+    ],
+    "dispatches": [
+      "collapse",
+      "collapsed",
+      "expand",
+      "expanded"
+    ]
   },
   "visibility": {
     "identifier": "visibility",
@@ -381,6 +720,11 @@
     ],
     "values": {},
     "outlets": [],
-    "classes": []
+    "classes": [],
+    "actions": [
+      "dismissed",
+      "toggle"
+    ],
+    "dispatches": []
   }
 }