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