@ids-group-ltd/ids-design-system 0.3.0 → 0.5.0

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