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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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';
@@ -316,6 +317,9 @@ type ButtonVariant = 'solid' | 'tonal' | 'ghost' | 'outline' | 'text';
316
317
  type ButtonType = 'button' | 'submit' | 'reset';
317
318
 
318
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;
319
323
  /** Brand/status hue family. */
320
324
  readonly color: _angular_core.InputSignal<ButtonColor>;
321
325
  /** Fill pattern: solid | tonal | ghost | outline | text. All color×variant
@@ -452,6 +456,94 @@ declare class StatusDotComponent {
452
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>;
453
457
  }
454
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
+
455
547
  /**
456
548
  * Fixed-frame application layout: the host is pinned to the viewport
457
549
  * (`100dvh` + `overflow: hidden`) and ONLY the content region scrolls, so
@@ -509,6 +601,16 @@ declare class AppLayoutComponent {
509
601
  * landing as close as it allows. Only meaningful with `restoreScroll`.
510
602
  */
511
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>;
512
614
  /**
513
615
  * True only while the rail is an overlay. Gates the dialog semantics: above
514
616
  * the breakpoint the rail is an ordinary region, and a permanent
@@ -528,7 +630,7 @@ declare class AppLayoutComponent {
528
630
  protected closeRail(): void;
529
631
  private watchDesktopBreakpoint;
530
632
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppLayoutComponent, never>;
531
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppLayoutComponent, "ds-app-layout", never, { "topbarSpan": { "alias": "topbarSpan"; "required": false; "isSignal": true; }; "railOpen": { "alias": "railOpen"; "required": false; "isSignal": true; }; "railLabel": { "alias": "railLabel"; "required": false; "isSignal": true; }; "restoreScroll": { "alias": "restoreScroll"; "required": false; "isSignal": true; }; "restoreScrollTimeout": { "alias": "restoreScrollTimeout"; "required": false; "isSignal": true; }; }, { "railOpen": "railOpenChange"; }, never, ["[sidenav]", "[topbar]", "*"], true, never>;
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>;
532
634
  }
533
635
 
534
636
  /**
@@ -548,8 +650,8 @@ declare class AppLayoutComponent {
548
650
  * host element, and on `<ds-icon-button>` that is the wrapper, whose inner
549
651
  * `<button>` is what a screen reader actually reads. With a DS button, skip this
550
652
  * directive and bind its forwarding inputs instead —
551
- * `[ariaExpanded]="shell.railOverlay() ? shell.railOpen() : null"` and
552
- * `[ariaControls]="shell.railId"` off a `<ds-app-layout #shell>` template ref.
653
+ * `[ariaExpanded]="layout.railOverlay() ? layout.railOpen() : null"` and
654
+ * `[ariaControls]="layout.railId"` off a `<ds-app-layout #layout>` template ref.
553
655
  *
554
656
  * Both attributes are dropped while the rail is NOT an overlay: above the
555
657
  * breakpoint the rail is permanently in the layout, so `aria-expanded="false"`
@@ -567,77 +669,45 @@ declare class RailTriggerDirective {
567
669
  }
568
670
 
569
671
  /**
570
- * Owns the layout's content scroller. In the fixed-frame layout the window never
571
- * scrolls, so the router's built-in window-based scrolling no-ops — this service
572
- * resets the registered container to the top when navigation lands on a different
573
- * PATH instead. Provided by `ds-app-layout`, so routed pages can
574
- * `inject(LayoutScrollService)` and call `scrollToTop()` manually (e.g. list pages
575
- * that DO want the top after a filter change).
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.
576
677
  *
577
- * With `restoreScroll` on the layout it also restores the reader's place. Only
578
- * when ARMED, which is the whole design: going BACK to a list should return to
579
- * where the reader was, while following a link into a new screen should not.
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.
580
704
  */
581
- declare class LayoutScrollService {
582
- private readonly navigation;
705
+ declare class LayoutNavigationService {
583
706
  private readonly router;
584
- private readonly destroyRef;
585
- private readonly container;
586
- /**
587
- * The content scroller, once the layout has rendered it. Exposed so a host that
588
- * must measure or drive the scroll itself — a scroll-spy, a virtualizer — can
589
- * ask the layout for it instead of guessing the layout's internal markup with
590
- * `document.querySelector`.
591
- */
592
- readonly scroller: _angular_core.Signal<Element | null>;
593
- private restoreTimeoutMs;
594
- private armed;
595
- private pendingOffset;
596
- private endRestore;
597
- private firstNavigation;
598
- constructor();
599
- /**
600
- * Wiring, called by `ds-app-layout` once its content region exists. Public only
601
- * because the component and the service sit in different files - a consumer has
602
- * no reason to call it, and calling it points the service at the wrong element.
603
- */
604
- setScrollContainer(element: Element): void;
605
- /** Wiring: `ds-app-layout` mirrors its `restoreScroll` inputs through here. */
606
- configureRestore(timeoutMs: number | null): void;
607
- scrollToTop(): void;
608
- /**
609
- * Scroll the content region to an absolute offset. Assigns `scrollTop` rather
610
- * than calling `scrollTo`, so a themed `scroll-behavior: smooth` cannot turn a
611
- * positioning jump into an animation.
612
- */
613
- scrollTo(top: number): void;
614
- /**
615
- * Take the offset this navigation is going to restore, and cancel the restore.
616
- *
617
- * For a host that renders its own scroll position — a virtualizer needs the
618
- * offset BEFORE it decides which rows to build, so letting the service assign
619
- * `scrollTop` afterwards would scroll a list that has not been built yet.
620
- * Returns null when nothing is pending, which is every navigation that is not a
621
- * back.
622
- */
623
- consumePendingOffset(): number | null;
624
- /**
625
- * Optional accelerator: tell the layout the content for this route is in the
626
- * DOM. Without it the restore still lands — it waits for the container to grow
627
- * and clamps at the deadline — but a host that knows when its data arrived can
628
- * end the wait early instead of paying the growth watch.
629
- */
630
- contentReady(): void;
631
- private onNavigationStart;
632
- private onNavigationEnd;
633
- private beginRestore;
634
- private applyClamped;
635
- private finishRestore;
636
- private read;
637
- private remember;
638
- private recall;
639
- static ɵfac: _angular_core.ɵɵFactoryDeclaration<LayoutScrollService, never>;
640
- static ɵprov: _angular_core.ɵɵInjectableDeclaration<LayoutScrollService>;
707
+ readonly pathChanged: Observable<string>;
708
+ private samePage;
709
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<LayoutNavigationService, never>;
710
+ static ɵprov: _angular_core.ɵɵInjectableDeclaration<LayoutNavigationService>;
641
711
  }
642
712
 
643
713
  type CardElevation = 'flat' | 'raised' | 'hover' | 'interactive';
@@ -670,22 +740,29 @@ declare class BrandNameDirective {
670
740
  * content fits. Here the host is the only one, and it also carries the safe-area
671
741
  * insets a notched phone in landscape needs.
672
742
  *
673
- * The brand row follows `ds-sidenav`: a `brand` string gets a letter-mark tile
674
- * plus wordmark, `logoLetter` overrides the glyph, `[dsBrandName]` projects a
675
- * two-tone wordmark, and `[brand]` projects a real logo instead of the tile.
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.
676
753
  *
677
754
  * ```html
678
- * <ds-auth-shell brand="MyAdmin" logoLetter="A" tagline="Broker administration">
755
+ * <ds-auth-layout brand="MyAdmin" logoLetter="A" tagline="Broker administration">
679
756
  * <h1 class="title">Sign in</h1>
680
757
  * <form class="form">…</form>
681
758
  *
682
759
  * <p dsAuthSupport>
683
760
  * Need a hand? <a href="mailto:support@example.com">Contact support</a>
684
761
  * </p>
685
- * </ds-auth-shell>
762
+ * </ds-auth-layout>
686
763
  * ```
687
764
  */
688
- declare class AuthShellComponent {
765
+ declare class AuthLayoutComponent {
689
766
  /** Wordmark beside the letter-mark tile. For a logo image/SVG, project it into
690
767
  * the `[brand]` slot instead; for a two-tone wordmark use `[dsBrandName]`. */
691
768
  readonly brand: _angular_core.InputSignal<string>;
@@ -698,11 +775,24 @@ declare class AuthShellComponent {
698
775
  readonly cardElevation: _angular_core.InputSignal<CardElevation>;
699
776
  /** Card padding, passed through to `ds-card`. `md` tightens a short form. */
700
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">;
701
787
  /** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
702
788
  protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
703
789
  protected readonly hasBrandName: _angular_core.Signal<boolean>;
704
- static ɵfac: _angular_core.ɵɵFactoryDeclaration<AuthShellComponent, never>;
705
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AuthShellComponent, "ds-auth-shell", never, { "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "logoLetter": { "alias": "logoLetter"; "required": false; "isSignal": true; }; "tagline": { "alias": "tagline"; "required": false; "isSignal": true; }; "cardElevation": { "alias": "cardElevation"; "required": false; "isSignal": true; }; "cardPadding": { "alias": "cardPadding"; "required": false; "isSignal": true; }; }, {}, ["brandNameRef"], ["[brand]", "[dsBrandName]", "*", "[dsAuthSupport]"], true, never>;
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>;
706
796
  }
707
797
 
708
798
  /**
@@ -778,6 +868,59 @@ declare class FilterBarComponent {
778
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>;
779
869
  }
780
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>;
922
+ }
923
+
781
924
  type AvatarSize = 'xs' | DsSize;
782
925
  type AvatarStatus = 'online' | 'offline' | 'away' | 'busy';
783
926
 
@@ -872,9 +1015,18 @@ declare class CardComponent {
872
1015
  }
873
1016
 
874
1017
  declare class StatComponent {
1018
+ constructor();
875
1019
  /** Metric name shown above the value. */
876
1020
  readonly label: _angular_core.InputSignal<string>;
877
- /** 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. */
878
1030
  readonly value: _angular_core.InputSignal<string | number>;
879
1031
  /** Change amount; sign drives the up/down arrow and color. */
880
1032
  readonly delta: _angular_core.InputSignal<number | null>;
@@ -894,7 +1046,7 @@ declare class StatComponent {
894
1046
  protected readonly deltaIcon: _angular_core.Signal<"arrowUp" | "arrowDown" | null>;
895
1047
  protected readonly deltaText: _angular_core.Signal<string>;
896
1048
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<StatComponent, never>;
897
- 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>;
898
1050
  }
899
1051
 
900
1052
  declare class TabComponent {
@@ -933,6 +1085,27 @@ declare class TabsComponent {
933
1085
  /** Controls whether the tab list and panel are stacked horizontally (default)
934
1086
  or the tab list runs vertically beside the panel. */
935
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>;
936
1109
  /** Emitted when a close button is clicked. Carries the tab's value input, or
937
1110
  its label when value is not set. The host is responsible for removing the
938
1111
  tab from its list. */
@@ -940,6 +1113,16 @@ declare class TabsComponent {
940
1113
  private readonly host;
941
1114
  private readonly uid;
942
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;
943
1126
  /** Tracks which tab indices have ever been activated (for lazy rendering). */
944
1127
  private readonly activatedIndices;
945
1128
  protected tabId(index: number): string;
@@ -955,7 +1138,7 @@ declare class TabsComponent {
955
1138
  Arrow axis follows orientation: Left/Right for horizontal, Up/Down for vertical. */
956
1139
  protected onKeydown(event: KeyboardEvent, index: number): void;
957
1140
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabsComponent, never>;
958
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabsComponent, "ds-tabs", never, { "selectedIndex": { "alias": "selectedIndex"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "scrollable": { "alias": "scrollable"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; }, { "selectedIndex": "selectedIndexChange"; "tabClosed": "tabClosed"; }, ["tabs"], never, true, never>;
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>;
959
1142
  }
960
1143
 
961
1144
  type FieldMessageState = 'default' | 'error' | 'warning' | 'success';
@@ -997,6 +1180,20 @@ interface DsFieldMessage {
997
1180
  declare abstract class DsControlValueAccessor<T> implements ControlValueAccessor {
998
1181
  /** The component's two-way value model. */
999
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;
1000
1197
  /** Driven by the forms API via `setDisabledState`. */
1001
1198
  protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
1002
1199
  protected readonly touchedSelf: _angular_core.WritableSignal<boolean>;
@@ -1012,7 +1209,7 @@ declare abstract class DsControlValueAccessor<T> implements ControlValueAccessor
1012
1209
  registerOnTouched(fn: () => void): void;
1013
1210
  setDisabledState(isDisabled: boolean): void;
1014
1211
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsControlValueAccessor<any>, never>;
1015
- 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>;
1016
1213
  }
1017
1214
  /**
1018
1215
  * Shared `ControlValueAccessor` for DS boolean controls (checkbox, switch)
@@ -1024,6 +1221,16 @@ declare abstract class DsControlValueAccessor<T> implements ControlValueAccessor
1024
1221
  declare abstract class DsBooleanControlValueAccessor implements ControlValueAccessor {
1025
1222
  /** The component's two-way checked model. */
1026
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;
1027
1234
  /** Driven by the forms API via `setDisabledState`. */
1028
1235
  protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
1029
1236
  protected readonly touchedSelf: _angular_core.WritableSignal<boolean>;
@@ -1039,13 +1246,16 @@ declare abstract class DsBooleanControlValueAccessor implements ControlValueAcce
1039
1246
  registerOnTouched(fn: () => void): void;
1040
1247
  setDisabledState(isDisabled: boolean): void;
1041
1248
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsBooleanControlValueAccessor, never>;
1042
- 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>;
1043
1250
  }
1044
1251
 
1045
1252
  type InputType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search';
1046
1253
 
1047
1254
  declare class InputComponent extends DsControlValueAccessor<string> {
1048
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;
1049
1259
  /** Text value, two-way bound. */
1050
1260
  readonly value: _angular_core.ModelSignal<string>;
1051
1261
  /** Native input type — also affects the default clear button and password toggle. */
@@ -1080,6 +1290,12 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1080
1290
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1081
1291
  /** Prevents editing while still allowing focus and selection. */
1082
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>;
1083
1299
  /** Applies error styling and marks the field `aria-invalid`. */
1084
1300
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1085
1301
  /** Applies success styling to the field. */
@@ -1097,9 +1313,9 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1097
1313
  /** Native `name` attribute. */
1098
1314
  readonly name: _angular_core.InputSignal<string | null>;
1099
1315
  /** Native `min` attribute — applies when `type="number"`. */
1100
- readonly min: _angular_core.InputSignal<number | null>;
1316
+ readonly min: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
1101
1317
  /** Native `max` attribute — applies when `type="number"`. */
1102
- readonly max: _angular_core.InputSignal<number | null>;
1318
+ readonly max: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
1103
1319
  /** Native `step` attribute — applies when `type="number"`. */
1104
1320
  readonly step: _angular_core.InputSignal<number | null>;
1105
1321
  /** Native autocomplete token (e.g. "email", "current-password"). */
@@ -1116,7 +1332,11 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1116
1332
  readonly ariaDescribedBy: _angular_core.InputSignal<string | null>;
1117
1333
  /** Hard character cap — applies the native maxlength attribute and shows a
1118
1334
  * live "{current}/{max}" counter below the field. */
1119
- 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>;
1120
1340
  /** Mobile keyboard hints — forwarded to the native input as attributes. */
1121
1341
  readonly enterKeyHint: _angular_core.InputSignal<"search" | "next" | "enter" | "done" | "go" | "previous" | "send" | null>;
1122
1342
  /** Native `inputmode` attribute — hints the on-screen keyboard layout. */
@@ -1136,6 +1356,9 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1136
1356
  /** Whether the password is currently shown as plain text, two-way bound. */
1137
1357
  readonly passwordVisible: _angular_core.ModelSignal<boolean>;
1138
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>;
1139
1362
  protected readonly uid: string;
1140
1363
  protected readonly hintId: _angular_core.Signal<string | null>;
1141
1364
  protected readonly describedBy: _angular_core.Signal<string | null>;
@@ -1157,16 +1380,16 @@ declare class InputComponent extends DsControlValueAccessor<string> {
1157
1380
  focus(options?: FocusOptions): void;
1158
1381
  protected clear(): void;
1159
1382
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<InputComponent, never>;
1160
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<InputComponent, "ds-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "floating": { "alias": "floating"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "enterKeyHint": { "alias": "enterKeyHint"; "required": false; "isSignal": true; }; "inputMode": { "alias": "inputMode"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "passwordToggle": { "alias": "passwordToggle"; "required": false; "isSignal": true; }; "passwordVisible": { "alias": "passwordVisible"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "blurred": "blurred"; "passwordVisible": "passwordVisibleChange"; }, never, ["[dsInputPrefix]", "[dsInputSuffix]"], true, never>;
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>;
1161
1384
  }
1162
1385
 
1163
1386
  declare class NumberStepperComponent {
1164
1387
  /** Current numeric value, two-way bound. */
1165
1388
  readonly value: _angular_core.ModelSignal<number>;
1166
1389
  /** Lower bound — the decrement button and typed input clamp to it. */
1167
- readonly min: _angular_core.InputSignal<number>;
1390
+ readonly min: _angular_core.InputSignalWithTransform<number, number | undefined>;
1168
1391
  /** Upper bound — the increment button and typed input clamp to it; unbounded when null. */
1169
- readonly max: _angular_core.InputSignal<number | null>;
1392
+ readonly max: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
1170
1393
  /** Amount added or subtracted per increment/decrement. */
1171
1394
  readonly step: _angular_core.InputSignal<number>;
1172
1395
  /** Control height — sm/md/lg. */
@@ -1221,6 +1444,12 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
1221
1444
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1222
1445
  /** Prevents editing while still allowing focus and selection. */
1223
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>;
1224
1453
  /** Applies error styling and marks the field `aria-invalid`. */
1225
1454
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1226
1455
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
@@ -1243,7 +1472,14 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
1243
1472
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
1244
1473
  /** Hard character cap — applies the native maxlength attribute and shows a
1245
1474
  * live "{current}/{max}" counter below the field. */
1246
- 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>;
1247
1483
  protected readonly uid: string;
1248
1484
  protected readonly hintId: _angular_core.Signal<string | null>;
1249
1485
  private readonly fieldMessage;
@@ -1262,10 +1498,13 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
1262
1498
  * deliberately, e.g. focusing the first invalid field on a failed submit. */
1263
1499
  focus(options?: FocusOptions): void;
1264
1500
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextareaComponent, never>;
1265
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextareaComponent, "ds-textarea", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "autosize": { "alias": "autosize"; "required": false; "isSignal": true; }; "minRows": { "alias": "minRows"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "resize": { "alias": "resize"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
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>;
1266
1502
  }
1267
1503
 
1268
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;
1269
1508
  /** Search text, two-way bound. */
1270
1509
  readonly value: _angular_core.ModelSignal<string>;
1271
1510
  /** Placeholder shown when empty. */
@@ -1326,6 +1565,9 @@ declare function isSelectOptionGroup(item: SelectItem): item is SelectOptionGrou
1326
1565
 
1327
1566
  declare class SelectComponent extends DsControlValueAccessor<string> implements OnDestroy {
1328
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;
1329
1571
  private readonly vcr;
1330
1572
  private readonly host;
1331
1573
  protected readonly preview: DsStaticPreview;
@@ -1343,6 +1585,12 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1343
1585
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1344
1586
  /** Prevents opening the dropdown while still allowing focus. */
1345
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>;
1346
1594
  /** Applies error styling and marks the trigger `aria-invalid`. */
1347
1595
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1348
1596
  /** Helper text shown below the trigger. */
@@ -1419,7 +1667,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1419
1667
  private firstEnabledIndex;
1420
1668
  private lastEnabledIndex;
1421
1669
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
1422
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
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: {}; }]>;
1423
1671
  }
1424
1672
 
1425
1673
  /**
@@ -1447,11 +1695,59 @@ declare class CellTemplateDirective {
1447
1695
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CellTemplateDirective, "[dsCellTemplate]", never, { "dsCellTemplate": { "alias": "dsCellTemplate"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
1448
1696
  }
1449
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
+
1450
1746
  /**
1451
1747
  * Who sorts a `ds-table`.
1452
1748
  *
1453
- * - `'client'` (default) — the table reorders `data()` itself.
1454
- * - `'server'` — the table only emits `sortChange`; the host reorders.
1749
+ * - `'server'` (default) — the table only emits `sortChange`; the host reorders.
1750
+ * - `'client'` — the table reorders `data()` itself, for a table holding every row.
1455
1751
  * - `'none'` — nothing sorts, and `sortable` columns render no affordance rather
1456
1752
  * than a control that does nothing.
1457
1753
  *
@@ -1459,6 +1755,18 @@ declare class CellTemplateDirective {
1459
1755
  * marked `sortable` on a table with no sorting drew a live-looking header that
1460
1756
  * did nothing, and no type or dev check could catch it.
1461
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';
1462
1770
  type TableSortMode = 'client' | 'server' | 'none';
1463
1771
 
1464
1772
  interface TableColumn<T = unknown> {
@@ -1572,6 +1880,17 @@ declare class TableComponent<T extends object> {
1572
1880
  * (unsorted); pass ['asc','desc'] to forbid the unsorted state (e.g.
1573
1881
  * server-paged lists). */
1574
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>;
1575
1894
  /** Number of shimmer rows rendered while `loading` is `'skeleton'`. */
1576
1895
  readonly skeletonRows: _angular_core.InputSignal<number>;
1577
1896
  /** Accessible name for the table (rendered as a visually-hidden caption).
@@ -1620,12 +1939,24 @@ declare class TableComponent<T extends object> {
1620
1939
  readonly exportButton: _angular_core.InputSignalWithTransform<boolean, unknown>;
1621
1940
  /** Filename the export button downloads as. */
1622
1941
  readonly exportFilename: _angular_core.InputSignal<string>;
1623
- /** Rows to export instead of what the table holds. A server-paged table only
1624
- * HAS the current page, so exporting without this silently exports one page —
1625
- * return the whole set here and the button awaits it. */
1626
- readonly exportFetcher: _angular_core.InputSignal<(() => Promise<readonly T[]>) | null>;
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>;
1627
1955
  /** True while `exportFetcher` is in flight, so the button can disable itself. */
1628
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>;
1629
1960
  /** Keeps the horizontal scrollbar reachable on tall tables: the scroll
1630
1961
  * container's native bar is hidden and a proxy stuck to the bottom of the
1631
1962
  * nearest scroll ancestor mirrors it both ways. Off by default. */
@@ -1636,6 +1967,11 @@ declare class TableComponent<T extends object> {
1636
1967
  readonly page: _angular_core.ModelSignal<number>;
1637
1968
  /** Selectable page-size choices shown in the pagination control. */
1638
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>;
1639
1975
  /** Server-side total row count. `null` (default) = client paging: the table
1640
1976
  * slices `data()` itself and the pager counts the rows in hand. When set, the
1641
1977
  * host has already sliced to one page — the pager uses this count and the
@@ -1644,10 +1980,24 @@ declare class TableComponent<T extends object> {
1644
1980
  /** Scroll the table into view on a page change (opt-in) — keeps a bottom
1645
1981
  * pager from leaving the viewport on the previous page's last rows. */
1646
1982
  readonly scrollToTopOnPageChange: _angular_core.InputSignalWithTransform<boolean, unknown>;
1647
- /** Who sorts — see `TableSortMode`. Unset resolves to `'client'`, so a column
1648
- * marked `sortable` always does something; declare `'server'` when the host
1649
- * reorders, or `'none'` to drop the affordance entirely. */
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. */
1650
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>;
1651
2001
  protected readonly sortModeResolved: _angular_core.Signal<TableSortMode>;
1652
2002
  /** Pin the first data column (and the select column) on horizontal scroll. */
1653
2003
  readonly stickyFirstColumn: _angular_core.InputSignalWithTransform<boolean, unknown>;
@@ -1665,6 +2015,23 @@ declare class TableComponent<T extends object> {
1665
2015
  /** Row height in px in virtual mode. Must match what the rows actually
1666
2016
  * measure, so it drives the CSS height rather than merely describing it. */
1667
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
+ }>;
1668
2035
  /** Fires with the row on click (or Enter/Space when `rowInteractive`). */
1669
2036
  readonly rowClicked: _angular_core.OutputEmitterRef<T>;
1670
2037
  /** Fires whenever sort key/direction changes, in every `sortMode` but `'none'`. */
@@ -1733,17 +2100,31 @@ declare class TableComponent<T extends object> {
1733
2100
  /** The column whose filter menu is open — drives the distinct-value list. */
1734
2101
  protected readonly filterColumn: _angular_core.WritableSignal<TableColumn<T> | null>;
1735
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. */
1736
2109
  protected hasColumnFilter(col: TableColumn<T>): boolean;
1737
2110
  /** A column is "actively filtered" when at least one of its values is unchecked. */
1738
2111
  protected isColumnFiltered(col: TableColumn<T>): boolean;
1739
- private distinctValuesOf;
2112
+ /** The checklist's domain: what the host declared, else what is in hand. */
2113
+ private optionsFor;
1740
2114
  /** Distinct values of the open column, narrowed by the popover search box. */
1741
- protected readonly filterValues: _angular_core.Signal<string[]>;
2115
+ protected readonly filterValues: _angular_core.Signal<readonly string[]>;
1742
2116
  protected readonly filterSelectedCount: _angular_core.Signal<number>;
1743
2117
  protected isFilterValueChecked(value: string): boolean;
1744
2118
  protected onColumnFilterClick(col: TableColumn<T>, event: Event): void;
1745
2119
  protected onFilterSearch(event: Event): void;
1746
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
+ };
1747
2128
  protected clearColumnFilter(): void;
1748
2129
  private readonly injector;
1749
2130
  private readonly editInput;
@@ -1757,13 +2138,41 @@ declare class TableComponent<T extends object> {
1757
2138
  protected onEditInput(event: Event): void;
1758
2139
  protected commitEdit(row: T, col: TableColumn<T>): void;
1759
2140
  protected cancelEdit(): void;
2141
+ private static readonly RESIZE_STEP;
2142
+ private static readonly RESIZE_PAGE;
1760
2143
  private static readonly MIN_COLUMN_WIDTH;
1761
2144
  private resizeState;
1762
2145
  /** Resolved pixel width for a column: a drag override wins, else `column.width`. */
1763
2146
  protected columnWidth(col: TableColumn<T>): number | null;
1764
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;
1765
2163
  protected onResizeMove(event: PointerEvent): void;
1766
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;
1767
2176
  /** Client-side filter over the full data set — combines the `filterQuery`
1768
2177
  * substring search with any per-column set filters. Sorting and pagination
1769
2178
  * run on the filtered rows. */
@@ -1774,11 +2183,28 @@ declare class TableComponent<T extends object> {
1774
2183
  protected readonly pagedData: _angular_core.Signal<readonly T[]>;
1775
2184
  /** Rows actually rendered: paged when paginating, else sorted/raw data. */
1776
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;
1777
2199
  /** Virtual mode needs a bounded scroller to window against. */
1778
2200
  protected readonly virtualizing: _angular_core.Signal<boolean>;
1779
2201
  /** Drives the CSS row height from the same number the arithmetic uses, so the
1780
2202
  * two cannot drift — which would make every offset progressively wrong. */
1781
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>;
1782
2208
  /** `null` when not virtualizing — the row loop then walks `displayData()` whole. */
1783
2209
  protected readonly virtualWindow: _angular_core.Signal<{
1784
2210
  start: number;
@@ -1788,10 +2214,23 @@ declare class TableComponent<T extends object> {
1788
2214
  } | null>;
1789
2215
  /** The rows the template actually renders. */
1790
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
+ }[]>;
1791
2230
  /** Zebra striping cannot come from `:nth-child` while windowing — the parity
1792
2231
  * of a rendered row depends on its ABSOLUTE index, and the spacer rows are
1793
2232
  * children too. Matches `:nth-child(odd)`, which is 1-based. */
1794
- protected isStriped(rowIndex: number): boolean;
2233
+ protected isStriped(absoluteIndex: number): boolean;
1795
2234
  protected readonly allSelected: _angular_core.Signal<boolean>;
1796
2235
  protected readonly someSelected: _angular_core.Signal<boolean>;
1797
2236
  /** Select-all is page-scoped only when paginating. */
@@ -1812,12 +2251,23 @@ declare class TableComponent<T extends object> {
1812
2251
  /** Click on a `truncate` cell: when the text is actually clipped, show the
1813
2252
  * full value in a popover; otherwise let the click fall through to the row. */
1814
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;
1815
2264
  private readonly scrollWrap;
1816
2265
  private readonly hscrollProxy;
1817
2266
  protected readonly hscrollContentWidth: _angular_core.WritableSignal<number>;
1818
2267
  protected readonly hscrollNeeded: _angular_core.WritableSignal<boolean>;
1819
2268
  private readonly scrollTop;
1820
2269
  private readonly viewportHeight;
2270
+ private lastLazyRequest;
1821
2271
  constructor();
1822
2272
  private parseDurationMs;
1823
2273
  protected onRowMenuClick(row: T, event: Event): void;
@@ -1857,11 +2307,14 @@ declare class TableComponent<T extends object> {
1857
2307
  /** Export button handler: awaits `exportFetcher` when one is given, so a
1858
2308
  * server-paged table exports the whole set rather than the page it holds. */
1859
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;
1860
2313
  /** Deterministic per-cell width so skeleton rows look organic but stable
1861
2314
  * across re-renders. Mixes column key + row index into one of five widths. */
1862
2315
  protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
1863
2316
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
1864
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "animateHeight": { "alias": "animateHeight"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDir": { "alias": "sortDir"; "required": false; "isSignal": true; }; "sortingOrder": { "alias": "sortingOrder"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "activeRowId": { "alias": "activeRowId"; "required": false; "isSignal": true; }; "filterQuery": { "alias": "filterQuery"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "hiddenKeys": { "alias": "hiddenKeys"; "required": false; "isSignal": true; }; "resizableColumns": { "alias": "resizableColumns"; "required": false; "isSignal": true; }; "columnWidths": { "alias": "columnWidths"; "required": false; "isSignal": true; }; "reorderableColumns": { "alias": "reorderableColumns"; "required": false; "isSignal": true; }; "columnOrder": { "alias": "columnOrder"; "required": false; "isSignal": true; }; "persistLayout": { "alias": "persistLayout"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "exportButton": { "alias": "exportButton"; "required": false; "isSignal": true; }; "exportFilename": { "alias": "exportFilename"; "required": false; "isSignal": true; }; "exportFetcher": { "alias": "exportFetcher"; "required": false; "isSignal": true; }; "stickyScrollbar": { "alias": "stickyScrollbar"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "sortMode": { "alias": "sortMode"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualRowSize": { "alias": "virtualRowSize"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKey": "sortKeyChange"; "sortDir": "sortDirChange"; "columnFilters": "columnFiltersChange"; "hiddenKeys": "hiddenKeysChange"; "columnWidths": "columnWidthsChange"; "columnOrder": "columnOrderChange"; "pageSize": "pageSizeChange"; "page": "pageChange"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; }, ["cellTemplateDirectives"], ["[empty]", "[bulk-actions]"], true, never>;
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>;
1865
2318
  }
1866
2319
 
1867
2320
  declare class PaginationComponent {
@@ -2013,6 +2466,9 @@ interface DayCell {
2013
2466
  isDisabled: boolean;
2014
2467
  }
2015
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;
2016
2472
  constructor();
2017
2473
  /** Field text for the DOM: fixed-width `_`-padded once any digit exists,
2018
2474
  * else '' (so an untouched field is genuinely empty — no error on blur,
@@ -2182,6 +2638,14 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
2182
2638
  protected open(moveFocusToGrid?: boolean): void;
2183
2639
  protected close(cause?: DsOverlayCloseCause): void;
2184
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
+ */
2185
2649
  protected onFieldClick(): void;
2186
2650
  private mobileEdit;
2187
2651
  protected onFieldInput(event: Event): void;
@@ -2249,12 +2713,21 @@ interface Cell<T> {
2249
2713
  /** Internal (not public API): Hours / Minutes / AM-PM listbox columns.
2250
2714
  * Reused by ds-time-picker's overlay and the date-picker time footer. */
2251
2715
  declare class TimeColumnsComponent {
2716
+ /** Current time as `HH:mm` (24h, always — `format` changes only what is DISPLAYED). */
2252
2717
  readonly value: _angular_core.InputSignal<string | null>;
2718
+ /** Display clock. `12h` adds an AM/PM column; the emitted value stays 24h either way. */
2253
2719
  readonly format: _angular_core.InputSignal<TimeFormat>;
2720
+ /** Minute granularity — 15 gives four rows an hour instead of sixty. */
2254
2721
  readonly minuteStep: _angular_core.InputSignalWithTransform<number, unknown>;
2722
+ /** Earliest selectable time, `HH:mm`. Earlier rows render disabled rather than being removed,
2723
+ * so the columns do not reflow as the bound changes. */
2255
2724
  readonly minTime: _angular_core.InputSignal<string | null>;
2725
+ /** Latest selectable time, `HH:mm`. */
2256
2726
  readonly maxTime: _angular_core.InputSignal<string | null>;
2727
+ /** Per-time predicate for what a range cannot express — booked slots, a lunch break.
2728
+ * Receives `HH:mm`; return true to disable. */
2257
2729
  readonly disabledTime: _angular_core.InputSignal<((time: string) => boolean) | null>;
2730
+ /** A complete time was picked, as `HH:mm`. Not emitted while only one column has moved. */
2258
2731
  readonly timeChange: _angular_core.OutputEmitterRef<string>;
2259
2732
  private readonly hourButtons;
2260
2733
  private readonly minuteButtons;
@@ -2424,14 +2897,29 @@ declare class BreadcrumbsComponent {
2424
2897
  readonly separator: _angular_core.InputSignal<IconName | null>;
2425
2898
  /** Whether crumbs render as links; falls back to `DS_CONFIG.breadcrumbs.clickable`, then `true`. */
2426
2899
  readonly clickable: _angular_core.InputSignal<boolean | null>;
2900
+ /**
2901
+ * Caps how many crumbs render, collapsing the middle into an ellipsis — the
2902
+ * first and the LAST always survive. Null (default) renders every crumb.
2903
+ *
2904
+ * Worth setting on any trail that can get deep: the row is `nowrap` with
2905
+ * `overflow: hidden`, so without a cap an overlong trail is clipped from the
2906
+ * END, which is the current page — the one crumb the reader needs most.
2907
+ */
2908
+ readonly maxItems: _angular_core.InputSignalWithTransform<number | null, number | null>;
2427
2909
  /** Fires when a clickable crumb with `href` is activated; default navigation is always prevented. */
2428
2910
  readonly navigate: _angular_core.OutputEmitterRef<BreadcrumbItem>;
2911
+ private readonly allItems;
2912
+ /**
2913
+ * What renders. The collapsed crumb carries no `href`, so it is inert rather
2914
+ * than a link to nowhere; its label is the count, which tells the reader how
2915
+ * much is hidden instead of just that something is.
2916
+ */
2429
2917
  protected readonly resolvedItems: _angular_core.Signal<BreadcrumbItem[]>;
2430
2918
  protected readonly effectiveSeparator: _angular_core.Signal<IconName>;
2431
2919
  protected readonly effectiveClickable: _angular_core.Signal<boolean>;
2432
2920
  protected onNav(event: Event, item: BreadcrumbItem): void;
2433
2921
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<BreadcrumbsComponent, never>;
2434
- 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>;
2922
+ 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>;
2435
2923
  }
2436
2924
 
2437
2925
  /**
@@ -2595,6 +3083,8 @@ declare class SidenavFooterComponent {
2595
3083
  readonly alertItems: _angular_core.InputSignal<readonly SidenavAlertItem[] | null>;
2596
3084
  /** Route for the account menu's "Your profile"; empty = the item is a no-op. */
2597
3085
  readonly profileRoute: _angular_core.InputSignal<string>;
3086
+ /** The collapse control was activated. The footer does not collapse itself — `ds-app-layout`
3087
+ * owns the rail state, so the host relays this. */
2598
3088
  readonly collapseToggled: _angular_core.OutputEmitterRef<void>;
2599
3089
  /** Emitted when the Alerts popover is opened, so the layout can mark-all-read. */
2600
3090
  readonly alertsOpened: _angular_core.OutputEmitterRef<void>;
@@ -2649,10 +3139,14 @@ declare class ModalComponent implements OnDestroy {
2649
3139
  readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
2650
3140
  /** Dialog title, shown in the header and used for `aria-labelledby`. */
2651
3141
  readonly title: _angular_core.InputSignal<string>;
3142
+ /** Secondary line under the title. Not part of the accessible name. */
3143
+ readonly subtitle: _angular_core.InputSignal<string | null>;
2652
3144
  /** Fires once the close (leave) animation finishes. */
2653
3145
  readonly closed: _angular_core.OutputEmitterRef<void>;
2654
3146
  /** Emit this yourself from a confirm action in the projected content — not fired by the modal itself. */
2655
3147
  readonly confirmed: _angular_core.OutputEmitterRef<void>;
3148
+ /** Draws the rules under the header and over the actions. Turning them off also tightens the vertical padding they were sized for. */
3149
+ readonly dividers: _angular_core.InputSignalWithTransform<boolean, unknown>;
2656
3150
  /** When false, clicking the scrim does not close the modal. */
2657
3151
  readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
2658
3152
  /** When true, neither backdrop click nor Escape closes the modal — only programmatic or explicit close button. */
@@ -2671,7 +3165,7 @@ declare class ModalComponent implements OnDestroy {
2671
3165
  protected onBackdrop(event: MouseEvent): void;
2672
3166
  protected onEscape(): void;
2673
3167
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalComponent, never>;
2674
- 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: {}; }]>;
3168
+ 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: {}; }]>;
2675
3169
  }
2676
3170
 
2677
3171
  declare class ModalCardComponent {
@@ -2681,8 +3175,12 @@ declare class ModalCardComponent {
2681
3175
  readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
2682
3176
  /** Card title, shown in the header and used for `aria-labelledby`. */
2683
3177
  readonly title: _angular_core.InputSignal<string>;
3178
+ /** Secondary line under the title. Not part of the accessible name. */
3179
+ readonly subtitle: _angular_core.InputSignal<string | null>;
2684
3180
  /** Shows the header close button. */
2685
3181
  readonly showClose: _angular_core.InputSignalWithTransform<boolean, unknown>;
3182
+ /** Draws the rules under the header and over the actions. Turning them off also tightens the vertical padding they were sized for. */
3183
+ readonly dividers: _angular_core.InputSignalWithTransform<boolean, unknown>;
2686
3184
  /** Icon badge shown next to the title. */
2687
3185
  readonly icon: _angular_core.InputSignal<IconName | null>;
2688
3186
  /** ARIA role for the dialog element. */
@@ -2693,7 +3191,7 @@ declare class ModalCardComponent {
2693
3191
  protected readonly classes: _angular_core.Signal<string>;
2694
3192
  protected onClose(): void;
2695
3193
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalCardComponent, never>;
2696
- 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>;
3194
+ 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>;
2697
3195
  }
2698
3196
 
2699
3197
  type ModalConfirmTone = 'default' | 'error';
@@ -2838,6 +3336,9 @@ declare class MenuItemComponent implements OnDestroy {
2838
3336
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
2839
3337
  /** Renders the item in an error/destructive style. */
2840
3338
  readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
3339
+ /** Renders the item muted — a secondary row like "Sign out" under a divider,
3340
+ * still actionable but not competing with the items above it. */
3341
+ readonly quiet: _angular_core.InputSignalWithTransform<boolean, unknown>;
2841
3342
  /** Optional submenu template — renders a nested `ds-menu` on hover / ArrowRight. */
2842
3343
  readonly submenu: _angular_core.InputSignal<TemplateRef<unknown> | null>;
2843
3344
  /** Fires on click, unless the item is disabled or opens a submenu. */
@@ -2868,7 +3369,7 @@ declare class MenuItemComponent implements OnDestroy {
2868
3369
  private clearOpenTimer;
2869
3370
  private clearCloseTimer;
2870
3371
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuItemComponent, never>;
2871
- 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>;
3372
+ 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>;
2872
3373
  }
2873
3374
 
2874
3375
  declare class MenuDividerComponent {
@@ -3331,6 +3832,9 @@ interface AutocompleteOptionGroup<T = unknown> {
3331
3832
  }
3332
3833
 
3333
3834
  declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<T | readonly T[] | null> implements OnDestroy {
3835
+ /** Segment of a ds-field-group: the group owns the border, radius and focus
3836
+ * ring, so .in-group strips this control back to its bare contents. */
3837
+ protected readonly inGroup: boolean;
3334
3838
  private readonly overlay;
3335
3839
  private readonly vcr;
3336
3840
  private readonly host;
@@ -3345,6 +3849,13 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
3345
3849
  readonly value: _angular_core.ModelSignal<T | readonly T[] | null>;
3346
3850
  /** Allows selecting more than one option, shown as removable tags. */
3347
3851
  readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
3852
+ /** Draws the trailing chevron. Turn it off for a search field, where an arrow
3853
+ * invites a click that would list everything instead of searching. */
3854
+ readonly showChevron: _angular_core.InputSignalWithTransform<boolean, unknown>;
3855
+ /** Caps the number of chips shown before collapsing the rest into "+N more" — 0/null shows all.
3856
+ * Same name and semantics as `ds-multi-select`: without it a trigger grows a
3857
+ * line per selection and pushes the rest of the form down the page. */
3858
+ readonly maxVisibleChips: _angular_core.InputSignalWithTransform<number | null, number | null>;
3348
3859
  /** Trigger height — sm/md/lg. */
3349
3860
  readonly size: _angular_core.InputSignal<DsSize>;
3350
3861
  /** Trigger width — `fill` stretches to the container, `content` hugs the value. */
@@ -3407,6 +3918,11 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
3407
3918
  /** Flat list of visible options used for keyboard navigation index. */
3408
3919
  protected readonly visibleOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
3409
3920
  protected readonly selectedTags: _angular_core.Signal<AutocompleteOption<T>[]>;
3921
+ /** What the trigger renders. Separate from `selectedTags`, which stays the
3922
+ * full selection: Backspace removes the last SELECTED chip, and capping the
3923
+ * list it reads would silently make it remove the last VISIBLE one instead. */
3924
+ protected readonly visibleTags: _angular_core.Signal<AutocompleteOption<T>[]>;
3925
+ protected readonly overflowCount: _angular_core.Signal<number>;
3410
3926
  protected readonly displayLabel: _angular_core.Signal<string>;
3411
3927
  protected readonly placeholderText: _angular_core.Signal<string>;
3412
3928
  protected isSelected(option: AutocompleteOption<T>): boolean;
@@ -3418,13 +3934,26 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
3418
3934
  protected onKeydown(event: KeyboardEvent): void;
3419
3935
  protected openPanel(): void;
3420
3936
  protected close(cause?: DsOverlayCloseCause): void;
3937
+ /**
3938
+ * Empties the field — both the selected value and the text the user typed.
3939
+ *
3940
+ * `value.set(null)` alone is not enough from outside: the typed query is
3941
+ * component state with no input bound to it, so the text stays on screen after
3942
+ * the value goes. That gap is why a host reaching for "reset after navigating"
3943
+ * ends up querying the inner `<input>` and dispatching a synthetic `input`
3944
+ * event.
3945
+ *
3946
+ * Deliberately does NOT move focus — the caller may be navigating away, and
3947
+ * stealing focus back into a field they just left is worse than leaving it.
3948
+ */
3949
+ clear(): void;
3421
3950
  ngOnDestroy(): void;
3422
3951
  protected onFilter(event: Event): void;
3423
3952
  protected onPick(option: AutocompleteOption<T>): void;
3424
3953
  protected onCreateNew(): void;
3425
3954
  protected remove(target: T): void;
3426
3955
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent<any>, never>;
3427
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionGroups": { "alias": "optionGroups"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "create": "create"; }, never, never, true, never>;
3956
+ 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>;
3428
3957
  }
3429
3958
 
3430
3959
  type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
@@ -3436,7 +3965,10 @@ type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
3436
3965
  type DividerSpacing = 'none' | 'sm' | 'md' | 'lg';
3437
3966
 
3438
3967
  declare class DividerComponent {
3968
+ /** `default` hairline · `strong` heavier rule · `vertical` for a row · `label` to carry
3969
+ * projected text in the middle of the line. */
3439
3970
  readonly variant: _angular_core.InputSignal<DividerVariant>;
3971
+ /** Vertical breathing room around the rule. `none` when the parent layout already owns the gap. */
3440
3972
  readonly spacing: _angular_core.InputSignal<DividerSpacing>;
3441
3973
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DividerComponent, never>;
3442
3974
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<DividerComponent, "ds-divider", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "spacing": { "alias": "spacing"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -3469,22 +4001,29 @@ type LayoutJustify = 'start' | 'center' | 'end' | 'between';
3469
4001
  type ContainerSize = DsSize | 'xl' | 'full';
3470
4002
 
3471
4003
  declare class StackComponent {
4004
+ /** Space between children. `null` inherits whatever the enclosing layout set. */
3472
4005
  readonly gap: _angular_core.InputSignal<LayoutGap | null>;
4006
+ /** Cross-axis alignment — horizontal, for a column. */
3473
4007
  readonly align: _angular_core.InputSignal<LayoutAlign | null>;
3474
4008
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<StackComponent, never>;
3475
4009
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<StackComponent, "ds-stack", never, { "gap": { "alias": "gap"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
3476
4010
  }
3477
4011
 
3478
4012
  declare class InlineComponent {
4013
+ /** Space between children. `null` inherits whatever the enclosing layout set. */
3479
4014
  readonly gap: _angular_core.InputSignal<LayoutGap | null>;
4015
+ /** Cross-axis alignment — vertical, for a row. */
3480
4016
  readonly align: _angular_core.InputSignal<LayoutAlign | null>;
4017
+ /** Main-axis distribution — horizontal, for a row. `between` pushes the ends apart. */
3481
4018
  readonly justify: _angular_core.InputSignal<LayoutJustify | null>;
4019
+ /** Let the row wrap onto more lines (default). `false` keeps one line and lets it overflow. */
3482
4020
  readonly wrap: _angular_core.InputSignalWithTransform<boolean, unknown>;
3483
4021
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<InlineComponent, never>;
3484
4022
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<InlineComponent, "ds-inline", never, { "gap": { "alias": "gap"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "justify": { "alias": "justify"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
3485
4023
  }
3486
4024
 
3487
4025
  declare class ContainerComponent {
4026
+ /** Max content width before the container centres itself. `full` removes the cap. */
3488
4027
  readonly size: _angular_core.InputSignal<ContainerSize>;
3489
4028
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ContainerComponent, never>;
3490
4029
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<ContainerComponent, "ds-container", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
@@ -4237,5 +4776,5 @@ declare class FieldClickFocusDirective {
4237
4776
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
4238
4777
  }
4239
4778
 
4240
- export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppLayoutComponent, AuthShellComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BodyScrollLockService, BottomSheetComponent, BrandNameDirective, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_ICON_REGISTRY, DS_TOAST_CONFIG, DS_TOAST_POSITION, DS_TOAST_POSITION_DEFAULT, DatePickerComponent, DescriptionItemComponent, DescriptionListComponent, DividerComponent, DrawerComponent, DropzoneComponent, DsOverlayCloseRef, DsStaticPreview, EmptyStateComponent, FieldClickFocusDirective, FilterBarComponent, FilterItemDirective, ICONS, IconButtonComponent, IconComponent, InlineComponent, InputComponent, LayoutScrollService, ListComponent, ListItemComponent, LoadingOverlayComponent, MenuComponent, MenuDividerComponent, MenuItemComponent, ModalCardComponent, ModalComponent, ModalService, MultiSelectComponent, NumberStepperComponent, OtpInputComponent, PageFooterComponent, PageHeaderComponent, PaginationComponent, PasswordRulesComponent, PopoverComponent, ProgressComponent, RADIO_GROUP, RadioComponent, RadioGroupComponent, RailTriggerDirective, ReserveMessagesDirective, SIDENAV, SearchComponent, SegmentedComponent, SelectComponent, SidenavComponent, SidenavFooterComponent, SidenavGroupComponent, SidenavItemComponent, SkeletonComponent, SliderComponent, SpinnerComponent, SplitButtonComponent, StackComponent, StatComponent, StatusDotComponent, StepperComponent, SwitchComponent, TabComponent, TableComponent, TabsComponent, TagComponent, TextareaComponent, TimePickerComponent, TimelineComponent, TimelineItemComponent, ToastComponent, ToastRegionComponent, ToastService, ToggleButtonComponent, TooltipDirective, TooltipPanelComponent, TopBarComponent, TreeComponent, W3wComponent, avatarTint, inheritDsConfig, initialsFrom, isSelectOptionGroup, passwordRulesMet, provideDsConfig, provideDsIcons, provideDsTheme };
4241
- export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteOption, AutocompleteOptionGroup, AutocompleteWidth, AvatarSize, AvatarStatus, AvatarTintOptions, BannerVariant, BreadcrumbItem, ButtonColor, ButtonType, ButtonVariant, CardElevation, CardPadding, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerSpacing, DividerVariant, DrawerPlacement, DropzoneFile, DropzoneFileState, DsConfig, DsIconRegistry, DsPasswordRule, DsPasswordRuleState, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, EmptyStateVariant, IconButtonType, IconButtonVariant, IconName, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectOption, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, SidenavAlertItem, SidenavContract, SidenavItemModel, SidenavSearchProvider, SidenavSearchResult, SortChangeEvent, SortDir, SplitButtonItem, SplitButtonVariant, StepperLabelPosition, StepperOrientation, TableCellEditEvent, TableColumn, TableRowAction, TableRowActionEvent, TableSortMode, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TimeFormat, TimePickerMode, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };
4779
+ 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 };
4780
+ 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 };