@jetbrains/ring-ui 4.1.12 → 5.0.0-beta.11

package/components/list/consts.js

@@ -1,26 +1,26 @@
 /**
  * @enum {number}
  */
-export const Type = {
-  SEPARATOR: 0,
-  LINK: 1,
-  ITEM: 2,
-  HINT: 3,
-  CUSTOM: 4,
-  TITLE: 5,
-  MARGIN: 6
-};
-
-export const Dimension = {
-  ITEM_PADDING: 16,
-  ITEM_HEIGHT: 32,
-  COMPACT_ITEM_HEIGHT: 24,
-  SEPARATOR_HEIGHT: 25,
-  SEPARATOR_FIRST_HEIGHT: 16,
-  SEPARATOR_TEXT_HEIGHT: 18,
-  TITLE_HEIGHT: 42,
-  INNER_PADDING: 8,
-  MARGIN: 8
-};
-
+export var Type;
+(function (Type) {
+    Type[Type["SEPARATOR"] = 0] = "SEPARATOR";
+    Type[Type["LINK"] = 1] = "LINK";
+    Type[Type["ITEM"] = 2] = "ITEM";
+    Type[Type["HINT"] = 3] = "HINT";
+    Type[Type["CUSTOM"] = 4] = "CUSTOM";
+    Type[Type["TITLE"] = 5] = "TITLE";
+    Type[Type["MARGIN"] = 6] = "MARGIN";
+})(Type || (Type = {}));
+export var Dimension;
+(function (Dimension) {
+    Dimension[Dimension["ITEM_PADDING"] = 16] = "ITEM_PADDING";
+    Dimension[Dimension["ITEM_HEIGHT"] = 32] = "ITEM_HEIGHT";
+    Dimension[Dimension["COMPACT_ITEM_HEIGHT"] = 24] = "COMPACT_ITEM_HEIGHT";
+    Dimension[Dimension["SEPARATOR_HEIGHT"] = 25] = "SEPARATOR_HEIGHT";
+    Dimension[Dimension["SEPARATOR_FIRST_HEIGHT"] = 16] = "SEPARATOR_FIRST_HEIGHT";
+    Dimension[Dimension["SEPARATOR_TEXT_HEIGHT"] = 18] = "SEPARATOR_TEXT_HEIGHT";
+    Dimension[Dimension["TITLE_HEIGHT"] = 42] = "TITLE_HEIGHT";
+    Dimension[Dimension["INNER_PADDING"] = 8] = "INNER_PADDING";
+    Dimension[Dimension["MARGIN"] = 8] = "MARGIN";
+})(Dimension || (Dimension = {}));
 export const DEFAULT_ITEM_TYPE = Type.ITEM;

package/components/list/list.d.ts

@@ -0,0 +1,191 @@
+/**
+ * @name List
+ */
+import React, { Component, ReactNode, SyntheticEvent } from 'react';
+import PropTypes from 'prop-types';
+import VirtualizedList, { ListRowProps } from 'react-virtualized/dist/es/List';
+import { Size } from 'react-virtualized/dist/es/AutoSizer';
+import { WindowScrollerChildProps } from 'react-virtualized/dist/es/WindowScroller';
+import { ShortcutsMap } from '../shortcuts/core';
+import ListHint from './list__hint';
+import { Dimension, ListDataItem, ListDataItemProps, Type } from './consts';
+export type { ListDataItem };
+declare function noop(): void;
+/**
+ * @param {Type} listItemType
+ * @param {Object} item list item
+ */
+declare function isItemType<T>(listItemType: Type, item: ListDataItem<T>): boolean;
+export interface SelectHandlerParams {
+    tryKeepOpen?: boolean;
+}
+export interface ListProps<T = unknown> {
+    data: readonly ListDataItem<T>[];
+    restoreActiveIndex: boolean;
+    activateSingleItem: boolean;
+    activateFirstItem: boolean;
+    onMouseOut: (e: SyntheticEvent) => void;
+    onSelect: (item: ListDataItem<T>, event: Event | SyntheticEvent, params?: SelectHandlerParams) => void;
+    onScrollToBottom: () => void;
+    onResize: (info: Size) => void;
+    shortcuts: boolean;
+    renderOptimization: boolean;
+    disableMoveDownOverflow: boolean;
+    ariaLabel: string;
+    id?: string | undefined;
+    className?: string | null | undefined;
+    hint?: ReactNode;
+    hintOnSelection?: string | null | undefined;
+    maxHeight?: number | null | undefined;
+    activeIndex?: number | null | undefined;
+    useMouseUp?: boolean | null | undefined;
+    visible?: boolean | null | undefined;
+    disableMoveOverflow?: boolean | null | undefined;
+    compact?: boolean | null | undefined;
+    disableScrollToActive?: boolean | null | undefined;
+    hidden?: boolean | null | undefined;
+}
+export declare const ActiveItemContext: {
+    ValueContext: React.Context<string | undefined>;
+    UpdateContext: React.Context<(value: string | undefined) => void>;
+    Provider: {
+        ({ children }: import("../global/create-stateful-context").ProviderProps): JSX.Element;
+        propTypes: {
+            children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        };
+        displayName: string;
+    };
+    useUpdate: (value: string | undefined, skipUpdate?: boolean | undefined) => void;
+    Updater: React.MemoExoticComponent<{
+        ({ value, skipUpdate }: import("../global/create-stateful-context").UpdaterProps<string | undefined>): null;
+        displayName: string;
+    }>;
+};
+export interface ListState<T = unknown> {
+    activeIndex: number | null;
+    prevActiveIndex: number | null;
+    prevData: ListDataItem<T>[];
+    activeItem: ListDataItem<T> | null;
+    needScrollToActive: boolean;
+    scrolling: boolean;
+    hasOverflow: boolean;
+    disabledHover: boolean;
+    scrolledToBottom: boolean;
+}
+interface RenderVirtualizedInnerParams extends Partial<WindowScrollerChildProps> {
+    height: number;
+    maxHeight?: number;
+    autoHeight?: boolean;
+    rowCount: number;
+}
+/**
+ * @name List
+ * @constructor
+ * @extends {ReactComponent}
+ */
+/**
+ * Displays a list of items.
+ */
+export default class List<T = unknown> extends Component<ListProps<T>, ListState<T>> {
+    static propTypes: {
+        id: PropTypes.Requireable<string>;
+        className: PropTypes.Requireable<string>;
+        hint: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        hintOnSelection: PropTypes.Requireable<string>;
+        data: PropTypes.Requireable<any[]>;
+        maxHeight: PropTypes.Requireable<number>;
+        activeIndex: PropTypes.Requireable<number>;
+        restoreActiveIndex: PropTypes.Requireable<boolean>;
+        activateSingleItem: PropTypes.Requireable<boolean>;
+        activateFirstItem: PropTypes.Requireable<boolean>;
+        shortcuts: PropTypes.Requireable<boolean>;
+        onMouseOut: PropTypes.Requireable<(...args: any[]) => any>;
+        onSelect: PropTypes.Requireable<(...args: any[]) => any>;
+        onScrollToBottom: PropTypes.Requireable<(...args: any[]) => any>;
+        onResize: PropTypes.Requireable<(...args: any[]) => any>;
+        useMouseUp: PropTypes.Requireable<boolean>;
+        visible: PropTypes.Requireable<boolean>;
+        renderOptimization: PropTypes.Requireable<boolean>;
+        disableMoveOverflow: PropTypes.Requireable<boolean>;
+        disableMoveDownOverflow: PropTypes.Requireable<boolean>;
+        compact: PropTypes.Requireable<boolean>;
+        disableScrollToActive: PropTypes.Requireable<boolean>;
+        hidden: PropTypes.Requireable<boolean>;
+        ariaLabel: PropTypes.Requireable<string>;
+    };
+    static defaultProps: {
+        data: never[];
+        restoreActiveIndex: boolean;
+        activateSingleItem: boolean;
+        activateFirstItem: boolean;
+        onMouseOut: typeof noop;
+        onSelect: typeof noop;
+        onScrollToBottom: typeof noop;
+        onResize: typeof noop;
+        shortcuts: boolean;
+        renderOptimization: boolean;
+        disableMoveDownOverflow: boolean;
+        ariaLabel: string;
+    };
+    state: ListState<T>;
+    static getDerivedStateFromProps(nextProps: ListProps, prevState: ListState): {
+        prevActiveIndex: number | null | undefined;
+        prevData: readonly ListDataItem<unknown>[];
+    };
+    componentDidMount(): void;
+    shouldComponentUpdate(nextProps: ListProps<T>, nextState: ListState<T>): boolean;
+    componentDidUpdate(prevProps: ListProps<T>): void;
+    componentWillUnmount(): void;
+    static isItemType: typeof isItemType;
+    static ListHint: typeof ListHint;
+    static ListProps: {
+        Type: typeof Type;
+        Dimension: typeof Dimension;
+    };
+    virtualizedList?: VirtualizedList | null;
+    unmounted?: boolean;
+    container?: HTMLElement | null;
+    hoverHandler: (arg: number) => () => void;
+    private _activatableItems;
+    private _bufferSize;
+    sizeCacheKey: (index: number) => string | Type.ITEM | Type.MARGIN;
+    private _cache;
+    private _hasActivatableItems;
+    hasActivatableItems(): any;
+    selectHandler: (arg: number) => (event: Event | SyntheticEvent, tryKeepOpen?: boolean) => void;
+    checkboxHandler: (arg: number) => (event: SyntheticEvent) => void;
+    upHandler: (e: KeyboardEvent) => void;
+    downHandler: (e: KeyboardEvent) => void;
+    homeHandler: (e: KeyboardEvent) => void;
+    endHandler: (e: KeyboardEvent) => void;
+    onDocumentMouseMove: () => void;
+    onDocumentKeyDown: (e: KeyboardEvent) => void;
+    moveHandler(index: number, retryCallback: (e: KeyboardEvent) => void, e: KeyboardEvent): void;
+    mouseHandler: () => void;
+    scrollHandler: () => void;
+    enterHandler: (event: KeyboardEvent, shortcut?: string | undefined) => boolean;
+    getFirst(): ListDataItem<T> | undefined;
+    getSelected(): ListDataItem<T> | null;
+    clearSelected: () => void;
+    defaultItemHeight(): Dimension.ITEM_HEIGHT | Dimension.COMPACT_ITEM_HEIGHT;
+    scrollEndHandler: () => void;
+    checkOverflow: () => void;
+    getVisibleListHeight(maxHeight: number): number;
+    private _deprecatedGenerateKeyFromContent;
+    getId(item: ListDataItem<T> | null): string | undefined;
+    renderItem: ({ index, style, isScrolling, parent, key }: Partial<ListRowProps>) => JSX.Element;
+    addItemDataTestToProp: (props: ListDataItemProps<T>) => ListDataItemProps<T>;
+    virtualizedListRef: (el: VirtualizedList | null) => void;
+    containerRef: (el: HTMLElement | null) => void;
+    private _inner?;
+    get inner(): HTMLElement | null | undefined;
+    renderVirtualizedInner({ height, maxHeight, autoHeight, rowCount, isScrolling, onChildScroll, scrollTop, registerChild }: RenderVirtualizedInnerParams): JSX.Element;
+    renderVirtualized(maxHeight: number | null | undefined, rowCount: number): JSX.Element;
+    renderSimple(maxHeight: number | null | undefined, rowCount: number): JSX.Element;
+    id: string;
+    shortcutsScope: string;
+    shortcutsMap: ShortcutsMap;
+    /** @override */
+    render(): JSX.Element;
+}
+export declare type ListAttrs<T = unknown> = JSX.LibraryManagedAttributes<typeof List, ListProps<T>>;