Skip to content
ArcadiaDesign
A run's limits: its own cap, then two plans, each window a row, on one grid across both groups.

TSX

A limit is one line and its bar: what it measures, a scope where one thing has its own, the circumstance and the figure, over a Meter as wide as the row. Rows live in a MeterList, alone or in groups under a head (MeterListGroup), on one grid: every figure ends on one column, as wide as the widest figure present, and every bar has one width. A row on its own makes a list of one.

The figure says what is left in words ("64% left", "Limit reached", "Not started") and the bar says it as a level. tone paints both at once: the warning ink from 15% left, the danger ink once spent, each with its word. A quiet bar, room that cannot be used now, quiets its figure; an old reading (stale) steps the bar back and says its age as the circumstance. The bar takes every state a Meter draws.

Anatomy

Line
One style, Body, on one line: the name and its scope at the start, the circumstance against the figure at the end.
Name
What it measures, in --text-1, Body bold. A mark before it is one run with the word, Body bold's icon, centred on its capitals, --space-1-5 before it. It takes its room first: where it cannot share its line with the figure it takes a line of its own, and it never fades.
Scope
Whose it is, where one thing has its own window: right after the name in --text-3, --space-1-5 apart.
Circumstance
When it comes back, or how old the reading is: in --text-3, pushed against the figure, at least --space-3 from both. The first to give way.
Figure
What is left, in --text-1, tabular, in one end column as wide as the widest figure of the list. It takes the warning or danger ink with its tone, and only with its word. Never cut.
Bar
A Meter at md, --space-1 under the line, from the name's start to the figure's end: one width in every row. A MeterGroup in its place is a bar in parts.
Head
A group's mark and name in --text-2, a detail after it in --text-3, at most one control at its end, --space-2 over its first row.
Rhythm
Rows --space-3 apart from bar to line, three times a line's gap to its own bar; groups --space-6 apart. No divider and no box between rows.

States

One row in every state a Meter draws: only the figure, its ink and the bar change.

Room; low; spent; quiet while another window binds; an old reading; not started; reset and being read again; not read yet; a sign-in that expired, its action in the figure's place.

A bar in parts

Where a row stands for several things of one kind, a pool of accounts, its bar is a MeterGroup: a part each, in one capsule. The line reads the pool.

Four accounts: two spent, the chat's own at full ink. The circumstance says when the next is back, the figure how many are open.

A mark beside a name

mark takes an icon's name or a ProviderMark, on a row's name or a head's.

A company's mark sits in its name's run, as tall as the letters, so mark and word read as one.

A row that opens

A limit that opens is a DisclosureRow whose face is the meter row: the whole face is the toggle, its chevron on the first line, and what it opens stands under it.

A pool open on its four accounts, a plan closed. Press a row, or Tab to it and press Enter or an arrow.

One part opens a row and one draws a limit.

An action at its end

The row's openAction stands at the end of its first line: under the pointer, on keyboard focus and while the row is open, and where nothing hovers while it is open.

Point at a row or Tab to it: Manage takes the figure's place. A sign-in that expired keeps its action at the end.

While it shows, the figure and the circumstance give way to it rather than stand under it, and a row's action stands there always, the open action before it.

Pointing at a part

active and onActiveChange reach the bar in parts: pointing at one account keeps its ink and quiets the others, and the line can say which it is.

Point at a part of the bar: the circumstance names its account and the figure says what it has left.

Narrow

A row answers its width and takes the name's room first: the circumstance gives way, shortening and then fading at its end.

600px: all of it on one line
340px: the circumstance fades at its end; a name that cannot share its line with the figure takes one of its own
160px: a name on a line of its own wraps rather than fade

A name that cannot share its line with the figure takes a line of its own across the row, the circumstance and the figure under it, and wraps there rather than fade; the figure is never cut.

A row is one thing to a screen reader: its bar is a meter named by the name and the scope ("Weekly Fable"), and its value text is the sentence a person reads, the figure and then the circumstance ("100% left, resets Nov 20, 6:27 AM"). The line itself is hidden from assistive technology, since the bar says it. A bar that is not a level is an image named the same way ("5-hour: Sign-in expired"), and a bar in parts a group.

The list is a list and each row an item; a group is a list of its own, named by its head. Nothing in a row takes focus. The one exception is an action, at a head's end or in a row's figure, and it is a real button or link. Colour is never alone: the figure's word says low and spent.

As a row's face the meter row is the toggle's content: the toggle is named by the sentence the row reads ("Anthropic: 1 of 4 open, 1 back in 1h 15m") and says whether it is expanded, and the bar inside it is drawn only. The row's actions stand beside the toggle, never in it, and come after it in the Tab order; the open action shows when it takes focus.

MeterRow

namerequired
string
"Weekly": with scope, the bar's accessible name.
mark
IconName | ReactNode
An icon's name or a ProviderMark, on the name's capitals.
scope
string
Whose window it is, where one thing has its own ("Fable").
detail
string
The circumstance ("Resets in 3h"): the first to give way.
figure
string
What is left, in words ("64% left"): never cut.
action
ReactNode
A button or link in the figure's place. As a row's face it has none: the row's own action stands there.
value
number
What is left, 0..100.
segments
readonly MeterSegment[]
A bar in parts instead of one Meter.
active
string | null
The segment with the pointer (MeterGroup's): it keeps its ink and the others go quiet.
onActiveChange
(id: string | null) => void
The pointer came to a segment, or left the bar (null).
valueText
string
Default: the figure, then the detail.
rootStyle
RootStyle
A component's typed override prop: Layout and its documented knobs, each the references it takes or another kit knob of its kind; anything else is a type error at the call site (STYLEX.md).
held
number
What comes back with it, 0..100: a faint second fill, drawn on a spent track too.
tone
"neutral" | "warning" | "danger"Default "neutral"
warning (yellow fill) at 15% left or under; danger (a red track) once spent.
state
"level" | "off" | "unknown" | "pending" | "busy" | "none"Default "level"
What the bar says when it is not a level.
emphasis
"strong" | "normal" | "quiet"Default "normal"
The fill's rank among neighbouring meters.
stale
boolean
The number is old (the last read failed): the bar steps back.

label
string
Its accessible name.
rootStyle
RootStyle
A component's typed override prop: Layout and its documented knobs, each the references it takes or another kit knob of its kind; anything else is a type error at the call site (STYLEX.md).

namerequired
string
"OpenAI": with detail, the group's accessible name.
mark
IconName | ReactNode
detail
string
After the name ("ChatGPT Plus").
action
ReactNode
At most one control, at the end.
rootStyle
RootStyle
A component's typed override prop: Layout and its documented knobs, each the references it takes or another kit knob of its kind; anything else is a type error at the call site (STYLEX.md).