@ids-group-ltd/ids-design-system 0.10.3 → 0.11.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/CHANGELOG.md +1376 -904
  2. package/components.md +61 -30
  3. package/design-system.md +18 -18
  4. package/fesm2022/ids-group-ltd-ids-design-system.mjs +992 -486
  5. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  6. package/migrations/0.1.0.json +2 -1
  7. package/migrations/0.10.0.json +219 -42
  8. package/migrations/0.10.1.json +50 -13
  9. package/migrations/0.10.2.json +90 -24
  10. package/migrations/0.10.3.json +22 -5
  11. package/migrations/0.11.0.json +216 -0
  12. package/migrations/0.11.1.json +305 -0
  13. package/migrations/0.2.0.json +22 -9
  14. package/migrations/0.2.1.json +2 -1
  15. package/migrations/0.2.2.json +3 -2
  16. package/migrations/0.3.0.json +16 -10
  17. package/migrations/0.4.0.json +38 -14
  18. package/migrations/0.5.0.json +49 -25
  19. package/migrations/0.5.1/badge-statuses.md +1 -3
  20. package/migrations/0.5.1.json +75 -33
  21. package/migrations/0.6.0.json +6 -2
  22. package/migrations/0.6.1.json +19 -1
  23. package/migrations/0.6.2.json +3 -1
  24. package/migrations/0.6.3.json +13 -4
  25. package/migrations/0.7.0.json +45 -26
  26. package/migrations/0.7.1.json +58 -20
  27. package/migrations/0.8.0.json +53 -15
  28. package/migrations/0.9.0.json +147 -27
  29. package/migrations/0.9.1.json +4 -3
  30. package/migrations/README.md +34 -52
  31. package/package.json +2 -1
  32. package/styles/_dropdown-overlay.scss +35 -13
  33. package/styles/_ds-color.scss +3 -3
  34. package/styles/_field-box.scss +2 -6
  35. package/styles/_field-label.scss +5 -10
  36. package/styles/_field-state.scss +3 -2
  37. package/styles/_focus.scss +0 -2
  38. package/styles/_layout-utils.scss +2 -2
  39. package/styles/_link.scss +1 -2
  40. package/styles/_overlay-motion.scss +2 -4
  41. package/styles/_press.scss +3 -5
  42. package/styles/_reset.scss +0 -1
  43. package/styles/_scrollbar.scss +1 -3
  44. package/styles/_status.scss +1 -2
  45. package/styles/_surface-motion.scss +3 -4
  46. package/styles/_text-clip.scss +1 -1
  47. package/styles/_theme-activation.scss +1 -1
  48. package/styles/_tokens-charts.scss +1 -3
  49. package/styles/_tokens.scss +4 -3
  50. package/styles/_typography.scss +2 -2
  51. package/themes/README.md +3 -3
  52. package/themes/_base-palette.scss +2 -2
  53. package/themes/_semantic.scss +2 -2
  54. package/themes/dark/_palette.scss +1 -2
  55. package/themes/light/_palette.scss +1 -1
  56. package/themes/light/_theme.scss +1 -1
  57. package/types/ids-group-ltd-ids-design-system.d.ts +403 -108
  58. package/migrations/AUTHORING.md +0 -273
@@ -6,7 +6,9 @@
6
6
  "kind": "removed-api",
7
7
  "old": "ds-table[clientSort]",
8
8
  "new": "sortMode",
9
- "note": "`ds-table`'s boolean `clientSort` is REMOVED and replaced by `sortMode: 'client' | 'server' | 'none'`. The boolean could not express \"nothing sorts\", so a column marked `sortable: true` on a table with no sorting drew a header that looked live, showed a caret on hover and did nothing — mm-broker shipped several detail tables that way and only caught it in a browser walkthrough. ACTION, mechanical: `[clientSort]=\"true\"` becomes `sortMode=\"client\"`; a bare `clientSort` attribute becomes `sortMode=\"client\"`; `[clientSort]=\"false\"` or `[clientSort]=\"expr\"` becomes `[sortMode]=\"expr ? 'client' : 'server'\"`. A table that had NO clientSort binding and reorders in its own `(sortChange)` handler must now say `sortMode=\"server\"` — this is the one case that is not a find/replace, because the DEFAULT CHANGED: unset now resolves to `'client'`, so a table that previously only emitted `sortChange` will ALSO sort its own rows unless it declares `'server'`. That default flip is deliberate — it makes `sortable: true` always do something — but for a SERVER-PAGED table (one that binds `total`) client sorting reorders the current page only, so the rows look sorted and are not; dev builds warn about exactly that combination. Tables that render a sortable column but sort nowhere should declare `sortMode=\"none\"`, which now drops the button, the caret and `aria-sort` instead of leaving a dead control. NOTE for TypeScript callers: the union is exported as `TableSortMode`, so a field, computed or method that supplies the mode to `[sortMode]` can be typed with `import type { TableSortMode } from '@ids-group-ltd/ids-design-system';` rather than repeating the literals.",
9
+ "action": "`[clientSort]=\"true\"` and a bare `clientSort` become `sortMode=\"client\"`; `[clientSort]=\"false\"` or `[clientSort]=\"expr\"` becomes `[sortMode]=\"expr ? 'client' : 'server'\"`. A table that had NO clientSort binding and reorders in its own `(sortChange)` handler must declare `sortMode=\"server\"`. A table that renders a sortable column but sorts nowhere declares `sortMode=\"none\"`, which drops the button, the caret and `aria-sort` instead of leaving a dead control. TypeScript callers can type the value with `import type { TableSortMode }`.",
10
+ "pitfall": "The last case is the one that is not a find/replace, because the DEFAULT CHANGED: unset resolves to `client` at this version. A server-paged table that only emitted `sortChange` will now ALSO sort its own rows — and client sorting reorders the current page only, so the rows look sorted and are not. Dev builds warn on `total` plus client, but a production build says nothing.",
11
+ "note": "The boolean could not express \"nothing sorts\", so a column marked `sortable: true` on a table with no sorting drew a header that looked live, showed a caret on hover and did nothing.",
10
12
  "searchHints": [
11
13
  "clientSort",
12
14
  "[clientSort]",
@@ -17,7 +19,7 @@
17
19
  "ds-table"
18
20
  ],
19
21
  "surface": "template",
20
- "verify": "Every `<ds-table>` that binds `total` either declares sortMode=\"server\" or leaves it unset (both resolve to server), and every table that holds all its rows AND has a sortable column declares sortMode=\"client\".",
22
+ "verify": "No `clientSort` is left anywhere. Every server-paged `<ds-table>` - one that binds `total` and reorders in its own (sortChange) - declares sortMode=\"server\" EXPLICITLY: at this version an unset sortMode resolves to \"client\", so leaving it off makes the table re-sort the page it is showing and the rows look sorted while the server order is unchanged. A table holding all its rows declares sortMode=\"client\" or leaves it unset; a table that sorts nothing declares sortMode=\"none\". Dev builds warn on total + client.",
21
23
  "restore": "sortMode=\"server\" on a table that should only emit (sortChange) and sort nothing itself"
22
24
  },
23
25
  {
@@ -25,7 +27,10 @@
25
27
  "kind": "behavior",
26
28
  "old": "extends InputComponent",
27
29
  "new": null,
28
- "note": "This release's single class-member-collision entry: it covers EVERY exported class whose member surface changed, so a consumer who EXTENDS a DS component can resolve them in one pass. Subclassing a DS component is unsupported (design-system.md § Components), but where it happens the names collide: TS4114 demands `override`, TS2415 fires on a redeclared private member, TS2416 on a differing signature. (1) The 14 message-bearing FIELD classes (Input, Textarea, Select, DatePicker, TimePicker, Autocomplete, Checkbox, Switch, RadioGroup, Radio, OtpInput, Slider, ColorPicker, MultiSelect) REMOVED the protected `messageState` computed, and DatePickerComponent also removed `messageText`; all 14 ADDED the `error`, `warning`, `errors` and `touched` inputs plus protected `message` and `invalidResolved`, with DatePickerComponent also gaining private `localError` and `dateInvalid`. (2) Both CVA base classes (`DsControlValueAccessor`, `DsBooleanControlValueAccessor`) gained a protected `touchedSelf`. (3) `AppLayoutComponent` gained public `railOverlay` and `railId`. (4) `TableComponent` REMOVED the `clientSort` input and gained `sortModeResolved`, `sortableCol()`, `exporting`, `runExport()`, `virtualizing`, `virtualRowHeight`, `virtualWindow`, `windowData` and `isStriped()`, plus the `persistLayout`, `storageKey`, `exportButton`, `exportFilename`, `exportFetcher`, `virtualScroll` and `virtualRowSize` inputs, and the PRIVATE methods `saveLayout()` and `restoreLayout()` - a private collides too (TS2415), and `saveLayout` is the one that actually bit a consumer whose own table declared the same name. (5) `ButtonComponent` gained `ariaControls`; `IconButtonComponent` gained `ariaExpanded` and `ariaControls`. (6) `CheckboxComponent`, `SwitchComponent` and `RadioComponent` REMOVED the protected `devMode`. (7) `LayoutScrollService` gained `scroller`, `scrollTo()`, `configureRestore()`, `consumePendingOffset()` and `contentReady()`. (8) The `close()` method on SelectComponent, AutocompleteComponent, MultiSelectComponent, DatePickerComponent, TimePickerComponent, ColorPickerComponent and PopoverComponent gained an optional `cause` parameter, as did TimePickerComponent's `onEscape()` — an override declared as `close()` still satisfies the base, so this one only bites a subclass that re-declares the parameter list differently. ACTION: rename the subclass's own member, or add `override` where the base's semantics genuinely match; a subclass that overrode `messageState` should move its logic to an `error` / `warning` binding on the element instead, since the message is now resolved centrally. Consumers who only use the <ds-...> elements in templates need no change.",
30
+ "action": "Build after upgrading — the compiler enumerates every collision. Per member: rename your own, or add `override` where the base semantics genuinely match. A subclass that overrode `messageState` should move its logic to an `error` or `warning` binding on the element instead, since the message is resolved centrally now.",
31
+ "appliesWhen": "Only a consumer that EXTENDS a DS component class. Subclassing is unsupported (design-system.md § Components); template users of the `<ds-…>` elements need nothing.",
32
+ "pitfall": "A PRIVATE member collides too — TS2415 — and `TableComponent.saveLayout()` is the likeliest to collide, because a table wrapper commonly declares the same name. Two more shapes hide here: this release REMOVES members as well as adding them (the fourteen fields dropped protected `messageState`, DatePicker also `messageText`, and Checkbox, Switch and Radio dropped protected `devMode`), so an `override` can start naming nothing; and `close()` gained an optional `cause`, which an override declared as `close()` still satisfies — only a subclass that re-declares the parameter list differently breaks.",
33
+ "note": "Additions: the fourteen field classes gained the `error`, `warning`, `errors` and `touched` inputs plus protected `message` and `invalidResolved`; both CVA bases gained protected `touchedSelf`; AppLayoutComponent gained `railOverlay` and `railId`; TableComponent lost `clientSort` and gained `sortModeResolved`, `sortableCol()`, `exporting`, `runExport()`, `virtualizing`, `virtualRowHeight`, `virtualWindow`, `windowData`, `isStriped()`, the `persistLayout`, `storageKey`, `exportButton`, `exportFilename`, `exportFetcher`, `virtualScroll` and `virtualRowSize` inputs and the private `saveLayout()` / `restoreLayout()`; ButtonComponent gained `ariaControls`; IconButtonComponent `ariaExpanded` and `ariaControls`; LayoutScrollService `scroller`, `scrollTo()`, `configureRestore()`, `consumePendingOffset()` and `contentReady()`.",
29
34
  "searchHints": [
30
35
  "extends InputComponent",
31
36
  "extends SelectComponent",
@@ -57,7 +62,10 @@
57
62
  "kind": "class-rename",
58
63
  "old": "ds-select .select-label",
59
64
  "new": ".label",
60
- "note": "STYLING ONLY, and only for a consumer who styles ds-select's internal DOM. The label element is now `.label`, the same class every other field in the family uses, so a rule written as `.select-label` (or the doubled `.select-label.select-label` needed to out-rank the shimmed component rule) silently matches nothing after the upgrade. Retarget to `.label`, scoped to the element: `ds-select .label { … }`. In most cases the rule can be DELETED instead — it existed to make the select's label match the input's, and they now match by default. Scope strictly to selectors under ds-select; `.label` is also the class ds-input, ds-textarea, ds-date-picker, ds-time-picker and ds-radio-group use.",
65
+ "action": "Retarget `.select-label` to `.label`, scoped to the element: `ds-select .label { … }`.",
66
+ "appliesWhen": "Only a consumer who styles ds-select internal DOM. In most cases the rule can simply be DELETED — it existed to make the select label match the input, and they match by default now.",
67
+ "pitfall": "`.label` is also the class ds-input, ds-textarea, ds-date-picker, ds-time-picker and ds-radio-group use, so an unscoped retarget spreads the rule across the whole field family. Scope every selector under `ds-select`.",
68
+ "note": "The label element uses the same class as the rest of the family now, so `.select-label` — and the doubled `.select-label.select-label` written to out-rank the shimmed component rule — silently match nothing.",
61
69
  "searchHints": [
62
70
  "select-label",
63
71
  ".select-label",
@@ -72,7 +80,10 @@
72
80
  "kind": "class-rename",
73
81
  "old": "ds-radio-group .group-label",
74
82
  "new": ".label",
75
- "note": "TWO changes to the same element. (1) CLASS: `ds-radio-group`'s label is now `.label`, so consumer CSS targeting `.group-label` under ds-radio-group stops matching — retarget or delete. Note `.group-label` is ALSO the class `ds-sidenav-group` uses for its heading, which is unchanged; only rules scoped under ds-radio-group are affected. (2) VISIBLE: the label now draws the family's type - `--font-weight-bold` at `--font-size-xs` - instead of its own `--font-weight-medium` at `--font-size-s` on `--line-height-flat`. It was the only field label drawing its own, and in a form beside an input or select it read as a different kind of element. ACTION: none for most screens, since matching the family is the point. To keep the old look, scope the family tokens: `ds-radio-group { --ds-field-label-weight: var(--font-weight-medium); --ds-field-label-font-size: var(--font-size-s); }`.",
83
+ "action": "Retarget `.group-label` to `.label` under ds-radio-group, or delete the rule. To keep the old look, scope the family tokens: `ds-radio-group { --ds-field-label-weight: var(--font-weight-medium); --ds-field-label-font-size: var(--font-size-s); }`.",
84
+ "appliesWhen": "None of this is needed for most screens — matching the family is the point of the change.",
85
+ "pitfall": "`.group-label` is ALSO the class `ds-sidenav-group` uses for its heading, and that one is unchanged. A repo-wide rename takes the sidenav heading with it. Only rules scoped under ds-radio-group are affected.",
86
+ "note": "Two changes to one element: the class, and the type — the label draws `--font-weight-bold` at `--font-size-xs` now instead of its own medium weight at `--font-size-s`. It was the only field label drawing its own, and beside an input it read as a different kind of element.",
76
87
  "searchHints": [
77
88
  "group-label",
78
89
  ".group-label",
@@ -88,7 +99,9 @@
88
99
  "kind": "behavior",
89
100
  "old": "ng add @ids-group-ltd/ids-design-system",
90
101
  "new": null,
91
- "note": "`ng add` never actually ran its schematic in any released version, so the DS global styles were NEVER wired automatically - every consumer either did it by hand or shipped without them. The package is `\"type\": \"module\"` while the compiled schematic was CommonJS, so Node refused to load it: \"exports is not defined in ES module scope\". The build wrote a nested schematics/package.json with {\"type\":\"commonjs\"} to fix exactly that, and `npm pack` silently DROPPED it - npm treats a directory holding a package.json as a separate package root - so the marker existed in dist/ and was absent from the tarball. The schematic is now `.cts` compiled to `.cjs`, which survives packing. ACTION: consumers who added `@use '@ids-group-ltd/ids-design-system/styles/ds';` to their global stylesheet by hand need do nothing - ng add prepends the same line and skips when it is already present. Consumers who never wired the styles (and whose components therefore render unthemed) can now run `ng add` and have it work, or add that one line themselves.",
102
+ "action": "Nothing, if you already added `@use '@ids-group-ltd/ids-design-system/styles/ds';` to your global stylesheet by hand — `ng add` prepends the same line and skips when it is present. If you never wired the styles, run `ng add` now or add that one line yourself.",
103
+ "appliesWhen": "Relevant to anyone whose components render unthemed, which is the symptom of the styles never having been wired.",
104
+ "note": "`ng add` never ran its schematic in any released version: the package is `\"type\": \"module\"` while the compiled schematic was CommonJS, and the nested `{\"type\":\"commonjs\"}` marker that fixed it in `dist/` was dropped by `npm pack`, which treats a directory holding a package.json as a separate root. The schematic is `.cts` compiled to `.cjs` now, which survives packing.",
92
105
  "searchHints": [
93
106
  "ng add",
94
107
  "ng-add",
@@ -108,7 +121,9 @@
108
121
  "kind": "behavior",
109
122
  "old": "ds-menu",
110
123
  "new": null,
111
- "note": "DEFAULT CHANGED, visual: a `ds-menu` row's hover/active fill was `var(--radius-md)` (8px) and is now SQUARE — the new `--ds-menu-item-radius` token defaults to `0`. In the same change `ds-menu` dropped its own `padding: var(--space-1)` to `padding: 0` and gained `overflow: hidden`, so rows now run edge to edge and the panel's own corner clips the first and last row. The reason: a curve at zero inset can never be concentric with the panel's, and inside a `ds-popover` (which drops its padding for a menu) the row's 8px sat against the popover's 12px corner and left visible slivers at the top and bottom of the list. ACTION: none for consumers happy with the new look. To restore the old rounded highlight set `ds-menu { --ds-menu-item-radius: var(--radius-md); }`; to also restore the old 4px inset around the rows add your own `ds-menu { padding: var(--space-1); }`, because the panel padding has NO token. Setting a radius without restoring some padding is the one combination to avoid — the corners have nothing to curve away from.",
124
+ "action": "None if the new look is fine. To restore the rounded highlight: `ds-menu { --ds-menu-item-radius: var(--radius-md); padding: var(--space-1); }` — both declarations.",
125
+ "pitfall": "Setting the radius WITHOUT restoring some padding is the one combination to avoid: the rows run edge to edge now, so a corner at zero inset has nothing to curve away from. The panel padding has no token, which is why the restore names a raw `padding`.",
126
+ "note": "The row fill was `--radius-md` and is square now through the new `--ds-menu-item-radius`, defaulting to 0; ds-menu also dropped its own padding to 0 and gained `overflow: hidden`. A curve at zero inset can never be concentric with the panel, and inside a ds-popover the row's 8px sat against the popover's 12px corner and left visible slivers.",
112
127
  "searchHints": [
113
128
  "ds-menu",
114
129
  "ds-menu-item",
@@ -125,7 +140,9 @@
125
140
  "kind": "behavior",
126
141
  "old": "ds-menu-divider",
127
142
  "new": null,
128
- "note": "DEFAULT CHANGED, visual: `ds-menu-divider` carried `padding: var(--space-1) 0` (4px above and below) on top of the `gap: var(--space-0-5)` (2px) that `ds-menu` already puts between rows, so a separated group read as a hole — 6px + line + 6px where adjacent items sat 2px apart. The divider's padding now defaults to `0` through the new `--ds-menu-divider-spacing` token, so the line takes one row's place instead of adding a second gap. Menu items keep their own 8px/12px padding, so the line still separates without help. ACTION: none unless you want the old airier boundary back, in which case set `ds-menu { --ds-menu-divider-spacing: var(--space-1); }`. Affects only menus that actually use `ds-menu-divider`.",
143
+ "action": "None unless you want the airier boundary back: `ds-menu { --ds-menu-divider-spacing: var(--space-1); }`.",
144
+ "appliesWhen": "Only menus that actually use `ds-menu-divider`.",
145
+ "note": "The divider carried 4px above and below on top of the 2px gap ds-menu already puts between rows, so a separated group read as a hole. Its padding defaults to 0 now, so the line takes one row's place; menu items keep their own padding, so it still separates.",
129
146
  "searchHints": [
130
147
  "ds-menu-divider",
131
148
  "--ds-menu-divider-spacing",
@@ -141,7 +158,9 @@
141
158
  "kind": "behavior",
142
159
  "old": "ds-time-picker",
143
160
  "new": null,
144
- "note": "DEFAULT CHANGED, visual: the `ds-time-picker` dropdown panel's corner radius was `var(--radius-md)` (8px) and is now `var(--ds-radius-panel)` (`--radius-lg`, 12px). It was the one floating panel in the library still drawing the CONTROL radius — its own sibling `ds-date-picker` has always drawn the panel role, so the two pickers rendered different corners side by side in the same form. The radius was also the only property on that element with no public hook (fill, border and shadow all had one). ACTION: none unless you want the old 8px corner back, in which case set `ds-time-picker { --ds-time-picker-panel-radius: var(--radius-md); }` — the new hook is forwarded onto the portaled overlay pane, so a per-instance override on the element does reach the panel. Affects only the open dropdown; the trigger's radius is unchanged and still resolves through `--ds-time-picker-trigger-radius`.",
161
+ "action": "None unless you want the old 8px corner: `ds-time-picker { --ds-time-picker-panel-radius: var(--radius-md); }`. The hook is forwarded onto the portaled overlay pane, so a per-instance override does reach the panel.",
162
+ "appliesWhen": "The open dropdown only. The trigger radius is unchanged and still resolves through `--ds-time-picker-trigger-radius`.",
163
+ "note": "The panel drew the CONTROL radius (8px) and draws the panel role now (12px). It was the last floating panel in the library still doing so, and it rendered different corners beside its own sibling ds-date-picker in the same form.",
145
164
  "searchHints": [
146
165
  "ds-time-picker",
147
166
  "--ds-time-picker-panel-radius",
@@ -158,7 +177,10 @@
158
177
  "kind": "code-add",
159
178
  "old": "@use '@ids-group-ltd/ids-design-system/styles",
160
179
  "new": "@use '@ids-group-ltd/ids-design-system/styles/focus';",
161
- "note": "ONLY for a consumer who cherry-picks DS style partials individually instead of importing the bundled `styles/ds` entry. The `data-focus` focus-style switch AND the `@media (forced-colors: active)` fallback both live in the new `styles/_focus.scss` partial. A consumer of the bundled entry gets both automatically and must do NOTHING — the partial is `@forward`ed from `styles/ds`. A consumer who @uses partials à la carte gets NEITHER until they add this line to the same global stylesheet: without it, the `data-focus` attribute silently does nothing, and — the part that matters for accessibility — focused elements have NO visible indicator at all in Windows High Contrast / forced-colors mode, because forced-colors drops box-shadow and the shadow-only indicator was all they had. Site: the global stylesheet that already @uses the other DS partials. Do NOT add it alongside a `styles/ds` import; that entry already includes it.",
180
+ "action": "Add `@use '@ids-group-ltd/ids-design-system/styles/focus';` to the same global stylesheet that already `@use`s the other DS partials.",
181
+ "appliesWhen": "ONLY a consumer who cherry-picks partials. Do NOT add it beside a `styles/ds` import — that entry forwards it already, and its users must do nothing.",
182
+ "pitfall": "Missing it costs accessibility, silently. The `data-focus` switch simply does nothing, and — the part that matters — focused elements have NO visible indicator at all in Windows High Contrast and other forced-colors modes, because forced-colors drops box-shadow and the shadow-only indicator was all they had.",
183
+ "note": "The `data-focus` switch and the `@media (forced-colors: active)` fallback both live in the new `styles/_focus.scss`.",
162
184
  "searchHints": [
163
185
  "@use '@ids-group-ltd/ids-design-system/styles",
164
186
  "styles/ds",
@@ -174,7 +196,9 @@
174
196
  "kind": "removed-api",
175
197
  "old": "--combobox-offset / --combobox-maxh",
176
198
  "new": "--picker-offset / --picker-maxh",
177
- "note": "The two global tokens sizing the listbox panel shared by ds-autocomplete and ds-multi-select kept the name of a component that no longer exists - ds-combobox was renamed to ds-autocomplete on 2026-07-07. ACTION, only if you overrode them: rename --combobox-offset to --picker-offset and --combobox-maxh to --picker-maxh. These are global scale tokens, not --ds-* component tokens, so nothing else changes and the values are unchanged.",
199
+ "action": "Rename `--combobox-offset` to `--picker-offset` and `--combobox-maxh` to `--picker-maxh`.",
200
+ "appliesWhen": "Only if you overrode them. These are global scale tokens, not `--ds-*` component tokens, and the values are unchanged.",
201
+ "note": "The two tokens sizing the listbox panel shared by ds-autocomplete and ds-multi-select still carried the name of a component that no longer exists.",
178
202
  "searchHints": [
179
203
  "--combobox-offset",
180
204
  "--combobox-maxh",
@@ -206,12 +230,26 @@
206
230
  "ds-table gained [persistLayout] + storageKey (round-tripping columnOrder, columnWidths and hiddenKeys through localStorage) and [exportButton] + exportFilename + exportFetcher. All opt-in and off by default, so NO ACTION. A consumer who wrote their own localStorage effect for the three column models, or their own export button, can delete both - together with the sortValue accessor these were the last three reasons to keep a wrapper around ds-table. exportCsv() is unchanged for existing callers and now accepts an optional row set as its second argument.",
207
231
  "New component ds-password-rules: the live requirement checklist under a new-password field. Purely additive, NO ACTION. A consumer with a hand-rolled password checklist can replace it - pass the rule set as { label, test } pairs (the policy stays yours, it has to mirror your server), bind [value] to the field and [showUnmet] to whether the user has tried to submit. Exposes metCount and allMet for gating a submit button, and the standalone passwordRulesMet(value, rules) function — the same predicate that backs allMet — for gating one without rendering the list. Also exported: the DsPasswordRule ({ label, test }) and DsPasswordRuleState ('pending' | 'met' | 'failed') types for typing the rule set, plus a listId input that names the <ul> so a field's aria-describedby can point at the checklist.",
208
232
  "ds-input gained ariaDescribedBy, merged with the field's own message id rather than replacing it - for describing a field with a password-rule list or a policy note. Additive, NO ACTION. Note that setting aria-describedby on the <ds-input> element itself does NOT work: it lands on the wrapper, not the inner input.",
209
- "New component ds-auth-shell: the scaffold for the screens in front of the login (sign-in, forgot password, reset, MFA), counterpart to ds-app-layout. Purely additive, NO ACTION. A consumer with a hand-rolled auth scaffold can replace it: brand lockup + optional tagline + one card holding the form + a support line. The brand row is the ds-sidenav row - same brand / logoLetter / [dsBrandName] contract and the same letter-mark tile - so it is NOT the string-splitting brandAccent the ports used; project [dsBrandName] to tint a slice of the wordmark. Card body is the default slot, the support line goes in [dsAuthSupport] (a real <footer>, so it carries the contentinfo landmark). cardElevation / cardPadding pass through to ds-card. Tokens: --ds-auth-shell-min-height, -card-max-width, -gap, -bg-color, -mark-bg-color, -mark-label-color. WORTH KNOWING when porting: the shell owns the full-height box itself, so do NOT wrap it in your own 100vh/100dvh container - the ports that stacked two scrolled a page whose content fits. It also adds env(safe-area-inset-*) padding, and centres with auto margins rather than centre alignment so a form taller than the box stays reachable when the shell is embedded at min-height 100%.",
233
+ "New component ds-auth-shell: the scaffold for the screens in front of the login (sign-in, forgot password, reset, MFA), counterpart to ds-app-layout. Purely additive, NO ACTION. A consumer with a hand-rolled auth scaffold can replace it: brand lockup + optional tagline + one card holding the form + a support line. The brand row is the ds-sidenav row - same brand / logoLetter / [dsBrandName] contract and the same letter-mark tile - so it is NOT a string-splitting brandAccent; project [dsBrandName] to tint a slice of the wordmark. Card body is the default slot, the support line goes in [dsAuthSupport] (a real <footer>, so it carries the contentinfo landmark). cardElevation / cardPadding pass through to ds-card. Tokens: --ds-auth-shell-min-height, -card-max-width, -gap, -bg-color, -mark-bg-color, -mark-label-color. WORTH KNOWING when porting: the shell owns the full-height box itself, so do NOT wrap it in your own 100vh/100dvh container - nesting two of them scrolls a page whose content fits. It also adds env(safe-area-inset-*) padding, and centres with auto margins rather than centre alignment so a form taller than the box stays reachable when the shell is embedded at min-height 100%.",
210
234
  "New component ds-filter-bar: a Priority+ filter row - as many filters as fit inline, the rest behind a \"+N more\" panel. Purely additive, NO ACTION. A consumer with a hand-rolled filter row (or one that wraps to two lines on a laptop) can replace it. Each filter goes in an <ng-template [dsFilterItem]=\"180\"> carrying the width it should occupy; the bar decides the split from those numbers plus a ResizeObserver on the row. Trailing controls (search, Clear) carry the dsFilterBarTrailing attribute - mark each control, do NOT wrap them in a div: the bar owns that group's gap and alignment, and a projected wrapper is a plain block whose children stack. Tokens: --ds-filter-bar-gap, --ds-filter-bar-panel-gap. Inputs moreLabel and panelLabel exist for translation. WORTH KNOWING: the declared width is a contract, not a hint - the slot is sized to exactly that number, so declare what the control actually occupies. And because a filter that collapses is MOVED into the panel, its view is destroyed and re-created: internal state such as an open dropdown or focus does not survive that, while its value does (it lives in your signal or form control). Content that reaches the bar with neither slot marker is dropped, with a dev-mode console warning.",
211
- "ds-table gained virtual scrolling: [virtualScroll]=\"true\" plus virtualRowSize (px). Opt-in and off by default, so NO ACTION. Only the rows in view stay in the DOM (~25 regardless of row count), padded by two spacer rows so the scrollbar still spans the whole data set. REQUIRES maxHeight - a bounded scroller is the viewport it windows against, and without one nothing is virtualized (dev warning). CONSTRAINTS in virtual mode, all enforced rather than assumed: every row is exactly virtualRowSize tall (the CSS height comes from that same input), table-layout becomes fixed, and cells are kept to one line - so declare column widths, and do not rely on wrapping cell text there. Row EXPANSION is suppressed with a dev warning (an expanded row is taller than virtualRowSize and every offset below it would be wrong); pageSize alongside virtualScroll is also warned about, since virtual scrolling is what pagination was for. Sorting, filtering, selection, sticky header, sticky first column and column resizing all keep working. NOT built on the CDK virtual-scroll viewport on purpose: that wraps the table in a transformed content wrapper, and the transform breaks this table's sticky header and sticky first column. STILL OPEN: lazy loading (fetching slices from a server as they scroll into view) is NOT part of this - see the backlog item.",
212
- "FIXED in ds-table: with stickyHeader and stickyFirstColumn both on, the first body row painted OVER the header in the pinned columns, so the header read as that row's data. --table-sticky-corner-z was already there to keep the corner above the body, but the sticky-header rule out-specified it and both ended up at the same z-index, where DOM order puts the body on top. No action needed - it is a pure CSS fix. If you worked around it with your own z-index on DS table cells, that override can go.",
235
+ "ds-table gained virtual scrolling: [virtualScroll]=\"true\" plus virtualRowSize (px). Opt-in and off by default, so NO ACTION. Only the rows in view stay in the DOM (~25 regardless of row count), padded by two spacer rows so the scrollbar still spans the whole data set. REQUIRES maxHeight - a bounded scroller is the viewport it windows against, and without one nothing is virtualized (dev warning). CONSTRAINTS in virtual mode, all enforced rather than assumed: every row is exactly virtualRowSize tall (the CSS height comes from that same input), table-layout becomes fixed, and cells are kept to one line - so declare column widths, and do not rely on wrapping cell text there. Row EXPANSION is suppressed with a dev warning (an expanded row is taller than virtualRowSize and every offset below it would be wrong); pageSize alongside virtualScroll is also warned about, since virtual scrolling is what pagination was for. Sorting, filtering, selection, sticky header, sticky first column and column resizing all keep working. NOT built on the CDK virtual-scroll viewport on purpose: that wraps the table in a transformed content wrapper, and the transform breaks this table's sticky header and sticky first column. STILL OPEN: lazy loading (fetching slices from a server as they scroll into view) is NOT part of this.",
236
+ "FIXED in ds-table: with stickyHeader and stickyFirstColumn both on, the first body row painted OVER the header in the pinned columns, so the header read as that row's data. --table-sticky-corner-z was already there to keep the corner above the body, but the sticky-header rule out-specified it and both ended up at the same z-index, where DOM order puts the body on top. No action needed - it is a pure CSS fix. If you worked around it with your own z-index on DS table cells, that override can go. (delete list: table-sticky-corner-zindex-workaround)",
213
237
  "ds-checkbox / ds-switch / ds-radio now RENDER a projected caption instead of dropping it, and expose the caption's colour and size. Additive, NO ACTION - [label] stays the documented API and still wins when both are supplied. If you added a dev-warning workaround after 0.7.1 (moving markup-bearing captions into a string), you can move them back: <ds-checkbox>I accept the <a href=...>Terms</a></ds-checkbox> now works. ONE DIFFERENCE: the required asterisk comes with [label] only - a projected caption owns its own marker, since only your markup knows where it belongs. New hooks: --ds-checkbox-label-color / -label-font-size, the same pair on ds-switch, and --ds-radio-label-font-size (--ds-radio-label-color already shipped). The font-size hook beats the size class. These are deliberately NOT part of the --ds-field-label-* contract: a label above an input is a heading for the field and reads secondary, a caption beside a checkbox is the content being agreed to and reads primary. If you were overriding the caption colour with a descendant selector against .control-text, replace it with the token.",
214
238
  "Overlay panels now fade out when DISMISSED and still close instantly when something is CHOSEN. No action - behaviour only. Escape, a press outside, or the page scrolling away fades the panel over --ds-motion-exit-duration (120ms); picking an option, pressing the trigger again, or Tab still closes instantly, because a fade on a deliberate choice reads as the panel lagging behind it. Applies to select, autocomplete, multi-select, date-picker, time-picker, color-picker and popover. Tune with --ds-overlay-leave-duration / --ds-overlay-leave-easing, or set the duration to 0ms to get the old always-instant close everywhere. Reduced motion already zeroes it. A fading panel is pointer-events: none, so it cannot swallow a click aimed at what is behind it. If you built anything that assumed the overlay pane is removed from the DOM synchronously on Escape, note that it now lives for one exit duration longer (the component state - open(), overlayRef - is still cleared immediately).",
215
- "design-system.md now states the --ds-* token contract once instead of repeating it per component, and carries a warning that its hand-written API and token lists have drifted from the code (ds-button is documented with its pre-color/variant API and the pre-rename --ds-button-bg / -fg names). For the authoritative surface use the auto-generated Component API tables and token reference in ds-docs, which are extracted from source on every build. No action - documentation only."
239
+ "design-system.md now states the --ds-* token contract once instead of repeating it per component, and carries a warning that its hand-written API and token lists have drifted from the code (ds-button is documented with its pre-color/variant API and the pre-rename --ds-button-bg / -fg names). For the authoritative surface use the Component API tables and token reference on the documentation site, generated from the source of each release. No action - documentation only."
240
+ ],
241
+ "deleteList": [
242
+ {
243
+ "id": "table-sticky-corner-zindex-workaround",
244
+ "surface": "style",
245
+ "find": [
246
+ "ds-table",
247
+ "z-index",
248
+ "--table-sticky-corner-z",
249
+ "sticky"
250
+ ],
251
+ "why": "A consumer z-index on DS table cells, raised to stop the first body row painting over the header when stickyHeader and stickyFirstColumn were both on. The sticky-header rule out-specified --table-sticky-corner-z and both landed on the same z-index; that is fixed in the component.",
252
+ "replaceWith": "nothing - the component orders the layers itself"
253
+ }
216
254
  ]
217
255
  }
@@ -6,7 +6,10 @@
6
6
  "kind": "token-rename",
7
7
  "old": "modal-out / ds-sheet-down / ds-sheet-fade-out / drawer-panel-close-right|left|top|bottom / drawer-scrim-out",
8
8
  "new": "ds-fade-out / ds-scale-out / ds-slide-out / ds-slide-edge-out",
9
- "note": "REMOVED: seven exit @keyframes local to modal, drawer and bottom-sheet are gone, replaced by four GLOBAL presets mirroring the entrance vocabulary. ACTION: nothing, unless you referenced one of the old names - only possible from a global stylesheet, since they were view-encapsulated. If you did, the mapping is: modal-out, ds-sheet-fade-out and drawer-scrim-out -> ds-fade-out; ds-sheet-down and all four drawer-panel-close-* -> ds-slide-edge-out. WHY: teardown matched the animation NAME on animationend, so the exit could not be swapped without breaking close entirely; the guard now checks the event came from the animated element rather than a child, which frees the name. WHAT YOU GAIN: --ds-modal-leave-keyframes, --ds-drawer-leave-keyframes and --ds-bottom-sheet-leave-keyframes, the exit counterparts of the --ds-*-enter-keyframes you already have. Point one at your own GLOBAL @keyframes - a component-scoped name is renamed by Angular and will not resolve. An exit preset reads --_ds-exit-x/y/scale and falls back to the matching --_ds-enter-*, so a surface that leaves the way it arrived declares nothing. VERIFY AFTER UPGRADING: open and close a modal, a drawer and a bottom sheet and confirm the page scrolls again afterwards - a teardown that does not fire leaks the body-scroll lock, which is the failure this change could cause and the one we tested for.",
9
+ "action": "Only if you referenced an old name from a GLOBAL stylesheet: `modal-out`, `ds-sheet-fade-out` and `drawer-scrim-out` map to `ds-fade-out`; `ds-sheet-down` and all four `drawer-panel-close-*` map to `ds-slide-edge-out`. After upgrading, open and close a modal, a drawer and a bottom sheet and confirm the page scrolls again afterwards.",
10
+ "appliesWhen": "The old names were view-encapsulated, so only a global stylesheet could ever have referenced them. You also gain `--ds-modal-leave-keyframes`, `--ds-drawer-leave-keyframes` and `--ds-bottom-sheet-leave-keyframes`, the exit counterparts of the enter hooks.",
11
+ "pitfall": "Point a leave hook at your own GLOBAL `@keyframes` only — Angular renames a component-scoped animation name, so a scoped one never resolves. And check the scroll after closing: teardown used to match the animation NAME on animationend, and a teardown that does not fire leaks the body-scroll lock. That is the failure this change could cause and the one it was tested for.",
12
+ "note": "Seven exit keyframes local to modal, drawer and bottom-sheet became four global presets mirroring the entrance vocabulary. The animationend guard checks the event came from the animated element rather than a child now, which is what freed the name. An exit preset reads `--_ds-exit-x/y/scale` and falls back to the matching enter values, so a surface that leaves the way it arrived declares nothing.",
10
13
  "searchHints": [
11
14
  "modal-out",
12
15
  "ds-sheet-down",
@@ -22,7 +25,10 @@
22
25
  "kind": "behavior",
23
26
  "old": "ds-select",
24
27
  "new": null,
25
- "note": "CHANGED DEFAULT, visual: the dropdown panel behind ds-select has a 12px corner (--ds-radius-panel), was 8px. It was the one panel outside the radius role layer - modal, popover, date-picker, time-picker, autocomplete, bottom-sheet, card, stat and page-footer all resolve --ds-radius-panel - so it both disagreed with its siblings and could not be retuned through the role a consumer is told to use. ACTION: none unless you want the old corner, in which case set --ds-radius-panel: 8px, which moves EVERY panel together and is the only lever there is: there is no per-panel token for the select, and --ds-select-panel-radius does not exist. ds-autocomplete does carry a per-panel --ds-autocomplete-panel-radius. NOT AFFECTED: ds-multi-select, whose panel is its own element with a hardcoded border-radius: var(--radius-md) that the shared rule does not reach - it stays at 8px in this version. CHECK: a screen where a dropdown opens beside a popover or a date picker - that is where the 4px difference was visible and is now gone.",
28
+ "action": "None unless you want the old corner: `--ds-radius-panel: 8px`.",
29
+ "appliesWhen": "ds-multi-select is NOT affected — its panel is its own element with a hardcoded `border-radius: var(--radius-md)` the shared rule does not reach, so it stays at 8px in this version.",
30
+ "pitfall": "That restore is the only lever there is, and it moves EVERY panel together — modal, popover, date-picker, time-picker, autocomplete, bottom-sheet, card, stat and page-footer all resolve the same role. There is no per-panel token for the select; `--ds-select-panel-radius` does not exist. ds-autocomplete does carry its own.",
31
+ "note": "The ds-select dropdown panel drew 8px and draws the 12px panel role now. It was the one panel outside the radius role layer, so it disagreed with its siblings and could not be retuned through the role a consumer is told to use.",
26
32
  "searchHints": [
27
33
  "--radius-md",
28
34
  "dropdown-panel",
@@ -38,7 +44,9 @@
38
44
  "kind": "selector-rename",
39
45
  "old": "ds-auth-shell",
40
46
  "new": "ds-auth-layout",
41
- "note": "Component renamed (shipped as ds-auth-shell in the tagged 0.8.0 source, its only release under that name). \"Shell\" is not this library's word for a layout: the app-level one was renamed ds-app-shell -> ds-app-layout in 0.7.0, and calling the auth counterpart a shell put the split vocabulary back. ACTION: rename the element and its closing tag. Behaviour, inputs and slots are unchanged - brand, logoLetter, tagline, cardElevation, cardPadding, [brand], [dsBrandName] and dsAuthSupport all keep their names. Also rename the class and the tokens (separate entries below).",
47
+ "action": "Rename the element and its closing tag from `ds-auth-shell` to `ds-auth-layout`, then apply the class and token items below.",
48
+ "appliesWhen": "Behaviour, inputs and slots are unchanged — `brand`, `logoLetter`, `tagline`, `cardElevation`, `cardPadding`, `[brand]`, `[dsBrandName]` and `dsAuthSupport` all keep their names.",
49
+ "note": "\"Shell\" is not this library's word for a layout: the app-level one became ds-app-layout in 0.7.0, and calling the auth counterpart a shell put the split vocabulary back. It shipped as ds-auth-shell in exactly one release.",
42
50
  "searchHints": [
43
51
  "ds-auth-shell"
44
52
  ],
@@ -49,7 +57,8 @@
49
57
  "kind": "type-rename",
50
58
  "old": "AuthShellComponent",
51
59
  "new": "AuthLayoutComponent",
52
- "note": "The exported component class renamed alongside the ds-auth-shell -> ds-auth-layout selector. Update imports and any type references. No members changed.",
60
+ "action": "Replace `AuthShellComponent` with `AuthLayoutComponent` in imports and type references.",
61
+ "note": "The exported class follows the selector rename. No members changed.",
53
62
  "searchHints": [
54
63
  "AuthShellComponent"
55
64
  ],
@@ -60,7 +69,10 @@
60
69
  "kind": "token-rename",
61
70
  "old": "--ds-auth-shell-",
62
71
  "new": "--ds-auth-layout-",
63
- "note": "Prefix rename for the six component tokens: --ds-auth-shell-min-height / -card-max-width / -gap / -bg-color / -mark-bg-color / -mark-label-color -> --ds-auth-layout-*. Values and defaults are unchanged. DS-owned tokens only (no others ship under this prefix); a consumer's own --ds-auth-shell-* variable is out of scope. EXCLUDED, do not rename: the global scale token --auth-card-w, the fallback behind -card-max-width, which carries no --ds-auth-shell- prefix and keeps its name. Confirm the new name exists in the installed package.",
72
+ "action": "Replace the prefix `--ds-auth-shell-` with `--ds-auth-layout-` on the six component tokens: `-min-height`, `-card-max-width`, `-gap`, `-bg-color`, `-mark-bg-color`, `-mark-label-color`.",
73
+ "appliesWhen": "DS-owned tokens only — no others ship under this prefix, and a variable of your own is out of scope.",
74
+ "pitfall": "Do NOT rename `--auth-card-w`. It is the global scale token behind `-card-max-width`, it carries no `--ds-auth-shell-` prefix, and it keeps its name — a prefix-blind sweep that catches it breaks the fallback.",
75
+ "note": "Values and defaults are unchanged.",
64
76
  "searchHints": [
65
77
  "--ds-auth-shell-"
66
78
  ],
@@ -71,10 +83,13 @@
71
83
  "kind": "behavior",
72
84
  "old": "ds-search",
73
85
  "new": null,
74
- "note": "CHANGED DEFAULT: ds-search is 40px tall at the default size, was 36px. Every size moved onto the field scale - sm var(--field-h-sm) 32px (was --hit-min 32px, unchanged), md var(--field-h-md) 40px (was --search-h 36px, CHANGED), lg var(--field-h-lg) 48px (unchanged). The old 36px was a lone tier: nothing else in the library used it, while ds-button, ds-input, ds-select and both pickers all resolve --field-h-md, so a search box in a toolbar sat 4px short of every neighbour. RESTORE the old height with `ds-search { --ds-search-height: 36px; }` - that token still wins over everything. ALSO NEW: the height now falls through --ds-field-height, so `--ds-field-height: 44px` on a toolbar levels search along with the fields, which was the point of the change.",
86
+ "action": "None unless you want the old height: `ds-search { --ds-search-height: 36px; }` — that token still wins over everything.",
87
+ "appliesWhen": "sm (32px) and lg (48px) are unchanged; only the md default moved. The height also falls through `--ds-field-height` now, so `--ds-field-height: 44px` on a toolbar levels search along with the fields.",
88
+ "note": "ds-search is 40px at the default size, was 36px. The old 36px was a lone tier nothing else used, while ds-button, ds-input, ds-select and both pickers all resolve `--field-h-md`, so a search box in a toolbar sat 4px short of every neighbour.",
75
89
  "searchHints": [
76
90
  "ds-search",
77
91
  "--ds-search-height",
92
+ "--hit-min",
78
93
  "--search-h"
79
94
  ],
80
95
  "surface": "style",
@@ -86,7 +101,10 @@
86
101
  "kind": "removed-api",
87
102
  "old": "--search-h",
88
103
  "new": null,
89
- "note": "The global --search-h token is gone; it existed only to hold ds-search's 36px and nothing reads it any more. Its replacements, in precedence order: --ds-search-height (retunes search alone) and --ds-field-height (levels the whole field family). If you declared --search-h to resize search, that declaration is now inert - swap it for --ds-search-height with the same value. Reading it in your own CSS resolves to nothing. The --hit-md scale token it pointed at (36px) is untouched and still available.",
104
+ "action": "If you declared `--search-h` to resize search, swap it for `--ds-search-height` with the same value.",
105
+ "appliesWhen": "The `--hit-md` scale token it pointed at (36px) is untouched and still available. `--ds-field-height` is the other replacement, levelling the whole field family.",
106
+ "pitfall": "A leftover `--search-h` declaration is now INERT — it sets a custom property nothing reads, so it neither errors nor warns, and reading it in your own CSS resolves to nothing.",
107
+ "note": "The global token existed only to hold ds-search's 36px and nothing reads it any more.",
90
108
  "searchHints": [
91
109
  "--search-h"
92
110
  ],
@@ -101,7 +119,10 @@
101
119
  "kind": "behavior",
102
120
  "old": "ds-table",
103
121
  "new": null,
104
- "note": "CHANGED DEFAULT: ds-table sortMode and filterMode resolve to 'server' when unset, were 'client'. An undeclared table now emits (sortChange) / updates columnFilters and reorders or filters NOTHING itself. ACTION, and it is per-table: if the table receives ALL its rows - the giveaway is that it does NOT bind `total` - add sortMode=\"client\" and, where any column has filter: 'set', filterMode=\"client\", or its headers will look live and do nothing. If it binds `total` it is server-paged and the new default is what you already wanted: the old 'client' sorted only the page in hand, so the rows looked sorted and were not, and a dev warning said exactly that. Tables that already declare a mode are untouched. A reversed dev warning now fires on the client case (no `total` + sortable/filterable columns + no declared mode), so run the app and let the console list them.",
122
+ "action": "Per table. If it receives ALL its rows — the giveaway is that it does NOT bind `total` — add `sortMode=\"client\"`, and `filterMode=\"client\"` where any column has `filter: 'set'`. Run the app afterwards: a dev warning now fires on exactly that case (no `total`, sortable or filterable columns, no declared mode) and the console lists them.",
123
+ "appliesWhen": "Tables that already declare a mode are untouched. A table that binds `total` is server-paged and the new default is what it wanted.",
124
+ "pitfall": "Skip it and the headers look live and do nothing — the table emits `(sortChange)` and updates `columnFilters` while reordering and filtering NOTHING itself. It is the mirror of the 0.8.0 default, which sorted only the page in hand.",
125
+ "note": "`sortMode` and `filterMode` resolve to `server` when unset, where they resolved to `client` before.",
105
126
  "searchHints": [
106
127
  "ds-table",
107
128
  "sortMode",
@@ -121,7 +142,9 @@
121
142
  "kind": "behavior",
122
143
  "old": "ds-number-stepper",
123
144
  "new": null,
124
- "note": "CHANGED DEFAULT, one size only: ds-number-stepper with size=\"lg\" is 48px tall, was 44px. It resolved --hit-comfy while the field family's large size is --field-h-lg (--hit-touch, 48px), so a large stepper was a step short of a large input beside it. The +/- buttons and the quantity box derive their widths from that height, so they widen with it. size=\"sm\" (32px) and the size=\"md\" default (40px) are unchanged. RESTORE with `ds-number-stepper { --ds-field-height: 44px; }` scoped to the instance, or set the size back to md.",
145
+ "action": "None unless you want the old height: `ds-number-stepper { --ds-field-height: 44px; }` scoped to the instance, or set the size back to md.",
146
+ "appliesWhen": "One size only — sm (32px) and the md default (40px) are unchanged.",
147
+ "note": "`size=\"lg\"` is 48px, was 44px: it resolved `--hit-comfy` while the family's large size is `--field-h-lg`, so a large stepper was a step short of a large input beside it. The +/- buttons and the quantity box derive their widths from that height, so they widen with it.",
125
148
  "searchHints": [
126
149
  "ds-number-stepper",
127
150
  "size=\"lg\"",
@@ -143,7 +166,10 @@
143
166
  "kind": "code-add",
144
167
  "old": "ds-tabs",
145
168
  "new": "urlParam=\"tab\"",
146
- "note": "ds-tabs can now keep the active tab in the URL: set urlParam (e.g. urlParam=\"tab\") and the strip writes ?tab=<name>, so the tab survives F5, a shared link and the Back button. Nothing changes until you set it, but this is worth a deliberate pass rather than a skim. ACTION, per strip: (1) GIVE EACH ds-tab A `value` if it has none - the URL is written from value, falling back to label, so without one a link carries the visible label and breaks the moment the label is translated or reworded. (2) ONE STRIP PER PARAMETER NAME. Two ds-tabs sharing a name on the same screen erase each other: both write the same query parameter, and a reload restores whichever wrote last. A dev-mode warning now names the clash. Nested or sibling strips need distinct names (tab, subtab). (3) DELETE any hand-rolled wiring - a queryParamMap subscription plus a navigate() on tabChanged is exactly what this replaces, and running both fights. Behaviour to expect: NAMES not indices (an index would silently repoint every old link as soon as a tab is inserted), the FIRST tab writes no parameter, every write uses replaceUrl so flipping tabs does not fill the Back button, and an unknown or missing name lands on the first tab instead of throwing. Inert outside a routed context, and being query-only it does not trip ds-app-layout's scroll reset.",
169
+ "action": "Per strip, and worth a deliberate pass. (1) Give each `ds-tab` a `value` if it has none. (2) Use one strip per parameter name — nested or sibling strips need distinct names, such as `tab` and `subtab`. (3) Delete any hand-rolled wiring: a queryParamMap subscription plus a `navigate()` on `tabChanged` is exactly what this replaces.",
170
+ "appliesWhen": "Nothing changes until you set `urlParam`.",
171
+ "pitfall": "Two traps, both silent until someone shares a link. Without a `value` the URL is written from the LABEL, so the link breaks the moment the label is translated or reworded. And two strips sharing a parameter name erase each other — both write the same query parameter and a reload restores whichever wrote last. A dev-mode warning names that clash.",
172
+ "note": "Setting `urlParam=\"tab\"` makes the strip write `?tab=<name>`, so the active tab survives F5, a shared link and the Back button.",
147
173
  "searchHints": [
148
174
  "<ds-tabs",
149
175
  "ds-tabs",
@@ -166,7 +192,10 @@
166
192
  "kind": "behavior",
167
193
  "old": "extends TableComponent",
168
194
  "new": null,
169
- "note": "This release's single class-member-collision entry, the counterpart of 0.8.0's: it covers EVERY exported class whose member surface changed, so a consumer who EXTENDS a DS component resolves them in one pass. Subclassing a DS component is unsupported (design-system.md), but where it happens the names collide and the build stops: TS4114 demands `override`, TS2415 fires on a redeclared private, TS2416 on a differing signature. This is not hypothetical - migrating to 0.8.0, one consumer's ids-data-table (which extends TableComponent) failed on exactly three of them. WHAT GAINED MEMBERS: (1) TableComponent, by far the largest - lazy, lazyLoad, showLabel, showPageSize, filterMode, columnFilterOptions, sortAnnouncement, rangeAnnouncement and exportFailed as inputs/outputs, plus protected filterModeResolved, headerFilters, headerFilterByKey, headerFilterFor(), headerFilterContext(), statusMessage, sortMessage, rangeMessage, virtualCount, rowSlots, exportStatus, resolvedColumnWidth(), onResizeKey() and onHeaderEnter(). Note isStriped() now takes an ABSOLUTE row index rather than a window-relative one, so a subclass that overrode it computes the wrong row. (2) Both CVA bases (DsControlValueAccessor, DsBooleanControlValueAccessor) gained the `hidden` input and a `focus()` method - inherited by every field control, so a subclass with its own focus() needs `override`. (3) InputComponent and TextareaComponent gained readonlyBinding, isReadOnly, minLength, pattern and patternAttribute; SelectComponent gained readonlyBinding and isReadOnly. (4) ModalComponent and ModalCardComponent each gained `subtitle` and `dividers`. (5) AutocompleteComponent gained maxVisibleChips, showChevron, clear(), visibleTags and overflowCount. (6) BreadcrumbsComponent gained maxItems and allItems; MenuItemComponent gained `quiet`; AppLayoutComponent gained scrollReset; AuthLayoutComponent gained `landmark`; TabsComponent gained urlParam and urlParams; LayoutScrollService gained configureReset(). (7) NEW exported symbols that can shadow a local name: FieldGroupComponent, DS_FIELD_GROUP, HeaderFilterDirective and HeaderFilterContext. WHAT WAS REMOVED: TableComponent's private `distinctValuesOf()` is gone, replaced by `optionsFor()`, which prefers the new `columnFilterOptions` input and falls back to the rows in hand — a subclass that called or redeclared the old name loses it silently at the call site and noisily at the declaration. ACTION: rename the subclass's own member, or add `override` where the base's semantics genuinely match - and re-read isStriped() if you overrode it. Consumers who only use the <ds-...> elements in templates need no change.",
195
+ "action": "Build after upgrading: the compiler raises most of these collisions, but NOT the ones named in `pitfall` below — check those by hand, because they compile clean. Then per member: rename your own, or add `override` where the base semantics genuinely match.",
196
+ "appliesWhen": "Only a consumer that EXTENDS a DS component class. Subclassing is unsupported (design-system.md § Components); template users need nothing.",
197
+ "pitfall": "Two things the compiler will NOT tell you. `isStriped()` keeps its signature but now takes an ABSOLUTE row index rather than a window-relative one, so a subclass that overrode it silently computes the wrong row. And `distinctValuesOf()` was replaced by `optionsFor()` — a subclass that CALLED the old name loses it silently at the call site while only the declaration errors. Also note both CVA bases gained a `focus()` inherited by every field control, so a subclass with its own needs `override`, and four new exported symbols can shadow a local name: FieldGroupComponent, DS_FIELD_GROUP, HeaderFilterDirective, HeaderFilterContext.",
198
+ "note": "TableComponent changed by far the most; ModalComponent, ModalCardComponent, InputComponent, TextareaComponent, SelectComponent, AutocompleteComponent, BreadcrumbsComponent, MenuItemComponent, AppLayoutComponent, AuthLayoutComponent, TabsComponent, LayoutScrollService and both CVA bases also moved. TS4114 demands `override`, TS2415 fires on a redeclared private, TS2416 on a differing signature.",
170
199
  "searchHints": [
171
200
  "extends TableComponent",
172
201
  "extends InputComponent",
@@ -193,41 +222,69 @@
193
222
  "override "
194
223
  ],
195
224
  "verify": "A typecheck reports no TS4114 / TS2415 / TS2416 on any class extending a DS component; a subclass that overrode isStriped() reads an ABSOLUTE row index now."
225
+ },
226
+ {
227
+ "id": "input-signal-types-widened-by-transforms",
228
+ "kind": "behavior",
229
+ "old": "class MyInput extends InputComponent (or NumberStepperComponent / TextareaComponent)",
230
+ "new": null,
231
+ "action": "Drop the annotation, or widen it to `InputSignalWithTransform`. `ds-input.focus()` and `ds-textarea.focus()` also gained `override`, for the same subclass-only reason.",
232
+ "appliesWhen": "NO ACTION for a caller: the WRITE type widened, so every binding that compiled still compiles, and the READ type is unchanged. Two shapes only are affected — an explicit annotation naming the old type, and a subclass that re-declares one of these.",
233
+ "note": "Six inputs gained a transform, so their declared type went from `InputSignal<T>` to `InputSignalWithTransform<T, W>`: `min`, `max` and `maxLength` on ds-input, `min` and `max` on ds-number-stepper, `maxLength` on ds-textarea. The failures are TS2322 on the annotation and TS2416 on the subclass.",
234
+ "surface": "typescript",
235
+ "verify": "Build your app: no TS2322 naming `InputSignal` and no TS2416 on a class that extends a DS field. A template binding `[min]=\"expr\"` compiles unchanged.",
236
+ "searchHints": [
237
+ "InputSignal",
238
+ "InputSignalWithTransform",
239
+ "extends InputComponent",
240
+ "extends NumberStepperComponent",
241
+ "extends TextareaComponent",
242
+ "TS2322",
243
+ "TS2416"
244
+ ],
245
+ "detect": [
246
+ "InputSignal<",
247
+ "extends InputComponent",
248
+ "extends NumberStepperComponent",
249
+ "extends TextareaComponent",
250
+ "TS2322",
251
+ "TS2416"
252
+ ]
196
253
  }
197
254
  ],
198
255
  "informational": [
199
- "--ds-radius-inner now actually reaches the small affordances. 33 reads across fifteen component stylesheets took var(--radius-sm) directly - dropdown options, field clear buttons, calendar days, chips, tag and toast close buttons - so the role a consumer is told to retune reached exactly one component. They resolve the role now, and its default IS --radius-sm, so NOTHING MOVES: verified by measuring a component page before and after, identical surfaces at identical radii. NO ACTION, but it changes what a square brand costs you: zeroing the three roles used to leave five surfaces rounded and now leaves one. Two deliberate exclusions - five focus-ring radii inside :focus-visible keep following the raw scale (a ring traces a box, it is not a brand surface), and the shared dropdown panel behind ds-select / ds-multi-select still reads --radius-md (8px) where every other panel resolves --ds-radius-panel (12px). That last one is a tracked inconsistency, not a hook: squaring it needs the scale. Worked example on the Theming page.",
200
- "A 32px toolbar is `density=\"compact\"`, not a per-control height pin. Measured on a nine-control row: search, input, select, autocomplete, date-picker, time-picker, multi-select, number-stepper and button are all 40px by default and all 32px under [data-density=\"compact\"] on the container. DELETE-LIST MATERIAL: if you pin --ds-search-height (or any sibling) to get a shorter row - one consumer pins --hit-min and its comment complains that md used to be 36px - that pin can go, and after the height contract it was fighting the family rather than joining it. Known limit at the bottom of the scale: ds-multi-select and ds-autocomplete hold chips, so they set a min-height rather than a height and stop following the floor once it drops below what the text needs - under ultra-compact they are 33px and 29px where the rest reach 24px, because a density tier scales padding and hit targets but not the type scale. Compact is unaffected in practice (33 against 32). Documented on the Density page.",
256
+ "--ds-radius-inner now actually reaches the small affordances. 33 reads across fifteen component stylesheets took var(--radius-sm) directly - dropdown options, field clear buttons, calendar days, chips, tag and toast close buttons - so the role a consumer is told to retune reached exactly one component. They resolve the role now, and its default IS --radius-sm, so NOTHING MOVES. NO ACTION, but it changes what a square brand costs you: zeroing the three roles used to leave five surfaces rounded and now leaves one. Two deliberate exclusions - five focus-ring radii inside :focus-visible keep following the raw scale (a ring traces a box, it is not a brand surface), and the shared dropdown panel behind ds-select / ds-multi-select still reads --radius-md (8px) where every other panel resolves --ds-radius-panel (12px). That last one is a known inconsistency, not a hook: squaring it needs the scale. Worked example on the Theming page.",
257
+ "A 32px toolbar is `density=\"compact\"`, not a per-control height pin. Measured on a nine-control row: search, input, select, autocomplete, date-picker, time-picker, multi-select, number-stepper and button are all 40px by default and all 32px under [data-density=\"compact\"] on the container. DELETE-LIST MATERIAL: if you pin --ds-search-height, or reach past it to --hit-min, to get a shorter row - that pin can go, and after the height contract it was fighting the family rather than joining it. `--hit-min` is also a legitimate density knob, so discard hits where it is set deliberately rather than to shorten a search row. Known limit at the bottom of the scale: ds-multi-select and ds-autocomplete hold chips, so they set a min-height rather than a height and stop following the floor once it drops below what the text needs - under ultra-compact they are 33px and 29px where the rest reach 24px, because a density tier scales padding and hit targets but not the type scale. Compact is unaffected in practice (33 against 32). Documented on the Density page. (delete list: search-height-pinned-for-a-short-row)",
201
258
  "SIGNAL FORMS WORK — no adapter, no wrapper, no DS import. Put [formField] from @angular/forms/signals on any DS control and the form owns the value, validation, touched and disabled state. This was ALWAYS nearly true and nobody knew: FormValueControl requires exactly one member, a `value` model(), and every DS control already had it. Measured across all fifteen controls - thirteen bound with no library change at all. Additive, NO ACTION. WHAT CHANGED HERE, and it is why the other four rules now work too: min/max/maxLength on ds-input, ds-textarea and ds-number-stepper accept undefined on the WRITE side (the binder sends it for an unset bound; the read type is untouched); `readonly` joins ds-input, ds-textarea and ds-select as the contract spelling of the existing readOnly, because signal forms binds by NAME and a readonly() rule was reaching nothing; `minLength` and `pattern` are new native attributes on ds-input and ds-textarea; and `hidden` is declared on both control-value-accessor bases, so a hidden() rule now removes the control on all thirteen that carry one. focus() is implemented too, so focusBoundControl() - the usual way to reach the first invalid field after a failed submit - lands on the element that holds the value rather than on the host, which is a <ds-*> element and not focusable, so focus previously went nowhere. It resolves per control: the stepper's number box rather than its minus button, the tabbable radio rather than the first in the DOM, a picker's trigger rather than an input inside its closed panel. NOT implemented: dirty, pending and disabledReasons - the form still tracks them, and they are blocked on a visual decision rather than wiring. ERROR TEXT still comes from your validator: required(path.email, { message: '...' }) or a provideDsConfig field.errorMessages mapping, otherwise the field goes red with no words and only a dev warning explains why. Docs: the Practice > Signal Forms page, with a live form and the measured contract table.",
202
- "ds-modal / ds-modal-card gained [dividers] (default true = today's rendering). Additive, NO ACTION - but DELETE-LIST MATERIAL if you set --ds-modal-divider: transparent. Two consumer apps did exactly that, and both were then left with header and actions padding sized to clear a rule that was no longer drawn, stacking into a 35px gap where 16px was wanted; one needed !important plus a stylelint-disable to win it back. [dividers]=\"false\" drops the rules AND the padding in one move, because those are one design decision. If you kept a deliberate --ds-modal-divider colour, nothing changes. If you set it transparent, replace it with [dividers]=\"false\" and delete whatever padding overrides you wrote afterwards - and note --ds-modal-body-pad-y now falls to 0 in that mode, so set it explicitly if you want a value in both.",
203
- "ds-modal / ds-modal-card gained a [title-badge] content slot and a subtitle input, so a dialog header can carry a status chip and a second line without abandoning the component. Additive, NO ACTION - both are absent by default and the header renders exactly as before. WORTH A LOOK IF YOU HAND-ROLLED A DIALOG: a consumer audit found two screens that dropped ds-modal purely because the header could not hold `title + ds-badge` over a `carrier - type` line, and re-implemented the scrim, the body scroll lock, backdrop-click and Escape by hand - losing the focus trap, focus restore, the enter/leave animation and, in one case, the footer, which put a destructive action next to the close button. The shape matches ds-page-header: [title-badge] projects beside the title, subtitle is a plain string under it. The accessible name is still the title string - projected markup never enters aria-labelledby. Retune with --ds-modal-subtitle-text-color and --ds-modal-subtitle-font-size.",
259
+ "ds-modal / ds-modal-card gained [dividers] (default true = today's rendering). Additive, NO ACTION - but DELETE-LIST MATERIAL if you set --ds-modal-divider: transparent. Setting it transparent leaves the header and actions padding sized to clear a rule that is no longer drawn, stacking into a 35px gap where 16px was wanted. [dividers]=\"false\" drops the rules AND the padding in one move, because those are one design decision. If you kept a deliberate --ds-modal-divider colour, nothing changes. If you set it transparent, replace it with [dividers]=\"false\" and delete whatever padding overrides you wrote afterwards - and note --ds-modal-body-pad-y now falls to 0 in that mode, so set it explicitly if you want a value in both. (delete list: modal-divider-transparent-plus-padding)",
260
+ "ds-modal / ds-modal-card gained a [title-badge] content slot and a subtitle input, so a dialog header can carry a status chip and a second line without abandoning the component. Additive, NO ACTION - both are absent by default and the header renders exactly as before. WORTH A LOOK IF YOU HAND-ROLLED A DIALOG: a header that has to carry `title + ds-badge` over a second line used to be a reason to drop ds-modal and re-implement the scrim, the body scroll lock, backdrop-click and Escape by hand - which costs the focus trap, focus restore, the enter/leave animation and, easily, the footer, leaving a destructive action next to the close button. The shape matches ds-page-header: [title-badge] projects beside the title, subtitle is a plain string under it. The accessible name is still the title string - projected markup never enters aria-labelledby. Retune with --ds-modal-subtitle-text-color and --ds-modal-subtitle-font-size.",
204
261
  "NEW COMPONENT ds-field-group: several controls in one bordered box (select + input, input + button, search + date-picker). Additive, NO ACTION. If you hand-rolled a glued row by stripping borders off two controls and wrapping them, this replaces it - wrap them in <ds-field-group> and mark the stretching one with grow. Six controls can be segments: ds-input, ds-select, ds-search, ds-autocomplete, ds-date-picker, ds-button. ds-number-stepper and ds-multi-select are excluded by design. Grouped controls must not be given a label or hint - the message row would break the glued line and is suppressed.",
205
262
  "ds-table gained [lazy] + (lazyLoad) for fetching rows as they scroll into view. Additive and opt-in, NO ACTION. If you paged a long list yourself to keep it responsive, this is the alternative: set lazy with virtualScroll and total, make data a SPARSE array total long, and write each fetched row at its ABSOLUTE index - gaps inside the window render skeleton rows. Note sortMode must not be \"client\" (it would sort only the rows that happen to have arrived); the new server default is already right.",
206
263
  "--ds-field-height now reaches ds-autocomplete, ds-multi-select, ds-color-picker, ds-number-stepper, ds-split-button and the ds-modal confirm input. All six spelled their height as the raw --hit-* value, so the token the name advertises did nothing for them; they read the field scale now. Pixel-identical at every size EXCEPT ds-number-stepper at size=\"lg\" (its own actionable entry above). NO ACTION unless you had already worked around the gap by pinning height on one of these - that pin can go.",
207
264
  "The six connected panels (ds-select, ds-multi-select, ds-autocomplete, ds-color-picker, ds-date-picker, ds-time-picker) now build their overlay from one shared helper instead of six identical copies. Internal only, NO ACTION: the position, the 4px gap, the flip-above fallback, the panel classes and the scroll strategy are byte-for-byte what they were.",
208
265
  "ds-autocomplete gained dsAutocompletePrefix / dsAutocompleteSuffix content slots and [showChevron] (default true). Additive, NO ACTION. If you absolutely positioned a search glyph over the field and re-padded the input, or hid the arrow with a global rule reaching for .autocomplete-chevron, replace both: put the icon in the prefix slot and set [showChevron]=\"false\". The slot names and behaviour match ds-input's dsInputPrefix / dsInputSuffix.",
209
- "ds-autocomplete gained a public clear() that empties the value AND the typed text. If you reset the field by querying the inner <input> out of the DS's DOM and dispatching a synthetic input event, delete that and call clear() on a viewChild ref - the DOM shape it depended on is not part of the public API. It deliberately does not move focus.",
266
+ "ds-autocomplete gained a public clear() that empties the value AND the typed text. If you reset the field by querying the inner <input> out of the DS's DOM and dispatching a synthetic input event, delete that and call clear() on a viewChild ref - the DOM shape it depended on is not part of the public API. It deliberately does not move focus. (delete list: autocomplete-synthetic-input-clear)",
210
267
  "ds-autocomplete gained --ds-autocomplete-panel-radius (default --ds-radius-panel) and --ds-autocomplete-panel-maxh (default --picker-maxh). NO ACTION - both defaults equal today's values. The radius one matters if you square the radius roles: the autocomplete panel was the last portaled surface hard-coding --radius-lg, so it stayed rounded in an otherwise square brand. The max-height one replaces reaching for the private --picker-maxh, which ds-multi-select also reads.",
211
- "ds-table gained --ds-table-head-pad-top / --ds-table-head-pad-bottom, plus showPageSize and showLabel forwarded to its footer pager. All additive with today's values as defaults, NO ACTION. Separately FIXED: density=\"compact\" pinned padding onto the cells, which out-specified every --ds-table-*-pad-* hook, so a compact table silently ignored all of them; it now retunes the density tokens instead. Spacing is unchanged - but if you fought that with an !important, it can go.",
268
+ "ds-table gained --ds-table-head-pad-top / --ds-table-head-pad-bottom, plus showPageSize and showLabel forwarded to its footer pager. All additive with today's values as defaults, NO ACTION. Separately FIXED: density=\"compact\" pinned padding onto the cells, which out-specified every --ds-table-*-pad-* hook, so a compact table silently ignored all of them; it now retunes the density tokens instead. Spacing is unchanged - but if you fought that with an !important, it can go. (delete list: compact-cell-padding-important)",
212
269
  "ds-date-picker and ds-time-picker resolve their trigger's horizontal padding from --field-pad-x (new hooks: --ds-date-picker-trigger-pad-x, --ds-time-picker-trigger-pad-x) instead of a hard-coded --space-3. Identical at the default density; the difference shows under [data-density], where the token shrinks and the literal did not, leaving a picker 8px wider than the input beside it. NO ACTION unless you hand-pinned picker padding to compensate.",
213
270
  "The ds-auth-shell -> ds-auth-layout rename is vocabulary only: no input, output, slot, token value or behaviour changed, and it is the same component 0.8.0 shipped. If you never adopted ds-auth-shell (it was added in 0.8.0), there is nothing to do.",
214
271
  "FIXED in ds-textarea: size=\"sm\" and size=\"lg\" rendered the md vertical padding (12px top and bottom) regardless of the size. The size blocks set the inner textarea's vertical pad, but a :host-prefixed pin at the end of the file out-ranked them once emulated encapsulation shimmed both selectors - it carries one more attribute than the size selector. There are now three pins, one per size, and the size blocks keep only the horizontal padding they own. NO ACTION: the change is visible only on a non-md textarea and the md default is unchanged. Note that retuning --ds-input-pad-y previously moved all three sizes together; if you compensated for the wrong padding with your own override on a sm or lg textarea, that override now stacks on the corrected value and can go.",
215
- "ds-auth-layout now COMPRESSES its own chrome on a short viewport: block padding, the column gap, the letter-mark tile and the masthead inner gap clamp against svh. No action - behaviour only, and a viewport 800px tall or more renders exactly what it did before. Read that as a VIEWPORT height, not a screen size: a 1366x768 laptop sits near 630px after browser and OS chrome, and a 1080p screen at 150% display scaling near 585px, so plenty of desktops do get the compressed furniture - an earlier wording of this line said 'so desktop is unchanged', which was wrong. Type is deliberately NOT clamped: the wordmark and the tile's glyph were measured to buy zero vertical space (the tile sets the row height at every viewport, and the glyph sits in a fixed-size box) while flattening the brand against a fixed 14px tagline, so both keep the fixed sizes 0.8.0 ships. Below 800px the remaining furniture shrinks so it is not what pushes a card into scrolling (~131px instead of ~219px at a landscape phone's ~330px). Two tokens opt out per dimension: --ds-auth-layout-pad-block and --ds-auth-layout-mark-size; setting any of those or the existing --ds-auth-layout-gap to a fixed value stops that one compressing. A card taller than the remaining space still scrolls - that is intended.",
272
+ "ds-auth-layout now COMPRESSES its own chrome on a short viewport: block padding, the column gap, the letter-mark tile and the masthead inner gap clamp against svh. No action - behaviour only, and a viewport 800px tall or more renders exactly what it did before. Read that as a VIEWPORT height, not a screen size: a 1366x768 laptop sits near 630px after browser and OS chrome, and a 1080p screen at 150% display scaling near 585px, so plenty of desktops do get the compressed furniture. Type is deliberately NOT clamped: the wordmark and the tile's glyph were measured to buy zero vertical space (the tile sets the row height at every viewport, and the glyph sits in a fixed-size box) while flattening the brand against a fixed 14px tagline, so both keep the fixed sizes 0.8.0 ships. Below 800px the remaining furniture shrinks so it is not what pushes a card into scrolling (~131px instead of ~219px at a landscape phone's ~330px). Two tokens opt out per dimension: --ds-auth-layout-pad-block and --ds-auth-layout-mark-size; setting any of those or the existing --ds-auth-layout-gap to a fixed value stops that one compressing. A card taller than the remaining space still scrolls - that is intended.",
216
273
  "ds-auth-layout audit fixes, all additive or corrective - NO ACTION. The letter-mark tile is now aria-hidden (a screen reader announced 'A MyAdmin', now 'MyAdmin') and carries flex-shrink: 0 so a long wordmark cannot squash it out of square; logoLetter on its own renders its tile instead of nothing; the glyph is taken by code point rather than charAt(0), which returned half a surrogate pair for a brand starting with an emoji; box-sizing: border-box is declared on the host rather than inherited, so the component still avoids its own overflow scrollbar for a consumer composing style partials without styles/reset. The four env(safe-area-inset-*) calls gained 0px fallbacks and moved to physical padding-left/padding-right so the insets cannot swap sides under RTL - and note they are inert unless YOUR app sets viewport-fit=cover in its viewport meta, which the library cannot set for you. New tokens, both defaulting to today's behaviour: --ds-auth-layout-mark-radius (the tile's radius was the one value with no override hop) and --ds-auth-layout-brand-max-height (none by default; set it to cap a projected [brand] logo, which nothing constrained). New input landmark, default 'none': set landmark=\"main\" on a standalone auth page so the card - an <article>, which is not a landmark - becomes something a screen-reader user can jump to; it stays opt-in because this layout is also embedded inside pages that already own a main.",
217
- "ds-icon now logs a dev-mode warning when an icon name is in neither the DS set nor your provideDsIcons() registry - previously it rendered an empty <svg> silently. No action, and nothing changes in production. Expect the warning to surface real typos the moment you upgrade: an audit of three screens in one consumer is what prompted it.",
274
+ "ds-icon now logs a dev-mode warning when an icon name is in neither the DS set nor your provideDsIcons() registry - previously it rendered an empty <svg> silently. No action, and nothing changes in production. Expect the warning to surface real typos the moment you upgrade.",
218
275
  "ds-app-layout gained scrollReset: \"path\" | \"never\" | \"always\" (default \"path\" = existing behaviour, so NO ACTION), and LayoutNavigationService is now exported. If you wrote your own \"did the path change?\" check to work around the layout resetting scroll - or to skip a view transition, or to reset a tab - replace it with inject(LayoutNavigationService).pathChanged: it is NavigationEnd, path only, de-duplicated, and it skips a navigation carrying state: { dsSamePage: true }. Note a naive split(\"?\") is NOT equivalent, it keeps the fragment this stream strips. To stop the layout resetting scroll on a paged or filtered list, set scrollReset=\"never\" and call LayoutScrollService.scrollToTop() where you actually want it.",
219
- "Options in ds-select / ds-autocomplete / ds-multi-select panels now have a pressed state (they had hover only, which does nothing on touch). No action - visual only. If you styled :active on .option yourself to work around it, you can drop that override; if you want a different pressed fill, it reads --surface-muted (neutral rows) and --primary-subtitle (the selected row).",
220
- "ds-table gained filterMode: \"client\" | \"server\" | \"none\" (default \"client\" = existing behaviour, so NO ACTION) and columnFilterOptions. If your table is server-paged (you bind `total`) and any column has filter: \"set\", you WANT filterMode=\"server\" plus columnFilterOptions with the real value domain - otherwise the checklist offers only the values on the current page and then filters locally on top of the server. A dev warning now points this out.",
276
+ "Options in ds-select / ds-autocomplete / ds-multi-select panels now have a pressed state (they had hover only, which does nothing on touch). No action - visual only. If you styled :active on .option yourself to work around it, you can drop that override; if you want a different pressed fill, it reads --surface-muted (neutral rows) and --primary-subtitle (the selected row). (delete list: dropdown-option-active-override)",
277
+ "ds-table gained filterMode: \"client\" | \"server\" | \"none\" and columnFilterOptions. It resolves to \"server\" when unset - see the table-sort-filter-mode-default-server item, which is where the action for that lives. If your table is server-paged (you bind `total`) and any column has filter: \"set\", you WANT filterMode=\"server\" plus columnFilterOptions with the real value domain - otherwise the checklist offers only the values on the current page and then filters locally on top of the server. A dev warning now points this out.",
221
278
  "ds-table gained dsHeaderFilter, a template slot for a header filter the built-in checklist cannot express (date range, numeric threshold, async options). Additive, NO ACTION. If you built a host-owned popover outside the table for this, you can move it inside: <ng-template dsHeaderFilter=\"key\" [active]=\"...\" let-close=\"close\">. The table keeps the button, the popover and the active styling; `active` is how you tell it your criterion is set, and `close` dismisses the panel after applying. A projected filter also makes the column filterable on its own - you do not additionally need filter: \"set\".",
222
- "ds-table now announces sort state and row range through its role=\"status\" region (\"Sorted by Owner, ascending\", \"Showing 1-25 of 240\"). No action - it is additive and the first render stays silent, since aria-live announces changes rather than initial content. If you added your own live region around the table for this, remove it or you will get double announcements. Wording is overridable per table through the sortAnnouncement and rangeAnnouncement inputs, which take the facts and return the sentence.",
279
+ "ds-table now announces sort state and row range through its role=\"status\" region (\"Sorted by Owner, ascending\", \"Showing 1-25 of 240\"). No action - it is additive and the first render stays silent, since aria-live announces changes rather than initial content. If you added your own live region around the table for this, remove it or you will get double announcements. Wording is overridable per table through the sortAnnouncement and rangeAnnouncement inputs, which take the facts and return the sentence. (delete list: table-own-live-region)",
223
280
  "ds-table column resizing is now keyboard-operable: the handle is focusable (role=\"separator\", labelled per column) and answers Arrow (16px), PageUp/PageDown (64px) and Home (back to automatic sizing). No action. If you hid or restyled .col-resize, note it can now receive focus and shows an indicator.",
224
- "ds-table exportFetcher may now resolve a Blob or a URL string as well as rows, so a backend-formatted file downloads as-is; a new exportFailed output emits the rejection. Additive, NO ACTION - returning rows keeps working. If you wrapped the button to catch failures yourself, you can drop that.",
281
+ "ds-table exportFetcher may now resolve a Blob or a URL string as well as rows, so a backend-formatted file downloads as-is; a new exportFailed output emits the rejection. Additive, NO ACTION - returning rows keeps working. If you wrapped the button to catch failures yourself, you can drop that. (delete list: table-export-failure-wrapper)",
225
282
  "ds-table: the FIRST column resize now freezes every visible column at its measured width before applying the drag, so untouched columns stop jumping. No action, but if you persist columnWidths (persistLayout) expect the stored map to gain entries for columns the user never dragged - that is the fix, not a bug.",
226
283
  "ds-table sortValue string comparison now uses sensitivity: \"base\" alongside numeric: true, so mixed-case and accented values sort together. No action; if you relied on case-sensitive ordering, pass your own sortValue returning a normalized key.",
227
- "ds-date-picker keeps its trigger indicator while the panel is open (an \"open\" class alongside the focus rules). Visual only, NO ACTION. If you styled .trigger:focus-within yourself to work around the trigger going dark, you can drop it.",
228
- "ds-autocomplete in single mode collapses its filter input once a value is chosen and the panel is closed, so the field reads as a picker instead of a text box. Visual only, NO ACTION. Clicking the field still opens the panel and expands the input, and typing still filters. If you set --ds-autocomplete-input-minw to work around the empty box, you can drop it.",
284
+ "ds-date-picker keeps its trigger indicator while the panel is open (an \"open\" class alongside the focus rules). Visual only, NO ACTION. If you styled .trigger:focus-within yourself to work around the trigger going dark, you can drop it. (delete list: date-picker-trigger-focus-within-override)",
285
+ "ds-autocomplete in single mode collapses its filter input once a value is chosen and the panel is closed, so the field reads as a picker instead of a text box. Visual only, NO ACTION. Clicking the field still opens the panel and expands the input, and typing still filters. If you set --ds-autocomplete-input-minw to work around the empty box, you can drop it. (delete list: autocomplete-input-minw-override)",
229
286
  "ds-date-picker: clicking the calendar glyph no longer moves focus into the day grid. It now behaves like a click on the field - with allowInput (the default) the caret stays in the field, and a read-only field still focuses the grid. No action; ArrowDown on the field enters the grid as before. If you scripted tests that assumed a glyph click lands focus on a day button, they need updating.",
230
- "WHAT YOU CAN NOW DELETE - the half a release note usually leaves out. Two dogfooding audits (mm-ecm 2026-08-06, mm-broker 2026-08-07) read consumer stylesheets as a record of what this library made them write, and both found the same thing: most of the workarounds were written against hooks that ALREADY existed, because a release note says what broke and never says what became unnecessary. Each line below is SEARCH-FOR -> WHY IT CAN GO. None of it is required: skipping it leaves working code that is merely redundant. How to sweep for the rest: grep your styles for ::ng-deep, !important, and any selector naming a DS internal class (.button, .trigger, .option, .modal) - each hit is either an entry below or a genuine gap worth reporting."
287
+ "WHAT THE DELETE LIST COVERS - the half a release note usually leaves out. Most of the workarounds are written against hooks that ALREADY existed, because a release note says what broke and never says what became unnecessary. Each line below is SEARCH-FOR -> WHY IT CAN GO. None of it is required: skipping it leaves working code that is merely redundant. How to sweep for the rest: grep your styles for ::ng-deep, !important, and any selector naming a DS internal class (.button, .trigger, .option, .modal) - each hit is either an entry below or a genuine gap worth reporting."
231
288
  ],
232
289
  "deleteList": [
233
290
  {
@@ -430,7 +487,8 @@
430
487
  "surface": "style",
431
488
  "find": [
432
489
  "!important",
433
- "density="
490
+ "density=",
491
+ "--ds-table-cell-pad"
434
492
  ],
435
493
  "why": "`!important` on `ds-table` cell padding under `density=\"compact\"`",
436
494
  "replaceWith": "Compact no longer out-specifies the padding hooks"
@@ -448,6 +506,68 @@
448
506
  ],
449
507
  "why": "A wrapper around `ds-table` for sort/range announcements, keyboard column resize, or a header filter the checklist cannot express",
450
508
  "replaceWith": "All three ship: the live region, the `role=\"separator\"` handle, and `dsHeaderFilter`"
509
+ },
510
+ {
511
+ "id": "dropdown-option-active-override",
512
+ "surface": "style",
513
+ "find": [
514
+ ".option",
515
+ ":active",
516
+ "ds-select",
517
+ "ds-autocomplete",
518
+ "ds-multi-select"
519
+ ],
520
+ "why": "An :active rule you wrote on a panel option because the options had hover only, which does nothing on touch. The components paint a pressed state themselves now.",
521
+ "replaceWith": "nothing - or retune it through --surface-muted and --primary-subtitle"
522
+ },
523
+ {
524
+ "id": "table-export-failure-wrapper",
525
+ "surface": [
526
+ "template",
527
+ "typescript"
528
+ ],
529
+ "find": [
530
+ "exportFetcher",
531
+ "ds-table",
532
+ "catch",
533
+ "try {"
534
+ ],
535
+ "why": "A wrapper around the export button that caught a rejected exportFetcher, written because the table surfaced no failure of its own. ds-table emits exportFailed now.",
536
+ "replaceWith": "bind (exportFailed) on ds-table"
537
+ },
538
+ {
539
+ "id": "date-picker-trigger-focus-within-override",
540
+ "surface": "style",
541
+ "find": [
542
+ ".trigger",
543
+ ":focus-within",
544
+ "ds-date-picker"
545
+ ],
546
+ "why": "A :focus-within rule on the date-picker trigger, written because the trigger went dark while its panel was open. The component keeps an \"open\" class alongside the focus rules now.",
547
+ "replaceWith": "nothing - the component holds the indicator itself"
548
+ },
549
+ {
550
+ "id": "autocomplete-input-minw-override",
551
+ "surface": "style",
552
+ "find": [
553
+ "--ds-autocomplete-input-minw"
554
+ ],
555
+ "why": "A --ds-autocomplete-input-minw override, written to hide the empty filter box that sat beside a chosen value in single mode. The input collapses on its own once a value is picked and the panel closes.",
556
+ "replaceWith": "nothing - unless you genuinely want a wider typing area"
557
+ },
558
+ {
559
+ "id": "table-own-live-region",
560
+ "surface": [
561
+ "template",
562
+ "typescript"
563
+ ],
564
+ "find": [
565
+ "aria-live",
566
+ "role=\"status\"",
567
+ "ds-table"
568
+ ],
569
+ "why": "A live region you wrapped around ds-table to announce sort state or row range. The table announces both through its own role=\"status\" region now, so keeping yours gives the screen reader every change twice.",
570
+ "replaceWith": "nothing - retune the wording through sortAnnouncement and rangeAnnouncement"
451
571
  }
452
572
  ]
453
573
  }