@angular/aria 22.0.0-next.7 → 22.0.0-rc.0

package/types/tabs.d.ts

@@ -1,60 +1,14 @@
-import * as _angular_cdk_bidi from '@angular/cdk/bidi';
 import * as _angular_core from '@angular/core';
 import { OnInit, OnDestroy, WritableSignal } from '@angular/core';
-import { TabPattern, TabPanelPattern, TabListPattern } from './_tabs-chunk.js';
+import * as _angular_cdk_bidi from '@angular/cdk/bidi';
+import { TabPattern, TabListPattern, TabPanelPattern } from './_tabs-chunk.js';
+import { HasElement, SortedCollection } from './_collection-chunk.js';
 import { DeferredContentAware, DeferredContent } from './_deferred-content-chunk.js';
-import { HasElement } from './_element-chunk.js';
 import './_keyboard-event-manager-chunk.js';
-import './_signal-like-chunk.js';
 import './_click-event-manager-chunk.js';
 import './_expansion-chunk.js';
 import './_list-navigation-chunk.js';
 
-/**
- * A TabPanel container for the resources of layered content associated with a tab.
- *
- * The `ngTabPanel` directive holds the content for a specific tab. It is linked to an
- * `ngTab` by a matching `value`. If a tab panel is hidden, the `inert` attribute will be
- * applied to remove it from the accessibility tree. Proper styling is required for visual hiding.
- *
- * ```html
- * <div ngTabPanel value="myTabId">
- *   <ng-template ngTabContent>
- *     <!-- Content for the tab panel -->
- *   </ng-template>
- * </div>
- * ```
- *
- * @developerPreview 21.0
- *
- * @see [Tabs](guide/aria/tabs)
- */
-declare class TabPanel implements OnInit, OnDestroy {
-    /** A reference to the host element. */
-    private readonly _elementRef;
-    /** A reference to the host element. */
-    readonly element: HTMLElement;
-    /** The DeferredContentAware host directive. */
-    private readonly _deferredContentAware;
-    /** The parent Tabs. */
-    private readonly _tabs;
-    /** A global unique identifier for the tab. */
-    readonly id: _angular_core.InputSignal<string>;
-    /** The Tab UIPattern associated with the tabpanel */
-    readonly _tabPattern: WritableSignal<TabPattern | undefined>;
-    /** A local unique identifier for the tabpanel. */
-    readonly value: _angular_core.InputSignal<string>;
-    /** Whether the tab panel is visible. */
-    readonly visible: _angular_core.Signal<boolean>;
-    /** The TabPanel UIPattern. */
-    readonly _pattern: TabPanelPattern;
-    constructor();
-    ngOnInit(): void;
-    ngOnDestroy(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabPanel, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<TabPanel, "[ngTabPanel]", ["ngTabPanel"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof DeferredContentAware; inputs: { "preserveContent": "preserveContent"; }; outputs: {}; }]>;
-}
-
 /**
  * A selectable tab in a TabList.
  *
@@ -67,8 +21,6 @@ declare class TabPanel implements OnInit, OnDestroy {
  * </li>
  * ```
  *
- * @developerPreview 21.0
- *
  * @see [Tabs](guide/aria/tabs)
  */
 declare class Tab implements HasElement, OnInit, OnDestroy {
@@ -76,14 +28,12 @@ declare class Tab implements HasElement, OnInit, OnDestroy {
     private readonly _elementRef;
     /** A reference to the host element. */
     readonly element: HTMLElement;
-    /** The parent Tabs wrapper. */
-    private readonly _tabsWrapper;
     /** The parent TabList. */
     private readonly _tabList;
     /** A unique identifier for the widget. */
     readonly id: _angular_core.InputSignal<string>;
-    /** The panel associated with this tab. */
-    readonly panel: _angular_core.Signal<TabPanel | undefined>;
+    /** The TabPanel UIPattern associated with the tab */
+    private readonly _tabpanelPattern;
     /** Whether a tab is disabled. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** The remote tabpanel unique identifier. */
@@ -96,6 +46,7 @@ declare class Tab implements HasElement, OnInit, OnDestroy {
     readonly _pattern: TabPattern;
     /** Opens this tab panel. */
     open(): void;
+    constructor();
     ngOnInit(): void;
     ngOnDestroy(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<Tab, never>;
@@ -116,8 +67,6 @@ declare class Tab implements HasElement, OnInit, OnDestroy {
  * </ul>
  * ```
  *
- * @developerPreview 21.0
- *
  * @see [Tabs](guide/aria/tabs)
  */
 declare class TabList implements OnInit, OnDestroy {
@@ -126,13 +75,11 @@ declare class TabList implements OnInit, OnDestroy {
     /** A reference to the host element. */
     readonly element: HTMLElement;
     /** The parent Tabs container. */
-    private readonly _tabsParent;
-    /** The Tabs registered for this TabList. */
-    private readonly _tabs;
-    /** The Tabs registered for this TabList. */
-    readonly _sortedTabs: _angular_core.Signal<Tab[]>;
+    readonly _tabsParent: Tabs;
+    /** The collection of Tabs. */
+    readonly _collection: SortedCollection<Tab>;
     /** The Tab UIPatterns of the child Tabs. */
-    private readonly _tabPatterns;
+    readonly _tabPatterns: _angular_core.Signal<TabPattern[]>;
     /** Whether the tablist is vertically or horizontally oriented. */
     readonly orientation: _angular_core.InputSignal<"vertical" | "horizontal">;
     /** Text direction. */
@@ -167,8 +114,6 @@ declare class TabList implements OnInit, OnDestroy {
     constructor();
     ngOnInit(): void;
     ngOnDestroy(): void;
-    _registerTab(child: Tab): void;
-    _unregisterTab(child: Tab): void;
     /** Opens the tab panel with the specified value. */
     open(value: string): boolean;
     findTab(value?: string): Tab | undefined;
@@ -176,6 +121,50 @@ declare class TabList implements OnInit, OnDestroy {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<TabList, "[ngTabList]", ["ngTabList"], { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "softDisabled": { "alias": "softDisabled"; "required": false; "isSignal": true; }; "focusMode": { "alias": "focusMode"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "selectedTab": { "alias": "selectedTab"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "selectedTab": "selectedTabChange"; }, never, never, true, never>;
 }
 
+/**
+ * A TabPanel container for the resources of layered content associated with a tab.
+ *
+ * The `ngTabPanel` directive holds the content for a specific tab. It is linked to an
+ * `ngTab` by a matching `value`. If a tab panel is hidden, the `inert` attribute will be
+ * applied to remove it from the accessibility tree. Proper styling is required for visual hiding.
+ *
+ * ```html
+ * <div ngTabPanel value="myTabId">
+ *   <ng-template ngTabContent>
+ *     <!-- Content for the tab panel -->
+ *   </ng-template>
+ * </div>
+ * ```
+ *
+ * @see [Tabs](guide/aria/tabs)
+ */
+declare class TabPanel implements OnInit, OnDestroy {
+    /** A reference to the host element. */
+    private readonly _elementRef;
+    /** A reference to the host element. */
+    readonly element: HTMLElement;
+    /** The DeferredContentAware host directive. */
+    private readonly _deferredContentAware;
+    /** The parent Tabs. */
+    private readonly _tabs;
+    /** A global unique identifier for the tab. */
+    readonly id: _angular_core.InputSignal<string>;
+    /** The Tab UIPattern associated with the tabpanel */
+    private readonly _tabPattern;
+    /** A local unique identifier for the tabpanel. */
+    readonly value: _angular_core.InputSignal<string>;
+    /** Whether the tab panel is visible. */
+    readonly visible: _angular_core.Signal<boolean>;
+    /** The TabPanel UIPattern. */
+    readonly _pattern: TabPanelPattern;
+    private readonly _tabContent;
+    constructor();
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabPanel, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<TabPanel, "[ngTabPanel]", ["ngTabPanel"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; }, {}, ["_tabContent"], never, true, [{ directive: typeof DeferredContentAware; inputs: { "preserveContent": "preserveContent"; }; outputs: {}; }]>;
+}
+
 /**
  * A Tabs container.
  *
@@ -203,27 +192,29 @@ declare class TabList implements OnInit, OnDestroy {
  * </div>
  * ```
  *
- * @developerPreview 21.0
- *
  * @see [Tabs](guide/aria/tabs)
  */
-declare class Tabs {
+declare class Tabs implements OnDestroy {
     /** A reference to the host element. */
     private readonly _elementRef;
     /** A reference to the host element. */
     readonly element: HTMLElement;
     /** The TabList registered for this container. */
-    private readonly _tabList;
-    /** The TabPanels registered for this container. */
-    private readonly _tabPanels;
-    /** The TabPanels registered for this container. */
-    private readonly _tabPanelsList;
+    readonly _tabList: _angular_core.WritableSignal<TabList | undefined>;
+    /** The collection of TabPanels. */
+    readonly _collection: SortedCollection<TabPanel>;
+    /** The Tab UIPattern of the child Tabs. */
+    readonly _tabPatterns: _angular_core.Signal<TabPattern[] | undefined>;
+    /** The TabPanel UIPattern of the child TabPanels. */
+    readonly _tabPanelPatterns: _angular_core.Signal<TabPanelPattern[]>;
+    /** A reactive map of tab values to their TabPanelPattern. */
+    readonly _panelMap: _angular_core.Signal<Map<string, TabPanelPattern>>;
+    /** A reactive map of tab values to their TabPattern. */
+    readonly _tabMap: _angular_core.Signal<Map<string, TabPattern>>;
     constructor();
-    _registerList(list: TabList): void;
-    _unregisterList(list: TabList): void;
-    _registerPanel(panel: TabPanel): void;
-    _unregisterPanel(panel: TabPanel): void;
-    findTabPanel(value?: string): TabPanel | undefined;
+    ngOnDestroy(): void;
+    _register(child: TabList): void;
+    _unregister(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<Tabs, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Tabs, "[ngTabs]", ["ngTabs"], {}, {}, never, never, true, never>;
 }
@@ -243,8 +234,6 @@ declare class Tabs {
  * </div>
  * ```
  *
- * @developerPreview 21.0
- *
  * @see [Tabs](guide/aria/tabs)
  */
 declare class TabContent {

package/types/toolbar-testing.d.ts

@@ -12,6 +12,8 @@ interface ToolbarWidgetHarnessFilters extends BaseHarnessFilters {
     text?: string | RegExp;
     /** Active state that the widget should match. */
     active?: boolean;
+    /** Selected state that the widget should match. */
+    selected?: boolean;
 }
 
 /** Harness for interacting with an Aria toolbar widget in tests. */
@@ -32,6 +34,8 @@ declare class ToolbarWidgetHarness extends ContentContainerComponentHarness<stri
     isActive(): Promise<boolean>;
     /** Gets whether the widget is disabled. */
     isDisabled(): Promise<boolean>;
+    /** Gets whether the widget is selected. */
+    isSelected(): Promise<boolean>;
 }
 
 /** Harness for interacting with an Aria toolbar widget group in tests. */

package/types/toolbar.d.ts

@@ -2,7 +2,7 @@ import * as _angular_core from '@angular/core';
 import { OnInit, OnDestroy } from '@angular/core';
 import * as _angular_cdk_bidi from '@angular/cdk/bidi';
 import { ToolbarWidgetGroupPattern, ToolbarWidgetPattern, ToolbarPattern } from './_toolbar-chunk.js';
-import './_signal-like-chunk.js';
+import { SortedCollection } from './_collection-chunk.js';
 import './_list-chunk.js';
 import './_list-navigation-chunk.js';
 
@@ -10,8 +10,6 @@ import './_list-navigation-chunk.js';
  * A directive that groups toolbar widgets, used for more complex widgets like radio groups
  * that have their own internal navigation.
  *
- * @developerPreview 21.0
- *
  * @see [Toolbar](guide/aria/toolbar)
  */
 declare class ToolbarWidgetGroup<V> {
@@ -33,6 +31,7 @@ declare class ToolbarWidgetGroup<V> {
     readonly multi: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** The ToolbarWidgetGroup UIPattern. */
     readonly _pattern: ToolbarWidgetGroupPattern<ToolbarWidgetPattern<V>, V>;
+    constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToolbarWidgetGroup<any>, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ToolbarWidgetGroup<any>, "[ngToolbarWidgetGroup]", ["ngToolbarWidgetGroup"], { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "multi": { "alias": "multi"; "required": false; "isSignal": true; }; }, {}, ["_widgets"], never, true, never>;
 }
@@ -50,8 +49,6 @@ declare class ToolbarWidgetGroup<V> {
  * </button>
  * ```
  *
- * @developerPreview 21.0
- *
  * @see [Toolbar](guide/aria/toolbar)
  */
 declare class ToolbarWidget<V> implements OnInit, OnDestroy {
@@ -104,17 +101,15 @@ declare class ToolbarWidget<V> implements OnInit, OnDestroy {
  * </div>
  * ```
  *
- * @developerPreview 21.0
- *
  * @see [Toolbar](guide/aria/toolbar)
  */
-declare class Toolbar<V> {
+declare class Toolbar<V> implements OnDestroy {
     /** A reference to the host element. */
     private readonly _elementRef;
     /** A reference to the host element. */
     readonly element: HTMLElement;
-    /** The TabList nested inside of the container. */
-    private readonly _widgets;
+    /** The collection of widgets in the toolbar. */
+    readonly _collection: SortedCollection<ToolbarWidget<V>>;
     /** Text direction. */
     readonly textDirection: _angular_core.WritableSignal<_angular_cdk_bidi.Direction>;
     /** Sorted UIPatterns of the child widgets */
@@ -135,8 +130,7 @@ declare class Toolbar<V> {
     /** The toolbar UIPattern. */
     readonly _pattern: ToolbarPattern<V>;
     constructor();
-    _register(widget: ToolbarWidget<V>): void;
-    _unregister(widget: ToolbarWidget<V>): void;
+    ngOnDestroy(): void;
     /** Finds the toolbar item associated with a given element. */
     private _getItem;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<Toolbar<any>, never>;

package/types/tree-testing.d.ts

@@ -38,6 +38,14 @@ declare class TreeItemHarness extends ContentContainerComponentHarness<string> {
     getText(): Promise<string>;
     /** Clicks the tree item. */
     click(): Promise<void>;
+    /** Focuses the tree item. */
+    focus(): Promise<void>;
+    /** Blurs the tree item. */
+    blur(): Promise<void>;
+    /** Whether the tree item is active. */
+    isActive(): Promise<boolean>;
+    /** Whether the tree item has focus. */
+    isFocused(): Promise<boolean>;
     private _getHostAttribute;
 }
 

package/types/tree.d.ts

@@ -2,17 +2,13 @@ import * as _angular_cdk_bidi from '@angular/cdk/bidi';
 import * as _angular_core from '@angular/core';
 import { OnInit, OnDestroy, Signal } from '@angular/core';
 import { TreeItemPattern, TreePattern } from './_tree-chunk.js';
+import { HasElement, SortedCollection } from './_collection-chunk.js';
 import { DeferredContent, DeferredContentAware } from './_deferred-content-chunk.js';
-import { HasElement } from './_element-chunk.js';
-import { ComboboxPopup } from './combobox.js';
-export { Combobox as ɵɵCombobox, ComboboxDialog as ɵɵComboboxDialog, ComboboxInput as ɵɵComboboxInput, ComboboxPopupContainer as ɵɵComboboxPopupContainer } from './combobox.js';
-import './_signal-like-chunk.js';
 import './_expansion-chunk.js';
 import './_list-navigation-chunk.js';
 import './_list-chunk.js';
 import './_keyboard-event-manager-chunk.js';
 import './_click-event-manager-chunk.js';
-import './_combobox-chunk.js';
 
 /**
  * Group that contains children tree items.
@@ -32,8 +28,6 @@ import './_combobox-chunk.js';
  * </li>
  * ```
  *
- * @developerPreview 21.0
- *
  * @see [Tree](guide/aria/tree)
  */
 declare class TreeItemGroup<V> implements OnInit, OnDestroy {
@@ -69,8 +63,6 @@ declare class TreeItemGroup<V> implements OnInit, OnDestroy {
  *   Item Label
  * </li>
  * ```
- *
- * @developerPreview 21.0
  */
 declare class TreeItem<V> extends DeferredContentAware implements OnInit, OnDestroy, HasElement {
     /** A reference to the host element. */
@@ -150,19 +142,15 @@ declare class TreeItem<V> extends DeferredContentAware implements OnInit, OnDest
  * </ng-template>
  * ```
  *
- * @developerPreview 21.0
- *
  * @see [Tree](guide/aria/tree)
  */
-declare class Tree<V> {
+declare class Tree<V> implements OnDestroy {
     /** A reference to the host element. */
     private readonly _elementRef;
     /** A reference to the host element. */
     readonly element: HTMLElement;
-    /** A reference to the parent combobox popup, if one exists. */
-    private readonly _popup;
-    /** All TreeItem instances within this tree. */
-    private readonly _unorderedItems;
+    /** The collection of tree items. */
+    readonly _collection: SortedCollection<TreeItem<V>>;
     /** A unique identifier for the tree. */
     readonly id: _angular_core.InputSignal<string>;
     /** Orientation of the tree. */
@@ -210,11 +198,10 @@ declare class Tree<V> {
     /** The ID of the active descendant in the tree. */
     readonly activeDescendant: Signal<string | undefined>;
     constructor();
-    _register(child: TreeItem<V>): void;
-    _unregister(child: TreeItem<V>): void;
+    ngOnDestroy(): void;
     scrollActiveItemIntoView(options?: ScrollIntoViewOptions): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<Tree<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Tree<any>, "[ngTree]", ["ngTree"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "multi": { "alias": "multi"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "focusMode": { "alias": "focusMode"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "softDisabled": { "alias": "softDisabled"; "required": false; "isSignal": true; }; "typeaheadDelay": { "alias": "typeaheadDelay"; "required": false; "isSignal": true; }; "tabIndex": { "alias": "tabIndex"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "nav": { "alias": "nav"; "required": false; "isSignal": true; }; "currentType": { "alias": "currentType"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, [{ directive: typeof ComboboxPopup; inputs: {}; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Tree<any>, "[ngTree]", ["ngTree"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "multi": { "alias": "multi"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "focusMode": { "alias": "focusMode"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "softDisabled": { "alias": "softDisabled"; "required": false; "isSignal": true; }; "typeaheadDelay": { "alias": "typeaheadDelay"; "required": false; "isSignal": true; }; "tabIndex": { "alias": "tabindex"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "nav": { "alias": "nav"; "required": false; "isSignal": true; }; "currentType": { "alias": "currentType"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
 }
 
-export { Tree, TreeItem, TreeItemGroup, ComboboxPopup as ɵɵComboboxPopup, DeferredContent as ɵɵDeferredContent };
+export { Tree, TreeItem, TreeItemGroup, DeferredContent as ɵɵDeferredContent };