@crystal-ui/core 2.1.0 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/assets/crystal-theme.css +15 -0
  2. package/assets/crystal.css +652 -12
  3. package/assets/crystal.js +10 -0
  4. package/assets/motion.css +3 -3
  5. package/assets/motion.js +17 -2
  6. package/assets/tokens.js +1 -1
  7. package/docs/accessibility.md +19 -3
  8. package/docs/adoption.md +3 -1
  9. package/docs/catalogue.md +467 -53
  10. package/docs/components.md +36 -9
  11. package/docs/materials.md +12 -4
  12. package/docs/motion-components.md +11 -8
  13. package/docs/motion.md +10 -4
  14. package/docs/tokens.md +3 -2
  15. package/engines.js +13 -2
  16. package/exports/crystal-tokens.kt +2 -1
  17. package/exports/crystal-tokens.swift +2 -1
  18. package/exports/crystal-tokens.ts +2 -1
  19. package/package.json +2 -1
  20. package/tokens/catalogue/01-layout.json +45 -0
  21. package/tokens/catalogue/02-navigation.json +88 -6
  22. package/tokens/catalogue/03-actions.json +42 -2
  23. package/tokens/catalogue/04-inputs.json +359 -5
  24. package/tokens/catalogue/05-data-display.json +185 -21
  25. package/tokens/catalogue/06-feedback.json +75 -6
  26. package/tokens/catalogue/07-overlays.json +52 -5
  27. package/tokens/catalogue/08-typography.json +54 -0
  28. package/tokens/catalogue/09-utility.json +79 -0
  29. package/tokens/catalogue/10-charts.json +89 -1
  30. package/tokens/catalogue/11-media.json +33 -0
  31. package/tokens/catalogue/12-commerce.json +133 -1
  32. package/tokens/catalogue/13-screens.json +77 -0
  33. package/tokens/catalogue/14-blocks.json +101 -0
  34. package/tokens/catalogue.json +1656 -48
  35. package/tokens/crystal.json +3 -2
  36. package/tokens/crystal.tokens.json +7 -2
  37. package/tokens/motion-recipes.json +124 -96
  38. package/tokens/surfaces.json +177 -0
@@ -17,6 +17,9 @@
17
17
  "read-only"
18
18
  ],
19
19
  "material": "Resin shell, Haze well; the native field keeps its functional boundary",
20
+ "surface": [
21
+ "field"
22
+ ],
20
23
  "geometry": "Field well radius = content radius − 7px; shell 20px; 44px minimum height",
21
24
  "semantics": "Native input with a programmatically associated label, aria-invalid and aria-describedby for errors",
22
25
  "crystal": "Shell material, badge vocabulary (hollow circle idle, filled focused, asterisk required, exclamation invalid), focus ring",
@@ -46,6 +49,9 @@
46
49
  "read-only"
47
50
  ],
48
51
  "material": "Resin shell, Haze well",
52
+ "surface": [
53
+ "field"
54
+ ],
49
55
  "geometry": "Well radius = content radius − 7px; minimum three visible lines",
50
56
  "semantics": "Native textarea with an associated label; autosize must not trap the caret",
51
57
  "crystal": "Shell material, badge placement at the well's top edge, focus ring",
@@ -72,10 +78,18 @@
72
78
  "at-max"
73
79
  ],
74
80
  "material": "Resin shell; steppers share the plane rather than floating separately",
81
+ "surface": [
82
+ "field"
83
+ ],
75
84
  "geometry": "Stepper targets meet 44px even when visually compact",
76
- "semantics": "Native number input or a text input with inputmode and role=spinbutton; arrow keys must step",
85
+ "semantics": "A text input with inputmode=numeric whose bounds are announced when reached; arrow keys must step. Not role=spinbutton, which VoiceOver cannot focus.",
77
86
  "crystal": "Shell, stepper treatment, at-bound states",
78
87
  "product": "Step size, precision, clamping and locale formatting",
88
+ "motion": [
89
+ "field-focus",
90
+ "field-invalid",
91
+ "field-valid"
92
+ ],
79
93
  "parity": [
80
94
  "mantine:NumberInput",
81
95
  "mui:TextField",
@@ -94,10 +108,18 @@
94
108
  "disabled"
95
109
  ],
96
110
  "material": "Resin shell; the toggle shares the shell",
111
+ "surface": [
112
+ "field"
113
+ ],
97
114
  "geometry": "Toggle meets the 44px floor",
98
115
  "semantics": "The reveal toggle is a button with aria-pressed and a real accessible name; never a decorative icon",
99
116
  "crystal": "Shell, toggle placement, strength meter treatment",
100
117
  "product": "Strength policy and what it reveals",
118
+ "motion": [
119
+ "field-focus",
120
+ "field-invalid",
121
+ "field-valid"
122
+ ],
101
123
  "parity": [
102
124
  "mantine:PasswordInput",
103
125
  "mui:TextField",
@@ -116,10 +138,18 @@
116
138
  "disabled"
117
139
  ],
118
140
  "material": "Resin shell, Haze well",
141
+ "surface": [
142
+ "field"
143
+ ],
119
144
  "geometry": "Pill well is permitted here, as search reads as an action surface",
120
145
  "semantics": "role=searchbox or type=search inside a search landmark; the clear control is a named button",
121
146
  "crystal": "Shell, icon placement, clear affordance, loading treatment",
122
147
  "product": "Debounce, the query and result rendering",
148
+ "motion": [
149
+ "field-focus",
150
+ "field-invalid",
151
+ "field-valid"
152
+ ],
123
153
  "parity": [
124
154
  "mantine:TextInput",
125
155
  "mui:TextField",
@@ -139,10 +169,21 @@
139
169
  "disabled"
140
170
  ],
141
171
  "material": "Resin shell, Haze well",
172
+ "surface": [
173
+ "field",
174
+ "frost"
175
+ ],
142
176
  "geometry": "Well radius = content radius − 7px",
143
177
  "semantics": "Native select wherever the option set allows it; the badge never covers the platform arrow",
144
178
  "crystal": "Shell material, badge placement clear of the disclosure, focus ring",
145
179
  "product": "Options, grouping and change handling",
180
+ "motion": [
181
+ "field-focus",
182
+ "field-invalid",
183
+ "field-valid",
184
+ "menu-in",
185
+ "menu-out"
186
+ ],
146
187
  "parity": [
147
188
  "mantine:NativeSelect",
148
189
  "mui:Select",
@@ -164,6 +205,10 @@
164
205
  "disabled"
165
206
  ],
166
207
  "material": "Resin field shell, Resin popover with Haze rows",
208
+ "surface": [
209
+ "field",
210
+ "frost"
211
+ ],
167
212
  "geometry": "Popover content radius; rows inset 8px",
168
213
  "semantics": "role=combobox with aria-expanded, aria-controls and aria-activedescendant; the list is never focus-stealing",
169
214
  "crystal": "Field and popover material, row treatment, label weight for selection, empty and loading appearance",
@@ -193,10 +238,24 @@
193
238
  "disabled"
194
239
  ],
195
240
  "material": "Resin shell, Haze chips",
241
+ "surface": [
242
+ "field",
243
+ "compact",
244
+ "frost"
245
+ ],
196
246
  "geometry": "Chips are pills; the shell grows in whole line steps",
197
247
  "semantics": "Each chip's remove control is a named button; removal must be reachable by keyboard",
198
248
  "crystal": "Chip geometry within the shell, overflow treatment, growth behaviour",
199
249
  "product": "Selection limits, the option set and the accessible implementation",
250
+ "motion": [
251
+ "field-focus",
252
+ "field-invalid",
253
+ "field-valid",
254
+ "menu-in",
255
+ "menu-out",
256
+ "list-in",
257
+ "list-out"
258
+ ],
200
259
  "parity": [
201
260
  "mantine:MultiSelect",
202
261
  "mui:Autocomplete multiple",
@@ -216,6 +275,9 @@
216
275
  "invalid"
217
276
  ],
218
277
  "material": "Resin box, primary fill when checked",
278
+ "surface": [
279
+ "choice"
280
+ ],
219
281
  "geometry": "26px box, 9px radius; the whole label is a target meeting 44px",
220
282
  "semantics": "Native checkbox; indeterminate set through the property, not a class",
221
283
  "crystal": "Box material, the contained mark, focus ring",
@@ -241,6 +303,9 @@
241
303
  "disabled"
242
304
  ],
243
305
  "material": "Inherits the surrounding surface",
306
+ "surface": [
307
+ "none"
308
+ ],
244
309
  "geometry": "Spacing from the 4px rhythm",
245
310
  "semantics": "fieldset and legend, or role=group with an accessible name; errors describe the group",
246
311
  "crystal": "Grouping rhythm and error association treatment",
@@ -263,18 +328,21 @@
263
328
  "invalid"
264
329
  ],
265
330
  "material": "Resin circle, primary centre when selected",
331
+ "surface": [
332
+ "choice"
333
+ ],
266
334
  "geometry": "26px circle; label target meets 44px",
267
335
  "semantics": "Native radio in a named group; arrow keys move within the group",
268
336
  "crystal": "Circle material, contained centre mark, focus ring",
269
337
  "product": "Group naming and validation",
338
+ "motion": [
339
+ "check",
340
+ "check-off"
341
+ ],
270
342
  "parity": [
271
343
  "mantine:Radio",
272
344
  "mui:Radio",
273
345
  "antd:Radio"
274
- ],
275
- "motion": [
276
- "check",
277
- "check-off"
278
346
  ]
279
347
  },
280
348
  {
@@ -287,6 +355,9 @@
287
355
  "disabled"
288
356
  ],
289
357
  "material": "Inherits",
358
+ "surface": [
359
+ "none"
360
+ ],
290
361
  "geometry": "4px rhythm",
291
362
  "semantics": "fieldset and legend, or role=radiogroup with an accessible name",
292
363
  "crystal": "Grouping rhythm and error association",
@@ -309,6 +380,9 @@
309
380
  "loading"
310
381
  ],
311
382
  "material": "Resin track, primary-soft track when on, opaque thumb",
383
+ "surface": [
384
+ "choice"
385
+ ],
312
386
  "geometry": "44x28px track, circular thumb; 44px target",
313
387
  "semantics": "Native checkbox with role=switch, or a button with aria-checked; state must not rely on position alone",
314
388
  "crystal": "Track and thumb material, travel, focus ring on the track",
@@ -335,6 +409,9 @@
335
409
  "disabled"
336
410
  ],
337
411
  "material": "Primary fill to the value, primary-soft beyond; Resin thumb",
412
+ "surface": [
413
+ "choice"
414
+ ],
338
415
  "geometry": "8px track, 26px thumb; the thumb is the target and meets 44px in practice through padding",
339
416
  "semantics": "Native range or role=slider with aria-valuenow, valuemin, valuemax and valuetext",
340
417
  "crystal": "Track fill, thumb material, tick treatment, RTL mirroring",
@@ -360,10 +437,16 @@
360
437
  "collapsed"
361
438
  ],
362
439
  "material": "Primary fill between the thumbs",
440
+ "surface": [
441
+ "choice"
442
+ ],
363
443
  "geometry": "Shared with Slider; thumbs must remain separable when they meet",
364
444
  "semantics": "Two sliders with distinct accessible names; each announces its own bound",
365
445
  "crystal": "Span fill, thumb collision behaviour",
366
446
  "product": "Minimum span and what the range drives",
447
+ "motion": [
448
+ "slider-step"
449
+ ],
367
450
  "parity": [
368
451
  "mantine:RangeSlider",
369
452
  "mui:Slider range",
@@ -382,6 +465,9 @@
382
465
  "disabled"
383
466
  ],
384
467
  "material": "One Resin plane; primary fill on the selected segment",
468
+ "surface": [
469
+ "dock"
470
+ ],
385
471
  "geometry": "Pill strip and pill segments; 44px minimum",
386
472
  "semantics": "Radio group semantics, or aria-pressed on buttons; never aria-selected outside a tablist",
387
473
  "crystal": "Shared plane, label weight for the selected segment, focus ring",
@@ -408,10 +494,16 @@
408
494
  "read-only"
409
495
  ],
410
496
  "material": "Primary fill on the active symbols",
497
+ "surface": [
498
+ "none"
499
+ ],
411
500
  "geometry": "24px symbols on the icon grid; 44px targets when interactive",
412
501
  "semantics": "Radio group when interactive; plain text with a visible value when read-only. Never symbol-only.",
413
502
  "crystal": "Symbol treatment and fractional fill",
414
503
  "product": "Scale, precision and what the score means",
504
+ "motion": [
505
+ "selection"
506
+ ],
415
507
  "parity": [
416
508
  "mantine:Rating",
417
509
  "mui:Rating",
@@ -431,10 +523,18 @@
431
523
  "disabled"
432
524
  ],
433
525
  "material": "Resin shells with Haze wells",
526
+ "surface": [
527
+ "field"
528
+ ],
434
529
  "geometry": "Square-ish wells at the field radius; 44px minimum",
435
530
  "semantics": "One labelled group; paste must fill the whole value; backspace must move back",
436
531
  "crystal": "Well geometry, advance and focus treatment",
437
532
  "product": "Length, masking and verification",
533
+ "motion": [
534
+ "field-focus",
535
+ "field-invalid",
536
+ "field-valid"
537
+ ],
438
538
  "parity": [
439
539
  "mantine:PinInput",
440
540
  "mui:—",
@@ -454,10 +554,21 @@
454
554
  "invalid"
455
555
  ],
456
556
  "material": "Resin shell, Haze chips",
557
+ "surface": [
558
+ "field",
559
+ "compact"
560
+ ],
457
561
  "geometry": "Pill chips; shell grows in whole line steps",
458
562
  "semantics": "Each chip has a named remove control; additions and removals are announced",
459
563
  "crystal": "Chip geometry, duplicate and limit treatment",
460
564
  "product": "Delimiters, validation and limits",
565
+ "motion": [
566
+ "field-focus",
567
+ "field-invalid",
568
+ "field-valid",
569
+ "list-in",
570
+ "list-out"
571
+ ],
461
572
  "parity": [
462
573
  "mantine:TagsInput",
463
574
  "mui:Autocomplete freeSolo",
@@ -477,10 +588,17 @@
477
588
  "removable"
478
589
  ],
479
590
  "material": "Haze fill on a Resin rim; primary fill when selected",
591
+ "surface": [
592
+ "control"
593
+ ],
480
594
  "geometry": "Pill; 32px compact height with a 44px target",
481
595
  "semantics": "Selectable chips use aria-pressed; the remove control is a separate named button",
482
596
  "crystal": "Pill geometry, selected treatment, remove affordance",
483
597
  "product": "What the chip filters or represents",
598
+ "motion": [
599
+ "selection",
600
+ "press"
601
+ ],
484
602
  "parity": [
485
603
  "mantine:Chip",
486
604
  "mui:Chip",
@@ -499,10 +617,18 @@
499
617
  "disabled"
500
618
  ],
501
619
  "material": "Resin shell; the swatch is specimen content, not a reading well",
620
+ "surface": [
621
+ "field"
622
+ ],
502
623
  "geometry": "Circular swatch; picker at content radius",
503
624
  "semantics": "A text value must always be editable; colour alone is never the only representation",
504
625
  "crystal": "Swatch treatment, picker surface material",
505
626
  "product": "Colour space, format and the picker implementation",
627
+ "motion": [
628
+ "field-focus",
629
+ "field-invalid",
630
+ "field-valid"
631
+ ],
506
632
  "parity": [
507
633
  "mantine:ColorInput",
508
634
  "mui:—",
@@ -522,10 +648,18 @@
522
648
  "open"
523
649
  ],
524
650
  "material": "Resin shell, Haze well",
651
+ "surface": [
652
+ "field"
653
+ ],
525
654
  "geometry": "Field radius; calendar at content radius",
526
655
  "semantics": "Typing must always be possible; the calendar is an enhancement, never the only route",
527
656
  "crystal": "Shell, disclosure placement, calendar surface",
528
657
  "product": "Locale, parsing, validation and the calendar implementation",
658
+ "motion": [
659
+ "field-focus",
660
+ "field-invalid",
661
+ "field-valid"
662
+ ],
529
663
  "parity": [
530
664
  "mantine:DateInput",
531
665
  "mui:DatePicker",
@@ -545,10 +679,24 @@
545
679
  "out-of-month"
546
680
  ],
547
681
  "material": "Resin surface, Haze day cells, primary fill on the selection",
682
+ "surface": [
683
+ "field",
684
+ "frost",
685
+ "haze"
686
+ ],
548
687
  "geometry": "Circular day cells; 44px targets",
549
688
  "semantics": "role=grid with full arrow-key navigation; the selected date is announced in words",
550
689
  "crystal": "Surface, cell geometry, selection and range treatment",
551
690
  "product": "Date arithmetic, locale, disabled ranges and the grid keyboard implementation",
691
+ "motion": [
692
+ "field-focus",
693
+ "field-invalid",
694
+ "field-valid",
695
+ "menu-in",
696
+ "menu-out",
697
+ "selection",
698
+ "page-in"
699
+ ],
552
700
  "parity": [
553
701
  "mantine:DatePicker",
554
702
  "mui:DateCalendar",
@@ -567,10 +715,24 @@
567
715
  "disabled"
568
716
  ],
569
717
  "material": "Primary-soft span fill between endpoints",
718
+ "surface": [
719
+ "field",
720
+ "frost",
721
+ "haze"
722
+ ],
570
723
  "geometry": "Span fill joins cells without breaking the 44px target",
571
724
  "semantics": "Start and end are separately named and separately announced",
572
725
  "crystal": "Span treatment and preview appearance",
573
726
  "product": "Range rules, minimum and maximum spans",
727
+ "motion": [
728
+ "field-focus",
729
+ "field-invalid",
730
+ "field-valid",
731
+ "menu-in",
732
+ "menu-out",
733
+ "selection",
734
+ "page-in"
735
+ ],
574
736
  "parity": [
575
737
  "mantine:DatePicker type=range",
576
738
  "mui:DateRangePicker",
@@ -589,10 +751,18 @@
589
751
  "disabled"
590
752
  ],
591
753
  "material": "Resin shell, Haze well",
754
+ "surface": [
755
+ "field"
756
+ ],
592
757
  "geometry": "Field radius; segment targets meet 44px",
593
758
  "semantics": "Segments are individually focusable and individually announced",
594
759
  "crystal": "Shell and segment treatment",
595
760
  "product": "Locale, 12- or 24-hour policy and validation",
761
+ "motion": [
762
+ "field-focus",
763
+ "field-invalid",
764
+ "field-valid"
765
+ ],
596
766
  "parity": [
597
767
  "mantine:TimeInput",
598
768
  "mui:TimePicker",
@@ -611,10 +781,19 @@
611
781
  "disabled"
612
782
  ],
613
783
  "material": "Resin action, Haze file rows",
784
+ "surface": [
785
+ "control",
786
+ "haze"
787
+ ],
614
788
  "geometry": "Pill action; rows at content radius",
615
789
  "semantics": "Native file input with a real label; progress and errors reach a live region",
616
790
  "crystal": "Action and row treatment, progress appearance",
617
791
  "product": "Upload, accepted types, size limits and retry",
792
+ "motion": [
793
+ "list-in",
794
+ "list-out",
795
+ "progress-change"
796
+ ],
618
797
  "parity": [
619
798
  "mantine:FileInput",
620
799
  "mui:—",
@@ -634,6 +813,9 @@
634
813
  "disabled"
635
814
  ],
636
815
  "material": "Haze surface with a dashed edge at rest, primary-soft while accepting",
816
+ "surface": [
817
+ "haze"
818
+ ],
637
819
  "geometry": "Content radius; minimum 120px height",
638
820
  "semantics": "Must have a keyboard-reachable file action; drag and drop is never the only route",
639
821
  "crystal": "Surface, edge treatment and state appearance",
@@ -659,6 +841,9 @@
659
841
  "disabled"
660
842
  ],
661
843
  "material": "Inherits",
844
+ "surface": [
845
+ "none"
846
+ ],
662
847
  "geometry": "Label to control 7px; control to helper 6px",
663
848
  "semantics": "Programmatic association through label, aria-describedby and aria-invalid. Errors are text, never colour alone.",
664
849
  "crystal": "Rhythm, label and helper treatment, error appearance",
@@ -679,6 +864,9 @@
679
864
  "invalid"
680
865
  ],
681
866
  "material": "Optional Haze panel for visually grouped sections",
867
+ "surface": [
868
+ "haze"
869
+ ],
682
870
  "geometry": "Content radius when a surface is used",
683
871
  "semantics": "Native fieldset and legend; disabling the set disables its controls",
684
872
  "crystal": "Grouping rhythm and optional panel treatment",
@@ -701,6 +889,10 @@
701
889
  "disabled"
702
890
  ],
703
891
  "material": "Haze list panels, Resin move actions",
892
+ "surface": [
893
+ "haze",
894
+ "control"
895
+ ],
704
896
  "geometry": "Content radius panels; pill actions",
705
897
  "semantics": "Each list is separately named; moves are announced; keyboard must move items without drag",
706
898
  "crystal": "Panel and action treatment, label weight for selection in the lists",
@@ -728,10 +920,22 @@
728
920
  "disabled"
729
921
  ],
730
922
  "material": "Resin popover, Haze columns",
923
+ "surface": [
924
+ "field",
925
+ "frost",
926
+ "haze"
927
+ ],
731
928
  "geometry": "Content radius; columns separated by a hairline",
732
929
  "semantics": "Each column is a listbox; the composed value is announced as a path",
733
930
  "crystal": "Popover and column treatment, label weight for the selected column entry",
734
931
  "product": "The hierarchy, lazy loading and the keyboard implementation",
932
+ "motion": [
933
+ "field-focus",
934
+ "field-invalid",
935
+ "field-valid",
936
+ "menu-in",
937
+ "menu-out"
938
+ ],
735
939
  "parity": [
736
940
  "antd:Cascader",
737
941
  "mui:—",
@@ -750,10 +954,18 @@
750
954
  "disabled"
751
955
  ],
752
956
  "material": "Resin popover with Haze rows over the field",
957
+ "surface": [
958
+ "frost",
959
+ "haze"
960
+ ],
753
961
  "geometry": "Popover at content radius, anchored to the caret",
754
962
  "semantics": "Combobox semantics attached to the text surface; the inserted value is announced",
755
963
  "crystal": "Popover, row and inserted-token treatment",
756
964
  "product": "Trigger characters, the data source and insertion",
965
+ "motion": [
966
+ "menu-in",
967
+ "menu-out"
968
+ ],
757
969
  "parity": [
758
970
  "antd:Mentions",
759
971
  "mui:—",
@@ -772,6 +984,9 @@
772
984
  "read-only"
773
985
  ],
774
986
  "material": "Resin toolbar, Haze editing surface",
987
+ "surface": [
988
+ "field"
989
+ ],
775
990
  "geometry": "Toolbar is a pill group; surface at content radius",
776
991
  "semantics": "Toolbar actions use aria-pressed for active formatting; the editor exposes its own semantics",
777
992
  "crystal": "Toolbar and surface appearance, active-format treatment",
@@ -793,6 +1008,9 @@
793
1008
  "error"
794
1009
  ],
795
1010
  "material": "None; sits on the surrounding surface",
1011
+ "surface": [
1012
+ "none"
1013
+ ],
796
1014
  "geometry": "6px below the control; never overlaps the field shell",
797
1015
  "semantics": "Associated through aria-describedby. When an error replaces the hint, the error must also be associated and announced.",
798
1016
  "crystal": "Rhythm, colour role, and the transition between hint and error",
@@ -821,10 +1039,21 @@
821
1039
  "disabled"
822
1040
  ],
823
1041
  "material": "Haze field fill inside a Resin shell; Frost popover",
1042
+ "surface": [
1043
+ "field",
1044
+ "frost"
1045
+ ],
824
1046
  "geometry": "Field radius is the content radius; the popover keeps panel radius.",
825
1047
  "semantics": "combobox with aria-autocomplete=\"list\"; the input keeps its own value.",
826
1048
  "crystal": "Materials, focus ring, list motion, empty and loading surfaces",
827
1049
  "product": "Where suggestions come from, debounce, free-text policy",
1050
+ "motion": [
1051
+ "field-focus",
1052
+ "field-invalid",
1053
+ "field-valid",
1054
+ "menu-in",
1055
+ "menu-out"
1056
+ ],
828
1057
  "parity": [
829
1058
  "antd:AutoComplete",
830
1059
  "mui:Autocomplete"
@@ -841,10 +1070,20 @@
841
1070
  "disabled"
842
1071
  ],
843
1072
  "material": "Haze field fill inside a Resin shell",
1073
+ "surface": [
1074
+ "field"
1075
+ ],
844
1076
  "geometry": "Matches the text field; the indicator sits in the trailing inline edge.",
845
1077
  "semantics": "A real <select>. Its options are the platform's and are never restyled.",
846
1078
  "crystal": "Shell material, focus ring, indicator",
847
1079
  "product": "Options and value",
1080
+ "motion": [
1081
+ "field-focus",
1082
+ "field-invalid",
1083
+ "field-valid",
1084
+ "menu-in",
1085
+ "menu-out"
1086
+ ],
848
1087
  "parity": [
849
1088
  "mantine:NativeSelect",
850
1089
  "mui:NativeSelect"
@@ -862,10 +1101,23 @@
862
1101
  "disabled"
863
1102
  ],
864
1103
  "material": "Haze field fill; Frost panel",
1104
+ "surface": [
1105
+ "field",
1106
+ "frost"
1107
+ ],
865
1108
  "geometry": "Segments are individually focusable; the panel keeps panel radius.",
866
1109
  "semantics": "Segmented input semantics; each segment announces its own role and bounds.",
867
1110
  "crystal": "Materials, segment focus, panel motion",
868
1111
  "product": "Locale, time zone, min and max",
1112
+ "motion": [
1113
+ "field-focus",
1114
+ "field-invalid",
1115
+ "field-valid",
1116
+ "menu-in",
1117
+ "menu-out",
1118
+ "selection",
1119
+ "page-in"
1120
+ ],
869
1121
  "parity": [
870
1122
  "mui-x-date-pickers:DateTimePicker",
871
1123
  "primereact:datepicker"
@@ -882,10 +1134,18 @@
882
1134
  "disabled"
883
1135
  ],
884
1136
  "material": "Frost panel with Haze cells",
1137
+ "surface": [
1138
+ "frost",
1139
+ "haze"
1140
+ ],
885
1141
  "geometry": "Cells are square-ish and reach 44px.",
886
1142
  "semantics": "A grid; the selected month uses aria-selected, never a check mark.",
887
1143
  "crystal": "Cell material, selection by weight, motion",
888
1144
  "product": "Range limits and locale",
1145
+ "motion": [
1146
+ "selection",
1147
+ "page-in"
1148
+ ],
889
1149
  "parity": [
890
1150
  "mui-x-date-pickers:MonthCalendar"
891
1151
  ]
@@ -901,10 +1161,18 @@
901
1161
  "disabled"
902
1162
  ],
903
1163
  "material": "Frost panel with Haze cells",
1164
+ "surface": [
1165
+ "frost",
1166
+ "haze"
1167
+ ],
904
1168
  "geometry": "Matches the month picker.",
905
1169
  "semantics": "A grid; selection is announced, and the current year is marked as current.",
906
1170
  "crystal": "Cell material, selection, scroll anchoring",
907
1171
  "product": "Range limits",
1172
+ "motion": [
1173
+ "selection",
1174
+ "page-in"
1175
+ ],
908
1176
  "parity": [
909
1177
  "mui-x-date-pickers:YearCalendar"
910
1178
  ]
@@ -920,10 +1188,17 @@
920
1188
  "disabled"
921
1189
  ],
922
1190
  "material": "Frost panel with Haze rows",
1191
+ "surface": [
1192
+ "frost",
1193
+ "haze"
1194
+ ],
923
1195
  "geometry": "Rows reach 44px; the list scrolls to the selected value.",
924
1196
  "semantics": "A listbox; the selected row is aria-selected and carries label weight.",
925
1197
  "crystal": "Row material, selection, scroll behaviour",
926
1198
  "product": "Interval, bounds, locale",
1199
+ "motion": [
1200
+ "selection"
1201
+ ],
927
1202
  "parity": [
928
1203
  "mui-x-date-pickers:DigitalClock"
929
1204
  ]
@@ -939,10 +1214,16 @@
939
1214
  "disabled"
940
1215
  ],
941
1216
  "material": "Resin track with a Resin thumb",
1217
+ "surface": [
1218
+ "none"
1219
+ ],
942
1220
  "geometry": "Circular; the thumb reaches 44px including its hit area.",
943
1221
  "semantics": "role=\"slider\" with aria-valuenow in degrees and a text equivalent.",
944
1222
  "crystal": "Track and thumb material, focus ring, motion on commit",
945
1223
  "product": "Range, step, what the angle means",
1224
+ "motion": [
1225
+ "slider-step"
1226
+ ],
946
1227
  "parity": [
947
1228
  "mantine:AngleSlider"
948
1229
  ]
@@ -958,10 +1239,16 @@
958
1239
  "disabled"
959
1240
  ],
960
1241
  "material": "Resin body with a Haze value arc",
1242
+ "surface": [
1243
+ "none"
1244
+ ],
961
1245
  "geometry": "Circular; keyboard steps match the slider contract.",
962
1246
  "semantics": "role=\"slider\"; the value is readable as text, not only as an arc.",
963
1247
  "crystal": "Material, arc rendering, focus ring",
964
1248
  "product": "Range, step, formatting",
1249
+ "motion": [
1250
+ "slider-step"
1251
+ ],
965
1252
  "parity": [
966
1253
  "primereact:knob"
967
1254
  ]
@@ -977,10 +1264,18 @@
977
1264
  "disabled"
978
1265
  ],
979
1266
  "material": "Haze field fill inside a Resin shell",
1267
+ "surface": [
1268
+ "field"
1269
+ ],
980
1270
  "geometry": "Matches the text field exactly.",
981
1271
  "semantics": "The mask never traps a screen reader; the raw value is what submits.",
982
1272
  "crystal": "Shell material, focus ring, invalid motion",
983
1273
  "product": "Mask pattern and raw-value policy",
1274
+ "motion": [
1275
+ "field-focus",
1276
+ "field-invalid",
1277
+ "field-valid"
1278
+ ],
984
1279
  "parity": [
985
1280
  "mantine:MaskInput",
986
1281
  "primereact:inputmask"
@@ -997,10 +1292,18 @@
997
1292
  "disabled"
998
1293
  ],
999
1294
  "material": "Haze field fill inside a Resin shell",
1295
+ "surface": [
1296
+ "field"
1297
+ ],
1000
1298
  "geometry": "Monospace; matches the textarea otherwise.",
1001
1299
  "semantics": "Parse errors are described in text and associated with the field.",
1002
1300
  "crystal": "Material, invalid state, error surface",
1003
1301
  "product": "Schema and formatting rules",
1302
+ "motion": [
1303
+ "field-focus",
1304
+ "field-invalid",
1305
+ "field-valid"
1306
+ ],
1004
1307
  "parity": [
1005
1308
  "mantine:JsonInput"
1006
1309
  ]
@@ -1016,10 +1319,14 @@
1016
1319
  "disabled"
1017
1320
  ],
1018
1321
  "material": "Resin thumb over the gradient field",
1322
+ "surface": [
1323
+ "none"
1324
+ ],
1019
1325
  "geometry": "Thumb reaches 44px including its hit area.",
1020
1326
  "semantics": "Two linked sliders; each axis announces its own value and responds to arrow keys.",
1021
1327
  "crystal": "Thumb material, focus ring, contrast of the thumb against any underlying colour",
1022
1328
  "product": "Colour space and value",
1329
+ "motion": [],
1023
1330
  "parity": [
1024
1331
  "react-aria:ColorArea"
1025
1332
  ]
@@ -1035,10 +1342,14 @@
1035
1342
  "disabled"
1036
1343
  ],
1037
1344
  "material": "Resin thumb on a gradient track",
1345
+ "surface": [
1346
+ "none"
1347
+ ],
1038
1348
  "geometry": "Matches the slider contract.",
1039
1349
  "semantics": "role=\"slider\" with the channel named and the value in that channel's units.",
1040
1350
  "crystal": "Thumb and track material, focus ring",
1041
1351
  "product": "Which channel, and the colour space",
1352
+ "motion": [],
1042
1353
  "parity": [
1043
1354
  "react-aria:ColorSlider"
1044
1355
  ]
@@ -1054,10 +1365,14 @@
1054
1365
  "disabled"
1055
1366
  ],
1056
1367
  "material": "Resin thumb on the hue ring",
1368
+ "surface": [
1369
+ "none"
1370
+ ],
1057
1371
  "geometry": "Ring thickness is a declared proportion of the radius.",
1058
1372
  "semantics": "role=\"slider\" in degrees, wrapping at 360.",
1059
1373
  "crystal": "Thumb material, ring geometry, focus ring",
1060
1374
  "product": "Colour space",
1375
+ "motion": [],
1061
1376
  "parity": [
1062
1377
  "react-aria:ColorWheel"
1063
1378
  ]
@@ -1072,10 +1387,16 @@
1072
1387
  "focus-visible"
1073
1388
  ],
1074
1389
  "material": "Haze chequerboard beneath a transparent colour",
1390
+ "surface": [
1391
+ "none"
1392
+ ],
1075
1393
  "geometry": "Content radius; selection is a ring, never a check mark.",
1076
1394
  "semantics": "Carries the colour name as text, because colour cannot be the only carrier.",
1077
1395
  "crystal": "Transparency treatment, selection ring, contrast",
1078
1396
  "product": "The colour and its name",
1397
+ "motion": [
1398
+ "selection"
1399
+ ],
1079
1400
  "parity": [
1080
1401
  "react-aria:ColorSwatch"
1081
1402
  ]
@@ -1090,10 +1411,16 @@
1090
1411
  "focus-visible"
1091
1412
  ],
1092
1413
  "material": "Inherits from its swatches",
1414
+ "surface": [
1415
+ "none"
1416
+ ],
1093
1417
  "geometry": "Grid gap follows the spacing scale.",
1094
1418
  "semantics": "A listbox of swatches; arrow keys move, and the selected one is announced by name.",
1095
1419
  "crystal": "Selection rendering, focus order",
1096
1420
  "product": "The palette offered",
1421
+ "motion": [
1422
+ "selection"
1423
+ ],
1097
1424
  "parity": [
1098
1425
  "react-aria:ColorSwatchPicker"
1099
1426
  ]
@@ -1109,10 +1436,21 @@
1109
1436
  "disabled"
1110
1437
  ],
1111
1438
  "material": "Haze field fill; tokens are Haze chips",
1439
+ "surface": [
1440
+ "field",
1441
+ "compact"
1442
+ ],
1112
1443
  "geometry": "Field keeps the content radius; tokens are pills.",
1113
1444
  "semantics": "Each token is removable by keyboard and announces its removal; the field keeps its own value.",
1114
1445
  "crystal": "Token material, add and remove motion, focus return after removal",
1115
1446
  "product": "What may be tokenised, and duplicate policy",
1447
+ "motion": [
1448
+ "field-focus",
1449
+ "field-invalid",
1450
+ "field-valid",
1451
+ "list-in",
1452
+ "list-out"
1453
+ ],
1116
1454
  "parity": [
1117
1455
  "react-aria:TokenField",
1118
1456
  "mantine:PillsInput"
@@ -1131,10 +1469,19 @@
1131
1469
  "focus-visible"
1132
1470
  ],
1133
1471
  "material": "Resin control with Haze file rows",
1472
+ "surface": [
1473
+ "control",
1474
+ "haze"
1475
+ ],
1134
1476
  "geometry": "Rows keep the content radius; the trigger is a pill.",
1135
1477
  "semantics": "Progress is announced politely; a failure is announced assertively and is retryable by keyboard.",
1136
1478
  "crystal": "Materials, progress rendering, status colour from the status tokens, retry affordance",
1137
1479
  "product": "Transport, chunking, retry policy, accepted types",
1480
+ "motion": [
1481
+ "list-in",
1482
+ "list-out",
1483
+ "progress-change"
1484
+ ],
1138
1485
  "parity": [
1139
1486
  "primereact:fileupload",
1140
1487
  "antd:Upload"
@@ -1152,10 +1499,17 @@
1152
1499
  "focus-visible"
1153
1500
  ],
1154
1501
  "material": "Haze fill with a dashed rim",
1502
+ "surface": [
1503
+ "haze"
1504
+ ],
1155
1505
  "geometry": "Content radius; the whole zone is a 44px-plus target.",
1156
1506
  "semantics": "Dragging is never the only route: the zone is also a button, and paste works. Rejections say why.",
1157
1507
  "crystal": "Drag-over material change, rejection surface, motion on drop",
1158
1508
  "product": "Accepted types, size limits, transport",
1509
+ "motion": [
1510
+ "drag-pickup",
1511
+ "drag-settle"
1512
+ ],
1159
1513
  "parity": [
1160
1514
  "react-aria:DropZone",
1161
1515
  "primereact:fileupload",