feat(aria/combobox): migrate simple-combobox directly into primary entrypoints (angular#33206)

* refactor(aria/combobox): deprecate and relocate legacy combobox entrypoints

Relocate the public `src/aria/combobox` entrypoint to `src/aria/deprecated/combobox` and the private implementation patterns to `src/aria/private/deprecated/combobox`. This frees up the primary `combobox` namespace for the upcoming standalone combobox widget migration.

- Add JSDoc `@deprecated` and `@breaking-change 22.0.0` markers to legacy classes and primitives.
- Adjust relative imports outwards to accommodate the deeper directory nesting levels.
- Re-wire build dependencies and entrypoint configurations across the framework package graph.
- Bulk update consumer example module targets and prune unused dependencies.

* refactor(aria/combobox): remove legacy combobox and autocomplete implementations

Deletes the deprecated legacy combobox and autocomplete codebases, including their core entrypoints, integration layers within listbox and tree components, examples, dev-app pages, and associated API goldens.

BREAKING CHANGE:
The legacy combobox and autocomplete implementations have been removed. Use the new standalone combobox instead.

* feat(aria/combobox): promote simple-combobox to stable un-prefixed combobox

- Relocates public, private, and example directories to clean `combobox` entry points.
- Renames internal layout symbols, selectors, and uppercase tokens (`SIMPLE_COMBOBOX_POPUP` -> `COMBOBOX_POPUP`).
- Establishes full documentation extraction parity with the `json_api` Bazel rule target.
- Standardizes the accompanying toolbar component showcase into the clean `aria-toolbar` path.
- Re-routes dev-app navigation links and migrates public API golden records.

BREAKING CHANGE:
`SimpleCombobox` has been promoted to `Combobox`. All `simple-combobox` prefixed symbols, selectors, and tokens have been renamed to use the `combobox` prefix.

* refactor(aria/combobox): relocate and restructure autocomplete and toolbar examples
Relocate the autocomplete examples to `src/components-examples/aria/autocomplete` and toolbar examples to `src/components-examples/aria/toolbar`.
- Restore naming continuity with the historical codebase by stripping redundant prefixes from example filenames and component selectors.
- Sync dev-app preview routing layout paths and strict Bazel target dependency links.

Author: tjshiu

goldens/aria/combobox/index.api.md

@@ -4,76 +4,74 @@
 
 ```ts
 
-import * as _angular_cdk_bidi from '@angular/cdk/bidi';
 import * as _angular_core from '@angular/core';
+import { ComboboxPattern } from '@angular/aria/private';
+import { ComboboxPopupPattern } from '@angular/aria/private';
+import { DeferredContentAware } from '@angular/aria/private';
+import * as i1 from '@angular/aria/private';
 import { OnDestroy } from '@angular/core';
+import { OnInit } from '@angular/core';
 
 // @public
-export class Combobox<V> {
+export class Combobox extends DeferredContentAware implements OnInit {
     constructor();
     readonly alwaysExpanded: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    close(): void;
     readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
     readonly element: HTMLElement;
-    readonly expanded: _angular_core.Signal<boolean>;
-    readonly filterMode: _angular_core.InputSignal<"manual" | "auto-select" | "highlight">;
-    readonly firstMatch: _angular_core.InputSignal<V | undefined>;
-    readonly inputElement: _angular_core.Signal<HTMLInputElement | undefined>;
-    open(): void;
-    readonly _pattern: ComboboxPattern<any, V>;
-    readonly popup: _angular_core.Signal<ComboboxPopup<V> | undefined>;
-    readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    protected readonly textDirection: _angular_core.Signal<_angular_cdk_bidi.Direction>;
+    readonly expanded: _angular_core.ModelSignal<boolean>;
+    readonly inlineSuggestion: _angular_core.InputSignal<string | undefined>;
     // (undocumented)
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Combobox<any>, "[ngCombobox]", ["ngCombobox"], { "filterMode": { "alias": "filterMode"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "firstMatch": { "alias": "firstMatch"; "required": false; "isSignal": true; }; "alwaysExpanded": { "alias": "alwaysExpanded"; "required": false; "isSignal": true; }; }, {}, ["popup"], never, true, [{ directive: typeof DeferredContentAware; inputs: { "preserveContent": "preserveContent"; }; outputs: {}; }]>;
+    ngOnInit(): void;
+    readonly _pattern: ComboboxPattern;
+    readonly _popup: _angular_core.WritableSignal<ComboboxPopup | undefined>;
+    _registerPopup(popup: ComboboxPopup): void;
+    readonly softDisabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly tabIndex: _angular_core.InputSignalWithTransform<number | undefined, string | number | undefined>;
+    _unregisterPopup(): void;
+    readonly value: _angular_core.ModelSignal<string>;
+    // (undocumented)
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Combobox, "[ngCombobox]", ["ngCombobox"], { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "softDisabled": { "alias": "softDisabled"; "required": false; "isSignal": true; }; "alwaysExpanded": { "alias": "alwaysExpanded"; "required": false; "isSignal": true; }; "tabIndex": { "alias": "tabindex"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "inlineSuggestion": { "alias": "inlineSuggestion"; "required": false; "isSignal": true; }; }, { "expanded": "expandedChange"; "value": "valueChange"; }, never, never, true, never>;
     // (undocumented)
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<Combobox<any>, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<Combobox, never>;
 }
 
 // @public
-export class ComboboxDialog {
-    constructor();
+export class ComboboxPopup implements OnInit, OnDestroy {
+    readonly activeDescendant: _angular_core.Signal<string | undefined>;
+    readonly combobox: _angular_core.InputSignal<Combobox>;
+    readonly controlTarget: _angular_core.Signal<HTMLElement | undefined>;
     // (undocumented)
-    close(): void;
-    readonly combobox: Combobox<any>;
-    readonly element: HTMLDialogElement;
-    readonly id: _angular_core.InputSignal<string>;
+    ngOnDestroy(): void;
     // (undocumented)
-    readonly _pattern: ComboboxDialogPattern;
+    ngOnInit(): void;
+    readonly _pattern: ComboboxPopupPattern;
+    readonly popupId: _angular_core.Signal<string | undefined>;
+    readonly popupType: _angular_core.InputSignal<"listbox" | "tree" | "grid" | "dialog">;
+    _registerWidget(widget: ComboboxWidget): void;
+    _unregisterWidget(): void;
+    readonly _widget: _angular_core.WritableSignal<ComboboxWidget | undefined>;
     // (undocumented)
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxDialog, "dialog[ngComboboxDialog]", ["ngComboboxDialog"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof ComboboxPopup; inputs: {}; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxPopup, "ng-template[ngComboboxPopup]", ["ngComboboxPopup"], { "combobox": { "alias": "combobox"; "required": true; "isSignal": true; }; "popupType": { "alias": "popupType"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.DeferredContent; inputs: {}; outputs: {}; }]>;
     // (undocumented)
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComboboxDialog, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComboboxPopup, never>;
 }
 
 // @public
-export class ComboboxInput {
+export class ComboboxWidget implements OnInit, OnDestroy {
     constructor();
-    readonly combobox: Combobox<any>;
+    readonly activeDescendant: _angular_core.InputSignal<string | undefined>;
     readonly element: HTMLElement;
-    readonly value: _angular_core.ModelSignal<string>;
-    // (undocumented)
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxInput, "input[ngComboboxInput]", ["ngComboboxInput"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
-    // (undocumented)
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComboboxInput, never>;
-}
-
-// @public
-export class ComboboxPopup<V> {
-    readonly combobox: Combobox<V> | null;
-    readonly _controls: _angular_core.WritableSignal<ComboboxListboxControls<any, V> | ComboboxTreeControls<any, V> | ComboboxDialogPattern | undefined>;
     // (undocumented)
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxPopup<any>, "[ngComboboxPopup]", ["ngComboboxPopup"], {}, {}, never, never, true, never>;
+    ngOnDestroy(): void;
     // (undocumented)
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComboboxPopup<any>, never>;
-}
-
-// @public
-export class ComboboxPopupContainer {
+    ngOnInit(): void;
+    onFocusin(): void;
+    onFocusout(event: FocusEvent): void;
+    readonly popupId: _angular_core.WritableSignal<string | undefined>;
     // (undocumented)
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxPopupContainer, "ng-template[ngComboboxPopupContainer]", ["ngComboboxPopupContainer"], {}, {}, never, never, true, [{ directive: typeof DeferredContent; inputs: {}; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ComboboxWidget, "[ngComboboxWidget]", ["ngComboboxWidget"], { "activeDescendant": { "alias": "activeDescendant"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
     // (undocumented)
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComboboxPopupContainer, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComboboxWidget, never>;
 }
 
 // (No @packageDocumentation comment for this package)

…ria/simple-combobox/testing/index.api.md …ldens/aria/combobox/testing/index.api.mdgoldens/aria/simple-combobox/testing/index.api.md renamed to goldens/aria/combobox/testing/index.api.md goldens/aria/simple-combobox/testing/index.api.md renamed to goldens/aria/combobox/testing/index.api.md

@@ -1,4 +1,4 @@
-## API Report File for "@angular/aria_simple-combobox_testing"
+## API Report File for "@angular/aria_combobox_testing"
 
 > Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
 

goldens/aria/listbox/index.api.md

@@ -36,7 +36,7 @@ export class Listbox<V> implements OnDestroy {
     readonly value: _angular_core.ModelSignal<V[]>;
     readonly wrap: _angular_core.InputSignalWithTransform<boolean, unknown>;
     // (undocumented)
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Listbox<any>, "[ngListbox]", ["ngListbox"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "multi": { "alias": "multi"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "softDisabled": { "alias": "softDisabled"; "required": false; "isSignal": true; }; "focusMode": { "alias": "focusMode"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "typeaheadDelay": { "alias": "typeaheadDelay"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "tabIndex": { "alias": "tabindex"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, [{ directive: typeof ComboboxPopup; inputs: {}; outputs: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<Listbox<any>, "[ngListbox]", ["ngListbox"], { "id": { "alias": "id"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "multi": { "alias": "multi"; "required": false; "isSignal": true; }; "wrap": { "alias": "wrap"; "required": false; "isSignal": true; }; "softDisabled": { "alias": "softDisabled"; "required": false; "isSignal": true; }; "focusMode": { "alias": "focusMode"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "typeaheadDelay": { "alias": "typeaheadDelay"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "tabIndex": { "alias": "tabindex"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
     // (undocumented)
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<Listbox<any>, never>;
 }