@ids-group-ltd/ids-design-system 0.6.3 → 0.7.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.
@@ -102,6 +102,52 @@
102
102
  "--ds-menu-item-danger-label-color"
103
103
  ]
104
104
  },
105
+ {
106
+ "id": "modal-card-danger-class-rename",
107
+ "kind": "class-rename",
108
+ "old": "ds-modal .danger",
109
+ "new": ".error",
110
+ "note": "The status-vocabulary rename also renamed the class the card puts on its root: [danger] used to emit `danger`, [error] now emits `error`. The input-rename item fixes the BINDING; a consumer stylesheet that keys off the class needs this one, and nothing in the binding rename would find it. Scope strictly to selectors under ds-modal / ds-modal-card.",
111
+ "searchHints": [
112
+ "ds-modal",
113
+ "ds-modal-card",
114
+ ".modal.danger",
115
+ "&.danger"
116
+ ]
117
+ },
118
+ {
119
+ "id": "menu-item-danger-class-rename",
120
+ "kind": "class-rename",
121
+ "old": "ds-menu-item .danger",
122
+ "new": ".error",
123
+ "note": "Same rename on ds-menu-item: the host used to carry `danger`, it now carries `error`. Consumer STYLING only.",
124
+ "searchHints": [
125
+ "ds-menu-item",
126
+ ".danger"
127
+ ]
128
+ },
129
+ {
130
+ "id": "stat-danger-class-rename",
131
+ "kind": "class-rename",
132
+ "old": "ds-stat .danger",
133
+ "new": ".error",
134
+ "note": "ds-stat's variant value moved danger -> error, and the host class follows it (host binding [class.error]). Consumer STYLING only; the value-remap item covers the binding.",
135
+ "searchHints": [
136
+ "ds-stat",
137
+ ".danger"
138
+ ]
139
+ },
140
+ {
141
+ "id": "progress-danger-class-rename",
142
+ "kind": "class-rename",
143
+ "old": "ds-progress .danger",
144
+ "new": ".error",
145
+ "note": "Same as ds-stat: variant value danger -> error with a matching host class. Consumer STYLING only.",
146
+ "searchHints": [
147
+ "ds-progress",
148
+ ".danger"
149
+ ]
150
+ },
105
151
  {
106
152
  "id": "progress-bar-warn-token-rename",
107
153
  "kind": "token-rename",
@@ -22,6 +22,17 @@
22
22
  "<ds-table",
23
23
  "rowInteractive"
24
24
  ]
25
+ },
26
+ {
27
+ "id": "table-component-subclass-member-collisions",
28
+ "kind": "behavior",
29
+ "old": null,
30
+ "new": null,
31
+ "note": "Only affects a consumer that EXTENDS the DS TableComponent class. Subclassing a DS component is unsupported (design-system.md - Components), but where it happens this release breaks the build: the new column API added ~76 members to TableComponent, so a subclass that already used one of those names no longer compiles — TS4114 requires an 'override' modifier, TS2416 fires where the signature differs. Collisions observed: zebra, columnOrder, orderedColumns, visibleColumns, toggleColumn, onColumnDrop, moveColumn, resetColumns, columnFilters, exportCsv, onResizeMove, onResizeEnd. Resolution per member: where the base member means the same thing, keep the name and add `override` with a base-compatible signature (zebra must adopt the base's booleanAttribute transform); otherwise RENAME the subclass's own member — the private/protected ones are internal to the component and its own template, so renaming is behaviour-preserving, but check the new name against the base's member list so it does not collide again. Build the consumer right after the bump: the compiler enumerates every collision. A consumer that only uses the <ds-table> element needs no action.",
32
+ "searchHints": [
33
+ "extends TableComponent",
34
+ "extends "
35
+ ]
25
36
  }
26
37
  ],
27
38
  "informational": [
@@ -0,0 +1,274 @@
1
+ {
2
+ "version": "0.7.0",
3
+ "items": [
4
+ {
5
+ "id": "size-type-icon-button-to-dssize",
6
+ "kind": "type-rename",
7
+ "old": "IconButtonSize",
8
+ "new": "DsSize",
9
+ "note": "The per-component size scale is now the shared `DsSize` ('sm'|'md'|'lg'), exported from the package root. Rename this type BEFORE `ButtonSize` — this identifier contains it, so an unordered replace would corrupt it. Collapse any duplicate `DsSize` imports that result.",
10
+ "searchHints": [
11
+ "IconButtonSize"
12
+ ]
13
+ },
14
+ {
15
+ "id": "size-type-button-to-dssize",
16
+ "kind": "type-rename",
17
+ "old": "ButtonSize",
18
+ "new": "DsSize",
19
+ "note": "Removed — use the shared `DsSize` from the package root. Rename `IconButtonSize` FIRST (it contains `ButtonSize`). Collapse any duplicate `DsSize` imports.",
20
+ "searchHints": [
21
+ "ButtonSize"
22
+ ]
23
+ },
24
+ {
25
+ "id": "size-type-input-to-dssize",
26
+ "kind": "type-rename",
27
+ "old": "InputSize",
28
+ "new": "DsSize",
29
+ "note": "Removed — use the shared `DsSize` from the package root; collapse any duplicate `DsSize` imports if you import several of these together.",
30
+ "searchHints": [
31
+ "InputSize"
32
+ ]
33
+ },
34
+ {
35
+ "id": "size-type-select-to-dssize",
36
+ "kind": "type-rename",
37
+ "old": "SelectSize",
38
+ "new": "DsSize",
39
+ "note": "Removed — use the shared `DsSize` from the package root; collapse any duplicate `DsSize` imports.",
40
+ "searchHints": [
41
+ "SelectSize"
42
+ ]
43
+ },
44
+ {
45
+ "id": "size-type-search-to-dssize",
46
+ "kind": "type-rename",
47
+ "old": "SearchSize",
48
+ "new": "DsSize",
49
+ "note": "Removed — use the shared `DsSize` from the package root; collapse any duplicate `DsSize` imports.",
50
+ "searchHints": [
51
+ "SearchSize"
52
+ ]
53
+ },
54
+ {
55
+ "id": "size-type-checkbox-to-dssize",
56
+ "kind": "type-rename",
57
+ "old": "CheckboxSize",
58
+ "new": "DsSize",
59
+ "note": "Removed — use the shared `DsSize` from the package root; collapse any duplicate `DsSize` imports.",
60
+ "searchHints": [
61
+ "CheckboxSize"
62
+ ]
63
+ },
64
+ {
65
+ "id": "size-type-radio-to-dssize",
66
+ "kind": "type-rename",
67
+ "old": "RadioSize",
68
+ "new": "DsSize",
69
+ "note": "Removed — use the shared `DsSize` from the package root; collapse any duplicate `DsSize` imports.",
70
+ "searchHints": [
71
+ "RadioSize"
72
+ ]
73
+ },
74
+ {
75
+ "id": "size-type-switch-to-dssize",
76
+ "kind": "type-rename",
77
+ "old": "SwitchSize",
78
+ "new": "DsSize",
79
+ "note": "Removed — use the shared `DsSize` from the package root; collapse any duplicate `DsSize` imports.",
80
+ "searchHints": [
81
+ "SwitchSize"
82
+ ]
83
+ },
84
+ {
85
+ "id": "size-type-spinner-to-dssize",
86
+ "kind": "type-rename",
87
+ "old": "SpinnerSize",
88
+ "new": "DsSize",
89
+ "note": "Removed — use the shared `DsSize` from the package root; collapse any duplicate `DsSize` imports.",
90
+ "searchHints": [
91
+ "SpinnerSize"
92
+ ]
93
+ },
94
+ {
95
+ "id": "size-type-textarea-to-dssize",
96
+ "kind": "type-rename",
97
+ "old": "TextareaSize",
98
+ "new": "DsSize",
99
+ "note": "Removed — use the shared `DsSize` from the package root; collapse any duplicate `DsSize` imports.",
100
+ "searchHints": [
101
+ "TextareaSize"
102
+ ]
103
+ },
104
+ {
105
+ "id": "size-type-number-stepper-to-dssize",
106
+ "kind": "type-rename",
107
+ "old": "NumberStepperSize",
108
+ "new": "DsSize",
109
+ "note": "Removed — use the shared `DsSize` from the package root; collapse any duplicate `DsSize` imports.",
110
+ "searchHints": [
111
+ "NumberStepperSize"
112
+ ]
113
+ },
114
+ {
115
+ "id": "size-type-date-picker-to-dssize",
116
+ "kind": "type-rename",
117
+ "old": "DatePickerSize",
118
+ "new": "DsSize",
119
+ "note": "Removed — use the shared `DsSize` from the package root; collapse any duplicate `DsSize` imports.",
120
+ "searchHints": [
121
+ "DatePickerSize"
122
+ ]
123
+ },
124
+ {
125
+ "id": "size-type-time-picker-to-dssize",
126
+ "kind": "type-rename",
127
+ "old": "TimePickerSize",
128
+ "new": "DsSize",
129
+ "note": "Removed — use the shared `DsSize` from the package root; collapse any duplicate `DsSize` imports.",
130
+ "searchHints": [
131
+ "TimePickerSize"
132
+ ]
133
+ },
134
+ {
135
+ "id": "size-type-drawer-to-dssize",
136
+ "kind": "type-rename",
137
+ "old": "DrawerSize",
138
+ "new": "DsSize",
139
+ "note": "Removed — use the shared `DsSize` from the package root; collapse any duplicate `DsSize` imports.",
140
+ "searchHints": [
141
+ "DrawerSize"
142
+ ]
143
+ },
144
+ {
145
+ "id": "size-type-autocomplete-to-dssize",
146
+ "kind": "type-rename",
147
+ "old": "AutocompleteSize",
148
+ "new": "DsSize",
149
+ "note": "Removed — use the shared `DsSize` from the package root; collapse any duplicate `DsSize` imports.",
150
+ "searchHints": [
151
+ "AutocompleteSize"
152
+ ]
153
+ },
154
+ {
155
+ "id": "pagination-page-change-to-current-page-change",
156
+ "kind": "output-rename",
157
+ "old": "ds-pagination[pageChange]",
158
+ "new": "currentPageChange",
159
+ "note": "The manual (pageChange) output is removed; the currentPage two-way model already emits (currentPageChange) on every page change (including the reset to page 1 after a size change). Rename (pageChange)=\"...\" to (currentPageChange)=\"...\" on ds-pagination. (pageSizeChange) is UNCHANGED — it is now the pageSize model's implicit output, same name and payload; [(currentPage)] / [(pageSize)] two-way bindings need no change.",
160
+ "searchHints": [
161
+ "(pageChange)",
162
+ "pageChange"
163
+ ]
164
+ },
165
+ {
166
+ "id": "input-with-addon-removed",
167
+ "kind": "removed-api",
168
+ "old": "ds-input[withAddon]",
169
+ "new": null,
170
+ "note": "Removed (distinct from withAddonRight below — match the exact attribute; withAddon is a substring of withAddonRight). The flush-addon layout is now derived from the DOM: a boxed .addon projected into [dsInputPrefix] (<span dsInputPrefix class=\"addon\">…</span>) sits flush automatically via :has(), and a bare <ds-icon dsInputPrefix> keeps its inset. Delete the [withAddon] attribute — a boxed addon renders identically; a bare icon that used the flag regains its proper left inset (bugfix).",
171
+ "searchHints": [
172
+ "[withAddon]"
173
+ ]
174
+ },
175
+ {
176
+ "id": "input-with-addon-right-removed",
177
+ "kind": "removed-api",
178
+ "old": "ds-input[withAddonRight]",
179
+ "new": null,
180
+ "note": "Removed — the trailing counterpart of withAddon. A boxed .addon.right projected into [dsInputSuffix] now sits flush automatically via :has(). Delete the [withAddonRight] attribute.",
181
+ "searchHints": [
182
+ "[withAddonRight]"
183
+ ]
184
+ },
185
+ {
186
+ "id": "app-shell-selector-to-app-layout",
187
+ "kind": "selector-rename",
188
+ "old": "ds-app-shell",
189
+ "new": "ds-app-layout",
190
+ "note": "Component renamed (shipped as ds-app-shell in the tagged 0.6.3 source). Behaviour unchanged — rename the element and its closing tag. Also rename the class, service and tokens (separate entries below).",
191
+ "searchHints": [
192
+ "ds-app-shell"
193
+ ]
194
+ },
195
+ {
196
+ "id": "app-shell-class-to-app-layout",
197
+ "kind": "type-rename",
198
+ "old": "AppShellComponent",
199
+ "new": "AppLayoutComponent",
200
+ "note": "The exported component class renamed alongside the ds-app-shell → ds-app-layout selector. Update imports / type references.",
201
+ "searchHints": [
202
+ "AppShellComponent"
203
+ ]
204
+ },
205
+ {
206
+ "id": "shell-scroll-service-to-layout-scroll-service",
207
+ "kind": "type-rename",
208
+ "old": "ShellScrollService",
209
+ "new": "LayoutScrollService",
210
+ "note": "The exported scroll-to-top-on-navigation service renamed with the app-shell → app-layout rename. Update inject()/import references; the scrollToTop() API is unchanged.",
211
+ "searchHints": [
212
+ "ShellScrollService"
213
+ ]
214
+ },
215
+ {
216
+ "id": "app-shell-tokens-to-app-layout",
217
+ "kind": "token-rename",
218
+ "old": "--ds-app-shell-",
219
+ "new": "--ds-app-layout-",
220
+ "note": "Prefix rename for the four layout tokens: --ds-app-shell-pad-x / -pad-y / -content-max-width / -height → --ds-app-layout-*. DS-owned tokens only (no others ship under this prefix); a consumer's own --ds-app-shell-* variable is out of scope. Confirm the new name exists in the installed package.",
221
+ "searchHints": [
222
+ "--ds-app-shell-"
223
+ ]
224
+ },
225
+ {
226
+ "id": "select-clear-button-dom-change",
227
+ "kind": "behavior",
228
+ "old": null,
229
+ "new": null,
230
+ "note": "ds-select's clear-x is now keyboard-operable: the trigger changed from <button role=\"combobox\"> to <div role=\"combobox\" tabindex=\"0\">, and the clear affordance from a mouse-only <span aria-hidden> to a real <button aria-label=\"Clear selection\">. Nothing stops compiling, but a consumer that targeted the old <button role=combobox> trigger or the <span> clear in CSS selectors or e2e/unit tests must retarget to the div / the button.",
231
+ "searchHints": [
232
+ "ds-select",
233
+ "role=\"combobox\"",
234
+ "Clear selection"
235
+ ]
236
+ },
237
+ {
238
+ "id": "field-reserve-message-default-on",
239
+ "kind": "behavior",
240
+ "old": null,
241
+ "new": null,
242
+ "note": "Message-bearing fields (ds-input, ds-textarea, ds-select, ds-autocomplete, ds-multi-select, ds-checkbox, ds-radio, ds-radio-group, ds-switch, ds-slider, ds-otp-input, ds-date-picker, ds-time-picker, ds-color-picker) now reserve one message line of height by DEFAULT via the new reserveMessage input (default true). Was: the footer existed only when a hint/error/counter was present, so a field with no message was shorter and grew when a message first appeared. Purely visual — nothing stops compiling. To restore the old collapsing behaviour on a field, set [reserveMessage]=\"false\". Review form vertical rhythm: the reserved row sits ~23px under the control, so tightly-stacked field pairs may read as a gap. (ds-search and ds-number-stepper have no message row and are NOT affected.)",
243
+ "searchHints": [
244
+ "<ds-input",
245
+ "<ds-textarea",
246
+ "<ds-select",
247
+ "reserveMessage"
248
+ ]
249
+ },
250
+ {
251
+ "id": "table-component-subclass-member-collisions",
252
+ "kind": "behavior",
253
+ "old": null,
254
+ "new": null,
255
+ "note": "Only affects a consumer that EXTENDS a DS component class. Subclassing is unsupported (design-system.md - Components), but where it happens this release can break the build the same way 0.6.3 did: TableComponent gained total, sortingOrder, animateHeight and scrollToTopOnPageChange, and most other component classes changed too, so a subclass that already used one of those names no longer compiles — TS4114 requires an 'override' modifier, TS2416 fires where the signature differs. Resolution per member: where the base member means the same thing, keep the name and add `override` with a base-compatible signature; otherwise RENAME the subclass's own member, checking the new name against the base's member list first. Build the consumer right after the bump: the compiler enumerates every collision. A consumer that only uses the DS elements needs no action.",
256
+ "searchHints": [
257
+ "extends TableComponent",
258
+ "extends "
259
+ ]
260
+ }
261
+ ],
262
+ "informational": [
263
+ "AvatarSize, ModalSize and ContainerSize are NOT removed — they remain and now extend DsSize ('xs' | DsSize, DsSize | 'xl' | 'fullscreen', DsSize | 'xl' | 'full'); no change needed for consumers using those three.",
264
+ "ds-avatar gains deterministic seeded tinting: [seed]/[avoidHues] inputs derive a stable per-person OKLCH background + auto-contrast text; standalone exports avatarTint(seed, options), AvatarTintOptions and initialsFrom(first, last) (also accepts a full-name string), and [tint] now also accepts 'neutral' — additive, off by default, no code change.",
265
+ "New override tokens --ds-sidenav-item-label-weight and --ds-modal-title-weight (previously baked into font: shorthands); defaults unchanged (--font-weight-semibold / --font-weight-bold) — additive, no code change.",
266
+ "ds-table gains opt-in inputs total (server-side paging: feed the full row count and pass one pre-sliced page), sortingOrder (e.g. ['asc','desc'] to drop the unsorted state), animateHeight (tween body height on a row-set change), scrollToTopOnPageChange, plus TableColumn.srLabel (visually-hidden header name) — all additive, off by default, no code change.",
267
+ "ds-search gains a size input (sm/md/lg); default md keeps the prior 36px height, so existing consumers are unaffected — additive, no code change.",
268
+ "ds-badge gains a countLabel input (default 'notifications') for the count's accessible-label noun — additive, no code change.",
269
+ "Bugfixes, no code change: --ds-avatar-size now applies at every size (not only md); ds-table clamps an out-of-range page after a client-side filter shrinks the result set; collapsed ds-sidenav no longer overflows by 1px; dsTooltip now listens on focusin/focusout so keyboard focus toggles the tip and re-rendered anchors no longer strand panels; stacked overlays (modal/drawer/bottom-sheet) no longer unlock body scroll under each other (shared ref-counted BodyScrollLockService).",
270
+ "ds-sidenav-item gains an optional (activate) output — emits the click MouseEvent; preventDefault() intercepts navigation on an href item, but a routerLink item navigates regardless. Additive, no code change.",
271
+ "BodyScrollLockService is now a public export — inject it to make a consumer's own full-screen overlay share the DS body-scroll lock (paired lock()/unlock()). Additive, no code change.",
272
+ "ds-menu: a disabled ds-menu-item is now keyboard-focusable (aria-disabled, kept in the roving/arrow/type-ahead order) instead of being dropped from nav and rendered as a native disabled button; activation stays blocked and a [dsTooltip] on it now shows on focus. Behavior/a11y only, no code change — but an e2e/unit test asserting a disabled menu item is unfocusable/native-disabled must be updated."
273
+ ]
274
+ }
@@ -0,0 +1,145 @@
1
+ {
2
+ "version": "0.7.1",
3
+ "items": [
4
+ {
5
+ "id": "surface-motion-partial-a-la-carte",
6
+ "kind": "scss-api",
7
+ "old": "@use 'styles/overlay-motion';",
8
+ "new": "@use 'styles/surface-motion';\n@use 'styles/overlay-motion';",
9
+ "note": "New GLOBAL partial `styles/_surface-motion.scss` holds the shared entrance keyframes (ds-fade-in, ds-scale-in, ds-slide-in, ds-slide-edge-in) that every DS surface now names through --ds-<surface>-enter-keyframes. Consumers of the bundled entry (`@use 'styles/ds';`) need NO change — ds.scss forwards it. Only à-la-carte consumers that @use DS partials individually must add it, next to `styles/overlay-motion`: without it the keyframes do not exist and modal / drawer / bottom-sheet / toast / banner / alert / loading-overlay / overlay panels render with no entrance (silently — no error). Order does not matter; @use anywhere in the styles entry is enough. If a consumer's styles.scss has no `styles/overlay-motion` line, add `@use 'styles/surface-motion';` beside whatever DS partials it does @use.",
10
+ "searchHints": [
11
+ "styles/overlay-motion",
12
+ "styles/ds",
13
+ "@use 'styles/",
14
+ "ids-design-system/styles"
15
+ ]
16
+ },
17
+ {
18
+ "id": "table-sortkey-non-null-when-unsorted",
19
+ "kind": "behavior",
20
+ "old": "ds-table[sortKey]",
21
+ "new": null,
22
+ "note": "`ds-table` no longer nulls `sortKey` when the sort cycle reaches \"unsorted\" — the key keeps naming the column the user last touched and `sortDir === null` alone means unsorted. Fixes a header desync for hosts that map \"off\" back to their own default sort. ACTION: any host that treats a non-null `sortKey` as \"a sort is active\" must gate on `sortDir` instead — e.g. `if (sortKey())` becomes `if (sortDir())`, and a server query built as `orderBy: sortKey()` must skip the clause when `sortDir()` is null. Hosts that already read both, or that pass `sortingOrder: ['asc','desc']` (no unsorted state), need no change. The table's own rendering (icons, aria-sort) and its client-side sorting were already gated on `sortDir` and are unchanged.",
23
+ "searchHints": [
24
+ "sortKey",
25
+ "sortDir",
26
+ "sortChange",
27
+ "(sortChange)",
28
+ "[(sortKey)]"
29
+ ]
30
+ },
31
+ {
32
+ "id": "field-reserve-message-default-off",
33
+ "kind": "behavior",
34
+ "old": "ds-input[reserveMessage]",
35
+ "new": null,
36
+ "note": "Every message-bearing field now defaults `reserveMessage` to FALSE (was true since 0.7.0). The resolution chain is unchanged - per-field input, then `DS_CONFIG.field.reserveMessage`, then the default - only the final fallback flipped. VISIBLE CONSEQUENCE: a field with no hint/error no longer holds a message line, so a form gets ~23px shorter per field and the controls below shift down the first time a hint or error appears. Affects all 14 fields: input, textarea, select, autocomplete, multi-select, checkbox, radio, radio-group, switch, slider, date-picker, time-picker, color-picker, otp-input. ACTION: a form that validates and must not reflow should turn it back on. App-wide in one line - `provideDsConfig({ field: { reserveMessage: true } })` - which is also how to restore 0.7.0 behaviour exactly; or per field with `[reserveMessage]=\"true\"`. Consumers that had written `[reserveMessage]=\"false\"` to opt OUT can delete those bindings, and any tighter sub-stack added to compensate for the reserved gap (e.g. a `var(--space-1)` wrapper) should be re-checked - with the row collapsed, a normal 16px stack is correct again.",
37
+ "searchHints": [
38
+ "reserveMessage",
39
+ "[reserveMessage]",
40
+ "provideDsConfig",
41
+ "field: {",
42
+ "DS_CONFIG"
43
+ ]
44
+ },
45
+ {
46
+ "id": "ds-config-nested-provide-merges",
47
+ "kind": "behavior",
48
+ "old": "provideDsConfig",
49
+ "new": null,
50
+ "note": "A nested `provideDsConfig` (on a Route, component or directive) now MERGES with the config above it, section by section, instead of replacing it wholesale. Previously the provider used `useValue`, so a subtree that set one flag silently reset every unrelated section to its default. NO ACTION for the normal case - a single root-level `provideDsConfig` behaves exactly as before, and nested provision was neither documented nor safe to use. Only relevant if a consumer deliberately relied on a nested call to RESET a section back to defaults: that now needs the section spelled out explicitly, e.g. `provideDsConfig({ datePicker: { locale: 'en-US', dateFormat: undefined, firstDayOfWeek: 1 } })`. Enables the new `dsReserveMessages` directive to scope one field flag without disturbing the rest.",
51
+ "searchHints": [
52
+ "provideDsConfig",
53
+ "DS_CONFIG",
54
+ "providers: [provideDsConfig"
55
+ ]
56
+ },
57
+ {
58
+ "id": "exported-classes-gained-members",
59
+ "kind": "behavior",
60
+ "old": "extends TableComponent",
61
+ "new": null,
62
+ "note": "Several exported component classes CHANGED their member surface this range, which breaks a consumer that EXTENDS one (subclassing a DS component is unsupported - design-system.md section Components - but where it happens the names collide: TS4114 demands an `override` modifier, TS2415 fires on a redeclared private member, TS2416 where a signature differs). New members: all 14 message-bearing fields (ds-autocomplete, ds-checkbox, ds-color-picker, ds-date-picker, ds-input, ds-multi-select, ds-otp-input, ds-radio, ds-radio-group, ds-select, ds-slider, ds-switch, ds-textarea, ds-time-picker) gained `reserveMessageResolved`, and CheckboxComponent, SwitchComponent and RadioComponent also gained a protected `devMode`; InputComponent and TextareaComponent also gained `control` and `focus`; SearchComponent gained `focus`; TableComponent gained `rowId` and `rowKey`; PaginationComponent gained `showPageSize`; TimePickerComponent gained `label`, `required`, `optional`, `labelId`, `fullWidth`; DatePickerComponent gained `fullWidth`; AppLayoutComponent gained `railOpen`, `railLabel`, `compact`, `closeRail` plus the private `navigation`, `destroyRef`, `watchDesktopBreakpoint`. ONE REMOVAL: TooltipDirective (dsTooltip) dropped its protected `onOpen`, split into `onPointerEnter` / `onFocusIn` / `onFocusOut` plus a private `scheduleShow`, `describedElement`, `focusedTarget` - a subclass that overrode `onOpen` fails to compile because its `override` names a member the base no longer declares; move a mouse-path body to `onPointerEnter` and a keyboard-path body to `onFocusIn`. ACTION: rename the subclass's own member, or add `override` where the base's semantics genuinely match. Build after upgrading - the compiler enumerates every collision. Consumers who only use the <ds-...> elements need no change.",
63
+ "searchHints": [
64
+ "extends TableComponent",
65
+ "extends InputComponent",
66
+ "extends TextareaComponent",
67
+ "extends PaginationComponent",
68
+ "extends TimePickerComponent",
69
+ "extends DatePickerComponent",
70
+ "extends SearchComponent",
71
+ "extends TooltipDirective",
72
+ "extends CheckboxComponent",
73
+ "extends SwitchComponent",
74
+ "extends RadioComponent",
75
+ "extends AppLayoutComponent",
76
+ "extends ",
77
+ "override readonly"
78
+ ]
79
+ },
80
+ {
81
+ "id": "app-layout-scroll-reset-path-only",
82
+ "kind": "behavior",
83
+ "old": "LayoutScrollService",
84
+ "new": null,
85
+ "note": "`ds-app-layout` no longer resets the content scroll on EVERY router NavigationEnd - only when the PATH changes (the part before `?` or `#`). A sort, page or filter change that rewrites just the query string or fragment now KEEPS the reader's scroll position. ACTION only if a screen relied on the old blanket reset: inject the still-public `LayoutScrollService` and call `scrollToTop()` from the handler that changes the filter, which is per-interaction and more precise than the old behaviour. No action for anyone who found the old reset disruptive.",
86
+ "searchHints": [
87
+ "LayoutScrollService",
88
+ "scrollToTop",
89
+ "ds-app-layout",
90
+ "NavigationEnd"
91
+ ]
92
+ },
93
+ {
94
+ "id": "modal-title-flex-moved-to-heading",
95
+ "kind": "class-rename",
96
+ "old": "ds-modal-card .title",
97
+ "new": ".heading",
98
+ "note": "STYLING ONLY, and only for a consumer who styles the modal's internal DOM. The `[eyebrow]` slot wrapped `<h2 class=\"title\">` together with the eyebrow in a new `<div class=\"heading\">`, and the `flex: 1` that used to sit on the `<h2>` moved to that wrapper. A consumer rule that targeted `.modal-card .title` for the flex slot must retarget `.heading`; rules that target `.title` for typography or colour are unaffected. Scope strictly to selectors under ds-modal / ds-modal-card.",
99
+ "searchHints": [
100
+ "ds-modal",
101
+ "ds-modal-card",
102
+ ".modal-card .title",
103
+ ".title",
104
+ "flex: 1"
105
+ ]
106
+ },
107
+ {
108
+ "id": "table-client-sort-blanks-last-and-numeric-collation",
109
+ "kind": "behavior",
110
+ "old": "ds-table[clientSort]",
111
+ "new": null,
112
+ "note": "`clientSort` changes how existing columns order in two ways, both applying with or without the new per-column `sortValue`. (1) BLANKS SINK: a cell reading as no-data - empty string, or one of the em dash, en dash, hyphen, 'n/a', 'never', 'none' matched case-insensitively - now sorts LAST in both ascending and descending order. Previously an empty string was just the smallest value, so it floated to the top on ascending. (2) NATURAL TEXT COLLATION: the text fallback now passes { numeric: true } to localeCompare, so 'item 9' precedes 'item 10' instead of following it. ACTION: none for most tables - both changes are what a reader expects. Only if a screen deliberately relied on blanks sorting first, or on the old pure-lexical order of strings containing digits, supply a per-column `sortValue` that maps the values the way that screen wants.",
113
+ "searchHints": [
114
+ "clientSort",
115
+ "sortChange",
116
+ "sortKey",
117
+ "sortDir",
118
+ "[columns]",
119
+ "TableColumn"
120
+ ]
121
+ }
122
+ ],
123
+ "informational": [
124
+ "Purely additive, opt-in inputs — no consumer action: `ds-table` [rowId] accessor (row identity for tracking/selection/expansion; still defaults to row.id), `ds-date-picker`/`ds-time-picker` [fullWidth], `ds-pagination` [showPageSize], and public `focus(options?)` on `ds-search` / `ds-input` / `ds-textarea`.",
125
+ "`ds-table`'s row generic relaxes from `{ id: string }` to `object` so keyless data can supply [rowId]; rows that keep an `id` type-check exactly as before, and the resolver is public as `rowKey(row)`.",
126
+ "New override tokens, all defaulting to the current values: --ds-<surface>-enter-keyframes / -enter-duration / -enter-easing (+ -enter-offset / -enter-scale) and -leave-duration / -leave-easing across overlay panels, modal, drawer, bottom sheet, toast, banner, alert and loading overlay; --ds-modal-eyebrow-* (5); --ds-modal-title-font-size; --ds-date-picker-trigger-radius; --ds-date-picker-panel-radius; --ds-checkbox-radius; --ds-popover-min-width; --ds-menu-min-width / -max-width; --ds-toast-min-width / -max-width; --ds-table-cell-pad-{top,right,bottom,left}; --ds-table-head-border-color / -weight / -tracking; --ds-pagination-label-font-size / -weight / -color.",
127
+ "`ds-modal` / `ds-modal-card` gained an `[eyebrow]` projection slot above the title; unfilled it renders nothing, so existing dialogs are unaffected.",
128
+ "`DS_CONFIG` gained a `field.reserveMessage` key — `provideDsConfig({ field: { reserveMessage: false } })` sets the message-row default for all 14 message-bearing fields. The per-field input still wins; its type widens to `boolean | null` (null = not set), so existing bindings and bare attributes behave identically.",
129
+ "Visual-only: overlay panels now enter FROM their trigger edge (a panel above its trigger rises instead of sliding down), a selected dropdown option keeps its tint under hover/keyboard-active, and a read-only `ds-modal` no longer draws an empty footer strip.",
130
+ "ds-time-picker gained label / required / optional inputs (additive) — a date + time form row now aligns without a hand-rolled label; existing usages without label render exactly as before.",
131
+ "Visual-only in ds-time-picker: the clock glyph moved from before the value to the trailing edge and grew 14px -> 16px, the value weight dropped from medium to regular, and the trigger gap narrowed 8px -> 4px, all to match ds-date-picker / ds-select / ds-input. Recover the old weight with --ds-time-picker-value-weight: var(--font-weight-medium).",
132
+ "Value typography of both pickers is now tokenised: --ds-date-picker-value-font-family / -font-size / -weight (mono default, shared with the ghost mask) and --ds-time-picker-value-font-family / -font-size / -weight, plus --ds-time-picker-required-color. Defaults unchanged except the time value weight noted above.",
133
+ "ds-date-picker [fullWidth] now pushes the calendar glyph to the trailing edge instead of leaving it packed beside the value; only affects fields that opt into fullWidth.",
134
+ "`ds-app-layout` gained an opt-in responsive rail: below the `lg` breakpoint the rail becomes an off-canvas overlay driven by the new two-way `[(railOpen)]` model, with `railLabel` (default 'Navigation') naming it for a screen reader. At/above `lg` nothing changes and `railOpen` has no effect, so an existing desktop-only consumer is unaffected. New tokens --ds-app-layout-rail-bg-color / -rail-shadow / --ds-app-layout-scrim-color all default to current values. PREREQUISITE: the breakpoint is read at runtime from the emitted `--bp-lg` custom property, with no literal px fallback - a consumer whose global styles never emit the `--bp-*` scale keeps the desktop layout at every width (dev builds log a console.error saying so). Include the DS global styles, or the bundled `styles/ds` entry, to get the compact behaviour.",
135
+ "`inheritDsConfig(config)` is a new public export beside `provideDsConfig`: it reads the nearest ancestor DS_CONFIG (skipSelf, optional) and shallow-merges per top-level section. Call it from an injection context if you need the merging behaviour in your own factory provider or directive metadata.",
136
+ "`dsReserveMessages` is a new directive: put it on a form and every DS field DECLARED inside reserves its message row, without a per-control binding. Presence-driven (no input), merges with the config above it, and a field's own [reserveMessage] still wins. Projected <ng-content> is not covered - it keeps the injector of the template it was written in.",
137
+ "Visual-only: dialogs opened through `ModalService` no longer carry the `ds-overlay-pane` panel class, so the shared overlay-panel entrance is no longer layered on top of the modal's own card/backdrop animation.",
138
+ "Known gap, not a regression: the ds-time-picker label wiring (aria-labelledby / aria-required) landed on the SINGLE-mode trigger only; range mode's start/end segment triggers are not wired to the label yet.",
139
+ "`TableColumn` gained an optional `sortValue: (row) => string | number | Date | null | undefined` so a column sorts by its domain value instead of the rendered text; formatted money, percents and dates sorted wrong before. Purely additive - a column without it keeps today's behaviour. Only affects sorting, not the header filter's value list.",
140
+ "`ds-checkbox`, `ds-switch` and `ds-radio` log a dev-mode warning when a caption is projected (`<ds-checkbox>text</ds-checkbox>`) instead of passed via [label]; the text never rendered and failed silently. All three share the [label]-only contract. Dev only - the detection node is gated on isDevMode(), so production is unchanged. Projection itself is still unsupported. The directive doing the detection is internal (not exported from public-api).",
141
+ "Known gap, not a regression: `--ds-overlay-enter-scale` is the one entrance token NOT forwarded onto a portaled overlay pane, so setting it per instance (`ds-select { --ds-overlay-enter-scale: 0.9 }`) has no effect on select / autocomplete / multi-select / date / time / colour picker / popover / tooltip / menu submenu panels. Scope it globally until it is forwarded; the other four (-enter-keyframes / -duration / -easing / -offset) do forward.",
142
+ "Bugfix, no action: `dsTooltip` now puts `aria-describedby` on the element that actually took focus (recorded from the bubbling `focusin`) rather than unconditionally on its host, so a tooltip on a host that is not itself focusable — `ds-menu-item` carries `role=\"none\"` and holds the real button inside — finally reaches a screen reader. A pointer-only open still describes the host.",
143
+ "Visual-only fixes: `ds-pagination` pins its internal rows-per-page select to `reserveMessage: false` (it inherited the app default and pushed the pager off the page buttons' baseline), and `ds-stat`'s card fills a stretched host so a KPI row with mixed captions paints equal-height tiles. Consumers can drop the global workarounds for both (`ds-pagination ds-field-message { display: none }` and `ds-stat { height: 100% }`)."
144
+ ]
145
+ }
@@ -113,6 +113,14 @@ family with "point the channel back at `--primary-h/s/l` to keep the old look".)
113
113
  **Catch-all:** if you can't confidently fit a breaking/changed entry to a mechanical kind, make it
114
114
  `behavior` (never drop it). Reading the changelog completely matters more than perfect kinds.
115
115
 
116
+ **One rename can need TWO items.** When an input, a `variant` value or a tone also changes the class
117
+ the component puts in the DOM, the `input-rename` / `value-remap` fixes the consumer's *binding* and
118
+ finds nothing in their stylesheet — a selector like `.modal.danger` survives the upgrade and silently
119
+ matches nothing. Emit a `class-rename` alongside it, element-scoped (`ds-modal .danger`), and say in
120
+ the `note` that only consumer STYLING of the internal class is affected. This is how 0.5.1's
121
+ `danger` → `error` vocabulary rename left a consumer with a dead destructive-modal stripe: every
122
+ binding item was present and correct, the class items were missing (added retroactively 2026-08-03).
123
+
116
124
  ## actionable vs informational
117
125
 
118
126
  Decide by CONTENT, not by which `###` section it sits in — an actionable change can hide in
@@ -121,6 +129,16 @@ Actionable = existing consumer code stops working or *behaving as before*. Every
121
129
  components, new optional inputs, additive tokens whose defaults equal the old role token, pure
122
130
  bugfixes, visual polish) → `informational`, so a reader knows silence = safe.
123
131
 
132
+ **Members added to an exported class are actionable even when the feature is additive.** Subclassing
133
+ a DS component is unsupported (`design-system.md` § Components), but a consumer who does it breaks on
134
+ a name collision — TS4114 demands `override`, TS2416 fires when the signature differs — so a release
135
+ that only ADDS can fail their build. Emit ONE `behavior` item per release naming the classes whose
136
+ member surface grew, with the added member names where few enough to list and the count where not,
137
+ `searchHints` that locate the subclass (`extends TableComponent`, `extends `), and a `note` giving the
138
+ resolution: rename the subclass's own member, or add `override` where the base's semantics genuinely
139
+ match. Keep the feature bullets themselves in `informational` — the item is the collision, not the
140
+ feature.
141
+
124
142
  ## Per-entry checklist
125
143
 
126
144
  - [ ] `id` is a stable, unique kebab slug.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ids-group-ltd/ids-design-system",
3
- "version": "0.6.3",
3
+ "version": "0.7.1",
4
4
  "description": "IDS Group Angular design system: components, tokens, themes",
5
5
  "license": "MIT",
6
6
  "homepage": "https://ids-ds.proto.ids-group.co.uk/",
@@ -92,8 +92,12 @@
92
92
  flex: 0 0 auto;
93
93
  }
94
94
 
95
- &:hover:not(.is-disabled),
96
- &.is-active:not(.is-disabled) {
95
+ // `:not(.is-selected)` is load-bearing: this branch outranks `.is-selected`
96
+ // on specificity, so without it a hovered (or keyboard-active) selected row
97
+ // repaints to the neutral surface while KEEPING the selected label colour —
98
+ // unreadable as soon as a brand gives the selected row a dark fill.
99
+ &:hover:not(.is-disabled, .is-selected),
100
+ &.is-active:not(.is-disabled, .is-selected) {
97
101
  background: var(--surface-secondary);
98
102
  }
99
103
 
@@ -107,6 +111,11 @@
107
111
  color: var(--primary-strong);
108
112
 
109
113
  .option-icon { color: var(--primary-strong); }
114
+
115
+ &:hover:not(.is-disabled),
116
+ &.is-active:not(.is-disabled) {
117
+ background: var(--primary-muted);
118
+ }
110
119
  }
111
120
 
112
121
  &.is-disabled {
@@ -1,17 +1,58 @@
1
1
  // Enter motion for CDK-overlay panels that carry the `ds-overlay-pane`
2
2
  // panelClass (select, autocomplete, multi-select, date-picker, time-picker,
3
- // color-picker, popover, tooltip). Animates the panel's ROOT CHILD, not the
4
- // pane itself, so CDK's positioning transforms on `.cdk-overlay-pane` are left
5
- // untouched. The leave/exit animation was removed (close is instant) — see the
6
- // TODO(overlay-leave) in components/overlay-motion.ts to reinstate it.
3
+ // color-picker, popover, tooltip, menu submenu). Animates the panel's ROOT
4
+ // CHILD, not the pane itself, so CDK's positioning transforms on
5
+ // `.cdk-overlay-pane` are left untouched. The leave/exit animation was removed
6
+ // (close is instant) — see the TODO(overlay-leave) in components/overlay-motion.ts
7
+ // to reinstate it.
8
+ //
9
+ // `data-ds-placement` names WHERE the panel sits relative to its trigger and is
10
+ // stamped by `prepareOverlayEnter()` before the panel is attached, so the panel
11
+ // always enters FROM the trigger edge: the offset axis/sign and the scale origin
12
+ // both follow it. The keyframe name never changes with placement, so a mid-scroll
13
+ // CDK flip redirects the motion instead of restarting it.
14
+ //
15
+ // Duration/easing stay longhands the library owns: reduced motion zeroes the
16
+ // duration rather than dropping the animation, which keeps `animationend`-driven
17
+ // teardown working and outranks a consumer keyframe carrying its own timing.
7
18
 
8
- .cdk-overlay-pane.ds-overlay-pane > * {
9
- animation: ds-overlay-in var(--duration-fast) var(--ease-decelerate);
10
- }
19
+ .cdk-overlay-pane.ds-overlay-pane {
20
+ /* Public --ds-overlay-* are read with fallbacks, never declared — consumer overrides inherit in. */
21
+ --_overlay-enter-keyframes: var(--ds-overlay-enter-keyframes, ds-slide-in);
22
+ --_overlay-enter-duration: var(--ds-overlay-enter-duration, var(--duration-fast));
23
+ --_overlay-enter-easing: var(--ds-overlay-enter-easing, var(--ease-decelerate));
24
+ --_overlay-enter-offset: var(--ds-overlay-enter-offset, 4px);
25
+ --_ds-enter-scale: var(--ds-overlay-enter-scale, 0.96);
26
+
27
+ --_ds-enter-x: 0px;
28
+ --_ds-enter-y: calc(-1 * var(--_overlay-enter-offset));
29
+ --_overlay-enter-origin: top center;
30
+
31
+ &[data-ds-placement='top'] {
32
+ --_ds-enter-y: var(--_overlay-enter-offset);
33
+ --_overlay-enter-origin: bottom center;
34
+ }
35
+
36
+ &[data-ds-placement='left'] {
37
+ --_ds-enter-x: var(--_overlay-enter-offset);
38
+ --_ds-enter-y: 0px;
39
+ --_overlay-enter-origin: center right;
40
+ }
41
+
42
+ &[data-ds-placement='right'] {
43
+ --_ds-enter-x: calc(-1 * var(--_overlay-enter-offset));
44
+ --_ds-enter-y: 0px;
45
+ --_overlay-enter-origin: center left;
46
+ }
47
+
48
+ @media (prefers-reduced-motion: reduce) {
49
+ --_overlay-enter-duration: 0ms;
50
+ }
11
51
 
12
- @keyframes ds-overlay-in {
13
- from {
14
- opacity: 0;
15
- transform: translateY(-4px);
52
+ > * {
53
+ animation-name: var(--_overlay-enter-keyframes);
54
+ animation-duration: var(--_overlay-enter-duration);
55
+ animation-timing-function: var(--_overlay-enter-easing);
56
+ transform-origin: var(--_overlay-enter-origin);
16
57
  }
17
58
  }