@ids-group-ltd/ids-design-system 0.9.0 → 0.9.1
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 +81 -10
- package/design-system.md +178 -7
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +36 -0
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.9.0.json +23 -2
- package/migrations/README.md +21 -12
- package/package.json +1 -1
- package/types/ids-group-ltd-ids-design-system.d.ts +21 -0
- package/migrations/unreleased/README.md +0 -134
package/CHANGELOG.md
CHANGED
|
@@ -8,8 +8,81 @@ While the package is on `0.x`, minor releases may contain breaking changes.
|
|
|
8
8
|
|
|
9
9
|
## Unreleased
|
|
10
10
|
|
|
11
|
+
## 0.9.1 — 2026-08-10
|
|
12
|
+
|
|
13
|
+
### Added
|
|
14
|
+
|
|
15
|
+
- **The token and component reference now documents every public token and prop** — 41 were
|
|
16
|
+
shipping with a name, a type and no description: 10 `--ds-*` tokens (the whole
|
|
17
|
+
`--ds-password-rules-*` set among them, plus `--ds-multi-select-panel-bg-color` and
|
|
18
|
+
`--ds-menu-item-radius`) and 31 inputs and outputs across `ds-calendar-day`, `ds-time-columns`,
|
|
19
|
+
`ds-field-message`, `ds-divider`, `ds-sidenav-footer` and the three layout primitives. **Three of
|
|
20
|
+
them were guessable wrong**, so check yours if you use them: `ds-time-columns` `value` is always
|
|
21
|
+
`HH:mm` in 24h and `format` changes only the DISPLAY, so a 12h picker still emits 24h;
|
|
22
|
+
`minTime`/`maxTime` disable the out-of-range rows rather than removing them, so the columns keep
|
|
23
|
+
their height as a bound moves; and `ds-calendar-day` `tabIndex` is a roving tabindex (one cell at
|
|
24
|
+
0, the rest at -1), not a tab position you set per day. No behaviour changed — only what the
|
|
25
|
+
reference tells you.
|
|
26
|
+
|
|
27
|
+
### Fixed
|
|
28
|
+
|
|
29
|
+
- **The changelog page on the docs site was rendering with browser defaults.** Its markdown styles
|
|
30
|
+
were scoped by emulated encapsulation, which stamps its attribute on the container but not on the
|
|
31
|
+
nodes the markdown renderer produces — so every rule in that block matched nothing: measured
|
|
32
|
+
border-top 0px and margin-top 0px on the version headings, and `h3` white instead of
|
|
33
|
+
`--text-secondary`. Docs-site only, nothing in the package.
|
|
34
|
+
|
|
35
|
+
### Changed
|
|
36
|
+
|
|
37
|
+
- **`migrations/<version>.json` now carries the delete-list, so an upgrade tool can act on it.**
|
|
38
|
+
Each version's manifest gains `DELETE-LIST: if you have <X> -> <why it can go>` entries — 21 of
|
|
39
|
+
them for 0.9.0 — naming the workarounds that release made unnecessary, from the
|
|
40
|
+
`.button.button.button` triple-class to hand-binding `[value]`/`(valueChange)` on every field of a
|
|
41
|
+
signal form. They existed for 0.9.0 but only in a prose file the tooling does not read, so nothing
|
|
42
|
+
applied them. **Nothing here is required**: skipping it leaves working code that is merely
|
|
43
|
+
redundant. The same table is in this file under 0.9.0 if you would rather read than run.
|
|
44
|
+
`migrations/unreleased/README.md` no longer ships — it duplicated the manifest and had already gone
|
|
45
|
+
stale inside one release.
|
|
46
|
+
|
|
11
47
|
## 0.9.0 — 2026-08-10
|
|
12
48
|
|
|
49
|
+
### What you can now DELETE
|
|
50
|
+
|
|
51
|
+
The half a release note usually leaves out. Two dogfooding audits (mm-ecm 2026-08-06, mm-broker
|
|
52
|
+
2026-08-07) read consumer stylesheets as a record of what this library made them write, and both
|
|
53
|
+
found the same thing: **most of the workarounds were written against hooks that already existed** —
|
|
54
|
+
the consumer had no signal that anything had been tokenised since. That is a failure of these notes,
|
|
55
|
+
not of the consumer. None of this is required; skipping it leaves working code that is merely
|
|
56
|
+
redundant.
|
|
57
|
+
|
|
58
|
+
| If you have | Delete it, because |
|
|
59
|
+
| --- | --- |
|
|
60
|
+
| `.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"]` |
|
|
61
|
+
| `--radius-sm: 0` to square a checkbox | `--ds-checkbox-radius` |
|
|
62
|
+
| `.title.title { font-size }` inside a modal | `--ds-modal-title-font-size` |
|
|
63
|
+
| Pagination label type overrides | `--ds-pagination-label-*` |
|
|
64
|
+
| `.size { display: none }` on a pager | `[showPageSize]="false"` — and it is now forwarded through `ds-table` too |
|
|
65
|
+
| `.actions:empty { display: none }` on a modal | The library already ships it |
|
|
66
|
+
| `--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 |
|
|
67
|
+
| A defensive hover rule on the selected dropdown row | The `:not(.is-selected)` branch already handles it |
|
|
68
|
+
| `ds-menu-divider { padding: 0 }` | `--ds-menu-divider-spacing`, which already defaults to 0 |
|
|
69
|
+
| 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 |
|
|
70
|
+
| A global rule squaring `.ds-overlay-pane` | Radius and elevation roles now travel onto portaled panes when the host overrides them |
|
|
71
|
+
| Absolutely positioning a search glyph over an autocomplete, or hiding `.autocomplete-chevron` | `dsAutocompletePrefix` and `[showChevron]="false"` |
|
|
72
|
+
| Querying the autocomplete's inner `<input>` and dispatching a synthetic `input` event to clear it | `clear()` |
|
|
73
|
+
| A hand-built KPI tile whose value is a badge | `ds-stat` takes a projected `[dsStatValue]` |
|
|
74
|
+
| 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 |
|
|
75
|
+
| 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 |
|
|
76
|
+
| `[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 |
|
|
77
|
+
| `white-space: normal` forced onto a badge in a table cell | `--ds-badge-white-space` |
|
|
78
|
+
| `::ng-deep .card { height: 100% }` for equal-height cards | The card's box fills a stretched host on its own |
|
|
79
|
+
| `!important` on `ds-table` cell padding under `density="compact"` | Compact no longer out-specifies the padding hooks |
|
|
80
|
+
| 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` |
|
|
81
|
+
|
|
82
|
+
**To sweep for the rest:** grep your styles for `::ng-deep`, `!important` and any selector naming a
|
|
83
|
+
DS internal class (`.button`, `.trigger`, `.option`, `.modal`). Each hit is either a row above or a
|
|
84
|
+
genuine gap worth reporting.
|
|
85
|
+
|
|
13
86
|
### Changed (breaking, behaviour)
|
|
14
87
|
|
|
15
88
|
- **`ds-table` `sortMode` and `filterMode` default to `'server'`, were `'client'`.** Server-paged is the
|
|
@@ -43,6 +116,14 @@ While the package is on `0.x`, minor releases may contain breaking changes.
|
|
|
43
116
|
|
|
44
117
|
### Changed
|
|
45
118
|
|
|
119
|
+
- **`--ds-radius-inner` now reaches the small affordances it was written for.** Thirty-three reads across
|
|
120
|
+
fifteen component stylesheets took `var(--radius-sm)` directly — dropdown options, field clear buttons,
|
|
121
|
+
calendar days, chips, tag and toast close buttons — so the role a consumer is told to retune reached
|
|
122
|
+
exactly one component. Nothing moves (the role's default IS `--radius-sm`, verified by measuring a page
|
|
123
|
+
before and after), but it changes what a square brand costs: zeroing the three radius roles used to leave
|
|
124
|
+
five surfaces rounded and now squares every one. Five focus-ring radii inside `:focus-visible` keep
|
|
125
|
+
following the raw scale deliberately — a ring traces a box, it is not a surface a brand designs.
|
|
126
|
+
|
|
46
127
|
- **`ds-auth-layout` compresses its own chrome on a short viewport, so the layout is never the reason a
|
|
47
128
|
card scrolls.** Block padding, the column gap, the letter-mark tile and the masthead's inner gap clamp
|
|
48
129
|
against `svh`. At ~330px of viewport — a landscape phone — that furniture costs ~131px instead of ~219px.
|
|
@@ -86,16 +167,6 @@ While the package is on `0.x`, minor releases may contain breaking changes.
|
|
|
86
167
|
called a shell in 0.8.0 reintroduced the split vocabulary that rename existed to remove. Mechanical:
|
|
87
168
|
rename the tag, the class and the six tokens. Nothing about the behaviour or the slots changes.
|
|
88
169
|
|
|
89
|
-
### Changed (internal, no action)
|
|
90
|
-
|
|
91
|
-
- **`--ds-radius-inner` now reaches the small affordances it was written for.** Thirty-three reads across
|
|
92
|
-
fifteen component stylesheets took `var(--radius-sm)` directly — dropdown options, field clear buttons,
|
|
93
|
-
calendar days, chips, tag and toast close buttons — so the role a consumer is told to retune reached
|
|
94
|
-
exactly one component. Nothing moves (the role's default IS `--radius-sm`, verified by measuring a page
|
|
95
|
-
before and after), but it changes what a square brand costs: zeroing the three radius roles used to leave
|
|
96
|
-
five surfaces rounded and now squares every one. Five focus-ring radii inside `:focus-visible` keep
|
|
97
|
-
following the raw scale deliberately — a ring traces a box, it is not a surface a brand designs.
|
|
98
|
-
|
|
99
170
|
### Added
|
|
100
171
|
|
|
101
172
|
- **Exit motion is swappable, the way entrances already were** — `--ds-modal-leave-keyframes`,
|
package/design-system.md
CHANGED
|
@@ -108,7 +108,177 @@ follows it. This is why every rule on this page names a token.
|
|
|
108
108
|
|
|
109
109
|
---
|
|
110
110
|
|
|
111
|
-
## 4.
|
|
111
|
+
## 4. Colour
|
|
112
|
+
|
|
113
|
+
### Pick the ROLE for the job, not the colour that looks right
|
|
114
|
+
|
|
115
|
+
Components never read a palette primitive (`--blue-600`). They read a semantic role, and the
|
|
116
|
+
role names say what the thing IS, so the theme and any brand can move underneath. Measured
|
|
117
|
+
usage across the library:
|
|
118
|
+
|
|
119
|
+
| Role | Uses | What it is for |
|
|
120
|
+
| --- | --- | --- |
|
|
121
|
+
| `--text-primary` | 82 | Body copy, labels, values — the default. If you are unsure, this. |
|
|
122
|
+
| `--text-tertiary` | 69 | Meta that must not compete: eyebrows, placeholders, counters, timestamps. |
|
|
123
|
+
| `--text-secondary` | 46 | Supporting copy that still has to be read — hints, subtitles, descriptions. |
|
|
124
|
+
| `--text-disabled` | 33 | Only for a disabled control. Never as "quiet text". |
|
|
125
|
+
| `--surface-default` | 50 | The page and the inside of a control. |
|
|
126
|
+
| `--surface-secondary` | 52 | A tier up from the page: table heads, sandboxes, code blocks. |
|
|
127
|
+
| `--surface-muted` | 16 | Hover and pressed fills on a neutral row. |
|
|
128
|
+
| `--surface-overlay` | 15 | Anything that floats — panels, menus, dialogs. |
|
|
129
|
+
| `--border-default` | 44 | The edge of a control. |
|
|
130
|
+
| `--border-divider` | 31 | A line BETWEEN things, not around them. |
|
|
131
|
+
|
|
132
|
+
`--text-tertiary` being the second most used role is the load-bearing fact here: most of what
|
|
133
|
+
looks like "grey text" in this system is a deliberate tertiary, and reaching for
|
|
134
|
+
`--text-disabled` to get the same greyness tells a screen reader's user nothing and lies to
|
|
135
|
+
the next reader of your CSS.
|
|
136
|
+
|
|
137
|
+
### A status family has four members and they are not interchangeable
|
|
138
|
+
|
|
139
|
+
Measured by which property each one actually lands on, across every component that uses one:
|
|
140
|
+
|
|
141
|
+
- **`--<status>`** — the saturated one: `border-color`, the fill of a solid button, and the
|
|
142
|
+
`color` of a MARKER — a required asterisk, an icon badge's glyph. Every one of the eight
|
|
143
|
+
`color: var(--error)` declarations in the library is a marker of that kind, six of them the
|
|
144
|
+
`.req` asterisk, and the other two an icon sitting on an `--error-subtitle` tint. **That
|
|
145
|
+
glyph-on-tint pair is the pattern to copy**, and the reason not to put prose in this member:
|
|
146
|
+
it is contrast-checked as a large glyph, not as text.
|
|
147
|
+
- **`--<status>-text`** — `color`, on a light surface. This is the contrast-safe member, and the
|
|
148
|
+
one you want for a message.
|
|
149
|
+
- **`--<status>-subtitle`** — `background`. The tint behind an alert or an icon badge.
|
|
150
|
+
- **`--<status>-muted` / `-hover`** — interaction states on the tinted surface.
|
|
151
|
+
|
|
152
|
+
So a status message is `--error-text` on `--error-subtitle`, never `--error` on anything with
|
|
153
|
+
text on it. Statuses are `info | success | warning | error` (`DsStatus`); `danger` and `warn`
|
|
154
|
+
are not words this library uses.
|
|
155
|
+
|
|
156
|
+
### Text on a saturated fill uses the on-role, and it does not flip with the theme
|
|
157
|
+
|
|
158
|
+
`--text-on-primary`, `-on-error`, `-on-success`, `-on-warning`. They resolve to
|
|
159
|
+
`--static-white` / `--static-ink`, which are theme-INDEPENDENT on purpose: the fill under them
|
|
160
|
+
is the same colour in light and dark, so flipping the text with the theme would break the pair
|
|
161
|
+
that was contrast-checked. Never use `--text-primary` on a filled button.
|
|
162
|
+
|
|
163
|
+
### Colour is never the only carrier
|
|
164
|
+
|
|
165
|
+
Every status in this library also has a glyph or a word. A red border alone fails the
|
|
166
|
+
colour-blind reader and fails a printout; `ds-alert`, `ds-badge` and the field message all
|
|
167
|
+
pair the colour with an icon or text, and a new status surface should too.
|
|
168
|
+
|
|
169
|
+
---
|
|
170
|
+
|
|
171
|
+
## 5. Motion
|
|
172
|
+
|
|
173
|
+
### Four durations, and 109 of the 139 uses are one of them
|
|
174
|
+
|
|
175
|
+
| Token | Value | What it is for | Uses |
|
|
176
|
+
| --- | --- | --- | --- |
|
|
177
|
+
| `--duration-instant` | 80ms | A press that must feel like contact. | 2 |
|
|
178
|
+
| `--duration-fast` | 120ms | Every hover, colour and border change — the default. | 109 |
|
|
179
|
+
| `--duration-base` | 180ms | A surface arriving (dialog, drawer) or a layout settling. | 27 |
|
|
180
|
+
| `--duration-slow` | 260ms | Only something large crossing the screen. | 1 |
|
|
181
|
+
|
|
182
|
+
If a transition you are adding is not `--duration-fast`, be able to say why. The one
|
|
183
|
+
`--duration-slow` in the library is a full-height drawer; that is the bar.
|
|
184
|
+
|
|
185
|
+
### Easing follows direction
|
|
186
|
+
|
|
187
|
+
`--ease-standard` (132 uses) for anything that changes in place — colour, border, a fill.
|
|
188
|
+
`--ease-decelerate` for something ARRIVING, `--ease-accelerate` for something LEAVING: an
|
|
189
|
+
entrance slows into its resting place, an exit gets out of the way. The role layer already
|
|
190
|
+
encodes this, so prefer it to picking an easing yourself: `--ds-motion-enter-panel-*` (a
|
|
191
|
+
dropdown), `--ds-motion-enter-surface-*` (a dialog), `--ds-motion-enter-large-*` (a drawer),
|
|
192
|
+
and `--ds-motion-exit-*`, which is deliberately FASTER than its entrance.
|
|
193
|
+
|
|
194
|
+
### Transition properties, not `all`
|
|
195
|
+
|
|
196
|
+
Measured: `background-color` (20), `transform` (12), `color` (10), `border-color` (5),
|
|
197
|
+
`opacity` (2). Nothing in the library transitions `all`, and only three places transition a
|
|
198
|
+
`width` — animating a layout property costs a reflow per frame. Prefer `transform` and
|
|
199
|
+
`opacity`; if you find yourself animating `height`, the answer is usually a `grid-template-rows`
|
|
200
|
+
trick or an overlay.
|
|
201
|
+
|
|
202
|
+
### An animation must mean something
|
|
203
|
+
|
|
204
|
+
Motion in this library either shows where a surface came from (a panel grows out of its
|
|
205
|
+
trigger, a drawer travels from its edge) or confirms a hit (a press). Decoration is not a
|
|
206
|
+
reason. The test: describe what the animation TELLS the user in one clause — if you cannot,
|
|
207
|
+
delete it.
|
|
208
|
+
|
|
209
|
+
### Reduced motion zeroes the DURATION, never the animation
|
|
210
|
+
|
|
211
|
+
`prefers-reduced-motion` sets the duration to `0ms` and leaves the keyframes in place, because
|
|
212
|
+
the modal, drawer and bottom sheet tear themselves down on `animationend` — removing the
|
|
213
|
+
animation would strand them mounted and leak the body-scroll lock. Follow that pattern in
|
|
214
|
+
anything with an exit.
|
|
215
|
+
|
|
216
|
+
---
|
|
217
|
+
|
|
218
|
+
## 6. Content
|
|
219
|
+
|
|
220
|
+
### Labels are sentence case
|
|
221
|
+
|
|
222
|
+
Measured: of 57 multi-word labels across the docs' own specimens, **45 are sentence case**. The
|
|
223
|
+
apparent exceptions are not exceptions — they are acronyms and notation the case rule does not
|
|
224
|
+
touch (`Site URL`, `Project ID`, `Date (en-US, Sunday-first)`). So: capitalise the first word
|
|
225
|
+
and whatever is a proper noun or an acronym, and nothing else. `Asset register`, not
|
|
226
|
+
`Asset Register`. No trailing colon: the field's shape already says a value follows.
|
|
227
|
+
|
|
228
|
+
Mark the exception, not the rule. `required` is the default expectation in most forms, so
|
|
229
|
+
`ds-input` and its siblings carry an `optional` input that renders "(optional)" rather than
|
|
230
|
+
making you label every other field.
|
|
231
|
+
|
|
232
|
+
### An empty state is five different situations, and saying which is the whole job
|
|
233
|
+
|
|
234
|
+
`ds-empty-state` takes a `variant`, and the vocabulary is the rule:
|
|
235
|
+
`none | loading | error | locked | success`. A screen that shows the same "No data" for a
|
|
236
|
+
first-run list, a filter that matched nothing, a failed request and a permission denial has
|
|
237
|
+
told the user nothing in four different ways. The pattern's own worked examples show the shape:
|
|
238
|
+
|
|
239
|
+
| Variant | Title says the SITUATION | Body says the NEXT STEP or the CAUSE |
|
|
240
|
+
| --- | --- | --- |
|
|
241
|
+
| `none` | "No asset allocated yet" | "Pick from the asset register to start building this Sub-record." |
|
|
242
|
+
| `error` | "Couldn't load resource allocations" | "Network error — the request timed out after 30 seconds." |
|
|
243
|
+
| `locked` | "You don't have access to this Logistics plan" | "Logistics plans are restricted to Logistics and Producer roles. Ask Alex Park or your team lead." |
|
|
244
|
+
|
|
245
|
+
Three things to copy from those: the title is a **statement, not a label** — "No asset
|
|
246
|
+
allocated yet", never "Empty"; the error body names a **concrete** cause with the number in it,
|
|
247
|
+
not "Something went wrong"; and the locked body names **who can unblock them**, because a
|
|
248
|
+
permission wall with no next step is a dead end.
|
|
249
|
+
|
|
250
|
+
### A message says what happened, what follows, and what to do
|
|
251
|
+
|
|
252
|
+
The library holds itself to this. All 15 messages it prints are tagged with the component that
|
|
253
|
+
printed them (`[ds-table] …`), 7 of 15 state the consequence with a plain "so", and 5 name the
|
|
254
|
+
fix outright:
|
|
255
|
+
|
|
256
|
+
> `[ds-table] lazy needs virtualScroll: without a window there is no range to fetch, so every
|
|
257
|
+
> gap in `data` renders a skeleton row and nothing ever asks for the rows.`
|
|
258
|
+
|
|
259
|
+
Anatomy worth keeping: **where** (the tag) → **what is wrong** → **what follows from it** →
|
|
260
|
+
**what to do**. The middle clause is the one people drop, and it is the one that stops the
|
|
261
|
+
reader guessing whether the warning matters.
|
|
262
|
+
|
|
263
|
+
### Field errors: the validator owns the words, and it must supply them
|
|
264
|
+
|
|
265
|
+
A DS field renders the message; it never invents one. Give the validator a message
|
|
266
|
+
(`required(path.email, { message: 'We need an email to send the invite to' })`) or map the kind
|
|
267
|
+
once for the app in `provideDsConfig({ field: { errorMessages: { … } } })`. With neither, an
|
|
268
|
+
invalid field goes red with no words and a dev warning names the kinds it could not resolve —
|
|
269
|
+
deliberately, because the alternative is the library writing copy for your domain.
|
|
270
|
+
|
|
271
|
+
Say what to do, not what went wrong: "Enter a valid email address" beats "Invalid email".
|
|
272
|
+
|
|
273
|
+
**Errors appear after the user has finished with the field, not while they type**, and the
|
|
274
|
+
library enforces it rather than asking you to: `errors` is gated on `touched`, so a `required`
|
|
275
|
+
error cannot greet an untouched form and a half-typed address is not yet wrong. An explicit
|
|
276
|
+
`error` string is the deliberate exception — binding it says the consumer has already decided,
|
|
277
|
+
so it shows immediately.
|
|
278
|
+
|
|
279
|
+
---
|
|
280
|
+
|
|
281
|
+
## 7. Overriding a component
|
|
112
282
|
|
|
113
283
|
Set the component's own `--ds-*` token **on the host element**, scoped as narrowly as the
|
|
114
284
|
change deserves:
|
|
@@ -136,10 +306,11 @@ internals.
|
|
|
136
306
|
|
|
137
307
|
---
|
|
138
308
|
|
|
139
|
-
##
|
|
309
|
+
## 8. Where the rest lives
|
|
140
310
|
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
`
|
|
311
|
+
The decisions this file does NOT make are the ones about which COMPONENT to reach for, and they
|
|
312
|
+
have their own home: ds-docs `Practice → Do / Don't` (modal vs drawer, button hierarchy, table
|
|
313
|
+
density, badge proliferation, status without colour, tooltips vs banners) and
|
|
314
|
+
`Practice → Token Discipline` (the token-vs-literal rule, in worked pairs). The component
|
|
315
|
+
inventory is `components.md`; the generated Component API and token reference in ds-docs are
|
|
316
|
+
extracted from source on every build and are the only surfaces that cannot go stale.
|
|
@@ -2865,9 +2865,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
|
|
|
2865
2865
|
* `text` is empty. The host field owns the `aria-describedby` relationship
|
|
2866
2866
|
* and passes `messageId`; this only renders the element that carries it. */
|
|
2867
2867
|
class FieldMessageComponent {
|
|
2868
|
+
/** The one line under a field. Empty renders nothing (or reserved space, if the field asks). */
|
|
2868
2869
|
text = input('', ...(ngDevMode ? [{ debugName: "text" }] : /* istanbul ignore next */ []));
|
|
2870
|
+
/** Which role the line is playing — hint, error, warning or success. Decides colour and icon. */
|
|
2869
2871
|
state = input('default', ...(ngDevMode ? [{ debugName: "state" }] : /* istanbul ignore next */ []));
|
|
2872
|
+
/** Id the field points `aria-describedby` at, so the message is announced with the control. */
|
|
2870
2873
|
messageId = input(null, ...(ngDevMode ? [{ debugName: "messageId" }] : /* istanbul ignore next */ []));
|
|
2874
|
+
/** Overrides the glyph the `state` would pick. */
|
|
2871
2875
|
icon = input(null, ...(ngDevMode ? [{ debugName: "icon" }] : /* istanbul ignore next */ []));
|
|
2872
2876
|
/** Reserve one line of height even when there's no `text`, so a field that
|
|
2873
2877
|
* gains/loses a message doesn't shift the layout below it. */
|
|
@@ -5905,19 +5909,30 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
|
|
|
5905
5909
|
* `display: contents` so the inner button is the grid item, and the date-picker
|
|
5906
5910
|
* can still focus a specific day via `[data-day]` (roving tabindex). */
|
|
5907
5911
|
class CalendarDayComponent {
|
|
5912
|
+
/** The chosen day in single mode, or an end of the range in range mode. Drives `aria-selected`. */
|
|
5908
5913
|
selected = input(false, { ...(ngDevMode ? { debugName: "selected" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
|
|
5914
|
+
/** A day BETWEEN the two ends of a range — tinted, but not itself selected. */
|
|
5909
5915
|
inRange = input(false, { ...(ngDevMode ? { debugName: "inRange" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
|
|
5916
|
+
/** First day of a range: rounds the leading corners and counts as selected. */
|
|
5910
5917
|
rangeStart = input(false, { ...(ngDevMode ? { debugName: "rangeStart" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
|
|
5918
|
+
/** Last day of a range: rounds the trailing corners and counts as selected. */
|
|
5911
5919
|
rangeEnd = input(false, { ...(ngDevMode ? { debugName: "rangeEnd" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
|
|
5920
|
+
/** Marks the current date. Independent of selection — today can be unselected. */
|
|
5912
5921
|
today = input(false, { ...(ngDevMode ? { debugName: "today" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
|
|
5913
5922
|
/** Day from an adjacent month — dimmed. */
|
|
5914
5923
|
muted = input(false, { ...(ngDevMode ? { debugName: "muted" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
|
|
5924
|
+
/** Outside `minDate`/`maxDate` or rejected by `disabledDate` — dimmed and not clickable. */
|
|
5915
5925
|
disabled = input(false, { ...(ngDevMode ? { debugName: "disabled" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
|
|
5916
5926
|
/** Stable key the date-picker uses to focus a specific day (roving tabindex). */
|
|
5917
5927
|
dataDay = input(null, ...(ngDevMode ? [{ debugName: "dataDay" }] : /* istanbul ignore next */ []));
|
|
5928
|
+
/** Roving tabindex: exactly one day in the grid carries 0, the rest -1, so Tab enters the
|
|
5929
|
+
* grid once and arrows move within it. */
|
|
5918
5930
|
tabIndex = input(-1, ...(ngDevMode ? [{ debugName: "tabIndex" }] : /* istanbul ignore next */ []));
|
|
5931
|
+
/** Full spoken date ("12 March 2026"), since the cell text is only the day number. */
|
|
5919
5932
|
ariaLabel = input(null, ...(ngDevMode ? [{ debugName: "ariaLabel" }] : /* istanbul ignore next */ []));
|
|
5933
|
+
/** Click on an enabled day. Carries the event so the host can read modifier keys. */
|
|
5920
5934
|
daySelected = output();
|
|
5935
|
+
/** Key press on the focused day — the grid owns arrow/Home/End navigation, not the cell. */
|
|
5921
5936
|
dayKeydown = output();
|
|
5922
5937
|
classes = computed(() => {
|
|
5923
5938
|
const parts = ['day'];
|
|
@@ -7299,12 +7314,21 @@ function clampToRange(value, constraints) {
|
|
|
7299
7314
|
/** Internal (not public API): Hours / Minutes / AM-PM listbox columns.
|
|
7300
7315
|
* Reused by ds-time-picker's overlay and the date-picker time footer. */
|
|
7301
7316
|
class TimeColumnsComponent {
|
|
7317
|
+
/** Current time as `HH:mm` (24h, always — `format` changes only what is DISPLAYED). */
|
|
7302
7318
|
value = input(null, ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
|
|
7319
|
+
/** Display clock. `12h` adds an AM/PM column; the emitted value stays 24h either way. */
|
|
7303
7320
|
format = input('24h', ...(ngDevMode ? [{ debugName: "format" }] : /* istanbul ignore next */ []));
|
|
7321
|
+
/** Minute granularity — 15 gives four rows an hour instead of sixty. */
|
|
7304
7322
|
minuteStep = input(1, { ...(ngDevMode ? { debugName: "minuteStep" } : /* istanbul ignore next */ {}), transform: numberAttribute });
|
|
7323
|
+
/** Earliest selectable time, `HH:mm`. Earlier rows render disabled rather than being removed,
|
|
7324
|
+
* so the columns do not reflow as the bound changes. */
|
|
7305
7325
|
minTime = input(null, ...(ngDevMode ? [{ debugName: "minTime" }] : /* istanbul ignore next */ []));
|
|
7326
|
+
/** Latest selectable time, `HH:mm`. */
|
|
7306
7327
|
maxTime = input(null, ...(ngDevMode ? [{ debugName: "maxTime" }] : /* istanbul ignore next */ []));
|
|
7328
|
+
/** Per-time predicate for what a range cannot express — booked slots, a lunch break.
|
|
7329
|
+
* Receives `HH:mm`; return true to disable. */
|
|
7307
7330
|
disabledTime = input(null, ...(ngDevMode ? [{ debugName: "disabledTime" }] : /* istanbul ignore next */ []));
|
|
7331
|
+
/** A complete time was picked, as `HH:mm`. Not emitted while only one column has moved. */
|
|
7308
7332
|
timeChange = output();
|
|
7309
7333
|
hourButtons = viewChildren('hourOpt', ...(ngDevMode ? [{ debugName: "hourButtons" }] : /* istanbul ignore next */ []));
|
|
7310
7334
|
minuteButtons = viewChildren('minOpt', ...(ngDevMode ? [{ debugName: "minuteButtons" }] : /* istanbul ignore next */ []));
|
|
@@ -8249,6 +8273,8 @@ class SidenavFooterComponent {
|
|
|
8249
8273
|
alertItems = input(null, ...(ngDevMode ? [{ debugName: "alertItems" }] : /* istanbul ignore next */ []));
|
|
8250
8274
|
/** Route for the account menu's "Your profile"; empty = the item is a no-op. */
|
|
8251
8275
|
profileRoute = input('', ...(ngDevMode ? [{ debugName: "profileRoute" }] : /* istanbul ignore next */ []));
|
|
8276
|
+
/** The collapse control was activated. The footer does not collapse itself — `ds-app-layout`
|
|
8277
|
+
* owns the rail state, so the host relays this. */
|
|
8252
8278
|
collapseToggled = output();
|
|
8253
8279
|
/** Emitted when the Alerts popover is opened, so the layout can mark-all-read. */
|
|
8254
8280
|
alertsOpened = output();
|
|
@@ -10074,9 +10100,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
|
|
|
10074
10100
|
}], propDecorators: { options: [{ type: i0.Input, args: [{ isSignal: true, alias: "options", required: false }] }], optionGroups: [{ type: i0.Input, args: [{ isSignal: true, alias: "optionGroups", required: false }] }], value: [{ type: i0.Input, args: [{ isSignal: true, alias: "value", required: false }] }, { type: i0.Output, args: ["valueChange"] }], multiple: [{ type: i0.Input, args: [{ isSignal: true, alias: "multiple", required: false }] }], showChevron: [{ type: i0.Input, args: [{ isSignal: true, alias: "showChevron", required: false }] }], maxVisibleChips: [{ type: i0.Input, args: [{ isSignal: true, alias: "maxVisibleChips", required: false }] }], size: [{ type: i0.Input, args: [{ isSignal: true, alias: "size", required: false }] }], width: [{ type: i0.Input, args: [{ isSignal: true, alias: "width", required: false }] }], placeholder: [{ type: i0.Input, args: [{ isSignal: true, alias: "placeholder", required: false }] }], disabled: [{ type: i0.Input, args: [{ isSignal: true, alias: "disabled", required: false }] }], invalid: [{ type: i0.Input, args: [{ isSignal: true, alias: "invalid", required: false }] }], hint: [{ type: i0.Input, args: [{ isSignal: true, alias: "hint", required: false }] }], error: [{ type: i0.Input, args: [{ isSignal: true, alias: "error", required: false }] }], warning: [{ type: i0.Input, args: [{ isSignal: true, alias: "warning", required: false }] }], errors: [{ type: i0.Input, args: [{ isSignal: true, alias: "errors", required: false }] }], touched: [{ type: i0.Input, args: [{ isSignal: true, alias: "touched", required: false }] }], reserveMessage: [{ type: i0.Input, args: [{ isSignal: true, alias: "reserveMessage", required: false }] }], allowCreate: [{ type: i0.Input, args: [{ isSignal: true, alias: "allowCreate", required: false }] }], ariaLabel: [{ type: i0.Input, args: [{ isSignal: true, alias: "ariaLabel", required: false }] }], create: [{ type: i0.Output, args: ["create"] }], trigger: [{ type: i0.ViewChild, args: ['trigger', { isSignal: true }] }], filterInput: [{ type: i0.ViewChild, args: ['filter', { isSignal: true }] }], panelTpl: [{ type: i0.ViewChild, args: ['panel', { isSignal: true }] }] } });
|
|
10075
10101
|
|
|
10076
10102
|
class DividerComponent {
|
|
10103
|
+
/** `default` hairline · `strong` heavier rule · `vertical` for a row · `label` to carry
|
|
10104
|
+
* projected text in the middle of the line. */
|
|
10077
10105
|
variant = input('default', ...(ngDevMode ? [{ debugName: "variant" }] : /* istanbul ignore next */ []));
|
|
10078
10106
|
// Vertical margin around the divider. Defaults to `md` (8px) for parity
|
|
10079
10107
|
// with menus / sidenavs; bump to `lg` for content-section separators.
|
|
10108
|
+
/** Vertical breathing room around the rule. `none` when the parent layout already owns the gap. */
|
|
10080
10109
|
spacing = input('md', ...(ngDevMode ? [{ debugName: "spacing" }] : /* istanbul ignore next */ []));
|
|
10081
10110
|
static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: DividerComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
|
|
10082
10111
|
static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "21.2.17", type: DividerComponent, isStandalone: true, selector: "ds-divider", inputs: { variant: { classPropertyName: "variant", publicName: "variant", isSignal: true, isRequired: false, transformFunction: null }, spacing: { classPropertyName: "spacing", publicName: "spacing", isSignal: true, isRequired: false, transformFunction: null } }, host: { attributes: { "role": "separator" }, properties: { "class.strong": "variant() === 'strong'", "class.vertical": "variant() === 'vertical'", "class.label": "variant() === 'label'", "class.spacing-none": "spacing() === 'none'", "class.spacing-sm": "spacing() === 'sm'", "class.spacing-md": "spacing() === 'md'", "class.spacing-lg": "spacing() === 'lg'", "attr.aria-orientation": "variant() === 'vertical' ? 'vertical' : null" } }, ngImport: i0, template: '<ng-content></ng-content>', isInline: true, styles: ["@charset \"UTF-8\";:host{--_divider-color: var(--ds-divider-color, var(--border-divider));--_divider-label-color: var(--ds-divider-label-color, var(--text-tertiary));--_divider-thickness: var(--ds-divider-thickness, var(--border-width-default));--_divider-strong-color: var(--ds-divider-strong-color, var(--border-default));display:block;height:var(--_divider-thickness);background:var(--_divider-color);margin:var(--space-2) 0;border:0}:host(.spacing-none){margin:0}:host(.spacing-sm){margin:var(--space-1) 0}:host(.spacing-md){margin:var(--space-2) 0}:host(.spacing-lg){margin:var(--space-4) 0}:host(.strong){background:var(--_divider-strong-color)}:host(.vertical){width:var(--_divider-thickness);height:auto;align-self:stretch;margin:0 var(--space-3)}:host(.label){display:flex;align-items:center;gap:var(--space-3);background:transparent;height:auto;font:var(--font-weight-bold) var(--font-size-2xs)/var(--line-height-base) var(--font-sans);letter-spacing:var(--letter-spacing-wider);text-transform:uppercase;color:var(--_divider-label-color)}:host(.label):before,:host(.label):after{content:\"\";flex:1;height:var(--_divider-thickness);background:var(--_divider-color)}\n"] });
|
|
@@ -10139,7 +10168,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
|
|
|
10139
10168
|
|
|
10140
10169
|
class StackComponent {
|
|
10141
10170
|
// null → semantic --space-stack default; named sizes map to the spacing scale.
|
|
10171
|
+
/** Space between children. `null` inherits whatever the enclosing layout set. */
|
|
10142
10172
|
gap = input(null, ...(ngDevMode ? [{ debugName: "gap" }] : /* istanbul ignore next */ []));
|
|
10173
|
+
/** Cross-axis alignment — horizontal, for a column. */
|
|
10143
10174
|
align = input(null, ...(ngDevMode ? [{ debugName: "align" }] : /* istanbul ignore next */ []));
|
|
10144
10175
|
static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: StackComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
|
|
10145
10176
|
static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "21.2.17", type: StackComponent, isStandalone: true, selector: "ds-stack", inputs: { gap: { classPropertyName: "gap", publicName: "gap", isSignal: true, isRequired: false, transformFunction: null }, align: { classPropertyName: "align", publicName: "align", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "attr.data-gap": "gap()", "attr.data-align": "align()" } }, ngImport: i0, template: '<ng-content></ng-content>', isInline: true, styles: [":host{--_stack-gap: var(--ds-stack-gap, var(--space-stack));display:flex;flex-direction:column;gap:var(--_stack-gap)}:host([data-gap=none]){--_stack-gap: 0}:host([data-gap=xs]){--_stack-gap: var(--space-1)}:host([data-gap=sm]){--_stack-gap: var(--space-2)}:host([data-gap=md]){--_stack-gap: var(--space-4)}:host([data-gap=lg]){--_stack-gap: var(--space-6)}:host([data-gap=xl]){--_stack-gap: var(--space-8)}:host([data-align=start]){align-items:flex-start}:host([data-align=center]){align-items:center}:host([data-align=end]){align-items:flex-end}:host([data-align=stretch]){align-items:stretch}\n"] });
|
|
@@ -10154,9 +10185,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
|
|
|
10154
10185
|
|
|
10155
10186
|
class InlineComponent {
|
|
10156
10187
|
// null → semantic --space-inline default; named sizes map to the spacing scale.
|
|
10188
|
+
/** Space between children. `null` inherits whatever the enclosing layout set. */
|
|
10157
10189
|
gap = input(null, ...(ngDevMode ? [{ debugName: "gap" }] : /* istanbul ignore next */ []));
|
|
10190
|
+
/** Cross-axis alignment — vertical, for a row. */
|
|
10158
10191
|
align = input(null, ...(ngDevMode ? [{ debugName: "align" }] : /* istanbul ignore next */ []));
|
|
10192
|
+
/** Main-axis distribution — horizontal, for a row. `between` pushes the ends apart. */
|
|
10159
10193
|
justify = input(null, ...(ngDevMode ? [{ debugName: "justify" }] : /* istanbul ignore next */ []));
|
|
10194
|
+
/** Let the row wrap onto more lines (default). `false` keeps one line and lets it overflow. */
|
|
10160
10195
|
wrap = input(true, { ...(ngDevMode ? { debugName: "wrap" } : /* istanbul ignore next */ {}), transform: booleanAttribute });
|
|
10161
10196
|
static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: InlineComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
|
|
10162
10197
|
static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "21.2.17", type: InlineComponent, isStandalone: true, selector: "ds-inline", inputs: { gap: { classPropertyName: "gap", publicName: "gap", isSignal: true, isRequired: false, transformFunction: null }, align: { classPropertyName: "align", publicName: "align", isSignal: true, isRequired: false, transformFunction: null }, justify: { classPropertyName: "justify", publicName: "justify", isSignal: true, isRequired: false, transformFunction: null }, wrap: { classPropertyName: "wrap", publicName: "wrap", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "attr.data-gap": "gap()", "attr.data-align": "align()", "attr.data-justify": "justify()", "class.nowrap": "!wrap()" } }, ngImport: i0, template: '<ng-content></ng-content>', isInline: true, styles: [":host{--_inline-gap: var(--ds-inline-gap, var(--space-inline));display:flex;flex-flow:row wrap;align-items:center;gap:var(--_inline-gap)}:host(.nowrap){flex-wrap:nowrap}:host([data-gap=none]){--_inline-gap: 0}:host([data-gap=xs]){--_inline-gap: var(--space-1)}:host([data-gap=sm]){--_inline-gap: var(--space-2)}:host([data-gap=md]){--_inline-gap: var(--space-4)}:host([data-gap=lg]){--_inline-gap: var(--space-6)}:host([data-gap=xl]){--_inline-gap: var(--space-8)}:host([data-align=start]){align-items:flex-start}:host([data-align=center]){align-items:center}:host([data-align=end]){align-items:flex-end}:host([data-align=stretch]){align-items:stretch}:host([data-justify=start]){justify-content:flex-start}:host([data-justify=center]){justify-content:center}:host([data-justify=end]){justify-content:flex-end}:host([data-justify=between]){justify-content:space-between}\n"] });
|
|
@@ -10173,6 +10208,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.17", ngImpo
|
|
|
10173
10208
|
|
|
10174
10209
|
class ContainerComponent {
|
|
10175
10210
|
// Max content width; defaults to the global content cap (--col-cap-content).
|
|
10211
|
+
/** Max content width before the container centres itself. `full` removes the cap. */
|
|
10176
10212
|
size = input('xl', ...(ngDevMode ? [{ debugName: "size" }] : /* istanbul ignore next */ []));
|
|
10177
10213
|
static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.17", ngImport: i0, type: ContainerComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
|
|
10178
10214
|
static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "21.2.17", type: ContainerComponent, isStandalone: true, selector: "ds-container", inputs: { size: { classPropertyName: "size", publicName: "size", isSignal: true, isRequired: false, transformFunction: null } }, host: { properties: { "attr.data-size": "size()" } }, ngImport: i0, template: '<ng-content></ng-content>', isInline: true, styles: [":host{--_container-max: var(--ds-container-max, var(--col-cap-content));--_container-pad-x: var( --ds-container-pad-x, clamp(var(--space-4), 4vw, var(--space-6)) );display:block;max-width:var(--_container-max);margin-inline:auto;padding-inline:var(--_container-pad-x)}:host([data-size=sm]){--_container-max: var(--bp-sm)}:host([data-size=md]){--_container-max: var(--bp-md)}:host([data-size=lg]){--_container-max: var(--bp-lg)}:host([data-size=xl]){--_container-max: var(--col-cap-content)}:host([data-size=full]){--_container-max: none}\n"] });
|