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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -98,6 +98,19 @@ declare const ICONS: {
98
98
  type IconName = keyof typeof ICONS | (string & {});
99
99
 
100
100
  interface DsConfig {
101
+ field?: {
102
+ /** Default for every field's `reserveMessage` — keeps a message line's worth
103
+ * of space even when empty. Default `false`. Setting `true` here applies to
104
+ * EVERY field in the injector's subtree, which is rarely what a whole app
105
+ * wants; prefer `dsReserveMessages` on the individual form that validates. */
106
+ reserveMessage?: boolean;
107
+ /** Fallback text per validation-error kind, for errors whose validator did
108
+ * not carry a `message` — Angular's built-ins never do, so this is where
109
+ * `required`, `minlength`, `email` and friends get their wording. A message
110
+ * on the error itself always wins, so one shared map here plus a per-case
111
+ * override at the validator covers both. Unmapped kinds warn in dev. */
112
+ errorMessages?: Record<string, string>;
113
+ };
101
114
  breadcrumbs?: {
102
115
  separator?: IconName;
103
116
  clickable?: boolean;
@@ -116,13 +129,29 @@ interface DsConfig {
116
129
  };
117
130
  }
118
131
  declare const DS_CONFIG: InjectionToken<DsConfig>;
119
- /** Provide DS-level defaults at the app root.
132
+ /** Provide DS-level defaults.
120
133
  *
121
134
  * providers: [provideDsConfig({ card: { padding: 'sm' } })]
122
135
  *
123
- * Component inputs (e.g. `<ds-card padding="lg">`) still win over the config.
136
+ * Works at the app root, on a `Route`, or on a component/directive — the
137
+ * config resolves through the element-injector chain, so a subtree can differ
138
+ * from the app. Component inputs (e.g. `<ds-card padding="lg">`) still win.
139
+ *
140
+ * A nested call MERGES with the config above it, section by section, so
141
+ * scoping one flag cannot silently drop unrelated app-level settings. Only the
142
+ * keys you name are replaced.
124
143
  */
125
144
  declare function provideDsConfig(config: DsConfig): Provider;
145
+ /**
146
+ * The factory body behind `provideDsConfig`, exported so a directive can put the
147
+ * provider in its metadata as a plain object literal. Calling `provideDsConfig`
148
+ * there instead would run at module-evaluation time, which makes the module
149
+ * side-effectful and costs the consumer its tree-shaking (measured: the whole
150
+ * library moved into ds-docs' eager chunk, +566 kB).
151
+ *
152
+ * Must be called from an injection context.
153
+ */
154
+ declare function inheritDsConfig(config: DsConfig): DsConfig;
126
155
 
127
156
  interface DsThemeOptions {
128
157
  /**
@@ -252,6 +281,36 @@ declare const DS_ICON_REGISTRY: InjectionToken<Readonly<Record<string, string>>>
252
281
  */
253
282
  declare function provideDsIcons(icons: DsIconRegistry): Provider;
254
283
 
284
+ /**
285
+ * Turns on `reserveMessage` for every DS field declared inside the host
286
+ * element, so a validated form holds its message rows without repeating the
287
+ * input on each control:
288
+ *
289
+ * ```html
290
+ * <form dsReserveMessages>
291
+ * <ds-input label="Email" />
292
+ * <ds-input label="Password" />
293
+ * </form>
294
+ * ```
295
+ *
296
+ * It provides `DS_CONFIG`, which merges with the config above it — scoping this
297
+ * one flag cannot drop unrelated app-level settings. A field's own
298
+ * `[reserveMessage]` still wins, so a single control can opt back out.
299
+ *
300
+ * The switch is the directive's PRESENCE, not an input: providers are resolved
301
+ * at construction, before inputs are set, so a bound value could not drive
302
+ * them. To turn it off for a subtree, provide the config directly:
303
+ * `provideDsConfig({ field: { reserveMessage: false } })`.
304
+ *
305
+ * Applies to fields DECLARED inside the host — projected content keeps the
306
+ * injector of the template it was written in, so wrapping `<ng-content>` in
307
+ * this directive does not reach the projected fields.
308
+ */
309
+ declare class ReserveMessagesDirective {
310
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<ReserveMessagesDirective, never>;
311
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ReserveMessagesDirective, "[dsReserveMessages]", never, {}, {}, never, never, true, never>;
312
+ }
313
+
255
314
  type ButtonColor = 'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning';
256
315
  type ButtonVariant = 'solid' | 'tonal' | 'ghost' | 'outline' | 'text';
257
316
  type ButtonType = 'button' | 'submit' | 'reset';
@@ -290,6 +349,9 @@ declare class ButtonComponent {
290
349
  /** ARIA `aria-expanded`, forwarded to the inner <button> — bind to the
291
350
  * overlay's open state on a trigger button. */
292
351
  readonly ariaExpanded: _angular_core.InputSignal<boolean | null>;
352
+ /** ARIA `aria-controls`, forwarded to the inner <button> — the id of the panel
353
+ * this button opens, e.g. `ds-app-layout`'s `railId`. */
354
+ readonly ariaControls: _angular_core.InputSignal<string | null>;
293
355
  /** Fires on click, unless `disabled` or `loading`. */
294
356
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
295
357
  /** The inner native <button>, exposed so overlay triggers can position
@@ -300,7 +362,7 @@ declare class ButtonComponent {
300
362
  constructor();
301
363
  protected onClick(event: MouseEvent): void;
302
364
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonComponent, never>;
303
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonComponent, "ds-button", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "trailingIcon": { "alias": "trailingIcon"; "required": false; "isSignal": true; }; "ariaHasPopup": { "alias": "ariaHasPopup"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["*", "[dsButtonSubtext]"], true, never>;
365
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonComponent, "ds-button", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "trailingIcon": { "alias": "trailingIcon"; "required": false; "isSignal": true; }; "ariaHasPopup": { "alias": "ariaHasPopup"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; "ariaControls": { "alias": "ariaControls"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["*", "[dsButtonSubtext]"], true, never>;
304
366
  }
305
367
 
306
368
  /** A single binary toggle button (pressed / not pressed) with an optional
@@ -345,13 +407,20 @@ declare class IconButtonComponent {
345
407
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
346
408
  /** Toggle state — renders the pressed/active look and sets aria-pressed. */
347
409
  readonly selected: _angular_core.InputSignalWithTransform<boolean, unknown>;
410
+ /** ARIA `aria-expanded`, forwarded to the inner `<button>` — bind to the open
411
+ * state when this button opens a panel. On the host element it would land on
412
+ * a non-focusable wrapper, which no screen reader reads. */
413
+ readonly ariaExpanded: _angular_core.InputSignal<boolean | null>;
414
+ /** ARIA `aria-controls`, forwarded to the inner `<button>` — the id of the
415
+ * panel this button opens, e.g. `ds-app-layout`'s `railId`. */
416
+ readonly ariaControls: _angular_core.InputSignal<string | null>;
348
417
  /** Fires on click, unless disabled. */
349
418
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
350
419
  protected readonly classes: _angular_core.Signal<string>;
351
420
  protected readonly iconSize: _angular_core.Signal<16 | 24 | 20>;
352
421
  protected onClick(event: MouseEvent): void;
353
422
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<IconButtonComponent, never>;
354
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<IconButtonComponent, "ds-icon-button", never, { "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": true; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, never, true, never>;
423
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<IconButtonComponent, "ds-icon-button", never, { "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": true; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; "ariaControls": { "alias": "ariaControls"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, never, true, never>;
355
424
  }
356
425
 
357
426
  declare class BadgeComponent {
@@ -398,11 +467,18 @@ declare class StatusDotComponent {
398
467
  * ```
399
468
  *
400
469
  * The layout renders the `<main>` landmark itself — do not nest another
401
- * `<main>` in the content. Scroll-to-top on navigation is built in
402
- * (`LayoutScrollService`); the content padding auto-compensates the native
403
- * scrollbar width so the right inset always equals the left one. The layout
404
- * requires the application router (`provideRouter`) because its scroll-to-top
405
- * service subscribes to navigation events.
470
+ * `<main>` in the content. Scroll-to-top is built in (`LayoutScrollService`)
471
+ * and fires when navigation changes the PATH, so a URL-driven list can page
472
+ * and filter without losing the reader's place; inject the service and call
473
+ * `scrollToTop()` for the changes that do want the top. The content padding
474
+ * auto-compensates the native scrollbar width so the right inset always
475
+ * equals the left one. The layout requires the application router
476
+ * (`provideRouter`) because its scroll-to-top service subscribes to
477
+ * navigation events.
478
+ *
479
+ * Below the `lg` breakpoint the rail becomes a modal overlay driven by
480
+ * `[(railOpen)]`; put the burger wherever the design wants it inside your own
481
+ * projected topbar.
406
482
  */
407
483
  declare class AppLayoutComponent {
408
484
  /**
@@ -411,34 +487,297 @@ declare class AppLayoutComponent {
411
487
  * topbar spans the full width and the rail + content sit below it.
412
488
  */
413
489
  readonly topbarSpan: _angular_core.InputSignal<"content" | "full">;
490
+ /**
491
+ * Whether the rail is open as an overlay. Only meaningful below the `lg`
492
+ * breakpoint — above it the rail is always in the layout and this is
493
+ * ignored. Two-way, so a burger in your topbar can drive it.
494
+ */
495
+ readonly railOpen: _angular_core.ModelSignal<boolean>;
496
+ /** Accessible name for the rail while it is a modal overlay. */
497
+ readonly railLabel: _angular_core.InputSignal<string>;
498
+ /**
499
+ * Remember the content scroll per path and restore it on the way BACK. Off by
500
+ * default: a layout that silently moved the scroll would surprise every existing
501
+ * consumer. Only a history traversal restores — following a link into a screen
502
+ * still lands at the top — plus a host that pushes its own "back to list" and
503
+ * says so with `state: { dsRestoreScroll: true }`, and the first navigation after
504
+ * a reload.
505
+ */
506
+ readonly restoreScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
507
+ /**
508
+ * How long to wait for the restored screen's content to grow tall enough before
509
+ * landing as close as it allows. Only meaningful with `restoreScroll`.
510
+ */
511
+ readonly restoreScrollTimeout: _angular_core.InputSignal<number>;
512
+ /**
513
+ * True only while the rail is an overlay. Gates the dialog semantics: above
514
+ * the breakpoint the rail is an ordinary region, and a permanent
515
+ * `role="dialog"` there would lie to a screen reader.
516
+ */
517
+ protected readonly compact: _angular_core.WritableSignal<boolean>;
518
+ /** Whether the rail is currently an overlay rather than part of the layout. */
519
+ readonly railOverlay: _angular_core.Signal<boolean>;
520
+ /** Id of the rail panel, for a trigger's `aria-controls`. */
521
+ readonly railId: string;
414
522
  private readonly layoutScroll;
523
+ private readonly navigation;
524
+ private readonly destroyRef;
415
525
  private readonly content;
416
526
  constructor();
527
+ /** Dismissal: Escape or the scrim. Restores focus, which navigation must not. */
528
+ protected closeRail(): void;
529
+ private watchDesktopBreakpoint;
417
530
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppLayoutComponent, never>;
418
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppLayoutComponent, "ds-app-layout", never, { "topbarSpan": { "alias": "topbarSpan"; "required": false; "isSignal": true; }; }, {}, never, ["[sidenav]", "[topbar]", "*"], true, never>;
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>;
419
532
  }
420
533
 
421
534
  /**
422
- * Owns the layout's content scroller. In the fixed-frame layout the window
423
- * never scrolls, so the router's built-in window-based scrolling no-ops —
424
- * this service resets the registered container to the top after every
425
- * navigation instead. Provided by `ds-app-layout`, so routed pages can
426
- * `inject(LayoutScrollService)` and call `scrollToTop()` manually (e.g. list
427
- * pages resetting scroll on filter changes). Per-route scroll restoration is
428
- * a documented growth point — add it here if a page ever needs
429
- * back-navigation scroll memory.
535
+ * Wires a consumer's own burger to the layout's overlay rail: toggles
536
+ * `[(railOpen)]` on click and keeps `aria-expanded` / `aria-controls` in sync, so
537
+ * the trigger and the panel are related for a screen reader.
538
+ *
539
+ * ```html
540
+ * <ds-app-layout>
541
+ * <ds-topbar topbar>
542
+ * <button dsRailTrigger type="button" aria-label="Navigation">☰</button>
543
+ * </ds-topbar>
544
+ * </ds-app-layout>
545
+ * ```
546
+ *
547
+ * PUT IT ON THE FOCUSABLE CONTROL, not on a wrapper: the attributes go on the
548
+ * host element, and on `<ds-icon-button>` that is the wrapper, whose inner
549
+ * `<button>` is what a screen reader actually reads. With a DS button, skip this
550
+ * directive and bind its forwarding inputs instead —
551
+ * `[ariaExpanded]="shell.railOverlay() ? shell.railOpen() : null"` and
552
+ * `[ariaControls]="shell.railId"` off a `<ds-app-layout #shell>` template ref.
553
+ *
554
+ * Both attributes are dropped while the rail is NOT an overlay: above the
555
+ * breakpoint the rail is permanently in the layout, so `aria-expanded="false"`
556
+ * would state the opposite of what the user sees.
557
+ *
558
+ * Must sit inside a `ds-app-layout` — the injector walks the declaration tree, so
559
+ * anywhere in the projected chrome works. Outside one, DI fails naming
560
+ * `AppLayoutComponent`, which says what is missing.
561
+ */
562
+ declare class RailTriggerDirective {
563
+ protected readonly layout: AppLayoutComponent;
564
+ protected toggle(): void;
565
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<RailTriggerDirective, never>;
566
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<RailTriggerDirective, "[dsRailTrigger]", never, {}, {}, never, never, true, never>;
567
+ }
568
+
569
+ /**
570
+ * Owns the layout's content scroller. In the fixed-frame layout the window never
571
+ * scrolls, so the router's built-in window-based scrolling no-ops — this service
572
+ * resets the registered container to the top when navigation lands on a different
573
+ * PATH instead. Provided by `ds-app-layout`, so routed pages can
574
+ * `inject(LayoutScrollService)` and call `scrollToTop()` manually (e.g. list pages
575
+ * that DO want the top after a filter change).
576
+ *
577
+ * With `restoreScroll` on the layout it also restores the reader's place. Only
578
+ * when ARMED, which is the whole design: going BACK to a list should return to
579
+ * where the reader was, while following a link into a new screen should not.
430
580
  */
431
581
  declare class LayoutScrollService {
582
+ private readonly navigation;
432
583
  private readonly router;
433
584
  private readonly destroyRef;
434
- private scrollContainer;
585
+ private readonly container;
586
+ /**
587
+ * The content scroller, once the layout has rendered it. Exposed so a host that
588
+ * must measure or drive the scroll itself — a scroll-spy, a virtualizer — can
589
+ * ask the layout for it instead of guessing the layout's internal markup with
590
+ * `document.querySelector`.
591
+ */
592
+ readonly scroller: _angular_core.Signal<Element | null>;
593
+ private restoreTimeoutMs;
594
+ private armed;
595
+ private pendingOffset;
596
+ private endRestore;
597
+ private firstNavigation;
435
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
+ */
436
604
  setScrollContainer(element: Element): void;
605
+ /** Wiring: `ds-app-layout` mirrors its `restoreScroll` inputs through here. */
606
+ configureRestore(timeoutMs: number | null): void;
437
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;
438
639
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<LayoutScrollService, never>;
439
640
  static ɵprov: _angular_core.ɵɵInjectableDeclaration<LayoutScrollService>;
440
641
  }
441
642
 
643
+ type CardElevation = 'flat' | 'raised' | 'hover' | 'interactive';
644
+ type CardPadding = 'none' | 'sm' | 'md' | 'lg';
645
+
646
+ /**
647
+ * Marks projected wordmark markup for `ds-sidenav`: when present, the sidenav
648
+ * renders the projected content inside `.brand-name` instead of the plain
649
+ * `brand` text (two-tone wordmarks, inline logos etc. stay consumer-side).
650
+ *
651
+ * Interplay: projecting `[dsBrandName]` is enough to render the brand row and
652
+ * its wordmark even without a string `brand`, but it only supplies the
653
+ * wordmark — the letter-mark tile still comes from `logoLetter` (or the first
654
+ * letter of `brand`), so an empty `brand` + projection renders the wordmark
655
+ * with no tile.
656
+ */
657
+ declare class BrandNameDirective {
658
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<BrandNameDirective, never>;
659
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BrandNameDirective, "[dsBrandName]", never, {}, {}, never, never, true, never>;
660
+ }
661
+
662
+ /**
663
+ * Scaffold for the UNauthenticated screens — sign-in, forgot password, reset,
664
+ * MFA — and the counterpart to `ds-app-layout`, which only ever covers the
665
+ * screens behind the login.
666
+ *
667
+ * Brand row, tagline, card and support footer are the same four parts in every
668
+ * consumer that has hand-rolled this. What the ports get wrong is the full-height
669
+ * box: they nest a `100vh` wrapper inside a `100dvh` one and scroll a page whose
670
+ * content fits. Here the host is the only one, and it also carries the safe-area
671
+ * insets a notched phone in landscape needs.
672
+ *
673
+ * The brand row follows `ds-sidenav`: a `brand` string gets a letter-mark tile
674
+ * plus wordmark, `logoLetter` overrides the glyph, `[dsBrandName]` projects a
675
+ * two-tone wordmark, and `[brand]` projects a real logo instead of the tile.
676
+ *
677
+ * ```html
678
+ * <ds-auth-shell brand="MyAdmin" logoLetter="A" tagline="Broker administration">
679
+ * <h1 class="title">Sign in</h1>
680
+ * <form class="form">…</form>
681
+ *
682
+ * <p dsAuthSupport>
683
+ * Need a hand? <a href="mailto:support@example.com">Contact support</a>
684
+ * </p>
685
+ * </ds-auth-shell>
686
+ * ```
687
+ */
688
+ declare class AuthShellComponent {
689
+ /** Wordmark beside the letter-mark tile. For a logo image/SVG, project it into
690
+ * the `[brand]` slot instead; for a two-tone wordmark use `[dsBrandName]`. */
691
+ readonly brand: _angular_core.InputSignal<string>;
692
+ /** Letter-mark glyph when it differs from the brand's first letter (e.g. an
693
+ * "A" tile beside the "MyAdmin" wordmark). Empty = first letter of `brand`. */
694
+ readonly logoLetter: _angular_core.InputSignal<string>;
695
+ /** One line under the wordmark naming the product or audience. */
696
+ readonly tagline: _angular_core.InputSignal<string>;
697
+ /** Card treatment. `flat` suits a screen that already sits on a tinted canvas. */
698
+ readonly cardElevation: _angular_core.InputSignal<CardElevation>;
699
+ /** Card padding, passed through to `ds-card`. `md` tightens a short form. */
700
+ readonly cardPadding: _angular_core.InputSignal<CardPadding>;
701
+ /** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
702
+ protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
703
+ protected readonly hasBrandName: _angular_core.Signal<boolean>;
704
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<AuthShellComponent, never>;
705
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AuthShellComponent, "ds-auth-shell", never, { "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "logoLetter": { "alias": "logoLetter"; "required": false; "isSignal": true; }; "tagline": { "alias": "tagline"; "required": false; "isSignal": true; }; "cardElevation": { "alias": "cardElevation"; "required": false; "isSignal": true; }; "cardPadding": { "alias": "cardPadding"; "required": false; "isSignal": true; }; }, {}, ["brandNameRef"], ["[brand]", "[dsBrandName]", "*", "[dsAuthSupport]"], true, never>;
706
+ }
707
+
708
+ /**
709
+ * One filter inside `ds-filter-bar`, with the width it should occupy:
710
+ * `<ng-template [dsFilterItem]="220"> <ds-date-picker … /> </ng-template>`.
711
+ *
712
+ * A template rather than plain projection because the bar has to MOVE the filters
713
+ * that do not fit into its overflow panel, and projected DOM cannot be relocated
714
+ * — it renders where it was projected. The cost is that crossing the boundary
715
+ * destroys and re-creates the view, so a control's internal state (an open panel,
716
+ * focus) does not survive a resize that collapses it. Its VALUE does: that lives
717
+ * in the consumer's own signal or form control.
718
+ *
719
+ * The width is a contract, not a hint — the bar sizes the slot to exactly this
720
+ * and decides the split from it, so a control that would render wider is
721
+ * narrowed rather than allowed to break the row.
722
+ */
723
+ declare class FilterItemDirective {
724
+ readonly template: TemplateRef<unknown>;
725
+ /** Slot width in px. Bare `dsFilterItem` (or a non-positive value) means 180. */
726
+ readonly width: _angular_core.InputSignalWithTransform<number, unknown>;
727
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FilterItemDirective, never>;
728
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FilterItemDirective, "ng-template[dsFilterItem]", never, { "width": { "alias": "dsFilterItem"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
729
+ }
730
+
731
+ /**
732
+ * Priority+ filter row: renders as many filters as fit and collapses the rest
733
+ * into a "+N more" panel. Every admin list past three filters hits the same wall
734
+ * — the row wraps to a second line on a laptop, or the consumer hand-rolls this.
735
+ *
736
+ * The split is decided from each item's declared width plus one `ResizeObserver`
737
+ * on the row, never by measuring the filters themselves: they would have to be in
738
+ * the DOM to be measured, so anything that did not fit would flash before being
739
+ * taken away. `[dsFilterItem]` carries the width.
740
+ *
741
+ * Anything marked `dsFilterBarTrailing` — search, a Clear button — sits at the
742
+ * trailing edge and never collapses. Mark each control rather than wrapping them:
743
+ * the bar owns that row's gap and alignment, and a projected wrapper would be a
744
+ * plain block whose children stack. The trailing group is outside the measured
745
+ * row, so flexbox subtracts its width before the row is measured and the
746
+ * arithmetic needs no allowance for it.
747
+ *
748
+ * ```html
749
+ * <ds-filter-bar>
750
+ * <ng-template [dsFilterItem]="180">
751
+ * <ds-select label="Status" … />
752
+ * </ng-template>
753
+ * <ng-template [dsFilterItem]="220">
754
+ * <ds-date-picker label="Opened" … />
755
+ * </ng-template>
756
+ *
757
+ * <ds-search dsFilterBarTrailing … />
758
+ * <ds-button dsFilterBarTrailing variant="text">Clear</ds-button>
759
+ * </ds-filter-bar>
760
+ * ```
761
+ */
762
+ declare class FilterBarComponent {
763
+ /** Trailing word of the trigger, after the count: "+2 filters". */
764
+ readonly moreLabel: _angular_core.InputSignal<string>;
765
+ /** Accessible name of the overflow panel. */
766
+ readonly panelLabel: _angular_core.InputSignal<string>;
767
+ protected readonly devMode: boolean;
768
+ protected readonly items: _angular_core.Signal<readonly FilterItemDirective[]>;
769
+ private readonly row;
770
+ private readonly rowWidth;
771
+ private readonly gap;
772
+ protected readonly inlineCount: _angular_core.Signal<number>;
773
+ protected readonly inline: _angular_core.Signal<FilterItemDirective[]>;
774
+ /** The filters currently in the overflow panel. */
775
+ readonly collapsed: _angular_core.Signal<FilterItemDirective[]>;
776
+ constructor();
777
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<FilterBarComponent, never>;
778
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<FilterBarComponent, "ds-filter-bar", never, { "moreLabel": { "alias": "moreLabel"; "required": false; "isSignal": true; }; "panelLabel": { "alias": "panelLabel"; "required": false; "isSignal": true; }; }, {}, ["items"], ["[dsFilterBarTrailing]", "*"], true, never>;
779
+ }
780
+
442
781
  type AvatarSize = 'xs' | DsSize;
443
782
  type AvatarStatus = 'online' | 'offline' | 'away' | 'busy';
444
783
 
@@ -518,9 +857,6 @@ declare class AvatarGroupComponent {
518
857
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<AvatarGroupComponent, "ds-avatar-group", never, { "max": { "alias": "max"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
519
858
  }
520
859
 
521
- type CardElevation = 'flat' | 'raised' | 'hover' | 'interactive';
522
- type CardPadding = 'none' | 'sm' | 'md' | 'lg';
523
-
524
860
  declare class CardComponent {
525
861
  /** Visual treatment; `interactive` makes the card clickable and emits `pressed`. */
526
862
  readonly elevation: _angular_core.InputSignal<CardElevation>;
@@ -622,6 +958,32 @@ declare class TabsComponent {
622
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>;
623
959
  }
624
960
 
961
+ type FieldMessageState = 'default' | 'error' | 'warning' | 'success';
962
+
963
+ /**
964
+ * One validation error, structurally identical to Angular's signal-forms
965
+ * `ValidationError`.
966
+ *
967
+ * Declared here rather than imported from `@angular/forms/signals` on purpose:
968
+ * that module is `@experimental`, and a public DS type must not carry a
969
+ * dependency that can be renamed out from under consumers. Structural
970
+ * compatibility is all the interop needs — signal forms binds by input NAME and
971
+ * assigns its own `ValidationError[]`, which this shape accepts.
972
+ */
973
+ interface DsFieldError {
974
+ /** Identifies the kind of error, e.g. `required`, `minlength`, `server`. */
975
+ readonly kind: string;
976
+ /** Human-readable text. Authored by the consumer, at the validator. */
977
+ readonly message?: string;
978
+ }
979
+ /** What a field's `errors` input accepts before normalization. */
980
+ type DsFieldErrorsInput = string | DsFieldError | readonly DsFieldError[] | null | undefined;
981
+ /** The single line a field shows below itself, already resolved. */
982
+ interface DsFieldMessage {
983
+ readonly text: string;
984
+ readonly state: FieldMessageState;
985
+ }
986
+
625
987
  /**
626
988
  * Shared `ControlValueAccessor` for DS form controls whose value is a signal
627
989
  * `model()`. Bridges that model with Angular forms (reactive `formControl` /
@@ -637,6 +999,7 @@ declare abstract class DsControlValueAccessor<T> implements ControlValueAccessor
637
999
  abstract readonly value: ModelSignal<T>;
638
1000
  /** Driven by the forms API via `setDisabledState`. */
639
1001
  protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
1002
+ protected readonly touchedSelf: _angular_core.WritableSignal<boolean>;
640
1003
  private onChange;
641
1004
  private onTouched;
642
1005
  private synced;
@@ -663,6 +1026,7 @@ declare abstract class DsBooleanControlValueAccessor implements ControlValueAcce
663
1026
  abstract readonly checked: ModelSignal<boolean>;
664
1027
  /** Driven by the forms API via `setDisabledState`. */
665
1028
  protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
1029
+ protected readonly touchedSelf: _angular_core.WritableSignal<boolean>;
666
1030
  private onChange;
667
1031
  private onTouched;
668
1032
  private synced;
@@ -678,11 +1042,10 @@ declare abstract class DsBooleanControlValueAccessor implements ControlValueAcce
678
1042
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsBooleanControlValueAccessor, never, never, {}, {}, never, never, true, never>;
679
1043
  }
680
1044
 
681
- type FieldMessageState = 'default' | 'error' | 'success';
682
-
683
1045
  type InputType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search';
684
1046
 
685
1047
  declare class InputComponent extends DsControlValueAccessor<string> {
1048
+ private readonly control;
686
1049
  /** Text value, two-way bound. */
687
1050
  readonly value: _angular_core.ModelSignal<string>;
688
1051
  /** Native input type — also affects the default clear button and password toggle. */
@@ -693,10 +1056,24 @@ declare class InputComponent extends DsControlValueAccessor<string> {
693
1056
  readonly label: _angular_core.InputSignal<string>;
694
1057
  /** Helper text shown below the field. */
695
1058
  readonly hint: _angular_core.InputSignal<string>;
1059
+ /** Error text. Shown immediately — binding it says the consumer has already
1060
+ * decided this field is in error. Takes precedence over `errors`. */
1061
+ readonly error: _angular_core.InputSignal<string>;
1062
+ /** Advisory text, shown when there is no error. */
1063
+ readonly warning: _angular_core.InputSignal<string>;
1064
+ /** Validation errors, shown once the user has interacted. Bound automatically
1065
+ * by signal forms; reactive and template-driven forms are read through
1066
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
1067
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
1068
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
1069
+ * `errors`, so a `required` error does not greet an untouched form. */
1070
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
696
1071
  /** Reserve the message-row height even when empty, so the field doesn't shift
697
- * the layout below it when a hint/error appears. Default on — opt out for a
698
- * deliberately collapsing field. */
699
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
1072
+ * the layout below it when a hint/error appears. Falls back to
1073
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
1074
+ * for a form that shows validation messages. */
1075
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
1076
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
700
1077
  /** Placeholder shown when empty. */
701
1078
  readonly placeholder: _angular_core.InputSignal<string>;
702
1079
  /** Disables the field and blocks all interaction. */
@@ -732,6 +1109,11 @@ declare class InputComponent extends DsControlValueAccessor<string> {
732
1109
  /** Accessible name when no visible `label` is provided (falls back to the
733
1110
  * placeholder so the control is never unnamed). */
734
1111
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
1112
+ /** Extra element ids to describe the control with — a password-rule list, a
1113
+ * policy note. MERGED with the field's own message id rather than replacing
1114
+ * it, and it has to be an input because the attribute belongs on the inner
1115
+ * `<input>`: set on the host it lands on a wrapper no screen reader reads. */
1116
+ readonly ariaDescribedBy: _angular_core.InputSignal<string | null>;
735
1117
  /** Hard character cap — applies the native maxlength attribute and shows a
736
1118
  * live "{current}/{max}" counter below the field. */
737
1119
  readonly maxLength: _angular_core.InputSignal<number | null>;
@@ -756,7 +1138,10 @@ declare class InputComponent extends DsControlValueAccessor<string> {
756
1138
  protected readonly canClear: _angular_core.Signal<boolean>;
757
1139
  protected readonly uid: string;
758
1140
  protected readonly hintId: _angular_core.Signal<string | null>;
759
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
1141
+ protected readonly describedBy: _angular_core.Signal<string | null>;
1142
+ private readonly fieldMessage;
1143
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
1144
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
760
1145
  /** Only name via aria-label when there's no visible `<label for>`. */
761
1146
  protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
762
1147
  /** Effective disabled — own `disabled` input OR the reactive-forms state. */
@@ -767,9 +1152,12 @@ declare class InputComponent extends DsControlValueAccessor<string> {
767
1152
  protected readonly effectiveType: _angular_core.Signal<InputType>;
768
1153
  protected togglePassword(): void;
769
1154
  protected readonly wrapperClasses: _angular_core.Signal<string>;
1155
+ /** Move keyboard focus to the native input — public so a host can drive it
1156
+ * deliberately, e.g. focusing the first invalid field on a failed submit. */
1157
+ focus(options?: FocusOptions): void;
770
1158
  protected clear(): void;
771
1159
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<InputComponent, never>;
772
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<InputComponent, "ds-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "floating": { "alias": "floating"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "enterKeyHint": { "alias": "enterKeyHint"; "required": false; "isSignal": true; }; "inputMode": { "alias": "inputMode"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "passwordToggle": { "alias": "passwordToggle"; "required": false; "isSignal": true; }; "passwordVisible": { "alias": "passwordVisible"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "blurred": "blurred"; "passwordVisible": "passwordVisibleChange"; }, never, ["[dsInputPrefix]", "[dsInputSuffix]"], true, never>;
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>;
773
1161
  }
774
1162
 
775
1163
  declare class NumberStepperComponent {
@@ -800,6 +1188,7 @@ declare class NumberStepperComponent {
800
1188
  type TextareaResize = 'none' | 'vertical' | 'horizontal' | 'both';
801
1189
 
802
1190
  declare class TextareaComponent extends DsControlValueAccessor<string> {
1191
+ private readonly control;
803
1192
  /** Text value, two-way bound. */
804
1193
  readonly value: _angular_core.ModelSignal<string>;
805
1194
  /** Field height — sm/md/lg. */
@@ -808,10 +1197,24 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
808
1197
  readonly label: _angular_core.InputSignal<string>;
809
1198
  /** Helper text shown below the field. */
810
1199
  readonly hint: _angular_core.InputSignal<string>;
1200
+ /** Error text. Shown immediately — binding it says the consumer has already
1201
+ * decided this field is in error. Takes precedence over `errors`. */
1202
+ readonly error: _angular_core.InputSignal<string>;
1203
+ /** Advisory text, shown when there is no error. */
1204
+ readonly warning: _angular_core.InputSignal<string>;
1205
+ /** Validation errors, shown once the user has interacted. Bound automatically
1206
+ * by signal forms; reactive and template-driven forms are read through
1207
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
1208
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
1209
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
1210
+ * `errors`, so a `required` error does not greet an untouched form. */
1211
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
811
1212
  /** Reserve the message-row height even when empty, so the field doesn't shift
812
- * the layout below it when a hint/error appears. Default on — opt out for a
813
- * deliberately collapsing field. */
814
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
1213
+ * the layout below it when a hint/error appears. Falls back to
1214
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
1215
+ * for a form that shows validation messages. */
1216
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
1217
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
815
1218
  /** Placeholder shown when empty. */
816
1219
  readonly placeholder: _angular_core.InputSignal<string>;
817
1220
  /** Disables the field and blocks all interaction. */
@@ -843,7 +1246,9 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
843
1246
  readonly maxLength: _angular_core.InputSignal<number | null>;
844
1247
  protected readonly uid: string;
845
1248
  protected readonly hintId: _angular_core.Signal<string | null>;
846
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
1249
+ private readonly fieldMessage;
1250
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
1251
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
847
1252
  protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
848
1253
  /** Effective disabled — own `disabled` input OR the reactive-forms state. */
849
1254
  protected readonly isDisabled: _angular_core.Signal<boolean>;
@@ -853,8 +1258,11 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
853
1258
  protected readonly autosizeMinHeight: _angular_core.Signal<string | null>;
854
1259
  protected readonly autosizeMaxHeight: _angular_core.Signal<string | null>;
855
1260
  protected readonly effectiveResize: _angular_core.Signal<TextareaResize>;
1261
+ /** Move keyboard focus to the native textarea — public so a host can drive it
1262
+ * deliberately, e.g. focusing the first invalid field on a failed submit. */
1263
+ focus(options?: FocusOptions): void;
856
1264
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextareaComponent, never>;
857
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextareaComponent, "ds-textarea", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "autosize": { "alias": "autosize"; "required": false; "isSignal": true; }; "minRows": { "alias": "minRows"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "resize": { "alias": "resize"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
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>;
858
1266
  }
859
1267
 
860
1268
  declare class SearchComponent {
@@ -876,12 +1284,23 @@ declare class SearchComponent {
876
1284
  /** Fires with the current value on Enter. */
877
1285
  readonly submitted: _angular_core.OutputEmitterRef<string>;
878
1286
  private readonly inputEl;
1287
+ /** Move keyboard focus to the search input. Public so a host can hand focus
1288
+ * over deliberately — e.g. a Clear button that disables itself on activation
1289
+ * would otherwise blur into `<body>` and restart Tab order at the top. */
1290
+ focus(options?: FocusOptions): void;
879
1291
  protected onSubmit(): void;
880
1292
  protected clear(): void;
881
1293
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SearchComponent, never>;
882
1294
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<SearchComponent, "ds-search", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "shortcut": { "alias": "shortcut"; "required": false; "isSignal": true; }; "showIcon": { "alias": "showIcon"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "submitted": "submitted"; }, never, never, true, never>;
883
1295
  }
884
1296
 
1297
+ /**
1298
+ * Why a panel is closing. `'select'` is a deliberate action that produced a
1299
+ * result — an option chosen, a date picked, the trigger pressed again, Tab moving
1300
+ * on; `'dismiss'` is ambient — Escape, a press outside, the page scrolling away.
1301
+ */
1302
+ type DsOverlayCloseCause = 'select' | 'dismiss';
1303
+
885
1304
  /** Showcase-only: renders the component's open/overlay surface inline in normal
886
1305
  * flow instead of its real overlay mechanics (for static docs specimens).
887
1306
  * Not part of the production contract. */
@@ -928,10 +1347,24 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
928
1347
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
929
1348
  /** Helper text shown below the trigger. */
930
1349
  readonly hint: _angular_core.InputSignal<string>;
1350
+ /** Error text. Shown immediately — binding it says the consumer has already
1351
+ * decided this field is in error. Takes precedence over `errors`. */
1352
+ readonly error: _angular_core.InputSignal<string>;
1353
+ /** Advisory text, shown when there is no error. */
1354
+ readonly warning: _angular_core.InputSignal<string>;
1355
+ /** Validation errors, shown once the user has interacted. Bound automatically
1356
+ * by signal forms; reactive and template-driven forms are read through
1357
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
1358
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
1359
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
1360
+ * `errors`, so a `required` error does not greet an untouched form. */
1361
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
931
1362
  /** Reserve the message-row height even when empty, so the field doesn't shift
932
- * the layout below it when a hint/error appears. Default on — opt out for a
933
- * deliberately collapsing field. */
934
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
1363
+ * the layout below it when a hint/error appears. Falls back to
1364
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
1365
+ * for a form that shows validation messages. */
1366
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
1367
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
935
1368
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
936
1369
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
937
1370
  /** Shows an "(optional)" marker next to the label (ignored when `required`). */
@@ -946,7 +1379,9 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
946
1379
  protected readonly labelId: string;
947
1380
  protected readonly listboxId: string;
948
1381
  protected readonly hintId: _angular_core.Signal<string | null>;
949
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
1382
+ private readonly fieldMessage;
1383
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
1384
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
950
1385
  protected optionId(flatIndex: number): string;
951
1386
  /** Active option for `aria-activedescendant` (combobox keeps DOM focus). */
952
1387
  protected readonly activeDescendant: _angular_core.Signal<string | null>;
@@ -972,7 +1407,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
972
1407
  protected flatIndexOf(opt: SelectOption): number;
973
1408
  protected toggle(): void;
974
1409
  protected openPanel(): void;
975
- protected close(): void;
1410
+ protected close(cause?: DsOverlayCloseCause): void;
976
1411
  ngOnDestroy(): void;
977
1412
  protected pick(option: SelectOption, groupDisabled?: boolean): void;
978
1413
  protected clearValue(event: MouseEvent): void;
@@ -984,7 +1419,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
984
1419
  private firstEnabledIndex;
985
1420
  private lastEnabledIndex;
986
1421
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
987
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
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: {}; }]>;
988
1423
  }
989
1424
 
990
1425
  /**
@@ -1012,6 +1447,20 @@ declare class CellTemplateDirective {
1012
1447
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CellTemplateDirective, "[dsCellTemplate]", never, { "dsCellTemplate": { "alias": "dsCellTemplate"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
1013
1448
  }
1014
1449
 
1450
+ /**
1451
+ * Who sorts a `ds-table`.
1452
+ *
1453
+ * - `'client'` (default) — the table reorders `data()` itself.
1454
+ * - `'server'` — the table only emits `sortChange`; the host reorders.
1455
+ * - `'none'` — nothing sorts, and `sortable` columns render no affordance rather
1456
+ * than a control that does nothing.
1457
+ *
1458
+ * Replaces the boolean `clientSort`, which could not express `'none'`: a column
1459
+ * marked `sortable` on a table with no sorting drew a live-looking header that
1460
+ * did nothing, and no type or dev check could catch it.
1461
+ */
1462
+ type TableSortMode = 'client' | 'server' | 'none';
1463
+
1015
1464
  interface TableColumn<T = unknown> {
1016
1465
  key: string;
1017
1466
  label: string;
@@ -1033,6 +1482,14 @@ interface TableColumn<T = unknown> {
1033
1482
  width?: number;
1034
1483
  align?: 'left' | 'right' | 'center';
1035
1484
  cell?: (row: T) => string;
1485
+ /** Sort this column by a DOMAIN value instead of the rendered text. Without
1486
+ * it, client sorting compares what the cell displays, so `$1.2M / $840K / $95K`
1487
+ * sorts by the leading character and `Oct 09, 2023 / Feb 27, 2024` sorts by
1488
+ * month NAME — the table looks sorted and is not. Return the underlying
1489
+ * number, `Date` or plain string; `null`/`undefined`/`''` counts as blank and
1490
+ * sorts last in BOTH directions. Only affects sorting — the header filter
1491
+ * still lists what the user can see. */
1492
+ sortValue?: (row: T) => string | number | Date | null | undefined;
1036
1493
  /** Double-click the cell to edit it inline; the committed value is emitted
1037
1494
  * via the table's `cellEdited` output (the consumer owns the data update). */
1038
1495
  editable?: boolean;
@@ -1069,11 +1526,14 @@ interface TableCellEditEvent<T = unknown> {
1069
1526
  value: string;
1070
1527
  }
1071
1528
 
1072
- declare class TableComponent<T extends {
1073
- id: string;
1074
- }> {
1529
+ declare class TableComponent<T extends object> {
1075
1530
  /** Rows to render. */
1076
1531
  readonly data: _angular_core.InputSignal<readonly T[]>;
1532
+ /** Row identity used for tracking, selection, expansion and the active-row
1533
+ * highlight. Defaults to `row.id`; pass an accessor for display-only data
1534
+ * with no natural key (`[rowId]="row => row.channel + row.sentAt"`), which
1535
+ * beats mapping synthetic ids into the data just to satisfy the table. */
1536
+ readonly rowId: _angular_core.InputSignal<((row: T) => string) | null>;
1077
1537
  /** Column definitions driving headers, cells and sorting. */
1078
1538
  readonly columns: _angular_core.InputSignal<readonly TableColumn<T>[]>;
1079
1539
  /** Adds a checkbox column for row/select-all selection. */
@@ -1147,6 +1607,25 @@ declare class TableComponent<T extends {
1147
1607
  * order; the column panel owns it once the user reorders. Keys absent from
1148
1608
  * the list fall back to declaration order after the listed ones. */
1149
1609
  readonly columnOrder: _angular_core.ModelSignal<string[] | null>;
1610
+ /** Round-trip `columnOrder`, `columnWidths` and `hiddenKeys` through
1611
+ * `localStorage`, so a reader's column layout survives a reload. Needs
1612
+ * `storageKey` — without one there is nothing to key a screen by, and two
1613
+ * tables would overwrite each other. Off by default. */
1614
+ readonly persistLayout: _angular_core.InputSignalWithTransform<boolean, unknown>;
1615
+ /** Screen id the persisted layout is stored under. Pick something stable per
1616
+ * table, not per route instance. */
1617
+ readonly storageKey: _angular_core.InputSignal<string>;
1618
+ /** Render an export button above the table. Off by default; `exportCsv()`
1619
+ * stays available for a consumer's own button. */
1620
+ readonly exportButton: _angular_core.InputSignalWithTransform<boolean, unknown>;
1621
+ /** Filename the export button downloads as. */
1622
+ readonly exportFilename: _angular_core.InputSignal<string>;
1623
+ /** Rows to export instead of what the table holds. A server-paged table only
1624
+ * HAS the current page, so exporting without this silently exports one page —
1625
+ * return the whole set here and the button awaits it. */
1626
+ readonly exportFetcher: _angular_core.InputSignal<(() => Promise<readonly T[]>) | null>;
1627
+ /** True while `exportFetcher` is in flight, so the button can disable itself. */
1628
+ protected readonly exporting: _angular_core.WritableSignal<boolean>;
1150
1629
  /** Keeps the horizontal scrollbar reachable on tall tables: the scroll
1151
1630
  * container's native bar is hidden and a proxy stuck to the bottom of the
1152
1631
  * nearest scroll ancestor mirrors it both ways. Off by default. */
@@ -1165,14 +1644,30 @@ declare class TableComponent<T extends {
1165
1644
  /** Scroll the table into view on a page change (opt-in) — keeps a bottom
1166
1645
  * pager from leaving the viewport on the previous page's last rows. */
1167
1646
  readonly scrollToTopOnPageChange: _angular_core.InputSignalWithTransform<boolean, unknown>;
1168
- /** When true, the table sorts `data()` itself; otherwise it only emits
1169
- * `sortChange` and leaves ordering to the consumer (default). */
1170
- readonly clientSort: _angular_core.InputSignalWithTransform<boolean, unknown>;
1647
+ /** Who sorts — see `TableSortMode`. Unset resolves to `'client'`, so a column
1648
+ * marked `sortable` always does something; declare `'server'` when the host
1649
+ * reorders, or `'none'` to drop the affordance entirely. */
1650
+ readonly sortMode: _angular_core.InputSignal<TableSortMode | null>;
1651
+ protected readonly sortModeResolved: _angular_core.Signal<TableSortMode>;
1171
1652
  /** Pin the first data column (and the select column) on horizontal scroll. */
1172
1653
  readonly stickyFirstColumn: _angular_core.InputSignalWithTransform<boolean, unknown>;
1654
+ /**
1655
+ * Render only the rows in view, padding the rest with two spacer rows. Opt-in,
1656
+ * and it needs `maxHeight` — without a bounded scroller there is no viewport to
1657
+ * window against, so nothing is virtualized (dev-warned).
1658
+ *
1659
+ * Every row must be the same height, which is `virtualRowSize`: the arithmetic
1660
+ * that decides what is in view has no other way to know where a row starts. So
1661
+ * virtual mode forces `table-layout: fixed` and single-line cells, and the
1662
+ * expansion panel is suppressed — a row that can grow breaks the maths.
1663
+ */
1664
+ readonly virtualScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
1665
+ /** Row height in px in virtual mode. Must match what the rows actually
1666
+ * measure, so it drives the CSS height rather than merely describing it. */
1667
+ readonly virtualRowSize: _angular_core.InputSignal<number>;
1173
1668
  /** Fires with the row on click (or Enter/Space when `rowInteractive`). */
1174
1669
  readonly rowClicked: _angular_core.OutputEmitterRef<T>;
1175
- /** Fires whenever sort key/direction changes, regardless of `clientSort`. */
1670
+ /** Fires whenever sort key/direction changes, in every `sortMode` but `'none'`. */
1176
1671
  readonly sortChange: _angular_core.OutputEmitterRef<SortChangeEvent>;
1177
1672
  /** Row-action menu items rendered as a trailing kebab (⋮) column.
1178
1673
  * Empty (default) — no column. Menu clicks never trigger `rowClicked`. */
@@ -1182,10 +1677,10 @@ declare class TableComponent<T extends {
1182
1677
  /** Fires when an `editable` cell is committed (Enter or blur) with the new value. */
1183
1678
  readonly cellEdited: _angular_core.OutputEmitterRef<TableCellEditEvent<T>>;
1184
1679
  /** Cell templates supplied as an explicit map instead of (or in addition to)
1185
- * projected `dsCellTemplate` directives. Lets a wrapper component (e.g.
1186
- * ids-data-table) collect the directives itself and pass them down, since
1187
- * content projected through a wrapper's `<ng-content>` is not seen by this
1188
- * component's content query. Entries here override projected ones. */
1680
+ * projected `dsCellTemplate` directives. Lets a wrapper component collect
1681
+ * the directives itself and pass them down, since content projected through
1682
+ * a wrapper's `<ng-content>` is not seen by this component's content query.
1683
+ * Entries here override projected ones. */
1189
1684
  readonly cellTemplateMap: _angular_core.InputSignal<Record<string, TemplateRef<{
1190
1685
  $implicit: unknown;
1191
1686
  row: unknown;
@@ -1273,12 +1768,30 @@ declare class TableComponent<T extends {
1273
1768
  * substring search with any per-column set filters. Sorting and pagination
1274
1769
  * run on the filtered rows. */
1275
1770
  protected readonly filteredData: _angular_core.Signal<readonly T[]>;
1276
- /** Client-side sort over the filtered data set — only when `clientSort()`. */
1771
+ /** Client-side sort over the filtered data set — only in `'client'` mode. */
1277
1772
  protected readonly sortedData: _angular_core.Signal<readonly T[]>;
1278
1773
  /** Current page's slice of the sorted rows, when paginating. */
1279
1774
  protected readonly pagedData: _angular_core.Signal<readonly T[]>;
1280
1775
  /** Rows actually rendered: paged when paginating, else sorted/raw data. */
1281
1776
  protected readonly displayData: _angular_core.Signal<readonly T[]>;
1777
+ /** Virtual mode needs a bounded scroller to window against. */
1778
+ protected readonly virtualizing: _angular_core.Signal<boolean>;
1779
+ /** Drives the CSS row height from the same number the arithmetic uses, so the
1780
+ * two cannot drift — which would make every offset progressively wrong. */
1781
+ protected readonly virtualRowHeight: _angular_core.Signal<string>;
1782
+ /** `null` when not virtualizing — the row loop then walks `displayData()` whole. */
1783
+ protected readonly virtualWindow: _angular_core.Signal<{
1784
+ start: number;
1785
+ end: number;
1786
+ padTop: number;
1787
+ padBottom: number;
1788
+ } | null>;
1789
+ /** The rows the template actually renders. */
1790
+ protected readonly windowData: _angular_core.Signal<readonly T[]>;
1791
+ /** Zebra striping cannot come from `:nth-child` while windowing — the parity
1792
+ * of a rendered row depends on its ABSOLUTE index, and the spacer rows are
1793
+ * children too. Matches `:nth-child(odd)`, which is 1-based. */
1794
+ protected isStriped(rowIndex: number): boolean;
1282
1795
  protected readonly allSelected: _angular_core.Signal<boolean>;
1283
1796
  protected readonly someSelected: _angular_core.Signal<boolean>;
1284
1797
  /** Select-all is page-scoped only when paginating. */
@@ -1303,6 +1816,8 @@ declare class TableComponent<T extends {
1303
1816
  private readonly hscrollProxy;
1304
1817
  protected readonly hscrollContentWidth: _angular_core.WritableSignal<number>;
1305
1818
  protected readonly hscrollNeeded: _angular_core.WritableSignal<boolean>;
1819
+ private readonly scrollTop;
1820
+ private readonly viewportHeight;
1306
1821
  constructor();
1307
1822
  private parseDurationMs;
1308
1823
  protected onRowMenuClick(row: T, event: Event): void;
@@ -1321,6 +1836,11 @@ declare class TableComponent<T extends {
1321
1836
  /** Accessible name for an interactive row, taken from the first visible column. */
1322
1837
  protected rowAriaLabel(row: T): string;
1323
1838
  /** `aria-sort` value for a header: only meaningful on sortable columns. */
1839
+ /** Row identity — the `rowId` accessor when given, else `row.id`. Public so a
1840
+ * host reading `selectedIds`/`expandedIds` can compute the same keys. */
1841
+ rowKey(row: T): string;
1842
+ /** Whether this column's header is an actual sort control right now. */
1843
+ protected sortableCol(col: TableColumn<T>): boolean;
1324
1844
  protected ariaSort(col: TableColumn<T>): 'ascending' | 'descending' | 'none' | null;
1325
1845
  protected onSort(col: TableColumn<T>): void;
1326
1846
  protected headerClasses(col: TableColumn<T>): string;
@@ -1329,12 +1849,19 @@ declare class TableComponent<T extends {
1329
1849
  /** Exports the visible columns of the filtered + sorted rows (all rows, not
1330
1850
  * just the current page) as a CSV download. Call from a consumer button:
1331
1851
  * `<ds-button (pressed)="table.exportCsv()">`. */
1332
- exportCsv(filename?: string): void;
1852
+ exportCsv(filename?: string, rows?: readonly T[]): void;
1853
+ private layoutKey;
1854
+ private layoutRestored;
1855
+ private restoreLayout;
1856
+ private saveLayout;
1857
+ /** Export button handler: awaits `exportFetcher` when one is given, so a
1858
+ * server-paged table exports the whole set rather than the page it holds. */
1859
+ protected runExport(): Promise<void>;
1333
1860
  /** Deterministic per-cell width so skeleton rows look organic but stable
1334
1861
  * across re-renders. Mixes column key + row index into one of five widths. */
1335
1862
  protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
1336
1863
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
1337
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "animateHeight": { "alias": "animateHeight"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDir": { "alias": "sortDir"; "required": false; "isSignal": true; }; "sortingOrder": { "alias": "sortingOrder"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "activeRowId": { "alias": "activeRowId"; "required": false; "isSignal": true; }; "filterQuery": { "alias": "filterQuery"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "hiddenKeys": { "alias": "hiddenKeys"; "required": false; "isSignal": true; }; "resizableColumns": { "alias": "resizableColumns"; "required": false; "isSignal": true; }; "columnWidths": { "alias": "columnWidths"; "required": false; "isSignal": true; }; "reorderableColumns": { "alias": "reorderableColumns"; "required": false; "isSignal": true; }; "columnOrder": { "alias": "columnOrder"; "required": false; "isSignal": true; }; "stickyScrollbar": { "alias": "stickyScrollbar"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "clientSort": { "alias": "clientSort"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKey": "sortKeyChange"; "sortDir": "sortDirChange"; "columnFilters": "columnFiltersChange"; "hiddenKeys": "hiddenKeysChange"; "columnWidths": "columnWidthsChange"; "columnOrder": "columnOrderChange"; "pageSize": "pageSizeChange"; "page": "pageChange"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; }, ["cellTemplateDirectives"], ["[empty]", "[bulk-actions]"], true, never>;
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>;
1338
1865
  }
1339
1866
 
1340
1867
  declare class PaginationComponent {
@@ -1349,6 +1876,9 @@ declare class PaginationComponent {
1349
1876
  readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
1350
1877
  /** Shows the "Showing X–Y of Z" range label. */
1351
1878
  readonly showLabel: _angular_core.InputSignalWithTransform<boolean, unknown>;
1879
+ /** Shows the rows-per-page dropdown. Turn it off for a screen with a fixed
1880
+ * page size — otherwise the control offers a choice the host won't honour. */
1881
+ readonly showPageSize: _angular_core.InputSignalWithTransform<boolean, unknown>;
1352
1882
  protected readonly totalPages: _angular_core.Signal<number>;
1353
1883
  protected readonly pageItems: _angular_core.Signal<(number | "ellipsis")[]>;
1354
1884
  protected readonly rangeLabel: _angular_core.Signal<string>;
@@ -1360,7 +1890,82 @@ declare class PaginationComponent {
1360
1890
  protected goTo(page: number): void;
1361
1891
  protected onSizeChange(value: string): void;
1362
1892
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<PaginationComponent, never>;
1363
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<PaginationComponent, "ds-pagination", never, { "total": { "alias": "total"; "required": true; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "currentPage": { "alias": "currentPage"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; }, { "pageSize": "pageSizeChange"; "currentPage": "currentPageChange"; }, never, never, true, never>;
1893
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<PaginationComponent, "ds-pagination", never, { "total": { "alias": "total"; "required": true; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "currentPage": { "alias": "currentPage"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; }, { "pageSize": "pageSizeChange"; "currentPage": "currentPageChange"; }, never, never, true, never>;
1894
+ }
1895
+
1896
+ /**
1897
+ * One password requirement. The consumer owns the POLICY — `test` must mirror
1898
+ * whatever their server enforces — and the DS owns only how the row reads.
1899
+ */
1900
+ interface DsPasswordRule {
1901
+ /** Row text, e.g. "At least 8 characters". */
1902
+ readonly label: string;
1903
+ /** Whether the current value satisfies this rule. */
1904
+ readonly test: (value: string) => boolean;
1905
+ }
1906
+ /** Per-row state, exposed so a consumer can style or test against it. */
1907
+ type DsPasswordRuleState = 'pending' | 'met' | 'failed';
1908
+
1909
+ interface RuleRow {
1910
+ readonly label: string;
1911
+ readonly state: DsPasswordRuleState;
1912
+ readonly icon: IconName;
1913
+ readonly announced: string;
1914
+ }
1915
+ /**
1916
+ * Passes when every rule does. Exported separately so a form can gate its submit
1917
+ * from a validator without reaching for the component instance.
1918
+ */
1919
+ declare function passwordRulesMet(value: string, rules: readonly DsPasswordRule[]): boolean;
1920
+ /**
1921
+ * Live checklist under a "new password" field.
1922
+ *
1923
+ * The consumer keeps the POLICY — each rule carries its own `test`, which has to
1924
+ * mirror the server, or the checklist is a lie — and this owns the rendering: the
1925
+ * tri-state glyph, the met and failed colours, the type scale. One consumer had
1926
+ * written it twice and the copies had already drifted (different labels for the
1927
+ * same rule, a different order, different state classes), which is why it is here.
1928
+ *
1929
+ * ```html
1930
+ * <ds-input
1931
+ * type="password"
1932
+ * [attr.aria-describedby]="rules.listId"
1933
+ * [(value)]="password"
1934
+ * />
1935
+ * <ds-password-rules
1936
+ * #rules
1937
+ * [value]="password()"
1938
+ * [rules]="passwordRules"
1939
+ * [showUnmet]="submitted()"
1940
+ * />
1941
+ * ```
1942
+ */
1943
+ declare class PasswordRulesComponent {
1944
+ /** The password being typed. */
1945
+ readonly value: _angular_core.InputSignal<string>;
1946
+ /** The rule set, in the order it should read. */
1947
+ readonly rules: _angular_core.InputSignal<readonly DsPasswordRule[]>;
1948
+ /**
1949
+ * Whether an unmet rule may read as FAILED. Bind it to "the user has tried to
1950
+ * submit": before that an unmet rule is merely pending, because marking a
1951
+ * half-typed password with errors scolds someone who is still typing.
1952
+ */
1953
+ readonly showUnmet: _angular_core.InputSignalWithTransform<boolean, unknown>;
1954
+ /** Lay the rows out in two columns — for a checklist beside a wide form. */
1955
+ readonly columns: _angular_core.InputSignal<1 | 2>;
1956
+ /**
1957
+ * Id put on the rule list, for the field's `aria-describedby`. Defaults to a
1958
+ * generated one; set it explicitly and both sides can name the same string,
1959
+ * which avoids threading a template ref between two siblings.
1960
+ */
1961
+ readonly listId: _angular_core.InputSignal<string>;
1962
+ protected readonly rows: _angular_core.Signal<readonly RuleRow[]>;
1963
+ /** How many rules pass — for a host that wants to gate its own submit. */
1964
+ readonly metCount: _angular_core.Signal<number>;
1965
+ /** True when every rule passes. */
1966
+ readonly allMet: _angular_core.Signal<boolean>;
1967
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<PasswordRulesComponent, never>;
1968
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<PasswordRulesComponent, "ds-password-rules", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "rules": { "alias": "rules"; "required": false; "isSignal": true; }; "showUnmet": { "alias": "showUnmet"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": false; "isSignal": true; }; "listId": { "alias": "listId"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
1364
1969
  }
1365
1970
 
1366
1971
  interface DateFormatSpec {
@@ -1425,6 +2030,9 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1425
2030
  readonly mode: _angular_core.InputSignal<DatePickerMode>;
1426
2031
  /** Trigger height — sm/md/lg. */
1427
2032
  readonly size: _angular_core.InputSignal<DsSize>;
2033
+ /** Stretch the trigger to fill its container instead of hugging the mask
2034
+ * width — opt in when the field shares a grid/flex track with inputs. */
2035
+ readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
1428
2036
  /** Selected date (single) or `[start, end]` (range), two-way bound. */
1429
2037
  readonly value: _angular_core.ModelSignal<Date | RangeValue | null>;
1430
2038
  /** Accessible-name fallback only — the mask fills the visible placeholder, not this. */
@@ -1433,10 +2041,25 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1433
2041
  readonly label: _angular_core.InputSignal<string>;
1434
2042
  /** Helper text shown below the field. */
1435
2043
  readonly hint: _angular_core.InputSignal<string>;
2044
+ /** Error text. Shown immediately — binding it says the consumer has already
2045
+ * decided this field is in error. Takes precedence over `errors` and over the
2046
+ * picker's own "enter a valid date" message. */
2047
+ readonly error: _angular_core.InputSignal<string>;
2048
+ /** Advisory text, shown when there is no error. */
2049
+ readonly warning: _angular_core.InputSignal<string>;
2050
+ /** Validation errors, shown once the user has interacted. Bound automatically
2051
+ * by signal forms; reactive and template-driven forms are read through
2052
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
2053
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
2054
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
2055
+ * `errors`, so a `required` error does not greet an untouched form. */
2056
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1436
2057
  /** Reserve the message-row height even when empty, so the field doesn't shift
1437
- * the layout below it when a hint/error appears. Default on — opt out for a
1438
- * deliberately collapsing field. */
1439
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
2058
+ * the layout below it when a hint/error appears. Falls back to
2059
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
2060
+ * for a form that shows validation messages. */
2061
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
2062
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
1440
2063
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
1441
2064
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
1442
2065
  /** Shows an "(optional)" marker beside the label — ignored when `required` is set. */
@@ -1473,9 +2096,11 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1473
2096
  readonly allowInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
1474
2097
  protected readonly isDisabled: _angular_core.Signal<boolean>;
1475
2098
  protected readonly hintId: _angular_core.Signal<string | null>;
1476
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
1477
- /** Field-message text: a validation message when typing is invalid, else the hint. */
1478
- protected readonly messageText: _angular_core.Signal<string>;
2099
+ private readonly localError;
2100
+ private readonly dateInvalid;
2101
+ private readonly fieldMessage;
2102
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
2103
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
1479
2104
  protected readonly resolvedLocale: _angular_core.Signal<string>;
1480
2105
  protected readonly resolvedFirstDay: _angular_core.Signal<number>;
1481
2106
  protected readonly formatSpec: _angular_core.Signal<DateFormatSpec>;
@@ -1555,7 +2180,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1555
2180
  protected readonly weeksGrid: _angular_core.Signal<DayCell[][]>;
1556
2181
  private getRangeContext;
1557
2182
  protected open(moveFocusToGrid?: boolean): void;
1558
- protected close(): void;
2183
+ protected close(cause?: DsOverlayCloseCause): void;
1559
2184
  ngOnDestroy(): void;
1560
2185
  protected onFieldClick(): void;
1561
2186
  private mobileEdit;
@@ -1604,7 +2229,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
1604
2229
  protected isPresetDisabled(preset: DatePickerPreset): boolean;
1605
2230
  protected applyPreset(preset: DatePickerPreset): void;
1606
2231
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DatePickerComponent, never>;
1607
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "ds-date-picker", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "minYear": { "alias": "minYear"; "required": false; "isSignal": true; }; "maxYear": { "alias": "maxYear"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "disabledDate": { "alias": "disabledDate"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "defaultDate": { "alias": "defaultDate"; "required": false; "isSignal": true; }; "allowInput": { "alias": "allowInput"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
2232
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "ds-date-picker", never, { "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "minYear": { "alias": "minYear"; "required": false; "isSignal": true; }; "maxYear": { "alias": "maxYear"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "disabledDate": { "alias": "disabledDate"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "dateFormat": { "alias": "dateFormat"; "required": false; "isSignal": true; }; "firstDayOfWeek": { "alias": "firstDayOfWeek"; "required": false; "isSignal": true; }; "defaultDate": { "alias": "defaultDate"; "required": false; "isSignal": true; }; "allowInput": { "alias": "allowInput"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
1608
2233
  }
1609
2234
 
1610
2235
  type TimePickerMode = 'single' | 'range';
@@ -1697,16 +2322,40 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1697
2322
  readonly disabledTime: _angular_core.InputSignal<((time: string) => boolean) | null>;
1698
2323
  /** Trigger height — sm/md/lg. */
1699
2324
  readonly size: _angular_core.InputSignal<DsSize>;
2325
+ /** Stretch the trigger to fill its container instead of hugging its content —
2326
+ * opt in when the field shares a grid/flex track with inputs. */
2327
+ readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
2328
+ /** Field label shown above the trigger — same row a `ds-date-picker` label
2329
+ * occupies, so date + time in one form row line up without a hand-rolled label. */
2330
+ readonly label: _angular_core.InputSignal<string>;
2331
+ /** Marks the field required — shows an asterisk and sets `aria-required`. */
2332
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
2333
+ /** Shows an "(optional)" marker beside the label — ignored when `required` is set. */
2334
+ readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
1700
2335
  /** Disables the picker and blocks all interaction. */
1701
2336
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1702
2337
  /** Applies error styling and marks the trigger `aria-invalid`. */
1703
2338
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
1704
2339
  /** Helper text shown below the picker. */
1705
2340
  readonly hint: _angular_core.InputSignal<string>;
2341
+ /** Error text. Shown immediately — binding it says the consumer has already
2342
+ * decided this field is in error. Takes precedence over `errors`. */
2343
+ readonly error: _angular_core.InputSignal<string>;
2344
+ /** Advisory text, shown when there is no error. */
2345
+ readonly warning: _angular_core.InputSignal<string>;
2346
+ /** Validation errors, shown once the user has interacted. Bound automatically
2347
+ * by signal forms; reactive and template-driven forms are read through
2348
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
2349
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
2350
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
2351
+ * `errors`, so a `required` error does not greet an untouched form. */
2352
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1706
2353
  /** Reserve the message-row height even when empty, so the field doesn't shift
1707
- * the layout below it when a hint/error appears. Default on — opt out for a
1708
- * deliberately collapsing field. */
1709
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
2354
+ * the layout below it when a hint/error appears. Falls back to
2355
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
2356
+ * for a form that shows validation messages. */
2357
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
2358
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
1710
2359
  /** Shown in the trigger when no time is set. */
1711
2360
  readonly placeholder: _angular_core.InputSignal<string>;
1712
2361
  /** Shows an inline clear button when a value is set — single mode only. */
@@ -1716,6 +2365,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1716
2365
  /** Override the DS-config format for this instance. */
1717
2366
  readonly format: _angular_core.InputSignal<TimeFormat | null>;
1718
2367
  protected readonly uid: string;
2368
+ protected readonly labelId: string;
1719
2369
  protected readonly openSegment: _angular_core.WritableSignal<Segment | null>;
1720
2370
  private overlayRef;
1721
2371
  protected readonly singleTrigger: _angular_core.Signal<ElementRef<HTMLButtonElement> | undefined>;
@@ -1725,7 +2375,9 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1725
2375
  protected readonly columns: _angular_core.Signal<TimeColumnsComponent | undefined>;
1726
2376
  protected readonly isDisabled: _angular_core.Signal<boolean>;
1727
2377
  protected readonly hintId: _angular_core.Signal<string | null>;
1728
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
2378
+ private readonly fieldMessage;
2379
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
2380
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
1729
2381
  protected readonly resolvedFormat: _angular_core.Signal<TimeFormat>;
1730
2382
  protected readonly singleValue: _angular_core.Signal<string | null>;
1731
2383
  protected readonly rangeValue: _angular_core.Signal<TimeRangeValue>;
@@ -1741,9 +2393,9 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1741
2393
  protected formatFor(value: string | null): string;
1742
2394
  protected open(segment: Segment): void;
1743
2395
  protected onTriggerClick(segment: Segment): void;
1744
- protected close(): void;
2396
+ protected close(cause?: DsOverlayCloseCause): void;
1745
2397
  ngOnDestroy(): void;
1746
- protected onEscape(): void;
2398
+ protected onEscape(cause?: DsOverlayCloseCause): void;
1747
2399
  protected onPick(next: string): void;
1748
2400
  protected setNow(): void;
1749
2401
  protected clear(event: Event): void;
@@ -1751,7 +2403,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
1751
2403
  private minutesOf;
1752
2404
  private laterOf;
1753
2405
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TimePickerComponent, never>;
1754
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimePickerComponent, "ds-time-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "disabledTime": { "alias": "disabledTime"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
2406
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TimePickerComponent, "ds-time-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "minuteStep": { "alias": "minuteStep"; "required": false; "isSignal": true; }; "minTime": { "alias": "minTime"; "required": false; "isSignal": true; }; "maxTime": { "alias": "maxTime"; "required": false; "isSignal": true; }; "disabledTime": { "alias": "disabledTime"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
1755
2407
  }
1756
2408
 
1757
2409
  interface BreadcrumbItem {
@@ -1799,22 +2451,6 @@ declare class BreadcrumbsService {
1799
2451
  static ɵprov: _angular_core.ɵɵInjectableDeclaration<BreadcrumbsService>;
1800
2452
  }
1801
2453
 
1802
- /**
1803
- * Marks projected wordmark markup for `ds-sidenav`: when present, the sidenav
1804
- * renders the projected content inside `.brand-name` instead of the plain
1805
- * `brand` text (two-tone wordmarks, inline logos etc. stay consumer-side).
1806
- *
1807
- * Interplay: projecting `[dsBrandName]` is enough to render the brand row and
1808
- * its wordmark even without a string `brand`, but it only supplies the
1809
- * wordmark — the letter-mark tile still comes from `logoLetter` (or the first
1810
- * letter of `brand`), so an empty `brand` + projection renders the wordmark
1811
- * with no tile.
1812
- */
1813
- declare class BrandNameDirective {
1814
- static ɵfac: _angular_core.ɵɵFactoryDeclaration<BrandNameDirective, never>;
1815
- static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BrandNameDirective, "[dsBrandName]", never, {}, {}, never, never, true, never>;
1816
- }
1817
-
1818
2454
  /** Contract that ds-sidenav-item reads from its parent ds-sidenav. */
1819
2455
  interface SidenavContract {
1820
2456
  readonly collapsed: () => boolean;
@@ -2035,7 +2671,7 @@ declare class ModalComponent implements OnDestroy {
2035
2671
  protected onBackdrop(event: MouseEvent): void;
2036
2672
  protected onEscape(): void;
2037
2673
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalComponent, never>;
2038
- 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, ["[body]", "[impact]", "[actions]"], true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
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: {}; }]>;
2039
2675
  }
2040
2676
 
2041
2677
  declare class ModalCardComponent {
@@ -2057,7 +2693,7 @@ declare class ModalCardComponent {
2057
2693
  protected readonly classes: _angular_core.Signal<string>;
2058
2694
  protected onClose(): void;
2059
2695
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalCardComponent, never>;
2060
- 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, ["[body]", "[impact]", "[actions]"], true, 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>;
2061
2697
  }
2062
2698
 
2063
2699
  type ModalConfirmTone = 'default' | 'error';
@@ -2097,7 +2733,7 @@ declare class BannerComponent {
2097
2733
  /** Tighter padding, centred items, single-line title. */
2098
2734
  readonly compact: _angular_core.InputSignalWithTransform<boolean, unknown>;
2099
2735
  /** `'stacked'` wraps actions onto their own line; `'row'` keeps them inline. */
2100
- readonly layout: _angular_core.InputSignal<"stacked" | "row">;
2736
+ readonly layout: _angular_core.InputSignal<"row" | "stacked">;
2101
2737
  /** Coloured accent rail on the leading edge; set false to hide it. */
2102
2738
  readonly accentRail: _angular_core.InputSignalWithTransform<boolean, unknown>;
2103
2739
  /** Fires when the user dismisses the banner. */
@@ -2356,7 +2992,28 @@ declare class TooltipDirective implements OnDestroy {
2356
2992
  private ref;
2357
2993
  private timer;
2358
2994
  private readonly tipId;
2359
- protected onOpen(): void;
2995
+ /**
2996
+ * Where `aria-describedby` belongs, when focus is involved. A host that is not
2997
+ * focusable itself never reaches a screen reader — `ds-menu-item` carries
2998
+ * `role="none"` and puts the real `<button>` inside — so describing the host
2999
+ * describes something the user never focuses. `focusin` bubbles, so its target
3000
+ * IS whatever took focus; recording it is what keeps this directive out of the
3001
+ * host component's internal DOM. A pointer-only open leaves this null and
3002
+ * falls back to the host, where no screen reader is involved anyway.
3003
+ */
3004
+ private focusedTarget;
3005
+ /**
3006
+ * Where `aria-describedby` was actually written, remembered so teardown strips
3007
+ * it from the same element. Not derivable at teardown: focus can arrive after
3008
+ * the panel opened (hover, then click or arrow onto it), which moves
3009
+ * `focusedTarget` and would otherwise strand the attribute on the host,
3010
+ * pointing at a panel that no longer exists.
3011
+ */
3012
+ private describedElement;
3013
+ protected onPointerEnter(): void;
3014
+ protected onFocusIn(event: FocusEvent): void;
3015
+ protected onFocusOut(): void;
3016
+ private scheduleShow;
2360
3017
  protected onClose(): void;
2361
3018
  private disposeRef;
2362
3019
  protected onEscape(): void;
@@ -2412,7 +3069,7 @@ declare class PopoverComponent implements OnDestroy, DsOverlayCloseRef {
2412
3069
  /** Resolved placement after the overlay positions — drives the arrow direction. */
2413
3070
  readonly resolvedPlacement: _angular_core.WritableSignal<PopoverPlacement>;
2414
3071
  toggle(trigger: HTMLElement): void;
2415
- close(): void;
3072
+ close(cause?: DsOverlayCloseCause): void;
2416
3073
  ngOnDestroy(): void;
2417
3074
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverComponent, never>;
2418
3075
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<PopoverComponent, "ds-popover", never, { "align": { "alias": "align"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "arrow": { "alias": "arrow"; "required": false; "isSignal": true; }; "panelRole": { "alias": "panelRole"; "required": false; "isSignal": true; }; "panelLabel": { "alias": "panelLabel"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
@@ -2700,19 +3357,35 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2700
3357
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2701
3358
  /** Helper text shown below the field. */
2702
3359
  readonly hint: _angular_core.InputSignal<string>;
3360
+ /** Error text. Shown immediately — binding it says the consumer has already
3361
+ * decided this field is in error. Takes precedence over `errors`. */
3362
+ readonly error: _angular_core.InputSignal<string>;
3363
+ /** Advisory text, shown when there is no error. */
3364
+ readonly warning: _angular_core.InputSignal<string>;
3365
+ /** Validation errors, shown once the user has interacted. Bound automatically
3366
+ * by signal forms; reactive and template-driven forms are read through
3367
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
3368
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
3369
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
3370
+ * `errors`, so a `required` error does not greet an untouched form. */
3371
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
2703
3372
  /** Reserve the message-row height even when empty, so the field doesn't shift
2704
- * the layout below it when a hint/error appears. Default on — opt out for a
2705
- * deliberately collapsing field. */
2706
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
3373
+ * the layout below it when a hint/error appears. Falls back to
3374
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
3375
+ * for a form that shows validation messages. */
3376
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3377
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
2707
3378
  /** Shows a "Create «text»" row when the typed text matches no option. */
2708
3379
  readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
2709
- /** Accessible name for the combobox input. */
3380
+ /** Accessible name for the input. */
2710
3381
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
2711
3382
  /** Fires with the typed text when the user picks the create-new option. */
2712
3383
  readonly create: _angular_core.OutputEmitterRef<string>;
2713
3384
  protected readonly isDisabled: _angular_core.Signal<boolean>;
2714
3385
  protected readonly hintId: _angular_core.Signal<string | null>;
2715
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
3386
+ private readonly fieldMessage;
3387
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
3388
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
2716
3389
  protected readonly query: _angular_core.WritableSignal<string>;
2717
3390
  protected readonly isOpen: _angular_core.WritableSignal<boolean>;
2718
3391
  protected readonly activeIndex: _angular_core.WritableSignal<number>;
@@ -2744,14 +3417,14 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
2744
3417
  protected togglePanel(event: MouseEvent): void;
2745
3418
  protected onKeydown(event: KeyboardEvent): void;
2746
3419
  protected openPanel(): void;
2747
- protected close(): void;
3420
+ protected close(cause?: DsOverlayCloseCause): void;
2748
3421
  ngOnDestroy(): void;
2749
3422
  protected onFilter(event: Event): void;
2750
3423
  protected onPick(option: AutocompleteOption<T>): void;
2751
3424
  protected onCreateNew(): void;
2752
3425
  protected remove(target: T): void;
2753
3426
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent<any>, never>;
2754
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionGroups": { "alias": "optionGroups"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "create": "create"; }, never, never, true, never>;
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>;
2755
3428
  }
2756
3429
 
2757
3430
  type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
@@ -2938,10 +3611,24 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
2938
3611
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2939
3612
  /** Helper text shown below the cells. */
2940
3613
  readonly hint: _angular_core.InputSignal<string>;
3614
+ /** Error text. Shown immediately — binding it says the consumer has already
3615
+ * decided this field is in error. Takes precedence over `errors`. */
3616
+ readonly error: _angular_core.InputSignal<string>;
3617
+ /** Advisory text, shown when there is no error. */
3618
+ readonly warning: _angular_core.InputSignal<string>;
3619
+ /** Validation errors, shown once the user has interacted. Bound automatically
3620
+ * by signal forms; reactive and template-driven forms are read through
3621
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
3622
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
3623
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
3624
+ * `errors`, so a `required` error does not greet an untouched form. */
3625
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
2941
3626
  /** Reserve the message-row height even when empty, so the field doesn't shift
2942
- * the layout below it when a hint/error appears. Default on — opt out for a
2943
- * deliberately collapsing field. */
2944
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
3627
+ * the layout below it when a hint/error appears. Falls back to
3628
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
3629
+ * for a form that shows validation messages. */
3630
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3631
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
2945
3632
  /** Accessible group label for the cell row. */
2946
3633
  readonly ariaLabel: _angular_core.InputSignal<string>;
2947
3634
  /** Fires once, with the full code, on the partial → complete transition. */
@@ -2950,7 +3637,9 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
2950
3637
  private wasComplete;
2951
3638
  protected readonly uid: string;
2952
3639
  protected readonly hintId: _angular_core.Signal<string | null>;
2953
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
3640
+ private readonly fieldMessage;
3641
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
3642
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
2954
3643
  protected readonly isDisabled: _angular_core.Signal<boolean>;
2955
3644
  protected readonly cells: _angular_core.Signal<string[]>;
2956
3645
  protected onInput(event: Event, index: number): void;
@@ -2966,7 +3655,7 @@ declare class OtpInputComponent extends DsControlValueAccessor<string> {
2966
3655
  private focusBox;
2967
3656
  private sanitize;
2968
3657
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<OtpInputComponent, never>;
2969
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<OtpInputComponent, "ds-otp-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "length": { "alias": "length"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "completed": "completed"; }, never, never, true, never>;
3658
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<OtpInputComponent, "ds-otp-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "length": { "alias": "length"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "mask": { "alias": "mask"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "completed": "completed"; }, never, never, true, never>;
2970
3659
  }
2971
3660
 
2972
3661
  type SliderValue = number | readonly [number, number];
@@ -2989,15 +3678,31 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
2989
3678
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
2990
3679
  /** Helper text shown below the slider. */
2991
3680
  readonly hint: _angular_core.InputSignal<string>;
3681
+ /** Error text. Shown immediately — binding it says the consumer has already
3682
+ * decided this field is in error. Takes precedence over `errors`. */
3683
+ readonly error: _angular_core.InputSignal<string>;
3684
+ /** Advisory text, shown when there is no error. */
3685
+ readonly warning: _angular_core.InputSignal<string>;
3686
+ /** Validation errors, shown once the user has interacted. Bound automatically
3687
+ * by signal forms; reactive and template-driven forms are read through
3688
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
3689
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
3690
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
3691
+ * `errors`, so a `required` error does not greet an untouched form. */
3692
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
2992
3693
  /** Reserve the message-row height even when empty, so the field doesn't shift
2993
- * the layout below it when a hint/error appears. Default on — opt out for a
2994
- * deliberately collapsing field. */
2995
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
3694
+ * the layout below it when a hint/error appears. Falls back to
3695
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
3696
+ * for a form that shows validation messages. */
3697
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3698
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
2996
3699
  private readonly track;
2997
3700
  private dragging;
2998
3701
  protected readonly uid: string;
2999
3702
  protected readonly hintId: _angular_core.Signal<string | null>;
3000
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
3703
+ private readonly fieldMessage;
3704
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
3705
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3001
3706
  protected readonly isDisabled: _angular_core.Signal<boolean>;
3002
3707
  protected readonly thumbValues: _angular_core.Signal<number[]>;
3003
3708
  protected readonly fill: _angular_core.Signal<{
@@ -3018,7 +3723,7 @@ declare class SliderComponent extends DsControlValueAccessor<SliderValue> {
3018
3723
  private setThumb;
3019
3724
  private snap;
3020
3725
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SliderComponent, never>;
3021
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SliderComponent, "ds-slider", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3726
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SliderComponent, "ds-slider", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "range": { "alias": "range"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3022
3727
  }
3023
3728
 
3024
3729
  declare class LoadingOverlayComponent {
@@ -3104,10 +3809,24 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
3104
3809
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3105
3810
  /** Helper text shown below the trigger. */
3106
3811
  readonly hint: _angular_core.InputSignal<string>;
3812
+ /** Error text. Shown immediately — binding it says the consumer has already
3813
+ * decided this field is in error. Takes precedence over `errors`. */
3814
+ readonly error: _angular_core.InputSignal<string>;
3815
+ /** Advisory text, shown when there is no error. */
3816
+ readonly warning: _angular_core.InputSignal<string>;
3817
+ /** Validation errors, shown once the user has interacted. Bound automatically
3818
+ * by signal forms; reactive and template-driven forms are read through
3819
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
3820
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
3821
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
3822
+ * `errors`, so a `required` error does not greet an untouched form. */
3823
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3107
3824
  /** Reserve the message-row height even when empty, so the field doesn't shift
3108
- * the layout below it when a hint/error appears. Default on — opt out for a
3109
- * deliberately collapsing field. */
3110
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
3825
+ * the layout below it when a hint/error appears. Falls back to
3826
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
3827
+ * for a form that shows validation messages. */
3828
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3829
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
3111
3830
  protected readonly trigger: _angular_core.Signal<ElementRef<HTMLButtonElement>>;
3112
3831
  protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
3113
3832
  protected readonly open: _angular_core.WritableSignal<boolean>;
@@ -3118,7 +3837,9 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
3118
3837
  ngOnDestroy(): void;
3119
3838
  protected readonly uid: string;
3120
3839
  protected readonly hintId: _angular_core.Signal<string | null>;
3121
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
3840
+ private readonly fieldMessage;
3841
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
3842
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3122
3843
  protected readonly isDisabled: _angular_core.Signal<boolean>;
3123
3844
  protected readonly displayHex: _angular_core.Signal<string>;
3124
3845
  protected readonly hueColor: _angular_core.Signal<string>;
@@ -3140,14 +3861,14 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
3140
3861
  protected onHuePointerUp(event: PointerEvent): void;
3141
3862
  protected onHueKeydown(event: KeyboardEvent): void;
3142
3863
  private openPanel;
3143
- close(): void;
3864
+ close(cause?: DsOverlayCloseCause): void;
3144
3865
  private setHsv;
3145
3866
  private commitHex;
3146
3867
  private updateSv;
3147
3868
  private updateHue;
3148
3869
  private clampPct;
3149
3870
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColorPickerComponent, never>;
3150
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColorPickerComponent, "ds-color-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3871
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColorPickerComponent, "ds-color-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "presets": { "alias": "presets"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3151
3872
  }
3152
3873
 
3153
3874
  interface MultiSelectOption {
@@ -3179,10 +3900,24 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
3179
3900
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3180
3901
  /** Helper text shown below the field. */
3181
3902
  readonly hint: _angular_core.InputSignal<string>;
3903
+ /** Error text. Shown immediately — binding it says the consumer has already
3904
+ * decided this field is in error. Takes precedence over `errors`. */
3905
+ readonly error: _angular_core.InputSignal<string>;
3906
+ /** Advisory text, shown when there is no error. */
3907
+ readonly warning: _angular_core.InputSignal<string>;
3908
+ /** Validation errors, shown once the user has interacted. Bound automatically
3909
+ * by signal forms; reactive and template-driven forms are read through
3910
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
3911
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
3912
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
3913
+ * `errors`, so a `required` error does not greet an untouched form. */
3914
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3182
3915
  /** Reserve the message-row height even when empty, so the field doesn't shift
3183
- * the layout below it when a hint/error appears. Default on — opt out for a
3184
- * deliberately collapsing field. */
3185
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
3916
+ * the layout below it when a hint/error appears. Falls back to
3917
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
3918
+ * for a form that shows validation messages. */
3919
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
3920
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
3186
3921
  /** Accessible name for the trigger — falls back to `placeholder`. */
3187
3922
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
3188
3923
  /** Shows a "Select all" row that toggles every filter-matching, enabled option. */
@@ -3207,7 +3942,9 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
3207
3942
  protected readonly activeDescendant: _angular_core.Signal<string | null>;
3208
3943
  protected readonly resolvedAriaLabel: _angular_core.Signal<string>;
3209
3944
  protected readonly hintId: _angular_core.Signal<string | null>;
3210
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
3945
+ private readonly fieldMessage;
3946
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
3947
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3211
3948
  private enabledFiltered;
3212
3949
  protected readonly allFilteredSelected: _angular_core.Signal<boolean>;
3213
3950
  protected readonly someFilteredSelected: _angular_core.Signal<boolean>;
@@ -3220,10 +3957,10 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
3220
3957
  protected onSearchKeydown(event: KeyboardEvent): void;
3221
3958
  protected openPanel(): void;
3222
3959
  protected onTriggerClick(): void;
3223
- protected close(): void;
3960
+ protected close(cause?: DsOverlayCloseCause): void;
3224
3961
  private moveActive;
3225
3962
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
3226
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3963
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
3227
3964
  }
3228
3965
 
3229
3966
  declare class SkeletonComponent {
@@ -3261,10 +3998,24 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
3261
3998
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3262
3999
  /** Helper text shown below the checkbox. */
3263
4000
  readonly hint: _angular_core.InputSignal<string>;
4001
+ /** Error text. Shown immediately — binding it says the consumer has already
4002
+ * decided this field is in error. Takes precedence over `errors`. */
4003
+ readonly error: _angular_core.InputSignal<string>;
4004
+ /** Advisory text, shown when there is no error. */
4005
+ readonly warning: _angular_core.InputSignal<string>;
4006
+ /** Validation errors, shown once the user has interacted. Bound automatically
4007
+ * by signal forms; reactive and template-driven forms are read through
4008
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4009
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4010
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
4011
+ * `errors`, so a `required` error does not greet an untouched form. */
4012
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3264
4013
  /** Reserve the message-row height even when empty, so the field doesn't shift
3265
- * the layout below it when a hint/error appears. Default on — opt out for a
3266
- * deliberately collapsing field. */
3267
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
4014
+ * the layout below it when a hint/error appears. Falls back to
4015
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4016
+ * for a form that shows validation messages. */
4017
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4018
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
3268
4019
  /** Checkbox size — sm/md/lg. */
3269
4020
  readonly size: _angular_core.InputSignal<DsSize>;
3270
4021
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
@@ -3276,11 +4027,13 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
3276
4027
  protected readonly uid: string;
3277
4028
  protected readonly controlId: _angular_core.Signal<string>;
3278
4029
  protected readonly hintId: _angular_core.Signal<string | null>;
3279
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
4030
+ private readonly fieldMessage;
4031
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4032
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3280
4033
  protected readonly fieldClass: _angular_core.Signal<string>;
3281
4034
  protected onCheckedChange(event: Event): void;
3282
4035
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<CheckboxComponent, never>;
3283
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxComponent, "ds-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, never, true, never>;
4036
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxComponent, "ds-checkbox", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
3284
4037
  }
3285
4038
 
3286
4039
  declare class RadioComponent {
@@ -3299,10 +4052,24 @@ declare class RadioComponent {
3299
4052
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3300
4053
  /** Helper text shown below the control. */
3301
4054
  readonly hint: _angular_core.InputSignal<string>;
4055
+ /** Error text. Shown immediately — binding it says the consumer has already
4056
+ * decided this field is in error. Takes precedence over `errors`. */
4057
+ readonly error: _angular_core.InputSignal<string>;
4058
+ /** Advisory text, shown when there is no error. */
4059
+ readonly warning: _angular_core.InputSignal<string>;
4060
+ /** Validation errors, shown once the user has interacted. Bound automatically
4061
+ * by signal forms; reactive and template-driven forms are read through
4062
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4063
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4064
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
4065
+ * `errors`, so a `required` error does not greet an untouched form. */
4066
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3302
4067
  /** Reserve the message-row height even when empty, so the field doesn't shift
3303
- * the layout below it when a hint/error appears. Default on — opt out for a
3304
- * deliberately collapsing field. */
3305
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
4068
+ * the layout below it when a hint/error appears. Falls back to
4069
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4070
+ * for a form that shows validation messages. */
4071
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4072
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
3306
4073
  /** Control size — sm/md/lg. */
3307
4074
  readonly size: _angular_core.InputSignal<DsSize>;
3308
4075
  /** Marks the radio required — shows an asterisk on the label and sets `aria-required`. */
@@ -3313,7 +4080,9 @@ declare class RadioComponent {
3313
4080
  protected readonly uid: string;
3314
4081
  protected readonly controlId: _angular_core.Signal<string>;
3315
4082
  protected readonly hintId: _angular_core.Signal<string | null>;
3316
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
4083
+ private readonly fieldMessage;
4084
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4085
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3317
4086
  /** Injected via token to avoid circular import with RadioGroupComponent. */
3318
4087
  protected readonly group: _ids_group_ltd_ids_design_system.RadioGroupContract | null;
3319
4088
  readonly effectiveDisabled: _angular_core.Signal<boolean>;
@@ -3327,7 +4096,7 @@ declare class RadioComponent {
3327
4096
  focus(): void;
3328
4097
  protected onSelect(): void;
3329
4098
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<RadioComponent, never>;
3330
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioComponent, "ds-radio", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, never, true, never>;
4099
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioComponent, "ds-radio", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
3331
4100
  }
3332
4101
 
3333
4102
  /** Contract that ds-radio reads from its parent ds-radio-group, injected via
@@ -3359,10 +4128,24 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
3359
4128
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3360
4129
  /** Helper text shown below the group. */
3361
4130
  readonly hint: _angular_core.InputSignal<string>;
4131
+ /** Error text. Shown immediately — binding it says the consumer has already
4132
+ * decided this field is in error. Takes precedence over `errors`. */
4133
+ readonly error: _angular_core.InputSignal<string>;
4134
+ /** Advisory text, shown when there is no error. */
4135
+ readonly warning: _angular_core.InputSignal<string>;
4136
+ /** Validation errors, shown once the user has interacted. Bound automatically
4137
+ * by signal forms; reactive and template-driven forms are read through
4138
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4139
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4140
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
4141
+ * `errors`, so a `required` error does not greet an untouched form. */
4142
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3362
4143
  /** Reserve the message-row height even when empty, so the field doesn't shift
3363
- * the layout below it when a hint/error appears. Default on — opt out for a
3364
- * deliberately collapsing field. */
3365
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
4144
+ * the layout below it when a hint/error appears. Falls back to
4145
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4146
+ * for a form that shows validation messages. */
4147
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4148
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
3366
4149
  /** Accessible name for the group when no visible label is provided. */
3367
4150
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
3368
4151
  /** Visible group label; omit to supply your own. */
@@ -3371,14 +4154,16 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
3371
4154
  protected readonly uid: string;
3372
4155
  readonly groupName: _angular_core.Signal<string>;
3373
4156
  protected readonly hintId: _angular_core.Signal<string | null>;
3374
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
4157
+ private readonly fieldMessage;
4158
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4159
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3375
4160
  private readonly radios;
3376
4161
  private get enabledRadios();
3377
4162
  isTabbable(radio: RadioGroupChild): boolean;
3378
4163
  select(value: unknown): void;
3379
4164
  protected onKeydown(event: KeyboardEvent): void;
3380
4165
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<RadioGroupComponent, never>;
3381
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioGroupComponent, "ds-radio-group", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["radios"], ["*"], true, never>;
4166
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioGroupComponent, "ds-radio-group", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["radios"], ["*"], true, never>;
3382
4167
  }
3383
4168
 
3384
4169
  declare class SwitchComponent extends DsBooleanControlValueAccessor {
@@ -3396,10 +4181,24 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
3396
4181
  readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
3397
4182
  /** Helper text shown below the switch. */
3398
4183
  readonly hint: _angular_core.InputSignal<string>;
4184
+ /** Error text. Shown immediately — binding it says the consumer has already
4185
+ * decided this field is in error. Takes precedence over `errors`. */
4186
+ readonly error: _angular_core.InputSignal<string>;
4187
+ /** Advisory text, shown when there is no error. */
4188
+ readonly warning: _angular_core.InputSignal<string>;
4189
+ /** Validation errors, shown once the user has interacted. Bound automatically
4190
+ * by signal forms; reactive and template-driven forms are read through
4191
+ * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
4192
+ readonly errors: _angular_core.InputSignalWithTransform<readonly DsFieldError[], DsFieldErrorsInput>;
4193
+ /** Whether the user has interacted with the field. Bound by signal forms; gates
4194
+ * `errors`, so a `required` error does not greet an untouched form. */
4195
+ readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
3399
4196
  /** Reserve the message-row height even when empty, so the field doesn't shift
3400
- * the layout below it when a hint/error appears. Default on — opt out for a
3401
- * deliberately collapsing field. */
3402
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean, unknown>;
4197
+ * the layout below it when a hint/error appears. Falls back to
4198
+ * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
4199
+ * for a form that shows validation messages. */
4200
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
4201
+ protected readonly reserveMessageResolved: _angular_core.Signal<boolean>;
3403
4202
  /** Switch size — sm/md/lg. */
3404
4203
  readonly size: _angular_core.InputSignal<DsSize>;
3405
4204
  /** Marks the field required — shows an asterisk and sets `aria-required`. */
@@ -3411,12 +4210,14 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
3411
4210
  protected readonly uid: string;
3412
4211
  protected readonly controlId: _angular_core.Signal<string>;
3413
4212
  protected readonly hintId: _angular_core.Signal<string | null>;
3414
- protected readonly messageState: _angular_core.Signal<FieldMessageState>;
4213
+ private readonly fieldMessage;
4214
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
4215
+ protected readonly invalidResolved: _angular_core.Signal<boolean>;
3415
4216
  protected readonly switchClasses: _angular_core.Signal<string>;
3416
4217
  protected readonly fieldClass: _angular_core.Signal<string>;
3417
4218
  protected onCheckedChange(event: Event): void;
3418
4219
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SwitchComponent, never>;
3419
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SwitchComponent, "ds-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, never, true, never>;
4220
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SwitchComponent, "ds-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
3420
4221
  }
3421
4222
 
3422
4223
  /**
@@ -3436,5 +4237,5 @@ declare class FieldClickFocusDirective {
3436
4237
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
3437
4238
  }
3438
4239
 
3439
- export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppLayoutComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BodyScrollLockService, BottomSheetComponent, BrandNameDirective, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_ICON_REGISTRY, DS_TOAST_CONFIG, DS_TOAST_POSITION, DS_TOAST_POSITION_DEFAULT, DatePickerComponent, DescriptionItemComponent, DescriptionListComponent, DividerComponent, DrawerComponent, DropzoneComponent, DsOverlayCloseRef, DsStaticPreview, EmptyStateComponent, FieldClickFocusDirective, ICONS, IconButtonComponent, IconComponent, InlineComponent, InputComponent, LayoutScrollService, ListComponent, ListItemComponent, LoadingOverlayComponent, MenuComponent, MenuDividerComponent, MenuItemComponent, ModalCardComponent, ModalComponent, ModalService, MultiSelectComponent, NumberStepperComponent, OtpInputComponent, PageFooterComponent, PageHeaderComponent, PaginationComponent, PopoverComponent, ProgressComponent, RADIO_GROUP, RadioComponent, RadioGroupComponent, SIDENAV, SearchComponent, SegmentedComponent, SelectComponent, SidenavComponent, SidenavFooterComponent, SidenavGroupComponent, SidenavItemComponent, SkeletonComponent, SliderComponent, SpinnerComponent, SplitButtonComponent, StackComponent, StatComponent, StatusDotComponent, StepperComponent, SwitchComponent, TabComponent, TableComponent, TabsComponent, TagComponent, TextareaComponent, TimePickerComponent, TimelineComponent, TimelineItemComponent, ToastComponent, ToastRegionComponent, ToastService, ToggleButtonComponent, TooltipDirective, TooltipPanelComponent, TopBarComponent, TreeComponent, W3wComponent, avatarTint, initialsFrom, isSelectOptionGroup, provideDsConfig, provideDsIcons, provideDsTheme };
3440
- export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteOption, AutocompleteOptionGroup, AutocompleteWidth, AvatarSize, AvatarStatus, AvatarTintOptions, BannerVariant, BreadcrumbItem, ButtonColor, ButtonType, ButtonVariant, CardElevation, CardPadding, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerSpacing, DividerVariant, DrawerPlacement, DropzoneFile, DropzoneFileState, DsConfig, DsIconRegistry, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, EmptyStateVariant, IconButtonType, IconButtonVariant, IconName, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectOption, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, SidenavAlertItem, SidenavContract, SidenavItemModel, SidenavSearchProvider, SidenavSearchResult, SortChangeEvent, SortDir, SplitButtonItem, SplitButtonVariant, StepperLabelPosition, StepperOrientation, TableCellEditEvent, TableColumn, TableRowAction, TableRowActionEvent, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TimeFormat, TimePickerMode, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };
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 };