@ids-group-ltd/ids-design-system 0.6.2 → 0.7.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 +285 -1
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +2004 -828
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.5.1/badge-statuses.md +181 -0
- package/migrations/0.5.1.json +2 -2
- package/migrations/0.6.3.json +50 -0
- package/migrations/0.7.0.json +263 -0
- package/migrations/README.md +6 -0
- package/package.json +1 -1
- package/styles/_press.scss +1 -1
- package/styles/_status.scss +1 -0
- package/styles/_tokens.scss +2 -13
- package/styles/_typography.scss +169 -20
- package/themes/README.md +11 -7
- package/types/ids-group-ltd-ids-design-system.d.ts +567 -92
package/CHANGELOG.md
CHANGED
|
@@ -8,6 +8,289 @@ While the package is on `0.x`, minor releases may contain breaking changes.
|
|
|
8
8
|
|
|
9
9
|
## Unreleased
|
|
10
10
|
|
|
11
|
+
## 0.7.0 — 2026-07-30
|
|
12
|
+
|
|
13
|
+
### Changed
|
|
14
|
+
|
|
15
|
+
- **BREAKING: the control `size` scale is unified into one shared `DsSize` type.** The per-component
|
|
16
|
+
size types (`InputSize`, `ButtonSize`, `SelectSize`, `SearchSize`, `CheckboxSize`, `RadioSize`,
|
|
17
|
+
`SwitchSize`, `SpinnerSize`, `TextareaSize`, `NumberStepperSize`, `DatePickerSize`, `TimePickerSize`,
|
|
18
|
+
`DrawerSize`, `IconButtonSize`, `AutocompleteSize`) are removed from the public API — import
|
|
19
|
+
`DsSize` instead (`type DsSize = 'sm' | 'md' | 'lg'`, exported from the package root). `AvatarSize`,
|
|
20
|
+
`ModalSize` and `ContainerSize` remain and now extend it (`'xs' | DsSize`, `DsSize | 'xl' | 'fullscreen'`,
|
|
21
|
+
`DsSize | 'xl' | 'full'`). No runtime or visual change — every component's `size` input behaves exactly as before.
|
|
22
|
+
|
|
23
|
+
- **BREAKING: form fields now reserve one line for the message row by default.** Every field
|
|
24
|
+
(`ds-input`, `ds-textarea`, `ds-select`, `ds-autocomplete`, and the other message-bearing controls)
|
|
25
|
+
gains a `reserveMessage` input (default `true`). With it on, the field always keeps a message line's
|
|
26
|
+
worth of vertical space even when there's no hint or error, so a form no longer reflows when
|
|
27
|
+
validation messages appear — the row is there from the start. Set `[reserveMessage]="false"` to
|
|
28
|
+
collapse the space back (the previous behaviour) where the layout can absorb the shift.
|
|
29
|
+
|
|
30
|
+
- **BREAKING: `ds-pagination` drops its manual `(pageChange)` and `(pageSizeChange)` outputs.** They
|
|
31
|
+
duplicated the two-way models — the manual `pageSizeChange` even name-collided with the `pageSize`
|
|
32
|
+
model's own implicit output, and one size change fired the change events three times over. Page and
|
|
33
|
+
size are now driven purely by the `[(currentPage)]` / `[(pageSize)]` two-way models. Migrate
|
|
34
|
+
`(pageChange)="…"` to `(currentPageChange)="…"`; `(pageSizeChange)` keeps working unchanged (it is now
|
|
35
|
+
the `pageSize` model's implicit output, same name and payload). `[(currentPage)]` / `[(pageSize)]`
|
|
36
|
+
bindings are unaffected. (`ds-table` already drove pagination via the models, so it is untouched.)
|
|
37
|
+
|
|
38
|
+
- **BREAKING: `ds-input` drops the `withAddon` / `withAddonRight` inputs.** They hand-declared what the
|
|
39
|
+
DOM already states — and the doc line was wrong (the flag stripped the control's inset rather than
|
|
40
|
+
"reserving space"). The flush-addon layout is now derived automatically: a boxed `.addon` projected
|
|
41
|
+
into `[dsInputPrefix]`/`[dsInputSuffix]` (`<span dsInputPrefix class="addon">…</span>`) sits flush via
|
|
42
|
+
`:has()`, while a bare projected `<ds-icon dsInputPrefix>` correctly keeps its inset. Delete
|
|
43
|
+
`[withAddon]` / `[withAddonRight]` from your templates — a boxed addon renders identically, and a bare
|
|
44
|
+
icon that previously (mis)set the flag regains its proper inset (a bugfix).
|
|
45
|
+
|
|
46
|
+
- **BREAKING: `ds-app-shell` is renamed to `ds-app-layout`.** The slotted fixed-frame application layout
|
|
47
|
+
shipped as `ds-app-shell` in the tagged 0.6.3 source; this renames the selector (`ds-app-shell` →
|
|
48
|
+
`ds-app-layout`), the component class (`AppShellComponent` → `AppLayoutComponent`), the exported scroll
|
|
49
|
+
service (`ShellScrollService` → `LayoutScrollService`), and its four tokens (`--ds-app-shell-pad-x` /
|
|
50
|
+
`-pad-y` / `-content-max-width` / `-height` → `--ds-app-layout-*`). Behaviour is unchanged — rename the
|
|
51
|
+
references (see `migrations/`). A consumer still on 0.6.3's `ds-app-shell` must migrate.
|
|
52
|
+
|
|
53
|
+
### Added
|
|
54
|
+
|
|
55
|
+
- **New override tokens for two baked-in weights: `--ds-sidenav-item-label-weight` and
|
|
56
|
+
`--ds-modal-title-weight`.** The nav-item label weight and the modal title weight were locked inside a
|
|
57
|
+
`font:` shorthand with no `--ds-*` hook; a brand can now retune either without reaching past the public
|
|
58
|
+
token contract. Defaults unchanged (`--font-weight-semibold` / `--font-weight-bold`).
|
|
59
|
+
|
|
60
|
+
- **`ds-table` gains an opt-in `scrollToTopOnPageChange` input.** With it on, changing page scrolls the
|
|
61
|
+
table back into view, so paging from a bottom pager doesn't leave the viewport on the old page's rows.
|
|
62
|
+
Off by default.
|
|
63
|
+
|
|
64
|
+
- **`ds-search` gains a `size` input (`sm`/`md`/`lg`, default `md`).** Search previously ignored `size`
|
|
65
|
+
and its size CSS never matched, so it sat 4px taller than sibling controls in dense toolbars. `sm` is
|
|
66
|
+
now 32px (matching `ds-input`/`ds-button` at `sm`); the default `md` keeps the prior 36px search-row
|
|
67
|
+
height, so existing consumers are unaffected.
|
|
68
|
+
|
|
69
|
+
- **`ds-table` gains a `total` input for server-side pagination.** Set `[total]` to the full row count
|
|
70
|
+
when the data you pass in is already the current page (fetched from the server); the table then treats
|
|
71
|
+
`data` as pre-paged — it no longer slices it — and drives the pager off `total` instead of the local
|
|
72
|
+
row count. Leave `total` unset (default `null`) to keep the existing client-side paging behaviour.
|
|
73
|
+
|
|
74
|
+
- **`ds-table` gains a `sortingOrder` input.** By default a sortable header cycles
|
|
75
|
+
`asc → desc → unsorted`; pass `[sortingOrder]="['asc','desc']"` to drop the unsorted state (useful with
|
|
76
|
+
server-paged lists that must always send a sort direction). The default is unchanged.
|
|
77
|
+
|
|
78
|
+
- **`ds-table` gains an `animateHeight` input (opt-in).** With `[animateHeight]="true"` the body
|
|
79
|
+
tweens its height when the row set changes (paging, filtering) instead of snapping — the flicker
|
|
80
|
+
when a full page gives way to a short one. Off by default; instant under reduced-motion (it reads the
|
|
81
|
+
DS `--duration-*` token, which the reduced-motion reset zeroes).
|
|
82
|
+
|
|
83
|
+
- **`TableColumn` gains an optional `srLabel`.** Provides a visually-hidden accessible name for columns
|
|
84
|
+
whose visible `label` is intentionally empty (e.g. an actions column), so screen-reader users still
|
|
85
|
+
hear a column name.
|
|
86
|
+
|
|
87
|
+
- **`ds-badge` gains a `countLabel` input (default `'notifications'`).** The count's accessible label was
|
|
88
|
+
hard-coded to `"N notifications"`; set `countLabel` for non-notification counts (`'items in cart'`,
|
|
89
|
+
`'results'`, …).
|
|
90
|
+
|
|
91
|
+
- **`ds-avatar` gains deterministic seeded tinting.** Pass `[seed]` (a user id, email or name) and the
|
|
92
|
+
avatar derives a stable per-person background + auto-contrast text colour, so the same person gets the
|
|
93
|
+
same colour across the product; `[avoidHues]` excludes hue arcs (e.g. a brand colour), and `[tint]` now
|
|
94
|
+
also accepts `'neutral'`. The maths ships standalone too — `avatarTint(seed, options)` returns an OKLCH
|
|
95
|
+
background (`AvatarTintOptions`: `avoidHues` / `lightness` / `chroma` / `foreground`) with a
|
|
96
|
+
WCAG-luminance black-or-white foreground, and `initialsFrom(first, last)` (which also accepts a single
|
|
97
|
+
full-name string) — both exported from the package root.
|
|
98
|
+
|
|
99
|
+
- **`ds-sidenav-item` gains an `(activate)` output.** Emitted on click, carrying the `MouseEvent`. On an
|
|
100
|
+
`href` item, `preventDefault()` intercepts navigation (e.g. a sidebar driving its own scroll-spy); a
|
|
101
|
+
`routerLink` item navigates regardless (Angular's `RouterLink` ignores `defaultPrevented`), so it's a
|
|
102
|
+
click hook there. Additive; omit it to navigate as before, keeping active/badge/tooltip/collapse intact.
|
|
103
|
+
|
|
104
|
+
- **`BodyScrollLockService` is now exported.** The ref-counted body-scroll lock that `ds-modal` /
|
|
105
|
+
`ds-drawer` / `ds-bottom-sheet` share is injectable, so a consumer's own full-screen overlay can
|
|
106
|
+
participate in the same lock instead of fighting it (`lock()` / `unlock()`, paired).
|
|
107
|
+
|
|
108
|
+
### Fixed
|
|
109
|
+
|
|
110
|
+
- **`ds-menu`: disabled items are now keyboard-reachable.** A disabled `ds-menu-item` was dropped from the
|
|
111
|
+
roving-tabindex nav (unreachable by keyboard) and rendered a native `disabled` button; it now uses
|
|
112
|
+
`aria-disabled` and stays in the arrow / type-ahead order (ARIA menu practice), so a keyboard user can
|
|
113
|
+
focus it — and a `[dsTooltip]` on it now shows on focus, surfacing a "why is this disabled" reason.
|
|
114
|
+
Activation stays blocked. (Reliable screen-reader announcement of that reason is a separate follow-up —
|
|
115
|
+
the tooltip's `aria-describedby` currently lands on the `role="none"` host, not the inner button.)
|
|
116
|
+
|
|
117
|
+
- **Stacked overlays no longer unlock body scroll under each other.** `ds-modal`, `ds-drawer` and
|
|
118
|
+
`ds-bottom-sheet` each wrote `body.style.overflow` directly, so closing the outer of two stacked
|
|
119
|
+
overlays re-enabled page scroll while the inner one was still open. They now share a ref-counted
|
|
120
|
+
`BodyScrollLockService` — the first lock hides `body` overflow, the last unlock restores it.
|
|
121
|
+
|
|
122
|
+
- **`ds-avatar`: `--ds-avatar-size` now applies at every size, not just `md`.** The `xs`/`sm`/`lg`
|
|
123
|
+
modifiers set `width`/`height` directly, silently ignoring a consumer's `--ds-avatar-size`; they now
|
|
124
|
+
route through the same private var the token feeds, so an override wins at any size.
|
|
125
|
+
|
|
126
|
+
- **`ds-table`: an out-of-range page is clamped back into range.** When a client-side filter shrinks the
|
|
127
|
+
result set below the current page, the table now pulls `page` down to the last page that has rows
|
|
128
|
+
instead of rendering an empty body (guarded to client paging — with `total` set the host owns the clamp).
|
|
129
|
+
|
|
130
|
+
- **`ds-sidenav`: collapsed items no longer overflow by 1px.** A collapsed item was sized to the
|
|
131
|
+
`--sidenav-collapsed-item` hit target, 1px wider than the rail's content box (border-box minus padding
|
|
132
|
+
and the right border), which produced a hairline horizontal scrollbar. Collapsed items now fill the
|
|
133
|
+
available width, and the rail clips any residual x-overflow.
|
|
134
|
+
|
|
135
|
+
- **`dsTooltip`: keyboard focus now shows and hides the tip reliably, and panels no longer strand.** The
|
|
136
|
+
directive listened on `focus`/`blur`, which don't fire for focus moving between descendants; it now uses
|
|
137
|
+
the bubbling `focusin`/`focusout`, so tooltips on composite controls open and close as focus enters and
|
|
138
|
+
leaves. A re-rendered anchor under a stationary cursor could also leave a panel open — `show()` now
|
|
139
|
+
disposes any existing overlay first, and activation (`click`) dismisses too.
|
|
140
|
+
|
|
141
|
+
- **`ds-select`: the clear (×) button is now keyboard-operable.** It was a non-focusable `<span>`; it is
|
|
142
|
+
now a real `<button aria-label="Clear selection">`, and the trigger is a focusable `role="combobox"`
|
|
143
|
+
container so the nested button is valid.
|
|
144
|
+
|
|
145
|
+
## 0.6.3 — 2026-07-27
|
|
146
|
+
|
|
147
|
+
### Added
|
|
148
|
+
|
|
149
|
+
- **Typography utilities (`.t-*`) expose per-axis `--ds-t-*` token hooks.** Every `.t-display`/`.t-h1`
|
|
150
|
+
…`.t-mono-block` utility now reads each type property as a longhand through a public
|
|
151
|
+
`--ds-t-<name>-<prop>` custom property that falls back to the current semantic token —
|
|
152
|
+
`font-weight`, `font-size`, `line-height`, `font-family`, plus `letter-spacing` / `text-transform` /
|
|
153
|
+
`color` / `background-color` / `border-color` / `border-radius` where the class sets them. A consumer
|
|
154
|
+
can now retune a single axis in a scope (`[data-brand] .t-h3 { --ds-t-h3-font-weight: var(--font-weight-bold) }`)
|
|
155
|
+
without re-declaring the whole rule or forking the class — the same consumer-first `--ds-*` contract
|
|
156
|
+
the components use, extended to the global utility layer. Default rendering is unchanged (structural
|
|
157
|
+
box props — padding/margin/border-width/max-width/overflow — stay raw). Minor: the `font` shorthand
|
|
158
|
+
was split into longhands, so `.t-*` no longer force `font-style`/`font-variant` back to `normal`
|
|
159
|
+
(they inherit) — only observable inside an italic/small-caps ancestor.
|
|
160
|
+
- **`ds-table` row-action kebab menu.** New opt-in `rowActions` input renders a trailing ⋮ column;
|
|
161
|
+
the per-row button opens a `ds-menu` of the configured items (`id`, `label`, optional `icon`,
|
|
162
|
+
destructive `error`, per-row `disabled` predicate) and `rowActionSelected` emits `{ action, row }`
|
|
163
|
+
on pick. Off by default — tables without `rowActions` render exactly as before. Kebab clicks stop
|
|
164
|
+
propagation, so on a `rowInteractive` table a menu click never triggers `rowClicked`. New exported
|
|
165
|
+
types `TableRowAction` / `TableRowActionEvent`.
|
|
166
|
+
- **`ds-table` current-row highlight, client filter, and honored column fields.** New opt-in
|
|
167
|
+
`activeRowId` input marks one row as current (tinted via the new `--ds-table-row-active-bg-color`
|
|
168
|
+
token + `aria-current`) — e.g. the row whose detail drawer is open. New `filterQuery` input filters
|
|
169
|
+
rows client-side (case-insensitive substring over cell text; columns with `filterable: true`
|
|
170
|
+
restrict the match set, none marked = all columns) — sorting, pagination totals and the empty slot
|
|
171
|
+
all follow the filtered set. `TableColumn.width` (px, applied to the header cell),
|
|
172
|
+
`TableColumn.truncate` (ellipsis-clip at `width`, 240px fallback, full value in the title tooltip;
|
|
173
|
+
text cells only) and `TableColumn.hidden` (column skipped, still filterable/sortable) were declared
|
|
174
|
+
but ignored — they now work.
|
|
175
|
+
- **`ds-table` column picker.** Columns marked `hideable: true` (declared but ignored until now)
|
|
176
|
+
surface a picker button in the header's trailing cell — a checkbox popover toggles column
|
|
177
|
+
visibility, with `hidden: true` as the initial state and the last visible column locked so the
|
|
178
|
+
grid can't go empty. New two-way `hiddenKeys` model (`Set<string> | null`; `null`, the default,
|
|
179
|
+
derives the set from the `hidden` flags — binding a Set takes over and the flags are ignored).
|
|
180
|
+
- **`ds-table` inline cell editing.** Columns marked `editable: true` turn into a text input on
|
|
181
|
+
double-click; Enter or blur commits, Escape cancels. The table stays data-agnostic — it emits
|
|
182
|
+
`cellEdited` (`{ row, key, value }`, new exported `TableCellEditEvent` type) and the consumer owns
|
|
183
|
+
the data update.
|
|
184
|
+
- **`ds-table` per-column set filters.** A column marked `filter: 'set'` gets a header funnel
|
|
185
|
+
button opening a searchable checkbox list of that column's distinct values; unchecking narrows the
|
|
186
|
+
rows and the funnel highlights while a filter is active. State is two-way bindable via the new
|
|
187
|
+
`columnFilters` model (`Map<key, Set<value>>` — the still-checked values; a column absent or fully
|
|
188
|
+
checked reads as unfiltered) and combines with `filterQuery`.
|
|
189
|
+
- **`ds-table` column resizing.** New opt-in `resizableColumns` input adds a drag handle to each
|
|
190
|
+
column header's right edge; widths are two-way bindable via the new `columnWidths` model
|
|
191
|
+
(`Map<key, px>`), seeded from `column.width`. The header clips its label so a narrowed column
|
|
192
|
+
can't spill into its neighbour.
|
|
193
|
+
- **`ds-table` column reordering.** New opt-in `reorderableColumns` input adds a drag handle and
|
|
194
|
+
up/down buttons to each row of the column panel (which now lists every column, not just hideable
|
|
195
|
+
ones); the order is two-way bindable via the new `columnOrder` model (`string[] | null`, `null` =
|
|
196
|
+
declaration order), and the panel's `Reset to default` resets all three column models — order,
|
|
197
|
+
visibility **and** widths (`columnOrder`, `hiddenKeys`, `columnWidths`). The panel surfaces
|
|
198
|
+
whenever any column is `hideable` **or** `reorderableColumns` is set.
|
|
199
|
+
- **`ds-table` CSV export.** New public `exportCsv(filename?)` method downloads the visible columns
|
|
200
|
+
of the filtered + sorted rows (all rows, not just the current page) as a UTF-8 CSV — wire it to a
|
|
201
|
+
consumer toolbar button via a template reference.
|
|
202
|
+
- **`ds-table` density, zebra striping and capped scroll height.** New `density="compact"` input
|
|
203
|
+
tightens cell padding for spreadsheet-dense lists; `zebra` tints odd rows (via the new
|
|
204
|
+
`--ds-table-row-stripe-bg-color` token); `maxHeight` (any CSS length) caps the scroll body and
|
|
205
|
+
scrolls it vertically, pairing with `stickyHeader` for a self-contained scroll region. All opt-in.
|
|
206
|
+
- **`ds-table` sticky horizontal scrollbar.** New opt-in `stickyScrollbar` input hides the scroll
|
|
207
|
+
container's native horizontal bar and renders a proxy scrollbar stuck to the bottom of the nearest
|
|
208
|
+
scroll ancestor while the table is in view, mirroring `scrollLeft` both ways — on a tall, wide
|
|
209
|
+
table the horizontal bar stays reachable without scrolling to the table's end. The proxy hides
|
|
210
|
+
itself when the table doesn't overflow.
|
|
211
|
+
- **`ds-table` truncated cells open a full-value popover on click.** A `truncate` column's clipped
|
|
212
|
+
cell now shows its complete text in a popover when clicked (in addition to the existing title
|
|
213
|
+
tooltip); the click is swallowed so it never doubles as a row click, while an unclipped cell
|
|
214
|
+
passes the click through to the row unchanged.
|
|
215
|
+
- **`ds-app-shell` — slotted fixed-frame application shell.** `[sidenav]`/`[topbar]`/default
|
|
216
|
+
content slots; the host pins to the viewport (`100dvh`, `overflow: hidden`) and ONLY the content
|
|
217
|
+
`<main>` scrolls (`scrollbar-gutter: stable` + automatic native-scrollbar-width padding
|
|
218
|
+
compensation via the new `--ds-scrollbar-width` root variable). `topbarSpan` input switches the
|
|
219
|
+
geometry (`'content'` default: full-height rail; `'full'`: full-width topbar). Built-in
|
|
220
|
+
scroll-to-top on router navigation via the new exported `ShellScrollService` (also injectable
|
|
221
|
+
from routed pages for manual `scrollToTop()`). Tokens: `--ds-app-shell-pad-x/-pad-y/`
|
|
222
|
+
`-content-max-width/-height`.
|
|
223
|
+
- **`ds-sidenav-footer` — rail footer brick.** Search row with a live grouped-results popover
|
|
224
|
+
(Enter opens the first hit), Alerts row with an unread dot + feed popover, Collapse row, and a
|
|
225
|
+
user card with an account menu. Inputs `userName`/`userRole`/`alerts`/`collapsed`/
|
|
226
|
+
`searchProvider`/`alertItems`/`profileRoute`; outputs `collapseToggled`/`alertsOpened`/
|
|
227
|
+
`signOutSelected`. New exported types `SidenavSearchProvider`/`SidenavSearchResult`/
|
|
228
|
+
`SidenavAlertItem`. Tokens: `--ds-sidenav-footer-popover-width/-popover-max-width/`
|
|
229
|
+
`-popover-max-height/-head-tracking/-dot-size`.
|
|
230
|
+
- **`ds-sidenav` brand-row logo glyph + wordmark projection.** New optional `logoLetter` input sets
|
|
231
|
+
the tile glyph when it differs from the brand's first letter. A new `[dsBrandName]` projection
|
|
232
|
+
slot (exported marker directive `BrandNameDirective`) lets consumers project custom wordmark
|
|
233
|
+
markup — two-tone wordmarks, inline logos — which renders inside `.brand-name` in place of the
|
|
234
|
+
plain `brand` text. Both are optional; omitting them renders exactly as before.
|
|
235
|
+
|
|
236
|
+
### Changed
|
|
237
|
+
|
|
238
|
+
- **`ds-input`, `ds-search` and `ds-textarea` focus the control when the frame chrome is clicked.**
|
|
239
|
+
Clicking a leading/trailing icon, a prefix/suffix add-on, or the frame padding now focuses the
|
|
240
|
+
inner `input`/`textarea` instead of doing nothing — the whole field box is a focus target, matching
|
|
241
|
+
native `<label>` behaviour. Clicks on nested controls (projected buttons, the clear ✕, the password
|
|
242
|
+
toggle) are left untouched. Driven by the new exported `FieldClickFocusDirective`
|
|
243
|
+
(`[dsFieldClickFocus]`), which consumers can apply to their own field wrappers. Overlay-trigger
|
|
244
|
+
fields (`ds-autocomplete`, `ds-date-picker`, `ds-select`, `ds-multi-select`, `ds-color-picker`)
|
|
245
|
+
already focused on trigger click and are unchanged.
|
|
246
|
+
- **`ds-table` row hover/pressed tints are now exclusive to `rowInteractive` tables.** Passive
|
|
247
|
+
tables no longer tint rows on hover — the tint now honestly signals clickability; interactive rows
|
|
248
|
+
additionally gain a pressed (`:active`) fill via the new `--ds-table-row-pressed-bg-color` token
|
|
249
|
+
(default `--surface-muted`). To restore the old always-on hover on a specific passive table, add
|
|
250
|
+
consumer CSS: `ds-table tbody tr:hover td { background-color: var(--surface-secondary); }`.
|
|
251
|
+
- **`ds-table` row click yields to text selection.** On a `rowInteractive` table, a click that
|
|
252
|
+
finishes a mouse text selection no longer emits `rowClicked` — users can drag-select and copy
|
|
253
|
+
cell text without triggering the row's navigation. Only a selection created by that same
|
|
254
|
+
press-drag-release gesture counts (compared against a mousedown snapshot): a pre-existing
|
|
255
|
+
selection the browser can't collapse (e.g. over `user-select: none` content) never wedges row
|
|
256
|
+
clicks. Keyboard activation (Enter/Space) is unaffected.
|
|
257
|
+
|
|
258
|
+
- **Breaking: `ds-date-picker` input `defaultMonth` is renamed to `defaultDate`.** The input always
|
|
259
|
+
accepted a full `Date` and used its exact day (grid focus lands on that day, the panel opens on
|
|
260
|
+
its month) — the old name undersold it as month-only granularity. Behavior is unchanged: it only
|
|
261
|
+
positions the calendar when the value is empty and is never written to the value. Rename
|
|
262
|
+
`[defaultMonth]="…"` to `[defaultDate]="…"`.
|
|
263
|
+
- **`ds-select`, `ds-autocomplete`, `ds-multi-select`, `ds-time-picker`, `ds-color-picker` and
|
|
264
|
+
`ds-popover` overlay panels are now non-modal (no backdrop), matching `ds-date-picker`.** They drop
|
|
265
|
+
the transparent CDK backdrop (`hasBackdrop: true` + `backdropClick`-to-close) for
|
|
266
|
+
`hasBackdrop: false`, so while a panel is open the page behind it stays fully interactive — hover,
|
|
267
|
+
cursor and pointer all reach it, and an outside click both activates whatever it lands on and closes
|
|
268
|
+
the panel. Panels now dismiss on a pointer press outside the panel or on page scroll (a capture-phase
|
|
269
|
+
document scroll listener, since CDK scroll strategies miss a plain `overflow: auto` container).
|
|
270
|
+
Button-style triggers (`ds-select`, `ds-color-picker`, `ds-popover`, `ds-multi-select`) now toggle —
|
|
271
|
+
a click, or Enter/Space, on the trigger closes an open panel (previously a trigger click couldn't
|
|
272
|
+
close it); `ds-time-picker` segment buttons toggle the open segment and switch directly between the
|
|
273
|
+
start/end segments; `ds-autocomplete`'s text input keeps its click for caret placement (only its
|
|
274
|
+
chevron toggles), and typing that overflows the filter input no longer collapses the panel. Focus
|
|
275
|
+
returns to the trigger when a panel closes via Escape, a selection (e.g. a `ds-color-picker` preset)
|
|
276
|
+
or an in-panel control, but an outside-pointer/scroll close leaves focus where the user's click or
|
|
277
|
+
scroll put it (no focus stealing). `ds-modal` / `ModalService` are intentionally unaffected — they
|
|
278
|
+
stay modal. No public API or token changes.
|
|
279
|
+
- **`ds-toast` now slides up from below into place as it enters** (previously it dropped in from
|
|
280
|
+
slightly above). The exit animation is unchanged — the toast still slides up as it fades out.
|
|
281
|
+
Visual/motion only; no API change.
|
|
282
|
+
|
|
283
|
+
### Fixed
|
|
284
|
+
|
|
285
|
+
- **`ds-date-picker` no longer strands focus on `<body>` when the calendar closes by outside
|
|
286
|
+
click or page scroll.** The picker was already non-modal, but a scroll-close or
|
|
287
|
+
outside-pointer close left focus on the document body instead of the field. `close()` now
|
|
288
|
+
returns focus to the field (`preventScroll`) whenever focus was inside the calendar — with
|
|
289
|
+
one exception: a coarse-pointer device with an editable field (`allowInput`) is left alone,
|
|
290
|
+
to avoid re-summoning the soft keyboard, while a readonly field (`allowInput=false`) always
|
|
291
|
+
refocuses. Escape / selection / preset closes already refocused and are unchanged; no API
|
|
292
|
+
change.
|
|
293
|
+
|
|
11
294
|
## 0.6.2 — 2026-07-21
|
|
12
295
|
|
|
13
296
|
### Added
|
|
@@ -197,7 +480,8 @@ While the package is on `0.x`, minor releases may contain breaking changes.
|
|
|
197
480
|
`BadgeSemantic`, and `StatusValue` are removed. Migrate `variant="active"` → `status="active"`,
|
|
198
481
|
then define your own status colours via the new `styles/status` SCSS API (see Added) keyed on
|
|
199
482
|
`[data-status]`. `[count]` mode, `[solid]`, `[withDot]`, `[max]`, and the `--ds-badge-*` /
|
|
200
|
-
`--ds-status-dot-*` hooks are unchanged.
|
|
483
|
+
`--ds-status-dot-*` hooks are unchanged. Full migration guide (model, worked example, and the
|
|
484
|
+
case where a consumer coloured badges via its own status-named class): `migrations/0.5.1/badge-statuses.md`.
|
|
201
485
|
- **`title` is now required on `ds-drawer`, `ds-bottom-sheet`, and `ds-accordion-item`** (was
|
|
202
486
|
optional). Their `title` is the component's accessible name (dialog `aria-labelledby`) or the
|
|
203
487
|
disclosure-button label, so a missing title left them unnamed. `ds-modal` / `ds-modal-card` stay
|