@angular/aria 21.0.2 → 21.0.4

package/_adev_assets/aria-combobox.json

@@ -1,603 +0,0 @@
-{
-  "repo": "angular/components",
-  "moduleLabel": "@angular/aria/combobox",
-  "moduleName": "@angular/aria/combobox",
-  "normalizedModuleName": "angular_aria_combobox",
-  "entries": [
-    {
-      "name": "Combobox",
-      "isAbstract": false,
-      "entryType": "undecorated_class",
-      "members": [
-        {
-          "name": "textDirection",
-          "type": "any",
-          "memberType": "property",
-          "memberTags": [
-            "protected"
-          ],
-          "description": "A signal wrapper for directionality.",
-          "jsdocTags": []
-        },
-        {
-          "name": "element",
-          "type": "HTMLElement",
-          "memberType": "property",
-          "memberTags": [
-            "readonly"
-          ],
-          "description": "A reference to the combobox element.",
-          "jsdocTags": []
-        },
-        {
-          "name": "popup",
-          "type": "any",
-          "memberType": "property",
-          "memberTags": [
-            "readonly"
-          ],
-          "description": "The combobox popup.",
-          "jsdocTags": []
-        },
-        {
-          "name": "filterMode",
-          "type": "any",
-          "memberType": "property",
-          "memberTags": [],
-          "description": "The filter mode for the combobox.\n- `manual`: The consumer is responsible for filtering the options.\n- `auto-select`: The combobox automatically selects the first matching option.\n- `highlight`: The combobox highlights matching text in the options without changing selection.",
-          "jsdocTags": []
-        },
-        {
-          "name": "disabled",
-          "type": "any",
-          "memberType": "property",
-          "memberTags": [
-            "readonly"
-          ],
-          "description": "Whether the combobox is disabled.",
-          "jsdocTags": []
-        },
-        {
-          "name": "readonly",
-          "type": "any",
-          "memberType": "property",
-          "memberTags": [
-            "readonly"
-          ],
-          "description": "Whether the combobox is read-only.",
-          "jsdocTags": []
-        },
-        {
-          "name": "firstMatch",
-          "type": "any",
-          "memberType": "property",
-          "memberTags": [
-            "readonly"
-          ],
-          "description": "The value of the first matching item in the popup.",
-          "jsdocTags": []
-        },
-        {
-          "name": "expanded",
-          "type": "any",
-          "memberType": "property",
-          "memberTags": [
-            "readonly"
-          ],
-          "description": "Whether the combobox is expanded.",
-          "jsdocTags": []
-        },
-        {
-          "name": "alwaysExpanded",
-          "type": "any",
-          "memberType": "property",
-          "memberTags": [
-            "readonly"
-          ],
-          "description": "Whether the combobox popup should always be expanded, regardless of user interaction.",
-          "jsdocTags": []
-        },
-        {
-          "name": "inputElement",
-          "type": "any",
-          "memberType": "property",
-          "memberTags": [
-            "readonly"
-          ],
-          "description": "Input element connected to the combobox, if any.",
-          "jsdocTags": []
-        },
-        {
-          "name": "open",
-          "signatures": [
-            {
-              "name": "open",
-              "entryType": "function",
-              "description": "Opens the combobox to the selected item.",
-              "generics": [],
-              "isNewType": false,
-              "jsdocTags": [],
-              "params": [],
-              "rawComment": "/** Opens the combobox to the selected item. */",
-              "returnType": "void"
-            }
-          ],
-          "implementation": {
-            "params": [],
-            "isNewType": false,
-            "returnType": "void",
-            "generics": [],
-            "name": "open",
-            "description": "Opens the combobox to the selected item.",
-            "entryType": "function",
-            "jsdocTags": [],
-            "rawComment": "/** Opens the combobox to the selected item. */"
-          },
-          "entryType": "function",
-          "description": "Opens the combobox to the selected item.",
-          "jsdocTags": [],
-          "rawComment": "/** Opens the combobox to the selected item. */",
-          "memberType": "method",
-          "memberTags": []
-        },
-        {
-          "name": "close",
-          "signatures": [
-            {
-              "name": "close",
-              "entryType": "function",
-              "description": "Closes the combobox.",
-              "generics": [],
-              "isNewType": false,
-              "jsdocTags": [],
-              "params": [],
-              "rawComment": "/** Closes the combobox. */",
-              "returnType": "void"
-            }
-          ],
-          "implementation": {
-            "params": [],
-            "isNewType": false,
-            "returnType": "void",
-            "generics": [],
-            "name": "close",
-            "description": "Closes the combobox.",
-            "entryType": "function",
-            "jsdocTags": [],
-            "rawComment": "/** Closes the combobox. */"
-          },
-          "entryType": "function",
-          "description": "Closes the combobox.",
-          "jsdocTags": [],
-          "rawComment": "/** Closes the combobox. */",
-          "memberType": "method",
-          "memberTags": []
-        }
-      ],
-      "generics": [
-        {
-          "name": "V"
-        }
-      ],
-      "description": "The container element that wraps a combobox input and popup, and orchestrates its behavior.\n\nThe `ngCombobox` directive is the main entry point for creating a combobox and customizing its\nbehavior. It coordinates the interactions between the `ngComboboxInput` and the popup, which\nis defined by a `ng-template` with the `ngComboboxPopupContainer` directive. If using the\n`CdkOverlay`, the `cdkConnectedOverlay` directive takes the place of `ngComboboxPopupContainer`.\n\n```html\n<div ngCombobox filterMode=\"highlight\">\n  <input\n    ngComboboxInput\n    placeholder=\"Search for a state...\"\n    [(value)]=\"searchString\"\n  />\n\n  <ng-template ngComboboxPopupContainer>\n    <div ngListbox [(value)]=\"selectedValue\">\n      @for (option of filteredOptions(); track option) {\n        <div ngOption [value]=\"option\" [label]=\"option\">\n          <span>{{option}}</span>\n        </div>\n      }\n    </div>\n  </ng-template>\n</div>\n```",
-      "jsdocTags": [
-        {
-          "name": "developerPreview",
-          "comment": "21.0"
-        }
-      ],
-      "rawComment": "/**\n * The container element that wraps a combobox input and popup, and orchestrates its behavior.\n *\n * The `ngCombobox` directive is the main entry point for creating a combobox and customizing its\n * behavior. It coordinates the interactions between the `ngComboboxInput` and the popup, which\n * is defined by a `ng-template` with the `ngComboboxPopupContainer` directive. If using the\n * `CdkOverlay`, the `cdkConnectedOverlay` directive takes the place of `ngComboboxPopupContainer`.\n *\n * ```html\n * <div ngCombobox filterMode=\"highlight\">\n *   <input\n *     ngComboboxInput\n *     placeholder=\"Search for a state...\"\n *     [(value)]=\"searchString\"\n *   />\n *\n *   <ng-template ngComboboxPopupContainer>\n *     <div ngListbox [(value)]=\"selectedValue\">\n *       @for (option of filteredOptions(); track option) {\n *         <div ngOption [value]=\"option\" [label]=\"option\">\n *           <span>{{option}}</span>\n *         </div>\n *       }\n *     </div>\n *   </ng-template>\n * </div>\n * ```\n *\n * @developerPreview 21.0\n */",
-      "implements": [],
-      "source": {
-        "filePath": "src/aria/combobox/combobox.ts",
-        "startLine": 65,
-        "endLine": 176
-      }
-    },
-    {
-      "name": "ComboboxInput",
-      "isAbstract": false,
-      "entryType": "directive",
-      "members": [
-        {
-          "name": "element",
-          "type": "HTMLElement",
-          "memberType": "property",
-          "memberTags": [
-            "readonly"
-          ],
-          "description": "A reference to the input element.",
-          "jsdocTags": []
-        },
-        {
-          "name": "combobox",
-          "type": "any",
-          "memberType": "property",
-          "memberTags": [
-            "readonly"
-          ],
-          "description": "The combobox that the input belongs to.",
-          "jsdocTags": []
-        },
-        {
-          "name": "value",
-          "type": "any",
-          "memberType": "property",
-          "memberTags": [
-            "input",
-            "output"
-          ],
-          "description": "The value of the input.",
-          "jsdocTags": [],
-          "inputAlias": "value",
-          "isRequiredInput": false,
-          "outputAlias": "valueChange"
-        }
-      ],
-      "generics": [],
-      "description": "An input that is part of a combobox. It is responsible for displaying the\ncurrent value and handling user input for filtering and selection.\n\nThis directive should be applied to an `<input>` element within an `ngCombobox`\ncontainer. It automatically handles keyboard interactions, such as opening the\npopup and navigating through the options.\n\n```html\n<input\n  ngComboboxInput\n  placeholder=\"Search...\"\n  [(value)]=\"searchString\"\n/>\n```",
-      "jsdocTags": [
-        {
-          "name": "developerPreview",
-          "comment": "21.0"
-        }
-      ],
-      "rawComment": "/**\n * An input that is part of a combobox. It is responsible for displaying the\n * current value and handling user input for filtering and selection.\n *\n * This directive should be applied to an `<input>` element within an `ngCombobox`\n * container. It automatically handles keyboard interactions, such as opening the\n * popup and navigating through the options.\n *\n * ```html\n * <input\n *   ngComboboxInput\n *   placeholder=\"Search...\"\n *   [(value)]=\"searchString\"\n * />\n * ```\n *\n * @developerPreview 21.0\n */",
-      "implements": [],
-      "isStandalone": true,
-      "selector": "input[ngComboboxInput]",
-      "exportAs": [
-        "ngComboboxInput"
-      ],
-      "source": {
-        "filePath": "src/aria/combobox/combobox.ts",
-        "startLine": 196,
-        "endLine": 242
-      }
-    },
-    {
-      "name": "ComboboxPopupContainer",
-      "isAbstract": false,
-      "entryType": "undecorated_class",
-      "members": [],
-      "generics": [],
-      "description": "A structural directive that marks the `ng-template` to be used as the popup\nfor a combobox. This content is conditionally rendered.\n\nThe content of the popup can be a `ngListbox`, `ngTree`, or `role=\"dialog\"`, allowing for\nflexible and complex combobox implementations. The consumer is responsible for\nimplementing the filtering logic based on the `ngComboboxInput`'s value.\n\n```html\n<ng-template ngComboboxPopupContainer>\n  <div ngListbox [(value)]=\"selectedValue\">\n    <!-- ... options ... -->\n  </div>\n</ng-template>\n```\n\nWhen using CdkOverlay, this directive can be replaced by `cdkConnectedOverlay`.\n\n```html\n<ng-template\n    [cdkConnectedOverlay]=\"{origin: inputElement, usePopover: 'inline' matchWidth: true}\"\n    [cdkConnectedOverlayOpen]=\"combobox.expanded()\">\n  <div ngListbox [(value)]=\"selectedValue\">\n    <!-- ... options ... -->\n  </div>\n</ng-template>\n```",
-      "jsdocTags": [
-        {
-          "name": "developerPreview",
-          "comment": "21.0"
-        }
-      ],
-      "rawComment": "/**\n * A structural directive that marks the `ng-template` to be used as the popup\n * for a combobox. This content is conditionally rendered.\n *\n * The content of the popup can be a `ngListbox`, `ngTree`, or `role=\"dialog\"`, allowing for\n * flexible and complex combobox implementations. The consumer is responsible for\n * implementing the filtering logic based on the `ngComboboxInput`'s value.\n *\n * ```html\n * <ng-template ngComboboxPopupContainer>\n *   <div ngListbox [(value)]=\"selectedValue\">\n *     <!-- ... options ... -->\n *   </div>\n * </ng-template>\n * ```\n *\n * When using CdkOverlay, this directive can be replaced by `cdkConnectedOverlay`.\n *\n * ```html\n * <ng-template\n *     [cdkConnectedOverlay]=\"{origin: inputElement, usePopover: 'inline' matchWidth: true}\"\n *     [cdkConnectedOverlayOpen]=\"combobox.expanded()\">\n *   <div ngListbox [(value)]=\"selectedValue\">\n *     <!-- ... options ... -->\n *   </div>\n * </ng-template>\n * ```\n *\n * @developerPreview 21.0\n */",
-      "implements": [],
-      "source": {
-        "filePath": "src/aria/combobox/combobox.ts",
-        "startLine": 274,
-        "endLine": 279
-      }
-    },
-    {
-      "name": "ComboboxPopup",
-      "isAbstract": false,
-      "entryType": "directive",
-      "members": [
-        {
-          "name": "combobox",
-          "type": "any",
-          "memberType": "property",
-          "memberTags": [
-            "readonly"
-          ],
-          "description": "The combobox that the popup belongs to.",
-          "jsdocTags": []
-        }
-      ],
-      "generics": [
-        {
-          "name": "V"
-        }
-      ],
-      "description": "Identifies an element as a popup for an `ngCombobox`.\n\nThis directive acts as a bridge, allowing the `ngCombobox` to discover and interact\nwith the underlying control (e.g., `ngListbox`, `ngTree`, or `ngComboboxDialog`) that\nmanages the options. It's primarily used as a host directive and is responsible for\nexposing the popup's control pattern to the parent combobox.",
-      "jsdocTags": [
-        {
-          "name": "developerPreview",
-          "comment": "21.0"
-        }
-      ],
-      "rawComment": "/**\n * Identifies an element as a popup for an `ngCombobox`.\n *\n * This directive acts as a bridge, allowing the `ngCombobox` to discover and interact\n * with the underlying control (e.g., `ngListbox`, `ngTree`, or `ngComboboxDialog`) that\n * manages the options. It's primarily used as a host directive and is responsible for\n * exposing the popup's control pattern to the parent combobox.\n *\n * @developerPreview 21.0\n */",
-      "implements": [],
-      "isStandalone": true,
-      "selector": "[ngComboboxPopup]",
-      "exportAs": [
-        "ngComboboxPopup"
-      ],
-      "source": {
-        "filePath": "src/aria/combobox/combobox.ts",
-        "startLine": 291,
-        "endLine": 306
-      }
-    },
-    {
-      "name": "ComboboxDialog",
-      "isAbstract": false,
-      "entryType": "directive",
-      "members": [
-        {
-          "name": "element",
-          "type": "HTMLElement",
-          "memberType": "property",
-          "memberTags": [
-            "readonly"
-          ],
-          "description": "A reference to the dialog element.",
-          "jsdocTags": []
-        },
-        {
-          "name": "combobox",
-          "type": "any",
-          "memberType": "property",
-          "memberTags": [
-            "readonly"
-          ],
-          "description": "The combobox that the dialog belongs to.",
-          "jsdocTags": []
-        },
-        {
-          "name": "close",
-          "signatures": [
-            {
-              "name": "close",
-              "entryType": "function",
-              "description": "",
-              "generics": [],
-              "isNewType": false,
-              "jsdocTags": [],
-              "params": [],
-              "rawComment": "",
-              "returnType": "void"
-            }
-          ],
-          "implementation": {
-            "params": [],
-            "isNewType": false,
-            "returnType": "void",
-            "generics": [],
-            "name": "close",
-            "description": "",
-            "entryType": "function",
-            "jsdocTags": [],
-            "rawComment": ""
-          },
-          "entryType": "function",
-          "description": "",
-          "jsdocTags": [],
-          "rawComment": "",
-          "memberType": "method",
-          "memberTags": []
-        }
-      ],
-      "generics": [],
-      "description": "Integrates a native `<dialog>` element with the combobox, allowing for\na modal or non-modal popup experience. It handles the opening and closing of the dialog\nbased on the combobox's expanded state.\n\n```html\n<ng-template ngComboboxPopupContainer>\n  <dialog ngComboboxDialog class=\"example-dialog\">\n    <!-- ... dialog content ... -->\n  </dialog>\n</ng-template>\n```",
-      "jsdocTags": [
-        {
-          "name": "developerPreview",
-          "comment": "21.0"
-        }
-      ],
-      "rawComment": "/**\n * Integrates a native `<dialog>` element with the combobox, allowing for\n * a modal or non-modal popup experience. It handles the opening and closing of the dialog\n * based on the combobox's expanded state.\n *\n * ```html\n * <ng-template ngComboboxPopupContainer>\n *   <dialog ngComboboxDialog class=\"example-dialog\">\n *     <!-- ... dialog content ... -->\n *   </dialog>\n * </ng-template>\n * ```\n *\n * @developerPreview 21.0\n */",
-      "implements": [],
-      "isStandalone": true,
-      "selector": "dialog[ngComboboxDialog]",
-      "exportAs": [
-        "ngComboboxDialog"
-      ],
-      "source": {
-        "filePath": "src/aria/combobox/combobox.ts",
-        "startLine": 323,
-        "endLine": 373
-      }
-    }
-  ],
-  "symbols": [
-    [
-      "afterRenderEffect",
-      "@angular/core"
-    ],
-    [
-      "booleanAttribute",
-      "@angular/core"
-    ],
-    [
-      "computed",
-      "@angular/core"
-    ],
-    [
-      "contentChild",
-      "@angular/core"
-    ],
-    [
-      "Directive",
-      "@angular/core"
-    ],
-    [
-      "ElementRef",
-      "@angular/core"
-    ],
-    [
-      "forwardRef",
-      "@angular/core"
-    ],
-    [
-      "inject",
-      "@angular/core"
-    ],
-    [
-      "input",
-      "@angular/core"
-    ],
-    [
-      "model",
-      "@angular/core"
-    ],
-    [
-      "signal",
-      "@angular/core"
-    ],
-    [
-      "untracked",
-      "@angular/core"
-    ],
-    [
-      "WritableSignal",
-      "@angular/core"
-    ],
-    [
-      "DeferredContent",
-      "@angular/aria/private"
-    ],
-    [
-      "DeferredContentAware",
-      "@angular/aria/private"
-    ],
-    [
-      "ComboboxPattern",
-      "@angular/aria/private"
-    ],
-    [
-      "ComboboxListboxControls",
-      "@angular/aria/private"
-    ],
-    [
-      "ComboboxTreeControls",
-      "@angular/aria/private"
-    ],
-    [
-      "ComboboxDialogPattern",
-      "@angular/aria/private"
-    ],
-    [
-      "Directionality",
-      "@angular/cdk/bidi"
-    ],
-    [
-      "toSignal",
-      "@angular/core/rxjs-interop"
-    ],
-    [
-      "Combobox",
-      "@angular/aria/combobox"
-    ],
-    [
-      "ComboboxInput",
-      "@angular/aria/combobox"
-    ],
-    [
-      "ComboboxPopupContainer",
-      "@angular/aria/combobox"
-    ],
-    [
-      "ComboboxPopup",
-      "@angular/aria/combobox"
-    ],
-    [
-      "ComboboxDialog",
-      "@angular/aria/combobox"
-    ],
-    [
-      "Combobox",
-      "@angular/aria/combobox"
-    ],
-    [
-      "Combobox.textDirection",
-      "@angular/aria/combobox"
-    ],
-    [
-      "Combobox.element",
-      "@angular/aria/combobox"
-    ],
-    [
-      "Combobox.popup",
-      "@angular/aria/combobox"
-    ],
-    [
-      "Combobox.filterMode",
-      "@angular/aria/combobox"
-    ],
-    [
-      "Combobox.disabled",
-      "@angular/aria/combobox"
-    ],
-    [
-      "Combobox.readonly",
-      "@angular/aria/combobox"
-    ],
-    [
-      "Combobox.firstMatch",
-      "@angular/aria/combobox"
-    ],
-    [
-      "Combobox.expanded",
-      "@angular/aria/combobox"
-    ],
-    [
-      "Combobox.alwaysExpanded",
-      "@angular/aria/combobox"
-    ],
-    [
-      "Combobox.inputElement",
-      "@angular/aria/combobox"
-    ],
-    [
-      "Combobox.open",
-      "@angular/aria/combobox"
-    ],
-    [
-      "Combobox.close",
-      "@angular/aria/combobox"
-    ],
-    [
-      "ComboboxInput",
-      "@angular/aria/combobox"
-    ],
-    [
-      "ComboboxInput.element",
-      "@angular/aria/combobox"
-    ],
-    [
-      "ComboboxInput.combobox",
-      "@angular/aria/combobox"
-    ],
-    [
-      "ComboboxInput.value",
-      "@angular/aria/combobox"
-    ],
-    [
-      "ComboboxPopupContainer",
-      "@angular/aria/combobox"
-    ],
-    [
-      "ComboboxPopup",
-      "@angular/aria/combobox"
-    ],
-    [
-      "ComboboxPopup.combobox",
-      "@angular/aria/combobox"
-    ],
-    [
-      "ComboboxDialog",
-      "@angular/aria/combobox"
-    ],
-    [
-      "ComboboxDialog.element",
-      "@angular/aria/combobox"
-    ],
-    [
-      "ComboboxDialog.combobox",
-      "@angular/aria/combobox"
-    ],
-    [
-      "ComboboxDialog.close",
-      "@angular/aria/combobox"
-    ]
-  ]
-}