@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
@@ -203,12 +203,15 @@
203
203
  "kind": "selector-rename",
204
204
  "old": "ds-app-shell",
205
205
  "new": "ds-app-layout",
206
- "action": "Rename the element and its closing tag from `ds-app-shell` to `ds-app-layout`, then apply the class, service and token items below.",
206
+ "action": "Rename the element and its closing tag from `ds-app-shell` to `ds-app-layout`, and any stylesheet rule that names the element with it, then apply the class, service and token items below.",
207
207
  "note": "Behaviour is unchanged; the component shipped as ds-app-shell in the tagged 0.6.3 source.",
208
208
  "searchHints": [
209
209
  "ds-app-shell"
210
210
  ],
211
- "surface": "template"
211
+ "surface": [
212
+ "template",
213
+ "style"
214
+ ]
212
215
  },
213
216
  {
214
217
  "id": "app-shell-class-to-app-layout",
@@ -44,13 +44,16 @@
44
44
  "kind": "selector-rename",
45
45
  "old": "ds-auth-shell",
46
46
  "new": "ds-auth-layout",
47
- "action": "Rename the element and its closing tag from `ds-auth-shell` to `ds-auth-layout`, then apply the class and token items below.",
47
+ "action": "Rename the element and its closing tag from `ds-auth-shell` to `ds-auth-layout`, and any stylesheet rule that names the element with it, then apply the class and token items below.",
48
48
  "appliesWhen": "Behaviour, inputs and slots are unchanged — `brand`, `logoLetter`, `tagline`, `cardElevation`, `cardPadding`, `[brand]`, `[dsBrandName]` and `dsAuthSupport` all keep their names.",
49
49
  "note": "\"Shell\" is not this library's word for a layout: the app-level one became ds-app-layout in 0.7.0, and calling the auth counterpart a shell put the split vocabulary back. It shipped as ds-auth-shell in exactly one release.",
50
50
  "searchHints": [
51
51
  "ds-auth-shell"
52
52
  ],
53
- "surface": "template"
53
+ "surface": [
54
+ "template",
55
+ "style"
56
+ ]
54
57
  },
55
58
  {
56
59
  "id": "auth-shell-class-to-auth-layout",
@@ -16,7 +16,8 @@ One file per released version — `migrations/<version>.json` — mirroring that
16
16
  "deleteList": [ { "id": "<slug>", "surface": "<surface>", "find": ["<shape>", "..."],
17
17
  "why": "<what made it unnecessary>",
18
18
  "replaceWith": "<the API that replaces it>" } ],
19
- "informational": [ "<one-line FYI per non-actionable change group>" ] }
19
+ "informational": [ "<one-line FYI per non-actionable change group>" |
20
+ { "text": "...", "verify": "<one concrete eyeball check>" } ] }
20
21
  ```
21
22
 
22
23
  - `kind` ∈ `selector-rename | type-rename | input-rename | output-rename | token-rename |
@@ -26,7 +27,8 @@ One file per released version — `migrations/<version>.json` — mirroring that
26
27
  a value absent from the map is undocumented-as-changed and must be left untouched.
27
28
  - `old` of an element-scoped item is `element[attr]`.
28
29
  - **`surface`** — which of the consumer's artifacts changes: their `template`, their `typescript`,
29
- their `style`, their app `config`, or `none` when the only action is to LOOK. It is a required
30
+ their `style`, their app `config`, or `none` when the only action is to LOOK (an item keeps
31
+ `surface: none` only beside a `restore` or a conditional `action`). It is a required
30
32
  statement, not a hint: `none` and "the author forgot" must not read the same to a finder.
31
33
  - **`detect`** — the shapes to grep for when `old` is a DS symbol the affected code never mentions.
32
34
  Written the way the consumer writes it (`orderBy: sortKey`, `?? config.control?.size`), not the
@@ -49,6 +51,9 @@ One file per released version — `migrations/<version>.json` — mirroring that
49
51
  - **`pitfall`** — the way to apply the item mechanically correctly and still ship a broken app.
50
52
  Read it before deciding a clean build means done.
51
53
  - **`deleteList`** — the structured form of "what you can now delete" (see below).
54
+ - **`informational`** — a non-actionable FYI, a bare string or `{ "text": "...", "verify": "..." }`
55
+ where `verify` is the one eyeball check for a change to rendering alone (no symbol for a grep or
56
+ a build to catch).
52
57
 
53
58
  **Why:** an upgrade tool can read the plan out of the prose changelog, but it re-derives it on
54
59
  every run. A shipped manifest makes it deterministic: the tool validates and prefers the
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ids-group-ltd/ids-design-system",
3
- "version": "0.13.4",
3
+ "version": "0.14.0",
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/",
@@ -133,15 +133,15 @@
133
133
  position: relative;
134
134
  }
135
135
 
136
- /* Top CENTRE: the corner competes with a legend on the pie and with the value labels on a
137
- column chart, and on a wide card a corner control is a long way from the mark it undoes.
138
- Centred, it sits over the plot it belongs to whatever the chart's shape.
136
+ /* Bottom CENTRE: the panel it undoes opens above the held mark, so a control at the top is the
137
+ one thing the panel covers. A corner competes with a legend on the pie and with the value
138
+ labels on a column chart, and on a wide card it is a long way from the mark it undoes.
139
139
 
140
140
  44px minimum box around a 12px label, because it is a real control and the library's own touch
141
141
  rule applies to it. */
142
142
  .pin-reset {
143
143
  position: absolute;
144
- inset-block-start: var(--space-2);
144
+ inset-block-end: var(--space-2);
145
145
  inset-inline: 0;
146
146
  z-index: 1;
147
147
  justify-self: center;
@@ -2,8 +2,17 @@
2
2
  //
3
3
  // The enter is DELAYED by the exit duration, and that delay is what stages the three phases:
4
4
  // removals finish before additions start, so a vanishing mark and an arriving one are never on
5
- // screen together. Angular's `animate.enter` / `animate.leave` own the classes; this file owns
6
- // what they mean. `--_chart-mark-stagger` is set per mark by the component and adds to the delay.
5
+ // screen together. `--_chart-mark-stagger` is set per mark by the component and adds to the delay.
6
+ //
7
+ // The enter is a plain CSS animation declared on the mark, so the browser plays it once when the
8
+ // mark is inserted - on first render and for a mark a data change adds - with no script at all.
9
+ // NOT `animate.enter`: its runtime calls `getAnimations()` once per mark, and in Chrome each call
10
+ // costs more the more animations are running, so a chart entering a thousand marks at once blocks
11
+ // the main thread for seconds. `backwards`, not `both`: a finished animation that still fills stays
12
+ // in effect for good, and every later `getAnimations()` on the page pays for it. The exit still goes
13
+ // through `animate.leave`, because only Angular can hold a removed mark until it has faded, but in
14
+ // its function form: the component puts `.mark-leave` on the mark and Angular removes it on
15
+ // `animationend`, with no `getAnimations()` call.
7
16
  //
8
17
  // A mark ARRIVES BY GROWING FROM ITS OWN BASELINE, never by scaling about its centre: a uniform
9
18
  // scale reads as the whole chart zooming, and it moves the mark's baseline, which is the one line
@@ -52,14 +61,12 @@
52
61
  calc(
53
62
  var(--ds-motion-chart-mark-exit-duration) + var(--_chart-mark-stagger, 0ms)
54
63
  )
55
- both;
64
+ backwards;
56
65
  }
57
66
  }
58
67
 
59
- // `animate.enter` goes on the element that ANIMATES, not on the one the `@for` creates: Angular
60
- // drops the class when the animation on THAT element ends, and a class put on the row while the
61
- // fill inside it animates is never taken off again. `animate.leave` still belongs on the row —
62
- // that is what leaves.
68
+ // `animate.leave` goes on the element the `@for` creates - that is what leaves - while the enter
69
+ // is declared on the element that animates, which for a column and a bar row is the fill inside.
63
70
 
64
71
  /* A column: the fill grows up out of the category axis. */
65
72
  @mixin grows-up($mark, $fill) {
@@ -67,7 +74,7 @@
67
74
  transform-origin: bottom;
68
75
  }
69
76
 
70
- @include enters('#{$fill}.mark-enter', ds-chart-mark-grow-y);
77
+ @include enters('#{$fill}', ds-chart-mark-grow-y);
71
78
  @include leaves($mark);
72
79
  }
73
80
 
@@ -77,12 +84,12 @@
77
84
  transform-origin: left;
78
85
  }
79
86
 
80
- @include enters('#{$fill}.mark-enter', ds-chart-mark-grow-x);
87
+ @include enters('#{$fill}', ds-chart-mark-grow-x);
81
88
  @include leaves($mark);
82
89
  }
83
90
 
84
91
  /* A mark with no baseline of its own — a ring arc, a funnel band, a line. */
85
92
  @mixin fades-in($mark) {
86
- @include enters('#{$mark}.mark-enter', ds-chart-mark-fade-in);
93
+ @include enters('#{$mark}', ds-chart-mark-fade-in);
87
94
  @include leaves($mark);
88
95
  }
@@ -85,12 +85,20 @@
85
85
  }
86
86
  }
87
87
 
88
- /* The pane takes the pointer, so the panel can be reached and its text selected — WCAG 1.4.13
89
- requires that of anything shown on hover. What stops the flicker an interactive pane used to
90
- cause (panel covers the plot, plot takes a `pointerleave`, chart clears, panel closes, pointer
91
- lands on the plot again) is the grace period on the chart's own leave, in `chart-active-mark.ts`.
92
- The two are one mechanism: make the pane inert again and the criterion breaks silently; drop the
93
- grace and the flicker returns. */
88
+ /* The pane is INERT, because it is drawn over the plot it describes: on a funnel or a tight
89
+ category axis the panel covers the neighbouring marks, and a pane that takes the pointer means
90
+ the mark underneath never sees it - the reader is over a new segment while the panel still names
91
+ the old one. Inert, the pointer reaches the mark and the panel follows it.
92
+
93
+ WCAG 1.4.13 still holds. Hoverable: moving onto the panel does not dismiss it, because the
94
+ pointer either stays on the mark under it or the grace period in `chart-active-mark.ts` carries
95
+ the gap. Dismissible: Escape. Persistent: the panel stays while the mark is hovered, and a press
96
+ pins it where the chart offers pinning - a pinned pane takes the pointer again so its text can be
97
+ selected. Drop the grace and the flicker returns. */
94
98
  .cdk-overlay-pane.ds-chart-tooltip-pane {
99
+ pointer-events: none;
100
+ }
101
+
102
+ .cdk-overlay-pane.ds-chart-tooltip-pane.is-pinned {
95
103
  pointer-events: auto;
96
104
  }
@@ -9,8 +9,11 @@
9
9
  // one invalidates the style of every element that could inherit it — the whole document, every
10
10
  // frame. And the phase-lock buys no viewport anchoring anyway, because `mask-position` measures
11
11
  // from the host's own box.
12
+ //
13
+ // `!important`, because the travel is declared as `[_nghost-…]::after`, which outranks
14
+ // `ds-skeleton::after` whatever the order.
12
15
  @media (prefers-reduced-motion: reduce) {
13
16
  ds-skeleton::after {
14
- animation: none;
17
+ animation: none !important;
15
18
  }
16
19
  }
@@ -290,7 +290,7 @@
290
290
 
291
291
  --slider-track-h: 4px;
292
292
  --slider-thumb-size: 18px;
293
- --slider-thumb-bw: var(--border-width-strong);
293
+ --slider-thumb-border-width: var(--border-width-strong);
294
294
 
295
295
  --status-dot-size: 8px;
296
296
  --badge-dot-size: 6px;
@@ -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 { ChartFrame, ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
@@ -66,6 +67,7 @@ interface BarChartRow {
66
67
  }
67
68
 
68
69
  declare class BarChartComponent {
70
+ protected readonly leaveMark: typeof leaveMark;
69
71
  /** One row per bar, drawn in the order given. */
70
72
  readonly data: _angular_core.InputSignal<readonly BarChartRow[]>;
71
73
  /** Track length is relative to this. Null uses the largest value, so the
@@ -157,11 +159,7 @@ declare class BarChartComponent {
157
159
  private readonly tooltipLingerResolved;
158
160
  protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
159
161
  protected onMarkClick(payload: BarChartRow, index: number, event: Event): void;
160
- /** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
161
- * every mouse-operable control has to be separately focusable, and that is what keeps a
162
- * twenty-five mark chart from being twenty-five stops in the page's tab order. */
163
- protected readonly rovingIndex: _angular_core.WritableSignal<number>;
164
- protected readonly tabStopIndex: _angular_core.Signal<number>;
162
+ protected readonly roving: _ids_group_ltd_ids_design_system_components.RovingMarks;
165
163
  protected onMarkFocus(index: number, event: FocusEvent): void;
166
164
  protected onMarkNavigation(event: KeyboardEvent, index: number): void;
167
165
  protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
@@ -23,6 +23,9 @@ declare class ChartDataTableComponent {
23
23
  /** Fires with the disclosure's state, so a chart with thousands of readings can build its rows
24
24
  * only while they are on screen. */
25
25
  readonly toggled: _angular_core.OutputEmitterRef<boolean>;
26
+ private readonly openedOnce;
27
+ protected readonly built: _angular_core.Signal<boolean>;
28
+ protected onToggle(open: boolean): void;
26
29
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartDataTableComponent, never>;
27
30
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartDataTableComponent, "ds-chart-data-table", never, { "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "rowHeader": { "alias": "rowHeader"; "required": false; "isSignal": true; }; }, { "toggled": "toggled"; }, never, never, true, never>;
28
31
  }
@@ -15,6 +15,9 @@ interface ChartTooltipEntry {
15
15
  /** Already through the chart's `valueFormat`, so the panel never formats. */
16
16
  readonly formatted: string;
17
17
  readonly color: string;
18
+ /** Marks whose fill is hatched rather than solid. The swatch takes the same treatment, so the
19
+ * panel and the plot encode the distinction the same way and neither relies on hue alone. */
20
+ readonly hatched?: boolean;
18
21
  /** A second line under the value, for what the chart does NOT already print beside the mark —
19
22
  * its share of the total, its rank, the drop into it. A tooltip that repeats the label a
20
23
  * reader is looking at has told them nothing. */
@@ -55,6 +58,9 @@ declare class ChartTooltipDirective {
55
58
  /** Opens the panel BELOW the mark first. A chart sets it while a mark is held, so the panel
56
59
  * leaves the plot's top edge — and the Unpin control that lives there — alone. */
57
60
  readonly dsChartTooltipPreferBelow: _angular_core.InputSignal<boolean>;
61
+ /** A held panel takes the pointer again, so its text can be selected. While it merely follows
62
+ * the pointer the pane stays inert, or the mark it covers never sees the pointer at all. */
63
+ readonly dsChartTooltipPinned: _angular_core.InputSignal<boolean>;
58
64
  private overlayRef;
59
65
  private panelRef;
60
66
  private detachScrollReposition;
@@ -65,7 +71,7 @@ declare class ChartTooltipDirective {
65
71
  private closeOnEscape;
66
72
  private close;
67
73
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartTooltipDirective, 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>;
74
+ 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; }; "dsChartTooltipPinned": { "alias": "dsChartTooltipPinned"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
69
75
  }
70
76
 
71
77
  /** @internal */
@@ -76,7 +82,9 @@ interface ChartActiveMark {
76
82
  readonly origin: Signal<Element | null>;
77
83
  /** Whether the active mark is held rather than followed — a tap, or a click under `pinOnClick`. */
78
84
  readonly pinned: Signal<boolean>;
79
- enter(index: number, event: Event, anchor?: string | Element | null): void;
85
+ /** `mark` is the hovered element, for a listener delegated to the marks' parent; it defaults to
86
+ * the event's `currentTarget`. */
87
+ enter(index: number, event: Event, anchor?: string | Element | null, mark?: Element): void;
80
88
  /** Moves the active index with no pointer behind it - a keyboard, or a mark handing over which
81
89
  * category it took focus on. Leaves the anchor alone: the caller that has no event has no
82
90
  * element to aim at either. A pin holds against this too. */
@@ -84,7 +92,7 @@ interface ChartActiveMark {
84
92
  leave(): void;
85
93
  /** Holds the mark that was activated, for any pointer type. Activating the mark that is already
86
94
  * pinned releases it, so one gesture both sets and clears. */
87
- pin(index: number, event: Event, anchor?: string | Element | null): void;
95
+ pin(index: number, event: Event, anchor?: string | Element | null, mark?: Element): void;
88
96
  /** Lets go of a held mark, for a control that offers the way out in as many words. */
89
97
  release(): void;
90
98
  }