plutonium 0.69.0 → 0.70.0

data/lib/plutonium/ui/grid/card.rb

@@ -195,7 +195,10 @@ module Plutonium
         #   - associations → display_name_of (label, not an object inspect)
         #   - everything else → humanized, with the RAW value driving the
         #     variant so status-like enums (in_progress, published…) still
-        #     resolve to a semantic color.
+        #     resolve to a semantic color. A `colors:` map declared on the
+        #     field's `column` (or else its `display`) picks the variant
+        #     first, as it does for the Badge in the table and on the show
+        #     page.
         # The variant hashes the stable formatted label for currency/associations,
         # so the decorative color no longer churns on an object's memory address.
         def render_meta_badge(name, value)
@@ -209,7 +212,7 @@ module Plutonium
             variant = badge.variant_for(label)
           else
             label = Plutonium::Translation.value_label(@record.class, name, value) || badge.humanize(value)
-            variant = badge.variant_for(value)
+            variant = badge.variant_for(value, colors: declared_colors(name))
           end
 
           span(class: tokens("pu-badge", "pu-badge-#{variant}")) do
@@ -217,6 +220,12 @@ module Plutonium
           end
         end
 
+        def declared_colors(name)
+          name = name.to_sym
+          resource_definition.defined_columns.dig(name, :options, :colors) ||
+            resource_definition.defined_displays.dig(name, :options, :colors)
+        end
+
         def currency_field?(name)
           klass = record.class
           klass.respond_to?(:has_cents_decimal_attribute?) && klass.has_cents_decimal_attribute?(name.to_sym)

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

@@ -54,7 +54,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 render_bulk_actions_toolbar
@@ -181,7 +181,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/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/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.69.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.69.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);

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: plutonium
 version: !ruby/object:Gem::Version
-  version: 0.69.0
+  version: 0.70.0
 platform: ruby
 authors:
 - Stefan Froelich
 bindir: exe
 cert_chain: []
-date: 2026-10-15 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: zeitwerk
@@ -619,6 +619,7 @@ files:
 - docs/blog/jobs-are-not-permission-snapshots.md
 - docs/blog/plutonium-and-ai-agents.md
 - docs/blog/realtime-is-one-line-and-four-dependencies.md
+- docs/blog/the-slowest-query-is-the-count.md
 - docs/blog/two-forms-one-dom-id.md
 - docs/blog/whats-new-async-kanban-wizards.md
 - docs/getting-started/index.md
@@ -660,11 +661,9 @@ files:
 - docs/public/favicon-16x16.png
 - docs/public/favicon-32x32.png
 - docs/public/favicon.ico
-- docs/public/images/blog/dashboards-card-error.png
-- docs/public/images/blog/dashboards-loading.png
-- docs/public/images/blog/dashboards-overview.png
-- docs/public/images/blog/dashboards-sidebar.png
 - docs/public/images/blog/i18n-es-admin.png
+- docs/public/images/blog/pagination-capped.png
+- docs/public/images/blog/pagination-countless.png
 - docs/public/images/components/avatar.png
 - docs/public/images/guides/custom-actions-bulk.png
 - docs/public/images/guides/dashboard-card-error.png
@@ -1225,6 +1224,7 @@ files:
 - lib/plutonium/migrations.rb
 - lib/plutonium/models/has_cents.rb
 - lib/plutonium/package/engine.rb
+- lib/plutonium/pagination.rb
 - lib/plutonium/portal/controller.rb
 - lib/plutonium/portal/dynamic_controllers.rb
 - lib/plutonium/portal/engine.rb
@@ -1584,7 +1584,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Build production-ready Rails apps in minutes, not days
 test_files: []