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

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.
@@ -317,6 +317,10 @@ interface DsOption<T = string> {
317
317
  value: T;
318
318
  label: string;
319
319
  disabled?: boolean;
320
+ /** Why this option cannot be picked. Reaches the row as `aria-describedby`, so a
321
+ * reader hears the reason instead of only meeting a dead row. Ignored unless
322
+ * `disabled` is set. */
323
+ disabledReason?: string;
320
324
  /** Rendered before the label at 16px by every picker's option row. */
321
325
  icon?: IconName;
322
326
  }
@@ -1911,6 +1915,19 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1911
1915
  readonly label: _angular_core.InputSignal<string>;
1912
1916
  /** Disables the trigger and blocks all interaction. */
1913
1917
  readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
1918
+ /** Options are still being fetched. The panel shows a spinner instead of the
1919
+ * empty row — which would otherwise claim there are no matches — and the list
1920
+ * reports `aria-busy`. */
1921
+ readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
1922
+ /** The panel opened. The moment to fetch options for a picker whose list is
1923
+ * loaded on demand. */
1924
+ readonly opened: _angular_core.OutputEmitterRef<void>;
1925
+ /** The panel closed, for any reason — a pick, Escape, an outside click, a scroll. */
1926
+ readonly closed: _angular_core.OutputEmitterRef<void>;
1927
+ /** Scrolls the keyboard cursor's row into view. On by default: a list longer
1928
+ * than the panel otherwise walks the cursor out of sight. Set `false` only if
1929
+ * you are driving the scroll position yourself. */
1930
+ readonly scrollActiveIntoView: _angular_core.InputSignalWithTransform<boolean, unknown>;
1914
1931
  /** Prevents opening the dropdown while still allowing focus. */
1915
1932
  readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
1916
1933
  /**
@@ -1934,6 +1951,9 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1934
1951
  readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
1935
1952
  protected readonly optionTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
1936
1953
  protected readonly pickerTrigger: _angular_core.Signal<TemplateRef<any> | undefined>;
1954
+ protected readonly panelHeaderTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
1955
+ protected readonly panelFooterTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
1956
+ protected readonly groupLabelTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
1937
1957
  protected readonly emptyTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
1938
1958
  protected readonly uid: string;
1939
1959
  protected readonly labelId: string;
@@ -1972,15 +1992,35 @@ declare class SelectComponent extends DsControlValueAccessor<string> implements
1972
1992
  ngOnDestroy(): void;
1973
1993
  protected pick(option: SelectOption, groupDisabled?: boolean): void;
1974
1994
  protected clearValue(event: MouseEvent): void;
1995
+ /**
1996
+ * Empties the selection from outside — a "reset filters" button, a form the app
1997
+ * clears itself. `ds-autocomplete` has had this; the other two had only the
1998
+ * in-trigger button, so an app with its own reset had to write the empty value
1999
+ * by hand and guess what "empty" is for this control.
2000
+ *
2001
+ * Deliberately does NOT move focus: the caller may be navigating away, and
2002
+ * stealing focus back into a field they just left is worse than leaving it.
2003
+ */
2004
+ clear(): void;
1975
2005
  protected isSelected(option: SelectOption): boolean;
1976
2006
  protected isOptionDisabled(option: SelectOption, groupDisabled?: boolean): boolean;
1977
2007
  protected onTriggerKeydown(event: KeyboardEvent): void;
2008
+ private pickActive;
1978
2009
  protected isActive(index: number): boolean;
2010
+ private readonly typeAhead;
2011
+ private handleTypeAhead;
2012
+ protected readonly cursorFromKeyboard: _angular_core.WritableSignal<boolean>;
2013
+ private cursorList;
2014
+ /** How far PageUp and PageDown move. Ten rows is the native `<select>` step and
2015
+ * the APG listbox example's — a fixed number rather than a measured screenful,
2016
+ * so the jump is the same wherever the panel happens to be clipped. */
2017
+ private static readonly pageStep;
1979
2018
  private moveActive;
1980
- private firstEnabledIndex;
2019
+ private setOpen;
1981
2020
  private lastEnabledIndex;
2021
+ private firstEnabledIndex;
1982
2022
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
1983
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["optionTemplate", "pickerTrigger", "emptyTemplate"], never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
2023
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "ds-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "scrollActiveIntoView": { "alias": "scrollActiveIntoView"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "opened": "opened"; "closed": "closed"; }, ["optionTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate"], never, true, [{ directive: typeof DsStaticPreview; inputs: { "staticPreview": "staticPreview"; }; outputs: {}; }]>;
1984
2024
  }
1985
2025
 
1986
2026
  /**
@@ -2056,18 +2096,6 @@ declare class HeaderFilterDirective {
2056
2096
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<HeaderFilterDirective, "ng-template[dsHeaderFilter]", never, { "dsHeaderFilter": { "alias": "dsHeaderFilter"; "required": true; "isSignal": true; }; "active": { "alias": "active"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
2057
2097
  }
2058
2098
 
2059
- /**
2060
- * Who sorts a `ds-table`.
2061
- *
2062
- * - `'server'` (default) — the table only emits `sortChange`; the host reorders.
2063
- * - `'client'` — the table reorders `data()` itself, for a table holding every row.
2064
- * - `'none'` — nothing sorts, and `sortable` columns render no affordance rather
2065
- * than a control that does nothing.
2066
- *
2067
- * Replaces the boolean `clientSort`, which could not express `'none'`: a column
2068
- * marked `sortable` on a table with no sorting drew a live-looking header that
2069
- * did nothing, and no type or dev check could catch it.
2070
- */
2071
2099
  /**
2072
2100
  * Who applies the header filters.
2073
2101
  *
@@ -2080,7 +2108,22 @@ declare class HeaderFilterDirective {
2080
2108
  * control that does nothing.
2081
2109
  */
2082
2110
  type TableFilterMode = 'client' | 'server' | 'none';
2111
+ /**
2112
+ * Who sorts a `ds-table`.
2113
+ *
2114
+ * - `'server'` (default) — the table only emits `sortChange`; the host reorders.
2115
+ * - `'client'` — the table reorders `data()` itself, for a table holding every row.
2116
+ * - `'none'` — nothing sorts, and `sortable` columns render no affordance rather
2117
+ * than a control that does nothing.
2118
+ *
2119
+ * Replaces the boolean `clientSort`, which could not express `'none'`: a column
2120
+ * marked `sortable` on a table with no sorting drew a live-looking header that
2121
+ * did nothing, and no type or dev check could catch it.
2122
+ */
2083
2123
  type TableSortMode = 'client' | 'server' | 'none';
2124
+ /** `'single'` closes the open row when another is expanded; `'multiple'` (default)
2125
+ * leaves every expanded row open. */
2126
+ type TableExpandMode = 'multiple' | 'single';
2084
2127
 
2085
2128
  interface TableColumn<T = unknown> {
2086
2129
  key: string;
@@ -2450,6 +2493,23 @@ declare class TableComponent<T extends object> {
2450
2493
  readonly expandableRows: _angular_core.InputSignalWithTransform<boolean, unknown>;
2451
2494
  /** Two-way set of currently expanded row ids. */
2452
2495
  readonly expandedIds: _angular_core.ModelSignal<Set<string>>;
2496
+ /** `'single'` collapses the open row when another expander is clicked.
2497
+ * Enforced on interaction only: a set seeded with several ids is left alone
2498
+ * (and warned about in dev) rather than silently rewritten under the host. */
2499
+ readonly expandMode: _angular_core.InputSignal<TableExpandMode>;
2500
+ /** Renders an expand-all/collapse-all chevron in the expander column header,
2501
+ * page-scoped when paginating, like select-all. Suppressed under
2502
+ * `expandMode="single"`, which it would contradict. */
2503
+ readonly expandAllToggle: _angular_core.InputSignalWithTransform<boolean, unknown>;
2504
+ /** Fires with the row when an expander opens it — including each row opened
2505
+ * by expand-all, so a host lazy-loading panel content sees every one. */
2506
+ readonly rowExpanded: _angular_core.OutputEmitterRef<T>;
2507
+ /** Fires with the row when an expander closes it, the row auto-closed by
2508
+ * `expandMode="single"` included. It carries a row, so it cannot speak for an
2509
+ * id whose row is no longer in `data()` — under server-side paging that id is
2510
+ * cleared silently. `expandedIds` is the complete signal; this one is the
2511
+ * convenient one. */
2512
+ readonly rowCollapsed: _angular_core.OutputEmitterRef<T>;
2453
2513
  /** Template rendered inside an expanded row's panel.
2454
2514
  * Context: `$implicit` = row, `row` = row. */
2455
2515
  readonly rowExpandTemplate: _angular_core.InputSignal<TemplateRef<{
@@ -2522,6 +2582,7 @@ declare class TableComponent<T extends object> {
2522
2582
  };
2523
2583
  protected clearColumnFilter(): void;
2524
2584
  private readonly injector;
2585
+ private readonly destroyRef;
2525
2586
  private readonly editInput;
2526
2587
  protected readonly editingCell: _angular_core.WritableSignal<{
2527
2588
  rowId: string;
@@ -2565,9 +2626,38 @@ declare class TableComponent<T extends object> {
2565
2626
  private lockMeasuredWidths;
2566
2627
  protected onResizeMove(event: PointerEvent): void;
2567
2628
  protected onResizeEnd(): void;
2568
- /** Current rendered width, for the keyboard path and the handle's
2569
- * `aria-valuenow`. Falls back to the DOM when the column was auto-sized and
2570
- * has neither an override nor a declared width. */
2629
+ private readonly resizeFocus;
2630
+ /**
2631
+ * The widest a single column may be dragged: the scroll viewport.
2632
+ *
2633
+ * A column wider than the viewport can never be seen whole, and long text has
2634
+ * its own affordance here — `truncate` clips it and the clip popover shows the
2635
+ * rest — so nothing is lost by stopping at the edge. The ceiling exists at all
2636
+ * because `aria-valuemax` has to be TRUE: a focusable `role="separator"` is a
2637
+ * range widget, and announcing a bound that neither resize path applies is
2638
+ * worse than announcing none.
2639
+ */
2640
+ private columnWidthCeiling;
2641
+ private clampColumnWidth;
2642
+ protected onResizeFocus(col: TableColumn<T>, event: FocusEvent): void;
2643
+ protected onResizeBlur(): void;
2644
+ /**
2645
+ * The separator's range, and only while it holds focus — that is when a range
2646
+ * widget is announced, and an auto-sized column has no width to report until
2647
+ * something measures one. Measuring on every change detection to fill an
2648
+ * attribute nothing is reading would force layout once per resizable column.
2649
+ *
2650
+ * `now` prefers `columnWidth`, which the first arrow key makes known and keeps
2651
+ * live; the focus measurement only covers the moment before that.
2652
+ */
2653
+ protected resizeRange(col: TableColumn<T>): {
2654
+ now: number;
2655
+ min: number;
2656
+ max: number;
2657
+ } | null;
2658
+ /** Current rendered width for the keyboard resize path. Falls back to the DOM
2659
+ * when the column was auto-sized and has neither an override nor a declared
2660
+ * width. */
2571
2661
  protected resolvedColumnWidth(col: TableColumn<T>, from?: HTMLElement): number;
2572
2662
  /**
2573
2663
  * Keyboard resizing. A drag handle that only answers to a pointer makes a
@@ -2576,6 +2666,19 @@ declare class TableComponent<T extends object> {
2576
2666
  * ones and Home to hand the column back to automatic sizing.
2577
2667
  */
2578
2668
  protected onResizeKey(col: TableColumn<T>, event: KeyboardEvent): void;
2669
+ /**
2670
+ * One column-width step, from wherever it was asked for: the handle's own
2671
+ * keyboard, or the width controls in the column panel.
2672
+ *
2673
+ * `'auto'` hands the column back to automatic sizing. The header cell is
2674
+ * passed when the caller has it — the panel does not, so it is looked up by
2675
+ * `data-col-key`, and the measurement matters: stepping an auto-sized column
2676
+ * has to start from what it currently RENDERS, not from the minimum.
2677
+ */
2678
+ private stepColumnWidth;
2679
+ private headerCellFor;
2680
+ protected onColumnWidthStep(col: TableColumn<T>, delta: number | 'auto'): void;
2681
+ protected readonly resizeStep = 16;
2579
2682
  /** Client-side filter over the full data set — combines the `filterQuery`
2580
2683
  * substring search with any per-column set filters. Sorting and pagination
2581
2684
  * run on the filtered rows. */
@@ -2584,7 +2687,8 @@ declare class TableComponent<T extends object> {
2584
2687
  protected readonly sortedData: _angular_core.Signal<readonly T[]>;
2585
2688
  /** Current page's slice of the sorted rows, when paginating. */
2586
2689
  protected readonly pagedData: _angular_core.Signal<readonly T[]>;
2587
- /** Rows actually rendered: paged when paginating, else sorted/raw data. */
2690
+ /** The full display set — paged when paginating, else sorted/raw data.
2691
+ * Virtual mode windows this further; `rowSlots` is what the loop walks. */
2588
2692
  protected readonly displayData: _angular_core.Signal<readonly T[]>;
2589
2693
  /**
2590
2694
  * The single live-region line. Loading wins while it lasts — a sort
@@ -2597,6 +2701,9 @@ declare class TableComponent<T extends object> {
2597
2701
  * unsorted first render is silent; only real changes speak.
2598
2702
  */
2599
2703
  protected readonly statusMessage: _angular_core.Signal<string>;
2704
+ /** Only from two rows up: a single expander announces itself through its own
2705
+ * `aria-expanded`, and repeating that here would say everything twice. */
2706
+ private readonly expansionMessage;
2600
2707
  private readonly sortMessage;
2601
2708
  private readonly rangeMessage;
2602
2709
  /** Virtual mode needs a bounded scroller to window against. */
@@ -2615,8 +2722,6 @@ declare class TableComponent<T extends object> {
2615
2722
  padTop: number;
2616
2723
  padBottom: number;
2617
2724
  } | null>;
2618
- /** The rows the template actually renders. */
2619
- protected readonly windowData: _angular_core.Signal<readonly T[]>;
2620
2725
  /**
2621
2726
  * What the row loop walks: each slot carries its ABSOLUTE index, and a `null`
2622
2727
  * row is a gap the host has not filled yet.
@@ -2638,14 +2743,23 @@ declare class TableComponent<T extends object> {
2638
2743
  protected readonly someSelected: _angular_core.Signal<boolean>;
2639
2744
  /** Select-all is page-scoped only when paginating. */
2640
2745
  protected readonly selectAllLabel: _angular_core.Signal<"Select all rows on this page" | "Select all rows">;
2746
+ protected readonly allExpanded: _angular_core.Signal<boolean>;
2747
+ protected readonly expandAllVisible: _angular_core.Signal<boolean>;
2748
+ protected readonly expandAllLabel: _angular_core.Signal<string>;
2641
2749
  protected readonly skeletonArray: _angular_core.Signal<any[]>;
2642
- /** Total colspan for the expanded-row panel: data cols + optional select/expand/actions cols. */
2750
+ /** Colspan of a full-width row (expansion panel, empty state): data cols +
2751
+ * optional select/expand/actions cols. */
2643
2752
  protected readonly expandedColspan: _angular_core.Signal<number>;
2644
2753
  protected readonly hasRowActions: _angular_core.Signal<boolean>;
2645
2754
  /** Row whose kebab menu is open — drives the per-row `disabled` predicates. */
2646
2755
  protected readonly menuRow: _angular_core.WritableSignal<T | null>;
2647
2756
  private readonly rowMenuPopover;
2648
2757
  private readonly columnPickerPopover;
2758
+ protected readonly columnSheetOpen: _angular_core.WritableSignal<boolean>;
2759
+ private readonly coarsePointerState;
2760
+ /** Whether the column panel opens as a sheet and the drag handle stands down.
2761
+ * Keyed on the pointer, not the viewport — see `_table.scss`'s matching query. */
2762
+ protected readonly coarsePointer: _angular_core.Signal<boolean>;
2649
2763
  protected readonly columnPickerOpened: _angular_core.Signal<boolean>;
2650
2764
  protected onColumnPickerClick(event: Event): void;
2651
2765
  protected readonly hasTruncate: _angular_core.Signal<boolean>;
@@ -2687,6 +2801,7 @@ declare class TableComponent<T extends object> {
2687
2801
  protected onRowAction(action: TableRowAction<T>): void;
2688
2802
  protected isExpanded(row: T): boolean;
2689
2803
  protected onToggleExpand(row: T, event: Event): void;
2804
+ protected onToggleExpandAll(): void;
2690
2805
  protected isSelected(row: T): boolean;
2691
2806
  protected onToggleAll(event: Event): void;
2692
2807
  protected onToggleRow(row: T, event: Event): void;
@@ -2696,12 +2811,12 @@ declare class TableComponent<T extends object> {
2696
2811
  protected onRowKey(row: T, event: Event): void;
2697
2812
  /** Accessible name for an interactive row, taken from the first visible column. */
2698
2813
  protected rowAriaLabel(row: T): string;
2699
- /** `aria-sort` value for a header: only meaningful on sortable columns. */
2700
2814
  /** Row identity — the `rowId` accessor when given, else `row.id`. Public so a
2701
2815
  * host reading `selectedIds`/`expandedIds` can compute the same keys. */
2702
2816
  rowKey(row: T): string;
2703
2817
  /** Whether this column's header is an actual sort control right now. */
2704
2818
  protected sortableCol(col: TableColumn<T>): boolean;
2819
+ /** `aria-sort` value for a header: only meaningful on sortable columns. */
2705
2820
  protected ariaSort(col: TableColumn<T>): 'ascending' | 'descending' | 'none' | null;
2706
2821
  protected onSort(col: TableColumn<T>): void;
2707
2822
  protected headerClasses(col: TableColumn<T>): string;
@@ -2729,8 +2844,9 @@ declare class TableComponent<T extends object> {
2729
2844
  /** Deterministic per-cell width so skeleton rows look organic but stable
2730
2845
  * across re-renders. Mixes column key + row index into one of five widths. */
2731
2846
  protected skeletonWidth(col: TableColumn<T>, rowIndex: number): string;
2847
+ private watchPointer;
2732
2848
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<TableComponent<any>, never>;
2733
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "animateHeight": { "alias": "animateHeight"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDir": { "alias": "sortDir"; "required": false; "isSignal": true; }; "sortingOrder": { "alias": "sortingOrder"; "required": false; "isSignal": true; }; "sortAnnouncement": { "alias": "sortAnnouncement"; "required": false; "isSignal": true; }; "rangeAnnouncement": { "alias": "rangeAnnouncement"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "activeRowId": { "alias": "activeRowId"; "required": false; "isSignal": true; }; "filterQuery": { "alias": "filterQuery"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "hiddenKeys": { "alias": "hiddenKeys"; "required": false; "isSignal": true; }; "resizableColumns": { "alias": "resizableColumns"; "required": false; "isSignal": true; }; "columnWidths": { "alias": "columnWidths"; "required": false; "isSignal": true; }; "reorderableColumns": { "alias": "reorderableColumns"; "required": false; "isSignal": true; }; "columnOrder": { "alias": "columnOrder"; "required": false; "isSignal": true; }; "persistLayout": { "alias": "persistLayout"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "exportButton": { "alias": "exportButton"; "required": false; "isSignal": true; }; "exportFilename": { "alias": "exportFilename"; "required": false; "isSignal": true; }; "exportFetcher": { "alias": "exportFetcher"; "required": false; "isSignal": true; }; "stickyScrollbar": { "alias": "stickyScrollbar"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "sortMode": { "alias": "sortMode"; "required": false; "isSignal": true; }; "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "columnFilterOptions": { "alias": "columnFilterOptions"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualRowSize": { "alias": "virtualRowSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKeyChange": "sortKeyChange"; "sortDirChange": "sortDirChange"; "columnFilters": "columnFiltersChange"; "hiddenKeys": "hiddenKeysChange"; "columnWidths": "columnWidthsChange"; "columnOrder": "columnOrderChange"; "exportFailed": "exportFailed"; "pageSize": "pageSizeChange"; "page": "pageChange"; "lazyLoad": "lazyLoad"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; }, ["cellTemplateDirectives", "headerFilters"], ["[toolbar]", "[empty]", "[bulk-actions]"], true, never>;
2849
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<TableComponent<any>, "ds-table", never, { "data": { "alias": "data"; "required": true; "isSignal": true; }; "rowId": { "alias": "rowId"; "required": false; "isSignal": true; }; "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "maxHeight": { "alias": "maxHeight"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "zebra": { "alias": "zebra"; "required": false; "isSignal": true; }; "animateHeight": { "alias": "animateHeight"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "sortKey": { "alias": "sortKey"; "required": false; "isSignal": true; }; "sortDir": { "alias": "sortDir"; "required": false; "isSignal": true; }; "sortingOrder": { "alias": "sortingOrder"; "required": false; "isSignal": true; }; "sortAnnouncement": { "alias": "sortAnnouncement"; "required": false; "isSignal": true; }; "rangeAnnouncement": { "alias": "rangeAnnouncement"; "required": false; "isSignal": true; }; "skeletonRows": { "alias": "skeletonRows"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "rowInteractive": { "alias": "rowInteractive"; "required": false; "isSignal": true; }; "activeRowId": { "alias": "activeRowId"; "required": false; "isSignal": true; }; "filterQuery": { "alias": "filterQuery"; "required": false; "isSignal": true; }; "columnFilters": { "alias": "columnFilters"; "required": false; "isSignal": true; }; "hiddenKeys": { "alias": "hiddenKeys"; "required": false; "isSignal": true; }; "resizableColumns": { "alias": "resizableColumns"; "required": false; "isSignal": true; }; "columnWidths": { "alias": "columnWidths"; "required": false; "isSignal": true; }; "reorderableColumns": { "alias": "reorderableColumns"; "required": false; "isSignal": true; }; "columnOrder": { "alias": "columnOrder"; "required": false; "isSignal": true; }; "persistLayout": { "alias": "persistLayout"; "required": false; "isSignal": true; }; "storageKey": { "alias": "storageKey"; "required": false; "isSignal": true; }; "exportButton": { "alias": "exportButton"; "required": false; "isSignal": true; }; "exportFilename": { "alias": "exportFilename"; "required": false; "isSignal": true; }; "exportFetcher": { "alias": "exportFetcher"; "required": false; "isSignal": true; }; "stickyScrollbar": { "alias": "stickyScrollbar"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showPageSize": { "alias": "showPageSize"; "required": false; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "total": { "alias": "total"; "required": false; "isSignal": true; }; "scrollToTopOnPageChange": { "alias": "scrollToTopOnPageChange"; "required": false; "isSignal": true; }; "sortMode": { "alias": "sortMode"; "required": false; "isSignal": true; }; "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "columnFilterOptions": { "alias": "columnFilterOptions"; "required": false; "isSignal": true; }; "stickyFirstColumn": { "alias": "stickyFirstColumn"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualRowSize": { "alias": "virtualRowSize"; "required": false; "isSignal": true; }; "lazy": { "alias": "lazy"; "required": false; "isSignal": true; }; "rowActions": { "alias": "rowActions"; "required": false; "isSignal": true; }; "cellTemplateMap": { "alias": "cellTemplateMap"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "expandableRows": { "alias": "expandableRows"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "expandMode": { "alias": "expandMode"; "required": false; "isSignal": true; }; "expandAllToggle": { "alias": "expandAllToggle"; "required": false; "isSignal": true; }; "rowExpandTemplate": { "alias": "rowExpandTemplate"; "required": false; "isSignal": true; }; }, { "selectedIds": "selectedIdsChange"; "sortKeyChange": "sortKeyChange"; "sortDirChange": "sortDirChange"; "columnFilters": "columnFiltersChange"; "hiddenKeys": "hiddenKeysChange"; "columnWidths": "columnWidthsChange"; "columnOrder": "columnOrderChange"; "exportFailed": "exportFailed"; "pageSize": "pageSizeChange"; "page": "pageChange"; "lazyLoad": "lazyLoad"; "rowClicked": "rowClicked"; "sortChange": "sortChange"; "rowActionSelected": "rowActionSelected"; "cellEdited": "cellEdited"; "expandedIds": "expandedIdsChange"; "rowExpanded": "rowExpanded"; "rowCollapsed": "rowCollapsed"; }, ["cellTemplateDirectives", "headerFilters"], ["[toolbar]", "[empty]", "[bulk-actions]"], true, never>;
2734
2850
  }
2735
2851
 
2736
2852
  declare class PaginationComponent {
@@ -4062,6 +4178,10 @@ interface ToastEntry {
4062
4178
  readonly variant: ToastVariant;
4063
4179
  readonly dismissible: boolean;
4064
4180
  readonly action?: ToastAction;
4181
+ /** Auto-dismiss delay, counted from the moment the toast becomes VISIBLE — a
4182
+ * queued toast must not expire while it is still waiting behind the cap.
4183
+ * 0 = indefinite. */
4184
+ readonly durationMs: number;
4065
4185
  }
4066
4186
  interface ToastPromiseMessages {
4067
4187
  readonly loading: string;
@@ -4101,7 +4221,16 @@ declare class ToastRegionComponent {
4101
4221
  protected readonly visibleEntries: _angular_core.WritableSignal<readonly ToastEntry[]>;
4102
4222
  protected readonly leaving: _angular_core.WritableSignal<ReadonlySet<number>>;
4103
4223
  private readonly pendingQueue;
4224
+ private readonly timers;
4225
+ private readonly position;
4226
+ /** Newest goes NEAREST the anchor, so the toast that just fired appears where the
4227
+ * stack is pinned rather than at the far end of a list the reader has to hunt
4228
+ * down. DOM order is the visual order, so this also keeps the reading order. */
4229
+ private readonly newestFirst;
4104
4230
  add(entry: ToastEntry): void;
4231
+ private show;
4232
+ private startCountdown;
4233
+ private clearCountdown;
4105
4234
  /** Replace fields of an already-visible or queued toast in place. */
4106
4235
  update(id: number, patch: Partial<Pick<ToastEntry, 'body' | 'title' | 'variant' | 'dismissible' | 'action'>>): void;
4107
4236
  remove(id: number): void;
@@ -4347,6 +4476,51 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4347
4476
  readonly allowCreate: _angular_core.InputSignalWithTransform<boolean, unknown>;
4348
4477
  /** Field label above the control — the same meaning it has on the other two pickers. */
4349
4478
  readonly label: _angular_core.InputSignal<string>;
4479
+ /** How two values are decided to be the same one. The default is `===`, which
4480
+ * is reference identity — so with object values a re-fetch that returns equal
4481
+ * data as NEW objects loses the selection. Pass a comparator keyed on whatever
4482
+ * identifies the value: `(a, b) => a?.id === b?.id`. */
4483
+ readonly compareWith: _angular_core.InputSignal<(a: T | null, b: T | null) => boolean>;
4484
+ /** Native `name` attribute forwarded to the trigger. */
4485
+ readonly name: _angular_core.InputSignal<string | null>;
4486
+ /** Prevents opening the panel while still allowing focus. */
4487
+ readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
4488
+ /**
4489
+ * The contract spelling of `readOnly`, a second input because signal forms binds
4490
+ * by NAME — a `readonly()` rule was reaching nothing before this existed.
4491
+ */
4492
+ readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
4493
+ /** Shows a clear affordance once there is something to clear. */
4494
+ readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
4495
+ /** Placeholder while the field is being typed in, when a value is already
4496
+ * settled — `placeholder` is the empty-field caption and cannot be both.
4497
+ * Empty (the default) keeps `placeholder` doing both jobs, as before. */
4498
+ readonly searchPlaceholder: _angular_core.InputSignal<string>;
4499
+ /** How the typed query narrows the list.
4500
+ *
4501
+ * The default matches a case-insensitive substring of `label`. Pass a predicate
4502
+ * to match on anything else — a second field, ignoring diacritics, a fuzzy score.
4503
+ * Pass `'none'` when the list arrives already filtered, which is what a
4504
+ * server-side search needs: the query is reported through `filterChange` and
4505
+ * every option given is rendered.
4506
+ */
4507
+ readonly filterWith: _angular_core.InputSignal<"none" | ((option: AutocompleteOption<T>, query: string) => boolean)>;
4508
+ /** The query the user typed, on every change. The input for a server-side search;
4509
+ * pair it with `filterWith="none"` so the list is not narrowed twice. */
4510
+ readonly filterChange: _angular_core.OutputEmitterRef<string>;
4511
+ /** Options are still being fetched. The panel shows a spinner instead of the
4512
+ * empty row — which would otherwise claim there are no matches — and the list
4513
+ * reports `aria-busy`. */
4514
+ readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
4515
+ /** The panel opened. The moment to fetch options for a picker whose list is
4516
+ * loaded on demand. */
4517
+ readonly opened: _angular_core.OutputEmitterRef<void>;
4518
+ /** The panel closed, for any reason — a pick, Escape, an outside click, a scroll. */
4519
+ readonly closed: _angular_core.OutputEmitterRef<void>;
4520
+ /** Scrolls the keyboard cursor's row into view. On by default: a list longer
4521
+ * than the panel otherwise walks the cursor out of sight. Set `false` only if
4522
+ * you are driving the scroll position yourself. */
4523
+ readonly scrollActiveIntoView: _angular_core.InputSignalWithTransform<boolean, unknown>;
4350
4524
  /** Marks the field required: a `*` beside the label and `aria-required` on the input. */
4351
4525
  readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
4352
4526
  /** Marks the field optional in words, for a form where most fields are required. */
@@ -4364,6 +4538,9 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4364
4538
  protected readonly optionTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4365
4539
  protected readonly chipTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4366
4540
  protected readonly pickerTrigger: _angular_core.Signal<TemplateRef<any> | undefined>;
4541
+ protected readonly panelHeaderTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4542
+ protected readonly panelFooterTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4543
+ protected readonly groupLabelTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4367
4544
  protected readonly emptyTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4368
4545
  protected readonly createTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4369
4546
  protected readonly query: _angular_core.WritableSignal<string>;
@@ -4425,11 +4602,21 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4425
4602
  private nextEnabledIndex;
4426
4603
  /** Flat index of the given option within the visible (filtered) list. */
4427
4604
  protected flatIndexOf(option: AutocompleteOption<T>): number;
4605
+ constructor();
4606
+ private setOpen;
4607
+ protected readonly isReadOnly: _angular_core.Signal<boolean>;
4608
+ protected readonly cursorFromKeyboard: _angular_core.WritableSignal<boolean>;
4609
+ /** How far PageUp and PageDown move. Ten rows is the native `<select>` step and
4610
+ * the APG listbox example's — a fixed number rather than a measured screenful,
4611
+ * so the jump is the same wherever the panel happens to be clipped. */
4612
+ private static readonly pageStep;
4613
+ private cursorList;
4428
4614
  protected onTriggerClick(): void;
4429
4615
  protected togglePanel(event: MouseEvent): void;
4430
4616
  protected onKeydown(event: KeyboardEvent): void;
4431
4617
  protected openPanel(): void;
4432
4618
  protected close(cause?: DsOverlayCloseCause): void;
4619
+ protected clearValue(event: MouseEvent): void;
4433
4620
  /**
4434
4621
  * Empties the field — both the selected value and the text the user typed.
4435
4622
  *
@@ -4449,7 +4636,7 @@ declare class AutocompleteComponent<T = unknown> extends DsControlValueAccessor<
4449
4636
  protected onCreateNew(): void;
4450
4637
  protected remove(target: T): void;
4451
4638
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent<any>, never>;
4452
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showChevron": { "alias": "showChevron"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "valueOverflow": { "alias": "valueOverflow"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "create": "create"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "emptyTemplate", "createTemplate"], ["[dsAutocompletePrefix]", "[dsAutocompleteSuffix]"], true, never>;
4639
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent<any>, "ds-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "showChevron": { "alias": "showChevron"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "valueOverflow": { "alias": "valueOverflow"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "allowCreate": { "alias": "allowCreate"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "filterWith": { "alias": "filterWith"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "scrollActiveIntoView": { "alias": "scrollActiveIntoView"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "filterChange": "filterChange"; "opened": "opened"; "closed": "closed"; "create": "create"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate", "createTemplate"], ["[dsAutocompletePrefix]", "[dsAutocompleteSuffix]"], true, never>;
4453
4640
  }
4454
4641
 
4455
4642
  type DividerVariant = 'default' | 'strong' | 'vertical' | 'label';
@@ -4744,8 +4931,20 @@ declare class LoadingOverlayComponent {
4744
4931
  readonly spinnerSize: _angular_core.InputSignal<DsSize>;
4745
4932
  /** Offset the scrim top edge — useful when a sticky header should stay uncovered. */
4746
4933
  readonly insetTop: _angular_core.InputSignal<string>;
4934
+ /**
4935
+ * Whether the projected content goes `inert` while the scrim is up. On by
4936
+ * default, because a scrim that only stops the POINTER is the bug this exists
4937
+ * to prevent: focus walks straight under it, and a keyboard user activates a
4938
+ * control the mouse cannot even reach.
4939
+ *
4940
+ * Turn it off only when the scrim covers part of the content (`insetTop`), and
4941
+ * then mark the covered subtree `inert` yourself — a blanket flag would take
4942
+ * the uncovered part with it. `ds-table` does exactly that: the scrim starts
4943
+ * below the header, so sorting during a refresh stays possible.
4944
+ */
4945
+ readonly inertContent: _angular_core.InputSignalWithTransform<boolean, unknown>;
4747
4946
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<LoadingOverlayComponent, never>;
4748
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<LoadingOverlayComponent, "ds-loading-overlay", never, { "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "blur": { "alias": "blur"; "required": false; "isSignal": true; }; "spinnerSize": { "alias": "spinnerSize"; "required": false; "isSignal": true; }; "insetTop": { "alias": "insetTop"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
4947
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<LoadingOverlayComponent, "ds-loading-overlay", never, { "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "blur": { "alias": "blur"; "required": false; "isSignal": true; }; "spinnerSize": { "alias": "spinnerSize"; "required": false; "isSignal": true; }; "insetTop": { "alias": "insetTop"; "required": false; "isSignal": true; }; "inertContent": { "alias": "inertContent"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
4749
4948
  }
4750
4949
 
4751
4950
  interface TreeNode {
@@ -4890,6 +5089,42 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4890
5089
  * Enter, Escape and `aria-activedescendant` are the filter input's today. */
4891
5090
  readonly searchable: _angular_core.InputSignalWithTransform<number | boolean | null, unknown>;
4892
5091
  readonly searchableResolved: _angular_core.Signal<number | boolean>;
5092
+ /** Native `name` attribute forwarded to the trigger. */
5093
+ readonly name: _angular_core.InputSignal<string | null>;
5094
+ /** Prevents opening the panel while still allowing focus. */
5095
+ readonly readOnly: _angular_core.InputSignalWithTransform<boolean, unknown>;
5096
+ /**
5097
+ * The contract spelling of `readOnly`, a second input because signal forms binds
5098
+ * by NAME — a `readonly()` rule was reaching nothing before this existed.
5099
+ */
5100
+ readonly readonlyBinding: _angular_core.InputSignalWithTransform<boolean, unknown>;
5101
+ /** Shows a clear affordance once there is something to clear. */
5102
+ readonly clearable: _angular_core.InputSignalWithTransform<boolean, unknown>;
5103
+ /** How the typed query narrows the list.
5104
+ *
5105
+ * The default matches a case-insensitive substring of `label`. Pass a predicate
5106
+ * to match on anything else — a second field, ignoring diacritics, a fuzzy score.
5107
+ * Pass `'none'` when the list arrives already filtered, which is what a
5108
+ * server-side search needs: the query is reported through `filterChange` and
5109
+ * every option given is rendered.
5110
+ */
5111
+ readonly filterWith: _angular_core.InputSignal<"none" | ((option: MultiSelectOption, query: string) => boolean)>;
5112
+ /** The query the user typed, on every change. The input for a server-side search;
5113
+ * pair it with `filterWith="none"` so the list is not narrowed twice. */
5114
+ readonly filterChange: _angular_core.OutputEmitterRef<string>;
5115
+ /** Options are still being fetched. The panel shows a spinner instead of the
5116
+ * empty row — which would otherwise claim there are no matches — and the list
5117
+ * reports `aria-busy`. */
5118
+ readonly loading: _angular_core.InputSignalWithTransform<boolean, unknown>;
5119
+ /** The panel opened. The moment to fetch options for a picker whose list is
5120
+ * loaded on demand. */
5121
+ readonly opened: _angular_core.OutputEmitterRef<void>;
5122
+ /** The panel closed, for any reason — a pick, Escape, an outside click, a scroll. */
5123
+ readonly closed: _angular_core.OutputEmitterRef<void>;
5124
+ /** Scrolls the keyboard cursor's row into view. On by default: a list longer
5125
+ * than the panel otherwise walks the cursor out of sight. Set `false` only if
5126
+ * you are driving the scroll position yourself. */
5127
+ readonly scrollActiveIntoView: _angular_core.InputSignalWithTransform<boolean, unknown>;
4893
5128
  /** How the chips collapse when they outgrow one line. `"fit"` (the default)
4894
5129
  * measures and shows as many as the trigger is wide, the rest behind "+N more".
4895
5130
  * A NUMBER is a CEILING, not a promise: the row still measures, so you get at
@@ -4933,6 +5168,9 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4933
5168
  protected readonly optionTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4934
5169
  protected readonly chipTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4935
5170
  protected readonly pickerTrigger: _angular_core.Signal<TemplateRef<any> | undefined>;
5171
+ protected readonly panelHeaderTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
5172
+ protected readonly panelFooterTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
5173
+ protected readonly groupLabelTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4936
5174
  protected readonly emptyTemplate: _angular_core.Signal<TemplateRef<any> | undefined>;
4937
5175
  protected readonly uid: string;
4938
5176
  protected readonly listboxId: string;
@@ -4998,17 +5236,38 @@ declare class MultiSelectComponent extends DsControlValueAccessor<string[]> impl
4998
5236
  protected toggleSelectAll(): void;
4999
5237
  protected isSelected(value: string): boolean;
5000
5238
  protected toggleValue(option: MultiSelectOption): void;
5239
+ protected clearValue(event: MouseEvent): void;
5240
+ /**
5241
+ * Empties the selection from outside — a "reset filters" button, a form the app
5242
+ * clears itself. `ds-autocomplete` has had this; the other two had only the
5243
+ * in-trigger button.
5244
+ *
5245
+ * Deliberately does NOT move focus: the caller may be navigating away, and
5246
+ * stealing focus back into a field they just left is worse than leaving it.
5247
+ */
5248
+ clear(): void;
5001
5249
  protected removeValue(value: string): void;
5250
+ constructor();
5002
5251
  protected onFilter(event: Event): void;
5252
+ private setOpen;
5253
+ protected readonly isReadOnly: _angular_core.Signal<boolean>;
5254
+ private readonly typeAhead;
5255
+ private handleTypeAhead;
5256
+ protected readonly cursorFromKeyboard: _angular_core.WritableSignal<boolean>;
5257
+ private cursorList;
5003
5258
  private firstEnabledIndex;
5004
5259
  protected onTriggerKeydown(event: KeyboardEvent): void;
5005
5260
  protected onSearchKeydown(event: KeyboardEvent): void;
5006
5261
  protected openPanel(): void;
5007
5262
  protected onTriggerClick(): void;
5008
5263
  protected close(cause?: DsOverlayCloseCause): void;
5264
+ /** How far PageUp and PageDown move. Ten rows is the native `<select>` step and
5265
+ * the APG listbox example's — a fixed number rather than a measured screenful,
5266
+ * so the jump is the same wherever the panel happens to be clipped. */
5267
+ private static readonly pageStep;
5009
5268
  private moveActive;
5010
5269
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
5011
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "triggerDisplay": { "alias": "triggerDisplay"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "emptyTemplate"], never, true, never>;
5270
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ds-multi-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "readOnly": { "alias": "readOnly"; "required": false; "isSignal": true; }; "readonlyBinding": { "alias": "readonly"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "filterWith": { "alias": "filterWith"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "scrollActiveIntoView": { "alias": "scrollActiveIntoView"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "success": { "alias": "success"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "triggerDisplay": { "alias": "triggerDisplay"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "optional": { "alias": "optional"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "filterChange": "filterChange"; "opened": "opened"; "closed": "closed"; }, ["optionTemplate", "chipTemplate", "pickerTrigger", "panelHeaderTemplate", "panelFooterTemplate", "groupLabelTemplate", "emptyTemplate"], never, true, never>;
5012
5271
  }
5013
5272
 
5014
5273
  declare class SkeletonComponent {
@@ -5259,6 +5518,58 @@ declare class DsEmptyTemplateDirective {
5259
5518
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsEmptyTemplateDirective, "[dsEmptyTemplate]", never, {}, {}, never, never, true, never>;
5260
5519
  }
5261
5520
 
5521
+ /**
5522
+ * Fills a strip above a picker panel's option list — "3 of 40 selected", a
5523
+ * "clear all" button, a hint, a link to a fuller search.
5524
+ *
5525
+ * Context: `count` is how many options are visible after filtering, `total` how
5526
+ * many were given, and `query` the text that narrowed them.
5527
+ *
5528
+ * It sits OUTSIDE the `listbox`, so whatever you put here is not counted as an
5529
+ * option and does not break a screen reader's "N of M" position reporting. It
5530
+ * also stays put while the list scrolls under it — the panel clips and the list
5531
+ * is the scroller.
5532
+ */
5533
+ declare class DsPanelHeaderTemplateDirective {
5534
+ readonly template: TemplateRef<unknown>;
5535
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsPanelHeaderTemplateDirective, never>;
5536
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsPanelHeaderTemplateDirective, "[dsPanelHeaderTemplate]", never, {}, {}, never, never, true, never>;
5537
+ }
5538
+
5539
+ /**
5540
+ * Fills a strip below a picker panel's option list — a "create new" affordance
5541
+ * of your own, a count, a link, an apply button for a panel the user batches
5542
+ * choices in.
5543
+ *
5544
+ * Context: the same as the header slot — `count`, `total`, `query`.
5545
+ *
5546
+ * Like the header it sits OUTSIDE the `listbox` and does not scroll with the
5547
+ * options. Anything focusable you put here is reached by Tab from the panel, so
5548
+ * give it an accessible name.
5549
+ */
5550
+ declare class DsPanelFooterTemplateDirective {
5551
+ readonly template: TemplateRef<unknown>;
5552
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsPanelFooterTemplateDirective, never>;
5553
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsPanelFooterTemplateDirective, "[dsPanelFooterTemplate]", never, {}, {}, never, never, true, never>;
5554
+ }
5555
+
5556
+ /**
5557
+ * Fills an option group's heading — a count beside the name, a team glyph, a
5558
+ * secondary line.
5559
+ *
5560
+ * Context: `$implicit` and `group` are the group itself, `count` how many of its
5561
+ * options survived the filter.
5562
+ *
5563
+ * The heading element stays the library's: it keeps the id that the group's
5564
+ * `aria-labelledby` points at, so replacing the text cannot detach a group from
5565
+ * its name.
5566
+ */
5567
+ declare class DsGroupLabelTemplateDirective {
5568
+ readonly template: TemplateRef<unknown>;
5569
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<DsGroupLabelTemplateDirective, never>;
5570
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DsGroupLabelTemplateDirective, "[dsGroupLabelTemplate]", never, {}, {}, never, never, true, never>;
5571
+ }
5572
+
5262
5573
  /**
5263
5574
  * Replaces `ds-autocomplete`'s "Create «…»" row.
5264
5575
  *
@@ -5304,5 +5615,5 @@ declare class FieldClickFocusDirective {
5304
5615
  static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FieldClickFocusDirective, "[dsFieldClickFocus]", never, {}, {}, never, never, true, never>;
5305
5616
  }
5306
5617
 
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 };
5618
+ export { ACCORDION, AccordionComponent, AccordionItemComponent, AlertComponent, AppLayoutComponent, AuthLayoutComponent, AutocompleteComponent, AvatarComponent, AvatarGroupComponent, BadgeComponent, BannerComponent, BodyScrollLockService, BottomSheetComponent, BrandNameDirective, BreadcrumbsComponent, BreadcrumbsService, ButtonComponent, ButtonGroupComponent, CardComponent, CellTemplateDirective, CheckboxComponent, ColorPickerComponent, ContainerComponent, DS_CONFIG, DS_FIELD_GROUP, DS_FIELD_WARNING_KIND, DS_ICON_REGISTRY, DS_TOAST_CONFIG, DS_TOAST_POSITION, DS_TOAST_POSITION_DEFAULT, DatePickerComponent, DescriptionItemComponent, DescriptionListComponent, DividerComponent, DrawerComponent, DropzoneComponent, DsChipTemplateDirective, DsCreateTemplateDirective, DsEmptyTemplateDirective, DsGroupLabelTemplateDirective, DsOptionTemplateDirective, DsOverlayCloseRef, DsPanelFooterTemplateDirective, DsPanelHeaderTemplateDirective, DsPickerTriggerDirective, DsStaticPreview, EmptyStateComponent, FieldClickFocusDirective, FieldGroupComponent, FilterBarComponent, FilterItemDirective, HeaderFilterDirective, ICONS, IconButtonComponent, IconComponent, InlineComponent, InputComponent, LayoutNavigationService, LayoutScrollService, ListComponent, ListItemComponent, LoadingOverlayComponent, MenuComponent, MenuDividerComponent, MenuItemComponent, ModalCardComponent, ModalComponent, ModalService, MultiSelectComponent, NumberStepperComponent, OtpInputComponent, PageFooterComponent, PageHeaderComponent, PaginationComponent, PasswordRulesComponent, PopoverComponent, ProgressComponent, RADIO_GROUP, RadioComponent, RadioGroupComponent, RailTriggerDirective, ReserveMessagesDirective, SIDENAV, SearchComponent, SegmentedComponent, SelectComponent, SidenavComponent, SidenavFooterComponent, SidenavGroupComponent, SidenavItemComponent, SkeletonComponent, SliderComponent, SpinnerComponent, SplitButtonComponent, StackComponent, StatComponent, StatusDotComponent, StepperComponent, SwitchComponent, TabComponent, TableComponent, TabsComponent, TagComponent, TextareaComponent, TimePickerComponent, TimelineComponent, TimelineItemComponent, ToastComponent, ToastRegionComponent, ToastService, ToggleButtonComponent, TooltipDirective, TooltipPanelComponent, TopBarComponent, TreeComponent, W3wComponent, avatarTint, flattenDsOptions, inheritDsConfig, initialsFrom, isDsOptionGroup, isSelectOptionGroup, passwordRulesMet, provideDsConfig, provideDsIcons, provideDsTheme };
5619
+ export type { AccordionContract, AccordionItemRef, AlertVariant, AutocompleteItem, AutocompleteOption, AutocompleteOptionGroup, AutocompleteValueOverflow, AutocompleteWidth, AvatarSize, AvatarStatus, AvatarTintOptions, BannerVariant, BreadcrumbItem, ButtonColor, ButtonType, ButtonVariant, CardElevation, CardPadding, ContainerSize, DatePickerMode, DatePickerPreset, DatePickerValue, DateValue, DescriptionListOrientation, DividerSpacing, DividerVariant, DrawerPlacement, DropzoneFile, DropzoneFileState, DsConfig, DsControlWidth, DsFieldError, DsFieldErrorsInput, DsFieldGroupContext, DsIconRegistry, DsOption, DsOptionGroup, DsOptionItem, DsPasswordRule, DsPasswordRuleState, DsScrollReset, DsSize, DsStatus, DsStatusKey, DsStatusRegistry, DsThemeOptions, DsToastConfig, DsToastHorizontalPosition, DsToastPosition, DsToastVerticalPosition, DsTriggerDisplay, EmptyStateVariant, HeaderFilterContext, IconButtonType, IconButtonVariant, IconName, InputType, LayoutAlign, LayoutGap, LayoutJustify, ModalConfirmOptions, ModalConfirmTone, ModalSize, MultiSelectItem, MultiSelectOption, MultiSelectOptionGroup, MultiSelectWidth, OtpMode, PageFooterVariant, PopoverAlign, PopoverPlacement, ProgressVariant, RadioGroupChild, RadioGroupContract, RangeValue, SegmentedOption, SelectItem, SelectOption, SelectOptionGroup, SelectWidth, SidenavAlertItem, SidenavContract, SidenavItemModel, SidenavSearchProvider, SidenavSearchResult, SortChangeEvent, SortDir, SplitButtonItem, SplitButtonVariant, StepperLabelPosition, StepperOrientation, TableCellEditEvent, TableColumn, TableExpandMode, TableFilterMode, TableRowAction, TableRowActionEvent, TableSortMode, TabsOrientation, TabsVariant, TagVariant, TextareaResize, TimeFormat, TimePickerMode, TimePickerValue, TimeRangeValue, TimeValue, TimelineTone, ToastAction, ToastEntry, ToastOptions, ToastPromiseMessages, ToastRef, ToastVariant, TooltipPlacement, TreeNode };