@astral/ui 4.81.0 → 4.83.0

package/components/Onboarding/ui/StepStrategy/steps/HighlightStep/styles.d.ts

@@ -0,0 +1,25 @@
+/// <reference types="react" />
+/**
+ * Popover шага, z-index над overlay, быстрое закрытие.
+ */
+export declare const StepPopover: import("../../../../../styled").StyledComponent<import("../../../../../NewPopover").NewPopoverProps & {
+    theme?: import("@emotion/react").Theme | undefined;
+}, {}, {}>;
+export declare const PopoverBody: 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 CloseButton: import("../../../../../styled").StyledComponent<Omit<import("../../../../..").WithoutEmotionSpecific<import("@mui/material").ButtonProps>, "color" | "component" | "size" | "variant" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "TouchRippleProps" | "touchRippleRef" | "disableFocusRipple"> & {
+    variant?: "light" | "link" | "text" | "contained" | "outlined" | undefined;
+    loading?: boolean | undefined;
+    color?: "primary" | "success" | "warning" | "error" | "grey" | undefined;
+    component?: import("react").ElementType | undefined;
+    selected?: boolean | undefined;
+    size?: "large" | "medium" | undefined;
+} & Omit<import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, ""> & import("react").RefAttributes<HTMLButtonElement> & {
+    theme?: import("@emotion/react").Theme | undefined;
+}, {}, {}>;
+export declare const Content: 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/Onboarding/ui/StepStrategy/steps/HighlightStep/styles.js

@@ -0,0 +1,56 @@
+import { IconButton } from '../../../../../IconButton';
+import { NewPopover } from '../../../../../NewPopover';
+import { popoverClassnames } from '../../../../../NewPopover/constants';
+import { styled } from '../../../../../styled';
+import { ONBOARDING_Z_INDEX_OFFSET } from '../../../../constants';
+/**
+ * Popover шага, z-index над overlay, быстрое закрытие.
+ */
+export const StepPopover = styled(NewPopover) `
+  && {
+    z-index: ${({ theme }) => theme.zIndex.tooltip + ONBOARDING_Z_INDEX_OFFSET.popover};
+  }
+  
+  .${popoverClassnames.innerContainer} {
+    border-radius: calc(${({ theme }) => theme.shape.medium} * 2);
+  }
+
+  .${popoverClassnames.animatedWrapper}:not(.${popoverClassnames.animatedWrapperOpen}) {
+    animation-duration: ${({ theme }) => theme.transitions.duration.shortest}ms;
+  }
+`;
+export const PopoverBody = styled.div `
+  position: relative;
+
+  width: 400px;
+  padding: ${({ theme }) => theme.spacing(6)};
+
+  border-radius: calc(${({ theme }) => theme.shape.medium} * 2);
+
+  /* Фокус-трап ставит фокус на контейнер, браузерную рамку убираем. */
+  &:focus {
+    outline: none;
+  }
+`;
+export const CloseButton = styled(IconButton) `
+  position: absolute;
+  top: ${({ theme }) => theme.spacing(6)};
+  right: ${({ theme }) => theme.spacing(6)};
+`;
+export const Content = styled.div `
+  display: flex;
+  flex-direction: column;
+  gap: ${({ theme }) => theme.spacing(4)};
+
+  margin-bottom: ${({ theme }) => theme.spacing(6)};
+
+  &:last-child {
+    margin-bottom: 0;
+  }
+
+  /* Резерв справа под крестик — только у верхнего элемента (заголовок, а если
+     его нет — текст) */
+  & > *:first-of-type {
+    padding-right: ${({ theme }) => theme.spacing(10)};
+  }
+`;

package/components/Onboarding/ui/StepStrategy/steps/HighlightStep/useLogic/index.d.ts

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

package/components/Onboarding/ui/StepStrategy/steps/HighlightStep/useLogic/index.js

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

package/components/Onboarding/ui/StepStrategy/steps/HighlightStep/useLogic/useLogic.d.ts

@@ -0,0 +1,12 @@
+import { type ActiveStepState } from '../../../../../types';
+import { type OverlayGeometry } from '../../../useLogic';
+export type UseLogicResult = {
+    isOpen: boolean;
+    shouldShowPopover: boolean;
+    setPopoverNode: (node: HTMLElement | null) => void;
+    handleClose: () => void;
+};
+/**
+ * Логика highlight-шага: задержка popover, фокус-трап, закрытие.
+ */
+export declare const useLogic: (activeStep: ActiveStepState, isClosing: boolean, geometry: OverlayGeometry) => UseLogicResult;

package/components/Onboarding/ui/StepStrategy/steps/HighlightStep/useLogic/useLogic.js

@@ -0,0 +1,37 @@
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { useTheme } from '../../../../../../theme/hooks/useTheme';
+import { useFocusTrap } from '../../../../hooks/useFocusTrap';
+/**
+ * Логика highlight-шага: задержка popover, фокус-трап, закрытие.
+ */
+export const useLogic = (activeStep, isClosing, geometry) => {
+    const { isInteractive, isConfirming } = activeStep;
+    const { anchorEl, element, isTransitioning } = geometry;
+    const theme = useTheme();
+    const isOpen = !isClosing;
+    // Задержка до появления popover после готовности hole.
+    const isHoleReady = anchorEl !== null;
+    const [isEntered, setIsEntered] = useState(false);
+    useEffect(() => {
+        if (isEntered || !isHoleReady) {
+            return;
+        }
+        const timer = setTimeout(() => setIsEntered(true), theme.transitions.duration.shortest);
+        return () => clearTimeout(timer);
+    }, [isEntered, isHoleReady]);
+    const [popoverNode, setPopoverNode] = useState(null);
+    const trapNodes = useMemo(() => [popoverNode, isInteractive ? element : null], [popoverNode, isInteractive, element]);
+    // Трап выключен при закрытии/подтверждении.
+    useFocusTrap(trapNodes, isOpen && !isConfirming);
+    const handleClose = useCallback(() => {
+        activeStep.requestClose();
+    }, [activeStep]);
+    // При переходе popover размонтируется; при закрытии — grow-out.
+    const shouldShowPopover = !isConfirming && !isTransitioning && isEntered;
+    return {
+        isOpen,
+        shouldShowPopover,
+        setPopoverNode,
+        handleClose,
+    };
+};

package/components/Onboarding/ui/StepStrategy/steps/StandaloneStep/StandaloneStep.d.ts

@@ -0,0 +1,6 @@
+import { type StepViewProps } from '../types';
+export type StandaloneStepProps = StepViewProps;
+/**
+ * Standalone шаг-модалка.
+ */
+export declare const StandaloneStep: ({ activeStep, isClosing, }: StandaloneStepProps) => import("react/jsx-runtime").JSX.Element;

package/components/Onboarding/ui/StepStrategy/steps/StandaloneStep/StandaloneStep.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { DialogContent } from '../../../../../DialogContent';
+import { StepFooter } from '../StepFooter';
+import { Footer, StepDialog } from './styles';
+/**
+ * Standalone шаг-модалка.
+ */
+export const StandaloneStep = ({ activeStep, isClosing, }) => {
+    const { step, isConfirming, requestClose } = activeStep;
+    return (_jsxs(StepDialog, { open: !isConfirming && !isClosing, title: step.title, onClose: requestClose, size: step.dialogSize, disableAutoFocus: true, children: [_jsx(DialogContent, { children: step.content }), _jsx(Footer, { children: _jsx(StepFooter, { activeStep: activeStep }) })] }));
+};

package/components/Onboarding/ui/StepStrategy/steps/StandaloneStep/index.d.ts

@@ -0,0 +1,2 @@
+export { StandaloneStep } from './StandaloneStep';
+export type { StandaloneStepProps } from './StandaloneStep';

package/components/Onboarding/ui/StepStrategy/steps/StandaloneStep/index.js

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

package/components/Onboarding/ui/StepStrategy/steps/StandaloneStep/styles.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="react" />
+export declare const StepDialog: import("../../../../../styled").StyledComponent<import("../../../../..").WithoutEmotionSpecific<Omit<import("@mui/material").DialogProps, "title" | "maxWidth">> & {
+    title?: string | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>>[] | undefined;
+    disableBackdropClick?: boolean | undefined;
+    size?: import("../../../../../Dialog").DialogSize | undefined;
+    headerContent?: import("react").ReactNode;
+} & {
+    theme?: import("@emotion/react").Theme | undefined;
+}, {}, {}>;
+export declare const Footer: 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/Onboarding/ui/StepStrategy/steps/StandaloneStep/styles.js

@@ -0,0 +1,9 @@
+import { Dialog } from '../../../../../Dialog';
+import { styled } from '../../../../../styled';
+import { onboardingModalSurface } from '../../../styles';
+export const StepDialog = styled(Dialog) `
+  ${({ theme }) => onboardingModalSurface(theme)};
+`;
+export const Footer = styled.div `
+    padding: ${({ theme }) => theme.spacing(0, 6, 6)};
+`;

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/ProgressDots.d.ts

@@ -0,0 +1,6 @@
+import { type ActiveStepState } from '../../../../../types';
+export type ProgressDotsProps = Pick<ActiveStepState, 'position' | 'total' | 'onSelectStep'>;
+/**
+ * Индикатор прогресса точками
+ */
+export declare const ProgressDots: ({ position, total, onSelectStep, }: ProgressDotsProps) => import("react/jsx-runtime").JSX.Element;

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/ProgressDots.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cva } from '../../../../../../utils/cva';
+import { progressDotClassnames } from './constants';
+import { Dot, Dots } from './styles';
+const dotCva = cva(progressDotClassnames.root, {
+    variants: {
+        isActive: {
+            true: progressDotClassnames.active,
+        },
+    },
+});
+/**
+ * Индикатор прогресса точками
+ */
+export const ProgressDots = ({ position, total, onSelectStep, }) => (_jsx(Dots, { children: Array.from({ length: total }, (_, index) => (_jsx(Dot, { type: "button", className: dotCva({ isActive: index === position }), "aria-label": `Перейти к шагу ${index + 1}`, "aria-current": index === position, onClick: () => onSelectStep(index) }, index))) }));

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const progressDotClassnames: {
+    root: string;
+    active: string;
+};

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/constants.js

@@ -0,0 +1,5 @@
+import { createUIKitClassname } from '../../../../../../utils/createUIKitClassname';
+export const progressDotClassnames = {
+    root: createUIKitClassname('onboarding-progress-dot'),
+    active: createUIKitClassname('onboarding-progress-dot_active'),
+};

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/index.d.ts

@@ -0,0 +1,2 @@
+export { ProgressDots } from './ProgressDots';
+export type { ProgressDotsProps } from './ProgressDots';

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/index.js

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

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/styles.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="react" />
+export declare const Dots: 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 Dot: 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").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, {}>;

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/styles.js

@@ -0,0 +1,34 @@
+import { styled } from '../../../../../../styled';
+import { progressDotClassnames } from './constants';
+export const Dots = styled.div `
+  display: flex;
+  gap: ${({ theme }) => theme.spacing(1)};
+  align-items: center;
+`;
+export const Dot = styled.button `
+  cursor: pointer;
+
+  width: 8px;
+  height: 8px;
+  padding: 0;
+
+  background-color: ${({ theme }) => theme.palette.grey[200]};
+  border: none;
+  border-radius: 50%;
+
+  transition: background-color 0.2s;
+
+  &.${progressDotClassnames.active} {
+    background-color: ${({ theme }) => theme.palette.grey[600]};
+  }
+
+  /* Круглый фокус вместо браузерной рамки. */
+  &:focus {
+    outline: none;
+  }
+
+  &:focus-visible {
+    outline: 2px solid ${({ theme }) => theme.palette.components.focused};
+    outline-offset: 2px;
+  }
+`;

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/StepFooter.d.ts

@@ -0,0 +1,9 @@
+import { type ActiveStepState } from '../../../../types';
+export type StepFooterProps = {
+    activeStep: ActiveStepState;
+};
+/**
+ * Футер шага: индикатор прогресса и кнопки навигации.
+ * Общий для standalone и highlight.
+ */
+export declare const StepFooter: ({ activeStep }: StepFooterProps) => import("react/jsx-runtime").JSX.Element | null;

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/StepFooter.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button } from '../../../../../Button';
+import { Typography } from '../../../../../Typography';
+import { ProgressDots } from './ProgressDots';
+import { CenterSlot, LeftSlot, NavigationRow, RightSlot, Root } from './styles';
+import { useLogic } from './useLogic';
+/**
+ * Футер шага: индикатор прогресса и кнопки навигации.
+ * Общий для standalone и highlight.
+ */
+export const StepFooter = ({ activeStep }) => {
+    const { isPrevVisible, isNextVisible, isDotsVisible, isCounterVisible, position, total, prevButtonText, nextButtonText, nextButtonVariant, onNext, onPrev, onSelectStep, } = useLogic(activeStep);
+    // Нечего показывать — не отрисовываем пустой футер
+    if (!isPrevVisible && !isNextVisible && !isDotsVisible && !isCounterVisible) {
+        return null;
+    }
+    return (_jsx(Root, { children: _jsxs(NavigationRow, { children: [_jsx(LeftSlot, { children: isPrevVisible && (_jsx(Button, { variant: "text", onClick: onPrev, children: prevButtonText })) }), _jsxs(CenterSlot, { children: [isDotsVisible && (_jsx(ProgressDots, { position: position, total: total, onSelectStep: onSelectStep })), isCounterVisible && (_jsxs(Typography, { variant: "caption", color: "grey", colorIntensity: "600", children: [position + 1, " / ", total] }))] }), _jsx(RightSlot, { children: isNextVisible && (_jsx(Button, { "data-focus": "next", variant: nextButtonVariant, onClick: onNext, children: nextButtonText }, nextButtonVariant)) })] }) }));
+};

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/constants.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Максимум точек в индикаторе прогресса
+ */
+export declare const MAX_PROGRESS_DOTS = 6;

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/constants.js

@@ -0,0 +1,4 @@
+/**
+ * Максимум точек в индикаторе прогресса
+ */
+export const MAX_PROGRESS_DOTS = 6;

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/index.d.ts

@@ -0,0 +1,2 @@
+export { StepFooter } from './StepFooter';
+export type { StepFooterProps } from './StepFooter';

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/index.js

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

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/styles.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="react" />
+export declare const Root: 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 NavigationRow: 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 LeftSlot: 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 CenterSlot: 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 RightSlot: 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/Onboarding/ui/StepStrategy/steps/StepFooter/styles.js

@@ -0,0 +1,28 @@
+import { styled } from '../../../../../styled';
+export const Root = styled.div `
+  display: flex;
+  flex-direction: column;
+  gap: ${({ theme }) => theme.spacing(2)};
+
+  width: 100%;
+  padding:0;
+`;
+export const NavigationRow = styled.div `
+  display: grid;
+  grid-template-columns: 1fr auto 1fr;
+  align-items: center;
+`;
+export const LeftSlot = styled.div `
+  display: flex;
+  justify-content: flex-start;
+`;
+export const CenterSlot = styled.div `
+  display: flex;
+  flex-direction: column;
+  gap: ${({ theme }) => theme.spacing(1)};
+  align-items: center;
+`;
+export const RightSlot = styled.div `
+  display: flex;
+  justify-content: flex-end;
+`;

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/useLogic/index.d.ts

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

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/useLogic/index.js

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

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/useLogic/useLogic.d.ts

@@ -0,0 +1,16 @@
+import { type ActiveStepState } from '../../../../../types';
+export type UseLogicResult = {
+    isPrevVisible: boolean;
+    isNextVisible: boolean;
+    isDotsVisible: boolean;
+    isCounterVisible: boolean;
+    position: number;
+    total: number;
+    prevButtonText: string;
+    nextButtonText: string;
+    nextButtonVariant: 'text' | 'contained';
+    onNext: () => void;
+    onPrev: () => void;
+    onSelectStep: (position: number) => void;
+};
+export declare const useLogic: (activeStep: ActiveStepState) => UseLogicResult;

package/components/Onboarding/ui/StepStrategy/steps/StepFooter/useLogic/useLogic.js

@@ -0,0 +1,22 @@
+import { MAX_PROGRESS_DOTS } from '../constants';
+export const useLogic = (activeStep) => {
+    const { step, position, total, hasNext, hasPrev, isDotsVisible, isCounterVisible, buttons, onNext, onPrev, onSelectStep, } = activeStep;
+    // Прогресс имеет смысл только при total > 1.
+    const hasProgress = total > 1;
+    // Последний шаг: кнопка «вперёд» превращается в завершающую.
+    const isFinishStep = !hasNext;
+    return {
+        isPrevVisible: step.isPrevButtonVisible && hasPrev,
+        isNextVisible: step.isNextButtonVisible,
+        isDotsVisible: isDotsVisible && hasProgress && total <= MAX_PROGRESS_DOTS,
+        isCounterVisible: isCounterVisible && hasProgress,
+        position,
+        total,
+        prevButtonText: buttons.prevLabel,
+        nextButtonText: isFinishStep ? buttons.finishLabel : buttons.nextLabel,
+        nextButtonVariant: isFinishStep ? buttons.finishVariant : 'contained',
+        onNext,
+        onPrev,
+        onSelectStep,
+    };
+};

package/components/Onboarding/ui/StepStrategy/steps/types.d.ts

@@ -0,0 +1,16 @@
+import { type ActiveStepState } from '../../../types';
+import { type OverlayGeometry } from '../useLogic';
+/**
+ * Контракт step-view, передаётся стратегией по типу шага.
+ */
+export type StepViewProps = {
+    activeStep: ActiveStepState;
+    /**
+     * Тур в процессе закрытия
+     */
+    isClosing: boolean;
+    /**
+     * Геометрия подсветки (единый источник для overlay и popover).
+     */
+    geometry: OverlayGeometry;
+};

package/components/Onboarding/ui/StepStrategy/steps/types.js

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

package/components/Onboarding/ui/StepStrategy/useLogic/index.d.ts

@@ -0,0 +1 @@
+export { useLogic, type OverlayGeometry } from './useLogic';

package/components/Onboarding/ui/StepStrategy/useLogic/index.js

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

package/components/Onboarding/ui/StepStrategy/useLogic/useLogic.d.ts

@@ -0,0 +1,47 @@
+import { type ActiveStepState } from '../../../types';
+import { type VirtualAnchor } from '../../../utils/createVirtualAnchor';
+import { type Rect } from '../../../utils/geometry';
+/**
+ * Геометрия подсветки, общая для overlay и popover.
+ */
+export type OverlayGeometry = {
+    /**
+     * Область hole (null для standalone или пока элемент не найден).
+     */
+    hole: Rect | null;
+    /**
+     * Якорь popover (null пока нет hole).
+     */
+    anchorEl: VirtualAnchor | null;
+    /**
+     * Подсвечиваемый элемент (null для standalone или пока не найден).
+     */
+    element: HTMLElement | null;
+    /**
+     * Hole движется между элементами.
+     */
+    isTransitioning: boolean;
+};
+export type UseLogicResult = {
+    geometry: OverlayGeometry;
+    /**
+     * Показывать ли overlay.
+     */
+    shouldShowOverlay: boolean;
+    /**
+     * Overlay виден.
+     */
+    isVisible: boolean;
+    /**
+     * Hole анимируется.
+     */
+    isHoleMoving: boolean;
+    /**
+     * Клик по overlay — запрос выхода.
+     */
+    onOverlayClose: () => void;
+};
+/**
+ * Логика стратегии: держит единый overlay на весь тур.
+ */
+export declare const useLogic: (activeStep: ActiveStepState, isClosing: boolean) => UseLogicResult;

package/components/Onboarding/ui/StepStrategy/useLogic/useLogic.js

@@ -0,0 +1,51 @@
+import { useCallback, useMemo, useRef } from 'react';
+import { useTheme } from '../../../../theme/hooks/useTheme';
+import { createVirtualAnchor, } from '../../../utils/createVirtualAnchor';
+import { inflateRect, parseOffset } from '../../../utils/geometry';
+import { useStepTransition } from '../../hooks/useStepTransition';
+import { useTargetAnchor } from '../../hooks/useTargetAnchor';
+/**
+ * Логика стратегии: держит единый overlay на весь тур.
+ */
+export const useLogic = (activeStep, isClosing) => {
+    const { step, onError } = activeStep;
+    const theme = useTheme();
+    const isHighlight = step.type === 'highlight';
+    const { element, rect } = useTargetAnchor(step.name, {
+        onError,
+        // Трекинг только для highlight-шага.
+        shouldTrack: isHighlight,
+        scrollOnEnter: true,
+        timeout: step.waitForTimeout,
+    });
+    const padding = parseOffset(step.highlightOffset);
+    const hole = useMemo(() => (rect ? inflateRect(rect, padding) : null), [rect, padding]);
+    const anchorEl = useMemo(() => (hole ? createVirtualAnchor(hole) : null), [hole]);
+    const { isPopoverHidden, isHoleMoving } = useStepTransition(step.name, {
+        // Popover скрыт пока hole движется.
+        popoverHiddenMs: theme.transitions.duration.short,
+        holeMovingMs: theme.transitions.duration.short,
+        hasHole: isHighlight,
+    });
+    const onOverlayClose = useCallback(() => {
+        activeStep.requestClose();
+    }, [activeStep]);
+    // Overlay залипает на весь тур после первого показа (без моргания).
+    const wantsOverlay = hole !== null || !isHighlight;
+    const hasShownOverlayRef = useRef(false);
+    if (wantsOverlay) {
+        hasShownOverlayRef.current = true;
+    }
+    return {
+        geometry: {
+            hole,
+            anchorEl,
+            element,
+            isTransitioning: isPopoverHidden,
+        },
+        shouldShowOverlay: hasShownOverlayRef.current,
+        isVisible: !isClosing,
+        isHoleMoving,
+        onOverlayClose,
+    };
+};

package/components/Onboarding/ui/hooks/useActiveStep/index.d.ts

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

package/components/Onboarding/ui/hooks/useActiveStep/index.js

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

package/components/Onboarding/ui/hooks/useActiveStep/useActiveStep.d.ts

@@ -0,0 +1,6 @@
+import { type ActiveStepStore } from '../../../core/ActiveStepStore';
+import { type ActiveStepState } from '../../../types';
+/**
+ * Подписка на активный шаг из store экземпляра.
+ */
+export declare const useActiveStep: (store: ActiveStepStore) => ActiveStepState | null;

package/components/Onboarding/ui/hooks/useActiveStep/useActiveStep.js

@@ -0,0 +1,7 @@
+// TODO После ухода с React 17 — заменить импорт на `react` и убрать use-sync-external-store.
+// https://track.astral.ru/soft/browse/UIKIT-3285
+import { useSyncExternalStore } from 'use-sync-external-store/shim';
+/**
+ * Подписка на активный шаг из store экземпляра.
+ */
+export const useActiveStep = (store) => useSyncExternalStore(store.subscribe, store.getActiveStep, store.getActiveStep);

package/components/Onboarding/ui/hooks/useDelayedActiveStep/index.d.ts

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

package/components/Onboarding/ui/hooks/useDelayedActiveStep/index.js

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

package/components/Onboarding/ui/hooks/useDelayedActiveStep/useDelayedActiveStep.d.ts

@@ -0,0 +1,15 @@
+import { type ActiveStepState } from '../../../types';
+export type DelayedActiveStep = {
+    /**
+     * Шаг, удержанный на экране на время закрытия.
+     */
+    active: ActiveStepState | null;
+    /**
+     * Анимация закрытия в процессе.
+     */
+    isClosing: boolean;
+};
+/**
+ * Откладывает обнуление шага на время закрытия анимаций.
+ */
+export declare const useDelayedActiveStep: (active: ActiveStepState | null, exitDurationMs: number) => DelayedActiveStep;

package/components/Onboarding/ui/hooks/useDelayedActiveStep/useDelayedActiveStep.js

@@ -0,0 +1,19 @@
+import { useEffect, useState } from 'react';
+/**
+ * Откладывает обнуление шага на время закрытия анимаций.
+ */
+export const useDelayedActiveStep = (active, exitDurationMs) => {
+    const [displayedStep, setDisplayedStep] = useState(active);
+    useEffect(() => {
+        if (active) {
+            setDisplayedStep(active);
+            return;
+        }
+        const timer = setTimeout(() => setDisplayedStep(null), exitDurationMs);
+        return () => clearTimeout(timer);
+    }, [active, exitDurationMs]);
+    return {
+        active: displayedStep,
+        isClosing: displayedStep !== null && active === null,
+    };
+};