@ids-group-ltd/ids-design-system 0.5.1 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -14,6 +14,7 @@ declare const ICONS: {
14
14
  readonly chevronRight: "<path d=\"m9 6 6 6-6 6\" />";
15
15
  readonly chevronLeft: "<path d=\"m15 6-6 6 6 6\" />";
16
16
  readonly chevronUp: "<path d=\"m6 15 6-6 6 6\" />";
17
+ readonly menu: "<path d=\"M4 6h16M4 12h16M4 18h16\" />";
17
18
  readonly arrowRight: "<path d=\"M5 12h14M13 6l6 6-6 6\" />";
18
19
  readonly arrowUp: "<path d=\"M12 19V5M6 11l6-6 6 6\" />";
19
20
  readonly arrowDown: "<path d=\"M12 5v14M6 13l6 6 6-6\" />";
@@ -242,9 +243,13 @@ declare class ButtonComponent {
242
243
  discouraged for ALL colours — prefer the global `.link` class; it stays for
243
244
  cases needing the ds-button API (loading/fullWidth/typed pressed). */
244
245
  readonly variant: _angular_core.InputSignal<ButtonVariant>;
246
+ /** Button height — sm/md/lg. */
245
247
  readonly size: _angular_core.InputSignal<ButtonSize>;
248
+ /** Native `<button>` `type` attribute. */
246
249
  readonly type: _angular_core.InputSignal<ButtonType>;
250
+ /** Disables the button and blocks `pressed`. */
247
251
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
252
+ /** Busy state — disables interaction and sets `aria-busy`. */
248
253
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
249
254
  /** Stretch the button to fill its container — the host becomes block-level
250
255
  and 100% wide (the inner control is already full-width). Use for mobile
@@ -253,14 +258,17 @@ declare class ButtonComponent {
253
258
  /** Accessible name — forwarded to the inner <button> as aria-label. Use when
254
259
  the visible label is absent or non-descriptive. */
255
260
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
261
+ /** Leading icon, before the projected content. */
256
262
  readonly icon: _angular_core.InputSignal<IconName | null>;
263
+ /** Trailing icon, after the projected content. */
257
264
  readonly trailingIcon: _angular_core.InputSignal<IconName | null>;
258
265
  /** ARIA `aria-haspopup`, forwarded to the inner <button> — set when this
259
266
  * button triggers a menu/dialog/listbox overlay. */
260
- readonly ariaHasPopup: _angular_core.InputSignal<"grid" | "true" | "menu" | "listbox" | "tree" | "dialog" | null>;
267
+ readonly ariaHasPopup: _angular_core.InputSignal<"menu" | "grid" | "true" | "listbox" | "tree" | "dialog" | null>;
261
268
  /** ARIA `aria-expanded`, forwarded to the inner <button> — bind to the
262
269
  * overlay's open state on a trigger button. */
263
270
  readonly ariaExpanded: _angular_core.InputSignal<boolean | null>;
271
+ /** Fires on click, unless `disabled` or `loading`. */
264
272
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
265
273
  /** The inner native <button>, exposed so overlay triggers can position
266
274
  * against and restore focus to the real focusable element — e.g.
@@ -277,8 +285,11 @@ declare class ButtonComponent {
277
285
  * leading icon and a projected label. Distinct from `ds-segmented` (a
278
286
  * one-of-many value toggle) — this is a standalone on/off control. */
279
287
  declare class ToggleButtonComponent {
288
+ /** Pressed (on/off) state; two-way bound. */
280
289
  readonly pressed: _angular_core.ModelSignal<boolean>;
290
+ /** Optional leading icon name. */
281
291
  readonly icon: _angular_core.InputSignal<string>;
292
+ /** Disables the toggle. */
282
293
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
283
294
  protected toggle(): void;
284
295
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToggleButtonComponent, never>;
@@ -296,17 +307,24 @@ type IconButtonType = 'button' | 'submit' | 'reset';
296
307
  * for labelled actions. `ariaLabel` is REQUIRED (icon-only has no text label).
297
308
  */
298
309
  declare class IconButtonComponent {
310
+ /** Icon to render — the button's only visible content. */
299
311
  readonly icon: _angular_core.InputSignal<IconName>;
312
+ /** Accessible name — required since the button has no visible text. */
300
313
  readonly ariaLabel: _angular_core.InputSignal<string>;
314
+ /** Fill style — standard (chromeless), filled, tonal, or outlined. */
301
315
  readonly variant: _angular_core.InputSignal<IconButtonVariant>;
302
316
  /** Brand/status hue family (shared with ds-button). `variant` is the fill
303
317
  axis; `color` recolours the accent the fill consumes. Default primary. */
304
318
  readonly color: _angular_core.InputSignal<ButtonColor>;
319
+ /** Button size — sm/md/lg, matches the field/button height scale. */
305
320
  readonly size: _angular_core.InputSignal<IconButtonSize>;
321
+ /** Native `button` type attribute. */
306
322
  readonly type: _angular_core.InputSignal<IconButtonType>;
323
+ /** Disables the button and blocks `pressed`. */
307
324
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
308
325
  /** Toggle state — renders the pressed/active look and sets aria-pressed. */
309
326
  readonly selected: _angular_core.InputSignalWithTransform<boolean, unknown>;
327
+ /** Fires on click, unless disabled. */
310
328
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
311
329
  protected readonly classes: _angular_core.Signal<string>;
312
330
  protected readonly iconSize: _angular_core.Signal<16 | 24 | 20>;
@@ -318,9 +336,13 @@ declare class IconButtonComponent {
318
336
  declare class BadgeComponent {
319
337
  /** Consumer-defined status key; colours are wired via styles/status. Unset → neutral. */
320
338
  readonly status: _angular_core.InputSignal<string | undefined>;
339
+ /** Shows a status dot; only rendered when `count` is unset. */
321
340
  readonly withDot: _angular_core.InputSignalWithTransform<boolean, unknown>;
341
+ /** Solid accent fill instead of the default subtle background. */
322
342
  readonly solid: _angular_core.InputSignalWithTransform<boolean, unknown>;
343
+ /** Numeric count to display; overrides projected content when set. */
323
344
  readonly count: _angular_core.InputSignal<number | null>;
345
+ /** Count is capped at this value, shown as `"max+"` beyond it. */
324
346
  readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
325
347
  /** Display text for the count, capped at max+. */
326
348
  protected readonly countDisplay: _angular_core.Signal<string | null>;
@@ -343,8 +365,11 @@ type AvatarSize = 'xs' | 'sm' | 'md' | 'lg';
343
365
  type AvatarStatus = 'online' | 'offline' | 'away' | 'busy';
344
366
 
345
367
  declare class AvatarComponent {
368
+ /** Diameter — xs/sm/lg apply a size class; md is the default. */
346
369
  readonly size: _angular_core.InputSignal<AvatarSize>;
370
+ /** Fallback text shown when there's no `imageUrl`. */
347
371
  readonly initials: _angular_core.InputSignal<string>;
372
+ /** Image source; shown before `initials` or `fallbackIcon` when set. */
348
373
  readonly imageUrl: _angular_core.InputSignal<string | null>;
349
374
  /** Accessible name. When omitted, the avatar is treated as decorative
350
375
  * (hidden from AT) — correct when a visible name sits beside it. */
@@ -370,7 +395,9 @@ declare class AvatarComponent {
370
395
  }
371
396
 
372
397
  declare class AvatarGroupComponent {
398
+ /** Maximum avatars shown before the rest collapse into an overflow chip. */
373
399
  readonly max: _angular_core.InputSignal<number>;
400
+ /** Total avatar count driving the `+N` overflow; null counts the projected children. */
374
401
  readonly total: _angular_core.InputSignal<number | null>;
375
402
  protected readonly overflow: _angular_core.Signal<number | null>;
376
403
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AvatarGroupComponent, never>;
@@ -381,8 +408,11 @@ type CardElevation = 'flat' | 'raised' | 'hover' | 'interactive';
381
408
  type CardPadding = 'none' | 'sm' | 'md' | 'lg';
382
409
 
383
410
  declare class CardComponent {
411
+ /** Visual treatment; `interactive` makes the card clickable and emits `pressed`. */
384
412
  readonly elevation: _angular_core.InputSignal<CardElevation>;
413
+ /** Inner padding preset; `null` keeps the card's default padding. */
385
414
  readonly padding: _angular_core.InputSignal<CardPadding | null>;
415
+ /** Fires the click event when `elevation` is `interactive`. */
386
416
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
387
417
  protected readonly interactive: _angular_core.Signal<boolean>;
388
418
  protected readonly classes: _angular_core.Signal<string>;
@@ -392,14 +422,23 @@ declare class CardComponent {
392
422
  }
393
423
 
394
424
  declare class StatComponent {
425
+ /** Metric name shown above the value. */
395
426
  readonly label: _angular_core.InputSignal<string>;
427
+ /** Headline metric; `unit` is appended directly after it. */
396
428
  readonly value: _angular_core.InputSignal<string | number>;
429
+ /** Change amount; sign drives the up/down arrow and color. */
397
430
  readonly delta: _angular_core.InputSignal<number | null>;
431
+ /** Suffix appended after the delta's magnitude, e.g. "vs last month". */
398
432
  readonly deltaLabel: _angular_core.InputSignal<string>;
433
+ /** Overrides the automatic up/down coloring of the delta. */
399
434
  readonly deltaTone: _angular_core.InputSignal<"secondary" | "neutral" | null>;
435
+ /** Secondary text shown below the value when there's no `delta`. */
400
436
  readonly caption: _angular_core.InputSignal<string>;
437
+ /** Suffix appended directly after `value`, e.g. "%". */
401
438
  readonly unit: _angular_core.InputSignal<string>;
439
+ /** `error` applies the error color treatment. */
402
440
  readonly variant: _angular_core.InputSignal<"error" | "default">;
441
+ /** Controls the stat's overall type scale. */
403
442
  readonly size: _angular_core.InputSignal<"sm" | "md" | "lg">;
404
443
  protected readonly deltaClasses: _angular_core.Signal<string>;
405
444
  protected readonly deltaIcon: _angular_core.Signal<"arrowUp" | "arrowDown" | null>;
@@ -409,9 +448,13 @@ declare class StatComponent {
409
448
  }
410
449
 
411
450
  declare class TabComponent {
451
+ /** Text shown in the tab button. */
412
452
  readonly label: _angular_core.InputSignal<string>;
453
+ /** Icon shown before the label. */
413
454
  readonly icon: _angular_core.InputSignal<IconName | null>;
455
+ /** Numeric badge shown after the label. */
414
456
  readonly count: _angular_core.InputSignal<number | null>;
457
+ /** Excludes the tab from selection and keyboard navigation. */
415
458
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
416
459
  /** Identifier emitted by tabClosed. Falls back to label when omitted. */
417
460
  readonly value: _angular_core.InputSignal<string | null>;
@@ -424,7 +467,9 @@ type TabsVariant = 'line' | 'pills';
424
467
  type TabsOrientation = 'horizontal' | 'vertical';
425
468
 
426
469
  declare class TabsComponent {
470
+ /** Index of the active tab, two-way bound. */
427
471
  readonly selectedIndex: _angular_core.ModelSignal<number>;
472
+ /** Visual style of the tab strip. */
428
473
  readonly variant: _angular_core.InputSignal<TabsVariant>;
429
474
  /** When true, a tab's content is instantiated only on first activation and
430
475
  kept alive thereafter. When false (default), all panels render eagerly. */
@@ -525,15 +570,25 @@ type InputSize = 'sm' | 'md' | 'lg';
525
570
  type InputType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search';
526
571
 
527
572
  declare class InputComponent extends DsControlValueAccessor<string> {
573
+ /** Text value, two-way bound. */
528
574
  readonly value: _angular_core.ModelSignal<string>;
575
+ /** Native input type — also affects the default clear button and password toggle. */
529
576
  readonly type: _angular_core.InputSignal<InputType>;
577
+ /** Field height — sm/md/lg. */
530
578
  readonly size: _angular_core.InputSignal<InputSize>;
579
+ /** Label shown above the field, or inside it when `floating`. */
531
580
  readonly label: _angular_core.InputSignal<string>;
581
+ /** Helper text shown below the field. */
532
582
  readonly hint: _angular_core.InputSignal<string>;
583
+ /** Placeholder shown when empty. */
533
584
  readonly placeholder: _angular_core.InputSignal<string>;
585
+ /** Disables the field and blocks all interaction. */
534
586
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
587
+ /** Prevents editing while still allowing focus and selection. */
535
588
  readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
589
+ /** Applies error styling and marks the field `aria-invalid`. */
536
590
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
591
+ /** Applies success styling to the field. */
537
592
  readonly success: _angular_core.InputSignalWithTransform<boolean, unknown>;
538
593
  /** Shows a trailing spinner — e.g. async validation in flight. The input
539
594
  * stays editable; pair with a `hint` like "Checking availability…". */
@@ -541,16 +596,25 @@ declare class InputComponent extends DsControlValueAccessor<string> {
541
596
  /** Floating-label variant — the label sits inside a taller control instead
542
597
  * of stacked above it. */
543
598
  readonly floating: _angular_core.InputSignalWithTransform<boolean, unknown>;
599
+ /** Reserves space for a leading addon projected into `[dsInputPrefix]`. */
544
600
  readonly withAddon: _angular_core.InputSignalWithTransform<boolean, unknown>;
601
+ /** Reserves space for a trailing addon projected into `[dsInputSuffix]`. */
545
602
  readonly withAddonRight: _angular_core.InputSignalWithTransform<boolean, unknown>;
603
+ /** Marks the field required — shows an asterisk and sets `aria-required`. */
546
604
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
605
+ /** Shows an "(optional)" marker next to the label (ignored when `required`). */
547
606
  readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
607
+ /** Native `name` attribute. */
548
608
  readonly name: _angular_core.InputSignal<string | null>;
609
+ /** Native `min` attribute — applies when `type="number"`. */
549
610
  readonly min: _angular_core.InputSignal<number | null>;
611
+ /** Native `max` attribute — applies when `type="number"`. */
550
612
  readonly max: _angular_core.InputSignal<number | null>;
613
+ /** Native `step` attribute — applies when `type="number"`. */
551
614
  readonly step: _angular_core.InputSignal<number | null>;
552
615
  /** Native autocomplete token (e.g. "email", "current-password"). */
553
616
  readonly autocomplete: _angular_core.InputSignal<string | null>;
617
+ /** Focuses the field automatically on render. */
554
618
  readonly autofocus: _angular_core.InputSignalWithTransform<boolean, unknown>;
555
619
  /** Accessible name when no visible `label` is provided (falls back to the
556
620
  * placeholder so the control is never unnamed). */
@@ -560,6 +624,7 @@ declare class InputComponent extends DsControlValueAccessor<string> {
560
624
  readonly maxLength: _angular_core.InputSignal<number | null>;
561
625
  /** Mobile keyboard hints — forwarded to the native input as attributes. */
562
626
  readonly enterKeyHint: _angular_core.InputSignal<"search" | "enter" | "done" | "go" | "next" | "previous" | "send" | null>;
627
+ /** Native `inputmode` attribute — hints the on-screen keyboard layout. */
563
628
  readonly inputMode: _angular_core.InputSignal<"search" | "text" | "none" | "email" | "tel" | "url" | "decimal" | "numeric" | null>;
564
629
  /** Emits when the native input loses focus. */
565
630
  readonly blurred: _angular_core.OutputEmitterRef<void>;
@@ -571,7 +636,9 @@ declare class InputComponent extends DsControlValueAccessor<string> {
571
636
  * an explicit boolean to override.
572
637
  */
573
638
  readonly clearable: _angular_core.InputSignal<boolean | null>;
639
+ /** Shows a show/hide button when `type="password"`. */
574
640
  readonly passwordToggle: _angular_core.InputSignalWithTransform<boolean, unknown>;
641
+ /** Whether the password is currently shown as plain text, two-way bound. */
575
642
  readonly passwordVisible: _angular_core.ModelSignal<boolean>;
576
643
  protected readonly canClear: _angular_core.Signal<boolean>;
577
644
  protected readonly uid: string;
@@ -595,11 +662,17 @@ declare class InputComponent extends DsControlValueAccessor<string> {
595
662
  type NumberStepperSize = 'sm' | 'md' | 'lg';
596
663
 
597
664
  declare class NumberStepperComponent {
665
+ /** Current numeric value, two-way bound. */
598
666
  readonly value: _angular_core.ModelSignal<number>;
667
+ /** Lower bound — the decrement button and typed input clamp to it. */
599
668
  readonly min: _angular_core.InputSignal<number>;
669
+ /** Upper bound — the increment button and typed input clamp to it; unbounded when null. */
600
670
  readonly max: _angular_core.InputSignal<number | null>;
671
+ /** Amount added or subtracted per increment/decrement. */
601
672
  readonly step: _angular_core.InputSignal<number>;
673
+ /** Control height — sm/md/lg. */
602
674
  readonly size: _angular_core.InputSignal<NumberStepperSize>;
675
+ /** Disables the stepper and blocks all interaction. */
603
676
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
604
677
  /** Accessible name for the number input (the stepper has no visible label). */
605
678
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
@@ -617,21 +690,37 @@ type TextareaSize = 'sm' | 'md' | 'lg';
617
690
  type TextareaResize = 'none' | 'vertical' | 'horizontal' | 'both';
618
691
 
619
692
  declare class TextareaComponent extends DsControlValueAccessor<string> {
693
+ /** Text value, two-way bound. */
620
694
  readonly value: _angular_core.ModelSignal<string>;
695
+ /** Field height — sm/md/lg. */
621
696
  readonly size: _angular_core.InputSignal<TextareaSize>;
697
+ /** Label shown above the field. */
622
698
  readonly label: _angular_core.InputSignal<string>;
699
+ /** Helper text shown below the field. */
623
700
  readonly hint: _angular_core.InputSignal<string>;
701
+ /** Placeholder shown when empty. */
624
702
  readonly placeholder: _angular_core.InputSignal<string>;
703
+ /** Disables the field and blocks all interaction. */
625
704
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
705
+ /** Prevents editing while still allowing focus and selection. */
626
706
  readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
707
+ /** Applies error styling and marks the field `aria-invalid`. */
627
708
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
709
+ /** Marks the field required — shows an asterisk and sets `aria-required`. */
628
710
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
711
+ /** Shows an "(optional)" marker next to the label (ignored when `required`). */
629
712
  readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
713
+ /** Native `rows` attribute — visible line count. */
630
714
  readonly rows: _angular_core.InputSignal<number>;
715
+ /** Native `name` attribute. */
631
716
  readonly name: _angular_core.InputSignal<string | null>;
717
+ /** Grows the field with content instead of scrolling; forces `resize` to none. */
632
718
  readonly autosize: _angular_core.InputSignalWithTransform<boolean, unknown>;
719
+ /** Minimum height in lines when `autosize`. */
633
720
  readonly minRows: _angular_core.InputSignal<number | null>;
721
+ /** Maximum height in lines when `autosize`, beyond which it scrolls. */
634
722
  readonly maxRows: _angular_core.InputSignal<number | null>;
723
+ /** Native CSS `resize` behaviour — ignored when `autosize`. */
635
724
  readonly resize: _angular_core.InputSignal<TextareaResize>;
636
725
  /** Accessible name when no visible `label` is provided. */
637
726
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
@@ -655,14 +744,19 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
655
744
  }
656
745
 
657
746
  declare class SearchComponent {
747
+ /** Search text, two-way bound. */
658
748
  readonly value: _angular_core.ModelSignal<string>;
749
+ /** Placeholder shown when empty. */
659
750
  readonly placeholder: _angular_core.InputSignal<string>;
751
+ /** Keyboard shortcut hint rendered in a trailing `<kbd>` badge. */
660
752
  readonly shortcut: _angular_core.InputSignal<string>;
753
+ /** Shows the leading search icon. */
661
754
  readonly showIcon: _angular_core.InputSignalWithTransform<boolean, unknown>;
662
755
  /** Show an inline clear (×) button on the right when there's a value. */
663
756
  readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
664
757
  /** Accessible name for the input (placeholder is not a reliable label). */
665
758
  readonly ariaLabel: _angular_core.InputSignal<string>;
759
+ /** Fires with the current value on Enter. */
666
760
  readonly submitted: _angular_core.OutputEmitterRef<string>;
667
761
  private readonly inputEl;
668
762
  protected onSubmit(): void;
@@ -699,20 +793,33 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
699
793
  private readonly overlay;
700
794
  private readonly vcr;
701
795
  protected readonly preview: DsStaticPreview;
796
+ /** Selected option's value, two-way bound. */
702
797
  readonly value: _angular_core.ModelSignal<string>;
798
+ /** Flat options or option groups rendered in the dropdown panel. */
703
799
  readonly options: _angular_core.InputSignal<SelectItem[]>;
800
+ /** Shown in the trigger when nothing is selected. */
704
801
  readonly placeholder: _angular_core.InputSignal<string>;
802
+ /** Trigger height — sm/md/lg. */
705
803
  readonly size: _angular_core.InputSignal<SelectSize>;
804
+ /** Label shown above the trigger. */
706
805
  readonly label: _angular_core.InputSignal<string>;
806
+ /** Disables the trigger and blocks all interaction. */
707
807
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
808
+ /** Prevents opening the dropdown while still allowing focus. */
708
809
  readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
810
+ /** Applies error styling and marks the trigger `aria-invalid`. */
709
811
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
812
+ /** Helper text shown below the trigger. */
710
813
  readonly hint: _angular_core.InputSignal<string>;
814
+ /** Marks the field required — shows an asterisk and sets `aria-required`. */
711
815
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
816
+ /** Shows an "(optional)" marker next to the label (ignored when `required`). */
712
817
  readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
818
+ /** Native `name` attribute forwarded to the trigger. */
713
819
  readonly name: _angular_core.InputSignal<string | null>;
714
820
  /** Accessible name when no visible `label` is provided. */
715
821
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
822
+ /** Shows an inline clear (×) button when a value is selected. */
716
823
  readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
717
824
  protected readonly uid: string;
718
825
  protected readonly labelId: string;
@@ -805,8 +912,11 @@ interface SortChangeEvent {
805
912
  declare class TableComponent<T extends {
806
913
  id: string;
807
914
  }> {
915
+ /** Rows to render. */
808
916
  readonly data: _angular_core.InputSignal<readonly T[]>;
917
+ /** Column definitions driving headers, cells and sorting. */
809
918
  readonly columns: _angular_core.InputSignal<readonly TableColumn<T>[]>;
919
+ /** Adds a checkbox column for row/select-all selection. */
810
920
  readonly selectable: _angular_core.InputSignalWithTransform<boolean, unknown>;
811
921
  /** Opt-in outer border + radius. Off by default so tables flush inside a
812
922
  * `<ds-card padding="none">` (workspaces, programs-list) don't double-border.
@@ -819,10 +929,15 @@ declare class TableComponent<T extends {
819
929
  * 'overlay' — re-fetch indicator; existing rows stay visible behind
820
930
  * a translucent overlay with a centred spinner. */
821
931
  readonly loading: _angular_core.InputSignal<false | "skeleton" | "overlay">;
932
+ /** Keeps the header row pinned while the body scrolls. */
822
933
  readonly stickyHeader: _angular_core.InputSignalWithTransform<boolean, unknown>;
934
+ /** Two-way set of currently selected row ids. */
823
935
  readonly selectedIds: _angular_core.ModelSignal<Set<string>>;
936
+ /** Column key currently sorted by; `null` when unsorted. */
824
937
  readonly sortKey: _angular_core.ModelSignal<string | null>;
938
+ /** Sort direction for `sortKey`. */
825
939
  readonly sortDir: _angular_core.ModelSignal<SortDir>;
940
+ /** Number of shimmer rows rendered while `loading` is `'skeleton'`. */
826
941
  readonly skeletonRows: _angular_core.InputSignal<number>;
827
942
  /** Accessible name for the table (rendered as a visually-hidden caption).
828
943
  * Without it, screen-reader users get an unlabelled table. */
@@ -836,13 +951,16 @@ declare class TableComponent<T extends {
836
951
  readonly pageSize: _angular_core.ModelSignal<number | null>;
837
952
  /** Current 1-based page. Only meaningful when `pageSize()` is set. */
838
953
  readonly page: _angular_core.ModelSignal<number>;
954
+ /** Selectable page-size choices shown in the pagination control. */
839
955
  readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
840
956
  /** When true, the table sorts `data()` itself; otherwise it only emits
841
957
  * `sortChange` and leaves ordering to the consumer (default). */
842
958
  readonly clientSort: _angular_core.InputSignalWithTransform<boolean, unknown>;
843
959
  /** Pin the first data column (and the select column) on horizontal scroll. */
844
960
  readonly stickyFirstColumn: _angular_core.InputSignalWithTransform<boolean, unknown>;
961
+ /** Fires with the row on click (or Enter/Space when `rowInteractive`). */
845
962
  readonly rowClicked: _angular_core.OutputEmitterRef<T>;
963
+ /** Fires whenever sort key/direction changes, regardless of `clientSort`. */
846
964
  readonly sortChange: _angular_core.OutputEmitterRef<SortChangeEvent>;
847
965
  /** Cell templates supplied as an explicit map instead of (or in addition to)
848
966
  * projected `dsCellTemplate` directives. Lets a wrapper component (e.g.
@@ -915,12 +1033,19 @@ declare class TableComponent<T extends {
915
1033
  }
916
1034
 
917
1035
  declare class PaginationComponent {
1036
+ /** Total item count, used to compute the page count. */
918
1037
  readonly total: _angular_core.InputSignal<number>;
1038
+ /** Items per page, two-way bound. */
919
1039
  readonly pageSize: _angular_core.ModelSignal<number>;
1040
+ /** 1-based active page, two-way bound. */
920
1041
  readonly currentPage: _angular_core.ModelSignal<number>;
1042
+ /** Preset choices offered in the page-size dropdown. */
921
1043
  readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
1044
+ /** Shows the "Showing X–Y of Z" range label. */
922
1045
  readonly showLabel: _angular_core.InputSignalWithTransform<boolean, unknown>;
1046
+ /** Fires whenever the active page changes, including the reset to page 1 after a size change. */
923
1047
  readonly pageChange: _angular_core.OutputEmitterRef<number>;
1048
+ /** Fires when the page size changes via the size dropdown. */
924
1049
  readonly pageSizeChange: _angular_core.OutputEmitterRef<number>;
925
1050
  protected readonly totalPages: _angular_core.Signal<number>;
926
1051
  protected readonly pageItems: _angular_core.Signal<(number | "ellipsis")[]>;
@@ -945,6 +1070,20 @@ interface DateFormatSpec {
945
1070
  length: number;
946
1071
  }[];
947
1072
  }
1073
+ /** One editable digit slot in the masked field. */
1074
+ interface FieldSlot {
1075
+ type: 'D' | 'M' | 'Y';
1076
+ maxLength: number;
1077
+ }
1078
+ /** Field layout: the slots and the literal shown after each (except the last). */
1079
+ interface FieldLayout {
1080
+ slots: FieldSlot[];
1081
+ literals: string[];
1082
+ }
1083
+ interface DisplayPart {
1084
+ text: string;
1085
+ muted: boolean;
1086
+ }
948
1087
 
949
1088
  type DatePickerMode = 'single' | 'range';
950
1089
  type DatePickerSize = 'sm' | 'md' | 'lg';
@@ -969,6 +1108,10 @@ interface DayCell {
969
1108
  }
970
1109
  declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeValue | null> implements OnDestroy {
971
1110
  constructor();
1111
+ /** Field text for the DOM: fixed-width `_`-padded once any digit exists,
1112
+ * else '' (so an untouched field is genuinely empty — no error on blur,
1113
+ * nothing for AT to read out). */
1114
+ private toFieldText;
972
1115
  private readonly overlay;
973
1116
  private readonly vcr;
974
1117
  private readonly injector;
@@ -977,20 +1120,31 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
977
1120
  /** Public panel tokens forwarded onto the portaled overlay pane on open so
978
1121
  * a consumer's `ds-date-picker { --ds-date-picker-panel-*: … }` reaches it. */
979
1122
  private readonly panelTokens;
1123
+ /** Selection mode — single date or start/end range. */
980
1124
  readonly mode: _angular_core.InputSignal<DatePickerMode>;
1125
+ /** Trigger height — sm/md/lg. */
981
1126
  readonly size: _angular_core.InputSignal<DatePickerSize>;
1127
+ /** Selected date (single) or `[start, end]` (range), two-way bound. */
982
1128
  readonly value: _angular_core.ModelSignal<Date | RangeValue | null>;
1129
+ /** Accessible-name fallback only — the mask fills the visible placeholder, not this. */
983
1130
  readonly placeholder: _angular_core.InputSignal<string>;
1131
+ /** Field label shown above the trigger. */
984
1132
  readonly label: _angular_core.InputSignal<string>;
1133
+ /** Helper text shown below the field. */
985
1134
  readonly hint: _angular_core.InputSignal<string>;
1135
+ /** Marks the field required — shows an asterisk and sets `aria-required`. */
986
1136
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1137
+ /** Shows an "(optional)" marker beside the label — ignored when `required` is set. */
987
1138
  readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
1139
+ /** Disables the picker and blocks all interaction. */
988
1140
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1141
+ /** Applies error styling and marks the trigger `aria-invalid`. */
989
1142
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
990
1143
  /** Accessible name when no visible `label` is provided. */
991
1144
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
992
1145
  /** Bounds for the year dropdown in the calendar header. */
993
1146
  readonly minYear: _angular_core.InputSignal<number>;
1147
+ /** Upper bound for the year dropdown in the calendar header. */
994
1148
  readonly maxYear: _angular_core.InputSignal<number>;
995
1149
  /** Earliest selectable date (inclusive). Days before this are disabled. */
996
1150
  readonly minDate: _angular_core.InputSignal<Date | null>;
@@ -1018,6 +1172,8 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1018
1172
  protected readonly resolvedLocale: _angular_core.Signal<string>;
1019
1173
  protected readonly resolvedFirstDay: _angular_core.Signal<number>;
1020
1174
  protected readonly formatSpec: _angular_core.Signal<DateFormatSpec>;
1175
+ /** Slot/literal layout for the current mode — single date or doubled range. */
1176
+ protected readonly layout: _angular_core.Signal<FieldLayout>;
1021
1177
  protected readonly monthNames: _angular_core.Signal<string[]>;
1022
1178
  protected readonly weekdays: _angular_core.Signal<string[]>;
1023
1179
  /** Full weekday names for the grid column headers' accessible names. */
@@ -1060,12 +1216,13 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1060
1216
  protected readonly fieldPlaceholder: _angular_core.Signal<string>;
1061
1217
  /** `size` attribute so the field hugs its mask width instead of stretching.
1062
1218
  * +1 covers `size` under-counting the mask's wide glyphs (M/D/Y), which
1063
- * otherwise clip the last chars of the longer range mask. Digits render with
1064
- * `tabular-nums` so the width never shifts as you type. */
1219
+ * otherwise clip the last chars of the longer range mask. The field's
1220
+ * `font-family: var(--font-mono)` keeps every glyph equal width, so the
1221
+ * width never shifts as you type. */
1065
1222
  protected readonly fieldSize: _angular_core.Signal<number>;
1066
- /** Still-empty tail of the mask, kept visible as a ghost while typing so the
1067
- * format never disappears (after "12/" the field reads "12/DD/YYYY"). */
1068
- protected readonly ghostRemainder: _angular_core.Signal<string>;
1223
+ /** Per-slot overlay runs: digits at normal weight, unfilled positions
1224
+ * (format letters or `_` padding) muted — see displayParts(). */
1225
+ protected readonly displaySlots: _angular_core.Signal<DisplayPart[]>;
1069
1226
  protected readonly monthMenuOpen: _angular_core.WritableSignal<boolean>;
1070
1227
  protected readonly yearMenuOpen: _angular_core.WritableSignal<boolean>;
1071
1228
  protected readonly viewMonthIndex: _angular_core.Signal<number>;
@@ -1094,18 +1251,44 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1094
1251
  protected close(): void;
1095
1252
  ngOnDestroy(): void;
1096
1253
  protected onFieldClick(): void;
1254
+ private mobileEdit;
1097
1255
  protected onFieldInput(event: Event): void;
1098
- /** Backspace/Delete hop over mask separators — only digits are editable. */
1256
+ /** Physical-keyboard editing (desktop): typed digits fill the caret's slot;
1257
+ * Backspace/Delete never shift digits across a separator. Delegates to the
1258
+ * shared segment editor. */
1099
1259
  protected onFieldKeydown(event: KeyboardEvent): void;
1260
+ /** Mobile keyboards don't fire a reliable `keydown` (Gboard reports keyCode 229 /
1261
+ * "Unidentified"), so edits are routed here via `beforeinput`'s `inputType` instead.
1262
+ * Android Chrome can also ignore `preventDefault()` here, so the intended result is
1263
+ * stashed and re-asserted in `onFieldInput`; the microtask expires the stash once
1264
+ * preventDefault worked (no following `input` in the same task). */
1265
+ protected onFieldBeforeInput(event: InputEvent): void;
1266
+ /** Apply one segment edit (type a digit / Backspace / Delete) at the caret or
1267
+ * over the selection, then write the fixed-width value + caret back. A
1268
+ * selection is cleared through the model so `_` placeholders are never
1269
+ * natively erased — only digits are editable. Shared by keydown + beforeinput. */
1270
+ private runSegmentEdit;
1271
+ /** Paste digits into the segment model at the caret slot — never a global
1272
+ * flatten — so existing digits elsewhere in the field survive untouched. */
1273
+ protected onFieldPaste(event: ClipboardEvent): void;
1100
1274
  private countDigits;
1101
- private removeDigit;
1102
- /** Mask `raw`, force it into the DOM (defeats over-typing), parse and validate. */
1275
+ /** Rebuild `raw` as a digit stream (IME / autofill / suggestion fallback —
1276
+ * any `input` event with no preceding handled `beforeinput`), split per slot
1277
+ * by its fixed width, then render fixed-width so it matches the overlay —
1278
+ * empty when no digits remain. */
1103
1279
  private commitRaw;
1280
+ /** Write masked text + caret into the DOM, then parse and validate it. */
1281
+ private applyEditedText;
1104
1282
  protected onFieldBlur(): void;
1105
- /** Force the DOM value to the mask (over-typed digits can't accumulate) and
1106
- * place the caret after `targetDigits` digits, skipping separators. */
1107
- private writeBack;
1108
- private caretAfterDigits;
1283
+ /** Force the DOM value to `text` (over-typed digits can't accumulate) and
1284
+ * place the caret at `caret`. Setting `value` first parks the caret at the
1285
+ * end, so the explicit range must follow; the later `[value]` binding writes
1286
+ * the same string, which leaves the caret untouched. */
1287
+ private writeBackText;
1288
+ /** Caret just past the last digit filled by a flat digit stream (commitRaw's
1289
+ * fallback path) — the first slot short of its max length, or the very end
1290
+ * once every slot is full. Empty segments naturally resolve to 0. */
1291
+ private caretAfterFill;
1109
1292
  /** Parse the combined range text, flag malformed segments, commit on blur. */
1110
1293
  private applyRangeText;
1111
1294
  protected prevMonth(): void;
@@ -1194,18 +1377,31 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1194
1377
  /** Public panel tokens forwarded onto the portaled overlay pane on open so
1195
1378
  * a consumer's `ds-time-picker { --ds-time-picker-panel-*: … }` reaches it. */
1196
1379
  private readonly panelTokens;
1380
+ /** Selected time, or `[start, end]` tuple when `mode="range"`. Two-way bound. */
1197
1381
  readonly value: _angular_core.ModelSignal<string | TimeRangeValue | null>;
1382
+ /** Single time or `[start, end]` range picker. */
1198
1383
  readonly mode: _angular_core.InputSignal<TimePickerMode>;
1384
+ /** Minute increment shown in the picker columns. */
1199
1385
  readonly minuteStep: _angular_core.InputSignalWithTransform<number, unknown>;
1386
+ /** Earliest selectable time ("HH:MM"). */
1200
1387
  readonly minTime: _angular_core.InputSignal<string | null>;
1388
+ /** Latest selectable time ("HH:MM"). */
1201
1389
  readonly maxTime: _angular_core.InputSignal<string | null>;
1390
+ /** Predicate marking individual times unselectable. */
1202
1391
  readonly disabledTime: _angular_core.InputSignal<((time: string) => boolean) | null>;
1392
+ /** Trigger height — sm/md/lg. */
1203
1393
  readonly size: _angular_core.InputSignal<TimePickerSize>;
1394
+ /** Disables the picker and blocks all interaction. */
1204
1395
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1396
+ /** Applies error styling and marks the trigger `aria-invalid`. */
1205
1397
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1398
+ /** Helper text shown below the picker. */
1206
1399
  readonly hint: _angular_core.InputSignal<string>;
1400
+ /** Shown in the trigger when no time is set. */
1207
1401
  readonly placeholder: _angular_core.InputSignal<string>;
1402
+ /** Shows an inline clear button when a value is set — single mode only. */
1208
1403
  readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
1404
+ /** Accessible name for the trigger(s), suffixed "(from)"/"(to)" in range mode. */
1209
1405
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
1210
1406
  /** Override the DS-config format for this instance. */
1211
1407
  readonly format: _angular_core.InputSignal<TimeFormat | null>;
@@ -1261,8 +1457,11 @@ declare class BreadcrumbsComponent {
1261
1457
  * Pass an explicit array to opt out of the service (per-page override).
1262
1458
  */
1263
1459
  readonly items: _angular_core.InputSignal<BreadcrumbItem[] | null>;
1460
+ /** Icon between crumbs; falls back to `DS_CONFIG.breadcrumbs.separator`, then `chevronRight`. */
1264
1461
  readonly separator: _angular_core.InputSignal<IconName | null>;
1462
+ /** Whether crumbs render as links; falls back to `DS_CONFIG.breadcrumbs.clickable`, then `true`. */
1265
1463
  readonly clickable: _angular_core.InputSignal<boolean | null>;
1464
+ /** Fires when a clickable crumb with `href` is activated; default navigation is always prevented. */
1266
1465
  readonly navigate: _angular_core.OutputEmitterRef<BreadcrumbItem>;
1267
1466
  protected readonly resolvedItems: _angular_core.Signal<BreadcrumbItem[]>;
1268
1467
  protected readonly effectiveSeparator: _angular_core.Signal<IconName>;
@@ -1296,16 +1495,22 @@ interface SidenavContract {
1296
1495
  declare const SIDENAV: InjectionToken<SidenavContract>;
1297
1496
 
1298
1497
  declare class SidenavComponent implements SidenavContract {
1498
+ /** Collapses the rail to icon-only width; read by nested `ds-sidenav-item`/`ds-sidenav-group`. */
1299
1499
  readonly collapsed: _angular_core.InputSignalWithTransform<boolean, unknown>;
1500
+ /** Brand/logo text shown at the top of the rail. */
1300
1501
  readonly brand: _angular_core.InputSignal<string>;
1301
1502
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavComponent, never>;
1302
1503
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavComponent, "ds-sidenav", never, { "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "brand": { "alias": "brand"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
1303
1504
  }
1304
1505
 
1305
1506
  declare class SidenavGroupComponent {
1507
+ /** Group heading text. */
1306
1508
  readonly label: _angular_core.InputSignal<string>;
1509
+ /** Optional group icon; omit to project custom content via the `[icon]` slot instead. */
1307
1510
  readonly icon: _angular_core.InputSignal<IconName | null>;
1511
+ /** When true, the label/icon row becomes a clickable header that expands/collapses the group. */
1308
1512
  readonly expandable: _angular_core.InputSignalWithTransform<boolean, unknown>;
1513
+ /** Two-way bindable open state; defaults open so a non-expandable group always shows its items. */
1309
1514
  readonly expanded: _angular_core.ModelSignal<boolean>;
1310
1515
  protected toggle(): void;
1311
1516
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavGroupComponent, never>;
@@ -1313,13 +1518,21 @@ declare class SidenavGroupComponent {
1313
1518
  }
1314
1519
 
1315
1520
  declare class SidenavItemComponent {
1521
+ /** Icon shown before the label; omit to project a custom icon via the `[icon]` slot instead. */
1316
1522
  readonly icon: _angular_core.InputSignal<IconName | null>;
1523
+ /** Visible link text; also used as the tooltip/aria-label when the rail is collapsed. */
1317
1524
  readonly label: _angular_core.InputSignal<string>;
1525
+ /** Plain `href` target, used when `routerLink` is not set. */
1318
1526
  readonly href: _angular_core.InputSignal<string>;
1527
+ /** Angular `RouterLink` target — string or array form for dynamic segments. */
1319
1528
  readonly routerLink: _angular_core.InputSignal<string | readonly unknown[] | null>;
1529
+ /** Applies the active style; also drives `aria-current` when not using `routerLink`. */
1320
1530
  readonly active: _angular_core.InputSignalWithTransform<boolean, unknown>;
1531
+ /** Numeric count shown at the end of the item. */
1321
1532
  readonly badge: _angular_core.InputSignal<number | null>;
1533
+ /** Shows an alert dot alongside the badge. */
1322
1534
  readonly hasAlert: _angular_core.InputSignalWithTransform<boolean, unknown>;
1535
+ /** Disables the item — non-navigable and styled as inactive. */
1323
1536
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1324
1537
  private readonly sidenav;
1325
1538
  /** Tooltip text shown when collapsed; empty string suppresses the tooltip when expanded. */
@@ -1345,11 +1558,17 @@ declare class TopBarComponent {
1345
1558
  }
1346
1559
 
1347
1560
  declare class PageHeaderComponent {
1561
+ /** Small label shown above the title. */
1348
1562
  readonly eyebrow: _angular_core.InputSignal<string>;
1563
+ /** Page title, rendered as the `h1`. */
1349
1564
  readonly title: _angular_core.InputSignal<string>;
1565
+ /** Supporting line shown under the title. */
1350
1566
  readonly subtitle: _angular_core.InputSignal<string>;
1567
+ /** Tightens spacing for dense layouts. */
1351
1568
  readonly compact: _angular_core.InputSignalWithTransform<boolean, unknown>;
1569
+ /** Shows a rule under the whole header. */
1352
1570
  readonly divider: _angular_core.InputSignalWithTransform<boolean, unknown>;
1571
+ /** Shows a rule under the meta row only. */
1353
1572
  readonly metaDivider: _angular_core.InputSignalWithTransform<boolean, unknown>;
1354
1573
  protected readonly classes: _angular_core.Signal<string>;
1355
1574
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<PageHeaderComponent, never>;
@@ -1361,11 +1580,17 @@ type ModalSize = 'sm' | 'md' | 'lg' | 'xl' | 'fullscreen';
1361
1580
  declare class ModalComponent implements OnDestroy {
1362
1581
  private readonly doc;
1363
1582
  protected readonly preview: DsStaticPreview;
1583
+ /** Open state, two-way bound. */
1364
1584
  readonly open: _angular_core.ModelSignal<boolean>;
1585
+ /** Dialog width — sm/md/lg/xl/fullscreen. */
1365
1586
  readonly size: _angular_core.InputSignal<ModalSize>;
1587
+ /** Renders the error styling on the modal card. */
1366
1588
  readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
1589
+ /** Dialog title, shown in the header and used for `aria-labelledby`. */
1367
1590
  readonly title: _angular_core.InputSignal<string>;
1591
+ /** Fires once the close (leave) animation finishes. */
1368
1592
  readonly closed: _angular_core.OutputEmitterRef<void>;
1593
+ /** Emit this yourself from a confirm action in the projected content — not fired by the modal itself. */
1369
1594
  readonly confirmed: _angular_core.OutputEmitterRef<void>;
1370
1595
  /** When false, clicking the scrim does not close the modal. */
1371
1596
  readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -1376,10 +1601,12 @@ declare class ModalComponent implements OnDestroy {
1376
1601
  /** Playing the scrim fade-out leave animation. */
1377
1602
  protected readonly closing: _angular_core.WritableSignal<boolean>;
1378
1603
  private wasOpen;
1604
+ private closeFallbackTimer;
1379
1605
  constructor();
1380
1606
  ngOnDestroy(): void;
1381
1607
  protected onClose(): void;
1382
1608
  protected onLeaveEnd(event: AnimationEvent): void;
1609
+ private finishClose;
1383
1610
  protected onBackdrop(event: MouseEvent): void;
1384
1611
  protected onEscape(): void;
1385
1612
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalComponent, never>;
@@ -1387,12 +1614,19 @@ declare class ModalComponent implements OnDestroy {
1387
1614
  }
1388
1615
 
1389
1616
  declare class ModalCardComponent {
1617
+ /** Card width — sm/md/lg/xl/fullscreen. */
1390
1618
  readonly size: _angular_core.InputSignal<ModalSize>;
1619
+ /** Renders the error styling (icon badge and card accent). */
1391
1620
  readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
1621
+ /** Card title, shown in the header and used for `aria-labelledby`. */
1392
1622
  readonly title: _angular_core.InputSignal<string>;
1623
+ /** Shows the header close button. */
1393
1624
  readonly showClose: _angular_core.InputSignalWithTransform<boolean, unknown>;
1625
+ /** Icon badge shown next to the title. */
1394
1626
  readonly icon: _angular_core.InputSignal<IconName | null>;
1627
+ /** ARIA role for the dialog element. */
1395
1628
  readonly dialogRole: _angular_core.InputSignal<"dialog" | "alertdialog">;
1629
+ /** Fires when the header close button is clicked. */
1396
1630
  readonly closed: _angular_core.OutputEmitterRef<void>;
1397
1631
  protected readonly titleId: string;
1398
1632
  protected readonly classes: _angular_core.Signal<string>;
@@ -1427,13 +1661,21 @@ declare class ModalService {
1427
1661
  type BannerVariant = 'info' | 'success' | 'warning' | 'severe' | 'error' | 'neutral';
1428
1662
 
1429
1663
  declare class BannerComponent {
1664
+ /** Severity — drives colour, the default icon and the ARIA role/live. */
1430
1665
  readonly variant: _angular_core.InputSignal<BannerVariant>;
1666
+ /** Optional bold heading above the message. */
1431
1667
  readonly title: _angular_core.InputSignal<string>;
1668
+ /** Show a close button that emits `closed`. */
1432
1669
  readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
1670
+ /** Override the variant's default icon. */
1433
1671
  readonly icon: _angular_core.InputSignal<IconName | null>;
1672
+ /** Tighter padding, centred items, single-line title. */
1434
1673
  readonly compact: _angular_core.InputSignalWithTransform<boolean, unknown>;
1674
+ /** `'stacked'` wraps actions onto their own line; `'row'` keeps them inline. */
1435
1675
  readonly layout: _angular_core.InputSignal<"stacked" | "row">;
1676
+ /** Coloured accent rail on the leading edge; set false to hide it. */
1436
1677
  readonly accentRail: _angular_core.InputSignalWithTransform<boolean, unknown>;
1678
+ /** Fires when the user dismisses the banner. */
1437
1679
  readonly closed: _angular_core.OutputEmitterRef<void>;
1438
1680
  protected get noRail(): boolean;
1439
1681
  protected get ariaRole(): 'alert' | 'status';
@@ -1448,10 +1690,15 @@ declare class BannerComponent {
1448
1690
  type AlertVariant = 'info' | 'success' | 'warning' | 'error' | 'neutral';
1449
1691
 
1450
1692
  declare class AlertComponent {
1693
+ /** Severity — drives colour, the default icon and the ARIA role/live. */
1451
1694
  readonly variant: _angular_core.InputSignal<AlertVariant>;
1695
+ /** Optional bold heading above the message. */
1452
1696
  readonly title: _angular_core.InputSignal<string>;
1697
+ /** Show a close button that emits `closed`. */
1453
1698
  readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
1699
+ /** Override the variant's default icon. */
1454
1700
  readonly icon: _angular_core.InputSignal<IconName | null>;
1701
+ /** Fires when the user dismisses the alert. */
1455
1702
  readonly closed: _angular_core.OutputEmitterRef<void>;
1456
1703
  protected get ariaRole(): 'alert' | 'status';
1457
1704
  protected get ariaLive(): 'assertive' | 'polite';
@@ -1476,15 +1723,20 @@ interface DropzoneFile {
1476
1723
  }
1477
1724
 
1478
1725
  declare class DropzoneComponent {
1726
+ /** Native `accept` attribute — comma-separated MIME types or extensions. */
1479
1727
  readonly accept: _angular_core.InputSignal<string>;
1728
+ /** Allows picking more than one file at once (ignored when `single`). */
1480
1729
  readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
1730
+ /** Files shown in the list — the consumer owns upload state and progress. */
1481
1731
  readonly files: _angular_core.ModelSignal<DropzoneFile[]>;
1482
1732
  /** Disables the dropzone: blocks all file-picking interactions and signals unavailability. */
1483
1733
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1484
1734
  /** Restricts the dropzone to a single file; narrows the panel to `--col-cap-text`. */
1485
1735
  readonly single: _angular_core.InputSignalWithTransform<boolean, unknown>;
1486
1736
  protected readonly dragOver: _angular_core.WritableSignal<boolean>;
1737
+ /** Fires with the raw files picked or dropped; the consumer adds them to `files`. */
1487
1738
  readonly filesAdded: _angular_core.OutputEmitterRef<File[]>;
1739
+ /** Fires when the user removes a file from the list. */
1488
1740
  readonly fileRemoved: _angular_core.OutputEmitterRef<DropzoneFile>;
1489
1741
  protected readonly classes: _angular_core.Signal<string>;
1490
1742
  protected onDragOver(event: DragEvent): void;
@@ -1517,11 +1769,15 @@ declare class MenuItemComponent implements OnDestroy {
1517
1769
  private readonly vcr;
1518
1770
  private readonly hostElement;
1519
1771
  private readonly button;
1772
+ /** Leading icon shown before the projected label. */
1520
1773
  readonly icon: _angular_core.InputSignal<IconName | null>;
1774
+ /** Disables the item and excludes it from `ds-menu`'s roving-tabindex navigation. */
1521
1775
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1776
+ /** Renders the item in an error/destructive style. */
1522
1777
  readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
1523
1778
  /** Optional submenu template — renders a nested `ds-menu` on hover / ArrowRight. */
1524
1779
  readonly submenu: _angular_core.InputSignal<TemplateRef<unknown> | null>;
1780
+ /** Fires on click, unless the item is disabled or opens a submenu. */
1525
1781
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
1526
1782
  /** Roving tabindex, owned by ds-menu — exactly one item is tabbable (0), the
1527
1783
  * rest -1. Defaults true so a standalone item (outside ds-menu) stays
@@ -1560,9 +1816,13 @@ declare class MenuDividerComponent {
1560
1816
  type EmptyStateVariant = 'none' | 'loading' | 'error' | 'locked' | 'success';
1561
1817
 
1562
1818
  declare class EmptyStateComponent {
1819
+ /** State — drives the default icon and shows a loading overlay when `'loading'`. */
1563
1820
  readonly variant: _angular_core.InputSignal<EmptyStateVariant>;
1821
+ /** Override the variant's default icon. */
1564
1822
  readonly icon: _angular_core.InputSignal<IconName | null>;
1823
+ /** Optional heading below the icon. */
1565
1824
  readonly title: _angular_core.InputSignal<string>;
1825
+ /** Optional supporting text below the title. */
1566
1826
  readonly body: _angular_core.InputSignal<string>;
1567
1827
  protected readonly classes: _angular_core.Signal<string>;
1568
1828
  protected readonly resolvedIcon: _angular_core.Signal<IconName>;
@@ -1573,8 +1833,11 @@ declare class EmptyStateComponent {
1573
1833
  type ProgressVariant = 'default' | Exclude<DsStatus, 'info'>;
1574
1834
 
1575
1835
  declare class ProgressComponent {
1836
+ /** Progress 0–100; clamped, and ignored while `indeterminate`. */
1576
1837
  readonly value: _angular_core.InputSignal<number>;
1838
+ /** Colour variant — drives the success/warning/error styling. */
1577
1839
  readonly variant: _angular_core.InputSignal<ProgressVariant>;
1840
+ /** Indeterminate (unknown-duration) animation instead of a fixed `value`. */
1578
1841
  readonly indeterminate: _angular_core.InputSignalWithTransform<boolean, unknown>;
1579
1842
  /** Accessible name for the progress bar (e.g. "Upload progress"). */
1580
1843
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
@@ -1607,8 +1870,11 @@ declare class AccordionComponent implements AccordionContract {
1607
1870
  }
1608
1871
 
1609
1872
  declare class AccordionItemComponent implements AccordionItemRef {
1873
+ /** Header text shown in the toggle button. */
1610
1874
  readonly title: _angular_core.InputSignal<string>;
1875
+ /** Open state, two-way bound. */
1611
1876
  readonly expanded: _angular_core.ModelSignal<boolean>;
1877
+ /** Disables the toggle button; state stays as-is. */
1612
1878
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1613
1879
  protected readonly uid: string;
1614
1880
  protected readonly headId: string;
@@ -1630,14 +1896,19 @@ type StepperLabelPosition = 'bottom' | 'inline';
1630
1896
  /** Layout axis of the stepper. */
1631
1897
  type StepperOrientation = 'horizontal' | 'vertical';
1632
1898
  declare class StepperComponent {
1899
+ /** Step labels, in order — one node is rendered per entry. */
1633
1900
  readonly steps: _angular_core.InputSignal<readonly string[]>;
1901
+ /** Zero-based index of the active step; earlier steps render as completed. */
1634
1902
  readonly current: _angular_core.InputSignal<number>;
1903
+ /** Where the step caption sits relative to its node. */
1635
1904
  readonly labelPosition: _angular_core.InputSignal<StepperLabelPosition>;
1905
+ /** Layout axis of the stepper. */
1636
1906
  readonly orientation: _angular_core.InputSignal<StepperOrientation>;
1637
1907
  /** When true, each step node renders as a button and emits its index on activation. */
1638
1908
  readonly clickable: _angular_core.InputSignalWithTransform<boolean, unknown>;
1639
1909
  /** Zero-based indices of steps in an error state. Error wins over completed/current/upcoming. */
1640
1910
  readonly errorSteps: _angular_core.InputSignal<readonly number[]>;
1911
+ /** Fires with a step's index when it's activated (only when `clickable`). */
1641
1912
  readonly stepClicked: _angular_core.OutputEmitterRef<number>;
1642
1913
  protected stepState(index: number): 'error' | 'completed' | 'current' | 'upcoming';
1643
1914
  protected nodeClass(index: number): string;
@@ -1669,8 +1940,11 @@ declare class TooltipDirective implements OnDestroy {
1669
1940
  }
1670
1941
 
1671
1942
  declare class TooltipPanelComponent {
1943
+ /** Tooltip text content. */
1672
1944
  readonly text: _angular_core.InputSignal<string>;
1945
+ /** Side of the trigger the panel is positioned on; also drives the arrow class. */
1673
1946
  readonly placement: _angular_core.InputSignal<TooltipPlacement>;
1947
+ /** Element `id`, referenced by the trigger's `aria-describedby`. */
1674
1948
  readonly panelId: _angular_core.InputSignal<string>;
1675
1949
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TooltipPanelComponent, never>;
1676
1950
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<TooltipPanelComponent, "ds-tooltip-panel", never, { "text": { "alias": "text"; "required": true; "isSignal": true; }; "placement": { "alias": "placement"; "required": true; "isSignal": true; }; "panelId": { "alias": "panelId"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -1688,6 +1962,7 @@ declare class PopoverComponent implements OnDestroy, DsOverlayCloseRef {
1688
1962
  /** Public panel tokens forwarded onto the portaled overlay pane on open so
1689
1963
  * a consumer's `ds-popover { --ds-popover-panel-*: … }` reaches it. */
1690
1964
  private readonly panelTokens;
1965
+ /** Cross-axis alignment of the panel against the trigger. */
1691
1966
  readonly align: _angular_core.InputSignal<PopoverAlign>;
1692
1967
  /** Which side of the trigger the panel prefers to appear on. */
1693
1968
  readonly placement: _angular_core.InputSignal<PopoverPlacement>;
@@ -1790,12 +2065,19 @@ declare class ToastRegionComponent {
1790
2065
  * AND by static showcases that need to display a toast specimen inline.
1791
2066
  */
1792
2067
  declare class ToastComponent {
2068
+ /** Severity — drives colour, the default icon/spinner and the ARIA role/live. */
1793
2069
  readonly variant: _angular_core.InputSignal<ToastVariant>;
2070
+ /** Optional bold heading above the message. */
1794
2071
  readonly title: _angular_core.InputSignal<string>;
2072
+ /** Body text of the toast. */
1795
2073
  readonly message: _angular_core.InputSignal<string>;
2074
+ /** Show a close button that emits `closed`. */
1796
2075
  readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
2076
+ /** Override the variant's default icon. */
1797
2077
  readonly icon: _angular_core.InputSignal<IconName | null>;
2078
+ /** Optional action button rendered before the dismiss control. */
1798
2079
  readonly action: _angular_core.InputSignal<ToastAction | null>;
2080
+ /** Fires when the toast is dismissed or its action is invoked. */
1799
2081
  readonly closed: _angular_core.OutputEmitterRef<void>;
1800
2082
  protected readonly isLoading: _angular_core.Signal<boolean>;
1801
2083
  protected onAction(action: ToastAction): void;
@@ -1822,10 +2104,15 @@ type DrawerPlacement = 'right' | 'left' | 'top' | 'bottom';
1822
2104
 
1823
2105
  declare class DrawerComponent implements OnDestroy {
1824
2106
  private readonly doc;
2107
+ /** Open state, two-way bound. */
1825
2108
  readonly open: _angular_core.ModelSignal<boolean>;
2109
+ /** Panel size — sm/md/lg. */
1826
2110
  readonly size: _angular_core.InputSignal<DrawerSize>;
2111
+ /** Edge the panel slides in from. */
1827
2112
  readonly placement: _angular_core.InputSignal<DrawerPlacement>;
2113
+ /** Drawer title, shown in the header and used for `aria-labelledby`. */
1828
2114
  readonly title: _angular_core.InputSignal<string>;
2115
+ /** Fires once the close (slide-out) animation finishes. */
1829
2116
  readonly closed: _angular_core.OutputEmitterRef<void>;
1830
2117
  protected readonly titleId: string;
1831
2118
  /** Panel is in the DOM (kept true through the slide-out). */
@@ -1833,11 +2120,13 @@ declare class DrawerComponent implements OnDestroy {
1833
2120
  /** Playing the slide-out + scrim-fade leave animation. */
1834
2121
  protected readonly closing: _angular_core.WritableSignal<boolean>;
1835
2122
  private wasOpen;
2123
+ private closeFallbackTimer;
1836
2124
  protected readonly classes: _angular_core.Signal<string>;
1837
2125
  constructor();
1838
2126
  ngOnDestroy(): void;
1839
2127
  protected onClose(): void;
1840
2128
  protected onLeaveEnd(event: AnimationEvent): void;
2129
+ private finishClose;
1841
2130
  protected onEscape(): void;
1842
2131
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DrawerComponent, never>;
1843
2132
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<DrawerComponent, "ds-drawer", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; }, never, ["[drawer-body]", "[drawer-footer]"], true, never>;
@@ -1849,9 +2138,12 @@ declare class DrawerComponent implements OnDestroy {
1849
2138
  * --ds-bottom-sheet-maxw and centred; prefer ds-modal / ds-drawer for
1850
2139
  * desktop-first layouts. position: fixed resolves against the nearest
1851
2140
  * ancestor containing block, so framed hosts contain the sheet. */
1852
- declare class BottomSheetComponent {
2141
+ declare class BottomSheetComponent implements OnDestroy {
2142
+ /** Open state, two-way bound. */
1853
2143
  readonly open: _angular_core.ModelSignal<boolean>;
2144
+ /** Sheet title, shown in the header and used for `aria-labelledby`. */
1854
2145
  readonly title: _angular_core.InputSignal<string>;
2146
+ /** Fires once the close (leave) animation finishes. */
1855
2147
  readonly closed: _angular_core.OutputEmitterRef<void>;
1856
2148
  protected readonly titleId: string;
1857
2149
  /**
@@ -1878,9 +2170,12 @@ declare class BottomSheetComponent {
1878
2170
  private velocity;
1879
2171
  private previousBodyOverflow;
1880
2172
  private wasOpen;
2173
+ private closeFallbackTimer;
1881
2174
  constructor();
2175
+ ngOnDestroy(): void;
1882
2176
  protected close(): void;
1883
2177
  protected onLeaveEnd(event: AnimationEvent): void;
2178
+ private finishClose;
1884
2179
  protected onEscape(): void;
1885
2180
  protected stop(event: Event): void;
1886
2181
  protected onGrabStart(event: PointerEvent): void;
@@ -1893,13 +2188,19 @@ declare class BottomSheetComponent {
1893
2188
  type TagVariant = 'solid' | 'neutral';
1894
2189
 
1895
2190
  declare class TagComponent {
2191
+ /** Fill style — `solid` for high-emphasis, `neutral` for low-emphasis chips. */
1896
2192
  readonly variant: _angular_core.InputSignal<TagVariant>;
2193
+ /** Shows a close button that emits `closed`. */
1897
2194
  readonly closable: _angular_core.InputSignalWithTransform<boolean, unknown>;
2195
+ /** Makes the tag clickable, emitting `toggled` on click. */
1898
2196
  readonly interactive: _angular_core.InputSignalWithTransform<boolean, unknown>;
2197
+ /** Applies the active/selected visual state. */
1899
2198
  readonly selected: _angular_core.InputSignalWithTransform<boolean, unknown>;
1900
2199
  /** Accessible label for the close button (e.g. "Remove Source filter"). */
1901
2200
  readonly closeLabel: _angular_core.InputSignal<string>;
2201
+ /** Fires when the close button is clicked. */
1902
2202
  readonly closed: _angular_core.OutputEmitterRef<void>;
2203
+ /** Fires on click when `interactive` is true. */
1903
2204
  readonly toggled: _angular_core.OutputEmitterRef<void>;
1904
2205
  protected onClick(): void;
1905
2206
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TagComponent, never>;
@@ -1907,9 +2208,13 @@ declare class TagComponent {
1907
2208
  }
1908
2209
 
1909
2210
  declare class W3wComponent {
2211
+ /** Marker rendered before the address (e.g. the "///" glyph). */
1910
2212
  readonly prefix: _angular_core.InputSignal<string>;
2213
+ /** The three-word address, rendered after `prefix`. */
1911
2214
  readonly address: _angular_core.InputSignal<string>;
2215
+ /** Makes the address clickable/focusable and copies `prefix` + `address` to the clipboard. */
1912
2216
  readonly copyable: _angular_core.InputSignalWithTransform<boolean, unknown>;
2217
+ /** Fires with `address` after a successful copy. */
1913
2218
  readonly copied: _angular_core.OutputEmitterRef<string>;
1914
2219
  protected onKeyActivate(event: Event): void;
1915
2220
  protected onCopy(): void;
@@ -1920,6 +2225,7 @@ declare class W3wComponent {
1920
2225
  type PageFooterVariant = 'default' | 'compact' | 'save';
1921
2226
 
1922
2227
  declare class PageFooterComponent {
2228
+ /** Visual style — default, compact, or the accented `save`-bar look. */
1923
2229
  readonly variant: _angular_core.InputSignal<PageFooterVariant>;
1924
2230
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<PageFooterComponent, never>;
1925
2231
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<PageFooterComponent, "ds-page-footer", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["[brand]", "[nav]", "[actions]", "*"], true, never>;
@@ -1944,19 +2250,31 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
1944
2250
  /** Public panel tokens forwarded onto the portaled overlay pane on open so
1945
2251
  * a consumer's `ds-autocomplete { --ds-autocomplete-panel-*: … }` reaches it. */
1946
2252
  private readonly panelTokens;
2253
+ /** Flat option list — ignored when `optionGroups` is set. */
1947
2254
  readonly options: _angular_core.InputSignal<readonly AutocompleteOption<T>[]>;
2255
+ /** Options grouped under labelled sections, rendered instead of `options`. */
1948
2256
  readonly optionGroups: _angular_core.InputSignal<AutocompleteOptionGroup<T>[]>;
2257
+ /** Selected value, or an array of values when `multiple`. */
1949
2258
  readonly value: _angular_core.ModelSignal<T | readonly T[] | null>;
2259
+ /** Allows selecting more than one option, shown as removable tags. */
1950
2260
  readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
2261
+ /** Trigger height — sm/md/lg. */
1951
2262
  readonly size: _angular_core.InputSignal<AutocompleteSize>;
2263
+ /** Trigger width — `fill` stretches to the container, `content` hugs the value. */
1952
2264
  readonly width: _angular_core.InputSignal<AutocompleteWidth>;
2265
+ /** Placeholder shown in the input when empty. */
1953
2266
  readonly placeholder: _angular_core.InputSignal<string>;
2267
+ /** Disables the trigger and blocks all interaction. */
1954
2268
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2269
+ /** Applies error styling and marks the field `aria-invalid`. */
1955
2270
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2271
+ /** Helper text shown below the field. */
1956
2272
  readonly hint: _angular_core.InputSignal<string>;
2273
+ /** Shows a "Create «text»" row when the typed text matches no option. */
1957
2274
  readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
1958
2275
  /** Accessible name for the combobox input. */
1959
2276
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2277
+ /** Fires with the typed text when the user picks the create-new option. */
1960
2278
  readonly create: _angular_core.OutputEmitterRef<string>;
1961
2279
  protected readonly isDisabled: _angular_core.Signal<boolean>;
1962
2280
  protected readonly hintId: _angular_core.Signal<string | null>;
@@ -2019,6 +2337,7 @@ declare class DividerComponent {
2019
2337
 
2020
2338
  type DescriptionListOrientation = 'horizontal' | 'stacked';
2021
2339
  declare class DescriptionListComponent {
2340
+ /** horizontal = label column + value; stacked = label above value. */
2022
2341
  readonly orientation: _angular_core.InputSignal<DescriptionListOrientation>;
2023
2342
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DescriptionListComponent, never>;
2024
2343
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<DescriptionListComponent, "ds-description-list", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -2026,7 +2345,9 @@ declare class DescriptionListComponent {
2026
2345
 
2027
2346
  declare class DescriptionItemComponent {
2028
2347
  private readonly list;
2348
+ /** The label. Plain text; rich values go in the projected content. */
2029
2349
  readonly term: _angular_core.InputSignal<string>;
2350
+ /** When set, a copy button appears that copies this string to the clipboard. */
2030
2351
  readonly copyValue: _angular_core.InputSignal<string | null>;
2031
2352
  protected readonly stacked: _angular_core.Signal<boolean>;
2032
2353
  protected readonly copied: _angular_core.WritableSignal<boolean>;
@@ -2070,8 +2391,11 @@ interface SegmentedOption {
2070
2391
  }
2071
2392
 
2072
2393
  declare class SegmentedComponent {
2394
+ /** Segments to render — each needs a `label` and `value`, optional `icon`/`disabled`. */
2073
2395
  readonly options: _angular_core.InputSignal<readonly SegmentedOption[]>;
2396
+ /** Selected segment's `value`, two-way bound. */
2074
2397
  readonly value: _angular_core.ModelSignal<string>;
2398
+ /** Accessible name for the segmented control (radiogroup role). */
2075
2399
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2076
2400
  private readonly buttons;
2077
2401
  protected readonly focusableValue: _angular_core.Signal<string | null>;
@@ -2083,23 +2407,31 @@ declare class SegmentedComponent {
2083
2407
  }
2084
2408
 
2085
2409
  declare class ButtonGroupComponent {
2410
+ /** Accessible name for the group, set as `aria-label` on the `role="group"` host. */
2086
2411
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2087
2412
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonGroupComponent, never>;
2088
2413
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonGroupComponent, "ds-button-group", never, { "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
2089
2414
  }
2090
2415
 
2091
2416
  declare class ListComponent {
2417
+ /** Draw a hairline separator between adjacent items. */
2092
2418
  readonly dividers: _angular_core.InputSignalWithTransform<boolean, unknown>;
2093
2419
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListComponent, never>;
2094
2420
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListComponent, "ds-list", never, { "dividers": { "alias": "dividers"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
2095
2421
  }
2096
2422
 
2097
2423
  declare class ListItemComponent {
2424
+ /** Convenience text; richer middle content can be projected as default content. */
2098
2425
  readonly title: _angular_core.InputSignal<string>;
2426
+ /** Secondary line below `title`. */
2099
2427
  readonly subtitle: _angular_core.InputSignal<string>;
2428
+ /** Whole-row navigation: renders an inner button and emits `activated`. */
2100
2429
  readonly clickable: _angular_core.InputSignalWithTransform<boolean, unknown>;
2430
+ /** Marks the row current via `aria-current`. */
2101
2431
  readonly selected: _angular_core.InputSignalWithTransform<boolean, unknown>;
2432
+ /** Disables the row; only affects the button when `clickable`. */
2102
2433
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2434
+ /** Fires when the clickable row's button is activated. */
2103
2435
  readonly activated: _angular_core.OutputEmitterRef<void>;
2104
2436
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListItemComponent, never>;
2105
2437
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListItemComponent, "ds-list-item", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "activated": "activated"; }, never, ["[leading]", "*", "[trailing]"], true, never>;
@@ -2115,14 +2447,21 @@ interface SplitButtonItem {
2115
2447
  }
2116
2448
 
2117
2449
  declare class SplitButtonComponent {
2450
+ /** Label text on the main button. */
2118
2451
  readonly label: _angular_core.InputSignal<string>;
2452
+ /** Visual style — primary (solid) or outline. */
2119
2453
  readonly variant: _angular_core.InputSignal<SplitButtonVariant>;
2454
+ /** Icon shown on the main button, before the label. */
2120
2455
  readonly icon: _angular_core.InputSignal<IconName | null>;
2456
+ /** Disables both the main button and the dropdown trigger. */
2121
2457
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2458
+ /** Items listed in the dropdown menu. */
2122
2459
  readonly menuItems: _angular_core.InputSignal<readonly SplitButtonItem[]>;
2123
2460
  /** Accessible name for the dropdown trigger. */
2124
2461
  readonly menuLabel: _angular_core.InputSignal<string>;
2462
+ /** Fires when the main button (not the dropdown trigger) is clicked. */
2125
2463
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
2464
+ /** Fires with the chosen menu item. */
2126
2465
  readonly itemSelected: _angular_core.OutputEmitterRef<SplitButtonItem>;
2127
2466
  protected onItemSelect(item: SplitButtonItem): void;
2128
2467
  protected onTriggerKeydown(event: KeyboardEvent, popover: PopoverComponent, trigger: HTMLElement): void;
@@ -2137,9 +2476,13 @@ declare class TimelineComponent {
2137
2476
 
2138
2477
  type TimelineTone = 'default' | 'primary' | 'success' | 'warning' | 'error' | 'muted';
2139
2478
  declare class TimelineItemComponent {
2479
+ /** Primary text for the entry. */
2140
2480
  readonly heading: _angular_core.InputSignal<string>;
2481
+ /** Timestamp or date label shown below the content. */
2141
2482
  readonly time: _angular_core.InputSignal<string>;
2483
+ /** Icon shown in the marker; omit for a plain dot. */
2142
2484
  readonly icon: _angular_core.InputSignal<IconName | null>;
2485
+ /** Semantic accent color for the marker. */
2143
2486
  readonly tone: _angular_core.InputSignal<TimelineTone>;
2144
2487
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TimelineItemComponent, never>;
2145
2488
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimelineItemComponent, "ds-timeline-item", never, { "heading": { "alias": "heading"; "required": false; "isSignal": true; }; "time": { "alias": "time"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "tone": { "alias": "tone"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -2147,14 +2490,23 @@ declare class TimelineItemComponent {
2147
2490
 
2148
2491
  type OtpMode = 'numeric' | 'alphanumeric';
2149
2492
  declare class OtpInputComponent extends DsControlValueAccessor<string> {
2493
+ /** Entered code, two-way bound. */
2150
2494
  readonly value: _angular_core.ModelSignal<string>;
2495
+ /** Number of character cells. */
2151
2496
  readonly length: _angular_core.InputSignal<number>;
2497
+ /** Restricts input and the mobile keyboard to digits-only, or allows letters too. */
2152
2498
  readonly mode: _angular_core.InputSignal<OtpMode>;
2499
+ /** Renders each cell as a password dot instead of the typed character. */
2153
2500
  readonly mask: _angular_core.InputSignalWithTransform<boolean, unknown>;
2501
+ /** Disables all cells and blocks interaction. */
2154
2502
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2503
+ /** Applies error styling and marks each cell `aria-invalid`. */
2155
2504
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2505
+ /** Helper text shown below the cells. */
2156
2506
  readonly hint: _angular_core.InputSignal<string>;
2507
+ /** Accessible group label for the cell row. */
2157
2508
  readonly ariaLabel: _angular_core.InputSignal<string>;
2509
+ /** Fires once, with the full code, on the partial → complete transition. */
2158
2510
  readonly completed: _angular_core.OutputEmitterRef<string>;
2159
2511
  private readonly boxes;
2160
2512
  private wasComplete;
@@ -2181,14 +2533,23 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
2181
2533
 
2182
2534
  type SliderValue = number | readonly [number, number];
2183
2535
  declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
2536
+ /** Current value, or `[low, high]` when `range`. Two-way bound. */
2184
2537
  readonly value: _angular_core.ModelSignal<SliderValue>;
2538
+ /** Minimum selectable value. */
2185
2539
  readonly min: _angular_core.InputSignalWithTransform<number, unknown>;
2540
+ /** Maximum selectable value. */
2186
2541
  readonly max: _angular_core.InputSignalWithTransform<number, unknown>;
2542
+ /** Increment applied when dragging (snap) or nudging with arrow keys. */
2187
2543
  readonly step: _angular_core.InputSignalWithTransform<number, unknown>;
2544
+ /** Two-thumb range mode — `value` becomes a `[low, high]` tuple. */
2188
2545
  readonly range: _angular_core.InputSignalWithTransform<boolean, unknown>;
2546
+ /** Disables the slider and blocks all interaction. */
2189
2547
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2548
+ /** Accessible name for the thumb(s) — suffixed "minimum"/"maximum" in `range` mode. */
2190
2549
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2550
+ /** Applies error styling. */
2191
2551
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2552
+ /** Helper text shown below the slider. */
2192
2553
  readonly hint: _angular_core.InputSignal<string>;
2193
2554
  private readonly track;
2194
2555
  private dragging;
@@ -2221,10 +2582,15 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
2221
2582
  type SpinnerSize = 'sm' | 'md' | 'lg';
2222
2583
 
2223
2584
  declare class LoadingOverlayComponent {
2585
+ /** Show the scrim + spinner over the projected region. */
2224
2586
  readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
2587
+ /** Optional caption beneath the spinner. */
2225
2588
  readonly label: _angular_core.InputSignal<string>;
2589
+ /** Backdrop-blur the projected content behind the scrim. */
2226
2590
  readonly blur: _angular_core.InputSignalWithTransform<boolean, unknown>;
2591
+ /** Size of the spinner shown in the scrim. */
2227
2592
  readonly spinnerSize: _angular_core.InputSignal<SpinnerSize>;
2593
+ /** Offset the scrim top edge — useful when a sticky header should stay uncovered. */
2228
2594
  readonly insetTop: _angular_core.InputSignal<string>;
2229
2595
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<LoadingOverlayComponent, never>;
2230
2596
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<LoadingOverlayComponent, "ds-loading-overlay", never, { "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "blur": { "alias": "blur"; "required": false; "isSignal": true; }; "spinnerSize": { "alias": "spinnerSize"; "required": false; "isSignal": true; }; "insetTop": { "alias": "insetTop"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -2246,9 +2612,13 @@ interface VisibleNode {
2246
2612
  }
2247
2613
  declare class TreeComponent {
2248
2614
  private readonly host;
2615
+ /** Root-level nodes; nest via `children`. */
2249
2616
  readonly nodes: _angular_core.InputSignal<readonly TreeNode[]>;
2617
+ /** Two-way set of currently expanded node ids. */
2250
2618
  readonly expandedIds: _angular_core.ModelSignal<Set<string>>;
2619
+ /** Two-way id of the currently selected node. */
2251
2620
  readonly selectedId: _angular_core.ModelSignal<string | null>;
2621
+ /** Fires with the node when a row is selected (click or Enter/Space). */
2252
2622
  readonly nodeSelected: _angular_core.OutputEmitterRef<TreeNode>;
2253
2623
  private readonly activeId;
2254
2624
  protected readonly visibleNodes: _angular_core.Signal<VisibleNode[]>;
@@ -2282,11 +2652,17 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
2282
2652
  /** Public panel tokens forwarded onto the portaled overlay pane on open so
2283
2653
  * a consumer's `ds-color-picker { --ds-color-picker-panel-*: … }` reaches it. */
2284
2654
  private readonly panelTokens;
2655
+ /** Selected colour as a hex string, two-way bound. */
2285
2656
  readonly value: _angular_core.ModelSignal<string>;
2657
+ /** Swatches shown in the panel — defaults to a built-in palette. */
2286
2658
  readonly presets: _angular_core.InputSignal<readonly string[]>;
2659
+ /** Disables the trigger and blocks all interaction. */
2287
2660
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2661
+ /** Accessible name for the trigger button and panel. */
2288
2662
  readonly ariaLabel: _angular_core.InputSignal<string>;
2663
+ /** Applies error styling and marks the trigger `aria-invalid`. */
2289
2664
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2665
+ /** Helper text shown below the trigger. */
2290
2666
  readonly hint: _angular_core.InputSignal<string>;
2291
2667
  protected readonly trigger: _angular_core.Signal<ElementRef<HTMLButtonElement>>;
2292
2668
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
@@ -2343,15 +2719,25 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
2343
2719
  /** Public panel tokens forwarded onto the portaled overlay pane on open so
2344
2720
  * a consumer's `ds-multi-select { --ds-multi-select-panel-*: … }` reaches it. */
2345
2721
  private readonly panelTokens;
2722
+ /** Selected values, two-way bound. */
2346
2723
  readonly value: _angular_core.ModelSignal<string[]>;
2724
+ /** Options shown in the panel. */
2347
2725
  readonly options: _angular_core.InputSignal<readonly MultiSelectOption[]>;
2726
+ /** Placeholder shown in the trigger when nothing is selected. */
2348
2727
  readonly placeholder: _angular_core.InputSignal<string>;
2728
+ /** Placeholder for the in-panel filter input. */
2349
2729
  readonly searchPlaceholder: _angular_core.InputSignal<string>;
2730
+ /** Caps the number of chips shown before collapsing the rest into "+N more" — 0/null shows all. */
2350
2731
  readonly maxVisibleChips: _angular_core.InputSignalWithTransform<number | null, number | null>;
2732
+ /** Disables the trigger and blocks all interaction. */
2351
2733
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2734
+ /** Applies error styling and marks the field `aria-invalid`. */
2352
2735
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2736
+ /** Helper text shown below the field. */
2353
2737
  readonly hint: _angular_core.InputSignal<string>;
2738
+ /** Accessible name for the trigger — falls back to `placeholder`. */
2354
2739
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2740
+ /** Shows a "Select all" row that toggles every filter-matching, enabled option. */
2355
2741
  readonly selectAll: _angular_core.InputSignalWithTransform<boolean, unknown>;
2356
2742
  protected readonly uid: string;
2357
2743
  protected readonly listboxId: string;
@@ -2392,15 +2778,20 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
2392
2778
  }
2393
2779
 
2394
2780
  declare class SkeletonComponent {
2781
+ /** CSS width of the placeholder (e.g. `'120px'`, `'50%'`). */
2395
2782
  readonly width: _angular_core.InputSignal<string | undefined>;
2783
+ /** CSS height of the placeholder. */
2396
2784
  readonly height: _angular_core.InputSignal<string | undefined>;
2785
+ /** Pill radius, for avatar/dot-shaped placeholders. */
2397
2786
  readonly circle: _angular_core.InputSignalWithTransform<boolean, unknown>;
2787
+ /** `display: inline-block` instead of `block`, to sit inline with text. */
2398
2788
  readonly inline: _angular_core.InputSignalWithTransform<boolean, unknown>;
2399
2789
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SkeletonComponent, never>;
2400
2790
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<SkeletonComponent, "ds-skeleton", never, { "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "circle": { "alias": "circle"; "required": false; "isSignal": true; }; "inline": { "alias": "inline"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
2401
2791
  }
2402
2792
 
2403
2793
  declare class SpinnerComponent {
2794
+ /** Spinner size — sm/md/lg. */
2404
2795
  readonly size: _angular_core.InputSignal<SpinnerSize>;
2405
2796
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SpinnerComponent, never>;
2406
2797
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<SpinnerComponent, "ds-spinner", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -2409,14 +2800,23 @@ declare class SpinnerComponent {
2409
2800
  type CheckboxSize = 'sm' | 'md' | 'lg';
2410
2801
 
2411
2802
  declare class CheckboxComponent extends DsBooleanControlValueAccessor {
2803
+ /** Checked state, two-way bound. */
2412
2804
  readonly checked: _angular_core.ModelSignal<boolean>;
2805
+ /** Shows the partial/mixed visual state — independent of `checked`. */
2413
2806
  readonly indeterminate: _angular_core.InputSignalWithTransform<boolean, unknown>;
2807
+ /** Disables the checkbox and blocks all interaction. */
2414
2808
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2809
+ /** Native `name` attribute. */
2415
2810
  readonly name: _angular_core.InputSignal<string | null>;
2811
+ /** Overrides the generated id used by the native `<input>` and its `<label for>`. */
2416
2812
  readonly inputId: _angular_core.InputSignal<string | null>;
2813
+ /** Applies error styling and marks the input `aria-invalid`. */
2417
2814
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2815
+ /** Helper text shown below the checkbox. */
2418
2816
  readonly hint: _angular_core.InputSignal<string>;
2817
+ /** Checkbox size — sm/md/lg. */
2419
2818
  readonly size: _angular_core.InputSignal<CheckboxSize>;
2819
+ /** Marks the field required — shows an asterisk and sets `aria-required`. */
2420
2820
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
2421
2821
  /** Inline label rendered beside the box and wired via for/id. Omit to
2422
2822
  * bring your own <label>. */
@@ -2438,13 +2838,21 @@ declare class RadioComponent {
2438
2838
  /** Standalone two-way binding. When inside ds-radio-group, isChecked() is
2439
2839
  * derived from the group value instead. */
2440
2840
  readonly checked: _angular_core.ModelSignal<boolean>;
2841
+ /** Disables the radio; a disabled parent `ds-radio-group` also disables it. */
2441
2842
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2843
+ /** Native `name` attribute — overridden by the group's name when inside `ds-radio-group`. */
2442
2844
  readonly name: _angular_core.InputSignal<string>;
2845
+ /** Value compared against the group's selection when inside `ds-radio-group`. */
2443
2846
  readonly value: _angular_core.InputSignal<unknown>;
2847
+ /** Overrides the auto-generated id used for the input and its label's `for`. */
2444
2848
  readonly inputId: _angular_core.InputSignal<string | null>;
2849
+ /** Applies error styling and marks the input `aria-invalid`. */
2445
2850
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2851
+ /** Helper text shown below the control. */
2446
2852
  readonly hint: _angular_core.InputSignal<string>;
2853
+ /** Control size — sm/md/lg. */
2447
2854
  readonly size: _angular_core.InputSignal<RadioSize>;
2855
+ /** Marks the radio required — shows an asterisk on the label and sets `aria-required`. */
2448
2856
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
2449
2857
  /** Inline label rendered beside the dot and wired via for/id. Omit to bring
2450
2858
  * your own <label>. */
@@ -2488,12 +2896,19 @@ interface RadioGroupChild {
2488
2896
  declare const RADIO_GROUP: InjectionToken<RadioGroupContract>;
2489
2897
 
2490
2898
  declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implements RadioGroupContract {
2899
+ /** Selected radio value; two-way bound. */
2491
2900
  readonly value: _angular_core.ModelSignal<unknown>;
2901
+ /** Native `name` shared by every radio in the group. */
2492
2902
  readonly name: _angular_core.InputSignal<string | null>;
2903
+ /** Disables the whole group. */
2493
2904
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2905
+ /** Applies error styling and marks the group `aria-invalid`. */
2494
2906
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2907
+ /** Helper text shown below the group. */
2495
2908
  readonly hint: _angular_core.InputSignal<string>;
2909
+ /** Accessible name for the group when no visible label is provided. */
2496
2910
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2911
+ /** Visible group label; omit to supply your own. */
2497
2912
  readonly label: _angular_core.InputSignal<string>;
2498
2913
  readonly isDisabled: _angular_core.Signal<boolean>;
2499
2914
  protected readonly uid: string;
@@ -2512,14 +2927,23 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
2512
2927
  type SwitchSize = 'sm' | 'md' | 'lg';
2513
2928
 
2514
2929
  declare class SwitchComponent extends DsBooleanControlValueAccessor {
2930
+ /** On/off state, two-way bound. */
2515
2931
  readonly checked: _angular_core.ModelSignal<boolean>;
2932
+ /** Disables the switch and blocks all interaction. */
2516
2933
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2934
+ /** Native `name` attribute. */
2517
2935
  readonly name: _angular_core.InputSignal<string | null>;
2936
+ /** Track colour when checked. */
2518
2937
  readonly variant: _angular_core.InputSignal<"error" | "success" | "default">;
2938
+ /** Overrides the generated id used by the native `<input>` and its `<label for>`. */
2519
2939
  readonly inputId: _angular_core.InputSignal<string | null>;
2940
+ /** Applies error styling and marks the input `aria-invalid`. */
2520
2941
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2942
+ /** Helper text shown below the switch. */
2521
2943
  readonly hint: _angular_core.InputSignal<string>;
2944
+ /** Switch size — sm/md/lg. */
2522
2945
  readonly size: _angular_core.InputSignal<SwitchSize>;
2946
+ /** Marks the field required — shows an asterisk and sets `aria-required`. */
2523
2947
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
2524
2948
  /** Inline label rendered beside the track and wired via for/id. Omit to
2525
2949
  * bring your own <label>. */