@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,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,109 @@
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 FunnelChartStage {
7
+ id: string;
8
+ label: string;
9
+ value: number;
10
+ }
11
+ /** How a stage's geometry encodes its value. `'area'` is the default; `'taper'` encodes nothing —
12
+ * the silhouette is fixed whatever the data. See `funnelGeometry`. */
13
+ type FunnelChartShape = 'taper' | 'width' | 'area';
14
+
15
+ declare class FunnelChartComponent {
16
+ /** Drawn in the order given. The order of a funnel's stages is its meaning,
17
+ * so they are never sorted. */
18
+ readonly data: _angular_core.InputSignal<readonly FunnelChartStage[]>;
19
+ /** What the silhouette encodes. `'area'`, the default, makes each stage's AREA proportional to
20
+ * its value, which is the honest encoding that still leaves a tail wide enough to label.
21
+ * `'width'` reads the widths straight off the values, which collapses the tail of a steep
22
+ * funnel below a labellable width. `'taper'` encodes NOTHING: the shape is fixed whatever the
23
+ * data, and the numbers are read from the table beside it. */
24
+ readonly shape: _angular_core.InputSignal<FunnelChartShape>;
25
+ /** The value, percent and drop table printed under the funnel. It supersedes
26
+ * `dataTable`: while this is on, the disclosure every chart carries would
27
+ * repeat a strict subset of these same numbers, so it is not rendered. */
28
+ readonly showTable: _angular_core.InputSignalWithTransform<boolean, unknown>;
29
+ /** Printed above the plot as the chart's visible title, and reused as the annex table's
30
+ * caption. */
31
+ readonly caption: _angular_core.InputSignal<string | null>;
32
+ /** Accessible name. Generated from the data when omitted. */
33
+ readonly summary: _angular_core.InputSignal<string | null>;
34
+ /** The label-and-value disclosure every chart carries. Ignored while
35
+ * `showTable` is on, which already prints every label and value. */
36
+ readonly dataTable: _angular_core.InputSignal<"toggle" | "visible" | "none">;
37
+ /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
38
+ * when the data lands. */
39
+ readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
40
+ /** Shown in place of the plot when `data` is empty. */
41
+ readonly emptyText: _angular_core.InputSignal<string>;
42
+ /** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
43
+ * because "the request failed" and "there is nothing to show" read the same to a reader and
44
+ * mean opposite things. */
45
+ readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
46
+ /** The message the error state prints. */
47
+ readonly errorText: _angular_core.InputSignal<string>;
48
+ /** Formats every value the chart prints, the annex table and the generated description
49
+ * included. Defaults to the browser's locale grouping with a K/M/B suffix past four digits. */
50
+ readonly valueFormat: _angular_core.InputSignal<(value: number) => string>;
51
+ /** Turns on the click affordance — the pointer cursor and any hover tint.
52
+ * The click output fires whether or not this is set, so a consumer that
53
+ * binds the output and forgets the flag still receives every click. */
54
+ readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
55
+ /** The stage that was clicked, or activated with Enter or Space. Fires whether or not
56
+ * `interactive` is set. */
57
+ readonly stageClicked: _angular_core.OutputEmitterRef<FunnelChartStage>;
58
+ /** Milliseconds between one mark's entrance and the next. `0`, the default, is no stagger at
59
+ * all; `40` is the documented non-zero step. The total is capped, so a long series does not
60
+ * crawl in. */
61
+ readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
62
+ protected markStagger(index: number): string;
63
+ /** Whether a hovered or focused stage opens a tooltip. `'axis'` is not offered — a
64
+ * funnel's stages are its categories, so an axis tooltip would repeat the item one. */
65
+ readonly tooltip: _angular_core.InputSignal<ChartItemTooltipTrigger>;
66
+ protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
67
+ $implicit: ChartTooltipContext;
68
+ }> | undefined>;
69
+ protected readonly activeMark: _ids_group_ltd_ids_design_system_components_chart_tooltip.ChartActiveMark;
70
+ /** One tab stop per chart, not one per mark: WCAG 2.1.1's Understanding is explicit that not
71
+ * every mouse-operable control has to be separately focusable, and that is what keeps a
72
+ * twenty-five mark chart from being twenty-five stops in the page's tab order. */
73
+ protected readonly rovingIndex: _angular_core.WritableSignal<number>;
74
+ protected readonly tabStopIndex: _angular_core.Signal<number>;
75
+ protected onMarkFocus(index: number, event: FocusEvent): void;
76
+ protected onMarkNavigation(event: KeyboardEvent, index: number): void;
77
+ protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
78
+ protected readonly viewBox = "0 0 100 100";
79
+ protected readonly stages: _angular_core.Signal<{
80
+ stage: FunnelChartStage;
81
+ points: string;
82
+ formattedValue: string;
83
+ formattedPercent: string;
84
+ formattedDrop: string;
85
+ color: string;
86
+ }[]>;
87
+ protected readonly accessibleName: _angular_core.Signal<string>;
88
+ protected entryLabel(entry: {
89
+ stage: FunnelChartStage;
90
+ formattedValue: string;
91
+ }): string;
92
+ protected onStageKey(stage: FunnelChartStage, event: Event): void;
93
+ protected readonly isEmpty: _angular_core.Signal<boolean>;
94
+ protected readonly showDataTable: _angular_core.Signal<boolean>;
95
+ protected readonly chartHeight: _angular_core.Signal<string>;
96
+ /** Placeholder stage widths while loading. The count follows the real stage
97
+ * count so the chart does not resize when the data lands, falling back to
98
+ * three when `data` is still empty. The widths vary — and deliberately do
99
+ * not narrow in order — because a column of equal full-width bars is
100
+ * indistinguishable from a funnel whose stages have all gone grey, and a
101
+ * narrowing one just reads as the funnel itself. Same reasoning as the
102
+ * table's skeleton rows. */
103
+ protected readonly skeletonStages: _angular_core.Signal<("88%" | "62%" | "80%" | "54%" | "72%")[]>;
104
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FunnelChartComponent, never>;
105
+ 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; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "stageClicked": "stageClicked"; }, ["tooltipTemplate"], never, true, never>;
106
+ }
107
+
108
+ export { FunnelChartComponent };
109
+ 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>;
@@ -0,0 +1,241 @@
1
+ import * as _ids_group_ltd_ids_design_system_components from '@ids-group-ltd/ids-design-system/components';
2
+ import * as _angular_core from '@angular/core';
3
+ import { TemplateRef } from '@angular/core';
4
+ import { ChartLegendItem } from '@ids-group-ltd/ids-design-system/components/chart-legend';
5
+ import { ChartTooltipTrigger, ChartTooltipContext, ChartTooltipOrigin } from '@ids-group-ltd/ids-design-system/components/chart-tooltip';
6
+
7
+ interface LineChartSeries {
8
+ id: string;
9
+ label: string;
10
+ /** A `null` is a missing reading. What it draws is the chart's `gaps` input. */
11
+ data: readonly (number | null)[];
12
+ /** Which y axis this series is measured against. Defaults to `'primary'`. */
13
+ axis?: 'primary' | 'secondary';
14
+ /** Fills the band between the line and its axis baseline. */
15
+ area?: boolean;
16
+ /** 1-based palette slot. Pinning it keeps every other series on its own colour
17
+ * when one is hidden; left out, a series takes the colour of its position. */
18
+ slot?: number;
19
+ }
20
+ /** How the secondary axis relates to the primary one.
21
+ *
22
+ * - `'rounded'` — one set of gridlines, and the secondary axis rounds its step up
23
+ * to a round number, so its series stops short of the top.
24
+ * - `'exact'` — one set of gridlines, and the secondary axis ends exactly at its
25
+ * largest reading, so its series uses the full height and the labels are not round.
26
+ * - `'independent'` — each axis is scaled and gridded on its own.
27
+ * - `'stacked'` — two plots one above the other, sharing the category axis. */
28
+ type LineChartAxisMode = 'rounded' | 'exact' | 'independent' | 'stacked';
29
+ /** What a `null` reading draws: a hole in the line, or a point at zero. */
30
+ type LineChartGaps = 'break' | 'zero';
31
+ /** One reading, named by the series it belongs to and the category it sits under. */
32
+ interface LineChartPoint {
33
+ readonly series: LineChartSeries;
34
+ readonly categoryIndex: number;
35
+ readonly category: string;
36
+ readonly value: number;
37
+ }
38
+
39
+ interface PlotArea {
40
+ readonly left: number;
41
+ readonly top: number;
42
+ readonly width: number;
43
+ readonly height: number;
44
+ }
45
+ interface AxisScale {
46
+ readonly max: number;
47
+ readonly ticks: readonly number[];
48
+ }
49
+ interface AxisLayout {
50
+ readonly primary: AxisScale;
51
+ /** Null when no series asked for a second axis. */
52
+ readonly secondary: AxisScale | null;
53
+ /** True when the secondary axis is drawn against the primary's gridlines. */
54
+ readonly alignedTicks: boolean;
55
+ }
56
+ interface ChartLayout {
57
+ readonly primaryPlot: PlotArea;
58
+ /** The same area as `primaryPlot` unless the plots are stacked. */
59
+ readonly secondaryPlot: PlotArea;
60
+ readonly categoryLabelY: number;
61
+ readonly stacked: boolean;
62
+ }
63
+ interface LinePoint {
64
+ readonly categoryIndex: number;
65
+ readonly x: number;
66
+ readonly y: number;
67
+ readonly value: number;
68
+ }
69
+
70
+ interface ResolvedSeries {
71
+ readonly series: LineChartSeries;
72
+ readonly values: readonly (number | null)[];
73
+ readonly onSecondaryAxis: boolean;
74
+ readonly color: string;
75
+ /** `null` while `patterns` is off, which is what keeps a solid line solid. */
76
+ readonly dash: string | null;
77
+ }
78
+ interface PlottedSeries extends ResolvedSeries {
79
+ readonly polylines: readonly string[];
80
+ readonly areaPaths: readonly string[];
81
+ readonly markers: readonly LinePoint[];
82
+ }
83
+ interface AxisTick {
84
+ readonly y: number;
85
+ readonly label: string;
86
+ }
87
+ interface CategoryLabel {
88
+ readonly x: number;
89
+ readonly text: string;
90
+ }
91
+ declare class LineChartComponent {
92
+ /** X labels. Every series' `data` is read against this length. */
93
+ readonly categories: _angular_core.InputSignal<readonly string[]>;
94
+ /** One line per entry. Every series is read against `categories`, so a series longer than it
95
+ * loses its tail and a shorter one ends early. */
96
+ readonly series: _angular_core.InputSignal<readonly LineChartSeries[]>;
97
+ /** How a secondary axis relates to the primary one. */
98
+ readonly yAxisMode: _angular_core.InputSignal<LineChartAxisMode>;
99
+ /** Draws a dot at every reading. Off, the dots appear on hover and on focus only. */
100
+ readonly showMarkers: _angular_core.InputSignalWithTransform<boolean, unknown>;
101
+ /** Makes every reading focusable and clickable. A series drawn without markers grows invisible
102
+ * ones so there is something to land on; they appear on hover and on focus.
103
+ *
104
+ * The click output fires whether or not this is set, so a consumer that binds the output and
105
+ * forgets the flag still receives every click. */
106
+ readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
107
+ /** The point that was clicked, or activated with Enter or Space. Fires whether or not
108
+ * `interactive` is set. */
109
+ readonly pointClicked: _angular_core.OutputEmitterRef<LineChartPoint>;
110
+ /** What a `null` reading draws. The default refuses to assert that a missing
111
+ * reading is a zero. */
112
+ readonly gaps: _angular_core.InputSignal<LineChartGaps>;
113
+ /** How many value-axis ticks to aim for. A hint, not a count: ticks snap to a round step, so
114
+ * the axis may carry one more or one fewer. */
115
+ readonly tickCount: _angular_core.InputSignalWithTransform<number, unknown>;
116
+ /** Printed above the plot as the chart's visible title, and reused as the annex table's
117
+ * caption. */
118
+ readonly caption: _angular_core.InputSignal<string | null>;
119
+ /** Accessible name. Generated from the data when omitted. */
120
+ readonly summary: _angular_core.InputSignal<string | null>;
121
+ /** The label-and-value table under the plot: `'toggle'` puts it behind a disclosure,
122
+ * `'visible'` opens it, `'none'` renders none. It is the non-visual route to the numbers, so
123
+ * `'none'` belongs only where the same data is already in a table on the page. */
124
+ readonly dataTable: _angular_core.InputSignal<"none" | "toggle" | "visible">;
125
+ /** Draws skeleton marks in place of the data, at the same count, so the chart does not resize
126
+ * when the data lands. */
127
+ readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
128
+ /** Shown in place of the plot when `data` is empty. */
129
+ readonly emptyText: _angular_core.InputSignal<string>;
130
+ /** Shows `errorText` in place of the plot. Separate from `loading` and from an empty `data`,
131
+ * because "the request failed" and "there is nothing to show" read the same to a reader and
132
+ * mean opposite things. */
133
+ readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
134
+ /** The message the error state prints. */
135
+ readonly errorText: _angular_core.InputSignal<string>;
136
+ /** Formats every value the chart prints, the annex table and the generated description
137
+ * included. Defaults to the browser's locale grouping with a K/M/B suffix past four digits. */
138
+ readonly valueFormat: _angular_core.InputSignal<(value: number) => string>;
139
+ protected readonly viewBox = "0 0 640 320";
140
+ protected readonly resolvedSeries: _angular_core.Signal<readonly ResolvedSeries[]>;
141
+ /** Ids of the series the legend has switched off. Two-way, so a page can drive it from a URL
142
+ * parameter and read back what the reader chose. */
143
+ readonly hiddenSeries: _angular_core.ModelSignal<readonly string[]>;
144
+ /** Whether hiding a series re-scales the value axis to what is left. Default `false`: a silent
145
+ * rescale turns a period-over-period comparison into a different claim, and a comparison
146
+ * dashboard is the common case. */
147
+ readonly rescaleOnHide: _angular_core.InputSignalWithTransform<boolean, unknown>;
148
+ /** Whether the legend switches series off. Off leaves it a plain key. */
149
+ readonly legendFilters: _angular_core.InputSignalWithTransform<boolean, unknown>;
150
+ /** Shown in place of the plot once the legend has switched every series off. Without it the
151
+ * reader is left with an empty grid and nothing saying why. */
152
+ readonly noVisibleSeriesText: _angular_core.InputSignal<string>;
153
+ /** Gives every series a dash pattern of its own, so the lines are told apart by shape as well
154
+ * as by colour — WCAG technique G111. Off by default: the shipped palette clears the
155
+ * colour-blind separation threshold on its own, so the patterns are for monochrome print, for a
156
+ * retuned palette, and for a reader who asks for them. */
157
+ readonly patterns: _angular_core.InputSignalWithTransform<boolean, unknown>;
158
+ /** Milliseconds between one series' entrance and the next. `0`, the default, is no stagger at
159
+ * all; `40` is the documented non-zero step. The total is capped, so a long list of series does
160
+ * not crawl in. */
161
+ readonly staggerMs: _angular_core.InputSignalWithTransform<number, unknown>;
162
+ protected markStagger(index: number): string;
163
+ protected readonly highlightedSeries: _angular_core.WritableSignal<string | null>;
164
+ protected readonly visibleSeries: _angular_core.Signal<readonly ResolvedSeries[]>;
165
+ protected readonly legendItems: _angular_core.Signal<readonly ChartLegendItem[]>;
166
+ protected isDimmed(seriesId: string): boolean;
167
+ protected readonly hasSecondaryAxis: _angular_core.Signal<boolean>;
168
+ protected readonly layout: _angular_core.Signal<ChartLayout>;
169
+ protected readonly axes: _angular_core.Signal<AxisLayout>;
170
+ protected readonly categoryPositions: _angular_core.Signal<number[]>;
171
+ protected readonly plottedSeries: _angular_core.Signal<readonly PlottedSeries[]>;
172
+ protected readonly primaryTicks: _angular_core.Signal<AxisTick[]>;
173
+ protected readonly secondaryTicks: _angular_core.Signal<readonly AxisTick[]>;
174
+ /** Drawn only when the two axes do not share the primary's gridlines, and only
175
+ * when the axis has more than the single tick a degenerate domain leaves. */
176
+ protected readonly showSecondaryGridlines: _angular_core.Signal<boolean>;
177
+ protected readonly stacked: _angular_core.Signal<boolean>;
178
+ protected readonly categoryLabelY: _angular_core.Signal<number>;
179
+ /** The category under the pointer, or -1. */
180
+ protected readonly activeCategory: _angular_core.WritableSignal<number>;
181
+ protected readonly categoryBands: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.BandScale>;
182
+ protected readonly activeBandX: _angular_core.Signal<number>;
183
+ protected readonly activeBandWidth: _angular_core.Signal<number>;
184
+ protected readonly activeCategoryX: _angular_core.Signal<number>;
185
+ protected onPlotPointer(event: PointerEvent): void;
186
+ protected clearActiveCategory(): void;
187
+ /** Whether the plot opens a tooltip, and for what. `'axis'` names every series at the
188
+ * category under the pointer, which is the reading a multi-series line is compared on;
189
+ * `'item'` names only the marker itself. */
190
+ readonly tooltip: _angular_core.InputSignal<ChartTooltipTrigger>;
191
+ protected readonly tooltipTemplate: _angular_core.Signal<TemplateRef<{
192
+ $implicit: ChartTooltipContext;
193
+ }> | undefined>;
194
+ protected readonly tooltipOrigin: _angular_core.WritableSignal<ChartTooltipOrigin | null>;
195
+ /** The series focus is on, or -1 for the whole category. A pointer answers for every
196
+ * series at once; a focused marker answers for its own. */
197
+ protected readonly activeSeries: _angular_core.WritableSignal<number>;
198
+ /** One tab stop PER SERIES, keyed by series id — each line is a strand the reader walks with
199
+ * the arrows. WCAG 2.1.1's Understanding is explicit that not every mouse-operable control has
200
+ * to be separately focusable, which is what keeps a 12-category, 2-series plot from being
201
+ * twenty-four stops in the page's tab order. */
202
+ protected readonly rovingByCategory: _angular_core.WritableSignal<ReadonlyMap<string, number>>;
203
+ protected isTabStop(seriesId: string, categoryIndex: number): boolean;
204
+ protected onMarkerFocus(seriesIndex: number, categoryIndex: number, event: FocusEvent): void;
205
+ protected onMarkerNavigation(event: KeyboardEvent, seriesIndex: number, categoryIndex: number): void;
206
+ private setRoving;
207
+ protected onMarkerBlur(): void;
208
+ protected readonly tooltipContext: _angular_core.Signal<ChartTooltipContext | null>;
209
+ protected readonly plotLeft: _angular_core.Signal<number>;
210
+ protected readonly plotRight: _angular_core.Signal<number>;
211
+ protected readonly primaryTopY: _angular_core.Signal<number>;
212
+ protected readonly secondaryTopY: _angular_core.Signal<number>;
213
+ protected readonly primaryBaselineY: _angular_core.Signal<number>;
214
+ protected readonly secondaryBaselineY: _angular_core.Signal<number>;
215
+ protected readonly primaryLabelX: _angular_core.Signal<number>;
216
+ protected readonly secondaryLabelX: _angular_core.Signal<number>;
217
+ protected readonly secondaryLabelAnchor: _angular_core.Signal<"end" | "start">;
218
+ protected readonly categoryLabels: _angular_core.Signal<readonly CategoryLabel[]>;
219
+ protected readonly tableRows: _angular_core.Signal<{
220
+ category: string;
221
+ cells: string[];
222
+ }[]>;
223
+ protected readonly accessibleName: _angular_core.Signal<string>;
224
+ protected pointOf(entry: PlottedSeries, marker: LinePoint): LineChartPoint;
225
+ protected markerLabel(entry: PlottedSeries, marker: LinePoint): string;
226
+ protected onMarkerKey(entry: PlottedSeries, marker: LinePoint, event: Event): void;
227
+ protected readonly isEmpty: _angular_core.Signal<boolean>;
228
+ protected readonly showLegend: _angular_core.Signal<boolean>;
229
+ protected readonly noVisibleSeries: _angular_core.Signal<boolean>;
230
+ /** Placeholder legend rows while loading. Follows the real series count so the
231
+ * chart does not resize when the data lands; falls back to three when `series`
232
+ * is still empty. */
233
+ protected readonly skeletonSeries: _angular_core.Signal<unknown[]>;
234
+ private plotFor;
235
+ private ticksFor;
236
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<LineChartComponent, never>;
237
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<LineChartComponent, "ds-line-chart", never, { "categories": { "alias": "categories"; "required": true; "isSignal": true; }; "series": { "alias": "series"; "required": true; "isSignal": true; }; "yAxisMode": { "alias": "yAxisMode"; "required": false; "isSignal": true; }; "showMarkers": { "alias": "showMarkers"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "gaps": { "alias": "gaps"; "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; }; "hiddenSeries": { "alias": "hiddenSeries"; "required": false; "isSignal": true; }; "rescaleOnHide": { "alias": "rescaleOnHide"; "required": false; "isSignal": true; }; "legendFilters": { "alias": "legendFilters"; "required": false; "isSignal": true; }; "noVisibleSeriesText": { "alias": "noVisibleSeriesText"; "required": false; "isSignal": true; }; "patterns": { "alias": "patterns"; "required": false; "isSignal": true; }; "staggerMs": { "alias": "staggerMs"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; }, { "pointClicked": "pointClicked"; "hiddenSeries": "hiddenSeriesChange"; }, ["tooltipTemplate"], never, true, never>;
238
+ }
239
+
240
+ export { LineChartComponent };
241
+ export type { LineChartAxisMode, LineChartGaps, LineChartPoint, LineChartSeries };
@@ -53,15 +53,10 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
53
53
  }
54
54
 
55
55
  declare class RadioComponent extends DsFieldBase {
56
- /** Standalone two-way binding, and the ONLY way to drive a lone radio: this
57
- * component is deliberately not a `ControlValueAccessor`, so `[formControl]` and
58
- * `ngModel` do not bind to it. Inside `ds-radio-group` the GROUP is the form
59
- * control — a radio is one option of a choice, not a value of its own — and a
60
- * second accessor on the option would fight it. A lone radio in a form binds
61
- * through `[(checked)]`, or becomes a one-option `ds-radio-group`.
62
- *
63
- * When inside `ds-radio-group`, `isChecked()` derives from the group value and
64
- * this input is not read. */
56
+ /** The ONLY way to drive a lone radio: this is deliberately not a `ControlValueAccessor`, so
57
+ * `[formControl]` and `ngModel` do not bind to it — inside `ds-radio-group` the GROUP is the
58
+ * form control, and a second accessor on one option would fight it. Inside a group this input
59
+ * is not read at all. */
65
60
  readonly checked: _angular_core.ModelSignal<boolean>;
66
61
  /** Lets a checked standalone radio be cleared by clicking it again. Off by default, and
67
62
  * ignored inside `ds-radio-group`: there a radio is one option of a choice, and clearing it
@@ -83,11 +78,16 @@ declare class RadioComponent extends DsFieldBase {
83
78
  /** Inline label rendered beside the dot and wired via for/id. Omit to bring
84
79
  * your own <label>. */
85
80
  readonly label: _angular_core.InputSignal<string>;
81
+ /** Accessible name for a control with no visible label — the row's `<label>` collapses when it
82
+ * is empty, leaving nothing to name it. Set beside a label it OVERRIDES the label, per ARIA. */
83
+ readonly ariaLabel: _angular_core.InputSignal<string | null>;
86
84
  protected readonly uid: string;
87
85
  protected readonly controlId: _angular_core.Signal<string>;
88
86
  protected readonly hintId: _angular_core.Signal<string | null>;
89
87
  private readonly fieldMessage;
90
88
  protected readonly message: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.DsFieldMessage>;
89
+ /** Only name via aria-label when there is no visible `<label for>` to do it. */
90
+ protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
91
91
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
92
92
  /** Injected via token to avoid circular import with RadioGroupComponent. */
93
93
  protected readonly group: _ids_group_ltd_ids_design_system_components_radio_group.RadioGroupContract | null;
@@ -103,7 +103,7 @@ declare class RadioComponent extends DsFieldBase {
103
103
  protected onClick(): void;
104
104
  protected onSelect(): void;
105
105
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<RadioComponent, never>;
106
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioComponent, "ds-radio", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "deselectable": { "alias": "deselectable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "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>;
106
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioComponent, "ds-radio", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "deselectable": { "alias": "deselectable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "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>;
107
107
  }
108
108
 
109
109
  export { RADIO_GROUP, RadioComponent, RadioGroupComponent };
@@ -5,6 +5,7 @@ import * as _ids_group_ltd_ids_design_system_core from '@ids-group-ltd/ids-desig
5
5
  import { DsOptionItem, DsOption, DsOptionGroup, DsControlWidth, DsSize } from '@ids-group-ltd/ids-design-system/core';
6
6
  import * as _angular_core from '@angular/core';
7
7
  import { OnDestroy, TemplateRef, ElementRef } from '@angular/core';
8
+ import { describedByIds } from '@ids-group-ltd/ids-design-system/components/field-group';
8
9
 
9
10
  interface SelectOption extends DsOption<string> {
10
11
  }
@@ -59,8 +60,8 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
59
60
  /** Prevents opening the dropdown while still allowing focus. */
60
61
  readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
61
62
  /**
62
- * The contract spelling of `readOnly`, a second input because signal forms binds
63
- * by NAME — a `readonly()` rule was reaching nothing before this existed.
63
+ * The contract spelling of `readOnly`: signal forms binds by NAME, so a
64
+ * `readonly()` rule reaches nothing without it.
64
65
  */
65
66
  readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
66
67
  protected readonly isReadOnly: _angular_core.Signal<boolean>;
@@ -90,6 +91,8 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
90
91
  private readonly fieldMessage;
91
92
  protected readonly message: _angular_core.Signal<_ids_group_ltd_ids_design_system_components.DsFieldMessage>;
92
93
  protected readonly controlState: _angular_core.Signal<_ids_group_ltd_ids_design_system_components_field_message.FieldMessageState | null>;
94
+ protected readonly groupMessage: _angular_core.Signal<string | null>;
95
+ protected readonly describedByIds: typeof describedByIds;
93
96
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
94
97
  protected optionId(flatIndex: number): string;
95
98
  /** Active option for `aria-activedescendant` (combobox keeps DOM focus). */