@ids-group-ltd/ids-design-system 0.9.0 → 0.10.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.
@@ -1,134 +0,0 @@
1
- # Migrating to the next release
2
-
3
- The manifest (`../unreleased.json`) is the terse machine mirror — what a tool applies.
4
- This is the human half: **where to look, what to change, and what you can now delete.**
5
-
6
- > **If you are on 0.7.x**, you are taking two releases at once. Read the 0.8.0 notes
7
- > first; everything below is on top of them.
8
-
9
- ---
10
-
11
- ## 1. What breaks — eight things, by where you will find them
12
-
13
- Work through them in this order. The first three are one rename and are best done together.
14
-
15
- ### In your templates
16
-
17
- | Look for | Change to | Notes |
18
- | --- | --- | --- |
19
- | `<ds-auth-shell>` | `<ds-auth-layout>` | Inputs, outputs and slots all keep their names |
20
- | `sortMode` / `filterMode` **absent** on a `ds-table` | Add `sortMode="client"` (and `filterMode="client"`) **if the table holds every row** | The default flipped to `"server"`. See §2 |
21
-
22
- ### In your TypeScript
23
-
24
- | Look for | Change to |
25
- | --- | --- |
26
- | `AuthShellComponent` | `AuthLayoutComponent` |
27
-
28
- ### In your stylesheets
29
-
30
- | Look for | Change to | Notes |
31
- | --- | --- | --- |
32
- | `--ds-auth-shell-*` | `--ds-auth-layout-*` | Six tokens. **Do not** rename `--auth-card-w` — it carries no such prefix |
33
- | `--search-h` | `--ds-search-height`, or `--ds-field-height` for the whole family | The global token is gone; a declaration of it is now inert |
34
-
35
- ### Visual changes to eyeball
36
-
37
- - **`ds-search` is 40px tall, was 36px.** It was the only control in the library on that
38
- height. Restore with `ds-search { --ds-search-height: 36px; }` if your toolbar depends
39
- on it — but see §3 first, because a pin may not be what you want.
40
- - **`ds-number-stepper` at `size="lg"` is 48px, was 44px.** Other sizes unchanged.
41
-
42
- ### Worth a deliberate pass, not a find/replace
43
-
44
- - **Signal Forms bind to DS controls.** `<ds-input [formField]="f.email" />` — that is the whole
45
- integration; `[formField]` comes from `@angular/forms/signals`, not from this library. Thirteen
46
- of fifteen controls already bound before this release; the other two, and the `readonly()`,
47
- `pattern()`, `minLength()` and `hidden()` rules, work now. If you hand-bound
48
- `[value]="f.x().value()" (valueChange)="f.x().value.set($event)"` per field, **all of that can
49
- go.** Give each validator a `message`, or map the kinds once in `provideDsConfig`, or the field
50
- turns red with no words. See the Practice → Signal Forms page.
51
-
52
- - **`ds-tabs` can now own the URL.** Set `urlParam="tab"` and the active tab survives F5,
53
- a shared link and the Back button. Per strip: give each `ds-tab` a `value` (the URL is
54
- written from it, so without one your links carry the visible label and break when it is
55
- reworded), use **one parameter name per strip** (two strips sharing a name erase each
56
- other — there is a dev warning), and delete any hand-rolled `queryParamMap` + `navigate()`
57
- wiring, which would otherwise fight it.
58
-
59
- ---
60
-
61
- ## 2. The one that needs judgement per table
62
-
63
- `sortMode` and `filterMode` default to `'server'` now, where they used to default to
64
- `'client'`.
65
-
66
- **Why it changed:** server-paged is the normal case, and there the old default was
67
- actively wrong — the table sorted the page in hand, so rows looked sorted and were not.
68
-
69
- **How to decide, per table:**
70
-
71
- - **Binds `total`?** It is server-paged. The new default is what you wanted; do nothing.
72
- - **Does not bind `total`?** It almost certainly holds every row. Add `sortMode="client"`,
73
- and `filterMode="client"` if any column has `filter: 'set'` — otherwise the headers stay
74
- clickable and do nothing.
75
-
76
- **How to find them all:** run the app in dev and read the console. A reversed dev warning
77
- now fires on exactly the case that needs your attention (no `total`, sortable or filterable
78
- columns, no declared mode) and names each table.
79
-
80
- ---
81
-
82
- ## 3. What you can now DELETE — the half a migration guide usually leaves out
83
-
84
- Two dogfooding audits (mm-ecm 2026-08-06, mm-broker 2026-08-07) read consumer stylesheets
85
- as a record of what this library made them write. Both found the same thing: **most of the
86
- workarounds were written against hooks that already existed** — the consumer had no signal
87
- that anything had been tokenised since. That is a failure of these notes, not of the
88
- consumer, so here is the list.
89
-
90
- Search your styles for these; if you find them, they can go.
91
-
92
- | If you have | Delete it, because |
93
- | --- | --- |
94
- | `.button.button.button { … }` or rules against `.v-outline` / `.c-secondary` | `ds-button` reflects `[data-variant]` and `[data-color]` on the HOST. Use `ds-button[data-variant="outline"]` |
95
- | `--radius-sm: 0` to square a checkbox | `--ds-checkbox-radius` |
96
- | `.title.title { font-size }` inside a modal | `--ds-modal-title-font-size` |
97
- | Pagination label type overrides | `--ds-pagination-label-*` |
98
- | `.size { display: none }` on a pager | `[showPageSize]="false"` — and it is now forwarded through `ds-table` too |
99
- | `.actions:empty { display: none }` on a modal | The library already ships it |
100
- | `--ds-modal-divider: transparent`, plus whatever you rewrote the modal padding to afterwards | `[dividers]="false"` — it drops the rules *and* the padding that existed to clear them |
101
- | A defensive hover rule on the selected dropdown row | The `:not(.is-selected)` branch already handles it |
102
- | `ds-menu-divider { padding: 0 }` | `--ds-menu-divider-spacing`, which already defaults to 0 |
103
- | A dozen scattered `--ds-*-radius: 0` | For a fully square brand, four lines: `--radius-sm/md/lg/xl: 0` (leave `--radius-pill`). Measured — the three ROLES alone leave options, clear buttons and dropdown panels rounded; they are the tool for squaring one family and keeping another. Worked example on the Theming page |
104
- | A global rule squaring `.ds-overlay-pane` | Radius and elevation roles now travel onto portaled panes when the host overrides them |
105
- | Absolutely positioning a search glyph over an autocomplete, or hiding `.autocomplete-chevron` | `dsAutocompletePrefix` and `[showChevron]="false"` |
106
- | Querying the autocomplete's inner `<input>` and dispatching a synthetic `input` event to clear it | `clear()` |
107
- | A hand-built KPI tile whose value is a badge | `ds-stat` takes a projected `[dsStatValue]` |
108
- | A pinned `--ds-search-height` (or any sibling) to get a shorter control row | `density="compact"` on the container — every field control is 32px there, measured |
109
- | A hand-rolled `.scrim` + `.panel` dialog, written because the modal header could not hold a badge or a second line | `ds-modal` projects `[title-badge]` and takes a `subtitle`. You get back the focus trap, focus restore, the scroll lock, Escape and the footer |
110
- | `[value]="f.x().value()" (valueChange)="f.x().value.set($event)"` on every field of a signal form | `[formField]="f.x"` — the control implements the contract already |
111
- | `white-space: normal` forced onto a badge in a table cell | `--ds-badge-white-space` |
112
- | `::ng-deep .card { height: 100% }` for equal-height cards | The card's box fills a stretched host on its own |
113
- | `!important` on `ds-table` cell padding under `density="compact"` | Compact no longer out-specifies the padding hooks |
114
- | A wrapper around `ds-table` for sort/range announcements, keyboard column resize, or a header filter the checklist cannot express | All three ship: the live region, the `role="separator"` handle, and `dsHeaderFilter` |
115
-
116
- **How to check you got them all:** grep your styles for `::ng-deep`, `!important` and any
117
- selector naming a DS internal class (`.button`, `.trigger`, `.option`, `.modal`). Each hit
118
- is either a genuine gap worth reporting or an entry in the table above.
119
-
120
- ---
121
-
122
- ## 4. After you bump
123
-
124
- - **Run the app in dev with the console open.** The library warns about the combinations it
125
- cannot fix for you: undeclared sort/filter mode, duplicate `urlParam`, lazy without
126
- `virtualScroll`, an unknown icon name, a projected stat value with an orphaned `unit`.
127
- Every warning names the component and what to do.
128
- - **Check a toolbar and a form row side by side.** The field-height contract moved
129
- `ds-search`, so anything you had lined up by hand is worth a second look. If you pin
130
- heights per component, consider `[data-density]` instead — it retunes the whole family at
131
- once and survives the next change of this kind.
132
- - **Tell us what you had to hand-roll.** The delete list in §3 exists because two consumers
133
- wrote forty lines of workarounds against hooks that were already there. If you are
134
- reaching into a DS internal, that is a gap worth filing.