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

package/types/listbox-testing.d.ts

@@ -15,24 +15,49 @@ interface ListboxHarnessFilters extends BaseHarnessFilters {
     disabled?: boolean;
 }
 
+/** Harness for interacting with a standard ngOption in tests. */
 declare class ListboxOptionHarness extends ComponentHarness {
     static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for an option
+     * with specific attributes.
+     * @param options Options for filtering which option instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
     static with(options?: ListboxOptionHarnessFilters): HarnessPredicate<ListboxOptionHarness>;
+    /** Whether the option is selected. */
     isSelected(): Promise<boolean>;
+    /** Whether the option is disabled. */
     isDisabled(): Promise<boolean>;
+    /** Gets the option's text. */
     getText(): Promise<string>;
+    /** Clicks the option to toggle its selected state. */
     click(): Promise<void>;
 }
+/** Harness for interacting with a standard ngListbox in tests. */
 declare class ListboxHarness extends ComponentHarness {
     static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a listbox
+     * with specific attributes.
+     * @param options Options for filtering which listbox instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
     static with(options?: ListboxHarnessFilters): HarnessPredicate<ListboxHarness>;
+    /** Gets the orientation of the listbox. */
     getOrientation(): Promise<'vertical' | 'horizontal'>;
+    /** Whether the listbox is multiselectable. */
     isMulti(): Promise<boolean>;
+    /** Whether the listbox is disabled. */
     isDisabled(): Promise<boolean>;
+    /** Gets the options inside the listbox. */
     getOptions(filters?: ListboxOptionHarnessFilters): Promise<ListboxOptionHarness[]>;
+    /** Focuses the listbox container. */
     focus(): Promise<void>;
     /** Blurs the listbox container. */
     blur(): Promise<void>;
+    /** Gets the ID of the active option. */
+    getActiveDescendantId(): Promise<string | null>;
 }
 
 export { ListboxHarness, ListboxOptionHarness };

package/types/listbox.d.ts

@@ -1,16 +1,59 @@
 import * as _angular_cdk_bidi from '@angular/cdk/bidi';
 import * as _angular_core from '@angular/core';
+import { OnInit, OnDestroy, 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';
-import './_signal-like-chunk.js';
+import { SortedCollection } from './_collection-chunk.js';
 import './_list-chunk.js';
 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';
+
+/**
+ * A selectable option in an `ngListbox`.
+ *
+ * This directive should be applied to an element (e.g., `<li>`, `<div>`) within an
+ * `ngListbox`. The `value` input is used to identify the option, and the `label` input provides
+ * the accessible name for the option.
+ *
+ * ```html
+ * <li ngOption value="item-id" label="Item Name">
+ *   Item Name
+ * </li>
+ * ```
+ *
+ * @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> implements OnInit, OnDestroy {
+    /** A reference to the host element. */
+    readonly element: HTMLElement;
+    /** Whether the option is currently active (focused). */
+    readonly active: _angular_core.Signal<boolean>;
+    /** The parent Listbox. */
+    private readonly _listbox;
+    /** A unique identifier for the option. */
+    readonly id: _angular_core.InputSignal<string>;
+    /** The parent Listbox UIPattern. */
+    private readonly _listboxPattern;
+    /** The value of the option. */
+    readonly value: _angular_core.InputSignal<V>;
+    /** Whether an item is disabled. */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** The text used by the typeahead search. */
+    readonly label: _angular_core.InputSignal<string | undefined>;
+    /** Whether the option is selected. */
+    readonly selected: _angular_core.Signal<boolean | undefined>;
+    /** The Option UIPattern. */
+    readonly _pattern: OptionPattern<V>;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<Option<any>, never>;
+    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>;
+}
 
 /**
  * Represents a container used to display a list of items for a user to select from.
@@ -36,21 +79,17 @@ import './_deferred-content-chunk.js';
  * @see [Select](guide/aria/select)
  * @see [Multiselect](guide/aria/multiselect)
  */
-declare class Listbox<V> {
+declare class Listbox<V> implements OnDestroy {
     /** A unique identifier for the listbox. */
     readonly id: _angular_core.InputSignal<string>;
-    /** A reference to the parent combobox popup, if one exists. */
-    private readonly _popup;
     /** A reference to the host element. */
     private readonly _elementRef;
     /** A reference to the host element. */
     readonly element: HTMLElement;
-    /** The Options nested inside of the Listbox. */
-    private readonly _options;
+    /** The collection of Options. */
+    readonly _collection: SortedCollection<Option<V>>;
     /** A signal wrapper for directionality. */
-    protected readonly textDirection: _angular_core.Signal<_angular_cdk_bidi.Direction>;
-    /** The Option UIPatterns of the child Options. */
-    protected readonly items: _angular_core.Signal<OptionPattern<V>[]>;
+    protected readonly textDirection: Signal<_angular_cdk_bidi.Direction>;
     /** 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,63 +119,21 @@ 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();
+    ngOnDestroy(): void;
     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: {}; }]>;
-}
-
-/**
- * A selectable option in an `ngListbox`.
- *
- * This directive should be applied to an element (e.g., `<li>`, `<div>`) within an
- * `ngListbox`. The `value` input is used to identify the option, and the `label` input provides
- * the accessible name for the option.
- *
- * ```html
- * <li ngOption value="item-id" label="Item Name">
- *   Item Name
- * </li>
- * ```
- *
- * @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. */
-    readonly element: HTMLElement;
-    /** Whether the option is currently active (focused). */
-    readonly active: _angular_core.Signal<boolean>;
-    /** The parent Listbox. */
-    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. */
-    readonly value: _angular_core.InputSignal<V>;
-    /** Whether an item is disabled. */
-    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** The text used by the typeahead search. */
-    readonly label: _angular_core.InputSignal<string | undefined>;
-    /** Whether the option is selected. */
-    readonly selected: _angular_core.Signal<boolean | undefined>;
-    /** The Option UIPattern. */
-    readonly _pattern: OptionPattern<V>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<Option<any>, never>;
-    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>;
+    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"; }, never, never, true, never>;
 }
 
-export { Listbox, Option, ComboboxPopup as ɵɵComboboxPopup };
+export { Listbox, Option };

package/types/menu-testing.d.ts

@@ -29,6 +29,10 @@ declare class MenuItemHarness extends ComponentHarness {
     click(): Promise<void>;
     /** Resolves the nested submenu panel associated with this menu item, if any exists. */
     getSubmenu(): Promise<MenuHarness | null>;
+    /** Whether the menu item has focus. */
+    isFocused(): Promise<boolean>;
+    /** Whether the menu item acts as a submenu trigger. */
+    hasSubmenu(): Promise<boolean>;
 }
 /** Harness for interacting with a standard ngMenu or ngMenuBar in tests. */
 declare class MenuHarness extends ComponentHarness {
@@ -38,6 +42,8 @@ declare class MenuHarness extends ComponentHarness {
     _getTrigger(): Promise<TestElement | null>;
     /** Checks whether the menu container is visible. */
     isOpen(): Promise<boolean>;
+    /** Whether the menu is a menu bar. */
+    isMenuBar(): Promise<boolean>;
     /** Opens the menu if it is currently closed. */
     open(): Promise<void>;
     /** Closes the menu if it is currently open. */

package/types/menu.d.ts

@@ -1,9 +1,9 @@
 import * as _angular_core from '@angular/core';
-import { Signal } from '@angular/core';
+import { OnDestroy, OnInit, Signal } from '@angular/core';
 import * as _angular_cdk_bidi from '@angular/cdk/bidi';
 import { MenuBarPattern, MenuItemPattern, MenuPattern, MenuTriggerPattern } from './_menu-chunk.js';
 import { DeferredContentAware, DeferredContent } from './_deferred-content-chunk.js';
-import { SignalLike } from './_signal-like-chunk.js';
+import { SortedCollection, SignalLike } from './_collection-chunk.js';
 import './_keyboard-event-manager-chunk.js';
 import './_list-chunk.js';
 import './_list-navigation-chunk.js';
@@ -37,9 +37,9 @@ import './_list-navigation-chunk.js';
  * @see [Menu](guide/aria/menu)
  * @see [MenuBar](guide/aria/menubar)
  */
-declare class MenuBar<V> {
-    /** The menu items contained in the menubar. */
-    readonly _allItems: _angular_core.Signal<readonly MenuItem<V>[]>;
+declare class MenuBar<V> implements OnDestroy {
+    /** The collection of menu items. */
+    readonly _collection: SortedCollection<MenuItem<V>>;
     readonly _items: SignalLike<MenuItem<V>[]>;
     /** A reference to the host element. */
     private readonly _elementRef;
@@ -64,10 +64,11 @@ declare class MenuBar<V> {
     /** A callback function triggered when a menu item is selected. */
     readonly itemSelected: _angular_core.OutputEmitterRef<V>;
     constructor();
+    ngOnDestroy(): void;
     /** 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; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "typeaheadDelay": { "alias": "typeaheadDelay"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "itemSelected": "itemSelected"; }, ["_allItems"], never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MenuBar<any>, "[ngMenuBar]", ["ngMenuBar"], { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "softDisabled": { "alias": "softDisabled"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "typeaheadDelay": { "alias": "typeaheadDelay"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "itemSelected": "itemSelected"; }, never, never, true, never>;
 }
 
 /**
@@ -78,7 +79,7 @@ declare class MenuBar<V> {
  *
  * ```html
  * <div ngMenu (itemSelected)="doAction()">
- *   <div ngMenuItem >Action Item</div>
+ *   <div ngMenuItem>Action Item</div>
  *   <div ngMenuItem [submenu]="anotherMenu">Submenu Trigger</div>
  * </div>
  * ```
@@ -88,14 +89,14 @@ declare class MenuBar<V> {
  * @see [Menu](guide/aria/menu)
  * @see [MenuBar](guide/aria/menubar)
  */
-declare class MenuItem<V> {
+declare class MenuItem<V> implements OnInit, OnDestroy {
     /** 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, used as the default aria-label */
+    /** The value of the menu item. */
     readonly value: _angular_core.InputSignal<V>;
     /** Whether the menu item is disabled. */
     readonly disabled: _angular_core.InputSignal<boolean>;
@@ -114,6 +115,8 @@ declare class MenuItem<V> {
     /** The menu item ui pattern instance. */
     readonly _pattern: MenuItemPattern<V>;
     constructor();
+    ngOnInit(): void;
+    ngOnDestroy(): void;
     /** Opens the submenu focusing on the first menu item. */
     open(): void;
     /** Closes the submenu. */
@@ -149,11 +152,11 @@ declare class MenuItem<V> {
  * @see [Menu](guide/aria/menu)
  * @see [MenuBar](guide/aria/menubar)
  */
-declare class Menu<V> {
+declare class Menu<V> implements OnDestroy {
     /** The DeferredContentAware host directive. */
     private readonly _deferredContentAware;
-    /** The menu items contained in the menu. */
-    readonly _allItems: Signal<readonly MenuItem<V>[]>;
+    /** The collection of menu items. */
+    readonly _collection: SortedCollection<MenuItem<V>>;
     /** The menu items that are direct children of this menu. */
     readonly _items: Signal<MenuItem<V>[]>;
     /** A reference to the host element. */
@@ -175,11 +178,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. */
@@ -191,10 +197,11 @@ declare class Menu<V> {
     /** The delay in milliseconds before expanding sub-menus on hover. */
     readonly expansionDelay: _angular_core.InputSignal<number>;
     constructor();
+    ngOnDestroy(): void;
     /** 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; }; }, { "itemSelected": "itemSelected"; }, ["_allItems"], never, true, [{ directive: typeof 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; }; }, { "itemSelected": "itemSelected"; }, never, never, true, [{ directive: typeof DeferredContentAware; inputs: { "preserveContent": "preserveContent"; }; outputs: {}; }]>;
 }
 
 /**

package/types/private.d.ts

@@ -1,145 +1,127 @@
-import { ComboboxPattern, ComboboxListboxControls, ComboboxTreeControls } from './_combobox-chunk.js';
-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';
+export { ListboxInputs, ListboxPattern, OptionInputs, OptionPattern } from './_listbox-chunk.js';
 export { MenuBarInputs, MenuBarPattern, MenuInputs, MenuItemInputs, MenuItemPattern, MenuPattern, MenuTriggerInputs, MenuTriggerPattern } from './_menu-chunk.js';
+import { SignalLike, WritableSignalLike } from './_collection-chunk.js';
+export { HasElement, SortedCollection, computed, convertGetterSetterToWritableSignalLike, linkedSignal, signal, sortDirectives } from './_collection-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 { TreeInputs, TreeItemInputs, TreeItemPattern, TreePattern } from './_tree-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. */
-    combobox: SignalLike<ComboboxPattern<OptionPattern<V>, V> | undefined>;
-};
-declare class ComboboxListboxPattern<V> extends ListboxPattern<V> implements ComboboxListboxControls<OptionPattern<V>, V> {
-    readonly inputs: ComboboxListboxInputs<V>;
-    /** A unique identifier for the popup. */
-    readonly id: SignalLike<string>;
-    /** The ARIA role for the listbox. */
-    readonly role: SignalLike<"listbox">;
-    /** The id of the active (focused) item in the listbox. */
-    readonly activeId: SignalLike<string | undefined>;
-    /** The list of options in the listbox. */
-    readonly items: SignalLike<OptionPattern<V>[]>;
-    /** The tab index for the listbox. Always -1 because the combobox handles focus. */
-    tabIndex: SignalLike<-1 | 0>;
-    /** Whether multiple items in the list can be selected at once. */
-    multi: SignalLike<boolean>;
-    constructor(inputs: ComboboxListboxInputs<V>);
-    /** Noop. The combobox handles keydown events. */
-    onKeydown(_: KeyboardEvent): void;
-    /** Noop. The combobox handles pointerdown events. */
-    onClick(_: PointerEvent): void;
-    /** Noop. The combobox controls the open state. */
-    setDefaultState(): void;
-    /** Navigates to the specified item in the listbox. */
-    readonly focus: (item: OptionPattern<V>, opts?: {
-        focusElement?: boolean;
-    }) => void;
-    /** Navigates to the previous focusable item in the listbox. */
-    readonly getActiveItem: () => OptionPattern<V> | undefined;
-    /** Navigates to the next focusable item in the listbox. */
-    readonly next: () => void;
-    /** Navigates to the previous focusable item in the listbox. */
-    readonly prev: () => void;
-    /** Navigates to the last focusable item in the listbox. */
-    readonly last: () => void;
-    /** Navigates to the first focusable item in the listbox. */
-    readonly first: () => void;
-    /** Unfocuses the currently focused item in the listbox. */
-    readonly unfocus: () => void;
-    /** Selects the specified item in the listbox. */
-    readonly select: (item?: OptionPattern<V>) => void;
-    /** Toggles the selection state of the given item in the listbox. */
-    readonly toggle: (item?: OptionPattern<V>) => void;
-    /** Clears the selection in the listbox. */
-    readonly clearSelection: () => void;
-    /** Retrieves the OptionPattern associated with a pointer event. */
-    readonly getItem: (e: PointerEvent) => OptionPattern<V> | undefined;
-    /** Retrieves the currently selected items in the listbox. */
-    readonly getSelectedItems: () => OptionPattern<V>[];
-    /** Sets the value of the combobox listbox. */
-    readonly setValue: (value: V | undefined) => void;
-}
+/**
+ * Transform function for tabIndex inputs.
+ * Returns undefined if the value is undefined, otherwise converts it to a number.
+ */
+declare function tabIndexTransform(v: string | number | undefined): number | undefined;
 
-type ComboboxTreeInputs<V> = TreeInputs<V> & {
-    /** The combobox controlling the tree. */
-    combobox: SignalLike<ComboboxPattern<TreeItemPattern<V>, V> | undefined>;
-};
-declare class ComboboxTreePattern<V> extends TreePattern<V> implements ComboboxTreeControls<TreeItemPattern<V>, V> {
-    readonly inputs: ComboboxTreeInputs<V>;
-    /** Toggles to expand or collapse a tree item. */
-    readonly toggleExpansion: (item?: TreeItemPattern<V>) => void;
-    /** Whether the currently focused item is collapsible. */
-    readonly isItemCollapsible: () => boolean;
-    /** The ARIA role for the tree. */
-    readonly role: () => "tree";
-    readonly activeId: SignalLike<string | undefined>;
-    /** Returns the currently active (focused) item in the tree. */
-    readonly getActiveItem: () => TreeItemPattern<V> | undefined;
-    /** The list of items in the tree. */
-    items: SignalLike<TreeItemPattern<V>[]>;
-    /** The tab index for the tree. Always -1 because the combobox handles focus. */
-    readonly tabIndex: SignalLike<-1 | 0>;
-    constructor(inputs: ComboboxTreeInputs<V>);
-    /** Noop. The combobox handles keydown events. */
-    onKeydown(_: KeyboardEvent): void;
-    /** Noop. The combobox handles click events. */
-    onClick(_: PointerEvent): void;
-    /** Noop. The combobox controls the open state. */
-    setDefaultState(): void;
-    /** Navigates to the specified item in the tree. */
-    readonly focus: (item: TreeItemPattern<V>) => void;
-    /** Navigates to the next focusable item in the tree. */
-    readonly next: () => void;
-    /** Navigates to the previous focusable item in the tree. */
-    readonly prev: () => void;
-    /** Navigates to the last focusable item in the tree. */
-    readonly last: () => void;
-    /** Navigates to the first focusable item in the tree. */
-    readonly first: () => void;
-    /** Unfocuses the currently focused item in the tree. */
-    readonly unfocus: () => void;
-    /** Selects the specified item in the tree or the current active item if not provided. */
-    readonly select: (item?: TreeItemPattern<V>) => void;
-    /** Toggles the selection state of the given item in the tree or the current active item if not provided. */
-    readonly toggle: (item?: TreeItemPattern<V>) => void;
-    /** Clears the selection in the tree. */
-    readonly clearSelection: () => void;
-    /** Retrieves the TreeItemPattern associated with a pointer event. */
-    readonly getItem: (e: PointerEvent) => TreeItemPattern<V> | undefined;
-    /** Retrieves the currently selected items in the tree */
-    readonly getSelectedItems: () => TreeItemPattern<V>[];
-    /** Sets the value of the combobox tree. */
-    readonly setValue: (value: V | undefined) => void;
-    /** Expands the currently focused item if it is expandable, or navigates to the first child. */
-    readonly expandItem: () => void;
-    /** Collapses the currently focused item if it is expandable, or navigates to the parent. */
-    readonly collapseItem: () => void;
-    /** Whether the specified item or the currently active item is expandable. */
-    isItemExpandable(item?: TreeItemPattern<V> | undefined): boolean;
-    /** Expands all of the tree items. */
-    readonly expandAll: () => void;
-    /** Collapses all of the tree items. */
-    readonly collapseAll: () => void;
-    /** Whether the currently active item is selectable. */
-    readonly isItemSelectable: (item?: TreeItemPattern<V> | undefined) => boolean;
+/** Represents the required inputs for a simple combobox. */
+interface ComboboxInputs 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<ComboboxPopupPattern | undefined>;
+    /** An inline suggestion to be displayed in the input. */
+    inlineSuggestion: SignalLike<string | undefined>;
+    /** Whether the combobox is disabled. */
+    disabled: SignalLike<boolean>;
+    /** Whether the combobox is soft disabled. */
+    softDisabled?: SignalLike<boolean>;
+}
+/** Controls the state of a simple combobox. */
+declare class ComboboxPattern {
+    readonly inputs: ComboboxInputs;
+    /** 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;
+    /** Whether the combobox is soft disabled. */
+    readonly softDisabled: () => 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: ComboboxInputs);
+    /** 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 ComboboxPopupInputs {
+    /** 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 ComboboxPopupPattern {
+    readonly inputs: ComboboxPopupInputs;
+    /** 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: ComboboxPopupInputs);
+    /** 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, TreeInputs, TreeItemPattern, TreePattern };
-export type { ComboboxListboxInputs, ComboboxTreeInputs };
+export { ComboboxPattern, ComboboxPopupPattern, SignalLike, WritableSignalLike, tabIndexTransform };
+export type { ComboboxInputs, ComboboxPopupInputs };