@ids-group-ltd/ids-design-system 0.6.1 → 0.6.3
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 +206 -1
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +2636 -1770
- 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/README.md +6 -0
- package/package.json +1 -1
- package/styles/_typography.scss +169 -20
- package/types/ids-group-ltd-ids-design-system.d.ts +369 -16
package/CHANGELOG.md
CHANGED
|
@@ -8,6 +8,210 @@ While the package is on `0.x`, minor releases may contain breaking changes.
|
|
|
8
8
|
|
|
9
9
|
## Unreleased
|
|
10
10
|
|
|
11
|
+
## 0.6.3 — 2026-07-27
|
|
12
|
+
|
|
13
|
+
### Added
|
|
14
|
+
|
|
15
|
+
- **Typography utilities (`.t-*`) expose per-axis `--ds-t-*` token hooks.** Every `.t-display`/`.t-h1`
|
|
16
|
+
…`.t-mono-block` utility now reads each type property as a longhand through a public
|
|
17
|
+
`--ds-t-<name>-<prop>` custom property that falls back to the current semantic token —
|
|
18
|
+
`font-weight`, `font-size`, `line-height`, `font-family`, plus `letter-spacing` / `text-transform` /
|
|
19
|
+
`color` / `background-color` / `border-color` / `border-radius` where the class sets them. A consumer
|
|
20
|
+
can now retune a single axis in a scope (`[data-brand] .t-h3 { --ds-t-h3-font-weight: var(--font-weight-bold) }`)
|
|
21
|
+
without re-declaring the whole rule or forking the class — the same consumer-first `--ds-*` contract
|
|
22
|
+
the components use, extended to the global utility layer. Default rendering is unchanged (structural
|
|
23
|
+
box props — padding/margin/border-width/max-width/overflow — stay raw). Minor: the `font` shorthand
|
|
24
|
+
was split into longhands, so `.t-*` no longer force `font-style`/`font-variant` back to `normal`
|
|
25
|
+
(they inherit) — only observable inside an italic/small-caps ancestor.
|
|
26
|
+
- **`ds-table` row-action kebab menu.** New opt-in `rowActions` input renders a trailing ⋮ column;
|
|
27
|
+
the per-row button opens a `ds-menu` of the configured items (`id`, `label`, optional `icon`,
|
|
28
|
+
destructive `error`, per-row `disabled` predicate) and `rowActionSelected` emits `{ action, row }`
|
|
29
|
+
on pick. Off by default — tables without `rowActions` render exactly as before. Kebab clicks stop
|
|
30
|
+
propagation, so on a `rowInteractive` table a menu click never triggers `rowClicked`. New exported
|
|
31
|
+
types `TableRowAction` / `TableRowActionEvent`.
|
|
32
|
+
- **`ds-table` current-row highlight, client filter, and honored column fields.** New opt-in
|
|
33
|
+
`activeRowId` input marks one row as current (tinted via the new `--ds-table-row-active-bg-color`
|
|
34
|
+
token + `aria-current`) — e.g. the row whose detail drawer is open. New `filterQuery` input filters
|
|
35
|
+
rows client-side (case-insensitive substring over cell text; columns with `filterable: true`
|
|
36
|
+
restrict the match set, none marked = all columns) — sorting, pagination totals and the empty slot
|
|
37
|
+
all follow the filtered set. `TableColumn.width` (px, applied to the header cell),
|
|
38
|
+
`TableColumn.truncate` (ellipsis-clip at `width`, 240px fallback, full value in the title tooltip;
|
|
39
|
+
text cells only) and `TableColumn.hidden` (column skipped, still filterable/sortable) were declared
|
|
40
|
+
but ignored — they now work.
|
|
41
|
+
- **`ds-table` column picker.** Columns marked `hideable: true` (declared but ignored until now)
|
|
42
|
+
surface a picker button in the header's trailing cell — a checkbox popover toggles column
|
|
43
|
+
visibility, with `hidden: true` as the initial state and the last visible column locked so the
|
|
44
|
+
grid can't go empty. New two-way `hiddenKeys` model (`Set<string> | null`; `null`, the default,
|
|
45
|
+
derives the set from the `hidden` flags — binding a Set takes over and the flags are ignored).
|
|
46
|
+
- **`ds-table` inline cell editing.** Columns marked `editable: true` turn into a text input on
|
|
47
|
+
double-click; Enter or blur commits, Escape cancels. The table stays data-agnostic — it emits
|
|
48
|
+
`cellEdited` (`{ row, key, value }`, new exported `TableCellEditEvent` type) and the consumer owns
|
|
49
|
+
the data update.
|
|
50
|
+
- **`ds-table` per-column set filters.** A column marked `filter: 'set'` gets a header funnel
|
|
51
|
+
button opening a searchable checkbox list of that column's distinct values; unchecking narrows the
|
|
52
|
+
rows and the funnel highlights while a filter is active. State is two-way bindable via the new
|
|
53
|
+
`columnFilters` model (`Map<key, Set<value>>` — the still-checked values; a column absent or fully
|
|
54
|
+
checked reads as unfiltered) and combines with `filterQuery`.
|
|
55
|
+
- **`ds-table` column resizing.** New opt-in `resizableColumns` input adds a drag handle to each
|
|
56
|
+
column header's right edge; widths are two-way bindable via the new `columnWidths` model
|
|
57
|
+
(`Map<key, px>`), seeded from `column.width`. The header clips its label so a narrowed column
|
|
58
|
+
can't spill into its neighbour.
|
|
59
|
+
- **`ds-table` column reordering.** New opt-in `reorderableColumns` input adds a drag handle and
|
|
60
|
+
up/down buttons to each row of the column panel (which now lists every column, not just hideable
|
|
61
|
+
ones); the order is two-way bindable via the new `columnOrder` model (`string[] | null`, `null` =
|
|
62
|
+
declaration order), and the panel's `Reset to default` resets all three column models — order,
|
|
63
|
+
visibility **and** widths (`columnOrder`, `hiddenKeys`, `columnWidths`). The panel surfaces
|
|
64
|
+
whenever any column is `hideable` **or** `reorderableColumns` is set.
|
|
65
|
+
- **`ds-table` CSV export.** New public `exportCsv(filename?)` method downloads the visible columns
|
|
66
|
+
of the filtered + sorted rows (all rows, not just the current page) as a UTF-8 CSV — wire it to a
|
|
67
|
+
consumer toolbar button via a template reference.
|
|
68
|
+
- **`ds-table` density, zebra striping and capped scroll height.** New `density="compact"` input
|
|
69
|
+
tightens cell padding for spreadsheet-dense lists; `zebra` tints odd rows (via the new
|
|
70
|
+
`--ds-table-row-stripe-bg-color` token); `maxHeight` (any CSS length) caps the scroll body and
|
|
71
|
+
scrolls it vertically, pairing with `stickyHeader` for a self-contained scroll region. All opt-in.
|
|
72
|
+
- **`ds-table` sticky horizontal scrollbar.** New opt-in `stickyScrollbar` input hides the scroll
|
|
73
|
+
container's native horizontal bar and renders a proxy scrollbar stuck to the bottom of the nearest
|
|
74
|
+
scroll ancestor while the table is in view, mirroring `scrollLeft` both ways — on a tall, wide
|
|
75
|
+
table the horizontal bar stays reachable without scrolling to the table's end. The proxy hides
|
|
76
|
+
itself when the table doesn't overflow.
|
|
77
|
+
- **`ds-table` truncated cells open a full-value popover on click.** A `truncate` column's clipped
|
|
78
|
+
cell now shows its complete text in a popover when clicked (in addition to the existing title
|
|
79
|
+
tooltip); the click is swallowed so it never doubles as a row click, while an unclipped cell
|
|
80
|
+
passes the click through to the row unchanged.
|
|
81
|
+
- **`ds-app-shell` — slotted fixed-frame application shell.** `[sidenav]`/`[topbar]`/default
|
|
82
|
+
content slots; the host pins to the viewport (`100dvh`, `overflow: hidden`) and ONLY the content
|
|
83
|
+
`<main>` scrolls (`scrollbar-gutter: stable` + automatic native-scrollbar-width padding
|
|
84
|
+
compensation via the new `--ds-scrollbar-width` root variable). `topbarSpan` input switches the
|
|
85
|
+
geometry (`'content'` default: full-height rail; `'full'`: full-width topbar). Built-in
|
|
86
|
+
scroll-to-top on router navigation via the new exported `ShellScrollService` (also injectable
|
|
87
|
+
from routed pages for manual `scrollToTop()`). Tokens: `--ds-app-shell-pad-x/-pad-y/`
|
|
88
|
+
`-content-max-width/-height`.
|
|
89
|
+
- **`ds-sidenav-footer` — rail footer brick.** Search row with a live grouped-results popover
|
|
90
|
+
(Enter opens the first hit), Alerts row with an unread dot + feed popover, Collapse row, and a
|
|
91
|
+
user card with an account menu. Inputs `userName`/`userRole`/`alerts`/`collapsed`/
|
|
92
|
+
`searchProvider`/`alertItems`/`profileRoute`; outputs `collapseToggled`/`alertsOpened`/
|
|
93
|
+
`signOutSelected`. New exported types `SidenavSearchProvider`/`SidenavSearchResult`/
|
|
94
|
+
`SidenavAlertItem`. Tokens: `--ds-sidenav-footer-popover-width/-popover-max-width/`
|
|
95
|
+
`-popover-max-height/-head-tracking/-dot-size`.
|
|
96
|
+
- **`ds-sidenav` brand-row logo glyph + wordmark projection.** New optional `logoLetter` input sets
|
|
97
|
+
the tile glyph when it differs from the brand's first letter. A new `[dsBrandName]` projection
|
|
98
|
+
slot (exported marker directive `BrandNameDirective`) lets consumers project custom wordmark
|
|
99
|
+
markup — two-tone wordmarks, inline logos — which renders inside `.brand-name` in place of the
|
|
100
|
+
plain `brand` text. Both are optional; omitting them renders exactly as before.
|
|
101
|
+
|
|
102
|
+
### Changed
|
|
103
|
+
|
|
104
|
+
- **`ds-input`, `ds-search` and `ds-textarea` focus the control when the frame chrome is clicked.**
|
|
105
|
+
Clicking a leading/trailing icon, a prefix/suffix add-on, or the frame padding now focuses the
|
|
106
|
+
inner `input`/`textarea` instead of doing nothing — the whole field box is a focus target, matching
|
|
107
|
+
native `<label>` behaviour. Clicks on nested controls (projected buttons, the clear ✕, the password
|
|
108
|
+
toggle) are left untouched. Driven by the new exported `FieldClickFocusDirective`
|
|
109
|
+
(`[dsFieldClickFocus]`), which consumers can apply to their own field wrappers. Overlay-trigger
|
|
110
|
+
fields (`ds-autocomplete`, `ds-date-picker`, `ds-select`, `ds-multi-select`, `ds-color-picker`)
|
|
111
|
+
already focused on trigger click and are unchanged.
|
|
112
|
+
- **`ds-table` row hover/pressed tints are now exclusive to `rowInteractive` tables.** Passive
|
|
113
|
+
tables no longer tint rows on hover — the tint now honestly signals clickability; interactive rows
|
|
114
|
+
additionally gain a pressed (`:active`) fill via the new `--ds-table-row-pressed-bg-color` token
|
|
115
|
+
(default `--surface-muted`). To restore the old always-on hover on a specific passive table, add
|
|
116
|
+
consumer CSS: `ds-table tbody tr:hover td { background-color: var(--surface-secondary); }`.
|
|
117
|
+
- **`ds-table` row click yields to text selection.** On a `rowInteractive` table, a click that
|
|
118
|
+
finishes a mouse text selection no longer emits `rowClicked` — users can drag-select and copy
|
|
119
|
+
cell text without triggering the row's navigation. Only a selection created by that same
|
|
120
|
+
press-drag-release gesture counts (compared against a mousedown snapshot): a pre-existing
|
|
121
|
+
selection the browser can't collapse (e.g. over `user-select: none` content) never wedges row
|
|
122
|
+
clicks. Keyboard activation (Enter/Space) is unaffected.
|
|
123
|
+
|
|
124
|
+
- **Breaking: `ds-date-picker` input `defaultMonth` is renamed to `defaultDate`.** The input always
|
|
125
|
+
accepted a full `Date` and used its exact day (grid focus lands on that day, the panel opens on
|
|
126
|
+
its month) — the old name undersold it as month-only granularity. Behavior is unchanged: it only
|
|
127
|
+
positions the calendar when the value is empty and is never written to the value. Rename
|
|
128
|
+
`[defaultMonth]="…"` to `[defaultDate]="…"`.
|
|
129
|
+
- **`ds-select`, `ds-autocomplete`, `ds-multi-select`, `ds-time-picker`, `ds-color-picker` and
|
|
130
|
+
`ds-popover` overlay panels are now non-modal (no backdrop), matching `ds-date-picker`.** They drop
|
|
131
|
+
the transparent CDK backdrop (`hasBackdrop: true` + `backdropClick`-to-close) for
|
|
132
|
+
`hasBackdrop: false`, so while a panel is open the page behind it stays fully interactive — hover,
|
|
133
|
+
cursor and pointer all reach it, and an outside click both activates whatever it lands on and closes
|
|
134
|
+
the panel. Panels now dismiss on a pointer press outside the panel or on page scroll (a capture-phase
|
|
135
|
+
document scroll listener, since CDK scroll strategies miss a plain `overflow: auto` container).
|
|
136
|
+
Button-style triggers (`ds-select`, `ds-color-picker`, `ds-popover`, `ds-multi-select`) now toggle —
|
|
137
|
+
a click, or Enter/Space, on the trigger closes an open panel (previously a trigger click couldn't
|
|
138
|
+
close it); `ds-time-picker` segment buttons toggle the open segment and switch directly between the
|
|
139
|
+
start/end segments; `ds-autocomplete`'s text input keeps its click for caret placement (only its
|
|
140
|
+
chevron toggles), and typing that overflows the filter input no longer collapses the panel. Focus
|
|
141
|
+
returns to the trigger when a panel closes via Escape, a selection (e.g. a `ds-color-picker` preset)
|
|
142
|
+
or an in-panel control, but an outside-pointer/scroll close leaves focus where the user's click or
|
|
143
|
+
scroll put it (no focus stealing). `ds-modal` / `ModalService` are intentionally unaffected — they
|
|
144
|
+
stay modal. No public API or token changes.
|
|
145
|
+
- **`ds-toast` now slides up from below into place as it enters** (previously it dropped in from
|
|
146
|
+
slightly above). The exit animation is unchanged — the toast still slides up as it fades out.
|
|
147
|
+
Visual/motion only; no API change.
|
|
148
|
+
|
|
149
|
+
### Fixed
|
|
150
|
+
|
|
151
|
+
- **`ds-date-picker` no longer strands focus on `<body>` when the calendar closes by outside
|
|
152
|
+
click or page scroll.** The picker was already non-modal, but a scroll-close or
|
|
153
|
+
outside-pointer close left focus on the document body instead of the field. `close()` now
|
|
154
|
+
returns focus to the field (`preventScroll`) whenever focus was inside the calendar — with
|
|
155
|
+
one exception: a coarse-pointer device with an editable field (`allowInput`) is left alone,
|
|
156
|
+
to avoid re-summoning the soft keyboard, while a readonly field (`allowInput=false`) always
|
|
157
|
+
refocuses. Escape / selection / preset closes already refocused and are unchanged; no API
|
|
158
|
+
change.
|
|
159
|
+
|
|
160
|
+
## 0.6.2 — 2026-07-21
|
|
161
|
+
|
|
162
|
+
### Added
|
|
163
|
+
|
|
164
|
+
- **`ds-sidenav` accepts a projected `[brand]` slot for a custom logo.** A
|
|
165
|
+
`<ng-content select="[brand]">` now sits in the brand row at the top of the rail, so consumers
|
|
166
|
+
can project an `img`/SVG/any markup as the logo instead of — or alongside — the string `brand`
|
|
167
|
+
input. The string `brand` input is unchanged (it still renders an auto letter-mark from the
|
|
168
|
+
first character plus the brand name). The brand row, previously gated on the string `brand`
|
|
169
|
+
being set, now always renders and hides itself via `:empty` when there is neither brand text
|
|
170
|
+
nor projected content, so the empty state is identical to before.
|
|
171
|
+
|
|
172
|
+
### Fixed
|
|
173
|
+
|
|
174
|
+
- **`ds-bottom-sheet` Escape is now scoped to its own panel instead of the document.** The sheet
|
|
175
|
+
bound `(document:keydown.escape)`, whereas modal and drawer scope Escape to their panel; with
|
|
176
|
+
stacked overlays this let a background sheet steal the Escape meant for the overlay on top. The
|
|
177
|
+
binding moves to `(keydown.escape)` on the sheet's overlay element, mirroring modal — the focus
|
|
178
|
+
trap auto-captures focus inside the sheet so Escape lands on the panel (sheets whose body has no
|
|
179
|
+
focusable content now need one for Escape to reach them), and a stacked overlay above the sheet
|
|
180
|
+
no longer has its Escape consumed underneath.
|
|
181
|
+
- **`ds-date-picker` mobile Backspace/Delete removes one digit and crosses separators instead of
|
|
182
|
+
wiping the whole segment.** Following 0.6.1's routing of mobile edits through `beforeinput`,
|
|
183
|
+
Gboard reports Backspace/Delete with a full-segment "selection" (its composing region), which
|
|
184
|
+
hit the segment editor's selection-clear branch and erased the entire segment (e.g. all of
|
|
185
|
+
`MM`) on one tap — also defeating 0.6.1's separator-crossing behaviour. The mobile `beforeinput`
|
|
186
|
+
path now collapses the selection to the caret edge (`selectionEnd` for Backspace,
|
|
187
|
+
`selectionStart` for Delete) before editing, forcing the single-character branch so one tap
|
|
188
|
+
deletes exactly one digit and crosses a `/` separator, matching desktop `keydown`.
|
|
189
|
+
- **`ds-bottom-sheet` no longer jolts all host-app content up then down as it opens.** The `.sheet`
|
|
190
|
+
enters via `translateY(100%) → none` inside the `position: fixed; inset: 0` `.sheet-overlay`, and
|
|
191
|
+
`cdkTrapFocusAutoCapture` focuses the panel's first tabbable at frame ~0 via `element.focus()`
|
|
192
|
+
without `preventScroll` — while the panel still sticks out below the frame. In consumer shells that
|
|
193
|
+
are a containing block for fixed descendants (`filter`/`transform`) combined with `overflow: hidden`
|
|
194
|
+
(e.g. a centred "phone frame"), the still-translated panel contributes scrollable overflow to that
|
|
195
|
+
shell, so the focus scroll-into-view yanks the shell's `scrollTop` up by ≈ the sheet height (all app
|
|
196
|
+
content jumps up in one frame); as the enter animation lands the overflow vanishes and the browser
|
|
197
|
+
clamps the scroll back to 0 (content slides back down). `.sheet-overlay` now uses `overflow: clip`,
|
|
198
|
+
which clips the translating panel so it never leaks scrollable overflow to consumer ancestors and —
|
|
199
|
+
unlike `hidden` — is not programmatically scrollable, so scroll-into-view cannot move it either. No
|
|
200
|
+
visual change: the panel was already visually cut at the frame edge.
|
|
201
|
+
- **`ds-drawer` no longer scroll-jolts host-app content as it opens.** Same bug class as the
|
|
202
|
+
bottom-sheet fix: the `.drawer` panel was itself `position: fixed` (a sibling of the fixed
|
|
203
|
+
`.drawer-scrim`) sliding in from `translateX/Y(±100%)` under the same `cdkTrapFocusAutoCapture`, so
|
|
204
|
+
the right/bottom (positive-direction) placements leaked scrollable overflow into the same kind of
|
|
205
|
+
containing-block-plus-`overflow: hidden` consumer frames. The scrim and panel are now wrapped in a
|
|
206
|
+
`.drawer-root` div (`position: fixed; inset: 0; z-index: var(--layer-modal); overflow: clip`) and
|
|
207
|
+
both children switched from `fixed` to `absolute`, so the wrapper genuinely clips them (fixed
|
|
208
|
+
descendants would escape an ancestor's clip); geometry is identical in normal and framed apps across
|
|
209
|
+
all four placements, including the RTL left-drawer case. `isolation: isolate` was added to `.drawer`
|
|
210
|
+
to preserve the stacking context the old `fixed` + `z-index` panel provided, so negative-`z-index`
|
|
211
|
+
content projected into the drawer body can't sink under the scrim. No public API or token change:
|
|
212
|
+
scrim click-to-close, panel-scoped plus document-level Escape, `animationend` teardown, and the focus
|
|
213
|
+
trap are all unchanged.
|
|
214
|
+
|
|
11
215
|
## 0.6.1 — 2026-07-16
|
|
12
216
|
|
|
13
217
|
### Fixed
|
|
@@ -142,7 +346,8 @@ While the package is on `0.x`, minor releases may contain breaking changes.
|
|
|
142
346
|
`BadgeSemantic`, and `StatusValue` are removed. Migrate `variant="active"` → `status="active"`,
|
|
143
347
|
then define your own status colours via the new `styles/status` SCSS API (see Added) keyed on
|
|
144
348
|
`[data-status]`. `[count]` mode, `[solid]`, `[withDot]`, `[max]`, and the `--ds-badge-*` /
|
|
145
|
-
`--ds-status-dot-*` hooks are unchanged.
|
|
349
|
+
`--ds-status-dot-*` hooks are unchanged. Full migration guide (model, worked example, and the
|
|
350
|
+
case where a consumer coloured badges via its own status-named class): `migrations/0.5.1/badge-statuses.md`.
|
|
146
351
|
- **`title` is now required on `ds-drawer`, `ds-bottom-sheet`, and `ds-accordion-item`** (was
|
|
147
352
|
optional). Their `title` is the component's accessible name (dialog `aria-labelledby`) or the
|
|
148
353
|
disclosure-button label, so a missing title left them unnamed. `ds-modal` / `ds-modal-card` stay
|