@astral/ui 4.4.1 → 4.6.0

package/components/TreeLikeAsyncAutocomplete/OptionsModal/useLogic/useLogic.d.ts

@@ -0,0 +1,27 @@
+import { type ButtonProps } from '../../../Button';
+import { type DialogProps, type DialogSize } from '../../../Dialog';
+import { type SearchFieldProps } from '../../../SearchField';
+import { type TreeLikeListProps } from '../../../TreeLikeList';
+import type { TreeLikeAsyncAutocompleteValue } from '../../types';
+import type { OptionsModalProps } from '../types';
+type UseLogicParams = OptionsModalProps;
+type UseLogicResult = {
+    isNoResult: boolean;
+    isShowSearchSuggestion: boolean;
+    searchFieldProps: SearchFieldProps;
+    modalProps: DialogProps & {
+        size: DialogSize;
+    };
+    treeListProps: TreeLikeListProps<TreeLikeAsyncAutocompleteValue>;
+    cancelButtonProps: ButtonProps;
+    confirmButtonProps: ButtonProps;
+    handleRetry: () => void;
+    isShowUserHint?: boolean;
+    isShowModalLoader: boolean;
+    isShowSearchFieldLoader?: boolean;
+    treeProps?: Pick<TreeLikeListProps, 'disabledItems' | 'renderItem'>;
+    isLoadingError?: boolean;
+    loadingErrorMsg?: string;
+};
+export declare const useLogic: ({ isOpen, initialValue, options, onChange, dialogProps, onInputChange, onRetry, meta, onShowUserHint, isLoadingModal, minSymbolsToFetch, isLoading, isLoadingError, loadingErrorMsg, treeProps, }: UseLogicParams) => UseLogicResult;
+export {};

package/components/TreeLikeAsyncAutocomplete/OptionsModal/useLogic/useLogic.js

@@ -0,0 +1,92 @@
+import { useEffect, useMemo, useState, } from 'react';
+import { deepMap } from '../../../utils/array';
+export const useLogic = ({ isOpen, initialValue, options, onChange, dialogProps, onInputChange, onRetry, meta, onShowUserHint, isLoadingModal, minSymbolsToFetch = 0, isLoading, isLoadingError, loadingErrorMsg, treeProps, }) => {
+    const [value, setValue] = useState(initialValue);
+    const [searchValue, setSearchValue] = useState();
+    const { onClose, ...restDialogProps } = dialogProps;
+    useEffect(() => {
+        setValue(initialValue);
+    }, [initialValue]);
+    useEffect(() => {
+        // В поле ввода вставляем выбранное значение или пустую строку для запроса на открытие модального окна
+        if (isOpen) {
+            setSearchValue('');
+        }
+    }, [isOpen]);
+    const addIsForceExpandedFlag = (item) => {
+        if (item.children) {
+            return {
+                ...item,
+                options: { ...(item.options || {}), isForceExpanded: true },
+            };
+        }
+        return item;
+    };
+    // Если строка поиска не пустая и загрузки нет, то раскрываем все дерево в отфильтрованной выдаче
+    const optionToRender = useMemo(() => searchValue && !isLoading
+        ? deepMap(options, 'children', addIsForceExpandedFlag)
+        : options, [options, searchValue, isLoading]);
+    const handleChangeSearchField = (event) => {
+        setSearchValue(event.target.value);
+        onInputChange(event.target.value);
+    };
+    const handleChange = (newValue) => setValue(newValue);
+    const handleClose = (event) => {
+        setValue(initialValue);
+        onClose?.(event, 'escapeKeyDown');
+    };
+    const handleCancel = (event) => {
+        setValue(initialValue);
+        onClose?.(event, 'escapeKeyDown');
+    };
+    const handleClick = (event) => {
+        onChange?.(value);
+        onClose?.(event, 'escapeKeyDown');
+    };
+    const isNoResult = Boolean(searchValue) && !options.length;
+    const isDisabledButton = !value || isNoResult;
+    const handleRetry = () => {
+        onRetry?.(searchValue);
+    };
+    const isShowUserHint = onShowUserHint?.(options) || meta?.isAllDataLoaded;
+    const isShowModalLoader = isLoadingModal && options.length === 0;
+    const isShowSearchFieldLoader = (isLoading && !isLoadingModal) ||
+        (isLoading && isLoadingModal && options.length > 0);
+    const isShowSearchSuggestion = Boolean((!searchValue && minSymbolsToFetch > 0) ||
+        (searchValue && searchValue.length < minSymbolsToFetch));
+    return {
+        isShowModalLoader,
+        isShowSearchFieldLoader,
+        isNoResult,
+        handleRetry,
+        isShowUserHint,
+        isShowSearchSuggestion,
+        treeProps,
+        loadingErrorMsg,
+        isLoadingError,
+        modalProps: {
+            onClose: handleClose,
+            disableRestoreFocus: true,
+            open: isOpen,
+            size: 'md',
+            ...restDialogProps,
+        },
+        searchFieldProps: {
+            value: searchValue,
+            onChange: handleChangeSearchField,
+        },
+        treeListProps: {
+            value,
+            data: optionToRender,
+            onChange: handleChange,
+            isObjectMode: true,
+        },
+        cancelButtonProps: {
+            onClick: handleCancel,
+        },
+        confirmButtonProps: {
+            disabled: isDisabledButton,
+            onClick: handleClick,
+        },
+    };
+};

package/components/TreeLikeAsyncAutocomplete/TreeLikeAsyncAutocomplete.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+import type { TreeLikeAsyncAutocompleteProps } from './types';
+export declare const TreeLikeAsyncAutocomplete: import("react").ForwardRefExoticComponent<Omit<TreeLikeAsyncAutocompleteProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/components/TreeLikeAsyncAutocomplete/TreeLikeAsyncAutocomplete.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from 'react';
+import { Input } from './Input';
+import { OptionsModal } from './OptionsModal';
+import { useLogic } from './useLogic';
+export const TreeLikeAsyncAutocomplete = forwardRef((props, forwardedRef) => {
+    const { inputProps, optionsModalProps } = useLogic(props);
+    return (_jsxs(_Fragment, { children: [_jsx(Input, { ref: forwardedRef, ...inputProps }), _jsx(OptionsModal, { ...optionsModalProps })] }));
+});

package/components/TreeLikeAsyncAutocomplete/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_MIN_SEARCH_CHARACTERS = 0;
+export declare const DEFAULT_DELAY_MS = 300;

package/components/TreeLikeAsyncAutocomplete/constants.js

@@ -0,0 +1,2 @@
+export const DEFAULT_MIN_SEARCH_CHARACTERS = 0;
+export const DEFAULT_DELAY_MS = 300;

package/components/TreeLikeAsyncAutocomplete/index.d.ts

@@ -0,0 +1,2 @@
+export type { TreeLikeAsyncAutocompleteValue, TreeLikeAsyncAutocompleteProps, FetchOptionsResult, } from './types';
+export * from './TreeLikeAsyncAutocomplete';

package/components/TreeLikeAsyncAutocomplete/index.js

@@ -0,0 +1 @@
+export * from './TreeLikeAsyncAutocomplete';

package/components/TreeLikeAsyncAutocomplete/types.d.ts

@@ -0,0 +1,69 @@
+import type { FetchOptionsResult, TreeAsyncAutocompleteValue } from '../TreeAsyncAutocomplete';
+import type { TreeAutocompleteProps } from '../TreeAutocomplete';
+/**
+ * Значение для TreeLikeAsyncAutocomplete - массив элементов дерева
+ */
+export type TreeLikeAsyncAutocompleteValue = TreeAsyncAutocompleteValue[];
+export type { FetchOptionsResult };
+export type TreeLikeAsyncAutocompleteProps = Omit<TreeAutocompleteProps, 'options' | 'isLoading' | 'isLoadingError' | 'value' | 'onChange' | 'filterOptions' | 'trimmed' | 'maxLength' | 'type'> & {
+    /**
+     * Выбранное значения
+     */
+    value?: TreeLikeAsyncAutocompleteValue;
+    /**
+     * Функция, которая запускается при выборе item
+     */
+    onChange?: (newValue?: TreeLikeAsyncAutocompleteValue) => void;
+    /**
+     * Функция для асинхронной загрузки опций на основе поискового запроса
+     * При возникновении ошибки запроса данных, компонент сам ее обработает.
+     * Для обработки ошибок вручную используйте параметр `onDataLoadError`
+     *
+     * @param search - Строка поиска, введенная пользователем. На основе этой
+     *   строки функция должна вернуть подходящие опции.
+     * @param signal - Объект `AbortSignal`, который позволяет отменить запрос,
+     *   если пользователь изменил поисковый запрос или закрыл компонент.
+     *
+     * @returns Promise<FetchResult> Промис, который разрешается объектом с массивом узлов дерева и метаданными.
+     *
+     * @example
+     ```typescript
+     * const fetchOptions = async (search: string, signal?: AbortSignal) => {
+     *   const response = await fetch(`/api/options/search?query=${search}`, {
+     *     signal
+     *   });
+     *   const data = await response.json();
+     *
+     *   return {
+     *     options: data.items,
+     *     meta: {
+     *       isAllDataLoaded: data.isAllDataLoaded,
+     *     }
+     *   };
+     * };
+     *
+     * <TreeLikeAsyncAutocomplete fetchOptions={fetchOptions} />
+     * ```
+     */
+    fetchOptions: (search: string, signal?: AbortSignal) => Promise<FetchOptionsResult>;
+    /**
+     * Задержка для fetchOptions
+     */
+    fetchDelayMs?: number;
+    /**
+     * Функция для обработки ошибок загрузки данных
+     */
+    onDataLoadError?: (error: Error) => void;
+    /**
+     * Минимальное количество символов для выполнения запроса
+     */
+    minSymbolsToFetch?: number;
+    /**
+     * Функция определения необходимости показа подсказки пользователю
+     */
+    onShowUserHint?: (options: TreeLikeAsyncAutocompleteValue) => boolean;
+    /**
+     * Флаг загрузки данных
+     */
+    isLoading?: boolean;
+};

package/components/TreeLikeAsyncAutocomplete/types.js

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

package/components/TreeLikeAsyncAutocomplete/useLogic/index.d.ts

@@ -0,0 +1 @@
+export * from './useLogic';

package/components/TreeLikeAsyncAutocomplete/useLogic/index.js

@@ -0,0 +1 @@
+export * from './useLogic';