@ids-group-ltd/ids-design-system 0.6.2 → 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.
@@ -2,6 +2,7 @@ import * as _angular_core from '@angular/core';
2
2
  import { InjectionToken, Provider, EnvironmentProviders, ElementRef, TemplateRef, ModelSignal, OnDestroy } from '@angular/core';
3
3
  import { SafeHtml } from '@angular/platform-browser';
4
4
  import { ControlValueAccessor } from '@angular/forms';
5
+ import { CdkDragDrop } from '@angular/cdk/drag-drop';
5
6
  import * as _ids_group_ltd_ids_design_system from '@ids-group-ltd/ids-design-system';
6
7
 
7
8
  declare const ICONS: {
@@ -160,6 +161,23 @@ declare abstract class DsOverlayCloseRef {
160
161
  abstract close(): void;
161
162
  }
162
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
+
163
181
  /** Canonical status vocabulary shared across status-bearing components. */
164
182
  type DsStatus = 'info' | 'success' | 'warning' | 'error';
165
183
  /**
@@ -183,9 +201,14 @@ interface DsStatusRegistry {
183
201
  * open `string`; once a consumer augments DsStatusRegistry it narrows to the
184
202
  * union of their keys (autocomplete). The tuple wrap avoids `never` distribution.
185
203
  */
186
- type DsStatusKey = [
187
- keyof DsStatusRegistry
188
- ] 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';
189
212
 
190
213
  declare class IconComponent {
191
214
  private readonly sanitizer;
@@ -231,7 +254,6 @@ declare function provideDsIcons(icons: DsIconRegistry): Provider;
231
254
 
232
255
  type ButtonColor = 'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning';
233
256
  type ButtonVariant = 'solid' | 'tonal' | 'ghost' | 'outline' | 'text';
234
- type ButtonSize = 'sm' | 'md' | 'lg';
235
257
  type ButtonType = 'button' | 'submit' | 'reset';
236
258
 
237
259
  declare class ButtonComponent {
@@ -244,8 +266,8 @@ declare class ButtonComponent {
244
266
  cases needing the ds-button API (loading/fullWidth/typed pressed). */
245
267
  readonly variant: _angular_core.InputSignal<ButtonVariant>;
246
268
  /** Button height — sm/md/lg. */
247
- readonly size: _angular_core.InputSignal<ButtonSize>;
248
- /** 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. */
249
271
  readonly type: _angular_core.InputSignal<ButtonType>;
250
272
  /** Disables the button and blocks `pressed`. */
251
273
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -297,7 +319,6 @@ declare class ToggleButtonComponent {
297
319
  }
298
320
 
299
321
  type IconButtonVariant = 'standard' | 'filled' | 'tonal' | 'outlined';
300
- type IconButtonSize = 'sm' | 'md' | 'lg';
301
322
  type IconButtonType = 'button' | 'submit' | 'reset';
302
323
 
303
324
  /**
@@ -317,8 +338,8 @@ declare class IconButtonComponent {
317
338
  axis; `color` recolours the accent the fill consumes. Default primary. */
318
339
  readonly color: _angular_core.InputSignal<ButtonColor>;
319
340
  /** Button size — sm/md/lg, matches the field/button height scale. */
320
- readonly size: _angular_core.InputSignal<IconButtonSize>;
321
- /** 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. */
322
343
  readonly type: _angular_core.InputSignal<IconButtonType>;
323
344
  /** Disables the button and blocks `pressed`. */
324
345
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -344,12 +365,13 @@ declare class BadgeComponent {
344
365
  readonly count: _angular_core.InputSignal<number | null>;
345
366
  /** Count is capped at this value, shown as `"max+"` beyond it. */
346
367
  readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
347
- /** 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>;
348
370
  protected readonly countDisplay: _angular_core.Signal<string | null>;
349
371
  protected readonly classes: _angular_core.Signal<string>;
350
372
  protected readonly countAriaLabel: _angular_core.Signal<string | null>;
351
373
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<BadgeComponent, never>;
352
- 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>;
353
375
  }
354
376
 
355
377
  declare class StatusDotComponent {
@@ -361,7 +383,63 @@ declare class StatusDotComponent {
361
383
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<StatusDotComponent, "ds-status-dot", never, { "status": { "alias": "status"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
362
384
  }
363
385
 
364
- type AvatarSize = 'xs' | 'sm' | 'md' | 'lg';
386
+ /**
387
+ * Fixed-frame application layout: the host is pinned to the viewport
388
+ * (`100dvh` + `overflow: hidden`) and ONLY the content region scrolls, so
389
+ * the sidenav rail and the topbar stay put on pages taller than the
390
+ * viewport. Consumers project their own chrome into the slots:
391
+ *
392
+ * ```html
393
+ * <ds-app-layout>
394
+ * <ds-sidenav sidenav>…</ds-sidenav>
395
+ * <ds-topbar topbar>…</ds-topbar>
396
+ * <router-outlet />
397
+ * </ds-app-layout>
398
+ * ```
399
+ *
400
+ * The layout renders the `<main>` landmark itself — do not nest another
401
+ * `<main>` in the content. Scroll-to-top on navigation is built in
402
+ * (`LayoutScrollService`); the content padding auto-compensates the native
403
+ * scrollbar width so the right inset always equals the left one. The layout
404
+ * requires the application router (`provideRouter`) because its scroll-to-top
405
+ * service subscribes to navigation events.
406
+ */
407
+ declare class AppLayoutComponent {
408
+ /**
409
+ * `'content'` (default): the rail spans the full viewport height on the
410
+ * left and the topbar sits above the content column only. `'full'`: the
411
+ * topbar spans the full width and the rail + content sit below it.
412
+ */
413
+ readonly topbarSpan: _angular_core.InputSignal<"content" | "full">;
414
+ private readonly layoutScroll;
415
+ private readonly content;
416
+ constructor();
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>;
419
+ }
420
+
421
+ /**
422
+ * Owns the layout's content scroller. In the fixed-frame layout the window
423
+ * never scrolls, so the router's built-in window-based scrolling no-ops —
424
+ * this service resets the registered container to the top after every
425
+ * navigation instead. Provided by `ds-app-layout`, so routed pages can
426
+ * `inject(LayoutScrollService)` and call `scrollToTop()` manually (e.g. list
427
+ * pages resetting scroll on filter changes). Per-route scroll restoration is
428
+ * a documented growth point — add it here if a page ever needs
429
+ * back-navigation scroll memory.
430
+ */
431
+ declare class LayoutScrollService {
432
+ private readonly router;
433
+ private readonly destroyRef;
434
+ private scrollContainer;
435
+ constructor();
436
+ setScrollContainer(element: Element): void;
437
+ scrollToTop(): void;
438
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<LayoutScrollService, never>;
439
+ static ɵprov: _angular_core.ɵɵInjectableDeclaration<LayoutScrollService>;
440
+ }
441
+
442
+ type AvatarSize = 'xs' | DsSize;
365
443
  type AvatarStatus = 'online' | 'offline' | 'away' | 'busy';
366
444
 
367
445
  declare class AvatarComponent {
@@ -385,14 +463,50 @@ declare class AvatarComponent {
385
463
  readonly status: _angular_core.InputSignal<AvatarStatus | null>;
386
464
  /** Icon rendered when there is no imageUrl and no initials. */
387
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])[]>;
388
472
  protected readonly tintStyle: _angular_core.Signal<{
389
473
  bg: string | null;
390
474
  fg: string | null;
391
475
  }>;
392
476
  protected readonly statusAriaLabel: _angular_core.Signal<string | null>;
393
477
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AvatarComponent, never>;
394
- 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>;
395
- }
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;
396
510
 
397
511
  declare class AvatarGroupComponent {
398
512
  /** Maximum avatars shown before the rest collapse into an overflow chip. */
@@ -566,7 +680,6 @@ declare abstract class DsBooleanControlValueAccessor implements ControlValueAcce
566
680
 
567
681
  type FieldMessageState = 'default' | 'error' | 'success';
568
682
 
569
- type InputSize = 'sm' | 'md' | 'lg';
570
683
  type InputType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search';
571
684
 
572
685
  declare class InputComponent extends DsControlValueAccessor<string> {
@@ -575,11 +688,15 @@ declare class InputComponent extends DsControlValueAccessor<string> {
575
688
  /** Native input type — also affects the default clear button and password toggle. */
576
689
  readonly type: _angular_core.InputSignal<InputType>;
577
690
  /** Field height — sm/md/lg. */
578
- readonly size: _angular_core.InputSignal<InputSize>;
691
+ readonly size: _angular_core.InputSignal<DsSize>;
579
692
  /** Label shown above the field, or inside it when `floating`. */
580
693
  readonly label: _angular_core.InputSignal<string>;
581
694
  /** Helper text shown below the field. */
582
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>;
583
700
  /** Placeholder shown when empty. */
584
701
  readonly placeholder: _angular_core.InputSignal<string>;
585
702
  /** Disables the field and blocks all interaction. */
@@ -596,10 +713,6 @@ declare class InputComponent extends DsControlValueAccessor<string> {
596
713
  /** Floating-label variant — the label sits inside a taller control instead
597
714
  * of stacked above it. */
598
715
  readonly floating: _angular_core.InputSignalWithTransform<boolean, unknown>;
599
- /** Reserves space for a leading addon projected into `[dsInputPrefix]`. */
600
- readonly withAddon: _angular_core.InputSignalWithTransform<boolean, unknown>;
601
- /** Reserves space for a trailing addon projected into `[dsInputSuffix]`. */
602
- readonly withAddonRight: _angular_core.InputSignalWithTransform<boolean, unknown>;
603
716
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
604
717
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
605
718
  /** Shows an "(optional)" marker next to the label (ignored when `required`). */
@@ -623,7 +736,7 @@ declare class InputComponent extends DsControlValueAccessor<string> {
623
736
  * live "{current}/{max}" counter below the field. */
624
737
  readonly maxLength: _angular_core.InputSignal<number | null>;
625
738
  /** Mobile keyboard hints — forwarded to the native input as attributes. */
626
- readonly enterKeyHint: _angular_core.InputSignal<"search" | "enter" | "done" | "go" | "next" | "previous" | "send" | null>;
739
+ readonly enterKeyHint: _angular_core.InputSignal<"search" | "next" | "enter" | "done" | "go" | "previous" | "send" | null>;
627
740
  /** Native `inputmode` attribute — hints the on-screen keyboard layout. */
628
741
  readonly inputMode: _angular_core.InputSignal<"search" | "text" | "none" | "email" | "tel" | "url" | "decimal" | "numeric" | null>;
629
742
  /** Emits when the native input loses focus. */
@@ -656,11 +769,9 @@ declare class InputComponent extends DsControlValueAccessor<string> {
656
769
  protected readonly wrapperClasses: _angular_core.Signal<string>;
657
770
  protected clear(): void;
658
771
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<InputComponent, never>;
659
- 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>;
660
773
  }
661
774
 
662
- type NumberStepperSize = 'sm' | 'md' | 'lg';
663
-
664
775
  declare class NumberStepperComponent {
665
776
  /** Current numeric value, two-way bound. */
666
777
  readonly value: _angular_core.ModelSignal<number>;
@@ -671,7 +782,7 @@ declare class NumberStepperComponent {
671
782
  /** Amount added or subtracted per increment/decrement. */
672
783
  readonly step: _angular_core.InputSignal<number>;
673
784
  /** Control height — sm/md/lg. */
674
- readonly size: _angular_core.InputSignal<NumberStepperSize>;
785
+ readonly size: _angular_core.InputSignal<DsSize>;
675
786
  /** Disables the stepper and blocks all interaction. */
676
787
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
677
788
  /** Accessible name for the number input (the stepper has no visible label). */
@@ -686,18 +797,21 @@ declare class NumberStepperComponent {
686
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>;
687
798
  }
688
799
 
689
- type TextareaSize = 'sm' | 'md' | 'lg';
690
800
  type TextareaResize = 'none' | 'vertical' | 'horizontal' | 'both';
691
801
 
692
802
  declare class TextareaComponent extends DsControlValueAccessor<string> {
693
803
  /** Text value, two-way bound. */
694
804
  readonly value: _angular_core.ModelSignal<string>;
695
805
  /** Field height — sm/md/lg. */
696
- readonly size: _angular_core.InputSignal<TextareaSize>;
806
+ readonly size: _angular_core.InputSignal<DsSize>;
697
807
  /** Label shown above the field. */
698
808
  readonly label: _angular_core.InputSignal<string>;
699
809
  /** Helper text shown below the field. */
700
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>;
701
815
  /** Placeholder shown when empty. */
702
816
  readonly placeholder: _angular_core.InputSignal<string>;
703
817
  /** Disables the field and blocks all interaction. */
@@ -740,7 +854,7 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
740
854
  protected readonly autosizeMaxHeight: _angular_core.Signal<string | null>;
741
855
  protected readonly effectiveResize: _angular_core.Signal<TextareaResize>;
742
856
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextareaComponent, never>;
743
- 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>;
744
858
  }
745
859
 
746
860
  declare class SearchComponent {
@@ -756,13 +870,16 @@ declare class SearchComponent {
756
870
  readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
757
871
  /** Accessible name for the input (placeholder is not a reliable label). */
758
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>;
759
876
  /** Fires with the current value on Enter. */
760
877
  readonly submitted: _angular_core.OutputEmitterRef<string>;
761
878
  private readonly inputEl;
762
879
  protected onSubmit(): void;
763
880
  protected clear(): void;
764
881
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SearchComponent, never>;
765
- 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>;
766
883
  }
767
884
 
768
885
  /** Showcase-only: renders the component's open/overlay surface inline in normal
@@ -774,7 +891,6 @@ declare class DsStaticPreview {
774
891
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsStaticPreview, never, never, { "staticPreview": { "alias": "staticPreview"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
775
892
  }
776
893
 
777
- type SelectSize = 'sm' | 'md' | 'lg';
778
894
  interface SelectOption {
779
895
  label: string;
780
896
  value: string;
@@ -792,6 +908,7 @@ declare function isSelectOptionGroup(item: SelectItem): item is SelectOptionGrou
792
908
  declare class SelectComponent extends DsControlValueAccessor<string> implements OnDestroy {
793
909
  private readonly overlay;
794
910
  private readonly vcr;
911
+ private readonly host;
795
912
  protected readonly preview: DsStaticPreview;
796
913
  /** Selected option's value, two-way bound. */
797
914
  readonly value: _angular_core.ModelSignal<string>;
@@ -800,7 +917,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
800
917
  /** Shown in the trigger when nothing is selected. */
801
918
  readonly placeholder: _angular_core.InputSignal<string>;
802
919
  /** Trigger height — sm/md/lg. */
803
- readonly size: _angular_core.InputSignal<SelectSize>;
920
+ readonly size: _angular_core.InputSignal<DsSize>;
804
921
  /** Label shown above the trigger. */
805
922
  readonly label: _angular_core.InputSignal<string>;
806
923
  /** Disables the trigger and blocks all interaction. */
@@ -811,6 +928,10 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
811
928
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
812
929
  /** Helper text shown below the trigger. */
813
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>;
814
935
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
815
936
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
816
937
  /** Shows an "(optional)" marker next to the label (ignored when `required`). */
@@ -832,7 +953,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
832
953
  protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
833
954
  /** Effective disabled — own `disabled` input OR the reactive-forms state. */
834
955
  protected readonly isDisabled: _angular_core.Signal<boolean>;
835
- protected readonly trigger: _angular_core.Signal<ElementRef<HTMLButtonElement>>;
956
+ protected readonly trigger: _angular_core.Signal<ElementRef<HTMLElement>>;
836
957
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
837
958
  protected readonly panelContentTpl: _angular_core.Signal<TemplateRef<unknown>>;
838
959
  protected readonly open: _angular_core.WritableSignal<boolean>;
@@ -863,7 +984,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
863
984
  private firstEnabledIndex;
864
985
  private lastEnabledIndex;
865
986
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
866
- 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: {}; }]>;
867
988
  }
868
989
 
869
990
  /**
@@ -894,13 +1015,33 @@ declare class CellTemplateDirective {
894
1015
  interface TableColumn<T = unknown> {
895
1016
  key: string;
896
1017
  label: string;
1018
+ /** Visually-hidden accessible header name — use when `label` is
1019
+ * intentionally empty (e.g. an actions column). */
1020
+ srLabel?: string;
897
1021
  sortable?: boolean;
1022
+ /** Include the column in `filterQuery` matching. When no column is marked,
1023
+ * every column matches. Works on `hidden` columns too. */
898
1024
  filterable?: boolean;
1025
+ /** Adds a header filter menu. `'set'` lists the column's distinct values as
1026
+ * a searchable checkbox list; a row passes when its value stays checked. */
1027
+ filter?: 'set';
1028
+ /** Ellipsis-clip long cell text at `width` (240px when unset) — full value
1029
+ * in the title tooltip, and clicking a clipped cell opens it in a popover.
1030
+ * Text cells only — template cells own their overflow. */
899
1031
  truncate?: boolean;
1032
+ /** Column width in px — also the clip width for `truncate`. */
900
1033
  width?: number;
901
1034
  align?: 'left' | 'right' | 'center';
902
1035
  cell?: (row: T) => string;
1036
+ /** Double-click the cell to edit it inline; the committed value is emitted
1037
+ * via the table's `cellEdited` output (the consumer owns the data update). */
1038
+ editable?: boolean;
1039
+ /** Let the user toggle the column in the header column picker — the picker
1040
+ * button appears once at least one column is hideable. */
903
1041
  hideable?: boolean;
1042
+ /** Initial visibility: start hidden. The column picker (or a bound
1043
+ * `hiddenKeys` set) owns the state from then on; a hidden column stays
1044
+ * available to `filterable` matching and sorting. */
904
1045
  hidden?: boolean;
905
1046
  }
906
1047
  type SortDir = 'asc' | 'desc' | null;
@@ -908,6 +1049,25 @@ interface SortChangeEvent {
908
1049
  key: string;
909
1050
  dir: SortDir;
910
1051
  }
1052
+ interface TableRowAction<T = unknown> {
1053
+ /** Stable identifier — use it to branch in `rowActionSelected`. */
1054
+ id: string;
1055
+ label: string;
1056
+ icon?: IconName;
1057
+ /** Renders the item in the destructive style. */
1058
+ error?: boolean;
1059
+ /** Per-row predicate — return true to disable the item for that row. */
1060
+ disabled?: (row: T) => boolean;
1061
+ }
1062
+ interface TableRowActionEvent<T = unknown> {
1063
+ action: TableRowAction<T>;
1064
+ row: T;
1065
+ }
1066
+ interface TableCellEditEvent<T = unknown> {
1067
+ row: T;
1068
+ key: string;
1069
+ value: string;
1070
+ }
911
1071
 
912
1072
  declare class TableComponent<T extends {
913
1073
  id: string;
@@ -931,12 +1091,27 @@ declare class TableComponent<T extends {
931
1091
  readonly loading: _angular_core.InputSignal<false | "skeleton" | "overlay">;
932
1092
  /** Keeps the header row pinned while the body scrolls. */
933
1093
  readonly stickyHeader: _angular_core.InputSignalWithTransform<boolean, unknown>;
1094
+ /** Caps the scroll body height (any CSS length, e.g. `'320px'`) and scrolls it
1095
+ * vertically — pair with `stickyHeader` for a self-contained scroll region.
1096
+ * `null` (default) lets the table grow to its content. */
1097
+ readonly maxHeight: _angular_core.InputSignal<string | null>;
1098
+ /** Row density — `'compact'` tightens cell padding for spreadsheet-dense lists. */
1099
+ readonly density: _angular_core.InputSignal<"default" | "compact">;
1100
+ /** Tints odd rows for easier row-tracking across wide tables. */
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>;
934
1105
  /** Two-way set of currently selected row ids. */
935
1106
  readonly selectedIds: _angular_core.ModelSignal<Set<string>>;
936
1107
  /** Column key currently sorted by; `null` when unsorted. */
937
1108
  readonly sortKey: _angular_core.ModelSignal<string | null>;
938
1109
  /** Sort direction for `sortKey`. */
939
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[]>;
940
1115
  /** Number of shimmer rows rendered while `loading` is `'skeleton'`. */
941
1116
  readonly skeletonRows: _angular_core.InputSignal<number>;
942
1117
  /** Accessible name for the table (rendered as a visually-hidden caption).
@@ -945,14 +1120,51 @@ declare class TableComponent<T extends {
945
1120
  /** When true, each row becomes a keyboard-operable control (role=button,
946
1121
  * tabindex, Enter/Space → rowClicked) with an accessible name from the first
947
1122
  * column. Off by default so non-navigating tables don't advertise a false
948
- * click affordance. */
1123
+ * click affordance. Also the gate for the hover/pressed row tints. */
949
1124
  readonly rowInteractive: _angular_core.InputSignalWithTransform<boolean, unknown>;
1125
+ /** Id of the row rendered as current (highlight + `aria-current`) — e.g. the
1126
+ * row whose detail drawer or side panel is open. `null` — none. */
1127
+ readonly activeRowId: _angular_core.InputSignal<string | null>;
1128
+ /** Client-side row filter — case-insensitive substring match against cell
1129
+ * text. Columns with `filterable: true` restrict the match set (none
1130
+ * marked — every column matches, hidden ones included). '' — no filtering. */
1131
+ readonly filterQuery: _angular_core.InputSignal<string>;
1132
+ /** Two-way per-column set-filters: column key → the still-checked values.
1133
+ * A column absent from the map (or with every value checked) is unfiltered. */
1134
+ readonly columnFilters: _angular_core.ModelSignal<Map<string, ReadonlySet<string>>>;
1135
+ /** Two-way set of hidden column keys. `null` (default) derives the set from
1136
+ * each column's `hidden` flag; the column picker then owns it. Binding a
1137
+ * Set takes over — `hidden` flags are ignored. */
1138
+ readonly hiddenKeys: _angular_core.ModelSignal<Set<string> | null>;
1139
+ /** Enables drag-to-resize handles on each column header. */
1140
+ readonly resizableColumns: _angular_core.InputSignalWithTransform<boolean, unknown>;
1141
+ /** Two-way per-column pixel width overrides (keyed by column key), set by
1142
+ * dragging a resize handle. Seeded from `column.width` where unset. */
1143
+ readonly columnWidths: _angular_core.ModelSignal<Map<string, number>>;
1144
+ /** Enables drag + up/down reordering in the column panel. */
1145
+ readonly reorderableColumns: _angular_core.InputSignalWithTransform<boolean, unknown>;
1146
+ /** Two-way column order as a list of keys. `null` (default) keeps declaration
1147
+ * order; the column panel owns it once the user reorders. Keys absent from
1148
+ * the list fall back to declaration order after the listed ones. */
1149
+ readonly columnOrder: _angular_core.ModelSignal<string[] | null>;
1150
+ /** Keeps the horizontal scrollbar reachable on tall tables: the scroll
1151
+ * container's native bar is hidden and a proxy stuck to the bottom of the
1152
+ * nearest scroll ancestor mirrors it both ways. Off by default. */
1153
+ readonly stickyScrollbar: _angular_core.InputSignalWithTransform<boolean, unknown>;
950
1154
  /** Rows per page. `null` (default) disables pagination — all rows render. */
951
1155
  readonly pageSize: _angular_core.ModelSignal<number | null>;
952
1156
  /** Current 1-based page. Only meaningful when `pageSize()` is set. */
953
1157
  readonly page: _angular_core.ModelSignal<number>;
954
1158
  /** Selectable page-size choices shown in the pagination control. */
955
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>;
956
1168
  /** When true, the table sorts `data()` itself; otherwise it only emits
957
1169
  * `sortChange` and leaves ordering to the consumer (default). */
958
1170
  readonly clientSort: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -962,6 +1174,13 @@ declare class TableComponent<T extends {
962
1174
  readonly rowClicked: _angular_core.OutputEmitterRef<T>;
963
1175
  /** Fires whenever sort key/direction changes, regardless of `clientSort`. */
964
1176
  readonly sortChange: _angular_core.OutputEmitterRef<SortChangeEvent>;
1177
+ /** Row-action menu items rendered as a trailing kebab (⋮) column.
1178
+ * Empty (default) — no column. Menu clicks never trigger `rowClicked`. */
1179
+ readonly rowActions: _angular_core.InputSignal<readonly TableRowAction<T>[]>;
1180
+ /** Fires with the chosen action and its row when a kebab menu item is selected. */
1181
+ readonly rowActionSelected: _angular_core.OutputEmitterRef<TableRowActionEvent<T>>;
1182
+ /** Fires when an `editable` cell is committed (Enter or blur) with the new value. */
1183
+ readonly cellEdited: _angular_core.OutputEmitterRef<TableCellEditEvent<T>>;
965
1184
  /** Cell templates supplied as an explicit map instead of (or in addition to)
966
1185
  * projected `dsCellTemplate` directives. Lets a wrapper component (e.g.
967
1186
  * ids-data-table) collect the directives itself and pass them down, since
@@ -997,7 +1216,64 @@ declare class TableComponent<T extends {
997
1216
  protected readonly tableClasses: _angular_core.Signal<string>;
998
1217
  protected readonly isSkeletonLoading: _angular_core.Signal<boolean>;
999
1218
  protected readonly isOverlayLoading: _angular_core.Signal<boolean>;
1000
- /** Client-side sort over the full data set — only when `clientSort()`. */
1219
+ protected readonly effectiveHiddenKeys: _angular_core.Signal<ReadonlySet<string>>;
1220
+ /** Columns in the user-controlled order — `columnOrder` first (dropping
1221
+ * unknown keys), then any declared column the order omitted. */
1222
+ protected readonly orderedColumns: _angular_core.Signal<readonly TableColumn<T>[]>;
1223
+ /** Columns actually rendered — reordered, then hidden ones skipped. */
1224
+ protected readonly visibleColumns: _angular_core.Signal<readonly TableColumn<T>[]>;
1225
+ /** Columns the user may toggle — drives the header column picker. */
1226
+ protected readonly hideableColumns: _angular_core.Signal<readonly TableColumn<T>[]>;
1227
+ protected readonly hasColumnPicker: _angular_core.Signal<boolean>;
1228
+ /** The trailing utility column hosts the picker button and/or row kebabs. */
1229
+ protected readonly hasUtilityColumn: _angular_core.Signal<boolean>;
1230
+ protected isColumnVisible(col: TableColumn<T>): boolean;
1231
+ /** The last visible column can't be hidden — an all-hidden grid is useless. */
1232
+ protected isColumnLocked(col: TableColumn<T>): boolean;
1233
+ protected toggleColumn(col: TableColumn<T>): void;
1234
+ protected moveColumn(col: TableColumn<T>, delta: -1 | 1): void;
1235
+ protected onColumnDrop(event: CdkDragDrop<unknown>): void;
1236
+ protected resetColumns(): void;
1237
+ private readonly columnFilterPopover;
1238
+ /** The column whose filter menu is open — drives the distinct-value list. */
1239
+ protected readonly filterColumn: _angular_core.WritableSignal<TableColumn<T> | null>;
1240
+ protected readonly filterSearch: _angular_core.WritableSignal<string>;
1241
+ protected hasColumnFilter(col: TableColumn<T>): boolean;
1242
+ /** A column is "actively filtered" when at least one of its values is unchecked. */
1243
+ protected isColumnFiltered(col: TableColumn<T>): boolean;
1244
+ private distinctValuesOf;
1245
+ /** Distinct values of the open column, narrowed by the popover search box. */
1246
+ protected readonly filterValues: _angular_core.Signal<string[]>;
1247
+ protected readonly filterSelectedCount: _angular_core.Signal<number>;
1248
+ protected isFilterValueChecked(value: string): boolean;
1249
+ protected onColumnFilterClick(col: TableColumn<T>, event: Event): void;
1250
+ protected onFilterSearch(event: Event): void;
1251
+ protected toggleFilterValue(value: string): void;
1252
+ protected clearColumnFilter(): void;
1253
+ private readonly injector;
1254
+ private readonly editInput;
1255
+ protected readonly editingCell: _angular_core.WritableSignal<{
1256
+ rowId: string;
1257
+ key: string;
1258
+ } | null>;
1259
+ protected readonly editDraft: _angular_core.WritableSignal<string>;
1260
+ protected isEditing(row: T, col: TableColumn<T>): boolean;
1261
+ protected startEdit(row: T, col: TableColumn<T>, event: Event): void;
1262
+ protected onEditInput(event: Event): void;
1263
+ protected commitEdit(row: T, col: TableColumn<T>): void;
1264
+ protected cancelEdit(): void;
1265
+ private static readonly MIN_COLUMN_WIDTH;
1266
+ private resizeState;
1267
+ /** Resolved pixel width for a column: a drag override wins, else `column.width`. */
1268
+ protected columnWidth(col: TableColumn<T>): number | null;
1269
+ protected onResizeStart(col: TableColumn<T>, event: PointerEvent): void;
1270
+ protected onResizeMove(event: PointerEvent): void;
1271
+ protected onResizeEnd(): void;
1272
+ /** Client-side filter over the full data set — combines the `filterQuery`
1273
+ * substring search with any per-column set filters. Sorting and pagination
1274
+ * run on the filtered rows. */
1275
+ protected readonly filteredData: _angular_core.Signal<readonly T[]>;
1276
+ /** Client-side sort over the filtered data set — only when `clientSort()`. */
1001
1277
  protected readonly sortedData: _angular_core.Signal<readonly T[]>;
1002
1278
  /** Current page's slice of the sorted rows, when paginating. */
1003
1279
  protected readonly pagedData: _angular_core.Signal<readonly T[]>;
@@ -1008,16 +1284,41 @@ declare class TableComponent<T extends {
1008
1284
  /** Select-all is page-scoped only when paginating. */
1009
1285
  protected readonly selectAllLabel: _angular_core.Signal<"Select all rows on this page" | "Select all rows">;
1010
1286
  protected readonly skeletonArray: _angular_core.Signal<any[]>;
1011
- /** Total colspan for the expanded-row panel: data cols + optional select + expand col. */
1287
+ /** Total colspan for the expanded-row panel: data cols + optional select/expand/actions cols. */
1012
1288
  protected readonly expandedColspan: _angular_core.Signal<number>;
1289
+ protected readonly hasRowActions: _angular_core.Signal<boolean>;
1290
+ /** Row whose kebab menu is open — drives the per-row `disabled` predicates. */
1291
+ protected readonly menuRow: _angular_core.WritableSignal<T | null>;
1292
+ private readonly rowMenuPopover;
1293
+ private readonly columnPickerPopover;
1294
+ protected readonly columnPickerOpened: _angular_core.Signal<boolean>;
1295
+ protected onColumnPickerClick(event: Event): void;
1296
+ protected readonly hasTruncate: _angular_core.Signal<boolean>;
1297
+ private readonly cellTextPopover;
1298
+ protected readonly cellPopoverText: _angular_core.WritableSignal<string>;
1299
+ /** Click on a `truncate` cell: when the text is actually clipped, show the
1300
+ * full value in a popover; otherwise let the click fall through to the row. */
1301
+ protected onCellClipClick(row: T, col: TableColumn<T>, event: Event): void;
1302
+ private readonly scrollWrap;
1303
+ private readonly hscrollProxy;
1304
+ protected readonly hscrollContentWidth: _angular_core.WritableSignal<number>;
1305
+ protected readonly hscrollNeeded: _angular_core.WritableSignal<boolean>;
1306
+ constructor();
1307
+ private parseDurationMs;
1308
+ protected onRowMenuClick(row: T, event: Event): void;
1309
+ protected isMenuOpenFor(row: T): boolean;
1310
+ protected isActionDisabled(action: TableRowAction<T>): boolean;
1311
+ protected onRowAction(action: TableRowAction<T>): void;
1013
1312
  protected isExpanded(row: T): boolean;
1014
1313
  protected onToggleExpand(row: T, event: Event): void;
1015
1314
  protected isSelected(row: T): boolean;
1016
1315
  protected onToggleAll(event: Event): void;
1017
1316
  protected onToggleRow(row: T, event: Event): void;
1317
+ private selectionBeforeGesture;
1318
+ protected onRowMousedown(): void;
1018
1319
  protected onRowClick(row: T, event: Event): void;
1019
1320
  protected onRowKey(row: T, event: Event): void;
1020
- /** Accessible name for an interactive row, taken from the first column. */
1321
+ /** Accessible name for an interactive row, taken from the first visible column. */
1021
1322
  protected rowAriaLabel(row: T): string;
1022
1323
  /** `aria-sort` value for a header: only meaningful on sortable columns. */
1023
1324
  protected ariaSort(col: TableColumn<T>): 'ascending' | 'descending' | 'none' | null;
@@ -1025,11 +1326,15 @@ declare class TableComponent<T extends {
1025
1326
  protected headerClasses(col: TableColumn<T>): string;
1026
1327
  protected sortIcon(col: TableColumn<T>): 'sortAsc' | 'sortDesc' | 'sort';
1027
1328
  protected cellValue(row: T, col: TableColumn<T>): string;
1329
+ /** Exports the visible columns of the filtered + sorted rows (all rows, not
1330
+ * just the current page) as a CSV download. Call from a consumer button:
1331
+ * `<ds-button (pressed)="table.exportCsv()">`. */
1332
+ exportCsv(filename?: string): void;
1028
1333
  /** Deterministic per-cell width so skeleton rows look organic but stable
1029
1334
  * across re-renders. Mixes column key + row index into one of five widths. */
1030
1335
  protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
1031
1336
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
1032
- 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; }; "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; }; "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; }; "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"; "pageSize": "pageSizeChange"; "page": "pageChange"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "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>;
1033
1338
  }
1034
1339
 
1035
1340
  declare class PaginationComponent {
@@ -1037,16 +1342,13 @@ declare class PaginationComponent {
1037
1342
  readonly total: _angular_core.InputSignal<number>;
1038
1343
  /** Items per page, two-way bound. */
1039
1344
  readonly pageSize: _angular_core.ModelSignal<number>;
1040
- /** 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`. */
1041
1347
  readonly currentPage: _angular_core.ModelSignal<number>;
1042
1348
  /** Preset choices offered in the page-size dropdown. */
1043
1349
  readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
1044
1350
  /** Shows the "Showing X–Y of Z" range label. */
1045
1351
  readonly showLabel: _angular_core.InputSignalWithTransform<boolean, unknown>;
1046
- /** Fires whenever the active page changes, including the reset to page 1 after a size change. */
1047
- readonly pageChange: _angular_core.OutputEmitterRef<number>;
1048
- /** Fires when the page size changes via the size dropdown. */
1049
- readonly pageSizeChange: _angular_core.OutputEmitterRef<number>;
1050
1352
  protected readonly totalPages: _angular_core.Signal<number>;
1051
1353
  protected readonly pageItems: _angular_core.Signal<(number | "ellipsis")[]>;
1052
1354
  protected readonly rangeLabel: _angular_core.Signal<string>;
@@ -1058,7 +1360,7 @@ declare class PaginationComponent {
1058
1360
  protected goTo(page: number): void;
1059
1361
  protected onSizeChange(value: string): void;
1060
1362
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<PaginationComponent, never>;
1061
- 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>;
1062
1364
  }
1063
1365
 
1064
1366
  interface DateFormatSpec {
@@ -1086,7 +1388,6 @@ interface DisplayPart {
1086
1388
  }
1087
1389
 
1088
1390
  type DatePickerMode = 'single' | 'range';
1089
- type DatePickerSize = 'sm' | 'md' | 'lg';
1090
1391
  type DateValue = Date | null;
1091
1392
  type RangeValue = [Date | null, Date | null];
1092
1393
  type DatePickerValue = DateValue | RangeValue;
@@ -1123,7 +1424,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1123
1424
  /** Selection mode — single date or start/end range. */
1124
1425
  readonly mode: _angular_core.InputSignal<DatePickerMode>;
1125
1426
  /** Trigger height — sm/md/lg. */
1126
- readonly size: _angular_core.InputSignal<DatePickerSize>;
1427
+ readonly size: _angular_core.InputSignal<DsSize>;
1127
1428
  /** Selected date (single) or `[start, end]` (range), two-way bound. */
1128
1429
  readonly value: _angular_core.ModelSignal<Date | RangeValue | null>;
1129
1430
  /** Accessible-name fallback only — the mask fills the visible placeholder, not this. */
@@ -1132,6 +1433,10 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1132
1433
  readonly label: _angular_core.InputSignal<string>;
1133
1434
  /** Helper text shown below the field. */
1134
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>;
1135
1440
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
1136
1441
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1137
1442
  /** Shows an "(optional)" marker beside the label — ignored when `required` is set. */
@@ -1160,8 +1465,10 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1160
1465
  readonly dateFormat: _angular_core.InputSignal<string | null>;
1161
1466
  /** First weekday column: 0=Sunday … 6=Saturday. Default 1 (Monday). */
1162
1467
  readonly firstDayOfWeek: _angular_core.InputSignal<number | null>;
1163
- /** Month the calendar opens on when the value is empty (e.g. a Date Of Birth). */
1164
- readonly defaultMonth: _angular_core.InputSignal<Date | null>;
1468
+ /** Date the calendar opens on when the value is empty (e.g. a Date Of Birth):
1469
+ * the panel shows its month and grid focus lands on its exact day.
1470
+ * Never written to `value` — selection stays with the user. */
1471
+ readonly defaultDate: _angular_core.InputSignal<Date | null>;
1165
1472
  /** Allow masked manual typing. When false the trigger is a button (calendar-only). */
1166
1473
  readonly allowInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
1167
1474
  protected readonly isDisabled: _angular_core.Signal<boolean>;
@@ -1297,11 +1604,10 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1297
1604
  protected isPresetDisabled(preset: DatePickerPreset): boolean;
1298
1605
  protected applyPreset(preset: DatePickerPreset): void;
1299
1606
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DatePickerComponent, never>;
1300
- 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; }; "defaultMonth": { "alias": "defaultMonth"; "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>;
1301
1608
  }
1302
1609
 
1303
1610
  type TimePickerMode = 'single' | 'range';
1304
- type TimePickerSize = 'sm' | 'md' | 'lg';
1305
1611
  type TimeFormat = '24h' | '12h';
1306
1612
  /** Canonical stored value: 24h `"HH:MM"`. */
1307
1613
  type TimeValue = string;
@@ -1390,13 +1696,17 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1390
1696
  /** Predicate marking individual times unselectable. */
1391
1697
  readonly disabledTime: _angular_core.InputSignal<((time: string) => boolean) | null>;
1392
1698
  /** Trigger height — sm/md/lg. */
1393
- readonly size: _angular_core.InputSignal<TimePickerSize>;
1699
+ readonly size: _angular_core.InputSignal<DsSize>;
1394
1700
  /** Disables the picker and blocks all interaction. */
1395
1701
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1396
1702
  /** Applies error styling and marks the trigger `aria-invalid`. */
1397
1703
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1398
1704
  /** Helper text shown below the picker. */
1399
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>;
1400
1710
  /** Shown in the trigger when no time is set. */
1401
1711
  readonly placeholder: _angular_core.InputSignal<string>;
1402
1712
  /** Shows an inline clear button when a value is set — single mode only. */
@@ -1430,6 +1740,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1430
1740
  protected ariaLabelFor(segment: Segment): string;
1431
1741
  protected formatFor(value: string | null): string;
1432
1742
  protected open(segment: Segment): void;
1743
+ protected onTriggerClick(segment: Segment): void;
1433
1744
  protected close(): void;
1434
1745
  ngOnDestroy(): void;
1435
1746
  protected onEscape(): void;
@@ -1440,7 +1751,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1440
1751
  private minutesOf;
1441
1752
  private laterOf;
1442
1753
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TimePickerComponent, never>;
1443
- 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>;
1444
1755
  }
1445
1756
 
1446
1757
  interface BreadcrumbItem {
@@ -1488,6 +1799,22 @@ declare class BreadcrumbsService {
1488
1799
  static ɵprov: _angular_core.ɵɵInjectableDeclaration<BreadcrumbsService>;
1489
1800
  }
1490
1801
 
1802
+ /**
1803
+ * Marks projected wordmark markup for `ds-sidenav`: when present, the sidenav
1804
+ * renders the projected content inside `.brand-name` instead of the plain
1805
+ * `brand` text (two-tone wordmarks, inline logos etc. stay consumer-side).
1806
+ *
1807
+ * Interplay: projecting `[dsBrandName]` is enough to render the brand row and
1808
+ * its wordmark even without a string `brand`, but it only supplies the
1809
+ * wordmark — the letter-mark tile still comes from `logoLetter` (or the first
1810
+ * letter of `brand`), so an empty `brand` + projection renders the wordmark
1811
+ * with no tile.
1812
+ */
1813
+ declare class BrandNameDirective {
1814
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<BrandNameDirective, never>;
1815
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BrandNameDirective, "[dsBrandName]", never, {}, {}, never, never, true, never>;
1816
+ }
1817
+
1491
1818
  /** Contract that ds-sidenav-item reads from its parent ds-sidenav. */
1492
1819
  interface SidenavContract {
1493
1820
  readonly collapsed: () => boolean;
@@ -1500,8 +1827,14 @@ declare class SidenavComponent implements SidenavContract {
1500
1827
  /** Brand text at the top of the rail (auto letter-mark + name). For a custom
1501
1828
  * logo image/SVG, project it into the `[brand]` slot instead. */
1502
1829
  readonly brand: _angular_core.InputSignal<string>;
1830
+ /** Letter-mark glyph when it differs from the brand's first letter (e.g. an
1831
+ * "A" tile beside the "MyAdmin" wordmark). Empty = first letter of `brand`. */
1832
+ readonly logoLetter: _angular_core.InputSignal<string>;
1833
+ /** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
1834
+ protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
1835
+ protected readonly hasBrandName: _angular_core.Signal<boolean>;
1503
1836
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavComponent, never>;
1504
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavComponent, "ds-sidenav", never, { "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "brand": { "alias": "brand"; "required": false; "isSignal": true; }; }, {}, never, ["[brand]", "*"], true, never>;
1837
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavComponent, "ds-sidenav", never, { "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "logoLetter": { "alias": "logoLetter"; "required": false; "isSignal": true; }; }, {}, ["brandNameRef"], ["[brand]", "[dsBrandName]", "*"], true, never>;
1505
1838
  }
1506
1839
 
1507
1840
  declare class SidenavGroupComponent {
@@ -1535,13 +1868,19 @@ declare class SidenavItemComponent {
1535
1868
  readonly hasAlert: _angular_core.InputSignalWithTransform<boolean, unknown>;
1536
1869
  /** Disables the item — non-navigable and styled as inactive. */
1537
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>;
1538
1876
  private readonly sidenav;
1877
+ protected onActivate(event: MouseEvent): void;
1539
1878
  /** Tooltip text shown when collapsed; empty string suppresses the tooltip when expanded. */
1540
1879
  protected readonly collapsedTooltip: _angular_core.Signal<string>;
1541
1880
  protected readonly collapsedAriaLabel: _angular_core.Signal<string | null>;
1542
1881
  protected readonly linkClasses: _angular_core.Signal<string>;
1543
1882
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavItemComponent, never>;
1544
- 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>;
1545
1884
  }
1546
1885
 
1547
1886
  interface SidenavItemModel {
@@ -1553,6 +1892,91 @@ interface SidenavItemModel {
1553
1892
  hasAlert?: boolean;
1554
1893
  }
1555
1894
 
1895
+ /**
1896
+ * A notification rendered in the sidenav Alerts popover. The footer is
1897
+ * domain-agnostic: the layout derives its own alerts and feeds them in, and the
1898
+ * footer only knows how to render this shape.
1899
+ */
1900
+ interface SidenavAlertItem {
1901
+ readonly id: string;
1902
+ readonly icon: IconName;
1903
+ /** Tone of the leading icon chip (reuses the DS status palette). */
1904
+ readonly variant: 'success' | 'warning' | 'error' | 'info';
1905
+ readonly title: string;
1906
+ readonly body: string;
1907
+ /** Relative/display timestamp, e.g. "Jul 23". */
1908
+ readonly at: string;
1909
+ /** Optional router path to navigate to when the alert is clicked. */
1910
+ readonly route?: string;
1911
+ }
1912
+ /**
1913
+ * A single global-search hit rendered in the sidenav Search popover. The footer
1914
+ * stays domain-agnostic: the layout supplies a {@link SidenavSearchProvider} that maps
1915
+ * a query string to these results, so the footer never needs to know about the
1916
+ * portal's sections or entities.
1917
+ */
1918
+ interface SidenavSearchResult {
1919
+ readonly id: string;
1920
+ /** Primary line (entity/section name). */
1921
+ readonly label: string;
1922
+ /** Optional secondary line (reference, email, type…). */
1923
+ readonly sublabel?: string;
1924
+ readonly icon?: IconName;
1925
+ /** Group heading the hit is filed under, e.g. "Sections". */
1926
+ readonly group: string;
1927
+ /** Router path to navigate to on select. */
1928
+ readonly route: string;
1929
+ /** Optional query params — used to deep-open in-page detail views. */
1930
+ readonly queryParams?: Record<string, string>;
1931
+ }
1932
+ /** A query -> results function supplied by the layout to the shared footer. */
1933
+ type SidenavSearchProvider = (query: string) => readonly SidenavSearchResult[];
1934
+
1935
+ interface SearchGroup {
1936
+ group: string;
1937
+ items: SidenavSearchResult[];
1938
+ }
1939
+ /**
1940
+ * Bottom block of the app sidenav: quick actions (Search / Alerts / Collapse)
1941
+ * and the signed-in user with an account menu (popover). Pinned to the bottom
1942
+ * via `margin-top: auto`. Collapse is driven by the parent (emits
1943
+ * `collapseToggled`, reflects `collapsed`); sign-out is delegated to the parent
1944
+ * (emits `signOutSelected`) so the layout keeps a single logout path.
1945
+ */
1946
+ declare class SidenavFooterComponent {
1947
+ private readonly router;
1948
+ /** Name shown in the footer's account row. */
1949
+ readonly userName: _angular_core.InputSignal<string>;
1950
+ /** Secondary line under the name (role / organisation). */
1951
+ readonly userRole: _angular_core.InputSignal<string>;
1952
+ /** Show the unread dot on the Alerts row. */
1953
+ readonly alerts: _angular_core.InputSignal<boolean>;
1954
+ /** Mirrors the rail's collapsed state — labels hide, the avatar + icons stay. */
1955
+ readonly collapsed: _angular_core.InputSignal<boolean>;
1956
+ /** When set, the Search row opens a live results popover; unset keeps it inert. */
1957
+ readonly searchProvider: _angular_core.InputSignal<SidenavSearchProvider | null>;
1958
+ /** When non-null (even empty) the Alerts row opens a list popover; null keeps it inert. */
1959
+ readonly alertItems: _angular_core.InputSignal<readonly SidenavAlertItem[] | null>;
1960
+ /** Route for the account menu's "Your profile"; empty = the item is a no-op. */
1961
+ readonly profileRoute: _angular_core.InputSignal<string>;
1962
+ readonly collapseToggled: _angular_core.OutputEmitterRef<void>;
1963
+ /** Emitted when the Alerts popover is opened, so the layout can mark-all-read. */
1964
+ readonly alertsOpened: _angular_core.OutputEmitterRef<void>;
1965
+ /** Emitted when "Sign out" is chosen; the layout owns the actual logout flow. */
1966
+ readonly signOutSelected: _angular_core.OutputEmitterRef<void>;
1967
+ protected readonly query: _angular_core.WritableSignal<string>;
1968
+ protected readonly initials: _angular_core.Signal<string>;
1969
+ /** Run the provider for the current query, grouped by `group` for display. */
1970
+ protected searchGroups(provider: SidenavSearchProvider): SearchGroup[];
1971
+ protected goResult(result: SidenavSearchResult): void;
1972
+ /** Activate the top result (Enter key). Returns whether a result was opened. */
1973
+ protected goFirst(provider: SidenavSearchProvider): boolean;
1974
+ protected goAlert(alert: SidenavAlertItem): void;
1975
+ protected goProfile(): void;
1976
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavFooterComponent, never>;
1977
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavFooterComponent, "ds-sidenav-footer", never, { "userName": { "alias": "userName"; "required": false; "isSignal": true; }; "userRole": { "alias": "userRole"; "required": false; "isSignal": true; }; "alerts": { "alias": "alerts"; "required": false; "isSignal": true; }; "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "searchProvider": { "alias": "searchProvider"; "required": false; "isSignal": true; }; "alertItems": { "alias": "alertItems"; "required": false; "isSignal": true; }; "profileRoute": { "alias": "profileRoute"; "required": false; "isSignal": true; }; }, { "collapseToggled": "collapseToggled"; "alertsOpened": "alertsOpened"; "signOutSelected": "signOutSelected"; }, never, never, true, never>;
1978
+ }
1979
+
1556
1980
  declare class TopBarComponent {
1557
1981
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TopBarComponent, never>;
1558
1982
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<TopBarComponent, "ds-topbar", never, {}, {}, never, ["[title]", "[breadcrumbs]", "[search]", "[actions]"], true, never>;
@@ -1576,10 +2000,10 @@ declare class PageHeaderComponent {
1576
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>;
1577
2001
  }
1578
2002
 
1579
- type ModalSize = 'sm' | 'md' | 'lg' | 'xl' | 'fullscreen';
2003
+ type ModalSize = DsSize | 'xl' | 'fullscreen';
1580
2004
 
1581
2005
  declare class ModalComponent implements OnDestroy {
1582
- private readonly doc;
2006
+ private readonly scrollLock;
1583
2007
  protected readonly preview: DsStaticPreview;
1584
2008
  /** Open state, two-way bound. */
1585
2009
  readonly open: _angular_core.ModelSignal<boolean>;
@@ -1737,7 +2161,7 @@ declare class DropzoneComponent {
1737
2161
  protected readonly dragOver: _angular_core.WritableSignal<boolean>;
1738
2162
  /** Fires with the raw files picked or dropped; the consumer adds them to `files`. */
1739
2163
  readonly filesAdded: _angular_core.OutputEmitterRef<File[]>;
1740
- /** 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. */
1741
2165
  readonly fileRemoved: _angular_core.OutputEmitterRef<DropzoneFile>;
1742
2166
  protected readonly classes: _angular_core.Signal<string>;
1743
2167
  protected onDragOver(event: DragEvent): void;
@@ -1772,7 +2196,9 @@ declare class MenuItemComponent implements OnDestroy {
1772
2196
  private readonly button;
1773
2197
  /** Leading icon shown before the projected label. */
1774
2198
  readonly icon: _angular_core.InputSignal<IconName | null>;
1775
- /** 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. */
1776
2202
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1777
2203
  /** Renders the item in an error/destructive style. */
1778
2204
  readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -1932,6 +2358,7 @@ declare class TooltipDirective implements OnDestroy {
1932
2358
  private readonly tipId;
1933
2359
  protected onOpen(): void;
1934
2360
  protected onClose(): void;
2361
+ private disposeRef;
1935
2362
  protected onEscape(): void;
1936
2363
  private show;
1937
2364
  private positionFor;
@@ -1959,7 +2386,10 @@ declare class PopoverComponent implements OnDestroy, DsOverlayCloseRef {
1959
2386
  private readonly host;
1960
2387
  protected readonly preview: DsStaticPreview;
1961
2388
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown> | undefined>;
2389
+ private readonly panelTrap;
1962
2390
  private ref;
2391
+ private triggerElement;
2392
+ private focusTimer;
1963
2393
  /** Public panel tokens forwarded onto the portaled overlay pane on open so
1964
2394
  * a consumer's `ds-popover { --ds-popover-panel-*: … }` reaches it. */
1965
2395
  private readonly panelTokens;
@@ -1970,9 +2400,10 @@ declare class PopoverComponent implements OnDestroy, DsOverlayCloseRef {
1970
2400
  /** Render a small caret pointing at the trigger. */
1971
2401
  readonly arrow: _angular_core.InputSignalWithTransform<boolean, unknown>;
1972
2402
  /** ARIA role for the panel (e.g. 'dialog' for interactive popovers). When set,
1973
- * the panel also traps focus, auto-captures it into the panel on open, and
1974
- * restores it to the trigger on close (Escape or backdrop). Leave null for
1975
- * plain, non-interactive text popovers. */
2403
+ * the panel traps focus and captures it on open; a keyboard (Escape) or
2404
+ * in-panel close returns focus to the trigger, while an outside click or
2405
+ * scroll leaves focus where it lands (non-modal). Leave null for plain,
2406
+ * non-interactive text popovers. */
1976
2407
  readonly panelRole: _angular_core.InputSignal<string | null>;
1977
2408
  /** Accessible name for the panel; pair with `panelRole`. */
1978
2409
  readonly panelLabel: _angular_core.InputSignal<string | null>;
@@ -2100,15 +2531,14 @@ interface DsToastConfig {
2100
2531
  }
2101
2532
  declare const DS_TOAST_CONFIG: InjectionToken<DsToastConfig>;
2102
2533
 
2103
- type DrawerSize = 'sm' | 'md' | 'lg';
2104
2534
  type DrawerPlacement = 'right' | 'left' | 'top' | 'bottom';
2105
2535
 
2106
2536
  declare class DrawerComponent implements OnDestroy {
2107
- private readonly doc;
2537
+ private readonly scrollLock;
2108
2538
  /** Open state, two-way bound. */
2109
2539
  readonly open: _angular_core.ModelSignal<boolean>;
2110
2540
  /** Panel size — sm/md/lg. */
2111
- readonly size: _angular_core.InputSignal<DrawerSize>;
2541
+ readonly size: _angular_core.InputSignal<DsSize>;
2112
2542
  /** Edge the panel slides in from. */
2113
2543
  readonly placement: _angular_core.InputSignal<DrawerPlacement>;
2114
2544
  /** Drawer title, shown in the header and used for `aria-labelledby`. */
@@ -2155,6 +2585,7 @@ declare class BottomSheetComponent implements OnDestroy {
2155
2585
  */
2156
2586
  readonly snapPoints: _angular_core.InputSignal<readonly number[]>;
2157
2587
  private readonly doc;
2588
+ private readonly scrollLock;
2158
2589
  private readonly sheetRef;
2159
2590
  protected readonly dragOffset: _angular_core.WritableSignal<number | null>;
2160
2591
  /** Sheet is in the DOM (kept true through the leave animation). */
@@ -2169,7 +2600,6 @@ declare class BottomSheetComponent implements OnDestroy {
2169
2600
  private lastMoveY;
2170
2601
  private lastMoveTime;
2171
2602
  private velocity;
2172
- private previousBodyOverflow;
2173
2603
  private wasOpen;
2174
2604
  private closeFallbackTimer;
2175
2605
  constructor();
@@ -2232,7 +2662,6 @@ declare class PageFooterComponent {
2232
2662
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<PageFooterComponent, "ds-page-footer", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["[brand]", "[nav]", "[actions]", "*"], true, never>;
2233
2663
  }
2234
2664
 
2235
- type AutocompleteSize = 'sm' | 'md' | 'lg';
2236
2665
  /** `fill` stretches to the host container (default); `content` hugs chips/value + a min typing area. */
2237
2666
  type AutocompleteWidth = 'fill' | 'content';
2238
2667
  interface AutocompleteOption<T = unknown> {
@@ -2260,7 +2689,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2260
2689
  /** Allows selecting more than one option, shown as removable tags. */
2261
2690
  readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
2262
2691
  /** Trigger height — sm/md/lg. */
2263
- readonly size: _angular_core.InputSignal<AutocompleteSize>;
2692
+ readonly size: _angular_core.InputSignal<DsSize>;
2264
2693
  /** Trigger width — `fill` stretches to the container, `content` hugs the value. */
2265
2694
  readonly width: _angular_core.InputSignal<AutocompleteWidth>;
2266
2695
  /** Placeholder shown in the input when empty. */
@@ -2271,6 +2700,10 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2271
2700
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2272
2701
  /** Helper text shown below the field. */
2273
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>;
2274
2707
  /** Shows a "Create «text»" row when the typed text matches no option. */
2275
2708
  readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
2276
2709
  /** Accessible name for the combobox input. */
@@ -2318,7 +2751,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2318
2751
  protected onCreateNew(): void;
2319
2752
  protected remove(target: T): void;
2320
2753
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent<any>, never>;
2321
- 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>;
2322
2755
  }
2323
2756
 
2324
2757
  type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
@@ -2360,7 +2793,7 @@ declare class DescriptionItemComponent {
2360
2793
  type LayoutGap = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
2361
2794
  type LayoutAlign = 'start' | 'center' | 'end' | 'stretch';
2362
2795
  type LayoutJustify = 'start' | 'center' | 'end' | 'between';
2363
- type ContainerSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
2796
+ type ContainerSize = DsSize | 'xl' | 'full';
2364
2797
 
2365
2798
  declare class StackComponent {
2366
2799
  readonly gap: _angular_core.InputSignal<LayoutGap | null>;
@@ -2505,6 +2938,10 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
2505
2938
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2506
2939
  /** Helper text shown below the cells. */
2507
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>;
2508
2945
  /** Accessible group label for the cell row. */
2509
2946
  readonly ariaLabel: _angular_core.InputSignal<string>;
2510
2947
  /** Fires once, with the full code, on the partial → complete transition. */
@@ -2529,7 +2966,7 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
2529
2966
  private focusBox;
2530
2967
  private sanitize;
2531
2968
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<OtpInputComponent, never>;
2532
- 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>;
2533
2970
  }
2534
2971
 
2535
2972
  type SliderValue = number | readonly [number, number];
@@ -2552,6 +2989,10 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
2552
2989
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2553
2990
  /** Helper text shown below the slider. */
2554
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>;
2555
2996
  private readonly track;
2556
2997
  private dragging;
2557
2998
  protected readonly uid: string;
@@ -2577,11 +3018,9 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
2577
3018
  private setThumb;
2578
3019
  private snap;
2579
3020
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SliderComponent, never>;
2580
- 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>;
2581
3022
  }
2582
3023
 
2583
- type SpinnerSize = 'sm' | 'md' | 'lg';
2584
-
2585
3024
  declare class LoadingOverlayComponent {
2586
3025
  /** Show the scrim + spinner over the projected region. */
2587
3026
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -2590,7 +3029,7 @@ declare class LoadingOverlayComponent {
2590
3029
  /** Backdrop-blur the projected content behind the scrim. */
2591
3030
  readonly blur: _angular_core.InputSignalWithTransform<boolean, unknown>;
2592
3031
  /** Size of the spinner shown in the scrim. */
2593
- readonly spinnerSize: _angular_core.InputSignal<SpinnerSize>;
3032
+ readonly spinnerSize: _angular_core.InputSignal<DsSize>;
2594
3033
  /** Offset the scrim top edge — useful when a sticky header should stay uncovered. */
2595
3034
  readonly insetTop: _angular_core.InputSignal<string>;
2596
3035
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<LoadingOverlayComponent, never>;
@@ -2665,6 +3104,10 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
2665
3104
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2666
3105
  /** Helper text shown below the trigger. */
2667
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>;
2668
3111
  protected readonly trigger: _angular_core.Signal<ElementRef<HTMLButtonElement>>;
2669
3112
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
2670
3113
  protected readonly open: _angular_core.WritableSignal<boolean>;
@@ -2704,7 +3147,7 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
2704
3147
  private updateHue;
2705
3148
  private clampPct;
2706
3149
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColorPickerComponent, never>;
2707
- 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>;
2708
3151
  }
2709
3152
 
2710
3153
  interface MultiSelectOption {
@@ -2736,6 +3179,10 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
2736
3179
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2737
3180
  /** Helper text shown below the field. */
2738
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>;
2739
3186
  /** Accessible name for the trigger — falls back to `placeholder`. */
2740
3187
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2741
3188
  /** Shows a "Select all" row that toggles every filter-matching, enabled option. */
@@ -2772,10 +3219,11 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
2772
3219
  protected onTriggerKeydown(event: KeyboardEvent): void;
2773
3220
  protected onSearchKeydown(event: KeyboardEvent): void;
2774
3221
  protected openPanel(): void;
3222
+ protected onTriggerClick(): void;
2775
3223
  protected close(): void;
2776
3224
  private moveActive;
2777
3225
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
2778
- 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>;
2779
3227
  }
2780
3228
 
2781
3229
  declare class SkeletonComponent {
@@ -2793,13 +3241,11 @@ declare class SkeletonComponent {
2793
3241
 
2794
3242
  declare class SpinnerComponent {
2795
3243
  /** Spinner size — sm/md/lg. */
2796
- readonly size: _angular_core.InputSignal<SpinnerSize>;
3244
+ readonly size: _angular_core.InputSignal<DsSize>;
2797
3245
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SpinnerComponent, never>;
2798
3246
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<SpinnerComponent, "ds-spinner", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
2799
3247
  }
2800
3248
 
2801
- type CheckboxSize = 'sm' | 'md' | 'lg';
2802
-
2803
3249
  declare class CheckboxComponent extends DsBooleanControlValueAccessor {
2804
3250
  /** Checked state, two-way bound. */
2805
3251
  readonly checked: _angular_core.ModelSignal<boolean>;
@@ -2815,8 +3261,12 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
2815
3261
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2816
3262
  /** Helper text shown below the checkbox. */
2817
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>;
2818
3268
  /** Checkbox size — sm/md/lg. */
2819
- readonly size: _angular_core.InputSignal<CheckboxSize>;
3269
+ readonly size: _angular_core.InputSignal<DsSize>;
2820
3270
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
2821
3271
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
2822
3272
  /** Inline label rendered beside the box and wired via for/id. Omit to
@@ -2830,11 +3280,9 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
2830
3280
  protected readonly fieldClass: _angular_core.Signal<string>;
2831
3281
  protected onCheckedChange(event: Event): void;
2832
3282
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<CheckboxComponent, never>;
2833
- 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>;
2834
3284
  }
2835
3285
 
2836
- type RadioSize = 'sm' | 'md' | 'lg';
2837
-
2838
3286
  declare class RadioComponent {
2839
3287
  /** Standalone two-way binding. When inside ds-radio-group, isChecked() is
2840
3288
  * derived from the group value instead. */
@@ -2851,8 +3299,12 @@ declare class RadioComponent {
2851
3299
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2852
3300
  /** Helper text shown below the control. */
2853
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>;
2854
3306
  /** Control size — sm/md/lg. */
2855
- readonly size: _angular_core.InputSignal<RadioSize>;
3307
+ readonly size: _angular_core.InputSignal<DsSize>;
2856
3308
  /** Marks the radio required — shows an asterisk on the label and sets `aria-required`. */
2857
3309
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
2858
3310
  /** Inline label rendered beside the dot and wired via for/id. Omit to bring
@@ -2875,7 +3327,7 @@ declare class RadioComponent {
2875
3327
  focus(): void;
2876
3328
  protected onSelect(): void;
2877
3329
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<RadioComponent, never>;
2878
- 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>;
2879
3331
  }
2880
3332
 
2881
3333
  /** Contract that ds-radio reads from its parent ds-radio-group, injected via
@@ -2907,6 +3359,10 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
2907
3359
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2908
3360
  /** Helper text shown below the group. */
2909
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>;
2910
3366
  /** Accessible name for the group when no visible label is provided. */
2911
3367
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2912
3368
  /** Visible group label; omit to supply your own. */
@@ -2922,11 +3378,9 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
2922
3378
  select(value: unknown): void;
2923
3379
  protected onKeydown(event: KeyboardEvent): void;
2924
3380
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<RadioGroupComponent, never>;
2925
- 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>;
2926
3382
  }
2927
3383
 
2928
- type SwitchSize = 'sm' | 'md' | 'lg';
2929
-
2930
3384
  declare class SwitchComponent extends DsBooleanControlValueAccessor {
2931
3385
  /** On/off state, two-way bound. */
2932
3386
  readonly checked: _angular_core.ModelSignal<boolean>;
@@ -2942,8 +3396,12 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
2942
3396
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2943
3397
  /** Helper text shown below the switch. */
2944
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>;
2945
3403
  /** Switch size — sm/md/lg. */
2946
- readonly size: _angular_core.InputSignal<SwitchSize>;
3404
+ readonly size: _angular_core.InputSignal<DsSize>;
2947
3405
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
2948
3406
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
2949
3407
  /** Inline label rendered beside the track and wired via for/id. Omit to
@@ -2958,8 +3416,25 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
2958
3416
  protected readonly fieldClass: _angular_core.Signal<string>;
2959
3417
  protected onCheckedChange(event: Event): void;
2960
3418
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SwitchComponent, never>;
2961
- 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>;
3420
+ }
3421
+
3422
+ /**
3423
+ * Focuses the field's inner `input`/`textarea` when the click lands on the
3424
+ * frame chrome — padding, a leading/trailing icon, an addon slot — instead of
3425
+ * the control itself. Applied to a field's wrapper element.
3426
+ *
3427
+ * `preventDefault` on that mousedown stops focus from bouncing off the
3428
+ * non-focusable chrome; clicks that land on the control, or on a nested
3429
+ * button/link/other input, are left untouched so caret placement, toggles and
3430
+ * projected controls keep working.
3431
+ */
3432
+ declare class FieldClickFocusDirective {
3433
+ private readonly host;
3434
+ protected onMousedown(event: MouseEvent): void;
3435
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FieldClickFocusDirective, never>;
3436
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
2962
3437
  }
2963
3438
 
2964
- export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BottomSheetComponent, 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, 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, SidenavComponent, 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 };
2965
- 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, SidenavContract, SidenavItemModel, SortChangeEvent, SortDir, SpinnerSize, SplitButtonItem, SplitButtonVariant, StepperLabelPosition, StepperOrientation, SwitchSize, TableColumn, 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 };