@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.
- package/CHANGELOG.md +801 -13
- package/components.md +13 -13
- package/design-system.md +178 -7
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +1097 -339
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.10.0.json +407 -0
- package/migrations/0.6.1.json +9 -0
- package/migrations/0.6.2.json +24 -0
- package/migrations/0.8.0.json +4 -2
- package/migrations/0.9.0.json +50 -3
- package/migrations/0.9.1.json +10 -0
- package/migrations/AUTHORING.md +8 -0
- package/migrations/README.md +27 -15
- package/package.json +1 -1
- package/styles/_chip-row.scss +32 -0
- package/styles/_dropdown-overlay.scss +9 -2
- package/styles/_field-group-segment.scss +29 -0
- package/styles/_field-state.scss +38 -0
- package/styles/_focus.scss +8 -0
- package/styles/_link.scss +21 -0
- package/styles/_tokens.scss +8 -9
- package/styles/_visually-hidden.scss +14 -0
- package/types/ids-group-ltd-ids-design-system.d.ts +505 -145
- package/migrations/unreleased/README.md +0 -134
|
@@ -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.
|