@cloud-ru/ds-list 1.0.0

package/dist/esm/types.d.ts

@@ -0,0 +1,38 @@
+import { ScrollProps as OriginalScrollProps } from '@cloud-ru/ds-scroll';
+import { ValueOf } from '@cloud-ru/ds-utils';
+import { ChangeEvent, KeyboardEvent, Ref } from 'react';
+import { ITEM_TYPE, MODE, SIZE } from './constants.js';
+/** Размер списка и его элементов */
+export type Size = ValueOf<typeof SIZE>;
+/** Режим выбора элементов списка */
+export type Mode = ValueOf<typeof MODE>;
+/** Тип группового / составного элемента списка */
+export type ItemType = ValueOf<typeof ITEM_TYPE>;
+/** Настройки поисковой строки списка */
+export type SearchState = {
+    placeholder?: string;
+    loading?: boolean;
+    value?: string;
+    onChange(value: string, e?: ChangeEvent<HTMLInputElement>): void;
+    onKeyDown?(e: KeyboardEvent<HTMLElement>): void;
+};
+export type ScrollProps = {
+    /** Включить ли скролл для основной части списка */
+    scroll?: boolean;
+    /** Ссылка на элемент, обозначающий самый конец прокручиваемого списка */
+    scrollRef?: Ref<HTMLElement>;
+    /** Ссылка на контейнер, который скроллится */
+    scrollContainerRef?: Ref<HTMLElement>;
+    /** Отключает возможность взаимодействовать со скролбарами мышью. */
+    untouchableScrollbars?: boolean;
+    /**
+     * Управление скрытием скролл баров:
+     * <br> - `Never` - показывать всегда
+     * <br> - `Leave` - скрывать когда курсор покидает компонент
+     * <br> - `Scroll` - показывать только когда происходит скроллинг
+     * <br> - `Move` - показывать при движении курсора над компонентом
+     */
+    barHideStrategy?: OriginalScrollProps['barHideStrategy'];
+    /** Колбек на скролл прокручиваемого списка */
+    onScroll?: OriginalScrollProps['onScroll'];
+};

package/dist/esm/types.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/utils.d.ts

@@ -0,0 +1,18 @@
+import { ReactEventHandler } from 'react';
+import { ItemId } from './components/index.js';
+export declare const stopPropagation: ReactEventHandler;
+/**
+ * Возвращает id для элемента футера
+ * @function  helper
+ */
+export declare const getFooterItemId: (id: ItemId) => string;
+/**
+ * Возвращает id для элемента, подставляя префикс
+ * @function  helper
+ */
+export declare const getItemAutoId: (prefix: ItemId, id: ItemId) => string;
+/**
+ * Возвращает id для дефолтного элемента
+ * @function  helper
+ */
+export declare const getDefaultItemId: (id: ItemId) => string;

package/dist/esm/utils.js

@@ -0,0 +1,19 @@
+import { ITEM_PREFIXES } from './constants.js';
+export const stopPropagation = e => {
+    e.stopPropagation();
+};
+/**
+ * Возвращает id для элемента футера
+ * @function  helper
+ */
+export const getFooterItemId = (id) => `${ITEM_PREFIXES.footer}__${id}`;
+/**
+ * Возвращает id для элемента, подставляя префикс
+ * @function  helper
+ */
+export const getItemAutoId = (prefix, id) => [prefix, id].join('-');
+/**
+ * Возвращает id для дефолтного элемента
+ * @function  helper
+ */
+export const getDefaultItemId = (id) => getItemAutoId(ITEM_PREFIXES.default, id);