@angular/aria 21.0.0-next.9 → 21.0.0-rc.1

package/types/{ui-patterns.d.ts → private.d.ts}

@@ -1,114 +1,14 @@
 import * as _angular_core from '@angular/core';
-
-/**
- * Options that are applicable to all event handlers.
- *
- * This library has not yet had a need for stopPropagationImmediate.
- */
-interface EventHandlerOptions {
-    stopPropagation: boolean;
-    preventDefault: boolean;
-}
-/** A basic event handler. */
-type EventHandler<T extends Event> = (event: T) => void;
-/** A function that determines whether an event is to be handled. */
-type EventMatcher<T extends Event> = (event: T) => boolean;
-/** A config that specifies how to handle a particular event. */
-interface EventHandlerConfig<T extends Event> extends EventHandlerOptions {
-    matcher: EventMatcher<T>;
-    handler: EventHandler<T>;
-}
-/** Bit flag representation of the possible modifier keys that can be present on an event. */
-declare enum Modifier {
-    None = 0,
-    Ctrl = 1,
-    Shift = 2,
-    Alt = 4,
-    Meta = 8,
-    Any = "Any"
-}
-type ModifierInputs = Modifier | Modifier[];
-/**
- * Abstract base class for all event managers.
- *
- * Event managers are designed to normalize how event handlers are authored and create a safety net
- * for common event handling gotchas like remembering to call preventDefault or stopPropagation.
- */
-declare abstract class EventManager<T extends Event> {
-    protected configs: EventHandlerConfig<T>[];
-    abstract options: EventHandlerOptions;
-    /** Runs the handlers that match with the given event. */
-    handle(event: T): void;
-    /** Configures the event manager to handle specific events. (See subclasses for more). */
-    abstract on(...args: [...unknown[]]): this;
-}
-
-type SignalLike<T> = () => T;
-interface WritableSignalLike<T> extends SignalLike<T> {
-    set(value: T): void;
-    update(updateFn: (value: T) => T): void;
-}
-/** Converts a getter setter style signal to a WritableSignalLike. */
-declare function convertGetterSetterToWritableSignalLike<T>(getter: () => T, setter: (v: T) => void): WritableSignalLike<T>;
-
-/**
- * Used to represent a keycode.
- *
- * This is used to match whether an events keycode should be handled. The ability to match using a
- * string, SignalLike, or Regexp gives us more flexibility when authoring event handlers.
- */
-type KeyCode = string | SignalLike<string> | RegExp;
-/**
- * An event manager that is specialized for handling keyboard events. By default this manager stops
- * propagation and prevents default on all events it handles.
- */
-declare class KeyboardEventManager<T extends KeyboardEvent> extends EventManager<T> {
-    options: EventHandlerOptions;
-    /** Configures this event manager to handle events with a specific key and no modifiers. */
-    on(key: KeyCode, handler: EventHandler<T>): this;
-    /**  Configures this event manager to handle events with a specific modifer and key combination. */
-    on(modifiers: ModifierInputs, key: KeyCode, handler: EventHandler<T>): this;
-    private _normalizeInputs;
-    private _isMatch;
-}
-
-/**
- * The different mouse buttons that may appear on a pointer event.
- */
-declare enum MouseButton {
-    Main = 0,
-    Auxiliary = 1,
-    Secondary = 2
-}
-/** An event manager that is specialized for handling pointer events. */
-declare class PointerEventManager<T extends PointerEvent> extends EventManager<T> {
-    options: EventHandlerOptions;
-    /**
-     * Configures this event manager to handle events with a specific modifer and mouse button
-     * combination.
-     */
-    on(button: MouseButton, modifiers: ModifierInputs, handler: EventHandler<T>): this;
-    /**
-     * Configures this event manager to handle events with a specific mouse button and no modifiers.
-     */
-    on(modifiers: ModifierInputs, handler: EventHandler<T>): this;
-    /**
-     * Configures this event manager to handle events with the main mouse button and no modifiers.
-     *
-     * @param handler The handler function
-     * @param options Options for whether to stop propagation or prevent default.
-     */
-    on(handler: EventHandler<T>): this;
-    private _normalizeInputs;
-    _isMatch(event: PointerEvent, button: MouseButton, modifiers: ModifierInputs): boolean;
-}
+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';
 
 /** Represents an item in a collection, such as a listbox option, than may receive focus. */
 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. */
@@ -124,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. */
@@ -142,12 +42,14 @@ 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): boolean;
+    focus(item: T, opts?: {
+        focusElement?: boolean;
+    }): boolean;
     /** Returns true if the given item can be navigated to. */
     isFocusable(item: T): boolean;
 }
@@ -173,19 +75,33 @@ declare class ListNavigation<T extends ListNavigationItem> {
         focusManager: ListFocus<T>;
     });
     /** Navigates to the given item. */
-    goto(item?: T): boolean;
+    goto(item?: T, opts?: {
+        focusElement?: boolean;
+    }): boolean;
     /** Navigates to the next item in the list. */
-    next(): boolean;
+    next(opts?: {
+        focusElement?: boolean;
+    }): boolean;
     /** Peeks the next item in the list. */
     peekNext(): T | undefined;
     /** Navigates to the previous item in the list. */
-    prev(): boolean;
+    prev(opts?: {
+        focusElement?: boolean;
+    }): boolean;
     /** Peeks the previous item in the list. */
     peekPrev(): T | undefined;
     /** Navigates to the first item in the list. */
-    first(): boolean;
+    first(opts?: {
+        focusElement?: boolean;
+    }): boolean;
     /** Navigates to the last item in the list. */
-    last(): boolean;
+    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. */
@@ -196,6 +112,8 @@ declare class ListNavigation<T extends ListNavigationItem> {
 interface ListSelectionItem<V> extends ListFocusItem {
     /** The value of the item. */
     value: SignalLike<V>;
+    /** Whether the item is selectable. */
+    selectable: SignalLike<boolean>;
 }
 /** Represents the required inputs for a collection that contains selectable items. */
 interface ListSelectionInputs<T extends ListSelectionItem<V>, V> extends ListFocusInputs<T> {
@@ -225,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. */
@@ -299,13 +217,14 @@ declare class ListTypeahead<T extends ListTypeaheadItem> {
     private _getItem;
 }
 
-/** The selection operations that the list can perform. */
-interface SelectOptions$1 {
+/** The operations that the list can perform after navigation. */
+interface NavOptions {
     toggle?: boolean;
     select?: boolean;
     selectOne?: boolean;
     selectRange?: boolean;
     anchor?: boolean;
+    focusElement?: boolean;
 }
 /** Represents an item in the list. */
 type ListItem<V> = ListTypeaheadItem & ListNavigationItem & ListSelectionItem<V> & ListFocusItem;
@@ -325,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>;
     /**
@@ -346,24 +265,24 @@ 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?: SelectOptions$1): void;
+    first(opts?: NavOptions): void;
     /** Navigates to the last option in the list. */
-    last(opts?: SelectOptions$1): void;
+    last(opts?: NavOptions): void;
     /** Navigates to the next option in the list. */
-    next(opts?: SelectOptions$1): void;
+    next(opts?: NavOptions): void;
     /** Navigates to the previous option in the list. */
-    prev(opts?: SelectOptions$1): void;
+    prev(opts?: NavOptions): void;
     /** Navigates to the given item in the list. */
-    goto(item: T, opts?: SelectOptions$1): void;
+    goto(item: T, opts?: NavOptions): void;
     /** Removes focus from the list. */
     unfocus(): void;
     /** Marks the given index as the potential start of a range selection. */
     anchor(index: number): void;
     /** Handles typeahead search navigation for the list. */
-    search(char: string, opts?: SelectOptions$1): void;
+    search(char: string, opts?: NavOptions): void;
     /** Checks if the list is currently typing for typeahead search. */
     isTyping(): boolean;
     /** Selects the currently active item in the list. */
@@ -371,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. */
@@ -383,7 +302,7 @@ declare class List<T extends ListItem<V>, V> {
     /** Checks if the given item is able to receive focus. */
     isFocusable(item: T): boolean;
     /** Handles updating selection for the list. */
-    updateSelection(opts?: SelectOptions$1): void;
+    updateSelection(opts?: NavOptions): void;
     /**
      * Safely performs a navigation operation.
      *
@@ -410,6 +329,12 @@ interface ComboboxInputs<T extends ListItem<V>, V> {
     inputValue?: WritableSignalLike<string>;
     /** The value of the first matching item in the popup. */
     firstMatch: SignalLike<V | undefined>;
+    /** Whether the combobox is disabled. */
+    disabled: SignalLike<boolean>;
+    /** Whether the combobox is read-only. */
+    readonly: SignalLike<boolean>;
+    /** Whether the combobox is in a right-to-left context. */
+    textDirection: SignalLike<'rtl' | 'ltr'>;
 }
 /** An interface that allows combobox popups to expose the necessary controls for the combobox. */
 interface ComboboxListboxControls<T extends ListItem<V>, V> {
@@ -417,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. */
@@ -433,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;
 }
@@ -452,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> {
@@ -464,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. */
@@ -472,15 +407,17 @@ declare class ComboboxPattern<T extends ListItem<V>, V> {
     /** Whether the combobox is focused. */
     isFocused: _angular_core.WritableSignal<boolean>;
     /** The key used to navigate to the previous item in the list. */
-    expandKey: _angular_core.Signal<string>;
+    expandKey: _angular_core.Signal<"ArrowLeft" | "ArrowRight">;
     /** The key used to navigate to the next item in the list. */
-    collapseKey: _angular_core.Signal<string>;
+    collapseKey: _angular_core.Signal<"ArrowLeft" | "ArrowRight">;
     /** The ID of the popup associated with the combobox. */
     popupId: _angular_core.Signal<string | null>;
     /** The autocomplete behavior of the combobox. */
     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 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. */
@@ -492,18 +429,25 @@ declare class ComboboxPattern<T extends ListItem<V>, V> {
     onPointerup(event: PointerEvent): void;
     /** Handles input events for the combobox. */
     onInput(event: Event): void;
+    /** Handles focus in events for the combobox. */
     onFocusIn(): void;
     /** Handles focus out events for the combobox. */
     onFocusOut(event: FocusEvent): void;
+    /** The first matching item in the combobox. */
     firstMatch: _angular_core.Signal<T | undefined>;
+    /** Handles filtering logic for the combobox. */
     onFilter(): void;
+    /** 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;
@@ -513,7 +457,9 @@ declare class ComboboxPattern<T extends ListItem<V>, V> {
     first(): void;
     /** Navigates to the last focusable item in the combobox popup. */
     last(): void;
+    /** Collapses the currently focused item in the combobox. */
     collapseItem(): void;
+    /** Expands the currently focused item in the combobox. */
     expandItem(): void;
     /** Selects an item in the combobox popup. */
     select(opts?: {
@@ -536,7 +482,7 @@ interface ListboxPattern$1<V> {
     listBehavior: List<OptionPattern<V>, V>;
 }
 /** Represents the required inputs for an option in a listbox. */
-interface OptionInputs<V> extends Omit<ListItem<V>, 'index'> {
+interface OptionInputs<V> extends Omit<ListItem<V>, 'index' | 'selectable'> {
     listbox: SignalLike<ListboxPattern$1<V> | undefined>;
 }
 /** Represents an option in a listbox. */
@@ -551,16 +497,18 @@ declare class OptionPattern<V> {
     active: _angular_core.Signal<boolean>;
     /** Whether the option is selected. */
     selected: _angular_core.Signal<boolean | undefined>;
+    /** Whether the option is selectable. */
+    selectable: () => boolean;
     /** Whether the option is disabled. */
     disabled: SignalLike<boolean>;
     /** The text used by the typeahead search. */
     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>);
 }
 
@@ -581,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. */
@@ -639,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;
@@ -649,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. */
@@ -662,276 +614,237 @@ 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;
 }
 
-/** Represents the required inputs for a radio button in a radio group. */
-interface RadioButtonInputs<V> extends Omit<ListItem<V>, 'searchTerm' | 'index'> {
-    /** 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 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.
-     */
+/** The inputs for the MenuBarPattern class. */
+interface MenuBarInputs<V> extends Omit<ListInputs<MenuItemPattern<V>, V>, 'disabled'> {
+    /** The menu items contained in the menu. */
+    items: SignalLike<MenuItemPattern<V>[]>;
+    /** Callback function triggered when a menu item is selected. */
+    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'> {
+    /** The unique ID of the menu. */
+    id: SignalLike<string>;
+    /** The menu items contained in the menu. */
+    items: SignalLike<MenuItemPattern<V>[]>;
+    /** 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. */
+    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 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'> {
+    /** A reference to the parent menu or menu trigger. */
+    parent: SignalLike<MenuPattern<V> | MenuBarPattern<V> | undefined>;
+    /** A reference to the submenu associated with the menu item. */
+    submenu: SignalLike<MenuPattern<V> | undefined>;
+}
+/** The menu ui pattern class. */
+declare class MenuPattern<V> {
+    readonly inputs: MenuInputs<V>;
+    /** The unique ID of the menu. */
+    id: SignalLike<string>;
+    /** The role of the menu. */
+    role: () => string;
+    /** Whether the menu is visible. */
+    isVisible: Signal<boolean>;
+    /** Controls list behavior for the menu items. */
+    listBehavior: List<MenuItemPattern<V>, V>;
+    /** Whether the menu or any of its child elements are currently focused. */
+    isFocused: _angular_core.WritableSignal<boolean>;
+    /** Whether the menu has received focus. */
+    hasBeenFocused: _angular_core.WritableSignal<boolean>;
+    /** Whether the menu should be focused on mouse over. */
+    shouldFocus: Signal<boolean>;
+    /** The key used to expand sub-menus. */
+    private _expandKey;
+    /** The key used to collapse sub-menus. */
+    private _collapseKey;
+    /** Represents the space key. Does nothing when the user is actively using typeahead. */
+    dynamicSpaceKey: Signal<"" | " ">;
+    /** The regexp used to decide if a key should trigger typeahead. */
+    typeaheadRegexp: RegExp;
+    /** The root of the menu. */
+    root: Signal<MenuTriggerPattern<V> | MenuBarPattern<V> | MenuPattern<V> | undefined>;
+    /** Handles keyboard events for the menu. */
+    keydownManager: Signal<KeyboardEventManager<KeyboardEvent>>;
+    constructor(inputs: MenuInputs<V>);
+    /** Sets the default state for the menu. */
     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'> {
-    /** 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;
-    /** 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. */
+    /** Handles keyboard events for the menu. */
+    onKeydown(event: KeyboardEvent): void;
+    /** Handles mouseover events for the menu. */
+    onMouseOver(event: MouseEvent): void;
+    /** Handles mouseout events for the menu. */
+    onMouseOut(event: MouseEvent): void;
+    /** Handles click events for the menu. */
+    onClick(event: MouseEvent): void;
+    /** Handles focusin events for the menu. */
+    onFocusIn(): void;
+    /** Handles the focusout event for the menu. */
+    onFocusOut(event: FocusEvent): void;
+    /** Focuses the previous menu item. */
+    prev(): void;
+    /** Focuses the next menu item. */
+    next(): void;
+    /** Focuses the first menu item. */
     first(): void;
-    /** Navigates to the last widget in the group. */
+    /** Focuses the last menu item. */
     last(): void;
-    /** Removes focus from the widget group. */
-    unfocus(): void;
-    /** Triggers the action of the currently active widget in the group. */
+    /** Triggers the active menu item. */
     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'> {
-    /** 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>;
+    /** Submits the menu. */
+    submit(item?: MenuItemPattern<V> | undefined): void;
+    /** Collapses the current menu or focuses the previous item in the menubar. */
+    collapse(): void;
+    /** Expands the current menu or focuses the next item in the menubar. */
+    expand(): void;
+    /** Closes the menu and all parent menus. */
+    closeAll(): void;
 }
-/** 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;
-    /** 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>);
+/** The menubar ui pattern class. */
+declare class MenuBarPattern<V> {
+    readonly inputs: MenuBarInputs<V>;
+    /** Controls list behavior for the menu items. */
+    listBehavior: List<MenuItemPattern<V>, V>;
+    /** The key used to navigate to the next item. */
+    private _nextKey;
+    /** The key used to navigate to the previous item. */
+    private _previousKey;
+    /** Represents the space key. Does nothing when the user is actively using typeahead. */
+    dynamicSpaceKey: Signal<"" | " ">;
+    /** The regexp used to decide if a key should trigger typeahead. */
+    typeaheadRegexp: RegExp;
+    /** Whether the menubar or any of its children are currently focused. */
+    isFocused: _angular_core.WritableSignal<boolean>;
+    /** Whether the menubar has been focused. */
+    hasBeenFocused: _angular_core.WritableSignal<boolean>;
+    /** Handles keyboard events for the menu. */
+    keydownManager: Signal<KeyboardEventManager<KeyboardEvent>>;
+    constructor(inputs: MenuBarInputs<V>);
+    /** Sets the default state for the menubar. */
+    setDefaultState(): void;
+    /** Handles keyboard events for the menu. */
+    onKeydown(event: KeyboardEvent): void;
+    /** Handles click events for the menu bar. */
+    onClick(event: MouseEvent): void;
+    /** Handles mouseover events for the menu bar. */
+    onMouseOver(event: MouseEvent): void;
+    /** Handles focusin events for the menu bar. */
+    onFocusIn(): void;
+    /** Handles focusout events for the menu bar. */
+    onFocusOut(event: FocusEvent): void;
+    /** Goes to and optionally focuses the specified menu item. */
+    goto(item: MenuItemPattern<V>, opts?: {
+        focusElement?: boolean;
+    }): void;
+    /** Focuses the next menu item. */
+    next(): void;
+    /** Focuses the previous menu item. */
+    prev(): void;
+    /** Closes the menubar and refocuses the root menu bar item. */
+    close(): void;
 }
-
-/** 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. */
+/** The menu trigger ui pattern class. */
+declare class MenuTriggerPattern<V> {
+    readonly inputs: MenuTriggerInputs<V>;
+    /** Whether the menu is expanded. */
+    expanded: _angular_core.WritableSignal<boolean>;
+    /** The role of the menu trigger. */
+    role: () => string;
+    /** Whether the menu trigger has a popup. */
+    hasPopup: () => boolean;
+    /** 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>);
+    /** Handles keyboard events for the menu trigger. */
     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[];
+    /** Handles click events for the menu trigger. */
+    onClick(): void;
+    /** Handles focusout events for the menu trigger. */
+    onFocusOut(event: FocusEvent): void;
+    /** Opens the menu. */
+    open(opts?: {
+        first?: boolean;
+        last?: boolean;
+    }): void;
+    /** Closes the menu. */
+    close(opts?: {
+        refocus?: boolean;
+    }): void;
 }
-
-/** 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;
+/** The menu item ui pattern class. */
+declare class MenuItemPattern<V> implements ListItem<V> {
+    readonly inputs: MenuItemInputs<V>;
+    /** The value of the menu item. */
+    value: SignalLike<V>;
+    /** The unique ID of the menu item. */
+    id: SignalLike<string>;
+    /** Whether the menu item is disabled. */
+    disabled: SignalLike<boolean>;
+    /** The search term for the menu item. */
+    searchTerm: SignalLike<string>;
+    /** The element of the menu item. */
+    element: SignalLike<HTMLElement | undefined>;
+    /** Whether the menu item is active. */
+    isActive: Signal<boolean>;
+    /** 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. */
+    expanded: Signal<boolean | null>;
+    /** Whether the menu item is expanded. */
+    _expanded: _angular_core.WritableSignal<boolean>;
+    /** The ID of the menu that the menu item controls. */
+    controls: _angular_core.WritableSignal<string | undefined>;
+    /** The role of the menu item. */
+    role: () => string;
+    /** Whether the menu item has a popup. */
+    hasPopup: Signal<boolean>;
+    /** The submenu associated with the menu item. */
+    submenu: SignalLike<MenuPattern<V> | undefined>;
+    /** Whether the menu item is selectable. */
+    selectable: SignalLike<boolean>;
+    constructor(inputs: MenuItemInputs<V>);
+    /** Opens the submenu. */
+    open(opts?: {
+        first?: boolean;
+        last?: boolean;
+    }): void;
+    /** Closes the submenu. */
+    close(opts?: {
+        refocus?: boolean;
+    }): void;
 }
 
 /** Represents an item that can be expanded or collapsed. */
@@ -1023,7 +936,7 @@ declare class LabelControl {
 }
 
 /** The required inputs to tabs. */
-interface TabInputs extends Omit<ListItem<string>, 'searchTerm' | 'index'>, Omit<ExpansionItem, 'expansionId' | 'expandable'> {
+interface TabInputs extends Omit<ListItem<string>, 'searchTerm' | 'index' | 'selectable'>, Omit<ExpansionItem, 'expansionId' | 'expandable'> {
     /** The parent tablist that controls the tab. */
     tablist: SignalLike<TabListPattern>;
     /** The remote tabpanel controlled by the tab. */
@@ -1043,7 +956,9 @@ 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. */
     readonly searchTerm: () => string;
     /** Whether this tab has expandable content. */
@@ -1056,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);
@@ -1079,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);
@@ -1098,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. */
@@ -1130,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 {
@@ -1171,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. */
@@ -1224,13 +1258,27 @@ interface TreeItemInputs<V> extends Omit<ListItem<V>, 'index'> {
     /** The tree pattern this item belongs to. */
     tree: SignalLike<TreePattern<V>>;
 }
-interface TreeItemPattern<V> extends TreeItemInputs<V> {
-}
 /**
  * Represents an item in a Tree.
  */
-declare class TreeItemPattern<V> implements ExpansionItem {
+declare class TreeItemPattern<V> implements ListItem<V>, ExpansionItem {
     readonly inputs: TreeItemInputs<V>;
+    /** A unique identifier for this item. */
+    readonly id: SignalLike<string>;
+    /** The value of this item. */
+    readonly value: SignalLike<V>;
+    /** A reference to the item element. */
+    readonly element: SignalLike<HTMLElement | undefined>;
+    /** Whether the item is disabled. */
+    readonly disabled: SignalLike<boolean>;
+    /** The text used by the typeahead search. */
+    readonly searchTerm: SignalLike<string>;
+    /** The tree pattern this item belongs to. */
+    readonly tree: SignalLike<TreePattern<V>>;
+    /** The parent item. */
+    readonly parent: SignalLike<TreeItemPattern<V> | TreePattern<V>>;
+    /** The children items. */
+    readonly children: SignalLike<TreeItemPattern<V>[]>;
     /** The position of this item among its siblings. */
     readonly index: _angular_core.Signal<number>;
     /** The unique identifier used by the expansion behavior. */
@@ -1241,24 +1289,26 @@ declare class TreeItemPattern<V> implements ExpansionItem {
     readonly expansion: ExpansionControl;
     /** Whether the item is expandable. It's expandable if children item exist. */
     readonly expandable: SignalLike<boolean>;
+    /** Whether the item is selectable. */
+    readonly selectable: SignalLike<boolean>;
     /** The level of the current item in a tree. */
     readonly level: SignalLike<number>;
     /** 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: _angular_core.Signal<boolean | undefined>;
+    readonly selected: SignalLike<boolean | undefined>;
     /** The current type of this item. */
-    readonly current: _angular_core.Signal<"page" | "step" | "location" | "date" | "time" | "true" | "false" | undefined>;
+    readonly current: SignalLike<string | undefined>;
     constructor(inputs: TreeItemInputs<V>);
 }
 /** The selection operations that the tree can perform. */
@@ -1292,10 +1342,12 @@ declare class TreePattern<V> {
     readonly level: () => number;
     /** The root is always expanded. */
     readonly expanded: () => boolean;
-    /** The tabindex of the tree. */
-    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. */
@@ -1318,6 +1370,34 @@ declare class TreePattern<V> {
     readonly keydown: _angular_core.Signal<KeyboardEventManager<KeyboardEvent>>;
     /** The pointerdown event manager for the tree. */
     pointerdown: _angular_core.Signal<PointerEventManager<PointerEvent>>;
+    /** A unique identifier for the tree. */
+    id: SignalLike<string>;
+    /** Whether the tree is in navigation mode. */
+    nav: SignalLike<boolean>;
+    /** The aria-current type. */
+    currentType: SignalLike<'page' | 'step' | 'location' | 'date' | 'time' | 'true' | 'false'>;
+    /** All items in the tree, in document order (DFS-like, a flattened list). */
+    allItems: SignalLike<TreeItemPattern<V>[]>;
+    /** Whether the tree is disabled. */
+    disabled: SignalLike<boolean>;
+    /** The currently active item in the tree. */
+    activeItem: WritableSignalLike<TreeItemPattern<V> | undefined>;
+    /** 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. */
+    orientation: SignalLike<'vertical' | 'horizontal'>;
+    /** The text direction of the tree. */
+    textDirection: SignalLike<'ltr' | 'rtl'>;
+    /** Whether multiple items can be selected at the same time. */
+    multi: SignalLike<boolean>;
+    /** The selection mode of the tree. */
+    selectionMode: SignalLike<'follow' | 'explicit'>;
+    /** The delay in milliseconds to wait before clearing the typeahead buffer. */
+    typeaheadDelay: SignalLike<number>;
+    /** The current value of the tree (the selected items). */
+    value: WritableSignalLike<V[]>;
     constructor(inputs: TreeInputs<V>);
     /**
      * Sets the tree to it's default initial state.
@@ -1357,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;
@@ -1380,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. */
@@ -1398,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, OptionPattern, RadioButtonPattern, RadioGroupPattern, TabListPattern, TabPanelPattern, TabPattern, ToolbarPattern, ToolbarRadioGroupPattern, ToolbarWidgetGroupPattern, ToolbarWidgetPattern, TreeItemPattern, TreePattern, convertGetterSetterToWritableSignalLike };
-export type { AccordionGroupInputs, AccordionPanelInputs, AccordionTriggerInputs, ComboboxInputs, ComboboxListboxControls, ComboboxListboxInputs, ComboboxTreeControls, ComboboxTreeInputs, ListboxInputs, OptionInputs, RadioButtonInputs, RadioGroupInputs, SignalLike, TabInputs, TabListInputs, TabPanelInputs, ToolbarInputs, ToolbarRadioGroupInputs, ToolbarWidgetGroupControls, ToolbarWidgetGroupInputs, ToolbarWidgetInputs, TreeInputs, TreeItemInputs, WritableSignalLike };
+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 };