build: setup golden file testing for @angular/aria package

goldens/BUILD.bazel

@@ -39,3 +39,10 @@ api_golden_test_npm_package(
         "//:node_modules/@types/youtube": "youtube",
     },
 )
+
+api_golden_test_npm_package(
+    name = "aria_api",
+    data = glob(["aria/**"]) + ["//src/aria:npm_package"],
+    golden_dir = "goldens/aria",
+    npm_package = "src/aria/npm_package",
+)

goldens/aria/accordion/index.api.md

@@ -0,0 +1,79 @@
+## API Report File for "@angular/aria_accordion"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+
+import { AccordionGroupPattern } from '@angular/aria/private';
+import { AccordionPanelPattern } from '@angular/aria/private';
+import { AccordionTriggerPattern } from '@angular/aria/private';
+import * as _angular_cdk_bidi from '@angular/cdk/bidi';
+import * as _angular_core from '@angular/core';
+import * as i1 from '@angular/aria/private';
+import { WritableSignal } from '@angular/core';
+
+// @public
+export class AccordionContent {
+    // (undocumented)
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AccordionContent, "ng-template[ngAccordionContent]", never, {}, {}, never, never, true, [{ directive: typeof i1.DeferredContent; inputs: {}; outputs: {}; }]>;
+    // (undocumented)
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AccordionContent, never>;
+}
+
+// @public
+export class AccordionGroup {
+    constructor();
+    collapseAll(): void;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly element: HTMLElement;
+    expandAll(): void;
+    readonly multiExpandable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly _pattern: AccordionGroupPattern;
+    readonly softDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly textDirection: WritableSignal<_angular_cdk_bidi.Direction>;
+    readonly wrap: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    // (undocumented)
+    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>;
+    // (undocumented)
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AccordionGroup, never>;
+}
+
+// @public
+export class AccordionPanel {
+    constructor();
+    readonly _accordionTriggerPattern: WritableSignal<AccordionTriggerPattern | undefined>;
+    collapse(): void;
+    expand(): void;
+    readonly id: _angular_core.InputSignal<string>;
+    readonly panelId: _angular_core.InputSignal<string>;
+    readonly _pattern: AccordionPanelPattern;
+    toggle(): void;
+    readonly visible: _angular_core.Signal<boolean>;
+    // (undocumented)
+    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: {}; }]>;
+    // (undocumented)
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AccordionPanel, never>;
+}
+
+// @public
+export class AccordionTrigger {
+    readonly _accordionPanelPattern: WritableSignal<AccordionPanelPattern | undefined>;
+    readonly active: _angular_core.Signal<boolean>;
+    collapse(): void;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly element: HTMLElement;
+    expand(): void;
+    readonly expanded: _angular_core.ModelSignal<boolean>;
+    readonly id: _angular_core.InputSignal<string>;
+    readonly panelId: _angular_core.InputSignal<string>;
+    readonly _pattern: AccordionTriggerPattern;
+    toggle(): void;
+    // (undocumented)
+    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>;
+    // (undocumented)
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AccordionTrigger, never>;
+}
+
+// (No @packageDocumentation comment for this package)
+
+```

goldens/aria/combobox/index.api.md

@@ -0,0 +1,85 @@
+## API Report File for "@angular/aria_combobox"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+
+import * as _angular_cdk_bidi from '@angular/cdk/bidi';
+import * as _angular_core from '@angular/core';
+import { ComboboxDialogPattern } from '@angular/aria/private';
+import { ComboboxListboxControls } from '@angular/aria/private';
+import { ComboboxPattern } from '@angular/aria/private';
+import { ComboboxTreeControls } from '@angular/aria/private';
+import * as i1 from '@angular/aria/private';
+import { WritableSignal } from '@angular/core';
+
+// @public
+export class Combobox<V> {
+    constructor();
+    readonly alwaysExpanded: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    close(): void;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly element: HTMLElement;
+    readonly expanded: _angular_core.Signal<boolean>;
+    filterMode: _angular_core.InputSignal<"manual" | "auto-select" | "highlight">;
+    readonly firstMatch: _angular_core.InputSignal<V | undefined>;
+    readonly inputElement: _angular_core.Signal<HTMLInputElement | undefined>;
+    open(): void;
+    readonly _pattern: ComboboxPattern<any, V>;
+    readonly popup: _angular_core.Signal<ComboboxPopup<V> | undefined>;
+    readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    protected textDirection: _angular_core.Signal<_angular_cdk_bidi.Direction>;
+    // (undocumented)
+    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: {}; }]>;
+    // (undocumented)
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<Combobox<any>, never>;
+}
+
+// @public
+export class ComboboxDialog {
+    constructor();
+    // (undocumented)
+    close(): void;
+    readonly combobox: Combobox<any>;
+    readonly element: HTMLElement;
+    // (undocumented)
+    _pattern: ComboboxDialogPattern;
+    // (undocumented)
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxDialog, "dialog[ngComboboxDialog]", ["ngComboboxDialog"], {}, {}, never, never, true, [{ directive: typeof ComboboxPopup; inputs: {}; outputs: {}; }]>;
+    // (undocumented)
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComboboxDialog, never>;
+}
+
+// @public
+export class ComboboxInput {
+    constructor();
+    readonly combobox: Combobox<any>;
+    readonly element: HTMLElement;
+    value: _angular_core.ModelSignal<string>;
+    // (undocumented)
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxInput, "input[ngComboboxInput]", ["ngComboboxInput"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+    // (undocumented)
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComboboxInput, never>;
+}
+
+// @public
+export class ComboboxPopup<V> {
+    readonly combobox: Combobox<V> | null;
+    readonly _controls: WritableSignal<ComboboxDialogPattern | ComboboxListboxControls<any, V> | ComboboxTreeControls<any, V> | undefined>;
+    // (undocumented)
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxPopup<any>, "[ngComboboxPopup]", ["ngComboboxPopup"], {}, {}, never, never, true, never>;
+    // (undocumented)
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComboboxPopup<any>, never>;
+}
+
+// @public
+export class ComboboxPopupContainer {
+    // (undocumented)
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxPopupContainer, "ng-template[ngComboboxPopupContainer]", ["ngComboboxPopupContainer"], {}, {}, never, never, true, [{ directive: typeof i1.DeferredContent; inputs: {}; outputs: {}; }]>;
+    // (undocumented)
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComboboxPopupContainer, never>;
+}
+
+// (No @packageDocumentation comment for this package)
+
+```

goldens/aria/grid/index.api.md

@@ -0,0 +1,97 @@
+## API Report File for "@angular/aria_grid"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+
+import * as _angular_cdk_bidi from '@angular/cdk/bidi';
+import * as _angular_core from '@angular/core';
+import { ElementRef } from '@angular/core';
+import { Signal } from '@angular/core';
+import { WritableSignal } from '@angular/core';
+
+// @public
+export class Grid {
+    constructor();
+    readonly colWrap: _angular_core.InputSignal<"continuous" | "loop" | "nowrap">;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly element: HTMLElement;
+    readonly enableRangeSelection: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly enableSelection: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly focusMode: _angular_core.InputSignal<"roving" | "activedescendant">;
+    readonly multi: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly _pattern: GridPattern;
+    readonly rowWrap: _angular_core.InputSignal<"continuous" | "loop" | "nowrap">;
+    readonly selectionMode: _angular_core.InputSignal<"follow" | "explicit">;
+    readonly softDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly textDirection: _angular_core.WritableSignal<_angular_cdk_bidi.Direction>;
+    // (undocumented)
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Grid, "[ngGrid]", ["ngGrid"], { "enableSelection": { "alias": "enableSelection"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "softDisabled": { "alias": "softDisabled"; "required": false; "isSignal": true; }; "focusMode": { "alias": "focusMode"; "required": false; "isSignal": true; }; "rowWrap": { "alias": "rowWrap"; "required": false; "isSignal": true; }; "colWrap": { "alias": "colWrap"; "required": false; "isSignal": true; }; "multi": { "alias": "multi"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "enableRangeSelection": { "alias": "enableRangeSelection"; "required": false; "isSignal": true; }; }, {}, ["_rows"], never, true, never>;
+    // (undocumented)
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<Grid, never>;
+}
+
+// @public
+export class GridCell {
+    constructor();
+    readonly active: Signal<boolean>;
+    readonly colIndex: _angular_core.InputSignal<number | undefined>;
+    readonly colSpan: _angular_core.InputSignal<number>;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly element: HTMLElement;
+    readonly id: _angular_core.InputSignal<string>;
+    readonly orientation: _angular_core.InputSignal<"vertical" | "horizontal">;
+    readonly _pattern: GridCellPattern;
+    readonly role: _angular_core.InputSignal<"gridcell" | "columnheader" | "rowheader">;
+    readonly rowIndex: _angular_core.InputSignal<number | undefined>;
+    readonly rowSpan: _angular_core.InputSignal<number>;
+    readonly selectable: _angular_core.InputSignal<boolean>;
+    readonly selected: _angular_core.ModelSignal<boolean>;
+    protected readonly _tabIndex: Signal<number>;
+    readonly tabindex: _angular_core.InputSignal<number | undefined>;
+    readonly textDirection: _angular_core.WritableSignal<_angular_cdk_bidi.Direction>;
+    readonly wrap: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    // (undocumented)
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GridCell, "[ngGridCell]", ["ngGridCell"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "role": { "alias": "role"; "required": false; "isSignal": true; }; "rowSpan": { "alias": "rowSpan"; "required": false; "isSignal": true; }; "colSpan": { "alias": "colSpan"; "required": false; "isSignal": true; }; "rowIndex": { "alias": "rowIndex"; "required": false; "isSignal": true; }; "colIndex": { "alias": "colIndex"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "tabindex": { "alias": "tabindex"; "required": false; "isSignal": true; }; }, { "selected": "selectedChange"; }, ["_widgets"], never, true, never>;
+    // (undocumented)
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<GridCell, never>;
+}
+
+// @public
+export class GridCellWidget {
+    constructor();
+    activate(): void;
+    readonly active: Signal<boolean>;
+    deactivate(): void;
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly element: HTMLElement;
+    readonly focusTarget: _angular_core.InputSignal<ElementRef<any> | HTMLElement | undefined>;
+    readonly id: _angular_core.InputSignal<string>;
+    get isActivated(): Signal<boolean>;
+    readonly onActivate: _angular_core.OutputEmitterRef<KeyboardEvent | FocusEvent | undefined>;
+    readonly onDeactivate: _angular_core.OutputEmitterRef<KeyboardEvent | FocusEvent | undefined>;
+    readonly _pattern: GridCellWidgetPattern;
+    protected readonly _tabIndex: Signal<number>;
+    readonly tabindex: _angular_core.InputSignal<number | undefined>;
+    readonly widgetType: _angular_core.InputSignal<"simple" | "complex" | "editable">;
+    // (undocumented)
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GridCellWidget, "[ngGridCellWidget]", ["ngGridCellWidget"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "widgetType": { "alias": "widgetType"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "focusTarget": { "alias": "focusTarget"; "required": false; "isSignal": true; }; "tabindex": { "alias": "tabindex"; "required": false; "isSignal": true; }; }, { "onActivate": "onActivate"; "onDeactivate": "onDeactivate"; }, never, never, true, never>;
+    // (undocumented)
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<GridCellWidget, never>;
+}
+
+// @public
+export class GridRow {
+    readonly element: HTMLElement;
+    readonly _gridPattern: Signal<GridPattern>;
+    readonly _pattern: GridRowPattern;
+    readonly rowIndex: _angular_core.InputSignal<number | undefined>;
+    // (undocumented)
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<GridRow, "[ngGridRow]", ["ngGridRow"], { "rowIndex": { "alias": "rowIndex"; "required": false; "isSignal": true; }; }, {}, ["_cells"], never, true, never>;
+    // (undocumented)
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<GridRow, never>;
+}
+
+// (No @packageDocumentation comment for this package)
+
+```

goldens/aria/index.api.md

@@ -0,0 +1,14 @@
+## API Report File for "@angular/aria"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+
+import { Version } from '@angular/core';
+
+// @public
+export const VERSION: Version;
+
+// (No @packageDocumentation comment for this package)
+
+```