layered-ui-rails 0.20.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f93bf15a80c67a460c8eada9407beb94507d3dce7fe511e935355abcd329a4d8
-  data.tar.gz: 06d49cc35c54fa21fddb6ced245abfa9ad4783003a03074beb9467e03f46cbb1
+  metadata.gz: 9ced93c0df2346914e675fcdf3dd10657a079d3dcc046271dfb6bb24e6ff2c8c
+  data.tar.gz: 5e64064b0fdb591d0621118350bf5c1b181c88de7799a02a9b7f2e7e628f5ad0
 SHA512:
-  metadata.gz: f4435d521aa96f5e74b0d1183ae5d486b795d28eb6d6dc16728b8147599715a5e49b64c0a226a78b5aed479c6586dd73f02962321d2e976e693453f79d022fe6
-  data.tar.gz: 21030bae58aefc605b07370d6dcc615a1f1441566a72b28859068151109d41005b1fc333234878293a4c02d424d5896f9b3230886f1efcfc071ce3cbb493a7d4
+  metadata.gz: 9408f35f4b9b2d2a57d0227ec06cbf55a8f8c9ac692d97e1a0a6e9765f0b369bf9732aea5d8742b4c454c1cc555e258303abb2e57f878c352db18b5416fb454b
+  data.tar.gz: e24b88f24d9f70192bdfa75166f287da9bb01165c6af436b25efc812e7d83e1c5df2cd915896a75aa5c26a4c699c2fbcd3ac6661a0f8f0888d94d8366daac241

data/.claude/skills/layered-ui-rails/SKILL.md

@@ -182,6 +182,7 @@ Quick reference:
 | `l_ui_authentication` | Default header login/register buttons (Devise) |
 | `l_ui_navigation_toggle` | Default header sidebar toggle button |
 | `l_ui_popover(id: nil, placement: :bottom, align: :start, container: {})` | Floating panel anchored to a trigger, built on the native `popover` attribute |
+| `l_ui_tag(rounded: false, container: {})` | Interactive tag built from segments (`t.text`, `t.button`, `t.link`, `t.remove`) with an optional attached popover (`t.popover`); `rounded: true` for a pill shape |
 
 ## CSS classes
 
@@ -200,6 +201,7 @@ Key components:
 | Forms | `.l-ui-form`, `.l-ui-form__group`, `.l-ui-form__field`, `.l-ui-label`, `.l-ui-select` |
 | Tables | `.l-ui-table`, `.l-ui-table__header`, `.l-ui-table__cell`, `--primary`, `--action`, `.l-ui-table__action`, `--danger` |
 | Badges | `.l-ui-badge`, `--rounded`, `--default`, `--success`, `--warning`, `--danger` |
+| Tags | `.l-ui-tag`, `--rounded`, `__text`, `__button`, `__remove` |
 | Notices | `.l-ui-notice` (base), `--success`, `--warning`, `--error` |
 | Tabs | `.l-ui-tabs`, `.l-ui-tabs__list`, `.l-ui-tabs__tab`, `--active` |
 | Modal | `.l-ui-modal`, `.l-ui-modal__header`, `.l-ui-modal__body` |

data/.claude/skills/layered-ui-rails/references/CSS.md

@@ -269,6 +269,20 @@ Always combine the base block with one variant modifier (e.g. `class="l-ui-notic
 
 Always combine the base block with a modifier, e.g. `<span class="l-ui-badge l-ui-badge--success">`.
 
+## Tags
+
+Interactive tag - e.g. an email recipient or an active filter. A badge is a static styled span; a tag is a container with separately interactive segments.
+
+```
+.l-ui-tag           Tag container (div); carries colour and shape but no padding - segments supply it
+.l-ui-tag--rounded  Pill shape (matching l-ui-badge--rounded); default is the subtle badge radius
+.l-ui-tag__text     Static label segment (span)
+.l-ui-tag__button   Interactive label segment (button or a); focus ring + pointer
+.l-ui-tag__remove   Trailing remove segment (button or a) holding a ✕ icon (e.g. l-ui-icon--xs); needs an aria-label
+```
+
+A tag takes the same subtle corner radius as a badge by default; add `l-ui-tag--rounded` for a pill. Segments must be direct children in label-then-remove order; when a remove segment follows, the label segment automatically drops its right padding so the remove owns the gap and every part of the tag stays clickable. Prefer the `l_ui_tag` helper (see HELPERS.md), which also wires an optional popover.
+
 ## Tabs
 
 ```

data/.claude/skills/layered-ui-rails/references/HELPERS.md

@@ -367,6 +367,41 @@ For a list of actions (e.g. a "more" menu on a table row), wrap the items in a `
     }) %>
 ```
 
+## Tag
+
+```ruby
+l_ui_tag(rounded: false, container: {}, &block)
+```
+
+Renders an interactive tag (`class="l-ui-tag"`) - e.g. an email recipient or an active filter. Visually related to `l-ui-badge` but a distinct control: a badge is a static styled span, while a tag is a container whose segments (label, remove) are separately interactive.
+
+- `rounded` (Boolean, optional) - pill shape (matching `l-ui-badge--rounded`); defaults to `false` for the subtle badge radius
+- `container` (Hash, optional) - extra HTML attributes for the wrapping `<div>` (e.g. `class:`)
+- `&block` - declare segments on the builder; they render in call order. Use `<%` (not `<%=`) - segment content is captured by the builder
+
+Builder methods:
+
+- `t.text(content = nil, **opts, &block)` - static label segment (`<span class="l-ui-tag__text">`)
+- `t.button(**opts, &block)` - button segment (`<button class="l-ui-tag__button">`); opens the tag's popover when one is declared
+- `t.link(url, **opts, &block)` - link segment, styled like a button segment
+- `t.remove(url = nil, **opts, &block)` - trailing remove segment (`l-ui-tag__remove`): a link when `url` is given, otherwise a button. Renders a ✕ icon unless the block supplies custom content. Pass `aria: { label: ... }` so it has an accessible name
+- `t.popover(id: nil, placement: :bottom, align: :start, &block)` - attaches a popover; the block is the popover body. Options match `l_ui_popover`
+
+```erb
+<%= l_ui_tag do |t| %>
+  <% t.button(aria: { label: "Edit status filter" }) do %>
+    Status: Active
+  <% end %>
+  <% t.remove remove_filter_path, aria: { label: "Remove status filter" },
+       data: { turbo_frame: "results" } %>
+  <% t.popover do %>
+    <p>Filter controls.</p>
+  <% end %>
+<% end %>
+```
+
+When a popover is declared, the tag container itself becomes the `l-ui--popover` controller root and placement target - the popover aligns with the whole tag rather than the label button inside it - and button segments are wired to open it via `popovertarget`. A tag without a popover renders no Stimulus wiring.
+
 ## Header
 
 ```ruby

data/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file. This project follows [Semantic Versioning](https://semver.org/).
 
+## [0.21.0] - 2026-07-09
+
+### Added
+
+- Tags: interactive tags (`l-ui-tag`), such as email recipients or active filters. Visually related to badges but a distinct control: a badge is a static styled span, while a tag is a container whose segments - `l-ui-tag__text` (static label), `l-ui-tag__button` (button or link label), and `l-ui-tag__remove` (trailing ✕ link or button) - are separately interactive, each carrying its share of the tag's padding so every part is a hit target. Takes the same subtle corner radius as a badge by default, with `l-ui-tag--rounded` for a pill shape (matching `l-ui-badge--rounded`). The `l_ui_tag` helper builds the tag from builder calls (`t.text`, `t.button`, `t.link`, `t.remove`, `t.popover`) and takes a `rounded:` option; declaring `t.popover` makes the whole tag the popover's placement target and wires button segments to open it via `popovertarget`. The default `t.remove` control is a filled x-circle.
+- `icon_close_circle.svg` (a filled circle with a cross knocked out) added to the bundled icon set, used by the tag remove control and available as a general-purpose icon.
+
 ## [0.20.0] - 2026-07-08
 
 ### Added

data/README.md

@@ -36,7 +36,7 @@ An open source, Rails 8+ engine that provides WCAG 2.2 AA compliant design token
 - **Dark/light theme** - system preference detection with localStorage persistence and manual toggle
 - **Responsive layout** - header, sidebar navigation, main content area, and optional resizable panel
 - **WCAG 2.2 AA compliant** - skip links, focus indicators, ARIA attributes, and 4.5:1 contrast ratios
-- **Components** - buttons, forms, surfaces, tables, tabs, notices, badges, conversations, modals, popovers, and pagination
+- **Components** - buttons, forms, surfaces, tables, tabs, notices, badges, tags, conversations, modals, popovers, and pagination
 - **Optional integrations** - Devise authentication and Pagy pagination with styled views
 - **Customisable branding** - Override the default logos and icons and colors
 - **Google Lighthouse** - `layered-ui-rails` scores a [perfect 100](https://github.com/layered-ai-public/layered-ui-rails/raw/refs/heads/main/test/dummy/app/assets/images/lighthouse.webp) across all four Google Lighthouse categories - performance, accessibility, best practices, and SEO

data/app/assets/images/layered_ui/icon_close_circle.svg

@@ -0,0 +1,3 @@
+<svg fill="currentColor" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
+  <path fill-rule="evenodd" clip-rule="evenodd" d="M12 2.25c-5.385 0-9.75 4.365-9.75 9.75s4.365 9.75 9.75 9.75 9.75-4.365 9.75-9.75S17.385 2.25 12 2.25Zm-1.72 6.97a.75.75 0 0 0-1.06 1.06L10.94 12l-1.72 1.72a.75.75 0 1 0 1.06 1.06L12 13.06l1.72 1.72a.75.75 0 1 0 1.06-1.06L13.06 12l1.72-1.72a.75.75 0 1 0-1.06-1.06L12 10.94l-1.72-1.72Z" />
+</svg>

data/app/assets/tailwind/layered_ui/engine.css

@@ -1855,6 +1855,62 @@ pre.l-ui-surface {
          bg-error-bg;
 }
 
+/* Tags */
+
+/* An interactive tag - e.g. an email recipient or an active filter. Related
+   to the badge visually, but a distinct control: a badge is a static styled
+   span, while a tag is a container with interactive segments. The container
+   carries no padding of its own - each segment supplies its share, so every
+   part of the tag is a hit target. */
+
+.l-ui-tag {
+  @apply inline-flex items-stretch
+         min-h-[32px]
+         text-xs font-medium
+         text-foreground-muted
+         bg-surface-highlighted
+         rounded;
+}
+
+/* Pill shape, matching l-ui-badge--rounded. */
+.l-ui-tag--rounded {
+  @apply !rounded-full;
+}
+
+.l-ui-tag__text {
+  @apply flex items-center
+         gap-1 px-3;
+}
+
+.l-ui-tag__button {
+  @apply flex items-center
+         gap-1 px-3
+         rounded
+         focus-ring
+         cursor-pointer;
+}
+
+/* Segment focus rings follow the tag's shape. */
+.l-ui-tag--rounded .l-ui-tag__button,
+.l-ui-tag--rounded .l-ui-tag__remove {
+  @apply !rounded-full;
+}
+
+/* When a remove segment follows, it owns the gap between the label and the
+   ✕ (its left padding), so the label segment gives up its right padding. */
+.l-ui-tag__text:has(+ .l-ui-tag__remove),
+.l-ui-tag__button:has(+ .l-ui-tag__remove) {
+  @apply pr-0;
+}
+
+.l-ui-tag__remove {
+  @apply flex items-center
+         pl-1.5 pr-2
+         rounded
+         focus-ring
+         cursor-pointer;
+}
+
 /* Panel */
 
 .l-ui-panel__button {

data/app/helpers/layered/ui/tag_helper.rb

@@ -0,0 +1,171 @@
+module Layered
+  module Ui
+    module TagHelper
+      # Renders an interactive tag - e.g. an email recipient or an active
+      # filter. Visually related to +l-ui-badge+, but a distinct control: a
+      # badge is a static styled span, while a tag is a container whose
+      # segments (label, remove) are separately interactive.
+      #
+      #   <%= l_ui_tag do |t| %>
+      #     <% t.text "alice@example.com" %>
+      #     <% t.remove aria: { label: "Remove alice@example.com" } %>
+      #   <% end %>
+      #
+      # A tag may carry a popover. The whole tag becomes the placement target
+      # (so the popover aligns with the tag rather than the segment inside
+      # it), and button segments open it via +popovertarget+:
+      #
+      #   <%= l_ui_tag do |t| %>
+      #     <% t.button(aria: { label: "Edit status filter" }) do %>
+      #       Status: Active
+      #     <% end %>
+      #     <% t.remove remove_filter_path, aria: { label: "Remove status filter" } %>
+      #     <% t.popover do %>
+      #       <p>Filter controls.</p>
+      #     <% end %>
+      #   <% end %>
+      #
+      # Note: use +<% t.button %>+ (without the equals sign) so segment content
+      # is captured by the builder rather than written to the body buffer.
+      #
+      # Segments render in the order they are declared; the popover element is
+      # always appended last. Give icon-only segments (such as +t.remove+) an
+      # +aria-label+ so they have an accessible name.
+      #
+      # Options:
+      #   rounded:   (Boolean) Pill shape (matching +l-ui-badge--rounded+); defaults to false for the subtle badge shape.
+      #   container: (Hash)    Extra HTML attributes for the wrapping <div>.
+      #
+      # Builder methods:
+      #   t.text(content = nil, **options, &block)  Static label segment (<span>).
+      #   t.button(**options, &block)               Button segment; opens the tag's popover when one is declared.
+      #   t.link(url, **options, &block)            Link segment, styled like a button segment.
+      #   t.remove(url = nil, **options, &block)    Trailing remove segment: a link when +url+ is given, otherwise a
+      #                                             button. Renders a ✕ icon unless the block supplies custom content.
+      #   t.popover(id: nil, placement: :bottom, align: :start, &block)
+      #                                             Attaches a popover to the tag; the block is the popover body.
+      #                                             Options match +l_ui_popover+.
+      def l_ui_tag(rounded: false, container: {}, &block)
+        builder = TagBuilder.new(self)
+        capture { block.call(builder) }
+
+        container_attrs = container.deep_dup
+        container_attrs[:class] = class_names("l-ui-tag", ("l-ui-tag--rounded" if rounded), container_attrs[:class])
+
+        if builder.popover?
+          container_data = container_attrs[:data] || {}
+          existing_controller = container_data.delete(:controller) || container_data.delete("controller")
+          container_data[:controller] = [existing_controller, "l-ui--popover"].compact.reject(&:empty?).join(" ")
+          container_data[:"l-ui--popover-target"] = "trigger"
+          container_data[:"l-ui--popover-placement-value"] = builder.popover_placement
+          container_data[:"l-ui--popover-align-value"] = builder.popover_align
+          container_attrs[:data] = container_data
+        end
+
+        tag.div(**container_attrs) do
+          parts = builder.segments.map { |segment| l_ui_tag_segment(builder, segment) }
+          parts << l_ui_tag_popover(builder) if builder.popover?
+          safe_join(parts)
+        end
+      end
+
+      class TagBuilder
+        attr_reader :segments, :popover_id, :popover_placement, :popover_align, :popover_body
+
+        def initialize(view)
+          @view = view
+          @segments = []
+        end
+
+        def text(content = nil, **options, &block)
+          content = @view.capture(&block) if block
+          @segments << { kind: :text, content: content, options: options }
+          nil
+        end
+
+        def button(**options, &block)
+          content = block ? @view.capture(&block) : nil
+          @segments << { kind: :button, content: content, options: options }
+          nil
+        end
+
+        def link(url, **options, &block)
+          content = block ? @view.capture(&block) : nil
+          @segments << { kind: :link, url: url, content: content, options: options }
+          nil
+        end
+
+        def remove(url = nil, **options, &block)
+          content = block ? @view.capture(&block) : nil
+          @segments << { kind: :remove, url: url, content: content, options: options }
+          nil
+        end
+
+        def popover(id: nil, placement: :bottom, align: :start, &block)
+          @popover_id = id || "l-ui-tag-popover-#{SecureRandom.hex(4)}"
+          @popover_placement = placement
+          @popover_align = align
+          @popover_body = @view.capture(&block)
+          nil
+        end
+
+        def popover?
+          !@popover_id.nil?
+        end
+      end
+
+      private
+
+      def l_ui_tag_segment(builder, segment)
+        options = segment[:options].deep_dup
+
+        case segment[:kind]
+        when :text
+          options[:class] = class_names("l-ui-tag__text", options[:class])
+          tag.span(segment[:content], **options)
+        when :button
+          options[:class] = class_names("l-ui-tag__button", options[:class])
+          options[:type] ||= "button"
+          options[:popovertarget] ||= builder.popover_id if builder.popover?
+          tag.button(segment[:content], **options)
+        when :link
+          options[:class] = class_names("l-ui-tag__button", options[:class])
+          link_to(segment[:content], segment[:url], options)
+        when :remove
+          options[:class] = class_names("l-ui-tag__remove", options[:class])
+          content = segment[:content] || l_ui_tag_remove_icon
+          if segment[:url]
+            link_to(content, segment[:url], options)
+          else
+            options[:type] ||= "button"
+            tag.button(content, **options)
+          end
+        end
+      end
+
+      # Filled x-circle, matching the bundled +icon_close_circle.svg+ asset.
+      # Rendered inline (rather than via image_tag) so it inherits the tag's
+      # muted +currentColor+; an <img>-loaded SVG cannot.
+      def l_ui_tag_remove_icon
+        tag.svg(
+          tag.path("fill-rule" => "evenodd", "clip-rule" => "evenodd",
+            "d" => "M12 2.25c-5.385 0-9.75 4.365-9.75 9.75s4.365 9.75 9.75 9.75 9.75-4.365 9.75-9.75S17.385 2.25 12 2.25Zm-1.72 6.97a.75.75 0 0 0-1.06 1.06L10.94 12l-1.72 1.72a.75.75 0 1 0 1.06 1.06L12 13.06l1.72 1.72a.75.75 0 1 0 1.06-1.06L13.06 12l1.72-1.72a.75.75 0 1 0-1.06-1.06L12 10.94l-1.72-1.72Z"),
+          class: "l-ui-icon--sm",
+          fill: "currentColor",
+          "viewBox" => "0 0 24 24",
+          "aria-hidden" => "true"
+        )
+      end
+
+      def l_ui_tag_popover(builder)
+        tag.div(
+          builder.popover_body,
+          id: builder.popover_id,
+          popover: "auto",
+          class: "l-ui-popover",
+          data: { "l-ui--popover-target" => "popover" }
+        )
+      end
+    end
+  end
+end

data/lib/layered/ui/engine.rb

@@ -38,6 +38,7 @@ module Layered
           helper Layered::Ui::ModalHelper
           helper Layered::Ui::PopoverHelper
           helper Layered::Ui::RansackHelper
+          helper Layered::Ui::TagHelper
         end
       end
 

data/lib/layered/ui/version.rb

@@ -1,5 +1,5 @@
 module Layered
   module Ui
-    VERSION = "0.20.0"
+    VERSION = "0.21.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: layered-ui-rails
 version: !ruby/object:Gem::Version
-  version: 0.20.0
+  version: 0.21.0
 platform: ruby
 authors:
 - layered.ai
@@ -193,6 +193,7 @@ files:
 - app/assets/images/layered_ui/icon_chevron_down.svg
 - app/assets/images/layered_ui/icon_chevron_right.svg
 - app/assets/images/layered_ui/icon_close.svg
+- app/assets/images/layered_ui/icon_close_circle.svg
 - app/assets/images/layered_ui/icon_dark.svg
 - app/assets/images/layered_ui/icon_discord.svg
 - app/assets/images/layered_ui/icon_github.svg
@@ -224,6 +225,7 @@ files:
 - app/helpers/layered/ui/popover_helper.rb
 - app/helpers/layered/ui/ransack_helper.rb
 - app/helpers/layered/ui/table_helper.rb
+- app/helpers/layered/ui/tag_helper.rb
 - app/helpers/layered/ui/title_bar_helper.rb
 - app/javascript/layered_ui/controllers/l_ui/modal_controller.js
 - app/javascript/layered_ui/controllers/l_ui/navigation_controller.js