wabi 0.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: abcbfe9f2785a854e687d5f992d6ceb32c4e4fb67ba0d081416ff4bd9b383988
+  data.tar.gz: 6706563e1af726d59eafc0dbee7020a1fe565ed51cde9846020dcd74239b97e3
+SHA512:
+  metadata.gz: a367a2820c7e1276ce580cae7f577fca70d0f2f2c2f211a222f97dffc8920b1d4bbdfd3745c3ac76a921e654b74cf958b465d7fcd3501bbedfbe8aa474b8a387
+  data.tar.gz: c1de47b6186629b44e908fb3a364a564605a5b34c3551307057909fec013ae4e71b2c0a12f42e69d714f88a94a1f1ef38be755e4c1206a577edf668e469317e4

data/CHANGELOG.md

@@ -0,0 +1,157 @@
+# Changelog
+
+All notable changes to Wabi land here. Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.3.0] — 2026-05-26
+
+Sprint 7 (docs site polish). The docs site stops being a one-page kitchen
+sink and starts behaving like real documentation: marketing landing,
+components index, detailed pages for the 4 exemplar components, and
+prose docs for onboarding / theming / philosophy. Sprint 8 (v0.4) is
+queued to fill in the remaining 16 component detail pages + Pagefind
+search.
+
+### Added
+
+- **`Components::Site::CodeBlock`** — Phlex `<pre><code>` wrapper with server-side Rouge syntax highlighting and a clipboard-copy button. Backed by a tiny `site--copy` Stimulus controller that hands the literal source (not the highlighted HTML) to `navigator.clipboard`.
+- **`Components::Site::ComponentPreview`** — Tabbed Preview/Code view around an example. Block-provided live render in the Preview tab; literal source string rendered via CodeBlock in the Code tab. Backed by `site--preview-tabs` Stimulus controller that toggles panels and flips `data-active` on the tab buttons.
+- **`ComponentsController` + `/docs/components` index** — Routes a components landing that lists all 20 v0.2 components with their manifest-derived descriptions. Cards for the 4 exemplars with detailed docs (Button / DropdownMenu / Dialog / Tabs) link out; cards for the remaining 16 show description + a "Source only" affordance until v0.4 fills them in. Nav header gains a "Components" link.
+- **4 detailed component doc pages**: `/docs/components/button` (single-element variants), `/docs/components/dropdown_menu` (compound with submenu), `/docs/components/dialog` (overlay), `/docs/components/tabs` (in-flow navigation). Each ships: breadcrumb back-link, title, description, installation snippet, live `ComponentPreview` example, Source `CodeBlock(s)` reading the actual .rb files at request time, Accessibility bullets.
+- **Marketing landing at `/`** — Hero ("Beautifully imperfect components for Rails") with Get-started + Browse-components CTAs, theming-aware live demo (two Cards that repaint with the theme picker), 30-second install snippet, "Why Wabi" 3-up feature grid, footer.
+- **`/preview`** — The Sprint 1-6 kitchen sink home is preserved verbatim here for dev-time component browsing. 22 component demo sections.
+- **`/docs/getting-started`** — 5-step onboarding (gem add → install generator → wire Tailwind 4 → mount theme controller → add components). Cross-links to /docs/components, /docs/theming, /docs/themes, /docs/philosophy.
+- **`/docs/theming`** — How to switch palettes, available palette list, dark-mode toggle pattern, customizing tokens (HSL var space), Tailwind 4 notes (no preset.js, `@theme inline`, `@source` for autodetection).
+- **`/docs/philosophy`** — 5-section rationale: "you own the code", Phlex-native composition, accessible-by-default, brand-neutral, Hotwire-friendly.
+
+### Changed
+
+- **Dependencies**: `docs/Gemfile` gains `rouge ~> 4.5` for server-side syntax highlighting in `CodeBlock`. No new gems beyond that.
+- **`docs/app/views/pages/home.rb` REPLACED** with the marketing landing; the old kitchen-sink home was moved to `docs/app/views/pages/preview.rb` (class renamed `Home` → `Preview`) and routed at `/preview`.
+- **Nav layout**: header gains a "Components" link alongside the existing "Themes" link. ThemePicker dropdown stays.
+
+### Fixed
+
+- **Constant resolution shadow under `Views::Pages::Components`.** Introducing the new `Views::Pages::Components::*` namespace (for the components index and 4 detailed pages) shadowed the top-level `Components::*` from anything else under `Views::Pages`. Ruby's constant lookup found `Views::Pages::Components` first and failed to find `Site` or `UI` inside it. Three views needed leading-`::` prefix on their `render` calls: `Home`, `Preview`, `Themes`. The `Themes` view (Sprint 6) had been silently broken since the components namespace was introduced — discovered and fixed in the same task.
+
+### Spec totals
+
+- Registry: 125/125 unchanged (Sprint 7 doesn't touch registry).
+- Gem: 66/66 unchanged.
+- Doc-site smoke (Rack::Test): 11/11 routes return 200 — `/`, `/preview`, `/docs/themes`, `/docs/components`, `/docs/components/{button,dropdown_menu,dialog,tabs}`, `/docs/getting-started`, `/docs/theming`, `/docs/philosophy`.
+
+### Known v0.3 deferrals → v0.4
+
+- **Detailed doc pages for the remaining 16 components** (input, textarea, label, card, badge, separator, alert, avatar, checkbox, switch, select, drawer, tooltip, popover, toast, accordion). The index lists them with descriptions + "Source only" affordance; v0.4 fills in the per-component pages.
+- **Pagefind static search** — Needs Node/bun + pre-rendered HTML. Not yet worth the infrastructure for ~25 docs pages.
+- **Sidebar nav** with active-section state — Header-only nav is fine for 5 top-level pages; sidebar makes sense once components have their own subsection.
+- Same v0.2 deferrals still standing: `@zag-js/toast` group machine, real portal pattern, `wabi:update` generator, multi-level DropdownMenu nesting, `tailwind-merge`-equivalent class dedup edge cases, Phlex 2.4.1 Ruby 4 warnings.
+
+---
+
+## [0.2.0] — 2026-05-26
+
+Sprint 6 (themes). 8 palettes ship, live theme switcher in the docs nav,
+`/docs/themes` gallery page, and a `wabi:theme <slug>` generator to swap
+themes in user apps. Sprint 7 (docs polish — per-component doc pages,
+Pagefind search, marketing landing) is the next planned milestone.
+
+### Added
+
+- **7 new theme palettes**: slate, stone, zinc, rose, blue, green, violet. Light + dark per theme, scoped via `[data-theme="<slug>"]` and `[data-theme="<slug>"][data-mode="dark"]` selectors. Default theme stays as the bare `[data-theme="default"]` (plus `:root` for the no-theme-yet case).
+- **`bin/rails g wabi:theme <slug>` generator**: fetches `_shared.css` + `<slug>.css` from the lockfile's registry (HTTP or `file://`), concatenates, and overwrites `app/assets/tailwind/wabi/tokens.css`. Hint printed to re-run `tailwindcss:build`.
+- **`Components::Site::ThemePicker`**: DropdownMenu in the docs nav with the 8 themes as a RadioGroup + a "Toggle dark mode" item. Wired to the existing `wabi--theme` Stimulus controller (`setTheme`/`toggleMode`), so persists in localStorage across reloads.
+- **`/docs/themes` gallery**: side-by-side cards painting with each palette's own colors (each card carries its own `data-theme`). Each has an "Apply this theme" button that propagates the choice globally.
+- **Registry endpoint `/r/themes/:slug.css`**: serves the per-theme CSS file. Slug regex allows the `_shared` underscore-prefixed name plus regular slugs. Realpath check guards against directory traversal.
+- **`registry/themes/` directory + builder integration**: new canonical home for theme files. `Wabi::Registry::Builder#build_themes` runs as part of every `bin/build` and regenerates two derived artifacts:
+  - `gem/templates/tokens.css` — `_shared.css` + `default.css` only (what `wabi:install` copies into user apps).
+  - `docs/app/assets/tailwind/wabi/tokens.css` — `_shared.css` + all 8 themes concatenated (powers live switching in the docs site).
+
+### Fixed
+
+- **DropdownMenuItem / DropdownMenuRadioItem dropped user-supplied `data:` kwargs.** Both components extracted only `:class` from `@attrs`, silently discarding everything else. Surfaced when wiring ThemePicker's `data: { action: "click->wabi--theme#setTheme", ... }` and the action attribute never reached the DOM. Both components now merge user data with component data; component keys win on collision so caller-supplied attrs can't override target/value bindings. Two new regression specs lock this in.
+- **CSS specificity bug: `:root` redefined per theme clobbered light-mode switching.** First pass had every theme file start with `:root, [data-theme="<slug>"]`. When concatenated for the docs site, `:root` appeared 8 times. Since `:root` and `[data-theme="X"]` have equal specificity (0,1,0), the later `:root` block (from violet, last in concat order) overrode every earlier `[data-theme="X"]` rule — so every light-mode theme repainted as violet. Dark mode escaped because `[data-theme="X"][data-mode="dark"]` has specificity (0,2,0). Fix: only `default.css` keeps the `:root, ` prefix; the other 7 themes use `[data-theme="<slug>"]` alone. Regression spec asserts exactly one `:root` block in the docs output.
+
+### Changed
+
+- **Default theme location moved** from `gem/templates/tokens.css` (hand-maintained) to `registry/themes/default.css` (canonical source) + `_shared.css` (boilerplate). The gem template is now a build artifact, regenerated by `bin/build`. Users see no functional difference; gem upgrades carry the same default palette as before.
+- **Site::Layout grew a `<header>`** with a "Wabi" home link, a "Themes" nav link to `/docs/themes`, and the theme picker. The `raw safe(yield_content(&block))` + `<Toaster>` body siblings are preserved exactly.
+
+### Spec totals
+
+- Registry: 125 examples, 0 failures (was 119 at v0.1; +6 across `#build_themes` describe block + DropdownMenu user-data merge specs).
+- Gem: 66 examples, 0 failures (was 64; +2 from `theme_generator_spec`).
+
+### Known v0.2 deferrals → v0.3
+
+- Pagefind static search.
+- Per-component documentation pages (20 routes).
+- Marketing-oriented landing page; kitchen-sink home would move to `/preview`.
+- Getting-started / philosophy / theming concept prose pages.
+- `@zag-js/toast` group machine (max stack, gap/offset, pause-on-group-hover).
+- Real portal pattern for transformed ancestors.
+- `wabi:update` diff-aware generator (`wabi:install --force` is the current minimum).
+- Multi-level DropdownMenu nesting (v0.2 still supports single-level submenus).
+- Phlex 2.4.1 Ruby 4 warnings (wait for upstream fix).
+
+---
+
+## [0.1.0] — 2026-05-26
+
+First milestone release. 20 components, accessible, themable, no Zag.js
+0.x quirks left, no public gem / GitHub repo yet.
+
+### Components (20)
+
+- **Static** (9): Button, Input, Textarea, Label, Card (compound), Badge, Separator, Alert (compound), Avatar (compound).
+- **Forms** (3): Checkbox, Switch, Select (compound).
+- **Overlays** (4): Dialog (compound), Drawer (4-side variant), Tooltip, Popover.
+- **Menus + feedback** (2): DropdownMenu (with nested Submenu + checkbox/radio items), Toast (+ Toaster singleton container).
+- **Navigation** (2): Tabs, Accordion.
+
+### Gem
+
+- `wabi:install` + `wabi:add` + `wabi:list` + `wabi:registry` Rails generators.
+- `Wabi::Base` Phlex base class with CVA-style `variants` DSL and variant-aware `merge_class` Tailwind dedup (`focus-visible:`, `data-[state=…]:`, axis-aware, width-vs-color for `border`/`ring`/`text`/`outline`/`divide`).
+- `Wabi::RegistryClient` with disk cache, dev-context cache bypass (file://, localhost).
+- `Wabi::Lockfile` tracking installed components.
+- `Wabi::TurboStreamExtensions` adds `turbo_stream.wabi_toast(...)` when Turbo is loaded.
+- Tailwind 4 native — `@theme inline` + `@custom-variant dark`, no preset.js.
+
+### Registry
+
+- Build pipeline produces `dist/r/<name>.json` per component + `index.json`.
+- JSON Schema validation (`schema/component.v1.json`).
+- 20 components installable via `bin/rails g wabi:add <name>`.
+
+### Accessibility
+
+- All overlays toggle the `inert` attribute via Zag's `onOpenChange` callback (synchronous inside the state transition, lands before `setInitialFocus`). Closed overlays are out of the tab order and the accessibility tree.
+- `data-state` driven CSS transitions (opacity / translate / pointer-events) — no `display:none` cuts transitions short.
+- WCAG-AA targeted per component manifest.
+
+### Theming
+
+- Default theme ships in `app/assets/tailwind/wabi/tokens.css` via `wabi:install`.
+- `data-mode="dark"` toggles dark palette; `data-theme="…"` ready for multi-palette in v0.2.
+
+### Tooling
+
+- `bin/dev` monorepo entrypoint clears stale `docs/tmp/pids/server.pid` on launch.
+- CI verifies all 20 dist artifacts on push (`.github/workflows/registry-build.yml`).
+- Registry spec suite: 119 examples, 0 failures.
+- Gem spec suite: 64 examples, 0 failures.
+
+### Documentation
+
+- `docs/SMOKE-TEST.md` records per-sprint outcomes and Zag.js 1.x trap memos (entries 1–10 in `feedback_zag_js_pattern`).
+- `docs/V01-CARRYOVER.md` tracks v0.1 carryover (now closed) plus v0.2 deferrals.
+
+### Known v0.2 deferrals
+
+- `@zag-js/toast` group machine (`max` / `gap` / pause-on-group-hover). Current vanilla controller per toast covers the 99% case.
+- Real portal pattern (Stimulus loses target tracking when subtree moves to `document.body`). Workaround: `position: fixed` + high z-index.
+- Multi-palette theme picker UI + documented theme-extension flow.
+- `wabi:update` diff-aware generator (current `wabi:install --force` is the minimum acceptable for v0.1).
+- Multi-level DropdownMenu nesting (sub-inside-a-sub). v0.1 supports single-level submenus.
+- `tailwind-merge`-equivalent class dedup for edge cases (`bg-cover` collapsing under `bg-{color}` etc.).
+- Phlex 2.4.1 emits Ruby 4.0.5 warnings at load time; wait for upstream fix.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Oscar Ortega and Wabi contributors
+
+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,179 @@
+# Wabi
+
+> Beautifully imperfect components for Rails.
+
+Wabi is an open-source UI component library for **Ruby on Rails 8**, built on **Phlex + Tailwind 4 + Stimulus + Hotwire**. Inspired by shadcn/ui, components are *copied* into your app — you own the code, customize freely, no upstream API to drift away from.
+
+🎉 **Status:** v0.3.0 alpha. 20 components, 8 theme palettes, WCAG-AA targeted. Not yet on RubyGems.
+
+---
+
+## Quick start
+
+```bash
+# 1. Add the gem (path-based for now; RubyGems push pending)
+bundle add wabi --git https://github.com/wabikit/wabi --glob 'gem/*'
+
+# 2. Run the installer (copies tokens.css + theme controller + lockfile)
+bin/rails g wabi:install
+
+# 3. Add components from the registry
+bin/rails g wabi:add button card dialog
+
+# 4. Render
+# In any Phlex view:
+#   render Components::UI::Button.new(appearance: :primary) { "Click me" }
+```
+
+Then add `@import "./wabi/tokens.css";` AFTER `@import "tailwindcss";` in your `app/assets/tailwind/application.css`, and mount `data-controller="wabi--theme"` on `<html>` in your layout.
+
+---
+
+## What's in the box
+
+### 20 components
+
+| Static (9) | Forms (3) | Overlays (4) | Menus + Feedback (2) | Navigation (2) |
+|---|---|---|---|---|
+| Button | Checkbox | Dialog | DropdownMenu | Tabs |
+| Input | Switch | Drawer (4 sides) | Toast + Toaster | Accordion |
+| Textarea | Select | Tooltip | | |
+| Label | | Popover | | |
+| Card (compound) | | | | |
+| Badge | | | | |
+| Separator | | | | |
+| Alert (compound) | | | | |
+| Avatar (compound) | | | | |
+
+All interactive components wire through **Zag.js 1.x** state machines for WAI-ARIA roles, keyboard semantics, and focus management. Toast uses a custom vanilla controller (cross-toast coordination is a v0.4 task).
+
+### 8 theme palettes
+
+`default`, `slate`, `stone`, `zinc`, `rose`, `blue`, `green`, `violet`. Light + dark variants per theme. Switch with:
+
+```bash
+bin/rails g wabi:theme rose
+```
+
+Or live-switch via the `wabi--theme` Stimulus controller (sets `data-theme` on `<html>`, persists in `localStorage`).
+
+---
+
+## Why Wabi
+
+| Principle | What it means |
+|---|---|
+| **You own the code** | `bin/rails g wabi:add button` COPIES the Phlex source into your app. Edit, refactor, fork — there's no upstream API to drift from, because the upstream is you. |
+| **Phlex-native** | Components are Ruby classes. Composition is method dispatch. Variants are class-method DSLs. Real inheritance, IDE tab-into-source, like the rest of your Rails app. |
+| **Accessible by default** | Zag.js carries WAI-ARIA roles, keyboard nav, focus management, scroll lock for modals. Overlays toggle `inert` when closed so they stay out of tab order + the a11y tree. |
+| **Brand-neutral** | 8 carefully-chosen palettes. None is "the Wabi look". Pick the closest one or edit HSL values directly. |
+| **Hotwire-friendly** | Stimulus controllers wrap each Zag machine. `turbo_stream.wabi_toast(...)` lets the server spawn notifications without round-tripping the page. |
+
+---
+
+## Example: a confirmation dialog
+
+```ruby
+# app/views/users/destroy_confirmation.rb
+class Views::Users::DestroyConfirmation < Views::Base
+  def view_template
+    render Components::UI::Dialog.new do
+      render Components::UI::DialogTrigger.new(
+        class: "inline-flex h-10 px-4 rounded-md bg-destructive text-destructive-foreground"
+      ) { "Delete account" }
+
+      render Components::UI::DialogContent.new do
+        render Components::UI::DialogHeader.new do
+          render Components::UI::DialogTitle.new       { "Delete account" }
+          render Components::UI::DialogDescription.new { "This action cannot be undone." }
+        end
+        render Components::UI::DialogFooter.new do
+          render Components::UI::DialogCancel.new { "Cancel" }
+          render Components::UI::DialogAction.new(appearance: :destructive,
+                                                    data: { action: "click->wabi--dialog#close" }) { "Delete" }
+        end
+      end
+    end
+  end
+end
+```
+
+That's a fully-accessible modal with focus trap, scroll lock, backdrop click, Escape dismiss, and `inert` on close — out of the box. The Phlex source is in `app/components/ui/dialog*.rb`; modify whatever you want.
+
+---
+
+## CLI reference
+
+| Generator | What it does |
+|---|---|
+| `wabi:install [--force]` | Copies `tokens.css`, the `wabi--theme` Stimulus controller, and initializes `config/wabi.lock.json`. `--force` re-copies tokens/controller on gem upgrades (lockfile is preserved). |
+| `wabi:add <name…>` | Copies one or more component source files from the registry into `app/components/ui/` and their controllers into `app/javascript/controllers/wabi/`. Updates the lockfile. |
+| `wabi:list` | Lists all available components in the configured registry. |
+| `wabi:registry <url>` | Switches the active registry origin (default: `https://wabikit.dev/r`). |
+| `wabi:theme <slug>` | Swaps `tokens.css` for the requested palette. Run `bin/rails tailwindcss:build` after. |
+
+---
+
+## Compatibility
+
+- **Ruby**: 3.4 or later
+- **Rails**: 8.0 or later
+- **Tailwind**: 4.x (native `@theme inline`, no `tailwind.config.js`/`preset.js`)
+- **Phlex**: 2.4 or later
+- **Stimulus**: 3.x
+- **Browsers**: Chrome 117+, Safari 17.4+, Firefox 119+ (some components use modern CSS like `grid-template-rows` height animation for Accordion)
+
+---
+
+## Documentation
+
+The full docs site is at the GitHub repo's `docs/` Rails app (also planned to host at https://wabikit.dev when DNS is wired). Locally:
+
+```bash
+git clone https://github.com/wabikit/wabi
+cd wabi
+bin/dev      # starts registry watcher + tailwind watcher + docs server on :3000
+```
+
+Then visit:
+- `/` — marketing landing
+- `/docs/components` — index of all 20 components
+- `/docs/components/{button,dropdown_menu,dialog,tabs}` — detailed pages with live preview + source
+- `/docs/themes` — all 8 palettes side-by-side
+- `/docs/getting-started`, `/docs/theming`, `/docs/philosophy` — prose docs
+- `/preview` — the Sprint 1-6 kitchen sink (every component on one page)
+
+---
+
+## Monorepo layout
+
+- `gem/` — the `wabi` Ruby gem: runtime (`Wabi::Base`, `Wabi::Variants`, `Wabi::ClassMerge`, `Wabi::RegistryClient`, `Wabi::Lockfile`) + Rails generators.
+- `registry/` — component source files (`components/<name>/{manifest.yml, *.rb, *.js}`) + theme CSS files + the build pipeline emitting `dist/r/<name>.json`.
+- `docs/` — the `wabikit.dev` Rails app; also serves the registry at `/r/*.json` and `/r/themes/*.css`.
+
+---
+
+## Roadmap
+
+| Version | Target | Status |
+|---|---|---|
+| v0.1 | 20 components | ✅ shipped 2026-05-26 |
+| v0.2 | 8 themes + theme picker | ✅ shipped 2026-05-26 |
+| v0.3 | Real docs site (marketing + components index + 4 detailed pages + prose) | ✅ shipped 2026-05-26 |
+| v0.4 | Detailed pages for remaining 16 components; Pagefind search; sidebar nav | planned |
+| v0.5 | `@zag-js/toast` group machine; real portal pattern; `wabi:update` generator | planned |
+| v1.0 | API stability; external a11y audit | 2027-04 target |
+
+See [ROADMAP.md](./ROADMAP.md) for the long-term view and [CHANGELOG.md](./CHANGELOG.md) for the per-release detail.
+
+---
+
+## Contributing
+
+Wabi is in alpha and the API is still moving. Filing issues with concrete repros, suggestions for components, or theme palette ideas is the most useful kind of contribution right now. See [CONTRIBUTING.md](./CONTRIBUTING.md) (TODO — will land before v0.4) for the per-component anatomy and the Zag.js wiring conventions used throughout.
+
+---
+
+## License
+
+MIT — see [LICENSE](./LICENSE). Theme HSL values derive from [shadcn/ui](https://ui.shadcn.com)'s palettes, also MIT-licensed.

data/lib/wabi/base.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require "phlex"
+require_relative "variants"
+require_relative "class_merge"
+
+module Wabi
+  class Base < Phlex::HTML
+    extend Wabi::Variants
+
+    private
+
+    def merge_class(*classes)
+      Wabi::ClassMerge.call(*classes)
+    end
+  end
+end

data/lib/wabi/class_merge.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+require "set"
+
+module Wabi
+  # Minimal Tailwind class deduplication. Later tokens win for the same group key.
+  #
+  # The group key is variant-aware: any variants stacked in front of a utility
+  # (e.g. "focus-visible:", "data-[state=checked]:", "md:dark:") become part of
+  # the key, so variant-scoped utilities never collide with their plain
+  # counterparts. Inside a given variant scope, the key is the utility's first
+  # hyphen-separated segment ("h-4" → "h", "bg-red-500" → "bg").
+  #
+  # NOTE: Still intentionally minimal for v0.1 — utilities that share a prefix
+  # but represent different CSS properties (e.g. `ring-2` width vs `ring-ring`
+  # color, or `border` width vs `border-primary` color) collide and the later
+  # one wins. Full Tailwind conflict resolution (à la tailwind-merge) is
+  # post-v0.1.
+  module ClassMerge
+    module_function
+
+    def call(*inputs)
+      tokens = inputs.compact.flat_map { |s| s.to_s.split(/\s+/) }.reject(&:empty?)
+      seen = {}
+      tokens.each do |token|
+        seen[group_key(token)] = token
+      end
+      seen.values.join(" ")
+    end
+
+    def group_key(token)
+      idx = last_colon_outside_brackets(token)
+      if idx
+        prefix  = token[0..idx]
+        utility = token[(idx + 1)..]
+      else
+        prefix  = ""
+        utility = token
+      end
+      "#{prefix}#{utility_group(utility)}"
+    end
+
+    # Single-word "atom" utilities that name a CSS property whose compound
+    # siblings (e.g. `flex` vs `flex-col`, `border` vs `border-input`) target
+    # an entirely different property and must NOT share a dedup bucket. Without
+    # this distinction, `flex flex-col` collapses to just `flex-col` -- the
+    # display:flex rule is lost and the children don't lay out as a flex row.
+    ATOM_UTILITIES = %w[
+      flex grid block inline hidden visible
+      border ring rounded outline
+      transition truncate
+      absolute relative fixed static sticky
+    ].to_set.freeze
+
+    # Directional / axial suffix segments that distinguish utilities in the
+    # same family (e.g. `-translate-x-1/2` vs `-translate-y-1/2` are different
+    # axes, `border-l` vs `border-r` are different sides). When the first
+    # segment after the family root matches one of these, keep the family root
+    # PLUS the direction segment as the group key.
+    AXIS_FAMILIES = %w[translate -translate scale skew rotate space border].to_set.freeze
+    AXIS_SUFFIXES = %w[x y z t b l r s e].to_set.freeze
+
+    # Families whose first non-family segment can be EITHER a width/size value
+    # OR a color name. Tailwind treats these as different CSS properties so
+    # they must dedup independently. Without this, `border-2 border-input`
+    # collapses to just `border-input` (loses the width), or `ring-2 ring-ring
+    # ring-offset-2` collapses to one of them (the focus ring vanishes).
+    WIDTH_COLOR_FAMILIES = %w[border ring text outline divide].to_set.freeze
+
+    # Tail tokens that unambiguously identify a size/length utility. Anything
+    # that doesn't match these AND doesn't look numeric is assumed to be a
+    # color (or other named theme token).
+    SIZE_TOKENS = %w[
+      xs sm base md lg xl 2xl 3xl 4xl 5xl 6xl 7xl 8xl 9xl
+      auto full screen min max fit none px
+    ].to_set.freeze
+
+    def utility_group(utility)
+      return "atom:#{utility}" if ATOM_UTILITIES.include?(utility)
+
+      segments = utility.split("-").reject(&:empty?)
+      head = utility.start_with?("-") ? "-#{segments.first}" : segments.first
+      tail = utility.start_with?("-") ? segments[1] : segments[1]
+
+      # `ring-offset-*` is its own family: `ring-offset-2` (width) and
+      # `ring-offset-input` (color) must NOT collide with bare `ring-*`.
+      if head == "ring" && tail == "offset"
+        sub_tail = utility.start_with?("-") ? segments[2] : segments[2]
+        return "ring-offset:size"  if sub_tail && size_or_numeric?(sub_tail)
+        return "ring-offset:color" if sub_tail
+        return "ring-offset"
+      end
+
+      return "#{head}-#{tail}" if AXIS_FAMILIES.include?(head) && AXIS_SUFFIXES.include?(tail)
+
+      if WIDTH_COLOR_FAMILIES.include?(head) && tail
+        return "#{head}:size"  if size_or_numeric?(tail)
+        return "#{head}:color"
+      end
+
+      head
+    end
+
+    def size_or_numeric?(tail)
+      return true if SIZE_TOKENS.include?(tail)
+      return true if tail.match?(/\A-?\d+(\/\d+)?\z/)
+      false
+    end
+
+    # The last `:` that lives outside any `[...]` block. Arbitrary-value variants
+    # like `data-[state=checked]:` may contain `:` inside the brackets, which
+    # must not be treated as the variant→utility separator.
+    def last_colon_outside_brackets(token)
+      depth = 0
+      idx   = nil
+      token.each_char.with_index do |c, i|
+        case c
+        when "[" then depth += 1
+        when "]" then depth -= 1
+        when ":" then idx = i if depth.zero?
+        end
+      end
+      idx
+    end
+  end
+end

data/lib/wabi/generators/add_generator.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "digest"
+require "wabi/registry_client"
+require "wabi/lockfile"
+
+module Wabi
+  module Generators
+    class AddGenerator < Rails::Generators::Base
+      argument :components, type: :array, banner: "component_name [component_name ...]"
+
+      desc "Add one or more Wabi components to this app."
+
+      def add_components
+        @js_deps_to_pin = {}
+        lockfile # eager-init via accessor
+        components.each { |name| install_component(name) }
+        lockfile.save
+        print_js_pin_instructions
+      end
+
+      private
+
+      def lockfile
+        @lockfile ||= Wabi::Lockfile.load(File.join(destination_root, "config/wabi.lock.json"))
+      end
+
+      def client
+        @client ||= Wabi::RegistryClient.new(base_url: lockfile.registry)
+      end
+
+      def install_component(name)
+        return if lockfile.components.key?(name)
+        say "  fetching  #{name}", :cyan
+        data = client.fetch(name)
+
+        Array(data["registry_dependencies"]).each { |dep| install_component(dep) }
+
+        data["files"].each do |file|
+          target = File.join(destination_root, file["path"])
+          FileUtils.mkdir_p(File.dirname(target))
+          File.write(target, file["content"])
+          say "  create    #{file["path"]}", :green
+        end
+
+        (data["js_dependencies"] || {}).each { |pkg, ver| @js_deps_to_pin[pkg] = ver }
+
+        hash = Digest::SHA256.hexdigest(JSON.generate(data["files"]))
+        lockfile.record(name, version: data["version"], hash: hash)
+      end
+
+      def print_js_pin_instructions
+        return if @js_deps_to_pin.empty?
+        say "\n  This component requires JS packages. Add these pins to config/importmap.rb:", :yellow
+        @js_deps_to_pin.each do |pkg, version|
+          v = version.to_s.sub(/\A[~^]/, "")
+          v = "1.0.0" if v.empty?
+          say %(    pin "#{pkg}", to: "https://cdn.jsdelivr.net/npm/#{pkg}@#{v}/+esm")
+        end
+        say "\n  NOTE: `bin/importmap pin <pkg>` is NOT recommended for packages with submodule"
+        say "  imports (like @zag-js/*) — it only downloads the entry file, leaving relative"
+        say "  imports unresolved. The `+esm` endpoint above ships a single bundle with all"
+        say "  transitive deps resolved to absolute URLs.", :yellow
+      end
+    end
+  end
+end

data/lib/wabi/generators/install_generator.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "wabi/lockfile"
+
+module Wabi
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("../../../templates", __dir__)
+
+      desc "Set up Wabi in this Rails app: copy tokens, theme controller, init lockfile."
+
+      class_option :force, type: :boolean, default: false,
+                           desc: "Overwrite existing tokens.css and theme_controller.js (the lockfile is preserved)."
+
+      def copy_tokens
+        copy_file "tokens.css", "app/assets/tailwind/wabi/tokens.css",
+                  force: options[:force], skip: !options[:force]
+      end
+
+      def copy_theme_controller
+        copy_file "controllers/wabi/theme_controller.js",
+                  "app/javascript/controllers/wabi/theme_controller.js",
+                  force: options[:force], skip: !options[:force]
+      end
+
+      def init_lockfile
+        path = File.join(destination_root, "config/wabi.lock.json")
+        FileUtils.mkdir_p(File.dirname(path))
+        return if File.exist?(path)
+        lockfile = Wabi::Lockfile.load(path)
+        lockfile.save
+      end
+
+      def print_next_steps
+        say "\n  Wabi installed. Next steps:", :green
+        say ""
+        say "    1. Import tokens AFTER the Tailwind import in app/assets/tailwind/application.css:"
+        say "         @import \"tailwindcss\";"
+        say "         @import \"./wabi/tokens.css\";"
+        say ""
+        say "    2. Use 'tailwind' (not 'application') in your stylesheet link tag:"
+        say "         stylesheet_link_tag \"tailwind\", \"data-turbo-track\": \"reload\""
+        say "       (Rails 8.1's :app symbol also works if you keep the default ERB layout.)"
+        say ""
+        say "    3. Mount the theme controller on <html> in your layout:"
+        say "         <html data-controller=\"wabi--theme\">"
+        say ""
+        say "    4. Add components from the registry:"
+        say "         bin/rails g wabi:add button input card"
+        say "       Components autoload under Components::UI::* (Phlex 2.x convention)."
+        say "       Render them as:  render Components::UI::Button.new"
+        say ""
+        say "    5. If Tailwind doesn't pick up component classes, add this near the top of"
+        say "       application.css (Tailwind 4 normally auto-detects .rb files, but in"
+        say "       unusual asset paths an explicit @source helps):"
+        say "         @source \"../../components/**/*.rb\";"
+        say ""
+        say "    Run wabi:install --force later to refresh tokens.css and theme_controller.js"
+        say "    after a gem upgrade (your wabi.lock.json is preserved)."
+      end
+    end
+  end
+end

data/lib/wabi/generators/list_generator.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "wabi/lockfile"
+require "wabi/registry_client"
+
+module Wabi
+  module Generators
+    class ListGenerator < Rails::Generators::Base
+      desc "List installed Wabi components and available components in the registry."
+
+      def list
+        lockfile = Wabi::Lockfile.load(File.join(destination_root, "config/wabi.lock.json"))
+        installed_names = lockfile.components.keys
+
+        client = Wabi::RegistryClient.new(base_url: lockfile.registry)
+        catalog = client.fetch("index")["components"] || []
+
+        say "\nRegistry: #{lockfile.registry}\n", :cyan
+        catalog.each do |entry|
+          name = entry["name"]
+          marker = installed_names.include?(name) ? "[installed]" : "          "
+          say format("  %s  %-20s  v%s", marker, name, entry["version"])
+        end
+      end
+    end
+  end
+end

data/lib/wabi/generators/registry_generator.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "wabi/lockfile"
+
+module Wabi
+  module Generators
+    class RegistryGenerator < Rails::Generators::Base
+      argument :url, type: :string, banner: "registry_url"
+
+      desc "Set the registry URL for this project."
+
+      def update_registry
+        path = File.join(destination_root, "config/wabi.lock.json")
+        lockfile = Wabi::Lockfile.load(path)
+        # Lockfile doesn't currently expose a registry setter; bypass via instance_var.
+        lockfile.instance_variable_set(:@registry, url)
+        lockfile.save
+        say "  registry → #{url}", :green
+      end
+    end
+  end
+end

data/lib/wabi/generators/theme_generator.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "wabi/lockfile"
+require "net/http"
+require "uri"
+
+module Wabi
+  module Generators
+    class ThemeGenerator < Rails::Generators::Base
+      argument :slug, type: :string, banner: "theme_slug"
+
+      desc "Switch to a different Wabi theme palette (default, slate, stone, zinc, rose, blue, green, violet)."
+
+      def fetch_and_write
+        lockfile = Wabi::Lockfile.load(File.join(destination_root, "config/wabi.lock.json"))
+        base = lockfile.registry  # e.g. https://wabikit.dev/r OR file:///abs/path
+
+        shared = fetch("#{base}/themes/_shared.css", label: "_shared")
+        body   = fetch("#{base}/themes/#{slug}.css", label: slug)
+
+        target = File.join(destination_root, "app/assets/tailwind/wabi/tokens.css")
+        FileUtils.mkdir_p(File.dirname(target))
+        File.write(target, [shared, body].join("\n"))
+
+        say "  theme  → #{slug}", :green
+        say "  wrote  app/assets/tailwind/wabi/tokens.css", :green
+        say "         Run `bin/rails tailwindcss:build` to compile the new palette.", :cyan
+      end
+
+      private
+
+      def fetch(url_or_path, label:)
+        if url_or_path.start_with?("file://")
+          path = url_or_path.sub("file://", "")
+          raise Wabi::Error, "Theme #{label} not found at #{path}" unless File.exist?(path)
+          File.read(path)
+        else
+          uri = URI.parse(url_or_path)
+          response = Net::HTTP.get_response(uri)
+          raise Wabi::Error, "Theme #{label} not found at #{url_or_path}: HTTP #{response.code}" unless response.is_a?(Net::HTTPSuccess)
+          response.body
+        end
+      end
+    end
+  end
+end

data/lib/wabi/lockfile.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require "json"
+require "fileutils"
+
+module Wabi
+  # Manages config/wabi.lock.json in a user's Rails app.
+  # Tracks installed components, versions, hashes, and registry origin.
+  class Lockfile
+    DEFAULT_REGISTRY = "https://wabikit.dev/r"
+
+    attr_reader :path, :registry, :components
+
+    def self.load(path)
+      data =
+        if File.exist?(path)
+          JSON.parse(File.read(path))
+        else
+          {}
+        end
+      new(path: path, data: data)
+    end
+
+    def initialize(path:, data: {})
+      @path       = path
+      @registry   = data["registry"]   || DEFAULT_REGISTRY
+      @components = data["components"] || {}
+    end
+
+    def record(name, version:, hash:)
+      @components[name] = { "version" => version, "hash" => hash }
+    end
+
+    def save
+      FileUtils.mkdir_p(File.dirname(@path))
+      File.write(@path, JSON.pretty_generate({
+        "registry"   => @registry,
+        "components" => @components,
+      }))
+    end
+  end
+end

data/lib/wabi/registry_client.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "fileutils"
+require "uri"
+require_relative "version"
+
+module Wabi
+  class RegistryClient
+    DEFAULT_BASE_URL = "https://wabikit.dev/r"
+    DEFAULT_TTL = 24 * 60 * 60
+
+    attr_reader :base_url
+
+    def initialize(base_url: DEFAULT_BASE_URL)
+      @base_url = base_url
+      @ttl = Integer(ENV.fetch("WABI_CACHE_TTL", DEFAULT_TTL))
+    end
+
+    def cache_dir
+      File.expand_path("~/.cache/wabi/#{Wabi::VERSION}")
+    end
+
+    def fetch(component_name)
+      unless dev_context?
+        cached = read_cache(component_name)
+        return JSON.parse(cached) if cached
+      end
+
+      body =
+        if @base_url.start_with?("file://")
+          fetch_local(component_name)
+        else
+          fetch_http(component_name)
+        end
+
+      write_cache(component_name, body) unless dev_context?
+      JSON.parse(body)
+    end
+
+    private
+
+    def dev_context?
+      @base_url.start_with?("file://", "http://localhost", "http://127.")
+    end
+
+    def fetch_local(name)
+      path = File.join(@base_url.sub("file://", ""), "#{name}.json")
+      raise Wabi::Error, "Component #{name} not found at #{path}" unless File.exist?(path)
+      File.read(path)
+    end
+
+    def fetch_http(name)
+      uri = URI.parse("#{@base_url}/#{name}.json")
+      response = Net::HTTP.get_response(uri)
+      unless response.is_a?(Net::HTTPSuccess)
+        raise Wabi::Error, "Failed to fetch #{name}: HTTP #{response.code}"
+      end
+      response.body
+    end
+
+    def cache_path(name)
+      File.join(cache_dir, "#{name}.json")
+    end
+
+    def read_cache(name)
+      path = cache_path(name)
+      return nil unless File.exist?(path)
+      return nil if (Time.now - File.mtime(path)) > @ttl
+      File.read(path)
+    end
+
+    def write_cache(name, body)
+      FileUtils.mkdir_p(cache_dir)
+      File.write(cache_path(name), body)
+    end
+  end
+end

data/lib/wabi/turbo_stream_extensions.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Wabi
+  # Extends `Turbo::Streams::TagBuilder` with a `wabi_toast` shorthand that
+  # appends a server-rendered Toast component into the singleton Toaster
+  # container.
+  #
+  # In a Rails controller / Turbo Stream view:
+  #
+  #   render turbo_stream: turbo_stream.wabi_toast(
+  #     title: "Saved",
+  #     description: "Profile updated.",
+  #     appearance: :success,
+  #   )
+  #
+  # Equivalent to:
+  #
+  #   render turbo_stream: turbo_stream.append(
+  #     "wabi-toaster",
+  #     Components::UI::Toast.new(title: "Saved", description: "...", appearance: :success),
+  #   )
+  #
+  # The user app must have run `bin/rails g wabi:add toast` first so that
+  # `Components::UI::Toast` is defined.
+  #
+  # NOTE: this module is named `Wabi::TurboStreamExtensions` (NOT
+  # `Wabi::Rails::TurboStreamExtensions`) because nesting a `Rails` module
+  # inside `Wabi` shadows the top-level `Rails` constant from generators that
+  # reference `Rails::Generators::Base`, breaking gem load order.
+  module TurboStreamExtensions
+    def wabi_toast(toaster_id: "wabi-toaster", **toast_options)
+      toast_class = wabi_resolve_toast_class
+      append(toaster_id, toast_class.new(**toast_options))
+    end
+
+    private
+
+    def wabi_resolve_toast_class
+      Object.const_get("Components::UI::Toast")
+    rescue NameError
+      raise NameError,
+            "Components::UI::Toast is not defined. Run `bin/rails g wabi:add toast` " \
+            "to install the component before using `turbo_stream.wabi_toast(...)`."
+    end
+  end
+end
+
+# Inject into Turbo's tag builder when Turbo is loaded. Gated so the gem stays
+# usable in non-Turbo Rails apps and in pure-Ruby specs.
+if defined?(::Turbo::Streams::TagBuilder)
+  ::Turbo::Streams::TagBuilder.include(Wabi::TurboStreamExtensions)
+end

data/lib/wabi/variants.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Wabi
+  # CVA-style variant DSL. Use by extending into a class:
+  #
+  #   class Button
+  #     extend Wabi::Variants
+  #     variants do
+  #       base "btn"
+  #       variant :size, { sm: "h-8", md: "h-10" }, default: :md
+  #     end
+  #   end
+  #
+  #   Button.new.tokens(size: :sm) # => "btn h-8"
+  module Variants
+    def variants(&block)
+      definition = Definition.new
+      definition.instance_eval(&block)
+      @_wabi_variants = definition
+      define_method(:tokens) do |**opts|
+        self.class.instance_variable_get(:@_wabi_variants).resolve(**opts)
+      end
+    end
+
+    class Definition
+      def initialize
+        @base = ""
+        @variants = {}
+        @defaults = {}
+      end
+
+      def base(str)
+        @base = str
+      end
+
+      def variant(key, options, default: nil)
+        @variants[key] = options
+        @defaults[key] = default if default
+      end
+
+      def resolve(**opts)
+        parts = [@base]
+        @variants.each do |key, options|
+          selected = opts[key] || @defaults[key]
+          parts << options[selected] if selected && options[selected]
+        end
+        parts.compact.reject(&:empty?).join(" ")
+      end
+    end
+  end
+end

data/lib/wabi/version.rb

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

data/lib/wabi.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require_relative "wabi/version"
+require_relative "wabi/base"
+require_relative "wabi/class_merge"
+require_relative "wabi/variants"
+require_relative "wabi/registry_client"
+require_relative "wabi/lockfile"
+require_relative "wabi/turbo_stream_extensions"
+
+module Wabi
+  class Error < StandardError; end
+end
+
+# Generators are only loaded under Rails (which triggers them via convention)
+if defined?(Rails::Generators)
+  require_relative "wabi/generators/install_generator"
+  require_relative "wabi/generators/add_generator"
+  require_relative "wabi/generators/list_generator"
+  require_relative "wabi/generators/registry_generator"
+  require_relative "wabi/generators/theme_generator"
+end

data/templates/controllers/wabi/theme_controller.js

@@ -0,0 +1,37 @@
+import { Controller } from "@hotwired/stimulus"
+
+// Wabi theme controller — toggles data-mode on <html>, persists to localStorage,
+// respects prefers-color-scheme on first load.
+export default class extends Controller {
+  static values = {
+    themeKey: { type: String, default: "wabi-theme" },
+    modeKey:  { type: String, default: "wabi-mode" },
+  }
+
+  connect() {
+    const html = document.documentElement
+    const storedTheme = localStorage.getItem(this.themeKeyValue) || "default"
+    const storedMode  = localStorage.getItem(this.modeKeyValue) || this.systemMode()
+    html.dataset.theme = storedTheme
+    html.dataset.mode  = storedMode
+  }
+
+  toggleMode() {
+    const html = document.documentElement
+    const next = html.dataset.mode === "dark" ? "light" : "dark"
+    html.dataset.mode = next
+    localStorage.setItem(this.modeKeyValue, next)
+    this.dispatch("change", { detail: { mode: next } })
+  }
+
+  setTheme(event) {
+    const theme = event.params.theme
+    document.documentElement.dataset.theme = theme
+    localStorage.setItem(this.themeKeyValue, theme)
+    this.dispatch("change", { detail: { theme } })
+  }
+
+  systemMode() {
+    return window.matchMedia?.("(prefers-color-scheme: dark)").matches ? "dark" : "light"
+  }
+}

data/templates/tokens.css

@@ -0,0 +1,87 @@
+/* Wabi theme system — Tailwind 4 native, shared infrastructure.
+ *
+ * Every Wabi theme CSS file is the concatenation of this `_shared.css` and a
+ * per-theme `<slug>.css` file containing only the raw HSL variable blocks.
+ * The build step in `registry/lib/builder.rb` emits the merged result to
+ * `gem/templates/tokens.css` (for the gem's wabi:install) and
+ * `docs/app/assets/tailwind/wabi/tokens.css` (for live switching in docs).
+ */
+
+@custom-variant dark (&:where([data-mode="dark"], [data-mode="dark"] *));
+
+@theme inline {
+  --color-background: hsl(var(--background));
+  --color-foreground: hsl(var(--foreground));
+  --color-card: hsl(var(--card));
+  --color-card-foreground: hsl(var(--card-foreground));
+  --color-popover: hsl(var(--popover));
+  --color-popover-foreground: hsl(var(--popover-foreground));
+  --color-primary: hsl(var(--primary));
+  --color-primary-foreground: hsl(var(--primary-foreground));
+  --color-secondary: hsl(var(--secondary));
+  --color-secondary-foreground: hsl(var(--secondary-foreground));
+  --color-muted: hsl(var(--muted));
+  --color-muted-foreground: hsl(var(--muted-foreground));
+  --color-accent: hsl(var(--accent));
+  --color-accent-foreground: hsl(var(--accent-foreground));
+  --color-destructive: hsl(var(--destructive));
+  --color-destructive-foreground: hsl(var(--destructive-foreground));
+  --color-border: hsl(var(--border));
+  --color-input: hsl(var(--input));
+  --color-ring: hsl(var(--ring));
+  --radius-lg: var(--radius);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-sm: calc(var(--radius) - 4px);
+}
+
+/* Wabi default theme — neutral grayscale.
+ *
+ * Raw HSL values only. The `_shared.css` companion ships the @custom-variant
+ * + @theme inline mapping; both files must be concatenated to produce a
+ * working tokens.css.
+ */
+
+:root, [data-theme="default"] {
+  --background: 0 0% 100%;
+  --foreground: 240 10% 3.9%;
+  --primary: 240 5.9% 10%;
+  --primary-foreground: 0 0% 98%;
+  --secondary: 240 4.8% 95.9%;
+  --secondary-foreground: 240 5.9% 10%;
+  --muted: 240 4.8% 95.9%;
+  --muted-foreground: 240 3.8% 46.1%;
+  --accent: 240 4.8% 95.9%;
+  --accent-foreground: 240 5.9% 10%;
+  --destructive: 0 84.2% 60.2%;
+  --destructive-foreground: 0 0% 98%;
+  --border: 240 5.9% 90%;
+  --input: 240 5.9% 90%;
+  --ring: 240 5.9% 10%;
+  --radius: 0.5rem;
+  --card: 0 0% 100%;
+  --card-foreground: 240 10% 3.9%;
+  --popover: 0 0% 100%;
+  --popover-foreground: 240 10% 3.9%;
+}
+
+[data-theme="default"][data-mode="dark"] {
+  --background: 240 10% 3.9%;
+  --foreground: 0 0% 98%;
+  --primary: 0 0% 98%;
+  --primary-foreground: 240 5.9% 10%;
+  --secondary: 240 3.7% 15.9%;
+  --secondary-foreground: 0 0% 98%;
+  --muted: 240 3.7% 15.9%;
+  --muted-foreground: 240 5% 64.9%;
+  --accent: 240 3.7% 15.9%;
+  --accent-foreground: 0 0% 98%;
+  --destructive: 0 62.8% 30.6%;
+  --destructive-foreground: 0 0% 98%;
+  --border: 240 3.7% 15.9%;
+  --input: 240 3.7% 15.9%;
+  --ring: 240 4.9% 83.9%;
+  --card: 240 10% 3.9%;
+  --card-foreground: 0 0% 98%;
+  --popover: 240 10% 3.9%;
+  --popover-foreground: 0 0% 98%;
+}

metadata

@@ -0,0 +1,161 @@
+--- !ruby/object:Gem::Specification
+name: wabi
+version: !ruby/object:Gem::Version
+  version: 0.3.0
+platform: ruby
+authors:
+- Oscar Ortega
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: phlex-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.0'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.13'
+- !ruby/object:Gem::Dependency
+  name: fakefs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.26'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.26'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: An OSS UI component library for Rails 8 — Phlex-native, Tailwind-themed,
+  accessible, with 'you own the code' philosophy.
+email:
+- dev@cosmaneura.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/wabi.rb
+- lib/wabi/base.rb
+- lib/wabi/class_merge.rb
+- lib/wabi/generators/add_generator.rb
+- lib/wabi/generators/install_generator.rb
+- lib/wabi/generators/list_generator.rb
+- lib/wabi/generators/registry_generator.rb
+- lib/wabi/generators/theme_generator.rb
+- lib/wabi/lockfile.rb
+- lib/wabi/registry_client.rb
+- lib/wabi/turbo_stream_extensions.rb
+- lib/wabi/variants.rb
+- lib/wabi/version.rb
+- templates/controllers/wabi/theme_controller.js
+- templates/tokens.css
+homepage: https://wabikit.dev
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://wabikit.dev
+  source_code_uri: https://github.com/wabikit/wabi
+  bug_tracker_uri: https://github.com/wabikit/wabi/issues
+  changelog_uri: https://github.com/wabikit/wabi/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.4'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: Beautifully imperfect components for Rails.
+test_files: []