From e494cff561e54d5909deaa4c38840865717aad3b Mon Sep 17 00:00:00 2001
From: Albrecht Degering <albrecht@degering.name>
Date: Tue, 18 Aug 2026 13:17:31 +0200
Subject: [PATCH] Adopt shared WebUI structural primitives

---
 webui/src/features/forms/FormInstancePage.tsx |  7 +-
 webui/src/features/forms/FormsRuntimePage.tsx | 31 ++++---
 webui/src/styles/forms-runtime.css            | 88 +------------------
 3 files changed, 20 insertions(+), 106 deletions(-)

diff --git a/webui/src/features/forms/FormInstancePage.tsx b/webui/src/features/forms/FormInstancePage.tsx
index 94a71ce..20d9dae 100644
--- a/webui/src/features/forms/FormInstancePage.tsx
+++ b/webui/src/features/forms/FormInstancePage.tsx
@@ -18,6 +18,7 @@ import { ActionToolbar,
   usePlatformModuleInstalled,
   usePlatformLanguage,
   useUnsavedDraftGuard,
+  WorkspaceFrame,
   type PlatformRouteContext
 } from "@govoplan/core-webui";
 import {
@@ -310,8 +311,8 @@ export default function FormInstancePage({ settings, auth }: PlatformRouteContex
 
   return (
     <main className="forms-runtime-page">
-      <div className="form-instance-shell">
-        <ActionToolbar className="form-instance-toolbar">
+      <WorkspaceFrame className="form-instance-shell" label="Form instance" interfaceId="forms-runtime.instance" helpContextId="forms-runtime.page.instance" helpModuleId="forms-runtime">
+        <ActionToolbar surface="panel-header" className="form-instance-toolbar">
           <Button onClick={() => navigate("/forms-runtime")}>
             <ArrowLeft size={16} aria-hidden="true" />
             Forms
@@ -527,7 +528,7 @@ export default function FormInstancePage({ settings, auth }: PlatformRouteContex
             </div>
           }
         </PageScrollViewport>
-      </div>
+      </WorkspaceFrame>
       <ConfirmDialog
         open={confirmingAcknowledgement}
         title="Record acknowledgement"
diff --git a/webui/src/features/forms/FormsRuntimePage.tsx b/webui/src/features/forms/FormsRuntimePage.tsx
index a7395f4..8371b68 100644
--- a/webui/src/features/forms/FormsRuntimePage.tsx
+++ b/webui/src/features/forms/FormsRuntimePage.tsx
@@ -6,11 +6,16 @@ import { ActionToolbar,
   DismissibleAlert,
   LoadingIndicator,
   PageScrollViewport,
+  SelectionList,
+  SelectionListItem,
+  SelectionListItemContent,
+  StatePanel,
   StatusBadge,
   hasScope,
   i18nMessage,
   useGuardedNavigate,
   usePlatformLanguage,
+  WorkspaceFrame,
   type PlatformRouteContext
 } from "@govoplan/core-webui";
 import { listFormInstances, type FormInstance } from "../../api/formsRuntime";
@@ -57,8 +62,8 @@ export default function FormsRuntimePage({ settings, auth }: PlatformRouteContex
 
   return (
     <main className="forms-runtime-page">
-      <div className="forms-runtime-shell">
-        <ActionToolbar className="forms-runtime-toolbar">
+      <WorkspaceFrame className="forms-runtime-shell" label="Forms runtime" interfaceId="forms-runtime.workspace" helpContextId="forms-runtime.page.workspace" helpModuleId="forms-runtime">
+        <ActionToolbar surface="panel-header" className="forms-runtime-toolbar">
           <Button onClick={() => void load()} disabled={loading} disabledReason={loading ? FORMS_RUNTIME_I18N.loading : undefined}>
             <RefreshCw size={16} aria-hidden="true" />
             Refresh
@@ -94,29 +99,23 @@ export default function FormsRuntimePage({ settings, auth }: PlatformRouteContex
           }
           {loading && <LoadingIndicator label="Loading forms" />}
           {!loading && !error && items.length === 0 &&
-            <div className="forms-runtime-empty">No matching Forms.</div>
+            <StatePanel size="compact" description="No matching Forms." />
           }
           {!loading && items.length > 0 &&
-            <div className="forms-runtime-list" role="list">
+            <SelectionList variant="navigation" label="Forms">
               {items.map((item) =>
-                <button
-                  type="button"
-                  role="listitem"
-                  className="forms-runtime-row"
+                <SelectionListItem
                   key={item.instance_id}
+                  selected={false}
                   onClick={() => navigate(`/forms-runtime/${encodeURIComponent(item.instance_id)}`)}>
-                  <span className="forms-runtime-row-main">
-                    <strong>{item.definition_ref.label ?? humanize(item.definition_ref.object_id)}</strong>
-                    <span>Revision {item.definition_ref.version ?? "-"}</span>
-                  </span>
-                  <span>{formatDateTime(item.recorded_at, language)}</span>
+                  <SelectionListItemContent title={item.definition_ref.label ?? humanize(item.definition_ref.object_id)} description={`Revision ${item.definition_ref.version ?? "-"} · ${formatDateTime(item.recorded_at, language)}`} />
                   <StatusBadge status={isOpen(item.status) ? "active" : "inactive"} label={stateLabel(item.status)} />
-                </button>
+                </SelectionListItem>
               )}
-            </div>
+            </SelectionList>
           }
         </PageScrollViewport>
-      </div>
+      </WorkspaceFrame>
       <IntakeProfilesDialog open={intakeOpen} settings={settings} onClose={() => setIntakeOpen(false)} />
     </main>
   );
diff --git a/webui/src/styles/forms-runtime.css b/webui/src/styles/forms-runtime.css
index 1e56b0b..81f8d6a 100644
--- a/webui/src/styles/forms-runtime.css
+++ b/webui/src/styles/forms-runtime.css
@@ -1,29 +1,9 @@
-.forms-runtime-page,
-.forms-runtime-shell,
-.form-instance-shell {
+.forms-runtime-page {
   height: 100%;
   min-height: 0;
   overflow: hidden;
 }
 
-.forms-runtime-shell,
-.form-instance-shell {
-  display: flex;
-  flex-direction: column;
-  background: var(--surface);
-}
-
-.forms-runtime-toolbar,
-.form-instance-toolbar {
-  display: flex;
-  align-items: center;
-  gap: 14px;
-  min-height: 58px;
-  padding: 10px 18px;
-  border-bottom: 1px solid var(--border);
-  background: var(--surface-raised);
-}
-
 .forms-runtime-toolbar label {
   display: flex;
   align-items: center;
@@ -53,64 +33,6 @@
   margin: 0 auto 16px;
 }
 
-.forms-runtime-list {
-  overflow: hidden;
-  border: 1px solid var(--border);
-  border-radius: 6px;
-  background: var(--surface-raised);
-}
-
-.forms-runtime-row {
-  display: grid;
-  grid-template-columns: minmax(260px, 1fr) minmax(170px, auto) auto;
-  align-items: center;
-  gap: 16px;
-  width: 100%;
-  min-height: 64px;
-  padding: 10px 14px;
-  border: 0;
-  border-bottom: 1px solid var(--border);
-  background: transparent;
-  color: inherit;
-  text-align: left;
-  cursor: pointer;
-}
-
-.forms-runtime-row:last-child {
-  border-bottom: 0;
-}
-
-.forms-runtime-row:hover,
-.forms-runtime-row:focus-visible {
-  background: var(--hover-bg);
-}
-
-.forms-runtime-row-main {
-  display: flex;
-  min-width: 0;
-  flex-direction: column;
-  gap: 3px;
-}
-
-.forms-runtime-row-main strong,
-.forms-runtime-row-main span {
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-
-.forms-runtime-row-main span,
-.forms-runtime-row > span:not(.status-badge) {
-  color: var(--text-soft);
-  font-size: 0.84rem;
-}
-
-.forms-runtime-empty {
-  padding: 36px 0;
-  color: var(--text-soft);
-  text-align: center;
-}
-
 .form-instance-content {
   display: grid;
   grid-template-columns: minmax(0, 1fr) minmax(280px, 360px);
@@ -545,14 +467,6 @@
 }
 
 @media (max-width: 860px) {
-  .forms-runtime-row {
-    grid-template-columns: minmax(0, 1fr) auto;
-  }
-
-  .forms-runtime-row > span:not(.forms-runtime-row-main, .status-badge) {
-    display: none;
-  }
-
   .form-instance-content {
     grid-template-columns: 1fr;
   }