@ids-group-ltd/ids-design-system 0.9.1 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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';
@@ -1260,9 +1411,11 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1260
1411
  readonly value: _angular_core.ModelSignal<string>;
1261
1412
  /** Native input type — also affects the default clear button and password toggle. */
1262
1413
  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`. */
1414
+ /** Field height — sm/md/lg.
1415
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1416
+ readonly size: _angular_core.InputSignal<DsSize | null>;
1417
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1418
+ /** Label shown above the field. */
1266
1419
  readonly label: _angular_core.InputSignal<string>;
1267
1420
  /** Helper text shown below the field. */
1268
1421
  readonly hint: _angular_core.InputSignal<string>;
@@ -1303,9 +1456,6 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1303
1456
  /** Shows a trailing spinner — e.g. async validation in flight. The input
1304
1457
  * stays editable; pair with a `hint` like "Checking availability…". */
1305
1458
  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
1459
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
1310
1460
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1311
1461
  /** Shows an "(optional)" marker next to the label (ignored when `required`). */
@@ -1340,7 +1490,7 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1340
1490
  /** Mobile keyboard hints — forwarded to the native input as attributes. */
1341
1491
  readonly enterKeyHint: _angular_core.InputSignal<"search" | "next" | "enter" | "done" | "go" | "previous" | "send" | null>;
1342
1492
  /** Native `inputmode` attribute — hints the on-screen keyboard layout. */
1343
- readonly inputMode: _angular_core.InputSignal<"search" | "text" | "none" | "email" | "tel" | "url" | "decimal" | "numeric" | null>;
1493
+ readonly inputMode: _angular_core.InputSignal<"search" | "none" | "text" | "email" | "tel" | "url" | "decimal" | "numeric" | null>;
1344
1494
  /** Emits when the native input loses focus. */
1345
1495
  readonly blurred: _angular_core.OutputEmitterRef<void>;
1346
1496
  /**
@@ -1364,6 +1514,7 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1364
1514
  protected readonly describedBy: _angular_core.Signal<string | null>;
1365
1515
  private readonly fieldMessage;
1366
1516
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
1517
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
1367
1518
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
1368
1519
  /** Only name via aria-label when there's no visible `<label for>`. */
1369
1520
  protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
@@ -1380,7 +1531,7 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1380
1531
  focus(options?: FocusOptions): void;
1381
1532
  protected clear(): void;
1382
1533
  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>;
1534
+ 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; }; "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
1535
  }
1385
1536
 
1386
1537
  declare class NumberStepperComponent {
@@ -1392,8 +1543,10 @@ declare class NumberStepperComponent {
1392
1543
  readonly max: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
1393
1544
  /** Amount added or subtracted per increment/decrement. */
1394
1545
  readonly step: _angular_core.InputSignal<number>;
1395
- /** Control height — sm/md/lg. */
1396
- readonly size: _angular_core.InputSignal<DsSize>;
1546
+ /** Control height — sm/md/lg.
1547
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1548
+ readonly size: _angular_core.InputSignal<DsSize | null>;
1549
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1397
1550
  /** Disables the stepper and blocks all interaction. */
1398
1551
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1399
1552
  /** Accessible name for the number input (the stepper has no visible label). */
@@ -1414,8 +1567,10 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
1414
1567
  private readonly control;
1415
1568
  /** Text value, two-way bound. */
1416
1569
  readonly value: _angular_core.ModelSignal<string>;
1417
- /** Field height — sm/md/lg. */
1418
- readonly size: _angular_core.InputSignal<DsSize>;
1570
+ /** Field height — sm/md/lg.
1571
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1572
+ readonly size: _angular_core.InputSignal<DsSize | null>;
1573
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1419
1574
  /** Label shown above the field. */
1420
1575
  readonly label: _angular_core.InputSignal<string>;
1421
1576
  /** Helper text shown below the field. */
@@ -1484,6 +1639,7 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
1484
1639
  protected readonly hintId: _angular_core.Signal<string | null>;
1485
1640
  private readonly fieldMessage;
1486
1641
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
1642
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
1487
1643
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
1488
1644
  protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
1489
1645
  /** Effective disabled — own `disabled` input OR the reactive-forms state. */
@@ -1518,19 +1674,43 @@ declare class SearchComponent {
1518
1674
  /** Accessible name for the input (placeholder is not a reliable label). */
1519
1675
  readonly ariaLabel: _angular_core.InputSignal<string>;
1520
1676
  /** 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>;
1677
+ * aligns search with dense toolbars beside `sm` inputs/buttons; `lg` is touch.
1678
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1679
+ readonly size: _angular_core.InputSignal<DsSize | null>;
1680
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1523
1681
  /** Fires with the current value on Enter. */
1524
1682
  readonly submitted: _angular_core.OutputEmitterRef<string>;
1683
+ /** Milliseconds to hold each keystroke back before `value` updates — 0 (default)
1684
+ * writes on every keystroke, exactly as this control always has.
1685
+ *
1686
+ * Clearing the field BYPASSES the delay, which is the part a plain
1687
+ * `debounceTime` gets wrong: emptying a search is a deliberate act, and making
1688
+ * the user wait 200ms to see the full list back reads as a hang. Enter flushes
1689
+ * for the same reason. What the input SHOWS is never delayed. */
1690
+ readonly debounce: _angular_core.InputSignalWithTransform<number, unknown>;
1525
1691
  private readonly inputEl;
1692
+ /** What the input shows. Separate from `value` only so typing never waits on
1693
+ * the timer; with `debounce` at 0 the two move together. */
1694
+ protected readonly text: _angular_core.WritableSignal<string>;
1695
+ private pending;
1696
+ /** The last text this component pushed into `value`, so an update arriving from
1697
+ * the HOST can be told apart from its own echo — a host resetting the field
1698
+ * mid-typing has to win, and cancel the keystroke still in flight. */
1699
+ private pushed;
1700
+ constructor();
1526
1701
  /** Move keyboard focus to the search input. Public so a host can hand focus
1527
1702
  * over deliberately — e.g. a Clear button that disables itself on activation
1528
1703
  * would otherwise blur into `<body>` and restart Tab order at the top. */
1529
1704
  focus(options?: FocusOptions): void;
1705
+ protected onText(next: string): void;
1530
1706
  protected onSubmit(): void;
1531
1707
  protected clear(): void;
1708
+ /** So Enter searches what the reader can see, not what the timer last let past. */
1709
+ private flush;
1710
+ private push;
1711
+ private cancel;
1532
1712
  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>;
1713
+ 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
1714
  }
1535
1715
 
1536
1716
  /**
@@ -1549,11 +1729,7 @@ declare class DsStaticPreview {
1549
1729
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsStaticPreview, never, never, { "staticPreview": { "alias": "staticPreview"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
1550
1730
  }
1551
1731
 
1552
- interface SelectOption {
1553
- label: string;
1554
- value: string;
1555
- disabled?: boolean;
1556
- icon?: IconName;
1732
+ interface SelectOption extends DsOption<string> {
1557
1733
  }
1558
1734
  interface SelectOptionGroup {
1559
1735
  label: string;
@@ -1577,8 +1753,10 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1577
1753
  readonly options: _angular_core.InputSignal<SelectItem[]>;
1578
1754
  /** Shown in the trigger when nothing is selected. */
1579
1755
  readonly placeholder: _angular_core.InputSignal<string>;
1580
- /** Trigger height — sm/md/lg. */
1581
- readonly size: _angular_core.InputSignal<DsSize>;
1756
+ /** Trigger height — sm/md/lg.
1757
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
1758
+ readonly size: _angular_core.InputSignal<DsSize | null>;
1759
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
1582
1760
  /** Label shown above the trigger. */
1583
1761
  readonly label: _angular_core.InputSignal<string>;
1584
1762
  /** Disables the trigger and blocks all interaction. */
@@ -1629,6 +1807,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1629
1807
  protected readonly hintId: _angular_core.Signal<string | null>;
1630
1808
  private readonly fieldMessage;
1631
1809
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
1810
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
1632
1811
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
1633
1812
  protected optionId(flatIndex: number): string;
1634
1813
  /** Active option for `aria-activedescendant` (combobox keeps DOM focus). */
@@ -1786,8 +1965,15 @@ interface TableColumn<T = unknown> {
1786
1965
  * in the title tooltip, and clicking a clipped cell opens it in a popover.
1787
1966
  * Text cells only — template cells own their overflow. */
1788
1967
  truncate?: boolean;
1789
- /** Column width in px — also the clip width for `truncate`. */
1790
- width?: number;
1968
+ /** Column width in px — also the clip width for `truncate`.
1969
+ *
1970
+ * `'content'` instead sizes the column to its widest cell and stops it wrapping,
1971
+ * leaving the remaining width to the columns that should absorb it. An
1972
+ * auto-layout table spreads slack evenly, so a short column (a status, a count,
1973
+ * an actions cell) ends up as wide as its own header while the name column that
1974
+ * should take the slack does not. A pixel width cannot express that — pin one
1975
+ * column and the rest still spread. Dragging the column's edge overrides it. */
1976
+ width?: number | 'content';
1791
1977
  align?: 'left' | 'right' | 'center';
1792
1978
  cell?: (row: T) => string;
1793
1979
  /** Sort this column by a DOMAIN value instead of the rendered text. Without
@@ -1849,14 +2035,23 @@ declare class TableComponent<T extends object> {
1849
2035
  /** Opt-in outer border + radius. Off by default so tables flush inside a
1850
2036
  * `<ds-card padding="none">` (workspaces, programs-list) don't double-border.
1851
2037
  * 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.
2038
+ * `var(--radius-md)` radius — useful when the table stands alone in a padded card.
2039
+ * Unset falls back to `DS_CONFIG.table.bordered`, then `false`. */
2040
+ readonly bordered: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
2041
+ /** false — no loading state.
2042
+ * `true` — the table picks: skeleton rows while it has nothing to show, overlay
2043
+ * once rows are on screen. Prefer it; the right choice is a function of the row
2044
+ * count, which only the table holds.
1855
2045
  * 'skeleton' — first-load placeholder; rows are replaced with shimmer
1856
2046
  * rows that read the global --skeleton-shimmer-x driver.
1857
2047
  * '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">;
2048
+ * a translucent overlay with a centred spinner. Pin either one only to
2049
+ * override the rule deliberately. */
2050
+ readonly loading: _angular_core.InputSignal<boolean | "skeleton" | "overlay">;
2051
+ /** The mode actually rendered. Skeletons replace what the reader is looking at and
2052
+ * an overlay on an empty card says nothing, so `true` resolves per state rather
2053
+ * than picking a favourite. */
2054
+ protected readonly loadingMode: _angular_core.Signal<false | "skeleton" | "overlay">;
1860
2055
  /** Keeps the header row pinned while the body scrolls. */
1861
2056
  readonly stickyHeader: _angular_core.InputSignalWithTransform<boolean, unknown>;
1862
2057
  /** Caps the scroll body height (any CSS length, e.g. `'320px'`) and scrolls it
@@ -1872,10 +2067,29 @@ declare class TableComponent<T extends object> {
1872
2067
  readonly animateHeight: _angular_core.InputSignalWithTransform<boolean, unknown>;
1873
2068
  /** Two-way set of currently selected row ids. */
1874
2069
  readonly selectedIds: _angular_core.ModelSignal<Set<string>>;
1875
- /** Column key currently sorted by; `null` when unsorted. */
1876
- readonly sortKey: _angular_core.ModelSignal<string | null>;
2070
+ /** Column key currently sorted by; `null` when unsorted. Two-way bindable
2071
+ * (`[(sortKey)]`) or one-way from your own state with `(sortChange)`. */
2072
+ readonly sortKey: _angular_core.InputSignal<string | null>;
2073
+ /** Emitted for `[(sortKey)]`. `sortChange` carries the same click with both
2074
+ * halves at once, which is usually the one to listen to. */
2075
+ readonly sortKeyChange: _angular_core.OutputEmitterRef<string | null>;
1877
2076
  /** Sort direction for `sortKey`. */
1878
- readonly sortDir: _angular_core.ModelSignal<SortDir>;
2077
+ readonly sortDir: _angular_core.InputSignal<SortDir>;
2078
+ /** Emitted for `[(sortDir)]`. */
2079
+ readonly sortDirChange: _angular_core.OutputEmitterRef<SortDir>;
2080
+ /**
2081
+ * What the header marks, and what a client sort reads.
2082
+ *
2083
+ * `linkedSignal` over BOTH inputs, not a `model`: Angular writes an input only
2084
+ * when the bound expression changed, diffing against the value IT last wrote, and
2085
+ * an internal `.set()` never updates that slot. Seeding from both means a host
2086
+ * answering with its own default re-seeds the pair even when one half of that
2087
+ * default equals what it last bound. A host that binds neither never re-seeds, so
2088
+ * the optimistic state survives.
2089
+ */
2090
+ private readonly sortState;
2091
+ protected readonly activeSortKey: _angular_core.Signal<string | null>;
2092
+ protected readonly activeSortDir: _angular_core.Signal<SortDir>;
1879
2093
  /** Sort states a column cycles through on click. Default includes null
1880
2094
  * (unsorted); pass ['asc','desc'] to forbid the unsorted state (e.g.
1881
2095
  * server-paged lists). */
@@ -1934,8 +2148,9 @@ declare class TableComponent<T extends object> {
1934
2148
  /** Screen id the persisted layout is stored under. Pick something stable per
1935
2149
  * table, not per route instance. */
1936
2150
  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. */
2151
+ /** Render an export button in the table's toolbar row. Off by default. Leave it
2152
+ * off and drive `runExport()` from your own button — in a page header, a filter
2153
+ * bar, the `[toolbar]` slot — reading `exporting()` for its loading state. */
1939
2154
  readonly exportButton: _angular_core.InputSignalWithTransform<boolean, unknown>;
1940
2155
  /** Filename the export button downloads as. */
1941
2156
  readonly exportFilename: _angular_core.InputSignal<string>;
@@ -1952,15 +2167,19 @@ declare class TableComponent<T extends object> {
1952
2167
  /** Fires when `exportFetcher` rejects. Without it a failed export is silent —
1953
2168
  * the button simply re-enables and no file arrives. */
1954
2169
  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>;
2170
+ private readonly exportingState;
2171
+ /** True while `exportFetcher` is in flight. Public so a button OUTSIDE the table
2172
+ * can show the same in-flight state as the built-in one. */
2173
+ readonly exporting: _angular_core.Signal<boolean>;
2174
+ private readonly exportStatusState;
1957
2175
  /** Announced in the table's live region while an export is running or after it
1958
2176
  * failed, so the button's own disabled state is not the only signal. */
1959
- protected readonly exportStatus: _angular_core.WritableSignal<string>;
2177
+ readonly exportStatus: _angular_core.Signal<string>;
1960
2178
  /** Keeps the horizontal scrollbar reachable on tall tables: the scroll
1961
2179
  * 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>;
2180
+ * nearest scroll ancestor mirrors it both ways. Off by default. Unset falls
2181
+ * back to `DS_CONFIG.table.stickyScrollbar`, then `false`. */
2182
+ readonly stickyScrollbar: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
1964
2183
  /** Rows per page. `null` (default) disables pagination — all rows render. */
1965
2184
  readonly pageSize: _angular_core.ModelSignal<number | null>;
1966
2185
  /** Current 1-based page. Only meaningful when `pageSize()` is set. */
@@ -1999,6 +2218,8 @@ declare class TableComponent<T extends object> {
1999
2218
  readonly columnFilterOptions: _angular_core.InputSignal<ReadonlyMap<string, readonly string[]>>;
2000
2219
  protected readonly filterModeResolved: _angular_core.Signal<TableFilterMode>;
2001
2220
  protected readonly sortModeResolved: _angular_core.Signal<TableSortMode>;
2221
+ protected readonly borderedResolved: _angular_core.Signal<boolean>;
2222
+ protected readonly stickyScrollbarResolved: _angular_core.Signal<boolean>;
2002
2223
  /** Pin the first data column (and the select column) on horizontal scroll. */
2003
2224
  readonly stickyFirstColumn: _angular_core.InputSignalWithTransform<boolean, unknown>;
2004
2225
  /**
@@ -2078,6 +2299,11 @@ declare class TableComponent<T extends object> {
2078
2299
  protected readonly tableClasses: _angular_core.Signal<string>;
2079
2300
  protected readonly isSkeletonLoading: _angular_core.Signal<boolean>;
2080
2301
  protected readonly isOverlayLoading: _angular_core.Signal<boolean>;
2302
+ /** The empty row is a CLAIM about the data — "there are none" — so it must not
2303
+ * appear while the table is still asking. Only `skeleton` used to suppress it,
2304
+ * and `overlay` is the mode a list uses on every read after the first, so a
2305
+ * zero-row reload painted "No rows yet" under the spinner. */
2306
+ protected readonly showsEmptyRow: _angular_core.Signal<boolean>;
2081
2307
  protected readonly effectiveHiddenKeys: _angular_core.Signal<ReadonlySet<string>>;
2082
2308
  /** Columns in the user-controlled order — `columnOrder` first (dropping
2083
2309
  * unknown keys), then any declared column the order omitted. */
@@ -2142,8 +2368,16 @@ declare class TableComponent<T extends object> {
2142
2368
  private static readonly RESIZE_PAGE;
2143
2369
  private static readonly MIN_COLUMN_WIDTH;
2144
2370
  private resizeState;
2145
- /** Resolved pixel width for a column: a drag override wins, else `column.width`. */
2371
+ /** Resolved pixel width for a column: a drag override wins, else `column.width`
2372
+ * when that is a number. `'content'` is not a pixel value — it is carried by a
2373
+ * class instead, see `fitsContent`. */
2146
2374
  protected columnWidth(col: TableColumn<T>): number | null;
2375
+ /** Shrink-to-content mode, unless the user has dragged this column — a drag is a
2376
+ * deliberate pixel width and must win over the declared intent. */
2377
+ protected fitsContent(col: TableColumn<T>): boolean;
2378
+ /** Clip width for `truncate`. `'content'` has no clip width — the column is as
2379
+ * wide as its widest cell, so there is nothing to ellipsis against. */
2380
+ protected clipWidth(col: TableColumn<T>): number | null;
2147
2381
  protected onResizeStart(col: TableColumn<T>, event: PointerEvent): void;
2148
2382
  /**
2149
2383
  * Freeze the columns at what they currently measure, once, before the first
@@ -2296,17 +2530,21 @@ declare class TableComponent<T extends object> {
2296
2530
  protected headerClasses(col: TableColumn<T>): string;
2297
2531
  protected sortIcon(col: TableColumn<T>): 'sortAsc' | 'sortDesc' | 'sort';
2298
2532
  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()">`. */
2533
+ /** Serialises the visible columns of the rows the TABLE HOLDS as a CSV download.
2534
+ * On a server-paged table that is one page — prefer `runExport()`, which goes
2535
+ * through `exportFetcher` and exports the whole set. Pass `rows` to serialise a
2536
+ * set you fetched yourself. */
2302
2537
  exportCsv(filename?: string, rows?: readonly T[]): void;
2303
2538
  private layoutKey;
2304
2539
  private layoutRestored;
2305
2540
  private restoreLayout;
2306
2541
  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>;
2542
+ /** Runs the export the built-in button runs: awaits `exportFetcher` when one is
2543
+ * given — so a server-paged table exports the whole set rather than the page it
2544
+ * holds — downloads the result, drives `exporting`, writes the live region and
2545
+ * emits `exportFailed`. Public so the button can live anywhere:
2546
+ * `<ds-button [loading]="table.exporting()" (pressed)="table.runExport()">`. */
2547
+ runExport(): Promise<void>;
2310
2548
  /** Hands a ready-made file to the browser. Only a Blob gets its object URL
2311
2549
  * revoked — a URL the caller supplied is theirs to manage. */
2312
2550
  private downloadFile;
@@ -2314,7 +2552,7 @@ declare class TableComponent<T extends object> {
2314
2552
  * across re-renders. Mixes column key + row index into one of five widths. */
2315
2553
  protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
2316
2554
  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>;
2555
+ 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
2556
  }
2319
2557
 
2320
2558
  declare class PaginationComponent {
@@ -2484,8 +2722,10 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
2484
2722
  private readonly panelTokens;
2485
2723
  /** Selection mode — single date or start/end range. */
2486
2724
  readonly mode: _angular_core.InputSignal<DatePickerMode>;
2487
- /** Trigger height — sm/md/lg. */
2488
- readonly size: _angular_core.InputSignal<DsSize>;
2725
+ /** Trigger height — sm/md/lg.
2726
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
2727
+ readonly size: _angular_core.InputSignal<DsSize | null>;
2728
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
2489
2729
  /** Stretch the trigger to fill its container instead of hugging the mask
2490
2730
  * width — opt in when the field shares a grid/flex track with inputs. */
2491
2731
  readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -2556,6 +2796,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
2556
2796
  private readonly dateInvalid;
2557
2797
  private readonly fieldMessage;
2558
2798
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
2799
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
2559
2800
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
2560
2801
  protected readonly resolvedLocale: _angular_core.Signal<string>;
2561
2802
  protected readonly resolvedFirstDay: _angular_core.Signal<number>;
@@ -2703,7 +2944,8 @@ type TimeValue = string;
2703
2944
  type TimeRangeValue = [string | null, string | null];
2704
2945
  type TimePickerValue = TimeValue | TimeRangeValue | null;
2705
2946
 
2706
- type ColumnId = 'hours' | 'minutes' | 'period';
2947
+ /** Which of the panel's listbox columns a pick came from. */
2948
+ type TimeColumnId = 'hours' | 'minutes' | 'period';
2707
2949
  interface Cell<T> {
2708
2950
  value: T;
2709
2951
  label: string;
@@ -2729,6 +2971,11 @@ declare class TimeColumnsComponent {
2729
2971
  readonly disabledTime: _angular_core.InputSignal<((time: string) => boolean) | null>;
2730
2972
  /** A complete time was picked, as `HH:mm`. Not emitted while only one column has moved. */
2731
2973
  readonly timeChange: _angular_core.OutputEmitterRef<string>;
2974
+ /** Which column the pick came from. `timeChange` alone cannot say: it carries a
2975
+ * whole time, and a host that wants to close once the user has been through
2976
+ * both columns cannot infer the difference between "chose the same hour again"
2977
+ * and "did not touch hours". Emitted immediately after `timeChange`. */
2978
+ readonly partPicked: _angular_core.OutputEmitterRef<TimeColumnId>;
2732
2979
  private readonly hourButtons;
2733
2980
  private readonly minuteButtons;
2734
2981
  private readonly periodButtons;
@@ -2748,7 +2995,7 @@ declare class TimeColumnsComponent {
2748
2995
  protected selectHour(cell: Cell<number>): void;
2749
2996
  protected selectMinute(cell: Cell<number>): void;
2750
2997
  protected selectPeriod(cell: Cell<'AM' | 'PM'>): void;
2751
- protected onKey(event: KeyboardEvent, column: ColumnId, index: number): void;
2998
+ protected onKey(event: KeyboardEvent, column: TimeColumnId, index: number): void;
2752
2999
  /** Called by the parent after the overlay renders. */
2753
3000
  focusSelected(): void;
2754
3001
  scrollSelectedIntoView(): void;
@@ -2767,7 +3014,7 @@ declare class TimeColumnsComponent {
2767
3014
  private focusColumn;
2768
3015
  private scrollColumn;
2769
3016
  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>;
3017
+ 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
3018
  }
2772
3019
 
2773
3020
  type Segment = 'single' | 'start' | 'end';
@@ -2793,8 +3040,10 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
2793
3040
  readonly maxTime: _angular_core.InputSignal<string | null>;
2794
3041
  /** Predicate marking individual times unselectable. */
2795
3042
  readonly disabledTime: _angular_core.InputSignal<((time: string) => boolean) | null>;
2796
- /** Trigger height — sm/md/lg. */
2797
- readonly size: _angular_core.InputSignal<DsSize>;
3043
+ /** Trigger height — sm/md/lg.
3044
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
3045
+ readonly size: _angular_core.InputSignal<DsSize | null>;
3046
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
2798
3047
  /** Stretch the trigger to fill its container instead of hugging its content —
2799
3048
  * opt in when the field shares a grid/flex track with inputs. */
2800
3049
  readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -2840,6 +3089,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
2840
3089
  protected readonly uid: string;
2841
3090
  protected readonly labelId: string;
2842
3091
  protected readonly openSegment: _angular_core.WritableSignal<Segment | null>;
3092
+ private readonly pickedParts;
2843
3093
  private overlayRef;
2844
3094
  protected readonly singleTrigger: _angular_core.Signal<ElementRef<HTMLButtonElement> | undefined>;
2845
3095
  protected readonly startTrigger: _angular_core.Signal<ElementRef<HTMLButtonElement> | undefined>;
@@ -2850,6 +3100,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
2850
3100
  protected readonly hintId: _angular_core.Signal<string | null>;
2851
3101
  private readonly fieldMessage;
2852
3102
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
3103
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
2853
3104
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
2854
3105
  protected readonly resolvedFormat: _angular_core.Signal<TimeFormat>;
2855
3106
  protected readonly singleValue: _angular_core.Signal<string | null>;
@@ -2870,6 +3121,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
2870
3121
  ngOnDestroy(): void;
2871
3122
  protected onEscape(cause?: DsOverlayCloseCause): void;
2872
3123
  protected onPick(next: string): void;
3124
+ protected onPartPicked(part: TimeColumnId): void;
2873
3125
  protected setNow(): void;
2874
3126
  protected clear(event: Event): void;
2875
3127
  private triggerFor;
@@ -2949,14 +3201,25 @@ declare class SidenavComponent implements SidenavContract {
2949
3201
  /** Collapses the rail to icon-only width; read by nested `ds-sidenav-item`/`ds-sidenav-group`. */
2950
3202
  readonly collapsed: _angular_core.InputSignalWithTransform<boolean, unknown>;
2951
3203
  /** 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>;
3204
+ * logo image/SVG, project it into the `[brand]` slot instead. Unset falls back
3205
+ * to `DS_CONFIG.brand.name`. Each field resolves on its own, so `brand=""` drops
3206
+ * the wordmark while a `logoLetter` in the config still paints its tile. */
3207
+ readonly brand: _angular_core.InputSignal<string | null>;
2954
3208
  /** 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>;
3209
+ * "A" tile beside the "MyAdmin" wordmark). Empty = first letter of `brand`;
3210
+ * unset falls back to `DS_CONFIG.brand.logoLetter`. */
3211
+ readonly logoLetter: _angular_core.InputSignal<string | null>;
3212
+ /** The template must read THIS, never the input beside it — that one is null
3213
+ * until bound, and the config default lives here. */
3214
+ protected readonly brandName: _angular_core.Signal<string>;
3215
+ protected readonly letterGlyph: _angular_core.Signal<string>;
2957
3216
  /** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
2958
3217
  protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
2959
3218
  protected readonly hasBrandName: _angular_core.Signal<boolean>;
3219
+ /** Spread, not `charAt(0)`: the latter indexes UTF-16 code UNITS, so a brand
3220
+ * starting with an astral character (an emoji, a rarer CJK glyph) yields half
3221
+ * a surrogate pair and paints as tofu. */
3222
+ protected readonly markGlyph: _angular_core.Signal<string>;
2960
3223
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavComponent, never>;
2961
3224
  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
3225
  }
@@ -3135,8 +3398,10 @@ declare class ModalComponent implements OnDestroy {
3135
3398
  readonly open: _angular_core.ModelSignal<boolean>;
3136
3399
  /** Dialog width — sm/md/lg/xl/fullscreen. */
3137
3400
  readonly size: _angular_core.InputSignal<ModalSize>;
3138
- /** Renders the error styling on the modal card. */
3139
- readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
3401
+ /** Severity, forwarded to the card — drives its icon-badge tint, title colour,
3402
+ * default icon and ARIA role. Null (default) is a neutral dialog. `false` and
3403
+ * `undefined` land on null too, so `[status]="isDangerous && 'error'"` binds. */
3404
+ readonly status: _angular_core.InputSignalWithTransform<DsStatus | null, false | DsStatus | null | undefined>;
3140
3405
  /** Dialog title, shown in the header and used for `aria-labelledby`. */
3141
3406
  readonly title: _angular_core.InputSignal<string>;
3142
3407
  /** Secondary line under the title. Not part of the accessible name. */
@@ -3145,8 +3410,13 @@ declare class ModalComponent implements OnDestroy {
3145
3410
  readonly closed: _angular_core.OutputEmitterRef<void>;
3146
3411
  /** Emit this yourself from a confirm action in the projected content — not fired by the modal itself. */
3147
3412
  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>;
3413
+ /** Draws the rules under the header and over the actions. Turning them off also
3414
+ * tightens the vertical padding they were sized for. Unset falls back to
3415
+ * `DS_CONFIG.modal.dividers`, then `true`. */
3416
+ readonly dividers: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3417
+ /** Resolved here and passed down, so the card is told rather than resolving a
3418
+ * second time — the two would disagree if a provider sat between them. */
3419
+ protected readonly dividersResolved: _angular_core.Signal<boolean>;
3150
3420
  /** When false, clicking the scrim does not close the modal. */
3151
3421
  readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
3152
3422
  /** When true, neither backdrop click nor Escape closes the modal — only programmatic or explicit close button. */
@@ -3162,36 +3432,54 @@ declare class ModalComponent implements OnDestroy {
3162
3432
  protected onClose(): void;
3163
3433
  protected onLeaveEnd(event: AnimationEvent): void;
3164
3434
  private finishClose;
3165
- protected onBackdrop(event: MouseEvent): void;
3435
+ protected readonly backdropPress: {
3436
+ down: (event: PointerEvent) => void;
3437
+ shouldDismiss: (event: PointerEvent) => boolean;
3438
+ };
3439
+ protected onBackdropRelease(event: PointerEvent): void;
3166
3440
  protected onEscape(): void;
3167
3441
  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: {}; }]>;
3442
+ 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
3443
  }
3170
3444
 
3171
3445
  declare class ModalCardComponent {
3172
3446
  /** Card width — sm/md/lg/xl/fullscreen. */
3173
3447
  readonly size: _angular_core.InputSignal<ModalSize>;
3174
- /** Renders the error styling (icon badge and card accent). */
3175
- readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
3448
+ /** Severity — drives the icon-badge tint, the title colour, the DEFAULT icon and
3449
+ * the ARIA role, which is the same set `ds-alert`'s variant drives. Null (the
3450
+ * default) is a neutral dialog. It picks an icon as well as a tint because a tint
3451
+ * alone signals by colour only; `icon` overrides the pick.
3452
+ *
3453
+ * `false` and `undefined` land on null too, so a template can bind the short
3454
+ * `[status]="isDangerous && 'error'"` instead of spelling out the ternary. */
3455
+ readonly status: _angular_core.InputSignalWithTransform<DsStatus | null, false | DsStatus | null | undefined>;
3176
3456
  /** Card title, shown in the header and used for `aria-labelledby`. */
3177
3457
  readonly title: _angular_core.InputSignal<string>;
3178
3458
  /** Secondary line under the title. Not part of the accessible name. */
3179
3459
  readonly subtitle: _angular_core.InputSignal<string | null>;
3180
3460
  /** Shows the header close button. */
3181
3461
  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. */
3462
+ /** Draws the rules under the header and over the actions. Turning them off also
3463
+ * tightens the vertical padding they were sized for. Unset falls back to
3464
+ * `DS_CONFIG.modal.dividers`, then `true`. */
3465
+ readonly dividers: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3466
+ protected readonly dividersResolved: _angular_core.Signal<boolean>;
3467
+ /** Icon badge shown next to the title. Overrides the icon `status` would pick. */
3185
3468
  readonly icon: _angular_core.InputSignal<IconName | null>;
3186
- /** ARIA role for the dialog element. */
3187
- readonly dialogRole: _angular_core.InputSignal<"dialog" | "alertdialog">;
3469
+ /** ARIA role. Unset, an error or warning becomes `alertdialog` — the role for a
3470
+ * dialog that interrupts with something the reader must act on — and anything
3471
+ * else stays `dialog`. Same split `ds-alert` makes between `alert` and `status`. */
3472
+ readonly dialogRole: _angular_core.InputSignal<"dialog" | "alertdialog" | null>;
3188
3473
  /** Fires when the header close button is clicked. */
3189
3474
  readonly closed: _angular_core.OutputEmitterRef<void>;
3190
3475
  protected readonly titleId: string;
3476
+ /** Status picks the glyph so a severity is never carried by colour alone. */
3477
+ protected readonly resolvedIcon: _angular_core.Signal<IconName | null>;
3478
+ protected readonly resolvedRole: _angular_core.Signal<"dialog" | "alertdialog">;
3191
3479
  protected readonly classes: _angular_core.Signal<string>;
3192
3480
  protected onClose(): void;
3193
3481
  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>;
3482
+ 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
3483
  }
3196
3484
 
3197
3485
  type ModalConfirmTone = 'default' | 'error';
@@ -3766,7 +4054,11 @@ declare class BottomSheetComponent implements OnDestroy {
3766
4054
  protected onLeaveEnd(event: AnimationEvent): void;
3767
4055
  private finishClose;
3768
4056
  protected onEscape(): void;
3769
- protected stop(event: Event): void;
4057
+ protected readonly backdropPress: {
4058
+ down: (event: PointerEvent) => void;
4059
+ shouldDismiss: (event: PointerEvent) => boolean;
4060
+ };
4061
+ protected onBackdropRelease(event: PointerEvent): void;
3770
4062
  protected onGrabStart(event: PointerEvent): void;
3771
4063
  protected onGrabMove(event: PointerEvent): void;
3772
4064
  protected onGrabEnd(): void;
@@ -3822,9 +4114,7 @@ declare class PageFooterComponent {
3822
4114
 
3823
4115
  /** `fill` stretches to the host container (default); `content` hugs chips/value + a min typing area. */
3824
4116
  type AutocompleteWidth = 'fill' | 'content';
3825
- interface AutocompleteOption<T = unknown> {
3826
- readonly value: T;
3827
- readonly label: string;
4117
+ interface AutocompleteOption<T = unknown> extends DsOption<T> {
3828
4118
  }
3829
4119
  interface AutocompleteOptionGroup<T = unknown> {
3830
4120
  readonly label: string;
@@ -3852,12 +4142,16 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
3852
4142
  /** Draws the trailing chevron. Turn it off for a search field, where an arrow
3853
4143
  * invites a click that would list everything instead of searching. */
3854
4144
  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>;
4145
+ /** How the chips collapse when they outgrow one line. `"fit"` (the default)
4146
+ * measures and shows as many as the trigger is wide, the rest behind "+N more".
4147
+ * A NUMBER caps at exactly that many, which is what you want when the trigger's
4148
+ * height must be predictable whatever the width. `null` shows every chip and
4149
+ * lets the trigger grow a line per selection. */
4150
+ readonly maxVisibleChips: _angular_core.InputSignalWithTransform<number | "fit" | null, number | "fit" | null>;
4151
+ /** Trigger height — sm/md/lg.
4152
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
4153
+ readonly size: _angular_core.InputSignal<DsSize | null>;
4154
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
3861
4155
  /** Trigger width — `fill` stretches to the container, `content` hugs the value. */
3862
4156
  readonly width: _angular_core.InputSignal<AutocompleteWidth>;
3863
4157
  /** Placeholder shown in the input when empty. */
@@ -3896,6 +4190,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
3896
4190
  protected readonly hintId: _angular_core.Signal<string | null>;
3897
4191
  private readonly fieldMessage;
3898
4192
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
4193
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
3899
4194
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
3900
4195
  protected readonly query: _angular_core.WritableSignal<string>;
3901
4196
  protected readonly isOpen: _angular_core.WritableSignal<boolean>;
@@ -3903,6 +4198,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
3903
4198
  protected readonly trigger: _angular_core.Signal<ElementRef<HTMLElement>>;
3904
4199
  protected readonly filterInput: _angular_core.Signal<ElementRef<HTMLInputElement>>;
3905
4200
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
4201
+ private readonly chipRow;
3906
4202
  private overlayRef;
3907
4203
  protected readonly uid: string;
3908
4204
  protected readonly listboxId: string;
@@ -3918,6 +4214,17 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
3918
4214
  /** Flat list of visible options used for keyboard navigation index. */
3919
4215
  protected readonly visibleOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
3920
4216
  protected readonly selectedTags: _angular_core.Signal<AutocompleteOption<T>[]>;
4217
+ /** True for BOTH `'fit'` and a number: a number is a ceiling ("at most N"), not a
4218
+ * promise, so the row still measures and shows only what the width allows. Only
4219
+ * `null` opts out of measuring. */
4220
+ protected readonly fitsChipsToWidth: _angular_core.Signal<boolean>;
4221
+ /** How many chips the row is ASKED to render before measuring: everything for
4222
+ * `'fit'`, the ceiling for a number. It has to be the ceiling and not the
4223
+ * selection, because the measurement caches chip widths from a render that
4224
+ * holds them all — with a numeric cap that render never happens, the cache
4225
+ * never fills, and the fit fell back to "show them all" without a word. */
4226
+ private readonly chipBudget;
4227
+ private readonly chipsThatFit;
3921
4228
  /** What the trigger renders. Separate from `selectedTags`, which stays the
3922
4229
  * full selection: Backspace removes the last SELECTED chip, and capping the
3923
4230
  * list it reads would silently make it remove the last VISIBLE one instead. */
@@ -3927,6 +4234,14 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
3927
4234
  protected readonly placeholderText: _angular_core.Signal<string>;
3928
4235
  protected isSelected(option: AutocompleteOption<T>): boolean;
3929
4236
  protected optionClass(option: AutocompleteOption<T>): string;
4237
+ /** First option a reader can actually act on — -1 when the list is empty or
4238
+ * every option is disabled. */
4239
+ private firstEnabledIndex;
4240
+ /** Arrow keys step OVER a disabled option rather than landing on it — an active
4241
+ * row Enter refuses to act on is a dead end the reader has to guess their way
4242
+ * out of. `step` is +1/-1; the create row (past the last option) is always
4243
+ * reachable. Returns -1 when every option is disabled. */
4244
+ private nextEnabledIndex;
3930
4245
  /** Flat index of the given option within the visible (filtered) list. */
3931
4246
  protected flatIndexOf(option: AutocompleteOption<T>): number;
3932
4247
  protected onTriggerClick(): void;
@@ -4178,6 +4493,7 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
4178
4493
  protected readonly hintId: _angular_core.Signal<string | null>;
4179
4494
  private readonly fieldMessage;
4180
4495
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
4496
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
4181
4497
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
4182
4498
  protected readonly isDisabled: _angular_core.Signal<boolean>;
4183
4499
  protected readonly cells: _angular_core.Signal<string[]>;
@@ -4378,6 +4694,7 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
4378
4694
  protected readonly hintId: _angular_core.Signal<string | null>;
4379
4695
  private readonly fieldMessage;
4380
4696
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
4697
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
4381
4698
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
4382
4699
  protected readonly isDisabled: _angular_core.Signal<boolean>;
4383
4700
  protected readonly displayHex: _angular_core.Signal<string>;
@@ -4410,10 +4727,7 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
4410
4727
  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>;
4411
4728
  }
4412
4729
 
4413
- interface MultiSelectOption {
4414
- label: string;
4415
- value: string;
4416
- disabled?: boolean;
4730
+ interface MultiSelectOption extends DsOption<string> {
4417
4731
  }
4418
4732
 
4419
4733
  declare class MultiSelectComponent extends DsControlValueAccessor<string[]> implements OnDestroy {
@@ -4431,8 +4745,12 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4431
4745
  readonly placeholder: _angular_core.InputSignal<string>;
4432
4746
  /** Placeholder for the in-panel filter input. */
4433
4747
  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>;
4748
+ /** How the chips collapse when they outgrow one line. `"fit"` (the default)
4749
+ * measures and shows as many as the trigger is wide, the rest behind "+N more".
4750
+ * A NUMBER caps at exactly that many, which is what you want when the trigger's
4751
+ * height must be predictable whatever the width. `null` shows every chip and
4752
+ * lets the trigger grow a line per selection. */
4753
+ readonly maxVisibleChips: _angular_core.InputSignalWithTransform<number | "fit" | null, number | "fit" | null>;
4436
4754
  /** Disables the trigger and blocks all interaction. */
4437
4755
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
4438
4756
  /** Applies error styling and marks the field `aria-invalid`. */
@@ -4467,6 +4785,7 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4467
4785
  protected readonly trigger: _angular_core.Signal<ElementRef<HTMLElement>>;
4468
4786
  protected readonly searchInput: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
4469
4787
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
4788
+ private readonly chipRow;
4470
4789
  protected readonly open: _angular_core.WritableSignal<boolean>;
4471
4790
  protected readonly filter: _angular_core.WritableSignal<string>;
4472
4791
  protected readonly activeIndex: _angular_core.WritableSignal<number>;
@@ -4475,6 +4794,19 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4475
4794
  ngOnDestroy(): void;
4476
4795
  protected readonly isDisabled: _angular_core.Signal<boolean>;
4477
4796
  protected readonly selectedOptions: _angular_core.Signal<MultiSelectOption[]>;
4797
+ /** True for BOTH `'fit'` and a number: a number is a ceiling, not a promise —
4798
+ * "at most N" — so the row still measures and shows only what the trigger is
4799
+ * wide enough for. Without that, a phone-width trigger honoured the count and
4800
+ * wrapped the text input onto a second line, which is the one thing the cap
4801
+ * exists to prevent. `null` opts out of measuring and grows, as documented. */
4802
+ protected readonly fitsChipsToWidth: _angular_core.Signal<boolean>;
4803
+ /** How many chips the row is ASKED to render before measuring: everything for
4804
+ * `'fit'`, the ceiling for a number. It has to be the ceiling and not the
4805
+ * selection, because the measurement caches chip widths from a render that
4806
+ * holds them all — with a numeric cap that render never happens, the cache
4807
+ * never fills, and the fit fell back to "show them all" without a word. */
4808
+ private readonly chipBudget;
4809
+ private readonly chipsThatFit;
4478
4810
  protected readonly visibleChips: _angular_core.Signal<MultiSelectOption[]>;
4479
4811
  protected readonly overflowCount: _angular_core.Signal<number>;
4480
4812
  protected readonly filteredOptions: _angular_core.Signal<MultiSelectOption[]>;
@@ -4483,6 +4815,7 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4483
4815
  protected readonly hintId: _angular_core.Signal<string | null>;
4484
4816
  private readonly fieldMessage;
4485
4817
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
4818
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
4486
4819
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
4487
4820
  private enabledFiltered;
4488
4821
  protected readonly allFilteredSelected: _angular_core.Signal<boolean>;
@@ -4555,8 +4888,10 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
4555
4888
  * for a form that shows validation messages. */
4556
4889
  readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4557
4890
  protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4558
- /** Checkbox size — sm/md/lg. */
4559
- readonly size: _angular_core.InputSignal<DsSize>;
4891
+ /** Checkbox size — sm/md/lg.
4892
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
4893
+ readonly size: _angular_core.InputSignal<DsSize | null>;
4894
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
4560
4895
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
4561
4896
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
4562
4897
  /** Inline label rendered beside the box and wired via for/id. Omit to
@@ -4609,8 +4944,10 @@ declare class RadioComponent {
4609
4944
  * for a form that shows validation messages. */
4610
4945
  readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4611
4946
  protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4612
- /** Control size — sm/md/lg. */
4613
- readonly size: _angular_core.InputSignal<DsSize>;
4947
+ /** Control size — sm/md/lg.
4948
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
4949
+ readonly size: _angular_core.InputSignal<DsSize | null>;
4950
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
4614
4951
  /** Marks the radio required — shows an asterisk on the label and sets `aria-required`. */
4615
4952
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
4616
4953
  /** Inline label rendered beside the dot and wired via for/id. Omit to bring
@@ -4738,8 +5075,10 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
4738
5075
  * for a form that shows validation messages. */
4739
5076
  readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4740
5077
  protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
4741
- /** Switch size — sm/md/lg. */
4742
- readonly size: _angular_core.InputSignal<DsSize>;
5078
+ /** Switch size — sm/md/lg.
5079
+ * Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
5080
+ readonly size: _angular_core.InputSignal<DsSize | null>;
5081
+ protected readonly sizeResolved: _angular_core.Signal<DsSize>;
4743
5082
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
4744
5083
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
4745
5084
  /** Inline label rendered beside the track and wired via for/id. Omit to
@@ -4777,4 +5116,4 @@ declare class FieldClickFocusDirective {
4777
5116
  }
4778
5117
 
4779
5118
  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 };
5119
+ 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, 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 };