@ids-group-ltd/ids-design-system 0.11.0 → 0.11.2
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 +1368 -1021
- package/components.md +49 -26
- package/design-system.md +18 -18
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +1750 -598
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.10.0.json +19 -19
- package/migrations/0.10.1.json +20 -7
- package/migrations/0.10.2.json +8 -8
- package/migrations/0.10.3.json +2 -2
- package/migrations/0.11.0.json +9 -54
- package/migrations/0.11.1.json +279 -0
- package/migrations/0.11.2.json +158 -0
- package/migrations/0.2.0.json +17 -5
- package/migrations/0.2.2.json +1 -1
- package/migrations/0.3.0.json +1 -1
- package/migrations/0.4.0.json +1 -1
- package/migrations/0.5.1/badge-statuses.md +1 -3
- package/migrations/0.5.1.json +1 -1
- package/migrations/0.6.3.json +1 -1
- package/migrations/0.7.1.json +6 -6
- package/migrations/0.8.0.json +5 -5
- package/migrations/0.9.0.json +12 -11
- package/migrations/0.9.1.json +2 -2
- package/migrations/README.md +34 -52
- package/package.json +1 -1
- package/styles/_dropdown-overlay.scss +64 -23
- 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/_overlay-motion.scss +2 -3
- 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 +5 -4
- package/styles/_typography.scss +2 -2
- package/themes/README.md +6 -6
- 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 +608 -72
|
@@ -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
|
*/
|
|
@@ -308,9 +317,31 @@ interface DsOption<T = string> {
|
|
|
308
317
|
value: T;
|
|
309
318
|
label: string;
|
|
310
319
|
disabled?: boolean;
|
|
320
|
+
/** Why this option cannot be picked. Reaches the row as `aria-describedby`, so a
|
|
321
|
+
* reader hears the reason instead of only meeting a dead row. Ignored unless
|
|
322
|
+
* `disabled` is set. */
|
|
323
|
+
disabledReason?: string;
|
|
311
324
|
/** Rendered before the label at 16px by every picker's option row. */
|
|
312
325
|
icon?: IconName;
|
|
313
326
|
}
|
|
327
|
+
/**
|
|
328
|
+
* A labelled section of options. `disabled` turns the whole section off.
|
|
329
|
+
*/
|
|
330
|
+
interface DsOptionGroup<T = string> {
|
|
331
|
+
label: string;
|
|
332
|
+
options: DsOption<T>[];
|
|
333
|
+
disabled?: boolean;
|
|
334
|
+
}
|
|
335
|
+
/**
|
|
336
|
+
* What a picker's `options` input takes: flat options, groups, or both mixed.
|
|
337
|
+
* One input rather than two, because a second `optionGroups` input can only
|
|
338
|
+
* answer "what if both are set" by silently ignoring one — which is what
|
|
339
|
+
* `ds-autocomplete` used to do.
|
|
340
|
+
*/
|
|
341
|
+
type DsOptionItem<T = string> = DsOption<T> | DsOptionGroup<T>;
|
|
342
|
+
declare function isDsOptionGroup<T>(item: DsOptionItem<T>): item is DsOptionGroup<T>;
|
|
343
|
+
/** Every option in `items`, groups flattened in place, in source order. */
|
|
344
|
+
declare function flattenDsOptions<T>(items: readonly DsOptionItem<T>[]): DsOption<T>[];
|
|
314
345
|
|
|
315
346
|
/** Canonical status vocabulary shared across status-bearing components. */
|
|
316
347
|
type DsStatus = 'info' | 'success' | 'warning' | 'error';
|
|
@@ -319,11 +350,6 @@ type DsStatus = 'info' | 'success' | 'warning' | 'error';
|
|
|
319
350
|
* The DS ships it EMPTY — no statuses are predefined. A consumer registers keys
|
|
320
351
|
* via declaration merging to get autocomplete on the `status` input:
|
|
321
352
|
*
|
|
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
353
|
* declare module '@ids-group-ltd/ids-design-system' {
|
|
328
354
|
* interface DsStatusRegistry { shipped: true; delivered: true; }
|
|
329
355
|
* }
|
|
@@ -337,6 +363,33 @@ interface DsStatusRegistry {
|
|
|
337
363
|
*/
|
|
338
364
|
type DsStatusKey = [keyof DsStatusRegistry] extends [never] ? string : keyof DsStatusRegistry;
|
|
339
365
|
|
|
366
|
+
/**
|
|
367
|
+
* How a control sizes itself and its overlay panel.
|
|
368
|
+
*
|
|
369
|
+
* `fill` stretches to the container and pins the panel to the trigger's width.
|
|
370
|
+
* `content` hugs the trigger and takes that width as the panel's FLOOR, so the
|
|
371
|
+
* panel still grows to its options — without it a short trigger gives a panel
|
|
372
|
+
* too narrow to read.
|
|
373
|
+
*/
|
|
374
|
+
type DsControlWidth = 'fill' | 'content';
|
|
375
|
+
|
|
376
|
+
/**
|
|
377
|
+
* What a picker's trigger shows.
|
|
378
|
+
*
|
|
379
|
+
* `full` is the control's own display — chips, or the selected value.
|
|
380
|
+
*
|
|
381
|
+
* `count` is a caption and a selected-count badge at intrinsic width, for a filter
|
|
382
|
+
* toolbar where a field that grows with the selection does not fit. `labels` is the
|
|
383
|
+
* same footprint but names what is selected instead of counting it, cut to what the
|
|
384
|
+
* trigger is wide enough for, with the rest behind "+N" — the same measurement the
|
|
385
|
+
* chips already use.
|
|
386
|
+
*
|
|
387
|
+
* Only pickers that hold several values offer the other two: a single-value control
|
|
388
|
+
* has nothing to count and nothing to list, and its `full` trigger is already the
|
|
389
|
+
* caption plus the value.
|
|
390
|
+
*/
|
|
391
|
+
type DsTriggerDisplay = 'full' | 'count' | 'labels';
|
|
392
|
+
|
|
340
393
|
declare class IconComponent {
|
|
341
394
|
private readonly sanitizer;
|
|
342
395
|
private readonly registry;
|
|
@@ -485,8 +538,8 @@ declare class ButtonComponent extends DsMessageBase {
|
|
|
485
538
|
/** Brand/status hue family. */
|
|
486
539
|
readonly color: _angular_core.InputSignal<ButtonColor>;
|
|
487
540
|
/** Fill pattern: solid | tonal | ghost | outline | text. All color×variant
|
|
488
|
-
pairs render; some are UX-discouraged
|
|
489
|
-
|
|
541
|
+
pairs render; some are UX-discouraged and emit a dev-mode
|
|
542
|
+
warning naming the reason — they work, but read poorly. `text` is
|
|
490
543
|
discouraged for ALL colours — prefer the global `.link` class; it stays for
|
|
491
544
|
cases needing the ds-button API (loading/fullWidth/typed pressed). */
|
|
492
545
|
readonly variant: _angular_core.InputSignal<ButtonVariant>;
|
|
@@ -928,7 +981,7 @@ declare class BrandNameDirective {
|
|
|
928
981
|
* screens behind the login.
|
|
929
982
|
*
|
|
930
983
|
* Brand row, tagline, card and support footer are the same four parts in every
|
|
931
|
-
* consumer that has hand-rolled this. What
|
|
984
|
+
* consumer that has hand-rolled this. What a hand-rolled version gets wrong is the full-height
|
|
932
985
|
* box: they nest a `100vh` wrapper inside a `100dvh` one and scroll a page whose
|
|
933
986
|
* content fits. Here the host is the only one, and it also carries the safe-area
|
|
934
987
|
* insets a notched phone in landscape needs.
|
|
@@ -958,8 +1011,8 @@ declare class BrandNameDirective {
|
|
|
958
1011
|
declare class AuthLayoutComponent {
|
|
959
1012
|
/** Wordmark beside the letter-mark tile. For a logo image/SVG, project it into
|
|
960
1013
|
* the `[brand]` slot instead; for a two-tone wordmark use `[dsBrandName]`.
|
|
961
|
-
* Unset falls back to `DS_CONFIG.brand.name
|
|
962
|
-
* identically. Each field resolves on its own, so `brand=""` drops the wordmark
|
|
1014
|
+
* Unset falls back to `DS_CONFIG.brand.name`, which every auth screen in an app
|
|
1015
|
+
* answers identically. Each field resolves on its own, so `brand=""` drops the wordmark
|
|
963
1016
|
* but a `logoLetter` in the config still paints its tile; clear both to give one
|
|
964
1017
|
* screen no brand row. */
|
|
965
1018
|
readonly brand: _angular_core.InputSignal<string | null>;
|
|
@@ -983,10 +1036,8 @@ declare class AuthLayoutComponent {
|
|
|
983
1036
|
* content of an auth screen and `ds-card` renders an `<article>`, which is NOT
|
|
984
1037
|
* a landmark, so by default a screen-reader user has nothing to jump to — set
|
|
985
1038
|
* this to `'main'` on a standalone auth page. It is opt-in because the layout
|
|
986
|
-
* is also embedded inside pages that already own a `main
|
|
987
|
-
*
|
|
988
|
-
* Defaulting it to `'main'` is the better end state and belongs in the next
|
|
989
|
-
* batch of default changes. */
|
|
1039
|
+
* is also embedded inside pages that already own a `main`, and two `main`s is its
|
|
1040
|
+
* own violation. */
|
|
990
1041
|
readonly landmark: _angular_core.InputSignal<"none" | "main">;
|
|
991
1042
|
/** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
|
|
992
1043
|
protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
|
|
@@ -1828,12 +1879,10 @@ declare class DsStaticPreview {
|
|
|
1828
1879
|
|
|
1829
1880
|
interface SelectOption extends DsOption<string> {
|
|
1830
1881
|
}
|
|
1831
|
-
|
|
1832
|
-
|
|
1833
|
-
options: SelectOption[];
|
|
1834
|
-
disabled?: boolean;
|
|
1882
|
+
type SelectWidth = DsControlWidth;
|
|
1883
|
+
interface SelectOptionGroup extends DsOptionGroup<string> {
|
|
1835
1884
|
}
|
|
1836
|
-
type SelectItem =
|
|
1885
|
+
type SelectItem = DsOptionItem<string>;
|
|
1837
1886
|
declare function isSelectOptionGroup(item: SelectItem): item is SelectOptionGroup;
|
|
1838
1887
|
|
|
1839
1888
|
declare class SelectComponent extends DsControlValueAccessor<string> implements OnDestroy {
|
|
@@ -1847,7 +1896,15 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1847
1896
|
/** Selected option's value, two-way bound. */
|
|
1848
1897
|
readonly value: _angular_core.ModelSignal<string>;
|
|
1849
1898
|
/** Flat options or option groups rendered in the dropdown panel. */
|
|
1850
|
-
readonly options: _angular_core.InputSignal<SelectItem[]>;
|
|
1899
|
+
readonly options: _angular_core.InputSignal<readonly SelectItem[]>;
|
|
1900
|
+
/** Public panel tokens forwarded onto the portaled overlay pane on open, so a
|
|
1901
|
+
* consumer's `ds-select { --ds-dropdown-panel-*: … }` reaches it. Without this the
|
|
1902
|
+
* tokens can only be set globally: the pane is portaled out of this component. */
|
|
1903
|
+
private readonly panelTokens;
|
|
1904
|
+
/** Trigger width — `fill` stretches to the container and pins the panel to the
|
|
1905
|
+
* trigger's width; `content` hugs the trigger's own content and takes that width
|
|
1906
|
+
* as the panel's FLOOR, so the panel can still grow to its options. */
|
|
1907
|
+
readonly width: _angular_core.InputSignal<_ids_group_ltd_ids_design_system.DsControlWidth>;
|
|
1851
1908
|
/** Shown in the trigger when nothing is selected. */
|
|
1852
1909
|
readonly placeholder: _angular_core.InputSignal<string>;
|
|
1853
1910
|
/** Trigger height — sm/md/lg.
|
|
@@ -1858,6 +1915,19 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1858
1915
|
readonly label: _angular_core.InputSignal<string>;
|
|
1859
1916
|
/** Disables the trigger and blocks all interaction. */
|
|
1860
1917
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1918
|
+
/** Options are still being fetched. The panel shows a spinner instead of the
|
|
1919
|
+
* empty row — which would otherwise claim there are no matches — and the list
|
|
1920
|
+
* reports `aria-busy`. */
|
|
1921
|
+
readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1922
|
+
/** The panel opened. The moment to fetch options for a picker whose list is
|
|
1923
|
+
* loaded on demand. */
|
|
1924
|
+
readonly opened: _angular_core.OutputEmitterRef<void>;
|
|
1925
|
+
/** The panel closed, for any reason — a pick, Escape, an outside click, a scroll. */
|
|
1926
|
+
readonly closed: _angular_core.OutputEmitterRef<void>;
|
|
1927
|
+
/** Scrolls the keyboard cursor's row into view. On by default: a list longer
|
|
1928
|
+
* than the panel otherwise walks the cursor out of sight. Set `false` only if
|
|
1929
|
+
* you are driving the scroll position yourself. */
|
|
1930
|
+
readonly scrollActiveIntoView: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1861
1931
|
/** Prevents opening the dropdown while still allowing focus. */
|
|
1862
1932
|
readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1863
1933
|
/**
|
|
@@ -1879,6 +1949,12 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1879
1949
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
1880
1950
|
/** Shows an inline clear (×) button when a value is selected. */
|
|
1881
1951
|
readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1952
|
+
protected readonly optionTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
1953
|
+
protected readonly pickerTrigger: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
1954
|
+
protected readonly panelHeaderTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
1955
|
+
protected readonly panelFooterTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
1956
|
+
protected readonly groupLabelTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
1957
|
+
protected readonly emptyTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
1882
1958
|
protected readonly uid: string;
|
|
1883
1959
|
protected readonly labelId: string;
|
|
1884
1960
|
protected readonly listboxId: string;
|
|
@@ -1916,15 +1992,35 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1916
1992
|
ngOnDestroy(): void;
|
|
1917
1993
|
protected pick(option: SelectOption, groupDisabled?: boolean): void;
|
|
1918
1994
|
protected clearValue(event: MouseEvent): void;
|
|
1995
|
+
/**
|
|
1996
|
+
* Empties the selection from outside — a "reset filters" button, a form the app
|
|
1997
|
+
* clears itself. `ds-autocomplete` has had this; the other two had only the
|
|
1998
|
+
* in-trigger button, so an app with its own reset had to write the empty value
|
|
1999
|
+
* by hand and guess what "empty" is for this control.
|
|
2000
|
+
*
|
|
2001
|
+
* Deliberately does NOT move focus: the caller may be navigating away, and
|
|
2002
|
+
* stealing focus back into a field they just left is worse than leaving it.
|
|
2003
|
+
*/
|
|
2004
|
+
clear(): void;
|
|
1919
2005
|
protected isSelected(option: SelectOption): boolean;
|
|
1920
2006
|
protected isOptionDisabled(option: SelectOption, groupDisabled?: boolean): boolean;
|
|
1921
2007
|
protected onTriggerKeydown(event: KeyboardEvent): void;
|
|
2008
|
+
private pickActive;
|
|
1922
2009
|
protected isActive(index: number): boolean;
|
|
2010
|
+
private readonly typeAhead;
|
|
2011
|
+
private handleTypeAhead;
|
|
2012
|
+
protected readonly cursorFromKeyboard: _angular_core.WritableSignal<boolean>;
|
|
2013
|
+
private cursorList;
|
|
2014
|
+
/** How far PageUp and PageDown move. Ten rows is the native `<select>` step and
|
|
2015
|
+
* the APG listbox example's — a fixed number rather than a measured screenful,
|
|
2016
|
+
* so the jump is the same wherever the panel happens to be clipped. */
|
|
2017
|
+
private static readonly pageStep;
|
|
1923
2018
|
private moveActive;
|
|
1924
|
-
private
|
|
2019
|
+
private setOpen;
|
|
1925
2020
|
private lastEnabledIndex;
|
|
2021
|
+
private firstEnabledIndex;
|
|
1926
2022
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
|
|
1927
|
-
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"; },
|
|
2023
|
+
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; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "scrollActiveIntoView": { "alias": "scrollActiveIntoView"; "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"; "opened": "opened"; "closed": "closed"; }, ["optionTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate"], never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
|
|
1928
2024
|
}
|
|
1929
2025
|
|
|
1930
2026
|
/**
|
|
@@ -2000,18 +2096,6 @@ declare class HeaderFilterDirective {
|
|
|
2000
2096
|
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<HeaderFilterDirective, "ng-template[dsHeaderFilter]", never, { "dsHeaderFilter": { "alias": "dsHeaderFilter"; "required": true; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
2001
2097
|
}
|
|
2002
2098
|
|
|
2003
|
-
/**
|
|
2004
|
-
* Who sorts a `ds-table`.
|
|
2005
|
-
*
|
|
2006
|
-
* - `'server'` (default) — the table only emits `sortChange`; the host reorders.
|
|
2007
|
-
* - `'client'` — the table reorders `data()` itself, for a table holding every row.
|
|
2008
|
-
* - `'none'` — nothing sorts, and `sortable` columns render no affordance rather
|
|
2009
|
-
* than a control that does nothing.
|
|
2010
|
-
*
|
|
2011
|
-
* Replaces the boolean `clientSort`, which could not express `'none'`: a column
|
|
2012
|
-
* marked `sortable` on a table with no sorting drew a live-looking header that
|
|
2013
|
-
* did nothing, and no type or dev check could catch it.
|
|
2014
|
-
*/
|
|
2015
2099
|
/**
|
|
2016
2100
|
* Who applies the header filters.
|
|
2017
2101
|
*
|
|
@@ -2024,7 +2108,22 @@ declare class HeaderFilterDirective {
|
|
|
2024
2108
|
* control that does nothing.
|
|
2025
2109
|
*/
|
|
2026
2110
|
type TableFilterMode = 'client' | 'server' | 'none';
|
|
2111
|
+
/**
|
|
2112
|
+
* Who sorts a `ds-table`.
|
|
2113
|
+
*
|
|
2114
|
+
* - `'server'` (default) — the table only emits `sortChange`; the host reorders.
|
|
2115
|
+
* - `'client'` — the table reorders `data()` itself, for a table holding every row.
|
|
2116
|
+
* - `'none'` — nothing sorts, and `sortable` columns render no affordance rather
|
|
2117
|
+
* than a control that does nothing.
|
|
2118
|
+
*
|
|
2119
|
+
* Replaces the boolean `clientSort`, which could not express `'none'`: a column
|
|
2120
|
+
* marked `sortable` on a table with no sorting drew a live-looking header that
|
|
2121
|
+
* did nothing, and no type or dev check could catch it.
|
|
2122
|
+
*/
|
|
2027
2123
|
type TableSortMode = 'client' | 'server' | 'none';
|
|
2124
|
+
/** `'single'` closes the open row when another is expanded; `'multiple'` (default)
|
|
2125
|
+
* leaves every expanded row open. */
|
|
2126
|
+
type TableExpandMode = 'multiple' | 'single';
|
|
2028
2127
|
|
|
2029
2128
|
interface TableColumn<T = unknown> {
|
|
2030
2129
|
key: string;
|
|
@@ -2146,7 +2245,7 @@ declare class TableComponent<T extends object> {
|
|
|
2146
2245
|
/** Adds a checkbox column for row/select-all selection. */
|
|
2147
2246
|
readonly selectable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2148
2247
|
/** Opt-in outer border + radius. Off by default so tables flush inside a
|
|
2149
|
-
* `<ds-card padding="none">`
|
|
2248
|
+
* `<ds-card padding="none">` don't double-border.
|
|
2150
2249
|
* When `true`, the scroll-wrap gets a `var(--border-default)` outline and
|
|
2151
2250
|
* `var(--radius-md)` radius — useful when the table stands alone in a padded card.
|
|
2152
2251
|
* Unset falls back to `DS_CONFIG.table.bordered`, then `false`. */
|
|
@@ -2394,6 +2493,23 @@ declare class TableComponent<T extends object> {
|
|
|
2394
2493
|
readonly expandableRows: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2395
2494
|
/** Two-way set of currently expanded row ids. */
|
|
2396
2495
|
readonly expandedIds: _angular_core.ModelSignal<Set<string>>;
|
|
2496
|
+
/** `'single'` collapses the open row when another expander is clicked.
|
|
2497
|
+
* Enforced on interaction only: a set seeded with several ids is left alone
|
|
2498
|
+
* (and warned about in dev) rather than silently rewritten under the host. */
|
|
2499
|
+
readonly expandMode: _angular_core.InputSignal<TableExpandMode>;
|
|
2500
|
+
/** Renders an expand-all/collapse-all chevron in the expander column header,
|
|
2501
|
+
* page-scoped when paginating, like select-all. Suppressed under
|
|
2502
|
+
* `expandMode="single"`, which it would contradict. */
|
|
2503
|
+
readonly expandAllToggle: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2504
|
+
/** Fires with the row when an expander opens it — including each row opened
|
|
2505
|
+
* by expand-all, so a host lazy-loading panel content sees every one. */
|
|
2506
|
+
readonly rowExpanded: _angular_core.OutputEmitterRef<T>;
|
|
2507
|
+
/** Fires with the row when an expander closes it, the row auto-closed by
|
|
2508
|
+
* `expandMode="single"` included. It carries a row, so it cannot speak for an
|
|
2509
|
+
* id whose row is no longer in `data()` — under server-side paging that id is
|
|
2510
|
+
* cleared silently. `expandedIds` is the complete signal; this one is the
|
|
2511
|
+
* convenient one. */
|
|
2512
|
+
readonly rowCollapsed: _angular_core.OutputEmitterRef<T>;
|
|
2397
2513
|
/** Template rendered inside an expanded row's panel.
|
|
2398
2514
|
* Context: `$implicit` = row, `row` = row. */
|
|
2399
2515
|
readonly rowExpandTemplate: _angular_core.InputSignal<TemplateRef<{
|
|
@@ -2466,6 +2582,7 @@ declare class TableComponent<T extends object> {
|
|
|
2466
2582
|
};
|
|
2467
2583
|
protected clearColumnFilter(): void;
|
|
2468
2584
|
private readonly injector;
|
|
2585
|
+
private readonly destroyRef;
|
|
2469
2586
|
private readonly editInput;
|
|
2470
2587
|
protected readonly editingCell: _angular_core.WritableSignal<{
|
|
2471
2588
|
rowId: string;
|
|
@@ -2509,9 +2626,38 @@ declare class TableComponent<T extends object> {
|
|
|
2509
2626
|
private lockMeasuredWidths;
|
|
2510
2627
|
protected onResizeMove(event: PointerEvent): void;
|
|
2511
2628
|
protected onResizeEnd(): void;
|
|
2512
|
-
|
|
2513
|
-
|
|
2514
|
-
*
|
|
2629
|
+
private readonly resizeFocus;
|
|
2630
|
+
/**
|
|
2631
|
+
* The widest a single column may be dragged: the scroll viewport.
|
|
2632
|
+
*
|
|
2633
|
+
* A column wider than the viewport can never be seen whole, and long text has
|
|
2634
|
+
* its own affordance here — `truncate` clips it and the clip popover shows the
|
|
2635
|
+
* rest — so nothing is lost by stopping at the edge. The ceiling exists at all
|
|
2636
|
+
* because `aria-valuemax` has to be TRUE: a focusable `role="separator"` is a
|
|
2637
|
+
* range widget, and announcing a bound that neither resize path applies is
|
|
2638
|
+
* worse than announcing none.
|
|
2639
|
+
*/
|
|
2640
|
+
private columnWidthCeiling;
|
|
2641
|
+
private clampColumnWidth;
|
|
2642
|
+
protected onResizeFocus(col: TableColumn<T>, event: FocusEvent): void;
|
|
2643
|
+
protected onResizeBlur(): void;
|
|
2644
|
+
/**
|
|
2645
|
+
* The separator's range, and only while it holds focus — that is when a range
|
|
2646
|
+
* widget is announced, and an auto-sized column has no width to report until
|
|
2647
|
+
* something measures one. Measuring on every change detection to fill an
|
|
2648
|
+
* attribute nothing is reading would force layout once per resizable column.
|
|
2649
|
+
*
|
|
2650
|
+
* `now` prefers `columnWidth`, which the first arrow key makes known and keeps
|
|
2651
|
+
* live; the focus measurement only covers the moment before that.
|
|
2652
|
+
*/
|
|
2653
|
+
protected resizeRange(col: TableColumn<T>): {
|
|
2654
|
+
now: number;
|
|
2655
|
+
min: number;
|
|
2656
|
+
max: number;
|
|
2657
|
+
} | null;
|
|
2658
|
+
/** Current rendered width for the keyboard resize path. Falls back to the DOM
|
|
2659
|
+
* when the column was auto-sized and has neither an override nor a declared
|
|
2660
|
+
* width. */
|
|
2515
2661
|
protected resolvedColumnWidth(col: TableColumn<T>, from?: HTMLElement): number;
|
|
2516
2662
|
/**
|
|
2517
2663
|
* Keyboard resizing. A drag handle that only answers to a pointer makes a
|
|
@@ -2520,6 +2666,19 @@ declare class TableComponent<T extends object> {
|
|
|
2520
2666
|
* ones and Home to hand the column back to automatic sizing.
|
|
2521
2667
|
*/
|
|
2522
2668
|
protected onResizeKey(col: TableColumn<T>, event: KeyboardEvent): void;
|
|
2669
|
+
/**
|
|
2670
|
+
* One column-width step, from wherever it was asked for: the handle's own
|
|
2671
|
+
* keyboard, or the width controls in the column panel.
|
|
2672
|
+
*
|
|
2673
|
+
* `'auto'` hands the column back to automatic sizing. The header cell is
|
|
2674
|
+
* passed when the caller has it — the panel does not, so it is looked up by
|
|
2675
|
+
* `data-col-key`, and the measurement matters: stepping an auto-sized column
|
|
2676
|
+
* has to start from what it currently RENDERS, not from the minimum.
|
|
2677
|
+
*/
|
|
2678
|
+
private stepColumnWidth;
|
|
2679
|
+
private headerCellFor;
|
|
2680
|
+
protected onColumnWidthStep(col: TableColumn<T>, delta: number | 'auto'): void;
|
|
2681
|
+
protected readonly resizeStep = 16;
|
|
2523
2682
|
/** Client-side filter over the full data set — combines the `filterQuery`
|
|
2524
2683
|
* substring search with any per-column set filters. Sorting and pagination
|
|
2525
2684
|
* run on the filtered rows. */
|
|
@@ -2528,7 +2687,8 @@ declare class TableComponent<T extends object> {
|
|
|
2528
2687
|
protected readonly sortedData: _angular_core.Signal<readonly T[]>;
|
|
2529
2688
|
/** Current page's slice of the sorted rows, when paginating. */
|
|
2530
2689
|
protected readonly pagedData: _angular_core.Signal<readonly T[]>;
|
|
2531
|
-
/**
|
|
2690
|
+
/** The full display set — paged when paginating, else sorted/raw data.
|
|
2691
|
+
* Virtual mode windows this further; `rowSlots` is what the loop walks. */
|
|
2532
2692
|
protected readonly displayData: _angular_core.Signal<readonly T[]>;
|
|
2533
2693
|
/**
|
|
2534
2694
|
* The single live-region line. Loading wins while it lasts — a sort
|
|
@@ -2541,6 +2701,9 @@ declare class TableComponent<T extends object> {
|
|
|
2541
2701
|
* unsorted first render is silent; only real changes speak.
|
|
2542
2702
|
*/
|
|
2543
2703
|
protected readonly statusMessage: _angular_core.Signal<string>;
|
|
2704
|
+
/** Only from two rows up: a single expander announces itself through its own
|
|
2705
|
+
* `aria-expanded`, and repeating that here would say everything twice. */
|
|
2706
|
+
private readonly expansionMessage;
|
|
2544
2707
|
private readonly sortMessage;
|
|
2545
2708
|
private readonly rangeMessage;
|
|
2546
2709
|
/** Virtual mode needs a bounded scroller to window against. */
|
|
@@ -2559,8 +2722,6 @@ declare class TableComponent<T extends object> {
|
|
|
2559
2722
|
padTop: number;
|
|
2560
2723
|
padBottom: number;
|
|
2561
2724
|
} | null>;
|
|
2562
|
-
/** The rows the template actually renders. */
|
|
2563
|
-
protected readonly windowData: _angular_core.Signal<readonly T[]>;
|
|
2564
2725
|
/**
|
|
2565
2726
|
* What the row loop walks: each slot carries its ABSOLUTE index, and a `null`
|
|
2566
2727
|
* row is a gap the host has not filled yet.
|
|
@@ -2582,14 +2743,23 @@ declare class TableComponent<T extends object> {
|
|
|
2582
2743
|
protected readonly someSelected: _angular_core.Signal<boolean>;
|
|
2583
2744
|
/** Select-all is page-scoped only when paginating. */
|
|
2584
2745
|
protected readonly selectAllLabel: _angular_core.Signal<"Select all rows on this page" | "Select all rows">;
|
|
2746
|
+
protected readonly allExpanded: _angular_core.Signal<boolean>;
|
|
2747
|
+
protected readonly expandAllVisible: _angular_core.Signal<boolean>;
|
|
2748
|
+
protected readonly expandAllLabel: _angular_core.Signal<string>;
|
|
2585
2749
|
protected readonly skeletonArray: _angular_core.Signal<any[]>;
|
|
2586
|
-
/**
|
|
2750
|
+
/** Colspan of a full-width row (expansion panel, empty state): data cols +
|
|
2751
|
+
* optional select/expand/actions cols. */
|
|
2587
2752
|
protected readonly expandedColspan: _angular_core.Signal<number>;
|
|
2588
2753
|
protected readonly hasRowActions: _angular_core.Signal<boolean>;
|
|
2589
2754
|
/** Row whose kebab menu is open — drives the per-row `disabled` predicates. */
|
|
2590
2755
|
protected readonly menuRow: _angular_core.WritableSignal<T | null>;
|
|
2591
2756
|
private readonly rowMenuPopover;
|
|
2592
2757
|
private readonly columnPickerPopover;
|
|
2758
|
+
protected readonly columnSheetOpen: _angular_core.WritableSignal<boolean>;
|
|
2759
|
+
private readonly coarsePointerState;
|
|
2760
|
+
/** Whether the column panel opens as a sheet and the drag handle stands down.
|
|
2761
|
+
* Keyed on the pointer, not the viewport — see `_table.scss`'s matching query. */
|
|
2762
|
+
protected readonly coarsePointer: _angular_core.Signal<boolean>;
|
|
2593
2763
|
protected readonly columnPickerOpened: _angular_core.Signal<boolean>;
|
|
2594
2764
|
protected onColumnPickerClick(event: Event): void;
|
|
2595
2765
|
protected readonly hasTruncate: _angular_core.Signal<boolean>;
|
|
@@ -2631,6 +2801,7 @@ declare class TableComponent<T extends object> {
|
|
|
2631
2801
|
protected onRowAction(action: TableRowAction<T>): void;
|
|
2632
2802
|
protected isExpanded(row: T): boolean;
|
|
2633
2803
|
protected onToggleExpand(row: T, event: Event): void;
|
|
2804
|
+
protected onToggleExpandAll(): void;
|
|
2634
2805
|
protected isSelected(row: T): boolean;
|
|
2635
2806
|
protected onToggleAll(event: Event): void;
|
|
2636
2807
|
protected onToggleRow(row: T, event: Event): void;
|
|
@@ -2640,12 +2811,12 @@ declare class TableComponent<T extends object> {
|
|
|
2640
2811
|
protected onRowKey(row: T, event: Event): void;
|
|
2641
2812
|
/** Accessible name for an interactive row, taken from the first visible column. */
|
|
2642
2813
|
protected rowAriaLabel(row: T): string;
|
|
2643
|
-
/** `aria-sort` value for a header: only meaningful on sortable columns. */
|
|
2644
2814
|
/** Row identity — the `rowId` accessor when given, else `row.id`. Public so a
|
|
2645
2815
|
* host reading `selectedIds`/`expandedIds` can compute the same keys. */
|
|
2646
2816
|
rowKey(row: T): string;
|
|
2647
2817
|
/** Whether this column's header is an actual sort control right now. */
|
|
2648
2818
|
protected sortableCol(col: TableColumn<T>): boolean;
|
|
2819
|
+
/** `aria-sort` value for a header: only meaningful on sortable columns. */
|
|
2649
2820
|
protected ariaSort(col: TableColumn<T>): 'ascending' | 'descending' | 'none' | null;
|
|
2650
2821
|
protected onSort(col: TableColumn<T>): void;
|
|
2651
2822
|
protected headerClasses(col: TableColumn<T>): string;
|
|
@@ -2673,8 +2844,9 @@ declare class TableComponent<T extends object> {
|
|
|
2673
2844
|
/** Deterministic per-cell width so skeleton rows look organic but stable
|
|
2674
2845
|
* across re-renders. Mixes column key + row index into one of five widths. */
|
|
2675
2846
|
protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
|
|
2847
|
+
private watchPointer;
|
|
2676
2848
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
|
|
2677
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "animateHeight": { "alias": "animateHeight"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDir": { "alias": "sortDir"; "required": false; "isSignal": true; }; "sortingOrder": { "alias": "sortingOrder"; "required": false; "isSignal": true; }; "sortAnnouncement": { "alias": "sortAnnouncement"; "required": false; "isSignal": true; }; "rangeAnnouncement": { "alias": "rangeAnnouncement"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "activeRowId": { "alias": "activeRowId"; "required": false; "isSignal": true; }; "filterQuery": { "alias": "filterQuery"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "hiddenKeys": { "alias": "hiddenKeys"; "required": false; "isSignal": true; }; "resizableColumns": { "alias": "resizableColumns"; "required": false; "isSignal": true; }; "columnWidths": { "alias": "columnWidths"; "required": false; "isSignal": true; }; "reorderableColumns": { "alias": "reorderableColumns"; "required": false; "isSignal": true; }; "columnOrder": { "alias": "columnOrder"; "required": false; "isSignal": true; }; "persistLayout": { "alias": "persistLayout"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "exportButton": { "alias": "exportButton"; "required": false; "isSignal": true; }; "exportFilename": { "alias": "exportFilename"; "required": false; "isSignal": true; }; "exportFetcher": { "alias": "exportFetcher"; "required": false; "isSignal": true; }; "stickyScrollbar": { "alias": "stickyScrollbar"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "sortMode": { "alias": "sortMode"; "required": false; "isSignal": true; }; "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "columnFilterOptions": { "alias": "columnFilterOptions"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualRowSize": { "alias": "virtualRowSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKeyChange": "sortKeyChange"; "sortDirChange": "sortDirChange"; "columnFilters": "columnFiltersChange"; "hiddenKeys": "hiddenKeysChange"; "columnWidths": "columnWidthsChange"; "columnOrder": "columnOrderChange"; "exportFailed": "exportFailed"; "pageSize": "pageSizeChange"; "page": "pageChange"; "lazyLoad": "lazyLoad"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; }, ["cellTemplateDirectives", "headerFilters"], ["[toolbar]", "[empty]", "[bulk-actions]"], true, never>;
|
|
2849
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "animateHeight": { "alias": "animateHeight"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDir": { "alias": "sortDir"; "required": false; "isSignal": true; }; "sortingOrder": { "alias": "sortingOrder"; "required": false; "isSignal": true; }; "sortAnnouncement": { "alias": "sortAnnouncement"; "required": false; "isSignal": true; }; "rangeAnnouncement": { "alias": "rangeAnnouncement"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "activeRowId": { "alias": "activeRowId"; "required": false; "isSignal": true; }; "filterQuery": { "alias": "filterQuery"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "hiddenKeys": { "alias": "hiddenKeys"; "required": false; "isSignal": true; }; "resizableColumns": { "alias": "resizableColumns"; "required": false; "isSignal": true; }; "columnWidths": { "alias": "columnWidths"; "required": false; "isSignal": true; }; "reorderableColumns": { "alias": "reorderableColumns"; "required": false; "isSignal": true; }; "columnOrder": { "alias": "columnOrder"; "required": false; "isSignal": true; }; "persistLayout": { "alias": "persistLayout"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "exportButton": { "alias": "exportButton"; "required": false; "isSignal": true; }; "exportFilename": { "alias": "exportFilename"; "required": false; "isSignal": true; }; "exportFetcher": { "alias": "exportFetcher"; "required": false; "isSignal": true; }; "stickyScrollbar": { "alias": "stickyScrollbar"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "sortMode": { "alias": "sortMode"; "required": false; "isSignal": true; }; "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "columnFilterOptions": { "alias": "columnFilterOptions"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualRowSize": { "alias": "virtualRowSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "expandMode": { "alias": "expandMode"; "required": false; "isSignal": true; }; "expandAllToggle": { "alias": "expandAllToggle"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKeyChange": "sortKeyChange"; "sortDirChange": "sortDirChange"; "columnFilters": "columnFiltersChange"; "hiddenKeys": "hiddenKeysChange"; "columnWidths": "columnWidthsChange"; "columnOrder": "columnOrderChange"; "exportFailed": "exportFailed"; "pageSize": "pageSizeChange"; "page": "pageChange"; "lazyLoad": "lazyLoad"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; "rowExpanded": "rowExpanded"; "rowCollapsed": "rowCollapsed"; }, ["cellTemplateDirectives", "headerFilters"], ["[toolbar]", "[empty]", "[bulk-actions]"], true, never>;
|
|
2678
2850
|
}
|
|
2679
2851
|
|
|
2680
2852
|
declare class PaginationComponent {
|
|
@@ -3181,7 +3353,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
|
|
|
3181
3353
|
protected readonly columns: _angular_core.Signal<TimeColumnsComponent | undefined>;
|
|
3182
3354
|
/** Any of the three trigger boxes, not the host: a range renders two and a single
|
|
3183
3355
|
* one renders one, while the host also carries the label and the message row —
|
|
3184
|
-
* clicking those has to dismiss the panel
|
|
3356
|
+
* clicking those has to dismiss the panel. */
|
|
3185
3357
|
private insideATrigger;
|
|
3186
3358
|
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
3187
3359
|
protected readonly hintId: _angular_core.Signal<string | null>;
|
|
@@ -3408,7 +3580,7 @@ interface SidenavAlertItem {
|
|
|
3408
3580
|
* A single global-search hit rendered in the sidenav Search popover. The footer
|
|
3409
3581
|
* stays domain-agnostic: the layout supplies a {@link SidenavSearchProvider} that maps
|
|
3410
3582
|
* a query string to these results, so the footer never needs to know about the
|
|
3411
|
-
*
|
|
3583
|
+
* app's sections or entities.
|
|
3412
3584
|
*/
|
|
3413
3585
|
interface SidenavSearchResult {
|
|
3414
3586
|
readonly id: string;
|
|
@@ -4006,6 +4178,10 @@ interface ToastEntry {
|
|
|
4006
4178
|
readonly variant: ToastVariant;
|
|
4007
4179
|
readonly dismissible: boolean;
|
|
4008
4180
|
readonly action?: ToastAction;
|
|
4181
|
+
/** Auto-dismiss delay, counted from the moment the toast becomes VISIBLE — a
|
|
4182
|
+
* queued toast must not expire while it is still waiting behind the cap.
|
|
4183
|
+
* 0 = indefinite. */
|
|
4184
|
+
readonly durationMs: number;
|
|
4009
4185
|
}
|
|
4010
4186
|
interface ToastPromiseMessages {
|
|
4011
4187
|
readonly loading: string;
|
|
@@ -4045,7 +4221,16 @@ declare class ToastRegionComponent {
|
|
|
4045
4221
|
protected readonly visibleEntries: _angular_core.WritableSignal<readonly ToastEntry[]>;
|
|
4046
4222
|
protected readonly leaving: _angular_core.WritableSignal<ReadonlySet<number>>;
|
|
4047
4223
|
private readonly pendingQueue;
|
|
4224
|
+
private readonly timers;
|
|
4225
|
+
private readonly position;
|
|
4226
|
+
/** Newest goes NEAREST the anchor, so the toast that just fired appears where the
|
|
4227
|
+
* stack is pinned rather than at the far end of a list the reader has to hunt
|
|
4228
|
+
* down. DOM order is the visual order, so this also keeps the reading order. */
|
|
4229
|
+
private readonly newestFirst;
|
|
4048
4230
|
add(entry: ToastEntry): void;
|
|
4231
|
+
private show;
|
|
4232
|
+
private startCountdown;
|
|
4233
|
+
private clearCountdown;
|
|
4049
4234
|
/** Replace fields of an already-visible or queued toast in place. */
|
|
4050
4235
|
update(id: number, patch: Partial<Pick<ToastEntry, 'body' | 'title' | 'variant' | 'dismissible' | 'action'>>): void;
|
|
4051
4236
|
remove(id: number): void;
|
|
@@ -4230,14 +4415,15 @@ declare class PageFooterComponent {
|
|
|
4230
4415
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<PageFooterComponent, "ds-page-footer", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["[brand]", "[nav]", "[actions]", "*"], true, never>;
|
|
4231
4416
|
}
|
|
4232
4417
|
|
|
4233
|
-
/** `
|
|
4234
|
-
type AutocompleteWidth =
|
|
4418
|
+
/** `content` here also reserves a minimum typing area beside the chips. */
|
|
4419
|
+
type AutocompleteWidth = DsControlWidth;
|
|
4420
|
+
/** What a settled single value does when it outgrows the trigger. */
|
|
4421
|
+
type AutocompleteValueOverflow = 'ellipsis' | 'wrap';
|
|
4235
4422
|
interface AutocompleteOption<T = unknown> extends DsOption<T> {
|
|
4236
4423
|
}
|
|
4237
|
-
interface AutocompleteOptionGroup<T = unknown> {
|
|
4238
|
-
readonly label: string;
|
|
4239
|
-
readonly options: AutocompleteOption<T>[];
|
|
4424
|
+
interface AutocompleteOptionGroup<T = unknown> extends DsOptionGroup<T> {
|
|
4240
4425
|
}
|
|
4426
|
+
type AutocompleteItem<T = unknown> = DsOptionItem<T>;
|
|
4241
4427
|
|
|
4242
4428
|
declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<T | readonly T[] | null> implements OnDestroy {
|
|
4243
4429
|
/** Segment of a ds-field-group: the group owns the border, radius and focus
|
|
@@ -4249,10 +4435,8 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4249
4435
|
/** Public panel tokens forwarded onto the portaled overlay pane on open so
|
|
4250
4436
|
* a consumer's `ds-autocomplete { --ds-autocomplete-panel-*: … }` reaches it. */
|
|
4251
4437
|
private readonly panelTokens;
|
|
4252
|
-
/**
|
|
4253
|
-
readonly options: _angular_core.InputSignal<readonly
|
|
4254
|
-
/** Options grouped under labelled sections, rendered instead of `options`. */
|
|
4255
|
-
readonly optionGroups: _angular_core.InputSignal<AutocompleteOptionGroup<T>[]>;
|
|
4438
|
+
/** Options, groups, or both mixed — rendered in the order given. */
|
|
4439
|
+
readonly options: _angular_core.InputSignal<readonly AutocompleteItem<T>[]>;
|
|
4256
4440
|
/** Selected value, or an array of values when `multiple`. */
|
|
4257
4441
|
readonly value: _angular_core.ModelSignal<T | readonly T[] | null>;
|
|
4258
4442
|
/** Allows selecting more than one option, shown as removable tags. */
|
|
@@ -4275,7 +4459,12 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4275
4459
|
readonly size: _angular_core.InputSignal<DsSize | null>;
|
|
4276
4460
|
readonly sizeResolved: _angular_core.Signal<DsSize>;
|
|
4277
4461
|
/** Trigger width — `fill` stretches to the container, `content` hugs the value. */
|
|
4278
|
-
readonly width: _angular_core.InputSignal<
|
|
4462
|
+
readonly width: _angular_core.InputSignal<_ids_group_ltd_ids_design_system.DsControlWidth>;
|
|
4463
|
+
/** What a settled single value does when it is wider than the trigger. Defaults
|
|
4464
|
+
* to `ellipsis`; `wrap` restores the pre-0.12 behaviour, where the value broke
|
|
4465
|
+
* onto a second line and pushed the chevron onto a third. Multi mode is
|
|
4466
|
+
* unaffected — its chips have their own measured cap. */
|
|
4467
|
+
readonly valueOverflow: _angular_core.InputSignal<AutocompleteValueOverflow>;
|
|
4279
4468
|
/** Placeholder shown in the input when empty. */
|
|
4280
4469
|
readonly placeholder: _angular_core.InputSignal<string>;
|
|
4281
4470
|
/** Disables the trigger and blocks all interaction. */
|
|
@@ -4285,6 +4474,57 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4285
4474
|
readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
|
|
4286
4475
|
/** Shows a "Create «text»" row when the typed text matches no option. */
|
|
4287
4476
|
readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4477
|
+
/** Field label above the control — the same meaning it has on the other two pickers. */
|
|
4478
|
+
readonly label: _angular_core.InputSignal<string>;
|
|
4479
|
+
/** How two values are decided to be the same one. The default is `===`, which
|
|
4480
|
+
* is reference identity — so with object values a re-fetch that returns equal
|
|
4481
|
+
* data as NEW objects loses the selection. Pass a comparator keyed on whatever
|
|
4482
|
+
* identifies the value: `(a, b) => a?.id === b?.id`. */
|
|
4483
|
+
readonly compareWith: _angular_core.InputSignal<(a: T | null, b: T | null) => boolean>;
|
|
4484
|
+
/** Native `name` attribute forwarded to the trigger. */
|
|
4485
|
+
readonly name: _angular_core.InputSignal<string | null>;
|
|
4486
|
+
/** Prevents opening the panel while still allowing focus. */
|
|
4487
|
+
readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4488
|
+
/**
|
|
4489
|
+
* The contract spelling of `readOnly`, a second input because signal forms binds
|
|
4490
|
+
* by NAME — a `readonly()` rule was reaching nothing before this existed.
|
|
4491
|
+
*/
|
|
4492
|
+
readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4493
|
+
/** Shows a clear affordance once there is something to clear. */
|
|
4494
|
+
readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4495
|
+
/** Placeholder while the field is being typed in, when a value is already
|
|
4496
|
+
* settled — `placeholder` is the empty-field caption and cannot be both.
|
|
4497
|
+
* Empty (the default) keeps `placeholder` doing both jobs, as before. */
|
|
4498
|
+
readonly searchPlaceholder: _angular_core.InputSignal<string>;
|
|
4499
|
+
/** How the typed query narrows the list.
|
|
4500
|
+
*
|
|
4501
|
+
* The default matches a case-insensitive substring of `label`. Pass a predicate
|
|
4502
|
+
* to match on anything else — a second field, ignoring diacritics, a fuzzy score.
|
|
4503
|
+
* Pass `'none'` when the list arrives already filtered, which is what a
|
|
4504
|
+
* server-side search needs: the query is reported through `filterChange` and
|
|
4505
|
+
* every option given is rendered.
|
|
4506
|
+
*/
|
|
4507
|
+
readonly filterWith: _angular_core.InputSignal<"none" | ((option: AutocompleteOption<T>, query: string) => boolean)>;
|
|
4508
|
+
/** The query the user typed, on every change. The input for a server-side search;
|
|
4509
|
+
* pair it with `filterWith="none"` so the list is not narrowed twice. */
|
|
4510
|
+
readonly filterChange: _angular_core.OutputEmitterRef<string>;
|
|
4511
|
+
/** Options are still being fetched. The panel shows a spinner instead of the
|
|
4512
|
+
* empty row — which would otherwise claim there are no matches — and the list
|
|
4513
|
+
* reports `aria-busy`. */
|
|
4514
|
+
readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4515
|
+
/** The panel opened. The moment to fetch options for a picker whose list is
|
|
4516
|
+
* loaded on demand. */
|
|
4517
|
+
readonly opened: _angular_core.OutputEmitterRef<void>;
|
|
4518
|
+
/** The panel closed, for any reason — a pick, Escape, an outside click, a scroll. */
|
|
4519
|
+
readonly closed: _angular_core.OutputEmitterRef<void>;
|
|
4520
|
+
/** Scrolls the keyboard cursor's row into view. On by default: a list longer
|
|
4521
|
+
* than the panel otherwise walks the cursor out of sight. Set `false` only if
|
|
4522
|
+
* you are driving the scroll position yourself. */
|
|
4523
|
+
readonly scrollActiveIntoView: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4524
|
+
/** Marks the field required: a `*` beside the label and `aria-required` on the input. */
|
|
4525
|
+
readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4526
|
+
/** Marks the field optional in words, for a form where most fields are required. */
|
|
4527
|
+
readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4288
4528
|
/** Accessible name for the input. */
|
|
4289
4529
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
4290
4530
|
/** Fires with the typed text when the user picks the create-new option. */
|
|
@@ -4295,6 +4535,14 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4295
4535
|
protected readonly message: _angular_core.Signal<DsFieldMessage>;
|
|
4296
4536
|
protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
|
|
4297
4537
|
protected readonly invalidResolved: _angular_core.Signal<boolean>;
|
|
4538
|
+
protected readonly optionTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4539
|
+
protected readonly chipTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4540
|
+
protected readonly pickerTrigger: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4541
|
+
protected readonly panelHeaderTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4542
|
+
protected readonly panelFooterTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4543
|
+
protected readonly groupLabelTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4544
|
+
protected readonly emptyTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4545
|
+
protected readonly createTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4298
4546
|
protected readonly query: _angular_core.WritableSignal<string>;
|
|
4299
4547
|
protected readonly isOpen: _angular_core.WritableSignal<boolean>;
|
|
4300
4548
|
protected readonly activeIndex: _angular_core.WritableSignal<number>;
|
|
@@ -4305,17 +4553,20 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4305
4553
|
private overlayRef;
|
|
4306
4554
|
protected readonly uid: string;
|
|
4307
4555
|
protected readonly listboxId: string;
|
|
4556
|
+
protected readonly labelId: string;
|
|
4308
4557
|
protected optionId(index: number): string;
|
|
4309
4558
|
protected readonly activeDescendant: _angular_core.Signal<string | null>;
|
|
4310
|
-
/** All options flattened from either optionGroups or options. */
|
|
4311
4559
|
protected readonly allOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
|
|
4560
|
+
protected readonly filteredItems: _angular_core.Signal<AutocompleteItem<T>[]>;
|
|
4312
4561
|
protected readonly filteredOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
|
|
4313
|
-
|
|
4314
|
-
protected readonly filteredGroups: _angular_core.Signal<AutocompleteOptionGroup<T>[]>;
|
|
4562
|
+
protected isGroup(item: AutocompleteItem<T>): item is AutocompleteOptionGroup<T>;
|
|
4315
4563
|
/** Whether to show the "Create «text»" row at the bottom of the panel. */
|
|
4316
4564
|
protected readonly showCreateRow: _angular_core.Signal<boolean>;
|
|
4317
4565
|
/** Flat list of visible options used for keyboard navigation index. */
|
|
4318
4566
|
protected readonly visibleOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
|
|
4567
|
+
/** The visible label wins the accessible name when there is one — otherwise the
|
|
4568
|
+
* placeholder would announce over it, and `placeholder` always carries a default. */
|
|
4569
|
+
protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
|
|
4319
4570
|
protected readonly selectedTags: _angular_core.Signal<AutocompleteOption<T>[]>;
|
|
4320
4571
|
private readonly chipsMode;
|
|
4321
4572
|
private readonly showsEveryChip;
|
|
@@ -4334,7 +4585,10 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4334
4585
|
* list it reads would silently make it remove the last VISIBLE one instead. */
|
|
4335
4586
|
protected readonly visibleTags: _angular_core.Signal<AutocompleteOption<T>[]>;
|
|
4336
4587
|
protected readonly overflowCount: _angular_core.Signal<number>;
|
|
4588
|
+
protected readonly selectedOption: _angular_core.Signal<AutocompleteOption<T> | null>;
|
|
4337
4589
|
protected readonly displayLabel: _angular_core.Signal<string>;
|
|
4590
|
+
protected readonly hasSingleValue: _angular_core.Signal<boolean>;
|
|
4591
|
+
protected readonly triggerSelection: _angular_core.Signal<AutocompleteOption<T> | AutocompleteOption<T>[] | null>;
|
|
4338
4592
|
protected readonly placeholderText: _angular_core.Signal<string>;
|
|
4339
4593
|
protected isSelected(option: AutocompleteOption<T>): boolean;
|
|
4340
4594
|
protected optionClass(option: AutocompleteOption<T>): string;
|
|
@@ -4348,11 +4602,21 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4348
4602
|
private nextEnabledIndex;
|
|
4349
4603
|
/** Flat index of the given option within the visible (filtered) list. */
|
|
4350
4604
|
protected flatIndexOf(option: AutocompleteOption<T>): number;
|
|
4605
|
+
constructor();
|
|
4606
|
+
private setOpen;
|
|
4607
|
+
protected readonly isReadOnly: _angular_core.Signal<boolean>;
|
|
4608
|
+
protected readonly cursorFromKeyboard: _angular_core.WritableSignal<boolean>;
|
|
4609
|
+
/** How far PageUp and PageDown move. Ten rows is the native `<select>` step and
|
|
4610
|
+
* the APG listbox example's — a fixed number rather than a measured screenful,
|
|
4611
|
+
* so the jump is the same wherever the panel happens to be clipped. */
|
|
4612
|
+
private static readonly pageStep;
|
|
4613
|
+
private cursorList;
|
|
4351
4614
|
protected onTriggerClick(): void;
|
|
4352
4615
|
protected togglePanel(event: MouseEvent): void;
|
|
4353
4616
|
protected onKeydown(event: KeyboardEvent): void;
|
|
4354
4617
|
protected openPanel(): void;
|
|
4355
4618
|
protected close(cause?: DsOverlayCloseCause): void;
|
|
4619
|
+
protected clearValue(event: MouseEvent): void;
|
|
4356
4620
|
/**
|
|
4357
4621
|
* Empties the field — both the selected value and the text the user typed.
|
|
4358
4622
|
*
|
|
@@ -4372,7 +4636,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4372
4636
|
protected onCreateNew(): void;
|
|
4373
4637
|
protected remove(target: T): void;
|
|
4374
4638
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent<any>, never>;
|
|
4375
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "
|
|
4639
|
+
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; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "filterWith": { "alias": "filterWith"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "scrollActiveIntoView": { "alias": "scrollActiveIntoView"; "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"; "filterChange": "filterChange"; "opened": "opened"; "closed": "closed"; "create": "create"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate", "createTemplate"], ["[dsAutocompletePrefix]", "[dsAutocompleteSuffix]"], true, never>;
|
|
4376
4640
|
}
|
|
4377
4641
|
|
|
4378
4642
|
type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
|
|
@@ -4667,8 +4931,20 @@ declare class LoadingOverlayComponent {
|
|
|
4667
4931
|
readonly spinnerSize: _angular_core.InputSignal<DsSize>;
|
|
4668
4932
|
/** Offset the scrim top edge — useful when a sticky header should stay uncovered. */
|
|
4669
4933
|
readonly insetTop: _angular_core.InputSignal<string>;
|
|
4934
|
+
/**
|
|
4935
|
+
* Whether the projected content goes `inert` while the scrim is up. On by
|
|
4936
|
+
* default, because a scrim that only stops the POINTER is the bug this exists
|
|
4937
|
+
* to prevent: focus walks straight under it, and a keyboard user activates a
|
|
4938
|
+
* control the mouse cannot even reach.
|
|
4939
|
+
*
|
|
4940
|
+
* Turn it off only when the scrim covers part of the content (`insetTop`), and
|
|
4941
|
+
* then mark the covered subtree `inert` yourself — a blanket flag would take
|
|
4942
|
+
* the uncovered part with it. `ds-table` does exactly that: the scrim starts
|
|
4943
|
+
* below the header, so sorting during a refresh stays possible.
|
|
4944
|
+
*/
|
|
4945
|
+
readonly inertContent: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4670
4946
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<LoadingOverlayComponent, never>;
|
|
4671
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<LoadingOverlayComponent, "ds-loading-overlay", never, { "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "blur": { "alias": "blur"; "required": false; "isSignal": true; }; "spinnerSize": { "alias": "spinnerSize"; "required": false; "isSignal": true; }; "insetTop": { "alias": "insetTop"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
|
|
4947
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<LoadingOverlayComponent, "ds-loading-overlay", never, { "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "blur": { "alias": "blur"; "required": false; "isSignal": true; }; "spinnerSize": { "alias": "spinnerSize"; "required": false; "isSignal": true; }; "insetTop": { "alias": "insetTop"; "required": false; "isSignal": true; }; "inertContent": { "alias": "inertContent"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
|
|
4672
4948
|
}
|
|
4673
4949
|
|
|
4674
4950
|
interface TreeNode {
|
|
@@ -4785,6 +5061,10 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
|
|
|
4785
5061
|
|
|
4786
5062
|
interface MultiSelectOption extends DsOption<string> {
|
|
4787
5063
|
}
|
|
5064
|
+
interface MultiSelectOptionGroup extends DsOptionGroup<string> {
|
|
5065
|
+
}
|
|
5066
|
+
type MultiSelectItem = DsOptionItem<string>;
|
|
5067
|
+
type MultiSelectWidth = DsControlWidth;
|
|
4788
5068
|
|
|
4789
5069
|
declare class MultiSelectComponent extends DsControlValueAccessor<string[]> implements OnDestroy {
|
|
4790
5070
|
private readonly overlay;
|
|
@@ -4795,12 +5075,56 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
4795
5075
|
private readonly panelTokens;
|
|
4796
5076
|
/** Selected values, two-way bound. */
|
|
4797
5077
|
readonly value: _angular_core.ModelSignal<string[]>;
|
|
4798
|
-
/** Options
|
|
4799
|
-
readonly options: _angular_core.InputSignal<readonly
|
|
5078
|
+
/** Options, groups, or both mixed — rendered in the order given. */
|
|
5079
|
+
readonly options: _angular_core.InputSignal<readonly MultiSelectItem[]>;
|
|
4800
5080
|
/** Placeholder shown in the trigger when nothing is selected. */
|
|
4801
5081
|
readonly placeholder: _angular_core.InputSignal<string>;
|
|
4802
5082
|
/** Placeholder for the in-panel filter input. */
|
|
4803
5083
|
readonly searchPlaceholder: _angular_core.InputSignal<string>;
|
|
5084
|
+
/** Whether the panel carries a filter row. `true` always, `false` never, and a
|
|
5085
|
+
* NUMBER is a threshold — the row appears once there are at least that many
|
|
5086
|
+
* options. Unset falls back to `DS_CONFIG.picker.searchable`, then `true`.
|
|
5087
|
+
*
|
|
5088
|
+
* Hiding it moves the panel's keyboard model onto the trigger: the arrows,
|
|
5089
|
+
* Enter, Escape and `aria-activedescendant` are the filter input's today. */
|
|
5090
|
+
readonly searchable: _angular_core.InputSignalWithTransform<number | boolean | null, unknown>;
|
|
5091
|
+
readonly searchableResolved: _angular_core.Signal<number | boolean>;
|
|
5092
|
+
/** Native `name` attribute forwarded to the trigger. */
|
|
5093
|
+
readonly name: _angular_core.InputSignal<string | null>;
|
|
5094
|
+
/** Prevents opening the panel while still allowing focus. */
|
|
5095
|
+
readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
5096
|
+
/**
|
|
5097
|
+
* The contract spelling of `readOnly`, a second input because signal forms binds
|
|
5098
|
+
* by NAME — a `readonly()` rule was reaching nothing before this existed.
|
|
5099
|
+
*/
|
|
5100
|
+
readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
5101
|
+
/** Shows a clear affordance once there is something to clear. */
|
|
5102
|
+
readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
5103
|
+
/** How the typed query narrows the list.
|
|
5104
|
+
*
|
|
5105
|
+
* The default matches a case-insensitive substring of `label`. Pass a predicate
|
|
5106
|
+
* to match on anything else — a second field, ignoring diacritics, a fuzzy score.
|
|
5107
|
+
* Pass `'none'` when the list arrives already filtered, which is what a
|
|
5108
|
+
* server-side search needs: the query is reported through `filterChange` and
|
|
5109
|
+
* every option given is rendered.
|
|
5110
|
+
*/
|
|
5111
|
+
readonly filterWith: _angular_core.InputSignal<"none" | ((option: MultiSelectOption, query: string) => boolean)>;
|
|
5112
|
+
/** The query the user typed, on every change. The input for a server-side search;
|
|
5113
|
+
* pair it with `filterWith="none"` so the list is not narrowed twice. */
|
|
5114
|
+
readonly filterChange: _angular_core.OutputEmitterRef<string>;
|
|
5115
|
+
/** Options are still being fetched. The panel shows a spinner instead of the
|
|
5116
|
+
* empty row — which would otherwise claim there are no matches — and the list
|
|
5117
|
+
* reports `aria-busy`. */
|
|
5118
|
+
readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
5119
|
+
/** The panel opened. The moment to fetch options for a picker whose list is
|
|
5120
|
+
* loaded on demand. */
|
|
5121
|
+
readonly opened: _angular_core.OutputEmitterRef<void>;
|
|
5122
|
+
/** The panel closed, for any reason — a pick, Escape, an outside click, a scroll. */
|
|
5123
|
+
readonly closed: _angular_core.OutputEmitterRef<void>;
|
|
5124
|
+
/** Scrolls the keyboard cursor's row into view. On by default: a list longer
|
|
5125
|
+
* than the panel otherwise walks the cursor out of sight. Set `false` only if
|
|
5126
|
+
* you are driving the scroll position yourself. */
|
|
5127
|
+
readonly scrollActiveIntoView: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4804
5128
|
/** How the chips collapse when they outgrow one line. `"fit"` (the default)
|
|
4805
5129
|
* measures and shows as many as the trigger is wide, the rest behind "+N more".
|
|
4806
5130
|
* A NUMBER is a CEILING, not a promise: the row still measures, so you get at
|
|
@@ -4818,10 +5142,39 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
4818
5142
|
readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
|
|
4819
5143
|
/** Accessible name for the trigger — falls back to `placeholder`. */
|
|
4820
5144
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
4821
|
-
/**
|
|
4822
|
-
|
|
5145
|
+
/** Trigger width — `fill` stretches to the container and pins the panel to the
|
|
5146
|
+
* trigger's width; `content` hugs the trigger's own content and takes that width
|
|
5147
|
+
* as the panel's FLOOR, so a compact trigger does not force an unreadable panel. */
|
|
5148
|
+
readonly width: _angular_core.InputSignal<_ids_group_ltd_ids_design_system.DsControlWidth>;
|
|
5149
|
+
/** Trigger height — sm/md/lg. Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
|
|
5150
|
+
readonly size: _angular_core.InputSignal<DsSize | null>;
|
|
5151
|
+
readonly sizeResolved: _angular_core.Signal<DsSize>;
|
|
5152
|
+
/** What the trigger shows. `count` is a caption plus a selected-count badge at
|
|
5153
|
+
* intrinsic width; `labels` names the selection instead, cut to the width with the
|
|
5154
|
+
* rest behind "+N". A projected `dsPickerTrigger` template WINS over this — the
|
|
5155
|
+
* input is then not read at all. */
|
|
5156
|
+
readonly triggerDisplay: _angular_core.InputSignal<DsTriggerDisplay>;
|
|
5157
|
+
/** Field label above the control — the same meaning it has on `ds-select`, and the
|
|
5158
|
+
* caption a `count`/`labels` trigger uses when it needs one. */
|
|
5159
|
+
readonly label: _angular_core.InputSignal<string>;
|
|
5160
|
+
/** Marks the field required: a `*` beside the label and `aria-required` on the trigger. */
|
|
5161
|
+
readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
5162
|
+
/** Marks the field optional in words, for a form where most fields are required. */
|
|
5163
|
+
readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
5164
|
+
/** Where a "select all" row appears. `false` nowhere, `true` one row over the whole
|
|
5165
|
+
* panel, `'group'` one row per group, `'both'` for either. Group rows need groups
|
|
5166
|
+
* in `options` — with a flat list they have nothing to head. */
|
|
5167
|
+
readonly selectAll: _angular_core.InputSignalWithTransform<boolean | "group" | "both", unknown>;
|
|
5168
|
+
protected readonly optionTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
5169
|
+
protected readonly chipTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
5170
|
+
protected readonly pickerTrigger: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
5171
|
+
protected readonly panelHeaderTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
5172
|
+
protected readonly panelFooterTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
5173
|
+
protected readonly groupLabelTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
5174
|
+
protected readonly emptyTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4823
5175
|
protected readonly uid: string;
|
|
4824
5176
|
protected readonly listboxId: string;
|
|
5177
|
+
protected readonly labelId: string;
|
|
4825
5178
|
protected optionId(index: number): string;
|
|
4826
5179
|
protected readonly trigger: _angular_core.Signal<ElementRef<HTMLElement>>;
|
|
4827
5180
|
protected readonly searchInput: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
|
|
@@ -4834,6 +5187,11 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
4834
5187
|
private focusTimer;
|
|
4835
5188
|
ngOnDestroy(): void;
|
|
4836
5189
|
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
5190
|
+
protected readonly showsCompactTrigger: _angular_core.Signal<boolean>;
|
|
5191
|
+
protected readonly showsSearch: _angular_core.Signal<boolean>;
|
|
5192
|
+
protected readonly triggerActiveDescendant: _angular_core.Signal<string | null>;
|
|
5193
|
+
protected readonly triggerCaption: _angular_core.Signal<string>;
|
|
5194
|
+
protected readonly allOptions: _angular_core.Signal<MultiSelectOption[]>;
|
|
4837
5195
|
protected readonly selectedOptions: _angular_core.Signal<MultiSelectOption[]>;
|
|
4838
5196
|
private readonly chipsMode;
|
|
4839
5197
|
private readonly showsEveryChip;
|
|
@@ -4852,7 +5210,13 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
4852
5210
|
private readonly chipsThatFit;
|
|
4853
5211
|
protected readonly visibleChips: _angular_core.Signal<MultiSelectOption[]>;
|
|
4854
5212
|
protected readonly overflowCount: _angular_core.Signal<number>;
|
|
5213
|
+
protected readonly filteredItems: _angular_core.Signal<MultiSelectItem[]>;
|
|
4855
5214
|
protected readonly filteredOptions: _angular_core.Signal<MultiSelectOption[]>;
|
|
5215
|
+
protected isGroup(item: MultiSelectItem): item is MultiSelectOptionGroup;
|
|
5216
|
+
/** Where an option sits in the flat visible list — the id the listbox's
|
|
5217
|
+
* `aria-activedescendant` points at, which a grouped render cannot get from
|
|
5218
|
+
* the loop index. */
|
|
5219
|
+
protected flatIndexOf(option: MultiSelectOption): number;
|
|
4856
5220
|
protected readonly activeDescendant: _angular_core.Signal<string | null>;
|
|
4857
5221
|
protected readonly resolvedAriaLabel: _angular_core.Signal<string>;
|
|
4858
5222
|
protected readonly hintId: _angular_core.Signal<string | null>;
|
|
@@ -4863,19 +5227,47 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
4863
5227
|
private enabledFiltered;
|
|
4864
5228
|
protected readonly allFilteredSelected: _angular_core.Signal<boolean>;
|
|
4865
5229
|
protected readonly someFilteredSelected: _angular_core.Signal<boolean>;
|
|
5230
|
+
protected readonly showsPanelSelectAll: _angular_core.Signal<boolean>;
|
|
5231
|
+
protected readonly showsGroupSelectAll: _angular_core.Signal<boolean>;
|
|
5232
|
+
private enabledIn;
|
|
5233
|
+
protected groupAllSelected(group: MultiSelectOptionGroup): boolean;
|
|
5234
|
+
protected groupSomeSelected(group: MultiSelectOptionGroup): boolean;
|
|
5235
|
+
protected toggleGroup(group: MultiSelectOptionGroup): void;
|
|
4866
5236
|
protected toggleSelectAll(): void;
|
|
4867
5237
|
protected isSelected(value: string): boolean;
|
|
4868
5238
|
protected toggleValue(option: MultiSelectOption): void;
|
|
5239
|
+
protected clearValue(event: MouseEvent): void;
|
|
5240
|
+
/**
|
|
5241
|
+
* Empties the selection from outside — a "reset filters" button, a form the app
|
|
5242
|
+
* clears itself. `ds-autocomplete` has had this; the other two had only the
|
|
5243
|
+
* in-trigger button.
|
|
5244
|
+
*
|
|
5245
|
+
* Deliberately does NOT move focus: the caller may be navigating away, and
|
|
5246
|
+
* stealing focus back into a field they just left is worse than leaving it.
|
|
5247
|
+
*/
|
|
5248
|
+
clear(): void;
|
|
4869
5249
|
protected removeValue(value: string): void;
|
|
5250
|
+
constructor();
|
|
4870
5251
|
protected onFilter(event: Event): void;
|
|
5252
|
+
private setOpen;
|
|
5253
|
+
protected readonly isReadOnly: _angular_core.Signal<boolean>;
|
|
5254
|
+
private readonly typeAhead;
|
|
5255
|
+
private handleTypeAhead;
|
|
5256
|
+
protected readonly cursorFromKeyboard: _angular_core.WritableSignal<boolean>;
|
|
5257
|
+
private cursorList;
|
|
5258
|
+
private firstEnabledIndex;
|
|
4871
5259
|
protected onTriggerKeydown(event: KeyboardEvent): void;
|
|
4872
5260
|
protected onSearchKeydown(event: KeyboardEvent): void;
|
|
4873
5261
|
protected openPanel(): void;
|
|
4874
5262
|
protected onTriggerClick(): void;
|
|
4875
5263
|
protected close(cause?: DsOverlayCloseCause): void;
|
|
5264
|
+
/** How far PageUp and PageDown move. Ten rows is the native `<select>` step and
|
|
5265
|
+
* the APG listbox example's — a fixed number rather than a measured screenful,
|
|
5266
|
+
* so the jump is the same wherever the panel happens to be clipped. */
|
|
5267
|
+
private static readonly pageStep;
|
|
4876
5268
|
private moveActive;
|
|
4877
5269
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
|
|
4878
|
-
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"; },
|
|
5270
|
+
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; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "filterWith": { "alias": "filterWith"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "scrollActiveIntoView": { "alias": "scrollActiveIntoView"; "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"; "filterChange": "filterChange"; "opened": "opened"; "closed": "closed"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate"], never, true, never>;
|
|
4879
5271
|
}
|
|
4880
5272
|
|
|
4881
5273
|
declare class SkeletonComponent {
|
|
@@ -5062,6 +5454,150 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
|
|
|
5062
5454
|
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>;
|
|
5063
5455
|
}
|
|
5064
5456
|
|
|
5457
|
+
/**
|
|
5458
|
+
* Fills an option row's LABEL AREA in `ds-select`, `ds-multi-select` and
|
|
5459
|
+
* `ds-autocomplete` — an avatar, a colour dot, a second line of metadata.
|
|
5460
|
+
*
|
|
5461
|
+
* ```html
|
|
5462
|
+
* <ds-multi-select [options]="assignees()">
|
|
5463
|
+
* <ng-template dsOptionTemplate let-option>
|
|
5464
|
+
* <ds-avatar size="xs" [seed]="option.label" /> {{ option.label }}
|
|
5465
|
+
* </ng-template>
|
|
5466
|
+
* </ds-multi-select>
|
|
5467
|
+
* ```
|
|
5468
|
+
*
|
|
5469
|
+
* The row itself stays library-owned: `role="option"`, `aria-selected`, the
|
|
5470
|
+
* active-row class, the checkbox and the check glyph are not projected, so a
|
|
5471
|
+
* template cannot take the listbox semantics with it.
|
|
5472
|
+
*/
|
|
5473
|
+
declare class DsOptionTemplateDirective {
|
|
5474
|
+
readonly template: TemplateRef<unknown>;
|
|
5475
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsOptionTemplateDirective, never>;
|
|
5476
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsOptionTemplateDirective, "[dsOptionTemplate]", never, {}, {}, never, never, true, never>;
|
|
5477
|
+
}
|
|
5478
|
+
|
|
5479
|
+
/**
|
|
5480
|
+
* Replaces the CONTENTS of a picker's trigger — the chips, the value, the
|
|
5481
|
+
* placeholder — with your own markup. The trigger ELEMENT stays library-owned,
|
|
5482
|
+
* so `aria-haspopup`, `aria-expanded`, `aria-controls`, the roving
|
|
5483
|
+
* `aria-activedescendant` and the Enter/Space/ArrowDown/Escape handling cannot
|
|
5484
|
+
* be lost with it.
|
|
5485
|
+
*
|
|
5486
|
+
* ```html
|
|
5487
|
+
* <ds-multi-select [options]="labels()" [(value)]="picked">
|
|
5488
|
+
* <ng-template dsPickerTrigger let-count="count">
|
|
5489
|
+
* Labels @if (count) { <ds-badge [count]="count" /> }
|
|
5490
|
+
* </ng-template>
|
|
5491
|
+
* </ds-multi-select>
|
|
5492
|
+
* ```
|
|
5493
|
+
*
|
|
5494
|
+
* Context: `$implicit` and `selected` are the selected options, `count` their
|
|
5495
|
+
* number, `open` whether the panel is showing, `disabled` the control's state.
|
|
5496
|
+
*
|
|
5497
|
+
* A projected template WINS over `triggerDisplay` — that input is then not read
|
|
5498
|
+
* at all, so there is no "compact plus a template" combination to explain.
|
|
5499
|
+
*/
|
|
5500
|
+
declare class DsPickerTriggerDirective {
|
|
5501
|
+
readonly template: TemplateRef<unknown>;
|
|
5502
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsPickerTriggerDirective, never>;
|
|
5503
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsPickerTriggerDirective, "[dsPickerTrigger]", never, {}, {}, never, never, true, never>;
|
|
5504
|
+
}
|
|
5505
|
+
|
|
5506
|
+
/**
|
|
5507
|
+
* Replaces a picker panel's "no matches" row — an icon, a sentence in the app's
|
|
5508
|
+
* own language, a "clear the filter" button.
|
|
5509
|
+
*
|
|
5510
|
+
* Context: `query` is the text that matched nothing.
|
|
5511
|
+
*
|
|
5512
|
+
* The row keeps `role="status"`, so a reader is told the list emptied whatever
|
|
5513
|
+
* the template puts inside it.
|
|
5514
|
+
*/
|
|
5515
|
+
declare class DsEmptyTemplateDirective {
|
|
5516
|
+
readonly template: TemplateRef<unknown>;
|
|
5517
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsEmptyTemplateDirective, never>;
|
|
5518
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsEmptyTemplateDirective, "[dsEmptyTemplate]", never, {}, {}, never, never, true, never>;
|
|
5519
|
+
}
|
|
5520
|
+
|
|
5521
|
+
/**
|
|
5522
|
+
* Fills a strip above a picker panel's option list — "3 of 40 selected", a
|
|
5523
|
+
* "clear all" button, a hint, a link to a fuller search.
|
|
5524
|
+
*
|
|
5525
|
+
* Context: `count` is how many options are visible after filtering, `total` how
|
|
5526
|
+
* many were given, and `query` the text that narrowed them.
|
|
5527
|
+
*
|
|
5528
|
+
* It sits OUTSIDE the `listbox`, so whatever you put here is not counted as an
|
|
5529
|
+
* option and does not break a screen reader's "N of M" position reporting. It
|
|
5530
|
+
* also stays put while the list scrolls under it — the panel clips and the list
|
|
5531
|
+
* is the scroller.
|
|
5532
|
+
*/
|
|
5533
|
+
declare class DsPanelHeaderTemplateDirective {
|
|
5534
|
+
readonly template: TemplateRef<unknown>;
|
|
5535
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsPanelHeaderTemplateDirective, never>;
|
|
5536
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsPanelHeaderTemplateDirective, "[dsPanelHeaderTemplate]", never, {}, {}, never, never, true, never>;
|
|
5537
|
+
}
|
|
5538
|
+
|
|
5539
|
+
/**
|
|
5540
|
+
* Fills a strip below a picker panel's option list — a "create new" affordance
|
|
5541
|
+
* of your own, a count, a link, an apply button for a panel the user batches
|
|
5542
|
+
* choices in.
|
|
5543
|
+
*
|
|
5544
|
+
* Context: the same as the header slot — `count`, `total`, `query`.
|
|
5545
|
+
*
|
|
5546
|
+
* Like the header it sits OUTSIDE the `listbox` and does not scroll with the
|
|
5547
|
+
* options. Anything focusable you put here is reached by Tab from the panel, so
|
|
5548
|
+
* give it an accessible name.
|
|
5549
|
+
*/
|
|
5550
|
+
declare class DsPanelFooterTemplateDirective {
|
|
5551
|
+
readonly template: TemplateRef<unknown>;
|
|
5552
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsPanelFooterTemplateDirective, never>;
|
|
5553
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsPanelFooterTemplateDirective, "[dsPanelFooterTemplate]", never, {}, {}, never, never, true, never>;
|
|
5554
|
+
}
|
|
5555
|
+
|
|
5556
|
+
/**
|
|
5557
|
+
* Fills an option group's heading — a count beside the name, a team glyph, a
|
|
5558
|
+
* secondary line.
|
|
5559
|
+
*
|
|
5560
|
+
* Context: `$implicit` and `group` are the group itself, `count` how many of its
|
|
5561
|
+
* options survived the filter.
|
|
5562
|
+
*
|
|
5563
|
+
* The heading element stays the library's: it keeps the id that the group's
|
|
5564
|
+
* `aria-labelledby` points at, so replacing the text cannot detach a group from
|
|
5565
|
+
* its name.
|
|
5566
|
+
*/
|
|
5567
|
+
declare class DsGroupLabelTemplateDirective {
|
|
5568
|
+
readonly template: TemplateRef<unknown>;
|
|
5569
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsGroupLabelTemplateDirective, never>;
|
|
5570
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsGroupLabelTemplateDirective, "[dsGroupLabelTemplate]", never, {}, {}, never, never, true, never>;
|
|
5571
|
+
}
|
|
5572
|
+
|
|
5573
|
+
/**
|
|
5574
|
+
* Replaces `ds-autocomplete`'s "Create «…»" row.
|
|
5575
|
+
*
|
|
5576
|
+
* Context: `query` is the typed text the row would create.
|
|
5577
|
+
*
|
|
5578
|
+
* The row stays a `role="option"` the keyboard can reach, and picking it still
|
|
5579
|
+
* emits `create` — the template fills the row, it does not become the action.
|
|
5580
|
+
*/
|
|
5581
|
+
declare class DsCreateTemplateDirective {
|
|
5582
|
+
readonly template: TemplateRef<unknown>;
|
|
5583
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsCreateTemplateDirective, never>;
|
|
5584
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsCreateTemplateDirective, "[dsCreateTemplate]", never, {}, {}, never, never, true, never>;
|
|
5585
|
+
}
|
|
5586
|
+
|
|
5587
|
+
/**
|
|
5588
|
+
* Fills a selected chip's content in the trigger of `ds-multi-select` and
|
|
5589
|
+
* `ds-autocomplete`, so a picker whose rows carry an avatar does not lose it the
|
|
5590
|
+
* moment the option is chosen.
|
|
5591
|
+
*
|
|
5592
|
+
* The chip is still a `ds-tag` owned by the library: its close button, its
|
|
5593
|
+
* accessible remove label and the measured overflow cap are not projected.
|
|
5594
|
+
*/
|
|
5595
|
+
declare class DsChipTemplateDirective {
|
|
5596
|
+
readonly template: TemplateRef<unknown>;
|
|
5597
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsChipTemplateDirective, never>;
|
|
5598
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsChipTemplateDirective, "[dsChipTemplate]", never, {}, {}, never, never, true, never>;
|
|
5599
|
+
}
|
|
5600
|
+
|
|
5065
5601
|
/**
|
|
5066
5602
|
* Focuses the field's inner `input`/`textarea` when the click lands on the
|
|
5067
5603
|
* frame chrome — padding, a leading/trailing icon, an addon slot — instead of
|
|
@@ -5079,5 +5615,5 @@ declare class FieldClickFocusDirective {
|
|
|
5079
5615
|
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
|
|
5080
5616
|
}
|
|
5081
5617
|
|
|
5082
|
-
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 };
|
|
5083
|
-
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 };
|
|
5618
|
+
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, DsGroupLabelTemplateDirective, DsOptionTemplateDirective, DsOverlayCloseRef, DsPanelFooterTemplateDirective, DsPanelHeaderTemplateDirective, 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 };
|
|
5619
|
+
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, TableExpandMode, TableFilterMode, TableRowAction, TableRowActionEvent, TableSortMode, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TimeFormat, TimePickerMode, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };
|