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

package/types/_collection-chunk.d.ts

@@ -0,0 +1,42 @@
+import { Signal } from '@angular/core';
+
+type SignalLike<T> = () => T;
+interface WritableSignalLike<T> extends SignalLike<T> {
+    set(value: T): void;
+    update(updateFn: (value: T) => T): void;
+    asReadonly(): SignalLike<T>;
+}
+/** Converts a getter setter style signal to a WritableSignalLike. */
+declare function convertGetterSetterToWritableSignalLike<T>(getter: () => T, setter: (v: T) => void): WritableSignalLike<T>;
+declare function computed<T>(computation: () => T): SignalLike<T>;
+declare function signal<T>(initialValue: T): WritableSignalLike<T>;
+declare function linkedSignal<T>(sourceFn: () => T): WritableSignalLike<T>;
+
+interface HasElement {
+    element: HTMLElement;
+}
+/**
+ * Sort directives by their document order.
+ */
+declare function sortDirectives(a: HasElement, b: HasElement): 1 | -1;
+
+/**
+ * A collection that lazily sorts its items based on their DOM position.
+ * It uses manual registration and updates its order when items are added/removed
+ * or when structural DOM changes are detected via MutationObserver.
+ *
+ * TODO(ok7sai): replace Mutation Observer with internal API.
+ */
+declare class SortedCollection<T extends HasElement> {
+    private readonly _items;
+    private readonly _version;
+    private _observer?;
+    readonly orderedItems: Signal<T[]>;
+    register(item: T): void;
+    unregister(item: T): void;
+    startObserving(element: HTMLElement): void;
+    stopObserving(): void;
+}
+
+export { SortedCollection, computed, convertGetterSetterToWritableSignalLike, linkedSignal, signal, sortDirectives };
+export type { HasElement, SignalLike, WritableSignalLike };

package/types/_expansion-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 that can be expanded or collapsed. */
 interface ExpansionItem {

package/types/_grid-chunk.d.ts

@@ -1,6 +1,7 @@
-import { SignalLike, WritableSignalLike } from './_signal-like-chunk.js';
+import { SignalLike, WritableSignalLike } from './_collection-chunk.js';
 import { KeyboardEventManager } from './_keyboard-event-manager-chunk.js';
-import { PointerEventManager } from './_pointer-event-manager-chunk.js';
+import { ClickEventManager } from './_click-event-manager-chunk.js';
+import { ElementRef } from '@angular/core';
 
 /** Represents coordinates in a grid. */
 interface RowCol {
@@ -334,6 +335,11 @@ declare class Grid<T extends GridCell> {
     private _navigateWithSelection;
 }
 
+/** A type that allows lazy resolution of a DOM Element. */
+type ElementResolver<T = HTMLElement> = ElementRef<T> | T | undefined | null | ((context: HTMLElement) => T | null | undefined);
+/** Evaluates an ElementResolver to return the underlying DOM element, or undefined. */
+declare function resolveElement<T = HTMLElement>(resolver: ElementResolver<T>, context: HTMLElement): T | undefined;
+
 /** The inputs for the `GridCellWidgetPattern`. */
 interface GridCellWidgetInputs {
     /** Whether the widget is disabled. */
@@ -345,7 +351,11 @@ interface GridCellWidgetInputs {
     /** The type of widget, which determines how it is activated. */
     widgetType: SignalLike<'simple' | 'complex' | 'editable'>;
     /** The element that will receive focus when the widget is activated. */
-    focusTarget: SignalLike<HTMLElement | undefined>;
+    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 {
@@ -377,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. */
@@ -515,8 +529,8 @@ declare class GridPattern {
     readonly nextColKey: SignalLike<"ArrowRight" | "ArrowLeft">;
     /** The keydown event manager for the grid. */
     readonly keydown: SignalLike<KeyboardEventManager<KeyboardEvent>>;
-    /** The pointerdown event manager for the grid. */
-    readonly pointerdown: SignalLike<PointerEventManager<PointerEvent>>;
+    /** The click event manager for the grid. */
+    readonly clickManager: SignalLike<ClickEventManager<PointerEvent>>;
     /** Indicates maybe the losing focus is caused by row/cell deletion. */
     private readonly _maybeDeletion;
     /** Indicates the losing focus is certainly caused by row/cell deletion. */
@@ -526,8 +540,8 @@ declare class GridPattern {
     constructor(inputs: GridInputs);
     /** Handles keydown events on the grid. */
     onKeydown(event: KeyboardEvent): void;
-    /** Handles pointerdown events on the grid. */
-    onPointerdown(event: PointerEvent): void;
+    /** Handles click events on the grid. */
+    onClick(event: PointerEvent): void;
     /** Handles focusin events on the grid. */
     onFocusIn(event: FocusEvent): void;
     /** Handles focusout events on the grid. */
@@ -544,5 +558,5 @@ declare class GridPattern {
     focusEffect(): void;
 }
 
-export { GridCellPattern, GridCellWidgetPattern, GridPattern, GridRowPattern };
-export type { GridCellInputs, GridCellWidgetInputs, GridInputs, GridRowInputs };
+export { GridCellPattern, GridCellWidgetPattern, GridPattern, GridRowPattern, resolveElement };
+export type { ElementResolver, GridCellInputs, GridCellWidgetInputs, GridInputs, GridRowInputs };

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,56 +1,27 @@
 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';
 
-/** Represents the required inputs for the label control. */
-interface LabelControlInputs {
-    /** The default `aria-labelledby` ids. */
-    defaultLabelledBy: SignalLike<string[]>;
-}
-/** Represents the optional inputs for the label control. */
-interface LabelControlOptionalInputs {
-    /** The `aria-label`. */
-    label?: SignalLike<string | undefined>;
-    /** The user-provided `aria-labelledby` ids. */
-    labelledBy?: SignalLike<string[]>;
-}
-/** Controls label and description of an element. */
-declare class LabelControl {
-    readonly inputs: LabelControlInputs & LabelControlOptionalInputs;
-    /** The `aria-label`. */
-    readonly label: SignalLike<string | undefined>;
-    /** The `aria-labelledby` ids. */
-    readonly labelledBy: SignalLike<string[]>;
-    constructor(inputs: LabelControlInputs & LabelControlOptionalInputs);
-}
-
 /** The required inputs to tabs. */
-interface TabInputs extends Omit<ListNavigationItem, 'index'>, Omit<ExpansionItem, 'expandable'> {
+interface TabInputs extends Omit<ListNavigationItem, 'index'>, Omit<ExpansionItem, 'expandable' | 'expanded'> {
     /** The parent tablist that controls the tab. */
-    tablist: SignalLike<TabListPattern>;
+    tabList: SignalLike<TabListPattern>;
     /** The remote tabpanel controlled by the tab. */
-    tabpanel: SignalLike<TabPanelPattern | undefined>;
-    /** The remote tabpanel unique identifier. */
-    value: SignalLike<string>;
+    tabPanel: SignalLike<TabPanelPattern | undefined>;
 }
 /** A tab in a tablist. */
 declare class TabPattern {
     readonly inputs: TabInputs;
     /** A global unique identifier for the tab. */
     readonly id: SignalLike<string>;
-    /** The index of the tab. */
-    readonly index: SignalLike<number>;
-    /** The remote tabpanel unique identifier. */
-    readonly value: SignalLike<string>;
     /** Whether the tab is disabled. */
     readonly disabled: SignalLike<boolean>;
     /** The html element that should receive focus. */
     readonly element: SignalLike<HTMLElement>;
     /** Whether this tab has expandable panel. */
     readonly expandable: SignalLike<boolean>;
-    /** Whether the tab panel is expanded. */
     readonly expanded: WritableSignalLike<boolean>;
     /** Whether the tab is active. */
     readonly active: SignalLike<boolean>;
@@ -65,23 +36,17 @@ declare class TabPattern {
     open(): boolean;
 }
 /** The required inputs for the tabpanel. */
-interface TabPanelInputs extends LabelControlOptionalInputs {
+interface TabPanelInputs {
     /** A global unique identifier for the tabpanel. */
     id: SignalLike<string>;
     /** The tab that controls this tabpanel. */
-    tab: SignalLike<TabPattern | undefined>;
-    /** A local unique identifier for the tabpanel. */
-    value: SignalLike<string>;
+    readonly tab: SignalLike<TabPattern | undefined>;
 }
 /** A tabpanel associated with a tab. */
 declare class TabPanelPattern {
     readonly inputs: TabPanelInputs;
     /** A global unique identifier for the tabpanel. */
     readonly id: SignalLike<string>;
-    /** A local unique identifier for the tabpanel. */
-    readonly value: SignalLike<string>;
-    /** Controls label for this tabpanel. */
-    readonly labelManager: LabelControl;
     /** Whether the tabpanel is hidden. */
     readonly hidden: SignalLike<boolean>;
     /** The tab index of this tabpanel. */
@@ -94,6 +59,8 @@ declare class TabPanelPattern {
 interface TabListInputs extends Omit<ListNavigationInputs<TabPattern>, 'multi'>, Omit<ListExpansionInputs, 'multiExpandable' | 'items'> {
     /** The selection strategy used by the tablist. */
     selectionMode: SignalLike<'follow' | 'explicit'>;
+    /** The currently selected tab. */
+    selectedTab: WritableSignalLike<TabPattern | undefined>;
 }
 /** Controls the state of a tablist. */
 declare class TabListPattern {
@@ -146,8 +113,6 @@ declare class TabListPattern {
     onClick(event: PointerEvent): void;
     /** Handles focusin events for the tablist. */
     onFocusIn(): void;
-    /** Opens the tab by given value. */
-    open(value: string): boolean;
     /** Opens the given tab or the current active tab. */
     open(tab?: TabPattern): boolean;
     /** Executes a navigation operation and expand the active tab if needed. */

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 };