stimeo-ui 0.1.0.pre.beta.1 → 0.1.0.pre.beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (22) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +39 -0
  3. data/README.md +65 -5
  4. data/dist/cable/index.js +563 -0
  5. data/dist/controllers/combobox_controller.js +15 -0
  6. data/dist/controllers/count_up_controller.js +86 -0
  7. data/dist/controllers/intersection_controller.js +173 -0
  8. data/dist/controllers/lazy_frame_controller.js +57 -9
  9. data/dist/controllers/listbox_controller.js +13 -0
  10. data/dist/controllers/optimistic_controller.js +58 -0
  11. data/dist/controllers/pointer_drag_controller.js +406 -0
  12. data/dist/controllers/portal_controller.js +62 -6
  13. data/dist/controllers/reading_progress_controller.js +49 -0
  14. data/dist/controllers/roving_controller.js +1 -0
  15. data/dist/controllers/scrollspy_controller.js +65 -19
  16. data/dist/controllers/smart_sticky_header_controller.js +76 -0
  17. data/dist/controllers/sortable_controller.js +167 -0
  18. data/dist/controllers/sticky_observer_controller.js +60 -15
  19. data/dist/controllers/tabs_controller.js +1 -1
  20. data/dist/index.js +1124 -68
  21. data/lib/stimeo/ui/version.rb +3 -3
  22. metadata +11 -3
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: d5958af6bffb81de09834ec57bed72292dccba82e858e62c87b99a43f769cc94
4
- data.tar.gz: 4a35a8a27e890e26652fa67bf44739e8a9e28993df7bfd7b912ca33b39fef11b
3
+ metadata.gz: 43ec968d086165fbfd9daeda12d003a6cf0cb9e8375a9abfb34924aab3383959
4
+ data.tar.gz: 8c1fde6bff018d4f47ac745df3e18b2eaaa95d3658ea1ce05fd03bda5b35dc46
5
5
  SHA512:
6
- metadata.gz: b288d136c73d80180990c922f83999d9eabc8b03cf2e1c685ee0c9ebcbbb3f46aecb336888200570ff8caf481049a147f3bdeb70b53611be76a14ae4a7ab7e1f
7
- data.tar.gz: 8155446be40a4afbff0d10608797da863cd5264efc03507c018478aa3d0121029083fd8f6d28ed3d704604e9d2f4eb02dfc23641aeaeb57bf04961c5d573c1b3
6
+ metadata.gz: 0ab3a420ebc50b56abce77cd1a4b36be4c3891d4495bd4c2ab8961a42978dc6f79443822ab389dea100b308d236064e76c2e3a0445e0daeb260e7ce4653c71d1
7
+ data.tar.gz: 1ffc55e37df21a692a21da69f4e98b303ca1600bc57286a132584425392be40f654ba6570227c70436934f5b0ca2bf3d0a5dee9c39c2f24f61e70632e2992751
data/CHANGELOG.md CHANGED
@@ -7,6 +7,44 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
  While the version is `0.x`, the public API (the `stimeo--*` data attributes) may
8
8
  change between releases.
9
9
 
10
+ ## [0.1.0-beta.2] - 2026-07-12
11
+
12
+ The Inspector grows two new faces: an MCP server for AI coding agents and a
13
+ VS Code extension that checks markup as you type.
14
+
15
+ ### Added
16
+
17
+ - **MCP server** (`stimeo-ui mcp`): the Inspector engine now runs as a Model
18
+ Context Protocol server, so AI coding agents (Claude Code, Cursor, …) can
19
+ discover the catalog, fetch a controller's exact contract and verified
20
+ example markup, and check generated HTML/ERB before presenting it. Four
21
+ read-only tools (`stimeo_check`, `stimeo_catalog`, `stimeo_controller`,
22
+ `stimeo_example`), preloadable resources (`stimeo://manifest`,
23
+ `stimeo://examples/<id>`), and two prompts (`stimeo_build_ui`,
24
+ `stimeo_fix_markup`) — hand-written like the rest of the Inspector, adding
25
+ zero runtime dependencies.
26
+ - **VS Code extension — Stimeo UI Inspector**: live diagnostics, quick fixes,
27
+ manifest-driven completions, and contract hovers for `stimeo--*` markup in
28
+ HTML/ERB, published on the
29
+ [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=stimeo-labs.stimeo-ui)
30
+ and [Open VSX](https://open-vsx.org/extension/stimeo-labs/stimeo-ui).
31
+ - Ten new components — the catalog now spans **111 controllers**: count-up,
32
+ intersection, optimistic, pointer-drag, reading-progress,
33
+ smart-sticky-header, sortable, and — backed by Action Cable — live-counter,
34
+ presence, and typing-indicator.
35
+ - pointer-drag: opt-in follow mode that translates the dragged element while
36
+ the pointer moves.
37
+ - Inspector: checks now also cover keyboard-focusability prerequisites,
38
+ controller-managed ARIA that must not be hardcoded, and conditional
39
+ cross-controller composition rules (manifest schema v5). Verified example
40
+ markup for every component ships with the package.
41
+
42
+ ### Fixed
43
+
44
+ - listbox, combobox, and multi-select: the active option now scrolls into
45
+ view while navigating with the keyboard (`aria-activedescendant` lists
46
+ keep the highlighted option visible).
47
+
10
48
  ## [0.1.0-beta.1] - 2026-06-30
11
49
 
12
50
  First beta. The 101 core components meet the accessibility quality bar, so the
@@ -32,5 +70,6 @@ Initial public alpha: 101 behavior-only, accessible Stimulus controllers driven
32
70
  by `data-*` attributes, shipping no CSS. Published to npm (with provenance) and
33
71
  RubyGems.
34
72
 
73
+ [0.1.0-beta.2]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.1.0-beta.2
35
74
  [0.1.0-beta.1]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.1.0-beta.1
36
75
  [0.1.0-alpha.1]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.1.0-alpha.1
data/README.md CHANGED
@@ -7,7 +7,7 @@
7
7
 
8
8
  <p align="center"><a href="https://stimeo-labs.com"><strong>Live demo (beta) →</strong></a></p>
9
9
 
10
- [![CI](https://github.com/taiyaky/stimeo-ui/actions/workflows/ci.yml/badge.svg)](https://github.com/taiyaky/stimeo-ui/actions/workflows/ci.yml) [![npm](https://img.shields.io/npm/v/stimeo-ui)](https://www.npmjs.com/package/stimeo-ui) [![gem](https://img.shields.io/gem/v/stimeo-ui)](https://rubygems.org/gems/stimeo-ui) [![License: MIT](https://img.shields.io/github/license/taiyaky/stimeo-ui)](LICENSE)
10
+ [![CI](https://github.com/taiyaky/stimeo-ui/actions/workflows/ci.yml/badge.svg)](https://github.com/taiyaky/stimeo-ui/actions/workflows/ci.yml) [![npm](https://img.shields.io/npm/v/stimeo-ui/beta)](https://www.npmjs.com/package/stimeo-ui) [![gem](https://img.shields.io/gem/v/stimeo-ui)](https://rubygems.org/gems/stimeo-ui) [![License: MIT](https://img.shields.io/github/license/taiyaky/stimeo-ui)](LICENSE)
11
11
 
12
12
  **Headless Stimulus UI framework for Ruby on Rails.** Stimeo UI ships *behavior*
13
13
  — ARIA state, keyboard interaction, focus management, Turbo resilience — as
@@ -31,7 +31,7 @@ owns the look entirely.
31
31
  ### Rails with importmap (recommended)
32
32
 
33
33
  ```bash
34
- bundle add stimeo-ui --version "0.1.0.pre.beta.1"
34
+ bundle add stimeo-ui --version "0.1.0.pre.beta.2"
35
35
  bin/rails generate stimeo:install
36
36
  ```
37
37
 
@@ -50,7 +50,7 @@ Stimulus application. Then drive components from HTML alone:
50
50
  ### npm (jsbundling or any bundler)
51
51
 
52
52
  ```bash
53
- npm install stimeo-ui @hotwired/stimulus
53
+ npm install stimeo-ui@beta @hotwired/stimulus
54
54
  ```
55
55
 
56
56
  ```js
@@ -114,12 +114,72 @@ The `eslint-plugin-jsx-a11y` equivalents are
114
114
  `no-noninteractive-tabindex`. These components' real accessibility is exercised
115
115
  with axe-core and real screen readers in this project's own test suite.
116
116
 
117
+ ## Inspector CLI & MCP server
118
+
119
+ Stimeo UI bundles a zero-dependency static checker for its own markup contract
120
+ — spelling of controllers/targets/values, required structure, and the ARIA
121
+ attributes you (the author) must supply:
122
+
123
+ ```bash
124
+ npx stimeo-ui check app/views # check your templates (exit 1 on errors)
125
+ npx stimeo-ui catalog # list every controller's public API
126
+ ```
127
+
128
+ Both commands accept `--json` for machine-readable output, so `check` drops
129
+ straight into CI.
130
+
131
+ The same engine runs as a **Model Context Protocol** server, so AI coding
132
+ agents (Claude Code, Cursor, …) can discover the catalog, fetch verified
133
+ reference markup, and validate generated HTML/ERB before presenting it:
134
+
135
+ ```bash
136
+ claude mcp add stimeo -- npx -y stimeo-ui mcp
137
+ ```
138
+
139
+ or in `.mcp.json` (Claude Code) / `.cursor/mcp.json` (Cursor):
140
+
141
+ ```json
142
+ {
143
+ "mcpServers": {
144
+ "stimeo": {
145
+ "command": "npx",
146
+ "args": ["-y", "stimeo-ui", "mcp"]
147
+ }
148
+ }
149
+ }
150
+ ```
151
+
152
+ It exposes four read-only tools — `stimeo_check` (validate a source string),
153
+ `stimeo_catalog`, `stimeo_controller` (one controller's full contract,
154
+ accessibility requirements included), and `stimeo_example` (verified example
155
+ markup: the official catalog demo under [`examples/`](examples/), bundled at
156
+ build time and guaranteed to pass the checker) — plus MCP resources
157
+ (`stimeo://manifest`, `stimeo://examples/<id>`) for preloading context without
158
+ a tool round-trip. The server reads only its bundled manifest and example
159
+ index; there are no write-capable tools.
160
+
161
+ The same checks also run **live in your editor**: the **Stimeo UI Inspector**
162
+ extension on the
163
+ [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=stimeo-labs.stimeo-ui)
164
+ and [Open VSX](https://open-vsx.org/extension/stimeo-labs/stimeo-ui) (for Cursor /
165
+ VSCodium / Windsurf) gives as-you-type diagnostics, quick fixes, completions,
166
+ and contract hovers. No setup: the engine and a manifest snapshot are bundled,
167
+ and when your workspace installs `stimeo-ui`, the nearest installed version
168
+ wins — so diagnostics always match what you run.
169
+
117
170
  ## Contributing
118
171
 
119
172
  Bug reports and feature requests are very welcome — please open a GitHub issue.
120
173
  For code changes, open an issue first to discuss direction; see
121
174
  [`CONTRIBUTING.md`](CONTRIBUTING.md).
122
175
 
123
- ## License
176
+ ## License & Pro
177
+
178
+ Free and open source under the [MIT License](LICENSE) © Stimeo Labs. Every
179
+ component in this repository is Core, and the MIT grant is irrevocable.
124
180
 
125
- Released under the [MIT License](LICENSE) © Stimeo Labs.
181
+ **Stimeo UI Pro** — advanced behavior components that are the most work to
182
+ build yourself — is planned around 1.0 as a separately licensed commercial
183
+ track, built alongside (never carved out of) Core. For release news and
184
+ early access, join the waitlist at
185
+ [stimeo-labs.com/waitlist](https://stimeo-labs.com/waitlist).