@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
|
@@ -204,7 +204,7 @@
|
|
|
204
204
|
"invalid",
|
|
205
205
|
"disabled"
|
|
206
206
|
],
|
|
207
|
-
"material": "Resin field shell,
|
|
207
|
+
"material": "Resin field shell, Frost popover with Haze rows (R15e)",
|
|
208
208
|
"surface": [
|
|
209
209
|
"field",
|
|
210
210
|
"frost"
|
|
@@ -215,8 +215,7 @@
|
|
|
215
215
|
"product": "The accessible combobox implementation, filtering and async loading",
|
|
216
216
|
"motion": [
|
|
217
217
|
"popover-in",
|
|
218
|
-
"popover-out"
|
|
219
|
-
"list-in"
|
|
218
|
+
"popover-out"
|
|
220
219
|
],
|
|
221
220
|
"parity": [
|
|
222
221
|
"mantine:Autocomplete",
|
|
@@ -291,7 +290,7 @@
|
|
|
291
290
|
"mui:Checkbox",
|
|
292
291
|
"antd:Checkbox"
|
|
293
292
|
],
|
|
294
|
-
"note": "The checked mark is a check glyph. That is the control's own semantics
|
|
293
|
+
"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."
|
|
295
294
|
},
|
|
296
295
|
{
|
|
297
296
|
"id": "checkbox-group",
|
|
@@ -412,7 +411,7 @@
|
|
|
412
411
|
"surface": [
|
|
413
412
|
"choice"
|
|
414
413
|
],
|
|
415
|
-
"geometry": "8px track, 26px thumb; the thumb is the target and meets 44px
|
|
414
|
+
"geometry": "8px track, 26px thumb; the thumb is the target and meets 44px through padding",
|
|
416
415
|
"semantics": "Native range or role=slider with aria-valuenow, valuemin, valuemax and valuetext",
|
|
417
416
|
"crystal": "Track fill, thumb material, tick treatment, RTL mirroring",
|
|
418
417
|
"product": "Step, bounds and what the value drives",
|
|
@@ -799,7 +798,7 @@
|
|
|
799
798
|
"mui:—",
|
|
800
799
|
"antd:Upload"
|
|
801
800
|
],
|
|
802
|
-
"note": "Crystal supplies appearance only. A file input that does not
|
|
801
|
+
"note": "Crystal supplies appearance only. A file input that does not upload must not be presented as working."
|
|
803
802
|
},
|
|
804
803
|
{
|
|
805
804
|
"id": "dropzone",
|
|
@@ -898,8 +897,7 @@
|
|
|
898
897
|
"crystal": "Panel and action treatment, label weight for selection in the lists",
|
|
899
898
|
"product": "The data, move rules and filtering",
|
|
900
899
|
"motion": [
|
|
901
|
-
"list-in"
|
|
902
|
-
"list-out"
|
|
900
|
+
"list-in"
|
|
903
901
|
],
|
|
904
902
|
"parity": [
|
|
905
903
|
"antd:Transfer",
|
|
@@ -919,7 +917,7 @@
|
|
|
919
917
|
"loading",
|
|
920
918
|
"disabled"
|
|
921
919
|
],
|
|
922
|
-
"material": "
|
|
920
|
+
"material": "Frost popover with Haze columns (R15e), from a Resin field shell",
|
|
923
921
|
"surface": [
|
|
924
922
|
"field",
|
|
925
923
|
"frost",
|
|
@@ -953,7 +951,7 @@
|
|
|
953
951
|
"empty",
|
|
954
952
|
"disabled"
|
|
955
953
|
],
|
|
956
|
-
"material": "
|
|
954
|
+
"material": "Frost popover with Haze rows over the field (R15e)",
|
|
957
955
|
"surface": [
|
|
958
956
|
"frost",
|
|
959
957
|
"haze"
|
|
@@ -975,28 +973,38 @@
|
|
|
975
973
|
{
|
|
976
974
|
"id": "rich-text-surface",
|
|
977
975
|
"name": "Rich text surface",
|
|
978
|
-
"anatomy": "A toolbar of
|
|
976
|
+
"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.",
|
|
979
977
|
"states": [
|
|
980
978
|
"idle",
|
|
981
979
|
"focus",
|
|
982
980
|
"selection-active",
|
|
981
|
+
"selection-toolbar-open",
|
|
982
|
+
"touch-keyboard-open",
|
|
983
983
|
"disabled",
|
|
984
984
|
"read-only"
|
|
985
985
|
],
|
|
986
|
-
"material": "Resin toolbar, Haze editing surface",
|
|
986
|
+
"material": "Resin toolbar, Haze editing surface; Frost selection toolbar",
|
|
987
987
|
"surface": [
|
|
988
|
-
"field"
|
|
988
|
+
"field",
|
|
989
|
+
"frost"
|
|
989
990
|
],
|
|
990
|
-
"geometry": "Toolbar
|
|
991
|
-
"semantics": "Toolbar actions use aria-pressed for active formatting
|
|
992
|
-
"crystal": "Toolbar and surface appearance, active-format treatment",
|
|
993
|
-
"product": "The
|
|
991
|
+
"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.",
|
|
992
|
+
"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.",
|
|
993
|
+
"crystal": "Toolbar and surface appearance, active-format treatment, the format vocabulary and its rendering (shared with prose), the selection toolbar, toolbar placement on touch",
|
|
994
|
+
"product": "The editing engine, serialisation and paste handling, and which parts of the format vocabulary a product offers",
|
|
994
995
|
"parity": [
|
|
995
996
|
"mantine:RichTextEditor",
|
|
996
997
|
"mui:—",
|
|
997
998
|
"antd:—"
|
|
998
999
|
],
|
|
999
|
-
"note": "Crystal specifies the surface
|
|
1000
|
+
"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).",
|
|
1001
|
+
"motion": [
|
|
1002
|
+
"field-focus",
|
|
1003
|
+
"field-invalid",
|
|
1004
|
+
"field-valid",
|
|
1005
|
+
"menu-in",
|
|
1006
|
+
"menu-out"
|
|
1007
|
+
]
|
|
1000
1008
|
},
|
|
1001
1009
|
{
|
|
1002
1010
|
"id": "helper-text",
|
|
@@ -1215,7 +1223,7 @@
|
|
|
1215
1223
|
],
|
|
1216
1224
|
"material": "Resin track with a Resin thumb",
|
|
1217
1225
|
"surface": [
|
|
1218
|
-
"
|
|
1226
|
+
"resin"
|
|
1219
1227
|
],
|
|
1220
1228
|
"geometry": "Circular; the thumb reaches 44px including its hit area.",
|
|
1221
1229
|
"semantics": "role=\"slider\" with aria-valuenow in degrees and a text equivalent.",
|
|
@@ -1238,9 +1246,9 @@
|
|
|
1238
1246
|
"focus-visible",
|
|
1239
1247
|
"disabled"
|
|
1240
1248
|
],
|
|
1241
|
-
"material": "Resin body with a
|
|
1249
|
+
"material": "Resin body with a primary value arc",
|
|
1242
1250
|
"surface": [
|
|
1243
|
-
"
|
|
1251
|
+
"resin"
|
|
1244
1252
|
],
|
|
1245
1253
|
"geometry": "Circular; keyboard steps match the slider contract.",
|
|
1246
1254
|
"semantics": "role=\"slider\"; the value is readable as text, not only as an arc.",
|
|
@@ -1386,7 +1394,7 @@
|
|
|
1386
1394
|
"selected",
|
|
1387
1395
|
"focus-visible"
|
|
1388
1396
|
],
|
|
1389
|
-
"material": "
|
|
1397
|
+
"material": "A chequerboard beneath a transparent colour, so its alpha shows",
|
|
1390
1398
|
"surface": [
|
|
1391
1399
|
"none"
|
|
1392
1400
|
],
|
|
@@ -20,7 +20,7 @@
|
|
|
20
20
|
"haze"
|
|
21
21
|
],
|
|
22
22
|
"geometry": "Content radius; at least 12px between content and the feathered edge",
|
|
23
|
-
"semantics": "An article when it is content
|
|
23
|
+
"semantics": "An article when it is content or a button when the whole card acts, never both.",
|
|
24
24
|
"crystal": "Fill, feather, elevation, interactive treatment",
|
|
25
25
|
"product": "Content and what an interactive card does",
|
|
26
26
|
"motion": [
|
|
@@ -87,7 +87,6 @@
|
|
|
87
87
|
"product": "The data layer, virtualisation, and the sorting and filtering implementation",
|
|
88
88
|
"motion": [
|
|
89
89
|
"list-in",
|
|
90
|
-
"list-out",
|
|
91
90
|
"highlight"
|
|
92
91
|
],
|
|
93
92
|
"parity": [
|
|
@@ -252,12 +251,12 @@
|
|
|
252
251
|
"mui:Chip",
|
|
253
252
|
"antd:Tag"
|
|
254
253
|
],
|
|
255
|
-
"note": "Success uses a check mark. That is information display
|
|
254
|
+
"note": "Success uses a check mark. That is information display, the legitimate use of the glyph."
|
|
256
255
|
},
|
|
257
256
|
{
|
|
258
257
|
"id": "indicator",
|
|
259
258
|
"name": "Indicator",
|
|
260
|
-
"anatomy": "A small circular
|
|
259
|
+
"anatomy": "A small circular Haze mark attached to a control, carrying state.",
|
|
261
260
|
"states": [
|
|
262
261
|
"selection",
|
|
263
262
|
"current",
|
|
@@ -267,7 +266,7 @@
|
|
|
267
266
|
"required",
|
|
268
267
|
"invalid"
|
|
269
268
|
],
|
|
270
|
-
"material": "Haze: a 20px circle painting the Haze fill on an isolated layer with a 1px feather
|
|
269
|
+
"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",
|
|
271
270
|
"surface": [
|
|
272
271
|
"indicator"
|
|
273
272
|
],
|
|
@@ -318,7 +317,7 @@
|
|
|
318
317
|
"upcoming",
|
|
319
318
|
"error"
|
|
320
319
|
],
|
|
321
|
-
"material": "
|
|
320
|
+
"material": "Indicator markers on a Haze connector",
|
|
322
321
|
"surface": [
|
|
323
322
|
"indicator",
|
|
324
323
|
"haze"
|
|
@@ -409,8 +408,7 @@
|
|
|
409
408
|
"crystal": "Fade and control treatment",
|
|
410
409
|
"product": "Threshold and content",
|
|
411
410
|
"motion": [
|
|
412
|
-
"accordion-in"
|
|
413
|
-
"accordion-out"
|
|
411
|
+
"accordion-in"
|
|
414
412
|
],
|
|
415
413
|
"parity": [
|
|
416
414
|
"mantine:Spoiler",
|
|
@@ -542,7 +540,7 @@
|
|
|
542
540
|
{
|
|
543
541
|
"id": "authored-bubble",
|
|
544
542
|
"name": "Authored bubble",
|
|
545
|
-
"anatomy": "A reading surface with one
|
|
543
|
+
"anatomy": "A reading surface with one tightened corner indicating authorship or direction.",
|
|
546
544
|
"states": [
|
|
547
545
|
"incoming",
|
|
548
546
|
"own",
|
|
@@ -691,8 +689,7 @@
|
|
|
691
689
|
"crystal": "Node material, connector colour, selection by weight",
|
|
692
690
|
"product": "Hierarchy data and layout direction",
|
|
693
691
|
"motion": [
|
|
694
|
-
"accordion-in"
|
|
695
|
-
"accordion-out"
|
|
692
|
+
"accordion-in"
|
|
696
693
|
],
|
|
697
694
|
"parity": [
|
|
698
695
|
"primereact:organizationchart"
|
|
@@ -805,8 +802,7 @@
|
|
|
805
802
|
"crystal": "Row material, expansion motion, current marking by label weight",
|
|
806
803
|
"product": "The destination set and routing",
|
|
807
804
|
"motion": [
|
|
808
|
-
"accordion-in"
|
|
809
|
-
"accordion-out"
|
|
805
|
+
"accordion-in"
|
|
810
806
|
],
|
|
811
807
|
"parity": [
|
|
812
808
|
"react-aria:NavigationTree"
|
|
@@ -831,7 +827,6 @@
|
|
|
831
827
|
"product": "Which columns resize, and persistence",
|
|
832
828
|
"motion": [
|
|
833
829
|
"list-in",
|
|
834
|
-
"list-out",
|
|
835
830
|
"highlight",
|
|
836
831
|
"resize-settle"
|
|
837
832
|
],
|
|
@@ -34,7 +34,7 @@
|
|
|
34
34
|
{
|
|
35
35
|
"id": "toast",
|
|
36
36
|
"name": "Toast",
|
|
37
|
-
"anatomy": "A transient floating
|
|
37
|
+
"anatomy": "A transient floating Frost notification with a message and an optional single action.",
|
|
38
38
|
"states": [
|
|
39
39
|
"entering",
|
|
40
40
|
"visible",
|
|
@@ -44,7 +44,8 @@
|
|
|
44
44
|
],
|
|
45
45
|
"material": "Frost panel with Haze reading fill and the panel shadow (R15e); status accent from the semantic pair",
|
|
46
46
|
"surface": [
|
|
47
|
-
"frost"
|
|
47
|
+
"frost",
|
|
48
|
+
"haze"
|
|
48
49
|
],
|
|
49
50
|
"geometry": "Content radius; stacked with a 12px offset",
|
|
50
51
|
"semantics": "Polite live region; an urgent toast is assertive. Auto-dismiss must never remove the only route to an action.",
|
|
@@ -71,7 +72,8 @@
|
|
|
71
72
|
],
|
|
72
73
|
"material": "Frost panel with Haze reading fill (R15e)",
|
|
73
74
|
"surface": [
|
|
74
|
-
"frost"
|
|
75
|
+
"frost",
|
|
76
|
+
"haze"
|
|
75
77
|
],
|
|
76
78
|
"geometry": "Content radius",
|
|
77
79
|
"semantics": "Announced politely; the dismiss control is named for what it dismisses",
|
|
@@ -194,7 +196,7 @@
|
|
|
194
196
|
"mui:Skeleton",
|
|
195
197
|
"antd:Skeleton"
|
|
196
198
|
],
|
|
197
|
-
"note": "A skeleton must match the real layout.
|
|
199
|
+
"note": "A skeleton must match the real layout. One that resolves into a different shape is a worse experience than a spinner."
|
|
198
200
|
},
|
|
199
201
|
{
|
|
200
202
|
"id": "loading-overlay",
|
|
@@ -337,7 +339,7 @@
|
|
|
337
339
|
"determinate",
|
|
338
340
|
"indeterminate"
|
|
339
341
|
],
|
|
340
|
-
"material": "
|
|
342
|
+
"material": "A track in `--cr-haze-fill` with a primary arc",
|
|
341
343
|
"surface": [
|
|
342
344
|
"none"
|
|
343
345
|
],
|
|
@@ -360,7 +362,7 @@
|
|
|
360
362
|
"at-rest",
|
|
361
363
|
"focus-visible"
|
|
362
364
|
],
|
|
363
|
-
"material": "
|
|
365
|
+
"material": "A track in `--cr-haze-fill` with segment fills",
|
|
364
366
|
"surface": [
|
|
365
367
|
"none"
|
|
366
368
|
],
|
|
@@ -42,7 +42,7 @@
|
|
|
42
42
|
"open",
|
|
43
43
|
"dragging"
|
|
44
44
|
],
|
|
45
|
-
"material": "Mirage scrim
|
|
45
|
+
"material": "Mirage scrim and a Frost panel",
|
|
46
46
|
"surface": [
|
|
47
47
|
"frost",
|
|
48
48
|
"mirage"
|
|
@@ -64,7 +64,7 @@
|
|
|
64
64
|
{
|
|
65
65
|
"id": "menu",
|
|
66
66
|
"name": "Menu",
|
|
67
|
-
"anatomy": "A
|
|
67
|
+
"anatomy": "A Frost popover of actions, with optional groups, separators and checkable items.",
|
|
68
68
|
"states": [
|
|
69
69
|
"closed",
|
|
70
70
|
"open",
|
|
@@ -119,7 +119,7 @@
|
|
|
119
119
|
{
|
|
120
120
|
"id": "popover",
|
|
121
121
|
"name": "Popover",
|
|
122
|
-
"anatomy": "An anchored
|
|
122
|
+
"anatomy": "An anchored Frost surface holding arbitrary content, with optional arrow.",
|
|
123
123
|
"states": [
|
|
124
124
|
"closed",
|
|
125
125
|
"open",
|
|
@@ -174,7 +174,7 @@
|
|
|
174
174
|
{
|
|
175
175
|
"id": "tooltip",
|
|
176
176
|
"name": "Tooltip",
|
|
177
|
-
"anatomy": "Short supplemental text on a small
|
|
177
|
+
"anatomy": "Short supplemental text on a small Frost surface, anchored to its trigger.",
|
|
178
178
|
"states": [
|
|
179
179
|
"hidden",
|
|
180
180
|
"visible"
|
|
@@ -27,12 +27,14 @@
|
|
|
27
27
|
{
|
|
28
28
|
"id": "text",
|
|
29
29
|
"name": "Text",
|
|
30
|
-
"anatomy": "Body copy with size, weight, colour role and truncation options.",
|
|
30
|
+
"anatomy": "Body copy with size, weight, colour role, decoration (underline, strikethrough) and truncation options.",
|
|
31
31
|
"states": [
|
|
32
32
|
"default",
|
|
33
33
|
"muted",
|
|
34
34
|
"truncated",
|
|
35
|
-
"clamped"
|
|
35
|
+
"clamped",
|
|
36
|
+
"underlined",
|
|
37
|
+
"struck-through"
|
|
36
38
|
],
|
|
37
39
|
"material": "None",
|
|
38
40
|
"surface": [
|
|
@@ -97,7 +99,7 @@
|
|
|
97
99
|
{
|
|
98
100
|
"id": "prose",
|
|
99
101
|
"name": "Prose",
|
|
100
|
-
"anatomy": "Long-form content with consistent rhythm across headings, lists, tables, code and media.",
|
|
102
|
+
"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.",
|
|
101
103
|
"states": [
|
|
102
104
|
"default"
|
|
103
105
|
],
|
|
@@ -106,7 +108,7 @@
|
|
|
106
108
|
"none"
|
|
107
109
|
],
|
|
108
110
|
"geometry": "78ch measure; 1.8 line height; 4px-rhythm vertical spacing",
|
|
109
|
-
"semantics": "Anchor navigation must preserve focus when sections change",
|
|
111
|
+
"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.",
|
|
110
112
|
"crystal": "The complete reading rhythm and embedded-element treatment",
|
|
111
113
|
"product": "Content, rendering and virtualisation",
|
|
112
114
|
"parity": [
|
|
@@ -188,7 +190,7 @@
|
|
|
188
190
|
"none"
|
|
189
191
|
],
|
|
190
192
|
"geometry": "Step per level; leading tightens as size grows.",
|
|
191
|
-
"semantics": "The level is the document structure, never chosen for size
|
|
193
|
+
"semantics": "The level is the document structure, never chosen for size. Size comes from the step.",
|
|
192
194
|
"crystal": "The scale and its tracking",
|
|
193
195
|
"product": "Level and wording",
|
|
194
196
|
"parity": [
|
|
@@ -218,16 +220,18 @@
|
|
|
218
220
|
{
|
|
219
221
|
"id": "prose-list",
|
|
220
222
|
"name": "Prose list",
|
|
221
|
-
"anatomy": "Ordered and unordered lists inside running text, with Crystal markers.",
|
|
223
|
+
"anatomy": "Ordered and unordered lists inside running text, with Crystal markers, and checklists whose markers are checkboxes.",
|
|
222
224
|
"states": [
|
|
223
|
-
"at-rest"
|
|
225
|
+
"at-rest",
|
|
226
|
+
"checked",
|
|
227
|
+
"unchecked"
|
|
224
228
|
],
|
|
225
229
|
"material": "Inherits",
|
|
226
230
|
"surface": [
|
|
227
231
|
"none"
|
|
228
232
|
],
|
|
229
233
|
"geometry": "Marker inset follows the spacing scale; hanging indent preserved.",
|
|
230
|
-
"semantics": "Real ul and ol so the count and nesting are announced.",
|
|
234
|
+
"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.",
|
|
231
235
|
"crystal": "Marker treatment, spacing, nesting rhythm",
|
|
232
236
|
"product": "Content and ordering",
|
|
233
237
|
"parity": [
|
|
@@ -403,7 +403,7 @@
|
|
|
403
403
|
"drop-target",
|
|
404
404
|
"focus-visible"
|
|
405
405
|
],
|
|
406
|
-
"material": "
|
|
406
|
+
"material": "No material of its own: the opaque surface with the float shadow while lifted, and a drop indicator in `--cr-haze-fill`",
|
|
407
407
|
"surface": [
|
|
408
408
|
"drag-handle"
|
|
409
409
|
],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"id": "charts",
|
|
3
3
|
"name": "Charts",
|
|
4
|
-
"description": "Data visualisation on one shared surface. Crystal named no charting component before 2.0 while every React benchmark shipped one
|
|
4
|
+
"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.",
|
|
5
5
|
"components": [
|
|
6
6
|
{
|
|
7
7
|
"id": "chart-surface",
|
|
@@ -86,7 +86,7 @@
|
|
|
86
86
|
"focus-visible",
|
|
87
87
|
"empty"
|
|
88
88
|
],
|
|
89
|
-
"material": "
|
|
89
|
+
"material": "The series colour at `--cr-chart-fill-opacity` beneath the line",
|
|
90
90
|
"surface": [
|
|
91
91
|
"none"
|
|
92
92
|
],
|
|
@@ -133,7 +133,7 @@
|
|
|
133
133
|
"focus-visible",
|
|
134
134
|
"empty"
|
|
135
135
|
],
|
|
136
|
-
"material": "
|
|
136
|
+
"material": "A centre fill in `--cr-haze-fill`",
|
|
137
137
|
"surface": [
|
|
138
138
|
"none"
|
|
139
139
|
],
|
|
@@ -177,7 +177,7 @@
|
|
|
177
177
|
"focus-visible",
|
|
178
178
|
"empty"
|
|
179
179
|
],
|
|
180
|
-
"material": "
|
|
180
|
+
"material": "The series colour at `--cr-chart-fill-opacity` inside each series polygon",
|
|
181
181
|
"surface": [
|
|
182
182
|
"none"
|
|
183
183
|
],
|
|
@@ -219,7 +219,7 @@
|
|
|
219
219
|
"determinate",
|
|
220
220
|
"empty"
|
|
221
221
|
],
|
|
222
|
-
"material": "
|
|
222
|
+
"material": "A track in `--cr-haze-fill` with a primary arc",
|
|
223
223
|
"surface": [
|
|
224
224
|
"none"
|
|
225
225
|
],
|
|
@@ -442,7 +442,7 @@
|
|
|
442
442
|
"focus-visible",
|
|
443
443
|
"empty"
|
|
444
444
|
],
|
|
445
|
-
"material": "
|
|
445
|
+
"material": "Range bands in `--cr-haze-fill`",
|
|
446
446
|
"surface": [
|
|
447
447
|
"none"
|
|
448
448
|
],
|
|
@@ -530,7 +530,7 @@
|
|
|
530
530
|
"focus-visible",
|
|
531
531
|
"empty"
|
|
532
532
|
],
|
|
533
|
-
"material": "
|
|
533
|
+
"material": "Node fills in `--cr-haze-fill`",
|
|
534
534
|
"surface": [
|
|
535
535
|
"none"
|
|
536
536
|
],
|
|
@@ -1,31 +1,39 @@
|
|
|
1
1
|
{
|
|
2
2
|
"id": "media",
|
|
3
3
|
"name": "Media",
|
|
4
|
-
"description": "Video, audio and galleries. Crystal named none of these before
|
|
4
|
+
"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.",
|
|
5
5
|
"components": [
|
|
6
6
|
{
|
|
7
7
|
"id": "video-player",
|
|
8
8
|
"name": "Video player",
|
|
9
|
-
"anatomy": "A video
|
|
9
|
+
"anatomy": "A media stage at a set aspect ratio holding the video, a caption cue above the transport, and the transport inset from the stage: play, skip, the scrubber with its two time readouts, mute and volume, then a settings menu (playback speed, subtitles and captions, audio track, quality), picture in picture and full screen.",
|
|
10
10
|
"states": [
|
|
11
11
|
"idle",
|
|
12
12
|
"playing",
|
|
13
13
|
"paused",
|
|
14
14
|
"buffering",
|
|
15
15
|
"ended",
|
|
16
|
-
"focus-visible"
|
|
16
|
+
"focus-visible",
|
|
17
|
+
"captions-on",
|
|
18
|
+
"settings-open",
|
|
19
|
+
"picture-in-picture",
|
|
20
|
+
"full-screen"
|
|
17
21
|
],
|
|
18
|
-
"material": "Resin
|
|
22
|
+
"material": "Resin transport over the video with Haze fills behind its time readouts; Stone behind caption cues; Frost settings menu",
|
|
19
23
|
"surface": [
|
|
20
24
|
"resin",
|
|
21
|
-
"haze"
|
|
25
|
+
"haze",
|
|
26
|
+
"stone",
|
|
27
|
+
"frost"
|
|
22
28
|
],
|
|
23
|
-
"geometry": "
|
|
24
|
-
"semantics": "Native video element underneath. Controls are real buttons, captions are supported and their state is announced, and keyboard shortcuts do not trap focus.",
|
|
25
|
-
"crystal": "
|
|
26
|
-
"product": "Sources,
|
|
29
|
+
"geometry": "The stage keeps the content radius and the aspect ratio the product sets (16:9, 4:3, 1:1, 9:16 or the media's own). The transport is a pill inset 12px from the stage, or the safe area in full screen, with 4px block padding around its controls (58px with its rim); every control reaches the 48px action target. Caption cues sit above the transport, never under it. Below 420px the transport wraps its trailing controls onto a second row.",
|
|
30
|
+
"semantics": "Native video element underneath. Controls are real buttons, captions are supported and their state is announced, and keyboard shortcuts do not trap focus. Speed, subtitle, audio-track and quality choices are menus of radio items (menuitemradio with aria-checked); the selected item is shown by label weight, never a check mark, and each change is announced in words. A choice the engine cannot make (an audio track list where the browser exposes none, picture in picture where it is unsupported) is not offered.",
|
|
31
|
+
"crystal": "Stage, transport and caption materials, transport geometry and insets, the settings menu, the motion of showing and hiding controls",
|
|
32
|
+
"product": "Sources, caption and audio tracks, quality renditions and their switching (adaptive streaming), DRM, analytics",
|
|
27
33
|
"motion": [
|
|
28
|
-
"media-in"
|
|
34
|
+
"media-in",
|
|
35
|
+
"menu-in",
|
|
36
|
+
"menu-out"
|
|
29
37
|
],
|
|
30
38
|
"parity": [
|
|
31
39
|
"primereact:galleria",
|
|
@@ -35,26 +43,30 @@
|
|
|
35
43
|
{
|
|
36
44
|
"id": "audio-player",
|
|
37
45
|
"name": "Audio player",
|
|
38
|
-
"anatomy": "
|
|
46
|
+
"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.",
|
|
39
47
|
"states": [
|
|
40
48
|
"idle",
|
|
41
49
|
"playing",
|
|
42
50
|
"paused",
|
|
43
51
|
"buffering",
|
|
44
52
|
"ended",
|
|
45
|
-
"focus-visible"
|
|
53
|
+
"focus-visible",
|
|
54
|
+
"settings-open"
|
|
46
55
|
],
|
|
47
|
-
"material": "Resin
|
|
56
|
+
"material": "Haze card holding a Resin transport; Frost settings menu",
|
|
48
57
|
"surface": [
|
|
58
|
+
"haze",
|
|
49
59
|
"resin",
|
|
50
|
-
"
|
|
60
|
+
"frost"
|
|
51
61
|
],
|
|
52
|
-
"geometry": "
|
|
62
|
+
"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.",
|
|
53
63
|
"semantics": "A real audio element. The scrubber is a slider announcing time, not a progress bar.",
|
|
54
64
|
"crystal": "Material, scrubber geometry, time formatting",
|
|
55
65
|
"product": "Sources, playlists, streaming",
|
|
56
66
|
"motion": [
|
|
57
|
-
"media-in"
|
|
67
|
+
"media-in",
|
|
68
|
+
"menu-in",
|
|
69
|
+
"menu-out"
|
|
58
70
|
],
|
|
59
71
|
"parity": [
|
|
60
72
|
"mantine:Audio"
|
|
@@ -63,7 +75,7 @@
|
|
|
63
75
|
{
|
|
64
76
|
"id": "media-controls",
|
|
65
77
|
"name": "Media controls",
|
|
66
|
-
"anatomy": "The shared transport used by both players.",
|
|
78
|
+
"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).",
|
|
67
79
|
"states": [
|
|
68
80
|
"idle",
|
|
69
81
|
"playing",
|
|
@@ -71,11 +83,12 @@
|
|
|
71
83
|
"buffering",
|
|
72
84
|
"focus-visible"
|
|
73
85
|
],
|
|
74
|
-
"material": "Resin plane",
|
|
86
|
+
"material": "Resin plane; Haze behind the time readouts",
|
|
75
87
|
"surface": [
|
|
76
|
-
"resin"
|
|
88
|
+
"resin",
|
|
89
|
+
"haze"
|
|
77
90
|
],
|
|
78
|
-
"geometry": "Pill
|
|
91
|
+
"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.",
|
|
79
92
|
"semantics": "Each control is a button with a name; play and pause are one toggle with a pressed state.",
|
|
80
93
|
"crystal": "Materials, the press recipe on every control",
|
|
81
94
|
"product": "Which controls appear",
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"id": "commerce",
|
|
3
3
|
"name": "Commerce",
|
|
4
|
-
"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
|
|
4
|
+
"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.",
|
|
5
5
|
"components": [
|
|
6
6
|
{
|
|
7
7
|
"id": "price",
|
|
@@ -79,7 +79,7 @@
|
|
|
79
79
|
"field"
|
|
80
80
|
],
|
|
81
81
|
"geometry": "Pill; both controls reach 44px.",
|
|
82
|
-
"semantics": "A typable numeric field: the value is read as its text, and the bounds are announced when reached. Not role=spinbutton
|
|
82
|
+
"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.",
|
|
83
83
|
"crystal": "Materials, press recipe on each control",
|
|
84
84
|
"product": "Bounds, step, stock rules",
|
|
85
85
|
"motion": [
|
|
@@ -307,9 +307,9 @@
|
|
|
307
307
|
"haze"
|
|
308
308
|
],
|
|
309
309
|
"geometry": "Options keep the content radius; the selected one carries label weight.",
|
|
310
|
-
"semantics": "A radio group. Card fields are never reimplemented
|
|
310
|
+
"semantics": "A radio group. Card fields are never reimplemented: the host supplies its provider element.",
|
|
311
311
|
"crystal": "Option material, selection, focus ring",
|
|
312
|
-
"product": "The provider, tokenisation, and PCI scope
|
|
312
|
+
"product": "The provider, tokenisation, and PCI scope; this component never handles raw card data",
|
|
313
313
|
"motion": [
|
|
314
314
|
"selection"
|
|
315
315
|
],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"id": "screens",
|
|
3
3
|
"name": "Screens",
|
|
4
|
-
"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
|
|
4
|
+
"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.",
|
|
5
5
|
"components": [
|
|
6
6
|
{
|
|
7
7
|
"id": "screen",
|
|
@@ -91,8 +91,7 @@
|
|
|
91
91
|
"crystal": "Pane materials, the collapse transition",
|
|
92
92
|
"product": "The data and routing",
|
|
93
93
|
"motion": [
|
|
94
|
-
"page-in"
|
|
95
|
-
"page-out"
|
|
94
|
+
"page-in"
|
|
96
95
|
],
|
|
97
96
|
"parity": [
|
|
98
97
|
"antd:Layout"
|