@ids-group-ltd/ids-design-system 0.11.2 → 0.11.4
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 +319 -12
- package/components.md +35 -12
- package/design-system.md +135 -1
- package/docs/agent/INDEX.md +99 -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/body-scroll-lock-service.md +12 -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 +17 -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 +924 -763
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.11.3.json +152 -0
- package/migrations/0.11.4.json +241 -0
- package/migrations/0.8.0.json +6 -5
- package/package.json +1 -1
- package/styles/_control-label.scss +18 -0
- package/styles/_dropdown-overlay.scss +25 -32
- package/styles/_ds-color.scss +37 -12
- package/styles/_focus.scss +16 -0
- package/styles/_skeleton-shimmer.scss +10 -26
- package/styles/_tokens-charts.scss +2 -3
- package/styles/_tokens.scss +158 -321
- package/themes/README.md +32 -1
- package/themes/_base-palette.scss +35 -76
- package/themes/_semantic.scss +16 -4
- package/types/ids-group-ltd-ids-design-system.d.ts +205 -230
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import * as _angular_core from '@angular/core';
|
|
2
|
-
import { InjectionToken, Provider, EnvironmentProviders, ElementRef, TemplateRef, ModelSignal, WritableSignal, OnDestroy } from '@angular/core';
|
|
2
|
+
import { InjectionToken, Provider, EnvironmentProviders, ElementRef, Signal, TemplateRef, ModelSignal, WritableSignal, OnDestroy } from '@angular/core';
|
|
3
3
|
import { SafeHtml } from '@angular/platform-browser';
|
|
4
4
|
import { Observable } from 'rxjs';
|
|
5
5
|
import { ControlValueAccessor } from '@angular/forms';
|
|
@@ -109,6 +109,14 @@ type DsSize = 'sm' | 'md' | 'lg';
|
|
|
109
109
|
type CardElevation = 'flat' | 'raised' | 'hover' | 'interactive';
|
|
110
110
|
type CardPadding = 'none' | 'sm' | 'md' | 'lg';
|
|
111
111
|
|
|
112
|
+
type DsToastHorizontalPosition = 'left' | 'center' | 'right';
|
|
113
|
+
type DsToastVerticalPosition = 'top' | 'bottom';
|
|
114
|
+
interface DsToastPosition {
|
|
115
|
+
readonly horizontalPosition: DsToastHorizontalPosition;
|
|
116
|
+
readonly verticalPosition: DsToastVerticalPosition;
|
|
117
|
+
readonly offset: string;
|
|
118
|
+
}
|
|
119
|
+
|
|
112
120
|
interface DsConfig {
|
|
113
121
|
field?: {
|
|
114
122
|
/** Default for every field's `reserveMessage` — keeps a message line's worth
|
|
@@ -123,16 +131,12 @@ interface DsConfig {
|
|
|
123
131
|
* override at the validator covers both. Unmapped kinds warn in dev. */
|
|
124
132
|
errorMessages?: Record<string, string>;
|
|
125
133
|
/** 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.
|
|
134
|
+
* `error`, `warning` and `success` and NONE for `hint`, which is resting text
|
|
135
|
+
* rather than a state. Each key is independent — a glyph name replaces the
|
|
136
|
+
* default, `false` removes it, and `stateIcons: false` removes all four.
|
|
132
137
|
*
|
|
133
|
-
*
|
|
134
|
-
*
|
|
135
|
-
* else — which WCAG 1.4.1 forbids a state from resting on. */
|
|
138
|
+
* The glyphs exist because warning and success differ from each other by hue
|
|
139
|
+
* and nothing else, which WCAG 1.4.1 forbids a state from resting on. */
|
|
136
140
|
stateIcons?: false | {
|
|
137
141
|
error?: IconName | false;
|
|
138
142
|
warning?: IconName | false;
|
|
@@ -151,8 +155,8 @@ interface DsConfig {
|
|
|
151
155
|
};
|
|
152
156
|
avatar?: {
|
|
153
157
|
/** How `ds-avatar` turns its `name` into initials, app-wide. The built-in rule
|
|
154
|
-
* takes the first two words
|
|
155
|
-
*
|
|
158
|
+
* takes the first two words, which is a Latin-script guess — an app whose names
|
|
159
|
+
* follow another convention supplies its own here. */
|
|
156
160
|
initials?: (name: string) => string;
|
|
157
161
|
};
|
|
158
162
|
brand?: {
|
|
@@ -170,13 +174,20 @@ interface DsConfig {
|
|
|
170
174
|
* `ds-modal` ancestor to bind — an attribute cannot reach it. */
|
|
171
175
|
dividers?: boolean;
|
|
172
176
|
};
|
|
177
|
+
toast?: {
|
|
178
|
+
/** Where the stack sits. Merged field by field over the built-in
|
|
179
|
+
* `right` / `top` / `var(--space-6)`, so naming one key keeps the other two. */
|
|
180
|
+
position?: Partial<DsToastPosition>;
|
|
181
|
+
/** Maximum number of toasts visible at once. Extras are queued and shown as
|
|
182
|
+
* earlier ones dismiss. Default `5`; `0` means unlimited. */
|
|
183
|
+
maxVisible?: number;
|
|
184
|
+
};
|
|
173
185
|
picker?: {
|
|
174
186
|
/** Default for `ds-multi-select``s `searchable`. `true` always shows the panel's
|
|
175
187
|
* 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. */
|
|
188
|
+
* there are at least that many options. Default `true`. One threshold for the
|
|
189
|
+
* app is the point: left to each call site, two panels of the same length in
|
|
190
|
+
* the same screen end up disagreeing. */
|
|
180
191
|
searchable?: boolean | number;
|
|
181
192
|
};
|
|
182
193
|
control?: {
|
|
@@ -195,14 +206,12 @@ interface DsConfig {
|
|
|
195
206
|
};
|
|
196
207
|
table?: {
|
|
197
208
|
/** Default for `ds-table`'s `stickyScrollbar` — the proxy that keeps the
|
|
198
|
-
* horizontal bar reachable on a tall table. Default `false`.
|
|
199
|
-
*
|
|
200
|
-
*
|
|
209
|
+
* horizontal bar reachable on a tall table. Default `false`. Here rather than
|
|
210
|
+
* per table because every new table is one forgotten binding away from
|
|
211
|
+
* scrolling invisibly. */
|
|
201
212
|
stickyScrollbar?: boolean;
|
|
202
213
|
/** 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. */
|
|
214
|
+
* Default `false`. */
|
|
206
215
|
bordered?: boolean;
|
|
207
216
|
};
|
|
208
217
|
icon?: {
|
|
@@ -227,25 +236,22 @@ declare const DS_CONFIG: InjectionToken<DsConfig>;
|
|
|
227
236
|
*
|
|
228
237
|
* providers: [provideDsConfig({ control: { size: 'sm' } })]
|
|
229
238
|
*
|
|
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.
|
|
239
|
+
* Works at the app root, on a `Route`, or on a component/directive — the config
|
|
240
|
+
* resolves through the element-injector chain, so a subtree can differ from the
|
|
241
|
+
* app. Component inputs (e.g. `<ds-card padding="lg">`) still win.
|
|
237
242
|
*
|
|
238
|
-
*
|
|
239
|
-
*
|
|
240
|
-
*
|
|
243
|
+
* A nested call MERGES with the config above it section by section; only the keys
|
|
244
|
+
* you name are replaced. ONE call per injector, though: two in the SAME
|
|
245
|
+
* `providers` array both resolve their parent with `skipSelf`, so the later wins
|
|
246
|
+
* and the earlier is silently lost.
|
|
241
247
|
*/
|
|
242
248
|
declare function provideDsConfig(config: DsConfig): Provider;
|
|
243
249
|
/**
|
|
244
250
|
* The factory body behind `provideDsConfig`, exported so a directive can put the
|
|
245
251
|
* 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).
|
|
252
|
+
* there instead runs at module-evaluation time, which makes the module
|
|
253
|
+
* side-effectful and costs the consumer its tree-shaking (measured at +566 kB
|
|
254
|
+
* moved into the eager chunk).
|
|
249
255
|
*
|
|
250
256
|
* Must be called from an injection context.
|
|
251
257
|
*/
|
|
@@ -335,8 +341,7 @@ interface DsOptionGroup<T = string> {
|
|
|
335
341
|
/**
|
|
336
342
|
* What a picker's `options` input takes: flat options, groups, or both mixed.
|
|
337
343
|
* One input rather than two, because a second `optionGroups` input can only
|
|
338
|
-
* answer "what if both are set" by silently ignoring one
|
|
339
|
-
* `ds-autocomplete` used to do.
|
|
344
|
+
* answer "what if both are set" by silently ignoring one.
|
|
340
345
|
*/
|
|
341
346
|
type DsOptionItem<T = string> = DsOption<T> | DsOptionGroup<T>;
|
|
342
347
|
declare function isDsOptionGroup<T>(item: DsOptionItem<T>): item is DsOptionGroup<T>;
|
|
@@ -739,7 +744,7 @@ declare class LayoutScrollService {
|
|
|
739
744
|
* ask the layout for it instead of guessing the layout's internal markup with
|
|
740
745
|
* `document.querySelector`.
|
|
741
746
|
*/
|
|
742
|
-
readonly scroller:
|
|
747
|
+
readonly scroller: Signal<Element | null>;
|
|
743
748
|
private restoreTimeoutMs;
|
|
744
749
|
private resetStrategy;
|
|
745
750
|
private armed;
|
|
@@ -980,10 +985,8 @@ declare class BrandNameDirective {
|
|
|
980
985
|
* MFA — and the counterpart to `ds-app-layout`, which only ever covers the
|
|
981
986
|
* screens behind the login.
|
|
982
987
|
*
|
|
983
|
-
*
|
|
984
|
-
*
|
|
985
|
-
* box: they nest a `100vh` wrapper inside a `100dvh` one and scroll a page whose
|
|
986
|
-
* content fits. Here the host is the only one, and it also carries the safe-area
|
|
988
|
+
* The host is the ONLY full-height box — nesting a `100vh` wrapper inside a
|
|
989
|
+
* `100dvh` one scrolls a page whose content fits — and it carries the safe-area
|
|
987
990
|
* insets a notched phone in landscape needs.
|
|
988
991
|
*
|
|
989
992
|
* The brand row takes the same CONTRACT as `ds-sidenav` — a `brand` string gets a
|
|
@@ -1011,10 +1014,9 @@ declare class BrandNameDirective {
|
|
|
1011
1014
|
declare class AuthLayoutComponent {
|
|
1012
1015
|
/** Wordmark beside the letter-mark tile. For a logo image/SVG, project it into
|
|
1013
1016
|
* the `[brand]` slot instead; for a two-tone wordmark use `[dsBrandName]`.
|
|
1014
|
-
* Unset falls back to `DS_CONFIG.brand.name
|
|
1015
|
-
*
|
|
1016
|
-
*
|
|
1017
|
-
* screen no brand row. */
|
|
1017
|
+
* Unset falls back to `DS_CONFIG.brand.name`. Each field resolves on its own, so
|
|
1018
|
+
* `brand=""` drops the wordmark but a `logoLetter` in the config still paints its
|
|
1019
|
+
* tile; clear both to give one screen no brand row. */
|
|
1018
1020
|
readonly brand: _angular_core.InputSignal<string | null>;
|
|
1019
1021
|
/** Letter-mark glyph when it differs from the brand's first letter (e.g. an
|
|
1020
1022
|
* "A" tile beside the "MyAdmin" wordmark). Empty = first letter of `brand`;
|
|
@@ -1032,14 +1034,12 @@ declare class AuthLayoutComponent {
|
|
|
1032
1034
|
readonly cardElevation: _angular_core.InputSignal<CardElevation>;
|
|
1033
1035
|
/** Card padding, passed through to `ds-card`. `md` tightens a short form. */
|
|
1034
1036
|
readonly cardPadding: _angular_core.InputSignal<CardPadding>;
|
|
1035
|
-
/** Announce the card as the page's `main` landmark.
|
|
1036
|
-
*
|
|
1037
|
-
*
|
|
1038
|
-
*
|
|
1039
|
-
*
|
|
1040
|
-
* own violation. */
|
|
1037
|
+
/** Announce the card as the page's `main` landmark. `ds-card` renders an
|
|
1038
|
+
* `<article>`, which is NOT a landmark, so by default a screen-reader user has
|
|
1039
|
+
* nothing to jump to — set `'main'` on a standalone auth page. Opt-in because
|
|
1040
|
+
* the layout is also embedded inside pages that already own a `main`, and two
|
|
1041
|
+
* `main`s is its own violation. */
|
|
1041
1042
|
readonly landmark: _angular_core.InputSignal<"none" | "main">;
|
|
1042
|
-
/** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
|
|
1043
1043
|
protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
|
|
1044
1044
|
protected readonly hasBrandName: _angular_core.Signal<boolean>;
|
|
1045
1045
|
/** Spread, not `charAt(0)`: the latter indexes UTF-16 code UNITS, so a brand
|
|
@@ -1898,8 +1898,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1898
1898
|
/** Flat options or option groups rendered in the dropdown panel. */
|
|
1899
1899
|
readonly options: _angular_core.InputSignal<readonly SelectItem[]>;
|
|
1900
1900
|
/** Public panel tokens forwarded onto the portaled overlay pane on open, so a
|
|
1901
|
-
* consumer's `ds-select { --ds-dropdown-panel-*: … }` reaches it.
|
|
1902
|
-
* tokens can only be set globally: the pane is portaled out of this component. */
|
|
1901
|
+
* consumer's `ds-select { --ds-dropdown-panel-*: … }` reaches it. */
|
|
1903
1902
|
private readonly panelTokens;
|
|
1904
1903
|
/** Trigger width — `fill` stretches to the container and pins the panel to the
|
|
1905
1904
|
* trigger's width; `content` hugs the trigger's own content and takes that width
|
|
@@ -1967,7 +1966,6 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1967
1966
|
/** Active option for `aria-activedescendant` (combobox keeps DOM focus). */
|
|
1968
1967
|
protected readonly activeDescendant: _angular_core.Signal<string | null>;
|
|
1969
1968
|
protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
|
|
1970
|
-
/** Effective disabled — own `disabled` input OR the reactive-forms state. */
|
|
1971
1969
|
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
1972
1970
|
protected readonly trigger: _angular_core.Signal<ElementRef<HTMLElement>>;
|
|
1973
1971
|
protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
|
|
@@ -1994,9 +1992,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1994
1992
|
protected clearValue(event: MouseEvent): void;
|
|
1995
1993
|
/**
|
|
1996
1994
|
* Empties the selection from outside — a "reset filters" button, a form the app
|
|
1997
|
-
* clears itself.
|
|
1998
|
-
* in-trigger button, so an app with its own reset had to write the empty value
|
|
1999
|
-
* by hand and guess what "empty" is for this control.
|
|
1995
|
+
* clears itself.
|
|
2000
1996
|
*
|
|
2001
1997
|
* Deliberately does NOT move focus: the caller may be navigating away, and
|
|
2002
1998
|
* stealing focus back into a field they just left is worse than leaving it.
|
|
@@ -2042,6 +2038,8 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
2042
2038
|
* - row: alias for the row object (typed `unknown`)
|
|
2043
2039
|
*/
|
|
2044
2040
|
declare class CellTemplateDirective {
|
|
2041
|
+
/** The `key` of the column this template replaces, matched against the table's
|
|
2042
|
+
* `columns`. A key no column declares renders nothing and warns nowhere. */
|
|
2045
2043
|
readonly dsCellTemplate: _angular_core.InputSignal<string>;
|
|
2046
2044
|
readonly template: TemplateRef<any>;
|
|
2047
2045
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<CellTemplateDirective, never>;
|
|
@@ -2115,10 +2113,6 @@ type TableFilterMode = 'client' | 'server' | 'none';
|
|
|
2115
2113
|
* - `'client'` — the table reorders `data()` itself, for a table holding every row.
|
|
2116
2114
|
* - `'none'` — nothing sorts, and `sortable` columns render no affordance rather
|
|
2117
2115
|
* than a control that does nothing.
|
|
2118
|
-
*
|
|
2119
|
-
* Replaces the boolean `clientSort`, which could not express `'none'`: a column
|
|
2120
|
-
* marked `sortable` on a table with no sorting drew a live-looking header that
|
|
2121
|
-
* did nothing, and no type or dev check could catch it.
|
|
2122
2116
|
*/
|
|
2123
2117
|
type TableSortMode = 'client' | 'server' | 'none';
|
|
2124
2118
|
/** `'single'` closes the open row when another is expanded; `'multiple'` (default)
|
|
@@ -2254,8 +2248,7 @@ declare class TableComponent<T extends object> {
|
|
|
2254
2248
|
* `true` — the table picks: skeleton rows while it has nothing to show, overlay
|
|
2255
2249
|
* once rows are on screen. Prefer it; the right choice is a function of the row
|
|
2256
2250
|
* count, which only the table holds.
|
|
2257
|
-
* 'skeleton' — first-load placeholder; rows are replaced with shimmer
|
|
2258
|
-
* rows that read the global --skeleton-shimmer-x driver.
|
|
2251
|
+
* 'skeleton' — first-load placeholder; rows are replaced with shimmer rows.
|
|
2259
2252
|
* 'overlay' — re-fetch indicator; existing rows stay visible behind
|
|
2260
2253
|
* a translucent overlay with a centred spinner. Pin either one only to
|
|
2261
2254
|
* override the rule deliberately. */
|
|
@@ -2384,6 +2377,7 @@ declare class TableComponent<T extends object> {
|
|
|
2384
2377
|
* can show the same in-flight state as the built-in one. */
|
|
2385
2378
|
readonly exporting: _angular_core.Signal<boolean>;
|
|
2386
2379
|
private readonly exportStatusState;
|
|
2380
|
+
private readonly eventsAtExport;
|
|
2387
2381
|
/** Announced in the table's live region while an export is running or after it
|
|
2388
2382
|
* failed, so the button's own disabled state is not the only signal. */
|
|
2389
2383
|
readonly exportStatus: _angular_core.Signal<string>;
|
|
@@ -2534,15 +2528,10 @@ declare class TableComponent<T extends object> {
|
|
|
2534
2528
|
* `skeleton` paints "No rows yet" under the spinner on a zero-row reload. */
|
|
2535
2529
|
protected readonly showsEmptyRow: _angular_core.Signal<boolean>;
|
|
2536
2530
|
protected readonly effectiveHiddenKeys: _angular_core.Signal<ReadonlySet<string>>;
|
|
2537
|
-
/** Columns in the user-controlled order — `columnOrder` first (dropping
|
|
2538
|
-
* unknown keys), then any declared column the order omitted. */
|
|
2539
2531
|
protected readonly orderedColumns: _angular_core.Signal<readonly TableColumn<T>[]>;
|
|
2540
|
-
/** Columns actually rendered — reordered, then hidden ones skipped. */
|
|
2541
2532
|
protected readonly visibleColumns: _angular_core.Signal<readonly TableColumn<T>[]>;
|
|
2542
|
-
/** Columns the user may toggle — drives the header column picker. */
|
|
2543
2533
|
protected readonly hideableColumns: _angular_core.Signal<readonly TableColumn<T>[]>;
|
|
2544
2534
|
protected readonly hasColumnPicker: _angular_core.Signal<boolean>;
|
|
2545
|
-
/** The trailing utility column hosts the picker button and/or row kebabs. */
|
|
2546
2535
|
protected readonly hasUtilityColumn: _angular_core.Signal<boolean>;
|
|
2547
2536
|
protected isColumnVisible(col: TableColumn<T>): boolean;
|
|
2548
2537
|
/** The last visible column can't be hidden — an all-hidden grid is useless. */
|
|
@@ -2557,24 +2546,16 @@ declare class TableComponent<T extends object> {
|
|
|
2557
2546
|
protected readonly filterSearch: _angular_core.WritableSignal<string>;
|
|
2558
2547
|
private readonly headerFilters;
|
|
2559
2548
|
private readonly headerFilterByKey;
|
|
2560
|
-
/** The projected filter for a column, when the host supplied one. */
|
|
2561
2549
|
protected headerFilterFor(col: TableColumn<T>): HeaderFilterDirective | undefined;
|
|
2562
|
-
/** A projected filter makes the column filterable on its own — the host does
|
|
2563
|
-
* not also have to mark it `filter: 'set'` to get the header button. */
|
|
2564
2550
|
protected hasColumnFilter(col: TableColumn<T>): boolean;
|
|
2565
|
-
/** A column is "actively filtered" when at least one of its values is unchecked. */
|
|
2566
2551
|
protected isColumnFiltered(col: TableColumn<T>): boolean;
|
|
2567
|
-
/** The checklist's domain: what the host declared, else what is in hand. */
|
|
2568
2552
|
private optionsFor;
|
|
2569
|
-
/** Distinct values of the open column, narrowed by the popover search box. */
|
|
2570
2553
|
protected readonly filterValues: _angular_core.Signal<readonly string[]>;
|
|
2571
2554
|
protected readonly filterSelectedCount: _angular_core.Signal<number>;
|
|
2572
2555
|
protected isFilterValueChecked(value: string): boolean;
|
|
2573
2556
|
protected onColumnFilterClick(col: TableColumn<T>, event: Event): void;
|
|
2574
2557
|
protected onFilterSearch(event: Event): void;
|
|
2575
2558
|
protected toggleFilterValue(value: string): void;
|
|
2576
|
-
/** Context handed to a projected header filter. Rebuilt per open, which is
|
|
2577
|
-
* cheap and keeps `close` bound to the popover that is actually showing. */
|
|
2578
2559
|
protected headerFilterContext(col: TableColumn<T>): {
|
|
2579
2560
|
$implicit: unknown;
|
|
2580
2561
|
column: unknown;
|
|
@@ -2598,9 +2579,8 @@ declare class TableComponent<T extends object> {
|
|
|
2598
2579
|
private static readonly RESIZE_PAGE;
|
|
2599
2580
|
private static readonly MIN_COLUMN_WIDTH;
|
|
2600
2581
|
private resizeState;
|
|
2601
|
-
/**
|
|
2602
|
-
*
|
|
2603
|
-
* class instead, see `fitsContent`. */
|
|
2582
|
+
/** `'content'` is not a pixel value — it is carried by a class instead, see
|
|
2583
|
+
* `fitsContent`. */
|
|
2604
2584
|
protected columnWidth(col: TableColumn<T>): number | null;
|
|
2605
2585
|
/** Shrink-to-content mode, unless the user has dragged this column — a drag is a
|
|
2606
2586
|
* deliberate pixel width and must win over the declared intent. */
|
|
@@ -2619,8 +2599,7 @@ declare class TableComponent<T extends object> {
|
|
|
2619
2599
|
* drag changes one column and leaves the others where they were — the
|
|
2620
2600
|
* auto-sized geometry is kept rather than lost at the first grab.
|
|
2621
2601
|
*
|
|
2622
|
-
*
|
|
2623
|
-
* it reads the header row that is actually on screen rather than assuming a
|
|
2602
|
+
* Reads the header row that is actually on screen rather than assuming a
|
|
2624
2603
|
* column order.
|
|
2625
2604
|
*/
|
|
2626
2605
|
private lockMeasuredWidths;
|
|
@@ -2655,52 +2634,33 @@ declare class TableComponent<T extends object> {
|
|
|
2655
2634
|
min: number;
|
|
2656
2635
|
max: number;
|
|
2657
2636
|
} | null;
|
|
2658
|
-
/** Current rendered width for the keyboard resize path. Falls back to the DOM
|
|
2659
|
-
* when the column was auto-sized and has neither an override nor a declared
|
|
2660
|
-
* width. */
|
|
2661
2637
|
protected resolvedColumnWidth(col: TableColumn<T>, from?: HTMLElement): number;
|
|
2662
|
-
/**
|
|
2663
|
-
* Keyboard resizing. A drag handle that only answers to a pointer makes a
|
|
2664
|
-
* resizable column unusable without a mouse, which is an a11y gap rather than
|
|
2665
|
-
* a missing nicety — hence Arrow for fine steps, PageUp/PageDown for coarse
|
|
2666
|
-
* ones and Home to hand the column back to automatic sizing.
|
|
2667
|
-
*/
|
|
2668
2638
|
protected onResizeKey(col: TableColumn<T>, event: KeyboardEvent): void;
|
|
2669
2639
|
/**
|
|
2670
|
-
*
|
|
2671
|
-
*
|
|
2672
|
-
*
|
|
2673
|
-
*
|
|
2674
|
-
* passed when the caller has it — the panel does not, so it is looked up by
|
|
2675
|
-
* `data-col-key`, and the measurement matters: stepping an auto-sized column
|
|
2676
|
-
* has to start from what it currently RENDERS, not from the minimum.
|
|
2640
|
+
* The header cell is passed when the caller has it — the column panel does
|
|
2641
|
+
* not, so it is looked up by `data-col-key`, and the measurement matters:
|
|
2642
|
+
* stepping an auto-sized column has to start from what it currently RENDERS,
|
|
2643
|
+
* not from the minimum.
|
|
2677
2644
|
*/
|
|
2678
2645
|
private stepColumnWidth;
|
|
2679
2646
|
private headerCellFor;
|
|
2680
2647
|
protected onColumnWidthStep(col: TableColumn<T>, delta: number | 'auto'): void;
|
|
2681
2648
|
protected readonly resizeStep = 16;
|
|
2682
|
-
/** Client-side filter over the full data set — combines the `filterQuery`
|
|
2683
|
-
* substring search with any per-column set filters. Sorting and pagination
|
|
2684
|
-
* run on the filtered rows. */
|
|
2685
2649
|
protected readonly filteredData: _angular_core.Signal<readonly T[]>;
|
|
2686
|
-
/** Client-side sort over the filtered data set — only in `'client'` mode. */
|
|
2687
2650
|
protected readonly sortedData: _angular_core.Signal<readonly T[]>;
|
|
2688
|
-
/** Current page's slice of the sorted rows, when paginating. */
|
|
2689
2651
|
protected readonly pagedData: _angular_core.Signal<readonly T[]>;
|
|
2690
|
-
/**
|
|
2691
|
-
* Virtual mode windows this further; `rowSlots` is what the loop walks. */
|
|
2652
|
+
/** Virtual mode windows this further; `rowSlots` is what the loop walks. */
|
|
2692
2653
|
protected readonly displayData: _angular_core.Signal<readonly T[]>;
|
|
2693
2654
|
/**
|
|
2694
2655
|
* The single live-region line. Loading wins while it lasts — a sort
|
|
2695
2656
|
* announcement over rows that are being replaced tells the reader about a
|
|
2696
|
-
* state they cannot inspect yet.
|
|
2697
|
-
* row range, which are the two things a sighted user reads off the header and
|
|
2698
|
-
* the pager and a screen-reader user was told nothing about.
|
|
2657
|
+
* state they cannot inspect yet.
|
|
2699
2658
|
*
|
|
2700
2659
|
* `aria-live="polite"` does not announce a region's INITIAL content, so the
|
|
2701
2660
|
* unsorted first render is silent; only real changes speak.
|
|
2702
2661
|
*/
|
|
2703
2662
|
protected readonly statusMessage: _angular_core.Signal<string>;
|
|
2663
|
+
private readonly eventMessages;
|
|
2704
2664
|
/** Only from two rows up: a single expander announces itself through its own
|
|
2705
2665
|
* `aria-expanded`, and repeating that here would say everything twice. */
|
|
2706
2666
|
private readonly expansionMessage;
|
|
@@ -2715,7 +2675,6 @@ declare class TableComponent<T extends object> {
|
|
|
2715
2675
|
* ones that have arrived — otherwise the spacers shrink to the loaded slice
|
|
2716
2676
|
* and the scrollbar lies about the length of the list. */
|
|
2717
2677
|
protected readonly virtualCount: _angular_core.Signal<number>;
|
|
2718
|
-
/** `null` when not virtualizing — the row loop then walks `displayData()` whole. */
|
|
2719
2678
|
protected readonly virtualWindow: _angular_core.Signal<{
|
|
2720
2679
|
start: number;
|
|
2721
2680
|
end: number;
|
|
@@ -2741,32 +2700,27 @@ declare class TableComponent<T extends object> {
|
|
|
2741
2700
|
protected isStriped(absoluteIndex: number): boolean;
|
|
2742
2701
|
protected readonly allSelected: _angular_core.Signal<boolean>;
|
|
2743
2702
|
protected readonly someSelected: _angular_core.Signal<boolean>;
|
|
2744
|
-
/** Select-all is page-scoped only when paginating. */
|
|
2745
2703
|
protected readonly selectAllLabel: _angular_core.Signal<"Select all rows on this page" | "Select all rows">;
|
|
2746
2704
|
protected readonly allExpanded: _angular_core.Signal<boolean>;
|
|
2747
2705
|
protected readonly expandAllVisible: _angular_core.Signal<boolean>;
|
|
2748
2706
|
protected readonly expandAllLabel: _angular_core.Signal<string>;
|
|
2749
2707
|
protected readonly skeletonArray: _angular_core.Signal<any[]>;
|
|
2750
|
-
/** Colspan of a full-width row (expansion panel, empty state): data cols +
|
|
2751
|
-
* optional select/expand/actions cols. */
|
|
2752
2708
|
protected readonly expandedColspan: _angular_core.Signal<number>;
|
|
2753
2709
|
protected readonly hasRowActions: _angular_core.Signal<boolean>;
|
|
2754
|
-
/** Row whose kebab menu is open — drives the per-row `disabled` predicates. */
|
|
2755
2710
|
protected readonly menuRow: _angular_core.WritableSignal<T | null>;
|
|
2756
2711
|
private readonly rowMenuPopover;
|
|
2757
2712
|
private readonly columnPickerPopover;
|
|
2758
2713
|
protected readonly columnSheetOpen: _angular_core.WritableSignal<boolean>;
|
|
2759
2714
|
private readonly coarsePointerState;
|
|
2760
2715
|
/** Whether the column panel opens as a sheet and the drag handle stands down.
|
|
2761
|
-
* Keyed on the pointer, not the viewport — see
|
|
2716
|
+
* Keyed on the pointer, not the viewport — see the matching media query in
|
|
2717
|
+
* `table.component.scss`. */
|
|
2762
2718
|
protected readonly coarsePointer: _angular_core.Signal<boolean>;
|
|
2763
2719
|
protected readonly columnPickerOpened: _angular_core.Signal<boolean>;
|
|
2764
2720
|
protected onColumnPickerClick(event: Event): void;
|
|
2765
2721
|
protected readonly hasTruncate: _angular_core.Signal<boolean>;
|
|
2766
2722
|
private readonly cellTextPopover;
|
|
2767
2723
|
protected readonly cellPopoverText: _angular_core.WritableSignal<string>;
|
|
2768
|
-
/** Click on a `truncate` cell: when the text is actually clipped, show the
|
|
2769
|
-
* full value in a popover; otherwise let the click fall through to the row. */
|
|
2770
2724
|
protected onCellClipClick(row: T, col: TableColumn<T>, event: Event): void;
|
|
2771
2725
|
/** Clipped horizontally — itself or anything it renders. A `dsCellTemplate`
|
|
2772
2726
|
* puts the ellipsis on a descendant, so testing only the wrapper misses it. */
|
|
@@ -2780,6 +2734,8 @@ declare class TableComponent<T extends object> {
|
|
|
2780
2734
|
protected onHeaderEnter(event: Event, col: TableColumn<T>): void;
|
|
2781
2735
|
private readonly scrollWrap;
|
|
2782
2736
|
private readonly hscrollProxy;
|
|
2737
|
+
private readonly tableHead;
|
|
2738
|
+
private readonly hostElement;
|
|
2783
2739
|
protected readonly hscrollContentWidth: _angular_core.WritableSignal<number>;
|
|
2784
2740
|
protected readonly hscrollNeeded: _angular_core.WritableSignal<boolean>;
|
|
2785
2741
|
private readonly scrollTop;
|
|
@@ -2809,14 +2765,11 @@ declare class TableComponent<T extends object> {
|
|
|
2809
2765
|
protected onRowMousedown(): void;
|
|
2810
2766
|
protected onRowClick(row: T, event: Event): void;
|
|
2811
2767
|
protected onRowKey(row: T, event: Event): void;
|
|
2812
|
-
/** Accessible name for an interactive row, taken from the first visible column. */
|
|
2813
2768
|
protected rowAriaLabel(row: T): string;
|
|
2814
2769
|
/** Row identity — the `rowId` accessor when given, else `row.id`. Public so a
|
|
2815
2770
|
* host reading `selectedIds`/`expandedIds` can compute the same keys. */
|
|
2816
2771
|
rowKey(row: T): string;
|
|
2817
|
-
/** Whether this column's header is an actual sort control right now. */
|
|
2818
2772
|
protected sortableCol(col: TableColumn<T>): boolean;
|
|
2819
|
-
/** `aria-sort` value for a header: only meaningful on sortable columns. */
|
|
2820
2773
|
protected ariaSort(col: TableColumn<T>): 'ascending' | 'descending' | 'none' | null;
|
|
2821
2774
|
protected onSort(col: TableColumn<T>): void;
|
|
2822
2775
|
protected headerClasses(col: TableColumn<T>): string;
|
|
@@ -2838,11 +2791,12 @@ declare class TableComponent<T extends object> {
|
|
|
2838
2791
|
* emits `exportFailed`. Public so the button can live anywhere:
|
|
2839
2792
|
* `<ds-button [loading]="table.exporting()" (pressed)="table.runExport()">`. */
|
|
2840
2793
|
runExport(): Promise<void>;
|
|
2794
|
+
private announceExport;
|
|
2841
2795
|
/** Hands a ready-made file to the browser. Only a Blob gets its object URL
|
|
2842
2796
|
* revoked — a URL the caller supplied is theirs to manage. */
|
|
2843
2797
|
private downloadFile;
|
|
2844
2798
|
/** Deterministic per-cell width so skeleton rows look organic but stable
|
|
2845
|
-
* across re-renders.
|
|
2799
|
+
* across re-renders. */
|
|
2846
2800
|
protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
|
|
2847
2801
|
private watchPointer;
|
|
2848
2802
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
|
|
@@ -3040,7 +2994,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3040
2994
|
readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
|
|
3041
2995
|
/** Accessible name when no visible `label` is provided. */
|
|
3042
2996
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
3043
|
-
/**
|
|
2997
|
+
/** Lower bound for the year dropdown in the calendar header. */
|
|
3044
2998
|
readonly minYear: _angular_core.InputSignal<number>;
|
|
3045
2999
|
/** Upper bound for the year dropdown in the calendar header. */
|
|
3046
3000
|
readonly maxYear: _angular_core.InputSignal<number>;
|
|
@@ -3062,7 +3016,8 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3062
3016
|
* the panel shows its month and grid focus lands on its exact day.
|
|
3063
3017
|
* Never written to `value` — selection stays with the user. */
|
|
3064
3018
|
readonly defaultDate: _angular_core.InputSignal<Date | null>;
|
|
3065
|
-
/** Allow masked manual typing. When false the
|
|
3019
|
+
/** Allow masked manual typing. When false the field is read-only and a date can
|
|
3020
|
+
* only be picked from the calendar. */
|
|
3066
3021
|
readonly allowInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
3067
3022
|
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
3068
3023
|
protected readonly hintId: _angular_core.Signal<string | null>;
|
|
@@ -3075,13 +3030,10 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3075
3030
|
readonly resolvedLocale: _angular_core.Signal<string>;
|
|
3076
3031
|
protected readonly resolvedFirstDay: _angular_core.Signal<number>;
|
|
3077
3032
|
protected readonly formatSpec: _angular_core.Signal<DateFormatSpec>;
|
|
3078
|
-
/** Slot/literal layout for the current mode — single date or doubled range. */
|
|
3079
3033
|
protected readonly layout: _angular_core.Signal<FieldLayout>;
|
|
3080
3034
|
protected readonly monthNames: _angular_core.Signal<string[]>;
|
|
3081
3035
|
protected readonly weekdays: _angular_core.Signal<string[]>;
|
|
3082
|
-
/** Full weekday names for the grid column headers' accessible names. */
|
|
3083
3036
|
protected readonly weekdaysFull: _angular_core.Signal<string[]>;
|
|
3084
|
-
/** Localized "Month YYYY" caption — the grid's accessible name + live label. */
|
|
3085
3037
|
protected readonly monthYearLabel: _angular_core.Signal<string>;
|
|
3086
3038
|
protected readonly uid: string;
|
|
3087
3039
|
protected readonly labelId: string;
|
|
@@ -3104,7 +3056,6 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3104
3056
|
private addMonths;
|
|
3105
3057
|
private clampToBounds;
|
|
3106
3058
|
private focusGridDay;
|
|
3107
|
-
/** Full, unambiguous date for a day cell's accessible name. */
|
|
3108
3059
|
protected dayLabel(cell: DayCell): string;
|
|
3109
3060
|
protected readonly triggerClasses: _angular_core.Signal<string>;
|
|
3110
3061
|
protected readonly viewMonth: _angular_core.WritableSignal<Date>;
|
|
@@ -3113,9 +3064,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3113
3064
|
protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
|
|
3114
3065
|
private overlayRef;
|
|
3115
3066
|
private focusTrigger;
|
|
3116
|
-
/** Text shown in the field: masked single value, or the combined range string. */
|
|
3117
3067
|
protected readonly fieldText: _angular_core.Signal<string>;
|
|
3118
|
-
/** Format-mask placeholder (single) or the doubled range mask. */
|
|
3119
3068
|
protected readonly fieldPlaceholder: _angular_core.Signal<string>;
|
|
3120
3069
|
/** `size` attribute so the field hugs its mask width instead of stretching.
|
|
3121
3070
|
* +1 covers `size` under-counting the mask's wide glyphs (M/D/Y), which
|
|
@@ -3123,14 +3072,11 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3123
3072
|
* `font-family: var(--font-mono)` keeps every glyph equal width, so the
|
|
3124
3073
|
* width never shifts as you type. */
|
|
3125
3074
|
protected readonly fieldSize: _angular_core.Signal<number>;
|
|
3126
|
-
/** Per-slot overlay runs: digits at normal weight, unfilled positions
|
|
3127
|
-
* (format letters or `_` padding) muted — see displayParts(). */
|
|
3128
3075
|
protected readonly displaySlots: _angular_core.Signal<DisplayPart[]>;
|
|
3129
3076
|
protected readonly monthMenuOpen: _angular_core.WritableSignal<boolean>;
|
|
3130
3077
|
protected readonly yearMenuOpen: _angular_core.WritableSignal<boolean>;
|
|
3131
3078
|
protected readonly viewMonthIndex: _angular_core.Signal<number>;
|
|
3132
3079
|
protected readonly viewYear: _angular_core.Signal<number>;
|
|
3133
|
-
/** First year shown in the year grid; paged by YEAR_PAGE_SIZE within [minYear, maxYear]. */
|
|
3134
3080
|
protected readonly yearPageStart: _angular_core.WritableSignal<number>;
|
|
3135
3081
|
protected readonly yearsOnPage: _angular_core.Signal<number[]>;
|
|
3136
3082
|
protected readonly yearRangeLabel: _angular_core.Signal<string>;
|
|
@@ -3147,7 +3093,6 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3147
3093
|
protected selectYear(year: number, event: Event): void;
|
|
3148
3094
|
protected isDayDisabled(date: Date): boolean;
|
|
3149
3095
|
protected readonly daysGrid: _angular_core.Signal<DayCell[]>;
|
|
3150
|
-
/** daysGrid split into rows of 7 for the grid's `role="row"` structure. */
|
|
3151
3096
|
protected readonly weeksGrid: _angular_core.Signal<DayCell[][]>;
|
|
3152
3097
|
private getRangeContext;
|
|
3153
3098
|
protected open(moveFocusToGrid?: boolean): void;
|
|
@@ -3156,17 +3101,15 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3156
3101
|
/**
|
|
3157
3102
|
* Also the calendar glyph's handler. A POINTER open must not drag focus into
|
|
3158
3103
|
* the day grid: the reader did not ask to leave a field they may want to type
|
|
3159
|
-
* in
|
|
3160
|
-
*
|
|
3161
|
-
*
|
|
3162
|
-
* calls `open(true)` and enters the grid however the panel was opened.
|
|
3104
|
+
* in. So focus follows what the field IS — typeable, and the caret stays;
|
|
3105
|
+
* read-only, and the grid is the only thing worth focusing. The keyboard path is
|
|
3106
|
+
* unaffected: ArrowDown on the field calls `open(true)`.
|
|
3163
3107
|
*/
|
|
3164
3108
|
protected onFieldClick(): void;
|
|
3165
3109
|
private mobileEdit;
|
|
3166
3110
|
protected onFieldInput(event: Event): void;
|
|
3167
3111
|
/** Physical-keyboard editing (desktop): typed digits fill the caret's slot;
|
|
3168
|
-
* Backspace/Delete never shift digits across a separator.
|
|
3169
|
-
* shared segment editor. */
|
|
3112
|
+
* Backspace/Delete never shift digits across a separator. */
|
|
3170
3113
|
protected onFieldKeydown(event: KeyboardEvent): void;
|
|
3171
3114
|
/** Mobile keyboards don't fire a reliable `keydown` (Gboard reports keyCode 229 /
|
|
3172
3115
|
* "Unidentified"), so edits are routed here via `beforeinput`'s `inputType` instead.
|
|
@@ -3174,33 +3117,28 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3174
3117
|
* stashed and re-asserted in `onFieldInput`; the microtask expires the stash once
|
|
3175
3118
|
* preventDefault worked (no following `input` in the same task). */
|
|
3176
3119
|
protected onFieldBeforeInput(event: InputEvent): void;
|
|
3177
|
-
/**
|
|
3178
|
-
*
|
|
3179
|
-
* selection is cleared through the model so `_` placeholders are never
|
|
3180
|
-
* natively erased — only digits are editable. Shared by keydown + beforeinput. */
|
|
3120
|
+
/** A selection is cleared through the model so `_` placeholders are never
|
|
3121
|
+
* natively erased — only digits are editable. */
|
|
3181
3122
|
private runSegmentEdit;
|
|
3182
3123
|
/** Paste digits into the segment model at the caret slot — never a global
|
|
3183
3124
|
* flatten — so existing digits elsewhere in the field survive untouched. */
|
|
3184
3125
|
protected onFieldPaste(event: ClipboardEvent): void;
|
|
3185
3126
|
private countDigits;
|
|
3186
|
-
/**
|
|
3187
|
-
*
|
|
3188
|
-
*
|
|
3189
|
-
* empty when no digits remain. */
|
|
3127
|
+
/** The fallback for any `input` event with no preceding handled `beforeinput`
|
|
3128
|
+
* (IME, autofill, a suggestion): `raw` is re-read as a flat digit stream and
|
|
3129
|
+
* redistributed over the slots, since its own layout cannot be trusted. */
|
|
3190
3130
|
private commitRaw;
|
|
3191
|
-
/** Write masked text + caret into the DOM, then parse and validate it. */
|
|
3192
3131
|
private applyEditedText;
|
|
3193
3132
|
protected onFieldBlur(): void;
|
|
3194
|
-
/**
|
|
3195
|
-
*
|
|
3196
|
-
*
|
|
3197
|
-
* the same string, which leaves the caret untouched. */
|
|
3133
|
+
/** Writing `value` parks the caret at the end, so the explicit range has to
|
|
3134
|
+
* follow it; the later `[value]` binding writes the same string, which leaves
|
|
3135
|
+
* the caret untouched. */
|
|
3198
3136
|
private writeBackText;
|
|
3199
|
-
/** Caret just past the last digit
|
|
3200
|
-
*
|
|
3201
|
-
* once every slot is full. Empty segments naturally resolve to 0. */
|
|
3137
|
+
/** Caret just past the last digit a flat digit stream filled — the first slot
|
|
3138
|
+
* short of its max length, or the very end once every slot is full. */
|
|
3202
3139
|
private caretAfterFill;
|
|
3203
|
-
/**
|
|
3140
|
+
/** `commit` is the blur pass: only then is the field text rewritten from the
|
|
3141
|
+
* parsed value, and a half-filled range written through to `value`. */
|
|
3204
3142
|
private applyRangeText;
|
|
3205
3143
|
protected prevMonth(): void;
|
|
3206
3144
|
protected nextMonth(): void;
|
|
@@ -3440,7 +3378,7 @@ declare class BreadcrumbsComponent {
|
|
|
3440
3378
|
*/
|
|
3441
3379
|
declare class BreadcrumbsService {
|
|
3442
3380
|
private readonly _items;
|
|
3443
|
-
readonly items:
|
|
3381
|
+
readonly items: Signal<BreadcrumbItem[]>;
|
|
3444
3382
|
set(items: BreadcrumbItem[]): void;
|
|
3445
3383
|
push(item: BreadcrumbItem): void;
|
|
3446
3384
|
pop(): void;
|
|
@@ -3805,13 +3743,20 @@ declare class BannerComponent {
|
|
|
3805
3743
|
/** Fires when the user dismisses the banner. */
|
|
3806
3744
|
readonly closed: _angular_core.OutputEmitterRef<void>;
|
|
3807
3745
|
protected get noRail(): boolean;
|
|
3808
|
-
|
|
3809
|
-
|
|
3746
|
+
/** Announce this banner to a screen reader when it appears.
|
|
3747
|
+
*
|
|
3748
|
+
* Off by default: an `alert` region fires on INSERTION, so a banner that is page
|
|
3749
|
+
* furniture would interrupt the reader on every route into the page. Turn it on for
|
|
3750
|
+
* one the app raises in response to an event; for anything transient prefer
|
|
3751
|
+
* `ToastService`, which owns a live region built for the purpose. */
|
|
3752
|
+
readonly announce: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
3753
|
+
protected get ariaRole(): 'alert' | 'status' | null;
|
|
3754
|
+
protected get ariaLive(): 'assertive' | 'polite' | null;
|
|
3810
3755
|
protected readonly classes: _angular_core.Signal<string>;
|
|
3811
3756
|
protected readonly defaultIcon: _angular_core.Signal<IconName>;
|
|
3812
3757
|
protected onDismiss(): void;
|
|
3813
3758
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<BannerComponent, never>;
|
|
3814
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<BannerComponent, "ds-banner", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "accentRail": { "alias": "accentRail"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*", "[actions]"], true, never>;
|
|
3759
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<BannerComponent, "ds-banner", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "compact": { "alias": "compact"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "accentRail": { "alias": "accentRail"; "required": false; "isSignal": true; }; "announce": { "alias": "announce"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*", "[actions]"], true, never>;
|
|
3815
3760
|
}
|
|
3816
3761
|
|
|
3817
3762
|
type AlertVariant = 'info' | 'success' | 'warning' | 'error' | 'neutral';
|
|
@@ -3827,14 +3772,18 @@ declare class AlertComponent {
|
|
|
3827
3772
|
readonly icon: _angular_core.InputSignal<IconName | null>;
|
|
3828
3773
|
/** Fires when the user dismisses the alert. */
|
|
3829
3774
|
readonly closed: _angular_core.OutputEmitterRef<void>;
|
|
3830
|
-
|
|
3831
|
-
|
|
3775
|
+
/** Announce this alert to a screen reader when it appears. Off by default — see
|
|
3776
|
+
* `ds-banner`'s `announce` for why, and prefer `ToastService` for anything
|
|
3777
|
+
* transient. */
|
|
3778
|
+
readonly announce: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
3779
|
+
protected get ariaRole(): 'alert' | 'status' | null;
|
|
3780
|
+
protected get ariaLive(): 'assertive' | 'polite' | null;
|
|
3832
3781
|
protected readonly classes: _angular_core.Signal<string>;
|
|
3833
3782
|
protected readonly defaultIcon: _angular_core.Signal<IconName>;
|
|
3834
3783
|
protected readonly resolvedIcon: _angular_core.Signal<IconName>;
|
|
3835
3784
|
protected onDismiss(): void;
|
|
3836
3785
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<AlertComponent, never>;
|
|
3837
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<AlertComponent, "ds-alert", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*", "[actions]"], true, never>;
|
|
3786
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<AlertComponent, "ds-alert", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "announce": { "alias": "announce"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*", "[actions]"], true, never>;
|
|
3838
3787
|
}
|
|
3839
3788
|
|
|
3840
3789
|
type DropzoneFileState = 'queued' | 'uploading' | 'success' | 'error';
|
|
@@ -4065,8 +4014,15 @@ type TooltipPlacement = 'top' | 'bottom' | 'left' | 'right';
|
|
|
4065
4014
|
declare class TooltipDirective implements OnDestroy {
|
|
4066
4015
|
private readonly overlay;
|
|
4067
4016
|
private readonly host;
|
|
4017
|
+
/** Tip text. An empty string is how you turn the tooltip off — a host bound to a
|
|
4018
|
+
* value that may be blank needs no separate condition. */
|
|
4068
4019
|
readonly dsTooltip: _angular_core.InputSignal<string>;
|
|
4020
|
+
/** Which side the tip opens on. It does NOT flip: only the requested side is
|
|
4021
|
+
* offered to the overlay, so a tip with no room there is pushed rather than moved
|
|
4022
|
+
* to the opposite side. */
|
|
4069
4023
|
readonly dsTooltipPlacement: _angular_core.InputSignal<TooltipPlacement>;
|
|
4024
|
+
/** Milliseconds before the tip appears. Hiding is immediate — this delay only ever
|
|
4025
|
+
* suppresses a tip the pointer passed over on its way somewhere else. */
|
|
4070
4026
|
readonly dsTooltipDelay: _angular_core.InputSignal<number>;
|
|
4071
4027
|
private ref;
|
|
4072
4028
|
private timer;
|
|
@@ -4180,35 +4136,54 @@ interface ToastEntry {
|
|
|
4180
4136
|
readonly action?: ToastAction;
|
|
4181
4137
|
/** Auto-dismiss delay, counted from the moment the toast becomes VISIBLE — a
|
|
4182
4138
|
* queued toast must not expire while it is still waiting behind the cap.
|
|
4183
|
-
* 0
|
|
4139
|
+
* `0`, and any negative, means it never expires. */
|
|
4184
4140
|
readonly durationMs: number;
|
|
4185
4141
|
}
|
|
4186
|
-
interface ToastPromiseMessages {
|
|
4142
|
+
interface ToastPromiseMessages<T = unknown> {
|
|
4187
4143
|
readonly loading: string;
|
|
4188
|
-
readonly success: string | ((value:
|
|
4144
|
+
readonly success: string | ((value: T) => string);
|
|
4189
4145
|
readonly error: string | ((reason: unknown) => string);
|
|
4190
4146
|
}
|
|
4191
|
-
type DsToastHorizontalPosition = 'left' | 'center' | 'right';
|
|
4192
|
-
type DsToastVerticalPosition = 'top' | 'bottom';
|
|
4193
|
-
interface DsToastPosition {
|
|
4194
|
-
readonly horizontalPosition: DsToastHorizontalPosition;
|
|
4195
|
-
readonly verticalPosition: DsToastVerticalPosition;
|
|
4196
|
-
readonly offset: string;
|
|
4197
|
-
}
|
|
4198
4147
|
|
|
4199
4148
|
declare class ToastService {
|
|
4200
4149
|
private readonly overlay;
|
|
4201
|
-
private readonly position;
|
|
4202
4150
|
private readonly toastConfig;
|
|
4151
|
+
private readonly announcer;
|
|
4203
4152
|
private overlayRef;
|
|
4204
4153
|
private regionRef;
|
|
4205
4154
|
private nextId;
|
|
4155
|
+
private pendingAnnouncements;
|
|
4156
|
+
private pendingAssertive;
|
|
4157
|
+
private announceTimer;
|
|
4158
|
+
private scrimWatcher;
|
|
4159
|
+
constructor();
|
|
4206
4160
|
show(opts: ToastOptions): ToastRef;
|
|
4207
|
-
/** Show a loading toast for the duration of `
|
|
4208
|
-
* reflected in-place (same toast, no stack-up) as success/error variants
|
|
4209
|
-
|
|
4161
|
+
/** Show a loading toast for the duration of `source`. Resolution and rejection are
|
|
4162
|
+
* reflected in-place (same toast, no stack-up) as success/error variants, each with
|
|
4163
|
+
* its own auto-dismiss delay.
|
|
4164
|
+
*
|
|
4165
|
+
* Returns `source` itself, so the caller still owns rejection handling — an
|
|
4166
|
+
* un-`catch`ed call produces an unhandled rejection exactly as it would without a
|
|
4167
|
+
* toast. */
|
|
4168
|
+
promise<T>(source: Promise<T>, messages: ToastPromiseMessages<T>): Promise<T>;
|
|
4169
|
+
/** The announcement must NOT ride the visual toast: `aria-live` on an element created
|
|
4170
|
+
* together with its text announces nothing in NVDA or JAWS. The CDK announcer's region
|
|
4171
|
+
* exists from construction and only its text changes.
|
|
4172
|
+
*
|
|
4173
|
+
* Serialising a burst does not work either — `announce()` clears the region and writes
|
|
4174
|
+
* on a timeout, resolving its promise inside that callback, so the next message wipes
|
|
4175
|
+
* the previous one before anything can read it. One region change carrying every
|
|
4176
|
+
* message is the only shape that survives. */
|
|
4177
|
+
private announce;
|
|
4210
4178
|
dismissAll(): void;
|
|
4211
4179
|
private ensureRegion;
|
|
4180
|
+
/** Keeps the toast above a scrim opened AFTER it. `--layer-toast` cannot: CDK gives
|
|
4181
|
+
* every overlay host `popover="manual"`, and the browser's top layer paints in the
|
|
4182
|
+
* order things were shown, ignoring z-index. Re-showing the host is the only lever.
|
|
4183
|
+
*
|
|
4184
|
+
* Scrimmed overlays only: the published layer scale puts `--layer-tooltip` above the
|
|
4185
|
+
* toast. */
|
|
4186
|
+
private keepAboveScrims;
|
|
4212
4187
|
private buildPositionStrategy;
|
|
4213
4188
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToastService, never>;
|
|
4214
4189
|
static ɵprov: _angular_core.ɵɵInjectableDeclaration<ToastService>;
|
|
@@ -4216,27 +4191,52 @@ declare class ToastService {
|
|
|
4216
4191
|
|
|
4217
4192
|
declare class ToastRegionComponent {
|
|
4218
4193
|
/** Cap on concurrently visible toasts. Extras are queued and shown as
|
|
4219
|
-
* earlier ones dismiss. 0 = unlimited
|
|
4194
|
+
* earlier ones dismiss. `0` = unlimited. */
|
|
4220
4195
|
readonly maxVisible: _angular_core.InputSignal<number>;
|
|
4221
4196
|
protected readonly visibleEntries: _angular_core.WritableSignal<readonly ToastEntry[]>;
|
|
4222
4197
|
protected readonly leaving: _angular_core.WritableSignal<ReadonlySet<number>>;
|
|
4223
4198
|
private readonly pendingQueue;
|
|
4224
4199
|
private readonly timers;
|
|
4200
|
+
private readonly leaveTimers;
|
|
4201
|
+
private readonly remaining;
|
|
4202
|
+
private readonly startedAt;
|
|
4203
|
+
private hovered;
|
|
4204
|
+
private focusWithin;
|
|
4205
|
+
private readonly host;
|
|
4225
4206
|
private readonly position;
|
|
4207
|
+
constructor();
|
|
4226
4208
|
/** Newest goes NEAREST the anchor, so the toast that just fired appears where the
|
|
4227
4209
|
* stack is pinned rather than at the far end of a list the reader has to hunt
|
|
4228
4210
|
* down. DOM order is the visual order, so this also keeps the reading order. */
|
|
4229
4211
|
private readonly newestFirst;
|
|
4230
4212
|
add(entry: ToastEntry): void;
|
|
4231
4213
|
private show;
|
|
4232
|
-
|
|
4214
|
+
/** FLIP, rather than the usual absolute stack: absolute positioning collapses the region
|
|
4215
|
+
* to zero height, and it lives in a CDK pane sized to its content, so the hit area goes
|
|
4216
|
+
* with it. */
|
|
4217
|
+
private slideNeighbours;
|
|
4218
|
+
private toastNodes;
|
|
4219
|
+
private measureTops;
|
|
4220
|
+
private arm;
|
|
4233
4221
|
private clearCountdown;
|
|
4234
|
-
|
|
4235
|
-
|
|
4222
|
+
protected onHover(entered: boolean): void;
|
|
4223
|
+
protected onFocusWithin(event: FocusEvent | true): void;
|
|
4224
|
+
private syncPause;
|
|
4225
|
+
private get paused();
|
|
4226
|
+
private pauseAll;
|
|
4227
|
+
private resumeAll;
|
|
4228
|
+
/** Replace fields of an already-visible or queued toast in place. Patching
|
|
4229
|
+
* `durationMs` restarts the clock, and on a QUEUED toast it takes effect only on
|
|
4230
|
+
* promotion — otherwise a duration would burn down while the toast is invisible. */
|
|
4231
|
+
update(id: number, patch: Partial<Pick<ToastEntry, 'body' | 'title' | 'variant' | 'dismissible' | 'action' | 'durationMs'>>): void;
|
|
4236
4232
|
remove(id: number): void;
|
|
4233
|
+
/** The leave transition is a public token, so its length is whatever the consumer
|
|
4234
|
+
* set — read it off the node rather than assuming. Reduced motion zeroes it, which
|
|
4235
|
+
* is why the floor applies only when there is nothing to measure. */
|
|
4236
|
+
private leaveDuration;
|
|
4237
4237
|
protected isLeaving(id: number): boolean;
|
|
4238
4238
|
clear(): void;
|
|
4239
|
-
private
|
|
4239
|
+
private drainQueue;
|
|
4240
4240
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToastRegionComponent, never>;
|
|
4241
4241
|
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToastRegionComponent, "ds-toast-region", never, { "maxVisible": { "alias": "maxVisible"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
|
|
4242
4242
|
}
|
|
@@ -4246,12 +4246,12 @@ declare class ToastRegionComponent {
|
|
|
4246
4246
|
* AND by static showcases that need to display a toast specimen inline.
|
|
4247
4247
|
*/
|
|
4248
4248
|
declare class ToastComponent {
|
|
4249
|
-
/** Severity — drives colour
|
|
4249
|
+
/** Severity — drives colour and the default icon or spinner. */
|
|
4250
4250
|
readonly variant: _angular_core.InputSignal<ToastVariant>;
|
|
4251
4251
|
/** Optional bold heading above the message. */
|
|
4252
4252
|
readonly title: _angular_core.InputSignal<string>;
|
|
4253
|
-
/**
|
|
4254
|
-
readonly
|
|
4253
|
+
/** The same field `ToastOptions.body` carries, so a specimen and a raised toast agree. */
|
|
4254
|
+
readonly body: _angular_core.InputSignal<string>;
|
|
4255
4255
|
/** Show a close button that emits `closed`. */
|
|
4256
4256
|
readonly dismissible: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
4257
4257
|
/** Override the variant's default icon. */
|
|
@@ -4263,22 +4263,13 @@ declare class ToastComponent {
|
|
|
4263
4263
|
protected readonly isLoading: _angular_core.Signal<boolean>;
|
|
4264
4264
|
protected onAction(action: ToastAction): void;
|
|
4265
4265
|
protected readonly classes: _angular_core.Signal<string>;
|
|
4266
|
-
/** Errors/warnings interrupt (assertive); info/success wait their turn. */
|
|
4267
|
-
protected readonly role: _angular_core.Signal<"status" | "alert">;
|
|
4268
4266
|
protected readonly defaultIcon: _angular_core.Signal<IconName>;
|
|
4269
4267
|
protected onDismiss(): void;
|
|
4270
4268
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToastComponent, never>;
|
|
4271
|
-
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToastComponent, "ds-toast", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "
|
|
4269
|
+
static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToastComponent, "ds-toast", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "body": { "alias": "body"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "action": { "alias": "action"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*", "[actions]"], true, never>;
|
|
4272
4270
|
}
|
|
4273
4271
|
|
|
4274
|
-
declare const DS_TOAST_POSITION: InjectionToken<DsToastPosition>;
|
|
4275
4272
|
declare const DS_TOAST_POSITION_DEFAULT: DsToastPosition;
|
|
4276
|
-
interface DsToastConfig {
|
|
4277
|
-
/** Maximum number of toasts visible at once. Extras are queued and shown
|
|
4278
|
-
* as earlier ones dismiss. Defaults to unlimited when not provided. */
|
|
4279
|
-
readonly maxVisible?: number;
|
|
4280
|
-
}
|
|
4281
|
-
declare const DS_TOAST_CONFIG: InjectionToken<DsToastConfig>;
|
|
4282
4273
|
|
|
4283
4274
|
type DrawerPlacement = 'right' | 'left' | 'top' | 'bottom';
|
|
4284
4275
|
|
|
@@ -4560,9 +4551,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4560
4551
|
protected readonly filteredItems: _angular_core.Signal<AutocompleteItem<T>[]>;
|
|
4561
4552
|
protected readonly filteredOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
|
|
4562
4553
|
protected isGroup(item: AutocompleteItem<T>): item is AutocompleteOptionGroup<T>;
|
|
4563
|
-
/** Whether to show the "Create «text»" row at the bottom of the panel. */
|
|
4564
4554
|
protected readonly showCreateRow: _angular_core.Signal<boolean>;
|
|
4565
|
-
/** Flat list of visible options used for keyboard navigation index. */
|
|
4566
4555
|
protected readonly visibleOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
|
|
4567
4556
|
/** The visible label wins the accessible name when there is one — otherwise the
|
|
4568
4557
|
* placeholder would announce over it, and `placeholder` always carries a default. */
|
|
@@ -4570,14 +4559,13 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4570
4559
|
protected readonly selectedTags: _angular_core.Signal<AutocompleteOption<T>[]>;
|
|
4571
4560
|
private readonly chipsMode;
|
|
4572
4561
|
private readonly showsEveryChip;
|
|
4573
|
-
/** True for
|
|
4574
|
-
*
|
|
4562
|
+
/** True for a number as well as `'fit'`: a number is a ceiling, not a promise,
|
|
4563
|
+
* so the row still measures. */
|
|
4575
4564
|
protected readonly fitsChipsToWidth: _angular_core.Signal<boolean>;
|
|
4576
|
-
/** How many chips the row is ASKED to render before measuring
|
|
4577
|
-
*
|
|
4578
|
-
*
|
|
4579
|
-
*
|
|
4580
|
-
* never fills, and the fit fell back to "show them all" without a word. */
|
|
4565
|
+
/** How many chips the row is ASKED to render before measuring. It has to be the
|
|
4566
|
+
* ceiling and not the selection: the measurement caches chip widths from a
|
|
4567
|
+
* render that holds them all, so with a numeric cap that render never happens,
|
|
4568
|
+
* the cache never fills, and the fit silently falls back to showing them all. */
|
|
4581
4569
|
private readonly chipBudget;
|
|
4582
4570
|
private readonly chipsThatFit;
|
|
4583
4571
|
/** What the trigger renders. Separate from `selectedTags`, which stays the
|
|
@@ -4592,15 +4580,12 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4592
4580
|
protected readonly placeholderText: _angular_core.Signal<string>;
|
|
4593
4581
|
protected isSelected(option: AutocompleteOption<T>): boolean;
|
|
4594
4582
|
protected optionClass(option: AutocompleteOption<T>): string;
|
|
4595
|
-
/**
|
|
4596
|
-
* every option is disabled. */
|
|
4583
|
+
/** -1 when nothing is pickable and there is no create row to fall back on. */
|
|
4597
4584
|
private firstEnabledIndex;
|
|
4598
|
-
/**
|
|
4599
|
-
* row
|
|
4600
|
-
*
|
|
4601
|
-
* reachable. Returns -1 when every option is disabled. */
|
|
4585
|
+
/** Steps OVER a disabled option rather than landing on it. `step` is +1/-1; the
|
|
4586
|
+
* create row (past the last option) is always reachable, and -1 comes back when
|
|
4587
|
+
* every option is disabled. */
|
|
4602
4588
|
private nextEnabledIndex;
|
|
4603
|
-
/** Flat index of the given option within the visible (filtered) list. */
|
|
4604
4589
|
protected flatIndexOf(option: AutocompleteOption<T>): number;
|
|
4605
4590
|
constructor();
|
|
4606
4591
|
private setOpen;
|
|
@@ -4622,9 +4607,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4622
4607
|
*
|
|
4623
4608
|
* `value.set(null)` alone is not enough from outside: the typed query is
|
|
4624
4609
|
* component state with no input bound to it, so the text stays on screen after
|
|
4625
|
-
* the value goes.
|
|
4626
|
-
* ends up querying the inner `<input>` and dispatching a synthetic `input`
|
|
4627
|
-
* event.
|
|
4610
|
+
* the value goes.
|
|
4628
4611
|
*
|
|
4629
4612
|
* Deliberately does NOT move focus — the caller may be navigating away, and
|
|
4630
4613
|
* stealing focus back into a field they just left is worse than leaving it.
|
|
@@ -5195,17 +5178,12 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
5195
5178
|
protected readonly selectedOptions: _angular_core.Signal<MultiSelectOption[]>;
|
|
5196
5179
|
private readonly chipsMode;
|
|
5197
5180
|
private readonly showsEveryChip;
|
|
5198
|
-
/** True for BOTH `'fit'` and a number: a number is a ceiling, not a promise
|
|
5199
|
-
*
|
|
5200
|
-
* wide enough for. Without that, a phone-width trigger honoured the count and
|
|
5201
|
-
* wrapped the text input onto a second line, which is the one thing the cap
|
|
5202
|
-
* exists to prevent. */
|
|
5181
|
+
/** True for BOTH `'fit'` and a number: a number is a ceiling, not a promise, so
|
|
5182
|
+
* the row still measures and shows only what the trigger is wide enough for. */
|
|
5203
5183
|
protected readonly fitsChipsToWidth: _angular_core.Signal<boolean>;
|
|
5204
5184
|
/** How many chips the row is ASKED to render before measuring: everything for
|
|
5205
|
-
* `'fit'`, the ceiling for a number. It
|
|
5206
|
-
*
|
|
5207
|
-
* holds them all — with a numeric cap that render never happens, the cache
|
|
5208
|
-
* never fills, and the fit fell back to "show them all" without a word. */
|
|
5185
|
+
* `'fit'`, the ceiling for a number. It must be the ceiling and not the selection —
|
|
5186
|
+
* the width cache only fills from a render that holds every chip. */
|
|
5209
5187
|
private readonly chipBudget;
|
|
5210
5188
|
private readonly chipsThatFit;
|
|
5211
5189
|
protected readonly visibleChips: _angular_core.Signal<MultiSelectOption[]>;
|
|
@@ -5239,11 +5217,8 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
5239
5217
|
protected clearValue(event: MouseEvent): void;
|
|
5240
5218
|
/**
|
|
5241
5219
|
* Empties the selection from outside — a "reset filters" button, a form the app
|
|
5242
|
-
* clears itself.
|
|
5243
|
-
*
|
|
5244
|
-
*
|
|
5245
|
-
* Deliberately does NOT move focus: the caller may be navigating away, and
|
|
5246
|
-
* stealing focus back into a field they just left is worse than leaving it.
|
|
5220
|
+
* clears itself. Deliberately does NOT move focus: the caller may be navigating
|
|
5221
|
+
* away.
|
|
5247
5222
|
*/
|
|
5248
5223
|
clear(): void;
|
|
5249
5224
|
protected removeValue(value: string): void;
|
|
@@ -5615,5 +5590,5 @@ declare class FieldClickFocusDirective {
|
|
|
5615
5590
|
static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
|
|
5616
5591
|
}
|
|
5617
5592
|
|
|
5618
|
-
export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppLayoutComponent, AuthLayoutComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BodyScrollLockService, BottomSheetComponent, BrandNameDirective, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_FIELD_GROUP, DS_FIELD_WARNING_KIND, DS_ICON_REGISTRY,
|
|
5619
|
-
export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteItem, AutocompleteOption, AutocompleteOptionGroup, AutocompleteValueOverflow, AutocompleteWidth, AvatarSize, AvatarStatus, AvatarTintOptions, BannerVariant, BreadcrumbItem, ButtonColor, ButtonType, ButtonVariant, CardElevation, CardPadding, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerSpacing, DividerVariant, DrawerPlacement, DropzoneFile, DropzoneFileState, DsConfig, DsControlWidth, DsFieldError, DsFieldErrorsInput, DsFieldGroupContext, DsIconRegistry, DsOption, DsOptionGroup, DsOptionItem, DsPasswordRule, DsPasswordRuleState, DsScrollReset, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions,
|
|
5593
|
+
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_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 };
|
|
5594
|
+
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, 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 };
|