@ids-group-ltd/ids-design-system 0.12.3 → 0.13.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 (126) hide show
  1. package/CHANGELOG.md +603 -6
  2. package/components.md +85 -2
  3. package/docs/agent/INDEX.md +11 -1
  4. package/docs/agent/charts/chart-colour-which-palette-a-chart-takes.md +9 -0
  5. package/docs/agent/charts/chart-frame-the-box-a-chart-draws-around-itself.md +12 -0
  6. package/docs/agent/charts/ds-bar-chart.md +15 -0
  7. package/docs/agent/charts/ds-column-chart.md +14 -0
  8. package/docs/agent/charts/ds-donut-chart.md +17 -0
  9. package/docs/agent/charts/ds-funnel-chart.md +16 -0
  10. package/docs/agent/charts/ds-line-chart.md +15 -0
  11. package/docs/agent/forms/ds-button.md +4 -2
  12. package/docs/agent/forms/ds-number-stepper.md +1 -0
  13. package/docs/agent/navigation/ds-sidenav-item.md +1 -0
  14. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +2 -2
  15. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
  16. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +16 -14
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs +2 -2
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs.map +1 -1
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +161 -0
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -0
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs +2 -2
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +58 -8
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +43 -0
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -0
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +197 -0
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -0
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +1 -0
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +1 -0
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +173 -0
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -0
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +9 -6
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs +299 -0
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs.map +1 -0
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +2 -2
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +2 -2
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +69 -17
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +1 -1
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +366 -0
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -0
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +10 -14
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +631 -0
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -0
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +1 -0
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +2 -2
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +1 -0
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +2 -2
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +2 -10
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +1 -0
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +9 -6
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +18 -7
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +1 -0
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +4 -3
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +1 -0
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +1 -1
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +30 -71
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +2 -2
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +1 -0
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +1 -0
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +31 -9
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  90. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +393 -5
  91. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  92. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +17 -1
  93. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  94. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +3 -0
  95. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
  96. package/fesm2022/ids-group-ltd-ids-design-system.mjs +10 -1
  97. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  98. package/migrations/0.13.0.json +530 -0
  99. package/package.json +57 -1
  100. package/styles/_chart-data-table.scss +95 -0
  101. package/styles/_chart-frame.scss +53 -0
  102. package/styles/_chart-interactive.scss +40 -0
  103. package/styles/_chart-motion.scss +45 -0
  104. package/styles/_focus.scss +1 -1
  105. package/styles/_tokens-charts.scss +149 -39
  106. package/styles/_tokens.scss +17 -4
  107. package/themes/dark/_theme.scss +37 -29
  108. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +11 -9
  109. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +104 -0
  110. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +37 -4
  111. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +34 -0
  112. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +78 -0
  113. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +105 -0
  114. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +4 -1
  115. package/types/ids-group-ltd-ids-design-system-components-donut-chart.d.ts +113 -0
  116. package/types/ids-group-ltd-ids-design-system-components-field-group.d.ts +52 -11
  117. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +109 -0
  118. package/types/ids-group-ltd-ids-design-system-components-input.d.ts +5 -7
  119. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +241 -0
  120. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +5 -2
  121. package/types/ids-group-ltd-ids-design-system-components-sidenav.d.ts +16 -4
  122. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +13 -28
  123. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +11 -1
  124. package/types/ids-group-ltd-ids-design-system-components.d.ts +154 -4
  125. package/types/ids-group-ltd-ids-design-system-core.d.ts +12 -1
  126. package/types/ids-group-ltd-ids-design-system.d.ts +9 -2
@@ -0,0 +1,530 @@
1
+ {
2
+ "version": "0.13.0",
3
+ "items": [
4
+ {
5
+ "id": "stat-value-clips-to-one-line",
6
+ "kind": "behavior",
7
+ "old": "ds-stat",
8
+ "new": null,
9
+ "surface": [
10
+ "template",
11
+ "style"
12
+ ],
13
+ "action": "Look at every screen with a ds-stat whose value is longer than its tile, and decide per tile whether the clipped value is acceptable or the value should wrap. Shorten any label that was relying on two lines, or widen its tile — the label clips with no hook to undo it.",
14
+ "appliesWhen": "Any ds-stat, and only where the label or value is wider than the card. A tile whose value fits renders identically and needs nothing. Tiles that already set --ds-stat-value-white-space are unaffected in shape — they wrapped before and wrap now.",
15
+ "pitfall": "Nothing fails to build and nothing is lost to a screen reader, so this only shows on the screen: a tile that read in full because its value painted over the neighbouring card now ends in an ellipsis, and the text is reachable only by hovering or focusing it.",
16
+ "restore": "ds-stat { --ds-stat-value-white-space: normal; }",
17
+ "searchHints": [
18
+ "ds-stat",
19
+ "--ds-stat-value-white-space",
20
+ "--ds-stat-value-font-size"
21
+ ],
22
+ "detect": [
23
+ "<ds-stat",
24
+ "ds-stat {",
25
+ "ds-stat["
26
+ ],
27
+ "verify": "No ds-stat value paints outside its own card at any viewport width, and every tile whose value is clipped opens a tooltip carrying the full value on hover.",
28
+ "note": "The value carried `white-space: nowrap` and no overflow rule, so a phrase ran past the card and over its neighbour — 158px past a 240px tile at the default size. It now takes the same single-line ellipsis the other eleven text-bearing components use. The restore snippet keeps every character visible by wrapping, which grows the tile instead; there is no hook that brings back the value escaping the card, because that was the defect. Three hooks shape it and they compose: `white-space`, `--ds-stat-value-lines` for the ellipsis on line N, and `--ds-stat-value-wrap: anywhere` for a word wider than the tile (delete list: stat-wrap-hook-for-spill)."
29
+ },
30
+ {
31
+ "id": "table-cell-discloses-on-hover",
32
+ "kind": "behavior",
33
+ "old": "ds-table",
34
+ "new": null,
35
+ "surface": [
36
+ "typescript",
37
+ "style"
38
+ ],
39
+ "action": "Replace any flow or test that clicked a truncated cell, or read its `title`, with one that hovers or focuses it and reads the tooltip.",
40
+ "appliesWhen": "Only where a column sets `truncate`. A table without truncated columns never rendered the popover and sets no `title`, so nothing changes for it.",
41
+ "pitfall": "An end-to-end test that asserted `title` on `.cell-clip` now reads null and a click on the cell opens nothing — both pass as \"no error\" while the assertion silently stops testing disclosure.",
42
+ "restore": null,
43
+ "searchHints": [
44
+ "cell-clip",
45
+ "cell-text-pop",
46
+ "truncate"
47
+ ],
48
+ "detect": [
49
+ ".cell-clip",
50
+ "getAttribute('title')",
51
+ "cell-text-pop",
52
+ "toHaveAttribute('title'"
53
+ ],
54
+ "verify": "Hovering a truncated cell shows the full value, and a cell that already reads in full shows nothing.",
55
+ "note": "The cell set `title` on every truncated cell and opened a popover on click; the header set `title` from its own pointer-enter handler. All three are `dsTooltipWhenClipped` now, which fires on hover and on focus and stays shut when the text already fits — so the disclosure reaches the keyboard, which the click popover never did. `title` is dropped deliberately: together with a tooltip it renders the same text twice, once styled and once by the OS (delete list: table-cell-text-pop-styling)."
56
+ },
57
+ {
58
+ "id": "exported-class-members-changed",
59
+ "kind": "behavior",
60
+ "old": "TooltipDirective",
61
+ "new": null,
62
+ "surface": "typescript",
63
+ "action": "Rename your subclass member where it collides, or add `override` where the base member genuinely matches; drop an override of a member that no longer exists on the base.",
64
+ "appliesWhen": "Only a class that extends one of the two named below. Subclassing a DS component is unsupported (design-system.md § Components), so most consumers are unaffected.",
65
+ "pitfall": "A gained name fails the build loudly (TS4114 / TS2416), but a LOST one does not: an `override` of a member the base no longer declares is an error, while a method that merely shadowed one now runs as your own code with nothing calling it.",
66
+ "restore": null,
67
+ "searchHints": [
68
+ "extends TooltipDirective",
69
+ "extends TableComponent",
70
+ "extends ButtonComponent",
71
+ "extends SidenavItemComponent",
72
+ "extends SidenavGroupComponent",
73
+ "extends AutocompleteComponent",
74
+ "extends DatePickerComponent",
75
+ "extends FieldGroupComponent",
76
+ "extends InputComponent",
77
+ "extends SelectComponent",
78
+ "extends "
79
+ ],
80
+ "detect": [
81
+ "extends TooltipDirective",
82
+ "extends TableComponent",
83
+ "extends ButtonComponent",
84
+ "extends SidenavItemComponent",
85
+ "extends SidenavGroupComponent",
86
+ "extends AutocompleteComponent",
87
+ "extends DatePickerComponent",
88
+ "extends FieldGroupComponent",
89
+ "extends InputComponent",
90
+ "extends SelectComponent"
91
+ ],
92
+ "verify": "The consumer app type-checks, and no subclass declares `override` on a member the base no longer has.",
93
+ "note": "TooltipDirective gained `dsTooltipWhenClipped` and `tipText`; ButtonComponent gained the five destination modifiers plus `routerLinkActiveOptions`, `ariaCurrent` and two resolvers; SidenavItemComponent and SidenavGroupComponent each gained `ariaCurrent` and two resolvers. TableComponent lost `cellPopoverText`, `isClipped`, `onCellClipClick` and `onHeaderEnter` — the three hand-rolled disclosures it carried, now one directive. The compiler enumerates every collision on the first build, which is why the names live here and not in the action."
94
+ },
95
+ {
96
+ "id": "button-border-token-names-the-colour",
97
+ "kind": "token-rename",
98
+ "old": "--ds-button-border",
99
+ "new": "--ds-button-border-color",
100
+ "surface": "style",
101
+ "action": "Rename the token where you set it.",
102
+ "appliesWhen": "Only a stylesheet that sets `--ds-button-border`. `--ds-button-border-width` is a different token and is NOT renamed — check the word boundary before replacing.",
103
+ "pitfall": "A blind replace of `--ds-button-border` also rewrites `--ds-button-border-width` into `--ds-button-border-color-width`, which resolves to nothing and drops the declaration.",
104
+ "restore": null,
105
+ "searchHints": [
106
+ "--ds-button-border"
107
+ ],
108
+ "detect": [
109
+ "--ds-button-border"
110
+ ],
111
+ "verify": "No stylesheet names `--ds-button-border` without the `-color` or `-width` suffix.",
112
+ "note": "The token sets the border COLOUR, and since the width moved out to `--ds-button-border-width` the bare name read as a `border` shorthand. Rename the longer `--ds-button-border-disabled` first — it is a separate entry, and the shorter name is a prefix of it."
113
+ },
114
+ {
115
+ "id": "button-border-disabled-token-names-the-colour",
116
+ "kind": "token-rename",
117
+ "old": "--ds-button-border-disabled",
118
+ "new": "--ds-button-border-color-disabled",
119
+ "surface": "style",
120
+ "action": "Rename the token where you set it.",
121
+ "appliesWhen": "Only a stylesheet that sets `--ds-button-border-disabled`.",
122
+ "pitfall": null,
123
+ "restore": null,
124
+ "searchHints": [
125
+ "--ds-button-border-disabled"
126
+ ],
127
+ "detect": [
128
+ "--ds-button-border-disabled"
129
+ ],
130
+ "verify": "No stylesheet names `--ds-button-border-disabled`.",
131
+ "note": "Same correction as the resting colour beside it. Rename this one FIRST: the shorter `--ds-button-border` is a prefix of it, so the other entry run first would corrupt this name."
132
+ },
133
+ {
134
+ "id": "link-aria-current-is-exact",
135
+ "kind": "behavior",
136
+ "old": "ds-button[routerLink]",
137
+ "new": null,
138
+ "surface": [
139
+ "typescript",
140
+ "none"
141
+ ],
142
+ "action": "Update any assertion that expected `aria-current=\"page\"` on a link whose destination is a PREFIX of the current URL — it reads `true` now.",
143
+ "appliesWhen": "Only a `routerLink` destination on `ds-button`, `ds-sidenav-item` or `ds-sidenav-group`, and only where the destination is an ancestor of the current URL. An exact destination still announces `page`. Nothing changes on screen: the `active` class still matches by prefix.",
144
+ "pitfall": "Nothing renders differently, so a screen is no evidence either way — the only readers are a screen reader and a test that reads the attribute.",
145
+ "restore": "ariaCurrent=\"page\"",
146
+ "searchHints": [
147
+ "aria-current",
148
+ "routerLinkActive"
149
+ ],
150
+ "detect": [
151
+ "aria-current=\"page\"",
152
+ "getAttribute('aria-current')",
153
+ "toHaveAttribute('aria-current'"
154
+ ],
155
+ "verify": "A link whose destination IS the current URL announces `page`; a link to a section the reader is inside announces `true`; every other link announces nothing.",
156
+ "note": "`aria-current` was derived from `routerLinkActive`, which matches by prefix, so a back-link claimed to be the page the reader was leaving. ARIA separates them: `page` is the page you are on, `true` is the current section or an ancestor. `ariaCurrent` overrides the result where a link is a step or a location rather than a page, and `null` silences it."
157
+ },
158
+ {
159
+ "id": "router-link-input-accepts-a-urltree",
160
+ "kind": "behavior",
161
+ "old": "ds-button[routerLink]",
162
+ "new": null,
163
+ "surface": "typescript",
164
+ "action": "Handle `UrlTree` where you read a `routerLink` value back off one of these components, or override the input in a subclass.",
165
+ "appliesWhen": "Only code that READS or OVERRIDES `routerLink` on `ds-button`, `ds-sidenav-item` or `ds-sidenav-group`. Writing it is unaffected — every value that worked before still works.",
166
+ "pitfall": "A widened union is source-compatible for whoever writes the value and breaking for whoever reads it back, so a consumer feels this only in a type error far from the binding — `link.split('/')` on a value that may now be a `UrlTree`.",
167
+ "restore": null,
168
+ "searchHints": [
169
+ "routerLink"
170
+ ],
171
+ "detect": [
172
+ ".routerLink()",
173
+ "extends ButtonComponent",
174
+ "extends SidenavItemComponent",
175
+ "extends SidenavGroupComponent"
176
+ ],
177
+ "verify": "The consumer app type-checks with no cast added at a routerLink read.",
178
+ "note": "`string | readonly unknown[] | null` became `DsRouterLink`, which adds `UrlTree`. It is what makes `relativeTo` and `preserveFragment` reachable without an input each. A subclass overriding the input breaks on the invariant `equal` position of `InputSignalWithTransform` even where the values are compatible."
179
+ },
180
+ {
181
+ "id": "field-group-chrome-moves-to-an-inner-row",
182
+ "kind": "behavior",
183
+ "old": "ds-field-group",
184
+ "new": null,
185
+ "surface": "style",
186
+ "action": "Re-point any rule that styles the group’s box at `ds-field-group .row`, or replace it with the matching `--ds-field-group-*` token.",
187
+ "appliesWhen": "Only a stylesheet that reaches `ds-field-group` itself to change the border, radius, padding, background or overflow. Overrides written through `--ds-field-group-*` tokens need nothing — the tokens are still declared on the host. Layout properties on the host (width, margin, display) are unaffected.",
188
+ "pitfall": "The rule still matches an element, so nothing errors and the selector does not go red in a linter — it simply styles a box that no longer draws the border.",
189
+ "restore": null,
190
+ "searchHints": [
191
+ "ds-field-group"
192
+ ],
193
+ "detect": [
194
+ "ds-field-group {",
195
+ "ds-field-group.",
196
+ "::ng-deep ds-field-group"
197
+ ],
198
+ "verify": "The group renders with your border/radius as before, and the message row sits outside the bordered box.",
199
+ "note": "The group carries its own message row now, and that line has to sit outside the border — so the host became the column that stacks the two and `.row` became the bordered box. A group with no message keeps the same outer box it had: measured at 40px row and 40px host, growing to 57px only once `error` or `hint` is bound."
200
+ },
201
+ {
202
+ "id": "chart-categorical-tokens-renamed",
203
+ "kind": "token-rename",
204
+ "surface": "style",
205
+ "old": "--chart-cat-1, --chart-cat-2, --chart-cat-3, --chart-cat-4, --chart-cat-5, --chart-cat-6, --chart-cat-7, --chart-cat-8",
206
+ "new": "--chart-categorical-1, --chart-categorical-2, --chart-categorical-3, --chart-categorical-4, --chart-categorical-5, --chart-categorical-6, --chart-categorical-7, --chart-categorical-8",
207
+ "action": "Replace the prefix `--chart-cat-` with `--chart-categorical-` on all eight series tokens, keeping the number.",
208
+ "appliesWhen": "Any stylesheet of yours that reads or re-declares one of the eight, including a theme block. A `--chart-cat-` variable of your own is out of scope, and the eight `--ds-chart-series-1-color` … `--ds-chart-series-8-color` hooks are new rather than renamed.",
209
+ "pitfall": "The old name is inert, not invalid. A `var()` on it resolves to nothing, which makes the declaration holding it invalid at computed-value time and drops it whole — a series loses its fill rather than falling back to a default, and nothing is reported.",
210
+ "note": "The palette is spelled out end to end now, so a name can be searched for without being decoded first. The eight VALUES are retuned in the same release, so the rename lands a different colour rather than the same one under a new name: the set is rebuilt around coral and teal, every hue clears 3:1 on white, and no hue falls between 35 and 130, where a colour cannot be both rich and legible. Slot 8 is a neutral now. Read each value back from the installed package rather than assuming the one you saw before.",
211
+ "searchHints": [
212
+ "--chart-cat-",
213
+ "chart-cat"
214
+ ],
215
+ "detect": [
216
+ "--chart-cat-"
217
+ ],
218
+ "verify": "No stylesheet names a `--chart-cat-` token, and every series that took its colour from one still paints."
219
+ },
220
+ {
221
+ "id": "chart-sequential-tokens-renamed",
222
+ "kind": "token-rename",
223
+ "surface": "style",
224
+ "old": "--chart-seq-1, --chart-seq-2, --chart-seq-3, --chart-seq-4, --chart-seq-5, --chart-seq-6",
225
+ "new": "--chart-sequential-1, --chart-sequential-2, --chart-sequential-3, --chart-sequential-4, --chart-sequential-5, --chart-sequential-6",
226
+ "action": "Replace the prefix `--chart-seq-` with `--chart-sequential-` on all six ramp stops, keeping the number.",
227
+ "appliesWhen": "Any stylesheet of yours that reads or re-declares one of the six, including a theme block. The ramp is six stops in both themes and neither gained nor lost one.",
228
+ "pitfall": "The old name is inert, not invalid. A `var()` on it resolves to nothing, which makes the declaration holding it invalid at computed-value time and drops it whole — a heat scale renders unpainted rather than falling back, and nothing is reported.",
229
+ "note": "Single-hue ramp for ordinal magnitudes, low to high. Values are identical in both the light and the dark theme, where the ramp runs the other way round by design.",
230
+ "searchHints": [
231
+ "--chart-seq-",
232
+ "chart-seq"
233
+ ],
234
+ "detect": [
235
+ "--chart-seq-"
236
+ ],
237
+ "verify": "No stylesheet names a `--chart-seq-` token, and a sequential scale still paints across all six stops."
238
+ },
239
+ {
240
+ "id": "chart-divergent-tokens-renamed",
241
+ "kind": "token-rename",
242
+ "surface": "style",
243
+ "old": "--chart-div--3, --chart-div--2, --chart-div--1, --chart-div-0, --chart-div-1, --chart-div-2, --chart-div-3",
244
+ "new": "--chart-divergent--3, --chart-divergent--2, --chart-divergent--1, --chart-divergent-0, --chart-divergent-1, --chart-divergent-2, --chart-divergent-3",
245
+ "action": "Replace the prefix `--chart-div-` with `--chart-divergent-` on all seven steps, keeping the suffix exactly as it is.",
246
+ "appliesWhen": "Any stylesheet of yours that reads or re-declares one of the seven, including a theme block. Only the prefix moves; the signed suffix is untouched.",
247
+ "pitfall": "The negative steps carry a double hyphen — `--chart-div--3` becomes `--chart-divergent--3`, not `--chart-divergent-3`. Collapsing it points the worst negative step at the best positive one, which is a readable chart with the sign inverted and no way to notice from the code.",
248
+ "note": "Red through neutral to green for signed data. The three negative steps, the zero step and the three positive steps all keep their meaning and their value in both themes.",
249
+ "searchHints": [
250
+ "--chart-div-",
251
+ "chart-div"
252
+ ],
253
+ "detect": [
254
+ "--chart-div-"
255
+ ],
256
+ "verify": "No stylesheet names a `--chart-div-` token, and a signed scale still shows its negative steps in red and its positive steps in green."
257
+ },
258
+ {
259
+ "id": "chart-strong-gridline-token-removed",
260
+ "kind": "removed-api",
261
+ "surface": "style",
262
+ "old": "--chart-grid-line-strong",
263
+ "new": null,
264
+ "action": "Delete the declaration. No chart draws an emphasised gridline, so the token fed nothing.",
265
+ "appliesWhen": "Any stylesheet of yours that declares `--chart-grid-line-strong`. The plain `--chart-grid-line` is a separate token, is renamed rather than removed, and has its own entry.",
266
+ "pitfall": "`--chart-grid-line` is a prefix of this name, so a sweep that renames the shorter one first rewrites this one into `--chart-grid-line-color-strong` instead of deleting it, and leaves a declaration nothing reads.",
267
+ "restore": null,
268
+ "note": "The token fed `--ds-chart-grid-line-strong-color`, which reached no rule, so setting either already painted nothing.",
269
+ "searchHints": [
270
+ "--chart-grid-line-strong",
271
+ "grid-line-strong"
272
+ ],
273
+ "detect": [
274
+ "--chart-grid-line-strong"
275
+ ],
276
+ "verify": "No stylesheet names `--chart-grid-line-strong`."
277
+ },
278
+ {
279
+ "id": "chart-color-tokens-gain-color-suffix",
280
+ "kind": "token-rename",
281
+ "surface": "style",
282
+ "old": "--chart-axis-line, --chart-axis-label, --chart-grid-line, --chart-cursor-line, --chart-tooltip-border",
283
+ "new": "--chart-axis-line-color, --chart-axis-label-color, --chart-grid-line-color, --chart-cursor-line-color, --chart-tooltip-border-color",
284
+ "action": "Add `-color` to the end of all five names, after renaming `--chart-grid-line-strong`.",
285
+ "appliesWhen": "Any stylesheet of yours that reads or re-declares one of the five, including a theme block. `--chart-hover-bg-color`, `--chart-tooltip-bg-color` and `--chart-tooltip-text-color` already carried the suffix and keep their names; `--chart-axis-title` is removed rather than renamed and has its own entry.",
286
+ "pitfall": "The old name is inert, not invalid: a gridline or an axis rule simply stops being painted, and an axis with no line reads as a deliberately minimal chart rather than as a broken override.",
287
+ "note": "`--chart-grid-line` is a prefix of `--chart-grid-line-strong`, so handle the longer identifier first — it has an entry of its own. The five values are unchanged in both themes.",
288
+ "searchHints": [
289
+ "--chart-axis-",
290
+ "--chart-grid-line",
291
+ "--chart-cursor-line",
292
+ "--chart-tooltip-border"
293
+ ],
294
+ "detect": [
295
+ "--chart-axis-line",
296
+ "--chart-axis-label",
297
+ "--chart-grid-line",
298
+ "--chart-cursor-line",
299
+ "--chart-tooltip-border"
300
+ ],
301
+ "verify": "Every chart colour token in your styles ends in `-color`, and axis lines, gridlines, the crosshair and the tooltip border all still paint."
302
+ },
303
+ {
304
+ "id": "chart-axis-title-token-removed",
305
+ "kind": "removed-api",
306
+ "surface": "style",
307
+ "old": "--chart-axis-title",
308
+ "new": null,
309
+ "action": "Delete the declaration. No chart draws an axis title, so the token fed nothing.",
310
+ "appliesWhen": "Any stylesheet of yours that declares `--chart-axis-title`.",
311
+ "pitfall": "It is a prefix of nothing and nothing is a prefix of it, so a sweep is safe — but the neighbouring `--chart-axis-line` and `--chart-axis-label` are RENAMED rather than removed, and deleting those loses the axis.",
312
+ "restore": null,
313
+ "note": "The token fed `--ds-chart-axis-title-color`, which reached no rule, so setting either already painted nothing.",
314
+ "searchHints": [
315
+ "--chart-axis-title"
316
+ ],
317
+ "detect": [
318
+ "--chart-axis-title"
319
+ ],
320
+ "verify": "No stylesheet names `--chart-axis-title`."
321
+ },
322
+ {
323
+ "id": "chart-line-width-bold-token-renamed",
324
+ "kind": "token-rename",
325
+ "surface": "style",
326
+ "old": "--chart-line-w-bold",
327
+ "new": "--chart-line-width-bold",
328
+ "action": "Rename `--chart-line-w-bold` to `--chart-line-width-bold`, before renaming the shorter `--chart-line-w`.",
329
+ "appliesWhen": "Any stylesheet of yours that sets the emphasised line-series stroke width. The plain `--chart-line-w` is a separate token with its own entry.",
330
+ "pitfall": "The old name is inert, not invalid: the stroke falls back to whatever the rule around it declared, so an emphasised line comes out the same weight as the rest and the chart still looks finished.",
331
+ "note": "`w` was the only abbreviation in the geometry set that a reader had to expand before searching for it. The value is unchanged at 3px.",
332
+ "searchHints": [
333
+ "--chart-line-w-bold",
334
+ "line-w-bold"
335
+ ],
336
+ "detect": [
337
+ "--chart-line-w-bold"
338
+ ],
339
+ "verify": "No stylesheet names `--chart-line-w-bold`, and an emphasised line still draws heavier than a plain one."
340
+ },
341
+ {
342
+ "id": "chart-dot-radius-active-token-renamed",
343
+ "kind": "token-rename",
344
+ "surface": "style",
345
+ "old": "--chart-dot-r-active",
346
+ "new": "--chart-dot-radius-active",
347
+ "action": "Rename `--chart-dot-r-active` to `--chart-dot-radius-active`, before renaming the shorter `--chart-dot-r`.",
348
+ "appliesWhen": "Any stylesheet of yours that sets the hovered or selected data-point radius. The resting `--chart-dot-r` is a separate token with its own entry.",
349
+ "pitfall": "The old name is inert, not invalid: the active dot keeps the resting radius, so hovering a point gives no size feedback at all while everything else about the interaction still works.",
350
+ "note": "`r` read as a radius only if you already knew the set. The value is unchanged at 6px.",
351
+ "searchHints": [
352
+ "--chart-dot-r-active",
353
+ "dot-r-active"
354
+ ],
355
+ "detect": [
356
+ "--chart-dot-r-active"
357
+ ],
358
+ "verify": "No stylesheet names `--chart-dot-r-active`, and a hovered data point still grows."
359
+ },
360
+ {
361
+ "id": "chart-geometry-abbreviations-spelled-out",
362
+ "kind": "token-rename",
363
+ "surface": "style",
364
+ "old": "--chart-axis-fs, --chart-line-w, --chart-dot-r",
365
+ "new": "--chart-axis-font-size, --chart-line-width, --chart-dot-radius",
366
+ "action": "Rename `--chart-axis-fs` to `--chart-axis-font-size`, `--chart-line-w` to `--chart-line-width` and `--chart-dot-r` to `--chart-dot-radius`.",
367
+ "appliesWhen": "Any stylesheet of yours that sets the axis label size, the line-series stroke width or the resting data-point radius. `--chart-tick-size` and `--chart-bar-gap` were never abbreviated and keep their names.",
368
+ "pitfall": "The old name is inert, not invalid: an axis label falls back to the surrounding font size and a dot to whatever the rule around it declared, so the chart still renders and only its proportions are wrong.",
369
+ "note": "Rename the two longer identifiers first — `--chart-line-w-bold` and `--chart-dot-r-active` each have an entry of their own, and a sweep that starts with the short names relies on replace order rather than on matching a whole name. All three values are unchanged.",
370
+ "searchHints": [
371
+ "--chart-axis-fs",
372
+ "--chart-line-w",
373
+ "--chart-dot-r"
374
+ ],
375
+ "detect": [
376
+ "--chart-axis-fs",
377
+ "--chart-line-w",
378
+ "--chart-dot-r"
379
+ ],
380
+ "verify": "No stylesheet names `--chart-axis-fs`, `--chart-line-w` or `--chart-dot-r`, and axis labels, line strokes and data-point dots keep the sizes they had."
381
+ },
382
+ {
383
+ "id": "table-row-action-label-accepts-a-function",
384
+ "kind": "behavior",
385
+ "old": "TableRowAction",
386
+ "new": null,
387
+ "surface": "typescript",
388
+ "action": "Narrow `action.label` before using it as a string wherever you read one back off a `TableRowAction`.",
389
+ "appliesWhen": "Only code that READS `label` off the type — a `rowActionSelected` handler branching on the text, a test asserting it, a custom renderer. Writing it is unaffected: every string that worked still works.",
390
+ "pitfall": "A widened union is source-compatible for whoever writes the value, so this surfaces far from the declaration — a template interpolating `action.label` prints the function source instead of failing.",
391
+ "restore": null,
392
+ "searchHints": [
393
+ "TableRowAction",
394
+ "rowActions",
395
+ "rowActionSelected"
396
+ ],
397
+ "detect": [
398
+ ".label",
399
+ "action.label",
400
+ "rowActionSelected"
401
+ ],
402
+ "verify": "No read of a row action’s `label` assumes a string without narrowing.",
403
+ "note": "`label: string` became `string | ((row: T) => string)`, the same widening `disabledReason` already carries. It exists so one action can read two ways under one id — the alternative was two ids with mirrored `hidden` predicates. Branch on `id`, never on the label text."
404
+ },
405
+ {
406
+ "id": "field-group-context-gains-two-members",
407
+ "kind": "behavior",
408
+ "old": "DsFieldGroupContext",
409
+ "new": null,
410
+ "surface": [
411
+ "typescript"
412
+ ],
413
+ "action": "Add `invalidResolved: () => boolean` and `messageId: () => string | null` to every object you provide for `DS_FIELD_GROUP`.",
414
+ "appliesWhen": "Only a wrapper that PROVIDES `DS_FIELD_GROUP` so that DS fields behave as segments inside it. Injecting the token to read the context is unaffected, and so is every consumer who only uses `ds-field-group` itself.",
415
+ "pitfall": "`() => true` on `invalidResolved` paints every segment invalid and sets `aria-invalid` on all of them; `() => 'x'` on `messageId` points each segment's `aria-describedby` at an element that does not exist, which a screen reader reads as no description at all. Neither fails the build.",
416
+ "restore": "invalidResolved: () => false, messageId: () => null",
417
+ "searchHints": [
418
+ "DS_FIELD_GROUP",
419
+ "DsFieldGroupContext",
420
+ "sizeResolved"
421
+ ],
422
+ "detect": [
423
+ "provide: DS_FIELD_GROUP",
424
+ "satisfies DsFieldGroupContext",
425
+ "sizeResolved:"
426
+ ],
427
+ "verify": "A wrapper providing the token compiles, and a segment inside it carries `aria-invalid` only while the wrapper reports itself invalid.",
428
+ "note": "A segment has to read the group's resolved error state — an `error` string counts, not only the `invalid` flag — and has to add the group's one message to its own `aria-describedby`. The interface could not carry either before, so a segment inside a custom wrapper announced nothing. `() => false` and `() => null` reproduce the old behaviour exactly."
429
+ }
430
+ ],
431
+ "informational": [
432
+ "`ds-button` takes five more style hooks — `--ds-button-font-family`, `--ds-button-line-height`, `--ds-button-border-width`, `--ds-button-label-color-hover` and `--ds-button-label-color-active`. Every one defaults to the value the stylesheet read before it, so nothing moves for a button that sets none of them. Worth knowing if you reached the same values the hard way: `ds-button { --font-sans: … }` and a subtree override of `--border-width-default` both have a hook of their own now, and neither of those workarounds stops working.",
433
+ "`ds-stat` takes two more hooks beside the existing `--ds-stat-value-white-space`: `--ds-stat-value-lines` puts the ellipsis on the line you name once the value wraps, and `--ds-stat-value-wrap: anywhere` breaks a word wider than the tile. Both default to the shape the component already had, so a tile that sets neither is unaffected by them.",
434
+ "`dsTooltipWhenClipped` is public on the tooltip directive: the tip opens only while its host is showing less text than it holds, and with no `dsTooltip` text it discloses the host's own text. `isTextClipped(element)` from `/core` is the same test on its own — horizontal only, descendants included. Additive; an existing `[dsTooltip]` binding behaves exactly as before.",
435
+ "`ds-button` forwards `fragment`, `queryParams`, `queryParamsHandling`, `target` and `rel` to the anchor it renders, and `routerLink` on it, `ds-sidenav-item` and `ds-sidenav-group` now also accepts a `UrlTree` for the options with no input of their own. All additive. If you kept a hand-written button class for controls that needed one of these, it can go (delete list: hand-written-button-class-for-modifiers).",
436
+ "`routerLinkActiveOptions` and `ariaCurrent` are public on the same three components — the first moves what the `active` class matches, the second overrides what the link announces. Neither is needed for the corrected default.",
437
+ "`ds-field-group` takes `error`, `hint` and `warning` — the same message inputs every field takes, resolved by the same code. `error` turns the state on and carries the text; `invalid` stays the flag for when the text lives in a form-level summary. Every segment gains `aria-invalid` while the group is in error and points at the one message through `aria-describedby`. Additive: a group binding neither renders exactly as before.",
438
+ "`ds-bar-chart` is new — horizontal bars with a label, a value and a percentage per row, an optional data table, and a `color` override per row.",
439
+ "A public override layer sits over the chart palette: `--ds-chart-series-1-color` through `--ds-chart-series-8-color`, plus `--ds-chart-axis-line-color`, `--ds-chart-axis-label-color`, `--ds-chart-axis-title-color`, `--ds-chart-axis-font-size`, `--ds-chart-grid-line-color`, `--ds-chart-grid-line-strong-color`, `--ds-chart-hover-bg-color`, `--ds-chart-cursor-line-color`, `--ds-chart-tooltip-bg-color`, `--ds-chart-tooltip-text-color`, `--ds-chart-tooltip-border-color`, `--ds-chart-bar-gap`, `--ds-chart-line-width`, `--ds-chart-line-width-bold`, `--ds-chart-dot-radius`, `--ds-chart-dot-radius-active` and `--ds-chart-tick-size`. Each defaults to the palette token behind it, so nothing moves until you set one; set these rather than the palette, and recolouring one series costs one declaration instead of the whole ramp.",
440
+ "`TableRowAction` gains `divider?: boolean`, which draws a line above the item — for the destructive tail that colour alone was separating. Additive, and ignored on the first item because a line at the top of a menu has nothing on one side of it.",
441
+ "A field that is disabled no longer sets `aria-invalid`, on all fifteen. Nothing renders differently — the error paint already excluded disabled — and the message text still shows. Only a test asserting `aria-invalid` on a disabled control is affected.",
442
+ "Five chart components ship: `ds-bar-chart`, `ds-column-chart`, `ds-donut-chart`, `ds-funnel-chart` and `ds-line-chart`. Each takes a `caption`, a `summary` for the accessible name, a `loading` skeleton, an `emptyText` and a `valueFormat`, and each offers its numbers again as a table under a `dataTable: 'toggle' | 'visible' | 'none'` disclosure. All new; nothing existing changes.",
443
+ "Chart colour is three families now, and picking the wrong one is the usual chart bug. `--ds-chart-series-1-color` … `--ds-chart-series-8-color` are CATEGORICAL — for marks that are different things, such as donut slices and line series. `--ds-chart-series-default-color` with `--ds-chart-series-accent-color` is a SINGLE SERIES measured repeatedly — bar rows, columns — where every mark shares one colour and the accent marks the one to land on. `--ds-chart-ramp-1-color` … `--ds-chart-ramp-8-color` is one hue light to deep, for the ordered stages of a single quantity. The default and accent tokens and the eight ramp tokens are new; the eight series tokens keep their names.",
444
+ "Every interactive chart is keyboard-operable. Set `interactive` on `ds-bar-chart`, `ds-column-chart`, `ds-donut-chart` or `ds-funnel-chart` and each mark joins the tab order as a `role=\"button\"`, answering Enter and Space with the same output a click emits, while the container announces itself as a `group` rather than an `img`. Without the flag the chart stays one image to a screen reader and the annex table carries the numbers. The click output fires either way, so a binding written without the flag is unaffected.",
445
+ "`ds-donut-chart` takes `maxSlices` and `otherLabel`: past the cap the smallest slices are summed into one slice on the neutral eighth palette colour. Off by default, so an existing ring is unaffected. `ds-number-stepper` takes `--ds-number-stepper-field-width`, defaulting to the width it already had — set it where values carry more digits than that width holds, since a longer one is clipped rather than wrapped."
446
+ ],
447
+ "deleteList": [
448
+ {
449
+ "id": "stat-wrap-hook-for-spill",
450
+ "surface": "style",
451
+ "find": [
452
+ "--ds-stat-value-white-space: normal",
453
+ "--ds-stat-value-white-space:normal"
454
+ ],
455
+ "why": "the value clips by default now, so the hook is no longer what stops it painting over the tile beside it",
456
+ "replaceWith": "nothing where it was written only to contain the value; keep it where the tile is meant to wrap and grow taller, which is still the only way to show every character"
457
+ },
458
+ {
459
+ "id": "stat-own-value-clip",
460
+ "surface": "style",
461
+ "find": [
462
+ "ds-stat .value",
463
+ "::ng-deep ds-stat"
464
+ ],
465
+ "why": "the component clips the value itself, through `overflow: clip` with a clip margin — a hand-written `overflow: hidden` on the same element shaves the descenders the component now keeps",
466
+ "replaceWith": "nothing"
467
+ },
468
+ {
469
+ "id": "table-cell-text-pop-styling",
470
+ "surface": "style",
471
+ "find": [
472
+ ".cell-text-pop",
473
+ "ds-table .cell-text-pop"
474
+ ],
475
+ "why": "the full-value popover is gone; a clipped cell opens a tooltip instead",
476
+ "replaceWith": "the tooltip panel, if the disclosure needs styling at all"
477
+ },
478
+ {
479
+ "id": "hand-written-button-class-for-modifiers",
480
+ "surface": [
481
+ "style",
482
+ "template"
483
+ ],
484
+ "find": [
485
+ "class=\"btn",
486
+ "class=\"btn btn--",
487
+ ".btn--primary"
488
+ ],
489
+ "why": "the destination modifiers that forced a control to stay hand-written — `fragment`, `queryParams`, `target`, `rel` — are inputs on `ds-button` now",
490
+ "replaceWith": "`ds-button` with the matching input; keep the class only for a control that is genuinely not a button"
491
+ },
492
+ {
493
+ "id": "routerlink-imported-for-extra-inputs",
494
+ "surface": "typescript",
495
+ "find": [
496
+ "RouterLink",
497
+ "imports: [RouterLink"
498
+ ],
499
+ "why": "importing it to write `[queryParams]` or `[fragment]` on a `<ds-button>` put a second RouterLink on the host that disagreed with the anchor\\u2019s about the destination",
500
+ "replaceWith": "the component\\u2019s own inputs; keep the import where you use `RouterLink` on your own anchors"
501
+ },
502
+ {
503
+ "id": "chart-axis-title-colour-hook",
504
+ "surface": "style",
505
+ "find": [
506
+ "--ds-chart-axis-title-color"
507
+ ],
508
+ "why": "no chart draws an axis title, so the token reached no rule and setting it changed nothing",
509
+ "replaceWith": "nothing"
510
+ },
511
+ {
512
+ "id": "chart-strong-gridline-hook",
513
+ "surface": "style",
514
+ "find": [
515
+ "--ds-chart-grid-line-strong-color"
516
+ ],
517
+ "why": "no chart draws a strong gridline, so the token reached no rule and setting it changed nothing",
518
+ "replaceWith": "nothing"
519
+ },
520
+ {
521
+ "id": "chart-axis-tick-size-hook",
522
+ "surface": "style",
523
+ "find": [
524
+ "--ds-chart-tick-size"
525
+ ],
526
+ "why": "no chart draws tick marks on its axes, so the token reached no rule and setting it changed nothing",
527
+ "replaceWith": "nothing"
528
+ }
529
+ ]
530
+ }