@ids-group-ltd/ids-design-system 0.14.5 → 0.14.6

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 (168) hide show
  1. package/CHANGELOG.md +161 -12
  2. package/components.md +21 -19
  3. package/design-system.md +1 -1
  4. package/docs/agent/charts/ds-bar-chart.md +1 -0
  5. package/docs/agent/charts/ds-column-chart.md +1 -0
  6. package/docs/agent/charts/ds-config.md +1 -1
  7. package/docs/agent/charts/ds-line-chart.md +1 -1
  8. package/docs/agent/forms/ds-autocomplete.md +1 -1
  9. package/docs/agent/forms/ds-input.md +1 -1
  10. package/docs/agent/forms/ds-multi-select.md +1 -1
  11. package/docs/agent/forms/ds-select.md +1 -1
  12. package/docs/agent/forms/ds-textarea.md +1 -1
  13. package/docs/agent/forms/filter-item-directive.md +1 -1
  14. package/docs/agent/forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md +1 -1
  15. package/docs/agent/foundations/global-helper-classes.md +2 -2
  16. package/docs/agent/foundations/grid.md +8 -8
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +2 -2
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +2 -2
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs +6 -4
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-app-layout.mjs.map +1 -1
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +2 -2
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +2 -2
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +4 -3
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs +7 -3
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +2 -2
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs +2 -2
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-calendar-day.mjs.map +1 -1
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs +2 -2
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-card.mjs.map +1 -1
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +2 -2
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +169 -3
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +261 -16
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +3 -3
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +2 -2
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +16 -13
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +2 -2
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs +2 -2
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-description-list.mjs.map +1 -1
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +2 -2
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +5 -3
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +1 -1
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +4 -3
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +4 -3
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs +2 -2
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-icon-button.mjs.map +1 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +2 -2
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs +2 -2
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-layout.mjs.map +1 -1
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +22 -19
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +2 -2
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs +2 -2
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs.map +1 -1
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +6 -6
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +2 -3
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +9 -11
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +2 -2
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs +1 -1
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs.map +1 -1
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +2 -2
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +4 -3
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +2 -2
  90. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  91. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +4 -3
  92. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  93. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +2 -2
  94. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +2 -2
  96. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  97. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +2 -2
  98. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  99. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs +2 -2
  100. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs.map +1 -1
  101. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +7 -7
  102. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  103. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +2 -2
  104. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  105. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs +2 -2
  106. package/fesm2022/ids-group-ltd-ids-design-system-components-sparkline.mjs.map +1 -1
  107. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs +2 -2
  108. package/fesm2022/ids-group-ltd-ids-design-system-components-split-button.mjs.map +1 -1
  109. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs +2 -2
  110. package/fesm2022/ids-group-ltd-ids-design-system-components-stepper.mjs.map +1 -1
  111. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +2 -2
  112. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  113. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +4 -4
  114. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  115. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +2 -2
  116. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  117. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs +3 -3
  118. package/fesm2022/ids-group-ltd-ids-design-system-components-tabs.mjs.map +1 -1
  119. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +16 -3
  120. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  121. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +2 -2
  122. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  123. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +4 -4
  124. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  125. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +2 -2
  126. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  127. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs +2 -2
  128. package/fesm2022/ids-group-ltd-ids-design-system-components-toggle-button.mjs.map +1 -1
  129. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +1 -1
  130. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  131. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +2 -2
  132. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  133. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs +4 -4
  134. package/fesm2022/ids-group-ltd-ids-design-system-components-w3w.mjs.map +1 -1
  135. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +4 -2
  136. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  137. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +16 -2
  138. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  139. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +3 -0
  140. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  141. package/migrations/0.14.5.json +3 -3
  142. package/migrations/0.14.6.json +176 -0
  143. package/package.json +1 -1
  144. package/schematics/check-overrides/surface.json +29 -16
  145. package/styles/_chart-frame.scss +1 -50
  146. package/styles/_field-state.scss +13 -1
  147. package/styles/_focus.scss +45 -33
  148. package/styles/_link.scss +12 -0
  149. package/styles/_press.scss +1 -1
  150. package/styles/_tokens-charts.scss +1 -1
  151. package/styles/_tokens.scss +2 -0
  152. package/styles/ds.scss +2 -0
  153. package/types/ids-group-ltd-ids-design-system-components-app-layout.d.ts +4 -2
  154. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +2 -2
  155. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +64 -3
  156. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +35 -2
  157. package/types/ids-group-ltd-ids-design-system-components-checkbox.d.ts +1 -1
  158. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +2 -3
  159. package/types/ids-group-ltd-ids-design-system-components-filter-bar.d.ts +1 -1
  160. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +4 -4
  161. package/types/ids-group-ltd-ids-design-system-components-page-header.d.ts +1 -1
  162. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +1 -1
  163. package/types/ids-group-ltd-ids-design-system-components-sidenav.d.ts +1 -1
  164. package/types/ids-group-ltd-ids-design-system-components-tabs.d.ts +1 -1
  165. package/types/ids-group-ltd-ids-design-system-components-tag.d.ts +2 -1
  166. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +1 -1
  167. package/types/ids-group-ltd-ids-design-system-components.d.ts +6 -1
  168. package/types/ids-group-ltd-ids-design-system-core.d.ts +3 -0
package/CHANGELOG.md CHANGED
@@ -1,5 +1,150 @@
1
1
  ## Unreleased
2
2
 
3
+ ## 0.14.6 — 2026-10-02
4
+
5
+ ### Breaking
6
+
7
+ - **A chart whose pointer picks a category is walked by verticals from the keyboard.** In an
8
+ `interactive` `ds-line-chart` and an `interactive` `ds-chart` with a category cursor, Tab lands
9
+ on the category band (ringed), Left and Right move between bands and wrap, Home and End jump to
10
+ the ends, and Tab leaves the chart in one press. Up and Down focus one series' marker inside the
11
+ band and the panel shows that point alone; Enter on it fires `pointClicked` as a click does.
12
+ Enter on a band pins it and moving to another band lets the pin go; Escape steps back from a
13
+ marker to the band and then closes the panel. The series markers are no longer Tab stops there;
14
+ charts whose pointer picks a mark are unchanged. A class extending `ChartComponent`,
15
+ `LineSeriesComponent` or `ColumnSeriesComponent` may collide with the members they gained
16
+ (`focusedCategory`, `axisPointElements` and the keyboard handlers); a colliding private one must
17
+ be renamed, since `override` cannot reach it.
18
+
19
+ - **`styles/focus` emits its global rules only through `emit-rules`.** The base focus indicator
20
+ (`:where(:focus-visible)`), the `ds-focus-ring-in` keyframes, the `data-focus` switch and the
21
+ forced-colours outline moved into `@mixin emit-rules`, which `styles/ds` includes. Before, every
22
+ stylesheet that used a focus mixin re-emitted all of them, so each component carrying one shipped a
23
+ copy of 1.0 kB of duplicated global rules unminified. If your global stylesheet composes the parts
24
+ instead of `@use 'styles/ds'`, add `@include focus.emit-rules;` after
25
+ `@use 'styles/focus' as focus;`, or focus rings disappear on elements that style none themselves
26
+ and `data-focus` stops switching. `@use 'styles/ds'` needs nothing.
27
+
28
+ - **`DsIntl` gains two required keys: `datePicker.previousMonth` and `datePicker.nextMonth`**
29
+ (defaults `'Previous month'` and `'Next month'`). A complete `DsIntl` dictionary, or a complete
30
+ `datePicker` section of one, declared as a typed object stops compiling until it lists them.
31
+ Overrides passed to `provideDsIntl` are partial and need nothing.
32
+
33
+ ### Added
34
+
35
+ - **`.link.plain`: a link underlined only on hover and keyboard focus.** For a link that stands on its
36
+ own, such as a row action or a list of links; keep the plain `.link`, underlined at rest, for a link
37
+ inside running text. Every other `.link` renders as before.
38
+
39
+ - **`ds-breadcrumbs` crumbs can carry a hover surface.** `--ds-breadcrumbs-bg-color-hover` (default
40
+ `transparent`) tints a link on hover, `--ds-breadcrumbs-padding` (default `0`) pads every crumb,
41
+ the current one included, so labels stay on one baseline, and `--ds-breadcrumbs-radius` (default
42
+ `var(--radius-sm)`) rounds the surface and the focus ring. Rendering is unchanged until one is set.
43
+
44
+ - **A `slash` icon.** `<ds-breadcrumbs separator="slash">` separates crumbs with a "/" in the
45
+ weight of `chevronRight`.
46
+
47
+ ### Changed
48
+
49
+ - **A focused warning or success field shows its state's colour.** Its halo is
50
+ `--ds-field-focus-shadow-warning` or `--ds-field-focus-shadow-success` (defaults
51
+ `--focus-field-warning` and `--focus-field-success`), as an error field's already was, where both
52
+ showed the blue halo of a plain field. Under `data-focus="ring"`, `"edge"` and `"inset"` the
53
+ indicator takes the field's border colour, `--warning-text` or `--success`. Set either token to
54
+ `var(--ds-field-focus-shadow)` to keep the blue. The `field-state` mixin of `styles/field-state`
55
+ takes them as two new trailing arguments, `$warning-focus-shadow` and `$success-focus-shadow`.
56
+
57
+ ### Fixed
58
+
59
+ - **`ds-dropzone` takes the same file twice.** Picking a file, removing it and picking it again
60
+ emitted nothing, because the browser fires no change for an unchanged selection; `filesAdded`
61
+ now fires on every pick.
62
+
63
+ - **A `clickable` `ds-stepper`'s step buttons have names.** Each was a focusable button hidden
64
+ from assistive technology, so Tab landed on something a screen reader could not announce; the
65
+ button now carries the step's name and state, `DS_INTL.stepper.step`.
66
+
67
+ - **`ds-w3w` emits `copied` only once the address is on the clipboard.** It fired on every click,
68
+ before the copy settled and also where the browser has no clipboard, so a "Copied" message could
69
+ report a copy that never happened.
70
+
71
+ - **`--ds-container-max-width` sets `ds-container`'s width.** Every `size`, the default `xl`
72
+ included, wrote its own width over the token, so setting it changed nothing; the token now wins
73
+ over `size`.
74
+
75
+ - **`ds-number-stepper` steps by `step` and stops at `min` and `max`.** A button step that would
76
+ pass a bound now lands on it: with `max` 100 and `step` 5, 98 goes to 100, where it went to 103.
77
+ The arrow keys in the field step by `step` too, where they moved by 1. Typed values were already
78
+ clamped.
79
+
80
+ - **`ds-funnel-chart`, `ds-heatmap-chart` and `ds-pie-chart` draw their keyboard focus ring.** The
81
+ ring's colour and width resolved to nothing inside these charts, so a focused stage, cell or
82
+ slice showed no indicator. It now takes `--focus-ring-color` and `--focus-ring-width`, and
83
+ `--ds-funnel-chart-focus-color`, `--ds-heatmap-chart-focus-color`, `--ds-pie-chart-focus-color`
84
+ and their `-focus-width` pairs restyle it as documented.
85
+
86
+ - **A pinned chart tooltip leaves the screen with its chart.** Scrolled past, the chart's pinned
87
+ panel stayed held at the edge of the viewport; it now hides while the chart is out of sight and
88
+ shows beside it again when it scrolls back. The pin itself is kept. The internal
89
+ `ChartTooltipDirective` gained a private `detachOffscreen`, so a subclass declaring that name
90
+ must rename it: `override` cannot reach a private member.
91
+
92
+ - **`ds-column-chart` and `ds-line-chart` follow a plot-height or geometry token re-pointed at a
93
+ breakpoint.** They read `--ds-column-chart-*` geometry and `--ds-line-chart-plot-height` once,
94
+ after the first render, so a media query changing one later never reached the plot; they now
95
+ re-read whenever the chart's width changes. A token changed while the width stays the same is
96
+ still picked up only at the next resize.
97
+
98
+ - **`styles/press`'s `feedback` mixin plays no press on a control disabled by class or ARIA.** It
99
+ skipped `:disabled`, `[disabled]` and `.is-disabled` only; it now also skips `.disabled` and
100
+ `[aria-disabled='true']`, so an anchor or a custom control marked disabled that way no longer
101
+ darkens and shrinks on press.
102
+
103
+ - **`ds-funnel-chart`'s Unpin control sits where every other chart's does.** In a framed funnel it
104
+ stood a frame padding further in from the top and the end (41px against 21px with the default
105
+ 20px padding); it now lines up with the caption like the rest.
106
+
107
+ - **`ds-app-layout`'s content region draws no focus ring.** An app that moves focus to the
108
+ `<main>` after a navigation, so the next Tab starts on the new page, got the base indicator round
109
+ the whole content area, and with no key pressed first the browser showed it. The region still
110
+ takes focus; only the ring is gone, except under forced colours, where it stays.
111
+
112
+ - **`ds-date-picker`'s month arrows have accessible names.** The previous- and next-month buttons in
113
+ the calendar panel are announced as `datePicker.previousMonth` and `datePicker.nextMonth`, where
114
+ they were announced as an unnamed button.
115
+
116
+ - **`--ds-multi-select-option-bg-color-active` sets the option fill.** It colours the row under the
117
+ keyboard cursor and the pointer in that multi-select's panel; it was declared where the panel had
118
+ already resolved the fill, so setting it changed nothing. Unset, the fill stays
119
+ `--surface-secondary`.
120
+
121
+ - **An `interactive` `ds-tag` works from the keyboard.** It is a tab stop with `role="button"` and
122
+ `aria-pressed` following `selected`, and Enter or Space emits `toggled`, as a click does; it took a
123
+ click only. If you added your own Enter or Space handler to an interactive `ds-tag` to make it
124
+ keyboard-operable, remove it, or each key press toggles twice, once through your handler and once
125
+ through the host's `toggled`; the `tabindex="0"` and `role="button"` you set alongside it are now
126
+ redundant too. A key pressed on its close button still only closes it. `TagComponent` gained a
127
+ protected `onKeyActivate`, so a subclass declaring that name needs `override`.
128
+
129
+ - **`ds-chart` shows the Unpin control while its category cursor is held.** A click on a band pins
130
+ the cursor by default, and the composable chart now draws the same pill button as the preset
131
+ charts, on its caption's line or, without a caption, over the top end of the plot. Before, Escape,
132
+ a press outside the plot or a second click on the band released the pin, and nothing on screen
133
+ said so. In every chart the `.pin-reset` button now sits inside an internal `ds-chart-unpin`
134
+ element rendered `display: contents`, so a rule selecting it as a direct child of the chart's
135
+ `figure` no longer matches; select `.pin-reset` alone. `ChartComponent` gained a protected
136
+ `drawsUnpin`, so a subclass declaring that name needs `override`.
137
+
138
+ - **A `ds-table` expanded row closes the way it opens.** Collapsing a row folds its panel back over
139
+ `--duration-base`, where the panel used to vanish on the next frame; the row leaves the DOM when
140
+ the fold ends. Under `prefers-reduced-motion` it closes at once, as it opens.
141
+
142
+ ### What you can now DELETE
143
+
144
+ | Delete | Why | Replace with |
145
+ | --- | --- | --- |
146
+ | `(keydown.enter)` and `(keydown.space)` on an interactive `ds-tag`, plus the `tabindex="0"` and `role="button"` set with them | the host is now a tab stop with `role="button"` and emits `toggled` on Enter or Space itself, so your handler and its `(toggled)` both fire on one press | nothing; the tag's own `toggled` |
147
+
3
148
  ## 0.14.5 — 2026-09-30
4
149
 
5
150
  ### Breaking
@@ -40,7 +185,9 @@
40
185
  - **Three chart tokens lose their declared defaults and fall back to `--ds-chart-bg-color`.**
41
186
  `--ds-chart-frame-bg-color`, `--ds-chart-focus-halo-color` and `--ds-chart-hatch-color` no longer
42
187
  declare a value; each resolves to `--ds-chart-bg-color` (default `var(--surface-default)`) unless
43
- you set it. The focus halo, which was white, is now the chart background. Setting any of the three
188
+ you set it. The focus halo, which was white, is now the chart background. The hatched swatch in a
189
+ chart tooltip reads `--ds-chart-hatch-color` with `var(--surface-default)` as its fallback, so
190
+ `--ds-chart-bg-color` does not reach it. Setting any of the three
44
191
  still overrides as before; reading one in your own CSS, which used to resolve to its old default,
45
192
  now resolves to nothing.
46
193
 
@@ -55,8 +202,8 @@
55
202
 
56
203
  - **Subclassing a chart breaks on moved, grown and renamed members.** The inputs every chart shares
57
204
  (`caption`, `summary`, `frame`, `loading`, `error`, `emptyText`, `errorText`, `valueFormat`,
58
- `interactive`, `tooltipSwatches`, `tooltipLingerMs`, `pinOnClick`) and their resolved signals move
59
- to an internal base class (`DsChartBase`) that `BarChartComponent`, `ChartComponent`,
205
+ `interactive`, `tooltipSwatches`, `tooltipLingerMs`, `pinOnClick`), their resolved signals and the
206
+ protected `defaults` and `intl` move to an internal base class (`DsChartBase`) that `BarChartComponent`, `ChartComponent`,
60
207
  `ColumnChartComponent`, `FunnelChartComponent`, `HeatmapChartComponent`, `LineChartComponent`,
61
208
  `PieChartComponent`, `ScatterChartComponent` and `WaterfallChartComponent` extend, each dropping
62
209
  its own declaration of them. On top of that: `ChartComponent` loses `cursorPin` and
@@ -82,8 +229,8 @@
82
229
 
83
230
  - **`--ds-chart-bg-color` paints the chart frame and every knockout.** A new token, default
84
231
  `var(--surface-default)`. It fills the frame background and every knockout cut into the plot:
85
- stacked line band separators, the line halo, the outlined line-marker ring, stacked-column gaps
86
- and hatch stripes, bar segment seams, reference-label and annotation halos, the pie centre-text
232
+ stacked line band separators, the line halo, the outlined line-marker ring, stacked-column hatch
233
+ stripes, bar segment seams, reference-label and annotation halos, the pie centre-text
87
234
  knockout and the focus halo. Set it to the surface the chart sits on - a card, say - and the frame
88
235
  and every knockout match it. A second new token, `--ds-chart-plot-bg-color` (default
89
236
  `transparent`), fills the plot area of `ds-chart` and `ds-scatter-chart`.
@@ -138,12 +285,13 @@
138
285
 
139
286
  - **A clipped `ds-breadcrumbs` label shows its full text in a tooltip.** A crumb label past `16ch`
140
287
  (the current page past `32ch`) ended in an ellipsis with no way to read the rest; hovering it, or
141
- focusing its link, now opens a tooltip with the whole label. A label that fits opens none.
288
+ focusing its link from the keyboard, now opens a tooltip with the whole label. A label that fits opens none.
142
289
 
143
- - **A Ctrl, Cmd or Shift click on a `ds-breadcrumbs` link opens it the browser's way.** Every click
290
+ - **A modified or non-primary click on a `ds-breadcrumbs` link opens it the browser's way.** Every click
144
291
  was prevented and emitted as `(navigate)`, so a consumer routing on it moved the current tab where
145
292
  the user asked for a new tab or window. A plain primary click still emits `(navigate)` with the
146
- default prevented; a modified or non-primary click leaves `href` to the browser and emits nothing.
293
+ default prevented; a Ctrl, Cmd, Shift or Alt click and any non-primary button leave `href` to the
294
+ browser and emit nothing.
147
295
 
148
296
  - **A `dsTooltip` with no room on its side opens on the opposite side.** The panel had one
149
297
  position, so a tooltip on a trigger near the top of the viewport (a page breadcrumb, a toolbar)
@@ -1312,7 +1460,7 @@
1312
1460
 
1313
1461
  The eight `--ds-description-list-term-*` and `-details-*` tokens are declared in
1314
1462
  `description-item.component.scss` and style one item, so they are `--ds-description-item-*`.
1315
- The three `--ds-segmented-button-*` are `--ds-segmented-segment-*`, because the component calls
1463
+ The three `--ds-segmented-btn-*` are `--ds-segmented-segment-*`, because the component calls
1316
1464
  its parts segments everywhere else it speaks - `class="segment"` in the template,
1317
1465
  `SegmentedOption` as the published type. `--ds-tabs-strip-gap` is `--ds-tabs-gap`: `strip` is
1318
1466
  our internal word for the tab list and appears nowhere a consumer reads.
@@ -4256,9 +4404,10 @@
4256
4404
  else, so a bundler sees straight through it. There is no migration here and no reason to rewrite
4257
4405
  an import.
4258
4406
 
4259
- - **Per-component specifiers do resolve** (`@ids-group-ltd/ids-design-system/button`), for a codebase
4260
- that prefers a file's dependencies spelled out. They are not the recommended form and they buy no
4261
- bytes. If you want them shorter, one line in your own `tsconfig.json` does it, with no change on
4407
+ - **Per-component specifiers do resolve** (`@ids-group-ltd/ids-design-system/components/button`),
4408
+ for a codebase that prefers a file's dependencies spelled out. They buy no bytes, except inside a
4409
+ `@defer` block: a component imported from the package root there stays in the initial bundle, so
4410
+ import it from its own specifier. If you want them shorter, one line in your own `tsconfig.json` does it, with no change on
4262
4411
  our side:
4263
4412
 
4264
4413
  ```json
package/components.md CHANGED
@@ -75,19 +75,19 @@ Loaded via `@use 'styles/tokens';` (when the consumer also `@use 'styles/ds';` t
75
75
 
76
76
  ### Grid
77
77
 
78
- Responsive 4-tier page grid loaded via `@use 'styles/ds'` (or directly via `@use 'styles/page-grid';`). One column-count per breakpoint, gutters and margins scale with the viewport, container caps on the widest tier and stays fluid below.
78
+ Responsive 4-tier page grid loaded via `@use 'styles/ds'` (or directly via `@use 'styles/page-grid';`). One column-count per breakpoint, gutters and margins scale with the viewport. The container caps at `--col-cap-content` (1280px) at every tier; it first binds above 1280px.
79
79
 
80
- | Tier | Range | Cols | Gutter | Margin | Container cap |
81
- | ------------ | ------------- | ---- | ------------- | -------------- | ------------------------ |
82
- | Mobile | ≤ 640px | 4 | `--space-3` (12) | `--space-4` (16) | fluid |
83
- | Tablet | 641 – 1024px | 8 | `--space-4` (16) | `--space-6` (24) | fluid |
84
- | Desktop | 1025 – 1440px | 12 | `--space-5` (20) | `--space-8` (32) | fluid |
85
- | Desktop wide | ≥ 1441px | 12 | `--space-6` (24) | `--space-10` (40) | `--col-cap-content` 1280 |
80
+ | Tier | Range | Cols | Gutter | Margin |
81
+ | ------------ | ------------- | ---- | ------------- | -------------- |
82
+ | Mobile | < 640px | 4 | `--space-3` (12) | `--space-4` (16) |
83
+ | Tablet | 640-1023px | 8 | `--space-4` (16) | `--space-6` (24) |
84
+ | Desktop | 1024-1440px | 12 | `--space-5` (20) | `--space-8` (32) |
85
+ | Desktop wide | ≥ 1441px | 12 | `--space-6` (24) | `--space-10` (40) |
86
86
 
87
87
  **Tokens:** `--bp-xs` 480, `--bp-sm` 640, `--bp-md` 768, `--bp-lg` 1024, `--bp-xl` 1441, `--bp-2xl` 1536. Per-tier gutters/margins live as `--page-gutter-{mobile|tablet|desktop|wide}` and `--page-margin-{mobile|tablet|desktop|wide}`; the active values resolve through `--page-gutter` / `--page-margin` on `.page-grid`. Content caps: `--col-cap-text` 720, `--col-cap-content` 1280.
88
88
 
89
89
  **Class API:**
90
- - `.page-grid` — root grid container. Sets `display: grid`, tier-appropriate `grid-template-columns`, `gap`, horizontal `padding`, and `max-width: var(--col-cap-content)` with `margin: 0 auto` for centring at the widest tier.
90
+ - `.page-grid` — root grid container. Sets `display: grid`, tier-appropriate `grid-template-columns`, `gap`, horizontal `padding`, and `max-width: var(--col-cap-content)` with `margin: 0 auto` for centring once the viewport exceeds the cap.
91
91
  - `.col-span-1` … `.col-span-12` — span helpers. At narrower tiers (8 / 4 cols), a span wider than the active column-count wraps to its own row.
92
92
 
93
93
  **Composition rules:**
@@ -112,7 +112,7 @@ Responsive 4-tier page grid loaded via `@use 'styles/ds'` (or directly via `@use
112
112
 
113
113
  The DS aggregate (`@use 'styles/ds'`) forwards the full stack: theme primitives + tokens + tokens-charts + fonts + reset + typography + link + layout-utils + page-grid + scrollbar + icon-base + dropdown-overlay + skeleton-shimmer. Consumers that only `@use 'styles/tokens'` get pure tokens — **no** font faces, `.link`, typography utilities, `.grid-*`, `.page-grid` / `.col-span-*`, or the dropdown/skeleton overlay rules — load each partial explicitly (`@use 'styles/fonts'; @use 'styles/link';` …) or switch to the aggregate.
114
114
 
115
- - `.link` — anchor styling, declared in `_link.scss`. Modifiers: `.quiet` `.inline` `.standalone` `.xs` `.sm` `.lg`. Hover→`color-mix(text-link, black 20%)`, active→`color-mix(text-link, black 35%)`, disabled via `[aria-disabled="true"]`. Loaded via `@use 'styles/link'` (included in the `@use 'styles/ds'` aggregate).
115
+ - `.link` — anchor styling, declared in `_link.scss`. Modifiers: `.quiet` `.inline` `.standalone` `.plain` `.xs` `.sm` `.lg`. `.plain` drops the underline until hover or keyboard focus: for a link that stands on its own (a row action, a list of links), never for a link inside running text. Hover→`color-mix(text-link, black 20%)`, active→`color-mix(text-link, black 35%)`, disabled via `[aria-disabled="true"]`. Loaded via `@use 'styles/link'` (included in the `@use 'styles/ds'` aggregate).
116
116
  - Typography utilities (`_typography.scss`): `.t-display`, `.t-h1`, `.t-h2`, `.t-h3`, `.t-h4`, `.t-h5`, `.t-l`, `.t-l-bold`, `.t-m`, `.t-m-bold`, `.t-s`, `.t-s-bold`, `.t-xs`, `.t-xs-bold`, `.t-overline`, `.t-caption`, `.t-mono`, `.t-mono-block`, `.sr-only`
117
117
  - Layout (`_layout-utils.scss`): `.grid-2`, `.grid-3`, `.grid-4`. Breakpoints: at ≤1100px `.grid-4` drops to 3 columns; at ≤820px both `.grid-3` and `.grid-4` drop to 2 columns. Gap is `--space-4`.
118
118
  - Page grid (`_page-grid.scss`): `.page-grid` + `.col-span-1` … `.col-span-12`. 4-tier responsive grid (4 / 8 / 12 / 12 columns); see Foundations → Grid above for the full spec.
@@ -121,7 +121,7 @@ The DS aggregate (`@use 'styles/ds'`) forwards the full stack: theme primitives
121
121
 
122
122
  **Two mixins for building your own composite controls.** `@use` the partial directly to reach the mixin; a mixin emits nothing until it is included.
123
123
 
124
- - `@use 'styles/focus' as focus;` → `focus.owns-the-focus-ring($control)`. This partial IS part of the `styles/ds` aggregate — it also carries the base indicator and the `data-focus` switch — so reaching for the mixin adds no CSS. Include it in a shell that paints its own ring on `:focus-within`, naming the ONE control inside that must not paint the base indicator too. `outline: 0` cannot do this — the base indicator is a box-shadow — and a box-wide reset instead of a named control silences the tab stops inside the box (a clear button, a stepper arrow), which leaves a keyboard user unable to tell what has focus. See Foundations → Colour → Focus for the worked example.
124
+ - `@use 'styles/focus' as focus;` → `focus.owns-the-focus-ring($control)`. The base indicator and the `data-focus` switch live in its `emit-rules` mixin, which `styles/ds` includes once, so reaching for a mixin adds no CSS. Include it in a shell that paints its own ring on `:focus-within`, naming the ONE control inside that must not paint the base indicator too. A plain `outline: 0` is not the same: the base indicator is an outline, and the mixin keeps it under forced colours, where the shell's box-shadow is dropped and nothing else would show focus. A box-wide reset instead of a named control silences the tab stops inside the box (a clear button, a stepper arrow), which leaves a keyboard user unable to tell what has focus. See Foundations → Colour → Focus for the worked example.
125
125
  - `@use 'styles/text-clip' as text-clip;` → `text-clip.single-line-ellipsis`. Mixin-only, so this partial is NOT part of the `styles/ds` aggregate and emits nothing on its own. A one-line label that truncates with an ellipsis. Use it instead of hand-writing `overflow: hidden; text-overflow: ellipsis`: with a line-height under the font's glyph box (Mulish measures 1.257em, so `--line-height-flat` and `--line-height-tight` both qualify) that `hidden` shaves the top and bottom off every glyph.
126
126
 
127
127
  ---
@@ -207,7 +207,7 @@ Example:
207
207
  Tokens: `--ds-input-bg-color`, `--ds-input-border`, `--ds-input-border-hover`, `--ds-input-border-focus`, `--ds-input-text-color`, `--ds-input-placeholder`, `--ds-input-radius`, `--ds-input-padding-x`, `--ds-input-padding-y`, `--ds-input-focus-shadow`, `--ds-input-border-error`, `--ds-input-bg-color-error`, `--ds-input-border-success`, `--ds-input-bg-color-disabled`, `--ds-input-font-size` (also read by `ds-textarea`)
208
208
 
209
209
  <!-- inputs:ds-input -->
210
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `type: InputType = 'text'`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonlyBinding: boolean = false`, `success: string = ''`, `loading: boolean = false`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `min: number | null = null`, `max: number | null = null`, `step: number | null = null`, `autocomplete: string | null = null`, `autofocus: boolean = false`, `ariaLabel: string | null = null`, `ariaDescribedBy: string | null = null`, `maxLength: number | null = null`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`, `enterKeyHint: 'enter' | 'done' | 'go' | 'next' | 'previous' | 'search' | 'send' | null = null`, `inputMode: | 'none'
210
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `type: InputType = 'text'`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `loading: boolean = false`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `min: number | null = null`, `max: number | null = null`, `step: number | null = null`, `autocomplete: string | null = null`, `autofocus: boolean = false`, `ariaLabel: string | null = null`, `ariaDescribedBy: string | null = null`, `maxLength: number | null = null`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`, `enterKeyHint: 'enter' | 'done' | 'go' | 'next' | 'previous' | 'search' | 'send' | null = null`, `inputMode: | 'none'
211
211
  | 'text'
212
212
  | 'decimal'
213
213
  | 'numeric'
@@ -226,7 +226,7 @@ New: `autosize: boolean = false` (grows with content; forces `resize='none'`), `
226
226
  Methods: `focus(options?)`, `selectionStart` / `selectionEnd` (reads), `setSelectionRange(start, end, direction?)`, `select()` - all forwarded to the native `<textarea>`, so an editor toolbar never queries the component's DOM. A value written through `value` lands a microtask later and moves the caret to the end; set a range after `value.set(...)` from a `setTimeout`.
227
227
 
228
228
  <!-- inputs:ds-textarea -->
229
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonlyBinding: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `rows: number = 3`, `name: string | null = null`, `autosize: boolean = false`, `minRows: number | null = null`, `maxRows: number | null = null`, `resize: 'none' | 'vertical' | 'horizontal' | 'both' = 'vertical'`, `ariaLabel: string | null = null`, `maxLength: number | null = null`, `maxLengthMode: 'hard' | 'soft' = 'hard'`, `countTrimmed: boolean = false`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`
229
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `rows: number = 3`, `name: string | null = null`, `autosize: boolean = false`, `minRows: number | null = null`, `maxRows: number | null = null`, `resize: 'none' | 'vertical' | 'horizontal' | 'both' = 'vertical'`, `ariaLabel: string | null = null`, `maxLength: number | null = null`, `maxLengthMode: 'hard' | 'soft' = 'hard'`, `countTrimmed: boolean = false`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`
230
230
  <!-- /inputs -->
231
231
 
232
232
  #### `<ds-number-stepper>` — `NumberStepperComponent`
@@ -281,7 +281,7 @@ Shared panel tokens — the three pickers portal their panel out of the componen
281
281
  Shared option tokens, painting the row inside any of the three panels: `--ds-option-selected-bg-color`, `-hover`, `--ds-option-selected-label-color`, `--ds-option-check-color`. `ds-select` and `ds-autocomplete` mark the selection with the check glyph these paint; `ds-multi-select` uses a checkbox and answers to `--ds-multi-select-check-bg-color` instead.
282
282
 
283
283
  <!-- inputs:ds-select -->
284
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `options: readonly SelectItem[] = []`, `width: 'fill' | 'content' = 'fill'`, `placeholder: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `disabled: boolean = false`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonlyBinding: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: boolean = false`, `staticPreview: boolean = false`
284
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `options: readonly SelectItem[] = []`, `width: 'fill' | 'content' = 'fill'`, `placeholder: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `disabled: boolean = false`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: boolean = false`, `staticPreview: boolean = false`
285
285
  <!-- /inputs -->
286
286
 
287
287
  #### `<ds-select>` — `SelectComponent`
@@ -289,14 +289,14 @@ Inputs: `value: model<string>`, `options: SelectItem[]`, `placeholder: string =
289
289
  Trigger plus a CDK overlay panel. Keyboard: ArrowUp/Down, Enter/Space, Home/End, Escape, skipping group headers. `isSelectOptionGroup(item)` is re-exported as a type guard.
290
290
 
291
291
  <!-- inputs:ds-select -->
292
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `options: readonly SelectItem[] = []`, `width: 'fill' | 'content' = 'fill'`, `placeholder: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `disabled: boolean = false`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonlyBinding: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: boolean = false`, `staticPreview: boolean = false`
292
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `options: readonly SelectItem[] = []`, `width: 'fill' | 'content' = 'fill'`, `placeholder: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `disabled: boolean = false`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: boolean = false`, `staticPreview: boolean = false`
293
293
  <!-- /inputs -->
294
294
 
295
295
  #### `<ds-multi-select>` — `MultiSelectComponent`
296
296
  Inputs: `value: model<string[]>`, `options: readonly MultiSelectItem[]`, `placeholder: string | null = null` (unset: `DS_INTL.picker.placeholder`), `searchPlaceholder: string | null = null` (unset: `DS_INTL.picker.filterPlaceholder`), `searchable: boolean | number | null = null` (`true` always shows the filter row, `false` never, a NUMBER shows it once the option count reaches it), `selectAll: boolean | 'group' | 'both' = false` (`'group'` puts a row per group, `'both'` adds a global row beside them), `triggerDisplay: DsTriggerDisplay = 'full'` (`'full' | 'count' | 'labels'`), `maxVisibleChips: number | 'fit' | 'all' | null = null` (a NUMBER is a ceiling, not an exact count — fewer fit when the trigger is narrow), `width`, `size`, `label`, `disabled`, `success`, `required`, `optional`, `ariaLabel`
297
297
 
298
298
  <!-- inputs:ds-multi-select -->
299
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string[] = []`, `options: readonly MultiSelectItem[] = []`, `placeholder: string | null = null`, `searchPlaceholder: string | null = null`, `searchable: boolean | number | null = null`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonlyBinding: boolean = false`, `clearable: boolean = false`, `filterWith: ((option: MultiSelectOption, query: string) => boolean) | 'none'`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `maxVisibleChips: number | 'fit' | 'all' | null = null`, `disabled: boolean = false`, `success: string = ''`, `ariaLabel: string | null = null`, `width: 'fill' | 'content' = 'fill'`, `size: 'sm' | 'md' | 'lg' = null`, `triggerDisplay: 'full' | 'count' | 'labels' = 'full'`, `label: string = ''`, `required: boolean = false`, `optional: boolean = false`, `selectAll: boolean | 'group' | 'both' = false`
299
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string[] = []`, `options: readonly MultiSelectItem[] = []`, `placeholder: string | null = null`, `searchPlaceholder: string | null = null`, `searchable: boolean | number | null = null`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `clearable: boolean = false`, `filterWith: ((option: MultiSelectOption, query: string) => boolean) | 'none'`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `maxVisibleChips: number | 'fit' | 'all' | null = null`, `disabled: boolean = false`, `success: string = ''`, `ariaLabel: string | null = null`, `width: 'fill' | 'content' = 'fill'`, `size: 'sm' | 'md' | 'lg' = null`, `triggerDisplay: 'full' | 'count' | 'labels' = 'full'`, `label: string = ''`, `required: boolean = false`, `optional: boolean = false`, `selectAll: boolean | 'group' | 'both' = false`
300
300
  <!-- /inputs -->
301
301
 
302
302
  #### `<ds-autocomplete>` — `AutocompleteComponent<T>`
@@ -306,7 +306,7 @@ Output: `(create): string` — the typed text, when `allowCreate` is on and noth
306
306
  In multiple mode the selection renders as chips above the trigger.
307
307
 
308
308
  <!-- inputs:ds-autocomplete -->
309
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `options: readonly AutocompleteItem<T>[] = []`, `value: T | readonly T[] | null = null`, `multiple: boolean = false`, `showChevron: boolean = true`, `maxVisibleChips: number | 'fit' | 'all' | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `width: 'fill' | 'content' = 'fill'`, `valueOverflow: 'ellipsis' | 'wrap' = 'ellipsis'`, `placeholder: string | null = null`, `disabled: boolean = false`, `success: string = ''`, `allowCreate: boolean = false`, `label: string = ''`, `compareWith: (a: T | null, b: T | null) => boolean`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonlyBinding: boolean = false`, `clearable: boolean = false`, `searchPlaceholder: string = ''`, `filterWith: ((option: AutocompleteOption<T>, query: string) => boolean) | 'none'`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `required: boolean = false`, `optional: boolean = false`, `ariaLabel: string | null = null`
309
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `options: readonly AutocompleteItem<T>[] = []`, `value: T | readonly T[] | null = null`, `multiple: boolean = false`, `showChevron: boolean = true`, `maxVisibleChips: number | 'fit' | 'all' | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `width: 'fill' | 'content' = 'fill'`, `valueOverflow: 'ellipsis' | 'wrap' = 'ellipsis'`, `placeholder: string | null = null`, `disabled: boolean = false`, `success: string = ''`, `allowCreate: boolean = false`, `label: string = ''`, `compareWith: (a: T | null, b: T | null) => boolean`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `clearable: boolean = false`, `searchPlaceholder: string = ''`, `filterWith: ((option: AutocompleteOption<T>, query: string) => boolean) | 'none'`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `required: boolean = false`, `optional: boolean = false`, `ariaLabel: string | null = null`
310
310
  <!-- /inputs -->
311
311
 
312
312
  #### `<ds-search>` — `SearchComponent`
@@ -414,7 +414,7 @@ All inputs: `moreLabel: string | null = null`, `panelLabel: string | null = null
414
414
  #### `<ng-template[dsFilterItem]>` — `FilterItemDirective`
415
415
 
416
416
  <!-- inputs:ng-template[dsFilterItem] -->
417
- All inputs: `width: unknown`
417
+ All inputs: `dsFilterItem: unknown`
418
418
  <!-- /inputs -->
419
419
 
420
420
  ### Display & feedback
@@ -892,6 +892,7 @@ Row: `BarChartRow = { label: string; value: number; percent?: number; color?: st
892
892
  `value` may be a `[low, high]` pair instead of a number: the bar spans between its own ends rather than from zero, which compares a duration and its PLACEMENT at once, and the ends may be written either way round. `target` draws a tick across the bar at one reading; `ranges` paints qualitative bands behind it, given as their upper bounds in ascending order. Together they are the bullet chart, which is a bar with two extras rather than a chart type. The bands take one neutral hue at rising opacity, never the series palette. Tokens: `--ds-bar-chart-band-color`, `--ds-bar-chart-target-color`, `--ds-bar-chart-target-width`, `--ds-bar-chart-target-overhang`.
893
893
  Colour: the rows are ONE series, so they all take `--ds-chart-series-default-color`. Set `color` on the single row the reader should land on, usually to `var(--ds-chart-series-accent-color)`. There is no accent flag — the accent is a colour, so a boolean would only be a less flexible way of setting one. Do NOT reach for `--ds-chart-series-1-color` … `-8-color` here: those separate series from one another, and a bar chart's rows are not separate series.
894
894
  Segments: `segments?: BarChartSegment[]` divides a row's bar into parts sized against their own sum; each takes the categorical palette in order and gets its own nested row in the data table. `highlighted: string | null = null` names one segment by `id` (or its position as a string) and fades every other part in every row to `--ds-chart-dim-opacity` — the same input the series marks take.
895
+ Stacking: a bar stacks inside its own row, through `segments`; there is no `stack` input. `ds-column-chart` stacks the other way, across named series with its `stack` input, because a column chart carries series and a bar chart is one series of rows.
895
896
  Behaviour: a non-finite value draws no bar and prints `—`; a negative value clamps to an empty bar; a share too small for one decimal prints `<0.1%` rather than `0.0%`.
896
897
  Rhythm: a label belongs to the bar under it, so `--ds-bar-chart-label-gap` is deliberately much smaller than `--ds-bar-chart-row-gap`. Level the two and the eye starts grouping a bar with the label BELOW it, which reads every row off by one.
897
898
  Tokens: `--ds-bar-chart-track-color`, `--ds-bar-chart-track-height`, `--ds-bar-chart-row-gap`, `--ds-bar-chart-label-gap`.
@@ -910,6 +911,7 @@ States: `loading` draws skeleton marks at the real count; `error` shows `errorTe
910
911
  Point: `ColumnChartPoint = { label: string; value: number; color?: string }`
911
912
  Thresholds: `ChartThreshold = { value: number; label?: string; color?: string; to?: number; dash?: 'solid' | 'dashed' | 'dotted' }` draws a target, a budget or an SLA across the plot, behind the columns. ONE number, not a coordinate pair; `to` makes the same object a band between two readings, in either order; `dash` defaults to `'dashed'`. A threshold widens the value axis to hold it, and is named in the generated description, so a target above every column is neither drawn off the plot nor left unsaid.
912
913
  Colour: the categorical palette by position — `--ds-chart-series-1-color` onward. Set `color` on a column that carries a meaning its position does not, such as `var(--ds-chart-series-accent-color)` on the period the reader should land on. This is the one chart where the default is a judgement call rather than a rule: columns often ARE separate things (revenue by region), and where they are one quantity over time, `color` puts every column on `--ds-chart-series-default-color` in one pass.
914
+ Stacking: `stack` piles named series within each category; a point carries no breakdown of its own. `ds-bar-chart` stacks the other way, inside one row through `segments`.
913
915
  Tokens: `--ds-column-chart-plot-height`, `--ds-column-chart-column-width` (share of its own cell), `--ds-column-chart-column-max-width` (the cap that stops a five-column chart drawing slabs wider than their labels), `--ds-column-chart-column-gap`, `--ds-column-chart-grid-line-color`, `--ds-column-chart-value-space` (headroom for the value printed above a full-height column), `--ds-column-chart-axis-width` (the tick-label column; widen it for a `valueFormat` that prints longer ticks, which are clipped rather than wrapped). Reference lines take `--ds-chart-threshold-color`, `--ds-chart-threshold-band-opacity`, `--ds-chart-threshold-dashed-pattern` and `--ds-chart-threshold-dotted-pattern`.
914
916
 
915
917
  <!-- inputs:ds-column-chart -->
@@ -1007,7 +1009,7 @@ All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `s
1007
1009
  One or more series plotted over a shared set of categories.
1008
1010
  Inputs: `categories: readonly string[]` (required), `series: readonly LineChartSeries[]` (required), `yAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `stack: 'none' | 'stacked' | 'normalized' = 'none'`, `showMarkers: boolean = true`, `gaps: 'break' | 'zero' = 'break'`, `tickCount: number = 5`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'none' | 'toggle' | 'visible' = 'none'`, `loading: boolean = false`, `emptyText: string = 'No data'`, `error: boolean = false`, `errorText: string = 'Could not load the data'`, `valueFormat: (value: number) => string`, `interactive: boolean = false`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `patterns: boolean = false`, `staggerMs: number = 40`, `legendFilters: boolean = false`, `hiddenSeries: readonly string[] = []` (two-way), `rescaleOnHide: boolean = false`, `noVisibleSeriesText: string | null = null` (unset: `DS_INTL.chart.noVisibleSeries`)
1009
1011
  Output: `(pointClicked): LineChartReading` — the reading that was clicked or activated. Fires whether or not `interactive` is set.
1010
- Interaction: a pointer moving over the plot picks the CATEGORY under it — a band paints behind every series and `tooltip="axis"`, the default here, names every series at that category. Tabbing reaches ONE marker per series; arrows walk that series' readings, and a focused marker's tooltip names its own series alone. A tap picks a category and latches the panel until the next tap outside; markers carry a transparent hit stroke of 24px, or 44px under `(pointer: coarse)`. `dimOthers` is the same separate opt-in as on the other four, and here it is the legend hover that drives it.
1012
+ Interaction: a pointer moving over the plot picks the CATEGORY under it — a band paints behind every series and `tooltip="axis"`, the default here, names every series at that category. With `interactive` set, Tab reaches the category band; Left and Right walk the categories, Up and Down focus one series' marker, whose tooltip names that point alone, and Enter on it fires `pointClicked`. A tap picks a category and latches the panel until the next tap outside; markers carry a transparent hit stroke of 24px, or 44px under `(pointer: coarse)`. `dimOthers` is the same separate opt-in as on the other four, and here it is the legend hover that drives it.
1011
1013
  Legend: drawn whenever there is more than one series. `legendFilters` turns each entry into a checkbox that hides its series, `hiddenSeries` is two-way so a page can drive it from a URL parameter, and hovering or focusing an entry tints it, dims the others and thickens the one hovered. **The axis does not move when a series is hidden** unless `rescaleOnHide` says so — a silent rescale turns a period-over-period comparison into a different claim. Hiding every series replaces the plot with `noVisibleSeriesText` on a `role="status"` line, legend still rendered.
1012
1014
  Second channel: `patterns` gives every series a dash of its own, in palette-slot order, with slot 1 left solid. Off by default — the shipped palette clears the colour-blind separation threshold on its own, so this is for monochrome print, a retuned palette, or a reader who asks for it.
1013
1015
  Series: `LineChartSeries = { id: string; label: string; data: readonly (number | null)[]; axis?: 'primary' | 'secondary'; area?: boolean; slot?: number }`. A `null` is a missing reading and `gaps` decides what it draws — `'break'` leaves a hole in the line, `'zero'` plants a point on the baseline. `area` fills the band between the line and its axis baseline. `slot` pins a palette slot, so hiding one series leaves every other series' colour alone.
@@ -1021,7 +1023,7 @@ All inputs: `frame: 'auto' | 'none' = null`, `caption: string | null = null`, `s
1021
1023
  <!-- /inputs -->
1022
1024
 
1023
1025
  #### Chart defaults — what `DS_CONFIG` decides once
1024
- Five chart inputs resolve through `DS_CONFIG.chart` because they are one decision per APP, not per plot: `valueFormat` (a number reads one way in a product; a formatter passed per chart drifts as soon as there are two screens), `dataTable` (whether the numbers behind a plot have a non-visual route is an accessibility policy), `frame`, `tooltipLingerMs` and `pinOnClick` (default `true`: a click holds a mark, with a pin disc on it, until a second click, Escape or a press elsewhere). `DS_CONFIG.chart.hoverDelayMs` (default `500`) is how long a resting pointer waits before any chart answers it; once a chart has answered, the next mark answers at once until the pointer leaves it, and focus, a tap and a pinning click answer at once. Precedence is the input, then the config, then the built-in — so binding one on a single chart still wins. The empty and error copy is wording, so it lives in `DS_INTL.chart.empty` / `.error`; the number locale is `DsConfig.locale`.
1026
+ Five chart inputs resolve through `DS_CONFIG.chart` because they are one decision per APP, not per plot: `valueFormat` (a number reads one way in a product; a formatter passed per chart drifts as soon as there are two screens), `dataTable` (whether the numbers behind a plot have a non-visual route is an accessibility policy), `frame`, `tooltipLingerMs` and `pinOnClick` (default `true`: a click holds a mark, with a pin disc on it, until a second click, Escape or a press elsewhere). `DS_CONFIG.chart.hoverDelayMs` (default `0`) is how long a resting pointer waits before any chart answers it; once a chart has answered, the next mark answers at once until the pointer leaves it, and focus, a tap and a pinning click answer at once. Precedence is the input, then the config, then the built-in — so binding one on a single chart still wins. The empty and error copy is wording, so it lives in `DS_INTL.chart.empty` / `.error`; the number locale is `DsConfig.locale`.
1025
1027
 
1026
1028
  `DS_CONFIG.chart.rendering` decides how charts build on a long page and is off by default: every chart draws as soon as it is created. With `deferUntilVisible: true` each chart shows a still placeholder of its own shape until it comes within `visibleMargin` (default `'10% 0px'`) of the viewport; `buildAheadWhileIdle` (default `true`) builds the charts within `buildAheadMargin` (default `'100% 0px'`) while the page is idle; `frameBudgetMs` (default `8`) caps how long one task spends building; `skipWhileOffscreen` (default `true`) lets the browser skip a built chart's rendering off screen through `content-visibility: auto`. Until a deferred chart is built a screen reader meets its caption only.
1027
1029
 
package/design-system.md CHANGED
@@ -73,7 +73,7 @@ container.
73
73
  ### Choose a ROLE, never a raw size
74
74
 
75
75
  The library ships named roles. Use the class; the size, weight, line-height and tracking
76
- come with it, and every one is retunable through `--ds-t-<role>-*` without touching the
76
+ come with it, and every one is retunable through `--ds-typography-<role>-*` without touching the
77
77
  call site.
78
78
 
79
79
  | Role | Use for |
@@ -12,6 +12,7 @@ Row: `BarChartRow = { label: string; value: number; percent?: number; color?: st
12
12
  `value` may be a `[low, high]` pair instead of a number: the bar spans between its own ends rather than from zero, which compares a duration and its PLACEMENT at once, and the ends may be written either way round. `target` draws a tick across the bar at one reading; `ranges` paints qualitative bands behind it, given as their upper bounds in ascending order. Together they are the bullet chart, which is a bar with two extras rather than a chart type. The bands take one neutral hue at rising opacity, never the series palette. Tokens: `--ds-bar-chart-band-color`, `--ds-bar-chart-target-color`, `--ds-bar-chart-target-width`, `--ds-bar-chart-target-overhang`.
13
13
  Colour: the rows are ONE series, so they all take `--ds-chart-series-default-color`. Set `color` on the single row the reader should land on, usually to `var(--ds-chart-series-accent-color)`. There is no accent flag — the accent is a colour, so a boolean would only be a less flexible way of setting one. Do NOT reach for `--ds-chart-series-1-color` … `-8-color` here: those separate series from one another, and a bar chart's rows are not separate series.
14
14
  Segments: `segments?: BarChartSegment[]` divides a row's bar into parts sized against their own sum; each takes the categorical palette in order and gets its own nested row in the data table. `highlighted: string | null = null` names one segment by `id` (or its position as a string) and fades every other part in every row to `--ds-chart-dim-opacity` — the same input the series marks take.
15
+ Stacking: a bar stacks inside its own row, through `segments`; there is no `stack` input. `ds-column-chart` stacks the other way, across named series with its `stack` input, because a column chart carries series and a bar chart is one series of rows.
15
16
  Behaviour: a non-finite value draws no bar and prints `—`; a negative value clamps to an empty bar; a share too small for one decimal prints `<0.1%` rather than `0.0%`.
16
17
  Rhythm: a label belongs to the bar under it, so `--ds-bar-chart-label-gap` is deliberately much smaller than `--ds-bar-chart-row-gap`. Level the two and the eye starts grouping a bar with the label BELOW it, which reads every row off by one.
17
18
  Tokens: `--ds-bar-chart-track-color`, `--ds-bar-chart-track-height`, `--ds-bar-chart-row-gap`, `--ds-bar-chart-label-gap`.
@@ -12,6 +12,7 @@ States: `loading` draws skeleton marks at the real count; `error` shows `errorTe
12
12
  Point: `ColumnChartPoint = { label: string; value: number; color?: string }`
13
13
  Thresholds: `ChartThreshold = { value: number; label?: string; color?: string; to?: number; dash?: 'solid' | 'dashed' | 'dotted' }` draws a target, a budget or an SLA across the plot, behind the columns. ONE number, not a coordinate pair; `to` makes the same object a band between two readings, in either order; `dash` defaults to `'dashed'`. A threshold widens the value axis to hold it, and is named in the generated description, so a target above every column is neither drawn off the plot nor left unsaid.
14
14
  Colour: the categorical palette by position — `--ds-chart-series-1-color` onward. Set `color` on a column that carries a meaning its position does not, such as `var(--ds-chart-series-accent-color)` on the period the reader should land on. This is the one chart where the default is a judgement call rather than a rule: columns often ARE separate things (revenue by region), and where they are one quantity over time, `color` puts every column on `--ds-chart-series-default-color` in one pass.
15
+ Stacking: `stack` piles named series within each category; a point carries no breakdown of its own. `ds-bar-chart` stacks the other way, inside one row through `segments`.
15
16
  Tokens: `--ds-column-chart-plot-height`, `--ds-column-chart-column-width` (share of its own cell), `--ds-column-chart-column-max-width` (the cap that stops a five-column chart drawing slabs wider than their labels), `--ds-column-chart-column-gap`, `--ds-column-chart-grid-line-color`, `--ds-column-chart-value-space` (headroom for the value printed above a full-height column), `--ds-column-chart-axis-width` (the tick-label column; widen it for a `valueFormat` that prints longer ticks, which are clipped rather than wrapped). Reference lines take `--ds-chart-threshold-color`, `--ds-chart-threshold-band-opacity`, `--ds-chart-threshold-dashed-pattern` and `--ds-chart-threshold-dotted-pattern`.
16
17
 
17
18
  <!-- inputs:ds-column-chart -->
@@ -3,7 +3,7 @@
3
3
 
4
4
  Group: Charts
5
5
 
6
- Five chart inputs resolve through `DS_CONFIG.chart` because they are one decision per APP, not per plot: `valueFormat` (a number reads one way in a product; a formatter passed per chart drifts as soon as there are two screens), `dataTable` (whether the numbers behind a plot have a non-visual route is an accessibility policy), `frame`, `tooltipLingerMs` and `pinOnClick` (default `true`: a click holds a mark, with a pin disc on it, until a second click, Escape or a press elsewhere). `DS_CONFIG.chart.hoverDelayMs` (default `500`) is how long a resting pointer waits before any chart answers it; once a chart has answered, the next mark answers at once until the pointer leaves it, and focus, a tap and a pinning click answer at once. Precedence is the input, then the config, then the built-in — so binding one on a single chart still wins. The empty and error copy is wording, so it lives in `DS_INTL.chart.empty` / `.error`; the number locale is `DsConfig.locale`.
6
+ Five chart inputs resolve through `DS_CONFIG.chart` because they are one decision per APP, not per plot: `valueFormat` (a number reads one way in a product; a formatter passed per chart drifts as soon as there are two screens), `dataTable` (whether the numbers behind a plot have a non-visual route is an accessibility policy), `frame`, `tooltipLingerMs` and `pinOnClick` (default `true`: a click holds a mark, with a pin disc on it, until a second click, Escape or a press elsewhere). `DS_CONFIG.chart.hoverDelayMs` (default `0`) is how long a resting pointer waits before any chart answers it; once a chart has answered, the next mark answers at once until the pointer leaves it, and focus, a tap and a pinning click answer at once. Precedence is the input, then the config, then the built-in — so binding one on a single chart still wins. The empty and error copy is wording, so it lives in `DS_INTL.chart.empty` / `.error`; the number locale is `DsConfig.locale`.
7
7
 
8
8
  `DS_CONFIG.chart.rendering` decides how charts build on a long page and is off by default: every chart draws as soon as it is created. With `deferUntilVisible: true` each chart shows a still placeholder of its own shape until it comes within `visibleMargin` (default `'10% 0px'`) of the viewport; `buildAheadWhileIdle` (default `true`) builds the charts within `buildAheadMargin` (default `'100% 0px'`) while the page is idle; `frameBudgetMs` (default `8`) caps how long one task spends building; `skipWhileOffscreen` (default `true`) lets the browser skip a built chart's rendering off screen through `content-visibility: auto`. Until a deferred chart is built a screen reader meets its caption only.
9
9
 
@@ -6,7 +6,7 @@ Group: Charts
6
6
  One or more series plotted over a shared set of categories.
7
7
  Inputs: `categories: readonly string[]` (required), `series: readonly LineChartSeries[]` (required), `yAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `stack: 'none' | 'stacked' | 'normalized' = 'none'`, `showMarkers: boolean = true`, `gaps: 'break' | 'zero' = 'break'`, `tickCount: number = 5`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'none' | 'toggle' | 'visible' = 'none'`, `loading: boolean = false`, `emptyText: string = 'No data'`, `error: boolean = false`, `errorText: string = 'Could not load the data'`, `valueFormat: (value: number) => string`, `interactive: boolean = false`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `patterns: boolean = false`, `staggerMs: number = 40`, `legendFilters: boolean = false`, `hiddenSeries: readonly string[] = []` (two-way), `rescaleOnHide: boolean = false`, `noVisibleSeriesText: string | null = null` (unset: `DS_INTL.chart.noVisibleSeries`)
8
8
  Output: `(pointClicked): LineChartReading` — the reading that was clicked or activated. Fires whether or not `interactive` is set.
9
- Interaction: a pointer moving over the plot picks the CATEGORY under it — a band paints behind every series and `tooltip="axis"`, the default here, names every series at that category. Tabbing reaches ONE marker per series; arrows walk that series' readings, and a focused marker's tooltip names its own series alone. A tap picks a category and latches the panel until the next tap outside; markers carry a transparent hit stroke of 24px, or 44px under `(pointer: coarse)`. `dimOthers` is the same separate opt-in as on the other four, and here it is the legend hover that drives it.
9
+ Interaction: a pointer moving over the plot picks the CATEGORY under it — a band paints behind every series and `tooltip="axis"`, the default here, names every series at that category. With `interactive` set, Tab reaches the category band; Left and Right walk the categories, Up and Down focus one series' marker, whose tooltip names that point alone, and Enter on it fires `pointClicked`. A tap picks a category and latches the panel until the next tap outside; markers carry a transparent hit stroke of 24px, or 44px under `(pointer: coarse)`. `dimOthers` is the same separate opt-in as on the other four, and here it is the legend hover that drives it.
10
10
  Legend: drawn whenever there is more than one series. `legendFilters` turns each entry into a checkbox that hides its series, `hiddenSeries` is two-way so a page can drive it from a URL parameter, and hovering or focusing an entry tints it, dims the others and thickens the one hovered. **The axis does not move when a series is hidden** unless `rescaleOnHide` says so — a silent rescale turns a period-over-period comparison into a different claim. Hiding every series replaces the plot with `noVisibleSeriesText` on a `role="status"` line, legend still rendered.
11
11
  Second channel: `patterns` gives every series a dash of its own, in palette-slot order, with slot 1 left solid. Off by default — the shipped palette clears the colour-blind separation threshold on its own, so this is for monochrome print, a retuned palette, or a reader who asks for it.
12
12
  Series: `LineChartSeries = { id: string; label: string; data: readonly (number | null)[]; axis?: 'primary' | 'secondary'; area?: boolean; slot?: number }`. A `null` is a missing reading and `gaps` decides what it draws — `'break'` leaves a hole in the line, `'zero'` plants a point on the baseline. `area` fills the band between the line and its axis baseline. `slot` pins a palette slot, so hiding one series leaves every other series' colour alone.
@@ -9,5 +9,5 @@ Output: `(create): string` — the typed text, when `allowCreate` is on and noth
9
9
  In multiple mode the selection renders as chips above the trigger.
10
10
 
11
11
  <!-- inputs:ds-autocomplete -->
12
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `options: readonly AutocompleteItem<T>[] = []`, `value: T | readonly T[] | null = null`, `multiple: boolean = false`, `showChevron: boolean = true`, `maxVisibleChips: number | 'fit' | 'all' | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `width: 'fill' | 'content' = 'fill'`, `valueOverflow: 'ellipsis' | 'wrap' = 'ellipsis'`, `placeholder: string | null = null`, `disabled: boolean = false`, `success: string = ''`, `allowCreate: boolean = false`, `label: string = ''`, `compareWith: (a: T | null, b: T | null) => boolean`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonlyBinding: boolean = false`, `clearable: boolean = false`, `searchPlaceholder: string = ''`, `filterWith: ((option: AutocompleteOption<T>, query: string) => boolean) | 'none'`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `required: boolean = false`, `optional: boolean = false`, `ariaLabel: string | null = null`
12
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `options: readonly AutocompleteItem<T>[] = []`, `value: T | readonly T[] | null = null`, `multiple: boolean = false`, `showChevron: boolean = true`, `maxVisibleChips: number | 'fit' | 'all' | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `width: 'fill' | 'content' = 'fill'`, `valueOverflow: 'ellipsis' | 'wrap' = 'ellipsis'`, `placeholder: string | null = null`, `disabled: boolean = false`, `success: string = ''`, `allowCreate: boolean = false`, `label: string = ''`, `compareWith: (a: T | null, b: T | null) => boolean`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `clearable: boolean = false`, `searchPlaceholder: string = ''`, `filterWith: ((option: AutocompleteOption<T>, query: string) => boolean) | 'none'`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `required: boolean = false`, `optional: boolean = false`, `ariaLabel: string | null = null`
13
13
  <!-- /inputs -->
@@ -22,7 +22,7 @@ Example:
22
22
  Tokens: `--ds-input-bg-color`, `--ds-input-border`, `--ds-input-border-hover`, `--ds-input-border-focus`, `--ds-input-text-color`, `--ds-input-placeholder`, `--ds-input-radius`, `--ds-input-padding-x`, `--ds-input-padding-y`, `--ds-input-focus-shadow`, `--ds-input-border-error`, `--ds-input-bg-color-error`, `--ds-input-border-success`, `--ds-input-bg-color-disabled`, `--ds-input-font-size` (also read by `ds-textarea`)
23
23
 
24
24
  <!-- inputs:ds-input -->
25
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `type: InputType = 'text'`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonlyBinding: boolean = false`, `success: string = ''`, `loading: boolean = false`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `min: number | null = null`, `max: number | null = null`, `step: number | null = null`, `autocomplete: string | null = null`, `autofocus: boolean = false`, `ariaLabel: string | null = null`, `ariaDescribedBy: string | null = null`, `maxLength: number | null = null`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`, `enterKeyHint: 'enter' | 'done' | 'go' | 'next' | 'previous' | 'search' | 'send' | null = null`, `inputMode: | 'none'
25
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `type: InputType = 'text'`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `loading: boolean = false`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `min: number | null = null`, `max: number | null = null`, `step: number | null = null`, `autocomplete: string | null = null`, `autofocus: boolean = false`, `ariaLabel: string | null = null`, `ariaDescribedBy: string | null = null`, `maxLength: number | null = null`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`, `enterKeyHint: 'enter' | 'done' | 'go' | 'next' | 'previous' | 'search' | 'send' | null = null`, `inputMode: | 'none'
26
26
  | 'text'
27
27
  | 'decimal'
28
28
  | 'numeric'
@@ -6,5 +6,5 @@ Group: Form & input
6
6
  Inputs: `value: model<string[]>`, `options: readonly MultiSelectItem[]`, `placeholder: string | null = null` (unset: `DS_INTL.picker.placeholder`), `searchPlaceholder: string | null = null` (unset: `DS_INTL.picker.filterPlaceholder`), `searchable: boolean | number | null = null` (`true` always shows the filter row, `false` never, a NUMBER shows it once the option count reaches it), `selectAll: boolean | 'group' | 'both' = false` (`'group'` puts a row per group, `'both'` adds a global row beside them), `triggerDisplay: DsTriggerDisplay = 'full'` (`'full' | 'count' | 'labels'`), `maxVisibleChips: number | 'fit' | 'all' | null = null` (a NUMBER is a ceiling, not an exact count — fewer fit when the trigger is narrow), `width`, `size`, `label`, `disabled`, `success`, `required`, `optional`, `ariaLabel`
7
7
 
8
8
  <!-- inputs:ds-multi-select -->
9
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string[] = []`, `options: readonly MultiSelectItem[] = []`, `placeholder: string | null = null`, `searchPlaceholder: string | null = null`, `searchable: boolean | number | null = null`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonlyBinding: boolean = false`, `clearable: boolean = false`, `filterWith: ((option: MultiSelectOption, query: string) => boolean) | 'none'`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `maxVisibleChips: number | 'fit' | 'all' | null = null`, `disabled: boolean = false`, `success: string = ''`, `ariaLabel: string | null = null`, `width: 'fill' | 'content' = 'fill'`, `size: 'sm' | 'md' | 'lg' = null`, `triggerDisplay: 'full' | 'count' | 'labels' = 'full'`, `label: string = ''`, `required: boolean = false`, `optional: boolean = false`, `selectAll: boolean | 'group' | 'both' = false`
9
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string[] = []`, `options: readonly MultiSelectItem[] = []`, `placeholder: string | null = null`, `searchPlaceholder: string | null = null`, `searchable: boolean | number | null = null`, `name: string | null = null`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `clearable: boolean = false`, `filterWith: ((option: MultiSelectOption, query: string) => boolean) | 'none'`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `maxVisibleChips: number | 'fit' | 'all' | null = null`, `disabled: boolean = false`, `success: string = ''`, `ariaLabel: string | null = null`, `width: 'fill' | 'content' = 'fill'`, `size: 'sm' | 'md' | 'lg' = null`, `triggerDisplay: 'full' | 'count' | 'labels' = 'full'`, `label: string = ''`, `required: boolean = false`, `optional: boolean = false`, `selectAll: boolean | 'group' | 'both' = false`
10
10
  <!-- /inputs -->
@@ -7,5 +7,5 @@ Inputs: `value: model<string>`, `options: SelectItem[]`, `placeholder: string =
7
7
  Trigger plus a CDK overlay panel. Keyboard: ArrowUp/Down, Enter/Space, Home/End, Escape, skipping group headers. `isSelectOptionGroup(item)` is re-exported as a type guard.
8
8
 
9
9
  <!-- inputs:ds-select -->
10
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `options: readonly SelectItem[] = []`, `width: 'fill' | 'content' = 'fill'`, `placeholder: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `disabled: boolean = false`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonlyBinding: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: boolean = false`, `staticPreview: boolean = false`
10
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `options: readonly SelectItem[] = []`, `width: 'fill' | 'content' = 'fill'`, `placeholder: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `disabled: boolean = false`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: boolean = false`, `staticPreview: boolean = false`
11
11
  <!-- /inputs -->
@@ -10,5 +10,5 @@ New: `autosize: boolean = false` (grows with content; forces `resize='none'`), `
10
10
  Methods: `focus(options?)`, `selectionStart` / `selectionEnd` (reads), `setSelectionRange(start, end, direction?)`, `select()` - all forwarded to the native `<textarea>`, so an editor toolbar never queries the component's DOM. A value written through `value` lands a microtask later and moves the caret to the end; set a range after `value.set(...)` from a `setTimeout`.
11
11
 
12
12
  <!-- inputs:ds-textarea -->
13
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonlyBinding: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `rows: number = 3`, `name: string | null = null`, `autosize: boolean = false`, `minRows: number | null = null`, `maxRows: number | null = null`, `resize: 'none' | 'vertical' | 'horizontal' | 'both' = 'vertical'`, `ariaLabel: string | null = null`, `maxLength: number | null = null`, `maxLengthMode: 'hard' | 'soft' = 'hard'`, `countTrimmed: boolean = false`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`
13
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `placeholder: string = ''`, `disabled: boolean = false`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `rows: number = 3`, `name: string | null = null`, `autosize: boolean = false`, `minRows: number | null = null`, `maxRows: number | null = null`, `resize: 'none' | 'vertical' | 'horizontal' | 'both' = 'vertical'`, `ariaLabel: string | null = null`, `maxLength: number | null = null`, `maxLengthMode: 'hard' | 'soft' = 'hard'`, `countTrimmed: boolean = false`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`
14
14
  <!-- /inputs -->
@@ -4,5 +4,5 @@
4
4
  Group: Form & input
5
5
 
6
6
  <!-- inputs:ng-template[dsFilterItem] -->
7
- All inputs: `width: unknown`
7
+ All inputs: `dsFilterItem: unknown`
8
8
  <!-- /inputs -->
@@ -21,5 +21,5 @@ Shared panel tokens — the three pickers portal their panel out of the componen
21
21
  Shared option tokens, painting the row inside any of the three panels: `--ds-option-selected-bg-color`, `-hover`, `--ds-option-selected-label-color`, `--ds-option-check-color`. `ds-select` and `ds-autocomplete` mark the selection with the check glyph these paint; `ds-multi-select` uses a checkbox and answers to `--ds-multi-select-check-bg-color` instead.
22
22
 
23
23
  <!-- inputs:ds-select -->
24
- All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `options: readonly SelectItem[] = []`, `width: 'fill' | 'content' = 'fill'`, `placeholder: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `disabled: boolean = false`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonlyBinding: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: boolean = false`, `staticPreview: boolean = false`
24
+ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `reserveMessage: boolean | null = null`, `messageIcon: IconName | false | null = null`, `errors: readonly DsFieldError[] = []`, `invalid: boolean = false`, `touched: boolean = false`, `hidden: boolean = false`, `value: string = ''`, `options: readonly SelectItem[] = []`, `width: 'fill' | 'content' = 'fill'`, `placeholder: string = ''`, `size: 'sm' | 'md' | 'lg' = null`, `label: string = ''`, `disabled: boolean = false`, `loading: boolean = false`, `scrollActiveIntoView: boolean = true`, `panelClass: string | readonly string[] = []`, `readOnly: boolean = false`, `readonly: boolean = false`, `success: string = ''`, `required: boolean = false`, `optional: boolean = false`, `name: string | null = null`, `ariaLabel: string | null = null`, `clearable: boolean = false`, `staticPreview: boolean = false`
25
25
  <!-- /inputs -->
@@ -3,7 +3,7 @@
3
3
 
4
4
  The DS aggregate (`@use 'styles/ds'`) forwards the full stack: theme primitives + tokens + tokens-charts + fonts + reset + typography + link + layout-utils + page-grid + scrollbar + icon-base + dropdown-overlay + skeleton-shimmer. Consumers that only `@use 'styles/tokens'` get pure tokens — **no** font faces, `.link`, typography utilities, `.grid-*`, `.page-grid` / `.col-span-*`, or the dropdown/skeleton overlay rules — load each partial explicitly (`@use 'styles/fonts'; @use 'styles/link';` …) or switch to the aggregate.
5
5
 
6
- - `.link` — anchor styling, declared in `_link.scss`. Modifiers: `.quiet` `.inline` `.standalone` `.xs` `.sm` `.lg`. Hover→`color-mix(text-link, black 20%)`, active→`color-mix(text-link, black 35%)`, disabled via `[aria-disabled="true"]`. Loaded via `@use 'styles/link'` (included in the `@use 'styles/ds'` aggregate).
6
+ - `.link` — anchor styling, declared in `_link.scss`. Modifiers: `.quiet` `.inline` `.standalone` `.plain` `.xs` `.sm` `.lg`. `.plain` drops the underline until hover or keyboard focus: for a link that stands on its own (a row action, a list of links), never for a link inside running text. Hover→`color-mix(text-link, black 20%)`, active→`color-mix(text-link, black 35%)`, disabled via `[aria-disabled="true"]`. Loaded via `@use 'styles/link'` (included in the `@use 'styles/ds'` aggregate).
7
7
  - Typography utilities (`_typography.scss`): `.t-display`, `.t-h1`, `.t-h2`, `.t-h3`, `.t-h4`, `.t-h5`, `.t-l`, `.t-l-bold`, `.t-m`, `.t-m-bold`, `.t-s`, `.t-s-bold`, `.t-xs`, `.t-xs-bold`, `.t-overline`, `.t-caption`, `.t-mono`, `.t-mono-block`, `.sr-only`
8
8
  - Layout (`_layout-utils.scss`): `.grid-2`, `.grid-3`, `.grid-4`. Breakpoints: at ≤1100px `.grid-4` drops to 3 columns; at ≤820px both `.grid-3` and `.grid-4` drop to 2 columns. Gap is `--space-4`.
9
9
  - Page grid (`_page-grid.scss`): `.page-grid` + `.col-span-1` … `.col-span-12`. 4-tier responsive grid (4 / 8 / 12 / 12 columns); see Foundations → Grid above for the full spec.
@@ -12,7 +12,7 @@ The DS aggregate (`@use 'styles/ds'`) forwards the full stack: theme primitives
12
12
 
13
13
  **Two mixins for building your own composite controls.** `@use` the partial directly to reach the mixin; a mixin emits nothing until it is included.
14
14
 
15
- - `@use 'styles/focus' as focus;` → `focus.owns-the-focus-ring($control)`. This partial IS part of the `styles/ds` aggregate — it also carries the base indicator and the `data-focus` switch — so reaching for the mixin adds no CSS. Include it in a shell that paints its own ring on `:focus-within`, naming the ONE control inside that must not paint the base indicator too. `outline: 0` cannot do this — the base indicator is a box-shadow — and a box-wide reset instead of a named control silences the tab stops inside the box (a clear button, a stepper arrow), which leaves a keyboard user unable to tell what has focus. See Foundations → Colour → Focus for the worked example.
15
+ - `@use 'styles/focus' as focus;` → `focus.owns-the-focus-ring($control)`. The base indicator and the `data-focus` switch live in its `emit-rules` mixin, which `styles/ds` includes once, so reaching for a mixin adds no CSS. Include it in a shell that paints its own ring on `:focus-within`, naming the ONE control inside that must not paint the base indicator too. A plain `outline: 0` is not the same: the base indicator is an outline, and the mixin keeps it under forced colours, where the shell's box-shadow is dropped and nothing else would show focus. A box-wide reset instead of a named control silences the tab stops inside the box (a clear button, a stepper arrow), which leaves a keyboard user unable to tell what has focus. See Foundations → Colour → Focus for the worked example.
16
16
  - `@use 'styles/text-clip' as text-clip;` → `text-clip.single-line-ellipsis`. Mixin-only, so this partial is NOT part of the `styles/ds` aggregate and emits nothing on its own. A one-line label that truncates with an ellipsis. Use it instead of hand-writing `overflow: hidden; text-overflow: ellipsis`: with a line-height under the font's glyph box (Mulish measures 1.257em, so `--line-height-flat` and `--line-height-tight` both qualify) that `hidden` shaves the top and bottom off every glyph.
17
17
 
18
18
  ---