@ids-group-ltd/ids-design-system 0.13.4 → 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (102) hide show
  1. package/CHANGELOG.md +258 -0
  2. package/components.md +24 -14
  3. package/docs/agent/INDEX.md +1 -1
  4. package/docs/agent/charts/column-series-component.md +1 -1
  5. package/docs/agent/charts/ds-chart.md +3 -1
  6. package/docs/agent/charts/ds-line-chart.md +1 -1
  7. package/docs/agent/charts/line-series-component.md +1 -1
  8. package/docs/agent/forms/ds-search.md +1 -1
  9. package/docs/agent/forms/ds-switch.md +4 -2
  10. package/docs/agent/forms/ds-textarea.md +1 -0
  11. package/docs/agent/navigation/ds-pagination.md +2 -2
  12. package/docs/agent/platform/ds-config.md +2 -1
  13. package/docs/agent/tables/ds-cell-template.md +1 -1
  14. package/docs/agent/tables/ds-table.md +4 -3
  15. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +26 -19
  16. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs +2 -2
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs.map +1 -1
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs +13 -3
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs.map +1 -1
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +2 -2
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +27 -14
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +366 -81
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +4 -4
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +2 -2
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +8 -17
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +1 -1
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +2 -2
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +6 -5
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +42 -6
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +17 -9
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +8 -17
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +27 -5
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +4 -0
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs +23 -4
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs.map +1 -1
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +2 -2
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +20 -5
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +2 -2
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +30 -22
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +2 -2
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +21 -0
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +1 -1
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +91 -10
  66. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +2 -3
  68. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  69. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  70. package/migrations/0.12.2.json +4 -1
  71. package/migrations/0.13.3.json +32 -10
  72. package/migrations/0.13.4.json +1630 -132
  73. package/migrations/0.14.0.json +591 -0
  74. package/migrations/0.5.0.json +10 -4
  75. package/migrations/0.7.0.json +5 -2
  76. package/migrations/0.9.0.json +5 -2
  77. package/migrations/README.md +7 -2
  78. package/package.json +1 -1
  79. package/styles/_chart-frame.scss +4 -4
  80. package/styles/_chart-motion.scss +17 -10
  81. package/styles/_overlay-motion.scss +14 -6
  82. package/styles/_skeleton-shimmer.scss +4 -1
  83. package/styles/_tokens.scss +1 -1
  84. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +3 -5
  85. package/types/ids-group-ltd-ids-design-system-components-chart-data-table.d.ts +3 -0
  86. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +11 -3
  87. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +125 -26
  88. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +2 -0
  89. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +3 -5
  90. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +4 -1
  91. package/types/ids-group-ltd-ids-design-system-components-modal.d.ts +4 -0
  92. package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +15 -10
  93. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +1 -4
  94. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +7 -1
  95. package/types/ids-group-ltd-ids-design-system-components-search.d.ts +2 -0
  96. package/types/ids-group-ltd-ids-design-system-components-skeleton.d.ts +1 -0
  97. package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +10 -1
  98. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +35 -24
  99. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +13 -0
  100. package/types/ids-group-ltd-ids-design-system-components.d.ts +46 -3
  101. package/types/ids-group-ltd-ids-design-system-core.d.ts +13 -4
  102. package/types/ids-group-ltd-ids-design-system.d.ts +1 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,263 @@
1
1
  ## Unreleased
2
2
 
3
+ ## 0.14.0 — 2026-09-24
4
+
5
+ ### Breaking
6
+
7
+ - **`ds-chart` opens the tooltip its marks describe, and a mark no longer takes one.** A mark
8
+ reported its context and every consumer bound `dsChartTooltip` on the mark themselves; a plot
9
+ holding two marks could open two panels, and a plot whose consumer forgot the binding opened
10
+ none. Marks now offer the container a tooltip source the way they already report a domain, and
11
+ the container draws the single panel.
12
+
13
+ Drop `[dsChartTooltip]`, `[dsChartTooltipOrigin]`, `[dsChartTooltipPreferBelow]` and
14
+ `[dsChartTooltipTemplate]` from `g[dsColumnSeries]` and `g[dsLineSeries]`. What replaces them:
15
+ nothing for the ordinary case, `[tooltipTemplate]` on `<ds-chart>` for a custom panel body, and
16
+ `[tooltipExtraGap]` there for a chart that prints value labels in the gap the panel wants.
17
+
18
+ - **The chart tooltip pane is inert unless the reading is pinned.** The pane is drawn over the plot
19
+ it describes, so on a funnel or a tight category axis it covered the neighbouring marks and the
20
+ mark underneath never saw the pointer - the panel named a segment the reader had already left.
21
+ A pinned pane takes the pointer again, so its text can still be selected. A rule of yours on
22
+ `.cdk-overlay-pane.ds-chart-tooltip-pane` that assumed `pointer-events: auto` needs
23
+ `.is-pinned` added to it.
24
+
25
+ - **Subclassing one of these breaks on a name collision.** `ChartComponent`,
26
+ `ColumnSeriesComponent`, `LineSeriesComponent`, `ColumnChartComponent`, `ScatterChartComponent`,
27
+ `ChartDataTableComponent`, `BarChartComponent`, `FunnelChartComponent` and `PieChartComponent`
28
+ each gained members, most of them while the container took over the tooltip, and so did
29
+ `ChartTooltipDirective`, which is internal but reachable through
30
+ `@ids-group-ltd/ids-design-system/components/chart-tooltip`. Outside the charts,
31
+ `ModalCardComponent`, `PaginationComponent`, `SearchComponent`, `SwitchComponent`,
32
+ `TableComponent`, `TextareaComponent`, `LineChartComponent` and `CellTemplateDirective` gained
33
+ members too, and so did
34
+ every field control: each extends one of the internal base classes `DsControlValueAccessor` or
35
+ `DsBooleanControlValueAccessor`, which gained `blur`. Declaring a member of the same name in a
36
+ subclass is a compile error - TS4114, or TS2416 where the signature differs - so rename yours or
37
+ add `override`. Protected members went too: the roving-focus pair on the bar, pie and funnel
38
+ charts and the column series, the per-mark event handlers of the column and line series, and the
39
+ plot's pointer handlers. A method of yours named like one of those, declared without `override`,
40
+ still compiles and is never called again, so delete it. Subclassing a DS component is unsupported
41
+ either way.
42
+
43
+ - **`ChartScales` requires two tooltip methods.** `reportTooltip(id, source)` and
44
+ `releaseTooltip(id)` are required members now that the container draws the single tooltip panel.
45
+ `<ds-chart>` implements both; a container of your own that implements `ChartScales` by hand does
46
+ not compile until you add them. The type of `source` is not exported - a hand-written container
47
+ forwards what its marks report without naming it.
48
+
49
+ - **Five tokens take their property's name.** `--ds-input-label-fw` is
50
+ `--ds-input-label-font-weight`, `--ds-tag-fw` is `--ds-tag-font-weight`, `--ds-tag-lh` is
51
+ `--ds-tag-line-height`, and `--ds-slider-thumb-bw` is `--ds-slider-thumb-border-width`. The
52
+ theme-level `--slider-thumb-bw` in `styles/_tokens.scss` is `--slider-thumb-border-width`; the
53
+ slider's own token falls back to it, then to `--border-width-strong`. An unknown custom property is
54
+ not an error, so a declaration left on an old name is inert and the element draws at its fallback
55
+ with no warning.
56
+
57
+ - **`ds-pagination`'s `layout` input is `PaginationLayout | null` and defaults to `null`.** It was
58
+ `PaginationLayout` with a `'grouped'` default. Writing the attribute in a template is unchanged,
59
+ but code that reads `layout()` back through a `viewChild` now sees `null` on a pager that was never
60
+ given one, and a subclass overriding `layout` must widen its type to match. The effective value -
61
+ the input, then `DS_CONFIG.pagination.layout`, then `'grouped'` - is `layoutResolved()`, which is
62
+ new and public; `sizeResolved()` is public too.
63
+
64
+ ### Added
65
+
66
+ - **`dsLineSeries` takes an `outline`, on by default.** The line and its markers sit on a band of
67
+ the surface colour, so they stay legible where they cross columns. Set `[outline]="false"` for a
68
+ line on an empty plot where the band only separates it from the gridlines. `ds-line-chart` takes
69
+ the same `outline` input and passes it to its series.
70
+
71
+ - **`dsColumnSeries` takes `seriesKey` and `highlighted`.** Naming a series in the legend fades the
72
+ others to `--ds-chart-dim-opacity`, which `ds-column-chart` now wires for you.
73
+
74
+ - **`ChartScales` carries an optional `measured` signal**, true once the plot has its real width.
75
+ A mark of your own can wait for it before building geometry the first measurement would replace.
76
+ A container of your own that implements `ChartScales` may leave it out, and a mark reads it as
77
+ always measured then.
78
+
79
+ - **`ds-bar` reads `--ds-bar-radius` on the track and the fill.** It defaults to
80
+ `var(--radius-pill)`, the shape both hard-coded before, so a bar can now be squared.
81
+
82
+ - **`ds-line-chart` sizes its loading and empty states from `--ds-line-chart-placeholder-height`.**
83
+ It sizes the loading skeleton and the empty and error box. Unset, the skeleton falls back to the
84
+ plot height and the message box to the view height, as before. Since 0.13.4
85
+ `--ds-line-chart-plot-height` also sizes the plot, so a value you set only to size the placeholder
86
+ states resizes every plot - move it to the new token.
87
+
88
+ - **`ds-pagination` takes `loading`.** A boolean attribute, default false: it sets
89
+ `aria-busy="true"` on the `<nav>`, replaces the "N of M" range label with an inline skeleton so a
90
+ stale total is never quoted, and disables Prev, Next, every page button and the rows-per-page
91
+ select. The current page button keeps its colour while disabled.
92
+
93
+ - **`DS_CONFIG` takes `pagination`.** `pagination?: { size?: DsSize; layout?: PaginationLayout }`
94
+ sets the default size and layout of every pager, `ds-table`'s footer included. A pager resolves
95
+ `size` from its input, then `DS_CONFIG.pagination.size`, then `DS_CONFIG.control.size`, then
96
+ `'sm'`; `layout` from its input, then `DS_CONFIG.pagination.layout`, then `'grouped'`.
97
+
98
+ - **`ds-table` takes `paginationSize` and `paginationLayout`.** Both default to `null`
99
+ (`DsSize | null` and `PaginationLayout | null`) and are forwarded to the footer pager's `size` and
100
+ `layout`, resolved through the same chain as a standalone pager.
101
+
102
+ - **`dsCellTemplate` types its `let-row` from `[dsCellTemplateOf]`.** The directive is generic,
103
+ `CellTemplateDirective<T = unknown>`, and `[dsCellTemplateOf]="rows"` - typing only, never read at
104
+ runtime - types `let-row` as the row type under strict templates. The new exported type
105
+ `CellTemplateContext<T = unknown>` is `{ readonly $implicit: T; readonly row: T }`. The
106
+ `rowExpandTemplate` and `cellTemplateMap` contexts stay `unknown`.
107
+
108
+ - **Every field control and `ds-search` gain `blur(): void`.** The counterpart of `focus()`: it
109
+ drops focus from whichever descendant of the host holds it, leaving an open overlay panel alone.
110
+
111
+ - **`ds-textarea` exposes the native selection API.** `selectionStart` and `selectionEnd` (0 before
112
+ the view exists), `setSelectionRange(start, end, direction?: 'forward' | 'backward' | 'none')`,
113
+ which does not move focus, and `select()`, each forwarded to the native textarea. A value written
114
+ through `value` reaches the element a microtask later and drops the caret to the end, so after
115
+ `value.set(...)` set the range from a `setTimeout`, not synchronously.
116
+
117
+ - **`ds-switch` takes `controlled` and emits `checkedRequested`.** `controlled` is a boolean
118
+ attribute, default false; `checkedRequested` is a `boolean` output carrying the value the user
119
+ asked for. Under `controlled` a click or Space is cancelled on the native toggle,
120
+ `checkedRequested` emits `!checked()`, and the switch moves only when `[checked]` changes. Because
121
+ the toggle is cancelled, a two-way `checked`, an `ngModel` or a form control is not updated by the
122
+ gesture - the host commits the value through `[checked]`. Without `controlled` nothing changes.
123
+
124
+ - **`PaginationLayout` is exported from `@ids-group-ltd/ids-design-system/core`** as well as from
125
+ `@ids-group-ltd/ids-design-system/components/pagination` and the package root.
126
+
127
+ - **`ds-modal` and `ds-modal-card` read `--ds-modal-actions-stacked-direction`.** Default
128
+ `column`, which stacks the actions in DOM order with the confirming action at the bottom;
129
+ `column-reverse` puts it on top. It has no effect while the actions row fits on one line.
130
+
131
+ ### Changed
132
+
133
+ - **Modal actions stack full-width when they outgrow the card.** When the `[actions]` row is wider
134
+ than the card, `.actions` gains `.stacked` and every projected action becomes full-width in a
135
+ column, in DOM order - cancel then confirm, matching Tab order. A row that fits stays a
136
+ right-aligned single line. The row used to overflow past the card's start edge and clip the first
137
+ button.
138
+
139
+ - **`ds-table`'s footer pager is disabled while the table shows skeleton rows.** Whenever the
140
+ table draws skeletons - `loading="skeleton"`, or `loading` on a table with no rows yet - the pager
141
+ gets `loading`, so its controls are disabled and `aria-busy` while the placeholder rows show. The
142
+ overlay mode leaves the pager alone.
143
+
144
+ - **`ds-scatter-chart` fades the other series while a legend entry is hovered**, to
145
+ `--ds-chart-dim-opacity`, as the other charts with a legend do.
146
+
147
+ - **Under a category cursor, a line chart's active marker grows for the whole category band**, not
148
+ only while the pointer is on the 4px dot, and the panel anchors above the tallest reading at the
149
+ category rather than whichever mark reported first.
150
+
151
+ - **The chart tooltip fades out when the pointer leaves the plot** instead of vanishing, and its
152
+ colour dot is larger, with a surface-coloured ring; a hatched dot's stripes run at 45deg.
153
+
154
+ - **A category panel names every series at the category.** `tooltip="axis"` was documented to do
155
+ this and listed only the series that opened it, because a mark could not see the others. Marks
156
+ now offer the container what they read at the cursor's category and the container merges them,
157
+ so a column and a line sharing a plot appear in one panel.
158
+
159
+ - **Legend hover fades the other series whether or not `dimOthers` is set.** That input governs
160
+ what a pointer over a MARK does; naming a series in the legend is the reader asking for that one
161
+ directly. On `dsLineSeries` this is the `highlighted` input, so a `[highlighted]` binding of yours
162
+ now fades the other lines without `dimOthers`, where before it only thickened the named one.
163
+
164
+ - **The unpin control sits below the plot.** The panel it undoes opens above the held mark, so a
165
+ control at the top was the one thing that panel covered.
166
+
167
+ - **A chart's data table is built the first time it is opened.** A closed disclosure carried the
168
+ whole table in the DOM; it now holds only its summary until the reader opens it, and keeps the
169
+ table from then on. `dataTable="visible"` is unaffected. The browser's find-in-page no longer
170
+ reaches the numbers of a table nobody has opened.
171
+
172
+ - **A mark's entrance is a CSS animation declared on the mark, and the `mark-enter` class is
173
+ gone.** The entrance plays when the mark is inserted - on first render and for a mark a data
174
+ change adds - exactly as before. A rule of yours that restyled the entrance through
175
+ `.mark-enter` targets the mark itself instead.
176
+
177
+ ### Fixed
178
+
179
+ - **A stacked mark answers the pointer over its own segment.** Each series carried a hit box
180
+ spanning the whole category slot, so stacked they lay on top of one another and only the series
181
+ drawn last ever answered - every segment reported the top one.
182
+
183
+ - **A tooltip anchored to a zero-value mark stays with its reading.** Such a mark is degenerate in
184
+ one axis - a column loses its height, a bar its width - and the overlay took the viewport corner
185
+ or the plot's left edge instead of the category.
186
+
187
+ - **The bar chart's tooltip points at the drawn value, not the track.** A floating bar put its
188
+ panel a full track width from the reading it describes.
189
+
190
+ - **A segmented bar's tooltip names its segments.** It repeated the row label the pointer was
191
+ already on; the row now heads the panel and each segment gets a line with its share.
192
+
193
+ - **A hatched mark's tooltip dot carries the same break its mark does**, so the panel and the plot
194
+ encode the distinction the same way and neither relies on hue alone.
195
+
196
+ - **The pinned-mark badge clears the column's top edge**, instead of sitting flush against it and
197
+ reading as part of the bar.
198
+
199
+ - **The column panel names a column whose header is visually empty.** A column declared with an
200
+ empty `label` and a `screenReaderLabel` - an actions column, say - was listed in the
201
+ `dsTableColumns` panel as a bare checkbox with no text, so nothing said which column it stood
202
+ for. The row now reads the `screenReaderLabel`, which also gives the checkbox its accessible
203
+ name.
204
+
205
+ - **A chart that enters hundreds of marks at once no longer freezes the page.** Every entering or
206
+ leaving mark asked the browser for its running animations, and in Chrome that call slows down with each
207
+ animation already running, so a scatter of a thousand points held the main thread for seconds -
208
+ longer still on a page with other charts entering. Under zone.js a `ds-chart` also ran two extra
209
+ change-detection passes of the whole application after its first render, a column or line series
210
+ built its geometry at a stand-in width before the real one arrived, every point, marker and column
211
+ carried up to eight event listeners of its own, and the default number format built a new
212
+ formatter for every label.
213
+
214
+ - **`ds-date-picker` keeps its border around its value in a container narrower than the mask.**
215
+ The value cannot clip, so the field shrank its border around it and the value and the calendar
216
+ button ran past the border - a range picker under `fullWidth` was the common case. The field now
217
+ keeps its content width as a minimum and overflows the container with its border intact. A
218
+ container that fits the mask renders as before.
219
+
220
+ - **A chart with an axis title reserves a band for it.** The widest tick label no longer runs
221
+ through the rotated title, and the secondary axis title gets its own band, so both titles stand the
222
+ same distance from their ticks.
223
+
224
+ - **Axis labels are measured again when their text changes.** The value gutter and the rotation and
225
+ thinning of category labels were decided on the first render alone, so a chart that started out
226
+ loading or empty, or whose categories or ticks changed later, kept overlapping labels.
227
+
228
+ - **A skeleton pauses its shimmer while it is off screen, and moves it twenty times a second.** The
229
+ wave is main-thread work on every update, on screen or not. Off screen it now stops, and resumes
230
+ where it stopped, so a placeholder that has been scrolled away can come back out of step with its
231
+ neighbours. On screen it advances in 68 steps over the default 3400ms instead of once per display
232
+ frame; a step is about one level of lightness. A `--ds-skeleton-wave-duration` of yours changes
233
+ the step rate with it, since the step count is fixed.
234
+
235
+ - **Reduced motion stops the skeleton shimmer.** The opt-out rule lost to the component's own
236
+ animation, and the wave kept running for readers who asked for less motion.
237
+
238
+ - **A chart destroyed while a reading was pinned no longer leaves a key listener on the document.**
239
+
240
+ - **An expanded `ds-table` row's panel spans every column.** The panel's `<td>` carried
241
+ `display: grid` for its reveal, and a cell whose display is not `table-cell` leaves the table
242
+ layout, so its `colspan` was ignored and the panel rendered one column wide - as narrow as its
243
+ first word. The grid and the `ds-table-expand` animation sit on `.expand-panel-inner`, and the
244
+ projected template is wrapped in `.expand-panel-content`, the track the reveal clips. A rule of
245
+ yours that reached your template's root through `.expand-panel-inner >` selects
246
+ `.expand-panel-content` now; `.expand-panel-cell > .expand-panel-inner` is unchanged.
247
+
248
+ ### What you can now DELETE
249
+
250
+ | Delete | Why | Replace with |
251
+ | --- | --- | --- |
252
+ | `ds-table .expand-panel-cell { display: table-cell }`, or a `::ng-deep` rule of that shape | the expand cell is a table cell, so the rule restates the default - and while it held, it also switched the reveal animation off | nothing |
253
+ | `[dsChartTooltip]="` and the `[dsChartTooltipOrigin]="` / `[dsChartTooltipPreferBelow]="` beside it, on any `g[dsColumnSeries]` or `g[dsLineSeries]` | `ds-chart` opens the panel its marks describe, so a binding on the mark opens a second one | nothing for the ordinary case; `[tooltipTemplate]` and `[tooltipExtraGap]` on `ds-chart` where the panel was customised |
254
+ | a `ds-modal-card .actions` rule setting `flex-wrap: wrap` | the actions row stacks full-width on its own once it outgrows the card, so a wrap rule only fights it | nothing |
255
+ | a `.pagination.pagination` or `.pagination-button.pagination-button` rule under `ds-table` forcing the footer pager's width, layout or button height | the footer pager takes its size and layout as inputs | `paginationSize` / `paginationLayout` on `ds-table`, or `provideDsConfig({ pagination: { ... } })`; a height none of `sm`, `md` or `lg` gives stays |
256
+ | `querySelector('input')?.blur()` reaching into a field control to drop focus | every field control has a public `blur()` | `blur()` on the field instance |
257
+ | `querySelector("textarea")` reaching into `ds-textarea` for its selection | the textarea forwards the native selection API | `selectionStart` / `selectionEnd` / `setSelectionRange()` / `select()` on `ds-textarea` |
258
+ | a `(row: unknown)` helper doing `return row as ` your row type for a cell template | `[dsCellTemplateOf]` types `let-row` | `[dsCellTemplateOf]="rows"` on the `dsCellTemplate`; keep a caster only for `rowExpandTemplate` or `cellTemplateMap` |
259
+ | a wrapper around `ds-switch` that calls `preventDefault()` and does `emit(!this.checked())` to gate a change | `ds-switch` cancels its own toggle under `controlled` and reports the request | `controlled` with `(checkedRequested)`, `[checked]` bound to the committed state |
260
+
3
261
  ## 0.13.4 — 2026-09-23
4
262
 
5
263
  ### Breaking
package/components.md CHANGED
@@ -140,6 +140,9 @@ Every entry below names its exported class (`ButtonComponent`, `TableComponent<T
140
140
  checkbox, radio, radio-group, switch, slider, segmented, OTP): `label`, `hint`, `error`, `warning`,
141
141
  `errors`, `invalid`, `touched`, `reserveMessage` — and one message line under the control that renders
142
142
  whichever of them wins. The ladder is error → errors → warning → advisory errors → success → hint.
143
+ Every field control also has `focus(options?)` and `blur()`. `blur()` drops focus from whichever
144
+ descendant holds it and leaves a portaled panel alone; `ds-autocomplete.clear()` keeps focus on
145
+ purpose, so a host that navigates away calls `clear()` then `blur()`.
143
146
 
144
147
  `error`, `warning` and `success` lead that line with a glyph; `hint` does not, because it is the resting
145
148
  text rather than a state. Retune app-wide with `DS_CONFIG.field.stateIcons` (per state, independent —
@@ -218,6 +221,7 @@ Multi-line counterpart to `<ds-input>` — same wrapper/states, reuses the `--ds
218
221
  Inputs: `value: model<string>`, `size: 'sm' | 'md' | 'lg' = 'md'`, `label`, `hint`, `placeholder`, `disabled`, `invalid`, `required`, `optional: boolean = false`, `name`, `rows: number = 3`
219
222
  Tokens: same `--ds-input-*` family as `<ds-input>` (textarea overrides `--ds-input-padding-y` to `--space-3` for vertical breathing room).
220
223
  New: `autosize: boolean = false` (grows with content; forces `resize='none'`), `minRows`/`maxRows: number | null = null`, `resize: 'none' | 'vertical' | 'horizontal' | 'both' = 'vertical'`.
224
+ 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`.
221
225
 
222
226
  <!-- inputs:ds-textarea -->
223
227
  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`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`
@@ -248,10 +252,12 @@ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `
248
252
  <!-- /inputs -->
249
253
 
250
254
  #### `<ds-switch>` — `SwitchComponent`
251
- Inputs: `checked: model<boolean>`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`
255
+ Inputs: `checked: model<boolean>`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`, `controlled: boolean = false`
256
+ Outputs: `(checkedRequested): boolean` - only when `controlled`: the value the user asked for; the switch waits for `[checked]` to change.
257
+ Controlled: `<ds-switch controlled [checked]="paused()" (checkedRequested)="askPause($event)" />` - a click cancels the native toggle instead of flipping, so a confirm dialog can run first and a cancelled one leaves the track untouched. Off by default; the switch flips on every toggle as before.
252
258
 
253
259
  <!-- inputs:ds-switch -->
254
- 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`, `checked: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`
260
+ 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`, `checked: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`, `controlled: boolean = false`
255
261
  <!-- /inputs -->
256
262
 
257
263
  #### The picker family — `<ds-select>`, `<ds-multi-select>`, `<ds-autocomplete>`
@@ -305,7 +311,7 @@ All inputs: `hint: string = ''`, `error: string = ''`, `warning: string = ''`, `
305
311
  Pre-styled search input with built-in icon. A form control, but not a field: no label, no message row.
306
312
  Inputs: `value: model<string>`, `placeholder: string = 'Search'`, `shortcut: string = ''` (rendered as a hint pill, e.g. `⌘K`), `showIcon: boolean = true`, `clearable: boolean = false`, `ariaLabel: string = ''`, `disabled: boolean = false`, `hidden: boolean = false`, `size: DsSize | null = null`, `debounce: number = 0` (ms held before `value` updates; clearing, Enter and `clear()` all skip the timer)
307
313
  Output: `(submitted): string` — emits the current value on Enter / form submit
308
- Methods: `clear()` — empties the field, drops an armed keystroke and publishes `''` at once, which writing `''` into `value` does not; `focus()`.
314
+ Methods: `clear()` — empties the field, drops an armed keystroke and publishes `''` at once, which writing `''` into `value` does not; `focus()`, `blur()`.
309
315
  Binds through `NG_VALUE_ACCESSOR`, taking the value plumbing without the field-message layer — so `hint` / `error` / `warning` / `errors` / `invalid` / `touched` / `reserveMessage` / `messageIcon` are NOT inputs here.
310
316
 
311
317
  <!-- inputs:ds-search -->
@@ -677,11 +683,11 @@ All inputs: `steps: readonly string[] = []`, `current: number = 0`, `labelPositi
677
683
  <!-- /inputs -->
678
684
 
679
685
  #### `<ds-pagination>` — `PaginationComponent`
680
- Inputs: `total: required number`, `pageSize: model<number> = 10`, `currentPage: model<number> = 1`, `pageSizeOptions: number[] = [10, 25, 50, 100]`, `showLabel: boolean = true`, `size: DsSize | null = null` (unset resolves `DS_CONFIG.control.size`, then `sm`), `layout: PaginationLayout = 'grouped'` (`'grouped' | 'spread'`; `'spread'` gives the nav full width and pushes the label and the controls to opposite edges)
686
+ Inputs: `total: required number`, `pageSize: model<number> = 10`, `currentPage: model<number> = 1`, `pageSizeOptions: number[] = [10, 25, 50, 100]`, `showLabel: boolean = true`, `size: DsSize | null = null` (unset resolves `DS_CONFIG.pagination.size`, then `DS_CONFIG.control.size`, then `sm`), `layout: PaginationLayout | null = null` (`'grouped' | 'spread'`; unset resolves `DS_CONFIG.pagination.layout`, then `'grouped'`; `'spread'` gives the nav full width and pushes the label and the controls to opposite edges), `loading: boolean = false` (every control disables, the range label is masked with a `ds-skeleton` so a stale `total` is never quoted, and the nav reports `aria-busy`). Inside `ds-table` `size` and `layout` arrive as `paginationSize` / `paginationLayout`, and `loading` is set from `loading="skeleton"`.
681
687
  Outputs: `(currentPageChange): number`, `(pageSizeChange): number`
682
688
 
683
689
  <!-- inputs:ds-pagination -->
684
- All inputs: `total: required number`, `pageSize: number = 10`, `currentPage: number = 1`, `pageSizeOptions: number[]`, `showLabel: boolean = true`, `showPageSize: boolean = true`, `size: 'sm' | 'md' | 'lg' = null`, `layout: 'grouped' | 'spread' = 'grouped'`
690
+ All inputs: `total: required number`, `pageSize: number = 10`, `currentPage: number = 1`, `pageSizeOptions: number[]`, `showLabel: boolean = true`, `showPageSize: boolean = true`, `size: 'sm' | 'md' | 'lg' = null`, `layout: 'grouped' | 'spread' = null`, `loading: boolean = false`
685
691
  <!-- /inputs -->
686
692
 
687
693
  #### `<ds-divider>` — `DividerComponent`
@@ -828,13 +834,14 @@ Inputs: `data: required readonly T[]`, `columns: required readonly TableColumn<T
828
834
  Outputs: `(rowClicked): T`, `(sortChange): SortChangeEvent` (`{ key, dir }`)
829
835
  Column shape: `{ key: string, label: string, sortable?: boolean, align?: 'left' | 'right' | 'center', cell?: (row: T) => string }`
830
836
  Opening a row: give one column `link: (row) => <route target> | null` and its value renders as a real `<a>` — visible without hovering, in the tab order as a link, and Ctrl/Cmd-clickable, none of which a clickable `<tr>` can do. `null` for a row leaves that cell as plain text, so a partly-reachable list stays one column; external URLs go through a `[dsCellTemplate]` instead, since `link` takes Angular route targets only. It composes with `rowInteractive` (the link stops its click from reaching the row), but the two together cost **two tab stops per row** — on a long list prefer the link alone. `interactive: true` only tints a cell on row hover, which a keyboard or touch user never sees; prefer `link` wherever the row actually leads somewhere.
831
- Cell templates: `<ng-template dsCellTemplate="<colKey>" let-row>…</ng-template>` — `row` is typed `unknown`, narrow via a helper method on the host.
837
+ Cell templates: `<ng-template dsCellTemplate="<colKey>" [dsCellTemplateOf]="rows" let-row>…</ng-template>` — bound to the same rows as `[data]`, `dsCellTemplateOf` types `row` as `T` under strict templates (a field typo is a compile error) and is never read at runtime. Without it `row` is `unknown`; narrow via a helper method on the host. `CellTemplateContext<T>` (`$implicit` and `row`) is exported.
832
838
  Content slots: `[empty]` (rendered when `data.length === 0`), `[bulk-actions]` (rendered in the bulk action bar when `selectable && some selected`)
833
- Loading modes: `'skeleton'` replaces rows with shimmer placeholders driven by the global `--skeleton-shimmer-x` keyframe; `'overlay'` keeps existing rows visible behind a translucent layer with a centred spinner.
839
+ Loading modes: `'skeleton'` replaces rows with shimmer placeholders driven by the global `--skeleton-shimmer-x` keyframe; `'overlay'` keeps existing rows visible behind a translucent layer with a centred spinner; under `'skeleton'` the footer pager takes `loading` as well - its controls disable and its range label is masked, so it never quotes the previous query's count. `'overlay'` leaves the pager live, like the header.
840
+ Footer pager: `pageSizeOptions`, `showPageSize`, `showLabel`, `paginationSize: DsSize | null = null` and `paginationLayout: PaginationLayout | null = null` are the embedded `ds-pagination`'s own inputs forwarded one-to-one; the last two unset resolve `DS_CONFIG.pagination.size` (then `DS_CONFIG.control.size`, then `sm`) and `DS_CONFIG.pagination.layout` (then `'grouped'`), so an app whose every pager wants `md` / `spread` says it once in the config.
834
841
  Tokens: `--ds-table-border: var(--border-default)`, `--ds-table-radius: var(--radius-md)`, `--ds-table-bg-color`, `--ds-table-head-text-color: var(--text-secondary)`, `--ds-table-head-bg-color: var(--surface-secondary)`, `--ds-table-head-font-size: var(--font-size-xs)`, `--ds-table-row-hover-bg-color`, `--ds-table-row-selected-bg-color`, `--ds-table-divider`, `--ds-table-sort-active-icon-color`, `--ds-table-cell-padding-x/y`. (Renamed 2026-06: `--ds-table-header-*` → `--ds-table-head-*`, matching the tokens reference.)
835
842
 
836
843
  <!-- inputs:ds-table -->
837
- All inputs: `data: required readonly T[]`, `rowId: ((row: T) => string) | null = null`, `columns: required readonly TableColumn<T>[]`, `selectable: boolean = false`, `bordered: boolean | null = null`, `loading: boolean | 'skeleton' | 'overlay' = false`, `stickyHeader: boolean = true`, `maxHeight: string | null = null`, `density: 'default' | 'compact' = 'default'`, `zebra: boolean = false`, `animateHeight: boolean = false`, `selectedIds: Set<string>`, `sortKey: string | null = null`, `sortDirection: 'asc' | 'desc' = null`, `sortingOrder: SortDirection[]`, `sortAnnouncement: (label: string, dir: SortDirection) => string`, `rangeAnnouncement: (first: number, last: number, total: number) => string`, `skeletonRows: number = 5`, `caption: string = ''`, `rowInteractive: boolean = false`, `activeRowId: string | null = null`, `filterQuery: string = ''`, `columnFilters: Map<string, ReadonlySet<string>>`, `persistLayout: boolean = false`, `storageKey: string = ''`, `stickyScrollbar: boolean | null = null`, `pageSize: number | null = null`, `page: number = 1`, `pageSizeOptions: number[]`, `showPageSize: boolean = true`, `showLabel: boolean = true`, `total: number | null = null`, `scrollToTopOnPageChange: boolean = false`, `sortMode: 'client' | 'server' | 'none' = null`, `filterMode: 'client' | 'server' | 'none' = null`, `columnFilterOptions: ReadonlyMap<string, readonly string[]>`, `stickyScrollbarOffset: string | null = null`, `stickyFirstColumn: boolean = false`, `virtualScroll: boolean = false`, `virtualRowSize: number = 44`, `lazy: boolean = false`, `rowActions: readonly TableRowAction<T>[] = []`, `cellTemplateMap: Record<string, TemplateRef<{ $implicit: unknown; row: unknown }>> = {}`, `emptyTemplate: TemplateRef<unknown> | null = null`, `expandableRows: boolean = false`, `expandedIds: Set<string>`, `expandMode: 'multiple' | 'single' = 'multiple'`, `expandAllToggle: boolean = false`, `rowExpandTemplate: TemplateRef<{
844
+ All inputs: `data: required readonly T[]`, `rowId: ((row: T) => string) | null = null`, `columns: required readonly TableColumn<T>[]`, `selectable: boolean = false`, `bordered: boolean | null = null`, `loading: boolean | 'skeleton' | 'overlay' = false`, `stickyHeader: boolean = true`, `maxHeight: string | null = null`, `density: 'default' | 'compact' = 'default'`, `zebra: boolean = false`, `animateHeight: boolean = false`, `selectedIds: Set<string>`, `sortKey: string | null = null`, `sortDirection: 'asc' | 'desc' = null`, `sortingOrder: SortDirection[]`, `sortAnnouncement: (label: string, dir: SortDirection) => string`, `rangeAnnouncement: (first: number, last: number, total: number) => string`, `skeletonRows: number = 5`, `caption: string = ''`, `rowInteractive: boolean = false`, `activeRowId: string | null = null`, `filterQuery: string = ''`, `columnFilters: Map<string, ReadonlySet<string>>`, `persistLayout: boolean = false`, `storageKey: string = ''`, `stickyScrollbar: boolean | null = null`, `pageSize: number | null = null`, `page: number = 1`, `pageSizeOptions: number[]`, `showPageSize: boolean = true`, `showLabel: boolean = true`, `paginationSize: 'sm' | 'md' | 'lg' = null`, `paginationLayout: 'grouped' | 'spread' = null`, `total: number | null = null`, `scrollToTopOnPageChange: boolean = false`, `sortMode: 'client' | 'server' | 'none' = null`, `filterMode: 'client' | 'server' | 'none' = null`, `columnFilterOptions: ReadonlyMap<string, readonly string[]>`, `stickyScrollbarOffset: string | null = null`, `stickyFirstColumn: boolean = false`, `virtualScroll: boolean = false`, `virtualRowSize: number = 44`, `lazy: boolean = false`, `rowActions: readonly TableRowAction<T>[] = []`, `cellTemplateMap: Record<string, TemplateRef<{ $implicit: unknown; row: unknown }>> = {}`, `emptyTemplate: TemplateRef<unknown> | null = null`, `expandableRows: boolean = false`, `expandedIds: Set<string>`, `expandMode: 'multiple' | 'single' = 'multiple'`, `expandAllToggle: boolean = false`, `rowExpandTemplate: TemplateRef<{
838
845
  $implicit: unknown;
839
846
  row: unknown;
840
847
  }> | null = null`
@@ -845,7 +852,7 @@ All inputs: `data: required readonly T[]`, `rowId: ((row: T) => string) | null =
845
852
  #### `[dsCellTemplate]` — `CellTemplateDirective`
846
853
 
847
854
  <!-- inputs:[dsCellTemplate] -->
848
- All inputs: `dsCellTemplate: required string`
855
+ All inputs: `dsCellTemplate: required string`, `dsCellTemplateOf: readonly T[] | null = null`
849
856
  <!-- /inputs -->
850
857
 
851
858
  #### `<ng-template[dsHeaderFilter]>` — `HeaderFilterDirective`
@@ -1001,7 +1008,7 @@ Colour: series ARE different things, so the categorical palette applies — `--d
1001
1008
  Tokens: `--ds-line-chart-plot-height`, `--ds-line-chart-line-width`, `--ds-line-chart-dot-radius`, `--ds-line-chart-area-opacity`, `--ds-line-chart-swatch-size`, `--ds-line-chart-grid-line-color`, `--ds-line-chart-axis-line-color`, `--ds-line-chart-axis-label-color`, `--ds-line-chart-axis-font-size`, `--ds-line-chart-annotation-color`, `--ds-line-chart-annotation-font-size`, `--ds-line-chart-annotation-font-weight`, `--ds-line-chart-annotation-halo-color`, `--ds-line-chart-annotation-halo-width`.
1002
1009
 
1003
1010
  <!-- inputs:ds-line-chart -->
1004
- All inputs: `categories: required readonly string[]`, `series: required readonly LineChartSeries[]`, `yAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `showMarkers: boolean = true`, `annotations: readonly LineChartAnnotation[] = []`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `stack: 'none' | 'stacked' | 'normalized' = 'none'`, `yAxisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tickCount: number = 5`, `frame: 'auto' | 'none' = null`, `tooltipLingerMs: number | null = null`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `max: number | null = null`, `maxSecondary: number | null = null`, `loading: boolean = false`, `emptyText: string | null = null`, `error: boolean = false`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `hiddenSeries: readonly string[] = []`, `rescaleOnHide: boolean = false`, `legendFilters: boolean = false`, `legendMode: 'toggle' | 'isolate' = 'isolate'`, `noVisibleSeriesText: string = 'All series are hidden'`, `patterns: boolean = false`, `staggerMs: number = 0`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `tooltipAnchor: 'point' | 'pointer' = 'point'`
1011
+ All inputs: `categories: required readonly string[]`, `series: required readonly LineChartSeries[]`, `yAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `showMarkers: boolean = true`, `outline: boolean = true`, `annotations: readonly LineChartAnnotation[] = []`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `stack: 'none' | 'stacked' | 'normalized' = 'none'`, `yAxisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tickCount: number = 5`, `frame: 'auto' | 'none' = null`, `tooltipLingerMs: number | null = null`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `max: number | null = null`, `maxSecondary: number | null = null`, `loading: boolean = false`, `emptyText: string | null = null`, `error: boolean = false`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `hiddenSeries: readonly string[] = []`, `rescaleOnHide: boolean = false`, `legendFilters: boolean = false`, `legendMode: 'toggle' | 'isolate' = 'isolate'`, `noVisibleSeriesText: string = 'All series are hidden'`, `patterns: boolean = false`, `staggerMs: number = 0`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `tooltipAnchor: 'point' | 'pointer' = 'point'`
1005
1012
  <!-- /inputs -->
1006
1013
 
1007
1014
  #### Chart defaults — what `DS_CONFIG` decides once
@@ -1038,19 +1045,21 @@ All inputs: `columns: readonly string[] = []`, `rows: readonly ChartDataRow[] =
1038
1045
  #### `<ds-chart>` — `ChartComponent`
1039
1046
 
1040
1047
  <!-- inputs:ds-chart -->
1041
- All inputs: `categories: readonly string[] = []`, `tickCount: number = 5`, `min: number | null = null`, `max: number | null = null`, `cursor: 'none' | 'category' = 'none'`, `cursorPin: boolean = false`, `tooltipLingerMs: number | null = null`, `maxSecondary: number | null = null`, `plotHeight: number = 240`, `axisGutter: number = 46`, `valueSpace: number = 20`, `caption: string | null = null`, `interactive: boolean = false`, `summary: string | null = null`, `frame: 'auto' | 'none' = null`, `loading: boolean = false`, `emptyText: string | null = null`, `error: boolean = false`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `secondaryAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `axisColor: string | null = null`, `secondaryAxisColor: string | null = null`, `axisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`
1048
+ All inputs: `categories: readonly string[] = []`, `tickCount: number = 5`, `min: number | null = null`, `max: number | null = null`, `cursor: 'none' | 'category' = 'none'`, `cursorPin: boolean = false`, `tooltipLingerMs: number | null = null`, `maxSecondary: number | null = null`, `plotHeight: number = 240`, `axisGutter: number = 46`, `valueSpace: number = 20`, `caption: string | null = null`, `interactive: boolean = false`, `summary: string | null = null`, `frame: 'auto' | 'none' = null`, `loading: boolean = false`, `emptyText: string | null = null`, `error: boolean = false`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `secondaryAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `axisColor: string | null = null`, `secondaryAxisColor: string | null = null`, `axisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tooltipTemplate: TemplateRef<{
1049
+ $implicit: ChartTooltipContext;
1050
+ }> | null = null`, `tooltipExtraGap: number = 0`
1042
1051
  <!-- /inputs -->
1043
1052
 
1044
1053
  #### `<g[dsColumnSeries]>` — `ColumnSeriesComponent`
1045
1054
 
1046
1055
  <!-- inputs:g[dsColumnSeries] -->
1047
- All inputs: `data: readonly ColumnSeriesPoint[] = []`, `showValues: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `staggerMs: number = 0`, `partOfWhole: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `tooltipAnchor: 'mark' | 'cell' = 'mark'`, `tooltipLingerMs: number = 0`, `valueFormat: ChartValueFormat`, `columnWidthRatio: number = 0.8`, `slot: number = 0`, `slotCount: number = 1`, `offsets: readonly ChartStackOffset[] | null = null`, `seriesColor: string | null = null`, `seriesFill: 'solid' | 'hatched' = null`, `seriesLabel: string | null = null`
1056
+ All inputs: `data: readonly ColumnSeriesPoint[] = []`, `showValues: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `staggerMs: number = 0`, `partOfWhole: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `tooltipAnchor: 'mark' | 'cell' = 'mark'`, `tooltipLingerMs: number = 0`, `valueFormat: ChartValueFormat`, `columnWidthRatio: number = 0.8`, `slot: number = 0`, `slotCount: number = 1`, `offsets: readonly ChartStackOffset[] | null = null`, `seriesColor: string | null = null`, `seriesFill: 'solid' | 'hatched' = null`, `seriesLabel: string | null = null`, `seriesKey: string | null = null`, `highlighted: string | null = null`
1048
1057
  <!-- /inputs -->
1049
1058
 
1050
1059
  #### `<g[dsLineSeries]>` — `LineSeriesComponent`
1051
1060
 
1052
1061
  <!-- inputs:g[dsLineSeries] -->
1053
- All inputs: `data: readonly LineSeriesData[] = []`, `showMarkers: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `highlighted: string | null = null`, `patterns: readonly string[] = []`, `stacked: boolean = false`, `staggerMs: number = 0`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `tooltip: 'item' | 'axis' | 'none' = 'item'`, `tooltipAnchor: 'reading' | 'pointer' = 'reading'`, `tooltipLingerMs: number = 0`, `valueFormat: ChartValueFormat`
1062
+ All inputs: `data: readonly LineSeriesData[] = []`, `showMarkers: boolean = true`, `outline: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `highlighted: string | null = null`, `patterns: readonly string[] = []`, `stacked: boolean = false`, `staggerMs: number = 0`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `tooltip: 'item' | 'axis' | 'none' = 'item'`, `tooltipAnchor: 'reading' | 'pointer' = 'reading'`, `tooltipLingerMs: number = 0`, `valueFormat: ChartValueFormat`
1054
1063
  <!-- /inputs -->
1055
1064
 
1056
1065
  #### `<g[dsSeriesAnnotation]>` — `SeriesAnnotationComponent`
@@ -1136,7 +1145,7 @@ bootstrapApplication(AppComponent, {
1136
1145
 
1137
1146
  `DsConfig` shape (the exported `DsConfig` type is the full contract):
1138
1147
 
1139
- Twelve sections. The exported `DsConfig` type is the source of truth — each key carries its own
1148
+ Eighteen sections. The exported `DsConfig` type is the source of truth — each key carries its own
1140
1149
  doc comment there, including why it is an app-level decision at all.
1141
1150
 
1142
1151
  ```ts
@@ -1152,6 +1161,7 @@ interface DsConfig {
1152
1161
  };
1153
1162
  };
1154
1163
  control?: { size?: DsSize }; // every control on the field-height contract
1164
+ pagination?: { size?: DsSize; layout?: PaginationLayout }; // every pager, ds-table's footer included
1155
1165
  card?: { elevation?: CardElevation; padding?: CardPadding };
1156
1166
  table?: { stickyScrollbar?: boolean; bordered?: boolean };
1157
1167
  modal?: { dividers?: boolean }; // reaches a ModalService confirm, which has no host to bind
@@ -75,7 +75,7 @@ and token names.** These leaves are for orientation and usage.
75
75
  - [<ds-number-stepper> — NumberStepperComponent](forms/ds-number-stepper.md) — Spinbox for bounded quantities — −/+ buttons around a numeric value.
76
76
  - [<ds-checkbox> — CheckboxComponent](forms/ds-checkbox.md) — <!-- inputs:ds-checkbox -->
77
77
  - [<ds-radio> — RadioComponent](forms/ds-radio.md) — <!-- inputs:ds-radio -->
78
- - [<ds-switch> — SwitchComponent](forms/ds-switch.md) — <!-- inputs:ds-switch -->
78
+ - [<ds-switch> — SwitchComponent](forms/ds-switch.md) — Controlled: <ds-switch controlled [checked]="paused()" (checkedRequested)="askPause($event)" /> - a click canc
79
79
  - [The picker family — <ds-select>, <ds-multi-select>, <ds-autocomplete>](forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md) — Five rules hold across all three: one meaning per member name, difference only where a reason is stated, one p
80
80
  - [<ds-select> — SelectComponent](forms/ds-select.md) — Trigger plus a CDK overlay panel. Keyboard: ArrowUp/Down, Enter/Space, Home/End, Escape, skipping group header
81
81
  - [<ds-multi-select> — MultiSelectComponent](forms/ds-multi-select.md) — <!-- inputs:ds-multi-select -->
@@ -4,5 +4,5 @@
4
4
  Group: Charts
5
5
 
6
6
  <!-- inputs:g[dsColumnSeries] -->
7
- All inputs: `data: readonly ColumnSeriesPoint[] = []`, `showValues: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `staggerMs: number = 0`, `partOfWhole: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `tooltipAnchor: 'mark' | 'cell' = 'mark'`, `tooltipLingerMs: number = 0`, `valueFormat: ChartValueFormat`, `columnWidthRatio: number = 0.8`, `slot: number = 0`, `slotCount: number = 1`, `offsets: readonly ChartStackOffset[] | null = null`, `seriesColor: string | null = null`, `seriesFill: 'solid' | 'hatched' = null`, `seriesLabel: string | null = null`
7
+ All inputs: `data: readonly ColumnSeriesPoint[] = []`, `showValues: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `staggerMs: number = 0`, `partOfWhole: boolean = false`, `tooltip: 'item' | 'none' = 'item'`, `tooltipAnchor: 'mark' | 'cell' = 'mark'`, `tooltipLingerMs: number = 0`, `valueFormat: ChartValueFormat`, `columnWidthRatio: number = 0.8`, `slot: number = 0`, `slotCount: number = 1`, `offsets: readonly ChartStackOffset[] | null = null`, `seriesColor: string | null = null`, `seriesFill: 'solid' | 'hatched' = null`, `seriesLabel: string | null = null`, `seriesKey: string | null = null`, `highlighted: string | null = null`
8
8
  <!-- /inputs -->
@@ -4,5 +4,7 @@
4
4
  Group: Charts
5
5
 
6
6
  <!-- inputs:ds-chart -->
7
- All inputs: `categories: readonly string[] = []`, `tickCount: number = 5`, `min: number | null = null`, `max: number | null = null`, `cursor: 'none' | 'category' = 'none'`, `cursorPin: boolean = false`, `tooltipLingerMs: number | null = null`, `maxSecondary: number | null = null`, `plotHeight: number = 240`, `axisGutter: number = 46`, `valueSpace: number = 20`, `caption: string | null = null`, `interactive: boolean = false`, `summary: string | null = null`, `frame: 'auto' | 'none' = null`, `loading: boolean = false`, `emptyText: string | null = null`, `error: boolean = false`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `secondaryAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `axisColor: string | null = null`, `secondaryAxisColor: string | null = null`, `axisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`
7
+ All inputs: `categories: readonly string[] = []`, `tickCount: number = 5`, `min: number | null = null`, `max: number | null = null`, `cursor: 'none' | 'category' = 'none'`, `cursorPin: boolean = false`, `tooltipLingerMs: number | null = null`, `maxSecondary: number | null = null`, `plotHeight: number = 240`, `axisGutter: number = 46`, `valueSpace: number = 20`, `caption: string | null = null`, `interactive: boolean = false`, `summary: string | null = null`, `frame: 'auto' | 'none' = null`, `loading: boolean = false`, `emptyText: string | null = null`, `error: boolean = false`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `secondaryAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `axisColor: string | null = null`, `secondaryAxisColor: string | null = null`, `axisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tooltipTemplate: TemplateRef<{
8
+ $implicit: ChartTooltipContext;
9
+ }> | null = null`, `tooltipExtraGap: number = 0`
8
10
  <!-- /inputs -->
@@ -16,5 +16,5 @@ Colour: series ARE different things, so the categorical palette applies — `--d
16
16
  Tokens: `--ds-line-chart-plot-height`, `--ds-line-chart-line-width`, `--ds-line-chart-dot-radius`, `--ds-line-chart-area-opacity`, `--ds-line-chart-swatch-size`, `--ds-line-chart-grid-line-color`, `--ds-line-chart-axis-line-color`, `--ds-line-chart-axis-label-color`, `--ds-line-chart-axis-font-size`, `--ds-line-chart-annotation-color`, `--ds-line-chart-annotation-font-size`, `--ds-line-chart-annotation-font-weight`, `--ds-line-chart-annotation-halo-color`, `--ds-line-chart-annotation-halo-width`.
17
17
 
18
18
  <!-- inputs:ds-line-chart -->
19
- All inputs: `categories: required readonly string[]`, `series: required readonly LineChartSeries[]`, `yAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `showMarkers: boolean = true`, `annotations: readonly LineChartAnnotation[] = []`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `stack: 'none' | 'stacked' | 'normalized' = 'none'`, `yAxisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tickCount: number = 5`, `frame: 'auto' | 'none' = null`, `tooltipLingerMs: number | null = null`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `max: number | null = null`, `maxSecondary: number | null = null`, `loading: boolean = false`, `emptyText: string | null = null`, `error: boolean = false`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `hiddenSeries: readonly string[] = []`, `rescaleOnHide: boolean = false`, `legendFilters: boolean = false`, `legendMode: 'toggle' | 'isolate' = 'isolate'`, `noVisibleSeriesText: string = 'All series are hidden'`, `patterns: boolean = false`, `staggerMs: number = 0`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `tooltipAnchor: 'point' | 'pointer' = 'point'`
19
+ All inputs: `categories: required readonly string[]`, `series: required readonly LineChartSeries[]`, `yAxisMode: 'aligned' | 'exact' | 'dual-grid' | 'split' = 'aligned'`, `showMarkers: boolean = true`, `outline: boolean = true`, `annotations: readonly LineChartAnnotation[] = []`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `stack: 'none' | 'stacked' | 'normalized' = 'none'`, `yAxisLabel: string | null = null`, `secondaryAxisLabel: string | null = null`, `tickCount: number = 5`, `frame: 'auto' | 'none' = null`, `tooltipLingerMs: number | null = null`, `caption: string | null = null`, `summary: string | null = null`, `dataTable: 'toggle' | 'visible' | 'none' = null`, `max: number | null = null`, `maxSecondary: number | null = null`, `loading: boolean = false`, `emptyText: string | null = null`, `error: boolean = false`, `errorText: string | null = null`, `valueFormat: ChartValueFormat | null = null`, `hiddenSeries: readonly string[] = []`, `rescaleOnHide: boolean = false`, `legendFilters: boolean = false`, `legendMode: 'toggle' | 'isolate' = 'isolate'`, `noVisibleSeriesText: string = 'All series are hidden'`, `patterns: boolean = false`, `staggerMs: number = 0`, `tooltip: 'item' | 'axis' | 'none' = 'axis'`, `tooltipAnchor: 'point' | 'pointer' = 'point'`
20
20
  <!-- /inputs -->
@@ -4,5 +4,5 @@
4
4
  Group: Charts
5
5
 
6
6
  <!-- inputs:g[dsLineSeries] -->
7
- All inputs: `data: readonly LineSeriesData[] = []`, `showMarkers: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `highlighted: string | null = null`, `patterns: readonly string[] = []`, `stacked: boolean = false`, `staggerMs: number = 0`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `tooltip: 'item' | 'axis' | 'none' = 'item'`, `tooltipAnchor: 'reading' | 'pointer' = 'reading'`, `tooltipLingerMs: number = 0`, `valueFormat: ChartValueFormat`
7
+ All inputs: `data: readonly LineSeriesData[] = []`, `showMarkers: boolean = true`, `outline: boolean = true`, `interactive: boolean = false`, `pinOnClick: boolean = false`, `dimOthers: boolean = false`, `highlighted: string | null = null`, `patterns: readonly string[] = []`, `stacked: boolean = false`, `staggerMs: number = 0`, `gaps: 'break' | 'zero' = 'break'`, `curve: 'linear' | 'step' | 'smooth' = 'linear'`, `tooltip: 'item' | 'axis' | 'none' = 'item'`, `tooltipAnchor: 'reading' | 'pointer' = 'reading'`, `tooltipLingerMs: number = 0`, `valueFormat: ChartValueFormat`
8
8
  <!-- /inputs -->
@@ -6,7 +6,7 @@ Group: Form & input
6
6
  Pre-styled search input with built-in icon. A form control, but not a field: no label, no message row.
7
7
  Inputs: `value: model<string>`, `placeholder: string = 'Search'`, `shortcut: string = ''` (rendered as a hint pill, e.g. `⌘K`), `showIcon: boolean = true`, `clearable: boolean = false`, `ariaLabel: string = ''`, `disabled: boolean = false`, `hidden: boolean = false`, `size: DsSize | null = null`, `debounce: number = 0` (ms held before `value` updates; clearing, Enter and `clear()` all skip the timer)
8
8
  Output: `(submitted): string` — emits the current value on Enter / form submit
9
- Methods: `clear()` — empties the field, drops an armed keystroke and publishes `''` at once, which writing `''` into `value` does not; `focus()`.
9
+ Methods: `clear()` — empties the field, drops an armed keystroke and publishes `''` at once, which writing `''` into `value` does not; `focus()`, `blur()`.
10
10
  Binds through `NG_VALUE_ACCESSOR`, taking the value plumbing without the field-message layer — so `hint` / `error` / `warning` / `errors` / `invalid` / `touched` / `reserveMessage` / `messageIcon` are NOT inputs here.
11
11
 
12
12
  <!-- inputs:ds-search -->
@@ -3,8 +3,10 @@
3
3
 
4
4
  Group: Form & input
5
5
 
6
- Inputs: `checked: model<boolean>`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`
6
+ Inputs: `checked: model<boolean>`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`, `controlled: boolean = false`
7
+ Outputs: `(checkedRequested): boolean` - only when `controlled`: the value the user asked for; the switch waits for `[checked]` to change.
8
+ Controlled: `<ds-switch controlled [checked]="paused()" (checkedRequested)="askPause($event)" />` - a click cancels the native toggle instead of flipping, so a confirm dialog can run first and a cancelled one leaves the track untouched. Off by default; the switch flips on every toggle as before.
7
9
 
8
10
  <!-- inputs:ds-switch -->
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`, `checked: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`
11
+ 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`, `checked: boolean = false`, `disabled: boolean = false`, `name: string | null = null`, `variant: 'default' | 'success' | 'error' = 'default'`, `inputId: string | null = null`, `size: 'sm' | 'md' | 'lg' = null`, `required: boolean = false`, `label: string = ''`, `ariaLabel: string | null = null`, `controlled: boolean = false`
10
12
  <!-- /inputs -->
@@ -7,6 +7,7 @@ Multi-line counterpart to `<ds-input>` — same wrapper/states, reuses the `--ds
7
7
  Inputs: `value: model<string>`, `size: 'sm' | 'md' | 'lg' = 'md'`, `label`, `hint`, `placeholder`, `disabled`, `invalid`, `required`, `optional: boolean = false`, `name`, `rows: number = 3`
8
8
  Tokens: same `--ds-input-*` family as `<ds-input>` (textarea overrides `--ds-input-padding-y` to `--space-3` for vertical breathing room).
9
9
  New: `autosize: boolean = false` (grows with content; forces `resize='none'`), `minRows`/`maxRows: number | null = null`, `resize: 'none' | 'vertical' | 'horizontal' | 'both' = 'vertical'`.
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`.
10
11
 
11
12
  <!-- inputs:ds-textarea -->
12
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`, `minLength: number | null = null`, `pattern: readonly RegExp[] = []`
@@ -3,9 +3,9 @@
3
3
 
4
4
  Group: Layout & navigation
5
5
 
6
- Inputs: `total: required number`, `pageSize: model<number> = 10`, `currentPage: model<number> = 1`, `pageSizeOptions: number[] = [10, 25, 50, 100]`, `showLabel: boolean = true`, `size: DsSize | null = null` (unset resolves `DS_CONFIG.control.size`, then `sm`), `layout: PaginationLayout = 'grouped'` (`'grouped' | 'spread'`; `'spread'` gives the nav full width and pushes the label and the controls to opposite edges)
6
+ Inputs: `total: required number`, `pageSize: model<number> = 10`, `currentPage: model<number> = 1`, `pageSizeOptions: number[] = [10, 25, 50, 100]`, `showLabel: boolean = true`, `size: DsSize | null = null` (unset resolves `DS_CONFIG.pagination.size`, then `DS_CONFIG.control.size`, then `sm`), `layout: PaginationLayout | null = null` (`'grouped' | 'spread'`; unset resolves `DS_CONFIG.pagination.layout`, then `'grouped'`; `'spread'` gives the nav full width and pushes the label and the controls to opposite edges), `loading: boolean = false` (every control disables, the range label is masked with a `ds-skeleton` so a stale `total` is never quoted, and the nav reports `aria-busy`). Inside `ds-table` `size` and `layout` arrive as `paginationSize` / `paginationLayout`, and `loading` is set from `loading="skeleton"`.
7
7
  Outputs: `(currentPageChange): number`, `(pageSizeChange): number`
8
8
 
9
9
  <!-- inputs:ds-pagination -->
10
- All inputs: `total: required number`, `pageSize: number = 10`, `currentPage: number = 1`, `pageSizeOptions: number[]`, `showLabel: boolean = true`, `showPageSize: boolean = true`, `size: 'sm' | 'md' | 'lg' = null`, `layout: 'grouped' | 'spread' = 'grouped'`
10
+ All inputs: `total: required number`, `pageSize: number = 10`, `currentPage: number = 1`, `pageSizeOptions: number[]`, `showLabel: boolean = true`, `showPageSize: boolean = true`, `size: 'sm' | 'md' | 'lg' = null`, `layout: 'grouped' | 'spread' = null`, `loading: boolean = false`
11
11
  <!-- /inputs -->
@@ -19,7 +19,7 @@ bootstrapApplication(AppComponent, {
19
19
 
20
20
  `DsConfig` shape (the exported `DsConfig` type is the full contract):
21
21
 
22
- Twelve sections. The exported `DsConfig` type is the source of truth — each key carries its own
22
+ Eighteen sections. The exported `DsConfig` type is the source of truth — each key carries its own
23
23
  doc comment there, including why it is an app-level decision at all.
24
24
 
25
25
  ```ts
@@ -35,6 +35,7 @@ interface DsConfig {
35
35
  };
36
36
  };
37
37
  control?: { size?: DsSize }; // every control on the field-height contract
38
+ pagination?: { size?: DsSize; layout?: PaginationLayout }; // every pager, ds-table's footer included
38
39
  card?: { elevation?: CardElevation; padding?: CardPadding };
39
40
  table?: { stickyScrollbar?: boolean; bordered?: boolean };
40
41
  modal?: { dividers?: boolean }; // reaches a ModalService confirm, which has no host to bind
@@ -4,5 +4,5 @@
4
4
  Group: Tables
5
5
 
6
6
  <!-- inputs:[dsCellTemplate] -->
7
- All inputs: `dsCellTemplate: required string`
7
+ All inputs: `dsCellTemplate: required string`, `dsCellTemplateOf: readonly T[] | null = null`
8
8
  <!-- /inputs -->
@@ -7,13 +7,14 @@ Inputs: `data: required readonly T[]`, `columns: required readonly TableColumn<T
7
7
  Outputs: `(rowClicked): T`, `(sortChange): SortChangeEvent` (`{ key, dir }`)
8
8
  Column shape: `{ key: string, label: string, sortable?: boolean, align?: 'left' | 'right' | 'center', cell?: (row: T) => string }`
9
9
  Opening a row: give one column `link: (row) => <route target> | null` and its value renders as a real `<a>` — visible without hovering, in the tab order as a link, and Ctrl/Cmd-clickable, none of which a clickable `<tr>` can do. `null` for a row leaves that cell as plain text, so a partly-reachable list stays one column; external URLs go through a `[dsCellTemplate]` instead, since `link` takes Angular route targets only. It composes with `rowInteractive` (the link stops its click from reaching the row), but the two together cost **two tab stops per row** — on a long list prefer the link alone. `interactive: true` only tints a cell on row hover, which a keyboard or touch user never sees; prefer `link` wherever the row actually leads somewhere.
10
- Cell templates: `<ng-template dsCellTemplate="<colKey>" let-row>…</ng-template>` — `row` is typed `unknown`, narrow via a helper method on the host.
10
+ Cell templates: `<ng-template dsCellTemplate="<colKey>" [dsCellTemplateOf]="rows" let-row>…</ng-template>` — bound to the same rows as `[data]`, `dsCellTemplateOf` types `row` as `T` under strict templates (a field typo is a compile error) and is never read at runtime. Without it `row` is `unknown`; narrow via a helper method on the host. `CellTemplateContext<T>` (`$implicit` and `row`) is exported.
11
11
  Content slots: `[empty]` (rendered when `data.length === 0`), `[bulk-actions]` (rendered in the bulk action bar when `selectable && some selected`)
12
- Loading modes: `'skeleton'` replaces rows with shimmer placeholders driven by the global `--skeleton-shimmer-x` keyframe; `'overlay'` keeps existing rows visible behind a translucent layer with a centred spinner.
12
+ Loading modes: `'skeleton'` replaces rows with shimmer placeholders driven by the global `--skeleton-shimmer-x` keyframe; `'overlay'` keeps existing rows visible behind a translucent layer with a centred spinner; under `'skeleton'` the footer pager takes `loading` as well - its controls disable and its range label is masked, so it never quotes the previous query's count. `'overlay'` leaves the pager live, like the header.
13
+ Footer pager: `pageSizeOptions`, `showPageSize`, `showLabel`, `paginationSize: DsSize | null = null` and `paginationLayout: PaginationLayout | null = null` are the embedded `ds-pagination`'s own inputs forwarded one-to-one; the last two unset resolve `DS_CONFIG.pagination.size` (then `DS_CONFIG.control.size`, then `sm`) and `DS_CONFIG.pagination.layout` (then `'grouped'`), so an app whose every pager wants `md` / `spread` says it once in the config.
13
14
  Tokens: `--ds-table-border: var(--border-default)`, `--ds-table-radius: var(--radius-md)`, `--ds-table-bg-color`, `--ds-table-head-text-color: var(--text-secondary)`, `--ds-table-head-bg-color: var(--surface-secondary)`, `--ds-table-head-font-size: var(--font-size-xs)`, `--ds-table-row-hover-bg-color`, `--ds-table-row-selected-bg-color`, `--ds-table-divider`, `--ds-table-sort-active-icon-color`, `--ds-table-cell-padding-x/y`. (Renamed 2026-06: `--ds-table-header-*` → `--ds-table-head-*`, matching the tokens reference.)
14
15
 
15
16
  <!-- inputs:ds-table -->
16
- All inputs: `data: required readonly T[]`, `rowId: ((row: T) => string) | null = null`, `columns: required readonly TableColumn<T>[]`, `selectable: boolean = false`, `bordered: boolean | null = null`, `loading: boolean | 'skeleton' | 'overlay' = false`, `stickyHeader: boolean = true`, `maxHeight: string | null = null`, `density: 'default' | 'compact' = 'default'`, `zebra: boolean = false`, `animateHeight: boolean = false`, `selectedIds: Set<string>`, `sortKey: string | null = null`, `sortDirection: 'asc' | 'desc' = null`, `sortingOrder: SortDirection[]`, `sortAnnouncement: (label: string, dir: SortDirection) => string`, `rangeAnnouncement: (first: number, last: number, total: number) => string`, `skeletonRows: number = 5`, `caption: string = ''`, `rowInteractive: boolean = false`, `activeRowId: string | null = null`, `filterQuery: string = ''`, `columnFilters: Map<string, ReadonlySet<string>>`, `persistLayout: boolean = false`, `storageKey: string = ''`, `stickyScrollbar: boolean | null = null`, `pageSize: number | null = null`, `page: number = 1`, `pageSizeOptions: number[]`, `showPageSize: boolean = true`, `showLabel: boolean = true`, `total: number | null = null`, `scrollToTopOnPageChange: boolean = false`, `sortMode: 'client' | 'server' | 'none' = null`, `filterMode: 'client' | 'server' | 'none' = null`, `columnFilterOptions: ReadonlyMap<string, readonly string[]>`, `stickyScrollbarOffset: string | null = null`, `stickyFirstColumn: boolean = false`, `virtualScroll: boolean = false`, `virtualRowSize: number = 44`, `lazy: boolean = false`, `rowActions: readonly TableRowAction<T>[] = []`, `cellTemplateMap: Record<string, TemplateRef<{ $implicit: unknown; row: unknown }>> = {}`, `emptyTemplate: TemplateRef<unknown> | null = null`, `expandableRows: boolean = false`, `expandedIds: Set<string>`, `expandMode: 'multiple' | 'single' = 'multiple'`, `expandAllToggle: boolean = false`, `rowExpandTemplate: TemplateRef<{
17
+ All inputs: `data: required readonly T[]`, `rowId: ((row: T) => string) | null = null`, `columns: required readonly TableColumn<T>[]`, `selectable: boolean = false`, `bordered: boolean | null = null`, `loading: boolean | 'skeleton' | 'overlay' = false`, `stickyHeader: boolean = true`, `maxHeight: string | null = null`, `density: 'default' | 'compact' = 'default'`, `zebra: boolean = false`, `animateHeight: boolean = false`, `selectedIds: Set<string>`, `sortKey: string | null = null`, `sortDirection: 'asc' | 'desc' = null`, `sortingOrder: SortDirection[]`, `sortAnnouncement: (label: string, dir: SortDirection) => string`, `rangeAnnouncement: (first: number, last: number, total: number) => string`, `skeletonRows: number = 5`, `caption: string = ''`, `rowInteractive: boolean = false`, `activeRowId: string | null = null`, `filterQuery: string = ''`, `columnFilters: Map<string, ReadonlySet<string>>`, `persistLayout: boolean = false`, `storageKey: string = ''`, `stickyScrollbar: boolean | null = null`, `pageSize: number | null = null`, `page: number = 1`, `pageSizeOptions: number[]`, `showPageSize: boolean = true`, `showLabel: boolean = true`, `paginationSize: 'sm' | 'md' | 'lg' = null`, `paginationLayout: 'grouped' | 'spread' = null`, `total: number | null = null`, `scrollToTopOnPageChange: boolean = false`, `sortMode: 'client' | 'server' | 'none' = null`, `filterMode: 'client' | 'server' | 'none' = null`, `columnFilterOptions: ReadonlyMap<string, readonly string[]>`, `stickyScrollbarOffset: string | null = null`, `stickyFirstColumn: boolean = false`, `virtualScroll: boolean = false`, `virtualRowSize: number = 44`, `lazy: boolean = false`, `rowActions: readonly TableRowAction<T>[] = []`, `cellTemplateMap: Record<string, TemplateRef<{ $implicit: unknown; row: unknown }>> = {}`, `emptyTemplate: TemplateRef<unknown> | null = null`, `expandableRows: boolean = false`, `expandedIds: Set<string>`, `expandMode: 'multiple' | 'single' = 'multiple'`, `expandAllToggle: boolean = false`, `rowExpandTemplate: TemplateRef<{
17
18
  $implicit: unknown;
18
19
  row: unknown;
19
20
  }> | null = null`