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

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",
@@ -64,11 +74,11 @@
           "jsdocTags": []
         },
         {
-          "name": "skipDisabled",
+          "name": "softDisabled",
           "type": "any",
           "memberType": "property",
           "memberTags": [],
-          "description": "Whether disabled items in the list 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": []
         },
         {
@@ -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,11 +122,11 @@
           "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": []
         },
         {
@@ -200,6 +210,39 @@
           "rawComment": "",
           "memberType": "method",
           "memberTags": []
+        },
+        {
+          "name": "gotoFirst",
+          "signatures": [
+            {
+              "name": "gotoFirst",
+              "entryType": "function",
+              "description": "Navigates to the first item in the listbox.",
+              "generics": [],
+              "isNewType": false,
+              "jsdocTags": [],
+              "params": [],
+              "rawComment": "/** Navigates to the first item in the listbox. */",
+              "returnType": "void"
+            }
+          ],
+          "implementation": {
+            "params": [],
+            "isNewType": false,
+            "returnType": "void",
+            "generics": [],
+            "name": "gotoFirst",
+            "description": "Navigates to the first item in the listbox.",
+            "entryType": "function",
+            "jsdocTags": [],
+            "rawComment": "/** Navigates to the first item in the listbox. */"
+          },
+          "entryType": "function",
+          "description": "Navigates to the first item in the listbox.",
+          "jsdocTags": [],
+          "rawComment": "/** Navigates to the first item in the listbox. */",
+          "memberType": "method",
+          "memberTags": []
         }
       ],
       "generics": [
@@ -207,14 +250,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 +275,54 @@
       "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": [],
+          "description": "Whether the option is currently active (focused).",
+          "jsdocTags": []
+        },
+        {
+          "name": "id",
           "type": "any",
           "memberType": "property",
           "memberTags": [
-            "protected"
+            "readonly",
+            "input"
           ],
-          "description": "The text used by the typeahead search.",
-          "jsdocTags": []
+          "description": "A unique identifier for the option.",
+          "jsdocTags": [],
+          "inputAlias": "id",
+          "isRequiredInput": false
         },
         {
-          "name": "listbox",
+          "name": "searchTerm",
           "type": "any",
           "memberType": "property",
           "memberTags": [
             "protected"
           ],
-          "description": "The parent Listbox UIPattern.",
+          "description": "The text used by the typeahead search.",
           "jsdocTags": []
         },
         {
-          "name": "element",
+          "name": "listbox",
           "type": "any",
           "memberType": "property",
           "memberTags": [
             "protected"
           ],
-          "description": "A reference to the option element to be focused on navigation.",
+          "description": "The parent Listbox UIPattern.",
           "jsdocTags": []
         },
         {
@@ -314,9 +377,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 +393,8 @@
       ],
       "source": {
         "filePath": "/src/aria/listbox/listbox.ts",
-        "startLine": 193,
-        "endLine": 252
+        "startLine": 226,
+        "endLine": 283
       }
     }
   ],
@@ -415,6 +483,10 @@
       "Listbox.id",
       "@angular/aria/listbox"
     ],
+    [
+      "Listbox.element",
+      "@angular/aria/listbox"
+    ],
     [
       "Listbox.textDirection",
       "@angular/aria/listbox"
@@ -436,7 +508,7 @@
       "@angular/aria/listbox"
     ],
     [
-      "Listbox.skipDisabled",
+      "Listbox.softDisabled",
       "@angular/aria/listbox"
     ],
     [
@@ -460,7 +532,7 @@
       "@angular/aria/listbox"
     ],
     [
-      "Listbox.value",
+      "Listbox.values",
       "@angular/aria/listbox"
     ],
     [
@@ -471,24 +543,32 @@
       "Listbox.scrollActiveItemIntoView",
       "@angular/aria/listbox"
     ],
+    [
+      "Listbox.gotoFirst",
+      "@angular/aria/listbox"
+    ],
     [
       "Option",
       "@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"
+    ],
+    [
+      "Option.listbox",
       "@angular/aria/listbox"
     ],
     [