@ids-group-ltd/ids-design-system 0.7.1 → 0.9.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.
@@ -1,6 +1,7 @@
1
1
  import * as _angular_core from '@angular/core';
2
2
  import { InjectionToken, Provider, EnvironmentProviders, ElementRef, TemplateRef, ModelSignal, OnDestroy } from '@angular/core';
3
3
  import { SafeHtml } from '@angular/platform-browser';
4
+ import { Observable } from 'rxjs';
4
5
  import { ControlValueAccessor } from '@angular/forms';
5
6
  import { CdkDragDrop } from '@angular/cdk/drag-drop';
6
7
  import * as _ids_group_ltd_ids_design_system from '@ids-group-ltd/ids-design-system';
@@ -104,6 +105,12 @@ interface DsConfig {
104
105
  * EVERY field in the injector's subtree, which is rarely what a whole app
105
106
  * wants; prefer `dsReserveMessages` on the individual form that validates. */
106
107
  reserveMessage?: boolean;
108
+ /** Fallback text per validation-error kind, for errors whose validator did
109
+ * not carry a `message` — Angular's built-ins never do, so this is where
110
+ * `required`, `minlength`, `email` and friends get their wording. A message
111
+ * on the error itself always wins, so one shared map here plus a per-case
112
+ * override at the validator covers both. Unmapped kinds warn in dev. */
113
+ errorMessages?: Record<string, string>;
107
114
  };
108
115
  breadcrumbs?: {
109
116
  separator?: IconName;
@@ -310,6 +317,9 @@ type ButtonVariant = 'solid' | 'tonal' | 'ghost' | 'outline' | 'text';
310
317
  type ButtonType = 'button' | 'submit' | 'reset';
311
318
 
312
319
  declare class ButtonComponent {
320
+ /** Segment of a ds-field-group: the group owns the border, radius and focus
321
+ * ring, so .in-group strips this control back to its bare contents. */
322
+ protected readonly inGroup: boolean;
313
323
  /** Brand/status hue family. */
314
324
  readonly color: _angular_core.InputSignal<ButtonColor>;
315
325
  /** Fill pattern: solid | tonal | ghost | outline | text. All color×variant
@@ -343,6 +353,9 @@ declare class ButtonComponent {
343
353
  /** ARIA `aria-expanded`, forwarded to the inner <button> — bind to the
344
354
  * overlay's open state on a trigger button. */
345
355
  readonly ariaExpanded: _angular_core.InputSignal<boolean | null>;
356
+ /** ARIA `aria-controls`, forwarded to the inner <button> — the id of the panel
357
+ * this button opens, e.g. `ds-app-layout`'s `railId`. */
358
+ readonly ariaControls: _angular_core.InputSignal<string | null>;
346
359
  /** Fires on click, unless `disabled` or `loading`. */
347
360
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
348
361
  /** The inner native <button>, exposed so overlay triggers can position
@@ -353,7 +366,7 @@ declare class ButtonComponent {
353
366
  constructor();
354
367
  protected onClick(event: MouseEvent): void;
355
368
  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>;
369
+ 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
370
  }
358
371
 
359
372
  /** A single binary toggle button (pressed / not pressed) with an optional
@@ -398,13 +411,20 @@ declare class IconButtonComponent {
398
411
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
399
412
  /** Toggle state — renders the pressed/active look and sets aria-pressed. */
400
413
  readonly selected: _angular_core.InputSignalWithTransform<boolean, unknown>;
414
+ /** ARIA `aria-expanded`, forwarded to the inner `<button>` — bind to the open
415
+ * state when this button opens a panel. On the host element it would land on
416
+ * a non-focusable wrapper, which no screen reader reads. */
417
+ readonly ariaExpanded: _angular_core.InputSignal<boolean | null>;
418
+ /** ARIA `aria-controls`, forwarded to the inner `<button>` — the id of the
419
+ * panel this button opens, e.g. `ds-app-layout`'s `railId`. */
420
+ readonly ariaControls: _angular_core.InputSignal<string | null>;
401
421
  /** Fires on click, unless disabled. */
402
422
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
403
423
  protected readonly classes: _angular_core.Signal<string>;
404
424
  protected readonly iconSize: _angular_core.Signal<16 | 24 | 20>;
405
425
  protected onClick(event: MouseEvent): void;
406
426
  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>;
427
+ 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
428
  }
409
429
 
410
430
  declare class BadgeComponent {
@@ -436,6 +456,94 @@ declare class StatusDotComponent {
436
456
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<StatusDotComponent, "ds-status-dot", never, { "status": { "alias": "status"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
437
457
  }
438
458
 
459
+ /**
460
+ * When the layout resets the content scroll to the top.
461
+ *
462
+ * `'path'` (default) is today's behaviour: only when navigation lands on a
463
+ * different PATH, so a search, a sort or a page step on the same screen keeps
464
+ * the reader's place. `'always'` resets on every navigation, which is what a
465
+ * server-paged list usually wants — a new page should start at the top.
466
+ * `'never'` hands the decision back to the screen, which can still call
467
+ * `LayoutScrollService.scrollToTop()` itself.
468
+ */
469
+ type DsScrollReset = 'path' | 'never' | 'always';
470
+ /**
471
+ * Owns the layout's content scroller. In the fixed-frame layout the window never
472
+ * scrolls, so the router's built-in window-based scrolling no-ops — this service
473
+ * resets the registered container to the top when navigation lands on a different
474
+ * PATH instead. Provided by `ds-app-layout`, so routed pages can
475
+ * `inject(LayoutScrollService)` and call `scrollToTop()` manually (e.g. list pages
476
+ * that DO want the top after a filter change).
477
+ *
478
+ * With `restoreScroll` on the layout it also restores the reader's place. Only
479
+ * when ARMED, which is the whole design: going BACK to a list should return to
480
+ * where the reader was, while following a link into a new screen should not.
481
+ */
482
+ declare class LayoutScrollService {
483
+ private readonly navigation;
484
+ private readonly router;
485
+ private readonly destroyRef;
486
+ private readonly container;
487
+ /**
488
+ * The content scroller, once the layout has rendered it. Exposed so a host that
489
+ * must measure or drive the scroll itself — a scroll-spy, a virtualizer — can
490
+ * ask the layout for it instead of guessing the layout's internal markup with
491
+ * `document.querySelector`.
492
+ */
493
+ readonly scroller: _angular_core.Signal<Element | null>;
494
+ private restoreTimeoutMs;
495
+ private resetStrategy;
496
+ private armed;
497
+ private pendingOffset;
498
+ private endRestore;
499
+ private firstNavigation;
500
+ constructor();
501
+ /**
502
+ * Wiring, called by `ds-app-layout` once its content region exists. Public only
503
+ * because the component and the service sit in different files - a consumer has
504
+ * no reason to call it, and calling it points the service at the wrong element.
505
+ */
506
+ setScrollContainer(element: Element): void;
507
+ /** Wiring: `ds-app-layout` mirrors its `restoreScroll` inputs through here. */
508
+ configureRestore(timeoutMs: number | null): void;
509
+ /** Wiring: `ds-app-layout` mirrors its `scrollReset` input through here. */
510
+ configureReset(strategy: DsScrollReset): void;
511
+ scrollToTop(): void;
512
+ /**
513
+ * Scroll the content region to an absolute offset. Assigns `scrollTop` rather
514
+ * than calling `scrollTo`, so a themed `scroll-behavior: smooth` cannot turn a
515
+ * positioning jump into an animation.
516
+ */
517
+ scrollTo(top: number): void;
518
+ /**
519
+ * Take the offset this navigation is going to restore, and cancel the restore.
520
+ *
521
+ * For a host that renders its own scroll position — a virtualizer needs the
522
+ * offset BEFORE it decides which rows to build, so letting the service assign
523
+ * `scrollTop` afterwards would scroll a list that has not been built yet.
524
+ * Returns null when nothing is pending, which is every navigation that is not a
525
+ * back.
526
+ */
527
+ consumePendingOffset(): number | null;
528
+ /**
529
+ * Optional accelerator: tell the layout the content for this route is in the
530
+ * DOM. Without it the restore still lands — it waits for the container to grow
531
+ * and clamps at the deadline — but a host that knows when its data arrived can
532
+ * end the wait early instead of paying the growth watch.
533
+ */
534
+ contentReady(): void;
535
+ private onNavigationStart;
536
+ private onNavigationEnd;
537
+ private beginRestore;
538
+ private applyClamped;
539
+ private finishRestore;
540
+ private read;
541
+ private remember;
542
+ private recall;
543
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<LayoutScrollService, never>;
544
+ static ɵprov: _angular_core.ɵɵInjectableDeclaration<LayoutScrollService>;
545
+ }
546
+
439
547
  /**
440
548
  * Fixed-frame application layout: the host is pinned to the viewport
441
549
  * (`100dvh` + `overflow: hidden`) and ONLY the content region scrolls, so
@@ -479,42 +587,338 @@ declare class AppLayoutComponent {
479
587
  readonly railOpen: _angular_core.ModelSignal<boolean>;
480
588
  /** Accessible name for the rail while it is a modal overlay. */
481
589
  readonly railLabel: _angular_core.InputSignal<string>;
590
+ /**
591
+ * Remember the content scroll per path and restore it on the way BACK. Off by
592
+ * default: a layout that silently moved the scroll would surprise every existing
593
+ * consumer. Only a history traversal restores — following a link into a screen
594
+ * still lands at the top — plus a host that pushes its own "back to list" and
595
+ * says so with `state: { dsRestoreScroll: true }`, and the first navigation after
596
+ * a reload.
597
+ */
598
+ readonly restoreScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
599
+ /**
600
+ * How long to wait for the restored screen's content to grow tall enough before
601
+ * landing as close as it allows. Only meaningful with `restoreScroll`.
602
+ */
603
+ readonly restoreScrollTimeout: _angular_core.InputSignal<number>;
604
+ /**
605
+ * When the content scroll resets to the top. `'path'` (default) is what the
606
+ * layout has always done; `'always'` also resets on a query- or fragment-only
607
+ * navigation, which is what a server-paged list wants; `'never'` hands the
608
+ * decision to the screen, which can still call `LayoutScrollService.scrollToTop()`.
609
+ *
610
+ * It exists because the layout owning the scroll CONTAINER also meant it owned
611
+ * the POLICY: a screen could add a reset but had no way to suppress one.
612
+ */
613
+ readonly scrollReset: _angular_core.InputSignal<DsScrollReset>;
482
614
  /**
483
615
  * True only while the rail is an overlay. Gates the dialog semantics: above
484
616
  * the breakpoint the rail is an ordinary region, and a permanent
485
617
  * `role="dialog"` there would lie to a screen reader.
486
618
  */
487
619
  protected readonly compact: _angular_core.WritableSignal<boolean>;
620
+ /** Whether the rail is currently an overlay rather than part of the layout. */
621
+ readonly railOverlay: _angular_core.Signal<boolean>;
622
+ /** Id of the rail panel, for a trigger's `aria-controls`. */
623
+ readonly railId: string;
488
624
  private readonly layoutScroll;
489
625
  private readonly navigation;
490
626
  private readonly destroyRef;
491
627
  private readonly content;
492
628
  constructor();
629
+ /** Dismissal: Escape or the scrim. Restores focus, which navigation must not. */
493
630
  protected closeRail(): void;
494
631
  private watchDesktopBreakpoint;
495
632
  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>;
633
+ 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; }; "scrollReset": { "alias": "scrollReset"; "required": false; "isSignal": true; }; }, { "railOpen": "railOpenChange"; }, never, ["[sidenav]", "[topbar]", "*"], true, never>;
634
+ }
635
+
636
+ /**
637
+ * Wires a consumer's own burger to the layout's overlay rail: toggles
638
+ * `[(railOpen)]` on click and keeps `aria-expanded` / `aria-controls` in sync, so
639
+ * the trigger and the panel are related for a screen reader.
640
+ *
641
+ * ```html
642
+ * <ds-app-layout>
643
+ * <ds-topbar topbar>
644
+ * <button dsRailTrigger type="button" aria-label="Navigation">☰</button>
645
+ * </ds-topbar>
646
+ * </ds-app-layout>
647
+ * ```
648
+ *
649
+ * PUT IT ON THE FOCUSABLE CONTROL, not on a wrapper: the attributes go on the
650
+ * host element, and on `<ds-icon-button>` that is the wrapper, whose inner
651
+ * `<button>` is what a screen reader actually reads. With a DS button, skip this
652
+ * directive and bind its forwarding inputs instead —
653
+ * `[ariaExpanded]="layout.railOverlay() ? layout.railOpen() : null"` and
654
+ * `[ariaControls]="layout.railId"` off a `<ds-app-layout #layout>` template ref.
655
+ *
656
+ * Both attributes are dropped while the rail is NOT an overlay: above the
657
+ * breakpoint the rail is permanently in the layout, so `aria-expanded="false"`
658
+ * would state the opposite of what the user sees.
659
+ *
660
+ * Must sit inside a `ds-app-layout` — the injector walks the declaration tree, so
661
+ * anywhere in the projected chrome works. Outside one, DI fails naming
662
+ * `AppLayoutComponent`, which says what is missing.
663
+ */
664
+ declare class RailTriggerDirective {
665
+ protected readonly layout: AppLayoutComponent;
666
+ protected toggle(): void;
667
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<RailTriggerDirective, never>;
668
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RailTriggerDirective, "[dsRailTrigger]", never, {}, {}, never, never, true, never>;
497
669
  }
498
670
 
499
671
  /**
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.
672
+ * Emits the new path whenever navigation lands on a DIFFERENT one. A query- or
673
+ * fragment-only navigation is a search, sort or page step on the same screen, and
674
+ * everything that reacts to "went somewhere else" must agree on that — the scroll
675
+ * reset, the responsive rail, and now your own code — so they read one source
676
+ * instead of each deciding for itself.
677
+ *
678
+ * PUBLIC since 0.8.x, because consumers were re-deriving it and disagreeing: one
679
+ * consumer had three separate answers to "did the path change?" — route snapshots
680
+ * in a view-transition skip, this stream inside the layout, and a `split('?')`
681
+ * in a tab helper that ignored the fragment this one strips. Inject it and read
682
+ * `pathChanged` rather than writing a fourth:
683
+ *
684
+ * ```ts
685
+ * private readonly navigation = inject(LayoutNavigationService);
686
+ * constructor() {
687
+ * this.navigation.pathChanged
688
+ * .pipe(takeUntilDestroyed())
689
+ * .subscribe((path) => …);
690
+ * }
691
+ * ```
692
+ *
693
+ * A PATH change is not always a page change. An app whose URL mirrors the
694
+ * reader's position — a docs layout rewriting `/area/section` from a scroll spy,
695
+ * a wizard that names its step — changes the path while staying on the screen,
696
+ * and resetting the scroll there fights the user: the reset moves the scroll,
697
+ * the spy rewrites the path again, and the page ping-pongs. Such a navigation
698
+ * must carry `state: { dsSamePage: true }`, which is skipped here.
699
+ *
700
+ * Root-provided, which is also what makes it safe to expose: the stream is
701
+ * derived from the router and holds no state, so one instance serves every
702
+ * reader. `LayoutScrollService` depends on it, so a consumer providing THAT
703
+ * outside `ds-app-layout` needs this one resolvable too.
508
704
  */
509
- declare class LayoutScrollService {
510
- private readonly navigation;
511
- private readonly destroyRef;
512
- private scrollContainer;
705
+ declare class LayoutNavigationService {
706
+ private readonly router;
707
+ readonly pathChanged: Observable<string>;
708
+ private samePage;
709
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<LayoutNavigationService, never>;
710
+ static ɵprov: _angular_core.ɵɵInjectableDeclaration<LayoutNavigationService>;
711
+ }
712
+
713
+ type CardElevation = 'flat' | 'raised' | 'hover' | 'interactive';
714
+ type CardPadding = 'none' | 'sm' | 'md' | 'lg';
715
+
716
+ /**
717
+ * Marks projected wordmark markup for `ds-sidenav`: when present, the sidenav
718
+ * renders the projected content inside `.brand-name` instead of the plain
719
+ * `brand` text (two-tone wordmarks, inline logos etc. stay consumer-side).
720
+ *
721
+ * Interplay: projecting `[dsBrandName]` is enough to render the brand row and
722
+ * its wordmark even without a string `brand`, but it only supplies the
723
+ * wordmark — the letter-mark tile still comes from `logoLetter` (or the first
724
+ * letter of `brand`), so an empty `brand` + projection renders the wordmark
725
+ * with no tile.
726
+ */
727
+ declare class BrandNameDirective {
728
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<BrandNameDirective, never>;
729
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BrandNameDirective, "[dsBrandName]", never, {}, {}, never, never, true, never>;
730
+ }
731
+
732
+ /**
733
+ * Scaffold for the UNauthenticated screens — sign-in, forgot password, reset,
734
+ * MFA — and the counterpart to `ds-app-layout`, which only ever covers the
735
+ * screens behind the login.
736
+ *
737
+ * Brand row, tagline, card and support footer are the same four parts in every
738
+ * consumer that has hand-rolled this. What the ports get wrong is the full-height
739
+ * box: they nest a `100vh` wrapper inside a `100dvh` one and scroll a page whose
740
+ * content fits. Here the host is the only one, and it also carries the safe-area
741
+ * insets a notched phone in landscape needs.
742
+ *
743
+ * The brand row takes the same CONTRACT as `ds-sidenav` — a `brand` string gets a
744
+ * letter-mark tile plus wordmark, `logoLetter` overrides the glyph, `[dsBrandName]`
745
+ * projects a two-tone wordmark (import `BrandNameDirective` alongside this
746
+ * component, or the attribute is inert and the wordmark lands in the card), and
747
+ * `[brand]` projects a real logo. The two are not pixel-identical: the rail's tile
748
+ * is a fixed 28px at weight 800, this one 24-32px at 700, and each has its own
749
+ * `--ds-*-mark-*` hooks, so retinting the mark means setting both.
750
+ *
751
+ * Projecting into `[brand]` does NOT suppress the tile — leave `brand`/`logoLetter`
752
+ * unset when you supply a logo.
753
+ *
754
+ * ```html
755
+ * <ds-auth-layout brand="MyAdmin" logoLetter="A" tagline="Broker administration">
756
+ * <h1 class="title">Sign in</h1>
757
+ * <form class="form">…</form>
758
+ *
759
+ * <p dsAuthSupport>
760
+ * Need a hand? <a href="mailto:support@example.com">Contact support</a>
761
+ * </p>
762
+ * </ds-auth-layout>
763
+ * ```
764
+ */
765
+ declare class AuthLayoutComponent {
766
+ /** Wordmark beside the letter-mark tile. For a logo image/SVG, project it into
767
+ * the `[brand]` slot instead; for a two-tone wordmark use `[dsBrandName]`. */
768
+ readonly brand: _angular_core.InputSignal<string>;
769
+ /** Letter-mark glyph when it differs from the brand's first letter (e.g. an
770
+ * "A" tile beside the "MyAdmin" wordmark). Empty = first letter of `brand`. */
771
+ readonly logoLetter: _angular_core.InputSignal<string>;
772
+ /** One line under the wordmark naming the product or audience. */
773
+ readonly tagline: _angular_core.InputSignal<string>;
774
+ /** Card treatment. `flat` suits a screen that already sits on a tinted canvas. */
775
+ readonly cardElevation: _angular_core.InputSignal<CardElevation>;
776
+ /** Card padding, passed through to `ds-card`. `md` tightens a short form. */
777
+ readonly cardPadding: _angular_core.InputSignal<CardPadding>;
778
+ /** Announce the card as the page's `main` landmark. The card holds the whole
779
+ * content of an auth screen and `ds-card` renders an `<article>`, which is NOT
780
+ * a landmark, so by default a screen-reader user has nothing to jump to — set
781
+ * this to `'main'` on a standalone auth page. It is opt-in because the layout
782
+ * is also embedded inside pages that already own a `main` (this repo's own docs
783
+ * site nests it inside `ds-app-layout`), and two `main`s is its own violation.
784
+ * Defaulting it to `'main'` is the better end state and belongs in the next
785
+ * batch of default changes. */
786
+ readonly landmark: _angular_core.InputSignal<"main" | "none">;
787
+ /** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
788
+ protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
789
+ protected readonly hasBrandName: _angular_core.Signal<boolean>;
790
+ /** Spread, not `charAt(0)`: the latter indexes UTF-16 code UNITS, so a brand
791
+ * starting with an astral character (an emoji, a rarer CJK glyph) yields half
792
+ * a surrogate pair and paints as tofu. */
793
+ protected readonly markGlyph: _angular_core.Signal<string>;
794
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<AuthLayoutComponent, never>;
795
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AuthLayoutComponent, "ds-auth-layout", 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; }; "landmark": { "alias": "landmark"; "required": false; "isSignal": true; }; }, {}, ["brandNameRef"], ["[brand]", "[dsBrandName]", "*", "[dsAuthSupport]"], true, never>;
796
+ }
797
+
798
+ /**
799
+ * One filter inside `ds-filter-bar`, with the width it should occupy:
800
+ * `<ng-template [dsFilterItem]="220"> <ds-date-picker … /> </ng-template>`.
801
+ *
802
+ * A template rather than plain projection because the bar has to MOVE the filters
803
+ * that do not fit into its overflow panel, and projected DOM cannot be relocated
804
+ * — it renders where it was projected. The cost is that crossing the boundary
805
+ * destroys and re-creates the view, so a control's internal state (an open panel,
806
+ * focus) does not survive a resize that collapses it. Its VALUE does: that lives
807
+ * in the consumer's own signal or form control.
808
+ *
809
+ * The width is a contract, not a hint — the bar sizes the slot to exactly this
810
+ * and decides the split from it, so a control that would render wider is
811
+ * narrowed rather than allowed to break the row.
812
+ */
813
+ declare class FilterItemDirective {
814
+ readonly template: TemplateRef<unknown>;
815
+ /** Slot width in px. Bare `dsFilterItem` (or a non-positive value) means 180. */
816
+ readonly width: _angular_core.InputSignalWithTransform<number, unknown>;
817
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FilterItemDirective, never>;
818
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FilterItemDirective, "ng-template[dsFilterItem]", never, { "width": { "alias": "dsFilterItem"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
819
+ }
820
+
821
+ /**
822
+ * Priority+ filter row: renders as many filters as fit and collapses the rest
823
+ * into a "+N more" panel. Every admin list past three filters hits the same wall
824
+ * — the row wraps to a second line on a laptop, or the consumer hand-rolls this.
825
+ *
826
+ * The split is decided from each item's declared width plus one `ResizeObserver`
827
+ * on the row, never by measuring the filters themselves: they would have to be in
828
+ * the DOM to be measured, so anything that did not fit would flash before being
829
+ * taken away. `[dsFilterItem]` carries the width.
830
+ *
831
+ * Anything marked `dsFilterBarTrailing` — search, a Clear button — sits at the
832
+ * trailing edge and never collapses. Mark each control rather than wrapping them:
833
+ * the bar owns that row's gap and alignment, and a projected wrapper would be a
834
+ * plain block whose children stack. The trailing group is outside the measured
835
+ * row, so flexbox subtracts its width before the row is measured and the
836
+ * arithmetic needs no allowance for it.
837
+ *
838
+ * ```html
839
+ * <ds-filter-bar>
840
+ * <ng-template [dsFilterItem]="180">
841
+ * <ds-select label="Status" … />
842
+ * </ng-template>
843
+ * <ng-template [dsFilterItem]="220">
844
+ * <ds-date-picker label="Opened" … />
845
+ * </ng-template>
846
+ *
847
+ * <ds-search dsFilterBarTrailing … />
848
+ * <ds-button dsFilterBarTrailing variant="text">Clear</ds-button>
849
+ * </ds-filter-bar>
850
+ * ```
851
+ */
852
+ declare class FilterBarComponent {
853
+ /** Trailing word of the trigger, after the count: "+2 filters". */
854
+ readonly moreLabel: _angular_core.InputSignal<string>;
855
+ /** Accessible name of the overflow panel. */
856
+ readonly panelLabel: _angular_core.InputSignal<string>;
857
+ protected readonly devMode: boolean;
858
+ protected readonly items: _angular_core.Signal<readonly FilterItemDirective[]>;
859
+ private readonly row;
860
+ private readonly rowWidth;
861
+ private readonly gap;
862
+ protected readonly inlineCount: _angular_core.Signal<number>;
863
+ protected readonly inline: _angular_core.Signal<FilterItemDirective[]>;
864
+ /** The filters currently in the overflow panel. */
865
+ readonly collapsed: _angular_core.Signal<FilterItemDirective[]>;
513
866
  constructor();
514
- setScrollContainer(element: Element): void;
515
- scrollToTop(): void;
516
- static ɵfac: _angular_core.ɵɵFactoryDeclaration<LayoutScrollService, never>;
517
- static ɵprov: _angular_core.ɵɵInjectableDeclaration<LayoutScrollService>;
867
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FilterBarComponent, never>;
868
+ 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>;
869
+ }
870
+
871
+ /** What a grouped control can read off the group that encloses it. */
872
+ interface DsFieldGroupContext {
873
+ /** The group's size, so a segment matches its neighbours without being told. */
874
+ readonly size: () => DsSize;
875
+ }
876
+ /**
877
+ * Provided by `ds-field-group`, injected `{ optional: true }` by every control
878
+ * that can be a segment.
879
+ *
880
+ * DI rather than a `[grouped]` input on each child: the alternative is manual,
881
+ * and one segment where it was forgotten renders its own border and radius in
882
+ * the middle of a glued row — a broken control that still looks deliberate.
883
+ * Presence of the token IS the fact the child needs, and the consumer already
884
+ * declared it by wrapping them.
885
+ */
886
+ declare const DS_FIELD_GROUP: InjectionToken<DsFieldGroupContext>;
887
+
888
+ /**
889
+ * One bordered control out of several: `select + input`, `search + button`,
890
+ * `button + select`. The group owns the border, the radius, the focus ring and
891
+ * the divider between segments; the controls inside render "naked".
892
+ *
893
+ * Segments are the direct children. Each hugs its content by default; mark the
894
+ * one that should take the slack with `grow`:
895
+ *
896
+ * ```html
897
+ * <ds-field-group>
898
+ * <ds-select [options]="scopes" />
899
+ * <ds-input grow placeholder="Search…" />
900
+ * </ds-field-group>
901
+ * ```
902
+ *
903
+ * A control knows it is a segment by injecting `DS_FIELD_GROUP` — see the token
904
+ * for why that is DI and not an input. Grouped controls must not carry a `label`
905
+ * or a `hint`: their own message row would break the glued line, so it is
906
+ * suppressed and a group-level one is not built yet.
907
+ */
908
+ declare class FieldGroupComponent implements DsFieldGroupContext {
909
+ /** Segment height — the field family's scale, so a group lines up with a
910
+ * plain field beside it. */
911
+ readonly size: _angular_core.InputSignal<DsSize>;
912
+ /** Draws the error border on the whole group. A single segment cannot be
913
+ * invalid on its own: the border belongs to the group. */
914
+ readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
915
+ /** Dims the group. Disable the CONTROLS too — this is the chrome, not their
916
+ * interactivity. */
917
+ readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
918
+ /** Fills the container instead of hugging its segments. */
919
+ readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
920
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FieldGroupComponent, never>;
921
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FieldGroupComponent, "ds-field-group", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
518
922
  }
519
923
 
520
924
  type AvatarSize = 'xs' | DsSize;
@@ -596,9 +1000,6 @@ declare class AvatarGroupComponent {
596
1000
  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
1001
  }
598
1002
 
599
- type CardElevation = 'flat' | 'raised' | 'hover' | 'interactive';
600
- type CardPadding = 'none' | 'sm' | 'md' | 'lg';
601
-
602
1003
  declare class CardComponent {
603
1004
  /** Visual treatment; `interactive` makes the card clickable and emits `pressed`. */
604
1005
  readonly elevation: _angular_core.InputSignal<CardElevation>;
@@ -614,9 +1015,18 @@ declare class CardComponent {
614
1015
  }
615
1016
 
616
1017
  declare class StatComponent {
1018
+ constructor();
617
1019
  /** Metric name shown above the value. */
618
1020
  readonly label: _angular_core.InputSignal<string>;
619
- /** Headline metric; `unit` is appended directly after it. */
1021
+ /** Headline metric; `unit` is appended directly after it.
1022
+ *
1023
+ * Optional because the value can be PROJECTED instead — `[dsStatValue]`
1024
+ * takes a badge, a status dot, anything a tile needs where a number would go.
1025
+ * The input is the fallback, the same shape `[delta]` already has.
1026
+ *
1027
+ * Namespaced, unlike `[delta]`: twenty components in this library have a
1028
+ * `value` input, so a bare `value` attribute used to slot one of them in
1029
+ * would also set that input to the empty string. */
620
1030
  readonly value: _angular_core.InputSignal<string | number>;
621
1031
  /** Change amount; sign drives the up/down arrow and color. */
622
1032
  readonly delta: _angular_core.InputSignal<number | null>;
@@ -636,7 +1046,7 @@ declare class StatComponent {
636
1046
  protected readonly deltaIcon: _angular_core.Signal<"arrowUp" | "arrowDown" | null>;
637
1047
  protected readonly deltaText: _angular_core.Signal<string>;
638
1048
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<StatComponent, never>;
639
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<StatComponent, "ds-stat", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "delta": { "alias": "delta"; "required": false; "isSignal": true; }; "deltaLabel": { "alias": "deltaLabel"; "required": false; "isSignal": true; }; "deltaTone": { "alias": "deltaTone"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "unit": { "alias": "unit"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, ["[delta]"], true, never>;
1049
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<StatComponent, "ds-stat", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "delta": { "alias": "delta"; "required": false; "isSignal": true; }; "deltaLabel": { "alias": "deltaLabel"; "required": false; "isSignal": true; }; "deltaTone": { "alias": "deltaTone"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "unit": { "alias": "unit"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, ["[dsStatValue]", "[delta]"], true, never>;
640
1050
  }
641
1051
 
642
1052
  declare class TabComponent {
@@ -675,6 +1085,27 @@ declare class TabsComponent {
675
1085
  /** Controls whether the tab list and panel are stacked horizontally (default)
676
1086
  or the tab list runs vertically beside the panel. */
677
1087
  readonly orientation: _angular_core.InputSignal<TabsOrientation>;
1088
+ /**
1089
+ * Keep the active tab in a query parameter, so it survives F5, a shared link
1090
+ * and the Back button: `urlParam="tab"` gives `?tab=activity`. Empty (the
1091
+ * default) leaves the URL alone, and the strip works exactly as before.
1092
+ *
1093
+ * The names come from each `ds-tab`'s `value` (falling back to its `label`),
1094
+ * so there is no second list to keep in step. **Names, not indices** — writing
1095
+ * `?tab=1` would silently repoint every old link the moment a tab is inserted.
1096
+ * The FIRST tab writes no parameter and every write REPLACES the history
1097
+ * entry, so a pristine screen keeps a clean address and flipping tabs does not
1098
+ * fill the Back button.
1099
+ *
1100
+ * An unknown or missing name lands on the first tab rather than throwing: a
1101
+ * URL is user input, and a stale bookmark should still open the screen.
1102
+ *
1103
+ * Outside a routed context the input is inert. Nothing router-shaped is even
1104
+ * resolved until you set it — no DI lookup and, more to the point, no
1105
+ * subscription — so a strip that never uses this costs exactly what it did
1106
+ * before the input existed.
1107
+ */
1108
+ readonly urlParam: _angular_core.InputSignal<string>;
678
1109
  /** Emitted when a close button is clicked. Carries the tab's value input, or
679
1110
  its label when value is not set. The host is responsible for removing the
680
1111
  tab from its list. */
@@ -682,6 +1113,16 @@ declare class TabsComponent {
682
1113
  private readonly host;
683
1114
  private readonly uid;
684
1115
  protected readonly tabs: _angular_core.Signal<readonly TabComponent[]>;
1116
+ private readonly injector;
1117
+ private router;
1118
+ private route;
1119
+ private readonly urlParams;
1120
+ constructor();
1121
+ /** Resolves the router pair on first use. Null outside a routed context, which
1122
+ * makes `urlParam` inert there rather than an error. */
1123
+ private resolveRouting;
1124
+ private tabName;
1125
+ private writeUrl;
685
1126
  /** Tracks which tab indices have ever been activated (for lazy rendering). */
686
1127
  private readonly activatedIndices;
687
1128
  protected tabId(index: number): string;
@@ -697,7 +1138,33 @@ declare class TabsComponent {
697
1138
  Arrow axis follows orientation: Left/Right for horizontal, Up/Down for vertical. */
698
1139
  protected onKeydown(event: KeyboardEvent, index: number): void;
699
1140
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabsComponent, never>;
700
- 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>;
1141
+ 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; }; "urlParam": { "alias": "urlParam"; "required": false; "isSignal": true; }; }, { "selectedIndex": "selectedIndexChange"; "tabClosed": "tabClosed"; }, ["tabs"], never, true, never>;
1142
+ }
1143
+
1144
+ type FieldMessageState = 'default' | 'error' | 'warning' | 'success';
1145
+
1146
+ /**
1147
+ * One validation error, structurally identical to Angular's signal-forms
1148
+ * `ValidationError`.
1149
+ *
1150
+ * Declared here rather than imported from `@angular/forms/signals` on purpose:
1151
+ * that module is `@experimental`, and a public DS type must not carry a
1152
+ * dependency that can be renamed out from under consumers. Structural
1153
+ * compatibility is all the interop needs — signal forms binds by input NAME and
1154
+ * assigns its own `ValidationError[]`, which this shape accepts.
1155
+ */
1156
+ interface DsFieldError {
1157
+ /** Identifies the kind of error, e.g. `required`, `minlength`, `server`. */
1158
+ readonly kind: string;
1159
+ /** Human-readable text. Authored by the consumer, at the validator. */
1160
+ readonly message?: string;
1161
+ }
1162
+ /** What a field's `errors` input accepts before normalization. */
1163
+ type DsFieldErrorsInput = string | DsFieldError | readonly DsFieldError[] | null | undefined;
1164
+ /** The single line a field shows below itself, already resolved. */
1165
+ interface DsFieldMessage {
1166
+ readonly text: string;
1167
+ readonly state: FieldMessageState;
701
1168
  }
702
1169
 
703
1170
  /**
@@ -713,8 +1180,23 @@ declare class TabsComponent {
713
1180
  declare abstract class DsControlValueAccessor<T> implements ControlValueAccessor {
714
1181
  /** The component's two-way value model. */
715
1182
  abstract readonly value: ModelSignal<T>;
1183
+ /**
1184
+ * Hides the control. On the base so signal forms reaches every control at once.
1185
+ * Inline `display`, not the `hidden` attribute — each control sets its own
1186
+ * `:host` display, which the attribute's weaker UA rule would lose to.
1187
+ */
1188
+ readonly hidden: _angular_core.InputSignalWithTransform<boolean, unknown>;
1189
+ private readonly hostElement;
1190
+ /**
1191
+ * Signal forms calls this through `focusBoundControl()` — typically to reach
1192
+ * the first invalid field after a failed submit. Without it the default is to
1193
+ * focus the HOST, and a `<ds-*>` element is not focusable, so focus went
1194
+ * nowhere. A control with a more precise target overrides this.
1195
+ */
1196
+ focus(options?: FocusOptions): void;
716
1197
  /** Driven by the forms API via `setDisabledState`. */
717
1198
  protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
1199
+ protected readonly touchedSelf: _angular_core.WritableSignal<boolean>;
718
1200
  private onChange;
719
1201
  private onTouched;
720
1202
  private synced;
@@ -727,7 +1209,7 @@ declare abstract class DsControlValueAccessor<T> implements ControlValueAccessor
727
1209
  registerOnTouched(fn: () => void): void;
728
1210
  setDisabledState(isDisabled: boolean): void;
729
1211
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsControlValueAccessor<any>, never>;
730
- static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsControlValueAccessor<any>, never, never, {}, {}, never, never, true, never>;
1212
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsControlValueAccessor<any>, never, never, { "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
731
1213
  }
732
1214
  /**
733
1215
  * Shared `ControlValueAccessor` for DS boolean controls (checkbox, switch)
@@ -739,8 +1221,19 @@ declare abstract class DsControlValueAccessor<T> implements ControlValueAccessor
739
1221
  declare abstract class DsBooleanControlValueAccessor implements ControlValueAccessor {
740
1222
  /** The component's two-way checked model. */
741
1223
  abstract readonly checked: ModelSignal<boolean>;
1224
+ /** Hides the control — see the note on `DsControlValueAccessor.hidden`. */
1225
+ readonly hidden: _angular_core.InputSignalWithTransform<boolean, unknown>;
1226
+ private readonly hostElement;
1227
+ /**
1228
+ * Signal forms calls this through `focusBoundControl()` — typically to reach
1229
+ * the first invalid field after a failed submit. Without it the default is to
1230
+ * focus the HOST, and a `<ds-*>` element is not focusable, so focus went
1231
+ * nowhere. A control with a more precise target overrides this.
1232
+ */
1233
+ focus(options?: FocusOptions): void;
742
1234
  /** Driven by the forms API via `setDisabledState`. */
743
1235
  protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
1236
+ protected readonly touchedSelf: _angular_core.WritableSignal<boolean>;
744
1237
  private onChange;
745
1238
  private onTouched;
746
1239
  private synced;
@@ -753,15 +1246,16 @@ declare abstract class DsBooleanControlValueAccessor implements ControlValueAcce
753
1246
  registerOnTouched(fn: () => void): void;
754
1247
  setDisabledState(isDisabled: boolean): void;
755
1248
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsBooleanControlValueAccessor, never>;
756
- static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsBooleanControlValueAccessor, never, never, {}, {}, never, never, true, never>;
1249
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsBooleanControlValueAccessor, never, never, { "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
757
1250
  }
758
1251
 
759
- type FieldMessageState = 'default' | 'error' | 'success';
760
-
761
1252
  type InputType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search';
762
1253
 
763
1254
  declare class InputComponent extends DsControlValueAccessor<string> {
764
1255
  private readonly control;
1256
+ /** Segment of a ds-field-group: the group owns the border, radius and focus
1257
+ * ring, so .in-group strips this control back to its bare contents. */
1258
+ protected readonly inGroup: boolean;
765
1259
  /** Text value, two-way bound. */
766
1260
  readonly value: _angular_core.ModelSignal<string>;
767
1261
  /** Native input type — also affects the default clear button and password toggle. */
@@ -772,6 +1266,18 @@ declare class InputComponent extends DsControlValueAccessor<string> {
772
1266
  readonly label: _angular_core.InputSignal<string>;
773
1267
  /** Helper text shown below the field. */
774
1268
  readonly hint: _angular_core.InputSignal<string>;
1269
+ /** Error text. Shown immediately — binding it says the consumer has already
1270
+ * decided this field is in error. Takes precedence over `errors`. */
1271
+ readonly error: _angular_core.InputSignal<string>;
1272
+ /** Advisory text, shown when there is no error. */
1273
+ readonly warning: _angular_core.InputSignal<string>;
1274
+ /** Validation errors, shown once the user has interacted. Bound automatically
1275
+ * by signal forms; reactive and template-driven forms are read through
1276
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
1277
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
1278
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
1279
+ * `errors`, so a `required` error does not greet an untouched form. */
1280
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
775
1281
  /** Reserve the message-row height even when empty, so the field doesn't shift
776
1282
  * the layout below it when a hint/error appears. Falls back to
777
1283
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -784,6 +1290,12 @@ declare class InputComponent extends DsControlValueAccessor<string> {
784
1290
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
785
1291
  /** Prevents editing while still allowing focus and selection. */
786
1292
  readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
1293
+ /**
1294
+ * The contract spelling of `readOnly`, a second input because signal forms binds
1295
+ * by NAME — a `readonly()` rule was reaching nothing before this existed.
1296
+ */
1297
+ readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
1298
+ protected readonly isReadOnly: _angular_core.Signal<boolean>;
787
1299
  /** Applies error styling and marks the field `aria-invalid`. */
788
1300
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
789
1301
  /** Applies success styling to the field. */
@@ -801,9 +1313,9 @@ declare class InputComponent extends DsControlValueAccessor<string> {
801
1313
  /** Native `name` attribute. */
802
1314
  readonly name: _angular_core.InputSignal<string | null>;
803
1315
  /** Native `min` attribute — applies when `type="number"`. */
804
- readonly min: _angular_core.InputSignal<number | null>;
1316
+ readonly min: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
805
1317
  /** Native `max` attribute — applies when `type="number"`. */
806
- readonly max: _angular_core.InputSignal<number | null>;
1318
+ readonly max: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
807
1319
  /** Native `step` attribute — applies when `type="number"`. */
808
1320
  readonly step: _angular_core.InputSignal<number | null>;
809
1321
  /** Native autocomplete token (e.g. "email", "current-password"). */
@@ -813,9 +1325,18 @@ declare class InputComponent extends DsControlValueAccessor<string> {
813
1325
  /** Accessible name when no visible `label` is provided (falls back to the
814
1326
  * placeholder so the control is never unnamed). */
815
1327
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
1328
+ /** Extra element ids to describe the control with — a password-rule list, a
1329
+ * policy note. MERGED with the field's own message id rather than replacing
1330
+ * it, and it has to be an input because the attribute belongs on the inner
1331
+ * `<input>`: set on the host it lands on a wrapper no screen reader reads. */
1332
+ readonly ariaDescribedBy: _angular_core.InputSignal<string | null>;
816
1333
  /** Hard character cap — applies the native maxlength attribute and shows a
817
1334
  * live "{current}/{max}" counter below the field. */
818
- readonly maxLength: _angular_core.InputSignal<number | null>;
1335
+ readonly maxLength: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
1336
+ /** Native `minlength` attribute. */
1337
+ readonly minLength: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
1338
+ /** Native `pattern` attribute — signal forms sends the schema's RegExp list. */
1339
+ readonly pattern: _angular_core.InputSignalWithTransform<readonly RegExp[], string | readonly RegExp[] | undefined>;
819
1340
  /** Mobile keyboard hints — forwarded to the native input as attributes. */
820
1341
  readonly enterKeyHint: _angular_core.InputSignal<"search" | "next" | "enter" | "done" | "go" | "previous" | "send" | null>;
821
1342
  /** Native `inputmode` attribute — hints the on-screen keyboard layout. */
@@ -835,9 +1356,15 @@ declare class InputComponent extends DsControlValueAccessor<string> {
835
1356
  /** Whether the password is currently shown as plain text, two-way bound. */
836
1357
  readonly passwordVisible: _angular_core.ModelSignal<boolean>;
837
1358
  protected readonly canClear: _angular_core.Signal<boolean>;
1359
+ /** A native `pattern` takes ONE expression; the schema can carry several, so
1360
+ * they are ANDed with lookaheads rather than silently dropping all but one. */
1361
+ protected readonly patternAttribute: _angular_core.Signal<string | null>;
838
1362
  protected readonly uid: string;
839
1363
  protected readonly hintId: _angular_core.Signal<string | null>;
840
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
1364
+ protected readonly describedBy: _angular_core.Signal<string | null>;
1365
+ private readonly fieldMessage;
1366
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
1367
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
841
1368
  /** Only name via aria-label when there's no visible `<label for>`. */
842
1369
  protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
843
1370
  /** Effective disabled — own `disabled` input OR the reactive-forms state. */
@@ -853,16 +1380,16 @@ declare class InputComponent extends DsControlValueAccessor<string> {
853
1380
  focus(options?: FocusOptions): void;
854
1381
  protected clear(): void;
855
1382
  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>;
1383
+ 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; }; "readonlyBinding": { "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; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "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
1384
  }
858
1385
 
859
1386
  declare class NumberStepperComponent {
860
1387
  /** Current numeric value, two-way bound. */
861
1388
  readonly value: _angular_core.ModelSignal<number>;
862
1389
  /** Lower bound — the decrement button and typed input clamp to it. */
863
- readonly min: _angular_core.InputSignal<number>;
1390
+ readonly min: _angular_core.InputSignalWithTransform<number, number | undefined>;
864
1391
  /** Upper bound — the increment button and typed input clamp to it; unbounded when null. */
865
- readonly max: _angular_core.InputSignal<number | null>;
1392
+ readonly max: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
866
1393
  /** Amount added or subtracted per increment/decrement. */
867
1394
  readonly step: _angular_core.InputSignal<number>;
868
1395
  /** Control height — sm/md/lg. */
@@ -893,6 +1420,18 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
893
1420
  readonly label: _angular_core.InputSignal<string>;
894
1421
  /** Helper text shown below the field. */
895
1422
  readonly hint: _angular_core.InputSignal<string>;
1423
+ /** Error text. Shown immediately — binding it says the consumer has already
1424
+ * decided this field is in error. Takes precedence over `errors`. */
1425
+ readonly error: _angular_core.InputSignal<string>;
1426
+ /** Advisory text, shown when there is no error. */
1427
+ readonly warning: _angular_core.InputSignal<string>;
1428
+ /** Validation errors, shown once the user has interacted. Bound automatically
1429
+ * by signal forms; reactive and template-driven forms are read through
1430
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
1431
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
1432
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
1433
+ * `errors`, so a `required` error does not greet an untouched form. */
1434
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
896
1435
  /** Reserve the message-row height even when empty, so the field doesn't shift
897
1436
  * the layout below it when a hint/error appears. Falls back to
898
1437
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -905,6 +1444,12 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
905
1444
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
906
1445
  /** Prevents editing while still allowing focus and selection. */
907
1446
  readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
1447
+ /**
1448
+ * The contract spelling of `readOnly`, a second input because signal forms binds
1449
+ * by NAME — a `readonly()` rule was reaching nothing before this existed.
1450
+ */
1451
+ readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
1452
+ protected readonly isReadOnly: _angular_core.Signal<boolean>;
908
1453
  /** Applies error styling and marks the field `aria-invalid`. */
909
1454
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
910
1455
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
@@ -927,10 +1472,19 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
927
1472
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
928
1473
  /** Hard character cap — applies the native maxlength attribute and shows a
929
1474
  * live "{current}/{max}" counter below the field. */
930
- readonly maxLength: _angular_core.InputSignal<number | null>;
1475
+ readonly maxLength: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
1476
+ /** Native `minlength` attribute. */
1477
+ readonly minLength: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
1478
+ /** Native `pattern` attribute — signal forms sends the schema's RegExp list. */
1479
+ readonly pattern: _angular_core.InputSignalWithTransform<readonly RegExp[], string | readonly RegExp[] | undefined>;
1480
+ /** A native `pattern` takes ONE expression; the schema can carry several, so
1481
+ * they are ANDed with lookaheads rather than silently dropping all but one. */
1482
+ protected readonly patternAttribute: _angular_core.Signal<string | null>;
931
1483
  protected readonly uid: string;
932
1484
  protected readonly hintId: _angular_core.Signal<string | null>;
933
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
1485
+ private readonly fieldMessage;
1486
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
1487
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
934
1488
  protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
935
1489
  /** Effective disabled — own `disabled` input OR the reactive-forms state. */
936
1490
  protected readonly isDisabled: _angular_core.Signal<boolean>;
@@ -944,10 +1498,13 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
944
1498
  * deliberately, e.g. focusing the first invalid field on a failed submit. */
945
1499
  focus(options?: FocusOptions): void;
946
1500
  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>;
1501
+ 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; }; "readonlyBinding": { "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; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
948
1502
  }
949
1503
 
950
1504
  declare class SearchComponent {
1505
+ /** Segment of a ds-field-group: the group owns the border, radius and focus
1506
+ * ring, so .in-group strips this control back to its bare contents. */
1507
+ protected readonly inGroup: boolean;
951
1508
  /** Search text, two-way bound. */
952
1509
  readonly value: _angular_core.ModelSignal<string>;
953
1510
  /** Placeholder shown when empty. */
@@ -976,6 +1533,13 @@ declare class SearchComponent {
976
1533
  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
1534
  }
978
1535
 
1536
+ /**
1537
+ * Why a panel is closing. `'select'` is a deliberate action that produced a
1538
+ * result — an option chosen, a date picked, the trigger pressed again, Tab moving
1539
+ * on; `'dismiss'` is ambient — Escape, a press outside, the page scrolling away.
1540
+ */
1541
+ type DsOverlayCloseCause = 'select' | 'dismiss';
1542
+
979
1543
  /** Showcase-only: renders the component's open/overlay surface inline in normal
980
1544
  * flow instead of its real overlay mechanics (for static docs specimens).
981
1545
  * Not part of the production contract. */
@@ -1001,6 +1565,9 @@ declare function isSelectOptionGroup(item: SelectItem): item is SelectOptionGrou
1001
1565
 
1002
1566
  declare class SelectComponent extends DsControlValueAccessor<string> implements OnDestroy {
1003
1567
  private readonly overlay;
1568
+ /** Segment of a ds-field-group: the group owns the border, radius and focus
1569
+ * ring, so .in-group strips this control back to its bare contents. */
1570
+ protected readonly inGroup: boolean;
1004
1571
  private readonly vcr;
1005
1572
  private readonly host;
1006
1573
  protected readonly preview: DsStaticPreview;
@@ -1018,10 +1585,28 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1018
1585
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1019
1586
  /** Prevents opening the dropdown while still allowing focus. */
1020
1587
  readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
1588
+ /**
1589
+ * The contract spelling of `readOnly`, a second input because signal forms binds
1590
+ * by NAME — a `readonly()` rule was reaching nothing before this existed.
1591
+ */
1592
+ readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
1593
+ protected readonly isReadOnly: _angular_core.Signal<boolean>;
1021
1594
  /** Applies error styling and marks the trigger `aria-invalid`. */
1022
1595
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1023
1596
  /** Helper text shown below the trigger. */
1024
1597
  readonly hint: _angular_core.InputSignal<string>;
1598
+ /** Error text. Shown immediately — binding it says the consumer has already
1599
+ * decided this field is in error. Takes precedence over `errors`. */
1600
+ readonly error: _angular_core.InputSignal<string>;
1601
+ /** Advisory text, shown when there is no error. */
1602
+ readonly warning: _angular_core.InputSignal<string>;
1603
+ /** Validation errors, shown once the user has interacted. Bound automatically
1604
+ * by signal forms; reactive and template-driven forms are read through
1605
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
1606
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
1607
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
1608
+ * `errors`, so a `required` error does not greet an untouched form. */
1609
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1025
1610
  /** Reserve the message-row height even when empty, so the field doesn't shift
1026
1611
  * the layout below it when a hint/error appears. Falls back to
1027
1612
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -1042,7 +1627,9 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1042
1627
  protected readonly labelId: string;
1043
1628
  protected readonly listboxId: string;
1044
1629
  protected readonly hintId: _angular_core.Signal<string | null>;
1045
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
1630
+ private readonly fieldMessage;
1631
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
1632
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
1046
1633
  protected optionId(flatIndex: number): string;
1047
1634
  /** Active option for `aria-activedescendant` (combobox keeps DOM focus). */
1048
1635
  protected readonly activeDescendant: _angular_core.Signal<string | null>;
@@ -1068,7 +1655,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1068
1655
  protected flatIndexOf(opt: SelectOption): number;
1069
1656
  protected toggle(): void;
1070
1657
  protected openPanel(): void;
1071
- protected close(): void;
1658
+ protected close(cause?: DsOverlayCloseCause): void;
1072
1659
  ngOnDestroy(): void;
1073
1660
  protected pick(option: SelectOption, groupDisabled?: boolean): void;
1074
1661
  protected clearValue(event: MouseEvent): void;
@@ -1080,7 +1667,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1080
1667
  private firstEnabledIndex;
1081
1668
  private lastEnabledIndex;
1082
1669
  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: {}; }]>;
1670
+ 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; }; "readonlyBinding": { "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
1671
  }
1085
1672
 
1086
1673
  /**
@@ -1108,6 +1695,80 @@ declare class CellTemplateDirective {
1108
1695
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CellTemplateDirective, "[dsCellTemplate]", never, { "dsCellTemplate": { "alias": "dsCellTemplate"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
1109
1696
  }
1110
1697
 
1698
+ /** What a projected header filter is handed. */
1699
+ interface HeaderFilterContext {
1700
+ /** The column being filtered. */
1701
+ readonly $implicit: unknown;
1702
+ /** Alias for the column. */
1703
+ readonly column: unknown;
1704
+ /** Dismisses the popover — call it after applying, so the filter behaves like
1705
+ * the built-in checklist rather than staying open. */
1706
+ readonly close: () => void;
1707
+ }
1708
+ /**
1709
+ * Projects a custom filter into a `ds-table` header popover, for a criterion the
1710
+ * built-in checklist cannot express: a date range, a numeric threshold, an async
1711
+ * option list.
1712
+ *
1713
+ * ```html
1714
+ * <ds-table [data]="rows" [columns]="cols">
1715
+ * <ng-template
1716
+ * dsHeaderFilter="opened"
1717
+ * [active]="!!range()"
1718
+ * let-close="close"
1719
+ * >
1720
+ * <ds-date-picker mode="range" [(value)]="range" />
1721
+ * <ds-button size="sm" (pressed)="apply(); close()">Apply</ds-button>
1722
+ * </ng-template>
1723
+ * </ds-table>
1724
+ * ```
1725
+ *
1726
+ * The table still owns the header button, the popover and the active-filter
1727
+ * styling — only the panel's contents change. It cannot know whether YOUR
1728
+ * criterion is set, though, so `active` is how the highlight gets told; without
1729
+ * it a custom filter renders but the header never marks itself filtered.
1730
+ *
1731
+ * The column is typed `unknown` for the same reason `dsCellTemplate`'s row is:
1732
+ * Angular cannot propagate the parent table's row type into a projected
1733
+ * template. Narrow it with a typed helper on the host.
1734
+ */
1735
+ declare class HeaderFilterDirective {
1736
+ /** Key of the column this filter belongs to. */
1737
+ readonly dsHeaderFilter: _angular_core.InputSignal<string>;
1738
+ /** Whether YOUR criterion is currently set, which drives the header's
1739
+ * active-filter styling. */
1740
+ readonly active: _angular_core.InputSignal<boolean>;
1741
+ readonly template: TemplateRef<any>;
1742
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<HeaderFilterDirective, never>;
1743
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<HeaderFilterDirective, "ng-template[dsHeaderFilter]", never, { "dsHeaderFilter": { "alias": "dsHeaderFilter"; "required": true; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
1744
+ }
1745
+
1746
+ /**
1747
+ * Who sorts a `ds-table`.
1748
+ *
1749
+ * - `'server'` (default) — the table only emits `sortChange`; the host reorders.
1750
+ * - `'client'` — the table reorders `data()` itself, for a table holding every row.
1751
+ * - `'none'` — nothing sorts, and `sortable` columns render no affordance rather
1752
+ * than a control that does nothing.
1753
+ *
1754
+ * Replaces the boolean `clientSort`, which could not express `'none'`: a column
1755
+ * marked `sortable` on a table with no sorting drew a live-looking header that
1756
+ * did nothing, and no type or dev check could catch it.
1757
+ */
1758
+ /**
1759
+ * Who applies the header filters.
1760
+ *
1761
+ * `'server'` (the default when unset) means the host does it: the table tracks
1762
+ * `columnFilters` so a request can be driven from it, but runs no local pass —
1763
+ * on a paged table a local pass would filter what the server already filtered,
1764
+ * and paged is the normal case. `'client'` filters the rows in hand, for a table
1765
+ * that holds every one of them. `'none'` drops the affordance,
1766
+ * so a column left marked `filter: 'set'` renders no button rather than a
1767
+ * control that does nothing.
1768
+ */
1769
+ type TableFilterMode = 'client' | 'server' | 'none';
1770
+ type TableSortMode = 'client' | 'server' | 'none';
1771
+
1111
1772
  interface TableColumn<T = unknown> {
1112
1773
  key: string;
1113
1774
  label: string;
@@ -1130,7 +1791,7 @@ interface TableColumn<T = unknown> {
1130
1791
  align?: 'left' | 'right' | 'center';
1131
1792
  cell?: (row: T) => string;
1132
1793
  /** 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`
1794
+ * it, client sorting compares what the cell displays, so `$1.2M / $840K / $95K`
1134
1795
  * sorts by the leading character and `Oct 09, 2023 / Feb 27, 2024` sorts by
1135
1796
  * month NAME — the table looks sorted and is not. Return the underlying
1136
1797
  * number, `Date` or plain string; `null`/`undefined`/`''` counts as blank and
@@ -1219,6 +1880,17 @@ declare class TableComponent<T extends object> {
1219
1880
  * (unsorted); pass ['asc','desc'] to forbid the unsorted state (e.g.
1220
1881
  * server-paged lists). */
1221
1882
  readonly sortingOrder: _angular_core.InputSignal<SortDir[]>;
1883
+ /**
1884
+ * Wording for the sort announcement, so it can be translated. Receives the
1885
+ * column's label and the new direction; return an empty string to say nothing.
1886
+ */
1887
+ readonly sortAnnouncement: _angular_core.InputSignal<(label: string, dir: SortDir) => string>;
1888
+ /**
1889
+ * Wording for the row-range announcement, so it can be translated. Receives
1890
+ * the 1-based first and last row on screen and the total; return an empty
1891
+ * string to say nothing.
1892
+ */
1893
+ readonly rangeAnnouncement: _angular_core.InputSignal<(first: number, last: number, total: number) => string>;
1222
1894
  /** Number of shimmer rows rendered while `loading` is `'skeleton'`. */
1223
1895
  readonly skeletonRows: _angular_core.InputSignal<number>;
1224
1896
  /** Accessible name for the table (rendered as a visually-hidden caption).
@@ -1254,6 +1926,37 @@ declare class TableComponent<T extends object> {
1254
1926
  * order; the column panel owns it once the user reorders. Keys absent from
1255
1927
  * the list fall back to declaration order after the listed ones. */
1256
1928
  readonly columnOrder: _angular_core.ModelSignal<string[] | null>;
1929
+ /** Round-trip `columnOrder`, `columnWidths` and `hiddenKeys` through
1930
+ * `localStorage`, so a reader's column layout survives a reload. Needs
1931
+ * `storageKey` — without one there is nothing to key a screen by, and two
1932
+ * tables would overwrite each other. Off by default. */
1933
+ readonly persistLayout: _angular_core.InputSignalWithTransform<boolean, unknown>;
1934
+ /** Screen id the persisted layout is stored under. Pick something stable per
1935
+ * table, not per route instance. */
1936
+ readonly storageKey: _angular_core.InputSignal<string>;
1937
+ /** Render an export button above the table. Off by default; `exportCsv()`
1938
+ * stays available for a consumer's own button. */
1939
+ readonly exportButton: _angular_core.InputSignalWithTransform<boolean, unknown>;
1940
+ /** Filename the export button downloads as. */
1941
+ readonly exportFilename: _angular_core.InputSignal<string>;
1942
+ /**
1943
+ * Where the export button gets its data. A server-paged table only HAS the
1944
+ * current page, so exporting without this silently exports one page.
1945
+ *
1946
+ * Return ROWS and the table serializes them the same way it serializes its
1947
+ * own. Return a `Blob` (or a URL string) and the table just downloads it —
1948
+ * which is what you want when the backend already formatted the file with its
1949
+ * own number formats, its own columns, or a sheet the table never held.
1950
+ */
1951
+ readonly exportFetcher: _angular_core.InputSignal<(() => Promise<readonly T[] | Blob | string>) | null>;
1952
+ /** Fires when `exportFetcher` rejects. Without it a failed export is silent —
1953
+ * the button simply re-enables and no file arrives. */
1954
+ readonly exportFailed: _angular_core.OutputEmitterRef<unknown>;
1955
+ /** True while `exportFetcher` is in flight, so the button can disable itself. */
1956
+ protected readonly exporting: _angular_core.WritableSignal<boolean>;
1957
+ /** Announced in the table's live region while an export is running or after it
1958
+ * failed, so the button's own disabled state is not the only signal. */
1959
+ protected readonly exportStatus: _angular_core.WritableSignal<string>;
1257
1960
  /** Keeps the horizontal scrollbar reachable on tall tables: the scroll
1258
1961
  * container's native bar is hidden and a proxy stuck to the bottom of the
1259
1962
  * nearest scroll ancestor mirrors it both ways. Off by default. */
@@ -1264,6 +1967,11 @@ declare class TableComponent<T extends object> {
1264
1967
  readonly page: _angular_core.ModelSignal<number>;
1265
1968
  /** Selectable page-size choices shown in the pagination control. */
1266
1969
  readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
1970
+ /** Shows the page-size picker in the footer pager. Set false for a table whose
1971
+ * page size is fixed — the standalone `ds-pagination` has always taken this. */
1972
+ readonly showPageSize: _angular_core.InputSignalWithTransform<boolean, unknown>;
1973
+ /** Shows the "N of M" range label in the footer pager. */
1974
+ readonly showLabel: _angular_core.InputSignalWithTransform<boolean, unknown>;
1267
1975
  /** Server-side total row count. `null` (default) = client paging: the table
1268
1976
  * slices `data()` itself and the pager counts the rows in hand. When set, the
1269
1977
  * host has already sliced to one page — the pager uses this count and the
@@ -1272,14 +1980,61 @@ declare class TableComponent<T extends object> {
1272
1980
  /** Scroll the table into view on a page change (opt-in) — keeps a bottom
1273
1981
  * pager from leaving the viewport on the previous page's last rows. */
1274
1982
  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>;
1983
+ /** Who sorts — see `TableSortMode`. Unset resolves to `'server'`: the table
1984
+ * emits `(sortChange)` and reorders nothing, which is what a paged table
1985
+ * needs. Declare `'client'` when the table holds every row, or `'none'` to
1986
+ * drop the affordance entirely. */
1987
+ readonly sortMode: _angular_core.InputSignal<TableSortMode | null>;
1988
+ /** Who filters — see `TableFilterMode`. Unset resolves to `'server'`: the
1989
+ * table tracks the selection in `columnFilters` for the host to turn into a
1990
+ * request, and runs no local pass. Declare `'client'` when the table holds
1991
+ * every row and should filter them itself. */
1992
+ readonly filterMode: _angular_core.InputSignal<TableFilterMode | null>;
1993
+ /**
1994
+ * The full value domain per column key, for a header filter the table cannot
1995
+ * derive itself. Without it the checklist is built from the rows in hand,
1996
+ * which on a server-paged table offers only the values that happen to be on
1997
+ * the current page.
1998
+ */
1999
+ readonly columnFilterOptions: _angular_core.InputSignal<ReadonlyMap<string, readonly string[]>>;
2000
+ protected readonly filterModeResolved: _angular_core.Signal<TableFilterMode>;
2001
+ protected readonly sortModeResolved: _angular_core.Signal<TableSortMode>;
1278
2002
  /** Pin the first data column (and the select column) on horizontal scroll. */
1279
2003
  readonly stickyFirstColumn: _angular_core.InputSignalWithTransform<boolean, unknown>;
2004
+ /**
2005
+ * Render only the rows in view, padding the rest with two spacer rows. Opt-in,
2006
+ * and it needs `maxHeight` — without a bounded scroller there is no viewport to
2007
+ * window against, so nothing is virtualized (dev-warned).
2008
+ *
2009
+ * Every row must be the same height, which is `virtualRowSize`: the arithmetic
2010
+ * that decides what is in view has no other way to know where a row starts. So
2011
+ * virtual mode forces `table-layout: fixed` and single-line cells, and the
2012
+ * expansion panel is suppressed — a row that can grow breaks the maths.
2013
+ */
2014
+ readonly virtualScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
2015
+ /** Row height in px in virtual mode. Must match what the rows actually
2016
+ * measure, so it drives the CSS height rather than merely describing it. */
2017
+ readonly virtualRowSize: _angular_core.InputSignal<number>;
2018
+ /**
2019
+ * Fetch rows as they scroll into view instead of receiving them all.
2020
+ *
2021
+ * `data` becomes a SPARSE array `total` long: put each fetched row at its
2022
+ * absolute index and leave the rest empty. Every gap inside the window
2023
+ * renders a skeleton row, and `(lazyLoad)` asks for the range covering it.
2024
+ *
2025
+ * Needs `virtualScroll` — without a window there is nothing to load
2026
+ * lazily AGAINST — and `total`, which is what the scrollbar is sized from.
2027
+ */
2028
+ readonly lazy: _angular_core.InputSignalWithTransform<boolean, unknown>;
2029
+ /** The range now on screen that `data` has gaps in — fetch it and write the
2030
+ * rows back at their absolute indices. Re-emits only when the range moves. */
2031
+ readonly lazyLoad: _angular_core.OutputEmitterRef<{
2032
+ first: number;
2033
+ rows: number;
2034
+ }>;
1280
2035
  /** Fires with the row on click (or Enter/Space when `rowInteractive`). */
1281
2036
  readonly rowClicked: _angular_core.OutputEmitterRef<T>;
1282
- /** Fires whenever sort key/direction changes, regardless of `clientSort`. */
2037
+ /** Fires whenever sort key/direction changes, in every `sortMode` but `'none'`. */
1283
2038
  readonly sortChange: _angular_core.OutputEmitterRef<SortChangeEvent>;
1284
2039
  /** Row-action menu items rendered as a trailing kebab (⋮) column.
1285
2040
  * Empty (default) — no column. Menu clicks never trigger `rowClicked`. */
@@ -1345,17 +2100,31 @@ declare class TableComponent<T extends object> {
1345
2100
  /** The column whose filter menu is open — drives the distinct-value list. */
1346
2101
  protected readonly filterColumn: _angular_core.WritableSignal<TableColumn<T> | null>;
1347
2102
  protected readonly filterSearch: _angular_core.WritableSignal<string>;
2103
+ private readonly headerFilters;
2104
+ private readonly headerFilterByKey;
2105
+ /** The projected filter for a column, when the host supplied one. */
2106
+ protected headerFilterFor(col: TableColumn<T>): HeaderFilterDirective | undefined;
2107
+ /** A projected filter makes the column filterable on its own — the host does
2108
+ * not also have to mark it `filter: 'set'` to get the header button. */
1348
2109
  protected hasColumnFilter(col: TableColumn<T>): boolean;
1349
2110
  /** A column is "actively filtered" when at least one of its values is unchecked. */
1350
2111
  protected isColumnFiltered(col: TableColumn<T>): boolean;
1351
- private distinctValuesOf;
2112
+ /** The checklist's domain: what the host declared, else what is in hand. */
2113
+ private optionsFor;
1352
2114
  /** Distinct values of the open column, narrowed by the popover search box. */
1353
- protected readonly filterValues: _angular_core.Signal<string[]>;
2115
+ protected readonly filterValues: _angular_core.Signal<readonly string[]>;
1354
2116
  protected readonly filterSelectedCount: _angular_core.Signal<number>;
1355
2117
  protected isFilterValueChecked(value: string): boolean;
1356
2118
  protected onColumnFilterClick(col: TableColumn<T>, event: Event): void;
1357
2119
  protected onFilterSearch(event: Event): void;
1358
2120
  protected toggleFilterValue(value: string): void;
2121
+ /** Context handed to a projected header filter. Rebuilt per open, which is
2122
+ * cheap and keeps `close` bound to the popover that is actually showing. */
2123
+ protected headerFilterContext(col: TableColumn<T>): {
2124
+ $implicit: unknown;
2125
+ column: unknown;
2126
+ close: () => void;
2127
+ };
1359
2128
  protected clearColumnFilter(): void;
1360
2129
  private readonly injector;
1361
2130
  private readonly editInput;
@@ -1369,23 +2138,99 @@ declare class TableComponent<T extends object> {
1369
2138
  protected onEditInput(event: Event): void;
1370
2139
  protected commitEdit(row: T, col: TableColumn<T>): void;
1371
2140
  protected cancelEdit(): void;
2141
+ private static readonly RESIZE_STEP;
2142
+ private static readonly RESIZE_PAGE;
1372
2143
  private static readonly MIN_COLUMN_WIDTH;
1373
2144
  private resizeState;
1374
2145
  /** Resolved pixel width for a column: a drag override wins, else `column.width`. */
1375
2146
  protected columnWidth(col: TableColumn<T>): number | null;
1376
2147
  protected onResizeStart(col: TableColumn<T>, event: PointerEvent): void;
2148
+ /**
2149
+ * Freeze the columns at what they currently measure, once, before the first
2150
+ * drag moves anything.
2151
+ *
2152
+ * Without it only the dragged column has a width and the rest are still
2153
+ * auto-sized, so the browser redistributes the remainder across them and
2154
+ * columns the reader never touched visibly jump. Measuring first means the
2155
+ * drag changes one column and leaves the others where they were — the
2156
+ * auto-sized geometry is kept rather than lost at the first grab.
2157
+ *
2158
+ * Runs only while something is unmeasured, so a second drag is untouched, and
2159
+ * it reads the header row that is actually on screen rather than assuming a
2160
+ * column order.
2161
+ */
2162
+ private lockMeasuredWidths;
1377
2163
  protected onResizeMove(event: PointerEvent): void;
1378
2164
  protected onResizeEnd(): void;
2165
+ /** Current rendered width, for the keyboard path and the handle's
2166
+ * `aria-valuenow`. Falls back to the DOM when the column was auto-sized and
2167
+ * has neither an override nor a declared width. */
2168
+ protected resolvedColumnWidth(col: TableColumn<T>, from?: HTMLElement): number;
2169
+ /**
2170
+ * Keyboard resizing. A drag handle that only answers to a pointer makes a
2171
+ * resizable column unusable without a mouse, which is an a11y gap rather than
2172
+ * a missing nicety — hence Arrow for fine steps, PageUp/PageDown for coarse
2173
+ * ones and Home to hand the column back to automatic sizing.
2174
+ */
2175
+ protected onResizeKey(col: TableColumn<T>, event: KeyboardEvent): void;
1379
2176
  /** Client-side filter over the full data set — combines the `filterQuery`
1380
2177
  * substring search with any per-column set filters. Sorting and pagination
1381
2178
  * run on the filtered rows. */
1382
2179
  protected readonly filteredData: _angular_core.Signal<readonly T[]>;
1383
- /** Client-side sort over the filtered data set — only when `clientSort()`. */
2180
+ /** Client-side sort over the filtered data set — only in `'client'` mode. */
1384
2181
  protected readonly sortedData: _angular_core.Signal<readonly T[]>;
1385
2182
  /** Current page's slice of the sorted rows, when paginating. */
1386
2183
  protected readonly pagedData: _angular_core.Signal<readonly T[]>;
1387
2184
  /** Rows actually rendered: paged when paginating, else sorted/raw data. */
1388
2185
  protected readonly displayData: _angular_core.Signal<readonly T[]>;
2186
+ /**
2187
+ * The single live-region line. Loading wins while it lasts — a sort
2188
+ * announcement over rows that are being replaced tells the reader about a
2189
+ * state they cannot inspect yet. Otherwise it carries the sort state and the
2190
+ * row range, which are the two things a sighted user reads off the header and
2191
+ * the pager and a screen-reader user was told nothing about.
2192
+ *
2193
+ * `aria-live="polite"` does not announce a region's INITIAL content, so the
2194
+ * unsorted first render is silent; only real changes speak.
2195
+ */
2196
+ protected readonly statusMessage: _angular_core.Signal<string>;
2197
+ private readonly sortMessage;
2198
+ private readonly rangeMessage;
2199
+ /** Virtual mode needs a bounded scroller to window against. */
2200
+ protected readonly virtualizing: _angular_core.Signal<boolean>;
2201
+ /** Drives the CSS row height from the same number the arithmetic uses, so the
2202
+ * two cannot drift — which would make every offset progressively wrong. */
2203
+ protected readonly virtualRowHeight: _angular_core.Signal<string>;
2204
+ /** How many rows the scroller spans. Lazy counts the rows that EXIST, not the
2205
+ * ones that have arrived — otherwise the spacers shrink to the loaded slice
2206
+ * and the scrollbar lies about the length of the list. */
2207
+ protected readonly virtualCount: _angular_core.Signal<number>;
2208
+ /** `null` when not virtualizing — the row loop then walks `displayData()` whole. */
2209
+ protected readonly virtualWindow: _angular_core.Signal<{
2210
+ start: number;
2211
+ end: number;
2212
+ padTop: number;
2213
+ padBottom: number;
2214
+ } | null>;
2215
+ /** The rows the template actually renders. */
2216
+ protected readonly windowData: _angular_core.Signal<readonly T[]>;
2217
+ /**
2218
+ * What the row loop walks: each slot carries its ABSOLUTE index, and a `null`
2219
+ * row is a gap the host has not filled yet.
2220
+ *
2221
+ * Absolute rather than loop-relative because everything downstream needs it —
2222
+ * striping parity, the skeleton's width seed, and the range `(lazyLoad)` asks
2223
+ * for. Outside lazy mode every slot is filled, so the extra object per visible
2224
+ * row buys uniformity for the ~25 rows windowing keeps in the DOM.
2225
+ */
2226
+ protected readonly rowSlots: _angular_core.Signal<readonly {
2227
+ row: T | null;
2228
+ index: number;
2229
+ }[]>;
2230
+ /** Zebra striping cannot come from `:nth-child` while windowing — the parity
2231
+ * of a rendered row depends on its ABSOLUTE index, and the spacer rows are
2232
+ * children too. Matches `:nth-child(odd)`, which is 1-based. */
2233
+ protected isStriped(absoluteIndex: number): boolean;
1389
2234
  protected readonly allSelected: _angular_core.Signal<boolean>;
1390
2235
  protected readonly someSelected: _angular_core.Signal<boolean>;
1391
2236
  /** Select-all is page-scoped only when paginating. */
@@ -1406,10 +2251,23 @@ declare class TableComponent<T extends object> {
1406
2251
  /** Click on a `truncate` cell: when the text is actually clipped, show the
1407
2252
  * full value in a popover; otherwise let the click fall through to the row. */
1408
2253
  protected onCellClipClick(row: T, col: TableColumn<T>, event: Event): void;
2254
+ /** Clipped horizontally — itself or anything it renders. A `dsCellTemplate`
2255
+ * puts the ellipsis on a descendant, so testing only the wrapper misses it. */
2256
+ private static isClipped;
2257
+ /**
2258
+ * A header narrowed by resizing clips its own label, and the label is the only
2259
+ * thing naming the column — so the full text has to stay reachable. Set on
2260
+ * enter rather than always, because a `title` on every header would fire a
2261
+ * tooltip on hover for text that is perfectly readable.
2262
+ */
2263
+ protected onHeaderEnter(event: Event, col: TableColumn<T>): void;
1409
2264
  private readonly scrollWrap;
1410
2265
  private readonly hscrollProxy;
1411
2266
  protected readonly hscrollContentWidth: _angular_core.WritableSignal<number>;
1412
2267
  protected readonly hscrollNeeded: _angular_core.WritableSignal<boolean>;
2268
+ private readonly scrollTop;
2269
+ private readonly viewportHeight;
2270
+ private lastLazyRequest;
1413
2271
  constructor();
1414
2272
  private parseDurationMs;
1415
2273
  protected onRowMenuClick(row: T, event: Event): void;
@@ -1431,6 +2289,8 @@ declare class TableComponent<T extends object> {
1431
2289
  /** Row identity — the `rowId` accessor when given, else `row.id`. Public so a
1432
2290
  * host reading `selectedIds`/`expandedIds` can compute the same keys. */
1433
2291
  rowKey(row: T): string;
2292
+ /** Whether this column's header is an actual sort control right now. */
2293
+ protected sortableCol(col: TableColumn<T>): boolean;
1434
2294
  protected ariaSort(col: TableColumn<T>): 'ascending' | 'descending' | 'none' | null;
1435
2295
  protected onSort(col: TableColumn<T>): void;
1436
2296
  protected headerClasses(col: TableColumn<T>): string;
@@ -1439,12 +2299,22 @@ declare class TableComponent<T extends object> {
1439
2299
  /** Exports the visible columns of the filtered + sorted rows (all rows, not
1440
2300
  * just the current page) as a CSV download. Call from a consumer button:
1441
2301
  * `<ds-button (pressed)="table.exportCsv()">`. */
1442
- exportCsv(filename?: string): void;
2302
+ exportCsv(filename?: string, rows?: readonly T[]): void;
2303
+ private layoutKey;
2304
+ private layoutRestored;
2305
+ private restoreLayout;
2306
+ private saveLayout;
2307
+ /** Export button handler: awaits `exportFetcher` when one is given, so a
2308
+ * server-paged table exports the whole set rather than the page it holds. */
2309
+ protected runExport(): Promise<void>;
2310
+ /** Hands a ready-made file to the browser. Only a Blob gets its object URL
2311
+ * revoked — a URL the caller supplied is theirs to manage. */
2312
+ private downloadFile;
1443
2313
  /** Deterministic per-cell width so skeleton rows look organic but stable
1444
2314
  * across re-renders. Mixes column key + row index into one of five widths. */
1445
2315
  protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
1446
2316
  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>;
2317
+ 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; }; "sortAnnouncement": { "alias": "sortAnnouncement"; "required": false; "isSignal": true; }; "rangeAnnouncement": { "alias": "rangeAnnouncement"; "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; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "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; }; "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "columnFilterOptions": { "alias": "columnFilterOptions"; "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; }; "lazy": { "alias": "lazy"; "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"; "exportFailed": "exportFailed"; "pageSize": "pageSizeChange"; "page": "pageChange"; "lazyLoad": "lazyLoad"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; }, ["cellTemplateDirectives", "headerFilters"], ["[empty]", "[bulk-actions]"], true, never>;
1448
2318
  }
1449
2319
 
1450
2320
  declare class PaginationComponent {
@@ -1476,6 +2346,81 @@ declare class PaginationComponent {
1476
2346
  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
2347
  }
1478
2348
 
2349
+ /**
2350
+ * One password requirement. The consumer owns the POLICY — `test` must mirror
2351
+ * whatever their server enforces — and the DS owns only how the row reads.
2352
+ */
2353
+ interface DsPasswordRule {
2354
+ /** Row text, e.g. "At least 8 characters". */
2355
+ readonly label: string;
2356
+ /** Whether the current value satisfies this rule. */
2357
+ readonly test: (value: string) => boolean;
2358
+ }
2359
+ /** Per-row state, exposed so a consumer can style or test against it. */
2360
+ type DsPasswordRuleState = 'pending' | 'met' | 'failed';
2361
+
2362
+ interface RuleRow {
2363
+ readonly label: string;
2364
+ readonly state: DsPasswordRuleState;
2365
+ readonly icon: IconName;
2366
+ readonly announced: string;
2367
+ }
2368
+ /**
2369
+ * Passes when every rule does. Exported separately so a form can gate its submit
2370
+ * from a validator without reaching for the component instance.
2371
+ */
2372
+ declare function passwordRulesMet(value: string, rules: readonly DsPasswordRule[]): boolean;
2373
+ /**
2374
+ * Live checklist under a "new password" field.
2375
+ *
2376
+ * The consumer keeps the POLICY — each rule carries its own `test`, which has to
2377
+ * mirror the server, or the checklist is a lie — and this owns the rendering: the
2378
+ * tri-state glyph, the met and failed colours, the type scale. One consumer had
2379
+ * written it twice and the copies had already drifted (different labels for the
2380
+ * same rule, a different order, different state classes), which is why it is here.
2381
+ *
2382
+ * ```html
2383
+ * <ds-input
2384
+ * type="password"
2385
+ * [attr.aria-describedby]="rules.listId"
2386
+ * [(value)]="password"
2387
+ * />
2388
+ * <ds-password-rules
2389
+ * #rules
2390
+ * [value]="password()"
2391
+ * [rules]="passwordRules"
2392
+ * [showUnmet]="submitted()"
2393
+ * />
2394
+ * ```
2395
+ */
2396
+ declare class PasswordRulesComponent {
2397
+ /** The password being typed. */
2398
+ readonly value: _angular_core.InputSignal<string>;
2399
+ /** The rule set, in the order it should read. */
2400
+ readonly rules: _angular_core.InputSignal<readonly DsPasswordRule[]>;
2401
+ /**
2402
+ * Whether an unmet rule may read as FAILED. Bind it to "the user has tried to
2403
+ * submit": before that an unmet rule is merely pending, because marking a
2404
+ * half-typed password with errors scolds someone who is still typing.
2405
+ */
2406
+ readonly showUnmet: _angular_core.InputSignalWithTransform<boolean, unknown>;
2407
+ /** Lay the rows out in two columns — for a checklist beside a wide form. */
2408
+ readonly columns: _angular_core.InputSignal<1 | 2>;
2409
+ /**
2410
+ * Id put on the rule list, for the field's `aria-describedby`. Defaults to a
2411
+ * generated one; set it explicitly and both sides can name the same string,
2412
+ * which avoids threading a template ref between two siblings.
2413
+ */
2414
+ readonly listId: _angular_core.InputSignal<string>;
2415
+ protected readonly rows: _angular_core.Signal<readonly RuleRow[]>;
2416
+ /** How many rules pass — for a host that wants to gate its own submit. */
2417
+ readonly metCount: _angular_core.Signal<number>;
2418
+ /** True when every rule passes. */
2419
+ readonly allMet: _angular_core.Signal<boolean>;
2420
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<PasswordRulesComponent, never>;
2421
+ 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>;
2422
+ }
2423
+
1479
2424
  interface DateFormatSpec {
1480
2425
  order: ('D' | 'M' | 'Y')[];
1481
2426
  separator: string;
@@ -1521,6 +2466,9 @@ interface DayCell {
1521
2466
  isDisabled: boolean;
1522
2467
  }
1523
2468
  declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeValue | null> implements OnDestroy {
2469
+ /** Segment of a ds-field-group: the group owns the border, radius and focus
2470
+ * ring, so .in-group strips this control back to its bare contents. */
2471
+ protected readonly inGroup: boolean;
1524
2472
  constructor();
1525
2473
  /** Field text for the DOM: fixed-width `_`-padded once any digit exists,
1526
2474
  * else '' (so an untouched field is genuinely empty — no error on blur,
@@ -1549,6 +2497,19 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1549
2497
  readonly label: _angular_core.InputSignal<string>;
1550
2498
  /** Helper text shown below the field. */
1551
2499
  readonly hint: _angular_core.InputSignal<string>;
2500
+ /** Error text. Shown immediately — binding it says the consumer has already
2501
+ * decided this field is in error. Takes precedence over `errors` and over the
2502
+ * picker's own "enter a valid date" message. */
2503
+ readonly error: _angular_core.InputSignal<string>;
2504
+ /** Advisory text, shown when there is no error. */
2505
+ readonly warning: _angular_core.InputSignal<string>;
2506
+ /** Validation errors, shown once the user has interacted. Bound automatically
2507
+ * by signal forms; reactive and template-driven forms are read through
2508
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
2509
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
2510
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
2511
+ * `errors`, so a `required` error does not greet an untouched form. */
2512
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1552
2513
  /** Reserve the message-row height even when empty, so the field doesn't shift
1553
2514
  * the layout below it when a hint/error appears. Falls back to
1554
2515
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -1591,9 +2552,11 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1591
2552
  readonly allowInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
1592
2553
  protected readonly isDisabled: _angular_core.Signal<boolean>;
1593
2554
  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>;
2555
+ private readonly localError;
2556
+ private readonly dateInvalid;
2557
+ private readonly fieldMessage;
2558
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
2559
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
1597
2560
  protected readonly resolvedLocale: _angular_core.Signal<string>;
1598
2561
  protected readonly resolvedFirstDay: _angular_core.Signal<number>;
1599
2562
  protected readonly formatSpec: _angular_core.Signal<DateFormatSpec>;
@@ -1673,8 +2636,16 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1673
2636
  protected readonly weeksGrid: _angular_core.Signal<DayCell[][]>;
1674
2637
  private getRangeContext;
1675
2638
  protected open(moveFocusToGrid?: boolean): void;
1676
- protected close(): void;
2639
+ protected close(cause?: DsOverlayCloseCause): void;
1677
2640
  ngOnDestroy(): void;
2641
+ /**
2642
+ * Also the calendar glyph's handler. A POINTER open must not drag focus into
2643
+ * the day grid: the reader did not ask to leave a field they may want to type
2644
+ * in, and `allowInput` defaults to true. So focus follows what the field IS —
2645
+ * typeable, and the caret stays; read-only, and the grid is the only thing
2646
+ * worth focusing. The keyboard path is unaffected: ArrowDown on the field
2647
+ * calls `open(true)` and enters the grid however the panel was opened.
2648
+ */
1678
2649
  protected onFieldClick(): void;
1679
2650
  private mobileEdit;
1680
2651
  protected onFieldInput(event: Event): void;
@@ -1722,7 +2693,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1722
2693
  protected isPresetDisabled(preset: DatePickerPreset): boolean;
1723
2694
  protected applyPreset(preset: DatePickerPreset): void;
1724
2695
  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>;
2696
+ 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
2697
  }
1727
2698
 
1728
2699
  type TimePickerMode = 'single' | 'range';
@@ -1831,6 +2802,18 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1831
2802
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1832
2803
  /** Helper text shown below the picker. */
1833
2804
  readonly hint: _angular_core.InputSignal<string>;
2805
+ /** Error text. Shown immediately — binding it says the consumer has already
2806
+ * decided this field is in error. Takes precedence over `errors`. */
2807
+ readonly error: _angular_core.InputSignal<string>;
2808
+ /** Advisory text, shown when there is no error. */
2809
+ readonly warning: _angular_core.InputSignal<string>;
2810
+ /** Validation errors, shown once the user has interacted. Bound automatically
2811
+ * by signal forms; reactive and template-driven forms are read through
2812
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
2813
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
2814
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
2815
+ * `errors`, so a `required` error does not greet an untouched form. */
2816
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1834
2817
  /** Reserve the message-row height even when empty, so the field doesn't shift
1835
2818
  * the layout below it when a hint/error appears. Falls back to
1836
2819
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -1856,7 +2839,9 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1856
2839
  protected readonly columns: _angular_core.Signal<TimeColumnsComponent | undefined>;
1857
2840
  protected readonly isDisabled: _angular_core.Signal<boolean>;
1858
2841
  protected readonly hintId: _angular_core.Signal<string | null>;
1859
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
2842
+ private readonly fieldMessage;
2843
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
2844
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
1860
2845
  protected readonly resolvedFormat: _angular_core.Signal<TimeFormat>;
1861
2846
  protected readonly singleValue: _angular_core.Signal<string | null>;
1862
2847
  protected readonly rangeValue: _angular_core.Signal<TimeRangeValue>;
@@ -1872,9 +2857,9 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1872
2857
  protected formatFor(value: string | null): string;
1873
2858
  protected open(segment: Segment): void;
1874
2859
  protected onTriggerClick(segment: Segment): void;
1875
- protected close(): void;
2860
+ protected close(cause?: DsOverlayCloseCause): void;
1876
2861
  ngOnDestroy(): void;
1877
- protected onEscape(): void;
2862
+ protected onEscape(cause?: DsOverlayCloseCause): void;
1878
2863
  protected onPick(next: string): void;
1879
2864
  protected setNow(): void;
1880
2865
  protected clear(event: Event): void;
@@ -1882,7 +2867,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1882
2867
  private minutesOf;
1883
2868
  private laterOf;
1884
2869
  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>;
2870
+ 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
2871
  }
1887
2872
 
1888
2873
  interface BreadcrumbItem {
@@ -1903,14 +2888,29 @@ declare class BreadcrumbsComponent {
1903
2888
  readonly separator: _angular_core.InputSignal<IconName | null>;
1904
2889
  /** Whether crumbs render as links; falls back to `DS_CONFIG.breadcrumbs.clickable`, then `true`. */
1905
2890
  readonly clickable: _angular_core.InputSignal<boolean | null>;
2891
+ /**
2892
+ * Caps how many crumbs render, collapsing the middle into an ellipsis — the
2893
+ * first and the LAST always survive. Null (default) renders every crumb.
2894
+ *
2895
+ * Worth setting on any trail that can get deep: the row is `nowrap` with
2896
+ * `overflow: hidden`, so without a cap an overlong trail is clipped from the
2897
+ * END, which is the current page — the one crumb the reader needs most.
2898
+ */
2899
+ readonly maxItems: _angular_core.InputSignalWithTransform<number | null, number | null>;
1906
2900
  /** Fires when a clickable crumb with `href` is activated; default navigation is always prevented. */
1907
2901
  readonly navigate: _angular_core.OutputEmitterRef<BreadcrumbItem>;
2902
+ private readonly allItems;
2903
+ /**
2904
+ * What renders. The collapsed crumb carries no `href`, so it is inert rather
2905
+ * than a link to nowhere; its label is the count, which tells the reader how
2906
+ * much is hidden instead of just that something is.
2907
+ */
1908
2908
  protected readonly resolvedItems: _angular_core.Signal<BreadcrumbItem[]>;
1909
2909
  protected readonly effectiveSeparator: _angular_core.Signal<IconName>;
1910
2910
  protected readonly effectiveClickable: _angular_core.Signal<boolean>;
1911
2911
  protected onNav(event: Event, item: BreadcrumbItem): void;
1912
2912
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<BreadcrumbsComponent, never>;
1913
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<BreadcrumbsComponent, "ds-breadcrumbs", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "separator": { "alias": "separator"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; }, { "navigate": "navigate"; }, never, never, true, never>;
2913
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<BreadcrumbsComponent, "ds-breadcrumbs", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "separator": { "alias": "separator"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "maxItems": { "alias": "maxItems"; "required": false; "isSignal": true; }; }, { "navigate": "navigate"; }, never, never, true, never>;
1914
2914
  }
1915
2915
 
1916
2916
  /**
@@ -1930,22 +2930,6 @@ declare class BreadcrumbsService {
1930
2930
  static ɵprov: _angular_core.ɵɵInjectableDeclaration<BreadcrumbsService>;
1931
2931
  }
1932
2932
 
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
2933
  /** Contract that ds-sidenav-item reads from its parent ds-sidenav. */
1950
2934
  interface SidenavContract {
1951
2935
  readonly collapsed: () => boolean;
@@ -2144,10 +3128,14 @@ declare class ModalComponent implements OnDestroy {
2144
3128
  readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
2145
3129
  /** Dialog title, shown in the header and used for `aria-labelledby`. */
2146
3130
  readonly title: _angular_core.InputSignal<string>;
3131
+ /** Secondary line under the title. Not part of the accessible name. */
3132
+ readonly subtitle: _angular_core.InputSignal<string | null>;
2147
3133
  /** Fires once the close (leave) animation finishes. */
2148
3134
  readonly closed: _angular_core.OutputEmitterRef<void>;
2149
3135
  /** Emit this yourself from a confirm action in the projected content — not fired by the modal itself. */
2150
3136
  readonly confirmed: _angular_core.OutputEmitterRef<void>;
3137
+ /** Draws the rules under the header and over the actions. Turning them off also tightens the vertical padding they were sized for. */
3138
+ readonly dividers: _angular_core.InputSignalWithTransform<boolean, unknown>;
2151
3139
  /** When false, clicking the scrim does not close the modal. */
2152
3140
  readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
2153
3141
  /** When true, neither backdrop click nor Escape closes the modal — only programmatic or explicit close button. */
@@ -2166,7 +3154,7 @@ declare class ModalComponent implements OnDestroy {
2166
3154
  protected onBackdrop(event: MouseEvent): void;
2167
3155
  protected onEscape(): void;
2168
3156
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalComponent, never>;
2169
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalComponent, "ds-modal", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "persistent": { "alias": "persistent"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; "confirmed": "confirmed"; }, never, ["[eyebrow]", "[body]", "[impact]", "[actions]"], true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
3157
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalComponent, "ds-modal", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "dividers": { "alias": "dividers"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "persistent": { "alias": "persistent"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; "confirmed": "confirmed"; }, never, ["[eyebrow]", "[title-badge]", "[body]", "[impact]", "[actions]"], true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
2170
3158
  }
2171
3159
 
2172
3160
  declare class ModalCardComponent {
@@ -2176,8 +3164,12 @@ declare class ModalCardComponent {
2176
3164
  readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
2177
3165
  /** Card title, shown in the header and used for `aria-labelledby`. */
2178
3166
  readonly title: _angular_core.InputSignal<string>;
3167
+ /** Secondary line under the title. Not part of the accessible name. */
3168
+ readonly subtitle: _angular_core.InputSignal<string | null>;
2179
3169
  /** Shows the header close button. */
2180
3170
  readonly showClose: _angular_core.InputSignalWithTransform<boolean, unknown>;
3171
+ /** Draws the rules under the header and over the actions. Turning them off also tightens the vertical padding they were sized for. */
3172
+ readonly dividers: _angular_core.InputSignalWithTransform<boolean, unknown>;
2181
3173
  /** Icon badge shown next to the title. */
2182
3174
  readonly icon: _angular_core.InputSignal<IconName | null>;
2183
3175
  /** ARIA role for the dialog element. */
@@ -2188,7 +3180,7 @@ declare class ModalCardComponent {
2188
3180
  protected readonly classes: _angular_core.Signal<string>;
2189
3181
  protected onClose(): void;
2190
3182
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalCardComponent, never>;
2191
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalCardComponent, "ds-modal-card", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "showClose": { "alias": "showClose"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "dialogRole": { "alias": "dialogRole"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["[eyebrow]", "[body]", "[impact]", "[actions]"], true, never>;
3183
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalCardComponent, "ds-modal-card", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "showClose": { "alias": "showClose"; "required": false; "isSignal": true; }; "dividers": { "alias": "dividers"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "dialogRole": { "alias": "dialogRole"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["[eyebrow]", "[title-badge]", "[body]", "[impact]", "[actions]"], true, never>;
2192
3184
  }
2193
3185
 
2194
3186
  type ModalConfirmTone = 'default' | 'error';
@@ -2228,7 +3220,7 @@ declare class BannerComponent {
2228
3220
  /** Tighter padding, centred items, single-line title. */
2229
3221
  readonly compact: _angular_core.InputSignalWithTransform<boolean, unknown>;
2230
3222
  /** `'stacked'` wraps actions onto their own line; `'row'` keeps them inline. */
2231
- readonly layout: _angular_core.InputSignal<"stacked" | "row">;
3223
+ readonly layout: _angular_core.InputSignal<"row" | "stacked">;
2232
3224
  /** Coloured accent rail on the leading edge; set false to hide it. */
2233
3225
  readonly accentRail: _angular_core.InputSignalWithTransform<boolean, unknown>;
2234
3226
  /** Fires when the user dismisses the banner. */
@@ -2333,6 +3325,9 @@ declare class MenuItemComponent implements OnDestroy {
2333
3325
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2334
3326
  /** Renders the item in an error/destructive style. */
2335
3327
  readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
3328
+ /** Renders the item muted — a secondary row like "Sign out" under a divider,
3329
+ * still actionable but not competing with the items above it. */
3330
+ readonly quiet: _angular_core.InputSignalWithTransform<boolean, unknown>;
2336
3331
  /** Optional submenu template — renders a nested `ds-menu` on hover / ArrowRight. */
2337
3332
  readonly submenu: _angular_core.InputSignal<TemplateRef<unknown> | null>;
2338
3333
  /** Fires on click, unless the item is disabled or opens a submenu. */
@@ -2363,7 +3358,7 @@ declare class MenuItemComponent implements OnDestroy {
2363
3358
  private clearOpenTimer;
2364
3359
  private clearCloseTimer;
2365
3360
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuItemComponent, never>;
2366
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<MenuItemComponent, "ds-menu-item", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "submenu": { "alias": "submenu"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["[icon]", "*"], true, never>;
3361
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<MenuItemComponent, "ds-menu-item", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "quiet": { "alias": "quiet"; "required": false; "isSignal": true; }; "submenu": { "alias": "submenu"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["[icon]", "*"], true, never>;
2367
3362
  }
2368
3363
 
2369
3364
  declare class MenuDividerComponent {
@@ -2564,7 +3559,7 @@ declare class PopoverComponent implements OnDestroy, DsOverlayCloseRef {
2564
3559
  /** Resolved placement after the overlay positions — drives the arrow direction. */
2565
3560
  readonly resolvedPlacement: _angular_core.WritableSignal<PopoverPlacement>;
2566
3561
  toggle(trigger: HTMLElement): void;
2567
- close(): void;
3562
+ close(cause?: DsOverlayCloseCause): void;
2568
3563
  ngOnDestroy(): void;
2569
3564
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverComponent, never>;
2570
3565
  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: {}; }]>;
@@ -2826,6 +3821,9 @@ interface AutocompleteOptionGroup<T = unknown> {
2826
3821
  }
2827
3822
 
2828
3823
  declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<T | readonly T[] | null> implements OnDestroy {
3824
+ /** Segment of a ds-field-group: the group owns the border, radius and focus
3825
+ * ring, so .in-group strips this control back to its bare contents. */
3826
+ protected readonly inGroup: boolean;
2829
3827
  private readonly overlay;
2830
3828
  private readonly vcr;
2831
3829
  private readonly host;
@@ -2840,6 +3838,13 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2840
3838
  readonly value: _angular_core.ModelSignal<T | readonly T[] | null>;
2841
3839
  /** Allows selecting more than one option, shown as removable tags. */
2842
3840
  readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
3841
+ /** Draws the trailing chevron. Turn it off for a search field, where an arrow
3842
+ * invites a click that would list everything instead of searching. */
3843
+ readonly showChevron: _angular_core.InputSignalWithTransform<boolean, unknown>;
3844
+ /** Caps the number of chips shown before collapsing the rest into "+N more" — 0/null shows all.
3845
+ * Same name and semantics as `ds-multi-select`: without it a trigger grows a
3846
+ * line per selection and pushes the rest of the form down the page. */
3847
+ readonly maxVisibleChips: _angular_core.InputSignalWithTransform<number | null, number | null>;
2843
3848
  /** Trigger height — sm/md/lg. */
2844
3849
  readonly size: _angular_core.InputSignal<DsSize>;
2845
3850
  /** Trigger width — `fill` stretches to the container, `content` hugs the value. */
@@ -2852,6 +3857,18 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2852
3857
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2853
3858
  /** Helper text shown below the field. */
2854
3859
  readonly hint: _angular_core.InputSignal<string>;
3860
+ /** Error text. Shown immediately — binding it says the consumer has already
3861
+ * decided this field is in error. Takes precedence over `errors`. */
3862
+ readonly error: _angular_core.InputSignal<string>;
3863
+ /** Advisory text, shown when there is no error. */
3864
+ readonly warning: _angular_core.InputSignal<string>;
3865
+ /** Validation errors, shown once the user has interacted. Bound automatically
3866
+ * by signal forms; reactive and template-driven forms are read through
3867
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
3868
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
3869
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
3870
+ * `errors`, so a `required` error does not greet an untouched form. */
3871
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
2855
3872
  /** Reserve the message-row height even when empty, so the field doesn't shift
2856
3873
  * the layout below it when a hint/error appears. Falls back to
2857
3874
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -2860,13 +3877,15 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2860
3877
  protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
2861
3878
  /** Shows a "Create «text»" row when the typed text matches no option. */
2862
3879
  readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
2863
- /** Accessible name for the combobox input. */
3880
+ /** Accessible name for the input. */
2864
3881
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2865
3882
  /** Fires with the typed text when the user picks the create-new option. */
2866
3883
  readonly create: _angular_core.OutputEmitterRef<string>;
2867
3884
  protected readonly isDisabled: _angular_core.Signal<boolean>;
2868
3885
  protected readonly hintId: _angular_core.Signal<string | null>;
2869
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
3886
+ private readonly fieldMessage;
3887
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
3888
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
2870
3889
  protected readonly query: _angular_core.WritableSignal<string>;
2871
3890
  protected readonly isOpen: _angular_core.WritableSignal<boolean>;
2872
3891
  protected readonly activeIndex: _angular_core.WritableSignal<number>;
@@ -2888,6 +3907,11 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2888
3907
  /** Flat list of visible options used for keyboard navigation index. */
2889
3908
  protected readonly visibleOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
2890
3909
  protected readonly selectedTags: _angular_core.Signal<AutocompleteOption<T>[]>;
3910
+ /** What the trigger renders. Separate from `selectedTags`, which stays the
3911
+ * full selection: Backspace removes the last SELECTED chip, and capping the
3912
+ * list it reads would silently make it remove the last VISIBLE one instead. */
3913
+ protected readonly visibleTags: _angular_core.Signal<AutocompleteOption<T>[]>;
3914
+ protected readonly overflowCount: _angular_core.Signal<number>;
2891
3915
  protected readonly displayLabel: _angular_core.Signal<string>;
2892
3916
  protected readonly placeholderText: _angular_core.Signal<string>;
2893
3917
  protected isSelected(option: AutocompleteOption<T>): boolean;
@@ -2898,14 +3922,27 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2898
3922
  protected togglePanel(event: MouseEvent): void;
2899
3923
  protected onKeydown(event: KeyboardEvent): void;
2900
3924
  protected openPanel(): void;
2901
- protected close(): void;
3925
+ protected close(cause?: DsOverlayCloseCause): void;
3926
+ /**
3927
+ * Empties the field — both the selected value and the text the user typed.
3928
+ *
3929
+ * `value.set(null)` alone is not enough from outside: the typed query is
3930
+ * component state with no input bound to it, so the text stays on screen after
3931
+ * the value goes. That gap is why a host reaching for "reset after navigating"
3932
+ * ends up querying the inner `<input>` and dispatching a synthetic `input`
3933
+ * event.
3934
+ *
3935
+ * Deliberately does NOT move focus — the caller may be navigating away, and
3936
+ * stealing focus back into a field they just left is worse than leaving it.
3937
+ */
3938
+ clear(): void;
2902
3939
  ngOnDestroy(): void;
2903
3940
  protected onFilter(event: Event): void;
2904
3941
  protected onPick(option: AutocompleteOption<T>): void;
2905
3942
  protected onCreateNew(): void;
2906
3943
  protected remove(target: T): void;
2907
3944
  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>;
3945
+ 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; }; "showChevron": { "alias": "showChevron"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "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, ["[dsAutocompletePrefix]", "[dsAutocompleteSuffix]"], true, never>;
2909
3946
  }
2910
3947
 
2911
3948
  type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
@@ -3092,6 +4129,18 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
3092
4129
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3093
4130
  /** Helper text shown below the cells. */
3094
4131
  readonly hint: _angular_core.InputSignal<string>;
4132
+ /** Error text. Shown immediately — binding it says the consumer has already
4133
+ * decided this field is in error. Takes precedence over `errors`. */
4134
+ readonly error: _angular_core.InputSignal<string>;
4135
+ /** Advisory text, shown when there is no error. */
4136
+ readonly warning: _angular_core.InputSignal<string>;
4137
+ /** Validation errors, shown once the user has interacted. Bound automatically
4138
+ * by signal forms; reactive and template-driven forms are read through
4139
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4140
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4141
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
4142
+ * `errors`, so a `required` error does not greet an untouched form. */
4143
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3095
4144
  /** Reserve the message-row height even when empty, so the field doesn't shift
3096
4145
  * the layout below it when a hint/error appears. Falls back to
3097
4146
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -3106,7 +4155,9 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
3106
4155
  private wasComplete;
3107
4156
  protected readonly uid: string;
3108
4157
  protected readonly hintId: _angular_core.Signal<string | null>;
3109
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
4158
+ private readonly fieldMessage;
4159
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4160
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3110
4161
  protected readonly isDisabled: _angular_core.Signal<boolean>;
3111
4162
  protected readonly cells: _angular_core.Signal<string[]>;
3112
4163
  protected onInput(event: Event, index: number): void;
@@ -3122,7 +4173,7 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
3122
4173
  private focusBox;
3123
4174
  private sanitize;
3124
4175
  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>;
4176
+ 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
4177
  }
3127
4178
 
3128
4179
  type SliderValue = number | readonly [number, number];
@@ -3145,6 +4196,18 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
3145
4196
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3146
4197
  /** Helper text shown below the slider. */
3147
4198
  readonly hint: _angular_core.InputSignal<string>;
4199
+ /** Error text. Shown immediately — binding it says the consumer has already
4200
+ * decided this field is in error. Takes precedence over `errors`. */
4201
+ readonly error: _angular_core.InputSignal<string>;
4202
+ /** Advisory text, shown when there is no error. */
4203
+ readonly warning: _angular_core.InputSignal<string>;
4204
+ /** Validation errors, shown once the user has interacted. Bound automatically
4205
+ * by signal forms; reactive and template-driven forms are read through
4206
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4207
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4208
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
4209
+ * `errors`, so a `required` error does not greet an untouched form. */
4210
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3148
4211
  /** Reserve the message-row height even when empty, so the field doesn't shift
3149
4212
  * the layout below it when a hint/error appears. Falls back to
3150
4213
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -3155,7 +4218,9 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
3155
4218
  private dragging;
3156
4219
  protected readonly uid: string;
3157
4220
  protected readonly hintId: _angular_core.Signal<string | null>;
3158
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
4221
+ private readonly fieldMessage;
4222
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4223
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3159
4224
  protected readonly isDisabled: _angular_core.Signal<boolean>;
3160
4225
  protected readonly thumbValues: _angular_core.Signal<number[]>;
3161
4226
  protected readonly fill: _angular_core.Signal<{
@@ -3176,7 +4241,7 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
3176
4241
  private setThumb;
3177
4242
  private snap;
3178
4243
  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>;
4244
+ 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
4245
  }
3181
4246
 
3182
4247
  declare class LoadingOverlayComponent {
@@ -3262,6 +4327,18 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
3262
4327
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3263
4328
  /** Helper text shown below the trigger. */
3264
4329
  readonly hint: _angular_core.InputSignal<string>;
4330
+ /** Error text. Shown immediately — binding it says the consumer has already
4331
+ * decided this field is in error. Takes precedence over `errors`. */
4332
+ readonly error: _angular_core.InputSignal<string>;
4333
+ /** Advisory text, shown when there is no error. */
4334
+ readonly warning: _angular_core.InputSignal<string>;
4335
+ /** Validation errors, shown once the user has interacted. Bound automatically
4336
+ * by signal forms; reactive and template-driven forms are read through
4337
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4338
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4339
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
4340
+ * `errors`, so a `required` error does not greet an untouched form. */
4341
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3265
4342
  /** Reserve the message-row height even when empty, so the field doesn't shift
3266
4343
  * the layout below it when a hint/error appears. Falls back to
3267
4344
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -3278,7 +4355,9 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
3278
4355
  ngOnDestroy(): void;
3279
4356
  protected readonly uid: string;
3280
4357
  protected readonly hintId: _angular_core.Signal<string | null>;
3281
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
4358
+ private readonly fieldMessage;
4359
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4360
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3282
4361
  protected readonly isDisabled: _angular_core.Signal<boolean>;
3283
4362
  protected readonly displayHex: _angular_core.Signal<string>;
3284
4363
  protected readonly hueColor: _angular_core.Signal<string>;
@@ -3300,14 +4379,14 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
3300
4379
  protected onHuePointerUp(event: PointerEvent): void;
3301
4380
  protected onHueKeydown(event: KeyboardEvent): void;
3302
4381
  private openPanel;
3303
- close(): void;
4382
+ close(cause?: DsOverlayCloseCause): void;
3304
4383
  private setHsv;
3305
4384
  private commitHex;
3306
4385
  private updateSv;
3307
4386
  private updateHue;
3308
4387
  private clampPct;
3309
4388
  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>;
4389
+ 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
4390
  }
3312
4391
 
3313
4392
  interface MultiSelectOption {
@@ -3339,6 +4418,18 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
3339
4418
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3340
4419
  /** Helper text shown below the field. */
3341
4420
  readonly hint: _angular_core.InputSignal<string>;
4421
+ /** Error text. Shown immediately — binding it says the consumer has already
4422
+ * decided this field is in error. Takes precedence over `errors`. */
4423
+ readonly error: _angular_core.InputSignal<string>;
4424
+ /** Advisory text, shown when there is no error. */
4425
+ readonly warning: _angular_core.InputSignal<string>;
4426
+ /** Validation errors, shown once the user has interacted. Bound automatically
4427
+ * by signal forms; reactive and template-driven forms are read through
4428
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4429
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4430
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
4431
+ * `errors`, so a `required` error does not greet an untouched form. */
4432
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3342
4433
  /** Reserve the message-row height even when empty, so the field doesn't shift
3343
4434
  * the layout below it when a hint/error appears. Falls back to
3344
4435
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -3369,7 +4460,9 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
3369
4460
  protected readonly activeDescendant: _angular_core.Signal<string | null>;
3370
4461
  protected readonly resolvedAriaLabel: _angular_core.Signal<string>;
3371
4462
  protected readonly hintId: _angular_core.Signal<string | null>;
3372
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
4463
+ private readonly fieldMessage;
4464
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4465
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3373
4466
  private enabledFiltered;
3374
4467
  protected readonly allFilteredSelected: _angular_core.Signal<boolean>;
3375
4468
  protected readonly someFilteredSelected: _angular_core.Signal<boolean>;
@@ -3382,10 +4475,10 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
3382
4475
  protected onSearchKeydown(event: KeyboardEvent): void;
3383
4476
  protected openPanel(): void;
3384
4477
  protected onTriggerClick(): void;
3385
- protected close(): void;
4478
+ protected close(cause?: DsOverlayCloseCause): void;
3386
4479
  private moveActive;
3387
4480
  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>;
4481
+ 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
4482
  }
3390
4483
 
3391
4484
  declare class SkeletonComponent {
@@ -3423,6 +4516,18 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
3423
4516
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3424
4517
  /** Helper text shown below the checkbox. */
3425
4518
  readonly hint: _angular_core.InputSignal<string>;
4519
+ /** Error text. Shown immediately — binding it says the consumer has already
4520
+ * decided this field is in error. Takes precedence over `errors`. */
4521
+ readonly error: _angular_core.InputSignal<string>;
4522
+ /** Advisory text, shown when there is no error. */
4523
+ readonly warning: _angular_core.InputSignal<string>;
4524
+ /** Validation errors, shown once the user has interacted. Bound automatically
4525
+ * by signal forms; reactive and template-driven forms are read through
4526
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4527
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4528
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
4529
+ * `errors`, so a `required` error does not greet an untouched form. */
4530
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3426
4531
  /** Reserve the message-row height even when empty, so the field doesn't shift
3427
4532
  * the layout below it when a hint/error appears. Falls back to
3428
4533
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -3440,12 +4545,13 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
3440
4545
  protected readonly uid: string;
3441
4546
  protected readonly controlId: _angular_core.Signal<string>;
3442
4547
  protected readonly hintId: _angular_core.Signal<string | null>;
3443
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
4548
+ private readonly fieldMessage;
4549
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4550
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3444
4551
  protected readonly fieldClass: _angular_core.Signal<string>;
3445
4552
  protected onCheckedChange(event: Event): void;
3446
- protected readonly devMode: boolean;
3447
4553
  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>;
4554
+ 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
4555
  }
3450
4556
 
3451
4557
  declare class RadioComponent {
@@ -3464,6 +4570,18 @@ declare class RadioComponent {
3464
4570
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3465
4571
  /** Helper text shown below the control. */
3466
4572
  readonly hint: _angular_core.InputSignal<string>;
4573
+ /** Error text. Shown immediately — binding it says the consumer has already
4574
+ * decided this field is in error. Takes precedence over `errors`. */
4575
+ readonly error: _angular_core.InputSignal<string>;
4576
+ /** Advisory text, shown when there is no error. */
4577
+ readonly warning: _angular_core.InputSignal<string>;
4578
+ /** Validation errors, shown once the user has interacted. Bound automatically
4579
+ * by signal forms; reactive and template-driven forms are read through
4580
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4581
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4582
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
4583
+ * `errors`, so a `required` error does not greet an untouched form. */
4584
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3467
4585
  /** Reserve the message-row height even when empty, so the field doesn't shift
3468
4586
  * the layout below it when a hint/error appears. Falls back to
3469
4587
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -3480,7 +4598,9 @@ declare class RadioComponent {
3480
4598
  protected readonly uid: string;
3481
4599
  protected readonly controlId: _angular_core.Signal<string>;
3482
4600
  protected readonly hintId: _angular_core.Signal<string | null>;
3483
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
4601
+ private readonly fieldMessage;
4602
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4603
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3484
4604
  /** Injected via token to avoid circular import with RadioGroupComponent. */
3485
4605
  protected readonly group: _ids_group_ltd_ids_design_system.RadioGroupContract | null;
3486
4606
  readonly effectiveDisabled: _angular_core.Signal<boolean>;
@@ -3493,9 +4613,8 @@ declare class RadioComponent {
3493
4613
  /** Called by the group's keyboard handler to focus this radio's input. */
3494
4614
  focus(): void;
3495
4615
  protected onSelect(): void;
3496
- protected readonly devMode: boolean;
3497
4616
  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>;
4617
+ 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
4618
  }
3500
4619
 
3501
4620
  /** Contract that ds-radio reads from its parent ds-radio-group, injected via
@@ -3527,6 +4646,18 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
3527
4646
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3528
4647
  /** Helper text shown below the group. */
3529
4648
  readonly hint: _angular_core.InputSignal<string>;
4649
+ /** Error text. Shown immediately — binding it says the consumer has already
4650
+ * decided this field is in error. Takes precedence over `errors`. */
4651
+ readonly error: _angular_core.InputSignal<string>;
4652
+ /** Advisory text, shown when there is no error. */
4653
+ readonly warning: _angular_core.InputSignal<string>;
4654
+ /** Validation errors, shown once the user has interacted. Bound automatically
4655
+ * by signal forms; reactive and template-driven forms are read through
4656
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4657
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4658
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
4659
+ * `errors`, so a `required` error does not greet an untouched form. */
4660
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3530
4661
  /** Reserve the message-row height even when empty, so the field doesn't shift
3531
4662
  * the layout below it when a hint/error appears. Falls back to
3532
4663
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -3541,14 +4672,16 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
3541
4672
  protected readonly uid: string;
3542
4673
  readonly groupName: _angular_core.Signal<string>;
3543
4674
  protected readonly hintId: _angular_core.Signal<string | null>;
3544
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
4675
+ private readonly fieldMessage;
4676
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4677
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3545
4678
  private readonly radios;
3546
4679
  private get enabledRadios();
3547
4680
  isTabbable(radio: RadioGroupChild): boolean;
3548
4681
  select(value: unknown): void;
3549
4682
  protected onKeydown(event: KeyboardEvent): void;
3550
4683
  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>;
4684
+ 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
4685
  }
3553
4686
 
3554
4687
  declare class SwitchComponent extends DsBooleanControlValueAccessor {
@@ -3566,6 +4699,18 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
3566
4699
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3567
4700
  /** Helper text shown below the switch. */
3568
4701
  readonly hint: _angular_core.InputSignal<string>;
4702
+ /** Error text. Shown immediately — binding it says the consumer has already
4703
+ * decided this field is in error. Takes precedence over `errors`. */
4704
+ readonly error: _angular_core.InputSignal<string>;
4705
+ /** Advisory text, shown when there is no error. */
4706
+ readonly warning: _angular_core.InputSignal<string>;
4707
+ /** Validation errors, shown once the user has interacted. Bound automatically
4708
+ * by signal forms; reactive and template-driven forms are read through
4709
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4710
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4711
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
4712
+ * `errors`, so a `required` error does not greet an untouched form. */
4713
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3569
4714
  /** Reserve the message-row height even when empty, so the field doesn't shift
3570
4715
  * the layout below it when a hint/error appears. Falls back to
3571
4716
  * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
@@ -3583,13 +4728,14 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
3583
4728
  protected readonly uid: string;
3584
4729
  protected readonly controlId: _angular_core.Signal<string>;
3585
4730
  protected readonly hintId: _angular_core.Signal<string | null>;
3586
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
4731
+ private readonly fieldMessage;
4732
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4733
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3587
4734
  protected readonly switchClasses: _angular_core.Signal<string>;
3588
4735
  protected readonly fieldClass: _angular_core.Signal<string>;
3589
4736
  protected onCheckedChange(event: Event): void;
3590
- protected readonly devMode: boolean;
3591
4737
  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>;
4738
+ 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
4739
  }
3594
4740
 
3595
4741
  /**
@@ -3609,5 +4755,5 @@ declare class FieldClickFocusDirective {
3609
4755
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
3610
4756
  }
3611
4757
 
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 };
4758
+ export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppLayoutComponent, AuthLayoutComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BodyScrollLockService, BottomSheetComponent, BrandNameDirective, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_FIELD_GROUP, DS_ICON_REGISTRY, DS_TOAST_CONFIG, DS_TOAST_POSITION, DS_TOAST_POSITION_DEFAULT, DatePickerComponent, DescriptionItemComponent, DescriptionListComponent, DividerComponent, DrawerComponent, DropzoneComponent, DsOverlayCloseRef, DsStaticPreview, EmptyStateComponent, FieldClickFocusDirective, FieldGroupComponent, FilterBarComponent, FilterItemDirective, HeaderFilterDirective, ICONS, IconButtonComponent, IconComponent, InlineComponent, InputComponent, LayoutNavigationService, 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 };
4759
+ 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, DsFieldGroupContext, DsIconRegistry, DsPasswordRule, DsPasswordRuleState, DsScrollReset, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, EmptyStateVariant, HeaderFilterContext, 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, TableFilterMode, TableRowAction, TableRowActionEvent, TableSortMode, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TimeFormat, TimePickerMode, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };