@angular/cdk 20.0.0-next.0 → 20.0.0-next.2

package/keycodes/index.d.ts

@@ -1,249 +1,128 @@
-export declare const A = 65;
-
-export declare const ALT = 18;
-
-export declare const APOSTROPHE = 192;
-
-export declare const AT_SIGN = 64;
-
-export declare const B = 66;
-
-export declare const BACKSLASH = 220;
-
-export declare const BACKSPACE = 8;
-
-export declare const C = 67;
-
-export declare const CAPS_LOCK = 20;
-
-export declare const CLOSE_SQUARE_BRACKET = 221;
-
-export declare const COMMA = 188;
-
-export declare const CONTEXT_MENU = 93;
-
-export declare const CONTROL = 17;
-
-export declare const D = 68;
-
-export declare const DASH = 189;
-
-export declare const DELETE = 46;
-
-export declare const DOWN_ARROW = 40;
-
-export declare const E = 69;
-
-export declare const EIGHT = 56;
-
-export declare const END = 35;
-
-export declare const ENTER = 13;
-
-export declare const EQUALS = 187;
-
-export declare const ESCAPE = 27;
-
-export declare const F = 70;
-
-export declare const F1 = 112;
-
-export declare const F10 = 121;
-
-export declare const F11 = 122;
-
-export declare const F12 = 123;
-
-export declare const F2 = 113;
-
-export declare const F3 = 114;
-
-export declare const F4 = 115;
-
-export declare const F5 = 116;
-
-export declare const F6 = 117;
-
-export declare const F7 = 118;
-
-export declare const F8 = 119;
-
-export declare const F9 = 120;
-
-export declare const FF_EQUALS = 61;
-
-export declare const FF_MINUS = 173;
-
-export declare const FF_MUTE = 181;
-
-export declare const FF_SEMICOLON = 59;
-
-export declare const FF_VOLUME_DOWN = 182;
-
-export declare const FF_VOLUME_UP = 183;
-
-export declare const FIRST_MEDIA = 166;
-
-export declare const FIVE = 53;
-
-export declare const FOUR = 52;
-
-export declare const G = 71;
-
-export declare const H = 72;
-
+declare const MAC_ENTER = 3;
+declare const BACKSPACE = 8;
+declare const TAB = 9;
+declare const NUM_CENTER = 12;
+declare const ENTER = 13;
+declare const SHIFT = 16;
+declare const CONTROL = 17;
+declare const ALT = 18;
+declare const PAUSE = 19;
+declare const CAPS_LOCK = 20;
+declare const ESCAPE = 27;
+declare const SPACE = 32;
+declare const PAGE_UP = 33;
+declare const PAGE_DOWN = 34;
+declare const END = 35;
+declare const HOME = 36;
+declare const LEFT_ARROW = 37;
+declare const UP_ARROW = 38;
+declare const RIGHT_ARROW = 39;
+declare const DOWN_ARROW = 40;
+declare const PLUS_SIGN = 43;
+declare const PRINT_SCREEN = 44;
+declare const INSERT = 45;
+declare const DELETE = 46;
+declare const ZERO = 48;
+declare const ONE = 49;
+declare const TWO = 50;
+declare const THREE = 51;
+declare const FOUR = 52;
+declare const FIVE = 53;
+declare const SIX = 54;
+declare const SEVEN = 55;
+declare const EIGHT = 56;
+declare const NINE = 57;
+declare const FF_SEMICOLON = 59;
+declare const FF_EQUALS = 61;
+declare const QUESTION_MARK = 63;
+declare const AT_SIGN = 64;
+declare const A = 65;
+declare const B = 66;
+declare const C = 67;
+declare const D = 68;
+declare const E = 69;
+declare const F = 70;
+declare const G = 71;
+declare const H = 72;
+declare const I = 73;
+declare const J = 74;
+declare const K = 75;
+declare const L = 76;
+declare const M = 77;
+declare const N = 78;
+declare const O = 79;
+declare const P = 80;
+declare const Q = 81;
+declare const R = 82;
+declare const S = 83;
+declare const T = 84;
+declare const U = 85;
+declare const V = 86;
+declare const W = 87;
+declare const X = 88;
+declare const Y = 89;
+declare const Z = 90;
+declare const META = 91;
+declare const MAC_WK_CMD_LEFT = 91;
+declare const MAC_WK_CMD_RIGHT = 93;
+declare const CONTEXT_MENU = 93;
+declare const NUMPAD_ZERO = 96;
+declare const NUMPAD_ONE = 97;
+declare const NUMPAD_TWO = 98;
+declare const NUMPAD_THREE = 99;
+declare const NUMPAD_FOUR = 100;
+declare const NUMPAD_FIVE = 101;
+declare const NUMPAD_SIX = 102;
+declare const NUMPAD_SEVEN = 103;
+declare const NUMPAD_EIGHT = 104;
+declare const NUMPAD_NINE = 105;
+declare const NUMPAD_MULTIPLY = 106;
+declare const NUMPAD_PLUS = 107;
+declare const NUMPAD_MINUS = 109;
+declare const NUMPAD_PERIOD = 110;
+declare const NUMPAD_DIVIDE = 111;
+declare const F1 = 112;
+declare const F2 = 113;
+declare const F3 = 114;
+declare const F4 = 115;
+declare const F5 = 116;
+declare const F6 = 117;
+declare const F7 = 118;
+declare const F8 = 119;
+declare const F9 = 120;
+declare const F10 = 121;
+declare const F11 = 122;
+declare const F12 = 123;
+declare const NUM_LOCK = 144;
+declare const SCROLL_LOCK = 145;
+declare const FIRST_MEDIA = 166;
+declare const FF_MINUS = 173;
+declare const MUTE = 173;
+declare const VOLUME_DOWN = 174;
+declare const VOLUME_UP = 175;
+declare const FF_MUTE = 181;
+declare const FF_VOLUME_DOWN = 182;
+declare const LAST_MEDIA = 183;
+declare const FF_VOLUME_UP = 183;
+declare const SEMICOLON = 186;
+declare const EQUALS = 187;
+declare const COMMA = 188;
+declare const DASH = 189;
+declare const PERIOD = 190;
+declare const SLASH = 191;
+declare const APOSTROPHE = 192;
+declare const TILDE = 192;
+declare const OPEN_SQUARE_BRACKET = 219;
+declare const BACKSLASH = 220;
+declare const CLOSE_SQUARE_BRACKET = 221;
+declare const SINGLE_QUOTE = 222;
+declare const MAC_META = 224;
+
+type ModifierKey = 'altKey' | 'shiftKey' | 'ctrlKey' | 'metaKey';
 /**
  * Checks whether a modifier key is pressed.
  * @param event Event to be checked.
  */
-export declare function hasModifierKey(event: KeyboardEvent, ...modifiers: ModifierKey[]): boolean;
-
-export declare const HOME = 36;
-
-export declare const I = 73;
-
-export declare const INSERT = 45;
-
-export declare const J = 74;
-
-export declare const K = 75;
-
-export declare const L = 76;
-
-export declare const LAST_MEDIA = 183;
-
-export declare const LEFT_ARROW = 37;
-
-export declare const M = 77;
-
-
-export declare const MAC_ENTER = 3;
-
-export declare const MAC_META = 224;
-
-export declare const MAC_WK_CMD_LEFT = 91;
-
-export declare const MAC_WK_CMD_RIGHT = 93;
-
-export declare const META = 91;
-
-
-export declare type ModifierKey = 'altKey' | 'shiftKey' | 'ctrlKey' | 'metaKey';
-
-export declare const MUTE = 173;
-
-export declare const N = 78;
-
-export declare const NINE = 57;
-
-export declare const NUM_CENTER = 12;
-
-export declare const NUM_LOCK = 144;
-
-export declare const NUMPAD_DIVIDE = 111;
-
-export declare const NUMPAD_EIGHT = 104;
-
-export declare const NUMPAD_FIVE = 101;
-
-export declare const NUMPAD_FOUR = 100;
-
-export declare const NUMPAD_MINUS = 109;
-
-export declare const NUMPAD_MULTIPLY = 106;
-
-export declare const NUMPAD_NINE = 105;
-
-export declare const NUMPAD_ONE = 97;
-
-export declare const NUMPAD_PERIOD = 110;
-
-export declare const NUMPAD_PLUS = 107;
-
-export declare const NUMPAD_SEVEN = 103;
-
-export declare const NUMPAD_SIX = 102;
-
-export declare const NUMPAD_THREE = 99;
-
-export declare const NUMPAD_TWO = 98;
-
-export declare const NUMPAD_ZERO = 96;
-
-export declare const O = 79;
-
-export declare const ONE = 49;
-
-export declare const OPEN_SQUARE_BRACKET = 219;
-
-export declare const P = 80;
-
-export declare const PAGE_DOWN = 34;
-
-export declare const PAGE_UP = 33;
-
-export declare const PAUSE = 19;
-
-export declare const PERIOD = 190;
-
-export declare const PLUS_SIGN = 43;
-
-export declare const PRINT_SCREEN = 44;
-
-export declare const Q = 81;
-
-export declare const QUESTION_MARK = 63;
-
-export declare const R = 82;
-
-export declare const RIGHT_ARROW = 39;
-
-export declare const S = 83;
-
-export declare const SCROLL_LOCK = 145;
-
-export declare const SEMICOLON = 186;
-
-export declare const SEVEN = 55;
-
-export declare const SHIFT = 16;
-
-export declare const SINGLE_QUOTE = 222;
-
-export declare const SIX = 54;
-
-export declare const SLASH = 191;
-
-export declare const SPACE = 32;
-
-export declare const T = 84;
-
-export declare const TAB = 9;
-
-export declare const THREE = 51;
-
-export declare const TILDE = 192;
-
-export declare const TWO = 50;
-
-export declare const U = 85;
-
-export declare const UP_ARROW = 38;
-
-export declare const V = 86;
-
-export declare const VOLUME_DOWN = 174;
-
-export declare const VOLUME_UP = 175;
-
-export declare const W = 87;
-
-export declare const X = 88;
-
-export declare const Y = 89;
-
-export declare const Z = 90;
-
-export declare const ZERO = 48;
+declare function hasModifierKey(event: KeyboardEvent, ...modifiers: ModifierKey[]): boolean;
 
-export { }
+export { A, ALT, APOSTROPHE, AT_SIGN, B, BACKSLASH, BACKSPACE, C, CAPS_LOCK, CLOSE_SQUARE_BRACKET, COMMA, CONTEXT_MENU, CONTROL, D, DASH, DELETE, DOWN_ARROW, E, EIGHT, END, ENTER, EQUALS, ESCAPE, F, F1, F10, F11, F12, F2, F3, F4, F5, F6, F7, F8, F9, FF_EQUALS, FF_MINUS, FF_MUTE, FF_SEMICOLON, FF_VOLUME_DOWN, FF_VOLUME_UP, FIRST_MEDIA, FIVE, FOUR, G, H, HOME, I, INSERT, J, K, L, LAST_MEDIA, LEFT_ARROW, M, MAC_ENTER, MAC_META, MAC_WK_CMD_LEFT, MAC_WK_CMD_RIGHT, META, MUTE, type ModifierKey, N, NINE, NUMPAD_DIVIDE, NUMPAD_EIGHT, NUMPAD_FIVE, NUMPAD_FOUR, NUMPAD_MINUS, NUMPAD_MULTIPLY, NUMPAD_NINE, NUMPAD_ONE, NUMPAD_PERIOD, NUMPAD_PLUS, NUMPAD_SEVEN, NUMPAD_SIX, NUMPAD_THREE, NUMPAD_TWO, NUMPAD_ZERO, NUM_CENTER, NUM_LOCK, O, ONE, OPEN_SQUARE_BRACKET, P, PAGE_DOWN, PAGE_UP, PAUSE, PERIOD, PLUS_SIGN, PRINT_SCREEN, Q, QUESTION_MARK, R, RIGHT_ARROW, S, SCROLL_LOCK, SEMICOLON, SEVEN, SHIFT, SINGLE_QUOTE, SIX, SLASH, SPACE, T, TAB, THREE, TILDE, TWO, U, UP_ARROW, V, VOLUME_DOWN, VOLUME_UP, W, X, Y, Z, ZERO, hasModifierKey };

package/layout/index.d.ts

@@ -1,9 +1,27 @@
 import * as i0 from '@angular/core';
-import { Observable } from 'rxjs';
 import { OnDestroy } from '@angular/core';
+import { Observable } from 'rxjs';
 
+declare class LayoutModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<LayoutModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<LayoutModule, never, never, never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<LayoutModule>;
+}
+
+/** The current state of a layout breakpoint. */
+interface BreakpointState {
+    /** Whether the breakpoint is currently matching. */
+    matches: boolean;
+    /**
+     * A key boolean pair for each query provided to the observe method,
+     * with its current matched state.
+     */
+    breakpoints: {
+        [key: string]: boolean;
+    };
+}
 /** Utility for checking the matching state of `@media` queries. */
-export declare class BreakpointObserver implements OnDestroy {
+declare class BreakpointObserver implements OnDestroy {
     private _mediaMatcher;
     private _zone;
     /**  A map of all media queries currently being listened for. */
@@ -32,8 +50,7 @@ export declare class BreakpointObserver implements OnDestroy {
     static ɵprov: i0.ɵɵInjectableDeclaration<BreakpointObserver>;
 }
 
-
-export declare const Breakpoints: {
+declare const Breakpoints: {
     XSmall: string;
     Small: string;
     Medium: string;
@@ -50,27 +67,8 @@ export declare const Breakpoints: {
     WebLandscape: string;
 };
 
-/** The current state of a layout breakpoint. */
-export declare interface BreakpointState {
-    /** Whether the breakpoint is currently matching. */
-    matches: boolean;
-    /**
-     * A key boolean pair for each query provided to the observe method,
-     * with its current matched state.
-     */
-    breakpoints: {
-        [key: string]: boolean;
-    };
-}
-
-export declare class LayoutModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<LayoutModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<LayoutModule, never, never, never>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<LayoutModule>;
-}
-
 /** A utility for calling matchMedia queries. */
-export declare class MediaMatcher {
+declare class MediaMatcher {
     private _platform;
     private _nonce;
     /** The internal matchMedia method to return back a MediaQueryList like object. */
@@ -87,4 +85,4 @@ export declare class MediaMatcher {
     static ɵprov: i0.ɵɵInjectableDeclaration<MediaMatcher>;
 }
 
-export { }
+export { BreakpointObserver, type BreakpointState, Breakpoints, LayoutModule, MediaMatcher };

package/list-key-manager.d-72e9a2e7.d.ts

@@ -0,0 +1,164 @@
+import { QueryList, Signal, Injector } from '@angular/core';
+import { Subject } from 'rxjs';
+
+/** This interface is for items that can be passed to a ListKeyManager. */
+interface ListKeyManagerOption {
+    /** Whether the option is disabled. */
+    disabled?: boolean;
+    /** Gets the label for this option. */
+    getLabel?(): string;
+}
+/** Modifier keys handled by the ListKeyManager. */
+type ListKeyManagerModifierKey = 'altKey' | 'ctrlKey' | 'metaKey' | 'shiftKey';
+/**
+ * This class manages keyboard events for selectable lists. If you pass it a query list
+ * of items, it will set the active item correctly when arrow events occur.
+ */
+declare class ListKeyManager<T extends ListKeyManagerOption> {
+    private _items;
+    private _activeItemIndex;
+    private _activeItem;
+    private _wrap;
+    private _typeaheadSubscription;
+    private _itemChangesSubscription?;
+    private _vertical;
+    private _horizontal;
+    private _allowedModifierKeys;
+    private _homeAndEnd;
+    private _pageUpAndDown;
+    private _effectRef;
+    private _typeahead?;
+    /**
+     * Predicate function that can be used to check whether an item should be skipped
+     * by the key manager. By default, disabled items are skipped.
+     */
+    private _skipPredicateFn;
+    constructor(items: QueryList<T> | T[] | readonly T[]);
+    constructor(items: Signal<T[]> | Signal<readonly T[]>, injector: Injector);
+    /**
+     * Stream that emits any time the TAB key is pressed, so components can react
+     * when focus is shifted off of the list.
+     */
+    readonly tabOut: Subject<void>;
+    /** Stream that emits whenever the active item of the list manager changes. */
+    readonly change: Subject<number>;
+    /**
+     * Sets the predicate function that determines which items should be skipped by the
+     * list key manager.
+     * @param predicate Function that determines whether the given item should be skipped.
+     */
+    skipPredicate(predicate: (item: T) => boolean): this;
+    /**
+     * Configures wrapping mode, which determines whether the active item will wrap to
+     * the other end of list when there are no more items in the given direction.
+     * @param shouldWrap Whether the list should wrap when reaching the end.
+     */
+    withWrap(shouldWrap?: boolean): this;
+    /**
+     * Configures whether the key manager should be able to move the selection vertically.
+     * @param enabled Whether vertical selection should be enabled.
+     */
+    withVerticalOrientation(enabled?: boolean): this;
+    /**
+     * Configures the key manager to move the selection horizontally.
+     * Passing in `null` will disable horizontal movement.
+     * @param direction Direction in which the selection can be moved.
+     */
+    withHorizontalOrientation(direction: 'ltr' | 'rtl' | null): this;
+    /**
+     * Modifier keys which are allowed to be held down and whose default actions will be prevented
+     * as the user is pressing the arrow keys. Defaults to not allowing any modifier keys.
+     */
+    withAllowedModifierKeys(keys: ListKeyManagerModifierKey[]): this;
+    /**
+     * Turns on typeahead mode which allows users to set the active item by typing.
+     * @param debounceInterval Time to wait after the last keystroke before setting the active item.
+     */
+    withTypeAhead(debounceInterval?: number): this;
+    /** Cancels the current typeahead sequence. */
+    cancelTypeahead(): this;
+    /**
+     * Configures the key manager to activate the first and last items
+     * respectively when the Home or End key is pressed.
+     * @param enabled Whether pressing the Home or End key activates the first/last item.
+     */
+    withHomeAndEnd(enabled?: boolean): this;
+    /**
+     * Configures the key manager to activate every 10th, configured or first/last element in up/down direction
+     * respectively when the Page-Up or Page-Down key is pressed.
+     * @param enabled Whether pressing the Page-Up or Page-Down key activates the first/last item.
+     * @param delta Whether pressing the Home or End key activates the first/last item.
+     */
+    withPageUpDown(enabled?: boolean, delta?: number): this;
+    /**
+     * Sets the active item to the item at the index specified.
+     * @param index The index of the item to be set as active.
+     */
+    setActiveItem(index: number): void;
+    /**
+     * Sets the active item to the specified item.
+     * @param item The item to be set as active.
+     */
+    setActiveItem(item: T): void;
+    /**
+     * Sets the active item depending on the key event passed in.
+     * @param event Keyboard event to be used for determining which element should be active.
+     */
+    onKeydown(event: KeyboardEvent): void;
+    /** Index of the currently active item. */
+    get activeItemIndex(): number | null;
+    /** The active item. */
+    get activeItem(): T | null;
+    /** Gets whether the user is currently typing into the manager using the typeahead feature. */
+    isTyping(): boolean;
+    /** Sets the active item to the first enabled item in the list. */
+    setFirstItemActive(): void;
+    /** Sets the active item to the last enabled item in the list. */
+    setLastItemActive(): void;
+    /** Sets the active item to the next enabled item in the list. */
+    setNextItemActive(): void;
+    /** Sets the active item to a previous enabled item in the list. */
+    setPreviousItemActive(): void;
+    /**
+     * Allows setting the active without any other effects.
+     * @param index Index of the item to be set as active.
+     */
+    updateActiveItem(index: number): void;
+    /**
+     * Allows setting the active item without any other effects.
+     * @param item Item to be set as active.
+     */
+    updateActiveItem(item: T): void;
+    /** Cleans up the key manager. */
+    destroy(): void;
+    /**
+     * This method sets the active item, given a list of items and the delta between the
+     * currently active item and the new active item. It will calculate differently
+     * depending on whether wrap mode is turned on.
+     */
+    private _setActiveItemByDelta;
+    /**
+     * Sets the active item properly given "wrap" mode. In other words, it will continue to move
+     * down the list until it finds an item that is not disabled, and it will wrap if it
+     * encounters either end of the list.
+     */
+    private _setActiveInWrapMode;
+    /**
+     * Sets the active item properly given the default mode. In other words, it will
+     * continue to move down the list until it finds an item that is not disabled. If
+     * it encounters either end of the list, it will stop and not wrap.
+     */
+    private _setActiveInDefaultMode;
+    /**
+     * Sets the active item to the first enabled item starting at the index specified. If the
+     * item is disabled, it will move in the fallbackDelta direction until it either
+     * finds an enabled item or encounters the end of the list.
+     */
+    private _setActiveItemByIndex;
+    /** Returns the items as an array. */
+    private _getItemsArray;
+    /** Callback for when the items have changed. */
+    private _itemsChanged;
+}
+
+export { type ListKeyManagerOption as L, type ListKeyManagerModifierKey as a, ListKeyManager as b };