@ids-group-ltd/ids-design-system 0.12.3 → 0.13.1

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 (147) hide show
  1. package/CHANGELOG.md +895 -6
  2. package/components.md +94 -2
  3. package/docs/agent/INDEX.md +12 -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-config.md +12 -0
  9. package/docs/agent/charts/ds-donut-chart.md +17 -0
  10. package/docs/agent/charts/ds-funnel-chart.md +16 -0
  11. package/docs/agent/charts/ds-line-chart.md +15 -0
  12. package/docs/agent/forms/ds-button.md +4 -2
  13. package/docs/agent/forms/ds-number-stepper.md +1 -0
  14. package/docs/agent/navigation/ds-sidenav-item.md +1 -0
  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 +25 -18
  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-badge.mjs +2 -2
  22. package/fesm2022/ids-group-ltd-ids-design-system-components-badge.mjs.map +1 -1
  23. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs +2 -2
  24. package/fesm2022/ids-group-ltd-ids-design-system-components-banner.mjs.map +1 -1
  25. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs +177 -0
  26. package/fesm2022/ids-group-ltd-ids-design-system-components-bar-chart.mjs.map +1 -0
  27. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs +2 -2
  28. package/fesm2022/ids-group-ltd-ids-design-system-components-bottom-sheet.mjs.map +1 -1
  29. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs +2 -2
  30. package/fesm2022/ids-group-ltd-ids-design-system-components-breadcrumbs.mjs.map +1 -1
  31. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs +58 -8
  32. package/fesm2022/ids-group-ltd-ids-design-system-components-button.mjs.map +1 -1
  33. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs +43 -0
  34. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-legend.mjs.map +1 -0
  35. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs +212 -0
  36. package/fesm2022/ids-group-ltd-ids-design-system-components-chart-tooltip.mjs.map +1 -0
  37. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs +1 -0
  38. package/fesm2022/ids-group-ltd-ids-design-system-components-checkbox.mjs.map +1 -1
  39. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs +10 -4
  40. package/fesm2022/ids-group-ltd-ids-design-system-components-color-picker.mjs.map +1 -1
  41. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs +196 -0
  42. package/fesm2022/ids-group-ltd-ids-design-system-components-column-chart.mjs.map +1 -0
  43. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs +18 -10
  44. package/fesm2022/ids-group-ltd-ids-design-system-components-date-picker.mjs.map +1 -1
  45. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs +311 -0
  46. package/fesm2022/ids-group-ltd-ids-design-system-components-donut-chart.mjs.map +1 -0
  47. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs +2 -1
  48. package/fesm2022/ids-group-ltd-ids-design-system-components-drawer.mjs.map +1 -1
  49. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs +2 -2
  50. package/fesm2022/ids-group-ltd-ids-design-system-components-dropzone.mjs.map +1 -1
  51. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs +2 -2
  52. package/fesm2022/ids-group-ltd-ids-design-system-components-empty-state.mjs.map +1 -1
  53. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs +69 -17
  54. package/fesm2022/ids-group-ltd-ids-design-system-components-field-group.mjs.map +1 -1
  55. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs +1 -1
  56. package/fesm2022/ids-group-ltd-ids-design-system-components-filter-bar.mjs.map +1 -1
  57. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs +388 -0
  58. package/fesm2022/ids-group-ltd-ids-design-system-components-funnel-chart.mjs.map +1 -0
  59. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs +10 -14
  60. package/fesm2022/ids-group-ltd-ids-design-system-components-input.mjs.map +1 -1
  61. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs +672 -0
  62. package/fesm2022/ids-group-ltd-ids-design-system-components-line-chart.mjs.map +1 -0
  63. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs +2 -1
  64. package/fesm2022/ids-group-ltd-ids-design-system-components-list.mjs.map +1 -1
  65. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs +5 -5
  66. package/fesm2022/ids-group-ltd-ids-design-system-components-modal.mjs.map +1 -1
  67. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs +10 -4
  68. package/fesm2022/ids-group-ltd-ids-design-system-components-multi-select.mjs.map +1 -1
  69. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs +2 -2
  70. package/fesm2022/ids-group-ltd-ids-design-system-components-number-stepper.mjs.map +1 -1
  71. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs +1 -0
  72. package/fesm2022/ids-group-ltd-ids-design-system-components-otp-input.mjs.map +1 -1
  73. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs +2 -2
  74. package/fesm2022/ids-group-ltd-ids-design-system-components-page-header.mjs.map +1 -1
  75. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs +2 -2
  76. package/fesm2022/ids-group-ltd-ids-design-system-components-pagination.mjs.map +1 -1
  77. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs +2 -10
  78. package/fesm2022/ids-group-ltd-ids-design-system-components-radio-group.mjs.map +1 -1
  79. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs +1 -0
  80. package/fesm2022/ids-group-ltd-ids-design-system-components-segmented.mjs.map +1 -1
  81. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs +18 -10
  82. package/fesm2022/ids-group-ltd-ids-design-system-components-select.mjs.map +1 -1
  83. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs +18 -7
  84. package/fesm2022/ids-group-ltd-ids-design-system-components-sidenav.mjs.map +1 -1
  85. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs +1 -0
  86. package/fesm2022/ids-group-ltd-ids-design-system-components-slider.mjs.map +1 -1
  87. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs +4 -3
  88. package/fesm2022/ids-group-ltd-ids-design-system-components-stat.mjs.map +1 -1
  89. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs +1 -0
  90. package/fesm2022/ids-group-ltd-ids-design-system-components-switch.mjs.map +1 -1
  91. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs +1 -1
  92. package/fesm2022/ids-group-ltd-ids-design-system-components-table-export.mjs.map +1 -1
  93. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs +30 -71
  94. package/fesm2022/ids-group-ltd-ids-design-system-components-table.mjs.map +1 -1
  95. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs +2 -2
  96. package/fesm2022/ids-group-ltd-ids-design-system-components-tag.mjs.map +1 -1
  97. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs +1 -0
  98. package/fesm2022/ids-group-ltd-ids-design-system-components-textarea.mjs.map +1 -1
  99. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs +10 -4
  100. package/fesm2022/ids-group-ltd-ids-design-system-components-time-picker.mjs.map +1 -1
  101. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs +2 -2
  102. package/fesm2022/ids-group-ltd-ids-design-system-components-toast.mjs.map +1 -1
  103. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs +31 -9
  104. package/fesm2022/ids-group-ltd-ids-design-system-components-tooltip.mjs.map +1 -1
  105. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs +448 -12
  106. package/fesm2022/ids-group-ltd-ids-design-system-components.mjs.map +1 -1
  107. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs +17 -1
  108. package/fesm2022/ids-group-ltd-ids-design-system-core.mjs.map +1 -1
  109. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs +3 -0
  110. package/fesm2022/ids-group-ltd-ids-design-system-icons.mjs.map +1 -1
  111. package/fesm2022/ids-group-ltd-ids-design-system.mjs +10 -1
  112. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  113. package/migrations/0.13.0.json +530 -0
  114. package/migrations/0.13.1.json +236 -0
  115. package/package.json +57 -1
  116. package/styles/_chart-data-table.scss +95 -0
  117. package/styles/_chart-frame.scss +68 -0
  118. package/styles/_chart-interactive.scss +51 -0
  119. package/styles/_chart-motion.scss +88 -0
  120. package/styles/_dropdown-overlay.scss +9 -3
  121. package/styles/_focus.scss +11 -2
  122. package/styles/_overlay-motion.scss +10 -1
  123. package/styles/_tokens-charts.scss +154 -39
  124. package/styles/_tokens.scss +17 -4
  125. package/themes/dark/_theme.scss +37 -29
  126. package/types/ids-group-ltd-ids-design-system-components-autocomplete.d.ts +17 -10
  127. package/types/ids-group-ltd-ids-design-system-components-bar-chart.d.ts +119 -0
  128. package/types/ids-group-ltd-ids-design-system-components-button.d.ts +37 -4
  129. package/types/ids-group-ltd-ids-design-system-components-chart-legend.d.ts +34 -0
  130. package/types/ids-group-ltd-ids-design-system-components-chart-tooltip.d.ts +84 -0
  131. package/types/ids-group-ltd-ids-design-system-components-color-picker.d.ts +6 -1
  132. package/types/ids-group-ltd-ids-design-system-components-column-chart.d.ts +125 -0
  133. package/types/ids-group-ltd-ids-design-system-components-date-picker.d.ts +10 -2
  134. package/types/ids-group-ltd-ids-design-system-components-donut-chart.d.ts +127 -0
  135. package/types/ids-group-ltd-ids-design-system-components-field-group.d.ts +52 -11
  136. package/types/ids-group-ltd-ids-design-system-components-funnel-chart.d.ts +128 -0
  137. package/types/ids-group-ltd-ids-design-system-components-input.d.ts +5 -7
  138. package/types/ids-group-ltd-ids-design-system-components-line-chart.d.ts +268 -0
  139. package/types/ids-group-ltd-ids-design-system-components-multi-select.d.ts +6 -1
  140. package/types/ids-group-ltd-ids-design-system-components-select.d.ts +11 -3
  141. package/types/ids-group-ltd-ids-design-system-components-sidenav.d.ts +16 -4
  142. package/types/ids-group-ltd-ids-design-system-components-table.d.ts +13 -28
  143. package/types/ids-group-ltd-ids-design-system-components-time-picker.d.ts +6 -1
  144. package/types/ids-group-ltd-ids-design-system-components-tooltip.d.ts +11 -1
  145. package/types/ids-group-ltd-ids-design-system-components.d.ts +171 -5
  146. package/types/ids-group-ltd-ids-design-system-core.d.ts +36 -2
  147. package/types/ids-group-ltd-ids-design-system.d.ts +9 -2
@@ -0,0 +1,127 @@
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
+ import { ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
6
+
7
+ interface DonutChartSlice {
8
+ id: string;
9
+ label: string;
10
+ value: number;
11
+ /** 1-based palette slot. Pinning a slice to a slot keeps every other slice's
12
+ * colour where it is when one is filtered out of `data`; left off, the colour
13
+ * follows the index and the whole ring repaints. */
14
+ slot?: number;
15
+ }
16
+
17
+ declare class DonutChartComponent {
18
+ /** One slice per entry. A non-positive or non-finite value counts as zero — a ring is a
19
+ * part-to-whole picture and has no way to draw a negative share. */
20
+ readonly data: _angular_core.InputSignal<readonly DonutChartSlice[]>;
21
+ /** Printed inside the ring. Null prints the sum through `valueFormat`. */
22
+ readonly centerValue: _angular_core.InputSignal<string | null>;
23
+ /** Caption under the centre value. */
24
+ readonly centerLabel: _angular_core.InputSignal<string | null>;
25
+ /** Logical placement, so a right-to-left page needs no second value. */
26
+ readonly legend: _angular_core.InputSignal<"end" | "bottom" | "none">;
27
+ /** Longest legend to draw. Past it the smallest slices are summed into one, so a long tail does
28
+ * not become a legend nobody reads. Off by default: grouping changes what the chart says, and
29
+ * that is the consumer's call. Values below 2 are ignored — one slice is not a donut. */
30
+ readonly maxSlices: _angular_core.InputSignalWithTransform<number | null, number | null>;
31
+ /** Names the grouped slice. */
32
+ readonly otherLabel: _angular_core.InputSignal<string>;
33
+ /** Ring width as a fraction of the radius. */
34
+ readonly thickness: _angular_core.InputSignalWithTransform<number, unknown>;
35
+ /** Printed above the plot as the chart's visible title, and reused as the annex table's
36
+ * caption. */
37
+ readonly caption: _angular_core.InputSignal<string | null>;
38
+ /** Accessible name. Generated from the data when omitted. */
39
+ readonly summary: _angular_core.InputSignal<string | null>;
40
+ /** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
41
+ * `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
42
+ * `'none'` belongs only where the same data is already in a table on the page.
43
+ * Unset falls back to `DS_CONFIG.chart.dataTable`, then `'toggle'`. */
44
+ readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
45
+ /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
46
+ * when the data lands. */
47
+ readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
48
+ /** Shown in place of the plot when `data` is empty. Unset falls back to
49
+ * `DS_CONFIG.chart.emptyText`, then `'No data'`. */
50
+ readonly emptyText: _angular_core.InputSignal<string | null>;
51
+ /** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
52
+ * because "the request failed" and "there is nothing to show" read the same to a reader and
53
+ * mean opposite things. */
54
+ readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
55
+ /** The message the error state prints. Unset falls back to `DS_CONFIG.chart.errorText`, then
56
+ * `'Could not load the data'`. */
57
+ readonly errorText: _angular_core.InputSignal<string | null>;
58
+ /** Formats every value the chart prints, the annex table and the generated description
59
+ * included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
60
+ * grouping with a K/M/B suffix past four digits. */
61
+ readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
62
+ readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
63
+ readonly emptyTextResolved: _angular_core.Signal<string>;
64
+ readonly errorTextResolved: _angular_core.Signal<string>;
65
+ readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
66
+ /** Turns on the click affordance — the pointer cursor and any hover tint.
67
+ * The click output fires whether or not this is set, so a consumer that
68
+ * binds the output and forgets the flag still receives every click. */
69
+ readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
70
+ /** The slice that was clicked, or activated with Enter or Space. Fires whether or not
71
+ * `interactive` is set. */
72
+ readonly sliceClicked: _angular_core.OutputEmitterRef<DonutChartSlice>;
73
+ /** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
74
+ * one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
75
+ * marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
76
+ * opacity to 2.1 at `--ds-chart-dim-opacity`'s default 0.3 — so it buys loudness for one mark
77
+ * and pays for it with the rest of the chart. */
78
+ readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
79
+ /** Accepted for parity with the other four charts and deliberately without effect here: a ring
80
+ * arrives as ONE object, because arcs share their edges and fading them one at a time lets the
81
+ * background through every seam. There is nothing to stagger. */
82
+ readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
83
+ /** Whether a hovered or focused slice opens a tooltip. `'axis'` is not offered — a ring
84
+ * has no axis to group readings under. */
85
+ readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
86
+ protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
87
+ $implicit: ChartTooltipContext;
88
+ }> | undefined>;
89
+ protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
90
+ /** One tab stop per chart, not one per slice: WCAG 2.1.1's Understanding is explicit that not
91
+ * every mouse-operable control has to be separately focusable. */
92
+ protected readonly rovingIndex: _angular_core.WritableSignal<number>;
93
+ protected readonly tabStopIndex: _angular_core.Signal<number>;
94
+ protected onMarkFocus(index: number, event: FocusEvent): void;
95
+ protected onMarkNavigation(event: KeyboardEvent, index: number, scope: string): void;
96
+ protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
97
+ protected readonly viewBox = "0 0 100 100";
98
+ protected readonly total: _angular_core.Signal<number>;
99
+ protected readonly visibleSlices: _angular_core.Signal<DonutChartSlice[]>;
100
+ protected readonly slices: _angular_core.Signal<{
101
+ slice: DonutChartSlice;
102
+ path: string;
103
+ color: string;
104
+ formattedValue: string;
105
+ formattedPercent: string;
106
+ }[]>;
107
+ protected readonly resolvedCenterValue: _angular_core.Signal<string>;
108
+ protected readonly accessibleName: _angular_core.Signal<string>;
109
+ protected readonly hole: _angular_core.Signal<number>;
110
+ protected entryLabel(entry: {
111
+ slice: DonutChartSlice;
112
+ formattedValue: string;
113
+ formattedPercent: string;
114
+ }): string;
115
+ protected onSliceKey(slice: DonutChartSlice, event: Event): void;
116
+ protected readonly ringCarriesTheRoute: _angular_core.Signal<boolean>;
117
+ protected readonly isEmpty: _angular_core.Signal<boolean>;
118
+ /** Placeholder legend rows while loading. Follows the real slice count so the
119
+ * chart does not resize when the data lands; falls back to three when `data`
120
+ * is still empty. */
121
+ protected readonly skeletonRows: _angular_core.Signal<unknown[]>;
122
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<DonutChartComponent, never>;
123
+ 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; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "sliceClicked": "sliceClicked"; }, ["tooltipTemplate"], never, true, never>;
124
+ }
125
+
126
+ export { DonutChartComponent };
127
+ export type { DonutChartSlice };
@@ -1,5 +1,7 @@
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';
1
3
  import * as _angular_core from '@angular/core';
2
- import { InjectionToken } from '@angular/core';
4
+ import { InjectionToken, Signal } from '@angular/core';
3
5
  import { DsSize } from '@ids-group-ltd/ids-design-system/core';
4
6
 
5
7
  /** What a grouped control can read off the group that encloses it. */
@@ -8,6 +10,14 @@ interface DsFieldGroupContext {
8
10
  * Resolved, not the raw input: `size` is unset by default and falls back to
9
11
  * `DS_CONFIG.control.size`, which a segment must not have to resolve again. */
10
12
  readonly sizeResolved: () => DsSize;
13
+ /** Whether the GROUP is in error — RESOLVED, so an `error` string counts and not only the
14
+ * `invalid` flag. A segment ORs it into its own state, so focusing any of them announces the
15
+ * error: the pair is invalid, and a reader who tabs to the second segment must hear it too.
16
+ * Named for the resolved value so it cannot be confused with the group's raw `invalid` input. */
17
+ readonly invalidResolved: () => boolean;
18
+ /** A segment adds this to its `aria-describedby`, which is what connects the
19
+ * group's one sentence to every control it describes. */
20
+ readonly messageId: () => string | null;
11
21
  }
12
22
  /**
13
23
  * Provided by `ds-field-group`, injected `{ optional: true }` by every control
@@ -30,6 +40,27 @@ declare const DS_FIELD_GROUP: InjectionToken<DsFieldGroupContext>;
30
40
  * @internal
31
41
  */
32
42
  declare function inFieldGroup(): boolean;
43
+ /**
44
+ * The enclosing group, or `null`. Use it where the boolean is not enough — the
45
+ * group's error state and the id of its message.
46
+ * @internal
47
+ */
48
+ declare function fieldGroupContext(): DsFieldGroupContext | null;
49
+ /**
50
+ * A segment's own error state, ORed with the enclosing group's. The pair is what is invalid, so
51
+ * every segment announces it: a reader who tabs straight to the second one has to hear it too,
52
+ * and the group's border is not something a screen reader can see.
53
+ * @internal
54
+ */
55
+ declare function groupInvalid(own: Signal<boolean>): Signal<boolean>;
56
+ /**
57
+ * The id of the enclosing group's message, for a segment's `aria-describedby` — one sentence
58
+ * describing every control it covers.
59
+ * @internal
60
+ */
61
+ declare function groupMessageId(): Signal<string | null>;
62
+ /** @internal */
63
+ declare function describedByIds(...ids: readonly (string | null | undefined)[]): string | null;
33
64
 
34
65
  /**
35
66
  * One bordered control out of several: `select + input`, `search + button`,
@@ -40,34 +71,44 @@ declare function inFieldGroup(): boolean;
40
71
  * one that should take the slack with `grow`:
41
72
  *
42
73
  * ```html
43
- * <ds-field-group>
44
- * <ds-select [options]="scopes" />
45
- * <ds-input grow placeholder="Search…" />
74
+ * <ds-field-group error="Введите сумму больше нуля">
75
+ * <ds-select [options]="currencies" />
76
+ * <ds-input grow [(value)]="amount" />
46
77
  * </ds-field-group>
47
78
  * ```
48
79
  *
49
80
  * A control knows it is a segment by injecting `DS_FIELD_GROUP` — see the token
50
- * for why that is DI and not an input. Grouped controls must not carry a `label`
51
- * or a `hint`: their own message row would break the glued line, so it is
52
- * suppressed and a group-level one is not built yet.
81
+ * for why that is DI and not an input. A segment's own label and message stay
82
+ * suppressed: they would break the glued line, which is why the group carries
83
+ * the pair every field has — `error` for state WITH text, `invalid` for state
84
+ * whose text lives elsewhere.
53
85
  */
54
- declare class FieldGroupComponent implements DsFieldGroupContext {
86
+ declare class FieldGroupComponent extends DsMessageBase implements DsFieldGroupContext {
55
87
  /** Segment height — the field family's scale, so a group lines up with a
56
88
  * plain field beside it.
57
89
  * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
58
90
  readonly size: _angular_core.InputSignal<DsSize | null>;
59
91
  readonly sizeResolved: _angular_core.Signal<DsSize>;
60
- /** Draws the error border on the whole group. A single segment cannot be
61
- * invalid on its own: the border belongs to the group. */
92
+ /** Paints the error state WITHOUT a message of its own — for when the text
93
+ * lives in a form-level summary. Use `error` to show text; binding either one
94
+ * is enough, exactly as on a field.
95
+ *
96
+ * Segments read `invalidResolved`, not this, so an `error` string announces
97
+ * itself without the flag beside it. */
62
98
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
63
99
  /** Dims the group. Disable the CONTROLS too — this is the chrome, not their
64
100
  * interactivity. */
65
101
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
66
102
  /** Fills the container instead of hugging its segments. */
67
103
  readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
104
+ private readonly uid;
105
+ private readonly fieldMessage;
106
+ protected readonly message: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.DsFieldMessage>;
107
+ readonly invalidResolved: _angular_core.Signal<boolean>;
108
+ readonly messageId: _angular_core.Signal<string | null>;
68
109
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<FieldGroupComponent, never>;
69
110
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<FieldGroupComponent, "ds-field-group", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
70
111
  }
71
112
 
72
- export { DS_FIELD_GROUP, FieldGroupComponent, inFieldGroup };
113
+ export { DS_FIELD_GROUP, FieldGroupComponent, describedByIds, fieldGroupContext, groupInvalid, groupMessageId, inFieldGroup };
73
114
  export type { DsFieldGroupContext };
@@ -0,0 +1,128 @@
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
+ import { ChartDataTable, ChartValueFormat } from '@ids-group-ltd/ids-design-system/core';
6
+
7
+ interface FunnelChartStage {
8
+ id: string;
9
+ label: string;
10
+ value: number;
11
+ }
12
+ /** How a stage's geometry encodes its value. `'area'` is the default; `'taper'` encodes nothing —
13
+ * the silhouette is fixed whatever the data. See `funnelGeometry`. */
14
+ type FunnelChartShape = 'taper' | 'width' | 'area';
15
+
16
+ declare class FunnelChartComponent {
17
+ /** Drawn in the order given. The order of a funnel's stages is its meaning,
18
+ * so they are never sorted. */
19
+ readonly data: _angular_core.InputSignal<readonly FunnelChartStage[]>;
20
+ /** What the silhouette encodes. `'area'`, the default, makes each stage's AREA proportional to
21
+ * its value, which is the honest encoding that still leaves a tail wide enough to label.
22
+ * `'width'` reads the widths straight off the values, which collapses the tail of a steep
23
+ * funnel below a labellable width. `'taper'` encodes NOTHING: the shape is fixed whatever the
24
+ * data, and the numbers are read from the table beside it. */
25
+ readonly shape: _angular_core.InputSignal<FunnelChartShape>;
26
+ /** The value, percent and drop table printed under the funnel. It supersedes
27
+ * `dataTable`: while this is on, the disclosure every chart carries would
28
+ * repeat a strict subset of these same numbers, so it is not rendered. */
29
+ readonly showTable: _angular_core.InputSignalWithTransform<boolean, unknown>;
30
+ /** Printed above the plot as the chart's visible title, and reused as the annex table's
31
+ * caption. */
32
+ readonly caption: _angular_core.InputSignal<string | null>;
33
+ /** Accessible name. Generated from the data when omitted. */
34
+ readonly summary: _angular_core.InputSignal<string | null>;
35
+ /** The label-and-value disclosure every chart carries. Ignored while `showTable` is on, which
36
+ * already prints every label and value. Unset falls back to `DS_CONFIG.chart.dataTable`, then
37
+ * `'toggle'`. */
38
+ readonly dataTable: _angular_core.InputSignal<ChartDataTable | null>;
39
+ /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
40
+ * when the data lands. */
41
+ readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
42
+ /** Shown in place of the plot when `data` is empty. Unset falls back to
43
+ * `DS_CONFIG.chart.emptyText`, then `'No data'`. */
44
+ readonly emptyText: _angular_core.InputSignal<string | null>;
45
+ /** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
46
+ * because "the request failed" and "there is nothing to show" read the same to a reader and
47
+ * mean opposite things. */
48
+ readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
49
+ /** The message the error state prints. Unset falls back to `DS_CONFIG.chart.errorText`, then
50
+ * `'Could not load the data'`. */
51
+ readonly errorText: _angular_core.InputSignal<string | null>;
52
+ /** Formats every value the chart prints, the annex table and the generated description
53
+ * included. Unset falls back to `DS_CONFIG.chart.valueFormat`, then the browser's locale
54
+ * grouping with a K/M/B suffix past four digits. */
55
+ readonly valueFormat: _angular_core.InputSignal<ChartValueFormat | null>;
56
+ readonly dataTableResolved: _angular_core.Signal<ChartDataTable>;
57
+ readonly emptyTextResolved: _angular_core.Signal<string>;
58
+ readonly errorTextResolved: _angular_core.Signal<string>;
59
+ readonly valueFormatResolved: _angular_core.Signal<ChartValueFormat>;
60
+ /** Turns on the click affordance — the pointer cursor and any hover tint.
61
+ * The click output fires whether or not this is set, so a consumer that
62
+ * binds the output and forgets the flag still receives every click. */
63
+ readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
64
+ /** The stage that was clicked, or activated with Enter or Space. Fires whether or not
65
+ * `interactive` is set. */
66
+ readonly stageClicked: _angular_core.OutputEmitterRef<FunnelChartStage>;
67
+ /** Dims every OTHER mark while one is hovered or focused, so the reader's eye is held on the
68
+ * one under the pointer. Off by default: the dimming costs the separation BETWEEN the dimmed
69
+ * marks — measured 2026-09-13, the worst pair of three dimmed series falls from dE 14.8 at full
70
+ * opacity to 2.1 at `--ds-chart-dim-opacity`'s default 0.3 — so it buys loudness for one mark
71
+ * and pays for it with the rest of the chart. */
72
+ readonly dimOthers: _angular_core.InputSignalWithTransform<boolean, unknown>;
73
+ /** Milliseconds between one mark's entrance and the next. `0`, the default, is no stagger at
74
+ * all; `40` is the documented non-zero step. The total is capped, so a long series does not
75
+ * crawl in. */
76
+ readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
77
+ protected markStagger(index: number): string;
78
+ /** Whether a hovered or focused stage opens a tooltip. `'axis'` is not offered — a
79
+ * funnel's stages are its categories, so an axis tooltip would repeat the item one. */
80
+ readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
81
+ protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
82
+ $implicit: ChartTooltipContext;
83
+ }> | undefined>;
84
+ protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
85
+ /** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
86
+ * every mouse-operable control has to be separately focusable, and that is what keeps a
87
+ * twenty-five mark chart from being twenty-five stops in the page's tab order. */
88
+ protected readonly rovingIndex: _angular_core.WritableSignal<number>;
89
+ protected readonly tabStopIndex: _angular_core.Signal<number>;
90
+ protected onMarkFocus(index: number, event: FocusEvent): void;
91
+ protected onMarkNavigation(event: KeyboardEvent, index: number): void;
92
+ protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
93
+ protected readonly viewBox = "0 0 100 100";
94
+ /** The gap between two bands, painted as a TRANSPARENT STROKE on each. A stroke straddles the
95
+ * edge it is drawn on, so each band claims half the gap above it and half below — the gap stays
96
+ * exactly as wide to the eye and stops being dead space to the pointer. */
97
+ protected readonly hitGapUnits: _angular_core.Signal<number>;
98
+ protected readonly stages: _angular_core.Signal<{
99
+ stage: FunnelChartStage;
100
+ points: string;
101
+ formattedValue: string;
102
+ formattedPercent: string;
103
+ formattedDrop: string;
104
+ color: string;
105
+ }[]>;
106
+ protected readonly accessibleName: _angular_core.Signal<string>;
107
+ protected entryLabel(entry: {
108
+ stage: FunnelChartStage;
109
+ formattedValue: string;
110
+ }): string;
111
+ protected onStageKey(stage: FunnelChartStage, event: Event): void;
112
+ protected readonly isEmpty: _angular_core.Signal<boolean>;
113
+ protected readonly showDataTable: _angular_core.Signal<boolean>;
114
+ protected readonly chartHeight: _angular_core.Signal<string>;
115
+ /** Placeholder stage widths while loading. The count follows the real stage
116
+ * count so the chart does not resize when the data lands, falling back to
117
+ * three when `data` is still empty. The widths vary — and deliberately do
118
+ * not narrow in order — because a column of equal full-width bars is
119
+ * indistinguishable from a funnel whose stages have all gone grey, and a
120
+ * narrowing one just reads as the funnel itself. Same reasoning as the
121
+ * table's skeleton rows. */
122
+ protected readonly skeletonStages: _angular_core.Signal<("88%" | "62%" | "80%" | "54%" | "72%")[]>;
123
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FunnelChartComponent, never>;
124
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FunnelChartComponent, "ds-funnel-chart", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "showTable": { "alias": "showTable"; "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; }; "dimOthers": { "alias": "dimOthers"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "stageClicked": "stageClicked"; }, ["tooltipTemplate"], never, true, never>;
125
+ }
126
+
127
+ export { FunnelChartComponent };
128
+ export type { FunnelChartShape, FunnelChartStage };
@@ -28,8 +28,8 @@ declare class InputComponent extends DsControlValueAccessor<string> {
28
28
  /** Prevents editing while still allowing focus and selection. */
29
29
  readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
30
30
  /**
31
- * The contract spelling of `readOnly`, a second input because signal forms binds
32
- * by NAME — a `readonly()` rule was reaching nothing before this existed.
31
+ * The contract spelling of `readOnly`: signal forms binds by NAME, so a
32
+ * `readonly()` rule reaches nothing without it.
33
33
  */
34
34
  readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
35
35
  protected readonly isReadOnly: _angular_core.Signal<boolean>;
@@ -78,10 +78,8 @@ declare class InputComponent extends DsControlValueAccessor<string> {
78
78
  readonly blurred: _angular_core.OutputEmitterRef<void>;
79
79
  /**
80
80
  * Show an inline clear (×) button when the input has a non-empty value.
81
- * Mirrors the Material/PrimeNG pattern: explicit button (not native search
82
- * cancel) so the affordance is consistent across browsers and styled with
83
- * DS tokens. Defaults to true when type='search', false otherwise — pass
84
- * an explicit boolean to override.
81
+ * Defaults to true when `type="search"`, false otherwise — pass an explicit
82
+ * boolean to override.
85
83
  */
86
84
  readonly clearable: _angular_core.InputSignal<boolean | null>;
87
85
  /** Shows a show/hide button when `type="password"`. */
@@ -98,10 +96,10 @@ declare class InputComponent extends DsControlValueAccessor<string> {
98
96
  private readonly fieldMessage;
99
97
  protected readonly message: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.DsFieldMessage>;
100
98
  protected readonly controlState: _angular_core.Signal<_ids_group_ltd_ids_design_system_components_field_message.FieldMessageState | null>;
99
+ protected readonly groupMessage: _angular_core.Signal<string | null>;
101
100
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
102
101
  /** Only name via aria-label when there's no visible `<label for>`. */
103
102
  protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
104
- /** Effective disabled — own `disabled` input OR the reactive-forms state. */
105
103
  protected readonly isDisabled: _angular_core.Signal<boolean>;
106
104
  protected readonly currentLength: _angular_core.Signal<number>;
107
105
  protected readonly counterId: _angular_core.Signal<string | null>;