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