plutonium 0.63.0 → 0.65.0

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

@@ -88,10 +88,10 @@ module Plutonium
           ) do
             div(class: "px-6 pt-5 pb-4 border-b border-[var(--pu-border)]") do
               h2(id: "pu-dirty-guard-title", class: "text-lg font-semibold text-[var(--pu-text)]") do
-                "Discard changes?"
+                t("plutonium.ui.form.discard_title")
               end
               p(id: "pu-dirty-guard-desc", class: "mt-1 text-sm text-[var(--pu-text-muted)]") do
-                "You have unsaved changes. Closing this form now will lose them."
+                t("plutonium.ui.form.discard_description")
               end
             end
             div(class: "flex items-center justify-end gap-2 px-6 py-4") do
@@ -99,12 +99,12 @@ module Plutonium
                 type: "button",
                 class: "pu-btn pu-btn-md pu-btn-outline",
                 data: {action: "dirty-form-guard#keepEditing"}
-              ) { "Keep editing" }
+              ) { t("plutonium.ui.form.keep_editing") }
               button(
                 type: "button",
                 class: "pu-btn pu-btn-md pu-btn-danger",
                 data: {action: "dirty-form-guard#discard"}
-              ) { "Discard changes" }
+              ) { t("plutonium.ui.form.discard_changes") }
             end
           end
         end
@@ -125,6 +125,12 @@ module Plutonium
             div(class: themed(:sections_wrapper, nil)) do
               sections.each { |rs| render_form_section(rs) }
             end
+            # Fields of sections dropped because every one of them is
+            # condition-hidden. They still go through the normal render path,
+            # which records them without emitting markup (see
+            # render_simple_resource_field), so the form keeps extracting their
+            # values exactly as it does for a hidden field in a visible section.
+            @condition_hidden_section_fields.each { |name| render_resource_field name }
           end
         end
 
@@ -134,6 +140,7 @@ module Plutonium
         # helpers live — same context as input/section `condition:`). Returns nil
         # when no form_layout is declared (caller falls back to a single grid).
         def resolve_form_layout
+          @condition_hidden_section_fields = []
           sections = resource_definition.resolve_form_sections(resource_fields)
           return nil if sections.nil?
 
@@ -146,12 +153,19 @@ module Plutonium
             # filtered out by the permitted set (policy, per-action, scoping,
             # nesting). Rendering the chrome (heading + empty grid) for these
             # litters the form with empty headings (notably on `+ New`, where
-            # fewer attributes are permitted than declared). Field-level
-            # `condition:` is evaluated later, at render — a section whose fields
-            # are all condition-hidden is the author's call to gate via the
-            # section's own `condition:`.
+            # fewer attributes are permitted than declared).
             next if resolved.fields.empty?
 
+            # Likewise drop sections whose fields are ALL hidden by their own
+            # `condition:` on this render (e.g. a "Timing" section of fields that
+            # only apply to some record types, re-evaluated on `pre_submit`).
+            # Their fields are kept aside and rendered after the sections, so
+            # the hidden values are still recorded.
+            if resolved.fields.all? { |name| field_condition_hidden?(name) }
+              @condition_hidden_section_fields.concat(resolved.fields)
+              next
+            end
+
             # `columns` stays a validated literal (the Builder rejects a non-Integer
             # at declaration); `label`/`description`/`collapsible`/`collapsed` may be
             # procs, resolved by the SAME arity rule as a field/input option so
@@ -268,7 +282,7 @@ module Plutonium
         end
 
         def render_submit_and_continue_button
-          label = object.new_record? ? "Create and add another" : "Update and continue editing"
+          label = object.new_record? ? t("plutonium.ui.form.create_and_add_another") : t("plutonium.ui.form.update_and_continue_editing")
 
           button(
             type: :submit,
@@ -315,19 +329,22 @@ module Plutonium
 
           tag = input_options[:as] || field_options[:as]
 
-          # Extract field-level options from input_options and merge into field_options
-          # These are Phlexi field options that should be passed to form.field(), not to the tag builder
-          # Note: forms use :hint, displays use :description
-          field_level_keys = [:hint, :label, :placeholder]
-          field_level_options = input_options.slice(*field_level_keys)
+          # Route the input's own field-level options to form.field(); strip the
+          # full union from the tag attributes so a display-only key (e.g.
+          # :description) declared here is dropped rather than leaked as an HTML
+          # attribute.
+          field_level_options = input_options.slice(*FORM_FIELD_LEVEL_KEYS)
           field_options = field_options.merge(field_level_options)
+          # Slots the definition left blank fall back to the locale convention
+          # (plutonium.fields.<model>.<attr>.placeholder / .hint).
+          field_options = Plutonium::Translation.fill_field_text(field_options, form.object.class, name, :placeholder, :hint)
 
           # Staging options are stripped here as well as in Wizard::StepAdapter,
           # because an interaction's inputs reach this method directly. A
           # Class-valued `uploader:` is not an HTML attribute and Phlex refuses
           # it, so leaving it in raises rather than rendering.
           tag_attributes = input_options.except(
-            :wrapper, :as, :pre_submit, :condition, *field_level_keys,
+            :wrapper, :as, :pre_submit, :condition, *FIELD_LEVEL_KEYS,
             *Plutonium::Attachments::STAGING_ONLY_INPUT_OPTIONS
           )
           if input_options[:pre_submit]
@@ -344,10 +361,15 @@ module Plutonium
           # renders correctly. The Builder consumes `:as` before Phlexi sees
           # the options, so this cannot leak into a Phlexi field option.
           field_options = field_options.merge(as: tag) if tag
-          field_options = field_options.except(:condition)
 
+          # Check for conditional rendering — read `:condition` from
+          # `field_options` BEFORE stripping it, so a `field :name,
+          # condition: -> {...}` declaration is honoured, not just
+          # `input :name, condition: -> {...}`. Mirrors the display
+          # renderer, which reads then removes (see display/resource.rb).
           condition = input_options[:condition] || field_options[:condition]
           conditionally_hidden = condition && !instance_exec(&condition)
+          field_options = field_options.except(:condition)
           if conditionally_hidden
             # Do not render the field, but still create field
             # Phlexi form will record it without rendering it, allowing us to extract its value
@@ -411,18 +433,24 @@ module Plutonium
         # is why it cannot take a `form` argument the way an option does.
         # Resolving it here would also collapse it to a boolean before the render
         # site that owns it gets to ask.
-        def resolve_option_procs(options)
-          return options if options.blank?
-
-          options.to_h do |key, value|
-            [key, resolvable_proc?(key, value) ? call_option_proc(value) : value]
-          end
+        # Whether +name+ is hidden on this render by its own `condition:` — the
+        # same check render_resource_field makes before rendering it: a nested
+        # input's condition, else the `input`/`field` condition. Structured
+        # inputs have no condition of their own and always count as visible.
+        def field_condition_hidden?(name)
+          definition = resource_definition
+          condition =
+            if definition.respond_to?(:defined_nested_inputs) && (nested = definition.defined_nested_inputs[name])
+              nested[:options]&.fetch(:condition, nil)
+            elsif definition.respond_to?(:defined_structured_inputs) && definition.defined_structured_inputs[name]
+              nil
+            else
+              definition.defined_inputs.dig(name, :options, :condition) ||
+                definition.defined_fields.dig(name, :options, :condition)
+            end
+          condition.present? && !instance_exec(&condition)
         end
 
-        def resolvable_proc?(key, value) = key != :condition && value.is_a?(Proc)
-
-        def call_option_proc(value) = value.arity.zero? ? value.call : value.call(self)
-
         def when_permitted(name, &)
           return unless resource_fields.include? name
 

data/lib/plutonium/ui/frame_navigator_panel.rb

@@ -66,10 +66,10 @@ module Plutonium
         div(data: {controller: %w[frame-navigator]}) do
           Panel do |panel|
             panel.with_title @title
-            panel.with_item PanelItem.new(label: "Home", icon: Phlex::TablerIcons::Home2, data_frame_navigator_target: "homeButton")
-            panel.with_item PanelItem.new(label: "Back", icon: Phlex::TablerIcons::ChevronLeft, data_frame_navigator_target: "backButton")
-            panel.with_item PanelItem.new(label: "Refresh", icon: Phlex::TablerIcons::RefreshDot, data_frame_navigator_target: "refreshButton")
-            panel.with_item PanelLink.new(label: "Maximize", icon: Phlex::TablerIcons::WindowMaximize, href: @src, data_frame_navigator_target: "maximizeLink")
+            panel.with_item PanelItem.new(label: t("plutonium.ui.home"), icon: Phlex::TablerIcons::Home2, data_frame_navigator_target: "homeButton")
+            panel.with_item PanelItem.new(label: t("plutonium.ui.frame_navigator.back"), icon: Phlex::TablerIcons::ChevronLeft, data_frame_navigator_target: "backButton")
+            panel.with_item PanelItem.new(label: t("plutonium.ui.frame_navigator.refresh"), icon: Phlex::TablerIcons::RefreshDot, data_frame_navigator_target: "refreshButton")
+            panel.with_item PanelLink.new(label: t("plutonium.ui.frame_navigator.maximize"), icon: Phlex::TablerIcons::WindowMaximize, href: @src, data_frame_navigator_target: "maximizeLink")
             panel.with_content PanelContent.new(id: @panel_id, src: @src)
           end
         end

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

@@ -200,7 +200,7 @@ module Plutonium
             label = helpers.display_name_of(value)
             variant = badge.variant_for(label)
           else
-            label = badge.humanize(value)
+            label = Plutonium::Translation.value_label(@record.class, name, value) || badge.humanize(value)
             variant = badge.variant_for(value)
           end
 
@@ -269,8 +269,8 @@ module Plutonium
             data: {row_click_target: "show", turbo_frame: @show_turbo_frame || show.turbo_frame(resource_definition)},
             class: "sr-only",
             tabindex: "-1",
-            "aria-label": "Open #{header_text}"
-          })) { plain "Open" }
+            "aria-label": t("plutonium.ui.grid.open_record", name: header_text)
+          })) { plain t("plutonium.ui.grid.open") }
         end
 
         # ---------------------------------------------------------------

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

@@ -63,7 +63,7 @@ module Plutonium
         end
 
         def render_empty_card
-          EmptyCard("No #{resource_name_plural(resource_class).downcase} available") {
+          EmptyCard(t("plutonium.ui.empty_state.none_available", resources: resource_name_plural(resource_class).downcase)) {
             action = resource_definition.defined_actions[:new]
             if action&.permitted_by?(current_policy)
               url = route_options_to_url(action.route_options, resource_class)
@@ -160,7 +160,7 @@ module Plutonium
                    "data-[open]:translate-x-0 " \
                    "flex flex-col",
             role: "dialog",
-            aria: {label: "Filters", hidden: "true", modal: "true"},
+            aria: {label: t("plutonium.ui.table.filters"), hidden: "true", modal: "true"},
             data: {filter_panel_target: "panel"}
           ) do
             render Plutonium::UI::Table::Components::FilterForm.new(
@@ -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)
+            TableInfo(pagy_instance, item_name: resource_name(resource_class, pagy_instance.count))
             TablePagination(pagy_instance)
           }
         end

data/lib/plutonium/ui/interaction/async/run_progress.rb

@@ -118,7 +118,7 @@ module Plutonium
           def render_status
             div(class: "flex items-center gap-2 flex-wrap") do
               span(class: "pu-badge pu-badge-#{BADGE_VARIANTS.fetch(run.outcome, "neutral")}") do
-                plain run.outcome.humanize
+                plain(Plutonium::Translation.value_label(run.class, :outcome, run.outcome) || run.outcome.humanize)
               end
               # The count rides alongside the badge rather than only in the list
               # below: a partially-applied :continue run ends as "completed", and
@@ -126,7 +126,7 @@ module Plutonium
               # do everything it was asked to.
               if run.error_count.positive?
                 span(class: "text-xs font-medium text-[var(--pu-text-danger)]") do
-                  plain "#{run.error_count} #{"error".pluralize(run.error_count)}"
+                  plain t("plutonium.async.progress.error_count", count: run.error_count)
                 end
               end
             end
@@ -151,7 +151,7 @@ module Plutonium
                 div(class: "h-2 rounded-full bg-primary-600", style: "width: #{percent}%")
               end
               div(class: "text-xs text-[var(--pu-text-muted)]") do
-                plain "#{run.progress_done} of #{run.progress_total} targets (#{percent}%)"
+                plain t("plutonium.async.progress.targets", done: run.progress_done, total: run.progress_total, percent: percent)
               end
             end
           end
@@ -175,7 +175,7 @@ module Plutonium
                 end
               end
               div(class: "text-xs text-[var(--pu-text-muted)]") do
-                plain(run.in_progress? ? "Working…" : "No progress total was recorded")
+                plain(run.in_progress? ? t("plutonium.async.progress.working") : t("plutonium.async.progress.no_total"))
               end
             end
           end
@@ -204,7 +204,7 @@ module Plutonium
           def render_failures
             div(class: "space-y-1") do
               div(class: "text-[10px] font-semibold uppercase tracking-wider text-[var(--pu-text-muted)]") do
-                plain "Failures"
+                plain t("plutonium.async.progress.failures")
               end
               ul(class: "pu-run-progress-failures text-xs space-y-1") do
                 run.errors_log.each do |entry|
@@ -218,7 +218,7 @@ module Plutonium
           # not a target whose id happens to be blank.
           def failure_text(entry)
             target_id = entry["target_id"]
-            target_id.nil? ? entry["message"].to_s : "##{target_id}: #{entry["message"]}"
+            target_id.nil? ? entry["message"].to_s : t("plutonium.async.progress.target_failure", target_id: target_id, message: entry["message"])
           end
         end
       end

data/lib/plutonium/ui/interaction/async/running_banner.rb

@@ -51,10 +51,10 @@ module Plutonium
                 # own page renders the pair.
                 span(class: "font-medium text-[var(--pu-text)]") { plain run.to_label }
                 plain " "
-                span(class: "text-[var(--pu-text-muted)]") { plain run.state.humanize }
+                span(class: "text-[var(--pu-text-muted)]") { plain(Plutonium::Translation.value_label(run.class, :state, run.state) || run.state.humanize) }
               end
               a(href: resource_url_for(run), class: "pu-btn pu-btn-xs pu-btn-soft-primary shrink-0") do
-                plain "View progress"
+                plain t("plutonium.async.banner.view_progress")
               end
             end
           end

data/lib/plutonium/ui/kanban/column.rb

@@ -162,7 +162,7 @@ module Plutonium
             button(
               class: "p-0.5 rounded text-[var(--pu-text-muted)] " \
                      "hover:text-[var(--pu-text)] hover:bg-[var(--pu-surface-alt)]",
-              title: "Expand #{column.label}",
+              title: t("plutonium.kanban.column.expand", column: column.label),
               type: "button",
               data: {
                 action: "click->kanban#toggleColumn",
@@ -214,7 +214,7 @@ module Plutonium
             button(
               class: "shrink-0 p-0.5 rounded text-[var(--pu-text-muted)] " \
                      "hover:text-[var(--pu-text)] hover:bg-[var(--pu-surface-alt)]",
-              title: "Collapse #{column.label}",
+              title: t("plutonium.kanban.column.collapse", column: column.label),
               type: "button",
               data: {
                 action: "click->kanban#toggleColumn",
@@ -237,7 +237,7 @@ module Plutonium
               "pu-badge text-xs font-mono",
               over ? "pu-badge-danger" : "pu-badge-neutral"
             ),
-            title: over ? "WIP limit exceeded" : "WIP limit: #{column.wip}"
+            title: over ? t("plutonium.kanban.column.wip_limit_exceeded") : t("plutonium.kanban.column.wip_limit", limit: column.wip)
           ) do
             plain "#{cards.size}/#{column.wip}"
           end
@@ -281,7 +281,7 @@ module Plutonium
         def render_more_footer
           div(class: "px-3 py-2 border-t border-[var(--pu-border)] bg-[var(--pu-surface)]") do
             span(class: "text-xs text-[var(--pu-text-muted)]") do
-              plain "+#{more_count} more"
+              plain t("plutonium.kanban.column.more", count: more_count)
             end
           end
         end
@@ -296,10 +296,10 @@ module Plutonium
           link_to(
             @column_add_url,
             class: "pu-btn pu-btn-ghost pu-btn-xs text-[var(--pu-text-muted)]",
-            title: "Add to #{column.label}",
+            title: t("plutonium.kanban.column.add_to", column: column.label),
             data: {turbo_frame: Plutonium::REMOTE_MODAL_FRAME}
           ) do
-            plain "+ Add"
+            plain t("plutonium.kanban.column.add")
           end
         end
 

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

@@ -21,7 +21,7 @@ module Plutonium
 
         private
 
-        def lang = nil
+        def lang = I18n.locale.to_s
 
         def page_title = view_context.controller.instance_variable_get(:@page_title)
 
@@ -35,6 +35,7 @@ module Plutonium
           head {
             render_title
             render_metatags
+            render_i18n
             render_assets
             render_pre_paint_scripts
           }
@@ -175,6 +176,23 @@ module Plutonium
           render_scripts
         end
 
+        # The `plutonium.js` locale subtree as JSON for src/js/i18n.js, in a
+        # <meta> rather than a <script>: Turbo Drive replaces provisional head
+        # elements on every visit but only ever appends scripts, so a locale
+        # switch mid-session would otherwise keep serving the first blob.
+        #
+        # Merged over the default locale so a partially translated locale
+        # falls back per key instead of dropping every untranslated string.
+        def render_i18n
+          meta(name: "pu-i18n", content: i18n_blob.to_json)
+        end
+
+        def i18n_blob
+          defaults = I18n.t("plutonium.js", locale: I18n.default_locale, default: {})
+          current = (I18n.locale == I18n.default_locale) ? {} : I18n.t("plutonium.js", default: {})
+          defaults.deep_merge(current)
+        end
+
         def render_styles
           render_external_styles
 

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

@@ -109,7 +109,7 @@ module Plutonium
             render Phlex::TablerIcons::X.new(class: "w-6 h-6")
           end
 
-          span(class: "sr-only") { "Toggle sidebar" }
+          span(class: "sr-only") { t("plutonium.ui.layout.toggle_sidebar") }
         end
 
         # Renders the action buttons section

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

@@ -38,7 +38,7 @@ module Plutonium
           aside(
             id: "sidebar-navigation",
             data: {controller: "sidebar icon-rail"},
-            aria: {label: "Sidebar Navigation"},
+            aria: {label: t("plutonium.ui.layout.sidebar_navigation")},
             class: "fixed top-0 left-0 z-40 h-dvh " \
                    "bg-[var(--pu-surface)] border-r border-[var(--pu-border)] " \
                    "flex flex-col transition-[width] duration-200 overflow-x-hidden " \
@@ -56,7 +56,7 @@ module Plutonium
           div(class: "h-12 flex items-center justify-center border-b border-[var(--pu-border)] shrink-0") do
             next unless brand_slot?
 
-            a(href: root_path, aria: {label: "Home"}, class: "flex items-center justify-center") do
+            a(href: root_path, aria: {label: t("plutonium.ui.home")}, class: "flex items-center justify-center") do
               render brand_slot
             end
           end
@@ -81,8 +81,8 @@ module Plutonium
         def render_pin_button
           button(
             type: "button",
-            title: "Toggle sidebar",
-            aria: {label: "Toggle sidebar pin"},
+            title: t("plutonium.ui.layout.toggle_sidebar"),
+            aria: {label: t("plutonium.ui.layout.toggle_sidebar_pin")},
             data: {action: "icon-rail#togglePin"},
             class: "flex items-center justify-center w-10 h-10 rounded-md transition-colors " \
                    "text-[var(--pu-text-muted)] hover:text-[var(--pu-text)] hover:bg-[var(--pu-surface-alt)]"

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

@@ -45,7 +45,7 @@ module Plutonium
         def render_links
           link_to root_path, class: "mt-4 inline-flex items-center gap-1.5 font-medium text-secondary-600 dark:text-secondary-400 hover:underline transition-colors" do
             render Phlex::TablerIcons::Home2.new(class: "size-5")
-            plain "Home"
+            plain t("plutonium.ui.home")
           end
         end
       end

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

@@ -17,7 +17,7 @@ module Plutonium
           aside(
             data: {controller: "sidebar"},
             id: "sidebar-navigation",
-            aria: {label: "Sidebar Navigation"},
+            aria: {label: t("plutonium.ui.layout.sidebar_navigation")},
             class: "fixed top-0 left-0 z-40 w-64 h-dvh pt-14 transition-transform -translate-x-full lg:translate-x-0"
           ) do
             div(

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

@@ -55,7 +55,7 @@ module Plutonium
             type: "button",
             data_action: "resource-header#toggleDrawer",
             aria_controls: "#sidebar-navigation",
-            aria_label: "Toggle sidebar",
+            aria_label: t("plutonium.ui.layout.toggle_sidebar"),
             class: "p-1.5 -ml-1.5 text-[var(--pu-text-muted)] rounded-md " \
                    "hover:text-[var(--pu-text)] hover:bg-[var(--pu-surface-alt)] " \
                    "lg:hidden transition-colors"
@@ -71,7 +71,7 @@ module Plutonium
           span(data_resource_header_target: "closeIcon", class: "hidden", aria_hidden: "true") do
             render Phlex::TablerIcons::X.new(class: "w-5 h-5")
           end
-          span(class: "sr-only") { "Toggle sidebar" }
+          span(class: "sr-only") { t("plutonium.ui.layout.toggle_sidebar") }
         end
 
         def render_breadcrumbs_section

data/lib/plutonium/ui/modal/base.rb

@@ -60,7 +60,7 @@ module Plutonium
           if @title
             attrs[:"aria-labelledby"] = title_id
           else
-            attrs[:"aria-label"] = "Dialog"
+            attrs[:"aria-label"] = t("plutonium.ui.modal.dialog")
           end
           attrs[:"aria-describedby"] = description_id if @description.present?
           attrs
@@ -130,8 +130,8 @@ module Plutonium
             target: "_blank",
             rel: "noopener",
             class: "p-1.5 text-[var(--pu-text-muted)] hover:text-[var(--pu-text)] hover:bg-[var(--pu-surface-alt)] rounded-md transition-colors",
-            "aria-label": "Open full page in a new tab",
-            title: "Open full page"
+            "aria-label": t("plutonium.ui.modal.open_full_page_new_tab"),
+            title: t("plutonium.ui.modal.open_full_page")
           ) do
             render Phlex::TablerIcons::ArrowsDiagonal.new(class: "w-5 h-5")
           end
@@ -145,7 +145,7 @@ module Plutonium
               type: "button",
               class: "p-1.5 text-[var(--pu-text-muted)] hover:text-[var(--pu-text)] hover:bg-[var(--pu-surface-alt)] rounded-md transition-colors",
               data: {action: "remote-modal#close"},
-              "aria-label": "Close dialog"
+              "aria-label": t("plutonium.ui.modal.close")
             ) do
               render Phlex::TablerIcons::X.new(class: "w-5 h-5")
             end

data/lib/plutonium/ui/nav_grid_menu.rb

@@ -70,7 +70,7 @@ module Plutonium
           data: {resource_drop_down_target: "trigger"},
           class: "p-2 text-[var(--pu-text-muted)] rounded-[var(--pu-radius-md)] hover:text-[var(--pu-text)] hover:bg-[var(--pu-surface-alt)] focus:ring-2 focus:ring-[var(--pu-border)] transition-colors"
         ) do
-          span(class: "sr-only") { "View #{@label}" }
+          span(class: "sr-only") { t("plutonium.ui.nav_grid_menu.view", label: @label) }
           render @icon.new(class: "w-6 h-6")
         end
       end

data/lib/plutonium/ui/nav_user.rb

@@ -76,8 +76,8 @@ module Plutonium
           id: "user-nav-dropdown-toggle",
           data: {resource_drop_down_target: "trigger"}
         ) do
-          span(class: "sr-only") { "Open user menu" }
-          Avatar(@record, src: @avatar_url, size: :sm, alt: "avatar", class: "ring-2 ring-[var(--pu-border)]")
+          span(class: "sr-only") { t("plutonium.ui.nav_user.open_menu") }
+          Avatar(@record, src: @avatar_url, size: :sm, alt: t("plutonium.ui.nav_user.avatar_alt"), class: "ring-2 ring-[var(--pu-border)]")
         end
       end
 

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

@@ -64,11 +64,19 @@ module Plutonium
         end
 
         def render_page_header
-          return unless page_title
+          return unless resolved_page_title
 
-          PageHeader(title: page_title, description: page_description, actions: page_actions)
+          PageHeader(title: resolved_page_title, description: resolved_page_description, actions: page_actions)
         end
 
+        # Titles and descriptions may be lazy translations (a proc built by
+        # the definition's `t`). Every surface that renders them (the page
+        # header, the modal chrome) goes through these so the lookup runs in
+        # the request's locale, the same way inputs and labels are resolved.
+        def resolved_page_title = Plutonium::Translation.resolve(page_title)
+
+        def resolved_page_description = Plutonium::Translation.resolve(page_description)
+
         def render_toolbar
           # Implement toolbar content
         end

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

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Plutonium
+  module UI
+    module Page
+      # The page a registered dashboard renders: the standard page header
+      # (title + description from `presents`) over the card grid. Keeps the
+      # `render_before_*` / `render_after_*` hooks of {Base} so an app can
+      # subclass it and add a toolbar or footer without owning the grid.
+      class Dashboard < Base
+        def initialize(dashboard:)
+          @dashboard = dashboard
+          super(page_title: dashboard.class.label, page_description: dashboard.class.description)
+        end
+
+        def view_template(&)
+          DynaFrameContent() do
+            div(class: tokens("pu-dashboard-page", width_classes)) do
+              render_before_header
+              render_header
+              render_after_header
+
+              render_before_content
+              render_content
+              render_after_content
+
+              render_before_footer
+              render_footer
+              render_after_footer
+            end
+          end
+        end
+
+        private
+
+        attr_reader :dashboard
+
+        def render_content
+          render Plutonium::UI::Dashboard::Board.new(dashboard:)
+        end
+
+        # A dashboard has no resource definition to consult and is its own
+        # navigation root, so it never renders a breadcrumb trail.
+        def render_breadcrumbs? = false
+
+        def width_classes
+          Plutonium::UI::PageWidth.classes_for(dashboard.class.width)
+        end
+
+        def page_type = :dashboard
+      end
+    end
+  end
+end

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

@@ -7,7 +7,7 @@ module Plutonium
         private
 
         def page_title
-          current_definition.edit_page_title || super || "Edit #{resource_name(resource_class, 1)}"
+          current_definition.edit_page_title || super || t("plutonium.ui.page.edit_title", resource: resource_name(resource_class, 1))
         end
 
         def page_description
@@ -25,8 +25,8 @@ module Plutonium
         def render_modal_form
           modal_class = Plutonium::UI::Modal::Base.class_for_mode(current_definition.modal_mode)
           render modal_class.new(
-            title: page_title,
-            description: page_description,
+            title: resolved_page_title,
+            description: resolved_page_description,
             size: current_definition.modal_size,
             # Opens this form standalone in a NEW TAB (target=_blank), so the
             # modal — and anything already typed into it — stays put.

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

@@ -23,8 +23,8 @@ module Plutonium
             )
 
             render modal_class.new(
-              title: page_title,
-              description: page_description,
+              title: resolved_page_title,
+              description: resolved_page_description,
               size: current_interactive_action.modal_size(current_definition),
               # The action's own GET path renders the standalone branch below,
               # and opens in a NEW TAB, so the modal keeps whatever has already

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

@@ -7,7 +7,7 @@ module Plutonium
         private
 
         def page_title
-          current_definition.new_page_title || super || "New #{resource_name(resource_class, 1)}"
+          current_definition.new_page_title || super || t("plutonium.ui.page.new_title", resource: resource_name(resource_class, 1))
         end
 
         def page_description
@@ -25,8 +25,8 @@ module Plutonium
         def render_modal_form
           modal_class = Plutonium::UI::Modal::Base.class_for_mode(current_definition.modal_mode)
           render modal_class.new(
-            title: page_title,
-            description: page_description,
+            title: resolved_page_title,
+            description: resolved_page_description,
             size: current_definition.modal_size,
             # Opens this form standalone in a NEW TAB (target=_blank), so the
             # modal — and anything already typed into it — stays put.