@astral/ui 4.49.0 → 4.50.0

package/components/NewStepper/Step/styles.js

@@ -0,0 +1,303 @@
+import { NextOutlineMd } from '../../../icons/NextOutlineMd';
+import { Button } from '../../Button';
+import { styled } from '../../styled';
+import { typographyClassnames } from '../../Typography/constants';
+import { stepIconClassnames } from '../StepIcon/constants';
+import { stepClassnames } from './constants';
+export const Wrapper = styled.div `
+  display: flex;
+  gap: ${({ theme }) => theme.microSpacing(5)};
+  align-items: center;
+
+  &.${stepClassnames.alternativeLabel} {
+    position: relative;
+
+    flex: 1;
+    flex-direction: column;
+
+    & .${stepClassnames.labelContainer} {
+      flex-direction: column;
+
+      text-align: center;
+    }
+
+    &:first-of-type {
+      & .${stepClassnames.connector} {
+        display: none;
+      }
+    }
+  }
+
+  &.${stepClassnames.connectorArrow} {
+    & .${stepClassnames.content} {
+      padding: ${({ theme }) => theme.microSpacing(5, 0)};
+    }
+    
+    &:not(:first-of-type) .${stepClassnames.content} {
+      margin-left: ${({ theme }) => theme.spacing(2)};
+    }
+
+    &:last-of-type .${stepClassnames.connector} {
+      display: none;
+    }
+  }
+
+  &.${stepClassnames.connectorLine} {
+    &.${stepClassnames.orientationHorizontal} {
+      & .${stepClassnames.content} {
+        align-items: center;
+
+        padding: ${({ theme }) => theme.spacing(0, 1)};
+      }
+
+    
+      &.${stepClassnames.alternativeLabel} {
+        & .${stepClassnames.content} {
+          padding: ${({ theme }) => theme.microSpacing(3, 0)};
+        }
+      }
+    }
+
+    &.${stepClassnames.orientationVertical} {
+      & .${stepClassnames.content} {
+        padding: ${({ theme }) => theme.spacing(1, 0, 0)};
+      }
+
+      & .${stepClassnames.connector}:not(.${stepClassnames.hasDescription}) {
+        margin-bottom: ${({ theme }) => theme.microSpacing(1)};
+      }
+
+      &:last-of-type {
+        & .${stepClassnames.description} {
+          min-height: 0;
+          margin: 0;
+          padding-left: ${({ theme }) => theme.spacing(6)};
+
+          border-left: none;
+
+          ${({ theme }) => theme.breakpoints.down('sm')} {
+            padding-left: ${({ theme }) => theme.spacing(7)};
+          }
+        }
+
+        & .${stepClassnames.connector} {
+          display: none;
+        }
+      }
+
+      &:last-of-type {
+        & .${stepClassnames.content} {
+          padding: ${({ theme }) => theme.spacing(1, 0)};
+    
+          & .${stepClassnames.description} {
+            margin-bottom: 0;
+          }
+        }
+      }
+
+      & .${stepClassnames.labelMobile} {
+        display: none;
+      }
+
+      & .${stepClassnames.label} {
+        display: block;
+      }
+    }
+  }
+
+  & .${stepClassnames.content} {
+    &.${stepClassnames.active} {
+      & .${stepClassnames.label} {
+        color: ${({ theme }) => theme.palette.grey[900]};
+      }
+
+      & .${stepIconClassnames.root} {
+        color: ${({ theme }) => theme.palette.primary[800]};
+
+        &.${stepIconClassnames.success} {
+          color: ${({ theme }) => theme.palette.success[800]};
+        }
+
+        &.${stepIconClassnames.error} {
+          color: ${({ theme }) => theme.palette.error[800]};
+        }
+
+        &.${stepIconClassnames.warning} {
+          color: ${({ theme }) => theme.palette.warning[800]};
+        }
+      }
+    }
+  }
+`;
+export const IconWrapper = styled.div `
+  display: flex;
+
+  & .${stepIconClassnames.root} {
+    width: 20px;
+    height: 20px;
+
+    color: ${({ theme }) => theme.palette.grey[300]};
+    
+    transition: ${({ theme }) => theme.transitions.create(['color'], {
+    duration: theme.transitions.duration.shorter,
+})};
+
+    &.${stepIconClassnames.active} {
+      color: ${({ theme }) => theme.palette.primary[800]};
+    }
+
+    &.${stepIconClassnames.success} {
+      color: ${({ theme }) => theme.palette.success[800]};
+    }
+
+    &.${stepIconClassnames.error} {
+      color: ${({ theme }) => theme.palette.error[800]};
+    }
+
+    &.${stepIconClassnames.warning} {
+      color: ${({ theme }) => theme.palette.warning[800]};
+    }
+
+    ${({ theme }) => theme.breakpoints.down('sm')} {
+      width: 24px;
+      height: 24px;
+    }
+  }
+`;
+export const ArrowConnector = styled(NextOutlineMd) `
+  width: 20px;
+  height: 20px;
+
+  color: ${({ theme }) => theme.palette.grey[400]};
+
+  ${({ theme }) => theme.breakpoints.down('sm')} {
+    width: 24px;
+    height: 24px;
+  }
+`;
+export const LineConnector = styled.div `
+  flex: 1 1 auto;
+
+  height: 2px;
+
+  border-top: 2px solid ${({ theme }) => theme.palette.grey[300]};
+
+  &.${stepClassnames.alternativeLabel} {
+    position: absolute;
+    top: 15px;
+    right: calc(50% + 14px);
+    left: calc(-50% + 14px);
+  }
+
+  &.${stepClassnames.orientationVertical} {
+    min-height: 16px;
+
+    /* Смещение необходимо для центрирования линии относительно иконки, т.к. линия шириной 2px, то для выравнивания необходимо число не кратное 2ум  */
+    margin-left: 9px;
+
+    border-top: unset;
+    border-left: 2px solid ${({ theme }) => theme.palette.grey[300]};
+
+    ${({ theme }) => theme.breakpoints.down('sm')} {
+      margin-left: 11px;
+    }
+  }
+`;
+export const LabelWrapper = styled.div `
+  display: flex;
+  gap: ${({ theme }) => theme.spacing(1)};
+  align-items: center;
+
+  color: ${({ theme }) => theme.palette.grey[600]};
+
+  & .${typographyClassnames.root} {
+    transition: ${({ theme }) => theme.transitions.create(['color'], {
+    duration: theme.transitions.duration.shorter,
+})};
+  }
+
+  ${({ theme }) => theme.breakpoints.down('sm')} {
+    white-space: nowrap;
+  }
+`;
+export const StepContentWrapper = styled.div `
+  display: flex;
+  flex-direction: column;
+  gap: ${({ theme }) => theme.spacing(1)};
+
+  ${({ theme }) => theme.breakpoints.down('sm')} {
+    gap: ${({ theme }) => theme.microSpacing(1)};
+  }
+`;
+export const StyledButton = styled(Button) `
+  cursor: pointer;
+
+  display: flex;
+  flex-direction: column;
+  gap: ${({ theme }) => theme.spacing(1)};
+  align-items: flex-start;
+  justify-content: flex-start;
+
+  width: 100%;
+  height: auto;
+  padding: 0;
+
+  background: transparent;
+  border: 0;
+
+  ${({ theme }) => theme.breakpoints.down('sm')} {
+    gap: ${({ theme }) => theme.microSpacing(1)};
+  }
+
+  &:hover {
+    background: transparent;
+
+    & .${stepClassnames.label} {
+      color: ${({ theme }) => theme.palette.grey[700]};
+    }
+
+    & .${stepIconClassnames.root} {
+      color: ${({ theme }) => theme.palette.primary[700]};
+
+      &.${stepIconClassnames.success} {
+        color: ${({ theme }) => theme.palette.success[700]};
+      }
+
+      &.${stepIconClassnames.error} {
+        color: ${({ theme }) => theme.palette.error[700]};
+      }
+
+      &.${stepIconClassnames.warning} {
+        color: ${({ theme }) => theme.palette.warning[700]};
+      }
+    }
+  }
+
+  &:active {
+    background: transparent;
+    & .${stepClassnames.label} {
+      color: ${({ theme }) => theme.palette.grey[900]};
+    }
+
+    & .${stepIconClassnames.root} {
+      color: ${({ theme }) => theme.palette.primary[800]};
+
+      &.${stepIconClassnames.success} {
+        color: ${({ theme }) => theme.palette.success[800]};
+      }
+
+      &.${stepIconClassnames.error} {
+        color: ${({ theme }) => theme.palette.error[800]};
+      }
+
+      &.${stepIconClassnames.warning} {
+        color: ${({ theme }) => theme.palette.warning[700]};
+      }
+    }
+  }
+
+  &:focus-visible {
+    border-radius: ${({ theme }) => theme.shape.medium};
+    outline: 1px solid ${({ theme }) => theme.palette.components.focused};
+  }
+`;

package/components/NewStepper/Step/types.d.ts

@@ -0,0 +1,44 @@
+import type { ReactNode } from 'react';
+import type { StepIconProps } from '../StepIcon';
+export type StepProps = {
+    /**
+     * Название шага
+     */
+    label: ReactNode;
+    /**
+     * Флаг ошибки шага
+     */
+    isError?: boolean;
+    /**
+     * Завершённость шага. Если не передан — считается по `activeStep` (как раньше: пройдены шаги с меньшим `stepId`).
+     */
+    isCompleted?: boolean;
+    /**
+     * Флаг предупреждения шага
+     */
+    isWarning?: boolean;
+    /**
+     * Флаг блокировки шага
+     */
+    isDisabled?: boolean;
+    /**
+     * Дополнительный текст шага
+     */
+    children?: ReactNode;
+    /**
+     * Функция вызываемая при клике на шаг
+     */
+    onClick?: (stepId: number) => void;
+    /**
+     * Кастомный компонент иконки
+     */
+    icon?: (props: Omit<StepIconProps, 'icon'>) => ReactNode;
+    /**
+     * Класс применяемый к корневому элементу
+     */
+    className?: string;
+    /**
+     * ID шага
+     */
+    stepId: number;
+};

package/components/NewStepper/Step/types.js

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

package/components/NewStepper/Step/useLogic/index.d.ts

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

package/components/NewStepper/Step/useLogic/index.js

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

package/components/NewStepper/Step/useLogic/useLogic.d.ts

@@ -0,0 +1,23 @@
+/// <reference types="react" />
+import type { StepProps } from '../types';
+type UseLogicParams = StepProps;
+export declare const useLogic: ({ stepId, isCompleted, onClick, children, isError, isWarning, icon, label, isDisabled, className, }: UseLogicParams) => {
+    isCompletedStep: boolean;
+    isRenderButton: boolean;
+    handleClick: () => void;
+    connectorVariant: "line" | "arrow";
+    alternativeLabel: boolean;
+    orientation: "horizontal" | "vertical";
+    stepId: number;
+    children: import("react").ReactNode;
+    isError: boolean | undefined;
+    isWarning: boolean | undefined;
+    icon: ((props: Omit<import("../../StepIcon").StepIconProps, "icon">) => import("react").ReactNode) | undefined;
+    className: string | undefined;
+    label: import("react").ReactNode;
+    isRenderVerticalLineConnector: boolean;
+    isRenderHorizontalLineConnector: boolean;
+    isDisabled: boolean;
+    isActiveStep: boolean;
+};
+export {};

package/components/NewStepper/Step/useLogic/useLogic.js

@@ -0,0 +1,55 @@
+import { useContext, useEffect } from 'react';
+import { StepperContext } from '../../StepperContext';
+export const useLogic = ({ stepId, isCompleted, onClick, children, isError, isWarning, icon, label, isDisabled, className, }) => {
+    const { connector, activeStep, orientation, alternativeLabel, onClickPrevStep, onClickStep, } = useContext(StepperContext);
+    useEffect(() => {
+        const hasDescription = Boolean(children);
+        const isValidForDescription = orientation === 'vertical' &&
+            connector === 'line' &&
+            alternativeLabel === false;
+        if (hasDescription && !isValidForDescription) {
+            // biome-ignore lint/suspicious/noConsole: Сообщение для интеграторов
+            console.error('Stepper: description можно использовать только с комбинацией:\n' +
+                'orientation="vertical", connector="line", alternativeLabel=false');
+        }
+    }, []);
+    const isCompletedStep = isCompleted !== undefined ? isCompleted : activeStep > stepId;
+    const isClickableStep = Boolean(onClick) ||
+        Boolean(onClickStep) ||
+        (Boolean(onClickPrevStep) && isCompletedStep);
+    const isDisabledFromPrevOnlyMode = Boolean(onClickPrevStep) && !isClickableStep;
+    const isDisabledStep = Boolean(isDisabled) || isDisabledFromPrevOnlyMode;
+    const isRenderButton = Boolean(onClick) || Boolean(onClickPrevStep) || Boolean(onClickStep);
+    const handleClick = () => {
+        if (isDisabledStep) {
+            return;
+        }
+        if (isCompletedStep && onClickPrevStep) {
+            onClickPrevStep(stepId);
+        }
+        onClickStep?.(stepId);
+        onClick?.(stepId);
+    };
+    const isRenderVerticalLineConnector = connector === 'line' && orientation === 'vertical' && !children;
+    const isRenderHorizontalLineConnector = connector === 'line' && orientation === 'horizontal' && alternativeLabel;
+    const isActiveStep = activeStep === stepId;
+    return {
+        isCompletedStep,
+        isRenderButton,
+        handleClick,
+        connectorVariant: connector,
+        alternativeLabel,
+        orientation,
+        stepId,
+        children,
+        isError,
+        isWarning,
+        icon,
+        className,
+        label,
+        isRenderVerticalLineConnector,
+        isRenderHorizontalLineConnector,
+        isDisabled: isDisabledStep,
+        isActiveStep,
+    };
+};

package/components/NewStepper/StepIcon/StepIcon.d.ts

@@ -0,0 +1,28 @@
+import type { ReactNode } from 'react';
+export type StepIconProps = {
+    /**
+     * Флаг активности шага
+     */
+    isActive?: boolean;
+    /**
+     * Флаг завершенности шага
+     */
+    isCompleted?: boolean;
+    /**
+     * Флаг ошибки шага
+     */
+    isError?: boolean;
+    /**
+     * Флаг предупреждения шага
+     */
+    isWarning?: boolean;
+    /**
+     * Класс применяемый к корневому элементу
+     */
+    className?: string;
+    /**
+     * Кастомный компонент иконки
+     */
+    icon?: (props: Omit<StepIconProps, 'icon'>) => ReactNode;
+};
+export declare const StepIcon: ({ icon: Icon, isActive, isCompleted, isError, isWarning, }: StepIconProps) => import("react/jsx-runtime").JSX.Element;

package/components/NewStepper/StepIcon/StepIcon.js

@@ -0,0 +1,34 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { StepDefaultFillMd } from '../../../icons/StepDefaultFillMd';
+import { StepErrorFillMd } from '../../../icons/StepErrorFillMd';
+import { StepSuccessFillMd } from '../../../icons/StepSuccessFillMd';
+import { cva } from '../../utils/cva';
+import { stepIconClassnames } from './constants';
+const stepIcon = cva(stepIconClassnames.root, {
+    variants: {
+        isActive: {
+            true: stepIconClassnames.active,
+        },
+        isCompleted: {
+            true: stepIconClassnames.success,
+        },
+        isError: {
+            true: stepIconClassnames.error,
+        },
+        isWarning: {
+            true: stepIconClassnames.warning,
+        },
+    },
+});
+export const StepIcon = ({ icon: Icon, isActive, isCompleted, isError, isWarning, }) => {
+    if (Icon) {
+        return (_jsx(Icon, { isActive: isActive, isCompleted: isCompleted, isError: isError, isWarning: isWarning, className: stepIcon({ isActive, isCompleted, isError, isWarning }) }));
+    }
+    if (isError && !isActive) {
+        return _jsx(StepErrorFillMd, { className: stepIcon({ isError: true }) });
+    }
+    if ((isCompleted && !isActive) || (isCompleted && isWarning && !isActive)) {
+        return (_jsx(StepSuccessFillMd, { className: stepIcon({ isCompleted: true, isWarning }) }));
+    }
+    return (_jsx(StepDefaultFillMd, { className: stepIcon({ isActive, isCompleted, isError, isWarning }) }));
+};

package/components/NewStepper/StepIcon/constants.d.ts

@@ -0,0 +1,7 @@
+export declare const stepIconClassnames: {
+    root: string;
+    active: string;
+    error: string;
+    warning: string;
+    success: string;
+};

package/components/NewStepper/StepIcon/constants.js

@@ -0,0 +1,8 @@
+import { createUIKitClassname } from '../../utils/createUIKitClassname';
+export const stepIconClassnames = {
+    root: createUIKitClassname('step__icon'),
+    active: createUIKitClassname('step__icon_active'),
+    error: createUIKitClassname('step__icon_error'),
+    warning: createUIKitClassname('step__icon_warning'),
+    success: createUIKitClassname('step__icon_success'),
+};

package/components/NewStepper/StepIcon/index.d.ts

@@ -0,0 +1,2 @@
+export { StepIcon, type StepIconProps } from './StepIcon';
+export { stepIconClassnames } from './constants';

package/components/NewStepper/StepIcon/index.js

@@ -0,0 +1,2 @@
+export { StepIcon } from './StepIcon';
+export { stepIconClassnames } from './constants';

package/components/NewStepper/StepperContext/StepperContext.d.ts

@@ -0,0 +1,11 @@
+/// <reference types="react" />
+export type StepperContextProps = {
+    activeStep: number;
+    setActiveStep: (step: number) => void;
+    orientation: 'horizontal' | 'vertical';
+    connector: 'arrow' | 'line';
+    alternativeLabel: boolean;
+    onClickPrevStep?: (index: number) => void;
+    onClickStep?: (index: number) => void;
+};
+export declare const StepperContext: import("react").Context<StepperContextProps>;

package/components/NewStepper/StepperContext/StepperContext.js

@@ -0,0 +1,10 @@
+import { createContext } from 'react';
+export const StepperContext = createContext({
+    activeStep: 0,
+    setActiveStep: () => undefined,
+    orientation: 'horizontal',
+    connector: 'line',
+    alternativeLabel: false,
+    onClickPrevStep: () => undefined,
+    onClickStep: () => undefined,
+});

package/components/NewStepper/StepperContext/StepperContextProvider/StepperContextProvider.d.ts

@@ -0,0 +1,7 @@
+import { type ReactNode } from 'react';
+import { type StepperContextProps } from '../StepperContext';
+type Props = StepperContextProps & {
+    children: ReactNode;
+};
+export declare const StepperContextProvider: ({ children, orientation, activeStep, setActiveStep, connector, alternativeLabel, onClickPrevStep, onClickStep, }: Props) => import("react/jsx-runtime").JSX.Element;
+export {};

package/components/NewStepper/StepperContext/StepperContextProvider/StepperContextProvider.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { StepperContext } from '../StepperContext';
+export const StepperContextProvider = ({ children, orientation, activeStep, setActiveStep, connector, alternativeLabel, onClickPrevStep, onClickStep, }) => {
+    const contextValue = useMemo(() => ({
+        activeStep,
+        orientation,
+        setActiveStep,
+        connector,
+        alternativeLabel,
+        onClickPrevStep,
+        onClickStep,
+    }), [
+        activeStep,
+        orientation,
+        setActiveStep,
+        connector,
+        alternativeLabel,
+        onClickPrevStep,
+        onClickStep,
+    ]);
+    return (_jsx(StepperContext.Provider, { value: contextValue, children: children }));
+};

package/components/NewStepper/StepperContext/StepperContextProvider/index.d.ts

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

package/components/NewStepper/StepperContext/StepperContextProvider/index.js

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

package/components/NewStepper/StepperContext/index.d.ts

@@ -0,0 +1,2 @@
+export * from './StepperContext';
+export * from './StepperContextProvider';

package/components/NewStepper/StepperContext/index.js

@@ -0,0 +1,2 @@
+export * from './StepperContext';
+export * from './StepperContextProvider';

package/components/NewStepper/constants.d.ts

@@ -0,0 +1,12 @@
+export declare const stepperClassnames: {
+    root: string;
+    lineConnector: string;
+    arrowConnector: string;
+    orientationHorizontal: string;
+    orientationVertical: string;
+    alternativeLabel: string;
+};
+/**
+ * Задержка перед scrollIntoView после смены activeStep, что бы анимация появления текста завершилась
+ */
+export declare const MOBILE_ACTIVE_STEP_SCROLL_DEFER_MS = 300;

package/components/NewStepper/constants.js

@@ -0,0 +1,13 @@
+import { createUIKitClassname } from '../utils/createUIKitClassname';
+export const stepperClassnames = {
+    root: createUIKitClassname('stepper'),
+    lineConnector: createUIKitClassname('stepper_connector-line'),
+    arrowConnector: createUIKitClassname('stepper_connector-arrow'),
+    orientationHorizontal: createUIKitClassname('stepper_orientation-horizontal'),
+    orientationVertical: createUIKitClassname('stepper_orientation-vertical'),
+    alternativeLabel: createUIKitClassname('stepper_alternative-label'),
+};
+/**
+ * Задержка перед scrollIntoView после смены activeStep, что бы анимация появления текста завершилась
+ */
+export const MOBILE_ACTIVE_STEP_SCROLL_DEFER_MS = 300;

package/components/NewStepper/index.d.ts

@@ -0,0 +1,4 @@
+export { NewStepper } from './NewStepper';
+export { Step, type StepProps, stepClassnames } from './Step';
+export type { StepperProps } from './types';
+export { stepIconClassnames } from './StepIcon';

package/components/NewStepper/index.js

@@ -0,0 +1,3 @@
+export { NewStepper } from './NewStepper';
+export { Step, stepClassnames } from './Step';
+export { stepIconClassnames } from './StepIcon';

package/components/NewStepper/public.d.ts

@@ -0,0 +1,4 @@
+export { NewStepper } from './NewStepper';
+export { Step, type StepProps, stepClassnames } from './Step';
+export { stepIconClassnames } from './StepIcon';
+export type { StepperProps } from './types';

package/components/NewStepper/public.js

@@ -0,0 +1,3 @@
+export { NewStepper } from './NewStepper';
+export { Step, stepClassnames } from './Step';
+export { stepIconClassnames } from './StepIcon';

package/components/NewStepper/styles.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="react" />
+export declare const Wrapper: 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>, {}>;