@angular/cdk 19.0.0-next.1 → 19.0.0-next.2

package/a11y/index.d.ts

@@ -1279,7 +1279,7 @@ export declare class TreeKeyManager<T extends TreeKeyManagerItem> implements Tre
     private _typeahead?;
     private _typeaheadSubscription;
     private _hasInitialFocused;
-    private _initialFocus;
+    private _initializeFocus;
     /**
      *
      * @param items List of TreeKeyManager options. Can be synchronous or asynchronous.
@@ -1371,6 +1371,10 @@ export declare interface TreeKeyManagerItem {
      * Unfocus the item. This should remove the focus state.
      */
     unfocus(): void;
+    /**
+     * Sets the item to be focusable without actually focusing it.
+     */
+    makeFocusable?(): void;
 }
 
 /**

package/fesm2022/a11y.mjs

@@ -737,21 +737,31 @@ class FocusKeyManager extends ListKeyManager {
  * keyboard events occur.
  */
 class TreeKeyManager {
-    _initialFocus() {
-        if (this._hasInitialFocused) {
+    _initializeFocus() {
+        if (this._hasInitialFocused || this._items.length === 0) {
             return;
         }
-        if (!this._items.length) {
-            return;
-        }
-        let focusIndex = 0;
+        let activeIndex = 0;
         for (let i = 0; i < this._items.length; i++) {
             if (!this._skipPredicateFn(this._items[i]) && !this._isItemDisabled(this._items[i])) {
-                focusIndex = i;
+                activeIndex = i;
                 break;
             }
         }
-        this.focusItem(focusIndex);
+        const activeItem = this._items[activeIndex];
+        // Use `makeFocusable` here, because we want the item to just be focusable, not actually
+        // capture the focus since the user isn't interacting with it. See #29628.
+        if (activeItem.makeFocusable) {
+            this._activeItem?.unfocus();
+            this._activeItemIndex = activeIndex;
+            this._activeItem = activeItem;
+            this._typeahead?.setCurrentSelectedItemIndex(activeIndex);
+            activeItem.makeFocusable();
+        }
+        else {
+            // Backwards compatibility for items that don't implement `makeFocusable`.
+            this.focusItem(activeIndex);
+        }
         this._hasInitialFocused = true;
     }
     /**
@@ -800,7 +810,7 @@ class TreeKeyManager {
                 this._items = newItems.toArray();
                 this._typeahead?.setItems(this._items);
                 this._updateActiveItemIndex(this._items);
-                this._initialFocus();
+                this._initializeFocus();
             });
         }
         else if (isObservable(items)) {
@@ -808,12 +818,12 @@ class TreeKeyManager {
                 this._items = newItems;
                 this._typeahead?.setItems(newItems);
                 this._updateActiveItemIndex(newItems);
-                this._initialFocus();
+                this._initializeFocus();
             });
         }
         else {
             this._items = items;
-            this._initialFocus();
+            this._initializeFocus();
         }
         if (typeof config.shouldActivationFollowFocus === 'boolean') {
             this._shouldActivationFollowFocus = config.shouldActivationFollowFocus;