@ids-group-ltd/ids-design-system 0.12.1 → 0.12.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.
Files changed (90) hide show
  1. package/CHANGELOG.md +394 -0
  2. package/components.md +3 -1
  3. package/docs/agent/forms/ds-button.md +3 -1
  4. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs +2 -2
  5. package/fesm2022/ids-group-ltd-ids-design-system-components-auth-layout.mjs.map +1 -1
  6. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +10 -13
  7. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  8. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs +20 -21
  9. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
  10. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +57 -40
  11. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  12. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +9 -4
  13. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  14. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +10 -7
  15. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  16. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +13 -9
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +2 -2
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +2 -2
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +2 -2
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +2 -2
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +2 -2
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +5 -5
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +10 -13
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +2 -2
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs +13 -5
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs.map +1 -1
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs +2 -2
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs.map +1 -1
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +12 -12
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +10 -13
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs +2 -2
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs.map +1 -1
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +11 -4
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs +2 -2
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs.map +1 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +2 -2
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +9 -4
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +8 -20
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +85 -9
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +2 -2
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +2 -2
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +10 -7
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +2 -2
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  66. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +43 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  68. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  69. package/migrations/0.12.0.json +30 -2
  70. package/migrations/0.12.1.json +132 -6
  71. package/migrations/0.12.2.json +291 -0
  72. package/migrations/0.12.3.json +83 -0
  73. package/package.json +1 -1
  74. package/styles/_check-box.scss +7 -0
  75. package/styles/_clear-button.scss +28 -0
  76. package/styles/_control-line.scss +45 -0
  77. package/styles/_field-state.scss +14 -15
  78. package/styles/_focus.scss +31 -60
  79. package/styles/_table-controls.scss +66 -0
  80. package/styles/_tokens.scss +22 -31
  81. package/types/ids-group-ltd-ids-design-system-components-auth-layout.d.ts +2 -2
  82. package/types/ids-group-ltd-ids-design-system-components-breadcrumbs.d.ts +8 -17
  83. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +26 -29
  84. package/types/ids-group-ltd-ids-design-system-components-checkbox.d.ts +6 -1
  85. package/types/ids-group-ltd-ids-design-system-components-radio-group.d.ts +10 -10
  86. package/types/ids-group-ltd-ids-design-system-components-sidenav.d.ts +9 -2
  87. package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +6 -1
  88. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +18 -1
  89. package/types/ids-group-ltd-ids-design-system-components.d.ts +37 -2
  90. package/types/ids-group-ltd-ids-design-system-core.d.ts +5 -0
package/CHANGELOG.md CHANGED
@@ -8,6 +8,392 @@ While the package is on `0.x`, minor releases may contain breaking changes.
8
8
 
9
9
  ## Unreleased
10
10
 
11
+ ## 0.12.3 — 2026-09-10
12
+
13
+ ### Breaking
14
+
15
+ - **`ds-button`'s `buttonRef` is `controlRef`, and it is typed `HTMLElement`.** The element the
16
+ component renders now follows its destination, so the old name described one of three cases and
17
+ the old type described the same one. Rename the reference; the property behind it is unchanged.
18
+ A read of `.nativeElement` that expects a `<button>` — `.disabled`, `.form`, `.type` — no longer
19
+ type-checks and needs a narrow of your own, because the element may be an `<a>`.
20
+
21
+ ```ts
22
+ // before
23
+ trigger.buttonRef().nativeElement.focus();
24
+ // after
25
+ trigger.controlRef().nativeElement.focus();
26
+ ```
27
+
28
+ ### Added
29
+
30
+ - **`ds-button` takes `routerLink` and `href`, so a call-to-action can stay a real link.** Three
31
+ elements, decided by destination: `routerLink` renders an `<a [routerLink]>` that also carries
32
+ `routerLinkActive`, `href` renders a plain `<a href>`, and neither renders the
33
+ `<button type="button">` it always did. Unset — the default — nothing changes.
34
+
35
+ The look is identical across all three, because the styling is class-based rather than keyed to
36
+ the tag. What you get back is what the element decides: middle-click, open-in-new-tab,
37
+ copy-link-address and the `link` role a screen reader announces.
38
+
39
+ ```html
40
+ <ds-button routerLink="/reports" icon="arrowRight">Go to reports</ds-button>
41
+ <ds-button href="https://example.com" variant="outline">Read the spec</ds-button>
42
+ ```
43
+
44
+ `routerLink` takes the shapes a router link takes anywhere, a string or a command array.
45
+ **`type` and `loading` are button-only** and are ignored on a link with a dev-mode warning: an
46
+ anchor has no form to submit, and a navigation cannot be in flight before it starts. `disabled`
47
+ works on all three, but an anchor has no native disabled state, so it takes `aria-disabled` plus
48
+ `tabindex="-1"` — and its click is swallowed, which is what stops an `href` from navigating
49
+ anyway. `disabledReason` reads the same on a link as on a button.
50
+
51
+ - **`ds-checkbox`, `ds-radio` and `ds-switch` take `ariaLabel`.** A control rendered with no
52
+ visible label — no `label`, nothing projected — had no accessible name and nothing a consumer
53
+ could set to give it one, while `ds-select` and `ds-number-stepper` had taken this input all
54
+ along. The row's `<label>` collapses when empty, so on a bare box the `aria-label` is the whole
55
+ name.
56
+
57
+ ```html
58
+ <ds-checkbox ariaLabel="Select all rows" />
59
+ ```
60
+
61
+ It applies only when there is no visible label; set it beside one and it overrides what the label
62
+ says, which is the ARIA rule rather than a choice this makes.
63
+
64
+ - **`--ds-field-group-focus-shadow-error` — the halo a `ds-field-group` draws while invalid and
65
+ focused.** Defaults to `--ds-field-focus-shadow-error`, the same halo a single error field uses,
66
+ so a focused invalid group reads as one state instead of a red border with a blue glow around it.
67
+
68
+ - **`BreadcrumbItem` takes `ariaLabel`, for the icon-only crumb.** A crumb with an `icon` and no
69
+ `label` — the usual home crumb — rendered as a link with no accessible name at all. Nothing is
70
+ derived from `icon`: `home` is a glyph id, not a word for the user, so a crumb in that shape now
71
+ dev-warns until it is given a name.
72
+
73
+ ```ts
74
+ items = [{ icon: 'home', href: '/', ariaLabel: 'Home' }, { label: 'Records' }];
75
+ ```
76
+
77
+ - **`--focus-ring-radius` — the radius a box takes when it exists only to carry a focus ring.**
78
+ Follows `--ds-radius-inner`, 4px, so retuning the inner radius moves these rings with it. There
79
+ is no `outline-radius` in CSS: an outline follows the
80
+ `border-radius` of the box it is painted on, so a ring host with no radius of its own draws a 90°
81
+ rectangle beside the rounded controls around it. Set this to reshape every such ring at once, or
82
+ give the host its own radius to override it locally.
83
+
84
+ ### Changed
85
+
86
+ - **A clickable `ds-table` row, a `ds-tree` row and a `ds-list` activator draw a rounded focus
87
+ ring.** All three ringed a square-cornered box while every control around them was rounded; they
88
+ now carry `--focus-ring-radius`. None of the three paints anything itself — the table row's tints
89
+ sit on its cells — so the radius shapes the ring and nothing else, and it sits on the resting rule
90
+ rather than inside `:focus-visible`, or the shape would appear only while focused. Reachable by
91
+ keyboard only.
92
+
93
+ - **`ds-checkbox`, `ds-radio` and `ds-switch` draw a rounded focus ring.** The ring goes on the row
94
+ that holds the glyph and its label, and that row had no radius, so it came out square while the
95
+ glyph inside it was rounded. The row now takes `--focus-ring-radius`. The row paints nothing else,
96
+ so this changes the ring and nothing besides it — no fill, no border, no layout. Reachable by
97
+ keyboard only; the resting state of all three is unchanged.
98
+
99
+ - **Four exported classes grew members — only matters if you SUBCLASS one.** `ButtonComponent`
100
+ gained `routerLink`, `href`, `controlRef` and `destination`, which decides which of the three
101
+ elements renders; `buttonRef` is gone from its surface, so a subclass that overrode it now
102
+ overrides nothing. `CheckboxComponent`, `RadioComponent` and `SwitchComponent` each gained
103
+ `ariaLabel` and `resolvedAriaLabel`. Being public API or not is no protection: `private` and
104
+ `protected` collide with TS2415 exactly as a public name does. Nothing changes for a consumer who
105
+ only uses the elements.
106
+
107
+ ### Fixed
108
+
109
+ - **`ds-field-group[invalid]` keeps its error border under the cursor and under focus.** Both
110
+ `:hover` and `:focus-within` carried one class more than `.invalid` did, so they out-ranked it —
111
+ and the border is the group's ONLY error affordance, because a segment's own label and message are
112
+ hidden to keep the glued row intact. The error vanished at exactly the moment the user reached the
113
+ control. Hover and focus now do not match an invalid group at all, and its focus halo takes the
114
+ error tint through the new `--ds-field-group-focus-shadow-error`. A valid group hovers and focuses
115
+ exactly as before.
116
+
117
+ `.invalid` also stops depending on line order to lose to `.disabled`: both sat at the same
118
+ specificity and only the order of the two rules decided it. Disabled takes no state paint, the
119
+ same rule the nine single fields now follow.
120
+
121
+ - **`ds-stat variant="error"` recolours the value.** `:host(.error) .value` and the later
122
+ `.stat .value` land on the same specificity once emulated encapsulation adds its attribute to
123
+ each, so the default colour won on source order and the error variant changed nothing at all.
124
+ Error now moves the `--_stat-value-color` resolver, which is how the size variants already work,
125
+ so a consumer's `--ds-stat-value-color` still overrides it.
126
+
127
+ - **`ds-sidenav-footer`'s collapse button has an accessible name.** Its only name was the
128
+ `Collapse` text beside the chevron, and the collapsed rail hides that text — so on the rail, which
129
+ is the state the button exists to leave, it announced as an unlabelled button. It now carries
130
+ `aria-label`, and both the label and the name say `Expand` while collapsed, because that is what
131
+ the button does from there. The placeholder search row rendered when there are no search items had
132
+ no name either and now matches its live twin.
133
+
134
+ - **An icon-only `ds-breadcrumbs` crumb has an accessible name.** The crumb rendered an `<a>` around
135
+ a decorative icon and nothing else, so a screen reader announced a link with no name and a
136
+ keyboard user tabbed onto an anonymous stop. Give it `ariaLabel` (above); in dev mode a crumb
137
+ still missing one says so.
138
+
139
+ - **A disabled field no longer paints its `data-field-state`.** An `error`, `warning` or `success`
140
+ state used to out-rank the disabled look in all nine field components — `ds-input`, `ds-textarea`,
141
+ `ds-select`, `ds-multi-select`, `ds-autocomplete`, `ds-date-picker`, `ds-time-picker`,
142
+ `ds-color-picker` and `ds-otp-input` — so a field left invalid and then disabled kept a red border
143
+ and fill while being unfocusable. It was pure specificity: the state selector carried one more
144
+ class than the disabled rule it landed on. A disabled control is not submitted and is not
145
+ validated, so the error promised a correction that could not be made; ARIA settles the same
146
+ conflict the same way, ignoring an ARIA state that a native attribute contradicts.
147
+
148
+ **A read-only field still paints it, deliberately.** `readonly` is submitted where `disabled` is
149
+ not, so a wrong value there does reach the server and is worth flagging. Both skip browser
150
+ validation; only one of them can still send something invalid.
151
+
152
+ - **A `ds-multi-select` panel's filter row draws a rounded focus ring.** It came out as a hard
153
+ rectangle the full width of the panel, inside a panel whose every other control is rounded,
154
+ because an `outline` has no radius of its own — it follows the box it is drawn on, and that row
155
+ had none. It now carries `--ds-radius-inner`, which is the radius the panel's option rows and
156
+ clear button already use. `ds-sidenav-footer`'s search box was always drawn this way and is
157
+ unchanged.
158
+
159
+ ## 0.12.2 — 2026-09-09
160
+
161
+ ### Breaking
162
+
163
+ - **`--ds-table-hscroll-bottom` is `--ds-table-sticky-scrollbar-offset`.** The knob now carries the
164
+ name of the feature it belongs to, beside `stickyScrollbar` itself and the new
165
+ `[stickyScrollbarOffset]` input; the old spelling named neither the feature nor the edge it moves.
166
+ It is inert under the old name, and a stylesheet that still sets it stops offsetting the bar with
167
+ nothing said. Rename the declaration and the value carries over unchanged — except where the value
168
+ was a negative offset equal to your scroll container's bottom padding, which the table measures
169
+ and cancels itself now, so that one is deleted rather than renamed
170
+ (delete list: table-hscroll-bottom-workaround).
171
+
172
+ ### Added
173
+
174
+ - **`ds-sidenav-group` takes a `routerLink`, so a group can be a destination as well as a
175
+ container.** Unset — the default, and what every existing group does — the header only expands,
176
+ unchanged. Set it and the header becomes a link that navigates, and the caret splits off into a
177
+ button of its own, because one control cannot both go somewhere and stay put to open something.
178
+ The link takes the whole header's look, so the row still reads as one control, and it carries the
179
+ active state when its route is the current one.
180
+
181
+ ```html
182
+ <ds-sidenav-group label="Reports" icon="chart" expandable routerLink="/reports">
183
+ <ds-sidenav-item label="Daily" routerLink="/reports/daily" />
184
+ </ds-sidenav-group>
185
+ ```
186
+
187
+ It takes the same shapes a router link takes anywhere, a string or a command array. **It does
188
+ nothing without `expandable`** — a group that cannot open has no caret to split off, so the header
189
+ stays a plain label and the link is ignored with nothing said. On a group that does opt in, the
190
+ header element changes from a `button` to an `a` — the active state above is a contextual
191
+ `.active` class it carries — and gains a `.group-header-row` wrapper beside a
192
+ `.group-caret-button`, with
193
+ `.group-caret` now sitting inside that button rather than directly in the header; a stylesheet of
194
+ yours reaching `.group-header` by class still lands, one that qualifies it with `button` does
195
+ not.
196
+
197
+ - **`ds-table` takes `[stickyScrollbarOffset]`, and `DS_CONFIG.table.stickyScrollbarOffset` sets it
198
+ for every table.** Where the sticky horizontal scrollbar comes to rest, as any CSS length.
199
+ Unset — the default — each table measures its own scroll container's bottom padding and cancels
200
+ it, which is what puts the bar on the edge the reader sees; set this for a scrollport whose
201
+ reachable edge is somewhere else, and set it in the config when that is true of a whole app rather
202
+ than of one table. `--ds-table-sticky-scrollbar-offset` still out-ranks both, for a rule that has
203
+ to reach one table from a stylesheet.
204
+
205
+ ```html
206
+ <ds-table
207
+ [stickyScrollbarOffset]="'-3rem'"
208
+ [stickyScrollbar]="true"
209
+ [columns]="cols"
210
+ [data]="rows" />
211
+ ```
212
+
213
+ ### Changed
214
+
215
+ - **An expanded `ds-table` row opens with a reveal instead of appearing at full height.** The
216
+ panel's cell animates its `grid-template-rows` from `0fr` to `1fr`, and a new
217
+ `.expand-panel-inner` wrapper between the cell and your projected expand template clips the
218
+ overflow so the content wipes into place rather than snapping open. The reveal runs over
219
+ `--duration-base` at `--ease-standard`; set those to retune its speed and curve. Under
220
+ `prefers-reduced-motion: reduce` the panel appears fully open with no reveal. Because that
221
+ wrapper now sits between the `<td>` and the projected template, a rule of yours that reached the
222
+ template as a direct child of the cell no longer matches — reach it through `.expand-panel-inner`,
223
+ or drop the child combinator.
224
+
225
+ - **The skeleton shimmer reads as a wave now, not a wash.** It travels diagonally, down and to the
226
+ right at 45°, so it arrives at the top of one placeholder and the bottom of another instead of
227
+ sweeping every row in step. Two waves cross per period — a main one and a quieter one exactly
228
+ between two mains — which fills the wait a single band left without making the main wave hurry.
229
+ Neither has a flat core: each peaks at a point and is ramp either side, so a pass arrives and
230
+ leaves rather than switching. The tone is one soft step darker than the base, unchanged: a shadow
231
+ moving over the placeholders, not a light switched on over them.
232
+ It is seamless, and the reason is one number. A repeating gradient still paints into a finite
233
+ image which the browser tiles, and an angled gradient meets itself across a tile edge only when
234
+ the tile advances its phase by a whole period: at 135° a square tile of side S advances it by
235
+ S / √2, so the tile has to be period × √2. Left at `auto` the tile was the positioning area — the
236
+ viewport, under `fixed` — and every tile boundary showed as a hard line straight across the page.
237
+ Measured against tiles of period / √2, of period, and one oversized no-repeat image: all three
238
+ seam, this one does not.
239
+
240
+ Four hooks, all with defaults — `--ds-skeleton-wave-period` (56rem),
241
+ `--ds-skeleton-wave-duration` (3400ms), `--ds-skeleton-wave-angle` (135deg) and
242
+ `--ds-skeleton-wave-echo-color`. **`--ds-skeleton-wave-duration` replaces the shimmer's old
243
+ dependency on `--duration-loop-slow`**, so a brand that retuned that global no longer reaches the
244
+ skeleton — set the skeleton hook instead. The loop is 3400ms where it was 1400ms, and the pass no
245
+ longer rests between crossings. **`--ds-skeleton-wave-angle` retunes the gradient's direction
246
+ only**: the tile size and the loop's travel are fixed to the 45° diagonal, so an angle far from
247
+ the default tiles visibly. Change it for a small adjustment, not for a new axis.
248
+
249
+ - **Two classes gained members — only matters if you SUBCLASS one.** `TableComponent` gained
250
+ `showsLoadingSpace`, which decides whether a table that is still loading and has no rows yet holds
251
+ a body open instead of collapsing onto its header, and `publishHeadHeight`, which measures the
252
+ header and publishes its height for the scrim to inset against, `scrollAncestor`, which finds the
253
+ scrollport a sticky offset inside the table resolves against, `hasAnyColumnFilter`, which decides
254
+ whether the column-filter panel is rendered at all, `isFilterPanelOpen`, which tells a header
255
+ button whether the panel showing belongs to it, and the new `stickyScrollbarOffset` input with its
256
+ `stickyScrollbarOffsetResolved`. `SidenavGroupComponent` gained the
257
+ new `routerLink` input and `headerNavigates`, the computed that decides whether the header splits
258
+ into a link and a caret. Only `routerLink` is public API and that is no protection for the rest:
259
+ `private` and `protected` collide with TS2415 exactly as a public name does, so a member of yours
260
+ sharing one of those names stops the build. Nothing changes for a consumer who only uses the
261
+ elements — no existing input, output or token changed name or type.
262
+
263
+ - **A fullscreen `ds-modal` is a full-height panel now, so `--modal-h-fullscreen` reads as a target
264
+ and no longer as a cap.** The class used to set the token as a `max-height`, which let a short
265
+ body shrink the panel; it sets the height itself now, still clipped by the modal's own 90dvh
266
+ ceiling. A modal you sized through that token gets `min(your value, 90dvh)` — set it below the
267
+ ceiling if you want the panel shorter, and expect the extra room to go to the scrolling body with
268
+ the footer at the bottom of the screen.
269
+
270
+ - **`ds-date-picker` focuses like a field, not like a button.** `--ds-date-picker-focus-shadow`
271
+ falls back to `--ds-field-focus-shadow` instead of `--ds-control-focus-shadow`, so the trigger
272
+ draws the single soft field halo the inputs draw and follows the `data-focus` switch, which it
273
+ used to ignore. A brand that retunes the control family no longer reaches the date picker — retune
274
+ the field family, or set `--ds-date-picker-focus-shadow` outright. `ds-time-picker` still resolves
275
+ the control family, so the two now focus differently.
276
+
277
+ - **Five classes that carried no styling are gone from the DOM — only matters if YOUR stylesheet
278
+ reached one.** `ds-autocomplete`'s trigger no longer takes `.open` or `.error`,
279
+ `ds-multi-select`'s trigger no longer takes `.readonly`, and `ds-tabs`' count badge is
280
+ `class="badge"` where it was `class="badge neutral count"`. This library never styled any of the
281
+ five, so none of its own rules move; a rule of yours keyed off one stops matching, silently. Every
282
+ state they reported is still on the element:
283
+ `.autocomplete-trigger:has(input[aria-expanded="true"])` for open, the host's
284
+ `[data-field-state="error"]` for error, `.field-trigger[aria-readonly="true"]` for read-only, and
285
+ `.badge` on its own for the badge.
286
+
287
+ - **The `ds-progress` warning bar is a yellow.** `--ds-progress-bar-color-warning` falls back to
288
+ `--yellow-500` rather than to `--warning-hover`, which mixed the warning hue toward black in the
289
+ light theme and toward white in the dark one — one bar read olive, the other pale. Both themes
290
+ paint the same yellow now. A brand that recoloured the bar through `--warning-hover` no longer
291
+ reaches it; set `--ds-progress-bar-color-warning`. `--warning-hover` itself is unchanged and still
292
+ used elsewhere.
293
+
294
+ ### Fixed
295
+
296
+ - **A `ds-table` loading in `overlay` mode with no rows keeps a body.** The tbody was empty, so the
297
+ table collapsed onto its header and the spinner floated over nothing. It now holds one
298
+ `aria-hidden` spacer row's worth of height, built from the same padding and line height a real row
299
+ uses, so it tracks density. Only `[loading]="'overlay'"` with zero rows is affected — `skeleton`
300
+ draws its own rows and `[loading]="true"` resolves to `skeleton` when there is nothing to show.
301
+ A test that asserts an empty tbody during an overlay load now sees that one row.
302
+
303
+ - **The `ds-table` loading scrim starts below the header from the first frame.** The header height
304
+ was read once per load and before layout, so the first frame fell back to a 40px guess under a
305
+ taller header and the blur began mid-header. It is measured after render and re-measured whenever
306
+ the header resizes, so a header that wraps or a density change moves the scrim with it.
307
+ `--ds-table-head-h` still overrides the measurement.
308
+
309
+ - **The `ds-table` selection checkbox stops twitching when the mark changes.** The box sat on the
310
+ text baseline, so the header row's height moved by a fraction of a pixel as the select-all box
311
+ swapped between its tick and its indeterminate bar. It is centred against the line box now. This
312
+ reaches the table's header and row checkboxes and the `dsTableColumns` panel's per-column
313
+ checkboxes; `ds-checkbox` itself lays the box out as a flex item and never showed it. A
314
+ `::ng-deep` nudge you added to compensate for the old sit is now that much out.
315
+
316
+ - **`ds-date-picker`'s calendar glyph matches the value it sits beside.** It rendered two pixels
317
+ taller than the digits' cap height and overhung them top and bottom.
318
+
319
+ - **Clicking above or below the digits in `ds-date-picker` places the caret instead of opening the
320
+ calendar.** The text input only covered the value's own line box, so the band either side of it
321
+ fell through to the trigger. It spans the field's height now.
322
+
323
+ - **`ds-dropzone` shows the hand cursor once files are listed.** The zone kept the arrow, which read
324
+ as "this is finished, there is nothing to click", while the whole zone had stayed clickable the
325
+ entire time. Nothing about what a click does has changed.
326
+
327
+ - **`dsTableColumns` draws a styled panel and a styled header button.** The panel's checkboxes, drag
328
+ handles, move buttons and `Reset to default` link came out as the browser's own widgets and the
329
+ button that opens the panel as a bordered grey rectangle, because the rules for `.col-picker`,
330
+ `.col-picker-row`, `.col-picker-option`, `.col-drag`, `.col-move`, `.col-move-btn`, `.col-reset`
331
+ and `.col-picker-btn` were scoped to `ds-table` while the elements they name sit in views of their
332
+ own. Each of those classes is styled from the view that renders it now. Markup, class names and
333
+ API are unchanged, but a stylesheet of yours that reached one of them by a bare class name shared
334
+ the element with nothing and now competes with a scoped rule — qualify your selector, or reach for
335
+ the token the class reads.
336
+
337
+ - **A `ds-table` sticky horizontal scrollbar rests on the edge the reader can see.** Inside a scroll
338
+ container with bottom padding the bar settled one padding-bottom short of that edge and drew over
339
+ the rows beneath it, because a sticky `bottom` resolves against the scrollport's content box. The
340
+ table measures that padding off its scroll ancestor, cancels it, and re-measures when the
341
+ container resizes, so a padding that moves with a media query moves the bar with it.
342
+ `--ds-table-sticky-scrollbar-offset` still overrides the measurement outright — keep it for a
343
+ scrollport whose reachable edge is not its padding edge, and drop a negative value written to
344
+ cancel your own container's padding, which now offsets the bar a second time
345
+ (delete list: table-hscroll-bottom-workaround).
346
+
347
+ - **`clearable` on `ds-autocomplete` and `ds-multi-select` draws the clear button the rest of the
348
+ field family draws.** Both rendered the `.clear-btn` markup with no rule able to reach it, so the
349
+ × came out as the browser's default button — a grey bordered rectangle with a square corner and a
350
+ default cursor — next to the properly drawn chips it sits beside. `ds-select`'s rule is shared by
351
+ all three now: chromeless, `--icon-default`, `--ds-radius-inner`, `--space-0-5` of padding and the
352
+ press feedback, over a `--surface-secondary` hover. `ds-select` itself is unchanged, and `ds-input`
353
+ keeps its own filled-disc clear button, which is a different control on purpose
354
+ (delete list: picker-clear-button-workaround).
355
+
356
+ - **A `ds-table` column filter opens on the first click.** The first click on a filter button only
357
+ built the panel and the second one opened it, because the handler raised the condition that
358
+ renders the panel and then read the panel back in the same synchronous line, before change
359
+ detection had created it. The panel's existence now follows the columns' own filter configuration,
360
+ the way the row-actions menu and the clipped-cell text popover already did, so it is there before
361
+ the first click arrives. This reaches `filterMode` set to anything but `'none'`, both the built-in
362
+ `filter: 'set'` panel and a projected `dsHeaderFilter`, and the keyboard as much as the pointer —
363
+ one Enter on the button opens it. A table with no filterable column renders no panel at all.
364
+
365
+ - **A `ds-table` column filter button says whether its panel is open.** It announced
366
+ `aria-haspopup="dialog"` and never `aria-expanded`, so a screen reader was told a dialog was
367
+ available but never that it had appeared. The attribute is on every filter button now and reads
368
+ `true` only on the column whose panel is showing.
369
+
370
+ - **A `ds-table` bulk-action bar rests `--bulk-bar-offset` above the edge the reader can see.**
371
+ Inside a scroll container with bottom padding it floated that offset PLUS the padding above the
372
+ edge, because a sticky `bottom` resolves against the scrollport's content box — the same reason
373
+ the sticky horizontal scrollbar settled short. The table measures its scroll container's bottom
374
+ padding once and both subtract it, so the gap is the offset you set whatever the container's
375
+ padding is. Only a table with row selection inside a padded scroll container moves; the token
376
+ itself is unchanged.
377
+
378
+ - **A panel re-opened straight after being dismissed can be closed again.** Dismissing an overlay
379
+ disposes it only after its exit animation, so re-opening within that window let the OLD panel's
380
+ disposal clear the state belonging to the NEW one: the component held no reference to the panel on
381
+ screen, `close()` therefore did nothing, and neither Escape nor a click outside would dismiss it —
382
+ while `aria-expanded` reported it collapsed. Reachable by dismissing and re-opening quickly, and
383
+ in `ds-table` by moving from one column filter to another. Measured in `ds-date-picker`,
384
+ `ds-color-picker`, `ds-time-picker` and `ds-popover` — and so in everything `ds-popover` carries:
385
+ `ds-table`'s column filter, row-actions menu and clipped-cell text, `ds-split-button`,
386
+ `ds-filter-bar`'s overflow panel and `ds-sidenav-footer`'s search. `ds-select`,
387
+ `ds-autocomplete` and `ds-multi-select` were already immune and are unchanged in behaviour.
388
+
389
+ ### What you can now DELETE
390
+
391
+ | your workaround | why it is unnecessary | replace with |
392
+ | --- | --- | --- |
393
+ | `ds-table .check` — a margin or `transform` nudging the selection box off the text baseline | the box is centred against the line box now, so the nudge is an offset of its own | nothing |
394
+ | `--ds-table-hscroll-bottom: -` — a negative offset equal to your scroll container's bottom padding | the table measures that padding and cancels it itself, so the value offsets the sticky scrollbar a second time — and the token it sits on is renamed, so this one is deleted rather than carried over | nothing |
395
+ | `ds-autocomplete .clear-btn` (or the `ds-multi-select` one) — your own rule giving the clear × a border, background, radius or size | both draw ds-select's clear button themselves now, so your rule fights it | nothing |
396
+
11
397
  ## 0.12.1 — 2026-09-05
12
398
 
13
399
  ### Breaking
@@ -298,6 +684,14 @@ While the package is on `0.x`, minor releases may contain breaking changes.
298
684
  `transform-origin` is the inner edge on each half — because a centred scale pulls the pressed half's
299
685
  inner edge inward and opens a hairline gap in the joint.
300
686
 
687
+ ### What you can now DELETE
688
+
689
+ | your workaround | why it is unnecessary | replace with |
690
+ | --- | --- | --- |
691
+ | `::ng-deep ds-menu-item` — a left padding or margin added so icon-less rows line up with rows that have icons | the menu reserves the icon slot for every row as soon as one item carries an icon | nothing |
692
+ | `::ng-deep ds-split-button` — a hand-rolled `:active` darken or scale | both halves darken and scale on press, and the scale runs away from the seam so the joint stays closed | `--ds-split-button-bg-color-active`, `--ds-split-button-press-scale` |
693
+ | `::ng-deep .search` — a focus indicator added by hand to a picker's search box, a column filter, a cell editor or a clipped icon button | each of those draws the control ring itself now, and the ring is an `outline` drawn inside the element, so a clipping ancestor no longer eats it | nothing |
694
+
301
695
  ## 0.12.0 — 2026-09-04
302
696
 
303
697
  ### Added
package/components.md CHANGED
@@ -153,9 +153,11 @@ text rather than a state. Retune app-wide with `DS_CONFIG.field.stateIcons` (per
153
153
  is not a validated field; where a search needs a label or an error line, use `ds-input`.
154
154
 
155
155
  #### `<ds-button>` — `ButtonComponent`
156
- Inputs: **two orthogonal axes** — `color: ButtonColor = 'primary'` (`'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning'`) and `variant: ButtonVariant = 'solid'` (`'solid' | 'tonal' | 'outline' | 'ghost' | 'text'`). Plus `size: DsSize | null = null` (unset resolves `DS_CONFIG.control.size`, then `md`), `type: 'button' | 'submit' | 'reset' = 'button'`, `disabled`, `loading`, `fullWidth`, `icon: IconName | null`. Plus the refusal pair below: `disabledReason`, and the field message inputs `hint` / `warning` / `error` / `messageIcon` / `reserveMessage` / `ariaDescribedBy`.
156
+ Inputs: **two orthogonal axes** — `color: ButtonColor = 'primary'` (`'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning'`) and `variant: ButtonVariant = 'solid'` (`'solid' | 'tonal' | 'outline' | 'ghost' | 'text'`). Plus `size: DsSize | null = null` (unset resolves `DS_CONFIG.control.size`, then `md`), `type: 'button' | 'submit' | 'reset' = 'button'`, `disabled`, `loading`, `fullWidth`, `icon: IconName | null`, and the destination pair `routerLink: string | readonly unknown[] | null = null` / `href: string = ''`. Plus the refusal pair below: `disabledReason`, and the field message inputs `hint` / `warning` / `error` / `messageIcon` / `reserveMessage` / `ariaDescribedBy`.
157
157
  Axis meaning: **variant is loudness** (solid > tonal > outline/ghost/text), **color is hue** — every pair renders, and the UX-discouraged ones dev-warn with the reason. Only solid and tonal paint a fill: outline, ghost and text are TRANSPARENT, so they adopt the surface they sit on. Disabled splits by whether the fill can carry the state: `solid` and `tonal` keep `oklch(from accent 70% 0.035 h)`, while `outline`, `ghost` and `text` — the three with no fill of their own — mix the label toward the surface, `color-mix(in srgb, <label> 40%, var(--surface-default))`, because a fixed lightness cannot serve both themes. (History: the single `variant` axis was split into color × variant in 2026-06; `danger`→`error`, `link`→`text`, the old `ghost`→`outline`.)
158
158
  Output: `(pressed): MouseEvent` — only fires when not disabled and not loading
159
+ **Three elements, decided by destination.** `routerLink` → an `<a [routerLink]>` with `routerLinkActive`; `href` → a plain `<a href>`; **neither → a `<button type="button">`** — the same rule `ds-sidenav-item` follows, and for the same reason: a control that navigates has to BE a link, or middle-click, open-in-new-tab, copy-link-address and the `link` role a screen reader announces are all gone. Styling is identical across all three (class-based on `.button`, and the anchor's UA underline is reset), so target the class, never the tag — measured at zero differences across eleven computed properties, focus ring included. `type` and `loading` are button-only and dev-warn if set on a link: an anchor has no form to submit, and a navigation cannot be in flight before it starts. A disabled link takes `aria-disabled` plus `tabindex="-1"` — an anchor has no native disabled state — and its click is swallowed, which is what stops an `href` from navigating anyway. **`controlRef`** (was `buttonRef` before 0.12.3) is typed `ElementRef<HTMLElement>` for that reason: it resolves whichever element rendered.
160
+ **A link-STYLED action is still the global `.link` class on a `<button>`**, not this. Destination inputs give a navigation the button's LOOK; `.link` gives an action the link's look. `variant="text"` dev-warns in favour of `.link`.
159
161
  Content slots: default (label / leading or trailing icon), plus `[dsButtonSubtext]` for a projected second line. For icon-only actions use `<ds-icon-button>`.
160
162
  **Saying WHY a button is refused, and the two kinds of refusal.** A greyed control that does not say why is a dead end, and until 0.10.4 the only way to explain one was a tooltip — mouse-only. Which input to reach for is decided by whether the user can lift the refusal on this screen:
161
163
  - **Standing** (no permission, no integration — nothing here will change it): `disabledReason` beside `disabled`. The reason renders as a second line INSIDE the button, and setting it flips how the button is disabled — `aria-disabled="true"` instead of the native attribute, because a natively disabled button never takes focus and its description would never be announced (measured; Chrome's a11y tree reports name `"Approve invoice"`, description `"Needs the Finance role"`, state disabled). The click is swallowed in the handler instead, so `(pressed)` still never fires. Leave `disabledReason` unset and NOTHING changes: the native attribute stays, and so does every existing layout. Length is deliberately uncapped — the text wraps and the button grows.
@@ -3,9 +3,11 @@
3
3
 
4
4
  Group: Form & input
5
5
 
6
- Inputs: **two orthogonal axes** — `color: ButtonColor = 'primary'` (`'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning'`) and `variant: ButtonVariant = 'solid'` (`'solid' | 'tonal' | 'outline' | 'ghost' | 'text'`). Plus `size: DsSize | null = null` (unset resolves `DS_CONFIG.control.size`, then `md`), `type: 'button' | 'submit' | 'reset' = 'button'`, `disabled`, `loading`, `fullWidth`, `icon: IconName | null`. Plus the refusal pair below: `disabledReason`, and the field message inputs `hint` / `warning` / `error` / `messageIcon` / `reserveMessage` / `ariaDescribedBy`.
6
+ Inputs: **two orthogonal axes** — `color: ButtonColor = 'primary'` (`'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning'`) and `variant: ButtonVariant = 'solid'` (`'solid' | 'tonal' | 'outline' | 'ghost' | 'text'`). Plus `size: DsSize | null = null` (unset resolves `DS_CONFIG.control.size`, then `md`), `type: 'button' | 'submit' | 'reset' = 'button'`, `disabled`, `loading`, `fullWidth`, `icon: IconName | null`, and the destination pair `routerLink: string | readonly unknown[] | null = null` / `href: string = ''`. Plus the refusal pair below: `disabledReason`, and the field message inputs `hint` / `warning` / `error` / `messageIcon` / `reserveMessage` / `ariaDescribedBy`.
7
7
  Axis meaning: **variant is loudness** (solid > tonal > outline/ghost/text), **color is hue** — every pair renders, and the UX-discouraged ones dev-warn with the reason. Only solid and tonal paint a fill: outline, ghost and text are TRANSPARENT, so they adopt the surface they sit on. Disabled splits by whether the fill can carry the state: `solid` and `tonal` keep `oklch(from accent 70% 0.035 h)`, while `outline`, `ghost` and `text` — the three with no fill of their own — mix the label toward the surface, `color-mix(in srgb, <label> 40%, var(--surface-default))`, because a fixed lightness cannot serve both themes. (History: the single `variant` axis was split into color × variant in 2026-06; `danger`→`error`, `link`→`text`, the old `ghost`→`outline`.)
8
8
  Output: `(pressed): MouseEvent` — only fires when not disabled and not loading
9
+ **Three elements, decided by destination.** `routerLink` → an `<a [routerLink]>` with `routerLinkActive`; `href` → a plain `<a href>`; **neither → a `<button type="button">`** — the same rule `ds-sidenav-item` follows, and for the same reason: a control that navigates has to BE a link, or middle-click, open-in-new-tab, copy-link-address and the `link` role a screen reader announces are all gone. Styling is identical across all three (class-based on `.button`, and the anchor's UA underline is reset), so target the class, never the tag — measured at zero differences across eleven computed properties, focus ring included. `type` and `loading` are button-only and dev-warn if set on a link: an anchor has no form to submit, and a navigation cannot be in flight before it starts. A disabled link takes `aria-disabled` plus `tabindex="-1"` — an anchor has no native disabled state — and its click is swallowed, which is what stops an `href` from navigating anyway. **`controlRef`** (was `buttonRef` before 0.12.3) is typed `ElementRef<HTMLElement>` for that reason: it resolves whichever element rendered.
10
+ **A link-STYLED action is still the global `.link` class on a `<button>`**, not this. Destination inputs give a navigation the button's LOOK; `.link` gives an action the link's look. `variant="text"` dev-warns in favour of `.link`.
9
11
  Content slots: default (label / leading or trailing icon), plus `[dsButtonSubtext]` for a projected second line. For icon-only actions use `<ds-icon-button>`.
10
12
  **Saying WHY a button is refused, and the two kinds of refusal.** A greyed control that does not say why is a dead end, and until 0.10.4 the only way to explain one was a tooltip — mouse-only. Which input to reach for is decided by whether the user can lift the refusal on this screen:
11
13
  - **Standing** (no permission, no integration — nothing here will change it): `disabledReason` beside `disabled`. The reason renders as a second line INSIDE the button, and setting it flips how the button is disabled — `aria-disabled="true"` instead of the native attribute, because a natively disabled button never takes focus and its description would never be announced (measured; Chrome's a11y tree reports name `"Approve invoice"`, description `"Needs the Finance role"`, state disabled). The click is swallowed in the handler instead, so `(pressed)` still never fires. Leave `disabledReason` unset and NOTHING changes: the native attribute stays, and so does every existing layout. Length is deliberately uncapped — the text wraps and the button grows.
@@ -25,7 +25,7 @@ import { resolveBrandValue } from '@ids-group-ltd/ids-design-system/components';
25
25
  * unset when you supply a logo.
26
26
  *
27
27
  * ```html
28
- * <ds-auth-layout brand="MyAdmin" logoLetter="A" tagline="Broker administration">
28
+ * <ds-auth-layout brand="AppAdmin" logoLetter="A" tagline="Workspace administration">
29
29
  * <h1 class="title">Sign in</h1>
30
30
  * <form class="form">…</form>
31
31
  *
@@ -43,7 +43,7 @@ class AuthLayoutComponent {
43
43
  * tile; clear both to give one screen no brand row. */
44
44
  brand = input(null, ...(ngDevMode ? [{ debugName: "brand" }] : /* istanbul ignore next */ []));
45
45
  /** Letter-mark glyph when it differs from the brand's first letter (e.g. an
46
- * "A" tile beside the "MyAdmin" wordmark). Empty = first letter of `brand`;
46
+ * "A" tile beside the "AppAdmin" wordmark). Empty = first letter of `brand`;
47
47
  * unset falls back to `DS_CONFIG.brand.logoLetter`. */
48
48
  logoLetter = input(null, ...(ngDevMode ? [{ debugName: "logoLetter" }] : /* istanbul ignore next */ []));
49
49
  /** One line under the wordmark naming the product or audience. Unset falls back
@@ -1 +1 @@
1
- {"version":3,"file":"ids-group-ltd-ids-design-system-components-auth-layout.mjs","sources":["../../../src/lib/components/auth-layout/auth-layout.component.ts","../../../src/lib/components/auth-layout/auth-layout.component.html","../../../src/lib/components/auth-layout/ids-group-ltd-ids-design-system-components-auth-layout.ts"],"sourcesContent":["import {\n ChangeDetectionStrategy,\n Component,\n ViewEncapsulation,\n computed,\n contentChild,\n input,\n} from '@angular/core';\nimport { CardComponent } from '@ids-group-ltd/ids-design-system/components/card';\nimport type {\n CardElevation,\n CardPadding,\n} from '@ids-group-ltd/ids-design-system/core';\nimport { BrandNameDirective } from '@ids-group-ltd/ids-design-system/components/sidenav';\nimport { resolveBrandValue } from '@ids-group-ltd/ids-design-system/components';\n\n/**\n * Scaffold for the UNauthenticated screens — sign-in, forgot password, reset,\n * MFA — and the counterpart to `ds-app-layout`, which only ever covers the\n * screens behind the login.\n *\n * The host is the ONLY full-height box — nesting a `100vh` wrapper inside a\n * `100dvh` one scrolls a page whose content fits — and it carries the safe-area\n * insets a notched phone in landscape needs.\n *\n * The brand row takes the same CONTRACT as `ds-sidenav` — a `brand` string gets a\n * letter-mark tile plus wordmark, `logoLetter` overrides the glyph, `[dsBrandName]`\n * projects a two-tone wordmark (import `BrandNameDirective` alongside this\n * component, or the attribute is inert and the wordmark lands in the card), and\n * `[brand]` projects a real logo. The two are not pixel-identical: the rail's tile\n * is a fixed 28px at weight 800, this one 24-32px at 700, and each has its own\n * `--ds-*-mark-*` hooks, so retinting the mark means setting both.\n *\n * Projecting into `[brand]` does NOT suppress the tile — leave `brand`/`logoLetter`\n * unset when you supply a logo.\n *\n * ```html\n * <ds-auth-layout brand=\"MyAdmin\" logoLetter=\"A\" tagline=\"Broker administration\">\n * <h1 class=\"title\">Sign in</h1>\n * <form class=\"form\">…</form>\n *\n * <p dsAuthSupport>\n * Need a hand? <a href=\"mailto:support@example.com\">Contact support</a>\n * </p>\n * </ds-auth-layout>\n * ```\n */\n@Component({\n selector: 'ds-auth-layout',\n standalone: true,\n imports: [CardComponent],\n templateUrl: './auth-layout.component.html',\n styleUrl: './auth-layout.component.scss',\n encapsulation: ViewEncapsulation.Emulated,\n changeDetection: ChangeDetectionStrategy.OnPush,\n})\nexport class AuthLayoutComponent {\n /** Wordmark beside the letter-mark tile. For a logo image/SVG, project it into\n * the `[brand]` slot instead; for a two-tone wordmark use `[dsBrandName]`.\n * Unset falls back to `DS_CONFIG.brand.name`. Each field resolves on its own, so\n * `brand=\"\"` drops the wordmark but a `logoLetter` in the config still paints its\n * tile; clear both to give one screen no brand row. */\n readonly brand = input<string | null>(null);\n /** Letter-mark glyph when it differs from the brand's first letter (e.g. an\n * \"A\" tile beside the \"MyAdmin\" wordmark). Empty = first letter of `brand`;\n * unset falls back to `DS_CONFIG.brand.logoLetter`. */\n readonly logoLetter = input<string | null>(null);\n /** One line under the wordmark naming the product or audience. Unset falls back\n * to `DS_CONFIG.brand.tagline`. */\n readonly tagline = input<string | null>(null);\n\n /** The template must read THIS, never the input beside it — that one is null\n * until bound, and the config default lives here. */\n readonly brandName = resolveBrandValue(this.brand, 'name');\n readonly letterGlyph = resolveBrandValue(this.logoLetter, 'logoLetter');\n readonly taglineText = resolveBrandValue(this.tagline, 'tagline');\n /** Card treatment. `flat` suits a screen that already sits on a tinted canvas. */\n readonly cardElevation = input<CardElevation>('raised');\n /** Card padding, passed through to `ds-card`. `md` tightens a short form. */\n readonly cardPadding = input<CardPadding>('lg');\n /** Announce the card as the page's `main` landmark. `ds-card` renders an\n * `<article>`, which is NOT a landmark, so by default a screen-reader user has\n * nothing to jump to — set `'main'` on a standalone auth page. Opt-in because\n * the layout is also embedded inside pages that already own a `main`, and two\n * `main`s is its own violation. */\n readonly landmark = input<'main' | 'none'>('none');\n\n protected readonly brandNameRef = contentChild(BrandNameDirective);\n protected readonly hasBrandName = computed(() => !!this.brandNameRef());\n\n /** Spread, not `charAt(0)`: the latter indexes UTF-16 code UNITS, so a brand\n * starting with an astral character (an emoji, a rarer CJK glyph) yields half\n * a surrogate pair and paints as tofu. */\n protected readonly markGlyph = computed(\n () => this.letterGlyph() || [...this.brandName()][0] || '',\n );\n}\n","<div class=\"auth\">\n <header class=\"masthead\">\n <div class=\"brand\">\n <ng-content select=\"[brand]\"></ng-content>\n\n @if (letterGlyph() || brandName()) {\n <span\n class=\"mark\"\n aria-hidden=\"true\">\n {{ markGlyph() }}\n </span>\n }\n\n @if (brandName() || hasBrandName()) {\n <span class=\"brand-name\">\n @if (hasBrandName()) {\n <ng-content select=\"[dsBrandName]\"></ng-content>\n } @else {\n {{ brandName() }}\n }\n </span>\n }\n </div>\n\n @if (taglineText()) {\n <p class=\"tagline\">\n {{ taglineText() }}\n </p>\n }\n </header>\n\n <ds-card\n class=\"card\"\n [attr.role]=\"landmark() === 'main' ? 'main' : null\"\n [elevation]=\"cardElevation()\"\n [padding]=\"cardPadding()\">\n <ng-content></ng-content>\n </ds-card>\n\n <footer class=\"support\">\n <ng-content select=\"[dsAuthSupport]\"></ng-content>\n </footer>\n</div>\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ids-group-ltd-ids-design-system-components-auth-layout.mjs","sources":["../../../src/lib/components/auth-layout/auth-layout.component.ts","../../../src/lib/components/auth-layout/auth-layout.component.html","../../../src/lib/components/auth-layout/ids-group-ltd-ids-design-system-components-auth-layout.ts"],"sourcesContent":["import {\n ChangeDetectionStrategy,\n Component,\n ViewEncapsulation,\n computed,\n contentChild,\n input,\n} from '@angular/core';\nimport { CardComponent } from '@ids-group-ltd/ids-design-system/components/card';\nimport type {\n CardElevation,\n CardPadding,\n} from '@ids-group-ltd/ids-design-system/core';\nimport { BrandNameDirective } from '@ids-group-ltd/ids-design-system/components/sidenav';\nimport { resolveBrandValue } from '@ids-group-ltd/ids-design-system/components';\n\n/**\n * Scaffold for the UNauthenticated screens — sign-in, forgot password, reset,\n * MFA — and the counterpart to `ds-app-layout`, which only ever covers the\n * screens behind the login.\n *\n * The host is the ONLY full-height box — nesting a `100vh` wrapper inside a\n * `100dvh` one scrolls a page whose content fits — and it carries the safe-area\n * insets a notched phone in landscape needs.\n *\n * The brand row takes the same CONTRACT as `ds-sidenav` — a `brand` string gets a\n * letter-mark tile plus wordmark, `logoLetter` overrides the glyph, `[dsBrandName]`\n * projects a two-tone wordmark (import `BrandNameDirective` alongside this\n * component, or the attribute is inert and the wordmark lands in the card), and\n * `[brand]` projects a real logo. The two are not pixel-identical: the rail's tile\n * is a fixed 28px at weight 800, this one 24-32px at 700, and each has its own\n * `--ds-*-mark-*` hooks, so retinting the mark means setting both.\n *\n * Projecting into `[brand]` does NOT suppress the tile — leave `brand`/`logoLetter`\n * unset when you supply a logo.\n *\n * ```html\n * <ds-auth-layout brand=\"AppAdmin\" logoLetter=\"A\" tagline=\"Workspace administration\">\n * <h1 class=\"title\">Sign in</h1>\n * <form class=\"form\">…</form>\n *\n * <p dsAuthSupport>\n * Need a hand? <a href=\"mailto:support@example.com\">Contact support</a>\n * </p>\n * </ds-auth-layout>\n * ```\n */\n@Component({\n selector: 'ds-auth-layout',\n standalone: true,\n imports: [CardComponent],\n templateUrl: './auth-layout.component.html',\n styleUrl: './auth-layout.component.scss',\n encapsulation: ViewEncapsulation.Emulated,\n changeDetection: ChangeDetectionStrategy.OnPush,\n})\nexport class AuthLayoutComponent {\n /** Wordmark beside the letter-mark tile. For a logo image/SVG, project it into\n * the `[brand]` slot instead; for a two-tone wordmark use `[dsBrandName]`.\n * Unset falls back to `DS_CONFIG.brand.name`. Each field resolves on its own, so\n * `brand=\"\"` drops the wordmark but a `logoLetter` in the config still paints its\n * tile; clear both to give one screen no brand row. */\n readonly brand = input<string | null>(null);\n /** Letter-mark glyph when it differs from the brand's first letter (e.g. an\n * \"A\" tile beside the \"AppAdmin\" wordmark). Empty = first letter of `brand`;\n * unset falls back to `DS_CONFIG.brand.logoLetter`. */\n readonly logoLetter = input<string | null>(null);\n /** One line under the wordmark naming the product or audience. Unset falls back\n * to `DS_CONFIG.brand.tagline`. */\n readonly tagline = input<string | null>(null);\n\n /** The template must read THIS, never the input beside it — that one is null\n * until bound, and the config default lives here. */\n readonly brandName = resolveBrandValue(this.brand, 'name');\n readonly letterGlyph = resolveBrandValue(this.logoLetter, 'logoLetter');\n readonly taglineText = resolveBrandValue(this.tagline, 'tagline');\n /** Card treatment. `flat` suits a screen that already sits on a tinted canvas. */\n readonly cardElevation = input<CardElevation>('raised');\n /** Card padding, passed through to `ds-card`. `md` tightens a short form. */\n readonly cardPadding = input<CardPadding>('lg');\n /** Announce the card as the page's `main` landmark. `ds-card` renders an\n * `<article>`, which is NOT a landmark, so by default a screen-reader user has\n * nothing to jump to — set `'main'` on a standalone auth page. Opt-in because\n * the layout is also embedded inside pages that already own a `main`, and two\n * `main`s is its own violation. */\n readonly landmark = input<'main' | 'none'>('none');\n\n protected readonly brandNameRef = contentChild(BrandNameDirective);\n protected readonly hasBrandName = computed(() => !!this.brandNameRef());\n\n /** Spread, not `charAt(0)`: the latter indexes UTF-16 code UNITS, so a brand\n * starting with an astral character (an emoji, a rarer CJK glyph) yields half\n * a surrogate pair and paints as tofu. */\n protected readonly markGlyph = computed(\n () => this.letterGlyph() || [...this.brandName()][0] || '',\n );\n}\n","<div class=\"auth\">\n <header class=\"masthead\">\n <div class=\"brand\">\n <ng-content select=\"[brand]\"></ng-content>\n\n @if (letterGlyph() || brandName()) {\n <span\n class=\"mark\"\n aria-hidden=\"true\">\n {{ markGlyph() }}\n </span>\n }\n\n @if (brandName() || hasBrandName()) {\n <span class=\"brand-name\">\n @if (hasBrandName()) {\n <ng-content select=\"[dsBrandName]\"></ng-content>\n } @else {\n {{ brandName() }}\n }\n </span>\n }\n </div>\n\n @if (taglineText()) {\n <p class=\"tagline\">\n {{ taglineText() }}\n </p>\n }\n </header>\n\n <ds-card\n class=\"card\"\n [attr.role]=\"landmark() === 'main' ? 'main' : null\"\n [elevation]=\"cardElevation()\"\n [padding]=\"cardPadding()\">\n <ng-content></ng-content>\n </ds-card>\n\n <footer class=\"support\">\n <ng-content select=\"[dsAuthSupport]\"></ng-content>\n </footer>\n</div>\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}