@angular/aria 21.0.0-rc.1 → 21.0.0-rc.3

package/_adev_assets/aria-toolbar.json

@@ -10,23 +10,23 @@
       "entryType": "directive",
       "members": [
         {
-          "name": "textDirection",
-          "type": "any",
+          "name": "element",
+          "type": "HTMLElement",
           "memberType": "property",
           "memberTags": [
             "readonly"
           ],
-          "description": "Text direction.",
+          "description": "A reference to the host element.",
           "jsdocTags": []
         },
         {
-          "name": "items",
+          "name": "textDirection",
           "type": "any",
           "memberType": "property",
           "memberTags": [
             "readonly"
           ],
-          "description": "Sorted UIPatterns of the child widgets",
+          "description": "Text direction.",
           "jsdocTags": []
         },
         {
@@ -49,7 +49,7 @@
           "memberTags": [
             "input"
           ],
-          "description": "Whether to allow disabled items to receive focus.",
+          "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": "softDisabled",
           "isRequiredInput": false
@@ -81,135 +81,19 @@
           "isRequiredInput": false
         },
         {
-          "name": "onFocus",
-          "signatures": [
-            {
-              "name": "onFocus",
-              "entryType": "function",
-              "description": "",
-              "generics": [],
-              "isNewType": false,
-              "jsdocTags": [],
-              "params": [],
-              "rawComment": "",
-              "returnType": "void"
-            }
-          ],
-          "implementation": {
-            "params": [],
-            "isNewType": false,
-            "returnType": "void",
-            "generics": [],
-            "name": "onFocus",
-            "description": "",
-            "entryType": "function",
-            "jsdocTags": [],
-            "rawComment": ""
-          },
-          "entryType": "function",
-          "description": "",
-          "jsdocTags": [],
-          "rawComment": "",
-          "memberType": "method",
-          "memberTags": []
-        },
-        {
-          "name": "register",
-          "signatures": [
-            {
-              "name": "register",
-              "entryType": "function",
-              "description": "",
-              "generics": [],
-              "isNewType": false,
-              "jsdocTags": [],
-              "params": [
-                {
-                  "name": "widget",
-                  "description": "",
-                  "type": "ToolbarWidget<V>",
-                  "isOptional": false,
-                  "isRestParam": false
-                }
-              ],
-              "rawComment": "",
-              "returnType": "void"
-            }
+          "name": "values",
+          "type": "any",
+          "memberType": "property",
+          "memberTags": [
+            "readonly",
+            "input",
+            "output"
           ],
-          "implementation": {
-            "params": [
-              {
-                "name": "widget",
-                "description": "",
-                "type": "ToolbarWidget<V>",
-                "isOptional": false,
-                "isRestParam": false
-              }
-            ],
-            "isNewType": false,
-            "returnType": "void",
-            "generics": [],
-            "name": "register",
-            "description": "",
-            "entryType": "function",
-            "jsdocTags": [],
-            "rawComment": ""
-          },
-          "entryType": "function",
-          "description": "",
+          "description": "The values of the selected widgets within the toolbar.",
           "jsdocTags": [],
-          "rawComment": "",
-          "memberType": "method",
-          "memberTags": []
-        },
-        {
-          "name": "unregister",
-          "signatures": [
-            {
-              "name": "unregister",
-              "entryType": "function",
-              "description": "",
-              "generics": [],
-              "isNewType": false,
-              "jsdocTags": [],
-              "params": [
-                {
-                  "name": "widget",
-                  "description": "",
-                  "type": "ToolbarWidget<V>",
-                  "isOptional": false,
-                  "isRestParam": false
-                }
-              ],
-              "rawComment": "",
-              "returnType": "void"
-            }
-          ],
-          "implementation": {
-            "params": [
-              {
-                "name": "widget",
-                "description": "",
-                "type": "ToolbarWidget<V>",
-                "isOptional": false,
-                "isRestParam": false
-              }
-            ],
-            "isNewType": false,
-            "returnType": "void",
-            "generics": [],
-            "name": "unregister",
-            "description": "",
-            "entryType": "function",
-            "jsdocTags": [],
-            "rawComment": ""
-          },
-          "entryType": "function",
-          "description": "",
-          "jsdocTags": [],
-          "rawComment": "",
-          "memberType": "method",
-          "memberTags": []
+          "inputAlias": "values",
+          "isRequiredInput": false,
+          "outputAlias": "valuesChange"
         }
       ],
       "generics": [
@@ -217,9 +101,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]",
@@ -228,8 +117,8 @@
       ],
       "source": {
         "filePath": "/src/aria/toolbar/toolbar.ts",
-        "startLine": 63,
-        "endLine": 158
+        "startLine": 65,
+        "endLine": 169
       }
     },
     {
@@ -238,37 +127,27 @@
       "entryType": "directive",
       "members": [
         {
-          "name": "id",
-          "type": "any",
-          "memberType": "property",
-          "memberTags": [
-            "readonly",
-            "input"
-          ],
-          "description": "A unique identifier for the widget.",
-          "jsdocTags": [],
-          "inputAlias": "id",
-          "isRequiredInput": false
-        },
-        {
-          "name": "toolbar",
-          "type": "any",
+          "name": "element",
+          "type": "HTMLElement",
           "memberType": "property",
           "memberTags": [
             "readonly"
           ],
-          "description": "The parent Toolbar UIPattern.",
+          "description": "A reference to the host element.",
           "jsdocTags": []
         },
         {
-          "name": "element",
+          "name": "id",
           "type": "any",
           "memberType": "property",
           "memberTags": [
-            "readonly"
+            "readonly",
+            "input"
           ],
-          "description": "A reference to the widget element to be focused on navigation.",
-          "jsdocTags": []
+          "description": "A unique identifier for the widget.",
+          "jsdocTags": [],
+          "inputAlias": "id",
+          "isRequiredInput": false
         },
         {
           "name": "disabled",
@@ -326,16 +205,6 @@
           "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": [
@@ -408,9 +277,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"
@@ -422,8 +296,8 @@
       ],
       "source": {
         "filePath": "/src/aria/toolbar/toolbar.ts",
-        "startLine": 166,
-        "endLine": 234
+        "startLine": 186,
+        "endLine": 253
       }
     },
     {
@@ -432,13 +306,13 @@
       "entryType": "directive",
       "members": [
         {
-          "name": "toolbar",
-          "type": "any",
+          "name": "element",
+          "type": "HTMLElement",
           "memberType": "property",
           "memberTags": [
             "readonly"
           ],
-          "description": "The parent Toolbar UIPattern.",
+          "description": "A reference to the host element.",
           "jsdocTags": []
         },
         {
@@ -454,16 +328,6 @@
           "inputAlias": "disabled",
           "isRequiredInput": false
         },
-        {
-          "name": "items",
-          "type": "() => any",
-          "memberType": "property",
-          "memberTags": [
-            "readonly"
-          ],
-          "description": "The list of toolbar items within the group.",
-          "jsdocTags": []
-        },
         {
           "name": "multi",
           "type": "any",
@@ -483,9 +347,14 @@
           "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 */",
+      "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": "[ngToolbarWidgetGroup]",
@@ -494,8 +363,8 @@
       ],
       "source": {
         "filePath": "/src/aria/toolbar/toolbar.ts",
-        "startLine": 240,
-        "endLine": 268
+        "startLine": 261,
+        "endLine": 296
       }
     }
   ],
@@ -532,10 +401,6 @@
       "signal",
       "@angular/core"
     ],
-    [
-      "Signal",
-      "@angular/core"
-    ],
     [
       "OnInit",
       "@angular/core"
@@ -548,6 +413,10 @@
       "contentChildren",
       "@angular/core"
     ],
+    [
+      "model",
+      "@angular/core"
+    ],
     [
       "ToolbarPattern",
       "@angular/aria/private"
@@ -589,11 +458,11 @@
       "@angular/aria/toolbar"
     ],
     [
-      "Toolbar.textDirection",
+      "Toolbar.element",
       "@angular/aria/toolbar"
     ],
     [
-      "Toolbar.items",
+      "Toolbar.textDirection",
       "@angular/aria/toolbar"
     ],
     [
@@ -613,15 +482,7 @@
       "@angular/aria/toolbar"
     ],
     [
-      "Toolbar.onFocus",
-      "@angular/aria/toolbar"
-    ],
-    [
-      "Toolbar.register",
-      "@angular/aria/toolbar"
-    ],
-    [
-      "Toolbar.unregister",
+      "Toolbar.values",
       "@angular/aria/toolbar"
     ],
     [
@@ -629,15 +490,11 @@
       "@angular/aria/toolbar"
     ],
     [
-      "ToolbarWidget.id",
-      "@angular/aria/toolbar"
-    ],
-    [
-      "ToolbarWidget.toolbar",
+      "ToolbarWidget.element",
       "@angular/aria/toolbar"
     ],
     [
-      "ToolbarWidget.element",
+      "ToolbarWidget.id",
       "@angular/aria/toolbar"
     ],
     [
@@ -660,10 +517,6 @@
       "ToolbarWidget.selected",
       "@angular/aria/toolbar"
     ],
-    [
-      "ToolbarWidget.group",
-      "@angular/aria/toolbar"
-    ],
     [
       "ToolbarWidget.ngOnInit",
       "@angular/aria/toolbar"
@@ -677,17 +530,13 @@
       "@angular/aria/toolbar"
     ],
     [
-      "ToolbarWidgetGroup.toolbar",
+      "ToolbarWidgetGroup.element",
       "@angular/aria/toolbar"
     ],
     [
       "ToolbarWidgetGroup.disabled",
       "@angular/aria/toolbar"
     ],
-    [
-      "ToolbarWidgetGroup.items",
-      "@angular/aria/toolbar"
-    ],
     [
       "ToolbarWidgetGroup.multi",
       "@angular/aria/toolbar"