@ids-group-ltd/ids-design-system 0.10.3 → 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 (58) hide show
  1. package/CHANGELOG.md +1376 -904
  2. package/components.md +61 -30
  3. package/design-system.md +18 -18
  4. package/fesm2022/ids-group-ltd-ids-design-system.mjs +992 -486
  5. package/fesm2022/ids-group-ltd-ids-design-system.mjs.map +1 -1
  6. package/migrations/0.1.0.json +2 -1
  7. package/migrations/0.10.0.json +219 -42
  8. package/migrations/0.10.1.json +50 -13
  9. package/migrations/0.10.2.json +90 -24
  10. package/migrations/0.10.3.json +22 -5
  11. package/migrations/0.11.0.json +216 -0
  12. package/migrations/0.11.1.json +305 -0
  13. package/migrations/0.2.0.json +22 -9
  14. package/migrations/0.2.1.json +2 -1
  15. package/migrations/0.2.2.json +3 -2
  16. package/migrations/0.3.0.json +16 -10
  17. package/migrations/0.4.0.json +38 -14
  18. package/migrations/0.5.0.json +49 -25
  19. package/migrations/0.5.1/badge-statuses.md +1 -3
  20. package/migrations/0.5.1.json +75 -33
  21. package/migrations/0.6.0.json +6 -2
  22. package/migrations/0.6.1.json +19 -1
  23. package/migrations/0.6.2.json +3 -1
  24. package/migrations/0.6.3.json +13 -4
  25. package/migrations/0.7.0.json +45 -26
  26. package/migrations/0.7.1.json +58 -20
  27. package/migrations/0.8.0.json +53 -15
  28. package/migrations/0.9.0.json +147 -27
  29. package/migrations/0.9.1.json +4 -3
  30. package/migrations/README.md +34 -52
  31. package/package.json +2 -1
  32. package/styles/_dropdown-overlay.scss +35 -13
  33. package/styles/_ds-color.scss +3 -3
  34. package/styles/_field-box.scss +2 -6
  35. package/styles/_field-label.scss +5 -10
  36. package/styles/_field-state.scss +3 -2
  37. package/styles/_focus.scss +0 -2
  38. package/styles/_layout-utils.scss +2 -2
  39. package/styles/_link.scss +1 -2
  40. package/styles/_overlay-motion.scss +2 -4
  41. package/styles/_press.scss +3 -5
  42. package/styles/_reset.scss +0 -1
  43. package/styles/_scrollbar.scss +1 -3
  44. package/styles/_status.scss +1 -2
  45. package/styles/_surface-motion.scss +3 -4
  46. package/styles/_text-clip.scss +1 -1
  47. package/styles/_theme-activation.scss +1 -1
  48. package/styles/_tokens-charts.scss +1 -3
  49. package/styles/_tokens.scss +4 -3
  50. package/styles/_typography.scss +2 -2
  51. package/themes/README.md +3 -3
  52. package/themes/_base-palette.scss +2 -2
  53. package/themes/_semantic.scss +2 -2
  54. package/themes/dark/_palette.scss +1 -2
  55. package/themes/light/_palette.scss +1 -1
  56. package/themes/light/_theme.scss +1 -1
  57. package/types/ids-group-ltd-ids-design-system.d.ts +403 -108
  58. package/migrations/AUTHORING.md +0 -273
@@ -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;
@@ -412,19 +461,81 @@ declare class ReserveMessagesDirective {
412
461
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ReserveMessagesDirective, "[dsReserveMessages]", never, {}, {}, never, never, true, never>;
413
462
  }
414
463
 
464
+ type FieldMessageState = 'default' | 'error' | 'warning' | 'success';
465
+
466
+ /**
467
+ * One validation error, structurally identical to Angular's signal-forms
468
+ * `ValidationError`.
469
+ *
470
+ * Declared here rather than imported from `@angular/forms/signals` on purpose:
471
+ * that module is `@experimental`, and a public DS type must not carry a
472
+ * dependency that can be renamed out from under consumers. Structural
473
+ * compatibility is all the interop needs — signal forms binds by input NAME and
474
+ * assigns its own `ValidationError[]`, which this shape accepts.
475
+ */
476
+ interface DsFieldError {
477
+ /** Identifies the kind of error, e.g. `required`, `minlength`, `server`. */
478
+ readonly kind: string;
479
+ /** Human-readable text. Authored by the consumer, at the validator. */
480
+ readonly message?: string;
481
+ }
482
+ /** What a field's `errors` input accepts before normalization. */
483
+ type DsFieldErrorsInput = string | DsFieldError | readonly DsFieldError[] | null | undefined;
484
+ /**
485
+ * The one reserved `DsFieldError.kind`. An error carrying it is advisory: it shows
486
+ * in the warning state and does NOT make the control invalid, which is how a form
487
+ * model can raise a non-blocking remark — Angular's own `AbstractControl` has no
488
+ * channel for one, only `errors` and the validity derived from it.
489
+ */
490
+ declare const DS_FIELD_WARNING_KIND = "warning";
491
+ /** The single line a field shows below itself, already resolved. */
492
+ interface DsFieldMessage {
493
+ readonly text: string;
494
+ readonly state: FieldMessageState;
495
+ }
496
+
415
497
  type ButtonColor = 'primary' | 'secondary' | 'tertiary' | 'neutral' | 'error' | 'success' | 'warning';
416
498
  type ButtonVariant = 'solid' | 'tonal' | 'ghost' | 'outline' | 'text';
417
499
  type ButtonType = 'button' | 'submit' | 'reset';
418
500
 
419
- declare class ButtonComponent {
501
+ /**
502
+ * The inputs of anything that renders a `ds-field-message` line — the message half
503
+ * of a field, split out so `ds-button` can take it without also taking `errors`,
504
+ * `invalid` and `touched`, which describe a form control's validation state and
505
+ * mean nothing on a button.
506
+ *
507
+ * `@Directive()` is required, not decoration: Angular refuses to compile a base
508
+ * class that declares inputs without it.
509
+ */
510
+ declare abstract class DsMessageBase {
511
+ /** Helper text shown below the control. */
512
+ readonly hint: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
513
+ /** Error text. Shown immediately — binding it says the consumer has already
514
+ * decided this is in error. Takes precedence over `errors`. */
515
+ readonly error: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
516
+ /** Advisory text, shown when there is no error. */
517
+ readonly warning: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
518
+ /** Reserve the message-row height even when empty, so the control doesn't shift
519
+ * the layout below it when a hint/error appears. Falls back to
520
+ * `DS_CONFIG.field.reserveMessage`, then off. */
521
+ readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
522
+ /** Glyph on the message line, overriding what the state resolves to. Unset
523
+ * follows `DS_CONFIG.field.stateIcons`; `false` removes the glyph here alone. */
524
+ readonly messageIcon: _angular_core.InputSignal<false | IconName | null>;
525
+ readonly reserveMessageResolved: _angular_core.Signal<boolean>;
526
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsMessageBase, never>;
527
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsMessageBase, never, never, { "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "messageIcon": { "alias": "messageIcon"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
528
+ }
529
+
530
+ declare class ButtonComponent extends DsMessageBase {
420
531
  /** Segment of a ds-field-group: the group owns the border, radius and focus
421
532
  * ring, so .in-group strips this control back to its bare contents. */
422
533
  protected readonly inGroup: boolean;
423
534
  /** Brand/status hue family. */
424
535
  readonly color: _angular_core.InputSignal<ButtonColor>;
425
536
  /** Fill pattern: solid | tonal | ghost | outline | text. All color×variant
426
- pairs render; some are UX-discouraged (see DISCOURAGED_COMBOS / the docs)
427
- 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
428
539
  discouraged for ALL colours — prefer the global `.link` class; it stays for
429
540
  cases needing the ds-button API (loading/fullWidth/typed pressed). */
430
541
  readonly variant: _angular_core.InputSignal<ButtonVariant>;
@@ -458,6 +569,21 @@ declare class ButtonComponent {
458
569
  /** ARIA `aria-controls`, forwarded to the inner <button> — the id of the panel
459
570
  * this button opens, e.g. `ds-app-layout`'s `railId`. */
460
571
  readonly ariaControls: _angular_core.InputSignal<string | null>;
572
+ /** Why the button is refused, shown as its second line. Read only while
573
+ * `disabled` — a greyed control that does not say why is a dead end.
574
+ *
575
+ * Setting it also changes HOW the button is disabled: it takes `aria-disabled`
576
+ * instead of the native attribute, because a natively disabled button cannot be
577
+ * focused and the reason would never be announced. The click is swallowed in
578
+ * `onClick` instead. Leave it unset and nothing changes.
579
+ *
580
+ * Length is deliberately not capped: the text wraps and the button grows. Same
581
+ * name and meaning as `TableRowAction.disabledReason`. */
582
+ readonly disabledReason: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
583
+ /** ARIA `aria-describedby` — point the button at a description the app renders
584
+ * itself, such as a `ds-field-message` under a form. Merged with the id of
585
+ * `disabledReason` when both are present. */
586
+ readonly ariaDescribedBy: _angular_core.InputSignal<string | null>;
461
587
  /** Fires on click, unless `disabled` or `loading`. */
462
588
  readonly pressed: _angular_core.OutputEmitterRef<MouseEvent>;
463
589
  /** The inner native <button>, exposed so overlay triggers can position
@@ -465,10 +591,18 @@ declare class ButtonComponent {
465
591
  * `(pressed)="pop.toggle(trigger.buttonRef().nativeElement)"`. */
466
592
  readonly buttonRef: _angular_core.Signal<ElementRef<HTMLButtonElement>>;
467
593
  protected readonly classes: _angular_core.Signal<string>;
594
+ protected readonly softDisabled: _angular_core.Signal<boolean>;
595
+ private readonly uid;
596
+ protected readonly reasonId: string;
597
+ protected readonly hintId: _angular_core.Signal<string | null>;
598
+ protected readonly describedBy: _angular_core.Signal<string | null>;
599
+ protected readonly hasMessageRow: _angular_core.Signal<boolean>;
600
+ private readonly fieldMessage;
601
+ protected readonly message: _angular_core.Signal<DsFieldMessage>;
468
602
  constructor();
469
603
  protected onClick(event: MouseEvent): void;
470
604
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonComponent, never>;
471
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonComponent, "ds-button", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "trailingIcon": { "alias": "trailingIcon"; "required": false; "isSignal": true; }; "ariaHasPopup": { "alias": "ariaHasPopup"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; "ariaControls": { "alias": "ariaControls"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["*", "[dsButtonSubtext]"], true, never>;
605
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonComponent, "ds-button", never, { "color": { "alias": "color"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "trailingIcon": { "alias": "trailingIcon"; "required": false; "isSignal": true; }; "ariaHasPopup": { "alias": "ariaHasPopup"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; "ariaControls": { "alias": "ariaControls"; "required": false; "isSignal": true; }; "disabledReason": { "alias": "disabledReason"; "required": false; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, ["*", "[dsButtonSubtext]"], true, never>;
472
606
  }
473
607
 
474
608
  /** A single binary toggle button (pressed / not pressed) with an optional
@@ -500,6 +634,11 @@ declare class IconButtonComponent {
500
634
  readonly icon: _angular_core.InputSignal<IconName>;
501
635
  /** Accessible name — required since the button has no visible text. */
502
636
  readonly ariaLabel: _angular_core.InputSignal<string>;
637
+ /** ARIA `aria-describedby` — the id of text the app renders beside the button,
638
+ * such as why the action is refused. Icon-only leaves no room for a second
639
+ * line, so unlike `ds-button` there is no `disabledReason` here: the text has
640
+ * to exist on screen already for this to point at it. */
641
+ readonly ariaDescribedBy: _angular_core.InputSignal<string | null>;
503
642
  /** Fill style — standard (chromeless), filled, tonal, or outlined. */
504
643
  readonly variant: _angular_core.InputSignal<IconButtonVariant>;
505
644
  /** Brand/status hue family (shared with ds-button). `variant` is the fill
@@ -528,7 +667,7 @@ declare class IconButtonComponent {
528
667
  protected readonly iconSize: _angular_core.Signal<16 | 24 | 20>;
529
668
  protected onClick(event: MouseEvent): void;
530
669
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<IconButtonComponent, never>;
531
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<IconButtonComponent, "ds-icon-button", never, { "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": true; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; "ariaControls": { "alias": "ariaControls"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, never, true, never>;
670
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<IconButtonComponent, "ds-icon-button", never, { "icon": { "alias": "icon"; "required": true; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": true; "isSignal": true; }; "ariaDescribedBy": { "alias": "ariaDescribedBy"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "ariaExpanded": { "alias": "ariaExpanded"; "required": false; "isSignal": true; }; "ariaControls": { "alias": "ariaControls"; "required": false; "isSignal": true; }; }, { "pressed": "pressed"; }, never, never, true, never>;
532
671
  }
533
672
 
534
673
  declare class BadgeComponent {
@@ -838,7 +977,7 @@ declare class BrandNameDirective {
838
977
  * screens behind the login.
839
978
  *
840
979
  * Brand row, tagline, card and support footer are the same four parts in every
841
- * 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
842
981
  * box: they nest a `100vh` wrapper inside a `100dvh` one and scroll a page whose
843
982
  * content fits. Here the host is the only one, and it also carries the safe-area
844
983
  * insets a notched phone in landscape needs.
@@ -868,8 +1007,8 @@ declare class BrandNameDirective {
868
1007
  declare class AuthLayoutComponent {
869
1008
  /** Wordmark beside the letter-mark tile. For a logo image/SVG, project it into
870
1009
  * the `[brand]` slot instead; for a two-tone wordmark use `[dsBrandName]`.
871
- * Unset falls back to `DS_CONFIG.brand.name` — six auth screens answer this
872
- * 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
873
1012
  * but a `logoLetter` in the config still paints its tile; clear both to give one
874
1013
  * screen no brand row. */
875
1014
  readonly brand: _angular_core.InputSignal<string | null>;
@@ -893,10 +1032,8 @@ declare class AuthLayoutComponent {
893
1032
  * content of an auth screen and `ds-card` renders an `<article>`, which is NOT
894
1033
  * a landmark, so by default a screen-reader user has nothing to jump to — set
895
1034
  * this to `'main'` on a standalone auth page. It is opt-in because the layout
896
- * is also embedded inside pages that already own a `main` (this repo's own docs
897
- * site nests it inside `ds-app-layout`), and two `main`s is its own violation.
898
- * Defaulting it to `'main'` is the better end state and belongs in the next
899
- * batch of default changes. */
1035
+ * is also embedded inside pages that already own a `main`, and two `main`s is its
1036
+ * own violation. */
900
1037
  readonly landmark: _angular_core.InputSignal<"none" | "main">;
901
1038
  /** Projected `[dsBrandName]` wordmark markup, when the consumer provides one. */
902
1039
  protected readonly brandNameRef: _angular_core.Signal<BrandNameDirective | undefined>;
@@ -1320,39 +1457,6 @@ declare class TabsComponent {
1320
1457
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabsComponent, "ds-tabs", never, { "selectedIndex": { "alias": "selectedIndex"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "scrollable": { "alias": "scrollable"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "urlParam": { "alias": "urlParam"; "required": false; "isSignal": true; }; "rememberLastTab": { "alias": "rememberLastTab"; "required": false; "isSignal": true; }; }, { "selectedIndex": "selectedIndexChange"; "tabClosed": "tabClosed"; }, ["tabs"], never, true, never>;
1321
1458
  }
1322
1459
 
1323
- type FieldMessageState = 'default' | 'error' | 'warning' | 'success';
1324
-
1325
- /**
1326
- * One validation error, structurally identical to Angular's signal-forms
1327
- * `ValidationError`.
1328
- *
1329
- * Declared here rather than imported from `@angular/forms/signals` on purpose:
1330
- * that module is `@experimental`, and a public DS type must not carry a
1331
- * dependency that can be renamed out from under consumers. Structural
1332
- * compatibility is all the interop needs — signal forms binds by input NAME and
1333
- * assigns its own `ValidationError[]`, which this shape accepts.
1334
- */
1335
- interface DsFieldError {
1336
- /** Identifies the kind of error, e.g. `required`, `minlength`, `server`. */
1337
- readonly kind: string;
1338
- /** Human-readable text. Authored by the consumer, at the validator. */
1339
- readonly message?: string;
1340
- }
1341
- /** What a field's `errors` input accepts before normalization. */
1342
- type DsFieldErrorsInput = string | DsFieldError | readonly DsFieldError[] | null | undefined;
1343
- /**
1344
- * The one reserved `DsFieldError.kind`. An error carrying it is advisory: it shows
1345
- * in the warning state and does NOT make the control invalid, which is how a form
1346
- * model can raise a non-blocking remark — Angular's own `AbstractControl` has no
1347
- * channel for one, only `errors` and the validity derived from it.
1348
- */
1349
- declare const DS_FIELD_WARNING_KIND = "warning";
1350
- /** The single line a field shows below itself, already resolved. */
1351
- interface DsFieldMessage {
1352
- readonly text: string;
1353
- readonly state: FieldMessageState;
1354
- }
1355
-
1356
1460
  /**
1357
1461
  * The inputs every DS form field has, declared once.
1358
1462
  *
@@ -1361,17 +1465,11 @@ interface DsFieldMessage {
1361
1465
  * lifting them would hand a checkbox a `success` or a slider a `label` it never
1362
1466
  * had — a silent public-API addition.
1363
1467
  *
1364
- * `@Directive()` is required, not decoration: Angular refuses to compile a base
1365
- * class that declares inputs without it.
1468
+ * The message half lives one level up in `DsMessageBase`, which anything with a
1469
+ * message line can take. What stays here is the validation state a form control
1470
+ * has and a plain control does not.
1366
1471
  */
1367
- declare abstract class DsFieldBase {
1368
- /** Helper text shown below the field. */
1369
- readonly hint: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
1370
- /** Error text. Shown immediately — binding it says the consumer has already
1371
- * decided this field is in error. Takes precedence over `errors`. */
1372
- readonly error: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
1373
- /** Advisory text, shown when there is no error. */
1374
- readonly warning: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
1472
+ declare abstract class DsFieldBase extends DsMessageBase {
1375
1473
  /** Validation errors, shown once the user has interacted. Bound automatically
1376
1474
  * by signal forms; reactive and template-driven forms are read through
1377
1475
  * `NgControl` and need nothing here. Accepts a string, one error, or an array. */
@@ -1383,18 +1481,8 @@ declare abstract class DsFieldBase {
1383
1481
  /** Whether the user has interacted with the field. Bound by signal forms; gates
1384
1482
  * `errors`, so a `required` error does not greet an untouched form. */
1385
1483
  readonly touched: _angular_core.InputSignalWithTransform<boolean, unknown>;
1386
- /** Reserve the message-row height even when empty, so the field doesn't shift
1387
- * the layout below it when a hint/error appears. Falls back to
1388
- * `DS_CONFIG.field.reserveMessage`, then off — opt in per field, or app-wide
1389
- * for a form that shows validation messages. */
1390
- readonly reserveMessage: _angular_core.InputSignalWithTransform<boolean | null, unknown>;
1391
- /** Glyph on the message line, overriding what the state resolves to. Unset
1392
- * follows `DS_CONFIG.field.stateIcons`; `false` removes the glyph on this field
1393
- * alone. */
1394
- readonly messageIcon: _angular_core.InputSignal<false | IconName | null>;
1395
- readonly reserveMessageResolved: _angular_core.Signal<boolean>;
1396
1484
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsFieldBase, never>;
1397
- static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsFieldBase, never, never, { "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "error": { "alias": "error"; "required": false; "isSignal": true; }; "warning": { "alias": "warning"; "required": false; "isSignal": true; }; "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; "reserveMessage": { "alias": "reserveMessage"; "required": false; "isSignal": true; }; "messageIcon": { "alias": "messageIcon"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
1485
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsFieldBase, never, never, { "errors": { "alias": "errors"; "required": false; "isSignal": true; }; "invalid": { "alias": "invalid"; "required": false; "isSignal": true; }; "touched": { "alias": "touched"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
1398
1486
  }
1399
1487
 
1400
1488
  /**
@@ -1787,12 +1875,10 @@ declare class DsStaticPreview {
1787
1875
 
1788
1876
  interface SelectOption extends DsOption<string> {
1789
1877
  }
1790
- interface SelectOptionGroup {
1791
- label: string;
1792
- options: SelectOption[];
1793
- disabled?: boolean;
1878
+ type SelectWidth = DsControlWidth;
1879
+ interface SelectOptionGroup extends DsOptionGroup<string> {
1794
1880
  }
1795
- type SelectItem = SelectOption | SelectOptionGroup;
1881
+ type SelectItem = DsOptionItem<string>;
1796
1882
  declare function isSelectOptionGroup(item: SelectItem): item is SelectOptionGroup;
1797
1883
 
1798
1884
  declare class SelectComponent extends DsControlValueAccessor<string> implements OnDestroy {
@@ -1806,7 +1892,15 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1806
1892
  /** Selected option's value, two-way bound. */
1807
1893
  readonly value: _angular_core.ModelSignal<string>;
1808
1894
  /** Flat options or option groups rendered in the dropdown panel. */
1809
- 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>;
1810
1904
  /** Shown in the trigger when nothing is selected. */
1811
1905
  readonly placeholder: _angular_core.InputSignal<string>;
1812
1906
  /** Trigger height — sm/md/lg.
@@ -1838,6 +1932,9 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1838
1932
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
1839
1933
  /** Shows an inline clear (×) button when a value is selected. */
1840
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>;
1841
1938
  protected readonly uid: string;
1842
1939
  protected readonly labelId: string;
1843
1940
  protected readonly listboxId: string;
@@ -1883,7 +1980,7 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1883
1980
  private firstEnabledIndex;
1884
1981
  private lastEnabledIndex;
1885
1982
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
1886
- 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: {}; }]>;
1887
1984
  }
1888
1985
 
1889
1986
  /**
@@ -2031,8 +2128,26 @@ interface TableColumn<T = unknown> {
2031
2128
  * colour and underline while the row is hovered. Only has an effect on a
2032
2129
  * `rowInteractive` table: on a passive one every hover treatment is suppressed on
2033
2130
  * purpose, so a tint cannot promise a click that does not happen. Style it with
2034
- * `--ds-table-cell-link-color` / `--ds-table-cell-link-decoration`. */
2131
+ * `--ds-table-cell-link-color` / `--ds-table-cell-link-decoration`.
2132
+ *
2133
+ * Prefer `link` where the row leads somewhere: a tint appears only on hover, which
2134
+ * a keyboard or touch user never sees. */
2035
2135
  interactive?: boolean;
2136
+ /** Renders this column's value as a real `<a>`, which is the accessible way to say
2137
+ * a row leads somewhere: it is visible without hovering, lands in the tab order as
2138
+ * a link rather than as a table row, and opens in a new tab on Ctrl/Cmd-click —
2139
+ * none of which a clickable `<tr>` can offer.
2140
+ *
2141
+ * Return an Angular route target (a string, or the array form for dynamic
2142
+ * segments); `null` / `undefined` leaves that row's cell as plain text, so a list
2143
+ * where only some rows are reachable needs no second column. For an external URL,
2144
+ * render the cell through a `[cell]` template instead — this takes route targets
2145
+ * only, and the router is touched at all only once a column sets `link`.
2146
+ *
2147
+ * Composes with `rowInteractive`: the link stops its own click from reaching the
2148
+ * row, so the row handler fires for the rest of the row and the link navigates
2149
+ * once. Style it with the same `--ds-table-cell-link-*` tokens as `interactive`. */
2150
+ link?: (row: T) => string | readonly unknown[] | null | undefined;
2036
2151
  /** Initial visibility: start hidden. The column picker (or a bound
2037
2152
  * `hiddenKeys` set) owns the state from then on; a hidden column stays
2038
2153
  * available to `filterable` matching and sorting. */
@@ -2087,7 +2202,7 @@ declare class TableComponent<T extends object> {
2087
2202
  /** Adds a checkbox column for row/select-all selection. */
2088
2203
  readonly selectable: _angular_core.InputSignalWithTransform<boolean, unknown>;
2089
2204
  /** Opt-in outer border + radius. Off by default so tables flush inside a
2090
- * `<ds-card padding="none">` (workspaces, programs-list) don't double-border.
2205
+ * `<ds-card padding="none">` don't double-border.
2091
2206
  * When `true`, the scroll-wrap gets a `var(--border-default)` outline and
2092
2207
  * `var(--radius-md)` radius — useful when the table stands alone in a padded card.
2093
2208
  * Unset falls back to `DS_CONFIG.table.bordered`, then `false`. */
@@ -2592,6 +2707,7 @@ declare class TableComponent<T extends object> {
2592
2707
  protected headerClasses(col: TableColumn<T>): string;
2593
2708
  protected sortIcon(col: TableColumn<T>): 'sortAsc' | 'sortDesc' | 'sort';
2594
2709
  protected cellValue(row: T, col: TableColumn<T>): string;
2710
+ protected cellLink(row: T, col: TableColumn<T>): string | readonly unknown[] | null;
2595
2711
  /** Serialises the visible columns of the rows the TABLE HOLDS as a CSV download.
2596
2712
  * On a server-paged table that is one page — prefer `runExport()`, which goes
2597
2713
  * through `exportFetcher` and exports the whole set. Pass `rows` to serialise a
@@ -3121,7 +3237,7 @@ declare class TimePickerComponent extends DsControlValueAccessor<string | TimeRa
3121
3237
  protected readonly columns: _angular_core.Signal<TimeColumnsComponent | undefined>;
3122
3238
  /** Any of the three trigger boxes, not the host: a range renders two and a single
3123
3239
  * one renders one, while the host also carries the label and the message row —
3124
- * clicking those has to dismiss the panel (MBP-225). */
3240
+ * clicking those has to dismiss the panel. */
3125
3241
  private insideATrigger;
3126
3242
  protected readonly isDisabled: _angular_core.Signal<boolean>;
3127
3243
  protected readonly hintId: _angular_core.Signal<string | null>;
@@ -3244,6 +3360,13 @@ declare class SidenavComponent implements SidenavContract {
3244
3360
  * "A" tile beside the "MyAdmin" wordmark). Empty = first letter of `brand`;
3245
3361
  * unset falls back to `DS_CONFIG.brand.logoLetter`. */
3246
3362
  readonly logoLetter: _angular_core.InputSignal<string | null>;
3363
+ /** Route the brand row links to — typically the app's home. Unset leaves the row a
3364
+ * plain, non-interactive block. Router targets only, and `RouterLink` is
3365
+ * instantiated only once this is set, so an app with no router still renders. */
3366
+ readonly brandRoute: _angular_core.InputSignal<string | readonly unknown[] | null>;
3367
+ /** Accessible name for the brand link; unset names it "<brand>, home". Ignored
3368
+ * while `brandRoute` is unset. */
3369
+ readonly brandLinkLabel: _angular_core.InputSignal<string | null>;
3247
3370
  /** The template must read THIS, never the input beside it — that one is null
3248
3371
  * until bound, and the config default lives here. */
3249
3372
  readonly brandName: _angular_core.Signal<string>;
@@ -3255,8 +3378,9 @@ declare class SidenavComponent implements SidenavContract {
3255
3378
  * starting with an astral character (an emoji, a rarer CJK glyph) yields half
3256
3379
  * a surrogate pair and paints as tofu. */
3257
3380
  protected readonly markGlyph: _angular_core.Signal<string>;
3381
+ protected readonly brandAriaLabel: _angular_core.Signal<string>;
3258
3382
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SidenavComponent, never>;
3259
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavComponent, "ds-sidenav", never, { "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "rail": { "alias": "rail"; "required": false; "isSignal": true; }; "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "logoLetter": { "alias": "logoLetter"; "required": false; "isSignal": true; }; }, {}, ["brandNameRef"], ["[brand]", "[dsBrandName]", "*"], true, never>;
3383
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SidenavComponent, "ds-sidenav", never, { "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "rail": { "alias": "rail"; "required": false; "isSignal": true; }; "brand": { "alias": "brand"; "required": false; "isSignal": true; }; "logoLetter": { "alias": "logoLetter"; "required": false; "isSignal": true; }; "brandRoute": { "alias": "brandRoute"; "required": false; "isSignal": true; }; "brandLinkLabel": { "alias": "brandLinkLabel"; "required": false; "isSignal": true; }; }, {}, ["brandNameRef"], ["[brand]", "[dsBrandName]", "*"], true, never>;
3260
3384
  }
3261
3385
 
3262
3386
  declare class SidenavGroupComponent {
@@ -3340,7 +3464,7 @@ interface SidenavAlertItem {
3340
3464
  * A single global-search hit rendered in the sidenav Search popover. The footer
3341
3465
  * stays domain-agnostic: the layout supplies a {@link SidenavSearchProvider} that maps
3342
3466
  * a query string to these results, so the footer never needs to know about the
3343
- * portal's sections or entities.
3467
+ * app's sections or entities.
3344
3468
  */
3345
3469
  interface SidenavSearchResult {
3346
3470
  readonly id: string;
@@ -4162,14 +4286,15 @@ declare class PageFooterComponent {
4162
4286
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<PageFooterComponent, "ds-page-footer", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, ["[brand]", "[nav]", "[actions]", "*"], true, never>;
4163
4287
  }
4164
4288
 
4165
- /** `fill` stretches to the host container (default); `content` hugs chips/value + a min typing area. */
4166
- 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';
4167
4293
  interface AutocompleteOption<T = unknown> extends DsOption<T> {
4168
4294
  }
4169
- interface AutocompleteOptionGroup<T = unknown> {
4170
- readonly label: string;
4171
- readonly options: AutocompleteOption<T>[];
4295
+ interface AutocompleteOptionGroup<T = unknown> extends DsOptionGroup<T> {
4172
4296
  }
4297
+ type AutocompleteItem<T = unknown> = DsOptionItem<T>;
4173
4298
 
4174
4299
  declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<T | readonly T[] | null> implements OnDestroy {
4175
4300
  /** Segment of a ds-field-group: the group owns the border, radius and focus
@@ -4181,10 +4306,8 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4181
4306
  /** Public panel tokens forwarded onto the portaled overlay pane on open so
4182
4307
  * a consumer's `ds-autocomplete { --ds-autocomplete-panel-*: … }` reaches it. */
4183
4308
  private readonly panelTokens;
4184
- /** Flat option list — ignored when `optionGroups` is set. */
4185
- readonly options: _angular_core.InputSignal<readonly AutocompleteOption<T>[]>;
4186
- /** Options grouped under labelled sections, rendered instead of `options`. */
4187
- 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>[]>;
4188
4311
  /** Selected value, or an array of values when `multiple`. */
4189
4312
  readonly value: _angular_core.ModelSignal<T | readonly T[] | null>;
4190
4313
  /** Allows selecting more than one option, shown as removable tags. */
@@ -4207,7 +4330,12 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4207
4330
  readonly size: _angular_core.InputSignal<DsSize | null>;
4208
4331
  readonly sizeResolved: _angular_core.Signal<DsSize>;
4209
4332
  /** Trigger width — `fill` stretches to the container, `content` hugs the value. */
4210
- 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>;
4211
4339
  /** Placeholder shown in the input when empty. */
4212
4340
  readonly placeholder: _angular_core.InputSignal<string>;
4213
4341
  /** Disables the trigger and blocks all interaction. */
@@ -4217,6 +4345,12 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4217
4345
  readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
4218
4346
  /** Shows a "Create «text»" row when the typed text matches no option. */
4219
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>;
4220
4354
  /** Accessible name for the input. */
4221
4355
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
4222
4356
  /** Fires with the typed text when the user picks the create-new option. */
@@ -4227,6 +4361,11 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4227
4361
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
4228
4362
  protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
4229
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>;
4230
4369
  protected readonly query: _angular_core.WritableSignal<string>;
4231
4370
  protected readonly isOpen: _angular_core.WritableSignal<boolean>;
4232
4371
  protected readonly activeIndex: _angular_core.WritableSignal<number>;
@@ -4237,17 +4376,20 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4237
4376
  private overlayRef;
4238
4377
  protected readonly uid: string;
4239
4378
  protected readonly listboxId: string;
4379
+ protected readonly labelId: string;
4240
4380
  protected optionId(index: number): string;
4241
4381
  protected readonly activeDescendant: _angular_core.Signal<string | null>;
4242
- /** All options flattened from either optionGroups or options. */
4243
4382
  protected readonly allOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
4383
+ protected readonly filteredItems: _angular_core.Signal<AutocompleteItem<T>[]>;
4244
4384
  protected readonly filteredOptions: _angular_core.Signal<readonly AutocompleteOption<T>[]>;
4245
- /** Filtered groups for grouped rendering — groups with no matching options are hidden. */
4246
- protected readonly filteredGroups: _angular_core.Signal<AutocompleteOptionGroup<T>[]>;
4385
+ protected isGroup(item: AutocompleteItem<T>): item is AutocompleteOptionGroup<T>;
4247
4386
  /** Whether to show the "Create «text»" row at the bottom of the panel. */
4248
4387
  protected readonly showCreateRow: _angular_core.Signal<boolean>;
4249
4388
  /** Flat list of visible options used for keyboard navigation index. */
4250
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>;
4251
4393
  protected readonly selectedTags: _angular_core.Signal<AutocompleteOption<T>[]>;
4252
4394
  private readonly chipsMode;
4253
4395
  private readonly showsEveryChip;
@@ -4266,7 +4408,10 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4266
4408
  * list it reads would silently make it remove the last VISIBLE one instead. */
4267
4409
  protected readonly visibleTags: _angular_core.Signal<AutocompleteOption<T>[]>;
4268
4410
  protected readonly overflowCount: _angular_core.Signal<number>;
4411
+ protected readonly selectedOption: _angular_core.Signal<AutocompleteOption<T> | null>;
4269
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>;
4270
4415
  protected readonly placeholderText: _angular_core.Signal<string>;
4271
4416
  protected isSelected(option: AutocompleteOption<T>): boolean;
4272
4417
  protected optionClass(option: AutocompleteOption<T>): string;
@@ -4304,7 +4449,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4304
4449
  protected onCreateNew(): void;
4305
4450
  protected remove(target: T): void;
4306
4451
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent<any>, never>;
4307
- 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>;
4308
4453
  }
4309
4454
 
4310
4455
  type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
@@ -4717,6 +4862,10 @@ declare class ColorPickerComponent extends DsControlValueAccessor<string> implem
4717
4862
 
4718
4863
  interface MultiSelectOption extends DsOption<string> {
4719
4864
  }
4865
+ interface MultiSelectOptionGroup extends DsOptionGroup<string> {
4866
+ }
4867
+ type MultiSelectItem = DsOptionItem<string>;
4868
+ type MultiSelectWidth = DsControlWidth;
4720
4869
 
4721
4870
  declare class MultiSelectComponent extends DsControlValueAccessor<string[]> implements OnDestroy {
4722
4871
  private readonly overlay;
@@ -4727,12 +4876,20 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4727
4876
  private readonly panelTokens;
4728
4877
  /** Selected values, two-way bound. */
4729
4878
  readonly value: _angular_core.ModelSignal<string[]>;
4730
- /** Options shown in the panel. */
4731
- 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[]>;
4732
4881
  /** Placeholder shown in the trigger when nothing is selected. */
4733
4882
  readonly placeholder: _angular_core.InputSignal<string>;
4734
4883
  /** Placeholder for the in-panel filter input. */
4735
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>;
4736
4893
  /** How the chips collapse when they outgrow one line. `"fit"` (the default)
4737
4894
  * measures and shows as many as the trigger is wide, the rest behind "+N more".
4738
4895
  * A NUMBER is a CEILING, not a promise: the row still measures, so you get at
@@ -4750,10 +4907,36 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4750
4907
  readonly success: _angular_core.InputSignalWithTransform<string, string | null | undefined>;
4751
4908
  /** Accessible name for the trigger — falls back to `placeholder`. */
4752
4909
  readonly ariaLabel: _angular_core.InputSignal<string | null>;
4753
- /** Shows a "Select all" row that toggles every filter-matching, enabled option. */
4754
- 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>;
4755
4937
  protected readonly uid: string;
4756
4938
  protected readonly listboxId: string;
4939
+ protected readonly labelId: string;
4757
4940
  protected optionId(index: number): string;
4758
4941
  protected readonly trigger: _angular_core.Signal<ElementRef<HTMLElement>>;
4759
4942
  protected readonly searchInput: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
@@ -4766,6 +4949,11 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4766
4949
  private focusTimer;
4767
4950
  ngOnDestroy(): void;
4768
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[]>;
4769
4957
  protected readonly selectedOptions: _angular_core.Signal<MultiSelectOption[]>;
4770
4958
  private readonly chipsMode;
4771
4959
  private readonly showsEveryChip;
@@ -4784,7 +4972,13 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4784
4972
  private readonly chipsThatFit;
4785
4973
  protected readonly visibleChips: _angular_core.Signal<MultiSelectOption[]>;
4786
4974
  protected readonly overflowCount: _angular_core.Signal<number>;
4975
+ protected readonly filteredItems: _angular_core.Signal<MultiSelectItem[]>;
4787
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;
4788
4982
  protected readonly activeDescendant: _angular_core.Signal<string | null>;
4789
4983
  protected readonly resolvedAriaLabel: _angular_core.Signal<string>;
4790
4984
  protected readonly hintId: _angular_core.Signal<string | null>;
@@ -4795,11 +4989,18 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4795
4989
  private enabledFiltered;
4796
4990
  protected readonly allFilteredSelected: _angular_core.Signal<boolean>;
4797
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;
4798
4998
  protected toggleSelectAll(): void;
4799
4999
  protected isSelected(value: string): boolean;
4800
5000
  protected toggleValue(option: MultiSelectOption): void;
4801
5001
  protected removeValue(value: string): void;
4802
5002
  protected onFilter(event: Event): void;
5003
+ private firstEnabledIndex;
4803
5004
  protected onTriggerKeydown(event: KeyboardEvent): void;
4804
5005
  protected onSearchKeydown(event: KeyboardEvent): void;
4805
5006
  protected openPanel(): void;
@@ -4807,7 +5008,7 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4807
5008
  protected close(cause?: DsOverlayCloseCause): void;
4808
5009
  private moveActive;
4809
5010
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
4810
- 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>;
4811
5012
  }
4812
5013
 
4813
5014
  declare class SkeletonComponent {
@@ -4857,6 +5058,7 @@ declare class CheckboxComponent extends DsBooleanControlValueAccessor {
4857
5058
  private readonly fieldMessage;
4858
5059
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
4859
5060
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
5061
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
4860
5062
  protected readonly fieldClass: _angular_core.Signal<string>;
4861
5063
  protected onCheckedChange(event: Event): void;
4862
5064
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<CheckboxComponent, never>;
@@ -4949,6 +5151,7 @@ declare class RadioGroupComponent extends DsControlValueAccessor<unknown> implem
4949
5151
  private readonly fieldMessage;
4950
5152
  protected readonly message: _angular_core.Signal<DsFieldMessage>;
4951
5153
  protected readonly invalidResolved: _angular_core.Signal<boolean>;
5154
+ protected readonly controlState: _angular_core.Signal<FieldMessageState | null>;
4952
5155
  private readonly radios;
4953
5156
  private get enabledRadios();
4954
5157
  isTabbable(radio: RadioGroupChild): boolean;
@@ -4992,6 +5195,98 @@ declare class SwitchComponent extends DsBooleanControlValueAccessor {
4992
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>;
4993
5196
  }
4994
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
+
4995
5290
  /**
4996
5291
  * Focuses the field's inner `input`/`textarea` when the click lands on the
4997
5292
  * frame chrome — padding, a leading/trailing icon, an addon slot — instead of
@@ -5009,5 +5304,5 @@ declare class FieldClickFocusDirective {
5009
5304
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
5010
5305
  }
5011
5306
 
5012
- 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 };
5013
- 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 };