@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 +193 -0
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +1070 -289
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.1.0.json +9 -0
- package/migrations/0.2.0.json +73 -0
- package/migrations/0.2.1.json +7 -0
- package/migrations/0.2.2.json +8 -0
- package/migrations/0.3.0.json +49 -0
- package/migrations/0.4.0.json +149 -0
- package/migrations/0.5.0.json +256 -0
- package/migrations/0.5.1.json +307 -0
- package/migrations/0.6.0.json +35 -0
- package/migrations/AUTHORING.md +134 -0
- package/migrations/README.md +35 -0
- package/package.json +1 -1
- package/styles/_breakpoints.scss +14 -5
- package/styles/_layout-utils.scss +27 -7
- package/styles/_page-grid.scss +3 -0
- package/styles/_status.scss +57 -0
- package/styles/_tokens.scss +12 -4
- package/styles/_typography.scss +1 -1
- package/styles/ds.scss +2 -0
- package/themes/_base-palette.scss +14 -3
- package/themes/_semantic.scss +20 -38
- package/themes/dark/_theme.scss +1 -7
- package/types/ids-group-ltd-ids-design-system.d.ts +569 -110
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
|