@crystal-ui/core 2.3.1 → 2.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +82 -23
- package/assets/core/preferences.d.ts +4 -4
- package/assets/core/preferences.js +4 -4
- package/assets/core/presets.d.ts +4 -3
- package/assets/core/presets.js +24 -18
- package/assets/core/spring.js +9 -10
- package/assets/core/state.js +7 -7
- package/assets/crystal.css +783 -288
- package/assets/crystal.d.ts +3 -3
- package/assets/crystal.js +100 -123
- package/assets/icons/heading-2.svg +1 -0
- package/assets/icons/heading-3.svg +1 -0
- package/assets/icons/heading-4.svg +1 -0
- package/assets/icons/link.svg +1 -0
- package/assets/icons/list-ordered.svg +1 -0
- package/assets/icons/list.svg +1 -0
- package/assets/icons/manifest.json +81 -2
- package/assets/icons/quote.svg +1 -0
- package/assets/icons/redo.svg +1 -0
- package/assets/icons/subscript.svg +1 -0
- package/assets/icons/undo.svg +1 -0
- package/assets/icons/unlink.svg +1 -0
- package/assets/motion.js +13 -12
- package/docs/accessibility.md +50 -54
- package/docs/adoption.md +33 -19
- package/docs/catalogue.md +113 -108
- package/docs/colors.md +67 -73
- package/docs/components.md +142 -66
- package/docs/icons.md +9 -3
- package/docs/materials.md +129 -117
- package/docs/motion-components.md +15 -15
- package/docs/motion.md +156 -158
- package/docs/principles.md +12 -12
- package/docs/tokens.md +129 -130
- package/engines.js +3 -3
- package/package.json +11 -3
- package/tokens/catalogue/01-layout.json +1 -1
- package/tokens/catalogue/02-navigation.json +4 -4
- package/tokens/catalogue/03-actions.json +2 -1
- package/tokens/catalogue/04-inputs.json +30 -22
- package/tokens/catalogue/05-data-display.json +9 -14
- package/tokens/catalogue/06-feedback.json +8 -6
- package/tokens/catalogue/07-overlays.json +4 -4
- package/tokens/catalogue/08-typography.json +12 -8
- package/tokens/catalogue/09-utility.json +1 -1
- package/tokens/catalogue/10-charts.json +7 -7
- package/tokens/catalogue/11-media.json +33 -20
- package/tokens/catalogue/12-commerce.json +4 -4
- package/tokens/catalogue/13-screens.json +2 -3
- package/tokens/catalogue/14-blocks.json +3 -3
- package/tokens/catalogue.json +176 -116
- package/tokens/crystal.tokens.json +6 -6
- package/tokens/motion-recipes.json +6 -6
- package/tokens/surface-recipes.json +3452 -0
- package/tokens/surfaces.json +48 -17
package/tokens/catalogue.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$description": "Crystal component catalogue, combined. Generated from core/tokens/catalogue/.",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.4.0",
|
|
4
4
|
"surfaces": [
|
|
5
5
|
{
|
|
6
6
|
"id": "plastic",
|
|
@@ -18,7 +18,10 @@
|
|
|
18
18
|
"Frost"
|
|
19
19
|
],
|
|
20
20
|
"class": ".cr-frost",
|
|
21
|
-
"use": "Intermediate task frames and every transient surface that opens over content: side panels, drawers, sheets
|
|
21
|
+
"use": "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.",
|
|
22
|
+
"also": [
|
|
23
|
+
".cr-frost.bar"
|
|
24
|
+
]
|
|
22
25
|
},
|
|
23
26
|
{
|
|
24
27
|
"id": "haze",
|
|
@@ -39,7 +42,10 @@
|
|
|
39
42
|
"Resin"
|
|
40
43
|
],
|
|
41
44
|
"class": ".cr-resin",
|
|
42
|
-
"use": "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
|
|
45
|
+
"use": "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.",
|
|
46
|
+
"also": [
|
|
47
|
+
".cr-resin.transport"
|
|
48
|
+
]
|
|
43
49
|
},
|
|
44
50
|
{
|
|
45
51
|
"id": "resin-panel",
|
|
@@ -63,7 +69,12 @@
|
|
|
63
69
|
"button",
|
|
64
70
|
"a.cr-button"
|
|
65
71
|
],
|
|
66
|
-
"use": "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."
|
|
72
|
+
"use": "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.",
|
|
73
|
+
"partial": {
|
|
74
|
+
".cr-button": "Element-keyed: `.cr-button` coats a `button` or an `a`. On any other element, wear `.cr-control`, which coats any element.",
|
|
75
|
+
".cr-control": "Takes the radius of what it is: the pill comes with `.cr-button`, and a card-shaped control keeps the content radius of the surface it also wears.",
|
|
76
|
+
"button": "Takes the radius of what it is: the pill comes with `.cr-button`, and a card-shaped button keeps the content radius of the surface it also wears."
|
|
77
|
+
}
|
|
67
78
|
},
|
|
68
79
|
{
|
|
69
80
|
"id": "field",
|
|
@@ -73,7 +84,13 @@
|
|
|
73
84
|
"Haze"
|
|
74
85
|
],
|
|
75
86
|
"class": ".cr-field-shell",
|
|
76
|
-
"use": "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."
|
|
87
|
+
"use": "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.",
|
|
88
|
+
"also": [
|
|
89
|
+
".cr-editor"
|
|
90
|
+
],
|
|
91
|
+
"partial": {
|
|
92
|
+
".cr-editor": "A part: the document inside the field shell, which carries the Resin surround and the Haze well."
|
|
93
|
+
}
|
|
77
94
|
},
|
|
78
95
|
{
|
|
79
96
|
"id": "compact",
|
|
@@ -87,7 +104,10 @@
|
|
|
87
104
|
".cr-tag",
|
|
88
105
|
".cr-resin-haze.count"
|
|
89
106
|
],
|
|
90
|
-
"use": "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
|
|
107
|
+
"use": "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.",
|
|
108
|
+
"partial": {
|
|
109
|
+
".cr-tag": "The tag's geometry (the pill, the 48px floor, the type size), worn with `.cr-resin-haze`, which carries the coat."
|
|
110
|
+
}
|
|
91
111
|
},
|
|
92
112
|
{
|
|
93
113
|
"id": "stone",
|
|
@@ -96,7 +116,14 @@
|
|
|
96
116
|
"Stone"
|
|
97
117
|
],
|
|
98
118
|
"class": ".cr-stone",
|
|
99
|
-
"use": "A label over an unknown or moving backdrop
|
|
119
|
+
"use": "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.",
|
|
120
|
+
"also": [
|
|
121
|
+
".cr-media-caption"
|
|
122
|
+
],
|
|
123
|
+
"partial": {
|
|
124
|
+
".cr-stone": "Stone backs a label and takes the radius of the element it backs.",
|
|
125
|
+
".cr-media-caption": "A part: the outer element positions the cue, and its inner box (`.cr-media-caption > *`) carries the Stone backing and the radius."
|
|
126
|
+
}
|
|
100
127
|
},
|
|
101
128
|
{
|
|
102
129
|
"id": "mirage",
|
|
@@ -121,7 +148,10 @@
|
|
|
121
148
|
"use": "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.",
|
|
122
149
|
"also": [
|
|
123
150
|
".cr-dialog-body"
|
|
124
|
-
]
|
|
151
|
+
],
|
|
152
|
+
"partial": {
|
|
153
|
+
".cr-dialog-body": "A part: the scrolling body inside the dialog's Haze surface, which carries the material; the body adds the scroll contract."
|
|
154
|
+
}
|
|
125
155
|
},
|
|
126
156
|
{
|
|
127
157
|
"id": "indicator",
|
|
@@ -162,20 +192,27 @@
|
|
|
162
192
|
"also": [
|
|
163
193
|
".cr-table"
|
|
164
194
|
],
|
|
165
|
-
"use": "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."
|
|
195
|
+
"use": "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.",
|
|
196
|
+
"partial": {
|
|
197
|
+
".cr-table": "A part: the table inside `.cr-table-scroll`, which carries the Resin shell and the Haze fill; the table is transparent on it."
|
|
198
|
+
}
|
|
166
199
|
},
|
|
167
200
|
{
|
|
168
201
|
"id": "dock",
|
|
169
202
|
"name": "Dock",
|
|
170
203
|
"materials": [
|
|
171
204
|
"Resin",
|
|
172
|
-
"Haze"
|
|
205
|
+
"Haze",
|
|
206
|
+
"Stone"
|
|
173
207
|
],
|
|
174
208
|
"class": ".cr-dock",
|
|
175
209
|
"also": [
|
|
176
210
|
".cr-dock-inner"
|
|
177
211
|
],
|
|
178
|
-
"use": "A Resin plane holding labelled controls on one
|
|
212
|
+
"use": "A Resin plane with a Haze perimeter, holding labelled controls on one Stone label backing (`.cr-dock-inner`), so every label reads on the same protected ground: a dock of destinations, and the strips that group controls the same way (tab strips, segmented controls, toolbars, command and action bars). The controls inside are transparent; the current or selected one takes weight 800 and the primary fill, whether it is a dock's destination, a tab or a segment. The controls may be buttons, tabs (`[role=tab]`, selected by `aria-selected`), radio labels (selected by `:checked`) or links (current by `aria-current`); only buttons were reached before 2.3.0.",
|
|
213
|
+
"partial": {
|
|
214
|
+
".cr-dock-inner": "The Stone label backing inside the dock. The dock carries the Resin blur, and Resin never contains Resin, so the inner fill has none."
|
|
215
|
+
}
|
|
179
216
|
},
|
|
180
217
|
{
|
|
181
218
|
"id": "group",
|
|
@@ -193,18 +230,16 @@
|
|
|
193
230
|
{
|
|
194
231
|
"id": "nav-item",
|
|
195
232
|
"name": "Navigation entry",
|
|
196
|
-
"materials": [
|
|
197
|
-
"Plastic"
|
|
198
|
-
],
|
|
233
|
+
"materials": [],
|
|
199
234
|
"class": ".cr-nav-item",
|
|
200
|
-
"use": "An entry in side navigation, a rail or a tree of destinations. It has no material of its own
|
|
235
|
+
"use": "An entry in side navigation, a rail or a tree of destinations. It has no material of its own, sits on the panel beneath it, and carries selection by label weight alone. Pill hit area, 44px target. `.stacked` puts the icon above the label for a rail. Adopted from the documentation site's side menu, which docs/components.md names as the reference implementation of selection."
|
|
201
236
|
},
|
|
202
237
|
{
|
|
203
238
|
"id": "bare",
|
|
204
239
|
"name": "Bare control",
|
|
205
240
|
"materials": [],
|
|
206
241
|
"class": ".cr-bare",
|
|
207
|
-
"use": "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
|
|
242
|
+
"use": "A control that must not wear the Resin coat because it sits inside a surface that already has one: a disclosure chevron, a chip's remove button, a sort header, a stepper's arrows, a dismiss button on a toast. Crystal paints every button by element, so this class subtracts the fill, the shadow, the backdrop filter and both pseudo-layers. The focus ring and the target floor stay."
|
|
208
243
|
},
|
|
209
244
|
{
|
|
210
245
|
"id": "drag-handle",
|
|
@@ -224,7 +259,10 @@
|
|
|
224
259
|
"input[type=checkbox][role=switch]",
|
|
225
260
|
"input[type=range]"
|
|
226
261
|
],
|
|
227
|
-
"use": "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."
|
|
262
|
+
"use": "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.",
|
|
263
|
+
"partial": {
|
|
264
|
+
"input[type=range]": "A track and a thumb, painted on the slider's pseudo-elements (`::-webkit-slider-runnable-track`, `::-webkit-slider-thumb` and their `::-moz-range-` forms), which this record does not read."
|
|
265
|
+
}
|
|
228
266
|
},
|
|
229
267
|
{
|
|
230
268
|
"id": "native",
|
|
@@ -241,7 +279,7 @@
|
|
|
241
279
|
"name": "No surface of its own",
|
|
242
280
|
"materials": [],
|
|
243
281
|
"class": null,
|
|
244
|
-
"use": "Layout, typography, behaviour and drawing components that inherit whatever they sit on. A chart's marks, a divider, a provider.
|
|
282
|
+
"use": "Layout, typography, behaviour and drawing components that inherit whatever they sit on. A chart's marks, a divider, a provider."
|
|
245
283
|
}
|
|
246
284
|
],
|
|
247
285
|
"categories": [
|
|
@@ -499,7 +537,7 @@
|
|
|
499
537
|
"scrolled",
|
|
500
538
|
"condensed"
|
|
501
539
|
],
|
|
502
|
-
"material": "Frost band over the
|
|
540
|
+
"material": "Frost band over the view's foundation",
|
|
503
541
|
"surface": [
|
|
504
542
|
"frost"
|
|
505
543
|
],
|
|
@@ -857,12 +895,11 @@
|
|
|
857
895
|
"haze"
|
|
858
896
|
],
|
|
859
897
|
"geometry": "Indent step 20px; guides use the edge token",
|
|
860
|
-
"semantics": "role=treegrid/row/gridcell with aria-expanded, aria-level, aria-posinset, aria-setsize and full arrow-key navigation. Not role=tree: a treeitem is a single navigable unit, so it cannot contain the expand control this anatomy requires
|
|
898
|
+
"semantics": "role=treegrid/row/gridcell with aria-expanded, aria-level, aria-posinset, aria-setsize and full arrow-key navigation. Not role=tree: a treeitem is a single navigable unit, so it cannot contain the expand control this anatomy requires, and treegrid is the pattern ARIA provides for a row that holds its own control. See M-3.",
|
|
861
899
|
"crystal": "Row treatment, indentation guides, label weight for the selected row",
|
|
862
900
|
"product": "The keyboard navigation implementation, data and lazy loading",
|
|
863
901
|
"motion": [
|
|
864
|
-
"accordion-in"
|
|
865
|
-
"accordion-out"
|
|
902
|
+
"accordion-in"
|
|
866
903
|
],
|
|
867
904
|
"parity": [
|
|
868
905
|
"mantine:Tree",
|
|
@@ -994,7 +1031,8 @@
|
|
|
994
1031
|
"react-aria:Menu",
|
|
995
1032
|
"primereact:menubar",
|
|
996
1033
|
"antd:Menu"
|
|
997
|
-
]
|
|
1034
|
+
],
|
|
1035
|
+
"note": "Each menu the bar opens is the product's child, a menu entry of its own. The bar owns the triggers and their roving focus; menu-in and menu-out are played by the menu the product renders, not by the bar."
|
|
998
1036
|
},
|
|
999
1037
|
{
|
|
1000
1038
|
"id": "submenu",
|
|
@@ -1143,7 +1181,8 @@
|
|
|
1143
1181
|
"antd:Dropdown.Button",
|
|
1144
1182
|
"mui:ButtonGroup",
|
|
1145
1183
|
"mantine:Menu"
|
|
1146
|
-
]
|
|
1184
|
+
],
|
|
1185
|
+
"note": "The menu the disclosure opens is the product's child, a menu entry of its own. The split button owns the two segments and the disclosure; menu-in and menu-out are played by the menu the product renders, not by the button."
|
|
1147
1186
|
},
|
|
1148
1187
|
{
|
|
1149
1188
|
"id": "floating-action",
|
|
@@ -1490,7 +1529,7 @@
|
|
|
1490
1529
|
"invalid",
|
|
1491
1530
|
"disabled"
|
|
1492
1531
|
],
|
|
1493
|
-
"material": "Resin field shell,
|
|
1532
|
+
"material": "Resin field shell, Frost popover with Haze rows (R15e)",
|
|
1494
1533
|
"surface": [
|
|
1495
1534
|
"field",
|
|
1496
1535
|
"frost"
|
|
@@ -1501,8 +1540,7 @@
|
|
|
1501
1540
|
"product": "The accessible combobox implementation, filtering and async loading",
|
|
1502
1541
|
"motion": [
|
|
1503
1542
|
"popover-in",
|
|
1504
|
-
"popover-out"
|
|
1505
|
-
"list-in"
|
|
1543
|
+
"popover-out"
|
|
1506
1544
|
],
|
|
1507
1545
|
"parity": [
|
|
1508
1546
|
"mantine:Autocomplete",
|
|
@@ -1577,7 +1615,7 @@
|
|
|
1577
1615
|
"mui:Checkbox",
|
|
1578
1616
|
"antd:Checkbox"
|
|
1579
1617
|
],
|
|
1580
|
-
"note": "The checked mark is a check glyph. That is the control's own semantics
|
|
1618
|
+
"note": "The checked mark is a check glyph. That is the control's own semantics (a validated, entered value), not a selection badge placed over a focused item."
|
|
1581
1619
|
},
|
|
1582
1620
|
{
|
|
1583
1621
|
"id": "checkbox-group",
|
|
@@ -1698,7 +1736,7 @@
|
|
|
1698
1736
|
"surface": [
|
|
1699
1737
|
"choice"
|
|
1700
1738
|
],
|
|
1701
|
-
"geometry": "8px track, 26px thumb; the thumb is the target and meets 44px
|
|
1739
|
+
"geometry": "8px track, 26px thumb; the thumb is the target and meets 44px through padding",
|
|
1702
1740
|
"semantics": "Native range or role=slider with aria-valuenow, valuemin, valuemax and valuetext",
|
|
1703
1741
|
"crystal": "Track fill, thumb material, tick treatment, RTL mirroring",
|
|
1704
1742
|
"product": "Step, bounds and what the value drives",
|
|
@@ -2085,7 +2123,7 @@
|
|
|
2085
2123
|
"mui:—",
|
|
2086
2124
|
"antd:Upload"
|
|
2087
2125
|
],
|
|
2088
|
-
"note": "Crystal supplies appearance only. A file input that does not
|
|
2126
|
+
"note": "Crystal supplies appearance only. A file input that does not upload must not be presented as working."
|
|
2089
2127
|
},
|
|
2090
2128
|
{
|
|
2091
2129
|
"id": "dropzone",
|
|
@@ -2184,8 +2222,7 @@
|
|
|
2184
2222
|
"crystal": "Panel and action treatment, label weight for selection in the lists",
|
|
2185
2223
|
"product": "The data, move rules and filtering",
|
|
2186
2224
|
"motion": [
|
|
2187
|
-
"list-in"
|
|
2188
|
-
"list-out"
|
|
2225
|
+
"list-in"
|
|
2189
2226
|
],
|
|
2190
2227
|
"parity": [
|
|
2191
2228
|
"antd:Transfer",
|
|
@@ -2205,7 +2242,7 @@
|
|
|
2205
2242
|
"loading",
|
|
2206
2243
|
"disabled"
|
|
2207
2244
|
],
|
|
2208
|
-
"material": "
|
|
2245
|
+
"material": "Frost popover with Haze columns (R15e), from a Resin field shell",
|
|
2209
2246
|
"surface": [
|
|
2210
2247
|
"field",
|
|
2211
2248
|
"frost",
|
|
@@ -2239,7 +2276,7 @@
|
|
|
2239
2276
|
"empty",
|
|
2240
2277
|
"disabled"
|
|
2241
2278
|
],
|
|
2242
|
-
"material": "
|
|
2279
|
+
"material": "Frost popover with Haze rows over the field (R15e)",
|
|
2243
2280
|
"surface": [
|
|
2244
2281
|
"frost",
|
|
2245
2282
|
"haze"
|
|
@@ -2261,28 +2298,38 @@
|
|
|
2261
2298
|
{
|
|
2262
2299
|
"id": "rich-text-surface",
|
|
2263
2300
|
"name": "Rich text surface",
|
|
2264
|
-
"anatomy": "A toolbar of
|
|
2301
|
+
"anatomy": "A formatting toolbar and an editable surface. The toolbar holds Crystal's format vocabulary in groups: the block type (paragraph, headings two to four, bulleted list, numbered list, checklist, quotation, code block), the marks (bold, italic, underline, strikethrough, inline code, highlight, link, subscript, superscript) and history (undo, redo). A selection toolbar of the commonest marks floats over highlighted text.",
|
|
2265
2302
|
"states": [
|
|
2266
2303
|
"idle",
|
|
2267
2304
|
"focus",
|
|
2268
2305
|
"selection-active",
|
|
2306
|
+
"selection-toolbar-open",
|
|
2307
|
+
"touch-keyboard-open",
|
|
2269
2308
|
"disabled",
|
|
2270
2309
|
"read-only"
|
|
2271
2310
|
],
|
|
2272
|
-
"material": "Resin toolbar, Haze editing surface",
|
|
2311
|
+
"material": "Resin toolbar, Haze editing surface; Frost selection toolbar",
|
|
2273
2312
|
"surface": [
|
|
2274
|
-
"field"
|
|
2313
|
+
"field",
|
|
2314
|
+
"frost"
|
|
2275
2315
|
],
|
|
2276
|
-
"geometry": "Toolbar
|
|
2277
|
-
"semantics": "Toolbar actions use aria-pressed for active formatting
|
|
2278
|
-
"crystal": "Toolbar and surface appearance, active-format treatment",
|
|
2279
|
-
"product": "The
|
|
2316
|
+
"geometry": "Toolbar controls are 48px pills in separated groups on the field shell's Haze well; the surface keeps the content radius and the card padding (20px). On a fine pointer the toolbar sits above the text; on a coarse pointer it sits below the text and sticks above the on-screen keyboard.",
|
|
2317
|
+
"semantics": "Toolbar actions use aria-pressed for active formatting, and the block type is a single control naming the current type. A format changed by a keyboard shortcut while focus is in the text is announced politely. The editor exposes its own semantics: real headings, lists and checkboxes in the document, so a screen reader navigates it as it would the published page.",
|
|
2318
|
+
"crystal": "Toolbar and surface appearance, active-format treatment, the format vocabulary and its rendering (shared with prose), the selection toolbar, toolbar placement on touch",
|
|
2319
|
+
"product": "The editing engine, serialisation and paste handling, and which parts of the format vocabulary a product offers",
|
|
2280
2320
|
"parity": [
|
|
2281
2321
|
"mantine:RichTextEditor",
|
|
2282
2322
|
"mui:—",
|
|
2283
2323
|
"antd:—"
|
|
2284
2324
|
],
|
|
2285
|
-
"note": "Crystal specifies the surface
|
|
2325
|
+
"note": "Crystal specifies the surface and the format vocabulary. Do not rebuild a rich-text engine to obtain this appearance; bind an existing one. A library may ship an optional binding of an engine from its own entry point, with the engine an optional peer dependency, so a product that never imports the binding never installs or bundles the engine. The format vocabulary is the contract a binding implements: every block type and mark it offers renders as the surface and prose render it (D-30).",
|
|
2326
|
+
"motion": [
|
|
2327
|
+
"field-focus",
|
|
2328
|
+
"field-invalid",
|
|
2329
|
+
"field-valid",
|
|
2330
|
+
"menu-in",
|
|
2331
|
+
"menu-out"
|
|
2332
|
+
]
|
|
2286
2333
|
},
|
|
2287
2334
|
{
|
|
2288
2335
|
"id": "helper-text",
|
|
@@ -2501,7 +2548,7 @@
|
|
|
2501
2548
|
],
|
|
2502
2549
|
"material": "Resin track with a Resin thumb",
|
|
2503
2550
|
"surface": [
|
|
2504
|
-
"
|
|
2551
|
+
"resin"
|
|
2505
2552
|
],
|
|
2506
2553
|
"geometry": "Circular; the thumb reaches 44px including its hit area.",
|
|
2507
2554
|
"semantics": "role=\"slider\" with aria-valuenow in degrees and a text equivalent.",
|
|
@@ -2524,9 +2571,9 @@
|
|
|
2524
2571
|
"focus-visible",
|
|
2525
2572
|
"disabled"
|
|
2526
2573
|
],
|
|
2527
|
-
"material": "Resin body with a
|
|
2574
|
+
"material": "Resin body with a primary value arc",
|
|
2528
2575
|
"surface": [
|
|
2529
|
-
"
|
|
2576
|
+
"resin"
|
|
2530
2577
|
],
|
|
2531
2578
|
"geometry": "Circular; keyboard steps match the slider contract.",
|
|
2532
2579
|
"semantics": "role=\"slider\"; the value is readable as text, not only as an arc.",
|
|
@@ -2672,7 +2719,7 @@
|
|
|
2672
2719
|
"selected",
|
|
2673
2720
|
"focus-visible"
|
|
2674
2721
|
],
|
|
2675
|
-
"material": "
|
|
2722
|
+
"material": "A chequerboard beneath a transparent colour, so its alpha shows",
|
|
2676
2723
|
"surface": [
|
|
2677
2724
|
"none"
|
|
2678
2725
|
],
|
|
@@ -2826,7 +2873,7 @@
|
|
|
2826
2873
|
"haze"
|
|
2827
2874
|
],
|
|
2828
2875
|
"geometry": "Content radius; at least 12px between content and the feathered edge",
|
|
2829
|
-
"semantics": "An article when it is content
|
|
2876
|
+
"semantics": "An article when it is content or a button when the whole card acts, never both.",
|
|
2830
2877
|
"crystal": "Fill, feather, elevation, interactive treatment",
|
|
2831
2878
|
"product": "Content and what an interactive card does",
|
|
2832
2879
|
"motion": [
|
|
@@ -2893,7 +2940,6 @@
|
|
|
2893
2940
|
"product": "The data layer, virtualisation, and the sorting and filtering implementation",
|
|
2894
2941
|
"motion": [
|
|
2895
2942
|
"list-in",
|
|
2896
|
-
"list-out",
|
|
2897
2943
|
"highlight"
|
|
2898
2944
|
],
|
|
2899
2945
|
"parity": [
|
|
@@ -3058,12 +3104,12 @@
|
|
|
3058
3104
|
"mui:Chip",
|
|
3059
3105
|
"antd:Tag"
|
|
3060
3106
|
],
|
|
3061
|
-
"note": "Success uses a check mark. That is information display
|
|
3107
|
+
"note": "Success uses a check mark. That is information display, the legitimate use of the glyph."
|
|
3062
3108
|
},
|
|
3063
3109
|
{
|
|
3064
3110
|
"id": "indicator",
|
|
3065
3111
|
"name": "Indicator",
|
|
3066
|
-
"anatomy": "A small circular
|
|
3112
|
+
"anatomy": "A small circular Haze mark attached to a control, carrying state.",
|
|
3067
3113
|
"states": [
|
|
3068
3114
|
"selection",
|
|
3069
3115
|
"current",
|
|
@@ -3073,7 +3119,7 @@
|
|
|
3073
3119
|
"required",
|
|
3074
3120
|
"invalid"
|
|
3075
3121
|
],
|
|
3076
|
-
"material": "Haze: a 20px circle painting the Haze fill on an isolated layer with a 1px feather
|
|
3122
|
+
"material": "Haze: a 20px circle painting the Haze fill on an isolated layer with a 1px feather, and no coat of its own, because it sits on surfaces that are often already translucent",
|
|
3077
3123
|
"surface": [
|
|
3078
3124
|
"indicator"
|
|
3079
3125
|
],
|
|
@@ -3124,7 +3170,7 @@
|
|
|
3124
3170
|
"upcoming",
|
|
3125
3171
|
"error"
|
|
3126
3172
|
],
|
|
3127
|
-
"material": "
|
|
3173
|
+
"material": "Indicator markers on a Haze connector",
|
|
3128
3174
|
"surface": [
|
|
3129
3175
|
"indicator",
|
|
3130
3176
|
"haze"
|
|
@@ -3215,8 +3261,7 @@
|
|
|
3215
3261
|
"crystal": "Fade and control treatment",
|
|
3216
3262
|
"product": "Threshold and content",
|
|
3217
3263
|
"motion": [
|
|
3218
|
-
"accordion-in"
|
|
3219
|
-
"accordion-out"
|
|
3264
|
+
"accordion-in"
|
|
3220
3265
|
],
|
|
3221
3266
|
"parity": [
|
|
3222
3267
|
"mantine:Spoiler",
|
|
@@ -3348,7 +3393,7 @@
|
|
|
3348
3393
|
{
|
|
3349
3394
|
"id": "authored-bubble",
|
|
3350
3395
|
"name": "Authored bubble",
|
|
3351
|
-
"anatomy": "A reading surface with one
|
|
3396
|
+
"anatomy": "A reading surface with one tightened corner indicating authorship or direction.",
|
|
3352
3397
|
"states": [
|
|
3353
3398
|
"incoming",
|
|
3354
3399
|
"own",
|
|
@@ -3497,8 +3542,7 @@
|
|
|
3497
3542
|
"crystal": "Node material, connector colour, selection by weight",
|
|
3498
3543
|
"product": "Hierarchy data and layout direction",
|
|
3499
3544
|
"motion": [
|
|
3500
|
-
"accordion-in"
|
|
3501
|
-
"accordion-out"
|
|
3545
|
+
"accordion-in"
|
|
3502
3546
|
],
|
|
3503
3547
|
"parity": [
|
|
3504
3548
|
"primereact:organizationchart"
|
|
@@ -3611,8 +3655,7 @@
|
|
|
3611
3655
|
"crystal": "Row material, expansion motion, current marking by label weight",
|
|
3612
3656
|
"product": "The destination set and routing",
|
|
3613
3657
|
"motion": [
|
|
3614
|
-
"accordion-in"
|
|
3615
|
-
"accordion-out"
|
|
3658
|
+
"accordion-in"
|
|
3616
3659
|
],
|
|
3617
3660
|
"parity": [
|
|
3618
3661
|
"react-aria:NavigationTree"
|
|
@@ -3637,7 +3680,6 @@
|
|
|
3637
3680
|
"product": "Which columns resize, and persistence",
|
|
3638
3681
|
"motion": [
|
|
3639
3682
|
"list-in",
|
|
3640
|
-
"list-out",
|
|
3641
3683
|
"highlight",
|
|
3642
3684
|
"resize-settle"
|
|
3643
3685
|
],
|
|
@@ -3784,7 +3826,7 @@
|
|
|
3784
3826
|
{
|
|
3785
3827
|
"id": "toast",
|
|
3786
3828
|
"name": "Toast",
|
|
3787
|
-
"anatomy": "A transient floating
|
|
3829
|
+
"anatomy": "A transient floating Frost notification with a message and an optional single action.",
|
|
3788
3830
|
"states": [
|
|
3789
3831
|
"entering",
|
|
3790
3832
|
"visible",
|
|
@@ -3794,7 +3836,8 @@
|
|
|
3794
3836
|
],
|
|
3795
3837
|
"material": "Frost panel with Haze reading fill and the panel shadow (R15e); status accent from the semantic pair",
|
|
3796
3838
|
"surface": [
|
|
3797
|
-
"frost"
|
|
3839
|
+
"frost",
|
|
3840
|
+
"haze"
|
|
3798
3841
|
],
|
|
3799
3842
|
"geometry": "Content radius; stacked with a 12px offset",
|
|
3800
3843
|
"semantics": "Polite live region; an urgent toast is assertive. Auto-dismiss must never remove the only route to an action.",
|
|
@@ -3821,7 +3864,8 @@
|
|
|
3821
3864
|
],
|
|
3822
3865
|
"material": "Frost panel with Haze reading fill (R15e)",
|
|
3823
3866
|
"surface": [
|
|
3824
|
-
"frost"
|
|
3867
|
+
"frost",
|
|
3868
|
+
"haze"
|
|
3825
3869
|
],
|
|
3826
3870
|
"geometry": "Content radius",
|
|
3827
3871
|
"semantics": "Announced politely; the dismiss control is named for what it dismisses",
|
|
@@ -3944,7 +3988,7 @@
|
|
|
3944
3988
|
"mui:Skeleton",
|
|
3945
3989
|
"antd:Skeleton"
|
|
3946
3990
|
],
|
|
3947
|
-
"note": "A skeleton must match the real layout.
|
|
3991
|
+
"note": "A skeleton must match the real layout. One that resolves into a different shape is a worse experience than a spinner."
|
|
3948
3992
|
},
|
|
3949
3993
|
{
|
|
3950
3994
|
"id": "loading-overlay",
|
|
@@ -4087,7 +4131,7 @@
|
|
|
4087
4131
|
"determinate",
|
|
4088
4132
|
"indeterminate"
|
|
4089
4133
|
],
|
|
4090
|
-
"material": "
|
|
4134
|
+
"material": "A track in `--cr-haze-fill` with a primary arc",
|
|
4091
4135
|
"surface": [
|
|
4092
4136
|
"none"
|
|
4093
4137
|
],
|
|
@@ -4110,7 +4154,7 @@
|
|
|
4110
4154
|
"at-rest",
|
|
4111
4155
|
"focus-visible"
|
|
4112
4156
|
],
|
|
4113
|
-
"material": "
|
|
4157
|
+
"material": "A track in `--cr-haze-fill` with segment fills",
|
|
4114
4158
|
"surface": [
|
|
4115
4159
|
"none"
|
|
4116
4160
|
],
|
|
@@ -4199,7 +4243,7 @@
|
|
|
4199
4243
|
"open",
|
|
4200
4244
|
"dragging"
|
|
4201
4245
|
],
|
|
4202
|
-
"material": "Mirage scrim
|
|
4246
|
+
"material": "Mirage scrim and a Frost panel",
|
|
4203
4247
|
"surface": [
|
|
4204
4248
|
"frost",
|
|
4205
4249
|
"mirage"
|
|
@@ -4221,7 +4265,7 @@
|
|
|
4221
4265
|
{
|
|
4222
4266
|
"id": "menu",
|
|
4223
4267
|
"name": "Menu",
|
|
4224
|
-
"anatomy": "A
|
|
4268
|
+
"anatomy": "A Frost popover of actions, with optional groups, separators and checkable items.",
|
|
4225
4269
|
"states": [
|
|
4226
4270
|
"closed",
|
|
4227
4271
|
"open",
|
|
@@ -4276,7 +4320,7 @@
|
|
|
4276
4320
|
{
|
|
4277
4321
|
"id": "popover",
|
|
4278
4322
|
"name": "Popover",
|
|
4279
|
-
"anatomy": "An anchored
|
|
4323
|
+
"anatomy": "An anchored Frost surface holding arbitrary content, with optional arrow.",
|
|
4280
4324
|
"states": [
|
|
4281
4325
|
"closed",
|
|
4282
4326
|
"open",
|
|
@@ -4331,7 +4375,7 @@
|
|
|
4331
4375
|
{
|
|
4332
4376
|
"id": "tooltip",
|
|
4333
4377
|
"name": "Tooltip",
|
|
4334
|
-
"anatomy": "Short supplemental text on a small
|
|
4378
|
+
"anatomy": "Short supplemental text on a small Frost surface, anchored to its trigger.",
|
|
4335
4379
|
"states": [
|
|
4336
4380
|
"hidden",
|
|
4337
4381
|
"visible"
|
|
@@ -4478,12 +4522,14 @@
|
|
|
4478
4522
|
{
|
|
4479
4523
|
"id": "text",
|
|
4480
4524
|
"name": "Text",
|
|
4481
|
-
"anatomy": "Body copy with size, weight, colour role and truncation options.",
|
|
4525
|
+
"anatomy": "Body copy with size, weight, colour role, decoration (underline, strikethrough) and truncation options.",
|
|
4482
4526
|
"states": [
|
|
4483
4527
|
"default",
|
|
4484
4528
|
"muted",
|
|
4485
4529
|
"truncated",
|
|
4486
|
-
"clamped"
|
|
4530
|
+
"clamped",
|
|
4531
|
+
"underlined",
|
|
4532
|
+
"struck-through"
|
|
4487
4533
|
],
|
|
4488
4534
|
"material": "None",
|
|
4489
4535
|
"surface": [
|
|
@@ -4548,7 +4594,7 @@
|
|
|
4548
4594
|
{
|
|
4549
4595
|
"id": "prose",
|
|
4550
4596
|
"name": "Prose",
|
|
4551
|
-
"anatomy": "Long-form content with consistent rhythm across headings, lists, tables, code and media.",
|
|
4597
|
+
"anatomy": "Long-form content with consistent rhythm across headings, lists and checklists, quotations, tables, code and media, and the inline marks: links, emphasis, underline, strikethrough, insertions and deletions, highlights, inline code, keys, subscript and superscript.",
|
|
4552
4598
|
"states": [
|
|
4553
4599
|
"default"
|
|
4554
4600
|
],
|
|
@@ -4557,7 +4603,7 @@
|
|
|
4557
4603
|
"none"
|
|
4558
4604
|
],
|
|
4559
4605
|
"geometry": "78ch measure; 1.8 line height; 4px-rhythm vertical spacing",
|
|
4560
|
-
"semantics": "Anchor navigation must preserve focus when sections change",
|
|
4606
|
+
"semantics": "Anchor navigation must preserve focus when sections change. Every mark differs in shape as well as colour (an insertion is underlined, a deletion struck through, a highlight filled), and each is its own element (ins, del, mark, u, s), so none rests on colour alone.",
|
|
4561
4607
|
"crystal": "The complete reading rhythm and embedded-element treatment",
|
|
4562
4608
|
"product": "Content, rendering and virtualisation",
|
|
4563
4609
|
"parity": [
|
|
@@ -4639,7 +4685,7 @@
|
|
|
4639
4685
|
"none"
|
|
4640
4686
|
],
|
|
4641
4687
|
"geometry": "Step per level; leading tightens as size grows.",
|
|
4642
|
-
"semantics": "The level is the document structure, never chosen for size
|
|
4688
|
+
"semantics": "The level is the document structure, never chosen for size. Size comes from the step.",
|
|
4643
4689
|
"crystal": "The scale and its tracking",
|
|
4644
4690
|
"product": "Level and wording",
|
|
4645
4691
|
"parity": [
|
|
@@ -4669,16 +4715,18 @@
|
|
|
4669
4715
|
{
|
|
4670
4716
|
"id": "prose-list",
|
|
4671
4717
|
"name": "Prose list",
|
|
4672
|
-
"anatomy": "Ordered and unordered lists inside running text, with Crystal markers.",
|
|
4718
|
+
"anatomy": "Ordered and unordered lists inside running text, with Crystal markers, and checklists whose markers are checkboxes.",
|
|
4673
4719
|
"states": [
|
|
4674
|
-
"at-rest"
|
|
4720
|
+
"at-rest",
|
|
4721
|
+
"checked",
|
|
4722
|
+
"unchecked"
|
|
4675
4723
|
],
|
|
4676
4724
|
"material": "Inherits",
|
|
4677
4725
|
"surface": [
|
|
4678
4726
|
"none"
|
|
4679
4727
|
],
|
|
4680
4728
|
"geometry": "Marker inset follows the spacing scale; hanging indent preserved.",
|
|
4681
|
-
"semantics": "Real ul and ol so the count and nesting are announced.",
|
|
4729
|
+
"semantics": "Real ul and ol so the count and nesting are announced. A checklist item's marker is a native checkbox, read-only when the list is, so its state is announced; a finished item recedes to the muted ink and is not struck through.",
|
|
4682
4730
|
"crystal": "Marker treatment, spacing, nesting rhythm",
|
|
4683
4731
|
"product": "Content and ordering",
|
|
4684
4732
|
"parity": [
|
|
@@ -5213,7 +5261,7 @@
|
|
|
5213
5261
|
"drop-target",
|
|
5214
5262
|
"focus-visible"
|
|
5215
5263
|
],
|
|
5216
|
-
"material": "
|
|
5264
|
+
"material": "No material of its own: the opaque surface with the float shadow while lifted, and a drop indicator in `--cr-haze-fill`",
|
|
5217
5265
|
"surface": [
|
|
5218
5266
|
"drag-handle"
|
|
5219
5267
|
],
|
|
@@ -5357,7 +5405,7 @@
|
|
|
5357
5405
|
{
|
|
5358
5406
|
"id": "charts",
|
|
5359
5407
|
"name": "Charts",
|
|
5360
|
-
"description": "Data visualisation on one shared surface. Crystal named no charting component before 2.0 while every React benchmark shipped one
|
|
5408
|
+
"description": "Data visualisation on one shared surface. Crystal named no charting component before 2.0 while every React benchmark shipped one. These are specified against MUI X Charts, PrimeReact Chart and Mantine Charts. Every chart owes a text equivalent of its data, so the chart is never the only representation.",
|
|
5361
5409
|
"components": [
|
|
5362
5410
|
{
|
|
5363
5411
|
"id": "chart-surface",
|
|
@@ -5442,7 +5490,7 @@
|
|
|
5442
5490
|
"focus-visible",
|
|
5443
5491
|
"empty"
|
|
5444
5492
|
],
|
|
5445
|
-
"material": "
|
|
5493
|
+
"material": "The series colour at `--cr-chart-fill-opacity` beneath the line",
|
|
5446
5494
|
"surface": [
|
|
5447
5495
|
"none"
|
|
5448
5496
|
],
|
|
@@ -5489,7 +5537,7 @@
|
|
|
5489
5537
|
"focus-visible",
|
|
5490
5538
|
"empty"
|
|
5491
5539
|
],
|
|
5492
|
-
"material": "
|
|
5540
|
+
"material": "A centre fill in `--cr-haze-fill`",
|
|
5493
5541
|
"surface": [
|
|
5494
5542
|
"none"
|
|
5495
5543
|
],
|
|
@@ -5533,7 +5581,7 @@
|
|
|
5533
5581
|
"focus-visible",
|
|
5534
5582
|
"empty"
|
|
5535
5583
|
],
|
|
5536
|
-
"material": "
|
|
5584
|
+
"material": "The series colour at `--cr-chart-fill-opacity` inside each series polygon",
|
|
5537
5585
|
"surface": [
|
|
5538
5586
|
"none"
|
|
5539
5587
|
],
|
|
@@ -5575,7 +5623,7 @@
|
|
|
5575
5623
|
"determinate",
|
|
5576
5624
|
"empty"
|
|
5577
5625
|
],
|
|
5578
|
-
"material": "
|
|
5626
|
+
"material": "A track in `--cr-haze-fill` with a primary arc",
|
|
5579
5627
|
"surface": [
|
|
5580
5628
|
"none"
|
|
5581
5629
|
],
|
|
@@ -5798,7 +5846,7 @@
|
|
|
5798
5846
|
"focus-visible",
|
|
5799
5847
|
"empty"
|
|
5800
5848
|
],
|
|
5801
|
-
"material": "
|
|
5849
|
+
"material": "Range bands in `--cr-haze-fill`",
|
|
5802
5850
|
"surface": [
|
|
5803
5851
|
"none"
|
|
5804
5852
|
],
|
|
@@ -5886,7 +5934,7 @@
|
|
|
5886
5934
|
"focus-visible",
|
|
5887
5935
|
"empty"
|
|
5888
5936
|
],
|
|
5889
|
-
"material": "
|
|
5937
|
+
"material": "Node fills in `--cr-haze-fill`",
|
|
5890
5938
|
"surface": [
|
|
5891
5939
|
"none"
|
|
5892
5940
|
],
|
|
@@ -5903,31 +5951,39 @@
|
|
|
5903
5951
|
{
|
|
5904
5952
|
"id": "media",
|
|
5905
5953
|
"name": "Media",
|
|
5906
|
-
"description": "Video, audio and galleries. Crystal named none of these before
|
|
5954
|
+
"description": "Video, audio and galleries. Crystal named none of these before. The parity requirement here is about capability: a design system without a transport control leaves every product to invent one, and each invention re-solves captions, scrubbing and keyboard transport differently.",
|
|
5907
5955
|
"components": [
|
|
5908
5956
|
{
|
|
5909
5957
|
"id": "video-player",
|
|
5910
5958
|
"name": "Video player",
|
|
5911
|
-
"anatomy": "A video
|
|
5959
|
+
"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.",
|
|
5912
5960
|
"states": [
|
|
5913
5961
|
"idle",
|
|
5914
5962
|
"playing",
|
|
5915
5963
|
"paused",
|
|
5916
5964
|
"buffering",
|
|
5917
5965
|
"ended",
|
|
5918
|
-
"focus-visible"
|
|
5966
|
+
"focus-visible",
|
|
5967
|
+
"captions-on",
|
|
5968
|
+
"settings-open",
|
|
5969
|
+
"picture-in-picture",
|
|
5970
|
+
"full-screen"
|
|
5919
5971
|
],
|
|
5920
|
-
"material": "Resin
|
|
5972
|
+
"material": "Resin transport over the video with Haze fills behind its time readouts; Stone behind caption cues; Frost settings menu",
|
|
5921
5973
|
"surface": [
|
|
5922
5974
|
"resin",
|
|
5923
|
-
"haze"
|
|
5975
|
+
"haze",
|
|
5976
|
+
"stone",
|
|
5977
|
+
"frost"
|
|
5924
5978
|
],
|
|
5925
|
-
"geometry": "
|
|
5926
|
-
"semantics": "Native video element underneath. Controls are real buttons, captions are supported and their state is announced, and keyboard shortcuts do not trap focus.",
|
|
5927
|
-
"crystal": "
|
|
5928
|
-
"product": "Sources,
|
|
5979
|
+
"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.",
|
|
5980
|
+
"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.",
|
|
5981
|
+
"crystal": "Stage, transport and caption materials, transport geometry and insets, the settings menu, the motion of showing and hiding controls",
|
|
5982
|
+
"product": "Sources, caption and audio tracks, quality renditions and their switching (adaptive streaming), DRM, analytics",
|
|
5929
5983
|
"motion": [
|
|
5930
|
-
"media-in"
|
|
5984
|
+
"media-in",
|
|
5985
|
+
"menu-in",
|
|
5986
|
+
"menu-out"
|
|
5931
5987
|
],
|
|
5932
5988
|
"parity": [
|
|
5933
5989
|
"primereact:galleria",
|
|
@@ -5937,26 +5993,30 @@
|
|
|
5937
5993
|
{
|
|
5938
5994
|
"id": "audio-player",
|
|
5939
5995
|
"name": "Audio player",
|
|
5940
|
-
"anatomy": "
|
|
5996
|
+
"anatomy": "A Haze card holding the title and any secondary line (artist, episode, chapter), with the transport inset from its edge: play, skip, the scrubber with its two time readouts, mute and volume, and a settings menu for playback speed.",
|
|
5941
5997
|
"states": [
|
|
5942
5998
|
"idle",
|
|
5943
5999
|
"playing",
|
|
5944
6000
|
"paused",
|
|
5945
6001
|
"buffering",
|
|
5946
6002
|
"ended",
|
|
5947
|
-
"focus-visible"
|
|
6003
|
+
"focus-visible",
|
|
6004
|
+
"settings-open"
|
|
5948
6005
|
],
|
|
5949
|
-
"material": "Resin
|
|
6006
|
+
"material": "Haze card holding a Resin transport; Frost settings menu",
|
|
5950
6007
|
"surface": [
|
|
6008
|
+
"haze",
|
|
5951
6009
|
"resin",
|
|
5952
|
-
"
|
|
6010
|
+
"frost"
|
|
5953
6011
|
],
|
|
5954
|
-
"geometry": "
|
|
6012
|
+
"geometry": "The card keeps the content radius and the card padding (20px); the transport is a pill with 4px block padding around its controls; the scrubber is a slider with a 44px thumb.",
|
|
5955
6013
|
"semantics": "A real audio element. The scrubber is a slider announcing time, not a progress bar.",
|
|
5956
6014
|
"crystal": "Material, scrubber geometry, time formatting",
|
|
5957
6015
|
"product": "Sources, playlists, streaming",
|
|
5958
6016
|
"motion": [
|
|
5959
|
-
"media-in"
|
|
6017
|
+
"media-in",
|
|
6018
|
+
"menu-in",
|
|
6019
|
+
"menu-out"
|
|
5960
6020
|
],
|
|
5961
6021
|
"parity": [
|
|
5962
6022
|
"mantine:Audio"
|
|
@@ -5965,7 +6025,7 @@
|
|
|
5965
6025
|
{
|
|
5966
6026
|
"id": "media-controls",
|
|
5967
6027
|
"name": "Media controls",
|
|
5968
|
-
"anatomy": "The shared transport used by both players.",
|
|
6028
|
+
"anatomy": "The shared transport used by both players: play, skip, the scrubber between two time readouts, mute and volume, then the controls a player adds (settings, picture in picture, full screen).",
|
|
5969
6029
|
"states": [
|
|
5970
6030
|
"idle",
|
|
5971
6031
|
"playing",
|
|
@@ -5973,11 +6033,12 @@
|
|
|
5973
6033
|
"buffering",
|
|
5974
6034
|
"focus-visible"
|
|
5975
6035
|
],
|
|
5976
|
-
"material": "Resin plane",
|
|
6036
|
+
"material": "Resin plane; Haze behind the time readouts",
|
|
5977
6037
|
"surface": [
|
|
5978
|
-
"resin"
|
|
6038
|
+
"resin",
|
|
6039
|
+
"haze"
|
|
5979
6040
|
],
|
|
5980
|
-
"geometry": "Pill
|
|
6041
|
+
"geometry": "Pill with 4px block and 12px inline padding around its 48px controls (58px tall with its rim), 4px between them. Time readouts are tabular and sit on Haze pills.",
|
|
5981
6042
|
"semantics": "Each control is a button with a name; play and pause are one toggle with a pressed state.",
|
|
5982
6043
|
"crystal": "Materials, the press recipe on every control",
|
|
5983
6044
|
"product": "Which controls appear",
|
|
@@ -6043,7 +6104,7 @@
|
|
|
6043
6104
|
{
|
|
6044
6105
|
"id": "commerce",
|
|
6045
6106
|
"name": "Commerce",
|
|
6046
|
-
"description": "Functional e-commerce components. Crystal named none before, which left every store to reinvent a quantity stepper, a variant selector and a cart summary
|
|
6107
|
+
"description": "Functional e-commerce components. Crystal named none before, which left every store to reinvent a quantity stepper, a variant selector and a cart summary, and to re-solve availability, currency formatting and checkout validation each time. Payment is deliberately bounded: these components never handle raw card data, and defer to the host provider's own element.",
|
|
6047
6108
|
"components": [
|
|
6048
6109
|
{
|
|
6049
6110
|
"id": "price",
|
|
@@ -6121,7 +6182,7 @@
|
|
|
6121
6182
|
"field"
|
|
6122
6183
|
],
|
|
6123
6184
|
"geometry": "Pill; both controls reach 44px.",
|
|
6124
|
-
"semantics": "A typable numeric field: the value is read as its text, and the bounds are announced when reached. Not role=spinbutton
|
|
6185
|
+
"semantics": "A typable numeric field: the value is read as its text, and the bounds are announced when reached. Not role=spinbutton, because a spin button cannot be focused with VoiceOver, so the role would put the control out of some readers' reach.",
|
|
6125
6186
|
"crystal": "Materials, press recipe on each control",
|
|
6126
6187
|
"product": "Bounds, step, stock rules",
|
|
6127
6188
|
"motion": [
|
|
@@ -6349,9 +6410,9 @@
|
|
|
6349
6410
|
"haze"
|
|
6350
6411
|
],
|
|
6351
6412
|
"geometry": "Options keep the content radius; the selected one carries label weight.",
|
|
6352
|
-
"semantics": "A radio group. Card fields are never reimplemented
|
|
6413
|
+
"semantics": "A radio group. Card fields are never reimplemented: the host supplies its provider element.",
|
|
6353
6414
|
"crystal": "Option material, selection, focus ring",
|
|
6354
|
-
"product": "The provider, tokenisation, and PCI scope
|
|
6415
|
+
"product": "The provider, tokenisation, and PCI scope; this component never handles raw card data",
|
|
6355
6416
|
"motion": [
|
|
6356
6417
|
"selection"
|
|
6357
6418
|
],
|
|
@@ -6625,7 +6686,7 @@
|
|
|
6625
6686
|
{
|
|
6626
6687
|
"id": "screens",
|
|
6627
6688
|
"name": "Screens",
|
|
6628
|
-
"description": "Whole views and the chrome around them, for interactive applications rather than documents. A screen owns landmarks, focus movement between views, and the states a view can be in before it has content
|
|
6689
|
+
"description": "Whole views and the chrome around them, for interactive applications rather than documents. A screen owns landmarks, focus movement between views, and the states a view can be in before it has content (loading, empty, error, offline, not found, unauthorised), which products otherwise improvise separately and inconsistently.",
|
|
6629
6690
|
"components": [
|
|
6630
6691
|
{
|
|
6631
6692
|
"id": "screen",
|
|
@@ -6715,8 +6776,7 @@
|
|
|
6715
6776
|
"crystal": "Pane materials, the collapse transition",
|
|
6716
6777
|
"product": "The data and routing",
|
|
6717
6778
|
"motion": [
|
|
6718
|
-
"page-in"
|
|
6719
|
-
"page-out"
|
|
6779
|
+
"page-in"
|
|
6720
6780
|
],
|
|
6721
6781
|
"parity": [
|
|
6722
6782
|
"antd:Layout"
|
|
@@ -6977,7 +7037,7 @@
|
|
|
6977
7037
|
{
|
|
6978
7038
|
"id": "blocks",
|
|
6979
7039
|
"name": "Blocks",
|
|
6980
|
-
"description": "Composed arrangements that solve a recognisable product problem: a dashboard shell, a checkout, a player, a storefront. Kept as their own tier rather than mixed into the components, because a component is a primitive with one job and a contract, while a block is opinionated by design
|
|
7040
|
+
"description": "Composed arrangements that solve a recognisable product problem: a dashboard shell, a checkout, a player, a storefront. Kept as their own tier rather than mixed into the components, because a component is a primitive with one job and a contract, while a block is opinionated by design. Mixing the two would ship opinions as if they were primitives. Benchmarked against Tailwind UI, Mantine UI, Ant Design Pro, MUI Templates and PrimeBlocks.",
|
|
6981
7041
|
"components": [
|
|
6982
7042
|
{
|
|
6983
7043
|
"id": "dashboard-shell",
|
|
@@ -7236,7 +7296,7 @@
|
|
|
7236
7296
|
"haze"
|
|
7237
7297
|
],
|
|
7238
7298
|
"geometry": "Transport is a pill; controls reach 44px.",
|
|
7239
|
-
"semantics": "Real media elements; captions and their state announced; transport reachable by keyboard.",
|
|
7299
|
+
"semantics": "Real media elements; captions and their state announced; transport reachable by keyboard; speed, track and quality choices announced as they change.",
|
|
7240
7300
|
"crystal": "Transport material, the show and hide motion",
|
|
7241
7301
|
"product": "Sources, queue, DRM",
|
|
7242
7302
|
"parity": [
|
|
@@ -7446,7 +7506,7 @@
|
|
|
7446
7506
|
{
|
|
7447
7507
|
"id": "editor-block",
|
|
7448
7508
|
"name": "Editor block",
|
|
7449
|
-
"anatomy": "A rich text surface with toolbar, and save
|
|
7509
|
+
"anatomy": "A rich text surface with its toolbar and selection toolbar, a save state in words, and the save action.",
|
|
7450
7510
|
"states": [
|
|
7451
7511
|
"at-rest",
|
|
7452
7512
|
"focus-visible",
|