@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
@@ -0,0 +1,591 @@
1
+ {
2
+ "version": "0.14.0",
3
+ "items": [
4
+ {
5
+ "id": "chart-container-owns-the-tooltip",
6
+ "kind": "behavior",
7
+ "old": "dsChartTooltip",
8
+ "new": null,
9
+ "surface": "template",
10
+ "action": "Remove [dsChartTooltip], [dsChartTooltipOrigin], [dsChartTooltipPreferBelow], [dsChartTooltipTemplate] and [dsChartTooltipExtraGap] from every g[dsColumnSeries] and g[dsLineSeries] inside a ds-chart. Move a custom panel body to [tooltipTemplate] on ds-chart, and a value-label gap to [tooltipExtraGap] there.",
11
+ "appliesWhen": "Only marks projected into ds-chart. The presets ds-column-chart, ds-line-chart, ds-bar-chart, ds-pie-chart and ds-funnel-chart wire themselves and need no edit. A consumer who never composed ds-chart by hand is unaffected.",
12
+ "pitfall": "Leaving the bindings in place opens TWO panels over one plot: the mark's own and the container's. Nothing errors, and the second panel is easy to read as a redraw.",
13
+ "restore": null,
14
+ "searchHints": [
15
+ "dsChartTooltip",
16
+ "dsChartTooltipOrigin",
17
+ "dsChartTooltipTemplate",
18
+ "dsChartTooltipPreferBelow",
19
+ "dsChartTooltipExtraGap",
20
+ "dsColumnSeries",
21
+ "dsLineSeries"
22
+ ],
23
+ "verify": "No g[dsColumnSeries] or g[dsLineSeries] in your templates carries a dsChartTooltip binding, and hovering a mark inside ds-chart opens exactly one ds-chart-tooltip-panel.",
24
+ "note": "A mark reported its context and the consumer had to bind the directive, so a plot with two marks could open two panels and a plot whose consumer forgot the binding opened none. Marks now offer the container a tooltip source the way they already report a domain, and the container draws the single panel."
25
+ },
26
+ {
27
+ "id": "chart-tooltip-pane-inert-unless-pinned",
28
+ "kind": "behavior",
29
+ "old": ".ds-chart-tooltip-pane",
30
+ "new": null,
31
+ "surface": "style",
32
+ "action": "If you style or hit-test .cdk-overlay-pane.ds-chart-tooltip-pane, scope the interactive half to .is-pinned. Ships in styles/overlay-motion, which styles/ds forwards.",
33
+ "appliesWhen": "Only an app with its own rule on the chart tooltip pane, or one that relied on the pane catching the pointer. The panel's content, position and dismissal are unchanged.",
34
+ "pitfall": "Text selection inside an unpinned panel no longer works, because the pane does not take the pointer. A pinned panel still does, and that is the supported way to reach the text.",
35
+ "restore": ".cdk-overlay-pane.ds-chart-tooltip-pane { pointer-events: auto; }",
36
+ "searchHints": [
37
+ "ds-chart-tooltip-pane",
38
+ "cdk-overlay-pane",
39
+ "pointer-events"
40
+ ],
41
+ "detect": [
42
+ ".ds-chart-tooltip-pane",
43
+ "ds-chart-tooltip-panel",
44
+ "pointer-events: auto"
45
+ ],
46
+ "verify": "In the BUILT css, .cdk-overlay-pane.ds-chart-tooltip-pane resolves to pointer-events: none and .cdk-overlay-pane.ds-chart-tooltip-pane.is-pinned to auto.",
47
+ "note": "The pane is drawn over the plot it describes, so on a funnel or a tight category axis it covered the neighbouring marks and the mark underneath never saw the pointer - the panel named a segment the reader had already left. WCAG 1.4.13 still holds: moving onto the panel does not dismiss it, Escape does, and a pinned pane takes the pointer again."
48
+ },
49
+ {
50
+ "id": "chart-scales-reports-tooltips",
51
+ "kind": "behavior",
52
+ "old": "ChartScales",
53
+ "new": null,
54
+ "surface": "typescript",
55
+ "action": "If a class of yours implements `ChartScales`, add `reportTooltip(id, source)` and `releaseTooltip(id)` to it. A container that draws no tooltip can implement both as no-ops.",
56
+ "appliesWhen": "Only TypeScript that implements the exported `ChartScales` interface - a hand-written chart container providing `CHART_SCALES` in place of `ds-chart`. Code that injects `CHART_SCALES` to read positions from a mark of its own, and every template, is unaffected.",
57
+ "pitfall": "The parameter type of `reportTooltip` is not exported, so type `source` through `Parameters<ChartScales['reportTooltip']>[1]` rather than redeclaring its shape.",
58
+ "restore": null,
59
+ "searchHints": [
60
+ "ChartScales",
61
+ "CHART_SCALES"
62
+ ],
63
+ "detect": [
64
+ "implements ChartScales",
65
+ "ChartScales {",
66
+ "provide: CHART_SCALES",
67
+ "useExisting"
68
+ ],
69
+ "verify": "Every class implementing `ChartScales` declares `reportTooltip` and `releaseTooltip`, and the app builds with no TS2420 against `ChartScales`.",
70
+ "note": "`ChartScales` gains two required methods, the tooltip counterpart of `reportDomain` / `releaseDomain`: a mark hands the container what its tooltip shows, and the container opens the one panel. The optional `measured` signal added beside them may be left out."
71
+ },
72
+ {
73
+ "id": "chart-mark-enter-class-removed",
74
+ "kind": "behavior",
75
+ "old": ".mark-enter",
76
+ "new": null,
77
+ "surface": "style",
78
+ "action": "Retarget a rule of yours on `.mark-enter` to the mark element itself (the column, bar, point, marker, arc or band the chart draws).",
79
+ "appliesWhen": "Only a stylesheet that selects `.mark-enter` inside a DS chart. The entrance plays exactly as before on first render and for marks a data change adds; `.mark-leave` and the keyframes `ds-chart-mark-grow-y`, `ds-chart-mark-grow-x`, `ds-chart-mark-fade-in` and `ds-chart-mark-exit` keep their names.",
80
+ "pitfall": "A rule on `.mark-enter` matches nothing and reports nothing, so a restyled entrance quietly reverts to the default one.",
81
+ "restore": null,
82
+ "searchHints": [
83
+ "mark-enter"
84
+ ],
85
+ "detect": [
86
+ ".mark-enter"
87
+ ],
88
+ "verify": "No stylesheet selects `.mark-enter`, and a restyled mark entrance still plays when the chart first renders.",
89
+ "note": "The entrance is a CSS animation declared on the mark, so no class is added for it any more."
90
+ },
91
+ {
92
+ "id": "line-series-outline-on-by-default",
93
+ "kind": "behavior",
94
+ "old": "dsLineSeries",
95
+ "new": null,
96
+ "surface": "template",
97
+ "action": "Look at a line chart. The line and its markers now sit on a band of the surface colour; set [outline]=\"false\" on the series or on the ds-line-chart to take it off.",
98
+ "appliesWhen": "Every dsLineSeries, and so ds-line-chart too. Column, bar, pie, funnel, scatter, heatmap and waterfall are unaffected.",
99
+ "pitfall": "The band is the surface colour, so where the line crosses gridlines it erases a few pixels of them. That is the point where the line crosses columns and unwanted where the line is alone.",
100
+ "restore": "[outline]=\"false\" on the g[dsLineSeries], or on the ds-line-chart.",
101
+ "searchHints": [
102
+ "dsLineSeries",
103
+ "ds-line-chart",
104
+ "series-line"
105
+ ],
106
+ "verify": "A rendered line series carries one path.series-halo per line path, stroked in the surface colour.",
107
+ "note": "A line drawn over other marks was hard to follow where it crossed them. The band is wider than the line and the markers take the same stroke behind their fill, so the series reads as one thing over a busy plot."
108
+ },
109
+ {
110
+ "id": "line-series-highlighted-fades-without-dim-others",
111
+ "kind": "behavior",
112
+ "old": "dsLineSeries[highlighted]",
113
+ "new": null,
114
+ "surface": "template",
115
+ "action": "None, unless you bind [highlighted] on a g[dsLineSeries] without dimOthers and want only the named line thickened: the other lines now fade as well, and no input brings back the thicken-only look.",
116
+ "appliesWhen": "Only a g[dsLineSeries] with a [highlighted] binding and no dimOthers. With dimOthers set nothing changes, and ds-line-chart's legend already faded the others.",
117
+ "pitfall": "The fade reads as the chart being disabled or loading when the app meant a quiet emphasis, and nothing reports it.",
118
+ "restore": null,
119
+ "searchHints": [
120
+ "highlighted",
121
+ "dsLineSeries",
122
+ "dimOthers"
123
+ ],
124
+ "verify": "A g[dsLineSeries] with [highlighted] set to one series id and no dimOthers draws that line bold and the other lines at --ds-chart-dim-opacity.",
125
+ "note": "highlighted used to fade the other lines only alongside dimOthers. It now fades them on its own, because naming a series is the reader asking for that one; dimOthers governs only the fade a pointer over a marker starts."
126
+ },
127
+ {
128
+ "id": "chart-axis-panel-names-every-series",
129
+ "kind": "behavior",
130
+ "old": "tooltip=\"axis\"",
131
+ "new": null,
132
+ "surface": "none",
133
+ "action": "None. A category panel now lists every series at that category rather than only the one that opened it.",
134
+ "appliesWhen": "Only a ds-chart with cursor=\"category\" holding more than one mark. A per-mark tooltip is unchanged.",
135
+ "pitfall": "A panel that named one series now names several, so a custom tooltipTemplate that assumed a single entry renders more rows than it did.",
136
+ "restore": null,
137
+ "searchHints": [
138
+ "tooltip=\"axis\"",
139
+ "cursor=\"category\"",
140
+ "tooltipTemplate"
141
+ ],
142
+ "verify": "With cursor=\"category\" over a plot holding a column series and a line series, the panel lists both.",
143
+ "note": "The behaviour was already documented and the code listed only the series whose mark opened the panel, because a mark could not see the others. Marks now offer the container what they read at the cursor's category and the container merges them, matching by label so a series is never listed twice."
144
+ },
145
+ {
146
+ "id": "exported-class-members-grew",
147
+ "kind": "behavior",
148
+ "old": "extends ChartComponent",
149
+ "new": null,
150
+ "surface": "typescript",
151
+ "action": "Only if you SUBCLASS one of these: rename a member of yours that collides with a new one, or add `override` where it genuinely means the same thing, and delete an override whose base member is gone.",
152
+ "appliesWhen": "Only a class extending one of the listed components. Using them in a template is unaffected, and so is a consumer who composes rather than subclasses.",
153
+ "pitfall": "A new name colliding is a compile error - TS4114, or TS2416 where the signature differs. A method of yours named like a REMOVED member and declared without `override` still compiles, and is simply never called again.",
154
+ "restore": null,
155
+ "searchHints": [
156
+ "extends ChartComponent",
157
+ "extends ColumnSeriesComponent",
158
+ "extends LineSeriesComponent",
159
+ "extends ColumnChartComponent",
160
+ "extends ChartTooltipDirective",
161
+ "extends ScatterChartComponent",
162
+ "extends ChartDataTableComponent",
163
+ "extends BarChartComponent",
164
+ "extends FunnelChartComponent",
165
+ "extends PieChartComponent",
166
+ "extends PaginationComponent",
167
+ "extends TableComponent",
168
+ "extends ModalCardComponent",
169
+ "extends DsControlValueAccessor",
170
+ "extends DsBooleanControlValueAccessor",
171
+ "extends SearchComponent",
172
+ "extends TextareaComponent",
173
+ "extends CellTemplateDirective",
174
+ "extends SwitchComponent",
175
+ "extends LineChartComponent",
176
+ "extends "
177
+ ],
178
+ "detect": [
179
+ "extends ChartComponent",
180
+ "ChartComponent",
181
+ "extends ColumnSeriesComponent",
182
+ "ColumnSeriesComponent",
183
+ "extends LineSeriesComponent",
184
+ "LineSeriesComponent",
185
+ "extends ColumnChartComponent",
186
+ "ColumnChartComponent",
187
+ "extends ChartTooltipDirective",
188
+ "ChartTooltipDirective",
189
+ "extends ScatterChartComponent",
190
+ "ScatterChartComponent",
191
+ "extends ChartDataTableComponent",
192
+ "ChartDataTableComponent",
193
+ "extends BarChartComponent",
194
+ "BarChartComponent",
195
+ "extends FunnelChartComponent",
196
+ "FunnelChartComponent",
197
+ "extends PieChartComponent",
198
+ "PieChartComponent",
199
+ "extends PaginationComponent",
200
+ "PaginationComponent",
201
+ "extends TableComponent",
202
+ "TableComponent",
203
+ "extends ModalCardComponent",
204
+ "ModalCardComponent",
205
+ "extends DsControlValueAccessor",
206
+ "DsControlValueAccessor",
207
+ "extends DsBooleanControlValueAccessor",
208
+ "DsBooleanControlValueAccessor",
209
+ "extends SearchComponent",
210
+ "SearchComponent",
211
+ "extends AutocompleteComponent",
212
+ "AutocompleteComponent",
213
+ "extends CheckboxComponent",
214
+ "CheckboxComponent",
215
+ "extends ColorPickerComponent",
216
+ "ColorPickerComponent",
217
+ "extends DatePickerComponent",
218
+ "DatePickerComponent",
219
+ "extends InputComponent",
220
+ "InputComponent",
221
+ "extends MultiSelectComponent",
222
+ "MultiSelectComponent",
223
+ "extends OtpInputComponent",
224
+ "OtpInputComponent",
225
+ "extends RadioGroupComponent",
226
+ "RadioGroupComponent",
227
+ "extends SegmentedComponent",
228
+ "SegmentedComponent",
229
+ "extends SelectComponent",
230
+ "SelectComponent",
231
+ "extends SliderComponent",
232
+ "SliderComponent",
233
+ "extends SwitchComponent",
234
+ "SwitchComponent",
235
+ "extends TextareaComponent",
236
+ "TextareaComponent",
237
+ "extends TimePickerComponent",
238
+ "TimePickerComponent",
239
+ "extends CellTemplateDirective",
240
+ "CellTemplateDirective",
241
+ "extends LineChartComponent",
242
+ "LineChartComponent"
243
+ ],
244
+ "verify": "Your build has no TS4114 or TS2416 against any of the listed classes, and no member of your subclass is named like one of the removed members listed in the note.",
245
+ "note": "Gained: ChartComponent 20 members (mostly the tooltip API, plus measured), ColumnSeriesComponent 14, LineSeriesComponent 9, ScatterChartComponent 4, ChartDataTableComponent 3, BarChartComponent/FunnelChartComponent 2 each, PieChartComponent roving, ColumnChartComponent highlightedSeries, PaginationComponent layoutResolved/loading, TableComponent paginationSize/paginationLayout, ModalCardComponent stackOverflowingActions, ChartTooltipDirective dsChartTooltipPinned (internal, via components/chart-tooltip), DsControlValueAccessor/DsBooleanControlValueAccessor blur (internal, via components; inherited by every field control, so a subclass declaring its own collides), SearchComponent blur, TextareaComponent selectionStart/selectionEnd/setSelectionRange/select, CellTemplateDirective dsCellTemplateOf and a static ngTemplateContextGuard (now generic, defaulting to unknown), SwitchComponent controlled/checkedRequested/onClick, LineChartComponent outline. Removed: rovingIndex/tabStopIndex (bar/pie/funnel/column series), onMarkEnter/onMarkNavigation/onPointKey (column series), onMarkerEnter/onMarkerNavigation (line series), onPlotPointer/clearCursor (ChartComponent), markIndex (ScatterChartComponent)."
246
+ },
247
+ {
248
+ "id": "table-expand-panel-content-wrapper",
249
+ "kind": "behavior",
250
+ "surface": "style",
251
+ "old": "ds-table .expand-panel-inner",
252
+ "new": null,
253
+ "action": "Re-point a rule that selected your projected template's root as a direct child of `.expand-panel-inner` at `.expand-panel-content`, or drop the child combinator. Delete a rule of yours that forces `display: table-cell` on `.expand-panel-cell` (delete list: expand-panel-cell-display-override).",
254
+ "appliesWhen": "Only a stylesheet of yours that reaches below `.expand-panel-inner` in an expanded `ds-table` row with a child combinator, or that overrode the expand cell's `display`. `.expand-panel-cell > .expand-panel-inner` still matches, a descendant selector matches through the new wrapper, and the template you project is untouched.",
255
+ "pitfall": "The selector stops matching and your rule is silently inert: no build error, and the row still opens with the library's own layout.",
256
+ "note": "The cell carried `display: grid` for the 0fr to 1fr reveal, and a `<td>` whose display is not `table-cell` leaves the table layout, so its `colspan` was ignored and the panel rendered one column wide. The grid and the `ds-table-expand` animation sit on `.expand-panel-inner`, and `.expand-panel-content` is the clipped track item under it.",
257
+ "verify": "An expanded row's `td.expand-panel-cell` is as wide as the row above it, and every rule of yours that styled the expanded row's content appears on an element again.",
258
+ "searchHints": [
259
+ "expand-panel-inner",
260
+ "expand-panel-cell",
261
+ "expand-panel",
262
+ "rowExpandTemplate"
263
+ ],
264
+ "restore": null
265
+ },
266
+ {
267
+ "id": "bar-radius-hook",
268
+ "kind": "code-add",
269
+ "old": null,
270
+ "new": "--ds-bar-radius",
271
+ "surface": "style",
272
+ "action": "None, unless a bar of yours was squared through the radius hook `ds-meter` had before 0.13.3: set `--ds-bar-radius` to that value on the `ds-bar`. A `--ds-bar-radius` declaration you already have is read as it stands.",
273
+ "appliesWhen": "Only a stylesheet that wants a `ds-bar` with corners other than a pill. Every bar without the declaration keeps its pill, and `ds-bar-chart` has its own tokens and is unaffected.",
274
+ "pitfall": "A `--ds-bar-radius` declaration already in a stylesheet, inert on 0.13.3 and 0.13.4, becomes live with this upgrade, so that bar changes shape without an edit of yours.",
275
+ "restore": null,
276
+ "searchHints": [
277
+ "--ds-bar-radius",
278
+ "--ds-meter-radius",
279
+ "ds-bar"
280
+ ],
281
+ "detect": [
282
+ "--ds-bar-radius",
283
+ "--ds-meter-radius"
284
+ ],
285
+ "verify": "A `ds-bar` under `--ds-bar-radius: 2px` renders its track and its fill with a 2px corner radius; without it both are pills.",
286
+ "note": "On 0.13.3 and 0.13.4 `ds-bar` pins the pill on the track and on the fill, with no radius hook. The bar now resolves the radius from `--ds-bar-radius` on both, defaulting to `var(--radius-pill)`, so a squared bar keeps a squared fill."
287
+ },
288
+ {
289
+ "id": "line-chart-placeholder-height-hook",
290
+ "kind": "code-add",
291
+ "old": "--ds-line-chart-plot-height",
292
+ "new": "--ds-line-chart-placeholder-height",
293
+ "surface": "style",
294
+ "action": "If you set `--ds-line-chart-plot-height` to size the loading skeleton or the empty and error boxes rather than the plot, move the value to `--ds-line-chart-placeholder-height` and let the plot take its default.",
295
+ "appliesWhen": "Only a stylesheet that sets `--ds-line-chart-plot-height`. Unset, nothing moves: the skeleton keeps the plot height and the boxes the height the plot would take. A value meant for the plot stays where it is.",
296
+ "pitfall": "Both tokens parse whatever they hold, so a value left on the plot token keeps resizing every plot with no build error and no console line.",
297
+ "restore": null,
298
+ "searchHints": [
299
+ "--ds-line-chart-plot-height",
300
+ "--ds-line-chart-placeholder-height",
301
+ "ds-line-chart"
302
+ ],
303
+ "detect": [
304
+ "--ds-line-chart-plot-height"
305
+ ],
306
+ "verify": "A `ds-line-chart` under `--ds-line-chart-placeholder-height: 120px` shows a 120px skeleton while loading and a 120px empty box with no series, while the plot it draws is the height `--ds-line-chart-plot-height` gives it.",
307
+ "note": "Until 0.13.4 `--ds-line-chart-plot-height` reached the skeleton and the message box alone, and 0.13.4 made it size the plot too, so a value pinned for the placeholder states resized every plot. The placeholder states have their own token now; set, it drives all of them, and the plot reads only the plot token."
308
+ },
309
+ {
310
+ "id": "modal-actions-stacked-direction-hook",
311
+ "kind": "code-add",
312
+ "old": null,
313
+ "new": "--ds-modal-actions-stacked-direction",
314
+ "surface": "style",
315
+ "action": "None, unless the confirming action should visually top a stacked actions row: set `--ds-modal-actions-stacked-direction: column-reverse` on `ds-modal` or `ds-modal-card`.",
316
+ "appliesWhen": "Only a stylesheet that wants the confirming action above the others once `.actions` carries `.stacked`. Unset, the stacked column follows DOM order (cancel-then-confirm), which is also Tab order; a row that still fits stays a right-aligned single line and the token has no effect there.",
317
+ "pitfall": "The token only has an effect once the row has actually stacked, so testing it against a row that still fits shows no change and reads as broken.",
318
+ "restore": null,
319
+ "searchHints": [
320
+ "--ds-modal-actions-stacked-direction",
321
+ "ds-modal-card",
322
+ ".actions.stacked"
323
+ ],
324
+ "detect": [
325
+ "--ds-modal-actions-stacked-direction"
326
+ ],
327
+ "verify": "A stacked `ds-modal-card` actions row with no override puts the DOM's last child (the confirming action) at the bottom; the same row under `--ds-modal-actions-stacked-direction: column-reverse` puts it at the top. Tab order matches the DOM in both.",
328
+ "note": "The stacked column reads its `flex-direction` from this resolver, defaulting to `column`, so DOM order, visual order and Tab order agree without a consumer doing anything. `column-reverse` is the escape hatch for a design that still wants the confirming action on top."
329
+ },
330
+ {
331
+ "id": "input-label-fw-is-input-label-font-weight",
332
+ "kind": "token-rename",
333
+ "old": "--ds-input-label-fw",
334
+ "new": "--ds-input-label-font-weight",
335
+ "surface": "style",
336
+ "action": "Rewrite `--ds-input-label-fw` to `--ds-input-label-font-weight`, keeping the value.",
337
+ "appliesWhen": "Any stylesheet that sets `--ds-input-label-fw`, on `ds-input`, an ancestor or `:root`. `--ds-input-label-font-size` and `--ds-input-label-color` are different tokens on the same element and are untouched; the family-level fallback this token still chains into, `--ds-field-label-font-weight`, keeps its own name.",
338
+ "pitfall": "The old name is inert rather than invalid, so a declaration left behind sets nothing and reports nothing - the label quietly falls back to `--ds-field-label-font-weight` or the default bold, which on most pages still looks close to right.",
339
+ "restore": null,
340
+ "searchHints": [
341
+ "--ds-input-label-fw"
342
+ ],
343
+ "detect": [
344
+ "--ds-input-label-fw([^A-Za-z0-9_-]|$)"
345
+ ],
346
+ "verify": "No stylesheet declares `--ds-input-label-fw`, and the ds-input label's weight still comes from `--ds-input-label-font-weight` (or the `--ds-field-label-font-weight` / `--font-weight-bold` fallback chain).",
347
+ "note": "Every other `--ds-*` weight token is spelled `-font-weight` since 0.13.4, including `--ds-input-label-font-size`'s sibling on the same element; this one now matches them."
348
+ },
349
+ {
350
+ "id": "tag-fw-is-tag-font-weight",
351
+ "kind": "token-rename",
352
+ "old": "--ds-tag-fw",
353
+ "new": "--ds-tag-font-weight",
354
+ "surface": "style",
355
+ "action": "Rewrite `--ds-tag-fw` to `--ds-tag-font-weight`, keeping the value.",
356
+ "appliesWhen": "Any stylesheet that sets `--ds-tag-fw`, on `ds-tag`, an ancestor or `:root`. `--ds-tag-font-size` and `--ds-tag-line-height` are different tokens on the same element, renamed by their own entry in this release.",
357
+ "pitfall": "The old name is inert rather than invalid, so a declaration left behind sets nothing and reports nothing - the tag's label quietly falls back to `--font-weight-bold`.",
358
+ "restore": null,
359
+ "searchHints": [
360
+ "--ds-tag-fw"
361
+ ],
362
+ "detect": [
363
+ "--ds-tag-fw([^A-Za-z0-9_-]|$)"
364
+ ],
365
+ "verify": "No stylesheet declares `--ds-tag-fw`, and `ds-tag`'s label weight comes from `--ds-tag-font-weight` (or the `--font-weight-bold` default).",
366
+ "note": "`ds-tag`'s typography tokens now read alike: `--ds-tag-font-size`, `--ds-tag-font-weight` and `--ds-tag-line-height`, matching the spelled-out `--ds-*` names elsewhere since 0.13.4."
367
+ },
368
+ {
369
+ "id": "tag-lh-is-tag-line-height",
370
+ "kind": "token-rename",
371
+ "old": "--ds-tag-lh",
372
+ "new": "--ds-tag-line-height",
373
+ "surface": "style",
374
+ "action": "Rewrite `--ds-tag-lh` to `--ds-tag-line-height`, keeping the value.",
375
+ "appliesWhen": "Any stylesheet that sets `--ds-tag-lh`, on `ds-tag`, an ancestor or `:root`. `--ds-tag-font-size` and `--ds-tag-font-weight` are different tokens on the same element.",
376
+ "pitfall": "The old name is inert rather than invalid, so a declaration left behind sets nothing and reports nothing - the tag's label quietly falls back to `--line-height-base`.",
377
+ "restore": null,
378
+ "searchHints": [
379
+ "--ds-tag-lh"
380
+ ],
381
+ "detect": [
382
+ "--ds-tag-lh([^A-Za-z0-9_-]|$)"
383
+ ],
384
+ "verify": "No stylesheet declares `--ds-tag-lh`, and `ds-tag`'s label line-height comes from `--ds-tag-line-height` (or the `--line-height-base` default).",
385
+ "note": "Renamed with `--ds-tag-fw` so every `ds-tag` typography token is spelled out, matching the `--ds-*` names elsewhere since 0.13.4."
386
+ },
387
+ {
388
+ "id": "slider-thumb-bw-is-slider-thumb-border-width",
389
+ "kind": "token-rename",
390
+ "old": "--ds-slider-thumb-bw",
391
+ "new": "--ds-slider-thumb-border-width",
392
+ "surface": "style",
393
+ "action": "Rewrite `--ds-slider-thumb-bw` to `--ds-slider-thumb-border-width`, keeping the value.",
394
+ "appliesWhen": "Any stylesheet that sets `--ds-slider-thumb-bw`, on `ds-slider`, an ancestor or `:root`. `--ds-slider-thumb-color` and `--ds-slider-thumb-border-color` are different tokens on the same element.",
395
+ "pitfall": "The old name is inert rather than invalid, so a declaration left behind sets nothing and reports nothing - the thumb border quietly falls back to the theme token `--slider-thumb-border-width` (renamed from `--slider-thumb-bw` by its own item in this release) or `--border-width-strong`.",
396
+ "restore": null,
397
+ "searchHints": [
398
+ "--ds-slider-thumb-bw"
399
+ ],
400
+ "detect": [
401
+ "--ds-slider-thumb-bw([^A-Za-z0-9_-]|$)"
402
+ ],
403
+ "verify": "No stylesheet declares `--ds-slider-thumb-bw`, and the slider thumb's border width comes from `--ds-slider-thumb-border-width` (or the `--slider-thumb-border-width` / `--border-width-strong` fallback chain).",
404
+ "note": "The slider's border width now reads like every other spelled-out `--ds-*` token. The theme-level fallback it chains into is renamed by its own item, so both layers move together."
405
+ },
406
+ {
407
+ "id": "theme-slider-thumb-bw-is-slider-thumb-border-width",
408
+ "kind": "token-rename",
409
+ "old": "--slider-thumb-bw",
410
+ "new": "--slider-thumb-border-width",
411
+ "surface": "style",
412
+ "action": "Rewrite `--slider-thumb-bw` to `--slider-thumb-border-width`, keeping the value.",
413
+ "appliesWhen": "Any stylesheet that sets the theme-level `--slider-thumb-bw` (not the `--ds-slider-thumb-bw` component token, renamed by its own item in this release) on `:root` or a theme class.",
414
+ "pitfall": "The old name is inert rather than invalid, so a declaration left behind sets nothing and reports nothing - the slider thumb border quietly falls back to `--border-width-strong`.",
415
+ "restore": null,
416
+ "searchHints": [
417
+ "--slider-thumb-bw"
418
+ ],
419
+ "detect": [
420
+ "--slider-thumb-bw([^A-Za-z0-9_-]|$)"
421
+ ],
422
+ "verify": "No stylesheet declares `--slider-thumb-bw`, and the slider thumb's border width still resolves through `--slider-thumb-border-width` (or the `--border-width-strong` default).",
423
+ "note": "This is the theme-layer fallback `--ds-slider-thumb-border-width` chains into, declared in `styles/_tokens.scss`. It is renamed together with the component token so the two layers keep one spelling."
424
+ },
425
+ {
426
+ "id": "pagination-layout-input-nullable",
427
+ "kind": "behavior",
428
+ "old": "ds-pagination[layout]",
429
+ "new": null,
430
+ "surface": "typescript",
431
+ "action": "Where you read `layout()` back from a `PaginationComponent` reference, or override `layout` in a subclass, handle `null`: the input is `PaginationLayout | null`, unset is `null`, and `layoutResolved()` gives the effective value.",
432
+ "appliesWhen": "Only TypeScript that reads `PaginationComponent.layout()` through a `viewChild` or a template reference, or a subclass overriding `layout`. A template binding `layout=\"spread\"` or `[layout]=\"expr\"` is unaffected, and so is every pager that never set it: unset still renders grouped.",
433
+ "pitfall": "A reader comparing `layout()` to `'grouped'` to detect the default now sees `null` for an unset pager and takes the other branch, with no compile error unless the value is assigned to a `PaginationLayout`. Read `layoutResolved()` for the effective value.",
434
+ "restore": null,
435
+ "searchHints": [
436
+ "PaginationComponent",
437
+ "layout()",
438
+ "layoutResolved"
439
+ ],
440
+ "detect": [
441
+ "PaginationComponent",
442
+ ".layout()",
443
+ "extends PaginationComponent"
444
+ ],
445
+ "verify": "Every read of a pager's `layout()` handles `null` or reads `layoutResolved()` instead, and a subclass overriding `layout` declares it `PaginationLayout | null`.",
446
+ "note": "`layout` was `input<PaginationLayout>('grouped')` and is `input<PaginationLayout | null>(null)`, so an unset pager can fall back to `DS_CONFIG.pagination.layout`, then `'grouped'`. Writers are fine: `'grouped'` and `'spread'` still bind. Readers of the raw input and overriders see the widened type."
447
+ }
448
+ ],
449
+ "informational": [
450
+ "A stacked mark answers the pointer over its own segment. Each series carried a hit box spanning the whole category slot, so stacked they lay on top of one another and only the series drawn last answered - every segment reported the top one.",
451
+ "A tooltip anchored to a zero-value mark stays with its reading. Such a mark is degenerate in one axis - a column loses its height, a bar its width - and the overlay took the viewport corner or the plot's left edge instead.",
452
+ "ds-bar-chart points its tooltip at the drawn value rather than the track, so a floating bar no longer puts the panel a track width from the reading.",
453
+ "A segmented bar's tooltip heads the panel with the row and gives each segment a line with its share, instead of repeating the row label the pointer is already on.",
454
+ "A hatched mark's tooltip dot carries the same break its mark does, so neither the panel nor the plot relies on hue alone.",
455
+ {
456
+ "text": "The pinned-mark badge clears the column's top edge instead of sitting flush against it.",
457
+ "verify": "Pin a column mark: the badge sits above the column's top edge with a visible gap, not touching it."
458
+ },
459
+ {
460
+ "text": "The unpin control sits below the plot, because the panel it undoes opens above the held mark.",
461
+ "verify": "Pin a mark: the unpin control renders below the plot area, never over the marks."
462
+ },
463
+ "Legend hover fades the other series whether or not dimOthers is set, and ds-column-chart wires its legend for it. dsColumnSeries takes seriesKey and highlighted for a hand-composed plot.",
464
+ {
465
+ "text": "ds-modal and ds-modal-card stack their [actions] into a full-width column once the buttons outgrow the card, confirming action at the bottom by default (DOM order, matching Tab order) - set --ds-modal-actions-stacked-direction: column-reverse to put it on top instead; a row that fits stays right-aligned. The row used to overflow past the card's start edge and clip the first button, so a consumer rule that wraps ds-modal-card .actions is redundant (delete list: modal-actions-flex-wrap).",
466
+ "verify": "Open a sm modal whose three buttons carry long labels: each button spans the card's full width and none is clipped, the confirming button at the bottom of the stack by default and at the top under --ds-modal-actions-stacked-direction: column-reverse; a modal with two short buttons keeps them in one right-aligned row."
467
+ },
468
+ {
469
+ "text": "ds-table takes paginationSize and paginationLayout and forwards them to its footer pager as size and layout, so a larger spread footer under a table is two attributes; a consumer rule that doubles .pagination.pagination or .pagination-button.pagination-button under ds-table to force the pager's width or button height is redundant (delete list: table-pager-size-layout-override).",
470
+ "verify": "A ds-table with paginationSize=\"md\" paginationLayout=\"spread\" renders its pager buttons at the md control height with the range label at the table's start edge and the controls at its end edge; a table without either input renders its pager as before."
471
+ },
472
+ "DS_CONFIG.pagination.size and DS_CONFIG.pagination.layout set the default size and layout of every pager, ds-table's footer included: size resolves the input, then pagination.size, then control.size, then 'sm'; layout resolves the input, then pagination.layout, then 'grouped'. PaginationLayout is exported from the core entry point as well as from components/pagination.",
473
+ "A skeleton's shimmer pauses while it is off screen and advances in 68 steps over the default 3400ms. A `--ds-skeleton-wave-duration` of yours changes the step rate with it, since the step count is fixed; nothing needs editing.",
474
+ "Every field control has blur(), the counterpart of focus(): it drops focus from whichever descendant holds it. ds-search has the same pair.",
475
+ "ds-textarea exposes selectionStart, selectionEnd, setSelectionRange(start, end, direction?) and select(), forwarded to its native textarea. After value.set(...), set the range from a setTimeout: the value reaches the element a microtask later and drops the caret to the end.",
476
+ "dsCellTemplate is generic: [dsCellTemplateOf]=\"rows\" on the ng-template types let-row as the row type under strict templates and is never read at runtime; without it row stays unknown. CellTemplateContext<T> is exported.",
477
+ "ds-switch takes controlled: the switch cancels its own toggle and emits checkedRequested with the asked-for value, moving only when [checked] changes from outside. Under controlled the gesture does not update a two-way checked, ngModel or form control; the host commits the value through [checked]. Off by default; nothing changes for an existing switch.",
478
+ "ds-pagination takes loading: while true the nav reports aria-busy, the range label becomes an inline skeleton, and Prev, Next, the page buttons and the rows-per-page select are disabled. ds-table sets it on its footer pager whenever it draws skeleton rows, and leaves it off in the overlay mode.",
479
+ "The dsTableColumns panel names a column whose label is empty by its screenReaderLabel, which also gives that row's checkbox an accessible name.",
480
+ "Reduced motion stops the ds-skeleton shimmer; the opt-out in styles/skeleton-shimmer now wins over the component's own animation.",
481
+ "A chart's data table is built the first time it is opened and kept from then on; dataTable=\"visible\" is unaffected, and find-in-page no longer reaches a table nobody has opened.",
482
+ "Axis labels are measured again when their text changes, so a chart whose categories or ticks arrive after a loading or empty state no longer keeps overlapping labels.",
483
+ "A chart that enters hundreds of marks at once no longer blocks the page, ds-chart listens to the pointer only for a category cursor, and a chart destroyed while a reading was pinned no longer leaves a key listener on the document.",
484
+ {
485
+ "text": "A chart with an axis title reserves a band for it, so the widest tick label no longer runs through the rotated title, and the secondary axis title stands as far from its ticks as the primary one.",
486
+ "verify": "Open a ds-line-chart or ds-column-chart with an axis title and long value labels: the rotated title sits clear of every tick label on both value axes."
487
+ },
488
+ {
489
+ "text": "Under a category cursor the panel anchors above the tallest reading at the category, a line chart's active marker grows anywhere in the category band, and the tooltip fades out when the pointer leaves the plot. The panel's colour dot is larger, with a surface-coloured ring.",
490
+ "verify": "Hover a category on a column-and-line ds-chart with tooltip=\"axis\": the panel opens above the tallest reading, the line's marker at that category is enlarged, and leaving the plot fades the panel out."
491
+ },
492
+ "ds-scatter-chart fades the other series while a legend entry is hovered, like the other charts with a legend; it and dsColumnSeries fade to --ds-chart-dim-opacity.",
493
+ {
494
+ "text": "ds-date-picker no longer lets its value or calendar button run past its own border in a container narrower than the value mask (a range picker under fullWidth was the common case): the field keeps its content width as a minimum and overflows the container with its border intact, instead of shrinking the border around a value that cannot clip. A picker whose container fits the mask renders as before.",
495
+ "verify": "Put a range ds-date-picker with fullWidth in a container narrower than its mask (about 200px): the calendar button sits inside the field border with the usual inner padding, and the whole field extends past the container edge; in a wider container the field fills it as before."
496
+ }
497
+ ],
498
+ "deleteList": [
499
+ {
500
+ "id": "modal-actions-flex-wrap",
501
+ "surface": "style",
502
+ "find": [
503
+ "ds-modal-card .actions",
504
+ "flex-wrap: wrap"
505
+ ],
506
+ "why": "The card measures its actions row and stacks it full-width when the buttons outgrow it, so a rule wrapping the row only restates that the buttons must not be clipped.",
507
+ "replaceWith": "nothing"
508
+ },
509
+ {
510
+ "id": "mark-level-chart-tooltip-bindings",
511
+ "surface": "template",
512
+ "find": [
513
+ "[dsChartTooltip]=\"",
514
+ "[dsChartTooltipOrigin]=\"",
515
+ "[dsChartTooltipPreferBelow]=\""
516
+ ],
517
+ "why": "ds-chart opens the panel its marks describe, so a binding on the mark now opens a second one.",
518
+ "replaceWith": "nothing for the ordinary case; [tooltipTemplate] and [tooltipExtraGap] on ds-chart where the panel was customised"
519
+ },
520
+ {
521
+ "id": "expand-panel-cell-display-override",
522
+ "surface": "style",
523
+ "find": [
524
+ ".expand-panel-cell",
525
+ "display: table-cell"
526
+ ],
527
+ "why": "The expand cell is a table cell again, so a rule forcing display: table-cell on it restates the default, and while it held it also switched the reveal animation off.",
528
+ "replaceWith": "nothing"
529
+ },
530
+ {
531
+ "id": "table-pager-size-layout-override",
532
+ "surface": "style",
533
+ "find": [
534
+ ".pagination.pagination",
535
+ ".pagination-button.pagination-button",
536
+ "ds-table .pagination",
537
+ "ds-table .pagination-button"
538
+ ],
539
+ "why": "ds-table forwards paginationSize and paginationLayout to its pager, and DS_CONFIG.pagination sets the default for every pager, so a doubled-class rule forcing the pager's width, display or button height inside a table restates a size or a layout the component takes.",
540
+ "replaceWith": "paginationSize=\"md\" paginationLayout=\"spread\" on the ds-table, or provideDsConfig({ pagination: { size: 'md', layout: 'spread' } }) for every pager; a rule that wants a height none of sm, md or lg gives stays"
541
+ },
542
+ {
543
+ "id": "field-inner-input-blur",
544
+ "surface": "typescript",
545
+ "find": [
546
+ "querySelector('input')?.blur()",
547
+ "querySelector('input').blur()",
548
+ "querySelector('textarea')?.blur()"
549
+ ],
550
+ "why": "Every field control has a public blur() that drops focus from whichever descendant holds it.",
551
+ "replaceWith": "blur() on the field instance, after clear() where the field was being emptied"
552
+ },
553
+ {
554
+ "id": "textarea-inner-element-query",
555
+ "surface": "typescript",
556
+ "find": [
557
+ "querySelector('textarea')",
558
+ "querySelector(\"textarea\")"
559
+ ],
560
+ "why": "ds-textarea forwards selectionStart, selectionEnd, setSelectionRange and select to its native element, so the host no longer needs the element itself.",
561
+ "replaceWith": "selectionStart / selectionEnd / setSelectionRange() / select() on the ds-textarea instance (viewChild(TextareaComponent))"
562
+ },
563
+ {
564
+ "id": "table-row-caster-helpers",
565
+ "surface": [
566
+ "typescript",
567
+ "template"
568
+ ],
569
+ "find": [
570
+ "(row: unknown)",
571
+ "return row as "
572
+ ],
573
+ "why": "[dsCellTemplateOf]=\"rows\" on the ng-template types let-row as the row type, so a one-line caster exists only to do what the binding now does.",
574
+ "replaceWith": "[dsCellTemplateOf] bound to the table's rows, then row.field in the template. Keep a caster only where it serves rowExpandTemplate or cellTemplateMap, whose contexts stay unknown"
575
+ },
576
+ {
577
+ "id": "switch-confirm-wrapper",
578
+ "surface": [
579
+ "template",
580
+ "typescript"
581
+ ],
582
+ "find": [
583
+ "preventDefault()",
584
+ "emit(!this.checked())",
585
+ "requestChange"
586
+ ],
587
+ "why": "ds-switch cancels its own native toggle under `controlled` and reports the asked-for value through `checkedRequested`, so a wrapper that preventDefaults the click and re-emits !checked restates it.",
588
+ "replaceWith": "controlled with (checkedRequested) on ds-switch, [checked] bound one-way to the committed state"
589
+ }
590
+ ]
591
+ }
@@ -6,13 +6,16 @@
6
6
  "kind": "selector-rename",
7
7
  "old": "ds-combobox",
8
8
  "new": "ds-autocomplete",
9
- "action": "Replace the element selector `ds-combobox` with `ds-autocomplete`.",
9
+ "action": "Replace the element selector `ds-combobox` with `ds-autocomplete`, in templates and in any stylesheet rule that names the element.",
10
10
  "note": "A rename to the industry word for the control. Behaviour is unchanged.",
11
11
  "searchHints": [
12
12
  "<ds-combobox",
13
13
  "ds-combobox"
14
14
  ],
15
- "surface": "template"
15
+ "surface": [
16
+ "template",
17
+ "style"
18
+ ]
16
19
  },
17
20
  {
18
21
  "id": "combobox-component-class-rename",
@@ -84,13 +87,16 @@
84
87
  "kind": "selector-rename",
85
88
  "old": "ds-dropdown",
86
89
  "new": "ds-select",
87
- "action": "Replace `ds-dropdown` with `ds-select`, then apply `dropdown-error-input-rename` and `dropdown-option-groups-fold` to the same elements.",
90
+ "action": "Replace `ds-dropdown` with `ds-select` in templates and in any stylesheet rule that names the element, then apply `dropdown-error-input-rename` and `dropdown-option-groups-fold` to the same elements.",
88
91
  "note": "ds-dropdown is gone; ds-select is the one select-only picker, and it carries the CVA, invalid and hint, required and optional, per-option icons and readOnly.",
89
92
  "searchHints": [
90
93
  "<ds-dropdown",
91
94
  "ds-dropdown"
92
95
  ],
93
- "surface": "template"
96
+ "surface": [
97
+ "template",
98
+ "style"
99
+ ]
94
100
  },
95
101
  {
96
102
  "id": "dropdown-error-input-rename",