@crystal-ui/core 2.4.0 → 2.6.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.
package/docs/catalogue.md CHANGED
@@ -34,16 +34,16 @@ Every component is made of one or more of these surfaces. Its Surface row names
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
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. |
37
+ | <a id="surface-haze"></a>**Haze reading surface** `haze` | Haze | <code>.cr-haze</code> | 88 | 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> | 12 | 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
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
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
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. |
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. `.large`, `.larger` and `.solid` are the reader's caption style: a cue 1.25 or 1.5 times the size, and a cue on the opaque surface. `::cue` on a `.cr-media` video is the flat fill for the browser's own renderer, which follows the reader's system caption settings. |
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
- | <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. |
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, as `.cr-indicator.pill`, the primary fill that travels behind the selected segment of a strip (D-37): tabs, a segmented control, the dock, bottom navigation or a toggle button group. The circle is Haze rather than Resin, because it sits on a surface that is often already translucent. Neither is ever the only mark of a selection: the selected segment keeps its label weight, and the circle never marks one at all. |
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. |
@@ -54,7 +54,7 @@ Every component is made of one or more of these surfaces. Its Surface row names
54
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
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. |
57
+ | <a id="surface-none"></a>**No surface of its own** `none` | None | None | 104 | 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
 
@@ -327,13 +327,13 @@ One floating Resin plane holding labelled destinations on a shared Stone label g
327
327
 
328
328
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
329
329
  <tr><th scope="row">States</th><td>default, selected, hover, focus</td></tr>
330
- <tr><th scope="row">Material</th><td>Resin plane, Stone label backing, primary fill on the selected destination</td></tr>
330
+ <tr><th scope="row">Material</th><td>Resin plane, Stone label backing, the primary pill behind the selected destination</td></tr>
331
331
  <tr><th scope="row">Surface</th><td><a href="#surface-dock">Dock</a></td></tr>
332
332
  <tr><th scope="row">Geometry</th><td>Pill; 52px minimum destination height</td></tr>
333
333
  <tr><th scope="row">Semantics</th><td>nav landmark; aria-pressed or aria-current on the destination</td></tr>
334
334
  <tr><th scope="row">Crystal supplies</th><td>The single shared plane, label weight for the current entry, elevation</td></tr>
335
335
  <tr><th scope="row">Product owns</th><td>Destinations and routing</td></tr>
336
- <tr><th scope="row">Motion</th><td><code>selection</code></td></tr>
336
+ <tr><th scope="row">Motion</th><td><code>selection-travel</code></td></tr>
337
337
  <tr><th scope="row">Parity</th><td>mui:BottomNavigation · antd:Menu · mantine:SegmentedControl</td></tr>
338
338
  </tbody></table></div>
339
339
 
@@ -361,13 +361,13 @@ A Resin tab strip with a selected tab and an associated panel.
361
361
 
362
362
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
363
363
  <tr><th scope="row">States</th><td>default, hover, focus, selected, disabled</td></tr>
364
- <tr><th scope="row">Material</th><td>Resin strip, primary fill on the selected tab</td></tr>
364
+ <tr><th scope="row">Material</th><td>Resin strip, the primary pill behind the selected tab</td></tr>
365
365
  <tr><th scope="row">Surface</th><td><a href="#surface-dock">Dock</a></td></tr>
366
366
  <tr><th scope="row">Geometry</th><td>Pill tabs inside a pill strip; 44px minimum</td></tr>
367
367
  <tr><th scope="row">Semantics</th><td>role=tablist/tab/tabpanel with arrow-key, Home and End navigation and aria-selected</td></tr>
368
368
  <tr><th scope="row">Crystal supplies</th><td>Strip material, label weight for the selected tab, focus ring</td></tr>
369
369
  <tr><th scope="row">Product owns</th><td>The roving tabindex implementation and panel content</td></tr>
370
- <tr><th scope="row">Motion</th><td><code>tab-in</code></td></tr>
370
+ <tr><th scope="row">Motion</th><td><code>tab-in</code>, <code>selection-travel</code></td></tr>
371
371
  <tr><th scope="row">Parity</th><td>mantine:Tabs · mui:Tabs · antd:Tabs</td></tr>
372
372
  </tbody></table></div>
373
373
 
@@ -478,9 +478,9 @@ A Resin destination group pinned to the bottom of a narrow view.
478
478
  <tr><th scope="row">Surface</th><td><a href="#surface-dock">Dock</a></td></tr>
479
479
  <tr><th scope="row">Geometry</th><td>Pill; targets at least 44px; respects the safe area.</td></tr>
480
480
  <tr><th scope="row">Semantics</th><td>role="navigation"; the current destination carries aria-current="page".</td></tr>
481
- <tr><th scope="row">Crystal supplies</th><td>Material, geometry, selection by label weight, safe-area inset</td></tr>
481
+ <tr><th scope="row">Crystal supplies</th><td>Material, geometry, selection by label weight with the pill behind it, safe-area inset</td></tr>
482
482
  <tr><th scope="row">Product owns</th><td>Destinations and routing</td></tr>
483
- <tr><th scope="row">Motion</th><td><code>selection</code></td></tr>
483
+ <tr><th scope="row">Motion</th><td><code>selection-travel</code></td></tr>
484
484
  <tr><th scope="row">Parity</th><td>mui:BottomNavigation</td></tr>
485
485
  </tbody></table></div>
486
486
 
@@ -596,9 +596,9 @@ Adjacent actions sharing one Resin plane with internal hairlines.
596
596
  <tr><th scope="row">Surface</th><td><a href="#surface-group">Group</a></td></tr>
597
597
  <tr><th scope="row">Geometry</th><td>Pill outer geometry; interior corners square against neighbours</td></tr>
598
598
  <tr><th scope="row">Semantics</th><td>group role with an accessible name when the buttons are related</td></tr>
599
- <tr><th scope="row">Crystal supplies</th><td>The shared plane and interior separation</td></tr>
599
+ <tr><th scope="row">Crystal supplies</th><td>The shared plane and interior separation; as a toggle set, the pill behind the pressed button</td></tr>
600
600
  <tr><th scope="row">Product owns</th><td>Which actions are grouped</td></tr>
601
- <tr><th scope="row">Motion</th><td><code>press</code></td></tr>
601
+ <tr><th scope="row">Motion</th><td><code>press</code>, <code>selection-travel</code></td></tr>
602
602
  <tr><th scope="row">Parity</th><td>mantine:Button.Group · mui:ButtonGroup · antd:Space.Compact</td></tr>
603
603
  </tbody></table></div>
604
604
 
@@ -952,13 +952,13 @@ A pill strip of mutually exclusive options sharing one Resin plane.
952
952
 
953
953
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
954
954
  <tr><th scope="row">States</th><td>default, hover, focus, selected, disabled</td></tr>
955
- <tr><th scope="row">Material</th><td>One Resin plane; primary fill on the selected segment</td></tr>
955
+ <tr><th scope="row">Material</th><td>One Resin plane; the primary pill behind the selected segment</td></tr>
956
956
  <tr><th scope="row">Surface</th><td><a href="#surface-dock">Dock</a></td></tr>
957
957
  <tr><th scope="row">Geometry</th><td>Pill strip and pill segments; 44px minimum</td></tr>
958
958
  <tr><th scope="row">Semantics</th><td>Radio group semantics, or aria-pressed on buttons; never aria-selected outside a tablist</td></tr>
959
959
  <tr><th scope="row">Crystal supplies</th><td>Shared plane, label weight for the selected segment, focus ring</td></tr>
960
960
  <tr><th scope="row">Product owns</th><td>Options and change handling</td></tr>
961
- <tr><th scope="row">Motion</th><td><code>selection</code></td></tr>
961
+ <tr><th scope="row">Motion</th><td><code>selection-travel</code></td></tr>
962
962
  <tr><th scope="row">Parity</th><td>mantine:SegmentedControl · mui:ToggleButtonGroup · antd:Segmented</td></tr>
963
963
  </tbody></table></div>
964
964
 
@@ -1421,7 +1421,7 @@ A two-dimensional field for saturation and brightness.
1421
1421
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
1422
1422
  <tr><th scope="row">States</th><td>at-rest, dragging, focus-visible, disabled</td></tr>
1423
1423
  <tr><th scope="row">Material</th><td>Resin thumb over the gradient field</td></tr>
1424
- <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
1424
+ <tr><th scope="row">Surface</th><td><a href="#surface-resin">Resin plane</a></td></tr>
1425
1425
  <tr><th scope="row">Geometry</th><td>Thumb reaches 44px including its hit area.</td></tr>
1426
1426
  <tr><th scope="row">Semantics</th><td>Two linked sliders; each axis announces its own value and responds to arrow keys.</td></tr>
1427
1427
  <tr><th scope="row">Crystal supplies</th><td>Thumb material, focus ring, contrast of the thumb against any underlying colour</td></tr>
@@ -1436,7 +1436,7 @@ One channel of a colour, as a track.
1436
1436
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
1437
1437
  <tr><th scope="row">States</th><td>at-rest, dragging, focus-visible, disabled</td></tr>
1438
1438
  <tr><th scope="row">Material</th><td>Resin thumb on a gradient track</td></tr>
1439
- <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
1439
+ <tr><th scope="row">Surface</th><td><a href="#surface-resin">Resin plane</a></td></tr>
1440
1440
  <tr><th scope="row">Geometry</th><td>Matches the slider contract.</td></tr>
1441
1441
  <tr><th scope="row">Semantics</th><td>role="slider" with the channel named and the value in that channel's units.</td></tr>
1442
1442
  <tr><th scope="row">Crystal supplies</th><td>Thumb and track material, focus ring</td></tr>
@@ -1451,7 +1451,7 @@ Hue as a ring.
1451
1451
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
1452
1452
  <tr><th scope="row">States</th><td>at-rest, dragging, focus-visible, disabled</td></tr>
1453
1453
  <tr><th scope="row">Material</th><td>Resin thumb on the hue ring</td></tr>
1454
- <tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
1454
+ <tr><th scope="row">Surface</th><td><a href="#surface-resin">Resin plane</a></td></tr>
1455
1455
  <tr><th scope="row">Geometry</th><td>Ring thickness is a declared proportion of the radius.</td></tr>
1456
1456
  <tr><th scope="row">Semantics</th><td>role="slider" in degrees, wrapping at 360.</td></tr>
1457
1457
  <tr><th scope="row">Crystal supplies</th><td>Thumb material, ring geometry, focus ring</td></tr>
@@ -2290,7 +2290,7 @@ A small popover asking for confirmation next to the control that triggered it.
2290
2290
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
2291
2291
  <tr><th scope="row">States</th><td>closed, open, pending</td></tr>
2292
2292
  <tr><th scope="row">Material</th><td>Frost panel with Haze reading fill (R15e)</td></tr>
2293
- <tr><th scope="row">Surface</th><td><a href="#surface-frost">Frost panel</a></td></tr>
2293
+ <tr><th scope="row">Surface</th><td><a href="#surface-frost">Frost panel</a> → <a href="#surface-haze">Haze reading surface</a></td></tr>
2294
2294
  <tr><th scope="row">Geometry</th><td>Content radius; anchored to the trigger</td></tr>
2295
2295
  <tr><th scope="row">Semantics</th><td>Focus moves into the popover, returns to the trigger on dismiss, and Escape cancels</td></tr>
2296
2296
  <tr><th scope="row">Crystal supplies</th><td>Popover surface and action row</td></tr>
@@ -2408,7 +2408,7 @@ A Frost popover of actions, with optional groups, separators and checkable items
2408
2408
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
2409
2409
  <tr><th scope="row">States</th><td>closed, open, highlighted, disabled-item, checked-item</td></tr>
2410
2410
  <tr><th scope="row">Material</th><td>Frost panel with Haze rows (R15e)</td></tr>
2411
- <tr><th scope="row">Surface</th><td><a href="#surface-frost">Frost panel</a></td></tr>
2411
+ <tr><th scope="row">Surface</th><td><a href="#surface-frost">Frost panel</a> → <a href="#surface-haze">Haze reading surface</a></td></tr>
2412
2412
  <tr><th scope="row">Geometry</th><td>Content radius; every row reserves leading room for a check mark, so ticking one does not shift its label</td></tr>
2413
2413
  <tr><th scope="row">Semantics</th><td>role=menu with full keyboard navigation, type-ahead and Escape; checkable items use aria-checked</td></tr>
2414
2414
  <tr><th scope="row">Crystal supplies</th><td>Surface, row treatment, row geometry, separators</td></tr>
@@ -2440,7 +2440,7 @@ An anchored Frost surface holding arbitrary content, with optional arrow.
2440
2440
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
2441
2441
  <tr><th scope="row">States</th><td>closed, open, repositioned</td></tr>
2442
2442
  <tr><th scope="row">Material</th><td>Frost panel with Haze reading fill (R15e)</td></tr>
2443
- <tr><th scope="row">Surface</th><td><a href="#surface-frost">Frost panel</a></td></tr>
2443
+ <tr><th scope="row">Surface</th><td><a href="#surface-frost">Frost panel</a> → <a href="#surface-haze">Haze reading surface</a></td></tr>
2444
2444
  <tr><th scope="row">Geometry</th><td>Content radius; flips and shifts to stay in view</td></tr>
2445
2445
  <tr><th scope="row">Semantics</th><td>The trigger carries aria-expanded and aria-controls; focus moves in for interactive content</td></tr>
2446
2446
  <tr><th scope="row">Crystal supplies</th><td>Surface, arrow, positioning behaviour</td></tr>
@@ -3564,14 +3564,14 @@ Video, audio and galleries. Crystal named none of these before. The parity requi
3564
3564
 
3565
3565
  ### Video player
3566
3566
 
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.
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, caption style, audio track, quality), picture in picture and full screen.
3568
3568
 
3569
3569
  <div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
3570
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
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
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
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>
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. The caption style (a larger size, 1.25 or 1.5 times, and a solid backing on the opaque surface) is the reader's: it is kept for every player the reader opens and drawn with `.cr-media-caption`'s `.large`, `.larger` and `.solid`. Speed, subtitle, caption-style, 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
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
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
3577
  <tr><th scope="row">Motion</th><td><code>media-in</code>, <code>menu-in</code>, <code>menu-out</code></td></tr>
@@ -108,7 +108,7 @@ The media and text recipes of 2.4.0 add no surface. Each is a selector on a surf
108
108
  | [Caption cue](#specimen-media-stage) `.cr-media-caption`, `::cue` | Stone label backing | A cue is a label over a moving picture, so it sits on Stone, above the transport and never under it: 12px above the bar whether or not the bar is shown, so it does not jump when a pointer arrives. `.cr-media-caption` is the feathered backing for a library that renders cues itself; `::cue` gives the browser's own renderer the flat Stone fill, because it accepts no pseudo-element. |
109
109
  | [Audio card](#specimen-media-audio) `.cr-haze.cr-media.audio` | Haze reading surface | The audio player has no picture, so the stage becomes a Haze card with the 20px card padding, holding the title, a secondary line and the transport. |
110
110
  | [Selection toolbar](#specimen-text-marks) `.cr-frost.bar` | Frost panel | A transient overlay shaped as a row of controls: a pill with 4px padding, for the commonest marks over highlighted text. It is Frost because every transient overlay is (R15e). |
111
- | [Prose and the editor](#specimen-text-editor) `.cr-prose`, `.cr-editor`, `.cr-editor-toolbar` | Field shell, when editing | One reading vocabulary for a document while it is written and after it is published: 24px between blocks, headings stepping down the type scale, muted list markers, a primary-soft rule on a quotation, checklists of native checkboxes, and marks that each differ in shape as well as colour. A field shell holding an editor becomes a column at the content radius. Its toolbar sits above the text on a fine pointer, and below it on a coarse one, clear of the on-screen keyboard; `.below` asks for that placement on any pointer. |
111
+ | [Prose and the editor](#specimen-text-editor) `.cr-prose`, `.cr-editor`, `.cr-editor-toolbar` | Field shell, when editing | One reading vocabulary for a document while it is written and after it is published: 24px between blocks, headings stepping down the type scale, muted list markers, a primary-soft rule on a quotation, checklists of native checkboxes, and marks that each differ in shape as well as colour. A field shell holding an editor becomes a column at the content radius. Its toolbar sits above the text on a fine pointer, and below it on a coarse one, clear of the on-screen keyboard, on the Haze fill so the document scrolling under it does not show through. `.below` and `.above` fix the placement on any pointer; the pointer still decides whether the controls wrap or scroll in one row. An empty editor holds four lines. |
112
112
 
113
113
  A native switch is a checkbox with a track, `<input type="checkbox" role="switch">`, styled by element like the checkbox and radio. The track reads `--cr-switch-track-width` and `-height`, the thumb is the opaque surface, and the on state is the primary-soft pair.
114
114
 
package/docs/materials.md CHANGED
@@ -151,7 +151,7 @@ Keep backdrop filters confined to a few bounded surfaces, avoid continuous blur
151
151
 
152
152
  This section defines two scales as tokens. They name what Crystal's own shell already does, so something other than the preview can reach the values. Neither is a new design decision.
153
153
 
154
- **The spacing scale** is the 4px rhythm, tied at two points to the reading rhythm: `md` is the 16px reading size and `lg` is the 24px leading, so a `lg` gap is exactly one blank line between blocks.
154
+ **The spacing scale** is the 4px rhythm, tied at two points to the reading rhythm: `md` is the 16px reading size and `lg`, 24px, is the step nearest the 25.6px leading, so a `lg` gap reads as one blank line between blocks.
155
155
 
156
156
  | Step | `2xs` | `xs` | `sm` | `md` | `lg` | `xl` | `2xl` |
157
157
  |---|---|---|---|---|---|---|---|
@@ -165,7 +165,7 @@ This section defines two scales as tokens. They name what Crystal's own shell al
165
165
 
166
166
  ## The type scale
167
167
 
168
- Crystal specifies a reading rhythm, Manrope at 16/24, and the scale is derived from it. Each step is a ratio of the reading size, so changing `typography.readingSize` changes all six steps and no step is a literal.
168
+ Crystal specifies a reading rhythm, Manrope at 16/25.6 (a leading of 1.6, D-41), and the scale is derived from it. Each step is a ratio of the reading size, so changing `typography.readingSize` changes all six steps and no step is a literal.
169
169
 
170
170
  | Step | Ratio | Size | Leading | Tracking |
171
171
  |---|---|---|---|---|
@@ -173,7 +173,7 @@ Crystal specifies a reading rhythm, Manrope at 16/24, and the scale is derived f
173
173
  | `title` | 1.5 | 24px | 1.2 | −0.04em |
174
174
  | `heading` | 1.25 | 20px | 1.3 | −0.03em |
175
175
  | `subheading` | 1.0625 | 17px | 1.45 | −0.01em |
176
- | `body` | 1 | 16px | 1.5 | 0 |
176
+ | `body` | 1 | 16px | 1.6 | 0 |
177
177
  | `caption` | 0.8125 | 13px | 1.45 | 0 |
178
178
 
179
179
  The scale is modest, because Crystal's hierarchy is carried by weight and material as much as by size, and a dramatic scale competes with both.
@@ -2,7 +2,7 @@
2
2
 
3
3
  [Open the live component studies](../motion.html#component-motion) · [Search all recipes](../motion.html#recipe-library) · [Run browser contracts](../motion-contracts.html)
4
4
 
5
- Crystal ships 59 executable component recipes in nine families, the six material signatures, Mirage withdrawal, a modal dismissal, and a measured-layout helper. Three of the recipes are continuous indicators of pending work. This is the animation foundation for future component libraries. The demonstration includes real local component behavior, but is not an audited production React, Rust or native component library. No remote operation is represented as implemented.
5
+ Crystal ships 60 executable component recipes in nine families, the six material signatures, Mirage withdrawal, a modal dismissal, a measured-layout helper, and the travelling selection pill, which plays `selection-travel` between measured segments. Three of the recipes are continuous indicators of pending work. This is the animation foundation for future component libraries. The demonstration includes real local component behavior, but is not an audited production React, Rust or native component library. No remote operation is represented as implemented.
6
6
 
7
7
  ## Engine responsibilities
8
8
 
@@ -38,7 +38,8 @@ The same formula applies to display labels, tags, badges and keyboard caps. Use
38
38
  | Slider, stepper, numeric output | `slider-step` | Native keyboard range interaction and current value |
39
39
  | Input, textarea, validation group | `field-focus`, `field-invalid`, `field-valid`, `hint-in/out` | Real validation, associated error text, `aria-invalid` |
40
40
  | Copy action, confirmation mark | `copy-confirm`, `success` | Play only after the actual action succeeds |
41
- | Tab, navigation rail, bottom navigation | `selection`, `tab-in` | Selected semantics, roving tab stop, panel visibility |
41
+ | Tab, navigation rail, bottom navigation | `selection`, `tab-in`; on a strip, `selection-travel` through `travel()` | Selected semantics, roving tab stop, panel visibility |
42
+ | Segmented control, dock, toggle button group | `selection-travel` through `travel()` | Selected semantics first; selection stays label weight, so the pill is never the only sign of it |
42
43
  | Page/view, wizard step, breadcrumb, pagination | `page-in/out`, `breadcrumb` | Router/history and focus managed by the host |
43
44
  | Dialog / alert dialog | Haze + Mirage + `dismiss` | Native modality, initial focus, Escape, focus return |
44
45
  | Drawer / inspector / sheet | `drawer-in/out` + Mirage | Native modality or an explicitly nonmodal panel contract |
@@ -73,6 +74,7 @@ Base times below are at 1×; the preview resolves the saved speed at playback. E
73
74
  | `press` | resin / pressure | Motion | 320ms | Buttons, icon buttons and segmented controls. Disabled controls never animate. |
74
75
  | `hover` | resin / caustic | Motion | 700ms | Fine-pointer affordance only; keyboard focus is immediate. |
75
76
  | `selection` | resin / meniscus | Motion | 420ms | Selected chips, radios, toggles and navigation; set selected semantics first. |
77
+ | `selection-travel` | resin / meniscus | Motion | 460ms | The one .cr-indicator.pill behind the selected segment of tabs, a segmented control, the dock, bottom navigation or a toggle button group, moving to the new segment when the choice changes. Set the selected semantics first; selection stays label weight, so the pill is never the only sign of it. Critically damped: a pill that overshoots stands for a moment on a segment nobody chose. |
76
78
  | `switch-on` | resin / coalesce | Motion | 460ms | Animate the thumb after its checked state is applied. |
77
79
  | `switch-off` | resin / coalesce | Motion | 460ms | Animate the thumb after its unchecked state is applied. |
78
80
  | `check` | resin / iris | Motion | 340ms | Checkbox and radio indicators; retain a visible non-color state. |
@@ -155,6 +157,18 @@ CrystalMotion.stopAll();
155
157
 
156
158
  `layout(element, previousRect)` compares the previous and current DOM position. Displacements up to the viewport diagonal use a GSAP-controlled inverse transform, with duration adapting to distance. Pass `{extended:false}` to retain the compact 50px/crossfade behavior. Offscreen-scale moves beyond the viewport diagonal crossfade. The final order is always the real DOM order. Layout animation is cosmetic and does not supply drag-and-drop behavior.
157
159
 
160
+ `travel(pill, segment, {instant})` moves a strip's selection pill (D-37). The pill is one `.cr-indicator.pill`, `aria-hidden`, a child of the plane that holds the segments: `.cr-dock`, `.cr-dock-inner` or `.cr-group`. Set the segment's selected semantics first, then call `travel` with the segment that carries them. It measures the segment inside the plane, writes `--cr-pill-x`, `--cr-pill-y`, `--cr-pill-width`, `--cr-pill-height` and `--cr-pill-radius` on the pill, marks it `data-placed`, and plays `selection-travel` from where the pill is seen to where the segment stands. Placing the pill is what hands the fill to it: until then each segment paints its own, so a strip with no script looks as it always has. The first call, `{instant:true}` (call it from a resize observer, or when fonts load) and reduced motion place the pill without travelling. A travel that starts while another is under way starts from where the pill is seen, so a quick second choice turns the pill rather than snapping it. While it travels the pill carries `data-travelling`, and the arriving label keeps the strip's ink until the pill is under it; its weight changes at once, with the semantics. Forced colours draw no pill and keep the segment's own outline.
161
+
162
+ ```js
163
+ const pill = strip.querySelector(':scope > .cr-indicator.pill');
164
+ await CrystalMotion.travel(pill, strip.querySelector('[aria-selected=true]'), { instant: true });
165
+
166
+ // When the choice changes:
167
+ previous.setAttribute('aria-selected', 'false');
168
+ next.setAttribute('aria-selected', 'true');
169
+ await CrystalMotion.travel(pill, next);
170
+ ```
171
+
158
172
  The engine bridge restores prior inline values and priorities for its owned properties. Consumers should avoid modifying the same animated property during an effect; stop it before changing that property. Component implementations should use a dedicated animated wrapper when they already own a nontrivial transform. Libraries must not let two engines compete for the same property.
159
173
 
160
174
  ## Live examples and interruption
package/docs/motion.md CHANGED
@@ -85,7 +85,7 @@ The canonical motion definitions live in `tokens/crystal.json`; CSS and JSON exp
85
85
 
86
86
  Both engines are installed, bundled locally and used by the runtime. [Motion's animate API](https://motion.dev/docs/animate) drives element keyframes. [GSAP timelines](https://gsap.com/docs/v3/GSAP/Timeline/) control material paint-layer clocks and selected component sequences. Native Web Animations effects paint actual pseudo-elements under those GSAP clocks; CSS supplies the native dialog backdrop fallback.
87
87
 
88
- See the [component motion suite](motion-components.html) for all 59 recipes, engine assignments, API contracts, live component behavior, test instructions and future component-library/Storybook coverage. [License notices](../reference/ASSET-NOTICES.md) accompany the local bundle.
88
+ See the [component motion suite](motion-components.html) for all 60 recipes, engine assignments, API contracts, live component behavior, test instructions and future component-library/Storybook coverage. [License notices](../reference/ASSET-NOTICES.md) accompany the local bundle.
89
89
 
90
90
  The compact CSS timing tokens remain available for small state changes. The material-driven Resin press recipe uses 320ms for a complete compression/recovery sequence; hover light uses 700ms. These visual clocks never delay the actual action. The executable catalog lists the current duration of every recipe.
91
91
 
@@ -228,7 +228,7 @@ including that reduced motion still applies the state instantly.
228
228
 
229
229
  <!-- generated:recipes -->
230
230
 
231
- All 59 recipes in 9 categories, generated from `core/tokens/motion-recipes.json`. Damping ratio and
231
+ All 60 recipes in 9 categories, generated from `core/tokens/motion-recipes.json`. Damping ratio and
232
232
  overshoot are derived from each recipe's spring by `core/assets/core/spring.js`, so a
233
233
  retuned spring cannot leave a stale number in this table.
234
234
 
@@ -243,6 +243,7 @@ correct is a material question; see the signature policy below.
243
243
  | `press`: Press and release | 320ms | pressure | resin | 0.660 | 6.3% | Buttons, icon buttons and segmented controls. Disabled controls never animate. | Apply the semantic state immediately; omit decorative movement. |
244
244
  | `hover`: Light follows the surface | 700ms | caustic | resin | 0.900 | 0.2% | Fine-pointer affordance only; keyboard focus is immediate. | Apply the semantic state immediately; omit decorative movement. |
245
245
  | `selection`: Selection settle | 420ms | meniscus | resin | 0.700 | 4.6% | Selected chips, radios, toggles and navigation; set selected semantics first. | Apply the semantic state immediately; omit decorative movement. |
246
+ | `selection-travel`: Selection travel | 460ms | meniscus | resin | 1.000 | none | The one .cr-indicator.pill behind the selected segment of tabs, a segmented control, the dock, bottom navigation or a toggle button group, moving to the new segment when the choice changes. Set the selected semantics first; selection stays label weight, so the pill is never the only sign of it. Critically damped: a pill that overshoots stands for a moment on a segment nobody chose. | The pill is placed behind the new segment at once; nothing travels. |
246
247
  | `switch-on`: Switch on | 460ms | coalesce | resin | 0.620 | 8.4% | Animate the thumb after its checked state is applied. | Apply the semantic state immediately; omit decorative movement. |
247
248
  | `switch-off`: Switch off | 460ms | coalesce | resin | 0.620 | 8.4% | Animate the thumb after its unchecked state is applied. | Apply the semantic state immediately; omit decorative movement. |
248
249
  | `check`: Checkmark confirmation | 340ms | iris | resin | 0.800 | 1.5% | Checkbox and radio indicators; retain a visible non-color state. | Apply the semantic state immediately; omit decorative movement. |
package/docs/tokens.md CHANGED
@@ -361,7 +361,7 @@ What a value means: the surface a card sits on, the duration a control settles o
361
361
  | --- | --- | --- | --- |
362
362
  | `semantic.typography.family` | fontFamily | `Manrope` | None |
363
363
  | `semantic.typography.readingSize` | dimension | `16px` | None |
364
- | `semantic.typography.readingLeading` | dimension | `24px` | None |
364
+ | `semantic.typography.readingLeading` | dimension | `25.6px` | None |
365
365
  | `semantic.typography.scale.display.ratio` | number | `2` | display: multiple of the reading size |
366
366
  | `semantic.typography.scale.display.leading` | number | `1.1` | display: line height as a multiple of its own size |
367
367
  | `semantic.typography.scale.display.tracking` | dimension | `-0.055em` | display: letter spacing |
@@ -375,7 +375,7 @@ What a value means: the surface a card sits on, the duration a control settles o
375
375
  | `semantic.typography.scale.subheading.leading` | number | `1.45` | subheading: line height as a multiple of its own size |
376
376
  | `semantic.typography.scale.subheading.tracking` | dimension | `-0.01em` | subheading: letter spacing |
377
377
  | `semantic.typography.scale.body.ratio` | number | `1` | body: multiple of the reading size |
378
- | `semantic.typography.scale.body.leading` | number | `1.5` | body: line height as a multiple of its own size |
378
+ | `semantic.typography.scale.body.leading` | number | `1.6` | body: line height as a multiple of its own size |
379
379
  | `semantic.typography.scale.body.tracking` | dimension | `0` | body: letter spacing |
380
380
  | `semantic.typography.scale.caption.ratio` | number | `0.8125` | caption: multiple of the reading size |
381
381
  | `semantic.typography.scale.caption.leading` | number | `1.45` | caption: line height as a multiple of its own size |
@@ -74,7 +74,7 @@ object CrystalToken {
74
74
  const val motionTravelMax = "50px"
75
75
  const val typographyFamily = "Manrope"
76
76
  const val typographyReadingSize = "16px"
77
- const val typographyReadingLeading = "24px"
77
+ const val typographyReadingLeading = "25.6px"
78
78
  const val typographyScaleDisplayRatio = "2"
79
79
  const val typographyScaleDisplayLeading = "1.1"
80
80
  const val typographyScaleDisplayTracking = "-0.055em"
@@ -88,7 +88,7 @@ object CrystalToken {
88
88
  const val typographyScaleSubheadingLeading = "1.45"
89
89
  const val typographyScaleSubheadingTracking = "-0.01em"
90
90
  const val typographyScaleBodyRatio = "1"
91
- const val typographyScaleBodyLeading = "1.5"
91
+ const val typographyScaleBodyLeading = "1.6"
92
92
  const val typographyScaleBodyTracking = "0"
93
93
  const val typographyScaleCaptionRatio = "0.8125"
94
94
  const val typographyScaleCaptionLeading = "1.45"
@@ -74,7 +74,7 @@ public enum CrystalToken {
74
74
  public static let motionTravelMax = "50px"
75
75
  public static let typographyFamily = "Manrope"
76
76
  public static let typographyReadingSize = "16px"
77
- public static let typographyReadingLeading = "24px"
77
+ public static let typographyReadingLeading = "25.6px"
78
78
  public static let typographyScaleDisplayRatio = "2"
79
79
  public static let typographyScaleDisplayLeading = "1.1"
80
80
  public static let typographyScaleDisplayTracking = "-0.055em"
@@ -88,7 +88,7 @@ public enum CrystalToken {
88
88
  public static let typographyScaleSubheadingLeading = "1.45"
89
89
  public static let typographyScaleSubheadingTracking = "-0.01em"
90
90
  public static let typographyScaleBodyRatio = "1"
91
- public static let typographyScaleBodyLeading = "1.5"
91
+ public static let typographyScaleBodyLeading = "1.6"
92
92
  public static let typographyScaleBodyTracking = "0"
93
93
  public static let typographyScaleCaptionRatio = "0.8125"
94
94
  public static let typographyScaleCaptionLeading = "1.45"
@@ -74,7 +74,7 @@ export const crystalTokens = {
74
74
  "motion.travel.max": "50px",
75
75
  "typography.family": "Manrope",
76
76
  "typography.readingSize": "16px",
77
- "typography.readingLeading": "24px",
77
+ "typography.readingLeading": "25.6px",
78
78
  "typography.scale.display.ratio": "2",
79
79
  "typography.scale.display.leading": "1.1",
80
80
  "typography.scale.display.tracking": "-0.055em",
@@ -88,7 +88,7 @@ export const crystalTokens = {
88
88
  "typography.scale.subheading.leading": "1.45",
89
89
  "typography.scale.subheading.tracking": "-0.01em",
90
90
  "typography.scale.body.ratio": "1",
91
- "typography.scale.body.leading": "1.5",
91
+ "typography.scale.body.leading": "1.6",
92
92
  "typography.scale.body.tracking": "0",
93
93
  "typography.scale.caption.ratio": "0.8125",
94
94
  "typography.scale.caption.leading": "1.45",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@crystal-ui/core",
3
- "version": "2.4.0",
3
+ "version": "2.6.0",
4
4
  "description": "Crystal, Meridian's design system: design tokens, material stylesheets, a token resolver, a headless state core, motion recipes, icons and the specification.",
5
5
  "keywords": [
6
6
  "design-system",
@@ -93,7 +93,7 @@
93
93
  "hover",
94
94
  "focus"
95
95
  ],
96
- "material": "Resin plane, Stone label backing, primary fill on the selected destination",
96
+ "material": "Resin plane, Stone label backing, the primary pill behind the selected destination",
97
97
  "surface": [
98
98
  "dock"
99
99
  ],
@@ -102,7 +102,7 @@
102
102
  "crystal": "The single shared plane, label weight for the current entry, elevation",
103
103
  "product": "Destinations and routing",
104
104
  "motion": [
105
- "selection"
105
+ "selection-travel"
106
106
  ],
107
107
  "parity": [
108
108
  "mui:BottomNavigation",
@@ -148,7 +148,7 @@
148
148
  "selected",
149
149
  "disabled"
150
150
  ],
151
- "material": "Resin strip, primary fill on the selected tab",
151
+ "material": "Resin strip, the primary pill behind the selected tab",
152
152
  "surface": [
153
153
  "dock"
154
154
  ],
@@ -157,7 +157,8 @@
157
157
  "crystal": "Strip material, label weight for the selected tab, focus ring",
158
158
  "product": "The roving tabindex implementation and panel content",
159
159
  "motion": [
160
- "tab-in"
160
+ "tab-in",
161
+ "selection-travel"
161
162
  ],
162
163
  "parity": [
163
164
  "mantine:Tabs",
@@ -348,10 +349,10 @@
348
349
  ],
349
350
  "geometry": "Pill; targets at least 44px; respects the safe area.",
350
351
  "semantics": "role=\"navigation\"; the current destination carries aria-current=\"page\".",
351
- "crystal": "Material, geometry, selection by label weight, safe-area inset",
352
+ "crystal": "Material, geometry, selection by label weight with the pill behind it, safe-area inset",
352
353
  "product": "Destinations and routing",
353
354
  "motion": [
354
- "selection"
355
+ "selection-travel"
355
356
  ],
356
357
  "parity": [
357
358
  "mui:BottomNavigation"
@@ -79,10 +79,11 @@
79
79
  ],
80
80
  "geometry": "Pill outer geometry; interior corners square against neighbours",
81
81
  "semantics": "group role with an accessible name when the buttons are related",
82
- "crystal": "The shared plane and interior separation",
82
+ "crystal": "The shared plane and interior separation; as a toggle set, the pill behind the pressed button",
83
83
  "product": "Which actions are grouped",
84
84
  "motion": [
85
- "press"
85
+ "press",
86
+ "selection-travel"
86
87
  ],
87
88
  "parity": [
88
89
  "mantine:Button.Group",
@@ -463,7 +463,7 @@
463
463
  "selected",
464
464
  "disabled"
465
465
  ],
466
- "material": "One Resin plane; primary fill on the selected segment",
466
+ "material": "One Resin plane; the primary pill behind the selected segment",
467
467
  "surface": [
468
468
  "dock"
469
469
  ],
@@ -472,7 +472,7 @@
472
472
  "crystal": "Shared plane, label weight for the selected segment, focus ring",
473
473
  "product": "Options and change handling",
474
474
  "motion": [
475
- "selection"
475
+ "selection-travel"
476
476
  ],
477
477
  "parity": [
478
478
  "mantine:SegmentedControl",
@@ -1328,7 +1328,7 @@
1328
1328
  ],
1329
1329
  "material": "Resin thumb over the gradient field",
1330
1330
  "surface": [
1331
- "none"
1331
+ "resin"
1332
1332
  ],
1333
1333
  "geometry": "Thumb reaches 44px including its hit area.",
1334
1334
  "semantics": "Two linked sliders; each axis announces its own value and responds to arrow keys.",
@@ -1351,7 +1351,7 @@
1351
1351
  ],
1352
1352
  "material": "Resin thumb on a gradient track",
1353
1353
  "surface": [
1354
- "none"
1354
+ "resin"
1355
1355
  ],
1356
1356
  "geometry": "Matches the slider contract.",
1357
1357
  "semantics": "role=\"slider\" with the channel named and the value in that channel's units.",
@@ -1374,7 +1374,7 @@
1374
1374
  ],
1375
1375
  "material": "Resin thumb on the hue ring",
1376
1376
  "surface": [
1377
- "none"
1377
+ "resin"
1378
1378
  ],
1379
1379
  "geometry": "Ring thickness is a declared proportion of the radius.",
1380
1380
  "semantics": "role=\"slider\" in degrees, wrapping at 360.",
@@ -287,7 +287,8 @@
287
287
  ],
288
288
  "material": "Frost panel with Haze reading fill (R15e)",
289
289
  "surface": [
290
- "frost"
290
+ "frost",
291
+ "haze"
291
292
  ],
292
293
  "geometry": "Content radius; anchored to the trigger",
293
294
  "semantics": "Focus moves into the popover, returns to the trigger on dismiss, and Escape cancels",
@@ -74,7 +74,8 @@
74
74
  ],
75
75
  "material": "Frost panel with Haze rows (R15e)",
76
76
  "surface": [
77
- "frost"
77
+ "frost",
78
+ "haze"
78
79
  ],
79
80
  "geometry": "Content radius; every row reserves leading room for a check mark, so ticking one does not shift its label",
80
81
  "semantics": "role=menu with full keyboard navigation, type-ahead and Escape; checkable items use aria-checked",
@@ -127,7 +128,8 @@
127
128
  ],
128
129
  "material": "Frost panel with Haze reading fill (R15e)",
129
130
  "surface": [
130
- "frost"
131
+ "frost",
132
+ "haze"
131
133
  ],
132
134
  "geometry": "Content radius; flips and shifts to stay in view",
133
135
  "semantics": "The trigger carries aria-expanded and aria-controls; focus moves in for interactive content",
@@ -6,7 +6,7 @@
6
6
  {
7
7
  "id": "video-player",
8
8
  "name": "Video player",
9
- "anatomy": "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.",
9
+ "anatomy": "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, caption style, audio track, quality), picture in picture and full screen.",
10
10
  "states": [
11
11
  "idle",
12
12
  "playing",
@@ -27,7 +27,7 @@
27
27
  "frost"
28
28
  ],
29
29
  "geometry": "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.",
30
- "semantics": "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.",
30
+ "semantics": "Native video element underneath. Controls are real buttons, captions are supported and their state is announced, and keyboard shortcuts do not trap focus. The caption style (a larger size, 1.25 or 1.5 times, and a solid backing on the opaque surface) is the reader's: it is kept for every player the reader opens and drawn with `.cr-media-caption`'s `.large`, `.larger` and `.solid`. Speed, subtitle, caption-style, 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.",
31
31
  "crystal": "Stage, transport and caption materials, transport geometry and insets, the settings menu, the motion of showing and hiding controls",
32
32
  "product": "Sources, caption and audio tracks, quality renditions and their switching (adaptive streaming), DRM, analytics",
33
33
  "motion": [