@angular/aria 21.0.0-rc.0 → 21.0.0-rc.2

package/_adev_assets/aria-toolbar.json

@@ -9,6 +9,16 @@
       "isAbstract": false,
       "entryType": "directive",
       "members": [
+        {
+          "name": "element",
+          "type": "HTMLElement",
+          "memberType": "property",
+          "memberTags": [
+            "readonly"
+          ],
+          "description": "A reference to the host element.",
+          "jsdocTags": []
+        },
         {
           "name": "textDirection",
           "type": "any",
@@ -16,7 +26,7 @@
           "memberTags": [
             "readonly"
           ],
-          "description": "A signal wrapper for directionality.",
+          "description": "Text direction.",
           "jsdocTags": []
         },
         {
@@ -43,16 +53,15 @@
           "isRequiredInput": false
         },
         {
-          "name": "skipDisabled",
+          "name": "softDisabled",
           "type": "any",
           "memberType": "property",
           "memberTags": [
-            "readonly",
             "input"
           ],
-          "description": "Whether disabled items in the group should be skipped when navigating.",
+          "description": "Whether to allow disabled items to receive focus. When `true`, disabled items are\nfocusable but not interactive. When `false`, disabled items are skipped during navigation.",
           "jsdocTags": [],
-          "inputAlias": "skipDisabled",
+          "inputAlias": "softDisabled",
           "isRequiredInput": false
         },
         {
@@ -128,7 +137,7 @@
                 {
                   "name": "widget",
                   "description": "",
-                  "type": "ToolbarWidget<V> | ToolbarWidgetGroup<V>",
+                  "type": "ToolbarWidget<V>",
                   "isOptional": false,
                   "isRestParam": false
                 }
@@ -142,7 +151,7 @@
               {
                 "name": "widget",
                 "description": "",
-                "type": "ToolbarWidget<V> | ToolbarWidgetGroup<V>",
+                "type": "ToolbarWidget<V>",
                 "isOptional": false,
                 "isRestParam": false
               }
@@ -177,7 +186,7 @@
                 {
                   "name": "widget",
                   "description": "",
-                  "type": "ToolbarWidget<V> | ToolbarWidgetGroup<V>",
+                  "type": "ToolbarWidget<V>",
                   "isOptional": false,
                   "isRestParam": false
                 }
@@ -191,7 +200,7 @@
               {
                 "name": "widget",
                 "description": "",
-                "type": "ToolbarWidget<V> | ToolbarWidgetGroup<V>",
+                "type": "ToolbarWidget<V>",
                 "isOptional": false,
                 "isRestParam": false
               }
@@ -218,9 +227,14 @@
           "name": "V"
         }
       ],
-      "description": "A toolbar widget container.\n\nWidgets such as radio groups or buttons are nested within a toolbar to allow for a single\nplace of reference for focus and navigation. The Toolbar is meant to be used in conjunction\nwith ToolbarWidget and RadioGroup as follows:\n\n```html\n<div ngToolbar>\n <button ngToolbarWidget>Button</button>\n <div ngRadioGroup>\n   <label ngRadioButton value=\"1\">Option 1</label>\n   <label ngRadioButton value=\"2\">Option 2</label>\n   <label ngRadioButton value=\"3\">Option 3</label>\n </div>\n</div>\n```",
-      "jsdocTags": [],
-      "rawComment": "/**\n * A toolbar widget container.\n *\n * Widgets such as radio groups or buttons are nested within a toolbar to allow for a single\n * place of reference for focus and navigation. The Toolbar is meant to be used in conjunction\n * with ToolbarWidget and RadioGroup as follows:\n *\n * ```html\n * <div ngToolbar>\n *  <button ngToolbarWidget>Button</button>\n *  <div ngRadioGroup>\n *    <label ngRadioButton value=\"1\">Option 1</label>\n *    <label ngRadioButton value=\"2\">Option 2</label>\n *    <label ngRadioButton value=\"3\">Option 3</label>\n *  </div>\n * </div>\n * ```\n */",
+      "description": "A toolbar widget container for a group of interactive widgets, such as\nbuttons or radio groups. It provides a single point of reference for keyboard navigation\nand focus management. It supports various orientations and disabled states.\n\n```html\n<div ngToolbar orientation=\"horizontal\" [wrap]=\"true\">\n  <button ngToolbarWidget value=\"save\">Save</button>\n  <button ngToolbarWidget value=\"print\">Print</button>\n\n  <div ngToolbarWidgetGroup [(value)]=\"selectedAlignment\">\n    <button ngToolbarWidget value=\"left\">Left</button>\n    <button ngToolbarWidget value=\"center\">Center</button>\n    <button ngToolbarWidget value=\"right\">Right</button>\n  </div>\n</div>\n```",
+      "jsdocTags": [
+        {
+          "name": "developerPreview",
+          "comment": "21.0"
+        }
+      ],
+      "rawComment": "/**\n * A toolbar widget container for a group of interactive widgets, such as\n * buttons or radio groups. It provides a single point of reference for keyboard navigation\n * and focus management. It supports various orientations and disabled states.\n *\n * ```html\n * <div ngToolbar orientation=\"horizontal\" [wrap]=\"true\">\n *   <button ngToolbarWidget value=\"save\">Save</button>\n *   <button ngToolbarWidget value=\"print\">Print</button>\n *\n *   <div ngToolbarWidgetGroup [(value)]=\"selectedAlignment\">\n *     <button ngToolbarWidget value=\"left\">Left</button>\n *     <button ngToolbarWidget value=\"center\">Center</button>\n *     <button ngToolbarWidget value=\"right\">Right</button>\n *   </div>\n * </div>\n * ```\n *\n * @developerPreview 21.0\n */",
       "implements": [],
       "isStandalone": true,
       "selector": "[ngToolbar]",
@@ -229,8 +243,8 @@
       ],
       "source": {
         "filePath": "/src/aria/toolbar/toolbar.ts",
-        "startLine": 62,
-        "endLine": 159
+        "startLine": 64,
+        "endLine": 164
       }
     },
     {
@@ -239,33 +253,36 @@
       "entryType": "directive",
       "members": [
         {
-          "name": "id",
-          "type": "any",
+          "name": "element",
+          "type": "HTMLElement",
           "memberType": "property",
           "memberTags": [
             "readonly"
           ],
-          "description": "A unique identifier for the widget.",
+          "description": "A reference to the host element.",
           "jsdocTags": []
         },
         {
-          "name": "toolbar",
+          "name": "id",
           "type": "any",
           "memberType": "property",
           "memberTags": [
-            "readonly"
+            "readonly",
+            "input"
           ],
-          "description": "The parent Toolbar UIPattern.",
-          "jsdocTags": []
+          "description": "A unique identifier for the widget.",
+          "jsdocTags": [],
+          "inputAlias": "id",
+          "isRequiredInput": false
         },
         {
-          "name": "element",
+          "name": "toolbar",
           "type": "any",
           "memberType": "property",
           "memberTags": [
             "readonly"
           ],
-          "description": "A reference to the widget element to be focused on navigation.",
+          "description": "The parent Toolbar UIPattern.",
           "jsdocTags": []
         },
         {
@@ -291,6 +308,49 @@
           "description": "Whether the widget is 'hard' disabled, which is different from `aria-disabled`. A hard disabled widget cannot receive focus.",
           "jsdocTags": []
         },
+        {
+          "name": "value",
+          "type": "any",
+          "memberType": "property",
+          "memberTags": [
+            "readonly",
+            "input"
+          ],
+          "description": "The value associated with the widget.",
+          "jsdocTags": [],
+          "inputAlias": "value",
+          "isRequiredInput": true
+        },
+        {
+          "name": "active",
+          "type": "any",
+          "memberType": "property",
+          "memberTags": [
+            "readonly"
+          ],
+          "description": "Whether the widget is currently active (focused).",
+          "jsdocTags": []
+        },
+        {
+          "name": "selected",
+          "type": "() => any",
+          "memberType": "property",
+          "memberTags": [
+            "readonly"
+          ],
+          "description": "Whether the widget is selected (only relevant in a selection group).",
+          "jsdocTags": []
+        },
+        {
+          "name": "group",
+          "type": "SignalLike<any>",
+          "memberType": "property",
+          "memberTags": [
+            "readonly"
+          ],
+          "description": "",
+          "jsdocTags": []
+        },
         {
           "name": "ngOnInit",
           "signatures": [
@@ -363,9 +423,14 @@
           "name": "V"
         }
       ],
-      "description": "A widget within a toolbar.\n\nA widget is anything that is within a toolbar. It should be applied to any native HTML element\nthat has the purpose of acting as a widget navigatable within a toolbar.",
-      "jsdocTags": [],
-      "rawComment": "/**\n * A widget within a toolbar.\n *\n * A widget is anything that is within a toolbar. It should be applied to any native HTML element\n * that has the purpose of acting as a widget navigatable within a toolbar.\n */",
+      "description": "A widget within a toolbar.\n\nThe `ngToolbarWidget` directive should be applied to any native HTML element that acts\nas an interactive widget within an `ngToolbar` or `ngToolbarWidgetGroup`. It enables\nkeyboard navigation and selection within the toolbar.\n\n```html\n<button ngToolbarWidget value=\"action-id\" [disabled]=\"isDisabled\">\n  Perform Action\n</button>\n```",
+      "jsdocTags": [
+        {
+          "name": "developerPreview",
+          "comment": "21.0"
+        }
+      ],
+      "rawComment": "/**\n * A widget within a toolbar.\n *\n * The `ngToolbarWidget` directive should be applied to any native HTML element that acts\n * as an interactive widget within an `ngToolbar` or `ngToolbarWidgetGroup`. It enables\n * keyboard navigation and selection within the toolbar.\n *\n * ```html\n * <button ngToolbarWidget value=\"action-id\" [disabled]=\"isDisabled\">\n *   Perform Action\n * </button>\n * ```\n *\n * @developerPreview 21.0\n */",
       "implements": [
         "OnInit",
         "OnDestroy"
@@ -377,8 +442,8 @@
       ],
       "source": {
         "filePath": "/src/aria/toolbar/toolbar.ts",
-        "startLine": 167,
-        "endLine": 220
+        "startLine": 181,
+        "endLine": 245
       }
     },
     {
@@ -387,13 +452,13 @@
       "entryType": "directive",
       "members": [
         {
-          "name": "id",
-          "type": "any",
+          "name": "element",
+          "type": "HTMLElement",
           "memberType": "property",
           "memberTags": [
             "readonly"
           ],
-          "description": "A unique identifier for the widget.",
+          "description": "A reference to the host element.",
           "jsdocTags": []
         },
         {
@@ -406,16 +471,6 @@
           "description": "The parent Toolbar UIPattern.",
           "jsdocTags": []
         },
-        {
-          "name": "element",
-          "type": "any",
-          "memberType": "property",
-          "memberTags": [
-            "readonly"
-          ],
-          "description": "A reference to the widget element to be focused on navigation.",
-          "jsdocTags": []
-        },
         {
           "name": "disabled",
           "type": "any",
@@ -430,80 +485,27 @@
           "isRequiredInput": false
         },
         {
-          "name": "controls",
-          "type": "any",
+          "name": "items",
+          "type": "() => any",
           "memberType": "property",
           "memberTags": [
             "readonly"
           ],
-          "description": "The controls that can be performed on the widget group.",
+          "description": "The list of toolbar items within the group.",
           "jsdocTags": []
         },
         {
-          "name": "ngOnInit",
-          "signatures": [
-            {
-              "name": "ngOnInit",
-              "entryType": "function",
-              "description": "",
-              "generics": [],
-              "isNewType": false,
-              "jsdocTags": [],
-              "params": [],
-              "rawComment": "",
-              "returnType": "void"
-            }
-          ],
-          "implementation": {
-            "params": [],
-            "isNewType": false,
-            "returnType": "void",
-            "generics": [],
-            "name": "ngOnInit",
-            "description": "",
-            "entryType": "function",
-            "jsdocTags": [],
-            "rawComment": ""
-          },
-          "entryType": "function",
-          "description": "",
-          "jsdocTags": [],
-          "rawComment": "",
-          "memberType": "method",
-          "memberTags": []
-        },
-        {
-          "name": "ngOnDestroy",
-          "signatures": [
-            {
-              "name": "ngOnDestroy",
-              "entryType": "function",
-              "description": "",
-              "generics": [],
-              "isNewType": false,
-              "jsdocTags": [],
-              "params": [],
-              "rawComment": "",
-              "returnType": "void"
-            }
+          "name": "multi",
+          "type": "any",
+          "memberType": "property",
+          "memberTags": [
+            "readonly",
+            "input"
           ],
-          "implementation": {
-            "params": [],
-            "isNewType": false,
-            "returnType": "void",
-            "generics": [],
-            "name": "ngOnDestroy",
-            "description": "",
-            "entryType": "function",
-            "jsdocTags": [],
-            "rawComment": ""
-          },
-          "entryType": "function",
-          "description": "",
+          "description": "Whether the group allows multiple widgets to be selected.",
           "jsdocTags": [],
-          "rawComment": "",
-          "memberType": "method",
-          "memberTags": []
+          "inputAlias": "multi",
+          "isRequiredInput": false
         }
       ],
       "generics": [
@@ -511,20 +513,24 @@
           "name": "V"
         }
       ],
-      "description": "A directive that groups toolbar widgets, used for more complex widgets like radio groups that\nhave their own internal navigation.",
-      "jsdocTags": [],
-      "rawComment": "/**\n * A directive that groups toolbar widgets, used for more complex widgets like radio groups that\n * have their own internal navigation.\n */",
-      "implements": [
-        "OnInit",
-        "OnDestroy"
+      "description": "A directive that groups toolbar widgets, used for more complex widgets like radio groups\nthat have their own internal navigation.",
+      "jsdocTags": [
+        {
+          "name": "developerPreview",
+          "comment": "21.0"
+        }
       ],
+      "rawComment": "/**\n * A directive that groups toolbar widgets, used for more complex widgets like radio groups\n * that have their own internal navigation.\n *\n * @developerPreview 21.0\n */",
+      "implements": [],
       "isStandalone": true,
-      "selector": "",
-      "exportAs": [],
+      "selector": "[ngToolbarWidgetGroup]",
+      "exportAs": [
+        "ngToolbarWidgetGroup"
+      ],
       "source": {
         "filePath": "/src/aria/toolbar/toolbar.ts",
-        "startLine": 226,
-        "endLine": 270
+        "startLine": 253,
+        "endLine": 284
       }
     }
   ],
@@ -562,15 +568,15 @@
       "@angular/core"
     ],
     [
-      "Signal",
+      "OnInit",
       "@angular/core"
     ],
     [
-      "OnInit",
+      "OnDestroy",
       "@angular/core"
     ],
     [
-      "OnDestroy",
+      "contentChildren",
       "@angular/core"
     ],
     [
@@ -586,7 +592,7 @@
       "@angular/aria/private"
     ],
     [
-      "ToolbarWidgetGroupControls",
+      "SignalLike",
       "@angular/aria/private"
     ],
     [
@@ -613,6 +619,10 @@
       "Toolbar",
       "@angular/aria/toolbar"
     ],
+    [
+      "Toolbar.element",
+      "@angular/aria/toolbar"
+    ],
     [
       "Toolbar.textDirection",
       "@angular/aria/toolbar"
@@ -626,7 +636,7 @@
       "@angular/aria/toolbar"
     ],
     [
-      "Toolbar.skipDisabled",
+      "Toolbar.softDisabled",
       "@angular/aria/toolbar"
     ],
     [
@@ -654,15 +664,15 @@
       "@angular/aria/toolbar"
     ],
     [
-      "ToolbarWidget.id",
+      "ToolbarWidget.element",
       "@angular/aria/toolbar"
     ],
     [
-      "ToolbarWidget.toolbar",
+      "ToolbarWidget.id",
       "@angular/aria/toolbar"
     ],
     [
-      "ToolbarWidget.element",
+      "ToolbarWidget.toolbar",
       "@angular/aria/toolbar"
     ],
     [
@@ -674,23 +684,31 @@
       "@angular/aria/toolbar"
     ],
     [
-      "ToolbarWidget.ngOnInit",
+      "ToolbarWidget.value",
       "@angular/aria/toolbar"
     ],
     [
-      "ToolbarWidget.ngOnDestroy",
+      "ToolbarWidget.active",
       "@angular/aria/toolbar"
     ],
     [
-      "ToolbarWidgetGroup",
+      "ToolbarWidget.selected",
       "@angular/aria/toolbar"
     ],
     [
-      "ToolbarWidgetGroup.id",
+      "ToolbarWidget.group",
       "@angular/aria/toolbar"
     ],
     [
-      "ToolbarWidgetGroup.toolbar",
+      "ToolbarWidget.ngOnInit",
+      "@angular/aria/toolbar"
+    ],
+    [
+      "ToolbarWidget.ngOnDestroy",
+      "@angular/aria/toolbar"
+    ],
+    [
+      "ToolbarWidgetGroup",
       "@angular/aria/toolbar"
     ],
     [
@@ -698,19 +716,19 @@
       "@angular/aria/toolbar"
     ],
     [
-      "ToolbarWidgetGroup.disabled",
+      "ToolbarWidgetGroup.toolbar",
       "@angular/aria/toolbar"
     ],
     [
-      "ToolbarWidgetGroup.controls",
+      "ToolbarWidgetGroup.disabled",
       "@angular/aria/toolbar"
     ],
     [
-      "ToolbarWidgetGroup.ngOnInit",
+      "ToolbarWidgetGroup.items",
       "@angular/aria/toolbar"
     ],
     [
-      "ToolbarWidgetGroup.ngOnDestroy",
+      "ToolbarWidgetGroup.multi",
       "@angular/aria/toolbar"
     ]
   ]