@ids-group-ltd/ids-design-system 0.10.3 → 0.11.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +1376 -904
- package/components.md +61 -30
- package/design-system.md +18 -18
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +992 -486
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.1.0.json +2 -1
- package/migrations/0.10.0.json +219 -42
- package/migrations/0.10.1.json +50 -13
- package/migrations/0.10.2.json +90 -24
- package/migrations/0.10.3.json +22 -5
- package/migrations/0.11.0.json +216 -0
- package/migrations/0.11.1.json +305 -0
- package/migrations/0.2.0.json +22 -9
- package/migrations/0.2.1.json +2 -1
- package/migrations/0.2.2.json +3 -2
- package/migrations/0.3.0.json +16 -10
- package/migrations/0.4.0.json +38 -14
- package/migrations/0.5.0.json +49 -25
- package/migrations/0.5.1/badge-statuses.md +1 -3
- package/migrations/0.5.1.json +75 -33
- package/migrations/0.6.0.json +6 -2
- package/migrations/0.6.1.json +19 -1
- package/migrations/0.6.2.json +3 -1
- package/migrations/0.6.3.json +13 -4
- package/migrations/0.7.0.json +45 -26
- package/migrations/0.7.1.json +58 -20
- package/migrations/0.8.0.json +53 -15
- package/migrations/0.9.0.json +147 -27
- package/migrations/0.9.1.json +4 -3
- package/migrations/README.md +34 -52
- package/package.json +2 -1
- package/styles/_dropdown-overlay.scss +35 -13
- package/styles/_ds-color.scss +3 -3
- package/styles/_field-box.scss +2 -6
- package/styles/_field-label.scss +5 -10
- package/styles/_field-state.scss +3 -2
- package/styles/_focus.scss +0 -2
- package/styles/_layout-utils.scss +2 -2
- package/styles/_link.scss +1 -2
- package/styles/_overlay-motion.scss +2 -4
- package/styles/_press.scss +3 -5
- package/styles/_reset.scss +0 -1
- package/styles/_scrollbar.scss +1 -3
- package/styles/_status.scss +1 -2
- package/styles/_surface-motion.scss +3 -4
- package/styles/_text-clip.scss +1 -1
- package/styles/_theme-activation.scss +1 -1
- package/styles/_tokens-charts.scss +1 -3
- package/styles/_tokens.scss +4 -3
- package/styles/_typography.scss +2 -2
- package/themes/README.md +3 -3
- package/themes/_base-palette.scss +2 -2
- package/themes/_semantic.scss +2 -2
- package/themes/dark/_palette.scss +1 -2
- package/themes/light/_palette.scss +1 -1
- package/themes/light/_theme.scss +1 -1
- package/types/ids-group-ltd-ids-design-system.d.ts +403 -108
- package/migrations/AUTHORING.md +0 -273
|
@@ -3,8 +3,8 @@ import { InjectionToken, Provider, EnvironmentProviders, ElementRef, TemplateRef
|
|
|
3
3
|
import { SafeHtml } from '@angular/platform-browser';
|
|
4
4
|
import { Observable } from 'rxjs';
|
|
5
5
|
import { ControlValueAccessor } from '@angular/forms';
|
|
6
|
-
import { CdkDragDrop } from '@angular/cdk/drag-drop';
|
|
7
6
|
import * as _ids_group_ltd_ids_design_system from '@ids-group-ltd/ids-design-system';
|
|
7
|
+
import { CdkDragDrop } from '@angular/cdk/drag-drop';
|
|
8
8
|
|
|
9
9
|
declare const ICONS: {
|
|
10
10
|
readonly search: "<circle cx=\"11\" cy=\"11\" r=\"7\" /><path d=\"m20 20-3.5-3.5\" />";
|
|
@@ -170,6 +170,15 @@ interface DsConfig {
|
|
|
170
170
|
* `ds-modal` ancestor to bind — an attribute cannot reach it. */
|
|
171
171
|
dividers?: boolean;
|
|
172
172
|
};
|
|
173
|
+
picker?: {
|
|
174
|
+
/** Default for `ds-multi-select``s `searchable`. `true` always shows the panel's
|
|
175
|
+
* filter row, `false` never, and a NUMBER is a threshold — the row appears once
|
|
176
|
+
* there are at least that many options. Default `true`.
|
|
177
|
+
*
|
|
178
|
+
* One threshold for the app is the point: left to each call site, two panels of
|
|
179
|
+
* the same length in the same screen end up disagreeing. */
|
|
180
|
+
searchable?: boolean | number;
|
|
181
|
+
};
|
|
173
182
|
control?: {
|
|
174
183
|
/** Default `size` for every control on the field-height contract. Default `'md'`.
|
|
175
184
|
*
|
|
@@ -187,7 +196,7 @@ interface DsConfig {
|
|
|
187
196
|
table?: {
|
|
188
197
|
/** Default for `ds-table`'s `stickyScrollbar` — the proxy that keeps the
|
|
189
198
|
* horizontal bar reachable on a tall table. Default `false`. A whole-app
|
|
190
|
-
* opinion in practice:
|
|
199
|
+
* opinion in practice: an app that wants it wants it on every table, and
|
|
191
200
|
* every new table is one forgotten binding away from scrolling invisibly. */
|
|
192
201
|
stickyScrollbar?: boolean;
|
|
193
202
|
/** Default for `ds-table`'s `bordered` — the outer border and radius.
|
|
@@ -235,8 +244,8 @@ declare function provideDsConfig(config: DsConfig): Provider;
|
|
|
235
244
|
* The factory body behind `provideDsConfig`, exported so a directive can put the
|
|
236
245
|
* provider in its metadata as a plain object literal. Calling `provideDsConfig`
|
|
237
246
|
* there instead would run at module-evaluation time, which makes the module
|
|
238
|
-
* side-effectful and costs the consumer its tree-shaking (measured
|
|
239
|
-
*
|
|
247
|
+
* side-effectful and costs the consumer its tree-shaking (measured at +566 kB moved
|
|
248
|
+
* into the eager chunk).
|
|
240
249
|
*
|
|
241
250
|
* Must be called from an injection context.
|
|
242
251
|
*/
|
|
@@ -311,6 +320,24 @@ interface DsOption<T = string> {
|
|
|
311
320
|
/** Rendered before the label at 16px by every picker's option row. */
|
|
312
321
|
icon?: IconName;
|
|
313
322
|
}
|
|
323
|
+
/**
|
|
324
|
+
* A labelled section of options. `disabled` turns the whole section off.
|
|
325
|
+
*/
|
|
326
|
+
interface DsOptionGroup<T = string> {
|
|
327
|
+
label: string;
|
|
328
|
+
options: DsOption<T>[];
|
|
329
|
+
disabled?: boolean;
|
|
330
|
+
}
|
|
331
|
+
/**
|
|
332
|
+
* What a picker's `options` input takes: flat options, groups, or both mixed.
|
|
333
|
+
* One input rather than two, because a second `optionGroups` input can only
|
|
334
|
+
* answer "what if both are set" by silently ignoring one — which is what
|
|
335
|
+
* `ds-autocomplete` used to do.
|
|
336
|
+
*/
|
|
337
|
+
type DsOptionItem<T = string> = DsOption<T> | DsOptionGroup<T>;
|
|
338
|
+
declare function isDsOptionGroup<T>(item: DsOptionItem<T>): item is DsOptionGroup<T>;
|
|
339
|
+
/** Every option in `items`, groups flattened in place, in source order. */
|
|
340
|
+
declare function flattenDsOptions<T>(items: readonly DsOptionItem<T>[]): DsOption<T>[];
|
|
314
341
|
|
|
315
342
|
/** Canonical status vocabulary shared across status-bearing components. */
|
|
316
343
|
type DsStatus = 'info' | 'success' | 'warning' | 'error';
|
|
@@ -319,11 +346,6 @@ type DsStatus = 'info' | 'success' | 'warning' | 'error';
|
|
|
319
346
|
* The DS ships it EMPTY — no statuses are predefined. A consumer registers keys
|
|
320
347
|
* via declaration merging to get autocomplete on the `status` input:
|
|
321
348
|
*
|
|
322
|
-
* // inside this repo (ds-docs imports the lib as 'ds'):
|
|
323
|
-
* declare module 'ds' {
|
|
324
|
-
* interface DsStatusRegistry { planning: true; confirmed: true; }
|
|
325
|
-
* }
|
|
326
|
-
* // external consumer of the published package:
|
|
327
349
|
* declare module '@ids-group-ltd/ids-design-system' {
|
|
328
350
|
* interface DsStatusRegistry { shipped: true; delivered: true; }
|
|
329
351
|
* }
|
|
@@ -337,6 +359,33 @@ interface DsStatusRegistry {
|
|
|
337
359
|
*/
|
|
338
360
|
type DsStatusKey = [keyof DsStatusRegistry] extends [never] ? string : keyof DsStatusRegistry;
|
|
339
361
|
|
|
362
|
+
/**
|
|
363
|
+
* How a control sizes itself and its overlay panel.
|
|
364
|
+
*
|
|
365
|
+
* `fill` stretches to the container and pins the panel to the trigger's width.
|
|
366
|
+
* `content` hugs the trigger and takes that width as the panel's FLOOR, so the
|
|
367
|
+
* panel still grows to its options — without it a short trigger gives a panel
|
|
368
|
+
* too narrow to read.
|
|
369
|
+
*/
|
|
370
|
+
type DsControlWidth = 'fill' | 'content';
|
|
371
|
+
|
|
372
|
+
/**
|
|
373
|
+
* What a picker's trigger shows.
|
|
374
|
+
*
|
|
375
|
+
* `full` is the control's own display — chips, or the selected value.
|
|
376
|
+
*
|
|
377
|
+
* `count` is a caption and a selected-count badge at intrinsic width, for a filter
|
|
378
|
+
* toolbar where a field that grows with the selection does not fit. `labels` is the
|
|
379
|
+
* same footprint but names what is selected instead of counting it, cut to what the
|
|
380
|
+
* trigger is wide enough for, with the rest behind "+N" — the same measurement the
|
|
381
|
+
* chips already use.
|
|
382
|
+
*
|
|
383
|
+
* Only pickers that hold several values offer the other two: a single-value control
|
|
384
|
+
* has nothing to count and nothing to list, and its `full` trigger is already the
|
|
385
|
+
* caption plus the value.
|
|
386
|
+
*/
|
|
387
|
+
type DsTriggerDisplay = 'full' | 'count' | 'labels';
|
|
388
|
+
|
|
340
389
|
declare class IconComponent {
|
|
341
390
|
private readonly sanitizer;
|
|
342
391
|
private readonly registry;
|
|
@@ -412,19 +461,81 @@ declare class ReserveMessagesDirective {
|
|
|
412
461
|
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ReserveMessagesDirective, "[dsReserveMessages]", never, {}, {}, never, never, true, never>;
|
|
413
462
|
}
|
|
414
463
|
|
|
464
|
+
type FieldMessageState = 'default' | 'error' | 'warning' | 'success';
|
|
465
|
+
|
|
466
|
+
/**
|
|
467
|
+
* One validation error, structurally identical to Angular's signal-forms
|
|
468
|
+
* `ValidationError`.
|
|
469
|
+
*
|
|
470
|
+
* Declared here rather than imported from `@angular/forms/signals` on purpose:
|
|
471
|
+
* that module is `@experimental`, and a public DS type must not carry a
|
|
472
|
+
* dependency that can be renamed out from under consumers. Structural
|
|
473
|
+
* compatibility is all the interop needs — signal forms binds by input NAME and
|
|
474
|
+
* assigns its own `ValidationError[]`, which this shape accepts.
|
|
475
|
+
*/
|
|
476
|
+
interface DsFieldError {
|
|
477
|
+
/** Identifies the kind of error, e.g. `required`, `minlength`, `server`. */
|
|
478
|
+
readonly kind: string;
|
|
479
|
+
/** Human-readable text. Authored by the consumer, at the validator. */
|
|
480
|
+
readonly message?: string;
|
|
481
|
+
}
|
|
482
|
+
/** What a field's `errors` input accepts before normalization. */
|
|
483
|
+
type DsFieldErrorsInput = string | DsFieldError | readonly DsFieldError[] | null | undefined;
|
|
484
|
+
/**
|
|
485
|
+
* The one reserved `DsFieldError.kind`. An error carrying it is advisory: it shows
|
|
486
|
+
* in the warning state and does NOT make the control invalid, which is how a form
|
|
487
|
+
* model can raise a non-blocking remark — Angular's own `AbstractControl` has no
|
|
488
|
+
* channel for one, only `errors` and the validity derived from it.
|
|
489
|
+
*/
|
|
490
|
+
declare const DS_FIELD_WARNING_KIND = "warning";
|
|
491
|
+
/** The single line a field shows below itself, already resolved. */
|
|
492
|
+
interface DsFieldMessage {
|
|
493
|
+
readonly text: string;
|
|
494
|
+
readonly state: FieldMessageState;
|
|
495
|
+
}
|
|
496
|
+
|
|
415
497
|
type ButtonColor = 'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning';
|
|
416
498
|
type ButtonVariant = 'solid' | 'tonal' | 'ghost' | 'outline' | 'text';
|
|
417
499
|
type ButtonType = 'button' | 'submit' | 'reset';
|
|
418
500
|
|
|
419
|
-
|
|
501
|
+
/**
|
|
502
|
+
* The inputs of anything that renders a `ds-field-message` line — the message half
|
|
503
|
+
* of a field, split out so `ds-button` can take it without also taking `errors`,
|
|
504
|
+
* `invalid` and `touched`, which describe a form control's validation state and
|
|
505
|
+
* mean nothing on a button.
|
|
506
|
+
*
|
|
507
|
+
* `@Directive()` is required, not decoration: Angular refuses to compile a base
|
|
508
|
+
* class that declares inputs without it.
|
|
509
|
+
*/
|
|
510
|
+
declare abstract class DsMessageBase {
|
|
511
|
+
/** Helper text shown below the control. */
|
|
512
|
+
readonly hint: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
|
|
513
|
+
/** Error text. Shown immediately — binding it says the consumer has already
|
|
514
|
+
* decided this is in error. Takes precedence over `errors`. */
|
|
515
|
+
readonly error: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
|
|
516
|
+
/** Advisory text, shown when there is no error. */
|
|
517
|
+
readonly warning: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
|
|
518
|
+
/** Reserve the message-row height even when empty, so the control doesn't shift
|
|
519
|
+
* the layout below it when a hint/error appears. Falls back to
|
|
520
|
+
* `DS_CONFIG.field.reserveMessage`, then off. */
|
|
521
|
+
readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
|
|
522
|
+
/** Glyph on the message line, overriding what the state resolves to. Unset
|
|
523
|
+
* follows `DS_CONFIG.field.stateIcons`; `false` removes the glyph here alone. */
|
|
524
|
+
readonly messageIcon: _angular_core.InputSignal<false | IconName | null>;
|
|
525
|
+
readonly reserveMessageResolved: _angular_core.Signal<boolean>;
|
|
526
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsMessageBase, never>;
|
|
527
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsMessageBase, never, never, { "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "messageIcon": { "alias": "messageIcon"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
528
|
+
}
|
|
529
|
+
|
|
530
|
+
declare class ButtonComponent extends DsMessageBase {
|
|
420
531
|
/** Segment of a ds-field-group: the group owns the border, radius and focus
|
|
421
532
|
* ring, so .in-group strips this control back to its bare contents. */
|
|
422
533
|
protected readonly inGroup: boolean;
|
|
423
534
|
/** Brand/status hue family. */
|
|
424
535
|
readonly color: _angular_core.InputSignal<ButtonColor>;
|
|
425
536
|
/** Fill pattern: solid | tonal | ghost | outline | text. All color×variant
|
|
426
|
-
pairs render; some are UX-discouraged
|
|
427
|
-
|
|
537
|
+
pairs render; some are UX-discouraged and emit a dev-mode
|
|
538
|
+
warning naming the reason — they work, but read poorly. `text` is
|
|
428
539
|
discouraged for ALL colours — prefer the global `.link` class; it stays for
|
|
429
540
|
cases needing the ds-button API (loading/fullWidth/typed pressed). */
|
|
430
541
|
readonly variant: _angular_core.InputSignal<ButtonVariant>;
|
|
@@ -458,6 +569,21 @@ declare class ButtonComponent {
|
|
|
458
569
|
/** ARIA `aria-controls`, forwarded to the inner <button> — the id of the panel
|
|
459
570
|
* this button opens, e.g. `ds-app-layout`'s `railId`. */
|
|
460
571
|
readonly ariaControls: _angular_core.InputSignal<string | null>;
|
|
572
|
+
/** Why the button is refused, shown as its second line. Read only while
|
|
573
|
+
* `disabled` — a greyed control that does not say why is a dead end.
|
|
574
|
+
*
|
|
575
|
+
* Setting it also changes HOW the button is disabled: it takes `aria-disabled`
|
|
576
|
+
* instead of the native attribute, because a natively disabled button cannot be
|
|
577
|
+
* focused and the reason would never be announced. The click is swallowed in
|
|
578
|
+
* `onClick` instead. Leave it unset and nothing changes.
|
|
579
|
+
*
|
|
580
|
+
* Length is deliberately not capped: the text wraps and the button grows. Same
|
|
581
|
+
* name and meaning as `TableRowAction.disabledReason`. */
|
|
582
|
+
readonly disabledReason: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
|
|
583
|
+
/** ARIA `aria-describedby` — point the button at a description the app renders
|
|
584
|
+
* itself, such as a `ds-field-message` under a form. Merged with the id of
|
|
585
|
+
* `disabledReason` when both are present. */
|
|
586
|
+
readonly ariaDescribedBy: _angular_core.InputSignal<string | null>;
|
|
461
587
|
/** Fires on click, unless `disabled` or `loading`. */
|
|
462
588
|
readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
|
|
463
589
|
/** The inner native <button>, exposed so overlay triggers can position
|
|
@@ -465,10 +591,18 @@ declare class ButtonComponent {
|
|
|
465
591
|
* `(pressed)="pop.toggle(trigger.buttonRef().nativeElement)"`. */
|
|
466
592
|
readonly buttonRef: _angular_core.Signal<ElementRef<HTMLButtonElement>>;
|
|
467
593
|
protected readonly classes: _angular_core.Signal<string>;
|
|
594
|
+
protected readonly softDisabled: _angular_core.Signal<boolean>;
|
|
595
|
+
private readonly uid;
|
|
596
|
+
protected readonly reasonId: string;
|
|
597
|
+
protected readonly hintId: _angular_core.Signal<string | null>;
|
|
598
|
+
protected readonly describedBy: _angular_core.Signal<string | null>;
|
|
599
|
+
protected readonly hasMessageRow: _angular_core.Signal<boolean>;
|
|
600
|
+
private readonly fieldMessage;
|
|
601
|
+
protected readonly message: _angular_core.Signal<DsFieldMessage>;
|
|
468
602
|
constructor();
|
|
469
603
|
protected onClick(event: MouseEvent): void;
|
|
470
604
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonComponent, never>;
|
|
471
|
-
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>;
|
|
605
|
+
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; }; "disabledReason": { "alias": "disabledReason"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["*", "[dsButtonSubtext]"], true, never>;
|
|
472
606
|
}
|
|
473
607
|
|
|
474
608
|
/** A single binary toggle button (pressed / not pressed) with an optional
|
|
@@ -500,6 +634,11 @@ declare class IconButtonComponent {
|
|
|
500
634
|
readonly icon: _angular_core.InputSignal<IconName>;
|
|
501
635
|
/** Accessible name — required since the button has no visible text. */
|
|
502
636
|
readonly ariaLabel: _angular_core.InputSignal<string>;
|
|
637
|
+
/** ARIA `aria-describedby` — the id of text the app renders beside the button,
|
|
638
|
+
* such as why the action is refused. Icon-only leaves no room for a second
|
|
639
|
+
* line, so unlike `ds-button` there is no `disabledReason` here: the text has
|
|
640
|
+
* to exist on screen already for this to point at it. */
|
|
641
|
+
readonly ariaDescribedBy: _angular_core.InputSignal<string | null>;
|
|
503
642
|
/** Fill style — standard (chromeless), filled, tonal, or outlined. */
|
|
504
643
|
readonly variant: _angular_core.InputSignal<IconButtonVariant>;
|
|
505
644
|
/** Brand/status hue family (shared with ds-button). `variant` is the fill
|
|
@@ -528,7 +667,7 @@ declare class IconButtonComponent {
|
|
|
528
667
|
protected readonly iconSize: _angular_core.Signal<16 | 24 | 20>;
|
|
529
668
|
protected onClick(event: MouseEvent): void;
|
|
530
669
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<IconButtonComponent, never>;
|
|
531
|
-
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>;
|
|
670
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<IconButtonComponent, "ds-icon-button", never, { "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": true; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "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>;
|
|
532
671
|
}
|
|
533
672
|
|
|
534
673
|
declare class BadgeComponent {
|
|
@@ -838,7 +977,7 @@ declare class BrandNameDirective {
|
|
|
838
977
|
* screens behind the login.
|
|
839
978
|
*
|
|
840
979
|
* Brand row, tagline, card and support footer are the same four parts in every
|
|
841
|
-
* consumer that has hand-rolled this. What
|
|
980
|
+
* consumer that has hand-rolled this. What a hand-rolled version gets wrong is the full-height
|
|
842
981
|
* box: they nest a `100vh` wrapper inside a `100dvh` one and scroll a page whose
|
|
843
982
|
* content fits. Here the host is the only one, and it also carries the safe-area
|
|
844
983
|
* insets a notched phone in landscape needs.
|
|
@@ -868,8 +1007,8 @@ declare class BrandNameDirective {
|
|
|
868
1007
|
declare class AuthLayoutComponent {
|
|
869
1008
|
/** Wordmark beside the letter-mark tile. For a logo image/SVG, project it into
|
|
870
1009
|
* the `[brand]` slot instead; for a two-tone wordmark use `[dsBrandName]`.
|
|
871
|
-
* Unset falls back to `DS_CONFIG.brand.name
|
|
872
|
-
* identically. Each field resolves on its own, so `brand=""` drops the wordmark
|
|
1010
|
+
* Unset falls back to `DS_CONFIG.brand.name`, which every auth screen in an app
|
|
1011
|
+
* answers identically. Each field resolves on its own, so `brand=""` drops the wordmark
|
|
873
1012
|
* but a `logoLetter` in the config still paints its tile; clear both to give one
|
|
874
1013
|
* screen no brand row. */
|
|
875
1014
|
readonly brand: _angular_core.InputSignal<string | null>;
|
|
@@ -893,10 +1032,8 @@ declare class AuthLayoutComponent {
|
|
|
893
1032
|
* content of an auth screen and `ds-card` renders an `<article>`, which is NOT
|
|
894
1033
|
* a landmark, so by default a screen-reader user has nothing to jump to — set
|
|
895
1034
|
* this to `'main'` on a standalone auth page. It is opt-in because the layout
|
|
896
|
-
* is also embedded inside pages that already own a `main
|
|
897
|
-
*
|
|
898
|
-
* Defaulting it to `'main'` is the better end state and belongs in the next
|
|
899
|
-
* batch of default changes. */
|
|
1035
|
+
* is also embedded inside pages that already own a `main`, and two `main`s is its
|
|
1036
|
+
* own violation. */
|
|
900
1037
|
readonly landmark: _angular_core.InputSignal<"none" | "main">;
|
|
901
1038
|
/** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
|
|
902
1039
|
protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
|
|
@@ -1320,39 +1457,6 @@ declare class TabsComponent {
|
|
|
1320
1457
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabsComponent, "ds-tabs", never, { "selectedIndex": { "alias": "selectedIndex"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "scrollable": { "alias": "scrollable"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "urlParam": { "alias": "urlParam"; "required": false; "isSignal": true; }; "rememberLastTab": { "alias": "rememberLastTab"; "required": false; "isSignal": true; }; }, { "selectedIndex": "selectedIndexChange"; "tabClosed": "tabClosed"; }, ["tabs"], never, true, never>;
|
|
1321
1458
|
}
|
|
1322
1459
|
|
|
1323
|
-
type FieldMessageState = 'default' | 'error' | 'warning' | 'success';
|
|
1324
|
-
|
|
1325
|
-
/**
|
|
1326
|
-
* One validation error, structurally identical to Angular's signal-forms
|
|
1327
|
-
* `ValidationError`.
|
|
1328
|
-
*
|
|
1329
|
-
* Declared here rather than imported from `@angular/forms/signals` on purpose:
|
|
1330
|
-
* that module is `@experimental`, and a public DS type must not carry a
|
|
1331
|
-
* dependency that can be renamed out from under consumers. Structural
|
|
1332
|
-
* compatibility is all the interop needs — signal forms binds by input NAME and
|
|
1333
|
-
* assigns its own `ValidationError[]`, which this shape accepts.
|
|
1334
|
-
*/
|
|
1335
|
-
interface DsFieldError {
|
|
1336
|
-
/** Identifies the kind of error, e.g. `required`, `minlength`, `server`. */
|
|
1337
|
-
readonly kind: string;
|
|
1338
|
-
/** Human-readable text. Authored by the consumer, at the validator. */
|
|
1339
|
-
readonly message?: string;
|
|
1340
|
-
}
|
|
1341
|
-
/** What a field's `errors` input accepts before normalization. */
|
|
1342
|
-
type DsFieldErrorsInput = string | DsFieldError | readonly DsFieldError[] | null | undefined;
|
|
1343
|
-
/**
|
|
1344
|
-
* The one reserved `DsFieldError.kind`. An error carrying it is advisory: it shows
|
|
1345
|
-
* in the warning state and does NOT make the control invalid, which is how a form
|
|
1346
|
-
* model can raise a non-blocking remark — Angular's own `AbstractControl` has no
|
|
1347
|
-
* channel for one, only `errors` and the validity derived from it.
|
|
1348
|
-
*/
|
|
1349
|
-
declare const DS_FIELD_WARNING_KIND = "warning";
|
|
1350
|
-
/** The single line a field shows below itself, already resolved. */
|
|
1351
|
-
interface DsFieldMessage {
|
|
1352
|
-
readonly text: string;
|
|
1353
|
-
readonly state: FieldMessageState;
|
|
1354
|
-
}
|
|
1355
|
-
|
|
1356
1460
|
/**
|
|
1357
1461
|
* The inputs every DS form field has, declared once.
|
|
1358
1462
|
*
|
|
@@ -1361,17 +1465,11 @@ interface DsFieldMessage {
|
|
|
1361
1465
|
* lifting them would hand a checkbox a `success` or a slider a `label` it never
|
|
1362
1466
|
* had — a silent public-API addition.
|
|
1363
1467
|
*
|
|
1364
|
-
*
|
|
1365
|
-
*
|
|
1468
|
+
* The message half lives one level up in `DsMessageBase`, which anything with a
|
|
1469
|
+
* message line can take. What stays here is the validation state a form control
|
|
1470
|
+
* has and a plain control does not.
|
|
1366
1471
|
*/
|
|
1367
|
-
declare abstract class DsFieldBase {
|
|
1368
|
-
/** Helper text shown below the field. */
|
|
1369
|
-
readonly hint: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
|
|
1370
|
-
/** Error text. Shown immediately — binding it says the consumer has already
|
|
1371
|
-
* decided this field is in error. Takes precedence over `errors`. */
|
|
1372
|
-
readonly error: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
|
|
1373
|
-
/** Advisory text, shown when there is no error. */
|
|
1374
|
-
readonly warning: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
|
|
1472
|
+
declare abstract class DsFieldBase extends DsMessageBase {
|
|
1375
1473
|
/** Validation errors, shown once the user has interacted. Bound automatically
|
|
1376
1474
|
* by signal forms; reactive and template-driven forms are read through
|
|
1377
1475
|
* `NgControl` and need nothing here. Accepts a string, one error, or an array. */
|
|
@@ -1383,18 +1481,8 @@ declare abstract class DsFieldBase {
|
|
|
1383
1481
|
/** Whether the user has interacted with the field. Bound by signal forms; gates
|
|
1384
1482
|
* `errors`, so a `required` error does not greet an untouched form. */
|
|
1385
1483
|
readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1386
|
-
/** Reserve the message-row height even when empty, so the field doesn't shift
|
|
1387
|
-
* the layout below it when a hint/error appears. Falls back to
|
|
1388
|
-
* `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
|
|
1389
|
-
* for a form that shows validation messages. */
|
|
1390
|
-
readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
|
|
1391
|
-
/** Glyph on the message line, overriding what the state resolves to. Unset
|
|
1392
|
-
* follows `DS_CONFIG.field.stateIcons`; `false` removes the glyph on this field
|
|
1393
|
-
* alone. */
|
|
1394
|
-
readonly messageIcon: _angular_core.InputSignal<false | IconName | null>;
|
|
1395
|
-
readonly reserveMessageResolved: _angular_core.Signal<boolean>;
|
|
1396
1484
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsFieldBase, never>;
|
|
1397
|
-
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsFieldBase, never, never, { "
|
|
1485
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsFieldBase, never, never, { "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
1398
1486
|
}
|
|
1399
1487
|
|
|
1400
1488
|
/**
|
|
@@ -1787,12 +1875,10 @@ declare class DsStaticPreview {
|
|
|
1787
1875
|
|
|
1788
1876
|
interface SelectOption extends DsOption<string> {
|
|
1789
1877
|
}
|
|
1790
|
-
|
|
1791
|
-
|
|
1792
|
-
options: SelectOption[];
|
|
1793
|
-
disabled?: boolean;
|
|
1878
|
+
type SelectWidth = DsControlWidth;
|
|
1879
|
+
interface SelectOptionGroup extends DsOptionGroup<string> {
|
|
1794
1880
|
}
|
|
1795
|
-
type SelectItem =
|
|
1881
|
+
type SelectItem = DsOptionItem<string>;
|
|
1796
1882
|
declare function isSelectOptionGroup(item: SelectItem): item is SelectOptionGroup;
|
|
1797
1883
|
|
|
1798
1884
|
declare class SelectComponent extends DsControlValueAccessor<string> implements OnDestroy {
|
|
@@ -1806,7 +1892,15 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1806
1892
|
/** Selected option's value, two-way bound. */
|
|
1807
1893
|
readonly value: _angular_core.ModelSignal<string>;
|
|
1808
1894
|
/** Flat options or option groups rendered in the dropdown panel. */
|
|
1809
|
-
readonly options: _angular_core.InputSignal<SelectItem[]>;
|
|
1895
|
+
readonly options: _angular_core.InputSignal<readonly SelectItem[]>;
|
|
1896
|
+
/** Public panel tokens forwarded onto the portaled overlay pane on open, so a
|
|
1897
|
+
* consumer's `ds-select { --ds-dropdown-panel-*: … }` reaches it. Without this the
|
|
1898
|
+
* tokens can only be set globally: the pane is portaled out of this component. */
|
|
1899
|
+
private readonly panelTokens;
|
|
1900
|
+
/** Trigger width — `fill` stretches to the container and pins the panel to the
|
|
1901
|
+
* trigger's width; `content` hugs the trigger's own content and takes that width
|
|
1902
|
+
* as the panel's FLOOR, so the panel can still grow to its options. */
|
|
1903
|
+
readonly width: _angular_core.InputSignal<_ids_group_ltd_ids_design_system.DsControlWidth>;
|
|
1810
1904
|
/** Shown in the trigger when nothing is selected. */
|
|
1811
1905
|
readonly placeholder: _angular_core.InputSignal<string>;
|
|
1812
1906
|
/** Trigger height — sm/md/lg.
|
|
@@ -1838,6 +1932,9 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1838
1932
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
1839
1933
|
/** Shows an inline clear (×) button when a value is selected. */
|
|
1840
1934
|
readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1935
|
+
protected readonly optionTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
1936
|
+
protected readonly pickerTrigger: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
1937
|
+
protected readonly emptyTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
1841
1938
|
protected readonly uid: string;
|
|
1842
1939
|
protected readonly labelId: string;
|
|
1843
1940
|
protected readonly listboxId: string;
|
|
@@ -1883,7 +1980,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1883
1980
|
private firstEnabledIndex;
|
|
1884
1981
|
private lastEnabledIndex;
|
|
1885
1982
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
|
|
1886
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "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"; },
|
|
1983
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "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"; }, ["optionTemplate", "pickerTrigger", "emptyTemplate"], never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
|
|
1887
1984
|
}
|
|
1888
1985
|
|
|
1889
1986
|
/**
|
|
@@ -2031,8 +2128,26 @@ interface TableColumn<T = unknown> {
|
|
|
2031
2128
|
* colour and underline while the row is hovered. Only has an effect on a
|
|
2032
2129
|
* `rowInteractive` table: on a passive one every hover treatment is suppressed on
|
|
2033
2130
|
* purpose, so a tint cannot promise a click that does not happen. Style it with
|
|
2034
|
-
* `--ds-table-cell-link-color` / `--ds-table-cell-link-decoration`.
|
|
2131
|
+
* `--ds-table-cell-link-color` / `--ds-table-cell-link-decoration`.
|
|
2132
|
+
*
|
|
2133
|
+
* Prefer `link` where the row leads somewhere: a tint appears only on hover, which
|
|
2134
|
+
* a keyboard or touch user never sees. */
|
|
2035
2135
|
interactive?: boolean;
|
|
2136
|
+
/** Renders this column's value as a real `<a>`, which is the accessible way to say
|
|
2137
|
+
* a row leads somewhere: it is visible without hovering, lands in the tab order as
|
|
2138
|
+
* a link rather than as a table row, and opens in a new tab on Ctrl/Cmd-click —
|
|
2139
|
+
* none of which a clickable `<tr>` can offer.
|
|
2140
|
+
*
|
|
2141
|
+
* Return an Angular route target (a string, or the array form for dynamic
|
|
2142
|
+
* segments); `null` / `undefined` leaves that row's cell as plain text, so a list
|
|
2143
|
+
* where only some rows are reachable needs no second column. For an external URL,
|
|
2144
|
+
* render the cell through a `[cell]` template instead — this takes route targets
|
|
2145
|
+
* only, and the router is touched at all only once a column sets `link`.
|
|
2146
|
+
*
|
|
2147
|
+
* Composes with `rowInteractive`: the link stops its own click from reaching the
|
|
2148
|
+
* row, so the row handler fires for the rest of the row and the link navigates
|
|
2149
|
+
* once. Style it with the same `--ds-table-cell-link-*` tokens as `interactive`. */
|
|
2150
|
+
link?: (row: T) => string | readonly unknown[] | null | undefined;
|
|
2036
2151
|
/** Initial visibility: start hidden. The column picker (or a bound
|
|
2037
2152
|
* `hiddenKeys` set) owns the state from then on; a hidden column stays
|
|
2038
2153
|
* available to `filterable` matching and sorting. */
|
|
@@ -2087,7 +2202,7 @@ declare class TableComponent<T extends object> {
|
|
|
2087
2202
|
/** Adds a checkbox column for row/select-all selection. */
|
|
2088
2203
|
readonly selectable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2089
2204
|
/** Opt-in outer border + radius. Off by default so tables flush inside a
|
|
2090
|
-
* `<ds-card padding="none">`
|
|
2205
|
+
* `<ds-card padding="none">` don't double-border.
|
|
2091
2206
|
* When `true`, the scroll-wrap gets a `var(--border-default)` outline and
|
|
2092
2207
|
* `var(--radius-md)` radius — useful when the table stands alone in a padded card.
|
|
2093
2208
|
* Unset falls back to `DS_CONFIG.table.bordered`, then `false`. */
|
|
@@ -2592,6 +2707,7 @@ declare class TableComponent<T extends object> {
|
|
|
2592
2707
|
protected headerClasses(col: TableColumn<T>): string;
|
|
2593
2708
|
protected sortIcon(col: TableColumn<T>): 'sortAsc' | 'sortDesc' | 'sort';
|
|
2594
2709
|
protected cellValue(row: T, col: TableColumn<T>): string;
|
|
2710
|
+
protected cellLink(row: T, col: TableColumn<T>): string | readonly unknown[] | null;
|
|
2595
2711
|
/** Serialises the visible columns of the rows the TABLE HOLDS as a CSV download.
|
|
2596
2712
|
* On a server-paged table that is one page — prefer `runExport()`, which goes
|
|
2597
2713
|
* through `exportFetcher` and exports the whole set. Pass `rows` to serialise a
|
|
@@ -3121,7 +3237,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
|
|
|
3121
3237
|
protected readonly columns: _angular_core.Signal<TimeColumnsComponent | undefined>;
|
|
3122
3238
|
/** Any of the three trigger boxes, not the host: a range renders two and a single
|
|
3123
3239
|
* one renders one, while the host also carries the label and the message row —
|
|
3124
|
-
* clicking those has to dismiss the panel
|
|
3240
|
+
* clicking those has to dismiss the panel. */
|
|
3125
3241
|
private insideATrigger;
|
|
3126
3242
|
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
3127
3243
|
protected readonly hintId: _angular_core.Signal<string | null>;
|
|
@@ -3244,6 +3360,13 @@ declare class SidenavComponent implements SidenavContract {
|
|
|
3244
3360
|
* "A" tile beside the "MyAdmin" wordmark). Empty = first letter of `brand`;
|
|
3245
3361
|
* unset falls back to `DS_CONFIG.brand.logoLetter`. */
|
|
3246
3362
|
readonly logoLetter: _angular_core.InputSignal<string | null>;
|
|
3363
|
+
/** Route the brand row links to — typically the app's home. Unset leaves the row a
|
|
3364
|
+
* plain, non-interactive block. Router targets only, and `RouterLink` is
|
|
3365
|
+
* instantiated only once this is set, so an app with no router still renders. */
|
|
3366
|
+
readonly brandRoute: _angular_core.InputSignal<string | readonly unknown[] | null>;
|
|
3367
|
+
/** Accessible name for the brand link; unset names it "<brand>, home". Ignored
|
|
3368
|
+
* while `brandRoute` is unset. */
|
|
3369
|
+
readonly brandLinkLabel: _angular_core.InputSignal<string | null>;
|
|
3247
3370
|
/** The template must read THIS, never the input beside it — that one is null
|
|
3248
3371
|
* until bound, and the config default lives here. */
|
|
3249
3372
|
readonly brandName: _angular_core.Signal<string>;
|
|
@@ -3255,8 +3378,9 @@ declare class SidenavComponent implements SidenavContract {
|
|
|
3255
3378
|
* starting with an astral character (an emoji, a rarer CJK glyph) yields half
|
|
3256
3379
|
* a surrogate pair and paints as tofu. */
|
|
3257
3380
|
protected readonly markGlyph: _angular_core.Signal<string>;
|
|
3381
|
+
protected readonly brandAriaLabel: _angular_core.Signal<string>;
|
|
3258
3382
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavComponent, never>;
|
|
3259
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavComponent, "ds-sidenav", never, { "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "rail": { "alias": "rail"; "required": false; "isSignal": true; }; "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "logoLetter": { "alias": "logoLetter"; "required": false; "isSignal": true; }; }, {}, ["brandNameRef"], ["[brand]", "[dsBrandName]", "*"], true, never>;
|
|
3383
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavComponent, "ds-sidenav", never, { "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "rail": { "alias": "rail"; "required": false; "isSignal": true; }; "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "logoLetter": { "alias": "logoLetter"; "required": false; "isSignal": true; }; "brandRoute": { "alias": "brandRoute"; "required": false; "isSignal": true; }; "brandLinkLabel": { "alias": "brandLinkLabel"; "required": false; "isSignal": true; }; }, {}, ["brandNameRef"], ["[brand]", "[dsBrandName]", "*"], true, never>;
|
|
3260
3384
|
}
|
|
3261
3385
|
|
|
3262
3386
|
declare class SidenavGroupComponent {
|
|
@@ -3340,7 +3464,7 @@ interface SidenavAlertItem {
|
|
|
3340
3464
|
* A single global-search hit rendered in the sidenav Search popover. The footer
|
|
3341
3465
|
* stays domain-agnostic: the layout supplies a {@link SidenavSearchProvider} that maps
|
|
3342
3466
|
* a query string to these results, so the footer never needs to know about the
|
|
3343
|
-
*
|
|
3467
|
+
* app's sections or entities.
|
|
3344
3468
|
*/
|
|
3345
3469
|
interface SidenavSearchResult {
|
|
3346
3470
|
readonly id: string;
|
|
@@ -4162,14 +4286,15 @@ declare class PageFooterComponent {
|
|
|
4162
4286
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<PageFooterComponent, "ds-page-footer", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["[brand]", "[nav]", "[actions]", "*"], true, never>;
|
|
4163
4287
|
}
|
|
4164
4288
|
|
|
4165
|
-
/** `
|
|
4166
|
-
type AutocompleteWidth =
|
|
4289
|
+
/** `content` here also reserves a minimum typing area beside the chips. */
|
|
4290
|
+
type AutocompleteWidth = DsControlWidth;
|
|
4291
|
+
/** What a settled single value does when it outgrows the trigger. */
|
|
4292
|
+
type AutocompleteValueOverflow = 'ellipsis' | 'wrap';
|
|
4167
4293
|
interface AutocompleteOption<T = unknown> extends DsOption<T> {
|
|
4168
4294
|
}
|
|
4169
|
-
interface AutocompleteOptionGroup<T = unknown> {
|
|
4170
|
-
readonly label: string;
|
|
4171
|
-
readonly options: AutocompleteOption<T>[];
|
|
4295
|
+
interface AutocompleteOptionGroup<T = unknown> extends DsOptionGroup<T> {
|
|
4172
4296
|
}
|
|
4297
|
+
type AutocompleteItem<T = unknown> = DsOptionItem<T>;
|
|
4173
4298
|
|
|
4174
4299
|
declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<T | readonly T[] | null> implements OnDestroy {
|
|
4175
4300
|
/** Segment of a ds-field-group: the group owns the border, radius and focus
|
|
@@ -4181,10 +4306,8 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4181
4306
|
/** Public panel tokens forwarded onto the portaled overlay pane on open so
|
|
4182
4307
|
* a consumer's `ds-autocomplete { --ds-autocomplete-panel-*: … }` reaches it. */
|
|
4183
4308
|
private readonly panelTokens;
|
|
4184
|
-
/**
|
|
4185
|
-
readonly options: _angular_core.InputSignal<readonly
|
|
4186
|
-
/** Options grouped under labelled sections, rendered instead of `options`. */
|
|
4187
|
-
readonly optionGroups: _angular_core.InputSignal<AutocompleteOptionGroup<T>[]>;
|
|
4309
|
+
/** Options, groups, or both mixed — rendered in the order given. */
|
|
4310
|
+
readonly options: _angular_core.InputSignal<readonly AutocompleteItem<T>[]>;
|
|
4188
4311
|
/** Selected value, or an array of values when `multiple`. */
|
|
4189
4312
|
readonly value: _angular_core.ModelSignal<T | readonly T[] | null>;
|
|
4190
4313
|
/** Allows selecting more than one option, shown as removable tags. */
|
|
@@ -4207,7 +4330,12 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4207
4330
|
readonly size: _angular_core.InputSignal<DsSize | null>;
|
|
4208
4331
|
readonly sizeResolved: _angular_core.Signal<DsSize>;
|
|
4209
4332
|
/** Trigger width — `fill` stretches to the container, `content` hugs the value. */
|
|
4210
|
-
readonly width: _angular_core.InputSignal<
|
|
4333
|
+
readonly width: _angular_core.InputSignal<_ids_group_ltd_ids_design_system.DsControlWidth>;
|
|
4334
|
+
/** What a settled single value does when it is wider than the trigger. Defaults
|
|
4335
|
+
* to `ellipsis`; `wrap` restores the pre-0.12 behaviour, where the value broke
|
|
4336
|
+
* onto a second line and pushed the chevron onto a third. Multi mode is
|
|
4337
|
+
* unaffected — its chips have their own measured cap. */
|
|
4338
|
+
readonly valueOverflow: _angular_core.InputSignal<AutocompleteValueOverflow>;
|
|
4211
4339
|
/** Placeholder shown in the input when empty. */
|
|
4212
4340
|
readonly placeholder: _angular_core.InputSignal<string>;
|
|
4213
4341
|
/** Disables the trigger and blocks all interaction. */
|
|
@@ -4217,6 +4345,12 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4217
4345
|
readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
|
|
4218
4346
|
/** Shows a "Create «text»" row when the typed text matches no option. */
|
|
4219
4347
|
readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4348
|
+
/** Field label above the control — the same meaning it has on the other two pickers. */
|
|
4349
|
+
readonly label: _angular_core.InputSignal<string>;
|
|
4350
|
+
/** Marks the field required: a `*` beside the label and `aria-required` on the input. */
|
|
4351
|
+
readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4352
|
+
/** Marks the field optional in words, for a form where most fields are required. */
|
|
4353
|
+
readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4220
4354
|
/** Accessible name for the input. */
|
|
4221
4355
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
4222
4356
|
/** Fires with the typed text when the user picks the create-new option. */
|
|
@@ -4227,6 +4361,11 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4227
4361
|
protected readonly message: _angular_core.Signal<DsFieldMessage>;
|
|
4228
4362
|
protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
|
|
4229
4363
|
protected readonly invalidResolved: _angular_core.Signal<boolean>;
|
|
4364
|
+
protected readonly optionTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4365
|
+
protected readonly chipTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4366
|
+
protected readonly pickerTrigger: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4367
|
+
protected readonly emptyTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4368
|
+
protected readonly createTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4230
4369
|
protected readonly query: _angular_core.WritableSignal<string>;
|
|
4231
4370
|
protected readonly isOpen: _angular_core.WritableSignal<boolean>;
|
|
4232
4371
|
protected readonly activeIndex: _angular_core.WritableSignal<number>;
|
|
@@ -4237,17 +4376,20 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4237
4376
|
private overlayRef;
|
|
4238
4377
|
protected readonly uid: string;
|
|
4239
4378
|
protected readonly listboxId: string;
|
|
4379
|
+
protected readonly labelId: string;
|
|
4240
4380
|
protected optionId(index: number): string;
|
|
4241
4381
|
protected readonly activeDescendant: _angular_core.Signal<string | null>;
|
|
4242
|
-
/** All options flattened from either optionGroups or options. */
|
|
4243
4382
|
protected readonly allOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
|
|
4383
|
+
protected readonly filteredItems: _angular_core.Signal<AutocompleteItem<T>[]>;
|
|
4244
4384
|
protected readonly filteredOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
|
|
4245
|
-
|
|
4246
|
-
protected readonly filteredGroups: _angular_core.Signal<AutocompleteOptionGroup<T>[]>;
|
|
4385
|
+
protected isGroup(item: AutocompleteItem<T>): item is AutocompleteOptionGroup<T>;
|
|
4247
4386
|
/** Whether to show the "Create «text»" row at the bottom of the panel. */
|
|
4248
4387
|
protected readonly showCreateRow: _angular_core.Signal<boolean>;
|
|
4249
4388
|
/** Flat list of visible options used for keyboard navigation index. */
|
|
4250
4389
|
protected readonly visibleOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
|
|
4390
|
+
/** The visible label wins the accessible name when there is one — otherwise the
|
|
4391
|
+
* placeholder would announce over it, and `placeholder` always carries a default. */
|
|
4392
|
+
protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
|
|
4251
4393
|
protected readonly selectedTags: _angular_core.Signal<AutocompleteOption<T>[]>;
|
|
4252
4394
|
private readonly chipsMode;
|
|
4253
4395
|
private readonly showsEveryChip;
|
|
@@ -4266,7 +4408,10 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4266
4408
|
* list it reads would silently make it remove the last VISIBLE one instead. */
|
|
4267
4409
|
protected readonly visibleTags: _angular_core.Signal<AutocompleteOption<T>[]>;
|
|
4268
4410
|
protected readonly overflowCount: _angular_core.Signal<number>;
|
|
4411
|
+
protected readonly selectedOption: _angular_core.Signal<AutocompleteOption<T> | null>;
|
|
4269
4412
|
protected readonly displayLabel: _angular_core.Signal<string>;
|
|
4413
|
+
protected readonly hasSingleValue: _angular_core.Signal<boolean>;
|
|
4414
|
+
protected readonly triggerSelection: _angular_core.Signal<AutocompleteOption<T> | AutocompleteOption<T>[] | null>;
|
|
4270
4415
|
protected readonly placeholderText: _angular_core.Signal<string>;
|
|
4271
4416
|
protected isSelected(option: AutocompleteOption<T>): boolean;
|
|
4272
4417
|
protected optionClass(option: AutocompleteOption<T>): string;
|
|
@@ -4304,7 +4449,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4304
4449
|
protected onCreateNew(): void;
|
|
4305
4450
|
protected remove(target: T): void;
|
|
4306
4451
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent<any>, never>;
|
|
4307
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "
|
|
4452
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showChevron": { "alias": "showChevron"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "valueOverflow": { "alias": "valueOverflow"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "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; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "create": "create"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "emptyTemplate", "createTemplate"], ["[dsAutocompletePrefix]", "[dsAutocompleteSuffix]"], true, never>;
|
|
4308
4453
|
}
|
|
4309
4454
|
|
|
4310
4455
|
type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
|
|
@@ -4717,6 +4862,10 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
|
|
|
4717
4862
|
|
|
4718
4863
|
interface MultiSelectOption extends DsOption<string> {
|
|
4719
4864
|
}
|
|
4865
|
+
interface MultiSelectOptionGroup extends DsOptionGroup<string> {
|
|
4866
|
+
}
|
|
4867
|
+
type MultiSelectItem = DsOptionItem<string>;
|
|
4868
|
+
type MultiSelectWidth = DsControlWidth;
|
|
4720
4869
|
|
|
4721
4870
|
declare class MultiSelectComponent extends DsControlValueAccessor<string[]> implements OnDestroy {
|
|
4722
4871
|
private readonly overlay;
|
|
@@ -4727,12 +4876,20 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
4727
4876
|
private readonly panelTokens;
|
|
4728
4877
|
/** Selected values, two-way bound. */
|
|
4729
4878
|
readonly value: _angular_core.ModelSignal<string[]>;
|
|
4730
|
-
/** Options
|
|
4731
|
-
readonly options: _angular_core.InputSignal<readonly
|
|
4879
|
+
/** Options, groups, or both mixed — rendered in the order given. */
|
|
4880
|
+
readonly options: _angular_core.InputSignal<readonly MultiSelectItem[]>;
|
|
4732
4881
|
/** Placeholder shown in the trigger when nothing is selected. */
|
|
4733
4882
|
readonly placeholder: _angular_core.InputSignal<string>;
|
|
4734
4883
|
/** Placeholder for the in-panel filter input. */
|
|
4735
4884
|
readonly searchPlaceholder: _angular_core.InputSignal<string>;
|
|
4885
|
+
/** Whether the panel carries a filter row. `true` always, `false` never, and a
|
|
4886
|
+
* NUMBER is a threshold — the row appears once there are at least that many
|
|
4887
|
+
* options. Unset falls back to `DS_CONFIG.picker.searchable`, then `true`.
|
|
4888
|
+
*
|
|
4889
|
+
* Hiding it moves the panel's keyboard model onto the trigger: the arrows,
|
|
4890
|
+
* Enter, Escape and `aria-activedescendant` are the filter input's today. */
|
|
4891
|
+
readonly searchable: _angular_core.InputSignalWithTransform<number | boolean | null, unknown>;
|
|
4892
|
+
readonly searchableResolved: _angular_core.Signal<number | boolean>;
|
|
4736
4893
|
/** How the chips collapse when they outgrow one line. `"fit"` (the default)
|
|
4737
4894
|
* measures and shows as many as the trigger is wide, the rest behind "+N more".
|
|
4738
4895
|
* A NUMBER is a CEILING, not a promise: the row still measures, so you get at
|
|
@@ -4750,10 +4907,36 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
4750
4907
|
readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
|
|
4751
4908
|
/** Accessible name for the trigger — falls back to `placeholder`. */
|
|
4752
4909
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
4753
|
-
/**
|
|
4754
|
-
|
|
4910
|
+
/** Trigger width — `fill` stretches to the container and pins the panel to the
|
|
4911
|
+
* trigger's width; `content` hugs the trigger's own content and takes that width
|
|
4912
|
+
* as the panel's FLOOR, so a compact trigger does not force an unreadable panel. */
|
|
4913
|
+
readonly width: _angular_core.InputSignal<_ids_group_ltd_ids_design_system.DsControlWidth>;
|
|
4914
|
+
/** Trigger height — sm/md/lg. Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
|
|
4915
|
+
readonly size: _angular_core.InputSignal<DsSize | null>;
|
|
4916
|
+
readonly sizeResolved: _angular_core.Signal<DsSize>;
|
|
4917
|
+
/** What the trigger shows. `count` is a caption plus a selected-count badge at
|
|
4918
|
+
* intrinsic width; `labels` names the selection instead, cut to the width with the
|
|
4919
|
+
* rest behind "+N". A projected `dsPickerTrigger` template WINS over this — the
|
|
4920
|
+
* input is then not read at all. */
|
|
4921
|
+
readonly triggerDisplay: _angular_core.InputSignal<DsTriggerDisplay>;
|
|
4922
|
+
/** Field label above the control — the same meaning it has on `ds-select`, and the
|
|
4923
|
+
* caption a `count`/`labels` trigger uses when it needs one. */
|
|
4924
|
+
readonly label: _angular_core.InputSignal<string>;
|
|
4925
|
+
/** Marks the field required: a `*` beside the label and `aria-required` on the trigger. */
|
|
4926
|
+
readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4927
|
+
/** Marks the field optional in words, for a form where most fields are required. */
|
|
4928
|
+
readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4929
|
+
/** Where a "select all" row appears. `false` nowhere, `true` one row over the whole
|
|
4930
|
+
* panel, `'group'` one row per group, `'both'` for either. Group rows need groups
|
|
4931
|
+
* in `options` — with a flat list they have nothing to head. */
|
|
4932
|
+
readonly selectAll: _angular_core.InputSignalWithTransform<boolean | "group" | "both", unknown>;
|
|
4933
|
+
protected readonly optionTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4934
|
+
protected readonly chipTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4935
|
+
protected readonly pickerTrigger: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4936
|
+
protected readonly emptyTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4755
4937
|
protected readonly uid: string;
|
|
4756
4938
|
protected readonly listboxId: string;
|
|
4939
|
+
protected readonly labelId: string;
|
|
4757
4940
|
protected optionId(index: number): string;
|
|
4758
4941
|
protected readonly trigger: _angular_core.Signal<ElementRef<HTMLElement>>;
|
|
4759
4942
|
protected readonly searchInput: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
|
|
@@ -4766,6 +4949,11 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
4766
4949
|
private focusTimer;
|
|
4767
4950
|
ngOnDestroy(): void;
|
|
4768
4951
|
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
4952
|
+
protected readonly showsCompactTrigger: _angular_core.Signal<boolean>;
|
|
4953
|
+
protected readonly showsSearch: _angular_core.Signal<boolean>;
|
|
4954
|
+
protected readonly triggerActiveDescendant: _angular_core.Signal<string | null>;
|
|
4955
|
+
protected readonly triggerCaption: _angular_core.Signal<string>;
|
|
4956
|
+
protected readonly allOptions: _angular_core.Signal<MultiSelectOption[]>;
|
|
4769
4957
|
protected readonly selectedOptions: _angular_core.Signal<MultiSelectOption[]>;
|
|
4770
4958
|
private readonly chipsMode;
|
|
4771
4959
|
private readonly showsEveryChip;
|
|
@@ -4784,7 +4972,13 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
4784
4972
|
private readonly chipsThatFit;
|
|
4785
4973
|
protected readonly visibleChips: _angular_core.Signal<MultiSelectOption[]>;
|
|
4786
4974
|
protected readonly overflowCount: _angular_core.Signal<number>;
|
|
4975
|
+
protected readonly filteredItems: _angular_core.Signal<MultiSelectItem[]>;
|
|
4787
4976
|
protected readonly filteredOptions: _angular_core.Signal<MultiSelectOption[]>;
|
|
4977
|
+
protected isGroup(item: MultiSelectItem): item is MultiSelectOptionGroup;
|
|
4978
|
+
/** Where an option sits in the flat visible list — the id the listbox's
|
|
4979
|
+
* `aria-activedescendant` points at, which a grouped render cannot get from
|
|
4980
|
+
* the loop index. */
|
|
4981
|
+
protected flatIndexOf(option: MultiSelectOption): number;
|
|
4788
4982
|
protected readonly activeDescendant: _angular_core.Signal<string | null>;
|
|
4789
4983
|
protected readonly resolvedAriaLabel: _angular_core.Signal<string>;
|
|
4790
4984
|
protected readonly hintId: _angular_core.Signal<string | null>;
|
|
@@ -4795,11 +4989,18 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
4795
4989
|
private enabledFiltered;
|
|
4796
4990
|
protected readonly allFilteredSelected: _angular_core.Signal<boolean>;
|
|
4797
4991
|
protected readonly someFilteredSelected: _angular_core.Signal<boolean>;
|
|
4992
|
+
protected readonly showsPanelSelectAll: _angular_core.Signal<boolean>;
|
|
4993
|
+
protected readonly showsGroupSelectAll: _angular_core.Signal<boolean>;
|
|
4994
|
+
private enabledIn;
|
|
4995
|
+
protected groupAllSelected(group: MultiSelectOptionGroup): boolean;
|
|
4996
|
+
protected groupSomeSelected(group: MultiSelectOptionGroup): boolean;
|
|
4997
|
+
protected toggleGroup(group: MultiSelectOptionGroup): void;
|
|
4798
4998
|
protected toggleSelectAll(): void;
|
|
4799
4999
|
protected isSelected(value: string): boolean;
|
|
4800
5000
|
protected toggleValue(option: MultiSelectOption): void;
|
|
4801
5001
|
protected removeValue(value: string): void;
|
|
4802
5002
|
protected onFilter(event: Event): void;
|
|
5003
|
+
private firstEnabledIndex;
|
|
4803
5004
|
protected onTriggerKeydown(event: KeyboardEvent): void;
|
|
4804
5005
|
protected onSearchKeydown(event: KeyboardEvent): void;
|
|
4805
5006
|
protected openPanel(): void;
|
|
@@ -4807,7 +5008,7 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
4807
5008
|
protected close(cause?: DsOverlayCloseCause): void;
|
|
4808
5009
|
private moveActive;
|
|
4809
5010
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
|
|
4810
|
-
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; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; },
|
|
5011
|
+
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; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "triggerDisplay": { "alias": "triggerDisplay"; "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; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "emptyTemplate"], never, true, never>;
|
|
4811
5012
|
}
|
|
4812
5013
|
|
|
4813
5014
|
declare class SkeletonComponent {
|
|
@@ -4857,6 +5058,7 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
|
|
|
4857
5058
|
private readonly fieldMessage;
|
|
4858
5059
|
protected readonly message: _angular_core.Signal<DsFieldMessage>;
|
|
4859
5060
|
protected readonly invalidResolved: _angular_core.Signal<boolean>;
|
|
5061
|
+
protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
|
|
4860
5062
|
protected readonly fieldClass: _angular_core.Signal<string>;
|
|
4861
5063
|
protected onCheckedChange(event: Event): void;
|
|
4862
5064
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<CheckboxComponent, never>;
|
|
@@ -4949,6 +5151,7 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
|
|
|
4949
5151
|
private readonly fieldMessage;
|
|
4950
5152
|
protected readonly message: _angular_core.Signal<DsFieldMessage>;
|
|
4951
5153
|
protected readonly invalidResolved: _angular_core.Signal<boolean>;
|
|
5154
|
+
protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
|
|
4952
5155
|
private readonly radios;
|
|
4953
5156
|
private get enabledRadios();
|
|
4954
5157
|
isTabbable(radio: RadioGroupChild): boolean;
|
|
@@ -4992,6 +5195,98 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
|
|
|
4992
5195
|
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; }; "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>;
|
|
4993
5196
|
}
|
|
4994
5197
|
|
|
5198
|
+
/**
|
|
5199
|
+
* Fills an option row's LABEL AREA in `ds-select`, `ds-multi-select` and
|
|
5200
|
+
* `ds-autocomplete` — an avatar, a colour dot, a second line of metadata.
|
|
5201
|
+
*
|
|
5202
|
+
* ```html
|
|
5203
|
+
* <ds-multi-select [options]="assignees()">
|
|
5204
|
+
* <ng-template dsOptionTemplate let-option>
|
|
5205
|
+
* <ds-avatar size="xs" [seed]="option.label" /> {{ option.label }}
|
|
5206
|
+
* </ng-template>
|
|
5207
|
+
* </ds-multi-select>
|
|
5208
|
+
* ```
|
|
5209
|
+
*
|
|
5210
|
+
* The row itself stays library-owned: `role="option"`, `aria-selected`, the
|
|
5211
|
+
* active-row class, the checkbox and the check glyph are not projected, so a
|
|
5212
|
+
* template cannot take the listbox semantics with it.
|
|
5213
|
+
*/
|
|
5214
|
+
declare class DsOptionTemplateDirective {
|
|
5215
|
+
readonly template: TemplateRef<unknown>;
|
|
5216
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsOptionTemplateDirective, never>;
|
|
5217
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsOptionTemplateDirective, "[dsOptionTemplate]", never, {}, {}, never, never, true, never>;
|
|
5218
|
+
}
|
|
5219
|
+
|
|
5220
|
+
/**
|
|
5221
|
+
* Replaces the CONTENTS of a picker's trigger — the chips, the value, the
|
|
5222
|
+
* placeholder — with your own markup. The trigger ELEMENT stays library-owned,
|
|
5223
|
+
* so `aria-haspopup`, `aria-expanded`, `aria-controls`, the roving
|
|
5224
|
+
* `aria-activedescendant` and the Enter/Space/ArrowDown/Escape handling cannot
|
|
5225
|
+
* be lost with it.
|
|
5226
|
+
*
|
|
5227
|
+
* ```html
|
|
5228
|
+
* <ds-multi-select [options]="labels()" [(value)]="picked">
|
|
5229
|
+
* <ng-template dsPickerTrigger let-count="count">
|
|
5230
|
+
* Labels @if (count) { <ds-badge [count]="count" /> }
|
|
5231
|
+
* </ng-template>
|
|
5232
|
+
* </ds-multi-select>
|
|
5233
|
+
* ```
|
|
5234
|
+
*
|
|
5235
|
+
* Context: `$implicit` and `selected` are the selected options, `count` their
|
|
5236
|
+
* number, `open` whether the panel is showing, `disabled` the control's state.
|
|
5237
|
+
*
|
|
5238
|
+
* A projected template WINS over `triggerDisplay` — that input is then not read
|
|
5239
|
+
* at all, so there is no "compact plus a template" combination to explain.
|
|
5240
|
+
*/
|
|
5241
|
+
declare class DsPickerTriggerDirective {
|
|
5242
|
+
readonly template: TemplateRef<unknown>;
|
|
5243
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsPickerTriggerDirective, never>;
|
|
5244
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsPickerTriggerDirective, "[dsPickerTrigger]", never, {}, {}, never, never, true, never>;
|
|
5245
|
+
}
|
|
5246
|
+
|
|
5247
|
+
/**
|
|
5248
|
+
* Replaces a picker panel's "no matches" row — an icon, a sentence in the app's
|
|
5249
|
+
* own language, a "clear the filter" button.
|
|
5250
|
+
*
|
|
5251
|
+
* Context: `query` is the text that matched nothing.
|
|
5252
|
+
*
|
|
5253
|
+
* The row keeps `role="status"`, so a reader is told the list emptied whatever
|
|
5254
|
+
* the template puts inside it.
|
|
5255
|
+
*/
|
|
5256
|
+
declare class DsEmptyTemplateDirective {
|
|
5257
|
+
readonly template: TemplateRef<unknown>;
|
|
5258
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsEmptyTemplateDirective, never>;
|
|
5259
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsEmptyTemplateDirective, "[dsEmptyTemplate]", never, {}, {}, never, never, true, never>;
|
|
5260
|
+
}
|
|
5261
|
+
|
|
5262
|
+
/**
|
|
5263
|
+
* Replaces `ds-autocomplete`'s "Create «…»" row.
|
|
5264
|
+
*
|
|
5265
|
+
* Context: `query` is the typed text the row would create.
|
|
5266
|
+
*
|
|
5267
|
+
* The row stays a `role="option"` the keyboard can reach, and picking it still
|
|
5268
|
+
* emits `create` — the template fills the row, it does not become the action.
|
|
5269
|
+
*/
|
|
5270
|
+
declare class DsCreateTemplateDirective {
|
|
5271
|
+
readonly template: TemplateRef<unknown>;
|
|
5272
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsCreateTemplateDirective, never>;
|
|
5273
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsCreateTemplateDirective, "[dsCreateTemplate]", never, {}, {}, never, never, true, never>;
|
|
5274
|
+
}
|
|
5275
|
+
|
|
5276
|
+
/**
|
|
5277
|
+
* Fills a selected chip's content in the trigger of `ds-multi-select` and
|
|
5278
|
+
* `ds-autocomplete`, so a picker whose rows carry an avatar does not lose it the
|
|
5279
|
+
* moment the option is chosen.
|
|
5280
|
+
*
|
|
5281
|
+
* The chip is still a `ds-tag` owned by the library: its close button, its
|
|
5282
|
+
* accessible remove label and the measured overflow cap are not projected.
|
|
5283
|
+
*/
|
|
5284
|
+
declare class DsChipTemplateDirective {
|
|
5285
|
+
readonly template: TemplateRef<unknown>;
|
|
5286
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsChipTemplateDirective, never>;
|
|
5287
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsChipTemplateDirective, "[dsChipTemplate]", never, {}, {}, never, never, true, never>;
|
|
5288
|
+
}
|
|
5289
|
+
|
|
4995
5290
|
/**
|
|
4996
5291
|
* Focuses the field's inner `input`/`textarea` when the click lands on the
|
|
4997
5292
|
* frame chrome — padding, a leading/trailing icon, an addon slot — instead of
|
|
@@ -5009,5 +5304,5 @@ declare class FieldClickFocusDirective {
|
|
|
5009
5304
|
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
|
|
5010
5305
|
}
|
|
5011
5306
|
|
|
5012
|
-
export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppLayoutComponent, AuthLayoutComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BodyScrollLockService, BottomSheetComponent, BrandNameDirective, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_FIELD_GROUP, DS_FIELD_WARNING_KIND, DS_ICON_REGISTRY, DS_TOAST_CONFIG, DS_TOAST_POSITION, DS_TOAST_POSITION_DEFAULT, DatePickerComponent, DescriptionItemComponent, DescriptionListComponent, DividerComponent, DrawerComponent, DropzoneComponent, DsOverlayCloseRef, DsStaticPreview, EmptyStateComponent, FieldClickFocusDirective, FieldGroupComponent, FilterBarComponent, FilterItemDirective, HeaderFilterDirective, ICONS, IconButtonComponent, IconComponent, InlineComponent, InputComponent, LayoutNavigationService, LayoutScrollService, ListComponent, ListItemComponent, LoadingOverlayComponent, MenuComponent, MenuDividerComponent, MenuItemComponent, ModalCardComponent, ModalComponent, ModalService, MultiSelectComponent, NumberStepperComponent, OtpInputComponent, PageFooterComponent, PageHeaderComponent, PaginationComponent, PasswordRulesComponent, PopoverComponent, ProgressComponent, RADIO_GROUP, RadioComponent, RadioGroupComponent, RailTriggerDirective, ReserveMessagesDirective, SIDENAV, SearchComponent, SegmentedComponent, SelectComponent, SidenavComponent, SidenavFooterComponent, SidenavGroupComponent, SidenavItemComponent, SkeletonComponent, SliderComponent, SpinnerComponent, SplitButtonComponent, StackComponent, StatComponent, StatusDotComponent, StepperComponent, SwitchComponent, TabComponent, TableComponent, TabsComponent, TagComponent, TextareaComponent, TimePickerComponent, TimelineComponent, TimelineItemComponent, ToastComponent, ToastRegionComponent, ToastService, ToggleButtonComponent, TooltipDirective, TooltipPanelComponent, TopBarComponent, TreeComponent, W3wComponent, avatarTint, inheritDsConfig, initialsFrom, isSelectOptionGroup, passwordRulesMet, provideDsConfig, provideDsIcons, provideDsTheme };
|
|
5013
|
-
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, DsFieldError, DsFieldErrorsInput, DsFieldGroupContext, DsIconRegistry, DsOption, DsPasswordRule, DsPasswordRuleState, DsScrollReset, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, EmptyStateVariant, HeaderFilterContext, IconButtonType, IconButtonVariant, IconName, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectOption, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, SidenavAlertItem, SidenavContract, SidenavItemModel, SidenavSearchProvider, SidenavSearchResult, SortChangeEvent, SortDir, SplitButtonItem, SplitButtonVariant, StepperLabelPosition, StepperOrientation, TableCellEditEvent, TableColumn, TableFilterMode, TableRowAction, TableRowActionEvent, TableSortMode, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TimeFormat, TimePickerMode, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };
|
|
5307
|
+
export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppLayoutComponent, AuthLayoutComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BodyScrollLockService, BottomSheetComponent, BrandNameDirective, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_FIELD_GROUP, DS_FIELD_WARNING_KIND, DS_ICON_REGISTRY, DS_TOAST_CONFIG, DS_TOAST_POSITION, DS_TOAST_POSITION_DEFAULT, DatePickerComponent, DescriptionItemComponent, DescriptionListComponent, DividerComponent, DrawerComponent, DropzoneComponent, DsChipTemplateDirective, DsCreateTemplateDirective, DsEmptyTemplateDirective, DsOptionTemplateDirective, DsOverlayCloseRef, DsPickerTriggerDirective, DsStaticPreview, EmptyStateComponent, FieldClickFocusDirective, FieldGroupComponent, FilterBarComponent, FilterItemDirective, HeaderFilterDirective, ICONS, IconButtonComponent, IconComponent, InlineComponent, InputComponent, LayoutNavigationService, LayoutScrollService, ListComponent, ListItemComponent, LoadingOverlayComponent, MenuComponent, MenuDividerComponent, MenuItemComponent, ModalCardComponent, ModalComponent, ModalService, MultiSelectComponent, NumberStepperComponent, OtpInputComponent, PageFooterComponent, PageHeaderComponent, PaginationComponent, PasswordRulesComponent, PopoverComponent, ProgressComponent, RADIO_GROUP, RadioComponent, RadioGroupComponent, RailTriggerDirective, ReserveMessagesDirective, SIDENAV, SearchComponent, SegmentedComponent, SelectComponent, SidenavComponent, SidenavFooterComponent, SidenavGroupComponent, SidenavItemComponent, SkeletonComponent, SliderComponent, SpinnerComponent, SplitButtonComponent, StackComponent, StatComponent, StatusDotComponent, StepperComponent, SwitchComponent, TabComponent, TableComponent, TabsComponent, TagComponent, TextareaComponent, TimePickerComponent, TimelineComponent, TimelineItemComponent, ToastComponent, ToastRegionComponent, ToastService, ToggleButtonComponent, TooltipDirective, TooltipPanelComponent, TopBarComponent, TreeComponent, W3wComponent, avatarTint, flattenDsOptions, inheritDsConfig, initialsFrom, isDsOptionGroup, isSelectOptionGroup, passwordRulesMet, provideDsConfig, provideDsIcons, provideDsTheme };
|
|
5308
|
+
export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteItem, AutocompleteOption, AutocompleteOptionGroup, AutocompleteValueOverflow, AutocompleteWidth, AvatarSize, AvatarStatus, AvatarTintOptions, BannerVariant, BreadcrumbItem, ButtonColor, ButtonType, ButtonVariant, CardElevation, CardPadding, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerSpacing, DividerVariant, DrawerPlacement, DropzoneFile, DropzoneFileState, DsConfig, DsControlWidth, DsFieldError, DsFieldErrorsInput, DsFieldGroupContext, DsIconRegistry, DsOption, DsOptionGroup, DsOptionItem, DsPasswordRule, DsPasswordRuleState, DsScrollReset, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, DsTriggerDisplay, EmptyStateVariant, HeaderFilterContext, IconButtonType, IconButtonVariant, IconName, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectItem, MultiSelectOption, MultiSelectOptionGroup, MultiSelectWidth, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, SelectWidth, SidenavAlertItem, SidenavContract, SidenavItemModel, SidenavSearchProvider, SidenavSearchResult, SortChangeEvent, SortDir, SplitButtonItem, SplitButtonVariant, StepperLabelPosition, StepperOrientation, TableCellEditEvent, TableColumn, TableFilterMode, TableRowAction, TableRowActionEvent, TableSortMode, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TimeFormat, TimePickerMode, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };
|