@ids-group-ltd/ids-design-system 0.13.1 → 0.13.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +626 -0
- package/components.md +17 -9
- package/docs/agent/INDEX.md +1 -1
- package/docs/agent/charts/ds-column-chart.md +3 -2
- package/docs/agent/charts/ds-line-chart.md +2 -1
- package/docs/agent/feedback/ds-bar.md +13 -0
- package/docs/agent/forms/ds-button.md +1 -1
- package/docs/agent/forms/ds-icon-button.md +1 -1
- package/docs/agent/surfaces/ds-card.md +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +81 -13
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs +95 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs.map +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +3 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +47 -5
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +198 -50
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +973 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -0
- package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +172 -111
- package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs +86 -15
- package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +87 -12
- package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +193 -98
- package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +2 -2
- package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +233 -33
- package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +2 -1
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.13.2.json +269 -0
- package/migrations/0.13.3.json +211 -0
- package/package.json +17 -9
- package/styles/_chart-frame.scss +117 -10
- package/styles/_chart-interactive.scss +12 -3
- package/styles/_overlay-motion.scss +7 -6
- package/styles/_tokens-charts.scss +29 -5
- package/styles/_tokens.scss +1 -1
- package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +68 -5
- package/types/ids-group-ltd-ids-design-system-components-bar.d.ts +63 -0
- package/types/ids-group-ltd-ids-design-system-components-button.d.ts +3 -2
- package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +25 -2
- package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +21 -4
- package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +543 -0
- package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +125 -37
- package/types/ids-group-ltd-ids-design-system-components-donut-chart.d.ts +43 -4
- package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +52 -4
- package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +90 -23
- package/types/ids-group-ltd-ids-design-system-components.d.ts +91 -16
- package/types/ids-group-ltd-ids-design-system-core.d.ts +73 -6
- package/types/ids-group-ltd-ids-design-system.d.ts +7 -6
- package/docs/agent/feedback/ds-progress.md +0 -7
- package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs +0 -41
- package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs.map +0 -1
- package/types/ids-group-ltd-ids-design-system-components-progress.d.ts +0 -22
|
@@ -0,0 +1,269 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": "0.13.2",
|
|
3
|
+
"items": [
|
|
4
|
+
{
|
|
5
|
+
"id": "chart-share-of-total-behind-part-of-whole",
|
|
6
|
+
"kind": "behavior",
|
|
7
|
+
"old": "ds-bar-chart",
|
|
8
|
+
"new": null,
|
|
9
|
+
"surface": "template",
|
|
10
|
+
"action": "Add `partOfWhole` to any `ds-bar-chart` or `ds-column-chart` whose categories genuinely divide one total, to keep the `18.6% of total` line `0.13.1` put in its tooltip. Leave it off everywhere else — the line disappears and the tooltip reads as it did before `0.13.1`.",
|
|
11
|
+
"appliesWhen": "Only `ds-bar-chart` and `ds-column-chart`. `ds-donut-chart` and `ds-funnel-chart` state their own percentages from their own geometry and are untouched; `ds-line-chart` never had the line.",
|
|
12
|
+
"pitfall": "Nothing errors and nothing logs — the second line simply stops appearing. The reverse is the worse failure: leaving `partOfWhole` on a chart whose marks are a funnel or a time series states a share of a total that does not exist as a quantity.",
|
|
13
|
+
"restore": "Set `partOfWhole` on the chart.",
|
|
14
|
+
"searchHints": [
|
|
15
|
+
"ds-bar-chart",
|
|
16
|
+
"ds-column-chart",
|
|
17
|
+
"of total",
|
|
18
|
+
"partOfWhole"
|
|
19
|
+
],
|
|
20
|
+
"detect": [
|
|
21
|
+
"ds-bar-chart",
|
|
22
|
+
"ds-column-chart"
|
|
23
|
+
],
|
|
24
|
+
"verify": "Every chart that still shows a share on its tooltip carries `partOfWhole`, and every chart carrying it has categories that add up to a total a reader can name.",
|
|
25
|
+
"note": "A share of a total is only a real quantity when the marks are parts of one whole. `0.13.1` stated one unconditionally, which made the figure meaningless on funnel-shaped and time-series data. The input also governs the new `Share of total` column in the data table."
|
|
26
|
+
},
|
|
27
|
+
{
|
|
28
|
+
"id": "exported-class-members-grew",
|
|
29
|
+
"kind": "behavior",
|
|
30
|
+
"old": "BarChartComponent",
|
|
31
|
+
"new": null,
|
|
32
|
+
"surface": "typescript",
|
|
33
|
+
"action": "Only if you SUBCLASS a chart component, or the internal legend or tooltip directive that the package root does not export, and declare a member of the same name: rename yours, or add `override` where your member genuinely means the same thing. A private base member — `detachEscape` and `closeOnEscape` — can only be resolved by renaming yours.",
|
|
34
|
+
"appliesWhen": "Only a class extending one of the five chart components, or extending the internal legend or tooltip directive, neither of which the package root exports. A template that uses the charts needs nothing.",
|
|
35
|
+
"pitfall": "The collision is a compile error, not a silent one — TS4114 for a same-named member, TS2416 where the signature differs — so a build that passes has none.",
|
|
36
|
+
"restore": null,
|
|
37
|
+
"searchHints": [
|
|
38
|
+
"pinOnClick",
|
|
39
|
+
"partOfWhole",
|
|
40
|
+
"legendMode",
|
|
41
|
+
"onMarkClick",
|
|
42
|
+
"onMarkerClick",
|
|
43
|
+
"mode",
|
|
44
|
+
"tooltipLingerMs",
|
|
45
|
+
"max",
|
|
46
|
+
"maxSecondary",
|
|
47
|
+
"drop",
|
|
48
|
+
"annotations"
|
|
49
|
+
],
|
|
50
|
+
"detect": [
|
|
51
|
+
"extends BarChartComponent",
|
|
52
|
+
"extends ColumnChartComponent",
|
|
53
|
+
"extends DonutChartComponent",
|
|
54
|
+
"extends FunnelChartComponent",
|
|
55
|
+
"extends LineChartComponent",
|
|
56
|
+
"extends ChartLegendComponent",
|
|
57
|
+
"extends ChartTooltipDirective",
|
|
58
|
+
"BarChartComponent",
|
|
59
|
+
"ColumnChartComponent",
|
|
60
|
+
"DonutChartComponent",
|
|
61
|
+
"FunnelChartComponent",
|
|
62
|
+
"LineChartComponent",
|
|
63
|
+
"ChartLegendComponent",
|
|
64
|
+
"ChartTooltipDirective",
|
|
65
|
+
"extends ProgressComponent",
|
|
66
|
+
"ProgressComponent",
|
|
67
|
+
"DsMessageBase",
|
|
68
|
+
"extends DsMessageBase"
|
|
69
|
+
],
|
|
70
|
+
"verify": "No subclass declares a member named `pinOnClick`, `partOfWhole`, `legendMode`, `tooltipLingerMs`, `max`, `maxSecondary`, `drop`, `annotations`, `onMarkClick`, `onMarkerClick`, `pinnedCategory`, `releaseCategoryPin`, `mode`, `isolated`, `isolate`, `showAll`, `hideAll`, `groupName`, `target`, `detachEscape` or `closeOnEscape`; the app builds with no TS4114, TS2415 or TS2416 on those classes.",
|
|
71
|
+
"note": "Pinning, the share gate, the legend mode and the tooltip linger each added members to the classes that carry them. Subclassing a DS component is unsupported, but a release that only adds can still fail such a build on a name collision, which is why the additions are listed here rather than in the additive notes. `ds-funnel-chart` gained `drop`, `ds-line-chart` gained `max`, `maxSecondary` and `annotations`, `ds-progress` gained `target` and `max`, and the shared message base behind the fields and the button — internal, and not exported from the package root — a protected flag deciding whether an unset reserve follows the app-wide field default."
|
|
72
|
+
},
|
|
73
|
+
{
|
|
74
|
+
"id": "chart-legend-isolates-by-default",
|
|
75
|
+
"kind": "behavior",
|
|
76
|
+
"old": "ds-line-chart",
|
|
77
|
+
"new": null,
|
|
78
|
+
"surface": "template",
|
|
79
|
+
"action": "Add `legendMode=\"toggle\"` to any `ds-line-chart` with `legendFilters` whose legend should keep hiding one series at a time. Leave it off and the legend isolates instead: choosing a series shows that one and hides the rest.",
|
|
80
|
+
"appliesWhen": "Only a `ds-line-chart` that sets `legendFilters`. A chart with a plain key legend is unchanged, and so is `hiddenSeries` — it carries the same ids in both modes, so a page driving it from a URL parameter needs nothing.",
|
|
81
|
+
"pitfall": "Nothing errors. The legend changes SHAPE as well as behaviour — checkboxes become a radio group with an `All` option — so a screenshot test of the legend and any test clicking a checkbox by role will both need updating.",
|
|
82
|
+
"restore": "Set `legendMode=\"toggle\"`.",
|
|
83
|
+
"searchHints": [
|
|
84
|
+
"legendFilters",
|
|
85
|
+
"legendMode",
|
|
86
|
+
"hiddenSeries",
|
|
87
|
+
"legend-check"
|
|
88
|
+
],
|
|
89
|
+
"detect": [
|
|
90
|
+
"legendFilters",
|
|
91
|
+
"ds-line-chart"
|
|
92
|
+
],
|
|
93
|
+
"verify": "Every filtering legend either isolates deliberately or carries `legendMode=\"toggle\"`, and any test that clicked a legend checkbox has been updated for the mode it now renders.",
|
|
94
|
+
"note": "Isolate answers the question a reader of a crowded chart actually asks — show me only this — in one action rather than one per series. The two are different controls, so isolate renders as radios and toggle as checkboxes, which is what gives each the keyboard and screen-reader behaviour it should have."
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
"id": "button-drops-the-app-wide-reserve-message-default",
|
|
98
|
+
"kind": "behavior",
|
|
99
|
+
"old": "ButtonComponent",
|
|
100
|
+
"new": null,
|
|
101
|
+
"surface": [
|
|
102
|
+
"style",
|
|
103
|
+
"template"
|
|
104
|
+
],
|
|
105
|
+
"action": "Only if your app sets `provideDsConfig({ field: { reserveMessage: true } })` AND a layout was built around the taller buttons that produced: add `[reserveMessage]=\"true\"` to the buttons that should keep the reserved row, or drop the local spacing that compensated for it.",
|
|
106
|
+
"appliesWhen": "Only an app that sets the app-wide `field.reserveMessage`. A button binding `[reserveMessage]` itself is unchanged, and so is every field — `DS_CONFIG.field.reserveMessage` still reaches them, `ds-field-group` included.",
|
|
107
|
+
"pitfall": "Nothing errors and the buttons get SHORTER, so a broken layout looks like tightened spacing rather than a regression. The tell is a button row that used to line up with a field row beside it and now sits higher.",
|
|
108
|
+
"restore": "[reserveMessage]=\"true\"",
|
|
109
|
+
"searchHints": [
|
|
110
|
+
"reserveMessage",
|
|
111
|
+
"provideDsConfig"
|
|
112
|
+
],
|
|
113
|
+
"detect": [
|
|
114
|
+
"reserveMessage: true",
|
|
115
|
+
"field: { reserveMessage",
|
|
116
|
+
"provideDsConfig",
|
|
117
|
+
"with-message"
|
|
118
|
+
],
|
|
119
|
+
"verify": "No `<ds-button>` renders an empty message row unless it binds `[reserveMessage]=\"true\"`, and every field still reserves under the app-wide default.",
|
|
120
|
+
"note": "The button takes the field message line without being a field row, and it took the field-wide default with it. `reserveMessage` exists so a field does not shift its neighbours when a message appears; a button sits outside that column, so the app-wide value now reaches fields alone and a button opts in per instance."
|
|
121
|
+
},
|
|
122
|
+
{
|
|
123
|
+
"id": "chart-frame-leaves-through-an-input",
|
|
124
|
+
"kind": "behavior",
|
|
125
|
+
"old": "ds-bar-chart",
|
|
126
|
+
"new": null,
|
|
127
|
+
"surface": "template",
|
|
128
|
+
"action": "Replace a stylesheet rule that zeroed the frame — `--ds-chart-frame-border-width: 0` with `--ds-chart-frame-padding: 0` on the chart tags — with `provideDsConfig({ chart: { frame: 'none' } })`, or `frame=\"none\"` on the odd chart that differs. Nothing is required: the custom properties still work.",
|
|
129
|
+
"appliesWhen": "Only an app that turns the chart frame off. The frame still draws by default, so an app that never touched it sees no change.",
|
|
130
|
+
"pitfall": "Nothing breaks either way. The custom properties and the input reach the same box, so setting both is harmless but means two places to look when the frame is wrong.",
|
|
131
|
+
"restore": null,
|
|
132
|
+
"searchHints": [
|
|
133
|
+
"ds-bar-chart",
|
|
134
|
+
"ds-column-chart",
|
|
135
|
+
"ds-donut-chart",
|
|
136
|
+
"ds-funnel-chart",
|
|
137
|
+
"ds-line-chart",
|
|
138
|
+
"--ds-chart-frame-border-width",
|
|
139
|
+
"--ds-chart-frame-padding"
|
|
140
|
+
],
|
|
141
|
+
"detect": [
|
|
142
|
+
"ds-bar-chart",
|
|
143
|
+
"ds-column-chart",
|
|
144
|
+
"ds-donut-chart",
|
|
145
|
+
"ds-funnel-chart",
|
|
146
|
+
"ds-line-chart"
|
|
147
|
+
],
|
|
148
|
+
"verify": "No global stylesheet reaches into a chart's frame; the app sets `DS_CONFIG.chart.frame` or a per-chart `frame` instead.",
|
|
149
|
+
"note": "Whether charts live inside cards is decided once for an app, the same as `dataTable` — so it belongs beside it in `DS_CONFIG` rather than in a deep selector."
|
|
150
|
+
},
|
|
151
|
+
{
|
|
152
|
+
"id": "chart-data-table-off-by-default",
|
|
153
|
+
"kind": "behavior",
|
|
154
|
+
"old": "ds-bar-chart",
|
|
155
|
+
"new": null,
|
|
156
|
+
"surface": "template",
|
|
157
|
+
"action": "Set `dataTable=\"toggle\"` on any chart whose numbers are NOT already on the page, or `provideDsConfig({ chart: { dataTable: 'toggle' } })` to restore the old default for a whole app.",
|
|
158
|
+
"appliesWhen": "Every chart that relied on the default. A chart already setting `dataTable` explicitly is unchanged.",
|
|
159
|
+
"pitfall": "Nothing errors, and nothing looks broken — the disclosure simply stops being rendered. Where the annex was the only non-visual route to the numbers, removing it silently takes that route away, which is why this is worth a decision rather than a default.",
|
|
160
|
+
"restore": "Set `dataTable=\"toggle\"`, or the `DS_CONFIG` default.",
|
|
161
|
+
"searchHints": [
|
|
162
|
+
"dataTable",
|
|
163
|
+
"provideDsConfig",
|
|
164
|
+
"data-table"
|
|
165
|
+
],
|
|
166
|
+
"detect": [
|
|
167
|
+
"dataTable",
|
|
168
|
+
"ds-bar-chart",
|
|
169
|
+
"ds-column-chart",
|
|
170
|
+
"ds-donut-chart"
|
|
171
|
+
],
|
|
172
|
+
"verify": "Every chart whose page does not otherwise carry its numbers sets `dataTable` explicitly, and no page shows an annex disclosure nobody asked for.",
|
|
173
|
+
"note": "`dataTable` now defaults to `'none'` rather than `'toggle'`, on all five charts and in `DS_CONFIG.chart.dataTable`. A disclosure under every plot is chrome the page did not ask for, and the page usually carries the numbers already."
|
|
174
|
+
},
|
|
175
|
+
{
|
|
176
|
+
"id": "chart-tooltip-linger-off-by-default",
|
|
177
|
+
"kind": "behavior",
|
|
178
|
+
"old": "ds-bar-chart",
|
|
179
|
+
"new": null,
|
|
180
|
+
"surface": [
|
|
181
|
+
"template",
|
|
182
|
+
"config"
|
|
183
|
+
],
|
|
184
|
+
"action": "Only where a chart tooltip holds something the reader has to REACH with the pointer — a link, a figure, a selectable string: set `[tooltipLingerMs]=\"140\"` on that chart, or `DS_CONFIG.chart.tooltipLingerMs = 140` where every tooltip in the app carries one. Everywhere else, nothing.",
|
|
185
|
+
"appliesWhen": "All five charts and any `tooltipTemplate` they render. A chart whose tooltip is the built-in label-and-value panel needs nothing — there is nothing in it to reach.",
|
|
186
|
+
"pitfall": "Nothing errors and nothing logs. A custom `tooltipTemplate` carrying a link keeps rendering the link, and the panel simply closes before the pointer can arrive — so the link is unreachable by pointer while still being in the DOM, which reads as a broken control rather than a missing setting.",
|
|
187
|
+
"restore": "Set `DS_CONFIG.chart.tooltipLingerMs = 140` to put the grace back on every chart at once.",
|
|
188
|
+
"searchHints": [
|
|
189
|
+
"tooltipTemplate",
|
|
190
|
+
"dsChartTooltip",
|
|
191
|
+
"ds-chart-tooltip-pane",
|
|
192
|
+
"tooltipLingerMs"
|
|
193
|
+
],
|
|
194
|
+
"detect": [
|
|
195
|
+
"tooltipTemplate",
|
|
196
|
+
"ds-chart-tooltip-pane",
|
|
197
|
+
"DS_CONFIG",
|
|
198
|
+
"provideDsConfig"
|
|
199
|
+
],
|
|
200
|
+
"verify": "Every chart whose tooltip template renders an anchor, a button or text a reader would select carries a non-zero `tooltipLingerMs`; every other chart carries none.",
|
|
201
|
+
"note": "A panel that outlives the pointer sits over the plot the reader has moved on to, so the delay is off. WCAG 1.4.13 asks that a hover-triggered panel be hoverable, dismissible and persistent — the first clause only bites when there is something in the panel to reach, and the built-in panel is one line of text. Dismissible and persistent hold at every value, because Escape and the latch are not on this timer."
|
|
202
|
+
},
|
|
203
|
+
{
|
|
204
|
+
"id": "chart-active-mark-gains-release",
|
|
205
|
+
"kind": "behavior",
|
|
206
|
+
"old": "ChartActiveMark",
|
|
207
|
+
"new": null,
|
|
208
|
+
"surface": "typescript",
|
|
209
|
+
"action": "Only if a class of yours IMPLEMENTS the internal `ChartActiveMark` by hand — it is not exported from the package root, only from the chart-tooltip entry point: add a `release(): void` that clears the pinned mark. Code that calls the factory needs nothing.",
|
|
210
|
+
"appliesWhen": "Only a hand-written implementation of that internal interface. Every chart binding, and every caller of the factory that returns one, is unaffected — the factory implements the method already.",
|
|
211
|
+
"pitfall": "The compiler names it (TS2420 on the class, TS2739 on a literal), so a build that passes has none. What it cannot see is a `release` that does nothing: the Unpin control and Escape both route through it, so an empty one leaves a mark pinned with a button that looks live.",
|
|
212
|
+
"restore": null,
|
|
213
|
+
"searchHints": [
|
|
214
|
+
"ChartActiveMark",
|
|
215
|
+
"chartActiveMark"
|
|
216
|
+
],
|
|
217
|
+
"detect": [
|
|
218
|
+
"implements ChartActiveMark",
|
|
219
|
+
": ChartActiveMark",
|
|
220
|
+
"ChartActiveMark"
|
|
221
|
+
],
|
|
222
|
+
"verify": "Every hand-written implementation of that internal interface declares `release()`, and calling it leaves no mark pinned.",
|
|
223
|
+
"note": "A pinned mark now offers a control that releases it, and the internal interface is what the charts call to do so. Unexported from the package root, so only a deep import can reach it, which is why the item is narrow."
|
|
224
|
+
}
|
|
225
|
+
],
|
|
226
|
+
"informational": [
|
|
227
|
+
"`ds-bar-chart` and `ds-column-chart` gained a `Share of total` column in their data table, shown only under `partOfWhole`. It carries the same figure as the tooltip's second line, so a reader who cannot hover now has a route to it. The heading says `Share of total` rather than `Share` because `ds-bar-chart` already prints a percentage beside each row and that one is the share of the largest row, not of the sum.",
|
|
228
|
+
"A chart tooltip can be selected and dismissed with Escape, which WCAG 1.4.13 requires of anything shown on hover. The panel still closes the moment the pointer leaves the mark; reaching it with the pointer is `tooltipLingerMs`, which is `0` — see the actionable item of the same name. Nothing in your code changes. One thing will notice: a rule of yours setting `pointer-events` on `.ds-chart-tooltip-pane` decides whether the panel can be selected at all, and must stay `auto`.",
|
|
229
|
+
"Every chart gained `pinOnClick`, off by default. With it set, clicking a mark holds that mark, its tooltip and — where `dimOthers` is on — the dimming of the other marks, until Escape or a press outside releases it. The click output fires either way. On `ds-line-chart` the pin hangs off the data markers, so Enter and Space pin from the keyboard too.",
|
|
230
|
+
"`ds-progress` takes a `target`: a second point on the same 0–100 scale, drawn as a hairline across the track so a bar reads actual against a goal or a baseline. It is clamped like `value`, ignored while `indeterminate`, and unset draws nothing, so every existing bar is unchanged. `role=\"progressbar\"` carries one value and no second, so the mark is visual only — put the comparison in `ariaLabel`. `--ds-progress-target-color` and `--ds-progress-target-width` set its look. It also takes `max`, the scale `value` and `target` are read against: left at 100 they stay percentages and nothing existing changes, while setting the real total makes `aria-valuenow` and `aria-valuemax` carry the measurement rather than a percentage the caller had to compute.",
|
|
231
|
+
"Clicking a mark on ds-donut-chart, ds-funnel-chart or ds-line-chart no longer leaves a rectangular outline around it. Chromium focuses an SVG shape on click even without a tabindex and reports that focus as not :focus-visible, so the browser painted its own bounding-box outline. The marks suppress it on :focus now; the keyboard indicator is a stroke that follows the shape and is unchanged. A screenshot test that captured a clicked slice or band will differ.",
|
|
232
|
+
"A ds-column-chart tooltip opens far enough above the column to clear the value that showValues prints on top of it. Nothing in your code changes; a test asserting the panel position relative to the column will see it roughly one text line higher.",
|
|
233
|
+
"`ds-line-chart` takes `annotations`: labels pinned over their readings, each naming a `categoryIndex`, a `label` and optionally the `seriesId` it belongs to. Nothing is drawn without them, so every existing chart is unchanged. A label sits above its reading, below it where the plot has no room, and anchors to its own edge near one; a hidden series takes its annotations with it. Marked `aria-hidden`, because the annex table already carries every reading. `--ds-line-chart-annotation-color`, `-font-size`, `-weight`, `-halo-color` and `-halo-width` set its look.",
|
|
234
|
+
"A drag across a chart no longer selects its chrome: axis ticks, legend labels and the visually-hidden caption came out selected and painted as bars over the card. The plot is `user-select: none` now. The annex table, the funnel's stage table and the visible caption stay selectable — those carry numbers people copy.",
|
|
235
|
+
"A pinned mark carries a pushpin on an opaque disc on all five charts, and an `Unpin` button appears centred above the plot while anything is pinned. Nothing in your code changes; a screenshot test of a pinned chart will differ.",
|
|
236
|
+
"`ds-line-chart` places its first reading ON the value axis and its last at the far edge, instead of centring each reading in a slot. The line now fills the plot rather than floating half a slot inside it. Nothing in your code changes. Two things will notice: a screenshot test of a line chart, and any test asserting a marker x — the spacing between readings is now the plot width divided by one less than the reading count.",
|
|
237
|
+
"A `ds-bar-chart` row takes `segments`: parts that divide the row’s bar without shortening it, sized against their own sum so they always fill it. The bar keeps the length its `value` earns, each part takes the categorical palette in order, and each reaches the annex table as its own row. Rows without `segments` are unchanged.",
|
|
238
|
+
"A `ds-bar-chart` row takes `detail`: a second, already-formatted reading printed under the label and carried into the annex table, for a row that encodes a ratio the bar can only draw half of. Rows without it are unchanged.",
|
|
239
|
+
"`ds-line-chart` takes `max` and `maxSecondary`, which pin the value axis so two renders of the same panel are comparable. Null, the default, keeps the derived axis; a maximum below the data does not clip it, because the larger of the two wins.",
|
|
240
|
+
"`ds-funnel-chart` takes `drop`, which says what its Drop column reports: `relative` (the default, and what it always showed) is the share that leaked at that stage, `absolute` the count, `none` removes the column. Charts that set nothing are unchanged.",
|
|
241
|
+
"A `ds-chart-legend` in its isolate mode gained a `None` option and always keeps one option chosen, so the radio group can reach an empty plot and never reads as undecided. Each legend now scopes its radio group to itself, so several charts on one page no longer share a single selection.",
|
|
242
|
+
"`ds-meter` is new: one track and one fill for a measurement inside a table cell, taking `value`, `max`, `color` and `ariaLabel`. It is the in-cell alternative to a chart, and is not `ds-progress` — it carries `role=\"meter\"` only when `ariaLabel` names it, and is `aria-hidden` otherwise. Nothing existing changes.",
|
|
243
|
+
"A pinned mark offers an `Unpin` control: `ds-bar-chart`, `ds-column-chart`, `ds-donut-chart` and `ds-funnel-chart` render a pill button above the plot while one is held, and `ds-donut-chart` and `ds-funnel-chart` draw a pin glyph at the pinned slice or band. The glyph takes no pointer events. `--ds-chart-pin-size` sizes it and the button carries `.pin-reset`; nothing in your code changes, and a chart with no pin shows neither.",
|
|
244
|
+
"A toggleable `ds-chart-legend` in `isolate` mode offers a `None` control beside `All`, so the plot can be cleared in one action. Additive: the existing controls and the `hidden` model are unchanged.",
|
|
245
|
+
"Two legends on one page no longer share a selection. The isolate controls are radios and every legend named the same group, so a page with several charts formed one document-wide group — choosing a series in one cleared the others, and only the last-rendered legend showed a selection. Each legend names its own group now, and a leftover partial state settles on `All` rather than leaving nothing chosen. Nothing in your code changes.",
|
|
246
|
+
"`ds-line-chart` keeps its height when the last series is switched off. The empty message reserved `--ds-line-chart-plot-height` alone while the plot is an SVG sized by its ratio against the card width, so on a wider card the box came up short and the card jumped. It reserves the canvas ratio now, with the token as the floor."
|
|
247
|
+
],
|
|
248
|
+
"deleteList": [
|
|
249
|
+
{
|
|
250
|
+
"id": "chart-frame-css-override",
|
|
251
|
+
"surface": "style",
|
|
252
|
+
"find": [
|
|
253
|
+
"--ds-chart-frame-border-width",
|
|
254
|
+
"--ds-chart-frame-padding: 0"
|
|
255
|
+
],
|
|
256
|
+
"why": "the frame is an input and an app-wide config key now, so stripping it no longer means reaching into the component’s own chrome",
|
|
257
|
+
"replaceWith": "`frame=\"none\"` on the chart, or `provideDsConfig({ chart: { frame: \"none\" } })` for the app"
|
|
258
|
+
},
|
|
259
|
+
{
|
|
260
|
+
"id": "chart-data-table-none-binding",
|
|
261
|
+
"surface": "template",
|
|
262
|
+
"find": [
|
|
263
|
+
"dataTable=\"none\""
|
|
264
|
+
],
|
|
265
|
+
"why": "the annex table is off by default, so the binding restates the default",
|
|
266
|
+
"replaceWith": "nothing — keep it only where the app-wide default is `toggle` and this one chart differs"
|
|
267
|
+
}
|
|
268
|
+
]
|
|
269
|
+
}
|
|
@@ -0,0 +1,211 @@
|
|
|
1
|
+
{
|
|
2
|
+
"version": "0.13.3",
|
|
3
|
+
"items": [
|
|
4
|
+
{
|
|
5
|
+
"id": "progress-renamed-to-bar",
|
|
6
|
+
"kind": "selector-rename",
|
|
7
|
+
"old": "ds-progress",
|
|
8
|
+
"new": "ds-bar",
|
|
9
|
+
"surface": [
|
|
10
|
+
"template",
|
|
11
|
+
"typescript"
|
|
12
|
+
],
|
|
13
|
+
"action": "Rename every `<ds-progress>` element to `<ds-bar>`, and `ProgressComponent` to `BarComponent` imported from `@ids-group-ltd/ids-design-system/components/bar`. The type `ProgressVariant` is now `BarVariant` from the same entry point. Behaviour is unchanged — every input keeps its name and its default.",
|
|
14
|
+
"appliesWhen": "Every template rendering `<ds-progress>` and every file importing `ProgressComponent` or `ProgressVariant`. `ds-bar-chart` is a different component and keeps its name.",
|
|
15
|
+
"pitfall": "The old tag is an unknown element, not an error: Angular renders nothing and logs nothing outside strict schema mode, so a missed one is a bar that silently vanished. `ds-bar` is a prefix of `ds-bar-chart`, which is a DIFFERENT component and is NOT renamed. Match on a word boundary and confirm the tag ends there; rename nothing whose name continues past `ds-bar`.",
|
|
16
|
+
"restore": null,
|
|
17
|
+
"searchHints": [
|
|
18
|
+
"ds-progress",
|
|
19
|
+
"ProgressComponent",
|
|
20
|
+
"ProgressVariant",
|
|
21
|
+
"components/progress"
|
|
22
|
+
],
|
|
23
|
+
"detect": [
|
|
24
|
+
"ds-progress",
|
|
25
|
+
"ProgressComponent",
|
|
26
|
+
"ProgressVariant"
|
|
27
|
+
],
|
|
28
|
+
"verify": "No `ds-progress` tag, `ProgressComponent` or `ProgressVariant` symbol, or `components/progress` import path remains, and every `ds-bar-chart` is still spelled in full.",
|
|
29
|
+
"note": "The progress bar and the measurement bar were the same drawing under two names, so they are one component under a neutral one. A rename alone is a complete and behaviour-preserving upgrade for a progress bar; see `bar-semantics-says-what-the-bar-is` for what the merged component can now additionally say."
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"id": "meter-renamed-to-bar",
|
|
33
|
+
"kind": "selector-rename",
|
|
34
|
+
"old": "ds-meter",
|
|
35
|
+
"new": "ds-bar",
|
|
36
|
+
"surface": [
|
|
37
|
+
"template",
|
|
38
|
+
"typescript"
|
|
39
|
+
],
|
|
40
|
+
"action": "Rename every `<ds-meter>` element to `<ds-bar>` and `MeterComponent` to `BarComponent` from `@ids-group-ltd/ids-design-system/components/bar`. Then give each one a `semantics` — `\"none\"` where it had no `ariaLabel`, `\"meter\"` where it had one. Without that the bar announces as a progress bar.",
|
|
41
|
+
"appliesWhen": "Only code written against `0.13.2`, the single release `ds-meter` existed in. `ds-bar-chart` is a different component and keeps its name.",
|
|
42
|
+
"pitfall": "The rename alone compiles, renders identically, and silently changes what assistive technology hears: `ds-meter` was `aria-hidden` unless `ariaLabel` named it, and `ds-bar` defaults to `semantics=\"progress\"`. A table of two hundred rates that announced nothing now announces two hundred progress bars. `ds-bar` is a prefix of `ds-bar-chart`, which is a DIFFERENT component and is NOT renamed. Match on a word boundary and confirm the tag ends there; rename nothing whose name continues past `ds-bar`.",
|
|
43
|
+
"restore": null,
|
|
44
|
+
"searchHints": [
|
|
45
|
+
"ds-meter",
|
|
46
|
+
"MeterComponent",
|
|
47
|
+
"components/meter"
|
|
48
|
+
],
|
|
49
|
+
"detect": [
|
|
50
|
+
"ds-meter",
|
|
51
|
+
"MeterComponent"
|
|
52
|
+
],
|
|
53
|
+
"verify": "No `ds-meter` tag or `MeterComponent` symbol remains, and every bar that replaced one carries `semantics=\"none\"` or `semantics=\"meter\"` — never the default.",
|
|
54
|
+
"note": "The `semantics` step is not optional bookkeeping: it is the whole reason `ds-meter` existed, carried across as an input. `0.13.2` is the only release that shipped the tag, so an app on `0.13.1` or earlier has nothing to do here."
|
|
55
|
+
},
|
|
56
|
+
{
|
|
57
|
+
"id": "bar-semantics-says-what-the-bar-is",
|
|
58
|
+
"kind": "behavior",
|
|
59
|
+
"old": "ds-bar[semantics]",
|
|
60
|
+
"new": null,
|
|
61
|
+
"surface": "template",
|
|
62
|
+
"action": "Add `semantics=\"none\"` to every `ds-bar` rendered per row of a table or list whose figure is printed beside it, and `semantics=\"meter\"` to one that is the only place a measurement appears. A bar reporting how far a task has got needs nothing — that is the default.",
|
|
63
|
+
"appliesWhen": "Only bars that are NOT reporting a task. An upload bar, a step counter or a job indicator keeps the default and is unchanged.",
|
|
64
|
+
"pitfall": "Nothing errors and nothing looks different — the drawing is identical either way. The cost lands in the accessibility tree, where a per-row bar left at the default reads out a percentage the row already states.",
|
|
65
|
+
"restore": "Leave `semantics` unset. The default is `progress`, which is what `ds-progress` always did.",
|
|
66
|
+
"searchHints": [
|
|
67
|
+
"ds-bar",
|
|
68
|
+
"semantics",
|
|
69
|
+
"dsCellTemplate"
|
|
70
|
+
],
|
|
71
|
+
"detect": [
|
|
72
|
+
"ds-bar",
|
|
73
|
+
"dsCellTemplate",
|
|
74
|
+
"role=\"progressbar\""
|
|
75
|
+
],
|
|
76
|
+
"verify": "Every `ds-bar` rendered once per row carries `semantics=\"none\"` or `semantics=\"meter\"`, and a screen-reader pass over a data table announces no progress bar per row.",
|
|
77
|
+
"note": "The merged component can state what it is, which neither `ds-progress` nor a bare `ds-meter` could express per instance. Defaulting to `progress` is what keeps the `ds-progress` rename silent and behaviour-preserving."
|
|
78
|
+
},
|
|
79
|
+
{
|
|
80
|
+
"id": "progress-and-meter-tokens-renamed-to-bar",
|
|
81
|
+
"kind": "token-rename",
|
|
82
|
+
"old": "--ds-progress-*",
|
|
83
|
+
"new": "--ds-bar-*",
|
|
84
|
+
"surface": "style",
|
|
85
|
+
"action": "Rename `--ds-progress-height`, `-track-color`, `-target-color` and `-target-width` to `--ds-bar-…` with the same suffix. `--ds-progress-bar-color` and its `-success` / `-warning` / `-error` siblings become `--ds-bar-fill-color`, `--ds-bar-fill-color-success`, `--ds-bar-fill-color-warning`, `--ds-bar-fill-color-error`. The `--ds-meter-*` names go the same way: `-height`, `-min-width`, `-track-color`, `-radius` keep their suffix and `--ds-meter-fill-color` becomes `--ds-bar-fill-color`. The global `--progress-h` is now `--bar-h`.",
|
|
86
|
+
"appliesWhen": "Any stylesheet setting one of those names. DS tokens only — a consumer's own `--progress-…` variable is untouched, and so are `--stepper-bar-h` and `--calendar-bar-h`, which are different tokens that merely end in `-bar-h`.",
|
|
87
|
+
"pitfall": "An override of a name nothing reads still parses and cascades, so a missed rename changes nothing and reports nothing: the bar quietly returns to its default look. `ds-bar` is a prefix of `ds-bar-chart`, which is a DIFFERENT component and is NOT renamed. Match on a word boundary and confirm the tag ends there; rename nothing whose name continues past `ds-bar`.",
|
|
88
|
+
"restore": null,
|
|
89
|
+
"searchHints": [
|
|
90
|
+
"--ds-progress-",
|
|
91
|
+
"--ds-meter-",
|
|
92
|
+
"--progress-h",
|
|
93
|
+
"bar-color"
|
|
94
|
+
],
|
|
95
|
+
"detect": [
|
|
96
|
+
"--ds-progress-",
|
|
97
|
+
"--ds-meter-",
|
|
98
|
+
"--progress-h"
|
|
99
|
+
],
|
|
100
|
+
"verify": "No `--ds-progress-`, `--ds-meter-` or `--progress-h` name remains in the app's stylesheets, and every bar that was restyled still looks restyled.",
|
|
101
|
+
"note": "`bar-color` became `fill-color` because the component is now the bar and `--ds-bar-bar-color` would stutter. `--progress-h` moved with it: same 6px default, under a name that no longer described the component."
|
|
102
|
+
},
|
|
103
|
+
{
|
|
104
|
+
"id": "exported-class-members-moved",
|
|
105
|
+
"kind": "behavior",
|
|
106
|
+
"old": "ProgressComponent",
|
|
107
|
+
"new": null,
|
|
108
|
+
"surface": "typescript",
|
|
109
|
+
"action": "Only if you SUBCLASS one of these and declare a member of the same name: rename yours, or add `override` where your member genuinely means the same thing. A subclass of `ProgressComponent` or `MeterComponent` has no base class any more — extend `BarComponent` and check `semantics`.",
|
|
110
|
+
"appliesWhen": "Only a class extending `BarComponent`, the two classes it replaces, or the internal chart tooltip directive, which the package root does not export. A template that uses the components needs nothing.",
|
|
111
|
+
"pitfall": "The collision is a compile error, not a silent one — TS4114 for a same-named member, TS2416 where the signature differs — so a build that passes has none. The silent half is a subclass of the OLD classes: that file stops resolving its import, which is also loud.",
|
|
112
|
+
"restore": null,
|
|
113
|
+
"searchHints": [
|
|
114
|
+
"extends BarComponent",
|
|
115
|
+
"extends ProgressComponent",
|
|
116
|
+
"extends MeterComponent",
|
|
117
|
+
"extends ChartTooltipDirective",
|
|
118
|
+
"dsChartTooltipPreferBelow",
|
|
119
|
+
"extends ColumnChartComponent",
|
|
120
|
+
"extends DonutChartComponent",
|
|
121
|
+
"extends FunnelChartComponent"
|
|
122
|
+
],
|
|
123
|
+
"detect": [
|
|
124
|
+
"extends BarComponent",
|
|
125
|
+
"BarComponent",
|
|
126
|
+
"extends ProgressComponent",
|
|
127
|
+
"ProgressComponent",
|
|
128
|
+
"extends MeterComponent",
|
|
129
|
+
"MeterComponent",
|
|
130
|
+
"extends ChartTooltipDirective",
|
|
131
|
+
"ChartTooltipDirective",
|
|
132
|
+
"extends ColumnChartComponent",
|
|
133
|
+
"ColumnChartComponent",
|
|
134
|
+
"extends DonutChartComponent",
|
|
135
|
+
"DonutChartComponent",
|
|
136
|
+
"extends FunnelChartComponent",
|
|
137
|
+
"FunnelChartComponent"
|
|
138
|
+
],
|
|
139
|
+
"verify": "No subclass declares a member named `semantics`, `color`, `role` or `dsChartTooltipPreferBelow`, and the app builds with no TS4114, TS2415 or TS2416 on those classes.",
|
|
140
|
+
"note": "Merging the progress bar and the measurement bar moved every member of both onto one class, and the tooltip directive gained the input that opens a pinned panel below its mark. The three chart components grew as well: the column chart moved its drawing into the shared container and took several series, gaining `thresholds`, `categories`, `geometry`, `tableRows`, `viewHeightPx`, `skeletonHeightPx`, `stack`, `resolvedSeries`, `seriesRefs`, `pinnedSeries`, `slotCount`, `offsets`, `offsetsFor`, `multiSeries`, `legendItems` and `axisFormat` while losing the members that drew its marks; the donut gained `partOfWhole`, `arcAt`, `isDimmed` and three legend handlers; the funnel gained `isDimmed` and `onRowEnter`. Subclassing a DS component is unsupported, but a release that only merges and adds can still fail such a build on a name collision."
|
|
141
|
+
},
|
|
142
|
+
{
|
|
143
|
+
"id": "chart-value-format-receives-tick-or-tooltip-location",
|
|
144
|
+
"kind": "behavior",
|
|
145
|
+
"old": "ChartValueFormat",
|
|
146
|
+
"new": null,
|
|
147
|
+
"surface": "typescript",
|
|
148
|
+
"action": "Give your `valueFormat` callback a second parameter, `location: ChartFormatLocation` (`'tick' | 'tooltip'`), imported from `@ids-group-ltd/ids-design-system/core`. Return a compact string for `'tick'` and the full value for `'tooltip'`. A callback that ignores the parameter still compiles and still runs.",
|
|
149
|
+
"appliesWhen": "The `action` above is only for a `ds-column-chart` or `ds-line-chart` with a custom `valueFormat` bound, as an input or through `DS_CONFIG.chart.valueFormat`: that is who has code to touch. A chart left on the built-in default needs no code change, but its own rendered ticks changed too; see the informational note about the built-in default below.",
|
|
150
|
+
"pitfall": "Nothing throws and the build stays green. TypeScript allows an implementation with fewer parameters than its declared type, and JavaScript ignores an argument nothing reads, so a one-argument callback keeps compiling and keeps running. It now also runs for every axis tick, and an implementation that returns the full value regardless of location prints that same full value on the axis, clipped by the fixed-width axis column, which is the defect this release fixes only for the built-in default.",
|
|
151
|
+
"restore": null,
|
|
152
|
+
"searchHints": [
|
|
153
|
+
"valueFormat",
|
|
154
|
+
"ChartValueFormat",
|
|
155
|
+
"ChartFormatLocation",
|
|
156
|
+
"chart.valueFormat"
|
|
157
|
+
],
|
|
158
|
+
"detect": [
|
|
159
|
+
"valueFormat]=\"",
|
|
160
|
+
"valueFormat:",
|
|
161
|
+
"(value: number) =>",
|
|
162
|
+
"chart: { valueFormat:"
|
|
163
|
+
],
|
|
164
|
+
"verify": "Every custom `valueFormat` bound on a `ds-column-chart` or `ds-line-chart` reads its second argument, and the value axis on such a chart prints a compact label rather than the full number.",
|
|
165
|
+
"note": "The axis tick and the annex table used to share one formatter call with no way to tell them apart, so a formatter written to spell the table's values out in full also ran, unchanged, on the axis. `location` is what lets one callback serve both without a chart-side special case for its own default."
|
|
166
|
+
},
|
|
167
|
+
{
|
|
168
|
+
"id": "column-chart-data-accepts-a-series-list",
|
|
169
|
+
"kind": "behavior",
|
|
170
|
+
"old": "ds-column-chart[data]",
|
|
171
|
+
"new": null,
|
|
172
|
+
"surface": "typescript",
|
|
173
|
+
"action": "Where the `data` signal is READ BACK or the input is redeclared, narrow on the shape first: `'data' in entry` is a `ColumnChartSeries`, otherwise a `ColumnChartPoint`. Binding a flat `ColumnChartPoint[]` needs no change at all.",
|
|
174
|
+
"appliesWhen": "Only code that reads `ds-column-chart`'s own `data` signal back through a template reference or a `viewChild`, or a subclass redeclaring `data`. Every consumer that only PASSES an array is unaffected, whatever its shape.",
|
|
175
|
+
"pitfall": "A reader breaks at compile time and a writer does not, so a build that passes has no reader left to fix. The silent half is a runtime narrowing written the other way round - testing for `value` rather than for `data` - which treats an empty series list as a point list and draws nothing.",
|
|
176
|
+
"restore": null,
|
|
177
|
+
"searchHints": [
|
|
178
|
+
"ds-column-chart",
|
|
179
|
+
"ColumnChartPoint",
|
|
180
|
+
"ColumnChartSeries",
|
|
181
|
+
"ColumnChartComponent"
|
|
182
|
+
],
|
|
183
|
+
"detect": [
|
|
184
|
+
"extends ColumnChartComponent",
|
|
185
|
+
".data()[",
|
|
186
|
+
"viewChild(ColumnChartComponent",
|
|
187
|
+
"ColumnChartComponent)",
|
|
188
|
+
"readonly data = input"
|
|
189
|
+
],
|
|
190
|
+
"verify": "Every place that reads a `ds-column-chart`'s `data` signal back narrows on the entry's shape before touching `value` or `label`, and the app builds with no TS2339 or TS2416 on `ColumnChartComponent`.",
|
|
191
|
+
"note": "`data` was `readonly ColumnChartPoint[]` and is now `readonly ColumnChartPoint[] | readonly ColumnChartSeries[]`, so one chart can carry several named series. Widening an input is source-compatible for whoever writes the value and breaking for whoever reads it back or overrides it: an input signal's type is invariant, so a redeclaration fails even where the values are compatible."
|
|
192
|
+
}
|
|
193
|
+
],
|
|
194
|
+
"informational": [
|
|
195
|
+
"`ds-column-chart` takes a list of named series on `data` as well as the flat list of points it already took, and a `stack` input (`'none'` | `'grouped'` | `'stacked'` | `'normalized'`) deciding how they share a category's band. A chart passing a flat list is unaffected: it stays one series across the whole band, coloured by point position, and `stack` defaults to `'none'`. A series list draws a legend under the plot and colours each series as a whole. See `column-chart-data-accepts-a-series-list` for the only code this can break.",
|
|
196
|
+
"`stack=\"stacked\"` on `ds-column-chart` and `axisMode=\"stacked\"` on `ds-line-chart` are different things: series drawn on top of each other, against two plots one above the other. Neither input changed; the words collide only when read side by side.",
|
|
197
|
+
"`ds-bar` carries everything `ds-progress` had — `value`, `max`, `variant`, `indeterminate`, `target` and `ariaLabel` keep their names and defaults — so for a progress bar the rename alone is the whole upgrade. It adds `semantics` and `color`.",
|
|
198
|
+
"`indeterminate` is now ignored unless `semantics` is `progress`. Only a task has an unknown duration, and the input was never meaningful on a measurement. Nothing that used it on `ds-progress` is affected, because that is the default.",
|
|
199
|
+
"The bar carries `min-inline-size: 3rem` (`--ds-bar-min-width`). `ds-progress` had none, so a bar inside a content-sized column or a shrink-to-fit flex item that used to collapse to nothing is now visible. Set the property to `0` to get the old collapsing behaviour back.",
|
|
200
|
+
"Chart tooltips sit closer to their marks: the gap went from 12px to 6px, and `ds-bar-chart` anchors its panel to the bar rather than to the whole row, which was opening it 46.7px away. Nothing in your code changes; a screenshot test of a chart with a tooltip open will differ.",
|
|
201
|
+
"While a mark is pinned its panel opens BELOW the mark, so it no longer covers the Unpin control at the plot's top edge. Moving the pin between marks no longer unmounts that control for a frame.",
|
|
202
|
+
"The focus indicator on a chart mark is now the app's `--focus-ring-color` with a light keyline, instead of a white ring with a dark halo. Override `--ds-chart-focus-ring-color` and `--ds-chart-focus-halo-color` to keep the old pair.",
|
|
203
|
+
"`ds-line-chart` and `ds-column-chart` draw their axes behind the empty, error and no-visible-series messages. No ticks and no labels, because there is no data to scale them against.",
|
|
204
|
+
"The `pin` icon is redrawn as a drawing pin seen from the side. Any `<ds-icon name=\"pin\">` in your app changes shape.",
|
|
205
|
+
"The built-in default `valueFormat` on `ds-column-chart` and `ds-line-chart` now compacts each axis tick by that tick's own magnitude (`Intl.NumberFormat`'s `notation: 'compact'`), where the previous default picked one suffix for the whole axis from its step. An axis whose ticks cross a thousand, million or billion boundary can now print more than one suffix, `1M` beside `800K` where it used to print `1000K` beside `800K`. Nothing in your code changes; a screenshot of such an axis will differ.",
|
|
206
|
+
"Hovering or focusing a legend item on `ds-donut-chart`, or a stage row on `ds-funnel-chart`, now opens the same tooltip over the MARK it names and dims the rest of the plot, exactly as pointing at the arc or the bar does. Nothing to change: it affects what a pointer does, not what a template declares.",
|
|
207
|
+
"`ds-donut-chart` gains `partOfWhole`, defaulting to true. A ring's legend, tooltip and data table always stated each slice's share before this input existed; `partOfWhole` only adds the opt-out that was previously impossible — `[partOfWhole]=\"false\"` drops it from all three. Nothing changes for an existing consumer.",
|
|
208
|
+
"`ds-chart`, the container the column and line charts are built inside, now ships as its own entry point, `@ids-group-ltd/ids-design-system/components/chart`, together with the column and line series marks, the reference line and label marks, their data types, the scales token and the two geometry helpers. Purely additive - nothing to change. Reach for one of the five presets first; the container is the escape hatch for a plot none of them draws, such as columns and a cumulative line on two axes. It is not re-exported from the package facade, so it is imported by its own path. A mark is an ATTRIBUTE selector on a real `<svg:g>` (`<svg:g dsColumnSeries>`), never an element of its own, because an element the SVG specification does not know renders nothing and neither do its children."
|
|
209
|
+
],
|
|
210
|
+
"deleteList": []
|
|
211
|
+
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ids-group-ltd/ids-design-system",
|
|
3
|
-
"version": "0.13.
|
|
3
|
+
"version": "0.13.3",
|
|
4
4
|
"description": "IDS Group Angular design system: components, tokens, themes",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"homepage": "https://ids-ds.proto.ids-group.co.uk/",
|
|
@@ -65,6 +65,10 @@
|
|
|
65
65
|
"types": "./types/ids-group-ltd-ids-design-system-components-banner.d.ts",
|
|
66
66
|
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs"
|
|
67
67
|
},
|
|
68
|
+
"./components/bar": {
|
|
69
|
+
"types": "./types/ids-group-ltd-ids-design-system-components-bar.d.ts",
|
|
70
|
+
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs"
|
|
71
|
+
},
|
|
68
72
|
"./components/bar-chart": {
|
|
69
73
|
"types": "./types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts",
|
|
70
74
|
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs"
|
|
@@ -93,6 +97,10 @@
|
|
|
93
97
|
"types": "./types/ids-group-ltd-ids-design-system-components-card.d.ts",
|
|
94
98
|
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-card.mjs"
|
|
95
99
|
},
|
|
100
|
+
"./components/chart": {
|
|
101
|
+
"types": "./types/ids-group-ltd-ids-design-system-components-chart.d.ts",
|
|
102
|
+
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs"
|
|
103
|
+
},
|
|
96
104
|
"./components/chart-legend": {
|
|
97
105
|
"types": "./types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts",
|
|
98
106
|
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs"
|
|
@@ -221,10 +229,6 @@
|
|
|
221
229
|
"types": "./types/ids-group-ltd-ids-design-system-components-popover.d.ts",
|
|
222
230
|
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs"
|
|
223
231
|
},
|
|
224
|
-
"./components/progress": {
|
|
225
|
-
"types": "./types/ids-group-ltd-ids-design-system-components-progress.d.ts",
|
|
226
|
-
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs"
|
|
227
|
-
},
|
|
228
232
|
"./components/radio-group": {
|
|
229
233
|
"types": "./types/ids-group-ltd-ids-design-system-components-radio-group.d.ts",
|
|
230
234
|
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs"
|
|
@@ -397,6 +401,10 @@
|
|
|
397
401
|
"types": "./types/ids-group-ltd-ids-design-system-components-banner.d.ts",
|
|
398
402
|
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs"
|
|
399
403
|
},
|
|
404
|
+
"./bar": {
|
|
405
|
+
"types": "./types/ids-group-ltd-ids-design-system-components-bar.d.ts",
|
|
406
|
+
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs"
|
|
407
|
+
},
|
|
400
408
|
"./bar-chart": {
|
|
401
409
|
"types": "./types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts",
|
|
402
410
|
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs"
|
|
@@ -425,6 +433,10 @@
|
|
|
425
433
|
"types": "./types/ids-group-ltd-ids-design-system-components-card.d.ts",
|
|
426
434
|
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-card.mjs"
|
|
427
435
|
},
|
|
436
|
+
"./chart": {
|
|
437
|
+
"types": "./types/ids-group-ltd-ids-design-system-components-chart.d.ts",
|
|
438
|
+
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs"
|
|
439
|
+
},
|
|
428
440
|
"./chart-legend": {
|
|
429
441
|
"types": "./types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts",
|
|
430
442
|
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs"
|
|
@@ -553,10 +565,6 @@
|
|
|
553
565
|
"types": "./types/ids-group-ltd-ids-design-system-components-popover.d.ts",
|
|
554
566
|
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs"
|
|
555
567
|
},
|
|
556
|
-
"./progress": {
|
|
557
|
-
"types": "./types/ids-group-ltd-ids-design-system-components-progress.d.ts",
|
|
558
|
-
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs"
|
|
559
|
-
},
|
|
560
568
|
"./radio-group": {
|
|
561
569
|
"types": "./types/ids-group-ltd-ids-design-system-components-radio-group.d.ts",
|
|
562
570
|
"default": "./fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs"
|