@jetbrains/ring-ui 4.1.6 → 5.0.0-beta.3

package/components/select/select.d.ts

@@ -0,0 +1,291 @@
+import React, { ButtonHTMLAttributes, Component, CSSProperties, HTMLAttributes, ReactNode, RefCallback, SyntheticEvent } from 'react';
+import { SelectHandlerParams } from '../list/list';
+import { Size } from '../input/input';
+import Theme from '../global/theme';
+import { ListDataItem } from '../list/consts';
+import { Directions } from '../popup/popup.consts';
+import SelectPopup, { Filter, FilterFn, Multiple, Tags } from './select__popup';
+/**
+ * @name Select
+ */
+declare function noop(): void;
+/**
+ * @enum {number}
+ */
+declare enum Type {
+    BUTTON = "BUTTON",
+    INPUT = "INPUT",
+    CUSTOM = "CUSTOM",
+    INLINE = "INLINE",
+    MATERIAL = "MATERIAL",
+    INPUT_WITHOUT_CONTROLS = "INPUT_WITHOUT_CONTROLS"
+}
+declare type SelectItemData<T> = T & {
+    key: string | number;
+    isResetItem?: boolean | null | undefined;
+    separator?: boolean | null | undefined;
+};
+export declare type SelectItem<T = unknown> = ListDataItem<SelectItemData<T>>;
+declare function getLowerCaseLabel<T>(item: SelectItem<T>): string | null;
+declare function doesLabelMatch<T>(itemToCheck: SelectItem<T>, fn: (label: string) => boolean): boolean;
+export interface Add {
+    alwaysVisible?: boolean | null | undefined;
+    regexp?: RegExp | null | undefined;
+    minlength?: number | null | undefined;
+    label?: ((filterString: string) => string) | string | null | undefined;
+    prefix?: string | null | undefined;
+    delayed?: boolean | null | undefined;
+}
+export interface DataTestProps {
+    'data-test'?: string | null | undefined;
+}
+export interface CustomAnchorProps {
+    wrapperProps: HTMLAttributes<HTMLElement> & DataTestProps & {
+        ref: RefCallback<HTMLElement>;
+    };
+    buttonProps: ButtonHTMLAttributes<HTMLButtonElement> & DataTestProps;
+    popup: ReactNode;
+}
+export interface BaseSelectProps<T = unknown> {
+    data: readonly SelectItem<T>[];
+    filter: boolean | Filter<T>;
+    clear: boolean;
+    loading: boolean;
+    disabled: boolean;
+    loadingMessage: string;
+    notFoundMessage: string;
+    type: Type;
+    size: Size;
+    hideSelected: boolean;
+    allowAny: boolean;
+    maxHeight: number;
+    hideArrow: boolean;
+    directions: readonly Directions[];
+    label: string;
+    selectedLabel: ReactNode;
+    inputPlaceholder: string;
+    shortcutsEnabled: boolean;
+    onBeforeOpen: () => void;
+    onLoadMore: () => void;
+    onOpen: () => void;
+    onFilter: (value: string) => void;
+    onFocus: () => void;
+    onBlur: () => void;
+    onKeyDown: (event: React.KeyboardEvent<HTMLInputElement>) => void;
+    onSelect: (selected: SelectItem<T> | null, event?: Event | SyntheticEvent) => void;
+    onDeselect: (selected: SelectItem<T> | null) => void;
+    onAdd: (value: string) => void;
+    onDone: () => void;
+    onReset: () => void;
+    dir: 'ltr' | 'rtl';
+    targetElement?: HTMLElement | null | undefined;
+    className?: string | null | undefined;
+    buttonClassName?: string | null | undefined;
+    id?: string | undefined;
+    getInitial?: (() => string) | null | undefined;
+    minWidth?: number | undefined;
+    popupClassName?: string | null | undefined;
+    popupStyle?: CSSProperties | undefined;
+    top?: number | undefined;
+    left?: number | undefined;
+    renderOptimization?: boolean | undefined;
+    ringPopupTarget?: string | null | undefined;
+    hint?: ReactNode;
+    add?: Add | null | undefined;
+    compact?: boolean | null | undefined;
+    theme?: string | null | undefined;
+    customAnchor?: ((props: CustomAnchorProps) => ReactNode) | null | undefined;
+    disableMoveOverflow?: boolean | null | undefined;
+    disableScrollToActive?: boolean | null | undefined;
+    'data-test'?: string | null | undefined;
+}
+export interface SingleSelectProps<T = unknown> extends BaseSelectProps<T> {
+    multiple: false;
+    onClose: (selected: SelectItem<T> | null) => void;
+    onChange: (selected: SelectItem<T> | null, event?: Event | SyntheticEvent) => void;
+    selected?: SelectItem<T> | null | undefined;
+    tags?: null | undefined;
+}
+export interface MultipleSelectProps<T = unknown> extends BaseSelectProps<T> {
+    multiple: true | Multiple;
+    selected: readonly SelectItem<T>[];
+    onClose: (selected: SelectItem<T>[]) => void;
+    onChange: (selected: SelectItem<T>[], event?: Event | SyntheticEvent) => void;
+    tags?: Tags | boolean | null | undefined;
+}
+declare type SelectProps<T = unknown> = SingleSelectProps<T> | MultipleSelectProps<T>;
+interface AddButton {
+    prefix: string | null | undefined;
+    label: string;
+    delayed: boolean;
+}
+export interface SelectState<T = unknown> {
+    data: SelectItem<T>[];
+    shownData: SelectItem<T>[];
+    selected: SelectItem<T> | SelectItem<T>[] | null | undefined;
+    selectedIndex: number | null;
+    filterValue: string;
+    shortcutsEnabled: boolean;
+    popupShortcuts: boolean;
+    showPopup: boolean;
+    prevData: readonly SelectItem<T>[];
+    prevSelected: SelectItem<T> | readonly SelectItem<T>[] | null | undefined;
+    prevMultiple: Multiple | boolean | null | undefined;
+    multipleMap: Record<string, boolean>;
+    addButton: AddButton | null;
+    focused?: boolean;
+}
+/**
+ * @name Select
+ * @constructor
+ * @extends {Component}
+ */
+/**
+ * Displays a select.
+ */
+export default class Select<T = unknown> extends Component<SelectProps<T>, SelectState<T>> {
+    static defaultProps: {
+        data: never[];
+        filter: boolean;
+        multiple: boolean;
+        clear: boolean;
+        loading: boolean;
+        disabled: boolean;
+        loadingMessage: string;
+        notFoundMessage: string;
+        type: Type;
+        size: Size;
+        targetElement: null;
+        hideSelected: boolean;
+        allowAny: boolean;
+        hideArrow: boolean;
+        maxHeight: number;
+        directions: Directions[];
+        selected: null;
+        label: string;
+        selectedLabel: string;
+        inputPlaceholder: string;
+        hint: null;
+        shortcutsEnabled: boolean;
+        onBeforeOpen: typeof noop;
+        onLoadMore: typeof noop;
+        onOpen: typeof noop;
+        onClose: typeof noop;
+        onFilter: typeof noop;
+        onFocus: typeof noop;
+        onBlur: typeof noop;
+        onKeyDown: typeof noop;
+        onSelect: typeof noop;
+        onDeselect: typeof noop;
+        onChange: typeof noop;
+        onAdd: typeof noop;
+        onDone: typeof noop;
+        onReset: typeof noop;
+        tags: null;
+        ringPopupTarget: null;
+        dir: string;
+    };
+    static getDerivedStateFromProps<T = unknown>(nextProps: SelectProps<T>, prevState: SelectState<T>): Partial<SelectState<T>>;
+    state: SelectState<T>;
+    componentDidUpdate(prevProps: SelectProps<T>, prevState: SelectState<T>): void;
+    static Type: typeof Type;
+    static Size: typeof Size;
+    static Theme: typeof Theme;
+    id: string;
+    shortcutsScope: string;
+    listId: string;
+    private _focusHandler;
+    private _blurHandler;
+    node?: HTMLElement | null;
+    nodeRef: (el: HTMLElement | null) => void;
+    _popup: SelectPopup<SelectItemData<T>> | null;
+    onEmptyPopupEnter: () => void;
+    private _onEnter;
+    private _onEsc;
+    _inputShortcutHandler: () => void;
+    getValueForFilter(selected: SelectItem<T> | readonly SelectItem<T>[] | null | undefined): string;
+    _getSelectedIndex(selected: SelectItem<T> | readonly SelectItem<T>[] | null | undefined, data: readonly SelectItem<T>[]): number | null;
+    popupRef: (el: SelectPopup<SelectItemData<T>> | null) => void;
+    _getResetOption(): SelectItem<T> | null;
+    _prependResetOption(shownData: SelectItem<T>[]): SelectItem<T>[];
+    private _renderPopup;
+    _showPopup(): void;
+    _hidePopup(tryFocusAnchor?: boolean): void;
+    addHandler: () => void;
+    getToolbar(): JSX.Element | null;
+    getLowerCaseLabel: typeof getLowerCaseLabel;
+    doesLabelMatch: typeof doesLabelMatch;
+    getFilterFn(): FilterFn<T>;
+    getListItems(rawFilterString: string, data?: SelectItem<T>[]): SelectItem<T>[];
+    filterValue(): string;
+    filterValue(setValue: string): void;
+    isInputMode(): boolean;
+    _clickHandler: () => void;
+    _filterChangeHandler: (e: React.ChangeEvent<HTMLInputElement>) => void;
+    private _setFilter;
+    private _rebuildMultipleMap;
+    _redrawPopup: () => void;
+    _listSelectHandler: (selected: SelectItem<T>, event?: Event | undefined, opts?: SelectHandlerParams) => void;
+    _listSelectAllHandler: (isSelectAll?: boolean) => void;
+    private _onCloseAttempt;
+    clearFilter: (e?: React.SyntheticEvent<Element, Event> | undefined) => void;
+    clear: (event?: Event | React.SyntheticEvent<Element, Event> | undefined) => boolean;
+    _selectionIsEmpty(): boolean;
+    private _getLabel;
+    _getSelectedString(): string | null;
+    private _getIcons;
+    private _getAvatar;
+    button?: HTMLElement | null;
+    buttonRef: (el: HTMLElement | null) => void;
+    filter?: HTMLInputElement | null;
+    filterRef: (el: HTMLInputElement | null) => void;
+    getShortcutsMap(): {
+        enter: () => true | undefined;
+        esc: (event: KeyboardEvent) => boolean | undefined;
+        up: () => void;
+        down: () => void;
+        right: typeof noop;
+        left: typeof noop;
+        'shift+up': typeof noop;
+        'shift+down': typeof noop;
+        space: typeof noop;
+    };
+    renderSelect(activeItemId: string | undefined): JSX.Element;
+    render(): JSX.Element;
+}
+export declare type SingleSelectAttrs<T = unknown> = JSX.LibraryManagedAttributes<typeof Select, SingleSelectProps<T>>;
+export declare type MultipleSelectAttrs<T = unknown> = JSX.LibraryManagedAttributes<typeof Select, MultipleSelectProps<T>>;
+export declare type SelectAttrs<T = unknown> = JSX.LibraryManagedAttributes<typeof Select, SelectProps<T>>;
+export declare const RerenderableSelect: {
+    new (props: SelectProps<unknown>): {
+        _propsCache: Readonly<SelectProps<unknown>> & Readonly<{
+            children?: React.ReactNode;
+        }>;
+        rerender(props?: Partial<SelectProps<unknown>>, callback?: (() => void) | undefined): void | Element | React.Component<SelectProps<unknown>, any, any>;
+        node?: HTMLElement | null | undefined;
+        context: any;
+        setState<K extends keyof SelectState<unknown>>(state: SelectState<unknown> | ((prevState: Readonly<SelectState<unknown>>, props: Readonly<SelectProps<unknown>>) => SelectState<unknown> | Pick<SelectState<unknown>, K> | null) | Pick<SelectState<unknown>, K> | null, callback?: (() => void) | undefined): void;
+        forceUpdate(callback?: (() => void) | undefined): void;
+        render(): React.ReactNode;
+        readonly props: Readonly<SelectProps<unknown>> & Readonly<{
+            children?: React.ReactNode;
+        }>;
+        state: Readonly<SelectState<unknown>>;
+        refs: {
+            [key: string]: React.ReactInstance;
+        };
+        componentDidMount?(): void;
+        shouldComponentUpdate?(nextProps: Readonly<SelectProps<unknown>>, nextState: Readonly<SelectState<unknown>>, nextContext: any): boolean;
+        componentWillUnmount?(): void;
+        componentDidCatch?(error: Error, errorInfo: React.ErrorInfo): void;
+        getSnapshotBeforeUpdate?(prevProps: Readonly<SelectProps<unknown>>, prevState: Readonly<SelectState<unknown>>): any;
+        componentDidUpdate?(prevProps: Readonly<SelectProps<unknown>>, prevState: Readonly<SelectState<unknown>>, snapshot?: any): void;
+        componentWillMount?(): void;
+        UNSAFE_componentWillMount?(): void;
+        componentWillReceiveProps?(nextProps: Readonly<SelectProps<unknown>>, nextContext: any): void;
+        UNSAFE_componentWillReceiveProps?(nextProps: Readonly<SelectProps<unknown>>, nextContext: any): void;
+        componentWillUpdate?(nextProps: Readonly<SelectProps<unknown>>, nextState: Readonly<SelectState<unknown>>, nextContext: any): void;
+        UNSAFE_componentWillUpdate?(nextProps: Readonly<SelectProps<unknown>>, nextState: Readonly<SelectState<unknown>>, nextContext: any): void;
+    };
+};
+export {};