@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.
Files changed (75) hide show
  1. package/CHANGELOG.md +119 -2
  2. package/components.md +27 -12
  3. package/design-system.md +135 -1
  4. package/docs/agent/INDEX.md +98 -0
  5. package/docs/agent/domain/ds-w3w.md +10 -0
  6. package/docs/agent/feedback/ds-alert.md +9 -0
  7. package/docs/agent/feedback/ds-avatar-group.md +7 -0
  8. package/docs/agent/feedback/ds-avatar.md +6 -0
  9. package/docs/agent/feedback/ds-badge.md +7 -0
  10. package/docs/agent/feedback/ds-banner.md +10 -0
  11. package/docs/agent/feedback/ds-empty-state.md +7 -0
  12. package/docs/agent/feedback/ds-progress.md +7 -0
  13. package/docs/agent/feedback/ds-skeleton.md +6 -0
  14. package/docs/agent/feedback/ds-spinner.md +6 -0
  15. package/docs/agent/feedback/ds-stat.md +7 -0
  16. package/docs/agent/feedback/ds-status-dot.md +6 -0
  17. package/docs/agent/feedback/ds-tag.md +8 -0
  18. package/docs/agent/feedback/ds-toast.md +12 -0
  19. package/docs/agent/forms/ds-autocomplete.md +9 -0
  20. package/docs/agent/forms/ds-button.md +14 -0
  21. package/docs/agent/forms/ds-checkbox.md +6 -0
  22. package/docs/agent/forms/ds-date-picker.md +7 -0
  23. package/docs/agent/forms/ds-dropzone.md +10 -0
  24. package/docs/agent/forms/ds-icon-button.md +10 -0
  25. package/docs/agent/forms/ds-input.md +22 -0
  26. package/docs/agent/forms/ds-multi-select.md +6 -0
  27. package/docs/agent/forms/ds-number-stepper.md +8 -0
  28. package/docs/agent/forms/ds-radio.md +6 -0
  29. package/docs/agent/forms/ds-search.md +10 -0
  30. package/docs/agent/forms/ds-select.md +7 -0
  31. package/docs/agent/forms/ds-switch.md +6 -0
  32. package/docs/agent/forms/ds-textarea.md +9 -0
  33. package/docs/agent/forms/the-picker-family-ds-select-ds-multi-select-ds-autocomplete.md +21 -0
  34. package/docs/agent/foundations/global-helper-classes.md +18 -0
  35. package/docs/agent/foundations/grid.md +35 -0
  36. package/docs/agent/foundations/tokens.md +47 -0
  37. package/docs/agent/navigation/ds-app-layout.md +10 -0
  38. package/docs/agent/navigation/ds-auth-layout.md +9 -0
  39. package/docs/agent/navigation/ds-breadcrumbs.md +7 -0
  40. package/docs/agent/navigation/ds-divider.md +9 -0
  41. package/docs/agent/navigation/ds-page-footer.md +7 -0
  42. package/docs/agent/navigation/ds-page-header.md +8 -0
  43. package/docs/agent/navigation/ds-pagination.md +7 -0
  44. package/docs/agent/navigation/ds-sidenav-group.md +8 -0
  45. package/docs/agent/navigation/ds-sidenav-item.md +9 -0
  46. package/docs/agent/navigation/ds-sidenav.md +9 -0
  47. package/docs/agent/navigation/ds-stepper.md +6 -0
  48. package/docs/agent/navigation/ds-tabs.md +9 -0
  49. package/docs/agent/navigation/ds-topbar.md +8 -0
  50. package/docs/agent/overlays/ds-bottom-sheet.md +9 -0
  51. package/docs/agent/overlays/ds-drawer.md +9 -0
  52. package/docs/agent/overlays/ds-menu.md +8 -0
  53. package/docs/agent/overlays/ds-modal-card.md +6 -0
  54. package/docs/agent/overlays/ds-modal.md +8 -0
  55. package/docs/agent/overlays/ds-popover.md +6 -0
  56. package/docs/agent/overlays/ds-tooltip.md +8 -0
  57. package/docs/agent/platform/breadcrumbs-service.md +30 -0
  58. package/docs/agent/platform/ds-config.md +60 -0
  59. package/docs/agent/platform/ds-icon-registry.md +23 -0
  60. package/docs/agent/platform/toast-service.md +19 -0
  61. package/docs/agent/surfaces/ds-accordion.md +8 -0
  62. package/docs/agent/surfaces/ds-card.md +10 -0
  63. package/docs/agent/tables/ds-table.md +15 -0
  64. package/fesm2022/ids-group-ltd-ids-design-system.mjs +262 -338
  65. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  66. package/migrations/0.11.3.json +152 -0
  67. package/package.json +1 -1
  68. package/styles/_dropdown-overlay.scss +25 -32
  69. package/styles/_ds-color.scss +31 -12
  70. package/styles/_tokens-charts.scss +2 -3
  71. package/styles/_tokens.scss +158 -321
  72. package/themes/README.md +32 -1
  73. package/themes/_base-palette.scss +35 -76
  74. package/themes/_semantic.scss +5 -2
  75. 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
- * the three states that mean something — `error`, `warn`, `success` — and NONE
127
- * for `hint`, which is the resting text rather than a state: a form where every
128
- * field carries an info circle reads as noise. Each key is independent, so
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
- * WHY a glyph at all: colour alone carried error / warning / success, and in the
134
- * light theme warning (#8A7400) and success (#156822) differ by hue and nothing
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 — a Latin-script guess. Reading a name is a cultural
155
- * convention, so an app that knows its own provides it here. */
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
- * One threshold for the app is the point: left to each call site, two panels of
179
- * the same length in the same screen end up disagreeing. */
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`. A whole-app
199
- * opinion in practice: an app that wants it wants it on every table, and
200
- * every new table is one forgotten binding away from scrolling invisibly. */
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`. Per app rather than per table in practice, which is why
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
- * config resolves through the element-injector chain, so a subtree can differ
232
- * from the app. Component inputs (e.g. `<ds-card padding="lg">`) still win.
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
- * ONE call per injector, though: two in the SAME `providers` array both resolve
239
- * their parent with `skipSelf`, so the later one wins and the earlier is silently
240
- * lost. Merging happens across injector levels, not within one array.
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 would run at module-evaluation time, which makes the module
247
- * side-effectful and costs the consumer its tree-shaking (measured at +566 kB moved
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 — which is what
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
- * Brand row, tagline, card and support footer are the same four parts in every
984
- * consumer that has hand-rolled this. What a hand-rolled version gets wrong is the full-height
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`, which every auth screen in an app
1015
- * answers identically. Each field resolves on its own, so `brand=""` drops the wordmark
1016
- * but a `logoLetter` in the config still paints its tile; clear both to give one
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. The card holds the whole
1036
- * content of an auth screen and `ds-card` renders an `<article>`, which is NOT
1037
- * a landmark, so by default a screen-reader user has nothing to jump to — set
1038
- * this to `'main'` on a standalone auth page. It is opt-in because the layout
1039
- * is also embedded inside pages that already own a `main`, and two `main`s is its
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. Without this the
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. `ds-autocomplete` has had this; the other two had only the
1998
- * in-trigger button, so an app with its own reset had to write the empty value
1999
- * by hand and guess what "empty" is for this control.
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
- /** Resolved pixel width for a column: a drag override wins, else `column.width`
2602
- * when that is a number. `'content'` is not a pixel value — it is carried by a
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
- * Runs only while something is unmeasured, so a second drag is untouched, and
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
- * One column-width step, from wherever it was asked for: the handle's own
2671
- * keyboard, or the width controls in the column panel.
2672
- *
2673
- * `'auto'` hands the column back to automatic sizing. The header cell is
2674
- * passed when the caller has it — the panel does not, so it is looked up by
2675
- * `data-col-key`, and the measurement matters: stepping an auto-sized column
2676
- * has to start from what it currently RENDERS, not from the minimum.
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
- /** The full display set — paged when paginating, else sorted/raw data.
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. Otherwise it carries the sort state and the
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 `_table.scss`'s matching query. */
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. Mixes column key + row index into one of five widths. */
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
- /** Bounds for the year dropdown in the calendar header. */
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 trigger is a button (calendar-only). */
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, and `allowInput` defaults to true. So focus follows what the field IS —
3160
- * typeable, and the caret stays; read-only, and the grid is the only thing
3161
- * worth focusing. The keyboard path is unaffected: ArrowDown on the field
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. Delegates to the
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
- /** Apply one segment edit (type a digit / Backspace / Delete) at the caret or
3178
- * over the selection, then write the fixed-width value + caret back. A
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
- /** Rebuild `raw` as a digit stream (IME / autofill / suggestion fallback —
3187
- * any `input` event with no preceding handled `beforeinput`), split per slot
3188
- * by its fixed width, then render fixed-width so it matches the overlay —
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
- /** Force the DOM value to `text` (over-typed digits can't accumulate) and
3195
- * place the caret at `caret`. Setting `value` first parks the caret at the
3196
- * end, so the explicit range must follow; the later `[value]` binding writes
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 filled by a flat digit stream (commitRaw's
3200
- * fallback path) — the first slot short of its max length, or the very end
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
- /** Parse the combined range text, flag malformed segments, commit on blur. */
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 `promise`. Resolves/rejects are
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 startCountdown;
4158
+ private arm;
4233
4159
  private clearCountdown;
4234
- /** Replace fields of an already-visible or queued toast in place. */
4235
- update(id: number, patch: Partial<Pick<ToastEntry, 'body' | 'title' | 'variant' | 'dismissible' | 'action'>>): void;
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 BOTH `'fit'` and a number: a number is a ceiling ("at most N"), not a
4574
- * promise, so the row still measures and shows only what the width allows. */
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: everything for
4577
- * `'fit'`, the ceiling for a number. It has to be the ceiling and not the
4578
- * selection, because the measurement caches chip widths from a render that
4579
- * holds them all — with a numeric cap that render never happens, the cache
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
- /** First option a reader can actually act on — -1 when the list is empty or
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
- /** Arrow keys step OVER a disabled option rather than landing on it — an active
4599
- * row Enter refuses to act on is a dead end the reader has to guess their way
4600
- * out of. `step` is +1/-1; the create row (past the last option) is always
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. That gap is why a host reaching for "reset after navigating"
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
- * "at most N" — so the row still measures and shows only what the trigger is
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 has to be the ceiling and not the
5206
- * selection, because the measurement caches chip widths from a render that
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. `ds-autocomplete` has had this; the other two had only the
5243
- * in-trigger button.
5244
- *
5245
- * Deliberately does NOT move focus: the caller may be navigating away, and
5246
- * stealing focus back into a field they just left is worse than leaving it.
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;