@ids-group-ltd/ids-design-system 0.6.3 → 0.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -98,6 +98,13 @@ declare const ICONS: {
98
98
  type IconName = keyof typeof ICONS | (string & {});
99
99
 
100
100
  interface DsConfig {
101
+ field?: {
102
+ /** Default for every field's `reserveMessage` — keeps a message line's worth
103
+ * of space even when empty. Default `false`. Setting `true` here applies to
104
+ * EVERY field in the injector's subtree, which is rarely what a whole app
105
+ * wants; prefer `dsReserveMessages` on the individual form that validates. */
106
+ reserveMessage?: boolean;
107
+ };
101
108
  breadcrumbs?: {
102
109
  separator?: IconName;
103
110
  clickable?: boolean;
@@ -116,13 +123,29 @@ interface DsConfig {
116
123
  };
117
124
  }
118
125
  declare const DS_CONFIG: InjectionToken<DsConfig>;
119
- /** Provide DS-level defaults at the app root.
126
+ /** Provide DS-level defaults.
120
127
  *
121
128
  * providers: [provideDsConfig({ card: { padding: 'sm' } })]
122
129
  *
123
- * Component inputs (e.g. `<ds-card padding="lg">`) still win over the config.
130
+ * Works at the app root, on a `Route`, or on a component/directive — the
131
+ * config resolves through the element-injector chain, so a subtree can differ
132
+ * from the app. Component inputs (e.g. `<ds-card padding="lg">`) still win.
133
+ *
134
+ * A nested call MERGES with the config above it, section by section, so
135
+ * scoping one flag cannot silently drop unrelated app-level settings. Only the
136
+ * keys you name are replaced.
124
137
  */
125
138
  declare function provideDsConfig(config: DsConfig): Provider;
139
+ /**
140
+ * The factory body behind `provideDsConfig`, exported so a directive can put the
141
+ * provider in its metadata as a plain object literal. Calling `provideDsConfig`
142
+ * there instead would run at module-evaluation time, which makes the module
143
+ * side-effectful and costs the consumer its tree-shaking (measured: the whole
144
+ * library moved into ds-docs' eager chunk, +566 kB).
145
+ *
146
+ * Must be called from an injection context.
147
+ */
148
+ declare function inheritDsConfig(config: DsConfig): DsConfig;
126
149
 
127
150
  interface DsThemeOptions {
128
151
  /**
@@ -161,6 +184,23 @@ declare abstract class DsOverlayCloseRef {
161
184
  abstract close(): void;
162
185
  }
163
186
 
187
+ /**
188
+ * Ref-counted lock on `document.body` scroll, shared by every overlay that
189
+ * covers the viewport (modal, drawer, bottom-sheet). The FIRST `lock()` saves
190
+ * the current `body` overflow and hides it; the LAST `unlock()` restores it —
191
+ * so closing one overlay never re-enables page scroll while another stacked on
192
+ * top of it is still open. Calls must be paired (one `unlock()` per `lock()`).
193
+ */
194
+ declare class BodyScrollLockService {
195
+ private readonly doc;
196
+ private count;
197
+ private previousOverflow;
198
+ lock(): void;
199
+ unlock(): void;
200
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<BodyScrollLockService, never>;
201
+ static ɵprov: _angular_core.ɵɵInjectableDeclaration<BodyScrollLockService>;
202
+ }
203
+
164
204
  /** Canonical status vocabulary shared across status-bearing components. */
165
205
  type DsStatus = 'info' | 'success' | 'warning' | 'error';
166
206
  /**
@@ -184,9 +224,14 @@ interface DsStatusRegistry {
184
224
  * open `string`; once a consumer augments DsStatusRegistry it narrows to the
185
225
  * union of their keys (autocomplete). The tuple wrap avoids `never` distribution.
186
226
  */
187
- type DsStatusKey = [
188
- keyof DsStatusRegistry
189
- ] extends [never] ? string : keyof DsStatusRegistry;
227
+ type DsStatusKey = [keyof DsStatusRegistry] extends [never] ? string : keyof DsStatusRegistry;
228
+
229
+ /**
230
+ * Canonical control-size scale — the shared vocabulary components bind their
231
+ * `size` input to. A component that needs extra steps extends this base with its
232
+ * own (component-named) type, kept inside that component.
233
+ */
234
+ type DsSize = 'sm' | 'md' | 'lg';
190
235
 
191
236
  declare class IconComponent {
192
237
  private readonly sanitizer;
@@ -230,9 +275,38 @@ declare const DS_ICON_REGISTRY: InjectionToken<Readonly<Record<string, string>>>
230
275
  */
231
276
  declare function provideDsIcons(icons: DsIconRegistry): Provider;
232
277
 
278
+ /**
279
+ * Turns on `reserveMessage` for every DS field declared inside the host
280
+ * element, so a validated form holds its message rows without repeating the
281
+ * input on each control:
282
+ *
283
+ * ```html
284
+ * <form dsReserveMessages>
285
+ * <ds-input label="Email" />
286
+ * <ds-input label="Password" />
287
+ * </form>
288
+ * ```
289
+ *
290
+ * It provides `DS_CONFIG`, which merges with the config above it — scoping this
291
+ * one flag cannot drop unrelated app-level settings. A field's own
292
+ * `[reserveMessage]` still wins, so a single control can opt back out.
293
+ *
294
+ * The switch is the directive's PRESENCE, not an input: providers are resolved
295
+ * at construction, before inputs are set, so a bound value could not drive
296
+ * them. To turn it off for a subtree, provide the config directly:
297
+ * `provideDsConfig({ field: { reserveMessage: false } })`.
298
+ *
299
+ * Applies to fields DECLARED inside the host — projected content keeps the
300
+ * injector of the template it was written in, so wrapping `<ng-content>` in
301
+ * this directive does not reach the projected fields.
302
+ */
303
+ declare class ReserveMessagesDirective {
304
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ReserveMessagesDirective, never>;
305
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ReserveMessagesDirective, "[dsReserveMessages]", never, {}, {}, never, never, true, never>;
306
+ }
307
+
233
308
  type ButtonColor = 'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning';
234
309
  type ButtonVariant = 'solid' | 'tonal' | 'ghost' | 'outline' | 'text';
235
- type ButtonSize = 'sm' | 'md' | 'lg';
236
310
  type ButtonType = 'button' | 'submit' | 'reset';
237
311
 
238
312
  declare class ButtonComponent {
@@ -245,8 +319,8 @@ declare class ButtonComponent {
245
319
  cases needing the ds-button API (loading/fullWidth/typed pressed). */
246
320
  readonly variant: _angular_core.InputSignal<ButtonVariant>;
247
321
  /** Button height — sm/md/lg. */
248
- readonly size: _angular_core.InputSignal<ButtonSize>;
249
- /** Native `<button>` `type` attribute. */
322
+ readonly size: _angular_core.InputSignal<DsSize>;
323
+ /** Native `<button>` `type`; defaults to `'button'` (not `'submit'`) so it never submits an ancestor form by accident. */
250
324
  readonly type: _angular_core.InputSignal<ButtonType>;
251
325
  /** Disables the button and blocks `pressed`. */
252
326
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -298,7 +372,6 @@ declare class ToggleButtonComponent {
298
372
  }
299
373
 
300
374
  type IconButtonVariant = 'standard' | 'filled' | 'tonal' | 'outlined';
301
- type IconButtonSize = 'sm' | 'md' | 'lg';
302
375
  type IconButtonType = 'button' | 'submit' | 'reset';
303
376
 
304
377
  /**
@@ -318,8 +391,8 @@ declare class IconButtonComponent {
318
391
  axis; `color` recolours the accent the fill consumes. Default primary. */
319
392
  readonly color: _angular_core.InputSignal<ButtonColor>;
320
393
  /** Button size — sm/md/lg, matches the field/button height scale. */
321
- readonly size: _angular_core.InputSignal<IconButtonSize>;
322
- /** Native `button` type attribute. */
394
+ readonly size: _angular_core.InputSignal<DsSize>;
395
+ /** Native `<button>` `type`; defaults to `'button'` (not `'submit'`) so it never submits an ancestor form by accident. */
323
396
  readonly type: _angular_core.InputSignal<IconButtonType>;
324
397
  /** Disables the button and blocks `pressed`. */
325
398
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -345,12 +418,13 @@ declare class BadgeComponent {
345
418
  readonly count: _angular_core.InputSignal<number | null>;
346
419
  /** Count is capped at this value, shown as `"max+"` beyond it. */
347
420
  readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
348
- /** Display text for the count, capped at max+. */
421
+ /** Noun used in the count's accessible label — set for non-notification counts (cart, results, …). */
422
+ readonly countLabel: _angular_core.InputSignal<string>;
349
423
  protected readonly countDisplay: _angular_core.Signal<string | null>;
350
424
  protected readonly classes: _angular_core.Signal<string>;
351
425
  protected readonly countAriaLabel: _angular_core.Signal<string | null>;
352
426
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<BadgeComponent, never>;
353
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<BadgeComponent, "ds-badge", never, { "status": { "alias": "status"; "required": false; "isSignal": true; }; "withDot": { "alias": "withDot"; "required": false; "isSignal": true; }; "solid": { "alias": "solid"; "required": false; "isSignal": true; }; "count": { "alias": "count"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
427
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<BadgeComponent, "ds-badge", never, { "status": { "alias": "status"; "required": false; "isSignal": true; }; "withDot": { "alias": "withDot"; "required": false; "isSignal": true; }; "solid": { "alias": "solid"; "required": false; "isSignal": true; }; "count": { "alias": "count"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "countLabel": { "alias": "countLabel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
354
428
  }
355
429
 
356
430
  declare class StatusDotComponent {
@@ -363,62 +437,87 @@ declare class StatusDotComponent {
363
437
  }
364
438
 
365
439
  /**
366
- * Fixed-frame application shell: the host is pinned to the viewport
440
+ * Fixed-frame application layout: the host is pinned to the viewport
367
441
  * (`100dvh` + `overflow: hidden`) and ONLY the content region scrolls, so
368
442
  * the sidenav rail and the topbar stay put on pages taller than the
369
443
  * viewport. Consumers project their own chrome into the slots:
370
444
  *
371
445
  * ```html
372
- * <ds-app-shell>
446
+ * <ds-app-layout>
373
447
  * <ds-sidenav sidenav>…</ds-sidenav>
374
448
  * <ds-topbar topbar>…</ds-topbar>
375
449
  * <router-outlet />
376
- * </ds-app-shell>
450
+ * </ds-app-layout>
377
451
  * ```
378
452
  *
379
- * The shell renders the `<main>` landmark itself — do not nest another
380
- * `<main>` in the content. Scroll-to-top on navigation is built in
381
- * (`ShellScrollService`); the content padding auto-compensates the native
382
- * scrollbar width so the right inset always equals the left one. The shell
383
- * requires the application router (`provideRouter`) because its scroll-to-top
384
- * service subscribes to navigation events.
453
+ * The layout renders the `<main>` landmark itself — do not nest another
454
+ * `<main>` in the content. Scroll-to-top is built in (`LayoutScrollService`)
455
+ * and fires when navigation changes the PATH, so a URL-driven list can page
456
+ * and filter without losing the reader's place; inject the service and call
457
+ * `scrollToTop()` for the changes that do want the top. The content padding
458
+ * auto-compensates the native scrollbar width so the right inset always
459
+ * equals the left one. The layout requires the application router
460
+ * (`provideRouter`) because its scroll-to-top service subscribes to
461
+ * navigation events.
462
+ *
463
+ * Below the `lg` breakpoint the rail becomes a modal overlay driven by
464
+ * `[(railOpen)]`; put the burger wherever the design wants it inside your own
465
+ * projected topbar.
385
466
  */
386
- declare class AppShellComponent {
467
+ declare class AppLayoutComponent {
387
468
  /**
388
469
  * `'content'` (default): the rail spans the full viewport height on the
389
470
  * left and the topbar sits above the content column only. `'full'`: the
390
471
  * topbar spans the full width and the rail + content sit below it.
391
472
  */
392
473
  readonly topbarSpan: _angular_core.InputSignal<"content" | "full">;
393
- private readonly shellScroll;
474
+ /**
475
+ * Whether the rail is open as an overlay. Only meaningful below the `lg`
476
+ * breakpoint — above it the rail is always in the layout and this is
477
+ * ignored. Two-way, so a burger in your topbar can drive it.
478
+ */
479
+ readonly railOpen: _angular_core.ModelSignal<boolean>;
480
+ /** Accessible name for the rail while it is a modal overlay. */
481
+ readonly railLabel: _angular_core.InputSignal<string>;
482
+ /**
483
+ * True only while the rail is an overlay. Gates the dialog semantics: above
484
+ * the breakpoint the rail is an ordinary region, and a permanent
485
+ * `role="dialog"` there would lie to a screen reader.
486
+ */
487
+ protected readonly compact: _angular_core.WritableSignal<boolean>;
488
+ private readonly layoutScroll;
489
+ private readonly navigation;
490
+ private readonly destroyRef;
394
491
  private readonly content;
395
492
  constructor();
396
- static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppShellComponent, never>;
397
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppShellComponent, "ds-app-shell", never, { "topbarSpan": { "alias": "topbarSpan"; "required": false; "isSignal": true; }; }, {}, never, ["[sidenav]", "[topbar]", "*"], true, never>;
493
+ protected closeRail(): void;
494
+ private watchDesktopBreakpoint;
495
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppLayoutComponent, never>;
496
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppLayoutComponent, "ds-app-layout", never, { "topbarSpan": { "alias": "topbarSpan"; "required": false; "isSignal": true; }; "railOpen": { "alias": "railOpen"; "required": false; "isSignal": true; }; "railLabel": { "alias": "railLabel"; "required": false; "isSignal": true; }; }, { "railOpen": "railOpenChange"; }, never, ["[sidenav]", "[topbar]", "*"], true, never>;
398
497
  }
399
498
 
400
499
  /**
401
- * Owns the shell's content scroller. In the fixed-frame shell the window
500
+ * Owns the layout's content scroller. In the fixed-frame layout the window
402
501
  * never scrolls, so the router's built-in window-based scrolling no-ops —
403
- * this service resets the registered container to the top after every
404
- * navigation instead. Provided by `ds-app-shell`, so routed pages can
405
- * `inject(ShellScrollService)` and call `scrollToTop()` manually (e.g. list
406
- * pages resetting scroll on filter changes). Per-route scroll restoration is
407
- * a documented growth point — add it here if a page ever needs
408
- * back-navigation scroll memory.
502
+ * this service resets the registered container to the top when navigation
503
+ * lands on a different PATH instead. Provided by `ds-app-layout`, so routed
504
+ * pages can `inject(LayoutScrollService)` and call `scrollToTop()` manually
505
+ * (e.g. list pages that DO want the top after a filter change). Per-route
506
+ * scroll restoration is a documented growth point — add it here if a page
507
+ * ever needs back-navigation scroll memory.
409
508
  */
410
- declare class ShellScrollService {
411
- private readonly router;
509
+ declare class LayoutScrollService {
510
+ private readonly navigation;
412
511
  private readonly destroyRef;
413
512
  private scrollContainer;
414
513
  constructor();
415
514
  setScrollContainer(element: Element): void;
416
515
  scrollToTop(): void;
417
- static ɵfac: _angular_core.ɵɵFactoryDeclaration<ShellScrollService, never>;
418
- static ɵprov: _angular_core.ɵɵInjectableDeclaration<ShellScrollService>;
516
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<LayoutScrollService, never>;
517
+ static ɵprov: _angular_core.ɵɵInjectableDeclaration<LayoutScrollService>;
419
518
  }
420
519
 
421
- type AvatarSize = 'xs' | 'sm' | 'md' | 'lg';
520
+ type AvatarSize = 'xs' | DsSize;
422
521
  type AvatarStatus = 'online' | 'offline' | 'away' | 'busy';
423
522
 
424
523
  declare class AvatarComponent {
@@ -442,14 +541,50 @@ declare class AvatarComponent {
442
541
  readonly status: _angular_core.InputSignal<AvatarStatus | null>;
443
542
  /** Icon rendered when there is no imageUrl and no initials. */
444
543
  readonly fallbackIcon: _angular_core.InputSignal<IconName | null>;
544
+ /** Seed for a deterministic tint (e.g. an email or name) used when no explicit
545
+ * `tint` is set — the same seed always yields the same colour. */
546
+ readonly seed: _angular_core.InputSignal<string | null>;
547
+ /** Hue arcs `[start, end]` (0–360°) the seeded tint must avoid, e.g. a brand
548
+ * hue: `[[310, 360], [0, 20]]`. Only applies when `seed` drives the tint. */
549
+ readonly avoidHues: _angular_core.InputSignal<readonly (readonly [number, number])[]>;
445
550
  protected readonly tintStyle: _angular_core.Signal<{
446
551
  bg: string | null;
447
552
  fg: string | null;
448
553
  }>;
449
554
  protected readonly statusAriaLabel: _angular_core.Signal<string | null>;
450
555
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AvatarComponent, never>;
451
- 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; }; }, {}, never, never, true, never>;
452
- }
556
+ 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>;
557
+ }
558
+
559
+ /** Options for {@link avatarTint}. */
560
+ interface AvatarTintOptions {
561
+ /** Hue arcs (degrees, `[start, end]` with `start < end`, within 0–360) the
562
+ * derived hue must never land in — e.g. `[[310, 360], [0, 20]]` to skip a
563
+ * pink brand hue and reds. An arc crossing 0° must be given as two arcs.
564
+ * Default: none (full 0–360 range). */
565
+ avoidHues?: readonly (readonly [number, number])[];
566
+ /** OKLCH lightness percentage. Default 62. */
567
+ lightness?: number;
568
+ /** OKLCH chroma. Default 0.14. */
569
+ chroma?: number;
570
+ /** Text colour paired with the background. Default: auto — black or white,
571
+ * whichever reads best on the derived background (WCAG luminance). */
572
+ foreground?: string;
573
+ }
574
+ /** Deterministic `{ bg, fg }` tint for a seed string (an email, a name), so the
575
+ * same person always gets the same colour. The background is an OKLCH colour
576
+ * (perceptually even lightness across hues); the text defaults to whichever of
577
+ * black/white reads best on it. Pass to `ds-avatar`'s `tint`, or let the
578
+ * component derive it via its `seed` input. */
579
+ declare function avatarTint(seed: string, options?: AvatarTintOptions): {
580
+ bg: string;
581
+ fg: string;
582
+ };
583
+ /** Uppercased initials from the first two words. Accepts `(first, last)` parts
584
+ * or a single full name (`initialsFrom('Ada Lovelace')` → `AL`); a lone name
585
+ * gives one letter, `?` when empty. More than two words is rare — only the
586
+ * first two are used. */
587
+ declare function initialsFrom(first?: string, last?: string): string;
453
588
 
454
589
  declare class AvatarGroupComponent {
455
590
  /** Maximum avatars shown before the rest collapse into an overflow chip. */
@@ -623,20 +758,26 @@ declare abstract class DsBooleanControlValueAccessor implements ControlValueAcce
623
758
 
624
759
  type FieldMessageState = 'default' | 'error' | 'success';
625
760
 
626
- type InputSize = 'sm' | 'md' | 'lg';
627
761
  type InputType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search';
628
762
 
629
763
  declare class InputComponent extends DsControlValueAccessor<string> {
764
+ private readonly control;
630
765
  /** Text value, two-way bound. */
631
766
  readonly value: _angular_core.ModelSignal<string>;
632
767
  /** Native input type — also affects the default clear button and password toggle. */
633
768
  readonly type: _angular_core.InputSignal<InputType>;
634
769
  /** Field height — sm/md/lg. */
635
- readonly size: _angular_core.InputSignal<InputSize>;
770
+ readonly size: _angular_core.InputSignal<DsSize>;
636
771
  /** Label shown above the field, or inside it when `floating`. */
637
772
  readonly label: _angular_core.InputSignal<string>;
638
773
  /** Helper text shown below the field. */
639
774
  readonly hint: _angular_core.InputSignal<string>;
775
+ /** Reserve the message-row height even when empty, so the field doesn't shift
776
+ * the layout below it when a hint/error appears. Falls back to
777
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
778
+ * for a form that shows validation messages. */
779
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
780
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
640
781
  /** Placeholder shown when empty. */
641
782
  readonly placeholder: _angular_core.InputSignal<string>;
642
783
  /** Disables the field and blocks all interaction. */
@@ -653,10 +794,6 @@ declare class InputComponent extends DsControlValueAccessor<string> {
653
794
  /** Floating-label variant — the label sits inside a taller control instead
654
795
  * of stacked above it. */
655
796
  readonly floating: _angular_core.InputSignalWithTransform<boolean, unknown>;
656
- /** Reserves space for a leading addon projected into `[dsInputPrefix]`. */
657
- readonly withAddon: _angular_core.InputSignalWithTransform<boolean, unknown>;
658
- /** Reserves space for a trailing addon projected into `[dsInputSuffix]`. */
659
- readonly withAddonRight: _angular_core.InputSignalWithTransform<boolean, unknown>;
660
797
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
661
798
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
662
799
  /** Shows an "(optional)" marker next to the label (ignored when `required`). */
@@ -711,13 +848,14 @@ declare class InputComponent extends DsControlValueAccessor<string> {
711
848
  protected readonly effectiveType: _angular_core.Signal<InputType>;
712
849
  protected togglePassword(): void;
713
850
  protected readonly wrapperClasses: _angular_core.Signal<string>;
851
+ /** Move keyboard focus to the native input — public so a host can drive it
852
+ * deliberately, e.g. focusing the first invalid field on a failed submit. */
853
+ focus(options?: FocusOptions): void;
714
854
  protected clear(): void;
715
855
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<InputComponent, never>;
716
- 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; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "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; }; "withAddon": { "alias": "withAddon"; "required": false; "isSignal": true; }; "withAddonRight": { "alias": "withAddonRight"; "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; }; "maxLength": { "alias": "maxLength"; "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>;
856
+ 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; }; "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; }; "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; }; "maxLength": { "alias": "maxLength"; "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>;
717
857
  }
718
858
 
719
- type NumberStepperSize = 'sm' | 'md' | 'lg';
720
-
721
859
  declare class NumberStepperComponent {
722
860
  /** Current numeric value, two-way bound. */
723
861
  readonly value: _angular_core.ModelSignal<number>;
@@ -728,7 +866,7 @@ declare class NumberStepperComponent {
728
866
  /** Amount added or subtracted per increment/decrement. */
729
867
  readonly step: _angular_core.InputSignal<number>;
730
868
  /** Control height — sm/md/lg. */
731
- readonly size: _angular_core.InputSignal<NumberStepperSize>;
869
+ readonly size: _angular_core.InputSignal<DsSize>;
732
870
  /** Disables the stepper and blocks all interaction. */
733
871
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
734
872
  /** Accessible name for the number input (the stepper has no visible label). */
@@ -743,18 +881,24 @@ declare class NumberStepperComponent {
743
881
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<NumberStepperComponent, "ds-number-stepper", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
744
882
  }
745
883
 
746
- type TextareaSize = 'sm' | 'md' | 'lg';
747
884
  type TextareaResize = 'none' | 'vertical' | 'horizontal' | 'both';
748
885
 
749
886
  declare class TextareaComponent extends DsControlValueAccessor<string> {
887
+ private readonly control;
750
888
  /** Text value, two-way bound. */
751
889
  readonly value: _angular_core.ModelSignal<string>;
752
890
  /** Field height — sm/md/lg. */
753
- readonly size: _angular_core.InputSignal<TextareaSize>;
891
+ readonly size: _angular_core.InputSignal<DsSize>;
754
892
  /** Label shown above the field. */
755
893
  readonly label: _angular_core.InputSignal<string>;
756
894
  /** Helper text shown below the field. */
757
895
  readonly hint: _angular_core.InputSignal<string>;
896
+ /** Reserve the message-row height even when empty, so the field doesn't shift
897
+ * the layout below it when a hint/error appears. Falls back to
898
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
899
+ * for a form that shows validation messages. */
900
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
901
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
758
902
  /** Placeholder shown when empty. */
759
903
  readonly placeholder: _angular_core.InputSignal<string>;
760
904
  /** Disables the field and blocks all interaction. */
@@ -796,8 +940,11 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
796
940
  protected readonly autosizeMinHeight: _angular_core.Signal<string | null>;
797
941
  protected readonly autosizeMaxHeight: _angular_core.Signal<string | null>;
798
942
  protected readonly effectiveResize: _angular_core.Signal<TextareaResize>;
943
+ /** Move keyboard focus to the native textarea — public so a host can drive it
944
+ * deliberately, e.g. focusing the first invalid field on a failed submit. */
945
+ focus(options?: FocusOptions): void;
799
946
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextareaComponent, never>;
800
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextareaComponent, "ds-textarea", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "autosize": { "alias": "autosize"; "required": false; "isSignal": true; }; "minRows": { "alias": "minRows"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "resize": { "alias": "resize"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
947
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextareaComponent, "ds-textarea", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "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; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "autosize": { "alias": "autosize"; "required": false; "isSignal": true; }; "minRows": { "alias": "minRows"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "resize": { "alias": "resize"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
801
948
  }
802
949
 
803
950
  declare class SearchComponent {
@@ -813,13 +960,20 @@ declare class SearchComponent {
813
960
  readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
814
961
  /** Accessible name for the input (placeholder is not a reliable label). */
815
962
  readonly ariaLabel: _angular_core.InputSignal<string>;
963
+ /** Control height. `md` (default) keeps the 36px search-row height; `sm` (32px)
964
+ * aligns search with dense toolbars beside `sm` inputs/buttons; `lg` is touch. */
965
+ readonly size: _angular_core.InputSignal<DsSize>;
816
966
  /** Fires with the current value on Enter. */
817
967
  readonly submitted: _angular_core.OutputEmitterRef<string>;
818
968
  private readonly inputEl;
969
+ /** Move keyboard focus to the search input. Public so a host can hand focus
970
+ * over deliberately — e.g. a Clear button that disables itself on activation
971
+ * would otherwise blur into `<body>` and restart Tab order at the top. */
972
+ focus(options?: FocusOptions): void;
819
973
  protected onSubmit(): void;
820
974
  protected clear(): void;
821
975
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SearchComponent, never>;
822
- 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; }; }, { "value": "valueChange"; "submitted": "submitted"; }, never, never, true, never>;
976
+ 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>;
823
977
  }
824
978
 
825
979
  /** Showcase-only: renders the component's open/overlay surface inline in normal
@@ -831,7 +985,6 @@ declare class DsStaticPreview {
831
985
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsStaticPreview, never, never, { "staticPreview": { "alias": "staticPreview"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
832
986
  }
833
987
 
834
- type SelectSize = 'sm' | 'md' | 'lg';
835
988
  interface SelectOption {
836
989
  label: string;
837
990
  value: string;
@@ -858,7 +1011,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
858
1011
  /** Shown in the trigger when nothing is selected. */
859
1012
  readonly placeholder: _angular_core.InputSignal<string>;
860
1013
  /** Trigger height — sm/md/lg. */
861
- readonly size: _angular_core.InputSignal<SelectSize>;
1014
+ readonly size: _angular_core.InputSignal<DsSize>;
862
1015
  /** Label shown above the trigger. */
863
1016
  readonly label: _angular_core.InputSignal<string>;
864
1017
  /** Disables the trigger and blocks all interaction. */
@@ -869,6 +1022,12 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
869
1022
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
870
1023
  /** Helper text shown below the trigger. */
871
1024
  readonly hint: _angular_core.InputSignal<string>;
1025
+ /** Reserve the message-row height even when empty, so the field doesn't shift
1026
+ * the layout below it when a hint/error appears. Falls back to
1027
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
1028
+ * for a form that shows validation messages. */
1029
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
1030
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
872
1031
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
873
1032
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
874
1033
  /** Shows an "(optional)" marker next to the label (ignored when `required`). */
@@ -890,7 +1049,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
890
1049
  protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
891
1050
  /** Effective disabled — own `disabled` input OR the reactive-forms state. */
892
1051
  protected readonly isDisabled: _angular_core.Signal<boolean>;
893
- protected readonly trigger: _angular_core.Signal<ElementRef<HTMLButtonElement>>;
1052
+ protected readonly trigger: _angular_core.Signal<ElementRef<HTMLElement>>;
894
1053
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
895
1054
  protected readonly panelContentTpl: _angular_core.Signal<TemplateRef<unknown>>;
896
1055
  protected readonly open: _angular_core.WritableSignal<boolean>;
@@ -921,7 +1080,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
921
1080
  private firstEnabledIndex;
922
1081
  private lastEnabledIndex;
923
1082
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
924
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
1083
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
925
1084
  }
926
1085
 
927
1086
  /**
@@ -952,6 +1111,9 @@ declare class CellTemplateDirective {
952
1111
  interface TableColumn<T = unknown> {
953
1112
  key: string;
954
1113
  label: string;
1114
+ /** Visually-hidden accessible header name — use when `label` is
1115
+ * intentionally empty (e.g. an actions column). */
1116
+ srLabel?: string;
955
1117
  sortable?: boolean;
956
1118
  /** Include the column in `filterQuery` matching. When no column is marked,
957
1119
  * every column matches. Works on `hidden` columns too. */
@@ -967,6 +1129,14 @@ interface TableColumn<T = unknown> {
967
1129
  width?: number;
968
1130
  align?: 'left' | 'right' | 'center';
969
1131
  cell?: (row: T) => string;
1132
+ /** Sort this column by a DOMAIN value instead of the rendered text. Without
1133
+ * it, `clientSort` compares what the cell displays, so `$1.2M / $840K / $95K`
1134
+ * sorts by the leading character and `Oct 09, 2023 / Feb 27, 2024` sorts by
1135
+ * month NAME — the table looks sorted and is not. Return the underlying
1136
+ * number, `Date` or plain string; `null`/`undefined`/`''` counts as blank and
1137
+ * sorts last in BOTH directions. Only affects sorting — the header filter
1138
+ * still lists what the user can see. */
1139
+ sortValue?: (row: T) => string | number | Date | null | undefined;
970
1140
  /** Double-click the cell to edit it inline; the committed value is emitted
971
1141
  * via the table's `cellEdited` output (the consumer owns the data update). */
972
1142
  editable?: boolean;
@@ -1003,11 +1173,14 @@ interface TableCellEditEvent<T = unknown> {
1003
1173
  value: string;
1004
1174
  }
1005
1175
 
1006
- declare class TableComponent<T extends {
1007
- id: string;
1008
- }> {
1176
+ declare class TableComponent<T extends object> {
1009
1177
  /** Rows to render. */
1010
1178
  readonly data: _angular_core.InputSignal<readonly T[]>;
1179
+ /** Row identity used for tracking, selection, expansion and the active-row
1180
+ * highlight. Defaults to `row.id`; pass an accessor for display-only data
1181
+ * with no natural key (`[rowId]="row => row.channel + row.sentAt"`), which
1182
+ * beats mapping synthetic ids into the data just to satisfy the table. */
1183
+ readonly rowId: _angular_core.InputSignal<((row: T) => string) | null>;
1011
1184
  /** Column definitions driving headers, cells and sorting. */
1012
1185
  readonly columns: _angular_core.InputSignal<readonly TableColumn<T>[]>;
1013
1186
  /** Adds a checkbox column for row/select-all selection. */
@@ -1033,12 +1206,19 @@ declare class TableComponent<T extends {
1033
1206
  readonly density: _angular_core.InputSignal<"default" | "compact">;
1034
1207
  /** Tints odd rows for easier row-tracking across wide tables. */
1035
1208
  readonly zebra: _angular_core.InputSignalWithTransform<boolean, unknown>;
1209
+ /** Animate the body height when the row set changes (page/filter) instead of
1210
+ * snapping. Opt-in; instant under reduced-motion (the DS zeroes the token). */
1211
+ readonly animateHeight: _angular_core.InputSignalWithTransform<boolean, unknown>;
1036
1212
  /** Two-way set of currently selected row ids. */
1037
1213
  readonly selectedIds: _angular_core.ModelSignal<Set<string>>;
1038
1214
  /** Column key currently sorted by; `null` when unsorted. */
1039
1215
  readonly sortKey: _angular_core.ModelSignal<string | null>;
1040
1216
  /** Sort direction for `sortKey`. */
1041
1217
  readonly sortDir: _angular_core.ModelSignal<SortDir>;
1218
+ /** Sort states a column cycles through on click. Default includes null
1219
+ * (unsorted); pass ['asc','desc'] to forbid the unsorted state (e.g.
1220
+ * server-paged lists). */
1221
+ readonly sortingOrder: _angular_core.InputSignal<SortDir[]>;
1042
1222
  /** Number of shimmer rows rendered while `loading` is `'skeleton'`. */
1043
1223
  readonly skeletonRows: _angular_core.InputSignal<number>;
1044
1224
  /** Accessible name for the table (rendered as a visually-hidden caption).
@@ -1084,6 +1264,14 @@ declare class TableComponent<T extends {
1084
1264
  readonly page: _angular_core.ModelSignal<number>;
1085
1265
  /** Selectable page-size choices shown in the pagination control. */
1086
1266
  readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
1267
+ /** Server-side total row count. `null` (default) = client paging: the table
1268
+ * slices `data()` itself and the pager counts the rows in hand. When set, the
1269
+ * host has already sliced to one page — the pager uses this count and the
1270
+ * table renders `data()` as-is (no internal slice). */
1271
+ readonly total: _angular_core.InputSignal<number | null>;
1272
+ /** Scroll the table into view on a page change (opt-in) — keeps a bottom
1273
+ * pager from leaving the viewport on the previous page's last rows. */
1274
+ readonly scrollToTopOnPageChange: _angular_core.InputSignalWithTransform<boolean, unknown>;
1087
1275
  /** When true, the table sorts `data()` itself; otherwise it only emits
1088
1276
  * `sortChange` and leaves ordering to the consumer (default). */
1089
1277
  readonly clientSort: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -1101,10 +1289,10 @@ declare class TableComponent<T extends {
1101
1289
  /** Fires when an `editable` cell is committed (Enter or blur) with the new value. */
1102
1290
  readonly cellEdited: _angular_core.OutputEmitterRef<TableCellEditEvent<T>>;
1103
1291
  /** Cell templates supplied as an explicit map instead of (or in addition to)
1104
- * projected `dsCellTemplate` directives. Lets a wrapper component (e.g.
1105
- * ids-data-table) collect the directives itself and pass them down, since
1106
- * content projected through a wrapper's `<ng-content>` is not seen by this
1107
- * component's content query. Entries here override projected ones. */
1292
+ * projected `dsCellTemplate` directives. Lets a wrapper component collect
1293
+ * the directives itself and pass them down, since content projected through
1294
+ * a wrapper's `<ng-content>` is not seen by this component's content query.
1295
+ * Entries here override projected ones. */
1108
1296
  readonly cellTemplateMap: _angular_core.InputSignal<Record<string, TemplateRef<{
1109
1297
  $implicit: unknown;
1110
1298
  row: unknown;
@@ -1223,6 +1411,7 @@ declare class TableComponent<T extends {
1223
1411
  protected readonly hscrollContentWidth: _angular_core.WritableSignal<number>;
1224
1412
  protected readonly hscrollNeeded: _angular_core.WritableSignal<boolean>;
1225
1413
  constructor();
1414
+ private parseDurationMs;
1226
1415
  protected onRowMenuClick(row: T, event: Event): void;
1227
1416
  protected isMenuOpenFor(row: T): boolean;
1228
1417
  protected isActionDisabled(action: TableRowAction<T>): boolean;
@@ -1239,6 +1428,9 @@ declare class TableComponent<T extends {
1239
1428
  /** Accessible name for an interactive row, taken from the first visible column. */
1240
1429
  protected rowAriaLabel(row: T): string;
1241
1430
  /** `aria-sort` value for a header: only meaningful on sortable columns. */
1431
+ /** Row identity — the `rowId` accessor when given, else `row.id`. Public so a
1432
+ * host reading `selectedIds`/`expandedIds` can compute the same keys. */
1433
+ rowKey(row: T): string;
1242
1434
  protected ariaSort(col: TableColumn<T>): 'ascending' | 'descending' | 'none' | null;
1243
1435
  protected onSort(col: TableColumn<T>): void;
1244
1436
  protected headerClasses(col: TableColumn<T>): string;
@@ -1252,7 +1444,7 @@ declare class TableComponent<T extends {
1252
1444
  * across re-renders. Mixes column key + row index into one of five widths. */
1253
1445
  protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
1254
1446
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
1255
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "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; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDir": { "alias": "sortDir"; "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; }; "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; }; "clientSort": { "alias": "clientSort"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "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"; "pageSize": "pageSizeChange"; "page": "pageChange"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; }, ["cellTemplateDirectives"], ["[empty]", "[bulk-actions]"], true, never>;
1447
+ 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; }; "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; }; "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; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "clientSort": { "alias": "clientSort"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "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"; "pageSize": "pageSizeChange"; "page": "pageChange"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; }, ["cellTemplateDirectives"], ["[empty]", "[bulk-actions]"], true, never>;
1256
1448
  }
1257
1449
 
1258
1450
  declare class PaginationComponent {
@@ -1260,16 +1452,16 @@ declare class PaginationComponent {
1260
1452
  readonly total: _angular_core.InputSignal<number>;
1261
1453
  /** Items per page, two-way bound. */
1262
1454
  readonly pageSize: _angular_core.ModelSignal<number>;
1263
- /** 1-based active page, two-way bound. */
1455
+ /** 1-based active page, two-way bound; a page change (incl. the reset to 1
1456
+ * after a size change) emits via the implicit `currentPageChange`. */
1264
1457
  readonly currentPage: _angular_core.ModelSignal<number>;
1265
1458
  /** Preset choices offered in the page-size dropdown. */
1266
1459
  readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
1267
1460
  /** Shows the "Showing X–Y of Z" range label. */
1268
1461
  readonly showLabel: _angular_core.InputSignalWithTransform<boolean, unknown>;
1269
- /** Fires whenever the active page changes, including the reset to page 1 after a size change. */
1270
- readonly pageChange: _angular_core.OutputEmitterRef<number>;
1271
- /** Fires when the page size changes via the size dropdown. */
1272
- readonly pageSizeChange: _angular_core.OutputEmitterRef<number>;
1462
+ /** Shows the rows-per-page dropdown. Turn it off for a screen with a fixed
1463
+ * page size — otherwise the control offers a choice the host won't honour. */
1464
+ readonly showPageSize: _angular_core.InputSignalWithTransform<boolean, unknown>;
1273
1465
  protected readonly totalPages: _angular_core.Signal<number>;
1274
1466
  protected readonly pageItems: _angular_core.Signal<(number | "ellipsis")[]>;
1275
1467
  protected readonly rangeLabel: _angular_core.Signal<string>;
@@ -1281,7 +1473,7 @@ declare class PaginationComponent {
1281
1473
  protected goTo(page: number): void;
1282
1474
  protected onSizeChange(value: string): void;
1283
1475
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<PaginationComponent, never>;
1284
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<PaginationComponent, "ds-pagination", never, { "total": { "alias": "total"; "required": true; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "currentPage": { "alias": "currentPage"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; }, { "pageSize": "pageSizeChange"; "currentPage": "currentPageChange"; "pageChange": "pageChange"; "pageSizeChange": "pageSizeChange"; }, never, never, true, never>;
1476
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<PaginationComponent, "ds-pagination", never, { "total": { "alias": "total"; "required": true; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "currentPage": { "alias": "currentPage"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; }, { "pageSize": "pageSizeChange"; "currentPage": "currentPageChange"; }, never, never, true, never>;
1285
1477
  }
1286
1478
 
1287
1479
  interface DateFormatSpec {
@@ -1309,7 +1501,6 @@ interface DisplayPart {
1309
1501
  }
1310
1502
 
1311
1503
  type DatePickerMode = 'single' | 'range';
1312
- type DatePickerSize = 'sm' | 'md' | 'lg';
1313
1504
  type DateValue = Date | null;
1314
1505
  type RangeValue = [Date | null, Date | null];
1315
1506
  type DatePickerValue = DateValue | RangeValue;
@@ -1346,7 +1537,10 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1346
1537
  /** Selection mode — single date or start/end range. */
1347
1538
  readonly mode: _angular_core.InputSignal<DatePickerMode>;
1348
1539
  /** Trigger height — sm/md/lg. */
1349
- readonly size: _angular_core.InputSignal<DatePickerSize>;
1540
+ readonly size: _angular_core.InputSignal<DsSize>;
1541
+ /** Stretch the trigger to fill its container instead of hugging the mask
1542
+ * width — opt in when the field shares a grid/flex track with inputs. */
1543
+ readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
1350
1544
  /** Selected date (single) or `[start, end]` (range), two-way bound. */
1351
1545
  readonly value: _angular_core.ModelSignal<Date | RangeValue | null>;
1352
1546
  /** Accessible-name fallback only — the mask fills the visible placeholder, not this. */
@@ -1355,6 +1549,12 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1355
1549
  readonly label: _angular_core.InputSignal<string>;
1356
1550
  /** Helper text shown below the field. */
1357
1551
  readonly hint: _angular_core.InputSignal<string>;
1552
+ /** Reserve the message-row height even when empty, so the field doesn't shift
1553
+ * the layout below it when a hint/error appears. Falls back to
1554
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
1555
+ * for a form that shows validation messages. */
1556
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
1557
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
1358
1558
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
1359
1559
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1360
1560
  /** Shows an "(optional)" marker beside the label — ignored when `required` is set. */
@@ -1522,11 +1722,10 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1522
1722
  protected isPresetDisabled(preset: DatePickerPreset): boolean;
1523
1723
  protected applyPreset(preset: DatePickerPreset): void;
1524
1724
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DatePickerComponent, never>;
1525
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "ds-date-picker", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "minYear": { "alias": "minYear"; "required": false; "isSignal": true; }; "maxYear": { "alias": "maxYear"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "disabledDate": { "alias": "disabledDate"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "defaultDate": { "alias": "defaultDate"; "required": false; "isSignal": true; }; "allowInput": { "alias": "allowInput"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
1725
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "ds-date-picker", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "minYear": { "alias": "minYear"; "required": false; "isSignal": true; }; "maxYear": { "alias": "maxYear"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "disabledDate": { "alias": "disabledDate"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "defaultDate": { "alias": "defaultDate"; "required": false; "isSignal": true; }; "allowInput": { "alias": "allowInput"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
1526
1726
  }
1527
1727
 
1528
1728
  type TimePickerMode = 'single' | 'range';
1529
- type TimePickerSize = 'sm' | 'md' | 'lg';
1530
1729
  type TimeFormat = '24h' | '12h';
1531
1730
  /** Canonical stored value: 24h `"HH:MM"`. */
1532
1731
  type TimeValue = string;
@@ -1615,13 +1814,29 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1615
1814
  /** Predicate marking individual times unselectable. */
1616
1815
  readonly disabledTime: _angular_core.InputSignal<((time: string) => boolean) | null>;
1617
1816
  /** Trigger height — sm/md/lg. */
1618
- readonly size: _angular_core.InputSignal<TimePickerSize>;
1817
+ readonly size: _angular_core.InputSignal<DsSize>;
1818
+ /** Stretch the trigger to fill its container instead of hugging its content —
1819
+ * opt in when the field shares a grid/flex track with inputs. */
1820
+ readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
1821
+ /** Field label shown above the trigger — same row a `ds-date-picker` label
1822
+ * occupies, so date + time in one form row line up without a hand-rolled label. */
1823
+ readonly label: _angular_core.InputSignal<string>;
1824
+ /** Marks the field required — shows an asterisk and sets `aria-required`. */
1825
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1826
+ /** Shows an "(optional)" marker beside the label — ignored when `required` is set. */
1827
+ readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
1619
1828
  /** Disables the picker and blocks all interaction. */
1620
1829
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1621
1830
  /** Applies error styling and marks the trigger `aria-invalid`. */
1622
1831
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1623
1832
  /** Helper text shown below the picker. */
1624
1833
  readonly hint: _angular_core.InputSignal<string>;
1834
+ /** Reserve the message-row height even when empty, so the field doesn't shift
1835
+ * the layout below it when a hint/error appears. Falls back to
1836
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
1837
+ * for a form that shows validation messages. */
1838
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
1839
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
1625
1840
  /** Shown in the trigger when no time is set. */
1626
1841
  readonly placeholder: _angular_core.InputSignal<string>;
1627
1842
  /** Shows an inline clear button when a value is set — single mode only. */
@@ -1631,6 +1846,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1631
1846
  /** Override the DS-config format for this instance. */
1632
1847
  readonly format: _angular_core.InputSignal<TimeFormat | null>;
1633
1848
  protected readonly uid: string;
1849
+ protected readonly labelId: string;
1634
1850
  protected readonly openSegment: _angular_core.WritableSignal<Segment | null>;
1635
1851
  private overlayRef;
1636
1852
  protected readonly singleTrigger: _angular_core.Signal<ElementRef<HTMLButtonElement> | undefined>;
@@ -1666,7 +1882,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1666
1882
  private minutesOf;
1667
1883
  private laterOf;
1668
1884
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TimePickerComponent, never>;
1669
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimePickerComponent, "ds-time-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "disabledTime": { "alias": "disabledTime"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
1885
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimePickerComponent, "ds-time-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "disabledTime": { "alias": "disabledTime"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
1670
1886
  }
1671
1887
 
1672
1888
  interface BreadcrumbItem {
@@ -1783,13 +1999,19 @@ declare class SidenavItemComponent {
1783
1999
  readonly hasAlert: _angular_core.InputSignalWithTransform<boolean, unknown>;
1784
2000
  /** Disables the item — non-navigable and styled as inactive. */
1785
2001
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2002
+ /** Emitted on click, carrying the `MouseEvent`. On an `href` item,
2003
+ * `preventDefault()` intercepts navigation (e.g. a docs sidebar driving
2004
+ * scroll-spy); a `routerLink` item navigates regardless — Angular's
2005
+ * RouterLink ignores `defaultPrevented` — so treat it as a click hook there. */
2006
+ readonly activate: _angular_core.OutputEmitterRef<MouseEvent>;
1786
2007
  private readonly sidenav;
2008
+ protected onActivate(event: MouseEvent): void;
1787
2009
  /** Tooltip text shown when collapsed; empty string suppresses the tooltip when expanded. */
1788
2010
  protected readonly collapsedTooltip: _angular_core.Signal<string>;
1789
2011
  protected readonly collapsedAriaLabel: _angular_core.Signal<string | null>;
1790
2012
  protected readonly linkClasses: _angular_core.Signal<string>;
1791
2013
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavItemComponent, never>;
1792
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavItemComponent, "ds-sidenav-item", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "routerLink": { "alias": "routerLink"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "hasAlert": { "alias": "hasAlert"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, ["[icon]", "[trailing]"], true, never>;
2014
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavItemComponent, "ds-sidenav-item", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "href": { "alias": "href"; "required": false; "isSignal": true; }; "routerLink": { "alias": "routerLink"; "required": false; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; "badge": { "alias": "badge"; "required": false; "isSignal": true; }; "hasAlert": { "alias": "hasAlert"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "activate": "activate"; }, never, ["[icon]", "[trailing]"], true, never>;
1793
2015
  }
1794
2016
 
1795
2017
  interface SidenavItemModel {
@@ -1854,10 +2076,13 @@ interface SearchGroup {
1854
2076
  */
1855
2077
  declare class SidenavFooterComponent {
1856
2078
  private readonly router;
2079
+ /** Name shown in the footer's account row. */
1857
2080
  readonly userName: _angular_core.InputSignal<string>;
2081
+ /** Secondary line under the name (role / organisation). */
1858
2082
  readonly userRole: _angular_core.InputSignal<string>;
1859
2083
  /** Show the unread dot on the Alerts row. */
1860
2084
  readonly alerts: _angular_core.InputSignal<boolean>;
2085
+ /** Mirrors the rail's collapsed state — labels hide, the avatar + icons stay. */
1861
2086
  readonly collapsed: _angular_core.InputSignal<boolean>;
1862
2087
  /** When set, the Search row opens a live results popover; unset keeps it inert. */
1863
2088
  readonly searchProvider: _angular_core.InputSignal<SidenavSearchProvider | null>;
@@ -1906,10 +2131,10 @@ declare class PageHeaderComponent {
1906
2131
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<PageHeaderComponent, "ds-page-header", never, { "eyebrow": { "alias": "eyebrow"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "divider": { "alias": "divider"; "required": false; "isSignal": true; }; "metaDivider": { "alias": "metaDivider"; "required": false; "isSignal": true; }; }, {}, never, ["[breadcrumbs]", "[title-badge]", "[meta]", "[actions]", "[tabs]"], true, never>;
1907
2132
  }
1908
2133
 
1909
- type ModalSize = 'sm' | 'md' | 'lg' | 'xl' | 'fullscreen';
2134
+ type ModalSize = DsSize | 'xl' | 'fullscreen';
1910
2135
 
1911
2136
  declare class ModalComponent implements OnDestroy {
1912
- private readonly doc;
2137
+ private readonly scrollLock;
1913
2138
  protected readonly preview: DsStaticPreview;
1914
2139
  /** Open state, two-way bound. */
1915
2140
  readonly open: _angular_core.ModelSignal<boolean>;
@@ -1941,7 +2166,7 @@ declare class ModalComponent implements OnDestroy {
1941
2166
  protected onBackdrop(event: MouseEvent): void;
1942
2167
  protected onEscape(): void;
1943
2168
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalComponent, never>;
1944
- 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; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "persistent": { "alias": "persistent"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; "confirmed": "confirmed"; }, never, ["[body]", "[impact]", "[actions]"], true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
2169
+ 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; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "persistent": { "alias": "persistent"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; "confirmed": "confirmed"; }, never, ["[eyebrow]", "[body]", "[impact]", "[actions]"], true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
1945
2170
  }
1946
2171
 
1947
2172
  declare class ModalCardComponent {
@@ -1963,7 +2188,7 @@ declare class ModalCardComponent {
1963
2188
  protected readonly classes: _angular_core.Signal<string>;
1964
2189
  protected onClose(): void;
1965
2190
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalCardComponent, never>;
1966
- 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; }; "showClose": { "alias": "showClose"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "dialogRole": { "alias": "dialogRole"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["[body]", "[impact]", "[actions]"], true, never>;
2191
+ 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; }; "showClose": { "alias": "showClose"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "dialogRole": { "alias": "dialogRole"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["[eyebrow]", "[body]", "[impact]", "[actions]"], true, never>;
1967
2192
  }
1968
2193
 
1969
2194
  type ModalConfirmTone = 'default' | 'error';
@@ -2067,7 +2292,7 @@ declare class DropzoneComponent {
2067
2292
  protected readonly dragOver: _angular_core.WritableSignal<boolean>;
2068
2293
  /** Fires with the raw files picked or dropped; the consumer adds them to `files`. */
2069
2294
  readonly filesAdded: _angular_core.OutputEmitterRef<File[]>;
2070
- /** Fires when the user removes a file from the list. */
2295
+ /** Fires when the user removes a file; unlike `filesAdded`, the consumer must remove the matching entry from `files` itself. */
2071
2296
  readonly fileRemoved: _angular_core.OutputEmitterRef<DropzoneFile>;
2072
2297
  protected readonly classes: _angular_core.Signal<string>;
2073
2298
  protected onDragOver(event: DragEvent): void;
@@ -2102,7 +2327,9 @@ declare class MenuItemComponent implements OnDestroy {
2102
2327
  private readonly button;
2103
2328
  /** Leading icon shown before the projected label. */
2104
2329
  readonly icon: _angular_core.InputSignal<IconName | null>;
2105
- /** Disables the item and excludes it from `ds-menu`'s roving-tabindex navigation. */
2330
+ /** Blocks activation and styles the item as inactive. It stays
2331
+ * keyboard-focusable (`aria-disabled`, ARIA menu practice) and in `ds-menu`'s
2332
+ * roving order, so a `[dsTooltip]` explaining why can be reached and shown. */
2106
2333
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2107
2334
  /** Renders the item in an error/destructive style. */
2108
2335
  readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -2260,8 +2487,30 @@ declare class TooltipDirective implements OnDestroy {
2260
2487
  private ref;
2261
2488
  private timer;
2262
2489
  private readonly tipId;
2263
- protected onOpen(): void;
2490
+ /**
2491
+ * Where `aria-describedby` belongs, when focus is involved. A host that is not
2492
+ * focusable itself never reaches a screen reader — `ds-menu-item` carries
2493
+ * `role="none"` and puts the real `<button>` inside — so describing the host
2494
+ * describes something the user never focuses. `focusin` bubbles, so its target
2495
+ * IS whatever took focus; recording it is what keeps this directive out of the
2496
+ * host component's internal DOM. A pointer-only open leaves this null and
2497
+ * falls back to the host, where no screen reader is involved anyway.
2498
+ */
2499
+ private focusedTarget;
2500
+ /**
2501
+ * Where `aria-describedby` was actually written, remembered so teardown strips
2502
+ * it from the same element. Not derivable at teardown: focus can arrive after
2503
+ * the panel opened (hover, then click or arrow onto it), which moves
2504
+ * `focusedTarget` and would otherwise strand the attribute on the host,
2505
+ * pointing at a panel that no longer exists.
2506
+ */
2507
+ private describedElement;
2508
+ protected onPointerEnter(): void;
2509
+ protected onFocusIn(event: FocusEvent): void;
2510
+ protected onFocusOut(): void;
2511
+ private scheduleShow;
2264
2512
  protected onClose(): void;
2513
+ private disposeRef;
2265
2514
  protected onEscape(): void;
2266
2515
  private show;
2267
2516
  private positionFor;
@@ -2434,15 +2683,14 @@ interface DsToastConfig {
2434
2683
  }
2435
2684
  declare const DS_TOAST_CONFIG: InjectionToken<DsToastConfig>;
2436
2685
 
2437
- type DrawerSize = 'sm' | 'md' | 'lg';
2438
2686
  type DrawerPlacement = 'right' | 'left' | 'top' | 'bottom';
2439
2687
 
2440
2688
  declare class DrawerComponent implements OnDestroy {
2441
- private readonly doc;
2689
+ private readonly scrollLock;
2442
2690
  /** Open state, two-way bound. */
2443
2691
  readonly open: _angular_core.ModelSignal<boolean>;
2444
2692
  /** Panel size — sm/md/lg. */
2445
- readonly size: _angular_core.InputSignal<DrawerSize>;
2693
+ readonly size: _angular_core.InputSignal<DsSize>;
2446
2694
  /** Edge the panel slides in from. */
2447
2695
  readonly placement: _angular_core.InputSignal<DrawerPlacement>;
2448
2696
  /** Drawer title, shown in the header and used for `aria-labelledby`. */
@@ -2489,6 +2737,7 @@ declare class BottomSheetComponent implements OnDestroy {
2489
2737
  */
2490
2738
  readonly snapPoints: _angular_core.InputSignal<readonly number[]>;
2491
2739
  private readonly doc;
2740
+ private readonly scrollLock;
2492
2741
  private readonly sheetRef;
2493
2742
  protected readonly dragOffset: _angular_core.WritableSignal<number | null>;
2494
2743
  /** Sheet is in the DOM (kept true through the leave animation). */
@@ -2503,7 +2752,6 @@ declare class BottomSheetComponent implements OnDestroy {
2503
2752
  private lastMoveY;
2504
2753
  private lastMoveTime;
2505
2754
  private velocity;
2506
- private previousBodyOverflow;
2507
2755
  private wasOpen;
2508
2756
  private closeFallbackTimer;
2509
2757
  constructor();
@@ -2566,7 +2814,6 @@ declare class PageFooterComponent {
2566
2814
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<PageFooterComponent, "ds-page-footer", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["[brand]", "[nav]", "[actions]", "*"], true, never>;
2567
2815
  }
2568
2816
 
2569
- type AutocompleteSize = 'sm' | 'md' | 'lg';
2570
2817
  /** `fill` stretches to the host container (default); `content` hugs chips/value + a min typing area. */
2571
2818
  type AutocompleteWidth = 'fill' | 'content';
2572
2819
  interface AutocompleteOption<T = unknown> {
@@ -2594,7 +2841,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2594
2841
  /** Allows selecting more than one option, shown as removable tags. */
2595
2842
  readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
2596
2843
  /** Trigger height — sm/md/lg. */
2597
- readonly size: _angular_core.InputSignal<AutocompleteSize>;
2844
+ readonly size: _angular_core.InputSignal<DsSize>;
2598
2845
  /** Trigger width — `fill` stretches to the container, `content` hugs the value. */
2599
2846
  readonly width: _angular_core.InputSignal<AutocompleteWidth>;
2600
2847
  /** Placeholder shown in the input when empty. */
@@ -2605,6 +2852,12 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2605
2852
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2606
2853
  /** Helper text shown below the field. */
2607
2854
  readonly hint: _angular_core.InputSignal<string>;
2855
+ /** Reserve the message-row height even when empty, so the field doesn't shift
2856
+ * the layout below it when a hint/error appears. Falls back to
2857
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
2858
+ * for a form that shows validation messages. */
2859
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
2860
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
2608
2861
  /** Shows a "Create «text»" row when the typed text matches no option. */
2609
2862
  readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
2610
2863
  /** Accessible name for the combobox input. */
@@ -2652,7 +2905,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2652
2905
  protected onCreateNew(): void;
2653
2906
  protected remove(target: T): void;
2654
2907
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent<any>, never>;
2655
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionGroups": { "alias": "optionGroups"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "create": "create"; }, never, never, true, never>;
2908
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionGroups": { "alias": "optionGroups"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "create": "create"; }, never, never, true, never>;
2656
2909
  }
2657
2910
 
2658
2911
  type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
@@ -2694,7 +2947,7 @@ declare class DescriptionItemComponent {
2694
2947
  type LayoutGap = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
2695
2948
  type LayoutAlign = 'start' | 'center' | 'end' | 'stretch';
2696
2949
  type LayoutJustify = 'start' | 'center' | 'end' | 'between';
2697
- type ContainerSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
2950
+ type ContainerSize = DsSize | 'xl' | 'full';
2698
2951
 
2699
2952
  declare class StackComponent {
2700
2953
  readonly gap: _angular_core.InputSignal<LayoutGap | null>;
@@ -2839,6 +3092,12 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
2839
3092
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2840
3093
  /** Helper text shown below the cells. */
2841
3094
  readonly hint: _angular_core.InputSignal<string>;
3095
+ /** Reserve the message-row height even when empty, so the field doesn't shift
3096
+ * the layout below it when a hint/error appears. Falls back to
3097
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
3098
+ * for a form that shows validation messages. */
3099
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3100
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
2842
3101
  /** Accessible group label for the cell row. */
2843
3102
  readonly ariaLabel: _angular_core.InputSignal<string>;
2844
3103
  /** Fires once, with the full code, on the partial → complete transition. */
@@ -2863,7 +3122,7 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
2863
3122
  private focusBox;
2864
3123
  private sanitize;
2865
3124
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<OtpInputComponent, never>;
2866
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<OtpInputComponent, "ds-otp-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "length": { "alias": "length"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "completed": "completed"; }, never, never, true, never>;
3125
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<OtpInputComponent, "ds-otp-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "length": { "alias": "length"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "completed": "completed"; }, never, never, true, never>;
2867
3126
  }
2868
3127
 
2869
3128
  type SliderValue = number | readonly [number, number];
@@ -2886,6 +3145,12 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
2886
3145
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2887
3146
  /** Helper text shown below the slider. */
2888
3147
  readonly hint: _angular_core.InputSignal<string>;
3148
+ /** Reserve the message-row height even when empty, so the field doesn't shift
3149
+ * the layout below it when a hint/error appears. Falls back to
3150
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
3151
+ * for a form that shows validation messages. */
3152
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3153
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
2889
3154
  private readonly track;
2890
3155
  private dragging;
2891
3156
  protected readonly uid: string;
@@ -2911,11 +3176,9 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
2911
3176
  private setThumb;
2912
3177
  private snap;
2913
3178
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SliderComponent, never>;
2914
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SliderComponent, "ds-slider", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3179
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SliderComponent, "ds-slider", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
2915
3180
  }
2916
3181
 
2917
- type SpinnerSize = 'sm' | 'md' | 'lg';
2918
-
2919
3182
  declare class LoadingOverlayComponent {
2920
3183
  /** Show the scrim + spinner over the projected region. */
2921
3184
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -2924,7 +3187,7 @@ declare class LoadingOverlayComponent {
2924
3187
  /** Backdrop-blur the projected content behind the scrim. */
2925
3188
  readonly blur: _angular_core.InputSignalWithTransform<boolean, unknown>;
2926
3189
  /** Size of the spinner shown in the scrim. */
2927
- readonly spinnerSize: _angular_core.InputSignal<SpinnerSize>;
3190
+ readonly spinnerSize: _angular_core.InputSignal<DsSize>;
2928
3191
  /** Offset the scrim top edge — useful when a sticky header should stay uncovered. */
2929
3192
  readonly insetTop: _angular_core.InputSignal<string>;
2930
3193
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<LoadingOverlayComponent, never>;
@@ -2999,6 +3262,12 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
2999
3262
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3000
3263
  /** Helper text shown below the trigger. */
3001
3264
  readonly hint: _angular_core.InputSignal<string>;
3265
+ /** Reserve the message-row height even when empty, so the field doesn't shift
3266
+ * the layout below it when a hint/error appears. Falls back to
3267
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
3268
+ * for a form that shows validation messages. */
3269
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3270
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
3002
3271
  protected readonly trigger: _angular_core.Signal<ElementRef<HTMLButtonElement>>;
3003
3272
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
3004
3273
  protected readonly open: _angular_core.WritableSignal<boolean>;
@@ -3038,7 +3307,7 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
3038
3307
  private updateHue;
3039
3308
  private clampPct;
3040
3309
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColorPickerComponent, never>;
3041
- 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; }; }, { "value": "valueChange"; }, never, never, true, never>;
3310
+ 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; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3042
3311
  }
3043
3312
 
3044
3313
  interface MultiSelectOption {
@@ -3070,6 +3339,12 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
3070
3339
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3071
3340
  /** Helper text shown below the field. */
3072
3341
  readonly hint: _angular_core.InputSignal<string>;
3342
+ /** Reserve the message-row height even when empty, so the field doesn't shift
3343
+ * the layout below it when a hint/error appears. Falls back to
3344
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
3345
+ * for a form that shows validation messages. */
3346
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3347
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
3073
3348
  /** Accessible name for the trigger — falls back to `placeholder`. */
3074
3349
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
3075
3350
  /** Shows a "Select all" row that toggles every filter-matching, enabled option. */
@@ -3110,7 +3385,7 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
3110
3385
  protected close(): void;
3111
3386
  private moveActive;
3112
3387
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
3113
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3388
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3114
3389
  }
3115
3390
 
3116
3391
  declare class SkeletonComponent {
@@ -3128,13 +3403,11 @@ declare class SkeletonComponent {
3128
3403
 
3129
3404
  declare class SpinnerComponent {
3130
3405
  /** Spinner size — sm/md/lg. */
3131
- readonly size: _angular_core.InputSignal<SpinnerSize>;
3406
+ readonly size: _angular_core.InputSignal<DsSize>;
3132
3407
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SpinnerComponent, never>;
3133
3408
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<SpinnerComponent, "ds-spinner", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
3134
3409
  }
3135
3410
 
3136
- type CheckboxSize = 'sm' | 'md' | 'lg';
3137
-
3138
3411
  declare class CheckboxComponent extends DsBooleanControlValueAccessor {
3139
3412
  /** Checked state, two-way bound. */
3140
3413
  readonly checked: _angular_core.ModelSignal<boolean>;
@@ -3150,8 +3423,14 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
3150
3423
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3151
3424
  /** Helper text shown below the checkbox. */
3152
3425
  readonly hint: _angular_core.InputSignal<string>;
3426
+ /** Reserve the message-row height even when empty, so the field doesn't shift
3427
+ * the layout below it when a hint/error appears. Falls back to
3428
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
3429
+ * for a form that shows validation messages. */
3430
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3431
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
3153
3432
  /** Checkbox size — sm/md/lg. */
3154
- readonly size: _angular_core.InputSignal<CheckboxSize>;
3433
+ readonly size: _angular_core.InputSignal<DsSize>;
3155
3434
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
3156
3435
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
3157
3436
  /** Inline label rendered beside the box and wired via for/id. Omit to
@@ -3164,12 +3443,11 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
3164
3443
  protected readonly messageState: _angular_core.Signal<FieldMessageState>;
3165
3444
  protected readonly fieldClass: _angular_core.Signal<string>;
3166
3445
  protected onCheckedChange(event: Event): void;
3446
+ protected readonly devMode: boolean;
3167
3447
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<CheckboxComponent, never>;
3168
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxComponent, "ds-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, never, true, never>;
3448
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxComponent, "ds-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
3169
3449
  }
3170
3450
 
3171
- type RadioSize = 'sm' | 'md' | 'lg';
3172
-
3173
3451
  declare class RadioComponent {
3174
3452
  /** Standalone two-way binding. When inside ds-radio-group, isChecked() is
3175
3453
  * derived from the group value instead. */
@@ -3186,8 +3464,14 @@ declare class RadioComponent {
3186
3464
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3187
3465
  /** Helper text shown below the control. */
3188
3466
  readonly hint: _angular_core.InputSignal<string>;
3467
+ /** Reserve the message-row height even when empty, so the field doesn't shift
3468
+ * the layout below it when a hint/error appears. Falls back to
3469
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
3470
+ * for a form that shows validation messages. */
3471
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3472
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
3189
3473
  /** Control size — sm/md/lg. */
3190
- readonly size: _angular_core.InputSignal<RadioSize>;
3474
+ readonly size: _angular_core.InputSignal<DsSize>;
3191
3475
  /** Marks the radio required — shows an asterisk on the label and sets `aria-required`. */
3192
3476
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
3193
3477
  /** Inline label rendered beside the dot and wired via for/id. Omit to bring
@@ -3209,8 +3493,9 @@ declare class RadioComponent {
3209
3493
  /** Called by the group's keyboard handler to focus this radio's input. */
3210
3494
  focus(): void;
3211
3495
  protected onSelect(): void;
3496
+ protected readonly devMode: boolean;
3212
3497
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<RadioComponent, never>;
3213
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioComponent, "ds-radio", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, never, true, never>;
3498
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioComponent, "ds-radio", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
3214
3499
  }
3215
3500
 
3216
3501
  /** Contract that ds-radio reads from its parent ds-radio-group, injected via
@@ -3242,6 +3527,12 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
3242
3527
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3243
3528
  /** Helper text shown below the group. */
3244
3529
  readonly hint: _angular_core.InputSignal<string>;
3530
+ /** Reserve the message-row height even when empty, so the field doesn't shift
3531
+ * the layout below it when a hint/error appears. Falls back to
3532
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
3533
+ * for a form that shows validation messages. */
3534
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3535
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
3245
3536
  /** Accessible name for the group when no visible label is provided. */
3246
3537
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
3247
3538
  /** Visible group label; omit to supply your own. */
@@ -3257,11 +3548,9 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
3257
3548
  select(value: unknown): void;
3258
3549
  protected onKeydown(event: KeyboardEvent): void;
3259
3550
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<RadioGroupComponent, never>;
3260
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioGroupComponent, "ds-radio-group", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["radios"], ["*"], true, never>;
3551
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioGroupComponent, "ds-radio-group", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["radios"], ["*"], true, never>;
3261
3552
  }
3262
3553
 
3263
- type SwitchSize = 'sm' | 'md' | 'lg';
3264
-
3265
3554
  declare class SwitchComponent extends DsBooleanControlValueAccessor {
3266
3555
  /** On/off state, two-way bound. */
3267
3556
  readonly checked: _angular_core.ModelSignal<boolean>;
@@ -3277,8 +3566,14 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
3277
3566
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3278
3567
  /** Helper text shown below the switch. */
3279
3568
  readonly hint: _angular_core.InputSignal<string>;
3569
+ /** Reserve the message-row height even when empty, so the field doesn't shift
3570
+ * the layout below it when a hint/error appears. Falls back to
3571
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
3572
+ * for a form that shows validation messages. */
3573
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3574
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
3280
3575
  /** Switch size — sm/md/lg. */
3281
- readonly size: _angular_core.InputSignal<SwitchSize>;
3576
+ readonly size: _angular_core.InputSignal<DsSize>;
3282
3577
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
3283
3578
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
3284
3579
  /** Inline label rendered beside the track and wired via for/id. Omit to
@@ -3292,8 +3587,9 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
3292
3587
  protected readonly switchClasses: _angular_core.Signal<string>;
3293
3588
  protected readonly fieldClass: _angular_core.Signal<string>;
3294
3589
  protected onCheckedChange(event: Event): void;
3590
+ protected readonly devMode: boolean;
3295
3591
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SwitchComponent, never>;
3296
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SwitchComponent, "ds-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, never, true, never>;
3592
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SwitchComponent, "ds-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
3297
3593
  }
3298
3594
 
3299
3595
  /**
@@ -3313,5 +3609,5 @@ declare class FieldClickFocusDirective {
3313
3609
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
3314
3610
  }
3315
3611
 
3316
- export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppShellComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BottomSheetComponent, BrandNameDirective, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_ICON_REGISTRY, DS_TOAST_CONFIG, DS_TOAST_POSITION, DS_TOAST_POSITION_DEFAULT, DatePickerComponent, DescriptionItemComponent, DescriptionListComponent, DividerComponent, DrawerComponent, DropzoneComponent, DsOverlayCloseRef, DsStaticPreview, EmptyStateComponent, FieldClickFocusDirective, ICONS, IconButtonComponent, IconComponent, InlineComponent, InputComponent, ListComponent, ListItemComponent, LoadingOverlayComponent, MenuComponent, MenuDividerComponent, MenuItemComponent, ModalCardComponent, ModalComponent, ModalService, MultiSelectComponent, NumberStepperComponent, OtpInputComponent, PageFooterComponent, PageHeaderComponent, PaginationComponent, PopoverComponent, ProgressComponent, RADIO_GROUP, RadioComponent, RadioGroupComponent, SIDENAV, SearchComponent, SegmentedComponent, SelectComponent, ShellScrollService, 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, isSelectOptionGroup, provideDsConfig, provideDsIcons, provideDsTheme };
3317
- export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteOption, AutocompleteOptionGroup, AutocompleteSize, AutocompleteWidth, AvatarSize, AvatarStatus, BannerVariant, BreadcrumbItem, ButtonColor, ButtonSize, ButtonType, ButtonVariant, CardElevation, CardPadding, CheckboxSize, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerSpacing, DividerVariant, DrawerPlacement, DrawerSize, DropzoneFile, DropzoneFileState, DsConfig, DsIconRegistry, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, EmptyStateVariant, IconButtonSize, IconButtonType, IconButtonVariant, IconName, InputSize, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectOption, NumberStepperSize, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RadioSize, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, SelectSize, SidenavAlertItem, SidenavContract, SidenavItemModel, SidenavSearchProvider, SidenavSearchResult, SortChangeEvent, SortDir, SpinnerSize, SplitButtonItem, SplitButtonVariant, StepperLabelPosition, StepperOrientation, SwitchSize, TableCellEditEvent, TableColumn, TableRowAction, TableRowActionEvent, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TextareaSize, TimeFormat, TimePickerMode, TimePickerSize, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };
3612
+ export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppLayoutComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BodyScrollLockService, BottomSheetComponent, BrandNameDirective, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_ICON_REGISTRY, DS_TOAST_CONFIG, DS_TOAST_POSITION, DS_TOAST_POSITION_DEFAULT, DatePickerComponent, DescriptionItemComponent, DescriptionListComponent, DividerComponent, DrawerComponent, DropzoneComponent, DsOverlayCloseRef, DsStaticPreview, EmptyStateComponent, FieldClickFocusDirective, ICONS, IconButtonComponent, IconComponent, InlineComponent, InputComponent, LayoutScrollService, ListComponent, ListItemComponent, LoadingOverlayComponent, MenuComponent, MenuDividerComponent, MenuItemComponent, ModalCardComponent, ModalComponent, ModalService, MultiSelectComponent, NumberStepperComponent, OtpInputComponent, PageFooterComponent, PageHeaderComponent, PaginationComponent, PopoverComponent, ProgressComponent, RADIO_GROUP, RadioComponent, RadioGroupComponent, 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, provideDsConfig, provideDsIcons, provideDsTheme };
3613
+ 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, DsIconRegistry, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, EmptyStateVariant, 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, TableRowAction, TableRowActionEvent, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TimeFormat, TimePickerMode, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };