From 2b53fcd7424e5ecc1b9159bb2f77bb98365510f3 Mon Sep 17 00:00:00 2001
From: iris <iris@hyperhive.local>
Date: Fri, 6 Nov 2026 17:59:32 +0100
Subject: [PATCH] fixup! swarm-ui: shared Hint, ActionRow, Toolbar, EmptyState,
 ExternalLink and ExpandableCard replace per-page copies

---
 .../swarm-ui/src/pages/ComponentsPage.tsx     |  4 ++--
 .../swarm-ui/src/pages/builds/BuildsPage.tsx  |  8 ++-----
 .../src/pages/review-runs/ReviewRuns.tsx      |  8 ++-----
 .../src/ui/expandable-card/ExpandableCard.tsx | 23 ++++++++++++++++++-
 .../packages/swarm-ui/src/ui/hint/Hint.tsx    |  6 ++---
 5 files changed, 31 insertions(+), 18 deletions(-)

diff --git a/frontend/packages/swarm-ui/src/pages/ComponentsPage.tsx b/frontend/packages/swarm-ui/src/pages/ComponentsPage.tsx
index b5820d63..c26c4018 100644
--- a/frontend/packages/swarm-ui/src/pages/ComponentsPage.tsx
+++ b/frontend/packages/swarm-ui/src/pages/ComponentsPage.tsx
@@ -38,7 +38,7 @@ import { ActionRow } from "../ui/action-row/ActionRow.js";
 import { EmptyState } from "../ui/empty-state/EmptyState.js";
 import {
   ExpandableCard,
-  ExpandableCardSkeleton,
+  ExpandableCardListSkeleton,
 } from "../ui/expandable-card/ExpandableCard.js";
 import { ExternalLink } from "../ui/external-link/ExternalLink.js";
 import { Hint, type HintTone } from "../ui/hint/Hint.js";
@@ -653,7 +653,7 @@ export function ComponentsPage() {
           >
             <Hint>The body appears while the card is open.</Hint>
           </ExpandableCard>
-          <ExpandableCardSkeleton />
+          <ExpandableCardListSkeleton label="the builds" count={1} />
         </Sample>
       </Section>
 
diff --git a/frontend/packages/swarm-ui/src/pages/builds/BuildsPage.tsx b/frontend/packages/swarm-ui/src/pages/builds/BuildsPage.tsx
index 7ee6b5c8..da5a3b26 100644
--- a/frontend/packages/swarm-ui/src/pages/builds/BuildsPage.tsx
+++ b/frontend/packages/swarm-ui/src/pages/builds/BuildsPage.tsx
@@ -12,7 +12,7 @@ import { Badge } from "@hive/shared/badge.js";
 import { EmptyState } from "../../ui/empty-state/EmptyState.js";
 import {
   ExpandableCard,
-  ExpandableCardSkeleton,
+  ExpandableCardListSkeleton,
 } from "../../ui/expandable-card/ExpandableCard.js";
 import { Hint } from "../../ui/hint/Hint.js";
 import { Toolbar } from "../../ui/toolbar/Toolbar.js";
@@ -163,11 +163,7 @@ function BuildsBody() {
       ) : null}
       <div class="ui-builds-list">
         {runs === null && !error ? (
-          <>
-            <ExpandableCardSkeleton />
-            <ExpandableCardSkeleton />
-            <ExpandableCardSkeleton />
-          </>
+          <ExpandableCardListSkeleton label="the builds" />
         ) : null}
         {(runs ?? []).map((run) => (
           <BuildCard
diff --git a/frontend/packages/swarm-ui/src/pages/review-runs/ReviewRuns.tsx b/frontend/packages/swarm-ui/src/pages/review-runs/ReviewRuns.tsx
index 55d602bf..e19422a8 100644
--- a/frontend/packages/swarm-ui/src/pages/review-runs/ReviewRuns.tsx
+++ b/frontend/packages/swarm-ui/src/pages/review-runs/ReviewRuns.tsx
@@ -11,7 +11,7 @@ import { EmptyState } from "../../ui/empty-state/EmptyState.js";
 import { ExternalLink } from "../../ui/external-link/ExternalLink.js";
 import {
   ExpandableCard,
-  ExpandableCardSkeleton,
+  ExpandableCardListSkeleton,
 } from "../../ui/expandable-card/ExpandableCard.js";
 import { Hint } from "../../ui/hint/Hint.js";
 import { Panel } from "../../ui/panel/Panel.js";
@@ -141,11 +141,7 @@ export function ReviewRuns() {
       ) : null}
       <div class="ui-runs-list">
         {runs === null && !error ? (
-          <>
-            <ExpandableCardSkeleton metaOnOwnRow />
-            <ExpandableCardSkeleton metaOnOwnRow />
-            <ExpandableCardSkeleton metaOnOwnRow />
-          </>
+          <ExpandableCardListSkeleton label="the runs" metaOnOwnRow />
         ) : null}
         {(runs ?? []).map((run) => (
           <RunCard
diff --git a/frontend/packages/swarm-ui/src/ui/expandable-card/ExpandableCard.tsx b/frontend/packages/swarm-ui/src/ui/expandable-card/ExpandableCard.tsx
index 9f5c5482..ffd3dfbf 100644
--- a/frontend/packages/swarm-ui/src/ui/expandable-card/ExpandableCard.tsx
+++ b/frontend/packages/swarm-ui/src/ui/expandable-card/ExpandableCard.tsx
@@ -10,8 +10,10 @@
 //
 // `ExpandableCardSkeleton` is its twin for a list that is loading: the same
 // card and the same head layout with a placeholder in each slot.
+// `ExpandableCardListSkeleton` is a few of them in a `SkeletonRegion`, so
+// assistive tech hears once that the list is loading.
 import type { ComponentChildren } from "preact";
-import { Skeleton } from "../skeleton/Skeleton.js";
+import { Skeleton, SkeletonRegion } from "../skeleton/Skeleton.js";
 import { Card } from "../card/Card.js";
 import "./ExpandableCard.css";
 
@@ -92,6 +94,25 @@ export function ExpandableCard({
   );
 }
 
+export function ExpandableCardListSkeleton({
+  label,
+  count = 3,
+  metaOnOwnRow = false,
+}: {
+  /** What is loading, as a screen reader says it: "the builds". */
+  label: string;
+  count?: number;
+  metaOnOwnRow?: boolean;
+}) {
+  return (
+    <SkeletonRegion label={label}>
+      {Array.from({ length: count }, (_, i) => (
+        <ExpandableCardSkeleton key={i} metaOnOwnRow={metaOnOwnRow} />
+      ))}
+    </SkeletonRegion>
+  );
+}
+
 export function ExpandableCardSkeleton({
   metaOnOwnRow = false,
 }: {
diff --git a/frontend/packages/swarm-ui/src/ui/hint/Hint.tsx b/frontend/packages/swarm-ui/src/ui/hint/Hint.tsx
index 48025cd3..de5f7637 100644
--- a/frontend/packages/swarm-ui/src/ui/hint/Hint.tsx
+++ b/frontend/packages/swarm-ui/src/ui/hint/Hint.tsx
@@ -3,9 +3,9 @@
 // for what each form and card used to restyle under its own class name, so
 // "muted", "warning", "error" and "ok" mean the same colour everywhere.
 //
-// `error` and `warn` are read out when they appear (`role="alert"` for an
-// error); the others are plain text unless the caller passes a `role`, such as
-// `status` for a line that changes after a save. `class` is for a page's
+// `error` is read out when it appears (`role="alert"`); the other tones are
+// plain text unless the caller passes a `role`, such as `status` for a line
+// that changes after a save. `class` is for a page's
 // layout around the hint (a margin, a width), not for its colour.
 import type { ComponentChildren } from "preact";
 import "./Hint.css";