@ids-group-ltd/ids-design-system 0.12.2 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (139) hide show
  1. package/CHANGELOG.md +751 -6
  2. package/components.md +87 -2
  3. package/docs/agent/INDEX.md +11 -1
  4. package/docs/agent/charts/chart-colour-which-palette-a-chart-takes.md +9 -0
  5. package/docs/agent/charts/chart-frame-the-box-a-chart-draws-around-itself.md +12 -0
  6. package/docs/agent/charts/ds-bar-chart.md +15 -0
  7. package/docs/agent/charts/ds-column-chart.md +14 -0
  8. package/docs/agent/charts/ds-donut-chart.md +17 -0
  9. package/docs/agent/charts/ds-funnel-chart.md +16 -0
  10. package/docs/agent/charts/ds-line-chart.md +15 -0
  11. package/docs/agent/forms/ds-button.md +6 -2
  12. package/docs/agent/forms/ds-number-stepper.md +1 -0
  13. package/docs/agent/navigation/ds-sidenav-item.md +1 -0
  14. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +2 -2
  15. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
  16. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +16 -14
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs +2 -2
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs.map +1 -1
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +161 -0
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -0
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs +20 -21
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +107 -40
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +43 -0
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -0
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +197 -0
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -0
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +10 -4
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +3 -2
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +173 -0
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -0
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +9 -6
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs +299 -0
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs.map +1 -0
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +2 -2
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +2 -2
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +69 -17
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +2 -2
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +366 -0
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -0
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +12 -16
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +631 -0
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -0
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +2 -2
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +1 -1
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +3 -2
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +2 -2
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +3 -2
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +2 -2
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +14 -22
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +1 -0
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +9 -6
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs +2 -2
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav-footer.mjs.map +1 -1
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +18 -7
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +1 -0
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +4 -3
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +10 -4
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +1 -1
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +30 -71
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +2 -2
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +3 -2
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  90. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +3 -2
  91. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  92. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +31 -9
  93. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  94. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs +2 -2
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-tree.mjs.map +1 -1
  96. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +409 -5
  97. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  98. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +17 -1
  99. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  100. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +3 -0
  101. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
  102. package/fesm2022/ids-group-ltd-ids-design-system.mjs +10 -1
  103. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  104. package/migrations/0.12.3.json +83 -0
  105. package/migrations/0.13.0.json +530 -0
  106. package/package.json +57 -1
  107. package/styles/_chart-data-table.scss +95 -0
  108. package/styles/_chart-frame.scss +53 -0
  109. package/styles/_chart-interactive.scss +40 -0
  110. package/styles/_chart-motion.scss +45 -0
  111. package/styles/_control-line.scss +45 -0
  112. package/styles/_field-state.scss +14 -15
  113. package/styles/_focus.scss +31 -60
  114. package/styles/_tokens-charts.scss +149 -39
  115. package/styles/_tokens.scss +35 -31
  116. package/themes/dark/_theme.scss +37 -29
  117. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +11 -9
  118. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +104 -0
  119. package/types/ids-group-ltd-ids-design-system-components-breadcrumbs.d.ts +8 -17
  120. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +60 -30
  121. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +34 -0
  122. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +78 -0
  123. package/types/ids-group-ltd-ids-design-system-components-checkbox.d.ts +6 -1
  124. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +105 -0
  125. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +4 -1
  126. package/types/ids-group-ltd-ids-design-system-components-donut-chart.d.ts +113 -0
  127. package/types/ids-group-ltd-ids-design-system-components-field-group.d.ts +52 -11
  128. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +109 -0
  129. package/types/ids-group-ltd-ids-design-system-components-input.d.ts +5 -7
  130. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +241 -0
  131. package/types/ids-group-ltd-ids-design-system-components-radio-group.d.ts +10 -10
  132. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +5 -2
  133. package/types/ids-group-ltd-ids-design-system-components-sidenav.d.ts +16 -4
  134. package/types/ids-group-ltd-ids-design-system-components-switch.d.ts +6 -1
  135. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +13 -28
  136. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +11 -1
  137. package/types/ids-group-ltd-ids-design-system-components.d.ts +163 -3
  138. package/types/ids-group-ltd-ids-design-system-core.d.ts +12 -1
  139. package/types/ids-group-ltd-ids-design-system.d.ts +9 -2
@@ -1,7 +1,8 @@
1
1
  import * as _ids_group_ltd_ids_design_system_components from '@ids-group-ltd/ids-design-system/components';
2
- import { DsMessageBase } from '@ids-group-ltd/ids-design-system/components';
2
+ import { DsMessageBase, DsRouterLink, DsAriaCurrent, DsLinkModifiers } from '@ids-group-ltd/ids-design-system/components';
3
3
  import * as _angular_core from '@angular/core';
4
4
  import { ElementRef } from '@angular/core';
5
+ import { Params, QueryParamsHandling, IsActiveMatchOptions } from '@angular/router';
5
6
  import { DsSize, IconName } from '@ids-group-ltd/ids-design-system/core';
6
7
 
7
8
  type ButtonColor = 'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning';
@@ -9,33 +10,65 @@ type ButtonVariant = 'solid' | 'tonal' | 'ghost' | 'outline' | 'text';
9
10
  type ButtonType = 'button' | 'submit' | 'reset';
10
11
 
11
12
  declare class ButtonComponent extends DsMessageBase {
12
- /** Segment of a ds-field-group: the group owns the border, radius and focus
13
- * ring, so .in-group strips this control back to its bare contents. */
14
13
  protected readonly inGroup: boolean;
15
14
  /** Brand/status hue family. */
16
15
  readonly color: _angular_core.InputSignal<ButtonColor>;
17
- /** Fill pattern: solid | tonal | ghost | outline | text. All color×variant
18
- pairs render; some are UX-discouraged and emit a dev-mode
19
- warning naming the reason — they work, but read poorly. `text` is
20
- discouraged for ALL colours — prefer the global `.link` class; it stays for
21
- cases needing the ds-button API (loading/fullWidth/typed pressed). */
16
+ /** Fill pattern. Every color×variant pair renders; the discouraged ones dev-warn with the
17
+ * reason. `text` is discouraged for every colour — prefer the global `.link` class, and keep
18
+ * this one only where the ds-button API is needed. */
22
19
  readonly variant: _angular_core.InputSignal<ButtonVariant>;
23
20
  /** Button height — sm/md/lg.
24
21
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
25
22
  readonly size: _angular_core.InputSignal<DsSize | null>;
26
23
  readonly sizeResolved: _angular_core.Signal<DsSize>;
27
- /** Native `<button>` `type`; defaults to `'button'` (not `'submit'`) so it never submits an ancestor form by accident. */
24
+ /** `RouterLink` target. Set it and the button renders an `<a [routerLink]>` with
25
+ * `routerLinkActive`: middle-click, open-in-new-tab and the announced "link" role depend on the
26
+ * element, not on the look.
27
+ *
28
+ * Accepts a `UrlTree` as well as a path or a command array — `Router.createUrlTree` is the way
29
+ * to reach the `UrlCreationOptions` that have no input of their own here (`relativeTo`,
30
+ * `preserveFragment`). */
31
+ readonly routerLink: _angular_core.InputSignal<DsRouterLink>;
32
+ /** Plain `href` target, used when `routerLink` is not set — an external address or a download.
33
+ * Renders an `<a href>`; same reasoning as `routerLink`. */
34
+ readonly href: _angular_core.InputSignal<string>;
35
+ /** Hash to append to a `routerLink` destination — the section of the page to land on.
36
+ * routerLink-only: on an `href` put it in the URL, and on a plain button it is ignored with a
37
+ * dev warning. */
38
+ readonly fragment: _angular_core.InputSignal<string | undefined>;
39
+ /** Query parameters for a `routerLink` destination. routerLink-only, same as `fragment`. */
40
+ readonly queryParams: _angular_core.InputSignal<Params | null | undefined>;
41
+ /** How the destination's query merges with the current one — `'merge'`, `'preserve'` or
42
+ * `'replace'`. routerLink-only. */
43
+ readonly queryParamsHandling: _angular_core.InputSignal<QueryParamsHandling | null | undefined>;
44
+ /** Browsing context for the link — `'_blank'` and the rest. Both link destinations take it; on a
45
+ * plain button it is ignored with a dev warning. */
46
+ readonly target: _angular_core.InputSignal<string | undefined>;
47
+ /** `rel` for the link. Pair it with `target="_blank"`: without `noopener` the opened page can
48
+ * reach back through `window.opener`. Both link destinations take it. */
49
+ readonly rel: _angular_core.InputSignal<string | undefined>;
50
+ /** How `routerLinkActive` decides the `active` CLASS — prefix by default, so a section link
51
+ * stays lit inside its own pages. It also bounds the announcement, because the same directive
52
+ * writes it: narrowed to `{ exact: true }`, a prefix match is no longer active and the link
53
+ * announces nothing rather than `true`. Pass `ariaCurrent` alongside to keep one. */
54
+ readonly routerLinkActiveOptions: _angular_core.InputSignal<IsActiveMatchOptions | {
55
+ exact: boolean;
56
+ }>;
57
+ /** Overrides what the link announces. Unset, an exact match announces `page` and a prefix match
58
+ * announces `true`, which is what ARIA means by each; pass `null` to announce nothing, or one
59
+ * of the other values when the link is a step or a location rather than a page. */
60
+ readonly ariaCurrent: _angular_core.InputSignal<DsAriaCurrent | null | undefined>;
61
+ /** Native `type`, defaulting to `'button'` so it never submits an ancestor form by accident.
62
+ * Button-only: ignored on a link, with a dev warning. */
28
63
  readonly type: _angular_core.InputSignal<ButtonType>;
29
64
  /** Disables the button and blocks `pressed`. */
30
65
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
31
- /** Busy state — disables interaction and sets `aria-busy`. */
66
+ /** Busy state — disables interaction and sets `aria-busy`. Button-only: a navigation cannot be
67
+ * in flight before it starts, so on an anchor it is ignored with a dev-mode warning. */
32
68
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
33
- /** Stretch the button to fill its container — the host becomes block-level
34
- and 100% wide (the inner control is already full-width). Use for mobile
35
- primary CTAs and full-bleed form submit buttons. */
69
+ /** Stretch to fill the container: the host becomes block-level and 100% wide. */
36
70
  readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
37
- /** Accessible name — forwarded to the inner <button> as aria-label. Use when
38
- the visible label is absent or non-descriptive. */
71
+ /** Accessible name, forwarded as `aria-label`. For an icon-only or non-descriptive label. */
39
72
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
40
73
  /** Leading icon, before the projected content. */
41
74
  readonly icon: _angular_core.InputSignal<IconName | null>;
@@ -50,16 +83,11 @@ declare class ButtonComponent extends DsMessageBase {
50
83
  /** ARIA `aria-controls`, forwarded to the inner <button> — the id of the panel
51
84
  * this button opens, e.g. `ds-app-layout`'s `railId`. */
52
85
  readonly ariaControls: _angular_core.InputSignal<string | null>;
53
- /** Why the button is refused, shown as its second line. Read only while
54
- * `disabled` — a greyed control that does not say why is a dead end.
55
- *
56
- * Setting it also changes HOW the button is disabled: it takes `aria-disabled`
57
- * instead of the native attribute, because a natively disabled button cannot be
58
- * focused and the reason would never be announced. The click is swallowed in
59
- * `onClick` instead. Leave it unset and nothing changes.
60
- *
61
- * Length is deliberately not capped: the text wraps and the button grows. Same
62
- * name and meaning as `TableRowAction.disabledReason`. */
86
+ /** Why the button is refused, shown as its second line and read only while `disabled`. Setting
87
+ * it also changes HOW the button is disabled — `aria-disabled` instead of the native attribute,
88
+ * because a natively disabled button cannot be focused and the reason would never be announced,
89
+ * so the click is swallowed in `onClick` instead. Uncapped: the text wraps and the button grows.
90
+ * Same name and meaning as `TableRowAction.disabledReason`. */
63
91
  readonly disabledReason: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
64
92
  /** ARIA `aria-describedby` — point the button at a description the app renders
65
93
  * itself, such as a `ds-field-message` under a form. Merged with the id of
@@ -67,10 +95,12 @@ declare class ButtonComponent extends DsMessageBase {
67
95
  readonly ariaDescribedBy: _angular_core.InputSignal<string | null>;
68
96
  /** Fires on click, unless `disabled` or `loading`. */
69
97
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
70
- /** The inner native <button>, exposed so overlay triggers can position
71
- * against and restore focus to the real focusable element — e.g.
72
- * `(pressed)="pop.toggle(trigger.buttonRef().nativeElement)"`. */
73
- readonly buttonRef: _angular_core.Signal<ElementRef<HTMLButtonElement>>;
98
+ /** The inner control, for an overlay trigger to position against and restore focus to. Typed
99
+ * `HTMLElement`, not `HTMLButtonElement`: the element follows the destination. */
100
+ readonly controlRef: _angular_core.Signal<ElementRef<HTMLElement>>;
101
+ protected readonly destination: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.DsDestination>;
102
+ protected readonly linkModifiers: _angular_core.Signal<DsLinkModifiers>;
103
+ protected readonly ariaCurrentResolved: _angular_core.Signal<DsAriaCurrent | undefined>;
74
104
  protected readonly classes: _angular_core.Signal<string>;
75
105
  protected readonly softDisabled: _angular_core.Signal<boolean>;
76
106
  private readonly uid;
@@ -83,7 +113,7 @@ declare class ButtonComponent extends DsMessageBase {
83
113
  constructor();
84
114
  protected onClick(event: MouseEvent): void;
85
115
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonComponent, never>;
86
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonComponent, "ds-button", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "trailingIcon": { "alias": "trailingIcon"; "required": false; "isSignal": true; }; "ariaHasPopup": { "alias": "ariaHasPopup"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; "ariaControls": { "alias": "ariaControls"; "required": false; "isSignal": true; }; "disabledReason": { "alias": "disabledReason"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["*", "[dsButtonSubtext]"], true, never>;
116
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonComponent, "ds-button", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "routerLink": { "alias": "routerLink"; "required": false; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "fragment": { "alias": "fragment"; "required": false; "isSignal": true; }; "queryParams": { "alias": "queryParams"; "required": false; "isSignal": true; }; "queryParamsHandling": { "alias": "queryParamsHandling"; "required": false; "isSignal": true; }; "target": { "alias": "target"; "required": false; "isSignal": true; }; "rel": { "alias": "rel"; "required": false; "isSignal": true; }; "routerLinkActiveOptions": { "alias": "routerLinkActiveOptions"; "required": false; "isSignal": true; }; "ariaCurrent": { "alias": "ariaCurrent"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "trailingIcon": { "alias": "trailingIcon"; "required": false; "isSignal": true; }; "ariaHasPopup": { "alias": "ariaHasPopup"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; "ariaControls": { "alias": "ariaControls"; "required": false; "isSignal": true; }; "disabledReason": { "alias": "disabledReason"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["*", "[dsButtonSubtext]"], true, never>;
87
117
  }
88
118
 
89
119
  export { ButtonComponent };
@@ -0,0 +1,34 @@
1
+ import * as _angular_core from '@angular/core';
2
+
3
+ interface ChartLegendItem {
4
+ /** Matches the series or slice id the chart hides by. */
5
+ readonly id: string;
6
+ readonly label: string;
7
+ readonly color: string;
8
+ }
9
+
10
+ /**
11
+ * The key beside a chart, and — when `toggleable` — the control that hides a series.
12
+ *
13
+ * Ordinary DOM, never inside the `<svg>`: an item is a real `<input type="checkbox">`, which is
14
+ * what makes the toggle keyboard-operable and correctly announced without inventing a role.
15
+ *
16
+ * @internal
17
+ */
18
+ declare class ChartLegendComponent {
19
+ readonly items: _angular_core.InputSignal<readonly ChartLegendItem[]>;
20
+ /** Ids of the hidden items. Two-way, so a page can drive it from a URL parameter and so
21
+ * cross-chart filtering later is this same mechanism. */
22
+ readonly hidden: _angular_core.ModelSignal<readonly string[]>;
23
+ /** Offers the toggle. Off leaves the legend a plain key. */
24
+ readonly toggleable: _angular_core.InputSignalWithTransform<boolean, unknown>;
25
+ /** The item under the pointer or holding focus, which is what the chart dims from. */
26
+ readonly highlighted: _angular_core.ModelSignal<string | null>;
27
+ protected isHidden(id: string): boolean;
28
+ protected toggle(id: string): void;
29
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartLegendComponent, never>;
30
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChartLegendComponent, "ds-chart-legend", never, { "items": { "alias": "items"; "required": true; "isSignal": true; }; "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; "toggleable": { "alias": "toggleable"; "required": false; "isSignal": true; }; "highlighted": { "alias": "highlighted"; "required": false; "isSignal": true; }; }, { "hidden": "hiddenChange"; "highlighted": "highlightedChange"; }, never, never, true, never>;
31
+ }
32
+
33
+ export { ChartLegendComponent };
34
+ export type { ChartLegendItem };
@@ -0,0 +1,78 @@
1
+ import * as _angular_core from '@angular/core';
2
+ import { TemplateRef, Signal } from '@angular/core';
3
+
4
+ /** Which mark a chart's tooltip answers for. `'item'` is the mark under the pointer;
5
+ * `'axis'` is every series at the category under the pointer, which is what a line
6
+ * chart needs and a bar chart does not. */
7
+ type ChartTooltipTrigger = 'item' | 'axis' | 'none';
8
+ /** The subset a chart whose marks ARE its categories offers. Spelled out rather than written as
9
+ * `Exclude<ChartTooltipTrigger, 'axis'>`: the React wrapper generator cannot resolve a built-in
10
+ * utility type, so the conditional collapses the whole input to `unknown` on that side. */
11
+ type ChartItemTooltipTrigger = 'item' | 'none';
12
+ interface ChartTooltipEntry {
13
+ readonly label: string;
14
+ readonly value: number;
15
+ /** Already through the chart's `valueFormat`, so the panel never formats. */
16
+ readonly formatted: string;
17
+ readonly color: string;
18
+ }
19
+ interface ChartTooltipContext {
20
+ /** Empty on a chart whose marks are the categories, where the entry label says it. */
21
+ readonly category: string;
22
+ readonly entries: readonly ChartTooltipEntry[];
23
+ }
24
+ /** Where the panel is anchored: the mark's own element, or a point in client
25
+ * coordinates for a chart whose active mark has no element of its own. */
26
+ type ChartTooltipOrigin = Element | {
27
+ readonly x: number;
28
+ readonly y: number;
29
+ };
30
+
31
+ /**
32
+ * The chart tooltip, driven entirely by the context a chart hands it: non-null opens the
33
+ * panel, null closes it. Pointer and keyboard therefore share one path — a chart that
34
+ * sets the context on `focus` gets the panel with no pointer involved.
35
+ *
36
+ * @internal
37
+ */
38
+ declare class ChartTooltipDirective {
39
+ private readonly overlay;
40
+ private readonly viewContainerRef;
41
+ readonly dsChartTooltip: _angular_core.InputSignal<ChartTooltipContext | null>;
42
+ readonly dsChartTooltipOrigin: _angular_core.InputSignal<ChartTooltipOrigin | null>;
43
+ readonly dsChartTooltipTemplate: _angular_core.InputSignal<TemplateRef<{
44
+ $implicit: ChartTooltipContext;
45
+ }> | null>;
46
+ private overlayRef;
47
+ private panelRef;
48
+ constructor();
49
+ private open;
50
+ private strategyFor;
51
+ private close;
52
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChartTooltipDirective, never>;
53
+ 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; }; }, {}, never, never, true, never>;
54
+ }
55
+
56
+ interface ChartActiveMark {
57
+ /** Index of the mark under the pointer or holding focus; `-1` when none is. */
58
+ readonly index: Signal<number>;
59
+ /** The mark's own element, which is what the tooltip anchors to. */
60
+ readonly origin: Signal<Element | null>;
61
+ enter(index: number, event: Event): void;
62
+ leave(): void;
63
+ }
64
+ /**
65
+ * The pointer-and-focus target the tooltip reads, for a chart whose marks are elements.
66
+ * Pointer and keyboard write the same pair, so a chart wires `pointerenter` and `focus` to
67
+ * `enter` and gets one code path rather than two.
68
+ *
69
+ * A TAP LATCHES. A touch fires `pointerleave` the moment the finger lifts, so without this the
70
+ * panel would flash and vanish; latched, it stays until the next tap lands outside the mark. Call
71
+ * from an injection context — the release listener is torn down with the component.
72
+ *
73
+ * @internal
74
+ */
75
+ declare function chartActiveMark(): ChartActiveMark;
76
+
77
+ export { ChartTooltipDirective, chartActiveMark };
78
+ export type { ChartActiveMark, ChartItemTooltipTrigger, ChartTooltipContext, ChartTooltipEntry, ChartTooltipOrigin, ChartTooltipTrigger };
@@ -24,18 +24,23 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
24
24
  /** Inline label rendered beside the box and wired via for/id. Omit to
25
25
  * bring your own <label>. */
26
26
  readonly label: _angular_core.InputSignal<string>;
27
+ /** Accessible name for a control with no visible label — the row's `<label>` collapses when it
28
+ * is empty, leaving nothing to name it. Set beside a label it OVERRIDES the label, per ARIA. */
29
+ readonly ariaLabel: _angular_core.InputSignal<string | null>;
27
30
  protected readonly isDisabled: _angular_core.Signal<boolean>;
28
31
  protected readonly uid: string;
29
32
  protected readonly controlId: _angular_core.Signal<string>;
30
33
  protected readonly hintId: _angular_core.Signal<string | null>;
31
34
  private readonly fieldMessage;
32
35
  protected readonly message: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.DsFieldMessage>;
36
+ /** Only name via aria-label when there is no visible `<label for>` to do it. */
37
+ protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
33
38
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
34
39
  protected readonly controlState: _angular_core.Signal<_ids_group_ltd_ids_design_system_components_field_message.FieldMessageState | null>;
35
40
  protected readonly fieldClass: _angular_core.Signal<string>;
36
41
  protected onCheckedChange(event: Event): void;
37
42
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<CheckboxComponent, never>;
38
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxComponent, "ds-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "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; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
43
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxComponent, "ds-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "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>;
39
44
  }
40
45
 
41
46
  export { CheckboxComponent };
@@ -0,0 +1,105 @@
1
+ import * as _ids_group_ltd_ids_design_system_components_chart_tooltip from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
2
+ import { ChartItemTooltipTrigger, ChartTooltipContext } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
3
+ import * as _angular_core from '@angular/core';
4
+ import { TemplateRef } from '@angular/core';
5
+
6
+ interface ColumnChartPoint {
7
+ /** Falls back to the column's position when left out, so a reorder rewrites the DOM. */
8
+ id?: string;
9
+ label: string;
10
+ value: number;
11
+ /** Overrides this column's colour. Columns take the categorical palette by
12
+ * position; set this where a column carries a meaning its position does not,
13
+ * such as the accent on the period the reader should land on. */
14
+ color?: string;
15
+ }
16
+
17
+ declare class ColumnChartComponent {
18
+ /** One column per point, drawn in the order given. */
19
+ readonly data: _angular_core.InputSignal<readonly ColumnChartPoint[]>;
20
+ /** Prints each column's value above the column. */
21
+ readonly showValues: _angular_core.InputSignalWithTransform<boolean, unknown>;
22
+ /** How many value-axis ticks to aim for. A hint, not a count: ticks are
23
+ * snapped to a round step, so the axis may carry one more or one fewer. */
24
+ readonly tickCount: _angular_core.InputSignalWithTransform<number, unknown>;
25
+ /** Printed above the plot as the chart's visible title, and reused as the annex table's
26
+ * caption. */
27
+ readonly caption: _angular_core.InputSignal<string | null>;
28
+ /** Accessible name. Generated from the data when omitted. */
29
+ readonly summary: _angular_core.InputSignal<string | null>;
30
+ /** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
31
+ * `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
32
+ * `'none'` belongs only where the same data is already in a table on the page. */
33
+ readonly dataTable: _angular_core.InputSignal<"toggle" | "visible" | "none">;
34
+ /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
35
+ * when the data lands. */
36
+ readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
37
+ /** Shown in place of the plot when `data` is empty. */
38
+ readonly emptyText: _angular_core.InputSignal<string>;
39
+ /** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
40
+ * because "the request failed" and "there is nothing to show" read the same to a reader and
41
+ * mean opposite things. */
42
+ readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
43
+ /** The message the error state prints. */
44
+ readonly errorText: _angular_core.InputSignal<string>;
45
+ /** Formats every value the chart prints, the annex table and the generated description
46
+ * included. Defaults to the browser's locale grouping with a K/M/B suffix past four digits. */
47
+ readonly valueFormat: _angular_core.InputSignal<(value: number) => string>;
48
+ /** Turns on the click affordance — the pointer cursor and any hover tint.
49
+ * The click output fires whether or not this is set, so a consumer that
50
+ * binds the output and forgets the flag still receives every click. */
51
+ readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
52
+ /** The point that was clicked, or activated with Enter or Space. Fires whether or not
53
+ * `interactive` is set. */
54
+ readonly pointClicked: _angular_core.OutputEmitterRef<ColumnChartPoint>;
55
+ /** Milliseconds between one mark's entrance and the next. `0`, the default, is no stagger at
56
+ * all; `40` is the documented non-zero step. The total is capped, so a long series does not
57
+ * crawl in. */
58
+ readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
59
+ protected markStagger(index: number): string;
60
+ /** Whether a hovered or focused column opens a tooltip. `'axis'` is not offered — a
61
+ * column chart's marks ARE its categories, so an axis tooltip would repeat the item one. */
62
+ readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
63
+ protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
64
+ $implicit: ChartTooltipContext;
65
+ }> | undefined>;
66
+ protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
67
+ /** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
68
+ * every mouse-operable control has to be separately focusable, and that is what keeps a
69
+ * twenty-five mark chart from being twenty-five stops in the page's tab order. */
70
+ protected readonly rovingIndex: _angular_core.WritableSignal<number>;
71
+ protected readonly tabStopIndex: _angular_core.Signal<number>;
72
+ protected onMarkFocus(index: number, event: FocusEvent): void;
73
+ protected onMarkNavigation(event: KeyboardEvent, index: number): void;
74
+ protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
75
+ protected readonly domainMax: _angular_core.Signal<number>;
76
+ /** Top of the value axis: the domain rounded up to a whole tick, so the
77
+ * tallest column ends on a gridline rather than between two. */
78
+ protected readonly axisMax: _angular_core.Signal<number>;
79
+ protected readonly ticks: _angular_core.Signal<{
80
+ label: string;
81
+ offsetPercent: number;
82
+ }[]>;
83
+ protected readonly columns: _angular_core.Signal<{
84
+ key: string;
85
+ point: ColumnChartPoint;
86
+ heightPercent: number;
87
+ formattedValue: string;
88
+ color: string;
89
+ }[]>;
90
+ protected readonly accessibleName: _angular_core.Signal<string>;
91
+ protected entryLabel(entry: {
92
+ point: ColumnChartPoint;
93
+ formattedValue: string;
94
+ }): string;
95
+ protected onPointKey(point: ColumnChartPoint, event: Event): void;
96
+ protected readonly isEmpty: _angular_core.Signal<boolean>;
97
+ /** Placeholder columns while loading. Follows the real point count so the chart does not resize
98
+ * when the data lands; falls back to three when `data` is still empty. */
99
+ protected readonly skeletonColumns: _angular_core.Signal<unknown[]>;
100
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColumnChartComponent, never>;
101
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnChartComponent, "ds-column-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "showValues": { "alias": "showValues"; "required": false; "isSignal": true; }; "tickCount": { "alias": "tickCount"; "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; }; "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; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; }, ["tooltipTemplate"], never, true, never>;
102
+ }
103
+
104
+ export { ColumnChartComponent };
105
+ export type { ColumnChartPoint };
@@ -4,6 +4,7 @@ import { DsControlValueAccessor, DsOverlayCloseCause } from '@ids-group-ltd/ids-
4
4
  import * as _angular_core from '@angular/core';
5
5
  import { OnDestroy, ElementRef, TemplateRef } from '@angular/core';
6
6
  import { DsSize } from '@ids-group-ltd/ids-design-system/core';
7
+ import { describedByIds } from '@ids-group-ltd/ids-design-system/components/field-group';
7
8
 
8
9
  interface DateFormatSpec {
9
10
  order: ('D' | 'M' | 'Y')[];
@@ -64,7 +65,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
64
65
  private readonly config;
65
66
  private readonly host;
66
67
  /** Public panel tokens forwarded onto the portaled overlay pane on open so
67
- * a consumer's `ds-date-picker { --ds-date-picker-panel-*: … }` reaches it. */
68
+ * a consumer's `ds-date-picker { --ds-date-picker-*: … }` reaches it. */
68
69
  private readonly panelTokens;
69
70
  /** Selection mode — single date or start/end range. */
70
71
  readonly mode: _angular_core.InputSignal<DatePickerMode>;
@@ -124,6 +125,8 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
124
125
  private readonly fieldMessage;
125
126
  protected readonly message: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.DsFieldMessage>;
126
127
  protected readonly controlState: _angular_core.Signal<_ids_group_ltd_ids_design_system_components_field_message.FieldMessageState | null>;
128
+ protected readonly groupMessage: _angular_core.Signal<string | null>;
129
+ protected readonly describedByIds: typeof describedByIds;
127
130
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
128
131
  readonly resolvedLocale: _angular_core.Signal<string>;
129
132
  protected readonly resolvedFirstDay: _angular_core.Signal<number>;
@@ -0,0 +1,113 @@
1
+ import * as _ids_group_ltd_ids_design_system_components_chart_tooltip from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
2
+ import { ChartItemTooltipTrigger, ChartTooltipContext } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
3
+ import * as _angular_core from '@angular/core';
4
+ import { TemplateRef } from '@angular/core';
5
+
6
+ interface DonutChartSlice {
7
+ id: string;
8
+ label: string;
9
+ value: number;
10
+ /** 1-based palette slot. Pinning a slice to a slot keeps every other slice's
11
+ * colour where it is when one is filtered out of `data`; left off, the colour
12
+ * follows the index and the whole ring repaints. */
13
+ slot?: number;
14
+ }
15
+
16
+ declare class DonutChartComponent {
17
+ /** One slice per entry. A non-positive or non-finite value counts as zero — a ring is a
18
+ * part-to-whole picture and has no way to draw a negative share. */
19
+ readonly data: _angular_core.InputSignal<readonly DonutChartSlice[]>;
20
+ /** Printed inside the ring. Null prints the sum through `valueFormat`. */
21
+ readonly centerValue: _angular_core.InputSignal<string | null>;
22
+ /** Caption under the centre value. */
23
+ readonly centerLabel: _angular_core.InputSignal<string | null>;
24
+ /** Logical placement, so a right-to-left page needs no second value. */
25
+ readonly legend: _angular_core.InputSignal<"end" | "bottom" | "none">;
26
+ /** Longest legend to draw. Past it the smallest slices are summed into one, so a long tail does
27
+ * not become a legend nobody reads. Off by default: grouping changes what the chart says, and
28
+ * that is the consumer's call. Values below 2 are ignored — one slice is not a donut. */
29
+ readonly maxSlices: _angular_core.InputSignalWithTransform<number | null, number | null>;
30
+ /** Names the grouped slice. */
31
+ readonly otherLabel: _angular_core.InputSignal<string>;
32
+ /** Ring width as a fraction of the radius. */
33
+ readonly thickness: _angular_core.InputSignalWithTransform<number, unknown>;
34
+ /** Printed above the plot as the chart's visible title, and reused as the annex table's
35
+ * caption. */
36
+ readonly caption: _angular_core.InputSignal<string | null>;
37
+ /** Accessible name. Generated from the data when omitted. */
38
+ readonly summary: _angular_core.InputSignal<string | null>;
39
+ /** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
40
+ * `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
41
+ * `'none'` belongs only where the same data is already in a table on the page. */
42
+ readonly dataTable: _angular_core.InputSignal<"none" | "toggle" | "visible">;
43
+ /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
44
+ * when the data lands. */
45
+ readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
46
+ /** Shown in place of the plot when `data` is empty. */
47
+ readonly emptyText: _angular_core.InputSignal<string>;
48
+ /** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
49
+ * because "the request failed" and "there is nothing to show" read the same to a reader and
50
+ * mean opposite things. */
51
+ readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
52
+ /** The message the error state prints. */
53
+ readonly errorText: _angular_core.InputSignal<string>;
54
+ /** Formats every value the chart prints, the annex table and the generated description
55
+ * included. Defaults to the browser's locale grouping with a K/M/B suffix past four digits. */
56
+ readonly valueFormat: _angular_core.InputSignal<(value: number) => string>;
57
+ /** Turns on the click affordance — the pointer cursor and any hover tint.
58
+ * The click output fires whether or not this is set, so a consumer that
59
+ * binds the output and forgets the flag still receives every click. */
60
+ readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
61
+ /** The slice that was clicked, or activated with Enter or Space. Fires whether or not
62
+ * `interactive` is set. */
63
+ readonly sliceClicked: _angular_core.OutputEmitterRef<DonutChartSlice>;
64
+ /** Milliseconds between one mark's entrance and the next. `0`, the default, is no stagger at
65
+ * all; `40` is the documented non-zero step. The total is capped, so a long series does not
66
+ * crawl in. */
67
+ readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
68
+ protected markStagger(index: number): string;
69
+ /** Whether a hovered or focused slice opens a tooltip. `'axis'` is not offered — a ring
70
+ * has no axis to group readings under. */
71
+ readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
72
+ protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
73
+ $implicit: ChartTooltipContext;
74
+ }> | undefined>;
75
+ protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
76
+ /** One tab stop per chart, not one per slice: WCAG 2.1.1's Understanding is explicit that not
77
+ * every mouse-operable control has to be separately focusable. */
78
+ protected readonly rovingIndex: _angular_core.WritableSignal<number>;
79
+ protected readonly tabStopIndex: _angular_core.Signal<number>;
80
+ protected onMarkFocus(index: number, event: FocusEvent): void;
81
+ protected onMarkNavigation(event: KeyboardEvent, index: number, scope: string): void;
82
+ protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
83
+ protected readonly viewBox = "0 0 100 100";
84
+ protected readonly total: _angular_core.Signal<number>;
85
+ protected readonly visibleSlices: _angular_core.Signal<DonutChartSlice[]>;
86
+ protected readonly slices: _angular_core.Signal<{
87
+ slice: DonutChartSlice;
88
+ path: string;
89
+ color: string;
90
+ formattedValue: string;
91
+ formattedPercent: string;
92
+ }[]>;
93
+ protected readonly resolvedCenterValue: _angular_core.Signal<string>;
94
+ protected readonly accessibleName: _angular_core.Signal<string>;
95
+ protected readonly hole: _angular_core.Signal<number>;
96
+ protected entryLabel(entry: {
97
+ slice: DonutChartSlice;
98
+ formattedValue: string;
99
+ formattedPercent: string;
100
+ }): string;
101
+ protected onSliceKey(slice: DonutChartSlice, event: Event): void;
102
+ protected readonly ringCarriesTheRoute: _angular_core.Signal<boolean>;
103
+ protected readonly isEmpty: _angular_core.Signal<boolean>;
104
+ /** Placeholder legend rows while loading. Follows the real slice count so the
105
+ * chart does not resize when the data lands; falls back to three when `data`
106
+ * is still empty. */
107
+ protected readonly skeletonRows: _angular_core.Signal<unknown[]>;
108
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<DonutChartComponent, never>;
109
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<DonutChartComponent, "ds-donut-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "centerValue": { "alias": "centerValue"; "required": false; "isSignal": true; }; "centerLabel": { "alias": "centerLabel"; "required": false; "isSignal": true; }; "legend": { "alias": "legend"; "required": false; "isSignal": true; }; "maxSlices": { "alias": "maxSlices"; "required": false; "isSignal": true; }; "otherLabel": { "alias": "otherLabel"; "required": false; "isSignal": true; }; "thickness": { "alias": "thickness"; "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; }; "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; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "sliceClicked": "sliceClicked"; }, ["tooltipTemplate"], never, true, never>;
110
+ }
111
+
112
+ export { DonutChartComponent };
113
+ export type { DonutChartSlice };