wabi 0.30.0 → 0.30.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71aa466808ac1d38788cab128140642bc5b7130b045f72bdf9c7a76dc9545fcf
-  data.tar.gz: b2a9956a503a1a7cea95730b4d819ee47a332006ef22598338432fefb30bac53
+  metadata.gz: f985366bdbaa72cb9eb6e8e298fe9bf5557ab1fc23d316ca2c73c3d11203ea83
+  data.tar.gz: abc233d1f6ee64d0240f536dcf734915bd10e064358f5f1a57a7be3ebff7306d
 SHA512:
-  metadata.gz: '09bcde85a5ad92d26b7992c84186d118d09dff63b5ec78159da8b90895a788199dde737cd2aa457c370a9f55d6cb021613fb182b01931852e728a4b9594b7875'
-  data.tar.gz: ec94e25aa20ee576d77f8c9bdd66cad7401b6d8265d365bb41de255c0e4691f70710270f8367085ea14027d4ef632494ba7470edb1b5df698a63eaa934530bf2
+  metadata.gz: 1149b9dc2e6ceb244ceba8b1c89937306d066fbd41951590899755f86908e0246898f424376f0cabfb8d3e805357718c70dab61210bacb76ca608fc4f8b51759
+  data.tar.gz: bfcf82fdfdc5b4ed09848ebe52240ea6025d910f2124edfaab53111850df9907fe581821b363b0d0d88c08d6acf935fcadcf86441c5f07c71768f0c29b670670

data/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 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.30.2 - 2026-06-10
+
+### Docs
+- Brand identity: a wabi-sabi gem icon (a faceted gem with a chipped edge) replaces Rails' default red-circle favicon — adaptive `icon.svg`, `icon.png`, and `favicon.ico`, plus the gem next to the "Wabi" wordmark in the docs header and above the README title.
+
+## 0.30.1 - 2026-06-09
+
+Fresh-install fix, found by following the README in a brand-new Rails app.
+
+### Fixed
+- **`require "phlex/rails"` from the gem entrypoint** (when Rails is defined). Apps that only `bundle add wabi` previously got Phlex without the Rails integration — the first `render Components::UI::X` failed with "must implement #to_partial_path". The docs app masked this by depending on phlex-rails directly.
+- `wabi:install` now warns when Phlex isn't set up (no `config/initializers/phlex.rb`) and points at `bin/rails g phlex:install`, which creates the `Components::`/`Views::` namespaces components autoload under.
+
+### Docs
+- README quick start gains the `phlex:install` step, the importmap-pins note for interactive components, and the `--css tailwind` prerequisite; CLI table documents `wabi:update`; stale counts/roadmap refreshed. Getting-started page updated to match.
+
 ## 0.30.0 - 2026-06-09
 
 Pre-1.0 hardening: a Turbo-cache fix for every portaled overlay, dependency alignment, and release-metadata polish. Version jumps 0.26 → 0.30 to mark the start of the 0.3x pre-1.0 series.

data/README.md

@@ -1,32 +1,43 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/wabikit/wabi/main/docs/public/icon.png" width="84" height="84" alt="Wabi logo — a faceted gem with a chipped edge">
+</p>
+
 # 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.30.0 alpha — [available on RubyGems](https://rubygems.org/gems/wabi). 49 components, 8 theme palettes, WCAG-AA audited, live docs + registry at [wabi-docs.onrender.com](https://wabi-docs.onrender.com).
+🎉 **Status:** v0.30.2 alpha — [available on RubyGems](https://rubygems.org/gems/wabi). 49 components, 8 theme palettes, WCAG-AA audited, live docs + registry at [wabi-docs.onrender.com](https://wabi-docs.onrender.com).
 
 ---
 
 ## Quick start
 
+Wabi expects a Rails 8 app with Tailwind 4 and importmap (`rails new myapp --css tailwind` gives you both).
+
 ```bash
 # 1. Add the gem
 bundle add wabi
 
-# 2. Run the installer (copies tokens.css + theme controller + lockfile)
+# 2. Set up Phlex (skip if your app already uses phlex-rails) —
+#    creates the Components::/Views:: namespaces components autoload under
+bin/rails g phlex:install
+
+# 3. Run the Wabi installer (copies tokens.css + theme controller + lockfile)
 bin/rails g wabi:install
 
-# 3. Add components from the registry
+# 4. Add components from the registry
 bin/rails g wabi:add button card dialog
 
-# 4. Render
-# In any Phlex view:
+# 5. Render — in any Phlex view or ERB template:
 #   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.
 
+Interactive components (dialog, select, …) need their Zag.js importmap pins — `wabi:add` prints the exact `pin` lines to paste into `config/importmap.rb`. Restart the server after adding initializers or pins.
+
 ---
 
 ## What's in the box
@@ -105,6 +116,7 @@ That's a fully-accessible modal with focus trap, scroll lock, backdrop click, Es
 |---|---|
 | `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:update <name…>` | Re-fetches installed components and 3-way merges registry changes with your local edits (conflict markers on overlap). |
 | `wabi:list` | Lists all available components in the configured registry. |
 | `wabi:registry <url>` | Switches the active registry origin (default: `https://wabi-docs.onrender.com/r`). |
 | `wabi:theme <slug>` | Swaps `tokens.css` for the requested palette. Run `bin/rails tailwindcss:build` after. |
@@ -135,11 +147,11 @@ bin/dev      # starts registry watcher + tailwind watcher + docs server on :3000
 
 Then visit:
 - `/` — marketing landing
-- `/docs/components` — index of all 36 components
+- `/docs/components` — index of all 49 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)
+- `/preview` — kitchen sink (every component on one page)
 
 ---
 
@@ -184,7 +196,9 @@ Requires Node 20+ in PATH (Pagefind is fetched via `npx` on demand).
 | v0.12 | Skeleton, Breadcrumb, Pagination, Progress, AlertDialog | ✅ shipped 2026-06-01 |
 | v0.13 | DataTable (server-driven: sortable headers + row selection) | ✅ shipped 2026-06-01 |
 | v0.14–0.25 | JS test suite + coverage floors; +29 components (Sidebar, Carousel, Splitter, NavigationMenu, RatingGroup, HoverCard, TagsInput, Collapsible, ColorPicker, TreeView, …); full WCAG-AA audit | ✅ shipped 2026-06-08 |
-| v1.0 | API stability; external a11y audit | 2027-04 target |
+| v0.26 | API-standardization pass (frozen contract for 1.0); docs consistency sweep; automated OIDC gem releases | ✅ shipped 2026-06-09 |
+| v0.30 | Pre-1.0 hardening: Turbo-cache overlay fix, Zag 1.41.2 alignment, Ruby >= 4.0 | ✅ shipped 2026-06-09 |
+| v1.0 | API stability; external a11y audit | next up |
 
 See [ROADMAP.md](./ROADMAP.md) for the long-term view and [CHANGELOG.md](./CHANGELOG.md) for the per-release detail.
 

data/lib/wabi/generators/install_generator.rb

@@ -49,6 +49,17 @@ module Wabi
         RUBY
       end
 
+      # Wabi components autoload under Components::UI — that namespace comes
+      # from phlex-rails's own installer (config/initializers/phlex.rb pushes
+      # app/components under Components). Warn when it's missing, otherwise the
+      # first `render Components::UI::X` raises uninitialized constant.
+      def check_phlex_setup
+        return if File.exist?(File.join(destination_root, "config/initializers/phlex.rb"))
+        say "\n  ⚠ Phlex doesn't look set up in this app (no config/initializers/phlex.rb).", :yellow
+        say "    Run `bin/rails g phlex:install` to create the Components::/Views:: namespaces"
+        say "    Wabi components rely on — without it Components::UI::* won't resolve."
+      end
+
       def print_next_steps
         say "\n  Wabi installed. Next steps:", :green
         say ""

data/lib/wabi/version.rb

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

data/lib/wabi.rb

@@ -1,5 +1,12 @@
 # frozen_string_literal: true
 
+# Load phlex-rails before anything else: it gives Phlex components render_in /
+# the Rails integration. Without this require, apps that only `bundle add wabi`
+# get a Phlex::HTML with no Rails support and `render Components::UI::X` fails
+# with "must implement #to_partial_path". Guarded because phlex/rails needs
+# ActiveSupport (absent in the bare gem test env).
+require "phlex/rails" if defined?(Rails)
+
 require_relative "wabi/version"
 require_relative "wabi/base"
 require_relative "wabi/class_merge"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wabi
 version: !ruby/object:Gem::Version
-  version: 0.30.0
+  version: 0.30.2
 platform: ruby
 authors:
 - Oscar Ortega