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

package/types/private.d.ts

@@ -1,114 +1,9 @@
 import * as _angular_core from '@angular/core';
-import { Signal, OnDestroy } from '@angular/core';
-import { SignalLike, WritableSignalLike, KeyboardEventManager, PointerEventManager } from './_grid-chunk.js';
+import { Signal, WritableSignal, OnDestroy } from '@angular/core';
+import { ListFocusItem, SignalLike, ListFocusInputs, WritableSignalLike, ListFocus, ListNavigationItem, ListNavigationInputs, ListNavigation, 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 | undefined>;
-    /** Whether an item is disabled. */
-    disabled: SignalLike<boolean>;
-    /** The index of the item in the list. */
-    index: SignalLike<number>;
-}
-/** Represents the required inputs for a collection that contains focusable items. */
-interface ListFocusInputs<T extends ListFocusItem> {
-    /** The focus strategy used by the list. */
-    focusMode: SignalLike<'roving' | 'activedescendant'>;
-    /** Whether the list is disabled. */
-    disabled: SignalLike<boolean>;
-    /** The items in the list. */
-    items: SignalLike<T[]>;
-    /** The active item. */
-    activeItem: WritableSignalLike<T | undefined>;
-    /** Whether disabled items in the list should be focusable. */
-    softDisabled: SignalLike<boolean>;
-    element: SignalLike<HTMLElement | undefined>;
-}
-/** Controls focus for a list of items. */
-declare class ListFocus<T extends ListFocusItem> {
-    readonly inputs: ListFocusInputs<T>;
-    /** The last item that was active. */
-    prevActiveItem: _angular_core.WritableSignal<T | undefined>;
-    /** The index of the last item that was active. */
-    prevActiveIndex: _angular_core.Signal<number>;
-    /** The current active index in the list. */
-    activeIndex: _angular_core.Signal<number>;
-    constructor(inputs: ListFocusInputs<T>);
-    /** Whether the list is in a disabled state. */
-    isListDisabled(): boolean;
-    /** The id of the current active item. */
-    getActiveDescendant(): string | undefined;
-    /** 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;
-    }): boolean;
-    /** Returns true if the given item can be navigated to. */
-    isFocusable(item: T): boolean;
-}
-
-/** Represents an item in a collection, such as a listbox option, than can be navigated to. */
-interface ListNavigationItem extends ListFocusItem {
-}
-/** Represents the required inputs for a collection that has navigable items. */
-interface ListNavigationInputs<T extends ListNavigationItem> extends ListFocusInputs<T> {
-    /** Whether focus should wrap when navigating. */
-    wrap: SignalLike<boolean>;
-    /** Whether the list is vertically or horizontally oriented. */
-    orientation: SignalLike<'vertical' | 'horizontal'>;
-    /** The direction that text is read based on the users locale. */
-    textDirection: SignalLike<'rtl' | 'ltr'>;
-}
-/** Controls navigation for a list of items. */
-declare class ListNavigation<T extends ListNavigationItem> {
-    readonly inputs: ListNavigationInputs<T> & {
-        focusManager: ListFocus<T>;
-    };
-    constructor(inputs: ListNavigationInputs<T> & {
-        focusManager: ListFocus<T>;
-    });
-    /** Navigates to the given item. */
-    goto(item?: T, opts?: {
-        focusElement?: boolean;
-    }): boolean;
-    /** Navigates to the next item in the list. */
-    next(opts?: {
-        focusElement?: boolean;
-    }): boolean;
-    /** Peeks the next item in the list. */
-    peekNext(): T | undefined;
-    /** Navigates to the previous item in the list. */
-    prev(opts?: {
-        focusElement?: boolean;
-    }): boolean;
-    /** Peeks the previous item in the list. */
-    peekPrev(): T | undefined;
-    /** Navigates to the first item in the list. */
-    first(opts?: {
-        focusElement?: boolean;
-    }): boolean;
-    /** Navigates to the last item in the list. */
-    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. */
-    private _peek;
-}
-
-/** Represents an item in a collection, such as a listbox option, than can be selected. */
+/** Represents an item in a collection, such as a listbox option, that can be selected. */
 interface ListSelectionItem<V> extends ListFocusItem {
     /** The value of the item. */
     value: SignalLike<V>;
@@ -120,7 +15,7 @@ interface ListSelectionInputs<T extends ListSelectionItem<V>, V> extends ListFoc
     /** Whether multiple items in the list can be selected at once. */
     multi: SignalLike<boolean>;
     /** The current value of the list selection. */
-    value: WritableSignalLike<V[]>;
+    values: WritableSignalLike<V[]>;
     /** The selection strategy used by the list. */
     selectionMode: SignalLike<'follow' | 'explicit'>;
 }
@@ -318,7 +213,7 @@ declare class List<T extends ListItem<V>, V> {
 /** Represents the required inputs for a combobox. */
 interface ComboboxInputs<T extends ListItem<V>, V> {
     /** The controls for the popup associated with the combobox. */
-    popupControls: SignalLike<ComboboxListboxControls<T, V> | ComboboxTreeControls<T, V> | undefined>;
+    popupControls: SignalLike<ComboboxListboxControls<T, V> | ComboboxTreeControls<T, V> | ComboboxDialogPattern | undefined>;
     /** The HTML input element that serves as the combobox input. */
     inputEl: SignalLike<HTMLInputElement | undefined>;
     /** The HTML element that serves as the combobox container. */
@@ -335,6 +230,8 @@ interface ComboboxInputs<T extends ListItem<V>, V> {
     readonly: SignalLike<boolean>;
     /** Whether the combobox is in a right-to-left context. */
     textDirection: SignalLike<'rtl' | 'ltr'>;
+    /** Whether the combobox is always expanded. */
+    alwaysExpanded: SignalLike<boolean>;
 }
 /** An interface that allows combobox popups to expose the necessary controls for the combobox. */
 interface ComboboxListboxControls<T extends ListItem<V>, V> {
@@ -370,6 +267,8 @@ interface ComboboxListboxControls<T extends ListItem<V>, V> {
     unfocus: () => void;
     /** Returns the item corresponding to the given event. */
     getItem: (e: PointerEvent) => T | undefined;
+    /** Returns the currently active (focused) item in the popup. */
+    getActiveItem: () => T | undefined;
     /** Returns the currently selected items in the popup. */
     getSelectedItems: () => T[];
     /** Sets the value of the combobox based on the selected item. */
@@ -398,6 +297,8 @@ declare class ComboboxPattern<T extends ListItem<V>, V> {
     readonly inputs: ComboboxInputs<T, V>;
     /** Whether the combobox is expanded. */
     expanded: _angular_core.WritableSignal<boolean>;
+    /** Whether the combobox is disabled. */
+    disabled: () => boolean;
     /** The ID of the active item in the combobox. */
     activeDescendant: _angular_core.Signal<string | null>;
     /** The currently highlighted item in the combobox. */
@@ -406,6 +307,8 @@ declare class ComboboxPattern<T extends ListItem<V>, V> {
     isDeleting: boolean;
     /** Whether the combobox is focused. */
     isFocused: _angular_core.WritableSignal<boolean>;
+    /** Whether the combobox has ever been focused. */
+    hasBeenFocused: _angular_core.WritableSignal<boolean>;
     /** The key used to navigate to the previous item in the list. */
     expandKey: _angular_core.Signal<"ArrowLeft" | "ArrowRight">;
     /** The key used to navigate to the next item in the list. */
@@ -415,18 +318,22 @@ declare class ComboboxPattern<T extends ListItem<V>, V> {
     /** 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>;
+    hasPopup: _angular_core.Signal<"listbox" | "tree" | "grid" | "dialog" | null>;
     /** Whether the combobox is read-only. */
     readonly: _angular_core.Signal<true | null>;
+    /** Returns the listbox controls for the combobox. */
+    listControls: () => ComboboxListboxControls<T, V> | null | undefined;
+    /** Returns the tree controls for the combobox. */
+    treeControls: () => ComboboxTreeControls<T, V> | null;
     /** The keydown event manager for the combobox. */
     keydown: _angular_core.Signal<KeyboardEventManager<KeyboardEvent>>;
-    /** The pointerup event manager for the combobox. */
-    pointerup: _angular_core.Signal<PointerEventManager<PointerEvent>>;
+    /** The click event manager for the combobox. */
+    click: _angular_core.Signal<PointerEventManager<PointerEvent>>;
     constructor(inputs: ComboboxInputs<T, V>);
     /** Handles keydown events for the combobox. */
     onKeydown(event: KeyboardEvent): void;
-    /** Handles pointerup events for the combobox. */
-    onPointerup(event: PointerEvent): void;
+    /** Handles click events for the combobox. */
+    onClick(event: MouseEvent): void;
     /** Handles input events for the combobox. */
     onInput(event: Event): void;
     /** Handles focus in events for the combobox. */
@@ -472,6 +379,23 @@ declare class ComboboxPattern<T extends ListItem<V>, V> {
     /** Navigates and handles additional actions based on filter mode. */
     private _navigate;
 }
+declare class ComboboxDialogPattern {
+    readonly inputs: {
+        combobox: ComboboxPattern<any, any>;
+        element: SignalLike<HTMLDialogElement>;
+        id: SignalLike<string>;
+    };
+    id: () => string;
+    role: () => "dialog";
+    keydown: _angular_core.Signal<KeyboardEventManager<KeyboardEvent>>;
+    constructor(inputs: {
+        combobox: ComboboxPattern<any, any>;
+        element: SignalLike<HTMLDialogElement>;
+        id: SignalLike<string>;
+    });
+    onKeydown(event: KeyboardEvent): void;
+    onClick(event: MouseEvent): void;
+}
 
 /**
  * Represents the properties exposed by a listbox that need to be accessed by an option.
@@ -602,6 +526,8 @@ declare class ComboboxListboxPattern<V> extends ListboxPattern<V> implements Com
     focus: (item: OptionPattern<V>, opts?: {
         focusElement?: boolean;
     }) => void;
+    /** Navigates to the previous focusable item in the listbox. */
+    getActiveItem: () => OptionPattern<V> | undefined;
     /** Navigates to the next focusable item in the listbox. */
     next: () => void;
     /** Navigates to the previous focusable item in the listbox. */
@@ -627,7 +553,7 @@ declare class ComboboxListboxPattern<V> extends ListboxPattern<V> implements Com
 }
 
 /** The inputs for the MenuBarPattern class. */
-interface MenuBarInputs<V> extends Omit<ListInputs<MenuItemPattern<V>, V>, 'disabled'> {
+interface MenuBarInputs<V> extends ListInputs<MenuItemPattern<V>, V> {
     /** The menu items contained in the menu. */
     items: SignalLike<MenuItemPattern<V>[]>;
     /** Callback function triggered when a menu item is selected. */
@@ -636,7 +562,7 @@ interface MenuBarInputs<V> extends Omit<ListInputs<MenuItemPattern<V>, V>, 'disa
     textDirection: SignalLike<'ltr' | 'rtl'>;
 }
 /** The inputs for the MenuPattern class. */
-interface MenuInputs<V> extends Omit<ListInputs<MenuItemPattern<V>, V>, 'value' | 'disabled'> {
+interface MenuInputs<V> extends Omit<ListInputs<MenuItemPattern<V>, V>, 'values'> {
     /** The unique ID of the menu. */
     id: SignalLike<string>;
     /** The menu items contained in the menu. */
@@ -647,6 +573,8 @@ interface MenuInputs<V> extends Omit<ListInputs<MenuItemPattern<V>, V>, 'value'
     onSelect?: (value: V) => void;
     /** The text direction of the menu bar. */
     textDirection: SignalLike<'ltr' | 'rtl'>;
+    /** The delay in milliseconds before expanding sub-menus on hover. */
+    expansionDelay: SignalLike<number>;
 }
 /** The inputs for the MenuTriggerPattern class. */
 interface MenuTriggerInputs<V> {
@@ -656,6 +584,8 @@ interface MenuTriggerInputs<V> {
     menu: SignalLike<MenuPattern<V> | undefined>;
     /** The text direction of the menu bar. */
     textDirection: SignalLike<'ltr' | 'rtl'>;
+    /** Whether the menu trigger is disabled. */
+    disabled: SignalLike<boolean>;
 }
 /** The inputs for the MenuItemPattern class. */
 interface MenuItemInputs<V> extends Omit<ListItem<V>, 'index' | 'selectable'> {
@@ -671,14 +601,22 @@ declare class MenuPattern<V> {
     id: SignalLike<string>;
     /** The role of the menu. */
     role: () => string;
+    /** Whether the menu is disabled. */
+    disabled: () => boolean;
     /** Whether the menu is visible. */
-    isVisible: Signal<boolean>;
+    visible: 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>;
+    /** Timeout used to open sub-menus on hover. */
+    _openTimeout: any;
+    /** Timeout used to close sub-menus on hover out. */
+    _closeTimeout: any;
+    /** The tab index of the menu. */
+    tabIndex: () => 0 | -1;
     /** Whether the menu should be focused on mouse over. */
     shouldFocus: Signal<boolean>;
     /** The key used to expand sub-menus. */
@@ -700,6 +638,10 @@ declare class MenuPattern<V> {
     onKeydown(event: KeyboardEvent): void;
     /** Handles mouseover events for the menu. */
     onMouseOver(event: MouseEvent): void;
+    /** Closes the specified menu item after a delay. */
+    private _closeItem;
+    /** Opens the specified menu item after a delay. */
+    private _openItem;
     /** Handles mouseout events for the menu. */
     onMouseOut(event: MouseEvent): void;
     /** Handles click events for the menu. */
@@ -724,14 +666,24 @@ declare class MenuPattern<V> {
     collapse(): void;
     /** Expands the current menu or focuses the next item in the menubar. */
     expand(): void;
+    /** Closes the menu. */
+    close(): void;
     /** Closes the menu and all parent menus. */
     closeAll(): void;
+    /** Clears any open or close timeouts for sub-menus. */
+    _clearTimeouts(): void;
+    /** Clears the open timeout. */
+    _clearOpenTimeout(): void;
+    /** Clears the close timeout. */
+    _clearCloseTimeout(): void;
 }
 /** 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 tab index of the menu. */
+    tabIndex: () => 0 | -1;
     /** The key used to navigate to the next item. */
     private _nextKey;
     /** The key used to navigate to the previous item. */
@@ -744,6 +696,8 @@ declare class MenuBarPattern<V> {
     isFocused: _angular_core.WritableSignal<boolean>;
     /** Whether the menubar has been focused. */
     hasBeenFocused: _angular_core.WritableSignal<boolean>;
+    /** Whether the menubar is disabled. */
+    disabled: () => boolean;
     /** Handles keyboard events for the menu. */
     keydownManager: Signal<KeyboardEventManager<KeyboardEvent>>;
     constructor(inputs: MenuBarInputs<V>);
@@ -775,6 +729,8 @@ declare class MenuTriggerPattern<V> {
     readonly inputs: MenuTriggerInputs<V>;
     /** Whether the menu is expanded. */
     expanded: _angular_core.WritableSignal<boolean>;
+    /** Whether the menu trigger has received focus. */
+    hasBeenFocused: _angular_core.WritableSignal<boolean>;
     /** The role of the menu trigger. */
     role: () => string;
     /** Whether the menu trigger has a popup. */
@@ -783,6 +739,8 @@ declare class MenuTriggerPattern<V> {
     menu: SignalLike<MenuPattern<V> | undefined>;
     /** The tab index of the menu trigger. */
     tabIndex: Signal<-1 | 0>;
+    /** Whether the menu trigger is disabled. */
+    disabled: () => boolean;
     /** Handles keyboard events for the menu trigger. */
     keydownManager: Signal<KeyboardEventManager<KeyboardEvent>>;
     constructor(inputs: MenuTriggerInputs<V>);
@@ -790,6 +748,8 @@ declare class MenuTriggerPattern<V> {
     onKeydown(event: KeyboardEvent): void;
     /** Handles click events for the menu trigger. */
     onClick(): void;
+    /** Handles focusin events for the menu trigger. */
+    onFocusIn(): void;
     /** Handles focusout events for the menu trigger. */
     onFocusOut(event: FocusEvent): void;
     /** Opens the menu. */
@@ -810,13 +770,15 @@ declare class MenuItemPattern<V> implements ListItem<V> {
     /** The unique ID of the menu item. */
     id: SignalLike<string>;
     /** Whether the menu item is disabled. */
-    disabled: SignalLike<boolean>;
+    disabled: () => 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>;
+    active: Signal<boolean>;
+    /** Whether the menu item has received focus. */
+    hasBeenFocused: _angular_core.WritableSignal<boolean>;
     /** The tab index of the menu item. */
     tabIndex: Signal<0 | -1>;
     /** The position of the menu item in the menu. */
@@ -845,47 +807,23 @@ declare class MenuItemPattern<V> implements ListItem<V> {
     close(opts?: {
         refocus?: boolean;
     }): void;
+    /** Handles focusin events for the menu item. */
+    onFocusIn(): void;
 }
 
 /** Represents an item that can be expanded or collapsed. */
 interface ExpansionItem {
     /** Whether the item is expandable. */
     expandable: SignalLike<boolean>;
-    /** Used to uniquely identify an expansion item. */
-    expansionId: SignalLike<string>;
+    /** Whether the item is expanded. */
+    expanded: WritableSignalLike<boolean>;
     /** Whether the expansion is disabled. */
     disabled: SignalLike<boolean>;
 }
-interface ExpansionControl extends ExpansionItem {
-}
-/**
- * Controls a single item's expansion state and interactions,
- * delegating actual state changes to an Expansion manager.
- */
-declare class ExpansionControl {
-    readonly inputs: ExpansionItem & {
-        expansionManager: ListExpansion;
-    };
-    /** Whether this specific item is currently expanded. Derived from the Expansion manager. */
-    readonly isExpanded: _angular_core.Signal<boolean>;
-    /** Whether this item can be expanded. */
-    readonly isExpandable: _angular_core.Signal<boolean>;
-    constructor(inputs: ExpansionItem & {
-        expansionManager: ListExpansion;
-    });
-    /** Requests the Expansion manager to open this item. */
-    open(): void;
-    /** Requests the Expansion manager to close this item. */
-    close(): void;
-    /** Requests the Expansion manager to toggle this item. */
-    toggle(): void;
-}
 /** Represents the required inputs for an expansion behavior. */
 interface ListExpansionInputs {
     /** Whether multiple items can be expanded at once. */
     multiExpandable: SignalLike<boolean>;
-    /** An array of ids of the currently expanded items. */
-    expandedIds: WritableSignalLike<string[]>;
     /** An array of expansion items. */
     items: SignalLike<ExpansionItem[]>;
     /** Whether all expansions are disabled. */
@@ -894,23 +832,19 @@ interface ListExpansionInputs {
 /** Manages the expansion state of a list of items. */
 declare class ListExpansion {
     readonly inputs: ListExpansionInputs;
-    /** A signal holding an array of ids of the currently expanded items. */
-    expandedIds: WritableSignalLike<string[]>;
     constructor(inputs: ListExpansionInputs);
     /** Opens the specified item. */
-    open(item: ExpansionItem): void;
+    open(item: ExpansionItem): boolean;
     /** Closes the specified item. */
-    close(item: ExpansionItem): void;
+    close(item: ExpansionItem): boolean;
     /** Toggles the expansion state of the specified item. */
-    toggle(item: ExpansionItem): void;
+    toggle(item: ExpansionItem): boolean;
     /** Opens all focusable items in the list. */
     openAll(): void;
     /** Closes all focusable items in the list. */
     closeAll(): void;
     /** Checks whether the specified item is expandable / collapsible. */
     isExpandable(item: ExpansionItem): boolean;
-    /** Checks whether the specified item is currently expanded. */
-    isExpanded(item: ExpansionItem): boolean;
 }
 
 /** Represents the required inputs for the label control. */
@@ -936,37 +870,31 @@ declare class LabelControl {
 }
 
 /** The required inputs to tabs. */
-interface TabInputs extends Omit<ListItem<string>, 'searchTerm' | 'index' | 'selectable'>, Omit<ExpansionItem, 'expansionId' | 'expandable'> {
+interface TabInputs extends Omit<ListNavigationItem, 'index'>, Omit<ExpansionItem, 'expandable'> {
     /** The parent tablist that controls the tab. */
     tablist: SignalLike<TabListPattern>;
     /** The remote tabpanel controlled by the tab. */
     tabpanel: SignalLike<TabPanelPattern | undefined>;
+    /** The remote tabpanel unique identifier. */
+    value: SignalLike<string>;
 }
 /** A tab in a tablist. */
 declare class TabPattern {
     readonly inputs: TabInputs;
-    /** Controls expansion for this tab. */
-    readonly expansion: ExpansionControl;
     /** A global unique identifier for the tab. */
     readonly id: SignalLike<string>;
     /** The index of the tab. */
     readonly index: _angular_core.Signal<number>;
-    /** A local unique identifier for the tab. */
+    /** The remote tabpanel unique identifier. */
     readonly value: SignalLike<string>;
     /** Whether the tab is disabled. */
     readonly disabled: SignalLike<boolean>;
     /** The html element that should receive focus. */
-    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. */
-    readonly expandable: _angular_core.Signal<boolean>;
-    /** The unique identifier used by the expansion behavior. */
-    readonly expansionId: _angular_core.Signal<string>;
-    /** Whether the tab is expanded. */
-    readonly expanded: _angular_core.Signal<boolean>;
+    readonly element: SignalLike<HTMLElement>;
+    /** Whether this tab has expandable panel. */
+    readonly expandable: SignalLike<boolean>;
+    /** Whether the tab panel is expanded. */
+    readonly expanded: WritableSignalLike<boolean>;
     /** Whether the tab is active. */
     readonly active: _angular_core.Signal<boolean>;
     /** Whether the tab is selected. */
@@ -976,11 +904,16 @@ declare class TabPattern {
     /** The id of the tabpanel associated with the tab. */
     readonly controls: _angular_core.Signal<string | undefined>;
     constructor(inputs: TabInputs);
+    /** Opens the tab. */
+    open(): boolean;
 }
 /** The required inputs for the tabpanel. */
 interface TabPanelInputs extends LabelControlOptionalInputs {
+    /** A global unique identifier for the tabpanel. */
     id: SignalLike<string>;
+    /** The tab that controls this tabpanel. */
     tab: SignalLike<TabPattern | undefined>;
+    /** A local unique identifier for the tabpanel. */
     value: SignalLike<string>;
 }
 /** A tabpanel associated with a tab. */
@@ -995,20 +928,29 @@ declare class TabPanelPattern {
     /** Whether the tabpanel is hidden. */
     readonly hidden: _angular_core.Signal<boolean>;
     /** The tab index of this tabpanel. */
-    readonly tabIndex: _angular_core.Signal<0 | -1>;
+    readonly tabIndex: _angular_core.Signal<-1 | 0>;
     /** The aria-labelledby value for this tabpanel. */
     readonly labelledBy: _angular_core.Signal<string | undefined>;
     constructor(inputs: TabPanelInputs);
 }
 /** The required inputs for the tablist. */
-type TabListInputs = Omit<ListInputs<TabPattern, string>, 'multi' | 'typeaheadDelay'> & Omit<ListExpansionInputs, 'multiExpandable' | 'expandedIds' | 'items'>;
+interface TabListInputs extends Omit<ListNavigationInputs<TabPattern>, 'multi'>, Omit<ListExpansionInputs, 'multiExpandable' | 'items'> {
+    /** The selection strategy used by the tablist. */
+    selectionMode: SignalLike<'follow' | 'explicit'>;
+}
 /** Controls the state of a tablist. */
 declare class TabListPattern {
     readonly inputs: TabListInputs;
-    /** The list behavior for the tablist. */
-    readonly listBehavior: List<TabPattern, string>;
+    /** The list focus behavior for the tablist. */
+    readonly focusBehavior: ListFocus<TabPattern>;
+    /** The list navigation behavior for the tablist. */
+    readonly navigationBehavior: ListNavigation<TabPattern>;
     /** Controls expansion for the tablist. */
-    readonly expansionManager: ListExpansion;
+    readonly expansionBehavior: ListExpansion;
+    /** The currently active tab. */
+    readonly activeTab: SignalLike<TabPattern | undefined>;
+    /** The currently selected tab. */
+    readonly selectedTab: WritableSignal<TabPattern | undefined>;
     /** Whether the tablist is vertically or horizontally oriented. */
     readonly orientation: SignalLike<'vertical' | 'horizontal'>;
     /** Whether the tablist is disabled. */
@@ -1041,6 +983,12 @@ declare class TabListPattern {
     onKeydown(event: KeyboardEvent): void;
     /** The pointerdown event manager for the tablist. */
     onPointerdown(event: PointerEvent): void;
+    /** Opens the tab by given value. */
+    open(value: string): boolean;
+    /** Opens the given tab or the current active tab. */
+    open(tab?: TabPattern): boolean;
+    /** Executes a navigation operation and expand the active tab if needed. */
+    private _navigate;
     /** Returns the tab item associated with the given pointer event. */
     private _getItem;
 }
@@ -1109,7 +1057,7 @@ declare class ToolbarWidgetPattern<V> implements ListItem<V> {
 }
 
 /** Represents the required inputs for a toolbar. */
-type ToolbarInputs<V> = Omit<ListInputs<ToolbarWidgetPattern<V>, V>, 'multi' | 'typeaheadDelay' | 'value' | 'selectionMode' | 'focusMode'> & {
+type ToolbarInputs<V> = Omit<ListInputs<ToolbarWidgetPattern<V>, V>, 'multi' | 'typeaheadDelay' | 'selectionMode' | 'focusMode'> & {
     /** A function that returns the toolbar item associated with a given element. */
     getItem: (e: Element) => ToolbarWidgetPattern<V> | undefined;
 };
@@ -1165,53 +1113,20 @@ declare class ToolbarPattern<V> {
 }
 
 /** Inputs of the AccordionGroupPattern. */
-type AccordionGroupInputs = Omit<ListNavigationInputs<AccordionTriggerPattern> & ListFocusInputs<AccordionTriggerPattern> & Omit<ListExpansionInputs, 'items'>, 'focusMode'>;
-interface AccordionGroupPattern extends AccordionGroupInputs {
+interface AccordionGroupInputs extends Omit<ListNavigationInputs<AccordionTriggerPattern> & ListFocusInputs<AccordionTriggerPattern> & Omit<ListExpansionInputs, 'items'>, 'focusMode'> {
+    /** A function that returns the trigger associated with a given element. */
+    getItem: (e: Element | null | undefined) => AccordionTriggerPattern | undefined;
 }
 /** A pattern controls the nested Accordions. */
 declare class AccordionGroupPattern {
     readonly inputs: AccordionGroupInputs;
     /** Controls navigation for the group. */
-    navigation: ListNavigation<AccordionTriggerPattern>;
+    readonly navigationBehavior: ListNavigation<AccordionTriggerPattern>;
     /** Controls focus for the group. */
-    focusManager: ListFocus<AccordionTriggerPattern>;
+    readonly focusBehavior: ListFocus<AccordionTriggerPattern>;
     /** Controls expansion for the group. */
-    expansionManager: ListExpansion;
+    readonly expansionBehavior: ListExpansion;
     constructor(inputs: AccordionGroupInputs);
-}
-/** Inputs for the AccordionTriggerPattern. */
-type AccordionTriggerInputs = Omit<ListNavigationItem & ListFocusItem, 'index'> & Omit<ExpansionItem, 'expansionId' | 'expandable'> & {
-    /** A local unique identifier for the trigger. */
-    value: SignalLike<string>;
-    /** The parent accordion group that controls this trigger. */
-    accordionGroup: SignalLike<AccordionGroupPattern>;
-    /** The accordion panel controlled by this trigger. */
-    accordionPanel: SignalLike<AccordionPanelPattern | undefined>;
-};
-interface AccordionTriggerPattern extends AccordionTriggerInputs {
-}
-/** A pattern controls the expansion state of an accordion. */
-declare class AccordionTriggerPattern {
-    readonly inputs: AccordionTriggerInputs;
-    /** Whether this tab has expandable content. */
-    expandable: SignalLike<boolean>;
-    /** The unique identifier used by the expansion behavior. */
-    expansionId: SignalLike<string>;
-    /** Whether an accordion is expanded. */
-    expanded: SignalLike<boolean>;
-    /** Controls the expansion state for the trigger. */
-    expansionControl: ExpansionControl;
-    /** Whether the trigger is active. */
-    active: _angular_core.Signal<boolean>;
-    /** Id of the accordion panel controlled by the trigger. */
-    controls: _angular_core.Signal<string | undefined>;
-    /** 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. */
-    index: _angular_core.Signal<number>;
-    constructor(inputs: AccordionTriggerInputs);
     /** The key used to navigate to the previous accordion trigger. */
     prevKey: _angular_core.Signal<"ArrowUp" | "ArrowRight" | "ArrowLeft">;
     /** The key used to navigate to the next accordion trigger. */
@@ -1226,29 +1141,72 @@ declare class AccordionTriggerPattern {
     onPointerdown(event: PointerEvent): void;
     /** Handles focus events on the trigger. This ensures the tabbing changes the active index. */
     onFocus(event: FocusEvent): void;
-    private _getItem;
+    /** Toggles the expansion state of the active accordion item. */
+    toggle(): void;
+}
+/** Inputs for the AccordionTriggerPattern. */
+interface AccordionTriggerInputs extends Omit<ListNavigationItem & ListFocusItem, 'index'>, Omit<ExpansionItem, 'expandable'> {
+    /** A local unique identifier for the trigger's corresponding panel. */
+    panelId: SignalLike<string>;
+    /** The parent accordion group that controls this trigger. */
+    accordionGroup: SignalLike<AccordionGroupPattern>;
+    /** The accordion panel controlled by this trigger. */
+    accordionPanel: SignalLike<AccordionPanelPattern | undefined>;
+}
+/** A pattern controls the expansion state of an accordion. */
+declare class AccordionTriggerPattern implements ListNavigationItem, ListFocusItem, ExpansionItem {
+    readonly inputs: AccordionTriggerInputs;
+    /** A unique identifier for this trigger. */
+    readonly id: SignalLike<string>;
+    /** A reference to the trigger element. */
+    readonly element: SignalLike<HTMLElement>;
+    /** Whether this trigger has expandable panel. */
+    readonly expandable: SignalLike<boolean>;
+    /** Whether the corresponding panel is expanded. */
+    readonly expanded: WritableSignalLike<boolean>;
+    /** Whether the trigger is active. */
+    readonly active: _angular_core.Signal<boolean>;
+    /** Id of the accordion panel controlled by the trigger. */
+    readonly controls: _angular_core.Signal<string | undefined>;
+    /** The tabindex of the trigger. */
+    readonly tabIndex: _angular_core.Signal<-1 | 0>;
+    /** Whether the trigger is disabled. Disabling an accordion group disables all the triggers. */
+    readonly disabled: _angular_core.Signal<boolean>;
+    /** Whether the trigger is hard disabled.  */
+    readonly hardDisabled: _angular_core.Signal<boolean>;
+    /** The index of the trigger within its accordion group. */
+    readonly index: _angular_core.Signal<number>;
+    constructor(inputs: AccordionTriggerInputs);
+    /** Opens the accordion panel. */
+    open(): void;
+    /** Closes the accordion panel. */
+    close(): void;
+    /** Toggles the accordion panel. */
+    toggle(): void;
 }
 /** Represents the required inputs for the AccordionPanelPattern. */
 interface AccordionPanelInputs {
     /** A global unique identifier for the panel. */
     id: SignalLike<string>;
-    /** A local unique identifier for the panel, matching its trigger's value. */
-    value: SignalLike<string>;
+    /** A local unique identifier for the panel, matching its trigger's panelId. */
+    panelId: SignalLike<string>;
     /** The parent accordion trigger that controls this panel. */
     accordionTrigger: SignalLike<AccordionTriggerPattern | undefined>;
 }
-interface AccordionPanelPattern extends AccordionPanelInputs {
-}
 /** Represents an accordion panel. */
 declare class AccordionPanelPattern {
     readonly inputs: AccordionPanelInputs;
+    /** A global unique identifier for the panel. */
+    id: SignalLike<string>;
+    /** The parent accordion trigger that controls this panel. */
+    accordionTrigger: SignalLike<AccordionTriggerPattern | undefined>;
     /** Whether the accordion panel is hidden. True if the associated trigger is not expanded. */
     hidden: SignalLike<boolean>;
     constructor(inputs: AccordionPanelInputs);
 }
 
 /** Represents the required inputs for a tree item. */
-interface TreeItemInputs<V> extends Omit<ListItem<V>, 'index'> {
+interface TreeItemInputs<V> extends Omit<ListItem<V>, 'index'>, Omit<ExpansionItem, 'expandable'> {
     /** The parent item. */
     parent: SignalLike<TreeItemPattern<V> | TreePattern<V>>;
     /** Whether this item has children. Children can be lazily loaded. */
@@ -1268,7 +1226,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 | undefined>;
+    readonly element: SignalLike<HTMLElement>;
     /** Whether the item is disabled. */
     readonly disabled: SignalLike<boolean>;
     /** The text used by the typeahead search. */
@@ -1281,20 +1239,16 @@ declare class TreeItemPattern<V> implements ListItem<V>, ExpansionItem {
     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. */
-    readonly expansionId: SignalLike<string>;
     /** Controls expansion for child items. */
-    readonly expansionManager: ListExpansion;
-    /** Controls expansion for this item. */
-    readonly expansion: ExpansionControl;
+    readonly expansionBehavior: ListExpansion;
     /** 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>;
+    /** Whether the item is expanded. */
+    readonly expanded: WritableSignalLike<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: SignalLike<boolean>;
     /** The number of items under the same parent at the same level. */
@@ -1329,20 +1283,18 @@ interface TreeInputs<V> extends Omit<ListInputs<TreeItemPattern<V>, V>, 'items'>
     /** The aria-current type. */
     currentType: SignalLike<'page' | 'step' | 'location' | 'date' | 'time' | 'true' | 'false'>;
 }
-interface TreePattern<V> extends TreeInputs<V> {
-}
 /** Controls the state and interactions of a tree view. */
-declare class TreePattern<V> {
+declare class TreePattern<V> implements TreeInputs<V> {
     readonly inputs: TreeInputs<V>;
     /** The list behavior for the tree. */
     readonly listBehavior: List<TreeItemPattern<V>, V>;
     /** Controls expansion for direct children of the tree root (top-level items). */
-    readonly expansionManager: ListExpansion;
+    readonly expansionBehavior: ListExpansion;
     /** The root level is 0. */
     readonly level: () => number;
     /** The root is always expanded. */
     readonly expanded: () => boolean;
-    /** The roow is always visible. */
+    /** The root is always visible. */
     readonly visible: () => boolean;
     /** The tab index of the tree. */
     readonly tabIndex: SignalLike<-1 | 0>;
@@ -1354,6 +1306,8 @@ declare class TreePattern<V> {
     readonly visibleItems: _angular_core.Signal<TreeItemPattern<V>[]>;
     /** Whether the tree selection follows focus. */
     readonly followFocus: _angular_core.Signal<boolean>;
+    /** Whether the tree direction is RTL. */
+    readonly isRtl: _angular_core.Signal<boolean>;
     /** The key for navigating to the previous item. */
     readonly prevKey: _angular_core.Signal<"ArrowUp" | "ArrowRight" | "ArrowLeft">;
     /** The key for navigating to the next item. */
@@ -1371,33 +1325,37 @@ declare class TreePattern<V> {
     /** The pointerdown event manager for the tree. */
     pointerdown: _angular_core.Signal<PointerEventManager<PointerEvent>>;
     /** A unique identifier for the tree. */
-    id: SignalLike<string>;
+    readonly id: SignalLike<string>;
+    /** The host native element. */
+    readonly element: SignalLike<HTMLElement>;
     /** Whether the tree is in navigation mode. */
-    nav: SignalLike<boolean>;
+    readonly nav: SignalLike<boolean>;
     /** The aria-current type. */
-    currentType: SignalLike<'page' | 'step' | 'location' | 'date' | 'time' | 'true' | 'false'>;
+    readonly 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>[]>;
+    readonly allItems: SignalLike<TreeItemPattern<V>[]>;
+    /** The focus strategy used by the tree. */
+    readonly focusMode: SignalLike<'roving' | 'activedescendant'>;
     /** Whether the tree is disabled. */
-    disabled: SignalLike<boolean>;
+    readonly disabled: SignalLike<boolean>;
     /** The currently active item in the tree. */
-    activeItem: WritableSignalLike<TreeItemPattern<V> | undefined>;
+    readonly activeItem: WritableSignalLike<TreeItemPattern<V> | undefined>;
     /** Whether disabled items should be focusable. */
-    softDisabled: SignalLike<boolean>;
+    readonly softDisabled: SignalLike<boolean>;
     /** Whether the focus should wrap when navigating past the first or last item. */
-    wrap: SignalLike<boolean>;
+    readonly wrap: SignalLike<boolean>;
     /** The orientation of the tree. */
-    orientation: SignalLike<'vertical' | 'horizontal'>;
+    readonly orientation: SignalLike<'vertical' | 'horizontal'>;
     /** The text direction of the tree. */
-    textDirection: SignalLike<'ltr' | 'rtl'>;
+    readonly textDirection: SignalLike<'ltr' | 'rtl'>;
     /** Whether multiple items can be selected at the same time. */
-    multi: SignalLike<boolean>;
+    readonly multi: SignalLike<boolean>;
     /** The selection mode of the tree. */
-    selectionMode: SignalLike<'follow' | 'explicit'>;
+    readonly 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[]>;
+    readonly typeaheadDelay: SignalLike<number>;
+    /** The current selected items of the tree. */
+    readonly values: WritableSignalLike<V[]>;
     constructor(inputs: TreeInputs<V>);
     /**
      * Sets the tree to it's default initial state.
@@ -1435,6 +1393,8 @@ declare class ComboboxTreePattern<V> extends TreePattern<V> implements ComboboxT
     /** The ARIA role for the tree. */
     role: () => "tree";
     activeId: _angular_core.Signal<string | undefined>;
+    /** Returns the currently active (focused) item in the tree. */
+    getActiveItem: () => TreeItemPattern<V> | undefined;
     /** The list of items in the tree. */
     items: _angular_core.Signal<TreeItemPattern<V>[]>;
     /** The tab index for the tree. Always -1 because the combobox handles focus. */
@@ -1522,5 +1482,5 @@ declare class DeferredContent implements OnDestroy {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<DeferredContent, never, never, {}, {}, never, never, true, never>;
 }
 
-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 { AccordionGroupPattern, AccordionPanelPattern, AccordionTriggerPattern, ComboboxDialogPattern, 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 };