active_admin_prism 0.1.2 → 0.1.4

data/lib/active_admin/views/action_items.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module ActiveAdmin
+  module Views
+    # Reopens ActiveAdmin::Views::ActionItems purely to mark the
+    # auto-registered "New <Resource>" action item with its own class —
+    # ActiveAdmin::Resource::ActionItems#add_default_new_action_item names
+    # it :new internally, but that name never reaches the rendered
+    # `span.action_item` itself (ActionItem#html_class only ever emits
+    # "action_item" plus a host's own optional :class, nothing derived
+    # from the name), so there'd otherwise be no way for CSS/JS to tell it
+    # apart from any other action_item at all.
+    #
+    # js-src/prism.js's consolidated-action-items dropdown reads this to
+    # always exclude the New-resource button from consolidation, leaving
+    # it inline in its original spot — it's the single most-used action on
+    # an index page, unlike the bulk-action/CSV-upload links this feature
+    # was actually built to tidy away, so sweeping it into a dropdown too
+    # would bury the one button visitors reach for constantly.
+    class ActionItems
+      def build(action_items)
+        action_items.each do |action_item|
+          classes = [action_item.html_class]
+          classes << "prism-action-item-new" if action_item.name == :new
+          span class: classes.join(" ") do
+            instance_exec(&action_item.block)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/active_admin/views/active_filters_bar.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+module ActiveAdmin
+  module Filters
+    # ActiveAdmin core auto-registers this sidebar section on every resource
+    # (see active_admin/filters/resource_extension.rb#add_search_status_sidebar_section)
+    # to summarize the current scope + active filters inside #sidebar,
+    # alongside the Filters form. Skip it entirely when
+    # ActiveAdminPrism.configuration.active_filters_bar is on — see
+    # active_filters_bar.rb's Pages::Index override, which renders the same
+    # content next to Batch Actions instead.
+    class ActiveSidebar
+      def sidebar_options
+        {
+          only: :index,
+          if: -> {
+            active_admin_config.current_filters_enabled? &&
+              (params[:q] || params[:scope]) &&
+              !ActiveAdminPrism.configuration.active_filters_bar
+          }
+        }
+      end
+    end
+  end
+
+  module Views
+    module Pages
+      # Relocates the "Search status" summary (current scope + active
+      # filters — AA core's ActiveAdmin::Filters::ActiveSidebar, reopened
+      # above to skip its normal #sidebar rendering when this is on) into
+      # the same row as the Batch Actions button/scopes tabs (AA core's own
+      # ".table_tools", rendered by Pages::Index#build_table_tools) instead
+      # of ActiveAdmin's own #sidebar.
+      #
+      # Why not #sidebar: ActiveAdminPrism.configuration.collapsible_filters
+      # squeezes the *entire* #sidebar column down to a 72px icon gutter
+      # while the Filters form is collapsed (scss-src/_panels.scss) — every
+      # child of #sidebar shrinks with it, this section included. Its
+      # content (one "field contains value" sentence per active filter) has
+      # nowhere to fit in 72px and overflows out over the table instead of
+      # shrinking cleanly.
+      #
+      # ActiveAdminPrism::Configuration#active_filters_bar controls this —
+      # false restores ActiveAdmin's stock behavior (rendered inside
+      # #sidebar, squeezed along with it when collapsible_filters is on).
+      class Index
+        # AA core's own #build_table_tools (active_admin/views/pages/index.rb)
+        # only renders ".table_tools" at all `if any_table_tools?` (batch
+        # actions, scopes, or multiple index presenters) — grouping the
+        # controls it does render into their own ".table_tools_actions" wrapper
+        # (a new element, not AA's) is what lets scss-src/_panels.scss push
+        # this bar to the opposite end of the same flex row via
+        # `justify-content: space-between` regardless of whether that group
+        # is present at all, rather than only ever being able to sit beside
+        # it when it happens to exist.
+        def build_table_tools
+          show_bar = active_filters_bar?
+          return unless any_table_tools? || show_bar
+
+          div class: "table_tools" do
+            if any_table_tools?
+              div class: "table_tools_actions" do
+                build_batch_actions_selector
+                build_scopes
+                build_index_list
+              end
+            end
+            build_active_filters_bar if show_bar
+          end
+        end
+
+        def active_filters_bar?
+          return false unless ActiveAdminPrism.configuration.active_filters_bar
+          return false unless active_admin_config
+          # active_admin_config should always be an ActiveAdmin::Resource here
+          # (only a Resource's :index action ever reaches Pages::Index), but
+          # #current_filters_enabled? is defined via Filters::ResourceExtension
+          # rather than on ActiveAdmin::Config itself — guard rather than
+          # assume, the same defensive style as the rest of this gem.
+          return false unless active_admin_config.respond_to?(:current_filters_enabled?)
+          return false unless active_admin_config.current_filters_enabled?
+
+          (params[:q] || params[:scope]).present?
+        end
+
+        def build_active_filters_bar
+          div id: "prism_active_filters_bar", class: "prism-active-filters-bar" do
+            active_filters_sidebar_content
+          end
+        end
+      end
+    end
+  end
+end

data/lib/active_admin/views/filters_sidebar.rb

@@ -3,22 +3,36 @@
 module ActiveAdmin
   module Views
     # Reopens ActiveAdmin::Views::SidebarSection (used for every sidebar
-    # section, e.g. "Filters", "Search Status", any custom
-    # `sidebar :title do ... end` block) to inject a real inline SVG icon
-    # into the title of the *Filters* section specifically — matching the
-    # id ActiveAdmin::SidebarSection#id computes for it
-    # ("filters_sidebar_section"). Every other sidebar section is untouched.
+    # section — "Filters", "Search Status", and any custom
+    # `sidebar "Title" do ... end` block a host app registers) to collapse
+    # *every* section to a single icon button by default, expanding to the
+    # full panel on click — not just the Filters section, which is all this
+    # used to do.
     #
-    # The label text is wrapped in its own span so CSS can visually hide it
-    # while collapsed without touching the icon (see
-    # scss-src/_panels.scss's #filters_sidebar_section rules, and
-    # prism.js's filters-collapse handler for the actual toggle).
+    # Why generalize this: the #sidebar column's own width only shrinks to
+    # a 72px icon gutter while every one of its sections is collapsed (see
+    # scss-src/_panels.scss's ":has(.prism-collapsible-panel):not(:has(...open))"
+    # rule) — a section left OUT of that treatment still renders at its
+    # normal full width/height inside that shrunk 72px column, wrapping
+    # every word onto its own line (or, depending on its own CSS, spilling
+    # out unclipped over the main content) instead of collapsing cleanly
+    # alongside Filters. A host's own custom sidebar block (e.g. a "More
+    # Actions" link list) hit exactly this before this file generalized
+    # the treatment to cover it too.
+    #
+    # A host can pass its own icon via `sidebar "Title", icon: :list do
+    # ... end` (any name from lib/prism_icons.rb) — anything else, plus
+    # every section that predates this option, falls back to a generic
+    # icon (:filter for the Filters section specifically, matching its
+    # pre-existing look; :list for everything else).
     #
     # This only runs when ActiveAdminPrism.configuration.collapsible_filters
-    # is true — when it's false the section is left exactly as ActiveAdmin
-    # renders it by default (plain text title, no icon).
+    # is true — when it's false, every section is left exactly as
+    # ActiveAdmin renders it by default (plain text title, no icon, never
+    # collapsed).
     class SidebarSection < Panel
       FILTERS_SECTION_ID = "filters_sidebar_section"
+      DEFAULT_ICON = :list
 
       def build(section)
         @section = section
@@ -26,7 +40,7 @@ module ActiveAdmin
         add_class @section.custom_class if @section.custom_class
         self.id = @section.id
 
-        if @section.id == FILTERS_SECTION_ID && ActiveAdminPrism.configuration.collapsible_filters
+        if ActiveAdminPrism.configuration.collapsible_filters
           add_class "prism-collapsible-panel"
 
           # Panel#build already appended the plain-text @title (h3) as the
@@ -48,7 +62,7 @@ module ActiveAdmin
           # be explicitly deleted from wherever it landed before unshifting
           # it to the front — otherwise it ends up in `children` twice.
           children.delete(@title)
-          icon = ActiveAdminPrism::Icons.svg(:filter, css_class: "prism-filter-icon")
+          icon = ActiveAdminPrism::Icons.svg(icon_name, css_class: "prism-filter-icon")
           contents = @contents
           @contents = nil
           new_title = h3 do
@@ -64,6 +78,21 @@ module ActiveAdmin
 
         build_sidebar_content
       end
+
+      private
+
+      # `options[:icon]` is a new convention this gem adds to the stock
+      # `sidebar "Title", only: [...] do ... end` DSL — ActiveAdmin::
+      # SidebarSection itself just stores the whole options hash
+      # untouched, so a host can already pass `icon:` today without any
+      # of their own version needing to change; it's a no-op until this
+      # gem starts reading it here.
+      def icon_name
+        return @section.options[:icon] if @section.options[:icon]
+        return :filter if @section.id == FILTERS_SECTION_ID
+
+        DEFAULT_ICON
+      end
     end
   end
 end

data/lib/active_admin/views/flash_messages.rb

@@ -3,17 +3,21 @@
 module ActiveAdmin
   module Views
     module Pages
-      # Reopens ActiveAdmin::Views::Pages::Base to add a dismiss ("x")
-      # button to each flash message, and to render the configured
-      # auto-dismiss delay as a data attribute prism.js reads at runtime
-      # (see ActiveAdminPrism::Configuration#flash_dismissible /
+      # Reopens ActiveAdmin::Views::Pages::Base to render flash messages as
+      # floating toast cards (icon + message + dismiss button + a
+      # countdown progress bar) instead of ActiveAdmin's plain inline
+      # banner, and to render the configured auto-dismiss delay as a data
+      # attribute prism.js reads at runtime (see
+      # ActiveAdminPrism::Configuration#flash_dismissible /
       # #flash_auto_dismiss / #flash_auto_dismiss_seconds).
       #
       # The stock #build_flash_messages just renders
-      # `div message, class: "flash flash_#{type}"` — no room for a button.
-      # When flash_dismissible is false, that exact stock markup is what
-      # this renders; only when it's true (the default) does the message
-      # get wrapped with a dismiss button alongside it.
+      # `div message, class: "flash flash_#{type}"` — no room for an icon,
+      # a button, or a progress bar. When flash_dismissible is false, the
+      # dismiss button is dropped; the icon and (if flash_auto_dismiss is
+      # on) the progress bar still render either way — see
+      # scss-src/_base.scss for the toast styling/positioning and the
+      # progress bar's CSS animation.
       #
       # Auto-dismiss timing and the click handler for the dismiss button
       # both live in active_admin_prism/prism.js (CSS alone can't
@@ -22,29 +26,43 @@ module ActiveAdmin
         def build_flash_messages
           config = ActiveAdminPrism.configuration
           flashes_data = { "prism-transition-ms": config.flash_transition_ms.to_i }
-          if config.flash_auto_dismiss
-            flashes_data[:"prism-auto-dismiss-ms"] = (config.flash_auto_dismiss_seconds.to_f * 1000).round
-          end
+          auto_dismiss_ms = config.flash_auto_dismiss_ms
+          flashes_data[:"prism-auto-dismiss-ms"] = auto_dismiss_ms if auto_dismiss_ms
 
           div class: "flashes", data: flashes_data do
             flash_messages.each do |type, messages|
               [*messages].each do |message|
-                if config.flash_dismissible
-                  div class: "flash flash_#{type}" do
-                    span message, class: "prism-flash-message"
-                    button class: "prism-flash-dismiss", type: "button",
-                           "aria-label": "Dismiss", data: { "prism-flash-dismiss": true } do
-                      text_node ActiveAdminPrism::Icons.svg(:x, css_class: "prism-flash-dismiss-icon", size: 14).html_safe
-                    end
-                  end
-                else
-                  div message, class: "flash flash_#{type}"
-                end
+                build_flash(type, message, config, auto_dismiss_ms)
               end
             end
           end
         end
 
+        def build_flash(type, message, config, auto_dismiss_ms)
+          flash_options = { class: "flash flash_#{type}" }
+          flash_options[:style] = "--prism-flash-duration: #{auto_dismiss_ms}ms" if auto_dismiss_ms
+
+          div flash_options do
+            text_node flash_icon(type)
+            span message, class: "prism-flash-message"
+            if config.flash_dismissible
+              button class: "prism-flash-dismiss", type: "button",
+                     "aria-label": "Dismiss", data: { "prism-flash-dismiss": true } do
+                text_node ActiveAdminPrism::Icons.svg(:x, css_class: "prism-flash-dismiss-icon", size: 14).html_safe
+              end
+            end
+            div class: "prism-flash-progress" if auto_dismiss_ms
+          end
+        end
+
+        # See lib/prism_icons.rb's ActiveAdminPrism::Icons.flash_icon_name —
+        # shared with the plain-ERB logged-out layout, which needs the same
+        # mapping but can't reach this Arbre-only method.
+        def flash_icon(type)
+          name = ActiveAdminPrism::Icons.flash_icon_name(type)
+          (ActiveAdminPrism::Icons.svg(name, css_class: "prism-flash-icon") || "").html_safe
+        end
+
         # Read by prism.js / scss-src's CSS to decide whether to route
         # data-confirm links through the styled dialog, whether the Filters
         # sidebar panel collapses to an icon, whether ActiveAdmin's

data/lib/active_admin/views/prism_sidebar.rb

@@ -40,7 +40,10 @@ module ActiveAdmin
         end
 
         div class: "prism-sidebar-inner" do
-          div(class: "prism-sidebar-brand") { site_title @namespace }
+          div(class: "prism-sidebar-brand") do
+            render_collapse_toggle if ActiveAdminPrism.configuration.sidebar_collapsible
+            site_title @namespace
+          end
           render_language_switcher if ActiveAdminPrism.configuration.language_switcher
           render_search_box if ActiveAdminPrism.configuration.menu_search
           div(class: "prism-sidebar-scroll") do
@@ -79,6 +82,27 @@ module ActiveAdmin
         ).html_safe
       end
 
+      # A hamburger icon button at the top of the sidebar, beside the brand
+      # — the same :menu icon the mobile off-canvas toggle uses, so both
+      # read as "the sidebar toggle" at a glance even though they're two
+      # separate buttons for two separate behaviors (this one only ever
+      # renders/matters at desktop widths; see scss-src/_sidebar.scss).
+      # Toggles the whole sidebar between full width and a narrow
+      # icon-only rail — see ActiveAdminPrism::Configuration
+      # #sidebar_collapsible and js-src/prism.js for the click handler
+      # (persists to localStorage) and scss-src/_sidebar.scss for the
+      # collapsed-state styling.
+      def render_collapse_toggle
+        span(
+          class: "prism-sidebar-collapse-toggle",
+          data: { "prism-toggle-sidebar-collapse": true },
+          role: "button", tabindex: "0", "aria-expanded": "true",
+          "aria-label": "Collapse sidebar"
+        ) do
+          text_node ActiveAdminPrism::Icons.svg(:menu, css_class: "prism-sidebar-collapse-icon").html_safe
+        end
+      end
+
       # A small "Languages" dropdown near the top of the sidebar — see
       # ActiveAdminPrism::Configuration#language_switcher/#languages. Built
       # here directly (rather than via the `admin.build_menu
@@ -191,8 +215,13 @@ module ActiveAdmin
       end
 
       def render_group_toggle(item, label)
-        span(class: "prism-nav-group-toggle", data: { "prism-toggle": true }) do
-          text_node icon_for(item)
+        # title: a plain native tooltip — inert most of the time (the
+        # sidebar already shows this label as text), but the only way to
+        # identify this item by hover once ActiveAdminPrism::Configuration
+        # #sidebar_collapsible has shrunk the sidebar to its icon-only rail
+        # and .prism-nav-label itself is hidden (see scss-src/_sidebar.scss).
+        span(class: "prism-nav-group-toggle", data: { "prism-toggle": true }, title: label) do
+          text_node icon_for(item, label)
           span(label, class: "prism-nav-label")
           text_node chevron_svg
         end
@@ -201,22 +230,26 @@ module ActiveAdmin
       def render_leaf(item, label, url)
         link_options = item.html_options.except(:icon)
         link_options[:class] = ["prism-nav-link", link_options[:class]].compact.join(" ")
+        # Same rail-collapse tooltip as render_group_toggle above — a host's
+        # own explicit :title (via html_options) wins over the label.
+        link_options[:title] ||= label
 
         if real_url?(url)
           text_node helpers.link_to(link_body(item, label), url, **link_options)
         else
-          span(class: "prism-nav-link") { link_body(item, label) }
+          span(class: "prism-nav-link", title: label) { link_body(item, label) }
         end
       end
 
       def link_body(item, label)
-        helpers.safe_join([icon_for(item), helpers.content_tag(:span, label, class: "prism-nav-label")])
+        helpers.safe_join([icon_for(item, label), helpers.content_tag(:span, label, class: "prism-nav-label")])
       end
 
       # Always returns an html_safe string (possibly empty) — never escape-able
       # raw markup should cross a text_node/content_tag boundary unmarked.
-      def icon_for(item)
+      def icon_for(item, label)
         name = item.html_options[:icon] || DEFAULT_ITEM_ICONS[item.id]
+        name ||= ActiveAdminPrism::Icons.auto_nav_icon_name(label) if ActiveAdminPrism.configuration.auto_nav_icons
         return "".html_safe unless name
 
         (ActiveAdminPrism::Icons.svg(name, css_class: "prism-nav-icon") || "").html_safe

data/lib/active_admin/views/title_bar.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module ActiveAdmin
+  module Views
+    # Reopens ActiveAdmin::Views::TitleBar purely to render
+    # ActiveAdminPrism::Configuration#action_items_dropdown_threshold as a
+    # data attribute on "#titlebar_right" — js-src/prism.js reads it at
+    # runtime to decide whether the action_item buttons it finds inside
+    # need consolidating into a dropdown (see that file, and
+    # scss-src/_buttons.scss for the dropdown's own styling). Nothing else
+    # about title bar rendering changes; this can't be done in CSS alone
+    # since deciding whether to consolidate depends on *counting* how many
+    # action_items actually rendered, not just their presence.
+    class TitleBar
+      def build_titlebar_right
+        config = ActiveAdminPrism.configuration
+        data = {}
+        data[:"prism-action-items-threshold"] = config.action_items_dropdown_threshold if config.action_items_dropdown
+
+        div id: "titlebar_right", data: data do
+          build_action_items
+        end
+      end
+      private :build_titlebar_right
+    end
+  end
+end

data/lib/active_admin_prism/configuration.rb

@@ -161,6 +161,81 @@ module ActiveAdminPrism
     # see js-src/prism.js and vendor/select2/.
     attr_accessor :select2
 
+    # Whether the "current scope + active filters" summary (AA core's own
+    # "Search status" sidebar section, auto-added to every resource) renders
+    # as a compact bar above the index table instead of inside #sidebar.
+    # true (the default) avoids it getting squeezed/overflowing alongside
+    # the Filters panel when collapsible_filters is on (see
+    # lib/active_admin/views/active_filters_bar.rb). false restores
+    # ActiveAdmin's stock behavior — rendered inside #sidebar as its own
+    # panel, above/below the Filters form depending on registration order.
+    attr_accessor :active_filters_bar
+
+    # Whether a toggle button renders at the bottom of the Prism sidebar
+    # (below the nav/account area) that collapses it to a narrow icon-only
+    # rail on desktop, expanding back to full width (with labels) on
+    # another click — state persists across page loads via localStorage,
+    # the same convention already used for per-group nav expand/collapse
+    # state (see lib/active_admin/views/prism_sidebar.rb and js-src/prism.js).
+    # Purely a desktop feature: the existing off-canvas mobile toggle
+    # (below 900px) is unaffected either way. false renders no toggle at
+    # all — the sidebar is always full width, matching this gem's behavior
+    # before this flag existed.
+    attr_accessor :sidebar_collapsible
+
+    # Whether a title bar with more than #action_items_dropdown_threshold
+    # `action_item` buttons collapses them into a single "Actions"
+    # dropdown instead of rendering every one inline. A resource that
+    # registers many (a dozen+ CSV upload / bulk-action links is a real
+    # example this was built for) turns the title bar into a multi-row
+    # wall of buttons otherwise — see js-src/prism.js's action-items
+    # handler, which does the actual consolidation client-side, and
+    # lib/active_admin/views/title_bar.rb for the threshold this reads.
+    # false never consolidates — every action_item always renders inline,
+    # matching this gem's behavior before this flag existed.
+    attr_accessor :action_items_dropdown
+
+    # How many `action_item`s (not counting the auto-added "New Resource"
+    # button, which is never counted or consolidated — see
+    # lib/active_admin/views/action_items.rb) a title bar can have before
+    # #action_items_dropdown (if true) collapses them into a dropdown.
+    # Default 0 means the "Actions" Select2 dropdown is what a host sees
+    # by default the moment they add even a single custom action_item,
+    # rather than only once they've piled up "many" of them — raise this
+    # if you'd rather a page with just one or two extra actions kept
+    # rendering them inline instead.
+    attr_accessor :action_items_dropdown_threshold
+
+    # Whether a Pages nav item with no explicit `icon:` (and not one of
+    # the handful this gem itself always icons — the current-user/logout
+    # rows) gets one anyway instead of rendering label-less, or as just a
+    # bare dot once the sidebar is collapsed to its icon-only rail (see
+    # ActiveAdminPrism::Configuration#sidebar_collapsible). Deterministic
+    # per item, not re-rolled on every request — the same menu label
+    # always picks the same icon from lib/prism_icons.rb's
+    # ActiveAdminPrism::Icons::NAV_ICON_POOL (see
+    # lib/active_admin/views/prism_sidebar.rb#icon_for), so it doesn't
+    # visibly shuffle around between page loads. false renders no icon at
+    # all for such an item, matching this gem's behavior before this flag
+    # existed.
+    attr_accessor :auto_nav_icons
+
+    # Milliseconds equivalent of #flash_auto_dismiss_seconds, or nil when
+    # #flash_auto_dismiss is off — the exact number both flash-rendering
+    # paths this gem ships (lib/active_admin/views/flash_messages.rb's
+    # Arbre override for logged-in pages, and the plain-ERB
+    # app/views/layouts/active_admin_logged_out.html.erb for Devise's
+    # sign-in/password/etc pages) need to render identically: as the
+    # "data-prism-auto-dismiss-ms" attribute js-src/prism.js reads to
+    # schedule removal, and as each flash's own
+    # "--prism-flash-duration" inline style the countdown bar
+    # (scss-src/_base.scss's ".prism-flash-progress") animates against.
+    def flash_auto_dismiss_ms
+      return nil unless flash_auto_dismiss
+
+      (flash_auto_dismiss_seconds.to_f * 1000).round
+    end
+
     def initialize
       @sidebar = true
       @colorize_action_icons = true
@@ -183,6 +258,11 @@ module ActiveAdminPrism
       ]
       @menu_search = true
       @select2 = false
+      @active_filters_bar = true
+      @sidebar_collapsible = true
+      @action_items_dropdown = true
+      @action_items_dropdown_threshold = 0
+      @auto_nav_icons = true
     end
   end
 

data/lib/active_admin_prism/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActiveAdminPrism
-  VERSION = "0.1.2"
+  VERSION = "0.1.4"
 end

data/lib/active_admin_prism.rb

@@ -12,6 +12,9 @@ require_relative "active_admin/views/prism_sidebar"
 require_relative "active_admin/views/index_table_actions"
 require_relative "active_admin/views/flash_messages"
 require_relative "active_admin/views/filters_sidebar"
+require_relative "active_admin/views/active_filters_bar"
+require_relative "active_admin/views/title_bar"
+require_relative "active_admin/views/action_items"
 require_relative "formtastic/inputs/prism_toggle_input"
 
 module ActiveAdminPrism

data/lib/prism_icons.rb

@@ -36,9 +36,34 @@ module ActiveAdminPrism
              '<path d="M10 11v6M14 11v6"/>',
       filter: '<path d="M4 5h16l-6.5 7.5v6l-3 1.5v-7.5Z"/>',
       globe: '<circle cx="12" cy="12" r="9"/><path d="M3 12h18"/>' \
-             '<path d="M12 3c2.5 2.4 4 5.6 4 9s-1.5 6.6-4 9c-2.5-2.4-4-5.6-4-9s1.5-6.6 4-9Z"/>'
+             '<path d="M12 3c2.5 2.4 4 5.6 4 9s-1.5 6.6-4 9c-2.5-2.4-4-5.6-4-9s1.5-6.6 4-9Z"/>',
+      check_circle: '<circle cx="12" cy="12" r="9"/><path d="M8 12.5l2.5 2.5L16 9"/>',
+      alert_circle: '<circle cx="12" cy="12" r="9"/><path d="M12 7.5v6"/><circle cx="12" cy="16.5" r="0.1" fill="currentColor" stroke-width="2.5"/>',
+      alert_triangle: '<path d="M12 4 2.5 20h19L12 4Z"/><path d="M12 10v4.5"/><circle cx="12" cy="17.2" r="0.1" fill="currentColor" stroke-width="2.5"/>',
+      info: '<circle cx="12" cy="12" r="9"/><path d="M12 11v5.5"/><circle cx="12" cy="7.8" r="0.1" fill="currentColor" stroke-width="2.5"/>'
     }.freeze
 
+    # Candidates for ActiveAdminPrism::Configuration#auto_nav_icons — a
+    # generic-enough subset of ICONS above that any of them reads as
+    # plausible next to an arbitrary menu label (excludes chevron_down,
+    # check/x, the alert/info trio and logout: purpose-specific shapes
+    # that would look wrong or actively misleading picked at random for,
+    # say, a "Reports" link).
+    NAV_ICON_POOL = %i[
+      dashboard users cart box receipt credit_card message settings
+      home list folder bell search globe eye pencil filter
+    ].freeze
+
+    # Deterministic, not actually random — the same `label` always maps
+    # to the same icon (a simple sum-of-bytes hash, stable across
+    # processes/restarts unlike Ruby's own salted String#hash), so a
+    # nav item's auto-picked icon doesn't visibly shuffle between page
+    # loads. See lib/active_admin/views/prism_sidebar.rb#icon_for, the
+    # only caller.
+    def self.auto_nav_icon_name(label)
+      NAV_ICON_POOL[label.to_s.each_byte.sum % NAV_ICON_POOL.length]
+    end
+
     # Returns an inline <svg>...</svg> string for `name`, or nil if unknown.
     def self.svg(name, css_class: "prism-icon", size: 18)
       inner = ICONS[name.to_sym]
@@ -49,6 +74,27 @@ module ActiveAdminPrism
         %(stroke-linejoin="round" aria-hidden="true">#{inner}</svg>)
     end
 
+    # Maps a flash's key (Rails' own :notice/:alert conventions, plus
+    # :error/:warning/:success/:info as an app might set directly) to one
+    # of the four icons above — anything else (a host's own custom flash
+    # key) falls back to the neutral :info icon rather than none at all.
+    # Shared by both flash-rendering paths this gem ships: the Arbre-based
+    # one for logged-in pages (lib/active_admin/views/flash_messages.rb)
+    # and the plain-ERB logged-out layout (app/views/layouts/
+    # active_admin_logged_out.html.erb) — Devise's sign-in/password/etc
+    # pages render through a completely separate layout ActiveAdmin
+    # itself ships, not through Pages::Base/Arbre at all, so that
+    # Ruby-side override alone never reaches them.
+    FLASH_ICONS = {
+      notice: :check_circle, success: :check_circle,
+      alert: :alert_triangle, warning: :alert_triangle,
+      error: :alert_circle
+    }.freeze
+
+    def self.flash_icon_name(type)
+      FLASH_ICONS[type.to_sym] || :info
+    end
+
     # The default sign-in page mark (see ActiveAdminPrism::Configuration
     # #login_logo) — a generic glass-prism-with-spectrum motif distinct from
     # the 24x24 line-icon set above (bigger, multi-color, animated via