@ids-group-ltd/ids-design-system 0.9.1 → 0.10.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.
@@ -88,6 +88,7 @@ declare const ICONS: {
88
88
  readonly mail: "<rect x=\"3\" y=\"5\" width=\"18\" height=\"14\" rx=\"2\" /><path d=\"m3 7 9 6 9-6\" />";
89
89
  readonly 'eye-off': "<path d=\"M3 3l18 18\" /><path d=\"M10.6 6.1A10 10 0 0 1 12 6c6 0 10 7 10 7a14 14 0 0 1-2.4 3.1\" /><path d=\"M6.7 6.7A14 14 0 0 0 2 12s4 7 10 7a10 10 0 0 0 4.5-1\" /><path d=\"M9.9 14.1A3 3 0 0 1 9 12a3 3 0 0 1 3-3 3 3 0 0 1 2.1.9\" />";
90
90
  readonly 'check-circle': "<circle cx=\"12\" cy=\"12\" r=\"9\" /><path d=\"m8 12 3 3 5-6\" />";
91
+ readonly circle: "<circle cx=\"12\" cy=\"12\" r=\"8\" />";
91
92
  readonly drag: "<circle cx=\"9\" cy=\"6\" r=\"1.6\" /><circle cx=\"15\" cy=\"6\" r=\"1.6\" /><circle cx=\"9\" cy=\"12\" r=\"1.6\" /><circle cx=\"15\" cy=\"12\" r=\"1.6\" /><circle cx=\"9\" cy=\"18\" r=\"1.6\" /><circle cx=\"15\" cy=\"18\" r=\"1.6\" />";
92
93
  readonly scan: "<path d=\"M4 8V5a1 1 0 0 1 1-1h3M16 4h3a1 1 0 0 1 1 1v3M20 16v3a1 1 0 0 1-1 1h-3M8 20H5a1 1 0 0 1-1-1v-3\" />";
93
94
  readonly wifi: "<path d=\"M2 9.5a15 15 0 0 1 20 0\" /><path d=\"M5 13a10 10 0 0 1 14 0\" /><path d=\"M8.5 16.5a5 5 0 0 1 7 0\" /><path d=\"M12 20h.01\" />";
@@ -98,6 +99,16 @@ declare const ICONS: {
98
99
  * autocomplete for those custom names). */
99
100
  type IconName = keyof typeof ICONS | (string & {});
100
101
 
102
+ /**
103
+ * Canonical control-size scale — the shared vocabulary components bind their
104
+ * `size` input to. A component that needs extra steps extends this base with its
105
+ * own (component-named) type, kept inside that component.
106
+ */
107
+ type DsSize = 'sm' | 'md' | 'lg';
108
+
109
+ type CardElevation = 'flat' | 'raised' | 'hover' | 'interactive';
110
+ type CardPadding = 'none' | 'sm' | 'md' | 'lg';
111
+
101
112
  interface DsConfig {
102
113
  field?: {
103
114
  /** Default for every field's `reserveMessage` — keeps a message line's worth
@@ -120,6 +131,61 @@ interface DsConfig {
120
131
  /** Display format for `ds-time-picker` / date-picker time — 24h or 12h AM/PM. Default `'24h'`. */
121
132
  format?: '24h' | '12h';
122
133
  };
134
+ avatar?: {
135
+ /** How `ds-avatar` turns its `name` into initials, app-wide. The built-in rule
136
+ * takes the first two words — a Latin-script guess. Reading a name is a cultural
137
+ * convention, so an app that knows its own provides it here. */
138
+ initials?: (name: string) => string;
139
+ };
140
+ brand?: {
141
+ /** Brand text for `ds-sidenav` and `ds-auth-layout` — the wordmark, and the
142
+ * source of the letter-mark's glyph when `logoLetter` is unset. */
143
+ name?: string;
144
+ /** Letter-mark glyph when it differs from the brand's first character. */
145
+ logoLetter?: string;
146
+ /** Strapline under the brand row. `ds-auth-layout` only. */
147
+ tagline?: string;
148
+ };
149
+ modal?: {
150
+ /** Default for `dividers` on `ds-modal` and `ds-modal-card`. Default `true`.
151
+ * Configurable app-wide because a `ModalService` confirm renders a card with no
152
+ * `ds-modal` ancestor to bind — an attribute cannot reach it. */
153
+ dividers?: boolean;
154
+ };
155
+ control?: {
156
+ /** Default `size` for every control on the field-height contract. Default `'md'`.
157
+ *
158
+ * A different axis from `[data-density]`: that tier rewrites hit targets and
159
+ * padding in CSS, this picks which of the three declared sizes a control renders
160
+ * at. A screen that differs still binds `size` per element. */
161
+ size?: DsSize;
162
+ };
163
+ card?: {
164
+ /** Default `elevation` for `ds-card`. Default `'flat'`. */
165
+ elevation?: CardElevation;
166
+ /** Default `padding` preset for `ds-card`. Unset keeps the card's own. */
167
+ padding?: CardPadding;
168
+ };
169
+ table?: {
170
+ /** Default for `ds-table`'s `stickyScrollbar` — the proxy that keeps the
171
+ * horizontal bar reachable on a tall table. Default `false`. A whole-app
172
+ * opinion in practice: one consumer binds it on all 35 of its tables, and
173
+ * every new table is one forgotten binding away from scrolling invisibly. */
174
+ stickyScrollbar?: boolean;
175
+ /** Default for `ds-table`'s `bordered` — the outer border and radius.
176
+ * Default `false`. Per app rather than per table in practice, which is why
177
+ * it is here: `provideDsConfig` scopes to a root or a route subtree, so the
178
+ * deliberate exceptions stay visible as bindings. */
179
+ bordered?: boolean;
180
+ };
181
+ icon?: {
182
+ /** Default pixel `size` for `ds-icon`. Default `16`. */
183
+ size?: number;
184
+ };
185
+ badge?: {
186
+ /** Default for `ds-badge`'s `withDot` — the leading status dot. Default `false`. */
187
+ withDot?: boolean;
188
+ };
123
189
  datePicker?: {
124
190
  /** BCP-47 locale for `ds-date-picker` names + value format. Default `'en-US'`. */
125
191
  locale?: string;
@@ -132,7 +198,7 @@ interface DsConfig {
132
198
  declare const DS_CONFIG: InjectionToken<DsConfig>;
133
199
  /** Provide DS-level defaults.
134
200
  *
135
- * providers: [provideDsConfig({ card: { padding: 'sm' } })]
201
+ * providers: [provideDsConfig({ control: { size: 'sm' } })]
136
202
  *
137
203
  * Works at the app root, on a `Route`, or on a component/directive — the
138
204
  * config resolves through the element-injector chain, so a subtree can differ
@@ -208,6 +274,22 @@ declare class BodyScrollLockService {
208
274
  static ɵprov: _angular_core.ɵɵInjectableDeclaration<BodyScrollLockService>;
209
275
  }
210
276
 
277
+ /**
278
+ * The shape every picker's option shares — select, multi-select, autocomplete.
279
+ * Add a field HERE, or the three drift apart the way `icon` did. Each keeps its
280
+ * own exported name: those are public API.
281
+ *
282
+ * `T` exists because autocomplete carries typed values; the other two are keyed
283
+ * by string.
284
+ */
285
+ interface DsOption<T = string> {
286
+ value: T;
287
+ label: string;
288
+ disabled?: boolean;
289
+ /** Rendered before the label at 16px by every picker's option row. */
290
+ icon?: IconName;
291
+ }
292
+
211
293
  /** Canonical status vocabulary shared across status-bearing components. */
212
294
  type DsStatus = 'info' | 'success' | 'warning' | 'error';
213
295
  /**
@@ -233,18 +315,14 @@ interface DsStatusRegistry {
233
315
  */
234
316
  type DsStatusKey = [keyof DsStatusRegistry] extends [never] ? string : keyof DsStatusRegistry;
235
317
 
236
- /**
237
- * Canonical control-size scale — the shared vocabulary components bind their
238
- * `size` input to. A component that needs extra steps extends this base with its
239
- * own (component-named) type, kept inside that component.
240
- */
241
- type DsSize = 'sm' | 'md' | 'lg';
242
-
243
318
  declare class IconComponent {
244
319
  private readonly sanitizer;
245
320
  private readonly registry;
246
321
  readonly name: _angular_core.InputSignal<IconName>;
247
- readonly size: _angular_core.InputSignal<number>;
322
+ /** Pixel size of the square glyph. Unset falls back to `DS_CONFIG.icon.size`,
323
+ * then `16`. */
324
+ readonly size: _angular_core.InputSignalWithTransform<number | null, unknown>;
325
+ protected readonly sizeResolved: _angular_core.Signal<number>;
248
326
  readonly stroke: _angular_core.InputSignal<number>;
249
327
  /** When set, the icon is exposed to assistive tech as an image with this
250
328
  * name; otherwise it is decorative and hidden (`aria-hidden`). */
@@ -328,8 +406,10 @@ declare class ButtonComponent {
328
406
  discouraged for ALL colours — prefer the global `.link` class; it stays for
329
407
  cases needing the ds-button API (loading/fullWidth/typed pressed). */
330
408
  readonly variant: _angular_core.InputSignal<ButtonVariant>;
331
- /** Button height — sm/md/lg. */
332
- readonly size: _angular_core.InputSignal<DsSize>;
409
+ /** Button height — sm/md/lg.
410
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
411
+ readonly size: _angular_core.InputSignal<DsSize | null>;
412
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
333
413
  /** Native `<button>` `type`; defaults to `'button'` (not `'submit'`) so it never submits an ancestor form by accident. */
334
414
  readonly type: _angular_core.InputSignal<ButtonType>;
335
415
  /** Disables the button and blocks `pressed`. */
@@ -403,8 +483,10 @@ declare class IconButtonComponent {
403
483
  /** Brand/status hue family (shared with ds-button). `variant` is the fill
404
484
  axis; `color` recolours the accent the fill consumes. Default primary. */
405
485
  readonly color: _angular_core.InputSignal<ButtonColor>;
406
- /** Button size — sm/md/lg, matches the field/button height scale. */
407
- readonly size: _angular_core.InputSignal<DsSize>;
486
+ /** Button size — sm/md/lg, matches the field/button height scale.
487
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
488
+ readonly size: _angular_core.InputSignal<DsSize | null>;
489
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
408
490
  /** Native `<button>` `type`; defaults to `'button'` (not `'submit'`) so it never submits an ancestor form by accident. */
409
491
  readonly type: _angular_core.InputSignal<IconButtonType>;
410
492
  /** Disables the button and blocks `pressed`. */
@@ -431,7 +513,9 @@ declare class BadgeComponent {
431
513
  /** Consumer-defined status key; colours are wired via styles/status. Unset → neutral. */
432
514
  readonly status: _angular_core.InputSignal<string | undefined>;
433
515
  /** Shows a status dot; only rendered when `count` is unset. */
434
- readonly withDot: _angular_core.InputSignalWithTransform<boolean, unknown>;
516
+ /** Leading status dot. Unset falls back to `DS_CONFIG.badge.withDot`, then `false`. */
517
+ readonly withDot: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
518
+ protected readonly withDotResolved: _angular_core.Signal<boolean>;
435
519
  /** Solid accent fill instead of the default subtle background. */
436
520
  readonly solid: _angular_core.InputSignalWithTransform<boolean, unknown>;
437
521
  /** Numeric count to display; overrides projected content when set. */
@@ -710,9 +794,6 @@ declare class LayoutNavigationService {
710
794
  static ɵprov: _angular_core.ɵɵInjectableDeclaration<LayoutNavigationService>;
711
795
  }
712
796
 
713
- type CardElevation = 'flat' | 'raised' | 'hover' | 'interactive';
714
- type CardPadding = 'none' | 'sm' | 'md' | 'lg';
715
-
716
797
  /**
717
798
  * Marks projected wordmark markup for `ds-sidenav`: when present, the sidenav
718
799
  * renders the projected content inside `.brand-name` instead of the plain
@@ -764,13 +845,24 @@ declare class BrandNameDirective {
764
845
  */
765
846
  declare class AuthLayoutComponent {
766
847
  /** Wordmark beside the letter-mark tile. For a logo image/SVG, project it into
767
- * the `[brand]` slot instead; for a two-tone wordmark use `[dsBrandName]`. */
768
- readonly brand: _angular_core.InputSignal<string>;
848
+ * the `[brand]` slot instead; for a two-tone wordmark use `[dsBrandName]`.
849
+ * Unset falls back to `DS_CONFIG.brand.name` — six auth screens answer this
850
+ * identically. Each field resolves on its own, so `brand=""` drops the wordmark
851
+ * but a `logoLetter` in the config still paints its tile; clear both to give one
852
+ * screen no brand row. */
853
+ readonly brand: _angular_core.InputSignal<string | null>;
769
854
  /** Letter-mark glyph when it differs from the brand's first letter (e.g. an
770
- * "A" tile beside the "MyAdmin" wordmark). Empty = first letter of `brand`. */
771
- readonly logoLetter: _angular_core.InputSignal<string>;
772
- /** One line under the wordmark naming the product or audience. */
773
- readonly tagline: _angular_core.InputSignal<string>;
855
+ * "A" tile beside the "MyAdmin" wordmark). Empty = first letter of `brand`;
856
+ * unset falls back to `DS_CONFIG.brand.logoLetter`. */
857
+ readonly logoLetter: _angular_core.InputSignal<string | null>;
858
+ /** One line under the wordmark naming the product or audience. Unset falls back
859
+ * to `DS_CONFIG.brand.tagline`. */
860
+ readonly tagline: _angular_core.InputSignal<string | null>;
861
+ /** The template must read THIS, never the input beside it — that one is null
862
+ * until bound, and the config default lives here. */
863
+ protected readonly brandName: _angular_core.Signal<string>;
864
+ protected readonly letterGlyph: _angular_core.Signal<string>;
865
+ protected readonly taglineText: _angular_core.Signal<string>;
774
866
  /** Card treatment. `flat` suits a screen that already sits on a tinted canvas. */
775
867
  readonly cardElevation: _angular_core.InputSignal<CardElevation>;
776
868
  /** Card padding, passed through to `ds-card`. `md` tightens a short form. */
@@ -783,7 +875,7 @@ declare class AuthLayoutComponent {
783
875
  * site nests it inside `ds-app-layout`), and two `main`s is its own violation.
784
876
  * Defaulting it to `'main'` is the better end state and belongs in the next
785
877
  * batch of default changes. */
786
- readonly landmark: _angular_core.InputSignal<"main" | "none">;
878
+ readonly landmark: _angular_core.InputSignal<"none" | "main">;
787
879
  /** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
788
880
  protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
789
881
  protected readonly hasBrandName: _angular_core.Signal<boolean>;
@@ -854,6 +946,11 @@ declare class FilterBarComponent {
854
946
  readonly moreLabel: _angular_core.InputSignal<string>;
855
947
  /** Accessible name of the overflow panel. */
856
948
  readonly panelLabel: _angular_core.InputSignal<string>;
949
+ /** Height of the "+N" trigger, to match the filters beside it. The bar cannot
950
+ * infer this: `dsFilterItem` carries a WIDTH, and the filters are arbitrary
951
+ * projected controls whose own `size` it never sees — so a row of `sm` filters
952
+ * got an `md` trigger standing 8px taller under `align-items: flex-end`. */
953
+ readonly triggerSize: _angular_core.InputSignal<DsSize>;
857
954
  protected readonly devMode: boolean;
858
955
  protected readonly items: _angular_core.Signal<readonly FilterItemDirective[]>;
859
956
  private readonly row;
@@ -865,13 +962,15 @@ declare class FilterBarComponent {
865
962
  readonly collapsed: _angular_core.Signal<FilterItemDirective[]>;
866
963
  constructor();
867
964
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<FilterBarComponent, never>;
868
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<FilterBarComponent, "ds-filter-bar", never, { "moreLabel": { "alias": "moreLabel"; "required": false; "isSignal": true; }; "panelLabel": { "alias": "panelLabel"; "required": false; "isSignal": true; }; }, {}, ["items"], ["[dsFilterBarTrailing]", "*"], true, never>;
965
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FilterBarComponent, "ds-filter-bar", never, { "moreLabel": { "alias": "moreLabel"; "required": false; "isSignal": true; }; "panelLabel": { "alias": "panelLabel"; "required": false; "isSignal": true; }; "triggerSize": { "alias": "triggerSize"; "required": false; "isSignal": true; }; }, {}, ["items"], ["[dsFilterBarTrailing]", "*"], true, never>;
869
966
  }
870
967
 
871
968
  /** What a grouped control can read off the group that encloses it. */
872
969
  interface DsFieldGroupContext {
873
- /** The group's size, so a segment matches its neighbours without being told. */
874
- readonly size: () => DsSize;
970
+ /** The group's size, so a segment matches its neighbours without being told.
971
+ * Resolved, not the raw input: `size` is unset by default and falls back to
972
+ * `DS_CONFIG.control.size`, which a segment must not have to resolve again. */
973
+ readonly sizeResolved: () => DsSize;
875
974
  }
876
975
  /**
877
976
  * Provided by `ds-field-group`, injected `{ optional: true }` by every control
@@ -907,8 +1006,10 @@ declare const DS_FIELD_GROUP: InjectionToken<DsFieldGroupContext>;
907
1006
  */
908
1007
  declare class FieldGroupComponent implements DsFieldGroupContext {
909
1008
  /** Segment height — the field family's scale, so a group lines up with a
910
- * plain field beside it. */
911
- readonly size: _angular_core.InputSignal<DsSize>;
1009
+ * plain field beside it.
1010
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1011
+ readonly size: _angular_core.InputSignal<DsSize | null>;
1012
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
912
1013
  /** Draws the error border on the whole group. A single segment cannot be
913
1014
  * invalid on its own: the border belongs to the group. */
914
1015
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -927,8 +1028,20 @@ type AvatarStatus = 'online' | 'offline' | 'away' | 'busy';
927
1028
  declare class AvatarComponent {
928
1029
  /** Diameter — xs/sm/lg apply a size class; md is the default. */
929
1030
  readonly size: _angular_core.InputSignal<AvatarSize>;
930
- /** Fallback text shown when there's no `imageUrl`. */
1031
+ /** Fallback text shown when there's no `imageUrl`. Wins over anything derived
1032
+ * from `name`, so a caller that already has the letters keeps passing them. */
931
1033
  readonly initials: _angular_core.InputSignal<string>;
1034
+ /** The person or thing this avatar stands for. One binding covers both jobs the
1035
+ * caller used to wire by hand: the initials, and the seed the tint hashes.
1036
+ *
1037
+ * The tint keys on the NAME, never on the initials — two letters collide
1038
+ * wholesale, so every Alice Brown and Adam Bell would share one colour. */
1039
+ readonly name: _angular_core.InputSignal<string>;
1040
+ /** Replaces the built-in rule for turning `name` into initials, for one avatar
1041
+ * or one table of them. Falls back to `DS_CONFIG.avatar.initials`, then to
1042
+ * `initialsFrom` — first two words, a Latin-script guess the library does not
1043
+ * pretend is universal. */
1044
+ readonly initialsRule: _angular_core.InputSignal<((name: string) => string) | null>;
932
1045
  /** Image source; shown before `initials` or `fallbackIcon` when set. */
933
1046
  readonly imageUrl: _angular_core.InputSignal<string | null>;
934
1047
  /** Accessible name. When omitted, the avatar is treated as decorative
@@ -945,19 +1058,22 @@ declare class AvatarComponent {
945
1058
  readonly status: _angular_core.InputSignal<AvatarStatus | null>;
946
1059
  /** Icon rendered when there is no imageUrl and no initials. */
947
1060
  readonly fallbackIcon: _angular_core.InputSignal<IconName | null>;
948
- /** Seed for a deterministic tint (e.g. an email or name) used when no explicit
949
- * `tint` is set — the same seed always yields the same colour. */
1061
+ /** Seed for a deterministic tint (e.g. an email) used when no explicit `tint` is
1062
+ * set — the same seed always yields the same colour. Defaults to `name`; set it
1063
+ * explicitly when identity is an id or an email rather than the display name. */
950
1064
  readonly seed: _angular_core.InputSignal<string | null>;
951
1065
  /** Hue arcs `[start, end]` (0–360°) the seeded tint must avoid, e.g. a brand
952
1066
  * hue: `[[310, 360], [0, 20]]`. Only applies when `seed` drives the tint. */
953
1067
  readonly avoidHues: _angular_core.InputSignal<readonly (readonly [number, number])[]>;
1068
+ private readonly config;
1069
+ protected readonly initialsText: _angular_core.Signal<string>;
954
1070
  protected readonly tintStyle: _angular_core.Signal<{
955
1071
  bg: string | null;
956
1072
  fg: string | null;
957
1073
  }>;
958
1074
  protected readonly statusAriaLabel: _angular_core.Signal<string | null>;
959
1075
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AvatarComponent, never>;
960
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AvatarComponent, "ds-avatar", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "initials": { "alias": "initials"; "required": false; "isSignal": true; }; "imageUrl": { "alias": "imageUrl"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "tint": { "alias": "tint"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "fallbackIcon": { "alias": "fallbackIcon"; "required": false; "isSignal": true; }; "seed": { "alias": "seed"; "required": false; "isSignal": true; }; "avoidHues": { "alias": "avoidHues"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
1076
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AvatarComponent, "ds-avatar", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "initials": { "alias": "initials"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "initialsRule": { "alias": "initialsRule"; "required": false; "isSignal": true; }; "imageUrl": { "alias": "imageUrl"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "tint": { "alias": "tint"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "fallbackIcon": { "alias": "fallbackIcon"; "required": false; "isSignal": true; }; "seed": { "alias": "seed"; "required": false; "isSignal": true; }; "avoidHues": { "alias": "avoidHues"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
961
1077
  }
962
1078
 
963
1079
  /** Options for {@link avatarTint}. */
@@ -967,27 +1083,37 @@ interface AvatarTintOptions {
967
1083
  * pink brand hue and reds. An arc crossing 0° must be given as two arcs.
968
1084
  * Default: none (full 0–360 range). */
969
1085
  avoidHues?: readonly (readonly [number, number])[];
970
- /** OKLCH lightness percentage. Default 62. */
1086
+ /** HSL lightness percentage. Default 62. */
971
1087
  lightness?: number;
972
- /** OKLCH chroma. Default 0.14. */
973
- chroma?: number;
974
- /** Text colour paired with the background. Default: auto — black or white,
975
- * whichever reads best on the derived background (WCAG luminance). */
1088
+ /** HSL saturation percentage. Default 50. */
1089
+ saturation?: number;
1090
+ /** Text colour paired with the background. Default `#fff`. */
976
1091
  foreground?: string;
977
1092
  }
978
1093
  /** Deterministic `{ bg, fg }` tint for a seed string (an email, a name), so the
979
- * same person always gets the same colour. The background is an OKLCH colour
980
- * (perceptually even lightness across hues); the text defaults to whichever of
981
- * black/white reads best on it. Pass to `ds-avatar`'s `tint`, or let the
982
- * component derive it via its `seed` input. */
1094
+ * same person always gets the same colour.
1095
+ *
1096
+ * The background is `hsl(H 50% 62%)` and the text is always WHITE. HSL lightness is
1097
+ * not perceptually even, so the set reads bright — at the cost of contrast: white on
1098
+ * the lighter hues measures as little as 1.65:1, under the 4.5:1 WCAG AA asks of
1099
+ * text. Where the initials are the only identifier, pass your own `lightness`
1100
+ * (about 50) and keep white, which measures 5.3-6.6:1.
1101
+ *
1102
+ * Pass to `ds-avatar`'s `tint`, or let the component derive it via `seed`. */
983
1103
  declare function avatarTint(seed: string, options?: AvatarTintOptions): {
984
1104
  bg: string;
985
1105
  fg: string;
986
1106
  };
987
- /** Uppercased initials from the first two words. Accepts `(first, last)` parts
988
- * or a single full name (`initialsFrom('Ada Lovelace')` → `AL`); a lone name
989
- * gives one letter, `?` when empty. More than two words is rare — only the
990
- * first two are used. */
1107
+ /** Uppercased initials from the first two words. Accepts `(first, last)` parts or
1108
+ * a single full name (`initialsFrom('Ada Lovelace')` → `AL`); a lone name gives
1109
+ * one letter, `?` when empty.
1110
+ *
1111
+ * A deliberately naive Latin-script guess, and the library's ONLY naming rule.
1112
+ * Reading a name is a cultural convention, not a UI decision — "María José
1113
+ * García López" wants MG from a Spanish reader and "Blue Cross Blue Shield" wants
1114
+ * BC from an insurer — so an app with a real rule passes its own through
1115
+ * `DS_CONFIG.avatar.initials` or `ds-avatar`'s `initialsRule` rather than asking
1116
+ * this to grow modes it cannot get right. */
991
1117
  declare function initialsFrom(first?: string, last?: string): string;
992
1118
 
993
1119
  declare class AvatarGroupComponent {
@@ -1001,15 +1127,20 @@ declare class AvatarGroupComponent {
1001
1127
  }
1002
1128
 
1003
1129
  declare class CardComponent {
1004
- /** Visual treatment; `interactive` makes the card clickable and emits `pressed`. */
1005
- readonly elevation: _angular_core.InputSignal<CardElevation>;
1006
- /** Inner padding preset; `null` keeps the card's default padding. */
1130
+ /** Visual treatment; `interactive` makes the card clickable and emits `pressed`.
1131
+ * Unset falls back to `DS_CONFIG.card.elevation`, then `'flat'`. */
1132
+ readonly elevation: _angular_core.InputSignal<CardElevation | null>;
1133
+ /** Inner padding preset. Unset falls back to `DS_CONFIG.card.padding`, then the
1134
+ * card's own padding. */
1007
1135
  readonly padding: _angular_core.InputSignal<CardPadding | null>;
1008
1136
  /** Fires the click event when `elevation` is `interactive`. */
1009
1137
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
1138
+ protected readonly elevationResolved: _angular_core.Signal<CardElevation>;
1139
+ protected readonly paddingResolved: _angular_core.Signal<CardPadding | null>;
1010
1140
  protected readonly interactive: _angular_core.Signal<boolean>;
1011
1141
  protected readonly classes: _angular_core.Signal<string>;
1012
1142
  protected onClick(event: MouseEvent): void;
1143
+ protected onActivationKey(event: Event): void;
1013
1144
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<CardComponent, never>;
1014
1145
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<CardComponent, "ds-card", never, { "elevation": { "alias": "elevation"; "required": false; "isSignal": true; }; "padding": { "alias": "padding"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["*"], true, never>;
1015
1146
  }
@@ -1106,6 +1237,12 @@ declare class TabsComponent {
1106
1237
  * before the input existed.
1107
1238
  */
1108
1239
  readonly urlParam: _angular_core.InputSignal<string>;
1240
+ /** Reopen the tab this screen was last left on, per path, from `sessionStorage`.
1241
+ * Off by default, and needs `urlParam` for the names — a remembered INDEX would
1242
+ * repoint the moment a tab is inserted. A link always wins: the parameter is read
1243
+ * first, memory only fills the gap the first tab leaves in the URL. Session, not
1244
+ * local, so tomorrow is a fresh visit. */
1245
+ readonly rememberLastTab: _angular_core.InputSignalWithTransform<boolean, unknown>;
1109
1246
  /** Emitted when a close button is clicked. Carries the tab's value input, or
1110
1247
  its label when value is not set. The host is responsible for removing the
1111
1248
  tab from its list. */
@@ -1121,7 +1258,21 @@ declare class TabsComponent {
1121
1258
  /** Resolves the router pair on first use. Null outside a routed context, which
1122
1259
  * makes `urlParam` inert there rather than an error. */
1123
1260
  private resolveRouting;
1261
+ /** The tab's name AS IT APPEARS IN THE URL, and deliberately NOT what
1262
+ * `tabClosed` emits — that stays the label, because a host matches it against
1263
+ * its own list. A slug is still derived from display copy, so renaming a tab
1264
+ * still breaks saved links; `value` is the only fix for that. */
1124
1265
  private tabName;
1266
+ /** Storage key for `rememberLastTab`: the path plus the parameter name. Per
1267
+ * path because that is the screen a reader returns to, and the parameter is
1268
+ * what keeps two strips on one path apart — which the dev warning above
1269
+ * already insists is unique. */
1270
+ private memoryKey;
1271
+ /** Every access is wrapped: Safari in private mode throws on write, and a
1272
+ * quota error must not take a tab strip down with it. Same guard as
1273
+ * `ds-table`'s persisted layout. */
1274
+ private rememberedName;
1275
+ private remember;
1125
1276
  private writeUrl;
1126
1277
  /** Tracks which tab indices have ever been activated (for lazy rendering). */
1127
1278
  private readonly activatedIndices;
@@ -1138,7 +1289,7 @@ declare class TabsComponent {
1138
1289
  Arrow axis follows orientation: Left/Right for horizontal, Up/Down for vertical. */
1139
1290
  protected onKeydown(event: KeyboardEvent, index: number): void;
1140
1291
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabsComponent, never>;
1141
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabsComponent, "ds-tabs", never, { "selectedIndex": { "alias": "selectedIndex"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "scrollable": { "alias": "scrollable"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "urlParam": { "alias": "urlParam"; "required": false; "isSignal": true; }; }, { "selectedIndex": "selectedIndexChange"; "tabClosed": "tabClosed"; }, ["tabs"], never, true, never>;
1292
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabsComponent, "ds-tabs", never, { "selectedIndex": { "alias": "selectedIndex"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "scrollable": { "alias": "scrollable"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "urlParam": { "alias": "urlParam"; "required": false; "isSignal": true; }; "rememberLastTab": { "alias": "rememberLastTab"; "required": false; "isSignal": true; }; }, { "selectedIndex": "selectedIndexChange"; "tabClosed": "tabClosed"; }, ["tabs"], never, true, never>;
1142
1293
  }
1143
1294
 
1144
1295
  type FieldMessageState = 'default' | 'error' | 'warning' | 'success';
@@ -1161,12 +1312,59 @@ interface DsFieldError {
1161
1312
  }
1162
1313
  /** What a field's `errors` input accepts before normalization. */
1163
1314
  type DsFieldErrorsInput = string | DsFieldError | readonly DsFieldError[] | null | undefined;
1315
+ /**
1316
+ * The one reserved `DsFieldError.kind`. An error carrying it is advisory: it shows
1317
+ * in the warning state and does NOT make the control invalid, which is how a form
1318
+ * model can raise a non-blocking remark — Angular's own `AbstractControl` has no
1319
+ * channel for one, only `errors` and the validity derived from it.
1320
+ */
1321
+ declare const DS_FIELD_WARNING_KIND = "warning";
1164
1322
  /** The single line a field shows below itself, already resolved. */
1165
1323
  interface DsFieldMessage {
1166
1324
  readonly text: string;
1167
1325
  readonly state: FieldMessageState;
1168
1326
  }
1169
1327
 
1328
+ /**
1329
+ * The inputs every DS form field has, declared once.
1330
+ *
1331
+ * Only the UNIVERSAL ones belong here. `success`, `label`, `required` and
1332
+ * `optional` stay on the components: they exist on some fields and not others, so
1333
+ * lifting them would hand a checkbox a `success` or a slider a `label` it never
1334
+ * had — a silent public-API addition.
1335
+ *
1336
+ * `@Directive()` is required, not decoration: Angular refuses to compile a base
1337
+ * class that declares inputs without it.
1338
+ */
1339
+ declare abstract class DsFieldBase {
1340
+ /** Helper text shown below the field. */
1341
+ readonly hint: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
1342
+ /** Error text. Shown immediately — binding it says the consumer has already
1343
+ * decided this field is in error. Takes precedence over `errors`. */
1344
+ readonly error: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
1345
+ /** Advisory text, shown when there is no error. */
1346
+ readonly warning: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
1347
+ /** Validation errors, shown once the user has interacted. Bound automatically
1348
+ * by signal forms; reactive and template-driven forms are read through
1349
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
1350
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
1351
+ /** Paints the error state and sets `aria-invalid`, WITHOUT a message of its own
1352
+ * — for when the text lives elsewhere, such as a form-level error summary or
1353
+ * one message covering a whole field group. Use `error` to show text. */
1354
+ readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1355
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
1356
+ * `errors`, so a `required` error does not greet an untouched form. */
1357
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1358
+ /** Reserve the message-row height even when empty, so the field doesn't shift
1359
+ * the layout below it when a hint/error appears. Falls back to
1360
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
1361
+ * for a form that shows validation messages. */
1362
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
1363
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
1364
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsFieldBase, never>;
1365
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsFieldBase, never, never, { "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
1366
+ }
1367
+
1170
1368
  /**
1171
1369
  * Shared `ControlValueAccessor` for DS form controls whose value is a signal
1172
1370
  * `model()`. Bridges that model with Angular forms (reactive `formControl` /
@@ -1177,7 +1375,7 @@ interface DsFieldMessage {
1177
1375
  * effective disabled state so `FormControl.disable()` actually reaches the
1178
1376
  * control; it should also call `markTouched()` from a blur handler.
1179
1377
  */
1180
- declare abstract class DsControlValueAccessor<T> implements ControlValueAccessor {
1378
+ declare abstract class DsControlValueAccessor<T> extends DsFieldBase implements ControlValueAccessor {
1181
1379
  /** The component's two-way value model. */
1182
1380
  abstract readonly value: ModelSignal<T>;
1183
1381
  /**
@@ -1218,7 +1416,7 @@ declare abstract class DsControlValueAccessor<T> implements ControlValueAccessor
1218
1416
  * signal API. Subclasses must OR `formDisabled()` into their effective disabled
1219
1417
  * state and call `markTouched()` from a blur handler.
1220
1418
  */
1221
- declare abstract class DsBooleanControlValueAccessor implements ControlValueAccessor {
1419
+ declare abstract class DsBooleanControlValueAccessor extends DsFieldBase implements ControlValueAccessor {
1222
1420
  /** The component's two-way checked model. */
1223
1421
  abstract readonly checked: ModelSignal<boolean>;
1224
1422
  /** Hides the control — see the note on `DsControlValueAccessor.hidden`. */
@@ -1260,30 +1458,12 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1260
1458
  readonly value: _angular_core.ModelSignal<string>;
1261
1459
  /** Native input type — also affects the default clear button and password toggle. */
1262
1460
  readonly type: _angular_core.InputSignal<InputType>;
1263
- /** Field height — sm/md/lg. */
1264
- readonly size: _angular_core.InputSignal<DsSize>;
1265
- /** Label shown above the field, or inside it when `floating`. */
1461
+ /** Field height — sm/md/lg.
1462
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1463
+ readonly size: _angular_core.InputSignal<DsSize | null>;
1464
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1465
+ /** Label shown above the field. */
1266
1466
  readonly label: _angular_core.InputSignal<string>;
1267
- /** Helper text shown below the field. */
1268
- readonly hint: _angular_core.InputSignal<string>;
1269
- /** Error text. Shown immediately — binding it says the consumer has already
1270
- * decided this field is in error. Takes precedence over `errors`. */
1271
- readonly error: _angular_core.InputSignal<string>;
1272
- /** Advisory text, shown when there is no error. */
1273
- readonly warning: _angular_core.InputSignal<string>;
1274
- /** Validation errors, shown once the user has interacted. Bound automatically
1275
- * by signal forms; reactive and template-driven forms are read through
1276
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
1277
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
1278
- /** Whether the user has interacted with the field. Bound by signal forms; gates
1279
- * `errors`, so a `required` error does not greet an untouched form. */
1280
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1281
- /** Reserve the message-row height even when empty, so the field doesn't shift
1282
- * the layout below it when a hint/error appears. Falls back to
1283
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
1284
- * for a form that shows validation messages. */
1285
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
1286
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
1287
1467
  /** Placeholder shown when empty. */
1288
1468
  readonly placeholder: _angular_core.InputSignal<string>;
1289
1469
  /** Disables the field and blocks all interaction. */
@@ -1296,16 +1476,12 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1296
1476
  */
1297
1477
  readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
1298
1478
  protected readonly isReadOnly: _angular_core.Signal<boolean>;
1299
- /** Applies error styling and marks the field `aria-invalid`. */
1300
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1301
- /** Applies success styling to the field. */
1302
- readonly success: _angular_core.InputSignalWithTransform<boolean, unknown>;
1479
+ /** Confirmation text, shown when there is no error or warning — and it paints
1480
+ * the field's success border. A string like `warning`: the text IS the state. */
1481
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
1303
1482
  /** Shows a trailing spinner — e.g. async validation in flight. The input
1304
1483
  * stays editable; pair with a `hint` like "Checking availability…". */
1305
1484
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
1306
- /** Floating-label variant — the label sits inside a taller control instead
1307
- * of stacked above it. */
1308
- readonly floating: _angular_core.InputSignalWithTransform<boolean, unknown>;
1309
1485
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
1310
1486
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1311
1487
  /** Shows an "(optional)" marker next to the label (ignored when `required`). */
@@ -1340,7 +1516,7 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1340
1516
  /** Mobile keyboard hints — forwarded to the native input as attributes. */
1341
1517
  readonly enterKeyHint: _angular_core.InputSignal<"search" | "next" | "enter" | "done" | "go" | "previous" | "send" | null>;
1342
1518
  /** Native `inputmode` attribute — hints the on-screen keyboard layout. */
1343
- readonly inputMode: _angular_core.InputSignal<"search" | "text" | "none" | "email" | "tel" | "url" | "decimal" | "numeric" | null>;
1519
+ readonly inputMode: _angular_core.InputSignal<"search" | "none" | "text" | "email" | "tel" | "url" | "decimal" | "numeric" | null>;
1344
1520
  /** Emits when the native input loses focus. */
1345
1521
  readonly blurred: _angular_core.OutputEmitterRef<void>;
1346
1522
  /**
@@ -1364,6 +1540,7 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1364
1540
  protected readonly describedBy: _angular_core.Signal<string | null>;
1365
1541
  private readonly fieldMessage;
1366
1542
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
1543
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
1367
1544
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
1368
1545
  /** Only name via aria-label when there's no visible `<label for>`. */
1369
1546
  protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
@@ -1380,7 +1557,7 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1380
1557
  focus(options?: FocusOptions): void;
1381
1558
  protected clear(): void;
1382
1559
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<InputComponent, never>;
1383
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<InputComponent, "ds-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "floating": { "alias": "floating"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "required": false; "isSignal": true; }; "enterKeyHint": { "alias": "enterKeyHint"; "required": false; "isSignal": true; }; "inputMode": { "alias": "inputMode"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "passwordToggle": { "alias": "passwordToggle"; "required": false; "isSignal": true; }; "passwordVisible": { "alias": "passwordVisible"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "blurred": "blurred"; "passwordVisible": "passwordVisibleChange"; }, never, ["[dsInputPrefix]", "[dsInputSuffix]"], true, never>;
1560
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<InputComponent, "ds-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "required": false; "isSignal": true; }; "enterKeyHint": { "alias": "enterKeyHint"; "required": false; "isSignal": true; }; "inputMode": { "alias": "inputMode"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "passwordToggle": { "alias": "passwordToggle"; "required": false; "isSignal": true; }; "passwordVisible": { "alias": "passwordVisible"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "blurred": "blurred"; "passwordVisible": "passwordVisibleChange"; }, never, ["[dsInputPrefix]", "[dsInputSuffix]"], true, never>;
1384
1561
  }
1385
1562
 
1386
1563
  declare class NumberStepperComponent {
@@ -1392,8 +1569,10 @@ declare class NumberStepperComponent {
1392
1569
  readonly max: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
1393
1570
  /** Amount added or subtracted per increment/decrement. */
1394
1571
  readonly step: _angular_core.InputSignal<number>;
1395
- /** Control height — sm/md/lg. */
1396
- readonly size: _angular_core.InputSignal<DsSize>;
1572
+ /** Control height — sm/md/lg.
1573
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1574
+ readonly size: _angular_core.InputSignal<DsSize | null>;
1575
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1397
1576
  /** Disables the stepper and blocks all interaction. */
1398
1577
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1399
1578
  /** Accessible name for the number input (the stepper has no visible label). */
@@ -1414,30 +1593,12 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
1414
1593
  private readonly control;
1415
1594
  /** Text value, two-way bound. */
1416
1595
  readonly value: _angular_core.ModelSignal<string>;
1417
- /** Field height — sm/md/lg. */
1418
- readonly size: _angular_core.InputSignal<DsSize>;
1596
+ /** Field height — sm/md/lg.
1597
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1598
+ readonly size: _angular_core.InputSignal<DsSize | null>;
1599
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1419
1600
  /** Label shown above the field. */
1420
1601
  readonly label: _angular_core.InputSignal<string>;
1421
- /** Helper text shown below the field. */
1422
- readonly hint: _angular_core.InputSignal<string>;
1423
- /** Error text. Shown immediately — binding it says the consumer has already
1424
- * decided this field is in error. Takes precedence over `errors`. */
1425
- readonly error: _angular_core.InputSignal<string>;
1426
- /** Advisory text, shown when there is no error. */
1427
- readonly warning: _angular_core.InputSignal<string>;
1428
- /** Validation errors, shown once the user has interacted. Bound automatically
1429
- * by signal forms; reactive and template-driven forms are read through
1430
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
1431
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
1432
- /** Whether the user has interacted with the field. Bound by signal forms; gates
1433
- * `errors`, so a `required` error does not greet an untouched form. */
1434
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1435
- /** Reserve the message-row height even when empty, so the field doesn't shift
1436
- * the layout below it when a hint/error appears. Falls back to
1437
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
1438
- * for a form that shows validation messages. */
1439
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
1440
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
1441
1602
  /** Placeholder shown when empty. */
1442
1603
  readonly placeholder: _angular_core.InputSignal<string>;
1443
1604
  /** Disables the field and blocks all interaction. */
@@ -1450,8 +1611,9 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
1450
1611
  */
1451
1612
  readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
1452
1613
  protected readonly isReadOnly: _angular_core.Signal<boolean>;
1453
- /** Applies error styling and marks the field `aria-invalid`. */
1454
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1614
+ /** Confirmation text, shown when there is no error or warning — and it paints
1615
+ * the field's success border. A string like `warning`: the text IS the state. */
1616
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
1455
1617
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
1456
1618
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1457
1619
  /** Shows an "(optional)" marker next to the label (ignored when `required`). */
@@ -1484,6 +1646,7 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
1484
1646
  protected readonly hintId: _angular_core.Signal<string | null>;
1485
1647
  private readonly fieldMessage;
1486
1648
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
1649
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
1487
1650
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
1488
1651
  protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
1489
1652
  /** Effective disabled — own `disabled` input OR the reactive-forms state. */
@@ -1498,7 +1661,7 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
1498
1661
  * deliberately, e.g. focusing the first invalid field on a failed submit. */
1499
1662
  focus(options?: FocusOptions): void;
1500
1663
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextareaComponent, never>;
1501
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextareaComponent, "ds-textarea", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "autosize": { "alias": "autosize"; "required": false; "isSignal": true; }; "minRows": { "alias": "minRows"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "resize": { "alias": "resize"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
1664
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextareaComponent, "ds-textarea", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "autosize": { "alias": "autosize"; "required": false; "isSignal": true; }; "minRows": { "alias": "minRows"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "resize": { "alias": "resize"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
1502
1665
  }
1503
1666
 
1504
1667
  declare class SearchComponent {
@@ -1518,19 +1681,43 @@ declare class SearchComponent {
1518
1681
  /** Accessible name for the input (placeholder is not a reliable label). */
1519
1682
  readonly ariaLabel: _angular_core.InputSignal<string>;
1520
1683
  /** Control height. `md` (default) keeps the 36px search-row height; `sm` (32px)
1521
- * aligns search with dense toolbars beside `sm` inputs/buttons; `lg` is touch. */
1522
- readonly size: _angular_core.InputSignal<DsSize>;
1684
+ * aligns search with dense toolbars beside `sm` inputs/buttons; `lg` is touch.
1685
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1686
+ readonly size: _angular_core.InputSignal<DsSize | null>;
1687
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1523
1688
  /** Fires with the current value on Enter. */
1524
1689
  readonly submitted: _angular_core.OutputEmitterRef<string>;
1690
+ /** Milliseconds to hold each keystroke back before `value` updates — 0 (default)
1691
+ * writes on every keystroke, exactly as this control always has.
1692
+ *
1693
+ * Clearing the field BYPASSES the delay, which is the part a plain
1694
+ * `debounceTime` gets wrong: emptying a search is a deliberate act, and making
1695
+ * the user wait 200ms to see the full list back reads as a hang. Enter flushes
1696
+ * for the same reason. What the input SHOWS is never delayed. */
1697
+ readonly debounce: _angular_core.InputSignalWithTransform<number, unknown>;
1525
1698
  private readonly inputEl;
1699
+ /** What the input shows. Separate from `value` only so typing never waits on
1700
+ * the timer; with `debounce` at 0 the two move together. */
1701
+ protected readonly text: _angular_core.WritableSignal<string>;
1702
+ private pending;
1703
+ /** The last text this component pushed into `value`, so an update arriving from
1704
+ * the HOST can be told apart from its own echo — a host resetting the field
1705
+ * mid-typing has to win, and cancel the keystroke still in flight. */
1706
+ private pushed;
1707
+ constructor();
1526
1708
  /** Move keyboard focus to the search input. Public so a host can hand focus
1527
1709
  * over deliberately — e.g. a Clear button that disables itself on activation
1528
1710
  * would otherwise blur into `<body>` and restart Tab order at the top. */
1529
1711
  focus(options?: FocusOptions): void;
1712
+ protected onText(next: string): void;
1530
1713
  protected onSubmit(): void;
1531
1714
  protected clear(): void;
1715
+ /** So Enter searches what the reader can see, not what the timer last let past. */
1716
+ private flush;
1717
+ private push;
1718
+ private cancel;
1532
1719
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SearchComponent, never>;
1533
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SearchComponent, "ds-search", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "shortcut": { "alias": "shortcut"; "required": false; "isSignal": true; }; "showIcon": { "alias": "showIcon"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "submitted": "submitted"; }, never, never, true, never>;
1720
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SearchComponent, "ds-search", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "shortcut": { "alias": "shortcut"; "required": false; "isSignal": true; }; "showIcon": { "alias": "showIcon"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "debounce": { "alias": "debounce"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "submitted": "submitted"; }, never, never, true, never>;
1534
1721
  }
1535
1722
 
1536
1723
  /**
@@ -1549,11 +1736,7 @@ declare class DsStaticPreview {
1549
1736
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsStaticPreview, never, never, { "staticPreview": { "alias": "staticPreview"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
1550
1737
  }
1551
1738
 
1552
- interface SelectOption {
1553
- label: string;
1554
- value: string;
1555
- disabled?: boolean;
1556
- icon?: IconName;
1739
+ interface SelectOption extends DsOption<string> {
1557
1740
  }
1558
1741
  interface SelectOptionGroup {
1559
1742
  label: string;
@@ -1577,8 +1760,10 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1577
1760
  readonly options: _angular_core.InputSignal<SelectItem[]>;
1578
1761
  /** Shown in the trigger when nothing is selected. */
1579
1762
  readonly placeholder: _angular_core.InputSignal<string>;
1580
- /** Trigger height — sm/md/lg. */
1581
- readonly size: _angular_core.InputSignal<DsSize>;
1763
+ /** Trigger height — sm/md/lg.
1764
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1765
+ readonly size: _angular_core.InputSignal<DsSize | null>;
1766
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1582
1767
  /** Label shown above the trigger. */
1583
1768
  readonly label: _angular_core.InputSignal<string>;
1584
1769
  /** Disables the trigger and blocks all interaction. */
@@ -1591,28 +1776,9 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1591
1776
  */
1592
1777
  readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
1593
1778
  protected readonly isReadOnly: _angular_core.Signal<boolean>;
1594
- /** Applies error styling and marks the trigger `aria-invalid`. */
1595
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1596
- /** Helper text shown below the trigger. */
1597
- readonly hint: _angular_core.InputSignal<string>;
1598
- /** Error text. Shown immediately — binding it says the consumer has already
1599
- * decided this field is in error. Takes precedence over `errors`. */
1600
- readonly error: _angular_core.InputSignal<string>;
1601
- /** Advisory text, shown when there is no error. */
1602
- readonly warning: _angular_core.InputSignal<string>;
1603
- /** Validation errors, shown once the user has interacted. Bound automatically
1604
- * by signal forms; reactive and template-driven forms are read through
1605
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
1606
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
1607
- /** Whether the user has interacted with the field. Bound by signal forms; gates
1608
- * `errors`, so a `required` error does not greet an untouched form. */
1609
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1610
- /** Reserve the message-row height even when empty, so the field doesn't shift
1611
- * the layout below it when a hint/error appears. Falls back to
1612
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
1613
- * for a form that shows validation messages. */
1614
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
1615
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
1779
+ /** Confirmation text, shown when there is no error or warning — and it paints
1780
+ * the field's success border. A string like `warning`: the text IS the state. */
1781
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
1616
1782
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
1617
1783
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1618
1784
  /** Shows an "(optional)" marker next to the label (ignored when `required`). */
@@ -1629,6 +1795,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1629
1795
  protected readonly hintId: _angular_core.Signal<string | null>;
1630
1796
  private readonly fieldMessage;
1631
1797
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
1798
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
1632
1799
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
1633
1800
  protected optionId(flatIndex: number): string;
1634
1801
  /** Active option for `aria-activedescendant` (combobox keeps DOM focus). */
@@ -1667,7 +1834,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1667
1834
  private firstEnabledIndex;
1668
1835
  private lastEnabledIndex;
1669
1836
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
1670
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
1837
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
1671
1838
  }
1672
1839
 
1673
1840
  /**
@@ -1786,8 +1953,15 @@ interface TableColumn<T = unknown> {
1786
1953
  * in the title tooltip, and clicking a clipped cell opens it in a popover.
1787
1954
  * Text cells only — template cells own their overflow. */
1788
1955
  truncate?: boolean;
1789
- /** Column width in px — also the clip width for `truncate`. */
1790
- width?: number;
1956
+ /** Column width in px — also the clip width for `truncate`.
1957
+ *
1958
+ * `'content'` instead sizes the column to its widest cell and stops it wrapping,
1959
+ * leaving the remaining width to the columns that should absorb it. An
1960
+ * auto-layout table spreads slack evenly, so a short column (a status, a count,
1961
+ * an actions cell) ends up as wide as its own header while the name column that
1962
+ * should take the slack does not. A pixel width cannot express that — pin one
1963
+ * column and the rest still spread. Dragging the column's edge overrides it. */
1964
+ width?: number | 'content';
1791
1965
  align?: 'left' | 'right' | 'center';
1792
1966
  cell?: (row: T) => string;
1793
1967
  /** Sort this column by a DOMAIN value instead of the rendered text. Without
@@ -1849,14 +2023,23 @@ declare class TableComponent<T extends object> {
1849
2023
  /** Opt-in outer border + radius. Off by default so tables flush inside a
1850
2024
  * `<ds-card padding="none">` (workspaces, programs-list) don't double-border.
1851
2025
  * When `true`, the scroll-wrap gets a `var(--border-default)` outline and
1852
- * `var(--radius-md)` radius — useful when the table stands alone in a padded card. */
1853
- readonly bordered: _angular_core.InputSignalWithTransform<boolean, unknown>;
1854
- /** false — no loading state.
2026
+ * `var(--radius-md)` radius — useful when the table stands alone in a padded card.
2027
+ * Unset falls back to `DS_CONFIG.table.bordered`, then `false`. */
2028
+ readonly bordered: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
2029
+ /** false — no loading state.
2030
+ * `true` — the table picks: skeleton rows while it has nothing to show, overlay
2031
+ * once rows are on screen. Prefer it; the right choice is a function of the row
2032
+ * count, which only the table holds.
1855
2033
  * 'skeleton' — first-load placeholder; rows are replaced with shimmer
1856
2034
  * rows that read the global --skeleton-shimmer-x driver.
1857
2035
  * 'overlay' — re-fetch indicator; existing rows stay visible behind
1858
- * a translucent overlay with a centred spinner. */
1859
- readonly loading: _angular_core.InputSignal<false | "skeleton" | "overlay">;
2036
+ * a translucent overlay with a centred spinner. Pin either one only to
2037
+ * override the rule deliberately. */
2038
+ readonly loading: _angular_core.InputSignal<boolean | "skeleton" | "overlay">;
2039
+ /** The mode actually rendered. Skeletons replace what the reader is looking at and
2040
+ * an overlay on an empty card says nothing, so `true` resolves per state rather
2041
+ * than picking a favourite. */
2042
+ protected readonly loadingMode: _angular_core.Signal<false | "skeleton" | "overlay">;
1860
2043
  /** Keeps the header row pinned while the body scrolls. */
1861
2044
  readonly stickyHeader: _angular_core.InputSignalWithTransform<boolean, unknown>;
1862
2045
  /** Caps the scroll body height (any CSS length, e.g. `'320px'`) and scrolls it
@@ -1872,10 +2055,29 @@ declare class TableComponent<T extends object> {
1872
2055
  readonly animateHeight: _angular_core.InputSignalWithTransform<boolean, unknown>;
1873
2056
  /** Two-way set of currently selected row ids. */
1874
2057
  readonly selectedIds: _angular_core.ModelSignal<Set<string>>;
1875
- /** Column key currently sorted by; `null` when unsorted. */
1876
- readonly sortKey: _angular_core.ModelSignal<string | null>;
2058
+ /** Column key currently sorted by; `null` when unsorted. Two-way bindable
2059
+ * (`[(sortKey)]`) or one-way from your own state with `(sortChange)`. */
2060
+ readonly sortKey: _angular_core.InputSignal<string | null>;
2061
+ /** Emitted for `[(sortKey)]`. `sortChange` carries the same click with both
2062
+ * halves at once, which is usually the one to listen to. */
2063
+ readonly sortKeyChange: _angular_core.OutputEmitterRef<string | null>;
1877
2064
  /** Sort direction for `sortKey`. */
1878
- readonly sortDir: _angular_core.ModelSignal<SortDir>;
2065
+ readonly sortDir: _angular_core.InputSignal<SortDir>;
2066
+ /** Emitted for `[(sortDir)]`. */
2067
+ readonly sortDirChange: _angular_core.OutputEmitterRef<SortDir>;
2068
+ /**
2069
+ * What the header marks, and what a client sort reads.
2070
+ *
2071
+ * `linkedSignal` over BOTH inputs, not a `model`: Angular writes an input only
2072
+ * when the bound expression changed, diffing against the value IT last wrote, and
2073
+ * an internal `.set()` never updates that slot. Seeding from both means a host
2074
+ * answering with its own default re-seeds the pair even when one half of that
2075
+ * default equals what it last bound. A host that binds neither never re-seeds, so
2076
+ * the optimistic state survives.
2077
+ */
2078
+ private readonly sortState;
2079
+ protected readonly activeSortKey: _angular_core.Signal<string | null>;
2080
+ protected readonly activeSortDir: _angular_core.Signal<SortDir>;
1879
2081
  /** Sort states a column cycles through on click. Default includes null
1880
2082
  * (unsorted); pass ['asc','desc'] to forbid the unsorted state (e.g.
1881
2083
  * server-paged lists). */
@@ -1934,8 +2136,9 @@ declare class TableComponent<T extends object> {
1934
2136
  /** Screen id the persisted layout is stored under. Pick something stable per
1935
2137
  * table, not per route instance. */
1936
2138
  readonly storageKey: _angular_core.InputSignal<string>;
1937
- /** Render an export button above the table. Off by default; `exportCsv()`
1938
- * stays available for a consumer's own button. */
2139
+ /** Render an export button in the table's toolbar row. Off by default. Leave it
2140
+ * off and drive `runExport()` from your own button — in a page header, a filter
2141
+ * bar, the `[toolbar]` slot — reading `exporting()` for its loading state. */
1939
2142
  readonly exportButton: _angular_core.InputSignalWithTransform<boolean, unknown>;
1940
2143
  /** Filename the export button downloads as. */
1941
2144
  readonly exportFilename: _angular_core.InputSignal<string>;
@@ -1952,15 +2155,19 @@ declare class TableComponent<T extends object> {
1952
2155
  /** Fires when `exportFetcher` rejects. Without it a failed export is silent —
1953
2156
  * the button simply re-enables and no file arrives. */
1954
2157
  readonly exportFailed: _angular_core.OutputEmitterRef<unknown>;
1955
- /** True while `exportFetcher` is in flight, so the button can disable itself. */
1956
- protected readonly exporting: _angular_core.WritableSignal<boolean>;
2158
+ private readonly exportingState;
2159
+ /** True while `exportFetcher` is in flight. Public so a button OUTSIDE the table
2160
+ * can show the same in-flight state as the built-in one. */
2161
+ readonly exporting: _angular_core.Signal<boolean>;
2162
+ private readonly exportStatusState;
1957
2163
  /** Announced in the table's live region while an export is running or after it
1958
2164
  * failed, so the button's own disabled state is not the only signal. */
1959
- protected readonly exportStatus: _angular_core.WritableSignal<string>;
2165
+ readonly exportStatus: _angular_core.Signal<string>;
1960
2166
  /** Keeps the horizontal scrollbar reachable on tall tables: the scroll
1961
2167
  * container's native bar is hidden and a proxy stuck to the bottom of the
1962
- * nearest scroll ancestor mirrors it both ways. Off by default. */
1963
- readonly stickyScrollbar: _angular_core.InputSignalWithTransform<boolean, unknown>;
2168
+ * nearest scroll ancestor mirrors it both ways. Off by default. Unset falls
2169
+ * back to `DS_CONFIG.table.stickyScrollbar`, then `false`. */
2170
+ readonly stickyScrollbar: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
1964
2171
  /** Rows per page. `null` (default) disables pagination — all rows render. */
1965
2172
  readonly pageSize: _angular_core.ModelSignal<number | null>;
1966
2173
  /** Current 1-based page. Only meaningful when `pageSize()` is set. */
@@ -1999,6 +2206,8 @@ declare class TableComponent<T extends object> {
1999
2206
  readonly columnFilterOptions: _angular_core.InputSignal<ReadonlyMap<string, readonly string[]>>;
2000
2207
  protected readonly filterModeResolved: _angular_core.Signal<TableFilterMode>;
2001
2208
  protected readonly sortModeResolved: _angular_core.Signal<TableSortMode>;
2209
+ protected readonly borderedResolved: _angular_core.Signal<boolean>;
2210
+ protected readonly stickyScrollbarResolved: _angular_core.Signal<boolean>;
2002
2211
  /** Pin the first data column (and the select column) on horizontal scroll. */
2003
2212
  readonly stickyFirstColumn: _angular_core.InputSignalWithTransform<boolean, unknown>;
2004
2213
  /**
@@ -2078,6 +2287,11 @@ declare class TableComponent<T extends object> {
2078
2287
  protected readonly tableClasses: _angular_core.Signal<string>;
2079
2288
  protected readonly isSkeletonLoading: _angular_core.Signal<boolean>;
2080
2289
  protected readonly isOverlayLoading: _angular_core.Signal<boolean>;
2290
+ /** The empty row is a CLAIM about the data — "there are none" — so it must not
2291
+ * appear while the table is still asking. Only `skeleton` used to suppress it,
2292
+ * and `overlay` is the mode a list uses on every read after the first, so a
2293
+ * zero-row reload painted "No rows yet" under the spinner. */
2294
+ protected readonly showsEmptyRow: _angular_core.Signal<boolean>;
2081
2295
  protected readonly effectiveHiddenKeys: _angular_core.Signal<ReadonlySet<string>>;
2082
2296
  /** Columns in the user-controlled order — `columnOrder` first (dropping
2083
2297
  * unknown keys), then any declared column the order omitted. */
@@ -2142,8 +2356,16 @@ declare class TableComponent<T extends object> {
2142
2356
  private static readonly RESIZE_PAGE;
2143
2357
  private static readonly MIN_COLUMN_WIDTH;
2144
2358
  private resizeState;
2145
- /** Resolved pixel width for a column: a drag override wins, else `column.width`. */
2359
+ /** Resolved pixel width for a column: a drag override wins, else `column.width`
2360
+ * when that is a number. `'content'` is not a pixel value — it is carried by a
2361
+ * class instead, see `fitsContent`. */
2146
2362
  protected columnWidth(col: TableColumn<T>): number | null;
2363
+ /** Shrink-to-content mode, unless the user has dragged this column — a drag is a
2364
+ * deliberate pixel width and must win over the declared intent. */
2365
+ protected fitsContent(col: TableColumn<T>): boolean;
2366
+ /** Clip width for `truncate`. `'content'` has no clip width — the column is as
2367
+ * wide as its widest cell, so there is nothing to ellipsis against. */
2368
+ protected clipWidth(col: TableColumn<T>): number | null;
2147
2369
  protected onResizeStart(col: TableColumn<T>, event: PointerEvent): void;
2148
2370
  /**
2149
2371
  * Freeze the columns at what they currently measure, once, before the first
@@ -2296,17 +2518,21 @@ declare class TableComponent<T extends object> {
2296
2518
  protected headerClasses(col: TableColumn<T>): string;
2297
2519
  protected sortIcon(col: TableColumn<T>): 'sortAsc' | 'sortDesc' | 'sort';
2298
2520
  protected cellValue(row: T, col: TableColumn<T>): string;
2299
- /** Exports the visible columns of the filtered + sorted rows (all rows, not
2300
- * just the current page) as a CSV download. Call from a consumer button:
2301
- * `<ds-button (pressed)="table.exportCsv()">`. */
2521
+ /** Serialises the visible columns of the rows the TABLE HOLDS as a CSV download.
2522
+ * On a server-paged table that is one page — prefer `runExport()`, which goes
2523
+ * through `exportFetcher` and exports the whole set. Pass `rows` to serialise a
2524
+ * set you fetched yourself. */
2302
2525
  exportCsv(filename?: string, rows?: readonly T[]): void;
2303
2526
  private layoutKey;
2304
2527
  private layoutRestored;
2305
2528
  private restoreLayout;
2306
2529
  private saveLayout;
2307
- /** Export button handler: awaits `exportFetcher` when one is given, so a
2308
- * server-paged table exports the whole set rather than the page it holds. */
2309
- protected runExport(): Promise<void>;
2530
+ /** Runs the export the built-in button runs: awaits `exportFetcher` when one is
2531
+ * given — so a server-paged table exports the whole set rather than the page it
2532
+ * holds — downloads the result, drives `exporting`, writes the live region and
2533
+ * emits `exportFailed`. Public so the button can live anywhere:
2534
+ * `<ds-button [loading]="table.exporting()" (pressed)="table.runExport()">`. */
2535
+ runExport(): Promise<void>;
2310
2536
  /** Hands a ready-made file to the browser. Only a Blob gets its object URL
2311
2537
  * revoked — a URL the caller supplied is theirs to manage. */
2312
2538
  private downloadFile;
@@ -2314,7 +2540,7 @@ declare class TableComponent<T extends object> {
2314
2540
  * across re-renders. Mixes column key + row index into one of five widths. */
2315
2541
  protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
2316
2542
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
2317
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "animateHeight": { "alias": "animateHeight"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDir": { "alias": "sortDir"; "required": false; "isSignal": true; }; "sortingOrder": { "alias": "sortingOrder"; "required": false; "isSignal": true; }; "sortAnnouncement": { "alias": "sortAnnouncement"; "required": false; "isSignal": true; }; "rangeAnnouncement": { "alias": "rangeAnnouncement"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "activeRowId": { "alias": "activeRowId"; "required": false; "isSignal": true; }; "filterQuery": { "alias": "filterQuery"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "hiddenKeys": { "alias": "hiddenKeys"; "required": false; "isSignal": true; }; "resizableColumns": { "alias": "resizableColumns"; "required": false; "isSignal": true; }; "columnWidths": { "alias": "columnWidths"; "required": false; "isSignal": true; }; "reorderableColumns": { "alias": "reorderableColumns"; "required": false; "isSignal": true; }; "columnOrder": { "alias": "columnOrder"; "required": false; "isSignal": true; }; "persistLayout": { "alias": "persistLayout"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "exportButton": { "alias": "exportButton"; "required": false; "isSignal": true; }; "exportFilename": { "alias": "exportFilename"; "required": false; "isSignal": true; }; "exportFetcher": { "alias": "exportFetcher"; "required": false; "isSignal": true; }; "stickyScrollbar": { "alias": "stickyScrollbar"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "sortMode": { "alias": "sortMode"; "required": false; "isSignal": true; }; "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "columnFilterOptions": { "alias": "columnFilterOptions"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualRowSize": { "alias": "virtualRowSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKey": "sortKeyChange"; "sortDir": "sortDirChange"; "columnFilters": "columnFiltersChange"; "hiddenKeys": "hiddenKeysChange"; "columnWidths": "columnWidthsChange"; "columnOrder": "columnOrderChange"; "exportFailed": "exportFailed"; "pageSize": "pageSizeChange"; "page": "pageChange"; "lazyLoad": "lazyLoad"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; }, ["cellTemplateDirectives", "headerFilters"], ["[empty]", "[bulk-actions]"], true, never>;
2543
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "animateHeight": { "alias": "animateHeight"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDir": { "alias": "sortDir"; "required": false; "isSignal": true; }; "sortingOrder": { "alias": "sortingOrder"; "required": false; "isSignal": true; }; "sortAnnouncement": { "alias": "sortAnnouncement"; "required": false; "isSignal": true; }; "rangeAnnouncement": { "alias": "rangeAnnouncement"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "activeRowId": { "alias": "activeRowId"; "required": false; "isSignal": true; }; "filterQuery": { "alias": "filterQuery"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "hiddenKeys": { "alias": "hiddenKeys"; "required": false; "isSignal": true; }; "resizableColumns": { "alias": "resizableColumns"; "required": false; "isSignal": true; }; "columnWidths": { "alias": "columnWidths"; "required": false; "isSignal": true; }; "reorderableColumns": { "alias": "reorderableColumns"; "required": false; "isSignal": true; }; "columnOrder": { "alias": "columnOrder"; "required": false; "isSignal": true; }; "persistLayout": { "alias": "persistLayout"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "exportButton": { "alias": "exportButton"; "required": false; "isSignal": true; }; "exportFilename": { "alias": "exportFilename"; "required": false; "isSignal": true; }; "exportFetcher": { "alias": "exportFetcher"; "required": false; "isSignal": true; }; "stickyScrollbar": { "alias": "stickyScrollbar"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "sortMode": { "alias": "sortMode"; "required": false; "isSignal": true; }; "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "columnFilterOptions": { "alias": "columnFilterOptions"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualRowSize": { "alias": "virtualRowSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKeyChange": "sortKeyChange"; "sortDirChange": "sortDirChange"; "columnFilters": "columnFiltersChange"; "hiddenKeys": "hiddenKeysChange"; "columnWidths": "columnWidthsChange"; "columnOrder": "columnOrderChange"; "exportFailed": "exportFailed"; "pageSize": "pageSizeChange"; "page": "pageChange"; "lazyLoad": "lazyLoad"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; }, ["cellTemplateDirectives", "headerFilters"], ["[toolbar]", "[empty]", "[bulk-actions]"], true, never>;
2318
2544
  }
2319
2545
 
2320
2546
  declare class PaginationComponent {
@@ -2484,8 +2710,10 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
2484
2710
  private readonly panelTokens;
2485
2711
  /** Selection mode — single date or start/end range. */
2486
2712
  readonly mode: _angular_core.InputSignal<DatePickerMode>;
2487
- /** Trigger height — sm/md/lg. */
2488
- readonly size: _angular_core.InputSignal<DsSize>;
2713
+ /** Trigger height — sm/md/lg.
2714
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
2715
+ readonly size: _angular_core.InputSignal<DsSize | null>;
2716
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
2489
2717
  /** Stretch the trigger to fill its container instead of hugging the mask
2490
2718
  * width — opt in when the field shares a grid/flex track with inputs. */
2491
2719
  readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -2495,35 +2723,15 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
2495
2723
  readonly placeholder: _angular_core.InputSignal<string>;
2496
2724
  /** Field label shown above the trigger. */
2497
2725
  readonly label: _angular_core.InputSignal<string>;
2498
- /** Helper text shown below the field. */
2499
- readonly hint: _angular_core.InputSignal<string>;
2500
- /** Error text. Shown immediately — binding it says the consumer has already
2501
- * decided this field is in error. Takes precedence over `errors` and over the
2502
- * picker's own "enter a valid date" message. */
2503
- readonly error: _angular_core.InputSignal<string>;
2504
- /** Advisory text, shown when there is no error. */
2505
- readonly warning: _angular_core.InputSignal<string>;
2506
- /** Validation errors, shown once the user has interacted. Bound automatically
2507
- * by signal forms; reactive and template-driven forms are read through
2508
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
2509
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
2510
- /** Whether the user has interacted with the field. Bound by signal forms; gates
2511
- * `errors`, so a `required` error does not greet an untouched form. */
2512
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
2513
- /** Reserve the message-row height even when empty, so the field doesn't shift
2514
- * the layout below it when a hint/error appears. Falls back to
2515
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
2516
- * for a form that shows validation messages. */
2517
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
2518
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
2519
2726
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
2520
2727
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
2521
2728
  /** Shows an "(optional)" marker beside the label — ignored when `required` is set. */
2522
2729
  readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
2523
2730
  /** Disables the picker and blocks all interaction. */
2524
2731
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2525
- /** Applies error styling and marks the trigger `aria-invalid`. */
2526
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2732
+ /** Confirmation text, shown when there is no error or warning — and it paints
2733
+ * the field's success border. A string like `warning`: the text IS the state. */
2734
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
2527
2735
  /** Accessible name when no visible `label` is provided. */
2528
2736
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2529
2737
  /** Bounds for the year dropdown in the calendar header. */
@@ -2556,6 +2764,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
2556
2764
  private readonly dateInvalid;
2557
2765
  private readonly fieldMessage;
2558
2766
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
2767
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
2559
2768
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
2560
2769
  protected readonly resolvedLocale: _angular_core.Signal<string>;
2561
2770
  protected readonly resolvedFirstDay: _angular_core.Signal<number>;
@@ -2693,7 +2902,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
2693
2902
  protected isPresetDisabled(preset: DatePickerPreset): boolean;
2694
2903
  protected applyPreset(preset: DatePickerPreset): void;
2695
2904
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DatePickerComponent, never>;
2696
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "ds-date-picker", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "minYear": { "alias": "minYear"; "required": false; "isSignal": true; }; "maxYear": { "alias": "maxYear"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "disabledDate": { "alias": "disabledDate"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "defaultDate": { "alias": "defaultDate"; "required": false; "isSignal": true; }; "allowInput": { "alias": "allowInput"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
2905
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "ds-date-picker", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "minYear": { "alias": "minYear"; "required": false; "isSignal": true; }; "maxYear": { "alias": "maxYear"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "disabledDate": { "alias": "disabledDate"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "defaultDate": { "alias": "defaultDate"; "required": false; "isSignal": true; }; "allowInput": { "alias": "allowInput"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
2697
2906
  }
2698
2907
 
2699
2908
  type TimePickerMode = 'single' | 'range';
@@ -2703,7 +2912,8 @@ type TimeValue = string;
2703
2912
  type TimeRangeValue = [string | null, string | null];
2704
2913
  type TimePickerValue = TimeValue | TimeRangeValue | null;
2705
2914
 
2706
- type ColumnId = 'hours' | 'minutes' | 'period';
2915
+ /** Which of the panel's listbox columns a pick came from. */
2916
+ type TimeColumnId = 'hours' | 'minutes' | 'period';
2707
2917
  interface Cell<T> {
2708
2918
  value: T;
2709
2919
  label: string;
@@ -2729,6 +2939,11 @@ declare class TimeColumnsComponent {
2729
2939
  readonly disabledTime: _angular_core.InputSignal<((time: string) => boolean) | null>;
2730
2940
  /** A complete time was picked, as `HH:mm`. Not emitted while only one column has moved. */
2731
2941
  readonly timeChange: _angular_core.OutputEmitterRef<string>;
2942
+ /** Which column the pick came from. `timeChange` alone cannot say: it carries a
2943
+ * whole time, and a host that wants to close once the user has been through
2944
+ * both columns cannot infer the difference between "chose the same hour again"
2945
+ * and "did not touch hours". Emitted immediately after `timeChange`. */
2946
+ readonly partPicked: _angular_core.OutputEmitterRef<TimeColumnId>;
2732
2947
  private readonly hourButtons;
2733
2948
  private readonly minuteButtons;
2734
2949
  private readonly periodButtons;
@@ -2748,7 +2963,7 @@ declare class TimeColumnsComponent {
2748
2963
  protected selectHour(cell: Cell<number>): void;
2749
2964
  protected selectMinute(cell: Cell<number>): void;
2750
2965
  protected selectPeriod(cell: Cell<'AM' | 'PM'>): void;
2751
- protected onKey(event: KeyboardEvent, column: ColumnId, index: number): void;
2966
+ protected onKey(event: KeyboardEvent, column: TimeColumnId, index: number): void;
2752
2967
  /** Called by the parent after the overlay renders. */
2753
2968
  focusSelected(): void;
2754
2969
  scrollSelectedIntoView(): void;
@@ -2767,7 +2982,7 @@ declare class TimeColumnsComponent {
2767
2982
  private focusColumn;
2768
2983
  private scrollColumn;
2769
2984
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TimeColumnsComponent, never>;
2770
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimeColumnsComponent, "ds-time-columns", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "disabledTime": { "alias": "disabledTime"; "required": false; "isSignal": true; }; }, { "timeChange": "timeChange"; }, never, never, true, never>;
2985
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimeColumnsComponent, "ds-time-columns", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "disabledTime": { "alias": "disabledTime"; "required": false; "isSignal": true; }; }, { "timeChange": "timeChange"; "partPicked": "partPicked"; }, never, never, true, never>;
2771
2986
  }
2772
2987
 
2773
2988
  type Segment = 'single' | 'start' | 'end';
@@ -2793,8 +3008,10 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
2793
3008
  readonly maxTime: _angular_core.InputSignal<string | null>;
2794
3009
  /** Predicate marking individual times unselectable. */
2795
3010
  readonly disabledTime: _angular_core.InputSignal<((time: string) => boolean) | null>;
2796
- /** Trigger height — sm/md/lg. */
2797
- readonly size: _angular_core.InputSignal<DsSize>;
3011
+ /** Trigger height — sm/md/lg.
3012
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
3013
+ readonly size: _angular_core.InputSignal<DsSize | null>;
3014
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
2798
3015
  /** Stretch the trigger to fill its container instead of hugging its content —
2799
3016
  * opt in when the field shares a grid/flex track with inputs. */
2800
3017
  readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -2807,28 +3024,9 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
2807
3024
  readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
2808
3025
  /** Disables the picker and blocks all interaction. */
2809
3026
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2810
- /** Applies error styling and marks the trigger `aria-invalid`. */
2811
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2812
- /** Helper text shown below the picker. */
2813
- readonly hint: _angular_core.InputSignal<string>;
2814
- /** Error text. Shown immediately — binding it says the consumer has already
2815
- * decided this field is in error. Takes precedence over `errors`. */
2816
- readonly error: _angular_core.InputSignal<string>;
2817
- /** Advisory text, shown when there is no error. */
2818
- readonly warning: _angular_core.InputSignal<string>;
2819
- /** Validation errors, shown once the user has interacted. Bound automatically
2820
- * by signal forms; reactive and template-driven forms are read through
2821
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
2822
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
2823
- /** Whether the user has interacted with the field. Bound by signal forms; gates
2824
- * `errors`, so a `required` error does not greet an untouched form. */
2825
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
2826
- /** Reserve the message-row height even when empty, so the field doesn't shift
2827
- * the layout below it when a hint/error appears. Falls back to
2828
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
2829
- * for a form that shows validation messages. */
2830
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
2831
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
3027
+ /** Confirmation text, shown when there is no error or warning — and it paints
3028
+ * the field's success border. A string like `warning`: the text IS the state. */
3029
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
2832
3030
  /** Shown in the trigger when no time is set. */
2833
3031
  readonly placeholder: _angular_core.InputSignal<string>;
2834
3032
  /** Shows an inline clear button when a value is set — single mode only. */
@@ -2840,6 +3038,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
2840
3038
  protected readonly uid: string;
2841
3039
  protected readonly labelId: string;
2842
3040
  protected readonly openSegment: _angular_core.WritableSignal<Segment | null>;
3041
+ private readonly pickedParts;
2843
3042
  private overlayRef;
2844
3043
  protected readonly singleTrigger: _angular_core.Signal<ElementRef<HTMLButtonElement> | undefined>;
2845
3044
  protected readonly startTrigger: _angular_core.Signal<ElementRef<HTMLButtonElement> | undefined>;
@@ -2850,6 +3049,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
2850
3049
  protected readonly hintId: _angular_core.Signal<string | null>;
2851
3050
  private readonly fieldMessage;
2852
3051
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
3052
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
2853
3053
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
2854
3054
  protected readonly resolvedFormat: _angular_core.Signal<TimeFormat>;
2855
3055
  protected readonly singleValue: _angular_core.Signal<string | null>;
@@ -2870,13 +3070,14 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
2870
3070
  ngOnDestroy(): void;
2871
3071
  protected onEscape(cause?: DsOverlayCloseCause): void;
2872
3072
  protected onPick(next: string): void;
3073
+ protected onPartPicked(part: TimeColumnId): void;
2873
3074
  protected setNow(): void;
2874
3075
  protected clear(event: Event): void;
2875
3076
  private triggerFor;
2876
3077
  private minutesOf;
2877
3078
  private laterOf;
2878
3079
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TimePickerComponent, never>;
2879
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimePickerComponent, "ds-time-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "disabledTime": { "alias": "disabledTime"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3080
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimePickerComponent, "ds-time-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "disabledTime": { "alias": "disabledTime"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
2880
3081
  }
2881
3082
 
2882
3083
  interface BreadcrumbItem {
@@ -2949,14 +3150,25 @@ declare class SidenavComponent implements SidenavContract {
2949
3150
  /** Collapses the rail to icon-only width; read by nested `ds-sidenav-item`/`ds-sidenav-group`. */
2950
3151
  readonly collapsed: _angular_core.InputSignalWithTransform<boolean, unknown>;
2951
3152
  /** Brand text at the top of the rail (auto letter-mark + name). For a custom
2952
- * logo image/SVG, project it into the `[brand]` slot instead. */
2953
- readonly brand: _angular_core.InputSignal<string>;
3153
+ * logo image/SVG, project it into the `[brand]` slot instead. Unset falls back
3154
+ * to `DS_CONFIG.brand.name`. Each field resolves on its own, so `brand=""` drops
3155
+ * the wordmark while a `logoLetter` in the config still paints its tile. */
3156
+ readonly brand: _angular_core.InputSignal<string | null>;
2954
3157
  /** Letter-mark glyph when it differs from the brand's first letter (e.g. an
2955
- * "A" tile beside the "MyAdmin" wordmark). Empty = first letter of `brand`. */
2956
- readonly logoLetter: _angular_core.InputSignal<string>;
3158
+ * "A" tile beside the "MyAdmin" wordmark). Empty = first letter of `brand`;
3159
+ * unset falls back to `DS_CONFIG.brand.logoLetter`. */
3160
+ readonly logoLetter: _angular_core.InputSignal<string | null>;
3161
+ /** The template must read THIS, never the input beside it — that one is null
3162
+ * until bound, and the config default lives here. */
3163
+ protected readonly brandName: _angular_core.Signal<string>;
3164
+ protected readonly letterGlyph: _angular_core.Signal<string>;
2957
3165
  /** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
2958
3166
  protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
2959
3167
  protected readonly hasBrandName: _angular_core.Signal<boolean>;
3168
+ /** Spread, not `charAt(0)`: the latter indexes UTF-16 code UNITS, so a brand
3169
+ * starting with an astral character (an emoji, a rarer CJK glyph) yields half
3170
+ * a surrogate pair and paints as tofu. */
3171
+ protected readonly markGlyph: _angular_core.Signal<string>;
2960
3172
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavComponent, never>;
2961
3173
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavComponent, "ds-sidenav", never, { "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "logoLetter": { "alias": "logoLetter"; "required": false; "isSignal": true; }; }, {}, ["brandNameRef"], ["[brand]", "[dsBrandName]", "*"], true, never>;
2962
3174
  }
@@ -3135,8 +3347,10 @@ declare class ModalComponent implements OnDestroy {
3135
3347
  readonly open: _angular_core.ModelSignal<boolean>;
3136
3348
  /** Dialog width — sm/md/lg/xl/fullscreen. */
3137
3349
  readonly size: _angular_core.InputSignal<ModalSize>;
3138
- /** Renders the error styling on the modal card. */
3139
- readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
3350
+ /** Severity, forwarded to the card — drives its icon-badge tint, title colour,
3351
+ * default icon and ARIA role. Null (default) is a neutral dialog. `false` and
3352
+ * `undefined` land on null too, so `[status]="isDangerous && 'error'"` binds. */
3353
+ readonly status: _angular_core.InputSignalWithTransform<DsStatus | null, false | DsStatus | null | undefined>;
3140
3354
  /** Dialog title, shown in the header and used for `aria-labelledby`. */
3141
3355
  readonly title: _angular_core.InputSignal<string>;
3142
3356
  /** Secondary line under the title. Not part of the accessible name. */
@@ -3145,8 +3359,13 @@ declare class ModalComponent implements OnDestroy {
3145
3359
  readonly closed: _angular_core.OutputEmitterRef<void>;
3146
3360
  /** Emit this yourself from a confirm action in the projected content — not fired by the modal itself. */
3147
3361
  readonly confirmed: _angular_core.OutputEmitterRef<void>;
3148
- /** Draws the rules under the header and over the actions. Turning them off also tightens the vertical padding they were sized for. */
3149
- readonly dividers: _angular_core.InputSignalWithTransform<boolean, unknown>;
3362
+ /** Draws the rules under the header and over the actions. Turning them off also
3363
+ * tightens the vertical padding they were sized for. Unset falls back to
3364
+ * `DS_CONFIG.modal.dividers`, then `true`. */
3365
+ readonly dividers: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3366
+ /** Resolved here and passed down, so the card is told rather than resolving a
3367
+ * second time — the two would disagree if a provider sat between them. */
3368
+ protected readonly dividersResolved: _angular_core.Signal<boolean>;
3150
3369
  /** When false, clicking the scrim does not close the modal. */
3151
3370
  readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
3152
3371
  /** When true, neither backdrop click nor Escape closes the modal — only programmatic or explicit close button. */
@@ -3162,36 +3381,54 @@ declare class ModalComponent implements OnDestroy {
3162
3381
  protected onClose(): void;
3163
3382
  protected onLeaveEnd(event: AnimationEvent): void;
3164
3383
  private finishClose;
3165
- protected onBackdrop(event: MouseEvent): void;
3384
+ protected readonly backdropPress: {
3385
+ down: (event: PointerEvent) => void;
3386
+ shouldDismiss: (event: PointerEvent) => boolean;
3387
+ };
3388
+ protected onBackdropRelease(event: PointerEvent): void;
3166
3389
  protected onEscape(): void;
3167
3390
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalComponent, never>;
3168
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalComponent, "ds-modal", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "dividers": { "alias": "dividers"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "persistent": { "alias": "persistent"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; "confirmed": "confirmed"; }, never, ["[eyebrow]", "[title-badge]", "[body]", "[impact]", "[actions]"], true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
3391
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalComponent, "ds-modal", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "dividers": { "alias": "dividers"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "persistent": { "alias": "persistent"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; "confirmed": "confirmed"; }, never, ["[eyebrow]", "[title-badge]", "[body]", "[impact]", "[actions]"], true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
3169
3392
  }
3170
3393
 
3171
3394
  declare class ModalCardComponent {
3172
3395
  /** Card width — sm/md/lg/xl/fullscreen. */
3173
3396
  readonly size: _angular_core.InputSignal<ModalSize>;
3174
- /** Renders the error styling (icon badge and card accent). */
3175
- readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
3397
+ /** Severity — drives the icon-badge tint, the title colour, the DEFAULT icon and
3398
+ * the ARIA role, which is the same set `ds-alert`'s variant drives. Null (the
3399
+ * default) is a neutral dialog. It picks an icon as well as a tint because a tint
3400
+ * alone signals by colour only; `icon` overrides the pick.
3401
+ *
3402
+ * `false` and `undefined` land on null too, so a template can bind the short
3403
+ * `[status]="isDangerous && 'error'"` instead of spelling out the ternary. */
3404
+ readonly status: _angular_core.InputSignalWithTransform<DsStatus | null, false | DsStatus | null | undefined>;
3176
3405
  /** Card title, shown in the header and used for `aria-labelledby`. */
3177
3406
  readonly title: _angular_core.InputSignal<string>;
3178
3407
  /** Secondary line under the title. Not part of the accessible name. */
3179
3408
  readonly subtitle: _angular_core.InputSignal<string | null>;
3180
3409
  /** Shows the header close button. */
3181
3410
  readonly showClose: _angular_core.InputSignalWithTransform<boolean, unknown>;
3182
- /** Draws the rules under the header and over the actions. Turning them off also tightens the vertical padding they were sized for. */
3183
- readonly dividers: _angular_core.InputSignalWithTransform<boolean, unknown>;
3184
- /** Icon badge shown next to the title. */
3411
+ /** Draws the rules under the header and over the actions. Turning them off also
3412
+ * tightens the vertical padding they were sized for. Unset falls back to
3413
+ * `DS_CONFIG.modal.dividers`, then `true`. */
3414
+ readonly dividers: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3415
+ protected readonly dividersResolved: _angular_core.Signal<boolean>;
3416
+ /** Icon badge shown next to the title. Overrides the icon `status` would pick. */
3185
3417
  readonly icon: _angular_core.InputSignal<IconName | null>;
3186
- /** ARIA role for the dialog element. */
3187
- readonly dialogRole: _angular_core.InputSignal<"dialog" | "alertdialog">;
3418
+ /** ARIA role. Unset, an error or warning becomes `alertdialog` — the role for a
3419
+ * dialog that interrupts with something the reader must act on — and anything
3420
+ * else stays `dialog`. Same split `ds-alert` makes between `alert` and `status`. */
3421
+ readonly dialogRole: _angular_core.InputSignal<"dialog" | "alertdialog" | null>;
3188
3422
  /** Fires when the header close button is clicked. */
3189
3423
  readonly closed: _angular_core.OutputEmitterRef<void>;
3190
3424
  protected readonly titleId: string;
3425
+ /** Status picks the glyph so a severity is never carried by colour alone. */
3426
+ protected readonly resolvedIcon: _angular_core.Signal<IconName | null>;
3427
+ protected readonly resolvedRole: _angular_core.Signal<"dialog" | "alertdialog">;
3191
3428
  protected readonly classes: _angular_core.Signal<string>;
3192
3429
  protected onClose(): void;
3193
3430
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalCardComponent, never>;
3194
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalCardComponent, "ds-modal-card", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "showClose": { "alias": "showClose"; "required": false; "isSignal": true; }; "dividers": { "alias": "dividers"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "dialogRole": { "alias": "dialogRole"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["[eyebrow]", "[title-badge]", "[body]", "[impact]", "[actions]"], true, never>;
3431
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalCardComponent, "ds-modal-card", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "showClose": { "alias": "showClose"; "required": false; "isSignal": true; }; "dividers": { "alias": "dividers"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "dialogRole": { "alias": "dialogRole"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["[eyebrow]", "[title-badge]", "[body]", "[impact]", "[actions]"], true, never>;
3195
3432
  }
3196
3433
 
3197
3434
  type ModalConfirmTone = 'default' | 'error';
@@ -3766,7 +4003,11 @@ declare class BottomSheetComponent implements OnDestroy {
3766
4003
  protected onLeaveEnd(event: AnimationEvent): void;
3767
4004
  private finishClose;
3768
4005
  protected onEscape(): void;
3769
- protected stop(event: Event): void;
4006
+ protected readonly backdropPress: {
4007
+ down: (event: PointerEvent) => void;
4008
+ shouldDismiss: (event: PointerEvent) => boolean;
4009
+ };
4010
+ protected onBackdropRelease(event: PointerEvent): void;
3770
4011
  protected onGrabStart(event: PointerEvent): void;
3771
4012
  protected onGrabMove(event: PointerEvent): void;
3772
4013
  protected onGrabEnd(): void;
@@ -3822,9 +4063,7 @@ declare class PageFooterComponent {
3822
4063
 
3823
4064
  /** `fill` stretches to the host container (default); `content` hugs chips/value + a min typing area. */
3824
4065
  type AutocompleteWidth = 'fill' | 'content';
3825
- interface AutocompleteOption<T = unknown> {
3826
- readonly value: T;
3827
- readonly label: string;
4066
+ interface AutocompleteOption<T = unknown> extends DsOption<T> {
3828
4067
  }
3829
4068
  interface AutocompleteOptionGroup<T = unknown> {
3830
4069
  readonly label: string;
@@ -3852,40 +4091,25 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
3852
4091
  /** Draws the trailing chevron. Turn it off for a search field, where an arrow
3853
4092
  * invites a click that would list everything instead of searching. */
3854
4093
  readonly showChevron: _angular_core.InputSignalWithTransform<boolean, unknown>;
3855
- /** Caps the number of chips shown before collapsing the rest into "+N more" — 0/null shows all.
3856
- * Same name and semantics as `ds-multi-select`: without it a trigger grows a
3857
- * line per selection and pushes the rest of the form down the page. */
3858
- readonly maxVisibleChips: _angular_core.InputSignalWithTransform<number | null, number | null>;
3859
- /** Trigger height — sm/md/lg. */
3860
- readonly size: _angular_core.InputSignal<DsSize>;
4094
+ /** How the chips collapse when they outgrow one line. `"fit"` (the default)
4095
+ * measures and shows as many as the trigger is wide, the rest behind "+N more".
4096
+ * A NUMBER caps at exactly that many, which is what you want when the trigger's
4097
+ * height must be predictable whatever the width. `null` shows every chip and
4098
+ * lets the trigger grow a line per selection. */
4099
+ readonly maxVisibleChips: _angular_core.InputSignalWithTransform<number | "fit" | null, number | "fit" | null>;
4100
+ /** Trigger height — sm/md/lg.
4101
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
4102
+ readonly size: _angular_core.InputSignal<DsSize | null>;
4103
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
3861
4104
  /** Trigger width — `fill` stretches to the container, `content` hugs the value. */
3862
4105
  readonly width: _angular_core.InputSignal<AutocompleteWidth>;
3863
4106
  /** Placeholder shown in the input when empty. */
3864
4107
  readonly placeholder: _angular_core.InputSignal<string>;
3865
4108
  /** Disables the trigger and blocks all interaction. */
3866
4109
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
3867
- /** Applies error styling and marks the field `aria-invalid`. */
3868
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3869
- /** Helper text shown below the field. */
3870
- readonly hint: _angular_core.InputSignal<string>;
3871
- /** Error text. Shown immediately — binding it says the consumer has already
3872
- * decided this field is in error. Takes precedence over `errors`. */
3873
- readonly error: _angular_core.InputSignal<string>;
3874
- /** Advisory text, shown when there is no error. */
3875
- readonly warning: _angular_core.InputSignal<string>;
3876
- /** Validation errors, shown once the user has interacted. Bound automatically
3877
- * by signal forms; reactive and template-driven forms are read through
3878
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
3879
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
3880
- /** Whether the user has interacted with the field. Bound by signal forms; gates
3881
- * `errors`, so a `required` error does not greet an untouched form. */
3882
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3883
- /** Reserve the message-row height even when empty, so the field doesn't shift
3884
- * the layout below it when a hint/error appears. Falls back to
3885
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
3886
- * for a form that shows validation messages. */
3887
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3888
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4110
+ /** Confirmation text, shown when there is no error or warning — and it paints
4111
+ * the field's success border. A string like `warning`: the text IS the state. */
4112
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
3889
4113
  /** Shows a "Create «text»" row when the typed text matches no option. */
3890
4114
  readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
3891
4115
  /** Accessible name for the input. */
@@ -3896,6 +4120,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
3896
4120
  protected readonly hintId: _angular_core.Signal<string | null>;
3897
4121
  private readonly fieldMessage;
3898
4122
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
4123
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
3899
4124
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
3900
4125
  protected readonly query: _angular_core.WritableSignal<string>;
3901
4126
  protected readonly isOpen: _angular_core.WritableSignal<boolean>;
@@ -3903,6 +4128,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
3903
4128
  protected readonly trigger: _angular_core.Signal<ElementRef<HTMLElement>>;
3904
4129
  protected readonly filterInput: _angular_core.Signal<ElementRef<HTMLInputElement>>;
3905
4130
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
4131
+ private readonly chipRow;
3906
4132
  private overlayRef;
3907
4133
  protected readonly uid: string;
3908
4134
  protected readonly listboxId: string;
@@ -3918,6 +4144,17 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
3918
4144
  /** Flat list of visible options used for keyboard navigation index. */
3919
4145
  protected readonly visibleOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
3920
4146
  protected readonly selectedTags: _angular_core.Signal<AutocompleteOption<T>[]>;
4147
+ /** True for BOTH `'fit'` and a number: a number is a ceiling ("at most N"), not a
4148
+ * promise, so the row still measures and shows only what the width allows. Only
4149
+ * `null` opts out of measuring. */
4150
+ protected readonly fitsChipsToWidth: _angular_core.Signal<boolean>;
4151
+ /** How many chips the row is ASKED to render before measuring: everything for
4152
+ * `'fit'`, the ceiling for a number. It has to be the ceiling and not the
4153
+ * selection, because the measurement caches chip widths from a render that
4154
+ * holds them all — with a numeric cap that render never happens, the cache
4155
+ * never fills, and the fit fell back to "show them all" without a word. */
4156
+ private readonly chipBudget;
4157
+ private readonly chipsThatFit;
3921
4158
  /** What the trigger renders. Separate from `selectedTags`, which stays the
3922
4159
  * full selection: Backspace removes the last SELECTED chip, and capping the
3923
4160
  * list it reads would silently make it remove the last VISIBLE one instead. */
@@ -3927,6 +4164,14 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
3927
4164
  protected readonly placeholderText: _angular_core.Signal<string>;
3928
4165
  protected isSelected(option: AutocompleteOption<T>): boolean;
3929
4166
  protected optionClass(option: AutocompleteOption<T>): string;
4167
+ /** First option a reader can actually act on — -1 when the list is empty or
4168
+ * every option is disabled. */
4169
+ private firstEnabledIndex;
4170
+ /** Arrow keys step OVER a disabled option rather than landing on it — an active
4171
+ * row Enter refuses to act on is a dead end the reader has to guess their way
4172
+ * out of. `step` is +1/-1; the create row (past the last option) is always
4173
+ * reachable. Returns -1 when every option is disabled. */
4174
+ private nextEnabledIndex;
3930
4175
  /** Flat index of the given option within the visible (filtered) list. */
3931
4176
  protected flatIndexOf(option: AutocompleteOption<T>): number;
3932
4177
  protected onTriggerClick(): void;
@@ -3953,7 +4198,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
3953
4198
  protected onCreateNew(): void;
3954
4199
  protected remove(target: T): void;
3955
4200
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent<any>, never>;
3956
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionGroups": { "alias": "optionGroups"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showChevron": { "alias": "showChevron"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "create": "create"; }, never, ["[dsAutocompletePrefix]", "[dsAutocompleteSuffix]"], true, never>;
4201
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionGroups": { "alias": "optionGroups"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showChevron": { "alias": "showChevron"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "create": "create"; }, never, ["[dsAutocompletePrefix]", "[dsAutocompleteSuffix]"], true, never>;
3957
4202
  }
3958
4203
 
3959
4204
  type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
@@ -4036,20 +4281,30 @@ interface SegmentedOption {
4036
4281
  disabled?: boolean;
4037
4282
  }
4038
4283
 
4039
- declare class SegmentedComponent {
4284
+ declare class SegmentedComponent extends DsControlValueAccessor<string> {
4040
4285
  /** Segments to render — each needs a `label` and `value`, optional `icon`/`disabled`. */
4041
4286
  readonly options: _angular_core.InputSignal<readonly SegmentedOption[]>;
4042
4287
  /** Selected segment's `value`, two-way bound. */
4043
4288
  readonly value: _angular_core.ModelSignal<string>;
4044
4289
  /** Accessible name for the segmented control (radiogroup role). */
4045
4290
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
4291
+ /** Visible label above the track; omit to supply your own. */
4292
+ readonly label: _angular_core.InputSignal<string>;
4293
+ /** Disables every segment. */
4294
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
4295
+ readonly isDisabled: _angular_core.Signal<boolean>;
4296
+ protected readonly uid: string;
4297
+ protected readonly hintId: _angular_core.Signal<string | null>;
4298
+ private readonly fieldMessage;
4299
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4300
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
4046
4301
  private readonly buttons;
4047
4302
  protected readonly focusableValue: _angular_core.Signal<string | null>;
4048
4303
  protected select(option: SegmentedOption): void;
4049
4304
  protected onKeydown(event: KeyboardEvent, index: number): void;
4050
4305
  private nextEnabled;
4051
4306
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SegmentedComponent, never>;
4052
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SegmentedComponent, "ds-segmented", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
4307
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SegmentedComponent, "ds-segmented", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
4053
4308
  }
4054
4309
 
4055
4310
  declare class ButtonGroupComponent {
@@ -4071,16 +4326,18 @@ declare class ListItemComponent {
4071
4326
  readonly title: _angular_core.InputSignal<string>;
4072
4327
  /** Secondary line below `title`. */
4073
4328
  readonly subtitle: _angular_core.InputSignal<string>;
4074
- /** Whole-row navigation: renders an inner button and emits `activated`. */
4329
+ /** Makes the row's text a button that emits `activated`. `[leading]` and
4330
+ * `[trailing]` stay outside it, so a row can hold its own controls as well. */
4075
4331
  readonly clickable: _angular_core.InputSignalWithTransform<boolean, unknown>;
4076
- /** Marks the row current via `aria-current`. */
4332
+ /** Marks the row current — `aria-current` and the selected tint. */
4077
4333
  readonly selected: _angular_core.InputSignalWithTransform<boolean, unknown>;
4078
- /** Disables the row; only affects the button when `clickable`. */
4334
+ /** Disables the row's own button. Controls projected into `[leading]` or
4335
+ * `[trailing]` keep their own disabled state. */
4079
4336
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
4080
4337
  /** Fires when the clickable row's button is activated. */
4081
4338
  readonly activated: _angular_core.OutputEmitterRef<void>;
4082
4339
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListItemComponent, never>;
4083
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListItemComponent, "ds-list-item", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "activated": "activated"; }, never, ["[leading]", "*", "[trailing]"], true, never>;
4340
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListItemComponent, "ds-list-item", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "activated": "activated"; }, never, ["[leading]", "[trailing]", "*"], true, never>;
4084
4341
  }
4085
4342
 
4086
4343
  type SplitButtonVariant = 'primary' | 'outline';
@@ -4146,28 +4403,9 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
4146
4403
  readonly mask: _angular_core.InputSignalWithTransform<boolean, unknown>;
4147
4404
  /** Disables all cells and blocks interaction. */
4148
4405
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
4149
- /** Applies error styling and marks each cell `aria-invalid`. */
4150
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
4151
- /** Helper text shown below the cells. */
4152
- readonly hint: _angular_core.InputSignal<string>;
4153
- /** Error text. Shown immediately — binding it says the consumer has already
4154
- * decided this field is in error. Takes precedence over `errors`. */
4155
- readonly error: _angular_core.InputSignal<string>;
4156
- /** Advisory text, shown when there is no error. */
4157
- readonly warning: _angular_core.InputSignal<string>;
4158
- /** Validation errors, shown once the user has interacted. Bound automatically
4159
- * by signal forms; reactive and template-driven forms are read through
4160
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4161
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4162
- /** Whether the user has interacted with the field. Bound by signal forms; gates
4163
- * `errors`, so a `required` error does not greet an untouched form. */
4164
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
4165
- /** Reserve the message-row height even when empty, so the field doesn't shift
4166
- * the layout below it when a hint/error appears. Falls back to
4167
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4168
- * for a form that shows validation messages. */
4169
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4170
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4406
+ /** Confirmation text, shown when there is no error or warning — and it paints
4407
+ * the field's success border. A string like `warning`: the text IS the state. */
4408
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
4171
4409
  /** Accessible group label for the cell row. */
4172
4410
  readonly ariaLabel: _angular_core.InputSignal<string>;
4173
4411
  /** Fires once, with the full code, on the partial → complete transition. */
@@ -4178,6 +4416,7 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
4178
4416
  protected readonly hintId: _angular_core.Signal<string | null>;
4179
4417
  private readonly fieldMessage;
4180
4418
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
4419
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
4181
4420
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
4182
4421
  protected readonly isDisabled: _angular_core.Signal<boolean>;
4183
4422
  protected readonly cells: _angular_core.Signal<string[]>;
@@ -4194,7 +4433,7 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
4194
4433
  private focusBox;
4195
4434
  private sanitize;
4196
4435
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<OtpInputComponent, never>;
4197
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<OtpInputComponent, "ds-otp-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "length": { "alias": "length"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "completed": "completed"; }, never, never, true, never>;
4436
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<OtpInputComponent, "ds-otp-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "length": { "alias": "length"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "completed": "completed"; }, never, never, true, never>;
4198
4437
  }
4199
4438
 
4200
4439
  type SliderValue = number | readonly [number, number];
@@ -4213,28 +4452,6 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
4213
4452
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
4214
4453
  /** Accessible name for the thumb(s) — suffixed "minimum"/"maximum" in `range` mode. */
4215
4454
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
4216
- /** Applies error styling. */
4217
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
4218
- /** Helper text shown below the slider. */
4219
- readonly hint: _angular_core.InputSignal<string>;
4220
- /** Error text. Shown immediately — binding it says the consumer has already
4221
- * decided this field is in error. Takes precedence over `errors`. */
4222
- readonly error: _angular_core.InputSignal<string>;
4223
- /** Advisory text, shown when there is no error. */
4224
- readonly warning: _angular_core.InputSignal<string>;
4225
- /** Validation errors, shown once the user has interacted. Bound automatically
4226
- * by signal forms; reactive and template-driven forms are read through
4227
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4228
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4229
- /** Whether the user has interacted with the field. Bound by signal forms; gates
4230
- * `errors`, so a `required` error does not greet an untouched form. */
4231
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
4232
- /** Reserve the message-row height even when empty, so the field doesn't shift
4233
- * the layout below it when a hint/error appears. Falls back to
4234
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4235
- * for a form that shows validation messages. */
4236
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4237
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4238
4455
  private readonly track;
4239
4456
  private dragging;
4240
4457
  protected readonly uid: string;
@@ -4262,7 +4479,7 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
4262
4479
  private setThumb;
4263
4480
  private snap;
4264
4481
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SliderComponent, never>;
4265
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SliderComponent, "ds-slider", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
4482
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SliderComponent, "ds-slider", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
4266
4483
  }
4267
4484
 
4268
4485
  declare class LoadingOverlayComponent {
@@ -4344,28 +4561,9 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
4344
4561
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
4345
4562
  /** Accessible name for the trigger button and panel. */
4346
4563
  readonly ariaLabel: _angular_core.InputSignal<string>;
4347
- /** Applies error styling and marks the trigger `aria-invalid`. */
4348
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
4349
- /** Helper text shown below the trigger. */
4350
- readonly hint: _angular_core.InputSignal<string>;
4351
- /** Error text. Shown immediately — binding it says the consumer has already
4352
- * decided this field is in error. Takes precedence over `errors`. */
4353
- readonly error: _angular_core.InputSignal<string>;
4354
- /** Advisory text, shown when there is no error. */
4355
- readonly warning: _angular_core.InputSignal<string>;
4356
- /** Validation errors, shown once the user has interacted. Bound automatically
4357
- * by signal forms; reactive and template-driven forms are read through
4358
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4359
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4360
- /** Whether the user has interacted with the field. Bound by signal forms; gates
4361
- * `errors`, so a `required` error does not greet an untouched form. */
4362
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
4363
- /** Reserve the message-row height even when empty, so the field doesn't shift
4364
- * the layout below it when a hint/error appears. Falls back to
4365
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4366
- * for a form that shows validation messages. */
4367
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4368
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4564
+ /** Confirmation text, shown when there is no error or warning — and it paints
4565
+ * the field's success border. A string like `warning`: the text IS the state. */
4566
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
4369
4567
  protected readonly trigger: _angular_core.Signal<ElementRef<HTMLButtonElement>>;
4370
4568
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
4371
4569
  protected readonly open: _angular_core.WritableSignal<boolean>;
@@ -4378,6 +4576,7 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
4378
4576
  protected readonly hintId: _angular_core.Signal<string | null>;
4379
4577
  private readonly fieldMessage;
4380
4578
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
4579
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
4381
4580
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
4382
4581
  protected readonly isDisabled: _angular_core.Signal<boolean>;
4383
4582
  protected readonly displayHex: _angular_core.Signal<string>;
@@ -4407,13 +4606,10 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
4407
4606
  private updateHue;
4408
4607
  private clampPct;
4409
4608
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColorPickerComponent, never>;
4410
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColorPickerComponent, "ds-color-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
4609
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColorPickerComponent, "ds-color-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
4411
4610
  }
4412
4611
 
4413
- interface MultiSelectOption {
4414
- label: string;
4415
- value: string;
4416
- disabled?: boolean;
4612
+ interface MultiSelectOption extends DsOption<string> {
4417
4613
  }
4418
4614
 
4419
4615
  declare class MultiSelectComponent extends DsControlValueAccessor<string[]> implements OnDestroy {
@@ -4431,32 +4627,17 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4431
4627
  readonly placeholder: _angular_core.InputSignal<string>;
4432
4628
  /** Placeholder for the in-panel filter input. */
4433
4629
  readonly searchPlaceholder: _angular_core.InputSignal<string>;
4434
- /** Caps the number of chips shown before collapsing the rest into "+N more" — 0/null shows all. */
4435
- readonly maxVisibleChips: _angular_core.InputSignalWithTransform<number | null, number | null>;
4630
+ /** How the chips collapse when they outgrow one line. `"fit"` (the default)
4631
+ * measures and shows as many as the trigger is wide, the rest behind "+N more".
4632
+ * A NUMBER caps at exactly that many, which is what you want when the trigger's
4633
+ * height must be predictable whatever the width. `null` shows every chip and
4634
+ * lets the trigger grow a line per selection. */
4635
+ readonly maxVisibleChips: _angular_core.InputSignalWithTransform<number | "fit" | null, number | "fit" | null>;
4436
4636
  /** Disables the trigger and blocks all interaction. */
4437
4637
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
4438
- /** Applies error styling and marks the field `aria-invalid`. */
4439
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
4440
- /** Helper text shown below the field. */
4441
- readonly hint: _angular_core.InputSignal<string>;
4442
- /** Error text. Shown immediately — binding it says the consumer has already
4443
- * decided this field is in error. Takes precedence over `errors`. */
4444
- readonly error: _angular_core.InputSignal<string>;
4445
- /** Advisory text, shown when there is no error. */
4446
- readonly warning: _angular_core.InputSignal<string>;
4447
- /** Validation errors, shown once the user has interacted. Bound automatically
4448
- * by signal forms; reactive and template-driven forms are read through
4449
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4450
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4451
- /** Whether the user has interacted with the field. Bound by signal forms; gates
4452
- * `errors`, so a `required` error does not greet an untouched form. */
4453
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
4454
- /** Reserve the message-row height even when empty, so the field doesn't shift
4455
- * the layout below it when a hint/error appears. Falls back to
4456
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4457
- * for a form that shows validation messages. */
4458
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4459
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4638
+ /** Confirmation text, shown when there is no error or warning — and it paints
4639
+ * the field's success border. A string like `warning`: the text IS the state. */
4640
+ readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
4460
4641
  /** Accessible name for the trigger — falls back to `placeholder`. */
4461
4642
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
4462
4643
  /** Shows a "Select all" row that toggles every filter-matching, enabled option. */
@@ -4467,6 +4648,7 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4467
4648
  protected readonly trigger: _angular_core.Signal<ElementRef<HTMLElement>>;
4468
4649
  protected readonly searchInput: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
4469
4650
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
4651
+ private readonly chipRow;
4470
4652
  protected readonly open: _angular_core.WritableSignal<boolean>;
4471
4653
  protected readonly filter: _angular_core.WritableSignal<string>;
4472
4654
  protected readonly activeIndex: _angular_core.WritableSignal<number>;
@@ -4475,6 +4657,19 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4475
4657
  ngOnDestroy(): void;
4476
4658
  protected readonly isDisabled: _angular_core.Signal<boolean>;
4477
4659
  protected readonly selectedOptions: _angular_core.Signal<MultiSelectOption[]>;
4660
+ /** True for BOTH `'fit'` and a number: a number is a ceiling, not a promise —
4661
+ * "at most N" — so the row still measures and shows only what the trigger is
4662
+ * wide enough for. Without that, a phone-width trigger honoured the count and
4663
+ * wrapped the text input onto a second line, which is the one thing the cap
4664
+ * exists to prevent. `null` opts out of measuring and grows, as documented. */
4665
+ protected readonly fitsChipsToWidth: _angular_core.Signal<boolean>;
4666
+ /** How many chips the row is ASKED to render before measuring: everything for
4667
+ * `'fit'`, the ceiling for a number. It has to be the ceiling and not the
4668
+ * selection, because the measurement caches chip widths from a render that
4669
+ * holds them all — with a numeric cap that render never happens, the cache
4670
+ * never fills, and the fit fell back to "show them all" without a word. */
4671
+ private readonly chipBudget;
4672
+ private readonly chipsThatFit;
4478
4673
  protected readonly visibleChips: _angular_core.Signal<MultiSelectOption[]>;
4479
4674
  protected readonly overflowCount: _angular_core.Signal<number>;
4480
4675
  protected readonly filteredOptions: _angular_core.Signal<MultiSelectOption[]>;
@@ -4483,6 +4678,7 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4483
4678
  protected readonly hintId: _angular_core.Signal<string | null>;
4484
4679
  private readonly fieldMessage;
4485
4680
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
4681
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
4486
4682
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
4487
4683
  private enabledFiltered;
4488
4684
  protected readonly allFilteredSelected: _angular_core.Signal<boolean>;
@@ -4499,7 +4695,7 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4499
4695
  protected close(cause?: DsOverlayCloseCause): void;
4500
4696
  private moveActive;
4501
4697
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
4502
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
4698
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
4503
4699
  }
4504
4700
 
4505
4701
  declare class SkeletonComponent {
@@ -4533,30 +4729,10 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
4533
4729
  readonly name: _angular_core.InputSignal<string | null>;
4534
4730
  /** Overrides the generated id used by the native `<input>` and its `<label for>`. */
4535
4731
  readonly inputId: _angular_core.InputSignal<string | null>;
4536
- /** Applies error styling and marks the input `aria-invalid`. */
4537
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
4538
- /** Helper text shown below the checkbox. */
4539
- readonly hint: _angular_core.InputSignal<string>;
4540
- /** Error text. Shown immediately — binding it says the consumer has already
4541
- * decided this field is in error. Takes precedence over `errors`. */
4542
- readonly error: _angular_core.InputSignal<string>;
4543
- /** Advisory text, shown when there is no error. */
4544
- readonly warning: _angular_core.InputSignal<string>;
4545
- /** Validation errors, shown once the user has interacted. Bound automatically
4546
- * by signal forms; reactive and template-driven forms are read through
4547
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4548
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4549
- /** Whether the user has interacted with the field. Bound by signal forms; gates
4550
- * `errors`, so a `required` error does not greet an untouched form. */
4551
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
4552
- /** Reserve the message-row height even when empty, so the field doesn't shift
4553
- * the layout below it when a hint/error appears. Falls back to
4554
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4555
- * for a form that shows validation messages. */
4556
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4557
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4558
- /** Checkbox size — sm/md/lg. */
4559
- readonly size: _angular_core.InputSignal<DsSize>;
4732
+ /** Checkbox size — sm/md/lg.
4733
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
4734
+ readonly size: _angular_core.InputSignal<DsSize | null>;
4735
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
4560
4736
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
4561
4737
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
4562
4738
  /** Inline label rendered beside the box and wired via for/id. Omit to
@@ -4572,10 +4748,10 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
4572
4748
  protected readonly fieldClass: _angular_core.Signal<string>;
4573
4749
  protected onCheckedChange(event: Event): void;
4574
4750
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<CheckboxComponent, never>;
4575
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxComponent, "ds-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "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>;
4751
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxComponent, "ds-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
4576
4752
  }
4577
4753
 
4578
- declare class RadioComponent {
4754
+ declare class RadioComponent extends DsFieldBase {
4579
4755
  /** Standalone two-way binding. When inside ds-radio-group, isChecked() is
4580
4756
  * derived from the group value instead. */
4581
4757
  readonly checked: _angular_core.ModelSignal<boolean>;
@@ -4587,30 +4763,10 @@ declare class RadioComponent {
4587
4763
  readonly value: _angular_core.InputSignal<unknown>;
4588
4764
  /** Overrides the auto-generated id used for the input and its label's `for`. */
4589
4765
  readonly inputId: _angular_core.InputSignal<string | null>;
4590
- /** Applies error styling and marks the input `aria-invalid`. */
4591
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
4592
- /** Helper text shown below the control. */
4593
- readonly hint: _angular_core.InputSignal<string>;
4594
- /** Error text. Shown immediately — binding it says the consumer has already
4595
- * decided this field is in error. Takes precedence over `errors`. */
4596
- readonly error: _angular_core.InputSignal<string>;
4597
- /** Advisory text, shown when there is no error. */
4598
- readonly warning: _angular_core.InputSignal<string>;
4599
- /** Validation errors, shown once the user has interacted. Bound automatically
4600
- * by signal forms; reactive and template-driven forms are read through
4601
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4602
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4603
- /** Whether the user has interacted with the field. Bound by signal forms; gates
4604
- * `errors`, so a `required` error does not greet an untouched form. */
4605
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
4606
- /** Reserve the message-row height even when empty, so the field doesn't shift
4607
- * the layout below it when a hint/error appears. Falls back to
4608
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4609
- * for a form that shows validation messages. */
4610
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4611
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4612
- /** Control size — sm/md/lg. */
4613
- readonly size: _angular_core.InputSignal<DsSize>;
4766
+ /** Control size — sm/md/lg.
4767
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
4768
+ readonly size: _angular_core.InputSignal<DsSize | null>;
4769
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
4614
4770
  /** Marks the radio required — shows an asterisk on the label and sets `aria-required`. */
4615
4771
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
4616
4772
  /** Inline label rendered beside the dot and wired via for/id. Omit to bring
@@ -4635,7 +4791,7 @@ declare class RadioComponent {
4635
4791
  focus(): void;
4636
4792
  protected onSelect(): void;
4637
4793
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<RadioComponent, never>;
4638
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioComponent, "ds-radio", never, { "checked": { "alias": "checked"; "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; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "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>;
4794
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioComponent, "ds-radio", never, { "checked": { "alias": "checked"; "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>;
4639
4795
  }
4640
4796
 
4641
4797
  /** Contract that ds-radio reads from its parent ds-radio-group, injected via
@@ -4663,28 +4819,6 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
4663
4819
  readonly name: _angular_core.InputSignal<string | null>;
4664
4820
  /** Disables the whole group. */
4665
4821
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
4666
- /** Applies error styling and marks the group `aria-invalid`. */
4667
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
4668
- /** Helper text shown below the group. */
4669
- readonly hint: _angular_core.InputSignal<string>;
4670
- /** Error text. Shown immediately — binding it says the consumer has already
4671
- * decided this field is in error. Takes precedence over `errors`. */
4672
- readonly error: _angular_core.InputSignal<string>;
4673
- /** Advisory text, shown when there is no error. */
4674
- readonly warning: _angular_core.InputSignal<string>;
4675
- /** Validation errors, shown once the user has interacted. Bound automatically
4676
- * by signal forms; reactive and template-driven forms are read through
4677
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4678
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4679
- /** Whether the user has interacted with the field. Bound by signal forms; gates
4680
- * `errors`, so a `required` error does not greet an untouched form. */
4681
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
4682
- /** Reserve the message-row height even when empty, so the field doesn't shift
4683
- * the layout below it when a hint/error appears. Falls back to
4684
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4685
- * for a form that shows validation messages. */
4686
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4687
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4688
4822
  /** Accessible name for the group when no visible label is provided. */
4689
4823
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
4690
4824
  /** Visible group label; omit to supply your own. */
@@ -4702,7 +4836,7 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
4702
4836
  select(value: unknown): void;
4703
4837
  protected onKeydown(event: KeyboardEvent): void;
4704
4838
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<RadioGroupComponent, never>;
4705
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioGroupComponent, "ds-radio-group", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["radios"], ["*"], true, never>;
4839
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioGroupComponent, "ds-radio-group", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["radios"], ["*"], true, never>;
4706
4840
  }
4707
4841
 
4708
4842
  declare class SwitchComponent extends DsBooleanControlValueAccessor {
@@ -4716,30 +4850,10 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
4716
4850
  readonly variant: _angular_core.InputSignal<"error" | "success" | "default">;
4717
4851
  /** Overrides the generated id used by the native `<input>` and its `<label for>`. */
4718
4852
  readonly inputId: _angular_core.InputSignal<string | null>;
4719
- /** Applies error styling and marks the input `aria-invalid`. */
4720
- readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
4721
- /** Helper text shown below the switch. */
4722
- readonly hint: _angular_core.InputSignal<string>;
4723
- /** Error text. Shown immediately — binding it says the consumer has already
4724
- * decided this field is in error. Takes precedence over `errors`. */
4725
- readonly error: _angular_core.InputSignal<string>;
4726
- /** Advisory text, shown when there is no error. */
4727
- readonly warning: _angular_core.InputSignal<string>;
4728
- /** Validation errors, shown once the user has interacted. Bound automatically
4729
- * by signal forms; reactive and template-driven forms are read through
4730
- * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4731
- readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4732
- /** Whether the user has interacted with the field. Bound by signal forms; gates
4733
- * `errors`, so a `required` error does not greet an untouched form. */
4734
- readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
4735
- /** Reserve the message-row height even when empty, so the field doesn't shift
4736
- * the layout below it when a hint/error appears. Falls back to
4737
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4738
- * for a form that shows validation messages. */
4739
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4740
- protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4741
- /** Switch size — sm/md/lg. */
4742
- readonly size: _angular_core.InputSignal<DsSize>;
4853
+ /** Switch size — sm/md/lg.
4854
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
4855
+ readonly size: _angular_core.InputSignal<DsSize | null>;
4856
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
4743
4857
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
4744
4858
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
4745
4859
  /** Inline label rendered beside the track and wired via for/id. Omit to
@@ -4756,7 +4870,7 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
4756
4870
  protected readonly fieldClass: _angular_core.Signal<string>;
4757
4871
  protected onCheckedChange(event: Event): void;
4758
4872
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SwitchComponent, never>;
4759
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SwitchComponent, "ds-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "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>;
4873
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SwitchComponent, "ds-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "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>;
4760
4874
  }
4761
4875
 
4762
4876
  /**
@@ -4776,5 +4890,5 @@ declare class FieldClickFocusDirective {
4776
4890
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
4777
4891
  }
4778
4892
 
4779
- export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppLayoutComponent, AuthLayoutComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BodyScrollLockService, BottomSheetComponent, BrandNameDirective, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_FIELD_GROUP, DS_ICON_REGISTRY, DS_TOAST_CONFIG, DS_TOAST_POSITION, DS_TOAST_POSITION_DEFAULT, DatePickerComponent, DescriptionItemComponent, DescriptionListComponent, DividerComponent, DrawerComponent, DropzoneComponent, DsOverlayCloseRef, DsStaticPreview, EmptyStateComponent, FieldClickFocusDirective, FieldGroupComponent, FilterBarComponent, FilterItemDirective, HeaderFilterDirective, ICONS, IconButtonComponent, IconComponent, InlineComponent, InputComponent, LayoutNavigationService, LayoutScrollService, ListComponent, ListItemComponent, LoadingOverlayComponent, MenuComponent, MenuDividerComponent, MenuItemComponent, ModalCardComponent, ModalComponent, ModalService, MultiSelectComponent, NumberStepperComponent, OtpInputComponent, PageFooterComponent, PageHeaderComponent, PaginationComponent, PasswordRulesComponent, PopoverComponent, ProgressComponent, RADIO_GROUP, RadioComponent, RadioGroupComponent, RailTriggerDirective, ReserveMessagesDirective, SIDENAV, SearchComponent, SegmentedComponent, SelectComponent, SidenavComponent, SidenavFooterComponent, SidenavGroupComponent, SidenavItemComponent, SkeletonComponent, SliderComponent, SpinnerComponent, SplitButtonComponent, StackComponent, StatComponent, StatusDotComponent, StepperComponent, SwitchComponent, TabComponent, TableComponent, TabsComponent, TagComponent, TextareaComponent, TimePickerComponent, TimelineComponent, TimelineItemComponent, ToastComponent, ToastRegionComponent, ToastService, ToggleButtonComponent, TooltipDirective, TooltipPanelComponent, TopBarComponent, TreeComponent, W3wComponent, avatarTint, inheritDsConfig, initialsFrom, isSelectOptionGroup, passwordRulesMet, provideDsConfig, provideDsIcons, provideDsTheme };
4780
- export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteOption, AutocompleteOptionGroup, AutocompleteWidth, AvatarSize, AvatarStatus, AvatarTintOptions, BannerVariant, BreadcrumbItem, ButtonColor, ButtonType, ButtonVariant, CardElevation, CardPadding, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerSpacing, DividerVariant, DrawerPlacement, DropzoneFile, DropzoneFileState, DsConfig, DsFieldGroupContext, DsIconRegistry, DsPasswordRule, DsPasswordRuleState, DsScrollReset, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, EmptyStateVariant, HeaderFilterContext, IconButtonType, IconButtonVariant, IconName, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectOption, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, SidenavAlertItem, SidenavContract, SidenavItemModel, SidenavSearchProvider, SidenavSearchResult, SortChangeEvent, SortDir, SplitButtonItem, SplitButtonVariant, StepperLabelPosition, StepperOrientation, TableCellEditEvent, TableColumn, TableFilterMode, TableRowAction, TableRowActionEvent, TableSortMode, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TimeFormat, TimePickerMode, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };
4893
+ export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppLayoutComponent, AuthLayoutComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BodyScrollLockService, BottomSheetComponent, BrandNameDirective, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_FIELD_GROUP, DS_FIELD_WARNING_KIND, DS_ICON_REGISTRY, DS_TOAST_CONFIG, DS_TOAST_POSITION, DS_TOAST_POSITION_DEFAULT, DatePickerComponent, DescriptionItemComponent, DescriptionListComponent, DividerComponent, DrawerComponent, DropzoneComponent, DsOverlayCloseRef, DsStaticPreview, EmptyStateComponent, FieldClickFocusDirective, FieldGroupComponent, FilterBarComponent, FilterItemDirective, HeaderFilterDirective, ICONS, IconButtonComponent, IconComponent, InlineComponent, InputComponent, LayoutNavigationService, LayoutScrollService, ListComponent, ListItemComponent, LoadingOverlayComponent, MenuComponent, MenuDividerComponent, MenuItemComponent, ModalCardComponent, ModalComponent, ModalService, MultiSelectComponent, NumberStepperComponent, OtpInputComponent, PageFooterComponent, PageHeaderComponent, PaginationComponent, PasswordRulesComponent, PopoverComponent, ProgressComponent, RADIO_GROUP, RadioComponent, RadioGroupComponent, RailTriggerDirective, ReserveMessagesDirective, SIDENAV, SearchComponent, SegmentedComponent, SelectComponent, SidenavComponent, SidenavFooterComponent, SidenavGroupComponent, SidenavItemComponent, SkeletonComponent, SliderComponent, SpinnerComponent, SplitButtonComponent, StackComponent, StatComponent, StatusDotComponent, StepperComponent, SwitchComponent, TabComponent, TableComponent, TabsComponent, TagComponent, TextareaComponent, TimePickerComponent, TimelineComponent, TimelineItemComponent, ToastComponent, ToastRegionComponent, ToastService, ToggleButtonComponent, TooltipDirective, TooltipPanelComponent, TopBarComponent, TreeComponent, W3wComponent, avatarTint, inheritDsConfig, initialsFrom, isSelectOptionGroup, passwordRulesMet, provideDsConfig, provideDsIcons, provideDsTheme };
4894
+ export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteOption, AutocompleteOptionGroup, AutocompleteWidth, AvatarSize, AvatarStatus, AvatarTintOptions, BannerVariant, BreadcrumbItem, ButtonColor, ButtonType, ButtonVariant, CardElevation, CardPadding, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerSpacing, DividerVariant, DrawerPlacement, DropzoneFile, DropzoneFileState, DsConfig, DsFieldError, DsFieldErrorsInput, DsFieldGroupContext, DsIconRegistry, DsOption, DsPasswordRule, DsPasswordRuleState, DsScrollReset, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, EmptyStateVariant, HeaderFilterContext, IconButtonType, IconButtonVariant, IconName, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectOption, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, SidenavAlertItem, SidenavContract, SidenavItemModel, SidenavSearchProvider, SidenavSearchResult, SortChangeEvent, SortDir, SplitButtonItem, SplitButtonVariant, StepperLabelPosition, StepperOrientation, TableCellEditEvent, TableColumn, TableFilterMode, TableRowAction, TableRowActionEvent, TableSortMode, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TimeFormat, TimePickerMode, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };