@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.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": "Build after upgrading — the compiler enumerates every collision, including the three shapes in `pitfall` below that a member-by-member diff does not show. 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 a member-by-member diff will not 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`; a member diff 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, including `controlState` on the nine bordered fields; this release's CHANGELOG block lists them by class.",
|
|
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=Recent%20Activity` becomes `?tab=recent-activity`: 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\". That wording is stale; this item describes the behaviour.",
|
|
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": "All fourteen field components — 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. 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: `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": [
|
|
@@ -519,7 +613,7 @@
|
|
|
519
613
|
"The measurement behind maxVisibleChips=\"fit\" reads the TRIGGER's width, never the chip row's own - a row cannot measure a box whose size the cut changes. Widths are cached per selection and a geometry guard skips re-measuring when neither width nor count moved, so a page of pickers measures once, not once per chip. [maxVisibleChips]=\"null\" opts out of measuring entirely.",
|
|
520
614
|
"ds-sidenav's brand row fixes, none of which need action: an astral first character (emoji, rarer CJK) no longer paints as tofu in the letter-mark; the mark is aria-hidden, so a screen reader reads the wordmark once instead of announcing the glyph then the name; and a logoLetter set WITHOUT a brand string now renders its tile at all, where an outer gate used to drop the whole lockup.",
|
|
521
615
|
"env(safe-area-inset-*) reads 0 unless YOUR index.html sets viewport-fit=cover in its viewport meta — a notched device alone is not enough, and this library cannot set it for you. ds-auth-layout pads by all four insets and ds-bottom-sheet by the bottom one, so both are plain-padded until you opt in; the docs site now sets it and both component pages state it. ds-bottom-sheet's env() also gained the `, 0px` fallback its siblings had: an unknown env() variable invalidates the entire declaration, which would have taken that sheet's horizontal padding with it.",
|
|
522
|
-
"The ds-select and ds-autocomplete panels now resolve --ds-dropdown-panel-radius, defaulting to the --ds-radius-panel role so nothing moves until you set it. TWO panels, not three: ds-multi-select's panel hardcodes border-radius: var(--radius-md) on its own .panel element, which is not the .dropdown-panel the shared rule targets, so neither this token nor --ds-radius-panel reaches it - it stays at 8px whatever you set, and that is a gap rather than a decision.
|
|
616
|
+
"The ds-select and ds-autocomplete panels now resolve --ds-dropdown-panel-radius, defaulting to the --ds-radius-panel role so nothing moves until you set it. TWO panels, not three: ds-multi-select's panel hardcodes border-radius: var(--radius-md) on its own .panel element, which is not the .dropdown-panel the shared rule targets, so neither this token nor --ds-radius-panel reaches it - it stays at 8px whatever you set, and that is a gap rather than a decision. Deliberately panel-level rather than per-component: retuning ONE picker is not a thing the library encourages, and --ds-radius-panel moves modal, popover and date-picker with it. Scope it with a selector - ds-select { --ds-dropdown-panel-radius: 8px } - and only that panel moves, since the token is forwarded onto the portaled pane.",
|
|
523
617
|
"A single-select ds-autocomplete no longer keeps the text typed to filter. Since 0.9.0 that text was also INVISIBLE - the filter input collapses to zero width once a chosen label is on show - while it still narrowed the list, so reopening a settled picker offered one option of four with nothing on screen to explain it. Cleared now whenever the panel closes over a displayed label, which covers both picking and dismissing after typing over a settled value. Multi-select is unchanged on purpose: its input never collapses, so the text stays visible and useful for the next pick. No action - query was component-private and could not be reset from an app.",
|
|
524
618
|
"The global .link class now resets a <button>: appearance, padding, border, background, font-family, font-size, line-height and text-align. It was written for anchors and touched none of them, yet ds-button warns variant=\"text\" off in favour of .link and an action that is not navigation has to be a button - so a button.link rendered at 13.3px inside 14px text with 1px 6px of padding and an outset border. font-weight is untouched so .quiet/.standalone still decide it, and display stays inline-block. Scoped with :where(), so the reset sits at .link specificity and a consumer rule still wins on source order.",
|
|
525
619
|
"ds-stat gained --ds-stat-value-white-space and --ds-stat-value-font-size, both defaulting to what the tile already rendered (nowrap, and h2/h4/h1 by size), so no existing tile moves. They exist because a value that is a PHRASE - a date range, a status - spilled straight past the tile edge under the nowrap that suits a number - the card sets no overflow, so it is not clipped, it escapes. The size hook now applies at every size input: the sm and lg variants move this token instead of restating font-size on .value, where they out-ranked any override and made such a hook work at md only.",
|
|
@@ -535,26 +629,26 @@
|
|
|
535
629
|
"ds-multi-select and ds-autocomplete render an option's `icon` before its label at 16px, which previously only ds-select did. The three option types now extend one exported DsOption<T> - they were three near-identical interfaces, which is why the icon field existed on one picker for a release - and each keeps its own exported name, so no import changes. Nothing to do: options without an icon render as before. Only ds-select repeats the icon in its TRIGGER, because its trigger is a button showing one label; the autocomplete trigger is a text input whose leading slot belongs to [dsAutocompletePrefix], and multi-select chips stay text-only so the label keeps the width.",
|
|
536
630
|
"provideDsConfig gained five sections, so an app can state a whole-app opinion once instead of on every element: control.size (button, icon-button, input, textarea, select, autocomplete, search, date/time picker, number stepper, checkbox, radio, switch, field-group), card.elevation, card.padding, table.stickyScrollbar, table.bordered, icon.size and badge.withDot. Precedence is input -> config -> built-in, and NO built-in default moved: an app that provides nothing renders exactly as it did.",
|
|
537
631
|
"DS_CONFIG.control.size is NOT the same axis as [data-density]. The density tier rewrites hit targets and padding in CSS for a route subtree; control.size picks which of the three declared sizes (sm/md/lg) a control renders at. An app can set both, and they compose.",
|
|
538
|
-
"
|
|
632
|
+
"Worth checking on your own side: a [size]=\"16\" binding on ds-icon restates the default, so it is a dead binding rather than a gap.",
|
|
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
|
|
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. (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.",
|
|
547
|
-
"components.md — the API digest
|
|
641
|
+
"components.md — the API digest this package carries for a consumer's agents — was two renames behind: 46 of the 92 --ds-* tokens it named no longer existed (the bg->bg-color and fg->text/label/icon-color renames, plus --ds-pagehdr-* -> --ds-page-header-*), ds-button was documented with its pre-2026-06 single `variant` axis rather than color x variant, and the topbar section described a --ds-topbar-margin-b that has never existed in the shipped component. All names now verified against the shipped components. If your agents or your notes were built from an older copy of this file, re-read it after the bump: token names you may have copied from it are dead.",
|
|
548
642
|
"Focus indicators are now universal: a single base rule, :where(:focus-visible) { outline: none; box-shadow: var(--ds-control-focus-shadow) }, gives the DS ring to anything focusable that does not style focus itself — the close buttons in ds-alert / ds-banner / ds-drawer, links in projected content, and an app's own bare <button>. Before this they fell through to the browser default (a black outline: auto in Chrome). Zero specificity via :where(), so every component rule and every app rule still wins, and the data-focus switch (ring / field / edge / outline) behaves exactly as before. ACTION only if you relied on an element having NO focus indicator: set box-shadow: none on it explicitly.",
|
|
549
|
-
"AutocompleteOption now extends the shared DsOption shape, so it gains `disabled?: boolean`, which it never had before — and ds-autocomplete acts on it: the row carries the .is-disabled class and aria-disabled, ignores the click, and the arrow keys skip it (as does the initial active row when the panel opens or the filter re-runs). Behaviourally this matches ds-select and ds-multi-select, which already honoured the flag. The row greys out as well
|
|
643
|
+
"AutocompleteOption now extends the shared DsOption shape, so it gains `disabled?: boolean`, which it never had before — and ds-autocomplete acts on it: the row carries the .is-disabled class and aria-disabled, ignores the click, and the arrow keys skip it (as does the initial active row when the panel opens or the filter re-runs). Behaviourally this matches ds-select and ds-multi-select, which already honoured the flag. The row greys out as well.",
|
|
550
644
|
"TableColumn.width now accepts the literal 'content' in addition to a pixel number: the column sizes to its widest cell and stops wrapping, leaving the remaining width to the other columns. Purely additive — a numeric width and an unset width behave exactly as before.",
|
|
551
|
-
"maxVisibleChips as a NUMBER is now a ceiling rather than an exact count on ds-autocomplete and ds-multi-select: at most N chips, and fewer when the trigger is too narrow to hold them beside the '+N more' marker and whatever follows (the text input, the chevron).
|
|
645
|
+
"maxVisibleChips as a NUMBER is now a ceiling rather than an exact count on ds-autocomplete and ds-multi-select: at most N chips, and fewer when the trigger is too narrow to hold them beside the '+N more' marker and whatever follows (the text input, the chevron). On a narrow trigger, [maxVisibleChips]=\"2\" showed two chips, ran out of width and wrapped the text input onto a second line — the growth the cap exists to prevent. Nothing to change on adoption; a wide trigger still shows exactly N. null is untouched and remains the only mode that does not measure. If you relied on a numeric cap to guarantee a fixed chip COUNT regardless of width, that guarantee is gone by design — the trigger's height is the thing being guaranteed instead.",
|
|
552
646
|
"ds-field-group segments now centre their value vertically. Every segment except ds-button pinned its value to the top of the row: the group stretches the segment, but the host is a block, so the height: 100% each control set on its bordered box resolved against `auto` and the box kept its own content height (a 19.6px line box inside a 40px row at md). Nothing to change on adoption. ACTION only if you had a ::ng-deep override compensating for it -- e.g. ds-field-group ds-input .control { align-items: center } or a padding-top nudge -- which is now double-applied; delete it.",
|
|
553
|
-
"An `error` string now marks the field invalid on its own, across all 14 field components
|
|
647
|
+
"An `error` string now marks the field invalid on its own, across all 14 field components (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).",
|
|
557
|
-
"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
|
|
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)",
|
|
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, and 0.6.1 / 0.6.2 / 0.9.1 were written for the first time. Every released version now ships a manifest, so an upgrade tool no longer falls back to re-deriving a plan from changelog prose on those three. 0.6.2 carries an actionable change that no machine-readable file had stated: 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.",
|
|
560
654
|
"runExport() without an exportFetcher falls through to exportCsv() synchronously and never touches exporting/exportStatus - so an external Export button bound to [loading]=\"table.exporting()\" shows no progress in that configuration. Bind exportFetcher if you want the in-flight state.",
|
|
@@ -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."
|
|
@@ -684,7 +778,7 @@
|
|
|
684
778
|
".modal > .header",
|
|
685
779
|
"!important"
|
|
686
780
|
],
|
|
687
|
-
"why": "`[dividers]=\"false\"` repeated on every modal
|
|
781
|
+
"why": "`[dividers]=\"false\"` repeated on every modal, or a reach into `.modal > .header` / `.body` / `.actions` with `!important` because hiding the rules left the padding stacked.",
|
|
688
782
|
"replaceWith": "`provideDsConfig({ modal: { dividers: false } })`, which drops the rules AND the padding that existed to clear them"
|
|
689
783
|
},
|
|
690
784
|
{
|
|
@@ -728,7 +822,7 @@
|
|
|
728
822
|
"[stickyScrollbar]=\"true\"",
|
|
729
823
|
"size=\"sm\""
|
|
730
824
|
],
|
|
731
|
-
"why": "An attribute repeated identically on every element -
|
|
825
|
+
"why": "An attribute repeated identically on every element - `[stickyScrollbar]=\"true\"` on every table, `size=\"sm\"` on every button.",
|
|
732
826
|
"replaceWith": "`provideDsConfig` with the matching section (`table`, `control.size`, …)"
|
|
733
827
|
},
|
|
734
828
|
{
|
|
@@ -748,7 +842,7 @@
|
|
|
748
842
|
"'skeleton'",
|
|
749
843
|
"'overlay'"
|
|
750
844
|
],
|
|
751
|
-
"why": "The computed beside every list table - `items().length > 0 ? 'overlay' : 'skeleton'
|
|
845
|
+
"why": "The computed beside every list table - `items().length > 0 ? 'overlay' : 'skeleton'`.",
|
|
752
846
|
"replaceWith": "`[loading]=\"true\"`, which resolves the treatment itself; pin a value only where you mean to override the rule"
|
|
753
847
|
},
|
|
754
848
|
{
|
|
@@ -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
|
}
|