@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.
Files changed (58) hide show
  1. package/CHANGELOG.md +1376 -904
  2. package/components.md +61 -30
  3. package/design-system.md +18 -18
  4. package/fesm2022/ids-group-ltd-ids-design-system.mjs +992 -486
  5. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  6. package/migrations/0.1.0.json +2 -1
  7. package/migrations/0.10.0.json +219 -42
  8. package/migrations/0.10.1.json +50 -13
  9. package/migrations/0.10.2.json +90 -24
  10. package/migrations/0.10.3.json +22 -5
  11. package/migrations/0.11.0.json +216 -0
  12. package/migrations/0.11.1.json +305 -0
  13. package/migrations/0.2.0.json +22 -9
  14. package/migrations/0.2.1.json +2 -1
  15. package/migrations/0.2.2.json +3 -2
  16. package/migrations/0.3.0.json +16 -10
  17. package/migrations/0.4.0.json +38 -14
  18. package/migrations/0.5.0.json +49 -25
  19. package/migrations/0.5.1/badge-statuses.md +1 -3
  20. package/migrations/0.5.1.json +75 -33
  21. package/migrations/0.6.0.json +6 -2
  22. package/migrations/0.6.1.json +19 -1
  23. package/migrations/0.6.2.json +3 -1
  24. package/migrations/0.6.3.json +13 -4
  25. package/migrations/0.7.0.json +45 -26
  26. package/migrations/0.7.1.json +58 -20
  27. package/migrations/0.8.0.json +53 -15
  28. package/migrations/0.9.0.json +147 -27
  29. package/migrations/0.9.1.json +4 -3
  30. package/migrations/README.md +34 -52
  31. package/package.json +2 -1
  32. package/styles/_dropdown-overlay.scss +35 -13
  33. package/styles/_ds-color.scss +3 -3
  34. package/styles/_field-box.scss +2 -6
  35. package/styles/_field-label.scss +5 -10
  36. package/styles/_field-state.scss +3 -2
  37. package/styles/_focus.scss +0 -2
  38. package/styles/_layout-utils.scss +2 -2
  39. package/styles/_link.scss +1 -2
  40. package/styles/_overlay-motion.scss +2 -4
  41. package/styles/_press.scss +3 -5
  42. package/styles/_reset.scss +0 -1
  43. package/styles/_scrollbar.scss +1 -3
  44. package/styles/_status.scss +1 -2
  45. package/styles/_surface-motion.scss +3 -4
  46. package/styles/_text-clip.scss +1 -1
  47. package/styles/_theme-activation.scss +1 -1
  48. package/styles/_tokens-charts.scss +1 -3
  49. package/styles/_tokens.scss +4 -3
  50. package/styles/_typography.scss +2 -2
  51. package/themes/README.md +3 -3
  52. package/themes/_base-palette.scss +2 -2
  53. package/themes/_semantic.scss +2 -2
  54. package/themes/dark/_palette.scss +1 -2
  55. package/themes/light/_palette.scss +1 -1
  56. package/themes/light/_theme.scss +1 -1
  57. package/types/ids-group-ltd-ids-design-system.d.ts +403 -108
  58. package/migrations/AUTHORING.md +0 -273
@@ -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, maintainer docs moved to repo-only CONTRIBUTING.md, README license entry made plain text (fixes the npm 404). No consumer action."
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
  }
@@ -6,7 +6,10 @@
6
6
  "kind": "token-rename",
7
7
  "old": "--ds-*-bg",
8
8
  "new": "--ds-*-bg-color",
9
- "note": "Every DS background token was renamed by appending -color (they held only a colour and now feed background-color). Pattern: any DS token whose name ENDS in -bg gains the -color suffix. Covers all public --ds-<component>-...-bg hooks (avatar, badge, banner, button, card, date-picker, dropzone, empty-state, icon-button, input, modal, pagination, search, sidenav, stat, table, tabs, tag, toast, topbar) PLUS the globals --select-bg, --chart-hover-bg, --chart-tooltip-bg and the --status-<x>-bg set. Only DS tokens are affected — a consumer's OWN variables ending in -bg are not. When unsure whether a token is DS-owned, confirm the new name exists in the installed 0.3.0 package (themes/, styles/). The changelog also renamed private `--_*` internal tokens in lockstep, but those are never consumer-facing (no public --ds- hook) — no consumer action for them.",
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
- "note": "Every DS foreground token dropped the fg abbreviation for a SEMANTIC suffix — the replacement varies per token: text/titles/inputs -> -text-color; control & nav labels -> -label-color; icons/glyphs -> -icon-color. Examples: --ds-modal-title-fg -> --ds-modal-title-text-color; --ds-sidenav-group-fg -> --ds-sidenav-group-label-color; --ds-icon-button-fg -> --ds-icon-button-icon-color. Covers all public --ds-<component>-...-fg hooks (avatar, badge, banner, breadcrumbs, button, date-picker, dropzone, empty-state, icon-button, input, menu, modal, page-header, pagination, search, sidenav, table, tabs, tag, topbar) plus the --status-* and chart-tooltip globals. For EACH consumer-overridden -fg token, resolve the exact new name by looking it up in the 0.3.0 sources (themes/ + styles/ + component SCSS in the checkout or installed package) — do not guess the semantic suffix. Only DS-owned tokens are affected — a consumer's OWN variable ending in -fg is not; when unsure whether a name is DS-owned, confirm the new name exists in the installed 0.3.0 package (themes/ + styles/ + component SCSS).",
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
- "note": "ds-stepper now renders the captions passed via [steps] as VISIBLE labels (previously screen-reader-only; only numbers showed) — a visual change for existing usages. Usually no code change: review that existing captions read well as visible labels; the new labelPosition input (bottom | inline, default bottom) adjusts the layout. Flag for visual review (eyeball).",
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
- "ds-stepper",
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
  }
@@ -6,7 +6,10 @@
6
6
  "kind": "value-remap",
7
7
  "old": "ds-button[variant]",
8
8
  "new": null,
9
- "note": "The single conflated `variant` input split into two orthogonal axes: `color` (primary|secondary|tertiary|neutral|error|success|warning, default primary) x `variant` (solid|tonal|ghost|outline|text, default solid). Static values migrate per the map. DYNAMIC `[variant]=\"expr\"` bindings whose expression yields only hue values (primary/error/success/warning) rebind to `[color]=\"expr\"` verbatim; expressions/fields typed with a mixed-axis union must be retyped to the new fill vocabulary and split per axis. `variant=\"text\"` stays valid (its map entry is an identity — same token in, same out — so the applier leaves it untouched); it is discouraged at runtime (dev-mode console.warn — prefer the global `.link` class) but requires no code migration.",
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
- "note": "ButtonSize collapsed to sm|md|lg (32/40/48px); the duplicate legacy one-letter tier is dropped. sm/md/lg values are unchanged (absent from the map — leave them). Default is now md (was l — same 40px, no action for attribute-less buttons). The 24px `s` is removed — its callers move to sm (32px, the closest). The exported TS type `ButtonSize` narrowed in lockstep from the old `s|m|l|sm|md|lg` superset to `sm|md|lg`: a consumer who typed a field/variable/input with `ButtonSize` and assigned a legacy literal (`'s'`/`'m'`/`'l'`) now gets a compile error — remap those literals the same way (`s`/`m`->`sm`, `l`->`md`).",
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
- "note": "The exported ButtonVariant union changed to the fill vocabulary (solid|tonal|ghost|outline|text); hue values moved to the NEW exported ButtonColor (primary|secondary|tertiary|neutral|error|success|warning). Consumer TS importing ButtonVariant, or typing its own fields/inputs with the old values: a purely-hue union retypes to ButtonColor (and its bindings move to [color]); a purely-fill union remaps values (secondary->tonal, tertiary->ghost, outline stays outline); a mixed-axis union must be split per axis.",
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
- "note": "Reactive-forms radio now uses the new <ds-radio-group> as the group container and form control (ControlValueAccessor, roving tabindex, name, group label/invalid/hint). A group of <ds-radio value> bound into a reactive form (formControlName/[formControl]/[(ngModel)] on the group) must be wrapped in <ds-radio-group>. Standalone <ds-radio [(checked)]> is unaffected.",
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
- "note": "Field helper/error text is now rendered by the shared ds-field-message; the new hook applies to EVERY field's helper/error line, not just input.",
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
- "note": "Same field-message consolidation as input-hint-color-token.",
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
- "note": "ds-bottom-sheet now animates its close; the (closed) output emits at the END of the leave animation instead of on the click. Review (closed) handlers that assumed synchronous-on-click ordering (immediate re-open, focus timing); usually no change is needed.",
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
- "note": "The old faint pressed halo now defaults to `none` (press feedback became darken + micro scale-down). Only consumers who RELIED on the halo act: set --ds-button-pressed-shadow explicitly to re-enable. No usage -> no action.",
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
- "note": "Default DISABLED appearance changed: `[disabled]` is now a per-variant muted tint derived from each variant's own colour (solid + text use a flat pale oklch tint; tonal/ghost/outline and icon-button tonal/outlined use color-mix with --surface-disabled), not one flat grey. Visual-only, no API change. To restore the old flat grey, override the per-variant `--ds-button-*-disabled` / `--ds-icon-button-*-disabled` tokens. Most consumers take no action — eyeball the disabled states.",
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
- "note": "ds-modal and ds-drawer now animate their close (animate-then-remove, like ds-bottom-sheet) instead of vanishing instantly; honors prefers-reduced-motion. Any close-related output/teardown fires at the END of the leave animation, not synchronously on the dismiss click — review handlers that assumed synchronous-on-click ordering (immediate re-open, focus hand-off). Usually no change needed.",
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
- "note": "Only consumers who import `styles/tokens` A LA CARTE (not via the `styles/ds` entry, which forwards both): the `--bp-*` custom properties moved into the new `styles/breakpoints` partial, so an a-la-carte tokens importer must now also `@use` styles/breakpoints to keep `--bp-*` defined. Consumers using `styles/ds` need no action.",
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
  }
@@ -6,7 +6,8 @@
6
6
  "kind": "selector-rename",
7
7
  "old": "ds-combobox",
8
8
  "new": "ds-autocomplete",
9
- "note": "Component renamed (clearer industry name); behavior unchanged.",
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
- "note": "TS import/reference rename only.",
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
- "note": "TS type rename. Beware token boundaries: ComboboxOptionGroup contains ComboboxOption — rename the longer identifier first (its own item).",
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
- "note": "TS type rename.",
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
- "note": "TS type rename.",
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
- "note": "TS type rename.",
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
- "note": "Prefix rename covering --ds-combobox-focus-shadow / -maxw / -input-minw; replace within each full suffixed name.",
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
- "note": "Docs-site anchor renamed #combobox -> #autocomplete; update any hardcoded documentation links in consumer code/README.",
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
- "note": "ds-dropdown removed; ds-select is the canonical select-only picker (CVA, invalid+hint, required/optional, per-option icons, readOnly). After the selector rename also apply dropdown-error-input-rename and dropdown-option-groups-fold (separate items).",
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
- "note": "On elements migrated from ds-dropdown to ds-select: [error] -> [invalid] (and static error=\"...\" -> invalid=\"...\").",
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
- "note": "[optionGroups]=\"groups\" is gone on ds-select — pass groups inline in [options]: SelectItem = SelectOption | SelectOptionGroup, so merge the flat options and the groups into one [options] array (order = desired render order).",
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
- "note": "TS import/reference rename.",
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
- "note": "TS type rename. Token boundaries: DropdownOptionGroup contains DropdownOption — rename the longer identifier first.",
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
- "note": "TS type rename.",
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
- "note": "TS type rename.",
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
- "note": "Prefix normalized to match the selector (~14 tokens). Names only — CSS property and defaults byte-identical. Replace within each full suffixed name.",
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
- "note": "Prefix normalized (color, size). Names only.",
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
- "note": "Prefix normalized (~10 tokens: eyebrow/title/subtitle/meta/crumb colors, meta-icon-color, divider, title-fs, title-gap). Names only.",
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
- "note": "Prefix normalized (overlap, ring, overflow-bg-color, overflow-label-color). Names only.",
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
- "note": "ds-search's inner input class renamed (over-generic .input let consumer global styles leak in). Only consumer STYLING that targeted the undocumented internal class is affected — scope strictly to selectors under ds-search.",
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
- "note": "Trigger is now an editable masked text input by default (allowInput defaults true) with a trailing calendar icon, and the field sizes to CONTENT width (was full-width). Pass [allowInput]=\"false\" for the old click-only field; set a width on the host to stretch. Usually no code change — flag for visual review (eyeball).",
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
- "note": "The selected-date/value display now defaults to `en-US` formatting via the new `locale` input (effective locale = [locale] ?? provideDsConfig datePicker.locale ?? 'en-US'), replacing the previous ambient browser `toLocaleDateString()`. A consumer whose users run a non-US browser locale (en-GB, de, fr, ...) will see a silently DIFFERENT date format with no markup change. To restore OS/ambient-driven display, set `[locale]` per instance or `provideDsConfig({ datePicker: { locale } })` app-wide.",
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
- "note": "Default max-width changed 320px -> none (ds-search now stretches like the rest of the field family). If the 320px cap was relied on, set --ds-search-maxw: 320px on the host/theme. Usually visual-review only.",
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
- "note": "ds-card with the pre-existing `elevation=\"interactive\"` value is now natively keyboard-activatable (Enter/Space trigger the click, with role=\"button\" + tabindex) — new runtime behavior on existing markup. If a consumer hand-rolled a keyboard workaround (a custom (keydown.enter)/(keydown.space) that also fires the action), it now DOUBLE-fires with the native activation — remove the workaround. Cards without elevation=\"interactive\", and consumers who never faked keyboard activation, need no action.",
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. See the field app's `_badge-status.scss` for a full real-world map.
179
+ colours.