@angular/aria 21.0.0-rc.0 → 21.0.0-rc.1

package/types/private.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { Signal } from '@angular/core';
+import { Signal, OnDestroy } from '@angular/core';
 import { SignalLike, WritableSignalLike, KeyboardEventManager, PointerEventManager } from './_grid-chunk.js';
 export { GridCellInputs, GridCellPattern, GridCellWidgetInputs, GridCellWidgetPattern, GridInputs, GridPattern, GridRowInputs, GridRowPattern, convertGetterSetterToWritableSignalLike } from './_grid-chunk.js';
 
@@ -8,7 +8,7 @@ interface ListFocusItem {
     /** A unique identifier for the item. */
     id: SignalLike<string>;
     /** The html element that should receive focus. */
-    element: SignalLike<HTMLElement>;
+    element: SignalLike<HTMLElement | undefined>;
     /** Whether an item is disabled. */
     disabled: SignalLike<boolean>;
     /** The index of the item in the list. */
@@ -24,8 +24,8 @@ interface ListFocusInputs<T extends ListFocusItem> {
     items: SignalLike<T[]>;
     /** The active item. */
     activeItem: WritableSignalLike<T | undefined>;
-    /** Whether disabled items in the list should be skipped when navigating. */
-    skipDisabled: SignalLike<boolean>;
+    /** Whether disabled items in the list should be focusable. */
+    softDisabled: SignalLike<boolean>;
     element: SignalLike<HTMLElement | undefined>;
 }
 /** Controls focus for a list of items. */
@@ -42,10 +42,10 @@ declare class ListFocus<T extends ListFocusItem> {
     isListDisabled(): boolean;
     /** The id of the current active item. */
     getActiveDescendant(): string | undefined;
-    /** The tabindex for the list. */
-    getListTabindex(): -1 | 0;
-    /** Returns the tabindex for the given item. */
-    getItemTabindex(item: T): -1 | 0;
+    /** The tab index for the list. */
+    getListTabIndex(): -1 | 0;
+    /** Returns the tab index for the given item. */
+    getItemTabIndex(item: T): -1 | 0;
     /** Moves focus to the given item if it is focusable. */
     focus(item: T, opts?: {
         focusElement?: boolean;
@@ -98,6 +98,10 @@ declare class ListNavigation<T extends ListNavigationItem> {
     last(opts?: {
         focusElement?: boolean;
     }): boolean;
+    /** Gets the first focusable item from the given list of items. */
+    peekFirst(items?: T[]): T | undefined;
+    /** Gets the last focusable item from the given list of items. */
+    peekLast(items?: T[]): T | undefined;
     /** Advances to the next or previous focusable item in the list based on the given delta. */
     private _advance;
     /** Peeks the next or previous focusable item in the list based on the given delta. */
@@ -139,9 +143,9 @@ declare class ListSelection<T extends ListSelectionItem<V>, V> {
         anchor: boolean;
     }): void;
     /** Deselects the item at the current active index. */
-    deselect(item?: T | null): void;
+    deselect(item?: ListSelectionItem<V>): void;
     /** Toggles the item at the current active index. */
-    toggle(): void;
+    toggle(item?: ListSelectionItem<V>): void;
     /** Toggles only the item at the current active index. */
     toggleOne(): void;
     /** Selects all items in the list. */
@@ -240,9 +244,9 @@ declare class List<T extends ListItem<V>, V> {
     /** Whether the list is disabled. */
     disabled: _angular_core.Signal<boolean>;
     /** The id of the current active item. */
-    activedescendant: _angular_core.Signal<string | undefined>;
-    /** The tabindex of the list. */
-    tabindex: _angular_core.Signal<0 | -1>;
+    activeDescendant: _angular_core.Signal<string | undefined>;
+    /** The tab index of the list. */
+    tabIndex: _angular_core.Signal<0 | -1>;
     /** The index of the currently active item in the list. */
     activeIndex: _angular_core.Signal<number>;
     /**
@@ -261,7 +265,7 @@ declare class List<T extends ListItem<V>, V> {
     /** Whether the list should wrap. Used to disable wrapping while range selecting. */
     private _wrap;
     constructor(inputs: ListInputs<T, V>);
-    /** Returns the tabindex for the given item. */
+    /** Returns the tab index for the given item. */
     getItemTabindex(item: T): 0 | -1;
     /** Navigates to the first option in the list. */
     first(opts?: NavOptions): void;
@@ -286,11 +290,11 @@ declare class List<T extends ListItem<V>, V> {
     /** Sets the selection to only the current active item. */
     selectOne(): void;
     /** Deselects the currently active item in the list. */
-    deselect(): void;
+    deselect(item?: T): void;
     /** Deselects all items in the list. */
     deselectAll(): void;
     /** Toggles the currently active item in the list. */
-    toggle(): void;
+    toggle(item?: T): void;
     /** Toggles the currently active item in the list, deselecting all other items. */
     toggleOne(): void;
     /** Toggles the selection of all items in the list. */
@@ -338,12 +342,16 @@ interface ComboboxListboxControls<T extends ListItem<V>, V> {
     id: () => string;
     /** The ARIA role for the popup. */
     role: SignalLike<'listbox' | 'tree' | 'grid'>;
+    /** Whether multiple items in the popup can be selected at once. */
+    multi: SignalLike<boolean>;
     /** The ID of the active item in the popup. */
     activeId: SignalLike<string | undefined>;
     /** The list of items in the popup. */
     items: SignalLike<T[]>;
     /** Navigates to the given item in the popup. */
-    focus: (item: T) => void;
+    focus: (item: T, opts?: {
+        focusElement?: boolean;
+    }) => void;
     /** Navigates to the next item in the popup. */
     next: () => void;
     /** Navigates to the previous item in the popup. */
@@ -354,14 +362,16 @@ interface ComboboxListboxControls<T extends ListItem<V>, V> {
     last: () => void;
     /** Selects the current item in the popup. */
     select: (item?: T) => void;
+    /** Toggles the selection state of the given item in the popup. */
+    toggle: (item?: T) => void;
     /** Clears the selection state of the popup. */
     clearSelection: () => void;
     /** Removes focus from any item in the popup. */
     unfocus: () => void;
     /** Returns the item corresponding to the given event. */
     getItem: (e: PointerEvent) => T | undefined;
-    /** Returns the currently selected item in the popup. */
-    getSelectedItem: () => T | undefined;
+    /** Returns the currently selected items in the popup. */
+    getSelectedItems: () => T[];
     /** Sets the value of the combobox based on the selected item. */
     setValue: (value: V | undefined) => void;
 }
@@ -373,11 +383,15 @@ interface ComboboxTreeControls<T extends ListItem<V>, V> extends ComboboxListbox
     /** Collapses the currently active item in the popup. */
     collapseItem: () => void;
     /** Checks if the currently active item in the popup is expandable. */
-    isItemExpandable: () => boolean;
+    isItemExpandable: (item?: T) => boolean;
     /** Expands all nodes in the tree. */
     expandAll: () => void;
     /** Collapses all nodes in the tree. */
     collapseAll: () => void;
+    /** Toggles the expansion state of the currently active item in the popup. */
+    toggleExpansion: (item?: T) => void;
+    /** Whether the current active item is selectable. */
+    isItemSelectable: (item?: T) => boolean;
 }
 /** Controls the state of a combobox. */
 declare class ComboboxPattern<T extends ListItem<V>, V> {
@@ -385,7 +399,7 @@ declare class ComboboxPattern<T extends ListItem<V>, V> {
     /** Whether the combobox is expanded. */
     expanded: _angular_core.WritableSignal<boolean>;
     /** The ID of the active item in the combobox. */
-    activedescendant: _angular_core.Signal<string | null>;
+    activeDescendant: _angular_core.Signal<string | null>;
     /** The currently highlighted item in the combobox. */
     highlightedItem: _angular_core.WritableSignal<T | undefined>;
     /** Whether the most recent input event was a deletion. */
@@ -402,8 +416,8 @@ declare class ComboboxPattern<T extends ListItem<V>, V> {
     autocomplete: _angular_core.Signal<"both" | "list">;
     /** The ARIA role of the popup associated with the combobox. */
     hasPopup: _angular_core.Signal<"listbox" | "tree" | "grid" | null>;
-    /** Whether the combobox is interactive. */
-    isInteractive: _angular_core.Signal<boolean>;
+    /** Whether the combobox is read-only. */
+    readonly: _angular_core.Signal<true | null>;
     /** The keydown event manager for the combobox. */
     keydown: _angular_core.Signal<KeyboardEventManager<KeyboardEvent>>;
     /** The pointerup event manager for the combobox. */
@@ -426,11 +440,14 @@ declare class ComboboxPattern<T extends ListItem<V>, V> {
     /** Highlights the currently selected item in the combobox. */
     highlight(): void;
     /** Closes the combobox. */
-    close(): void;
+    close(opts?: {
+        reset: boolean;
+    }): void;
     /** Opens the combobox. */
     open(nav?: {
         first?: boolean;
         last?: boolean;
+        selected?: boolean;
     }): void;
     /** Navigates to the next focusable item in the combobox popup. */
     next(): void;
@@ -488,10 +505,10 @@ declare class OptionPattern<V> {
     searchTerm: SignalLike<string>;
     /** A reference to the parent listbox. */
     listbox: SignalLike<ListboxPattern$1<V> | undefined>;
-    /** The tabindex of the option. */
-    tabindex: _angular_core.Signal<0 | -1 | undefined>;
+    /** The tab index of the option. */
+    tabIndex: _angular_core.Signal<0 | -1 | undefined>;
     /** The html element that should receive focus. */
-    element: SignalLike<HTMLElement>;
+    element: SignalLike<HTMLElement | undefined>;
     constructor(args: OptionInputs<V>);
 }
 
@@ -512,10 +529,10 @@ declare class ListboxPattern<V> {
     disabled: _angular_core.Signal<boolean>;
     /** Whether the listbox is readonly. */
     readonly: SignalLike<boolean>;
-    /** The tabindex of the listbox. */
-    tabindex: SignalLike<-1 | 0>;
+    /** The tab index of the listbox. */
+    tabIndex: SignalLike<-1 | 0>;
     /** The id of the current active item. */
-    activedescendant: _angular_core.Signal<string | undefined>;
+    activeDescendant: _angular_core.Signal<string | undefined>;
     /** Whether multiple items in the list can be selected at once. */
     multi: SignalLike<boolean>;
     /** The number of items in the listbox. */
@@ -570,8 +587,10 @@ declare class ComboboxListboxPattern<V> extends ListboxPattern<V> implements Com
     activeId: _angular_core.Signal<string | undefined>;
     /** The list of options in the listbox. */
     items: SignalLike<OptionPattern<V>[]>;
-    /** The tabindex for the listbox. Always -1 because the combobox handles focus. */
-    tabindex: SignalLike<-1 | 0>;
+    /** The tab index for the listbox. Always -1 because the combobox handles focus. */
+    tabIndex: SignalLike<-1 | 0>;
+    /** Whether multiple items in the list can be selected at once. */
+    multi: _angular_core.Signal<boolean>;
     constructor(inputs: ComboboxListboxInputs<V>);
     /** Noop. The combobox handles keydown events. */
     onKeydown(_: KeyboardEvent): void;
@@ -580,7 +599,9 @@ declare class ComboboxListboxPattern<V> extends ListboxPattern<V> implements Com
     /** Noop. The combobox controls the open state. */
     setDefaultState(): void;
     /** Navigates to the specified item in the listbox. */
-    focus: (item: OptionPattern<V>) => void;
+    focus: (item: OptionPattern<V>, opts?: {
+        focusElement?: boolean;
+    }) => void;
     /** Navigates to the next focusable item in the listbox. */
     next: () => void;
     /** Navigates to the previous focusable item in the listbox. */
@@ -593,12 +614,14 @@ declare class ComboboxListboxPattern<V> extends ListboxPattern<V> implements Com
     unfocus: () => void;
     /** Selects the specified item in the listbox. */
     select: (item?: OptionPattern<V>) => void;
+    /** Toggles the selection state of the given item in the listbox. */
+    toggle: (item?: OptionPattern<V>) => void;
     /** Clears the selection in the listbox. */
     clearSelection: () => void;
     /** Retrieves the OptionPattern associated with a pointer event. */
     getItem: (e: PointerEvent) => OptionPattern<V> | undefined;
-    /** Retrieves the currently selected item in the listbox. */
-    getSelectedItem: () => OptionPattern<V> | undefined;
+    /** Retrieves the currently selected items in the listbox. */
+    getSelectedItems: () => OptionPattern<V>[];
     /** Sets the value of the combobox listbox. */
     setValue: (value: V | undefined) => void;
 }
@@ -608,7 +631,9 @@ interface MenuBarInputs<V> extends Omit<ListInputs<MenuItemPattern<V>, V>, 'disa
     /** The menu items contained in the menu. */
     items: SignalLike<MenuItemPattern<V>[]>;
     /** Callback function triggered when a menu item is selected. */
-    onSubmit?: (value: V) => void;
+    onSelect?: (value: V) => void;
+    /** The text direction of the menu bar. */
+    textDirection: SignalLike<'ltr' | 'rtl'>;
 }
 /** The inputs for the MenuPattern class. */
 interface MenuInputs<V> extends Omit<ListInputs<MenuItemPattern<V>, V>, 'value' | 'disabled'> {
@@ -619,16 +644,18 @@ interface MenuInputs<V> extends Omit<ListInputs<MenuItemPattern<V>, V>, 'value'
     /** A reference to the parent menu or menu trigger. */
     parent: SignalLike<MenuTriggerPattern<V> | MenuItemPattern<V> | undefined>;
     /** Callback function triggered when a menu item is selected. */
-    onSubmit?: (value: V) => void;
+    onSelect?: (value: V) => void;
+    /** The text direction of the menu bar. */
+    textDirection: SignalLike<'ltr' | 'rtl'>;
 }
 /** The inputs for the MenuTriggerPattern class. */
 interface MenuTriggerInputs<V> {
     /** A reference to the menu trigger element. */
     element: SignalLike<HTMLElement | undefined>;
-    /** A reference to the submenu associated with the menu trigger. */
-    submenu: SignalLike<MenuPattern<V> | undefined>;
-    /** Callback function triggered when a menu item is selected. */
-    onSubmit?: (value: V) => void;
+    /** A reference to the menu associated with the trigger. */
+    menu: SignalLike<MenuPattern<V> | undefined>;
+    /** The text direction of the menu bar. */
+    textDirection: SignalLike<'ltr' | 'rtl'>;
 }
 /** The inputs for the MenuItemPattern class. */
 interface MenuItemInputs<V> extends Omit<ListItem<V>, 'index' | 'selectable'> {
@@ -752,10 +779,10 @@ declare class MenuTriggerPattern<V> {
     role: () => string;
     /** Whether the menu trigger has a popup. */
     hasPopup: () => boolean;
-    /** The submenu associated with the trigger. */
-    submenu: SignalLike<MenuPattern<V> | undefined>;
-    /** The tabindex of the menu trigger. */
-    tabindex: Signal<-1 | 0>;
+    /** The menu associated with the trigger. */
+    menu: SignalLike<MenuPattern<V> | undefined>;
+    /** The tab index of the menu trigger. */
+    tabIndex: Signal<-1 | 0>;
     /** Handles keyboard events for the menu trigger. */
     keydownManager: Signal<KeyboardEventManager<KeyboardEvent>>;
     constructor(inputs: MenuTriggerInputs<V>);
@@ -787,11 +814,11 @@ declare class MenuItemPattern<V> implements ListItem<V> {
     /** The search term for the menu item. */
     searchTerm: SignalLike<string>;
     /** The element of the menu item. */
-    element: SignalLike<HTMLElement>;
+    element: SignalLike<HTMLElement | undefined>;
     /** Whether the menu item is active. */
     isActive: Signal<boolean>;
-    /** The tabindex of the menu item. */
-    tabindex: Signal<0 | -1>;
+    /** The tab index of the menu item. */
+    tabIndex: Signal<0 | -1>;
     /** The position of the menu item in the menu. */
     index: Signal<number>;
     /** Whether the menu item is expanded. */
@@ -820,274 +847,6 @@ declare class MenuItemPattern<V> implements ListItem<V> {
     }): void;
 }
 
-/** Represents the required inputs for a radio button in a radio group. */
-interface RadioButtonInputs<V> extends Omit<ListItem<V>, 'searchTerm' | 'index' | 'selectable'> {
-    /** A reference to the parent radio group. */
-    group: SignalLike<RadioGroupPattern<V> | undefined>;
-}
-/** Represents a radio button within a radio group. */
-declare class RadioButtonPattern<V> {
-    readonly inputs: RadioButtonInputs<V>;
-    /** A unique identifier for the radio button. */
-    readonly id: SignalLike<string>;
-    /** The value associated with the radio button. */
-    readonly value: SignalLike<V>;
-    /** The position of the radio button within the group. */
-    readonly index: SignalLike<number>;
-    /** Whether the radio button is currently the active one (focused). */
-    readonly active: _angular_core.Signal<boolean>;
-    /** Whether the radio button is selected. */
-    readonly selected: SignalLike<boolean>;
-    /** Whether the radio button is selectable. */
-    readonly selectable: () => boolean;
-    /** Whether the radio button is disabled. */
-    readonly disabled: SignalLike<boolean>;
-    /** A reference to the parent radio group. */
-    readonly group: SignalLike<RadioGroupPattern<V> | undefined>;
-    /** The tabindex of the radio button. */
-    readonly tabindex: _angular_core.Signal<0 | -1 | undefined>;
-    /** The HTML element associated with the radio button. */
-    readonly element: SignalLike<HTMLElement>;
-    /** The search term for typeahead. */
-    readonly searchTerm: () => string;
-    constructor(inputs: RadioButtonInputs<V>);
-}
-
-/** Represents the required inputs for a radio group. */
-type RadioGroupInputs<V> = Omit<ListInputs<RadioButtonPattern<V>, V>, 'multi' | 'selectionMode' | 'wrap' | 'typeaheadDelay'> & {
-    /** Whether the radio group is disabled. */
-    disabled: SignalLike<boolean>;
-    /** Whether the radio group is readonly. */
-    readonly: SignalLike<boolean>;
-    /** A function that returns the radio button associated with a given element. */
-    getItem: (e: PointerEvent) => RadioButtonPattern<V> | undefined;
-};
-/** Controls the state of a radio group. */
-declare class RadioGroupPattern<V> {
-    readonly inputs: RadioGroupInputs<V>;
-    /** The list behavior for the radio group. */
-    readonly listBehavior: List<RadioButtonPattern<V>, V>;
-    /** Whether the radio group is vertically or horizontally oriented. */
-    readonly orientation: SignalLike<'vertical' | 'horizontal'>;
-    /** Whether focus should wrap when navigating. */
-    readonly wrap: _angular_core.WritableSignal<boolean>;
-    /** The selection strategy used by the radio group. */
-    readonly selectionMode: _angular_core.WritableSignal<"follow" | "explicit">;
-    /** Whether the radio group is disabled. */
-    readonly disabled: _angular_core.Signal<boolean>;
-    /** The currently selected radio button. */
-    readonly selectedItem: _angular_core.Signal<RadioButtonPattern<V>>;
-    /** Whether the radio group is readonly. */
-    readonly readonly: _angular_core.Signal<boolean>;
-    /** The tabindex of the radio group. */
-    readonly tabindex: _angular_core.Signal<0 | -1>;
-    /** The id of the current active radio button (if using activedescendant). */
-    readonly activedescendant: _angular_core.Signal<string | undefined>;
-    /** The key used to navigate to the previous radio button. */
-    private readonly _prevKey;
-    /** The key used to navigate to the next radio button. */
-    private readonly _nextKey;
-    /** The keydown event manager for the radio group. */
-    readonly keydown: _angular_core.Signal<KeyboardEventManager<KeyboardEvent>>;
-    /** The pointerdown event manager for the radio group. */
-    readonly pointerdown: _angular_core.Signal<PointerEventManager<PointerEvent>>;
-    constructor(inputs: RadioGroupInputs<V>);
-    /** Handles keydown events for the radio group. */
-    onKeydown(event: KeyboardEvent): void;
-    /** Handles pointerdown events for the radio group. */
-    onPointerdown(event: PointerEvent): void;
-    /**
-     * Sets the radio group to its default initial state.
-     *
-     * Sets the active index to the selected radio button if one exists and is focusable.
-     * Otherwise, sets the active index to the first focusable radio button.
-     */
-    setDefaultState(): void;
-    /** Validates the state of the radio group and returns a list of accessibility violations. */
-    validate(): string[];
-}
-
-/** Represents the required inputs for a toolbar widget in a toolbar. */
-interface ToolbarWidgetInputs<V> extends Omit<ListItem<V>, 'searchTerm' | 'value' | 'index' | 'selectable'> {
-    /** A reference to the parent toolbar. */
-    toolbar: SignalLike<ToolbarPattern<V>>;
-}
-declare class ToolbarWidgetPattern<V> implements ListItem<V> {
-    readonly inputs: ToolbarWidgetInputs<V>;
-    /** A unique identifier for the widget. */
-    readonly id: SignalLike<string>;
-    /** The html element that should receive focus. */
-    readonly element: SignalLike<HTMLElement>;
-    /** Whether the widget is disabled. */
-    readonly disabled: SignalLike<boolean>;
-    /** A reference to the parent toolbar. */
-    readonly toolbar: SignalLike<ToolbarPattern<V>>;
-    /** The tabindex of the widgdet. */
-    readonly tabindex: _angular_core.Signal<0 | -1>;
-    /** The text used by the typeahead search. */
-    readonly searchTerm: () => string;
-    /** The value associated with the widget. */
-    readonly value: () => V;
-    /** Whether the widget is selectable. */
-    readonly selectable: () => boolean;
-    /** The position of the widget within the toolbar. */
-    readonly index: _angular_core.Signal<number>;
-    /** Whether the widget is currently the active one (focused). */
-    readonly active: _angular_core.Signal<boolean>;
-    constructor(inputs: ToolbarWidgetInputs<V>);
-}
-
-/** An interface that allows sub patterns to expose the necessary controls for the toolbar. */
-interface ToolbarWidgetGroupControls {
-    /** Whether the widget group is currently on the first item. */
-    isOnFirstItem(): boolean;
-    /** Whether the widget group is currently on the last item. */
-    isOnLastItem(): boolean;
-    /** Navigates to the next widget in the group. */
-    next(wrap: boolean): void;
-    /** Navigates to the previous widget in the group. */
-    prev(wrap: boolean): void;
-    /** Navigates to the first widget in the group. */
-    first(): void;
-    /** Navigates to the last widget in the group. */
-    last(): void;
-    /** Removes focus from the widget group. */
-    unfocus(): void;
-    /** Triggers the action of the currently active widget in the group. */
-    trigger(): void;
-    /** Navigates to the widget targeted by a pointer event. */
-    goto(event: PointerEvent): void;
-    /** Sets the widget group to its default initial state. */
-    setDefaultState(): void;
-}
-/** Represents the required inputs for a toolbar widget group. */
-interface ToolbarWidgetGroupInputs<V> extends Omit<ListItem<V>, 'searchTerm' | 'value' | 'index' | 'selectable'> {
-    /** A reference to the parent toolbar. */
-    toolbar: SignalLike<ToolbarPattern<V> | undefined>;
-    /** The controls for the sub patterns associated with the toolbar. */
-    controls: SignalLike<ToolbarWidgetGroupControls | undefined>;
-}
-/** A group of widgets within a toolbar that provides nested navigation. */
-declare class ToolbarWidgetGroupPattern<V> implements ListItem<V> {
-    readonly inputs: ToolbarWidgetGroupInputs<V>;
-    /** A unique identifier for the widget. */
-    readonly id: SignalLike<string>;
-    /** The html element that should receive focus. */
-    readonly element: SignalLike<HTMLElement>;
-    /** Whether the widget is disabled. */
-    readonly disabled: SignalLike<boolean>;
-    /** A reference to the parent toolbar. */
-    readonly toolbar: SignalLike<ToolbarPattern<V> | undefined>;
-    /** The text used by the typeahead search. */
-    readonly searchTerm: () => string;
-    /** The value associated with the widget. */
-    readonly value: () => V;
-    /** Whether the widget is selectable. */
-    readonly selectable: () => boolean;
-    /** The position of the widget within the toolbar. */
-    readonly index: _angular_core.Signal<number>;
-    /** The actions that can be performed on the widget group. */
-    readonly controls: SignalLike<ToolbarWidgetGroupControls>;
-    /** Default toolbar widget group controls when no controls provided. */
-    private readonly _defaultControls;
-    constructor(inputs: ToolbarWidgetGroupInputs<V>);
-}
-
-/** Represents the required inputs for a toolbar. */
-type ToolbarInputs<V> = Omit<ListInputs<ToolbarWidgetPattern<V> | ToolbarWidgetGroupPattern<V>, V>, 'multi' | 'typeaheadDelay' | 'value' | 'selectionMode' | 'focusMode'> & {
-    /** A function that returns the toolbar item associated with a given element. */
-    getItem: (e: Element) => ToolbarWidgetPattern<V> | ToolbarWidgetGroupPattern<V> | undefined;
-};
-/** Controls the state of a toolbar. */
-declare class ToolbarPattern<V> {
-    readonly inputs: ToolbarInputs<V>;
-    /** The list behavior for the toolbar. */
-    readonly listBehavior: List<ToolbarWidgetPattern<V> | ToolbarWidgetGroupPattern<V>, V>;
-    /** Whether the tablist is vertically or horizontally oriented. */
-    readonly orientation: SignalLike<'vertical' | 'horizontal'>;
-    /** Whether disabled items in the group should be skipped when navigating. */
-    readonly skipDisabled: SignalLike<boolean>;
-    /** Whether the toolbar is disabled. */
-    readonly disabled: _angular_core.Signal<boolean>;
-    /** The tabindex of the toolbar (if using activedescendant). */
-    readonly tabindex: _angular_core.Signal<0 | -1>;
-    /** The id of the current active widget (if using activedescendant). */
-    readonly activedescendant: _angular_core.Signal<string | undefined>;
-    /** The key used to navigate to the previous widget. */
-    private readonly _prevKey;
-    /** The key used to navigate to the next widget. */
-    private readonly _nextKey;
-    /** The alternate key used to navigate to the previous widget. */
-    private readonly _altPrevKey;
-    /** The alternate key used to navigate to the next widget. */
-    private readonly _altNextKey;
-    /** The keydown event manager for the toolbar. */
-    private readonly _keydown;
-    /** The pointerdown event manager for the toolbar. */
-    private readonly _pointerdown;
-    /** Navigates to the next widget in the toolbar. */
-    private _next;
-    /** Navigates to the previous widget in the toolbar. */
-    private _prev;
-    private _groupNext;
-    private _groupPrev;
-    /** Triggers the action of the currently active widget. */
-    private _trigger;
-    /** Navigates to the first widget in the toolbar. */
-    private _first;
-    /** Navigates to the last widget in the toolbar. */
-    private _last;
-    /** Navigates to the widget targeted by a pointer event. */
-    private _goto;
-    constructor(inputs: ToolbarInputs<V>);
-    /** Handles keydown events for the toolbar. */
-    onKeydown(event: KeyboardEvent): void;
-    /** Handles pointerdown events for the toolbar. */
-    onPointerdown(event: PointerEvent): void;
-    /**
-     * Sets the toolbar to its default initial state.
-     *
-     * Sets the active index to the selected widget if one exists and is focusable.
-     * Otherwise, sets the active index to the first focusable widget.
-     */
-    setDefaultState(): void;
-    /** Validates the state of the toolbar and returns a list of accessibility violations. */
-    validate(): string[];
-}
-
-/** Represents the required inputs for a toolbar controlled radio group. */
-type ToolbarRadioGroupInputs<V> = RadioGroupInputs<V> & {
-    /** The toolbar controlling the radio group. */
-    toolbar: SignalLike<ToolbarPattern<V> | undefined>;
-};
-/** Controls the state of a radio group in a toolbar. */
-declare class ToolbarRadioGroupPattern<V> extends RadioGroupPattern<V> implements ToolbarWidgetGroupControls {
-    readonly inputs: ToolbarRadioGroupInputs<V>;
-    constructor(inputs: ToolbarRadioGroupInputs<V>);
-    /** Noop. The toolbar handles keydown events. */
-    onKeydown(_: KeyboardEvent): void;
-    /** Noop. The toolbar handles pointerdown events. */
-    onPointerdown(_: PointerEvent): void;
-    /** Whether the radio group is currently on the first item. */
-    isOnFirstItem(): boolean;
-    /** Whether the radio group is currently on the last item. */
-    isOnLastItem(): boolean;
-    /** Navigates to the next radio button in the group. */
-    next(wrap: boolean): void;
-    /** Navigates to the previous radio button in the group. */
-    prev(wrap: boolean): void;
-    /** Navigates to the first radio button in the group. */
-    first(): void;
-    /** Navigates to the last radio button in the group. */
-    last(): void;
-    /** Removes focus from the radio group. */
-    unfocus(): void;
-    /** Triggers the action of the currently active radio button in the group. */
-    trigger(): void;
-    /** Navigates to the radio button targeted by a pointer event. */
-    goto(e: PointerEvent): void;
-}
-
 /** Represents an item that can be expanded or collapsed. */
 interface ExpansionItem {
     /** Whether the item is expandable. */
@@ -1197,7 +956,7 @@ declare class TabPattern {
     /** Whether the tab is disabled. */
     readonly disabled: SignalLike<boolean>;
     /** The html element that should receive focus. */
-    readonly element: SignalLike<HTMLElement>;
+    readonly element: SignalLike<HTMLElement | undefined>;
     /** Whether the tab is selectable. */
     readonly selectable: () => boolean;
     /** The text used by the typeahead search. */
@@ -1212,8 +971,8 @@ declare class TabPattern {
     readonly active: _angular_core.Signal<boolean>;
     /** Whether the tab is selected. */
     readonly selected: _angular_core.Signal<boolean>;
-    /** The tabindex of the tab. */
-    readonly tabindex: _angular_core.Signal<0 | -1>;
+    /** The tab index of the tab. */
+    readonly tabIndex: _angular_core.Signal<0 | -1>;
     /** The id of the tabpanel associated with the tab. */
     readonly controls: _angular_core.Signal<string | undefined>;
     constructor(inputs: TabInputs);
@@ -1235,8 +994,8 @@ declare class TabPanelPattern {
     readonly labelManager: LabelControl;
     /** Whether the tabpanel is hidden. */
     readonly hidden: _angular_core.Signal<boolean>;
-    /** The tabindex of this tabpanel. */
-    readonly tabindex: _angular_core.Signal<0 | -1>;
+    /** The tab index of this tabpanel. */
+    readonly tabIndex: _angular_core.Signal<0 | -1>;
     /** The aria-labelledby value for this tabpanel. */
     readonly labelledBy: _angular_core.Signal<string | undefined>;
     constructor(inputs: TabPanelInputs);
@@ -1254,10 +1013,10 @@ declare class TabListPattern {
     readonly orientation: SignalLike<'vertical' | 'horizontal'>;
     /** Whether the tablist is disabled. */
     readonly disabled: SignalLike<boolean>;
-    /** The tabindex of the tablist. */
-    readonly tabindex: _angular_core.Signal<0 | -1>;
+    /** The tab index of the tablist. */
+    readonly tabIndex: _angular_core.Signal<0 | -1>;
     /** The id of the current active tab. */
-    readonly activedescendant: _angular_core.Signal<string | undefined>;
+    readonly activeDescendant: _angular_core.Signal<string | undefined>;
     /** Whether selection should follow focus. */
     readonly followFocus: _angular_core.Signal<boolean>;
     /** The key used to navigate to the previous tab in the tablist. */
@@ -1286,6 +1045,125 @@ declare class TabListPattern {
     private _getItem;
 }
 
+/** Represents the required inputs for a toolbar widget group. */
+interface ToolbarWidgetGroupInputs<T extends ListItem<V>, V> {
+    /** A reference to the parent toolbar. */
+    toolbar: SignalLike<ToolbarPattern<V> | undefined>;
+    /** Whether the widget group is disabled. */
+    disabled: SignalLike<boolean>;
+    /** The list of items within the widget group. */
+    items: SignalLike<T[]>;
+    /** Whether the group allows multiple widgets to be selected. */
+    multi: SignalLike<boolean>;
+}
+/** A group of widgets within a toolbar that provides nested navigation. */
+declare class ToolbarWidgetGroupPattern<T extends ListItem<V>, V> {
+    readonly inputs: ToolbarWidgetGroupInputs<T, V>;
+    /** Whether the widget is disabled. */
+    readonly disabled: () => boolean;
+    /** A reference to the parent toolbar. */
+    readonly toolbar: () => ToolbarPattern<V> | undefined;
+    /** Whether the group allows multiple widgets to be selected. */
+    readonly multi: () => boolean;
+    readonly searchTerm: () => string;
+    readonly value: () => V;
+    readonly selectable: () => boolean;
+    readonly element: () => undefined;
+    constructor(inputs: ToolbarWidgetGroupInputs<T, V>);
+}
+
+/** Represents the required inputs for a toolbar widget in a toolbar. */
+interface ToolbarWidgetInputs<V> extends Omit<ListItem<V>, 'searchTerm' | 'index' | 'selectable'> {
+    /** A reference to the parent toolbar. */
+    toolbar: SignalLike<ToolbarPattern<V>>;
+    /** A reference to the parent widget group. */
+    group: SignalLike<ToolbarWidgetGroupPattern<ToolbarWidgetPattern<V>, V> | undefined>;
+}
+declare class ToolbarWidgetPattern<V> implements ListItem<V> {
+    readonly inputs: ToolbarWidgetInputs<V>;
+    /** A unique identifier for the widget. */
+    readonly id: () => string;
+    /** The html element that should receive focus. */
+    readonly element: () => HTMLElement | undefined;
+    /** Whether the widget is disabled. */
+    readonly disabled: () => boolean;
+    /** A reference to the parent toolbar. */
+    readonly group: () => ToolbarWidgetGroupPattern<ToolbarWidgetPattern<V>, V> | undefined;
+    /** A reference to the toolbar containing the widget. */
+    readonly toolbar: () => ToolbarPattern<V>;
+    /** The tabindex of the widget. */
+    readonly tabIndex: _angular_core.Signal<0 | -1>;
+    /** The text used by the typeahead search. */
+    readonly searchTerm: () => string;
+    /** The value associated with the widget. */
+    readonly value: () => V;
+    /** Whether the widget is selectable. */
+    readonly selectable: () => boolean;
+    /** The position of the widget within the toolbar. */
+    readonly index: _angular_core.Signal<number>;
+    /** Whether the widget is selected (only relevant in a selection group). */
+    readonly selected: _angular_core.Signal<boolean>;
+    /** Whether the widget is currently the active one (focused). */
+    readonly active: SignalLike<boolean>;
+    constructor(inputs: ToolbarWidgetInputs<V>);
+}
+
+/** Represents the required inputs for a toolbar. */
+type ToolbarInputs<V> = Omit<ListInputs<ToolbarWidgetPattern<V>, V>, 'multi' | 'typeaheadDelay' | 'value' | 'selectionMode' | 'focusMode'> & {
+    /** A function that returns the toolbar item associated with a given element. */
+    getItem: (e: Element) => ToolbarWidgetPattern<V> | undefined;
+};
+/** Controls the state of a toolbar. */
+declare class ToolbarPattern<V> {
+    readonly inputs: ToolbarInputs<V>;
+    /** The list behavior for the toolbar. */
+    readonly listBehavior: List<ToolbarWidgetPattern<V>, V>;
+    /** Whether the tablist is vertically or horizontally oriented. */
+    readonly orientation: SignalLike<'vertical' | 'horizontal'>;
+    /** Whether disabled items in the group should be focusable. */
+    readonly softDisabled: SignalLike<boolean>;
+    /** Whether the toolbar is disabled. */
+    readonly disabled: _angular_core.Signal<boolean>;
+    /** The tab index of the toolbar (if using activedescendant). */
+    readonly tabIndex: _angular_core.Signal<0 | -1>;
+    /** The id of the current active widget (if using activedescendant). */
+    readonly activeDescendant: _angular_core.Signal<string | undefined>;
+    /** The currently active item in the toolbar. */
+    readonly activeItem: () => ToolbarWidgetPattern<V> | undefined;
+    /** The key used to navigate to the previous widget. */
+    private readonly _prevKey;
+    /** The key used to navigate to the next widget. */
+    private readonly _nextKey;
+    /** The alternate key used to navigate to the previous widget. */
+    private readonly _altPrevKey;
+    /** The alternate key used to navigate to the next widget. */
+    private readonly _altNextKey;
+    /** The keydown event manager for the toolbar. */
+    private readonly _keydown;
+    /** Navigates to the next widget in a widget group. */
+    private _groupNext;
+    /** Navigates to the previous widget in a widget group. */
+    private _groupPrev;
+    /** Navigates to the widget targeted by a pointer event. */
+    private _goto;
+    select(): void;
+    constructor(inputs: ToolbarInputs<V>);
+    /** Handles keydown events for the toolbar. */
+    onKeydown(event: KeyboardEvent): void;
+    onPointerdown(event: PointerEvent): void;
+    /** Handles click events for the toolbar. */
+    onClick(event: MouseEvent): void;
+    /**
+     * Sets the toolbar to its default initial state.
+     *
+     * Sets the active index to the selected widget if one exists and is focusable.
+     * Otherwise, sets the active index to the first focusable widget.
+     */
+    setDefaultState(): void;
+    /** Validates the state of the toolbar and returns a list of accessibility violations. */
+    validate(): string[];
+}
+
 /** Inputs of the AccordionGroupPattern. */
 type AccordionGroupInputs = Omit<ListNavigationInputs<AccordionTriggerPattern> & ListFocusInputs<AccordionTriggerPattern> & Omit<ListExpansionInputs, 'items'>, 'focusMode'>;
 interface AccordionGroupPattern extends AccordionGroupInputs {
@@ -1327,8 +1205,8 @@ declare class AccordionTriggerPattern {
     active: _angular_core.Signal<boolean>;
     /** Id of the accordion panel controlled by the trigger. */
     controls: _angular_core.Signal<string | undefined>;
-    /** The tabindex of the trigger. */
-    tabindex: _angular_core.Signal<-1 | 0>;
+    /** The tab index of the trigger. */
+    tabIndex: _angular_core.Signal<-1 | 0>;
     /** Whether the trigger is disabled. Disabling an accordion group disables all the triggers. */
     disabled: _angular_core.Signal<boolean>;
     /** The index of the trigger within its accordion group. */
@@ -1390,7 +1268,7 @@ declare class TreeItemPattern<V> implements ListItem<V>, ExpansionItem {
     /** The value of this item. */
     readonly value: SignalLike<V>;
     /** A reference to the item element. */
-    readonly element: SignalLike<HTMLElement>;
+    readonly element: SignalLike<HTMLElement | undefined>;
     /** Whether the item is disabled. */
     readonly disabled: SignalLike<boolean>;
     /** The text used by the typeahead search. */
@@ -1418,15 +1296,15 @@ declare class TreeItemPattern<V> implements ListItem<V>, ExpansionItem {
     /** Whether this item is currently expanded. */
     readonly expanded: _angular_core.Signal<boolean>;
     /** Whether this item is visible. */
-    readonly visible: _angular_core.Signal<boolean>;
+    readonly visible: SignalLike<boolean>;
     /** The number of items under the same parent at the same level. */
     readonly setsize: _angular_core.Signal<number>;
     /** The position of this item among its siblings (1-based). */
     readonly posinset: _angular_core.Signal<number>;
     /** Whether the item is active. */
     readonly active: _angular_core.Signal<boolean>;
-    /** The tabindex of the item. */
-    readonly tabindex: _angular_core.Signal<0 | -1>;
+    /** The tab index of the item. */
+    readonly tabIndex: _angular_core.Signal<0 | -1>;
     /** Whether the item is selected. */
     readonly selected: SignalLike<boolean | undefined>;
     /** The current type of this item. */
@@ -1464,10 +1342,12 @@ declare class TreePattern<V> {
     readonly level: () => number;
     /** The root is always expanded. */
     readonly expanded: () => boolean;
-    /** The tabindex of the tree. */
-    readonly tabindex: SignalLike<-1 | 0>;
+    /** The roow is always visible. */
+    readonly visible: () => boolean;
+    /** The tab index of the tree. */
+    readonly tabIndex: SignalLike<-1 | 0>;
     /** The id of the current active item. */
-    readonly activedescendant: _angular_core.Signal<string | undefined>;
+    readonly activeDescendant: _angular_core.Signal<string | undefined>;
     /** The direct children of the root (top-level tree items). */
     readonly children: _angular_core.Signal<TreeItemPattern<V>[]>;
     /** All currently visible tree items. An item is visible if their parent is expanded. */
@@ -1502,8 +1382,8 @@ declare class TreePattern<V> {
     disabled: SignalLike<boolean>;
     /** The currently active item in the tree. */
     activeItem: WritableSignalLike<TreeItemPattern<V> | undefined>;
-    /** Whether disabled items should be skipped when navigating. */
-    skipDisabled: SignalLike<boolean>;
+    /** Whether disabled items should be focusable. */
+    softDisabled: SignalLike<boolean>;
     /** Whether the focus should wrap when navigating past the first or last item. */
     wrap: SignalLike<boolean>;
     /** The orientation of the tree. */
@@ -1557,8 +1437,8 @@ declare class ComboboxTreePattern<V> extends TreePattern<V> implements ComboboxT
     activeId: _angular_core.Signal<string | undefined>;
     /** The list of items in the tree. */
     items: _angular_core.Signal<TreeItemPattern<V>[]>;
-    /** The tabindex for the tree. Always -1 because the combobox handles focus. */
-    tabindex: SignalLike<-1 | 0>;
+    /** The tab index for the tree. Always -1 because the combobox handles focus. */
+    tabIndex: SignalLike<-1 | 0>;
     constructor(inputs: ComboboxTreeInputs<V>);
     /** Noop. The combobox handles keydown events. */
     onKeydown(_: KeyboardEvent): void;
@@ -1580,12 +1460,14 @@ declare class ComboboxTreePattern<V> extends TreePattern<V> implements ComboboxT
     unfocus: () => void;
     /** Selects the specified item in the tree or the current active item if not provided. */
     select: (item?: TreeItemPattern<V>) => void;
+    /** Toggles the selection state of the given item in the tree or the current active item if not provided. */
+    toggle: (item?: TreeItemPattern<V>) => void;
     /** Clears the selection in the tree. */
     clearSelection: () => void;
     /** Retrieves the TreeItemPattern associated with a pointer event. */
     getItem: (e: PointerEvent) => TreeItemPattern<V> | undefined;
-    /** Retrieves the currently selected item in the tree */
-    getSelectedItem: () => TreeItemPattern<V> | undefined;
+    /** Retrieves the currently selected items in the tree */
+    getSelectedItems: () => TreeItemPattern<V>[];
     /** Sets the value of the combobox tree. */
     setValue: (value: V | undefined) => void;
     /** Expands the currently focused item if it is expandable. */
@@ -1598,7 +1480,47 @@ declare class ComboboxTreePattern<V> extends TreePattern<V> implements ComboboxT
     expandAll: () => void;
     /** Collapses all of the tree items. */
     collapseAll: () => void;
+    /** Whether the currently active item is selectable. */
+    isItemSelectable: (item?: TreeItemPattern<V> | undefined) => boolean;
+}
+
+/**
+ * A container directive controls the visibility of its content.
+ */
+declare class DeferredContentAware {
+    readonly contentVisible: _angular_core.WritableSignal<boolean>;
+    readonly preserveContent: _angular_core.ModelSignal<boolean>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DeferredContentAware, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DeferredContentAware, never, never, { "preserveContent": { "alias": "preserveContent"; "required": false; "isSignal": true; }; }, { "preserveContent": "preserveContentChange"; }, never, never, true, never>;
+}
+/**
+ * DeferredContent loads/unloads the content based on the visibility.
+ * The visibilty signal is sent from a parent directive implements
+ * DeferredContentAware.
+ *
+ * Use this directive as a host directive. For example:
+ *
+ * ```ts
+ *   @Directive({
+ *     selector: 'ng-template[AccordionContent]',
+ *     hostDirectives: [DeferredContent],
+ *   })
+ *   class AccordionContent {}
+ * ```
+ */
+declare class DeferredContent implements OnDestroy {
+    private readonly _deferredContentAware;
+    private readonly _templateRef;
+    private readonly _viewContainerRef;
+    private _currentViewRef;
+    private _isRendered;
+    readonly deferredContentAware: _angular_core.WritableSignal<DeferredContentAware | null>;
+    constructor();
+    ngOnDestroy(): void;
+    private _destroyContent;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DeferredContent, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DeferredContent, never, never, {}, {}, never, never, true, never>;
 }
 
-export { AccordionGroupPattern, AccordionPanelPattern, AccordionTriggerPattern, ComboboxListboxPattern, ComboboxPattern, ComboboxTreePattern, ListboxPattern, MenuBarPattern, MenuItemPattern, MenuPattern, MenuTriggerPattern, OptionPattern, RadioButtonPattern, RadioGroupPattern, SignalLike, TabListPattern, TabPanelPattern, TabPattern, ToolbarPattern, ToolbarRadioGroupPattern, ToolbarWidgetGroupPattern, ToolbarWidgetPattern, TreeItemPattern, TreePattern, WritableSignalLike };
-export type { AccordionGroupInputs, AccordionPanelInputs, AccordionTriggerInputs, ComboboxInputs, ComboboxListboxControls, ComboboxListboxInputs, ComboboxTreeControls, ComboboxTreeInputs, ListboxInputs, MenuBarInputs, MenuInputs, MenuItemInputs, MenuTriggerInputs, OptionInputs, RadioButtonInputs, RadioGroupInputs, TabInputs, TabListInputs, TabPanelInputs, ToolbarInputs, ToolbarRadioGroupInputs, ToolbarWidgetGroupControls, ToolbarWidgetGroupInputs, ToolbarWidgetInputs, TreeInputs, TreeItemInputs };
+export { AccordionGroupPattern, AccordionPanelPattern, AccordionTriggerPattern, ComboboxListboxPattern, ComboboxPattern, ComboboxTreePattern, DeferredContent, DeferredContentAware, ListboxPattern, MenuBarPattern, MenuItemPattern, MenuPattern, MenuTriggerPattern, OptionPattern, SignalLike, TabListPattern, TabPanelPattern, TabPattern, ToolbarPattern, ToolbarWidgetGroupPattern, ToolbarWidgetPattern, TreeItemPattern, TreePattern, WritableSignalLike };
+export type { AccordionGroupInputs, AccordionPanelInputs, AccordionTriggerInputs, ComboboxInputs, ComboboxListboxControls, ComboboxListboxInputs, ComboboxTreeControls, ComboboxTreeInputs, ListboxInputs, MenuBarInputs, MenuInputs, MenuItemInputs, MenuTriggerInputs, OptionInputs, TabInputs, TabListInputs, TabPanelInputs, ToolbarInputs, ToolbarWidgetGroupInputs, ToolbarWidgetInputs, TreeInputs, TreeItemInputs };