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

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 (47) hide show
  1. package/CHANGELOG.md +1164 -1011
  2. package/components.md +49 -26
  3. package/design-system.md +18 -18
  4. package/fesm2022/ids-group-ltd-ids-design-system.mjs +527 -116
  5. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  6. package/migrations/0.10.0.json +19 -19
  7. package/migrations/0.10.1.json +20 -7
  8. package/migrations/0.10.2.json +8 -8
  9. package/migrations/0.10.3.json +2 -2
  10. package/migrations/0.11.0.json +12 -12
  11. package/migrations/0.11.1.json +305 -0
  12. package/migrations/0.2.2.json +1 -1
  13. package/migrations/0.3.0.json +1 -1
  14. package/migrations/0.5.1/badge-statuses.md +1 -3
  15. package/migrations/0.5.1.json +1 -1
  16. package/migrations/0.6.3.json +1 -1
  17. package/migrations/0.7.1.json +3 -3
  18. package/migrations/0.8.0.json +5 -5
  19. package/migrations/0.9.0.json +10 -9
  20. package/migrations/0.9.1.json +2 -2
  21. package/migrations/README.md +34 -52
  22. package/package.json +1 -1
  23. package/styles/_dropdown-overlay.scss +35 -13
  24. package/styles/_ds-color.scss +3 -3
  25. package/styles/_field-box.scss +2 -6
  26. package/styles/_field-label.scss +5 -10
  27. package/styles/_field-state.scss +3 -2
  28. package/styles/_focus.scss +0 -2
  29. package/styles/_layout-utils.scss +2 -2
  30. package/styles/_overlay-motion.scss +2 -3
  31. package/styles/_press.scss +3 -5
  32. package/styles/_reset.scss +0 -1
  33. package/styles/_scrollbar.scss +1 -3
  34. package/styles/_status.scss +1 -2
  35. package/styles/_surface-motion.scss +3 -4
  36. package/styles/_text-clip.scss +1 -1
  37. package/styles/_theme-activation.scss +1 -1
  38. package/styles/_tokens-charts.scss +1 -3
  39. package/styles/_tokens.scss +4 -3
  40. package/styles/_typography.scss +2 -2
  41. package/themes/README.md +3 -3
  42. package/themes/_base-palette.scss +2 -2
  43. package/themes/_semantic.scss +2 -2
  44. package/themes/dark/_palette.scss +1 -2
  45. package/themes/light/_palette.scss +1 -1
  46. package/themes/light/_theme.scss +1 -1
  47. package/types/ids-group-ltd-ids-design-system.d.ts +274 -49
@@ -3,8 +3,8 @@ import { InjectionToken, Provider, EnvironmentProviders, ElementRef, TemplateRef
3
3
  import { SafeHtml } from '@angular/platform-browser';
4
4
  import { Observable } from 'rxjs';
5
5
  import { ControlValueAccessor } from '@angular/forms';
6
- import { CdkDragDrop } from '@angular/cdk/drag-drop';
7
6
  import * as _ids_group_ltd_ids_design_system from '@ids-group-ltd/ids-design-system';
7
+ import { CdkDragDrop } from '@angular/cdk/drag-drop';
8
8
 
9
9
  declare const ICONS: {
10
10
  readonly search: "<circle cx=\"11\" cy=\"11\" r=\"7\" /><path d=\"m20 20-3.5-3.5\" />";
@@ -170,6 +170,15 @@ interface DsConfig {
170
170
  * `ds-modal` ancestor to bind — an attribute cannot reach it. */
171
171
  dividers?: boolean;
172
172
  };
173
+ picker?: {
174
+ /** Default for `ds-multi-select``s `searchable`. `true` always shows the panel's
175
+ * 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. */
180
+ searchable?: boolean | number;
181
+ };
173
182
  control?: {
174
183
  /** Default `size` for every control on the field-height contract. Default `'md'`.
175
184
  *
@@ -187,7 +196,7 @@ interface DsConfig {
187
196
  table?: {
188
197
  /** Default for `ds-table`'s `stickyScrollbar` — the proxy that keeps the
189
198
  * horizontal bar reachable on a tall table. Default `false`. A whole-app
190
- * opinion in practice: one consumer binds it on all 35 of its tables, and
199
+ * opinion in practice: an app that wants it wants it on every table, and
191
200
  * every new table is one forgotten binding away from scrolling invisibly. */
192
201
  stickyScrollbar?: boolean;
193
202
  /** Default for `ds-table`'s `bordered` — the outer border and radius.
@@ -235,8 +244,8 @@ declare function provideDsConfig(config: DsConfig): Provider;
235
244
  * The factory body behind `provideDsConfig`, exported so a directive can put the
236
245
  * provider in its metadata as a plain object literal. Calling `provideDsConfig`
237
246
  * there instead would run at module-evaluation time, which makes the module
238
- * side-effectful and costs the consumer its tree-shaking (measured: the whole
239
- * library moved into ds-docs' eager chunk, +566 kB).
247
+ * side-effectful and costs the consumer its tree-shaking (measured at +566 kB moved
248
+ * into the eager chunk).
240
249
  *
241
250
  * Must be called from an injection context.
242
251
  */
@@ -311,6 +320,24 @@ interface DsOption<T = string> {
311
320
  /** Rendered before the label at 16px by every picker's option row. */
312
321
  icon?: IconName;
313
322
  }
323
+ /**
324
+ * A labelled section of options. `disabled` turns the whole section off.
325
+ */
326
+ interface DsOptionGroup<T = string> {
327
+ label: string;
328
+ options: DsOption<T>[];
329
+ disabled?: boolean;
330
+ }
331
+ /**
332
+ * What a picker's `options` input takes: flat options, groups, or both mixed.
333
+ * 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.
336
+ */
337
+ type DsOptionItem<T = string> = DsOption<T> | DsOptionGroup<T>;
338
+ declare function isDsOptionGroup<T>(item: DsOptionItem<T>): item is DsOptionGroup<T>;
339
+ /** Every option in `items`, groups flattened in place, in source order. */
340
+ declare function flattenDsOptions<T>(items: readonly DsOptionItem<T>[]): DsOption<T>[];
314
341
 
315
342
  /** Canonical status vocabulary shared across status-bearing components. */
316
343
  type DsStatus = 'info' | 'success' | 'warning' | 'error';
@@ -319,11 +346,6 @@ type DsStatus = 'info' | 'success' | 'warning' | 'error';
319
346
  * The DS ships it EMPTY — no statuses are predefined. A consumer registers keys
320
347
  * via declaration merging to get autocomplete on the `status` input:
321
348
  *
322
- * // inside this repo (ds-docs imports the lib as 'ds'):
323
- * declare module 'ds' {
324
- * interface DsStatusRegistry { planning: true; confirmed: true; }
325
- * }
326
- * // external consumer of the published package:
327
349
  * declare module '@ids-group-ltd/ids-design-system' {
328
350
  * interface DsStatusRegistry { shipped: true; delivered: true; }
329
351
  * }
@@ -337,6 +359,33 @@ interface DsStatusRegistry {
337
359
  */
338
360
  type DsStatusKey = [keyof DsStatusRegistry] extends [never] ? string : keyof DsStatusRegistry;
339
361
 
362
+ /**
363
+ * How a control sizes itself and its overlay panel.
364
+ *
365
+ * `fill` stretches to the container and pins the panel to the trigger's width.
366
+ * `content` hugs the trigger and takes that width as the panel's FLOOR, so the
367
+ * panel still grows to its options — without it a short trigger gives a panel
368
+ * too narrow to read.
369
+ */
370
+ type DsControlWidth = 'fill' | 'content';
371
+
372
+ /**
373
+ * What a picker's trigger shows.
374
+ *
375
+ * `full` is the control's own display — chips, or the selected value.
376
+ *
377
+ * `count` is a caption and a selected-count badge at intrinsic width, for a filter
378
+ * toolbar where a field that grows with the selection does not fit. `labels` is the
379
+ * same footprint but names what is selected instead of counting it, cut to what the
380
+ * trigger is wide enough for, with the rest behind "+N" — the same measurement the
381
+ * chips already use.
382
+ *
383
+ * Only pickers that hold several values offer the other two: a single-value control
384
+ * has nothing to count and nothing to list, and its `full` trigger is already the
385
+ * caption plus the value.
386
+ */
387
+ type DsTriggerDisplay = 'full' | 'count' | 'labels';
388
+
340
389
  declare class IconComponent {
341
390
  private readonly sanitizer;
342
391
  private readonly registry;
@@ -485,8 +534,8 @@ declare class ButtonComponent extends DsMessageBase {
485
534
  /** Brand/status hue family. */
486
535
  readonly color: _angular_core.InputSignal<ButtonColor>;
487
536
  /** Fill pattern: solid | tonal | ghost | outline | text. All color×variant
488
- pairs render; some are UX-discouraged (see DISCOURAGED_COMBOS / the docs)
489
- and emit a dev-mode warning — they work, but read poorly. `text` is
537
+ pairs render; some are UX-discouraged and emit a dev-mode
538
+ warning naming the reason — they work, but read poorly. `text` is
490
539
  discouraged for ALL colours — prefer the global `.link` class; it stays for
491
540
  cases needing the ds-button API (loading/fullWidth/typed pressed). */
492
541
  readonly variant: _angular_core.InputSignal<ButtonVariant>;
@@ -928,7 +977,7 @@ declare class BrandNameDirective {
928
977
  * screens behind the login.
929
978
  *
930
979
  * Brand row, tagline, card and support footer are the same four parts in every
931
- * consumer that has hand-rolled this. What the ports get wrong is the full-height
980
+ * consumer that has hand-rolled this. What a hand-rolled version gets wrong is the full-height
932
981
  * box: they nest a `100vh` wrapper inside a `100dvh` one and scroll a page whose
933
982
  * content fits. Here the host is the only one, and it also carries the safe-area
934
983
  * insets a notched phone in landscape needs.
@@ -958,8 +1007,8 @@ declare class BrandNameDirective {
958
1007
  declare class AuthLayoutComponent {
959
1008
  /** Wordmark beside the letter-mark tile. For a logo image/SVG, project it into
960
1009
  * the `[brand]` slot instead; for a two-tone wordmark use `[dsBrandName]`.
961
- * Unset falls back to `DS_CONFIG.brand.name` — six auth screens answer this
962
- * identically. Each field resolves on its own, so `brand=""` drops the wordmark
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
963
1012
  * but a `logoLetter` in the config still paints its tile; clear both to give one
964
1013
  * screen no brand row. */
965
1014
  readonly brand: _angular_core.InputSignal<string | null>;
@@ -983,10 +1032,8 @@ declare class AuthLayoutComponent {
983
1032
  * content of an auth screen and `ds-card` renders an `<article>`, which is NOT
984
1033
  * a landmark, so by default a screen-reader user has nothing to jump to — set
985
1034
  * this to `'main'` on a standalone auth page. It is opt-in because the layout
986
- * is also embedded inside pages that already own a `main` (this repo's own docs
987
- * site nests it inside `ds-app-layout`), and two `main`s is its own violation.
988
- * Defaulting it to `'main'` is the better end state and belongs in the next
989
- * batch of default changes. */
1035
+ * is also embedded inside pages that already own a `main`, and two `main`s is its
1036
+ * own violation. */
990
1037
  readonly landmark: _angular_core.InputSignal<"none" | "main">;
991
1038
  /** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
992
1039
  protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
@@ -1828,12 +1875,10 @@ declare class DsStaticPreview {
1828
1875
 
1829
1876
  interface SelectOption extends DsOption<string> {
1830
1877
  }
1831
- interface SelectOptionGroup {
1832
- label: string;
1833
- options: SelectOption[];
1834
- disabled?: boolean;
1878
+ type SelectWidth = DsControlWidth;
1879
+ interface SelectOptionGroup extends DsOptionGroup<string> {
1835
1880
  }
1836
- type SelectItem = SelectOption | SelectOptionGroup;
1881
+ type SelectItem = DsOptionItem<string>;
1837
1882
  declare function isSelectOptionGroup(item: SelectItem): item is SelectOptionGroup;
1838
1883
 
1839
1884
  declare class SelectComponent extends DsControlValueAccessor<string> implements OnDestroy {
@@ -1847,7 +1892,15 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1847
1892
  /** Selected option's value, two-way bound. */
1848
1893
  readonly value: _angular_core.ModelSignal<string>;
1849
1894
  /** Flat options or option groups rendered in the dropdown panel. */
1850
- readonly options: _angular_core.InputSignal<SelectItem[]>;
1895
+ readonly options: _angular_core.InputSignal<readonly SelectItem[]>;
1896
+ /** 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. */
1899
+ private readonly panelTokens;
1900
+ /** Trigger width — `fill` stretches to the container and pins the panel to the
1901
+ * trigger's width; `content` hugs the trigger's own content and takes that width
1902
+ * as the panel's FLOOR, so the panel can still grow to its options. */
1903
+ readonly width: _angular_core.InputSignal<_ids_group_ltd_ids_design_system.DsControlWidth>;
1851
1904
  /** Shown in the trigger when nothing is selected. */
1852
1905
  readonly placeholder: _angular_core.InputSignal<string>;
1853
1906
  /** Trigger height — sm/md/lg.
@@ -1879,6 +1932,9 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1879
1932
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
1880
1933
  /** Shows an inline clear (×) button when a value is selected. */
1881
1934
  readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
1935
+ protected readonly optionTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
1936
+ protected readonly pickerTrigger: _angular_core.Signal<TemplateRef<any> | undefined>;
1937
+ protected readonly emptyTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
1882
1938
  protected readonly uid: string;
1883
1939
  protected readonly labelId: string;
1884
1940
  protected readonly listboxId: string;
@@ -1924,7 +1980,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1924
1980
  private firstEnabledIndex;
1925
1981
  private lastEnabledIndex;
1926
1982
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
1927
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "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"; }, never, never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
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: {}; }]>;
1928
1984
  }
1929
1985
 
1930
1986
  /**
@@ -2146,7 +2202,7 @@ declare class TableComponent<T extends object> {
2146
2202
  /** Adds a checkbox column for row/select-all selection. */
2147
2203
  readonly selectable: _angular_core.InputSignalWithTransform<boolean, unknown>;
2148
2204
  /** Opt-in outer border + radius. Off by default so tables flush inside a
2149
- * `<ds-card padding="none">` (workspaces, programs-list) don't double-border.
2205
+ * `<ds-card padding="none">` don't double-border.
2150
2206
  * When `true`, the scroll-wrap gets a `var(--border-default)` outline and
2151
2207
  * `var(--radius-md)` radius — useful when the table stands alone in a padded card.
2152
2208
  * Unset falls back to `DS_CONFIG.table.bordered`, then `false`. */
@@ -3181,7 +3237,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
3181
3237
  protected readonly columns: _angular_core.Signal<TimeColumnsComponent | undefined>;
3182
3238
  /** Any of the three trigger boxes, not the host: a range renders two and a single
3183
3239
  * one renders one, while the host also carries the label and the message row —
3184
- * clicking those has to dismiss the panel (MBP-225). */
3240
+ * clicking those has to dismiss the panel. */
3185
3241
  private insideATrigger;
3186
3242
  protected readonly isDisabled: _angular_core.Signal<boolean>;
3187
3243
  protected readonly hintId: _angular_core.Signal<string | null>;
@@ -3408,7 +3464,7 @@ interface SidenavAlertItem {
3408
3464
  * A single global-search hit rendered in the sidenav Search popover. The footer
3409
3465
  * stays domain-agnostic: the layout supplies a {@link SidenavSearchProvider} that maps
3410
3466
  * a query string to these results, so the footer never needs to know about the
3411
- * portal's sections or entities.
3467
+ * app's sections or entities.
3412
3468
  */
3413
3469
  interface SidenavSearchResult {
3414
3470
  readonly id: string;
@@ -4230,14 +4286,15 @@ declare class PageFooterComponent {
4230
4286
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<PageFooterComponent, "ds-page-footer", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["[brand]", "[nav]", "[actions]", "*"], true, never>;
4231
4287
  }
4232
4288
 
4233
- /** `fill` stretches to the host container (default); `content` hugs chips/value + a min typing area. */
4234
- type AutocompleteWidth = 'fill' | 'content';
4289
+ /** `content` here also reserves a minimum typing area beside the chips. */
4290
+ type AutocompleteWidth = DsControlWidth;
4291
+ /** What a settled single value does when it outgrows the trigger. */
4292
+ type AutocompleteValueOverflow = 'ellipsis' | 'wrap';
4235
4293
  interface AutocompleteOption<T = unknown> extends DsOption<T> {
4236
4294
  }
4237
- interface AutocompleteOptionGroup<T = unknown> {
4238
- readonly label: string;
4239
- readonly options: AutocompleteOption<T>[];
4295
+ interface AutocompleteOptionGroup<T = unknown> extends DsOptionGroup<T> {
4240
4296
  }
4297
+ type AutocompleteItem<T = unknown> = DsOptionItem<T>;
4241
4298
 
4242
4299
  declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<T | readonly T[] | null> implements OnDestroy {
4243
4300
  /** Segment of a ds-field-group: the group owns the border, radius and focus
@@ -4249,10 +4306,8 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4249
4306
  /** Public panel tokens forwarded onto the portaled overlay pane on open so
4250
4307
  * a consumer's `ds-autocomplete { --ds-autocomplete-panel-*: … }` reaches it. */
4251
4308
  private readonly panelTokens;
4252
- /** Flat option list — ignored when `optionGroups` is set. */
4253
- readonly options: _angular_core.InputSignal<readonly AutocompleteOption<T>[]>;
4254
- /** Options grouped under labelled sections, rendered instead of `options`. */
4255
- readonly optionGroups: _angular_core.InputSignal<AutocompleteOptionGroup<T>[]>;
4309
+ /** Options, groups, or both mixed — rendered in the order given. */
4310
+ readonly options: _angular_core.InputSignal<readonly AutocompleteItem<T>[]>;
4256
4311
  /** Selected value, or an array of values when `multiple`. */
4257
4312
  readonly value: _angular_core.ModelSignal<T | readonly T[] | null>;
4258
4313
  /** Allows selecting more than one option, shown as removable tags. */
@@ -4275,7 +4330,12 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4275
4330
  readonly size: _angular_core.InputSignal<DsSize | null>;
4276
4331
  readonly sizeResolved: _angular_core.Signal<DsSize>;
4277
4332
  /** Trigger width — `fill` stretches to the container, `content` hugs the value. */
4278
- readonly width: _angular_core.InputSignal<AutocompleteWidth>;
4333
+ readonly width: _angular_core.InputSignal<_ids_group_ltd_ids_design_system.DsControlWidth>;
4334
+ /** What a settled single value does when it is wider than the trigger. Defaults
4335
+ * to `ellipsis`; `wrap` restores the pre-0.12 behaviour, where the value broke
4336
+ * onto a second line and pushed the chevron onto a third. Multi mode is
4337
+ * unaffected — its chips have their own measured cap. */
4338
+ readonly valueOverflow: _angular_core.InputSignal<AutocompleteValueOverflow>;
4279
4339
  /** Placeholder shown in the input when empty. */
4280
4340
  readonly placeholder: _angular_core.InputSignal<string>;
4281
4341
  /** Disables the trigger and blocks all interaction. */
@@ -4285,6 +4345,12 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4285
4345
  readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
4286
4346
  /** Shows a "Create «text»" row when the typed text matches no option. */
4287
4347
  readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
4348
+ /** Field label above the control — the same meaning it has on the other two pickers. */
4349
+ readonly label: _angular_core.InputSignal<string>;
4350
+ /** Marks the field required: a `*` beside the label and `aria-required` on the input. */
4351
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
4352
+ /** Marks the field optional in words, for a form where most fields are required. */
4353
+ readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
4288
4354
  /** Accessible name for the input. */
4289
4355
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
4290
4356
  /** Fires with the typed text when the user picks the create-new option. */
@@ -4295,6 +4361,11 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4295
4361
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
4296
4362
  protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
4297
4363
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
4364
+ protected readonly optionTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4365
+ protected readonly chipTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4366
+ protected readonly pickerTrigger: _angular_core.Signal<TemplateRef<any> | undefined>;
4367
+ protected readonly emptyTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4368
+ protected readonly createTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4298
4369
  protected readonly query: _angular_core.WritableSignal<string>;
4299
4370
  protected readonly isOpen: _angular_core.WritableSignal<boolean>;
4300
4371
  protected readonly activeIndex: _angular_core.WritableSignal<number>;
@@ -4305,17 +4376,20 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4305
4376
  private overlayRef;
4306
4377
  protected readonly uid: string;
4307
4378
  protected readonly listboxId: string;
4379
+ protected readonly labelId: string;
4308
4380
  protected optionId(index: number): string;
4309
4381
  protected readonly activeDescendant: _angular_core.Signal<string | null>;
4310
- /** All options flattened from either optionGroups or options. */
4311
4382
  protected readonly allOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
4383
+ protected readonly filteredItems: _angular_core.Signal<AutocompleteItem<T>[]>;
4312
4384
  protected readonly filteredOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
4313
- /** Filtered groups for grouped rendering — groups with no matching options are hidden. */
4314
- protected readonly filteredGroups: _angular_core.Signal<AutocompleteOptionGroup<T>[]>;
4385
+ protected isGroup(item: AutocompleteItem<T>): item is AutocompleteOptionGroup<T>;
4315
4386
  /** Whether to show the "Create «text»" row at the bottom of the panel. */
4316
4387
  protected readonly showCreateRow: _angular_core.Signal<boolean>;
4317
4388
  /** Flat list of visible options used for keyboard navigation index. */
4318
4389
  protected readonly visibleOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
4390
+ /** The visible label wins the accessible name when there is one — otherwise the
4391
+ * placeholder would announce over it, and `placeholder` always carries a default. */
4392
+ protected readonly resolvedAriaLabel: _angular_core.Signal<string | null>;
4319
4393
  protected readonly selectedTags: _angular_core.Signal<AutocompleteOption<T>[]>;
4320
4394
  private readonly chipsMode;
4321
4395
  private readonly showsEveryChip;
@@ -4334,7 +4408,10 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4334
4408
  * list it reads would silently make it remove the last VISIBLE one instead. */
4335
4409
  protected readonly visibleTags: _angular_core.Signal<AutocompleteOption<T>[]>;
4336
4410
  protected readonly overflowCount: _angular_core.Signal<number>;
4411
+ protected readonly selectedOption: _angular_core.Signal<AutocompleteOption<T> | null>;
4337
4412
  protected readonly displayLabel: _angular_core.Signal<string>;
4413
+ protected readonly hasSingleValue: _angular_core.Signal<boolean>;
4414
+ protected readonly triggerSelection: _angular_core.Signal<AutocompleteOption<T> | AutocompleteOption<T>[] | null>;
4338
4415
  protected readonly placeholderText: _angular_core.Signal<string>;
4339
4416
  protected isSelected(option: AutocompleteOption<T>): boolean;
4340
4417
  protected optionClass(option: AutocompleteOption<T>): string;
@@ -4372,7 +4449,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4372
4449
  protected onCreateNew(): void;
4373
4450
  protected remove(target: T): void;
4374
4451
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent<any>, never>;
4375
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "optionGroups": { "alias": "optionGroups"; "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; }; "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; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "create": "create"; }, never, ["[dsAutocompletePrefix]", "[dsAutocompleteSuffix]"], true, 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>;
4376
4453
  }
4377
4454
 
4378
4455
  type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
@@ -4785,6 +4862,10 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
4785
4862
 
4786
4863
  interface MultiSelectOption extends DsOption<string> {
4787
4864
  }
4865
+ interface MultiSelectOptionGroup extends DsOptionGroup<string> {
4866
+ }
4867
+ type MultiSelectItem = DsOptionItem<string>;
4868
+ type MultiSelectWidth = DsControlWidth;
4788
4869
 
4789
4870
  declare class MultiSelectComponent extends DsControlValueAccessor<string[]> implements OnDestroy {
4790
4871
  private readonly overlay;
@@ -4795,12 +4876,20 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4795
4876
  private readonly panelTokens;
4796
4877
  /** Selected values, two-way bound. */
4797
4878
  readonly value: _angular_core.ModelSignal<string[]>;
4798
- /** Options shown in the panel. */
4799
- readonly options: _angular_core.InputSignal<readonly MultiSelectOption[]>;
4879
+ /** Options, groups, or both mixed — rendered in the order given. */
4880
+ readonly options: _angular_core.InputSignal<readonly MultiSelectItem[]>;
4800
4881
  /** Placeholder shown in the trigger when nothing is selected. */
4801
4882
  readonly placeholder: _angular_core.InputSignal<string>;
4802
4883
  /** Placeholder for the in-panel filter input. */
4803
4884
  readonly searchPlaceholder: _angular_core.InputSignal<string>;
4885
+ /** Whether the panel carries a filter row. `true` always, `false` never, and a
4886
+ * NUMBER is a threshold — the row appears once there are at least that many
4887
+ * options. Unset falls back to `DS_CONFIG.picker.searchable`, then `true`.
4888
+ *
4889
+ * Hiding it moves the panel's keyboard model onto the trigger: the arrows,
4890
+ * Enter, Escape and `aria-activedescendant` are the filter input's today. */
4891
+ readonly searchable: _angular_core.InputSignalWithTransform<number | boolean | null, unknown>;
4892
+ readonly searchableResolved: _angular_core.Signal<number | boolean>;
4804
4893
  /** How the chips collapse when they outgrow one line. `"fit"` (the default)
4805
4894
  * measures and shows as many as the trigger is wide, the rest behind "+N more".
4806
4895
  * A NUMBER is a CEILING, not a promise: the row still measures, so you get at
@@ -4818,10 +4907,36 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4818
4907
  readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
4819
4908
  /** Accessible name for the trigger — falls back to `placeholder`. */
4820
4909
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
4821
- /** Shows a "Select all" row that toggles every filter-matching, enabled option. */
4822
- readonly selectAll: _angular_core.InputSignalWithTransform<boolean, unknown>;
4910
+ /** Trigger width — `fill` stretches to the container and pins the panel to the
4911
+ * trigger's width; `content` hugs the trigger's own content and takes that width
4912
+ * as the panel's FLOOR, so a compact trigger does not force an unreadable panel. */
4913
+ readonly width: _angular_core.InputSignal<_ids_group_ltd_ids_design_system.DsControlWidth>;
4914
+ /** Trigger height — sm/md/lg. Unset falls back to `DS_CONFIG.control.size`, then `'md'`. */
4915
+ readonly size: _angular_core.InputSignal<DsSize | null>;
4916
+ readonly sizeResolved: _angular_core.Signal<DsSize>;
4917
+ /** What the trigger shows. `count` is a caption plus a selected-count badge at
4918
+ * intrinsic width; `labels` names the selection instead, cut to the width with the
4919
+ * rest behind "+N". A projected `dsPickerTrigger` template WINS over this — the
4920
+ * input is then not read at all. */
4921
+ readonly triggerDisplay: _angular_core.InputSignal<DsTriggerDisplay>;
4922
+ /** Field label above the control — the same meaning it has on `ds-select`, and the
4923
+ * caption a `count`/`labels` trigger uses when it needs one. */
4924
+ readonly label: _angular_core.InputSignal<string>;
4925
+ /** Marks the field required: a `*` beside the label and `aria-required` on the trigger. */
4926
+ readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
4927
+ /** Marks the field optional in words, for a form where most fields are required. */
4928
+ readonly optional: _angular_core.InputSignalWithTransform<boolean, unknown>;
4929
+ /** Where a "select all" row appears. `false` nowhere, `true` one row over the whole
4930
+ * panel, `'group'` one row per group, `'both'` for either. Group rows need groups
4931
+ * in `options` — with a flat list they have nothing to head. */
4932
+ readonly selectAll: _angular_core.InputSignalWithTransform<boolean | "group" | "both", unknown>;
4933
+ protected readonly optionTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4934
+ protected readonly chipTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4935
+ protected readonly pickerTrigger: _angular_core.Signal<TemplateRef<any> | undefined>;
4936
+ protected readonly emptyTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4823
4937
  protected readonly uid: string;
4824
4938
  protected readonly listboxId: string;
4939
+ protected readonly labelId: string;
4825
4940
  protected optionId(index: number): string;
4826
4941
  protected readonly trigger: _angular_core.Signal<ElementRef<HTMLElement>>;
4827
4942
  protected readonly searchInput: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
@@ -4834,6 +4949,11 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4834
4949
  private focusTimer;
4835
4950
  ngOnDestroy(): void;
4836
4951
  protected readonly isDisabled: _angular_core.Signal<boolean>;
4952
+ protected readonly showsCompactTrigger: _angular_core.Signal<boolean>;
4953
+ protected readonly showsSearch: _angular_core.Signal<boolean>;
4954
+ protected readonly triggerActiveDescendant: _angular_core.Signal<string | null>;
4955
+ protected readonly triggerCaption: _angular_core.Signal<string>;
4956
+ protected readonly allOptions: _angular_core.Signal<MultiSelectOption[]>;
4837
4957
  protected readonly selectedOptions: _angular_core.Signal<MultiSelectOption[]>;
4838
4958
  private readonly chipsMode;
4839
4959
  private readonly showsEveryChip;
@@ -4852,7 +4972,13 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4852
4972
  private readonly chipsThatFit;
4853
4973
  protected readonly visibleChips: _angular_core.Signal<MultiSelectOption[]>;
4854
4974
  protected readonly overflowCount: _angular_core.Signal<number>;
4975
+ protected readonly filteredItems: _angular_core.Signal<MultiSelectItem[]>;
4855
4976
  protected readonly filteredOptions: _angular_core.Signal<MultiSelectOption[]>;
4977
+ protected isGroup(item: MultiSelectItem): item is MultiSelectOptionGroup;
4978
+ /** Where an option sits in the flat visible list — the id the listbox's
4979
+ * `aria-activedescendant` points at, which a grouped render cannot get from
4980
+ * the loop index. */
4981
+ protected flatIndexOf(option: MultiSelectOption): number;
4856
4982
  protected readonly activeDescendant: _angular_core.Signal<string | null>;
4857
4983
  protected readonly resolvedAriaLabel: _angular_core.Signal<string>;
4858
4984
  protected readonly hintId: _angular_core.Signal<string | null>;
@@ -4863,11 +4989,18 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4863
4989
  private enabledFiltered;
4864
4990
  protected readonly allFilteredSelected: _angular_core.Signal<boolean>;
4865
4991
  protected readonly someFilteredSelected: _angular_core.Signal<boolean>;
4992
+ protected readonly showsPanelSelectAll: _angular_core.Signal<boolean>;
4993
+ protected readonly showsGroupSelectAll: _angular_core.Signal<boolean>;
4994
+ private enabledIn;
4995
+ protected groupAllSelected(group: MultiSelectOptionGroup): boolean;
4996
+ protected groupSomeSelected(group: MultiSelectOptionGroup): boolean;
4997
+ protected toggleGroup(group: MultiSelectOptionGroup): void;
4866
4998
  protected toggleSelectAll(): void;
4867
4999
  protected isSelected(value: string): boolean;
4868
5000
  protected toggleValue(option: MultiSelectOption): void;
4869
5001
  protected removeValue(value: string): void;
4870
5002
  protected onFilter(event: Event): void;
5003
+ private firstEnabledIndex;
4871
5004
  protected onTriggerKeydown(event: KeyboardEvent): void;
4872
5005
  protected onSearchKeydown(event: KeyboardEvent): void;
4873
5006
  protected openPanel(): void;
@@ -4875,7 +5008,7 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4875
5008
  protected close(cause?: DsOverlayCloseCause): void;
4876
5009
  private moveActive;
4877
5010
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
4878
- 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; }; "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; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, 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>;
4879
5012
  }
4880
5013
 
4881
5014
  declare class SkeletonComponent {
@@ -5062,6 +5195,98 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
5062
5195
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<SwitchComponent, "ds-switch", never, { "checked": { "alias": "checked"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "inputId": { "alias": "inputId"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; }, never, ["*"], true, never>;
5063
5196
  }
5064
5197
 
5198
+ /**
5199
+ * Fills an option row's LABEL AREA in `ds-select`, `ds-multi-select` and
5200
+ * `ds-autocomplete` — an avatar, a colour dot, a second line of metadata.
5201
+ *
5202
+ * ```html
5203
+ * <ds-multi-select [options]="assignees()">
5204
+ * <ng-template dsOptionTemplate let-option>
5205
+ * <ds-avatar size="xs" [seed]="option.label" /> {{ option.label }}
5206
+ * </ng-template>
5207
+ * </ds-multi-select>
5208
+ * ```
5209
+ *
5210
+ * The row itself stays library-owned: `role="option"`, `aria-selected`, the
5211
+ * active-row class, the checkbox and the check glyph are not projected, so a
5212
+ * template cannot take the listbox semantics with it.
5213
+ */
5214
+ declare class DsOptionTemplateDirective {
5215
+ readonly template: TemplateRef<unknown>;
5216
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsOptionTemplateDirective, never>;
5217
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsOptionTemplateDirective, "[dsOptionTemplate]", never, {}, {}, never, never, true, never>;
5218
+ }
5219
+
5220
+ /**
5221
+ * Replaces the CONTENTS of a picker's trigger — the chips, the value, the
5222
+ * placeholder — with your own markup. The trigger ELEMENT stays library-owned,
5223
+ * so `aria-haspopup`, `aria-expanded`, `aria-controls`, the roving
5224
+ * `aria-activedescendant` and the Enter/Space/ArrowDown/Escape handling cannot
5225
+ * be lost with it.
5226
+ *
5227
+ * ```html
5228
+ * <ds-multi-select [options]="labels()" [(value)]="picked">
5229
+ * <ng-template dsPickerTrigger let-count="count">
5230
+ * Labels @if (count) { <ds-badge [count]="count" /> }
5231
+ * </ng-template>
5232
+ * </ds-multi-select>
5233
+ * ```
5234
+ *
5235
+ * Context: `$implicit` and `selected` are the selected options, `count` their
5236
+ * number, `open` whether the panel is showing, `disabled` the control's state.
5237
+ *
5238
+ * A projected template WINS over `triggerDisplay` — that input is then not read
5239
+ * at all, so there is no "compact plus a template" combination to explain.
5240
+ */
5241
+ declare class DsPickerTriggerDirective {
5242
+ readonly template: TemplateRef<unknown>;
5243
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsPickerTriggerDirective, never>;
5244
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsPickerTriggerDirective, "[dsPickerTrigger]", never, {}, {}, never, never, true, never>;
5245
+ }
5246
+
5247
+ /**
5248
+ * Replaces a picker panel's "no matches" row — an icon, a sentence in the app's
5249
+ * own language, a "clear the filter" button.
5250
+ *
5251
+ * Context: `query` is the text that matched nothing.
5252
+ *
5253
+ * The row keeps `role="status"`, so a reader is told the list emptied whatever
5254
+ * the template puts inside it.
5255
+ */
5256
+ declare class DsEmptyTemplateDirective {
5257
+ readonly template: TemplateRef<unknown>;
5258
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsEmptyTemplateDirective, never>;
5259
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsEmptyTemplateDirective, "[dsEmptyTemplate]", never, {}, {}, never, never, true, never>;
5260
+ }
5261
+
5262
+ /**
5263
+ * Replaces `ds-autocomplete`'s "Create «…»" row.
5264
+ *
5265
+ * Context: `query` is the typed text the row would create.
5266
+ *
5267
+ * The row stays a `role="option"` the keyboard can reach, and picking it still
5268
+ * emits `create` — the template fills the row, it does not become the action.
5269
+ */
5270
+ declare class DsCreateTemplateDirective {
5271
+ readonly template: TemplateRef<unknown>;
5272
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsCreateTemplateDirective, never>;
5273
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsCreateTemplateDirective, "[dsCreateTemplate]", never, {}, {}, never, never, true, never>;
5274
+ }
5275
+
5276
+ /**
5277
+ * Fills a selected chip's content in the trigger of `ds-multi-select` and
5278
+ * `ds-autocomplete`, so a picker whose rows carry an avatar does not lose it the
5279
+ * moment the option is chosen.
5280
+ *
5281
+ * The chip is still a `ds-tag` owned by the library: its close button, its
5282
+ * accessible remove label and the measured overflow cap are not projected.
5283
+ */
5284
+ declare class DsChipTemplateDirective {
5285
+ readonly template: TemplateRef<unknown>;
5286
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsChipTemplateDirective, never>;
5287
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsChipTemplateDirective, "[dsChipTemplate]", never, {}, {}, never, never, true, never>;
5288
+ }
5289
+
5065
5290
  /**
5066
5291
  * Focuses the field's inner `input`/`textarea` when the click lands on the
5067
5292
  * frame chrome — padding, a leading/trailing icon, an addon slot — instead of
@@ -5079,5 +5304,5 @@ declare class FieldClickFocusDirective {
5079
5304
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
5080
5305
  }
5081
5306
 
5082
- 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, DsOverlayCloseRef, 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, inheritDsConfig, initialsFrom, isSelectOptionGroup, passwordRulesMet, provideDsConfig, provideDsIcons, provideDsTheme };
5083
- export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteOption, AutocompleteOptionGroup, AutocompleteWidth, AvatarSize, AvatarStatus, AvatarTintOptions, BannerVariant, BreadcrumbItem, ButtonColor, ButtonType, ButtonVariant, CardElevation, CardPadding, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerSpacing, DividerVariant, DrawerPlacement, DropzoneFile, DropzoneFileState, DsConfig, DsFieldError, DsFieldErrorsInput, DsFieldGroupContext, DsIconRegistry, DsOption, DsPasswordRule, DsPasswordRuleState, DsScrollReset, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, EmptyStateVariant, HeaderFilterContext, IconButtonType, IconButtonVariant, IconName, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectOption, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, 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 };
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 };