@angular/aria 22.2.0-next.3 → 22.2.0-next.4

package/types/_toolbar-chunk.d.ts

@@ -1,42 +1,40 @@
 import { SignalLike, WritableSignalLike } from './_collection-chunk.js';
-import { ListItem, ListInputs, List } from './_list-chunk.js';
+import { ListFocusItem, ListNavigationItem, ListFocus, ListNavigation } from './_list-navigation-chunk.js';
 
 /** Represents the required inputs for a toolbar widget group. */
-interface ToolbarWidgetGroupInputs<T extends ListItem<V>, V> {
+interface ToolbarWidgetGroupInputs {
     /** A reference to the parent toolbar. */
-    toolbar: SignalLike<ToolbarPattern<V> | undefined>;
+    toolbar: SignalLike<ToolbarPattern | 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>;
+    items: SignalLike<ToolbarWidgetPattern[]>;
 }
 /** A group of widgets within a toolbar that provides nested navigation. */
-declare class ToolbarWidgetGroupPattern<T extends ListItem<V>, V> {
-    readonly inputs: ToolbarWidgetGroupInputs<T, V>;
+declare class ToolbarWidgetGroupPattern {
+    readonly inputs: ToolbarWidgetGroupInputs;
     /** 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>);
+    readonly toolbar: () => ToolbarPattern | undefined;
+    constructor(inputs: ToolbarWidgetGroupInputs);
 }
 
 /** Represents the required inputs for a toolbar widget in a toolbar. */
-interface ToolbarWidgetInputs<V> extends Omit<ListItem<V>, 'searchTerm' | 'index' | 'selectable'> {
+interface ToolbarWidgetInputs {
+    /** A unique identifier for the widget. */
+    id: SignalLike<string>;
+    /** The html element that should receive focus. */
+    element: SignalLike<HTMLElement | undefined>;
+    /** Whether the widget is disabled. */
+    disabled: SignalLike<boolean>;
     /** A reference to the parent toolbar. */
-    toolbar: SignalLike<ToolbarPattern<V>>;
+    toolbar: SignalLike<ToolbarPattern>;
     /** A reference to the parent widget group. */
-    group: SignalLike<ToolbarWidgetGroupPattern<ToolbarWidgetPattern<V>, V> | undefined>;
+    group: SignalLike<ToolbarWidgetGroupPattern | undefined>;
 }
-declare class ToolbarWidgetPattern<V> implements ListItem<V> {
-    readonly inputs: ToolbarWidgetInputs<V>;
+declare class ToolbarWidgetPattern implements ListFocusItem, ListNavigationItem {
+    readonly inputs: ToolbarWidgetInputs;
     /** A unique identifier for the widget. */
     readonly id: () => string;
     /** The html element that should receive focus. */
@@ -44,50 +42,60 @@ declare class ToolbarWidgetPattern<V> implements ListItem<V> {
     /** Whether the widget is disabled. */
     readonly disabled: () => boolean;
     /** A reference to the parent toolbar. */
-    readonly group: () => ToolbarWidgetGroupPattern<ToolbarWidgetPattern<V>, V> | undefined;
+    readonly group: () => ToolbarWidgetGroupPattern | undefined;
     /** A reference to the toolbar containing the widget. */
-    readonly toolbar: () => ToolbarPattern<V>;
+    readonly toolbar: () => ToolbarPattern;
     /** The tabindex of the widget. */
     readonly tabIndex: SignalLike<-1 | 0>;
-    /** 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: SignalLike<number>;
-    /** Whether the widget is selected (only relevant in a selection group). */
-    readonly selected: SignalLike<boolean>;
     /** Whether the widget is currently the active one (focused). */
     readonly active: SignalLike<boolean>;
-    constructor(inputs: ToolbarWidgetInputs<V>);
+    constructor(inputs: ToolbarWidgetInputs);
 }
 
 /** Represents the required inputs for a toolbar. */
-type ToolbarInputs<V> = Omit<ListInputs<ToolbarWidgetPattern<V>, V>, 'multi' | 'typeaheadDelay' | 'selectionMode' | 'focusMode'> & {
+type ToolbarInputs = {
+    /** The html element that should receive focus. */
+    element: SignalLike<HTMLElement | undefined>;
+    /** The active item. */
+    activeItem: WritableSignalLike<ToolbarWidgetPattern | undefined>;
+    /** The items in the toolbar. */
+    items: SignalLike<ToolbarWidgetPattern[]>;
+    /** Whether disabled items in the toolbar should be focusable. */
+    softDisabled: SignalLike<boolean>;
+    /** Whether the toolbar is disabled. */
+    disabled: SignalLike<boolean>;
+    /** Whether the toolbar is vertically or horizontally oriented. */
+    orientation: SignalLike<'vertical' | 'horizontal'>;
+    /** The direction that text is read based on the users locale. */
+    textDirection: SignalLike<'rtl' | 'ltr'>;
+    /** Whether focus should wrap when navigating. */
+    wrap: SignalLike<boolean>;
     /** A function that returns the toolbar item associated with a given element. */
-    getItem: (e: Element) => ToolbarWidgetPattern<V> | undefined;
+    getItem: (e: Element) => ToolbarWidgetPattern | 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>;
+declare class ToolbarPattern {
+    readonly inputs: ToolbarInputs;
+    /** Controls focus for the toolbar. */
+    readonly focusManager: ListFocus<ToolbarWidgetPattern>;
+    /** Controls navigation for the toolbar. */
+    readonly navigationBehavior: ListNavigation<ToolbarWidgetPattern>;
     /** Whether the toolbar has been interacted with. */
     readonly hasBeenInteracted: WritableSignalLike<boolean>;
-    /** Whether the tablist is vertically or horizontally oriented. */
+    /** Whether the toolbar 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: SignalLike<boolean>;
-    /** The tab index of the toolbar (if using activedescendant). */
+    /** The tab index of the toolbar. */
     readonly tabIndex: SignalLike<-1 | 0>;
-    /** The id of the current active widget (if using activedescendant). */
+    /** The id of the current active widget. */
     readonly activeDescendant: SignalLike<string | undefined>;
     /** The currently active item in the toolbar. */
-    readonly activeItem: () => ToolbarWidgetPattern<V> | undefined;
+    readonly activeItem: () => ToolbarWidgetPattern | undefined;
     /** The key used to navigate to the previous widget. */
     private readonly _prevKey;
     /** The key used to navigate to the next widget. */
@@ -104,10 +112,7 @@ declare class ToolbarPattern<V> {
     private _groupPrev;
     /** Navigates to the widget targeted by a pointer event. */
     private _goto;
-    select(): void;
-    constructor(inputs: ToolbarInputs<V>);
-    /** Returns a set of violations */
-    validate(): string[];
+    constructor(inputs: ToolbarInputs);
     /** Handles keydown events for the toolbar. */
     onKeydown(event: KeyboardEvent): void;
     onPointerdown(event: PointerEvent): void;
@@ -117,8 +122,7 @@ declare class ToolbarPattern<V> {
     /**
      * 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.
+     * Sets the active index to the first focusable widget.
      */
     setDefaultState(): void;
     /** Sets the default active state of the toolbar before receiving interaction for the first time. */

package/types/menu.d.ts

@@ -60,7 +60,7 @@ declare class MenuBar<V> implements OnDestroy {
     /** The menu items as a writable signal. */
     private readonly _itemPatterns;
     /** A callback function triggered when a menu item is selected. */
-    readonly itemSelected: _angular_core.OutputEmitterRef<V>;
+    readonly itemSelected: _angular_core.OutputEmitterRef<V | undefined>;
     constructor();
     ngOnDestroy(): void;
     /** Closes the menubar. */
@@ -93,7 +93,7 @@ declare class MenuItem<V> implements OnInit, OnDestroy {
     /** The unique ID of the menu item. */
     readonly id: _angular_core.InputSignal<string>;
     /** The value of the menu item. */
-    readonly value: _angular_core.InputSignal<V>;
+    readonly value: _angular_core.InputSignal<V | undefined>;
     /** Whether the menu item is disabled. */
     readonly disabled: _angular_core.InputSignal<boolean>;
     /** The search term associated with the menu item. */
@@ -120,7 +120,7 @@ declare class MenuItem<V> implements OnInit, OnDestroy {
     /** Closes the submenu. */
     close(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuItem<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MenuItem<any>, "[ngMenuItem]", ["ngMenuItem"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "searchTerm": { "alias": "searchTerm"; "required": false; "isSignal": true; }; "role": { "alias": "role"; "required": false; "isSignal": true; }; "submenu": { "alias": "submenu"; "required": false; "isSignal": true; }; }, { "searchTerm": "searchTermChange"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MenuItem<any>, "[ngMenuItem]", ["ngMenuItem"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "searchTerm": { "alias": "searchTerm"; "required": false; "isSignal": true; }; "role": { "alias": "role"; "required": false; "isSignal": true; }; "submenu": { "alias": "submenu"; "required": false; "isSignal": true; }; }, { "searchTerm": "searchTermChange"; }, never, never, true, never>;
 }
 
 /**
@@ -191,7 +191,7 @@ declare class Menu<V> implements OnDestroy {
     /** The tab index of the menu. */
     readonly tabIndex: Signal<-1 | 0>;
     /** A callback function triggered when a menu item is selected. */
-    readonly itemSelected: _angular_core.OutputEmitterRef<V>;
+    readonly itemSelected: _angular_core.OutputEmitterRef<V | undefined>;
     /** The delay in milliseconds before expanding sub-menus on hover. */
     readonly expansionDelay: _angular_core.InputSignal<number>;
     constructor();

package/types/private.d.ts

@@ -96,6 +96,8 @@ declare class ComboboxPattern {
     onFocusin(): void;
     /** Handles focus out events for the combobox. */
     onFocusout(): void;
+    /** Closes the popup once focus has left both the combobox and the popup. */
+    closePopupOnFocusout(): void;
     /** Handles input events for the combobox. */
     onInput(event: Event): void;
     /** Highlights the currently selected item in the combobox. */
@@ -113,6 +115,8 @@ interface ComboboxPopupInputs {
     activeDescendant: SignalLike<string | undefined>;
     /** The ID of the popup. */
     popupId: SignalLike<string | undefined>;
+    /** A reference to the parent combobox. */
+    combobox: SignalLike<ComboboxPattern | undefined>;
 }
 /** Controls the state of a simple combobox popup. */
 declare class ComboboxPopupPattern {
@@ -125,6 +129,8 @@ declare class ComboboxPopupPattern {
     readonly activeDescendant: () => string | undefined;
     /** The ID of the popup. */
     readonly popupId: () => string | undefined;
+    /** A reference to the parent combobox. */
+    readonly combobox: () => ComboboxPattern | undefined;
     /** Whether the popup is focused. */
     readonly isFocused: _angular_core.WritableSignal<boolean>;
     constructor(inputs: ComboboxPopupInputs);

package/types/toolbar.d.ts

@@ -1,9 +1,8 @@
 import * as _angular_core from '@angular/core';
 import { OnInit, OnDestroy, InjectionToken } from '@angular/core';
 import * as _angular_cdk_bidi from '@angular/cdk/bidi';
-import { ToolbarWidgetGroupPattern, ToolbarWidgetPattern, ToolbarPattern } from './private.js';
+import { ToolbarWidgetGroupPattern, ToolbarPattern, ToolbarWidgetPattern } from './private.js';
 import { SortedCollection } from './private.js';
-import './_list-chunk.js';
 import './_list-navigation-chunk.js';
 
 /**
@@ -12,7 +11,7 @@ import './_list-navigation-chunk.js';
  *
  * @see [Toolbar](guide/aria/toolbar)
  */
-declare class ToolbarWidgetGroup<V> {
+declare class ToolbarWidgetGroup {
     /** A reference to the host element. */
     private readonly _elementRef;
     /** A reference to the host element. */
@@ -27,13 +26,11 @@ declare class ToolbarWidgetGroup<V> {
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** The list of toolbar items within the group. */
     private readonly _itemPatterns;
-    /** Whether the group allows multiple widgets to be selected. */
-    readonly multi: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** The ToolbarWidgetGroup UIPattern. */
-    readonly _pattern: ToolbarWidgetGroupPattern<ToolbarWidgetPattern<V>, V>;
+    readonly _pattern: ToolbarWidgetGroupPattern;
     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>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToolbarWidgetGroup, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ToolbarWidgetGroup, "[ngToolbarWidgetGroup]", ["ngToolbarWidgetGroup"], { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, ["_widgets"], never, true, never>;
 }
 
 /**
@@ -41,17 +38,17 @@ declare class ToolbarWidgetGroup<V> {
  *
  * The `ngToolbarWidget` directive should be applied to any native HTML element that acts
  * as an interactive widget within an `ngToolbar` or `ngToolbarWidgetGroup`. It enables
- * keyboard navigation and selection within the toolbar.
+ * keyboard navigation within the toolbar.
  *
  * ```html
- * <button ngToolbarWidget value="action-id" [disabled]="isDisabled">
+ * <button ngToolbarWidget [disabled]="isDisabled">
  *   Perform Action
  * </button>
  * ```
  *
  * @see [Toolbar](guide/aria/toolbar)
  */
-declare class ToolbarWidget<V> implements OnInit, OnDestroy {
+declare class ToolbarWidget implements OnInit, OnDestroy {
     /** A reference to the host element. */
     private readonly _elementRef;
     /** A reference to the host element. */
@@ -61,26 +58,22 @@ declare class ToolbarWidget<V> implements OnInit, OnDestroy {
     /** A unique identifier for the widget. */
     readonly id: _angular_core.InputSignal<string>;
     /** The parent Toolbar UIPattern. */
-    readonly _toolbarPattern: _angular_core.Signal<ToolbarPattern<V>>;
+    readonly _toolbarPattern: _angular_core.Signal<ToolbarPattern>;
     /** Whether the widget is disabled. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Whether the widget is 'hard' disabled, which is different from `aria-disabled`. A hard disabled widget cannot receive focus. */
     readonly hardDisabled: _angular_core.Signal<boolean>;
     /** The optional ToolbarWidgetGroup this widget belongs to. */
-    readonly _group: ToolbarWidgetGroup<V> | null;
-    /** The value associated with the widget. */
-    readonly value: _angular_core.InputSignal<V>;
+    readonly _group: ToolbarWidgetGroup | null;
     /** Whether the widget is currently active (focused). */
     readonly active: _angular_core.Signal<boolean>;
-    /** Whether the widget is selected (only relevant in a selection group). */
-    readonly selected: () => boolean;
     private readonly _groupPattern;
     /** The ToolbarWidget UIPattern. */
-    readonly _pattern: ToolbarWidgetPattern<V>;
+    readonly _pattern: ToolbarWidgetPattern;
     ngOnInit(): void;
     ngOnDestroy(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToolbarWidget<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ToolbarWidget<any>, "[ngToolbarWidget]", ["ngToolbarWidget"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToolbarWidget, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ToolbarWidget, "[ngToolbarWidget]", ["ngToolbarWidget"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -90,30 +83,30 @@ declare class ToolbarWidget<V> implements OnInit, OnDestroy {
  *
  * ```html
  * <div ngToolbar orientation="horizontal" [wrap]="true">
- *   <button ngToolbarWidget value="save">Save</button>
- *   <button ngToolbarWidget value="print">Print</button>
+ *   <button ngToolbarWidget>Save</button>
+ *   <button ngToolbarWidget>Print</button>
  *
- *   <div ngToolbarWidgetGroup [(value)]="selectedAlignment">
- *     <button ngToolbarWidget value="left">Left</button>
- *     <button ngToolbarWidget value="center">Center</button>
- *     <button ngToolbarWidget value="right">Right</button>
+ *   <div ngToolbarWidgetGroup>
+ *     <button ngToolbarWidget>Left</button>
+ *     <button ngToolbarWidget>Center</button>
+ *     <button ngToolbarWidget>Right</button>
  *   </div>
  * </div>
  * ```
  *
  * @see [Toolbar](guide/aria/toolbar)
  */
-declare class Toolbar<V> implements OnDestroy {
+declare class Toolbar implements OnDestroy {
     /** A reference to the host element. */
     private readonly _elementRef;
     /** A reference to the host element. */
     readonly element: HTMLElement;
     /** The collection of widgets in the toolbar. */
-    readonly _collection: SortedCollection<ToolbarWidget<V>>;
+    readonly _collection: SortedCollection<ToolbarWidget>;
     /** Text direction. */
     readonly textDirection: _angular_core.WritableSignal<_angular_cdk_bidi.Direction>;
     /** Sorted UIPatterns of the child widgets */
-    readonly _itemPatterns: _angular_core.Signal<ToolbarWidgetPattern<V>[]>;
+    readonly _itemPatterns: _angular_core.Signal<ToolbarWidgetPattern[]>;
     /** Whether the toolbar is vertically or horizontally oriented. */
     readonly orientation: _angular_core.InputSignal<"horizontal" | "vertical">;
     /**
@@ -125,19 +118,17 @@ declare class Toolbar<V> implements OnDestroy {
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Whether focus should wrap when navigating. */
     readonly wrap: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** The values of the selected widgets within the toolbar. */
-    readonly value: _angular_core.ModelSignal<V[]>;
     /** The toolbar UIPattern. */
-    readonly _pattern: ToolbarPattern<V>;
+    readonly _pattern: ToolbarPattern;
     constructor();
     ngOnDestroy(): void;
     /** Finds the toolbar item associated with a given element. */
     private _getItem;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<Toolbar<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Toolbar<any>, "[ngToolbar]", ["ngToolbar"], { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "softDisabled": { "alias": "softDisabled"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<Toolbar, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Toolbar, "[ngToolbar]", ["ngToolbar"], { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "softDisabled": { "alias": "softDisabled"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /** Token used to provide the `ToolbarWidgetGroup` directive. */
-declare const TOOLBAR_WIDGET_GROUP: InjectionToken<ToolbarWidgetGroup<unknown>>;
+declare const TOOLBAR_WIDGET_GROUP: InjectionToken<ToolbarWidgetGroup>;
 
 export { TOOLBAR_WIDGET_GROUP, Toolbar, ToolbarWidget, ToolbarWidgetGroup };