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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -104,6 +104,12 @@ interface DsConfig {
104
104
  * EVERY field in the injector's subtree, which is rarely what a whole app
105
105
  * wants; prefer `dsReserveMessages` on the individual form that validates. */
106
106
  reserveMessage?: boolean;
107
+ /** Fallback text per validation-error kind, for errors whose validator did
108
+ * not carry a `message` — Angular's built-ins never do, so this is where
109
+ * `required`, `minlength`, `email` and friends get their wording. A message
110
+ * on the error itself always wins, so one shared map here plus a per-case
111
+ * override at the validator covers both. Unmapped kinds warn in dev. */
112
+ errorMessages?: Record<string, string>;
107
113
  };
108
114
  breadcrumbs?: {
109
115
  separator?: IconName;
@@ -343,6 +349,9 @@ declare class ButtonComponent {
343
349
  /** ARIA `aria-expanded`, forwarded to the inner <button> — bind to the
344
350
  * overlay's open state on a trigger button. */
345
351
  readonly ariaExpanded: _angular_core.InputSignal<boolean | null>;
352
+ /** ARIA `aria-controls`, forwarded to the inner <button> — the id of the panel
353
+ * this button opens, e.g. `ds-app-layout`'s `railId`. */
354
+ readonly ariaControls: _angular_core.InputSignal<string | null>;
346
355
  /** Fires on click, unless `disabled` or `loading`. */
347
356
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
348
357
  /** The inner native <button>, exposed so overlay triggers can position
@@ -353,7 +362,7 @@ declare class ButtonComponent {
353
362
  constructor();
354
363
  protected onClick(event: MouseEvent): void;
355
364
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonComponent, never>;
356
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonComponent, "ds-button", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "trailingIcon": { "alias": "trailingIcon"; "required": false; "isSignal": true; }; "ariaHasPopup": { "alias": "ariaHasPopup"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["*", "[dsButtonSubtext]"], true, never>;
365
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonComponent, "ds-button", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "trailingIcon": { "alias": "trailingIcon"; "required": false; "isSignal": true; }; "ariaHasPopup": { "alias": "ariaHasPopup"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; "ariaControls": { "alias": "ariaControls"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["*", "[dsButtonSubtext]"], true, never>;
357
366
  }
358
367
 
359
368
  /** A single binary toggle button (pressed / not pressed) with an optional
@@ -398,13 +407,20 @@ declare class IconButtonComponent {
398
407
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
399
408
  /** Toggle state — renders the pressed/active look and sets aria-pressed. */
400
409
  readonly selected: _angular_core.InputSignalWithTransform<boolean, unknown>;
410
+ /** ARIA `aria-expanded`, forwarded to the inner `<button>` — bind to the open
411
+ * state when this button opens a panel. On the host element it would land on
412
+ * a non-focusable wrapper, which no screen reader reads. */
413
+ readonly ariaExpanded: _angular_core.InputSignal<boolean | null>;
414
+ /** ARIA `aria-controls`, forwarded to the inner `<button>` — the id of the
415
+ * panel this button opens, e.g. `ds-app-layout`'s `railId`. */
416
+ readonly ariaControls: _angular_core.InputSignal<string | null>;
401
417
  /** Fires on click, unless disabled. */
402
418
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
403
419
  protected readonly classes: _angular_core.Signal<string>;
404
420
  protected readonly iconSize: _angular_core.Signal<16 | 24 | 20>;
405
421
  protected onClick(event: MouseEvent): void;
406
422
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<IconButtonComponent, never>;
407
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<IconButtonComponent, "ds-icon-button", never, { "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": true; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, never, true, never>;
423
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<IconButtonComponent, "ds-icon-button", never, { "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": true; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; "ariaControls": { "alias": "ariaControls"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, never, true, never>;
408
424
  }
409
425
 
410
426
  declare class BadgeComponent {
@@ -479,44 +495,289 @@ declare class AppLayoutComponent {
479
495
  readonly railOpen: _angular_core.ModelSignal<boolean>;
480
496
  /** Accessible name for the rail while it is a modal overlay. */
481
497
  readonly railLabel: _angular_core.InputSignal<string>;
498
+ /**
499
+ * Remember the content scroll per path and restore it on the way BACK. Off by
500
+ * default: a layout that silently moved the scroll would surprise every existing
501
+ * consumer. Only a history traversal restores — following a link into a screen
502
+ * still lands at the top — plus a host that pushes its own "back to list" and
503
+ * says so with `state: { dsRestoreScroll: true }`, and the first navigation after
504
+ * a reload.
505
+ */
506
+ readonly restoreScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
507
+ /**
508
+ * How long to wait for the restored screen's content to grow tall enough before
509
+ * landing as close as it allows. Only meaningful with `restoreScroll`.
510
+ */
511
+ readonly restoreScrollTimeout: _angular_core.InputSignal<number>;
482
512
  /**
483
513
  * True only while the rail is an overlay. Gates the dialog semantics: above
484
514
  * the breakpoint the rail is an ordinary region, and a permanent
485
515
  * `role="dialog"` there would lie to a screen reader.
486
516
  */
487
517
  protected readonly compact: _angular_core.WritableSignal<boolean>;
518
+ /** Whether the rail is currently an overlay rather than part of the layout. */
519
+ readonly railOverlay: _angular_core.Signal<boolean>;
520
+ /** Id of the rail panel, for a trigger's `aria-controls`. */
521
+ readonly railId: string;
488
522
  private readonly layoutScroll;
489
523
  private readonly navigation;
490
524
  private readonly destroyRef;
491
525
  private readonly content;
492
526
  constructor();
527
+ /** Dismissal: Escape or the scrim. Restores focus, which navigation must not. */
493
528
  protected closeRail(): void;
494
529
  private watchDesktopBreakpoint;
495
530
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppLayoutComponent, never>;
496
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppLayoutComponent, "ds-app-layout", never, { "topbarSpan": { "alias": "topbarSpan"; "required": false; "isSignal": true; }; "railOpen": { "alias": "railOpen"; "required": false; "isSignal": true; }; "railLabel": { "alias": "railLabel"; "required": false; "isSignal": true; }; }, { "railOpen": "railOpenChange"; }, never, ["[sidenav]", "[topbar]", "*"], true, never>;
531
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppLayoutComponent, "ds-app-layout", never, { "topbarSpan": { "alias": "topbarSpan"; "required": false; "isSignal": true; }; "railOpen": { "alias": "railOpen"; "required": false; "isSignal": true; }; "railLabel": { "alias": "railLabel"; "required": false; "isSignal": true; }; "restoreScroll": { "alias": "restoreScroll"; "required": false; "isSignal": true; }; "restoreScrollTimeout": { "alias": "restoreScrollTimeout"; "required": false; "isSignal": true; }; }, { "railOpen": "railOpenChange"; }, never, ["[sidenav]", "[topbar]", "*"], true, never>;
532
+ }
533
+
534
+ /**
535
+ * Wires a consumer's own burger to the layout's overlay rail: toggles
536
+ * `[(railOpen)]` on click and keeps `aria-expanded` / `aria-controls` in sync, so
537
+ * the trigger and the panel are related for a screen reader.
538
+ *
539
+ * ```html
540
+ * <ds-app-layout>
541
+ * <ds-topbar topbar>
542
+ * <button dsRailTrigger type="button" aria-label="Navigation">☰</button>
543
+ * </ds-topbar>
544
+ * </ds-app-layout>
545
+ * ```
546
+ *
547
+ * PUT IT ON THE FOCUSABLE CONTROL, not on a wrapper: the attributes go on the
548
+ * host element, and on `<ds-icon-button>` that is the wrapper, whose inner
549
+ * `<button>` is what a screen reader actually reads. With a DS button, skip this
550
+ * directive and bind its forwarding inputs instead —
551
+ * `[ariaExpanded]="shell.railOverlay() ? shell.railOpen() : null"` and
552
+ * `[ariaControls]="shell.railId"` off a `<ds-app-layout #shell>` template ref.
553
+ *
554
+ * Both attributes are dropped while the rail is NOT an overlay: above the
555
+ * breakpoint the rail is permanently in the layout, so `aria-expanded="false"`
556
+ * would state the opposite of what the user sees.
557
+ *
558
+ * Must sit inside a `ds-app-layout` — the injector walks the declaration tree, so
559
+ * anywhere in the projected chrome works. Outside one, DI fails naming
560
+ * `AppLayoutComponent`, which says what is missing.
561
+ */
562
+ declare class RailTriggerDirective {
563
+ protected readonly layout: AppLayoutComponent;
564
+ protected toggle(): void;
565
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<RailTriggerDirective, never>;
566
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RailTriggerDirective, "[dsRailTrigger]", never, {}, {}, never, never, true, never>;
497
567
  }
498
568
 
499
569
  /**
500
- * Owns the layout's content scroller. In the fixed-frame layout the window
501
- * never scrolls, so the router's built-in window-based scrolling no-ops —
502
- * this service resets the registered container to the top when navigation
503
- * lands on a different PATH instead. Provided by `ds-app-layout`, so routed
504
- * pages can `inject(LayoutScrollService)` and call `scrollToTop()` manually
505
- * (e.g. list pages that DO want the top after a filter change). Per-route
506
- * scroll restoration is a documented growth point — add it here if a page
507
- * ever needs back-navigation scroll memory.
570
+ * Owns the layout's content scroller. In the fixed-frame layout the window never
571
+ * scrolls, so the router's built-in window-based scrolling no-ops — this service
572
+ * resets the registered container to the top when navigation lands on a different
573
+ * PATH instead. Provided by `ds-app-layout`, so routed pages can
574
+ * `inject(LayoutScrollService)` and call `scrollToTop()` manually (e.g. list pages
575
+ * that DO want the top after a filter change).
576
+ *
577
+ * With `restoreScroll` on the layout it also restores the reader's place. Only
578
+ * when ARMED, which is the whole design: going BACK to a list should return to
579
+ * where the reader was, while following a link into a new screen should not.
508
580
  */
509
581
  declare class LayoutScrollService {
510
582
  private readonly navigation;
583
+ private readonly router;
511
584
  private readonly destroyRef;
512
- private scrollContainer;
585
+ private readonly container;
586
+ /**
587
+ * The content scroller, once the layout has rendered it. Exposed so a host that
588
+ * must measure or drive the scroll itself — a scroll-spy, a virtualizer — can
589
+ * ask the layout for it instead of guessing the layout's internal markup with
590
+ * `document.querySelector`.
591
+ */
592
+ readonly scroller: _angular_core.Signal<Element | null>;
593
+ private restoreTimeoutMs;
594
+ private armed;
595
+ private pendingOffset;
596
+ private endRestore;
597
+ private firstNavigation;
513
598
  constructor();
599
+ /**
600
+ * Wiring, called by `ds-app-layout` once its content region exists. Public only
601
+ * because the component and the service sit in different files - a consumer has
602
+ * no reason to call it, and calling it points the service at the wrong element.
603
+ */
514
604
  setScrollContainer(element: Element): void;
605
+ /** Wiring: `ds-app-layout` mirrors its `restoreScroll` inputs through here. */
606
+ configureRestore(timeoutMs: number | null): void;
515
607
  scrollToTop(): void;
608
+ /**
609
+ * Scroll the content region to an absolute offset. Assigns `scrollTop` rather
610
+ * than calling `scrollTo`, so a themed `scroll-behavior: smooth` cannot turn a
611
+ * positioning jump into an animation.
612
+ */
613
+ scrollTo(top: number): void;
614
+ /**
615
+ * Take the offset this navigation is going to restore, and cancel the restore.
616
+ *
617
+ * For a host that renders its own scroll position — a virtualizer needs the
618
+ * offset BEFORE it decides which rows to build, so letting the service assign
619
+ * `scrollTop` afterwards would scroll a list that has not been built yet.
620
+ * Returns null when nothing is pending, which is every navigation that is not a
621
+ * back.
622
+ */
623
+ consumePendingOffset(): number | null;
624
+ /**
625
+ * Optional accelerator: tell the layout the content for this route is in the
626
+ * DOM. Without it the restore still lands — it waits for the container to grow
627
+ * and clamps at the deadline — but a host that knows when its data arrived can
628
+ * end the wait early instead of paying the growth watch.
629
+ */
630
+ contentReady(): void;
631
+ private onNavigationStart;
632
+ private onNavigationEnd;
633
+ private beginRestore;
634
+ private applyClamped;
635
+ private finishRestore;
636
+ private read;
637
+ private remember;
638
+ private recall;
516
639
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<LayoutScrollService, never>;
517
640
  static ɵprov: _angular_core.ɵɵInjectableDeclaration<LayoutScrollService>;
518
641
  }
519
642
 
643
+ type CardElevation = 'flat' | 'raised' | 'hover' | 'interactive';
644
+ type CardPadding = 'none' | 'sm' | 'md' | 'lg';
645
+
646
+ /**
647
+ * Marks projected wordmark markup for `ds-sidenav`: when present, the sidenav
648
+ * renders the projected content inside `.brand-name` instead of the plain
649
+ * `brand` text (two-tone wordmarks, inline logos etc. stay consumer-side).
650
+ *
651
+ * Interplay: projecting `[dsBrandName]` is enough to render the brand row and
652
+ * its wordmark even without a string `brand`, but it only supplies the
653
+ * wordmark — the letter-mark tile still comes from `logoLetter` (or the first
654
+ * letter of `brand`), so an empty `brand` + projection renders the wordmark
655
+ * with no tile.
656
+ */
657
+ declare class BrandNameDirective {
658
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<BrandNameDirective, never>;
659
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BrandNameDirective, "[dsBrandName]", never, {}, {}, never, never, true, never>;
660
+ }
661
+
662
+ /**
663
+ * Scaffold for the UNauthenticated screens — sign-in, forgot password, reset,
664
+ * MFA — and the counterpart to `ds-app-layout`, which only ever covers the
665
+ * screens behind the login.
666
+ *
667
+ * Brand row, tagline, card and support footer are the same four parts in every
668
+ * consumer that has hand-rolled this. What the ports get wrong is the full-height
669
+ * box: they nest a `100vh` wrapper inside a `100dvh` one and scroll a page whose
670
+ * content fits. Here the host is the only one, and it also carries the safe-area
671
+ * insets a notched phone in landscape needs.
672
+ *
673
+ * The brand row follows `ds-sidenav`: a `brand` string gets a letter-mark tile
674
+ * plus wordmark, `logoLetter` overrides the glyph, `[dsBrandName]` projects a
675
+ * two-tone wordmark, and `[brand]` projects a real logo instead of the tile.
676
+ *
677
+ * ```html
678
+ * <ds-auth-shell brand="MyAdmin" logoLetter="A" tagline="Broker administration">
679
+ * <h1 class="title">Sign in</h1>
680
+ * <form class="form">…</form>
681
+ *
682
+ * <p dsAuthSupport>
683
+ * Need a hand? <a href="mailto:support@example.com">Contact support</a>
684
+ * </p>
685
+ * </ds-auth-shell>
686
+ * ```
687
+ */
688
+ declare class AuthShellComponent {
689
+ /** Wordmark beside the letter-mark tile. For a logo image/SVG, project it into
690
+ * the `[brand]` slot instead; for a two-tone wordmark use `[dsBrandName]`. */
691
+ readonly brand: _angular_core.InputSignal<string>;
692
+ /** Letter-mark glyph when it differs from the brand's first letter (e.g. an
693
+ * "A" tile beside the "MyAdmin" wordmark). Empty = first letter of `brand`. */
694
+ readonly logoLetter: _angular_core.InputSignal<string>;
695
+ /** One line under the wordmark naming the product or audience. */
696
+ readonly tagline: _angular_core.InputSignal<string>;
697
+ /** Card treatment. `flat` suits a screen that already sits on a tinted canvas. */
698
+ readonly cardElevation: _angular_core.InputSignal<CardElevation>;
699
+ /** Card padding, passed through to `ds-card`. `md` tightens a short form. */
700
+ readonly cardPadding: _angular_core.InputSignal<CardPadding>;
701
+ /** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
702
+ protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
703
+ protected readonly hasBrandName: _angular_core.Signal<boolean>;
704
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<AuthShellComponent, never>;
705
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AuthShellComponent, "ds-auth-shell", never, { "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "logoLetter": { "alias": "logoLetter"; "required": false; "isSignal": true; }; "tagline": { "alias": "tagline"; "required": false; "isSignal": true; }; "cardElevation": { "alias": "cardElevation"; "required": false; "isSignal": true; }; "cardPadding": { "alias": "cardPadding"; "required": false; "isSignal": true; }; }, {}, ["brandNameRef"], ["[brand]", "[dsBrandName]", "*", "[dsAuthSupport]"], true, never>;
706
+ }
707
+
708
+ /**
709
+ * One filter inside `ds-filter-bar`, with the width it should occupy:
710
+ * `<ng-template [dsFilterItem]="220"> <ds-date-picker … /> </ng-template>`.
711
+ *
712
+ * A template rather than plain projection because the bar has to MOVE the filters
713
+ * that do not fit into its overflow panel, and projected DOM cannot be relocated
714
+ * — it renders where it was projected. The cost is that crossing the boundary
715
+ * destroys and re-creates the view, so a control's internal state (an open panel,
716
+ * focus) does not survive a resize that collapses it. Its VALUE does: that lives
717
+ * in the consumer's own signal or form control.
718
+ *
719
+ * The width is a contract, not a hint — the bar sizes the slot to exactly this
720
+ * and decides the split from it, so a control that would render wider is
721
+ * narrowed rather than allowed to break the row.
722
+ */
723
+ declare class FilterItemDirective {
724
+ readonly template: TemplateRef<unknown>;
725
+ /** Slot width in px. Bare `dsFilterItem` (or a non-positive value) means 180. */
726
+ readonly width: _angular_core.InputSignalWithTransform<number, unknown>;
727
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FilterItemDirective, never>;
728
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FilterItemDirective, "ng-template[dsFilterItem]", never, { "width": { "alias": "dsFilterItem"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
729
+ }
730
+
731
+ /**
732
+ * Priority+ filter row: renders as many filters as fit and collapses the rest
733
+ * into a "+N more" panel. Every admin list past three filters hits the same wall
734
+ * — the row wraps to a second line on a laptop, or the consumer hand-rolls this.
735
+ *
736
+ * The split is decided from each item's declared width plus one `ResizeObserver`
737
+ * on the row, never by measuring the filters themselves: they would have to be in
738
+ * the DOM to be measured, so anything that did not fit would flash before being
739
+ * taken away. `[dsFilterItem]` carries the width.
740
+ *
741
+ * Anything marked `dsFilterBarTrailing` — search, a Clear button — sits at the
742
+ * trailing edge and never collapses. Mark each control rather than wrapping them:
743
+ * the bar owns that row's gap and alignment, and a projected wrapper would be a
744
+ * plain block whose children stack. The trailing group is outside the measured
745
+ * row, so flexbox subtracts its width before the row is measured and the
746
+ * arithmetic needs no allowance for it.
747
+ *
748
+ * ```html
749
+ * <ds-filter-bar>
750
+ * <ng-template [dsFilterItem]="180">
751
+ * <ds-select label="Status" … />
752
+ * </ng-template>
753
+ * <ng-template [dsFilterItem]="220">
754
+ * <ds-date-picker label="Opened" … />
755
+ * </ng-template>
756
+ *
757
+ * <ds-search dsFilterBarTrailing … />
758
+ * <ds-button dsFilterBarTrailing variant="text">Clear</ds-button>
759
+ * </ds-filter-bar>
760
+ * ```
761
+ */
762
+ declare class FilterBarComponent {
763
+ /** Trailing word of the trigger, after the count: "+2 filters". */
764
+ readonly moreLabel: _angular_core.InputSignal<string>;
765
+ /** Accessible name of the overflow panel. */
766
+ readonly panelLabel: _angular_core.InputSignal<string>;
767
+ protected readonly devMode: boolean;
768
+ protected readonly items: _angular_core.Signal<readonly FilterItemDirective[]>;
769
+ private readonly row;
770
+ private readonly rowWidth;
771
+ private readonly gap;
772
+ protected readonly inlineCount: _angular_core.Signal<number>;
773
+ protected readonly inline: _angular_core.Signal<FilterItemDirective[]>;
774
+ /** The filters currently in the overflow panel. */
775
+ readonly collapsed: _angular_core.Signal<FilterItemDirective[]>;
776
+ constructor();
777
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FilterBarComponent, never>;
778
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FilterBarComponent, "ds-filter-bar", never, { "moreLabel": { "alias": "moreLabel"; "required": false; "isSignal": true; }; "panelLabel": { "alias": "panelLabel"; "required": false; "isSignal": true; }; }, {}, ["items"], ["[dsFilterBarTrailing]", "*"], true, never>;
779
+ }
780
+
520
781
  type AvatarSize = 'xs' | DsSize;
521
782
  type AvatarStatus = 'online' | 'offline' | 'away' | 'busy';
522
783
 
@@ -596,9 +857,6 @@ declare class AvatarGroupComponent {
596
857
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<AvatarGroupComponent, "ds-avatar-group", never, { "max": { "alias": "max"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
597
858
  }
598
859
 
599
- type CardElevation = 'flat' | 'raised' | 'hover' | 'interactive';
600
- type CardPadding = 'none' | 'sm' | 'md' | 'lg';
601
-
602
860
  declare class CardComponent {
603
861
  /** Visual treatment; `interactive` makes the card clickable and emits `pressed`. */
604
862
  readonly elevation: _angular_core.InputSignal<CardElevation>;
@@ -700,6 +958,32 @@ declare class TabsComponent {
700
958
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabsComponent, "ds-tabs", never, { "selectedIndex": { "alias": "selectedIndex"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "scrollable": { "alias": "scrollable"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; }, { "selectedIndex": "selectedIndexChange"; "tabClosed": "tabClosed"; }, ["tabs"], never, true, never>;
701
959
  }
702
960
 
961
+ type FieldMessageState = 'default' | 'error' | 'warning' | 'success';
962
+
963
+ /**
964
+ * One validation error, structurally identical to Angular's signal-forms
965
+ * `ValidationError`.
966
+ *
967
+ * Declared here rather than imported from `@angular/forms/signals` on purpose:
968
+ * that module is `@experimental`, and a public DS type must not carry a
969
+ * dependency that can be renamed out from under consumers. Structural
970
+ * compatibility is all the interop needs — signal forms binds by input NAME and
971
+ * assigns its own `ValidationError[]`, which this shape accepts.
972
+ */
973
+ interface DsFieldError {
974
+ /** Identifies the kind of error, e.g. `required`, `minlength`, `server`. */
975
+ readonly kind: string;
976
+ /** Human-readable text. Authored by the consumer, at the validator. */
977
+ readonly message?: string;
978
+ }
979
+ /** What a field's `errors` input accepts before normalization. */
980
+ type DsFieldErrorsInput = string | DsFieldError | readonly DsFieldError[] | null | undefined;
981
+ /** The single line a field shows below itself, already resolved. */
982
+ interface DsFieldMessage {
983
+ readonly text: string;
984
+ readonly state: FieldMessageState;
985
+ }
986
+
703
987
  /**
704
988
  * Shared `ControlValueAccessor` for DS form controls whose value is a signal
705
989
  * `model()`. Bridges that model with Angular forms (reactive `formControl` /
@@ -715,6 +999,7 @@ declare abstract class DsControlValueAccessor<T> implements ControlValueAccessor
715
999
  abstract readonly value: ModelSignal<T>;
716
1000
  /** Driven by the forms API via `setDisabledState`. */
717
1001
  protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
1002
+ protected readonly touchedSelf: _angular_core.WritableSignal<boolean>;
718
1003
  private onChange;
719
1004
  private onTouched;
720
1005
  private synced;
@@ -741,6 +1026,7 @@ declare abstract class DsBooleanControlValueAccessor implements ControlValueAcce
741
1026
  abstract readonly checked: ModelSignal<boolean>;
742
1027
  /** Driven by the forms API via `setDisabledState`. */
743
1028
  protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
1029
+ protected readonly touchedSelf: _angular_core.WritableSignal<boolean>;
744
1030
  private onChange;
745
1031
  private onTouched;
746
1032
  private synced;
@@ -756,8 +1042,6 @@ declare abstract class DsBooleanControlValueAccessor implements ControlValueAcce
756
1042
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsBooleanControlValueAccessor, never, never, {}, {}, never, never, true, never>;
757
1043
  }
758
1044
 
759
- type FieldMessageState = 'default' | 'error' | 'success';
760
-
761
1045
  type InputType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search';
762
1046
 
763
1047
  declare class InputComponent extends DsControlValueAccessor<string> {
@@ -772,6 +1056,18 @@ declare class InputComponent extends DsControlValueAccessor<string> {
772
1056
  readonly label: _angular_core.InputSignal<string>;
773
1057
  /** Helper text shown below the field. */
774
1058
  readonly hint: _angular_core.InputSignal<string>;
1059
+ /** Error text. Shown immediately — binding it says the consumer has already
1060
+ * decided this field is in error. Takes precedence over `errors`. */
1061
+ readonly error: _angular_core.InputSignal<string>;
1062
+ /** Advisory text, shown when there is no error. */
1063
+ readonly warning: _angular_core.InputSignal<string>;
1064
+ /** Validation errors, shown once the user has interacted. Bound automatically
1065
+ * by signal forms; reactive and template-driven forms are read through
1066
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
1067
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
1068
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
1069
+ * `errors`, so a `required` error does not greet an untouched form. */
1070
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
775
1071
  /** Reserve the message-row height even when empty, so the field doesn't shift
776
1072
  * the layout below it when a hint/error appears. Falls back to
777
1073
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -813,6 +1109,11 @@ declare class InputComponent extends DsControlValueAccessor<string> {
813
1109
  /** Accessible name when no visible `label` is provided (falls back to the
814
1110
  * placeholder so the control is never unnamed). */
815
1111
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
1112
+ /** Extra element ids to describe the control with — a password-rule list, a
1113
+ * policy note. MERGED with the field's own message id rather than replacing
1114
+ * it, and it has to be an input because the attribute belongs on the inner
1115
+ * `<input>`: set on the host it lands on a wrapper no screen reader reads. */
1116
+ readonly ariaDescribedBy: _angular_core.InputSignal<string | null>;
816
1117
  /** Hard character cap — applies the native maxlength attribute and shows a
817
1118
  * live "{current}/{max}" counter below the field. */
818
1119
  readonly maxLength: _angular_core.InputSignal<number | null>;
@@ -837,7 +1138,10 @@ declare class InputComponent extends DsControlValueAccessor<string> {
837
1138
  protected readonly canClear: _angular_core.Signal<boolean>;
838
1139
  protected readonly uid: string;
839
1140
  protected readonly hintId: _angular_core.Signal<string | null>;
840
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
1141
+ protected readonly describedBy: _angular_core.Signal<string | null>;
1142
+ private readonly fieldMessage;
1143
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
1144
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
841
1145
  /** Only name via aria-label when there's no visible `<label for>`. */
842
1146
  protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
843
1147
  /** Effective disabled — own `disabled` input OR the reactive-forms state. */
@@ -853,7 +1157,7 @@ declare class InputComponent extends DsControlValueAccessor<string> {
853
1157
  focus(options?: FocusOptions): void;
854
1158
  protected clear(): void;
855
1159
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<InputComponent, never>;
856
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<InputComponent, "ds-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "floating": { "alias": "floating"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "enterKeyHint": { "alias": "enterKeyHint"; "required": false; "isSignal": true; }; "inputMode": { "alias": "inputMode"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "passwordToggle": { "alias": "passwordToggle"; "required": false; "isSignal": true; }; "passwordVisible": { "alias": "passwordVisible"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "blurred": "blurred"; "passwordVisible": "passwordVisibleChange"; }, never, ["[dsInputPrefix]", "[dsInputSuffix]"], true, never>;
1160
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<InputComponent, "ds-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "floating": { "alias": "floating"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "enterKeyHint": { "alias": "enterKeyHint"; "required": false; "isSignal": true; }; "inputMode": { "alias": "inputMode"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "passwordToggle": { "alias": "passwordToggle"; "required": false; "isSignal": true; }; "passwordVisible": { "alias": "passwordVisible"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "blurred": "blurred"; "passwordVisible": "passwordVisibleChange"; }, never, ["[dsInputPrefix]", "[dsInputSuffix]"], true, never>;
857
1161
  }
858
1162
 
859
1163
  declare class NumberStepperComponent {
@@ -893,6 +1197,18 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
893
1197
  readonly label: _angular_core.InputSignal<string>;
894
1198
  /** Helper text shown below the field. */
895
1199
  readonly hint: _angular_core.InputSignal<string>;
1200
+ /** Error text. Shown immediately — binding it says the consumer has already
1201
+ * decided this field is in error. Takes precedence over `errors`. */
1202
+ readonly error: _angular_core.InputSignal<string>;
1203
+ /** Advisory text, shown when there is no error. */
1204
+ readonly warning: _angular_core.InputSignal<string>;
1205
+ /** Validation errors, shown once the user has interacted. Bound automatically
1206
+ * by signal forms; reactive and template-driven forms are read through
1207
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
1208
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
1209
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
1210
+ * `errors`, so a `required` error does not greet an untouched form. */
1211
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
896
1212
  /** Reserve the message-row height even when empty, so the field doesn't shift
897
1213
  * the layout below it when a hint/error appears. Falls back to
898
1214
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -930,7 +1246,9 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
930
1246
  readonly maxLength: _angular_core.InputSignal<number | null>;
931
1247
  protected readonly uid: string;
932
1248
  protected readonly hintId: _angular_core.Signal<string | null>;
933
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
1249
+ private readonly fieldMessage;
1250
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
1251
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
934
1252
  protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
935
1253
  /** Effective disabled — own `disabled` input OR the reactive-forms state. */
936
1254
  protected readonly isDisabled: _angular_core.Signal<boolean>;
@@ -944,7 +1262,7 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
944
1262
  * deliberately, e.g. focusing the first invalid field on a failed submit. */
945
1263
  focus(options?: FocusOptions): void;
946
1264
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextareaComponent, never>;
947
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextareaComponent, "ds-textarea", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "autosize": { "alias": "autosize"; "required": false; "isSignal": true; }; "minRows": { "alias": "minRows"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "resize": { "alias": "resize"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
1265
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextareaComponent, "ds-textarea", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "autosize": { "alias": "autosize"; "required": false; "isSignal": true; }; "minRows": { "alias": "minRows"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "resize": { "alias": "resize"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
948
1266
  }
949
1267
 
950
1268
  declare class SearchComponent {
@@ -976,6 +1294,13 @@ declare class SearchComponent {
976
1294
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<SearchComponent, "ds-search", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "shortcut": { "alias": "shortcut"; "required": false; "isSignal": true; }; "showIcon": { "alias": "showIcon"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "submitted": "submitted"; }, never, never, true, never>;
977
1295
  }
978
1296
 
1297
+ /**
1298
+ * Why a panel is closing. `'select'` is a deliberate action that produced a
1299
+ * result — an option chosen, a date picked, the trigger pressed again, Tab moving
1300
+ * on; `'dismiss'` is ambient — Escape, a press outside, the page scrolling away.
1301
+ */
1302
+ type DsOverlayCloseCause = 'select' | 'dismiss';
1303
+
979
1304
  /** Showcase-only: renders the component's open/overlay surface inline in normal
980
1305
  * flow instead of its real overlay mechanics (for static docs specimens).
981
1306
  * Not part of the production contract. */
@@ -1022,6 +1347,18 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1022
1347
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1023
1348
  /** Helper text shown below the trigger. */
1024
1349
  readonly hint: _angular_core.InputSignal<string>;
1350
+ /** Error text. Shown immediately — binding it says the consumer has already
1351
+ * decided this field is in error. Takes precedence over `errors`. */
1352
+ readonly error: _angular_core.InputSignal<string>;
1353
+ /** Advisory text, shown when there is no error. */
1354
+ readonly warning: _angular_core.InputSignal<string>;
1355
+ /** Validation errors, shown once the user has interacted. Bound automatically
1356
+ * by signal forms; reactive and template-driven forms are read through
1357
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
1358
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
1359
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
1360
+ * `errors`, so a `required` error does not greet an untouched form. */
1361
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1025
1362
  /** Reserve the message-row height even when empty, so the field doesn't shift
1026
1363
  * the layout below it when a hint/error appears. Falls back to
1027
1364
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -1042,7 +1379,9 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1042
1379
  protected readonly labelId: string;
1043
1380
  protected readonly listboxId: string;
1044
1381
  protected readonly hintId: _angular_core.Signal<string | null>;
1045
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
1382
+ private readonly fieldMessage;
1383
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
1384
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
1046
1385
  protected optionId(flatIndex: number): string;
1047
1386
  /** Active option for `aria-activedescendant` (combobox keeps DOM focus). */
1048
1387
  protected readonly activeDescendant: _angular_core.Signal<string | null>;
@@ -1068,7 +1407,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1068
1407
  protected flatIndexOf(opt: SelectOption): number;
1069
1408
  protected toggle(): void;
1070
1409
  protected openPanel(): void;
1071
- protected close(): void;
1410
+ protected close(cause?: DsOverlayCloseCause): void;
1072
1411
  ngOnDestroy(): void;
1073
1412
  protected pick(option: SelectOption, groupDisabled?: boolean): void;
1074
1413
  protected clearValue(event: MouseEvent): void;
@@ -1080,7 +1419,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1080
1419
  private firstEnabledIndex;
1081
1420
  private lastEnabledIndex;
1082
1421
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
1083
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
1422
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
1084
1423
  }
1085
1424
 
1086
1425
  /**
@@ -1108,6 +1447,20 @@ declare class CellTemplateDirective {
1108
1447
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CellTemplateDirective, "[dsCellTemplate]", never, { "dsCellTemplate": { "alias": "dsCellTemplate"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
1109
1448
  }
1110
1449
 
1450
+ /**
1451
+ * Who sorts a `ds-table`.
1452
+ *
1453
+ * - `'client'` (default) — the table reorders `data()` itself.
1454
+ * - `'server'` — the table only emits `sortChange`; the host reorders.
1455
+ * - `'none'` — nothing sorts, and `sortable` columns render no affordance rather
1456
+ * than a control that does nothing.
1457
+ *
1458
+ * Replaces the boolean `clientSort`, which could not express `'none'`: a column
1459
+ * marked `sortable` on a table with no sorting drew a live-looking header that
1460
+ * did nothing, and no type or dev check could catch it.
1461
+ */
1462
+ type TableSortMode = 'client' | 'server' | 'none';
1463
+
1111
1464
  interface TableColumn<T = unknown> {
1112
1465
  key: string;
1113
1466
  label: string;
@@ -1130,7 +1483,7 @@ interface TableColumn<T = unknown> {
1130
1483
  align?: 'left' | 'right' | 'center';
1131
1484
  cell?: (row: T) => string;
1132
1485
  /** Sort this column by a DOMAIN value instead of the rendered text. Without
1133
- * it, `clientSort` compares what the cell displays, so `$1.2M / $840K / $95K`
1486
+ * it, client sorting compares what the cell displays, so `$1.2M / $840K / $95K`
1134
1487
  * sorts by the leading character and `Oct 09, 2023 / Feb 27, 2024` sorts by
1135
1488
  * month NAME — the table looks sorted and is not. Return the underlying
1136
1489
  * number, `Date` or plain string; `null`/`undefined`/`''` counts as blank and
@@ -1254,6 +1607,25 @@ declare class TableComponent<T extends object> {
1254
1607
  * order; the column panel owns it once the user reorders. Keys absent from
1255
1608
  * the list fall back to declaration order after the listed ones. */
1256
1609
  readonly columnOrder: _angular_core.ModelSignal<string[] | null>;
1610
+ /** Round-trip `columnOrder`, `columnWidths` and `hiddenKeys` through
1611
+ * `localStorage`, so a reader's column layout survives a reload. Needs
1612
+ * `storageKey` — without one there is nothing to key a screen by, and two
1613
+ * tables would overwrite each other. Off by default. */
1614
+ readonly persistLayout: _angular_core.InputSignalWithTransform<boolean, unknown>;
1615
+ /** Screen id the persisted layout is stored under. Pick something stable per
1616
+ * table, not per route instance. */
1617
+ readonly storageKey: _angular_core.InputSignal<string>;
1618
+ /** Render an export button above the table. Off by default; `exportCsv()`
1619
+ * stays available for a consumer's own button. */
1620
+ readonly exportButton: _angular_core.InputSignalWithTransform<boolean, unknown>;
1621
+ /** Filename the export button downloads as. */
1622
+ readonly exportFilename: _angular_core.InputSignal<string>;
1623
+ /** Rows to export instead of what the table holds. A server-paged table only
1624
+ * HAS the current page, so exporting without this silently exports one page —
1625
+ * return the whole set here and the button awaits it. */
1626
+ readonly exportFetcher: _angular_core.InputSignal<(() => Promise<readonly T[]>) | null>;
1627
+ /** True while `exportFetcher` is in flight, so the button can disable itself. */
1628
+ protected readonly exporting: _angular_core.WritableSignal<boolean>;
1257
1629
  /** Keeps the horizontal scrollbar reachable on tall tables: the scroll
1258
1630
  * container's native bar is hidden and a proxy stuck to the bottom of the
1259
1631
  * nearest scroll ancestor mirrors it both ways. Off by default. */
@@ -1272,14 +1644,30 @@ declare class TableComponent<T extends object> {
1272
1644
  /** Scroll the table into view on a page change (opt-in) — keeps a bottom
1273
1645
  * pager from leaving the viewport on the previous page's last rows. */
1274
1646
  readonly scrollToTopOnPageChange: _angular_core.InputSignalWithTransform<boolean, unknown>;
1275
- /** When true, the table sorts `data()` itself; otherwise it only emits
1276
- * `sortChange` and leaves ordering to the consumer (default). */
1277
- readonly clientSort: _angular_core.InputSignalWithTransform<boolean, unknown>;
1647
+ /** Who sorts — see `TableSortMode`. Unset resolves to `'client'`, so a column
1648
+ * marked `sortable` always does something; declare `'server'` when the host
1649
+ * reorders, or `'none'` to drop the affordance entirely. */
1650
+ readonly sortMode: _angular_core.InputSignal<TableSortMode | null>;
1651
+ protected readonly sortModeResolved: _angular_core.Signal<TableSortMode>;
1278
1652
  /** Pin the first data column (and the select column) on horizontal scroll. */
1279
1653
  readonly stickyFirstColumn: _angular_core.InputSignalWithTransform<boolean, unknown>;
1654
+ /**
1655
+ * Render only the rows in view, padding the rest with two spacer rows. Opt-in,
1656
+ * and it needs `maxHeight` — without a bounded scroller there is no viewport to
1657
+ * window against, so nothing is virtualized (dev-warned).
1658
+ *
1659
+ * Every row must be the same height, which is `virtualRowSize`: the arithmetic
1660
+ * that decides what is in view has no other way to know where a row starts. So
1661
+ * virtual mode forces `table-layout: fixed` and single-line cells, and the
1662
+ * expansion panel is suppressed — a row that can grow breaks the maths.
1663
+ */
1664
+ readonly virtualScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
1665
+ /** Row height in px in virtual mode. Must match what the rows actually
1666
+ * measure, so it drives the CSS height rather than merely describing it. */
1667
+ readonly virtualRowSize: _angular_core.InputSignal<number>;
1280
1668
  /** Fires with the row on click (or Enter/Space when `rowInteractive`). */
1281
1669
  readonly rowClicked: _angular_core.OutputEmitterRef<T>;
1282
- /** Fires whenever sort key/direction changes, regardless of `clientSort`. */
1670
+ /** Fires whenever sort key/direction changes, in every `sortMode` but `'none'`. */
1283
1671
  readonly sortChange: _angular_core.OutputEmitterRef<SortChangeEvent>;
1284
1672
  /** Row-action menu items rendered as a trailing kebab (⋮) column.
1285
1673
  * Empty (default) — no column. Menu clicks never trigger `rowClicked`. */
@@ -1380,12 +1768,30 @@ declare class TableComponent<T extends object> {
1380
1768
  * substring search with any per-column set filters. Sorting and pagination
1381
1769
  * run on the filtered rows. */
1382
1770
  protected readonly filteredData: _angular_core.Signal<readonly T[]>;
1383
- /** Client-side sort over the filtered data set — only when `clientSort()`. */
1771
+ /** Client-side sort over the filtered data set — only in `'client'` mode. */
1384
1772
  protected readonly sortedData: _angular_core.Signal<readonly T[]>;
1385
1773
  /** Current page's slice of the sorted rows, when paginating. */
1386
1774
  protected readonly pagedData: _angular_core.Signal<readonly T[]>;
1387
1775
  /** Rows actually rendered: paged when paginating, else sorted/raw data. */
1388
1776
  protected readonly displayData: _angular_core.Signal<readonly T[]>;
1777
+ /** Virtual mode needs a bounded scroller to window against. */
1778
+ protected readonly virtualizing: _angular_core.Signal<boolean>;
1779
+ /** Drives the CSS row height from the same number the arithmetic uses, so the
1780
+ * two cannot drift — which would make every offset progressively wrong. */
1781
+ protected readonly virtualRowHeight: _angular_core.Signal<string>;
1782
+ /** `null` when not virtualizing — the row loop then walks `displayData()` whole. */
1783
+ protected readonly virtualWindow: _angular_core.Signal<{
1784
+ start: number;
1785
+ end: number;
1786
+ padTop: number;
1787
+ padBottom: number;
1788
+ } | null>;
1789
+ /** The rows the template actually renders. */
1790
+ protected readonly windowData: _angular_core.Signal<readonly T[]>;
1791
+ /** Zebra striping cannot come from `:nth-child` while windowing — the parity
1792
+ * of a rendered row depends on its ABSOLUTE index, and the spacer rows are
1793
+ * children too. Matches `:nth-child(odd)`, which is 1-based. */
1794
+ protected isStriped(rowIndex: number): boolean;
1389
1795
  protected readonly allSelected: _angular_core.Signal<boolean>;
1390
1796
  protected readonly someSelected: _angular_core.Signal<boolean>;
1391
1797
  /** Select-all is page-scoped only when paginating. */
@@ -1410,6 +1816,8 @@ declare class TableComponent<T extends object> {
1410
1816
  private readonly hscrollProxy;
1411
1817
  protected readonly hscrollContentWidth: _angular_core.WritableSignal<number>;
1412
1818
  protected readonly hscrollNeeded: _angular_core.WritableSignal<boolean>;
1819
+ private readonly scrollTop;
1820
+ private readonly viewportHeight;
1413
1821
  constructor();
1414
1822
  private parseDurationMs;
1415
1823
  protected onRowMenuClick(row: T, event: Event): void;
@@ -1431,6 +1839,8 @@ declare class TableComponent<T extends object> {
1431
1839
  /** Row identity — the `rowId` accessor when given, else `row.id`. Public so a
1432
1840
  * host reading `selectedIds`/`expandedIds` can compute the same keys. */
1433
1841
  rowKey(row: T): string;
1842
+ /** Whether this column's header is an actual sort control right now. */
1843
+ protected sortableCol(col: TableColumn<T>): boolean;
1434
1844
  protected ariaSort(col: TableColumn<T>): 'ascending' | 'descending' | 'none' | null;
1435
1845
  protected onSort(col: TableColumn<T>): void;
1436
1846
  protected headerClasses(col: TableColumn<T>): string;
@@ -1439,12 +1849,19 @@ declare class TableComponent<T extends object> {
1439
1849
  /** Exports the visible columns of the filtered + sorted rows (all rows, not
1440
1850
  * just the current page) as a CSV download. Call from a consumer button:
1441
1851
  * `<ds-button (pressed)="table.exportCsv()">`. */
1442
- exportCsv(filename?: string): void;
1852
+ exportCsv(filename?: string, rows?: readonly T[]): void;
1853
+ private layoutKey;
1854
+ private layoutRestored;
1855
+ private restoreLayout;
1856
+ private saveLayout;
1857
+ /** Export button handler: awaits `exportFetcher` when one is given, so a
1858
+ * server-paged table exports the whole set rather than the page it holds. */
1859
+ protected runExport(): Promise<void>;
1443
1860
  /** Deterministic per-cell width so skeleton rows look organic but stable
1444
1861
  * across re-renders. Mixes column key + row index into one of five widths. */
1445
1862
  protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
1446
1863
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
1447
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "animateHeight": { "alias": "animateHeight"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDir": { "alias": "sortDir"; "required": false; "isSignal": true; }; "sortingOrder": { "alias": "sortingOrder"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "activeRowId": { "alias": "activeRowId"; "required": false; "isSignal": true; }; "filterQuery": { "alias": "filterQuery"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "hiddenKeys": { "alias": "hiddenKeys"; "required": false; "isSignal": true; }; "resizableColumns": { "alias": "resizableColumns"; "required": false; "isSignal": true; }; "columnWidths": { "alias": "columnWidths"; "required": false; "isSignal": true; }; "reorderableColumns": { "alias": "reorderableColumns"; "required": false; "isSignal": true; }; "columnOrder": { "alias": "columnOrder"; "required": false; "isSignal": true; }; "stickyScrollbar": { "alias": "stickyScrollbar"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "clientSort": { "alias": "clientSort"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKey": "sortKeyChange"; "sortDir": "sortDirChange"; "columnFilters": "columnFiltersChange"; "hiddenKeys": "hiddenKeysChange"; "columnWidths": "columnWidthsChange"; "columnOrder": "columnOrderChange"; "pageSize": "pageSizeChange"; "page": "pageChange"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; }, ["cellTemplateDirectives"], ["[empty]", "[bulk-actions]"], true, never>;
1864
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "animateHeight": { "alias": "animateHeight"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDir": { "alias": "sortDir"; "required": false; "isSignal": true; }; "sortingOrder": { "alias": "sortingOrder"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "activeRowId": { "alias": "activeRowId"; "required": false; "isSignal": true; }; "filterQuery": { "alias": "filterQuery"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "hiddenKeys": { "alias": "hiddenKeys"; "required": false; "isSignal": true; }; "resizableColumns": { "alias": "resizableColumns"; "required": false; "isSignal": true; }; "columnWidths": { "alias": "columnWidths"; "required": false; "isSignal": true; }; "reorderableColumns": { "alias": "reorderableColumns"; "required": false; "isSignal": true; }; "columnOrder": { "alias": "columnOrder"; "required": false; "isSignal": true; }; "persistLayout": { "alias": "persistLayout"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "exportButton": { "alias": "exportButton"; "required": false; "isSignal": true; }; "exportFilename": { "alias": "exportFilename"; "required": false; "isSignal": true; }; "exportFetcher": { "alias": "exportFetcher"; "required": false; "isSignal": true; }; "stickyScrollbar": { "alias": "stickyScrollbar"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "sortMode": { "alias": "sortMode"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualRowSize": { "alias": "virtualRowSize"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKey": "sortKeyChange"; "sortDir": "sortDirChange"; "columnFilters": "columnFiltersChange"; "hiddenKeys": "hiddenKeysChange"; "columnWidths": "columnWidthsChange"; "columnOrder": "columnOrderChange"; "pageSize": "pageSizeChange"; "page": "pageChange"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; }, ["cellTemplateDirectives"], ["[empty]", "[bulk-actions]"], true, never>;
1448
1865
  }
1449
1866
 
1450
1867
  declare class PaginationComponent {
@@ -1476,6 +1893,81 @@ declare class PaginationComponent {
1476
1893
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<PaginationComponent, "ds-pagination", never, { "total": { "alias": "total"; "required": true; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "currentPage": { "alias": "currentPage"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; }, { "pageSize": "pageSizeChange"; "currentPage": "currentPageChange"; }, never, never, true, never>;
1477
1894
  }
1478
1895
 
1896
+ /**
1897
+ * One password requirement. The consumer owns the POLICY — `test` must mirror
1898
+ * whatever their server enforces — and the DS owns only how the row reads.
1899
+ */
1900
+ interface DsPasswordRule {
1901
+ /** Row text, e.g. "At least 8 characters". */
1902
+ readonly label: string;
1903
+ /** Whether the current value satisfies this rule. */
1904
+ readonly test: (value: string) => boolean;
1905
+ }
1906
+ /** Per-row state, exposed so a consumer can style or test against it. */
1907
+ type DsPasswordRuleState = 'pending' | 'met' | 'failed';
1908
+
1909
+ interface RuleRow {
1910
+ readonly label: string;
1911
+ readonly state: DsPasswordRuleState;
1912
+ readonly icon: IconName;
1913
+ readonly announced: string;
1914
+ }
1915
+ /**
1916
+ * Passes when every rule does. Exported separately so a form can gate its submit
1917
+ * from a validator without reaching for the component instance.
1918
+ */
1919
+ declare function passwordRulesMet(value: string, rules: readonly DsPasswordRule[]): boolean;
1920
+ /**
1921
+ * Live checklist under a "new password" field.
1922
+ *
1923
+ * The consumer keeps the POLICY — each rule carries its own `test`, which has to
1924
+ * mirror the server, or the checklist is a lie — and this owns the rendering: the
1925
+ * tri-state glyph, the met and failed colours, the type scale. One consumer had
1926
+ * written it twice and the copies had already drifted (different labels for the
1927
+ * same rule, a different order, different state classes), which is why it is here.
1928
+ *
1929
+ * ```html
1930
+ * <ds-input
1931
+ * type="password"
1932
+ * [attr.aria-describedby]="rules.listId"
1933
+ * [(value)]="password"
1934
+ * />
1935
+ * <ds-password-rules
1936
+ * #rules
1937
+ * [value]="password()"
1938
+ * [rules]="passwordRules"
1939
+ * [showUnmet]="submitted()"
1940
+ * />
1941
+ * ```
1942
+ */
1943
+ declare class PasswordRulesComponent {
1944
+ /** The password being typed. */
1945
+ readonly value: _angular_core.InputSignal<string>;
1946
+ /** The rule set, in the order it should read. */
1947
+ readonly rules: _angular_core.InputSignal<readonly DsPasswordRule[]>;
1948
+ /**
1949
+ * Whether an unmet rule may read as FAILED. Bind it to "the user has tried to
1950
+ * submit": before that an unmet rule is merely pending, because marking a
1951
+ * half-typed password with errors scolds someone who is still typing.
1952
+ */
1953
+ readonly showUnmet: _angular_core.InputSignalWithTransform<boolean, unknown>;
1954
+ /** Lay the rows out in two columns — for a checklist beside a wide form. */
1955
+ readonly columns: _angular_core.InputSignal<1 | 2>;
1956
+ /**
1957
+ * Id put on the rule list, for the field's `aria-describedby`. Defaults to a
1958
+ * generated one; set it explicitly and both sides can name the same string,
1959
+ * which avoids threading a template ref between two siblings.
1960
+ */
1961
+ readonly listId: _angular_core.InputSignal<string>;
1962
+ protected readonly rows: _angular_core.Signal<readonly RuleRow[]>;
1963
+ /** How many rules pass — for a host that wants to gate its own submit. */
1964
+ readonly metCount: _angular_core.Signal<number>;
1965
+ /** True when every rule passes. */
1966
+ readonly allMet: _angular_core.Signal<boolean>;
1967
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<PasswordRulesComponent, never>;
1968
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<PasswordRulesComponent, "ds-password-rules", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "rules": { "alias": "rules"; "required": false; "isSignal": true; }; "showUnmet": { "alias": "showUnmet"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "listId": { "alias": "listId"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
1969
+ }
1970
+
1479
1971
  interface DateFormatSpec {
1480
1972
  order: ('D' | 'M' | 'Y')[];
1481
1973
  separator: string;
@@ -1549,6 +2041,19 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1549
2041
  readonly label: _angular_core.InputSignal<string>;
1550
2042
  /** Helper text shown below the field. */
1551
2043
  readonly hint: _angular_core.InputSignal<string>;
2044
+ /** Error text. Shown immediately — binding it says the consumer has already
2045
+ * decided this field is in error. Takes precedence over `errors` and over the
2046
+ * picker's own "enter a valid date" message. */
2047
+ readonly error: _angular_core.InputSignal<string>;
2048
+ /** Advisory text, shown when there is no error. */
2049
+ readonly warning: _angular_core.InputSignal<string>;
2050
+ /** Validation errors, shown once the user has interacted. Bound automatically
2051
+ * by signal forms; reactive and template-driven forms are read through
2052
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
2053
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
2054
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
2055
+ * `errors`, so a `required` error does not greet an untouched form. */
2056
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1552
2057
  /** Reserve the message-row height even when empty, so the field doesn't shift
1553
2058
  * the layout below it when a hint/error appears. Falls back to
1554
2059
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -1591,9 +2096,11 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1591
2096
  readonly allowInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
1592
2097
  protected readonly isDisabled: _angular_core.Signal<boolean>;
1593
2098
  protected readonly hintId: _angular_core.Signal<string | null>;
1594
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
1595
- /** Field-message text: a validation message when typing is invalid, else the hint. */
1596
- protected readonly messageText: _angular_core.Signal<string>;
2099
+ private readonly localError;
2100
+ private readonly dateInvalid;
2101
+ private readonly fieldMessage;
2102
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
2103
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
1597
2104
  protected readonly resolvedLocale: _angular_core.Signal<string>;
1598
2105
  protected readonly resolvedFirstDay: _angular_core.Signal<number>;
1599
2106
  protected readonly formatSpec: _angular_core.Signal<DateFormatSpec>;
@@ -1673,7 +2180,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1673
2180
  protected readonly weeksGrid: _angular_core.Signal<DayCell[][]>;
1674
2181
  private getRangeContext;
1675
2182
  protected open(moveFocusToGrid?: boolean): void;
1676
- protected close(): void;
2183
+ protected close(cause?: DsOverlayCloseCause): void;
1677
2184
  ngOnDestroy(): void;
1678
2185
  protected onFieldClick(): void;
1679
2186
  private mobileEdit;
@@ -1722,7 +2229,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1722
2229
  protected isPresetDisabled(preset: DatePickerPreset): boolean;
1723
2230
  protected applyPreset(preset: DatePickerPreset): void;
1724
2231
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DatePickerComponent, never>;
1725
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "ds-date-picker", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "minYear": { "alias": "minYear"; "required": false; "isSignal": true; }; "maxYear": { "alias": "maxYear"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "disabledDate": { "alias": "disabledDate"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "defaultDate": { "alias": "defaultDate"; "required": false; "isSignal": true; }; "allowInput": { "alias": "allowInput"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
2232
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "ds-date-picker", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "minYear": { "alias": "minYear"; "required": false; "isSignal": true; }; "maxYear": { "alias": "maxYear"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "disabledDate": { "alias": "disabledDate"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "defaultDate": { "alias": "defaultDate"; "required": false; "isSignal": true; }; "allowInput": { "alias": "allowInput"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
1726
2233
  }
1727
2234
 
1728
2235
  type TimePickerMode = 'single' | 'range';
@@ -1831,6 +2338,18 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1831
2338
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1832
2339
  /** Helper text shown below the picker. */
1833
2340
  readonly hint: _angular_core.InputSignal<string>;
2341
+ /** Error text. Shown immediately — binding it says the consumer has already
2342
+ * decided this field is in error. Takes precedence over `errors`. */
2343
+ readonly error: _angular_core.InputSignal<string>;
2344
+ /** Advisory text, shown when there is no error. */
2345
+ readonly warning: _angular_core.InputSignal<string>;
2346
+ /** Validation errors, shown once the user has interacted. Bound automatically
2347
+ * by signal forms; reactive and template-driven forms are read through
2348
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
2349
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
2350
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
2351
+ * `errors`, so a `required` error does not greet an untouched form. */
2352
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1834
2353
  /** Reserve the message-row height even when empty, so the field doesn't shift
1835
2354
  * the layout below it when a hint/error appears. Falls back to
1836
2355
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -1856,7 +2375,9 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1856
2375
  protected readonly columns: _angular_core.Signal<TimeColumnsComponent | undefined>;
1857
2376
  protected readonly isDisabled: _angular_core.Signal<boolean>;
1858
2377
  protected readonly hintId: _angular_core.Signal<string | null>;
1859
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
2378
+ private readonly fieldMessage;
2379
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
2380
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
1860
2381
  protected readonly resolvedFormat: _angular_core.Signal<TimeFormat>;
1861
2382
  protected readonly singleValue: _angular_core.Signal<string | null>;
1862
2383
  protected readonly rangeValue: _angular_core.Signal<TimeRangeValue>;
@@ -1872,9 +2393,9 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1872
2393
  protected formatFor(value: string | null): string;
1873
2394
  protected open(segment: Segment): void;
1874
2395
  protected onTriggerClick(segment: Segment): void;
1875
- protected close(): void;
2396
+ protected close(cause?: DsOverlayCloseCause): void;
1876
2397
  ngOnDestroy(): void;
1877
- protected onEscape(): void;
2398
+ protected onEscape(cause?: DsOverlayCloseCause): void;
1878
2399
  protected onPick(next: string): void;
1879
2400
  protected setNow(): void;
1880
2401
  protected clear(event: Event): void;
@@ -1882,7 +2403,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1882
2403
  private minutesOf;
1883
2404
  private laterOf;
1884
2405
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TimePickerComponent, never>;
1885
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimePickerComponent, "ds-time-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "disabledTime": { "alias": "disabledTime"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
2406
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimePickerComponent, "ds-time-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "disabledTime": { "alias": "disabledTime"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
1886
2407
  }
1887
2408
 
1888
2409
  interface BreadcrumbItem {
@@ -1930,22 +2451,6 @@ declare class BreadcrumbsService {
1930
2451
  static ɵprov: _angular_core.ɵɵInjectableDeclaration<BreadcrumbsService>;
1931
2452
  }
1932
2453
 
1933
- /**
1934
- * Marks projected wordmark markup for `ds-sidenav`: when present, the sidenav
1935
- * renders the projected content inside `.brand-name` instead of the plain
1936
- * `brand` text (two-tone wordmarks, inline logos etc. stay consumer-side).
1937
- *
1938
- * Interplay: projecting `[dsBrandName]` is enough to render the brand row and
1939
- * its wordmark even without a string `brand`, but it only supplies the
1940
- * wordmark — the letter-mark tile still comes from `logoLetter` (or the first
1941
- * letter of `brand`), so an empty `brand` + projection renders the wordmark
1942
- * with no tile.
1943
- */
1944
- declare class BrandNameDirective {
1945
- static ɵfac: _angular_core.ɵɵFactoryDeclaration<BrandNameDirective, never>;
1946
- static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BrandNameDirective, "[dsBrandName]", never, {}, {}, never, never, true, never>;
1947
- }
1948
-
1949
2454
  /** Contract that ds-sidenav-item reads from its parent ds-sidenav. */
1950
2455
  interface SidenavContract {
1951
2456
  readonly collapsed: () => boolean;
@@ -2228,7 +2733,7 @@ declare class BannerComponent {
2228
2733
  /** Tighter padding, centred items, single-line title. */
2229
2734
  readonly compact: _angular_core.InputSignalWithTransform<boolean, unknown>;
2230
2735
  /** `'stacked'` wraps actions onto their own line; `'row'` keeps them inline. */
2231
- readonly layout: _angular_core.InputSignal<"stacked" | "row">;
2736
+ readonly layout: _angular_core.InputSignal<"row" | "stacked">;
2232
2737
  /** Coloured accent rail on the leading edge; set false to hide it. */
2233
2738
  readonly accentRail: _angular_core.InputSignalWithTransform<boolean, unknown>;
2234
2739
  /** Fires when the user dismisses the banner. */
@@ -2564,7 +3069,7 @@ declare class PopoverComponent implements OnDestroy, DsOverlayCloseRef {
2564
3069
  /** Resolved placement after the overlay positions — drives the arrow direction. */
2565
3070
  readonly resolvedPlacement: _angular_core.WritableSignal<PopoverPlacement>;
2566
3071
  toggle(trigger: HTMLElement): void;
2567
- close(): void;
3072
+ close(cause?: DsOverlayCloseCause): void;
2568
3073
  ngOnDestroy(): void;
2569
3074
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverComponent, never>;
2570
3075
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<PopoverComponent, "ds-popover", never, { "align": { "alias": "align"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "arrow": { "alias": "arrow"; "required": false; "isSignal": true; }; "panelRole": { "alias": "panelRole"; "required": false; "isSignal": true; }; "panelLabel": { "alias": "panelLabel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
@@ -2852,6 +3357,18 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2852
3357
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2853
3358
  /** Helper text shown below the field. */
2854
3359
  readonly hint: _angular_core.InputSignal<string>;
3360
+ /** Error text. Shown immediately — binding it says the consumer has already
3361
+ * decided this field is in error. Takes precedence over `errors`. */
3362
+ readonly error: _angular_core.InputSignal<string>;
3363
+ /** Advisory text, shown when there is no error. */
3364
+ readonly warning: _angular_core.InputSignal<string>;
3365
+ /** Validation errors, shown once the user has interacted. Bound automatically
3366
+ * by signal forms; reactive and template-driven forms are read through
3367
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
3368
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
3369
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
3370
+ * `errors`, so a `required` error does not greet an untouched form. */
3371
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
2855
3372
  /** Reserve the message-row height even when empty, so the field doesn't shift
2856
3373
  * the layout below it when a hint/error appears. Falls back to
2857
3374
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -2860,13 +3377,15 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2860
3377
  protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
2861
3378
  /** Shows a "Create «text»" row when the typed text matches no option. */
2862
3379
  readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
2863
- /** Accessible name for the combobox input. */
3380
+ /** Accessible name for the input. */
2864
3381
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2865
3382
  /** Fires with the typed text when the user picks the create-new option. */
2866
3383
  readonly create: _angular_core.OutputEmitterRef<string>;
2867
3384
  protected readonly isDisabled: _angular_core.Signal<boolean>;
2868
3385
  protected readonly hintId: _angular_core.Signal<string | null>;
2869
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
3386
+ private readonly fieldMessage;
3387
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
3388
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
2870
3389
  protected readonly query: _angular_core.WritableSignal<string>;
2871
3390
  protected readonly isOpen: _angular_core.WritableSignal<boolean>;
2872
3391
  protected readonly activeIndex: _angular_core.WritableSignal<number>;
@@ -2898,14 +3417,14 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2898
3417
  protected togglePanel(event: MouseEvent): void;
2899
3418
  protected onKeydown(event: KeyboardEvent): void;
2900
3419
  protected openPanel(): void;
2901
- protected close(): void;
3420
+ protected close(cause?: DsOverlayCloseCause): void;
2902
3421
  ngOnDestroy(): void;
2903
3422
  protected onFilter(event: Event): void;
2904
3423
  protected onPick(option: AutocompleteOption<T>): void;
2905
3424
  protected onCreateNew(): void;
2906
3425
  protected remove(target: T): void;
2907
3426
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent<any>, never>;
2908
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionGroups": { "alias": "optionGroups"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "create": "create"; }, never, never, true, never>;
3427
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionGroups": { "alias": "optionGroups"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "create": "create"; }, never, never, true, never>;
2909
3428
  }
2910
3429
 
2911
3430
  type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
@@ -3092,6 +3611,18 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
3092
3611
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3093
3612
  /** Helper text shown below the cells. */
3094
3613
  readonly hint: _angular_core.InputSignal<string>;
3614
+ /** Error text. Shown immediately — binding it says the consumer has already
3615
+ * decided this field is in error. Takes precedence over `errors`. */
3616
+ readonly error: _angular_core.InputSignal<string>;
3617
+ /** Advisory text, shown when there is no error. */
3618
+ readonly warning: _angular_core.InputSignal<string>;
3619
+ /** Validation errors, shown once the user has interacted. Bound automatically
3620
+ * by signal forms; reactive and template-driven forms are read through
3621
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
3622
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
3623
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
3624
+ * `errors`, so a `required` error does not greet an untouched form. */
3625
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3095
3626
  /** Reserve the message-row height even when empty, so the field doesn't shift
3096
3627
  * the layout below it when a hint/error appears. Falls back to
3097
3628
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -3106,7 +3637,9 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
3106
3637
  private wasComplete;
3107
3638
  protected readonly uid: string;
3108
3639
  protected readonly hintId: _angular_core.Signal<string | null>;
3109
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
3640
+ private readonly fieldMessage;
3641
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
3642
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3110
3643
  protected readonly isDisabled: _angular_core.Signal<boolean>;
3111
3644
  protected readonly cells: _angular_core.Signal<string[]>;
3112
3645
  protected onInput(event: Event, index: number): void;
@@ -3122,7 +3655,7 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
3122
3655
  private focusBox;
3123
3656
  private sanitize;
3124
3657
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<OtpInputComponent, never>;
3125
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<OtpInputComponent, "ds-otp-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "length": { "alias": "length"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "completed": "completed"; }, never, never, true, never>;
3658
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<OtpInputComponent, "ds-otp-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "length": { "alias": "length"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "completed": "completed"; }, never, never, true, never>;
3126
3659
  }
3127
3660
 
3128
3661
  type SliderValue = number | readonly [number, number];
@@ -3145,6 +3678,18 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
3145
3678
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3146
3679
  /** Helper text shown below the slider. */
3147
3680
  readonly hint: _angular_core.InputSignal<string>;
3681
+ /** Error text. Shown immediately — binding it says the consumer has already
3682
+ * decided this field is in error. Takes precedence over `errors`. */
3683
+ readonly error: _angular_core.InputSignal<string>;
3684
+ /** Advisory text, shown when there is no error. */
3685
+ readonly warning: _angular_core.InputSignal<string>;
3686
+ /** Validation errors, shown once the user has interacted. Bound automatically
3687
+ * by signal forms; reactive and template-driven forms are read through
3688
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
3689
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
3690
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
3691
+ * `errors`, so a `required` error does not greet an untouched form. */
3692
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3148
3693
  /** Reserve the message-row height even when empty, so the field doesn't shift
3149
3694
  * the layout below it when a hint/error appears. Falls back to
3150
3695
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -3155,7 +3700,9 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
3155
3700
  private dragging;
3156
3701
  protected readonly uid: string;
3157
3702
  protected readonly hintId: _angular_core.Signal<string | null>;
3158
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
3703
+ private readonly fieldMessage;
3704
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
3705
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3159
3706
  protected readonly isDisabled: _angular_core.Signal<boolean>;
3160
3707
  protected readonly thumbValues: _angular_core.Signal<number[]>;
3161
3708
  protected readonly fill: _angular_core.Signal<{
@@ -3176,7 +3723,7 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
3176
3723
  private setThumb;
3177
3724
  private snap;
3178
3725
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SliderComponent, never>;
3179
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SliderComponent, "ds-slider", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3726
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SliderComponent, "ds-slider", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3180
3727
  }
3181
3728
 
3182
3729
  declare class LoadingOverlayComponent {
@@ -3262,6 +3809,18 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
3262
3809
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3263
3810
  /** Helper text shown below the trigger. */
3264
3811
  readonly hint: _angular_core.InputSignal<string>;
3812
+ /** Error text. Shown immediately — binding it says the consumer has already
3813
+ * decided this field is in error. Takes precedence over `errors`. */
3814
+ readonly error: _angular_core.InputSignal<string>;
3815
+ /** Advisory text, shown when there is no error. */
3816
+ readonly warning: _angular_core.InputSignal<string>;
3817
+ /** Validation errors, shown once the user has interacted. Bound automatically
3818
+ * by signal forms; reactive and template-driven forms are read through
3819
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
3820
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
3821
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
3822
+ * `errors`, so a `required` error does not greet an untouched form. */
3823
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3265
3824
  /** Reserve the message-row height even when empty, so the field doesn't shift
3266
3825
  * the layout below it when a hint/error appears. Falls back to
3267
3826
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -3278,7 +3837,9 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
3278
3837
  ngOnDestroy(): void;
3279
3838
  protected readonly uid: string;
3280
3839
  protected readonly hintId: _angular_core.Signal<string | null>;
3281
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
3840
+ private readonly fieldMessage;
3841
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
3842
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3282
3843
  protected readonly isDisabled: _angular_core.Signal<boolean>;
3283
3844
  protected readonly displayHex: _angular_core.Signal<string>;
3284
3845
  protected readonly hueColor: _angular_core.Signal<string>;
@@ -3300,14 +3861,14 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
3300
3861
  protected onHuePointerUp(event: PointerEvent): void;
3301
3862
  protected onHueKeydown(event: KeyboardEvent): void;
3302
3863
  private openPanel;
3303
- close(): void;
3864
+ close(cause?: DsOverlayCloseCause): void;
3304
3865
  private setHsv;
3305
3866
  private commitHex;
3306
3867
  private updateSv;
3307
3868
  private updateHue;
3308
3869
  private clampPct;
3309
3870
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColorPickerComponent, never>;
3310
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColorPickerComponent, "ds-color-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3871
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColorPickerComponent, "ds-color-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3311
3872
  }
3312
3873
 
3313
3874
  interface MultiSelectOption {
@@ -3339,6 +3900,18 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
3339
3900
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3340
3901
  /** Helper text shown below the field. */
3341
3902
  readonly hint: _angular_core.InputSignal<string>;
3903
+ /** Error text. Shown immediately — binding it says the consumer has already
3904
+ * decided this field is in error. Takes precedence over `errors`. */
3905
+ readonly error: _angular_core.InputSignal<string>;
3906
+ /** Advisory text, shown when there is no error. */
3907
+ readonly warning: _angular_core.InputSignal<string>;
3908
+ /** Validation errors, shown once the user has interacted. Bound automatically
3909
+ * by signal forms; reactive and template-driven forms are read through
3910
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
3911
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
3912
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
3913
+ * `errors`, so a `required` error does not greet an untouched form. */
3914
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3342
3915
  /** Reserve the message-row height even when empty, so the field doesn't shift
3343
3916
  * the layout below it when a hint/error appears. Falls back to
3344
3917
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -3369,7 +3942,9 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
3369
3942
  protected readonly activeDescendant: _angular_core.Signal<string | null>;
3370
3943
  protected readonly resolvedAriaLabel: _angular_core.Signal<string>;
3371
3944
  protected readonly hintId: _angular_core.Signal<string | null>;
3372
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
3945
+ private readonly fieldMessage;
3946
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
3947
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3373
3948
  private enabledFiltered;
3374
3949
  protected readonly allFilteredSelected: _angular_core.Signal<boolean>;
3375
3950
  protected readonly someFilteredSelected: _angular_core.Signal<boolean>;
@@ -3382,10 +3957,10 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
3382
3957
  protected onSearchKeydown(event: KeyboardEvent): void;
3383
3958
  protected openPanel(): void;
3384
3959
  protected onTriggerClick(): void;
3385
- protected close(): void;
3960
+ protected close(cause?: DsOverlayCloseCause): void;
3386
3961
  private moveActive;
3387
3962
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
3388
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3963
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3389
3964
  }
3390
3965
 
3391
3966
  declare class SkeletonComponent {
@@ -3423,6 +3998,18 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
3423
3998
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3424
3999
  /** Helper text shown below the checkbox. */
3425
4000
  readonly hint: _angular_core.InputSignal<string>;
4001
+ /** Error text. Shown immediately — binding it says the consumer has already
4002
+ * decided this field is in error. Takes precedence over `errors`. */
4003
+ readonly error: _angular_core.InputSignal<string>;
4004
+ /** Advisory text, shown when there is no error. */
4005
+ readonly warning: _angular_core.InputSignal<string>;
4006
+ /** Validation errors, shown once the user has interacted. Bound automatically
4007
+ * by signal forms; reactive and template-driven forms are read through
4008
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4009
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4010
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
4011
+ * `errors`, so a `required` error does not greet an untouched form. */
4012
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3426
4013
  /** Reserve the message-row height even when empty, so the field doesn't shift
3427
4014
  * the layout below it when a hint/error appears. Falls back to
3428
4015
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -3440,12 +4027,13 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
3440
4027
  protected readonly uid: string;
3441
4028
  protected readonly controlId: _angular_core.Signal<string>;
3442
4029
  protected readonly hintId: _angular_core.Signal<string | null>;
3443
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
4030
+ private readonly fieldMessage;
4031
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4032
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3444
4033
  protected readonly fieldClass: _angular_core.Signal<string>;
3445
4034
  protected onCheckedChange(event: Event): void;
3446
- protected readonly devMode: boolean;
3447
4035
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<CheckboxComponent, never>;
3448
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxComponent, "ds-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
4036
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxComponent, "ds-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
3449
4037
  }
3450
4038
 
3451
4039
  declare class RadioComponent {
@@ -3464,6 +4052,18 @@ declare class RadioComponent {
3464
4052
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3465
4053
  /** Helper text shown below the control. */
3466
4054
  readonly hint: _angular_core.InputSignal<string>;
4055
+ /** Error text. Shown immediately — binding it says the consumer has already
4056
+ * decided this field is in error. Takes precedence over `errors`. */
4057
+ readonly error: _angular_core.InputSignal<string>;
4058
+ /** Advisory text, shown when there is no error. */
4059
+ readonly warning: _angular_core.InputSignal<string>;
4060
+ /** Validation errors, shown once the user has interacted. Bound automatically
4061
+ * by signal forms; reactive and template-driven forms are read through
4062
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4063
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4064
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
4065
+ * `errors`, so a `required` error does not greet an untouched form. */
4066
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3467
4067
  /** Reserve the message-row height even when empty, so the field doesn't shift
3468
4068
  * the layout below it when a hint/error appears. Falls back to
3469
4069
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -3480,7 +4080,9 @@ declare class RadioComponent {
3480
4080
  protected readonly uid: string;
3481
4081
  protected readonly controlId: _angular_core.Signal<string>;
3482
4082
  protected readonly hintId: _angular_core.Signal<string | null>;
3483
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
4083
+ private readonly fieldMessage;
4084
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4085
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3484
4086
  /** Injected via token to avoid circular import with RadioGroupComponent. */
3485
4087
  protected readonly group: _ids_group_ltd_ids_design_system.RadioGroupContract | null;
3486
4088
  readonly effectiveDisabled: _angular_core.Signal<boolean>;
@@ -3493,9 +4095,8 @@ declare class RadioComponent {
3493
4095
  /** Called by the group's keyboard handler to focus this radio's input. */
3494
4096
  focus(): void;
3495
4097
  protected onSelect(): void;
3496
- protected readonly devMode: boolean;
3497
4098
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<RadioComponent, never>;
3498
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioComponent, "ds-radio", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
4099
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioComponent, "ds-radio", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
3499
4100
  }
3500
4101
 
3501
4102
  /** Contract that ds-radio reads from its parent ds-radio-group, injected via
@@ -3527,6 +4128,18 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
3527
4128
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3528
4129
  /** Helper text shown below the group. */
3529
4130
  readonly hint: _angular_core.InputSignal<string>;
4131
+ /** Error text. Shown immediately — binding it says the consumer has already
4132
+ * decided this field is in error. Takes precedence over `errors`. */
4133
+ readonly error: _angular_core.InputSignal<string>;
4134
+ /** Advisory text, shown when there is no error. */
4135
+ readonly warning: _angular_core.InputSignal<string>;
4136
+ /** Validation errors, shown once the user has interacted. Bound automatically
4137
+ * by signal forms; reactive and template-driven forms are read through
4138
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4139
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4140
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
4141
+ * `errors`, so a `required` error does not greet an untouched form. */
4142
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3530
4143
  /** Reserve the message-row height even when empty, so the field doesn't shift
3531
4144
  * the layout below it when a hint/error appears. Falls back to
3532
4145
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -3541,14 +4154,16 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
3541
4154
  protected readonly uid: string;
3542
4155
  readonly groupName: _angular_core.Signal<string>;
3543
4156
  protected readonly hintId: _angular_core.Signal<string | null>;
3544
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
4157
+ private readonly fieldMessage;
4158
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4159
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3545
4160
  private readonly radios;
3546
4161
  private get enabledRadios();
3547
4162
  isTabbable(radio: RadioGroupChild): boolean;
3548
4163
  select(value: unknown): void;
3549
4164
  protected onKeydown(event: KeyboardEvent): void;
3550
4165
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<RadioGroupComponent, never>;
3551
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioGroupComponent, "ds-radio-group", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["radios"], ["*"], true, never>;
4166
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioGroupComponent, "ds-radio-group", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["radios"], ["*"], true, never>;
3552
4167
  }
3553
4168
 
3554
4169
  declare class SwitchComponent extends DsBooleanControlValueAccessor {
@@ -3566,6 +4181,18 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
3566
4181
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3567
4182
  /** Helper text shown below the switch. */
3568
4183
  readonly hint: _angular_core.InputSignal<string>;
4184
+ /** Error text. Shown immediately — binding it says the consumer has already
4185
+ * decided this field is in error. Takes precedence over `errors`. */
4186
+ readonly error: _angular_core.InputSignal<string>;
4187
+ /** Advisory text, shown when there is no error. */
4188
+ readonly warning: _angular_core.InputSignal<string>;
4189
+ /** Validation errors, shown once the user has interacted. Bound automatically
4190
+ * by signal forms; reactive and template-driven forms are read through
4191
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4192
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4193
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
4194
+ * `errors`, so a `required` error does not greet an untouched form. */
4195
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3569
4196
  /** Reserve the message-row height even when empty, so the field doesn't shift
3570
4197
  * the layout below it when a hint/error appears. Falls back to
3571
4198
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -3583,13 +4210,14 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
3583
4210
  protected readonly uid: string;
3584
4211
  protected readonly controlId: _angular_core.Signal<string>;
3585
4212
  protected readonly hintId: _angular_core.Signal<string | null>;
3586
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
4213
+ private readonly fieldMessage;
4214
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4215
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3587
4216
  protected readonly switchClasses: _angular_core.Signal<string>;
3588
4217
  protected readonly fieldClass: _angular_core.Signal<string>;
3589
4218
  protected onCheckedChange(event: Event): void;
3590
- protected readonly devMode: boolean;
3591
4219
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SwitchComponent, never>;
3592
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SwitchComponent, "ds-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
4220
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SwitchComponent, "ds-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
3593
4221
  }
3594
4222
 
3595
4223
  /**
@@ -3609,5 +4237,5 @@ declare class FieldClickFocusDirective {
3609
4237
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
3610
4238
  }
3611
4239
 
3612
- export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppLayoutComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BodyScrollLockService, BottomSheetComponent, BrandNameDirective, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_ICON_REGISTRY, DS_TOAST_CONFIG, DS_TOAST_POSITION, DS_TOAST_POSITION_DEFAULT, DatePickerComponent, DescriptionItemComponent, DescriptionListComponent, DividerComponent, DrawerComponent, DropzoneComponent, DsOverlayCloseRef, DsStaticPreview, EmptyStateComponent, FieldClickFocusDirective, ICONS, IconButtonComponent, IconComponent, InlineComponent, InputComponent, LayoutScrollService, ListComponent, ListItemComponent, LoadingOverlayComponent, MenuComponent, MenuDividerComponent, MenuItemComponent, ModalCardComponent, ModalComponent, ModalService, MultiSelectComponent, NumberStepperComponent, OtpInputComponent, PageFooterComponent, PageHeaderComponent, PaginationComponent, PopoverComponent, ProgressComponent, RADIO_GROUP, RadioComponent, RadioGroupComponent, ReserveMessagesDirective, SIDENAV, SearchComponent, SegmentedComponent, SelectComponent, SidenavComponent, SidenavFooterComponent, SidenavGroupComponent, SidenavItemComponent, SkeletonComponent, SliderComponent, SpinnerComponent, SplitButtonComponent, StackComponent, StatComponent, StatusDotComponent, StepperComponent, SwitchComponent, TabComponent, TableComponent, TabsComponent, TagComponent, TextareaComponent, TimePickerComponent, TimelineComponent, TimelineItemComponent, ToastComponent, ToastRegionComponent, ToastService, ToggleButtonComponent, TooltipDirective, TooltipPanelComponent, TopBarComponent, TreeComponent, W3wComponent, avatarTint, inheritDsConfig, initialsFrom, isSelectOptionGroup, provideDsConfig, provideDsIcons, provideDsTheme };
3613
- export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteOption, AutocompleteOptionGroup, AutocompleteWidth, AvatarSize, AvatarStatus, AvatarTintOptions, BannerVariant, BreadcrumbItem, ButtonColor, ButtonType, ButtonVariant, CardElevation, CardPadding, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerSpacing, DividerVariant, DrawerPlacement, DropzoneFile, DropzoneFileState, DsConfig, DsIconRegistry, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, EmptyStateVariant, IconButtonType, IconButtonVariant, IconName, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectOption, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, SidenavAlertItem, SidenavContract, SidenavItemModel, SidenavSearchProvider, SidenavSearchResult, SortChangeEvent, SortDir, SplitButtonItem, SplitButtonVariant, StepperLabelPosition, StepperOrientation, TableCellEditEvent, TableColumn, TableRowAction, TableRowActionEvent, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TimeFormat, TimePickerMode, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };
4240
+ export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppLayoutComponent, AuthShellComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BodyScrollLockService, BottomSheetComponent, BrandNameDirective, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_ICON_REGISTRY, DS_TOAST_CONFIG, DS_TOAST_POSITION, DS_TOAST_POSITION_DEFAULT, DatePickerComponent, DescriptionItemComponent, DescriptionListComponent, DividerComponent, DrawerComponent, DropzoneComponent, DsOverlayCloseRef, DsStaticPreview, EmptyStateComponent, FieldClickFocusDirective, FilterBarComponent, FilterItemDirective, ICONS, IconButtonComponent, IconComponent, InlineComponent, InputComponent, LayoutScrollService, ListComponent, ListItemComponent, LoadingOverlayComponent, MenuComponent, MenuDividerComponent, MenuItemComponent, ModalCardComponent, ModalComponent, ModalService, MultiSelectComponent, NumberStepperComponent, OtpInputComponent, PageFooterComponent, PageHeaderComponent, PaginationComponent, PasswordRulesComponent, PopoverComponent, ProgressComponent, RADIO_GROUP, RadioComponent, RadioGroupComponent, RailTriggerDirective, ReserveMessagesDirective, SIDENAV, SearchComponent, SegmentedComponent, SelectComponent, SidenavComponent, SidenavFooterComponent, SidenavGroupComponent, SidenavItemComponent, SkeletonComponent, SliderComponent, SpinnerComponent, SplitButtonComponent, StackComponent, StatComponent, StatusDotComponent, StepperComponent, SwitchComponent, TabComponent, TableComponent, TabsComponent, TagComponent, TextareaComponent, TimePickerComponent, TimelineComponent, TimelineItemComponent, ToastComponent, ToastRegionComponent, ToastService, ToggleButtonComponent, TooltipDirective, TooltipPanelComponent, TopBarComponent, TreeComponent, W3wComponent, avatarTint, inheritDsConfig, initialsFrom, isSelectOptionGroup, passwordRulesMet, provideDsConfig, provideDsIcons, provideDsTheme };
4241
+ export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteOption, AutocompleteOptionGroup, AutocompleteWidth, AvatarSize, AvatarStatus, AvatarTintOptions, BannerVariant, BreadcrumbItem, ButtonColor, ButtonType, ButtonVariant, CardElevation, CardPadding, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerSpacing, DividerVariant, DrawerPlacement, DropzoneFile, DropzoneFileState, DsConfig, DsIconRegistry, DsPasswordRule, DsPasswordRuleState, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, EmptyStateVariant, IconButtonType, IconButtonVariant, IconName, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectOption, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, SidenavAlertItem, SidenavContract, SidenavItemModel, SidenavSearchProvider, SidenavSearchResult, SortChangeEvent, SortDir, SplitButtonItem, SplitButtonVariant, StepperLabelPosition, StepperOrientation, TableCellEditEvent, TableColumn, TableRowAction, TableRowActionEvent, TableSortMode, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TimeFormat, TimePickerMode, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };