@astral/ui 4.65.1 → 4.67.0

package/components/DashboardSidebar/SidebarNav/SidebarNav.js

@@ -1,6 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { forwardRef } from 'react';
+import { sidebarNavClassnames } from './constants';
 export const SidebarNav = forwardRef((props, ref) => {
     const { menu } = props;
-    return _jsx("nav", { ref: ref, children: menu });
+    return (_jsx("nav", { ref: ref, className: sidebarNavClassnames.root, children: menu }));
 });

package/components/DashboardSidebar/SidebarNav/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const sidebarNavClassnames: {
+    root: string;
+};

package/components/DashboardSidebar/SidebarNav/constants.js

@@ -0,0 +1,4 @@
+import { createUIKitClassname } from '../../utils/createUIKitClassname';
+export const sidebarNavClassnames = {
+    root: createUIKitClassname('dashboard-layout-sidebar__navigation'),
+};

package/components/DashboardSidebar/SidebarNav/index.d.ts

@@ -1 +1,2 @@
 export * from './SidebarNav';
+export { sidebarNavClassnames } from './constants';

package/components/DashboardSidebar/SidebarNav/index.js

@@ -1 +1,2 @@
 export * from './SidebarNav';
+export { sidebarNavClassnames } from './constants';

package/components/DashboardSidebar/useLogic/hooks/index.d.ts

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

package/components/DashboardSidebar/useLogic/hooks/index.js

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

package/components/DashboardSidebar/useLogic/hooks/useCloseSidebarOnMobile/index.d.ts

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

package/components/DashboardSidebar/useLogic/hooks/useCloseSidebarOnMobile/index.js

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

package/components/DashboardSidebar/useLogic/hooks/useCloseSidebarOnMobile/useCloseSidebarOnMobile.d.ts

@@ -0,0 +1 @@
+export declare const useCloseSidebarOnMobile: () => void;

package/components/DashboardSidebar/useLogic/hooks/useCloseSidebarOnMobile/useCloseSidebarOnMobile.js

@@ -0,0 +1,30 @@
+import { useContext, useEffect } from 'react';
+import { DashboardSidebarContext } from '../../../../DashboardSidebarProvider';
+import { navMenuItemButtonClassnames } from '../../../../NavMenu';
+import { useViewportType } from '../../../../useViewportType';
+import { sidebarNavClassnames } from '../../../SidebarNav';
+export const useCloseSidebarOnMobile = () => {
+    const { isMobile } = useViewportType();
+    const { collapsedIn, onToggleSidebar } = useContext(DashboardSidebarContext);
+    const handleMenuListItemClick = () => {
+        onToggleSidebar(false);
+    };
+    useEffect(() => {
+        if (!isMobile || !collapsedIn) {
+            return;
+        }
+        const sidebarNavElement = document.querySelector(`.${sidebarNavClassnames.root}`);
+        if (!sidebarNavElement) {
+            return;
+        }
+        const listItems = sidebarNavElement.querySelectorAll(`.${navMenuItemButtonClassnames.root}:not(.${navMenuItemButtonClassnames.hasGroup})`);
+        listItems.forEach((item) => {
+            item.addEventListener('click', handleMenuListItemClick);
+        });
+        return () => {
+            listItems.forEach((item) => {
+                item.removeEventListener('click', handleMenuListItemClick);
+            });
+        };
+    }, [isMobile, collapsedIn]);
+};

package/components/DashboardSidebar/useLogic/useLogic.js

@@ -7,11 +7,13 @@ import { useTheme } from '../../theme/hooks/useTheme';
 import { useViewportType } from '../../useViewportType';
 import { classNames } from '../../utils/classNames';
 import { dashboardSidebarClassnames } from '../constants';
+import { useCloseSidebarOnMobile } from './hooks';
 export const useLogic = (props) => {
     const { className, menu, header, isLoading } = props;
     const { onToggleSidebar, isPinned, onTogglePin, collapsedIn, setIsPopupOpen, } = useContext(DashboardSidebarContext);
     const { alertHeight, isLoading: isDashboardLoading, hasMenuOrganizationRef, hasProfileRef, mobileHeaderPriorityFeature, } = useContext(DashboardContext);
     const { isMobile } = useViewportType();
+    useCloseSidebarOnMobile();
     const hoverTimerRef = useRef(null);
     const theme = useTheme();
     const onMouseEnter = () => {

package/components/NavMenu/index.d.ts

@@ -1 +1,2 @@
 export * from './NavMenu';
+export { navMenuItemButtonClassnames } from './Item';

package/components/NavMenu/index.js

@@ -1 +1,2 @@
 export * from './NavMenu';
+export { navMenuItemButtonClassnames } from './Item';

package/components/NewPopover/NewPopover.d.ts

@@ -0,0 +1,2 @@
+import { type NewPopoverProps } from './types';
+export declare const NewPopover: ({ children, onClose, isOpen, title, className, style, placement, anchorEl, disablePortal, disableAutoFocus, }: NewPopoverProps) => import("react/jsx-runtime").JSX.Element;

package/components/NewPopover/NewPopover.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { BottomDrawer } from '../BottomDrawer';
+import { classNames } from '../utils/classNames';
+import { cva } from '../utils/cva';
+import { popoverClassnames } from './constants';
+import { AnimatedWrapper, InnerContainer, StyledMuiPopper } from './styles';
+import { useLogic } from './useLogic';
+const animatedWrapperCva = cva(popoverClassnames.animatedWrapper, {
+    variants: {
+        isOpen: {
+            true: popoverClassnames.animatedWrapperOpen,
+        },
+    },
+});
+export const NewPopover = ({ children, onClose, isOpen, title, className, style, placement = 'bottom', anchorEl, disablePortal, disableAutoFocus, }) => {
+    const { isMobile, isOpened, shouldRender, handleAnimationEnd, handleClose, setContainerRef, } = useLogic({ isOpen, anchorEl, onClose, disableAutoFocus });
+    if (isMobile) {
+        return (_jsx(BottomDrawer, { title: title, onClose: handleClose, open: isOpened, className: className, style: style, ModalProps: {
+                disableAutoFocus,
+            }, children: children }));
+    }
+    return (_jsx(StyledMuiPopper, { className: popoverClassnames.root, open: shouldRender, placement: placement, anchorEl: anchorEl, disablePortal: disablePortal, children: _jsx(AnimatedWrapper, { className: classNames(className, animatedWrapperCva({ isOpen: isOpened })), style: style, onAnimationEnd: handleAnimationEnd, children: _jsx(InnerContainer, { ref: setContainerRef, tabIndex: -1, className: popoverClassnames.innerContainer, children: children }) }) }));
+};

package/components/NewPopover/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const popoverClassnames: {
+    root: string;
+    innerContainer: string;
+    animatedWrapper: string;
+    animatedWrapperOpen: string;
+};

package/components/NewPopover/constants.js

@@ -0,0 +1,7 @@
+import { createUIKitClassname } from '../utils/createUIKitClassname';
+export const popoverClassnames = {
+    root: createUIKitClassname('popover'),
+    innerContainer: createUIKitClassname('popover__inner-container'),
+    animatedWrapper: createUIKitClassname('popover__animated-wrapper'),
+    animatedWrapperOpen: createUIKitClassname('popover__animated-wrapper_is-open'),
+};

package/components/NewPopover/index.d.ts

@@ -0,0 +1,2 @@
+export { NewPopover } from './NewPopover';
+export type { NewPopoverProps } from './types';

package/components/NewPopover/index.js

@@ -0,0 +1 @@
+export { NewPopover } from './NewPopover';

package/components/NewPopover/public.d.ts

@@ -0,0 +1,2 @@
+export { NewPopover } from './NewPopover';
+export type { NewPopoverProps } from './types';

package/components/NewPopover/public.js

@@ -0,0 +1 @@
+export { NewPopover } from './NewPopover';

package/components/NewPopover/styles.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="react" />
+export declare const StyledMuiPopper: import("../styled").StyledComponent<import("@mui/material/Popper").PopperProps & import("react").RefAttributes<HTMLDivElement> & {
+    theme?: import("@emotion/react").Theme | undefined;
+}, {}, {}>;
+export declare const AnimatedWrapper: import("../styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme | undefined;
+    as?: import("react").ElementType<any, keyof import("react").JSX.IntrinsicElements> | undefined;
+}, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;
+export declare const InnerContainer: import("../styled").StyledComponent<{
+    theme?: import("@emotion/react").Theme | undefined;
+    as?: import("react").ElementType<any, keyof import("react").JSX.IntrinsicElements> | undefined;
+}, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;

package/components/NewPopover/styles.js

@@ -0,0 +1,80 @@
+import MuiPopper from '@mui/material/Popper';
+import { styled } from '../styled';
+import { popoverClassnames } from './constants';
+export const StyledMuiPopper = styled(MuiPopper) `
+  &.${popoverClassnames.root} {
+    z-index: ${({ theme }) => theme.zIndex.tooltip};
+  }
+
+  &&[data-popper-placement*='top'] .${popoverClassnames.animatedWrapper} {
+    transform-origin: bottom center;
+
+    margin-bottom: ${({ theme }) => theme.spacing(2)};
+  }
+
+  &&[data-popper-placement*='bottom'] .${popoverClassnames.animatedWrapper} {
+    transform-origin: top center;
+
+    margin-top: ${({ theme }) => theme.spacing(2)};
+  }
+
+  &&[data-popper-placement*='left'] .${popoverClassnames.animatedWrapper} {
+    transform-origin: right center;
+
+    margin-right: ${({ theme }) => theme.spacing(2)};
+  }
+
+  &&[data-popper-placement*='right'] .${popoverClassnames.animatedWrapper} {
+    transform-origin: left center;
+
+    margin-left: ${({ theme }) => theme.spacing(2)};
+  }
+`;
+export const AnimatedWrapper = styled.div `
+  animation: popover-grow-out
+    ${({ theme }) => theme.transitions.duration.enteringScreen}ms
+    ${({ theme }) => theme.transitions.easing.easeInOut} forwards;
+
+  &.${popoverClassnames.animatedWrapperOpen} {
+    animation: popover-grow-in
+      ${({ theme }) => theme.transitions.duration.enteringScreen}ms
+      ${({ theme }) => theme.transitions.easing.easeInOut} forwards;
+  }
+
+  @keyframes popover-grow-in {
+    from {
+      transform: scale(0.75, 0.5625);
+
+      opacity: 0;
+    }
+
+    to {
+      transform: none;
+
+      opacity: 1;
+    }
+  }
+
+  @keyframes popover-grow-out {
+    from {
+      transform: none;
+
+      opacity: 1;
+    }
+
+    to {
+      transform: scale(0.75, 0.5625);
+
+      opacity: 0;
+    }
+  }
+`;
+export const InnerContainer = styled.div `
+  &.${popoverClassnames.innerContainer} {
+    overflow: hidden;
+
+    background: ${({ theme }) => theme.palette.background.paper};
+    border-radius: ${({ theme }) => theme.shape.medium};
+    box-shadow: ${({ theme }) => theme.elevation[200]};
+  }
+`;

package/components/NewPopover/types.d.ts

@@ -0,0 +1,53 @@
+import type { CSSProperties, ReactNode, SyntheticEvent } from 'react';
+export type NewPopoverOnClose = (event: Event | SyntheticEvent) => void;
+export type NewPopoverPlacement = 'auto' | 'auto-start' | 'auto-end' | 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'right' | 'right-start' | 'right-end' | 'left' | 'left-start' | 'left-end';
+type NewPopoverVirtualElement = {
+    getBoundingClientRect: () => DOMRect;
+};
+export type NewPopoverAnchorEl = null | NewPopoverVirtualElement | HTMLElement | (() => HTMLElement) | (() => NewPopoverVirtualElement);
+export type NewPopoverProps = {
+    /**
+     * Якорь позиционирования
+     */
+    anchorEl?: NewPopoverAnchorEl;
+    /**
+     * Показывать popover. Если не передан — видимость определяется наличием anchorEl.
+     */
+    isOpen?: boolean;
+    /**
+     * Позиция относительно anchor
+     * @default 'bottom'
+     */
+    placement?: NewPopoverPlacement;
+    /**
+     * Контент popover
+     */
+    children?: ReactNode;
+    /**
+     * className корневого popper
+     */
+    className?: string;
+    /**
+     * style корневого popper
+     */
+    style?: CSSProperties;
+    /**
+     * Заголовок для отображения в мобильной версии
+     */
+    title?: string;
+    /**
+     * Обработчик закрытия компонента
+     */
+    onClose?: NewPopoverOnClose;
+    /**
+     * Рендерить popper внутри родителя, без portal
+     * @default false
+     */
+    disablePortal?: boolean;
+    /**
+     * Отключить автофокус при открытии popover (десктоп)
+     * @default false
+     */
+    disableAutoFocus?: boolean;
+};
+export {};

package/components/NewPopover/types.js

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

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

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

package/components/NewPopover/useLogic/index.js

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

package/components/NewPopover/useLogic/useLogic.d.ts

@@ -0,0 +1,11 @@
+import { type NewPopoverProps } from '../types';
+type UseLogicParams = Pick<NewPopoverProps, 'isOpen' | 'anchorEl' | 'onClose' | 'disableAutoFocus'>;
+export declare const useLogic: ({ isOpen, anchorEl, onClose, disableAutoFocus, }: UseLogicParams) => {
+    isMobile: boolean;
+    isOpened: boolean;
+    shouldRender: boolean;
+    handleAnimationEnd: () => void;
+    handleClose: (event: Event) => void;
+    setContainerRef: (node: HTMLDivElement | null) => void;
+};
+export {};

package/components/NewPopover/useLogic/useLogic.js

@@ -0,0 +1,54 @@
+import { useCallback, useMemo, useRef, useState } from 'react';
+import { useClickAwayEffect } from '../../useClickAwayEffect';
+import { useEscapeClickEffect } from '../../useEscapeClickEffect';
+import { useFocusTrapEffect } from '../../useFocusTrapEffect';
+import { usePopoverAnimation } from '../../usePopoverAnimation';
+import { useViewportType } from '../../useViewportType';
+import { resolveAnchorNode } from '../utils';
+export const useLogic = ({ isOpen, anchorEl, onClose, disableAutoFocus, }) => {
+    const containerRef = useRef(null);
+    const [isContainerMounted, setIsContainerMounted] = useState(false);
+    const setContainerRef = useCallback((node) => {
+        containerRef.current = node;
+        setIsContainerMounted(Boolean(node));
+    }, []);
+    const isOpened = isOpen ?? Boolean(anchorEl);
+    const isControlled = isOpen !== undefined;
+    const { isMobile } = useViewportType();
+    const { shouldRender, handleAnimationEnd } = usePopoverAnimation(isOpened);
+    const isEffectActive = !isMobile && isOpened && isContainerMounted;
+    const anchorNode = useMemo(() => resolveAnchorNode(anchorEl), [anchorEl]);
+    const excludeNodes = useMemo(() => [anchorNode], [anchorNode]);
+    const handleClose = (event) => {
+        onClose?.(event);
+    };
+    useClickAwayEffect({
+        ref: containerRef,
+        onClickAway: handleClose,
+        isActive: isEffectActive && !isControlled,
+        preventBubbling: true,
+        excludeNodes,
+    });
+    useEscapeClickEffect({
+        onEscape: handleClose,
+        isActive: isEffectActive,
+        preventBubbling: true,
+    });
+    useFocusTrapEffect({
+        ref: containerRef,
+        isActive: isEffectActive && !disableAutoFocus,
+        returnFocusOnDeactivate: true,
+        escapeDeactivates: false,
+        clickOutsideDeactivates: false,
+        allowOutsideClick: true,
+        fallbackFocus: () => containerRef.current || document.body,
+    });
+    return {
+        isMobile,
+        isOpened,
+        shouldRender,
+        handleAnimationEnd,
+        handleClose,
+        setContainerRef,
+    };
+};

package/components/NewPopover/utils/index.d.ts

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

package/components/NewPopover/utils/index.js

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

package/components/NewPopover/utils/resolveAnchorNode.d.ts

@@ -0,0 +1,6 @@
+import { type NewPopoverAnchorEl } from '../types';
+/**
+ * Резолвит anchorEl в DOM-ноду, если это возможно.
+ * Для virtual-элементов вернёт null.
+ */
+export declare const resolveAnchorNode: (anchorEl: NewPopoverAnchorEl | undefined) => Node | null;

package/components/NewPopover/utils/resolveAnchorNode.js

@@ -0,0 +1,8 @@
+/**
+ * Резолвит anchorEl в DOM-ноду, если это возможно.
+ * Для virtual-элементов вернёт null.
+ */
+export const resolveAnchorNode = (anchorEl) => {
+    const value = typeof anchorEl === 'function' ? anchorEl() : anchorEl;
+    return value instanceof Node ? value : null;
+};

package/components/Popover/Popover.d.ts

@@ -1,9 +1,5 @@
-import type { PopoverProps as MuiPopoverProps } from '@mui/material/Popover';
-import { type WithoutEmotionSpecific } from '../types/WithoutEmotionSpecific';
-export type PopoverProps = WithoutEmotionSpecific<MuiPopoverProps> & {
-    /**
-     * Заголовок для отображения в мобильной версии
-     */
-    title?: string;
-};
+import type { PopoverProps } from './types';
+/**
+ * @deprecated Причина отказа от поддержки: MUI Popover использует backdrop, который перехватывает первый внешний клик и создает UX-эффект "двойного клика". Используйте компонент `NewPopover`.
+ */
 export declare const Popover: ({ children, onClose, open, title, className, ...restProps }: PopoverProps) => import("react/jsx-runtime").JSX.Element;

package/components/Popover/Popover.js

@@ -2,6 +2,9 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { BottomDrawer } from '../BottomDrawer';
 import { useViewportType } from '../useViewportType';
 import { StyledMuiPopover } from './styles';
+/**
+ * @deprecated Причина отказа от поддержки: MUI Popover использует backdrop, который перехватывает первый внешний клик и создает UX-эффект "двойного клика". Используйте компонент `NewPopover`.
+ */
 export const Popover = ({ children, onClose, open, title, className, ...restProps }) => {
     const { isMobile } = useViewportType();
     if (isMobile) {

package/components/Popover/index.d.ts

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

package/components/Popover/index.js

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

package/components/Popover/public.d.ts

@@ -1 +1,2 @@
-export * from './Popover';
+export { Popover } from './Popover';
+export type { PopoverProps } from './types';

package/components/Popover/public.js

@@ -1 +1 @@
-export * from './Popover';
+export { Popover } from './Popover';

package/components/Popover/types.d.ts

@@ -0,0 +1,8 @@
+import type { PopoverProps as MuiPopoverProps } from '@mui/material/Popover';
+import { type WithoutEmotionSpecific } from '../types/WithoutEmotionSpecific';
+export type PopoverProps = WithoutEmotionSpecific<MuiPopoverProps> & {
+    /**
+     * Заголовок для отображения в мобильной версии
+     */
+    title?: string;
+};

package/components/Popover/types.js

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

package/components/index.d.ts

@@ -20,7 +20,6 @@ export * from './Checkbox';
 export * from './CheckboxField';
 export * from './Chevron';
 export * from './ClickAwayListener';
-export * from './ClickAwayListener';
 export { CodeField, type CodeFieldProps } from './CodeField';
 export * from './CollapsableAlert';
 export * from './Collapse';

package/components/index.js

@@ -20,7 +20,6 @@ export * from './Checkbox';
 export * from './CheckboxField';
 export * from './Chevron';
 export * from './ClickAwayListener';
-export * from './ClickAwayListener';
 export { CodeField } from './CodeField';
 export * from './CollapsableAlert';
 export * from './Collapse';

package/components/useClickAwayEffect/useClickAwayEffect.d.ts

@@ -1,5 +1,6 @@
 import { type RefObject } from 'react';
 import { type CloseEventReason } from '../types/CloseEventReason';
+export type ExcludedNode = Node | RefObject<Node | null> | null | undefined;
 export type UseClickAwayListenerOptions = {
     /**
      * реф на дом ноду, клик вне которой надо отслеживать
@@ -17,9 +18,13 @@ export type UseClickAwayListenerOptions = {
      * флаг необходимости предотвращать всплытие, подойдет когда используется внутри модалки
      */
     preventBubbling?: boolean;
+    /**
+     * Ноды (или рефы), клик по которым не приводит к срабатыванию onClickAway
+     */
+    excludeNodes?: ExcludedNode[];
 };
 /**
  * хук позволяющий подписаться на клик вне указанного рефа,
  * подойдет для использования в кастомных попперах
  */
-export declare const useClickAwayEffect: ({ ref, onClickAway, preventBubbling, isActive, }: UseClickAwayListenerOptions) => void;
+export declare const useClickAwayEffect: ({ ref, onClickAway, preventBubbling, isActive, excludeNodes, }: UseClickAwayListenerOptions) => void;

package/components/useClickAwayEffect/useClickAwayEffect.js

@@ -1,26 +1,36 @@
 import { useEffect } from 'react';
+const resolveNode = (item) => {
+    if (!item) {
+        return null;
+    }
+    return item instanceof Node ? item : item.current;
+};
 /**
  * хук позволяющий подписаться на клик вне указанного рефа,
  * подойдет для использования в кастомных попперах
  */
-export const useClickAwayEffect = ({ ref, onClickAway, preventBubbling, isActive, }) => {
+export const useClickAwayEffect = ({ ref, onClickAway, preventBubbling, isActive, excludeNodes, }) => {
     useEffect(() => {
         const node = ref?.current;
         if (!isActive || !node) {
             return;
         }
-        const onClick = (e) => {
-            if (!node.contains(e.target)) {
-                if (preventBubbling) {
-                    e.stopPropagation();
-                    e.stopImmediatePropagation();
-                }
-                onClickAway(e, 'clickAway');
+        const onClick = (event) => {
+            const target = event.target;
+            const isClickInside = node.contains(target);
+            const isClickOnExcluded = excludeNodes?.some((item) => resolveNode(item)?.contains(target));
+            const isClickAway = !isClickInside && !isClickOnExcluded;
+            if (preventBubbling) {
+                event.stopPropagation();
+                event.stopImmediatePropagation();
+            }
+            if (isClickAway) {
+                onClickAway(event, 'clickAway');
             }
         };
         window.addEventListener('pointerdown', onClick);
         return () => {
             window.removeEventListener('pointerdown', onClick);
         };
-    }, [isActive, ref]);
+    }, [isActive, ref, excludeNodes, onClickAway, preventBubbling]);
 };

package/components/useFocusTrapEffect/index.d.ts

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

package/components/useFocusTrapEffect/index.js

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

package/components/useFocusTrapEffect/useFocusTrapEffect.d.ts

@@ -0,0 +1,17 @@
+import { type Options } from 'focus-trap';
+import { type RefObject } from 'react';
+export type UseFocusTrapEffectOptions = {
+    /**
+     * Реф на DOM-ноду контейнера ловушки фокуса
+     */
+    ref: RefObject<HTMLElement | null>;
+    /**
+     * Флаг активности ловушки
+     */
+    isActive: boolean;
+} & Pick<Options, 'initialFocus' | 'fallbackFocus' | 'escapeDeactivates' | 'clickOutsideDeactivates' | 'returnFocusOnDeactivate' | 'allowOutsideClick' | 'preventScroll' | 'delayInitialFocus'>;
+/**
+ * Хук для удержания фокуса внутри указанного контейнера.
+ * Опции соответствуют конфигурации focus-trap.
+ */
+export declare const useFocusTrapEffect: ({ ref, isActive, ...options }: UseFocusTrapEffectOptions) => void;

package/components/useFocusTrapEffect/useFocusTrapEffect.js

@@ -0,0 +1,24 @@
+import { createFocusTrap } from 'focus-trap';
+import { useEffect, useRef } from 'react';
+/**
+ * Хук для удержания фокуса внутри указанного контейнера.
+ * Опции соответствуют конфигурации focus-trap.
+ */
+export const useFocusTrapEffect = ({ ref, isActive, ...options }) => {
+    const trapRef = useRef(null);
+    useEffect(() => {
+        const node = ref.current;
+        if (!isActive || !node) {
+            trapRef.current?.deactivate();
+            trapRef.current = null;
+            return;
+        }
+        const trap = createFocusTrap(node, options);
+        trapRef.current = trap;
+        trap.activate();
+        return () => {
+            trap.deactivate();
+            trapRef.current = null;
+        };
+    }, [isActive, ref]);
+};

package/node/components/DashboardSidebar/SidebarNav/SidebarNav.js

@@ -3,7 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SidebarNav = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
+const constants_1 = require("./constants");
 exports.SidebarNav = (0, react_1.forwardRef)((props, ref) => {
     const { menu } = props;
-    return (0, jsx_runtime_1.jsx)("nav", { ref: ref, children: menu });
+    return ((0, jsx_runtime_1.jsx)("nav", { ref: ref, className: constants_1.sidebarNavClassnames.root, children: menu }));
 });

package/node/components/DashboardSidebar/SidebarNav/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const sidebarNavClassnames: {
+    root: string;
+};

package/node/components/DashboardSidebar/SidebarNav/constants.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sidebarNavClassnames = void 0;
+const createUIKitClassname_1 = require("../../utils/createUIKitClassname");
+exports.sidebarNavClassnames = {
+    root: (0, createUIKitClassname_1.createUIKitClassname)('dashboard-layout-sidebar__navigation'),
+};