@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.7.0.json
CHANGED
|
@@ -6,7 +6,8 @@
|
|
|
6
6
|
"kind": "type-rename",
|
|
7
7
|
"old": "IconButtonSize",
|
|
8
8
|
"new": "DsSize",
|
|
9
|
-
"
|
|
9
|
+
"action": "Replace `IconButtonSize` with `DsSize`, imported from the package root. Apply this BEFORE `ButtonSize`.",
|
|
10
|
+
"pitfall": "`IconButtonSize` CONTAINS `ButtonSize`. Renaming the shorter one first leaves `IconDsSize`, an identifier that exists nowhere — and the two items are adjacent in this file, so the wrong order is the natural one.",
|
|
10
11
|
"searchHints": [
|
|
11
12
|
"IconButtonSize"
|
|
12
13
|
],
|
|
@@ -17,7 +18,8 @@
|
|
|
17
18
|
"kind": "type-rename",
|
|
18
19
|
"old": "ButtonSize",
|
|
19
20
|
"new": "DsSize",
|
|
20
|
-
"
|
|
21
|
+
"action": "Replace `ButtonSize` with `DsSize`, imported from the package root. Apply `IconButtonSize` first.",
|
|
22
|
+
"pitfall": "`IconButtonSize` contains this name — rename the longer identifier first, or match whole identifiers.",
|
|
21
23
|
"searchHints": [
|
|
22
24
|
"ButtonSize"
|
|
23
25
|
],
|
|
@@ -28,7 +30,7 @@
|
|
|
28
30
|
"kind": "type-rename",
|
|
29
31
|
"old": "InputSize",
|
|
30
32
|
"new": "DsSize",
|
|
31
|
-
"
|
|
33
|
+
"action": "Replace `InputSize` with `DsSize`, imported from the package root.",
|
|
32
34
|
"searchHints": [
|
|
33
35
|
"InputSize"
|
|
34
36
|
],
|
|
@@ -39,7 +41,7 @@
|
|
|
39
41
|
"kind": "type-rename",
|
|
40
42
|
"old": "SelectSize",
|
|
41
43
|
"new": "DsSize",
|
|
42
|
-
"
|
|
44
|
+
"action": "Replace `SelectSize` with `DsSize`, imported from the package root.",
|
|
43
45
|
"searchHints": [
|
|
44
46
|
"SelectSize"
|
|
45
47
|
],
|
|
@@ -50,7 +52,7 @@
|
|
|
50
52
|
"kind": "type-rename",
|
|
51
53
|
"old": "SearchSize",
|
|
52
54
|
"new": "DsSize",
|
|
53
|
-
"
|
|
55
|
+
"action": "Replace `SearchSize` with `DsSize`, imported from the package root.",
|
|
54
56
|
"searchHints": [
|
|
55
57
|
"SearchSize"
|
|
56
58
|
],
|
|
@@ -61,7 +63,7 @@
|
|
|
61
63
|
"kind": "type-rename",
|
|
62
64
|
"old": "CheckboxSize",
|
|
63
65
|
"new": "DsSize",
|
|
64
|
-
"
|
|
66
|
+
"action": "Replace `CheckboxSize` with `DsSize`, imported from the package root.",
|
|
65
67
|
"searchHints": [
|
|
66
68
|
"CheckboxSize"
|
|
67
69
|
],
|
|
@@ -72,7 +74,7 @@
|
|
|
72
74
|
"kind": "type-rename",
|
|
73
75
|
"old": "RadioSize",
|
|
74
76
|
"new": "DsSize",
|
|
75
|
-
"
|
|
77
|
+
"action": "Replace `RadioSize` with `DsSize`, imported from the package root.",
|
|
76
78
|
"searchHints": [
|
|
77
79
|
"RadioSize"
|
|
78
80
|
],
|
|
@@ -83,7 +85,7 @@
|
|
|
83
85
|
"kind": "type-rename",
|
|
84
86
|
"old": "SwitchSize",
|
|
85
87
|
"new": "DsSize",
|
|
86
|
-
"
|
|
88
|
+
"action": "Replace `SwitchSize` with `DsSize`, imported from the package root.",
|
|
87
89
|
"searchHints": [
|
|
88
90
|
"SwitchSize"
|
|
89
91
|
],
|
|
@@ -94,7 +96,7 @@
|
|
|
94
96
|
"kind": "type-rename",
|
|
95
97
|
"old": "SpinnerSize",
|
|
96
98
|
"new": "DsSize",
|
|
97
|
-
"
|
|
99
|
+
"action": "Replace `SpinnerSize` with `DsSize`, imported from the package root.",
|
|
98
100
|
"searchHints": [
|
|
99
101
|
"SpinnerSize"
|
|
100
102
|
],
|
|
@@ -105,7 +107,7 @@
|
|
|
105
107
|
"kind": "type-rename",
|
|
106
108
|
"old": "TextareaSize",
|
|
107
109
|
"new": "DsSize",
|
|
108
|
-
"
|
|
110
|
+
"action": "Replace `TextareaSize` with `DsSize`, imported from the package root.",
|
|
109
111
|
"searchHints": [
|
|
110
112
|
"TextareaSize"
|
|
111
113
|
],
|
|
@@ -116,7 +118,7 @@
|
|
|
116
118
|
"kind": "type-rename",
|
|
117
119
|
"old": "NumberStepperSize",
|
|
118
120
|
"new": "DsSize",
|
|
119
|
-
"
|
|
121
|
+
"action": "Replace `NumberStepperSize` with `DsSize`, imported from the package root.",
|
|
120
122
|
"searchHints": [
|
|
121
123
|
"NumberStepperSize"
|
|
122
124
|
],
|
|
@@ -127,7 +129,7 @@
|
|
|
127
129
|
"kind": "type-rename",
|
|
128
130
|
"old": "DatePickerSize",
|
|
129
131
|
"new": "DsSize",
|
|
130
|
-
"
|
|
132
|
+
"action": "Replace `DatePickerSize` with `DsSize`, imported from the package root.",
|
|
131
133
|
"searchHints": [
|
|
132
134
|
"DatePickerSize"
|
|
133
135
|
],
|
|
@@ -138,7 +140,7 @@
|
|
|
138
140
|
"kind": "type-rename",
|
|
139
141
|
"old": "TimePickerSize",
|
|
140
142
|
"new": "DsSize",
|
|
141
|
-
"
|
|
143
|
+
"action": "Replace `TimePickerSize` with `DsSize`, imported from the package root.",
|
|
142
144
|
"searchHints": [
|
|
143
145
|
"TimePickerSize"
|
|
144
146
|
],
|
|
@@ -149,7 +151,7 @@
|
|
|
149
151
|
"kind": "type-rename",
|
|
150
152
|
"old": "DrawerSize",
|
|
151
153
|
"new": "DsSize",
|
|
152
|
-
"
|
|
154
|
+
"action": "Replace `DrawerSize` with `DsSize`, imported from the package root.",
|
|
153
155
|
"searchHints": [
|
|
154
156
|
"DrawerSize"
|
|
155
157
|
],
|
|
@@ -160,7 +162,7 @@
|
|
|
160
162
|
"kind": "type-rename",
|
|
161
163
|
"old": "AutocompleteSize",
|
|
162
164
|
"new": "DsSize",
|
|
163
|
-
"
|
|
165
|
+
"action": "Replace `AutocompleteSize` with `DsSize`, imported from the package root.",
|
|
164
166
|
"searchHints": [
|
|
165
167
|
"AutocompleteSize"
|
|
166
168
|
],
|
|
@@ -171,7 +173,9 @@
|
|
|
171
173
|
"kind": "output-rename",
|
|
172
174
|
"old": "ds-pagination[pageChange]",
|
|
173
175
|
"new": "currentPageChange",
|
|
174
|
-
"
|
|
176
|
+
"action": "Rename `(pageChange)` to `(currentPageChange)` on ds-pagination.",
|
|
177
|
+
"appliesWhen": "`(pageSizeChange)` is unchanged — it is the pageSize model implicit output now, same name and payload. `[(currentPage)]` and `[(pageSize)]` two-way bindings need nothing.",
|
|
178
|
+
"note": "The manual output is gone: the `currentPage` model already emits on every page change, including the reset to page 1 after a size change.",
|
|
175
179
|
"searchHints": [
|
|
176
180
|
"(pageChange)",
|
|
177
181
|
"pageChange"
|
|
@@ -183,7 +187,9 @@
|
|
|
183
187
|
"kind": "removed-api",
|
|
184
188
|
"old": "ds-input[withAddon]",
|
|
185
189
|
"new": null,
|
|
186
|
-
"
|
|
190
|
+
"action": "Delete the `[withAddon]` attribute.",
|
|
191
|
+
"pitfall": "`withAddon` is a SUBSTRING of `withAddonRight`, so a loose match deletes both and the trailing item below never fires. Match the exact attribute. Separately, a bare `<ds-icon dsInputPrefix>` that carried the flag regains its proper left inset — that shift is the bugfix, not a regression.",
|
|
192
|
+
"note": "The flush-addon layout is derived from the DOM now: a boxed `.addon` projected into `[dsInputPrefix]` sits flush through `:has()`, and a bare icon keeps its inset.",
|
|
187
193
|
"searchHints": [
|
|
188
194
|
"[withAddon]"
|
|
189
195
|
],
|
|
@@ -195,7 +201,8 @@
|
|
|
195
201
|
"kind": "removed-api",
|
|
196
202
|
"old": "ds-input[withAddonRight]",
|
|
197
203
|
"new": null,
|
|
198
|
-
"
|
|
204
|
+
"action": "Delete the `[withAddonRight]` attribute.",
|
|
205
|
+
"note": "The trailing counterpart: a boxed `.addon.right` in `[dsInputSuffix]` sits flush through `:has()` now.",
|
|
199
206
|
"searchHints": [
|
|
200
207
|
"[withAddonRight]"
|
|
201
208
|
],
|
|
@@ -207,7 +214,8 @@
|
|
|
207
214
|
"kind": "selector-rename",
|
|
208
215
|
"old": "ds-app-shell",
|
|
209
216
|
"new": "ds-app-layout",
|
|
210
|
-
"
|
|
217
|
+
"action": "Rename the element and its closing tag from `ds-app-shell` to `ds-app-layout`, then apply the class, service and token items below.",
|
|
218
|
+
"note": "Behaviour is unchanged; the component shipped as ds-app-shell in the tagged 0.6.3 source.",
|
|
211
219
|
"searchHints": [
|
|
212
220
|
"ds-app-shell"
|
|
213
221
|
],
|
|
@@ -218,7 +226,7 @@
|
|
|
218
226
|
"kind": "type-rename",
|
|
219
227
|
"old": "AppShellComponent",
|
|
220
228
|
"new": "AppLayoutComponent",
|
|
221
|
-
"
|
|
229
|
+
"action": "Replace `AppShellComponent` with `AppLayoutComponent`.",
|
|
222
230
|
"searchHints": [
|
|
223
231
|
"AppShellComponent"
|
|
224
232
|
],
|
|
@@ -229,7 +237,7 @@
|
|
|
229
237
|
"kind": "type-rename",
|
|
230
238
|
"old": "ShellScrollService",
|
|
231
239
|
"new": "LayoutScrollService",
|
|
232
|
-
"
|
|
240
|
+
"action": "Replace `ShellScrollService` with `LayoutScrollService`.",
|
|
233
241
|
"searchHints": [
|
|
234
242
|
"ShellScrollService"
|
|
235
243
|
],
|
|
@@ -240,7 +248,8 @@
|
|
|
240
248
|
"kind": "token-rename",
|
|
241
249
|
"old": "--ds-app-shell-",
|
|
242
250
|
"new": "--ds-app-layout-",
|
|
243
|
-
"
|
|
251
|
+
"action": "Replace the prefix `--ds-app-shell-` with `--ds-app-layout-` on the four layout tokens: `-pad-x`, `-pad-y`, `-content-max-width`, `-height`.",
|
|
252
|
+
"appliesWhen": "DS-owned tokens only — no others ship under this prefix, and a variable of your own is out of scope.",
|
|
244
253
|
"searchHints": [
|
|
245
254
|
"--ds-app-shell-"
|
|
246
255
|
],
|
|
@@ -251,7 +260,9 @@
|
|
|
251
260
|
"kind": "behavior",
|
|
252
261
|
"old": null,
|
|
253
262
|
"new": null,
|
|
254
|
-
"
|
|
263
|
+
"action": "Retarget any CSS selector or e2e/unit test that named the old trigger or clear element: the trigger is a `div role=\"combobox\" tabindex=\"0\"` now, and the clear is a real `button aria-label=\"Clear selection\"`.",
|
|
264
|
+
"pitfall": "Nothing stops compiling, so this lands green and fails later — a selector like `ds-select button[role=combobox]` simply matches nothing, and a test that clicked the old `<span>` clear now clicks air.",
|
|
265
|
+
"note": "The clear affordance became keyboard-operable, which meant the trigger could no longer be a button wrapping another button.",
|
|
255
266
|
"searchHints": [
|
|
256
267
|
"ds-select",
|
|
257
268
|
"role=\"combobox\"",
|
|
@@ -274,7 +285,10 @@
|
|
|
274
285
|
"kind": "behavior",
|
|
275
286
|
"old": null,
|
|
276
287
|
"new": null,
|
|
277
|
-
"
|
|
288
|
+
"action": "Look at the vertical rhythm of your forms. To bring back the collapsing footer on a field, set `[reserveMessage]=\"false\"`.",
|
|
289
|
+
"appliesWhen": "The fourteen message-bearing fields only. ds-search and ds-number-stepper have no message row and are untouched.",
|
|
290
|
+
"pitfall": "Purely visual and nothing stops compiling, so it ships unless somebody looks: the reserved row sits about 23px under the control, and a tightly stacked pair of fields now reads as a deliberate gap between them.",
|
|
291
|
+
"note": "The footer used to exist only once a hint, error or counter was present, so a field with no message was shorter and grew when one first appeared. `reserveMessage` defaults to true now.",
|
|
278
292
|
"searchHints": [
|
|
279
293
|
"<ds-input",
|
|
280
294
|
"<ds-textarea",
|
|
@@ -297,7 +311,10 @@
|
|
|
297
311
|
"kind": "behavior",
|
|
298
312
|
"old": null,
|
|
299
313
|
"new": null,
|
|
300
|
-
"
|
|
314
|
+
"action": "Build the consumer immediately after the bump — the compiler enumerates every collision. Per member: keep the name and add `override` with a base-compatible signature where the base means the same thing, otherwise rename your own member. TableComponent gained `total`, `sortingOrder`, `animateHeight` and `scrollToTopOnPageChange`.",
|
|
315
|
+
"appliesWhen": "Only a consumer that EXTENDS a DS component class. Subclassing is unsupported (design-system.md § Components); anyone using the DS elements is unaffected.",
|
|
316
|
+
"pitfall": "It is not only the table this time — most component classes changed, so fixing the collisions the compiler names first can still leave others in files it has not reached. Check any renamed member against the base member list before settling on the new name.",
|
|
317
|
+
"note": "A subclass that already used one of the added names stops compiling: TS4114 wants an `override` modifier, TS2416 fires where the signature differs.",
|
|
301
318
|
"searchHints": [
|
|
302
319
|
"extends TableComponent",
|
|
303
320
|
"extends "
|
|
@@ -312,6 +329,7 @@
|
|
|
312
329
|
}
|
|
313
330
|
],
|
|
314
331
|
"informational": [
|
|
332
|
+
"Fifteen per-component size types collapsed into one shared `DsSize` (`sm | md | lg`) exported from the package root - IconButtonSize, ButtonSize, InputSize, SelectSize, SearchSize, CheckboxSize, RadioSize, SwitchSize, SpinnerSize, TextareaSize, NumberStepperSize, DatePickerSize, TimePickerSize, DrawerSize and AutocompleteSize. Each has its own item above. After the renames a file that imported several of them holds several identical `DsSize` imports; collapse them.",
|
|
315
333
|
"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.",
|
|
316
334
|
"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.",
|
|
317
335
|
"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.",
|
|
@@ -322,5 +340,6 @@
|
|
|
322
340
|
"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.",
|
|
323
341
|
"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.",
|
|
324
342
|
"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."
|
|
325
|
-
]
|
|
343
|
+
],
|
|
344
|
+
"deleteList": []
|
|
326
345
|
}
|
package/migrations/0.7.1.json
CHANGED
|
@@ -4,9 +4,12 @@
|
|
|
4
4
|
{
|
|
5
5
|
"id": "surface-motion-partial-a-la-carte",
|
|
6
6
|
"kind": "scss-api",
|
|
7
|
-
"old": "@use 'styles/overlay-motion';",
|
|
8
|
-
"new": "@use 'styles/surface-motion';\n@use 'styles/overlay-motion';",
|
|
9
|
-
"
|
|
7
|
+
"old": "@use '@ids-group-ltd/ids-design-system/styles/overlay-motion';",
|
|
8
|
+
"new": "@use '@ids-group-ltd/ids-design-system/styles/surface-motion';\n@use '@ids-group-ltd/ids-design-system/styles/overlay-motion';",
|
|
9
|
+
"action": "Add `@use '@ids-group-ltd/ids-design-system/styles/surface-motion';` to your styles entry, beside `styles/overlay-motion`. If you have no overlay-motion line, put it beside whatever DS partials you do `@use`. Order does not matter.",
|
|
10
|
+
"appliesWhen": "Only à-la-carte consumers who `@use` DS partials individually. `styles/ds` forwards it, so its users need nothing at all.",
|
|
11
|
+
"pitfall": "Missing it fails SILENTLY — no error, no warning. The keyframes simply do not exist, and modal, drawer, bottom-sheet, toast, banner, alert, loading-overlay and the overlay panels all render with no entrance animation. Write the package-qualified specifier too: a bare `styles/…` does not resolve in a consumer build.",
|
|
12
|
+
"note": "A 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 names through `--ds-<surface>-enter-keyframes`.",
|
|
10
13
|
"searchHints": [
|
|
11
14
|
"styles/overlay-motion",
|
|
12
15
|
"styles/ds",
|
|
@@ -20,7 +23,10 @@
|
|
|
20
23
|
"kind": "behavior",
|
|
21
24
|
"old": "ds-table[sortKey]",
|
|
22
25
|
"new": null,
|
|
23
|
-
"
|
|
26
|
+
"action": "Gate on `sortDir`, not on `sortKey`. `if (sortKey())` becomes `if (sortDir())`, and a server query built as `orderBy: sortKey()` must skip the clause when `sortDir()` is null.",
|
|
27
|
+
"appliesWhen": "Hosts that already read both need nothing, and neither do those passing `sortingOrder: ['asc','desc']`, which has no unsorted state. The table's own icons, aria-sort and client-side sorting were always gated on `sortDir` and are unchanged.",
|
|
28
|
+
"pitfall": "This item finds NOTHING in a template. The code that breaks is the host's own — a store, a page class, a query builder — and it names no DS symbol at all, so a search for `ds-table` comes back clean and the item gets recorded not-applicable. A common shape is `sorting: store.sortKey() ? { path: store.sortKey()!, order: store.sortDir() ?? 'Asc' } : undefined`, which keeps ordering a server-paged list by the last column the reader touched while the header shows no sort. Grep the `.ts` for the `detect` shapes.",
|
|
29
|
+
"note": "`sortKey` is no longer nulled when the cycle reaches unsorted: it keeps naming the column the user last touched, and `sortDir === null` alone means unsorted. It fixes a header desync for hosts that map \"off\" back to their own default sort.",
|
|
24
30
|
"searchHints": [
|
|
25
31
|
"sortKey",
|
|
26
32
|
"sortDir",
|
|
@@ -44,7 +50,10 @@
|
|
|
44
50
|
"kind": "behavior",
|
|
45
51
|
"old": "ds-input[reserveMessage]",
|
|
46
52
|
"new": null,
|
|
47
|
-
"
|
|
53
|
+
"action": "A form that validates and must not reflow turns it back on: `provideDsConfig({ field: { reserveMessage: true } })` app-wide, or `[reserveMessage]=\"true\"` per field. Bindings you wrote as `[reserveMessage]=\"false\"` to opt out can be deleted.",
|
|
54
|
+
"appliesWhen": "All fourteen message-bearing fields: input, textarea, select, autocomplete, multi-select, checkbox, radio, radio-group, switch, slider, date-picker, time-picker, color-picker, otp-input.",
|
|
55
|
+
"pitfall": "Two shifts, neither of which stops a build. A field with no hint gets about 23px shorter, so everything under it moves up — and then moves down again the first time a hint or error appears. And any tighter sub-stack you added to compensate for the old reserved gap now over-tightens: with the row collapsed, a normal 16px stack is correct again.",
|
|
56
|
+
"note": "Only the final fallback flipped, from true to false. The resolution chain is unchanged: per-field input, then `DS_CONFIG.field.reserveMessage`, then the default.",
|
|
48
57
|
"searchHints": [
|
|
49
58
|
"reserveMessage",
|
|
50
59
|
"[reserveMessage]",
|
|
@@ -72,7 +81,9 @@
|
|
|
72
81
|
"kind": "behavior",
|
|
73
82
|
"old": "provideDsConfig",
|
|
74
83
|
"new": null,
|
|
75
|
-
"
|
|
84
|
+
"action": "None in the normal case. If you deliberately used a nested call to RESET a section to defaults, spell that section out: `provideDsConfig({ datePicker: { locale: 'en-US', dateFormat: undefined, firstDayOfWeek: 1 } })`.",
|
|
85
|
+
"appliesWhen": "A single root-level `provideDsConfig` behaves exactly as before. Nested provision was neither documented nor safe to use.",
|
|
86
|
+
"note": "A nested provider merges with the config above it section by section instead of replacing it wholesale — it used `useValue`, so a subtree setting one flag silently reset every unrelated section. The merge is what lets the new `dsReserveMessages` directive scope one field flag without disturbing the rest.",
|
|
76
87
|
"searchHints": [
|
|
77
88
|
"provideDsConfig",
|
|
78
89
|
"DS_CONFIG",
|
|
@@ -89,7 +100,10 @@
|
|
|
89
100
|
"kind": "behavior",
|
|
90
101
|
"old": "extends TableComponent",
|
|
91
102
|
"new": null,
|
|
92
|
-
"
|
|
103
|
+
"action": "Build right after upgrading — the compiler enumerates every collision. Per member: rename your own, or add `override` where the base semantics genuinely match.",
|
|
104
|
+
"appliesWhen": "Only a consumer that EXTENDS a DS component class. Subclassing is unsupported (design-system.md § Components); anyone using the `<ds-…>` elements needs nothing.",
|
|
105
|
+
"pitfall": "One change here is a REMOVAL, and it fails the other way round: TooltipDirective dropped its protected `onOpen`, split into `onPointerEnter` / `onFocusIn` / `onFocusOut`. A subclass that overrode `onOpen` fails because its `override` now names a member the base does not declare — move the mouse-path body to `onPointerEnter` and the keyboard-path body to `onFocusIn`.",
|
|
106
|
+
"note": "Additions: all fourteen message-bearing fields gained `reserveMessageResolved`; CheckboxComponent, SwitchComponent and RadioComponent a protected `devMode`; InputComponent and TextareaComponent `control` and `focus`; SearchComponent `focus`; TableComponent `rowId` and `rowKey`; PaginationComponent `showPageSize`; TimePickerComponent `label`, `required`, `optional`, `labelId`, `fullWidth`; DatePickerComponent `fullWidth`; AppLayoutComponent `railOpen`, `railLabel`, `compact`, `closeRail` and the private `navigation`, `destroyRef`, `watchDesktopBreakpoint`. TS4114 demands `override`, TS2415 fires on a redeclared private, TS2416 where a signature differs.",
|
|
93
107
|
"searchHints": [
|
|
94
108
|
"extends TableComponent",
|
|
95
109
|
"extends InputComponent",
|
|
@@ -119,7 +133,9 @@
|
|
|
119
133
|
"kind": "behavior",
|
|
120
134
|
"old": "LayoutScrollService",
|
|
121
135
|
"new": null,
|
|
122
|
-
"
|
|
136
|
+
"action": "Only if a screen relied on the blanket reset: inject the still-public `LayoutScrollService` and call `scrollToTop()` from the handler that changes the filter.",
|
|
137
|
+
"appliesWhen": "Nothing to do for anyone who found the old reset disruptive — that is the case this change serves.",
|
|
138
|
+
"note": "The content scroll resets only when the PATH changes now, not on every NavigationEnd, so a sort, page or filter change that rewrites just the query string or fragment keeps the reader where they were.",
|
|
123
139
|
"searchHints": [
|
|
124
140
|
"LayoutScrollService",
|
|
125
141
|
"scrollToTop",
|
|
@@ -136,25 +152,36 @@
|
|
|
136
152
|
},
|
|
137
153
|
{
|
|
138
154
|
"id": "modal-title-flex-moved-to-heading",
|
|
139
|
-
"kind": "
|
|
140
|
-
"old": "ds-modal-card .title",
|
|
141
|
-
"new":
|
|
142
|
-
"
|
|
155
|
+
"kind": "behavior",
|
|
156
|
+
"old": "ds-modal-card ::ng-deep .title { flex: … }",
|
|
157
|
+
"new": null,
|
|
158
|
+
"action": "Only if you set `flex`, `width` or `margin` on `.title` to control how the header row divides its space: move that declaration to `.heading`.",
|
|
159
|
+
"appliesWhen": "Only a consumer who styles the modal internal DOM. Everyone else is untouched.",
|
|
160
|
+
"pitfall": "`.title` is NOT renamed — it is still emitted, and a rule that only paints it (colour, font, letter-spacing) must NOT be re-pointed. Re-pointing it moves the paint onto a box that also wraps the eyebrow.",
|
|
161
|
+
"note": "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 `.title` moved to that wrapper.",
|
|
143
162
|
"searchHints": [
|
|
144
|
-
"ds-modal",
|
|
145
|
-
"ds-modal-card",
|
|
146
|
-
".modal-card .title",
|
|
147
163
|
".title",
|
|
148
|
-
"
|
|
164
|
+
".heading",
|
|
165
|
+
"ds-modal-card",
|
|
166
|
+
"ds-modal"
|
|
149
167
|
],
|
|
150
|
-
"surface": "style"
|
|
168
|
+
"surface": "style",
|
|
169
|
+
"verify": "Open a ds-modal-card that has both a title and an [eyebrow]: the title and eyebrow share one block that takes the free width, and the close button stays hard right. Any `.title` rule you kept still paints the heading text.",
|
|
170
|
+
"detect": [
|
|
171
|
+
"ds-modal-card ::ng-deep .title",
|
|
172
|
+
".title { flex",
|
|
173
|
+
".title{flex"
|
|
174
|
+
]
|
|
151
175
|
},
|
|
152
176
|
{
|
|
153
177
|
"id": "table-client-sort-blanks-last-and-numeric-collation",
|
|
154
178
|
"kind": "behavior",
|
|
155
179
|
"old": "ds-table[clientSort]",
|
|
156
180
|
"new": null,
|
|
157
|
-
"
|
|
181
|
+
"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.",
|
|
182
|
+
"appliesWhen": "Both changes apply with or without the new per-column `sortValue`.",
|
|
183
|
+
"pitfall": "Two orderings move at once and neither announces itself. Blanks used to be the smallest value, so on ascending they floated to the TOP; they sink to the bottom in both directions now. And the text fallback passes `{ numeric: true }` to localeCompare, so `item 9` precedes `item 10` instead of following it — a list that looked deliberately ordered can come back reordered.",
|
|
184
|
+
"note": "A cell reads as no-data when it is an empty string or one of the em dash, en dash, hyphen, `n/a`, `never` or `none`, matched case-insensitively.",
|
|
158
185
|
"searchHints": [
|
|
159
186
|
"clientSort",
|
|
160
187
|
"sortChange",
|
|
@@ -195,7 +222,7 @@
|
|
|
195
222
|
"`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).",
|
|
196
223
|
"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.",
|
|
197
224
|
"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.",
|
|
198
|
-
"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% }`)."
|
|
225
|
+
"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% }`). (delete list: pagination-inner-select-hidden)"
|
|
199
226
|
],
|
|
200
227
|
"deleteList": [
|
|
201
228
|
{
|
|
@@ -204,7 +231,7 @@
|
|
|
204
231
|
"find": [
|
|
205
232
|
"[reserveMessage]=\"false\""
|
|
206
233
|
],
|
|
207
|
-
"why": "The default is FALSE again, so an opt-out binding only restates it - unless the field sits under a `dsReserveMessages` host or an app config that turns it on, where the binding is still the way back out.
|
|
234
|
+
"why": "The default is FALSE again, so an opt-out binding only restates it - unless the field sits under a `dsReserveMessages` host or an app config that turns it on, where the binding is still the way back out.",
|
|
208
235
|
"replaceWith": "nothing - delete the binding where no host reserves"
|
|
209
236
|
},
|
|
210
237
|
{
|
|
@@ -216,6 +243,17 @@
|
|
|
216
243
|
],
|
|
217
244
|
"why": "A tighter sub-stack or a negative margin added to swallow the reserved message row is now over-tightening a form that no longer reserves it.",
|
|
218
245
|
"replaceWith": "the normal 16px field stack"
|
|
246
|
+
},
|
|
247
|
+
{
|
|
248
|
+
"id": "pagination-inner-select-hidden",
|
|
249
|
+
"surface": "style",
|
|
250
|
+
"find": [
|
|
251
|
+
"ds-pagination",
|
|
252
|
+
"ds-field-message",
|
|
253
|
+
"display: none"
|
|
254
|
+
],
|
|
255
|
+
"why": "A rule hiding the empty message row inside the pagination rows-per-page select. The component pins that select to its own compact shape now, so the row is gone at the source.",
|
|
256
|
+
"replaceWith": "nothing - delete the rule"
|
|
219
257
|
}
|
|
220
258
|
]
|
|
221
259
|
}
|