hpe-design-tokens 2.2.2 → 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.
package/CHANGELOG.md ADDED
@@ -0,0 +1,567 @@
1
+ # hpe-design-tokens
2
+
3
+ ## 2.3.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 525716f: Adds a new accent color palette and a new `color.foreground.info` color to the semantic colors, fixes the unselected CheckBox/RadioButton control border contrast, and aligns form-input hover styling.
8
+
9
+ - Added accent colors (`color.background.accent.{blue,purple,cyan}.{weak,strong}`, `color.border.accent.{blue,purple,cyan}.strong`) for use as functional, sparingly-applied brand accents. Hues carry no fixed semantic meaning. Background accent colors have been contrast-validated when paired with `color.{text,icon}.{default,strong,weak}` light and dark modes.
10
+
11
+ - Added `color.foreground.info` color for representing an informational status in foreground graphics such as `Meter` and progress bars. Completes the foreground status set (`color.foreground.critical`, `color.foreground.warning`, `color.foreground.ok`, `color.foreground.unknown`, `color.foreground.info`).
12
+
13
+ - Fixed the `checkbox.default.control.rest.borderColor` and `checkbox.default.control.rest.borderColor` to use `color.border.strong`, meeting the WCAG 2.1/2.2 SC 1.4.11 non-text contrast requirement (3:1).
14
+
15
+ - Aligned form input hover styling:
16
+ - FormField borders darken on hover. `formField.default.input.container.hover.borderColor` references `color.border.strong`.
17
+ - RadioButton control background darkens on hover matching CheckBox control. `radioButton.default.control.hover.background` references `color.background.hover`.
18
+
19
+ - Darkened the dark mode modal scrim (`color.background.screenOverlay`) so the overlay behind modals is clearly perceivable, indicating the underlying page is non-interactive. Light mode is unchanged.
20
+
21
+ If you were using the `color.decorative` palette for functional UI element backgrounds, replacement with `color.background.accent` tokens is recommended to meet WCAG contrast requirements.
22
+
23
+ ## 2.2.3
24
+
25
+ Changed
26
+ Button (Primary, Secondary, Default) “active/selected” state updates (Issue #5891)Updated selected.rest and selected.hover tokens for all button variants to use a shared styling model: transparent background, neutral text (text.strong), and a green border (border.selected).
27
+ Why: improve accessibility by replacing the font-weight shift with a high-contrast border, eliminate layout shift caused by heavier font-weight in active state (Issue #5840).
28
+
29
+ Formfield group item horizontal paddingUpdated hpe.formField.default.medium.input.group.item.paddingX from spacing.xxsmall (8px) to spacing.xsmall to match hpe.formField.default.medium.input.container.paddingX.
30
+ Why: a regression introduced in V1 changed the group item padding from spacing.xsmall to spacing.xxsmall, causing checkbox and radio button groups to appear misaligned with standard inputs in forms.
31
+
32
+ Impact / What to watch for
33
+
34
+ - All buttons (Primary, Secondary, Default) will now display a border when in the active state.
35
+ - Buttons will no longer shift font-weight (medium → semi-bold) when active, preventing layout movement.
36
+ - Checkbox and radio button groups inside form fields will now align horizontally with text inputs.
37
+
38
+ ### Patch 1: Primary Button
39
+
40
+ Issue: https://github.com/grommet/hpe-design-system/issues/5840
41
+
42
+ | Component | Design Token | Files | Change (new token value) | Notes | Semantic version |
43
+ | -------------- | ------------------------------------------- | ------------------------ | ------------------------ | ------------------------------------------------------------------------------------ | ---------------- |
44
+ | Button-primary | `button.primary.selected.rest.iconColor` | `component.default.json` | `color.icon.strong` | Updated to align all button kinds to a consistent active state. See #5840 | Patch |
45
+ | Button-primary | `button.primary.selected.rest.textColor` | `component.default.json` | `color.text.strong` | Updated to align all button kinds to a consistent active state. See #5840 | Patch |
46
+ | Button-primary | `button.primary.selected.rest.background` | `component.default.json` | `color.transparent` | Updated to align all button kinds to a consistent active state. See #5840 | Patch |
47
+ | Button-primary | `button.primary.selected.rest.borderColor` | `component.default.json` | `color.border.selected` | Border added as the perceivable accessibility affordance for active state. See #5840 | Patch |
48
+ | Button-primary | `button.primary.selected.rest.fontWeight` | `component.default.json` | `fontWeight.medium` | Font-weight unchanged between rest and active to eliminate layout shift. See #5840 | Patch |
49
+ | Button-primary | `button.primary.selected.hover.iconColor` | `component.default.json` | `color.icon.strong` | Updated to align all button kinds to a consistent active hover state. See #5840 | Patch |
50
+ | Button-primary | `button.primary.selected.hover.textColor` | `component.default.json` | `color.text.strong` | Updated to align all button kinds to a consistent active hover state. See #5840 | Patch |
51
+ | Button-primary | `button.primary.selected.hover.background` | `component.default.json` | `color.background.hover` | Updated to align all button kinds to a consistent active hover state. See #5840 | Patch |
52
+ | Button-primary | `button.primary.selected.hover.borderColor` | `component.default.json` | `color.border.selected` | Border persists on hover in active state. See #5840 | Patch |
53
+ | Button-primary | `button.primary.selected.hover.fontWeight` | `component.default.json` | `fontWeight.medium` | Font-weight unchanged between rest and active to eliminate layout shift. See #5840 | Patch |
54
+
55
+ ---
56
+
57
+ ### Patch 2: Secondary Button
58
+
59
+ Issue: https://github.com/grommet/hpe-design-system/issues/5840
60
+
61
+ | Component | Design Token | Files | Change (new token value) | Notes | Semantic version |
62
+ | ---------------- | --------------------------------------------- | ------------------------ | ------------------------ | ------------------------------------------------------------------------------------ | ---------------- |
63
+ | Button-secondary | `button.secondary.selected.rest.iconColor` | `component.default.json` | `color.icon.strong` | Updated to align all button kinds to a consistent active state. See #5840 | Patch |
64
+ | Button-secondary | `button.secondary.selected.rest.textColor` | `component.default.json` | `color.text.strong` | Updated to align all button kinds to a consistent active state. See #5840 | Patch |
65
+ | Button-secondary | `button.secondary.selected.rest.background` | `component.default.json` | `color.transparent` | Updated to align all button kinds to a consistent active state. See #5840 | Patch |
66
+ | Button-secondary | `button.secondary.selected.rest.borderColor` | `component.default.json` | `color.border.selected` | Border added as the perceivable accessibility affordance for active state. See #5840 | Patch |
67
+ | Button-secondary | `button.secondary.selected.rest.fontWeight` | `component.default.json` | `fontWeight.medium` | Font-weight unchanged between rest and active to eliminate layout shift. See #5840 | Patch |
68
+ | Button-secondary | `button.secondary.selected.hover.iconColor` | `component.default.json` | `color.icon.strong` | Updated to align all button kinds to a consistent active hover state. See #5840 | Patch |
69
+ | Button-secondary | `button.secondary.selected.hover.textColor` | `component.default.json` | `color.text.strong` | Updated to align all button kinds to a consistent active hover state. See #5840 | Patch |
70
+ | Button-secondary | `button.secondary.selected.hover.background` | `component.default.json` | `color.background.hover` | Updated to align all button kinds to a consistent active hover state. See #5840 | Patch |
71
+ | Button-secondary | `button.secondary.selected.hover.borderColor` | `component.default.json` | `color.border.selected` | Border persists on hover in active state. See #5840 | Patch |
72
+ | Button-secondary | `button.secondary.selected.hover.fontWeight` | `component.default.json` | `fontWeight.medium` | Font-weight unchanged between rest and active to eliminate layout shift. See #5840 | Patch |
73
+
74
+ ---
75
+
76
+ ### Patch 3: Default Button
77
+
78
+ Issue: https://github.com/grommet/hpe-design-system/issues/5840
79
+
80
+ | Component | Design Token | Files | Change (new token value) | Notes | Semantic version |
81
+ | -------------- | ------------------------------------------- | ------------------------ | ------------------------ | ------------------------------------------------------------------------------------ | ---------------- |
82
+ | Button-default | `button.default.selected.rest.iconColor` | `component.default.json` | `color.icon.strong` | Updated to align all button kinds to a consistent active state. See #5840 | Patch |
83
+ | Button-default | `button.default.selected.rest.textColor` | `component.default.json` | `color.text.strong` | Updated to align all button kinds to a consistent active state. See #5840 | Patch |
84
+ | Button-default | `button.default.selected.rest.background` | `component.default.json` | `color.transparent` | Updated to align all button kinds to a consistent active state. See #5840 | Patch |
85
+ | Button-default | `button.default.selected.rest.borderColor` | `component.default.json` | `color.border.selected` | Border added as the perceivable accessibility affordance for active state. See #5840 | Patch |
86
+ | Button-default | `button.default.selected.rest.fontWeight` | `component.default.json` | `fontWeight.medium` | Font-weight unchanged between rest and active to eliminate layout shift. See #5840 | Patch |
87
+ | Button-default | `button.default.selected.hover.iconColor` | `component.default.json` | `color.icon.strong` | Updated to align all button kinds to a consistent active hover state. See #5840 | Patch |
88
+ | Button-default | `button.default.selected.hover.textColor` | `component.default.json` | `color.text.strong` | Updated to align all button kinds to a consistent active hover state. See #5840 | Patch |
89
+ | Button-default | `button.default.selected.hover.background` | `component.default.json` | `color.background.hover` | Updated to align all button kinds to a consistent active hover state. See #5840 | Patch |
90
+ | Button-default | `button.default.selected.hover.borderColor` | `component.default.json` | `color.border.selected` | Border persists on hover in active state. See #5840 | Patch |
91
+ | Button-default | `button.default.selected.hover.fontWeight` | `component.default.json` | `fontWeight.medium` | Font-weight unchanged between rest and active to eliminate layout shift. See #5840 | Patch |
92
+
93
+ ### Patch 4: Formfield Groups
94
+
95
+ | Component | Design Token | Files | Change (new token value) | Notes | Semantic version |
96
+ | ---------------- | -------------------------------------------------- | ------------------------ | ------------------------ | ------------------------------------------------------------------ | ---------------- |
97
+ | Form-field Group | formField.default.medium.input.group.item.paddingX | `component.default.json` | `static.spacing.xsmall` | Updated to align horizontal padding with single form-field inputs. | Patch |
98
+
99
+ ### Patch 5: Heading xxsmall Size
100
+
101
+ In dimension.small updated `heading.xxsmall.fontSize` to `base.fontSize.90`.
102
+
103
+ ## 2.2.2
104
+
105
+ - Changed `primary` Button `selected`/`active` state styling tokens in `component.default.json` to mirror `secondary` Button styling.
106
+ - Changed `icon.critical` in light mode from `red.600` to `red.800`, aligning it with `border.critical` and `text.critical`.
107
+ - Changed `hpe.formField.default.input.group.container.disabled.rest.borderColor` from `border.disabled` to `color.transparent`.
108
+
109
+ ## 2.2.1
110
+
111
+ - Fixed bug where `color.focus` and `color.focus.support` were not defined correctly. https://github.com/grommet/hpe-design-system/pull/5668
112
+
113
+ ## 2.2.0
114
+
115
+ **Global**
116
+
117
+ - Changed `fontStack.primary` from `'Graphik', Arial, sans-serif` to `'HPE Graphik', Arial, sans-serif`.
118
+
119
+ **Primitive**
120
+
121
+ - Added `static.spacing.6xsmall` with value `base.dimension.50`.
122
+
123
+ **Dimension (default)**
124
+
125
+ - Added `spacing.6xsmall` with value `static.spacing.6xsmall`.
126
+
127
+ **Dimension (small)**
128
+
129
+ - Added `spacing.6xsmall` with value `static.spacing.6xsmall`.
130
+ - Changed `spacing.4xsmall` from `static.spacing.5xsmall` to `static.spacing.6xsmall`.
131
+ - Changed `spacing.5xsmall` from `static.spacing.5xsmall` to `static.spacing.6xsmall`.
132
+
133
+ **Color (light)**
134
+
135
+ - Added `color.foreground.ok` with value `base.color.green.650`.
136
+
137
+ **Color (dark)**
138
+
139
+ - Added `color.foreground.ok` with value `base.color.green.550`.
140
+
141
+ ## 2.1.0
142
+
143
+ - Fixed an accessibility issue with the focus indicator in dark mode.
144
+
145
+ **Color (light)**
146
+
147
+ - Added `color.focus.support` with value `base.color.white.100`
148
+
149
+ **Color (dark)**
150
+
151
+ - Added `color.focus.support` with value `base.color.grey.1000`
152
+ - Changed `color.focus` from `base.color.grey.1000` to `base.color.white.100`
153
+
154
+ **Global**
155
+
156
+ - Changed `focusIndicator.boxShadow` from `base.color.white.100` to `color.focus.support`
157
+
158
+ ## 2.0.0
159
+
160
+ ### Major Changes
161
+
162
+ - 1c60852: **Primitives**
163
+
164
+ - Updated `base.fontFamily.primary` from `MetricHPEXS` to `HPE Graphik`.
165
+ - Added new color tokens:
166
+ - Added `base.color.purple.100` with value `#b7a2fc`
167
+ - Added `base.color.purple.200` with value `#9b84fc`
168
+ - Added `base.color.purple.400` with value `#7764fc`
169
+ - Added `base.color.purple.700` with value `#5d45d6`
170
+ - Added `base.color.purple.900` with value `#3c3aa1`
171
+ - Added `base.color.fuschia.100` with value `#fc9ddc`
172
+ - Added `base.color.fuschia.200` with value `#db72b8`
173
+ - Added `base.color.fuschia.300` with value `#cc54a4`
174
+ - Added `base.color.fuschia.700` with value `#ad4089`
175
+ - Added `base.color.fuschia.900` with value `#7f245c`
176
+ - Added `base.color.orange.50` with value `#fff3dd`
177
+ - Added `base.color.orange.500` with value `#ec8c25`
178
+ - Added `base.color.orange.1000` with value `#3c361e`
179
+ - Added `base.color.plum.100` with value `#c98ad4`
180
+ - Added `base.color.plum.200` with value `#a455b3`
181
+ - Added `base.color.plum.600` with value `#873492`
182
+ - Added `base.color.plum.700` with value `#6c2b7c`
183
+ - Added `base.color.plum.900` with value `#5e1f68`
184
+ - Added `base.color.coral.100` with value `#fc988b`
185
+ - Added `base.color.coral.200` with value `#e5786a`
186
+ - Added `base.color.coral.300` with value `#d25f4b`
187
+ - Added `base.color.coral.400` with value `#c64f3a`
188
+ - Added `base.color.coral.500` with value `#b4422a`
189
+ - Added `base.color.gold.100` with value `#f9cc61`
190
+ - Added `base.color.gold.200` with value `#ecbe4f`
191
+ - Added `base.color.gold.300` with value `#deb146`
192
+ - Added `base.color.gold.400` with value `#c89e3a`
193
+ - Added `base.color.gold.500` with value `#b38a29`
194
+ - Added `base.color.gold.550` with value `#b0840d`
195
+ - Added `base.color.cyan.100` with value `#99f0f9`
196
+ - Added `base.color.cyan.200` with value `#62e5f6`
197
+ - Added `base.color.cyan.300` with value `#00dbe4`
198
+ - Added `base.color.cyan.400` with value `#00a4b3`
199
+ - Added `base.color.cyan.500` with value `#04909d`
200
+ - Added `base.color.green.450` with value `#66ebcf`
201
+ - Added `base.color.green.550` with value `#05cc93`
202
+ - Added `base.color.grey.200` with value `#e6e8e9`
203
+ - Added `base.color.grey.650` with value `#606a70`
204
+ - Added `base.color.grey.1000` with value `#292d3a`
205
+ - Added `base.color.grey.1300` with value `#1d1f27`
206
+ - Added `base.color.blue.50` with value `#e3f1ff`
207
+ - Added `base.color.blue.200` with value `#65aef9`
208
+ - Added `base.color.blue.300` with value `#3994f7`
209
+ - Added `base.color.blue.500` with value `#0070f8`
210
+ - Added `base.color.blue.700` with value `#0055da`
211
+ - Added `base.color.blue.900` with value `#003cae`
212
+ - Added `base.color.blue.1100` with value `#2b3547`
213
+ - Added `base.color.red.50` with value `#ffecec`
214
+ - Added `base.color.red.400` with value `#ff7b7b`
215
+ - Added `base.color.red.1000` with value `#552120`
216
+ - Updated existing color tokens:
217
+ - Updated `base.color.green.400` from `#17eba0` to `#00e0af`
218
+ - Updated `base.color.green.450` from `#00ebb5` to `#66ebcf`
219
+ - Updated `base.color.green.500` from `#1ed8ae` to `#00e0af`
220
+ - Updated `base.color.green.700` from `#008567` to `#068667`
221
+ - Updated `base.color.green.900` from `#074b3b` to `#074738`
222
+ - Updated `base.color.green.1000` from `#093a2f` to `#093d32`
223
+ - Updated `base.color.grey.400` from `#cccccc` to `#d4d8db`
224
+ - Updated `base.color.grey.500` from `#bbbbbb` to `#b1b9be`
225
+ - Updated `base.color.grey.600` from `#8c8c8c` to `#7d8a92`
226
+ - Updated `base.color.grey.700` from `#757575` to `#535c66`
227
+ - Updated `base.color.grey.800` from `#555555` to `#3e4550`
228
+ - Updated `base.color.grey.1000` from `#2e2e2e` to `#292d3a`
229
+ - Updated `base.color.grey.1200` from `#222222` to `#22252e`
230
+ - Updated `base.color.grey.1300` from `#1c1c1c` to `#1d1f27`
231
+ - Removed `base.color.grey.1100`
232
+ - Deprecated colors:
233
+ - All deprecated colors moved to `deprecated.base.color` namespace.
234
+ - Deprecated `base.color.brand`.
235
+ - Deprecated `base.fontFamily.MetricHPEXS`.
236
+
237
+ **Dimension**
238
+
239
+ - Updated `icon.xsmall.size` from `base.dimension.350` to `base.dimension.300`.
240
+ - Updated `icon.small.size` from `base.dimension.400` to `base.dimension.350`.
241
+ - Updated `icon.medium.size` from `base.dimension.450` to `base.dimension.400`.
242
+ - Updated `icon.large.size` from `base.dimension.550` to `base.dimension.450`.
243
+ - Updated `icon.xlarge.size` from `base.dimension.600` to `base.dimension.500`.
244
+ - Updated `icon.xxlarge.size` from `base.dimension.900` to `base.dimension.800`.
245
+ - Updated `text.xsmall.fontSize` from `base.fontSize.90` to `base.fontSize.80`.
246
+ - Updated `text.small.fontSize` from `base.fontSize.100` to `base.fontSize.90`.
247
+ - Updated `text.medium.fontSize` from `base.fontSize.200` to `base.fontSize.100`.
248
+ - Updated `text.large.fontSize` from `base.fontSize.400` to `base.fontSize.200`.
249
+ - Updated `text.xlarge.fontSize` from `base.fontSize.500` to `base.fontSize.300`.
250
+ - Updated `text.xxlarge.fontSize` from `base.fontSize.600` to `32`.
251
+ - Updated `text.3xlarge.fontSize` from `base.fontSize.700` to `base.fontSize.600`.
252
+ - Updated `text.4xlarge.fontSize` from `base.fontSize.800` to `base.fontSize.700`.
253
+ - Updated `text.5xlarge.fontSize` from `base.fontSize.900` to `64`.
254
+ - Updated `heading.xlarge.fontWeight` from `fontWeight.regular` to `fontWeight.medium`.
255
+ - Updated `heading.xlarge.fontSize` from `36` to `32`.
256
+ - Updated `heading.large.fontWeight` from `fontWeight.regular` to `fontWeight.medium`.
257
+ - Updated `heading.large.fontSize` from `28` to `base.fontSize.500`.
258
+ - Updated `heading.medium.fontSize` from `24` to `base.fontSize.400`.
259
+ - Updated `heading.medium.fontWeight` from `fontWeight.regular` to `fontWeight.medium`.
260
+ - Updated `heading.small.fontSize` from `20` to `base.fontSize.200`.
261
+ - Updated `heading.small.fontWeight` from `fontWeight.regular` to `fontWeight.medium`.
262
+ - Updated `heading.xsmall.fontSize` from `18` to `base.fontSize.100`.
263
+ - Updated `heading.xxsmall.fontSize` from `16` to `base.fontSize.90`.
264
+ - Updated `heading.xxsmall.fontWeight` from `fontWeight.semibold` to `fontWeight.medium`.
265
+ - Updated `text.xsmall.maxWidth` from `30em` to `38em`.
266
+ - Updated `text.small.maxWidth` from `30em` to `38em`.
267
+ - Updated `text.medium.maxWidth` from `30em` to `38em`.
268
+ - Updated `text.large.maxWidth` from `30em` to `38em`.
269
+ - Updated `text.xlarge.maxWidth` from `30em` to `38em`.
270
+ - Updated `text.xxlarge.maxWidth` from `30em` to `38em`.
271
+ - Updated `text.3xlarge.maxWidth` from `30em` to `38em`.
272
+ - Updated `text.4xlarge.maxWidth` from `30em` to `38em`.
273
+ - Updated `text.5xlarge.maxWidth` from `30em` to `38em`.
274
+
275
+ **Color (light)**
276
+
277
+ - Added `color.background.neutral.xstrong.hover`.
278
+ - Added `color.decorative.cyan`.
279
+ - Updated `color.background.disabled` from `base.color.black.opacity4` to `#d4d8d8`.
280
+ - Updated `color.background.warning` from `#fff3dd` to `base.color.orange.50`.
281
+ - Updated `color.background.ok` from `#e3fdf4` to `base.color.green.100`.
282
+ - Updated `color.background.info` from `#e0f8ff` to `base.color.blue.50`.
283
+ - Updated `color.background.critical` from `#ffecec` to `base.color.red.50`.
284
+ - Updated `color.border.strong` from `base.color.black.opacity72` to `base.color.grey.800`.
285
+ - Updated `color.border.default` from `base.color.black.opacity36` `base.color.grey.500`.
286
+ - Updated `color.border.weak` from `base.color.black.opacity12` `base.color.grey.400`.
287
+ - Updated `color.border.disabled` from `base.color.black.opacity12` to `base.color.grey.400`.
288
+ - Updated `color.text.weak` from `#676767` `base.color.grey.650`.
289
+ - Updated `color.text.disabled` from `base.color.black.opacity24` to `#a0a2a8`.
290
+ - Updated `color.icon.default` from `base.color.grey.800` to `color.text.default`.
291
+ - Updated `color.icon.strong` from `base.color.grey.1000` to `color.text.strong`.
292
+ - Updated `color.icon.disabled` from `base.color.black.opacity24` to `color.text.disabled`.
293
+ - Updated `color.icon.info` from `base.color.blue.900` to `color.color.blue.700`.
294
+ - Updated `color.icon.unknown` from `base.color.grey.700` to `color.color.grey.650`.
295
+ - Updated `color.decorative.green` from `base.color.green.400` to `color.color.green.550`.
296
+ - Updated `color.decorative.purple` from `base.color.purple.500` to `color.color.purple.300`.
297
+ - Updated `color.decorative.blue` from `base.color.blue.400` to `color.color.blue.500`.
298
+ - Updated `color.decorative.neutral` from `base.color.grey.700` to `color.color.grey.650`.
299
+ - Updated `color.datavis.categorical-10` from `base.color.datavis.purple2` to `base.color.blue.500`.
300
+ - Updated `color.datavis.categorical-20` from `base.color.datavis.gold1` to `base.color.green.650`.
301
+ Updated `color.datavis.categorical-30` from `base.color.datavis.pink1` to `base.color.purple.400`.
302
+ - Updated `color.datavis.categorical-40` from `base.color.datavis.blue1` to `base.color.blue.900`.
303
+ - Updated `color.datavis.categorical-50` from `#a78972` to `base.color.fuschia.300`.
304
+ - Updated `color.datavis.categorical-60` from `base.color.datavis.purple1` to `base.color.cyan.500`.
305
+ - Updated `color.datavis.categorical-70` from `base.color.datavis.darkblue.2` to `base.color.plum.700`.
306
+ - Updated `color.datavis.categorical-80` from `base.color.datavis.grape1` to `base.color.coral.300`.
307
+ - Deprecated `color.decorative.teal`, use `color.decorative.cyan` instead.
308
+ - Deprecated `color.decorative.red`.
309
+ - Deprecated `color.decorative.orange`.
310
+ - Deprecated `color.decorative.yellow`.
311
+
312
+ **Color (dark)**
313
+
314
+ - Added `color.background.neutral.xstrong.hover`.
315
+ - Added `color.decorative.cyan`.
316
+ - Added `color.background.neutral.xstrong`.
317
+ - Updated `color.background.front` from `base.color.grey.1200` to `base.color.grey.1000`.
318
+ - Updated `color.background.floating` from `base.color.grey.1200` to `base.color.grey.1000`.
319
+ - Updated `color.background.contrast` from `base.color.white.opacity12` to `base.color.white.opacity6`.
320
+ - Updated `color.background.contrast.hover` from `base.color.white.opacity20` to `base.color.white.opacity10`.
321
+ - Updated `color.background.disabled` from `base.color.black.opacity4` to `#d4d8d8`.
322
+ - Updated `color.background.warning` from `#3c361e` to `base.color.orange.1000`.
323
+ - Updated `color.background.ok` from `#1b5245` to `base.color.green.1000`.
324
+ - Updated `color.background.info` from `#1e363d` to `base.color.blue.1100`.
325
+ - Updated `color.background.critical` from `#552120` to `base.color.red.1000`.
326
+ - Updated `color.background.primary.strong` from `#007c60` to `base.color.green.600`.
327
+ - Updated `color.background.primary.strong.hover` from `#00513f` to `base.color.green.550`.
328
+ - Updated `color.background.primary.xstrong` from `base.color.green.1000` to `base.color.green.450`.
329
+ - Updated `color.text.default` from `base.color.white.100` `base.color.grey.50`.
330
+ - Updated `color.text.weak` from `#ffffff9c` `base.color.grey.500`.
331
+ - Updated `color.text.onPrimaryStrong` from `base.color.white.100` to `base.color.grey.1000`.
332
+ - Updated `color.text.primary` from `base.color.green.500` to `base.color.green.550`.
333
+ - Updated `color.text.primary.hover` from `base.color.green.450` to `base.color.green.500`.
334
+ - Updated `color.text.critical` from `color.foreground.critical` to `base.color.red.400`.
335
+ - Updated `color.text.onSelectedPrimaryStrong` from `base.color.white.100` to `color.text.onStrong`.
336
+ - Updated `color.text.onStrong` from `base.color.grey.1200` to `base.color.grey.1000`.
337
+ - Updated `color.icon.default` from `base.color.white.100` to `color.text.default`.
338
+ - Updated `color.icon.strong` from `base.color.white.100` to `color.text.strong`.
339
+ - Updated `color.icon.disabled` from `base.color.black.opacity24` to `color.text.disabled`.
340
+ - Updated `color.icon.info` from `base.color.blue.400` to `base.color.blue.200`.
341
+ - Updated `color.icon.ok` from `base.color.green.500` to `base.color.green.550`.
342
+ - Updated `color.icon.warning` from `base.color.orange.600` to `base.color.orange.500`.
343
+ - Updated `color.icon.primary` from `base.color.green.500` to `base.color.green.550`.
344
+ - Updated `color.icon.onPrimaryStrong` from `base.color.white.100` to `base.color.grey.1000`.
345
+ - Updated `color.icon.onSelectedStrong` from `base.color.white.100` to `color.icon.onStrong`.
346
+ - Updated `color.icon.onStrong` from `base.color.grey.1200` to `base.color.grey.1000`.
347
+ - Updated `color.decorative.green` from `base.color.green.700` to `base.color.green.700`.
348
+ - Updated `color.decorative.purple` from `base.color.purple.900` to `base.color.purple.400`.
349
+ - Updated `color.decorative.blue` from `base.color.blue.700` to `base.color.blue.500`.
350
+ - Updated `color.decorative.neutral` from `base.color.grey.700` to `base.color.grey.650`.
351
+ - Updated `color.datavis.categorical-10` from `#7372CF` to `base.color.blue.200`.
352
+ - Updated `color.datavis.categorical-20` from `base.color.datavis.gold2` to `base.color.grenn.400`.
353
+ Updated `color.datavis.categorical-30` from `base.color.datavis.pink2` to `base.color.purple.200`.
354
+ - Updated `color.datavis.categorical-40` from `base.color.datavis.lightblue1` to `base.color.blue.500`.
355
+ - Updated `color.datavis.categorical-50` from `#A68A74` to `base.color.fuschia.300`.
356
+ - Updated `color.datavis.categorical-60` from `#B889FF` to `base.color.cyan.300`.
357
+ - Updated `color.datavis.categorical-70` from `#4D8DA8` to `base.color.plum.100`.
358
+ - Updated `color.datavis.categorical-80` from `base.color.datavis.purple3` to `base.color.coral.200`.
359
+ - Deprecated `color.decorative.teal`, use `color.decorative.cyan` instead.
360
+ - Deprecated `color.decorative.red`.
361
+ - Deprecated `color.decorative.orange`.
362
+ - Deprecated `color.decorative.yellow`.
363
+
364
+ **Components**
365
+
366
+ - `button.primary.rest.background` updated from `color.background.primary.strong` to `color.background.neutral.xstrong`.
367
+ - `button.primary.rest.textColor` updated from `color.text.onPrimaryStrong` to `color.text.onStrong`.
368
+ - `button.primary.rest.iconColor` updated from `color.icon.onPrimaryStrong` to `color.icon.onStrong`.
369
+ - `button.primary.rest.fontWeight` updated from `fontWeight.semibold` to `fontWeight.medium`.
370
+ - Referenced by `button.primary.hover.fontWeight`, `button.primary.disabled.rest.fontWeight`, `button.primary.selected.rest.fontWeight`, `button.primary.selected.hover.fontWeight`
371
+ - `button.primary.hover.background` updated from `color.background.primary.strong.hover` to `color.background.neutral.strong`.
372
+ - `button.primary.hover.textColor` updated from `color.text.onPrimaryStrong` to `color.text.onStrong`.
373
+ - `button.primary.hover.iconColor` updated from `color.icon.onPrimaryStrong` to `color.icon.onStrong`.
374
+ - `button.primary.selected.rest.background` updated from `color.background.primary.strong` to `color.background.neutral.xstrong`.
375
+ - `button.primary.selected.rest.textColor` updated from `color.text.onPrimaryStrong` to `color.text.onStrong`.
376
+ - `button.primary.selected.rest.iconColor` updated from `color.icon.onPrimaryStrong` to `color.icon.onStrong`.
377
+ - `button.primary.selected.hover.background` updated from `color.background.primary.strong.hover` to `color.background.neutral.strong`.
378
+ - `button.primary.selected.hover.textColor` updated from `color.text.onPrimaryStrong` to `color.text.onStrong`.
379
+ - `button.primary.selected.hover.iconColor` updated from `color.icon.onPrimaryStrong` to `color.icon.onStrong`.
380
+ - `button.secondary.rest.textColor` updated from `color.text.primary` to `color.text.strong`.
381
+ - Referenced by `button.secondary.hover.textColor`
382
+ - `button.secondary.rest.iconColor` updated from `color.icon.primary` to `color.icon.strong`.
383
+ - Referenced by `button.secondary.hover.iconColor`.
384
+
385
+ ## 1.4.1
386
+
387
+ ### Patch Changes
388
+
389
+ - aaa738d: - Fixed `dataCell.default.medium.minHeight` to point to `base.dimension.1200` instead of `element.medium.minHeight`.
390
+ - Fixed `headerCell.default.medium.minHeight` to point to `dataCell.default.medium.minHeight` instead of `element.medium.minHeight`.
391
+ - Fixed `footerCell.default.medium.minHeight` to point to `dataCell.default.medium.minHeight` instead of `element.medium.minHeight`.
392
+
393
+ ## 1.4.0
394
+
395
+ ### Minor Changes
396
+
397
+ - 73eb9d1: - Added `color.icon.primary.hover`.
398
+
399
+ ### Patch Changes
400
+
401
+ - 73eb9d1: - Fixed value of `checkbox.control.indeterminate.rest.iconColor` from `color.icon.onPrimaryStrong` to `color.icon.onSelectedPrimaryStrong`. No visual change for this theme version, but fixes reference to be more scalable to future theme changes.
402
+
403
+ ## 1.3.0
404
+
405
+ ### Minor Changes
406
+
407
+ - ead69c5: - Refined `dataVis.categorical` palette to remove use of green and avoid confusion with status-based charts.
408
+
409
+ ### Patch Changes
410
+
411
+ - 833e765: - Fixed `color.foreground.primary`, `color.border.selected` to meet 4.5:1 contrast ratio on standard background colors.
412
+
413
+ ## 1.2.0
414
+
415
+ ### Minor Changes
416
+
417
+ - 1ce78aa: - Added ability to scope subsection of page to specific theme mode.
418
+ - a376d7a: - Updated `text.[size].maxWidth` from `25em` to `30em` to avoid prematurely wrapping; still adheres to WCAG AAA 80 character per line recommendation.
419
+
420
+ ### Patch Changes
421
+
422
+ - bce1edc: - Updated `color.text.weak` to meet minimum 4.5:1 contrast ratio on supported standard background colors.
423
+
424
+ ## 1.1.1
425
+
426
+ ### Patch Changes
427
+
428
+ - 31ce600: - Fix contrast ratios for `hpe.color.icon.unknown` and `hpe.color.icon.info` on status backgrounds.
429
+
430
+ ## 1.1.0
431
+
432
+ ### Minor Changes
433
+
434
+ - 06d0ab2: - Modified status backgrounds to use opaque values in order to avoid muddiness when placed on `color-background-back`.
435
+ - 6fb75fd: - Added `icon.onStrong` for use on "strong" and "xstrong" backgrounds.
436
+
437
+ ### Patch Changes
438
+
439
+ - 6feae82: - Added keyword of "status" to status color token descriptions to aid searchability in Figma.
440
+ - e0a9bab: - Added copyright comment to production files.
441
+
442
+ ## 1.0.1
443
+
444
+ ### Patch Changes
445
+
446
+ - cc52c53: - Fixed swapped descriptions for `color.background.warning` and `color.border.warning`.
447
+ - ff72acd: - Fixed `hpe.button.default.medium.fontSize` from `base.dimension.475` (19px, 1.1875rem) to `element.medium.fontSize` (18px, 1.125rem).
448
+ - Fixed `hpe.checkbox.control.selected.hover.borderColor` from `color.border.strong` to `color.transparent`.
449
+ - Fixed `hpe.checkbox.control.indeterminate.rest.borderColor` from `color.border.selected` to `color.transparent`.
450
+ - Fixed `hpe.checkbox.control.indeterminate.hover.borderColor` from `color.border.strong` to `color.transparent`.
451
+
452
+ ## 1.0.0
453
+
454
+ ### Major Changes
455
+
456
+ - 1c39846: - Updated design token values to reflect new theme.
457
+
458
+ ## 0.9.0
459
+
460
+ ### Minor Changes
461
+
462
+ - b87e080: - Rename `3xl`, `4xl`, `5xl` text and anchor sizes to `3xlarge`, `4xlarge`, and `5xlarge` for consistency with other t-shirt size naming.
463
+ - 6df1814:
464
+ - Fixed background-screenOverlay.
465
+ - Added `color.text.anchor`, `color.text.anchor.hover`.
466
+ - Fixed `anchor.disabled` tokens to be structured as `anchor.disabled.rest`
467
+ - Fixed `dataCell.primary.disabled` tokens to be structured as `dataCell.primary.disabled.rest`
468
+ - 66ca9da:
469
+ - Renamed exports from "base" to "primitives" (e.g., "base.css" --> "primitives.css").
470
+ - Removed "default" from CJS/ESM component token exports (e.g., "components.default.cjs" --> "components.js"). No effect on import.
471
+ - Removed light/dark, medium/small modes from ESM/CommonJS exports. Because these now return CSS variable refs, we don't need separate mode exports. (e.g., "color.light.js" --> "color.js").
472
+ - cb9764f: - Move `fontWeight` tokens for checkbox, switch, and radiobutton label under each state.
473
+ - 38aad17: - Fixed `icon.info` and `background.info` to correct values.
474
+ - fc7ba24:
475
+ - Renamed `color.background.primary.default` --> `color.background.primary.strong`
476
+ - Renamed `color.background.selected.strong.enabled` --> `color.background.selected.primary.strong`
477
+ - Renamed `color.background.selected.strong.hover` --> `color.background.selected.primary.strong.hover`
478
+ - Renamed `color.background.selected.weak.enabled` --> `color.background.selected.primary.weak`
479
+ - Renamed `color.background.selected.weak.hover` --> `color.background.selected.primary.weak.hover`
480
+ - Renamed `color.text.onPrimary` --> `color.text.onPrimaryStrong`
481
+ - Renamed `color.text.heading.default` --> `color.text.heading`
482
+ - Renamed `color.text.onSelectedStrong` --> `color.text.onSelectedPrimaryStrong`
483
+ - Renamed `color.text.onSelected` --> `color.text.onSelectedPrimary`
484
+ - Renamed `color.text.onStrong.default` --> `color.text.onStrong`
485
+ - Renamed `color.text.onCritical.default` --> `color.text.onCritical`
486
+ - Renamed `color.text.onWarning.default` --> `color.text.onWarning`
487
+ - Renamed `color.text.onOk.default` --> `color.text.onOk`
488
+ - Renamed `color.text.onInfo.default` --> `color.text.onInfo`
489
+ - Renamed `color.text.onUnknown.default` --> `color.text.onUnknown`
490
+ - Renamed `color.icon.onPrimary` --> `color.icon.onPrimaryStrong`
491
+ - Renamed `color.icon.onSelectedStrong` --> `color.icon.onSelectedPrimaryStrong`
492
+ - Renamed `color.icon.onSelected` --> `color.icon.onSelectedPrimary`
493
+ - 6c11700:
494
+ - Removed `color.text.xweak`, `color.icon.xweak`, `color.text.brand`, `color.icon.brand`
495
+ - Renamed `enabled` in component tokens to `rest`
496
+ - Removed `checkbox.control.selected.disabled` (use `checkbox.control.disabled.rest`)
497
+ - Removed `radiobutton.control.selected.disabled` (use `radiobutton.control.disabled.rest`)
498
+ - Removed `dataCell.primary.disabled` (use `dataCell.disabld.rest`)
499
+ - Updated Anchor token structure from `anchor.[size].default` to `anchor.default.[size]` in alignment with button token structure.
500
+ - Updated component state tokens for all but formField tokens to align with new state combinations.
501
+ - 083dab9:
502
+ - Added `anchor.default.xsmall` tokens.
503
+ - Added `color.decorative.neutral`, `color.decorative.neutral.hover`
504
+ - f9c30cc:
505
+ - Updated `borderWidth` scale values (and removed unused value of xlarge).
506
+ - Added `iconColor` for select.option states.
507
+ - Removed incorrect `dataCell.pinned.rest.backgroundColor` in favor of existing `dataCell.pinned.rest.background`.
508
+ - 78fb822: Updated `formField.input.group.container.enabled.background`, `formField.input.group.container.hover.background` to `color.transparent`
509
+ - 6700928: - Fixed container token values in "small" mode to remain the same as "default" mode, in alignment with current behavior.
510
+ - 2b30ef4:
511
+ - Added new export `hpe-design-tokens/grommet`.
512
+ - Changed ESM/CommonJS exports to resolve to CSS variables rather than raw values.
513
+ - Changed structure of "color" exports to flatten color name after the category (e.g., `hpe.color.background.selected.weak` --> `hpe.color.background['selected-weak']`).
514
+ - a334ab2: - Removed "!" namespaced decorative colors (e.g., `hpe.color.decorative.green!`).
515
+ - 1affdd5: - Updated t-shirt scales and values for `spacing` and `container` tokens.
516
+ - 11926ea:
517
+ - Added `iconColor` tokens to formField label.
518
+ - Fixed `switch.medium.label.lineHeight`
519
+ - Fixed `formField.input.group.container.error.rest.borderColor`
520
+ - Fixed `formField.input.group.container.disabled.rest.background`
521
+ - Fixed `formField.help.disabled.rest.textColor`
522
+ - Fixed `base.color.grey.1000` which is used by light mode for `color.text.strong`
523
+ - 38aad17: - Added `drop.boxShadow`.
524
+ - e3bf8e6: - Fix `shadow.small` dimension and `shadow.large` dark mode color.
525
+ - 38aad17: - Removed component-specific focus tokens in favor of relying on global focusIndicator tokens.
526
+ - c376a85:
527
+ - Removed `fontStack.code`
528
+ - Removed `display.medium`
529
+ - Removed `text.6xl`, `anchor.6xl`
530
+ - 52674f0:
531
+ - Added `formField.input.group.container.error.rest` tokens
532
+ - Removed `formField.input.group.item.status.critical` tokens
533
+ - Removed formField text "error" tokens for complex states, now only support `error.rest`, `error.hover`, `error.focus`.
534
+ - Renamed formField "enabled" tokens to "rest"
535
+ - Renamed formField "status.critical" tokens to "error.rest"
536
+ - Renamed formField "disabled" tokens to "disabled.rest"
537
+ - Renamed formField "readOnly" tokens to "readOnly.rest"
538
+ - Renamed `base.static` tokens to `static`.
539
+ - c3982ea: - Renamed default dimension mode from "medium" to "default".
540
+ - dc6b0f3:
541
+ - Renamed `size.icon[t-shirt size]` to `icon[t-shirt size].size` (e.g., `size.icon.xsmall` --> `icon.xsmall.size`)
542
+ - Renamed `size.container[t-shirt size]` to `container[t-shirt size]` (e.g., `size.container.medium` --> `container.medium`)
543
+ - Renamed all default component tokens to include "default" namespace (e.g., `checkbox.control.rest.background` --> `checkbox.default.control.rest.background`)
544
+
545
+ ## 0.8.0
546
+
547
+ ### Minor Changes
548
+
549
+ - c682b78: Added selected/hover state for buttons.
550
+ - c682b78: Added `color.text.primary`.
551
+ - c682b78: Added `base.color.green.800`.
552
+ - c682b78: Added `base.color.grey.550`.
553
+ - c682b78: Renamed `color.text.onSelectedWeak` to `color.text.onSelected`.
554
+
555
+ ## 0.7.0
556
+
557
+ ### Minor Changes
558
+
559
+ - e601f2a: Renamed `size.content` to `size.container`, `base.static.content` to `base.static.container`
560
+ - 1117f91: Updated dark and light mode of `color.background.primary.hover`, updated dark mode of `color.decorative.brand`
561
+ - 133aa8f: Removed paragraph tokens, moved `paragraph.[size].maxWidth` tokens `text.[size].maxWidth`
562
+
563
+ ## 0.6.0
564
+
565
+ ### Minor Changes
566
+
567
+ - 4acbe0e: Fixed CSS output for dimension.medium.css by removing incorrect media query
package/README.md CHANGED
@@ -2,6 +2,16 @@
2
2
 
3
3
  Design tokens for use with the HPE Design System.
4
4
 
5
+ ## Documentation Index
6
+
7
+ - Consumer usage: [HPE Design System design tokens documentation](https://design-system.hpe.design/design-tokens)
8
+ - Contributor workflow: [CONTRIBUTING.md](CONTRIBUTING.md)
9
+ - Maintainer operations and runbooks: [docs/OPERATIONS.md](docs/OPERATIONS.md)
10
+ - Environment-isolated sync implementation context: [docs/FIGMA_ENVIRONMENT_SYNC_PLAN.md](docs/FIGMA_ENVIRONMENT_SYNC_PLAN.md)
11
+ - Sync data model and flow details: [docs/DOCUMENTATION.md](docs/DOCUMENTATION.md)
12
+ - Semantic color path structures and normalization contract: [docs/SEMANTIC_COLOR_PATH_CONTRACT.md](docs/SEMANTIC_COLOR_PATH_CONTRACT.md)
13
+ - Sync contracts: [contracts/README.md](contracts/README.md)
14
+
5
15
  ## Install
6
16
 
7
17
  With pnpm:
@@ -26,6 +36,75 @@ npm i hpe-design-tokens
26
36
 
27
37
  For usage instructions, see [HPE Design System design tokens documentation](https://design-system.hpe.design/design-tokens).
28
38
 
39
+ ## Quick Start (Maintainers)
40
+
41
+ From repository root:
42
+
43
+ ```bash
44
+ pnpm --filter hpe-design-tokens test
45
+ pnpm --filter hpe-design-tokens test:contracts
46
+ pnpm --filter hpe-design-tokens sync-tokens-to-figma -- --env=test --dry-run
47
+ ```
48
+
49
+ See [docs/OPERATIONS.md](docs/OPERATIONS.md) for full sync runbooks, troubleshooting, and script coverage.
50
+
51
+ ## Semantic Color Parity Contract
52
+
53
+ Semantic color import/export behavior is protected by parity tests and golden fixtures.
54
+
55
+ Terminology note: in this monorepo, treat these parity artifacts as
56
+ `snapshot` files (referred to here as `golden` fixtures). They are contract
57
+ snapshots and should be updated only for intentional behavior changes, with
58
+ review of the resulting diff.
59
+
60
+ Semantic role metadata note:
61
+
62
+ - `role: null` means the token path does not include a semantic role segment.
63
+ - `role.family` identifies the role family grouping (e.g. `accent`); it is `null`
64
+ for single-slot roles such as `disabled`.
65
+ - `role.name` is the canonical role name within its target (e.g. `primary`,
66
+ `disabled`, `purple`).
67
+
68
+ - Parity scope:
69
+ - Legacy-vs-new adapter equivalence tests (`semantic_color_figma_adapter_parity.test.ts`).
70
+ - Golden output verification for export token output and import payload output (`semantic_color_payload_golden.test.ts`).
71
+ - Boundary vectors for non-canonical accent naming in both directions:
72
+ - Export fixture coverage for incoming Figma names such as `color/background/accent/purple-custom`.
73
+ - Import fixture coverage for aliases such as `color/background/accent/purple/custom/REST` that must resolve to canonical variable IDs.
74
+ - Golden fixtures:
75
+ - `src/tests/fixtures/semantic-color-parity/export-output.golden.json`
76
+ - `src/tests/fixtures/semantic-color-parity/import-output.golden.json`
77
+
78
+ ### When Golden Fixtures Should Change
79
+
80
+ Update golden fixtures only when semantic color normalization or payload behavior intentionally changes.
81
+
82
+ Examples:
83
+
84
+ - Introducing a deliberate naming contract change in import/export.
85
+ - Adjusting canonical mapping behavior for accent, focus, transparent, or interaction/scale handling.
86
+
87
+ Do not update fixtures to bypass a failing test without understanding the behavior delta.
88
+
89
+ ### Required Workflow Before PR
90
+
91
+ From repository root:
92
+
93
+ Always run:
94
+
95
+ ```bash
96
+ pnpm --filter hpe-design-tokens run test:parity
97
+ pnpm --filter hpe-design-tokens test -- src/tests/token_export.test.ts src/tests/token_import.test.ts src/tests/token_import_alias_resolution.test.ts src/tests/semantic_color_parser.test.ts
98
+ ```
99
+
100
+ Run this only when you intentionally changed semantic color import/export behavior and expect golden fixture output updates:
101
+
102
+ ```bash
103
+ pnpm --filter hpe-design-tokens run test:parity:update
104
+ ```
105
+
106
+ If fixture files change, include them in the same commit as the code change that caused the intentional behavior delta.
107
+
29
108
  ## License
30
109
 
31
110
  [Apache-2.0](https://github.com/grommet/hpe-design-system/blob/design-tokens-stable/LICENSE)