@astral/ui 4.93.0 → 4.95.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/hook-form/FormPageLayout/FormPageFooter/FormPageFooter.d.ts

@@ -1,4 +1,5 @@
 import type { SecondaryAction } from '../../FormPageLayoutBase';
+import { type FormPageLayoutSubmitButtonProps } from '../types';
 export type FormFooterProps = {
     /**
      * Если true, кнопки будут недоступны для взаимодействия
@@ -13,5 +14,9 @@ export type FormFooterProps = {
      * @default 'Отправить'
      */
     submitButtonText?: string;
+    /**
+     * Параметры для кнопки отправки формы
+     */
+    submitButtonProps?: FormPageLayoutSubmitButtonProps;
 };
 export declare const FormPageFooter: (props: FormFooterProps) => import("react/jsx-runtime").JSX.Element;

package/hook-form/FormPageLayout/FormPageFooter/FormPageFooter.js

@@ -4,9 +4,9 @@ import { useFormFooter } from './hooks';
 import { SecondaryActions } from './SecondaryActions';
 import { ActionsWrapper, ShowMoreButton, StyledFormSubmitButton, } from './styles';
 export const FormPageFooter = (props) => {
-    const { isDisabled, submitButtonText = 'Отправить', secondaryActions, } = props;
+    const { isDisabled, submitButtonText = 'Отправить', secondaryActions, submitButtonProps, } = props;
     const { isActive, handleToggle, isShowMoreButton } = useFormFooter({
         secondaryActions,
     });
-    return (_jsxs(FormPageFooterContainer, { children: [_jsxs(ActionsWrapper, { "$isShowMoreButton": isShowMoreButton, children: [_jsx(StyledFormSubmitButton, { size: "large", disabled: isDisabled, children: submitButtonText }), secondaryActions && (_jsx(SecondaryActions, { isDisabled: isDisabled, actions: secondaryActions, isActive: isActive }))] }), isShowMoreButton && (_jsxs(ShowMoreButton, { disabled: isDisabled, variant: "text", onClick: handleToggle, "$isActive": isActive, children: [isActive ? 'Скрыть' : 'Показать', " \u0434\u0440\u0443\u0433\u0438\u0435 \u0434\u0435\u0439\u0441\u0442\u0432\u0438\u044F"] }))] }));
+    return (_jsxs(FormPageFooterContainer, { children: [_jsxs(ActionsWrapper, { "$isShowMoreButton": isShowMoreButton, children: [_jsx(StyledFormSubmitButton, { size: "large", disabled: isDisabled, ...submitButtonProps, children: submitButtonText }), secondaryActions && (_jsx(SecondaryActions, { isDisabled: isDisabled, actions: secondaryActions, isActive: isActive }))] }), isShowMoreButton && (_jsxs(ShowMoreButton, { disabled: isDisabled, variant: "text", onClick: handleToggle, "$isActive": isActive, children: [isActive ? 'Скрыть' : 'Показать', " \u0434\u0440\u0443\u0433\u0438\u0435 \u0434\u0435\u0439\u0441\u0442\u0432\u0438\u044F"] }))] }));
 };

package/hook-form/FormPageLayout/FormPageLayout.d.ts

@@ -1,29 +1,5 @@
-import { type ReactNode } from 'react';
-import { type PageLayoutProps } from '../../components/PageLayout';
-import { type FormProps } from '../Form';
-import type { SecondaryAction } from '../FormPageLayoutBase';
-type FormPageProps<TFormValues extends Record<string, unknown>> = Omit<FormProps<TFormValues>, 'children'> & {
-    /**
-     * Текст для кнопки отправки формы
-     */
-    submitButtonText?: string;
-    /**
-     * Дополнительные кнопки формы
-     */
-    secondaryActions?: SecondaryAction[];
-};
-export type FormPageLayoutProps<TFormValues extends Record<string, unknown>> = Omit<PageLayoutProps, 'content'> & {
-    /**
-     * Содержимое формы
-     */
-    children: ReactNode;
-    /**
-     * Параметры страницы формы
-     */
-    form: FormPageProps<TFormValues>;
-};
+import { type FormPageLayoutProps } from './types';
 /**
  * FormPageLayout предназначен для построения страниц с формами.
  */
 export declare const FormPageLayout: <TFormValues extends Record<string, unknown>>(props: FormPageLayoutProps<TFormValues>) => import("react/jsx-runtime").JSX.Element;
-export {};

package/hook-form/FormPageLayout/FormPageLayout.js

@@ -9,8 +9,8 @@ import { FormContent } from './styles';
  */
 export const FormPageLayout = (props) => {
     const { form, children, ...restProps } = props;
-    const { secondaryActions, submitButtonText, ...restFormProps } = form;
+    const { secondaryActions, submitButtonText, submitButtonProps, ...restFormProps } = form;
     return (_jsx(FormPageLayoutBase, { ...restProps, formProps: { ...form, secondaryActions }, contentClassname: cn({
             [formPageContentClassnames.formPageContentSecondaryActions]: Boolean(secondaryActions),
-        }), children: ({ isDisabled }) => (_jsxs(Form, { ...restFormProps, isDisabled: isDisabled, children: [_jsx(FormContent, { children: children }), _jsx(FormPageFooter, { isDisabled: isDisabled, submitButtonText: submitButtonText, secondaryActions: secondaryActions })] })) }));
+        }), children: ({ isDisabled }) => (_jsxs(Form, { ...restFormProps, isDisabled: isDisabled, children: [_jsx(FormContent, { children: children }), _jsx(FormPageFooter, { isDisabled: isDisabled, submitButtonText: submitButtonText, secondaryActions: secondaryActions, submitButtonProps: submitButtonProps })] })) }));
 };

package/hook-form/FormPageLayout/index.d.ts

@@ -1,2 +1,3 @@
 export { ActionsWrapper, SecondaryActions, ShowMoreButton, StyledFormSubmitButton, useFormFooter, } from './FormPageFooter';
 export * from './FormPageLayout';
+export type { FormPageLayoutProps, FormPageLayoutSubmitButtonProps, } from './types';

package/hook-form/FormPageLayout/public.d.ts

@@ -1,2 +1,3 @@
 export { formPageContentClassnames, formPageLayoutClassnames, } from '../FormPageLayoutBase';
 export * from './FormPageLayout';
+export type { FormPageLayoutProps, FormPageLayoutSubmitButtonProps, } from './types';

package/hook-form/FormPageLayout/types.d.ts

@@ -0,0 +1,31 @@
+import { type ReactNode } from 'react';
+import { type PageLayoutProps } from '../../components/PageLayout';
+import { type FormProps } from '../Form';
+import { type SecondaryAction } from '../FormPageLayoutBase';
+import { type FormSubmitButtonProps } from '../FormSubmitButton';
+export type FormPageLayoutSubmitButtonProps = Pick<FormSubmitButtonProps, 'color' | 'startIcon' | 'endIcon'>;
+type FormPageProps<TFormValues extends Record<string, unknown>> = Omit<FormProps<TFormValues>, 'children'> & {
+    /**
+     * Параметры для кнопки отправки формы
+     */
+    submitButtonProps?: FormPageLayoutSubmitButtonProps;
+    /**
+     * Текст для кнопки отправки формы
+     */
+    submitButtonText?: string;
+    /**
+     * Дополнительные кнопки формы
+     */
+    secondaryActions?: SecondaryAction[];
+};
+export type FormPageLayoutProps<TFormValues extends Record<string, unknown>> = Omit<PageLayoutProps, 'content'> & {
+    /**
+     * Содержимое формы
+     */
+    children: ReactNode;
+    /**
+     * Параметры страницы формы
+     */
+    form: FormPageProps<TFormValues>;
+};
+export {};

package/hook-form/FormPageLayout/types.js

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

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/node/hook-form/FormPageLayout/FormPageFooter/FormPageFooter.d.ts

@@ -1,4 +1,5 @@
 import type { SecondaryAction } from '../../FormPageLayoutBase';
+import { type FormPageLayoutSubmitButtonProps } from '../types';
 export type FormFooterProps = {
     /**
      * Если true, кнопки будут недоступны для взаимодействия
@@ -13,5 +14,9 @@ export type FormFooterProps = {
      * @default 'Отправить'
      */
     submitButtonText?: string;
+    /**
+     * Параметры для кнопки отправки формы
+     */
+    submitButtonProps?: FormPageLayoutSubmitButtonProps;
 };
 export declare const FormPageFooter: (props: FormFooterProps) => import("react/jsx-runtime").JSX.Element;

package/node/hook-form/FormPageLayout/FormPageFooter/FormPageFooter.js

@@ -7,10 +7,10 @@ const hooks_1 = require("./hooks");
 const SecondaryActions_1 = require("./SecondaryActions");
 const styles_1 = require("./styles");
 const FormPageFooter = (props) => {
-    const { isDisabled, submitButtonText = 'Отправить', secondaryActions, } = props;
+    const { isDisabled, submitButtonText = 'Отправить', secondaryActions, submitButtonProps, } = props;
     const { isActive, handleToggle, isShowMoreButton } = (0, hooks_1.useFormFooter)({
         secondaryActions,
     });
-    return ((0, jsx_runtime_1.jsxs)(FormPageFooterContainer_1.FormPageFooterContainer, { children: [(0, jsx_runtime_1.jsxs)(styles_1.ActionsWrapper, { "$isShowMoreButton": isShowMoreButton, children: [(0, jsx_runtime_1.jsx)(styles_1.StyledFormSubmitButton, { size: "large", disabled: isDisabled, children: submitButtonText }), secondaryActions && ((0, jsx_runtime_1.jsx)(SecondaryActions_1.SecondaryActions, { isDisabled: isDisabled, actions: secondaryActions, isActive: isActive }))] }), isShowMoreButton && ((0, jsx_runtime_1.jsxs)(styles_1.ShowMoreButton, { disabled: isDisabled, variant: "text", onClick: handleToggle, "$isActive": isActive, children: [isActive ? 'Скрыть' : 'Показать', " \u0434\u0440\u0443\u0433\u0438\u0435 \u0434\u0435\u0439\u0441\u0442\u0432\u0438\u044F"] }))] }));
+    return ((0, jsx_runtime_1.jsxs)(FormPageFooterContainer_1.FormPageFooterContainer, { children: [(0, jsx_runtime_1.jsxs)(styles_1.ActionsWrapper, { "$isShowMoreButton": isShowMoreButton, children: [(0, jsx_runtime_1.jsx)(styles_1.StyledFormSubmitButton, { size: "large", disabled: isDisabled, ...submitButtonProps, children: submitButtonText }), secondaryActions && ((0, jsx_runtime_1.jsx)(SecondaryActions_1.SecondaryActions, { isDisabled: isDisabled, actions: secondaryActions, isActive: isActive }))] }), isShowMoreButton && ((0, jsx_runtime_1.jsxs)(styles_1.ShowMoreButton, { disabled: isDisabled, variant: "text", onClick: handleToggle, "$isActive": isActive, children: [isActive ? 'Скрыть' : 'Показать', " \u0434\u0440\u0443\u0433\u0438\u0435 \u0434\u0435\u0439\u0441\u0442\u0432\u0438\u044F"] }))] }));
 };
 exports.FormPageFooter = FormPageFooter;

package/node/hook-form/FormPageLayout/FormPageLayout.d.ts

@@ -1,29 +1,5 @@
-import { type ReactNode } from 'react';
-import { type PageLayoutProps } from '../../components/PageLayout';
-import { type FormProps } from '../Form';
-import type { SecondaryAction } from '../FormPageLayoutBase';
-type FormPageProps<TFormValues extends Record<string, unknown>> = Omit<FormProps<TFormValues>, 'children'> & {
-    /**
-     * Текст для кнопки отправки формы
-     */
-    submitButtonText?: string;
-    /**
-     * Дополнительные кнопки формы
-     */
-    secondaryActions?: SecondaryAction[];
-};
-export type FormPageLayoutProps<TFormValues extends Record<string, unknown>> = Omit<PageLayoutProps, 'content'> & {
-    /**
-     * Содержимое формы
-     */
-    children: ReactNode;
-    /**
-     * Параметры страницы формы
-     */
-    form: FormPageProps<TFormValues>;
-};
+import { type FormPageLayoutProps } from './types';
 /**
  * FormPageLayout предназначен для построения страниц с формами.
  */
 export declare const FormPageLayout: <TFormValues extends Record<string, unknown>>(props: FormPageLayoutProps<TFormValues>) => import("react/jsx-runtime").JSX.Element;
-export {};

package/node/hook-form/FormPageLayout/FormPageLayout.js

@@ -12,9 +12,9 @@ const styles_1 = require("./styles");
  */
 const FormPageLayout = (props) => {
     const { form, children, ...restProps } = props;
-    const { secondaryActions, submitButtonText, ...restFormProps } = form;
+    const { secondaryActions, submitButtonText, submitButtonProps, ...restFormProps } = form;
     return ((0, jsx_runtime_1.jsx)(FormPageLayoutBase_1.FormPageLayoutBase, { ...restProps, formProps: { ...form, secondaryActions }, contentClassname: (0, cn_1.cn)({
             [FormPageLayoutBase_1.formPageContentClassnames.formPageContentSecondaryActions]: Boolean(secondaryActions),
-        }), children: ({ isDisabled }) => ((0, jsx_runtime_1.jsxs)(Form_1.Form, { ...restFormProps, isDisabled: isDisabled, children: [(0, jsx_runtime_1.jsx)(styles_1.FormContent, { children: children }), (0, jsx_runtime_1.jsx)(FormPageFooter_1.FormPageFooter, { isDisabled: isDisabled, submitButtonText: submitButtonText, secondaryActions: secondaryActions })] })) }));
+        }), children: ({ isDisabled }) => ((0, jsx_runtime_1.jsxs)(Form_1.Form, { ...restFormProps, isDisabled: isDisabled, children: [(0, jsx_runtime_1.jsx)(styles_1.FormContent, { children: children }), (0, jsx_runtime_1.jsx)(FormPageFooter_1.FormPageFooter, { isDisabled: isDisabled, submitButtonText: submitButtonText, secondaryActions: secondaryActions, submitButtonProps: submitButtonProps })] })) }));
 };
 exports.FormPageLayout = FormPageLayout;

package/node/hook-form/FormPageLayout/index.d.ts

@@ -1,2 +1,3 @@
 export { ActionsWrapper, SecondaryActions, ShowMoreButton, StyledFormSubmitButton, useFormFooter, } from './FormPageFooter';
 export * from './FormPageLayout';
+export type { FormPageLayoutProps, FormPageLayoutSubmitButtonProps, } from './types';

package/node/hook-form/FormPageLayout/public.d.ts

@@ -1,2 +1,3 @@
 export { formPageContentClassnames, formPageLayoutClassnames, } from '../FormPageLayoutBase';
 export * from './FormPageLayout';
+export type { FormPageLayoutProps, FormPageLayoutSubmitButtonProps, } from './types';

package/node/hook-form/FormPageLayout/types.d.ts

@@ -0,0 +1,31 @@
+import { type ReactNode } from 'react';
+import { type PageLayoutProps } from '../../components/PageLayout';
+import { type FormProps } from '../Form';
+import { type SecondaryAction } from '../FormPageLayoutBase';
+import { type FormSubmitButtonProps } from '../FormSubmitButton';
+export type FormPageLayoutSubmitButtonProps = Pick<FormSubmitButtonProps, 'color' | 'startIcon' | 'endIcon'>;
+type FormPageProps<TFormValues extends Record<string, unknown>> = Omit<FormProps<TFormValues>, 'children'> & {
+    /**
+     * Параметры для кнопки отправки формы
+     */
+    submitButtonProps?: FormPageLayoutSubmitButtonProps;
+    /**
+     * Текст для кнопки отправки формы
+     */
+    submitButtonText?: string;
+    /**
+     * Дополнительные кнопки формы
+     */
+    secondaryActions?: SecondaryAction[];
+};
+export type FormPageLayoutProps<TFormValues extends Record<string, unknown>> = Omit<PageLayoutProps, 'content'> & {
+    /**
+     * Содержимое формы
+     */
+    children: ReactNode;
+    /**
+     * Параметры страницы формы
+     */
+    form: FormPageProps<TFormValues>;
+};
+export {};

package/node/hook-form/FormPageLayout/types.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astral/ui",
-  "version": "4.93.0",
+  "version": "4.95.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;