plutonium 0.68.0 → 0.70.0

data/lib/plutonium/ui/layout/icon_rail.rb

@@ -18,6 +18,12 @@ module Plutonium
       #   render IconRail.new(menu: @menu) do |rail|
       #     rail.with_brand { image_tag("logo.svg", class: "w-8 h-8") }
       #   end
+      #
+      # @example Links pinned above the footer, outside the scrolling nav
+      #   render IconRail.new(
+      #     menu: @menu,
+      #     footer_menu: Phlexi::Menu::Builder.new { |m| m.item "Settings", url: settings_path, icon: Phlex::TablerIcons::Settings }
+      #   )
       class IconRail < Plutonium::UI::Component::Base
         include Phlex::Slotable
 
@@ -28,9 +34,11 @@ module Plutonium
         DEFAULT_MAX_DEPTH = 2
 
         # @param menu [Phlexi::Menu::Builder, nil] Menu structure (same shape as SidebarMenu)
+        # @param footer_menu [Phlexi::Menu::Builder, nil] Links pinned above the footer, outside the scrolling nav
         # @param max_depth [Integer] Maximum rendering depth (depth 2 supports parent+children)
-        def initialize(menu: nil, max_depth: DEFAULT_MAX_DEPTH)
+        def initialize(menu: nil, footer_menu: nil, max_depth: DEFAULT_MAX_DEPTH)
           @menu = menu
+          @footer_menu = footer_menu
           @max_depth = max_depth
         end
 
@@ -46,6 +54,7 @@ module Plutonium
           ) do
             render_brand_section
             render_nav_section
+            render_footer_menu_section
             render_footer_section
           end
         end
@@ -72,6 +81,16 @@ module Plutonium
           end
         end
 
+        # Kept ahead of the footer, which stays the rail's last section: the
+        # pinned rail's styles right-align that section to place the pin button.
+        def render_footer_menu_section
+          return if @footer_menu.nil? || @footer_menu.items.empty?
+
+          div(class: "flex flex-col items-center gap-1 px-2 py-2 border-t border-[var(--pu-border)] shrink-0") do
+            render_items(@footer_menu.items, 0)
+          end
+        end
+
         def render_footer_section
           div(class: "h-14 flex items-center justify-center border-t border-[var(--pu-border)] shrink-0") do
             render_pin_button
@@ -116,11 +135,12 @@ module Plutonium
         def render_leaf_item(item, depth)
           a(
             href: item.url,
-            title: item.label,
-            **item_link_attributes(item, "icon-rail-leaf #{leaf_classes(item, depth)}", base_aria: {label: item.label})
+            title: item_title(item),
+            **item_link_attributes(item, "icon-rail-leaf #{leaf_classes(item, depth)}", base_aria: {label: item_title(item)})
           ) do
             render_item_icon(item)
             span(class: "icon-rail-label hidden") { item.label }
+            render_trailing_badge(item, "icon-rail-label hidden")
           end
         end
 
@@ -165,14 +185,32 @@ module Plutonium
                   a(
                     href: child.url,
                     role: "menuitem",
+                    title: item_title(child),
                     **item_link_attributes(child, "icon-rail-flyout-item")
-                  ) { child.label }
+                  ) do
+                    plain child.label
+                    render_trailing_badge(child)
+                  end
                 end
               end
             end
           end
         end
 
+        # The label, with the item's trailing badge in brackets, for tooltips
+        # and screen readers: "Reports (Pro)".
+        def item_title(item)
+          item.trailing_badge ? "#{item.label} (#{item.trailing_badge})" : item.label
+        end
+
+        # A short marker after the label, such as the plan that unlocks a page.
+        def render_trailing_badge(item, extra_classes = nil)
+          return unless item.trailing_badge
+
+          span(class: ["icon-rail-badge ml-auto rounded px-1.5 py-0.5 text-[10px] font-medium leading-none " \
+                       "bg-[var(--pu-surface-alt)] text-[var(--pu-text-muted)]", extra_classes].compact.join(" ")) { item.trailing_badge }
+        end
+
         def render_item_icon(item)
           if item.icon
             render item.icon.new(class: "w-5 h-5 shrink-0")

data/lib/plutonium/ui/page/index.rb

@@ -4,6 +4,11 @@ module Plutonium
   module UI
     module Page
       class Index < Base
+        # How many recently finished runs the running banner lists at most. It
+        # sits above the collection; a burst of dispatches must not push the
+        # collection off the screen. The run index has the rest.
+        RECENT_RUNS_LIMIT = 5
+
         # Cookie name carrying a per-resource view preference. Single
         # source of truth — Table::Resource, Grid::Resource, and the
         # Stimulus view-switcher controller all read from here. Underscored
@@ -101,12 +106,26 @@ module Plutonium
           # a URL for a route that doesn't exist here.
           return unless registered_resources.include?(Plutonium::Interaction::Async::Run)
 
-          runs = authorized_resource_scope(
-            Plutonium::Interaction::Async::Run,
-            relation: Plutonium::Interaction::Async::Run.for_target(resource_class).in_progress
+          run_class = Plutonium::Interaction::Async::Run
+          in_progress = authorized_resource_scope(
+            run_class, relation: run_class.for_target(resource_class).in_progress
+          ).to_a
+
+          # The current user's own runs that settled moments ago. A dispatch
+          # sends them back here, and a short run (or one its pre_check rejected)
+          # finishes before this page renders, so "in progress" alone would show
+          # them nothing. Only their own: someone else's finished run is not news.
+          recent = authorized_resource_scope(
+            run_class,
+            relation: run_class.for_target(resource_class)
+              .where(initiator: current_user)
+              .finished_since(Plutonium.configuration.async_interactions.recent_runs_window.ago)
+              .order(finished_at: :desc)
+              .limit(RECENT_RUNS_LIMIT)
           ).to_a
 
-          render Plutonium::UI::Interaction::Async::RunningBanner.new(runs: runs)
+          # uniq: a run that finishes between the two queries is in both.
+          render Plutonium::UI::Interaction::Async::RunningBanner.new(runs: (in_progress + recent).uniq)
         end
 
         def selected_view

data/lib/plutonium/ui/table/components/filter_pills.rb

@@ -5,9 +5,14 @@ module Plutonium
     module Table
       module Components
         class FilterPills < Plutonium::UI::Component::Base
-          def initialize(query:, total_count: nil)
+          # @param total_count [Integer, nil] nil hides the count (countless
+          #   pagination, `pagination count: false`)
+          # @param count_capped [Boolean] the count stopped at its cap
+          #   (`pagination count: 10_000`), so it reads "10000+ results"
+          def initialize(query:, total_count: nil, count_capped: false)
             @query = query
             @total_count = total_count
+            @count_capped = count_capped
           end
 
           def view_template
@@ -79,7 +84,8 @@ module Plutonium
 
           def render_result_count
             div(class: "ml-auto text-xs text-[var(--pu-text-muted)]") do
-              plain t("plutonium.ui.table.result_count", count: @total_count)
+              key = @count_capped ? "plutonium.ui.table.result_count_capped" : "plutonium.ui.table.result_count"
+              plain t(key, count: @total_count)
             end
           end
         end

data/lib/plutonium/ui/table/components/pagy_info.rb

@@ -34,21 +34,41 @@ module Plutonium
           private
 
           def results_info
-            key = if @pagy.count.zero?
-              "pagy.info_tag.no_items"
-            elsif @pagy.in == @pagy.count
-              "pagy.info_tag.single_page"
-            else
-              "pagy.info_tag.multiple_pages"
-            end
-
             div do
-              render_template(pagy_template(key, @pagy.count)) do |placeholder|
-                b { @pagy.public_send(placeholder).to_s }
+              render_template(results_template) do |placeholder|
+                b { (placeholder == :count) ? count_label : @pagy.public_send(placeholder).to_s }
               end
             end
           end
 
+          def results_template
+            count = known_count
+            if count.nil?
+              # Countless, past page 1: the total is unknown, so no "of N".
+              t("plutonium.ui.table.page_range", item_name: item_name(2), from: "%{from}", to: "%{to}")
+            elsif count.zero?
+              pagy_template("pagy.info_tag.no_items", count)
+            elsif count == @pagy.in
+              pagy_template("pagy.info_tag.single_page", count)
+            else
+              pagy_template("pagy.info_tag.multiple_pages", count)
+            end
+          end
+
+          # The total, when it is known. A countless pager (`pagination count:
+          # false`) has none, except on a first page with no next page, where the
+          # rows on it are the whole set.
+          def known_count
+            return @pagy.count if @pagy.count
+            @pagy.in if @pagy.page == 1 && !@pagy.next
+          end
+
+          # "10000+" when the count hit its cap (`pagination count: 10_000`).
+          def count_label
+            count = known_count.to_s
+            @pagy.options[:count_capped] ? t("plutonium.ui.table.capped_count", count:) : count
+          end
+
           def per_page_selector
             id = "perPage#{SecureRandom.hex}"
 

data/lib/plutonium/ui/table/resource.rb

@@ -71,7 +71,7 @@ module Plutonium
         end
 
         def render_filter_pills
-          TableFilterPills(query: current_query_object, total_count: pagy_instance&.count)
+          TableFilterPills(query: current_query_object, total_count: pagy_instance&.count, count_capped: pagy_instance&.options&.fetch(:count_capped, false))
         end
 
         def current_search_url
@@ -315,7 +315,7 @@ module Plutonium
 
         def render_footer
           div(class: "lg:sticky bottom-[-2px] mt-1 p-4 pb-6 w-full z-30 bg-[var(--pu-body)]") {
-            TableInfo(pagy_instance, item_name: resource_name(resource_class, pagy_instance.count))
+            TableInfo(pagy_instance, item_name: resource_name(resource_class, pagy_instance.count || 2))
             TablePagination(pagy_instance)
           }
         end

data/lib/plutonium/version.rb

@@ -1,5 +1,5 @@
 module Plutonium
-  VERSION = "0.68.0"
+  VERSION = "0.70.0"
   NEXT_MAJOR_VERSION = VERSION.split(".").tap { |v|
     v[1] = v[1].to_i + 1
     v[2] = 0

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@radioactive-labs/plutonium",
-  "version": "0.68.0",
+  "version": "0.70.0",
   "description": "Build production-ready Rails apps in minutes, not days. Convention-driven, fully customizable, AI-ready.",
   "type": "module",
   "main": "src/js/core.js",

data/plutonium.gemspec

@@ -35,7 +35,9 @@ Gem::Specification.new do |spec|
         f.start_with?(*%w[bin/ test/ spec/ features/ .git .github appveyor Gemfile]) ||
         # Maintainer tooling; host apps read tailwind.options.js and the postcss
         # plugin from the gem, not the lockfile or yarn settings.
-        %w[.yarnrc.yml yarn.lock public/plutonium-assets/].any? { |prefix| f.start_with?(prefix) }
+        %w[.yarnrc.yml yarn.lock public/plutonium-assets/].any? { |prefix| f.start_with?(prefix) } ||
+        # Full-size brand sources; the gem ships the resized app/assets copy.
+        f.start_with?("brand/")
     end
   end
   spec.bindir = "exe"

data/src/css/components.css

@@ -918,7 +918,9 @@ html.pu-rail-pinned .icon-rail-pin-expand {
 }
 
 .icon-rail-flyout-item {
-  display: block;
+  display: flex;
+  align-items: center;
+  gap: 8px;
   padding: 7px 10px;
   font-size: 13px;
   color: var(--pu-text);
@@ -1222,6 +1224,15 @@ html.pu-rail-pinned .icon-rail-pin-expand {
   margin-left: var(--pu-drag-marker-gap, 4px);
 }
 
+/* The failures on an async run's progress panel: an inline alert holding a
+   list, so it sits flush in the card and the list keeps its bullets. */
+.pu-run-progress-failures {
+  @apply mb-0 items-start;
+}
+.pu-run-progress-failures .pu-alert-message {
+  @apply ms-0 ps-4 list-disc space-y-1;
+}
+
 /* Indeterminate progress for an async run with no denominator (opaque work).
    A short segment sweeping the track: the motion is what says "alive", which a
    static bar at any width cannot, and a full-width bar would misread as done. */