@ids-group-ltd/ids-design-system 0.4.0 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md ADDED
@@ -0,0 +1,657 @@
1
+ # Changelog
2
+
3
+ All notable changes to `@ids-group-ltd/ids-design-system` are documented here.
4
+
5
+ Versioning follows [SemVer](https://semver.org). Mapping from commit types:
6
+ `fix` → patch, `feat` → minor, breaking change (API or visual) → major.
7
+ While the package is on `0.x`, minor releases may contain breaking changes.
8
+
9
+ ## Unreleased
10
+
11
+ ## 0.5.1 — 2026-07-13
12
+
13
+ ### Breaking
14
+
15
+ - **Status vocabulary unified — `danger` → `error`, `warn` → `warning`.** A new exported
16
+ `DsStatus = 'info' | 'success' | 'warning' | 'error'` is the canonical status vocabulary.
17
+ Renamed to match it: the boolean input `[danger]` → `[error]` on `ds-modal` / `ds-modal-card` /
18
+ `ds-menu-item`; `ds-stat` `variant` value `'danger'` → `'error'`; `ds-progress` `variant` value
19
+ `'warn'` → `'warning'` (`ProgressVariant` is now `'default' | Exclude<DsStatus, 'info'>`);
20
+ `ModalConfirmTone` `'danger'` → `'error'` (also `ModalService.confirm({ tone })`);
21
+ `SplitButtonItem.danger` → `.error`. Public tokens renamed in lockstep:
22
+ `--ds-menu-item-danger-label-color` → `--ds-menu-item-error-label-color` and
23
+ `--ds-progress-bar-color-warn` → `--ds-progress-bar-color-warning`. CSS state classes and every
24
+ default value are otherwise unchanged.
25
+ - **Event outputs renamed to past-participle (consistent event naming).** Dismissal events unified
26
+ to `closed`: `ds-alert` / `ds-banner` / `ds-toast` `(dismissed)` → `(closed)`. Action events made
27
+ past-tense: `ds-table` `(rowClick)` → `(rowClicked)`, `ds-stepper` `(stepClick)` →
28
+ `(stepClicked)`, `ds-calendar-day` `(daySelect)` → `(daySelected)`, `ds-tabs` `(tabClose)` →
29
+ `(tabClosed)`, `ds-tree` `(nodeSelect)` → `(nodeSelected)`, `ds-split-button` `(itemSelect)` →
30
+ `(itemSelected)`.
31
+ - **`ds-progress` — `indeterminate` is now a boolean input, not a `variant` value.** The animation
32
+ mode was conflated with the colour variant (a bar could not be `success`-coloured *and*
33
+ indeterminate). Migration: `<ds-progress variant="indeterminate" />` →
34
+ `<ds-progress indeterminate />`; `'indeterminate'` removed from `ProgressVariant`.
35
+ - **`ds-badge` / `ds-status-dot` status API redesigned — factory statuses replaced by a
36
+ consumer-defined registry.** `ds-badge`'s `[variant]` input (`BadgeVariant`) is replaced by
37
+ `[status]` (typed `DsStatusKey`); `ds-status-dot`'s `[status]` is retyped `StatusValue` →
38
+ `DsStatusKey` and no longer defaults to `'planning'`. Both now render the value as a `data-status`
39
+ attribute instead of a factory CSS class, so the built-in per-status rules (`.badge.planning` /
40
+ `.active` / `.confirmed` / `.completed` / `.info` / `.success` / `.warning` / `.error` /
41
+ `.neutral` / `.secondary`, plus the matching `.status-dot.*`) and the factory `--status-*`
42
+ lifecycle theme tokens (`--status-planning-bg-color`, `--status-confirmed-*`, `--status-active-*`,
43
+ `--status-completed-*`) are all removed. The exported types `BadgeVariant`, `BadgeLifecycle`,
44
+ `BadgeSemantic`, and `StatusValue` are removed. Migrate `variant="active"` → `status="active"`,
45
+ then define your own status colours via the new `styles/status` SCSS API (see Added) keyed on
46
+ `[data-status]`. `[count]` mode, `[solid]`, `[withDot]`, `[max]`, and the `--ds-badge-*` /
47
+ `--ds-status-dot-*` hooks are unchanged.
48
+ - **`title` is now required on `ds-drawer`, `ds-bottom-sheet`, and `ds-accordion-item`** (was
49
+ optional). Their `title` is the component's accessible name (dialog `aria-labelledby`) or the
50
+ disclosure-button label, so a missing title left them unnamed. `ds-modal` / `ds-modal-card` stay
51
+ required (unchanged); `ds-page-header` is now **optional** (its `title` is a plain `<h1>`, not an
52
+ accessible-name dependency — a non-breaking loosening).
53
+ - **Default `secondary` / `tertiary` hues now diverge from `primary`.** Previously both roles
54
+ defaulted to the `--primary` channels, so an un-branded app rendered `primary`, `secondary`, and
55
+ `tertiary` as the same blue. They now default to distinct palette families — `--secondary-h/s/l` →
56
+ `--orange-h/s/l` (warm orange) and `--tertiary-h/s/l` → `--violet-h/s/l` (cool violet), in both
57
+ light and dark themes. Consumers who already set `--secondary-h/s/l` / `--tertiary-h/s/l` per brand
58
+ are unaffected; to keep the old single-hue look, point those channels back at `--primary-h/s/l`.
59
+ - **`--static-white` theme token removed.** The fixed-value `--static-white` custom property is gone;
60
+ its uses now emit the literal `white`. No visual change, but a consumer who referenced
61
+ `var(--static-white)` must replace it with `white` (`--static-ink` is retained).
62
+
63
+ ### Added
64
+
65
+ - **`DsStatus` type export** — `'info' | 'success' | 'warning' | 'error'`, the shared status
66
+ vocabulary used across status-bearing components.
67
+ - **`ds-progress` `[indeterminate]` boolean input** — orthogonal to `variant` (see Breaking).
68
+ - **`DividerSpacing` is now exported** from the public API (the `ds-divider` `[spacing]` input type
69
+ was previously declared but not re-exported).
70
+ - **Extensible status system — `DsStatusRegistry` / `DsStatusKey` + `styles/status` SCSS API.** New
71
+ public exports: `DsStatusRegistry` (an empty interface consumers augment via declaration merging to
72
+ register their own status keys) and `DsStatusKey` (an open `string` until the registry is augmented,
73
+ then a union of the registered keys — the type of `ds-badge` / `ds-status-dot` `[status]`). A new
74
+ SCSS entry point `@use '@ids-group-ltd/ids-design-system/styles/status'` exposes `define($map)` —
75
+ wires `[data-status]` selectors to the `--ds-badge-*` / `--ds-status-dot-*` tokens from a Sass map
76
+ of `name: (bg:, text?:, dot?:)` — and `semantic-preset`, a ready-made `info` / `success` /
77
+ `warning` / `error` / `neutral` set. This is the replacement for the removed factory statuses (see
78
+ Breaking).
79
+
80
+ ### Changed
81
+
82
+ - **Press-feedback reworked — no button-style press on non-buttons.** The `:active` scale+brightness
83
+ press was removed from the overlay field triggers `ds-autocomplete` / `ds-select` /
84
+ `ds-multi-select` (opening the panel is the feedback). List/menu rows and the color-picker trigger
85
+ (`ds-menu-item`, `ds-list`, `ds-tree`, `ds-accordion` header, `ds-color-picker`) swap the scale for a
86
+ flat rounded `:active` background. Press-scale stays on buttons and compact actionable controls
87
+ (`ds-button`, `ds-calendar-day`, `ds-pagination`, `ds-tabs`, `ds-segmented`, `ds-toggle-button`,
88
+ `ds-sidenav-item`, checkbox / radio / switch). Small icon action buttons — close / dismiss /
89
+ clear / remove `×`, plus the `ds-tag` chip close (used by autocomplete & multi-select chips) — now
90
+ consistently get the button press-scale too (they previously had no `:active` feedback, or only a
91
+ flat tint).
92
+ - **`ds-date-picker` keeps the format mask visible while typing.** In manual-input mode the unfilled
93
+ tail of the date mask now stays on-screen as a muted ghost (after typing `12/` the field reads
94
+ `12/DD/YYYY`) instead of the placeholder vanishing on the first keystroke. The typed value renders
95
+ in the monospace font so digits land exactly on the mask's `D`/`M`/`Y` positions and the tail never
96
+ shifts as you type.
97
+
98
+ ### Fixed
99
+
100
+ - **Boolean attribute coercion on all boolean inputs.** ~54 boolean inputs across ~30 components
101
+ gained `transform: booleanAttribute`, so a bare or string attribute (`<ds-x required>` /
102
+ `disabled="false"`) now coerces correctly instead of being read as a truthy string. Property-
103
+ binding consumers are unaffected.
104
+ - **`ds-button` tonal fill — `:active` now darkens past `:hover`.** The `tonal` variant reused the
105
+ same token (`--c-muted-strong`) for both hover and active, so the pressed background was identical
106
+ to hover; active now mixes that tint ~10% toward black for a distinct pressed step.
107
+ - **Per-instance overlay panel token overrides now reach the portaled pane.** `--ds-*` panel tokens
108
+ set on the host of `ds-autocomplete`, `ds-multi-select`, `ds-date-picker`, `ds-color-picker`,
109
+ `ds-popover`, and `ds-time-picker` were ignored because the panel renders in a CDK overlay
110
+ (portaled outside `:host`, where the custom properties no longer inherit); the host's resolved
111
+ panel tokens are now forwarded onto the overlay element on open. (`ds-select` uses the shared
112
+ global panel class and was never affected.)
113
+ - **`ds-autocomplete` / `ds-multi-select` panels no longer render transparent.** Their internal panel
114
+ colour resolvers were declared on `:host`, but the panel is portaled — so the background collapsed
115
+ to transparent (page content bled through) with broken hover/active highlighting; the resolvers now
116
+ sit on the panel element itself.
117
+ - **`ds-tabs` `secondary` variant now applies.** The secondary-toned active indicator and label were
118
+ keyed off `.tabs.secondary`, but the variant class lands on the host, so the selector never
119
+ matched; rewritten to `:host(.secondary)`.
120
+ - **`ds-date-picker` range mask no longer clips the second date**, and the trigger's value-to-icon
121
+ gap is tightened to 4px. The field now reserves an extra character of width so the wider range-mode
122
+ mask (two dates) is no longer cut off.
123
+ - **`ultra-compact` density tier gained full token coverage.** `[data-density="ultra-compact"]` now
124
+ also scales avatar size, sidenav width, badge / status-dot sizes, and switch geometry — previously
125
+ left at the cozy defaults, so those controls didn't shrink with the tier.
126
+
127
+ ## 0.5.0 — 2026-07-08
128
+
129
+ ### Breaking
130
+
131
+ - **`ds-combobox` renamed to `ds-autocomplete`.** The clearer industry name for the editable
132
+ type-to-pick control (MUI's term); "combobox" survives only as the ARIA role — which the
133
+ select-only `ds-select` trigger also carries. Renames: selector `ds-combobox` →
134
+ `ds-autocomplete`; `ComboboxComponent` → `AutocompleteComponent`; exported types
135
+ `ComboboxOption` / `ComboboxOptionGroup` / `ComboboxSize` / `ComboboxWidth` →
136
+ `AutocompleteOption` / `AutocompleteOptionGroup` / `AutocompleteSize` / `AutocompleteWidth`;
137
+ public tokens `--ds-combobox-focus-shadow` / `--ds-combobox-maxw` / `--ds-combobox-input-minw`
138
+ → `--ds-autocomplete-*`; docs anchor `#combobox` → `#autocomplete`. Behavior unchanged.
139
+ - **`ds-dropdown` removed — use `ds-select`.** The two were near-identical select-only single
140
+ pickers (same trigger, same panel, same keyboard model); `ds-select` is the richer canonical
141
+ form field (`ControlValueAccessor`, `invalid` + `hint` via `ds-field-message`, `required` /
142
+ `optional`, per-option icons, group-level `disabled`). Migration: `<ds-dropdown>` →
143
+ `<ds-select>`; `[error]` → `[invalid]`; `[optionGroups]="groups"` → pass groups inline in
144
+ `[options]` (`SelectItem = SelectOption | SelectOptionGroup`); `DropdownOption` /
145
+ `DropdownOptionGroup` / `DropdownSize` → `SelectOption` / `SelectOptionGroup` / `SelectSize`.
146
+ `readOnly` moved to `ds-select` (see Added). Docs "Dropdown" section removed — the Select
147
+ section covers everything.
148
+ - **Public token prefixes normalized to match the selector (not aliased).** Four components had
149
+ their `--ds-*` token name fragments hyphenated to align with the Angular selector; the old
150
+ concatenated names silently stop resolving, so consumers who override any of these must rename.
151
+ `--ds-datepicker-*` → `--ds-date-picker-*` (~14 tokens: `bg-color`, `border`, `shadow`, `width`,
152
+ `trigger-bg-color`, `trigger-border-color`, `day-hover-bg-color`, `day-today-label-color`,
153
+ `day-selected-*`, `day-range-*`, `day-disabled-label-color`); `--ds-statusdot-*` →
154
+ `--ds-status-dot-*` (`color`, `size`); `--ds-pagehdr-*` → `--ds-page-header-*` (~10 tokens:
155
+ eyebrow / title / subtitle / meta / crumb text colors, `meta-icon-color`, `divider`, `title-fs`,
156
+ `title-gap`); `--ds-avatargroup-*` → `--ds-avatar-group-*` (`overlap`, `ring`, `overflow-bg-color`,
157
+ `overflow-label-color`). Only the names changed — the CSS property each feeds and every default
158
+ value are byte-identical; purely a naming-consistency fix.
159
+
160
+ ### Added
161
+
162
+ - **New `ds-time-picker` component.** A time field (HH:MM) that opens column wheels
163
+ (Hours / Minutes, plus AM·PM in 12-hour mode) in a CDK overlay. Value is a canonical
164
+ 24-hour `"HH:MM"` string; **24h vs 12h display is chosen app-wide** via
165
+ `provideDsConfig({ timePicker: { format: '12h' } })` (per-instance `[format]` override
166
+ available). Supports `[minuteStep]`, `[minTime]` / `[maxTime]` + a `[disabledTime]`
167
+ predicate, `single` and `range` modes (`[(value)]` is a `"HH:MM"` string or a
168
+ `[start, end]` tuple), `clearable`, `size` (`sm` / `md` / `lg`), and reactive forms
169
+ (`ControlValueAccessor`) with `invalid` / `hint` via `ds-field-message`. Full keyboard
170
+ support (roving arrows per column, Home/End, Escape). Exports `TimePickerComponent`,
171
+ `TimePickerMode`, `TimePickerSize`, `TimeFormat`, `TimeValue`, `TimeRangeValue`,
172
+ `TimePickerValue`; new `DsConfig.timePicker.format`; public `--ds-time-picker-*` hooks.
173
+ - **Selection controls gain `size` + `required`.** `ds-checkbox` / `ds-radio` / `ds-switch`
174
+ take a `size` input (`sm` / `md` / `lg`; `md` unchanged and still density-responsive) and
175
+ a `required` input (adds `aria-required` + a `*` marker on the inline `[label]`). `ds-radio`
176
+ (standalone) also gains `invalid` + `hint` via `ds-field-message`, matching checkbox/switch.
177
+ New exported `CheckboxSize` / `RadioSize` / `SwitchSize`.
178
+ - **`ds-input` / `ds-textarea` character counter.** New `[maxLength]` caps input and renders a
179
+ live `"n/max"` counter beside the hint. `ds-textarea` also gains `[readOnly]` (mirrors input).
180
+ - **`ds-date-picker` day-level constraints + presets.** New `[minDate]` / `[maxDate]` (disable
181
+ out-of-range days, inclusive), `[disabledDate]` predicate (disable arbitrary days), and
182
+ `[presets]` (`DatePickerPreset[]` — quick-pick buttons in the calendar panel). Disabled days
183
+ aren't selectable by click or keyboard. New exported `DatePickerPreset`.
184
+ - **Dropdown-family enhancements.** `ds-select` gains `clearable` + per-option `icon`
185
+ (`SelectOption.icon`) + `readOnly` (non-interactive filled look, ported from the removed
186
+ `ds-dropdown`); `ds-autocomplete` gains `[optionGroups]` + `[allowCreate]` with a "Create …" row
187
+ and a `(create)` output. New exported `AutocompleteOptionGroup`. (Native multi on `ds-select`
188
+ intentionally omitted — use `ds-multi-select`.)
189
+ - **`ds-table` expandable rows.** New `[expandableRows]`, `[(expandedIds)]` (`Set<string>`) and
190
+ `[rowExpandTemplate]` — a chevron toggle per row reveals a full-width detail row (works with
191
+ selection, sticky first column, and pagination).
192
+ - **Overlay dialogs.** `ds-modal` gains `[closeOnBackdrop]` (opt-out) + `[persistent]` (neither
193
+ backdrop nor Escape dismisses) + `xl` / `fullscreen` sizes. `ds-drawer` gains `[placement]`
194
+ (`right` / `left` / `top` / `bottom`) + `sm` size (new `DrawerPlacement`). `ds-bottom-sheet`
195
+ gains `[snapPoints]` (fractions of viewport height; drag snaps to the nearest, below-lowest closes).
196
+ - **`ds-toast` promise / loading / maxVisible.** New `'loading'` variant (spinner, no auto-dismiss)
197
+ and `ToastService.promise(p, { loading, success, error })` (updates the toast in place on settle);
198
+ `DsToastConfig.maxVisible` caps concurrent toasts and queues the rest.
199
+ - **`ds-menu` dividers + submenus.** New `ds-menu-divider` (`role="separator"`) and nested submenus
200
+ via `ds-menu-item [submenu]` (opens on hover / ArrowRight, closes on ArrowLeft / Escape).
201
+ - **`ds-popover` arrow + placement.** New `[arrow]` caret and `[placement]`
202
+ (`top` / `bottom` / `left` / `right`, new `PopoverPlacement`); the existing `align` stays the
203
+ cross-axis alignment.
204
+ - **`ds-tabs` lazy / scrollable / closable / vertical.** New `[lazy]` (defer panel content until
205
+ first shown), `[scrollable]` (horizontal-scroll strip), `[closable]` (per-tab close with a
206
+ `(tabClose)` output), and `[orientation]` (`horizontal` / `vertical`, new `TabsOrientation`;
207
+ roving arrows follow the axis).
208
+ - **`ds-accordion` single-open + item `disabled`.** New `[multi]` (default `true`; `false` = only
209
+ one item open at a time via a parent coordinator) and `[disabled]` on `ds-accordion-item`.
210
+ - **`ds-stepper` clickable / error / vertical.** New `[clickable]` + `(stepClick)`, `[errorSteps]`
211
+ (indices rendered in an error state), and `[orientation]` (`horizontal` / `vertical`, new
212
+ `StepperOrientation`).
213
+ - **`ds-sidenav-item` collapsed tooltip.** When the sidenav is collapsed, hovering/focusing an item
214
+ shows its label as a tooltip.
215
+ - **`ds-badge` numeric count.** New `[count]` + `[max]` (default 99) render a count with `"max+"`
216
+ overflow and an accessible label.
217
+ - **`ds-avatar` status dot + fallback icon.** New `[status]` (`online` / `offline` / `away` /
218
+ `busy`, new `AvatarStatus`) shows a corner status dot, and `[fallbackIcon]` renders when there's
219
+ no image or initials.
220
+ - **`ds-autocomplete` content-width mode.** New `width` input (`fill` — default, stretches to the
221
+ container as before / `content` — the trigger hugs its chips/value plus a minimum typing area,
222
+ for filter toolbars; the panel then sizes to its options with the trigger width as the floor).
223
+ New public hooks `--ds-autocomplete-input-minw` (typing-area minimum, default 80px) and
224
+ `--ds-autocomplete-maxw` (trigger cap, default none; in `content` mode defaults to 100% so chips
225
+ wrap at the parent edge). New exported `AutocompleteWidth`.
226
+ - **`ds-date-picker` localization + manual entry.** New `locale` (BCP-47) drives month names,
227
+ weekday headers and the value format together via `Intl` (no more OS-locale mixing); `dateFormat`
228
+ pins an explicit token order (e.g. `MM/DD/YYYY`); `firstDayOfWeek` (0–6, default Monday) shifts the
229
+ week; `defaultMonth` opens the panel near a realistic date when the value is empty (e.g. a Date Of
230
+ Birth). Manual masked entry is now available (`allowInput`, default `true`): the field enforces
231
+ the locale mask, rejects non-numeric input, hard-caps each segment (so a year can't exceed four
232
+ digits), and flags impossible/out-of-range dates on blur; range mode uses one combined field
233
+ (`MM/DD/YYYY – MM/DD/YYYY` in a single input). Clicking the field or the trailing calendar icon
234
+ opens the panel. New `DsConfig.datePicker` ({ `locale`, `dateFormat`, `firstDayOfWeek` }).
235
+ The panel follows the APG date-picker-dialog pattern: `role="dialog"` (aria-modal, labelled,
236
+ focus-trapped, Escape to close) over a `role="grid"` of labelled `columnheader`/`gridcell`s, each
237
+ day carrying a full-date accessible name; out-of-range days are `aria-disabled` yet stay
238
+ keyboard-reachable, and month/year navigation is announced via a polite live region. Masked entry
239
+ edits at the caret (insert/backspace hop over the mask separators).
240
+ - **Public `--ds-*` customization token sweep across ~44 components.** Components/sub-components that
241
+ previously had no public token API (or only a shallow one) now expose per-instance/theme knobs —
242
+ spinner, skeleton, progress, divider, accordion, page-footer, tooltip, w3w, drawer, popover, menu
243
+ (+ item + divider), checkbox, radio, switch, slider, segmented, toggle-button, stepper, select,
244
+ autocomplete, multi-select, date-picker, time-picker, otp-input, number-stepper, bottom-sheet, list,
245
+ loading-overlay, split-button, tree, avatar-group, description-list, dropzone, modal, page-header,
246
+ tabs, tag, timeline, toast, topbar, avatar, color-picker, icon-button, input, empty-state — bringing
247
+ drawer / popover / tooltip up to the same depth as modal / card. Roughly 160–180 new names,
248
+ predominantly color (surface/background, border, text/label, icon, accent, plus hover/selected/focus/
249
+ active states) with secondary sizing (height, width, max-width/height, radius, padding, shadow,
250
+ font-size). Each is a `--_x: var(--ds-x, <role-token>)` resolver whose default equals the existing
251
+ role token, so it is purely additive — zero visual change for consumers who set nothing.
252
+
253
+ ### Changed
254
+
255
+ - **`ds-search` inner input class renamed `.input` → `.search-input`.** The over-generic name let
256
+ consumer global `.input` styles/resets leak into the component through emulated encapsulation
257
+ (root cause of the PIN-475 double-focus-ring). Only consumer styling that targeted the
258
+ undocumented internal class is affected.
259
+ - **`ds-date-picker` trigger is now a text input by default.** Manual masked entry is on
260
+ (`allowInput` defaults to `true`), so the trigger renders as an editable field with a trailing
261
+ calendar icon (single and range) instead of a plain button. Pass `[allowInput]="false"` for a
262
+ read-only field that opens the calendar on click but rejects typing. The field also sizes to its
263
+ content width now (was full-width) — set a width on the host to stretch it. The selected-date
264
+ display is locale-pinned (was the ambient `toLocaleDateString()`), and month/weekday names are
265
+ localized together via the new `locale`.
266
+ - **`ds-search` fills its container by default.** Default `max-width` changed from `320px` to `none` —
267
+ `ds-search` now stretches to `width: 100%` like the rest of the field family (input / select /
268
+ textarea) instead of being capped at 320px. New public `--ds-search-maxw` override token (default
269
+ `none`) to opt back into a fixed cap, e.g. `ds-search { --ds-search-maxw: 320px }`.
270
+ - **Rounded press feedback + native tap-highlight suppression.** Interactive controls now show a
271
+ rounded `:active` press state (`filter: brightness(0.9)` + `transform: scale(0.97)`) that follows
272
+ each control's own border-radius/shape rather than a square box-shadow/background overlay — applied
273
+ across interactive controls (accordion-item, calendar-day, checkbox, color-picker, list-item,
274
+ menu-item, multi-select, pagination, radio, segmented, select, sidenav-item, switch, tabs,
275
+ toggle-button, tree, autocomplete), skipped on disabled controls. New per-component tuning tokens
276
+ `--ds-press-brightness` (default 0.9) and `--ds-press-scale` (default 0.97). The native Android-Chrome
277
+ rectangular tap-highlight overlay (which ignored border-radius and protruded square corners past
278
+ pill/rounded shapes) is now suppressed globally, the rounded press state replacing it.
279
+ Visual/interaction refinement only — no Angular API change.
280
+
281
+ ### Fixed
282
+
283
+ - **Accessibility hardening across overlays, pickers, fields and cards.** `ds-bottom-sheet` now
284
+ carries full dialog semantics (`role="dialog"` + `aria-modal`, labelled by its title, focus-trapped
285
+ on open). `ds-select` / `ds-autocomplete` close their panel on Tab (focus then moves on naturally) and
286
+ drop their listbox options out of the tab order (`tabindex="-1"`); `ds-autocomplete`'s "No matches" row
287
+ is announced via `role="status"`. `ds-field-message` renders its error line as a fresh node so
288
+ `role="alert"` reliably re-announces (toggling the role onto an existing node did not). `ds-number-stepper`
289
+ labels its −/+ buttons and gains a new `[ariaLabel]` input to name the field itself; the `ds-avatar-group`
290
+ "+N" overflow chip gets an accessible label; `ds-sidenav-item` exposes its label via `aria-label` only
291
+ when collapsed (icon-only). `ds-card` is keyboard-activatable (Enter / Space, with `role="button"` +
292
+ `tabindex`) when `elevation="interactive"`, and closable `ds-tabs` remove the focused tab on Delete (APG).
293
+
294
+ ## 0.4.0 — 2026-06-30
295
+
296
+ ### Added
297
+
298
+ #### New components
299
+
300
+ - **`ds-multi-select`** — multi-value dropdown that renders selections as chips, with an
301
+ in-panel text filter, a checkbox listbox (active-descendant keyboard nav), an opt-in
302
+ `selectAll` row with indeterminate state, and `maxVisibleChips` "+N more" collapsing.
303
+ Reactive-forms (`ControlValueAccessor`) + `[(value)]` (`string[]`), plus `invalid` /
304
+ `hint` / `disabled`. Exports `MultiSelectComponent`, `MultiSelectOption`.
305
+ - **`ds-slider`** — single-thumb or two-thumb `range` slider with `min` / `max` / `step`,
306
+ pointer drag and full keyboard control (Arrow / PageUp-Down / Home / End). CVA +
307
+ `[(value)]` (`number` or `[number, number]`), plus `invalid` / `hint` / `disabled`.
308
+ - **`ds-otp-input`** — one-time-code field with per-character cells, auto-advance, paste
309
+ distribution, configurable `length`, `numeric` / `alphanumeric` `mode`, optional `mask`,
310
+ and a `completed` output. CVA + `[(value)]` (`string`), plus `invalid` / `hint` /
311
+ `disabled`. Exports `OtpInputComponent`, `OtpMode`.
312
+ - **`ds-color-picker`** — Photoshop-style picker (2D saturation/value plane + hue slider +
313
+ hex field + preset swatches), panel portaled via CDK Overlay. CVA + `[(value)]` (hex
314
+ `string`), plus `presets`, `invalid` / `hint` / `disabled`.
315
+ - **`ds-tree`** — data-driven tree-view (`nodes: TreeNode[]` with recursive `children`),
316
+ roving-tabindex keyboard nav (Arrow / Home / End; Right expands, Left collapses),
317
+ `[(expandedIds)]` (`Set<string>`), `[(selectedId)]`, and a `nodeSelect` output. Exports
318
+ `TreeComponent`, `TreeNode`.
319
+ - **`ds-segmented`** — single-select segmented control (`role="radiogroup"`, roving
320
+ tabindex), data-driven via `options: SegmentedOption[]` with `[(value)]`. A value toggle —
321
+ unlike `ds-tabs` it owns no panels. Exports `SegmentedComponent`, `SegmentedOption`.
322
+ - **`ds-button-group`** — `role="group"` wrapper that visually joins projected
323
+ `<ds-button>` children into one segmented row.
324
+ - **`ds-split-button`** — a primary action plus an attached dropdown of secondary actions
325
+ (`menuItems: SplitButtonItem[]`), built on `ds-popover` + `ds-menu`; emits `pressed`
326
+ (main) and `itemSelect`. Exports `SplitButtonComponent`, `SplitButtonItem`,
327
+ `SplitButtonVariant`.
328
+ - **`ds-toggle-button`** — standalone on/off button with `[(pressed)]` (sets `aria-pressed`)
329
+ and an optional `icon`.
330
+ - **`ds-list` / `ds-list-item`** — semantic list (`role="list"`) with optional `dividers`;
331
+ each item has `title` / `subtitle` text, `[leading]` / `[trailing]` slots, and optional
332
+ `clickable` (emits `activated`) with `selected` / `disabled` states.
333
+ - **`ds-timeline` / `ds-timeline-item`** — vertical activity feed; each item has a
334
+ `heading`, `time`, an optional node `icon`, and a `tone`
335
+ (`default` | `primary` | `success` | `warning` | `error` | `muted`). Exports
336
+ `TimelineTone`.
337
+ - **`ds-description-list` / `ds-description-item`** — term/definition pairs with
338
+ `horizontal` | `stacked` `orientation`; each item takes a `term` and optional `copyValue`
339
+ (renders a copy-to-clipboard button). Exports `DescriptionListOrientation`.
340
+ - **`ds-stack` / `ds-inline` / `ds-container` layout primitives.** `ds-stack` (column) and
341
+ `ds-inline` (row, wraps by default) take a named `gap` (`none … xl`) + `align` /
342
+ `justify`; `ds-container` centres content at a named `size`
343
+ (`sm` | `md` | `lg` | `xl` | `full`). Adds semantic `--space-stack` / `--space-inline`
344
+ spacing aliases plus per-primitive `--ds-stack-gap` / `--ds-inline-gap` /
345
+ `--ds-container-max` / `--ds-container-pad-x` hooks. Exports `LayoutGap`, `LayoutAlign`,
346
+ `LayoutJustify`, `ContainerSize`.
347
+ - **`ds-loading-overlay`** — region scrim with a centred spinner + optional `label`,
348
+ toggled by `loading`, with `blur`, `spinnerSize` and an `insetTop` offset (clears a
349
+ sticky header). `ds-table` and `ds-empty-state` now render their loading state through it.
350
+ - **New `ds-radio-group` component.** A CVA-capable `<ds-radio-group [(value)] name invalid hint label>`
351
+ wrapper that projects `<ds-radio value="…">` children. Manages roving-tabindex keyboard navigation
352
+ and implements `ControlValueAccessor` for reactive-forms use. Standalone `<ds-radio [(checked)]>` is
353
+ unaffected and still works for non-group usage.
354
+ - **New `ds-alert` component.** Lightweight inline status message with five variants (`info`, `success`,
355
+ `warning`, `error`, `neutral`), an optional `title`, an optional dismiss button (`[dismissible]`),
356
+ a named `[actions]` slot for follow-up CTAs, a custom `icon` override, and a `(dismissed)` output.
357
+ Smaller and less prominent than `ds-banner` — intended for contextual form/page feedback rather than
358
+ page-level announcements.
359
+
360
+ #### Theming & colour
361
+
362
+ - **`ds-color` scoped-accent system.** A new `--accent-*` pointer layer lets any subtree be
363
+ recoloured to a different hue family without per-component overrides. Set it via the
364
+ `[ds-color="secondary | tertiary | error | success | warning"]` attribute on a zone
365
+ container or a component host, or from SCSS with the `ds.color(<family>)` mixin
366
+ (`@use '@ids-group-ltd/ids-design-system/styles/ds' as ds;`). Components route their accent
367
+ (fills, focus rings, surface tint) through `--accent` / `--accent-strong` / `--accent-muted`
368
+ / `--accent-muted-strong` / `--accent-on` / `--accent-pressed` / `--accent-focus-ring` /
369
+ `--accent-focus-field`; `ds-button` / `ds-icon-button` flip the same pointers per instance
370
+ via their `color` input. Ships in the default bundle (forwarded by `styles/ds`) — additive,
371
+ the default (primary) theme is unchanged pixel-for-pixel. Caveat: CDK-portaled overlays
372
+ (dropdown / select / combobox / date-picker / color-picker / popover / tooltip / toast /
373
+ modal panels) render outside the zone subtree, so set `ds-color` on the panel itself to
374
+ recolour them.
375
+ - **`--*-muted-strong` semantic roles** for `secondary` / `tertiary` / `error` / `success` /
376
+ `warning` (a denser muted step between `-muted` and the strong tone), plus per-family focus
377
+ rings (`--focus-ring-*` / `--focus-field-*`) and `-pressed` / `-on` aliases so every
378
+ ds-color family can resolve the full accent pointer set.
379
+ - **`ds-icon-button` colour axis.** Gains a `color` input (shared `ButtonColor` type, default
380
+ `primary`); `variant` stays the fill axis (`standard` | `filled` | `tonal` | `outlined`).
381
+ Additive — existing usage is unchanged.
382
+ - **Dark theme** (`themes/dark/`) — ships with the default bundle (`@use 'styles/ds'`).
383
+ **Light is the default** (no attribute); dark is opt-in via `<html data-theme="dark">`. There is
384
+ no automatic `prefers-color-scheme` switch — to follow the OS, opt in at the app root with the new
385
+ **`provideDsTheme({ followSystem: true })`** provider. Each theme declares `color-scheme` so native
386
+ UI (scrollbars, form controls) matches. Adds theme-stable `--static-white` / `--static-ink` tokens
387
+ so on-fill text keeps correct contrast across themes. Non-breaking — additive, light output unchanged.
388
+ Light and dark are **sibling themes** — a shared base palette (`themes/_base-palette`) + a shared
389
+ role map (`themes/_semantic`); light applies at `:root`, dark at `:root[data-theme='dark']` (the
390
+ dark block declares the complete token set, so it fully replaces light, not patches it).
391
+ `data-neutrals="brand"` is a light-context switch; brand overlays are authored on light. Dark also
392
+ ships its own chart tokens (sequential / divergent ramps + hover/tooltip surfaces); combining
393
+ `data-neutrals="brand"` with dark is a documented no-op for the brand grey tint (dark neutrals win).
394
+
395
+ #### Forms & fields
396
+
397
+ - **Reactive-forms (`ControlValueAccessor`) on `ds-checkbox`, `ds-switch`, `ds-combobox`, and
398
+ `ds-date-picker`.** Each control now works with `[(ngModel)]` and `formControl` / `formControlName`
399
+ out of the box. New `invalid` / `hint` inputs render an associated `ds-field-message` below the
400
+ control. `ds-combobox` and `ds-date-picker` also gain a new `disabled` input for template-driven
401
+ disable (previously only the forms layer could disable them). `ds-switch` gains `role="switch"`.
402
+ - **`hint` and `invalid` on `ds-select`.** The pre-existing dropdown can now render an
403
+ associated helper/error line (wired via `aria-describedby` + `role="alert"` on error)
404
+ through the shared internal `ds-field-message`; `ds-input` / `ds-textarea` render their hint
405
+ through the same component (the `--ds-input-hint-*` tokens are replaced by
406
+ `--ds-field-message-*` — see Breaking). The new field components above ship with `invalid` /
407
+ `hint` built in.
408
+ - **Inline `[label]` on `ds-checkbox` / `ds-radio` / `ds-switch`** — render the control label
409
+ without hand-writing a `<label for>`; `ds-radio-group` accepts a group `label` too.
410
+ - **`ds-input` `[loading]` and `[floating]`.** `loading` shows a trailing spinner while the
411
+ field stays editable (pair with a `hint` for async validation); `floating` switches to a
412
+ floating-label layout.
413
+ - **`--field-label-gap` token** (single source for label↔control and control↔hint vertical
414
+ rhythm, defaults to `--space-1-5`); every field control now routes its spacing through it.
415
+
416
+ #### Components — new capabilities
417
+
418
+ - **`ds-button` overlay-trigger support.** New `ariaHasPopup` / `ariaExpanded` inputs
419
+ (forwarded to the native `<button>`) and an exported `buttonRef` for positioning a
420
+ popover/menu and returning focus.
421
+ - **`ds-date-picker` month & year grid pickers** in the calendar header — click the
422
+ month/year labels to pick from a compact grid (years in a paged 12-cell grid) instead of
423
+ stepping month-by-month.
424
+ - **`ds-table` pagination, client-side sort & sticky first column** (absorbed from the
425
+ prototype data-grid): new `pageSize` / `page` / `pageSizeOptions`, `clientSort`,
426
+ `stickyFirstColumn`, plus `cellTemplateMap` / `emptyTemplate` for wrapper components.
427
+ - **`ModalService.confirm(options): Promise<boolean>`** — promise-based confirmation dialog
428
+ rendered as a modal card (`ModalConfirmOptions`: `title`, `message`, labels, `tone`, `icon`,
429
+ and `typeToConfirm` to gate destructive actions). Resolves `false` on cancel / backdrop /
430
+ Escape.
431
+ - **`ds-dropzone` per-file `message` and `queued` state.** `DropzoneFile` gains an optional
432
+ `message` (shown in place of the bare state name) and a `'queued'` value in
433
+ `DropzoneFileState`.
434
+
435
+ #### Tokens & build
436
+
437
+ - **`$bp-*` breakpoint Sass aliases + `up()` / `down()` mixins** (`styles/breakpoints`).
438
+ CSS custom properties can't be used in `@media` conditions, so the `--bp-*` scale was
439
+ unusable there. A new partial is now the single source for both representations: it emits
440
+ `--bp-*` (values unchanged) and exposes compile-time `$bp-xs … $bp-2xl` plus the mixins
441
+ `bp.up(md)` (`width >= 768px`) / `bp.down(sm)` (`width < 640px`), via
442
+ `@use 'breakpoints' as bp;`. Heads-up: advanced consumers importing `styles/tokens` à la
443
+ carte now also need `styles/breakpoints` for `--bp-*`; the `styles/ds` entry forwards both.
444
+ - **`--ds-button-border-disabled`** and **`--ds-icon-button-bg-color-disabled` /
445
+ `-icon-color-disabled` / `-border-disabled`** override tokens — the disabled
446
+ fill/label/border are now individually themeable (previously only button had
447
+ `bg-color`/`label-color-disabled`; icon-button had none).
448
+ - **`--ds-button-press-scale`** (default `0.98`) and **`--ds-icon-button-press-scale`**
449
+ (default `0.96`) — tune the press scale-down (set `1` to disable).
450
+
451
+ ### Breaking
452
+
453
+ - **`ds-button` now takes two orthogonal axes — `color` × `variant` — replacing the single
454
+ conflated `variant` input.** `color` is the hue family
455
+ (`primary` | `secondary` | `tertiary` | `neutral` | `error` | `success` | `warning`,
456
+ default `primary`); `variant` is the fill style
457
+ (`solid` | `tonal` | `ghost` | `outline` | `text`, default `solid`). The old single axis
458
+ mixed hue and emphasis — migrate as: `primary` → default (drop the attr); `secondary` →
459
+ `variant="tonal"`; `tertiary` → `variant="ghost"`; `outline` →
460
+ `color="neutral" variant="outline"`; `error` / `success` / `warning` →
461
+ `color="error|success|warning"`; `text` → `variant="text"`. New exported `ButtonColor` /
462
+ `ButtonVariant` types. `text` still renders but is **discouraged** (dev-mode `console.warn`
463
+ — prefer the global `.link` class); a small set of low-contrast `color × variant` combos
464
+ (e.g. `neutral` solid, `success` / `warning` ghost/outline) render with a discouraged ⚠
465
+ marker rather than being banned. Each instance flips the internal `--c-*` accent slots,
466
+ which now default to the `--accent-*` pointer layer (see ds-color).
467
+ - **Reactive-forms radio now uses `<ds-radio-group>` as the group container and form control.**
468
+ Standalone `<ds-radio [(checked)]>` continues to work for non-group usage, but a group of
469
+ radios that participates in a reactive form should now be wrapped in `<ds-radio-group>`.
470
+ - **`ButtonSize` collapsed to `sm | md | lg`** (32 / 40 / 48 px), dropping the duplicate
471
+ legacy `s | m | l` tier. Default is now `md` (was `l` — same 40 px). Migration:
472
+ `m` → `sm` (both 32), `l` → `md` (both 40); the 24 px `s` is removed — its callers move to
473
+ `sm` (32 px). Aligns button with input / select / date-picker / icon-button.
474
+ - **Removed `--ds-input-hint-color` / `--ds-input-hint-fs`.** Field helper/error text is now
475
+ rendered by the shared `ds-field-message`; tune its neutral colour and size via the new
476
+ `--ds-field-message-color` / `--ds-field-message-font-size` hooks (these apply to every field's
477
+ helper/error line, not just input).
478
+
479
+ ### Changed
480
+
481
+ - **Button & icon-button press is now darken + a micro scale-down; the pressed halo is off by default.**
482
+ `:active` darkens the fill (unchanged) and adds `transform: scale(0.98)` (button) / `0.96` (icon-button)
483
+ for tactile feedback. The old faint pressed halo (`--ds-button-pressed-shadow`) now defaults to `none`
484
+ — still settable to re-enable it. Honors `prefers-reduced-motion` (scale dropped, colour stays).
485
+ - **Button & icon-button `[disabled]` is now a per-variant muted tint, not one flat grey.**
486
+ The disabled look derives from each variant's own colour: solid fills (primary/error/
487
+ success/warning) and the chrome-less `text` button use a flat pale tint (`oklch` from the
488
+ accent, pinned lightness/chroma); the `tonal` / `ghost` / `outline` button variants and
489
+ icon-button `tonal` / `outlined` use `color-mix(fill 28%, --surface-disabled)`, preserving
490
+ the enabled emphasis ladder. `text` / icon-button `standard` stay chrome-less (no box).
491
+ Visual change to the default disabled appearance — override the `--ds-*-disabled` tokens to
492
+ restore a flat grey.
493
+ - **`ds-bottom-sheet` now animates its close** — slide-down + scrim fade on dismiss (scrim
494
+ tap / Escape / downward drag / programmatic `open = false`), mirroring the open animation
495
+ instead of vanishing instantly. Honors `prefers-reduced-motion` (closes instantly). The
496
+ `closed` output now emits at the end of the leave animation rather than on the click.
497
+ - **Smooth motion across components.** Interactive state changes that used to snap now ease,
498
+ all on the existing `--duration-*` / `--ease-*` tokens (`prefers-reduced-motion` zeroes
499
+ them). Selection fills animate (checkbox check / radio dot scale + fade, switch unified to
500
+ one duration); hover/active/selected eases on pagination, tabs pills, sidenav (incl. the
501
+ collapse width), table rows + sort icon, dropzone drag-over, stepper, combobox / date-picker
502
+ / dropdown options, breadcrumb crumbs and more. `ds-modal` and `ds-drawer` now animate their
503
+ close (animate-then-remove, like `ds-bottom-sheet`) — the modal card enters with scale + fade
504
+ (no slide). `ds-accordion` expand/collapse actually animates now (grid-rows, not height:auto).
505
+ Floating panels (`ds-select` / `ds-dropdown` / `ds-combobox` / `ds-date-picker` / `ds-popover`,
506
+ plus `ds-tooltip` on open) fade + slide in on open and out on close via a shared overlay-motion
507
+ helper; `ds-banner` fades in on mount; the toggle button's pressed/hover state eases too.
508
+ Action-driven dropdown / menu / picker panels close instantly (no leave-animation lag) when a
509
+ selection is made, while dismiss (scrim / Escape) keeps the fade.
510
+
511
+ ### Fixed
512
+
513
+ - **`prefers-reduced-motion` no longer freezes looping indicators.** A blanket
514
+ `animation-duration: 0 !important` was stopping spinners and the indeterminate progress
515
+ bar (a frozen spinner reads as "hung", not "loading"). Looping status indicators are now
516
+ slowed instead of zeroed; one-shot entrance/transition motion stays instant. The page-wide
517
+ skeleton sweep still halts (large-area motion, the one reduced-motion should remove).
518
+ - **Overlay scroll-lock is now released on dismiss.** The scoped `@keyframes` name guard now
519
+ matches Angular's emulated-encapsulation suffix (`endsWith`, not `===`), so the page no
520
+ longer stays scroll-locked after an overlay closes.
521
+ - **`ds-input` / `ds-search` clear button stays visible when the field is blurred** — its
522
+ contrast was bumped so it reads at rest, not only on focus.
523
+ - **`ds-combobox`** truncates long option labels with an ellipsis instead of wrapping in
524
+ narrow panels, and its multi-select option row now fills the panel width (label no longer
525
+ clipped to zero).
526
+ - **`ds-accordion`** collapses its body fully (padding moved off the clipped wrapper) and
527
+ restores body padding when expanded.
528
+
529
+ ## 0.3.0 — 2026-06-23
530
+
531
+ ### Breaking
532
+
533
+ - **Renamed `--*-bg` tokens → `--*-bg-color`.** Every background token held only a colour
534
+ and fed the `background` shorthand; they were renamed and switched to `background-color`.
535
+ Affects all public `--ds-*-bg` hooks — avatar, badge, banner, button, card, date-picker,
536
+ dropzone, empty-state, icon-button, input, modal, pagination, search, sidenav, stat,
537
+ table, tabs, tag, toast and topbar — plus global tokens (`--select-bg`, `--chart-hover-bg`,
538
+ `--chart-tooltip-bg`, the `--status-*-bg` set) and private `--_*` tokens. Consumers
539
+ overriding e.g. `--ds-toast-bg` must rename to `--ds-toast-bg-color`.
540
+ - **Renamed `--*-fg` tokens → semantic `-text-color` / `-label-color` / `-icon-color`.**
541
+ The unclear `fg` abbreviation is gone: text/titles/inputs → `-text-color`, control & nav
542
+ labels → `-label-color`, icons/glyphs → `-icon-color`. Affects all public `--ds-*-fg`
543
+ hooks — avatar, badge, banner, breadcrumbs, button, date-picker, dropzone, empty-state,
544
+ icon-button, input, menu, modal, page-header, pagination, search, sidenav, table, tabs,
545
+ tag and topbar — plus the `--status-*` and chart-tooltip globals. Examples:
546
+ `--ds-modal-title-fg` → `--ds-modal-title-text-color`, `--ds-sidenav-group-fg` →
547
+ `--ds-sidenav-group-label-color`, `--ds-icon-button-fg` → `--ds-icon-button-icon-color`.
548
+
549
+ ### Added
550
+
551
+ - **Reactive-forms support on `ds-input`, `ds-textarea`, `ds-select`.** They now
552
+ implement `ControlValueAccessor`, so `formControlName` / `[formControl]` and template
553
+ `[(ngModel)]` bind to them out of the box, and `FormControl.disable()` is honoured. The
554
+ existing `[(value)]` signal API is unchanged — both work. Shared via an internal
555
+ `DsControlValueAccessor` base. Checkbox/switch/combobox/date-picker/radio are not yet
556
+ wired (tracked).
557
+ - **`ng add` support.** `ng add @ids-group-ltd/ids-design-system` wires the design
558
+ system's global styles (`@use '@ids-group-ltd/ids-design-system/styles/ds';`) into the
559
+ target project's global styles entry, idempotently. It targets the default/first
560
+ application project or an explicit `--project`; if no styles file is found it logs the
561
+ one-line import to add manually. Components stay standalone — import them directly.
562
+ - **`ds-combobox` `size` input** (`sm | md | lg`, default `md`), mirroring `ds-select`;
563
+ sets the trigger min-height (32 / 40 / 48 px). New exported `ComboboxSize` type.
564
+ - **Overridable focus rings.** New shared group tokens `--ds-field-focus-shadow` /
565
+ `--ds-control-focus-shadow` (+ `-error` variants), defaulting to the semantic
566
+ `--focus-field` / `--focus-ring`. Every focusable component now reads its focus shadow
567
+ through a per-component public hook `--ds-<comp>-focus-shadow` (fields also expose a
568
+ matching `-error` hook) that falls back to the group token; the global `.link` utility
569
+ and the shared dropdown/select overlay panel read the group token directly. A consumer
570
+ can retune focus for one component, a whole group (all fields or all controls), or rely
571
+ on the theme default. Default appearance unchanged.
572
+ - **`ds-tag` hover tokens** `--ds-tag-hover-bg-color` / `--ds-tag-hover-label-color`
573
+ (private tokens hoisted to `:host` for consumer override).
574
+ - **`--opacity-state-active`** (0.24) overlay token, backing the new tag pressed state.
575
+
576
+ ### Changed
577
+
578
+ - **`ds-stepper` now shows step labels.** The captions passed via `[steps]` render as
579
+ visible labels (previously screen-reader-only — only numbers showed), with the current
580
+ step emphasised. A new `labelPosition` input (`bottom` | `inline`, new exported
581
+ `StepperLabelPosition` type) chooses the layout:
582
+ `bottom` (default) stacks the caption beneath each node in a full-width row with equal
583
+ segments; `inline` puts it beside the node in a compact row that hugs its content (a
584
+ header progress bar). New `--ds-stepper-label-color` / `--ds-stepper-label-color-current`
585
+ / `--ds-stepper-label-font-size` hooks. Visual change for existing usages.
586
+ - **Tag:** added an `:active` (pressed) state to the close/dismiss button (previously only
587
+ hover was styled), using the new `--opacity-state-active` overlay.
588
+ - **Accordion & sidenav group** now animate open/close (`height: 0 ↔ auto`) via an opt-in
589
+ `interpolate-size: allow-keywords` on `:root`. Collapsed content now stays in the DOM and
590
+ is marked `inert` instead of being removed — replacing the accordion's `@if` show/hide and
591
+ the sidenav group's `display: none`. The accordion body carries an `.is-open` class when
592
+ expanded.
593
+ - **`ds-combobox` focus** now uses the soft field halo (`--focus-field`) instead of the
594
+ hard ring (`--focus-ring`), matching `ds-input` / `ds-select` / `ds-search`. Minor visual
595
+ change to the combobox focus state.
596
+ - Backgrounds and several control transitions switched from the `background` shorthand to
597
+ `background-color` for precision. Alongside it, a repo-wide, value-preserving CSS-syntax
598
+ modernization: legacy `hsl()/hsla()` comma syntax → modern space/slash form, `clip:
599
+ rect(…)` → `clip-path: inset(50%)` on visually-hidden helpers, and `min-/max-width`
600
+ media queries → range syntax (`width >= …`). No intended visual change.
601
+
602
+ ### Fixed
603
+
604
+ - **`ds-drawer`** now closes on Escape even when focus has left the panel — a
605
+ `document`-level Escape handler was added alongside the existing panel-level one
606
+ (previously Escape dismissed the drawer only while focus stayed inside it).
607
+ - **`ds-combobox`** "No matches" empty option is no longer exposed as selectable
608
+ (`aria-selected="false"`).
609
+
610
+ ## 0.2.2 — 2026-06-17
611
+
612
+ ### Added
613
+
614
+ - `.t-mono-inline` typography utility — an inline code chip (mono font on a
615
+ subtle surface with padding/radius), completing the mono family alongside
616
+ `.t-mono` (font only) and `.t-mono-block` (block).
617
+
618
+ ### Changed
619
+
620
+ - Removed the repository link from the npm package: dropped the `repository` field
621
+ from `package.json` and moved the maintainer Development/Releasing docs out of the
622
+ published README into a repo-only `CONTRIBUTING.md`. The README License entry is
623
+ now plain text (no repo link), fixing the npm 404.
624
+
625
+ ## 0.2.1 — 2026-06-16
626
+
627
+ ### Added
628
+
629
+ - A `homepage` field linking the live docs/showcase, so the npm package page
630
+ points to it.
631
+
632
+ ## 0.2.0 — 2026-06-16
633
+
634
+ ### Breaking
635
+
636
+ - Renamed the subtle semantic color tokens `--*-subtle` → `--*-subtitle`
637
+ (border, primary, secondary, tertiary, success, warning, error, info). Consumers
638
+ referencing these tokens must rename.
639
+
640
+ ### Changed
641
+
642
+ - Clarified theme re-skin guidance in the shipped `themes/README`: brand roles
643
+ retint automatically from the `--blue` ramp, but a fully calibrated brand may
644
+ set the `--primary-*` roles directly to hand-picked hex.
645
+ - Relicensed from proprietary (UNLICENSED) to MIT.
646
+
647
+ ## 0.1.0 — 2026-06-12
648
+
649
+ Initial public release.
650
+
651
+ ### Added
652
+
653
+ - 45+ standalone Angular components: buttons, forms, overlays, navigation, data display
654
+ - Three-tier token architecture: palette → semantic theme → geometry/typography/motion tokens
655
+ - Default theme and palette, swappable by consumers
656
+ - Bundled Mulish and JetBrains Mono fonts
657
+ - SCSS sources shipped in the package (`styles/`, `themes/`)