Adopt semantic dashboard action states

src/govoplan_dashboard/backend/manifest.py

@@ -156,7 +156,10 @@ manifest = ModuleManifest(
             body=(
                 "A Dashboard layout belongs to the active tenant, account, and focused View. "
                 "Configuring changes only a local draft until Save layout is selected; Cancel or "
-                "Discard restores the last saved arrangement. Widget removal removes only the placement, "
+                "Discard restores the last saved arrangement. The page action bar always reports whether "
+                "the draft is saved, unsaved, or currently saving; Save and Cancel remain visible in stable "
+                "positions and are disabled with an explanation when no draft change exists. Leaving while "
+                "dirty invokes the shared save-or-discard guard. Widget removal removes only the placement, "
                 "not the module data represented by the widget. Reset restores the defaults announced by "
                 "currently active modules and remains reversible until save. A widget is offered only when "
                 "its module, focused View surface, and permission contract are available. Widgets never grant "

webui/src/features/dashboard/DashboardPage.tsx

@@ -16,6 +16,7 @@ import {
   DocumentationHelpLink,
   LoadingFrame,
   MetricCard,
+  PageActionBar,
   PageLayout,
   dashboardWidgetsForModules,
   hasAnyScope,
@@ -443,53 +444,46 @@ export default function DashboardPage({
 
   return (
     <PageLayout
+      archetype={configuring ? "editor" : "overview"}
       className="dashboard-page"
       title="i18n:govoplan-dashboard.dashboard.3f8b4df2"
       description="Personal workspace assembled from installed module widgets."
       error={error}
       success={error ? "" : notice}
-      actions={
+      actions={configuring ? (
-        <>
+        <PageActionBar
-            <DocumentationHelpLink reference={DASHBOARD_DOCUMENTATION} />
+          variant="editor"
-            {!configuring && (
+          dirty={dirty}
-              <>
+          saving={saving}
-                <Button
+          helpAction={<DocumentationHelpLink reference={DASHBOARD_DOCUMENTATION} />}
-                  onClick={() => setRefreshKey((value) => value + 1)}
+          discardAction={{ label: <><X size={16} /> Cancel</>, onClick: discardChanges }}
-                  disabled={loading}
+          saveAction={{ label: <><Save size={16} /> Save layout</>, onClick: () => void persistLayout() }}
-                  disabledReason={loading ? DASHBOARD_I18N.loading : undefined}
+        />
-                >
+      ) : (
-                  <RefreshCw size={16} /> Refresh
+        <PageActionBar
-                </Button>
+          variant="overview"
-                <Button
+          refreshable
-                  onClick={beginConfiguration}
+          reloadAction={(
-                  disabled={loading}
+            <Button
-                  disabledReason={loading ? DASHBOARD_I18N.loading : undefined}
+              onClick={() => setRefreshKey((value) => value + 1)}
-                >
+              disabled={loading}
-                  <SlidersHorizontal size={16} /> Configure
+              disabledReason={loading ? DASHBOARD_I18N.loading : undefined}
-                </Button>
+            >
-              </>
+              <RefreshCw size={16} /> Refresh
-            )}
+            </Button>
-            {configuring && (
+          )}
-              <>
+          helpAction={<DocumentationHelpLink reference={DASHBOARD_DOCUMENTATION} />}
-                <Button
+          primaryActions={(
-                  onClick={discardChanges}
+            <Button
-                  disabled={saving}
+              onClick={beginConfiguration}
-                  disabledReason={saving ? DASHBOARD_I18N.saving : undefined}
+              disabled={loading}
-                >
+              disabledReason={loading ? DASHBOARD_I18N.loading : undefined}
-                  <X size={16} /> Cancel
+            >
-                </Button>
+              <SlidersHorizontal size={16} /> Configure
-                <Button
+            </Button>
-                  variant="primary"
+          )}
-                  onClick={() => void persistLayout()}
+        />
-                  disabled={saving || !dirty}
+      )}
-                  disabledReason={saving ? DASHBOARD_I18N.saving : !dirty ? DASHBOARD_I18N.noChanges : undefined}
-                >
-                  <Save size={16} /> {saving ? "Saving..." : "Save layout"}
-                </Button>
-              </>
-            )}
-        </>
-      }
     >
 
         <MetricGrid className="dashboard-summary-metrics">