web: visual system tokens, styleguide and application notes

Role-named tokens (colour, 8px spacing, radii, type scale, elevation, focus,
state tints, motion) with a styleguide built from the app's real components and a
short application guide, including what to remove from the current CSS.
This commit is contained in:
2026-10-19 17:25:01 +01:00
parent 46a59ac015
commit f3c00f9ce5
5 changed files with 3449 additions and 0 deletions
+70
View File
@@ -0,0 +1,70 @@
// Capture the visual-system styleguide at 1440 × 900 through the repository's
// zero-dependency Chrome DevTools driver. Read-only import: web/test/browser.mjs
// is not modified.
//
// node web/design/tokens/capture.mjs
//
// Writes PNGs into web/design/tokens/captures/ (gitignored by the root
// `captures/` rule). No server is started; the styleguide is a local file.
import { mkdir } from "node:fs/promises";
import { dirname, join } from "node:path";
import { fileURLToPath, pathToFileURL } from "node:url";
import { launchChrome } from "../../test/browser.mjs";
const here = dirname(fileURLToPath(import.meta.url));
const outDir = join(here, "captures");
const styleguide = pathToFileURL(join(here, "styleguide.html"));
const shots = [
{ id: "foundations", name: "styleguide-01-foundations-1440x900.png" },
{ id: "type", name: "styleguide-02-type-1440x900.png" },
{ id: "space", name: "styleguide-03-space-1440x900.png" },
{ id: "navigation", name: "styleguide-04-rail-1440x900.png" },
{ id: "lists", name: "styleguide-05-lists-1440x900.png" },
{ id: "data", name: "styleguide-06-data-1440x900.png" },
{ id: "overlays", name: "styleguide-07-overlays-1440x900.png" },
{ id: "conversation", name: "styleguide-08-conversation-1440x900.png" },
{ id: "content", name: "styleguide-09-content-1440x900.png" },
];
await mkdir(outDir, { recursive: true });
const browser = await launchChrome({ width: 1440, height: 900 });
try {
for (const shot of shots) {
const page = await browser.openPage(`${styleguide.href}#${shot.id}`, {
width: 1440,
height: 900,
});
await page.waitForSelector(`#${shot.id}`);
await page.evaluate("document.fonts.ready.then(() => true)");
if (shot.id === "foundations") {
await page.evaluate("window.scrollTo(0, 0)");
} else {
await page.evaluate(`(() => {
const node = document.querySelector("#${shot.id}");
node.scrollIntoView({ block: "start" });
window.scrollBy(0, -16);
return node.getBoundingClientRect().top;
})()`);
}
await new Promise((resolve) => setTimeout(resolve, 180));
const path = join(outDir, shot.name);
await page.screenshot(path);
const metrics = await page.evaluate(`(() => {
const node = document.querySelector("#${shot.id}");
return {
top: Math.round(node.getBoundingClientRect().top),
width: Math.round(node.getBoundingClientRect().width),
pageHeight: document.documentElement.scrollHeight,
};
})()`);
console.log(
`${shot.name}: viewport 1440x900, section top ${metrics.top}px, width ${metrics.width}px, page ${metrics.pageHeight}px`,
);
await page.close();
}
} finally {
await browser.close();
}
File diff suppressed because it is too large Load Diff
+944
View File
@@ -0,0 +1,944 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Pipelines web — visual system styleguide</title>
<link rel="stylesheet" href="./tokens.css" />
<link rel="stylesheet" href="./styleguide.css" />
</head>
<body>
<svg class="icon-sprite" aria-hidden="true" focusable="false" width="0" height="0">
<symbol id="i-branch" viewBox="0 0 24 24">
<circle cx="6" cy="5" r="2" fill="currentColor" stroke="none"></circle>
<circle cx="6" cy="19" r="2" fill="currentColor" stroke="none"></circle>
<circle cx="18" cy="12" r="2" fill="currentColor" stroke="none"></circle>
<path d="M6 7v10M8 12h8" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></path>
</symbol>
<symbol id="i-clock" viewBox="0 0 24 24">
<circle cx="12" cy="12" r="8" fill="none" stroke="currentColor" stroke-width="1.8"></circle>
<path d="M12 8v4l3 2" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"></path>
</symbol>
<symbol id="i-chat" viewBox="0 0 24 24">
<path d="M4 6.5A2.5 2.5 0 0 1 6.5 4h11A2.5 2.5 0 0 1 20 6.5v7a2.5 2.5 0 0 1-2.5 2.5H10l-6 4V6.5Z" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linejoin="round"></path>
</symbol>
<symbol id="i-settings" viewBox="0 0 24 24">
<circle cx="12" cy="12" r="3" fill="none" stroke="currentColor" stroke-width="1.8"></circle>
<path d="M12 3v2M12 19v2M3 12h2M19 12h2M5.6 5.6 7 7M17 17l1.4 1.4M18.4 5.6 17 7M7 17l-1.4 1.4" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></path>
</symbol>
<symbol id="i-info" viewBox="0 0 24 24">
<circle cx="12" cy="12" r="8" fill="none" stroke="currentColor" stroke-width="1.8"></circle>
<path d="M12 11v5M12 8h.01" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></path>
</symbol>
<symbol id="i-graph" viewBox="0 0 24 24">
<circle cx="6" cy="6" r="2" fill="none" stroke="currentColor" stroke-width="1.8"></circle>
<circle cx="18" cy="9" r="2" fill="none" stroke="currentColor" stroke-width="1.8"></circle>
<circle cx="10" cy="18" r="2" fill="none" stroke="currentColor" stroke-width="1.8"></circle>
<path d="m8 7 8 1M8 8l1 8M16 11l-5 6" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></path>
</symbol>
<symbol id="i-code" viewBox="0 0 24 24">
<path d="m8 8-4 4 4 4M16 8l4 4-4 4M13 5l-2 14" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"></path>
</symbol>
<symbol id="i-search" viewBox="0 0 24 24">
<circle cx="11" cy="11" r="6.5" fill="none" stroke="currentColor" stroke-width="1.8"></circle>
<path d="m16 16 4 4" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></path>
</symbol>
<symbol id="i-paperclip" viewBox="0 0 24 24">
<path d="M9 12.5 15.5 6a3.5 3.5 0 0 1 5 5L11 20.5a5.5 5.5 0 0 1-7.8-7.8l9-9" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"></path>
</symbol>
<symbol id="i-shield" viewBox="0 0 24 24">
<path d="M12 3 5 6v5.5c0 4.3 2.9 8.2 7 9.5 4.1-1.3 7-5.2 7-9.5V6l-7-3Z" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linejoin="round"></path>
<path d="M12 8v4M12 15h.01" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"></path>
</symbol>
<symbol id="i-send" viewBox="0 0 24 24">
<path d="m4 12 16-7-7 16-2.4-6.6L4 12Z" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linejoin="round"></path>
</symbol>
</svg>
<div class="guide">
<aside class="guide-rail" aria-label="Styleguide contents">
<div class="guide-brand">
<span class="guide-mark" aria-hidden="true"></span>
<span class="guide-brand-text">
<span class="guide-brand-name">Pipelines</span>
<span class="guide-brand-sub">visual system</span>
</span>
</div>
<nav class="guide-nav" aria-label="Sections">
<p class="guide-nav-label">Contents</p>
<a href="#foundations"><span class="guide-nav-index">01</span>Foundations</a>
<a href="#type"><span class="guide-nav-index">02</span>Type</a>
<a href="#space"><span class="guide-nav-index">03</span>Space and depth</a>
<a href="#navigation"><span class="guide-nav-index">04</span>Rail</a>
<a href="#lists"><span class="guide-nav-index">05</span>Lists and toolbar</a>
<a href="#data"><span class="guide-nav-index">06</span>Key/value and code</a>
<a href="#overlays"><span class="guide-nav-index">07</span>Dialog and sheet</a>
<a href="#conversation"><span class="guide-nav-index">08</span>Conversation</a>
<a href="#content"><span class="guide-nav-index">09</span>Artifacts and empty</a>
</nav>
<div class="guide-rail-footer">
<span>Tokens v1 · dark identity</span>
<span>1440 × 900 capture</span>
<span>Status hues unchanged</span>
</div>
</aside>
<main class="guide-main">
<header class="guide-header">
<p class="eyebrow">Design deliverable</p>
<h1>Visual system</h1>
<p class="guide-lead">
The Pipelines web client keeps the app's dark identity, its mint accent and its
run-status vocabulary. This guide refines the layer model, the spacing and type
scales, and the component shapes so every area reads from one set of roles
instead of repeating its own chip, border and shadow.
</p>
<div class="guide-meta-row">
<span><strong>Contrast</strong> body ≥ 4.5:1 · UI edge ≥ 3:1</span>
<span><strong>Focus</strong> 2px ring, 2px offset</span>
<span><strong>Motion</strong> 80 / 120 / 180 / 240 ms</span>
<span><strong>Grid</strong> 8px with 4px half-steps</span>
</div>
</header>
<!-- ── 01 Foundations ─────────────────────────────────────────────── -->
<section class="guide-section" id="foundations" aria-labelledby="foundations-title">
<div class="section-head">
<h2 id="foundations-title">Foundations</h2>
<span class="section-index">01 / 09</span>
</div>
<p class="section-note">
Colour is assigned by layer, not by file. The page is <code>bg</code>;
a pane or card is <code>surface</code>; a control, row or code body is
<code>surface-2</code>; anything that floats is <code>elevated</code>.
Borders mark interactive edges. Dividers separate content inside one surface.
</p>
<div class="swatch-group">
<p class="swatch-group-label">Canvas and surface layers</p>
<div class="swatch-grid">
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-bg)"></span>
<span class="swatch-name">--color-bg</span>
<span class="swatch-value">#0e1513</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-surface)"></span>
<span class="swatch-name">--color-surface</span>
<span class="swatch-value">#161d1b</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-surface-2)"></span>
<span class="swatch-name">--color-surface-2</span>
<span class="swatch-value">#1a211f</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-elevated)"></span>
<span class="swatch-name">--color-elevated</span>
<span class="swatch-value">#252c2a</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-elevated-2)"></span>
<span class="swatch-name">--color-elevated-2</span>
<span class="swatch-value">#2f3634</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-scrim)"></span>
<span class="swatch-name">--color-scrim</span>
<span class="swatch-value">black 58%</span>
</div>
</div>
</div>
<div class="swatch-group">
<p class="swatch-group-label">Text, lines and focus</p>
<div class="swatch-grid">
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-text)"></span>
<span class="swatch-name">--color-text</span>
<span class="swatch-value">#dee4e1</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-muted)"></span>
<span class="swatch-name">--color-muted</span>
<span class="swatch-value">#a9bab5</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-faint)"></span>
<span class="swatch-name">--color-faint</span>
<span class="swatch-value">#8b9b96</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-divider)"></span>
<span class="swatch-name">--color-divider</span>
<span class="swatch-value">#2c3a36</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-border)"></span>
<span class="swatch-name">--color-border</span>
<span class="swatch-value">#6a7874</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-border-strong)"></span>
<span class="swatch-name">--color-border-strong</span>
<span class="swatch-value">#889391</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-focus)"></span>
<span class="swatch-name">--color-focus</span>
<span class="swatch-value">#a9f0dd</span>
</div>
</div>
</div>
<div class="swatch-group">
<p class="swatch-group-label">Accent and outcome</p>
<div class="swatch-grid">
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-accent)"></span>
<span class="swatch-name">--color-accent</span>
<span class="swatch-value">#7fd1bb</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-accent-strong)"></span>
<span class="swatch-name">--color-accent-strong</span>
<span class="swatch-value">#a3e4d3</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-ok)"></span>
<span class="swatch-name">--color-ok</span>
<span class="swatch-value">#6bd39a</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-warn)"></span>
<span class="swatch-name">--color-warn</span>
<span class="swatch-value">#e6c268</span>
</div>
<div class="swatch">
<span class="swatch-chip" style="--swatch: var(--color-bad)"></span>
<span class="swatch-name">--color-bad</span>
<span class="swatch-value">#ef8a8a</span>
</div>
</div>
</div>
</section>
<!-- ── 02 Type ────────────────────────────────────────────────────── -->
<section class="guide-section" id="type" aria-labelledby="type-title">
<div class="section-head">
<h2 id="type-title">Type</h2>
<span class="section-index">02 / 09</span>
</div>
<p class="section-note">
Eight sans roles and two mono roles. A screen title is
<code>title</code>; a section header is <code>title-small</code>; a row name is
<code>body</code> at semibold; meta is <code>meta</code>. Nothing picks a size
directly.
</p>
<div class="type-table">
<div class="type-row">
<span class="type-token">--type-eyebrow</span>
<span class="t-eyebrow">Workspace</span>
<span class="type-spec">11 / 14 · 600 · 0.06em</span>
</div>
<div class="type-row">
<span class="type-token">--type-label</span>
<span class="t-label">v5</span>
<span class="type-spec">11 / 16 · 600</span>
</div>
<div class="type-row">
<span class="type-token">--type-meta</span>
<span class="t-meta">id 24 · v5 · 6 stages</span>
<span class="type-spec">12 / 16 · 400</span>
</div>
<div class="type-row">
<span class="type-token">--type-body-small</span>
<span class="t-body-small">This asks the server to stop the active run.</span>
<span class="type-spec">13 / 18 · 400</span>
</div>
<div class="type-row">
<span class="type-token">--type-body</span>
<span class="t-body">Plan and land</span>
<span class="type-spec">14 / 20 · 400</span>
</div>
<div class="type-row">
<span class="type-token">--type-title-small</span>
<span class="t-title-small">Waiting for your decision</span>
<span class="type-spec">16 / 22 · 600</span>
</div>
<div class="type-row">
<span class="type-token">--type-title</span>
<span class="t-title">Pipelines</span>
<span class="type-spec">20 / 26 · 600</span>
</div>
<div class="type-row">
<span class="type-token">--type-display</span>
<span class="t-display">Visual system</span>
<span class="type-spec">24 / 30 · 600</span>
</div>
<div class="type-row">
<span class="type-token">--type-code</span>
<span class="t-code">sha256:9f2c41e8a7</span>
<span class="type-spec">12 / 18 · mono</span>
</div>
<div class="type-row">
<span class="type-token">--type-code-small</span>
<span class="t-code">run 458 · 12m</span>
<span class="type-spec">11 / 16 · mono</span>
</div>
</div>
</section>
<!-- ── 03 Space and depth ─────────────────────────────────────────── -->
<section class="guide-section" id="space" aria-labelledby="space-title">
<div class="section-head">
<h2 id="space-title">Space and depth</h2>
<span class="section-index">03 / 09</span>
</div>
<p class="section-note">
One 8px grid with 4px half-steps. Padding inside a component is smaller than
the gap between components; the gap between blocks is smaller than the gap
between sections. Radii collapse to five roles, and only floating surfaces
carry a shadow.
</p>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Spacing scale</h3>
<span class="specimen-caption">8px grid · 4px half-steps</span>
</div>
<div class="space-table">
<div class="space-row">
<span class="space-token">--space-3xs</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-3xs)"></span></span>
<span class="space-value">2px</span>
</div>
<div class="space-row">
<span class="space-token">--space-2xs</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-2xs)"></span></span>
<span class="space-value">4px</span>
</div>
<div class="space-row">
<span class="space-token">--space-xs</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-xs)"></span></span>
<span class="space-value">8px</span>
</div>
<div class="space-row">
<span class="space-token">--space-s</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-s)"></span></span>
<span class="space-value">12px</span>
</div>
<div class="space-row">
<span class="space-token">--space-m</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-m)"></span></span>
<span class="space-value">16px</span>
</div>
<div class="space-row">
<span class="space-token">--space-l</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-l)"></span></span>
<span class="space-value">24px</span>
</div>
<div class="space-row">
<span class="space-token">--space-xl</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-xl)"></span></span>
<span class="space-value">32px</span>
</div>
<div class="space-row">
<span class="space-token">--space-2xl</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-2xl)"></span></span>
<span class="space-value">40px</span>
</div>
<div class="space-row">
<span class="space-token">--space-3xl</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-3xl)"></span></span>
<span class="space-value">48px</span>
</div>
<div class="space-row">
<span class="space-token">--space-4xl</span>
<span class="space-track"><span class="space-bar" style="--bar: var(--space-4xl)"></span></span>
<span class="space-value">64px</span>
</div>
</div>
</div>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Radii</h3>
<span class="specimen-caption">one family, five roles</span>
</div>
<div class="radius-grid">
<div class="radius-cell">
<span class="radius-box" style="--radius: var(--radius-xs)"></span>
<span class="swatch-name">--radius-xs</span>
</div>
<div class="radius-cell">
<span class="radius-box" style="--radius: var(--radius-s)"></span>
<span class="swatch-name">--radius-s</span>
</div>
<div class="radius-cell">
<span class="radius-box" style="--radius: var(--radius-control)"></span>
<span class="swatch-name">--radius-control</span>
</div>
<div class="radius-cell">
<span class="radius-box" style="--radius: var(--radius-card)"></span>
<span class="swatch-name">--radius-card</span>
</div>
<div class="radius-cell">
<span class="radius-box" style="--radius: var(--radius-sheet)"></span>
<span class="swatch-name">--radius-sheet</span>
</div>
<div class="radius-cell radius-cell--pill">
<span class="radius-box" style="--radius: var(--radius-pill)"></span>
<span class="swatch-name">--radius-pill</span>
</div>
</div>
</div>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Elevation</h3>
<span class="specimen-caption">floating surfaces only</span>
</div>
<div class="elevation-grid">
<div class="elevation-cell">
<div class="elevation-box" style="--elevation: var(--elevation-1)">--elevation-1</div>
<span class="swatch-value">menu item, sticky edge</span>
</div>
<div class="elevation-cell">
<div class="elevation-box" style="--elevation: var(--elevation-2)">--elevation-2</div>
<span class="swatch-value">menu, toast</span>
</div>
<div class="elevation-cell">
<div class="elevation-box" style="--elevation: var(--elevation-3)">--elevation-3</div>
<span class="swatch-value">dialog</span>
</div>
</div>
</div>
</section>
<!-- ── 04 Rail ────────────────────────────────────────────────────── -->
<section class="guide-section" id="navigation" aria-labelledby="navigation-title">
<div class="section-head">
<h2 id="navigation-title">Rail</h2>
<span class="section-index">04 / 09</span>
</div>
<p class="section-note">
Destinations and sections share one item shape. The active item changes its
surface, its weight and adds a 2px inset accent bar, so selection is never
colour alone. Hover is a wash, not a new layer. Width belongs to the layout
track; the rail never sizes itself from its labels.
</p>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Destinations and sections</h3>
<span class="specimen-caption">200px track · 44px items</span>
</div>
<div class="stage stage--bare">
<div class="rail">
<div class="rail-brand">
<span class="rail-mark" aria-hidden="true"></span>
<span>Pipelines</span>
</div>
<nav aria-label="Destinations">
<a class="rail-item is-active" href="#navigation" aria-current="page">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-branch"></use></svg>
<span>Pipelines</span>
</a>
<a class="rail-item" href="#navigation">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-clock"></use></svg>
<span>Runs</span>
</a>
<a class="rail-item" href="#navigation">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-chat"></use></svg>
<span>Chat</span>
</a>
<a class="rail-item" href="#navigation">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-settings"></use></svg>
<span>Settings</span>
</a>
</nav>
<div class="rail-divider" role="presentation"></div>
<p class="rail-heading">Sections</p>
<div role="tablist" aria-label="Sections" aria-orientation="vertical">
<button class="rail-item is-active" type="button" role="tab" aria-selected="true">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-info"></use></svg>
<span>Summary</span>
</button>
<button class="rail-item" type="button" role="tab" aria-selected="false">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-graph"></use></svg>
<span>Graph</span>
</button>
<button class="rail-item" type="button" role="tab" aria-selected="false">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-code"></use></svg>
<span>Source</span>
</button>
</div>
<div class="rail-footer">
<span class="live-dot" aria-hidden="true"></span>
<span>Connected</span>
</div>
</div>
</div>
</div>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Item states</h3>
<span class="specimen-caption">default · hover · active</span>
</div>
<div class="rail-state-grid">
<div class="rail-state-cell">
<div class="rail">
<a class="rail-item" href="#navigation">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-clock"></use></svg>
<span>Runs</span>
</a>
</div>
<span class="rail-state-label">default</span>
</div>
<div class="rail-state-cell">
<div class="rail">
<a class="rail-item is-hover" href="#navigation">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-clock"></use></svg>
<span>Runs</span>
</a>
</div>
<span class="rail-state-label">hover · wash 5%</span>
</div>
<div class="rail-state-cell">
<div class="rail">
<a class="rail-item is-active" href="#navigation" aria-current="page">
<svg class="icon" aria-hidden="true" focusable="false"><use href="#i-clock"></use></svg>
<span>Runs</span>
</a>
</div>
<span class="rail-state-label">active · accent inset 2px</span>
</div>
</div>
</div>
</section>
<!-- ── 05 Lists and toolbar ───────────────────────────────────────── -->
<section class="guide-section" id="lists" aria-labelledby="lists-title">
<div class="section-head">
<h2 id="lists-title">Lists and toolbar</h2>
<span class="section-index">05 / 09</span>
</div>
<p class="section-note">
A row is one control, not a box around a box. Name, status and meta share one
two-column grid; hover is a wash and selection adds the accent bar. The toolbar
uses the same 36px control height as every other button and field.
</p>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Toolbar</h3>
<span class="specimen-caption">filter · sort · search · live</span>
</div>
<div class="toolbar">
<button class="btn" type="button">Filter</button>
<button class="btn" type="button">Sort: Newest first</button>
<label class="search">
<svg class="search-icon" aria-hidden="true" focusable="false"><use href="#i-search"></use></svg>
<input type="text" placeholder="Search pipelines, runs and artifacts" aria-label="Search pipelines, runs and artifacts" />
</label>
<span class="live-badge"><span class="live-dot" aria-hidden="true"></span>live</span>
</div>
</div>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Rows</h3>
<span class="specimen-caption">default · hover · selected</span>
</div>
<div class="stage">
<div class="row-list">
<button class="row is-selected" type="button" aria-current="true">
<span class="row-title">Plan and land</span>
<span class="chip chip--succeeded"><span class="chip-glyph" aria-hidden="true">✓</span>succeeded</span>
<span class="row-meta">id 24 · v5 · 6 stages</span>
</button>
<button class="row is-hover" type="button">
<span class="row-title">Server</span>
<span class="chip chip--failed"><span class="chip-glyph" aria-hidden="true">✕</span>failed</span>
<span class="row-meta">id 22 · v6 · 4 stages</span>
</button>
<button class="row" type="button">
<span class="row-title">Nightly audit</span>
<span class="chip chip--running"><span class="chip-glyph" aria-hidden="true">▶</span>running</span>
<span class="row-meta">id 12 · v9 · 5 stages</span>
</button>
</div>
</div>
</div>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Density</h3>
<span class="specimen-caption">light · compact</span>
</div>
<div class="density-grid">
<div class="density-panel">
<div class="density-head">
<span class="density-title">Light density</span>
<span class="density-meta">row 12px block</span>
</div>
<div class="row-list">
<button class="row" type="button">
<span class="row-title">Plan and land</span>
<span class="chip chip--succeeded"><span class="chip-glyph" aria-hidden="true">✓</span>succeeded</span>
<span class="row-meta">id 24 · v5 · 6 stages</span>
</button>
<button class="row" type="button">
<span class="row-title">Server</span>
<span class="chip chip--failed"><span class="chip-glyph" aria-hidden="true">✕</span>failed</span>
<span class="row-meta">id 22 · v6 · 4 stages</span>
</button>
<button class="row" type="button">
<span class="row-title">Docs site</span>
<span class="chip chip--queued"><span class="chip-glyph" aria-hidden="true">◷</span>queued</span>
<span class="row-meta">id 18 · v3 · 3 stages</span>
</button>
</div>
</div>
<div class="density-panel" data-density="compact">
<div class="density-head">
<span class="density-title">Compact</span>
<span class="density-meta">row 8px block</span>
</div>
<div class="row-list">
<button class="row" type="button">
<span class="row-title">Plan and land</span>
<span class="chip chip--succeeded"><span class="chip-glyph" aria-hidden="true">✓</span>succeeded</span>
<span class="row-meta">id 24 · v5 · 6 stages</span>
</button>
<button class="row" type="button">
<span class="row-title">Server</span>
<span class="chip chip--failed"><span class="chip-glyph" aria-hidden="true">✕</span>failed</span>
<span class="row-meta">id 22 · v6 · 4 stages</span>
</button>
<button class="row" type="button">
<span class="row-title">Docs site</span>
<span class="chip chip--queued"><span class="chip-glyph" aria-hidden="true">◷</span>queued</span>
<span class="row-meta">id 18 · v3 · 3 stages</span>
</button>
</div>
</div>
</div>
</div>
</section>
<!-- ── 06 Key/value and code ──────────────────────────────────────── -->
<section class="guide-section" id="data" aria-labelledby="data-title">
<div class="section-head">
<h2 id="data-title">Key/value and code</h2>
<span class="section-index">06 / 09</span>
</div>
<p class="section-note">
Facts use one two-column table with the label in <code>meta</code> and the value
in <code>body-small</code>; hashes, sessions and paths take the mono role. A code
block is a single framed surface with its own header, never a bordered box
inside another bordered box.
</p>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Key/value table</h3>
<span class="specimen-caption">Summary</span>
</div>
<div class="stage">
<dl class="kv">
<div><dt>Content hash</dt><dd><code>sha256:9f2c41e8a7</code></dd></div>
<div><dt>Started</dt><dd>19 Oct 2026 14:20</dd></div>
<div><dt>Finished</dt><dd>19 Oct 2026 14:32</dd></div>
<div><dt>Duration</dt><dd>12m</dd></div>
</dl>
</div>
</div>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Monospace code</h3>
<span class="specimen-caption">one frame, one label</span>
</div>
<div class="code-card">
<div class="code-head">
<span>Shell</span>
<button class="btn btn--ghost btn--small" type="button">Copy</button>
</div>
<pre class="code-body"><code><span class="tok-cmd">node</span> serve.mjs <span class="tok-arg">--port 8095 --pipelines 127.0.0.1:8080</span>
<span class="tok-comment"># http://127.0.0.1:8095/</span>
<span class="tok-cmd">PIPELINES_WS_URL</span>=<span class="tok-arg">ws://127.0.0.1:8095/connect</span> <span class="tok-cmd">node</span> test/smoke.mjs</code></pre>
</div>
</div>
</section>
<!-- ── 07 Dialog and sheet ────────────────────────────────────────── -->
<section class="guide-section" id="overlays" aria-labelledby="overlays-title">
<div class="section-head">
<h2 id="overlays-title">Dialog and sheet</h2>
<span class="section-index">07 / 09</span>
</div>
<p class="section-note">
Anything above the page uses <code>elevated</code>, the sheet radius and one
elevation. The scrim carries the separation; the panel does not add a second
border around its content. Actions sit on one row, with the primary last.
</p>
<div class="density-grid">
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Confirm dialog</h3>
<span class="specimen-caption">Cancel run 458?</span>
</div>
<div class="overlay-demo">
<div class="scrim" aria-hidden="true"></div>
<div class="dialog" role="dialog" aria-modal="true" aria-labelledby="cancel-title">
<h3 class="dialog-title" id="cancel-title">Cancel run 458?</h3>
<p class="dialog-message">This asks the server to stop the active run.</p>
<div class="dialog-actions">
<button class="btn" type="button">Keep</button>
<button class="btn btn--danger" type="button">Cancel run</button>
</div>
</div>
</div>
</div>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Bottom sheet</h3>
<span class="specimen-caption">Needs you</span>
</div>
<div class="overlay-demo overlay-demo--sheet">
<div class="scrim" aria-hidden="true"></div>
<div class="sheet" role="dialog" aria-modal="true" aria-labelledby="needs-title">
<div class="sheet-head">
<h3 class="sheet-title" id="needs-title">Needs you</h3>
<button class="btn btn--ghost btn--small" type="button">Close</button>
</div>
<div class="sheet-body">
<div class="sheet-row">
<span class="chip chip--failed"><span class="chip-glyph" aria-hidden="true">✕</span>failed</span>
<span class="sheet-row-text">
<span class="sheet-row-title">Server</span>
<span class="sheet-row-meta">Server · failed · needs you</span>
</span>
<button class="btn btn--ghost btn--small" type="button">Dismiss</button>
</div>
<div class="sheet-row">
<span class="chip chip--waiting"><span class="chip-glyph" aria-hidden="true">…</span>waiting</span>
<span class="sheet-row-text">
<span class="sheet-row-title">Nightly audit</span>
<span class="sheet-row-meta">Nightly audit · waiting for your decision</span>
</span>
<button class="btn btn--ghost btn--small" type="button">Dismiss</button>
</div>
<button class="btn btn--ghost btn--small" type="button">Clear all</button>
</div>
</div>
</div>
</div>
</div>
</section>
<!-- ── 08 Conversation ───────────────────────────────────────────── -->
<section class="guide-section" id="conversation" aria-labelledby="conversation-title">
<div class="section-head">
<h2 id="conversation-title">Conversation</h2>
<span class="section-index">08 / 09</span>
</div>
<p class="section-note">
The operator gets a bubble; the agent gets a full-width turn. The transcript is
the page surface, so the agent turn does not need a second card. The composer
shares the control radius and focus ring, and the approval card is the one
place where a warning edge is warranted.
</p>
<div class="chat-stage">
<div class="turn turn--user">
<div class="bubble-user">Show me why run 458 needed the decision, and what changed in the last stage.</div>
</div>
<div class="turn turn--agent">
<span class="agent-name">Agent</span>
<div class="markdown">
<p class="md-paragraph">
Run 458 waited on the review stage. The landing step then completed and
recorded four artifacts.
</p>
<ul class="md-list">
<li>Review requested a decision on the land stage.</li>
<li>The decision was recorded, then the run finished.</li>
<li>Four files changed in the last stage.</li>
</ul>
<div class="md-code-block">
<div class="md-code-label">bash</div>
<pre class="md-pre"><code>git diff --stat HEAD~1
4 files changed, 86 insertions(+), 21 deletions(-)</code></pre>
</div>
</div>
</div>
<div class="composer">
<button class="icon-button" type="button" aria-label="Attach file" title="Attach file">
<svg class="icon icon--inline" aria-hidden="true" focusable="false"><use href="#i-paperclip"></use></svg>
</button>
<textarea class="composer-input" rows="1" placeholder="Message the agent… or / for commands" aria-label="Message the agent… or / for commands"></textarea>
<button class="send" type="button" aria-label="Send" title="Send">
<svg class="icon icon--inline" aria-hidden="true" focusable="false"><use href="#i-send"></use></svg>
</button>
</div>
<section class="approval" aria-label="Approval request">
<div class="approval-head">
<svg class="approval-shield" aria-hidden="true" focusable="false"><use href="#i-shield"></use></svg>
<span class="approval-titles">
<span class="approval-headline">Approve bash</span>
<span class="approval-status">Waiting for your response</span>
</span>
</div>
<pre class="approval-resources">docker build -t pipelines:dev .</pre>
<div class="approval-risk">
<span class="approval-risk-head">
<svg class="icon icon--small" aria-hidden="true" focusable="false"><use href="#i-shield"></use></svg>
<span class="approval-risk-label">RISK REVIEW</span>
</span>
<span class="approval-risk-text">This writes an image tagged pipelines:dev on this machine.</span>
</div>
<div class="approval-actions">
<button class="btn btn--primary" type="button">Allow once</button>
<button class="btn" type="button">Always allow</button>
<button class="btn btn--ghost" type="button">Reject</button>
</div>
</section>
</div>
</section>
<!-- ── 09 Artifacts and empty ─────────────────────────────────────── -->
<section class="guide-section" id="content" aria-labelledby="content-title">
<div class="section-head">
<h2 id="content-title">Artifacts and empty</h2>
<span class="section-index">09 / 09</span>
</div>
<p class="section-note">
A tile is one framed surface; the media fills it and the actions sit over it.
An empty state is a sentence and, when there is a way out, one action — never a
dashed box or an illustration competing with the text.
</p>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Artifact tiles</h3>
<span class="specimen-caption">image · video · PDF · JSON</span>
</div>
<div class="artifact-grid">
<div class="artifact-tile">
<span class="artifact-thumb" aria-hidden="true"></span>
<div class="artifact-actions">
<button class="artifact-action" type="button">Share</button>
</div>
</div>
<div class="artifact-tile">
<span class="artifact-thumb" aria-hidden="true"></span>
<span class="artifact-poster" aria-hidden="true"><span class="artifact-play">▶</span></span>
<span class="artifact-name">land.webm</span>
<div class="artifact-actions">
<button class="artifact-action" type="button">Share</button>
</div>
</div>
<div class="artifact-tile">
<span class="artifact-kind">PDF</span>
<span class="artifact-name">session.pdf</span>
<span class="artifact-size">1.2 MiB</span>
<div class="artifact-actions">
<button class="artifact-action" type="button">Copy link</button>
<button class="artifact-action" type="button">Share</button>
</div>
</div>
<div class="artifact-tile">
<span class="artifact-kind">JSON</span>
<span class="artifact-name">report.json</span>
<span class="artifact-size">18.4 KiB</span>
<div class="artifact-actions">
<button class="artifact-action" type="button">Copy link</button>
<button class="artifact-action" type="button">Share</button>
</div>
</div>
</div>
</div>
<div class="density-grid">
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Empty state</h3>
<span class="specimen-caption">sentence plus one way out</span>
</div>
<div class="empty-state">
<p>No runs match the current filters.</p>
<button class="btn" type="button">Clear filters</button>
</div>
</div>
<div class="specimen">
<div class="specimen-head">
<h3 class="specimen-title">Run-status chip row</h3>
<span class="specimen-caption">web status palette · unchanged</span>
</div>
<div class="stage">
<div class="chip-row">
<span class="chip chip--queued"><span class="chip-glyph" aria-hidden="true">◷</span>queued</span>
<span class="chip chip--running"><span class="chip-glyph" aria-hidden="true">▶</span>running</span>
<span class="chip chip--waiting"><span class="chip-glyph" aria-hidden="true">…</span>waiting</span>
<span class="chip chip--succeeded"><span class="chip-glyph" aria-hidden="true">✓</span>succeeded</span>
<span class="chip chip--failed"><span class="chip-glyph" aria-hidden="true">✕</span>failed</span>
<span class="chip chip--canceled"><span class="chip-glyph" aria-hidden="true">⊘</span>canceled</span>
<span class="chip chip--interrupted"><span class="chip-glyph" aria-hidden="true">‖</span>interrupted</span>
<span class="chip chip--blocked"><span class="chip-glyph" aria-hidden="true">■</span>blocked</span>
<span class="chip chip--skipped"><span class="chip-glyph" aria-hidden="true">»</span>skipped</span>
<span class="chip chip--active"><span class="chip-glyph" aria-hidden="true">◆</span>active</span>
<span class="chip chip--unknown"><span class="chip-glyph" aria-hidden="true">?</span>unknown</span>
</div>
</div>
</div>
</div>
</section>
<footer class="guide-footer" id="closing">
<div class="section-head">
<h2>Apply it in this order</h2>
<span class="section-index">closing</span>
</div>
<div class="guide-footer-grid">
<div class="guide-footer-step">
<span class="guide-footer-index">01</span>
<h3>Install the roles</h3>
<p>Link tokens.css before the area stylesheets. Keep the app's status hues exactly as they are.</p>
</div>
<div class="guide-footer-step">
<span class="guide-footer-index">02</span>
<h3>Collapse the boxes</h3>
<p>Remove pane and card borders first, then per-row boxes. Replace them with spacing and dividers.</p>
</div>
<div class="guide-footer-step">
<span class="guide-footer-index">03</span>
<h3>Unify the details</h3>
<p>One chip, one control height, one radius family, one focus ring. Delete the duplicate selectors.</p>
</div>
</div>
<p class="guide-footer-files">
<span>tokens.css</span>
<span>styleguide.css</span>
<span>styleguide.html</span>
<span>capture.mjs</span>
<span>web/docs/visual-system.md</span>
</p>
</footer>
</main>
</div>
</body>
</html>
+262
View File
@@ -0,0 +1,262 @@
/* ===========================================================================
Pipelines web — visual system tokens
---------------------------------------------------------------------------
The single source of truth for colour roles, spacing, radii, type, elevation,
focus, tints and motion. Every token is named for the job it does, never for
the value it happens to hold.
This file contains custom properties only. Import it first, then a component
stylesheet (styleguide.css is the worked example). Nothing here paints a
selector on its own.
Contrast contract (verified against the surfaces below):
--color-text 14.35:1 on --color-bg, 13.29:1 on --color-surface
--color-muted 9.14:1 on --color-bg, 8.47:1 on --color-surface
--color-border 3.71:1 on --color-surface, 3.09:1 on --color-elevated
--color-focus 13.21:1 on --color-surface
Run-status hues are the web's current values, unchanged.
=========================================================================== */
:root {
/* ---- Canvas and surface layers ---------------------------------------- */
/* bg the page behind every pane
surface a pane, card or transcript group
surface-2 an inset control, row or code body
elevated a menu, dialog, sheet or toast above the page
elevated-2 the highest drawn surface: hover on an elevated control */
--color-bg: #0e1513;
--color-surface: #161d1b;
--color-surface-2: #1a211f;
--color-elevated: #252c2a;
--color-elevated-2: #2f3634;
--color-scrim: rgba(0, 0, 0, 0.58);
/* ---- Lines and focus --------------------------------------------------- */
/* divider decorative separation inside one surface (not a control edge)
border the edge of an interactive or focusable component; >=3:1 on
bg, surface, surface-2 and elevated (use border-strong on
elevated-2)
border-strong selected / pressed emphasis; >=3:1
focus the one focus ring colour, visible on every surface */
--color-divider: #2c3a36;
--color-border: #6a7874;
--color-border-strong: #889391;
--color-focus: #a9f0dd;
/* ---- Text -------------------------------------------------------------- */
--color-text: #dee4e1;
--color-muted: #a9bab5;
--color-faint: #8b9b96;
--color-on-accent: #06231c;
--color-on-bad: #1b0b0b;
--opacity-disabled: 0.5;
/* ---- Accent ------------------------------------------------------------ */
--color-accent: #7fd1bb;
--color-accent-strong: #a3e4d3;
--color-accent-pressed: #5fbfa8;
/* ---- Outcome hues (the app's own: ok / warn / bad) -------------------- */
--color-ok: #6bd39a;
--color-warn: #e6c268;
--color-bad: #ef8a8a;
/* ---- Run-status palette (the web's current values, unchanged) ---------- */
/* These are copied from the current base.css/.chip-* rules. Three values
(succeeded, failed, interrupted) are the web's tuned rendering; the Compose
RunStatusPalette uses slightly different stops. This item does not re-tune
any status hue. */
--status-queued: #9aa6a2;
--status-running: #7fb2f0;
--status-active: #7fb2f0;
--status-waiting: #8edff5;
--status-succeeded: #6bd39a;
--status-failed: #ef8a8a;
--status-canceled: #889391;
--status-interrupted: #e6c268;
--status-blocked: #f0a35e;
--status-skipped: #a8b8c8;
--status-unknown: #bec9c5;
/* Status washes tint the chip body; the neutral chip edge does the 3:1
boundary work, so a wash never has to carry the component alone. */
--status-queued-wash: rgba(154, 166, 162, 0.10);
--status-running-wash: rgba(127, 178, 240, 0.10);
--status-active-wash: rgba(127, 178, 240, 0.10);
--status-waiting-wash: rgba(142, 223, 245, 0.10);
--status-succeeded-wash: rgba(107, 211, 154, 0.10);
--status-failed-wash: rgba(239, 138, 138, 0.10);
--status-canceled-wash: rgba(136, 147, 145, 0.06);
--status-interrupted-wash: rgba(230, 194, 104, 0.10);
--status-blocked-wash: rgba(240, 163, 94, 0.10);
--status-skipped-wash: rgba(168, 184, 200, 0.10);
--status-unknown-wash: rgba(190, 201, 197, 0.10);
/* ---- Interaction tints ------------------------------------------------- */
/* A tint is a transparent wash laid over whatever surface is already there;
it never replaces a surface role. */
--tint-hover: rgba(222, 228, 225, 0.05);
--tint-pressed: rgba(222, 228, 225, 0.09);
--tint-selected: rgba(127, 209, 187, 0.12);
--tint-selected-strong: rgba(127, 209, 187, 0.20);
--tint-accent-soft: rgba(127, 209, 187, 0.10);
--tint-ok-soft: rgba(107, 211, 154, 0.10);
--tint-warn-soft: rgba(230, 194, 104, 0.10);
--tint-bad-soft: rgba(239, 138, 138, 0.10);
--tint-info-soft: rgba(142, 223, 245, 0.10);
/* ---- Spacing: 8px grid with 4px half-steps ----------------------------- */
/* 3xs is the only 2px step, reserved for optical alignment (a glyph against
a label), never for layout. */
--space-3xs: 2px;
--space-2xs: 4px;
--space-xs: 8px;
--space-s: 12px;
--space-m: 16px;
--space-l: 24px;
--space-xl: 32px;
--space-2xl: 40px;
--space-3xl: 48px;
--space-4xl: 64px;
/* Role aliases: use these in components, not the t-shirt scale. */
--space-inline-tight: var(--space-2xs); /* glyph + label */
--space-inline: var(--space-xs); /* buttons in a toolbar */
--space-inline-loose: var(--space-s); /* chips in a row */
--space-stack-tight: var(--space-2xs); /* title + meta */
--space-stack: var(--space-xs); /* lines inside a block */
--space-block: var(--space-m); /* block to block */
--space-section: var(--space-l); /* section to section */
--space-page: var(--space-xl); /* page / pane padding */
--space-field-gap: var(--space-xs); /* label to field */
--space-control-pad-inline: var(--space-s);
--space-control-pad-block: var(--space-2xs);
--space-row-pad-inline: var(--space-s);
--space-panel-pad: var(--space-m);
--space-pane-pad: var(--space-m);
/* ---- Density ----------------------------------------------------------- */
/* Density changes padding and control height, never type size, so a compact
list stays readable. Set data-density="compact" on a container. */
--density-row-pad-block: var(--space-s);
--density-row-pad-inline: var(--space-s);
--density-row-gap: var(--space-2xs);
--density-control-height: 36px;
--density-control-height-small: 30px;
--density-touch-target: 44px;
--density-touch-target-large: 48px;
/* ---- Radii ------------------------------------------------------------- */
--radius-xs: 4px; /* inline code */
--radius-s: 6px; /* tiny marker, count badge */
--radius-control: 8px; /* button, field, row, menu item */
--radius-card: 12px; /* pane, card, tile, transcript group */
--radius-sheet: 16px; /* dialog and sheet */
--radius-pill: 999px; /* chip, count pill, terminal node */
/* ---- Type -------------------------------------------------------------- */
--font-sans: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
--font-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
/* Sizes: 11 / 12 / 13 / 14 / 16 / 20 / 24. Roles, not numbers, at call sites. */
--type-eyebrow: 600 11px/14px var(--font-sans);
--type-label: 600 11px/16px var(--font-sans);
--type-meta: 400 12px/16px var(--font-sans);
--type-body-small: 400 13px/18px var(--font-sans);
--type-body: 400 14px/20px var(--font-sans);
--type-title-small: 600 16px/22px var(--font-sans);
--type-title: 600 20px/26px var(--font-sans);
--type-display: 600 24px/30px var(--font-sans);
--type-code: 400 12px/18px var(--font-mono);
--type-code-small: 400 11px/16px var(--font-mono);
--weight-regular: 400;
--weight-medium: 500;
--weight-semibold: 600;
--tracking-eyebrow: 0.06em;
--tracking-tight: -0.01em;
/* ---- Elevation --------------------------------------------------------- */
/* Elevation is reserved for things that float above the page: a menu, a
dialog, a sheet, a toast. A pane or card never casts a shadow. */
--elevation-1: 0 1px 2px rgba(0, 0, 0, 0.32);
--elevation-2: 0 8px 24px rgba(0, 0, 0, 0.42);
--elevation-3: 0 18px 48px rgba(0, 0, 0, 0.52);
--elevation-sheet: 0 -16px 48px rgba(0, 0, 0, 0.55);
--elevation-menu: var(--elevation-2);
--elevation-dialog: var(--elevation-3);
--elevation-toast: var(--elevation-2);
/* ---- Focus ------------------------------------------------------------- */
--focus-ring-width: 2px;
--focus-ring-offset: 2px;
--focus-ring-color: var(--color-focus);
--focus-ring: 0 0 0 var(--focus-ring-width) var(--focus-ring-color);
--focus-ring-inset: inset 0 0 0 var(--focus-ring-width) var(--focus-ring-color);
--focus-halo: 0 0 0 var(--focus-ring-width) var(--color-bg),
0 0 0 calc(var(--focus-ring-width) + var(--focus-ring-offset)) var(--color-focus);
/* ---- Motion ------------------------------------------------------------ */
/* fast hover / press feedback
base selection, expansion, focus colour
slow dialog and sheet entry
spin an indeterminate spinner's one rotation */
--motion-instant: 80ms;
--motion-fast: 120ms;
--motion-base: 180ms;
--motion-slow: 240ms;
--motion-spin: 800ms;
--ease-standard: cubic-bezier(0.2, 0, 0, 1);
--ease-out: cubic-bezier(0, 0, 0, 1);
--ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
/* ---- Layout ------------------------------------------------------------ */
--layout-rail: 200px;
--layout-list-min: 200px;
--layout-list-max: 360px;
--layout-dock: 60px;
--layout-hairline: 1px;
--layout-measure: 72ch;
--layout-chat-measure: 560px;
--layout-dialog: 440px;
--layout-sheet: 560px;
--layout-menu: 240px;
--icon-status: 14px;
--icon-small: 16px;
--icon-inline: 18px;
--icon-list: 20px;
--icon-rail: 24px;
--layer-sticky: 10;
--layer-popover: 20;
--layer-dialog: 40;
--layer-toast: 50;
/* ---- Transitional aliases --------------------------------------------- */
/* The existing stylesheets use these short names. They map onto the roles
above so a file can be migrated one rule at a time; new CSS should use the
--color-* / --type-* / --space-* roles directly. */
--bg: var(--color-bg);
--surface: var(--color-surface);
--surface-2: var(--color-surface-2);
--elevated: var(--color-elevated);
--border: var(--color-border);
--border-strong: var(--color-border-strong);
--text: var(--color-text);
--muted: var(--color-muted);
--accent: var(--color-accent);
--ok: var(--color-ok);
--warn: var(--color-warn);
--bad: var(--color-bad);
}
/* Compact density is a scope, not a second theme: same colours, same type,
tighter row padding and a shorter control. */
[data-density="compact"] {
--density-row-pad-block: var(--space-xs);
--density-row-pad-inline: var(--space-s);
--density-row-gap: var(--space-3xs);
--density-control-height: 30px;
--density-control-height-small: 24px;
}
+445
View File
@@ -0,0 +1,445 @@
# Pipelines web client — visual system
Design-only deliverable. It does not change `web/src`, `web/styles.css`,
`web/index.html`, any area stylesheet or any test. The reference implementation is
`web/design/tokens/styleguide.html` + `styleguide.css`, built entirely from
`tokens.css`.
Sources read for this refinement:
- `web/base.css`, `lists.css`, `run-detail.css`, `chat.css`, `graph.css`,
`dialogs.css`, `settings.css` — the current palette, chip, radius and shadow
vocabulary.
- `web/design/layout/prototype.html`, `prototype.css`, `web/docs/layout-spec.md`
— the target rail + list/detail shell and its 200px rail.
- `android/.../ui/theme/Color.kt`, `Typography.kt`, `Dimens.kt`, `Theme.kt` —
the app's dark identity, type intent and 4dp-derived spacing.
- `android/.../ui/components/RunStatus.kt` — the app-owned status vocabulary.
The result keeps the app's dark canvas, mint accent and the web's current
run-status hues. It is a refinement of hierarchy and reuse, not a new brand.
---
## 1. The layer model
One canvas, four surface steps, one scrim. Every component picks a layer from this
table; no component invents a background.
| Layer | Token | Used by | Never |
| --- | --- | --- | --- |
| Canvas | `--color-bg` | Page, list/detail pane body, chat transcript, code body, artifact thumb base | A static card that also has a border and a shadow |
| Base surface | `--color-surface` | Left rail, top bar, toolbar, card, detail section, composer shell, approval card, empty state | A row inside another card; use a tint instead |
| Inset surface | `--color-surface-2` | Button/field fill, row fill when needed, chip body, inline code, code header, user bubble, sheet row, artifact tile | A card on top of a card; never `surface-2` on `surface-2` |
| Elevated | `--color-elevated` | Menu, popover, dialog, sheet, toast, tool panel | A normal page card |
| Highest | `--color-elevated-2` | Hover on an elevated control, gradient stop | A page background |
| Scrim | `--color-scrim` | Behind a dialog, sheet or full-screen viewer | A content background |
Rules:
1. **One step per nesting level.** Pane (`bg`) → card (`surface`) → control
(`surface-2`). Do not put another `surface` card inside a card; use padding,
a divider or a tint.
2. **A tint is not a layer.** Hover, pressed and selected are transparent washes
(`--tint-*`) laid over the surface that is already there. They never replace a
surface role.
3. **Elevation means floating.** A shadow is reserved for menus, dialogs, sheets,
toasts and the tool panel. A pane or card never casts one.
4. **The transcript is the page.** The agent turn sits directly on `bg`; only the
operator's bubble takes `surface-2`. This removes the current transcript →
agent bubble → tool section → code block stack of four fills.
### Which surface for each named layer
| Area | Surface |
| --- | --- |
| App shell / page | `bg` |
| Rail | `surface`, separated from the workspace by a `divider` edge |
| List pane / detail pane | `bg`; the wide split uses a divider, not a card |
| Top bar / connection banner | `surface` + bottom divider; banner states use `surface-2`, `tint-warn-soft`, `tint-bad-soft` |
| List row | transparent on the pane; hover `tint-hover`; selected `tint-selected` + 2px accent inset |
| Toolbar | `surface`; its controls `surface-2` with a `border` |
| Card / detail section | `surface`, no border; sections separated by `space-section` |
| Key/value table | on the card surface; use spacing or a divider, never a per-row box |
| Code block | `bg` body, `surface-2` header, one outer `border` |
| Dialog / sheet / menu | `elevated` + `border` + matching elevation + scrim where modal |
| Chat user bubble | `surface-2` + `border` |
| Chat agent turn | transparent on `bg`; code block is the only framed part |
| Composer | `surface` shell + `border`; the textarea itself is transparent |
| Approval card | `surface` + `border` + 3px warning inset; resources `bg`; risk `tint-warn-soft` |
| Artifact tile | `surface-2` + `border`; media fills the tile; actions overlay it |
| Empty state | `surface` + `space-l` padding; a sentence and at most one action |
---
## 2. Border or background?
Use **background** to group, **border** to identify a control, **divider** to
separate content inside one surface.
| Need | Use | Do not use |
| --- | --- | --- |
| A card or section | A `surface` step and spacing | Border + radius + shadow on a static block |
| A button, input, tile, selected row, dialog | `--color-border` (≥3:1 on all surfaces) | `--color-divider`, which is decorative and below 3:1 |
| A separator between rows or sections | `--color-divider` (1px) | A border around each row |
| A selected row | `tint-selected` + 2px inset accent bar + weight | A 1px accent border alone |
| A focused control | The 2px focus ring with a 2px offset | Recolouring the border and calling it focus |
| A destructive confirm | `--color-bad` text/edge + `tint-bad-soft` | A red-filled button for a secondary action |
| A floating panel | `elevated` + `border` + one elevation | A border pretending to be a shadow |
Rules:
1. **A border is a control edge, not decoration.** `--color-border` is `#6a7874`
so it stays above 3:1 on `bg`, `surface`, `surface-2` and `elevated`. The old
`#2c3a36` border is now `--color-divider` and is only for non-interactive
separation.
2. **Never border, fill and shadow the same static box.** Pick the grouping
mechanism: a surface step, a divider, or a floating elevation.
3. **No border-only selection.** The selected row also changes weight and adds the
accent bar; the `aria-current`/`aria-selected` state carries the semantics.
4. **No accent border on hover.** Hover is a 5% wash. Accent is reserved for
active, focus and the primary action. Today every `button:hover` turns its
border mint, which makes ordinary hover look selected.
5. **One border around a group.** A code card frames once; the header uses a
divider, not a second border. A dialog frames once; its rows use a surface or
spacing.
---
## 3. Chips and badges
There is one chip component.
```
.chip
glyph (aria-hidden, optional) + the status word
height 22px · padding 1px 8px · radius pill · type-label 11/16 600
neutral border (3:1) · status wash background · status-colour text
```
Status mapping (the web's current status palette, unchanged):
The values below are copied byte-for-byte from the current `base.css` status
rules. They are the web's tuned rendering of the app's status vocabulary; this
item does not re-tune a single hue.
| Word | Token | Wash | Glyph |
| --- | --- | --- | --- |
| `queued` | `--status-queued` | `--status-queued-wash` | `◷` |
| `running` | `--status-running` | `--status-running-wash` | `▶` |
| `waiting` | `--status-waiting` | `--status-waiting-wash` | `…` |
| `succeeded` | `--status-succeeded` | `--status-succeeded-wash` | `✓` |
| `failed` | `--status-failed` | `--status-failed-wash` | `✕` |
| `canceled` | `--status-canceled` | `--status-canceled-wash` | `⊘` |
| `interrupted` | `--status-interrupted` | `--status-interrupted-wash` | `‖` |
| `blocked` | `--status-blocked` | `--status-blocked-wash` | `■` |
| `skipped` | `--status-skipped` | `--status-skipped-wash` | `»` |
| `active` | `--status-active` | `--status-active-wash` | `◆` |
| `unknown` | `--status-unknown` | `--status-unknown-wash` | `?` |
Rules:
1. **Never colour alone.** Every status chip carries its glyph and its word. The
glyph may be `aria-hidden` because the word is present.
2. **Use the server's vocabulary verbatim.** Status words stay lowercase; the
uppercase role is the eyebrow/overline, never a status label.
3. **One chip, tone modifiers only.** `chip--succeeded`, `chip--failed`, etc.
change colour and wash; they do not change height, radius or type. Delete the
parallel `.outcome-chip`, `.version-chip`, `.graph-type-chip` and
`.verdict-ref` shapes.
4. **A chip is a fact, not an action.** A chip is never a button and never nested
inside another chip. If it opens something, use a row or a link.
5. **Neutral is a tone for a non-status fact.** A version (`v5`) or a file kind
(`PDF`) can use `chip--neutral`; it must not borrow `--status-unknown` and must
not be used for a run state.
6. **Counts are a count chip, not a status chip.** `chip--count` is a neutral
pill with a minimum width, used for `12` or `Filter (2)`.
7. **Badges are attached, not inline.** The attention count is a small filled
bubble (`--color-bad` + `--color-on-bad`) with a number; the live badge is a
dot plus the word `live`. Neither replaces a status chip.
8. **One fact, one chip.** Do not show `failed` twice in a row (chip plus a
coloured diagnostic line); the chip carries the state, the diagnostic carries
the reason.
---
## 4. Spacing inside vs between
The layout scale is 8px with 4px half-steps. A separate 2px optical step exists
only for aligning a glyph against a label; it is never a layout gap.
| Inside | Value |
| --- | --- |
| Icon/label gap | 4px |
| Control padding (block × inline) | 4 × 12px |
| Row padding, light (comfortable) | 12 × 12px |
| Row padding, compact | 8 × 12px |
| Card / panel padding | 16px |
| Dialog padding | 16px |
| Sheet padding | 12px vertical, 16px horizontal |
| Code body padding | 12px |
| Chip / count padding | 1 × 8px |
| Between | Value |
| --- | --- |
| Chips or toolbar controls | 8px |
| Title and meta | 2–4px |
| Lines in a block | 8px |
| Block to block (card sections) | 16px |
| Section to section | 24px |
| Page / pane edge | 32px (24px narrow) |
Rules:
1. **One owner per gap.** Use `gap` on the container; do not add a margin to the
last child and a gap on the parent.
2. **Padding inside is smaller than space between.** If a card's padding equals
the gap to the next card, the grouping reads as one block.
3. **No nested padding beyond 24px.** Card 16 + panel 16 + row 12 is 44px of
inset for a 14px label. Remove a layer or reduce to 16 + 8.
4. **List separation is either a gap or a divider, never both.** The refined
lists use a 2px gap and no row border; day headers use a divider.
5. **Density changes geometry only.** Compact changes row block padding 12 → 8
and control height 36 → 30. Type, line height and touch targets do not shrink.
Touch surfaces (rail, dock, primary row actions) stay 44/48px.
---
## 5. Type roles
| Role | Size / line | Weight | Use |
| --- | --- | --- | --- |
| `--type-eyebrow` | 11 / 14 | 600 | Overline (`WORKSPACE`, `SECTIONS`, `RISK REVIEW`); tracking 0.06em, uppercase |
| `--type-label` | 11 / 16 | 600 | Chip and badge labels |
| `--type-meta` | 12 / 16 | 400 | Meta lines, key labels, captions, helper text |
| `--type-body-small` | 13 / 18 | 400 | Dialog copy, empty-state copy, dense prose |
| `--type-body` | 14 / 20 | 400 | Default body, row titles (add 600), toolbar labels |
| `--type-title-small` | 16 / 22 | 600 | Card title, dialog/sheet title, approval headline |
| `--type-title` | 20 / 26 | 600 | Screen title (`Pipelines`, `Runs`) |
| `--type-display` | 24 / 30 | 600 | The app's largest title; rare |
| `--type-code` | 12 / 18 | 400 mono | Commands, diffs, code blocks |
| `--type-code-small` | 11 / 16 | 400 mono | Inline code, hashes, timestamps in tables |
Rules:
1. **Roles, not sizes.** No `font-size` literal in an area stylesheet. The current
CSS has ten distinct sizes (10, 11, 12, 12.5, 13, 14, 15, 16, 18, 20) plus a
40px viewer glyph; collapse to the seven sizes above.
2. **Three weights.** 400, 500, 600. Do not introduce 650/700; the app is
semibold-led, not bold-led.
3. **Sentence case for actions and titles.** Uppercase is only the eyebrow /
overline role. Status words stay lowercase.
4. **Tabular numbers** for timestamps, durations, counts and IDs:
`font-variant-numeric: tabular-nums`.
5. **Mono is for data, not emphasis.** Hashes, paths, commands, code and IDs in a
table. A pipeline name or a status word is never mono.
6. **Measure.** Prose is capped at `--layout-measure` (72ch); a chat bubble at
`--layout-chat-measure` (560px).
---
## 6. State, focus and motion
### Focus
- One ring: `outline: 2px solid var(--color-focus)` with `outline-offset: 2px`.
`--color-focus` is `#a9f0dd`, 13.2:1 on `surface` and 11:1 on `elevated`.
- Use `:focus-visible`; do not show the ring on a mouse click.
- A filled accent button uses the halo (`--focus-halo`) so the ring sits on the
page, not on the mint fill.
- A composite field (search wrapper, composer shell) uses `:focus-within` and
removes the inner input outline.
- Never `outline: none` without a replacement. Today `.decision-feedback:focus`,
`.template-create-name:focus` and `.rename-input:focus` only recolour the
border; `.timeline-row:focus-visible` explicitly removes the outline.
- An invalid field keeps the focus ring and uses the bad colour for the message
and border, not for the ring.
### Interaction states
| State | Treatment | Structural cue |
| --- | --- | --- |
| Hover | `--tint-hover` (5%) | none needed |
| Pressed | `--tint-pressed` (9%) | none needed |
| Selected | `--tint-selected` (12%) | 2px inset accent bar + 600 weight |
| Active / current | `--tint-selected` + accent bar | `aria-current` / `aria-selected` |
| Disabled | `--opacity-disabled` (0.5) | `disabled` / `aria-disabled` |
Selection is never colour alone: the bar and the weight are the non-colour cue.
### Motion
- `--motion-fast` 120ms for hover/press, `--motion-base` 180ms for selection and
expansion, `--motion-slow` 240ms for dialog/sheet entry, `--motion-spin` 800ms
for an indeterminate spinner.
- Standard easing `cubic-bezier(0.2, 0, 0, 1)`.
- Under `prefers-reduced-motion: reduce`, transitions and animations collapse to
an immediate state, scroll behaviour becomes `auto`, and no selected or focus
state is removed. The styleguide implements this globally.
---
## 7. What to remove from today's CSS
### 7.1 Nested boxes
Remove the second and third frame in each chain:
- `base.css` — `.list` / `.detail` (border + radius) wraps `.row` (bottom border)
and `.step` (border + radius), and `.artifact-tile` adds another border and
radius. A run detail is three borders deep.
- `run-detail.css` — `.verdict` and `.field-block` frame content inside
`.stage-pane-sheet`; `.change-hunk` frames a diff inside `.change-viewer`.
- `chat.css` — `.chat-transcript` (border) → `.chat-bubble` (border) → optional
`.chat-tool-section` (border) → `.chat-tool-section-body` (bg). The approval
card is `.chat-approval` (border) → `.chat-approval-resources` (border) →
`.chat-approval-risk` (wash). That is three nested boxes for one decision.
- `dialogs.css` — `.attention-sheet-panel` → `.attention-row` → the inner
`.attention-row-open`; `.decision-sheet-panel` → `.decision-option`.
- `settings.css` — each `.settings-status`, `.settings-warning`,
`.settings-notify-state` and `.settings-card` is its own bordered box inside the
section.
Replace with: one pane surface, one card surface, spacing, and a divider where a
boundary is genuinely needed.
### 7.2 Duplicate chip styles
There are at least six parallel chip shapes:
| Selector | File | Problem |
| --- | --- | --- |
| `.chip` + `.chip-*` | `base.css` | The canonical shape, 11px pill |
| `.outcome-chip` + `.outcome-*` | `run-detail.css` | Second pill, `currentColor` border |
| `.verdict-ref` | `run-detail.css` | Third pill, 11px |
| `.version-chip` | `lists.css` | Fourth pill, surface fill |
| `.graph-type-chip` | `graph.css` | Fifth pill, 11px |
| `.graph-edge-label` | `graph.css` | Sixth pill-shaped label |
| `.attention-badge` | `dialogs.css` | A badge, correctly distinct; keep but tokenise |
Delete the five chip duplicates. Keep one `.chip`, one `.chip--count`, and the
attention badge as a badge. The graph edge label is a label, not a status chip:
style it with `type-code-small` and no status tone.
### 7.3 Inconsistent radii and heights
- Radii in the current files: 0, 2px, 4px, 6px, 8px, 10px, 12px, 14px, 50%,
999px. Collapse to `4 / 6 / 8 / 12 / 16 / pill`; use 50% only for a dot or a
circular poster.
- Control heights: about 22px (artifact action), 30px (approval control), 32px
(toolbar/tool), 36px (inputs), 40px (chat send), 44px (rail/strip), 48px (dock).
Standardise on **30px compact**, **36px comfortable**, **44/48px touch**.
- `.chat-send` and `.chat-stop` are 16px glyph buttons with 8px 12px padding while
`.chat-composer-input` is 20px line-height; they do not align. Put both on the
same 36px row.
- `.artifact-action` at 22px is below the 24px minimum for a secondary target;
use 30px or move the actions into a menu.
### 7.4 Raw colour, alpha and shadow duplication
- Status hexes are repeated in `base.css` (`.chip-*`), `lists.css`
(`.metric-*`), `run-detail.css` (`.outcome-*`), `dialogs.css`
(`.decision-card`, `.decision-open`) and `graph.css` (`.chip-unknown`). One
`--status-*` token per state.
- Banner and decision hexes `#2c1616`, `#12251b`, `#2a2410`, `#102329` are
one-off colours. Use `tint-bad-soft`, `tint-ok-soft`, `tint-warn-soft` and
`tint-info-soft`.
- Floating shadows have six recipes (`0 10px 30px`, `0 12px 32px`,
`0 16px 40px`, `0 20px 60px`, `0 -12px 40px`, `-12px 0 40px`). Use
`--elevation-2` / `--elevation-3` / `--elevation-sheet`.
- Inline `rgba(...)` tints (`rgba(127, 209, 187, 0.12)`, `rgba(0, 0, 0, 0.45)`)
become `--tint-*` and `--color-scrim`.
### 7.5 Focus and hover
- Add a base `:focus-visible` rule; today `base.css` has none, so buttons and
inputs rely on the browser default.
- Remove `outline: none` from `.timeline-row:focus-visible`,
`.decision-feedback:focus`, `.template-create-name:focus` and
`.rename-input:focus`.
- Stop using `border-color: var(--accent)` as the only hover signal on every
button, card, tile and menu item. Hover = tint; accent = active/focus/primary.
- Unify the four focus offsets (`1px`, `-2px`, `-1px`, `2px`) to the token.
### 7.6 Disabled and opacity
The files use `opacity: 0.4`, `0.45`, `0.5`, `0.55`, `0.6` and `0.8` for
disabled, unavailable and closed states. Use `--opacity-disabled: 0.5` for a
disabled control; do not fade a whole card to hide it.
---
## 8. The six biggest before/after improvements
| # | Before | After |
| --- | --- | --- |
| 1 | **Boxes inside boxes.** A run row is a bordered `.row` inside a bordered `.list`; a chat decision is three nested fills/borders; a settings section has a card per block. | One pane surface, one card, spacing and dividers. A row is a control on the pane; only a floating surface has elevation. |
| 2 | **Six chip dialects.** `.chip`, `.outcome-chip`, `.verdict-ref`, `.version-chip`, `.graph-type-chip`, `.graph-edge-label` each set their own height, radius and type. | One `.chip` with tone modifiers, a count chip and one attention badge. Every status carries a glyph and its word. |
| 3 | **Every control invents a height.** 22–48px buttons, fields, tiles and composer actions do not line up across a toolbar. | 30px compact / 36px comfortable / 44–48px touch, one control radius, one icon size. Toolbars and the composer align on one baseline. |
| 4 | **Accent borders on hover.** Every button, tile and card turns mint on hover, making hover look focused and selection look ordinary. | Hover is a 5% wash. Accent is reserved for active, focus and the primary action; selection adds a 2px bar and weight. |
| 5 | **Ten ad-hoc type sizes.** 10, 11, 12, 12.5, 13, 14, 15, 16, 18, 20px with three near-identical section headers. | Seven sizes across eight roles plus two mono roles: 11 / 12 / 13 / 14 / 16 / 20 / 24 with fixed line heights and 400/500/600 weights. |
| 6 | **Focus is a border colour, when it exists at all.** Some inputs remove the outline; a focused timeline row is indistinguishable from hover; `base.css` has no focus rule. | One 2px `#a9f0dd` ring with a 2px offset on every focusable control, `:focus-within` on composite fields, and a halo on filled accent buttons. |
These six are ordered for migration: each one is independently shippable and each
removes more CSS than it adds once the old selectors are deleted.
---
## 9. Adopt it without a redesign
1. **Add `tokens.css` first.** It is custom properties only; linking it changes
nothing until a rule consumes a token. The `--bg`, `--surface`, `--border`
aliases at the bottom of the file let the existing stylesheets keep working
while they migrate one rule at a time.
2. **Collapse one area at a time.** Start with `lists.css` (rows, toolbar,
filter menu) because it owns the clearest box-in-box chain. Then
`run-detail.css`, then `chat.css`, then `settings.css`.
3. **Delete duplicate chips in the same change that introduces the unified one.**
Do not leave both `.chip` and `.outcome-chip` shipping.
4. **Move focus to the base layer.** Add the focus rule and remove the
`outline: none` exceptions before touching colour, so keyboard users never
regress.
5. **Keep the app's words and status colours.** This system changes surfaces,
spacing and shape; it does not rename a run state or invent a new outcome hue.
---
## 10. Captures and verification
Capture command (no server, no build step):
```sh
node web/design/tokens/capture.mjs
```
Captured at **1440 × 900** through the repository's read-only
`web/test/browser.mjs` driver at device scale 1:
- `web/design/tokens/captures/styleguide-01-foundations-1440x900.png`
- `web/design/tokens/captures/styleguide-02-type-1440x900.png`
- `web/design/tokens/captures/styleguide-03-space-1440x900.png`
- `web/design/tokens/captures/styleguide-04-rail-1440x900.png`
- `web/design/tokens/captures/styleguide-05-lists-1440x900.png`
- `web/design/tokens/captures/styleguide-06-data-1440x900.png`
- `web/design/tokens/captures/styleguide-07-overlays-1440x900.png`
- `web/design/tokens/captures/styleguide-08-conversation-1440x900.png`
- `web/design/tokens/captures/styleguide-09-content-1440x900.png`
The captures are review evidence and are covered by the repository's root
`captures/` ignore rule, like the layout captures.
Contrast was checked against the defined surfaces:
| Pair | Ratio |
| --- | --- |
| `--color-text` / `--color-bg` | 14.35:1 |
| `--color-text` / `--color-surface` | 13.29:1 |
| `--color-muted` / `--color-surface` | 8.47:1 |
| `--color-border` / `--color-surface` | 3.71:1 |
| `--color-border` / `--color-elevated` | 3.09:1 |
| `--color-focus` / `--color-surface` | 13.21:1 |
| lowest status text / its chip wash (canceled) | 4.75:1 |
No production app stylesheet, view, markup or test was changed. The production
page still renders from the current area stylesheets; this is the target system
and its evidence, not a live restyle.