@ids-group-ltd/ids-design-system 0.10.3 → 0.11.1
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 +1376 -904
- package/components.md +61 -30
- package/design-system.md +18 -18
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +992 -486
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.1.0.json +2 -1
- package/migrations/0.10.0.json +219 -42
- package/migrations/0.10.1.json +50 -13
- package/migrations/0.10.2.json +90 -24
- package/migrations/0.10.3.json +22 -5
- package/migrations/0.11.0.json +216 -0
- package/migrations/0.11.1.json +305 -0
- package/migrations/0.2.0.json +22 -9
- package/migrations/0.2.1.json +2 -1
- package/migrations/0.2.2.json +3 -2
- package/migrations/0.3.0.json +16 -10
- package/migrations/0.4.0.json +38 -14
- package/migrations/0.5.0.json +49 -25
- package/migrations/0.5.1/badge-statuses.md +1 -3
- package/migrations/0.5.1.json +75 -33
- package/migrations/0.6.0.json +6 -2
- package/migrations/0.6.1.json +19 -1
- package/migrations/0.6.2.json +3 -1
- package/migrations/0.6.3.json +13 -4
- package/migrations/0.7.0.json +45 -26
- package/migrations/0.7.1.json +58 -20
- package/migrations/0.8.0.json +53 -15
- package/migrations/0.9.0.json +147 -27
- package/migrations/0.9.1.json +4 -3
- package/migrations/README.md +34 -52
- package/package.json +2 -1
- package/styles/_dropdown-overlay.scss +35 -13
- package/styles/_ds-color.scss +3 -3
- package/styles/_field-box.scss +2 -6
- package/styles/_field-label.scss +5 -10
- package/styles/_field-state.scss +3 -2
- package/styles/_focus.scss +0 -2
- package/styles/_layout-utils.scss +2 -2
- package/styles/_link.scss +1 -2
- package/styles/_overlay-motion.scss +2 -4
- package/styles/_press.scss +3 -5
- package/styles/_reset.scss +0 -1
- package/styles/_scrollbar.scss +1 -3
- package/styles/_status.scss +1 -2
- package/styles/_surface-motion.scss +3 -4
- package/styles/_text-clip.scss +1 -1
- package/styles/_theme-activation.scss +1 -1
- package/styles/_tokens-charts.scss +1 -3
- package/styles/_tokens.scss +4 -3
- package/styles/_typography.scss +2 -2
- package/themes/README.md +3 -3
- package/themes/_base-palette.scss +2 -2
- package/themes/_semantic.scss +2 -2
- package/themes/dark/_palette.scss +1 -2
- package/themes/light/_palette.scss +1 -1
- package/themes/light/_theme.scss +1 -1
- package/types/ids-group-ltd-ids-design-system.d.ts +403 -108
- package/migrations/AUTHORING.md +0 -273
package/migrations/0.2.2.json
CHANGED
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
"items": [],
|
|
4
4
|
"informational": [
|
|
5
5
|
"New .t-mono-inline typography utility (inline code chip), completing the mono family alongside .t-mono and .t-mono-block — additive.",
|
|
6
|
-
"npm package hygiene: repository field dropped from package.json,
|
|
7
|
-
]
|
|
6
|
+
"npm package hygiene: repository field dropped from package.json, README license entry made plain text (fixes the npm 404). No consumer action."
|
|
7
|
+
],
|
|
8
|
+
"deleteList": []
|
|
8
9
|
}
|
package/migrations/0.3.0.json
CHANGED
|
@@ -6,7 +6,10 @@
|
|
|
6
6
|
"kind": "token-rename",
|
|
7
7
|
"old": "--ds-*-bg",
|
|
8
8
|
"new": "--ds-*-bg-color",
|
|
9
|
-
"
|
|
9
|
+
"action": "Append `-color` to every DS token whose name ends in `-bg`. Covers the public `--ds-<component>-…-bg` hooks on avatar, badge, banner, button, card, date-picker, dropzone, empty-state, icon-button, input, modal, pagination, search, sidenav, stat, table, tabs, tag, toast and topbar, plus the globals `--select-bg`, `--chart-hover-bg`, `--chart-tooltip-bg` and the `--status-<x>-bg` set.",
|
|
10
|
+
"appliesWhen": "Only to DS-owned tokens. Your own variables ending in `-bg` are untouched, and the private `--_*` internals renamed in lockstep have no public hook, so they need nothing.",
|
|
11
|
+
"pitfall": "A blind search-and-replace on `-bg` renames YOUR variables too, and the result still compiles — a custom property resolves to nothing and the element silently loses its background. Before replacing a name, confirm the `-color` spelling exists in the installed 0.3.0 package under `themes/` or `styles/`; if it does not, the token was yours.",
|
|
12
|
+
"note": "The tokens held only a colour and now feed `background-color`, so the name says which property it reaches.",
|
|
10
13
|
"searchHints": [
|
|
11
14
|
"-bg:",
|
|
12
15
|
"-bg)",
|
|
@@ -22,17 +25,16 @@
|
|
|
22
25
|
"kind": "behavior",
|
|
23
26
|
"old": "--ds-*-fg",
|
|
24
27
|
"new": null,
|
|
25
|
-
"
|
|
28
|
+
"action": "For each `-fg` token you override, look the replacement up in the 0.3.0 token reference on the documentation site, which lists every `--ds-*`; the global roles are also readable in the installed package under `themes/` and `styles/`. Three suffixes are in play and the split is real: at 0.3.0 the package carries 23 `-text-color`, 49 `-label-color` and 21 `-icon-color`.",
|
|
29
|
+
"appliesWhen": "Only to DS-owned tokens. A variable of your own ending in `-fg` is untouched.",
|
|
30
|
+
"pitfall": "The suffix is NOT derivable from the old name, so guessing produces a name nothing reads and a silently unstyled element. Same shape, three answers: `--ds-modal-title-fg` became `-text-color`, `--ds-sidenav-group-fg` became `-label-color`, `--ds-icon-button-fg` became `-icon-color`.",
|
|
31
|
+
"note": "The `fg` abbreviation was dropped for a suffix that says what the token paints — text, a control or nav label, or a glyph. It covers the public `--ds-<component>-…-fg` hooks on avatar, badge, banner, breadcrumbs, button, date-picker, dropzone, empty-state, icon-button, input, menu, modal, page-header, pagination, search, sidenav, table, tabs, tag and topbar, plus the `--status-*` and chart-tooltip globals.",
|
|
26
32
|
"searchHints": [
|
|
27
33
|
"-fg:",
|
|
28
34
|
"-fg)",
|
|
29
35
|
"--status-"
|
|
30
36
|
],
|
|
31
37
|
"surface": "style",
|
|
32
|
-
"detect": [
|
|
33
|
-
"-fg",
|
|
34
|
-
"--ds-"
|
|
35
|
-
],
|
|
36
38
|
"verify": "No stylesheet declares or reads a --ds-*-fg token; each one names the semantic replacement its component reads (-text-color / -label-color / -icon-color)."
|
|
37
39
|
},
|
|
38
40
|
{
|
|
@@ -40,7 +42,9 @@
|
|
|
40
42
|
"kind": "behavior",
|
|
41
43
|
"old": "ds-stepper",
|
|
42
44
|
"new": null,
|
|
43
|
-
"
|
|
45
|
+
"action": "Read every caption you pass in `[steps]` as on-screen text and reword the ones written to be heard rather than seen. `labelPosition` (`bottom` | `inline`, default `bottom`) sets where they sit.",
|
|
46
|
+
"pitfall": "Nothing breaks and no build fails, so this ships unless somebody looks. Captions authored for a screen reader tend to carry the context the screen already gives — \"Step 2 of 5: enter your details\" reads fine when announced and badly when printed under a numbered dot.",
|
|
47
|
+
"note": "`[steps]` takes a `readonly string[]`, and those strings used to be screen-reader-only: on screen a step showed only its number. They render as visible labels now.",
|
|
44
48
|
"searchHints": [
|
|
45
49
|
"<ds-stepper",
|
|
46
50
|
"[steps]"
|
|
@@ -50,8 +54,9 @@
|
|
|
50
54
|
"typescript"
|
|
51
55
|
],
|
|
52
56
|
"detect": [
|
|
53
|
-
"
|
|
54
|
-
"steps"
|
|
57
|
+
"[steps]=",
|
|
58
|
+
"steps: string[]",
|
|
59
|
+
"readonly string[]"
|
|
55
60
|
],
|
|
56
61
|
"verify": "Every caption passed in [steps] is written to be READ on screen, not only announced - they render visibly now."
|
|
57
62
|
}
|
|
@@ -61,5 +66,6 @@
|
|
|
61
66
|
"ng add support (wires the global styles import idempotently); ds-combobox size input (+ComboboxSize); overridable focus-ring token system (--ds-field-focus-shadow / --ds-control-focus-shadow groups + per-component --ds-<comp>-focus-shadow hooks, default appearance unchanged); ds-tag hover tokens; --opacity-state-active overlay token — all additive.",
|
|
62
67
|
"Visual-only: tag close button gains a pressed state; accordion & sidenav-group animate open/close (collapsed content now stays in the DOM marked inert instead of being removed); ds-combobox focus uses the soft field halo; repo-wide value-preserving CSS modernization (background-color precision, modern hsl()/clip-path/range media syntax).",
|
|
63
68
|
"Fixes: ds-drawer closes on Escape when focus left the panel; ds-combobox 'No matches' row no longer selectable."
|
|
64
|
-
]
|
|
69
|
+
],
|
|
70
|
+
"deleteList": []
|
|
65
71
|
}
|
package/migrations/0.4.0.json
CHANGED
|
@@ -6,7 +6,10 @@
|
|
|
6
6
|
"kind": "value-remap",
|
|
7
7
|
"old": "ds-button[variant]",
|
|
8
8
|
"new": null,
|
|
9
|
-
"
|
|
9
|
+
"action": "Apply the map to every static `variant=\"…\"`. For a dynamic `[variant]=\"expr\"`: if the expression only ever yields hues (primary/error/success/warning), rebind it to `[color]=\"expr\"` verbatim; if it yields a mix of hues and fills, retype it and split it across the two inputs.",
|
|
10
|
+
"appliesWhen": "`variant=\"text\"` keeps working and its map entry is an identity, so leave it. It warns in dev builds (prefer the global `.link` class) but needs no migration.",
|
|
11
|
+
"pitfall": "A dynamic `[variant]` left bound to a hue does not fail — the value is simply not a variant any more, so it falls back to `solid` and the button quietly renders in the default colour. Nothing throws and nothing logs in production; only looking at the screen finds it.",
|
|
12
|
+
"note": "One conflated input became two orthogonal axes: `color` (primary|secondary|tertiary|neutral|error|success|warning, default primary) and `variant` (solid|tonal|ghost|outline|text, default solid).",
|
|
10
13
|
"searchHints": [
|
|
11
14
|
"<ds-button",
|
|
12
15
|
"variant=\"",
|
|
@@ -22,14 +25,18 @@
|
|
|
22
25
|
"warning": "color=\"warning\"",
|
|
23
26
|
"text": "variant=\"text\""
|
|
24
27
|
},
|
|
25
|
-
"surface": "template"
|
|
28
|
+
"surface": "template",
|
|
29
|
+
"verify": "No ds-button carries a variant value outside the shipped set, and every button that used to name a colour through `variant` now names it through the colour input. Buttons render in the colour they did before the upgrade, not all in the default."
|
|
26
30
|
},
|
|
27
31
|
{
|
|
28
32
|
"id": "ds-button-size-legacy-tier",
|
|
29
33
|
"kind": "value-remap",
|
|
30
34
|
"old": "ds-button[size]",
|
|
31
35
|
"new": null,
|
|
32
|
-
"
|
|
36
|
+
"action": "Apply the map in templates, and remap the same literals in TypeScript: the exported `ButtonSize` narrowed from `s|m|l|sm|md|lg` to `sm|md|lg`, so a field or input typed with it and assigned `'s'`, `'m'` or `'l'` stops compiling.",
|
|
37
|
+
"appliesWhen": "`sm`, `md` and `lg` are unchanged and absent from the map — leave them. A button with no `size` keeps the 40px it had as the old default `l`.",
|
|
38
|
+
"pitfall": "`m`→`sm` and `l`→`md` are pure renames, but `s`→`sm` is not: the 24px tier is gone and `sm` is 32px, so those buttons get **8px taller** and the row around them reflows. It compiles, it looks deliberate, and only a screen shows it.",
|
|
39
|
+
"note": "ButtonSize collapsed to sm|md|lg (32/40/48px at default density) and the duplicate one-letter tier was dropped.",
|
|
33
40
|
"searchHints": [
|
|
34
41
|
"<ds-button",
|
|
35
42
|
"size=\"",
|
|
@@ -41,14 +48,17 @@
|
|
|
41
48
|
"l": "size=\"md\""
|
|
42
49
|
},
|
|
43
50
|
"surface": "template",
|
|
44
|
-
"restore": "nothing to restore - the 24px tier is gone; its callers take sm (32px), and an attribute-less button keeps the same 40px it had as `l`"
|
|
51
|
+
"restore": "nothing to restore - the 24px tier is gone; its callers take sm (32px), and an attribute-less button keeps the same 40px it had as `l`",
|
|
52
|
+
"verify": "No ds-button binds size=\"s\", \"m\" or \"l\". A button left without size renders at the md height (40px), and every button that previously said \"l\" now says \"md\" and is unchanged on screen."
|
|
45
53
|
},
|
|
46
54
|
{
|
|
47
55
|
"id": "ds-button-ts-types-retyped",
|
|
48
56
|
"kind": "behavior",
|
|
49
57
|
"old": "ButtonVariant",
|
|
50
58
|
"new": null,
|
|
51
|
-
"
|
|
59
|
+
"action": "Retype per axis. A union of only hues becomes `ButtonColor` and its bindings move to `[color]`; a union of only fills keeps `ButtonVariant` and remaps its values (secondary→tonal, tertiary→ghost, outline stays); a union carrying both must be split into two.",
|
|
60
|
+
"pitfall": "A mixed union is the one that does not announce itself: it still satisfies neither type cleanly, and the tempting fix — widening it back to `string` — compiles everywhere and moves the failure to runtime, where an unknown value silently falls back to the default.",
|
|
61
|
+
"note": "`ButtonVariant` now holds the fill vocabulary (solid|tonal|ghost|outline|text); the hues moved to a new exported `ButtonColor` (primary|secondary|tertiary|neutral|error|success|warning).",
|
|
52
62
|
"searchHints": [
|
|
53
63
|
"ButtonVariant",
|
|
54
64
|
"ButtonColor"
|
|
@@ -65,7 +75,9 @@
|
|
|
65
75
|
"kind": "behavior",
|
|
66
76
|
"old": "ds-radio",
|
|
67
77
|
"new": null,
|
|
68
|
-
"
|
|
78
|
+
"action": "Wrap every group of `<ds-radio value>` that is bound into a reactive or template-driven form in `<ds-radio-group>`, and move `formControlName` / `[formControl]` / `[(ngModel)]` onto the group.",
|
|
79
|
+
"appliesWhen": "A standalone `<ds-radio [(checked)]>` outside a form is unaffected.",
|
|
80
|
+
"note": "`ds-radio-group` is the container and the form control now: it owns the ControlValueAccessor, the roving tabindex, the `name`, and the group label, invalid and hint.",
|
|
69
81
|
"searchHints": [
|
|
70
82
|
"<ds-radio",
|
|
71
83
|
"formControlName",
|
|
@@ -84,7 +96,8 @@
|
|
|
84
96
|
"kind": "token-rename",
|
|
85
97
|
"old": "--ds-input-hint-color",
|
|
86
98
|
"new": "--ds-field-message-color",
|
|
87
|
-
"
|
|
99
|
+
"action": "Replace `--ds-input-hint-color` with `--ds-field-message-color`.",
|
|
100
|
+
"note": "Helper and error text is rendered by the shared `ds-field-message` now, so the hook reaches every field's message line rather than only the input's.",
|
|
88
101
|
"searchHints": [
|
|
89
102
|
"--ds-input-hint-color"
|
|
90
103
|
],
|
|
@@ -95,7 +108,7 @@
|
|
|
95
108
|
"kind": "token-rename",
|
|
96
109
|
"old": "--ds-input-hint-fs",
|
|
97
110
|
"new": "--ds-field-message-font-size",
|
|
98
|
-
"
|
|
111
|
+
"action": "Replace `--ds-input-hint-fs` with `--ds-field-message-font-size`.",
|
|
99
112
|
"searchHints": [
|
|
100
113
|
"--ds-input-hint-fs"
|
|
101
114
|
],
|
|
@@ -106,7 +119,9 @@
|
|
|
106
119
|
"kind": "behavior",
|
|
107
120
|
"old": "ds-bottom-sheet",
|
|
108
121
|
"new": null,
|
|
109
|
-
"
|
|
122
|
+
"action": "Read every `(closed)` handler and check it does not depend on running in the same tick as the click.",
|
|
123
|
+
"pitfall": "The handlers that break are the ones that look harmless: re-opening the sheet immediately now races the leave animation, and a focus move made in the handler lands while the panel is still on screen and gets taken back.",
|
|
124
|
+
"note": "The close animates, so `(closed)` emits at the END of the leave animation instead of on the click.",
|
|
110
125
|
"searchHints": [
|
|
111
126
|
"<ds-bottom-sheet",
|
|
112
127
|
"(closed)"
|
|
@@ -123,7 +138,9 @@
|
|
|
123
138
|
"kind": "behavior",
|
|
124
139
|
"old": "--ds-button-pressed-shadow",
|
|
125
140
|
"new": null,
|
|
126
|
-
"
|
|
141
|
+
"action": "None, unless you relied on the pressed halo. To keep it, declare `--ds-button-pressed-shadow` explicitly.",
|
|
142
|
+
"appliesWhen": "Only where the token was being read. No usage, no action.",
|
|
143
|
+
"note": "The faint pressed halo now defaults to `none`; press feedback is a darken plus a micro scale-down.",
|
|
127
144
|
"searchHints": [
|
|
128
145
|
"--ds-button-pressed-shadow"
|
|
129
146
|
],
|
|
@@ -136,7 +153,9 @@
|
|
|
136
153
|
"kind": "behavior",
|
|
137
154
|
"old": "ds-button",
|
|
138
155
|
"new": null,
|
|
139
|
-
"
|
|
156
|
+
"action": "Look at the disabled state of every button variant you actually use. To go back to the flat grey, pin the per-variant `--ds-button-*-disabled` / `--ds-icon-button-*-disabled` hooks.",
|
|
157
|
+
"pitfall": "The tint is derived from each variant's own colour, so a brand that recoloured one variant gets a disabled state it never chose — and because nothing in the API moved, no build or type check points at it.",
|
|
158
|
+
"note": "Disabled is a per-variant muted tint now rather than one flat grey: solid and text take a flat pale oklch tint, while tonal, ghost, outline and the icon-button tonal and outlined variants use `color-mix` with `--surface-disabled`.",
|
|
140
159
|
"searchHints": [
|
|
141
160
|
"<ds-button",
|
|
142
161
|
"<ds-icon-button"
|
|
@@ -150,7 +169,9 @@
|
|
|
150
169
|
"kind": "behavior",
|
|
151
170
|
"old": "ds-modal",
|
|
152
171
|
"new": null,
|
|
153
|
-
"
|
|
172
|
+
"action": "Read every close-related handler on `ds-modal` and `ds-drawer` and check it does not depend on running in the same tick as the dismiss.",
|
|
173
|
+
"pitfall": "Same shape as the bottom sheet: an immediate re-open races the leave animation, and a focus hand-off made in the handler lands while the panel is still visible.",
|
|
174
|
+
"note": "Both animate their close now — animate-then-remove, like ds-bottom-sheet — and honour `prefers-reduced-motion`, so close-related outputs fire at the end of the leave animation.",
|
|
154
175
|
"searchHints": [
|
|
155
176
|
"<ds-modal",
|
|
156
177
|
"<ds-drawer"
|
|
@@ -169,7 +190,9 @@
|
|
|
169
190
|
"kind": "code-add",
|
|
170
191
|
"old": null,
|
|
171
192
|
"new": "@use '@ids-group-ltd/ids-design-system/styles/breakpoints';",
|
|
172
|
-
"
|
|
193
|
+
"action": "Add the `@use` beside your existing `styles/tokens` import.",
|
|
194
|
+
"appliesWhen": "Only if you import `styles/tokens` a la carte. The `styles/ds` entry forwards both, so its users need nothing.",
|
|
195
|
+
"note": "The `--bp-*` custom properties moved into a new `styles/breakpoints` partial, so a tokens-only importer no longer gets them.",
|
|
173
196
|
"searchHints": [
|
|
174
197
|
"styles/tokens",
|
|
175
198
|
"@use '@ids-group-ltd/ids-design-system/styles/tokens'"
|
|
@@ -184,5 +207,6 @@
|
|
|
184
207
|
"ds-button overlay-trigger inputs (ariaHasPopup/ariaExpanded/buttonRef); date-picker month/year grid pickers; table pagination/clientSort/stickyFirstColumn; ModalService.confirm(); dropzone per-file message + queued state — additive.",
|
|
185
208
|
"$bp-* Sass breakpoint aliases + up()/down() mixins; new disabled-state and press-scale override tokens — additive (a-la-carte styles/tokens importers also need styles/breakpoints now).",
|
|
186
209
|
"Visual-only: button/icon-button press is darken + micro scale-down; [disabled] is a per-variant muted tint (override --ds-*-disabled tokens to restore flat grey); smooth motion pass across components; reduced-motion no longer freezes spinners; overlay scroll-lock release fix."
|
|
187
|
-
]
|
|
210
|
+
],
|
|
211
|
+
"deleteList": []
|
|
188
212
|
}
|
package/migrations/0.5.0.json
CHANGED
|
@@ -6,7 +6,8 @@
|
|
|
6
6
|
"kind": "selector-rename",
|
|
7
7
|
"old": "ds-combobox",
|
|
8
8
|
"new": "ds-autocomplete",
|
|
9
|
-
"
|
|
9
|
+
"action": "Replace the element selector `ds-combobox` with `ds-autocomplete`.",
|
|
10
|
+
"note": "A rename to the industry word for the control. Behaviour is unchanged.",
|
|
10
11
|
"searchHints": [
|
|
11
12
|
"<ds-combobox",
|
|
12
13
|
"ds-combobox"
|
|
@@ -18,7 +19,7 @@
|
|
|
18
19
|
"kind": "type-rename",
|
|
19
20
|
"old": "ComboboxComponent",
|
|
20
21
|
"new": "AutocompleteComponent",
|
|
21
|
-
"
|
|
22
|
+
"action": "Replace `ComboboxComponent` with `AutocompleteComponent` in imports and references.",
|
|
22
23
|
"searchHints": [
|
|
23
24
|
"ComboboxComponent"
|
|
24
25
|
],
|
|
@@ -29,7 +30,8 @@
|
|
|
29
30
|
"kind": "type-rename",
|
|
30
31
|
"old": "ComboboxOption",
|
|
31
32
|
"new": "AutocompleteOption",
|
|
32
|
-
"
|
|
33
|
+
"action": "Replace `ComboboxOption` with `AutocompleteOption`, matching whole identifiers.",
|
|
34
|
+
"pitfall": "`ComboboxOptionGroup` CONTAINS `ComboboxOption`. A substring replace run on the short name first corrupts the long one into a name that exists nowhere. Apply the group item first, or match whole identifiers.",
|
|
33
35
|
"searchHints": [
|
|
34
36
|
"ComboboxOption"
|
|
35
37
|
],
|
|
@@ -40,7 +42,7 @@
|
|
|
40
42
|
"kind": "type-rename",
|
|
41
43
|
"old": "ComboboxOptionGroup",
|
|
42
44
|
"new": "AutocompleteOptionGroup",
|
|
43
|
-
"
|
|
45
|
+
"action": "Replace `ComboboxOptionGroup` with `AutocompleteOptionGroup`. Apply this before the shorter `ComboboxOption`.",
|
|
44
46
|
"searchHints": [
|
|
45
47
|
"ComboboxOptionGroup"
|
|
46
48
|
],
|
|
@@ -51,7 +53,7 @@
|
|
|
51
53
|
"kind": "type-rename",
|
|
52
54
|
"old": "ComboboxSize",
|
|
53
55
|
"new": "AutocompleteSize",
|
|
54
|
-
"
|
|
56
|
+
"action": "Replace `ComboboxSize` with `AutocompleteSize`.",
|
|
55
57
|
"searchHints": [
|
|
56
58
|
"ComboboxSize"
|
|
57
59
|
],
|
|
@@ -62,7 +64,7 @@
|
|
|
62
64
|
"kind": "type-rename",
|
|
63
65
|
"old": "ComboboxWidth",
|
|
64
66
|
"new": "AutocompleteWidth",
|
|
65
|
-
"
|
|
67
|
+
"action": "Replace `ComboboxWidth` with `AutocompleteWidth`.",
|
|
66
68
|
"searchHints": [
|
|
67
69
|
"ComboboxWidth"
|
|
68
70
|
],
|
|
@@ -73,7 +75,7 @@
|
|
|
73
75
|
"kind": "token-rename",
|
|
74
76
|
"old": "--ds-combobox-",
|
|
75
77
|
"new": "--ds-autocomplete-",
|
|
76
|
-
"
|
|
78
|
+
"action": "Replace the prefix `--ds-combobox-` with `--ds-autocomplete-` inside each full token name: `-focus-shadow`, `-maxw`, `-input-minw`.",
|
|
77
79
|
"searchHints": [
|
|
78
80
|
"--ds-combobox-"
|
|
79
81
|
],
|
|
@@ -84,7 +86,9 @@
|
|
|
84
86
|
"kind": "behavior",
|
|
85
87
|
"old": "#combobox",
|
|
86
88
|
"new": null,
|
|
87
|
-
"
|
|
89
|
+
"action": "Update any hardcoded documentation link pointing at `#combobox` to `#autocomplete`.",
|
|
90
|
+
"appliesWhen": "Only where a link to the docs site is written into your own code or README.",
|
|
91
|
+
"note": "The docs page moved with the component rename, so the fragment that used to address it no longer resolves and the link lands at the top of the page.",
|
|
88
92
|
"searchHints": [
|
|
89
93
|
"#combobox"
|
|
90
94
|
],
|
|
@@ -102,7 +106,8 @@
|
|
|
102
106
|
"kind": "selector-rename",
|
|
103
107
|
"old": "ds-dropdown",
|
|
104
108
|
"new": "ds-select",
|
|
105
|
-
"
|
|
109
|
+
"action": "Replace `ds-dropdown` with `ds-select`, then apply `dropdown-error-input-rename` and `dropdown-option-groups-fold` to the same elements.",
|
|
110
|
+
"note": "ds-dropdown is gone; ds-select is the one select-only picker, and it carries the CVA, invalid and hint, required and optional, per-option icons and readOnly.",
|
|
106
111
|
"searchHints": [
|
|
107
112
|
"<ds-dropdown",
|
|
108
113
|
"ds-dropdown"
|
|
@@ -114,7 +119,7 @@
|
|
|
114
119
|
"kind": "input-rename",
|
|
115
120
|
"old": "ds-dropdown[error]",
|
|
116
121
|
"new": "invalid",
|
|
117
|
-
"
|
|
122
|
+
"action": "On elements you moved from `ds-dropdown` to `ds-select`, rename `[error]` to `[invalid]` and `error=\"…\"` to `invalid=\"…\"`.",
|
|
118
123
|
"searchHints": [
|
|
119
124
|
"[error]=",
|
|
120
125
|
"error=\""
|
|
@@ -126,7 +131,9 @@
|
|
|
126
131
|
"kind": "behavior",
|
|
127
132
|
"old": "ds-dropdown[optionGroups]",
|
|
128
133
|
"new": null,
|
|
129
|
-
"
|
|
134
|
+
"action": "Merge the flat options and the groups into one `[options]` array. `SelectItem` is `SelectOption | SelectOptionGroup`, so both shapes sit in the same list.",
|
|
135
|
+
"pitfall": "The array order IS the render order now. Two separate inputs used to be rendered in a fixed sequence, so concatenating them the other way round silently reshuffles the list and nothing warns.",
|
|
136
|
+
"note": "`[optionGroups]` no longer exists on ds-select.",
|
|
130
137
|
"searchHints": [
|
|
131
138
|
"[optionGroups]="
|
|
132
139
|
],
|
|
@@ -145,7 +152,7 @@
|
|
|
145
152
|
"kind": "type-rename",
|
|
146
153
|
"old": "DropdownComponent",
|
|
147
154
|
"new": "SelectComponent",
|
|
148
|
-
"
|
|
155
|
+
"action": "Replace `DropdownComponent` with `SelectComponent` in imports and references.",
|
|
149
156
|
"searchHints": [
|
|
150
157
|
"DropdownComponent"
|
|
151
158
|
],
|
|
@@ -156,7 +163,8 @@
|
|
|
156
163
|
"kind": "type-rename",
|
|
157
164
|
"old": "DropdownOption",
|
|
158
165
|
"new": "SelectOption",
|
|
159
|
-
"
|
|
166
|
+
"action": "Replace `DropdownOption` with `SelectOption`, matching whole identifiers.",
|
|
167
|
+
"pitfall": "`DropdownOptionGroup` contains `DropdownOption`. Apply the group item first, or match whole identifiers — a substring replace corrupts the longer name.",
|
|
160
168
|
"searchHints": [
|
|
161
169
|
"DropdownOption"
|
|
162
170
|
],
|
|
@@ -167,7 +175,7 @@
|
|
|
167
175
|
"kind": "type-rename",
|
|
168
176
|
"old": "DropdownOptionGroup",
|
|
169
177
|
"new": "SelectOptionGroup",
|
|
170
|
-
"
|
|
178
|
+
"action": "Replace `DropdownOptionGroup` with `SelectOptionGroup`. Apply this before the shorter `DropdownOption`.",
|
|
171
179
|
"searchHints": [
|
|
172
180
|
"DropdownOptionGroup"
|
|
173
181
|
],
|
|
@@ -178,7 +186,7 @@
|
|
|
178
186
|
"kind": "type-rename",
|
|
179
187
|
"old": "DropdownSize",
|
|
180
188
|
"new": "SelectSize",
|
|
181
|
-
"
|
|
189
|
+
"action": "Replace `DropdownSize` with `SelectSize`.",
|
|
182
190
|
"searchHints": [
|
|
183
191
|
"DropdownSize"
|
|
184
192
|
],
|
|
@@ -189,7 +197,8 @@
|
|
|
189
197
|
"kind": "token-rename",
|
|
190
198
|
"old": "--ds-datepicker-",
|
|
191
199
|
"new": "--ds-date-picker-",
|
|
192
|
-
"
|
|
200
|
+
"action": "Replace the prefix `--ds-datepicker-` with `--ds-date-picker-` inside each full token name — about fourteen tokens.",
|
|
201
|
+
"note": "Names only: the prefix matches the selector now, and every value and CSS property is byte-identical.",
|
|
193
202
|
"searchHints": [
|
|
194
203
|
"--ds-datepicker-"
|
|
195
204
|
],
|
|
@@ -200,7 +209,8 @@
|
|
|
200
209
|
"kind": "token-rename",
|
|
201
210
|
"old": "--ds-statusdot-",
|
|
202
211
|
"new": "--ds-status-dot-",
|
|
203
|
-
"
|
|
212
|
+
"action": "Replace the prefix `--ds-statusdot-` with `--ds-status-dot-` inside each full token name — `-color` and `-size`.",
|
|
213
|
+
"note": "Names only: the prefix matches the selector now, and every value and CSS property is byte-identical.",
|
|
204
214
|
"searchHints": [
|
|
205
215
|
"--ds-statusdot-"
|
|
206
216
|
],
|
|
@@ -211,7 +221,8 @@
|
|
|
211
221
|
"kind": "token-rename",
|
|
212
222
|
"old": "--ds-pagehdr-",
|
|
213
223
|
"new": "--ds-page-header-",
|
|
214
|
-
"
|
|
224
|
+
"action": "Replace the prefix `--ds-pagehdr-` with `--ds-page-header-` inside each full token name — the page-header hooks.",
|
|
225
|
+
"note": "Names only: the prefix matches the selector now, and every value and CSS property is byte-identical.",
|
|
215
226
|
"searchHints": [
|
|
216
227
|
"--ds-pagehdr-"
|
|
217
228
|
],
|
|
@@ -222,7 +233,8 @@
|
|
|
222
233
|
"kind": "token-rename",
|
|
223
234
|
"old": "--ds-avatargroup-",
|
|
224
235
|
"new": "--ds-avatar-group-",
|
|
225
|
-
"
|
|
236
|
+
"action": "Replace the prefix `--ds-avatargroup-` with `--ds-avatar-group-` inside each full token name — `-overlap`, `-ring`, `-overflow-bg-color` and `-overflow-label-color`.",
|
|
237
|
+
"note": "Names only: the prefix matches the selector now, and every value and CSS property is byte-identical.",
|
|
226
238
|
"searchHints": [
|
|
227
239
|
"--ds-avatargroup-"
|
|
228
240
|
],
|
|
@@ -233,7 +245,10 @@
|
|
|
233
245
|
"kind": "class-rename",
|
|
234
246
|
"old": "ds-search .input",
|
|
235
247
|
"new": ".search-input",
|
|
236
|
-
"
|
|
248
|
+
"action": "Rename `.input` to `.search-input` in selectors scoped under `ds-search`.",
|
|
249
|
+
"appliesWhen": "Only if you styled the undocumented inner class. Nothing in the public API moved.",
|
|
250
|
+
"pitfall": "Scope the replace to selectors under ds-search. `.input` is generic enough that a repo-wide rename hits your own unrelated rules — the same leak this rename exists to stop.",
|
|
251
|
+
"note": "The inner input class was over-generic, so a consumer global `.input` rule leaked into the component.",
|
|
237
252
|
"searchHints": [
|
|
238
253
|
"ds-search"
|
|
239
254
|
],
|
|
@@ -244,7 +259,9 @@
|
|
|
244
259
|
"kind": "behavior",
|
|
245
260
|
"old": "ds-date-picker",
|
|
246
261
|
"new": null,
|
|
247
|
-
"
|
|
262
|
+
"action": "Look at every date picker. For the old click-only field pass `[allowInput]=\"false\"`; to keep it full-width, set a width on the host.",
|
|
263
|
+
"pitfall": "Two defaults moved at once and neither breaks a build: the field went from full-width to content-width, so a picker that used to fill its column now sits narrow inside it and the layout tuned around it has a hole.",
|
|
264
|
+
"note": "The trigger is an editable masked text input by default (allowInput defaults to true) with a trailing calendar icon, and it sizes to its content.",
|
|
248
265
|
"searchHints": [
|
|
249
266
|
"<ds-date-picker"
|
|
250
267
|
],
|
|
@@ -264,7 +281,9 @@
|
|
|
264
281
|
"kind": "behavior",
|
|
265
282
|
"old": "ds-date-picker",
|
|
266
283
|
"new": null,
|
|
267
|
-
"
|
|
284
|
+
"action": "If your readers are not en-US, set the locale: `[locale]` per instance, or `provideDsConfig({ datePicker: { locale } })` app-wide.",
|
|
285
|
+
"pitfall": "The old display followed the ambient browser locale, so on your own machine nothing need look different while an en-GB or de reader sees a silently reformatted date. No markup changes and nothing logs.",
|
|
286
|
+
"note": "The value display resolves `[locale] ?? provideDsConfig datePicker.locale ?? 'en-US'` instead of calling toLocaleDateString() with the browser default.",
|
|
268
287
|
"searchHints": [
|
|
269
288
|
"<ds-date-picker",
|
|
270
289
|
"toLocaleDateString"
|
|
@@ -286,7 +305,8 @@
|
|
|
286
305
|
"kind": "behavior",
|
|
287
306
|
"old": "ds-search",
|
|
288
307
|
"new": null,
|
|
289
|
-
"
|
|
308
|
+
"action": "To keep the old cap, set `--ds-search-maxw: 320px` on the host or in your theme.",
|
|
309
|
+
"note": "The default max-width went from 320px to none, so ds-search stretches like the rest of the field family.",
|
|
290
310
|
"searchHints": [
|
|
291
311
|
"<ds-search"
|
|
292
312
|
],
|
|
@@ -299,7 +319,10 @@
|
|
|
299
319
|
"kind": "behavior",
|
|
300
320
|
"old": "ds-card[elevation=interactive]",
|
|
301
321
|
"new": null,
|
|
302
|
-
"
|
|
322
|
+
"action": "If you hand-rolled keyboard activation on an interactive card — a `(keydown.enter)` or `(keydown.space)` that fires the same action — delete it.",
|
|
323
|
+
"appliesWhen": "Only cards carrying `elevation=\"interactive\"`. Others are untouched, and so is anyone who never faked the keyboard path.",
|
|
324
|
+
"pitfall": "Leaving the workaround makes the action fire TWICE on one key press, because the native activation runs beside it. A double submit or a double navigation is the symptom, and it shows only on the keyboard — a mouse test passes.",
|
|
325
|
+
"note": "`elevation=\"interactive\"` is natively keyboard-activatable now: Enter and Space trigger the click, with role=\"button\" and a tabindex.",
|
|
303
326
|
"searchHints": [
|
|
304
327
|
"elevation=\"interactive\"",
|
|
305
328
|
"elevation=interactive"
|
|
@@ -321,5 +344,6 @@
|
|
|
321
344
|
"Selection controls gain size + required; standalone ds-radio gains invalid/hint; input/textarea maxLength counter; date-picker minDate/maxDate/disabledDate/presets + locale/dateFormat/firstDayOfWeek/defaultMonth manual masked entry; select clearable/icons/readOnly; autocomplete optionGroups/allowCreate/width=content; table expandable rows; modal closeOnBackdrop/persistent/xl/fullscreen; drawer placement/sm; bottom-sheet snapPoints; toast loading/promise/maxVisible; menu dividers/submenus; popover arrow/placement; tabs lazy/scrollable/closable/vertical; accordion single-open/item disabled; stepper clickable/errorSteps/vertical; sidenav collapsed tooltip; badge count/max; avatar status/fallbackIcon — all additive.",
|
|
322
345
|
"Public --ds-* customization token sweep across ~44 components (~160-180 new names) — purely additive resolvers, zero visual change when unset.",
|
|
323
346
|
"Visual-only: rounded press feedback (+ --ds-press-brightness/--ds-press-scale tuning tokens) and native tap-highlight suppression; accessibility hardening across overlays/pickers/fields/cards (dialog semantics, Tab close, role=alert re-announce, labels)."
|
|
324
|
-
]
|
|
347
|
+
],
|
|
348
|
+
"deleteList": []
|
|
325
349
|
}
|
|
@@ -27,9 +27,7 @@ There are three moving parts:
|
|
|
27
27
|
`[data-status='…']` rules that set the public component tokens:
|
|
28
28
|
|
|
29
29
|
```scss
|
|
30
|
-
// external consumer of the published package:
|
|
31
30
|
@use '@ids-group-ltd/ids-design-system/styles/status' as status;
|
|
32
|
-
// inside this repo (ds-docs, loadPaths: src/lib): @use 'styles/status' as status;
|
|
33
31
|
|
|
34
32
|
@include status.define(
|
|
35
33
|
(
|
|
@@ -178,4 +176,4 @@ ds-badge.chip.in-transit { … } // .chip now carries layout rules only
|
|
|
178
176
|
```
|
|
179
177
|
|
|
180
178
|
This unifies every badge on one mechanism and restores the values that used to rely on factory
|
|
181
|
-
colours.
|
|
179
|
+
colours.
|