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

package/_adev_assets/aria-listbox.json

@@ -14,11 +14,21 @@
           "type": "any",
           "memberType": "property",
           "memberTags": [
-            "protected"
+            "readonly"
           ],
           "description": "A unique identifier for the listbox.",
           "jsdocTags": []
         },
+        {
+          "name": "element",
+          "type": "HTMLElement",
+          "memberType": "property",
+          "memberTags": [
+            "readonly"
+          ],
+          "description": "A reference to the host element.",
+          "jsdocTags": []
+        },
         {
           "name": "textDirection",
           "type": "any",
@@ -68,7 +78,7 @@
           "type": "any",
           "memberType": "property",
           "memberTags": [],
-          "description": "Whether to allow disabled items in the list 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": []
         },
         {
@@ -76,7 +86,7 @@
           "type": "any",
           "memberType": "property",
           "memberTags": [],
-          "description": "The focus strategy used by the list.",
+          "description": "The focus strategy used by the list.\n- `roving`: Focus is moved to the active item using `tabindex`.\n- `activedescendant`: Focus remains on the listbox container, and `aria-activedescendant` is used to indicate the active item.",
           "jsdocTags": []
         },
         {
@@ -84,7 +94,7 @@
           "type": "any",
           "memberType": "property",
           "memberTags": [],
-          "description": "The selection strategy used by the list.",
+          "description": "The selection strategy used by the list.\n- `follow`: The focused item is automatically selected.\n- `explicit`: Items are selected explicitly by the user (e.g., via click or spacebar).",
           "jsdocTags": []
         },
         {
@@ -112,34 +122,50 @@
           "jsdocTags": []
         },
         {
-          "name": "value",
+          "name": "values",
           "type": "any",
           "memberType": "property",
           "memberTags": [],
-          "description": "The values of the current selected items.",
+          "description": "The values of the currently selected items.",
           "jsdocTags": []
         },
         {
-          "name": "onFocus",
+          "name": "scrollActiveItemIntoView",
           "signatures": [
             {
-              "name": "onFocus",
+              "name": "scrollActiveItemIntoView",
               "entryType": "function",
               "description": "",
               "generics": [],
               "isNewType": false,
               "jsdocTags": [],
-              "params": [],
+              "params": [
+                {
+                  "name": "options",
+                  "description": "",
+                  "type": "ScrollIntoViewOptions",
+                  "isOptional": true,
+                  "isRestParam": false
+                }
+              ],
               "rawComment": "",
               "returnType": "void"
             }
           ],
           "implementation": {
-            "params": [],
+            "params": [
+              {
+                "name": "options",
+                "description": "",
+                "type": "ScrollIntoViewOptions",
+                "isOptional": true,
+                "isRestParam": false
+              }
+            ],
             "isNewType": false,
             "returnType": "void",
             "generics": [],
-            "name": "onFocus",
+            "name": "scrollActiveItemIntoView",
             "description": "",
             "entryType": "function",
             "jsdocTags": [],
@@ -153,51 +179,35 @@
           "memberTags": []
         },
         {
-          "name": "scrollActiveItemIntoView",
+          "name": "gotoFirst",
           "signatures": [
             {
-              "name": "scrollActiveItemIntoView",
+              "name": "gotoFirst",
               "entryType": "function",
-              "description": "",
+              "description": "Navigates to the first item in the listbox.",
               "generics": [],
               "isNewType": false,
               "jsdocTags": [],
-              "params": [
-                {
-                  "name": "options",
-                  "description": "",
-                  "type": "ScrollIntoViewOptions",
-                  "isOptional": true,
-                  "isRestParam": false
-                }
-              ],
-              "rawComment": "",
+              "params": [],
+              "rawComment": "/** Navigates to the first item in the listbox. */",
               "returnType": "void"
             }
           ],
           "implementation": {
-            "params": [
-              {
-                "name": "options",
-                "description": "",
-                "type": "ScrollIntoViewOptions",
-                "isOptional": true,
-                "isRestParam": false
-              }
-            ],
+            "params": [],
             "isNewType": false,
             "returnType": "void",
             "generics": [],
-            "name": "scrollActiveItemIntoView",
-            "description": "",
+            "name": "gotoFirst",
+            "description": "Navigates to the first item in the listbox.",
             "entryType": "function",
             "jsdocTags": [],
-            "rawComment": ""
+            "rawComment": "/** Navigates to the first item in the listbox. */"
           },
           "entryType": "function",
-          "description": "",
+          "description": "Navigates to the first item in the listbox.",
           "jsdocTags": [],
-          "rawComment": "",
+          "rawComment": "/** Navigates to the first item in the listbox. */",
           "memberType": "method",
           "memberTags": []
         }
@@ -207,14 +217,23 @@
           "name": "V"
         }
       ],
-      "description": "A listbox container.\n\nListboxes are used to display a list of items for a user to select from. The Listbox is meant\nto be used in conjunction with Option as follows:\n\n```html\n<ul ngListbox>\n  <li [value]=\"1\" ngOption>Item 1</li>\n  <li [value]=\"2\" ngOption>Item 2</li>\n  <li [value]=\"3\" ngOption>Item 3</li>\n</ul>\n```",
-      "jsdocTags": [],
-      "rawComment": "/**\n * A listbox container.\n *\n * Listboxes are used to display a list of items for a user to select from. The Listbox is meant\n * to be used in conjunction with Option as follows:\n *\n * ```html\n * <ul ngListbox>\n *   <li [value]=\"1\" ngOption>Item 1</li>\n *   <li [value]=\"2\" ngOption>Item 2</li>\n *   <li [value]=\"3\" ngOption>Item 3</li>\n * </ul>\n * ```\n */",
+      "description": "Represents a container used to display a list of items for a user to select from.\n\nThe `ngListbox` is meant to be used in conjunction with `ngOption` directives to create a\nselectable list. It supports single and multiple selection modes, as well as various focus and\norientation strategies.\n\n```html\n<ul ngListbox [(value)]=\"selectedItems\" [multi]=\"true\" orientation=\"vertical\">",
+      "jsdocTags": [
+        {
+          "name": "for",
+          "comment": "(item of items; track item.id) {\n<li ngOption [value]=\"item.id\" [label]=\"item.name\" [disabled]=\"item.disabled\">\n{{item.name}}\n</li>\n}\n</ul>\n```"
+        },
+        {
+          "name": "developerPreview",
+          "comment": "21.0"
+        }
+      ],
+      "rawComment": "/**\n * Represents a container used to display a list of items for a user to select from.\n *\n * The `ngListbox` is meant to be used in conjunction with `ngOption` directives to create a\n * selectable list. It supports single and multiple selection modes, as well as various focus and\n * orientation strategies.\n *\n * ```html\n * <ul ngListbox [(value)]=\"selectedItems\" [multi]=\"true\" orientation=\"vertical\">\n *   @for (item of items; track item.id) {\n *     <li ngOption [value]=\"item.id\" [label]=\"item.name\" [disabled]=\"item.disabled\">\n *       {{item.name}}\n *     </li>\n *   }\n * </ul>\n * ```\n *\n * @developerPreview 21.0\n */",
       "implements": [],
       "source": {
         "filePath": "/src/aria/listbox/listbox.ts",
-        "startLine": 42,
-        "endLine": 190
+        "startLine": 47,
+        "endLine": 209
       }
     },
     {
@@ -223,43 +242,44 @@
       "entryType": "directive",
       "members": [
         {
-          "name": "id",
-          "type": "any",
+          "name": "element",
+          "type": "HTMLElement",
           "memberType": "property",
           "memberTags": [
-            "protected"
+            "readonly"
           ],
-          "description": "A unique identifier for the option.",
+          "description": "A reference to the host element.",
           "jsdocTags": []
         },
         {
-          "name": "searchTerm",
+          "name": "active",
           "type": "any",
           "memberType": "property",
-          "memberTags": [
-            "protected"
-          ],
-          "description": "The text used by the typeahead search.",
+          "memberTags": [],
+          "description": "Whether the option is currently active (focused).",
           "jsdocTags": []
         },
         {
-          "name": "listbox",
+          "name": "id",
           "type": "any",
           "memberType": "property",
           "memberTags": [
-            "protected"
+            "readonly",
+            "input"
           ],
-          "description": "The parent Listbox UIPattern.",
-          "jsdocTags": []
+          "description": "A unique identifier for the option.",
+          "jsdocTags": [],
+          "inputAlias": "id",
+          "isRequiredInput": false
         },
         {
-          "name": "element",
+          "name": "searchTerm",
           "type": "any",
           "memberType": "property",
           "memberTags": [
             "protected"
           ],
-          "description": "A reference to the option element to be focused on navigation.",
+          "description": "The text used by the typeahead search.",
           "jsdocTags": []
         },
         {
@@ -314,9 +334,14 @@
           "name": "V"
         }
       ],
-      "description": "A selectable option in a Listbox.",
-      "jsdocTags": [],
-      "rawComment": "/** A selectable option in a Listbox. */",
+      "description": "A selectable option in an `ngListbox`.\n\nThis directive should be applied to an element (e.g., `<li>`, `<div>`) within an\n`ngListbox`. The `value` input is used to identify the option, and the `label` input provides\nthe accessible name for the option.\n\n```html\n<li ngOption value=\"item-id\" label=\"Item Name\">\n  Item Name\n</li>\n```",
+      "jsdocTags": [
+        {
+          "name": "developerPreview",
+          "comment": "21.0"
+        }
+      ],
+      "rawComment": "/**\n * A selectable option in an `ngListbox`.\n *\n * This directive should be applied to an element (e.g., `<li>`, `<div>`) within an\n * `ngListbox`. The `value` input is used to identify the option, and the `label` input provides\n * the accessible name for the option.\n *\n * ```html\n * <li ngOption value=\"item-id\" label=\"Item Name\">\n *   Item Name\n * </li>\n * ```\n *\n * @developerPreview 21.0\n */",
       "implements": [],
       "isStandalone": true,
       "selector": "[ngOption]",
@@ -325,8 +350,8 @@
       ],
       "source": {
         "filePath": "/src/aria/listbox/listbox.ts",
-        "startLine": 193,
-        "endLine": 252
+        "startLine": 226,
+        "endLine": 283
       }
     }
   ],
@@ -415,6 +440,10 @@
       "Listbox.id",
       "@angular/aria/listbox"
     ],
+    [
+      "Listbox.element",
+      "@angular/aria/listbox"
+    ],
     [
       "Listbox.textDirection",
       "@angular/aria/listbox"
@@ -460,15 +489,15 @@
       "@angular/aria/listbox"
     ],
     [
-      "Listbox.value",
+      "Listbox.values",
       "@angular/aria/listbox"
     ],
     [
-      "Listbox.onFocus",
+      "Listbox.scrollActiveItemIntoView",
       "@angular/aria/listbox"
     ],
     [
-      "Listbox.scrollActiveItemIntoView",
+      "Listbox.gotoFirst",
       "@angular/aria/listbox"
     ],
     [
@@ -476,19 +505,19 @@
       "@angular/aria/listbox"
     ],
     [
-      "Option.id",
+      "Option.element",
       "@angular/aria/listbox"
     ],
     [
-      "Option.searchTerm",
+      "Option.active",
       "@angular/aria/listbox"
     ],
     [
-      "Option.listbox",
+      "Option.id",
       "@angular/aria/listbox"
     ],
     [
-      "Option.element",
+      "Option.searchTerm",
       "@angular/aria/listbox"
     ],
     [