poetry-ui 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a7e5a4ac13adb19047199d51de9fc0077d10f3b89d74302fc738a10db528dc63
+  data.tar.gz: 2100d959fc3e89a3c189b6b8350ca4a22d41eda259a286fb071b898e88c9b56d
+SHA512:
+  metadata.gz: 8416f0e954b93265431f796ad2f2f42aea2a68c0f912dc7d6d83f224dc30c0c264a0ece1d806e4a0fca567c558e1a592eaa63e445fb8e25c20f98e1ff870c3dc
+  data.tar.gz: a92f9fb002bb8eb856c2f9810d6733a6234fe95e72131d60cd8e173f943210b7a616681626afc0a40c3cd90ecdcd1c4da0791722cc2b09574395780a734bba6c

data/.gitattributes

@@ -0,0 +1,6 @@
+# GitHub language stats (Linguist). The eval results are harness output
+# (generated markup, judge verdicts, captures), and the Hotwire files under
+# the dummy's vendor dir are vendored test assets; neither is this gem's
+# source. Without this the repo reads as HTML instead of Ruby.
+eval/results/** linguist-generated
+test/dummy/public/vendor/** linguist-vendored

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+# Changelog
+
+## [Unreleased]

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Matt Solt
+
+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,87 @@
+# poetry-ui
+
+Server-rendered UI components for Rails — the shadcn/ui component set as
+ViewComponents on Stimulus, with nine complete visual themes, a
+machine-readable component registry, and a full agent surface (llms.txt,
+MCP, Claude Code skills, `poetry check`). Names are working titles; the
+gems are unpublished.
+
+## Install
+
+```ruby
+# Gemfile
+gem "poetry-core"
+gem "poetry-ui"
+gem "poetry-lucide"     # default icon set
+# gem "poetry-charts"   # optional
+```
+
+```bash
+bundle install
+bin/rails g poetry:install --theme default   # or vega, nova, mira, rhea, maia, luma, lyra, sera
+```
+
+The installer wires everything a host needs: the vendored token/theme CSS
+set under `app/assets/tailwind/poetry/`, the Tailwind entry imports, the
+class safelist, Stimulus controller registration, the engine mount
+(llms.txt), an `AGENTS.md` section, and the Claude Code skills. Every step
+is idempotent — file creations skip what exists, injections append only
+missing lines, and the section/skills refresh in place.
+
+Add `--charts` to wire poetry-charts (requires the gem in the bundle).
+
+## Upgrade
+
+**The install generator is the upgrade path, not a one-shot.** After
+bumping the gems, re-run it:
+
+```bash
+bundle update poetry-core poetry-ui poetry-charts
+bin/rails g poetry:install     # your theme choice sticks; --theme switches
+bin/rails tailwindcss:build    # or your CSS build
+bin/rails test                 # confirm the app still renders
+```
+
+The re-run refreshes what only it can refresh: the vendored CSS files
+(new components ship their theme rules there) and the safelist (new
+classes would otherwise be purged), plus any new wiring lines, the
+AGENTS.md section, and the skills. Gem-owned code — components, templates,
+Stimulus controllers, the registry and MCP surface — upgrades with
+`bundle update` alone.
+
+Copied-in code is yours and is never rewritten. To see where your copies
+stand against the gems you now have installed:
+
+```bash
+bin/rails g poetry:diff        # read-only drift report for copy-ins
+bin/rails g poetry:add <name>  # adds newly-shipped files, never overwrites
+```
+
+And `rails g scaffold` itself can produce poetry-composed views — a
+DataTable index with sanitized URL state, Field-composed forms, and a
+matching controller — by installing the app-owned template overrides once:
+
+```bash
+bin/rails g poetry:scaffold_templates
+```
+
+Three ownership tiers, three upgrade behaviors:
+
+| Tier | Examples | Upgrades via |
+|---|---|---|
+| Gem-owned | components, controllers, registry, MCP | `bundle update` |
+| Vendored into the app | `app/assets/tailwind/poetry/*`, safelist | re-run `poetry:install` |
+| App-owned copy-ins | `poetry:add` components, blocks, `base.css`, initializer | you — `poetry:diff` reports |
+
+## Agent surface
+
+`/poetry/llms.txt` and `/poetry/llms-full.txt` (engine routes), the
+`poetry` MCP server (`bundle exec poetry-agent` from the poetry-agent gem, boot-free), `bin/rails
+poetry:check` (template verification — run it last), and the `poetry` /
+`poetry-design` / `poetry-component` Claude Code skills. See the generated
+`AGENTS.md` section in your app.
+
+## License
+
+Available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+See `THIRD_PARTY_NOTICES.md` for adapted code.

data/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,201 @@
+# Third-party notices - poetry-ui
+
+poetry-ui's component surface ports or adapts design and behavior from
+the MIT-licensed projects below. This file is the canonical source
+attribution; the license texts are reproduced here.
+
+## shadcn/ui
+
+- Source: https://github.com/shadcn-ui/ui (MIT)
+- The component vocabulary, markup anatomy, class dictionaries, themes, and the typeset port are derived from shadcn/ui
+
+```
+MIT License
+
+Copyright (c) 2023 shadcn
+
+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.
+```
+
+## Base UI
+
+- Source: https://github.com/mui/base-ui (MIT)
+- Part anatomy and interaction behavior for the primitive-backed components
+
+```
+MIT License
+
+Copyright (c) 2019 Material-UI SAS
+
+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.
+```
+
+## Radix Primitives
+
+- Source: https://github.com/radix-ui/primitives (MIT)
+- Earlier behavior reference for several parts (pre-Base UI alignment)
+
+```
+MIT License
+
+Copyright (c) 2022 WorkOS
+
+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.
+```
+
+## kumo
+
+- Source: https://github.com/cloudflare/kumo (MIT)
+- Adapted: the ClipboardText, SensitiveInput, and CodeBlock components
+
+```
+MIT License Copyright (c) 2026 Cloudflare, Inc.
+
+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
+(including the next paragraph) 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.
+```
+
+## ReUI
+
+- Source: https://github.com/keenthemes/reui (MIT)
+- The Timeline component's anatomy and styling follow ReUI's Timeline
+
+```
+MIT License
+
+Copyright (c) 2025 Keenthemes Inc
+
+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.
+```
+
+## hotwire_club-toolbox
+
+- Source: https://github.com/TheHotwireClub/hotwire_club-toolbox (MIT)
+- Adapted: the OptimisticForm component and form-builder integration
+
+```
+Copyright Julian Rubisch
+
+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.
+```
+
+
+## simple_form
+
+- Source: https://github.com/heartcombo/simple_form (MIT)
+- The FormBuilder's type-inference pipeline (attribute-type mapping, name heuristics on string columns, and the validator-to-control-attribute extractors) adapts conventions and heuristics from simple_form
+
+```
+Copyright (c) 2020-CURRENT Rafael França, Carlos Antonio da Silva
+Copyright (c) 2009-2019 Plataformatec
+
+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.
+```
+
+## Hotwire test assets
+
+- Source: https://github.com/hotwired/turbo (Turbo 8.0.13) and https://github.com/hotwired/stimulus (Stimulus 3.2.2), both MIT (37signals / Basecamp)
+- Vendored: `test/dummy/public/vendor/turbo.es2017-esm.js` and `test/dummy/public/vendor/stimulus.umd.js`, the unmodified dist builds with their license banners; test-only (the stable-id gate and the dommy tier), never shipped in the gem

data/app/components/poetry/ui/accordion/component.html.erb

@@ -0,0 +1,3 @@
+<%= content_tag(:div, **root_attributes.to_attributes) do %>
+  <% items.each do |item| %><%= item %><% end %>
+<% end %>

data/app/components/poetry/ui/accordion/component.rb

@@ -0,0 +1,197 @@
+# frozen_string_literal: true
+
+module Poetry
+  module Ui
+    # Vertically stacked expand/collapse sections.
+    module Accordion
+      # An expand/collapse list of sections keyed by value. type: :single
+      # (the default) keeps one section open at a time; type: :multiple
+      # allows several. Pass open: to server-render the expanded sections.
+      #
+      # Triggers are real buttons inside headings, so every section stays
+      # reachable by Tab; arrow keys also move focus between triggers.
+      # Panels are labelled regions. A single non-collapsible accordion
+      # marks the locked-open trigger disabled to assistive tech.
+      #
+      # @example Single-open accordion with the first item expanded
+      #   render Poetry::Ui::Accordion::Component.new(open: %w[a]) do |accordion|
+      #     accordion.with_item(value: "a", title: "First") { "First panel" }
+      #     accordion.with_item(value: "b", title: "Second") { "Second panel" }
+      #   end
+      class Component < Poetry::Core::Component
+        # The closed vocabulary for the type axis.
+        TYPES = %i[single multiple].freeze
+        # The closed vocabulary for the heading_level axis.
+        HEADINGS = %i[h2 h3 h4 h5 h6].freeze
+
+        # Projected into the registry, llms.txt, and the agent surface.
+        AGENT_RULES = [
+          "Items via with_item(value:, title:) { panel content } - value is the open-state key.",
+          "type: :single (default) opens one at a time; pass collapsible: true to allow closing it.",
+          "Server-render the open item(s) via open: %w[value] - never toggle data-open/data-closed by hand.",
+          "heading_level: fits the page outline (h3 default) - the trigger button lives inside it.",
+          "The chevron is built in - never add another indicator icon to the trigger.",
+          "disabled: true on with_item locks that item (native disabled on the trigger; roving focus skips it)."
+        ].freeze
+
+        # Slots the component cannot render without; static checks read this without rendering.
+        REQUIRED_SLOTS = { item: "at least one item" }.freeze
+
+        renders_many :items,
+                     doc: "The accordion sections. Each takes value: (its open-state key), title:, and a block of " \
+                          "panel content; disabled: true locks the section closed.",
+                     renders: lambda { |value:, title:, disabled: false, **options, &block|
+                       open_item = open_values.include?(value.to_s)
+                       item_id = "#{instance_id}-#{value}"
+                       item_attrs = { class: css(:item, class: options.delete(:class)),
+                                      "data-slot" => "accordion-item", "data-value" => value,
+                                      (open_item ? "data-open" : "data-closed") => "", **options }
+                       item_attrs["data-disabled"] = "" if disabled
+                       content_tag(:div, **item_attrs) do
+                         safe_join([accordion_header(item_id, title, open_item, disabled: disabled),
+                                    accordion_panel(item_id, open_item, &block)])
+                       end
+                     }
+
+        use_stimulus do
+          on :root do
+            controller :accordion do
+              register
+              value :type
+              value :collapsible
+            end
+            controller :roving_focus do
+              register
+              value :orientation, "vertical"
+              value :manage_tabindex, false
+              action :keydown, on: :keydown
+            end
+          end
+          on :trigger do
+            controller(:accordion) { action :toggle, on: :click }
+          end
+        end
+
+        option :type, :symbol, default: :single,
+                               doc: "Whether one section (:single) or several (:multiple) may be open at once."
+        option :collapsible, :boolean, default: false,
+                                       doc: "With type: :single, allows the open section to be closed again."
+        option :open, :list, default: -> { [] }, doc: "Value keys of the sections rendered expanded on load."
+        option :heading_level, :symbol, default: :h3,
+                                        doc: "The heading element wrapping each trigger; pick it to fit the page " \
+                                             "outline."
+
+        validates :type, inclusion: { in: TYPES }
+        validates :heading_level, inclusion: { in: HEADINGS }
+
+        part "accordion", "The list root - both controllers (the open-set machine and roving " \
+                          "focus) ride here",
+             states: {
+               "data-orientation" => { condition: "always vertical - the only axis the accordion ships",
+                                       values: %w[vertical] }
+             }
+        part "accordion-item", "One value-keyed section wrapping its header and panel",
+             states: {
+               "data-open" => "the item is expanded (server-rendered from open:; the controller " \
+                              "flips the pair at runtime)",
+               "data-closed" => "the item is collapsed",
+               "data-value" => "the item's open-state key (always present)",
+               "data-disabled" => "with_item(disabled: true) - the item is locked (styling hook; " \
+                                  "the trigger carries the native disabled attribute)"
+             }
+        part "accordion-header", "The heading element (heading_level:, h3 default) hosting the trigger button"
+        part "accordion-trigger", "The toggle button inside the header - the chevron rotation rides " \
+                                  "aria-expanded, not a data attribute",
+             states: {
+               "data-panel-open" => "its panel is open (controller-written; " \
+                                    "absent while closed)",
+               "data-disabled" => "with_item(disabled: true) - stamped beside the native disabled " \
+                                  "attribute; roving focus filters it out at query time"
+             }
+        part "accordion-trigger-icon", "The chevron svg inside the trigger (aria-hidden) - rotates with the item"
+        part "accordion-content", "The role=region panel - the presence animation and the measured " \
+                                  "height var ride here",
+             states: {
+               "data-open" => "panel is open or entering",
+               "data-closed" => "panel is closed or animating out (hidden lands after the exit finishes)"
+             },
+             vars: {
+               "--accordion-panel-height" => "the measured content height (controller-written) that " \
+                                             "feeds the accordion-down/up keyframes"
+             }
+
+        # Enforces the required item slot.
+        # @api private
+        def before_render
+          raise ArgumentError, "Accordion requires at least one with_item" unless items?
+        end
+
+        # The open: values normalized to strings.
+        # @api private
+        def open_values
+          Array(open).map(&:to_s)
+        end
+
+        # @api private
+        def root_attributes
+          html_attributes.merge_if_not_set(
+            { "data-slot" => "accordion", "data-orientation" => "vertical" }
+              .merge(stimulus_attributes_for(:root))
+              .merge(component_data_attributes)
+          )
+        end
+
+        private
+
+        def instance_id
+          @instance_id ||= poetry_instance_id("poetry-accordion")
+        end
+
+        def accordion_header(item_id, title, open_item, disabled: false)
+          trigger_attrs = {
+            type: "button", id: "#{item_id}-trigger", class: css(:trigger),
+            # No state attribute on the trigger: the controller reflects only
+            # aria-expanded here (the open/closed pair lives on the item and
+            # panel) - aria-expanded IS the trigger's styling hook.
+            "data-slot" => "accordion-trigger",
+            "data-poetry-collection-item" => "",
+            "aria-expanded" => open_item.to_s, "aria-controls" => "#{item_id}-panel"
+          }.merge(stimulus_attributes_for(:trigger))
+          trigger_attrs["aria-disabled"] = "true" if open_item && type == :single && !collapsible
+          # Native disabled owns interaction and focus; data-disabled is the
+          # roving-focus query filter (a natively disabled button already
+          # drops from the tab order on its own).
+          if disabled
+            trigger_attrs[:disabled] = true
+            trigger_attrs["data-disabled"] = ""
+          end
+
+          content_tag(heading_level, class: css(:header), "data-slot" => "accordion-header") do
+            content_tag(:button, trigger_attrs) do
+              safe_join([title, chevron])
+            end
+          end
+        end
+
+        def accordion_panel(item_id, open_item, &)
+          attrs = {
+            id: "#{item_id}-panel", role: "region", class: css(:content),
+            "data-slot" => "accordion-content", (open_item ? "data-open" : "data-closed") => "",
+            "aria-labelledby" => "#{item_id}-trigger"
+          }
+          attrs[:hidden] = true unless open_item
+          content_tag(:div, attrs) do
+            content_tag(:div, capture(&), class: css(:inner))
+          end
+        end
+
+        def chevron
+          render(Icon::Component.new(name: :"chevron-down", class: css(:indicator),
+                                     data: { slot: "accordion-trigger-icon" }))
+        end
+
+        private :open_values, :root_attributes
+      end
+    end
+  end
+end

data/app/components/poetry/ui/accordion/preview.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Poetry
+  module Ui
+    module Accordion
+      # The Accordion preview matrix.
+      class Preview < Poetry::Core::Preview::Base
+        def default
+          render_component(open: %w[shipping]) do |accordion|
+            accordion.with_item(value: "shipping", title: "Shipping") { "Free over $50, worldwide." }
+            accordion.with_item(value: "returns", title: "Returns") { "30 days, no questions." }
+            accordion.with_item(value: "warranty", title: "Warranty") { "Two years, parts and labor." }
+          end
+        end
+
+        def multiple
+          render_component(type: :multiple, open: %w[a b]) do |accordion|
+            accordion.with_item(value: "a", title: "First") { "Open together" }
+            accordion.with_item(value: "b", title: "Second") { "with the first." }
+          end
+        end
+
+        def single_collapsible
+          render_component(collapsible: true, open: %w[only]) do |accordion|
+            accordion.with_item(value: "only", title: "Toggle me") { "I can close." }
+          end
+        end
+
+        def disabled
+          render_component(collapsible: true) do |accordion|
+            accordion.with_item(value: "history", title: "Account history") { "All transactions and plan changes." }
+            accordion.with_item(value: "premium", title: "Premium features", disabled: true) { "Upgrade to access." }
+            accordion.with_item(value: "email", title: "Update email") { "Change it in account settings." }
+          end
+        end
+      end
+    end
+  end
+end

data/app/components/poetry/ui/accordion/style.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Poetry
+  module Ui
+    module Accordion
+      # Re-expressed through the cn-* theme layer. The panel
+      # animation classes ride the theme (the vendored accordion-down/up
+      # keyframes still fed by --accordion-panel-height); the chevron's
+      # aria-expanded rotation + motion stay inline (state mechanism).
+      class Style < Poetry::Core::Style
+        # Root hook: several themes (mira, rhea, luma, maia) style the
+        # root as a box - the name must compile in EVERY theme, so each
+        # fragment carries a rule (default: w-full).
+        base "cn-accordion flex flex-col w-full"
+
+        element :item, "cn-accordion-item"
+
+        element :header, "flex"
+
+        # The chevron flips on aria-expanded, not a data attribute: the
+        # controller reflects only aria-expanded on the trigger (the
+        # data-open/data-closed pair lives on the item and panel).
+        element :trigger, "cn-accordion-trigger flex flex-1 items-start justify-between transition-all " \
+                          "outline-none disabled:pointer-events-none disabled:opacity-50 " \
+                          "[&[aria-expanded=true]>svg]:rotate-180 border border-transparent " \
+                          "group/accordion-trigger relative"
+
+        element :indicator, "cn-accordion-trigger-icon pointer-events-none shrink-0 " \
+                            "transition-transform duration-200"
+
+        element :content, "cn-accordion-content overflow-hidden"
+
+        element :inner, "cn-accordion-content-inner"
+      end
+    end
+  end
+end

data/app/components/poetry/ui/alert/component.html.erb

@@ -0,0 +1,6 @@
+<%= content_tag(:div, **root_attributes.to_attributes) do %>
+  <%= icon %>
+  <% if title? %><div data-slot="alert-title" class="<%= css(:title) %>"><%= title %></div><% end %>
+  <div data-slot="alert-description" class="<%= css(:description) %>"><%= content %></div>
+  <% if action? %><div data-slot="alert-action" class="<%= css(:action) %>"><%= action %></div><% end %>
+<% end %>