@angular/aria 21.0.2 → 21.0.4

package/types/_tree-chunk.d.ts

@@ -0,0 +1,185 @@
+import { SignalLike, WritableSignalLike } from './_list-navigation-chunk.js';
+import { ListItem, ListInputs, List } from './_list-chunk.js';
+import { ExpansionItem, ListExpansion } from './_expansion-chunk.js';
+import { KeyboardEventManager } from './_keyboard-event-manager-chunk.js';
+import { PointerEventManager } from './_pointer-event-manager-chunk.js';
+
+/** Represents the required inputs for a tree item. */
+interface TreeItemInputs<V> extends Omit<ListItem<V>, 'index'>, Omit<ExpansionItem, 'expandable'> {
+    /** The parent item. */
+    parent: SignalLike<TreeItemPattern<V> | TreePattern<V>>;
+    /** Whether this item has children. Children can be lazily loaded. */
+    hasChildren: SignalLike<boolean>;
+    /** The children items. */
+    children: SignalLike<TreeItemPattern<V>[]>;
+    /** The tree pattern this item belongs to. */
+    tree: SignalLike<TreePattern<V>>;
+}
+/**
+ * Represents an item in a Tree.
+ */
+declare class TreeItemPattern<V> implements ListItem<V>, ExpansionItem {
+    readonly inputs: TreeItemInputs<V>;
+    /** A unique identifier for this item. */
+    readonly id: SignalLike<string>;
+    /** The value of this item. */
+    readonly value: SignalLike<V>;
+    /** A reference to the item element. */
+    readonly element: SignalLike<HTMLElement>;
+    /** Whether the item is disabled. */
+    readonly disabled: SignalLike<boolean>;
+    /** The text used by the typeahead search. */
+    readonly searchTerm: SignalLike<string>;
+    /** The tree pattern this item belongs to. */
+    readonly tree: SignalLike<TreePattern<V>>;
+    /** The parent item. */
+    readonly parent: SignalLike<TreeItemPattern<V> | TreePattern<V>>;
+    /** The children items. */
+    readonly children: SignalLike<TreeItemPattern<V>[]>;
+    /** The position of this item among its siblings. */
+    readonly index: SignalLike<number>;
+    /** Controls expansion for child items. */
+    readonly expansionBehavior: ListExpansion;
+    /** Whether the item is expandable. It's expandable if children item exist. */
+    readonly expandable: SignalLike<boolean>;
+    /** Whether the item is selectable. */
+    readonly selectable: SignalLike<boolean>;
+    /** Whether the item is expanded. */
+    readonly expanded: WritableSignalLike<boolean>;
+    /** The level of the current item in a tree. */
+    readonly level: SignalLike<number>;
+    /** Whether this item is visible. */
+    readonly visible: SignalLike<boolean>;
+    /** The number of items under the same parent at the same level. */
+    readonly setsize: SignalLike<number>;
+    /** The position of this item among its siblings (1-based). */
+    readonly posinset: SignalLike<number>;
+    /** Whether the item is active. */
+    readonly active: SignalLike<boolean>;
+    /** The tab index of the item. */
+    readonly tabIndex: SignalLike<0 | -1>;
+    /** Whether the item is selected. */
+    readonly selected: SignalLike<boolean | undefined>;
+    /** The current type of this item. */
+    readonly current: SignalLike<string | undefined>;
+    constructor(inputs: TreeItemInputs<V>);
+}
+/** The selection operations that the tree can perform. */
+interface SelectOptions {
+    toggle?: boolean;
+    selectOne?: boolean;
+    selectRange?: boolean;
+    anchor?: boolean;
+}
+/** Represents the required inputs for a tree. */
+interface TreeInputs<V> extends Omit<ListInputs<TreeItemPattern<V>, V>, 'items'> {
+    /** A unique identifier for the tree. */
+    id: SignalLike<string>;
+    /** All items in the tree, in document order (DFS-like, a flattened list). */
+    allItems: SignalLike<TreeItemPattern<V>[]>;
+    /** Whether the tree is in navigation mode. */
+    nav: SignalLike<boolean>;
+    /** The aria-current type. */
+    currentType: SignalLike<'page' | 'step' | 'location' | 'date' | 'time' | 'true' | 'false'>;
+}
+/** Controls the state and interactions of a tree view. */
+declare class TreePattern<V> implements TreeInputs<V> {
+    readonly inputs: TreeInputs<V>;
+    /** The list behavior for the tree. */
+    readonly listBehavior: List<TreeItemPattern<V>, V>;
+    /** Controls expansion for direct children of the tree root (top-level items). */
+    readonly expansionBehavior: ListExpansion;
+    /** The root level is 0. */
+    readonly level: () => number;
+    /** The root is always expanded. */
+    readonly expanded: () => boolean;
+    /** The root is always visible. */
+    readonly visible: () => boolean;
+    /** The tab index of the tree. */
+    readonly tabIndex: SignalLike<-1 | 0>;
+    /** The id of the current active item. */
+    readonly activeDescendant: SignalLike<string | undefined>;
+    /** The direct children of the root (top-level tree items). */
+    readonly children: SignalLike<TreeItemPattern<V>[]>;
+    /** All currently visible tree items. An item is visible if their parent is expanded. */
+    readonly visibleItems: SignalLike<TreeItemPattern<V>[]>;
+    /** Whether the tree selection follows focus. */
+    readonly followFocus: SignalLike<boolean>;
+    /** Whether the tree direction is RTL. */
+    readonly isRtl: SignalLike<boolean>;
+    /** The key for navigating to the previous item. */
+    readonly prevKey: SignalLike<"ArrowUp" | "ArrowRight" | "ArrowLeft">;
+    /** The key for navigating to the next item. */
+    readonly nextKey: SignalLike<"ArrowRight" | "ArrowLeft" | "ArrowDown">;
+    /** The key for collapsing an item or moving to its parent. */
+    readonly collapseKey: SignalLike<"ArrowUp" | "ArrowRight" | "ArrowLeft">;
+    /** The key for expanding an item or moving to its first child. */
+    readonly expandKey: SignalLike<"ArrowRight" | "ArrowLeft" | "ArrowDown">;
+    /** Represents the space key. Does nothing when the user is actively using typeahead. */
+    readonly dynamicSpaceKey: SignalLike<"" | " ">;
+    /** Regular expression to match characters for typeahead. */
+    readonly typeaheadRegexp: RegExp;
+    /** The keydown event manager for the tree. */
+    readonly keydown: SignalLike<KeyboardEventManager<KeyboardEvent>>;
+    /** The pointerdown event manager for the tree. */
+    pointerdown: SignalLike<PointerEventManager<PointerEvent>>;
+    /** A unique identifier for the tree. */
+    readonly id: SignalLike<string>;
+    /** The host native element. */
+    readonly element: SignalLike<HTMLElement>;
+    /** Whether the tree is in navigation mode. */
+    readonly nav: SignalLike<boolean>;
+    /** The aria-current type. */
+    readonly currentType: SignalLike<'page' | 'step' | 'location' | 'date' | 'time' | 'true' | 'false'>;
+    /** All items in the tree, in document order (DFS-like, a flattened list). */
+    readonly allItems: SignalLike<TreeItemPattern<V>[]>;
+    /** The focus strategy used by the tree. */
+    readonly focusMode: SignalLike<'roving' | 'activedescendant'>;
+    /** Whether the tree is disabled. */
+    readonly disabled: SignalLike<boolean>;
+    /** The currently active item in the tree. */
+    readonly activeItem: WritableSignalLike<TreeItemPattern<V> | undefined>;
+    /** Whether disabled items should be focusable. */
+    readonly softDisabled: SignalLike<boolean>;
+    /** Whether the focus should wrap when navigating past the first or last item. */
+    readonly wrap: SignalLike<boolean>;
+    /** The orientation of the tree. */
+    readonly orientation: SignalLike<'vertical' | 'horizontal'>;
+    /** The text direction of the tree. */
+    readonly textDirection: SignalLike<'ltr' | 'rtl'>;
+    /** Whether multiple items can be selected at the same time. */
+    readonly multi: SignalLike<boolean>;
+    /** The selection mode of the tree. */
+    readonly selectionMode: SignalLike<'follow' | 'explicit'>;
+    /** The delay in milliseconds to wait before clearing the typeahead buffer. */
+    readonly typeaheadDelay: SignalLike<number>;
+    /** The current selected items of the tree. */
+    readonly values: WritableSignalLike<V[]>;
+    constructor(inputs: TreeInputs<V>);
+    /**
+     * Sets the tree to it's default initial state.
+     *
+     * Sets the active index of the tree to the first focusable selected tree item if one exists.
+     * Otherwise, sets focus to the first focusable tree item.
+     */
+    setDefaultState(): void;
+    /** Handles keydown events on the tree. */
+    onKeydown(event: KeyboardEvent): void;
+    /** Handles pointerdown events on the tree. */
+    onPointerdown(event: PointerEvent): void;
+    /** Navigates to the given tree item in the tree. */
+    goto(e: PointerEvent, opts?: SelectOptions): void;
+    /** Toggles to expand or collapse a tree item. */
+    toggleExpansion(item?: TreeItemPattern<V>): void;
+    /** Expands a tree item. */
+    expand(opts?: SelectOptions): void;
+    /** Expands all sibling tree items including itself. */
+    expandSiblings(item?: TreeItemPattern<V>): void;
+    /** Collapses a tree item. */
+    collapse(opts?: SelectOptions): void;
+    /** Retrieves the TreeItemPattern associated with a DOM event, if any. */
+    protected _getItem(event: Event): TreeItemPattern<V> | undefined;
+}
+
+export { TreeItemPattern, TreePattern };
+export type { TreeInputs, TreeItemInputs };

package/types/accordion.d.ts

@@ -1,8 +1,12 @@
-import * as _angular_cdk_bidi from '@angular/cdk/bidi';
 import * as _angular_core from '@angular/core';
 import { WritableSignal } from '@angular/core';
-import * as i1 from '@angular/aria/private';
-import { AccordionTriggerPattern, AccordionPanelPattern, AccordionGroupPattern } from '@angular/aria/private';
+import { AccordionTriggerPattern, AccordionPanelPattern, AccordionGroupPattern } from './_accordion-chunk.js';
+import { DeferredContentAware, DeferredContent } from './_deferred-content-chunk.js';
+import * as _angular_cdk_bidi from '@angular/cdk/bidi';
+import './_keyboard-event-manager-chunk.js';
+import './_list-navigation-chunk.js';
+import './_pointer-event-manager-chunk.js';
+import './_expansion-chunk.js';
 
 /**
  * The content panel of an accordion item that is conditionally visible.
@@ -23,6 +27,7 @@ import { AccordionTriggerPattern, AccordionPanelPattern, AccordionGroupPattern }
  * ```
  *
  * @developerPreview 21.0
+ * @see [Accordion](guide/aria/accordion)
  */
 declare class AccordionPanel {
     /** The DeferredContentAware host directive. */
@@ -45,55 +50,9 @@ declare class AccordionPanel {
     /** Toggles the expansion state of this item. */
     toggle(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AccordionPanel, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AccordionPanel, "[ngAccordionPanel]", ["ngAccordionPanel"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "panelId": { "alias": "panelId"; "required": true; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.DeferredContentAware; inputs: { "preserveContent": "preserveContent"; }; outputs: {}; }]>;
-}
-/**
- * The trigger that toggles the visibility of its associated `ngAccordionPanel`.
- *
- * This directive requires a `panelId` that must match the `panelId` of the `ngAccordionPanel` it
- * controls. When clicked, it will expand or collapse the panel. It also handles keyboard
- * interactions for navigation within the `ngAccordionGroup`. It applies `role="button"` and manages
- * `aria-expanded`, `aria-controls`, and `aria-disabled` attributes for accessibility.
- * The `disabled` input can be used to disable the trigger.
- *
- * ```html
- * <button ngAccordionTrigger panelId="unique-id-1">
- *   Accordion Trigger Text
- * </button>
- * ```
- *
- * @developerPreview 21.0
- */
-declare class AccordionTrigger {
-    /** A reference to the trigger element. */
-    private readonly _elementRef;
-    /** A reference to the trigger element. */
-    readonly element: HTMLElement;
-    /** The parent AccordionGroup. */
-    private readonly _accordionGroup;
-    /** A unique identifier for the widget. */
-    readonly id: _angular_core.InputSignal<string>;
-    /** A local unique identifier for the trigger, used to match with its panel's `panelId`. */
-    readonly panelId: _angular_core.InputSignal<string>;
-    /** Whether the trigger is disabled. */
-    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Whether the corresponding panel is expanded. */
-    readonly expanded: _angular_core.ModelSignal<boolean>;
-    /** Whether the trigger is active. */
-    readonly active: _angular_core.Signal<boolean>;
-    /** The accordion panel pattern controlled by this trigger. This is set by AccordionGroup. */
-    readonly _accordionPanelPattern: WritableSignal<AccordionPanelPattern | undefined>;
-    /** The UI pattern instance for this trigger. */
-    readonly _pattern: AccordionTriggerPattern;
-    /** Expands this item. */
-    expand(): void;
-    /** Collapses this item. */
-    collapse(): void;
-    /** Toggles the expansion state of this item. */
-    toggle(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AccordionTrigger, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AccordionTrigger, "[ngAccordionTrigger]", ["ngAccordionTrigger"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "panelId": { "alias": "panelId"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AccordionPanel, "[ngAccordionPanel]", ["ngAccordionPanel"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "panelId": { "alias": "panelId"; "required": true; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof DeferredContentAware; inputs: { "preserveContent": "preserveContent"; }; outputs: {}; }]>;
 }
+
 /**
  * A container for a group of accordion items. It manages the overall state and
  * interactions of the accordion, such as keyboard navigation and expansion mode.
@@ -128,6 +87,7 @@ declare class AccordionTrigger {
  * ```
  *
  * @developerPreview 21.0
+ * @see [Accordion](guide/aria/accordion)
  */
 declare class AccordionGroup {
     /** A reference to the group element. */
@@ -141,7 +101,7 @@ declare class AccordionGroup {
     /** The AccordionPanels nested inside this group. */
     private readonly _panels;
     /** The text direction (ltr or rtl). */
-    readonly textDirection: WritableSignal<_angular_cdk_bidi.Direction>;
+    readonly textDirection: _angular_core.WritableSignal<_angular_cdk_bidi.Direction>;
     /** Whether the entire accordion group is disabled. */
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Whether multiple accordion items can be expanded simultaneously. */
@@ -165,6 +125,56 @@ declare class AccordionGroup {
     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; }; }, {}, ["_triggers", "_panels"], never, true, never>;
 }
+
+/**
+ * The trigger that toggles the visibility of its associated `ngAccordionPanel`.
+ *
+ * This directive requires a `panelId` that must match the `panelId` of the `ngAccordionPanel` it
+ * controls. When clicked, it will expand or collapse the panel. It also handles keyboard
+ * interactions for navigation within the `ngAccordionGroup`. It applies `role="button"` and manages
+ * `aria-expanded`, `aria-controls`, and `aria-disabled` attributes for accessibility.
+ * The `disabled` input can be used to disable the trigger.
+ *
+ * ```html
+ * <button ngAccordionTrigger panelId="unique-id-1">
+ *   Accordion Trigger Text
+ * </button>
+ * ```
+ *
+ * @developerPreview 21.0
+ * @see [Accordion](guide/aria/accordion)
+ */
+declare class AccordionTrigger {
+    /** A reference to the trigger element. */
+    private readonly _elementRef;
+    /** A reference to the trigger element. */
+    readonly element: HTMLElement;
+    /** The parent AccordionGroup. */
+    private readonly _accordionGroup;
+    /** A unique identifier for the widget. */
+    readonly id: _angular_core.InputSignal<string>;
+    /** A local unique identifier for the trigger, used to match with its panel's `panelId`. */
+    readonly panelId: _angular_core.InputSignal<string>;
+    /** Whether the trigger is disabled. */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Whether the corresponding panel is expanded. */
+    readonly expanded: _angular_core.ModelSignal<boolean>;
+    /** Whether the trigger is active. */
+    readonly active: _angular_core.Signal<boolean>;
+    /** The accordion panel pattern controlled by this trigger. This is set by AccordionGroup. */
+    readonly _accordionPanelPattern: WritableSignal<AccordionPanelPattern | undefined>;
+    /** The UI pattern instance for this trigger. */
+    readonly _pattern: AccordionTriggerPattern;
+    /** Expands this item. */
+    expand(): void;
+    /** Collapses this item. */
+    collapse(): void;
+    /** Toggles the expansion state of this item. */
+    toggle(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AccordionTrigger, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AccordionTrigger, "[ngAccordionTrigger]", ["ngAccordionTrigger"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "panelId": { "alias": "panelId"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; }, never, never, true, never>;
+}
+
 /**
  * A structural directive that provides a mechanism for lazily rendering the content for an
  * `ngAccordionPanel`.
@@ -182,10 +192,11 @@ declare class AccordionGroup {
  * ```
  *
  * @developerPreview 21.0
+ * @see [Accordion](guide/aria/accordion)
  */
 declare class AccordionContent {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AccordionContent, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AccordionContent, "ng-template[ngAccordionContent]", never, {}, {}, never, never, true, [{ directive: typeof i1.DeferredContent; inputs: {}; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AccordionContent, "ng-template[ngAccordionContent]", never, {}, {}, never, never, true, [{ directive: typeof DeferredContent; inputs: {}; outputs: {}; }]>;
 }
 
-export { AccordionContent, AccordionGroup, AccordionPanel, AccordionTrigger };
+export { AccordionContent, AccordionGroup, AccordionPanel, AccordionTrigger, DeferredContent as ɵɵDeferredContent };

package/types/aria.d.ts

@@ -1,6 +1,6 @@
 import { Version } from '@angular/core';
 
-/** Current version of the CDK Experimental package. */
+/** Current version of the Aria package. */
 declare const VERSION: Version;
 
 export { VERSION };

package/types/combobox.d.ts

@@ -1,8 +1,35 @@
 import * as _angular_core from '@angular/core';
-import { WritableSignal } from '@angular/core';
 import * as _angular_cdk_bidi from '@angular/cdk/bidi';
-import * as i1 from '@angular/aria/private';
-import { ComboboxPattern, ComboboxDialogPattern, ComboboxListboxControls, ComboboxTreeControls } from '@angular/aria/private';
+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.
@@ -33,10 +60,13 @@ import { ComboboxPattern, ComboboxDialogPattern, ComboboxListboxControls, Combob
  * ```
  *
  * @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> {
-    /** The directionality (LTR / RTL) context for the application (or a subtree of it). */
-    private readonly _directionality;
     /** A signal wrapper for directionality. */
     protected textDirection: _angular_core.Signal<_angular_cdk_bidi.Direction>;
     /** The element that the combobox is attached to. */
@@ -74,8 +104,45 @@ declare class Combobox<V> {
     /** 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 i1.DeferredContentAware; inputs: { "preserveContent": "preserveContent"; }; outputs: {}; }]>;
+    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
+ * based on the combobox's expanded state.
+ *
+ * ```html
+ * <ng-template ngComboboxPopupContainer>
+ *   <dialog ngComboboxDialog class="example-dialog">
+ *     <!-- ... dialog content ... -->
+ *   </dialog>
+ * </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: HTMLElement;
+    /** The combobox that the dialog belongs to. */
+    readonly combobox: Combobox<any>;
+    /** A reference to the parent combobox popup, if one exists. */
+    private readonly _popup;
+    _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: {}; }]>;
+}
+
 /**
  * An input that is part of a combobox. It is responsible for displaying the
  * current value and handling user input for filtering and selection.
@@ -93,6 +160,11 @@ declare class Combobox<V> {
  * ```
  *
  * @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. */
@@ -107,6 +179,7 @@ declare class ComboboxInput {
     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.
@@ -136,58 +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: {}; }]>;
-}
-/**
- * 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
- */
-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: WritableSignal<ComboboxDialogPattern | ComboboxListboxControls<any, V> | ComboboxTreeControls<any, V> | undefined>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComboboxPopup<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxPopup<any>, "[ngComboboxPopup]", ["ngComboboxPopup"], {}, {}, 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.
- *
- * ```html
- * <ng-template ngComboboxPopupContainer>
- *   <dialog ngComboboxDialog class="example-dialog">
- *     <!-- ... dialog content ... -->
- *   </dialog>
- * </ng-template>
- * ```
- *
- * @developerPreview 21.0
- */
-declare class ComboboxDialog {
-    /** The dialog element. */
-    private readonly _elementRef;
-    /** A reference to the dialog element. */
-    readonly element: HTMLElement;
-    /** The combobox that the dialog belongs to. */
-    readonly combobox: Combobox<any>;
-    /** A reference to the parent combobox popup, if one exists. */
-    private readonly _popup;
-    _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<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 };