@ids-group-ltd/ids-design-system 0.11.2 → 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 +119 -2
- 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 +262 -338
- package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
- package/migrations/0.11.3.json +152 -0
- package/package.json +1 -1
- package/styles/_dropdown-overlay.scss +25 -32
- package/styles/_ds-color.scss +31 -12
- 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 +5 -2
- package/types/ids-group-ltd-ids-design-system.d.ts +115 -190
|
@@ -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
|
*/
|
|
@@ -335,8 +325,7 @@ interface DsOptionGroup<T = string> {
|
|
|
335
325
|
/**
|
|
336
326
|
* What a picker's `options` input takes: flat options, groups, or both mixed.
|
|
337
327
|
* 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.
|
|
328
|
+
* answer "what if both are set" by silently ignoring one.
|
|
340
329
|
*/
|
|
341
330
|
type DsOptionItem<T = string> = DsOption<T> | DsOptionGroup<T>;
|
|
342
331
|
declare function isDsOptionGroup<T>(item: DsOptionItem<T>): item is DsOptionGroup<T>;
|
|
@@ -980,10 +969,8 @@ declare class BrandNameDirective {
|
|
|
980
969
|
* MFA — and the counterpart to `ds-app-layout`, which only ever covers the
|
|
981
970
|
* screens behind the login.
|
|
982
971
|
*
|
|
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
|
|
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
|
|
987
974
|
* insets a notched phone in landscape needs.
|
|
988
975
|
*
|
|
989
976
|
* The brand row takes the same CONTRACT as `ds-sidenav` — a `brand` string gets a
|
|
@@ -1011,10 +998,9 @@ declare class BrandNameDirective {
|
|
|
1011
998
|
declare class AuthLayoutComponent {
|
|
1012
999
|
/** Wordmark beside the letter-mark tile. For a logo image/SVG, project it into
|
|
1013
1000
|
* 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. */
|
|
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. */
|
|
1018
1004
|
readonly brand: _angular_core.InputSignal<string | null>;
|
|
1019
1005
|
/** Letter-mark glyph when it differs from the brand's first letter (e.g. an
|
|
1020
1006
|
* "A" tile beside the "MyAdmin" wordmark). Empty = first letter of `brand`;
|
|
@@ -1032,14 +1018,12 @@ declare class AuthLayoutComponent {
|
|
|
1032
1018
|
readonly cardElevation: _angular_core.InputSignal<CardElevation>;
|
|
1033
1019
|
/** Card padding, passed through to `ds-card`. `md` tightens a short form. */
|
|
1034
1020
|
readonly cardPadding: _angular_core.InputSignal<CardPadding>;
|
|
1035
|
-
/** Announce the card as the page's `main` landmark.
|
|
1036
|
-
*
|
|
1037
|
-
*
|
|
1038
|
-
*
|
|
1039
|
-
*
|
|
1040
|
-
* 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. */
|
|
1041
1026
|
readonly landmark: _angular_core.InputSignal<"none" | "main">;
|
|
1042
|
-
/** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
|
|
1043
1027
|
protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
|
|
1044
1028
|
protected readonly hasBrandName: _angular_core.Signal<boolean>;
|
|
1045
1029
|
/** Spread, not `charAt(0)`: the latter indexes UTF-16 code UNITS, so a brand
|
|
@@ -1898,8 +1882,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1898
1882
|
/** Flat options or option groups rendered in the dropdown panel. */
|
|
1899
1883
|
readonly options: _angular_core.InputSignal<readonly SelectItem[]>;
|
|
1900
1884
|
/** 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. */
|
|
1885
|
+
* consumer's `ds-select { --ds-dropdown-panel-*: … }` reaches it. */
|
|
1903
1886
|
private readonly panelTokens;
|
|
1904
1887
|
/** Trigger width — `fill` stretches to the container and pins the panel to the
|
|
1905
1888
|
* trigger's width; `content` hugs the trigger's own content and takes that width
|
|
@@ -1967,7 +1950,6 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1967
1950
|
/** Active option for `aria-activedescendant` (combobox keeps DOM focus). */
|
|
1968
1951
|
protected readonly activeDescendant: _angular_core.Signal<string | null>;
|
|
1969
1952
|
protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
|
|
1970
|
-
/** Effective disabled — own `disabled` input OR the reactive-forms state. */
|
|
1971
1953
|
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
1972
1954
|
protected readonly trigger: _angular_core.Signal<ElementRef<HTMLElement>>;
|
|
1973
1955
|
protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
|
|
@@ -1994,9 +1976,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
|
|
|
1994
1976
|
protected clearValue(event: MouseEvent): void;
|
|
1995
1977
|
/**
|
|
1996
1978
|
* 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.
|
|
1979
|
+
* clears itself.
|
|
2000
1980
|
*
|
|
2001
1981
|
* Deliberately does NOT move focus: the caller may be navigating away, and
|
|
2002
1982
|
* stealing focus back into a field they just left is worse than leaving it.
|
|
@@ -2115,10 +2095,6 @@ type TableFilterMode = 'client' | 'server' | 'none';
|
|
|
2115
2095
|
* - `'client'` — the table reorders `data()` itself, for a table holding every row.
|
|
2116
2096
|
* - `'none'` — nothing sorts, and `sortable` columns render no affordance rather
|
|
2117
2097
|
* 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
2098
|
*/
|
|
2123
2099
|
type TableSortMode = 'client' | 'server' | 'none';
|
|
2124
2100
|
/** `'single'` closes the open row when another is expanded; `'multiple'` (default)
|
|
@@ -2534,15 +2510,10 @@ declare class TableComponent<T extends object> {
|
|
|
2534
2510
|
* `skeleton` paints "No rows yet" under the spinner on a zero-row reload. */
|
|
2535
2511
|
protected readonly showsEmptyRow: _angular_core.Signal<boolean>;
|
|
2536
2512
|
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
2513
|
protected readonly orderedColumns: _angular_core.Signal<readonly TableColumn<T>[]>;
|
|
2540
|
-
/** Columns actually rendered — reordered, then hidden ones skipped. */
|
|
2541
2514
|
protected readonly visibleColumns: _angular_core.Signal<readonly TableColumn<T>[]>;
|
|
2542
|
-
/** Columns the user may toggle — drives the header column picker. */
|
|
2543
2515
|
protected readonly hideableColumns: _angular_core.Signal<readonly TableColumn<T>[]>;
|
|
2544
2516
|
protected readonly hasColumnPicker: _angular_core.Signal<boolean>;
|
|
2545
|
-
/** The trailing utility column hosts the picker button and/or row kebabs. */
|
|
2546
2517
|
protected readonly hasUtilityColumn: _angular_core.Signal<boolean>;
|
|
2547
2518
|
protected isColumnVisible(col: TableColumn<T>): boolean;
|
|
2548
2519
|
/** The last visible column can't be hidden — an all-hidden grid is useless. */
|
|
@@ -2557,24 +2528,16 @@ declare class TableComponent<T extends object> {
|
|
|
2557
2528
|
protected readonly filterSearch: _angular_core.WritableSignal<string>;
|
|
2558
2529
|
private readonly headerFilters;
|
|
2559
2530
|
private readonly headerFilterByKey;
|
|
2560
|
-
/** The projected filter for a column, when the host supplied one. */
|
|
2561
2531
|
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
2532
|
protected hasColumnFilter(col: TableColumn<T>): boolean;
|
|
2565
|
-
/** A column is "actively filtered" when at least one of its values is unchecked. */
|
|
2566
2533
|
protected isColumnFiltered(col: TableColumn<T>): boolean;
|
|
2567
|
-
/** The checklist's domain: what the host declared, else what is in hand. */
|
|
2568
2534
|
private optionsFor;
|
|
2569
|
-
/** Distinct values of the open column, narrowed by the popover search box. */
|
|
2570
2535
|
protected readonly filterValues: _angular_core.Signal<readonly string[]>;
|
|
2571
2536
|
protected readonly filterSelectedCount: _angular_core.Signal<number>;
|
|
2572
2537
|
protected isFilterValueChecked(value: string): boolean;
|
|
2573
2538
|
protected onColumnFilterClick(col: TableColumn<T>, event: Event): void;
|
|
2574
2539
|
protected onFilterSearch(event: Event): void;
|
|
2575
2540
|
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
2541
|
protected headerFilterContext(col: TableColumn<T>): {
|
|
2579
2542
|
$implicit: unknown;
|
|
2580
2543
|
column: unknown;
|
|
@@ -2598,9 +2561,8 @@ declare class TableComponent<T extends object> {
|
|
|
2598
2561
|
private static readonly RESIZE_PAGE;
|
|
2599
2562
|
private static readonly MIN_COLUMN_WIDTH;
|
|
2600
2563
|
private resizeState;
|
|
2601
|
-
/**
|
|
2602
|
-
*
|
|
2603
|
-
* class instead, see `fitsContent`. */
|
|
2564
|
+
/** `'content'` is not a pixel value — it is carried by a class instead, see
|
|
2565
|
+
* `fitsContent`. */
|
|
2604
2566
|
protected columnWidth(col: TableColumn<T>): number | null;
|
|
2605
2567
|
/** Shrink-to-content mode, unless the user has dragged this column — a drag is a
|
|
2606
2568
|
* deliberate pixel width and must win over the declared intent. */
|
|
@@ -2619,8 +2581,7 @@ declare class TableComponent<T extends object> {
|
|
|
2619
2581
|
* drag changes one column and leaves the others where they were — the
|
|
2620
2582
|
* auto-sized geometry is kept rather than lost at the first grab.
|
|
2621
2583
|
*
|
|
2622
|
-
*
|
|
2623
|
-
* 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
|
|
2624
2585
|
* column order.
|
|
2625
2586
|
*/
|
|
2626
2587
|
private lockMeasuredWidths;
|
|
@@ -2655,47 +2616,27 @@ declare class TableComponent<T extends object> {
|
|
|
2655
2616
|
min: number;
|
|
2656
2617
|
max: number;
|
|
2657
2618
|
} | 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
2619
|
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
2620
|
protected onResizeKey(col: TableColumn<T>, event: KeyboardEvent): void;
|
|
2669
2621
|
/**
|
|
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.
|
|
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.
|
|
2677
2626
|
*/
|
|
2678
2627
|
private stepColumnWidth;
|
|
2679
2628
|
private headerCellFor;
|
|
2680
2629
|
protected onColumnWidthStep(col: TableColumn<T>, delta: number | 'auto'): void;
|
|
2681
2630
|
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
2631
|
protected readonly filteredData: _angular_core.Signal<readonly T[]>;
|
|
2686
|
-
/** Client-side sort over the filtered data set — only in `'client'` mode. */
|
|
2687
2632
|
protected readonly sortedData: _angular_core.Signal<readonly T[]>;
|
|
2688
|
-
/** Current page's slice of the sorted rows, when paginating. */
|
|
2689
2633
|
protected readonly pagedData: _angular_core.Signal<readonly T[]>;
|
|
2690
|
-
/**
|
|
2691
|
-
* Virtual mode windows this further; `rowSlots` is what the loop walks. */
|
|
2634
|
+
/** Virtual mode windows this further; `rowSlots` is what the loop walks. */
|
|
2692
2635
|
protected readonly displayData: _angular_core.Signal<readonly T[]>;
|
|
2693
2636
|
/**
|
|
2694
2637
|
* The single live-region line. Loading wins while it lasts — a sort
|
|
2695
2638
|
* 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.
|
|
2639
|
+
* state they cannot inspect yet.
|
|
2699
2640
|
*
|
|
2700
2641
|
* `aria-live="polite"` does not announce a region's INITIAL content, so the
|
|
2701
2642
|
* unsorted first render is silent; only real changes speak.
|
|
@@ -2715,7 +2656,6 @@ declare class TableComponent<T extends object> {
|
|
|
2715
2656
|
* ones that have arrived — otherwise the spacers shrink to the loaded slice
|
|
2716
2657
|
* and the scrollbar lies about the length of the list. */
|
|
2717
2658
|
protected readonly virtualCount: _angular_core.Signal<number>;
|
|
2718
|
-
/** `null` when not virtualizing — the row loop then walks `displayData()` whole. */
|
|
2719
2659
|
protected readonly virtualWindow: _angular_core.Signal<{
|
|
2720
2660
|
start: number;
|
|
2721
2661
|
end: number;
|
|
@@ -2741,32 +2681,27 @@ declare class TableComponent<T extends object> {
|
|
|
2741
2681
|
protected isStriped(absoluteIndex: number): boolean;
|
|
2742
2682
|
protected readonly allSelected: _angular_core.Signal<boolean>;
|
|
2743
2683
|
protected readonly someSelected: _angular_core.Signal<boolean>;
|
|
2744
|
-
/** Select-all is page-scoped only when paginating. */
|
|
2745
2684
|
protected readonly selectAllLabel: _angular_core.Signal<"Select all rows on this page" | "Select all rows">;
|
|
2746
2685
|
protected readonly allExpanded: _angular_core.Signal<boolean>;
|
|
2747
2686
|
protected readonly expandAllVisible: _angular_core.Signal<boolean>;
|
|
2748
2687
|
protected readonly expandAllLabel: _angular_core.Signal<string>;
|
|
2749
2688
|
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
2689
|
protected readonly expandedColspan: _angular_core.Signal<number>;
|
|
2753
2690
|
protected readonly hasRowActions: _angular_core.Signal<boolean>;
|
|
2754
|
-
/** Row whose kebab menu is open — drives the per-row `disabled` predicates. */
|
|
2755
2691
|
protected readonly menuRow: _angular_core.WritableSignal<T | null>;
|
|
2756
2692
|
private readonly rowMenuPopover;
|
|
2757
2693
|
private readonly columnPickerPopover;
|
|
2758
2694
|
protected readonly columnSheetOpen: _angular_core.WritableSignal<boolean>;
|
|
2759
2695
|
private readonly coarsePointerState;
|
|
2760
2696
|
/** Whether the column panel opens as a sheet and the drag handle stands down.
|
|
2761
|
-
* Keyed on the pointer, not the viewport — see
|
|
2697
|
+
* Keyed on the pointer, not the viewport — see the matching media query in
|
|
2698
|
+
* `table.component.scss`. */
|
|
2762
2699
|
protected readonly coarsePointer: _angular_core.Signal<boolean>;
|
|
2763
2700
|
protected readonly columnPickerOpened: _angular_core.Signal<boolean>;
|
|
2764
2701
|
protected onColumnPickerClick(event: Event): void;
|
|
2765
2702
|
protected readonly hasTruncate: _angular_core.Signal<boolean>;
|
|
2766
2703
|
private readonly cellTextPopover;
|
|
2767
2704
|
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
2705
|
protected onCellClipClick(row: T, col: TableColumn<T>, event: Event): void;
|
|
2771
2706
|
/** Clipped horizontally — itself or anything it renders. A `dsCellTemplate`
|
|
2772
2707
|
* puts the ellipsis on a descendant, so testing only the wrapper misses it. */
|
|
@@ -2809,14 +2744,11 @@ declare class TableComponent<T extends object> {
|
|
|
2809
2744
|
protected onRowMousedown(): void;
|
|
2810
2745
|
protected onRowClick(row: T, event: Event): void;
|
|
2811
2746
|
protected onRowKey(row: T, event: Event): void;
|
|
2812
|
-
/** Accessible name for an interactive row, taken from the first visible column. */
|
|
2813
2747
|
protected rowAriaLabel(row: T): string;
|
|
2814
2748
|
/** Row identity — the `rowId` accessor when given, else `row.id`. Public so a
|
|
2815
2749
|
* host reading `selectedIds`/`expandedIds` can compute the same keys. */
|
|
2816
2750
|
rowKey(row: T): string;
|
|
2817
|
-
/** Whether this column's header is an actual sort control right now. */
|
|
2818
2751
|
protected sortableCol(col: TableColumn<T>): boolean;
|
|
2819
|
-
/** `aria-sort` value for a header: only meaningful on sortable columns. */
|
|
2820
2752
|
protected ariaSort(col: TableColumn<T>): 'ascending' | 'descending' | 'none' | null;
|
|
2821
2753
|
protected onSort(col: TableColumn<T>): void;
|
|
2822
2754
|
protected headerClasses(col: TableColumn<T>): string;
|
|
@@ -2842,7 +2774,7 @@ declare class TableComponent<T extends object> {
|
|
|
2842
2774
|
* revoked — a URL the caller supplied is theirs to manage. */
|
|
2843
2775
|
private downloadFile;
|
|
2844
2776
|
/** Deterministic per-cell width so skeleton rows look organic but stable
|
|
2845
|
-
* across re-renders.
|
|
2777
|
+
* across re-renders. */
|
|
2846
2778
|
protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
|
|
2847
2779
|
private watchPointer;
|
|
2848
2780
|
static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
|
|
@@ -3040,7 +2972,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3040
2972
|
readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
|
|
3041
2973
|
/** Accessible name when no visible `label` is provided. */
|
|
3042
2974
|
readonly ariaLabel: _angular_core.InputSignal<string | null>;
|
|
3043
|
-
/**
|
|
2975
|
+
/** Lower bound for the year dropdown in the calendar header. */
|
|
3044
2976
|
readonly minYear: _angular_core.InputSignal<number>;
|
|
3045
2977
|
/** Upper bound for the year dropdown in the calendar header. */
|
|
3046
2978
|
readonly maxYear: _angular_core.InputSignal<number>;
|
|
@@ -3062,7 +2994,8 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3062
2994
|
* the panel shows its month and grid focus lands on its exact day.
|
|
3063
2995
|
* Never written to `value` — selection stays with the user. */
|
|
3064
2996
|
readonly defaultDate: _angular_core.InputSignal<Date | null>;
|
|
3065
|
-
/** 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. */
|
|
3066
2999
|
readonly allowInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
|
|
3067
3000
|
protected readonly isDisabled: _angular_core.Signal<boolean>;
|
|
3068
3001
|
protected readonly hintId: _angular_core.Signal<string | null>;
|
|
@@ -3075,13 +3008,10 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3075
3008
|
readonly resolvedLocale: _angular_core.Signal<string>;
|
|
3076
3009
|
protected readonly resolvedFirstDay: _angular_core.Signal<number>;
|
|
3077
3010
|
protected readonly formatSpec: _angular_core.Signal<DateFormatSpec>;
|
|
3078
|
-
/** Slot/literal layout for the current mode — single date or doubled range. */
|
|
3079
3011
|
protected readonly layout: _angular_core.Signal<FieldLayout>;
|
|
3080
3012
|
protected readonly monthNames: _angular_core.Signal<string[]>;
|
|
3081
3013
|
protected readonly weekdays: _angular_core.Signal<string[]>;
|
|
3082
|
-
/** Full weekday names for the grid column headers' accessible names. */
|
|
3083
3014
|
protected readonly weekdaysFull: _angular_core.Signal<string[]>;
|
|
3084
|
-
/** Localized "Month YYYY" caption — the grid's accessible name + live label. */
|
|
3085
3015
|
protected readonly monthYearLabel: _angular_core.Signal<string>;
|
|
3086
3016
|
protected readonly uid: string;
|
|
3087
3017
|
protected readonly labelId: string;
|
|
@@ -3104,7 +3034,6 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3104
3034
|
private addMonths;
|
|
3105
3035
|
private clampToBounds;
|
|
3106
3036
|
private focusGridDay;
|
|
3107
|
-
/** Full, unambiguous date for a day cell's accessible name. */
|
|
3108
3037
|
protected dayLabel(cell: DayCell): string;
|
|
3109
3038
|
protected readonly triggerClasses: _angular_core.Signal<string>;
|
|
3110
3039
|
protected readonly viewMonth: _angular_core.WritableSignal<Date>;
|
|
@@ -3113,9 +3042,7 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3113
3042
|
protected readonly panelTpl: _angular_core.Signal<TemplateRef<unknown>>;
|
|
3114
3043
|
private overlayRef;
|
|
3115
3044
|
private focusTrigger;
|
|
3116
|
-
/** Text shown in the field: masked single value, or the combined range string. */
|
|
3117
3045
|
protected readonly fieldText: _angular_core.Signal<string>;
|
|
3118
|
-
/** Format-mask placeholder (single) or the doubled range mask. */
|
|
3119
3046
|
protected readonly fieldPlaceholder: _angular_core.Signal<string>;
|
|
3120
3047
|
/** `size` attribute so the field hugs its mask width instead of stretching.
|
|
3121
3048
|
* +1 covers `size` under-counting the mask's wide glyphs (M/D/Y), which
|
|
@@ -3123,14 +3050,11 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3123
3050
|
* `font-family: var(--font-mono)` keeps every glyph equal width, so the
|
|
3124
3051
|
* width never shifts as you type. */
|
|
3125
3052
|
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
3053
|
protected readonly displaySlots: _angular_core.Signal<DisplayPart[]>;
|
|
3129
3054
|
protected readonly monthMenuOpen: _angular_core.WritableSignal<boolean>;
|
|
3130
3055
|
protected readonly yearMenuOpen: _angular_core.WritableSignal<boolean>;
|
|
3131
3056
|
protected readonly viewMonthIndex: _angular_core.Signal<number>;
|
|
3132
3057
|
protected readonly viewYear: _angular_core.Signal<number>;
|
|
3133
|
-
/** First year shown in the year grid; paged by YEAR_PAGE_SIZE within [minYear, maxYear]. */
|
|
3134
3058
|
protected readonly yearPageStart: _angular_core.WritableSignal<number>;
|
|
3135
3059
|
protected readonly yearsOnPage: _angular_core.Signal<number[]>;
|
|
3136
3060
|
protected readonly yearRangeLabel: _angular_core.Signal<string>;
|
|
@@ -3147,7 +3071,6 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3147
3071
|
protected selectYear(year: number, event: Event): void;
|
|
3148
3072
|
protected isDayDisabled(date: Date): boolean;
|
|
3149
3073
|
protected readonly daysGrid: _angular_core.Signal<DayCell[]>;
|
|
3150
|
-
/** daysGrid split into rows of 7 for the grid's `role="row"` structure. */
|
|
3151
3074
|
protected readonly weeksGrid: _angular_core.Signal<DayCell[][]>;
|
|
3152
3075
|
private getRangeContext;
|
|
3153
3076
|
protected open(moveFocusToGrid?: boolean): void;
|
|
@@ -3156,17 +3079,15 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3156
3079
|
/**
|
|
3157
3080
|
* Also the calendar glyph's handler. A POINTER open must not drag focus into
|
|
3158
3081
|
* 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.
|
|
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)`.
|
|
3163
3085
|
*/
|
|
3164
3086
|
protected onFieldClick(): void;
|
|
3165
3087
|
private mobileEdit;
|
|
3166
3088
|
protected onFieldInput(event: Event): void;
|
|
3167
3089
|
/** Physical-keyboard editing (desktop): typed digits fill the caret's slot;
|
|
3168
|
-
* Backspace/Delete never shift digits across a separator.
|
|
3169
|
-
* shared segment editor. */
|
|
3090
|
+
* Backspace/Delete never shift digits across a separator. */
|
|
3170
3091
|
protected onFieldKeydown(event: KeyboardEvent): void;
|
|
3171
3092
|
/** Mobile keyboards don't fire a reliable `keydown` (Gboard reports keyCode 229 /
|
|
3172
3093
|
* "Unidentified"), so edits are routed here via `beforeinput`'s `inputType` instead.
|
|
@@ -3174,33 +3095,28 @@ declare class DatePickerComponent extends DsControlValueAccessor<Date | RangeVal
|
|
|
3174
3095
|
* stashed and re-asserted in `onFieldInput`; the microtask expires the stash once
|
|
3175
3096
|
* preventDefault worked (no following `input` in the same task). */
|
|
3176
3097
|
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. */
|
|
3098
|
+
/** A selection is cleared through the model so `_` placeholders are never
|
|
3099
|
+
* natively erased — only digits are editable. */
|
|
3181
3100
|
private runSegmentEdit;
|
|
3182
3101
|
/** Paste digits into the segment model at the caret slot — never a global
|
|
3183
3102
|
* flatten — so existing digits elsewhere in the field survive untouched. */
|
|
3184
3103
|
protected onFieldPaste(event: ClipboardEvent): void;
|
|
3185
3104
|
private countDigits;
|
|
3186
|
-
/**
|
|
3187
|
-
*
|
|
3188
|
-
*
|
|
3189
|
-
* 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. */
|
|
3190
3108
|
private commitRaw;
|
|
3191
|
-
/** Write masked text + caret into the DOM, then parse and validate it. */
|
|
3192
3109
|
private applyEditedText;
|
|
3193
3110
|
protected onFieldBlur(): void;
|
|
3194
|
-
/**
|
|
3195
|
-
*
|
|
3196
|
-
*
|
|
3197
|
-
* 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. */
|
|
3198
3114
|
private writeBackText;
|
|
3199
|
-
/** Caret just past the last digit
|
|
3200
|
-
*
|
|
3201
|
-
* 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. */
|
|
3202
3117
|
private caretAfterFill;
|
|
3203
|
-
/**
|
|
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`. */
|
|
3204
3120
|
private applyRangeText;
|
|
3205
3121
|
protected prevMonth(): void;
|
|
3206
3122
|
protected nextMonth(): void;
|
|
@@ -4204,8 +4120,13 @@ declare class ToastService {
|
|
|
4204
4120
|
private regionRef;
|
|
4205
4121
|
private nextId;
|
|
4206
4122
|
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
|
|
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. */
|
|
4209
4130
|
promise<T>(source: Promise<T>, messages: ToastPromiseMessages): Promise<T>;
|
|
4210
4131
|
dismissAll(): void;
|
|
4211
4132
|
private ensureRegion;
|
|
@@ -4222,6 +4143,11 @@ declare class ToastRegionComponent {
|
|
|
4222
4143
|
protected readonly leaving: _angular_core.WritableSignal<ReadonlySet<number>>;
|
|
4223
4144
|
private readonly pendingQueue;
|
|
4224
4145
|
private readonly timers;
|
|
4146
|
+
private readonly remaining;
|
|
4147
|
+
private readonly startedAt;
|
|
4148
|
+
private hovered;
|
|
4149
|
+
private focusWithin;
|
|
4150
|
+
private readonly host;
|
|
4225
4151
|
private readonly position;
|
|
4226
4152
|
/** Newest goes NEAREST the anchor, so the toast that just fired appears where the
|
|
4227
4153
|
* stack is pinned rather than at the far end of a list the reader has to hunt
|
|
@@ -4229,10 +4155,25 @@ declare class ToastRegionComponent {
|
|
|
4229
4155
|
private readonly newestFirst;
|
|
4230
4156
|
add(entry: ToastEntry): void;
|
|
4231
4157
|
private show;
|
|
4232
|
-
private
|
|
4158
|
+
private arm;
|
|
4233
4159
|
private clearCountdown;
|
|
4234
|
-
/**
|
|
4235
|
-
|
|
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;
|
|
4236
4177
|
remove(id: number): void;
|
|
4237
4178
|
protected isLeaving(id: number): boolean;
|
|
4238
4179
|
clear(): void;
|
|
@@ -4560,9 +4501,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4560
4501
|
protected readonly filteredItems: _angular_core.Signal<AutocompleteItem<T>[]>;
|
|
4561
4502
|
protected readonly filteredOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
|
|
4562
4503
|
protected isGroup(item: AutocompleteItem<T>): item is AutocompleteOptionGroup<T>;
|
|
4563
|
-
/** Whether to show the "Create «text»" row at the bottom of the panel. */
|
|
4564
4504
|
protected readonly showCreateRow: _angular_core.Signal<boolean>;
|
|
4565
|
-
/** Flat list of visible options used for keyboard navigation index. */
|
|
4566
4505
|
protected readonly visibleOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
|
|
4567
4506
|
/** The visible label wins the accessible name when there is one — otherwise the
|
|
4568
4507
|
* placeholder would announce over it, and `placeholder` always carries a default. */
|
|
@@ -4570,14 +4509,13 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4570
4509
|
protected readonly selectedTags: _angular_core.Signal<AutocompleteOption<T>[]>;
|
|
4571
4510
|
private readonly chipsMode;
|
|
4572
4511
|
private readonly showsEveryChip;
|
|
4573
|
-
/** True for
|
|
4574
|
-
*
|
|
4512
|
+
/** True for a number as well as `'fit'`: a number is a ceiling, not a promise,
|
|
4513
|
+
* so the row still measures. */
|
|
4575
4514
|
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. */
|
|
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. */
|
|
4581
4519
|
private readonly chipBudget;
|
|
4582
4520
|
private readonly chipsThatFit;
|
|
4583
4521
|
/** What the trigger renders. Separate from `selectedTags`, which stays the
|
|
@@ -4592,15 +4530,12 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4592
4530
|
protected readonly placeholderText: _angular_core.Signal<string>;
|
|
4593
4531
|
protected isSelected(option: AutocompleteOption<T>): boolean;
|
|
4594
4532
|
protected optionClass(option: AutocompleteOption<T>): string;
|
|
4595
|
-
/**
|
|
4596
|
-
* every option is disabled. */
|
|
4533
|
+
/** -1 when nothing is pickable and there is no create row to fall back on. */
|
|
4597
4534
|
private firstEnabledIndex;
|
|
4598
|
-
/**
|
|
4599
|
-
* row
|
|
4600
|
-
*
|
|
4601
|
-
* 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. */
|
|
4602
4538
|
private nextEnabledIndex;
|
|
4603
|
-
/** Flat index of the given option within the visible (filtered) list. */
|
|
4604
4539
|
protected flatIndexOf(option: AutocompleteOption<T>): number;
|
|
4605
4540
|
constructor();
|
|
4606
4541
|
private setOpen;
|
|
@@ -4622,9 +4557,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
|
|
|
4622
4557
|
*
|
|
4623
4558
|
* `value.set(null)` alone is not enough from outside: the typed query is
|
|
4624
4559
|
* 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.
|
|
4560
|
+
* the value goes.
|
|
4628
4561
|
*
|
|
4629
4562
|
* Deliberately does NOT move focus — the caller may be navigating away, and
|
|
4630
4563
|
* stealing focus back into a field they just left is worse than leaving it.
|
|
@@ -5195,17 +5128,12 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
5195
5128
|
protected readonly selectedOptions: _angular_core.Signal<MultiSelectOption[]>;
|
|
5196
5129
|
private readonly chipsMode;
|
|
5197
5130
|
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. */
|
|
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. */
|
|
5203
5133
|
protected readonly fitsChipsToWidth: _angular_core.Signal<boolean>;
|
|
5204
5134
|
/** 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. */
|
|
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. */
|
|
5209
5137
|
private readonly chipBudget;
|
|
5210
5138
|
private readonly chipsThatFit;
|
|
5211
5139
|
protected readonly visibleChips: _angular_core.Signal<MultiSelectOption[]>;
|
|
@@ -5239,11 +5167,8 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
|
|
|
5239
5167
|
protected clearValue(event: MouseEvent): void;
|
|
5240
5168
|
/**
|
|
5241
5169
|
* 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.
|
|
5170
|
+
* clears itself. Deliberately does NOT move focus: the caller may be navigating
|
|
5171
|
+
* away.
|
|
5247
5172
|
*/
|
|
5248
5173
|
clear(): void;
|
|
5249
5174
|
protected removeValue(value: string): void;
|