@ids-group-ltd/ids-design-system 0.11.1 → 0.11.3
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 +342 -31
- package/components.md +27 -12
- package/design-system.md +135 -1
- package/docs/agent/INDEX.md +98 -0
- package/docs/agent/domain/ds-w3w.md +10 -0
- package/docs/agent/feedback/ds-alert.md +9 -0
- package/docs/agent/feedback/ds-avatar-group.md +7 -0
- package/docs/agent/feedback/ds-avatar.md +6 -0
- package/docs/agent/feedback/ds-badge.md +7 -0
- package/docs/agent/feedback/ds-banner.md +10 -0
- package/docs/agent/feedback/ds-empty-state.md +7 -0
- package/docs/agent/feedback/ds-progress.md +7 -0
- package/docs/agent/feedback/ds-skeleton.md +6 -0
- package/docs/agent/feedback/ds-spinner.md +6 -0
- package/docs/agent/feedback/ds-stat.md +7 -0
- package/docs/agent/feedback/ds-status-dot.md +6 -0
- package/docs/agent/feedback/ds-tag.md +8 -0
- package/docs/agent/feedback/ds-toast.md +12 -0
- package/docs/agent/forms/ds-autocomplete.md +9 -0
- package/docs/agent/forms/ds-button.md +14 -0
- package/docs/agent/forms/ds-checkbox.md +6 -0
- package/docs/agent/forms/ds-date-picker.md +7 -0
- package/docs/agent/forms/ds-dropzone.md +10 -0
- package/docs/agent/forms/ds-icon-button.md +10 -0
- package/docs/agent/forms/ds-input.md +22 -0
- package/docs/agent/forms/ds-multi-select.md +6 -0
- package/docs/agent/forms/ds-number-stepper.md +8 -0
- package/docs/agent/forms/ds-radio.md +6 -0
- package/docs/agent/forms/ds-search.md +10 -0
- package/docs/agent/forms/ds-select.md +7 -0
- package/docs/agent/forms/ds-switch.md +6 -0
- package/docs/agent/forms/ds-textarea.md +9 -0
- package/docs/agent/forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md +21 -0
- package/docs/agent/foundations/global-helper-classes.md +18 -0
- package/docs/agent/foundations/grid.md +35 -0
- package/docs/agent/foundations/tokens.md +47 -0
- package/docs/agent/navigation/ds-app-layout.md +10 -0
- package/docs/agent/navigation/ds-auth-layout.md +9 -0
- package/docs/agent/navigation/ds-breadcrumbs.md +7 -0
- package/docs/agent/navigation/ds-divider.md +9 -0
- package/docs/agent/navigation/ds-page-footer.md +7 -0
- package/docs/agent/navigation/ds-page-header.md +8 -0
- package/docs/agent/navigation/ds-pagination.md +7 -0
- package/docs/agent/navigation/ds-sidenav-group.md +8 -0
- package/docs/agent/navigation/ds-sidenav-item.md +9 -0
- package/docs/agent/navigation/ds-sidenav.md +9 -0
- package/docs/agent/navigation/ds-stepper.md +6 -0
- package/docs/agent/navigation/ds-tabs.md +9 -0
- package/docs/agent/navigation/ds-topbar.md +8 -0
- package/docs/agent/overlays/ds-bottom-sheet.md +9 -0
- package/docs/agent/overlays/ds-drawer.md +9 -0
- package/docs/agent/overlays/ds-menu.md +8 -0
- package/docs/agent/overlays/ds-modal-card.md +6 -0
- package/docs/agent/overlays/ds-modal.md +8 -0
- package/docs/agent/overlays/ds-popover.md +6 -0
- package/docs/agent/overlays/ds-tooltip.md +8 -0
- package/docs/agent/platform/breadcrumbs-service.md +30 -0
- package/docs/agent/platform/ds-config.md +60 -0
- package/docs/agent/platform/ds-icon-registry.md +23 -0
- package/docs/agent/platform/toast-service.md +19 -0
- package/docs/agent/surfaces/ds-accordion.md +8 -0
- package/docs/agent/surfaces/ds-card.md +10 -0
- package/docs/agent/tables/ds-table.md +15 -0
- package/fesm2022/ids-group-ltd-ids-design-system.mjs +1530 -865
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.11.0.json +0 -45
- package/migrations/0.11.1.json +9 -35
- package/migrations/0.11.2.json +158 -0
- package/migrations/0.11.3.json +152 -0
- package/migrations/0.2.0.json +17 -5
- package/migrations/0.4.0.json +1 -1
- package/migrations/0.7.1.json +3 -3
- package/migrations/0.9.0.json +2 -2
- package/package.json +1 -1
- package/styles/_dropdown-overlay.scss +50 -38
- package/styles/_ds-color.scss +31 -12
- package/styles/_tokens-charts.scss +2 -3
- package/styles/_tokens.scss +159 -322
- package/themes/README.md +35 -4
- package/themes/_base-palette.scss +35 -76
- package/themes/_semantic.scss +5 -2
- package/types/ids-group-ltd-ids-design-system.d.ts +424 -188
|
@@ -123,16 +123,12 @@ interface DsConfig {
|
|
|
123
123
|
* override at the validator covers both. Unmapped kinds warn in dev. */
|
|
124
124
|
errorMessages?: Record<string, string>;
|
|
125
125
|
/** Leading glyph on a field's message line, per state. Defaults carry one for
|
|
126
|
-
*
|
|
127
|
-
*
|
|
128
|
-
*
|
|
129
|
-
* `{ warning: false, hint: 'info' }` turns one off and the other on. A glyph name
|
|
130
|
-
* replaces the default; `false` removes it. `stateIcons: false` removes all four,
|
|
131
|
-
* which is the one-line way to turn the glyphs off entirely.
|
|
126
|
+
* `error`, `warning` and `success` and NONE for `hint`, which is resting text
|
|
127
|
+
* rather than a state. Each key is independent — a glyph name replaces the
|
|
128
|
+
* default, `false` removes it, and `stateIcons: false` removes all four.
|
|
132
129
|
*
|
|
133
|
-
*
|
|
134
|
-
*
|
|
135
|
-
* else — which WCAG 1.4.1 forbids a state from resting on. */
|
|
130
|
+
* The glyphs exist because warning and success differ from each other by hue
|
|
131
|
+
* and nothing else, which WCAG 1.4.1 forbids a state from resting on. */
|
|
136
132
|
stateIcons?: false | {
|
|
137
133
|
error?: IconName | false;
|
|
138
134
|
warning?: IconName | false;
|
|
@@ -151,8 +147,8 @@ interface DsConfig {
|
|
|
151
147
|
};
|
|
152
148
|
avatar?: {
|
|
153
149
|
/** How `ds-avatar` turns its `name` into initials, app-wide. The built-in rule
|
|
154
|
-
* takes the first two words
|
|
155
|
-
*
|
|
150
|
+
* takes the first two words, which is a Latin-script guess — an app whose names
|
|
151
|
+
* follow another convention supplies its own here. */
|
|
156
152
|
initials?: (name: string) => string;
|
|
157
153
|
};
|
|
158
154
|
brand?: {
|
|
@@ -173,10 +169,9 @@ interface DsConfig {
|
|
|
173
169
|
picker?: {
|
|
174
170
|
/** Default for `ds-multi-select``s `searchable`. `true` always shows the panel's
|
|
175
171
|
* 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
|
-
*
|
|
179
|
-
* the same length in the same screen end up disagreeing. */
|
|
172
|
+
* there are at least that many options. Default `true`. One threshold for the
|
|
173
|
+
* app is the point: left to each call site, two panels of the same length in
|
|
174
|
+
* the same screen end up disagreeing. */
|
|
180
175
|
searchable?: boolean | number;
|
|
181
176
|
};
|
|
182
177
|
control?: {
|
|
@@ -195,14 +190,12 @@ interface DsConfig {
|
|
|
195
190
|
};
|
|
196
191
|
table?: {
|
|
197
192
|
/** Default for `ds-table`'s `stickyScrollbar` — the proxy that keeps the
|
|
198
|
-
* horizontal bar reachable on a tall table. Default `false`.
|
|
199
|
-
*
|
|
200
|
-
*
|
|
193
|
+
* horizontal bar reachable on a tall table. Default `false`. Here rather than
|
|
194
|
+
* per table because every new table is one forgotten binding away from
|
|
195
|
+
* scrolling invisibly. */
|
|
201
196
|
stickyScrollbar?: boolean;
|
|
202
197
|
/** Default for `ds-table`'s `bordered` — the outer border and radius.
|
|
203
|
-
* Default `false`.
|
|
204
|
-
* it is here: `provideDsConfig` scopes to a root or a route subtree, so the
|
|
205
|
-
* deliberate exceptions stay visible as bindings. */
|
|
198
|
+
* Default `false`. */
|
|
206
199
|
bordered?: boolean;
|
|
207
200
|
};
|
|
208
201
|
icon?: {
|
|
@@ -227,25 +220,22 @@ declare const DS_CONFIG: InjectionToken<DsConfig>;
|
|
|
227
220
|
*
|
|
228
221
|
* providers: [provideDsConfig({ control: { size: 'sm' } })]
|
|
229
222
|
*
|
|
230
|
-
* Works at the app root, on a `Route`, or on a component/directive — the
|
|
231
|
-
*
|
|
232
|
-
*
|
|
233
|
-
*
|
|
234
|
-
* A nested call MERGES with the config above it, section by section, so
|
|
235
|
-
* scoping one flag cannot silently drop unrelated app-level settings. Only the
|
|
236
|
-
* keys you name are replaced.
|
|
223
|
+
* Works at the app root, on a `Route`, or on a component/directive — the config
|
|
224
|
+
* resolves through the element-injector chain, so a subtree can differ from the
|
|
225
|
+
* app. Component inputs (e.g. `<ds-card padding="lg">`) still win.
|
|
237
226
|
*
|
|
238
|
-
*
|
|
239
|
-
*
|
|
240
|
-
*
|
|
227
|
+
* A nested call MERGES with the config above it section by section; only the keys
|
|
228
|
+
* you name are replaced. ONE call per injector, though: two in the SAME
|
|
229
|
+
* `providers` array both resolve their parent with `skipSelf`, so the later wins
|
|
230
|
+
* and the earlier is silently lost.
|
|
241
231
|
*/
|
|
242
232
|
declare function provideDsConfig(config: DsConfig): Provider;
|
|
243
233
|
/**
|
|
244
234
|
* The factory body behind `provideDsConfig`, exported so a directive can put the
|
|
245
235
|
* provider in its metadata as a plain object literal. Calling `provideDsConfig`
|
|
246
|
-
* there instead
|
|
247
|
-
* side-effectful and costs the consumer its tree-shaking (measured at +566 kB
|
|
248
|
-
* into the eager chunk).
|
|
236
|
+
* there instead runs at module-evaluation time, which makes the module
|
|
237
|
+
* side-effectful and costs the consumer its tree-shaking (measured at +566 kB
|
|
238
|
+
* moved into the eager chunk).
|
|
249
239
|
*
|
|
250
240
|
* Must be called from an injection context.
|
|
251
241
|
*/
|
|
@@ -317,6 +307,10 @@ interface DsOption<T = string> {
|
|
|
317
307
|
value: T;
|
|
318
308
|
label: string;
|
|
319
309
|
disabled?: boolean;
|
|
310
|
+
/** Why this option cannot be picked. Reaches the row as `aria-describedby`, so a
|
|
311
|
+
* reader hears the reason instead of only meeting a dead row. Ignored unless
|
|
312
|
+
* `disabled` is set. */
|
|
313
|
+
disabledReason?: string;
|
|
320
314
|
/** Rendered before the label at 16px by every picker's option row. */
|
|
321
315
|
icon?: IconName;
|
|
322
316
|
}
|
|
@@ -331,8 +325,7 @@ interface DsOptionGroup<T = string> {
|
|
|
331
325
|
/**
|
|
332
326
|
* What a picker's `options` input takes: flat options, groups, or both mixed.
|
|
333
327
|
* One input rather than two, because a second `optionGroups` input can only
|
|
334
|
-
* answer "what if both are set" by silently ignoring one
|
|
335
|
-
* `ds-autocomplete` used to do.
|
|
328
|
+
* answer "what if both are set" by silently ignoring one.
|
|
336
329
|
*/
|
|
337
330
|
type DsOptionItem<T = string> = DsOption<T> | DsOptionGroup<T>;
|
|
338
331
|
declare function isDsOptionGroup<T>(item: DsOptionItem<T>): item is DsOptionGroup<T>;
|
|
@@ -976,10 +969,8 @@ declare class BrandNameDirective {
|
|
|
976
969
|
* MFA — and the counterpart to `ds-app-layout`, which only ever covers the
|
|
977
970
|
* screens behind the login.
|
|
978
971
|
*
|
|
979
|
-
*
|
|
980
|
-
*
|
|
981
|
-
* box: they nest a `100vh` wrapper inside a `100dvh` one and scroll a page whose
|
|
982
|
-
* content fits. Here the host is the only one, and it also carries the safe-area
|
|
972
|
+
* The host is the ONLY full-height box — nesting a `100vh` wrapper inside a
|
|
973
|
+
* `100dvh` one scrolls a page whose content fits — and it carries the safe-area
|
|
983
974
|
* insets a notched phone in landscape needs.
|
|
984
975
|
*
|
|
985
976
|
* The brand row takes the same CONTRACT as `ds-sidenav` — a `brand` string gets a
|
|
@@ -1007,10 +998,9 @@ declare class BrandNameDirective {
|
|
|
1007
998
|
declare class AuthLayoutComponent {
|
|
1008
999
|
/** Wordmark beside the letter-mark tile. For a logo image/SVG, project it into
|
|
1009
1000
|
* the `[brand]` slot instead; for a two-tone wordmark use `[dsBrandName]`.
|
|
1010
|
-
* Unset falls back to `DS_CONFIG.brand.name
|
|
1011
|
-
*
|
|
1012
|
-
*
|
|
1013
|
-
* screen no brand row. */
|
|
1001
|
+
* Unset falls back to `DS_CONFIG.brand.name`. Each field resolves on its own, so
|
|
1002
|
+
* `brand=""` drops the wordmark but a `logoLetter` in the config still paints its
|
|
1003
|
+
* tile; clear both to give one screen no brand row. */
|
|
1014
1004
|
readonly brand: _angular_core.InputSignal<string | null>;
|
|
1015
1005
|
/** Letter-mark glyph when it differs from the brand's first letter (e.g. an
|
|
1016
1006
|
* "A" tile beside the "MyAdmin" wordmark). Empty = first letter of `brand`;
|
|
@@ -1028,14 +1018,12 @@ declare class AuthLayoutComponent {
|
|
|
1028
1018
|
readonly cardElevation: _angular_core.InputSignal<CardElevation>;
|
|
1029
1019
|
/** Card padding, passed through to `ds-card`. `md` tightens a short form. */
|
|
1030
1020
|
readonly cardPadding: _angular_core.InputSignal<CardPadding>;
|
|
1031
|
-
/** Announce the card as the page's `main` landmark.
|
|
1032
|
-
*
|
|
1033
|
-
*
|
|
1034
|
-
*
|
|
1035
|
-
*
|
|
1036
|
-
* own violation. */
|
|
1021
|
+
/** Announce the card as the page's `main` landmark. `ds-card` renders an
|
|
1022
|
+
* `<article>`, which is NOT a landmark, so by default a screen-reader user has
|
|
1023
|
+
* nothing to jump to — set `'main'` on a standalone auth page. Opt-in because
|
|
1024
|
+
* the layout is also embedded inside pages that already own a `main`, and two
|
|
1025
|
+
* `main`s is its own violation. */
|
|
1037
1026
|
readonly landmark: _angular_core.InputSignal<"none" | "main">;
|
|
1038
|
-
/** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
|
|
1039
1027
|
protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
|
|
1040
1028
|
protected readonly hasBrandName: _angular_core.Signal<boolean>;
|
|
1041
1029
|
/** Spread, not `charAt(0)`: the latter indexes UTF-16 code UNITS, so a brand
|
|
@@ -1894,8 +1882,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1894
1882
|
/** Flat options or option groups rendered in the dropdown panel. */
|
|
1895
1883
|
readonly options: _angular_core.InputSignal<readonly SelectItem[]>;
|
|
1896
1884
|
/** Public panel tokens forwarded onto the portaled overlay pane on open, so a
|
|
1897
|
-
* consumer's `ds-select { --ds-dropdown-panel-*: … }` reaches it.
|
|
1898
|
-
* tokens can only be set globally: the pane is portaled out of this component. */
|
|
1885
|
+
* consumer's `ds-select { --ds-dropdown-panel-*: … }` reaches it. */
|
|
1899
1886
|
private readonly panelTokens;
|
|
1900
1887
|
/** Trigger width — `fill` stretches to the container and pins the panel to the
|
|
1901
1888
|
* trigger's width; `content` hugs the trigger's own content and takes that width
|
|
@@ -1911,6 +1898,19 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1911
1898
|
readonly label: _angular_core.InputSignal<string>;
|
|
1912
1899
|
/** Disables the trigger and blocks all interaction. */
|
|
1913
1900
|
readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1901
|
+
/** Options are still being fetched. The panel shows a spinner instead of the
|
|
1902
|
+
* empty row — which would otherwise claim there are no matches — and the list
|
|
1903
|
+
* reports `aria-busy`. */
|
|
1904
|
+
readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1905
|
+
/** The panel opened. The moment to fetch options for a picker whose list is
|
|
1906
|
+
* loaded on demand. */
|
|
1907
|
+
readonly opened: _angular_core.OutputEmitterRef<void>;
|
|
1908
|
+
/** The panel closed, for any reason — a pick, Escape, an outside click, a scroll. */
|
|
1909
|
+
readonly closed: _angular_core.OutputEmitterRef<void>;
|
|
1910
|
+
/** Scrolls the keyboard cursor's row into view. On by default: a list longer
|
|
1911
|
+
* than the panel otherwise walks the cursor out of sight. Set `false` only if
|
|
1912
|
+
* you are driving the scroll position yourself. */
|
|
1913
|
+
readonly scrollActiveIntoView: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1914
1914
|
/** Prevents opening the dropdown while still allowing focus. */
|
|
1915
1915
|
readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1916
1916
|
/**
|
|
@@ -1934,6 +1934,9 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1934
1934
|
readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
1935
1935
|
protected readonly optionTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
1936
1936
|
protected readonly pickerTrigger: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
1937
|
+
protected readonly panelHeaderTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
1938
|
+
protected readonly panelFooterTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
1939
|
+
protected readonly groupLabelTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
1937
1940
|
protected readonly emptyTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
1938
1941
|
protected readonly uid: string;
|
|
1939
1942
|
protected readonly labelId: string;
|
|
@@ -1947,7 +1950,6 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1947
1950
|
/** Active option for `aria-activedescendant` (combobox keeps DOM focus). */
|
|
1948
1951
|
protected readonly activeDescendant: _angular_core.Signal<string | null>;
|
|
1949
1952
|
protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
|
|
1950
|
-
/** Effective disabled — own `disabled` input OR the reactive-forms state. */
|
|
1951
1953
|
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
1952
1954
|
protected readonly trigger: _angular_core.Signal<ElementRef<HTMLElement>>;
|
|
1953
1955
|
protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
|
|
@@ -1972,15 +1974,33 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1972
1974
|
ngOnDestroy(): void;
|
|
1973
1975
|
protected pick(option: SelectOption, groupDisabled?: boolean): void;
|
|
1974
1976
|
protected clearValue(event: MouseEvent): void;
|
|
1977
|
+
/**
|
|
1978
|
+
* Empties the selection from outside — a "reset filters" button, a form the app
|
|
1979
|
+
* clears itself.
|
|
1980
|
+
*
|
|
1981
|
+
* Deliberately does NOT move focus: the caller may be navigating away, and
|
|
1982
|
+
* stealing focus back into a field they just left is worse than leaving it.
|
|
1983
|
+
*/
|
|
1984
|
+
clear(): void;
|
|
1975
1985
|
protected isSelected(option: SelectOption): boolean;
|
|
1976
1986
|
protected isOptionDisabled(option: SelectOption, groupDisabled?: boolean): boolean;
|
|
1977
1987
|
protected onTriggerKeydown(event: KeyboardEvent): void;
|
|
1988
|
+
private pickActive;
|
|
1978
1989
|
protected isActive(index: number): boolean;
|
|
1990
|
+
private readonly typeAhead;
|
|
1991
|
+
private handleTypeAhead;
|
|
1992
|
+
protected readonly cursorFromKeyboard: _angular_core.WritableSignal<boolean>;
|
|
1993
|
+
private cursorList;
|
|
1994
|
+
/** How far PageUp and PageDown move. Ten rows is the native `<select>` step and
|
|
1995
|
+
* the APG listbox example's — a fixed number rather than a measured screenful,
|
|
1996
|
+
* so the jump is the same wherever the panel happens to be clipped. */
|
|
1997
|
+
private static readonly pageStep;
|
|
1979
1998
|
private moveActive;
|
|
1980
|
-
private
|
|
1999
|
+
private setOpen;
|
|
1981
2000
|
private lastEnabledIndex;
|
|
2001
|
+
private firstEnabledIndex;
|
|
1982
2002
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
|
|
1983
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["optionTemplate", "pickerTrigger", "emptyTemplate"], never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
|
|
2003
|
+
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: {}; }]>;
|
|
1984
2004
|
}
|
|
1985
2005
|
|
|
1986
2006
|
/**
|
|
@@ -2056,18 +2076,6 @@ declare class HeaderFilterDirective {
|
|
|
2056
2076
|
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>;
|
|
2057
2077
|
}
|
|
2058
2078
|
|
|
2059
|
-
/**
|
|
2060
|
-
* Who sorts a `ds-table`.
|
|
2061
|
-
*
|
|
2062
|
-
* - `'server'` (default) — the table only emits `sortChange`; the host reorders.
|
|
2063
|
-
* - `'client'` — the table reorders `data()` itself, for a table holding every row.
|
|
2064
|
-
* - `'none'` — nothing sorts, and `sortable` columns render no affordance rather
|
|
2065
|
-
* than a control that does nothing.
|
|
2066
|
-
*
|
|
2067
|
-
* Replaces the boolean `clientSort`, which could not express `'none'`: a column
|
|
2068
|
-
* marked `sortable` on a table with no sorting drew a live-looking header that
|
|
2069
|
-
* did nothing, and no type or dev check could catch it.
|
|
2070
|
-
*/
|
|
2071
2079
|
/**
|
|
2072
2080
|
* Who applies the header filters.
|
|
2073
2081
|
*
|
|
@@ -2080,7 +2088,18 @@ declare class HeaderFilterDirective {
|
|
|
2080
2088
|
* control that does nothing.
|
|
2081
2089
|
*/
|
|
2082
2090
|
type TableFilterMode = 'client' | 'server' | 'none';
|
|
2091
|
+
/**
|
|
2092
|
+
* Who sorts a `ds-table`.
|
|
2093
|
+
*
|
|
2094
|
+
* - `'server'` (default) — the table only emits `sortChange`; the host reorders.
|
|
2095
|
+
* - `'client'` — the table reorders `data()` itself, for a table holding every row.
|
|
2096
|
+
* - `'none'` — nothing sorts, and `sortable` columns render no affordance rather
|
|
2097
|
+
* than a control that does nothing.
|
|
2098
|
+
*/
|
|
2083
2099
|
type TableSortMode = 'client' | 'server' | 'none';
|
|
2100
|
+
/** `'single'` closes the open row when another is expanded; `'multiple'` (default)
|
|
2101
|
+
* leaves every expanded row open. */
|
|
2102
|
+
type TableExpandMode = 'multiple' | 'single';
|
|
2084
2103
|
|
|
2085
2104
|
interface TableColumn<T = unknown> {
|
|
2086
2105
|
key: string;
|
|
@@ -2450,6 +2469,23 @@ declare class TableComponent<T extends object> {
|
|
|
2450
2469
|
readonly expandableRows: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2451
2470
|
/** Two-way set of currently expanded row ids. */
|
|
2452
2471
|
readonly expandedIds: _angular_core.ModelSignal<Set<string>>;
|
|
2472
|
+
/** `'single'` collapses the open row when another expander is clicked.
|
|
2473
|
+
* Enforced on interaction only: a set seeded with several ids is left alone
|
|
2474
|
+
* (and warned about in dev) rather than silently rewritten under the host. */
|
|
2475
|
+
readonly expandMode: _angular_core.InputSignal<TableExpandMode>;
|
|
2476
|
+
/** Renders an expand-all/collapse-all chevron in the expander column header,
|
|
2477
|
+
* page-scoped when paginating, like select-all. Suppressed under
|
|
2478
|
+
* `expandMode="single"`, which it would contradict. */
|
|
2479
|
+
readonly expandAllToggle: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2480
|
+
/** Fires with the row when an expander opens it — including each row opened
|
|
2481
|
+
* by expand-all, so a host lazy-loading panel content sees every one. */
|
|
2482
|
+
readonly rowExpanded: _angular_core.OutputEmitterRef<T>;
|
|
2483
|
+
/** Fires with the row when an expander closes it, the row auto-closed by
|
|
2484
|
+
* `expandMode="single"` included. It carries a row, so it cannot speak for an
|
|
2485
|
+
* id whose row is no longer in `data()` — under server-side paging that id is
|
|
2486
|
+
* cleared silently. `expandedIds` is the complete signal; this one is the
|
|
2487
|
+
* convenient one. */
|
|
2488
|
+
readonly rowCollapsed: _angular_core.OutputEmitterRef<T>;
|
|
2453
2489
|
/** Template rendered inside an expanded row's panel.
|
|
2454
2490
|
* Context: `$implicit` = row, `row` = row. */
|
|
2455
2491
|
readonly rowExpandTemplate: _angular_core.InputSignal<TemplateRef<{
|
|
@@ -2474,15 +2510,10 @@ declare class TableComponent<T extends object> {
|
|
|
2474
2510
|
* `skeleton` paints "No rows yet" under the spinner on a zero-row reload. */
|
|
2475
2511
|
protected readonly showsEmptyRow: _angular_core.Signal<boolean>;
|
|
2476
2512
|
protected readonly effectiveHiddenKeys: _angular_core.Signal<ReadonlySet<string>>;
|
|
2477
|
-
/** Columns in the user-controlled order — `columnOrder` first (dropping
|
|
2478
|
-
* unknown keys), then any declared column the order omitted. */
|
|
2479
2513
|
protected readonly orderedColumns: _angular_core.Signal<readonly TableColumn<T>[]>;
|
|
2480
|
-
/** Columns actually rendered — reordered, then hidden ones skipped. */
|
|
2481
2514
|
protected readonly visibleColumns: _angular_core.Signal<readonly TableColumn<T>[]>;
|
|
2482
|
-
/** Columns the user may toggle — drives the header column picker. */
|
|
2483
2515
|
protected readonly hideableColumns: _angular_core.Signal<readonly TableColumn<T>[]>;
|
|
2484
2516
|
protected readonly hasColumnPicker: _angular_core.Signal<boolean>;
|
|
2485
|
-
/** The trailing utility column hosts the picker button and/or row kebabs. */
|
|
2486
2517
|
protected readonly hasUtilityColumn: _angular_core.Signal<boolean>;
|
|
2487
2518
|
protected isColumnVisible(col: TableColumn<T>): boolean;
|
|
2488
2519
|
/** The last visible column can't be hidden — an all-hidden grid is useless. */
|
|
@@ -2497,24 +2528,16 @@ declare class TableComponent<T extends object> {
|
|
|
2497
2528
|
protected readonly filterSearch: _angular_core.WritableSignal<string>;
|
|
2498
2529
|
private readonly headerFilters;
|
|
2499
2530
|
private readonly headerFilterByKey;
|
|
2500
|
-
/** The projected filter for a column, when the host supplied one. */
|
|
2501
2531
|
protected headerFilterFor(col: TableColumn<T>): HeaderFilterDirective | undefined;
|
|
2502
|
-
/** A projected filter makes the column filterable on its own — the host does
|
|
2503
|
-
* not also have to mark it `filter: 'set'` to get the header button. */
|
|
2504
2532
|
protected hasColumnFilter(col: TableColumn<T>): boolean;
|
|
2505
|
-
/** A column is "actively filtered" when at least one of its values is unchecked. */
|
|
2506
2533
|
protected isColumnFiltered(col: TableColumn<T>): boolean;
|
|
2507
|
-
/** The checklist's domain: what the host declared, else what is in hand. */
|
|
2508
2534
|
private optionsFor;
|
|
2509
|
-
/** Distinct values of the open column, narrowed by the popover search box. */
|
|
2510
2535
|
protected readonly filterValues: _angular_core.Signal<readonly string[]>;
|
|
2511
2536
|
protected readonly filterSelectedCount: _angular_core.Signal<number>;
|
|
2512
2537
|
protected isFilterValueChecked(value: string): boolean;
|
|
2513
2538
|
protected onColumnFilterClick(col: TableColumn<T>, event: Event): void;
|
|
2514
2539
|
protected onFilterSearch(event: Event): void;
|
|
2515
2540
|
protected toggleFilterValue(value: string): void;
|
|
2516
|
-
/** Context handed to a projected header filter. Rebuilt per open, which is
|
|
2517
|
-
* cheap and keeps `close` bound to the popover that is actually showing. */
|
|
2518
2541
|
protected headerFilterContext(col: TableColumn<T>): {
|
|
2519
2542
|
$implicit: unknown;
|
|
2520
2543
|
column: unknown;
|
|
@@ -2522,6 +2545,7 @@ declare class TableComponent<T extends object> {
|
|
|
2522
2545
|
};
|
|
2523
2546
|
protected clearColumnFilter(): void;
|
|
2524
2547
|
private readonly injector;
|
|
2548
|
+
private readonly destroyRef;
|
|
2525
2549
|
private readonly editInput;
|
|
2526
2550
|
protected readonly editingCell: _angular_core.WritableSignal<{
|
|
2527
2551
|
rowId: string;
|
|
@@ -2537,9 +2561,8 @@ declare class TableComponent<T extends object> {
|
|
|
2537
2561
|
private static readonly RESIZE_PAGE;
|
|
2538
2562
|
private static readonly MIN_COLUMN_WIDTH;
|
|
2539
2563
|
private resizeState;
|
|
2540
|
-
/**
|
|
2541
|
-
*
|
|
2542
|
-
* class instead, see `fitsContent`. */
|
|
2564
|
+
/** `'content'` is not a pixel value — it is carried by a class instead, see
|
|
2565
|
+
* `fitsContent`. */
|
|
2543
2566
|
protected columnWidth(col: TableColumn<T>): number | null;
|
|
2544
2567
|
/** Shrink-to-content mode, unless the user has dragged this column — a drag is a
|
|
2545
2568
|
* deliberate pixel width and must win over the declared intent. */
|
|
@@ -2558,45 +2581,70 @@ declare class TableComponent<T extends object> {
|
|
|
2558
2581
|
* drag changes one column and leaves the others where they were — the
|
|
2559
2582
|
* auto-sized geometry is kept rather than lost at the first grab.
|
|
2560
2583
|
*
|
|
2561
|
-
*
|
|
2562
|
-
* it reads the header row that is actually on screen rather than assuming a
|
|
2584
|
+
* Reads the header row that is actually on screen rather than assuming a
|
|
2563
2585
|
* column order.
|
|
2564
2586
|
*/
|
|
2565
2587
|
private lockMeasuredWidths;
|
|
2566
2588
|
protected onResizeMove(event: PointerEvent): void;
|
|
2567
2589
|
protected onResizeEnd(): void;
|
|
2568
|
-
|
|
2569
|
-
|
|
2570
|
-
*
|
|
2571
|
-
|
|
2590
|
+
private readonly resizeFocus;
|
|
2591
|
+
/**
|
|
2592
|
+
* The widest a single column may be dragged: the scroll viewport.
|
|
2593
|
+
*
|
|
2594
|
+
* A column wider than the viewport can never be seen whole, and long text has
|
|
2595
|
+
* its own affordance here — `truncate` clips it and the clip popover shows the
|
|
2596
|
+
* rest — so nothing is lost by stopping at the edge. The ceiling exists at all
|
|
2597
|
+
* because `aria-valuemax` has to be TRUE: a focusable `role="separator"` is a
|
|
2598
|
+
* range widget, and announcing a bound that neither resize path applies is
|
|
2599
|
+
* worse than announcing none.
|
|
2600
|
+
*/
|
|
2601
|
+
private columnWidthCeiling;
|
|
2602
|
+
private clampColumnWidth;
|
|
2603
|
+
protected onResizeFocus(col: TableColumn<T>, event: FocusEvent): void;
|
|
2604
|
+
protected onResizeBlur(): void;
|
|
2572
2605
|
/**
|
|
2573
|
-
*
|
|
2574
|
-
*
|
|
2575
|
-
*
|
|
2576
|
-
*
|
|
2606
|
+
* The separator's range, and only while it holds focus — that is when a range
|
|
2607
|
+
* widget is announced, and an auto-sized column has no width to report until
|
|
2608
|
+
* something measures one. Measuring on every change detection to fill an
|
|
2609
|
+
* attribute nothing is reading would force layout once per resizable column.
|
|
2610
|
+
*
|
|
2611
|
+
* `now` prefers `columnWidth`, which the first arrow key makes known and keeps
|
|
2612
|
+
* live; the focus measurement only covers the moment before that.
|
|
2577
2613
|
*/
|
|
2614
|
+
protected resizeRange(col: TableColumn<T>): {
|
|
2615
|
+
now: number;
|
|
2616
|
+
min: number;
|
|
2617
|
+
max: number;
|
|
2618
|
+
} | null;
|
|
2619
|
+
protected resolvedColumnWidth(col: TableColumn<T>, from?: HTMLElement): number;
|
|
2578
2620
|
protected onResizeKey(col: TableColumn<T>, event: KeyboardEvent): void;
|
|
2579
|
-
/**
|
|
2580
|
-
*
|
|
2581
|
-
*
|
|
2621
|
+
/**
|
|
2622
|
+
* The header cell is passed when the caller has it — the column panel does
|
|
2623
|
+
* not, so it is looked up by `data-col-key`, and the measurement matters:
|
|
2624
|
+
* stepping an auto-sized column has to start from what it currently RENDERS,
|
|
2625
|
+
* not from the minimum.
|
|
2626
|
+
*/
|
|
2627
|
+
private stepColumnWidth;
|
|
2628
|
+
private headerCellFor;
|
|
2629
|
+
protected onColumnWidthStep(col: TableColumn<T>, delta: number | 'auto'): void;
|
|
2630
|
+
protected readonly resizeStep = 16;
|
|
2582
2631
|
protected readonly filteredData: _angular_core.Signal<readonly T[]>;
|
|
2583
|
-
/** Client-side sort over the filtered data set — only in `'client'` mode. */
|
|
2584
2632
|
protected readonly sortedData: _angular_core.Signal<readonly T[]>;
|
|
2585
|
-
/** Current page's slice of the sorted rows, when paginating. */
|
|
2586
2633
|
protected readonly pagedData: _angular_core.Signal<readonly T[]>;
|
|
2587
|
-
/**
|
|
2634
|
+
/** Virtual mode windows this further; `rowSlots` is what the loop walks. */
|
|
2588
2635
|
protected readonly displayData: _angular_core.Signal<readonly T[]>;
|
|
2589
2636
|
/**
|
|
2590
2637
|
* The single live-region line. Loading wins while it lasts — a sort
|
|
2591
2638
|
* announcement over rows that are being replaced tells the reader about a
|
|
2592
|
-
* state they cannot inspect yet.
|
|
2593
|
-
* row range, which are the two things a sighted user reads off the header and
|
|
2594
|
-
* the pager and a screen-reader user was told nothing about.
|
|
2639
|
+
* state they cannot inspect yet.
|
|
2595
2640
|
*
|
|
2596
2641
|
* `aria-live="polite"` does not announce a region's INITIAL content, so the
|
|
2597
2642
|
* unsorted first render is silent; only real changes speak.
|
|
2598
2643
|
*/
|
|
2599
2644
|
protected readonly statusMessage: _angular_core.Signal<string>;
|
|
2645
|
+
/** Only from two rows up: a single expander announces itself through its own
|
|
2646
|
+
* `aria-expanded`, and repeating that here would say everything twice. */
|
|
2647
|
+
private readonly expansionMessage;
|
|
2600
2648
|
private readonly sortMessage;
|
|
2601
2649
|
private readonly rangeMessage;
|
|
2602
2650
|
/** Virtual mode needs a bounded scroller to window against. */
|
|
@@ -2608,15 +2656,12 @@ declare class TableComponent<T extends object> {
|
|
|
2608
2656
|
* ones that have arrived — otherwise the spacers shrink to the loaded slice
|
|
2609
2657
|
* and the scrollbar lies about the length of the list. */
|
|
2610
2658
|
protected readonly virtualCount: _angular_core.Signal<number>;
|
|
2611
|
-
/** `null` when not virtualizing — the row loop then walks `displayData()` whole. */
|
|
2612
2659
|
protected readonly virtualWindow: _angular_core.Signal<{
|
|
2613
2660
|
start: number;
|
|
2614
2661
|
end: number;
|
|
2615
2662
|
padTop: number;
|
|
2616
2663
|
padBottom: number;
|
|
2617
2664
|
} | null>;
|
|
2618
|
-
/** The rows the template actually renders. */
|
|
2619
|
-
protected readonly windowData: _angular_core.Signal<readonly T[]>;
|
|
2620
2665
|
/**
|
|
2621
2666
|
* What the row loop walks: each slot carries its ABSOLUTE index, and a `null`
|
|
2622
2667
|
* row is a gap the host has not filled yet.
|
|
@@ -2636,23 +2681,27 @@ declare class TableComponent<T extends object> {
|
|
|
2636
2681
|
protected isStriped(absoluteIndex: number): boolean;
|
|
2637
2682
|
protected readonly allSelected: _angular_core.Signal<boolean>;
|
|
2638
2683
|
protected readonly someSelected: _angular_core.Signal<boolean>;
|
|
2639
|
-
/** Select-all is page-scoped only when paginating. */
|
|
2640
2684
|
protected readonly selectAllLabel: _angular_core.Signal<"Select all rows on this page" | "Select all rows">;
|
|
2685
|
+
protected readonly allExpanded: _angular_core.Signal<boolean>;
|
|
2686
|
+
protected readonly expandAllVisible: _angular_core.Signal<boolean>;
|
|
2687
|
+
protected readonly expandAllLabel: _angular_core.Signal<string>;
|
|
2641
2688
|
protected readonly skeletonArray: _angular_core.Signal<any[]>;
|
|
2642
|
-
/** Total colspan for the expanded-row panel: data cols + optional select/expand/actions cols. */
|
|
2643
2689
|
protected readonly expandedColspan: _angular_core.Signal<number>;
|
|
2644
2690
|
protected readonly hasRowActions: _angular_core.Signal<boolean>;
|
|
2645
|
-
/** Row whose kebab menu is open — drives the per-row `disabled` predicates. */
|
|
2646
2691
|
protected readonly menuRow: _angular_core.WritableSignal<T | null>;
|
|
2647
2692
|
private readonly rowMenuPopover;
|
|
2648
2693
|
private readonly columnPickerPopover;
|
|
2694
|
+
protected readonly columnSheetOpen: _angular_core.WritableSignal<boolean>;
|
|
2695
|
+
private readonly coarsePointerState;
|
|
2696
|
+
/** Whether the column panel opens as a sheet and the drag handle stands down.
|
|
2697
|
+
* Keyed on the pointer, not the viewport — see the matching media query in
|
|
2698
|
+
* `table.component.scss`. */
|
|
2699
|
+
protected readonly coarsePointer: _angular_core.Signal<boolean>;
|
|
2649
2700
|
protected readonly columnPickerOpened: _angular_core.Signal<boolean>;
|
|
2650
2701
|
protected onColumnPickerClick(event: Event): void;
|
|
2651
2702
|
protected readonly hasTruncate: _angular_core.Signal<boolean>;
|
|
2652
2703
|
private readonly cellTextPopover;
|
|
2653
2704
|
protected readonly cellPopoverText: _angular_core.WritableSignal<string>;
|
|
2654
|
-
/** Click on a `truncate` cell: when the text is actually clipped, show the
|
|
2655
|
-
* full value in a popover; otherwise let the click fall through to the row. */
|
|
2656
2705
|
protected onCellClipClick(row: T, col: TableColumn<T>, event: Event): void;
|
|
2657
2706
|
/** Clipped horizontally — itself or anything it renders. A `dsCellTemplate`
|
|
2658
2707
|
* puts the ellipsis on a descendant, so testing only the wrapper misses it. */
|
|
@@ -2687,6 +2736,7 @@ declare class TableComponent<T extends object> {
|
|
|
2687
2736
|
protected onRowAction(action: TableRowAction<T>): void;
|
|
2688
2737
|
protected isExpanded(row: T): boolean;
|
|
2689
2738
|
protected onToggleExpand(row: T, event: Event): void;
|
|
2739
|
+
protected onToggleExpandAll(): void;
|
|
2690
2740
|
protected isSelected(row: T): boolean;
|
|
2691
2741
|
protected onToggleAll(event: Event): void;
|
|
2692
2742
|
protected onToggleRow(row: T, event: Event): void;
|
|
@@ -2694,13 +2744,10 @@ declare class TableComponent<T extends object> {
|
|
|
2694
2744
|
protected onRowMousedown(): void;
|
|
2695
2745
|
protected onRowClick(row: T, event: Event): void;
|
|
2696
2746
|
protected onRowKey(row: T, event: Event): void;
|
|
2697
|
-
/** Accessible name for an interactive row, taken from the first visible column. */
|
|
2698
2747
|
protected rowAriaLabel(row: T): string;
|
|
2699
|
-
/** `aria-sort` value for a header: only meaningful on sortable columns. */
|
|
2700
2748
|
/** Row identity — the `rowId` accessor when given, else `row.id`. Public so a
|
|
2701
2749
|
* host reading `selectedIds`/`expandedIds` can compute the same keys. */
|
|
2702
2750
|
rowKey(row: T): string;
|
|
2703
|
-
/** Whether this column's header is an actual sort control right now. */
|
|
2704
2751
|
protected sortableCol(col: TableColumn<T>): boolean;
|
|
2705
2752
|
protected ariaSort(col: TableColumn<T>): 'ascending' | 'descending' | 'none' | null;
|
|
2706
2753
|
protected onSort(col: TableColumn<T>): void;
|
|
@@ -2727,10 +2774,11 @@ declare class TableComponent<T extends object> {
|
|
|
2727
2774
|
* revoked — a URL the caller supplied is theirs to manage. */
|
|
2728
2775
|
private downloadFile;
|
|
2729
2776
|
/** Deterministic per-cell width so skeleton rows look organic but stable
|
|
2730
|
-
* across re-renders.
|
|
2777
|
+
* across re-renders. */
|
|
2731
2778
|
protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
|
|
2779
|
+
private watchPointer;
|
|
2732
2780
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
|
|
2733
|
-
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>;
|
|
2781
|
+
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>;
|
|
2734
2782
|
}
|
|
2735
2783
|
|
|
2736
2784
|
declare class PaginationComponent {
|
|
@@ -2924,7 +2972,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
2924
2972
|
readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
|
|
2925
2973
|
/** Accessible name when no visible `label` is provided. */
|
|
2926
2974
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
2927
|
-
/**
|
|
2975
|
+
/** Lower bound for the year dropdown in the calendar header. */
|
|
2928
2976
|
readonly minYear: _angular_core.InputSignal<number>;
|
|
2929
2977
|
/** Upper bound for the year dropdown in the calendar header. */
|
|
2930
2978
|
readonly maxYear: _angular_core.InputSignal<number>;
|
|
@@ -2946,7 +2994,8 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
2946
2994
|
* the panel shows its month and grid focus lands on its exact day.
|
|
2947
2995
|
* Never written to `value` — selection stays with the user. */
|
|
2948
2996
|
readonly defaultDate: _angular_core.InputSignal<Date | null>;
|
|
2949
|
-
/** Allow masked manual typing. When false the
|
|
2997
|
+
/** Allow masked manual typing. When false the field is read-only and a date can
|
|
2998
|
+
* only be picked from the calendar. */
|
|
2950
2999
|
readonly allowInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
2951
3000
|
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
2952
3001
|
protected readonly hintId: _angular_core.Signal<string | null>;
|
|
@@ -2959,13 +3008,10 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
2959
3008
|
readonly resolvedLocale: _angular_core.Signal<string>;
|
|
2960
3009
|
protected readonly resolvedFirstDay: _angular_core.Signal<number>;
|
|
2961
3010
|
protected readonly formatSpec: _angular_core.Signal<DateFormatSpec>;
|
|
2962
|
-
/** Slot/literal layout for the current mode — single date or doubled range. */
|
|
2963
3011
|
protected readonly layout: _angular_core.Signal<FieldLayout>;
|
|
2964
3012
|
protected readonly monthNames: _angular_core.Signal<string[]>;
|
|
2965
3013
|
protected readonly weekdays: _angular_core.Signal<string[]>;
|
|
2966
|
-
/** Full weekday names for the grid column headers' accessible names. */
|
|
2967
3014
|
protected readonly weekdaysFull: _angular_core.Signal<string[]>;
|
|
2968
|
-
/** Localized "Month YYYY" caption — the grid's accessible name + live label. */
|
|
2969
3015
|
protected readonly monthYearLabel: _angular_core.Signal<string>;
|
|
2970
3016
|
protected readonly uid: string;
|
|
2971
3017
|
protected readonly labelId: string;
|
|
@@ -2988,7 +3034,6 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
2988
3034
|
private addMonths;
|
|
2989
3035
|
private clampToBounds;
|
|
2990
3036
|
private focusGridDay;
|
|
2991
|
-
/** Full, unambiguous date for a day cell's accessible name. */
|
|
2992
3037
|
protected dayLabel(cell: DayCell): string;
|
|
2993
3038
|
protected readonly triggerClasses: _angular_core.Signal<string>;
|
|
2994
3039
|
protected readonly viewMonth: _angular_core.WritableSignal<Date>;
|
|
@@ -2997,9 +3042,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
2997
3042
|
protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
|
|
2998
3043
|
private overlayRef;
|
|
2999
3044
|
private focusTrigger;
|
|
3000
|
-
/** Text shown in the field: masked single value, or the combined range string. */
|
|
3001
3045
|
protected readonly fieldText: _angular_core.Signal<string>;
|
|
3002
|
-
/** Format-mask placeholder (single) or the doubled range mask. */
|
|
3003
3046
|
protected readonly fieldPlaceholder: _angular_core.Signal<string>;
|
|
3004
3047
|
/** `size` attribute so the field hugs its mask width instead of stretching.
|
|
3005
3048
|
* +1 covers `size` under-counting the mask's wide glyphs (M/D/Y), which
|
|
@@ -3007,14 +3050,11 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3007
3050
|
* `font-family: var(--font-mono)` keeps every glyph equal width, so the
|
|
3008
3051
|
* width never shifts as you type. */
|
|
3009
3052
|
protected readonly fieldSize: _angular_core.Signal<number>;
|
|
3010
|
-
/** Per-slot overlay runs: digits at normal weight, unfilled positions
|
|
3011
|
-
* (format letters or `_` padding) muted — see displayParts(). */
|
|
3012
3053
|
protected readonly displaySlots: _angular_core.Signal<DisplayPart[]>;
|
|
3013
3054
|
protected readonly monthMenuOpen: _angular_core.WritableSignal<boolean>;
|
|
3014
3055
|
protected readonly yearMenuOpen: _angular_core.WritableSignal<boolean>;
|
|
3015
3056
|
protected readonly viewMonthIndex: _angular_core.Signal<number>;
|
|
3016
3057
|
protected readonly viewYear: _angular_core.Signal<number>;
|
|
3017
|
-
/** First year shown in the year grid; paged by YEAR_PAGE_SIZE within [minYear, maxYear]. */
|
|
3018
3058
|
protected readonly yearPageStart: _angular_core.WritableSignal<number>;
|
|
3019
3059
|
protected readonly yearsOnPage: _angular_core.Signal<number[]>;
|
|
3020
3060
|
protected readonly yearRangeLabel: _angular_core.Signal<string>;
|
|
@@ -3031,7 +3071,6 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3031
3071
|
protected selectYear(year: number, event: Event): void;
|
|
3032
3072
|
protected isDayDisabled(date: Date): boolean;
|
|
3033
3073
|
protected readonly daysGrid: _angular_core.Signal<DayCell[]>;
|
|
3034
|
-
/** daysGrid split into rows of 7 for the grid's `role="row"` structure. */
|
|
3035
3074
|
protected readonly weeksGrid: _angular_core.Signal<DayCell[][]>;
|
|
3036
3075
|
private getRangeContext;
|
|
3037
3076
|
protected open(moveFocusToGrid?: boolean): void;
|
|
@@ -3040,17 +3079,15 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3040
3079
|
/**
|
|
3041
3080
|
* Also the calendar glyph's handler. A POINTER open must not drag focus into
|
|
3042
3081
|
* the day grid: the reader did not ask to leave a field they may want to type
|
|
3043
|
-
* in
|
|
3044
|
-
*
|
|
3045
|
-
*
|
|
3046
|
-
* calls `open(true)` and enters the grid however the panel was opened.
|
|
3082
|
+
* in. So focus follows what the field IS — typeable, and the caret stays;
|
|
3083
|
+
* read-only, and the grid is the only thing worth focusing. The keyboard path is
|
|
3084
|
+
* unaffected: ArrowDown on the field calls `open(true)`.
|
|
3047
3085
|
*/
|
|
3048
3086
|
protected onFieldClick(): void;
|
|
3049
3087
|
private mobileEdit;
|
|
3050
3088
|
protected onFieldInput(event: Event): void;
|
|
3051
3089
|
/** Physical-keyboard editing (desktop): typed digits fill the caret's slot;
|
|
3052
|
-
* Backspace/Delete never shift digits across a separator.
|
|
3053
|
-
* shared segment editor. */
|
|
3090
|
+
* Backspace/Delete never shift digits across a separator. */
|
|
3054
3091
|
protected onFieldKeydown(event: KeyboardEvent): void;
|
|
3055
3092
|
/** Mobile keyboards don't fire a reliable `keydown` (Gboard reports keyCode 229 /
|
|
3056
3093
|
* "Unidentified"), so edits are routed here via `beforeinput`'s `inputType` instead.
|
|
@@ -3058,33 +3095,28 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3058
3095
|
* stashed and re-asserted in `onFieldInput`; the microtask expires the stash once
|
|
3059
3096
|
* preventDefault worked (no following `input` in the same task). */
|
|
3060
3097
|
protected onFieldBeforeInput(event: InputEvent): void;
|
|
3061
|
-
/**
|
|
3062
|
-
*
|
|
3063
|
-
* selection is cleared through the model so `_` placeholders are never
|
|
3064
|
-
* natively erased — only digits are editable. Shared by keydown + beforeinput. */
|
|
3098
|
+
/** A selection is cleared through the model so `_` placeholders are never
|
|
3099
|
+
* natively erased — only digits are editable. */
|
|
3065
3100
|
private runSegmentEdit;
|
|
3066
3101
|
/** Paste digits into the segment model at the caret slot — never a global
|
|
3067
3102
|
* flatten — so existing digits elsewhere in the field survive untouched. */
|
|
3068
3103
|
protected onFieldPaste(event: ClipboardEvent): void;
|
|
3069
3104
|
private countDigits;
|
|
3070
|
-
/**
|
|
3071
|
-
*
|
|
3072
|
-
*
|
|
3073
|
-
* empty when no digits remain. */
|
|
3105
|
+
/** The fallback for any `input` event with no preceding handled `beforeinput`
|
|
3106
|
+
* (IME, autofill, a suggestion): `raw` is re-read as a flat digit stream and
|
|
3107
|
+
* redistributed over the slots, since its own layout cannot be trusted. */
|
|
3074
3108
|
private commitRaw;
|
|
3075
|
-
/** Write masked text + caret into the DOM, then parse and validate it. */
|
|
3076
3109
|
private applyEditedText;
|
|
3077
3110
|
protected onFieldBlur(): void;
|
|
3078
|
-
/**
|
|
3079
|
-
*
|
|
3080
|
-
*
|
|
3081
|
-
* the same string, which leaves the caret untouched. */
|
|
3111
|
+
/** Writing `value` parks the caret at the end, so the explicit range has to
|
|
3112
|
+
* follow it; the later `[value]` binding writes the same string, which leaves
|
|
3113
|
+
* the caret untouched. */
|
|
3082
3114
|
private writeBackText;
|
|
3083
|
-
/** Caret just past the last digit
|
|
3084
|
-
*
|
|
3085
|
-
* once every slot is full. Empty segments naturally resolve to 0. */
|
|
3115
|
+
/** Caret just past the last digit a flat digit stream filled — the first slot
|
|
3116
|
+
* short of its max length, or the very end once every slot is full. */
|
|
3086
3117
|
private caretAfterFill;
|
|
3087
|
-
/**
|
|
3118
|
+
/** `commit` is the blur pass: only then is the field text rewritten from the
|
|
3119
|
+
* parsed value, and a half-filled range written through to `value`. */
|
|
3088
3120
|
private applyRangeText;
|
|
3089
3121
|
protected prevMonth(): void;
|
|
3090
3122
|
protected nextMonth(): void;
|
|
@@ -4062,6 +4094,10 @@ interface ToastEntry {
|
|
|
4062
4094
|
readonly variant: ToastVariant;
|
|
4063
4095
|
readonly dismissible: boolean;
|
|
4064
4096
|
readonly action?: ToastAction;
|
|
4097
|
+
/** Auto-dismiss delay, counted from the moment the toast becomes VISIBLE — a
|
|
4098
|
+
* queued toast must not expire while it is still waiting behind the cap.
|
|
4099
|
+
* 0 = indefinite. */
|
|
4100
|
+
readonly durationMs: number;
|
|
4065
4101
|
}
|
|
4066
4102
|
interface ToastPromiseMessages {
|
|
4067
4103
|
readonly loading: string;
|
|
@@ -4084,8 +4120,13 @@ declare class ToastService {
|
|
|
4084
4120
|
private regionRef;
|
|
4085
4121
|
private nextId;
|
|
4086
4122
|
show(opts: ToastOptions): ToastRef;
|
|
4087
|
-
/** Show a loading toast for the duration of `
|
|
4088
|
-
* reflected in-place (same toast, no stack-up) as success/error variants
|
|
4123
|
+
/** Show a loading toast for the duration of `source`. Resolution and rejection are
|
|
4124
|
+
* reflected in-place (same toast, no stack-up) as success/error variants, each with
|
|
4125
|
+
* its own auto-dismiss delay.
|
|
4126
|
+
*
|
|
4127
|
+
* Returns `source` itself, so the caller still owns rejection handling — an
|
|
4128
|
+
* un-`catch`ed call produces an unhandled rejection exactly as it would without a
|
|
4129
|
+
* toast. */
|
|
4089
4130
|
promise<T>(source: Promise<T>, messages: ToastPromiseMessages): Promise<T>;
|
|
4090
4131
|
dismissAll(): void;
|
|
4091
4132
|
private ensureRegion;
|
|
@@ -4101,9 +4142,38 @@ declare class ToastRegionComponent {
|
|
|
4101
4142
|
protected readonly visibleEntries: _angular_core.WritableSignal<readonly ToastEntry[]>;
|
|
4102
4143
|
protected readonly leaving: _angular_core.WritableSignal<ReadonlySet<number>>;
|
|
4103
4144
|
private readonly pendingQueue;
|
|
4145
|
+
private readonly timers;
|
|
4146
|
+
private readonly remaining;
|
|
4147
|
+
private readonly startedAt;
|
|
4148
|
+
private hovered;
|
|
4149
|
+
private focusWithin;
|
|
4150
|
+
private readonly host;
|
|
4151
|
+
private readonly position;
|
|
4152
|
+
/** Newest goes NEAREST the anchor, so the toast that just fired appears where the
|
|
4153
|
+
* stack is pinned rather than at the far end of a list the reader has to hunt
|
|
4154
|
+
* down. DOM order is the visual order, so this also keeps the reading order. */
|
|
4155
|
+
private readonly newestFirst;
|
|
4104
4156
|
add(entry: ToastEntry): void;
|
|
4105
|
-
|
|
4106
|
-
|
|
4157
|
+
private show;
|
|
4158
|
+
private arm;
|
|
4159
|
+
private clearCountdown;
|
|
4160
|
+
/** A toast holding the pointer or the keyboard is being read or acted on, so its
|
|
4161
|
+
* clock stops. Without this the only control for an `action` can be destroyed
|
|
4162
|
+
* while the user is reaching for it — and the region sits last in tab order, so
|
|
4163
|
+
* reaching it takes longer than the default five seconds on any real page. */
|
|
4164
|
+
protected onHover(entered: boolean): void;
|
|
4165
|
+
protected onFocusWithin(event: FocusEvent | true): void;
|
|
4166
|
+
private syncPause;
|
|
4167
|
+
private get paused();
|
|
4168
|
+
private pauseAll;
|
|
4169
|
+
private resumeAll;
|
|
4170
|
+
/** Replace fields of an already-visible or queued toast in place.
|
|
4171
|
+
*
|
|
4172
|
+
* Patching `durationMs` restarts the clock, and for a QUEUED toast it only takes
|
|
4173
|
+
* effect on promotion — which is the whole point: `promise()` patches a loading
|
|
4174
|
+
* toast (duration 0) into a settled one, and if that toast is still behind the cap
|
|
4175
|
+
* its new duration must not start burning down while it is invisible. */
|
|
4176
|
+
update(id: number, patch: Partial<Pick<ToastEntry, 'body' | 'title' | 'variant' | 'dismissible' | 'action' | 'durationMs'>>): void;
|
|
4107
4177
|
remove(id: number): void;
|
|
4108
4178
|
protected isLeaving(id: number): boolean;
|
|
4109
4179
|
clear(): void;
|
|
@@ -4347,6 +4417,51 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4347
4417
|
readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4348
4418
|
/** Field label above the control — the same meaning it has on the other two pickers. */
|
|
4349
4419
|
readonly label: _angular_core.InputSignal<string>;
|
|
4420
|
+
/** How two values are decided to be the same one. The default is `===`, which
|
|
4421
|
+
* is reference identity — so with object values a re-fetch that returns equal
|
|
4422
|
+
* data as NEW objects loses the selection. Pass a comparator keyed on whatever
|
|
4423
|
+
* identifies the value: `(a, b) => a?.id === b?.id`. */
|
|
4424
|
+
readonly compareWith: _angular_core.InputSignal<(a: T | null, b: T | null) => boolean>;
|
|
4425
|
+
/** Native `name` attribute forwarded to the trigger. */
|
|
4426
|
+
readonly name: _angular_core.InputSignal<string | null>;
|
|
4427
|
+
/** Prevents opening the panel while still allowing focus. */
|
|
4428
|
+
readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4429
|
+
/**
|
|
4430
|
+
* The contract spelling of `readOnly`, a second input because signal forms binds
|
|
4431
|
+
* by NAME — a `readonly()` rule was reaching nothing before this existed.
|
|
4432
|
+
*/
|
|
4433
|
+
readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4434
|
+
/** Shows a clear affordance once there is something to clear. */
|
|
4435
|
+
readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4436
|
+
/** Placeholder while the field is being typed in, when a value is already
|
|
4437
|
+
* settled — `placeholder` is the empty-field caption and cannot be both.
|
|
4438
|
+
* Empty (the default) keeps `placeholder` doing both jobs, as before. */
|
|
4439
|
+
readonly searchPlaceholder: _angular_core.InputSignal<string>;
|
|
4440
|
+
/** How the typed query narrows the list.
|
|
4441
|
+
*
|
|
4442
|
+
* The default matches a case-insensitive substring of `label`. Pass a predicate
|
|
4443
|
+
* to match on anything else — a second field, ignoring diacritics, a fuzzy score.
|
|
4444
|
+
* Pass `'none'` when the list arrives already filtered, which is what a
|
|
4445
|
+
* server-side search needs: the query is reported through `filterChange` and
|
|
4446
|
+
* every option given is rendered.
|
|
4447
|
+
*/
|
|
4448
|
+
readonly filterWith: _angular_core.InputSignal<"none" | ((option: AutocompleteOption<T>, query: string) => boolean)>;
|
|
4449
|
+
/** The query the user typed, on every change. The input for a server-side search;
|
|
4450
|
+
* pair it with `filterWith="none"` so the list is not narrowed twice. */
|
|
4451
|
+
readonly filterChange: _angular_core.OutputEmitterRef<string>;
|
|
4452
|
+
/** Options are still being fetched. The panel shows a spinner instead of the
|
|
4453
|
+
* empty row — which would otherwise claim there are no matches — and the list
|
|
4454
|
+
* reports `aria-busy`. */
|
|
4455
|
+
readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4456
|
+
/** The panel opened. The moment to fetch options for a picker whose list is
|
|
4457
|
+
* loaded on demand. */
|
|
4458
|
+
readonly opened: _angular_core.OutputEmitterRef<void>;
|
|
4459
|
+
/** The panel closed, for any reason — a pick, Escape, an outside click, a scroll. */
|
|
4460
|
+
readonly closed: _angular_core.OutputEmitterRef<void>;
|
|
4461
|
+
/** Scrolls the keyboard cursor's row into view. On by default: a list longer
|
|
4462
|
+
* than the panel otherwise walks the cursor out of sight. Set `false` only if
|
|
4463
|
+
* you are driving the scroll position yourself. */
|
|
4464
|
+
readonly scrollActiveIntoView: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4350
4465
|
/** Marks the field required: a `*` beside the label and `aria-required` on the input. */
|
|
4351
4466
|
readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4352
4467
|
/** Marks the field optional in words, for a form where most fields are required. */
|
|
@@ -4364,6 +4479,9 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4364
4479
|
protected readonly optionTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4365
4480
|
protected readonly chipTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4366
4481
|
protected readonly pickerTrigger: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4482
|
+
protected readonly panelHeaderTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4483
|
+
protected readonly panelFooterTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4484
|
+
protected readonly groupLabelTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4367
4485
|
protected readonly emptyTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4368
4486
|
protected readonly createTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4369
4487
|
protected readonly query: _angular_core.WritableSignal<string>;
|
|
@@ -4383,9 +4501,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4383
4501
|
protected readonly filteredItems: _angular_core.Signal<AutocompleteItem<T>[]>;
|
|
4384
4502
|
protected readonly filteredOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
|
|
4385
4503
|
protected isGroup(item: AutocompleteItem<T>): item is AutocompleteOptionGroup<T>;
|
|
4386
|
-
/** Whether to show the "Create «text»" row at the bottom of the panel. */
|
|
4387
4504
|
protected readonly showCreateRow: _angular_core.Signal<boolean>;
|
|
4388
|
-
/** Flat list of visible options used for keyboard navigation index. */
|
|
4389
4505
|
protected readonly visibleOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
|
|
4390
4506
|
/** The visible label wins the accessible name when there is one — otherwise the
|
|
4391
4507
|
* placeholder would announce over it, and `placeholder` always carries a default. */
|
|
@@ -4393,14 +4509,13 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4393
4509
|
protected readonly selectedTags: _angular_core.Signal<AutocompleteOption<T>[]>;
|
|
4394
4510
|
private readonly chipsMode;
|
|
4395
4511
|
private readonly showsEveryChip;
|
|
4396
|
-
/** True for
|
|
4397
|
-
*
|
|
4512
|
+
/** True for a number as well as `'fit'`: a number is a ceiling, not a promise,
|
|
4513
|
+
* so the row still measures. */
|
|
4398
4514
|
protected readonly fitsChipsToWidth: _angular_core.Signal<boolean>;
|
|
4399
|
-
/** How many chips the row is ASKED to render before measuring
|
|
4400
|
-
*
|
|
4401
|
-
*
|
|
4402
|
-
*
|
|
4403
|
-
* never fills, and the fit fell back to "show them all" without a word. */
|
|
4515
|
+
/** How many chips the row is ASKED to render before measuring. It has to be the
|
|
4516
|
+
* ceiling and not the selection: the measurement caches chip widths from a
|
|
4517
|
+
* render that holds them all, so with a numeric cap that render never happens,
|
|
4518
|
+
* the cache never fills, and the fit silently falls back to showing them all. */
|
|
4404
4519
|
private readonly chipBudget;
|
|
4405
4520
|
private readonly chipsThatFit;
|
|
4406
4521
|
/** What the trigger renders. Separate from `selectedTags`, which stays the
|
|
@@ -4415,29 +4530,34 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4415
4530
|
protected readonly placeholderText: _angular_core.Signal<string>;
|
|
4416
4531
|
protected isSelected(option: AutocompleteOption<T>): boolean;
|
|
4417
4532
|
protected optionClass(option: AutocompleteOption<T>): string;
|
|
4418
|
-
/**
|
|
4419
|
-
* every option is disabled. */
|
|
4533
|
+
/** -1 when nothing is pickable and there is no create row to fall back on. */
|
|
4420
4534
|
private firstEnabledIndex;
|
|
4421
|
-
/**
|
|
4422
|
-
* row
|
|
4423
|
-
*
|
|
4424
|
-
* reachable. Returns -1 when every option is disabled. */
|
|
4535
|
+
/** Steps OVER a disabled option rather than landing on it. `step` is +1/-1; the
|
|
4536
|
+
* create row (past the last option) is always reachable, and -1 comes back when
|
|
4537
|
+
* every option is disabled. */
|
|
4425
4538
|
private nextEnabledIndex;
|
|
4426
|
-
/** Flat index of the given option within the visible (filtered) list. */
|
|
4427
4539
|
protected flatIndexOf(option: AutocompleteOption<T>): number;
|
|
4540
|
+
constructor();
|
|
4541
|
+
private setOpen;
|
|
4542
|
+
protected readonly isReadOnly: _angular_core.Signal<boolean>;
|
|
4543
|
+
protected readonly cursorFromKeyboard: _angular_core.WritableSignal<boolean>;
|
|
4544
|
+
/** How far PageUp and PageDown move. Ten rows is the native `<select>` step and
|
|
4545
|
+
* the APG listbox example's — a fixed number rather than a measured screenful,
|
|
4546
|
+
* so the jump is the same wherever the panel happens to be clipped. */
|
|
4547
|
+
private static readonly pageStep;
|
|
4548
|
+
private cursorList;
|
|
4428
4549
|
protected onTriggerClick(): void;
|
|
4429
4550
|
protected togglePanel(event: MouseEvent): void;
|
|
4430
4551
|
protected onKeydown(event: KeyboardEvent): void;
|
|
4431
4552
|
protected openPanel(): void;
|
|
4432
4553
|
protected close(cause?: DsOverlayCloseCause): void;
|
|
4554
|
+
protected clearValue(event: MouseEvent): void;
|
|
4433
4555
|
/**
|
|
4434
4556
|
* Empties the field — both the selected value and the text the user typed.
|
|
4435
4557
|
*
|
|
4436
4558
|
* `value.set(null)` alone is not enough from outside: the typed query is
|
|
4437
4559
|
* component state with no input bound to it, so the text stays on screen after
|
|
4438
|
-
* the value goes.
|
|
4439
|
-
* ends up querying the inner `<input>` and dispatching a synthetic `input`
|
|
4440
|
-
* event.
|
|
4560
|
+
* the value goes.
|
|
4441
4561
|
*
|
|
4442
4562
|
* Deliberately does NOT move focus — the caller may be navigating away, and
|
|
4443
4563
|
* stealing focus back into a field they just left is worse than leaving it.
|
|
@@ -4449,7 +4569,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4449
4569
|
protected onCreateNew(): void;
|
|
4450
4570
|
protected remove(target: T): void;
|
|
4451
4571
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent<any>, never>;
|
|
4452
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showChevron": { "alias": "showChevron"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "valueOverflow": { "alias": "valueOverflow"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "create": "create"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "emptyTemplate", "createTemplate"], ["[dsAutocompletePrefix]", "[dsAutocompleteSuffix]"], true, never>;
|
|
4572
|
+
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>;
|
|
4453
4573
|
}
|
|
4454
4574
|
|
|
4455
4575
|
type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
|
|
@@ -4744,8 +4864,20 @@ declare class LoadingOverlayComponent {
|
|
|
4744
4864
|
readonly spinnerSize: _angular_core.InputSignal<DsSize>;
|
|
4745
4865
|
/** Offset the scrim top edge — useful when a sticky header should stay uncovered. */
|
|
4746
4866
|
readonly insetTop: _angular_core.InputSignal<string>;
|
|
4867
|
+
/**
|
|
4868
|
+
* Whether the projected content goes `inert` while the scrim is up. On by
|
|
4869
|
+
* default, because a scrim that only stops the POINTER is the bug this exists
|
|
4870
|
+
* to prevent: focus walks straight under it, and a keyboard user activates a
|
|
4871
|
+
* control the mouse cannot even reach.
|
|
4872
|
+
*
|
|
4873
|
+
* Turn it off only when the scrim covers part of the content (`insetTop`), and
|
|
4874
|
+
* then mark the covered subtree `inert` yourself — a blanket flag would take
|
|
4875
|
+
* the uncovered part with it. `ds-table` does exactly that: the scrim starts
|
|
4876
|
+
* below the header, so sorting during a refresh stays possible.
|
|
4877
|
+
*/
|
|
4878
|
+
readonly inertContent: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4747
4879
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<LoadingOverlayComponent, never>;
|
|
4748
|
-
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>;
|
|
4880
|
+
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>;
|
|
4749
4881
|
}
|
|
4750
4882
|
|
|
4751
4883
|
interface TreeNode {
|
|
@@ -4890,6 +5022,42 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
4890
5022
|
* Enter, Escape and `aria-activedescendant` are the filter input's today. */
|
|
4891
5023
|
readonly searchable: _angular_core.InputSignalWithTransform<number | boolean | null, unknown>;
|
|
4892
5024
|
readonly searchableResolved: _angular_core.Signal<number | boolean>;
|
|
5025
|
+
/** Native `name` attribute forwarded to the trigger. */
|
|
5026
|
+
readonly name: _angular_core.InputSignal<string | null>;
|
|
5027
|
+
/** Prevents opening the panel while still allowing focus. */
|
|
5028
|
+
readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
5029
|
+
/**
|
|
5030
|
+
* The contract spelling of `readOnly`, a second input because signal forms binds
|
|
5031
|
+
* by NAME — a `readonly()` rule was reaching nothing before this existed.
|
|
5032
|
+
*/
|
|
5033
|
+
readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
5034
|
+
/** Shows a clear affordance once there is something to clear. */
|
|
5035
|
+
readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
5036
|
+
/** How the typed query narrows the list.
|
|
5037
|
+
*
|
|
5038
|
+
* The default matches a case-insensitive substring of `label`. Pass a predicate
|
|
5039
|
+
* to match on anything else — a second field, ignoring diacritics, a fuzzy score.
|
|
5040
|
+
* Pass `'none'` when the list arrives already filtered, which is what a
|
|
5041
|
+
* server-side search needs: the query is reported through `filterChange` and
|
|
5042
|
+
* every option given is rendered.
|
|
5043
|
+
*/
|
|
5044
|
+
readonly filterWith: _angular_core.InputSignal<"none" | ((option: MultiSelectOption, query: string) => boolean)>;
|
|
5045
|
+
/** The query the user typed, on every change. The input for a server-side search;
|
|
5046
|
+
* pair it with `filterWith="none"` so the list is not narrowed twice. */
|
|
5047
|
+
readonly filterChange: _angular_core.OutputEmitterRef<string>;
|
|
5048
|
+
/** Options are still being fetched. The panel shows a spinner instead of the
|
|
5049
|
+
* empty row — which would otherwise claim there are no matches — and the list
|
|
5050
|
+
* reports `aria-busy`. */
|
|
5051
|
+
readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
5052
|
+
/** The panel opened. The moment to fetch options for a picker whose list is
|
|
5053
|
+
* loaded on demand. */
|
|
5054
|
+
readonly opened: _angular_core.OutputEmitterRef<void>;
|
|
5055
|
+
/** The panel closed, for any reason — a pick, Escape, an outside click, a scroll. */
|
|
5056
|
+
readonly closed: _angular_core.OutputEmitterRef<void>;
|
|
5057
|
+
/** Scrolls the keyboard cursor's row into view. On by default: a list longer
|
|
5058
|
+
* than the panel otherwise walks the cursor out of sight. Set `false` only if
|
|
5059
|
+
* you are driving the scroll position yourself. */
|
|
5060
|
+
readonly scrollActiveIntoView: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4893
5061
|
/** How the chips collapse when they outgrow one line. `"fit"` (the default)
|
|
4894
5062
|
* measures and shows as many as the trigger is wide, the rest behind "+N more".
|
|
4895
5063
|
* A NUMBER is a CEILING, not a promise: the row still measures, so you get at
|
|
@@ -4933,6 +5101,9 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
4933
5101
|
protected readonly optionTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4934
5102
|
protected readonly chipTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4935
5103
|
protected readonly pickerTrigger: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
5104
|
+
protected readonly panelHeaderTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
5105
|
+
protected readonly panelFooterTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
5106
|
+
protected readonly groupLabelTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4936
5107
|
protected readonly emptyTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
|
|
4937
5108
|
protected readonly uid: string;
|
|
4938
5109
|
protected readonly listboxId: string;
|
|
@@ -4957,17 +5128,12 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
4957
5128
|
protected readonly selectedOptions: _angular_core.Signal<MultiSelectOption[]>;
|
|
4958
5129
|
private readonly chipsMode;
|
|
4959
5130
|
private readonly showsEveryChip;
|
|
4960
|
-
/** True for BOTH `'fit'` and a number: a number is a ceiling, not a promise
|
|
4961
|
-
*
|
|
4962
|
-
* wide enough for. Without that, a phone-width trigger honoured the count and
|
|
4963
|
-
* wrapped the text input onto a second line, which is the one thing the cap
|
|
4964
|
-
* exists to prevent. */
|
|
5131
|
+
/** True for BOTH `'fit'` and a number: a number is a ceiling, not a promise, so
|
|
5132
|
+
* the row still measures and shows only what the trigger is wide enough for. */
|
|
4965
5133
|
protected readonly fitsChipsToWidth: _angular_core.Signal<boolean>;
|
|
4966
5134
|
/** How many chips the row is ASKED to render before measuring: everything for
|
|
4967
|
-
* `'fit'`, the ceiling for a number. It
|
|
4968
|
-
*
|
|
4969
|
-
* holds them all — with a numeric cap that render never happens, the cache
|
|
4970
|
-
* never fills, and the fit fell back to "show them all" without a word. */
|
|
5135
|
+
* `'fit'`, the ceiling for a number. It must be the ceiling and not the selection —
|
|
5136
|
+
* the width cache only fills from a render that holds every chip. */
|
|
4971
5137
|
private readonly chipBudget;
|
|
4972
5138
|
private readonly chipsThatFit;
|
|
4973
5139
|
protected readonly visibleChips: _angular_core.Signal<MultiSelectOption[]>;
|
|
@@ -4998,17 +5164,35 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
4998
5164
|
protected toggleSelectAll(): void;
|
|
4999
5165
|
protected isSelected(value: string): boolean;
|
|
5000
5166
|
protected toggleValue(option: MultiSelectOption): void;
|
|
5167
|
+
protected clearValue(event: MouseEvent): void;
|
|
5168
|
+
/**
|
|
5169
|
+
* Empties the selection from outside — a "reset filters" button, a form the app
|
|
5170
|
+
* clears itself. Deliberately does NOT move focus: the caller may be navigating
|
|
5171
|
+
* away.
|
|
5172
|
+
*/
|
|
5173
|
+
clear(): void;
|
|
5001
5174
|
protected removeValue(value: string): void;
|
|
5175
|
+
constructor();
|
|
5002
5176
|
protected onFilter(event: Event): void;
|
|
5177
|
+
private setOpen;
|
|
5178
|
+
protected readonly isReadOnly: _angular_core.Signal<boolean>;
|
|
5179
|
+
private readonly typeAhead;
|
|
5180
|
+
private handleTypeAhead;
|
|
5181
|
+
protected readonly cursorFromKeyboard: _angular_core.WritableSignal<boolean>;
|
|
5182
|
+
private cursorList;
|
|
5003
5183
|
private firstEnabledIndex;
|
|
5004
5184
|
protected onTriggerKeydown(event: KeyboardEvent): void;
|
|
5005
5185
|
protected onSearchKeydown(event: KeyboardEvent): void;
|
|
5006
5186
|
protected openPanel(): void;
|
|
5007
5187
|
protected onTriggerClick(): void;
|
|
5008
5188
|
protected close(cause?: DsOverlayCloseCause): void;
|
|
5189
|
+
/** How far PageUp and PageDown move. Ten rows is the native `<select>` step and
|
|
5190
|
+
* the APG listbox example's — a fixed number rather than a measured screenful,
|
|
5191
|
+
* so the jump is the same wherever the panel happens to be clipped. */
|
|
5192
|
+
private static readonly pageStep;
|
|
5009
5193
|
private moveActive;
|
|
5010
5194
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
|
|
5011
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "triggerDisplay": { "alias": "triggerDisplay"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "emptyTemplate"], never, true, never>;
|
|
5195
|
+
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>;
|
|
5012
5196
|
}
|
|
5013
5197
|
|
|
5014
5198
|
declare class SkeletonComponent {
|
|
@@ -5259,6 +5443,58 @@ declare class DsEmptyTemplateDirective {
|
|
|
5259
5443
|
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsEmptyTemplateDirective, "[dsEmptyTemplate]", never, {}, {}, never, never, true, never>;
|
|
5260
5444
|
}
|
|
5261
5445
|
|
|
5446
|
+
/**
|
|
5447
|
+
* Fills a strip above a picker panel's option list — "3 of 40 selected", a
|
|
5448
|
+
* "clear all" button, a hint, a link to a fuller search.
|
|
5449
|
+
*
|
|
5450
|
+
* Context: `count` is how many options are visible after filtering, `total` how
|
|
5451
|
+
* many were given, and `query` the text that narrowed them.
|
|
5452
|
+
*
|
|
5453
|
+
* It sits OUTSIDE the `listbox`, so whatever you put here is not counted as an
|
|
5454
|
+
* option and does not break a screen reader's "N of M" position reporting. It
|
|
5455
|
+
* also stays put while the list scrolls under it — the panel clips and the list
|
|
5456
|
+
* is the scroller.
|
|
5457
|
+
*/
|
|
5458
|
+
declare class DsPanelHeaderTemplateDirective {
|
|
5459
|
+
readonly template: TemplateRef<unknown>;
|
|
5460
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsPanelHeaderTemplateDirective, never>;
|
|
5461
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsPanelHeaderTemplateDirective, "[dsPanelHeaderTemplate]", never, {}, {}, never, never, true, never>;
|
|
5462
|
+
}
|
|
5463
|
+
|
|
5464
|
+
/**
|
|
5465
|
+
* Fills a strip below a picker panel's option list — a "create new" affordance
|
|
5466
|
+
* of your own, a count, a link, an apply button for a panel the user batches
|
|
5467
|
+
* choices in.
|
|
5468
|
+
*
|
|
5469
|
+
* Context: the same as the header slot — `count`, `total`, `query`.
|
|
5470
|
+
*
|
|
5471
|
+
* Like the header it sits OUTSIDE the `listbox` and does not scroll with the
|
|
5472
|
+
* options. Anything focusable you put here is reached by Tab from the panel, so
|
|
5473
|
+
* give it an accessible name.
|
|
5474
|
+
*/
|
|
5475
|
+
declare class DsPanelFooterTemplateDirective {
|
|
5476
|
+
readonly template: TemplateRef<unknown>;
|
|
5477
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsPanelFooterTemplateDirective, never>;
|
|
5478
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsPanelFooterTemplateDirective, "[dsPanelFooterTemplate]", never, {}, {}, never, never, true, never>;
|
|
5479
|
+
}
|
|
5480
|
+
|
|
5481
|
+
/**
|
|
5482
|
+
* Fills an option group's heading — a count beside the name, a team glyph, a
|
|
5483
|
+
* secondary line.
|
|
5484
|
+
*
|
|
5485
|
+
* Context: `$implicit` and `group` are the group itself, `count` how many of its
|
|
5486
|
+
* options survived the filter.
|
|
5487
|
+
*
|
|
5488
|
+
* The heading element stays the library's: it keeps the id that the group's
|
|
5489
|
+
* `aria-labelledby` points at, so replacing the text cannot detach a group from
|
|
5490
|
+
* its name.
|
|
5491
|
+
*/
|
|
5492
|
+
declare class DsGroupLabelTemplateDirective {
|
|
5493
|
+
readonly template: TemplateRef<unknown>;
|
|
5494
|
+
static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsGroupLabelTemplateDirective, never>;
|
|
5495
|
+
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsGroupLabelTemplateDirective, "[dsGroupLabelTemplate]", never, {}, {}, never, never, true, never>;
|
|
5496
|
+
}
|
|
5497
|
+
|
|
5262
5498
|
/**
|
|
5263
5499
|
* Replaces `ds-autocomplete`'s "Create «…»" row.
|
|
5264
5500
|
*
|
|
@@ -5304,5 +5540,5 @@ declare class FieldClickFocusDirective {
|
|
|
5304
5540
|
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
|
|
5305
5541
|
}
|
|
5306
5542
|
|
|
5307
|
-
export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppLayoutComponent, AuthLayoutComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BodyScrollLockService, BottomSheetComponent, BrandNameDirective, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_FIELD_GROUP, DS_FIELD_WARNING_KIND, DS_ICON_REGISTRY, DS_TOAST_CONFIG, DS_TOAST_POSITION, DS_TOAST_POSITION_DEFAULT, DatePickerComponent, DescriptionItemComponent, DescriptionListComponent, DividerComponent, DrawerComponent, DropzoneComponent, DsChipTemplateDirective, DsCreateTemplateDirective, DsEmptyTemplateDirective, DsOptionTemplateDirective, DsOverlayCloseRef, DsPickerTriggerDirective, DsStaticPreview, EmptyStateComponent, FieldClickFocusDirective, FieldGroupComponent, FilterBarComponent, FilterItemDirective, HeaderFilterDirective, ICONS, IconButtonComponent, IconComponent, InlineComponent, InputComponent, LayoutNavigationService, LayoutScrollService, ListComponent, ListItemComponent, LoadingOverlayComponent, MenuComponent, MenuDividerComponent, MenuItemComponent, ModalCardComponent, ModalComponent, ModalService, MultiSelectComponent, NumberStepperComponent, OtpInputComponent, PageFooterComponent, PageHeaderComponent, PaginationComponent, PasswordRulesComponent, PopoverComponent, ProgressComponent, RADIO_GROUP, RadioComponent, RadioGroupComponent, RailTriggerDirective, ReserveMessagesDirective, SIDENAV, SearchComponent, SegmentedComponent, SelectComponent, SidenavComponent, SidenavFooterComponent, SidenavGroupComponent, SidenavItemComponent, SkeletonComponent, SliderComponent, SpinnerComponent, SplitButtonComponent, StackComponent, StatComponent, StatusDotComponent, StepperComponent, SwitchComponent, TabComponent, TableComponent, TabsComponent, TagComponent, TextareaComponent, TimePickerComponent, TimelineComponent, TimelineItemComponent, ToastComponent, ToastRegionComponent, ToastService, ToggleButtonComponent, TooltipDirective, TooltipPanelComponent, TopBarComponent, TreeComponent, W3wComponent, avatarTint, flattenDsOptions, inheritDsConfig, initialsFrom, isDsOptionGroup, isSelectOptionGroup, passwordRulesMet, provideDsConfig, provideDsIcons, provideDsTheme };
|
|
5308
|
-
export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteItem, AutocompleteOption, AutocompleteOptionGroup, AutocompleteValueOverflow, AutocompleteWidth, AvatarSize, AvatarStatus, AvatarTintOptions, BannerVariant, BreadcrumbItem, ButtonColor, ButtonType, ButtonVariant, CardElevation, CardPadding, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerSpacing, DividerVariant, DrawerPlacement, DropzoneFile, DropzoneFileState, DsConfig, DsControlWidth, DsFieldError, DsFieldErrorsInput, DsFieldGroupContext, DsIconRegistry, DsOption, DsOptionGroup, DsOptionItem, DsPasswordRule, DsPasswordRuleState, DsScrollReset, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, DsTriggerDisplay, EmptyStateVariant, HeaderFilterContext, IconButtonType, IconButtonVariant, IconName, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectItem, MultiSelectOption, MultiSelectOptionGroup, MultiSelectWidth, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, SelectWidth, SidenavAlertItem, SidenavContract, SidenavItemModel, SidenavSearchProvider, SidenavSearchResult, SortChangeEvent, SortDir, SplitButtonItem, SplitButtonVariant, StepperLabelPosition, StepperOrientation, TableCellEditEvent, TableColumn, TableFilterMode, TableRowAction, TableRowActionEvent, TableSortMode, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TimeFormat, TimePickerMode, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };
|
|
5543
|
+
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 };
|
|
5544
|
+
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 };
|