@ids-group-ltd/ids-design-system 0.6.2 → 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 CHANGED
@@ -8,6 +8,155 @@ 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
+
11
160
  ## 0.6.2 — 2026-07-21
12
161
 
13
162
  ### Added
@@ -197,7 +346,8 @@ While the package is on `0.x`, minor releases may contain breaking changes.
197
346
  `BadgeSemantic`, and `StatusValue` are removed. Migrate `variant="active"` → `status="active"`,
198
347
  then define your own status colours via the new `styles/status` SCSS API (see Added) keyed on
199
348
  `[data-status]`. `[count]` mode, `[solid]`, `[withDot]`, `[max]`, and the `--ds-badge-*` /
200
- `--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`.
201
351
  - **`title` is now required on `ds-drawer`, `ds-bottom-sheet`, and `ds-accordion-item`** (was
202
352
  optional). Their `title` is the component's accessible name (dialog `aria-labelledby`) or the
203
353
  disclosure-button label, so a missing title left them unnamed. `ds-modal` / `ds-modal-card` stay