Every component records its semantic element, visible states, required accessible relationships and the behaviour that remains owned by the consuming application.
Control specimens
Focus, labels and state remain visible.
Component inventory
Twenty-one documented primitives.
Each card is a contract record, not an application implementation.
navigation
nav · shared-visual
Primary navigation
Moves between stable product areas without hiding the current location.
default
current
collapsed
aria-label
aria-current
Host application owns routing.
nav · shared-visual
Breadcrumbs
Shows hierarchy and a reversible path through nested work.
default
overflow
aria-label
aria-current
Host application owns hierarchy.
div · shared-visual
Tabs
Switches among peer views while preserving one selected tab.
default
selected
disabled
role=tablist
aria-selected
aria-controls
Host application owns selection and panels.
action
button · shared-visual
Button
Invokes one named action with visible text or an accessible name.
default
hover
focus
pressed
disabled
busy
type
aria-label when icon-only
aria-busy when running
Host application owns the effect.
button · shared-visual
Toggle
Changes a reversible preference without claiming an external connection succeeded.
off
on
disabled
role=switch
aria-checked
Host application owns preference persistence.
input
input · shared-visual
Text field
Collects a named value with help and error relationships.
empty
filled
invalid
disabled
readonly
label
aria-describedby
aria-invalid when invalid
Host application owns validation.
button · shared-visual
Filter chip
Adds or removes one filter while keeping the active query legible.
available
selected
disabled
aria-pressed
Host application owns filtering.
content
ul · shared-visual
Selectable list
Presents scannable objects with a non-colour selected cue.
default
selected
empty
loading
accessible item names
aria-current or aria-selected
Host application owns object selection.
article · shared-visual
Card
Groups one object summary, its state, evidence and next action.
default
selected
disabled
heading
state text
Host application owns navigation or actions.
section · shared-visual
Panel
Defines a bounded work or inspection region without decorative colour fields.
default
recessed
raised
collapsed
heading or aria-label
Host application owns disclosure.
data
table · shared-visual
Data table
Compares structured records using headers and compact status text.
default
sorted
empty
loading
caption
scope on headers
aria-sort when sorted
Host application owns data and sorting.
feedback
dialog · shared-visual
Dialog
Interrupts only for a bounded decision with explicit close and focus return.
closed
open
busy
aria-labelledby
close action
focus return
Host application owns opening, validation and result.
span · shared-visual
Status
Pairs semantic text and shape with colour rather than relying on colour alone.
neutral
info
success
warning
danger
offline
visible text
aria-live only for changes
Host application owns truth and timestamps.
article · shared-visual
Activity item
Shows actor, action, time, affected object and adjacent evidence.
observed
pending
uncertain
verified
actor
timestamp
evidence link
Host application owns activity records.
article · shared-visual
Approval card
Shows the exact request, scope, consequence, expiry and human decision.
requested
approved
denied
expired
cancelled
requesting actor
scope
consequence
decision controls
Host application owns authority evaluation and decision.
article · shared-visual
Receipt card
Shows an attributable result and its evidence without implying universal authority.
recorded
verified
uncertain
superseded
actor
operation
time
evidence
Host application owns receipt generation and verification.
workbench
header · shared-visual
Command bar
Holds project context, search and named commands at workbench density.
default
searching
command-open
search label
command names
Host application owns command dispatch.
nav · shared-visual
Workbench rail
Provides project and buildout navigation beside the primary workspace.
expanded
compact
hidden
aria-label
current item
Host application owns route and selection.
aside · shared-visual
Inspector
Shows contextual fields, evidence and actions for the selected object.
open
empty
collapsed
heading or aria-label
selected object name
Host application owns inspected data.
section · shared-visual
Activity region
Presents ordered progress, logs and recovery information without becoming an unstructured console.
active
paused
empty
error
heading
ordered timestamps
live-region policy
Host application owns streaming and retention.
footer · shared-visual
Status line
Shows compact connection, selection, task and keyboard context.
ready
busy
degraded
offline
visible labels
no colour-only state
Host application owns observed state.
Truthful evidence specimens
Desired, observed and verified states remain separate.
These static specimens keep actor, scope, consequence and evidence adjacent. None of the controls dispatch an application command.
Text-first status
Symbol + label + detail
○IdleNo session loaded
●RunningStep 2 of 4
✓VerifiedReceipt attached
!StaleLast observed 8 minutes ago
×FailedNo external effect sent
Approval specimen
Publish one branch to GitHub
!Human decisionNot yet authorised
Requester
Foreman agent
Scope
Write agent/catalogue-evidence and open one draft pull request
Consequence
Repository collaborators can inspect the proposed code
Not included
Merge, release, deployment, credentials or unrelated repository writes