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

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 (104) hide show
  1. package/CHANGELOG.md +656 -3
  2. package/components.md +32 -11
  3. package/docs/agent/INDEX.md +2 -0
  4. package/docs/agent/charts/ds-bar-chart.md +1 -1
  5. package/docs/agent/charts/ds-column-chart.md +1 -1
  6. package/docs/agent/charts/ds-config.md +12 -0
  7. package/docs/agent/charts/ds-donut-chart.md +2 -2
  8. package/docs/agent/charts/ds-funnel-chart.md +1 -1
  9. package/docs/agent/charts/ds-line-chart.md +3 -2
  10. package/docs/agent/feedback/ds-meter.md +11 -0
  11. package/docs/agent/feedback/ds-progress.md +4 -1
  12. package/docs/agent/forms/ds-button.md +1 -1
  13. package/docs/agent/forms/ds-icon-button.md +1 -1
  14. package/docs/agent/surfaces/ds-card.md +1 -1
  15. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs +2 -2
  16. package/fesm2022/ids-group-ltd-ids-design-system-components-accordion.mjs.map +1 -1
  17. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs +2 -2
  18. package/fesm2022/ids-group-ltd-ids-design-system-components-alert.mjs.map +1 -1
  19. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs +9 -4
  20. package/fesm2022/ids-group-ltd-ids-design-system-components-autocomplete.mjs.map +1 -1
  21. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +2 -2
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +100 -15
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -1
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +2 -2
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +3 -0
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +47 -5
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -1
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +155 -21
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -1
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +9 -4
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +81 -18
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -1
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +9 -4
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs +75 -23
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs.map +1 -1
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +2 -1
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +2 -2
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +107 -19
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -1
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +236 -31
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -1
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +2 -1
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-meter.mjs +61 -0
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-meter.mjs.map +1 -0
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +4 -4
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +9 -4
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs +2 -2
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs.map +1 -1
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +1 -1
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs +34 -10
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-progress.mjs.map +1 -1
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +9 -4
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +2 -2
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +9 -4
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +2 -2
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  71. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +119 -13
  72. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  73. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  74. package/fesm2022/ids-group-ltd-ids-design-system.mjs +1 -0
  75. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  76. package/migrations/0.13.1.json +236 -0
  77. package/migrations/0.13.2.json +269 -0
  78. package/package.json +9 -1
  79. package/styles/_chart-frame.scss +116 -4
  80. package/styles/_chart-interactive.scss +27 -7
  81. package/styles/_chart-motion.scss +61 -18
  82. package/styles/_dropdown-overlay.scss +9 -3
  83. package/styles/_focus.scss +10 -1
  84. package/styles/_overlay-motion.scss +11 -1
  85. package/styles/_tokens-charts.scss +5 -0
  86. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +6 -1
  87. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +87 -10
  88. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +1 -0
  89. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +25 -2
  90. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +23 -3
  91. package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +6 -1
  92. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +60 -9
  93. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +6 -1
  94. package/types/ids-group-ltd-ids-design-system-components-donut-chart.d.ts +53 -13
  95. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +73 -11
  96. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +116 -12
  97. package/types/ids-group-ltd-ids-design-system-components-meter.d.ts +36 -0
  98. package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +6 -1
  99. package/types/ids-group-ltd-ids-design-system-components-progress.d.ts +21 -3
  100. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +6 -1
  101. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +6 -1
  102. package/types/ids-group-ltd-ids-design-system-components.d.ts +47 -5
  103. package/types/ids-group-ltd-ids-design-system-core.d.ts +40 -1
  104. package/types/ids-group-ltd-ids-design-system.d.ts +6 -5
@@ -4,18 +4,36 @@ import { DsStatus } from '@ids-group-ltd/ids-design-system/core';
4
4
  type ProgressVariant = 'default' | Exclude<DsStatus, 'info'>;
5
5
 
6
6
  declare class ProgressComponent {
7
- /** Progress 0–100; clamped, and ignored while `indeterminate`. */
7
+ /** Progress in units of `max`, so 0–100 by default; clamped, and ignored while
8
+ * `indeterminate`. */
8
9
  readonly value: _angular_core.InputSignal<number>;
10
+ /** The full scale `value` and `target` are read against. Left at 100 they are percentages, which
11
+ * is why nothing existing changes. Set it to the real total — `[value]="37" [max]="80"` — and
12
+ * the accessible name carries "37 of 80" rather than the 46% a caller would otherwise have to
13
+ * compute and a screen reader would read instead. Zero or less falls back to 100, because a
14
+ * scale with no width has no fraction to draw. */
15
+ readonly max: _angular_core.InputSignal<number>;
9
16
  /** Colour variant — drives the success/warning/error styling. */
10
17
  readonly variant: _angular_core.InputSignal<ProgressVariant>;
11
18
  /** Indeterminate (unknown-duration) animation instead of a fixed `value`. */
12
19
  readonly indeterminate: _angular_core.InputSignalWithTransform<boolean, unknown>;
13
- /** Accessible name for the progress bar (e.g. "Upload progress"). */
20
+ /** Accessible name for the progress bar (e.g. "Upload progress"). With a `target` set, name the
21
+ * comparison here — the mark is drawn, and `role="progressbar"` has no second value to announce,
22
+ * so "Resolved 62% against a 75% target" is what reaches a screen reader. */
14
23
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
24
+ /** A second point on the same scale as `value`, drawn as a hairline across the track — a goal or
25
+ * a baseline to read `value` against. Clamped like `value`, ignored while `indeterminate`, and
26
+ * unset draws nothing. */
27
+ readonly target: _angular_core.InputSignal<number | null>;
28
+ protected readonly scale: _angular_core.Signal<number>;
15
29
  protected readonly clampedValue: _angular_core.Signal<number>;
30
+ /** Width and offset are percentages of the track whatever the scale is. */
31
+ protected readonly valuePercent: _angular_core.Signal<number>;
32
+ protected readonly clampedTarget: _angular_core.Signal<number | null>;
33
+ protected readonly targetPercent: _angular_core.Signal<number | null>;
16
34
  protected readonly isIndet: _angular_core.Signal<boolean>;
17
35
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ProgressComponent, never>;
18
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ProgressComponent, "ds-progress", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
36
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ProgressComponent, "ds-progress", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "target": { "alias": "target"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
19
37
  }
20
38
 
21
39
  export { ProgressComponent };
@@ -57,6 +57,11 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
57
57
  * than the panel otherwise walks the cursor out of sight. Set `false` only if
58
58
  * you are driving the scroll position yourself. */
59
59
  readonly scrollActiveIntoView: _angular_core.InputSignalWithTransform<boolean, unknown>;
60
+ /** Extra classes for the portaled panel, beside `ds-dropdown-panel`,
61
+ * `ds-overlay-pane` and this component's own `ds-select-panel`. The panel is
62
+ * portaled out of the host, so a class on the pane is the only way a consumer
63
+ * stylesheet reaches ONE instance of it. */
64
+ readonly panelClass: _angular_core.InputSignal<string | readonly string[]>;
60
65
  /** Prevents opening the dropdown while still allowing focus. */
61
66
  readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
62
67
  /**
@@ -148,7 +153,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
148
153
  private lastEnabledIndex;
149
154
  private firstEnabledIndex;
150
155
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
151
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "scrollActiveIntoView": { "alias": "scrollActiveIntoView"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "opened": "opened"; "closed": "closed"; }, ["optionTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate"], never, true, [{ directive: typeof _ids_group_ltd_ids_design_system_components.DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
156
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "scrollActiveIntoView": { "alias": "scrollActiveIntoView"; "required": false; "isSignal": true; }; "panelClass": { "alias": "panelClass"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "opened": "opened"; "closed": "closed"; }, ["optionTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate"], never, true, [{ directive: typeof _ids_group_ltd_ids_design_system_components.DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
152
157
  }
153
158
 
154
159
  export { SelectComponent, isSelectOptionGroup };
@@ -122,6 +122,11 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
122
122
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
123
123
  /** Shows an "(optional)" marker beside the label — ignored when `required` is set. */
124
124
  readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
125
+ /** Extra classes for the portaled panel, beside `ds-dropdown-panel`,
126
+ * `ds-overlay-pane` and this component's own `ds-time-picker-panel`. The panel
127
+ * is portaled out of the host, so a class on the pane is the only way a consumer
128
+ * stylesheet reaches ONE instance of it. */
129
+ readonly panelClass: _angular_core.InputSignal<string | readonly string[]>;
125
130
  /** Disables the picker and blocks all interaction. */
126
131
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
127
132
  /** Confirmation text, shown when there is no error or warning — and it paints
@@ -181,7 +186,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
181
186
  private minutesOf;
182
187
  private laterOf;
183
188
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TimePickerComponent, never>;
184
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimePickerComponent, "ds-time-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "disabledTime": { "alias": "disabledTime"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
189
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimePickerComponent, "ds-time-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "disabledTime": { "alias": "disabledTime"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "panelClass": { "alias": "panelClass"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
185
190
  }
186
191
 
187
192
  export { TimePickerComponent };
@@ -56,6 +56,19 @@ declare function formatPercent(value: number, total: number): string;
56
56
  declare function largestRemainder(values: readonly number[]): number[];
57
57
  /** @internal */
58
58
  declare function formatTick(value: number, step: number): string;
59
+ /** One mark's share of the total its siblings add up to, as a bare percentage.
60
+ *
61
+ * Empty for a lone mark, which is the whole of its own total, and empty for a reading that is not
62
+ * part of a total anyone can see: negatives and non-finite values are excluded from the total
63
+ * rather than subtracted from it, so a negative mark has no share rather than a misleading one.
64
+ *
65
+ * @internal */
66
+ declare function shareOfTotal(values: readonly number[], index: number): string;
67
+ /** The same share, phrased for a tooltip line, where no column header stands above it to say what
68
+ * the percentage is OF.
69
+ *
70
+ * @internal */
71
+ declare function describeShare(values: readonly number[], index: number): string;
59
72
 
60
73
  /** Container width as a signal. It is 0 under SSR, while the container is
61
74
  * `display: none`, and before the first observation.
@@ -75,6 +88,13 @@ declare function tickStep(ticks: readonly number[]): number;
75
88
  /** @internal */
76
89
  declare function linearScale(domainMax: number, rangeSize: number): (value: number) => number;
77
90
  /** @internal */
91
+ interface PointScale {
92
+ readonly step: number;
93
+ readonly count: number;
94
+ position(index: number): number;
95
+ indexAt(offset: number): number;
96
+ }
97
+ /** @internal */
78
98
  interface BandScale {
79
99
  readonly bandWidth: number;
80
100
  /** Centre to centre, so it exceeds `bandWidth` by the padding. */
@@ -86,6 +106,15 @@ interface BandScale {
86
106
  * a caller branches on rather than clamps. */
87
107
  indexAt(offset: number): number;
88
108
  }
109
+ /** Positions for marks that sit AT a category rather than inside it — the readings of a line.
110
+ * The first is at the plot's start and the last at its end, so the run fills the axis rather than
111
+ * floating half a slot inside it. A single reading has no run to fill and takes the middle.
112
+ *
113
+ * `step` is the distance between neighbours, which is what a crosshair band is a slot of; at the
114
+ * two ends that slot is half outside the plot and the caller clamps it.
115
+ *
116
+ * @internal */
117
+ declare function pointScale(count: number, rangeSize: number): PointScale;
89
118
  /** @internal */
90
119
  declare function bandScale(count: number, rangeSize: number, paddingRatio: number): BandScale;
91
120
 
@@ -163,12 +192,19 @@ declare abstract class DsMessageBase {
163
192
  /** Advisory text, shown when there is no error. */
164
193
  readonly warning: i0.InputSignalWithTransform<string, string | null | undefined>;
165
194
  /** Reserve the message-row height even when empty, so the control doesn't shift
166
- * the layout below it when a hint/error appears. Falls back to
167
- * `DS_CONFIG.field.reserveMessage`, then off. */
195
+ * the layout below it when a hint/error appears. What an unset value falls back
196
+ * to is the subclass's call, in `reserveMessageResolved`: a field takes
197
+ * `DS_CONFIG.field.reserveMessage`, a button does not. */
168
198
  readonly reserveMessage: i0.InputSignalWithTransform<boolean | null, unknown>;
169
199
  /** Glyph on the message line, overriding what the state resolves to. Unset
170
200
  * follows `DS_CONFIG.field.stateIcons`; `false` removes the glyph here alone. */
171
201
  readonly messageIcon: i0.InputSignal<false | IconName | null>;
202
+ /** Whether an unset `reserveMessage` falls back to `DS_CONFIG.field.reserveMessage`.
203
+ * True for a field, whose row reserves so its neighbours do not shift; `ds-button`
204
+ * turns it off, because a button is not in that column and an app-wide field
205
+ * setting would otherwise give every button an empty message row. Read lazily, so
206
+ * a subclass initializer running after this one still decides it. */
207
+ protected readonly reserveFollowsFieldDefault: boolean;
172
208
  readonly reserveMessageResolved: i0.Signal<boolean>;
173
209
  static ɵfac: i0.ɵɵFactoryDeclaration<DsMessageBase, never>;
174
210
  static ɵdir: i0.ɵɵDirectiveDeclaration<DsMessageBase, never, never, { "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "messageIcon": { "alias": "messageIcon"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -547,13 +583,19 @@ type DsOverlayPlacement = 'top' | 'bottom' | 'left' | 'right';
547
583
  * @internal
548
584
  */
549
585
  type DsOverlayCloseCause = 'select' | 'dismiss';
586
+ /**
587
+ * One panel-class input as an array. Spreading the raw input would scatter a
588
+ * string into its characters, which is a silent per-letter class list.
589
+ * @internal
590
+ */
591
+ declare function panelClassesOf(panelClass: string | readonly string[]): readonly string[];
550
592
  /**
551
593
  * The geometry every DS dropdown shares. Width is deliberately NOT set here —
552
594
  * each caller has its own policy (the exact trigger width, or the trigger as a
553
595
  * floor).
554
596
  * @internal
555
597
  */
556
- declare function dropdownOverlay(overlay: Overlay, trigger: HTMLElement, panelClass?: string | string[]): {
598
+ declare function dropdownOverlay(overlay: Overlay, trigger: HTMLElement, extraPanelClass?: string | readonly string[]): {
557
599
  positionStrategy: FlexibleConnectedPositionStrategy;
558
600
  config: OverlayConfig;
559
601
  };
@@ -785,5 +827,5 @@ interface DsTypeAhead {
785
827
  /** @internal */
786
828
  declare function createTypeAhead(): DsTypeAhead;
787
829
 
788
- export { CHART_RAMP_COLORS, CHART_SERIES_COLORS, DS_FIELD_WARNING_KIND, DsBooleanControlValueAccessor, DsChipTemplateDirective, DsControlValueAccessor, DsCreateTemplateDirective, DsEmptyTemplateDirective, DsFieldBase, DsGroupLabelTemplateDirective, DsMessageBase, DsOptionTemplateDirective, DsPanelFooterTemplateDirective, DsPanelHeaderTemplateDirective, DsPickerTriggerDirective, DsStaticPreview, FieldClickFocusDirective, ProjectionDroppedDirective, announceOptionCount, bandScale, chartColors, chipFit, clearOnDetach, closeOnOutsidePointer, closeOnScroll, createTypeAhead, describeSeries, disposeWithLeave, dropdownOverlay, dsAriaCurrent, dsDestination, elementWidth, focusIsInside, focusMark, formatPercent, formatTick, formatValue, forwardOverlayTokens, largestRemainder, linearScale, nextControlId, nextRovingIndex, niceMax, overlayPlacementOf, prepareOverlayEnter, resolveBrandValue, resolveFieldMessage, scrollActiveOptionIntoView, staggerDelay, tickStep, tickValues, trimmedText, valueControlBridge };
789
- export type { BandScale, DsAriaCurrent, DsDestination, DsFieldError, DsFieldErrorsInput, DsFieldMessage, DsLinkModifiers, DsOverlayCloseCause, DsRouterLink, SummaryPoint };
830
+ export { CHART_RAMP_COLORS, CHART_SERIES_COLORS, DS_FIELD_WARNING_KIND, DsBooleanControlValueAccessor, DsChipTemplateDirective, DsControlValueAccessor, DsCreateTemplateDirective, DsEmptyTemplateDirective, DsFieldBase, DsGroupLabelTemplateDirective, DsMessageBase, DsOptionTemplateDirective, DsPanelFooterTemplateDirective, DsPanelHeaderTemplateDirective, DsPickerTriggerDirective, DsStaticPreview, FieldClickFocusDirective, ProjectionDroppedDirective, announceOptionCount, bandScale, chartColors, chipFit, clearOnDetach, closeOnOutsidePointer, closeOnScroll, createTypeAhead, describeSeries, describeShare, disposeWithLeave, dropdownOverlay, dsAriaCurrent, dsDestination, elementWidth, focusIsInside, focusMark, formatPercent, formatTick, formatValue, forwardOverlayTokens, largestRemainder, linearScale, nextControlId, nextRovingIndex, niceMax, overlayPlacementOf, panelClassesOf, pointScale, prepareOverlayEnter, resolveBrandValue, resolveFieldMessage, scrollActiveOptionIntoView, shareOfTotal, staggerDelay, tickStep, tickValues, trimmedText, valueControlBridge };
831
+ export type { BandScale, DsAriaCurrent, DsDestination, DsFieldError, DsFieldErrorsInput, DsFieldMessage, DsLinkModifiers, DsOverlayCloseCause, DsRouterLink, PointScale, SummaryPoint };
@@ -19,6 +19,16 @@ declare function backdropDismiss(): {
19
19
  type CardElevation = 'flat' | 'raised' | 'hover' | 'interactive';
20
20
  type CardPadding = 'none' | 'sm' | 'md' | 'lg';
21
21
 
22
+ /** Whether the label-and-value table under a chart's plot is offered, and how. It is the non-visual
23
+ * route to the numbers, so `'none'` belongs only where the same data is already in a table on the
24
+ * page. */
25
+ type ChartDataTable = 'toggle' | 'visible' | 'none';
26
+ /** Whether a chart draws its own bordered, padded box. `'auto'` draws it; `'none'` leaves the
27
+ * chart bare, for a chart placed inside a card the page has already drawn. */
28
+ type ChartFrame = 'auto' | 'none';
29
+ /** Formats every value a chart prints — the annex table and the generated description included. */
30
+ type ChartValueFormat = (value: number) => string;
31
+
22
32
  declare const ICONS: {
23
33
  readonly search: "<circle cx=\"11\" cy=\"11\" r=\"7\" /><path d=\"m20 20-3.5-3.5\" />";
24
34
  readonly plus: "<path d=\"M12 5v14M5 12h14\" />";
@@ -237,6 +247,35 @@ interface DsConfig {
237
247
  /** Default for `ds-badge`'s `withDot` — the leading status dot. Default `false`. */
238
248
  withDot?: boolean;
239
249
  };
250
+ chart?: {
251
+ /** Default `dataTable` for all five charts. Default `'none'`. It is an accessibility policy
252
+ * rather than a per-chart taste — whether the numbers behind a plot have a non-visual route is
253
+ * decided once for an app, not thirty times, so an app that wants the annex everywhere sets
254
+ * `'toggle'` here once rather than on every chart. Off by default: a chart usually sits in a
255
+ * page that already carries its numbers, and an unasked-for disclosure under every plot is
256
+ * chrome the page did not ask for. */
257
+ dataTable?: ChartDataTable;
258
+ /** Whether every chart draws its own bordered, padded box. Default `'auto'`, which draws it.
259
+ * Whether charts live inside cards is decided once for an app — a page that puts every chart
260
+ * in a card sets `'none'` here rather than reaching into five components' chrome from a
261
+ * global stylesheet. */
262
+ frame?: ChartFrame;
263
+ /** How long every chart's tooltip stays after the pointer leaves the mark, in milliseconds.
264
+ * Default 0. Raise it only where the panels carry something a reader has to reach — WCAG
265
+ * 1.4.13's hoverable clause — which is a property of what an app puts in its tooltips rather
266
+ * than of one plot. About 140 is enough to cross the gap at an ordinary pointer speed. */
267
+ tooltipLingerMs?: number;
268
+ /** Shown in place of the plot when a chart's data is empty. Default `'No data'`. */
269
+ emptyText?: string;
270
+ /** Shown in place of the plot when a chart has `error` set. Default
271
+ * `'Could not load the data'`. */
272
+ errorText?: string;
273
+ /** How every chart formats its values, the annex table and the generated description included.
274
+ * Default is the browser's locale grouping with a K/M/B suffix past four digits. The same
275
+ * reason `datePicker.locale` lives here: a number reads one way in an app, and a formatter
276
+ * passed per chart drifts as soon as there are two screens. */
277
+ valueFormat?: ChartValueFormat;
278
+ };
240
279
  datePicker?: {
241
280
  /** BCP-47 locale for `ds-date-picker` names + value format. Default `'en-US'`. */
242
281
  locale?: string;
@@ -449,4 +488,4 @@ type DsTriggerDisplay = 'full' | 'count' | 'labels';
449
488
  type DsControlWidth = 'fill' | 'content';
450
489
 
451
490
  export { DS_CONFIG, ICONS, backdropDismiss, boundOr, devWarn, firstEnabledIndex, flattenDsOptions, inheritDsConfig, isDsOptionGroup, isTextClipped, isTextEntryTarget, lastEnabledIndex, nextEnabledIndex, optionalBound, provideDsConfig, resolveWithConfig };
452
- export type { CardElevation, CardPadding, DsConfig, DsControlWidth, DsOption, DsOptionGroup, DsOptionItem, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, DsTriggerDisplay, IconName };
491
+ export type { CardElevation, CardPadding, ChartDataTable, ChartFrame, ChartValueFormat, DsConfig, DsControlWidth, DsOption, DsOptionGroup, DsOptionItem, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, DsTriggerDisplay, IconName };
@@ -8,14 +8,14 @@ export { AvatarComponent, AvatarSize, AvatarStatus, AvatarTintOptions, avatarTin
8
8
  export { AvatarGroupComponent } from '@ids-group-ltd/ids-design-system/components/avatar-group';
9
9
  export { BadgeComponent } from '@ids-group-ltd/ids-design-system/components/badge';
10
10
  export { BannerComponent, BannerVariant } from '@ids-group-ltd/ids-design-system/components/banner';
11
- export { BarChartComponent, BarChartRow } from '@ids-group-ltd/ids-design-system/components/bar-chart';
11
+ export { BarChartComponent, BarChartRow, BarChartSegment } from '@ids-group-ltd/ids-design-system/components/bar-chart';
12
12
  export { BottomSheetComponent } from '@ids-group-ltd/ids-design-system/components/bottom-sheet';
13
13
  export { BreadcrumbItem, BreadcrumbsComponent, BreadcrumbsService } from '@ids-group-ltd/ids-design-system/components/breadcrumbs';
14
14
  export { ButtonColor, ButtonComponent, ButtonType, ButtonVariant } from '@ids-group-ltd/ids-design-system/components/button';
15
15
  export { ButtonGroupComponent } from '@ids-group-ltd/ids-design-system/components/button-group';
16
16
  export { CardComponent, CardElevation, CardPadding } from '@ids-group-ltd/ids-design-system/components/card';
17
17
  export { ChartLegendItem } from '@ids-group-ltd/ids-design-system/components/chart-legend';
18
- export { ChartActiveMark, ChartItemTooltipTrigger, ChartTooltipContext, ChartTooltipEntry, ChartTooltipOrigin, ChartTooltipTrigger } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
18
+ export { ChartItemTooltipTrigger, ChartTooltipContext, ChartTooltipEntry, ChartTooltipOrigin, ChartTooltipTrigger } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
19
19
  export { CheckboxComponent } from '@ids-group-ltd/ids-design-system/components/checkbox';
20
20
  export { ColorPickerComponent } from '@ids-group-ltd/ids-design-system/components/color-picker';
21
21
  export { ColumnChartComponent, ColumnChartPoint } from '@ids-group-ltd/ids-design-system/components/column-chart';
@@ -28,14 +28,15 @@ export { DropzoneComponent, DropzoneFile, DropzoneFileState } from '@ids-group-l
28
28
  export { EmptyStateComponent, EmptyStateVariant } from '@ids-group-ltd/ids-design-system/components/empty-state';
29
29
  export { DS_FIELD_GROUP, DsFieldGroupContext, FieldGroupComponent } from '@ids-group-ltd/ids-design-system/components/field-group';
30
30
  export { FilterBarComponent, FilterItemDirective } from '@ids-group-ltd/ids-design-system/components/filter-bar';
31
- export { FunnelChartComponent, FunnelChartShape, FunnelChartStage } from '@ids-group-ltd/ids-design-system/components/funnel-chart';
31
+ export { FunnelChartComponent, FunnelChartDrop, FunnelChartShape, FunnelChartStage } from '@ids-group-ltd/ids-design-system/components/funnel-chart';
32
32
  export { IconButtonComponent, IconButtonType, IconButtonVariant } from '@ids-group-ltd/ids-design-system/components/icon-button';
33
33
  export { InputComponent, InputType } from '@ids-group-ltd/ids-design-system/components/input';
34
34
  export { ContainerComponent, ContainerSize, InlineComponent, LayoutAlign, LayoutGap, LayoutJustify, StackComponent } from '@ids-group-ltd/ids-design-system/components/layout';
35
- export { LineChartAxisMode, LineChartComponent, LineChartGaps, LineChartPoint, LineChartSeries } from '@ids-group-ltd/ids-design-system/components/line-chart';
35
+ export { LineChartAnnotation, LineChartAxisMode, LineChartComponent, LineChartGaps, LineChartPoint, LineChartSeries } from '@ids-group-ltd/ids-design-system/components/line-chart';
36
36
  export { ListComponent, ListItemComponent } from '@ids-group-ltd/ids-design-system/components/list';
37
37
  export { LoadingOverlayComponent } from '@ids-group-ltd/ids-design-system/components/loading-overlay';
38
38
  export { MenuComponent, MenuDividerComponent, MenuItemComponent } from '@ids-group-ltd/ids-design-system/components/menu';
39
+ export { MeterComponent } from '@ids-group-ltd/ids-design-system/components/meter';
39
40
  export { ModalCardComponent, ModalComponent, ModalConfirmOptions, ModalConfirmTone, ModalService, ModalSize } from '@ids-group-ltd/ids-design-system/components/modal';
40
41
  export { MultiSelectComponent, MultiSelectItem, MultiSelectOption, MultiSelectOptionGroup, MultiSelectWidth } from '@ids-group-ltd/ids-design-system/components/multi-select';
41
42
  export { NumberStepperComponent } from '@ids-group-ltd/ids-design-system/components/number-stepper';
@@ -76,7 +77,7 @@ export { TooltipDirective, TooltipPanelComponent, TooltipPlacement } from '@ids-
76
77
  export { TopBarComponent } from '@ids-group-ltd/ids-design-system/components/topbar';
77
78
  export { TreeComponent, TreeNode } from '@ids-group-ltd/ids-design-system/components/tree';
78
79
  export { W3wComponent } from '@ids-group-ltd/ids-design-system/components/w3w';
79
- export { DS_CONFIG, DsConfig, DsControlWidth, DsOption, DsOptionGroup, DsOptionItem, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsTriggerDisplay, ICONS, IconName, flattenDsOptions, inheritDsConfig, isDsOptionGroup, isTextClipped, provideDsConfig } from '@ids-group-ltd/ids-design-system/core';
80
+ export { ChartDataTable, ChartFrame, ChartValueFormat, DS_CONFIG, DsConfig, DsControlWidth, DsOption, DsOptionGroup, DsOptionItem, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsTriggerDisplay, ICONS, IconName, flattenDsOptions, inheritDsConfig, isDsOptionGroup, isTextClipped, provideDsConfig } from '@ids-group-ltd/ids-design-system/core';
80
81
  export { DS_ICON_REGISTRY, DsIconRegistry, IconComponent, provideDsIcons } from '@ids-group-ltd/ids-design-system/icons';
81
82
  export { BodyScrollLockService, DsOverlayCloseRef } from '@ids-group-ltd/ids-design-system/overlay';
82
83
  export { DsThemeOptions, provideDsTheme } from '@ids-group-ltd/ids-design-system/theme';