@ids-group-ltd/ids-design-system 0.8.0 → 0.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +448 -0
- package/components.md +500 -0
- package/design-system.md +316 -0
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +1281 -371
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.9.0.json +178 -0
- package/migrations/README.md +21 -5
- package/package.json +1 -1
- package/styles/_dropdown-overlay.scss +34 -7
- package/styles/_field-box.scss +8 -3
- package/styles/_surface-motion.scss +48 -3
- package/styles/_tokens.scss +1 -4
- package/types/ids-group-ltd-ids-design-system.d.ts +652 -113
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import * as _angular_core from '@angular/core';
|
|
2
2
|
import { InjectionToken, Provider, EnvironmentProviders, ElementRef, TemplateRef, ModelSignal, OnDestroy } from '@angular/core';
|
|
3
3
|
import { SafeHtml } from '@angular/platform-browser';
|
|
4
|
+
import { Observable } from 'rxjs';
|
|
4
5
|
import { ControlValueAccessor } from '@angular/forms';
|
|
5
6
|
import { CdkDragDrop } from '@angular/cdk/drag-drop';
|
|
6
7
|
import * as _ids_group_ltd_ids_design_system from '@ids-group-ltd/ids-design-system';
|
|
@@ -316,6 +317,9 @@ type ButtonVariant = 'solid' | 'tonal' | 'ghost' | 'outline' | 'text';
|
|
|
316
317
|
type ButtonType = 'button' | 'submit' | 'reset';
|
|
317
318
|
|
|
318
319
|
declare class ButtonComponent {
|
|
320
|
+
/** Segment of a ds-field-group: the group owns the border, radius and focus
|
|
321
|
+
* ring, so .in-group strips this control back to its bare contents. */
|
|
322
|
+
protected readonly inGroup: boolean;
|
|
319
323
|
/** Brand/status hue family. */
|
|
320
324
|
readonly color: _angular_core.InputSignal<ButtonColor>;
|
|
321
325
|
/** Fill pattern: solid | tonal | ghost | outline | text. All color×variant
|
|
@@ -452,6 +456,94 @@ declare class StatusDotComponent {
|
|
|
452
456
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<StatusDotComponent, "ds-status-dot", never, { "status": { "alias": "status"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
453
457
|
}
|
|
454
458
|
|
|
459
|
+
/**
|
|
460
|
+
* When the layout resets the content scroll to the top.
|
|
461
|
+
*
|
|
462
|
+
* `'path'` (default) is today's behaviour: only when navigation lands on a
|
|
463
|
+
* different PATH, so a search, a sort or a page step on the same screen keeps
|
|
464
|
+
* the reader's place. `'always'` resets on every navigation, which is what a
|
|
465
|
+
* server-paged list usually wants — a new page should start at the top.
|
|
466
|
+
* `'never'` hands the decision back to the screen, which can still call
|
|
467
|
+
* `LayoutScrollService.scrollToTop()` itself.
|
|
468
|
+
*/
|
|
469
|
+
type DsScrollReset = 'path' | 'never' | 'always';
|
|
470
|
+
/**
|
|
471
|
+
* Owns the layout's content scroller. In the fixed-frame layout the window never
|
|
472
|
+
* scrolls, so the router's built-in window-based scrolling no-ops — this service
|
|
473
|
+
* resets the registered container to the top when navigation lands on a different
|
|
474
|
+
* PATH instead. Provided by `ds-app-layout`, so routed pages can
|
|
475
|
+
* `inject(LayoutScrollService)` and call `scrollToTop()` manually (e.g. list pages
|
|
476
|
+
* that DO want the top after a filter change).
|
|
477
|
+
*
|
|
478
|
+
* With `restoreScroll` on the layout it also restores the reader's place. Only
|
|
479
|
+
* when ARMED, which is the whole design: going BACK to a list should return to
|
|
480
|
+
* where the reader was, while following a link into a new screen should not.
|
|
481
|
+
*/
|
|
482
|
+
declare class LayoutScrollService {
|
|
483
|
+
private readonly navigation;
|
|
484
|
+
private readonly router;
|
|
485
|
+
private readonly destroyRef;
|
|
486
|
+
private readonly container;
|
|
487
|
+
/**
|
|
488
|
+
* The content scroller, once the layout has rendered it. Exposed so a host that
|
|
489
|
+
* must measure or drive the scroll itself — a scroll-spy, a virtualizer — can
|
|
490
|
+
* ask the layout for it instead of guessing the layout's internal markup with
|
|
491
|
+
* `document.querySelector`.
|
|
492
|
+
*/
|
|
493
|
+
readonly scroller: _angular_core.Signal<Element | null>;
|
|
494
|
+
private restoreTimeoutMs;
|
|
495
|
+
private resetStrategy;
|
|
496
|
+
private armed;
|
|
497
|
+
private pendingOffset;
|
|
498
|
+
private endRestore;
|
|
499
|
+
private firstNavigation;
|
|
500
|
+
constructor();
|
|
501
|
+
/**
|
|
502
|
+
* Wiring, called by `ds-app-layout` once its content region exists. Public only
|
|
503
|
+
* because the component and the service sit in different files - a consumer has
|
|
504
|
+
* no reason to call it, and calling it points the service at the wrong element.
|
|
505
|
+
*/
|
|
506
|
+
setScrollContainer(element: Element): void;
|
|
507
|
+
/** Wiring: `ds-app-layout` mirrors its `restoreScroll` inputs through here. */
|
|
508
|
+
configureRestore(timeoutMs: number | null): void;
|
|
509
|
+
/** Wiring: `ds-app-layout` mirrors its `scrollReset` input through here. */
|
|
510
|
+
configureReset(strategy: DsScrollReset): void;
|
|
511
|
+
scrollToTop(): void;
|
|
512
|
+
/**
|
|
513
|
+
* Scroll the content region to an absolute offset. Assigns `scrollTop` rather
|
|
514
|
+
* than calling `scrollTo`, so a themed `scroll-behavior: smooth` cannot turn a
|
|
515
|
+
* positioning jump into an animation.
|
|
516
|
+
*/
|
|
517
|
+
scrollTo(top: number): void;
|
|
518
|
+
/**
|
|
519
|
+
* Take the offset this navigation is going to restore, and cancel the restore.
|
|
520
|
+
*
|
|
521
|
+
* For a host that renders its own scroll position — a virtualizer needs the
|
|
522
|
+
* offset BEFORE it decides which rows to build, so letting the service assign
|
|
523
|
+
* `scrollTop` afterwards would scroll a list that has not been built yet.
|
|
524
|
+
* Returns null when nothing is pending, which is every navigation that is not a
|
|
525
|
+
* back.
|
|
526
|
+
*/
|
|
527
|
+
consumePendingOffset(): number | null;
|
|
528
|
+
/**
|
|
529
|
+
* Optional accelerator: tell the layout the content for this route is in the
|
|
530
|
+
* DOM. Without it the restore still lands — it waits for the container to grow
|
|
531
|
+
* and clamps at the deadline — but a host that knows when its data arrived can
|
|
532
|
+
* end the wait early instead of paying the growth watch.
|
|
533
|
+
*/
|
|
534
|
+
contentReady(): void;
|
|
535
|
+
private onNavigationStart;
|
|
536
|
+
private onNavigationEnd;
|
|
537
|
+
private beginRestore;
|
|
538
|
+
private applyClamped;
|
|
539
|
+
private finishRestore;
|
|
540
|
+
private read;
|
|
541
|
+
private remember;
|
|
542
|
+
private recall;
|
|
543
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<LayoutScrollService, never>;
|
|
544
|
+
static ɵprov: _angular_core.ɵɵInjectableDeclaration<LayoutScrollService>;
|
|
545
|
+
}
|
|
546
|
+
|
|
455
547
|
/**
|
|
456
548
|
* Fixed-frame application layout: the host is pinned to the viewport
|
|
457
549
|
* (`100dvh` + `overflow: hidden`) and ONLY the content region scrolls, so
|
|
@@ -509,6 +601,16 @@ declare class AppLayoutComponent {
|
|
|
509
601
|
* landing as close as it allows. Only meaningful with `restoreScroll`.
|
|
510
602
|
*/
|
|
511
603
|
readonly restoreScrollTimeout: _angular_core.InputSignal<number>;
|
|
604
|
+
/**
|
|
605
|
+
* When the content scroll resets to the top. `'path'` (default) is what the
|
|
606
|
+
* layout has always done; `'always'` also resets on a query- or fragment-only
|
|
607
|
+
* navigation, which is what a server-paged list wants; `'never'` hands the
|
|
608
|
+
* decision to the screen, which can still call `LayoutScrollService.scrollToTop()`.
|
|
609
|
+
*
|
|
610
|
+
* It exists because the layout owning the scroll CONTAINER also meant it owned
|
|
611
|
+
* the POLICY: a screen could add a reset but had no way to suppress one.
|
|
612
|
+
*/
|
|
613
|
+
readonly scrollReset: _angular_core.InputSignal<DsScrollReset>;
|
|
512
614
|
/**
|
|
513
615
|
* True only while the rail is an overlay. Gates the dialog semantics: above
|
|
514
616
|
* the breakpoint the rail is an ordinary region, and a permanent
|
|
@@ -528,7 +630,7 @@ declare class AppLayoutComponent {
|
|
|
528
630
|
protected closeRail(): void;
|
|
529
631
|
private watchDesktopBreakpoint;
|
|
530
632
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppLayoutComponent, never>;
|
|
531
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppLayoutComponent, "ds-app-layout", never, { "topbarSpan": { "alias": "topbarSpan"; "required": false; "isSignal": true; }; "railOpen": { "alias": "railOpen"; "required": false; "isSignal": true; }; "railLabel": { "alias": "railLabel"; "required": false; "isSignal": true; }; "restoreScroll": { "alias": "restoreScroll"; "required": false; "isSignal": true; }; "restoreScrollTimeout": { "alias": "restoreScrollTimeout"; "required": false; "isSignal": true; }; }, { "railOpen": "railOpenChange"; }, never, ["[sidenav]", "[topbar]", "*"], true, never>;
|
|
633
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppLayoutComponent, "ds-app-layout", never, { "topbarSpan": { "alias": "topbarSpan"; "required": false; "isSignal": true; }; "railOpen": { "alias": "railOpen"; "required": false; "isSignal": true; }; "railLabel": { "alias": "railLabel"; "required": false; "isSignal": true; }; "restoreScroll": { "alias": "restoreScroll"; "required": false; "isSignal": true; }; "restoreScrollTimeout": { "alias": "restoreScrollTimeout"; "required": false; "isSignal": true; }; "scrollReset": { "alias": "scrollReset"; "required": false; "isSignal": true; }; }, { "railOpen": "railOpenChange"; }, never, ["[sidenav]", "[topbar]", "*"], true, never>;
|
|
532
634
|
}
|
|
533
635
|
|
|
534
636
|
/**
|
|
@@ -548,8 +650,8 @@ declare class AppLayoutComponent {
|
|
|
548
650
|
* host element, and on `<ds-icon-button>` that is the wrapper, whose inner
|
|
549
651
|
* `<button>` is what a screen reader actually reads. With a DS button, skip this
|
|
550
652
|
* directive and bind its forwarding inputs instead —
|
|
551
|
-
* `[ariaExpanded]="
|
|
552
|
-
* `[ariaControls]="
|
|
653
|
+
* `[ariaExpanded]="layout.railOverlay() ? layout.railOpen() : null"` and
|
|
654
|
+
* `[ariaControls]="layout.railId"` off a `<ds-app-layout #layout>` template ref.
|
|
553
655
|
*
|
|
554
656
|
* Both attributes are dropped while the rail is NOT an overlay: above the
|
|
555
657
|
* breakpoint the rail is permanently in the layout, so `aria-expanded="false"`
|
|
@@ -567,77 +669,45 @@ declare class RailTriggerDirective {
|
|
|
567
669
|
}
|
|
568
670
|
|
|
569
671
|
/**
|
|
570
|
-
*
|
|
571
|
-
*
|
|
572
|
-
*
|
|
573
|
-
*
|
|
574
|
-
*
|
|
575
|
-
* that DO want the top after a filter change).
|
|
672
|
+
* Emits the new path whenever navigation lands on a DIFFERENT one. A query- or
|
|
673
|
+
* fragment-only navigation is a search, sort or page step on the same screen, and
|
|
674
|
+
* everything that reacts to "went somewhere else" must agree on that — the scroll
|
|
675
|
+
* reset, the responsive rail, and now your own code — so they read one source
|
|
676
|
+
* instead of each deciding for itself.
|
|
576
677
|
*
|
|
577
|
-
*
|
|
578
|
-
*
|
|
579
|
-
*
|
|
678
|
+
* PUBLIC since 0.8.x, because consumers were re-deriving it and disagreeing: one
|
|
679
|
+
* consumer had three separate answers to "did the path change?" — route snapshots
|
|
680
|
+
* in a view-transition skip, this stream inside the layout, and a `split('?')`
|
|
681
|
+
* in a tab helper that ignored the fragment this one strips. Inject it and read
|
|
682
|
+
* `pathChanged` rather than writing a fourth:
|
|
683
|
+
*
|
|
684
|
+
* ```ts
|
|
685
|
+
* private readonly navigation = inject(LayoutNavigationService);
|
|
686
|
+
* constructor() {
|
|
687
|
+
* this.navigation.pathChanged
|
|
688
|
+
* .pipe(takeUntilDestroyed())
|
|
689
|
+
* .subscribe((path) => …);
|
|
690
|
+
* }
|
|
691
|
+
* ```
|
|
692
|
+
*
|
|
693
|
+
* A PATH change is not always a page change. An app whose URL mirrors the
|
|
694
|
+
* reader's position — a docs layout rewriting `/area/section` from a scroll spy,
|
|
695
|
+
* a wizard that names its step — changes the path while staying on the screen,
|
|
696
|
+
* and resetting the scroll there fights the user: the reset moves the scroll,
|
|
697
|
+
* the spy rewrites the path again, and the page ping-pongs. Such a navigation
|
|
698
|
+
* must carry `state: { dsSamePage: true }`, which is skipped here.
|
|
699
|
+
*
|
|
700
|
+
* Root-provided, which is also what makes it safe to expose: the stream is
|
|
701
|
+
* derived from the router and holds no state, so one instance serves every
|
|
702
|
+
* reader. `LayoutScrollService` depends on it, so a consumer providing THAT
|
|
703
|
+
* outside `ds-app-layout` needs this one resolvable too.
|
|
580
704
|
*/
|
|
581
|
-
declare class
|
|
582
|
-
private readonly navigation;
|
|
705
|
+
declare class LayoutNavigationService {
|
|
583
706
|
private readonly router;
|
|
584
|
-
|
|
585
|
-
private
|
|
586
|
-
|
|
587
|
-
|
|
588
|
-
* must measure or drive the scroll itself — a scroll-spy, a virtualizer — can
|
|
589
|
-
* ask the layout for it instead of guessing the layout's internal markup with
|
|
590
|
-
* `document.querySelector`.
|
|
591
|
-
*/
|
|
592
|
-
readonly scroller: _angular_core.Signal<Element | null>;
|
|
593
|
-
private restoreTimeoutMs;
|
|
594
|
-
private armed;
|
|
595
|
-
private pendingOffset;
|
|
596
|
-
private endRestore;
|
|
597
|
-
private firstNavigation;
|
|
598
|
-
constructor();
|
|
599
|
-
/**
|
|
600
|
-
* Wiring, called by `ds-app-layout` once its content region exists. Public only
|
|
601
|
-
* because the component and the service sit in different files - a consumer has
|
|
602
|
-
* no reason to call it, and calling it points the service at the wrong element.
|
|
603
|
-
*/
|
|
604
|
-
setScrollContainer(element: Element): void;
|
|
605
|
-
/** Wiring: `ds-app-layout` mirrors its `restoreScroll` inputs through here. */
|
|
606
|
-
configureRestore(timeoutMs: number | null): void;
|
|
607
|
-
scrollToTop(): void;
|
|
608
|
-
/**
|
|
609
|
-
* Scroll the content region to an absolute offset. Assigns `scrollTop` rather
|
|
610
|
-
* than calling `scrollTo`, so a themed `scroll-behavior: smooth` cannot turn a
|
|
611
|
-
* positioning jump into an animation.
|
|
612
|
-
*/
|
|
613
|
-
scrollTo(top: number): void;
|
|
614
|
-
/**
|
|
615
|
-
* Take the offset this navigation is going to restore, and cancel the restore.
|
|
616
|
-
*
|
|
617
|
-
* For a host that renders its own scroll position — a virtualizer needs the
|
|
618
|
-
* offset BEFORE it decides which rows to build, so letting the service assign
|
|
619
|
-
* `scrollTop` afterwards would scroll a list that has not been built yet.
|
|
620
|
-
* Returns null when nothing is pending, which is every navigation that is not a
|
|
621
|
-
* back.
|
|
622
|
-
*/
|
|
623
|
-
consumePendingOffset(): number | null;
|
|
624
|
-
/**
|
|
625
|
-
* Optional accelerator: tell the layout the content for this route is in the
|
|
626
|
-
* DOM. Without it the restore still lands — it waits for the container to grow
|
|
627
|
-
* and clamps at the deadline — but a host that knows when its data arrived can
|
|
628
|
-
* end the wait early instead of paying the growth watch.
|
|
629
|
-
*/
|
|
630
|
-
contentReady(): void;
|
|
631
|
-
private onNavigationStart;
|
|
632
|
-
private onNavigationEnd;
|
|
633
|
-
private beginRestore;
|
|
634
|
-
private applyClamped;
|
|
635
|
-
private finishRestore;
|
|
636
|
-
private read;
|
|
637
|
-
private remember;
|
|
638
|
-
private recall;
|
|
639
|
-
static ɵfac: _angular_core.ɵɵFactoryDeclaration<LayoutScrollService, never>;
|
|
640
|
-
static ɵprov: _angular_core.ɵɵInjectableDeclaration<LayoutScrollService>;
|
|
707
|
+
readonly pathChanged: Observable<string>;
|
|
708
|
+
private samePage;
|
|
709
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<LayoutNavigationService, never>;
|
|
710
|
+
static ɵprov: _angular_core.ɵɵInjectableDeclaration<LayoutNavigationService>;
|
|
641
711
|
}
|
|
642
712
|
|
|
643
713
|
type CardElevation = 'flat' | 'raised' | 'hover' | 'interactive';
|
|
@@ -670,22 +740,29 @@ declare class BrandNameDirective {
|
|
|
670
740
|
* content fits. Here the host is the only one, and it also carries the safe-area
|
|
671
741
|
* insets a notched phone in landscape needs.
|
|
672
742
|
*
|
|
673
|
-
* The brand row
|
|
674
|
-
* plus wordmark, `logoLetter` overrides the glyph, `[dsBrandName]`
|
|
675
|
-
* two-tone wordmark
|
|
743
|
+
* The brand row takes the same CONTRACT as `ds-sidenav` — a `brand` string gets a
|
|
744
|
+
* letter-mark tile plus wordmark, `logoLetter` overrides the glyph, `[dsBrandName]`
|
|
745
|
+
* projects a two-tone wordmark (import `BrandNameDirective` alongside this
|
|
746
|
+
* component, or the attribute is inert and the wordmark lands in the card), and
|
|
747
|
+
* `[brand]` projects a real logo. The two are not pixel-identical: the rail's tile
|
|
748
|
+
* is a fixed 28px at weight 800, this one 24-32px at 700, and each has its own
|
|
749
|
+
* `--ds-*-mark-*` hooks, so retinting the mark means setting both.
|
|
750
|
+
*
|
|
751
|
+
* Projecting into `[brand]` does NOT suppress the tile — leave `brand`/`logoLetter`
|
|
752
|
+
* unset when you supply a logo.
|
|
676
753
|
*
|
|
677
754
|
* ```html
|
|
678
|
-
* <ds-auth-
|
|
755
|
+
* <ds-auth-layout brand="MyAdmin" logoLetter="A" tagline="Broker administration">
|
|
679
756
|
* <h1 class="title">Sign in</h1>
|
|
680
757
|
* <form class="form">…</form>
|
|
681
758
|
*
|
|
682
759
|
* <p dsAuthSupport>
|
|
683
760
|
* Need a hand? <a href="mailto:support@example.com">Contact support</a>
|
|
684
761
|
* </p>
|
|
685
|
-
* </ds-auth-
|
|
762
|
+
* </ds-auth-layout>
|
|
686
763
|
* ```
|
|
687
764
|
*/
|
|
688
|
-
declare class
|
|
765
|
+
declare class AuthLayoutComponent {
|
|
689
766
|
/** Wordmark beside the letter-mark tile. For a logo image/SVG, project it into
|
|
690
767
|
* the `[brand]` slot instead; for a two-tone wordmark use `[dsBrandName]`. */
|
|
691
768
|
readonly brand: _angular_core.InputSignal<string>;
|
|
@@ -698,11 +775,24 @@ declare class AuthShellComponent {
|
|
|
698
775
|
readonly cardElevation: _angular_core.InputSignal<CardElevation>;
|
|
699
776
|
/** Card padding, passed through to `ds-card`. `md` tightens a short form. */
|
|
700
777
|
readonly cardPadding: _angular_core.InputSignal<CardPadding>;
|
|
778
|
+
/** Announce the card as the page's `main` landmark. The card holds the whole
|
|
779
|
+
* content of an auth screen and `ds-card` renders an `<article>`, which is NOT
|
|
780
|
+
* a landmark, so by default a screen-reader user has nothing to jump to — set
|
|
781
|
+
* this to `'main'` on a standalone auth page. It is opt-in because the layout
|
|
782
|
+
* is also embedded inside pages that already own a `main` (this repo's own docs
|
|
783
|
+
* site nests it inside `ds-app-layout`), and two `main`s is its own violation.
|
|
784
|
+
* Defaulting it to `'main'` is the better end state and belongs in the next
|
|
785
|
+
* batch of default changes. */
|
|
786
|
+
readonly landmark: _angular_core.InputSignal<"main" | "none">;
|
|
701
787
|
/** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
|
|
702
788
|
protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
|
|
703
789
|
protected readonly hasBrandName: _angular_core.Signal<boolean>;
|
|
704
|
-
|
|
705
|
-
|
|
790
|
+
/** Spread, not `charAt(0)`: the latter indexes UTF-16 code UNITS, so a brand
|
|
791
|
+
* starting with an astral character (an emoji, a rarer CJK glyph) yields half
|
|
792
|
+
* a surrogate pair and paints as tofu. */
|
|
793
|
+
protected readonly markGlyph: _angular_core.Signal<string>;
|
|
794
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<AuthLayoutComponent, never>;
|
|
795
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<AuthLayoutComponent, "ds-auth-layout", never, { "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "logoLetter": { "alias": "logoLetter"; "required": false; "isSignal": true; }; "tagline": { "alias": "tagline"; "required": false; "isSignal": true; }; "cardElevation": { "alias": "cardElevation"; "required": false; "isSignal": true; }; "cardPadding": { "alias": "cardPadding"; "required": false; "isSignal": true; }; "landmark": { "alias": "landmark"; "required": false; "isSignal": true; }; }, {}, ["brandNameRef"], ["[brand]", "[dsBrandName]", "*", "[dsAuthSupport]"], true, never>;
|
|
706
796
|
}
|
|
707
797
|
|
|
708
798
|
/**
|
|
@@ -778,6 +868,59 @@ declare class FilterBarComponent {
|
|
|
778
868
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<FilterBarComponent, "ds-filter-bar", never, { "moreLabel": { "alias": "moreLabel"; "required": false; "isSignal": true; }; "panelLabel": { "alias": "panelLabel"; "required": false; "isSignal": true; }; }, {}, ["items"], ["[dsFilterBarTrailing]", "*"], true, never>;
|
|
779
869
|
}
|
|
780
870
|
|
|
871
|
+
/** What a grouped control can read off the group that encloses it. */
|
|
872
|
+
interface DsFieldGroupContext {
|
|
873
|
+
/** The group's size, so a segment matches its neighbours without being told. */
|
|
874
|
+
readonly size: () => DsSize;
|
|
875
|
+
}
|
|
876
|
+
/**
|
|
877
|
+
* Provided by `ds-field-group`, injected `{ optional: true }` by every control
|
|
878
|
+
* that can be a segment.
|
|
879
|
+
*
|
|
880
|
+
* DI rather than a `[grouped]` input on each child: the alternative is manual,
|
|
881
|
+
* and one segment where it was forgotten renders its own border and radius in
|
|
882
|
+
* the middle of a glued row — a broken control that still looks deliberate.
|
|
883
|
+
* Presence of the token IS the fact the child needs, and the consumer already
|
|
884
|
+
* declared it by wrapping them.
|
|
885
|
+
*/
|
|
886
|
+
declare const DS_FIELD_GROUP: InjectionToken<DsFieldGroupContext>;
|
|
887
|
+
|
|
888
|
+
/**
|
|
889
|
+
* One bordered control out of several: `select + input`, `search + button`,
|
|
890
|
+
* `button + select`. The group owns the border, the radius, the focus ring and
|
|
891
|
+
* the divider between segments; the controls inside render "naked".
|
|
892
|
+
*
|
|
893
|
+
* Segments are the direct children. Each hugs its content by default; mark the
|
|
894
|
+
* one that should take the slack with `grow`:
|
|
895
|
+
*
|
|
896
|
+
* ```html
|
|
897
|
+
* <ds-field-group>
|
|
898
|
+
* <ds-select [options]="scopes" />
|
|
899
|
+
* <ds-input grow placeholder="Search…" />
|
|
900
|
+
* </ds-field-group>
|
|
901
|
+
* ```
|
|
902
|
+
*
|
|
903
|
+
* A control knows it is a segment by injecting `DS_FIELD_GROUP` — see the token
|
|
904
|
+
* for why that is DI and not an input. Grouped controls must not carry a `label`
|
|
905
|
+
* or a `hint`: their own message row would break the glued line, so it is
|
|
906
|
+
* suppressed and a group-level one is not built yet.
|
|
907
|
+
*/
|
|
908
|
+
declare class FieldGroupComponent implements DsFieldGroupContext {
|
|
909
|
+
/** Segment height — the field family's scale, so a group lines up with a
|
|
910
|
+
* plain field beside it. */
|
|
911
|
+
readonly size: _angular_core.InputSignal<DsSize>;
|
|
912
|
+
/** Draws the error border on the whole group. A single segment cannot be
|
|
913
|
+
* invalid on its own: the border belongs to the group. */
|
|
914
|
+
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
915
|
+
/** Dims the group. Disable the CONTROLS too — this is the chrome, not their
|
|
916
|
+
* interactivity. */
|
|
917
|
+
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
918
|
+
/** Fills the container instead of hugging its segments. */
|
|
919
|
+
readonly fullWidth: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
920
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<FieldGroupComponent, never>;
|
|
921
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<FieldGroupComponent, "ds-field-group", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
|
|
922
|
+
}
|
|
923
|
+
|
|
781
924
|
type AvatarSize = 'xs' | DsSize;
|
|
782
925
|
type AvatarStatus = 'online' | 'offline' | 'away' | 'busy';
|
|
783
926
|
|
|
@@ -872,9 +1015,18 @@ declare class CardComponent {
|
|
|
872
1015
|
}
|
|
873
1016
|
|
|
874
1017
|
declare class StatComponent {
|
|
1018
|
+
constructor();
|
|
875
1019
|
/** Metric name shown above the value. */
|
|
876
1020
|
readonly label: _angular_core.InputSignal<string>;
|
|
877
|
-
/** Headline metric; `unit` is appended directly after it.
|
|
1021
|
+
/** Headline metric; `unit` is appended directly after it.
|
|
1022
|
+
*
|
|
1023
|
+
* Optional because the value can be PROJECTED instead — `[dsStatValue]`
|
|
1024
|
+
* takes a badge, a status dot, anything a tile needs where a number would go.
|
|
1025
|
+
* The input is the fallback, the same shape `[delta]` already has.
|
|
1026
|
+
*
|
|
1027
|
+
* Namespaced, unlike `[delta]`: twenty components in this library have a
|
|
1028
|
+
* `value` input, so a bare `value` attribute used to slot one of them in
|
|
1029
|
+
* would also set that input to the empty string. */
|
|
878
1030
|
readonly value: _angular_core.InputSignal<string | number>;
|
|
879
1031
|
/** Change amount; sign drives the up/down arrow and color. */
|
|
880
1032
|
readonly delta: _angular_core.InputSignal<number | null>;
|
|
@@ -894,7 +1046,7 @@ declare class StatComponent {
|
|
|
894
1046
|
protected readonly deltaIcon: _angular_core.Signal<"arrowUp" | "arrowDown" | null>;
|
|
895
1047
|
protected readonly deltaText: _angular_core.Signal<string>;
|
|
896
1048
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<StatComponent, never>;
|
|
897
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<StatComponent, "ds-stat", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required":
|
|
1049
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<StatComponent, "ds-stat", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "delta": { "alias": "delta"; "required": false; "isSignal": true; }; "deltaLabel": { "alias": "deltaLabel"; "required": false; "isSignal": true; }; "deltaTone": { "alias": "deltaTone"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "unit": { "alias": "unit"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, ["[dsStatValue]", "[delta]"], true, never>;
|
|
898
1050
|
}
|
|
899
1051
|
|
|
900
1052
|
declare class TabComponent {
|
|
@@ -933,6 +1085,27 @@ declare class TabsComponent {
|
|
|
933
1085
|
/** Controls whether the tab list and panel are stacked horizontally (default)
|
|
934
1086
|
or the tab list runs vertically beside the panel. */
|
|
935
1087
|
readonly orientation: _angular_core.InputSignal<TabsOrientation>;
|
|
1088
|
+
/**
|
|
1089
|
+
* Keep the active tab in a query parameter, so it survives F5, a shared link
|
|
1090
|
+
* and the Back button: `urlParam="tab"` gives `?tab=activity`. Empty (the
|
|
1091
|
+
* default) leaves the URL alone, and the strip works exactly as before.
|
|
1092
|
+
*
|
|
1093
|
+
* The names come from each `ds-tab`'s `value` (falling back to its `label`),
|
|
1094
|
+
* so there is no second list to keep in step. **Names, not indices** — writing
|
|
1095
|
+
* `?tab=1` would silently repoint every old link the moment a tab is inserted.
|
|
1096
|
+
* The FIRST tab writes no parameter and every write REPLACES the history
|
|
1097
|
+
* entry, so a pristine screen keeps a clean address and flipping tabs does not
|
|
1098
|
+
* fill the Back button.
|
|
1099
|
+
*
|
|
1100
|
+
* An unknown or missing name lands on the first tab rather than throwing: a
|
|
1101
|
+
* URL is user input, and a stale bookmark should still open the screen.
|
|
1102
|
+
*
|
|
1103
|
+
* Outside a routed context the input is inert. Nothing router-shaped is even
|
|
1104
|
+
* resolved until you set it — no DI lookup and, more to the point, no
|
|
1105
|
+
* subscription — so a strip that never uses this costs exactly what it did
|
|
1106
|
+
* before the input existed.
|
|
1107
|
+
*/
|
|
1108
|
+
readonly urlParam: _angular_core.InputSignal<string>;
|
|
936
1109
|
/** Emitted when a close button is clicked. Carries the tab's value input, or
|
|
937
1110
|
its label when value is not set. The host is responsible for removing the
|
|
938
1111
|
tab from its list. */
|
|
@@ -940,6 +1113,16 @@ declare class TabsComponent {
|
|
|
940
1113
|
private readonly host;
|
|
941
1114
|
private readonly uid;
|
|
942
1115
|
protected readonly tabs: _angular_core.Signal<readonly TabComponent[]>;
|
|
1116
|
+
private readonly injector;
|
|
1117
|
+
private router;
|
|
1118
|
+
private route;
|
|
1119
|
+
private readonly urlParams;
|
|
1120
|
+
constructor();
|
|
1121
|
+
/** Resolves the router pair on first use. Null outside a routed context, which
|
|
1122
|
+
* makes `urlParam` inert there rather than an error. */
|
|
1123
|
+
private resolveRouting;
|
|
1124
|
+
private tabName;
|
|
1125
|
+
private writeUrl;
|
|
943
1126
|
/** Tracks which tab indices have ever been activated (for lazy rendering). */
|
|
944
1127
|
private readonly activatedIndices;
|
|
945
1128
|
protected tabId(index: number): string;
|
|
@@ -955,7 +1138,7 @@ declare class TabsComponent {
|
|
|
955
1138
|
Arrow axis follows orientation: Left/Right for horizontal, Up/Down for vertical. */
|
|
956
1139
|
protected onKeydown(event: KeyboardEvent, index: number): void;
|
|
957
1140
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabsComponent, never>;
|
|
958
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabsComponent, "ds-tabs", never, { "selectedIndex": { "alias": "selectedIndex"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "scrollable": { "alias": "scrollable"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; }, { "selectedIndex": "selectedIndexChange"; "tabClosed": "tabClosed"; }, ["tabs"], never, true, never>;
|
|
1141
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabsComponent, "ds-tabs", never, { "selectedIndex": { "alias": "selectedIndex"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "scrollable": { "alias": "scrollable"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "urlParam": { "alias": "urlParam"; "required": false; "isSignal": true; }; }, { "selectedIndex": "selectedIndexChange"; "tabClosed": "tabClosed"; }, ["tabs"], never, true, never>;
|
|
959
1142
|
}
|
|
960
1143
|
|
|
961
1144
|
type FieldMessageState = 'default' | 'error' | 'warning' | 'success';
|
|
@@ -997,6 +1180,20 @@ interface DsFieldMessage {
|
|
|
997
1180
|
declare abstract class DsControlValueAccessor<T> implements ControlValueAccessor {
|
|
998
1181
|
/** The component's two-way value model. */
|
|
999
1182
|
abstract readonly value: ModelSignal<T>;
|
|
1183
|
+
/**
|
|
1184
|
+
* Hides the control. On the base so signal forms reaches every control at once.
|
|
1185
|
+
* Inline `display`, not the `hidden` attribute — each control sets its own
|
|
1186
|
+
* `:host` display, which the attribute's weaker UA rule would lose to.
|
|
1187
|
+
*/
|
|
1188
|
+
readonly hidden: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1189
|
+
private readonly hostElement;
|
|
1190
|
+
/**
|
|
1191
|
+
* Signal forms calls this through `focusBoundControl()` — typically to reach
|
|
1192
|
+
* the first invalid field after a failed submit. Without it the default is to
|
|
1193
|
+
* focus the HOST, and a `<ds-*>` element is not focusable, so focus went
|
|
1194
|
+
* nowhere. A control with a more precise target overrides this.
|
|
1195
|
+
*/
|
|
1196
|
+
focus(options?: FocusOptions): void;
|
|
1000
1197
|
/** Driven by the forms API via `setDisabledState`. */
|
|
1001
1198
|
protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
|
|
1002
1199
|
protected readonly touchedSelf: _angular_core.WritableSignal<boolean>;
|
|
@@ -1012,7 +1209,7 @@ declare abstract class DsControlValueAccessor<T> implements ControlValueAccessor
|
|
|
1012
1209
|
registerOnTouched(fn: () => void): void;
|
|
1013
1210
|
setDisabledState(isDisabled: boolean): void;
|
|
1014
1211
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsControlValueAccessor<any>, never>;
|
|
1015
|
-
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsControlValueAccessor<any>, never, never, {}, {}, never, never, true, never>;
|
|
1212
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsControlValueAccessor<any>, never, never, { "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
1016
1213
|
}
|
|
1017
1214
|
/**
|
|
1018
1215
|
* Shared `ControlValueAccessor` for DS boolean controls (checkbox, switch)
|
|
@@ -1024,6 +1221,16 @@ declare abstract class DsControlValueAccessor<T> implements ControlValueAccessor
|
|
|
1024
1221
|
declare abstract class DsBooleanControlValueAccessor implements ControlValueAccessor {
|
|
1025
1222
|
/** The component's two-way checked model. */
|
|
1026
1223
|
abstract readonly checked: ModelSignal<boolean>;
|
|
1224
|
+
/** Hides the control — see the note on `DsControlValueAccessor.hidden`. */
|
|
1225
|
+
readonly hidden: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1226
|
+
private readonly hostElement;
|
|
1227
|
+
/**
|
|
1228
|
+
* Signal forms calls this through `focusBoundControl()` — typically to reach
|
|
1229
|
+
* the first invalid field after a failed submit. Without it the default is to
|
|
1230
|
+
* focus the HOST, and a `<ds-*>` element is not focusable, so focus went
|
|
1231
|
+
* nowhere. A control with a more precise target overrides this.
|
|
1232
|
+
*/
|
|
1233
|
+
focus(options?: FocusOptions): void;
|
|
1027
1234
|
/** Driven by the forms API via `setDisabledState`. */
|
|
1028
1235
|
protected readonly formDisabled: _angular_core.WritableSignal<boolean>;
|
|
1029
1236
|
protected readonly touchedSelf: _angular_core.WritableSignal<boolean>;
|
|
@@ -1039,13 +1246,16 @@ declare abstract class DsBooleanControlValueAccessor implements ControlValueAcce
|
|
|
1039
1246
|
registerOnTouched(fn: () => void): void;
|
|
1040
1247
|
setDisabledState(isDisabled: boolean): void;
|
|
1041
1248
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsBooleanControlValueAccessor, never>;
|
|
1042
|
-
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsBooleanControlValueAccessor, never, never, {}, {}, never, never, true, never>;
|
|
1249
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsBooleanControlValueAccessor, never, never, { "hidden": { "alias": "hidden"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
1043
1250
|
}
|
|
1044
1251
|
|
|
1045
1252
|
type InputType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search';
|
|
1046
1253
|
|
|
1047
1254
|
declare class InputComponent extends DsControlValueAccessor<string> {
|
|
1048
1255
|
private readonly control;
|
|
1256
|
+
/** Segment of a ds-field-group: the group owns the border, radius and focus
|
|
1257
|
+
* ring, so .in-group strips this control back to its bare contents. */
|
|
1258
|
+
protected readonly inGroup: boolean;
|
|
1049
1259
|
/** Text value, two-way bound. */
|
|
1050
1260
|
readonly value: _angular_core.ModelSignal<string>;
|
|
1051
1261
|
/** Native input type — also affects the default clear button and password toggle. */
|
|
@@ -1080,6 +1290,12 @@ declare class InputComponent extends DsControlValueAccessor<string> {
|
|
|
1080
1290
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1081
1291
|
/** Prevents editing while still allowing focus and selection. */
|
|
1082
1292
|
readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1293
|
+
/**
|
|
1294
|
+
* The contract spelling of `readOnly`, a second input because signal forms binds
|
|
1295
|
+
* by NAME — a `readonly()` rule was reaching nothing before this existed.
|
|
1296
|
+
*/
|
|
1297
|
+
readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1298
|
+
protected readonly isReadOnly: _angular_core.Signal<boolean>;
|
|
1083
1299
|
/** Applies error styling and marks the field `aria-invalid`. */
|
|
1084
1300
|
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1085
1301
|
/** Applies success styling to the field. */
|
|
@@ -1097,9 +1313,9 @@ declare class InputComponent extends DsControlValueAccessor<string> {
|
|
|
1097
1313
|
/** Native `name` attribute. */
|
|
1098
1314
|
readonly name: _angular_core.InputSignal<string | null>;
|
|
1099
1315
|
/** Native `min` attribute — applies when `type="number"`. */
|
|
1100
|
-
readonly min: _angular_core.
|
|
1316
|
+
readonly min: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
|
|
1101
1317
|
/** Native `max` attribute — applies when `type="number"`. */
|
|
1102
|
-
readonly max: _angular_core.
|
|
1318
|
+
readonly max: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
|
|
1103
1319
|
/** Native `step` attribute — applies when `type="number"`. */
|
|
1104
1320
|
readonly step: _angular_core.InputSignal<number | null>;
|
|
1105
1321
|
/** Native autocomplete token (e.g. "email", "current-password"). */
|
|
@@ -1116,7 +1332,11 @@ declare class InputComponent extends DsControlValueAccessor<string> {
|
|
|
1116
1332
|
readonly ariaDescribedBy: _angular_core.InputSignal<string | null>;
|
|
1117
1333
|
/** Hard character cap — applies the native maxlength attribute and shows a
|
|
1118
1334
|
* live "{current}/{max}" counter below the field. */
|
|
1119
|
-
readonly maxLength: _angular_core.
|
|
1335
|
+
readonly maxLength: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
|
|
1336
|
+
/** Native `minlength` attribute. */
|
|
1337
|
+
readonly minLength: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
|
|
1338
|
+
/** Native `pattern` attribute — signal forms sends the schema's RegExp list. */
|
|
1339
|
+
readonly pattern: _angular_core.InputSignalWithTransform<readonly RegExp[], string | readonly RegExp[] | undefined>;
|
|
1120
1340
|
/** Mobile keyboard hints — forwarded to the native input as attributes. */
|
|
1121
1341
|
readonly enterKeyHint: _angular_core.InputSignal<"search" | "next" | "enter" | "done" | "go" | "previous" | "send" | null>;
|
|
1122
1342
|
/** Native `inputmode` attribute — hints the on-screen keyboard layout. */
|
|
@@ -1136,6 +1356,9 @@ declare class InputComponent extends DsControlValueAccessor<string> {
|
|
|
1136
1356
|
/** Whether the password is currently shown as plain text, two-way bound. */
|
|
1137
1357
|
readonly passwordVisible: _angular_core.ModelSignal<boolean>;
|
|
1138
1358
|
protected readonly canClear: _angular_core.Signal<boolean>;
|
|
1359
|
+
/** A native `pattern` takes ONE expression; the schema can carry several, so
|
|
1360
|
+
* they are ANDed with lookaheads rather than silently dropping all but one. */
|
|
1361
|
+
protected readonly patternAttribute: _angular_core.Signal<string | null>;
|
|
1139
1362
|
protected readonly uid: string;
|
|
1140
1363
|
protected readonly hintId: _angular_core.Signal<string | null>;
|
|
1141
1364
|
protected readonly describedBy: _angular_core.Signal<string | null>;
|
|
@@ -1157,16 +1380,16 @@ declare class InputComponent extends DsControlValueAccessor<string> {
|
|
|
1157
1380
|
focus(options?: FocusOptions): void;
|
|
1158
1381
|
protected clear(): void;
|
|
1159
1382
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<InputComponent, never>;
|
|
1160
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<InputComponent, "ds-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "floating": { "alias": "floating"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "enterKeyHint": { "alias": "enterKeyHint"; "required": false; "isSignal": true; }; "inputMode": { "alias": "inputMode"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "passwordToggle": { "alias": "passwordToggle"; "required": false; "isSignal": true; }; "passwordVisible": { "alias": "passwordVisible"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "blurred": "blurred"; "passwordVisible": "passwordVisibleChange"; }, never, ["[dsInputPrefix]", "[dsInputSuffix]"], true, never>;
|
|
1383
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<InputComponent, "ds-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "floating": { "alias": "floating"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "min": { "alias": "min"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "step": { "alias": "step"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "required": false; "isSignal": true; }; "enterKeyHint": { "alias": "enterKeyHint"; "required": false; "isSignal": true; }; "inputMode": { "alias": "inputMode"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "passwordToggle": { "alias": "passwordToggle"; "required": false; "isSignal": true; }; "passwordVisible": { "alias": "passwordVisible"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "blurred": "blurred"; "passwordVisible": "passwordVisibleChange"; }, never, ["[dsInputPrefix]", "[dsInputSuffix]"], true, never>;
|
|
1161
1384
|
}
|
|
1162
1385
|
|
|
1163
1386
|
declare class NumberStepperComponent {
|
|
1164
1387
|
/** Current numeric value, two-way bound. */
|
|
1165
1388
|
readonly value: _angular_core.ModelSignal<number>;
|
|
1166
1389
|
/** Lower bound — the decrement button and typed input clamp to it. */
|
|
1167
|
-
readonly min: _angular_core.
|
|
1390
|
+
readonly min: _angular_core.InputSignalWithTransform<number, number | undefined>;
|
|
1168
1391
|
/** Upper bound — the increment button and typed input clamp to it; unbounded when null. */
|
|
1169
|
-
readonly max: _angular_core.
|
|
1392
|
+
readonly max: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
|
|
1170
1393
|
/** Amount added or subtracted per increment/decrement. */
|
|
1171
1394
|
readonly step: _angular_core.InputSignal<number>;
|
|
1172
1395
|
/** Control height — sm/md/lg. */
|
|
@@ -1221,6 +1444,12 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
|
|
|
1221
1444
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1222
1445
|
/** Prevents editing while still allowing focus and selection. */
|
|
1223
1446
|
readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1447
|
+
/**
|
|
1448
|
+
* The contract spelling of `readOnly`, a second input because signal forms binds
|
|
1449
|
+
* by NAME — a `readonly()` rule was reaching nothing before this existed.
|
|
1450
|
+
*/
|
|
1451
|
+
readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1452
|
+
protected readonly isReadOnly: _angular_core.Signal<boolean>;
|
|
1224
1453
|
/** Applies error styling and marks the field `aria-invalid`. */
|
|
1225
1454
|
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1226
1455
|
/** Marks the field required — shows an asterisk and sets `aria-required`. */
|
|
@@ -1243,7 +1472,14 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
|
|
|
1243
1472
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
1244
1473
|
/** Hard character cap — applies the native maxlength attribute and shows a
|
|
1245
1474
|
* live "{current}/{max}" counter below the field. */
|
|
1246
|
-
readonly maxLength: _angular_core.
|
|
1475
|
+
readonly maxLength: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
|
|
1476
|
+
/** Native `minlength` attribute. */
|
|
1477
|
+
readonly minLength: _angular_core.InputSignalWithTransform<number | null, number | null | undefined>;
|
|
1478
|
+
/** Native `pattern` attribute — signal forms sends the schema's RegExp list. */
|
|
1479
|
+
readonly pattern: _angular_core.InputSignalWithTransform<readonly RegExp[], string | readonly RegExp[] | undefined>;
|
|
1480
|
+
/** A native `pattern` takes ONE expression; the schema can carry several, so
|
|
1481
|
+
* they are ANDed with lookaheads rather than silently dropping all but one. */
|
|
1482
|
+
protected readonly patternAttribute: _angular_core.Signal<string | null>;
|
|
1247
1483
|
protected readonly uid: string;
|
|
1248
1484
|
protected readonly hintId: _angular_core.Signal<string | null>;
|
|
1249
1485
|
private readonly fieldMessage;
|
|
@@ -1262,10 +1498,13 @@ declare class TextareaComponent extends DsControlValueAccessor<string> {
|
|
|
1262
1498
|
* deliberately, e.g. focusing the first invalid field on a failed submit. */
|
|
1263
1499
|
focus(options?: FocusOptions): void;
|
|
1264
1500
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextareaComponent, never>;
|
|
1265
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextareaComponent, "ds-textarea", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "autosize": { "alias": "autosize"; "required": false; "isSignal": true; }; "minRows": { "alias": "minRows"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "resize": { "alias": "resize"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
|
|
1501
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextareaComponent, "ds-textarea", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "autosize": { "alias": "autosize"; "required": false; "isSignal": true; }; "minRows": { "alias": "minRows"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "resize": { "alias": "resize"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "pattern": { "alias": "pattern"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
|
|
1266
1502
|
}
|
|
1267
1503
|
|
|
1268
1504
|
declare class SearchComponent {
|
|
1505
|
+
/** Segment of a ds-field-group: the group owns the border, radius and focus
|
|
1506
|
+
* ring, so .in-group strips this control back to its bare contents. */
|
|
1507
|
+
protected readonly inGroup: boolean;
|
|
1269
1508
|
/** Search text, two-way bound. */
|
|
1270
1509
|
readonly value: _angular_core.ModelSignal<string>;
|
|
1271
1510
|
/** Placeholder shown when empty. */
|
|
@@ -1326,6 +1565,9 @@ declare function isSelectOptionGroup(item: SelectItem): item is SelectOptionGrou
|
|
|
1326
1565
|
|
|
1327
1566
|
declare class SelectComponent extends DsControlValueAccessor<string> implements OnDestroy {
|
|
1328
1567
|
private readonly overlay;
|
|
1568
|
+
/** Segment of a ds-field-group: the group owns the border, radius and focus
|
|
1569
|
+
* ring, so .in-group strips this control back to its bare contents. */
|
|
1570
|
+
protected readonly inGroup: boolean;
|
|
1329
1571
|
private readonly vcr;
|
|
1330
1572
|
private readonly host;
|
|
1331
1573
|
protected readonly preview: DsStaticPreview;
|
|
@@ -1343,6 +1585,12 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1343
1585
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1344
1586
|
/** Prevents opening the dropdown while still allowing focus. */
|
|
1345
1587
|
readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1588
|
+
/**
|
|
1589
|
+
* The contract spelling of `readOnly`, a second input because signal forms binds
|
|
1590
|
+
* by NAME — a `readonly()` rule was reaching nothing before this existed.
|
|
1591
|
+
*/
|
|
1592
|
+
readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1593
|
+
protected readonly isReadOnly: _angular_core.Signal<boolean>;
|
|
1346
1594
|
/** Applies error styling and marks the trigger `aria-invalid`. */
|
|
1347
1595
|
readonly invalid: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1348
1596
|
/** Helper text shown below the trigger. */
|
|
@@ -1419,7 +1667,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1419
1667
|
private firstEnabledIndex;
|
|
1420
1668
|
private lastEnabledIndex;
|
|
1421
1669
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
|
|
1422
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
|
|
1670
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
|
|
1423
1671
|
}
|
|
1424
1672
|
|
|
1425
1673
|
/**
|
|
@@ -1447,11 +1695,59 @@ declare class CellTemplateDirective {
|
|
|
1447
1695
|
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CellTemplateDirective, "[dsCellTemplate]", never, { "dsCellTemplate": { "alias": "dsCellTemplate"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
1448
1696
|
}
|
|
1449
1697
|
|
|
1698
|
+
/** What a projected header filter is handed. */
|
|
1699
|
+
interface HeaderFilterContext {
|
|
1700
|
+
/** The column being filtered. */
|
|
1701
|
+
readonly $implicit: unknown;
|
|
1702
|
+
/** Alias for the column. */
|
|
1703
|
+
readonly column: unknown;
|
|
1704
|
+
/** Dismisses the popover — call it after applying, so the filter behaves like
|
|
1705
|
+
* the built-in checklist rather than staying open. */
|
|
1706
|
+
readonly close: () => void;
|
|
1707
|
+
}
|
|
1708
|
+
/**
|
|
1709
|
+
* Projects a custom filter into a `ds-table` header popover, for a criterion the
|
|
1710
|
+
* built-in checklist cannot express: a date range, a numeric threshold, an async
|
|
1711
|
+
* option list.
|
|
1712
|
+
*
|
|
1713
|
+
* ```html
|
|
1714
|
+
* <ds-table [data]="rows" [columns]="cols">
|
|
1715
|
+
* <ng-template
|
|
1716
|
+
* dsHeaderFilter="opened"
|
|
1717
|
+
* [active]="!!range()"
|
|
1718
|
+
* let-close="close"
|
|
1719
|
+
* >
|
|
1720
|
+
* <ds-date-picker mode="range" [(value)]="range" />
|
|
1721
|
+
* <ds-button size="sm" (pressed)="apply(); close()">Apply</ds-button>
|
|
1722
|
+
* </ng-template>
|
|
1723
|
+
* </ds-table>
|
|
1724
|
+
* ```
|
|
1725
|
+
*
|
|
1726
|
+
* The table still owns the header button, the popover and the active-filter
|
|
1727
|
+
* styling — only the panel's contents change. It cannot know whether YOUR
|
|
1728
|
+
* criterion is set, though, so `active` is how the highlight gets told; without
|
|
1729
|
+
* it a custom filter renders but the header never marks itself filtered.
|
|
1730
|
+
*
|
|
1731
|
+
* The column is typed `unknown` for the same reason `dsCellTemplate`'s row is:
|
|
1732
|
+
* Angular cannot propagate the parent table's row type into a projected
|
|
1733
|
+
* template. Narrow it with a typed helper on the host.
|
|
1734
|
+
*/
|
|
1735
|
+
declare class HeaderFilterDirective {
|
|
1736
|
+
/** Key of the column this filter belongs to. */
|
|
1737
|
+
readonly dsHeaderFilter: _angular_core.InputSignal<string>;
|
|
1738
|
+
/** Whether YOUR criterion is currently set, which drives the header's
|
|
1739
|
+
* active-filter styling. */
|
|
1740
|
+
readonly active: _angular_core.InputSignal<boolean>;
|
|
1741
|
+
readonly template: TemplateRef<any>;
|
|
1742
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<HeaderFilterDirective, never>;
|
|
1743
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<HeaderFilterDirective, "ng-template[dsHeaderFilter]", never, { "dsHeaderFilter": { "alias": "dsHeaderFilter"; "required": true; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
1744
|
+
}
|
|
1745
|
+
|
|
1450
1746
|
/**
|
|
1451
1747
|
* Who sorts a `ds-table`.
|
|
1452
1748
|
*
|
|
1453
|
-
* - `'
|
|
1454
|
-
* - `'
|
|
1749
|
+
* - `'server'` (default) — the table only emits `sortChange`; the host reorders.
|
|
1750
|
+
* - `'client'` — the table reorders `data()` itself, for a table holding every row.
|
|
1455
1751
|
* - `'none'` — nothing sorts, and `sortable` columns render no affordance rather
|
|
1456
1752
|
* than a control that does nothing.
|
|
1457
1753
|
*
|
|
@@ -1459,6 +1755,18 @@ declare class CellTemplateDirective {
|
|
|
1459
1755
|
* marked `sortable` on a table with no sorting drew a live-looking header that
|
|
1460
1756
|
* did nothing, and no type or dev check could catch it.
|
|
1461
1757
|
*/
|
|
1758
|
+
/**
|
|
1759
|
+
* Who applies the header filters.
|
|
1760
|
+
*
|
|
1761
|
+
* `'server'` (the default when unset) means the host does it: the table tracks
|
|
1762
|
+
* `columnFilters` so a request can be driven from it, but runs no local pass —
|
|
1763
|
+
* on a paged table a local pass would filter what the server already filtered,
|
|
1764
|
+
* and paged is the normal case. `'client'` filters the rows in hand, for a table
|
|
1765
|
+
* that holds every one of them. `'none'` drops the affordance,
|
|
1766
|
+
* so a column left marked `filter: 'set'` renders no button rather than a
|
|
1767
|
+
* control that does nothing.
|
|
1768
|
+
*/
|
|
1769
|
+
type TableFilterMode = 'client' | 'server' | 'none';
|
|
1462
1770
|
type TableSortMode = 'client' | 'server' | 'none';
|
|
1463
1771
|
|
|
1464
1772
|
interface TableColumn<T = unknown> {
|
|
@@ -1572,6 +1880,17 @@ declare class TableComponent<T extends object> {
|
|
|
1572
1880
|
* (unsorted); pass ['asc','desc'] to forbid the unsorted state (e.g.
|
|
1573
1881
|
* server-paged lists). */
|
|
1574
1882
|
readonly sortingOrder: _angular_core.InputSignal<SortDir[]>;
|
|
1883
|
+
/**
|
|
1884
|
+
* Wording for the sort announcement, so it can be translated. Receives the
|
|
1885
|
+
* column's label and the new direction; return an empty string to say nothing.
|
|
1886
|
+
*/
|
|
1887
|
+
readonly sortAnnouncement: _angular_core.InputSignal<(label: string, dir: SortDir) => string>;
|
|
1888
|
+
/**
|
|
1889
|
+
* Wording for the row-range announcement, so it can be translated. Receives
|
|
1890
|
+
* the 1-based first and last row on screen and the total; return an empty
|
|
1891
|
+
* string to say nothing.
|
|
1892
|
+
*/
|
|
1893
|
+
readonly rangeAnnouncement: _angular_core.InputSignal<(first: number, last: number, total: number) => string>;
|
|
1575
1894
|
/** Number of shimmer rows rendered while `loading` is `'skeleton'`. */
|
|
1576
1895
|
readonly skeletonRows: _angular_core.InputSignal<number>;
|
|
1577
1896
|
/** Accessible name for the table (rendered as a visually-hidden caption).
|
|
@@ -1620,12 +1939,24 @@ declare class TableComponent<T extends object> {
|
|
|
1620
1939
|
readonly exportButton: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1621
1940
|
/** Filename the export button downloads as. */
|
|
1622
1941
|
readonly exportFilename: _angular_core.InputSignal<string>;
|
|
1623
|
-
/**
|
|
1624
|
-
*
|
|
1625
|
-
*
|
|
1626
|
-
|
|
1942
|
+
/**
|
|
1943
|
+
* Where the export button gets its data. A server-paged table only HAS the
|
|
1944
|
+
* current page, so exporting without this silently exports one page.
|
|
1945
|
+
*
|
|
1946
|
+
* Return ROWS and the table serializes them the same way it serializes its
|
|
1947
|
+
* own. Return a `Blob` (or a URL string) and the table just downloads it —
|
|
1948
|
+
* which is what you want when the backend already formatted the file with its
|
|
1949
|
+
* own number formats, its own columns, or a sheet the table never held.
|
|
1950
|
+
*/
|
|
1951
|
+
readonly exportFetcher: _angular_core.InputSignal<(() => Promise<readonly T[] | Blob | string>) | null>;
|
|
1952
|
+
/** Fires when `exportFetcher` rejects. Without it a failed export is silent —
|
|
1953
|
+
* the button simply re-enables and no file arrives. */
|
|
1954
|
+
readonly exportFailed: _angular_core.OutputEmitterRef<unknown>;
|
|
1627
1955
|
/** True while `exportFetcher` is in flight, so the button can disable itself. */
|
|
1628
1956
|
protected readonly exporting: _angular_core.WritableSignal<boolean>;
|
|
1957
|
+
/** Announced in the table's live region while an export is running or after it
|
|
1958
|
+
* failed, so the button's own disabled state is not the only signal. */
|
|
1959
|
+
protected readonly exportStatus: _angular_core.WritableSignal<string>;
|
|
1629
1960
|
/** Keeps the horizontal scrollbar reachable on tall tables: the scroll
|
|
1630
1961
|
* container's native bar is hidden and a proxy stuck to the bottom of the
|
|
1631
1962
|
* nearest scroll ancestor mirrors it both ways. Off by default. */
|
|
@@ -1636,6 +1967,11 @@ declare class TableComponent<T extends object> {
|
|
|
1636
1967
|
readonly page: _angular_core.ModelSignal<number>;
|
|
1637
1968
|
/** Selectable page-size choices shown in the pagination control. */
|
|
1638
1969
|
readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
|
|
1970
|
+
/** Shows the page-size picker in the footer pager. Set false for a table whose
|
|
1971
|
+
* page size is fixed — the standalone `ds-pagination` has always taken this. */
|
|
1972
|
+
readonly showPageSize: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1973
|
+
/** Shows the "N of M" range label in the footer pager. */
|
|
1974
|
+
readonly showLabel: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1639
1975
|
/** Server-side total row count. `null` (default) = client paging: the table
|
|
1640
1976
|
* slices `data()` itself and the pager counts the rows in hand. When set, the
|
|
1641
1977
|
* host has already sliced to one page — the pager uses this count and the
|
|
@@ -1644,10 +1980,24 @@ declare class TableComponent<T extends object> {
|
|
|
1644
1980
|
/** Scroll the table into view on a page change (opt-in) — keeps a bottom
|
|
1645
1981
|
* pager from leaving the viewport on the previous page's last rows. */
|
|
1646
1982
|
readonly scrollToTopOnPageChange: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1647
|
-
/** Who sorts — see `TableSortMode`. Unset resolves to `'
|
|
1648
|
-
*
|
|
1649
|
-
*
|
|
1983
|
+
/** Who sorts — see `TableSortMode`. Unset resolves to `'server'`: the table
|
|
1984
|
+
* emits `(sortChange)` and reorders nothing, which is what a paged table
|
|
1985
|
+
* needs. Declare `'client'` when the table holds every row, or `'none'` to
|
|
1986
|
+
* drop the affordance entirely. */
|
|
1650
1987
|
readonly sortMode: _angular_core.InputSignal<TableSortMode | null>;
|
|
1988
|
+
/** Who filters — see `TableFilterMode`. Unset resolves to `'server'`: the
|
|
1989
|
+
* table tracks the selection in `columnFilters` for the host to turn into a
|
|
1990
|
+
* request, and runs no local pass. Declare `'client'` when the table holds
|
|
1991
|
+
* every row and should filter them itself. */
|
|
1992
|
+
readonly filterMode: _angular_core.InputSignal<TableFilterMode | null>;
|
|
1993
|
+
/**
|
|
1994
|
+
* The full value domain per column key, for a header filter the table cannot
|
|
1995
|
+
* derive itself. Without it the checklist is built from the rows in hand,
|
|
1996
|
+
* which on a server-paged table offers only the values that happen to be on
|
|
1997
|
+
* the current page.
|
|
1998
|
+
*/
|
|
1999
|
+
readonly columnFilterOptions: _angular_core.InputSignal<ReadonlyMap<string, readonly string[]>>;
|
|
2000
|
+
protected readonly filterModeResolved: _angular_core.Signal<TableFilterMode>;
|
|
1651
2001
|
protected readonly sortModeResolved: _angular_core.Signal<TableSortMode>;
|
|
1652
2002
|
/** Pin the first data column (and the select column) on horizontal scroll. */
|
|
1653
2003
|
readonly stickyFirstColumn: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
@@ -1665,6 +2015,23 @@ declare class TableComponent<T extends object> {
|
|
|
1665
2015
|
/** Row height in px in virtual mode. Must match what the rows actually
|
|
1666
2016
|
* measure, so it drives the CSS height rather than merely describing it. */
|
|
1667
2017
|
readonly virtualRowSize: _angular_core.InputSignal<number>;
|
|
2018
|
+
/**
|
|
2019
|
+
* Fetch rows as they scroll into view instead of receiving them all.
|
|
2020
|
+
*
|
|
2021
|
+
* `data` becomes a SPARSE array `total` long: put each fetched row at its
|
|
2022
|
+
* absolute index and leave the rest empty. Every gap inside the window
|
|
2023
|
+
* renders a skeleton row, and `(lazyLoad)` asks for the range covering it.
|
|
2024
|
+
*
|
|
2025
|
+
* Needs `virtualScroll` — without a window there is nothing to load
|
|
2026
|
+
* lazily AGAINST — and `total`, which is what the scrollbar is sized from.
|
|
2027
|
+
*/
|
|
2028
|
+
readonly lazy: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2029
|
+
/** The range now on screen that `data` has gaps in — fetch it and write the
|
|
2030
|
+
* rows back at their absolute indices. Re-emits only when the range moves. */
|
|
2031
|
+
readonly lazyLoad: _angular_core.OutputEmitterRef<{
|
|
2032
|
+
first: number;
|
|
2033
|
+
rows: number;
|
|
2034
|
+
}>;
|
|
1668
2035
|
/** Fires with the row on click (or Enter/Space when `rowInteractive`). */
|
|
1669
2036
|
readonly rowClicked: _angular_core.OutputEmitterRef<T>;
|
|
1670
2037
|
/** Fires whenever sort key/direction changes, in every `sortMode` but `'none'`. */
|
|
@@ -1733,17 +2100,31 @@ declare class TableComponent<T extends object> {
|
|
|
1733
2100
|
/** The column whose filter menu is open — drives the distinct-value list. */
|
|
1734
2101
|
protected readonly filterColumn: _angular_core.WritableSignal<TableColumn<T> | null>;
|
|
1735
2102
|
protected readonly filterSearch: _angular_core.WritableSignal<string>;
|
|
2103
|
+
private readonly headerFilters;
|
|
2104
|
+
private readonly headerFilterByKey;
|
|
2105
|
+
/** The projected filter for a column, when the host supplied one. */
|
|
2106
|
+
protected headerFilterFor(col: TableColumn<T>): HeaderFilterDirective | undefined;
|
|
2107
|
+
/** A projected filter makes the column filterable on its own — the host does
|
|
2108
|
+
* not also have to mark it `filter: 'set'` to get the header button. */
|
|
1736
2109
|
protected hasColumnFilter(col: TableColumn<T>): boolean;
|
|
1737
2110
|
/** A column is "actively filtered" when at least one of its values is unchecked. */
|
|
1738
2111
|
protected isColumnFiltered(col: TableColumn<T>): boolean;
|
|
1739
|
-
|
|
2112
|
+
/** The checklist's domain: what the host declared, else what is in hand. */
|
|
2113
|
+
private optionsFor;
|
|
1740
2114
|
/** Distinct values of the open column, narrowed by the popover search box. */
|
|
1741
|
-
protected readonly filterValues: _angular_core.Signal<string[]>;
|
|
2115
|
+
protected readonly filterValues: _angular_core.Signal<readonly string[]>;
|
|
1742
2116
|
protected readonly filterSelectedCount: _angular_core.Signal<number>;
|
|
1743
2117
|
protected isFilterValueChecked(value: string): boolean;
|
|
1744
2118
|
protected onColumnFilterClick(col: TableColumn<T>, event: Event): void;
|
|
1745
2119
|
protected onFilterSearch(event: Event): void;
|
|
1746
2120
|
protected toggleFilterValue(value: string): void;
|
|
2121
|
+
/** Context handed to a projected header filter. Rebuilt per open, which is
|
|
2122
|
+
* cheap and keeps `close` bound to the popover that is actually showing. */
|
|
2123
|
+
protected headerFilterContext(col: TableColumn<T>): {
|
|
2124
|
+
$implicit: unknown;
|
|
2125
|
+
column: unknown;
|
|
2126
|
+
close: () => void;
|
|
2127
|
+
};
|
|
1747
2128
|
protected clearColumnFilter(): void;
|
|
1748
2129
|
private readonly injector;
|
|
1749
2130
|
private readonly editInput;
|
|
@@ -1757,13 +2138,41 @@ declare class TableComponent<T extends object> {
|
|
|
1757
2138
|
protected onEditInput(event: Event): void;
|
|
1758
2139
|
protected commitEdit(row: T, col: TableColumn<T>): void;
|
|
1759
2140
|
protected cancelEdit(): void;
|
|
2141
|
+
private static readonly RESIZE_STEP;
|
|
2142
|
+
private static readonly RESIZE_PAGE;
|
|
1760
2143
|
private static readonly MIN_COLUMN_WIDTH;
|
|
1761
2144
|
private resizeState;
|
|
1762
2145
|
/** Resolved pixel width for a column: a drag override wins, else `column.width`. */
|
|
1763
2146
|
protected columnWidth(col: TableColumn<T>): number | null;
|
|
1764
2147
|
protected onResizeStart(col: TableColumn<T>, event: PointerEvent): void;
|
|
2148
|
+
/**
|
|
2149
|
+
* Freeze the columns at what they currently measure, once, before the first
|
|
2150
|
+
* drag moves anything.
|
|
2151
|
+
*
|
|
2152
|
+
* Without it only the dragged column has a width and the rest are still
|
|
2153
|
+
* auto-sized, so the browser redistributes the remainder across them and
|
|
2154
|
+
* columns the reader never touched visibly jump. Measuring first means the
|
|
2155
|
+
* drag changes one column and leaves the others where they were — the
|
|
2156
|
+
* auto-sized geometry is kept rather than lost at the first grab.
|
|
2157
|
+
*
|
|
2158
|
+
* Runs only while something is unmeasured, so a second drag is untouched, and
|
|
2159
|
+
* it reads the header row that is actually on screen rather than assuming a
|
|
2160
|
+
* column order.
|
|
2161
|
+
*/
|
|
2162
|
+
private lockMeasuredWidths;
|
|
1765
2163
|
protected onResizeMove(event: PointerEvent): void;
|
|
1766
2164
|
protected onResizeEnd(): void;
|
|
2165
|
+
/** Current rendered width, for the keyboard path and the handle's
|
|
2166
|
+
* `aria-valuenow`. Falls back to the DOM when the column was auto-sized and
|
|
2167
|
+
* has neither an override nor a declared width. */
|
|
2168
|
+
protected resolvedColumnWidth(col: TableColumn<T>, from?: HTMLElement): number;
|
|
2169
|
+
/**
|
|
2170
|
+
* Keyboard resizing. A drag handle that only answers to a pointer makes a
|
|
2171
|
+
* resizable column unusable without a mouse, which is an a11y gap rather than
|
|
2172
|
+
* a missing nicety — hence Arrow for fine steps, PageUp/PageDown for coarse
|
|
2173
|
+
* ones and Home to hand the column back to automatic sizing.
|
|
2174
|
+
*/
|
|
2175
|
+
protected onResizeKey(col: TableColumn<T>, event: KeyboardEvent): void;
|
|
1767
2176
|
/** Client-side filter over the full data set — combines the `filterQuery`
|
|
1768
2177
|
* substring search with any per-column set filters. Sorting and pagination
|
|
1769
2178
|
* run on the filtered rows. */
|
|
@@ -1774,11 +2183,28 @@ declare class TableComponent<T extends object> {
|
|
|
1774
2183
|
protected readonly pagedData: _angular_core.Signal<readonly T[]>;
|
|
1775
2184
|
/** Rows actually rendered: paged when paginating, else sorted/raw data. */
|
|
1776
2185
|
protected readonly displayData: _angular_core.Signal<readonly T[]>;
|
|
2186
|
+
/**
|
|
2187
|
+
* The single live-region line. Loading wins while it lasts — a sort
|
|
2188
|
+
* announcement over rows that are being replaced tells the reader about a
|
|
2189
|
+
* state they cannot inspect yet. Otherwise it carries the sort state and the
|
|
2190
|
+
* row range, which are the two things a sighted user reads off the header and
|
|
2191
|
+
* the pager and a screen-reader user was told nothing about.
|
|
2192
|
+
*
|
|
2193
|
+
* `aria-live="polite"` does not announce a region's INITIAL content, so the
|
|
2194
|
+
* unsorted first render is silent; only real changes speak.
|
|
2195
|
+
*/
|
|
2196
|
+
protected readonly statusMessage: _angular_core.Signal<string>;
|
|
2197
|
+
private readonly sortMessage;
|
|
2198
|
+
private readonly rangeMessage;
|
|
1777
2199
|
/** Virtual mode needs a bounded scroller to window against. */
|
|
1778
2200
|
protected readonly virtualizing: _angular_core.Signal<boolean>;
|
|
1779
2201
|
/** Drives the CSS row height from the same number the arithmetic uses, so the
|
|
1780
2202
|
* two cannot drift — which would make every offset progressively wrong. */
|
|
1781
2203
|
protected readonly virtualRowHeight: _angular_core.Signal<string>;
|
|
2204
|
+
/** How many rows the scroller spans. Lazy counts the rows that EXIST, not the
|
|
2205
|
+
* ones that have arrived — otherwise the spacers shrink to the loaded slice
|
|
2206
|
+
* and the scrollbar lies about the length of the list. */
|
|
2207
|
+
protected readonly virtualCount: _angular_core.Signal<number>;
|
|
1782
2208
|
/** `null` when not virtualizing — the row loop then walks `displayData()` whole. */
|
|
1783
2209
|
protected readonly virtualWindow: _angular_core.Signal<{
|
|
1784
2210
|
start: number;
|
|
@@ -1788,10 +2214,23 @@ declare class TableComponent<T extends object> {
|
|
|
1788
2214
|
} | null>;
|
|
1789
2215
|
/** The rows the template actually renders. */
|
|
1790
2216
|
protected readonly windowData: _angular_core.Signal<readonly T[]>;
|
|
2217
|
+
/**
|
|
2218
|
+
* What the row loop walks: each slot carries its ABSOLUTE index, and a `null`
|
|
2219
|
+
* row is a gap the host has not filled yet.
|
|
2220
|
+
*
|
|
2221
|
+
* Absolute rather than loop-relative because everything downstream needs it —
|
|
2222
|
+
* striping parity, the skeleton's width seed, and the range `(lazyLoad)` asks
|
|
2223
|
+
* for. Outside lazy mode every slot is filled, so the extra object per visible
|
|
2224
|
+
* row buys uniformity for the ~25 rows windowing keeps in the DOM.
|
|
2225
|
+
*/
|
|
2226
|
+
protected readonly rowSlots: _angular_core.Signal<readonly {
|
|
2227
|
+
row: T | null;
|
|
2228
|
+
index: number;
|
|
2229
|
+
}[]>;
|
|
1791
2230
|
/** Zebra striping cannot come from `:nth-child` while windowing — the parity
|
|
1792
2231
|
* of a rendered row depends on its ABSOLUTE index, and the spacer rows are
|
|
1793
2232
|
* children too. Matches `:nth-child(odd)`, which is 1-based. */
|
|
1794
|
-
protected isStriped(
|
|
2233
|
+
protected isStriped(absoluteIndex: number): boolean;
|
|
1795
2234
|
protected readonly allSelected: _angular_core.Signal<boolean>;
|
|
1796
2235
|
protected readonly someSelected: _angular_core.Signal<boolean>;
|
|
1797
2236
|
/** Select-all is page-scoped only when paginating. */
|
|
@@ -1812,12 +2251,23 @@ declare class TableComponent<T extends object> {
|
|
|
1812
2251
|
/** Click on a `truncate` cell: when the text is actually clipped, show the
|
|
1813
2252
|
* full value in a popover; otherwise let the click fall through to the row. */
|
|
1814
2253
|
protected onCellClipClick(row: T, col: TableColumn<T>, event: Event): void;
|
|
2254
|
+
/** Clipped horizontally — itself or anything it renders. A `dsCellTemplate`
|
|
2255
|
+
* puts the ellipsis on a descendant, so testing only the wrapper misses it. */
|
|
2256
|
+
private static isClipped;
|
|
2257
|
+
/**
|
|
2258
|
+
* A header narrowed by resizing clips its own label, and the label is the only
|
|
2259
|
+
* thing naming the column — so the full text has to stay reachable. Set on
|
|
2260
|
+
* enter rather than always, because a `title` on every header would fire a
|
|
2261
|
+
* tooltip on hover for text that is perfectly readable.
|
|
2262
|
+
*/
|
|
2263
|
+
protected onHeaderEnter(event: Event, col: TableColumn<T>): void;
|
|
1815
2264
|
private readonly scrollWrap;
|
|
1816
2265
|
private readonly hscrollProxy;
|
|
1817
2266
|
protected readonly hscrollContentWidth: _angular_core.WritableSignal<number>;
|
|
1818
2267
|
protected readonly hscrollNeeded: _angular_core.WritableSignal<boolean>;
|
|
1819
2268
|
private readonly scrollTop;
|
|
1820
2269
|
private readonly viewportHeight;
|
|
2270
|
+
private lastLazyRequest;
|
|
1821
2271
|
constructor();
|
|
1822
2272
|
private parseDurationMs;
|
|
1823
2273
|
protected onRowMenuClick(row: T, event: Event): void;
|
|
@@ -1857,11 +2307,14 @@ declare class TableComponent<T extends object> {
|
|
|
1857
2307
|
/** Export button handler: awaits `exportFetcher` when one is given, so a
|
|
1858
2308
|
* server-paged table exports the whole set rather than the page it holds. */
|
|
1859
2309
|
protected runExport(): Promise<void>;
|
|
2310
|
+
/** Hands a ready-made file to the browser. Only a Blob gets its object URL
|
|
2311
|
+
* revoked — a URL the caller supplied is theirs to manage. */
|
|
2312
|
+
private downloadFile;
|
|
1860
2313
|
/** Deterministic per-cell width so skeleton rows look organic but stable
|
|
1861
2314
|
* across re-renders. Mixes column key + row index into one of five widths. */
|
|
1862
2315
|
protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
|
|
1863
2316
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
|
|
1864
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "animateHeight": { "alias": "animateHeight"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDir": { "alias": "sortDir"; "required": false; "isSignal": true; }; "sortingOrder": { "alias": "sortingOrder"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "activeRowId": { "alias": "activeRowId"; "required": false; "isSignal": true; }; "filterQuery": { "alias": "filterQuery"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "hiddenKeys": { "alias": "hiddenKeys"; "required": false; "isSignal": true; }; "resizableColumns": { "alias": "resizableColumns"; "required": false; "isSignal": true; }; "columnWidths": { "alias": "columnWidths"; "required": false; "isSignal": true; }; "reorderableColumns": { "alias": "reorderableColumns"; "required": false; "isSignal": true; }; "columnOrder": { "alias": "columnOrder"; "required": false; "isSignal": true; }; "persistLayout": { "alias": "persistLayout"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "exportButton": { "alias": "exportButton"; "required": false; "isSignal": true; }; "exportFilename": { "alias": "exportFilename"; "required": false; "isSignal": true; }; "exportFetcher": { "alias": "exportFetcher"; "required": false; "isSignal": true; }; "stickyScrollbar": { "alias": "stickyScrollbar"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "sortMode": { "alias": "sortMode"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualRowSize": { "alias": "virtualRowSize"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKey": "sortKeyChange"; "sortDir": "sortDirChange"; "columnFilters": "columnFiltersChange"; "hiddenKeys": "hiddenKeysChange"; "columnWidths": "columnWidthsChange"; "columnOrder": "columnOrderChange"; "pageSize": "pageSizeChange"; "page": "pageChange"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; }, ["cellTemplateDirectives"], ["[empty]", "[bulk-actions]"], true, never>;
|
|
2317
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "animateHeight": { "alias": "animateHeight"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDir": { "alias": "sortDir"; "required": false; "isSignal": true; }; "sortingOrder": { "alias": "sortingOrder"; "required": false; "isSignal": true; }; "sortAnnouncement": { "alias": "sortAnnouncement"; "required": false; "isSignal": true; }; "rangeAnnouncement": { "alias": "rangeAnnouncement"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "activeRowId": { "alias": "activeRowId"; "required": false; "isSignal": true; }; "filterQuery": { "alias": "filterQuery"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "hiddenKeys": { "alias": "hiddenKeys"; "required": false; "isSignal": true; }; "resizableColumns": { "alias": "resizableColumns"; "required": false; "isSignal": true; }; "columnWidths": { "alias": "columnWidths"; "required": false; "isSignal": true; }; "reorderableColumns": { "alias": "reorderableColumns"; "required": false; "isSignal": true; }; "columnOrder": { "alias": "columnOrder"; "required": false; "isSignal": true; }; "persistLayout": { "alias": "persistLayout"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "exportButton": { "alias": "exportButton"; "required": false; "isSignal": true; }; "exportFilename": { "alias": "exportFilename"; "required": false; "isSignal": true; }; "exportFetcher": { "alias": "exportFetcher"; "required": false; "isSignal": true; }; "stickyScrollbar": { "alias": "stickyScrollbar"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "sortMode": { "alias": "sortMode"; "required": false; "isSignal": true; }; "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "columnFilterOptions": { "alias": "columnFilterOptions"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualRowSize": { "alias": "virtualRowSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKey": "sortKeyChange"; "sortDir": "sortDirChange"; "columnFilters": "columnFiltersChange"; "hiddenKeys": "hiddenKeysChange"; "columnWidths": "columnWidthsChange"; "columnOrder": "columnOrderChange"; "exportFailed": "exportFailed"; "pageSize": "pageSizeChange"; "page": "pageChange"; "lazyLoad": "lazyLoad"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; }, ["cellTemplateDirectives", "headerFilters"], ["[empty]", "[bulk-actions]"], true, never>;
|
|
1865
2318
|
}
|
|
1866
2319
|
|
|
1867
2320
|
declare class PaginationComponent {
|
|
@@ -2013,6 +2466,9 @@ interface DayCell {
|
|
|
2013
2466
|
isDisabled: boolean;
|
|
2014
2467
|
}
|
|
2015
2468
|
declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeValue | null> implements OnDestroy {
|
|
2469
|
+
/** Segment of a ds-field-group: the group owns the border, radius and focus
|
|
2470
|
+
* ring, so .in-group strips this control back to its bare contents. */
|
|
2471
|
+
protected readonly inGroup: boolean;
|
|
2016
2472
|
constructor();
|
|
2017
2473
|
/** Field text for the DOM: fixed-width `_`-padded once any digit exists,
|
|
2018
2474
|
* else '' (so an untouched field is genuinely empty — no error on blur,
|
|
@@ -2182,6 +2638,14 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
2182
2638
|
protected open(moveFocusToGrid?: boolean): void;
|
|
2183
2639
|
protected close(cause?: DsOverlayCloseCause): void;
|
|
2184
2640
|
ngOnDestroy(): void;
|
|
2641
|
+
/**
|
|
2642
|
+
* Also the calendar glyph's handler. A POINTER open must not drag focus into
|
|
2643
|
+
* the day grid: the reader did not ask to leave a field they may want to type
|
|
2644
|
+
* in, and `allowInput` defaults to true. So focus follows what the field IS —
|
|
2645
|
+
* typeable, and the caret stays; read-only, and the grid is the only thing
|
|
2646
|
+
* worth focusing. The keyboard path is unaffected: ArrowDown on the field
|
|
2647
|
+
* calls `open(true)` and enters the grid however the panel was opened.
|
|
2648
|
+
*/
|
|
2185
2649
|
protected onFieldClick(): void;
|
|
2186
2650
|
private mobileEdit;
|
|
2187
2651
|
protected onFieldInput(event: Event): void;
|
|
@@ -2249,12 +2713,21 @@ interface Cell<T> {
|
|
|
2249
2713
|
/** Internal (not public API): Hours / Minutes / AM-PM listbox columns.
|
|
2250
2714
|
* Reused by ds-time-picker's overlay and the date-picker time footer. */
|
|
2251
2715
|
declare class TimeColumnsComponent {
|
|
2716
|
+
/** Current time as `HH:mm` (24h, always — `format` changes only what is DISPLAYED). */
|
|
2252
2717
|
readonly value: _angular_core.InputSignal<string | null>;
|
|
2718
|
+
/** Display clock. `12h` adds an AM/PM column; the emitted value stays 24h either way. */
|
|
2253
2719
|
readonly format: _angular_core.InputSignal<TimeFormat>;
|
|
2720
|
+
/** Minute granularity — 15 gives four rows an hour instead of sixty. */
|
|
2254
2721
|
readonly minuteStep: _angular_core.InputSignalWithTransform<number, unknown>;
|
|
2722
|
+
/** Earliest selectable time, `HH:mm`. Earlier rows render disabled rather than being removed,
|
|
2723
|
+
* so the columns do not reflow as the bound changes. */
|
|
2255
2724
|
readonly minTime: _angular_core.InputSignal<string | null>;
|
|
2725
|
+
/** Latest selectable time, `HH:mm`. */
|
|
2256
2726
|
readonly maxTime: _angular_core.InputSignal<string | null>;
|
|
2727
|
+
/** Per-time predicate for what a range cannot express — booked slots, a lunch break.
|
|
2728
|
+
* Receives `HH:mm`; return true to disable. */
|
|
2257
2729
|
readonly disabledTime: _angular_core.InputSignal<((time: string) => boolean) | null>;
|
|
2730
|
+
/** A complete time was picked, as `HH:mm`. Not emitted while only one column has moved. */
|
|
2258
2731
|
readonly timeChange: _angular_core.OutputEmitterRef<string>;
|
|
2259
2732
|
private readonly hourButtons;
|
|
2260
2733
|
private readonly minuteButtons;
|
|
@@ -2424,14 +2897,29 @@ declare class BreadcrumbsComponent {
|
|
|
2424
2897
|
readonly separator: _angular_core.InputSignal<IconName | null>;
|
|
2425
2898
|
/** Whether crumbs render as links; falls back to `DS_CONFIG.breadcrumbs.clickable`, then `true`. */
|
|
2426
2899
|
readonly clickable: _angular_core.InputSignal<boolean | null>;
|
|
2900
|
+
/**
|
|
2901
|
+
* Caps how many crumbs render, collapsing the middle into an ellipsis — the
|
|
2902
|
+
* first and the LAST always survive. Null (default) renders every crumb.
|
|
2903
|
+
*
|
|
2904
|
+
* Worth setting on any trail that can get deep: the row is `nowrap` with
|
|
2905
|
+
* `overflow: hidden`, so without a cap an overlong trail is clipped from the
|
|
2906
|
+
* END, which is the current page — the one crumb the reader needs most.
|
|
2907
|
+
*/
|
|
2908
|
+
readonly maxItems: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
2427
2909
|
/** Fires when a clickable crumb with `href` is activated; default navigation is always prevented. */
|
|
2428
2910
|
readonly navigate: _angular_core.OutputEmitterRef<BreadcrumbItem>;
|
|
2911
|
+
private readonly allItems;
|
|
2912
|
+
/**
|
|
2913
|
+
* What renders. The collapsed crumb carries no `href`, so it is inert rather
|
|
2914
|
+
* than a link to nowhere; its label is the count, which tells the reader how
|
|
2915
|
+
* much is hidden instead of just that something is.
|
|
2916
|
+
*/
|
|
2429
2917
|
protected readonly resolvedItems: _angular_core.Signal<BreadcrumbItem[]>;
|
|
2430
2918
|
protected readonly effectiveSeparator: _angular_core.Signal<IconName>;
|
|
2431
2919
|
protected readonly effectiveClickable: _angular_core.Signal<boolean>;
|
|
2432
2920
|
protected onNav(event: Event, item: BreadcrumbItem): void;
|
|
2433
2921
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<BreadcrumbsComponent, never>;
|
|
2434
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<BreadcrumbsComponent, "ds-breadcrumbs", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "separator": { "alias": "separator"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; }, { "navigate": "navigate"; }, never, never, true, never>;
|
|
2922
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<BreadcrumbsComponent, "ds-breadcrumbs", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "separator": { "alias": "separator"; "required": false; "isSignal": true; }; "clickable": { "alias": "clickable"; "required": false; "isSignal": true; }; "maxItems": { "alias": "maxItems"; "required": false; "isSignal": true; }; }, { "navigate": "navigate"; }, never, never, true, never>;
|
|
2435
2923
|
}
|
|
2436
2924
|
|
|
2437
2925
|
/**
|
|
@@ -2595,6 +3083,8 @@ declare class SidenavFooterComponent {
|
|
|
2595
3083
|
readonly alertItems: _angular_core.InputSignal<readonly SidenavAlertItem[] | null>;
|
|
2596
3084
|
/** Route for the account menu's "Your profile"; empty = the item is a no-op. */
|
|
2597
3085
|
readonly profileRoute: _angular_core.InputSignal<string>;
|
|
3086
|
+
/** The collapse control was activated. The footer does not collapse itself — `ds-app-layout`
|
|
3087
|
+
* owns the rail state, so the host relays this. */
|
|
2598
3088
|
readonly collapseToggled: _angular_core.OutputEmitterRef<void>;
|
|
2599
3089
|
/** Emitted when the Alerts popover is opened, so the layout can mark-all-read. */
|
|
2600
3090
|
readonly alertsOpened: _angular_core.OutputEmitterRef<void>;
|
|
@@ -2649,10 +3139,14 @@ declare class ModalComponent implements OnDestroy {
|
|
|
2649
3139
|
readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2650
3140
|
/** Dialog title, shown in the header and used for `aria-labelledby`. */
|
|
2651
3141
|
readonly title: _angular_core.InputSignal<string>;
|
|
3142
|
+
/** Secondary line under the title. Not part of the accessible name. */
|
|
3143
|
+
readonly subtitle: _angular_core.InputSignal<string | null>;
|
|
2652
3144
|
/** Fires once the close (leave) animation finishes. */
|
|
2653
3145
|
readonly closed: _angular_core.OutputEmitterRef<void>;
|
|
2654
3146
|
/** Emit this yourself from a confirm action in the projected content — not fired by the modal itself. */
|
|
2655
3147
|
readonly confirmed: _angular_core.OutputEmitterRef<void>;
|
|
3148
|
+
/** Draws the rules under the header and over the actions. Turning them off also tightens the vertical padding they were sized for. */
|
|
3149
|
+
readonly dividers: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2656
3150
|
/** When false, clicking the scrim does not close the modal. */
|
|
2657
3151
|
readonly closeOnBackdrop: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2658
3152
|
/** When true, neither backdrop click nor Escape closes the modal — only programmatic or explicit close button. */
|
|
@@ -2671,7 +3165,7 @@ declare class ModalComponent implements OnDestroy {
|
|
|
2671
3165
|
protected onBackdrop(event: MouseEvent): void;
|
|
2672
3166
|
protected onEscape(): void;
|
|
2673
3167
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalComponent, never>;
|
|
2674
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalComponent, "ds-modal", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "persistent": { "alias": "persistent"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; "confirmed": "confirmed"; }, never, ["[eyebrow]", "[body]", "[impact]", "[actions]"], true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
|
|
3168
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalComponent, "ds-modal", never, { "open": { "alias": "open"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "dividers": { "alias": "dividers"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "persistent": { "alias": "persistent"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "closed": "closed"; "confirmed": "confirmed"; }, never, ["[eyebrow]", "[title-badge]", "[body]", "[impact]", "[actions]"], true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
|
|
2675
3169
|
}
|
|
2676
3170
|
|
|
2677
3171
|
declare class ModalCardComponent {
|
|
@@ -2681,8 +3175,12 @@ declare class ModalCardComponent {
|
|
|
2681
3175
|
readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2682
3176
|
/** Card title, shown in the header and used for `aria-labelledby`. */
|
|
2683
3177
|
readonly title: _angular_core.InputSignal<string>;
|
|
3178
|
+
/** Secondary line under the title. Not part of the accessible name. */
|
|
3179
|
+
readonly subtitle: _angular_core.InputSignal<string | null>;
|
|
2684
3180
|
/** Shows the header close button. */
|
|
2685
3181
|
readonly showClose: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
3182
|
+
/** Draws the rules under the header and over the actions. Turning them off also tightens the vertical padding they were sized for. */
|
|
3183
|
+
readonly dividers: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2686
3184
|
/** Icon badge shown next to the title. */
|
|
2687
3185
|
readonly icon: _angular_core.InputSignal<IconName | null>;
|
|
2688
3186
|
/** ARIA role for the dialog element. */
|
|
@@ -2693,7 +3191,7 @@ declare class ModalCardComponent {
|
|
|
2693
3191
|
protected readonly classes: _angular_core.Signal<string>;
|
|
2694
3192
|
protected onClose(): void;
|
|
2695
3193
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalCardComponent, never>;
|
|
2696
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalCardComponent, "ds-modal-card", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "showClose": { "alias": "showClose"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "dialogRole": { "alias": "dialogRole"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["[eyebrow]", "[body]", "[impact]", "[actions]"], true, never>;
|
|
3194
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalCardComponent, "ds-modal-card", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "subtitle": { "alias": "subtitle"; "required": false; "isSignal": true; }; "showClose": { "alias": "showClose"; "required": false; "isSignal": true; }; "dividers": { "alias": "dividers"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "dialogRole": { "alias": "dialogRole"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["[eyebrow]", "[title-badge]", "[body]", "[impact]", "[actions]"], true, never>;
|
|
2697
3195
|
}
|
|
2698
3196
|
|
|
2699
3197
|
type ModalConfirmTone = 'default' | 'error';
|
|
@@ -2838,6 +3336,9 @@ declare class MenuItemComponent implements OnDestroy {
|
|
|
2838
3336
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2839
3337
|
/** Renders the item in an error/destructive style. */
|
|
2840
3338
|
readonly error: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
3339
|
+
/** Renders the item muted — a secondary row like "Sign out" under a divider,
|
|
3340
|
+
* still actionable but not competing with the items above it. */
|
|
3341
|
+
readonly quiet: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2841
3342
|
/** Optional submenu template — renders a nested `ds-menu` on hover / ArrowRight. */
|
|
2842
3343
|
readonly submenu: _angular_core.InputSignal<TemplateRef<unknown> | null>;
|
|
2843
3344
|
/** Fires on click, unless the item is disabled or opens a submenu. */
|
|
@@ -2868,7 +3369,7 @@ declare class MenuItemComponent implements OnDestroy {
|
|
|
2868
3369
|
private clearOpenTimer;
|
|
2869
3370
|
private clearCloseTimer;
|
|
2870
3371
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuItemComponent, never>;
|
|
2871
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<MenuItemComponent, "ds-menu-item", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "submenu": { "alias": "submenu"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["[icon]", "*"], true, never>;
|
|
3372
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<MenuItemComponent, "ds-menu-item", never, { "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "quiet": { "alias": "quiet"; "required": false; "isSignal": true; }; "submenu": { "alias": "submenu"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["[icon]", "*"], true, never>;
|
|
2872
3373
|
}
|
|
2873
3374
|
|
|
2874
3375
|
declare class MenuDividerComponent {
|
|
@@ -3331,6 +3832,9 @@ interface AutocompleteOptionGroup<T = unknown> {
|
|
|
3331
3832
|
}
|
|
3332
3833
|
|
|
3333
3834
|
declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<T | readonly T[] | null> implements OnDestroy {
|
|
3835
|
+
/** Segment of a ds-field-group: the group owns the border, radius and focus
|
|
3836
|
+
* ring, so .in-group strips this control back to its bare contents. */
|
|
3837
|
+
protected readonly inGroup: boolean;
|
|
3334
3838
|
private readonly overlay;
|
|
3335
3839
|
private readonly vcr;
|
|
3336
3840
|
private readonly host;
|
|
@@ -3345,6 +3849,13 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
3345
3849
|
readonly value: _angular_core.ModelSignal<T | readonly T[] | null>;
|
|
3346
3850
|
/** Allows selecting more than one option, shown as removable tags. */
|
|
3347
3851
|
readonly multiple: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
3852
|
+
/** Draws the trailing chevron. Turn it off for a search field, where an arrow
|
|
3853
|
+
* invites a click that would list everything instead of searching. */
|
|
3854
|
+
readonly showChevron: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
3855
|
+
/** Caps the number of chips shown before collapsing the rest into "+N more" — 0/null shows all.
|
|
3856
|
+
* Same name and semantics as `ds-multi-select`: without it a trigger grows a
|
|
3857
|
+
* line per selection and pushes the rest of the form down the page. */
|
|
3858
|
+
readonly maxVisibleChips: _angular_core.InputSignalWithTransform<number | null, number | null>;
|
|
3348
3859
|
/** Trigger height — sm/md/lg. */
|
|
3349
3860
|
readonly size: _angular_core.InputSignal<DsSize>;
|
|
3350
3861
|
/** Trigger width — `fill` stretches to the container, `content` hugs the value. */
|
|
@@ -3407,6 +3918,11 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
3407
3918
|
/** Flat list of visible options used for keyboard navigation index. */
|
|
3408
3919
|
protected readonly visibleOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
|
|
3409
3920
|
protected readonly selectedTags: _angular_core.Signal<AutocompleteOption<T>[]>;
|
|
3921
|
+
/** What the trigger renders. Separate from `selectedTags`, which stays the
|
|
3922
|
+
* full selection: Backspace removes the last SELECTED chip, and capping the
|
|
3923
|
+
* list it reads would silently make it remove the last VISIBLE one instead. */
|
|
3924
|
+
protected readonly visibleTags: _angular_core.Signal<AutocompleteOption<T>[]>;
|
|
3925
|
+
protected readonly overflowCount: _angular_core.Signal<number>;
|
|
3410
3926
|
protected readonly displayLabel: _angular_core.Signal<string>;
|
|
3411
3927
|
protected readonly placeholderText: _angular_core.Signal<string>;
|
|
3412
3928
|
protected isSelected(option: AutocompleteOption<T>): boolean;
|
|
@@ -3418,13 +3934,26 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
3418
3934
|
protected onKeydown(event: KeyboardEvent): void;
|
|
3419
3935
|
protected openPanel(): void;
|
|
3420
3936
|
protected close(cause?: DsOverlayCloseCause): void;
|
|
3937
|
+
/**
|
|
3938
|
+
* Empties the field — both the selected value and the text the user typed.
|
|
3939
|
+
*
|
|
3940
|
+
* `value.set(null)` alone is not enough from outside: the typed query is
|
|
3941
|
+
* component state with no input bound to it, so the text stays on screen after
|
|
3942
|
+
* the value goes. That gap is why a host reaching for "reset after navigating"
|
|
3943
|
+
* ends up querying the inner `<input>` and dispatching a synthetic `input`
|
|
3944
|
+
* event.
|
|
3945
|
+
*
|
|
3946
|
+
* Deliberately does NOT move focus — the caller may be navigating away, and
|
|
3947
|
+
* stealing focus back into a field they just left is worse than leaving it.
|
|
3948
|
+
*/
|
|
3949
|
+
clear(): void;
|
|
3421
3950
|
ngOnDestroy(): void;
|
|
3422
3951
|
protected onFilter(event: Event): void;
|
|
3423
3952
|
protected onPick(option: AutocompleteOption<T>): void;
|
|
3424
3953
|
protected onCreateNew(): void;
|
|
3425
3954
|
protected remove(target: T): void;
|
|
3426
3955
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent<any>, never>;
|
|
3427
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionGroups": { "alias": "optionGroups"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "create": "create"; }, never,
|
|
3956
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionGroups": { "alias": "optionGroups"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showChevron": { "alias": "showChevron"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "create": "create"; }, never, ["[dsAutocompletePrefix]", "[dsAutocompleteSuffix]"], true, never>;
|
|
3428
3957
|
}
|
|
3429
3958
|
|
|
3430
3959
|
type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
|
|
@@ -3436,7 +3965,10 @@ type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
|
|
|
3436
3965
|
type DividerSpacing = 'none' | 'sm' | 'md' | 'lg';
|
|
3437
3966
|
|
|
3438
3967
|
declare class DividerComponent {
|
|
3968
|
+
/** `default` hairline · `strong` heavier rule · `vertical` for a row · `label` to carry
|
|
3969
|
+
* projected text in the middle of the line. */
|
|
3439
3970
|
readonly variant: _angular_core.InputSignal<DividerVariant>;
|
|
3971
|
+
/** Vertical breathing room around the rule. `none` when the parent layout already owns the gap. */
|
|
3440
3972
|
readonly spacing: _angular_core.InputSignal<DividerSpacing>;
|
|
3441
3973
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DividerComponent, never>;
|
|
3442
3974
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<DividerComponent, "ds-divider", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "spacing": { "alias": "spacing"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
|
|
@@ -3469,22 +4001,29 @@ type LayoutJustify = 'start' | 'center' | 'end' | 'between';
|
|
|
3469
4001
|
type ContainerSize = DsSize | 'xl' | 'full';
|
|
3470
4002
|
|
|
3471
4003
|
declare class StackComponent {
|
|
4004
|
+
/** Space between children. `null` inherits whatever the enclosing layout set. */
|
|
3472
4005
|
readonly gap: _angular_core.InputSignal<LayoutGap | null>;
|
|
4006
|
+
/** Cross-axis alignment — horizontal, for a column. */
|
|
3473
4007
|
readonly align: _angular_core.InputSignal<LayoutAlign | null>;
|
|
3474
4008
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<StackComponent, never>;
|
|
3475
4009
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<StackComponent, "ds-stack", never, { "gap": { "alias": "gap"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
|
|
3476
4010
|
}
|
|
3477
4011
|
|
|
3478
4012
|
declare class InlineComponent {
|
|
4013
|
+
/** Space between children. `null` inherits whatever the enclosing layout set. */
|
|
3479
4014
|
readonly gap: _angular_core.InputSignal<LayoutGap | null>;
|
|
4015
|
+
/** Cross-axis alignment — vertical, for a row. */
|
|
3480
4016
|
readonly align: _angular_core.InputSignal<LayoutAlign | null>;
|
|
4017
|
+
/** Main-axis distribution — horizontal, for a row. `between` pushes the ends apart. */
|
|
3481
4018
|
readonly justify: _angular_core.InputSignal<LayoutJustify | null>;
|
|
4019
|
+
/** Let the row wrap onto more lines (default). `false` keeps one line and lets it overflow. */
|
|
3482
4020
|
readonly wrap: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
3483
4021
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<InlineComponent, never>;
|
|
3484
4022
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<InlineComponent, "ds-inline", never, { "gap": { "alias": "gap"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "justify": { "alias": "justify"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
|
|
3485
4023
|
}
|
|
3486
4024
|
|
|
3487
4025
|
declare class ContainerComponent {
|
|
4026
|
+
/** Max content width before the container centres itself. `full` removes the cap. */
|
|
3488
4027
|
readonly size: _angular_core.InputSignal<ContainerSize>;
|
|
3489
4028
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ContainerComponent, never>;
|
|
3490
4029
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ContainerComponent, "ds-container", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
|
|
@@ -4237,5 +4776,5 @@ declare class FieldClickFocusDirective {
|
|
|
4237
4776
|
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
|
|
4238
4777
|
}
|
|
4239
4778
|
|
|
4240
|
-
export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppLayoutComponent,
|
|
4241
|
-
export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteOption, AutocompleteOptionGroup, AutocompleteWidth, AvatarSize, AvatarStatus, AvatarTintOptions, BannerVariant, BreadcrumbItem, ButtonColor, ButtonType, ButtonVariant, CardElevation, CardPadding, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerSpacing, DividerVariant, DrawerPlacement, DropzoneFile, DropzoneFileState, DsConfig, DsIconRegistry, DsPasswordRule, DsPasswordRuleState, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, EmptyStateVariant, IconButtonType, IconButtonVariant, IconName, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectOption, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, SidenavAlertItem, SidenavContract, SidenavItemModel, SidenavSearchProvider, SidenavSearchResult, SortChangeEvent, SortDir, SplitButtonItem, SplitButtonVariant, StepperLabelPosition, StepperOrientation, TableCellEditEvent, TableColumn, TableRowAction, TableRowActionEvent, TableSortMode, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TimeFormat, TimePickerMode, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };
|
|
4779
|
+
export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppLayoutComponent, AuthLayoutComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BodyScrollLockService, BottomSheetComponent, BrandNameDirective, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_FIELD_GROUP, DS_ICON_REGISTRY, DS_TOAST_CONFIG, DS_TOAST_POSITION, DS_TOAST_POSITION_DEFAULT, DatePickerComponent, DescriptionItemComponent, DescriptionListComponent, DividerComponent, DrawerComponent, DropzoneComponent, DsOverlayCloseRef, DsStaticPreview, EmptyStateComponent, FieldClickFocusDirective, FieldGroupComponent, FilterBarComponent, FilterItemDirective, HeaderFilterDirective, ICONS, IconButtonComponent, IconComponent, InlineComponent, InputComponent, LayoutNavigationService, LayoutScrollService, ListComponent, ListItemComponent, LoadingOverlayComponent, MenuComponent, MenuDividerComponent, MenuItemComponent, ModalCardComponent, ModalComponent, ModalService, MultiSelectComponent, NumberStepperComponent, OtpInputComponent, PageFooterComponent, PageHeaderComponent, PaginationComponent, PasswordRulesComponent, PopoverComponent, ProgressComponent, RADIO_GROUP, RadioComponent, RadioGroupComponent, RailTriggerDirective, ReserveMessagesDirective, SIDENAV, SearchComponent, SegmentedComponent, SelectComponent, SidenavComponent, SidenavFooterComponent, SidenavGroupComponent, SidenavItemComponent, SkeletonComponent, SliderComponent, SpinnerComponent, SplitButtonComponent, StackComponent, StatComponent, StatusDotComponent, StepperComponent, SwitchComponent, TabComponent, TableComponent, TabsComponent, TagComponent, TextareaComponent, TimePickerComponent, TimelineComponent, TimelineItemComponent, ToastComponent, ToastRegionComponent, ToastService, ToggleButtonComponent, TooltipDirective, TooltipPanelComponent, TopBarComponent, TreeComponent, W3wComponent, avatarTint, inheritDsConfig, initialsFrom, isSelectOptionGroup, passwordRulesMet, provideDsConfig, provideDsIcons, provideDsTheme };
|
|
4780
|
+
export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteOption, AutocompleteOptionGroup, AutocompleteWidth, AvatarSize, AvatarStatus, AvatarTintOptions, BannerVariant, BreadcrumbItem, ButtonColor, ButtonType, ButtonVariant, CardElevation, CardPadding, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerSpacing, DividerVariant, DrawerPlacement, DropzoneFile, DropzoneFileState, DsConfig, DsFieldGroupContext, DsIconRegistry, DsPasswordRule, DsPasswordRuleState, DsScrollReset, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, EmptyStateVariant, HeaderFilterContext, IconButtonType, IconButtonVariant, IconName, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectOption, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, SidenavAlertItem, SidenavContract, SidenavItemModel, SidenavSearchProvider, SidenavSearchResult, SortChangeEvent, SortDir, SplitButtonItem, SplitButtonVariant, StepperLabelPosition, StepperOrientation, TableCellEditEvent, TableColumn, TableFilterMode, TableRowAction, TableRowActionEvent, TableSortMode, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TimeFormat, TimePickerMode, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };
|