@ids-group-ltd/ids-design-system 0.5.0 → 0.6.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 CHANGED
@@ -8,6 +8,199 @@ While the package is on `0.x`, minor releases may contain breaking changes.
8
8
 
9
9
  ## Unreleased
10
10
 
11
+ ## 0.6.0 — 2026-07-16
12
+
13
+ ### Breaking
14
+
15
+ - **`styles/breakpoints` is side-effect-free — `--bp-*` now comes from an explicit `emit-vars`
16
+ mixin.** The partial exposes the `$bp-*` Sass aliases and `up()` / `down()` mixins with zero CSS
17
+ output on plain `@use`, so component styles can import it for media queries without duplicating a
18
+ `:root` block. The `--bp-*` runtime custom properties (for JS via `getComputedStyle`) are emitted
19
+ only when `emit-vars` is included. `styles/ds` includes it once — **unaffected** for consumers of
20
+ the aggregate. À-la-carte consumers who `@use '@ids-group-ltd/ids-design-system/styles/breakpoints'`
21
+ directly and need `--bp-*` must add `@include bp.emit-vars;` themselves.
22
+
23
+ ### Added
24
+
25
+ - **`menu` icon** (hamburger, three horizontal bars) in the icon registry.
26
+
27
+ ### Changed
28
+
29
+ - **`.grid-2` / `.grid-3` / `.grid-4` layout utils collapse to a single column below 640px**
30
+ (`$bp-sm`), matching the rest of the responsive grid tiers.
31
+ - **`.grid-3` / `.grid-4` layout-utils collapse tiers normalized to canonical breakpoints**: 1100px →
32
+ 1024px (`$bp-lg`), 820px → 768px (`$bp-md`).
33
+ - **`ds-page-header` actions full-width threshold normalized to canonical breakpoint**: 720px → 768px
34
+ (`$bp-md`).
35
+ - **`.t-mono-block` scrolls instead of overflowing.** Added `max-width: 100%; overflow-x: auto;` so
36
+ long unbroken lines scroll within the block rather than forcing page-level horizontal overflow.
37
+ - **`ds-modal` panel clamps to the viewport on small screens.** New `max-width: calc(100vw -
38
+ var(--space-6))`; `max-height` is now `90vh` with a `90dvh` fallback (browsers without `dvh`
39
+ support keep `90vh`).
40
+ - **`ds-date-picker` shows per-segment placeholders and a fixed-width value.** Each empty
41
+ `MM` / `DD` / `YYYY` segment now renders its own format-letter placeholder (e.g. `MM/DD/YYYY`),
42
+ and a partially-typed segment shows the typed digits followed by muted padding letters. Achieved
43
+ with a transparent input layered over a per-slot overlay, so the value stays fixed-width and the
44
+ caret stays aligned as you type across segments (single and range mode).
45
+ - **`ds-date-picker` calendar panel is now non-blocking (no backdrop).** The panel renders with
46
+ `hasBackdrop: false`: it closes on pointer-down outside the panel, but the trigger stays live —
47
+ clicking the calendar icon while the panel is open toggles it closed, and hover/pointer events
48
+ reach the rest of the page instead of being swallowed by a full-screen scrim.
49
+
50
+ ### Fixed
51
+
52
+ - **`ds-description-list` no longer forces page-wide horizontal scroll on narrow viewports.** The
53
+ item's `1fr` grid column had no `minmax(0, …)`, so its min-content contribution (long unbroken
54
+ values like API keys) blew out the track past the container; both grid tracks now use
55
+ `minmax(0, …)` and the value gains `overflow-wrap: anywhere` to actually wrap into the freed space.
56
+ - **`ds-drawer` / `ds-bottom-sheet` / `ds-modal` no longer hang mid-close when the tab is backgrounded.**
57
+ Teardown waited on the leave animation's `animationend`, but Chrome freezes CSS animations on a
58
+ hidden document, so the event never fired and the panel stayed stuck in its `closing` state with
59
+ the scrim visible and body scroll locked; each now also arms a 300ms synthetic-fallback timer that
60
+ completes teardown if `animationend` doesn't arrive first (whichever fires first wins, the other is
61
+ cancelled). `ds-drawer`'s `animationend` name check also switched from a loose `.includes()` match
62
+ to per-placement `.endsWith()`, matching the guard already used by `ds-bottom-sheet` / `ds-modal`.
63
+ - **`ds-popover` overlay no longer touches or crosses the viewport edge on small screens.** The
64
+ `FlexibleConnectedPositionStrategy` had no viewport margin, so panels near an edge could butt
65
+ right up against it or overflow past it; now reserves an 8px margin on all sides.
66
+ - **`ds-date-picker` calendar panel no longer overflows phone viewports.** Below 640px (`$bp-sm`)
67
+ the panel clamps to `calc(100vw - var(--space-4))` and the presets column stacks below the day
68
+ grid instead of sitting beside it, replacing the fixed 454px-wide side-by-side layout that
69
+ overflowed the screen.
70
+ - **`ds-date-picker` text entry is now segment-aware — editing one field no longer disturbs the
71
+ others or the caret.** Typing, Backspace and Delete stay within the focused `MM` / `DD` / `YYYY`
72
+ field (single and range mode); previously correcting one segment could shift digits across the
73
+ `/` separators and fling the caret to the end.
74
+ - **`ds-date-picker` no longer shows a mask residue or a false invalid state when pristine.** An
75
+ untouched field previously held a `__/__/____` residue that was read out to screen readers and
76
+ could trip validation on blur; it now renders empty and raises no invalid state until the user
77
+ actually enters a value (single and range mode).
78
+ - **`ds-date-picker` paste is slot-aware.** Pasting digits fills segments sequentially from the
79
+ caret position rather than flattening the field or clearing unrelated segments.
80
+ - **`ds-date-picker` range values can no longer be corrupted by clearing one segment.** Parsing is
81
+ now slot-based instead of slicing by digit count, so clearing one segment of a range no longer
82
+ pulls a digit from an adjacent segment into the emptied slot; a date is parsed and validated only
83
+ once all of its slots are filled.
84
+ - **`ds-date-picker` exposes its format hint to screen readers via `aria-placeholder`.** After the
85
+ native placeholder was removed for the overlay rework, the `MM/DD/YYYY` format hint is now surfaced
86
+ to assistive technology through `aria-placeholder`.
87
+
88
+ ## 0.5.1 — 2026-07-13
89
+
90
+ ### Breaking
91
+
92
+ - **Status vocabulary unified — `danger` → `error`, `warn` → `warning`.** A new exported
93
+ `DsStatus = 'info' | 'success' | 'warning' | 'error'` is the canonical status vocabulary.
94
+ Renamed to match it: the boolean input `[danger]` → `[error]` on `ds-modal` / `ds-modal-card` /
95
+ `ds-menu-item`; `ds-stat` `variant` value `'danger'` → `'error'`; `ds-progress` `variant` value
96
+ `'warn'` → `'warning'` (`ProgressVariant` is now `'default' | Exclude<DsStatus, 'info'>`);
97
+ `ModalConfirmTone` `'danger'` → `'error'` (also `ModalService.confirm({ tone })`);
98
+ `SplitButtonItem.danger` → `.error`. Public tokens renamed in lockstep:
99
+ `--ds-menu-item-danger-label-color` → `--ds-menu-item-error-label-color` and
100
+ `--ds-progress-bar-color-warn` → `--ds-progress-bar-color-warning`. CSS state classes and every
101
+ default value are otherwise unchanged.
102
+ - **Event outputs renamed to past-participle (consistent event naming).** Dismissal events unified
103
+ to `closed`: `ds-alert` / `ds-banner` / `ds-toast` `(dismissed)` → `(closed)`. Action events made
104
+ past-tense: `ds-table` `(rowClick)` → `(rowClicked)`, `ds-stepper` `(stepClick)` →
105
+ `(stepClicked)`, `ds-calendar-day` `(daySelect)` → `(daySelected)`, `ds-tabs` `(tabClose)` →
106
+ `(tabClosed)`, `ds-tree` `(nodeSelect)` → `(nodeSelected)`, `ds-split-button` `(itemSelect)` →
107
+ `(itemSelected)`.
108
+ - **`ds-progress` — `indeterminate` is now a boolean input, not a `variant` value.** The animation
109
+ mode was conflated with the colour variant (a bar could not be `success`-coloured *and*
110
+ indeterminate). Migration: `<ds-progress variant="indeterminate" />` →
111
+ `<ds-progress indeterminate />`; `'indeterminate'` removed from `ProgressVariant`.
112
+ - **`ds-badge` / `ds-status-dot` status API redesigned — factory statuses replaced by a
113
+ consumer-defined registry.** `ds-badge`'s `[variant]` input (`BadgeVariant`) is replaced by
114
+ `[status]` (typed `DsStatusKey`); `ds-status-dot`'s `[status]` is retyped `StatusValue` →
115
+ `DsStatusKey` and no longer defaults to `'planning'`. Both now render the value as a `data-status`
116
+ attribute instead of a factory CSS class, so the built-in per-status rules (`.badge.planning` /
117
+ `.active` / `.confirmed` / `.completed` / `.info` / `.success` / `.warning` / `.error` /
118
+ `.neutral` / `.secondary`, plus the matching `.status-dot.*`) and the factory `--status-*`
119
+ lifecycle theme tokens (`--status-planning-bg-color`, `--status-confirmed-*`, `--status-active-*`,
120
+ `--status-completed-*`) are all removed. The exported types `BadgeVariant`, `BadgeLifecycle`,
121
+ `BadgeSemantic`, and `StatusValue` are removed. Migrate `variant="active"` → `status="active"`,
122
+ then define your own status colours via the new `styles/status` SCSS API (see Added) keyed on
123
+ `[data-status]`. `[count]` mode, `[solid]`, `[withDot]`, `[max]`, and the `--ds-badge-*` /
124
+ `--ds-status-dot-*` hooks are unchanged.
125
+ - **`title` is now required on `ds-drawer`, `ds-bottom-sheet`, and `ds-accordion-item`** (was
126
+ optional). Their `title` is the component's accessible name (dialog `aria-labelledby`) or the
127
+ disclosure-button label, so a missing title left them unnamed. `ds-modal` / `ds-modal-card` stay
128
+ required (unchanged); `ds-page-header` is now **optional** (its `title` is a plain `<h1>`, not an
129
+ accessible-name dependency — a non-breaking loosening).
130
+ - **Default `secondary` / `tertiary` hues now diverge from `primary`.** Previously both roles
131
+ defaulted to the `--primary` channels, so an un-branded app rendered `primary`, `secondary`, and
132
+ `tertiary` as the same blue. They now default to distinct palette families — `--secondary-h/s/l` →
133
+ `--orange-h/s/l` (warm orange) and `--tertiary-h/s/l` → `--violet-h/s/l` (cool violet), in both
134
+ light and dark themes. Consumers who already set `--secondary-h/s/l` / `--tertiary-h/s/l` per brand
135
+ are unaffected; to keep the old single-hue look, point those channels back at `--primary-h/s/l`.
136
+ - **`--static-white` theme token removed.** The fixed-value `--static-white` custom property is gone;
137
+ its uses now emit the literal `white`. No visual change, but a consumer who referenced
138
+ `var(--static-white)` must replace it with `white` (`--static-ink` is retained).
139
+
140
+ ### Added
141
+
142
+ - **`DsStatus` type export** — `'info' | 'success' | 'warning' | 'error'`, the shared status
143
+ vocabulary used across status-bearing components.
144
+ - **`ds-progress` `[indeterminate]` boolean input** — orthogonal to `variant` (see Breaking).
145
+ - **`DividerSpacing` is now exported** from the public API (the `ds-divider` `[spacing]` input type
146
+ was previously declared but not re-exported).
147
+ - **Extensible status system — `DsStatusRegistry` / `DsStatusKey` + `styles/status` SCSS API.** New
148
+ public exports: `DsStatusRegistry` (an empty interface consumers augment via declaration merging to
149
+ register their own status keys) and `DsStatusKey` (an open `string` until the registry is augmented,
150
+ then a union of the registered keys — the type of `ds-badge` / `ds-status-dot` `[status]`). A new
151
+ SCSS entry point `@use '@ids-group-ltd/ids-design-system/styles/status'` exposes `define($map)` —
152
+ wires `[data-status]` selectors to the `--ds-badge-*` / `--ds-status-dot-*` tokens from a Sass map
153
+ of `name: (bg:, text?:, dot?:)` — and `semantic-preset`, a ready-made `info` / `success` /
154
+ `warning` / `error` / `neutral` set. This is the replacement for the removed factory statuses (see
155
+ Breaking).
156
+
157
+ ### Changed
158
+
159
+ - **Press-feedback reworked — no button-style press on non-buttons.** The `:active` scale+brightness
160
+ press was removed from the overlay field triggers `ds-autocomplete` / `ds-select` /
161
+ `ds-multi-select` (opening the panel is the feedback). List/menu rows and the color-picker trigger
162
+ (`ds-menu-item`, `ds-list`, `ds-tree`, `ds-accordion` header, `ds-color-picker`) swap the scale for a
163
+ flat rounded `:active` background. Press-scale stays on buttons and compact actionable controls
164
+ (`ds-button`, `ds-calendar-day`, `ds-pagination`, `ds-tabs`, `ds-segmented`, `ds-toggle-button`,
165
+ `ds-sidenav-item`, checkbox / radio / switch). Small icon action buttons — close / dismiss /
166
+ clear / remove `×`, plus the `ds-tag` chip close (used by autocomplete & multi-select chips) — now
167
+ consistently get the button press-scale too (they previously had no `:active` feedback, or only a
168
+ flat tint).
169
+ - **`ds-date-picker` keeps the format mask visible while typing.** In manual-input mode the unfilled
170
+ tail of the date mask now stays on-screen as a muted ghost (after typing `12/` the field reads
171
+ `12/DD/YYYY`) instead of the placeholder vanishing on the first keystroke. The typed value renders
172
+ in the monospace font so digits land exactly on the mask's `D`/`M`/`Y` positions and the tail never
173
+ shifts as you type.
174
+
175
+ ### Fixed
176
+
177
+ - **Boolean attribute coercion on all boolean inputs.** ~54 boolean inputs across ~30 components
178
+ gained `transform: booleanAttribute`, so a bare or string attribute (`<ds-x required>` /
179
+ `disabled="false"`) now coerces correctly instead of being read as a truthy string. Property-
180
+ binding consumers are unaffected.
181
+ - **`ds-button` tonal fill — `:active` now darkens past `:hover`.** The `tonal` variant reused the
182
+ same token (`--c-muted-strong`) for both hover and active, so the pressed background was identical
183
+ to hover; active now mixes that tint ~10% toward black for a distinct pressed step.
184
+ - **Per-instance overlay panel token overrides now reach the portaled pane.** `--ds-*` panel tokens
185
+ set on the host of `ds-autocomplete`, `ds-multi-select`, `ds-date-picker`, `ds-color-picker`,
186
+ `ds-popover`, and `ds-time-picker` were ignored because the panel renders in a CDK overlay
187
+ (portaled outside `:host`, where the custom properties no longer inherit); the host's resolved
188
+ panel tokens are now forwarded onto the overlay element on open. (`ds-select` uses the shared
189
+ global panel class and was never affected.)
190
+ - **`ds-autocomplete` / `ds-multi-select` panels no longer render transparent.** Their internal panel
191
+ colour resolvers were declared on `:host`, but the panel is portaled — so the background collapsed
192
+ to transparent (page content bled through) with broken hover/active highlighting; the resolvers now
193
+ sit on the panel element itself.
194
+ - **`ds-tabs` `secondary` variant now applies.** The secondary-toned active indicator and label were
195
+ keyed off `.tabs.secondary`, but the variant class lands on the host, so the selector never
196
+ matched; rewritten to `:host(.secondary)`.
197
+ - **`ds-date-picker` range mask no longer clips the second date**, and the trigger's value-to-icon
198
+ gap is tightened to 4px. The field now reserves an extra character of width so the wider range-mode
199
+ mask (two dates) is no longer cut off.
200
+ - **`ultra-compact` density tier gained full token coverage.** `[data-density="ultra-compact"]` now
201
+ also scales avatar size, sidenav width, badge / status-dot sizes, and switch geometry — previously
202
+ left at the cozy defaults, so those controls didn't shrink with the tier.
203
+
11
204
  ## 0.5.0 — 2026-07-08
12
205
 
13
206
  ### Breaking