wabi 0.4.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5c5512565440dd12e42434dceb8522dbd9b0757e41b63981617e8a645f69bb37
-  data.tar.gz: 2f0c77f0a635bcd6bb2673fb403db9d9247bc916a4adf77ef9398a6816e3fbff
+  metadata.gz: 1975dde8069f308dad1c022923250b6ede092df708ba5cf5fdee333554dccbbe
+  data.tar.gz: 8e90d286204bb1ab579116ea8ab3ea2eec74262d55d20b758846b70bda85b755
 SHA512:
-  metadata.gz: 2a4eaf8d667a84e467238e9ba0b4f9cd14d9a5b685698ea82ed3c7ed443bac56b5ddc3c35bf68299947ec38ba7ed49b7d2a6fc0799a5311fc98e3aa9a443b5fe
-  data.tar.gz: 1f03f62dbcf1907505f19dd570d2ca7e06b15cbb9ad3cacb579885deba29b947057da789296981cf6ccafbca2c502989d400bb8e2011e84e0550d20dd49b3419
+  metadata.gz: fa61e143320502d057ee2f9bd4e4b6618726035c491917c9af0b0767b4464068f9c94376211853eba983cb0e131e2ddc82a361711fae495bba31fc1d53e0a206
+  data.tar.gz: dc50cb00e2cabfa8c992fbd3410f6947a76208c3b955c651771cc95f81f180ca151ab061afecfa32d743e79d5abc87b7cea5906f6b511f3b6082421a638cdf3f

data/CHANGELOG.md

@@ -2,6 +2,181 @@
 
 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.7.0 - 2026-05-30
+
+Quality + finish: 10 items closing v0.6 deferrals and v0.5 long-tail. No new
+components; one breaking change.
+
+### Breaking
+
+- **Slider range hidden inputs** now use Rails-native bracket params
+  (`name[min]` / `name[max]`) instead of v0.6's flat `name_min` /
+  `name_max`. Apps consuming range params must update their strong params
+  from `params.permit(:price_min, :price_max)` to
+  `params.require(:price).permit(:min, :max)`. Single-thumb sliders are
+  unchanged (`name=<value>`).
+
+### Features
+
+- **Combobox `ComboboxItemIndicator`** now wires through `getItemIndicatorProps`
+  and toggles `hidden` based on the item's selected state (was unwired in v0.6).
+- **Combobox per-item `disabled`** flag now works end-to-end: an item can carry
+  `{ value, label, disabled: true }` and the controller passes `isItemDisabled`
+  to the Zag collection so Zag stamps `data-disabled` on the matching `<li>` for
+  the `data-[disabled]:*` Tailwind variants.
+- **Command palette item selection closes the dialog.** The bridge controller
+  listens at `document` level for `wabi--combobox:change` and filters by id
+  linkage (`data-wabi--command-id`, read via `getAttribute` — the double-dash
+  attribute does not round-trip through `dataset`) to survive the dialog portal
+  move. The controllers are ordered `wabi--command wabi--dialog` so the bridge
+  stamps the dialog content before the dialog portals it. The "Preview in v0.6"
+  callout is removed.
+- **Command auto-opens the combobox when the dialog opens** so item clicks work
+  immediately, without typing first. The combobox builds its collection from the
+  rendered items when no `items` value is supplied.
+- **Toast Sonner-style animations.** Slides in from the right on enter and slides
+  back out on exit — pure CSS transitions on `data-state`, no plugin dependency.
+- **`window.wabiToasters[id]`** keyed registry (via a new `wabi--toaster`
+  controller on the `<ol>`) for pages with multiple Toaster instances.
+  `turbo_stream.wabi_toast(toaster_id: "alerts", ...)` targets a specific one.
+  `window.wabiToaster` remains as a deprecated alias to the most-recently-
+  connected toaster for back-compat.
+- **DropdownMenu N-level submenus.** Sub-inside-sub nesting now works to
+  arbitrary depth (v0.6 was single-level only). Each sub links to its closest
+  ancestor sub or the root menu.
+
+### Cleanup / Perf
+
+- **Vestigial `*-target="portal"` wrappers removed** from the portal-using
+  overlays (Dialog, Drawer, Command dialog). The wrapper was a v0.4 placeholder
+  for `portal: false` mode and added no behavior in v0.5+. (Popover, Tooltip,
+  DropdownMenu, and Select had already been cleaned in a prior refactor.)
+- **`WabiPortalRegistry.applyInert`** caches the body-siblings list. The cache is
+  invalidated only when register/unregister changes the portal node set;
+  `onOpenChange` reuses the cache and just toggles the inert attribute.
+
+### Deferred to v0.8
+
+- Combobox async items (server-side fetching).
+- Toast `@zag-js/toast` group machine retry.
+- `wabi:update` three-way merge on conflict.
+- Slider marks/ticks.
+- Overlay controller boilerplate refactor (the overlay controllers share
+  attach/restore boilerplate; the DropdownMenu ancestor-lookup is duplicated
+  between `connect()` and `render()`).
+- `motion-reduce:transition-none` on Toast (and overlays) for reduced-motion.
+- `WabiPortalRegistry` unregister/restoreFromBody ordering tidy.
+
+## 0.6.0 - 2026-05-28
+
+### Features
+
+- **Forms wave** — 7 new components bring Wabi to 27 total:
+  - `Toggle` — pressable toggle button (Bold/Italic style). Distinct from
+    Switch, which is the sliding control. Variants: appearance
+    (default/outline) and size (default/sm/lg). Powered by `@zag-js/toggle`.
+  - `RadioGroup` + `RadioGroupItem` + `RadioGroupIndicator` —
+    single-select radio group with keyboard navigation via
+    `@zag-js/radio-group`. Hidden `<input type="radio">` per item for
+    form submission.
+  - `ToggleGroup` + `ToggleGroupItem` — group of toggles. `type: :single`
+    enforces single selection (radio-like with button styling);
+    `type: :multiple` allows multiple simultaneous selections. Hidden
+    inputs emitted by the controller (`name` for single, `name[]` for
+    multiple).
+  - `Slider` + `SliderLabel` + `SliderTrack` + `SliderRange` +
+    `SliderThumb` — value picker. Accepts Integer (single thumb) or
+    Array (range mode). Vertical orientation via
+    `orientation: :vertical`. Range inputs submit as `name_min`/`name_max`.
+  - `Combobox` + 8 sub-components — input with autocomplete dropdown.
+    Static items only in v0.6 (async deferred to v0.7). Uses the
+    Sprint 9 portal pattern as a non-modal anchored overlay. A sibling
+    `<input type="hidden">` mirrors the selected value so form
+    submission posts the value, not the typed label.
+  - `Form` + `FormField` + `FormLabel` + `FormDescription` +
+    `FormMessage` — Phlex wrapper over Rails' `form_with` helper.
+    FormMessage auto-extracts ActiveModel errors via `model:` + `field:`
+    kwargs, with `text:` override for explicit messages. FormLabel uses
+    `for_:` (matching the standalone `Label` convention).
+  - `Command` + 7 sub-components — Cmd+K palette. Composition of Dialog
+    (modal) and Combobox (filterable list). The combobox controller is
+    mounted on an inner wrapper so it can't overwrite the dialog's
+    role / aria-modal / data-state attributes (a trap discovered during
+    smoke testing — `spreadProps` from `@zag-js/vanilla` strips existing
+    attrs). Selection-closes-palette is **deferred to v0.7** (the
+    `wabi--command` bridge can't reach across the dialog portal yet).
+
+### Docs
+
+- Form docs page demonstrates a multi-field example (name + email + bio
+  + newsletter checkbox + submit) with client-side validation and
+  inline success / per-field error messages — no page reload.
+- Sidebar preserves its scroll position across Turbo navigations and
+  highlights the active component with `bg-accent + font-semibold +
+  shadow-sm` via Tailwind's `aria-[current=page]:` arbitrary variant.
+- Docs `Pagefind` indexer now derives `ROUTES_TO_INDEX` from
+  `ComponentsController::ALL` instead of a hand-maintained list, so
+  future component additions are crawled automatically.
+
+### Deferred to v0.7
+
+- Combobox async items (server-side fetching via Turbo Frame or
+  callback).
+- Combobox `ComboboxItemIndicator` wiring (exported but not consumed by
+  the controller render loop).
+- Combobox `disabled:` on individual items (data attribute is set but
+  the collection doesn't pass `isItemDisabled`).
+- Slider marks/ticks at specific track positions.
+- Command palette item selection auto-closing the dialog (the
+  `wabi--command` bridge listener doesn't cross the dialog portal —
+  needs Stimulus Outlets or a document-level listener).
+- Toast `@zag-js/toast` group machine retry + Sonner-style animations
+  (carried over from v0.5).
+- Overlay controller boilerplate refactor (the now-six overlay
+  controllers share ~50 LOC of attach/restore + ref capture).
+- Vestigial `wabi--<name>-target="portal"` wrappers cleanup.
+- DropdownMenu multi-level submenu nesting.
+- `wabi:update` three-way merge.
+
+## 0.5.0 - 2026-05-27
+
+### Breaking
+
+- **Overlays portal to `document.body` by default**. Dialog, Drawer,
+  Tooltip, Popover, DropdownMenu, and Select all move their content (and
+  backdrop/positioner where applicable) to `<body>` on connect. Pass
+  `portal: false` to keep v0.4 in-tree behavior. The shared
+  `WabiPortalRegistry` JS module is now part of every overlay's wabi:add
+  install — it lands at
+  `app/javascript/controllers/wabi/_shared/portal_registry.js`.
+
+### Features
+
+- `wabi:update` generator. Per-component diff-aware updates with
+  per-file conflict detection. Flags: `--force`, `--dry-run`. Reads
+  and writes per-file SHA256 hashes in `wabi.lock.json` (additive
+  schema; legacy lockfiles fall back to prompting on every file).
+- Real portal pattern for the 6 overlays. Resolves the v0.1 carryover
+  documented in `docs/V01-CARRYOVER.md` (#3). Overlays inside
+  transformed/scrollable ancestors now position relative to the
+  viewport.
+
+### Docs
+
+- `+esm` jsdelivr footnote added to 5 component pages
+  (checkbox/select/switch/dialog/tabs) for parity with the other 5
+  Zag-backed components.
+
+### Deferred to v0.6
+
+- Toast `@zag-js/toast` group machine. Attempted in v0.5 but reverted — the group machine's interaction with Phlex+Stimulus+Turbo caused an infinite render loop. v0.4 vanilla setTimeout controller restored; group features (max/gap/pause-on-group-hover/swipe) targeted for v0.6 with a different implementation strategy.
+- Forms wave (RadioGroup/Toggle/ToggleGroup/Slider/Combobox/Command/Form).
+- Nav wave (Sheet/ContextMenu/Pagination/NavigationMenu).
+- Data wave (Calendar/DatePicker/DataTable).
+- Three-way merge in `wabi:update`.
+- Multi-level DropdownMenu nesting (sub-inside-sub).
+- Phlex 2.4 Ruby 4 warnings (upstream).
+
 ## [0.4.0] — 2026-05-27
 
 Sprint 8 — docs completeness + theme polish. The docs site gains the

data/lib/wabi/generators/add_generator.rb

@@ -37,17 +37,20 @@ module Wabi
 
         Array(data["registry_dependencies"]).each { |dep| install_component(dep) }
 
+        files_map = {}
         data["files"].each do |file|
           target = File.join(destination_root, file["path"])
           FileUtils.mkdir_p(File.dirname(target))
           File.write(target, file["content"])
+          files_map[file["path"]] = Digest::SHA256.hexdigest(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)
+        lockfile.record(name, version: data["version"], hash: hash, files: files_map,
+                        js_dependencies: data["js_dependencies"])
       end
 
       def print_js_pin_instructions

data/lib/wabi/generators/update_generator.rb

@@ -0,0 +1,184 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "digest"
+require "json"
+require "wabi/registry_client"
+require "wabi/lockfile"
+
+module Wabi
+  module Generators
+    class UpdateGenerator < Rails::Generators::Base
+      argument :components, type: :array, default: [],
+               banner: "[component_name ...]"
+
+      class_option :force,   type: :boolean, default: false,
+                             desc: "Overwrite locally-edited files without prompting."
+      class_option :dry_run, type: :boolean, default: false,
+                             desc: "Report planned changes, write nothing."
+
+      desc "Update installed Wabi components to the latest registry versions."
+
+      class UpdateAborted < StandardError; end
+
+      def update_components
+        names = target_names
+        if names.empty?
+          say "  no components to update", :yellow
+          return
+        end
+        names.each { |name| update_component(name) }
+        lockfile.save unless options[:dry_run]
+      rescue UpdateAborted => e
+        say "  aborted: #{e.message}", :red
+      end
+
+      private
+
+      def target_names
+        components.any? ? components : lockfile.components.keys
+      end
+
+      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 update_component(name)
+        unless lockfile.components.key?(name)
+          say "  not installed: #{name} (use `wabi:add #{name}`)", :yellow
+          return
+        end
+
+        installed_version = lockfile.components[name]["version"]
+        data              = client.fetch(name)
+        remote_version    = data["version"]
+
+        if Gem::Version.new(remote_version) <= Gem::Version.new(installed_version)
+          say "  up-to-date  #{name} (#{installed_version})", :cyan
+          return
+        end
+
+        say "  updating    #{name} (#{installed_version} -> #{remote_version})", :green
+
+        files_map     = {}
+        installed_map = lockfile.components[name]["files"] || {}
+
+        data["files"].each do |file|
+          path     = file["path"]
+          new_hash = Digest::SHA256.hexdigest(file["content"])
+          target   = File.join(destination_root, path)
+
+          files_map[path] = new_hash
+
+          if !File.exist?(target)
+            write_file(target, file["content"], reason: "create")
+            next
+          end
+
+          on_disk_hash   = Digest::SHA256.hexdigest(File.read(target))
+          installed_hash = installed_map[path]
+
+          if installed_hash.nil?
+            handle_conflict(path, target, file["content"], reason: "legacy lockfile has no per-file hash")
+            next
+          end
+
+          if on_disk_hash == installed_hash
+            write_file(target, file["content"], reason: "update")
+          else
+            handle_conflict(path, target, file["content"], reason: "edited locally")
+          end
+        end
+
+        print_js_deps_diff(name, data["js_dependencies"])
+
+        lockfile.record(
+          name,
+          version:         remote_version,
+          hash:            Digest::SHA256.hexdigest(JSON.generate(data["files"])),
+          files:           files_map,
+          js_dependencies: data["js_dependencies"],
+        )
+      end
+
+      def write_file(target, content, reason:)
+        if options[:dry_run]
+          say "  would write #{target} (#{reason})", :cyan
+          return
+        end
+        FileUtils.mkdir_p(File.dirname(target))
+        File.write(target, content)
+        say "  #{reason.ljust(10)} #{target}", :green
+      end
+
+      def handle_conflict(path, target, new_content, reason:)
+        if options[:force]
+          write_file(target, new_content, reason: "force-overwrite")
+          return
+        end
+        if options[:dry_run]
+          say "  CONFLICT    #{path} (#{reason}) - would prompt", :yellow
+          return
+        end
+
+        loop do
+          say ""
+          say "  conflict    #{path}", :yellow
+          say "    #{reason}. Overwrite with new version?", :yellow
+          answer = prompt_conflict(path)
+          case answer
+          when "y"
+            write_file(target, new_content, reason: "overwrite")
+            return
+          when "n"
+            say "    skipped     #{path}", :cyan
+            return
+          when "d"
+            print_diff(target, new_content)
+            next
+          when "q"
+            raise UpdateAborted, "user aborted update"
+          end
+        end
+      end
+
+      def prompt_conflict(_path)
+        ask("    (y)es / (n)o / (d)iff / (q)uit?", limited_to: %w[y n d q])
+      end
+
+      def print_diff(target, new_content)
+        on_disk = File.exist?(target) ? File.read(target) : ""
+        on_disk_lines = on_disk.split("\n", -1)
+        new_lines     = new_content.split("\n", -1)
+        say ""
+        say "    --- on-disk", :red
+        on_disk_lines.each { |l| say "    - #{l}", :red }
+        say "    +++ new", :green
+        new_lines.each { |l| say "    + #{l}", :green }
+        say ""
+      end
+
+      def print_js_deps_diff(name, new_deps)
+        new_deps ||= {}
+        old_deps   = lockfile.components.dig(name, "js_dependencies") || {}
+
+        added   = new_deps.reject { |pkg, _| old_deps.key?(pkg) }
+        changed = new_deps.select { |pkg, ver| old_deps.key?(pkg) && old_deps[pkg] != ver }
+
+        return if added.empty? && changed.empty?
+
+        say ""
+        say "  JS pin changes for #{name}:", :yellow
+        (added.merge(changed)).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
+      end
+    end
+  end
+end

data/lib/wabi/lockfile.rb

@@ -27,8 +27,11 @@ module Wabi
       @components = data["components"] || {}
     end
 
-    def record(name, version:, hash:)
-      @components[name] = { "version" => version, "hash" => hash }
+    def record(name, version:, hash:, files: nil, js_dependencies: nil)
+      entry = { "version" => version, "hash" => hash }
+      entry["files"]           = files           if files
+      entry["js_dependencies"] = js_dependencies if js_dependencies
+      @components[name] = entry
     end
 
     def save

data/lib/wabi/version.rb

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

data/lib/wabi.rb

@@ -16,6 +16,7 @@ end
 if defined?(Rails::Generators)
   require_relative "wabi/generators/install_generator"
   require_relative "wabi/generators/add_generator"
+  require_relative "wabi/generators/update_generator"
   require_relative "wabi/generators/list_generator"
   require_relative "wabi/generators/registry_generator"
   require_relative "wabi/generators/theme_generator"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: wabi
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Oscar Ortega
@@ -126,6 +126,7 @@ files:
 - lib/wabi/generators/list_generator.rb
 - lib/wabi/generators/registry_generator.rb
 - lib/wabi/generators/theme_generator.rb
+- lib/wabi/generators/update_generator.rb
 - lib/wabi/lockfile.rb
 - lib/wabi/registry_client.rb
 - lib/wabi/turbo_stream_extensions.rb