@ids-group-ltd/ids-design-system 0.13.2 → 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.
Files changed (54) hide show
  1. package/CHANGELOG.md +265 -0
  2. package/components.md +12 -16
  3. package/docs/agent/INDEX.md +1 -2
  4. package/docs/agent/charts/ds-column-chart.md +3 -2
  5. package/docs/agent/feedback/ds-bar.md +13 -0
  6. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +9 -10
  7. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  8. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs +95 -0
  9. package/fesm2022/ids-group-ltd-ids-design-system-components-bar.mjs.map +1 -0
  10. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +70 -41
  11. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  12. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs +973 -0
  13. package/fesm2022/ids-group-ltd-ids-design-system-components-chart.mjs.map +1 -0
  14. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +141 -120
  15. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  16. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs +42 -11
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs.map +1 -1
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +16 -7
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +14 -83
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +2 -2
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  24. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +163 -21
  25. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  26. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +1 -1
  27. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  28. package/fesm2022/ids-group-ltd-ids-design-system.mjs +2 -2
  29. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  30. package/migrations/0.13.3.json +211 -0
  31. package/package.json +17 -17
  32. package/styles/_chart-frame.scss +16 -6
  33. package/styles/_tokens-charts.scss +29 -5
  34. package/styles/_tokens.scss +1 -1
  35. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +2 -1
  36. package/types/ids-group-ltd-ids-design-system-components-bar.d.ts +63 -0
  37. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +2 -2
  38. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +7 -4
  39. package/types/ids-group-ltd-ids-design-system-components-chart.d.ts +543 -0
  40. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +95 -38
  41. package/types/ids-group-ltd-ids-design-system-components-donut-chart.d.ts +15 -2
  42. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +6 -1
  43. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +8 -18
  44. package/types/ids-group-ltd-ids-design-system-components.d.ts +58 -9
  45. package/types/ids-group-ltd-ids-design-system-core.d.ts +55 -4
  46. package/types/ids-group-ltd-ids-design-system.d.ts +4 -4
  47. package/docs/agent/feedback/ds-meter.md +0 -11
  48. package/docs/agent/feedback/ds-progress.md +0 -10
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-meter.mjs +0 -61
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-meter.mjs.map +0 -1
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs +0 -65
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs.map +0 -1
  53. package/types/ids-group-ltd-ids-design-system-components-meter.d.ts +0 -36
  54. package/types/ids-group-ltd-ids-design-system-components-progress.d.ts +0 -40
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ids-group-ltd/ids-design-system",
3
- "version": "0.13.2",
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"
@@ -185,10 +193,6 @@
185
193
  "types": "./types/ids-group-ltd-ids-design-system-components-menu.d.ts",
186
194
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs"
187
195
  },
188
- "./components/meter": {
189
- "types": "./types/ids-group-ltd-ids-design-system-components-meter.d.ts",
190
- "default": "./fesm2022/ids-group-ltd-ids-design-system-components-meter.mjs"
191
- },
192
196
  "./components/modal": {
193
197
  "types": "./types/ids-group-ltd-ids-design-system-components-modal.d.ts",
194
198
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs"
@@ -225,10 +229,6 @@
225
229
  "types": "./types/ids-group-ltd-ids-design-system-components-popover.d.ts",
226
230
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs"
227
231
  },
228
- "./components/progress": {
229
- "types": "./types/ids-group-ltd-ids-design-system-components-progress.d.ts",
230
- "default": "./fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs"
231
- },
232
232
  "./components/radio-group": {
233
233
  "types": "./types/ids-group-ltd-ids-design-system-components-radio-group.d.ts",
234
234
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs"
@@ -401,6 +401,10 @@
401
401
  "types": "./types/ids-group-ltd-ids-design-system-components-banner.d.ts",
402
402
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs"
403
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
+ },
404
408
  "./bar-chart": {
405
409
  "types": "./types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts",
406
410
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs"
@@ -429,6 +433,10 @@
429
433
  "types": "./types/ids-group-ltd-ids-design-system-components-card.d.ts",
430
434
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-card.mjs"
431
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
+ },
432
440
  "./chart-legend": {
433
441
  "types": "./types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts",
434
442
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs"
@@ -521,10 +529,6 @@
521
529
  "types": "./types/ids-group-ltd-ids-design-system-components-menu.d.ts",
522
530
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-menu.mjs"
523
531
  },
524
- "./meter": {
525
- "types": "./types/ids-group-ltd-ids-design-system-components-meter.d.ts",
526
- "default": "./fesm2022/ids-group-ltd-ids-design-system-components-meter.mjs"
527
- },
528
532
  "./modal": {
529
533
  "types": "./types/ids-group-ltd-ids-design-system-components-modal.d.ts",
530
534
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs"
@@ -561,10 +565,6 @@
561
565
  "types": "./types/ids-group-ltd-ids-design-system-components-popover.d.ts",
562
566
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-popover.mjs"
563
567
  },
564
- "./progress": {
565
- "types": "./types/ids-group-ltd-ids-design-system-components-progress.d.ts",
566
- "default": "./fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs"
567
- },
568
568
  "./radio-group": {
569
569
  "types": "./types/ids-group-ltd-ids-design-system-components-radio-group.d.ts",
570
570
  "default": "./fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs"
@@ -40,15 +40,14 @@
40
40
 
41
41
  // The focus indicator, drawn rather than outlined: `outline` on an SVG element paints its BOUNDING
42
42
  // BOX, not its silhouette, so a slice would ring as a rectangle. Two tones, because one is not
43
- // enough — a light stroke carries against a dark mark, the dark halo around it carries against a
44
- // light one and against the surface, and between them the ring clears 3:1 on every series colour
45
- // the palette holds. `drop-shadow` rather than a second stroke: an SVG shape has one stroke.
43
+ // enough: the ring is the app's own focus colour, so a focused mark reads as the same indicator as
44
+ // every other control, and the light keyline around it is what separates that colour from a mark
45
+ // of the same hue family. `drop-shadow` rather than a second stroke: an SVG shape has one stroke.
46
46
  @mixin drawn-focus-ring {
47
47
  stroke: var(--ds-chart-focus-ring-color);
48
48
  stroke-width: var(--focus-ring-width);
49
49
  paint-order: stroke;
50
- filter: drop-shadow(0 0 1px var(--ds-chart-focus-halo-color))
51
- drop-shadow(0 0 1px var(--ds-chart-focus-halo-color));
50
+ filter: drop-shadow(0 0 var(--focus-ring-width) var(--ds-chart-focus-halo-color));
52
51
  }
53
52
 
54
53
  // A CLICK focuses an SVG shape in Chromium even with no `tabindex` on it, and `:focus-visible` is
@@ -91,7 +90,13 @@
91
90
  // its data is empty, its request failed, or its legend switched the last series off drags the whole
92
91
  // page up under the reader's cursor — and the state they are being told about is exactly the moment
93
92
  // they are least able to afford the jump. `$height` is the plot the message stands in for.
94
- @mixin message-box($height) {
93
+ // `$axes` keeps the L of a plot that HAS axes — the value axis down the left, the category axis
94
+ // along the bottom. A chart whose data went away still has the frame its readings were measured
95
+ // against, and drawing it keeps the message inside a plot rather than floating in a blank card.
96
+ // Borders rather than an SVG: with no data there is nothing to scale against, and an axis without
97
+ // ticks or labels is exactly two lines. Off for the donut and the funnel, which have no axes to
98
+ // keep.
99
+ @mixin message-box($height, $axes: false) {
95
100
  .empty {
96
101
  display: grid;
97
102
  place-items: center;
@@ -99,6 +104,11 @@
99
104
  margin: 0;
100
105
  color: var(--text-secondary);
101
106
  text-align: center;
107
+
108
+ @if $axes {
109
+ border-inline-start: 1px solid var(--ds-chart-axis-line-color);
110
+ border-block-end: 1px solid var(--ds-chart-axis-line-color);
111
+ }
102
112
  }
103
113
  }
104
114
 
@@ -93,6 +93,14 @@
93
93
  --chart-grid-line-color: var(--neutral-150);
94
94
  --chart-axis-font-size: var(--font-size-2xs);
95
95
 
96
+ /* REFERENCE LINES - an annotation, not a series. A neutral stroke and a dash are what keep a
97
+ target from reading as one more category, and the band's opacity is low enough that a mark
98
+ drawn over it stays its own colour. */
99
+ --chart-threshold-color: var(--neutral-500);
100
+ --chart-threshold-band-opacity: 0.12;
101
+ --chart-threshold-dashed-pattern: 6 4;
102
+ --chart-threshold-dotted-pattern: 1 5;
103
+
96
104
  /* HIGHLIGHT / HOVER */
97
105
 
98
106
  /* Every level of dimming costs the separation BETWEEN the dimmed series: measured 2026-09-13,
@@ -103,11 +111,13 @@
103
111
  --chart-hover-bg-color: hsl(225deg 39% 7% / 4%);
104
112
  --chart-cursor-line-color: var(--neutral-400);
105
113
 
106
- /* The focus indicator is TWO tones, not one: a light stroke with a dark halo around it. A
107
- single accent ring disappears on a mark of the same hue family, and a chart's marks are
108
- exactly the surfaces a ring has to survive. */
109
- --chart-focus-ring-color: white;
110
- --chart-focus-halo-color: var(--static-ink);
114
+ /* The focus indicator is TWO tones, not one: a single accent ring disappears on a mark of the
115
+ same hue family, and a chart's marks are exactly the surfaces a ring has to survive. The ring
116
+ itself is the app's, so a focused mark reads as the same indicator as every other control;
117
+ the white keyline is what separates it from the mark underneath, and it is the keyline rather
118
+ than the ring that does the surviving. */
119
+ --chart-focus-ring-color: var(--focus-ring-color);
120
+ --chart-focus-halo-color: white;
111
121
 
112
122
  --chart-tooltip-bg-color: var(--neutral-900);
113
123
  --chart-tooltip-text-color: var(--neutral-0);
@@ -123,6 +133,12 @@
123
133
  --chart-line-width-bold: 3px;
124
134
  --chart-dot-radius: 4px;
125
135
  --chart-dot-radius-active: 6px;
136
+ --chart-area-opacity: 0.16;
137
+
138
+ /* Stripes wide enough to survive a 24px-wide mark at a glance, and drawn in the surface colour
139
+ so they read as gaps cut out of the mark rather than a second hue competing with it. */
140
+ --chart-hatch-color: var(--surface-default);
141
+ --chart-hatch-width: 3px;
126
142
  }
127
143
 
128
144
  /* Public override layer.
@@ -165,6 +181,11 @@
165
181
  --ds-chart-axis-font-size: var(--chart-axis-font-size);
166
182
  --ds-chart-grid-line-color: var(--chart-grid-line-color);
167
183
 
184
+ --ds-chart-threshold-color: var(--chart-threshold-color);
185
+ --ds-chart-threshold-band-opacity: var(--chart-threshold-band-opacity);
186
+ --ds-chart-threshold-dashed-pattern: var(--chart-threshold-dashed-pattern);
187
+ --ds-chart-threshold-dotted-pattern: var(--chart-threshold-dotted-pattern);
188
+
168
189
  --ds-chart-dim-opacity: var(--chart-dim-opacity);
169
190
  --ds-chart-hover-bg-color: var(--chart-hover-bg-color);
170
191
  --ds-chart-cursor-line-color: var(--chart-cursor-line-color);
@@ -180,4 +201,7 @@
180
201
  --ds-chart-line-width-bold: var(--chart-line-width-bold);
181
202
  --ds-chart-dot-radius: var(--chart-dot-radius);
182
203
  --ds-chart-dot-radius-active: var(--chart-dot-radius-active);
204
+ --ds-chart-area-opacity: var(--chart-area-opacity);
205
+ --ds-chart-hatch-color: var(--chart-hatch-color);
206
+ --ds-chart-hatch-width: var(--chart-hatch-width);
183
207
  }
@@ -318,7 +318,7 @@
318
318
  --spinner-lg: 24px;
319
319
  --spinner-bw: var(--border-width-strong);
320
320
 
321
- --progress-h: 6px;
321
+ --bar-h: 6px;
322
322
 
323
323
  --stepper-node-size: 28px; /* === --hit-sm */
324
324
  --stepper-bar-w: 56px;
@@ -2,6 +2,7 @@ import * as _ids_group_ltd_ids_design_system_components_chart_tooltip from '@ids
2
2
  import { ChartItemTooltipTrigger, ChartTooltipContext } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
3
3
  import * as _angular_core from '@angular/core';
4
4
  import { TemplateRef } from '@angular/core';
5
+ import { defaultChartFormat } from '@ids-group-ltd/ids-design-system/components';
5
6
  import { ChartFrame, ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
6
7
 
7
8
  /** One part of a row that is a distribution rather than a single quantity. */
@@ -105,7 +106,7 @@ declare class BarChartComponent {
105
106
  readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
106
107
  readonly emptyTextResolved: _angular_core.Signal<string>;
107
108
  readonly errorTextResolved: _angular_core.Signal<string>;
108
- readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
109
+ readonly valueFormatResolved: _angular_core.Signal<typeof defaultChartFormat>;
109
110
  /** Turns on the click affordance — the pointer cursor and any hover tint.
110
111
  * The click output fires whether or not this is set, so a consumer that
111
112
  * binds the output and forgets the flag still receives every click. */
@@ -0,0 +1,63 @@
1
+ import * as _angular_core from '@angular/core';
2
+
3
+ /** Colour role for the fill. */
4
+ type BarVariant = 'default' | 'success' | 'warning' | 'error';
5
+ /** What the bar IS, which decides how it is announced.
6
+ *
7
+ * - `'progress'` — how far a task has got. `role="progressbar"`.
8
+ * - `'meter'` — a measurement on a known scale: a rate, a score, a count against a ceiling. It
9
+ * has no beginning and no completion. `role="meter"`.
10
+ * - `'none'` — drawn only, hidden from assistive technology. For a bar in a table cell whose
11
+ * figure is printed beside it, where announcing each one repeats what the row already says. */
12
+ type BarSemantics = 'progress' | 'meter' | 'none';
13
+
14
+ /**
15
+ * One horizontal track with one fill: a task's completion, or a measurement on a known scale.
16
+ *
17
+ * The two are the same drawing and a different claim, which is what `semantics` carries — the
18
+ * platform splits them the same way, into `<progress>` and `<meter>`. Getting it wrong is not
19
+ * cosmetic: a table of two hundred rates under `'progress'` announces two hundred progress bars.
20
+ */
21
+ declare class BarComponent {
22
+ /** The reading, in units of `max`; clamped, and ignored while `indeterminate`. */
23
+ readonly value: _angular_core.InputSignalWithTransform<number, unknown>;
24
+ /** The full scale `value` and `target` are read against. Left at 100 they are percentages. Set
25
+ * it to the real total — `[value]="37" [max]="80"` — and the accessible name carries "37 of 80"
26
+ * rather than the 46% a caller would otherwise have to compute. For a column of measurements
27
+ * it is usually the column's own largest value, so the longest bar fills its track and the rest
28
+ * are its share. Zero or less falls back to 100, because a scale with no width has no fraction
29
+ * to draw. */
30
+ readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
31
+ /** What the bar is, and therefore how it is announced. See `BarSemantics`. Defaults to
32
+ * `'progress'`. */
33
+ readonly semantics: _angular_core.InputSignal<BarSemantics>;
34
+ /** Colour role — drives the success/warning/error styling. */
35
+ readonly variant: _angular_core.InputSignal<BarVariant>;
36
+ /** Indeterminate (unknown-duration) animation instead of a fixed `value`. Only a task has an
37
+ * unknown duration, so it is ignored unless `semantics` is `'progress'`. */
38
+ readonly indeterminate: _angular_core.InputSignalWithTransform<boolean, unknown>;
39
+ /** Overrides the fill for this one bar. A whole column is coloured once through
40
+ * `--ds-bar-fill-color` instead; use this where the colour carries meaning on one row. */
41
+ readonly color: _angular_core.InputSignal<string | null>;
42
+ /** Accessible name (e.g. "Upload progress"). With a `target` set, name the comparison here —
43
+ * the mark is drawn and the role has no second value to announce, so "Resolved 62% against a
44
+ * 75% target" is what reaches a screen reader. Unused under `semantics="none"`. */
45
+ readonly ariaLabel: _angular_core.InputSignal<string | null>;
46
+ /** A second point on the same scale as `value`, drawn as a hairline across the track — a goal,
47
+ * a baseline or a threshold to read `value` against. Clamped like `value`, ignored while
48
+ * `indeterminate`, and unset draws nothing. */
49
+ readonly target: _angular_core.InputSignal<number | null>;
50
+ protected readonly role: _angular_core.Signal<"meter" | "progressbar" | null>;
51
+ protected readonly scale: _angular_core.Signal<number>;
52
+ protected readonly clampedValue: _angular_core.Signal<number>;
53
+ /** Width and offset are percentages of the track whatever the scale is. */
54
+ protected readonly valuePercent: _angular_core.Signal<number>;
55
+ protected readonly clampedTarget: _angular_core.Signal<number | null>;
56
+ protected readonly targetPercent: _angular_core.Signal<number | null>;
57
+ protected readonly isIndet: _angular_core.Signal<boolean>;
58
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<BarComponent, never>;
59
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<BarComponent, "ds-bar", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "semantics": { "alias": "semantics"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "target": { "alias": "target"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
60
+ }
61
+
62
+ export { BarComponent };
63
+ export type { BarSemantics, BarVariant };
@@ -52,9 +52,9 @@ declare class ButtonComponent extends DsMessageBase {
52
52
  * stays lit inside its own pages. It also bounds the announcement, because the same directive
53
53
  * writes it: narrowed to `{ exact: true }`, a prefix match is no longer active and the link
54
54
  * announces nothing rather than `true`. Pass `ariaCurrent` alongside to keep one. */
55
- readonly routerLinkActiveOptions: _angular_core.InputSignal<IsActiveMatchOptions | {
55
+ readonly routerLinkActiveOptions: _angular_core.InputSignal<{
56
56
  exact: boolean;
57
- }>;
57
+ } | IsActiveMatchOptions>;
58
58
  /** Overrides what the link announces. Unset, an exact match announces `page` and a prefix match
59
59
  * announces `true`, which is what ARIA means by each; pass `null` to announce nothing, or one
60
60
  * of the other values when the link is a step or a location rather than a page. */
@@ -52,9 +52,12 @@ declare class ChartTooltipDirective {
52
52
  * that text as well as the mark, or the two overlap. Ignored for touch, where the gap is already
53
53
  * sized for a fingertip. */
54
54
  readonly dsChartTooltipExtraGap: _angular_core.InputSignal<number>;
55
+ /** Opens the panel BELOW the mark first. A chart sets it while a mark is held, so the panel
56
+ * leaves the plot's top edge — and the Unpin control that lives there — alone. */
57
+ readonly dsChartTooltipPreferBelow: _angular_core.InputSignal<boolean>;
55
58
  private overlayRef;
56
59
  private panelRef;
57
- private detachScrollClose;
60
+ private detachScrollReposition;
58
61
  private detachEscape;
59
62
  constructor();
60
63
  private open;
@@ -62,7 +65,7 @@ declare class ChartTooltipDirective {
62
65
  private closeOnEscape;
63
66
  private close;
64
67
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartTooltipDirective, never>;
65
- static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ChartTooltipDirective, "[dsChartTooltip]", never, { "dsChartTooltip": { "alias": "dsChartTooltip"; "required": false; "isSignal": true; }; "dsChartTooltipOrigin": { "alias": "dsChartTooltipOrigin"; "required": false; "isSignal": true; }; "dsChartTooltipTemplate": { "alias": "dsChartTooltipTemplate"; "required": false; "isSignal": true; }; "dsChartTooltipExtraGap": { "alias": "dsChartTooltipExtraGap"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
68
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ChartTooltipDirective, "[dsChartTooltip]", never, { "dsChartTooltip": { "alias": "dsChartTooltip"; "required": false; "isSignal": true; }; "dsChartTooltipOrigin": { "alias": "dsChartTooltipOrigin"; "required": false; "isSignal": true; }; "dsChartTooltipTemplate": { "alias": "dsChartTooltipTemplate"; "required": false; "isSignal": true; }; "dsChartTooltipExtraGap": { "alias": "dsChartTooltipExtraGap"; "required": false; "isSignal": true; }; "dsChartTooltipPreferBelow": { "alias": "dsChartTooltipPreferBelow"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
66
69
  }
67
70
 
68
71
  /** @internal */
@@ -73,11 +76,11 @@ interface ChartActiveMark {
73
76
  readonly origin: Signal<Element | null>;
74
77
  /** Whether the active mark is held rather than followed — a tap, or a click under `pinOnClick`. */
75
78
  readonly pinned: Signal<boolean>;
76
- enter(index: number, event: Event, anchorWithin?: string): void;
79
+ enter(index: number, event: Event, anchor?: string | Element | null): void;
77
80
  leave(): void;
78
81
  /** Holds the mark that was activated, for any pointer type. Activating the mark that is already
79
82
  * pinned releases it, so one gesture both sets and clears. */
80
- pin(index: number, event: Event, anchorWithin?: string): void;
83
+ pin(index: number, event: Event, anchor?: string | Element | null): void;
81
84
  /** Lets go of a held mark, for a control that offers the way out in as many words. */
82
85
  release(): void;
83
86
  }