@crystal-ui/core 2.2.0 → 2.3.1
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/assets/crystal.css +358 -8
- package/assets/motion.css +3 -3
- package/assets/tokens.js +1 -1
- package/docs/accessibility.md +12 -3
- package/docs/catalogue.md +38 -55
- package/docs/components.md +12 -2
- package/docs/motion-components.md +1 -3
- package/docs/motion.md +1 -3
- package/docs/tokens.md +2 -1
- package/exports/crystal-tokens.kt +1 -0
- package/exports/crystal-tokens.swift +1 -0
- package/exports/crystal-tokens.ts +1 -0
- package/package.json +1 -1
- package/tokens/catalogue/02-navigation.json +7 -12
- package/tokens/catalogue/03-actions.json +4 -5
- package/tokens/catalogue/04-inputs.json +5 -12
- package/tokens/catalogue/05-data-display.json +2 -24
- package/tokens/catalogue/06-feedback.json +1 -4
- package/tokens/catalogue/07-overlays.json +2 -2
- package/tokens/catalogue/09-utility.json +2 -2
- package/tokens/catalogue/11-media.json +1 -1
- package/tokens/catalogue/12-commerce.json +1 -2
- package/tokens/catalogue/13-screens.json +1 -1
- package/tokens/catalogue.json +53 -72
- package/tokens/crystal.json +2 -1
- package/tokens/crystal.tokens.json +5 -0
- package/tokens/motion-recipes.json +0 -96
- package/tokens/surfaces.json +16 -6
package/docs/catalogue.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Component catalogue
|
|
2
2
|
|
|
3
|
-
Crystal specifies **
|
|
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.
|
|
4
4
|
|
|
5
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.
|
|
6
6
|
|
|
@@ -13,8 +13,8 @@ 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 |
|
|
17
|
-
| [Data display](#data-display) |
|
|
16
|
+
| [Inputs and forms](#inputs-and-forms) | 52 | 44 |
|
|
17
|
+
| [Data display](#data-display) | 36 | 27 |
|
|
18
18
|
| [Feedback and status](#feedback-and-status) | 15 | 14 |
|
|
19
19
|
| [Overlays](#overlays) | 11 | 9 |
|
|
20
20
|
| [Typography](#typography) | 17 | 2 |
|
|
@@ -24,7 +24,7 @@ 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** | **
|
|
27
|
+
| **Total** | **284** | **162** |
|
|
28
28
|
|
|
29
29
|
## Surfaces
|
|
30
30
|
|
|
@@ -34,26 +34,27 @@ Every component is made of one or more of these, named in its **Surface** row, o
|
|
|
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> | 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> |
|
|
38
|
-
| <a id="surface-resin"></a>**Resin plane** `resin` | Resin | <code>.cr-resin</code> |
|
|
39
|
-
| <a id="surface-resin-panel"></a>**Resin panel** `resin-panel` | Resin | <code>.cr-resin.panel</code> |
|
|
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. |
|
|
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. `.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> |
|
|
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. |
|
|
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
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. |
|
|
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
|
-
| <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. |
|
|
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 `<dialog>`; 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> |
|
|
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. |
|
|
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. |
|
|
51
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. |
|
|
52
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. |
|
|
53
|
-
| <a id="surface-drag-handle"></a>**Drag handle** `drag-handle` | — | <code>.cr-drag-handle</code> |
|
|
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. |
|
|
54
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. |
|
|
55
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. |
|
|
56
|
-
| <a id="surface-none"></a>**No surface of its own** `none` | — | — |
|
|
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. |
|
|
57
58
|
|
|
58
59
|
## Layout and structure
|
|
59
60
|
|
|
@@ -300,7 +301,7 @@ Pill-shaped destination with optional icon, label and current-location dot.
|
|
|
300
301
|
<tr><th scope="row">Semantics</th><td>aria-current="page" for the active destination, never aria-selected</td></tr>
|
|
301
302
|
<tr><th scope="row">Crystal supplies</th><td>Material, pill geometry, current-location dot, focus ring</td></tr>
|
|
302
303
|
<tr><th scope="row">Product owns</th><td>Routing and which destination is current</td></tr>
|
|
303
|
-
<tr><th scope="row">Motion</th><td><code>
|
|
304
|
+
<tr><th scope="row">Motion</th><td><code>selection</code></td></tr>
|
|
304
305
|
<tr><th scope="row">Parity</th><td>mantine:NavLink · mui:ListItemButton · antd:Menu.Item</td></tr>
|
|
305
306
|
</tbody></table></div>
|
|
306
307
|
|
|
@@ -310,13 +311,13 @@ A vertical Frost panel of nav links, collapsible to icons.
|
|
|
310
311
|
|
|
311
312
|
<div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
|
|
312
313
|
<tr><th scope="row">States</th><td>expanded, collapsed, narrow</td></tr>
|
|
313
|
-
<tr><th scope="row">Material</th><td>Frost panel,
|
|
314
|
+
<tr><th scope="row">Material</th><td>Frost panel; its destinations are navigation entries, the current one at weight 800 on the surface-alt fill with the location dot</td></tr>
|
|
314
315
|
<tr><th scope="row">Surface</th><td><a href="#surface-frost">Frost panel</a> → <a href="#surface-nav-item">Navigation entry</a></td></tr>
|
|
315
316
|
<tr><th scope="row">Geometry</th><td>Panel radius = content radius + 6px</td></tr>
|
|
316
317
|
<tr><th scope="row">Semantics</th><td>nav landmark with an accessible name; collapsed items keep accessible names</td></tr>
|
|
317
318
|
<tr><th scope="row">Crystal supplies</th><td>Panel material, collapse geometry, active treatment</td></tr>
|
|
318
319
|
<tr><th scope="row">Product owns</th><td>Destination list, routing, collapse persistence</td></tr>
|
|
319
|
-
<tr><th scope="row">Motion</th><td><code>selection</code
|
|
320
|
+
<tr><th scope="row">Motion</th><td><code>selection</code></td></tr>
|
|
320
321
|
<tr><th scope="row">Parity</th><td>mantine:NavLink · mui:Drawer · antd:Menu</td></tr>
|
|
321
322
|
</tbody></table></div>
|
|
322
323
|
|
|
@@ -332,7 +333,7 @@ One floating Resin plane holding labelled destinations on a shared Stone label g
|
|
|
332
333
|
<tr><th scope="row">Semantics</th><td>nav landmark; aria-pressed or aria-current on the destination</td></tr>
|
|
333
334
|
<tr><th scope="row">Crystal supplies</th><td>The single shared plane, label weight for the current entry, elevation</td></tr>
|
|
334
335
|
<tr><th scope="row">Product owns</th><td>Destinations and routing</td></tr>
|
|
335
|
-
<tr><th scope="row">Motion</th><td><code>selection</code
|
|
336
|
+
<tr><th scope="row">Motion</th><td><code>selection</code></td></tr>
|
|
336
337
|
<tr><th scope="row">Parity</th><td>mui:BottomNavigation · antd:Menu · mantine:SegmentedControl</td></tr>
|
|
337
338
|
</tbody></table></div>
|
|
338
339
|
|
|
@@ -361,7 +362,7 @@ A Resin tab strip with a selected tab and an associated panel.
|
|
|
361
362
|
<div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
|
|
362
363
|
<tr><th scope="row">States</th><td>default, hover, focus, selected, disabled</td></tr>
|
|
363
364
|
<tr><th scope="row">Material</th><td>Resin strip, primary fill on the selected tab</td></tr>
|
|
364
|
-
<tr><th scope="row">Surface</th><td><a href="#surface-
|
|
365
|
+
<tr><th scope="row">Surface</th><td><a href="#surface-dock">Dock</a></td></tr>
|
|
365
366
|
<tr><th scope="row">Geometry</th><td>Pill tabs inside a pill strip; 44px minimum</td></tr>
|
|
366
367
|
<tr><th scope="row">Semantics</th><td>role=tablist/tab/tabpanel with arrow-key, Home and End navigation and aria-selected</td></tr>
|
|
367
368
|
<tr><th scope="row">Crystal supplies</th><td>Strip material, label weight for the selected tab, focus ring</td></tr>
|
|
@@ -398,7 +399,7 @@ Ordered steps with a connector, each showing its own completion state.
|
|
|
398
399
|
<tr><th scope="row">Semantics</th><td>Ordered list; the current step carries aria-current="step"; state is announced in text, not by colour</td></tr>
|
|
399
400
|
<tr><th scope="row">Crystal supplies</th><td>Marker geometry, connector, state treatment</td></tr>
|
|
400
401
|
<tr><th scope="row">Product owns</th><td>Step validation and whether steps are navigable</td></tr>
|
|
401
|
-
<tr><th scope="row">Motion</th><td><code>selection</code
|
|
402
|
+
<tr><th scope="row">Motion</th><td><code>selection</code></td></tr>
|
|
402
403
|
<tr><th scope="row">Parity</th><td>mantine:Stepper · mui:Stepper · antd:Steps</td></tr>
|
|
403
404
|
</tbody></table></div>
|
|
404
405
|
|
|
@@ -479,7 +480,7 @@ A Resin destination group pinned to the bottom of a narrow view.
|
|
|
479
480
|
<tr><th scope="row">Semantics</th><td>role="navigation"; the current destination carries aria-current="page".</td></tr>
|
|
480
481
|
<tr><th scope="row">Crystal supplies</th><td>Material, geometry, selection by label weight, safe-area inset</td></tr>
|
|
481
482
|
<tr><th scope="row">Product owns</th><td>Destinations and routing</td></tr>
|
|
482
|
-
<tr><th scope="row">Motion</th><td><code>selection</code
|
|
483
|
+
<tr><th scope="row">Motion</th><td><code>selection</code></td></tr>
|
|
483
484
|
<tr><th scope="row">Parity</th><td>mui:BottomNavigation</td></tr>
|
|
484
485
|
</tbody></table></div>
|
|
485
486
|
|
|
@@ -590,7 +591,7 @@ Adjacent actions sharing one Resin plane with internal hairlines.
|
|
|
590
591
|
<div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
|
|
591
592
|
<tr><th scope="row">States</th><td>default, hover, focus, disabled</td></tr>
|
|
592
593
|
<tr><th scope="row">Material</th><td>One shared Resin plane, not one plane per button</td></tr>
|
|
593
|
-
<tr><th scope="row">Surface</th><td><a href="#surface-
|
|
594
|
+
<tr><th scope="row">Surface</th><td><a href="#surface-group">Group</a></td></tr>
|
|
594
595
|
<tr><th scope="row">Geometry</th><td>Pill outer geometry; interior corners square against neighbours</td></tr>
|
|
595
596
|
<tr><th scope="row">Semantics</th><td>group role with an accessible name when the buttons are related</td></tr>
|
|
596
597
|
<tr><th scope="row">Crystal supplies</th><td>The shared plane and interior separation</td></tr>
|
|
@@ -606,7 +607,7 @@ A default action and an adjacent disclosure that opens related actions.
|
|
|
606
607
|
<div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
|
|
607
608
|
<tr><th scope="row">States</th><td>default, hover, focus, open, disabled</td></tr>
|
|
608
609
|
<tr><th scope="row">Material</th><td>Shared Resin plane with a hairline between the two targets</td></tr>
|
|
609
|
-
<tr><th scope="row">Surface</th><td><a href="#surface-
|
|
610
|
+
<tr><th scope="row">Surface</th><td><a href="#surface-group">Group</a></td></tr>
|
|
610
611
|
<tr><th scope="row">Geometry</th><td>Pill outer geometry; both halves meet the 44px floor independently</td></tr>
|
|
611
612
|
<tr><th scope="row">Semantics</th><td>Two buttons; the disclosure carries aria-expanded and aria-haspopup="menu"</td></tr>
|
|
612
613
|
<tr><th scope="row">Crystal supplies</th><td>Shared plane, separation, menu material</td></tr>
|
|
@@ -627,7 +628,7 @@ A persistent circular Resin action floating above content.
|
|
|
627
628
|
<tr><th scope="row">Semantics</th><td>Requires an accessible name; must not cover the final content or the focused element</td></tr>
|
|
628
629
|
<tr><th scope="row">Crystal supplies</th><td>Material, elevation, extend behaviour, safe-area offset</td></tr>
|
|
629
630
|
<tr><th scope="row">Product owns</th><td>The action and when it is present</td></tr>
|
|
630
|
-
<tr><th scope="row">Motion</th><td><code>press</code
|
|
631
|
+
<tr><th scope="row">Motion</th><td><code>press</code></td></tr>
|
|
631
632
|
<tr><th scope="row">Parity</th><td>mui:Fab · mantine:— · antd:FloatButton</td></tr>
|
|
632
633
|
</tbody></table></div>
|
|
633
634
|
|
|
@@ -672,7 +673,7 @@ A Resin group of actions that appears when a selection exists.
|
|
|
672
673
|
<div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
|
|
673
674
|
<tr><th scope="row">States</th><td>hidden, shown, focus-visible</td></tr>
|
|
674
675
|
<tr><th scope="row">Material</th><td>Resin plane</td></tr>
|
|
675
|
-
<tr><th scope="row">Surface</th><td><a href="#surface-
|
|
676
|
+
<tr><th scope="row">Surface</th><td><a href="#surface-dock">Dock</a></td></tr>
|
|
676
677
|
<tr><th scope="row">Geometry</th><td>Pill; floats above content with the floating elevation.</td></tr>
|
|
677
678
|
<tr><th scope="row">Semantics</th><td>role="toolbar"; announces how many items are selected.</td></tr>
|
|
678
679
|
<tr><th scope="row">Crystal supplies</th><td>Material, entry and exit motion, elevation</td></tr>
|
|
@@ -948,7 +949,7 @@ A pill strip of mutually exclusive options sharing one Resin plane.
|
|
|
948
949
|
<div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
|
|
949
950
|
<tr><th scope="row">States</th><td>default, hover, focus, selected, disabled</td></tr>
|
|
950
951
|
<tr><th scope="row">Material</th><td>One Resin plane; primary fill on the selected segment</td></tr>
|
|
951
|
-
<tr><th scope="row">Surface</th><td><a href="#surface-
|
|
952
|
+
<tr><th scope="row">Surface</th><td><a href="#surface-dock">Dock</a></td></tr>
|
|
952
953
|
<tr><th scope="row">Geometry</th><td>Pill strip and pill segments; 44px minimum</td></tr>
|
|
953
954
|
<tr><th scope="row">Semantics</th><td>Radio group semantics, or aria-pressed on buttons; never aria-selected outside a tablist</td></tr>
|
|
954
955
|
<tr><th scope="row">Crystal supplies</th><td>Shared plane, label weight for the selected segment, focus ring</td></tr>
|
|
@@ -1220,7 +1221,7 @@ A toolbar of formatting actions above an editable content surface.
|
|
|
1220
1221
|
<div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
|
|
1221
1222
|
<tr><th scope="row">States</th><td>idle, focus, selection-active, disabled, read-only</td></tr>
|
|
1222
1223
|
<tr><th scope="row">Material</th><td>Resin toolbar, Haze editing surface</td></tr>
|
|
1223
|
-
<tr><th scope="row">Surface</th><td><a href="#surface-
|
|
1224
|
+
<tr><th scope="row">Surface</th><td><a href="#surface-field">Field shell</a></td></tr>
|
|
1224
1225
|
<tr><th scope="row">Geometry</th><td>Toolbar is a pill group; surface at content radius</td></tr>
|
|
1225
1226
|
<tr><th scope="row">Semantics</th><td>Toolbar actions use aria-pressed for active formatting; the editor exposes its own semantics</td></tr>
|
|
1226
1227
|
<tr><th scope="row">Crystal supplies</th><td>Toolbar and surface appearance, active-format treatment</td></tr>
|
|
@@ -1420,7 +1421,6 @@ A two-dimensional field for saturation and brightness.
|
|
|
1420
1421
|
<tr><th scope="row">Semantics</th><td>Two linked sliders; each axis announces its own value and responds to arrow keys.</td></tr>
|
|
1421
1422
|
<tr><th scope="row">Crystal supplies</th><td>Thumb material, focus ring, contrast of the thumb against any underlying colour</td></tr>
|
|
1422
1423
|
<tr><th scope="row">Product owns</th><td>Colour space and value</td></tr>
|
|
1423
|
-
<tr><th scope="row">Motion</th><td><code>slider-step</code></td></tr>
|
|
1424
1424
|
<tr><th scope="row">Parity</th><td>react-aria:ColorArea</td></tr>
|
|
1425
1425
|
</tbody></table></div>
|
|
1426
1426
|
|
|
@@ -1436,7 +1436,6 @@ One channel of a colour, as a track.
|
|
|
1436
1436
|
<tr><th scope="row">Semantics</th><td>role="slider" with the channel named and the value in that channel's units.</td></tr>
|
|
1437
1437
|
<tr><th scope="row">Crystal supplies</th><td>Thumb and track material, focus ring</td></tr>
|
|
1438
1438
|
<tr><th scope="row">Product owns</th><td>Which channel, and the colour space</td></tr>
|
|
1439
|
-
<tr><th scope="row">Motion</th><td><code>slider-step</code></td></tr>
|
|
1440
1439
|
<tr><th scope="row">Parity</th><td>react-aria:ColorSlider</td></tr>
|
|
1441
1440
|
</tbody></table></div>
|
|
1442
1441
|
|
|
@@ -1452,7 +1451,6 @@ Hue as a ring.
|
|
|
1452
1451
|
<tr><th scope="row">Semantics</th><td>role="slider" in degrees, wrapping at 360.</td></tr>
|
|
1453
1452
|
<tr><th scope="row">Crystal supplies</th><td>Thumb material, ring geometry, focus ring</td></tr>
|
|
1454
1453
|
<tr><th scope="row">Product owns</th><td>Colour space</td></tr>
|
|
1455
|
-
<tr><th scope="row">Motion</th><td><code>slider-step</code></td></tr>
|
|
1456
1454
|
<tr><th scope="row">Parity</th><td>react-aria:ColorWheel</td></tr>
|
|
1457
1455
|
</tbody></table></div>
|
|
1458
1456
|
|
|
@@ -1871,7 +1869,7 @@ A reading surface with one intentionally tightened corner indicating authorship
|
|
|
1871
1869
|
<tr><th scope="row">Semantics</th><td>Author and time are text, not implied by side alone</td></tr>
|
|
1872
1870
|
<tr><th scope="row">Crystal supplies</th><td>Silhouette, corner asymmetry, own and incoming pairs, mirroring</td></tr>
|
|
1873
1871
|
<tr><th scope="row">Product owns</th><td>Delivery, grouping rules and failure recovery</td></tr>
|
|
1874
|
-
<tr><th scope="row">Motion</th><td><code>message-in</code
|
|
1872
|
+
<tr><th scope="row">Motion</th><td><code>message-in</code></td></tr>
|
|
1875
1873
|
<tr><th scope="row">Parity</th><td>—</td></tr>
|
|
1876
1874
|
</tbody></table></div>
|
|
1877
1875
|
|
|
@@ -1925,21 +1923,6 @@ A collection rendered as a list or grid, with sorting and paging.
|
|
|
1925
1923
|
<tr><th scope="row">Parity</th><td>primereact:dataview</td></tr>
|
|
1926
1924
|
</tbody></table></div>
|
|
1927
1925
|
|
|
1928
|
-
### Virtual scroller
|
|
1929
|
-
|
|
1930
|
-
A long list that renders only what is near the viewport.
|
|
1931
|
-
|
|
1932
|
-
<div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
|
|
1933
|
-
<tr><th scope="row">States</th><td>at-rest, scrolling, loading</td></tr>
|
|
1934
|
-
<tr><th scope="row">Material</th><td>None of its own</td></tr>
|
|
1935
|
-
<tr><th scope="row">Surface</th><td><a href="#surface-none">No surface of its own</a></td></tr>
|
|
1936
|
-
<tr><th scope="row">Geometry</th><td>Scroll container follows the scroll-area contract.</td></tr>
|
|
1937
|
-
<tr><th scope="row">Semantics</th><td>Rows keep their position in the set via aria-setsize and aria-posinset.</td></tr>
|
|
1938
|
-
<tr><th scope="row">Crystal supplies</th><td>Scroll surface, focus retention across recycling</td></tr>
|
|
1939
|
-
<tr><th scope="row">Product owns</th><td>Row height strategy, data source</td></tr>
|
|
1940
|
-
<tr><th scope="row">Parity</th><td>primereact:virtualscroller</td></tr>
|
|
1941
|
-
</tbody></table></div>
|
|
1942
|
-
|
|
1943
1926
|
### Image list
|
|
1944
1927
|
|
|
1945
1928
|
A grid of images with optional captions.
|
|
@@ -1994,7 +1977,7 @@ Two images under a draggable divider.
|
|
|
1994
1977
|
<div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
|
|
1995
1978
|
<tr><th scope="row">States</th><td>at-rest, dragging, focus-visible</td></tr>
|
|
1996
1979
|
<tr><th scope="row">Material</th><td>Resin handle over the images</td></tr>
|
|
1997
|
-
<tr><th scope="row">Surface</th><td><a href="#surface-
|
|
1980
|
+
<tr><th scope="row">Surface</th><td><a href="#surface-resin">Resin plane</a></td></tr>
|
|
1998
1981
|
<tr><th scope="row">Geometry</th><td>Handle is a pill and reaches 44px.</td></tr>
|
|
1999
1982
|
<tr><th scope="row">Semantics</th><td>The divider is a slider with a percentage value and keyboard steps.</td></tr>
|
|
2000
1983
|
<tr><th scope="row">Crystal supplies</th><td>Handle material, focus ring, drag motion</td></tr>
|
|
@@ -2194,7 +2177,7 @@ A determinate or indeterminate track showing work in flight.
|
|
|
2194
2177
|
<tr><th scope="row">Semantics</th><td>role=progressbar with aria-valuenow when determinate; indeterminate omits the value rather than faking one</td></tr>
|
|
2195
2178
|
<tr><th scope="row">Crystal supplies</th><td>Track, fill, indeterminate motion and reduced-motion fallback</td></tr>
|
|
2196
2179
|
<tr><th scope="row">Product owns</th><td>Real progress. Never simulate progress for work that is not measurable.</td></tr>
|
|
2197
|
-
<tr><th scope="row">Motion</th><td><code>progress-change</code>, <code>
|
|
2180
|
+
<tr><th scope="row">Motion</th><td><code>progress-change</code>, <code>activity-travel</code></td></tr>
|
|
2198
2181
|
<tr><th scope="row">Parity</th><td>mantine:Progress · mui:LinearProgress · antd:Progress</td></tr>
|
|
2199
2182
|
</tbody></table></div>
|
|
2200
2183
|
|
|
@@ -2226,7 +2209,7 @@ A compact indeterminate activity mark.
|
|
|
2226
2209
|
<tr><th scope="row">Semantics</th><td>Accompanied by text saying what is loading; reduced motion replaces spin with a static, still-legible state</td></tr>
|
|
2227
2210
|
<tr><th scope="row">Crystal supplies</th><td>Mark, motion and reduced-motion fallback</td></tr>
|
|
2228
2211
|
<tr><th scope="row">Product owns</th><td>When it appears and what it describes</td></tr>
|
|
2229
|
-
<tr><th scope="row">Motion</th><td><code>
|
|
2212
|
+
<tr><th scope="row">Motion</th><td><code>activity-turn</code></td></tr>
|
|
2230
2213
|
<tr><th scope="row">Parity</th><td>mantine:Loader · mui:CircularProgress · antd:Spin</td></tr>
|
|
2231
2214
|
</tbody></table></div>
|
|
2232
2215
|
|
|
@@ -2389,7 +2372,7 @@ A Mirage scrim, a Haze decision surface, a title, body and named actions.
|
|
|
2389
2372
|
<tr><th scope="row">States</th><td>closed, opening, open, closing</td></tr>
|
|
2390
2373
|
<tr><th scope="row">Material</th><td>Mirage scrim; 80% feathered Haze surface above it</td></tr>
|
|
2391
2374
|
<tr><th scope="row">Surface</th><td><a href="#surface-dialog">Dialog</a> → <a href="#surface-mirage">Mirage scrim</a></td></tr>
|
|
2392
|
-
<tr><th scope="row">Geometry</th><td>
|
|
2375
|
+
<tr><th scope="row">Geometry</th><td>Panel radius (the content radius plus 6px), as .cr-dialog draws it; 12px minimum from content to the feathered edge</td></tr>
|
|
2393
2376
|
<tr><th scope="row">Semantics</th><td>Real modal semantics with a named dialog, focus containment, Escape, and focus return to the trigger</td></tr>
|
|
2394
2377
|
<tr><th scope="row">Crystal supplies</th><td>Scrim, surface, entrance and exit motion, elevation</td></tr>
|
|
2395
2378
|
<tr><th scope="row">Product owns</th><td>Modality, focus management, the decision itself and its consequences</td></tr>
|
|
@@ -2485,7 +2468,7 @@ Short supplemental text on a small Resin surface, anchored to its trigger.
|
|
|
2485
2468
|
<tr><th scope="row">States</th><td>hidden, visible</td></tr>
|
|
2486
2469
|
<tr><th scope="row">Material</th><td>Frost, as every transient overlay is (R15e); the text sits directly on the panel</td></tr>
|
|
2487
2470
|
<tr><th scope="row">Surface</th><td><a href="#surface-frost">Frost panel</a></td></tr>
|
|
2488
|
-
<tr><th scope="row">Geometry</th><td>18px radius; compact padding</td></tr>
|
|
2471
|
+
<tr><th scope="row">Geometry</th><td>18px radius (component.overlay.tooltipRadius); compact padding</td></tr>
|
|
2489
2472
|
<tr><th scope="row">Semantics</th><td>Never the sole accessible name. Opens on focus as well as hover, dismisses on Escape, and stays while hovered.</td></tr>
|
|
2490
2473
|
<tr><th scope="row">Crystal supplies</th><td>Surface, delay, placement</td></tr>
|
|
2491
2474
|
<tr><th scope="row">Product owns</th><td>Content and whether a tooltip is the right disclosure at all</td></tr>
|
|
@@ -2934,7 +2917,7 @@ A region whose size the person controls, with a visible grab handle.
|
|
|
2934
2917
|
<div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
|
|
2935
2918
|
<tr><th scope="row">States</th><td>idle, hover, dragging, at-min, at-max, disabled</td></tr>
|
|
2936
2919
|
<tr><th scope="row">Material</th><td>Resin handle on the region's own surface</td></tr>
|
|
2937
|
-
<tr><th scope="row">Surface</th><td><a href="#surface-
|
|
2920
|
+
<tr><th scope="row">Surface</th><td><a href="#surface-resin">Resin plane</a></td></tr>
|
|
2938
2921
|
<tr><th scope="row">Geometry</th><td>Handle meets 44px even when the visible grip is narrower</td></tr>
|
|
2939
2922
|
<tr><th scope="row">Semantics</th><td>role=separator with aria-valuenow and arrow-key resizing. Pointer dragging is never the only route.</td></tr>
|
|
2940
2923
|
<tr><th scope="row">Crystal supplies</th><td>Handle treatment, bound states and the settle after a size change</td></tr>
|
|
@@ -3163,7 +3146,7 @@ A grouped set of controls with one tab stop.
|
|
|
3163
3146
|
<div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
|
|
3164
3147
|
<tr><th scope="row">States</th><td>at-rest, focus-visible</td></tr>
|
|
3165
3148
|
<tr><th scope="row">Material</th><td>Resin plane or inherits</td></tr>
|
|
3166
|
-
<tr><th scope="row">Surface</th><td><a href="#surface-
|
|
3149
|
+
<tr><th scope="row">Surface</th><td><a href="#surface-dock">Dock</a></td></tr>
|
|
3167
3150
|
<tr><th scope="row">Geometry</th><td>Controls are pills; the group reaches 44px.</td></tr>
|
|
3168
3151
|
<tr><th scope="row">Semantics</th><td>role="toolbar": one tab stop, arrows move within, orientation declared.</td></tr>
|
|
3169
3152
|
<tr><th scope="row">Crystal supplies</th><td>Material, grouping geometry, focus ring</td></tr>
|
|
@@ -3613,7 +3596,7 @@ The shared transport used by both players.
|
|
|
3613
3596
|
<div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
|
|
3614
3597
|
<tr><th scope="row">States</th><td>idle, playing, paused, buffering, focus-visible</td></tr>
|
|
3615
3598
|
<tr><th scope="row">Material</th><td>Resin plane</td></tr>
|
|
3616
|
-
<tr><th scope="row">Surface</th><td><a href="#surface-resin
|
|
3599
|
+
<tr><th scope="row">Surface</th><td><a href="#surface-resin">Resin plane</a></td></tr>
|
|
3617
3600
|
<tr><th scope="row">Geometry</th><td>Pill; 44px targets throughout.</td></tr>
|
|
3618
3601
|
<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>
|
|
3619
3602
|
<tr><th scope="row">Crystal supplies</th><td>Materials, the press recipe on every control</td></tr>
|
|
@@ -3841,7 +3824,7 @@ Progress through a purchase.
|
|
|
3841
3824
|
<tr><th scope="row">Semantics</th><td>The current step is aria-current; completion is stated in words, and a check mark here means validated rather than selected.</td></tr>
|
|
3842
3825
|
<tr><th scope="row">Crystal supplies</th><td>Step materials, connector treatment, the advance motion</td></tr>
|
|
3843
3826
|
<tr><th scope="row">Product owns</th><td>The steps and their validation</td></tr>
|
|
3844
|
-
<tr><th scope="row">Motion</th><td><code>selection</code
|
|
3827
|
+
<tr><th scope="row">Motion</th><td><code>selection</code></td></tr>
|
|
3845
3828
|
<tr><th scope="row">Parity</th><td>antd:Steps · mui:Stepper</td></tr>
|
|
3846
3829
|
</tbody></table></div>
|
|
3847
3830
|
|
|
@@ -4121,7 +4104,7 @@ A context-sensitive row of actions for the current view.
|
|
|
4121
4104
|
<div class="cr-table-scroll"><table class="cr-table cr-table-properties"><tbody>
|
|
4122
4105
|
<tr><th scope="row">States</th><td>at-rest, focus-visible, overflowing</td></tr>
|
|
4123
4106
|
<tr><th scope="row">Material</th><td>Resin plane</td></tr>
|
|
4124
|
-
<tr><th scope="row">Surface</th><td><a href="#surface-
|
|
4107
|
+
<tr><th scope="row">Surface</th><td><a href="#surface-dock">Dock</a></td></tr>
|
|
4125
4108
|
<tr><th scope="row">Geometry</th><td>Pill; overflow to a menu.</td></tr>
|
|
4126
4109
|
<tr><th scope="row">Semantics</th><td>role="toolbar" with one tab stop.</td></tr>
|
|
4127
4110
|
<tr><th scope="row">Crystal supplies</th><td>Material, overflow behaviour, press recipes</td></tr>
|
package/docs/components.md
CHANGED
|
@@ -18,7 +18,7 @@ The package contains working CSS primitives and a bounded interactive reference.
|
|
|
18
18
|
| Destructive action | Resin/Haze with independent danger boundary and explicit label | `.danger`; app supplies consequence-specific confirmation and recovery |
|
|
19
19
|
| Text field | Visible label, state badge, glowing focus ring, validation, helper/error association | `.cr-input`; working native form example; app supplies validation rules |
|
|
20
20
|
| Selection control | Explicit selected state plus text/mark | Native checkbox, radio and select, styled by `assets/crystal.css` as of 2.1.0, and the native switch (`input[type=checkbox][role=switch]`) as of 2.2.0; keyboard semantics must match the component |
|
|
21
|
-
| Navigation entry | No material of its own; pill hit area; selection by label weight
|
|
21
|
+
| Navigation entry | No material of its own; pill hit area; selection by label weight; current location by a flat primary dot on `aria-current`, inside the entry's own padding so the label never moves | `.cr-nav-item`, `.stacked` for a rail. Routing and the current-page state are app-owned |
|
|
22
22
|
| Bare control | A control inside a coated surface: no fill, shadow, blur or pseudo-layers; target and focus ring kept | `.cr-bare`; the action itself is app-owned |
|
|
23
23
|
| Drag handle | Grip glyph, grab cursor, lift while held | `.cr-drag-handle` with `aria-grabbed` or `data-dragging`; pointer capture, keyboard drag and drop validation are app-owned |
|
|
24
24
|
| Resin panel | The Resin plane at the content radius | `.cr-resin.panel`; a floating window or wide control bar |
|
|
@@ -84,11 +84,21 @@ The catalogue gives every one of its components a **surface** — the material c
|
|
|
84
84
|
|
|
85
85
|
| Surface | Recipe | What it is |
|
|
86
86
|
|---|---|---|
|
|
87
|
-
| Navigation entry | `.cr-nav-item`, `.stacked` for a rail | Furniture on the panel beneath it: no material of its own, pill hit area, 44px target, selection by label weight (650 → 800) and `aria-current
|
|
87
|
+
| Navigation entry | `.cr-nav-item`, `.stacked` for a rail | Furniture on the panel beneath it: no material of its own, pill hit area, 44px target, selection by label weight (650 → 800), and current location by a 6px primary dot on `aria-current` only — never on `aria-selected` or `aria-pressed`, which are selection. The dot is flat (no material, no elevation) and sits in the entry's inline-start padding, so the label does not move. Lifted from this site's own side menu, which this page has always named as the reference implementation of selection; the dot is what the catalogue added (D-22). |
|
|
88
88
|
| Bare control | `.cr-bare` | A control inside a surface that already has a coat — a disclosure chevron, a chip's remove button, a sort header, a stepper's arrows, a dismiss button. Crystal paints every `<button>` by element in five layers; this removes all five and keeps the target and the focus ring. |
|
|
89
89
|
| Drag handle | `.cr-drag-handle` | A bare control with a grip and a lift while `aria-grabbed` or `data-dragging` is set. Pointer capture, the keyboard alternative and drop validation are the product's. |
|
|
90
90
|
| Resin panel | `.cr-resin.panel` | The Resin plane with the content radius instead of the pill, for a floating window or a wide control bar. |
|
|
91
91
|
|
|
92
|
+
Five more arrived in 2.3.0, each from a ruling of 29 September 2026 on something a consumer had reached for and not found:
|
|
93
|
+
|
|
94
|
+
| Surface | Recipe | What it is |
|
|
95
|
+
|---|---|---|
|
|
96
|
+
| Group | `.cr-group`, `.vertical` to stack | A new surface in the vocabulary. A button group and a split button are one Resin plane whose controls touch: one pill outside, the interior corners square against their neighbours, a hairline in `--cr-edge` between. The children keep their fill and give up their own elevation and diffusion, because the plane is the group's. A dock spaces its controls apart; a group does not. |
|
|
97
|
+
| Dock controls that are not buttons | `.cr-dock` | The dock now reaches `[role=tab]` (selected by `aria-selected`), a `label` holding a radio (selected by `:checked`, its focus ring drawn on the label) and a link (current by `aria-current`), with the dock button's values. Every selector is inside `:where()`, so nothing a consumer already sits against changes specificity. |
|
|
98
|
+
| Dialog body | `.cr-dialog-body`, with `.cr-scroll-frost` | The dialog's surface does not scroll; its body does, so a tall dialog keeps its title in view and takes the edge fade without dissolving its own fill. Give the body `tabindex="0"` and a name when it scrolls, so a keyboard can reach and scroll it. A dialog written without a body scrolls its surface as before. `position: fixed` now applies to a native `dialog.cr-dialog` only, which the browser centres; on any other element the host positions the surface. |
|
|
99
|
+
| Recessed overlay | `.cr-haze.overlay` | A menu, popover or listbox opened inside a pane that is already lifted. On the page a transient overlay is Frost; inside a Haze dialog or a Frost panel it recesses into Haze, and plain Haze has no edge. This is a flat Haze fill with the `--cr-edge` rim and the content shadow, and no feather. |
|
|
100
|
+
| Count | `.cr-resin-haze.count` | The compact display sized for a count: a 20px circle that grows to a pill with its digits, filled to its own edge, with no block padding. The tag's 8px Haze inset and 17px block padding made a count badge 55px tall. |
|
|
101
|
+
|
|
92
102
|
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.
|
|
93
103
|
|
|
94
104
|
### Interaction surface geometry
|
|
@@ -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
|
|
5
|
+
Crystal ships 59 executable component recipes in nine families — three of them continuous indicators of pending work — the six material signatures, Mirage withdrawal, a modal dismissal, and a measured-layout helper. 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
|
|
|
@@ -105,13 +105,11 @@ Base times below are at 1×; the preview resolves the saved speed at playback. E
|
|
|
105
105
|
| `reorder` | plastic / inertia | GSAP | 500ms | Supplement DOM reordering; use layout() for measured bounded displacement. |
|
|
106
106
|
| `highlight` | haze / feather | Motion | 500ms | A brief update cue paired with actual content or announcement. |
|
|
107
107
|
| `message-in` | haze / feather | Motion | 650ms | Only on a new message; do not replay on virtualized history or steal scroll. |
|
|
108
|
-
| `reaction` | resin / coalesce | Motion | 680ms | Toggle the real reaction state and count before the response. |
|
|
109
108
|
| `toast-in` | resin / coalesce | Motion | 650ms | Live status text with a persistent dismiss button. |
|
|
110
109
|
| `toast-out` | resin / meniscus | Motion | 440ms | No timer required; manual dismissal preserves reading time. |
|
|
111
110
|
| `success` | stone / feather | GSAP | 600ms | Use after a successful operation with text and a recognizable mark. |
|
|
112
111
|
| `attention` | stone / feather | Motion | 500ms | Single finite cue for important text; never flash or loop. |
|
|
113
112
|
| `progress-change` | stone / feather | Motion | 500ms | Actual progress is set first; this animation does not fabricate completion. |
|
|
114
|
-
| `busy` | stone / feather | GSAP | 680ms | One cycle for an actual pending operation; keep a static busy label if it lasts longer. |
|
|
115
113
|
| `skeleton-resolve` | haze / feather | Motion | 650ms | Replace a skeleton only when real data arrives; no endless shimmer. |
|
|
116
114
|
| `empty-in` | resin / coalesce | Motion | 500ms | Shown only when the collection is actually empty. |
|
|
117
115
|
| `media-in` | frost / refraction | Motion | 900ms | After an image decodes or media becomes ready; reserve layout space. |
|
package/docs/motion.md
CHANGED
|
@@ -230,7 +230,7 @@ including that reduced motion still applies the state instantly.
|
|
|
230
230
|
|
|
231
231
|
<!-- generated:recipes -->
|
|
232
232
|
|
|
233
|
-
All
|
|
233
|
+
All 59 recipes in 9 categories, generated from `core/tokens/motion-recipes.json`. **Damping ratio** and
|
|
234
234
|
**overshoot** are derived from each recipe's spring by `core/assets/core/spring.js`, not
|
|
235
235
|
authored — so a spring that was retuned cannot leave a stale number behind in this table.
|
|
236
236
|
|
|
@@ -298,7 +298,6 @@ correct is a material question, not a taste question — see the signature polic
|
|
|
298
298
|
| `reorder` — Reorder settle | 500ms | inertia | plastic | 0.550 | 12.6% | Supplement DOM reordering; use layout() for measured bounded displacement. | Apply the semantic state immediately; omit decorative movement. |
|
|
299
299
|
| `highlight` — Updated content | 500ms | feather | haze | 0.920 | none | A brief update cue paired with actual content or announcement. | Apply the semantic state immediately; omit decorative movement. |
|
|
300
300
|
| `message-in` — Message arrival | 650ms | feather | haze | 0.920 | none | Only on a new message; do not replay on virtualized history or steal scroll. | Apply the semantic state immediately; omit decorative movement. |
|
|
301
|
-
| `reaction` — Reaction response | 680ms | coalesce | resin | 0.620 | 8.4% | Toggle the real reaction state and count before the response. | Apply the semantic state immediately; omit decorative movement. |
|
|
302
301
|
| `skeleton-sweep` — Luminance sweep | 1200ms | feather | haze | linear loop | — | A skeleton while its content is genuinely loading, on the Haze fill and never on the text that replaces it. Ends with skeleton-resolve. | Static Haze fill. |
|
|
303
302
|
| `mark-in` — Mark arriving | 500ms | feather | haze | 1.000 | none | A data mark — a bar, a series, a segment — growing from its baseline when a chart first appears, and not when its data later changes. transform-origin is the baseline. Staggered by index up to 24 marks; past that every mark arrives together, because a sequence nobody can count is decoration. Staggered 24ms per mark, up to 24. | Marks appear in place at their values. |
|
|
304
303
|
|
|
@@ -311,7 +310,6 @@ correct is a material question, not a taste question — see the signature polic
|
|
|
311
310
|
| `success` — Success acknowledgement | 600ms | feather | stone | 0.920 | none | Use after a successful operation with text and a recognizable mark. | Apply the semantic state immediately; omit decorative movement. |
|
|
312
311
|
| `attention` — Attention cue | 500ms | feather | stone | 0.920 | none | Single finite cue for important text; never flash or loop. | Apply the semantic state immediately; omit decorative movement. |
|
|
313
312
|
| `progress-change` — Progress settle | 500ms | feather | stone | 0.920 | none | Actual progress is set first; this animation does not fabricate completion. | Apply the semantic state immediately; omit decorative movement. |
|
|
314
|
-
| `busy` — Finite busy cue | 680ms | feather | stone | 0.920 | none | One cycle for an actual pending operation; keep a static busy label if it lasts longer. | Apply the semantic state immediately; omit decorative movement. |
|
|
315
313
|
| `skeleton-resolve` — Loading content resolve | 650ms | feather | haze | 0.920 | none | Replace a skeleton only when real data arrives; no endless shimmer. | Apply the semantic state immediately; omit decorative movement. |
|
|
316
314
|
| `empty-in` — Empty-state reveal | 500ms | coalesce | resin | 0.620 | 8.4% | Shown only when the collection is actually empty. | Apply the semantic state immediately; omit decorative movement. |
|
|
317
315
|
| `activity-turn` — Indeterminate arc | 1200ms | feather | stone | linear loop | — | A loader, or an indeterminate progress ring, while an operation is genuinely pending — and only then. Starts when the work starts and stops when it resolves. One period for every continuous indicator, so two in one view never tick against each other. | Static: the whole track visible and nothing turning. Never a partial arc, which reports a measurement nobody took. |
|
package/docs/tokens.md
CHANGED
|
@@ -433,7 +433,7 @@ What a value *means*: the surface a card sits on, the duration a control settles
|
|
|
433
433
|
|
|
434
434
|
Values that belong to one component family and would be wrong to reuse elsewhere. This tier exists so a component can be specific without inventing a private constant.
|
|
435
435
|
|
|
436
|
-
|
|
436
|
+
59 tokens.
|
|
437
437
|
|
|
438
438
|
### Component · action
|
|
439
439
|
|
|
@@ -519,6 +519,7 @@ Values that belong to one component family and would be wrong to reuse elsewhere
|
|
|
519
519
|
| --- | --- | --- | --- |
|
|
520
520
|
| `component.overlay.maxWidth` | dimension | `480px` | How wide an anchored popover may grow before it stops being anchored to anything |
|
|
521
521
|
| `component.overlay.tooltipMaxWidth` | dimension | `352px` | About sixty characters: a tooltip longer than this is documentation |
|
|
522
|
+
| `component.overlay.tooltipRadius` | dimension | `18px` | A tooltip's corner radius. Smaller than the content radius the other overlays share, because a tooltip is a compact panel of one or two lines. |
|
|
522
523
|
|
|
523
524
|
### Component · field
|
|
524
525
|
|
|
@@ -146,6 +146,7 @@ object CrystalToken {
|
|
|
146
146
|
const val overlayArrowRadius = "3px"
|
|
147
147
|
const val overlayMaxWidth = "480px"
|
|
148
148
|
const val overlayTooltipMaxWidth = "352px"
|
|
149
|
+
const val overlayTooltipRadius = "18px"
|
|
149
150
|
const val fieldWellInset = "7px"
|
|
150
151
|
const val cardRadius = "28px"
|
|
151
152
|
const val focusCoreWidth = "2px"
|
|
@@ -146,6 +146,7 @@ public enum CrystalToken {
|
|
|
146
146
|
public static let overlayArrowRadius = "3px"
|
|
147
147
|
public static let overlayMaxWidth = "480px"
|
|
148
148
|
public static let overlayTooltipMaxWidth = "352px"
|
|
149
|
+
public static let overlayTooltipRadius = "18px"
|
|
149
150
|
public static let fieldWellInset = "7px"
|
|
150
151
|
public static let cardRadius = "28px"
|
|
151
152
|
public static let focusCoreWidth = "2px"
|
|
@@ -146,6 +146,7 @@ export const crystalTokens = {
|
|
|
146
146
|
"overlayArrow.radius": "3px",
|
|
147
147
|
"overlay.maxWidth": "480px",
|
|
148
148
|
"overlay.tooltipMaxWidth": "352px",
|
|
149
|
+
"overlay.tooltipRadius": "18px",
|
|
149
150
|
"field.wellInset": "7px",
|
|
150
151
|
"card.radius": "28px",
|
|
151
152
|
"focus.coreWidth": "2px",
|
package/package.json
CHANGED
|
@@ -48,8 +48,7 @@
|
|
|
48
48
|
"crystal": "Material, pill geometry, current-location dot, focus ring",
|
|
49
49
|
"product": "Routing and which destination is current",
|
|
50
50
|
"motion": [
|
|
51
|
-
"
|
|
52
|
-
"page-out"
|
|
51
|
+
"selection"
|
|
53
52
|
],
|
|
54
53
|
"parity": [
|
|
55
54
|
"mantine:NavLink",
|
|
@@ -66,7 +65,7 @@
|
|
|
66
65
|
"collapsed",
|
|
67
66
|
"narrow"
|
|
68
67
|
],
|
|
69
|
-
"material": "Frost panel,
|
|
68
|
+
"material": "Frost panel; its destinations are navigation entries, the current one at weight 800 on the surface-alt fill with the location dot",
|
|
70
69
|
"surface": [
|
|
71
70
|
"frost",
|
|
72
71
|
"nav-item"
|
|
@@ -76,8 +75,7 @@
|
|
|
76
75
|
"crystal": "Panel material, collapse geometry, active treatment",
|
|
77
76
|
"product": "Destination list, routing, collapse persistence",
|
|
78
77
|
"motion": [
|
|
79
|
-
"selection"
|
|
80
|
-
"page-in"
|
|
78
|
+
"selection"
|
|
81
79
|
],
|
|
82
80
|
"parity": [
|
|
83
81
|
"mantine:NavLink",
|
|
@@ -104,8 +102,7 @@
|
|
|
104
102
|
"crystal": "The single shared plane, label weight for the current entry, elevation",
|
|
105
103
|
"product": "Destinations and routing",
|
|
106
104
|
"motion": [
|
|
107
|
-
"selection"
|
|
108
|
-
"page-in"
|
|
105
|
+
"selection"
|
|
109
106
|
],
|
|
110
107
|
"parity": [
|
|
111
108
|
"mui:BottomNavigation",
|
|
@@ -153,7 +150,7 @@
|
|
|
153
150
|
],
|
|
154
151
|
"material": "Resin strip, primary fill on the selected tab",
|
|
155
152
|
"surface": [
|
|
156
|
-
"
|
|
153
|
+
"dock"
|
|
157
154
|
],
|
|
158
155
|
"geometry": "Pill tabs inside a pill strip; 44px minimum",
|
|
159
156
|
"semantics": "role=tablist/tab/tabpanel with arrow-key, Home and End navigation and aria-selected",
|
|
@@ -217,8 +214,7 @@
|
|
|
217
214
|
"crystal": "Marker geometry, connector, state treatment",
|
|
218
215
|
"product": "Step validation and whether steps are navigable",
|
|
219
216
|
"motion": [
|
|
220
|
-
"selection"
|
|
221
|
-
"page-in"
|
|
217
|
+
"selection"
|
|
222
218
|
],
|
|
223
219
|
"parity": [
|
|
224
220
|
"mantine:Stepper",
|
|
@@ -356,8 +352,7 @@
|
|
|
356
352
|
"crystal": "Material, geometry, selection by label weight, safe-area inset",
|
|
357
353
|
"product": "Destinations and routing",
|
|
358
354
|
"motion": [
|
|
359
|
-
"selection"
|
|
360
|
-
"page-in"
|
|
355
|
+
"selection"
|
|
361
356
|
],
|
|
362
357
|
"parity": [
|
|
363
358
|
"mui:BottomNavigation"
|
|
@@ -75,7 +75,7 @@
|
|
|
75
75
|
],
|
|
76
76
|
"material": "One shared Resin plane, not one plane per button",
|
|
77
77
|
"surface": [
|
|
78
|
-
"
|
|
78
|
+
"group"
|
|
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",
|
|
@@ -103,7 +103,7 @@
|
|
|
103
103
|
],
|
|
104
104
|
"material": "Shared Resin plane with a hairline between the two targets",
|
|
105
105
|
"surface": [
|
|
106
|
-
"
|
|
106
|
+
"group"
|
|
107
107
|
],
|
|
108
108
|
"geometry": "Pill outer geometry; both halves meet the 44px floor independently",
|
|
109
109
|
"semantics": "Two buttons; the disclosure carries aria-expanded and aria-haspopup=\"menu\"",
|
|
@@ -139,8 +139,7 @@
|
|
|
139
139
|
"crystal": "Material, elevation, extend behaviour, safe-area offset",
|
|
140
140
|
"product": "The action and when it is present",
|
|
141
141
|
"motion": [
|
|
142
|
-
"press"
|
|
143
|
-
"resin-confluence"
|
|
142
|
+
"press"
|
|
144
143
|
],
|
|
145
144
|
"parity": [
|
|
146
145
|
"mui:Fab",
|
|
@@ -215,7 +214,7 @@
|
|
|
215
214
|
],
|
|
216
215
|
"material": "Resin plane",
|
|
217
216
|
"surface": [
|
|
218
|
-
"
|
|
217
|
+
"dock"
|
|
219
218
|
],
|
|
220
219
|
"geometry": "Pill; floats above content with the floating elevation.",
|
|
221
220
|
"semantics": "role=\"toolbar\"; announces how many items are selected.",
|