docs: add dev-preview to aria exports (angular#32304)

Author: andrewseguin

src/aria/accordion/accordion.ts

@@ -32,6 +32,8 @@ import {
 /**
  * Represents the content panel of an accordion item. It is controlled by an
  * associated `AccordionTrigger`.
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: '[ngAccordionPanel]',
@@ -100,6 +102,8 @@ export class AccordionPanel {
 /**
  * Represents the trigger button for an accordion item. It controls the expansion
  * state of an associated `AccordionPanel`.
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: '[ngAccordionTrigger]',
@@ -180,6 +184,8 @@ export class AccordionTrigger {
 /**
  * Container for a group of accordion items. It manages the overall state and
  * interactions of the accordion, such as keyboard navigation and expansion mode.
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: '[ngAccordionGroup]',
@@ -259,6 +265,8 @@ export class AccordionGroup {
 /**
  * A structural directive that marks the `ng-template` to be used as the content
  * for a `AccordionPanel`. This content can be lazily loaded.
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: 'ng-template[ngAccordionContent]',

src/aria/combobox/combobox.spec.ts

@@ -1226,12 +1226,12 @@ class ComboboxTreeExample {
   }
 }
 
-export interface TreeNode {
+interface TreeNode {
   name: string;
   children?: TreeNode[];
 }
 
-export const TREE_NODES = [
+const TREE_NODES = [
   {
     name: 'Winter',
     children: [{name: 'December'}, {name: 'January'}, {name: 'February'}],

src/aria/combobox/combobox.ts

@@ -30,6 +30,9 @@ import {
 import {Directionality} from '@angular/cdk/bidi';
 import {toSignal} from '@angular/core/rxjs-interop';
 
+/**
+ * @developerPreview 21.0
+ */
 @Directive({
   selector: '[ngCombobox]',
   exportAs: 'ngCombobox',
@@ -129,6 +132,9 @@ export class Combobox<V> {
   }
 }
 
+/**
+ * @developerPreview 21.0
+ */
 @Directive({
   selector: 'input[ngComboboxInput]',
   exportAs: 'ngComboboxInput',
@@ -173,13 +179,19 @@ export class ComboboxInput {
   }
 }
 
+/**
+ * @developerPreview 21.0
+ */
 @Directive({
   selector: 'ng-template[ngComboboxPopupContainer]',
   exportAs: 'ngComboboxPopupContainer',
   hostDirectives: [DeferredContent],
 })
 export class ComboboxPopupContainer {}
 
+/**
+ * @developerPreview 21.0
+ */
 @Directive({
   selector: '[ngComboboxPopup]',
   exportAs: 'ngComboboxPopup',
@@ -197,6 +209,9 @@ export class ComboboxPopup<V> {
   >(undefined);
 }
 
+/**
+ * @developerPreview 21.0
+ */
 @Directive({
   selector: 'dialog[ngComboboxDialog]',
   exportAs: 'ngComboboxDialog',

src/aria/grid/grid.ts

@@ -23,7 +23,11 @@ import {
 import {Directionality} from '@angular/cdk/bidi';
 import {GridPattern, GridRowPattern, GridCellPattern, GridCellWidgetPattern} from '../private';
 
-/** A directive that provides grid-based navigation and selection behavior. */
+/**
+ * A directive that provides grid-based navigation and selection behavior.
+ *
+ * @developerPreview 21.0
+ */
 @Directive({
   selector: '[ngGrid]',
   exportAs: 'ngGrid',
@@ -119,7 +123,11 @@ export class Grid {
   }
 }
 
-/** A directive that represents a row in a grid. */
+/**
+ * A directive that represents a row in a grid.
+ *
+ * @developerPreview 21.0
+ */
 @Directive({
   selector: '[ngGridRow]',
   exportAs: 'ngGridRow',
@@ -162,7 +170,11 @@ export class GridRow {
   });
 }
 
-/** A directive that represents a cell in a grid. */
+/**
+ * A directive that represents a cell in a grid.
+ *
+ * @developerPreview 21.0
+ */
 @Directive({
   selector: '[ngGridCell]',
   exportAs: 'ngGridCell',
@@ -238,7 +250,11 @@ export class GridCell {
   });
 }
 
-/** A directive that represents a widget inside a grid cell. */
+/**
+ * A directive that represents a widget inside a grid cell.
+ *
+ * @developerPreview 21.0
+ */
 @Directive({
   selector: '[ngGridCellWidget]',
   exportAs: 'ngGridCellWidget',

src/aria/listbox/listbox.ts

@@ -38,6 +38,8 @@ import {ComboboxPopup} from '../combobox';
  *   <li [value]="3" ngOption>Item 3</li>
  * </ul>
  * ```
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: '[ngListbox]',
@@ -194,7 +196,11 @@ export class Listbox<V> {
   }
 }
 
-/** A selectable option in a Listbox. */
+/**
+ * A selectable option in a Listbox.
+ *
+ * @developerPreview 21.0
+ */
 @Directive({
   selector: '[ngOption]',
   exportAs: 'ngOption',

src/aria/menu/menu.ts

@@ -38,6 +38,8 @@ import {Directionality} from '@angular/cdk/bidi';
  *
  * The menu trigger is used to open and close menus, and can be placed on menu items to connect
  * sub-menus.
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: 'button[ngMenuTrigger]',
@@ -110,6 +112,8 @@ export class MenuTrigger<V> {
  *   <div ngMenuItem>Delete</div>
  * </div>
  * ```
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: '[ngMenu]',
@@ -242,6 +246,8 @@ export class Menu<V> {
  * Like the menu, a menubar is used to offer a list of menu item choices to users. However, a
  * menubar is used to display a persistent, top-level,
  * always-visible set of menu item choices.
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: '[ngMenuBar]',
@@ -324,6 +330,8 @@ export class MenuBar<V> {
  * An item in a Menu.
  *
  * Menu items can be used in menus and menubars to represent a choice or action a user can take.
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: '[ngMenuItem]',
@@ -408,7 +416,11 @@ export class MenuItem<V> {
   }
 }
 
-/** Defers the rendering of the menu content. */
+/**
+ * Defers the rendering of the menu content.
+ *
+ * @developerPreview 21.0
+ */
 @Directive({
   selector: 'ng-template[ngMenuContent]',
   exportAs: 'ngMenuContent',

src/aria/tabs/tabs.ts

@@ -68,6 +68,8 @@ function sortDirectives(a: HasElement, b: HasElement) {
  *      <ng-template ngTabContent>Tab content 3</ng-template>
  *   </div>
  * ```
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: '[ngTabs]',
@@ -125,6 +127,8 @@ export class Tabs {
  * A TabList container.
  *
  * Controls a list of Tab(s).
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: '[ngTabList]',
@@ -230,7 +234,11 @@ export class TabList implements OnInit, OnDestroy {
   }
 }
 
-/** A selectable tab in a TabList. */
+/**
+ * A selectable tab in a TabList.
+ *
+ * @developerPreview 21.0
+ */
 @Directive({
   selector: '[ngTab]',
   exportAs: 'ngTab',
@@ -314,6 +322,8 @@ export class Tab implements HasElement, OnInit, OnDestroy {
  * will be applied to the tabpanel element to remove it from the accessibility tree and stop
  * all the keyboard and pointer interactions. Note that this does not visually hide the tabpenl
  * and a proper styling is required.
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: '[ngTabPanel]',
@@ -374,6 +384,8 @@ export class TabPanel implements OnInit, OnDestroy {
 
 /**
  * A TabContent container for the lazy-loaded content.
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: 'ng-template[ngTabContent]',

src/aria/toolbar/toolbar.ts

@@ -59,6 +59,8 @@ function sortDirectives(a: HasElement, b: HasElement) {
  *  </div>
  * </div>
  * ```
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: '[ngToolbar]',
@@ -162,6 +164,8 @@ export class Toolbar<V> {
  *
  * A widget is anything that is within a toolbar. It should be applied to any native HTML element
  * that has the purpose of acting as a widget navigatable within a toolbar.
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: '[ngToolbarWidget]',
@@ -236,6 +240,8 @@ export class ToolbarWidget<V> implements OnInit, OnDestroy {
 /**
  * A directive that groups toolbar widgets, used for more complex widgets like radio groups that
  * have their own internal navigation.
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: '[ngToolbarWidgetGroup]',

src/aria/tree/tree.ts

@@ -66,6 +66,8 @@ function sortDirectives(a: HasElement, b: HasElement) {
  *   <li ngTreeItem [value]="'leaf2'" [disabled]="true">Disabled Leaf Item 2</li>
  * </ul>
  * ```
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: '[ngTree]',
@@ -214,6 +216,8 @@ export class Tree<V> {
 
 /**
  * A selectable and expandable Tree Item in a Tree.
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: '[ngTreeItem]',
@@ -344,6 +348,8 @@ export class TreeItem<V> extends DeferredContentAware implements OnInit, OnDestr
 
 /**
  * Contains children tree itmes.
+ *
+ * @developerPreview 21.0
  */
 @Directive({
   selector: 'ng-template[ngTreeItemGroup]',