@ids-group-ltd/ids-design-system 0.10.3 → 0.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +359 -40
- package/components.md +14 -6
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +559 -464
- 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 +209 -32
- package/migrations/0.10.1.json +33 -9
- package/migrations/0.10.2.json +88 -22
- package/migrations/0.10.3.json +21 -4
- package/migrations/0.11.0.json +216 -0
- package/migrations/0.2.0.json +22 -9
- package/migrations/0.2.1.json +2 -1
- package/migrations/0.2.2.json +2 -1
- 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.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 +57 -19
- package/migrations/0.8.0.json +50 -12
- package/migrations/0.9.0.json +142 -23
- package/migrations/0.9.1.json +2 -1
- package/package.json +2 -1
- package/styles/_link.scss +1 -2
- package/styles/_overlay-motion.scss +0 -1
- package/types/ids-group-ltd-ids-design-system.d.ts +129 -59
- package/migrations/AUTHORING.md +0 -273
package/migrations/0.1.0.json
CHANGED
|
@@ -5,5 +5,6 @@
|
|
|
5
5
|
"Initial public release: 45+ standalone Angular components (buttons, forms, overlays, navigation, data display).",
|
|
6
6
|
"Three-tier token architecture (palette -> semantic theme -> geometry/typography/motion), default theme and palette swappable by consumers.",
|
|
7
7
|
"Bundled Mulish and JetBrains Mono fonts; SCSS sources shipped in the package (styles/, themes/)."
|
|
8
|
-
]
|
|
8
|
+
],
|
|
9
|
+
"deleteList": []
|
|
9
10
|
}
|
package/migrations/0.10.0.json
CHANGED
|
@@ -6,7 +6,10 @@
|
|
|
6
6
|
"kind": "behavior",
|
|
7
7
|
"old": "ds-autocomplete .autocomplete-trigger > ds-tag",
|
|
8
8
|
"new": null,
|
|
9
|
-
"
|
|
9
|
+
"action": "Drop the direct-child combinator (`.autocomplete-trigger ds-tag`) or insert the wrapper (`.chip-row > ds-tag`). Positional selectors become `.chip-row > ds-tag:first-child`.",
|
|
10
|
+
"appliesWhen": "Layout is unchanged ONLY on `[maxVisibleChips]=\"null\"`, where the wrapper is `display: contents` and the chips stay flex items of the trigger. In the measuring modes — which now includes the DEFAULT `fit` — the row becomes a nowrap flex box with `overflow: hidden` and the trigger flips to nowrap, so layout there is not unchanged either.",
|
|
11
|
+
"pitfall": "Three ways to get the rewrite wrong. The chips are no longer siblings of the filter input, the addon slots or the chevron, so a `ds-tag + .autocomplete-input` adjacency is gone with NO replacement. A multi-select trigger is `.field-trigger`, not `.trigger` — a selector written against `ds-multi-select .trigger` matches nothing and always did, so it looks like the wrapper broke it. And do not strip `data-chip` or `data-chip-overflow`: that is how the width measurement finds the chips, though selecting on them is fine.",
|
|
12
|
+
"note": "The chips of ds-autocomplete and ds-multi-select render inside a `<span class=\"chip-row\">` instead of sitting directly in the trigger, so a selector that walks the structure now matches the wrapper or nothing.",
|
|
10
13
|
"searchHints": [
|
|
11
14
|
"autocomplete-trigger > ds-tag",
|
|
12
15
|
"autocomplete-trigger>ds-tag",
|
|
@@ -31,7 +34,10 @@
|
|
|
31
34
|
"kind": "behavior",
|
|
32
35
|
"old": "extends AutocompleteComponent",
|
|
33
36
|
"new": null,
|
|
34
|
-
"
|
|
37
|
+
"action": "Run `npm run class-surface v0.9.1 v0.10.0` for the authoritative list, then per member: rename your own, or add `override` where the base semantics genuinely match. For the lost ones, drop the override and use the public API — `runExport()`, `exporting()`, `exportStatus()`, `status`.",
|
|
38
|
+
"appliesWhen": "Only a consumer that EXTENDS a DS component class. Subclassing is unsupported (design-system.md § Components); template users need nothing.",
|
|
39
|
+
"pitfall": "Three shapes the report cannot show you. (1) `TableComponent.exporting` and `.exportStatus` keep their NAMES but are public readonly signals now instead of the protected writable ones a subclass could set — assigning to them stops compiling and nothing in the diff says so. (2) SearchComponent also declares the plain private fields `pending` and `pushed`; class-surface matches `readonly` fields and methods, and a redeclared private still fails with TS2415. (3) Four classes LOST members — ModalComponent `error` and `onBackdrop`, ModalCardComponent `error`, BottomSheetComponent `stop`, InputComponent `floating` — so an `override` there now overrides nothing.",
|
|
40
|
+
"note": "Thirty classes gained members. The `controlState` additions on the nine bordered fields were invisible to class-surface until its field pattern was widened in this same release: it matched only `readonly x = call(…)`, and `controlState` is assigned from a property.",
|
|
35
41
|
"searchHints": [
|
|
36
42
|
"extends ButtonComponent",
|
|
37
43
|
"extends TableComponent",
|
|
@@ -63,7 +69,10 @@
|
|
|
63
69
|
"kind": "behavior",
|
|
64
70
|
"old": "ds-auth-layout [brand]",
|
|
65
71
|
"new": null,
|
|
66
|
-
"
|
|
72
|
+
"action": "Add `width: auto` to your own logo rule to restore the old result.",
|
|
73
|
+
"appliesWhen": "None for almost everyone. You are affected only if you BOTH opted into `--ds-auth-layout-brand-max-height` AND set an explicit width on the element you project into `[brand]`.",
|
|
74
|
+
"pitfall": "That logo used to scale to keep its ratio and will now honour your width — it can squash. The old declaration sat at specificity (0,2,0) and out-ranked your own width, which is why removing it changes anything at all.",
|
|
75
|
+
"note": "The slot rule declares only the `max-height` it shipped with in 0.9.0. With the default `max-height: none` the `width: auto` achieved nothing anyway: an `<img>` with no CSS width already keeps its ratio. ds-sidenav's identical slot gained the same constraint here and deliberately does not carry `width: auto` either.",
|
|
67
76
|
"searchHints": [
|
|
68
77
|
"--ds-auth-layout-brand-max-height",
|
|
69
78
|
"[brand]",
|
|
@@ -80,7 +89,10 @@
|
|
|
80
89
|
"kind": "behavior",
|
|
81
90
|
"old": "ds-tabs[urlParam]",
|
|
82
91
|
"new": null,
|
|
83
|
-
"
|
|
92
|
+
"action": "Either accept the new parameter values, or declare `value` on each `ds-tab` to pin the names permanently — the better fix regardless, since a slug is still derived from display copy and renaming a tab still moves the link.",
|
|
93
|
+
"appliesWhen": "Only consumers who adopted `urlParam` in 0.9.0 AND left `value` off their tabs. A label with nothing sluggable in it — CJK, bare punctuation — keeps its raw text.",
|
|
94
|
+
"pitfall": "Existing links stop matching and land on the first tab, and nothing throws: it is indistinguishable from a stale bookmark. Note too that `tabClosed` still emits the RAW label — the two identifiers are deliberately different now, and the docs said they were the same until this release.",
|
|
95
|
+
"note": "`?tab=License%20Verification%20Status` becomes `?tab=license-verification-status`: kebab, lowercased, diacritics decomposed and dropped.",
|
|
84
96
|
"searchHints": [
|
|
85
97
|
"urlParam",
|
|
86
98
|
"ds-tabs",
|
|
@@ -104,7 +116,9 @@
|
|
|
104
116
|
"kind": "input-rename",
|
|
105
117
|
"old": "ds-modal[error]",
|
|
106
118
|
"new": "ds-modal[status]",
|
|
107
|
-
"
|
|
119
|
+
"action": "`[error]=\"true\"` and a bare `error` become `status=\"error\"`. `[error]=\"false\"` and any unset case become nothing at all. A computed `[error]=\"expr\"` becomes `[status]=\"expr && 'error'\"` — the input takes false and undefined as \"no status\", so the short form binds under strictTemplates; `[status]=\"expr ? 'error' : null\"` is equally correct.",
|
|
120
|
+
"pitfall": "The mapping is mechanical but the RESULT is not the same dialog. A status drives four things now rather than one: the icon-badge tint, the title colour, a default icon, and the ARIA role — error and warning make the dialog an `alertdialog`, which changes how assistive tech announces and traps it. Both are overridable (`icon` beats the status pick, an explicit `dialogRole` beats the status role), and the default icon is deliberate: a tint alone signals by colour only.",
|
|
121
|
+
"note": "`error: boolean` became `status: DsStatus` (`info | success | warning | error`), because a boolean cannot express a warning or an info dialog and the rest of the library settled on that vocabulary in 0.9.0.",
|
|
108
122
|
"searchHints": [
|
|
109
123
|
"[error]",
|
|
110
124
|
"ds-modal",
|
|
@@ -120,7 +134,10 @@
|
|
|
120
134
|
"kind": "behavior",
|
|
121
135
|
"old": "ds-autocomplete[maxVisibleChips]",
|
|
122
136
|
"new": null,
|
|
123
|
-
"
|
|
137
|
+
"action": "Nothing, unless a screen relied on the growth — then bind `[maxVisibleChips]=\"null\"` to show every chip again.",
|
|
138
|
+
"appliesWhen": "ds-autocomplete and ds-multi-select alike. Check a form where a trigger sits above other fields, any layout whose height was measured or asserted with several chips selected, and any chip whose content is longer than a word.",
|
|
139
|
+
"pitfall": "Two things ride along with the default and are easy to miss. A trigger in any measuring mode — `fit` or a number — is `flex-wrap: nowrap` now, so its chips are held to one line each and CLIPPED rather than wrapped; only `null` still wraps. And a NUMBER is no longer an exact count: it is a ceiling that is then measured, so a narrow trigger shows FEWER than N.",
|
|
140
|
+
"note": "`maxVisibleChips` defaults to `fit` instead of null. A multi-value trigger used to grow a line per selection and push the rest of the form down the page; it keeps as many chips as it is wide now and collapses the rest into \"+N more\", re-splitting on resize.",
|
|
124
141
|
"searchHints": [
|
|
125
142
|
"maxVisibleChips",
|
|
126
143
|
"ds-multi-select",
|
|
@@ -136,7 +153,9 @@
|
|
|
136
153
|
"kind": "behavior",
|
|
137
154
|
"old": "[data-density=\"ultra-compact\"]",
|
|
138
155
|
"new": null,
|
|
139
|
-
"
|
|
156
|
+
"action": "If you want the old value inside an ultra-compact container, re-declare `--ds-container-pad: var(--space-6)` on it.",
|
|
157
|
+
"appliesWhen": "Only screens that set `[data-density=\"ultra-compact\"]` on a container holding a ds-card or ds-stat. The default and the other three tiers still resolve to 24px. Per-component pins (`--ds-card-pad`, `--ds-stat-pad`) still win and are unaffected — though they are worth collapsing into one `--ds-container-pad`, which is the lever both components default to.",
|
|
158
|
+
"note": "The tier compresses `--ds-container-pad` from 24px to 16px. It already compressed field padding and table-cell padding, so a card kept its full 24px frame while its own cells halved — the surface padding was the one it missed.",
|
|
140
159
|
"searchHints": [
|
|
141
160
|
"data-density",
|
|
142
161
|
"ultra-compact",
|
|
@@ -160,7 +179,10 @@
|
|
|
160
179
|
"kind": "behavior",
|
|
161
180
|
"old": "size()",
|
|
162
181
|
"new": null,
|
|
163
|
-
"
|
|
182
|
+
"action": "Keep the value you bound and read that, or resolve `DS_CONFIG.control.size` yourself. The built-in fallbacks are unchanged: `md` for size, `flat` for card elevation, 16 for icon size, false for badge withDot and for table bordered / stickyScrollbar.",
|
|
183
|
+
"appliesWhen": "NOTHING changes in a template — `size=\"sm\"` binds as before and an unsized control still renders md. Only reading the signal back changes. The same nullable-plus-protected-resolver shape now applies to ds-card elevation and padding, ds-icon size, ds-badge withDot, ds-table bordered / stickyScrollbar, dividers on ds-modal and ds-modal-card, and brand / logoLetter / tagline on ds-sidenav and ds-auth-layout.",
|
|
184
|
+
"pitfall": "There is NO public replacement accessor. Each component holds a `sizeResolved()` but declares it `protected`, so `cmp.sizeResolved()` from a host, a viewChild or a test does not compile (TS2445) — ds-field-group is the one exception, where it is public. So `size()` returning null where it used to return `md` has no one-line fix. Separately, if you implement DsFieldGroupContext yourself, its member is `sizeResolved` now rather than `size`.",
|
|
185
|
+
"note": "The size input on fourteen controls is typed `DsSize | null` and defaults to null, so an unbound size can fall through to the new `DS_CONFIG.control.size`.",
|
|
164
186
|
"searchHints": [
|
|
165
187
|
".size()",
|
|
166
188
|
"sizeResolved",
|
|
@@ -182,7 +204,10 @@
|
|
|
182
204
|
"kind": "removed-api",
|
|
183
205
|
"old": "TableComponent.sortKey.set()",
|
|
184
206
|
"new": null,
|
|
185
|
-
"
|
|
207
|
+
"action": "Keep the sort in your own state and bind it in — which every server-paged list already does — or listen to `(sortChange)` and write your own signal.",
|
|
208
|
+
"appliesWhen": "Templates are unaffected: `[(sortKey)]` and `[(sortDir)]` still work, one-way `[sortKey]` with `(sortChange)` still works, a static `sortKey=\"project\"` still works, and reading `table.sortKey()` still returns what the host bound.",
|
|
209
|
+
"pitfall": "`table.sortKey.set(…)` and `table.sortDir.set(…)` no longer exist, because an input is read-only.",
|
|
210
|
+
"note": "They changed from `model()` to an `input()` plus a matching output, so the component can tell a host write apart from its own — the fix for the lost sort indicator.",
|
|
186
211
|
"searchHints": [
|
|
187
212
|
"sortKey.set",
|
|
188
213
|
"sortDir.set",
|
|
@@ -205,7 +230,10 @@
|
|
|
205
230
|
"kind": "behavior",
|
|
206
231
|
"old": "ds-button[variant=outline]",
|
|
207
232
|
"new": null,
|
|
208
|
-
"
|
|
233
|
+
"action": "Only if a button sits on a photo, a gradient or any busy ground and needed the opaque fill: set `--ds-button-bg-color: var(--surface-default)` on that instance, or the `--ds-icon-button-bg-color` / `--ds-split-button-outline-bg-color` equivalent.",
|
|
234
|
+
"appliesWhen": "Only buttons placed on a non-white ground; on the default page surface the rendering is identical. Hover fills are unchanged and all still opaque.",
|
|
235
|
+
"pitfall": "The disabled state is transparent too on ds-button and ds-icon-button — mixing a transparent fill toward `--surface-disabled` would give a 72%-alpha box — so the border and label carry it. A disabled outlined ds-split-button is the EXCEPTION and still paints `--surface-muted`, because its outline rules are gated on `:not(:disabled)`. Two components that look alike now disable differently.",
|
|
236
|
+
"note": "The outlined variants default their fill to `transparent` instead of `--surface-default`. An opaque white fill is invisible on a white page and wrong on every tinted one; Material 3 and Bootstrap both specify a transparent container for this variant.",
|
|
209
237
|
"searchHints": [
|
|
210
238
|
"variant=\"outline\"",
|
|
211
239
|
"variant=\"outlined\"",
|
|
@@ -222,7 +250,10 @@
|
|
|
222
250
|
"kind": "removed-api",
|
|
223
251
|
"old": "ds-input[floating]",
|
|
224
252
|
"new": null,
|
|
225
|
-
"
|
|
253
|
+
"action": "Remove the `floating` attribute. The label then renders above the field like every other DS field.",
|
|
254
|
+
"appliesWhen": "`--ds-elevation-floating` is unrelated and UNTOUCHED — it is the elevation role for toasts, and a name-blind sweep will find it.",
|
|
255
|
+
"pitfall": "A height change rides along: a floating ds-input was 48px and now takes the normal size scale, 40px at `md`, so a row built around one needs its height re-checked. And the five internal tokens the variant read are gone — `--field-h-floating`, `--field-floating-label-fs`, `--field-floating-label-lh`, `--field-floating-label-top`, `--field-floating-pad-t` — so an override of any of them is now inert rather than wrong.",
|
|
256
|
+
"note": "It was half-built: the label was drawn inside a taller control but never animated out of the field on focus, which is the whole point — so an empty field read as a permanently mislabelled one.",
|
|
226
257
|
"searchHints": [
|
|
227
258
|
"floating",
|
|
228
259
|
"[floating]",
|
|
@@ -235,15 +266,21 @@
|
|
|
235
266
|
"--field-floating-label-top",
|
|
236
267
|
"--field-floating-pad-t"
|
|
237
268
|
],
|
|
238
|
-
"surface":
|
|
239
|
-
|
|
269
|
+
"surface": [
|
|
270
|
+
"template",
|
|
271
|
+
"style"
|
|
272
|
+
],
|
|
273
|
+
"verify": "No ds-input carries a `floating` attribute or binding. No stylesheet still sets --field-h-floating, --field-floating-label-fs, --field-floating-label-lh, --field-floating-label-top or --field-floating-pad-t: those five were declared at :root and are gone, so an override of any of them now resolves to nothing."
|
|
240
274
|
},
|
|
241
275
|
{
|
|
242
276
|
"id": "field-invalid-class-to-data-field-state",
|
|
243
277
|
"kind": "selector-rename",
|
|
244
278
|
"old": "ds-color-picker.invalid",
|
|
245
279
|
"new": "ds-color-picker[data-field-state='error']",
|
|
246
|
-
"
|
|
280
|
+
"action": "Rewrite a CSS override selecting `.invalid` on ds-color-picker, ds-otp-input or ds-multi-select's `.field-trigger` as `[data-field-state='error']`.",
|
|
281
|
+
"appliesWhen": "Those three only. ds-slider still binds `[class.invalid]` on its HOST and still paints through it (`:host(.invalid) .fill / .thumb`), and ds-field-group has its own `[invalid]` input and its own class — leave both alone, even though `.invalid` is one of this item's search hints.",
|
|
282
|
+
"pitfall": "`.error` is STILL EMITTED — on the wrapper by ds-input and ds-textarea, on the box by ds-select, ds-date-picker, ds-time-picker and ds-autocomplete, and `.success` by ds-input alone. Your selectors keep matching, so nothing looks broken, but the library no longer PAINTS through them: a rule written to stack on top of a DS rule now stands alone and carries the whole state by itself.",
|
|
283
|
+
"note": "Validation state on a field's control is one shared rule keyed off a `data-field-state` attribute on the host (`error | warning | success`), replacing three different spellings.",
|
|
247
284
|
"searchHints": [
|
|
248
285
|
"ds-color-picker.invalid",
|
|
249
286
|
"ds-otp-input.invalid",
|
|
@@ -260,7 +297,10 @@
|
|
|
260
297
|
"kind": "behavior",
|
|
261
298
|
"old": "ds-autocomplete[maxVisibleChips]",
|
|
262
299
|
"new": null,
|
|
263
|
-
"
|
|
300
|
+
"action": "Nothing for most, and a wide trigger still shows exactly N. You are affected only if you relied on a numeric cap to guarantee a fixed chip COUNT regardless of width.",
|
|
301
|
+
"appliesWhen": "ds-autocomplete and ds-multi-select alike. `null` remains the only mode that never measures.",
|
|
302
|
+
"pitfall": "The stale wording is still in the wild and it contradicts this item: the input's own JSDoc in both components, and the generated docs API table built from it, still say \"A NUMBER caps at exactly that many\". The manifest and the CHANGELOG are correct; those are not.",
|
|
303
|
+
"note": "A number is a CEILING that is then measured. `[maxVisibleChips]=\"2\"` means at most two, and fewer when the trigger is too narrow to hold them beside the \"+N more\" marker. Exactly-N is what made a capped trigger on a phone run out of room and wrap the text input onto a second line — the growth the cap exists to prevent. The single-line height is guaranteed instead.",
|
|
264
304
|
"searchHints": [
|
|
265
305
|
"maxVisibleChips",
|
|
266
306
|
"ds-autocomplete",
|
|
@@ -275,7 +315,10 @@
|
|
|
275
315
|
"kind": "behavior",
|
|
276
316
|
"old": "ds-autocomplete[maxVisibleChips]",
|
|
277
317
|
"new": null,
|
|
278
|
-
"
|
|
318
|
+
"action": "Replace every 0 that can reach this input — a literal, or an expression evaluating to 0 such as a count, a config value or a `?? 0` default — with the BINDING `[maxVisibleChips]=\"null\"`. Read the expression feeding the input, not just the template text: a grep for the literal misses the computed cases.",
|
|
319
|
+
"appliesWhen": "ds-autocomplete and ds-multi-select alike.",
|
|
320
|
+
"pitfall": "A STATIC `maxVisibleChips=\"null\"` is NOT equivalent and reintroduces the bug. The transform reads `raw === 'fit' ? 'fit' : raw == null ? null : numberAttribute(raw)`, so the string `'null'` is not `== null`, falls through to `numberAttribute('null')` → NaN, and `Math.min(Math.max(NaN, 0), total)` → NaN → zero chips again. Only the property binding passes a real null.",
|
|
321
|
+
"note": "0 used to mean \"show every chip\" — the old code read `max && max > 0 ? slice(0, max) : all`, and 0 is falsy. It means \"show NO chips\" now, putting the whole selection behind the \"+N more\" marker. Nothing throws; the trigger just empties.",
|
|
279
322
|
"searchHints": [
|
|
280
323
|
"maxVisibleChips",
|
|
281
324
|
"maxVisibleChips]=\"0\"",
|
|
@@ -299,7 +342,10 @@
|
|
|
299
342
|
"kind": "behavior",
|
|
300
343
|
"old": "ds-table[stickyScrollbar]",
|
|
301
344
|
"new": null,
|
|
302
|
-
"
|
|
345
|
+
"action": "Audit bindings whose expression is optional — `obj?.flag`, an `input()` with no default, an `| async` before it resolves — and coerce them yourself: `[dividers]=\"!!maybe\"`.",
|
|
346
|
+
"appliesWhen": "A literal `[bordered]=\"false\"`, a bare attribute and a static `bordered=\"false\"` are all unaffected. Check all five inputs, not just the scoped one: ds-table `bordered` and `stickyScrollbar`, ds-badge `withDot`, and `dividers` on ds-modal and ds-modal-card.",
|
|
347
|
+
"pitfall": "The five are not symmetric. For bordered, stickyScrollbar and withDot the built-in is false, so only an app that also sets the matching provideDsConfig section sees anything. For `dividers` the built-in is TRUE, so `[dividers]=\"someNullable\"` flips from no-rules to RULES the moment the expression yields null or undefined.",
|
|
348
|
+
"note": "`booleanAttribute(null)` is false, so these bindings used to render as OFF. Having swapped booleanAttribute for a nullable transform so they can fall through to DS_CONFIG, the same binding now reads as \"unset\" and resolves config-then-built-in.",
|
|
303
349
|
"searchHints": [
|
|
304
350
|
"[dividers]",
|
|
305
351
|
"[bordered]",
|
|
@@ -326,7 +372,10 @@
|
|
|
326
372
|
"kind": "behavior",
|
|
327
373
|
"old": "ds-bottom-sheet",
|
|
328
374
|
"new": null,
|
|
329
|
-
"
|
|
375
|
+
"action": "If you have a `(click)` handler on an element that CONTAINS a ds-bottom-sheet — a card, a row, a section that opens something — it now fires for clicks made inside the sheet. Move the handler, or stop propagation on your own side.",
|
|
376
|
+
"appliesWhen": "The `stop` member is also gone from the class, which matters only to a subclass that overrode it.",
|
|
377
|
+
"pitfall": "The sheet renders INLINE rather than through an overlay portal, so its clicks bubble into YOUR tree, not out of a detached one. That is why an ancestor handler you never associated with the sheet starts firing.",
|
|
378
|
+
"note": "The panel carried `(click)=\"stop($event)\"` purely to keep an inside click from reaching the backdrop listener. That listener is gone, replaced by the pointerdown+pointerup pair that fixes mouse-up dismissal, so the guard went with it.",
|
|
330
379
|
"searchHints": [
|
|
331
380
|
"ds-bottom-sheet",
|
|
332
381
|
"(click)",
|
|
@@ -346,7 +395,10 @@
|
|
|
346
395
|
"kind": "behavior",
|
|
347
396
|
"old": "ds-input[error]",
|
|
348
397
|
"new": null,
|
|
349
|
-
"
|
|
398
|
+
"action": "Nothing if you bound `[invalid]` alongside it. If you bound `error` ALONE and relied on the box staying neutral, move that text to `warning` for an advisory message, or to `hint`, and leave `error` empty.",
|
|
399
|
+
"appliesWhen": "The fourteen field components that route through resolveFieldMessage — border and fill on the nine bordered ones, aria-invalid and the message state on the other five.",
|
|
400
|
+
"pitfall": "The precedence ladder is error → warning → success now, so a ds-input carrying both `[success]=\"true\"` and a warning string paints the WARNING, where it used to paint success and ignore the warning.",
|
|
401
|
+
"note": "An `error` string marks the field invalid on its own. It used to colour only the message and leave the control neutral; it drives the error border, the tinted fill, the error focus ring and aria-invalid now.",
|
|
350
402
|
"searchHints": [
|
|
351
403
|
"error=\"",
|
|
352
404
|
"[error]",
|
|
@@ -368,7 +420,10 @@
|
|
|
368
420
|
"kind": "behavior",
|
|
369
421
|
"old": ":focus-visible",
|
|
370
422
|
"new": null,
|
|
371
|
-
"
|
|
423
|
+
"action": "Only if you deliberately relied on an element having NO focus indicator: give it `box-shadow: none` explicitly. The rule also sets `outline: none`, so an element relying on the BROWSER outline loses it — declare your own if that is what you wanted.",
|
|
424
|
+
"appliesWhen": "Written with `:where()`, so every component rule and every app rule still out-ranks it, and the `data-focus` switch is unaffected.",
|
|
425
|
+
"pitfall": "The case that actually bites: an app rule that styles `:focus-visible` with an OUTLINE ONLY. It keeps winning on outline, but it says nothing about box-shadow, so the base rule still supplies one and the element renders BOTH — a second ring in your colour around the DS ring. The app rule looks untouched because it is, so neither the build nor a grep for the change finds it; one consumer hit it fourteen times. FIND IT by grepping your styles for `:focus-visible` and reading each rule: one that sets outline (or outline-color / outline-offset) and no box-shadow is a hit. Add `box-shadow: none`, or better, delete the rule and retint the DS ring through `--ds-control-focus-shadow`.",
|
|
426
|
+
"note": "One zero-specificity base rule — `:where(:focus-visible) { outline: none; box-shadow: var(--ds-control-focus-shadow) }` — gives the DS ring to any focusable element that does not style focus itself, including your own bare `<button>`, a link in projected content, and the close buttons inside ds-alert, ds-banner and ds-drawer. They fell through to the browser default before.",
|
|
372
427
|
"searchHints": [
|
|
373
428
|
":focus-visible",
|
|
374
429
|
":focus",
|
|
@@ -391,7 +446,10 @@
|
|
|
391
446
|
"kind": "behavior",
|
|
392
447
|
"old": "ds-modal",
|
|
393
448
|
"new": null,
|
|
394
|
-
"
|
|
449
|
+
"action": "Nothing in application code. In TESTS, a dismissal written as `backdropElement.click()` must dispatch `pointerdown` + `pointerup` on the backdrop instead, each with `button: 0`.",
|
|
450
|
+
"appliesWhen": "ds-drawer and the ModalService confirm were never affected — their scrim is a SIBLING of the panel rather than a wrapper — and are unchanged.",
|
|
451
|
+
"pitfall": "The only consumer-code break is in tests, so the app looks fine and the suite goes red. A real mouse or touch has always sent both events; only a synthetic `click()` sent one.",
|
|
452
|
+
"note": "Dismissal requires the press AND the release to land on the backdrop, both with the primary button, so selecting text and letting go past the edge — or overshooting a slider — no longer closes the dialog.",
|
|
395
453
|
"searchHints": [
|
|
396
454
|
"backdrop",
|
|
397
455
|
".click()",
|
|
@@ -414,7 +472,10 @@
|
|
|
414
472
|
"kind": "behavior",
|
|
415
473
|
"old": "ds-modal-card[dialogRole]",
|
|
416
474
|
"new": null,
|
|
417
|
-
"
|
|
475
|
+
"action": "Set `dialogRole=\"dialog\"` explicitly wherever you want the role pinned regardless of status.",
|
|
476
|
+
"appliesWhen": "What RENDERS is unchanged while no status is set — unset still resolves to `role=\"dialog\"`. Only reading `dialogRole()` back differs: it returns null rather than `dialog` when nothing was bound.",
|
|
477
|
+
"pitfall": "`ds-modal` has NO `dialogRole` input at all, so `<ds-modal status=\"error\">` becomes an `alertdialog` with nothing to override it. Use ds-modal-card directly if you need the role back.",
|
|
478
|
+
"note": "The input became nullable so that \"unset\" is distinguishable from a deliberate `dialog`; a status of error or warning now resolves to `alertdialog` unless you say otherwise.",
|
|
418
479
|
"searchHints": [
|
|
419
480
|
"dialogRole",
|
|
420
481
|
"ds-modal-card",
|
|
@@ -437,7 +498,9 @@
|
|
|
437
498
|
"kind": "removed-api",
|
|
438
499
|
"old": "avatarTint(seed, { chroma })",
|
|
439
500
|
"new": "avatarTint(seed, { saturation })",
|
|
440
|
-
"
|
|
501
|
+
"action": "Three option changes. `chroma` is REMOVED — use `saturation`, an HSL percentage, default 50. `lightness` keeps its name and its default of 62 but means HSL lightness now, so re-pick any override. `foreground` defaults to `#fff`; pass it explicitly for anything else. `avoidHues` and the seed hashing are unchanged, so a given seed keeps its hue.",
|
|
502
|
+
"pitfall": "A leftover `chroma` is silently IGNORED — this one does not fail the build. And `lightness` is worse: it keeps its name AND its default, so the same number you passed before now produces a different colour, with nothing to flag it. Accessibility is a deliberate, accepted regression: white initials on the lighter hues measure as little as 1.65:1, and all 29 sampled hues in the 20–300 range fall short of the 4.5:1 WCAG AA asks of text. If your avatars carry initials as the ONLY identifier, override `lightness` to about 50 and keep white, which measures 5.3–6.6:1.",
|
|
503
|
+
"note": "`avatarTint` produces `hsl(H 50% 62%)` with a pinned white foreground, replacing `oklch(62% 0.14 H)` with an auto-chosen black-or-white foreground.",
|
|
441
504
|
"searchHints": [
|
|
442
505
|
"avatarTint",
|
|
443
506
|
"chroma",
|
|
@@ -460,7 +523,10 @@
|
|
|
460
523
|
"kind": "behavior",
|
|
461
524
|
"old": "ds-radio-group",
|
|
462
525
|
"new": null,
|
|
463
|
-
"
|
|
526
|
+
"action": "Retarget any documentation or test that names Enter as the way to pick a radio in this group to Space.",
|
|
527
|
+
"appliesWhen": "Nothing for almost everyone, and forms get their Enter-to-submit back for free. Space still selects and the arrow keys still move the selection.",
|
|
528
|
+
"pitfall": "A test driving Enter at a ds-radio-group now falls through to whatever the form does with it, so it may submit rather than fail.",
|
|
529
|
+
"note": "Enter used to mean \"select the focused radio\" and called preventDefault(), which is neither native radio behaviour nor what the WAI-ARIA APG asks for — and inside a form it silently removed the keyboard's only way to submit.",
|
|
464
530
|
"searchHints": [
|
|
465
531
|
"ds-radio-group",
|
|
466
532
|
"keydown.enter",
|
|
@@ -481,7 +547,10 @@
|
|
|
481
547
|
"kind": "behavior",
|
|
482
548
|
"old": "TableColumn",
|
|
483
549
|
"new": null,
|
|
484
|
-
"
|
|
550
|
+
"action": "Handle the new union member at the read site — `typeof col.width === 'number'` before arithmetic — or widen your own type to `number | 'content'`.",
|
|
551
|
+
"appliesWhen": "Writers who never read the field back need no change: assigning INTO the column definition compiles exactly as before, and the capability itself is additive.",
|
|
552
|
+
"pitfall": "Breaking for READERS and invisible to writers, which is why it was added retroactively after a consumer's build was the first finder. `sum += col.width` gives TS2365, `fixed[col.key] = col.width` into a number gives TS2322, and a helper parameter typed `width: number` stops accepting it.",
|
|
553
|
+
"note": "`TableColumn.width` went from `width?: number` to `width?: number | 'content'`.",
|
|
485
554
|
"searchHints": [
|
|
486
555
|
"TableColumn",
|
|
487
556
|
".width"
|
|
@@ -499,7 +568,10 @@
|
|
|
499
568
|
"kind": "behavior",
|
|
500
569
|
"old": "InputSignal",
|
|
501
570
|
"new": null,
|
|
502
|
-
"
|
|
571
|
+
"action": "Retype the declaration to the widened union, or drop the explicit annotation and let inference carry it. A subclass override is the unsupported case — rename the member or retype it to match.",
|
|
572
|
+
"appliesWhen": "Templates and plain bindings are unaffected. This entry is the TYPE-LEVEL counterpart of `control-size-input-becomes-nullable` and `nullable-boolean-inputs-treat-null-as-unset`, which carry the value semantics.",
|
|
573
|
+
"pitfall": "These declarations stop compiling even where the VALUES are compatible, because the type-parameter position of InputSignal / InputSignalWithTransform is invariant: TS2416 on a subclass override, TS2322 on an assignment to an explicitly typed variable, viewChild target or helper parameter.",
|
|
574
|
+
"note": "Widened here, per `npm run class-surface v0.9.1 v0.10.0`: `size` to `DsSize | null` on fourteen controls; ds-icon `size` to `number | null`; ds-table `bordered` and `stickyScrollbar`, ds-badge `withDot` and `dividers` on both modals to `boolean | null`; ds-table `loading` to `boolean | 'skeleton' | 'overlay'`; ds-card `elevation` to `CardElevation | null`; ds-modal-card `dialogRole` nullable; `brand` / `logoLetter` / `tagline` on ds-auth-layout and ds-sidenav to `string | null`; `maxVisibleChips` to `number | 'fit' | null`.",
|
|
503
575
|
"searchHints": [
|
|
504
576
|
"InputSignal",
|
|
505
577
|
"InputSignalWithTransform",
|
|
@@ -512,6 +584,28 @@
|
|
|
512
584
|
"viewChild"
|
|
513
585
|
],
|
|
514
586
|
"verify": "No explicit declaration types a DS input signal with the old non-nullable parameters."
|
|
587
|
+
},
|
|
588
|
+
{
|
|
589
|
+
"id": "modal-confirm-error-tone-paints-a-badge",
|
|
590
|
+
"kind": "behavior",
|
|
591
|
+
"old": "ModalService.confirm({ tone: 'error' })",
|
|
592
|
+
"new": null,
|
|
593
|
+
"action": "None unless the badge is wrong for you. There is no input that suppresses it, so a destructive confirm that should not shout uses `tone: 'default'` — or omits `tone` — and styles its own button instead.",
|
|
594
|
+
"appliesWhen": "Other tones are unaffected.",
|
|
595
|
+
"note": "A confirm opened with `tone: 'error'` carries the modal error status treatment now — a red badge in the header — because ds-modal-confirm binds `[status]=\"tone === 'error' ? 'error' : null\"`. Before this release `tone` only coloured the confirm button.",
|
|
596
|
+
"surface": "typescript",
|
|
597
|
+
"verify": "Open a confirm built with tone: 'error'. The header shows the error badge and the confirm button is destructive; a confirm with no tone shows neither.",
|
|
598
|
+
"restore": null,
|
|
599
|
+
"searchHints": [
|
|
600
|
+
"ModalService",
|
|
601
|
+
".confirm(",
|
|
602
|
+
"tone: 'error'",
|
|
603
|
+
"tone: \"error\""
|
|
604
|
+
],
|
|
605
|
+
"detect": [
|
|
606
|
+
"confirm({",
|
|
607
|
+
"tone:"
|
|
608
|
+
]
|
|
515
609
|
}
|
|
516
610
|
],
|
|
517
611
|
"informational": [
|
|
@@ -539,8 +633,8 @@
|
|
|
539
633
|
"ds-modal and ds-bottom-sheet no longer dismiss when the mouse is RELEASED on the backdrop after a press that started inside the dialog (selecting text and letting go past the edge, or overshooting a slider). Their backdrop wraps the dialog, so the browser fires click at the nearest common ancestor - the backdrop itself - which the target===currentTarget guard could not tell apart. Dismissal now requires the press AND the release to land on the backdrop. Nothing to do on adoption. ONE EXCEPTION: a test that dismisses a dialog with backdropElement.click() must now dispatch pointerdown + pointerup on the backdrop; a real mouse or touch always sends both. ds-drawer and the ModalService confirm were never affected - their scrim is a sibling of the panel - and are unchanged.",
|
|
540
634
|
"ds-table gained one projection slot, [toolbar], for controls that act on THAT table (a search box, a status filter, a refresh) — the row the export button already lived in, which until now existed only while exportButton was on. Project several controls and the row lays them out (flex, wrap, 8px gap); project a single element of your own and it takes the full row width, so your own layout is the only one in play. Visually additive: the row COLLAPSES when nothing filled it and exportButton is off, so a table that uses neither is pixel-identical. It is not DOM-identical - <div class=\"table-toolbar\"><div class=\"toolbar-slot\"> is now rendered unconditionally and hidden with display:none, so a ds-table > :first-child selector or a DOM snapshot sees it. Page-level filters still belong in a ds-filter-bar above the table.",
|
|
541
635
|
"ds-table now exposes runExport(), exporting() and exportStatus() publicly, so an Export button placed anywhere (page header, filter bar, the new toolbar slot) runs the same path as the built-in one: the exportFetcher call, the download, the in-flight state and the live-region announcement.",
|
|
542
|
-
"ds-table no longer renders its empty row while loading is anything but false. Previously only loading=\"skeleton\" suppressed it, so an overlay reload with zero rows painted the empty state under the spinner. Nothing to do on adoption, and you can delete the @if(!loading) guard around your own empty template — worth checking whether you have one at all: of one consumer 14 overlay-loading tables, 9 shipped \"no rows\" copy during a load.",
|
|
543
|
-
"ds-table no longer loses its sort indicator when a host answers a cleared sort with its own default. Angular writes an input only when the bound expression changed (it diffs against the last value it wrote, which an internal .set() never updates), so whichever half of the host default equalled the last bound value was skipped: a host defaulting to desc had its desc dropped and the header marked nothing over sorted rows, while a host defaulting to asc was restored — the reason the same three clicks worked on one screen and not another. The marked state is now a linkedSignal over BOTH inputs. Nothing to do on adoption; you can delete any workaround that re-bound the sort after a clear.",
|
|
636
|
+
"ds-table no longer renders its empty row while loading is anything but false. Previously only loading=\"skeleton\" suppressed it, so an overlay reload with zero rows painted the empty state under the spinner. Nothing to do on adoption, and you can delete the @if(!loading) guard around your own empty template — worth checking whether you have one at all: of one consumer 14 overlay-loading tables, 9 shipped \"no rows\" copy during a load. (delete list: table-empty-template-loading-guard)",
|
|
637
|
+
"ds-table no longer loses its sort indicator when a host answers a cleared sort with its own default. Angular writes an input only when the bound expression changed (it diffs against the last value it wrote, which an internal .set() never updates), so whichever half of the host default equalled the last bound value was skipped: a host defaulting to desc had its desc dropped and the header marked nothing over sorted rows, while a host defaulting to asc was restored — the reason the same three clicks worked on one screen and not another. The marked state is now a linkedSignal over BOTH inputs. Nothing to do on adoption; you can delete any workaround that re-bound the sort after a clear. (delete list: table-sort-rebind-after-clear)",
|
|
544
638
|
"ds-table accepts [loading]=\"true\" and resolves the treatment itself: skeleton rows while filteredData is empty, overlay once rows are on screen. The existing values are untouched — false, 'skeleton' and 'overlay' behave exactly as before, so nothing changes on adoption.",
|
|
545
639
|
"Disabled rows and triggers are no longer dimmed twice. ds-select, ds-date-picker, ds-time-picker, ds-menu-item and the shared dropdown row each applied --text-disabled AND opacity 0.6 on top of it, which measured 1.68:1 against the surface where the colour alone gives 2.53:1 (an enabled control is 17.32:1). The opacity is gone from those five and the colour carries the state. A disabled calendar day and ds-toggle-button, where opacity is the ONLY signal, moved from --opacity-muted (0.6) to --opacity-disabled (0.5).",
|
|
546
640
|
"ds-button and ds-icon-button use ONE disabled-label recipe for every variant now: oklch(from accent 70% 0.035 h), replacing the 58% base plus the 52% overrides that tonal and outline carried. Reason, measured across the full variant x colour x state matrix: the old lightness sat where a saturated accent already is, so on primary and error the disabled label differed from the live one by 1.16-1.60:1 on four of the five variants (neutral was fine because its enabled label is nearly black). It is now 2.40-2.71:1 on the coloured variants, and up to 6.46:1 on neutral. The disabled label is FAINTER against its own background than before (2.1-2.7:1 where it was 3.4-5.2) - that is the intended trade, and disabled text is exempt from the WCAG contrast floor. Nothing to do on adoption; --ds-button-label-color-disabled and --ds-icon-button-icon-color-disabled still override per component.",
|
|
@@ -553,7 +647,7 @@
|
|
|
553
647
|
"An `error` string now marks the field invalid on its own, across all 14 field components that route through resolveFieldMessage (ds-input, ds-textarea, ds-select, ds-autocomplete, ds-multi-select, ds-date-picker, ds-time-picker, ds-color-picker, ds-otp-input, ds-slider, ds-checkbox, ds-radio, ds-radio-group, ds-switch). Before, error=\"...\" coloured only the message and left the control neutral; it now drives the error border, fill, focus ring and aria-invalid, which is what the input always documented. Nothing to do if you bound [invalid] alongside it. ACTION only if you bound `error` on its own and WANTED a neutral box: move that text to `warning` (advisory) or to `hint`.",
|
|
554
648
|
"A `warning` string now paints the control, not only the message line: a --warning-text border (#8A7400, 4.59:1 on a white field) on all nine bordered fields -- ds-input, ds-textarea, ds-select, ds-autocomplete, ds-multi-select, ds-date-picker, ds-time-picker, ds-color-picker, ds-otp-input. Success keeps its border-only treatment and error keeps border + tinted fill, so the three states stay ranked. Two visual corrections ride along and need no action: an invalid ds-autocomplete drew a near-black border because it read a --border-error token that has never existed, and ds-multi-select / ds-color-picker / ds-otp-input had the error border but not the fill their siblings had. Every per-component override token (--ds-input-bg-color-error, --ds-select-focus-shadow-error, and the rest) still applies.",
|
|
555
649
|
"ds-otp-input no longer leaves two characters in one cell when a second character is typed into an already-filled cell. The value the component reported was always correct -- only the rendered cell was stale -- so nothing to change on adoption. ACTION only if you worked around it by reading the cell inputs from the DOM instead of the component's value.",
|
|
556
|
-
"ds-password-rules: its screen-reader-only per-row text ('- not met') was rendering VISIBLY, because the .visually-hidden class it used was defined by no stylesheet -- ds-table, ds-date-picker and ds-stepper each declared their own private copy. One shared mixin now backs all four. The leaked text is also what wrapped every label in the two-column layout. Separately, the pending glyph changed from `minus` to a new `circle` icon and the row now transitions its colour over --duration-base. Nothing to change on adoption. ACTION only if you targeted the pending row's glyph by name, or added your own .visually-hidden definition to work around the leak -- that override is now redundant (DELETE-LIST).",
|
|
650
|
+
"ds-password-rules: its screen-reader-only per-row text ('- not met') was rendering VISIBLY, because the .visually-hidden class it used was defined by no stylesheet -- ds-table, ds-date-picker and ds-stepper each declared their own private copy. One shared mixin now backs all four. The leaked text is also what wrapped every label in the two-column layout. Separately, the pending glyph changed from `minus` to a new `circle` icon and the row now transitions its colour over --duration-base. Nothing to change on adoption. ACTION only if you targeted the pending row's glyph by name, or added your own .visually-hidden definition to work around the leak -- that override is now redundant (DELETE-LIST). (delete list: private-visually-hidden-definition)",
|
|
557
651
|
"The migration manifests themselves changed: 0.9.0.json gained a class-member-collision item it never had (fifteen classes plus four newly exported symbols), 0.8.0.json now names the private saveLayout/restoreLayout that actually stopped a consumer build, and 0.6.1 / 0.6.2 / 0.9.1 were written for the first time. Every released version now ships a manifest, so the auto-update planner no longer falls back to re-deriving a plan from changelog prose on those three. 0.6.2 turned out to carry something actionable nobody had in machine-readable form: a ds-bottom-sheet with nothing focusable inside it stopped closing on Escape.",
|
|
558
652
|
"ds-modal gained three public title tokens for the new statuses - --ds-modal-title-text-color-warning, -success and -info, defaulting to --warning-text / --success-text / --info-text - joining the -error that already existed. Additive: nothing moves until you set one.",
|
|
559
653
|
"The [empty] slot is now unreachable during ANY load, not just a skeleton one: the empty row is withheld whenever loading is not false, and the projection lives inside that branch. Copy you want a reader to see WHILE a load runs has to come from your own page, above or around the table.",
|
|
@@ -562,9 +656,9 @@
|
|
|
562
656
|
"ds-search's Clear button now follows the text ON SCREEN rather than the debounced value, so at a non-zero [debounce] it appears on the first keystroke instead of after the delay.",
|
|
563
657
|
"On a resizableColumns ds-table the first drag OR resize keystroke anywhere locks a measured pixel width onto every column that has none, TableColumn width:'content' included. Home on a column's own handle hands that one back; the column panel's Reset to default button and clearing the public two-way columnWidths hand back all of them.",
|
|
564
658
|
"ds-time-picker in mode=\"single\" no longer renders a Done button: the panel closes itself once the user has picked BOTH an hour and a minute during that opening, and Now spans the full width of the footer beneath the columns. mode=\"range\" is unchanged -- it keeps Done and does not auto-close. Separately, hovering an already-selected hour or minute no longer paints it with the neutral hover fill (a specificity defect that left selected white text on pale grey, most visible on touch where the last-tapped cell keeps :hover). ACTION only if you scripted the panel closing via the Done button in single mode -- there is no such button now -- or overrode `.time-footer .time-action` widths, which now stretch when Done is absent.",
|
|
565
|
-
"The collapsed ds-sidenav no longer sets align-items: center on itself, which had stopped its projected children from stretching: every ds-sidenav-item shrank to its 20px icon inside a 40px rail, so the active tile rendered 20x40 (a lozenge, with the orange active rail down one side) and the alert dot sat above the glyph's middle. Items now fill the rail column, and the dot is anchored to the glyph's top-right corner through a new --sidenav-collapsed-glyph token rather than to the tile's corner. Nothing to change on adoption. ACTION only if you projected your own element into a collapsed ds-sidenav and relied on it sizing to its content -- it now stretches to the full column width -- or if you added a ::ng-deep width override to work around the squashed items, which is now double-applied (DELETE-LIST).",
|
|
566
|
-
"ds-timeline-item now pulls its node column up by half the difference between the heading's line box and the node size, so the marker's centre lands on the heading's rather than 4.2px below it. Each item is that much shorter at the top. Nothing to change on adoption. ACTION only if you compensated for the old offset with your own margin on ds-timeline-item or its node -- that override now double-applies (DELETE-LIST).",
|
|
567
|
-
"Two follow-ups to the shared field-state work, both fixed before release. (1) A field carrying its own error/warning/success state inside a ds-field-group repainted its background, tinting one segment mid-row; the three state rules now carry :not(.in-group), so the group keeps drawing the row's single treatment. (2) ds-field-group's own [invalid] read var(--border-error), a token that has never been declared, so it fell through to currentColor and drew a near-black border; it now resolves through a new public --ds-field-group-border-color-error (default --error). Nothing to change on adoption. ACTION only if you had a ::ng-deep override forcing the group's invalid border back to red, or suppressing a segment's fill inside a group -- both are now redundant (DELETE-LIST).",
|
|
659
|
+
"The collapsed ds-sidenav no longer sets align-items: center on itself, which had stopped its projected children from stretching: every ds-sidenav-item shrank to its 20px icon inside a 40px rail, so the active tile rendered 20x40 (a lozenge, with the orange active rail down one side) and the alert dot sat above the glyph's middle. Items now fill the rail column, and the dot is anchored to the glyph's top-right corner through a new --sidenav-collapsed-glyph token rather than to the tile's corner. Nothing to change on adoption. ACTION only if you projected your own element into a collapsed ds-sidenav and relied on it sizing to its content -- it now stretches to the full column width -- or if you added a ::ng-deep width override to work around the squashed items, which is now double-applied (DELETE-LIST). (delete list: collapsed-sidenav-item-width-override)",
|
|
660
|
+
"ds-timeline-item now pulls its node column up by half the difference between the heading's line box and the node size, so the marker's centre lands on the heading's rather than 4.2px below it. Each item is that much shorter at the top. Nothing to change on adoption. ACTION only if you compensated for the old offset with your own margin on ds-timeline-item or its node -- that override now double-applies (DELETE-LIST). (delete list: timeline-item-offset-margin)",
|
|
661
|
+
"Two follow-ups to the shared field-state work, both fixed before release. (1) A field carrying its own error/warning/success state inside a ds-field-group repainted its background, tinting one segment mid-row; the three state rules now carry :not(.in-group), so the group keeps drawing the row's single treatment. (2) ds-field-group's own [invalid] read var(--border-error), a token that has never been declared, so it fell through to currentColor and drew a near-black border; it now resolves through a new public --ds-field-group-border-color-error (default --error). Nothing to change on adoption. ACTION only if you had a ::ng-deep override forcing the group's invalid border back to red, or suppressing a segment's fill inside a group -- both are now redundant (DELETE-LIST). (delete list: field-group-invalid-border-override)",
|
|
568
662
|
"ds-card no longer cancels Enter and Space for everything inside it. The card bound (keydown.enter)/(keydown.space) with an unconditional preventDefault() on its <article>, and keydown bubbles, so EVERY card - not just elevation=\"interactive\" ones - killed both keys for its whole subtree: Enter in a password field submitted nothing, Space did not toggle a checkbox, Enter on a link did not follow it, and a space could not be typed into a text field. Both handlers now run only on an interactive card and only when the key landed on the card itself. Nothing to do; screens built inside a ds-card simply start working.",
|
|
569
663
|
"ds-table's onRowKey no longer consumes Enter and Space for every target inside an interactive row, so a row's own select checkbox toggles with Space and a cell's button activates with Enter.",
|
|
570
664
|
"ds-menu's type-ahead no longer swallows printable characters coming from a text-entry control, so a search or filter input projected into a menu can be typed into. Keys from ordinary menu items still drive the type-ahead. Nothing to do."
|
|
@@ -778,6 +872,89 @@
|
|
|
778
872
|
],
|
|
779
873
|
"why": "A `stopPropagation()` on a control inside a clickable row, added so the row would not steal the control's KEY. Read each hit before deleting: a CLICK still bubbles (`onRowClick` only skips a target inside an `<input>`), so a click-path guard stays.",
|
|
780
874
|
"replaceWith": "nothing on the key path - `onRowKey` now requires `target === currentTarget`"
|
|
875
|
+
},
|
|
876
|
+
{
|
|
877
|
+
"id": "table-empty-template-loading-guard",
|
|
878
|
+
"surface": "template",
|
|
879
|
+
"find": [
|
|
880
|
+
"@if(!loading)",
|
|
881
|
+
"*ngIf=\"!loading\"",
|
|
882
|
+
"ds-table",
|
|
883
|
+
"empty"
|
|
884
|
+
],
|
|
885
|
+
"why": "A guard wrapped around your own empty-state template so it would not show during a load. It existed because only loading=\"skeleton\" suppressed the empty row, so an overlay reload with zero rows painted \"no rows\" under the spinner. ds-table suppresses it for every loading value now.",
|
|
886
|
+
"replaceWith": "nothing - project the empty template unguarded"
|
|
887
|
+
},
|
|
888
|
+
{
|
|
889
|
+
"id": "table-sort-rebind-after-clear",
|
|
890
|
+
"surface": "typescript",
|
|
891
|
+
"find": [
|
|
892
|
+
"sortChange",
|
|
893
|
+
"sortKey",
|
|
894
|
+
"sortDir",
|
|
895
|
+
"setTimeout"
|
|
896
|
+
],
|
|
897
|
+
"why": "Host code that re-bound the sort after a cleared sort, written because the header lost its indicator whenever the host default equalled the last value Angular had written. The marked state is a linkedSignal over both inputs now.",
|
|
898
|
+
"replaceWith": "nothing - answer the cleared sort with your default and stop there"
|
|
899
|
+
},
|
|
900
|
+
{
|
|
901
|
+
"id": "private-visually-hidden-definition",
|
|
902
|
+
"surface": "style",
|
|
903
|
+
"find": [
|
|
904
|
+
".visually-hidden",
|
|
905
|
+
"clip: rect",
|
|
906
|
+
"clip-path: inset(50%)"
|
|
907
|
+
],
|
|
908
|
+
"why": "Your own .visually-hidden definition, or a rule targeting the pending row glyph by name, written because the class ds-password-rules used was declared by no stylesheet and its screen-reader text rendered visibly. One shared mixin backs all four components now.",
|
|
909
|
+
"replaceWith": "nothing - the components carry the class themselves"
|
|
910
|
+
},
|
|
911
|
+
{
|
|
912
|
+
"id": "collapsed-sidenav-item-width-override",
|
|
913
|
+
"surface": "style",
|
|
914
|
+
"find": [
|
|
915
|
+
"ds-sidenav",
|
|
916
|
+
"::ng-deep",
|
|
917
|
+
"width",
|
|
918
|
+
"align-items: center"
|
|
919
|
+
],
|
|
920
|
+
"why": "A ::ng-deep width override on a collapsed ds-sidenav, written because the rail set align-items: center and every item shrank to its 20px icon inside the 40px rail. Items fill the rail column now, so the override double-applies.",
|
|
921
|
+
"replaceWith": "nothing - remove the override"
|
|
922
|
+
},
|
|
923
|
+
{
|
|
924
|
+
"id": "timeline-item-offset-margin",
|
|
925
|
+
"surface": "style",
|
|
926
|
+
"find": [
|
|
927
|
+
"ds-timeline-item",
|
|
928
|
+
"margin-top",
|
|
929
|
+
"margin: -"
|
|
930
|
+
],
|
|
931
|
+
"why": "A margin you added on ds-timeline-item or its node to pull the marker onto the heading centre. The component pulls the node column up itself now, so your compensation double-applies.",
|
|
932
|
+
"replaceWith": "nothing - remove the margin"
|
|
933
|
+
},
|
|
934
|
+
{
|
|
935
|
+
"id": "field-group-invalid-border-override",
|
|
936
|
+
"surface": "style",
|
|
937
|
+
"find": [
|
|
938
|
+
"ds-field-group",
|
|
939
|
+
"::ng-deep",
|
|
940
|
+
"border-error",
|
|
941
|
+
"invalid"
|
|
942
|
+
],
|
|
943
|
+
"why": "A ::ng-deep override forcing the group invalid border back to red, or suppressing a segment fill inside a group. Both existed because the group read an undeclared token and a segment repainted its own state mid-row; both are fixed in the component.",
|
|
944
|
+
"replaceWith": "nothing - both overrides are redundant"
|
|
945
|
+
},
|
|
946
|
+
{
|
|
947
|
+
"id": "floating-label-token-overrides",
|
|
948
|
+
"surface": "style",
|
|
949
|
+
"find": [
|
|
950
|
+
"--field-h-floating",
|
|
951
|
+
"--field-floating-label-fs",
|
|
952
|
+
"--field-floating-label-lh",
|
|
953
|
+
"--field-floating-label-top",
|
|
954
|
+
"--field-floating-pad-t"
|
|
955
|
+
],
|
|
956
|
+
"why": "An override of one of the five floating-label tokens. They were :root declarations backing the floating variant, which this release removed, so the declaration now sets a custom property nothing reads.",
|
|
957
|
+
"replaceWith": "nothing - delete the declaration"
|
|
781
958
|
}
|
|
782
959
|
]
|
|
783
960
|
}
|