@angular/aria 21.0.3 → 21.0.4

package/types/combobox.d.ts

@@ -1,11 +1,112 @@
-import { Combobox, ComboboxPopup } from './_combobox-chunk.js';
-import { ComboboxDialogPattern } from './_combobox-chunk.d2.ts';
 import * as _angular_core from '@angular/core';
-import * as i1 from '@angular/aria/private';
-import '@angular/cdk/bidi';
+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 './_list-navigation-chunk.js';
+import './_pointer-event-manager-chunk.js';
 import './_list-chunk.js';
 
+/**
+ * Identifies an element as a popup for an `ngCombobox`.
+ *
+ * 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)
+ */
+declare class Combobox<V> {
+    /** A signal wrapper for directionality. */
+    protected textDirection: _angular_core.Signal<_angular_cdk_bidi.Direction>;
+    /** The element that the combobox is attached to. */
+    private readonly _elementRef;
+    /** A reference to the combobox 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.
+     */
+    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>;
+    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: {}; }]>;
+}
+
 /**
  * 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
@@ -20,6 +121,11 @@ import './_list-chunk.js';
  * ```
  *
  * @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. */
@@ -54,6 +160,11 @@ declare class ComboboxDialog {
  * ```
  *
  * @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 ComboboxInput {
     /** The element that the combobox is attached to. */
@@ -98,10 +209,15 @@ declare class ComboboxInput {
  * ```
  *
  * @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 i1.DeferredContent; inputs: {}; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxPopupContainer, "ng-template[ngComboboxPopupContainer]", ["ngComboboxPopupContainer"], {}, {}, never, never, true, [{ directive: typeof DeferredContent; inputs: {}; outputs: {}; }]>;
 }
 
-export { Combobox, ComboboxDialog, ComboboxInput, ComboboxPopup, ComboboxPopupContainer };
+export { Combobox, ComboboxDialog, ComboboxInput, ComboboxPopup, ComboboxPopupContainer, DeferredContent as ɵɵDeferredContent, DeferredContentAware as ɵɵDeferredContentAware };

package/types/grid.d.ts

@@ -4,6 +4,8 @@ import * as _angular_cdk_bidi from '@angular/cdk/bidi';
 import { GridPattern, GridCellPattern, GridRowPattern, GridCellWidgetPattern } from './_grid-chunk.js';
 import * as _angular_aria_private_public_api from '@angular/aria/private/public-api';
 import './_list-navigation-chunk.js';
+import './_keyboard-event-manager-chunk.js';
+import './_pointer-event-manager-chunk.js';
 
 /**
  * The container for a grid. It provides keyboard navigation and focus management for the grid's
@@ -25,6 +27,8 @@ import './_list-navigation-chunk.js';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Grid](guide/aria/grid)
  */
 declare class Grid {
     /** A reference to the host element. */
@@ -97,6 +101,8 @@ declare class Grid {
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Grid](guide/aria/grid)
  */
 declare class GridCell {
     /** A reference to the host element. */
@@ -161,6 +167,8 @@ declare class GridCell {
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Grid](guide/aria/grid)
  */
 declare class GridRow {
     /** A reference to the host element. */
@@ -198,6 +206,8 @@ declare class GridRow {
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Grid](guide/aria/grid)
  */
 declare class GridCellWidget {
     /** A reference to the host element. */

package/types/listbox.d.ts

@@ -2,10 +2,14 @@ import * as _angular_aria_private_public_api from '@angular/aria/private/public-
 import * as _angular_cdk_bidi from '@angular/cdk/bidi';
 import * as _angular_core from '@angular/core';
 import { ListboxPattern, OptionPattern } from './_listbox-chunk.js';
-import { ComboboxPopup } from './_combobox-chunk.js';
+import { ComboboxPopup } from './combobox.js';
+export { Combobox as ɵɵCombobox, ComboboxDialog as ɵɵComboboxDialog, ComboboxInput as ɵɵComboboxInput, ComboboxPopupContainer as ɵɵComboboxPopupContainer } from './combobox.js';
 import './_list-navigation-chunk.js';
 import './_list-chunk.js';
-import '@angular/aria/private';
+import './_keyboard-event-manager-chunk.js';
+import './_pointer-event-manager-chunk.js';
+import './_combobox-chunk.js';
+import './_deferred-content-chunk.js';
 
 /**
  * Represents a container used to display a list of items for a user to select from.
@@ -25,6 +29,11 @@ import '@angular/aria/private';
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Listbox](guide/aria/listbox)
+ * @see [Autocomplete](guide/aria/autocomplete)
+ * @see [Select](guide/aria/select)
+ * @see [Multiselect](guide/aria/multiselect)
  */
 declare class Listbox<V> {
     /** A unique identifier for the listbox. */
@@ -35,8 +44,6 @@ declare class Listbox<V> {
     private readonly _elementRef;
     /** A reference to the host element. */
     readonly element: HTMLElement;
-    /** The directionality (LTR / RTL) context for the application (or a subtree of it). */
-    private readonly _directionality;
     /** The Options nested inside of the Listbox. */
     private readonly _options;
     /** A signal wrapper for directionality. */
@@ -101,6 +108,11 @@ declare class Listbox<V> {
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Listbox](guide/aria/listbox)
+ * @see [Autocomplete](guide/aria/autocomplete)
+ * @see [Select](guide/aria/select)
+ * @see [Multiselect](guide/aria/multiselect)
  */
 declare class Option<V> {
     /** A reference to the host element. */
@@ -129,4 +141,4 @@ declare class Option<V> {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Option<any>, "[ngOption]", ["ngOption"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { Listbox, Option };
+export { Listbox, Option, ComboboxPopup as ɵɵComboboxPopup };

package/types/menu.d.ts

@@ -1,8 +1,11 @@
 import * as _angular_core from '@angular/core';
 import { Signal } from '@angular/core';
 import * as _angular_cdk_bidi from '@angular/cdk/bidi';
-import * as i1 from '@angular/aria/private';
-import { SignalLike, MenuBarPattern, MenuItemPattern, MenuPattern, MenuTriggerPattern } from '@angular/aria/private';
+import { MenuBarPattern, MenuItemPattern, MenuPattern, MenuTriggerPattern } from './_menu-chunk.js';
+import { DeferredContentAware, DeferredContent } from './_deferred-content-chunk.js';
+import { SignalLike } from './_list-navigation-chunk.js';
+import './_keyboard-event-manager-chunk.js';
+import './_list-chunk.js';
 
 /**
  * A menu bar of menu items.
@@ -29,6 +32,9 @@ import { SignalLike, MenuBarPattern, MenuItemPattern, MenuPattern, MenuTriggerPa
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Menu](guide/aria/menu)
+ * @see [MenuBar](guide/aria/menubar)
  */
 declare class MenuBar<V> {
     /** The menu items contained in the menubar. */
@@ -76,6 +82,9 @@ declare class MenuBar<V> {
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Menu](guide/aria/menu)
+ * @see [MenuBar](guide/aria/menubar)
  */
 declare class MenuItem<V> {
     /** A reference to the host element. */
@@ -134,6 +143,9 @@ declare class MenuItem<V> {
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Menu](guide/aria/menu)
+ * @see [MenuBar](guide/aria/menubar)
  */
 declare class Menu<V> {
     /** The DeferredContentAware host directive. */
@@ -180,7 +192,7 @@ declare class Menu<V> {
     /** Closes the menu. */
     close(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<Menu<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Menu<any>, "[ngMenu]", ["ngMenu"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "typeaheadDelay": { "alias": "typeaheadDelay"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "expansionDelay": { "alias": "expansionDelay"; "required": false; "isSignal": true; }; }, { "onSelect": "onSelect"; }, ["_allItems"], never, true, [{ directive: typeof i1.DeferredContentAware; inputs: { "preserveContent": "preserveContent"; }; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Menu<any>, "[ngMenu]", ["ngMenu"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "typeaheadDelay": { "alias": "typeaheadDelay"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "expansionDelay": { "alias": "expansionDelay"; "required": false; "isSignal": true; }; }, { "onSelect": "onSelect"; }, ["_allItems"], never, true, [{ directive: typeof DeferredContentAware; inputs: { "preserveContent": "preserveContent"; }; outputs: {}; }]>;
 }
 
 /**
@@ -200,6 +212,9 @@ declare class Menu<V> {
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Menu](guide/aria/menu)
+ * @see [MenuBar](guide/aria/menubar)
  */
 declare class MenuTrigger<V> {
     /** A reference to the host element. */
@@ -245,10 +260,13 @@ declare class MenuTrigger<V> {
  * ```
  *
  * @developerPreview 21.0
+ *
+ * @see [Menu](guide/aria/menu)
+ * @see [MenuBar](guide/aria/menubar)
  */
 declare class MenuContent {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuContent, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MenuContent, "ng-template[ngMenuContent]", ["ngMenuContent"], {}, {}, never, never, true, [{ directive: typeof i1.DeferredContent; inputs: {}; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MenuContent, "ng-template[ngMenuContent]", ["ngMenuContent"], {}, {}, never, never, true, [{ directive: typeof DeferredContent; inputs: {}; outputs: {}; }]>;
 }
 
-export { Menu, MenuBar, MenuContent, MenuItem, MenuTrigger };
+export { Menu, MenuBar, MenuContent, MenuItem, MenuTrigger, DeferredContent as ɵɵDeferredContent, DeferredContentAware as ɵɵDeferredContentAware };