swarm-ui: page shell + layout primitives

Structural foundation split out of hyperhive#3118 per mara's steer:
structure first so the real overview page (hive roster) and later
routes (swarm-wide agent roster) land as content changes rather than
each reinventing chrome + nav + a table/panel/chip shape.

- <Shell>: header bar (branding) + nav row, wraps every route. Route
  list lives in Shell itself (one small SPA, one place to know its
  own nav).
- ui/Panel, ui/StatusChip, ui/Table: the three primitives the
  overview page's actual scope (hive roster: name/domain/status,
  linking out to each hive's own dashboard) calls for, nothing
  speculative beyond that.

Preact-native styling (plain CSS files imported via swarm-ui.css, no
shadow DOM — this package renders into light DOM) — not
@hive/shared's chrome.css, which is the old MPA dashboard's visual
language. Same base16/Catppuccin color tokens via theme.css/colors.css
so it still reads as hyperhive.

npm run build (whole frontend workspace) + npm run typecheck both
clean. Verified with a real headless-chromium screenshot against the
built dist, not just source-reading.

Fixes hyperhive#3211
This commit is contained in:
iris 2026-08-12 21:05:12 +02:00 committed by mara
commit 67eb0c660d
10 changed files with 224 additions and 29 deletions

View file

@ -0,0 +1,15 @@
.ui-panel {
border: 1px solid var(--border);
border-radius: 0.5em;
background: var(--bg-elev);
}
.ui-panel-title {
margin: 0;
padding: 0.75em 1em;
font-size: 1em;
font-weight: 600;
border-bottom: 1px solid var(--border);
}
.ui-panel-body {
padding: 1em;
}

View file

@ -0,0 +1,14 @@
// <Panel> — the one generic container primitive every route needs: a
// bordered surface with an optional title, no other opinions. Not a
// card-with-actions/footer/whatever kit — those get added the first
// time a real page actually needs one, not speculatively ahead of it.
import type { ComponentChildren } from 'preact';
export function Panel({ title, children }: { title?: string; children: ComponentChildren }) {
return (
<section class="ui-panel">
{title ? <h2 class="ui-panel-title">{title}</h2> : null}
<div class="ui-panel-body">{children}</div>
</section>
);
}

View file

@ -0,0 +1,21 @@
.ui-chip {
display: inline-block;
padding: 0.15em 0.6em;
border-radius: 1em;
font-size: 0.85em;
line-height: 1.4;
background: var(--purple-dim);
color: var(--fg);
}
.ui-chip-neutral {
color: var(--muted);
}
.ui-chip-positive {
color: var(--green);
}
.ui-chip-warning {
color: var(--amber);
}
.ui-chip-negative {
color: var(--red);
}

View file

@ -0,0 +1,11 @@
// <StatusChip> — a small labelled state indicator. Generic over
// `tone` rather than a fixed status vocabulary (`online`/`offline`/…)
// because the first real caller (the hive roster) starts with a
// single static "configured" tone and grows real online/stale/offline
// states once a status rollup lands server-side — same component,
// richer data later, no rebuild.
export type ChipTone = 'neutral' | 'positive' | 'warning' | 'negative';
export function StatusChip({ tone = 'neutral', label }: { tone?: ChipTone; label: string }) {
return <span class={'ui-chip ui-chip-' + tone}>{label}</span>;
}

View file

@ -0,0 +1,18 @@
.ui-table {
width: 100%;
border-collapse: collapse;
}
.ui-table th {
text-align: left;
font-weight: 600;
color: var(--muted);
padding: 0.5em 0.75em;
border-bottom: 1px solid var(--border);
}
.ui-table td {
padding: 0.5em 0.75em;
border-bottom: 1px solid var(--border);
}
.ui-table tr:last-child td {
border-bottom: none;
}

View file

@ -0,0 +1,43 @@
// <Table> — a generic column-defined table, the shape the hive roster
// (name / domain / status chip, one row per hive) needs. Columns own
// their own cell rendering rather than this component knowing about
// any particular row shape, so it stays reusable for the swarm-wide
// agent roster later without a rewrite.
import type { ComponentChildren } from 'preact';
export interface TableColumn<T> {
key: string;
header: string;
render: (row: T) => ComponentChildren;
}
export function Table<T>({
columns,
rows,
rowKey,
}: {
columns: TableColumn<T>[];
rows: T[];
rowKey: (row: T) => string;
}) {
return (
<table class="ui-table">
<thead>
<tr>
{columns.map((c) => (
<th key={c.key}>{c.header}</th>
))}
</tr>
</thead>
<tbody>
{rows.map((row) => (
<tr key={rowKey(row)}>
{columns.map((c) => (
<td key={c.key}>{c.render(row)}</td>
))}
</tr>
))}
</tbody>
</table>
);
}