@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.
Files changed (55) hide show
  1. package/README.md +82 -23
  2. package/assets/core/preferences.d.ts +4 -4
  3. package/assets/core/preferences.js +4 -4
  4. package/assets/core/presets.d.ts +4 -3
  5. package/assets/core/presets.js +24 -18
  6. package/assets/core/spring.js +9 -10
  7. package/assets/core/state.js +7 -7
  8. package/assets/crystal.css +783 -288
  9. package/assets/crystal.d.ts +3 -3
  10. package/assets/crystal.js +100 -123
  11. package/assets/icons/heading-2.svg +1 -0
  12. package/assets/icons/heading-3.svg +1 -0
  13. package/assets/icons/heading-4.svg +1 -0
  14. package/assets/icons/link.svg +1 -0
  15. package/assets/icons/list-ordered.svg +1 -0
  16. package/assets/icons/list.svg +1 -0
  17. package/assets/icons/manifest.json +81 -2
  18. package/assets/icons/quote.svg +1 -0
  19. package/assets/icons/redo.svg +1 -0
  20. package/assets/icons/subscript.svg +1 -0
  21. package/assets/icons/undo.svg +1 -0
  22. package/assets/icons/unlink.svg +1 -0
  23. package/assets/motion.js +13 -12
  24. package/docs/accessibility.md +50 -54
  25. package/docs/adoption.md +33 -19
  26. package/docs/catalogue.md +113 -108
  27. package/docs/colors.md +67 -73
  28. package/docs/components.md +142 -66
  29. package/docs/icons.md +9 -3
  30. package/docs/materials.md +129 -117
  31. package/docs/motion-components.md +15 -15
  32. package/docs/motion.md +156 -158
  33. package/docs/principles.md +12 -12
  34. package/docs/tokens.md +129 -130
  35. package/engines.js +3 -3
  36. package/package.json +11 -3
  37. package/tokens/catalogue/01-layout.json +1 -1
  38. package/tokens/catalogue/02-navigation.json +4 -4
  39. package/tokens/catalogue/03-actions.json +2 -1
  40. package/tokens/catalogue/04-inputs.json +30 -22
  41. package/tokens/catalogue/05-data-display.json +9 -14
  42. package/tokens/catalogue/06-feedback.json +8 -6
  43. package/tokens/catalogue/07-overlays.json +4 -4
  44. package/tokens/catalogue/08-typography.json +12 -8
  45. package/tokens/catalogue/09-utility.json +1 -1
  46. package/tokens/catalogue/10-charts.json +7 -7
  47. package/tokens/catalogue/11-media.json +33 -20
  48. package/tokens/catalogue/12-commerce.json +4 -4
  49. package/tokens/catalogue/13-screens.json +2 -3
  50. package/tokens/catalogue/14-blocks.json +3 -3
  51. package/tokens/catalogue.json +176 -116
  52. package/tokens/crystal.tokens.json +6 -6
  53. package/tokens/motion-recipes.json +6 -6
  54. package/tokens/surface-recipes.json +3452 -0
  55. package/tokens/surfaces.json +48 -17
@@ -4,9 +4,9 @@ Crystal 2.0 is Meridian Digital's reusable design system, built out from the app
4
4
 
5
5
  ## Governing hierarchy
6
6
 
7
- **Plastic → Frost → Resin, from back to front, is Crystal’s defining invariant.** The user explicitly reaffirmed this priority on September 17, 2026. Product colors and layouts may vary; the hierarchy must remain recognizable. Plastic grounds the window, Frost forms the intermediate material layer, and Resin floats above it for functional controls. Haze reading wells live within the hierarchy for legibility; they are not a replacement theme or a competing fourth material identity.
7
+ **Plastic → Frost → Resin, from back to front, is Crystal's defining invariant.** The user reaffirmed this priority on September 17, 2026. Product colors and layouts may vary; the hierarchy must remain recognizable. Plastic grounds the window, Frost forms the intermediate material layer, and Resin floats above it for functional controls. Haze reading wells sit inside the hierarchy for legibility. They do not replace the theme and do not form a fourth material identity.
8
8
 
9
- Crystal names six materials: **Plastic, Frost, Resin, Haze, Stone, Mirage**. Haze fills reading surfaces; Stone protects labels within controls; Mirage separates modal decisions. The first three establish the main spatial hierarchy.
9
+ Crystal names six materials: Plastic, Frost, Resin, Haze, Stone, Mirage. Haze fills reading surfaces; Stone protects labels within controls; Mirage separates modal decisions. The first three establish the main spatial hierarchy.
10
10
 
11
11
  ## Shared identity, product freedom
12
12
 
@@ -34,30 +34,30 @@ Manrope is the shared default, bundled locally under its accompanying SIL Open F
34
34
 
35
35
  | Role | Size / line height | Weight | Use |
36
36
  |---|---|---|---|
37
- | Display | 36–50px / 1.08–1.2 | 750 | Product or section introduction; responsive |
38
- | Page title | 28–32px / 1.2 | 750 | Primary task context |
39
- | Section | 20–24px / 1.25 | 700 | Local hierarchy |
40
- | Reading | 16px / 24px | 400–500 | Messages, documents, sustained reading |
41
- | Control | 14–16px / 1.3–1.5 | 650–750 | Primary application controls |
42
- | Supporting | 12–14px / 1.5–1.7 | 500–650 | Metadata and short labels, never a replacement for reading type |
37
+ | Display | 36 to 50px / 1.08 to 1.2 | 750 | Product or section introduction; responsive |
38
+ | Page title | 28 to 32px / 1.2 | 750 | Primary task context |
39
+ | Section | 20 to 24px / 1.25 | 700 | Local hierarchy |
40
+ | Reading | 16px / 24px | 400 to 500 | Messages, documents, sustained reading |
41
+ | Control | 14 to 16px / 1.3 to 1.5 | 650 to 750 | Primary application controls |
42
+ | Supporting | 12 to 14px / 1.5 to 1.7 | 500 to 650 | Metadata and short labels, never a replacement for reading type |
43
43
 
44
- Respect user scaling. Do not cap text zoom or hide overflow to conceal clipped labels. Aim for 45–75 characters per line for sustained prose. Compact density reduces spacing, not reading size.
44
+ Respect user scaling. Do not cap text zoom or hide overflow to conceal clipped labels. Aim for 45 to 75 characters per line for sustained prose. Compact density reduces spacing and leaves reading size unchanged.
45
45
 
46
46
  ## Geometry, spacing and responsive layout
47
47
 
48
48
  Use a 4px base rhythm with 8, 12, 16, 20, 24, 32 and 48px spacing. The default content radius is 28px, adjustable between 14 and 28px. Supporting panels use content radius + 6px; input wells use content radius − 7px. Person avatars stay circular.
49
49
 
50
- **Actions are fully rounded.** Every action control — primary, secondary, quiet and compact buttons, segmented options, dock destinations and navigation pills — uses a pill radius (`999px`) independent of the content-radius control, so the radius slider never turns an action into a rectangle. Card-shaped buttons are the deliberate exception: a button whose content is a layout with artwork (specimen cards, palette cards, library items) keeps the content radius so its artwork is not clipped into a lozenge. The distinction is behavioral, not tag-based — it depends on whether the control reads as an action or as a card.
50
+ **Actions are fully rounded.** Every action control (primary, secondary, quiet and compact buttons, segmented options, dock destinations and navigation pills) uses a pill radius (`999px`) independent of the content-radius control, so the radius slider never turns an action into a rectangle. Card-shaped buttons are the exception: a button whose content is a layout with artwork (specimen cards, palette cards, library items) keeps the content radius so its artwork is not clipped into a lozenge. The distinction is behavioral: it depends on whether the control reads as an action or as a card, whatever its tag.
51
51
 
52
52
  An authored bubble uses 6 / R / R / R corners. A counterpart uses R / 6 / R / R; mirror the direction for RTL. Do not use asymmetric corners indiscriminately on controls.
53
53
 
54
- The playground moves its inspector below the canvas under 850px and stacks components under 600px. These are demonstration breakpoints, not universal product breakpoints. Product layouts should adapt to content and input modality, preserving navigation and avoiding horizontal page scroll at 320 CSS pixels.
54
+ The playground moves its inspector below the canvas under 850px and stacks components under 600px. These breakpoints belong to the demonstration. Product layouts should adapt to content and input modality, preserving navigation and avoiding horizontal page scroll at 320 CSS pixels.
55
55
 
56
56
  ## Icons and motion
57
57
 
58
58
  Use a coherent 24px icon grid, approximately 1.8px rounded strokes, visible labels for primary destinations, and accessible names for icon-only actions. The included SVGs are original simple line drawings. Do not rely on emoji as the only status or control vocabulary.
59
59
 
60
- Press feedback is 120ms, state feedback 213.33ms, compact spatial entrances 293.33ms and exits 160ms. Expressive material journeys use 1000–1400ms, 5–30px ordinary travel (50px compact guidance; larger spatial compositions may exceed it), in-place Haze/Stone movement and 650ms departures. A saved user speed factor scales motion, with a five-second ceiling and immediate reduced-motion states. The [motion specification](motion.html) defines all six material signatures, easing, interruption and live examples. Use motion in response to user action; no continuous decorative motion is required. Reduced motion removes spatial effects while retaining immediate state feedback.
60
+ Press feedback is 120ms, state feedback 213.33ms, compact spatial entrances 293.33ms and exits 160ms. Expressive material journeys use 1000 to 1400ms, 5 to 30px ordinary travel (50px compact guidance; larger spatial compositions may exceed it), in-place Haze/Stone movement and 650ms departures. A saved user speed factor scales motion, with a five-second ceiling and immediate reduced-motion states. The [motion specification](motion.html) defines all six material signatures, easing, interruption and live examples. Use motion in response to user action; no continuous decorative motion is required. Reduced motion removes spatial effects while retaining immediate state feedback.
61
61
 
62
62
  ## System boundaries
63
63
 
package/docs/tokens.md CHANGED
@@ -1,28 +1,28 @@
1
1
  # Tokens
2
2
 
3
- Every value Crystal ships, generated from `core/tokens/crystal.tokens.json` — the W3C
3
+ Every value Crystal ships, generated from `core/tokens/crystal.tokens.json`, the W3C
4
4
  Design Tokens (DTCG) source of truth. This page is written by
5
- `tools/build-reference.cjs`; editing it by hand is pointless, because the next build
6
- overwrites it. Edit the token file and run `npm run build`.
5
+ `tools/build-reference.cjs`, and the next build overwrites any edit made here by hand.
6
+ Edit the token file and run `npm run build`.
7
7
 
8
8
  ## How the three tiers work
9
9
 
10
- Crystal resolves a value through three tiers, and the direction is strictly one way:
10
+ Crystal resolves a value through three tiers, and the direction is one way only:
11
11
  a component reads a semantic token, a semantic token reads a primitive, and nothing
12
- reads upward. That is what makes a palette swap a change to one tier rather than a
13
- search across the codebase.
12
+ reads upward. A palette swap is therefore a change to one tier, with no search
13
+ across the codebase.
14
14
 
15
15
  ```
16
16
  component.action.radius → semantic.shape.pill → primitive.distance.full
17
17
  ```
18
18
 
19
- **A component that reads a primitive directly is a bug.** It works, and it silently
20
- opts that component out of every theme, mode and palette change made at the semantic
21
- tier. `tools/validate-tokens.cjs` checks the direction of every reference.
19
+ **A component that reads a primitive directly is a bug.** It works, and it opts that
20
+ component out of every theme, mode and palette change made at the semantic tier.
21
+ `tools/validate-tokens.cjs` checks the direction of every reference.
22
22
 
23
23
  ## Primitive tokens
24
24
 
25
- Raw values. Never referenced by a component directly — a primitive is the thing a semantic token points at, so that the meaning can be re-pointed without editing every use site.
25
+ Raw values. A component never references a primitive directly: a primitive is what a semantic token points at, so the meaning can be re-pointed without editing every use site.
26
26
 
27
27
  213 tokens.
28
28
 
@@ -30,9 +30,9 @@ Raw values. Never referenced by a component directly — a primitive is the thin
30
30
 
31
31
  | Token | Type | Value | Meaning |
32
32
  | --- | --- | --- | --- |
33
- | `primitive.palette.prism.seed` | color | `#7338EF` | — |
34
- | `primitive.palette.prism.companion` | color | `#EF48C6` | — |
35
- | `primitive.palette.prism.glow` | color | `#52BDF3` | — |
33
+ | `primitive.palette.prism.seed` | color | `#7338EF` | None |
34
+ | `primitive.palette.prism.companion` | color | `#EF48C6` | None |
35
+ | `primitive.palette.prism.glow` | color | `#52BDF3` | None |
36
36
  | `primitive.palette.prism.light.canvas` | color | `#f9f6fe` | Foundation behind every surface |
37
37
  | `primitive.palette.prism.light.surface` | color | `#ffffff` | Opaque reading surface |
38
38
  | `primitive.palette.prism.light.surfaceAlt` | color | `#f2edfe` | Secondary reading surface |
@@ -59,9 +59,9 @@ Raw values. Never referenced by a component directly — a primitive is the thin
59
59
  | `primitive.palette.prism.dark.decorative` | color | `#7e48f0` | Atmosphere and decorative light |
60
60
  | `primitive.palette.prism.dark.companion` | color | `#EF48C6` | Paired atmosphere colour |
61
61
  | `primitive.palette.prism.dark.glow` | color | `#52BDF3` | Highlight light |
62
- | `primitive.palette.fuchsia.seed` | color | `#C01993` | — |
63
- | `primitive.palette.fuchsia.companion` | color | `#7C4DFF` | — |
64
- | `primitive.palette.fuchsia.glow` | color | `#FF96DA` | — |
62
+ | `primitive.palette.fuchsia.seed` | color | `#C01993` | None |
63
+ | `primitive.palette.fuchsia.companion` | color | `#7C4DFF` | None |
64
+ | `primitive.palette.fuchsia.glow` | color | `#FF96DA` | None |
65
65
  | `primitive.palette.fuchsia.light.canvas` | color | `#fcf5fa` | Foundation behind every surface |
66
66
  | `primitive.palette.fuchsia.light.surface` | color | `#ffffff` | Opaque reading surface |
67
67
  | `primitive.palette.fuchsia.light.surfaceAlt` | color | `#f9eaf5` | Secondary reading surface |
@@ -88,9 +88,9 @@ Raw values. Never referenced by a component directly — a primitive is the thin
88
88
  | `primitive.palette.fuchsia.dark.decorative` | color | `#c52b9c` | Atmosphere and decorative light |
89
89
  | `primitive.palette.fuchsia.dark.companion` | color | `#7C4DFF` | Paired atmosphere colour |
90
90
  | `primitive.palette.fuchsia.dark.glow` | color | `#FF96DA` | Highlight light |
91
- | `primitive.palette.cobalt.seed` | color | `#2758E8` | — |
92
- | `primitive.palette.cobalt.companion` | color | `#6D47F2` | — |
93
- | `primitive.palette.cobalt.glow` | color | `#48C6F0` | — |
91
+ | `primitive.palette.cobalt.seed` | color | `#2758E8` | None |
92
+ | `primitive.palette.cobalt.companion` | color | `#6D47F2` | None |
93
+ | `primitive.palette.cobalt.glow` | color | `#48C6F0` | None |
94
94
  | `primitive.palette.cobalt.light.canvas` | color | `#f5f7fe` | Foundation behind every surface |
95
95
  | `primitive.palette.cobalt.light.surface` | color | `#ffffff` | Opaque reading surface |
96
96
  | `primitive.palette.cobalt.light.surfaceAlt` | color | `#ecf0fd` | Secondary reading surface |
@@ -117,9 +117,9 @@ Raw values. Never referenced by a component directly — a primitive is the thin
117
117
  | `primitive.palette.cobalt.dark.decorative` | color | `#3865ea` | Atmosphere and decorative light |
118
118
  | `primitive.palette.cobalt.dark.companion` | color | `#6D47F2` | Paired atmosphere colour |
119
119
  | `primitive.palette.cobalt.dark.glow` | color | `#48C6F0` | Highlight light |
120
- | `primitive.palette.ion.seed` | color | `#007E97` | — |
121
- | `primitive.palette.ion.companion` | color | `#3D45E5` | — |
122
- | `primitive.palette.ion.glow` | color | `#36DCD1` | — |
120
+ | `primitive.palette.ion.seed` | color | `#007E97` | None |
121
+ | `primitive.palette.ion.companion` | color | `#3D45E5` | None |
122
+ | `primitive.palette.ion.glow` | color | `#36DCD1` | None |
123
123
  | `primitive.palette.ion.light.canvas` | color | `#f4f9fa` | Foundation behind every surface |
124
124
  | `primitive.palette.ion.light.surface` | color | `#ffffff` | Opaque reading surface |
125
125
  | `primitive.palette.ion.light.surfaceAlt` | color | `#e8f3f6` | Secondary reading surface |
@@ -146,9 +146,9 @@ Raw values. Never referenced by a component directly — a primitive is the thin
146
146
  | `primitive.palette.ion.dark.decorative` | color | `#14889f` | Atmosphere and decorative light |
147
147
  | `primitive.palette.ion.dark.companion` | color | `#3D45E5` | Paired atmosphere colour |
148
148
  | `primitive.palette.ion.dark.glow` | color | `#36DCD1` | Highlight light |
149
- | `primitive.palette.amethyst.seed` | color | `#8430C6` | — |
150
- | `primitive.palette.amethyst.companion` | color | `#CE49B2` | — |
151
- | `primitive.palette.amethyst.glow` | color | `#9198FF` | — |
149
+ | `primitive.palette.amethyst.seed` | color | `#8430C6` | None |
150
+ | `primitive.palette.amethyst.companion` | color | `#CE49B2` | None |
151
+ | `primitive.palette.amethyst.glow` | color | `#9198FF` | None |
152
152
  | `primitive.palette.amethyst.light.canvas` | color | `#f9f6fc` | Foundation behind every surface |
153
153
  | `primitive.palette.amethyst.light.surface` | color | `#ffffff` | Opaque reading surface |
154
154
  | `primitive.palette.amethyst.light.surfaceAlt` | color | `#f4ecfa` | Secondary reading surface |
@@ -175,9 +175,9 @@ Raw values. Never referenced by a component directly — a primitive is the thin
175
175
  | `primitive.palette.amethyst.dark.decorative` | color | `#8e41cb` | Atmosphere and decorative light |
176
176
  | `primitive.palette.amethyst.dark.companion` | color | `#CE49B2` | Paired atmosphere colour |
177
177
  | `primitive.palette.amethyst.dark.glow` | color | `#9198FF` | Highlight light |
178
- | `primitive.palette.harbor.seed` | color | `#4669B2` | — |
179
- | `primitive.palette.harbor.companion` | color | `#8970B5` | — |
180
- | `primitive.palette.harbor.glow` | color | `#72C4DF` | — |
178
+ | `primitive.palette.harbor.seed` | color | `#4669B2` | None |
179
+ | `primitive.palette.harbor.companion` | color | `#8970B5` | None |
180
+ | `primitive.palette.harbor.glow` | color | `#72C4DF` | None |
181
181
  | `primitive.palette.harbor.light.canvas` | color | `#faf8fe` | Foundation behind every surface |
182
182
  | `primitive.palette.harbor.light.surface` | color | `#ffffff` | Opaque reading surface |
183
183
  | `primitive.palette.harbor.light.surfaceAlt` | color | `#e7e7f1` | Secondary reading surface |
@@ -204,69 +204,69 @@ Raw values. Never referenced by a component directly — a primitive is the thin
204
204
  | `primitive.palette.harbor.dark.decorative` | color | `#4669B2` | Atmosphere and decorative light |
205
205
  | `primitive.palette.harbor.dark.companion` | color | `#8970B5` | Paired atmosphere colour |
206
206
  | `primitive.palette.harbor.dark.glow` | color | `#72C4DF` | Highlight light |
207
- | `primitive.palette.harbor.dark.contentOwnSurface` | color | `#283c60` | — |
207
+ | `primitive.palette.harbor.dark.contentOwnSurface` | color | `#283c60` | None |
208
208
 
209
209
  ### Primitive · material
210
210
 
211
211
  | Token | Type | Value | Meaning |
212
212
  | --- | --- | --- | --- |
213
- | `primitive.material.acrylicBlur` | dimension | `40px` | — |
214
- | `primitive.material.acrylicSaturation` | number | `125` | — |
215
- | `primitive.material.glassBlur` | dimension | `20px` | — |
216
- | `primitive.material.glassSaturation` | number | `165` | — |
217
- | `primitive.material.glassOpacity` | number | `0.2` | — |
218
- | `primitive.material.grainOpacity` | number | `0.045` | — |
219
- | `primitive.material.labelVeil` | number | `0.55` | — |
220
- | `primitive.material.labelVeilDark` | number | `0.6` | — |
221
- | `primitive.material.contentOpacity` | number | `0.8` | — |
222
- | `primitive.material.contentFeather` | dimension | `1.95px` | — |
223
- | `primitive.material.stoneFeather` | dimension | `1.95px` | — |
224
- | `primitive.material.mirageColor` | color | `#111525` | — |
225
- | `primitive.material.mirageOpacity` | number | `0.38` | — |
226
- | `primitive.material.mirageBlur` | dimension | `28px` | — |
227
- | `primitive.material.mirageSaturation` | number | `165` | — |
228
- | `primitive.material.mirageBrightness` | number | `88` | — |
229
- | `primitive.material.mirageFallbackOpacity` | number | `0.64` | — |
230
- | `primitive.material.plasticInactive.light` | color | `#f1f1f3` | — |
231
- | `primitive.material.plasticInactive.dark` | color | `#202126` | — |
213
+ | `primitive.material.acrylicBlur` | dimension | `40px` | None |
214
+ | `primitive.material.acrylicSaturation` | number | `125` | None |
215
+ | `primitive.material.glassBlur` | dimension | `20px` | None |
216
+ | `primitive.material.glassSaturation` | number | `165` | None |
217
+ | `primitive.material.glassOpacity` | number | `0.2` | None |
218
+ | `primitive.material.grainOpacity` | number | `0.045` | None |
219
+ | `primitive.material.labelVeil` | number | `0.55` | None |
220
+ | `primitive.material.labelVeilDark` | number | `0.6` | None |
221
+ | `primitive.material.contentOpacity` | number | `0.8` | None |
222
+ | `primitive.material.contentFeather` | dimension | `1.95px` | None |
223
+ | `primitive.material.stoneFeather` | dimension | `1.95px` | None |
224
+ | `primitive.material.mirageColor` | color | `#111525` | None |
225
+ | `primitive.material.mirageOpacity` | number | `0.38` | None |
226
+ | `primitive.material.mirageBlur` | dimension | `28px` | None |
227
+ | `primitive.material.mirageSaturation` | number | `165` | None |
228
+ | `primitive.material.mirageBrightness` | number | `88` | None |
229
+ | `primitive.material.mirageFallbackOpacity` | number | `0.64` | None |
230
+ | `primitive.material.plasticInactive.light` | color | `#f1f1f3` | None |
231
+ | `primitive.material.plasticInactive.dark` | color | `#202126` | None |
232
232
 
233
233
  ### Primitive · duration
234
234
 
235
235
  | Token | Type | Value | Meaning |
236
236
  | --- | --- | --- | --- |
237
- | `primitive.duration.press` | duration | `120ms` | — |
238
- | `primitive.duration.state` | duration | `213.33ms` | — |
239
- | `primitive.duration.spatial` | duration | `293.33ms` | — |
240
- | `primitive.duration.exit` | duration | `160ms` | — |
241
- | `primitive.duration.material` | duration | `1000ms` | — |
242
- | `primitive.duration.liquid` | duration | `1400ms` | — |
243
- | `primitive.duration.flow` | duration | `1200ms` | — |
244
- | `primitive.duration.departure` | duration | `650ms` | — |
245
- | `primitive.duration.maxDuration` | duration | `5000ms` | — |
237
+ | `primitive.duration.press` | duration | `120ms` | None |
238
+ | `primitive.duration.state` | duration | `213.33ms` | None |
239
+ | `primitive.duration.spatial` | duration | `293.33ms` | None |
240
+ | `primitive.duration.exit` | duration | `160ms` | None |
241
+ | `primitive.duration.material` | duration | `1000ms` | None |
242
+ | `primitive.duration.liquid` | duration | `1400ms` | None |
243
+ | `primitive.duration.flow` | duration | `1200ms` | None |
244
+ | `primitive.duration.departure` | duration | `650ms` | None |
245
+ | `primitive.duration.maxDuration` | duration | `5000ms` | None |
246
246
 
247
247
  ### Primitive · distance
248
248
 
249
249
  | Token | Type | Value | Meaning |
250
250
  | --- | --- | --- | --- |
251
- | `primitive.distance.panel` | dimension | `24px` | — |
252
- | `primitive.distance.floating` | dimension | `30px` | — |
253
- | `primitive.distance.content` | dimension | `0px` | — |
254
- | `primitive.distance.exit` | dimension | `20px` | — |
255
- | `primitive.distance.depth` | dimension | `50px` | — |
256
- | `primitive.distance.feather` | dimension | `6px` | — |
257
- | `primitive.distance.maxTravel` | dimension | `50px` | — |
251
+ | `primitive.distance.panel` | dimension | `24px` | None |
252
+ | `primitive.distance.floating` | dimension | `30px` | None |
253
+ | `primitive.distance.content` | dimension | `0px` | None |
254
+ | `primitive.distance.exit` | dimension | `20px` | None |
255
+ | `primitive.distance.depth` | dimension | `50px` | None |
256
+ | `primitive.distance.feather` | dimension | `6px` | None |
257
+ | `primitive.distance.maxTravel` | dimension | `50px` | None |
258
258
 
259
259
  ### Primitive · easing
260
260
 
261
261
  | Token | Type | Value | Meaning |
262
262
  | --- | --- | --- | --- |
263
- | `primitive.easing.enter` | cubicBezier | `cubic-bezier(0.22, 0.65, 0.22, 1)` | — |
264
- | `primitive.easing.settle` | cubicBezier | `cubic-bezier(0.2, 0, 0.2, 1)` | — |
265
- | `primitive.easing.exit` | cubicBezier | `cubic-bezier(0.4, 0, 0.6, 1)` | — |
263
+ | `primitive.easing.enter` | cubicBezier | `cubic-bezier(0.22, 0.65, 0.22, 1)` | None |
264
+ | `primitive.easing.settle` | cubicBezier | `cubic-bezier(0.2, 0, 0.2, 1)` | None |
265
+ | `primitive.easing.exit` | cubicBezier | `cubic-bezier(0.4, 0, 0.6, 1)` | None |
266
266
 
267
267
  ## Semantic tokens
268
268
 
269
- What a value *means*: the surface a card sits on, the duration a control settles over. Components consume this tier and nothing below it.
269
+ What a value means: the surface a card sits on, the duration a control settles over. Components consume this tier and nothing below it.
270
270
 
271
271
  114 tokens.
272
272
 
@@ -298,70 +298,70 @@ What a value *means*: the surface a card sits on, the duration a control settles
298
298
 
299
299
  | Token | Type | Value | Meaning |
300
300
  | --- | --- | --- | --- |
301
- | `semantic.feedback.light.success.ink` | color | `#175D38` | — |
302
- | `semantic.feedback.light.success.surface` | color | `#E5F4EA` | — |
301
+ | `semantic.feedback.light.success.ink` | color | `#175D38` | None |
302
+ | `semantic.feedback.light.success.surface` | color | `#E5F4EA` | None |
303
303
  | `semantic.feedback.light.success.symbol` | string | `✓` | Carries meaning without colour. A check mark means validated or informational, never selected. |
304
- | `semantic.feedback.light.success.label` | string | `Ready` | — |
305
- | `semantic.feedback.light.attention.ink` | color | `#714B00` | — |
306
- | `semantic.feedback.light.attention.surface` | color | `#FFF0CD` | — |
304
+ | `semantic.feedback.light.success.label` | string | `Ready` | None |
305
+ | `semantic.feedback.light.attention.ink` | color | `#714B00` | None |
306
+ | `semantic.feedback.light.attention.surface` | color | `#FFF0CD` | None |
307
307
  | `semantic.feedback.light.attention.symbol` | string | `△` | Carries meaning without colour. A check mark means validated or informational, never selected. |
308
- | `semantic.feedback.light.attention.label` | string | `Review needed` | — |
309
- | `semantic.feedback.light.danger.ink` | color | `#941D36` | — |
310
- | `semantic.feedback.light.danger.surface` | color | `#FFE8EC` | — |
308
+ | `semantic.feedback.light.attention.label` | string | `Review needed` | None |
309
+ | `semantic.feedback.light.danger.ink` | color | `#941D36` | None |
310
+ | `semantic.feedback.light.danger.surface` | color | `#FFE8EC` | None |
311
311
  | `semantic.feedback.light.danger.symbol` | string | `!` | Carries meaning without colour. A check mark means validated or informational, never selected. |
312
- | `semantic.feedback.light.danger.label` | string | `Action blocked` | — |
313
- | `semantic.feedback.light.info.ink` | color | `#334155` | — |
314
- | `semantic.feedback.light.info.surface` | color | `#E8EDF4` | — |
312
+ | `semantic.feedback.light.danger.label` | string | `Action blocked` | None |
313
+ | `semantic.feedback.light.info.ink` | color | `#334155` | None |
314
+ | `semantic.feedback.light.info.surface` | color | `#E8EDF4` | None |
315
315
  | `semantic.feedback.light.info.symbol` | string | `i` | Carries meaning without colour. A check mark means validated or informational, never selected. |
316
- | `semantic.feedback.light.info.label` | string | `Information` | — |
317
- | `semantic.feedback.dark.success.ink` | color | `#9BE2B3` | — |
318
- | `semantic.feedback.dark.success.surface` | color | `#173525` | — |
316
+ | `semantic.feedback.light.info.label` | string | `Information` | None |
317
+ | `semantic.feedback.dark.success.ink` | color | `#9BE2B3` | None |
318
+ | `semantic.feedback.dark.success.surface` | color | `#173525` | None |
319
319
  | `semantic.feedback.dark.success.symbol` | string | `✓` | Carries meaning without colour. A check mark means validated or informational, never selected. |
320
- | `semantic.feedback.dark.success.label` | string | `Ready` | — |
321
- | `semantic.feedback.dark.attention.ink` | color | `#FFDA8A` | — |
322
- | `semantic.feedback.dark.attention.surface` | color | `#3D2D0E` | — |
320
+ | `semantic.feedback.dark.success.label` | string | `Ready` | None |
321
+ | `semantic.feedback.dark.attention.ink` | color | `#FFDA8A` | None |
322
+ | `semantic.feedback.dark.attention.surface` | color | `#3D2D0E` | None |
323
323
  | `semantic.feedback.dark.attention.symbol` | string | `△` | Carries meaning without colour. A check mark means validated or informational, never selected. |
324
- | `semantic.feedback.dark.attention.label` | string | `Review needed` | — |
325
- | `semantic.feedback.dark.danger.ink` | color | `#FFB2C0` | — |
326
- | `semantic.feedback.dark.danger.surface` | color | `#481C29` | — |
324
+ | `semantic.feedback.dark.attention.label` | string | `Review needed` | None |
325
+ | `semantic.feedback.dark.danger.ink` | color | `#FFB2C0` | None |
326
+ | `semantic.feedback.dark.danger.surface` | color | `#481C29` | None |
327
327
  | `semantic.feedback.dark.danger.symbol` | string | `!` | Carries meaning without colour. A check mark means validated or informational, never selected. |
328
- | `semantic.feedback.dark.danger.label` | string | `Action blocked` | — |
329
- | `semantic.feedback.dark.info.ink` | color | `#D2DCEC` | — |
330
- | `semantic.feedback.dark.info.surface` | color | `#263244` | — |
328
+ | `semantic.feedback.dark.danger.label` | string | `Action blocked` | None |
329
+ | `semantic.feedback.dark.info.ink` | color | `#D2DCEC` | None |
330
+ | `semantic.feedback.dark.info.surface` | color | `#263244` | None |
331
331
  | `semantic.feedback.dark.info.symbol` | string | `i` | Carries meaning without colour. A check mark means validated or informational, never selected. |
332
- | `semantic.feedback.dark.info.label` | string | `Information` | — |
332
+ | `semantic.feedback.dark.info.label` | string | `Information` | None |
333
333
 
334
334
  ### Semantic · motion
335
335
 
336
336
  | Token | Type | Value | Meaning |
337
337
  | --- | --- | --- | --- |
338
- | `semantic.motion.duration.press` | duration | `{primitive.duration.press}` | — |
339
- | `semantic.motion.duration.state` | duration | `{primitive.duration.state}` | — |
340
- | `semantic.motion.duration.spatial` | duration | `{primitive.duration.spatial}` | — |
341
- | `semantic.motion.duration.exit` | duration | `{primitive.duration.exit}` | — |
342
- | `semantic.motion.duration.material` | duration | `{primitive.duration.material}` | — |
343
- | `semantic.motion.duration.liquid` | duration | `{primitive.duration.liquid}` | — |
344
- | `semantic.motion.duration.flow` | duration | `{primitive.duration.flow}` | — |
345
- | `semantic.motion.duration.departure` | duration | `{primitive.duration.departure}` | — |
338
+ | `semantic.motion.duration.press` | duration | `{primitive.duration.press}` | None |
339
+ | `semantic.motion.duration.state` | duration | `{primitive.duration.state}` | None |
340
+ | `semantic.motion.duration.spatial` | duration | `{primitive.duration.spatial}` | None |
341
+ | `semantic.motion.duration.exit` | duration | `{primitive.duration.exit}` | None |
342
+ | `semantic.motion.duration.material` | duration | `{primitive.duration.material}` | None |
343
+ | `semantic.motion.duration.liquid` | duration | `{primitive.duration.liquid}` | None |
344
+ | `semantic.motion.duration.flow` | duration | `{primitive.duration.flow}` | None |
345
+ | `semantic.motion.duration.departure` | duration | `{primitive.duration.departure}` | None |
346
346
  | `semantic.motion.duration.ceiling` | duration | `{primitive.duration.maxDuration}` | Hard ceiling for any single animation, including replay-rate adjustment |
347
- | `semantic.motion.easing.enter` | cubicBezier | `{primitive.easing.enter}` | — |
348
- | `semantic.motion.easing.settle` | cubicBezier | `{primitive.easing.settle}` | — |
349
- | `semantic.motion.easing.exit` | cubicBezier | `{primitive.easing.exit}` | — |
350
- | `semantic.motion.travel.panel` | dimension | `{primitive.distance.panel}` | — |
351
- | `semantic.motion.travel.floating` | dimension | `{primitive.distance.floating}` | — |
352
- | `semantic.motion.travel.content` | dimension | `{primitive.distance.content}` | — |
353
- | `semantic.motion.travel.exit` | dimension | `{primitive.distance.exit}` | — |
354
- | `semantic.motion.travel.depth` | dimension | `{primitive.distance.depth}` | — |
355
- | `semantic.motion.travel.feather` | dimension | `{primitive.distance.feather}` | — |
356
- | `semantic.motion.travel.max` | dimension | `{primitive.distance.maxTravel}` | — |
347
+ | `semantic.motion.easing.enter` | cubicBezier | `{primitive.easing.enter}` | None |
348
+ | `semantic.motion.easing.settle` | cubicBezier | `{primitive.easing.settle}` | None |
349
+ | `semantic.motion.easing.exit` | cubicBezier | `{primitive.easing.exit}` | None |
350
+ | `semantic.motion.travel.panel` | dimension | `{primitive.distance.panel}` | None |
351
+ | `semantic.motion.travel.floating` | dimension | `{primitive.distance.floating}` | None |
352
+ | `semantic.motion.travel.content` | dimension | `{primitive.distance.content}` | None |
353
+ | `semantic.motion.travel.exit` | dimension | `{primitive.distance.exit}` | None |
354
+ | `semantic.motion.travel.depth` | dimension | `{primitive.distance.depth}` | None |
355
+ | `semantic.motion.travel.feather` | dimension | `{primitive.distance.feather}` | None |
356
+ | `semantic.motion.travel.max` | dimension | `{primitive.distance.maxTravel}` | None |
357
357
 
358
358
  ### Semantic · typography
359
359
 
360
360
  | Token | Type | Value | Meaning |
361
361
  | --- | --- | --- | --- |
362
- | `semantic.typography.family` | fontFamily | `Manrope` | — |
363
- | `semantic.typography.readingSize` | dimension | `16px` | — |
364
- | `semantic.typography.readingLeading` | dimension | `24px` | — |
362
+ | `semantic.typography.family` | fontFamily | `Manrope` | None |
363
+ | `semantic.typography.readingSize` | dimension | `16px` | None |
364
+ | `semantic.typography.readingLeading` | dimension | `24px` | None |
365
365
  | `semantic.typography.scale.display.ratio` | number | `2` | display: multiple of the reading size |
366
366
  | `semantic.typography.scale.display.leading` | number | `1.1` | display: line height as a multiple of its own size |
367
367
  | `semantic.typography.scale.display.tracking` | dimension | `-0.055em` | display: letter spacing |
@@ -422,12 +422,12 @@ What a value *means*: the surface a card sits on, the duration a control settles
422
422
 
423
423
  | Token | Type | Value | Meaning |
424
424
  | --- | --- | --- | --- |
425
- | `semantic.default.palette` | string | `prism` | — |
426
- | `semantic.default.mode` | string | `light` | — |
427
- | `semantic.default.density` | string | `comfortable` | — |
428
- | `semantic.default.font` | string | `manrope` | — |
429
- | `semantic.default.reduced` | boolean | `false` | — |
430
- | `semantic.default.reduceMotion` | boolean | `false` | — |
425
+ | `semantic.default.palette` | string | `prism` | None |
426
+ | `semantic.default.mode` | string | `light` | None |
427
+ | `semantic.default.density` | string | `comfortable` | None |
428
+ | `semantic.default.font` | string | `manrope` | None |
429
+ | `semantic.default.reduced` | boolean | `false` | None |
430
+ | `semantic.default.reduceMotion` | boolean | `false` | None |
431
431
 
432
432
  ## Component tokens
433
433
 
@@ -538,14 +538,14 @@ Values that belong to one component family and would be wrong to reuse elsewhere
538
538
  | Token | Type | Value | Meaning |
539
539
  | --- | --- | --- | --- |
540
540
  | `component.focus.coreWidth` | dimension | `2px` | Crisp focus core, never blurred |
541
- | `component.focus.coreOffset` | dimension | `3px` | — |
541
+ | `component.focus.coreOffset` | dimension | `3px` | None |
542
542
 
543
543
  ### Component · indicator
544
544
 
545
545
  | Token | Type | Value | Meaning |
546
546
  | --- | --- | --- | --- |
547
547
  | `component.indicator.size` | dimension | `20px` | Circular state badge |
548
- | `component.indicator.fieldSize` | dimension | `24px` | — |
548
+ | `component.indicator.fieldSize` | dimension | `24px` | None |
549
549
  | `component.indicator.lineWidth` | dimension | `3px` | A line that marks: a drop target's rule, a selected swatch's ring, a quotation's leading rule |
550
550
 
551
551
  ### Component · anchor
@@ -570,22 +570,22 @@ Values that belong to one component family and would be wrong to reuse elsewhere
570
570
 
571
571
  | Token | Type | Value | Meaning |
572
572
  | --- | --- | --- | --- |
573
- | `component.chart.seriesCount` | number | `6` | How many categorical series the palette can tell apart by colour. A seventh series repeats the first colour and must differ by another channel — a dash pattern, a fill pattern or a marker shape — because six hues is where perceptual separation runs out, not where charts do. |
573
+ | `component.chart.seriesCount` | number | `6` | How many categorical series the palette can tell apart by colour. A seventh series repeats the first colour and must differ by another channel, such as a dash pattern, a fill pattern or a marker shape. Six hues is where perceptual separation runs out, and charts often need more. |
574
574
  | `component.chart.seriesLightness.light` | number | `0.55` | OKLab lightness every light-mode series colour is drawn at. One lightness for all six is what makes them read as one family rather than a ramp: a categorical scale must not imply an order it does not have. |
575
- | `component.chart.seriesLightness.dark` | number | `0.72` | The same, for dark mode. Higher than light, because the ground is dark and a mark must be lighter than it — but not as high as the ground allows. At 0.80 sRGB can no longer hold the chroma at the violet and blue hues, the colours there go pale, and the first series of a violet palette lands on the same colour as the palette's own action colour, which is a data mark that reads as a button. |
575
+ | `component.chart.seriesLightness.dark` | number | `0.72` | The same, for dark mode. Higher than light, because the ground is dark and a mark must be lighter than it, but not as high as the ground allows. At 0.80 sRGB can no longer hold the chroma at the violet and blue hues, the colours there go pale, and the first series of a violet palette lands on the same colour as the palette's own action colour, which is a data mark that reads as a button. |
576
576
  | `component.chart.seriesChroma` | number | `0.18` | OKLab chroma asked for at each series hue, reduced per hue only where sRGB cannot hold it. Asking for one chroma and clipping is what keeps the six equally saturated to the eye. |
577
577
  | `component.chart.seriesHueOffset` | number | `30` | Degrees the ring of series hues is turned from the palette's own seed hue. Half a step, so the palette hue falls exactly between the first and last series rather than on the first. The ring is centred on the palette rather than started from it for one reason: a series colour sitting on the seed hue at the lightness these are drawn at is the palette's action colour, and a data mark that is the colour of every button on the page is a data mark people try to press. |
578
- | `component.chart.seriesContrast` | number | `3` | The floor every series colour clears against both the surface and the canvas of its mode. A data mark is a graphical object carrying information, so WCAG 1.4.11 applies to it and 3:1 is the bar. Where a hue cannot reach the floor at the stated lightness, its lightness moves until it does — the floor is not negotiable and the family resemblance is. |
578
+ | `component.chart.seriesContrast` | number | `3` | The floor every series colour clears against both the surface and the canvas of its mode. A data mark is a graphical object carrying information, so WCAG 1.4.11 applies to it and 3:1 is the bar. Where a hue cannot reach the floor at the stated lightness, its lightness moves until it does. The floor is fixed, and the family resemblance gives way. |
579
579
  | `component.chart.stroke` | dimension | `2px` | Line and edge weight for a data mark: a chart line, a polygon edge, a candle wick. |
580
- | `component.chart.hairline` | dimension | `1px` | The separation a chart draws in the surface colour rather than in ink — between pie segments, heatmap cells, treemap rectangles and map regions. It is a gap, not a border: it shows the ground through. |
580
+ | `component.chart.hairline` | dimension | `1px` | The separation a chart draws in the surface colour rather than in ink, between pie segments, heatmap cells, treemap rectangles and map regions. It is a gap that shows the ground through. |
581
581
  | `component.chart.pointMin` | dimension | `6px` | Smallest drawn point diameter. Points are sized on a scale between this and pointMax; the hit area is the action minimum regardless, so a 6px point is still a 44px target. |
582
582
  | `component.chart.pointMax` | dimension | `18px` | Largest drawn point diameter. |
583
583
  | `component.chart.barRadius` | dimension | `4px` | Radius on the value end of a bar only. The base end stays square because it sits on the axis, and rounding it would lift the bar off the line it is measured from. |
584
584
  | `component.chart.cellGap` | dimension | `2px` | Gap between the square cells of a heatmap or calendar heatmap. |
585
585
  | `component.chart.ringThickness` | number | `0.32` | A donut's ring thickness as a proportion of its outer radius. Declared rather than chosen per chart so a donut is recognisably the same object at every size. |
586
- | `component.chart.fillOpacity` | number | `0.25` | Opacity of a fill whose job is to show extent without hiding what is behind it — the region under a line, the inside of a radar polygon. Low enough that two overlapping series are still two, and that the gridlines a reader measures against are still legible through both. |
586
+ | `component.chart.fillOpacity` | number | `0.25` | Opacity of a fill whose job is to show extent without hiding what is behind it, such as the region under a line or the inside of a radar polygon. Low enough that two overlapping series are still two, and that the gridlines a reader measures against are still legible through both. |
587
587
  | `component.chart.linkOpacity` | number | `0.45` | Opacity of a flow between two nodes. Higher than a fill because a link is the mark rather than its backing, and low enough that a crossing reads as two links rather than as a third shape. |
588
- | `component.chart.intensitySteps` | number | `5` | How many buckets an intensity scale has — a heatmap cell, a calendar day. Five, because a reader comparing cells is matching them to a key rather than reading a gradient, and a key with more entries than a hand has fingers is a key nobody uses. |
588
+ | `component.chart.intensitySteps` | number | `5` | How many buckets an intensity scale has, for a heatmap cell or a calendar day. Five, because a reader comparing cells is matching them to a key rather than reading a gradient, and a key with more entries than a hand has fingers is a key nobody uses. |
589
589
  | `component.chart.gaugeSweep` | number | `270` | Degrees an arc gauge sweeps, centred on the bottom. Not a full circle, because a full circle has no ends and a gauge is a value between two of them; not a half, because three quarters gives the same travel half the diameter would and leaves the centre square for the value. |
590
590
 
591
591
  ### Component · progress
@@ -596,9 +596,8 @@ Values that belong to one component family and would be wrong to reuse elsewhere
596
596
 
597
597
  ## Deprecations
598
598
 
599
- A deprecated token still resolves. It is listed here so adopters can migrate before
600
- it is removed, which is the only reason to keep a name that no longer describes its
601
- value.
599
+ A deprecated token still resolves. Its name is kept, and listed here, only so
600
+ adopters can migrate before it is removed.
602
601
 
603
602
  | Token | Replacement or reason |
604
603
  | --- | --- |
package/engines.js CHANGED
@@ -4,9 +4,9 @@ import { gsap } from 'gsap';
4
4
 
5
5
  const cssName = name => name.replace(/[A-Z]/g, letter => '-' + letter.toLowerCase());
6
6
  function easing(value){
7
- /* A continuous recipe travels at constant speed. Anything that is not a named
8
- curve used to fall through to the default ease, which made a loop surge and
9
- slow once per cycle — a spinner that breathes. */
7
+ /* A continuous recipe travels at constant speed, so `linear` is handled here.
8
+ Anything that is not a named curve falls through to the default ease, which
9
+ makes a loop surge and slow once per cycle. */
10
10
  if(value==='linear')return t=>t;
11
11
  const match=/cubic-bezier\(([^)]+)\)/.exec(value||'');
12
12
  return match ? cubicBezier(...match[1].split(',').map(Number)) : cubicBezier(.22,.65,.22,1);
package/package.json CHANGED
@@ -1,8 +1,15 @@
1
1
  {
2
2
  "name": "@crystal-ui/core",
3
- "version": "2.3.1",
4
- "description": "Crystal design system: tokens, material primitives, headless core, icons and specifications.",
5
- "keywords": [],
3
+ "version": "2.4.0",
4
+ "description": "Crystal, Meridian's design system: design tokens, material stylesheets, a token resolver, a headless state core, motion recipes, icons and the specification.",
5
+ "keywords": [
6
+ "design-system",
7
+ "design-tokens",
8
+ "css",
9
+ "theming",
10
+ "motion",
11
+ "icons"
12
+ ],
6
13
  "type": "commonjs",
7
14
  "license": "SEE LICENSE IN licenses",
8
15
  "repository": {
@@ -44,6 +51,7 @@
44
51
  },
45
52
  "./catalogue": "./tokens/catalogue.json",
46
53
  "./surfaces": "./tokens/surfaces.json",
54
+ "./surface-recipes": "./tokens/surface-recipes.json",
47
55
  "./resolver": {
48
56
  "types": "./assets/crystal.d.ts",
49
57
  "default": "./assets/crystal.js"
@@ -252,7 +252,7 @@
252
252
  "scrolled",
253
253
  "condensed"
254
254
  ],
255
- "material": "Frost band over the Plastic foundation",
255
+ "material": "Frost band over the view's foundation",
256
256
  "surface": [
257
257
  "frost"
258
258
  ],
@@ -298,12 +298,11 @@
298
298
  "haze"
299
299
  ],
300
300
  "geometry": "Indent step 20px; guides use the edge token",
301
- "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 — treegrid is the pattern ARIA provides for a row that holds its own control. See M-3.",
301
+ "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.",
302
302
  "crystal": "Row treatment, indentation guides, label weight for the selected row",
303
303
  "product": "The keyboard navigation implementation, data and lazy loading",
304
304
  "motion": [
305
- "accordion-in",
306
- "accordion-out"
305
+ "accordion-in"
307
306
  ],
308
307
  "parity": [
309
308
  "mantine:Tree",
@@ -435,7 +434,8 @@
435
434
  "react-aria:Menu",
436
435
  "primereact:menubar",
437
436
  "antd:Menu"
438
- ]
437
+ ],
438
+ "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."
439
439
  },
440
440
  {
441
441
  "id": "submenu",
@@ -117,7 +117,8 @@
117
117
  "antd:Dropdown.Button",
118
118
  "mui:ButtonGroup",
119
119
  "mantine:Menu"
120
- ]
120
+ ],
121
+ "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."
121
122
  },
122
123
  {
123
124
  "id": "floating-action",