@astral/ui 4.93.0 → 4.94.0

package/components/AsyncAutocomplete/AsyncAutocomplete.d.ts

@@ -9,5 +9,6 @@ export declare const AsyncAutocomplete: <TOptions, TMultiple extends boolean = f
     fetchDelayMs?: number | undefined;
     fetchOptions: (search: string, signal?: AbortSignal | undefined) => Promise<TOptions[]>;
     minSymbolsToFetch?: number | undefined;
+    shouldFetch?: import("../useAsyncOptions").ShouldFetch | undefined;
     onDataLoadError?: ((error: Error) => void) | undefined;
 } & import("react").RefAttributes<unknown>) => import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | null;

package/components/AsyncAutocomplete/types.d.ts

@@ -1,4 +1,5 @@
 import { type AutocompleteProps } from '../Autocomplete';
+import { type ShouldFetch } from '../useAsyncOptions';
 export type AsyncAutocompleteProps<TOptions, TMultiple extends boolean = false, TDisableClearable extends boolean = false, TFreeSolo extends boolean = false> = Omit<AutocompleteProps<TOptions, TMultiple, TDisableClearable, TFreeSolo>, 'inputValue' | 'loading' | 'disabled' | 'fullWidth' | 'error' | 'required' | 'success' | 'options' | 'filterOptions'> & {
     /**
      * Если `true`, будет показан индикатор загрузки
@@ -59,6 +60,10 @@ export type AsyncAutocompleteProps<TOptions, TMultiple extends boolean = false,
      * @default 0
      */
     minSymbolsToFetch?: number;
+    /**
+     * Функция, задающая правила валидации запроса
+     */
+    shouldFetch?: ShouldFetch;
     /**
      * Функция для обработки ошибок загрузки данных
      */

package/components/AsyncAutocomplete/useLogic/useLogic.d.ts

@@ -2,7 +2,7 @@ import type { AutocompleteInputChangeReason } from '@mui/material/Autocomplete';
 import { type SyntheticEvent } from 'react';
 import { type AsyncAutocompleteProps } from '../types';
 type UseLogicParams<TOptions, TMultiple extends boolean, TDisableClearable extends boolean, TFreeSolo extends boolean> = AsyncAutocompleteProps<TOptions, TMultiple, TDisableClearable, TFreeSolo>;
-export declare const useLogic: <TOptions, TMultiple extends boolean, TDisableClearable extends boolean, TFreeSolo extends boolean>({ fetchOptions, fetchDelayMs, minSymbolsToFetch, defaultValue, getOptionLabel, noOptionsText, onOpen, onInputChange, onDataLoadError, isLoadedDataError, isDisabled, isFullWidth, isSuccess, isError, isLoading, isRequired, ...restProps }: UseLogicParams<TOptions, TMultiple, TDisableClearable, TFreeSolo>) => {
+export declare const useLogic: <TOptions, TMultiple extends boolean, TDisableClearable extends boolean, TFreeSolo extends boolean>({ fetchOptions, fetchDelayMs, minSymbolsToFetch, shouldFetch, defaultValue, getOptionLabel, noOptionsText, onOpen, onInputChange, onDataLoadError, isLoadedDataError, isDisabled, isFullWidth, isSuccess, isError, isLoading, isRequired, ...restProps }: UseLogicParams<TOptions, TMultiple, TDisableClearable, TFreeSolo>) => {
     autocompleteProps: {
         classes?: Partial<import("@mui/material/Autocomplete").AutocompleteClasses> | undefined;
         defaultChecked?: boolean | undefined;

package/components/AsyncAutocomplete/useLogic/useLogic.js

@@ -3,11 +3,12 @@ import { DEFAULT_DELAY_MS, DEFAULT_EMPTY_OPTIONS_TEXT, DEFAULT_MIN_SEARCH_CHARAC
 /* Стандартный фильтр. Необходим для правильного отображения опций, при асинхронном поиске
  * см. https://track.astral.ru/soft/browse/UIKIT-2823 */
 const filterOptions = (options) => options;
-export const useLogic = ({ fetchOptions, fetchDelayMs = DEFAULT_DELAY_MS, minSymbolsToFetch = DEFAULT_MIN_SEARCH_CHARACTERS, defaultValue, getOptionLabel, noOptionsText = DEFAULT_NO_OPTIONS_TEXT, onOpen, onInputChange, onDataLoadError, isLoadedDataError, isDisabled, isFullWidth, isSuccess, isError, isLoading, isRequired, ...restProps }) => {
-    const { options, onInputChange: propsOnInputChange, onOpen: propsOnOpen, isLoadingData, isLoadingError, } = useAsyncOptions({
+export const useLogic = ({ fetchOptions, fetchDelayMs = DEFAULT_DELAY_MS, minSymbolsToFetch = DEFAULT_MIN_SEARCH_CHARACTERS, shouldFetch, defaultValue, getOptionLabel, noOptionsText = DEFAULT_NO_OPTIONS_TEXT, onOpen, onInputChange, onDataLoadError, isLoadedDataError, isDisabled, isFullWidth, isSuccess, isError, isLoading, isRequired, ...restProps }) => {
+    const { options, onInputChange: propsOnInputChange, onOpen: propsOnOpen, isLoadingData, isLoadingError, isAllow, hintText, } = useAsyncOptions({
         fetchOptions,
         fetchDelayMs,
         minSymbolsToFetch,
+        shouldFetch,
         onDataLoadError,
     });
     const handleInputChange = (event, search, reason) => {
@@ -21,7 +22,15 @@ export const useLogic = ({ fetchOptions, fetchDelayMs = DEFAULT_DELAY_MS, minSym
         propsOnOpen(defaultSearch, defaultValue);
         onOpen?.(event);
     };
-    const emptyOptionsText = options.length === 0 ? noOptionsText : DEFAULT_EMPTY_OPTIONS_TEXT;
+    const getEmptyOptionsText = () => {
+        if (isAllow) {
+            return noOptionsText;
+        }
+        if (hintText !== '') {
+            return hintText;
+        }
+        return DEFAULT_EMPTY_OPTIONS_TEXT;
+    };
     return {
         autocompleteProps: {
             options,
@@ -32,7 +41,7 @@ export const useLogic = ({ fetchOptions, fetchDelayMs = DEFAULT_DELAY_MS, minSym
             required: isRequired,
             success: isSuccess,
             onOpen: handleOpen,
-            noOptionsText: emptyOptionsText,
+            noOptionsText: getEmptyOptionsText(),
             onInputChange: handleInputChange,
             isLoadedDataError: isLoadedDataError ?? isLoadingError,
             getOptionLabel,

package/components/useAsyncOptions/faker.d.ts

@@ -0,0 +1,3 @@
+export declare const makeFetchOptions: (options: string[]) => import("@vitest/spy").Mock<import("@vitest/spy").Procedure>;
+export declare const makeEmptyFetchOptions: () => import("@vitest/spy").Mock<import("@vitest/spy").Procedure>;
+export declare const makeErrorFetchOptions: (error: Error) => import("@vitest/spy").Mock<import("@vitest/spy").Procedure>;

package/components/useAsyncOptions/faker.js

@@ -0,0 +1,3 @@
+export const makeFetchOptions = (options) => vi.fn().mockResolvedValue({ options });
+export const makeEmptyFetchOptions = () => vi.fn().mockResolvedValue({ options: [] });
+export const makeErrorFetchOptions = (error) => vi.fn().mockRejectedValue(error);

package/components/useAsyncOptions/index.d.ts

@@ -1 +1,2 @@
 export * from './useAsyncOptions';
+export * from './types';

package/components/useAsyncOptions/index.js

@@ -1 +1,2 @@
 export * from './useAsyncOptions';
+export * from './types';

package/components/useAsyncOptions/public.d.ts

@@ -1 +1,2 @@
+export * from './types';
 export * from './useAsyncOptions';

package/components/useAsyncOptions/public.js

@@ -1 +1,2 @@
+export * from './types';
 export * from './useAsyncOptions';

package/components/useAsyncOptions/types.d.ts

@@ -0,0 +1,7 @@
+export type ShouldFetchResult = {
+    isAllow: true;
+} | {
+    isAllow: false;
+    reason: string;
+};
+export type ShouldFetch = (inputValue: string) => ShouldFetchResult;

package/components/useAsyncOptions/types.js

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

package/components/useAsyncOptions/useAsyncOptions.d.ts

@@ -1,4 +1,5 @@
 import type { AutocompleteInputChangeReason } from '@mui/material/Autocomplete';
+import { type ShouldFetch } from './types';
 type FetchResult<TOptions> = {
     options: TOptions[];
     meta?: {
@@ -37,6 +38,10 @@ type UseAsyncOptionsParams<TOptions> = {
      * Минимальное количество символов для выполнения запроса
      */
     minSymbolsToFetch: number;
+    /**
+     * Функция, задающая правила валидации запроса
+     */
+    shouldFetch?: ShouldFetch;
     /**
      * Задержка для debounce
      */
@@ -57,7 +62,7 @@ type UseAsyncOptionsParams<TOptions> = {
  * Хук для асинхронной загрузки опций в компонентах с поиском.
  * Управляет задержкой, отменой запросов и состояниями загрузки.
  */
-export declare const useAsyncOptions: <TOptions>({ fetchOptions, fetchDelayMs, minSymbolsToFetch, onDataLoadError, isSmoothLoading, }: UseAsyncOptionsParams<TOptions>) => {
+export declare const useAsyncOptions: <TOptions>({ fetchOptions, fetchDelayMs, minSymbolsToFetch, shouldFetch, onDataLoadError, isSmoothLoading, }: UseAsyncOptionsParams<TOptions>) => {
     options: TOptions[];
     meta: {
         isAllDataLoaded: boolean;
@@ -65,6 +70,8 @@ export declare const useAsyncOptions: <TOptions>({ fetchOptions, fetchDelayMs, m
     isLoadingData: boolean;
     onRetry: (search: string) => void;
     isLoadingError: boolean;
+    isAllow: boolean;
+    hintText: string;
     debouncedFetchOptions: import("debounce").DebouncedFunction<(search: string) => void>;
     onInputChange: (search: string, reason?: AutocompleteInputChangeReason) => void;
     onOpen: (defaultSearch?: string, defaultValue?: TOptions | null | undefined, isAlwaysTriggerOnOpen?: boolean) => void;

package/components/useAsyncOptions/useAsyncOptions.js

@@ -5,12 +5,14 @@ import { useLoadingState } from '../useLoadingState';
  * Хук для асинхронной загрузки опций в компонентах с поиском.
  * Управляет задержкой, отменой запросов и состояниями загрузки.
  */
-export const useAsyncOptions = ({ fetchOptions, fetchDelayMs, minSymbolsToFetch, onDataLoadError, isSmoothLoading, }) => {
+export const useAsyncOptions = ({ fetchOptions, fetchDelayMs, minSymbolsToFetch, shouldFetch, onDataLoadError, isSmoothLoading, }) => {
     const [isLoadingData, setIsLoadingData] = useState(false);
     const [isFirstOpen, setIsFirstOpen] = useState(true);
     const [isLoadingError, setIsLoadingError] = useState(false);
     const abortControllerRef = useRef(null);
     const { isShowLoader } = useLoadingState(isLoadingData);
+    const [isAllow, setIsAllow] = useState(true);
+    const [hintText, setHintText] = useState('');
     const [options, setOptions] = useState({
         options: [],
     });
@@ -39,17 +41,32 @@ export const useAsyncOptions = ({ fetchOptions, fetchDelayMs, minSymbolsToFetch,
             abortControllerRef.current = null;
         });
     }, fetchDelayMs), [fetchOptions, fetchDelayMs]);
-    const onInputChange = (search, reason) => {
+    const isAllowedSearch = (search) => {
         if ((!search.length && minSymbolsToFetch > 0) ||
             search.length < minSymbolsToFetch) {
+            setHintText('');
+            return false;
+        }
+        const shouldFetchResult = shouldFetch?.(search);
+        if (shouldFetchResult && !shouldFetchResult.isAllow) {
+            setHintText(search.length !== 0 ? shouldFetchResult.reason : '');
+            return false;
+        }
+        return true;
+    };
+    const onInputChange = (search, reason) => {
+        if (!isAllowedSearch(search)) {
             if (debouncedFetchOptions.isPending) {
                 debouncedFetchOptions.clear();
             }
             setIsLoadingData(false);
             setOptions({ options: [] });
+            setIsAllow(false);
             return;
         }
         if (!isFirstOpen) {
+            setIsAllow(true);
+            setHintText('');
             if (reason === 'input') {
                 setIsLoadingData(true);
             }
@@ -59,7 +76,7 @@ export const useAsyncOptions = ({ fetchOptions, fetchDelayMs, minSymbolsToFetch,
     const onOpen = (defaultSearch = '', defaultValue, isAlwaysTriggerOnOpen = false) => {
         if (isFirstOpen || isAlwaysTriggerOnOpen) {
             setIsFirstOpen(false);
-            if (defaultValue || minSymbolsToFetch === 0) {
+            if (defaultValue || isAllowedSearch(defaultSearch)) {
                 setIsLoadingData(true);
                 debouncedFetchOptions(defaultSearch);
             }
@@ -78,6 +95,8 @@ export const useAsyncOptions = ({ fetchOptions, fetchDelayMs, minSymbolsToFetch,
         isLoadingData: isSmoothLoading ? isShowLoader : isLoadingData,
         onRetry,
         isLoadingError,
+        isAllow,
+        hintText,
         debouncedFetchOptions,
         onInputChange,
         onOpen,

package/node/components/AsyncAutocomplete/AsyncAutocomplete.d.ts

@@ -9,5 +9,6 @@ export declare const AsyncAutocomplete: <TOptions, TMultiple extends boolean = f
     fetchDelayMs?: number | undefined;
     fetchOptions: (search: string, signal?: AbortSignal | undefined) => Promise<TOptions[]>;
     minSymbolsToFetch?: number | undefined;
+    shouldFetch?: import("../useAsyncOptions").ShouldFetch | undefined;
     onDataLoadError?: ((error: Error) => void) | undefined;
 } & import("react").RefAttributes<unknown>) => import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | null;

package/node/components/AsyncAutocomplete/types.d.ts

@@ -1,4 +1,5 @@
 import { type AutocompleteProps } from '../Autocomplete';
+import { type ShouldFetch } from '../useAsyncOptions';
 export type AsyncAutocompleteProps<TOptions, TMultiple extends boolean = false, TDisableClearable extends boolean = false, TFreeSolo extends boolean = false> = Omit<AutocompleteProps<TOptions, TMultiple, TDisableClearable, TFreeSolo>, 'inputValue' | 'loading' | 'disabled' | 'fullWidth' | 'error' | 'required' | 'success' | 'options' | 'filterOptions'> & {
     /**
      * Если `true`, будет показан индикатор загрузки
@@ -59,6 +60,10 @@ export type AsyncAutocompleteProps<TOptions, TMultiple extends boolean = false,
      * @default 0
      */
     minSymbolsToFetch?: number;
+    /**
+     * Функция, задающая правила валидации запроса
+     */
+    shouldFetch?: ShouldFetch;
     /**
      * Функция для обработки ошибок загрузки данных
      */

package/node/components/AsyncAutocomplete/useLogic/useLogic.d.ts

@@ -2,7 +2,7 @@ import type { AutocompleteInputChangeReason } from '@mui/material/Autocomplete';
 import { type SyntheticEvent } from 'react';
 import { type AsyncAutocompleteProps } from '../types';
 type UseLogicParams<TOptions, TMultiple extends boolean, TDisableClearable extends boolean, TFreeSolo extends boolean> = AsyncAutocompleteProps<TOptions, TMultiple, TDisableClearable, TFreeSolo>;
-export declare const useLogic: <TOptions, TMultiple extends boolean, TDisableClearable extends boolean, TFreeSolo extends boolean>({ fetchOptions, fetchDelayMs, minSymbolsToFetch, defaultValue, getOptionLabel, noOptionsText, onOpen, onInputChange, onDataLoadError, isLoadedDataError, isDisabled, isFullWidth, isSuccess, isError, isLoading, isRequired, ...restProps }: UseLogicParams<TOptions, TMultiple, TDisableClearable, TFreeSolo>) => {
+export declare const useLogic: <TOptions, TMultiple extends boolean, TDisableClearable extends boolean, TFreeSolo extends boolean>({ fetchOptions, fetchDelayMs, minSymbolsToFetch, shouldFetch, defaultValue, getOptionLabel, noOptionsText, onOpen, onInputChange, onDataLoadError, isLoadedDataError, isDisabled, isFullWidth, isSuccess, isError, isLoading, isRequired, ...restProps }: UseLogicParams<TOptions, TMultiple, TDisableClearable, TFreeSolo>) => {
     autocompleteProps: {
         classes?: Partial<import("@mui/material/Autocomplete").AutocompleteClasses> | undefined;
         defaultChecked?: boolean | undefined;

package/node/components/AsyncAutocomplete/useLogic/useLogic.js

@@ -6,11 +6,12 @@ const constants_1 = require("../constants");
 /* Стандартный фильтр. Необходим для правильного отображения опций, при асинхронном поиске
  * см. https://track.astral.ru/soft/browse/UIKIT-2823 */
 const filterOptions = (options) => options;
-const useLogic = ({ fetchOptions, fetchDelayMs = constants_1.DEFAULT_DELAY_MS, minSymbolsToFetch = constants_1.DEFAULT_MIN_SEARCH_CHARACTERS, defaultValue, getOptionLabel, noOptionsText = constants_1.DEFAULT_NO_OPTIONS_TEXT, onOpen, onInputChange, onDataLoadError, isLoadedDataError, isDisabled, isFullWidth, isSuccess, isError, isLoading, isRequired, ...restProps }) => {
-    const { options, onInputChange: propsOnInputChange, onOpen: propsOnOpen, isLoadingData, isLoadingError, } = (0, useAsyncOptions_1.useAsyncOptions)({
+const useLogic = ({ fetchOptions, fetchDelayMs = constants_1.DEFAULT_DELAY_MS, minSymbolsToFetch = constants_1.DEFAULT_MIN_SEARCH_CHARACTERS, shouldFetch, defaultValue, getOptionLabel, noOptionsText = constants_1.DEFAULT_NO_OPTIONS_TEXT, onOpen, onInputChange, onDataLoadError, isLoadedDataError, isDisabled, isFullWidth, isSuccess, isError, isLoading, isRequired, ...restProps }) => {
+    const { options, onInputChange: propsOnInputChange, onOpen: propsOnOpen, isLoadingData, isLoadingError, isAllow, hintText, } = (0, useAsyncOptions_1.useAsyncOptions)({
         fetchOptions,
         fetchDelayMs,
         minSymbolsToFetch,
+        shouldFetch,
         onDataLoadError,
     });
     const handleInputChange = (event, search, reason) => {
@@ -24,7 +25,15 @@ const useLogic = ({ fetchOptions, fetchDelayMs = constants_1.DEFAULT_DELAY_MS, m
         propsOnOpen(defaultSearch, defaultValue);
         onOpen?.(event);
     };
-    const emptyOptionsText = options.length === 0 ? noOptionsText : constants_1.DEFAULT_EMPTY_OPTIONS_TEXT;
+    const getEmptyOptionsText = () => {
+        if (isAllow) {
+            return noOptionsText;
+        }
+        if (hintText !== '') {
+            return hintText;
+        }
+        return constants_1.DEFAULT_EMPTY_OPTIONS_TEXT;
+    };
     return {
         autocompleteProps: {
             options,
@@ -35,7 +44,7 @@ const useLogic = ({ fetchOptions, fetchDelayMs = constants_1.DEFAULT_DELAY_MS, m
             required: isRequired,
             success: isSuccess,
             onOpen: handleOpen,
-            noOptionsText: emptyOptionsText,
+            noOptionsText: getEmptyOptionsText(),
             onInputChange: handleInputChange,
             isLoadedDataError: isLoadedDataError ?? isLoadingError,
             getOptionLabel,

package/node/components/useAsyncOptions/faker.d.ts

@@ -0,0 +1,3 @@
+export declare const makeFetchOptions: (options: string[]) => import("@vitest/spy").Mock<import("@vitest/spy").Procedure>;
+export declare const makeEmptyFetchOptions: () => import("@vitest/spy").Mock<import("@vitest/spy").Procedure>;
+export declare const makeErrorFetchOptions: (error: Error) => import("@vitest/spy").Mock<import("@vitest/spy").Procedure>;

package/node/components/useAsyncOptions/faker.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeErrorFetchOptions = exports.makeEmptyFetchOptions = exports.makeFetchOptions = void 0;
+const makeFetchOptions = (options) => vi.fn().mockResolvedValue({ options });
+exports.makeFetchOptions = makeFetchOptions;
+const makeEmptyFetchOptions = () => vi.fn().mockResolvedValue({ options: [] });
+exports.makeEmptyFetchOptions = makeEmptyFetchOptions;
+const makeErrorFetchOptions = (error) => vi.fn().mockRejectedValue(error);
+exports.makeErrorFetchOptions = makeErrorFetchOptions;

package/node/components/useAsyncOptions/index.d.ts

@@ -1 +1,2 @@
 export * from './useAsyncOptions';
+export * from './types';

package/node/components/useAsyncOptions/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./useAsyncOptions"), exports);
+__exportStar(require("./types"), exports);

package/node/components/useAsyncOptions/public.d.ts

@@ -1 +1,2 @@
+export * from './types';
 export * from './useAsyncOptions';

package/node/components/useAsyncOptions/public.js

@@ -14,4 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
 __exportStar(require("./useAsyncOptions"), exports);

package/node/components/useAsyncOptions/types.d.ts

@@ -0,0 +1,7 @@
+export type ShouldFetchResult = {
+    isAllow: true;
+} | {
+    isAllow: false;
+    reason: string;
+};
+export type ShouldFetch = (inputValue: string) => ShouldFetchResult;

package/node/components/useAsyncOptions/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/node/components/useAsyncOptions/useAsyncOptions.d.ts

@@ -1,4 +1,5 @@
 import type { AutocompleteInputChangeReason } from '@mui/material/Autocomplete';
+import { type ShouldFetch } from './types';
 type FetchResult<TOptions> = {
     options: TOptions[];
     meta?: {
@@ -37,6 +38,10 @@ type UseAsyncOptionsParams<TOptions> = {
      * Минимальное количество символов для выполнения запроса
      */
     minSymbolsToFetch: number;
+    /**
+     * Функция, задающая правила валидации запроса
+     */
+    shouldFetch?: ShouldFetch;
     /**
      * Задержка для debounce
      */
@@ -57,7 +62,7 @@ type UseAsyncOptionsParams<TOptions> = {
  * Хук для асинхронной загрузки опций в компонентах с поиском.
  * Управляет задержкой, отменой запросов и состояниями загрузки.
  */
-export declare const useAsyncOptions: <TOptions>({ fetchOptions, fetchDelayMs, minSymbolsToFetch, onDataLoadError, isSmoothLoading, }: UseAsyncOptionsParams<TOptions>) => {
+export declare const useAsyncOptions: <TOptions>({ fetchOptions, fetchDelayMs, minSymbolsToFetch, shouldFetch, onDataLoadError, isSmoothLoading, }: UseAsyncOptionsParams<TOptions>) => {
     options: TOptions[];
     meta: {
         isAllDataLoaded: boolean;
@@ -65,6 +70,8 @@ export declare const useAsyncOptions: <TOptions>({ fetchOptions, fetchDelayMs, m
     isLoadingData: boolean;
     onRetry: (search: string) => void;
     isLoadingError: boolean;
+    isAllow: boolean;
+    hintText: string;
     debouncedFetchOptions: import("debounce").DebouncedFunction<(search: string) => void>;
     onInputChange: (search: string, reason?: AutocompleteInputChangeReason) => void;
     onOpen: (defaultSearch?: string, defaultValue?: TOptions | null | undefined, isAlwaysTriggerOnOpen?: boolean) => void;

package/node/components/useAsyncOptions/useAsyncOptions.js

@@ -8,12 +8,14 @@ const useLoadingState_1 = require("../useLoadingState");
  * Хук для асинхронной загрузки опций в компонентах с поиском.
  * Управляет задержкой, отменой запросов и состояниями загрузки.
  */
-const useAsyncOptions = ({ fetchOptions, fetchDelayMs, minSymbolsToFetch, onDataLoadError, isSmoothLoading, }) => {
+const useAsyncOptions = ({ fetchOptions, fetchDelayMs, minSymbolsToFetch, shouldFetch, onDataLoadError, isSmoothLoading, }) => {
     const [isLoadingData, setIsLoadingData] = (0, react_1.useState)(false);
     const [isFirstOpen, setIsFirstOpen] = (0, react_1.useState)(true);
     const [isLoadingError, setIsLoadingError] = (0, react_1.useState)(false);
     const abortControllerRef = (0, react_1.useRef)(null);
     const { isShowLoader } = (0, useLoadingState_1.useLoadingState)(isLoadingData);
+    const [isAllow, setIsAllow] = (0, react_1.useState)(true);
+    const [hintText, setHintText] = (0, react_1.useState)('');
     const [options, setOptions] = (0, react_1.useState)({
         options: [],
     });
@@ -42,17 +44,32 @@ const useAsyncOptions = ({ fetchOptions, fetchDelayMs, minSymbolsToFetch, onData
             abortControllerRef.current = null;
         });
     }, fetchDelayMs), [fetchOptions, fetchDelayMs]);
-    const onInputChange = (search, reason) => {
+    const isAllowedSearch = (search) => {
         if ((!search.length && minSymbolsToFetch > 0) ||
             search.length < minSymbolsToFetch) {
+            setHintText('');
+            return false;
+        }
+        const shouldFetchResult = shouldFetch?.(search);
+        if (shouldFetchResult && !shouldFetchResult.isAllow) {
+            setHintText(search.length !== 0 ? shouldFetchResult.reason : '');
+            return false;
+        }
+        return true;
+    };
+    const onInputChange = (search, reason) => {
+        if (!isAllowedSearch(search)) {
             if (debouncedFetchOptions.isPending) {
                 debouncedFetchOptions.clear();
             }
             setIsLoadingData(false);
             setOptions({ options: [] });
+            setIsAllow(false);
             return;
         }
         if (!isFirstOpen) {
+            setIsAllow(true);
+            setHintText('');
             if (reason === 'input') {
                 setIsLoadingData(true);
             }
@@ -62,7 +79,7 @@ const useAsyncOptions = ({ fetchOptions, fetchDelayMs, minSymbolsToFetch, onData
     const onOpen = (defaultSearch = '', defaultValue, isAlwaysTriggerOnOpen = false) => {
         if (isFirstOpen || isAlwaysTriggerOnOpen) {
             setIsFirstOpen(false);
-            if (defaultValue || minSymbolsToFetch === 0) {
+            if (defaultValue || isAllowedSearch(defaultSearch)) {
                 setIsLoadingData(true);
                 debouncedFetchOptions(defaultSearch);
             }
@@ -81,6 +98,8 @@ const useAsyncOptions = ({ fetchOptions, fetchDelayMs, minSymbolsToFetch, onData
         isLoadingData: isSmoothLoading ? isShowLoader : isLoadingData,
         onRetry,
         isLoadingError,
+        isAllow,
+        hintText,
         debouncedFetchOptions,
         onInputChange,
         onOpen,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astral/ui",
-  "version": "4.93.0",
+  "version": "4.94.0",
   "browser": "./index.js",
   "main": "./node/index.js",
   "dependencies": {

package/components/AsyncAutocomplete/faker.d.ts

@@ -1,2 +0,0 @@
-import { type AxiosRequestConfig } from 'axios';
-export declare const getFakeUsers: (search: string, options?: AxiosRequestConfig) => Promise<any>;

package/components/AsyncAutocomplete/faker.js

@@ -1,38 +0,0 @@
-import { faker } from '@ui/dev/faker';
-import axios from 'axios';
-import AxiosMockAdapter from 'axios-mock-adapter';
-const getRandomDelay = () => Math.random() * 100 + 100; // 200-500ms
-const axiosInstance = axios.create();
-const mock = new AxiosMockAdapter(axiosInstance, {
-    delayResponse: getRandomDelay(),
-});
-const generateFakeUsers = (count) => {
-    return Array.from({ length: count - 1 }).map(() => ({
-        id: faker.string.uuid(),
-        name: faker.person.fullName(),
-    }));
-};
-const FAKE_USERS = [
-    {
-        id: '1',
-        name: 'Иван Третьяков',
-    },
-    ...generateFakeUsers(30),
-];
-mock.onGet('/api/users').reply((config) => {
-    const search = new URLSearchParams(config.params).get('name_like') || '';
-    const users = FAKE_USERS.filter((user) => user.name.toLowerCase().includes(search.toLowerCase()));
-    return [200, users];
-});
-mock.onGet('/api/users/id').reply((config) => {
-    const userId = new URLSearchParams(config.params).get('id') || '';
-    const user = FAKE_USERS.find((fakeUser) => fakeUser.id === userId);
-    return [200, user];
-});
-export const getFakeUsers = async (search, options) => {
-    const response = await axiosInstance.get('api/users', {
-        ...options,
-        params: { ...options?.params, name_like: search },
-    });
-    return response.data;
-};

package/node/components/AsyncAutocomplete/faker.d.ts

@@ -1,2 +0,0 @@
-import { type AxiosRequestConfig } from 'axios';
-export declare const getFakeUsers: (search: string, options?: AxiosRequestConfig) => Promise<any>;

package/node/components/AsyncAutocomplete/faker.js

@@ -1,45 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFakeUsers = void 0;
-const faker_1 = require("@ui/dev/faker");
-const axios_1 = __importDefault(require("axios"));
-const axios_mock_adapter_1 = __importDefault(require("axios-mock-adapter"));
-const getRandomDelay = () => Math.random() * 100 + 100; // 200-500ms
-const axiosInstance = axios_1.default.create();
-const mock = new axios_mock_adapter_1.default(axiosInstance, {
-    delayResponse: getRandomDelay(),
-});
-const generateFakeUsers = (count) => {
-    return Array.from({ length: count - 1 }).map(() => ({
-        id: faker_1.faker.string.uuid(),
-        name: faker_1.faker.person.fullName(),
-    }));
-};
-const FAKE_USERS = [
-    {
-        id: '1',
-        name: 'Иван Третьяков',
-    },
-    ...generateFakeUsers(30),
-];
-mock.onGet('/api/users').reply((config) => {
-    const search = new URLSearchParams(config.params).get('name_like') || '';
-    const users = FAKE_USERS.filter((user) => user.name.toLowerCase().includes(search.toLowerCase()));
-    return [200, users];
-});
-mock.onGet('/api/users/id').reply((config) => {
-    const userId = new URLSearchParams(config.params).get('id') || '';
-    const user = FAKE_USERS.find((fakeUser) => fakeUser.id === userId);
-    return [200, user];
-});
-const getFakeUsers = async (search, options) => {
-    const response = await axiosInstance.get('api/users', {
-        ...options,
-        params: { ...options?.params, name_like: search },
-    });
-    return response.data;
-};
-exports.getFakeUsers = getFakeUsers;