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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (102) hide show
  1. package/CHANGELOG.md +258 -0
  2. package/components.md +24 -14
  3. package/docs/agent/INDEX.md +1 -1
  4. package/docs/agent/charts/column-series-component.md +1 -1
  5. package/docs/agent/charts/ds-chart.md +3 -1
  6. package/docs/agent/charts/ds-line-chart.md +1 -1
  7. package/docs/agent/charts/line-series-component.md +1 -1
  8. package/docs/agent/forms/ds-search.md +1 -1
  9. package/docs/agent/forms/ds-switch.md +4 -2
  10. package/docs/agent/forms/ds-textarea.md +1 -0
  11. package/docs/agent/navigation/ds-pagination.md +2 -2
  12. package/docs/agent/platform/ds-config.md +2 -1
  13. package/docs/agent/tables/ds-cell-template.md +1 -1
  14. package/docs/agent/tables/ds-table.md +4 -3
  15. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +26 -19
  16. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs +2 -2
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs.map +1 -1
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs +13 -3
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-data-table.mjs.map +1 -1
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +2 -2
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +27 -14
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +366 -81
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -1
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +4 -4
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +2 -2
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +8 -17
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs +1 -1
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-heatmap-chart.mjs.map +1 -1
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +2 -2
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +6 -5
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +42 -6
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +17 -9
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs +8 -17
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-pie-chart.mjs.map +1 -1
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs +27 -5
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-scatter-chart.mjs.map +1 -1
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs +4 -0
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-search.mjs.map +1 -1
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs +23 -4
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-skeleton.mjs.map +1 -1
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +2 -2
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +20 -5
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs +2 -2
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-table-columns.mjs.map +1 -1
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +30 -22
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +2 -2
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +21 -0
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs +1 -1
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-waterfall-chart.mjs.map +1 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +91 -10
  66. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +2 -3
  68. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  69. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  70. package/migrations/0.12.2.json +4 -1
  71. package/migrations/0.13.3.json +32 -10
  72. package/migrations/0.13.4.json +1630 -132
  73. package/migrations/0.14.0.json +591 -0
  74. package/migrations/0.5.0.json +10 -4
  75. package/migrations/0.7.0.json +5 -2
  76. package/migrations/0.9.0.json +5 -2
  77. package/migrations/README.md +7 -2
  78. package/package.json +1 -1
  79. package/styles/_chart-frame.scss +4 -4
  80. package/styles/_chart-motion.scss +17 -10
  81. package/styles/_overlay-motion.scss +14 -6
  82. package/styles/_skeleton-shimmer.scss +4 -1
  83. package/styles/_tokens.scss +1 -1
  84. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +3 -5
  85. package/types/ids-group-ltd-ids-design-system-components-chart-data-table.d.ts +3 -0
  86. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +11 -3
  87. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +125 -26
  88. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +2 -0
  89. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +3 -5
  90. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +4 -1
  91. package/types/ids-group-ltd-ids-design-system-components-modal.d.ts +4 -0
  92. package/types/ids-group-ltd-ids-design-system-components-pagination.d.ts +15 -10
  93. package/types/ids-group-ltd-ids-design-system-components-pie-chart.d.ts +1 -4
  94. package/types/ids-group-ltd-ids-design-system-components-scatter-chart.d.ts +7 -1
  95. package/types/ids-group-ltd-ids-design-system-components-search.d.ts +2 -0
  96. package/types/ids-group-ltd-ids-design-system-components-skeleton.d.ts +1 -0
  97. package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +10 -1
  98. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +35 -24
  99. package/types/ids-group-ltd-ids-design-system-components-textarea.d.ts +13 -0
  100. package/types/ids-group-ltd-ids-design-system-components.d.ts +46 -3
  101. package/types/ids-group-ltd-ids-design-system-core.d.ts +13 -4
  102. package/types/ids-group-ltd-ids-design-system.d.ts +1 -1
@@ -1,10 +1,10 @@
1
1
  import * as _ids_group_ltd_ids_design_system_components from '@ids-group-ltd/ids-design-system/components';
2
- import { NiceDomain } from '@ids-group-ltd/ids-design-system/components';
2
+ import { NiceDomain, leaveMark } from '@ids-group-ltd/ids-design-system/components';
3
3
  import { ChartThresholdDash, ChartStackMode, ChartAxis, ChartFrame, ChartValueFormat, ChartAxisMode, ChartGaps, ChartCurve, ChartThreshold } from '@ids-group-ltd/ids-design-system/core';
4
- import * as _angular_core from '@angular/core';
5
- import { InjectionToken, Signal, OnDestroy } from '@angular/core';
6
4
  import * as _ids_group_ltd_ids_design_system_components_chart_tooltip from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
7
- import { ChartItemTooltipTrigger, ChartTooltipContext, ChartTooltipTrigger, ChartTooltipOrigin } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
5
+ import { ChartTooltipContext, ChartTooltipOrigin, ChartTooltipEntry, ChartItemTooltipTrigger, ChartTooltipTrigger } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
6
+ import * as _angular_core from '@angular/core';
7
+ import { InjectionToken, Signal, TemplateRef, OnDestroy } from '@angular/core';
8
8
  import { SafeHtml } from '@angular/platform-browser';
9
9
  import * as _ids_group_ltd_ids_design_system_components_chart from '@ids-group-ltd/ids-design-system/components/chart';
10
10
 
@@ -84,6 +84,19 @@ interface ChartStackOffset {
84
84
  readonly to: number;
85
85
  }
86
86
 
87
+ /** What a mark hands the container so the container can open the panel for it. The mark decides
88
+ * WHAT the panel says and WHERE it points; the container decides that there is one, which is what
89
+ * keeps a plot from opening two. */
90
+ interface ChartTooltipSource {
91
+ readonly context: Signal<ChartTooltipContext | null>;
92
+ readonly origin: Signal<ChartTooltipOrigin | null>;
93
+ /** Flips the panel under the mark, for a held reading whose own value label sits above it. */
94
+ readonly preferBelow?: Signal<boolean>;
95
+ /** What this mark reads at the category the cursor is on, whatever its own tooltip setting. A
96
+ * category panel names every series at that category, and a mark that answers per-mark still
97
+ * belongs in it. */
98
+ readonly axisEntries?: Signal<readonly ChartTooltipEntry[]>;
99
+ }
87
100
  /** The drawable rectangle inside `ds-chart`, in CSS pixels: the container measures itself and
88
101
  * sizes its `viewBox` so one user unit is one pixel. A length written into a mark is therefore
89
102
  * the length it says it is, at every card width. The gutters outside it carry the axis labels. */
@@ -103,6 +116,10 @@ interface ChartPlot {
103
116
  interface ChartScales {
104
117
  readonly categories: Signal<readonly string[]>;
105
118
  readonly plot: Signal<ChartPlot>;
119
+ /** Whether the plot has its real width yet. Until it does, the scales describe a stand-in width
120
+ * that the first measurement replaces, so a mark that waits for this builds its geometry once
121
+ * instead of twice. Absent means always measured. */
122
+ readonly measured?: Signal<boolean>;
106
123
  /** The CENTRE of a category's band. A mark with a width of its own subtracts half of
107
124
  * `bandWidth` to reach its leading edge. */
108
125
  readonly xPosition: Signal<(index: number) => number>;
@@ -140,6 +157,10 @@ interface ChartScales {
140
157
  reportDomain(id: string, values: readonly number[], axis?: ChartAxis): void;
141
158
  /** Withdraws a contribution, which a mark does in `ngOnDestroy`. */
142
159
  releaseDomain(id: string): void;
160
+ /** Offers the container a panel to open while this mark is the active one. Reporting again with
161
+ * the same id replaces the offer. */
162
+ reportTooltip(id: string, source: ChartTooltipSource): void;
163
+ releaseTooltip(id: string): void;
143
164
  }
144
165
  declare const CHART_SCALES: InjectionToken<ChartScales>;
145
166
 
@@ -236,10 +257,14 @@ declare class ChartComponent implements ChartScales {
236
257
  readonly errorTextResolved: Signal<string>;
237
258
  readonly valueFormatResolved: Signal<typeof _ids_group_ltd_ids_design_system_components.defaultChartFormat>;
238
259
  private readonly host;
260
+ private readonly zone;
261
+ private readonly isBrowser;
239
262
  /** The `<svg>`'s own rendered width: `:host(.framed)` carries the frame padding, so the host's
240
263
  * CONTENT box - which is what a `ResizeObserver` reports - is the box the canvas fills at
241
264
  * `inline-size: 100%`. Measuring the host is therefore measuring the canvas. */
242
265
  private readonly measuredWidth;
266
+ /** Server-rendered output has no width to wait for, so it draws at the stand-in. */
267
+ readonly measured: Signal<boolean>;
243
268
  protected readonly viewWidth: Signal<number>;
244
269
  /** Whether the marks may animate yet. The first frame draws at `CHART_FALLBACK_WIDTH` scaled to
245
270
  * fit, so the measurement that follows moves every mark - and a mark that transitions its
@@ -276,6 +301,16 @@ declare class ChartComponent implements ChartScales {
276
301
  * count, neither of which the gutter feeds, so widening it moves the labels without rewriting
277
302
  * them and the second measurement equals the first. */
278
303
  protected readonly effectiveAxisGutter: Signal<number>;
304
+ /** A rotated axis title stands in the same gutter as the tick labels, so the gutter has to carry
305
+ * both or the widest tick runs through the title. Its own width is its line height, because it
306
+ * is turned on its side. */
307
+ protected readonly axisTitleGutter: Signal<20 | 0>;
308
+ /** Where a rotated axis title sits: hard against the outer edge, with the tick labels between it
309
+ * and the plot. */
310
+ protected readonly axisTitleX: Signal<number>;
311
+ /** Mirrors `axisTitleX` against the right edge, so the two titles stand the same distance from
312
+ * their own ticks. */
313
+ protected readonly secondaryTitleX: Signal<number>;
279
314
  /** Widest secondary tick label, measured the same way and for the same reason as the primary
280
315
  * one: those labels sit OUTSIDE the plot's right edge and an SVG canvas clips what a DOM
281
316
  * column merely overflowed. */
@@ -283,12 +318,32 @@ declare class ChartComponent implements ChartScales {
283
318
  /** The plot gives the right-hand labels room only when they are drawn there - a stacked second
284
319
  * axis puts both label columns down the left, so the plot keeps the full width. */
285
320
  protected readonly rightGutter: Signal<number>;
321
+ /** The second axis's title stands in the right gutter exactly as the first one's stands in the
322
+ * left, so both sides reserve the same band and the plot sits centred between its two labels. */
323
+ protected readonly secondaryTitleGutter: Signal<20 | 0>;
286
324
  readonly plot: Signal<ChartPlot>;
287
325
  readonly secondaryPlot: Signal<ChartPlot>;
288
326
  private readonly reportedDomains;
289
327
  reportDomain(id: string, values: readonly number[], axis?: ChartAxis): void;
290
328
  private valuesOn;
291
329
  releaseDomain(id: string): void;
330
+ /** A template that replaces the panel's body, for a preset that prints more than label+value. */
331
+ readonly tooltipTemplate: _angular_core.InputSignal<TemplateRef<{
332
+ $implicit: ChartTooltipContext;
333
+ }> | null>;
334
+ /** Extra clearance between the mark and the panel, for a chart that prints a value label in
335
+ * the gap the panel would otherwise take. */
336
+ readonly tooltipExtraGap: _angular_core.InputSignalWithTransform<number, unknown>;
337
+ private readonly tooltipSources;
338
+ reportTooltip(id: string, source: ChartTooltipSource): void;
339
+ releaseTooltip(id: string): void;
340
+ /** The offer to show, if any mark is making one. At most one mark has a context at a time: a
341
+ * per-mark tooltip only fills it while that mark is hovered, and an axis tooltip only while the
342
+ * category cursor is on. The container opening the panel is what stops two marks opening two. */
343
+ private readonly activeTooltip;
344
+ protected readonly tooltipContext: Signal<ChartTooltipContext | null>;
345
+ protected readonly tooltipOrigin: Signal<_ids_group_ltd_ids_design_system_components_chart_tooltip.ChartTooltipOrigin | null>;
346
+ protected readonly tooltipPreferBelow: Signal<boolean>;
292
347
  /** Compared by value, which is what stops a mark that reports AND reads `yPosition()` in one
293
348
  * effect from running forever: every report allocates a fresh `Map` and `niceDomain` a fresh
294
349
  * object, so identity always differs and the read would re-arm the write. Measured without it:
@@ -336,8 +391,12 @@ declare class ChartComponent implements ChartScales {
336
391
  /** Whether the cursor is held. A preset renders its own way out of the pin from this. */
337
392
  readonly cursorPinned: Signal<boolean>;
338
393
  releaseCursor(): void;
339
- protected onPlotPointer(event: PointerEvent): void;
340
- protected clearCursor(): void;
394
+ private readonly canvasElement;
395
+ private canvasRect;
396
+ private plotPointer;
397
+ /** The plot listens to the pointer only when it draws a category cursor, and outside the zone:
398
+ * the handler writes signals, which schedule the render they need. */
399
+ private listenForCursor;
341
400
  private readonly bandElement;
342
401
  readonly cursorOrigin: Signal<Element | null>;
343
402
  setActiveIndex(index: number): void;
@@ -353,6 +412,7 @@ declare class ChartComponent implements ChartScales {
353
412
  y: number;
354
413
  label: string;
355
414
  }[]>;
415
+ private readonly labelTexts;
356
416
  /** Rotation is spent before thinning: a tilt costs the reader a glance, dropping a label costs
357
417
  * them a reading. Both are decided from the widest label as it actually rendered. */
358
418
  protected readonly categoryLabelsRotated: Signal<boolean>;
@@ -369,7 +429,7 @@ declare class ChartComponent implements ChartScales {
369
429
  protected readonly isEmpty: Signal<boolean>;
370
430
  protected readonly accessibleName: Signal<string>;
371
431
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartComponent, never>;
372
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartComponent, "ds-chart", ["dsChart"], { "categories": { "alias": "categories"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "cursor": { "alias": "cursor"; "required": false; "isSignal": true; }; "cursorPin": { "alias": "cursorPin"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "maxSecondary": { "alias": "maxSecondary"; "required": false; "isSignal": true; }; "plotHeight": { "alias": "plotHeight"; "required": false; "isSignal": true; }; "axisGutter": { "alias": "axisGutter"; "required": false; "isSignal": true; }; "valueSpace": { "alias": "valueSpace"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "secondaryAxisMode": { "alias": "secondaryAxisMode"; "required": false; "isSignal": true; }; "axisColor": { "alias": "axisColor"; "required": false; "isSignal": true; }; "secondaryAxisColor": { "alias": "secondaryAxisColor"; "required": false; "isSignal": true; }; "axisLabel": { "alias": "axisLabel"; "required": false; "isSignal": true; }; "secondaryAxisLabel": { "alias": "secondaryAxisLabel"; "required": false; "isSignal": true; }; }, {}, never, ["[dsReferenceLine]", "*", "[dsReferenceLabel], [dsSeriesAnnotation]"], true, never>;
432
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartComponent, "ds-chart", ["dsChart"], { "categories": { "alias": "categories"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "cursor": { "alias": "cursor"; "required": false; "isSignal": true; }; "cursorPin": { "alias": "cursorPin"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "maxSecondary": { "alias": "maxSecondary"; "required": false; "isSignal": true; }; "plotHeight": { "alias": "plotHeight"; "required": false; "isSignal": true; }; "axisGutter": { "alias": "axisGutter"; "required": false; "isSignal": true; }; "valueSpace": { "alias": "valueSpace"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "secondaryAxisMode": { "alias": "secondaryAxisMode"; "required": false; "isSignal": true; }; "axisColor": { "alias": "axisColor"; "required": false; "isSignal": true; }; "secondaryAxisColor": { "alias": "secondaryAxisColor"; "required": false; "isSignal": true; }; "axisLabel": { "alias": "axisLabel"; "required": false; "isSignal": true; }; "secondaryAxisLabel": { "alias": "secondaryAxisLabel"; "required": false; "isSignal": true; }; "tooltipTemplate": { "alias": "tooltipTemplate"; "required": false; "isSignal": true; }; "tooltipExtraGap": { "alias": "tooltipExtraGap"; "required": false; "isSignal": true; }; }, {}, never, ["[dsReferenceLine]", "*", "[dsReferenceLabel], [dsSeriesAnnotation]"], true, never>;
373
433
  }
374
434
 
375
435
  interface ColumnSeriesPoint {
@@ -387,6 +447,7 @@ interface ColumnSeriesPoint {
387
447
  * container's canvas would draw nothing. Written as `<svg:g dsColumnSeries>`.
388
448
  */
389
449
  declare class ColumnSeriesComponent implements OnDestroy {
450
+ protected readonly leaveMark: typeof leaveMark;
390
451
  private readonly scales;
391
452
  /** Not `input.required`: the preset reads `tooltipContext()` from a binding on this same
392
453
  * element, and a required input throws NG0950 for the pass before its own value is written. */
@@ -441,6 +502,11 @@ declare class ColumnSeriesComponent implements OnDestroy {
441
502
  /** Names the series in the tooltip, where the category then becomes the panel's heading. Unset,
442
503
  * the panel names the category instead, which is what a chart of one series has to say. */
443
504
  readonly seriesLabel: _angular_core.InputSignal<string | null>;
505
+ /** Identifies this series to the legend, so hovering a legend item can single it out. */
506
+ readonly seriesKey: _angular_core.InputSignal<string | null>;
507
+ /** The series the reader is pointing at in the legend. Every other series fades. */
508
+ readonly highlighted: _angular_core.InputSignal<string | null>;
509
+ protected readonly dimmedBySeries: _angular_core.Signal<boolean>;
444
510
  /** The clicked datum. Fires on click and on Enter or Space, whatever `interactive` says. */
445
511
  readonly pointClicked: _angular_core.OutputEmitterRef<ColumnSeriesPoint>;
446
512
  private readonly seriesId;
@@ -464,6 +530,19 @@ declare class ColumnSeriesComponent implements OnDestroy {
464
530
  * reservation costs nothing - the outer `<svg>` clips it - while falling short would leave a
465
531
  * strip under the plot that answers no pointer. */
466
532
  protected readonly hitHeight: _angular_core.Signal<number>;
533
+ /** Stacked series sit on top of one another, so a full-slot hit box on each one means only the
534
+ * series drawn last is ever reachable. Stacked, a mark catches the pointer over its own segment
535
+ * and nothing else. */
536
+ protected readonly stacked: _angular_core.Signal<boolean>;
537
+ /** Keeps a thin segment reachable without letting it reach into its neighbours. */
538
+ private static readonly MIN_STACK_HIT;
539
+ protected hitBox(mark: {
540
+ top: number;
541
+ height: number;
542
+ }): {
543
+ y: number;
544
+ height: number;
545
+ };
467
546
  protected readonly pinDiscRadius = 11;
468
547
  protected readonly pinGlyphSize = 14;
469
548
  protected readonly pinGlyphOffset: number;
@@ -485,23 +564,24 @@ declare class ColumnSeriesComponent implements OnDestroy {
485
564
  hatched: boolean;
486
565
  }[]>;
487
566
  protected markStagger(index: number): string;
488
- protected onMarkClick(payload: ColumnSeriesPoint, index: number, event: Event): void;
489
- protected onMarkEnter(index: number, event: Event): void;
490
- /** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
491
- * every mouse-operable control has to be separately focusable, and that is what keeps a
492
- * twenty-five mark chart from being twenty-five stops in the page's tab order. */
493
- protected readonly rovingIndex: _angular_core.WritableSignal<number>;
494
- protected readonly tabStopIndex: _angular_core.Signal<number>;
495
- protected onMarkFocus(index: number, event: FocusEvent): void;
496
- protected onMarkNavigation(event: KeyboardEvent, index: number): void;
497
- protected onPointKey(point: ColumnSeriesPoint, event: Event): void;
567
+ private readonly tooltipMark;
568
+ protected onMarkClick(event: MouseEvent): void;
569
+ protected onMarkOver(event: PointerEvent): void;
570
+ protected onMarkOut(event: PointerEvent): void;
571
+ protected readonly roving: _ids_group_ltd_ids_design_system_components.RovingMarks;
572
+ protected onMarkFocus(event: FocusEvent): void;
573
+ protected onMarkBlur(event: FocusEvent): void;
574
+ protected onMarkKey(event: KeyboardEvent): void;
498
575
  protected entryLabel(mark: {
499
576
  point: ColumnSeriesPoint;
500
577
  formattedValue: string;
501
578
  }): string;
579
+ /** This series' reading at the category the cursor is on. Filled whatever `tooltip` says: it
580
+ * feeds the container's category panel, never a panel of this mark's own. */
581
+ readonly axisEntries: _angular_core.Signal<readonly ChartTooltipEntry[]>;
502
582
  readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
503
583
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColumnSeriesComponent, never>;
504
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnSeriesComponent, "g[dsColumnSeries]", ["dsColumnSeries"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "columnWidthRatio": { "alias": "columnWidthRatio"; "required": false; "isSignal": true; }; "slot": { "alias": "slot"; "required": false; "isSignal": true; }; "slotCount": { "alias": "slotCount"; "required": false; "isSignal": true; }; "offsets": { "alias": "offsets"; "required": false; "isSignal": true; }; "seriesColor": { "alias": "seriesColor"; "required": false; "isSignal": true; }; "seriesFill": { "alias": "seriesFill"; "required": false; "isSignal": true; }; "seriesLabel": { "alias": "seriesLabel"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
584
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnSeriesComponent, "g[dsColumnSeries]", ["dsColumnSeries"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "partOfWhole": { "alias": "partOfWhole"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "columnWidthRatio": { "alias": "columnWidthRatio"; "required": false; "isSignal": true; }; "slot": { "alias": "slot"; "required": false; "isSignal": true; }; "slotCount": { "alias": "slotCount"; "required": false; "isSignal": true; }; "offsets": { "alias": "offsets"; "required": false; "isSignal": true; }; "seriesColor": { "alias": "seriesColor"; "required": false; "isSignal": true; }; "seriesFill": { "alias": "seriesFill"; "required": false; "isSignal": true; }; "seriesLabel": { "alias": "seriesLabel"; "required": false; "isSignal": true; }; "seriesKey": { "alias": "seriesKey"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
505
585
  }
506
586
 
507
587
  interface LineSeriesData {
@@ -530,6 +610,7 @@ interface LineSeriesData {
530
610
  * know is not rendered, and neither are its descendants. Written as `<svg:g dsLineSeries>`.
531
611
  */
532
612
  declare class LineSeriesComponent implements OnDestroy {
613
+ protected readonly leaveMark: typeof leaveMark;
533
614
  private readonly scales;
534
615
  /** Not `input.required`: the preset reads `tooltipContext()` from a binding on this same
535
616
  * element, and a required input throws NG0950 for the pass before its own value is written. */
@@ -537,6 +618,10 @@ declare class LineSeriesComponent implements OnDestroy {
537
618
  /** Draws a round marker at every reading. Off leaves the line alone, which reads better past
538
619
  * roughly twenty points. */
539
620
  readonly showMarkers: _angular_core.InputSignalWithTransform<boolean, unknown>;
621
+ /** Lays the line and its markers on a band of the surface colour, so they stay legible where
622
+ * they cross other marks. On by default: a line shares its plot more often than not, and on an
623
+ * empty plot the band only separates it from the gridlines. */
624
+ readonly outline: _angular_core.InputSignalWithTransform<boolean, unknown>;
540
625
  /** Turns on the click affordance - the pointer cursor and the hover tint. `pointClicked`
541
626
  * fires whether or not this is set. */
542
627
  readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -548,8 +633,8 @@ declare class LineSeriesComponent implements OnDestroy {
548
633
  readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
549
634
  /** The one series to single out: every other one draws faded and this one draws bold, so the
550
635
  * comparison survives a monochrome print. Driven from a legend, or from whatever else the app
551
- * uses to mean "show me this one". Needs `dimOthers`, which is what says fading is wanted at
552
- * all. */
636
+ * uses to mean "show me this one". Fades the others whether or not `dimOthers` is set, which
637
+ * governs only what a pointer over a marker does. */
553
638
  readonly highlighted: _angular_core.InputSignal<string | null>;
554
639
  /** A dash pattern per series, in the order the series are given. A series past the end of the
555
640
  * list, or given an empty string, draws solid. */
@@ -626,21 +711,35 @@ declare class LineSeriesComponent implements OnDestroy {
626
711
  * every mouse-operable control has to be separately focusable, which is what keeps a
627
712
  * 12-category, 2-series plot from being twenty-four stops in the page's tab order. */
628
713
  private readonly rovingBySeries;
714
+ private readonly firstMarkerBySeries;
629
715
  protected isTabStop(seriesId: string, markIndex: number): boolean;
630
716
  /** The series a marker holds focus on, which narrows an `'axis'` panel to that one reading: a
631
717
  * pointer answers for every series at once, a focused marker answers for its own. */
632
718
  private readonly focusedSeries;
633
- protected onMarkerEnter(markIndex: number, event: Event): void;
634
- protected onMarkerFocus(markIndex: number, event: FocusEvent): void;
635
- protected onMarkerBlur(): void;
636
- protected onMarkerNavigation(event: KeyboardEvent, markIndex: number): void;
719
+ /** A reading is active when its own marker is hovered OR when the category cursor is on its
720
+ * category: one band, one answer, so the dot grows wherever in the band the pointer is rather
721
+ * than only on the 4px dot itself. */
722
+ protected isActiveMarker(marker: {
723
+ markIndex: number;
724
+ categoryIndex: number;
725
+ }): boolean;
726
+ protected onMarkerOver(event: PointerEvent): void;
727
+ protected onMarkerOut(event: PointerEvent): void;
728
+ protected onMarkerFocus(event: FocusEvent): void;
729
+ protected onMarkerBlur(event: FocusEvent): void;
730
+ protected onMarkerKey(event: KeyboardEvent): void;
637
731
  protected isDimmed(seriesId: string): boolean;
638
- protected onMarkerClick(markIndex: number, event?: Event): void;
732
+ protected onMarkerClick(event: MouseEvent): void;
733
+ private selectMarker;
639
734
  protected markerLabel(marker: {
640
735
  seriesLabel: string;
641
736
  category: string;
642
737
  formattedValue: string;
643
738
  }): string;
739
+ /** What this series reads at the category the cursor is on, whatever `tooltip` says. It feeds
740
+ * the container's category panel, so one band answers for every mark on the plot rather than
741
+ * each mark owning a hover field of its own. */
742
+ readonly axisEntries: _angular_core.Signal<readonly ChartTooltipEntry[]>;
644
743
  readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
645
744
  private readonly markerElements;
646
745
  /** The topmost reading at the active category, as its own element. The cursor band spans the
@@ -655,7 +754,7 @@ declare class LineSeriesComponent implements OnDestroy {
655
754
  * blank one. */
656
755
  private readonly axisTooltipContext;
657
756
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<LineSeriesComponent, never>;
658
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineSeriesComponent, "g[dsLineSeries]", ["dsLineSeries"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showMarkers": { "alias": "showMarkers"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; "patterns": { "alias": "patterns"; "required": false; "isSignal": true; }; "stacked": { "alias": "stacked"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "gaps": { "alias": "gaps"; "required": false; "isSignal": true; }; "curve": { "alias": "curve"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
757
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineSeriesComponent, "g[dsLineSeries]", ["dsLineSeries"], { "data": { "alias": "data"; "required": false; "isSignal": true; }; "showMarkers": { "alias": "showMarkers"; "required": false; "isSignal": true; }; "outline": { "alias": "outline"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; "patterns": { "alias": "patterns"; "required": false; "isSignal": true; }; "stacked": { "alias": "stacked"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "gaps": { "alias": "gaps"; "required": false; "isSignal": true; }; "curve": { "alias": "curve"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, never, never, true, never>;
659
758
  }
660
759
 
661
760
  /**
@@ -190,6 +190,8 @@ declare class ColumnChartComponent {
190
190
  * its end standing rather than taking them off the axis for every other series too. */
191
191
  protected readonly categories: _angular_core.Signal<string[]>;
192
192
  protected readonly multiSeries: _angular_core.Signal<boolean>;
193
+ /** The series named in the legend under the pointer, which fades the rest. */
194
+ protected readonly highlightedSeries: _angular_core.WritableSignal<string | null>;
193
195
  protected readonly legendItems: _angular_core.Signal<readonly ChartLegendItem[]>;
194
196
  /** A normalized stack draws shares, not readings, so the axis has to say so - the value printed
195
197
  * beside each mark stays the reading, which is what `valueFormat` goes on formatting. */
@@ -1,6 +1,7 @@
1
1
  import * as _ids_group_ltd_ids_design_system_components_chart_tooltip from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
2
2
  import { ChartItemTooltipTrigger, ChartTooltipContext } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
3
3
  import * as _ids_group_ltd_ids_design_system_components from '@ids-group-ltd/ids-design-system/components';
4
+ import { leaveMark } from '@ids-group-ltd/ids-design-system/components';
4
5
  import * as _angular_core from '@angular/core';
5
6
  import { TemplateRef } from '@angular/core';
6
7
  import { ChartDataRow } from '@ids-group-ltd/ids-design-system/components/chart-data-table';
@@ -23,6 +24,7 @@ type FunnelChartDrop = 'relative' | 'absolute' | 'none';
23
24
  type FunnelChartShape = 'taper' | 'width' | 'area';
24
25
 
25
26
  declare class FunnelChartComponent {
27
+ protected readonly leaveMark: typeof leaveMark;
26
28
  /** Drawn in the order given. The order of a funnel's stages is its meaning,
27
29
  * so they are never sorted. */
28
30
  readonly data: _angular_core.InputSignal<readonly FunnelChartStage[]>;
@@ -124,11 +126,7 @@ declare class FunnelChartComponent {
124
126
  yPercent: number;
125
127
  } | null>;
126
128
  protected onMarkClick(payload: FunnelChartStage, index: number, event: Event): void;
127
- /** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
128
- * every mouse-operable control has to be separately focusable, and that is what keeps a
129
- * twenty-five mark chart from being twenty-five stops in the page's tab order. */
130
- protected readonly rovingIndex: _angular_core.WritableSignal<number>;
131
- protected readonly tabStopIndex: _angular_core.Signal<number>;
129
+ protected readonly roving: _ids_group_ltd_ids_design_system_components.RovingMarks;
132
130
  protected onMarkFocus(index: number, event: FocusEvent): void;
133
131
  /** A table row stands for its band, so it opens the band's tooltip over the BAND and dims the
134
132
  * others — the same state hovering the band itself produces. */
@@ -68,6 +68,9 @@ declare class LineChartComponent {
68
68
  readonly yAxisMode: _angular_core.InputSignal<ChartAxisMode>;
69
69
  /** Draws a dot at every reading. Off, the dots appear on hover and on focus only. */
70
70
  readonly showMarkers: _angular_core.InputSignalWithTransform<boolean, unknown>;
71
+ /** Lays the lines and their markers on a band of the surface colour. Off where the plot holds
72
+ * nothing for them to cross and the band only separates them from the gridlines. */
73
+ readonly outline: _angular_core.InputSignalWithTransform<boolean, unknown>;
71
74
  /** Labels pinned over their readings, for the points that have to read without a pointer. They
72
75
  * are drawn, not announced: the data table already carries every reading, and repeating one in
73
76
  * the plot makes a screen reader say it twice. */
@@ -274,7 +277,7 @@ declare class LineChartComponent {
274
277
  * is still empty. */
275
278
  protected readonly skeletonSeries: _angular_core.Signal<unknown[]>;
276
279
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<LineChartComponent, never>;
277
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineChartComponent, "ds-line-chart", never, { "categories": { "alias": "categories"; "required": true; "isSignal": true; }; "series": { "alias": "series"; "required": true; "isSignal": true; }; "yAxisMode": { "alias": "yAxisMode"; "required": false; "isSignal": true; }; "showMarkers": { "alias": "showMarkers"; "required": false; "isSignal": true; }; "annotations": { "alias": "annotations"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "gaps": { "alias": "gaps"; "required": false; "isSignal": true; }; "curve": { "alias": "curve"; "required": false; "isSignal": true; }; "stack": { "alias": "stack"; "required": false; "isSignal": true; }; "yAxisLabel": { "alias": "yAxisLabel"; "required": false; "isSignal": true; }; "secondaryAxisLabel": { "alias": "secondaryAxisLabel"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "maxSecondary": { "alias": "maxSecondary"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "hiddenSeries": { "alias": "hiddenSeries"; "required": false; "isSignal": true; }; "rescaleOnHide": { "alias": "rescaleOnHide"; "required": false; "isSignal": true; }; "legendFilters": { "alias": "legendFilters"; "required": false; "isSignal": true; }; "legendMode": { "alias": "legendMode"; "required": false; "isSignal": true; }; "noVisibleSeriesText": { "alias": "noVisibleSeriesText"; "required": false; "isSignal": true; }; "patterns": { "alias": "patterns"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; "hiddenSeries": "hiddenSeriesChange"; }, ["tooltipTemplate"], never, true, never>;
280
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineChartComponent, "ds-line-chart", never, { "categories": { "alias": "categories"; "required": true; "isSignal": true; }; "series": { "alias": "series"; "required": true; "isSignal": true; }; "yAxisMode": { "alias": "yAxisMode"; "required": false; "isSignal": true; }; "showMarkers": { "alias": "showMarkers"; "required": false; "isSignal": true; }; "outline": { "alias": "outline"; "required": false; "isSignal": true; }; "annotations": { "alias": "annotations"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "pinOnClick": { "alias": "pinOnClick"; "required": false; "isSignal": true; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "gaps": { "alias": "gaps"; "required": false; "isSignal": true; }; "curve": { "alias": "curve"; "required": false; "isSignal": true; }; "stack": { "alias": "stack"; "required": false; "isSignal": true; }; "yAxisLabel": { "alias": "yAxisLabel"; "required": false; "isSignal": true; }; "secondaryAxisLabel": { "alias": "secondaryAxisLabel"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "required": false; "isSignal": true; }; "frame": { "alias": "frame"; "required": false; "isSignal": true; }; "tooltipLingerMs": { "alias": "tooltipLingerMs"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "summary": { "alias": "summary"; "required": false; "isSignal": true; }; "dataTable": { "alias": "dataTable"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "maxSecondary": { "alias": "maxSecondary"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "errorText": { "alias": "errorText"; "required": false; "isSignal": true; }; "valueFormat": { "alias": "valueFormat"; "required": false; "isSignal": true; }; "hiddenSeries": { "alias": "hiddenSeries"; "required": false; "isSignal": true; }; "rescaleOnHide": { "alias": "rescaleOnHide"; "required": false; "isSignal": true; }; "legendFilters": { "alias": "legendFilters"; "required": false; "isSignal": true; }; "legendMode": { "alias": "legendMode"; "required": false; "isSignal": true; }; "noVisibleSeriesText": { "alias": "noVisibleSeriesText"; "required": false; "isSignal": true; }; "patterns": { "alias": "patterns"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "tooltipAnchor": { "alias": "tooltipAnchor"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; "hiddenSeries": "hiddenSeriesChange"; }, ["tooltipTemplate"], never, true, never>;
278
281
  }
279
282
 
280
283
  export { LineChartComponent };
@@ -88,6 +88,10 @@ declare class ModalCardComponent {
88
88
  /** Fires when the header close button is clicked. */
89
89
  readonly closed: _angular_core.OutputEmitterRef<void>;
90
90
  protected readonly titleId: string;
91
+ private readonly header;
92
+ private readonly actionsRow;
93
+ constructor();
94
+ private stackOverflowingActions;
91
95
  /** Status picks the glyph so a severity is never carried by colour alone. */
92
96
  protected readonly resolvedIcon: _angular_core.Signal<IconName | null>;
93
97
  protected readonly resolvedRole: _angular_core.Signal<"dialog" | "alertdialog">;
@@ -1,7 +1,6 @@
1
1
  import * as _angular_core from '@angular/core';
2
- import { DsSize } from '@ids-group-ltd/ids-design-system/core';
3
-
4
- type PaginationLayout = 'grouped' | 'spread';
2
+ import { DsSize, PaginationLayout } from '@ids-group-ltd/ids-design-system/core';
3
+ export { PaginationLayout } from '@ids-group-ltd/ids-design-system/core';
5
4
 
6
5
  declare class PaginationComponent {
7
6
  /** Total item count, used to compute the page count. */
@@ -19,12 +18,19 @@ declare class PaginationComponent {
19
18
  * page size — otherwise the control offers a choice the host won't honour. */
20
19
  readonly showPageSize: _angular_core.InputSignalWithTransform<boolean, unknown>;
21
20
  /** Control height - sm/md/lg. A pager under a full-width table wants targets bigger than the
22
- * dense default. Unset falls back to `DS_CONFIG.control.size`, then `'sm'`. */
21
+ * dense default. Unset falls back to `DS_CONFIG.pagination.size`, then
22
+ * `DS_CONFIG.control.size`, then `'sm'`. */
23
23
  readonly size: _angular_core.InputSignal<DsSize | null>;
24
- protected readonly sizeResolved: _angular_core.Signal<DsSize>;
25
- /** `'grouped'`, the default, keeps the label beside the controls. `'spread'` pushes them to
26
- * opposite edges of whatever width the nav is given. */
27
- readonly layout: _angular_core.InputSignal<PaginationLayout>;
24
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
25
+ /** `'grouped'` keeps the label beside the controls. `'spread'` pushes them to opposite edges
26
+ * of whatever width the nav is given. Unset falls back to `DS_CONFIG.pagination.layout`,
27
+ * then `'grouped'`. */
28
+ readonly layout: _angular_core.InputSignal<PaginationLayout | null>;
29
+ readonly layoutResolved: _angular_core.Signal<PaginationLayout>;
30
+ /** The host is still fetching: every control disables, the range label is masked with a
31
+ * `<ds-skeleton>` so a stale `total` is never quoted, and the nav reports `aria-busy`.
32
+ * `ds-table` sets it from `loading="skeleton"`. */
33
+ readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
28
34
  protected readonly navClass: _angular_core.Signal<string>;
29
35
  protected readonly totalPages: _angular_core.Signal<number>;
30
36
  protected readonly pageItems: _angular_core.Signal<(number | "ellipsis")[]>;
@@ -37,8 +43,7 @@ declare class PaginationComponent {
37
43
  protected goTo(page: number): void;
38
44
  protected onSizeChange(value: string): void;
39
45
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<PaginationComponent, never>;
40
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<PaginationComponent, "ds-pagination", never, { "total": { "alias": "total"; "required": true; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "currentPage": { "alias": "currentPage"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; }, { "pageSize": "pageSizeChange"; "currentPage": "currentPageChange"; }, never, never, true, never>;
46
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<PaginationComponent, "ds-pagination", never, { "total": { "alias": "total"; "required": true; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "currentPage": { "alias": "currentPage"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; }, { "pageSize": "pageSizeChange"; "currentPage": "currentPageChange"; }, never, never, true, never>;
41
47
  }
42
48
 
43
49
  export { PaginationComponent };
44
- export type { PaginationLayout };
@@ -118,10 +118,7 @@ declare class PieChartComponent {
118
118
  private readonly tooltipLingerResolved;
119
119
  protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
120
120
  protected onMarkClick(payload: PieChartSlice, index: number, event: Event): void;
121
- /** One tab stop per chart, not one per slice: WCAG 2.1.1's Understanding is explicit that not
122
- * every mouse-operable control has to be separately focusable. */
123
- protected readonly rovingIndex: _angular_core.WritableSignal<number>;
124
- protected readonly tabStopIndex: _angular_core.Signal<number>;
121
+ protected readonly roving: _ids_group_ltd_ids_design_system_components.RovingMarks;
125
122
  protected onMarkFocus(index: number, event: FocusEvent): void;
126
123
  /** A legend item stands for its arc, so it opens the arc's tooltip over the ARC and dims the
127
124
  * other slices — the same state hovering the arc itself produces. */
@@ -150,6 +150,8 @@ declare class ScatterChartComponent {
150
150
  protected readonly plotBottom: number;
151
151
  protected readonly plotRight: number;
152
152
  protected readonly multiSeries: _angular_core.Signal<boolean>;
153
+ /** The series named in the legend under the pointer, which fades the rest. */
154
+ protected readonly highlightedSeries: _angular_core.WritableSignal<string | null>;
153
155
  protected readonly legendItems: _angular_core.Signal<readonly ChartLegendItem[]>;
154
156
  protected readonly accessibleName: _angular_core.Signal<string>;
155
157
  protected readonly dataTableColumns: _angular_core.Signal<readonly string[]>;
@@ -171,7 +173,11 @@ declare class ScatterChartComponent {
171
173
  protected readonly skeletonHeight = "360";
172
174
  /** Flattened so one index addresses a mark, which is what `chartActiveMark` counts. */
173
175
  private readonly flatMarks;
174
- protected markIndex(seriesKey: string, pointKey: string): number;
176
+ /** Where each series starts in `flatMarks`, so a point carries its flat index without a search
177
+ * and the series' one listener reads it back. */
178
+ protected readonly seriesStart: _angular_core.Signal<Map<string, number>>;
179
+ protected onPointOver(event: Event): void;
180
+ protected onPointActivate(event: Event): void;
175
181
  protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
176
182
  protected onPointClick(series: ScatterChartSeries, point: ScatterPoint): void;
177
183
  protected pointLabel(series: ScatterChartSeries, point: ScatterPoint): string;
@@ -56,6 +56,8 @@ declare class SearchComponent implements ControlValueAccessor {
56
56
  * over deliberately — e.g. a Clear button that disables itself on activation
57
57
  * would otherwise blur into `<body>` and restart Tab order at the top. */
58
58
  focus(options?: FocusOptions): void;
59
+ /** Drops focus from the search input - the counterpart of `focus()`. */
60
+ blur(): void;
59
61
  protected onText(next: string): void;
60
62
  protected onSubmit(): void;
61
63
  /** Empties the field, DROPS any armed keystroke, and publishes '' immediately.
@@ -9,6 +9,7 @@ declare class SkeletonComponent {
9
9
  readonly circle: _angular_core.InputSignalWithTransform<boolean, unknown>;
10
10
  /** `display: inline-block` instead of `block`, to sit inline with text. */
11
11
  readonly inline: _angular_core.InputSignalWithTransform<boolean, unknown>;
12
+ constructor();
12
13
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SkeletonComponent, never>;
13
14
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<SkeletonComponent, "ds-skeleton", never, { "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "circle": { "alias": "circle"; "required": false; "isSignal": true; }; "inline": { "alias": "inline"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
14
15
  }
@@ -26,6 +26,14 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
26
26
  /** Accessible name for a control with no visible label — the row's `<label>` collapses when it
27
27
  * is empty, leaving nothing to name it. Set beside a label it OVERRIDES the label, per ARIA. */
28
28
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
29
+ /**
30
+ * The switch never flips itself: a click or Space cancels the native toggle and
31
+ * `checkedRequested` carries the value the user asked for. It moves only when
32
+ * `checked` changes from outside, so a cancelled confirmation changes nothing.
33
+ */
34
+ readonly controlled: _angular_core.InputSignalWithTransform<boolean, unknown>;
35
+ /** The value the user asked for, emitted in place of a flip when `controlled`. Silent otherwise. */
36
+ readonly checkedRequested: _angular_core.OutputEmitterRef<boolean>;
29
37
  protected readonly isDisabled: _angular_core.Signal<boolean>;
30
38
  protected readonly uid: string;
31
39
  protected readonly controlId: _angular_core.Signal<string>;
@@ -38,8 +46,9 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
38
46
  protected readonly switchClasses: _angular_core.Signal<string>;
39
47
  protected readonly fieldClass: _angular_core.Signal<string>;
40
48
  protected onCheckedChange(event: Event): void;
49
+ protected onClick(event: MouseEvent): void;
41
50
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SwitchComponent, never>;
42
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SwitchComponent, "ds-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
51
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SwitchComponent, "ds-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "controlled": { "alias": "controlled"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "checkedRequested": "checkedRequested"; }, never, ["*"], true, never>;
43
52
  }
44
53
 
45
54
  export { SwitchComponent };