@angular/aria 22.0.0-next.6 → 22.0.0-next.7

package/types/combobox.d.ts

@@ -4,7 +4,6 @@ import { ComboboxListboxControls, ComboboxTreeControls, ComboboxDialogPattern, C
 import { DeferredContentAware, DeferredContent } from './_deferred-content-chunk.js';
 import './_keyboard-event-manager-chunk.js';
 import './_signal-like-chunk.js';
-import './_pointer-event-manager-chunk.js';
 import './_list-chunk.js';
 import './_list-navigation-chunk.js';
 
@@ -132,16 +131,18 @@ declare class ComboboxDialog {
     /** The dialog element. */
     private readonly _elementRef;
     /** A reference to the dialog element. */
-    readonly element: HTMLElement;
+    readonly element: HTMLDialogElement;
     /** The combobox that the dialog belongs to. */
     readonly combobox: Combobox<any>;
+    /** The unique identifier for the trigger. */
+    readonly id: _angular_core.InputSignal<string>;
     /** A reference to the parent combobox popup, if one exists. */
     private readonly _popup;
     readonly _pattern: ComboboxDialogPattern;
     constructor();
     close(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComboboxDialog, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxDialog, "dialog[ngComboboxDialog]", ["ngComboboxDialog"], {}, {}, never, never, true, [{ directive: typeof ComboboxPopup; inputs: {}; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxDialog, "dialog[ngComboboxDialog]", ["ngComboboxDialog"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof ComboboxPopup; inputs: {}; outputs: {}; }]>;
 }
 
 /**

package/types/grid-testing.d.ts

@@ -0,0 +1,79 @@
+import { BaseHarnessFilters, ContentContainerComponentHarness, HarnessPredicate, ComponentHarness } from '@angular/cdk/testing';
+
+/** Filters for locating a `GridCellHarness`. */
+interface GridCellHarnessFilters extends BaseHarnessFilters {
+    /** Only find instances whose text matches the given value. */
+    text?: string | RegExp;
+    /** Only find instances whose selected state matches the given value. */
+    selected?: boolean;
+    /** Only find instances whose disabled state matches the given value. */
+    disabled?: boolean;
+}
+/** Filters for locating a `GridRowHarness`. */
+interface GridRowHarnessFilters extends BaseHarnessFilters {
+}
+/** Filters for locating a `GridHarness`. */
+interface GridHarnessFilters extends BaseHarnessFilters {
+    /** Only find instances whose disabled state matches the given value. */
+    disabled?: boolean;
+}
+
+/** Harness for interacting with a standard ngGridCell in tests. */
+declare class GridCellHarness extends ContentContainerComponentHarness {
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a grid cell with specific attributes.
+     * @param options Options for filtering which cell instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with(options?: GridCellHarnessFilters): HarnessPredicate<GridCellHarness>;
+    /** Whether the cell is selected. */
+    isSelected(): Promise<boolean>;
+    /** Whether the cell is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Gets the text content of the cell. */
+    getText(): Promise<string>;
+    /** Clicks the cell. */
+    click(): Promise<void>;
+    /** Focuses the cell. */
+    focus(): Promise<void>;
+    /** Blurs the cell. */
+    blur(): Promise<void>;
+}
+/** Harness for interacting with a standard ngGridRow in tests. */
+declare class GridRowHarness extends ComponentHarness {
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a grid row with specific attributes.
+     * @param options Options for filtering which row instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with(options?: GridRowHarnessFilters): HarnessPredicate<GridRowHarness>;
+    /** Gets all cells in the row. */
+    getCells(filters?: GridCellHarnessFilters): Promise<GridCellHarness[]>;
+    /** Gets the text of the cells in the row. */
+    getCellTextByIndex(filters?: GridCellHarnessFilters): Promise<string[]>;
+}
+/** Harness for interacting with a standard ngGrid in tests. */
+declare class GridHarness extends ComponentHarness {
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a grid with specific attributes.
+     * @param options Options for filtering which grid instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with(options?: GridHarnessFilters): HarnessPredicate<GridHarness>;
+    /** Whether the grid is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Whether the grid is multi-selectable. */
+    isMultiSelectable(): Promise<boolean>;
+    /** Gets all rows in the grid. */
+    getRows(filters?: GridRowHarnessFilters): Promise<GridRowHarness[]>;
+    /** Gets all cells in the grid. */
+    getCells(filters?: GridCellHarnessFilters): Promise<GridCellHarness[]>;
+    /** Gets the text inside the entire grid organized by rows. */
+    getCellTextByIndex(): Promise<string[][]>;
+}
+
+export { GridCellHarness, GridHarness, GridRowHarness };
+export type { GridCellHarnessFilters, GridHarnessFilters, GridRowHarnessFilters };

package/types/grid.d.ts

@@ -1,10 +1,10 @@
 import * as _angular_core from '@angular/core';
-import { Signal, ElementRef } from '@angular/core';
+import { Signal, EventEmitter } from '@angular/core';
 import * as _angular_cdk_bidi from '@angular/cdk/bidi';
-import { GridPattern, GridCellPattern, GridRowPattern, GridCellWidgetPattern } from './_grid-chunk.js';
+import { GridPattern, GridCellPattern, GridRowPattern, ElementResolver, GridCellWidgetPattern } from './_grid-chunk.js';
 import './_signal-like-chunk.js';
 import './_keyboard-event-manager-chunk.js';
-import './_pointer-event-manager-chunk.js';
+import './_click-event-manager-chunk.js';
 
 /**
  * The container for a grid. It provides keyboard navigation and focus management for the grid's
@@ -77,13 +77,19 @@ declare class Grid {
      * - `explicit`: Cells are selected explicitly by the user (e.g., via click or spacebar).
      */
     readonly selectionMode: _angular_core.InputSignal<"follow" | "explicit">;
+    /** The tabindex of the grid. */
+    readonly tabIndex: _angular_core.InputSignalWithTransform<number | undefined, string | number | undefined>;
     /** The UI pattern for the grid. */
     readonly _pattern: GridPattern;
+    /** The ID of the active descendant in the grid. */
+    readonly activeDescendant: Signal<string | undefined>;
     constructor();
+    /** Scrolls the active cell into view. */
+    scrollActiveCellIntoView(options?: ScrollIntoViewOptions): void;
     /** Gets the cell pattern for a given element. */
     private _getCell;
     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; }; }, {}, ["_rows"], never, true, 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; }; "tabIndex": { "alias": "tabIndex"; "required": false; "isSignal": true; }; }, {}, ["_rows"], never, true, never>;
 }
 
 /**
@@ -106,6 +112,8 @@ declare class GridCell {
     private readonly _renderer;
     /** A reference to the host element. */
     readonly element: HTMLElement;
+    /** Emits when the cell is activated via Enter/Space (simple widgets only). */
+    readonly activated: EventEmitter<KeyboardEvent>;
     /** Whether the cell is currently active (focused). */
     readonly active: Signal<boolean>;
     /** The widget contained within this cell, if any. */
@@ -148,7 +156,7 @@ declare class GridCell {
     /** Gets the cell widget pattern for a given element. */
     private _getWidget;
     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; }; "tabindex": { "alias": "tabindex"; "required": false; "isSignal": true; }; }, { "selected": "selectedChange"; }, ["_widget"], never, true, 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; }; "tabindex": { "alias": "tabindex"; "required": false; "isSignal": true; }; }, { "activated": "activated"; "selected": "selectedChange"; }, ["_widget"], never, true, never>;
 }
 
 /**
@@ -219,7 +227,7 @@ declare class GridCellWidget {
     /** Whether the widget is disabled. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** The target that will receive focus instead of the widget. */
-    readonly focusTarget: _angular_core.InputSignal<ElementRef<any> | HTMLElement | undefined>;
+    readonly focusTarget: _angular_core.InputSignal<ElementResolver<HTMLElement>>;
     /** Emits when the widget is activated. */
     readonly activated: _angular_core.OutputEmitterRef<KeyboardEvent | FocusEvent | undefined>;
     /** Emits when the widget is deactivated. */

package/types/listbox.d.ts

@@ -1,5 +1,6 @@
 import * as _angular_cdk_bidi from '@angular/cdk/bidi';
 import * as _angular_core from '@angular/core';
+import { Signal } from '@angular/core';
 import { OptionPattern, ListboxPattern } 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';
@@ -9,7 +10,6 @@ import './_list-navigation-chunk.js';
 import './_keyboard-event-manager-chunk.js';
 import './_click-event-manager-chunk.js';
 import './_combobox-chunk.js';
-import './_pointer-event-manager-chunk.js';
 import './_deferred-content-chunk.js';
 
 /**
@@ -48,9 +48,9 @@ declare class Listbox<V> {
     /** The Options nested inside of the Listbox. */
     private readonly _options;
     /** A signal wrapper for directionality. */
-    protected readonly textDirection: _angular_core.Signal<_angular_cdk_bidi.Direction>;
+    protected readonly textDirection: Signal<_angular_cdk_bidi.Direction>;
     /** The Option UIPatterns of the child Options. */
-    protected readonly items: _angular_core.Signal<OptionPattern<V>[]>;
+    protected readonly items: Signal<OptionPattern<V>[]>;
     /** Whether the list is vertically or horizontally oriented. */
     readonly orientation: _angular_core.InputSignal<"vertical" | "horizontal">;
     /** Whether multiple items in the list can be selected at once. */
@@ -80,16 +80,20 @@ declare class Listbox<V> {
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Whether the listbox is readonly. */
     readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** The tabindex of the listbox. */
+    readonly tabIndex: _angular_core.InputSignalWithTransform<number | undefined, string | number | undefined>;
     /** The values of the currently selected items. */
     readonly value: _angular_core.ModelSignal<V[]>;
     /** The Listbox UIPattern. */
     readonly _pattern: ListboxPattern<V>;
+    /** The ID of the active descendant in the listbox. */
+    readonly activeDescendant: Signal<string | undefined>;
     constructor();
     scrollActiveItemIntoView(options?: ScrollIntoViewOptions): void;
     /** Navigates to the first item in the listbox. */
     gotoFirst(): void;
     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; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["_options"], never, true, [{ directive: typeof ComboboxPopup; inputs: {}; outputs: {}; }]>;
+    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; }; "tabIndex": { "alias": "tabIndex"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, ["_options"], never, true, [{ directive: typeof ComboboxPopup; inputs: {}; outputs: {}; }]>;
 }
 
 /**
@@ -121,8 +125,6 @@ declare class Option<V> {
     private readonly _listbox;
     /** A unique identifier for the option. */
     readonly id: _angular_core.InputSignal<string>;
-    /** The text used by the typeahead search. */
-    protected readonly searchTerm: _angular_core.Signal<string>;
     /** The parent Listbox UIPattern. */
     private readonly _listboxPattern;
     /** The value of the option. */

package/types/menu.d.ts

@@ -175,11 +175,14 @@ declare class Menu<V> {
     /** The menu ui pattern instance. */
     readonly _pattern: MenuPattern<V>;
     /**
-     * The menu items as a writable signal.
+     * The menu item patterns for the menu items that are direct children of this menu, passed
+     * to the menu pattern.
      *
-     * TODO(wagnermaciel): This would normally be a computed, but using a computed causes a bug where
-     * sometimes the items array is empty. The bug can be reproduced by switching this to use a
-     * computed and then quickly opening and closing menus in the dev app.
+     * Note: contentChildren has an issue where it will return a successively smaller list
+     * each time that the menu is open and closed, eventually resulting in an empty list.
+     * The workaround is to trigger a recomputation of this signal whenever the menu is opened
+     * or closed, by calling this._pattern.visible() in the signal body. Otherwise, computed could
+     * not be used and would have to rebuild the list each time this method is called.
      */
     private readonly _itemPatterns;
     /** Whether the menu is visible. */

package/types/private.d.ts

@@ -2,25 +2,24 @@ import { ComboboxPattern, ComboboxListboxControls, ComboboxTreeControls } from '
 export { ComboboxDialogPattern, ComboboxInputs } from './_combobox-chunk.js';
 import { ListboxInputs, OptionPattern, ListboxPattern } from './_listbox-chunk.js';
 export { OptionInputs } from './_listbox-chunk.js';
-import { SignalLike } from './_signal-like-chunk.js';
-export { WritableSignalLike, computed, convertGetterSetterToWritableSignalLike, linkedSignal, signal } from './_signal-like-chunk.js';
+import { SignalLike, WritableSignalLike } from './_signal-like-chunk.js';
+export { computed, convertGetterSetterToWritableSignalLike, linkedSignal, signal } from './_signal-like-chunk.js';
 export { MenuBarInputs, MenuBarPattern, MenuInputs, MenuItemInputs, MenuItemPattern, MenuPattern, MenuTriggerInputs, MenuTriggerPattern } from './_menu-chunk.js';
 export { TabInputs, TabListInputs, TabListPattern, TabPanelInputs, TabPanelPattern, TabPattern } from './_tabs-chunk.js';
 export { ToolbarInputs, ToolbarPattern, ToolbarWidgetGroupInputs, ToolbarWidgetGroupPattern, ToolbarWidgetInputs, ToolbarWidgetPattern } from './_toolbar-chunk.js';
 export { AccordionGroupInputs, AccordionGroupPattern, AccordionTriggerInputs, AccordionTriggerPattern } from './_accordion-chunk.js';
 import { TreeInputs, TreeItemPattern, TreePattern } from './_tree-chunk.js';
 export { TreeItemInputs } from './_tree-chunk.js';
-export { GridCellInputs, GridCellPattern, GridCellWidgetInputs, GridCellWidgetPattern, GridInputs, GridPattern, GridRowInputs, GridRowPattern } from './_grid-chunk.js';
+export { ElementResolver, GridCellInputs, GridCellPattern, GridCellWidgetInputs, GridCellWidgetPattern, GridInputs, GridPattern, GridRowInputs, GridRowPattern, resolveElement } from './_grid-chunk.js';
 export { DeferredContent, DeferredContentAware } from './_deferred-content-chunk.js';
 export { HasElement, sortDirectives } from './_element-chunk.js';
+import * as _angular_core from '@angular/core';
+import { KeyboardEventManager } from './_keyboard-event-manager-chunk.js';
+import { ClickEventManager } from './_click-event-manager-chunk.js';
+import { ExpansionItem } from './_expansion-chunk.js';
 export { untracked } from '@angular/core/primitives/signals';
-import './_keyboard-event-manager-chunk.js';
-import './_pointer-event-manager-chunk.js';
 import './_list-chunk.js';
 import './_list-navigation-chunk.js';
-import './_click-event-manager-chunk.js';
-import './_expansion-chunk.js';
-import '@angular/core';
 
 type ComboboxListboxInputs<V> = ListboxInputs<V> & {
     /** The combobox controlling the listbox. */
@@ -141,5 +140,102 @@ declare class ComboboxTreePattern<V> extends TreePattern<V> implements ComboboxT
     readonly isItemSelectable: (item?: TreeItemPattern<V> | undefined) => boolean;
 }
 
-export { ComboboxListboxControls, ComboboxListboxPattern, ComboboxPattern, ComboboxTreeControls, ComboboxTreePattern, ListboxInputs, ListboxPattern, OptionPattern, SignalLike, TreeInputs, TreeItemPattern, TreePattern };
-export type { ComboboxListboxInputs, ComboboxTreeInputs };
+/** Represents the required inputs for a simple combobox. */
+interface SimpleComboboxInputs extends ExpansionItem {
+    /** Whether the combobox should always remain expanded. */
+    alwaysExpanded: SignalLike<boolean>;
+    /** The value of the combobox. */
+    value: WritableSignalLike<string>;
+    /** The element that the combobox is attached to. */
+    element: SignalLike<HTMLElement>;
+    /** The popup associated with the combobox. */
+    popup: SignalLike<SimpleComboboxPopupPattern | undefined>;
+    /** An inline suggestion to be displayed in the input. */
+    inlineSuggestion: SignalLike<string | undefined>;
+    /** Whether the combobox is disabled. */
+    disabled: SignalLike<boolean>;
+}
+/** Controls the state of a simple combobox. */
+declare class SimpleComboboxPattern {
+    readonly inputs: SimpleComboboxInputs;
+    /** The expanded state of the combobox. */
+    readonly isExpanded: _angular_core.Signal<boolean>;
+    /** The value of the combobox. */
+    readonly value: WritableSignalLike<string>;
+    /** The element that the combobox is attached to. */
+    readonly element: () => HTMLElement;
+    /** Whether the combobox is disabled. */
+    readonly disabled: () => boolean;
+    /** An inline suggestion to be displayed in the input. */
+    readonly inlineSuggestion: () => string | undefined;
+    /** The ID of the active descendant in the popup. */
+    readonly activeDescendant: _angular_core.Signal<string | undefined>;
+    /** The ID of the popup. */
+    readonly popupId: _angular_core.Signal<string | undefined>;
+    /** The type of the popup. */
+    readonly popupType: _angular_core.Signal<"listbox" | "tree" | "grid" | "dialog" | undefined>;
+    /** The autocomplete behavior of the combobox. */
+    readonly autocomplete: _angular_core.Signal<"none" | "inline" | "list" | "both">;
+    /** A relay for keyboard events to the popup. */
+    readonly keyboardEventRelay: _angular_core.WritableSignal<KeyboardEvent | undefined>;
+    /** Whether the combobox is focused. */
+    readonly isFocused: _angular_core.WritableSignal<boolean>;
+    /** Whether the most recent input event was a deletion. */
+    readonly isDeleting: _angular_core.WritableSignal<boolean>;
+    /** Whether the combobox is editable (i.e., an input or textarea). */
+    readonly isEditable: _angular_core.Signal<boolean>;
+    /** The keydown event manager for the combobox. */
+    keydown: _angular_core.Signal<KeyboardEventManager<KeyboardEvent>>;
+    /** The click event manager for the combobox. */
+    click: _angular_core.Signal<ClickEventManager<PointerEvent>>;
+    constructor(inputs: SimpleComboboxInputs);
+    /** Handles keydown events for the combobox. */
+    onKeydown(event: KeyboardEvent): void;
+    /** Handles click events for the combobox. */
+    onClick(event: PointerEvent): void;
+    /** Handles focus in events for the combobox. */
+    onFocusin(): void;
+    /** Handles focus out events for the combobox. */
+    onFocusout(event: FocusEvent): void;
+    /** Handles input events for the combobox. */
+    onInput(event: Event): void;
+    /** Highlights the currently selected item in the combobox. */
+    highlightEffect(): void;
+    /** Relays keyboard events to the popup. */
+    keyboardEventRelayEffect(): void;
+    /** Closes the popup when focus leaves the combobox and popup. */
+    closePopupOnBlurEffect(): void;
+}
+/** Represents the required inputs for a simple combobox popup. */
+interface SimpleComboboxPopupInputs {
+    /** The type of the popup. */
+    popupType: SignalLike<'listbox' | 'tree' | 'grid' | 'dialog'>;
+    /** The element that serves as the control target for the popup. */
+    controlTarget: SignalLike<HTMLElement | undefined>;
+    /** The ID of the active descendant in the popup. */
+    activeDescendant: SignalLike<string | undefined>;
+    /** The ID of the popup. */
+    popupId: SignalLike<string | undefined>;
+}
+/** Controls the state of a simple combobox popup. */
+declare class SimpleComboboxPopupPattern {
+    readonly inputs: SimpleComboboxPopupInputs;
+    /** The type of the popup. */
+    readonly popupType: () => "listbox" | "tree" | "grid" | "dialog";
+    /** The element that serves as the control target for the popup. */
+    readonly controlTarget: () => HTMLElement | undefined;
+    /** The ID of the active descendant in the popup. */
+    readonly activeDescendant: () => string | undefined;
+    /** The ID of the popup. */
+    readonly popupId: () => string | undefined;
+    /** Whether the popup is focused. */
+    readonly isFocused: _angular_core.WritableSignal<boolean>;
+    constructor(inputs: SimpleComboboxPopupInputs);
+    /** Handles focus in events for the popup. */
+    onFocusin(): void;
+    /** Handles focus out events for the popup. */
+    onFocusout(event: FocusEvent): void;
+}
+
+export { ComboboxListboxControls, ComboboxListboxPattern, ComboboxPattern, ComboboxTreeControls, ComboboxTreePattern, ListboxInputs, ListboxPattern, OptionPattern, SignalLike, SimpleComboboxPattern, SimpleComboboxPopupPattern, TreeInputs, TreeItemPattern, TreePattern, WritableSignalLike };
+export type { ComboboxListboxInputs, ComboboxTreeInputs, SimpleComboboxInputs, SimpleComboboxPopupInputs };

package/types/simple-combobox.d.ts

@@ -0,0 +1,124 @@
+import * as _angular_core from '@angular/core';
+import { OnInit, OnDestroy } from '@angular/core';
+import * as i1 from '@angular/aria/private';
+import { SimpleComboboxPopupPattern, DeferredContentAware, SimpleComboboxPattern } from '@angular/aria/private';
+export { DeferredContent as ɵɵDeferredContent, DeferredContentAware as ɵɵDeferredContentAware } from './_deferred-content-chunk.js';
+
+/**
+ * Identifies an element as a widget within a combobox popup.
+ *
+ * This directive should be applied to the element that contains the options or content
+ * of the popup. It handles the communication of ID and active descendant information
+ * to the combobox.
+ */
+declare class ComboboxWidget implements OnInit, OnDestroy {
+    /** The element that the popup widget is attached to. */
+    private readonly _elementRef;
+    private readonly _popup;
+    /** A reference to the popup widget element. */
+    readonly element: HTMLElement;
+    /** The ID of the popup widget. */
+    readonly popupId: _angular_core.WritableSignal<string | undefined>;
+    /** The ID of the active descendant in the widget. */
+    readonly activeDescendant: _angular_core.InputSignal<string | undefined>;
+    private _observer;
+    constructor();
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    /** Handles focus in events for the widget. */
+    onFocusin(): void;
+    /** Handles focus out events for the widget. */
+    onFocusout(event: FocusEvent): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComboboxWidget, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxWidget, "[ngComboboxWidget]", ["ngComboboxWidget"], { "activeDescendant": { "alias": "activeDescendant"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * A structural directive that marks the `ng-template` to be used as the popup
+ * for a combobox. This content is conditionally rendered.
+ *
+ * The content of the popup can be any element with the `ngComboboxWidget` directive.
+ *
+ * ```html
+ * <ng-template ngComboboxPopup>
+ *   <div ngComboboxWidget>
+ *     <!-- ... options ... -->
+ *   </div>
+ * </ng-template>
+ * ```
+ */
+declare class ComboboxPopup implements OnInit, OnDestroy {
+    private readonly _deferredContent;
+    /** The combobox that the popup belongs to. */
+    readonly combobox: _angular_core.InputSignal<Combobox>;
+    /** The widget contained within the popup. */
+    readonly _widget: _angular_core.WritableSignal<ComboboxWidget | undefined>;
+    /** The element that serves as the control target for the popup. */
+    readonly controlTarget: _angular_core.Signal<HTMLElement | undefined>;
+    /** The ID of the popup. */
+    readonly popupId: _angular_core.Signal<string | undefined>;
+    /** The ID of the active descendant in the popup. */
+    readonly activeDescendant: _angular_core.Signal<string | undefined>;
+    /** The type of the popup (e.g., listbox, tree, grid, dialog). */
+    readonly popupType: _angular_core.InputSignal<"listbox" | "tree" | "grid" | "dialog">;
+    /** The popup pattern. */
+    readonly _pattern: SimpleComboboxPopupPattern;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    /** Registers a widget with the popup. */
+    _registerWidget(widget: ComboboxWidget): void;
+    /** Unregisters the widget from the popup. */
+    _unregisterWidget(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComboboxPopup, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxPopup, "ng-template[ngComboboxPopup]", ["ngComboboxPopup"], { "combobox": { "alias": "combobox"; "required": true; "isSignal": true; }; "popupType": { "alias": "popupType"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.DeferredContent; inputs: {}; outputs: {}; }]>;
+}
+
+/**
+ * The container element that wraps a combobox input and popup, and orchestrates its behavior.
+ *
+ * The `ngCombobox` directive is the main entry point for creating a combobox and customizing its
+ * behavior. It coordinates the interactions between the input and the popup.
+ *
+ * ```html
+ * <div ngCombobox [(expanded)]="expanded">
+ *   <input ngComboboxInput />
+ *
+ *   <ng-template ngComboboxPopup>
+ *     <div ngComboboxWidget>
+ *       <!-- ... options ... -->
+ *     </div>
+ *   </ng-template>
+ * </div>
+ * ```
+ */
+declare class Combobox extends DeferredContentAware implements OnInit {
+    private readonly _renderer;
+    /** The element that the combobox is attached to. */
+    private readonly _elementRef;
+    /** A reference to the input element. */
+    readonly element: HTMLElement;
+    /** The popup associated with the combobox. */
+    readonly _popup: _angular_core.WritableSignal<ComboboxPopup | undefined>;
+    /** Whether the combobox is disabled. */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Whether the combobox should always remain expanded. */
+    readonly alwaysExpanded: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Whether the combobox is expanded. */
+    readonly expanded: _angular_core.ModelSignal<boolean>;
+    /** The value of the combobox input. */
+    readonly value: _angular_core.ModelSignal<string>;
+    /** An inline suggestion to be displayed in the input. */
+    readonly inlineSuggestion: _angular_core.InputSignal<string | undefined>;
+    /** The combobox ui pattern. */
+    readonly _pattern: SimpleComboboxPattern;
+    constructor();
+    ngOnInit(): void;
+    /** Registers a popup with the combobox. */
+    _registerPopup(popup: ComboboxPopup): void;
+    /** Unregisters the popup from the combobox. */
+    _unregisterPopup(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<Combobox, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Combobox, "[ngCombobox]", ["ngCombobox"], { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "alwaysExpanded": { "alias": "alwaysExpanded"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "inlineSuggestion": { "alias": "inlineSuggestion"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; "value": "valueChange"; }, never, never, true, never>;
+}
+
+export { Combobox, ComboboxPopup, ComboboxWidget };