feat(maestro): terminal-native web UI pass + design kit
ci / rust (push) Successful in 4m26s

Live-review iteration on the browser SPA, driven by crit feedback.

Sidebar / session tree
- Compact single-line leaf rows; status shown as a faint "alive" row wash
  instead of per-row dots (exited rows dim + keep the "exited" badge).
- Host is now the first level of nesting (host → label path → session); the
  inline @daemon is dropped from rows.
- Flush, borderless search input spanning the sidebar; drag-to-resize grip on
  the sidebar edge (width persisted to localStorage); narrower default.
- Per-row clone action (opens the spawn modal prefilled); right-pointing
  chevron when collapsed.

Chrome / layout
- Buttons swapped to a bracket terminal style ([ + Spawn ]); ghost/icon drop
  the brackets. Old filled styles removed.
- Squared corners globally (radius tokens) and tighter, denser spacing.
- Session tally + daemon chips moved into the centered app header.
- Shorter control height; shared --bar-h aligns the search and attach bars.

Attach / terminal
- Useful attach title (name · command @ host) over a bare UUID.
- Robust fit: compute columns from the viewport's scrollbar-excluded
  clientWidth (fixes mobile under-fit and desktop overflow); ResizeObserver +
  font-load refit; full-bleed terminal on mobile.

Spawn / empty states
- Spawn modal accepts a prefill (clone); real "+ Spawn" buttons in welcome and
  no-sessions empty states.

Dev
- New ?kit design-kit page (kit.ts/kit.css, DEV-only) showcasing components.
- Richer ?mock fixture with deeper label nesting.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-06-20 12:11:43 +00:00
co-authored by Claude Opus 4.8
parent eb2162889e
commit c02ff02849
9 changed files with 1130 additions and 164 deletions
+272
View File
@@ -0,0 +1,272 @@
// Dev-only design kit. Lazily imported behind `import.meta.env.DEV` from
// main.ts (`?kit`), so it never ships in a production bundle. Renders every
// component specimen on one scrollable page so the visual system can be
// critiqued as a whole — buttons (including terminal-native variants for
// review), inputs, chips, badges, session rows, and empty states.
import "./kit.css";
import { createThemeToggle } from "./theme.js";
function h(tag: string, className?: string, html?: string): HTMLElement {
const el = document.createElement(tag);
if (className) el.className = className;
if (html != null) el.innerHTML = html;
return el;
}
/** A titled section with an optional note and a content host. */
function section(title: string, note?: string): { el: HTMLElement; body: HTMLElement } {
const el = h("section", "kit-section");
const head = h("div", "kit-section-head");
head.appendChild(h("h2", "kit-section-title", title));
if (note) head.appendChild(h("p", "kit-section-note", note));
el.appendChild(head);
const body = h("div", "kit-row");
el.appendChild(body);
return { el, body };
}
/** A labelled specimen cell so each variant is named for critique. */
function specimen(label: string, node: Node): HTMLElement {
const cell = h("div", "kit-cell");
const slot = h("div", "kit-slot");
slot.appendChild(node);
cell.append(slot, h("span", "kit-label", label));
return cell;
}
function btn(className: string, label: string, disabled = false): HTMLButtonElement {
const b = document.createElement("button");
b.type = "button";
b.className = className;
b.textContent = label;
b.disabled = disabled;
return b;
}
/** A collapsible folder header, matching the real sidebar tree markup. */
function folderHeader(name: string, count: number, depth: number): HTMLElement {
const b = h("button", "tree-folder-header");
(b as HTMLButtonElement).type = "button";
b.style.paddingLeft = `${depth * 16}px`;
b.setAttribute("aria-expanded", "true");
b.innerHTML = `<span class="chevron">▾</span><span class="folder-name">${name}</span><span class="folder-count">${count}</span>`;
return b;
}
function leafRow(opts: {
name: string;
daemon: string;
cmd: string;
status: "running" | "dead";
active?: boolean;
indent?: number;
}): HTMLElement {
const row = h("a", "tree-leaf");
(row as HTMLAnchorElement).href = "#/kit";
row.dataset.status = opts.status;
if (opts.active) row.classList.add("is-active");
row.style.paddingLeft = `${(opts.indent ?? 0) * 16 + 8}px`;
row.innerHTML = `
<span class="leaf-name">${opts.name}</span>
${opts.cmd !== opts.name ? `<span class="leaf-meta"><span class="leaf-cmd">${opts.cmd}</span></span>` : ""}
${opts.status === "dead" ? `<span class="leaf-badge">exited</span>` : ""}
<span class="leaf-actions">
<button class="leaf-act leaf-clone" type="button" title="Clone" aria-label="Clone ${opts.name}">⧉</button>
<button class="leaf-act leaf-kill" type="button" title="Kill session" aria-label="Kill ${opts.name}">✕</button>
</span>`;
return row;
}
export function renderKit(): HTMLElement {
const page = h("div", "kit");
// --- header ---
const header = h("header", "kit-header");
header.appendChild(
h(
"div",
"kit-brand",
`<span class="brand-dot" aria-hidden="true"></span>
<h1>maestro<span class="blink" aria-hidden="true">_</span> · design kit</h1>`,
),
);
const headerActions = h("div", "kit-header-actions");
const back = document.createElement("a");
back.className = "btn btn-ghost";
back.href = "?mock";
back.textContent = "← back to app";
headerActions.append(back, createThemeToggle());
header.appendChild(headerActions);
page.appendChild(header);
const main = h("div", "kit-main");
page.appendChild(main);
// --- color tokens ---
{
const { el, body } = section(
"Color tokens",
"Slate neutrals (hue ~256) + signal-green = alive. Swap by theme toggle.",
);
body.classList.add("kit-swatches");
const tokens = [
"--bg",
"--surface",
"--surface-2",
"--surface-3",
"--border",
"--ink",
"--muted",
"--faint",
"--accent",
"--danger",
"--warn",
];
for (const t of tokens) {
const sw = h("div", "kit-swatch");
const chip = h("div", "kit-swatch-chip");
chip.style.background = `var(${t})`;
sw.append(chip, h("span", "kit-label", t));
body.appendChild(sw);
}
main.appendChild(el);
}
// --- buttons: current system ---
{
const { el, body } = section(
"Buttons — current",
"The shipping button styles — now the bracket terminal style, as used across the header, modal, and empty states.",
);
body.append(
specimen("btn-primary", btn("btn btn-primary", "+ Spawn")),
specimen("btn (default)", btn("btn", "Cancel")),
specimen("btn-ghost", btn("btn btn-ghost", "Dismiss")),
specimen("btn-icon", btn("btn btn-icon", "✕")),
specimen("btn:disabled", btn("btn btn-primary", "+ Spawn", true)),
);
main.appendChild(el);
}
// --- buttons: terminal-native variants for critique ---
{
const { el, body } = section(
"Buttons — other explorations",
"The bracket variant was adopted as the app style (above). These remain as alternates — not used in the app.",
);
body.append(
specimen("bracket", btn("kit-btn-bracket", "+ Spawn")),
specimen("bracket primary", btn("kit-btn-bracket is-primary", "+ Spawn")),
specimen("prompt caret", btn("kit-btn-prompt", "spawn")),
specimen("block", btn("kit-btn-block", "SPAWN")),
specimen("underline", btn("kit-btn-underline", "spawn")),
);
main.appendChild(el);
}
// --- inputs ---
{
const { el, body } = section("Inputs", "Mono inputs with a green focus ring.");
const search = h("input") as HTMLInputElement;
search.type = "search";
search.className = "search";
search.placeholder = "Search sessions…";
const text = h("div", "modal-body");
const ti = document.createElement("input");
ti.type = "text";
ti.placeholder = "branch-name";
text.appendChild(ti);
const sel = h("div", "modal-body");
const s = document.createElement("select");
s.innerHTML = `<option>thinkpad</option><option>tower</option><option>pi</option>`;
sel.appendChild(s);
body.append(
specimen("search", search),
specimen("text input", text),
specimen("select", sel),
);
main.appendChild(el);
}
// --- chips & badges ---
{
const { el, body } = section("Chips & badges", "Status-bearing pills and counts.");
body.append(
specimen("daemon-chip", h("span", "daemon-chip", "thinkpad")),
specimen("daemon-empty", h("span", "daemon-empty", "no daemons connected")),
specimen("folder-count", h("span", "folder-count", "4")),
specimen("leaf-badge", h("span", "leaf-badge", "exited")),
specimen(
"attach-state · open",
h("span", "attach-state", "live"),
),
);
(body.lastElementChild?.querySelector(".attach-state") as HTMLElement)?.setAttribute(
"data-state",
"open",
);
const connecting = specimen("attach-state · connecting", h("span", "attach-state", "connecting"));
(connecting.querySelector(".attach-state") as HTMLElement).setAttribute("data-state", "connecting");
const closed = specimen("attach-state · closed", h("span", "attach-state", "closed"));
(closed.querySelector(".attach-state") as HTMLElement).setAttribute("data-state", "closed");
body.append(connecting, closed);
main.appendChild(el);
}
// --- session rows, nested by project label ---
{
const { el, body } = section(
"Session rows — nested by host, then project",
"Host is the first level of nesting; the project label nests beneath it, so the daemon no longer rides on each row. “Alive” is a faint row wash; exited rows recede with a badge; the open session is highlighted.",
);
const list = h("div", "kit-tree");
list.append(
folderHeader("thinkpad", 3, 0),
folderHeader("maestro", 3, 1),
folderHeader("web", 2, 2),
leafRow({ name: "redesign", daemon: "", cmd: "claude", status: "running", indent: 3 }),
leafRow({ name: "dev-server", daemon: "", cmd: "vite dev", status: "running", indent: 3, active: true }),
folderHeader("server", 1, 2),
leafRow({ name: "registry-broker", daemon: "", cmd: "claude", status: "running", indent: 3 }),
folderHeader("tower", 2, 0),
folderHeader("work", 1, 1),
folderHeader("acme", 1, 2),
leafRow({ name: "billing-api", daemon: "", cmd: "claude", status: "running", indent: 3 }),
leafRow({ name: "scratch", daemon: "", cmd: "bash", status: "dead", indent: 1 }),
folderHeader("pi", 1, 0),
leafRow({ name: "monitor", daemon: "", cmd: "btop", status: "running", indent: 1 }),
);
body.classList.add("kit-tree-host");
body.appendChild(list);
main.appendChild(el);
}
// --- empty states ---
{
const { el, body } = section("Empty states", "Each one teaches the next action.");
body.classList.add("kit-empties");
const welcome = h("div", "empty");
welcome.innerHTML = `
<div class="empty-glyph" aria-hidden="true">⌘</div>
<div class="empty-title">No session open</div>
<p class="empty-hint">Pick a session from the list, or start a new one.</p>
<div class="empty-actions"></div>`;
welcome.querySelector(".empty-actions")!.appendChild(btn("btn btn-primary", "+ Spawn session"));
const noSessions = h("div", "empty");
noSessions.innerHTML = `
<div class="empty-glyph" aria-hidden="true">+</div>
<div class="empty-title">No sessions yet</div>
<p class="empty-hint">Start your first session — it'll show up here.</p>
<div class="empty-actions"></div>`;
noSessions.querySelector(".empty-actions")!.appendChild(btn("btn btn-primary", "+ Spawn session"));
const waiting = h("div", "empty connecting");
waiting.innerHTML = `
<div class="empty-glyph" aria-hidden="true">◴</div>
<div class="empty-title">Waiting for a daemon</div>
<p class="empty-hint">Start a <code>maestro daemon</code> on a host and it will appear here.</p>`;
body.append(welcome, noSessions, waiting);
main.appendChild(el);
}
return page;
}