@angular/aria 21.0.2 → 21.0.4

package/types/grid.d.ts

@@ -1,7 +1,11 @@
 import * as _angular_core from '@angular/core';
 import { Signal, ElementRef } from '@angular/core';
 import * as _angular_cdk_bidi from '@angular/cdk/bidi';
-import { GridPattern, GridRowPattern, GridCellPattern, GridCellWidgetPattern } from './_grid-chunk.js';
+import { GridPattern, GridCellPattern, GridRowPattern, GridCellWidgetPattern } from './_grid-chunk.js';
+import * as _angular_aria_private_public_api from '@angular/aria/private/public-api';
+import './_list-navigation-chunk.js';
+import './_keyboard-event-manager-chunk.js';
+import './_pointer-event-manager-chunk.js';
 
 /**
  * The container for a grid. It provides keyboard navigation and focus management for the grid's
@@ -23,6 +27,8 @@ import { GridPattern, GridRowPattern, GridCellPattern, GridCellWidgetPattern } f
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Grid](guide/aria/grid)
  */
 declare class Grid {
     /** A reference to the host element. */
@@ -82,37 +88,7 @@ declare class Grid {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<Grid, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Grid, "[ngGrid]", ["ngGrid"], { "enableSelection": { "alias": "enableSelection"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "softDisabled": { "alias": "softDisabled"; "required": false; "isSignal": true; }; "focusMode": { "alias": "focusMode"; "required": false; "isSignal": true; }; "rowWrap": { "alias": "rowWrap"; "required": false; "isSignal": true; }; "colWrap": { "alias": "colWrap"; "required": false; "isSignal": true; }; "multi": { "alias": "multi"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "enableRangeSelection": { "alias": "enableRangeSelection"; "required": false; "isSignal": true; }; }, {}, ["_rows"], never, true, never>;
 }
-/**
- * Represents a row within a grid. It is a container for `ngGridCell` directives.
- *
- * ```html
- * <tr ngGridRow>
- *   <!-- ... cells ... -->
- * </tr>
- * ```
- *
- * @developerPreview 21.0
- */
-declare class GridRow {
-    /** A reference to the host element. */
-    private readonly _elementRef;
-    /** A reference to the host element. */
-    readonly element: HTMLElement;
-    /** The cells that make up this row. */
-    private readonly _cells;
-    /** The UI patterns for the cells in this row. */
-    private readonly _cellPatterns;
-    /** The parent grid. */
-    private readonly _grid;
-    /** The parent grid UI pattern. */
-    readonly _gridPattern: Signal<GridPattern>;
-    /** The index of this row within the grid. */
-    readonly rowIndex: _angular_core.InputSignal<number | undefined>;
-    /** The UI pattern for the grid row. */
-    readonly _pattern: GridRowPattern;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<GridRow, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GridRow, "[ngGridRow]", ["ngGridRow"], { "rowIndex": { "alias": "rowIndex"; "required": false; "isSignal": true; }; }, {}, ["_cells"], never, true, never>;
-}
+
 /**
  * Represents a cell within a grid row. It is the primary focusable element
  * within the grid. It can be disabled and can have its selection state managed
@@ -125,6 +101,8 @@ declare class GridRow {
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Grid](guide/aria/grid)
  */
 declare class GridCell {
     /** A reference to the host element. */
@@ -178,6 +156,41 @@ declare class GridCell {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<GridCell, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GridCell, "[ngGridCell]", ["ngGridCell"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "role": { "alias": "role"; "required": false; "isSignal": true; }; "rowSpan": { "alias": "rowSpan"; "required": false; "isSignal": true; }; "colSpan": { "alias": "colSpan"; "required": false; "isSignal": true; }; "rowIndex": { "alias": "rowIndex"; "required": false; "isSignal": true; }; "colIndex": { "alias": "colIndex"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "tabindex": { "alias": "tabindex"; "required": false; "isSignal": true; }; }, { "selected": "selectedChange"; }, ["_widgets"], never, true, never>;
 }
+
+/**
+ * Represents a row within a grid. It is a container for `ngGridCell` directives.
+ *
+ * ```html
+ * <tr ngGridRow>
+ *   <!-- ... cells ... -->
+ * </tr>
+ * ```
+ *
+ * @developerPreview 21.0
+ *
+ * @see [Grid](guide/aria/grid)
+ */
+declare class GridRow {
+    /** A reference to the host element. */
+    private readonly _elementRef;
+    /** A reference to the host element. */
+    readonly element: HTMLElement;
+    /** The cells that make up this row. */
+    private readonly _cells;
+    /** The UI patterns for the cells in this row. */
+    private readonly _cellPatterns;
+    /** The parent grid. */
+    private readonly _grid;
+    /** The parent grid UI pattern. */
+    readonly _gridPattern: Signal<_angular_aria_private_public_api.GridPattern>;
+    /** The index of this row within the grid. */
+    readonly rowIndex: _angular_core.InputSignal<number | undefined>;
+    /** The UI pattern for the grid row. */
+    readonly _pattern: GridRowPattern;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<GridRow, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GridRow, "[ngGridRow]", ["ngGridRow"], { "rowIndex": { "alias": "rowIndex"; "required": false; "isSignal": true; }; }, {}, ["_cells"], never, true, never>;
+}
+
 /**
  * Represents an interactive element inside a `GridCell`. It allows for pausing grid navigation to
  * interact with the widget.
@@ -193,6 +206,8 @@ declare class GridCell {
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Grid](guide/aria/grid)
  */
 declare class GridCellWidget {
     /** A reference to the host element. */

package/types/listbox.d.ts

@@ -1,7 +1,15 @@
+import * as _angular_aria_private_public_api from '@angular/aria/private/public-api';
 import * as _angular_cdk_bidi from '@angular/cdk/bidi';
 import * as _angular_core from '@angular/core';
-import { ListboxPattern, OptionPattern } from '@angular/aria/private';
+import { ListboxPattern, OptionPattern } from './_listbox-chunk.js';
 import { ComboboxPopup } from './combobox.js';
+export { Combobox as ɵɵCombobox, ComboboxDialog as ɵɵComboboxDialog, ComboboxInput as ɵɵComboboxInput, ComboboxPopupContainer as ɵɵComboboxPopupContainer } from './combobox.js';
+import './_list-navigation-chunk.js';
+import './_list-chunk.js';
+import './_keyboard-event-manager-chunk.js';
+import './_pointer-event-manager-chunk.js';
+import './_combobox-chunk.js';
+import './_deferred-content-chunk.js';
 
 /**
  * Represents a container used to display a list of items for a user to select from.
@@ -21,6 +29,11 @@ import { ComboboxPopup } from './combobox.js';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Listbox](guide/aria/listbox)
+ * @see [Autocomplete](guide/aria/autocomplete)
+ * @see [Select](guide/aria/select)
+ * @see [Multiselect](guide/aria/multiselect)
  */
 declare class Listbox<V> {
     /** A unique identifier for the listbox. */
@@ -31,14 +44,12 @@ declare class Listbox<V> {
     private readonly _elementRef;
     /** A reference to the host element. */
     readonly element: HTMLElement;
-    /** The directionality (LTR / RTL) context for the application (or a subtree of it). */
-    private readonly _directionality;
     /** The Options nested inside of the Listbox. */
     private readonly _options;
     /** A signal wrapper for directionality. */
     protected textDirection: _angular_core.Signal<_angular_cdk_bidi.Direction>;
     /** The Option UIPatterns of the child Options. */
-    protected items: _angular_core.Signal<any[]>;
+    protected items: _angular_core.Signal<_angular_aria_private_public_api.OptionPattern<any>[]>;
     /** Whether the list is vertically or horizontally oriented. */
     orientation: _angular_core.InputSignal<"vertical" | "horizontal">;
     /** Whether multiple items in the list can be selected at once. */
@@ -82,6 +93,7 @@ declare class Listbox<V> {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<Listbox<any>, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Listbox<any>, "[ngListbox]", ["ngListbox"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "multi": { "alias": "multi"; "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; }; "typeaheadDelay": { "alias": "typeaheadDelay"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "values": { "alias": "values"; "required": false; "isSignal": true; }; }, { "values": "valuesChange"; }, ["_options"], never, true, [{ directive: typeof ComboboxPopup; inputs: {}; outputs: {}; }]>;
 }
+
 /**
  * A selectable option in an `ngListbox`.
  *
@@ -96,10 +108,13 @@ declare class Listbox<V> {
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Listbox](guide/aria/listbox)
+ * @see [Autocomplete](guide/aria/autocomplete)
+ * @see [Select](guide/aria/select)
+ * @see [Multiselect](guide/aria/multiselect)
  */
 declare class Option<V> {
-    /** A reference to the host element. */
-    private readonly _elementRef;
     /** A reference to the host element. */
     readonly element: HTMLElement;
     /** Whether the option is currently active (focused). */
@@ -126,4 +141,4 @@ declare class Option<V> {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Option<any>, "[ngOption]", ["ngOption"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { Listbox, Option };
+export { Listbox, Option, ComboboxPopup as ɵɵComboboxPopup };

package/types/menu.d.ts

@@ -1,54 +1,125 @@
 import * as _angular_core from '@angular/core';
 import { Signal } from '@angular/core';
 import * as _angular_cdk_bidi from '@angular/cdk/bidi';
-import * as i1 from '@angular/aria/private';
-import { MenuTriggerPattern, MenuPattern, SignalLike, MenuBarPattern, MenuItemPattern } from '@angular/aria/private';
+import { MenuBarPattern, MenuItemPattern, MenuPattern, MenuTriggerPattern } from './_menu-chunk.js';
+import { DeferredContentAware, DeferredContent } from './_deferred-content-chunk.js';
+import { SignalLike } from './_list-navigation-chunk.js';
+import './_keyboard-event-manager-chunk.js';
+import './_list-chunk.js';
 
 /**
- * A trigger for a menu.
+ * A menu bar of menu items.
  *
- * The `ngMenuTrigger` directive is used to open and close menus. It can be applied to
- * any interactive element (e.g., a button) to associate it with a `ngMenu` instance.
- * It also supports linking to sub-menus when applied to a `ngMenuItem`.
+ * Like the `ngMenu`, a `ngMenuBar` is used to offer a list of menu item choices to users.
+ * However, a menubar is used to display a persistent, top-level, always-visible set of
+ * menu item choices, typically found at the top of an application window.
  *
  * ```html
- * <button ngMenuTrigger [menu]="myMenu">Open Menu</button>
+ * <div ngMenuBar>
+ *   <button ngMenuTrigger [menu]="fileMenu">File</button>
+ *   <button ngMenuTrigger [menu]="editMenu">Edit</button>
+ * </div>
  *
- * <div ngMenu #myMenu="ngMenu">
- *   <div ngMenuItem>Item 1</div>
- *   <div ngMenuItem>Item 2</div>
+ * <div ngMenu #fileMenu="ngMenu">
+ *   <div ngMenuItem>New</div>
+ *   <div ngMenuItem>Open</div>
+ * </div>
+ *
+ * <div ngMenu #editMenu="ngMenu">
+ *   <div ngMenuItem>Cut</div>
+ *   <div ngMenuItem>Copy</div>
  * </div>
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Menu](guide/aria/menu)
+ * @see [MenuBar](guide/aria/menubar)
  */
-declare class MenuTrigger<V> {
+declare class MenuBar<V> {
+    /** The menu items contained in the menubar. */
+    readonly _allItems: _angular_core.Signal<readonly MenuItem<V>[]>;
+    readonly _items: SignalLike<MenuItem<V>[]>;
     /** A reference to the host element. */
     private readonly _elementRef;
     /** A reference to the host element. */
     readonly element: HTMLElement;
+    /** Whether the menubar is disabled. */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Whether the menubar is soft disabled. */
+    readonly softDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** The directionality (LTR / RTL) context for the application (or a subtree of it). */
     readonly textDirection: _angular_core.WritableSignal<_angular_cdk_bidi.Direction>;
-    /** The menu associated with the trigger. */
-    menu: _angular_core.InputSignal<Menu<V> | undefined>;
+    /** The values of the currently selected menu items. */
+    readonly values: _angular_core.ModelSignal<V[]>;
+    /** Whether the menu should wrap its items. */
+    readonly wrap: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** The delay in milliseconds before the typeahead buffer is cleared. */
+    readonly typeaheadDelay: _angular_core.InputSignal<number>;
+    /** The menu ui pattern instance. */
+    readonly _pattern: MenuBarPattern<V>;
+    /** The menu items as a writable signal. */
+    private readonly _itemPatterns;
+    /** A callback function triggered when a menu item is selected. */
+    onSelect: _angular_core.OutputEmitterRef<V>;
+    constructor();
+    /** Closes the menubar. */
+    close(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuBar<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MenuBar<any>, "[ngMenuBar]", ["ngMenuBar"], { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "softDisabled": { "alias": "softDisabled"; "required": false; "isSignal": true; }; "values": { "alias": "values"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "typeaheadDelay": { "alias": "typeaheadDelay"; "required": false; "isSignal": true; }; }, { "values": "valuesChange"; "onSelect": "onSelect"; }, ["_allItems"], never, true, never>;
+}
+
+/**
+ * An item in a Menu.
+ *
+ * `ngMenuItem` directives can be used in `ngMenu` and `ngMenuBar` to represent a choice
+ * or action a user can take. They can also act as triggers for sub-menus.
+ *
+ * ```html
+ * <div ngMenuItem (onSelect)="doAction()">Action Item</div>
+ *
+ * <div ngMenuItem [submenu]="anotherMenu">Submenu Trigger</div>
+ * ```
+ *
+ * @developerPreview 21.0
+ *
+ * @see [Menu](guide/aria/menu)
+ * @see [MenuBar](guide/aria/menubar)
+ */
+declare class MenuItem<V> {
+    /** A reference to the host element. */
+    private readonly _elementRef;
+    /** A reference to the host element. */
+    readonly element: HTMLElement;
+    /** 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>;
+    /** Whether the menu item is disabled. */
+    readonly disabled: _angular_core.InputSignal<boolean>;
+    /** The search term associated with the menu item. */
+    readonly searchTerm: _angular_core.ModelSignal<string>;
+    /** A reference to the parent menu or menubar. */
+    readonly parent: Menu<V> | MenuBar<V> | null;
+    /** The submenu associated with the menu item. */
+    readonly submenu: _angular_core.InputSignal<Menu<V> | undefined>;
+    /** Whether the menu item is active. */
+    readonly active: _angular_core.Signal<boolean>;
     /** Whether the menu is expanded. */
-    readonly expanded: Signal<boolean>;
-    /** Whether the menu trigger has a popup. */
-    readonly hasPopup: Signal<boolean>;
-    /** Whether the menu trigger is disabled. */
-    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Whether the menu trigger is soft disabled. */
-    readonly softDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** The menu trigger ui pattern instance. */
-    _pattern: MenuTriggerPattern<V>;
+    readonly expanded: _angular_core.Signal<boolean | null>;
+    /** Whether the menu item has a popup. */
+    readonly hasPopup: _angular_core.Signal<boolean>;
+    /** The menu item ui pattern instance. */
+    readonly _pattern: MenuItemPattern<V>;
     constructor();
-    /** Opens the menu focusing on the first menu item. */
+    /** Opens the submenu focusing on the first menu item. */
     open(): void;
-    /** Closes the menu. */
+    /** Closes the submenu. */
     close(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuTrigger<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MenuTrigger<any>, "button[ngMenuTrigger]", ["ngMenuTrigger"], { "menu": { "alias": "menu"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "softDisabled": { "alias": "softDisabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    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; }; "submenu": { "alias": "submenu"; "required": false; "isSignal": true; }; }, { "searchTerm": "searchTermChange"; }, never, never, true, never>;
 }
+
 /**
  * A list of menu items.
  *
@@ -72,6 +143,9 @@ declare class MenuTrigger<V> {
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Menu](guide/aria/menu)
+ * @see [MenuBar](guide/aria/menubar)
  */
 declare class Menu<V> {
     /** The DeferredContentAware host directive. */
@@ -118,117 +192,58 @@ declare class Menu<V> {
     /** Closes the menu. */
     close(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<Menu<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Menu<any>, "[ngMenu]", ["ngMenu"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "typeaheadDelay": { "alias": "typeaheadDelay"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "expansionDelay": { "alias": "expansionDelay"; "required": false; "isSignal": true; }; }, { "onSelect": "onSelect"; }, ["_allItems"], never, true, [{ directive: typeof i1.DeferredContentAware; inputs: { "preserveContent": "preserveContent"; }; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Menu<any>, "[ngMenu]", ["ngMenu"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "typeaheadDelay": { "alias": "typeaheadDelay"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "expansionDelay": { "alias": "expansionDelay"; "required": false; "isSignal": true; }; }, { "onSelect": "onSelect"; }, ["_allItems"], never, true, [{ directive: typeof DeferredContentAware; inputs: { "preserveContent": "preserveContent"; }; outputs: {}; }]>;
 }
+
 /**
- * A menu bar of menu items.
+ * A trigger for a menu.
  *
- * Like the `ngMenu`, a `ngMenuBar` is used to offer a list of menu item choices to users.
- * However, a menubar is used to display a persistent, top-level, always-visible set of
- * menu item choices, typically found at the top of an application window.
+ * The `ngMenuTrigger` directive is used to open and close menus. It can be applied to
+ * any interactive element (e.g., a button) to associate it with a `ngMenu` instance.
+ * It also supports linking to sub-menus when applied to a `ngMenuItem`.
  *
  * ```html
- * <div ngMenuBar>
- *   <button ngMenuTrigger [menu]="fileMenu">File</button>
- *   <button ngMenuTrigger [menu]="editMenu">Edit</button>
- * </div>
- *
- * <div ngMenu #fileMenu="ngMenu">
- *   <div ngMenuItem>New</div>
- *   <div ngMenuItem>Open</div>
- * </div>
+ * <button ngMenuTrigger [menu]="myMenu">Open Menu</button>
  *
- * <div ngMenu #editMenu="ngMenu">
- *   <div ngMenuItem>Cut</div>
- *   <div ngMenuItem>Copy</div>
+ * <div ngMenu #myMenu="ngMenu">
+ *   <div ngMenuItem>Item 1</div>
+ *   <div ngMenuItem>Item 2</div>
  * </div>
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Menu](guide/aria/menu)
+ * @see [MenuBar](guide/aria/menubar)
  */
-declare class MenuBar<V> {
-    /** The menu items contained in the menubar. */
-    readonly _allItems: Signal<readonly MenuItem<V>[]>;
-    readonly _items: SignalLike<MenuItem<V>[]>;
+declare class MenuTrigger<V> {
     /** A reference to the host element. */
     private readonly _elementRef;
     /** A reference to the host element. */
     readonly element: HTMLElement;
-    /** Whether the menubar is disabled. */
-    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Whether the menubar is soft disabled. */
-    readonly softDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** The directionality (LTR / RTL) context for the application (or a subtree of it). */
     readonly textDirection: _angular_core.WritableSignal<_angular_cdk_bidi.Direction>;
-    /** The values of the currently selected menu items. */
-    readonly values: _angular_core.ModelSignal<V[]>;
-    /** Whether the menu should wrap its items. */
-    readonly wrap: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** The delay in milliseconds before the typeahead buffer is cleared. */
-    readonly typeaheadDelay: _angular_core.InputSignal<number>;
-    /** The menu ui pattern instance. */
-    readonly _pattern: MenuBarPattern<V>;
-    /** The menu items as a writable signal. */
-    private readonly _itemPatterns;
-    /** A callback function triggered when a menu item is selected. */
-    onSelect: _angular_core.OutputEmitterRef<V>;
-    constructor();
-    /** Closes the menubar. */
-    close(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuBar<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MenuBar<any>, "[ngMenuBar]", ["ngMenuBar"], { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "softDisabled": { "alias": "softDisabled"; "required": false; "isSignal": true; }; "values": { "alias": "values"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "typeaheadDelay": { "alias": "typeaheadDelay"; "required": false; "isSignal": true; }; }, { "values": "valuesChange"; "onSelect": "onSelect"; }, ["_allItems"], never, true, never>;
-}
-/**
- * An item in a Menu.
- *
- * `ngMenuItem` directives can be used in `ngMenu` and `ngMenuBar` to represent a choice
- * or action a user can take. They can also act as triggers for sub-menus.
- *
- * ```html
- * <div ngMenuItem (onSelect)="doAction()">Action Item</div>
- *
- * <div ngMenuItem [submenu]="anotherMenu">Submenu Trigger</div>
- * ```
- *
- * @developerPreview 21.0
- */
-declare class MenuItem<V> {
-    /** A reference to the host element. */
-    private readonly _elementRef;
-    /** A reference to the host element. */
-    readonly element: HTMLElement;
-    /** 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>;
-    /** Whether the menu item is disabled. */
-    readonly disabled: _angular_core.InputSignal<boolean>;
-    /** The search term associated with the menu item. */
-    readonly searchTerm: _angular_core.ModelSignal<string>;
-    /** A reference to the parent menu. */
-    private readonly _menu;
-    /** A reference to the parent menu bar. */
-    private readonly _menuBar;
-    /** A reference to the parent menu or menubar. */
-    readonly parent: Menu<V> | MenuBar<V> | null;
-    /** The submenu associated with the menu item. */
-    readonly submenu: _angular_core.InputSignal<Menu<V> | undefined>;
-    /** Whether the menu item is active. */
-    readonly active: Signal<boolean>;
+    /** The menu associated with the trigger. */
+    menu: _angular_core.InputSignal<Menu<V> | undefined>;
     /** Whether the menu is expanded. */
-    readonly expanded: Signal<boolean | null>;
-    /** Whether the menu item has a popup. */
-    readonly hasPopup: Signal<boolean>;
-    /** The menu item ui pattern instance. */
-    readonly _pattern: MenuItemPattern<V>;
+    readonly expanded: _angular_core.Signal<boolean>;
+    /** Whether the menu trigger has a popup. */
+    readonly hasPopup: _angular_core.Signal<boolean>;
+    /** Whether the menu trigger is disabled. */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Whether the menu trigger is soft disabled. */
+    readonly softDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** The menu trigger ui pattern instance. */
+    _pattern: MenuTriggerPattern<V>;
     constructor();
-    /** Opens the submenu focusing on the first menu item. */
+    /** Opens the menu focusing on the first menu item. */
     open(): void;
-    /** Closes the submenu. */
+    /** Closes the menu. */
     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; }; "submenu": { "alias": "submenu"; "required": false; "isSignal": true; }; }, { "searchTerm": "searchTermChange"; }, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuTrigger<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MenuTrigger<any>, "button[ngMenuTrigger]", ["ngMenuTrigger"], { "menu": { "alias": "menu"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "softDisabled": { "alias": "softDisabled"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
+
 /**
  * Defers the rendering of the menu content.
  *
@@ -245,10 +260,13 @@ declare class MenuItem<V> {
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Menu](guide/aria/menu)
+ * @see [MenuBar](guide/aria/menubar)
  */
 declare class MenuContent {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuContent, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MenuContent, "ng-template[ngMenuContent]", ["ngMenuContent"], {}, {}, never, never, true, [{ directive: typeof i1.DeferredContent; inputs: {}; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MenuContent, "ng-template[ngMenuContent]", ["ngMenuContent"], {}, {}, never, never, true, [{ directive: typeof DeferredContent; inputs: {}; outputs: {}; }]>;
 }
 
-export { Menu, MenuBar, MenuContent, MenuItem, MenuTrigger };
+export { Menu, MenuBar, MenuContent, MenuItem, MenuTrigger, DeferredContent as ɵɵDeferredContent, DeferredContentAware as ɵɵDeferredContentAware };