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

package/types/_grid-chunk.d.ts

@@ -1,4 +1,4 @@
-import { SignalLike, WritableSignalLike } from './_signal-like-chunk.js';
+import { SignalLike, WritableSignalLike } from './_collection-chunk.js';
 import { KeyboardEventManager } from './_keyboard-event-manager-chunk.js';
 import { ClickEventManager } from './_click-event-manager-chunk.js';
 import { ElementRef } from '@angular/core';
@@ -352,6 +352,10 @@ interface GridCellWidgetInputs {
     widgetType: SignalLike<'simple' | 'complex' | 'editable'>;
     /** The element that will receive focus when the widget is activated. */
     focusTarget: SignalLike<ElementResolver<HTMLElement>>;
+    /** Callback hook used to notify parents or directives upon interaction. */
+    onActivate?: (event: KeyboardEvent | FocusEvent | undefined) => void;
+    /** Callback hook used to notify parents or directives upon exit. */
+    onDeactivate?: (event: KeyboardEvent | FocusEvent | undefined) => void;
 }
 /** The UI pattern for a widget inside a grid cell. */
 declare class GridCellWidgetPattern {
@@ -383,6 +387,10 @@ declare class GridCellWidgetPattern {
     onFocusOut(event: FocusEvent): void;
     /** Focuses the widget's host element. */
     focus(): void;
+    /** Side-effect executed whenever the widget activates. Runs in the write phase. */
+    activationEffect(): void;
+    /** Side-effect executed whenever the widget deactivates. Runs in the write phase. */
+    deactivationEffect(): void;
     /** Activates the widget. */
     activate(event?: KeyboardEvent | FocusEvent): void;
     /** Deactivates the widget and restores focus to the widget's host element. */
@@ -403,8 +411,6 @@ interface GridCellInputs extends GridCell {
     colIndex: SignalLike<number | undefined>;
     /** A function that returns the cell widget associated with a given element. */
     getWidget: (e: Element | null) => GridCellWidgetPattern | undefined;
-    /** Callback when the cell is activated via Enter/Space. */
-    onActivate?: (event: KeyboardEvent) => void;
 }
 /** The UI pattern for a grid cell. */
 declare class GridCellPattern implements GridCell {

package/types/_keyboard-event-manager-chunk.d.ts

@@ -1,4 +1,4 @@
-import { SignalLike } from './_signal-like-chunk.js';
+import { SignalLike } from './_collection-chunk.js';
 
 /**
  * Options that are applicable to all event handlers.

package/types/_list-chunk.d.ts

@@ -1,4 +1,4 @@
-import { SignalLike, WritableSignalLike } from './_signal-like-chunk.js';
+import { SignalLike, WritableSignalLike } from './_collection-chunk.js';
 import { ListFocusItem, ListFocusInputs, ListFocus, ListNavigationItem, ListNavigationInputs, ListNavigation } from './_list-navigation-chunk.js';
 
 /** Represents an item in a collection, such as a listbox option, that can be selected. */

package/types/_list-navigation-chunk.d.ts

@@ -1,4 +1,4 @@
-import { SignalLike, WritableSignalLike } from './_signal-like-chunk.js';
+import { SignalLike, WritableSignalLike } from './_collection-chunk.js';
 
 /** Represents an item in a collection, such as a listbox option, than may receive focus. */
 interface ListFocusItem {

package/types/_listbox-chunk.d.ts

@@ -1,4 +1,4 @@
-import { SignalLike, WritableSignalLike } from './_signal-like-chunk.js';
+import { SignalLike, WritableSignalLike } from './_collection-chunk.js';
 import { ListInputs, List, ListItem } from './_list-chunk.js';
 import { KeyboardEventManager } from './_keyboard-event-manager-chunk.js';
 import { ClickEventManager } from './_click-event-manager-chunk.js';

package/types/_menu-chunk.d.ts

@@ -1,4 +1,4 @@
-import { SignalLike, WritableSignalLike } from './_signal-like-chunk.js';
+import { SignalLike, WritableSignalLike } from './_collection-chunk.js';
 import { KeyboardEventManager } from './_keyboard-event-manager-chunk.js';
 import { ListInputs, ListItem, List } from './_list-chunk.js';
 

package/types/_tabs-chunk.d.ts

@@ -1,7 +1,7 @@
 import { KeyboardEventManager } from './_keyboard-event-manager-chunk.js';
 import { ClickEventManager } from './_click-event-manager-chunk.js';
 import { ExpansionItem, ListExpansionInputs, ListExpansion } from './_expansion-chunk.js';
-import { SignalLike, WritableSignalLike } from './_signal-like-chunk.js';
+import { SignalLike, WritableSignalLike } from './_collection-chunk.js';
 import { ListNavigationItem, ListNavigationInputs, ListFocus, ListNavigation } from './_list-navigation-chunk.js';
 
 /** The required inputs to tabs. */

package/types/_toolbar-chunk.d.ts

@@ -1,4 +1,4 @@
-import { SignalLike, WritableSignalLike } from './_signal-like-chunk.js';
+import { SignalLike, WritableSignalLike } from './_collection-chunk.js';
 import { ListItem, ListInputs, List } from './_list-chunk.js';
 
 /** Represents the required inputs for a toolbar widget group. */

package/types/_tree-chunk.d.ts

@@ -1,4 +1,4 @@
-import { SignalLike, WritableSignalLike } from './_signal-like-chunk.js';
+import { SignalLike, WritableSignalLike } from './_collection-chunk.js';
 import { ExpansionItem, ListExpansionInputs, ListExpansion } from './_expansion-chunk.js';
 import { ListNavigationItem, ListFocusItem, ListFocusInputs, ListNavigationInputs, ListNavigation, ListFocus } from './_list-navigation-chunk.js';
 import { ListTypeaheadItem, ListSelectionItem, ListSelectionInputs, ListTypeaheadInputs, ListSelection, ListTypeahead, NavOptions } from './_list-chunk.js';

package/types/accordion.d.ts

@@ -3,8 +3,8 @@ import { OnInit, OnDestroy } from '@angular/core';
 import { AccordionTriggerPattern, AccordionGroupPattern } from './_accordion-chunk.js';
 import { DeferredContentAware, DeferredContent } from './_deferred-content-chunk.js';
 import * as _angular_cdk_bidi from '@angular/cdk/bidi';
+import { SortedCollection } from './_collection-chunk.js';
 import './_keyboard-event-manager-chunk.js';
-import './_signal-like-chunk.js';
 import './_click-event-manager-chunk.js';
 import './_expansion-chunk.js';
 import './_list-navigation-chunk.js';
@@ -91,8 +91,6 @@ declare class AccordionTrigger implements OnInit, OnDestroy {
     readonly panelId: _angular_core.Signal<string>;
     /** Whether the trigger is disabled. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** The index of the trigger within the accordion group. */
-    readonly index: _angular_core.InputSignal<number | undefined>;
     /** Whether the corresponding panel is expanded. */
     readonly expanded: _angular_core.ModelSignal<boolean>;
     /** Whether the trigger is active. */
@@ -108,7 +106,7 @@ declare class AccordionTrigger implements OnInit, OnDestroy {
     /** Toggles the expansion state of this item. */
     toggle(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AccordionTrigger, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AccordionTrigger, "[ngAccordionTrigger]", ["ngAccordionTrigger"], { "panel": { "alias": "panel"; "required": true; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "index": { "alias": "index"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AccordionTrigger, "[ngAccordionTrigger]", ["ngAccordionTrigger"], { "panel": { "alias": "panel"; "required": true; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; }, never, never, true, never>;
 }
 
 /**
@@ -147,15 +145,13 @@ declare class AccordionTrigger implements OnInit, OnDestroy {
  * @developerPreview 21.0
  * @see [Accordion](guide/aria/accordion)
  */
-declare class AccordionGroup {
+declare class AccordionGroup implements OnDestroy {
     /** A reference to the group element. */
     private readonly _elementRef;
     /** A reference to the group element. */
     readonly element: HTMLElement;
-    /** The AccordionTriggers nested inside this group. */
-    private readonly _triggers;
-    /** The AccordionTriggers nested inside this group. */
-    private readonly _sortedTriggers;
+    /** The collection of AccordionTriggers. */
+    readonly _collection: SortedCollection<AccordionTrigger>;
     /** The corresponding patterns for the accordion triggers. */
     private readonly _triggerPatterns;
     /** The text direction (ltr or rtl). */
@@ -173,14 +169,12 @@ declare class AccordionGroup {
     readonly wrap: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** The UI pattern instance for this accordion group. */
     readonly _pattern: AccordionGroupPattern;
+    constructor();
+    ngOnDestroy(): void;
     /** Expands all accordion panels if multi-expandable. */
     expandAll(): void;
     /** Collapses all accordion panels. */
     collapseAll(): void;
-    /** Internal method to register each trigger as we can not use contentChildren. */
-    _registerTrigger(trigger: AccordionTrigger): void;
-    /** Internal method to unregister each trigger as we can not use contentChildren. */
-    _unregisterTrigger(trigger: AccordionTrigger): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AccordionGroup, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AccordionGroup, "[ngAccordionGroup]", ["ngAccordionGroup"], { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "multiExpandable": { "alias": "multiExpandable"; "required": false; "isSignal": true; }; "softDisabled": { "alias": "softDisabled"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }

package/types/combobox-testing.d.ts

@@ -0,0 +1,63 @@
+import { BaseHarnessFilters, ContentContainerComponentHarness, HarnessPredicate, ComponentHarness, ComponentHarnessConstructor, HarnessLoader } from '@angular/cdk/testing';
+
+/** A set of criteria that can be used to filter a list of `ComboboxHarness` instances. */
+interface ComboboxHarnessFilters extends BaseHarnessFilters {
+    /** Only find instances whose placeholder matches the given value. */
+    placeholder?: string | RegExp;
+    /** Only find instances whose value matches the given value. */
+    value?: string | RegExp;
+    /** Only find instances with the given disabled state. */
+    disabled?: boolean;
+}
+
+/** Harness for interacting with a standard `ngCombobox` input element in tests. */
+declare class ComboboxHarness extends ContentContainerComponentHarness {
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a combobox with specific attributes.
+     * @param options Options for filtering which combobox instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with(options?: ComboboxHarnessFilters): HarnessPredicate<ComboboxHarness>;
+    /**
+     * Gets the component harness for the active widget contained inside the popup.
+     * Use this when you need to access the harness of the widget itself (e.g., `ListboxHarness`),
+     * rather than querying items within it.
+     * @param type The harness type to locate. Must implement standard static `.with()` method.
+     */
+    getPopupWidget<T extends ComponentHarness>(type: ComponentHarnessConstructor<T> & {
+        with: (options?: {
+            selector?: string;
+        }) => HarnessPredicate<T>;
+    }): Promise<T>;
+    /**
+     * Gets a harness loader scoped to the content inside the popup container.
+     * Note that lookups performed by this loader will only find descendants of the popup container.
+     */
+    getPopupLoader(): Promise<HarnessLoader>;
+    /** Overrides root loader to automatically resolve queries nested inside the associated popup. */
+    protected getRootHarnessLoader(): Promise<HarnessLoader>;
+    /** Whether the combobox is expanded (popup is open). */
+    isOpen(): Promise<boolean>;
+    /** Whether the combobox is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Gets the current value string of the combobox input. */
+    getValue(): Promise<string>;
+    /** Sets the value of the combobox input. */
+    setValue(value: string): Promise<void>;
+    /** Gets the placeholder text of the combobox. */
+    getPlaceholder(): Promise<string | null>;
+    /** Opens the combobox popup if it is currently closed. */
+    open(): Promise<void>;
+    /** Closes the combobox popup if it is currently open. */
+    close(): Promise<void>;
+    /** Focuses the combobox. */
+    focus(): Promise<void>;
+    /** Blurs the combobox. */
+    blur(): Promise<void>;
+    /** Whether the combobox has focus. */
+    isFocused(): Promise<boolean>;
+}
+
+export { ComboboxHarness };
+export type { ComboboxHarnessFilters };

package/types/combobox.d.ts

@@ -1,225 +1,128 @@
 import * as _angular_core from '@angular/core';
-import * as _angular_cdk_bidi from '@angular/cdk/bidi';
-import { ComboboxListboxControls, ComboboxTreeControls, ComboboxDialogPattern, ComboboxPattern } from './_combobox-chunk.js';
-import { DeferredContentAware, DeferredContent } from './_deferred-content-chunk.js';
-import './_keyboard-event-manager-chunk.js';
-import './_signal-like-chunk.js';
-import './_list-chunk.js';
-import './_list-navigation-chunk.js';
+import { OnInit, OnDestroy } from '@angular/core';
+import * as i1 from '@angular/aria/private';
+import { ComboboxPopupPattern, DeferredContentAware, ComboboxPattern } from '@angular/aria/private';
+export { DeferredContent as ɵɵDeferredContent, DeferredContentAware as ɵɵDeferredContentAware } from './_deferred-content-chunk.js';
 
 /**
- * Identifies an element as a popup for an `ngCombobox`.
+ * Identifies an element as a widget within a combobox popup.
  *
- * This directive acts as a bridge, allowing the `ngCombobox` to discover and interact
- * with the underlying control (e.g., `ngListbox`, `ngTree`, or `ngComboboxDialog`) that
- * manages the options. It's primarily used as a host directive and is responsible for
- * exposing the popup's control pattern to the parent combobox.
- *
- * @developerPreview 21.0
- *
- * @see [Combobox](guide/aria/combobox)
- * @see [Select](guide/aria/select)
- * @see [Multiselect](guide/aria/multiselect)
- * @see [Autocomplete](guide/aria/autocomplete)
- */
-declare class ComboboxPopup<V> {
-    /** The combobox that the popup belongs to. */
-    readonly combobox: Combobox<V> | null;
-    /** The popup controls exposed to the combobox. */
-    readonly _controls: _angular_core.WritableSignal<ComboboxListboxControls<any, V> | ComboboxTreeControls<any, V> | ComboboxDialogPattern | undefined>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComboboxPopup<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxPopup<any>, "[ngComboboxPopup]", ["ngComboboxPopup"], {}, {}, never, never, true, never>;
-}
-
-/**
- * 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 `ngComboboxInput` and the popup, which
- * is defined by a `ng-template` with the `ngComboboxPopupContainer` directive. If using the
- * `CdkOverlay`, the `cdkConnectedOverlay` directive takes the place of `ngComboboxPopupContainer`.
- *
- * ```html
- * <div ngCombobox filterMode="highlight">
- *   <input
- *     ngComboboxInput
- *     placeholder="Search for a state..."
- *     [(value)]="searchString"
- *   />
- *
- *   <ng-template ngComboboxPopupContainer>
- *     <div ngListbox [(value)]="selectedValue">
- *       @for (option of filteredOptions(); track option) {
- *         <div ngOption [value]="option" [label]="option">
- *           <span>{{option}}</span>
- *         </div>
- *       }
- *     </div>
- *   </ng-template>
- * </div>
- * ```
- *
- * @developerPreview 21.0
- *
- * @see [Combobox](guide/aria/combobox)
- * @see [Select](guide/aria/select)
- * @see [Multiselect](guide/aria/multiselect)
- * @see [Autocomplete](guide/aria/autocomplete)
+ * 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 Combobox<V> {
-    /** A signal wrapper for directionality. */
-    protected readonly textDirection: _angular_core.Signal<_angular_cdk_bidi.Direction>;
-    /** The element that the combobox is attached to. */
+declare class ComboboxWidget implements OnInit, OnDestroy {
+    /** The element that the popup widget is attached to. */
     private readonly _elementRef;
-    /** A reference to the combobox element. */
+    private readonly _popup;
+    /** A reference to the popup widget element. */
     readonly element: HTMLElement;
-    /** The DeferredContentAware host directive. */
-    private readonly _deferredContentAware;
-    /** The combobox popup. */
-    readonly popup: _angular_core.Signal<ComboboxPopup<V> | undefined>;
-    /**
-     * The filter mode for the combobox.
-     * - `manual`: The consumer is responsible for filtering the options.
-     * - `auto-select`: The combobox automatically selects the first matching option.
-     * - `highlight`: The combobox highlights matching text in the options without changing selection.
-     */
-    readonly filterMode: _angular_core.InputSignal<"manual" | "auto-select" | "highlight">;
-    /** Whether the combobox is disabled. */
-    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Whether the combobox is read-only. */
-    readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** The value of the first matching item in the popup. */
-    readonly firstMatch: _angular_core.InputSignal<V | undefined>;
-    /** Whether the combobox is expanded. */
-    readonly expanded: _angular_core.Signal<boolean>;
-    /** Whether the combobox popup should always be expanded, regardless of user interaction. */
-    readonly alwaysExpanded: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Input element connected to the combobox, if any. */
-    readonly inputElement: _angular_core.Signal<HTMLInputElement | undefined>;
-    /** The combobox ui pattern. */
-    readonly _pattern: ComboboxPattern<any, V>;
+    /** 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();
-    /** Opens the combobox to the selected item. */
-    open(): void;
-    /** Closes the combobox. */
-    close(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<Combobox<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Combobox<any>, "[ngCombobox]", ["ngCombobox"], { "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "firstMatch": { "alias": "firstMatch"; "required": false; "isSignal": true; }; "alwaysExpanded": { "alias": "alwaysExpanded"; "required": false; "isSignal": true; }; }, {}, ["popup"], never, true, [{ directive: typeof DeferredContentAware; inputs: { "preserveContent": "preserveContent"; }; outputs: {}; }]>;
+    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>;
 }
 
 /**
- * Integrates a native `<dialog>` element with the combobox, allowing for
- * a modal or non-modal popup experience. It handles the opening and closing of the dialog
- * based on the combobox's expanded state.
+ * 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 ngComboboxPopupContainer>
- *   <dialog ngComboboxDialog class="example-dialog">
- *     <!-- ... dialog content ... -->
- *   </dialog>
+ * <ng-template ngComboboxPopup>
+ *   <div ngComboboxWidget>
+ *     <!-- ... options ... -->
+ *   </div>
  * </ng-template>
  * ```
- *
- * @developerPreview 21.0
- *
- * @see [Combobox](guide/aria/combobox)
- * @see [Select](guide/aria/select)
- * @see [Multiselect](guide/aria/multiselect)
- * @see [Autocomplete](guide/aria/autocomplete)
  */
-declare class ComboboxDialog {
-    /** The dialog element. */
-    private readonly _elementRef;
-    /** A reference to the dialog element. */
-    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"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof ComboboxPopup; inputs: {}; outputs: {}; }]>;
+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: ComboboxPopupPattern;
+    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: {}; }]>;
 }
 
 /**
- * An input that is part of a combobox. It is responsible for displaying the
- * current value and handling user input for filtering and selection.
+ * The container element that wraps a combobox input and popup, and orchestrates its behavior.
  *
- * This directive should be applied to an `<input>` element within an `ngCombobox`
- * container. It automatically handles keyboard interactions, such as opening the
- * popup and navigating through the options.
+ * 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
- * <input
- *   ngComboboxInput
- *   placeholder="Search..."
- *   [(value)]="searchString"
- * />
- * ```
- *
- * @developerPreview 21.0
+ * <div ngCombobox [(expanded)]="expanded">
+ *   <input ngComboboxInput />
  *
- * @see [Combobox](guide/aria/combobox)
- * @see [Select](guide/aria/select)
- * @see [Multiselect](guide/aria/multiselect)
- * @see [Autocomplete](guide/aria/autocomplete)
+ *   <ng-template ngComboboxPopup>
+ *     <div ngComboboxWidget>
+ *       <!-- ... options ... -->
+ *     </div>
+ *   </ng-template>
+ * </div>
+ * ```
  */
-declare class ComboboxInput {
+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 combobox that the input belongs to. */
-    readonly combobox: Combobox<any>;
-    /** The value of the input. */
+    /** 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 is soft disabled (remains focusable). */
+    readonly softDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Whether the combobox should always remain expanded. */
+    readonly alwaysExpanded: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** The tabindex of the combobox. */
+    readonly tabIndex: _angular_core.InputSignalWithTransform<number | undefined, string | number | undefined>;
+    /** 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: ComboboxPattern;
     constructor();
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComboboxInput, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxInput, "input[ngComboboxInput]", ["ngComboboxInput"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, 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 a `ngListbox`, `ngTree`, or `role="dialog"`, allowing for
- * flexible and complex combobox implementations. The consumer is responsible for
- * implementing the filtering logic based on the `ngComboboxInput`'s value.
- *
- * ```html
- * <ng-template ngComboboxPopupContainer>
- *   <div ngListbox [(value)]="selectedValue">
- *     <!-- ... options ... -->
- *   </div>
- * </ng-template>
- * ```
- *
- * When using CdkOverlay, this directive can be replaced by `cdkConnectedOverlay`.
- *
- * ```html
- * <ng-template
- *     [cdkConnectedOverlay]="{origin: inputElement, usePopover: 'inline' matchWidth: true}"
- *     [cdkConnectedOverlayOpen]="combobox.expanded()">
- *   <div ngListbox [(value)]="selectedValue">
- *     <!-- ... options ... -->
- *   </div>
- * </ng-template>
- * ```
- *
- * @developerPreview 21.0
- *
- * @see [Combobox](guide/aria/combobox)
- * @see [Select](guide/aria/select)
- * @see [Multiselect](guide/aria/multiselect)
- * @see [Autocomplete](guide/aria/autocomplete)
- */
-declare class ComboboxPopupContainer {
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComboboxPopupContainer, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxPopupContainer, "ng-template[ngComboboxPopupContainer]", ["ngComboboxPopupContainer"], {}, {}, never, never, true, [{ directive: typeof DeferredContent; inputs: {}; outputs: {}; }]>;
+    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; }; "softDisabled": { "alias": "softDisabled"; "required": false; "isSignal": true; }; "alwaysExpanded": { "alias": "alwaysExpanded"; "required": false; "isSignal": true; }; "tabIndex": { "alias": "tabindex"; "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, ComboboxDialog, ComboboxInput, ComboboxPopup, ComboboxPopupContainer, DeferredContent as ɵɵDeferredContent, DeferredContentAware as ɵɵDeferredContentAware };
+export { Combobox, ComboboxPopup, ComboboxWidget };

package/types/grid-testing.d.ts

@@ -39,6 +39,10 @@ declare class GridCellHarness extends ContentContainerComponentHarness {
     focus(): Promise<void>;
     /** Blurs the cell. */
     blur(): Promise<void>;
+    /** Whether the cell is active. */
+    isActive(): Promise<boolean>;
+    /** Whether the cell is focused. */
+    isFocused(): Promise<boolean>;
 }
 /** Harness for interacting with a standard ngGridRow in tests. */
 declare class GridRowHarness extends ComponentHarness {