@sapudex/web-components 2.51.0 → 2.52.0

package/dist/SelectBase.d.ts

@@ -120,6 +120,22 @@ declare class UDExSelectBase extends UDExSearchableListBase {
      * @private
      */
     _requestRender: boolean;
+    /**
+     * True while keyboard list navigation is active (aria-activedescendant set).
+     * Used in CSS to suppress the input focus ring and show the active item ring.
+     *
+     * @private
+     */
+    _navigating: boolean;
+    /**
+     * Text read by screen readers when the active item changes.
+     * Announced via an aria-live="assertive" region in the template.
+     * This works regardless of shadow DOM / popover teleportation because
+     * the live region lives inside SelectBox's own shadow root.
+     *
+     * @private
+     */
+    _liveRegionText: string;
     /**
      * Defines the footer content for the component dropdown.
      * Place any content (e.g. an action button) here. Clicking footer content does not close the dropdown —
@@ -144,14 +160,35 @@ declare class UDExSelectBase extends UDExSearchableListBase {
     _handleResizeBound: ResizeObserverCallback;
     _handleListKeyDownBound: (e: KeyboardEvent) => void;
     _listKeyDownListenerAdded: boolean;
+    _activeDescendantItem: UDExListItemBase | null;
     constructor();
     onEnterDOM(): void;
     onExitDOM(): void;
     onInvalidation({ name }: ChangeInfo): void;
     onAfterRendering(): void;
     _handleResize(): void;
+    /**
+     * Given a candidate index, skips over a non-interactive non-collapsible header if needed.
+     * Returns the effective target index.
+     */
+    _skipNonInteractive(items: UDExListItemBase[], raw: number, lastIndex: number, direction: "down" | "up"): number;
+    /**
+     * Sets or clears the aria-activedescendant on the combobox input and updates
+     * the aria-live region so JAWS/VoiceOver announce the item name and position.
+     * The live region is the primary announcement mechanism because aria-activedescendant
+     * across a UI5 Popover (which teleports content to document.body) is unreliable —
+     * screen readers cannot follow the ID reference across shadow root boundaries.
+     */
+    _setActiveDescendant(item: UDExListItemBase | null, scroll?: boolean): void;
+    /**
+     * Activates the first navigable item as the aria-activedescendant without moving DOM focus.
+     */
+    _activateFirstItem(): void;
+    /**
+     * Navigates to the item at the given index, updating aria-activedescendant and _selectedOption.
+     */
+    _navigateToIndex(items: UDExListItemBase[], nextIndex: number): void;
     handleKeyDownDropdown(e: KeyboardEvent): void;
-    handleListNavigationKeys(e: KeyboardEvent, items: UDExListItemBase[], effectiveTarget?: UDExListItemBase): void;
     handleEndKeyPress(items: UDExListItemBase[], lastItemIndex: number): void;
     handleHomeKeyPress(items: UDExListItemBase[]): void;
     handleDownKeyPress(items: UDExListItemBase[], currentSelectedIndex: number, lastItemIndex: number): void;
@@ -161,10 +198,24 @@ declare class UDExSelectBase extends UDExSearchableListBase {
     handleItemSelection(e: CustomEvent): void;
     onKeyDownSearch(e: KeyboardEvent): void;
     handleSearchChange(e: InputEvent): void;
+    onSearch(value: string): void;
     handleDirection(): void;
     handleDropdownBeforeClose(): void;
     dropdownBeforeOpen(): void;
     handleDropdownOpen(): void;
+    /**
+     * Announces the currently active descendant item (if set), or the first
+     * navigable item as a fallback. Used on open and after state changes.
+     */
+    _announceCurrentOrFirst(): void;
+    /**
+     * Returns the positional announcement text for an item, tree-aware when the
+     * list has groups. Matches the JAWS reading pattern of FilterMenu:
+     *   group header → "level 0, X of Y"  (Y = total navigable groups)
+     *   group child  → "level 1, X of Y"  (Y = siblings in that group)
+     *   flat item    → "X of Y"           (Y = total items, no level prefix)
+     */
+    _treePositionText(item: UDExListItemBase): string;
     fireEventDropdownBeforeOClose(): void;
     fireEventDropdownBeforeOpen(): void;
     fireEventDropdownOpen(): void;
@@ -200,6 +251,16 @@ declare class UDExSelectBase extends UDExSearchableListBase {
     _focusLastListItem(): void;
     _firstFocusableIn(el: Element | undefined): HTMLElement | null;
     _moveFocusAfterComponent(): void;
+    /**
+     * Builds the state portion of the live region announcement for a navigation item.
+     * Returns an array of state strings (e.g. ["collapsed", "Checked"]) to be joined
+     * with the label and position. Handles:
+     *   - collapsible group headers: expanded / collapsed
+     *   - MultiSelect: Checked / Unchecked / Indeterminate
+     *   - SingleSelect (tree): Selected / Unselected
+     *   - disabled: Disabled
+     */
+    _itemStateLabels(item: UDExListItemBase): string[];
     get ariaDescribedbyText(): string;
     get trigger(): HTMLElement;
     get isDisabled(): boolean;
@@ -212,6 +273,9 @@ declare class UDExSelectBase extends UDExSearchableListBase {
     };
     get popoverId(): string;
     get listboxRole(): AriaHasPopup;
+    get listAriaControlsId(): string;
+    get _activeDescendantMode(): boolean;
+    get isTreeStructure(): boolean;
     get hideDropdownSearch(): boolean;
     get showImageFlags(): boolean;
     get searchableList(): object;