@ids-group-ltd/ids-design-system 0.11.1 → 0.11.3

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