@angular/aria 21.1.0-next.0 → 21.1.0-next.2

package/types/_combobox-chunk.d2.ts

@@ -0,0 +1,193 @@
+import * as _angular_core from '@angular/core';
+import { SignalLike, WritableSignalLike, KeyboardEventManager, PointerEventManager } from './_list-navigation-chunk.js';
+import { ListItem } from './_list-chunk.js';
+
+/** Represents the required inputs for a combobox. */
+interface ComboboxInputs<T extends ListItem<V>, V> {
+    /** The controls for the popup associated with the combobox. */
+    popupControls: SignalLike<ComboboxListboxControls<T, V> | ComboboxTreeControls<T, V> | ComboboxDialogPattern | undefined>;
+    /** The HTML input element that serves as the combobox input. */
+    inputEl: SignalLike<HTMLInputElement | undefined>;
+    /** The HTML element that serves as the combobox container. */
+    containerEl: SignalLike<HTMLElement | undefined>;
+    /** The filtering mode for the combobox. */
+    filterMode: SignalLike<'manual' | 'auto-select' | 'highlight'>;
+    /** The current value of the combobox. */
+    inputValue?: WritableSignalLike<string>;
+    /** The value of the first matching item in the popup. */
+    firstMatch: SignalLike<V | undefined>;
+    /** Whether the combobox is disabled. */
+    disabled: SignalLike<boolean>;
+    /** Whether the combobox is read-only. */
+    readonly: SignalLike<boolean>;
+    /** Whether the combobox is in a right-to-left context. */
+    textDirection: SignalLike<'rtl' | 'ltr'>;
+    /** Whether the combobox is always expanded. */
+    alwaysExpanded: SignalLike<boolean>;
+}
+/** An interface that allows combobox popups to expose the necessary controls for the combobox. */
+interface ComboboxListboxControls<T extends ListItem<V>, V> {
+    /** A unique identifier for the popup. */
+    id: () => string;
+    /** The ARIA role for the popup. */
+    role: SignalLike<'listbox' | 'tree' | 'grid'>;
+    /** Whether multiple items in the popup can be selected at once. */
+    multi: SignalLike<boolean>;
+    /** The ID of the active item in the popup. */
+    activeId: SignalLike<string | undefined>;
+    /** The list of items in the popup. */
+    items: SignalLike<T[]>;
+    /** Navigates to the given item in the popup. */
+    focus: (item: T, opts?: {
+        focusElement?: boolean;
+    }) => void;
+    /** Navigates to the next item in the popup. */
+    next: () => void;
+    /** Navigates to the previous item in the popup. */
+    prev: () => void;
+    /** Navigates to the first item in the popup. */
+    first: () => void;
+    /** Navigates to the last item in the popup. */
+    last: () => void;
+    /** Selects the current item in the popup. */
+    select: (item?: T) => void;
+    /** Toggles the selection state of the given item in the popup. */
+    toggle: (item?: T) => void;
+    /** Clears the selection state of the popup. */
+    clearSelection: () => void;
+    /** Removes focus from any item in the popup. */
+    unfocus: () => void;
+    /** Returns the item corresponding to the given event. */
+    getItem: (e: PointerEvent) => T | undefined;
+    /** Returns the currently active (focused) item in the popup. */
+    getActiveItem: () => T | undefined;
+    /** Returns the currently selected items in the popup. */
+    getSelectedItems: () => T[];
+    /** Sets the value of the combobox based on the selected item. */
+    setValue: (value: V | undefined) => void;
+}
+interface ComboboxTreeControls<T extends ListItem<V>, V> extends ComboboxListboxControls<T, V> {
+    /** Whether the currently active item in the popup is collapsible. */
+    isItemCollapsible: () => boolean;
+    /** Expands the currently active item in the popup. */
+    expandItem: () => void;
+    /** Collapses the currently active item in the popup. */
+    collapseItem: () => void;
+    /** Checks if the currently active item in the popup is expandable. */
+    isItemExpandable: (item?: T) => boolean;
+    /** Expands all nodes in the tree. */
+    expandAll: () => void;
+    /** Collapses all nodes in the tree. */
+    collapseAll: () => void;
+    /** Toggles the expansion state of the currently active item in the popup. */
+    toggleExpansion: (item?: T) => void;
+    /** Whether the current active item is selectable. */
+    isItemSelectable: (item?: T) => boolean;
+}
+/** Controls the state of a combobox. */
+declare class ComboboxPattern<T extends ListItem<V>, V> {
+    readonly inputs: ComboboxInputs<T, V>;
+    /** Whether the combobox is expanded. */
+    expanded: _angular_core.WritableSignal<boolean>;
+    /** Whether the combobox is disabled. */
+    disabled: () => boolean;
+    /** The ID of the active item in the combobox. */
+    activeDescendant: _angular_core.Signal<string | null>;
+    /** The currently highlighted item in the combobox. */
+    highlightedItem: _angular_core.WritableSignal<T | undefined>;
+    /** Whether the most recent input event was a deletion. */
+    isDeleting: boolean;
+    /** Whether the combobox is focused. */
+    isFocused: _angular_core.WritableSignal<boolean>;
+    /** Whether the combobox has ever been focused. */
+    hasBeenFocused: _angular_core.WritableSignal<boolean>;
+    /** The key used to navigate to the previous item in the list. */
+    expandKey: _angular_core.Signal<"ArrowLeft" | "ArrowRight">;
+    /** The key used to navigate to the next item in the list. */
+    collapseKey: _angular_core.Signal<"ArrowLeft" | "ArrowRight">;
+    /** The ID of the popup associated with the combobox. */
+    popupId: _angular_core.Signal<string | null>;
+    /** The autocomplete behavior of the combobox. */
+    autocomplete: _angular_core.Signal<"both" | "list">;
+    /** The ARIA role of the popup associated with the combobox. */
+    hasPopup: _angular_core.Signal<"listbox" | "tree" | "grid" | "dialog" | null>;
+    /** Whether the combobox is read-only. */
+    readonly: _angular_core.Signal<true | null>;
+    /** Returns the listbox controls for the combobox. */
+    listControls: () => ComboboxListboxControls<T, V> | null | undefined;
+    /** Returns the tree controls for the combobox. */
+    treeControls: () => ComboboxTreeControls<T, V> | null;
+    /** The keydown event manager for the combobox. */
+    keydown: _angular_core.Signal<KeyboardEventManager<KeyboardEvent>>;
+    /** The click event manager for the combobox. */
+    click: _angular_core.Signal<PointerEventManager<PointerEvent>>;
+    constructor(inputs: ComboboxInputs<T, V>);
+    /** Handles keydown events for the combobox. */
+    onKeydown(event: KeyboardEvent): void;
+    /** Handles click events for the combobox. */
+    onClick(event: MouseEvent): void;
+    /** Handles input events for the combobox. */
+    onInput(event: Event): void;
+    /** Handles focus in events for the combobox. */
+    onFocusIn(): void;
+    /** Handles focus out events for the combobox. */
+    onFocusOut(event: FocusEvent): void;
+    /** The first matching item in the combobox. */
+    firstMatch: _angular_core.Signal<T | undefined>;
+    /** Handles filtering logic for the combobox. */
+    onFilter(): void;
+    /** Highlights the currently selected item in the combobox. */
+    highlight(): void;
+    /** Closes the combobox. */
+    close(opts?: {
+        reset: boolean;
+    }): void;
+    /** Opens the combobox. */
+    open(nav?: {
+        first?: boolean;
+        last?: boolean;
+        selected?: boolean;
+    }): void;
+    /** Navigates to the next focusable item in the combobox popup. */
+    next(): void;
+    /** Navigates to the previous focusable item in the combobox popup. */
+    prev(): void;
+    /** Navigates to the first focusable item in the combobox popup. */
+    first(): void;
+    /** Navigates to the last focusable item in the combobox popup. */
+    last(): void;
+    /** Collapses the currently focused item in the combobox. */
+    collapseItem(): void;
+    /** Expands the currently focused item in the combobox. */
+    expandItem(): void;
+    /** Selects an item in the combobox popup. */
+    select(opts?: {
+        item?: T;
+        commit?: boolean;
+        close?: boolean;
+    }): void;
+    /** Updates the value of the input based on the currently selected item. */
+    commit(): void;
+    /** Navigates and handles additional actions based on filter mode. */
+    private _navigate;
+}
+declare class ComboboxDialogPattern {
+    readonly inputs: {
+        combobox: ComboboxPattern<any, any>;
+        element: SignalLike<HTMLDialogElement>;
+        id: SignalLike<string>;
+    };
+    id: () => string;
+    role: () => "dialog";
+    keydown: _angular_core.Signal<KeyboardEventManager<KeyboardEvent>>;
+    constructor(inputs: {
+        combobox: ComboboxPattern<any, any>;
+        element: SignalLike<HTMLDialogElement>;
+        id: SignalLike<string>;
+    });
+    onKeydown(event: KeyboardEvent): void;
+    onClick(event: MouseEvent): void;
+}
+
+export { ComboboxDialogPattern, ComboboxPattern };
+export type { ComboboxInputs, ComboboxListboxControls, ComboboxTreeControls };

package/types/_grid-chunk.d.ts

@@ -1,213 +1,6 @@
 import * as _angular_core from '@angular/core';
 import { WritableSignal, Signal } from '@angular/core';
-
-/**
- * Options that are applicable to all event handlers.
- *
- * This library has not yet had a need for stopPropagationImmediate.
- */
-interface EventHandlerOptions {
-    stopPropagation: boolean;
-    preventDefault: boolean;
-}
-/** A basic event handler. */
-type EventHandler<T extends Event> = (event: T) => void;
-/** A function that determines whether an event is to be handled. */
-type EventMatcher<T extends Event> = (event: T) => boolean;
-/** A config that specifies how to handle a particular event. */
-interface EventHandlerConfig<T extends Event> extends EventHandlerOptions {
-    matcher: EventMatcher<T>;
-    handler: EventHandler<T>;
-}
-/** Bit flag representation of the possible modifier keys that can be present on an event. */
-declare enum Modifier {
-    None = 0,
-    Ctrl = 1,
-    Shift = 2,
-    Alt = 4,
-    Meta = 8,
-    Any = "Any"
-}
-type ModifierInputs = Modifier | Modifier[];
-/**
- * Abstract base class for all event managers.
- *
- * Event managers are designed to normalize how event handlers are authored and create a safety net
- * for common event handling gotchas like remembering to call preventDefault or stopPropagation.
- */
-declare abstract class EventManager<T extends Event> {
-    protected configs: EventHandlerConfig<T>[];
-    abstract options: EventHandlerOptions;
-    /** Runs the handlers that match with the given event. */
-    handle(event: T): void;
-    /** Configures the event manager to handle specific events. (See subclasses for more). */
-    abstract on(...args: [...unknown[]]): this;
-}
-
-type SignalLike<T> = () => T;
-interface WritableSignalLike<T> extends SignalLike<T> {
-    set(value: T): void;
-    update(updateFn: (value: T) => T): void;
-}
-/** Converts a getter setter style signal to a WritableSignalLike. */
-declare function convertGetterSetterToWritableSignalLike<T>(getter: () => T, setter: (v: T) => void): WritableSignalLike<T>;
-
-/**
- * Used to represent a keycode.
- *
- * This is used to match whether an events keycode should be handled. The ability to match using a
- * string, SignalLike, or Regexp gives us more flexibility when authoring event handlers.
- */
-type KeyCode = string | SignalLike<string> | RegExp;
-/**
- * An event manager that is specialized for handling keyboard events. By default this manager stops
- * propagation and prevents default on all events it handles.
- */
-declare class KeyboardEventManager<T extends KeyboardEvent> extends EventManager<T> {
-    options: EventHandlerOptions;
-    /** Configures this event manager to handle events with a specific key and no modifiers. */
-    on(key: KeyCode, handler: EventHandler<T>, options?: Partial<EventHandlerOptions>): this;
-    /**  Configures this event manager to handle events with a specific modifer and key combination. */
-    on(modifiers: ModifierInputs, key: KeyCode, handler: EventHandler<T>, options?: Partial<EventHandlerOptions>): this;
-    private _normalizeInputs;
-    private _isMatch;
-}
-
-/**
- * The different mouse buttons that may appear on a pointer event.
- */
-declare enum MouseButton {
-    Main = 0,
-    Auxiliary = 1,
-    Secondary = 2
-}
-/** An event manager that is specialized for handling pointer events. */
-declare class PointerEventManager<T extends PointerEvent> extends EventManager<T> {
-    options: EventHandlerOptions;
-    /**
-     * Configures this event manager to handle events with a specific modifer and mouse button
-     * combination.
-     */
-    on(button: MouseButton, modifiers: ModifierInputs, handler: EventHandler<T>): this;
-    /**
-     * Configures this event manager to handle events with a specific mouse button and no modifiers.
-     */
-    on(modifiers: ModifierInputs, handler: EventHandler<T>): this;
-    /**
-     * Configures this event manager to handle events with the main mouse button and no modifiers.
-     *
-     * @param handler The handler function
-     * @param options Options for whether to stop propagation or prevent default.
-     */
-    on(handler: EventHandler<T>): this;
-    private _normalizeInputs;
-    _isMatch(event: PointerEvent, button: MouseButton, modifiers: ModifierInputs): boolean;
-}
-
-/** Represents an item in a collection, such as a listbox option, than may receive focus. */
-interface ListFocusItem {
-    /** A unique identifier for the item. */
-    id: SignalLike<string>;
-    /** The html element that should receive focus. */
-    element: SignalLike<HTMLElement | undefined>;
-    /** Whether an item is disabled. */
-    disabled: SignalLike<boolean>;
-    /** The index of the item in the list. */
-    index: SignalLike<number>;
-}
-/** Represents the required inputs for a collection that contains focusable items. */
-interface ListFocusInputs<T extends ListFocusItem> {
-    /** The focus strategy used by the list. */
-    focusMode: SignalLike<'roving' | 'activedescendant'>;
-    /** Whether the list is disabled. */
-    disabled: SignalLike<boolean>;
-    /** The items in the list. */
-    items: SignalLike<T[]>;
-    /** The active item. */
-    activeItem: WritableSignalLike<T | undefined>;
-    /** Whether disabled items in the list should be focusable. */
-    softDisabled: SignalLike<boolean>;
-    element: SignalLike<HTMLElement | undefined>;
-}
-/** Controls focus for a list of items. */
-declare class ListFocus<T extends ListFocusItem> {
-    readonly inputs: ListFocusInputs<T>;
-    /** The last item that was active. */
-    prevActiveItem: _angular_core.WritableSignal<T | undefined>;
-    /** The index of the last item that was active. */
-    prevActiveIndex: _angular_core.Signal<number>;
-    /** The current active index in the list. */
-    activeIndex: _angular_core.Signal<number>;
-    constructor(inputs: ListFocusInputs<T>);
-    /** Whether the list is in a disabled state. */
-    isListDisabled(): boolean;
-    /** The id of the current active item. */
-    getActiveDescendant(): string | undefined;
-    /** The tab index for the list. */
-    getListTabIndex(): -1 | 0;
-    /** Returns the tab index for the given item. */
-    getItemTabIndex(item: T): -1 | 0;
-    /** Moves focus to the given item if it is focusable. */
-    focus(item: T, opts?: {
-        focusElement?: boolean;
-    }): boolean;
-    /** Returns true if the given item can be navigated to. */
-    isFocusable(item: T): boolean;
-}
-
-/** Represents an item in a collection, such as a listbox option, than can be navigated to. */
-interface ListNavigationItem extends ListFocusItem {
-}
-/** Represents the required inputs for a collection that has navigable items. */
-interface ListNavigationInputs<T extends ListNavigationItem> extends ListFocusInputs<T> {
-    /** Whether focus should wrap when navigating. */
-    wrap: SignalLike<boolean>;
-    /** Whether the list is vertically or horizontally oriented. */
-    orientation: SignalLike<'vertical' | 'horizontal'>;
-    /** The direction that text is read based on the users locale. */
-    textDirection: SignalLike<'rtl' | 'ltr'>;
-}
-/** Controls navigation for a list of items. */
-declare class ListNavigation<T extends ListNavigationItem> {
-    readonly inputs: ListNavigationInputs<T> & {
-        focusManager: ListFocus<T>;
-    };
-    constructor(inputs: ListNavigationInputs<T> & {
-        focusManager: ListFocus<T>;
-    });
-    /** Navigates to the given item. */
-    goto(item?: T, opts?: {
-        focusElement?: boolean;
-    }): boolean;
-    /** Navigates to the next item in the list. */
-    next(opts?: {
-        focusElement?: boolean;
-    }): boolean;
-    /** Peeks the next item in the list. */
-    peekNext(): T | undefined;
-    /** Navigates to the previous item in the list. */
-    prev(opts?: {
-        focusElement?: boolean;
-    }): boolean;
-    /** Peeks the previous item in the list. */
-    peekPrev(): T | undefined;
-    /** Navigates to the first item in the list. */
-    first(opts?: {
-        focusElement?: boolean;
-    }): boolean;
-    /** Navigates to the last item in the list. */
-    last(opts?: {
-        focusElement?: boolean;
-    }): boolean;
-    /** Gets the first focusable item from the given list of items. */
-    peekFirst(items?: T[]): T | undefined;
-    /** Gets the last focusable item from the given list of items. */
-    peekLast(items?: T[]): T | undefined;
-    /** Advances to the next or previous focusable item in the list based on the given delta. */
-    private _advance;
-    /** Peeks the next or previous focusable item in the list based on the given delta. */
-    private _peek;
-}
+import { SignalLike, WritableSignalLike, ListNavigationItem, KeyboardEventManager, ListNavigationInputs, ListFocus, ListNavigation, PointerEventManager } from './_list-navigation-chunk.js';
 
 /** Represents coordinates in a grid. */
 interface RowCol {
@@ -785,5 +578,5 @@ declare class GridPattern {
     focusEffect(): void;
 }
 
-export { GridCellPattern, GridCellWidgetPattern, GridPattern, GridRowPattern, KeyboardEventManager, ListFocus, ListNavigation, PointerEventManager, convertGetterSetterToWritableSignalLike };
-export type { GridCellInputs, GridCellWidgetInputs, GridInputs, GridRowInputs, ListFocusInputs, ListFocusItem, ListNavigationInputs, ListNavigationItem, SignalLike, WritableSignalLike };
+export { GridCellPattern, GridCellWidgetPattern, GridPattern, GridRowPattern };
+export type { GridCellInputs, GridCellWidgetInputs, GridInputs, GridRowInputs };

package/types/_list-chunk.d.ts

@@ -0,0 +1,212 @@
+import * as _angular_core from '@angular/core';
+import { ListFocusItem, SignalLike, ListFocusInputs, WritableSignalLike, ListFocus, ListNavigationItem, ListNavigationInputs, ListNavigation } from './_list-navigation-chunk.js';
+
+/** Represents an item in a collection, such as a listbox option, that can be selected. */
+interface ListSelectionItem<V> extends ListFocusItem {
+    /** The value of the item. */
+    value: SignalLike<V>;
+    /** Whether the item is selectable. */
+    selectable: SignalLike<boolean>;
+}
+/** Represents the required inputs for a collection that contains selectable items. */
+interface ListSelectionInputs<T extends ListSelectionItem<V>, V> extends ListFocusInputs<T> {
+    /** Whether multiple items in the list can be selected at once. */
+    multi: SignalLike<boolean>;
+    /** The current value of the list selection. */
+    values: WritableSignalLike<V[]>;
+    /** The selection strategy used by the list. */
+    selectionMode: SignalLike<'follow' | 'explicit'>;
+}
+/** Controls selection for a list of items. */
+declare class ListSelection<T extends ListSelectionItem<V>, V> {
+    readonly inputs: ListSelectionInputs<T, V> & {
+        focusManager: ListFocus<T>;
+    };
+    /** The start index to use for range selection. */
+    rangeStartIndex: _angular_core.WritableSignal<number>;
+    /** The end index to use for range selection. */
+    rangeEndIndex: _angular_core.WritableSignal<number>;
+    /** The currently selected items. */
+    selectedItems: _angular_core.Signal<T[]>;
+    constructor(inputs: ListSelectionInputs<T, V> & {
+        focusManager: ListFocus<T>;
+    });
+    /** Selects the item at the current active index. */
+    select(item?: ListSelectionItem<V>, opts?: {
+        anchor: boolean;
+    }): void;
+    /** Deselects the item at the current active index. */
+    deselect(item?: ListSelectionItem<V>): void;
+    /** Toggles the item at the current active index. */
+    toggle(item?: ListSelectionItem<V>): void;
+    /** Toggles only the item at the current active index. */
+    toggleOne(): void;
+    /** Selects all items in the list. */
+    selectAll(): void;
+    /** Deselects all items in the list. */
+    deselectAll(): void;
+    /**
+     * Selects all items in the list or deselects all
+     * items in the list if all items are already selected.
+     */
+    toggleAll(): void;
+    /** Sets the selection to only the current active item. */
+    selectOne(): void;
+    /**
+     * Selects all items in the list up to the anchor item.
+     *
+     * Deselects all items that were previously within the
+     * selected range that are now outside of the selected range
+     */
+    selectRange(opts?: {
+        anchor: boolean;
+    }): void;
+    /** Marks the given index as the start of a range selection. */
+    beginRangeSelection(index?: number): void;
+    /** Returns the items in the list starting from the given index.  */
+    private _getItemsFromIndex;
+}
+
+/**
+ * Represents an item in a collection, such as a listbox option, than can be navigated to by
+ * typeahead.
+ */
+interface ListTypeaheadItem extends ListFocusItem {
+    /** The text used by the typeahead search. */
+    searchTerm: SignalLike<string>;
+}
+/**
+ * Represents the required inputs for a collection that contains items that can be navigated to by
+ * typeahead.
+ */
+interface ListTypeaheadInputs<T extends ListTypeaheadItem> extends ListFocusInputs<T> {
+    /** The amount of time before the typeahead search is reset. */
+    typeaheadDelay: SignalLike<number>;
+}
+/** Controls typeahead for a list of items. */
+declare class ListTypeahead<T extends ListTypeaheadItem> {
+    readonly inputs: ListTypeaheadInputs<T> & {
+        focusManager: ListFocus<T>;
+    };
+    /** A reference to the timeout for resetting the typeahead search. */
+    timeout?: ReturnType<typeof setTimeout> | undefined;
+    /** The focus controller of the parent list. */
+    focusManager: ListFocus<T>;
+    /** Whether the user is actively typing a typeahead search query. */
+    isTyping: _angular_core.Signal<boolean>;
+    /** Keeps track of the characters that typeahead search is being called with. */
+    private _query;
+    /** The index where that the typeahead search was initiated from. */
+    private _startIndex;
+    constructor(inputs: ListTypeaheadInputs<T> & {
+        focusManager: ListFocus<T>;
+    });
+    /** Performs a typeahead search, appending the given character to the search string. */
+    search(char: string): boolean;
+    /**
+     * Returns the first item whose search term matches the
+     * current query starting from the the current anchor index.
+     */
+    private _getItem;
+}
+
+/** The operations that the list can perform after navigation. */
+interface NavOptions {
+    toggle?: boolean;
+    select?: boolean;
+    selectOne?: boolean;
+    selectRange?: boolean;
+    anchor?: boolean;
+    focusElement?: boolean;
+}
+/** Represents an item in the list. */
+type ListItem<V> = ListTypeaheadItem & ListNavigationItem & ListSelectionItem<V> & ListFocusItem;
+/** The necessary inputs for the list behavior. */
+type ListInputs<T extends ListItem<V>, V> = ListFocusInputs<T> & ListNavigationInputs<T> & ListSelectionInputs<T, V> & ListTypeaheadInputs<T>;
+/** Controls the state of a list. */
+declare class List<T extends ListItem<V>, V> {
+    readonly inputs: ListInputs<T, V>;
+    /** Controls navigation for the list. */
+    navigationBehavior: ListNavigation<T>;
+    /** Controls selection for the list. */
+    selectionBehavior: ListSelection<T, V>;
+    /** Controls typeahead for the list. */
+    typeaheadBehavior: ListTypeahead<T>;
+    /** Controls focus for the list. */
+    focusBehavior: ListFocus<T>;
+    /** Whether the list is disabled. */
+    disabled: _angular_core.Signal<boolean>;
+    /** The id of the current active item. */
+    activeDescendant: _angular_core.Signal<string | undefined>;
+    /** The tab index of the list. */
+    tabIndex: _angular_core.Signal<0 | -1>;
+    /** The index of the currently active item in the list. */
+    activeIndex: _angular_core.Signal<number>;
+    /**
+     * The uncommitted index for selecting a range of options.
+     *
+     * NOTE: This is subtly distinct from the "rangeStartIndex" in the ListSelection behavior.
+     * The anchorIndex does not necessarily represent the start of a range, but represents the most
+     * recent index where the user showed intent to begin a range selection. Usually, this is wherever
+     * the user most recently pressed the "Shift" key, but if the user presses shift + space to select
+     * from the anchor, the user is not intending to start a new range from this index.
+     *
+     * In other words, "rangeStartIndex" is only set when a user commits to starting a range selection
+     * while "anchorIndex" is set whenever a user indicates they may be starting a range selection.
+     */
+    private _anchorIndex;
+    /** Whether the list should wrap. Used to disable wrapping while range selecting. */
+    private _wrap;
+    constructor(inputs: ListInputs<T, V>);
+    /** Returns the tab index for the given item. */
+    getItemTabindex(item: T): 0 | -1;
+    /** Navigates to the first option in the list. */
+    first(opts?: NavOptions): void;
+    /** Navigates to the last option in the list. */
+    last(opts?: NavOptions): void;
+    /** Navigates to the next option in the list. */
+    next(opts?: NavOptions): void;
+    /** Navigates to the previous option in the list. */
+    prev(opts?: NavOptions): void;
+    /** Navigates to the given item in the list. */
+    goto(item: T, opts?: NavOptions): void;
+    /** Removes focus from the list. */
+    unfocus(): void;
+    /** Marks the given index as the potential start of a range selection. */
+    anchor(index: number): void;
+    /** Handles typeahead search navigation for the list. */
+    search(char: string, opts?: NavOptions): void;
+    /** Checks if the list is currently typing for typeahead search. */
+    isTyping(): boolean;
+    /** Selects the currently active item in the list. */
+    select(item?: T): void;
+    /** Sets the selection to only the current active item. */
+    selectOne(): void;
+    /** Deselects the currently active item in the list. */
+    deselect(item?: T): void;
+    /** Deselects all items in the list. */
+    deselectAll(): void;
+    /** Toggles the currently active item in the list. */
+    toggle(item?: T): void;
+    /** Toggles the currently active item in the list, deselecting all other items. */
+    toggleOne(): void;
+    /** Toggles the selection of all items in the list. */
+    toggleAll(): void;
+    /** Checks if the given item is able to receive focus. */
+    isFocusable(item: T): boolean;
+    /** Handles updating selection for the list. */
+    updateSelection(opts?: NavOptions): void;
+    /**
+     * Safely performs a navigation operation.
+     *
+     * Handles conditionally disabling wrapping for when a navigation
+     * operation is occurring while the user is selecting a range of options.
+     *
+     * Handles boilerplate calling of focus & selection operations. Also ensures these
+     * additional operations are only called if the navigation operation moved focus to a new option.
+     */
+    private _navigate;
+}
+
+export { List };
+export type { ListInputs, ListItem };