@angular/aria 22.0.0-next.7 → 22.0.0-rc.0

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,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 {
@@ -532,6 +538,8 @@ declare class GridPattern {
     /** Whether the grid state is stale and needs to be reconciled. */
     private readonly _stateStale;
     constructor(inputs: GridInputs);
+    /** Returns a set of violations */
+    validate(): string[];
     /** Handles keydown events on the grid. */
     onKeydown(event: KeyboardEvent): void;
     /** Handles click events on the grid. */

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';
 
@@ -84,6 +84,8 @@ declare class MenuPattern<V> {
     /** Handles keyboard events for the menu. */
     readonly keydownManager: SignalLike<KeyboardEventManager<KeyboardEvent>>;
     constructor(inputs: MenuInputs<V>);
+    /** Returns a set of violations */
+    validate(): string[];
     /** Sets the default state for the menu. */
     setDefaultState(): void;
     /** Sets the default active state of the menu before receiving interaction for the first time. */

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. */
@@ -106,6 +106,8 @@ declare class ToolbarPattern<V> {
     private _goto;
     select(): void;
     constructor(inputs: ToolbarInputs<V>);
+    /** Returns a set of violations */
+    validate(): string[];
     /** Handles keydown events for the toolbar. */
     onKeydown(event: KeyboardEvent): void;
     onPointerdown(event: PointerEvent): void;

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';
@@ -27,7 +27,6 @@ import './_list-navigation-chunk.js';
  * </div>
  * ```
  *
- * @developerPreview 21.0
  * @see [Accordion](guide/aria/accordion)
  */
 declare class AccordionPanel {
@@ -37,6 +36,7 @@ declare class AccordionPanel {
     readonly element: HTMLElement;
     /** The DeferredContentAware host directive. */
     private readonly _deferredContentAware;
+    private readonly _accordionContent;
     /** A global unique identifier for the panel. */
     readonly id: _angular_core.InputSignal<string>;
     /** Whether the accordion panel is visible. True if the associated trigger is expanded. */
@@ -55,7 +55,7 @@ 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; }; }, {}, never, never, true, [{ directive: typeof DeferredContentAware; inputs: { "preserveContent": "preserveContent"; }; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AccordionPanel, "[ngAccordionPanel]", ["ngAccordionPanel"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; }, {}, ["_accordionContent"], never, true, [{ directive: typeof DeferredContentAware; inputs: { "preserveContent": "preserveContent"; }; outputs: {}; }]>;
 }
 
 /**
@@ -73,7 +73,6 @@ declare class AccordionPanel {
  * </button>
  * ```
  *
- * @developerPreview 21.0
  * @see [Accordion](guide/aria/accordion)
  */
 declare class AccordionTrigger implements OnInit, OnDestroy {
@@ -91,14 +90,13 @@ 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. */
     readonly active: _angular_core.Signal<boolean>;
     /** The UI pattern instance for this trigger. */
     _pattern: AccordionTriggerPattern;
+    constructor();
     ngOnInit(): void;
     ngOnDestroy(): void;
     /** Expands this item. */
@@ -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>;
 }
 
 /**
@@ -144,18 +142,15 @@ declare class AccordionTrigger implements OnInit, OnDestroy {
  * </div>
  * ```
  *
- * @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 +168,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>;
 }
@@ -201,7 +194,6 @@ declare class AccordionGroup {
  * </div>
  * ```
  *
- * @developerPreview 21.0
  * @see [Accordion](guide/aria/accordion)
  */
 declare class AccordionContent {

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