Theme Accent Mode Density

Contrast

Text against what it sits on. Below 4.5:1 fails WCAG AA for body text — the check a reviewer runs on any surface that takes a tone.

Waiting for the first preview to report its palette.

Corners

Sets all three radii at once. The individual values are under Geometry.

Brand 5

The accent seam an app actually brands itself through. Change these and you have made the decision a real `DesignTokens.graphite(...)` call makes.

accent The one voice of color — a BRAND SLOT — as a FILL (`--accent`, `Brand.d.ts` THE ACCENT'S TWO JOBS, #1689): a surface painted with the accent under [onAccent] (a slab, the FAB, a count badge, a checked box's face, an on switch's track, an active toggle's face, a pin head, a band under `chrome: accent`) and every wash mixed from it ([accentTint], [accentSel], [focusHalo], [groundGridInk], the deep chrome). Drawn ON a surface, the accent is [accentInk]. onAccent Foreground color painted on top of [accent]. accentInk THE ACCENT'S INK (`--accent-ink`, #1689): the accent drawn ON a neutral or washed surface — text and links, a glyph or icon, a border, an edge or underline, a selection start-edge, the focus ring and a field's focused border, a radio's dot, a status marker, a progress bar or spinner, the chart's lead series, the palette's `accent` ink. THE BOUNDARY OF A FILLED STATE IS INK: a checked box, an on switch and an active toggle draw their edge in it over the [accent] fill. Absent from the brand it IS [accent], byte for byte; a brand whose accent is a high-luminance hue states a darker ink of the same hue, and the plane-contrast gate holds this, not the fill, to the card and the ground (`contrastFloorViolations`). accentTint The accent at 9% (16% dark) — ID chips, the active row's wash, an applied chip, an applied-but-closed control (`--accent-tint`, derived from [accent]). accentSel The accent at 11% (18% dark) — the rail's FILLED INDICATOR (M3), laid over the GROUND, a step stronger than [accentTint] because the ground is darker than the card (`--accent-sel`, derived from [accent]).

Geometry 15

Square or rounded, and how heavy every line is. The radius row above the controls sets all three corners at once, because "what does square feel like" is one decision rather than three numbers.

rXs Radius for chips, checkboxes, tags, badges (`--r-xs`, 2). rS Radius for controls: buttons, fields, map pins and clusters (`--r-s`, 3). rM Radius for surfaces: cards, menus, dialogs (`--r-m`, 4). rL Radius for a sheet's leading corners, the largest surfaces (`--r-l`, 8). rMark Radius for a status marker, a legend swatch (`--r-mark`, 1). rPill THE PILL FLOOR (`--r-pill`, #1102): 0 in every corners set but [CornerStyle.round], where it is 999 and clamps to height / 2. A pill-capable control reads [controlRadius] or [chipRadius], never this directly. hairline Hairline stroke width. iconStroke Icon stroke weight. focusW Focus ring stroke width (solid [accentInk], offset [focusOffset]). focusHaloW The width of a FIELD's focus halo (`--focus-halo-w`, 3): a focused field takes the [accentInk] border plus [focusHalo] this wide OUTSIDE the box — the idiomatic Flutter form is a [BoxShadow] with this `spreadRadius` and zero blur. ctl Control height: buttons, toolbar (44 comfortable · 32 compact). fld Field box height: text fields, selects, date fields (`--fld`, 44 comfortable · 36 compact) — a field box stays a step taller than a control at the desk. navh Nav row height (44 comfortable · 34 compact). rowV Table row vertical padding (density knob): 14 comfortable (a 48 row) · 10 compact (a 40 row). barH The app bar's height (`--bar-h`, 64 comfortable · 56 compact) — the frame's one band, on the ground.

Surfaces 17

Everything the app is painted ON — the ground behind the content (the frame paints it too), the cards over it, the well inset in a card, and the washes that show state.

sur The GROUND (`--sur`): the app background, and the frame — the app bar and the rail paint it, with no fill, rule or shadow of their own. paper The CARD (`--paper`): tables, panes, charts, forms, sheets, menus — the plane every job sits on, a step above [sur]. paperW Sidebar / rail wash (`--paper-w`) — retiring with the rail wash (#892). well The WELL (`--well`): inset fills inside a card — photo plates, quote blocks, tracks, avatar blocks, neutral tags. ink4 State layer: hover wash, pressed, chip trays — opaque, over the card. cardEdge The card's hairline edge (`--card-edge`) — a LITERAL per theme, not an alias: in dark it is the card's RIM, its own value, because a shadow cannot lift a card off a near-black ground. cardSelEdge The selected record card's start-edge bar (`--card-sel-edge`): 0, or [edge] under [SelectionMark.edge]. surfaceEdge The frame a tile, sheet, panel or docked pane draws around itself (`--surface-edge`, aliasing `--card-edge` — every one a card now). hair Row + minor separators inside a card. hairS Structural: table header rule, sheet edges, a divider that must read. rowHover Table row hover wash. groundHover The state layer ON THE GROUND (`--ground-hover`, #892): the rail's hover, a ghost control on the bar. [ink4] is a CARD state layer and sits above the ground's value, so on the ground it vanishes; this steps the ground itself toward the ink — `color-mix(in srgb, var(--ink) 6%, var(--sur))`, derived in each factory from its own ink and ground, so the separation knob moves it with [sur]. groundGridInk The grid's line color (`--ground-grid`: the accent at 10%). groundGridSize The grid's pitch (`--ground-pattern-size`, 24). rowSel Table row selected wash. expandBg Expanded-row detail well. scrim Modal/sheet scrim.

Bands 10

The rail's head and the view bar beside it (one band across the top at 960 and wider), a pushed screen's bar, the compact bar and the compact nav bar — the band's fill, its rule, its hover and active faces, the resting field box on it, and the ink and accent control that sit on it. The rail's tree and its footer stay on the ground.

chrome A band's fill (`--chrome`): the app bar, the app band, the rail outside a drawer, the compact nav bar. chromeField A FIELD BOX's resting fill on a band (`--chrome-field`, #1186 — `AppBar.d.ts` ON A BAND): the search field resting on an accent or deep band takes this tonal step of the band — the on-chrome ink at 14% over [chrome] — with no border, and lift to [paper] while focused. Under [ChromeTone.ground] it is the field's ordinary paper fill, so nothing changes there. chromeHair A rule on a band (`--chrome-hair`). chromeHover A band's state layer (`--chrome-hover`). chromeSel The active nav item's face on a band (`--chrome-sel`). onChrome Text and glyphs on a band (`--on-chrome`). onChrome60 Secondary ink on a band (`--on-chrome-60`): meta, counts, borders. onChromeAccent An accent control on a band (`--on-chrome-accent`) — inverted under an accent or deep band (the #338 accent-on-accent cases). onChromeAccentInk The accent as INK on a band (`--on-chrome-accent-ink`, #1689): a lit glyph, an edge or a ring on the chrome. [accentInk] under a ground band; under an accent or deep band it inverts with the fill and IS [onChromeAccent]. [onChromeScope] maps [accentInk] onto it. onChromeOnAccent The ink on that control (`--on-chrome-on-accent`).

Text and controls 11

The ink ramp, the control outlines and the field's focus halo. Every pair the panel can break is watched by a contrast badge above.

ink Primary text. ink60 Secondary text. ink40 Tertiary: labels, counts, glyphs, placeholders — never body text. ink20 DIM MARKS, never text (`--ink20`): an unfilled priority bar, the grab bar, a stepped-back chart bar, the crosshair. btnBorder Default button outline. btnBorderHover Button outline on hover. fieldBorder A field's box (`--field-border`): text fields, selects, date fields, the combobox, the ref tile, the search field — the 3:1 boundary. chkBorder Checkbox border — the 3:1 boundary. focusHalo A FIELD's focus halo color (`--focus-halo`): the accent at 20%, derived from [accent] — the FILL, since a halo is a wash (#1689) — so a brand's halo follows its accent. focusHaloDanger A focused field IN ERROR (`--focus-halo-danger`, #896; `TextField.d.ts` THE FIELD STATES): [focusHalo]'s halo in the danger, the danger at 20%. edge Selection/cursor start-edge indicator width.

Status 7

The three voices that mean something — danger, caution and ok — each as a foreground and a surface wash, danger with a border as well.

danger Danger/error foreground — someone must act. dangerTint Danger/error surface wash — the filled tag and the banner a demanding status takes. dangerEdge Danger/error border. caution The caution ink (`--caution`, #922): the StatusPill caution plate's word and the chart tier's caution tone (a donut segment, a gauge band, an aging segment). ONE number on both kits — the token's oklch value converted, never a color this kit derives. Accent-independent. cautionTint The caution plate's wash (`--caution-tint`) — [caution] at the token's alpha, so the plate composites on whatever surface it sits on. ok Success/resolved foreground — the estate's one green (`--ok`). Accent-independent like [danger]; appears only where resolution or success is stated (StatusPill positive, resolved chips), never as a third decorative voice. okTint Success/resolved surface wash (`--ok-tint`).

Data 5

The default pin head, its glyph and its halo, and the group bands. A pin's category color comes from the palette, named in the theme seed.

pinFill The head of a pin that names neither a category nor a status (`--pin-fill: var(--accent)`; `MapView.d.ts` ONE CHANNEL PER JOB). It IS the themed accent by definition. pinFg The glyph on [pinFill] (`--pin-fg: var(--on-accent)`); a palette fill takes its own [KitPaletteColor.on]. pinHalo The 1.5px ring OUTSIDE a pin head's rim, so any fill reads on any basemap (`--pin-halo`: the paper at 85%; `MapView.d.ts` EVERY FILL IS LEGIBLE ON EVERY BASEMAP). group0 Level-0 group header band. group1 Level-1 group header band.

Map 11

The basemap's roles — land, water, parks, roads and their casings, buildings, labels — and the pending pin's gray. A raster basemap keeps its own imagery; these paint the map's plate and any kit-drawn map.

mapLand Land — the map's plate (`--map-land`). mapWater Water (`--map-water`). mapPark Parks and green space (`--map-park`). mapRoad A minor road's fill (`--map-road`). mapRoadEdge A minor road's casing (`--map-road-edge`). mapRoadMajor A major road's fill (`--map-road-major`). mapRoadMajorEdge A major road's casing (`--map-road-major-edge`). mapBuilding Building footprints (`--map-building`). mapLabel Place and road labels (`--map-label`). mapLabelWater Water labels (`--map-label-water`). pinPending A PENDING pin's head (`--pin-pending`, #894): the StatusMark `pending` tone on a pin with no category, whose fill says its status — and the hollow status badge's border beside one (`MapView.d.ts` ONE CHANNEL PER JOB, #972). [accent], [ok] and [danger] carry the other three. Clears 3:1 on [mapLand]; never text.

Scrollbars 6

Every scroller's bar: the thumb at rest and while hovered or dragged, the strip it rides, and the desk bar's thickness, side gap and corners. The desk half shows only while a fine pointer is attached; at touch the platform's own overlay keeps its size.

scrollbarThumb The scrollbar thumb at rest (`--scrollbar-thumb`, aliasing [ink40]): the muted-ink role, which clears the 3:1 a draggable control needs on [sur] and [paper] — never the state layer, which Material's Android thumb reads by default and which cannot be seen on [sur]. scrollbarThumbHover The thumb while hovered or dragged (`--scrollbar-thumb-hover`, aliasing [ink60]) — one ink level up; the thumb never grows. scrollbarTrack The strip the thumb rides (`--scrollbar-track`): transparent in graphite, so the thumb reads against the surface it scrolls. A theme may fill it. scrollbarSize The DESK scrollbar thumb's thickness (`--scrollbar-size`, 8). Applied only while a fine pointer is attached; at touch the platform's overlay keeps its own. scrollbarInset The clear gap on either side of the desk thumb (`--scrollbar-inset`, 2) — `ScrollbarThemeData.crossAxisMargin` — so a scroller's bar takes [scrollbarSize] + 2 × this. scrollbarRadius The thumb's corner radius (`--scrollbar-radius`, aliasing [rS]): the control radius, so a theme that moves [rS] moves its thumbs with no widget edit.

Advanced 6

Real controls that are not decisions — motion durations, the focus ring offset, the touch floor. Opens collapsed on purpose.

tQuick Quick transition duration — chevrons, hovers, checks. tMove Move transition duration — sheets, rail, menus. tDraw Draw transition duration (`--t-draw`) — the chart entrance band, the draw-in choreography's clock. tStagger Per-mark entrance offset (`--t-stagger`) — the delay each successive mark takes on top of the entrance band; the per-mark offset clamps at 20 steps, so a large series never trails past the band. focusOffset Focus ring offset. touch Minimum hit-target floor. Follows the POINTER, not the density knob alone (rhythm.css): 44 at comfortable (touch surfaces — never shrink below on touch), 32 at compact, which only ever applies with a fine pointer attached. Density-resolving this is what lets the control set — and a control-bearing table row — densify together (V-16).

Take it with you

The Dart that reproduces what you are looking at. It is a real constructor call, because the configurator edits a real preset — what you copy is what an app can paste.

Screens

Records list

Reach for this as the compact-class counterpart of the table — the same collection below the table breakpoint, one primary line per record under the same narrowing chrome. A verb on this screen has three homes and none of them is the bar: the primary one is the Fab (fab), view verbs like Export are the view-options surface's header affordance, and a record's own actions belong to the pushed record surface — see Detail's hosting knob.

Spec of record: design-system/components/data/List.d.ts

Knobs

Live

Real widgets, built from the real kit. Turn a knob and it rebuilds; the theme bar above applies the design system's own tokens — including anything you changed under Customize — and the device selector uses the same sizes the golden baselines gate on, so what you see here is what CI holds the widget to.

Press Focus on any preview to take it to the full window — at a desktop width that renders most devices at 1:1, which is when the widget's own controls become clickable. The bar always states the device and the scale, so a shrunk preview says it is shrunk. Esc leaves.

Device

screen_records_list

Knobs

Theme

Accent Mode Density rowCount

Set to 0 for the empty state.

framed showStatus showMeta selectable

Assembly

compactNav

Which nav the compact posture mounts — the drawer behind the hamburger, or a bottom bar.

fab

The primary tier, and on a records destination the ONLY loud action the bar's neighborhood has. The scaffold renders it in the thumb zone at every window class; a screen never places it itself.

drawerActions

Actions in the drawer's own footer. The drawer carries them at EVERY window class — at 960 and wider it exists only because they do, since the expanded shell otherwise mounts a standing inline rail instead.

Shows when you open the drawer — the hamburger below 960, an edge swipe at 960 and wider, where the rail head's menu button toggles the rail instead. The actions sit in the drawer's own footer; the resting frame is identical either way. — press Focus to make the preview interactive.

railMark

The app's identity mark, and nothing else — it never opens a picker. At 960 and wider it sits beside the menu button in the rail's head at the same place in both postures, overhanging the collapsed rail so the bar beside it steps in. Below 960 the drawer's header band states it.

scope

The scope — one value of the app's own kind (here an Area) — as the FIRST item of the bar's subtitle, ahead of the meta. With a picker it is a quiet text button with a chevron; on a phone the whole title block opens the picker as a bottom sheet. A pushed record's bar shows it read-only.

footerActions

Global commands with no page ("Send feedback", "Help") pinned in the rail's footer under the footer destinations — the same row as a destination, but never lit and never counted in the destination index.

footerBrand

An organization's or partner's logo at the very bottom of the rail and the drawer — identity, never a control. Collapsed it shows its compact square, or nothing when the host gives none.

View

viewPanels

The Group and Columns panels beside the built-in Filter. `RecordsChrome.panels` is host-contributed and view-agnostic — the same cluster a table gets. OFF leaves Filter standing alone, which is a real posture: the tab row is absent at a single available control, because one control needs no tabs.

Shows when you open the view-options pane (tap Filter's control) — panels are TABS of that one pane, so the resting bar looks identical either way and only the pane's content differs — press Focus to make the preview interactive.

Dart for these values

screen_records_list()

What you can do in it

Capability the preview already carries that no knob can express — you reach it by using the widget. Worth knowing before concluding something is missing: most of this is only clickable once the preview is at Focus size.

The records chrome

**Search** — type in the field; the table narrows live. Collapsing search never clears the query, which survives as a removable search:… chip.
**Filter** — the funnel opens the view-options pane. Facets are type-appropriate: enums and text offer distinct values, numbers a min/max, dates a From/To.
**Chips** — every applied filter renders as a removable chip, and Clear all removes the lot.
**Narrowed to zero** states the narrowing and offers Clear, rather than the author-a-record empty state.

What it is made of

The widgets this screen assembles, with their full API below. They used to live on a second entry of their own; one thing you choose gets one page.

AppList widget

Full dartdoc

The design-system List — a vertical collection of AppListItems, the compact-class posture for record collections (the swap counterpart of a `DataTable` below the table breakpoint). Supply rows via itemCount + itemBuilder (lazy, `ListView.builder` underneath) for large/dynamic collections, or children for a small fixed set of already-built AppListItems — exactly one of the two is required. Rows separate with a DesignTokens.hair hairline; the whole list scrolls. Selection mode: AppList does not itself own a selection set — the caller drives AppListItem.checkbox / AppListItem.selected per row (typically a leading AppCheckbox wired to toggle membership in the caller's own selection state, passed through itemBuilder or the children list). Kept deliberately simple, per the spec: tri-state select-all is a table-scope concern, not a list-scope one. Empty state: when the list has zero items (`itemCount == 0`, or children is empty), renders an AppEmptyState built from emptyLabel / emptyActionLabel / onEmptyAction instead of an empty scroll view. Adaptation strategy: **scale** (density only, via DesignTokens.rowV) — the same anatomy at every M3 window class; AppList is itself one half of the table/list **swap** a host performs at the `DataTable` breakpoint. ```dart AppList( itemCount: rows.length, itemBuilder: (context, i) => AppListItem( leading: AppIdChip(id: rowsi.id), title: rowsi.title, subtitle: rowsi.site, meta: rowsi.updatedLabel, selected: rowsi.id == activeId, danger: rowsi.status == 'Blocked', trailing: const KitIcon(KitGlyph.open), onTap: () => openRecord(rowsi.id), ), emptyLabel: 'No records match.', emptyActionLabel: 'Clear filters', onEmptyAction: clearFilters, ) ```

AppListdefault constructor

Knob	Type	Default	What it does
children *	List<Widget>?	—	The fixed row set for the plain AppList constructor. Null for the AppList.builder form.
emptyActionLabel	String?	null	Empty-state single action label. Renders only when onEmptyAction is also non-null.
emptyActionNavigates	bool	false	THE ACTION THAT ONLY OPENS A PAGE (`ActionStrip.d.ts`, #1749): the empty face's action pushes another screen and writes nothing, so it reports a link to assistive technology. Declared, never inferred from onEmptyAction. Default false.
emptyLabel	String	'No records.'	Empty-state title — what the view would show. Rendered via AppEmptyState when the list has zero rows.
framed	bool	false	The grouped-settings frame (`List.d.ts` `framed`): a strong hairline on the top + inline edges and a soft hairline below, around the whole list — the settings-group posture for a framed cluster of rows on the surface wash. Off by default.
onEmptyAction	VoidCallback?	null	Empty-state single action callback. Renders only when emptyActionLabel is also non-null.
shrinkWrap	bool	false	When true, the list sizes itself to its rows and defers scrolling to an enclosing scroll view (NeverScrollableScrollPhysics) — the posture for a sectioned surface hosting several lists inside one outer scroll. Defaults to false: the list is its own scrollable, filling its viewport.

AppList.builder

Knob	Type	Default	What it does
emptyActionLabel	String?	null	Empty-state single action label. Renders only when onEmptyAction is also non-null.
emptyActionNavigates	bool	false	THE ACTION THAT ONLY OPENS A PAGE (`ActionStrip.d.ts`, #1749): the empty face's action pushes another screen and writes nothing, so it reports a link to assistive technology. Declared, never inferred from onEmptyAction. Default false.
emptyLabel	String	'No records.'	Empty-state title — what the view would show. Rendered via AppEmptyState when the list has zero rows.
framed	bool	false	The grouped-settings frame (`List.d.ts` `framed`): a strong hairline on the top + inline edges and a soft hairline below, around the whole list — the settings-group posture for a framed cluster of rows on the surface wash. Off by default.
itemBuilder *	Widget Function(BuildContext context, int index)?	—	Builds row `index` for the AppList.builder form — typically an AppListItem, though any widget is accepted (a caller composing a section header inline, say). Null for the fixed-children form.
itemCount *	int?	—	Row count for the AppList.builder form. Null for the fixed-children form.
onEmptyAction	VoidCallback?	null	Empty-state single action callback. Renders only when emptyActionLabel is also non-null.
shrinkWrap	bool	false	When true, the list sizes itself to its rows and defers scrolling to an enclosing scroll view (NeverScrollableScrollPhysics) — the posture for a sectioned surface hosting several lists inside one outer scroll. Defaults to false: the list is its own scrollable, filling its viewport.

AppListItem widget

Full dartdoc

One record row in the design-system List — the compact-class collection posture (phones, and any surface narrower than the `DataTable` swap threshold). Anatomy, leading to trailing: an optional selection-mode AppCheckbox (wired by AppList, never constructed directly by a caller composing a bare AppListItem), an optional leading identity slot (an AppIdChip, a framed thumb, an avatar — any widget), a title (clamped to two lines, DesignTokens.bodyEm) with an optional subtitle clamped to subtitleMaxLines (default one line; DesignTokens.body/DesignTokens.ink60 — machine-adjacent supporting text, not DesignTokens.dataS; reserve the data font for meta), an optional right-aligned side column stacking meta (DesignTokens.dataS/DesignTokens.ink60 — timestamps, counts) over an optional status word (the spec's first-class status slot, rendered through the shared cell grammar's neutral enum cast; statusDanger takes danger color + em weight), and an optional trailing widget (a chevron, or a single always-visible action / `⋯` menu — **never hover-revealed**, per the constitution's row-actions rule). Selection grammar mirrors the table row exactly: selected paints a 2px DesignTokens.edge accent start-edge over a DesignTokens.rowSel tint wash; danger paints the same edge in DesignTokens.danger with no tint (blocked/error, per the spec's `rowDanger`). The two are mutually exclusive — a selected row's selected wins if both are somehow set, since an open/selected record is the more specific fact in the moment. Full state contract: enabled · hover (DesignTokens.rowHover wash, pointer enhancement only, suppressed while selected) · focus-visible (1px solid accent, zero offset) · pressed (1px translateY on the content, only when onTap is set) · disabled (no onTap → not tappable, no hover) · selected / danger (edge + tint, above). Row height is at least DesignTokens.touch (44 logical px). No ripple. ```dart AppListItem( leading: const AppIdChip(id: 'WO-2041'), title: 'Replace pump seal', subtitle: 'Site 4 — North wing', meta: 'upd 09:41', trailing: const KitIcon(KitGlyph.open), onTap: () => openRecord('WO-2041'), ) AppListItem( title: 'Blocked work order', danger: true, onTap: () => openRecord('WO-2099'), ) ```

AppListItemdefault constructor

Knob	Type	Default	What it does
action	Widget?	null	The row's ONE primary verb (`List.d.ts` `rowAction`/`action`, 2026-08-17) — an end-slot widget rendered BESIDE trailing, before it. For state-driven rows whose next action must be one tap (Download a ready file, Retry a failed run, Cancel a queued one) — burying the verb in the ⋯ menu was rejected…
checkbox	Widget?	null	Selection-mode checkbox, supplied and wired by AppList — a bare AppListItem composed directly by a caller may also pass one, but the common case is AppList wiring this from its own `selectable` state. Renders in a fixed leading slot before leading.
danger	bool	false	Blocked/error grammar: 2px DesignTokens.edge danger start-edge, no tint wash. Ignored when selected is also true.
leading	Widget?	null	Optional leading identity slot — an AppIdChip, a framed thumbnail, an avatar. Any widget; AppListItem does not constrain its shape beyond vertical centering.
meta	String?	null	Optional trailing machine text (DesignTokens.dataS/ DesignTokens.ink60) — a timestamp, a count, a status word. Right- aligned above trailing when both are present.
metaFormat	FormatRule<Object?>?	null	The resolved rule the meta line wears, every paint, the data font kept. Null: the plain line.
note	Widget?	null	A SECOND quiet line in the start column, under subtitle — a WIDGET, not a string, for the one shape a string cannot carry: a live FACT plus the inline affordance that acts on it. `List.d.ts` types the supporting slot as a NODE; this kit narrowed it to a `String`, which is right for the ordinary…
onTap	VoidCallback?	null	Row-tap callback — opens the record. Null renders a non-interactive row (no hover/focus/press paint, no Semantics tap action) — the shape AppList uses while in selection mode is still this same callback wired to toggle selection, so "non-interactive" is genuinely rare (a row with truly nothing to…
selected	bool	false	Selection/open-record grammar: 2px DesignTokens.edge accent start-edge over DesignTokens.rowSel tint. Same encoding a selected table row carries.
semanticLabel	String?	null	Overrides the row's accessible name. Defaults to title (the subtitle and meta are not concatenated in — a screen reader announces the record's name, not its full row text), then titleFormat's label when it has one ("Tank 4, Below minimum").
status	String?	null	Optional status word — the spec's first-class `status` slot, stacked below meta in the right-aligned side column. A status is a WORD (encode once): rendered through the shared cell grammar (`appCellContent`, AppCellType.enumValue) as neutral DesignTokens.body/DesignTokens.ink60 — never a pill, never…
statusDanger	bool	false	Paints status in the danger role — DesignTokens.danger color AND em weight, the spec's `statusDanger` (color only where action is demanded). Ignored when status is absent.
subtitle	String?	null	Optional supporting text (DesignTokens.body/DesignTokens.ink60), e.g. a site name or parent record. Clamped to subtitleMaxLines (default one line), then ellipsized.
subtitleFormat	FormatRule<Object?>?	null	The resolved rule the supporting line (subtitle, `List.d.ts`'s `supporting`) wears, every paint ('tag' plates it on one line). Null: the plain line.
subtitleMaxLines	int	1	Line clamp for subtitle. Defaults to 1 (the canonical single-line supporting text); raise it when the supporting text must survive compact widths without truncating (e.g. a two-line description row).
title *	String	—	The record's primary label. Clamped to two lines (DesignTokens.bodyEm).
titleFormat	FormatRule<Object?>?	null	FORMAT RULES ON A ROW'S LINES (`List.d.ts`, #1006): the RESOLVED rule the title line wears — the resolver's output (resolveFormat), never a list. On the title 'tag' reads as 'ink' (a plated name is a badge) and `em` adds nothing. Null: the plain line, as before.
trailing	Widget?	null	Optional trailing widget — a chevron (`onTap`-only rows that merely navigate) or a single always-visible action / `⋯` menu. Never rendered conditionally on hover: the constitution bans hover-revealed row actions outright, and touch surfaces have no hover to reveal on.

Types its knobs take

These are not things you choose — they are the shapes the knobs above expect. They live under this entry rather than in the navigation for exactly that reason.

FormatRule support

One FORMAT RULE (`FormatRules.d.ts` THE FORMAT RULE): a match and its effects. A rule list is ORDERED and the FIRST holding rule formats the value; a rule with no match always holds, so written last it is the column's default.

Field	Type	Default	What it does
color	KitColor?	null	A palette name or a color parsed from data — on a map pin, its FILL.
em	bool	false	The word at the em weight.
glyph	KitIconRef?	null	A glyph — on a map pin, the head's glyph.
italic	bool	false	The word italic.
label	String?	null	What the rule means, in the host's words — read by a legend, a chip and the accessible name.
match	FormatMatch<T>?	null	The predicate, or null for "always holds" (the default rule).
muted	bool	false	The word at ink40 (ignored under FormatPaint.ink and FormatPaint.tag).
paint	FormatPaint	FormatPaint.mark	How color lands on a value (FormatPaint.mark by default).
strike	bool	false	The word struck through, in its own ink.

Where it lives

Class	File
AppList	packages/app_widgets/lib/src/kit/data/list.dart
AppListItem	packages/app_widgets/lib/src/kit/data/list.dart