@crystal-ui/core 2.3.0 → 2.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/README.md +82 -23
  2. package/assets/core/preferences.d.ts +4 -4
  3. package/assets/core/preferences.js +4 -4
  4. package/assets/core/presets.d.ts +4 -3
  5. package/assets/core/presets.js +24 -18
  6. package/assets/core/spring.js +9 -10
  7. package/assets/core/state.js +7 -7
  8. package/assets/crystal.css +784 -284
  9. package/assets/crystal.d.ts +3 -3
  10. package/assets/crystal.js +100 -123
  11. package/assets/icons/heading-2.svg +1 -0
  12. package/assets/icons/heading-3.svg +1 -0
  13. package/assets/icons/heading-4.svg +1 -0
  14. package/assets/icons/link.svg +1 -0
  15. package/assets/icons/list-ordered.svg +1 -0
  16. package/assets/icons/list.svg +1 -0
  17. package/assets/icons/manifest.json +81 -2
  18. package/assets/icons/quote.svg +1 -0
  19. package/assets/icons/redo.svg +1 -0
  20. package/assets/icons/subscript.svg +1 -0
  21. package/assets/icons/undo.svg +1 -0
  22. package/assets/icons/unlink.svg +1 -0
  23. package/assets/motion.js +13 -12
  24. package/docs/accessibility.md +50 -54
  25. package/docs/adoption.md +33 -19
  26. package/docs/catalogue.md +113 -108
  27. package/docs/colors.md +67 -73
  28. package/docs/components.md +142 -66
  29. package/docs/icons.md +9 -3
  30. package/docs/materials.md +129 -117
  31. package/docs/motion-components.md +15 -15
  32. package/docs/motion.md +156 -158
  33. package/docs/principles.md +12 -12
  34. package/docs/tokens.md +129 -130
  35. package/engines.js +3 -3
  36. package/package.json +11 -3
  37. package/tokens/catalogue/01-layout.json +1 -1
  38. package/tokens/catalogue/02-navigation.json +4 -4
  39. package/tokens/catalogue/03-actions.json +2 -1
  40. package/tokens/catalogue/04-inputs.json +30 -22
  41. package/tokens/catalogue/05-data-display.json +9 -14
  42. package/tokens/catalogue/06-feedback.json +8 -6
  43. package/tokens/catalogue/07-overlays.json +4 -4
  44. package/tokens/catalogue/08-typography.json +12 -8
  45. package/tokens/catalogue/09-utility.json +1 -1
  46. package/tokens/catalogue/10-charts.json +7 -7
  47. package/tokens/catalogue/11-media.json +33 -20
  48. package/tokens/catalogue/12-commerce.json +4 -4
  49. package/tokens/catalogue/13-screens.json +2 -3
  50. package/tokens/catalogue/14-blocks.json +3 -3
  51. package/tokens/catalogue.json +176 -116
  52. package/tokens/crystal.tokens.json +6 -6
  53. package/tokens/motion-recipes.json +6 -6
  54. package/tokens/surface-recipes.json +3452 -0
  55. package/tokens/surfaces.json +48 -17
package/docs/catalogue.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # Component catalogue
2
2
 
3
- Crystal specifies **284 components** across 14 categories. Parity is measured against the most fully-featured libraries in use — Mantine, Ant Design and MUI — rather than a shorter list Crystal finds convenient.
3
+ Crystal specifies 284 components across 14 categories. Parity is measured against Mantine, Ant Design and MUI, and each entry names the components it corresponds to in them.
4
4
 
5
- Crystal specifies appearance: anatomy, states, material, geometry and the semantics a correct implementation must expose. It does not ship focus management, menu keyboard behaviour, date arithmetic or a rich-text engine. Products bring their own accessible primitives and dress them in Crystal. Every entry states this split explicitly, so what the system owes you and what you owe the system are never in doubt.
5
+ Crystal specifies appearance: anatomy, states, material, geometry and the semantics a correct implementation must expose. It does not ship focus management, menu keyboard behaviour, date arithmetic or a rich-text engine. Products bring their own accessible primitives and style them with Crystal. Every entry says which parts Crystal supplies and which parts the product owns.
6
6
 
7
7
  This chapter is generated from `core/tokens/catalogue/`. The same source generates the parity manifest in `libraries/parity.json`, so a component cannot appear in one and not the other.
8
8
 
@@ -13,7 +13,7 @@ This chapter is generated from `core/tokens/catalogue/`. The same source generat
13
13
  | [Layout and structure](#layout-and-structure) | 14 | 0 |
14
14
  | [Navigation](#navigation) | 17 | 15 |
15
15
  | [Actions](#actions) | 9 | 9 |
16
- | [Inputs and forms](#inputs-and-forms) | 52 | 44 |
16
+ | [Inputs and forms](#inputs-and-forms) | 52 | 45 |
17
17
  | [Data display](#data-display) | 36 | 27 |
18
18
  | [Feedback and status](#feedback-and-status) | 15 | 14 |
19
19
  | [Overlays](#overlays) | 11 | 9 |
@@ -24,37 +24,37 @@ This chapter is generated from `core/tokens/catalogue/`. The same source generat
24
24
  | [Commerce](#commerce) | 24 | 15 |
25
25
  | [Screens](#screens) | 15 | 10 |
26
26
  | [Blocks](#blocks) | 20 | 6 |
27
- | **Total** | **284** | **162** |
27
+ | **Total** | **284** | **163** |
28
28
 
29
29
  ## Surfaces
30
30
 
31
- Every component is made of one or more of these, named in its **Surface** row, outer to inner. The vocabulary is `core/tokens/surfaces.json`; each surface is implemented by the `crystal.css` recipe shown, and the build refuses a component naming a surface that has no recipe. A library implements the surface once and every component made of it inherits the implementation — which is what keeps two hundred components from becoming two hundred recipes.
31
+ Every component is made of one or more of these surfaces. Its Surface row names them, outer to inner. The vocabulary is `core/tokens/surfaces.json`. Each surface is implemented by the `crystal.css` recipe shown, and the build refuses a component that names a surface with no recipe. A library implements each surface once, and every component made of that surface uses the implementation.
32
32
 
33
33
  | Surface | Materials | Recipe | Components | Use |
34
34
  | --- | --- | --- | --- | --- |
35
35
  | <a id="surface-plastic"></a>**Plastic foundation** `plastic` | Plastic | <code>.cr-plastic</code> | 6 | The root scene or window. One contextual, opaque foundation per view; never a component. |
36
- | <a id="surface-frost"></a>**Frost panel** `frost` | Frost | <code>.cr-frost</code> | 45 | Intermediate task frames and every transient surface that opens over content: side panels, drawers, sheets, app bars, and — at Meridian's direction (R15e) — menus, popovers, tooltips and toasts. Reading content inside it sits on Haze. |
37
- | <a id="surface-haze"></a>**Haze reading surface** `haze` | Haze | <code>.cr-haze</code> | 82 | Anything read: cards, rows, panels, wells, forms, messages, decisions. 80% fill, 1.95px feather on an isolated paint layer, crisp foreground. `.cr-well` is the same recipe recessed into a Frost or Resin frame. `.cr-haze.overlay` is the recessed overlay: a transient overlay opened inside a pane that is already lifted, drawn as a flat Haze fill with the `--cr-edge` rim and the content shadow, so it can be told from the pane it sits in. |
38
- | <a id="surface-resin"></a>**Resin plane** `resin` | Resin | <code>.cr-resin</code> | 7 | One floating Resin plane with no reading fill of its own, pill-shaped unless it is a panel: a player's transport bar, a pinned element, a Resin handle over imagery or between regions. Controls inside it lose their own backdrop filter — Resin never contains Resin. A plane whose controls are labels to be read holds a Haze fill as well, and is a dock. |
36
+ | <a id="surface-frost"></a>**Frost panel** `frost` | Frost | <code>.cr-frost</code> | 48 | Intermediate task frames and every transient surface that opens over content: side panels, drawers, sheets and app bars, and menus, popovers, tooltips and toasts (R15e). Reading content inside it sits on Haze. `.cr-frost.bar` is a transient overlay shaped as a row of controls, a pill with 4px padding: the selection toolbar over highlighted text. |
37
+ | <a id="surface-haze"></a>**Haze reading surface** `haze` | Haze | <code>.cr-haze</code> | 85 | Anything read: cards, rows, panels, wells, forms, messages, decisions. 80% fill, 1.95px feather on an isolated paint layer, crisp foreground. `.cr-well` is the same recipe recessed into a Frost or Resin frame. `.cr-haze.overlay` is the recessed overlay: a transient overlay opened inside a pane that is already lifted, drawn as a flat Haze fill with the `--cr-edge` rim and the content shadow, so it can be told from the pane it sits in. |
38
+ | <a id="surface-resin"></a>**Resin plane** `resin` | Resin | <code>.cr-resin</code> | 9 | One floating Resin plane with no reading fill of its own, pill-shaped unless it is a panel: a player's transport bar, a pinned element, a Resin handle over imagery or between regions. Controls inside it lose their own backdrop filter, because Resin never contains Resin. A plane whose controls are labels to be read holds a Haze fill as well, and is a dock. `.cr-resin.transport` is the media transport: the pill with 4px block and 12px inline padding around its 48px controls (58px tall with its rim), with tabular time readouts, wrapping to a second row in a player narrower than 420px. `.cr-media` is the stage it sits on (the content radius, the letterbox, `--cr-media-aspect` and `--cr-media-fit`), and `.cr-media-bar` is the region inset 12px, or the safe area in full screen, that holds the transport. |
39
39
  | <a id="surface-resin-panel"></a>**Resin panel** `resin-panel` | Resin | <code>.cr-resin.panel</code> | 1 | The Resin plane with the content radius instead of the pill, for a floating control plane that is a rectangle: a floating window, a media control bar wider than it is tall. Same fill, rim, blur and float shadow; only the geometry changes. |
40
- | <a id="surface-control"></a>**Resin control** `control` | Resin + Haze | <code>.cr-button</code> | 16 | An action: a Resin shell with the 8px-inset Haze reading pad and the optical sheen. Pill geometry. `.primary` tints the pad, `.quiet` removes it, `.danger` adds the destructive boundary. Selected state is the primary pad plus label weight 800. |
41
- | <a id="surface-field"></a>**Field shell** `field` | Resin + Haze | <code>.cr-field-shell</code> | 28 | The Resin surround of a native text entry, with the Haze well the value is read on and the circular field-state badge. The native control keeps its functional boundary and semantics. |
42
- | <a id="surface-compact"></a>**Compact display** `compact` | Resin + Haze | <code>.cr-resin-haze</code> | 5 | Small information displays that sit on content: tags, badges, labels, keyboard caps. A Resin shell with the inset Haze pad, 18px radius. Not for anything that opens — transient overlays are Frost. `.count` is the size for a count: a 20px circle that grows to a pill, filled to its own edge, with no block padding. |
43
- | <a id="surface-stone"></a>**Stone label backing** `stone` | Stone | <code>.cr-stone</code> | 2 | A label over an unknown or moving backdrop — a caption on media, a status bar over a scene. 55% light / 60% dark fill, feathered like Haze, crisp text. |
40
+ | <a id="surface-control"></a>**Resin control** `control` | Resin + Haze | <code>.cr-button</code> | 16 | An action: a Resin shell with the 8px-inset Haze reading pad and the optical sheen. Pill geometry with `.cr-button`, which coats a `button` or an `a`; `.cr-control` coats any element. `.primary` tints the pad, `.quiet` removes it, `.danger` adds the destructive boundary. Selected state is the primary pad plus label weight 800. |
41
+ | <a id="surface-field"></a>**Field shell** `field` | Resin + Haze | <code>.cr-field-shell</code> | 28 | The Resin surround of a native text entry, with the Haze well the value is read on and the circular field-state badge. The native control keeps its functional boundary and semantics. `.cr-editor` is the editable surface inside a rich text field: the shared prose vocabulary (headings, lists, checklists, marks, insertions and deletions) with the primary caret and a 28% primary selection, distinct from the primary-soft highlight (D-34). `.cr-editor-toolbar` is its toolbar, above the text on a fine pointer and below it, clear of the touch keyboard, on a coarse one. |
42
+ | <a id="surface-compact"></a>**Compact display** `compact` | Resin + Haze | <code>.cr-resin-haze</code> | 5 | Small information displays that sit on content: tags, badges, labels, keyboard caps. A Resin shell with the inset Haze pad, 18px radius. Not for anything that opens. Transient overlays are Frost. `.count` is the size for a count: a 20px circle that grows to a pill, filled to its own edge, with no block padding. |
43
+ | <a id="surface-stone"></a>**Stone label backing** `stone` | Stone | <code>.cr-stone</code> | 3 | A label over an unknown or moving backdrop: a caption on media, a status bar over a scene. 55% light / 60% dark fill, feathered like Haze, crisp text. `.cr-media-caption` is a caption cue rendered by the library: the Stone backing on a box above the transport, never under it. `::cue` on a `.cr-media` video is the flat fill for the browser's own renderer. |
44
44
  | <a id="surface-mirage"></a>**Mirage scrim** `mirage` | Mirage | <code>.cr-mirage</code> | 10 | The chromatic diffusion of the real scene behind a modal. Never a content surface; the decision surface above it is Haze. |
45
45
  | <a id="surface-dialog"></a>**Dialog** `dialog` | Haze + Mirage | <code>.cr-dialog</code> | 2 | A Haze decision surface over a Mirage scrim, with the float shadow. Modality, focus and dismissal are the product's. The surface does not scroll: `.cr-dialog-body`, worn with `.cr-scroll-frost`, scrolls inside it, so the title stays in view and the edge fade does not dissolve the surface. `position: fixed` is for a native `&lt;dialog&gt;`; on any other element the host positions it. |
46
46
  | <a id="surface-indicator"></a>**Indicator** `indicator` | Haze | <code>.cr-indicator</code> | 2 | A 20px informational circle painting Haze on an isolated layer, or the moving pill behind a selected segment. Haze rather than Resin, because it sits on a surface that is often already translucent. Never a selection mark. |
47
47
  | <a id="surface-status"></a>**Status badge** `status` | Resin + Haze | <code>.cr-status</code> | 1 | The semantic ink and surface pair behind a symbol, with words beside it. Status colours are independent of the palette and are never redefined by it. |
48
48
  | <a id="surface-bubble"></a>**Authored bubble** `bubble` | Haze | <code>.cr-bubble</code> | 1 | A Haze message surface with a directional tight corner. `.own` uses the palette's own-content pair. |
49
49
  | <a id="surface-table"></a>**Table** `table` | Resin + Haze | <code>.cr-table-scroll</code> | 5 | A Resin shell with an inset Haze fill holding the table, with the primary-soft header and the Resin scrollbar. Rows are read on the Haze; sort and selection are announced, and selection is label weight. |
50
- | <a id="surface-dock"></a>**Dock** `dock` | Resin + Haze | <code>.cr-dock</code> | 8 | A Resin plane holding labelled controls on one Haze fill, so every label reads on the same protected ground: a dock of destinations, and the strips that group controls the same way — tab strips, segmented controls, toolbars, command and action bars. The controls inside are transparent; the current or selected one takes weight 800 and the primary fill, whether it is a dock's destination, a tab or a segment. The controls may be buttons, tabs (`[role=tab]`, selected by `aria-selected`), radio labels (selected by `:checked`) or links (current by `aria-current`); only buttons were reached before 2.3.0. |
50
+ | <a id="surface-dock"></a>**Dock** `dock` | Resin + Haze + Stone | <code>.cr-dock</code> | 8 | A Resin plane with a Haze perimeter, holding labelled controls on one Stone label backing (`.cr-dock-inner`), so every label reads on the same protected ground: a dock of destinations, and the strips that group controls the same way (tab strips, segmented controls, toolbars, command and action bars). The controls inside are transparent; the current or selected one takes weight 800 and the primary fill, whether it is a dock's destination, a tab or a segment. The controls may be buttons, tabs (`[role=tab]`, selected by `aria-selected`), radio labels (selected by `:checked`) or links (current by `aria-current`); only buttons were reached before 2.3.0. |
51
51
  | <a id="surface-group"></a>**Group** `group` | Resin + Haze | <code>.cr-group</code> | 2 | A Resin plane whose controls touch: button groups and split buttons. The silhouette is one pill, the interior corners square off against their neighbours, and a hairline in `--cr-edge` separates them. The children keep their fill and give up their own elevation and diffusion, because the plane is the group's. `.vertical` stacks them. Not a dock: a dock spaces its controls apart on its Haze fill. |
52
- | <a id="surface-nav-item"></a>**Navigation entry** `nav-item` | Plastic | <code>.cr-nav-item</code> | 2 | An entry in side navigation, a rail or a tree of destinations. It has no material of its own — it is furniture on the panel beneath it — and carries selection by label weight alone. Pill hit area, 44px target. `.stacked` puts the icon above the label for a rail. Adopted from the documentation site's side menu, which docs/components.md names as the reference implementation of selection. |
53
- | <a id="surface-bare"></a>**Bare control** `bare` | — | <code>.cr-bare</code> | 0 | A control that must not wear the Resin coat because it sits inside a surface that already has one: a disclosure chevron, a chip's remove button, a sort header, a stepper's arrows, a dismiss button on a toast. Crystal paints every button by element, so bare means subtracting the fill, the shadow, the backdrop filter and both pseudo-layers — this class does all four. The focus ring and the target floor stay. |
54
- | <a id="surface-drag-handle"></a>**Drag handle** `drag-handle` | — | <code>.cr-drag-handle</code> | 1 | A bare control with a grip glyph and a lift while dragging. Keyboard drag is the product's; the handle only says it can be grabbed and when it has been. |
52
+ | <a id="surface-nav-item"></a>**Navigation entry** `nav-item` | None | <code>.cr-nav-item</code> | 2 | An entry in side navigation, a rail or a tree of destinations. It has no material of its own, sits on the panel beneath it, and carries selection by label weight alone. Pill hit area, 44px target. `.stacked` puts the icon above the label for a rail. Adopted from the documentation site's side menu, which docs/components.md names as the reference implementation of selection. |
53
+ | <a id="surface-bare"></a>**Bare control** `bare` | None | <code>.cr-bare</code> | 0 | A control that must not wear the Resin coat because it sits inside a surface that already has one: a disclosure chevron, a chip's remove button, a sort header, a stepper's arrows, a dismiss button on a toast. Crystal paints every button by element, so this class subtracts the fill, the shadow, the backdrop filter and both pseudo-layers. The focus ring and the target floor stay. |
54
+ | <a id="surface-drag-handle"></a>**Drag handle** `drag-handle` | None | <code>.cr-drag-handle</code> | 1 | A bare control with a grip glyph and a lift while dragging. Keyboard drag is the product's; the handle only says it can be grabbed and when it has been. |
55
55
  | <a id="surface-choice"></a>**Selection control** `choice` | Resin | <code>input:is([type=checkbox],[type=radio])</code> | 5 | Native checkbox, radio, switch and range, styled by element: a Resin box, circle or track with a contained mark, and the marked glass thumb. Semantics stay native. |
56
- | <a id="surface-native"></a>**Native control furniture** `native` | — | <code>select option</code> | 0 | Parts of native controls the browser draws and Crystal tints: select options, the file button. Platform-owned popups keep platform drawing. |
57
- | <a id="surface-none"></a>**No surface of its own** `none` | — | — | 109 | Layout, typography, behaviour and drawing components that inherit whatever they sit on. A chart's marks, a divider, a provider. Nothing to paint and nothing to wear. |
56
+ | <a id="surface-native"></a>**Native control furniture** `native` | None | <code>select option</code> | 0 | Parts of native controls the browser draws and Crystal tints: select options, the file button. Platform-owned popups keep platform drawing. |
57
+ | <a id="surface-none"></a>**No surface of its own** `none` | None | None | 107 | Layout, typography, behaviour and drawing components that inherit whatever they sit on. A chart's marks, a divider, a provider. |
58
58
 
59
59
  ## Layout and structure
60
60
 
@@ -231,7 +231,7 @@ A Frost band across the top of a view, holding a title, navigation affordances a
231
231
 
232
232
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
233
233
  <tr><th scope="row">States</th><td>at-rest, scrolled, condensed</td></tr>
234
- <tr><th scope="row">Material</th><td>Frost band over the Plastic foundation</td></tr>
234
+ <tr><th scope="row">Material</th><td>Frost band over the view's foundation</td></tr>
235
235
  <tr><th scope="row">Surface</th><td><a href="#surface-frost">Frost panel</a></td></tr>
236
236
  <tr><th scope="row">Geometry</th><td>Full-bleed; no radius on the outer edges; actions are pills.</td></tr>
237
237
  <tr><th scope="row">Semantics</th><td>role="banner" unless nested; the title is the page heading or labels one.</td></tr>
@@ -446,10 +446,10 @@ Nested disclosure rows with indentation guides and expand controls.
446
446
  <tr><th scope="row">Material</th><td>Haze rows on the surrounding surface</td></tr>
447
447
  <tr><th scope="row">Surface</th><td><a href="#surface-haze">Haze reading surface</a></td></tr>
448
448
  <tr><th scope="row">Geometry</th><td>Indent step 20px; guides use the edge token</td></tr>
449
- <tr><th scope="row">Semantics</th><td>role=treegrid/row/gridcell with aria-expanded, aria-level, aria-posinset, aria-setsize and full arrow-key navigation. Not role=tree: a treeitem is a single navigable unit, so it cannot contain the expand control this anatomy requires — treegrid is the pattern ARIA provides for a row that holds its own control. See M-3.</td></tr>
449
+ <tr><th scope="row">Semantics</th><td>role=treegrid/row/gridcell with aria-expanded, aria-level, aria-posinset, aria-setsize and full arrow-key navigation. Not role=tree: a treeitem is a single navigable unit, so it cannot contain the expand control this anatomy requires, and treegrid is the pattern ARIA provides for a row that holds its own control. See M-3.</td></tr>
450
450
  <tr><th scope="row">Crystal supplies</th><td>Row treatment, indentation guides, label weight for the selected row</td></tr>
451
451
  <tr><th scope="row">Product owns</th><td>The keyboard navigation implementation, data and lazy loading</td></tr>
452
- <tr><th scope="row">Motion</th><td><code>accordion-in</code>, <code>accordion-out</code></td></tr>
452
+ <tr><th scope="row">Motion</th><td><code>accordion-in</code></td></tr>
453
453
  <tr><th scope="row">Parity</th><td>mantine:Tree · mui:TreeView · antd:Tree</td></tr>
454
454
  </tbody></table></div>
455
455
 
@@ -532,6 +532,8 @@ A horizontal bar of menu triggers, each opening its own menu.
532
532
  <tr><th scope="row">Parity</th><td>react-aria:Menu · primereact:menubar · antd:Menu</td></tr>
533
533
  </tbody></table></div>
534
534
 
535
+ > Each menu the bar opens is the product's child, a menu entry of its own. The bar owns the triggers and their roving focus; menu-in and menu-out are played by the menu the product renders, not by the bar.
536
+
535
537
  ### Submenu
536
538
 
537
539
  A menu opened from an item inside another menu.
@@ -616,6 +618,8 @@ A default action and an adjacent disclosure that opens related actions.
616
618
  <tr><th scope="row">Parity</th><td>antd:Dropdown.Button · mui:ButtonGroup · mantine:Menu</td></tr>
617
619
  </tbody></table></div>
618
620
 
621
+ > The menu the disclosure opens is the product's child, a menu entry of its own. The split button owns the two segments and the disclosure; menu-in and menu-out are played by the menu the product renders, not by the button.
622
+
619
623
  ### Floating action
620
624
 
621
625
  A persistent circular Resin action floating above content.
@@ -804,13 +808,13 @@ A text field with a filtered popover list, keyboard highlight and optional creat
804
808
 
805
809
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
806
810
  <tr><th scope="row">States</th><td>idle, focus, open, filtering, empty, loading, invalid, disabled</td></tr>
807
- <tr><th scope="row">Material</th><td>Resin field shell, Resin popover with Haze rows</td></tr>
811
+ <tr><th scope="row">Material</th><td>Resin field shell, Frost popover with Haze rows (R15e)</td></tr>
808
812
  <tr><th scope="row">Surface</th><td><a href="#surface-field">Field shell</a> → <a href="#surface-frost">Frost panel</a></td></tr>
809
813
  <tr><th scope="row">Geometry</th><td>Popover content radius; rows inset 8px</td></tr>
810
814
  <tr><th scope="row">Semantics</th><td>role=combobox with aria-expanded, aria-controls and aria-activedescendant; the list is never focus-stealing</td></tr>
811
815
  <tr><th scope="row">Crystal supplies</th><td>Field and popover material, row treatment, label weight for selection, empty and loading appearance</td></tr>
812
816
  <tr><th scope="row">Product owns</th><td>The accessible combobox implementation, filtering and async loading</td></tr>
813
- <tr><th scope="row">Motion</th><td><code>popover-in</code>, <code>popover-out</code>, <code>list-in</code></td></tr>
817
+ <tr><th scope="row">Motion</th><td><code>popover-in</code>, <code>popover-out</code></td></tr>
814
818
  <tr><th scope="row">Parity</th><td>mantine:Autocomplete · mui:Autocomplete · antd:AutoComplete</td></tr>
815
819
  </tbody></table></div>
816
820
 
@@ -846,7 +850,7 @@ A luminous Resin box with a contained contrast-bearing mark, plus its label.
846
850
  <tr><th scope="row">Parity</th><td>mantine:Checkbox · mui:Checkbox · antd:Checkbox</td></tr>
847
851
  </tbody></table></div>
848
852
 
849
- > The checked mark is a check glyph. That is the control's own semantics — a validated, entered value — not a selection badge placed over a focused item.
853
+ > The checked mark is a check glyph. That is the control's own semantics (a validated, entered value), not a selection badge placed over a focused item.
850
854
 
851
855
  ### Checkbox group
852
856
 
@@ -918,7 +922,7 @@ A value-driven track with a marked glass thumb, optional ticks and a visible val
918
922
  <tr><th scope="row">States</th><td>default, hover, focus, dragging, disabled</td></tr>
919
923
  <tr><th scope="row">Material</th><td>Primary fill to the value, primary-soft beyond; Resin thumb</td></tr>
920
924
  <tr><th scope="row">Surface</th><td><a href="#surface-choice">Selection control</a></td></tr>
921
- <tr><th scope="row">Geometry</th><td>8px track, 26px thumb; the thumb is the target and meets 44px in practice through padding</td></tr>
925
+ <tr><th scope="row">Geometry</th><td>8px track, 26px thumb; the thumb is the target and meets 44px through padding</td></tr>
922
926
  <tr><th scope="row">Semantics</th><td>Native range or role=slider with aria-valuenow, valuemin, valuemax and valuetext</td></tr>
923
927
  <tr><th scope="row">Crystal supplies</th><td>Track fill, thumb material, tick treatment, RTL mirroring</td></tr>
924
928
  <tr><th scope="row">Product owns</th><td>Step, bounds and what the value drives</td></tr>
@@ -1118,7 +1122,7 @@ A named file action with selected-file rows and per-file removal.
1118
1122
  <tr><th scope="row">Parity</th><td>mantine:FileInput · mui:— · antd:Upload</td></tr>
1119
1123
  </tbody></table></div>
1120
1124
 
1121
- > Crystal supplies appearance only. A file input that does not actually upload must not be presented as working.
1125
+ > Crystal supplies appearance only. A file input that does not upload must not be presented as working.
1122
1126
 
1123
1127
  ### Dropzone
1124
1128
 
@@ -1178,7 +1182,7 @@ Two lists with controls that move items between them.
1178
1182
  <tr><th scope="row">Semantics</th><td>Each list is separately named; moves are announced; keyboard must move items without drag</td></tr>
1179
1183
  <tr><th scope="row">Crystal supplies</th><td>Panel and action treatment, label weight for selection in the lists</td></tr>
1180
1184
  <tr><th scope="row">Product owns</th><td>The data, move rules and filtering</td></tr>
1181
- <tr><th scope="row">Motion</th><td><code>list-in</code>, <code>list-out</code></td></tr>
1185
+ <tr><th scope="row">Motion</th><td><code>list-in</code></td></tr>
1182
1186
  <tr><th scope="row">Parity</th><td>antd:Transfer · mui:— · mantine:TransferList</td></tr>
1183
1187
  </tbody></table></div>
1184
1188
 
@@ -1188,7 +1192,7 @@ Progressive columns narrowing a hierarchical selection.
1188
1192
 
1189
1193
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
1190
1194
  <tr><th scope="row">States</th><td>idle, open, partial, complete, loading, disabled</td></tr>
1191
- <tr><th scope="row">Material</th><td>Resin popover, Haze columns</td></tr>
1195
+ <tr><th scope="row">Material</th><td>Frost popover with Haze columns (R15e), from a Resin field shell</td></tr>
1192
1196
  <tr><th scope="row">Surface</th><td><a href="#surface-field">Field shell</a> → <a href="#surface-frost">Frost panel</a> → <a href="#surface-haze">Haze reading surface</a></td></tr>
1193
1197
  <tr><th scope="row">Geometry</th><td>Content radius; columns separated by a hairline</td></tr>
1194
1198
  <tr><th scope="row">Semantics</th><td>Each column is a listbox; the composed value is announced as a path</td></tr>
@@ -1204,7 +1208,7 @@ A text surface that offers a filtered list after a trigger character.
1204
1208
 
1205
1209
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
1206
1210
  <tr><th scope="row">States</th><td>idle, triggered, filtering, empty, disabled</td></tr>
1207
- <tr><th scope="row">Material</th><td>Resin popover with Haze rows over the field</td></tr>
1211
+ <tr><th scope="row">Material</th><td>Frost popover with Haze rows over the field (R15e)</td></tr>
1208
1212
  <tr><th scope="row">Surface</th><td><a href="#surface-frost">Frost panel</a> → <a href="#surface-haze">Haze reading surface</a></td></tr>
1209
1213
  <tr><th scope="row">Geometry</th><td>Popover at content radius, anchored to the caret</td></tr>
1210
1214
  <tr><th scope="row">Semantics</th><td>Combobox semantics attached to the text surface; the inserted value is announced</td></tr>
@@ -1216,20 +1220,21 @@ A text surface that offers a filtered list after a trigger character.
1216
1220
 
1217
1221
  ### Rich text surface
1218
1222
 
1219
- A toolbar of formatting actions above an editable content surface.
1223
+ A formatting toolbar and an editable surface. The toolbar holds Crystal's format vocabulary in groups: the block type (paragraph, headings two to four, bulleted list, numbered list, checklist, quotation, code block), the marks (bold, italic, underline, strikethrough, inline code, highlight, link, subscript, superscript) and history (undo, redo). A selection toolbar of the commonest marks floats over highlighted text.
1220
1224
 
1221
1225
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
1222
- <tr><th scope="row">States</th><td>idle, focus, selection-active, disabled, read-only</td></tr>
1223
- <tr><th scope="row">Material</th><td>Resin toolbar, Haze editing surface</td></tr>
1224
- <tr><th scope="row">Surface</th><td><a href="#surface-field">Field shell</a></td></tr>
1225
- <tr><th scope="row">Geometry</th><td>Toolbar is a pill group; surface at content radius</td></tr>
1226
- <tr><th scope="row">Semantics</th><td>Toolbar actions use aria-pressed for active formatting; the editor exposes its own semantics</td></tr>
1227
- <tr><th scope="row">Crystal supplies</th><td>Toolbar and surface appearance, active-format treatment</td></tr>
1228
- <tr><th scope="row">Product owns</th><td>The entire editing engine, serialisation and paste handling</td></tr>
1226
+ <tr><th scope="row">States</th><td>idle, focus, selection-active, selection-toolbar-open, touch-keyboard-open, disabled, read-only</td></tr>
1227
+ <tr><th scope="row">Material</th><td>Resin toolbar, Haze editing surface; Frost selection toolbar</td></tr>
1228
+ <tr><th scope="row">Surface</th><td><a href="#surface-field">Field shell</a> → <a href="#surface-frost">Frost panel</a></td></tr>
1229
+ <tr><th scope="row">Geometry</th><td>Toolbar controls are 48px pills in separated groups on the field shell's Haze well; the surface keeps the content radius and the card padding (20px). On a fine pointer the toolbar sits above the text; on a coarse pointer it sits below the text and sticks above the on-screen keyboard.</td></tr>
1230
+ <tr><th scope="row">Semantics</th><td>Toolbar actions use aria-pressed for active formatting, and the block type is a single control naming the current type. A format changed by a keyboard shortcut while focus is in the text is announced politely. The editor exposes its own semantics: real headings, lists and checkboxes in the document, so a screen reader navigates it as it would the published page.</td></tr>
1231
+ <tr><th scope="row">Crystal supplies</th><td>Toolbar and surface appearance, active-format treatment, the format vocabulary and its rendering (shared with prose), the selection toolbar, toolbar placement on touch</td></tr>
1232
+ <tr><th scope="row">Product owns</th><td>The editing engine, serialisation and paste handling, and which parts of the format vocabulary a product offers</td></tr>
1233
+ <tr><th scope="row">Motion</th><td><code>field-focus</code>, <code>field-invalid</code>, <code>field-valid</code>, <code>menu-in</code>, <code>menu-out</code></td></tr>
1229
1234
  <tr><th scope="row">Parity</th><td>mantine:RichTextEditor · mui:— · antd:—</td></tr>
1230
1235
  </tbody></table></div>
1231
1236
 
1232
- > Crystal specifies the surface only. Do not rebuild a rich-text engine to obtain this appearance.
1237
+ > Crystal specifies the surface and the format vocabulary. Do not rebuild a rich-text engine to obtain this appearance; bind an existing one. A library may ship an optional binding of an engine from its own entry point, with the engine an optional peer dependency, so a product that never imports the binding never installs or bundles the engine. The format vocabulary is the contract a binding implements: every block type and mark it offers renders as the surface and prose render it (D-30).
1233
1238
 
1234
1239
  ### Helper text
1235
1240
 
@@ -1352,7 +1357,7 @@ A circular control for an angle.
1352
1357
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
1353
1358
  <tr><th scope="row">States</th><td>at-rest, dragging, focus-visible, disabled</td></tr>
1354
1359
  <tr><th scope="row">Material</th><td>Resin track with a Resin thumb</td></tr>
1355
- <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
1360
+ <tr><th scope="row">Surface</th><td><a href="#surface-resin">Resin plane</a></td></tr>
1356
1361
  <tr><th scope="row">Geometry</th><td>Circular; the thumb reaches 44px including its hit area.</td></tr>
1357
1362
  <tr><th scope="row">Semantics</th><td>role="slider" with aria-valuenow in degrees and a text equivalent.</td></tr>
1358
1363
  <tr><th scope="row">Crystal supplies</th><td>Track and thumb material, focus ring, motion on commit</td></tr>
@@ -1367,8 +1372,8 @@ A rotary control for a bounded value.
1367
1372
 
1368
1373
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
1369
1374
  <tr><th scope="row">States</th><td>at-rest, dragging, focus-visible, disabled</td></tr>
1370
- <tr><th scope="row">Material</th><td>Resin body with a Haze value arc</td></tr>
1371
- <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
1375
+ <tr><th scope="row">Material</th><td>Resin body with a primary value arc</td></tr>
1376
+ <tr><th scope="row">Surface</th><td><a href="#surface-resin">Resin plane</a></td></tr>
1372
1377
  <tr><th scope="row">Geometry</th><td>Circular; keyboard steps match the slider contract.</td></tr>
1373
1378
  <tr><th scope="row">Semantics</th><td>role="slider"; the value is readable as text, not only as an arc.</td></tr>
1374
1379
  <tr><th scope="row">Crystal supplies</th><td>Material, arc rendering, focus ring</td></tr>
@@ -1460,7 +1465,7 @@ One colour, shown as a surface.
1460
1465
 
1461
1466
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
1462
1467
  <tr><th scope="row">States</th><td>at-rest, selected, focus-visible</td></tr>
1463
- <tr><th scope="row">Material</th><td>Haze chequerboard beneath a transparent colour</td></tr>
1468
+ <tr><th scope="row">Material</th><td>A chequerboard beneath a transparent colour, so its alpha shows</td></tr>
1464
1469
  <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
1465
1470
  <tr><th scope="row">Geometry</th><td>Content radius; selection is a ring, never a check mark.</td></tr>
1466
1471
  <tr><th scope="row">Semantics</th><td>Carries the colour name as text, because colour cannot be the only carrier.</td></tr>
@@ -1547,7 +1552,7 @@ A Haze content surface with optional media, header, body and action row.
1547
1552
  <tr><th scope="row">Material</th><td>Haze, 80% fill with a 1.95px feathered perimeter</td></tr>
1548
1553
  <tr><th scope="row">Surface</th><td><a href="#surface-haze">Haze reading surface</a></td></tr>
1549
1554
  <tr><th scope="row">Geometry</th><td>Content radius; at least 12px between content and the feathered edge</td></tr>
1550
- <tr><th scope="row">Semantics</th><td>An article when it is content, a button when the whole card acts. Never both.</td></tr>
1555
+ <tr><th scope="row">Semantics</th><td>An article when it is content or a button when the whole card acts, never both.</td></tr>
1551
1556
  <tr><th scope="row">Crystal supplies</th><td>Fill, feather, elevation, interactive treatment</td></tr>
1552
1557
  <tr><th scope="row">Product owns</th><td>Content and what an interactive card does</td></tr>
1553
1558
  <tr><th scope="row">Motion</th><td><code>list-in</code>, <code>list-out</code></td></tr>
@@ -1584,7 +1589,7 @@ Table anatomy with sorting, filtering, selection, column sizing and pagination.
1584
1589
  <tr><th scope="row">Semantics</th><td>aria-sort on sorted headers; row selection through real checkboxes with names</td></tr>
1585
1590
  <tr><th scope="row">Crystal supplies</th><td>All Table treatment plus sort, filter and selection appearance</td></tr>
1586
1591
  <tr><th scope="row">Product owns</th><td>The data layer, virtualisation, and the sorting and filtering implementation</td></tr>
1587
- <tr><th scope="row">Motion</th><td><code>list-in</code>, <code>list-out</code>, <code>highlight</code></td></tr>
1592
+ <tr><th scope="row">Motion</th><td><code>list-in</code>, <code>highlight</code></td></tr>
1588
1593
  <tr><th scope="row">Parity</th><td>mui:DataGrid · antd:Table · mantine:DataTable</td></tr>
1589
1594
  </tbody></table></div>
1590
1595
 
@@ -1681,15 +1686,15 @@ A semantic symbol in a circular well, followed by a visible word.
1681
1686
  <tr><th scope="row">Parity</th><td>mantine:Badge · mui:Chip · antd:Tag</td></tr>
1682
1687
  </tbody></table></div>
1683
1688
 
1684
- > Success uses a check mark. That is information display — the legitimate use of the glyph.
1689
+ > Success uses a check mark. That is information display, the legitimate use of the glyph.
1685
1690
 
1686
1691
  ### Indicator
1687
1692
 
1688
- A small circular Resin mark attached to a control, carrying state.
1693
+ A small circular Haze mark attached to a control, carrying state.
1689
1694
 
1690
1695
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
1691
1696
  <tr><th scope="row">States</th><td>selection, current, busy, field-idle, field-focused, required, invalid</td></tr>
1692
- <tr><th scope="row">Material</th><td>Haze: a 20px circle painting the Haze fill on an isolated layer with a 1px feather; no Resin, because it sits on surfaces that are often already translucent</td></tr>
1697
+ <tr><th scope="row">Material</th><td>Haze: a 20px circle painting the Haze fill on an isolated layer with a 1px feather, and no coat of its own, because it sits on surfaces that are often already translucent</td></tr>
1693
1698
  <tr><th scope="row">Surface</th><td><a href="#surface-indicator">Indicator</a></td></tr>
1694
1699
  <tr><th scope="row">Geometry</th><td>20px, or 24px on fields; never a click target</td></tr>
1695
1700
  <tr><th scope="row">Semantics</th><td>aria-hidden. The real control supplies the state; the mark only shows it.</td></tr>
@@ -1722,7 +1727,7 @@ Ordered events on a connector with per-event markers.
1722
1727
 
1723
1728
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
1724
1729
  <tr><th scope="row">States</th><td>complete, current, upcoming, error</td></tr>
1725
- <tr><th scope="row">Material</th><td>Resin markers on a Haze connector</td></tr>
1730
+ <tr><th scope="row">Material</th><td>Indicator markers on a Haze connector</td></tr>
1726
1731
  <tr><th scope="row">Surface</th><td><a href="#surface-indicator">Indicator</a> → <a href="#surface-haze">Haze reading surface</a></td></tr>
1727
1732
  <tr><th scope="row">Geometry</th><td>Circular markers; 2px connector</td></tr>
1728
1733
  <tr><th scope="row">Semantics</th><td>Ordered list; the current item carries aria-current</td></tr>
@@ -1776,7 +1781,7 @@ Content truncated to a height with a reveal control and an edge fade.
1776
1781
  <tr><th scope="row">Semantics</th><td>The control carries aria-expanded; truncated text remains in the accessibility tree</td></tr>
1777
1782
  <tr><th scope="row">Crystal supplies</th><td>Fade and control treatment</td></tr>
1778
1783
  <tr><th scope="row">Product owns</th><td>Threshold and content</td></tr>
1779
- <tr><th scope="row">Motion</th><td><code>accordion-in</code>, <code>accordion-out</code></td></tr>
1784
+ <tr><th scope="row">Motion</th><td><code>accordion-in</code></td></tr>
1780
1785
  <tr><th scope="row">Parity</th><td>mantine:Spoiler · mui:— · antd:Typography ellipsis</td></tr>
1781
1786
  </tbody></table></div>
1782
1787
 
@@ -1859,7 +1864,7 @@ An icon in a filled container, used as a visual anchor rather than an action.
1859
1864
 
1860
1865
  ### Authored bubble
1861
1866
 
1862
- A reading surface with one intentionally tightened corner indicating authorship or direction.
1867
+ A reading surface with one tightened corner indicating authorship or direction.
1863
1868
 
1864
1869
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
1865
1870
  <tr><th scope="row">States</th><td>incoming, own, grouped, pending, failed</td></tr>
@@ -1951,7 +1956,7 @@ A hierarchy drawn as connected nodes.
1951
1956
  <tr><th scope="row">Semantics</th><td>A tree; collapse state is announced, and the chart is navigable by keyboard.</td></tr>
1952
1957
  <tr><th scope="row">Crystal supplies</th><td>Node material, connector colour, selection by weight</td></tr>
1953
1958
  <tr><th scope="row">Product owns</th><td>Hierarchy data and layout direction</td></tr>
1954
- <tr><th scope="row">Motion</th><td><code>accordion-in</code>, <code>accordion-out</code></td></tr>
1959
+ <tr><th scope="row">Motion</th><td><code>accordion-in</code></td></tr>
1955
1960
  <tr><th scope="row">Parity</th><td>primereact:organizationchart</td></tr>
1956
1961
  </tbody></table></div>
1957
1962
 
@@ -2029,7 +2034,7 @@ A tree whose items are navigation destinations rather than data.
2029
2034
  <tr><th scope="row">Semantics</th><td>A tree with aria-current on the active destination; expansion is announced.</td></tr>
2030
2035
  <tr><th scope="row">Crystal supplies</th><td>Row material, expansion motion, current marking by label weight</td></tr>
2031
2036
  <tr><th scope="row">Product owns</th><td>The destination set and routing</td></tr>
2032
- <tr><th scope="row">Motion</th><td><code>accordion-in</code>, <code>accordion-out</code></td></tr>
2037
+ <tr><th scope="row">Motion</th><td><code>accordion-in</code></td></tr>
2033
2038
  <tr><th scope="row">Parity</th><td>react-aria:NavigationTree</td></tr>
2034
2039
  </tbody></table></div>
2035
2040
 
@@ -2045,7 +2050,7 @@ A table whose columns can be resized by pointer and keyboard.
2045
2050
  <tr><th scope="row">Semantics</th><td>The resizer is a slider: arrow keys resize, and the new width is announced.</td></tr>
2046
2051
  <tr><th scope="row">Crystal supplies</th><td>Resizer affordance, focus ring, live layout while dragging</td></tr>
2047
2052
  <tr><th scope="row">Product owns</th><td>Which columns resize, and persistence</td></tr>
2048
- <tr><th scope="row">Motion</th><td><code>list-in</code>, <code>list-out</code>, <code>highlight</code>, <code>resize-settle</code></td></tr>
2053
+ <tr><th scope="row">Motion</th><td><code>list-in</code>, <code>highlight</code>, <code>resize-settle</code></td></tr>
2049
2054
  <tr><th scope="row">Parity</th><td>react-aria:ResizableTableContainer · mui-x-data-grid:GridColumnResizer</td></tr>
2050
2055
  </tbody></table></div>
2051
2056
 
@@ -2135,12 +2140,12 @@ An inline banner with a semantic symbol, a title, body text and optional actions
2135
2140
 
2136
2141
  ### Toast
2137
2142
 
2138
- A transient floating Resin notification with a message and an optional single action.
2143
+ A transient floating Frost notification with a message and an optional single action.
2139
2144
 
2140
2145
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
2141
2146
  <tr><th scope="row">States</th><td>entering, visible, leaving, persistent, stacked</td></tr>
2142
2147
  <tr><th scope="row">Material</th><td>Frost panel with Haze reading fill and the panel shadow (R15e); status accent from the semantic pair</td></tr>
2143
- <tr><th scope="row">Surface</th><td><a href="#surface-frost">Frost panel</a></td></tr>
2148
+ <tr><th scope="row">Surface</th><td><a href="#surface-frost">Frost panel</a> → <a href="#surface-haze">Haze reading surface</a></td></tr>
2144
2149
  <tr><th scope="row">Geometry</th><td>Content radius; stacked with a 12px offset</td></tr>
2145
2150
  <tr><th scope="row">Semantics</th><td>Polite live region; an urgent toast is assertive. Auto-dismiss must never remove the only route to an action.</td></tr>
2146
2151
  <tr><th scope="row">Crystal supplies</th><td>Surface, stacking, entry and exit motion</td></tr>
@@ -2156,7 +2161,7 @@ A persistent, dismissible message with a title, body, timestamp and actions.
2156
2161
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
2157
2162
  <tr><th scope="row">States</th><td>unread, read, dismissed</td></tr>
2158
2163
  <tr><th scope="row">Material</th><td>Frost panel with Haze reading fill (R15e)</td></tr>
2159
- <tr><th scope="row">Surface</th><td><a href="#surface-frost">Frost panel</a></td></tr>
2164
+ <tr><th scope="row">Surface</th><td><a href="#surface-frost">Frost panel</a> → <a href="#surface-haze">Haze reading surface</a></td></tr>
2160
2165
  <tr><th scope="row">Geometry</th><td>Content radius</td></tr>
2161
2166
  <tr><th scope="row">Semantics</th><td>Announced politely; the dismiss control is named for what it dismisses</td></tr>
2162
2167
  <tr><th scope="row">Crystal supplies</th><td>Surface, unread treatment, action row</td></tr>
@@ -2229,7 +2234,7 @@ Placeholder shapes matching the layout of content that is loading.
2229
2234
  <tr><th scope="row">Parity</th><td>mantine:Skeleton · mui:Skeleton · antd:Skeleton</td></tr>
2230
2235
  </tbody></table></div>
2231
2236
 
2232
- > A skeleton must match the real layout. A skeleton that does not resolve into the shape it promised is a worse experience than a spinner.
2237
+ > A skeleton must match the real layout. One that resolves into a different shape is a worse experience than a spinner.
2233
2238
 
2234
2239
  ### Loading overlay
2235
2240
 
@@ -2318,7 +2323,7 @@ A half-ring showing progress toward a value.
2318
2323
 
2319
2324
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
2320
2325
  <tr><th scope="row">States</th><td>determinate, indeterminate</td></tr>
2321
- <tr><th scope="row">Material</th><td>Haze track with a primary arc</td></tr>
2326
+ <tr><th scope="row">Material</th><td>A track in `--cr-haze-fill` with a primary arc</td></tr>
2322
2327
  <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
2323
2328
  <tr><th scope="row">Geometry</th><td>Stroke matches the ring progress contract.</td></tr>
2324
2329
  <tr><th scope="row">Semantics</th><td>role="progressbar" with a text value beside it.</td></tr>
@@ -2334,7 +2339,7 @@ Several proportions shown on one bar.
2334
2339
 
2335
2340
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
2336
2341
  <tr><th scope="row">States</th><td>at-rest, focus-visible</td></tr>
2337
- <tr><th scope="row">Material</th><td>Haze track with segment fills</td></tr>
2342
+ <tr><th scope="row">Material</th><td>A track in `--cr-haze-fill` with segment fills</td></tr>
2338
2343
  <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
2339
2344
  <tr><th scope="row">Geometry</th><td>Track keeps the content radius; segments meet without gaps.</td></tr>
2340
2345
  <tr><th scope="row">Semantics</th><td>Each segment is labelled; meaning never rests on colour alone.</td></tr>
@@ -2386,7 +2391,7 @@ An edge-anchored panel over a Mirage scrim, with a label and a close control.
2386
2391
 
2387
2392
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
2388
2393
  <tr><th scope="row">States</th><td>closed, open, dragging</td></tr>
2389
- <tr><th scope="row">Material</th><td>Mirage scrim, Frost or Resin panel by depth</td></tr>
2394
+ <tr><th scope="row">Material</th><td>Mirage scrim and a Frost panel</td></tr>
2390
2395
  <tr><th scope="row">Surface</th><td><a href="#surface-frost">Frost panel</a> → <a href="#surface-mirage">Mirage scrim</a></td></tr>
2391
2396
  <tr><th scope="row">Geometry</th><td>Panel radius on the inner edges only</td></tr>
2392
2397
  <tr><th scope="row">Semantics</th><td>Dialog semantics when modal; a complementary region when not. Modality must be real, not implied.</td></tr>
@@ -2398,7 +2403,7 @@ An edge-anchored panel over a Mirage scrim, with a label and a close control.
2398
2403
 
2399
2404
  ### Menu
2400
2405
 
2401
- A Resin popover of actions, with optional groups, separators and checkable items.
2406
+ A Frost popover of actions, with optional groups, separators and checkable items.
2402
2407
 
2403
2408
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
2404
2409
  <tr><th scope="row">States</th><td>closed, open, highlighted, disabled-item, checked-item</td></tr>
@@ -2430,7 +2435,7 @@ Menu anatomy opened at a pointer position or from a keyboard context key.
2430
2435
 
2431
2436
  ### Popover
2432
2437
 
2433
- An anchored Resin surface holding arbitrary content, with optional arrow.
2438
+ An anchored Frost surface holding arbitrary content, with optional arrow.
2434
2439
 
2435
2440
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
2436
2441
  <tr><th scope="row">States</th><td>closed, open, repositioned</td></tr>
@@ -2462,7 +2467,7 @@ A popover that opens on hover or focus after a delay, showing preview content.
2462
2467
 
2463
2468
  ### Tooltip
2464
2469
 
2465
- Short supplemental text on a small Resin surface, anchored to its trigger.
2470
+ Short supplemental text on a small Frost surface, anchored to its trigger.
2466
2471
 
2467
2472
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
2468
2473
  <tr><th scope="row">States</th><td>hidden, visible</td></tr>
@@ -2559,10 +2564,10 @@ A heading at one of six levels, with tightened tracking at display sizes.
2559
2564
 
2560
2565
  ### Text
2561
2566
 
2562
- Body copy with size, weight, colour role and truncation options.
2567
+ Body copy with size, weight, colour role, decoration (underline, strikethrough) and truncation options.
2563
2568
 
2564
2569
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
2565
- <tr><th scope="row">States</th><td>default, muted, truncated, clamped</td></tr>
2570
+ <tr><th scope="row">States</th><td>default, muted, truncated, clamped, underlined, struck-through</td></tr>
2566
2571
  <tr><th scope="row">Material</th><td>None</td></tr>
2567
2572
  <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
2568
2573
  <tr><th scope="row">Geometry</th><td>16px/24px reading rhythm; 78ch maximum measure</td></tr>
@@ -2605,14 +2610,14 @@ Inline highlighted text, typically a search match.
2605
2610
 
2606
2611
  ### Prose
2607
2612
 
2608
- Long-form content with consistent rhythm across headings, lists, tables, code and media.
2613
+ Long-form content with consistent rhythm across headings, lists and checklists, quotations, tables, code and media, and the inline marks: links, emphasis, underline, strikethrough, insertions and deletions, highlights, inline code, keys, subscript and superscript.
2609
2614
 
2610
2615
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
2611
2616
  <tr><th scope="row">States</th><td>default</td></tr>
2612
2617
  <tr><th scope="row">Material</th><td>Inherits; embedded surfaces follow their own components</td></tr>
2613
2618
  <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
2614
2619
  <tr><th scope="row">Geometry</th><td>78ch measure; 1.8 line height; 4px-rhythm vertical spacing</td></tr>
2615
- <tr><th scope="row">Semantics</th><td>Anchor navigation must preserve focus when sections change</td></tr>
2620
+ <tr><th scope="row">Semantics</th><td>Anchor navigation must preserve focus when sections change. Every mark differs in shape as well as colour (an insertion is underlined, a deletion struck through, a highlight filled), and each is its own element (ins, del, mark, u, s), so none rests on colour alone.</td></tr>
2616
2621
  <tr><th scope="row">Crystal supplies</th><td>The complete reading rhythm and embedded-element treatment</td></tr>
2617
2622
  <tr><th scope="row">Product owns</th><td>Content, rendering and virtualisation</td></tr>
2618
2623
  <tr><th scope="row">Parity</th><td>mui:— · mantine:TypographyStylesProvider · antd:Typography</td></tr>
@@ -2673,7 +2678,7 @@ Section headings, levels two to six.
2673
2678
  <tr><th scope="row">Material</th><td>Inherits</td></tr>
2674
2679
  <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
2675
2680
  <tr><th scope="row">Geometry</th><td>Step per level; leading tightens as size grows.</td></tr>
2676
- <tr><th scope="row">Semantics</th><td>The level is the document structure, never chosen for size — size comes from the step.</td></tr>
2681
+ <tr><th scope="row">Semantics</th><td>The level is the document structure, never chosen for size. Size comes from the step.</td></tr>
2677
2682
  <tr><th scope="row">Crystal supplies</th><td>The scale and its tracking</td></tr>
2678
2683
  <tr><th scope="row">Product owns</th><td>Level and wording</td></tr>
2679
2684
  <tr><th scope="row">Parity</th><td>mantine:Title · antd:Typography.Title</td></tr>
@@ -2696,14 +2701,14 @@ The standfirst paragraph beneath a title.
2696
2701
 
2697
2702
  ### Prose list
2698
2703
 
2699
- Ordered and unordered lists inside running text, with Crystal markers.
2704
+ Ordered and unordered lists inside running text, with Crystal markers, and checklists whose markers are checkboxes.
2700
2705
 
2701
2706
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
2702
- <tr><th scope="row">States</th><td>at-rest</td></tr>
2707
+ <tr><th scope="row">States</th><td>at-rest, checked, unchecked</td></tr>
2703
2708
  <tr><th scope="row">Material</th><td>Inherits</td></tr>
2704
2709
  <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
2705
2710
  <tr><th scope="row">Geometry</th><td>Marker inset follows the spacing scale; hanging indent preserved.</td></tr>
2706
- <tr><th scope="row">Semantics</th><td>Real ul and ol so the count and nesting are announced.</td></tr>
2711
+ <tr><th scope="row">Semantics</th><td>Real ul and ol so the count and nesting are announced. A checklist item's marker is a native checkbox, read-only when the list is, so its state is announced; a finished item recedes to the muted ink and is not struck through.</td></tr>
2707
2712
  <tr><th scope="row">Crystal supplies</th><td>Marker treatment, spacing, nesting rhythm</td></tr>
2708
2713
  <tr><th scope="row">Product owns</th><td>Content and ordering</td></tr>
2709
2714
  <tr><th scope="row">Parity</th><td>mantine:List · antd:Typography</td></tr>
@@ -3084,7 +3089,7 @@ Click-and-drag reordering and transfer, by pointer and by keyboard.
3084
3089
 
3085
3090
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
3086
3091
  <tr><th scope="row">States</th><td>at-rest, dragging, drop-target, focus-visible</td></tr>
3087
- <tr><th scope="row">Material</th><td>Resin while lifted; Haze drop indicator</td></tr>
3092
+ <tr><th scope="row">Material</th><td>No material of its own: the opaque surface with the float shadow while lifted, and a drop indicator in `--cr-haze-fill`</td></tr>
3088
3093
  <tr><th scope="row">Surface</th><td><a href="#surface-drag-handle">Drag handle</a></td></tr>
3089
3094
  <tr><th scope="row">Geometry</th><td>Handle is a 44px target; the lifted item keeps its own radius.</td></tr>
3090
3095
  <tr><th scope="row">Semantics</th><td>Keyboard drag is required, not optional: Enter lifts, arrows move, Enter drops, Escape cancels. Every state is announced.</td></tr>
@@ -3186,7 +3191,7 @@ Keeps generated ids stable across server and client.
3186
3191
 
3187
3192
  ## Charts
3188
3193
 
3189
- Data visualisation on one shared surface. Crystal named no charting component before 2.0 while every React benchmark shipped one; these are specified against MUI X Charts, PrimeReact Chart and Mantine Charts. Every chart owes a text equivalent of its data — a chart is a second representation, never the only one.
3194
+ Data visualisation on one shared surface. Crystal named no charting component before 2.0 while every React benchmark shipped one. These are specified against MUI X Charts, PrimeReact Chart and Mantine Charts. Every chart owes a text equivalent of its data, so the chart is never the only representation.
3190
3195
 
3191
3196
  ### Chart surface
3192
3197
 
@@ -3241,7 +3246,7 @@ A line chart with the region beneath it filled.
3241
3246
 
3242
3247
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
3243
3248
  <tr><th scope="row">States</th><td>at-rest, hover, focus-visible, empty</td></tr>
3244
- <tr><th scope="row">Material</th><td>Haze fill beneath the line</td></tr>
3249
+ <tr><th scope="row">Material</th><td>The series colour at `--cr-chart-fill-opacity` beneath the line</td></tr>
3245
3250
  <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
3246
3251
  <tr><th scope="row">Geometry</th><td>Fill never obscures gridlines beneath it.</td></tr>
3247
3252
  <tr><th scope="row">Semantics</th><td>As the line chart.</td></tr>
@@ -3272,7 +3277,7 @@ A pie with a hole, often carrying a summary value.
3272
3277
 
3273
3278
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
3274
3279
  <tr><th scope="row">States</th><td>at-rest, hover, focus-visible, empty</td></tr>
3275
- <tr><th scope="row">Material</th><td>Haze centre fill</td></tr>
3280
+ <tr><th scope="row">Material</th><td>A centre fill in `--cr-haze-fill`</td></tr>
3276
3281
  <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
3277
3282
  <tr><th scope="row">Geometry</th><td>Ring thickness is a declared proportion of the radius.</td></tr>
3278
3283
  <tr><th scope="row">Semantics</th><td>The centre value is text, not an image.</td></tr>
@@ -3302,7 +3307,7 @@ Several measures on radial axes.
3302
3307
 
3303
3308
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
3304
3309
  <tr><th scope="row">States</th><td>at-rest, hover, focus-visible, empty</td></tr>
3305
- <tr><th scope="row">Material</th><td>Haze fill inside each series polygon</td></tr>
3310
+ <tr><th scope="row">Material</th><td>The series colour at `--cr-chart-fill-opacity` inside each series polygon</td></tr>
3306
3311
  <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
3307
3312
  <tr><th scope="row">Geometry</th><td>Axis labels sit outside the outer ring.</td></tr>
3308
3313
  <tr><th scope="row">Semantics</th><td>Axes are labelled; series are named.</td></tr>
@@ -3332,7 +3337,7 @@ A single value against a range, drawn as an arc.
3332
3337
 
3333
3338
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
3334
3339
  <tr><th scope="row">States</th><td>determinate, empty</td></tr>
3335
- <tr><th scope="row">Material</th><td>Haze track with a primary arc</td></tr>
3340
+ <tr><th scope="row">Material</th><td>A track in `--cr-haze-fill` with a primary arc</td></tr>
3336
3341
  <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
3337
3342
  <tr><th scope="row">Geometry</th><td>Matches the ring progress stroke.</td></tr>
3338
3343
  <tr><th scope="row">Semantics</th><td>role="meter" with a text value.</td></tr>
@@ -3484,7 +3489,7 @@ A measure against a target and qualitative ranges.
3484
3489
 
3485
3490
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
3486
3491
  <tr><th scope="row">States</th><td>at-rest, focus-visible, empty</td></tr>
3487
- <tr><th scope="row">Material</th><td>Haze range bands</td></tr>
3492
+ <tr><th scope="row">Material</th><td>Range bands in `--cr-haze-fill`</td></tr>
3488
3493
  <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
3489
3494
  <tr><th scope="row">Geometry</th><td>Single row; the target is a crisp marker, not a bar.</td></tr>
3490
3495
  <tr><th scope="row">Semantics</th><td>role="meter" with the target stated in text.</td></tr>
@@ -3544,7 +3549,7 @@ Nodes and the edges between them.
3544
3549
 
3545
3550
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
3546
3551
  <tr><th scope="row">States</th><td>at-rest, hover, focus-visible, empty</td></tr>
3547
- <tr><th scope="row">Material</th><td>Haze node fills</td></tr>
3552
+ <tr><th scope="row">Material</th><td>Node fills in `--cr-haze-fill`</td></tr>
3548
3553
  <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
3549
3554
  <tr><th scope="row">Geometry</th><td>Node size is a scale; edges are hairlines.</td></tr>
3550
3555
  <tr><th scope="row">Semantics</th><td>Nodes are reachable by keyboard; each states its degree and neighbours.</td></tr>
@@ -3555,49 +3560,49 @@ Nodes and the edges between them.
3555
3560
 
3556
3561
  ## Media
3557
3562
 
3558
- Video, audio and galleries. Crystal named none of these before, and they are the clearest case of the parity requirement being about capability rather than nomenclature: a design system without a transport control leaves every product to invent one, and each invention re-solves captions, scrubbing and keyboard transport differently.
3563
+ Video, audio and galleries. Crystal named none of these before. The parity requirement here is about capability: a design system without a transport control leaves every product to invent one, and each invention re-solves captions, scrubbing and keyboard transport differently.
3559
3564
 
3560
3565
  ### Video player
3561
3566
 
3562
- A video surface with Crystal transport controls.
3567
+ A media stage at a set aspect ratio holding the video, a caption cue above the transport, and the transport inset from the stage: play, skip, the scrubber with its two time readouts, mute and volume, then a settings menu (playback speed, subtitles and captions, audio track, quality), picture in picture and full screen.
3563
3568
 
3564
3569
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
3565
- <tr><th scope="row">States</th><td>idle, playing, paused, buffering, ended, focus-visible</td></tr>
3566
- <tr><th scope="row">Material</th><td>Resin control bar over the video; Haze fills behind readable labels</td></tr>
3567
- <tr><th scope="row">Surface</th><td><a href="#surface-resin">Resin plane</a> → <a href="#surface-haze">Haze reading surface</a></td></tr>
3568
- <tr><th scope="row">Geometry</th><td>Control bar is a pill; every control reaches 44px.</td></tr>
3569
- <tr><th scope="row">Semantics</th><td>Native video element underneath. Controls are real buttons, captions are supported and their state is announced, and keyboard shortcuts do not trap focus.</td></tr>
3570
- <tr><th scope="row">Crystal supplies</th><td>Control-bar material, transport geometry, the motion of showing and hiding controls</td></tr>
3571
- <tr><th scope="row">Product owns</th><td>Sources, captions, DRM, analytics</td></tr>
3572
- <tr><th scope="row">Motion</th><td><code>media-in</code></td></tr>
3570
+ <tr><th scope="row">States</th><td>idle, playing, paused, buffering, ended, focus-visible, captions-on, settings-open, picture-in-picture, full-screen</td></tr>
3571
+ <tr><th scope="row">Material</th><td>Resin transport over the video with Haze fills behind its time readouts; Stone behind caption cues; Frost settings menu</td></tr>
3572
+ <tr><th scope="row">Surface</th><td><a href="#surface-resin">Resin plane</a> → <a href="#surface-haze">Haze reading surface</a> → <a href="#surface-stone">Stone label backing</a> → <a href="#surface-frost">Frost panel</a></td></tr>
3573
+ <tr><th scope="row">Geometry</th><td>The stage keeps the content radius and the aspect ratio the product sets (16:9, 4:3, 1:1, 9:16 or the media's own). The transport is a pill inset 12px from the stage, or the safe area in full screen, with 4px block padding around its controls (58px with its rim); every control reaches the 48px action target. Caption cues sit above the transport, never under it. Below 420px the transport wraps its trailing controls onto a second row.</td></tr>
3574
+ <tr><th scope="row">Semantics</th><td>Native video element underneath. Controls are real buttons, captions are supported and their state is announced, and keyboard shortcuts do not trap focus. Speed, subtitle, audio-track and quality choices are menus of radio items (menuitemradio with aria-checked); the selected item is shown by label weight, never a check mark, and each change is announced in words. A choice the engine cannot make (an audio track list where the browser exposes none, picture in picture where it is unsupported) is not offered.</td></tr>
3575
+ <tr><th scope="row">Crystal supplies</th><td>Stage, transport and caption materials, transport geometry and insets, the settings menu, the motion of showing and hiding controls</td></tr>
3576
+ <tr><th scope="row">Product owns</th><td>Sources, caption and audio tracks, quality renditions and their switching (adaptive streaming), DRM, analytics</td></tr>
3577
+ <tr><th scope="row">Motion</th><td><code>media-in</code>, <code>menu-in</code>, <code>menu-out</code></td></tr>
3573
3578
  <tr><th scope="row">Parity</th><td>primereact:galleria · mui:CardMedia</td></tr>
3574
3579
  </tbody></table></div>
3575
3580
 
3576
3581
  ### Audio player
3577
3582
 
3578
- An audio transport with scrubbing and volume.
3583
+ A Haze card holding the title and any secondary line (artist, episode, chapter), with the transport inset from its edge: play, skip, the scrubber with its two time readouts, mute and volume, and a settings menu for playback speed.
3579
3584
 
3580
3585
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
3581
- <tr><th scope="row">States</th><td>idle, playing, paused, buffering, ended, focus-visible</td></tr>
3582
- <tr><th scope="row">Material</th><td>Resin plane with Haze readable regions</td></tr>
3583
- <tr><th scope="row">Surface</th><td><a href="#surface-resin">Resin plane</a> → <a href="#surface-haze">Haze reading surface</a></td></tr>
3584
- <tr><th scope="row">Geometry</th><td>Pill; the scrubber is a slider with a 44px thumb.</td></tr>
3586
+ <tr><th scope="row">States</th><td>idle, playing, paused, buffering, ended, focus-visible, settings-open</td></tr>
3587
+ <tr><th scope="row">Material</th><td>Haze card holding a Resin transport; Frost settings menu</td></tr>
3588
+ <tr><th scope="row">Surface</th><td><a href="#surface-haze">Haze reading surface</a> → <a href="#surface-resin">Resin plane</a> → <a href="#surface-frost">Frost panel</a></td></tr>
3589
+ <tr><th scope="row">Geometry</th><td>The card keeps the content radius and the card padding (20px); the transport is a pill with 4px block padding around its controls; the scrubber is a slider with a 44px thumb.</td></tr>
3585
3590
  <tr><th scope="row">Semantics</th><td>A real audio element. The scrubber is a slider announcing time, not a progress bar.</td></tr>
3586
3591
  <tr><th scope="row">Crystal supplies</th><td>Material, scrubber geometry, time formatting</td></tr>
3587
3592
  <tr><th scope="row">Product owns</th><td>Sources, playlists, streaming</td></tr>
3588
- <tr><th scope="row">Motion</th><td><code>media-in</code></td></tr>
3593
+ <tr><th scope="row">Motion</th><td><code>media-in</code>, <code>menu-in</code>, <code>menu-out</code></td></tr>
3589
3594
  <tr><th scope="row">Parity</th><td>mantine:Audio</td></tr>
3590
3595
  </tbody></table></div>
3591
3596
 
3592
3597
  ### Media controls
3593
3598
 
3594
- The shared transport used by both players.
3599
+ The shared transport used by both players: play, skip, the scrubber between two time readouts, mute and volume, then the controls a player adds (settings, picture in picture, full screen).
3595
3600
 
3596
3601
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
3597
3602
  <tr><th scope="row">States</th><td>idle, playing, paused, buffering, focus-visible</td></tr>
3598
- <tr><th scope="row">Material</th><td>Resin plane</td></tr>
3599
- <tr><th scope="row">Surface</th><td><a href="#surface-resin">Resin plane</a></td></tr>
3600
- <tr><th scope="row">Geometry</th><td>Pill; 44px targets throughout.</td></tr>
3603
+ <tr><th scope="row">Material</th><td>Resin plane; Haze behind the time readouts</td></tr>
3604
+ <tr><th scope="row">Surface</th><td><a href="#surface-resin">Resin plane</a> → <a href="#surface-haze">Haze reading surface</a></td></tr>
3605
+ <tr><th scope="row">Geometry</th><td>Pill with 4px block and 12px inline padding around its 48px controls (58px tall with its rim), 4px between them. Time readouts are tabular and sit on Haze pills.</td></tr>
3601
3606
  <tr><th scope="row">Semantics</th><td>Each control is a button with a name; play and pause are one toggle with a pressed state.</td></tr>
3602
3607
  <tr><th scope="row">Crystal supplies</th><td>Materials, the press recipe on every control</td></tr>
3603
3608
  <tr><th scope="row">Product owns</th><td>Which controls appear</td></tr>
@@ -3638,7 +3643,7 @@ A single media item enlarged over a scrim.
3638
3643
 
3639
3644
  ## Commerce
3640
3645
 
3641
- Functional e-commerce components. Crystal named none before, which left every store to reinvent a quantity stepper, a variant selector and a cart summary — and to re-solve availability, currency formatting and checkout validation each time. Payment is deliberately bounded: these components never handle raw card data, and defer to the host provider's own element.
3646
+ Functional e-commerce components. Crystal named none before, which left every store to reinvent a quantity stepper, a variant selector and a cart summary, and to re-solve availability, currency formatting and checkout validation each time. Payment is deliberately bounded: these components never handle raw card data, and defer to the host provider's own element.
3642
3647
 
3643
3648
  ### Price
3644
3649
 
@@ -3695,7 +3700,7 @@ A bounded integer with decrement and increment.
3695
3700
  <tr><th scope="row">Material</th><td>Resin shell with a Haze well</td></tr>
3696
3701
  <tr><th scope="row">Surface</th><td><a href="#surface-field">Field shell</a></td></tr>
3697
3702
  <tr><th scope="row">Geometry</th><td>Pill; both controls reach 44px.</td></tr>
3698
- <tr><th scope="row">Semantics</th><td>A typable numeric field: the value is read as its text, and the bounds are announced when reached. Not role=spinbutton — a spin button cannot be focused with VoiceOver, so the role would put the control out of some readers' reach.</td></tr>
3703
+ <tr><th scope="row">Semantics</th><td>A typable numeric field: the value is read as its text, and the bounds are announced when reached. Not role=spinbutton, because a spin button cannot be focused with VoiceOver, so the role would put the control out of some readers' reach.</td></tr>
3699
3704
  <tr><th scope="row">Crystal supplies</th><td>Materials, press recipe on each control</td></tr>
3700
3705
  <tr><th scope="row">Product owns</th><td>Bounds, step, stock rules</td></tr>
3701
3706
  <tr><th scope="row">Motion</th><td><code>slider-step</code></td></tr>
@@ -3837,9 +3842,9 @@ Choice among stored or new payment methods.
3837
3842
  <tr><th scope="row">Material</th><td>Haze option fills</td></tr>
3838
3843
  <tr><th scope="row">Surface</th><td><a href="#surface-haze">Haze reading surface</a></td></tr>
3839
3844
  <tr><th scope="row">Geometry</th><td>Options keep the content radius; the selected one carries label weight.</td></tr>
3840
- <tr><th scope="row">Semantics</th><td>A radio group. Card fields are never reimplemented — the host supplies its provider element.</td></tr>
3845
+ <tr><th scope="row">Semantics</th><td>A radio group. Card fields are never reimplemented: the host supplies its provider element.</td></tr>
3841
3846
  <tr><th scope="row">Crystal supplies</th><td>Option material, selection, focus ring</td></tr>
3842
- <tr><th scope="row">Product owns</th><td>The provider, tokenisation, and PCI scope — this component never handles raw card data</td></tr>
3847
+ <tr><th scope="row">Product owns</th><td>The provider, tokenisation, and PCI scope; this component never handles raw card data</td></tr>
3843
3848
  <tr><th scope="row">Motion</th><td><code>selection</code></td></tr>
3844
3849
  <tr><th scope="row">Parity</th><td>antd:Radio.Group</td></tr>
3845
3850
  </tbody></table></div>
@@ -4017,7 +4022,7 @@ A horizontal strip of previously seen products.
4017
4022
 
4018
4023
  ## Screens
4019
4024
 
4020
- Whole views and the chrome around them, for interactive applications rather than documents. A screen owns landmarks, focus movement between views, and the states a view can be in before it has content — loading, empty, error, offline, not found, unauthorised — which products otherwise improvise separately and inconsistently.
4025
+ Whole views and the chrome around them, for interactive applications rather than documents. A screen owns landmarks, focus movement between views, and the states a view can be in before it has content (loading, empty, error, offline, not found, unauthorised), which products otherwise improvise separately and inconsistently.
4021
4026
 
4022
4027
  ### Screen
4023
4028
 
@@ -4077,7 +4082,7 @@ A list beside the detail of its selection.
4077
4082
  <tr><th scope="row">Semantics</th><td>Selection moves focus to the detail only when the layout has collapsed.</td></tr>
4078
4083
  <tr><th scope="row">Crystal supplies</th><td>Pane materials, the collapse transition</td></tr>
4079
4084
  <tr><th scope="row">Product owns</th><td>The data and routing</td></tr>
4080
- <tr><th scope="row">Motion</th><td><code>page-in</code>, <code>page-out</code></td></tr>
4085
+ <tr><th scope="row">Motion</th><td><code>page-in</code></td></tr>
4081
4086
  <tr><th scope="row">Parity</th><td>antd:Layout</td></tr>
4082
4087
  </tbody></table></div>
4083
4088
 
@@ -4256,7 +4261,7 @@ Access is denied or must be granted.
4256
4261
 
4257
4262
  ## Blocks
4258
4263
 
4259
- Composed arrangements that solve a recognisable product problem: a dashboard shell, a checkout, a player, a storefront. Kept as their own tier rather than mixed into the components, because a component is a primitive with one job and a contract, while a block is opinionated by design — and a design system that cannot tell the two apart ships opinions as if they were primitives. Benchmarked against Tailwind UI, Mantine UI, Ant Design Pro, MUI Templates and PrimeBlocks.
4264
+ Composed arrangements that solve a recognisable product problem: a dashboard shell, a checkout, a player, a storefront. Kept as their own tier rather than mixed into the components, because a component is a primitive with one job and a contract, while a block is opinionated by design. Mixing the two would ship opinions as if they were primitives. Benchmarked against Tailwind UI, Mantine UI, Ant Design Pro, MUI Templates and PrimeBlocks.
4260
4265
 
4261
4266
  ### Dashboard shell
4262
4267
 
@@ -4419,7 +4424,7 @@ A media surface with transport, queue and metadata.
4419
4424
  <tr><th scope="row">Material</th><td>Resin transport over the media; Haze metadata</td></tr>
4420
4425
  <tr><th scope="row">Surface</th><td><a href="#surface-resin">Resin plane</a> → <a href="#surface-haze">Haze reading surface</a></td></tr>
4421
4426
  <tr><th scope="row">Geometry</th><td>Transport is a pill; controls reach 44px.</td></tr>
4422
- <tr><th scope="row">Semantics</th><td>Real media elements; captions and their state announced; transport reachable by keyboard.</td></tr>
4427
+ <tr><th scope="row">Semantics</th><td>Real media elements; captions and their state announced; transport reachable by keyboard; speed, track and quality choices announced as they change.</td></tr>
4423
4428
  <tr><th scope="row">Crystal supplies</th><td>Transport material, the show and hide motion</td></tr>
4424
4429
  <tr><th scope="row">Product owns</th><td>Sources, queue, DRM</td></tr>
4425
4430
  <tr><th scope="row">Parity</th><td>primereact:galleria</td></tr>
@@ -4551,7 +4556,7 @@ Search with suggestions, recent queries and results.
4551
4556
 
4552
4557
  ### Editor block
4553
4558
 
4554
- A rich text surface with toolbar, and save state.
4559
+ A rich text surface with its toolbar and selection toolbar, a save state in words, and the save action.
4555
4560
 
4556
4561
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
4557
4562
  <tr><th scope="row">States</th><td>at-rest, focus-visible, dirty, saving, saved</td></tr>