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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -161,6 +161,23 @@ declare abstract class DsOverlayCloseRef {
161
161
  abstract close(): void;
162
162
  }
163
163
 
164
+ /**
165
+ * Ref-counted lock on `document.body` scroll, shared by every overlay that
166
+ * covers the viewport (modal, drawer, bottom-sheet). The FIRST `lock()` saves
167
+ * the current `body` overflow and hides it; the LAST `unlock()` restores it —
168
+ * so closing one overlay never re-enables page scroll while another stacked on
169
+ * top of it is still open. Calls must be paired (one `unlock()` per `lock()`).
170
+ */
171
+ declare class BodyScrollLockService {
172
+ private readonly doc;
173
+ private count;
174
+ private previousOverflow;
175
+ lock(): void;
176
+ unlock(): void;
177
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<BodyScrollLockService, never>;
178
+ static ɵprov: _angular_core.ɵɵInjectableDeclaration<BodyScrollLockService>;
179
+ }
180
+
164
181
  /** Canonical status vocabulary shared across status-bearing components. */
165
182
  type DsStatus = 'info' | 'success' | 'warning' | 'error';
166
183
  /**
@@ -184,9 +201,14 @@ interface DsStatusRegistry {
184
201
  * open `string`; once a consumer augments DsStatusRegistry it narrows to the
185
202
  * union of their keys (autocomplete). The tuple wrap avoids `never` distribution.
186
203
  */
187
- type DsStatusKey = [
188
- keyof DsStatusRegistry
189
- ] extends [never] ? string : keyof DsStatusRegistry;
204
+ type DsStatusKey = [keyof DsStatusRegistry] extends [never] ? string : keyof DsStatusRegistry;
205
+
206
+ /**
207
+ * Canonical control-size scale — the shared vocabulary components bind their
208
+ * `size` input to. A component that needs extra steps extends this base with its
209
+ * own (component-named) type, kept inside that component.
210
+ */
211
+ type DsSize = 'sm' | 'md' | 'lg';
190
212
 
191
213
  declare class IconComponent {
192
214
  private readonly sanitizer;
@@ -232,7 +254,6 @@ declare function provideDsIcons(icons: DsIconRegistry): Provider;
232
254
 
233
255
  type ButtonColor = 'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning';
234
256
  type ButtonVariant = 'solid' | 'tonal' | 'ghost' | 'outline' | 'text';
235
- type ButtonSize = 'sm' | 'md' | 'lg';
236
257
  type ButtonType = 'button' | 'submit' | 'reset';
237
258
 
238
259
  declare class ButtonComponent {
@@ -245,8 +266,8 @@ declare class ButtonComponent {
245
266
  cases needing the ds-button API (loading/fullWidth/typed pressed). */
246
267
  readonly variant: _angular_core.InputSignal<ButtonVariant>;
247
268
  /** Button height — sm/md/lg. */
248
- readonly size: _angular_core.InputSignal<ButtonSize>;
249
- /** Native `<button>` `type` attribute. */
269
+ readonly size: _angular_core.InputSignal<DsSize>;
270
+ /** Native `<button>` `type`; defaults to `'button'` (not `'submit'`) so it never submits an ancestor form by accident. */
250
271
  readonly type: _angular_core.InputSignal<ButtonType>;
251
272
  /** Disables the button and blocks `pressed`. */
252
273
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -298,7 +319,6 @@ declare class ToggleButtonComponent {
298
319
  }
299
320
 
300
321
  type IconButtonVariant = 'standard' | 'filled' | 'tonal' | 'outlined';
301
- type IconButtonSize = 'sm' | 'md' | 'lg';
302
322
  type IconButtonType = 'button' | 'submit' | 'reset';
303
323
 
304
324
  /**
@@ -318,8 +338,8 @@ declare class IconButtonComponent {
318
338
  axis; `color` recolours the accent the fill consumes. Default primary. */
319
339
  readonly color: _angular_core.InputSignal<ButtonColor>;
320
340
  /** Button size — sm/md/lg, matches the field/button height scale. */
321
- readonly size: _angular_core.InputSignal<IconButtonSize>;
322
- /** Native `button` type attribute. */
341
+ readonly size: _angular_core.InputSignal<DsSize>;
342
+ /** Native `<button>` `type`; defaults to `'button'` (not `'submit'`) so it never submits an ancestor form by accident. */
323
343
  readonly type: _angular_core.InputSignal<IconButtonType>;
324
344
  /** Disables the button and blocks `pressed`. */
325
345
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -345,12 +365,13 @@ declare class BadgeComponent {
345
365
  readonly count: _angular_core.InputSignal<number | null>;
346
366
  /** Count is capped at this value, shown as `"max+"` beyond it. */
347
367
  readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
348
- /** Display text for the count, capped at max+. */
368
+ /** Noun used in the count's accessible label — set for non-notification counts (cart, results, …). */
369
+ readonly countLabel: _angular_core.InputSignal<string>;
349
370
  protected readonly countDisplay: _angular_core.Signal<string | null>;
350
371
  protected readonly classes: _angular_core.Signal<string>;
351
372
  protected readonly countAriaLabel: _angular_core.Signal<string | null>;
352
373
  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>;
374
+ 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
375
  }
355
376
 
356
377
  declare class StatusDotComponent {
@@ -363,62 +384,62 @@ declare class StatusDotComponent {
363
384
  }
364
385
 
365
386
  /**
366
- * Fixed-frame application shell: the host is pinned to the viewport
387
+ * Fixed-frame application layout: the host is pinned to the viewport
367
388
  * (`100dvh` + `overflow: hidden`) and ONLY the content region scrolls, so
368
389
  * the sidenav rail and the topbar stay put on pages taller than the
369
390
  * viewport. Consumers project their own chrome into the slots:
370
391
  *
371
392
  * ```html
372
- * <ds-app-shell>
393
+ * <ds-app-layout>
373
394
  * <ds-sidenav sidenav>…</ds-sidenav>
374
395
  * <ds-topbar topbar>…</ds-topbar>
375
396
  * <router-outlet />
376
- * </ds-app-shell>
397
+ * </ds-app-layout>
377
398
  * ```
378
399
  *
379
- * The shell renders the `<main>` landmark itself — do not nest another
400
+ * The layout renders the `<main>` landmark itself — do not nest another
380
401
  * `<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
402
+ * (`LayoutScrollService`); the content padding auto-compensates the native
403
+ * scrollbar width so the right inset always equals the left one. The layout
383
404
  * requires the application router (`provideRouter`) because its scroll-to-top
384
405
  * service subscribes to navigation events.
385
406
  */
386
- declare class AppShellComponent {
407
+ declare class AppLayoutComponent {
387
408
  /**
388
409
  * `'content'` (default): the rail spans the full viewport height on the
389
410
  * left and the topbar sits above the content column only. `'full'`: the
390
411
  * topbar spans the full width and the rail + content sit below it.
391
412
  */
392
413
  readonly topbarSpan: _angular_core.InputSignal<"content" | "full">;
393
- private readonly shellScroll;
414
+ private readonly layoutScroll;
394
415
  private readonly content;
395
416
  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>;
417
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppLayoutComponent, never>;
418
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppLayoutComponent, "ds-app-layout", never, { "topbarSpan": { "alias": "topbarSpan"; "required": false; "isSignal": true; }; }, {}, never, ["[sidenav]", "[topbar]", "*"], true, never>;
398
419
  }
399
420
 
400
421
  /**
401
- * Owns the shell's content scroller. In the fixed-frame shell the window
422
+ * Owns the layout's content scroller. In the fixed-frame layout the window
402
423
  * never scrolls, so the router's built-in window-based scrolling no-ops —
403
424
  * 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
425
+ * navigation instead. Provided by `ds-app-layout`, so routed pages can
426
+ * `inject(LayoutScrollService)` and call `scrollToTop()` manually (e.g. list
406
427
  * pages resetting scroll on filter changes). Per-route scroll restoration is
407
428
  * a documented growth point — add it here if a page ever needs
408
429
  * back-navigation scroll memory.
409
430
  */
410
- declare class ShellScrollService {
431
+ declare class LayoutScrollService {
411
432
  private readonly router;
412
433
  private readonly destroyRef;
413
434
  private scrollContainer;
414
435
  constructor();
415
436
  setScrollContainer(element: Element): void;
416
437
  scrollToTop(): void;
417
- static ɵfac: _angular_core.ɵɵFactoryDeclaration<ShellScrollService, never>;
418
- static ɵprov: _angular_core.ɵɵInjectableDeclaration<ShellScrollService>;
438
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<LayoutScrollService, never>;
439
+ static ɵprov: _angular_core.ɵɵInjectableDeclaration<LayoutScrollService>;
419
440
  }
420
441
 
421
- type AvatarSize = 'xs' | 'sm' | 'md' | 'lg';
442
+ type AvatarSize = 'xs' | DsSize;
422
443
  type AvatarStatus = 'online' | 'offline' | 'away' | 'busy';
423
444
 
424
445
  declare class AvatarComponent {
@@ -442,14 +463,50 @@ declare class AvatarComponent {
442
463
  readonly status: _angular_core.InputSignal<AvatarStatus | null>;
443
464
  /** Icon rendered when there is no imageUrl and no initials. */
444
465
  readonly fallbackIcon: _angular_core.InputSignal<IconName | null>;
466
+ /** Seed for a deterministic tint (e.g. an email or name) used when no explicit
467
+ * `tint` is set — the same seed always yields the same colour. */
468
+ readonly seed: _angular_core.InputSignal<string | null>;
469
+ /** Hue arcs `[start, end]` (0–360°) the seeded tint must avoid, e.g. a brand
470
+ * hue: `[[310, 360], [0, 20]]`. Only applies when `seed` drives the tint. */
471
+ readonly avoidHues: _angular_core.InputSignal<readonly (readonly [number, number])[]>;
445
472
  protected readonly tintStyle: _angular_core.Signal<{
446
473
  bg: string | null;
447
474
  fg: string | null;
448
475
  }>;
449
476
  protected readonly statusAriaLabel: _angular_core.Signal<string | null>;
450
477
  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
- }
478
+ 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>;
479
+ }
480
+
481
+ /** Options for {@link avatarTint}. */
482
+ interface AvatarTintOptions {
483
+ /** Hue arcs (degrees, `[start, end]` with `start < end`, within 0–360) the
484
+ * derived hue must never land in — e.g. `[[310, 360], [0, 20]]` to skip a
485
+ * pink brand hue and reds. An arc crossing 0° must be given as two arcs.
486
+ * Default: none (full 0–360 range). */
487
+ avoidHues?: readonly (readonly [number, number])[];
488
+ /** OKLCH lightness percentage. Default 62. */
489
+ lightness?: number;
490
+ /** OKLCH chroma. Default 0.14. */
491
+ chroma?: number;
492
+ /** Text colour paired with the background. Default: auto — black or white,
493
+ * whichever reads best on the derived background (WCAG luminance). */
494
+ foreground?: string;
495
+ }
496
+ /** Deterministic `{ bg, fg }` tint for a seed string (an email, a name), so the
497
+ * same person always gets the same colour. The background is an OKLCH colour
498
+ * (perceptually even lightness across hues); the text defaults to whichever of
499
+ * black/white reads best on it. Pass to `ds-avatar`'s `tint`, or let the
500
+ * component derive it via its `seed` input. */
501
+ declare function avatarTint(seed: string, options?: AvatarTintOptions): {
502
+ bg: string;
503
+ fg: string;
504
+ };
505
+ /** Uppercased initials from the first two words. Accepts `(first, last)` parts
506
+ * or a single full name (`initialsFrom('Ada Lovelace')` → `AL`); a lone name
507
+ * gives one letter, `?` when empty. More than two words is rare — only the
508
+ * first two are used. */
509
+ declare function initialsFrom(first?: string, last?: string): string;
453
510
 
454
511
  declare class AvatarGroupComponent {
455
512
  /** Maximum avatars shown before the rest collapse into an overflow chip. */
@@ -623,7 +680,6 @@ declare abstract class DsBooleanControlValueAccessor implements ControlValueAcce
623
680
 
624
681
  type FieldMessageState = 'default' | 'error' | 'success';
625
682
 
626
- type InputSize = 'sm' | 'md' | 'lg';
627
683
  type InputType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search';
628
684
 
629
685
  declare class InputComponent extends DsControlValueAccessor<string> {
@@ -632,11 +688,15 @@ declare class InputComponent extends DsControlValueAccessor<string> {
632
688
  /** Native input type — also affects the default clear button and password toggle. */
633
689
  readonly type: _angular_core.InputSignal<InputType>;
634
690
  /** Field height — sm/md/lg. */
635
- readonly size: _angular_core.InputSignal<InputSize>;
691
+ readonly size: _angular_core.InputSignal<DsSize>;
636
692
  /** Label shown above the field, or inside it when `floating`. */
637
693
  readonly label: _angular_core.InputSignal<string>;
638
694
  /** Helper text shown below the field. */
639
695
  readonly hint: _angular_core.InputSignal<string>;
696
+ /** Reserve the message-row height even when empty, so the field doesn't shift
697
+ * the layout below it when a hint/error appears. Default on — opt out for a
698
+ * deliberately collapsing field. */
699
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
640
700
  /** Placeholder shown when empty. */
641
701
  readonly placeholder: _angular_core.InputSignal<string>;
642
702
  /** Disables the field and blocks all interaction. */
@@ -653,10 +713,6 @@ declare class InputComponent extends DsControlValueAccessor<string> {
653
713
  /** Floating-label variant — the label sits inside a taller control instead
654
714
  * of stacked above it. */
655
715
  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
716
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
661
717
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
662
718
  /** Shows an "(optional)" marker next to the label (ignored when `required`). */
@@ -713,11 +769,9 @@ declare class InputComponent extends DsControlValueAccessor<string> {
713
769
  protected readonly wrapperClasses: _angular_core.Signal<string>;
714
770
  protected clear(): void;
715
771
  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>;
772
+ 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
773
  }
718
774
 
719
- type NumberStepperSize = 'sm' | 'md' | 'lg';
720
-
721
775
  declare class NumberStepperComponent {
722
776
  /** Current numeric value, two-way bound. */
723
777
  readonly value: _angular_core.ModelSignal<number>;
@@ -728,7 +782,7 @@ declare class NumberStepperComponent {
728
782
  /** Amount added or subtracted per increment/decrement. */
729
783
  readonly step: _angular_core.InputSignal<number>;
730
784
  /** Control height — sm/md/lg. */
731
- readonly size: _angular_core.InputSignal<NumberStepperSize>;
785
+ readonly size: _angular_core.InputSignal<DsSize>;
732
786
  /** Disables the stepper and blocks all interaction. */
733
787
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
734
788
  /** Accessible name for the number input (the stepper has no visible label). */
@@ -743,18 +797,21 @@ declare class NumberStepperComponent {
743
797
  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
798
  }
745
799
 
746
- type TextareaSize = 'sm' | 'md' | 'lg';
747
800
  type TextareaResize = 'none' | 'vertical' | 'horizontal' | 'both';
748
801
 
749
802
  declare class TextareaComponent extends DsControlValueAccessor<string> {
750
803
  /** Text value, two-way bound. */
751
804
  readonly value: _angular_core.ModelSignal<string>;
752
805
  /** Field height — sm/md/lg. */
753
- readonly size: _angular_core.InputSignal<TextareaSize>;
806
+ readonly size: _angular_core.InputSignal<DsSize>;
754
807
  /** Label shown above the field. */
755
808
  readonly label: _angular_core.InputSignal<string>;
756
809
  /** Helper text shown below the field. */
757
810
  readonly hint: _angular_core.InputSignal<string>;
811
+ /** Reserve the message-row height even when empty, so the field doesn't shift
812
+ * the layout below it when a hint/error appears. Default on — opt out for a
813
+ * deliberately collapsing field. */
814
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
758
815
  /** Placeholder shown when empty. */
759
816
  readonly placeholder: _angular_core.InputSignal<string>;
760
817
  /** Disables the field and blocks all interaction. */
@@ -797,7 +854,7 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
797
854
  protected readonly autosizeMaxHeight: _angular_core.Signal<string | null>;
798
855
  protected readonly effectiveResize: _angular_core.Signal<TextareaResize>;
799
856
  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>;
857
+ 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
858
  }
802
859
 
803
860
  declare class SearchComponent {
@@ -813,13 +870,16 @@ declare class SearchComponent {
813
870
  readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
814
871
  /** Accessible name for the input (placeholder is not a reliable label). */
815
872
  readonly ariaLabel: _angular_core.InputSignal<string>;
873
+ /** Control height. `md` (default) keeps the 36px search-row height; `sm` (32px)
874
+ * aligns search with dense toolbars beside `sm` inputs/buttons; `lg` is touch. */
875
+ readonly size: _angular_core.InputSignal<DsSize>;
816
876
  /** Fires with the current value on Enter. */
817
877
  readonly submitted: _angular_core.OutputEmitterRef<string>;
818
878
  private readonly inputEl;
819
879
  protected onSubmit(): void;
820
880
  protected clear(): void;
821
881
  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>;
882
+ 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
883
  }
824
884
 
825
885
  /** Showcase-only: renders the component's open/overlay surface inline in normal
@@ -831,7 +891,6 @@ declare class DsStaticPreview {
831
891
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsStaticPreview, never, never, { "staticPreview": { "alias": "staticPreview"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
832
892
  }
833
893
 
834
- type SelectSize = 'sm' | 'md' | 'lg';
835
894
  interface SelectOption {
836
895
  label: string;
837
896
  value: string;
@@ -858,7 +917,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
858
917
  /** Shown in the trigger when nothing is selected. */
859
918
  readonly placeholder: _angular_core.InputSignal<string>;
860
919
  /** Trigger height — sm/md/lg. */
861
- readonly size: _angular_core.InputSignal<SelectSize>;
920
+ readonly size: _angular_core.InputSignal<DsSize>;
862
921
  /** Label shown above the trigger. */
863
922
  readonly label: _angular_core.InputSignal<string>;
864
923
  /** Disables the trigger and blocks all interaction. */
@@ -869,6 +928,10 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
869
928
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
870
929
  /** Helper text shown below the trigger. */
871
930
  readonly hint: _angular_core.InputSignal<string>;
931
+ /** Reserve the message-row height even when empty, so the field doesn't shift
932
+ * the layout below it when a hint/error appears. Default on — opt out for a
933
+ * deliberately collapsing field. */
934
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
872
935
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
873
936
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
874
937
  /** Shows an "(optional)" marker next to the label (ignored when `required`). */
@@ -890,7 +953,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
890
953
  protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
891
954
  /** Effective disabled — own `disabled` input OR the reactive-forms state. */
892
955
  protected readonly isDisabled: _angular_core.Signal<boolean>;
893
- protected readonly trigger: _angular_core.Signal<ElementRef<HTMLButtonElement>>;
956
+ protected readonly trigger: _angular_core.Signal<ElementRef<HTMLElement>>;
894
957
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
895
958
  protected readonly panelContentTpl: _angular_core.Signal<TemplateRef<unknown>>;
896
959
  protected readonly open: _angular_core.WritableSignal<boolean>;
@@ -921,7 +984,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
921
984
  private firstEnabledIndex;
922
985
  private lastEnabledIndex;
923
986
  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: {}; }]>;
987
+ 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
988
  }
926
989
 
927
990
  /**
@@ -952,6 +1015,9 @@ declare class CellTemplateDirective {
952
1015
  interface TableColumn<T = unknown> {
953
1016
  key: string;
954
1017
  label: string;
1018
+ /** Visually-hidden accessible header name — use when `label` is
1019
+ * intentionally empty (e.g. an actions column). */
1020
+ srLabel?: string;
955
1021
  sortable?: boolean;
956
1022
  /** Include the column in `filterQuery` matching. When no column is marked,
957
1023
  * every column matches. Works on `hidden` columns too. */
@@ -1033,12 +1099,19 @@ declare class TableComponent<T extends {
1033
1099
  readonly density: _angular_core.InputSignal<"default" | "compact">;
1034
1100
  /** Tints odd rows for easier row-tracking across wide tables. */
1035
1101
  readonly zebra: _angular_core.InputSignalWithTransform<boolean, unknown>;
1102
+ /** Animate the body height when the row set changes (page/filter) instead of
1103
+ * snapping. Opt-in; instant under reduced-motion (the DS zeroes the token). */
1104
+ readonly animateHeight: _angular_core.InputSignalWithTransform<boolean, unknown>;
1036
1105
  /** Two-way set of currently selected row ids. */
1037
1106
  readonly selectedIds: _angular_core.ModelSignal<Set<string>>;
1038
1107
  /** Column key currently sorted by; `null` when unsorted. */
1039
1108
  readonly sortKey: _angular_core.ModelSignal<string | null>;
1040
1109
  /** Sort direction for `sortKey`. */
1041
1110
  readonly sortDir: _angular_core.ModelSignal<SortDir>;
1111
+ /** Sort states a column cycles through on click. Default includes null
1112
+ * (unsorted); pass ['asc','desc'] to forbid the unsorted state (e.g.
1113
+ * server-paged lists). */
1114
+ readonly sortingOrder: _angular_core.InputSignal<SortDir[]>;
1042
1115
  /** Number of shimmer rows rendered while `loading` is `'skeleton'`. */
1043
1116
  readonly skeletonRows: _angular_core.InputSignal<number>;
1044
1117
  /** Accessible name for the table (rendered as a visually-hidden caption).
@@ -1084,6 +1157,14 @@ declare class TableComponent<T extends {
1084
1157
  readonly page: _angular_core.ModelSignal<number>;
1085
1158
  /** Selectable page-size choices shown in the pagination control. */
1086
1159
  readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
1160
+ /** Server-side total row count. `null` (default) = client paging: the table
1161
+ * slices `data()` itself and the pager counts the rows in hand. When set, the
1162
+ * host has already sliced to one page — the pager uses this count and the
1163
+ * table renders `data()` as-is (no internal slice). */
1164
+ readonly total: _angular_core.InputSignal<number | null>;
1165
+ /** Scroll the table into view on a page change (opt-in) — keeps a bottom
1166
+ * pager from leaving the viewport on the previous page's last rows. */
1167
+ readonly scrollToTopOnPageChange: _angular_core.InputSignalWithTransform<boolean, unknown>;
1087
1168
  /** When true, the table sorts `data()` itself; otherwise it only emits
1088
1169
  * `sortChange` and leaves ordering to the consumer (default). */
1089
1170
  readonly clientSort: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -1223,6 +1304,7 @@ declare class TableComponent<T extends {
1223
1304
  protected readonly hscrollContentWidth: _angular_core.WritableSignal<number>;
1224
1305
  protected readonly hscrollNeeded: _angular_core.WritableSignal<boolean>;
1225
1306
  constructor();
1307
+ private parseDurationMs;
1226
1308
  protected onRowMenuClick(row: T, event: Event): void;
1227
1309
  protected isMenuOpenFor(row: T): boolean;
1228
1310
  protected isActionDisabled(action: TableRowAction<T>): boolean;
@@ -1252,7 +1334,7 @@ declare class TableComponent<T extends {
1252
1334
  * across re-renders. Mixes column key + row index into one of five widths. */
1253
1335
  protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
1254
1336
  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>;
1337
+ 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; }; "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
1338
  }
1257
1339
 
1258
1340
  declare class PaginationComponent {
@@ -1260,16 +1342,13 @@ declare class PaginationComponent {
1260
1342
  readonly total: _angular_core.InputSignal<number>;
1261
1343
  /** Items per page, two-way bound. */
1262
1344
  readonly pageSize: _angular_core.ModelSignal<number>;
1263
- /** 1-based active page, two-way bound. */
1345
+ /** 1-based active page, two-way bound; a page change (incl. the reset to 1
1346
+ * after a size change) emits via the implicit `currentPageChange`. */
1264
1347
  readonly currentPage: _angular_core.ModelSignal<number>;
1265
1348
  /** Preset choices offered in the page-size dropdown. */
1266
1349
  readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
1267
1350
  /** Shows the "Showing X–Y of Z" range label. */
1268
1351
  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>;
1273
1352
  protected readonly totalPages: _angular_core.Signal<number>;
1274
1353
  protected readonly pageItems: _angular_core.Signal<(number | "ellipsis")[]>;
1275
1354
  protected readonly rangeLabel: _angular_core.Signal<string>;
@@ -1281,7 +1360,7 @@ declare class PaginationComponent {
1281
1360
  protected goTo(page: number): void;
1282
1361
  protected onSizeChange(value: string): void;
1283
1362
  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>;
1363
+ 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"; }, never, never, true, never>;
1285
1364
  }
1286
1365
 
1287
1366
  interface DateFormatSpec {
@@ -1309,7 +1388,6 @@ interface DisplayPart {
1309
1388
  }
1310
1389
 
1311
1390
  type DatePickerMode = 'single' | 'range';
1312
- type DatePickerSize = 'sm' | 'md' | 'lg';
1313
1391
  type DateValue = Date | null;
1314
1392
  type RangeValue = [Date | null, Date | null];
1315
1393
  type DatePickerValue = DateValue | RangeValue;
@@ -1346,7 +1424,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1346
1424
  /** Selection mode — single date or start/end range. */
1347
1425
  readonly mode: _angular_core.InputSignal<DatePickerMode>;
1348
1426
  /** Trigger height — sm/md/lg. */
1349
- readonly size: _angular_core.InputSignal<DatePickerSize>;
1427
+ readonly size: _angular_core.InputSignal<DsSize>;
1350
1428
  /** Selected date (single) or `[start, end]` (range), two-way bound. */
1351
1429
  readonly value: _angular_core.ModelSignal<Date | RangeValue | null>;
1352
1430
  /** Accessible-name fallback only — the mask fills the visible placeholder, not this. */
@@ -1355,6 +1433,10 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1355
1433
  readonly label: _angular_core.InputSignal<string>;
1356
1434
  /** Helper text shown below the field. */
1357
1435
  readonly hint: _angular_core.InputSignal<string>;
1436
+ /** Reserve the message-row height even when empty, so the field doesn't shift
1437
+ * the layout below it when a hint/error appears. Default on — opt out for a
1438
+ * deliberately collapsing field. */
1439
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
1358
1440
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
1359
1441
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1360
1442
  /** Shows an "(optional)" marker beside the label — ignored when `required` is set. */
@@ -1522,11 +1604,10 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1522
1604
  protected isPresetDisabled(preset: DatePickerPreset): boolean;
1523
1605
  protected applyPreset(preset: DatePickerPreset): void;
1524
1606
  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>;
1607
+ 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; }; "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
1608
  }
1527
1609
 
1528
1610
  type TimePickerMode = 'single' | 'range';
1529
- type TimePickerSize = 'sm' | 'md' | 'lg';
1530
1611
  type TimeFormat = '24h' | '12h';
1531
1612
  /** Canonical stored value: 24h `"HH:MM"`. */
1532
1613
  type TimeValue = string;
@@ -1615,13 +1696,17 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1615
1696
  /** Predicate marking individual times unselectable. */
1616
1697
  readonly disabledTime: _angular_core.InputSignal<((time: string) => boolean) | null>;
1617
1698
  /** Trigger height — sm/md/lg. */
1618
- readonly size: _angular_core.InputSignal<TimePickerSize>;
1699
+ readonly size: _angular_core.InputSignal<DsSize>;
1619
1700
  /** Disables the picker and blocks all interaction. */
1620
1701
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1621
1702
  /** Applies error styling and marks the trigger `aria-invalid`. */
1622
1703
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1623
1704
  /** Helper text shown below the picker. */
1624
1705
  readonly hint: _angular_core.InputSignal<string>;
1706
+ /** Reserve the message-row height even when empty, so the field doesn't shift
1707
+ * the layout below it when a hint/error appears. Default on — opt out for a
1708
+ * deliberately collapsing field. */
1709
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
1625
1710
  /** Shown in the trigger when no time is set. */
1626
1711
  readonly placeholder: _angular_core.InputSignal<string>;
1627
1712
  /** Shows an inline clear button when a value is set — single mode only. */
@@ -1666,7 +1751,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1666
1751
  private minutesOf;
1667
1752
  private laterOf;
1668
1753
  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>;
1754
+ 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; }; "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
1755
  }
1671
1756
 
1672
1757
  interface BreadcrumbItem {
@@ -1783,13 +1868,19 @@ declare class SidenavItemComponent {
1783
1868
  readonly hasAlert: _angular_core.InputSignalWithTransform<boolean, unknown>;
1784
1869
  /** Disables the item — non-navigable and styled as inactive. */
1785
1870
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1871
+ /** Emitted on click, carrying the `MouseEvent`. On an `href` item,
1872
+ * `preventDefault()` intercepts navigation (e.g. a docs sidebar driving
1873
+ * scroll-spy); a `routerLink` item navigates regardless — Angular's
1874
+ * RouterLink ignores `defaultPrevented` — so treat it as a click hook there. */
1875
+ readonly activate: _angular_core.OutputEmitterRef<MouseEvent>;
1786
1876
  private readonly sidenav;
1877
+ protected onActivate(event: MouseEvent): void;
1787
1878
  /** Tooltip text shown when collapsed; empty string suppresses the tooltip when expanded. */
1788
1879
  protected readonly collapsedTooltip: _angular_core.Signal<string>;
1789
1880
  protected readonly collapsedAriaLabel: _angular_core.Signal<string | null>;
1790
1881
  protected readonly linkClasses: _angular_core.Signal<string>;
1791
1882
  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>;
1883
+ 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
1884
  }
1794
1885
 
1795
1886
  interface SidenavItemModel {
@@ -1854,10 +1945,13 @@ interface SearchGroup {
1854
1945
  */
1855
1946
  declare class SidenavFooterComponent {
1856
1947
  private readonly router;
1948
+ /** Name shown in the footer's account row. */
1857
1949
  readonly userName: _angular_core.InputSignal<string>;
1950
+ /** Secondary line under the name (role / organisation). */
1858
1951
  readonly userRole: _angular_core.InputSignal<string>;
1859
1952
  /** Show the unread dot on the Alerts row. */
1860
1953
  readonly alerts: _angular_core.InputSignal<boolean>;
1954
+ /** Mirrors the rail's collapsed state — labels hide, the avatar + icons stay. */
1861
1955
  readonly collapsed: _angular_core.InputSignal<boolean>;
1862
1956
  /** When set, the Search row opens a live results popover; unset keeps it inert. */
1863
1957
  readonly searchProvider: _angular_core.InputSignal<SidenavSearchProvider | null>;
@@ -1906,10 +2000,10 @@ declare class PageHeaderComponent {
1906
2000
  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
2001
  }
1908
2002
 
1909
- type ModalSize = 'sm' | 'md' | 'lg' | 'xl' | 'fullscreen';
2003
+ type ModalSize = DsSize | 'xl' | 'fullscreen';
1910
2004
 
1911
2005
  declare class ModalComponent implements OnDestroy {
1912
- private readonly doc;
2006
+ private readonly scrollLock;
1913
2007
  protected readonly preview: DsStaticPreview;
1914
2008
  /** Open state, two-way bound. */
1915
2009
  readonly open: _angular_core.ModelSignal<boolean>;
@@ -2067,7 +2161,7 @@ declare class DropzoneComponent {
2067
2161
  protected readonly dragOver: _angular_core.WritableSignal<boolean>;
2068
2162
  /** Fires with the raw files picked or dropped; the consumer adds them to `files`. */
2069
2163
  readonly filesAdded: _angular_core.OutputEmitterRef<File[]>;
2070
- /** Fires when the user removes a file from the list. */
2164
+ /** Fires when the user removes a file; unlike `filesAdded`, the consumer must remove the matching entry from `files` itself. */
2071
2165
  readonly fileRemoved: _angular_core.OutputEmitterRef<DropzoneFile>;
2072
2166
  protected readonly classes: _angular_core.Signal<string>;
2073
2167
  protected onDragOver(event: DragEvent): void;
@@ -2102,7 +2196,9 @@ declare class MenuItemComponent implements OnDestroy {
2102
2196
  private readonly button;
2103
2197
  /** Leading icon shown before the projected label. */
2104
2198
  readonly icon: _angular_core.InputSignal<IconName | null>;
2105
- /** Disables the item and excludes it from `ds-menu`'s roving-tabindex navigation. */
2199
+ /** Blocks activation and styles the item as inactive. It stays
2200
+ * keyboard-focusable (`aria-disabled`, ARIA menu practice) and in `ds-menu`'s
2201
+ * roving order, so a `[dsTooltip]` explaining why can be reached and shown. */
2106
2202
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2107
2203
  /** Renders the item in an error/destructive style. */
2108
2204
  readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -2262,6 +2358,7 @@ declare class TooltipDirective implements OnDestroy {
2262
2358
  private readonly tipId;
2263
2359
  protected onOpen(): void;
2264
2360
  protected onClose(): void;
2361
+ private disposeRef;
2265
2362
  protected onEscape(): void;
2266
2363
  private show;
2267
2364
  private positionFor;
@@ -2434,15 +2531,14 @@ interface DsToastConfig {
2434
2531
  }
2435
2532
  declare const DS_TOAST_CONFIG: InjectionToken<DsToastConfig>;
2436
2533
 
2437
- type DrawerSize = 'sm' | 'md' | 'lg';
2438
2534
  type DrawerPlacement = 'right' | 'left' | 'top' | 'bottom';
2439
2535
 
2440
2536
  declare class DrawerComponent implements OnDestroy {
2441
- private readonly doc;
2537
+ private readonly scrollLock;
2442
2538
  /** Open state, two-way bound. */
2443
2539
  readonly open: _angular_core.ModelSignal<boolean>;
2444
2540
  /** Panel size — sm/md/lg. */
2445
- readonly size: _angular_core.InputSignal<DrawerSize>;
2541
+ readonly size: _angular_core.InputSignal<DsSize>;
2446
2542
  /** Edge the panel slides in from. */
2447
2543
  readonly placement: _angular_core.InputSignal<DrawerPlacement>;
2448
2544
  /** Drawer title, shown in the header and used for `aria-labelledby`. */
@@ -2489,6 +2585,7 @@ declare class BottomSheetComponent implements OnDestroy {
2489
2585
  */
2490
2586
  readonly snapPoints: _angular_core.InputSignal<readonly number[]>;
2491
2587
  private readonly doc;
2588
+ private readonly scrollLock;
2492
2589
  private readonly sheetRef;
2493
2590
  protected readonly dragOffset: _angular_core.WritableSignal<number | null>;
2494
2591
  /** Sheet is in the DOM (kept true through the leave animation). */
@@ -2503,7 +2600,6 @@ declare class BottomSheetComponent implements OnDestroy {
2503
2600
  private lastMoveY;
2504
2601
  private lastMoveTime;
2505
2602
  private velocity;
2506
- private previousBodyOverflow;
2507
2603
  private wasOpen;
2508
2604
  private closeFallbackTimer;
2509
2605
  constructor();
@@ -2566,7 +2662,6 @@ declare class PageFooterComponent {
2566
2662
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<PageFooterComponent, "ds-page-footer", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["[brand]", "[nav]", "[actions]", "*"], true, never>;
2567
2663
  }
2568
2664
 
2569
- type AutocompleteSize = 'sm' | 'md' | 'lg';
2570
2665
  /** `fill` stretches to the host container (default); `content` hugs chips/value + a min typing area. */
2571
2666
  type AutocompleteWidth = 'fill' | 'content';
2572
2667
  interface AutocompleteOption<T = unknown> {
@@ -2594,7 +2689,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2594
2689
  /** Allows selecting more than one option, shown as removable tags. */
2595
2690
  readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
2596
2691
  /** Trigger height — sm/md/lg. */
2597
- readonly size: _angular_core.InputSignal<AutocompleteSize>;
2692
+ readonly size: _angular_core.InputSignal<DsSize>;
2598
2693
  /** Trigger width — `fill` stretches to the container, `content` hugs the value. */
2599
2694
  readonly width: _angular_core.InputSignal<AutocompleteWidth>;
2600
2695
  /** Placeholder shown in the input when empty. */
@@ -2605,6 +2700,10 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2605
2700
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2606
2701
  /** Helper text shown below the field. */
2607
2702
  readonly hint: _angular_core.InputSignal<string>;
2703
+ /** Reserve the message-row height even when empty, so the field doesn't shift
2704
+ * the layout below it when a hint/error appears. Default on — opt out for a
2705
+ * deliberately collapsing field. */
2706
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
2608
2707
  /** Shows a "Create «text»" row when the typed text matches no option. */
2609
2708
  readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
2610
2709
  /** Accessible name for the combobox input. */
@@ -2652,7 +2751,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2652
2751
  protected onCreateNew(): void;
2653
2752
  protected remove(target: T): void;
2654
2753
  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>;
2754
+ 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
2755
  }
2657
2756
 
2658
2757
  type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
@@ -2694,7 +2793,7 @@ declare class DescriptionItemComponent {
2694
2793
  type LayoutGap = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
2695
2794
  type LayoutAlign = 'start' | 'center' | 'end' | 'stretch';
2696
2795
  type LayoutJustify = 'start' | 'center' | 'end' | 'between';
2697
- type ContainerSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
2796
+ type ContainerSize = DsSize | 'xl' | 'full';
2698
2797
 
2699
2798
  declare class StackComponent {
2700
2799
  readonly gap: _angular_core.InputSignal<LayoutGap | null>;
@@ -2839,6 +2938,10 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
2839
2938
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2840
2939
  /** Helper text shown below the cells. */
2841
2940
  readonly hint: _angular_core.InputSignal<string>;
2941
+ /** Reserve the message-row height even when empty, so the field doesn't shift
2942
+ * the layout below it when a hint/error appears. Default on — opt out for a
2943
+ * deliberately collapsing field. */
2944
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
2842
2945
  /** Accessible group label for the cell row. */
2843
2946
  readonly ariaLabel: _angular_core.InputSignal<string>;
2844
2947
  /** Fires once, with the full code, on the partial → complete transition. */
@@ -2863,7 +2966,7 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
2863
2966
  private focusBox;
2864
2967
  private sanitize;
2865
2968
  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>;
2969
+ 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
2970
  }
2868
2971
 
2869
2972
  type SliderValue = number | readonly [number, number];
@@ -2886,6 +2989,10 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
2886
2989
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2887
2990
  /** Helper text shown below the slider. */
2888
2991
  readonly hint: _angular_core.InputSignal<string>;
2992
+ /** Reserve the message-row height even when empty, so the field doesn't shift
2993
+ * the layout below it when a hint/error appears. Default on — opt out for a
2994
+ * deliberately collapsing field. */
2995
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
2889
2996
  private readonly track;
2890
2997
  private dragging;
2891
2998
  protected readonly uid: string;
@@ -2911,11 +3018,9 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
2911
3018
  private setThumb;
2912
3019
  private snap;
2913
3020
  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>;
3021
+ 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
3022
  }
2916
3023
 
2917
- type SpinnerSize = 'sm' | 'md' | 'lg';
2918
-
2919
3024
  declare class LoadingOverlayComponent {
2920
3025
  /** Show the scrim + spinner over the projected region. */
2921
3026
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -2924,7 +3029,7 @@ declare class LoadingOverlayComponent {
2924
3029
  /** Backdrop-blur the projected content behind the scrim. */
2925
3030
  readonly blur: _angular_core.InputSignalWithTransform<boolean, unknown>;
2926
3031
  /** Size of the spinner shown in the scrim. */
2927
- readonly spinnerSize: _angular_core.InputSignal<SpinnerSize>;
3032
+ readonly spinnerSize: _angular_core.InputSignal<DsSize>;
2928
3033
  /** Offset the scrim top edge — useful when a sticky header should stay uncovered. */
2929
3034
  readonly insetTop: _angular_core.InputSignal<string>;
2930
3035
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<LoadingOverlayComponent, never>;
@@ -2999,6 +3104,10 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
2999
3104
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3000
3105
  /** Helper text shown below the trigger. */
3001
3106
  readonly hint: _angular_core.InputSignal<string>;
3107
+ /** Reserve the message-row height even when empty, so the field doesn't shift
3108
+ * the layout below it when a hint/error appears. Default on — opt out for a
3109
+ * deliberately collapsing field. */
3110
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
3002
3111
  protected readonly trigger: _angular_core.Signal<ElementRef<HTMLButtonElement>>;
3003
3112
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
3004
3113
  protected readonly open: _angular_core.WritableSignal<boolean>;
@@ -3038,7 +3147,7 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
3038
3147
  private updateHue;
3039
3148
  private clampPct;
3040
3149
  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>;
3150
+ 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
3151
  }
3043
3152
 
3044
3153
  interface MultiSelectOption {
@@ -3070,6 +3179,10 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
3070
3179
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3071
3180
  /** Helper text shown below the field. */
3072
3181
  readonly hint: _angular_core.InputSignal<string>;
3182
+ /** Reserve the message-row height even when empty, so the field doesn't shift
3183
+ * the layout below it when a hint/error appears. Default on — opt out for a
3184
+ * deliberately collapsing field. */
3185
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
3073
3186
  /** Accessible name for the trigger — falls back to `placeholder`. */
3074
3187
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
3075
3188
  /** Shows a "Select all" row that toggles every filter-matching, enabled option. */
@@ -3110,7 +3223,7 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
3110
3223
  protected close(): void;
3111
3224
  private moveActive;
3112
3225
  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>;
3226
+ 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
3227
  }
3115
3228
 
3116
3229
  declare class SkeletonComponent {
@@ -3128,13 +3241,11 @@ declare class SkeletonComponent {
3128
3241
 
3129
3242
  declare class SpinnerComponent {
3130
3243
  /** Spinner size — sm/md/lg. */
3131
- readonly size: _angular_core.InputSignal<SpinnerSize>;
3244
+ readonly size: _angular_core.InputSignal<DsSize>;
3132
3245
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SpinnerComponent, never>;
3133
3246
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<SpinnerComponent, "ds-spinner", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
3134
3247
  }
3135
3248
 
3136
- type CheckboxSize = 'sm' | 'md' | 'lg';
3137
-
3138
3249
  declare class CheckboxComponent extends DsBooleanControlValueAccessor {
3139
3250
  /** Checked state, two-way bound. */
3140
3251
  readonly checked: _angular_core.ModelSignal<boolean>;
@@ -3150,8 +3261,12 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
3150
3261
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3151
3262
  /** Helper text shown below the checkbox. */
3152
3263
  readonly hint: _angular_core.InputSignal<string>;
3264
+ /** Reserve the message-row height even when empty, so the field doesn't shift
3265
+ * the layout below it when a hint/error appears. Default on — opt out for a
3266
+ * deliberately collapsing field. */
3267
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
3153
3268
  /** Checkbox size — sm/md/lg. */
3154
- readonly size: _angular_core.InputSignal<CheckboxSize>;
3269
+ readonly size: _angular_core.InputSignal<DsSize>;
3155
3270
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
3156
3271
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
3157
3272
  /** Inline label rendered beside the box and wired via for/id. Omit to
@@ -3165,11 +3280,9 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
3165
3280
  protected readonly fieldClass: _angular_core.Signal<string>;
3166
3281
  protected onCheckedChange(event: Event): void;
3167
3282
  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>;
3283
+ 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, never, true, never>;
3169
3284
  }
3170
3285
 
3171
- type RadioSize = 'sm' | 'md' | 'lg';
3172
-
3173
3286
  declare class RadioComponent {
3174
3287
  /** Standalone two-way binding. When inside ds-radio-group, isChecked() is
3175
3288
  * derived from the group value instead. */
@@ -3186,8 +3299,12 @@ declare class RadioComponent {
3186
3299
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3187
3300
  /** Helper text shown below the control. */
3188
3301
  readonly hint: _angular_core.InputSignal<string>;
3302
+ /** Reserve the message-row height even when empty, so the field doesn't shift
3303
+ * the layout below it when a hint/error appears. Default on — opt out for a
3304
+ * deliberately collapsing field. */
3305
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
3189
3306
  /** Control size — sm/md/lg. */
3190
- readonly size: _angular_core.InputSignal<RadioSize>;
3307
+ readonly size: _angular_core.InputSignal<DsSize>;
3191
3308
  /** Marks the radio required — shows an asterisk on the label and sets `aria-required`. */
3192
3309
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
3193
3310
  /** Inline label rendered beside the dot and wired via for/id. Omit to bring
@@ -3210,7 +3327,7 @@ declare class RadioComponent {
3210
3327
  focus(): void;
3211
3328
  protected onSelect(): void;
3212
3329
  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>;
3330
+ 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, never, true, never>;
3214
3331
  }
3215
3332
 
3216
3333
  /** Contract that ds-radio reads from its parent ds-radio-group, injected via
@@ -3242,6 +3359,10 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
3242
3359
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3243
3360
  /** Helper text shown below the group. */
3244
3361
  readonly hint: _angular_core.InputSignal<string>;
3362
+ /** Reserve the message-row height even when empty, so the field doesn't shift
3363
+ * the layout below it when a hint/error appears. Default on — opt out for a
3364
+ * deliberately collapsing field. */
3365
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
3245
3366
  /** Accessible name for the group when no visible label is provided. */
3246
3367
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
3247
3368
  /** Visible group label; omit to supply your own. */
@@ -3257,11 +3378,9 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
3257
3378
  select(value: unknown): void;
3258
3379
  protected onKeydown(event: KeyboardEvent): void;
3259
3380
  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>;
3381
+ 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
3382
  }
3262
3383
 
3263
- type SwitchSize = 'sm' | 'md' | 'lg';
3264
-
3265
3384
  declare class SwitchComponent extends DsBooleanControlValueAccessor {
3266
3385
  /** On/off state, two-way bound. */
3267
3386
  readonly checked: _angular_core.ModelSignal<boolean>;
@@ -3277,8 +3396,12 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
3277
3396
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3278
3397
  /** Helper text shown below the switch. */
3279
3398
  readonly hint: _angular_core.InputSignal<string>;
3399
+ /** Reserve the message-row height even when empty, so the field doesn't shift
3400
+ * the layout below it when a hint/error appears. Default on — opt out for a
3401
+ * deliberately collapsing field. */
3402
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
3280
3403
  /** Switch size — sm/md/lg. */
3281
- readonly size: _angular_core.InputSignal<SwitchSize>;
3404
+ readonly size: _angular_core.InputSignal<DsSize>;
3282
3405
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
3283
3406
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
3284
3407
  /** Inline label rendered beside the track and wired via for/id. Omit to
@@ -3293,7 +3416,7 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
3293
3416
  protected readonly fieldClass: _angular_core.Signal<string>;
3294
3417
  protected onCheckedChange(event: Event): void;
3295
3418
  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>;
3419
+ 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, never, true, never>;
3297
3420
  }
3298
3421
 
3299
3422
  /**
@@ -3313,5 +3436,5 @@ declare class FieldClickFocusDirective {
3313
3436
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
3314
3437
  }
3315
3438
 
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 };
3439
+ 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, 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, initialsFrom, isSelectOptionGroup, provideDsConfig, provideDsIcons, provideDsTheme };
3440
+ 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 };