skillgrid 0.0.36 → 0.0.39

package/dist/components/Snackbar/Provider/SnackbarProvider.d.ts

@@ -0,0 +1,9 @@
+import { FC, default as React } from 'react';
+interface SnackbarProviderProps {
+    /** Дочерние элементы */
+    children: React.ReactNode;
+    /** Тестовый id по умолчанию для обертки Snackbar */
+    dataTestId?: string;
+}
+export declare const SnackbarProvider: FC<SnackbarProviderProps>;
+export {};

package/dist/components/Snackbar/Provider/SnackbarProvider.type.d.ts

@@ -0,0 +1,69 @@
+import { SnackbarProps } from '../Snackbar.type';
+/**
+ * Параметры, которые можно передать в метод `show()` для отображения Snackbar.
+ * Наследует все пропсы Snackbar, кроме управляемых провайдером (`open`, `onClose`).
+ */
+export type ShowSnackbarProps = Omit<SnackbarProps, 'open' | 'onClose' | 'isStack'> & {
+    /**
+     * Контейнер, в котором Snackbar будет показан (по умолчанию — `document.body`).
+     */
+    parent?: HTMLElement;
+};
+/**
+ * Внутреннее представление Snackbar, используемое внутри провайдера.
+ * Содержит служебные поля состояния (`id`, `open`, `exiting`).
+ */
+export interface InternalSnackbar extends ShowSnackbarProps {
+    /** Уникальный идентификатор Snackbar. Генерируется автоматически. */
+    id: string;
+    /** Флаг отображения Snackbar. */
+    open: boolean;
+    /** Флаг завершения анимации (используется при скрытии). */
+    exiting?: boolean;
+    /** Флаг, указывающий, что Snackbar когда-либо находился в стеке */
+    wasInStack?: boolean;
+}
+/**
+ * Интерфейс контекста Snackbar-провайдера.
+ * Позволяет вызывать отображение Snackbar из любого места приложения.
+ */
+export interface SnackbarManagerContextProps {
+    /**
+     * Отображает Snackbar с указанными параметрами.
+     * @param options Параметры Snackbar (контент, тип, autoHideDuration и т.д.)
+     */
+    show: (options: ShowSnackbarProps) => void;
+}
+/**
+ * Состояние Snackbar-провайдера.
+ * Хранит список видимых Snackbar и очередь ожидающих.
+ */
+export type State = {
+    /** Snackbar, которые сейчас отображаются. */
+    visible: InternalSnackbar[];
+    /** Snackbar, ожидающие своей очереди для показа. */
+    queue: InternalSnackbar[];
+};
+/**
+ * Действия, обрабатываемые редьюсером Snackbar-провайдера.
+ */
+export type Action = 
+/** Добавляет новый Snackbar в очередь. */
+{
+    type: 'ENQUEUE';
+    snack: InternalSnackbar;
+}
+/** Перемещает следующий Snackbar из очереди в список видимых. */
+ | {
+    type: 'SHOW_NEXT';
+}
+/** Начинает анимацию скрытия Snackbar с указанным `id`. */
+ | {
+    type: 'START_EXIT';
+    id: string;
+}
+/** Полностью удаляет Snackbar из списка видимых. */
+ | {
+    type: 'REMOVE';
+    id: string;
+};

package/dist/components/Snackbar/Provider/index.d.ts

@@ -0,0 +1,2 @@
+export { SnackbarProvider } from './SnackbarProvider';
+export type { SnackbarManagerContextProps, Action, State } from './SnackbarProvider.type';

package/dist/components/Snackbar/Snackbar.d.ts

@@ -0,0 +1,2 @@
+import { SnackbarProps } from './Snackbar.type';
+export declare const Snackbar: import('react').ForwardRefExoticComponent<SnackbarProps & import('react').RefAttributes<HTMLDivElement>>;

package/dist/components/Snackbar/Snackbar.type.d.ts

@@ -0,0 +1,74 @@
+export type Reason = 'timeout' | 'close' | 'escape' | 'swipe';
+/**
+ * Свойства компонента Snackbar.
+ * Определяют внешний вид, поведение и содержимое уведомления.
+ */
+export type SnackbarProps = {
+    /**
+     * Флаг видимости Snackbar.
+     * Управляется извне (обычно провайдером).
+     */
+    open: boolean;
+    /**
+     * Вариант отображения, определяющий цвет и иконку уведомления.
+     * @default 'info'
+     */
+    variant?: 'info' | 'error' | 'success' | 'loading';
+    /**
+     * Режим отображения Snackbar:
+     * - `fix` — фиксированная ширина,
+     * - `fill` — растягивается на всю доступную ширину,
+     * - `hug` — подстраивается под контент.
+     * @default 'fix'
+     */
+    mode?: 'fix' | 'fill' | 'hug';
+    /**
+     * Колбэк, вызываемый при закрытии Snackbar (например, по кнопке или таймеру).
+     */
+    onClose?: () => void;
+    /**
+     * Время автозакрытия Snackbar (в миллисекундах).
+     * Если не указано — Snackbar не скрывается автоматически.
+     */
+    autoHideDuration?: number;
+    /**
+     * Контент уведомления.
+     * Может быть текстом, JSX-элементом или компонентом.
+     */
+    content: React.ReactNode;
+    /**
+     * Отключает автоматическое скрытие Snackbar.
+     * @default false
+     */
+    disableAutoHide?: boolean;
+    /**
+     * Отображать ли кнопку закрытия (например, крестик).
+     * @default true
+     */
+    showButtonClose?: boolean;
+    /**
+     * Показывать ли иконку в Snackbar (в зависимости от варианта).
+     * @default true
+     */
+    showIcon?: boolean;
+    /**
+     * Класс для корневого элемента Snackbar (для кастомной стилизации).
+     */
+    classNameSnackbarRoot?: string;
+    /**
+     * Кастомная иконка, заменяющая стандартную для выбранного варианта.
+     */
+    icon?: React.ReactNode;
+    /**
+     * testId для тестирования
+     */
+    'data-testid'?: string;
+    /**
+     * Несколько ли снекбаров в стеке
+     */
+    isStack?: boolean;
+    /**
+     * Если true — Snackbar начнёт анимацию закрытия извне
+     */
+    forceClose?: boolean;
+};

package/dist/components/Snackbar/assets/close.d.ts

@@ -0,0 +1 @@
+export declare const CloseIcon: () => import("react/jsx-runtime").JSX.Element;

package/dist/components/Snackbar/assets/error.d.ts

@@ -0,0 +1,3 @@
+export declare const ErrorIcon: ({ className }: {
+    className: string;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/components/Snackbar/assets/index.d.ts

@@ -0,0 +1,4 @@
+export { CloseIcon } from './close';
+export { ErrorIcon } from './error';
+export { InfoIcon } from './info';
+export { SuccessIcon } from './success';

package/dist/components/Snackbar/assets/info.d.ts

@@ -0,0 +1,3 @@
+export declare const InfoIcon: ({ className }: {
+    className: string;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/components/Snackbar/assets/success.d.ts

@@ -0,0 +1,3 @@
+export declare const SuccessIcon: ({ className }: {
+    className: string;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/components/Snackbar/index.d.ts

@@ -0,0 +1,2 @@
+export { useSnackbar } from './lib';
+export { SnackbarProvider } from './Provider/SnackbarProvider';

package/dist/components/Snackbar/lib/constants.d.ts

@@ -0,0 +1,6 @@
+import { default as styles } from '../Snackbar.module.css';
+import { Reason } from '../Snackbar.type';
+export declare const animationMap: Record<Reason, keyof typeof styles>;
+export declare const durationMap: Record<Reason, number>;
+export declare const stackDurationMap: Record<Reason, number>;
+export declare const MAX_VISIBLE = 3;

package/dist/components/Snackbar/lib/index.d.ts

@@ -0,0 +1,4 @@
+export { useSnackbar, SnackbarContext } from './useSnackbar';
+export * from './constants';
+export { snackbarReducer } from './snackbarReducer';
+export { useSwipe } from './useSwipe';

package/dist/components/Snackbar/lib/snackbarReducer/index.d.ts

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

package/dist/components/Snackbar/lib/snackbarReducer/snackbarReducer.d.ts

@@ -0,0 +1,2 @@
+import { Action, State } from '../../Provider';
+export declare const snackbarReducer: (state: State, action: Action) => State;

package/dist/components/Snackbar/lib/useSnackbar.d.ts

@@ -0,0 +1,3 @@
+import { SnackbarManagerContextProps } from '../Provider';
+export declare const SnackbarContext: import('react').Context<SnackbarManagerContextProps | undefined>;
+export declare const useSnackbar: () => SnackbarManagerContextProps;

package/dist/components/Snackbar/lib/useSwipe.d.ts

@@ -0,0 +1,52 @@
+import { MutableRefObject } from 'react';
+import { Reason } from '../Snackbar.type';
+interface ISwipeParams {
+    /**
+     * Реф на DOM-элемент Snackbar.
+     */
+    ref: MutableRefObject<HTMLDivElement | null>;
+    /**
+     * Флаг, показывающий открыт ли Snackbar.
+     */
+    open: boolean;
+    /**
+     * Колбэк вызывается при закрытии Snackbar.
+     * @param reason - причина закрытия: 'swipe', 'close', 'timeout' или 'escape'.
+     */
+    onClose: (reason: Reason) => void;
+    /**
+     * Функция для управления состоянием выхода (анимации).
+     * @param value - true, если Snackbar начинает выходить, иначе false.
+     */
+    setExiting: (value: boolean) => void;
+    /**
+     * Функция для установки причины закрытия.
+     * @param reason - причина закрытия: 'swipe', 'close', 'timeout' или 'escape'.
+     */
+    setExitReason: (reason?: Reason) => void;
+    /**
+     * Реф-флаг, показывающий, что сейчас выполняется свайп.
+     */
+    swiping: MutableRefObject<boolean>;
+    /**
+     * Реф для хранения стартовой X координаты касания.
+     */
+    startX: MutableRefObject<number>;
+    /**
+     * Реф для хранения стартовой Y координаты касания.
+     */
+    startY: MutableRefObject<number>;
+    /**
+     * Реф для хранения текущей X координаты пальца.
+     */
+    currentX: MutableRefObject<number>;
+    /**
+     * Реф для хранения текущей Y координаты пальца.
+     */
+    currentY: MutableRefObject<number>;
+}
+/**
+ * Хук useSwipe добавляет обработку свайпов
+ */
+export declare const useSwipe: ({ ref, open, onClose, setExiting, setExitReason, swiping, startX, startY, currentX, currentY, }: ISwipeParams) => void;
+export {};

package/dist/components/Trigger/Trigger.d.ts

@@ -0,0 +1,5 @@
+import { TriggerCommonProps } from './Trigger.type';
+/**
+ Component Trigger
+ */
+export declare const Trigger: ({ content, size, description, label, stretched, selectionStyle, clearable, error, prefixIcon, postfixTitle, disabled, open, onClear, classNames, styles, }: TriggerCommonProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/Trigger/Trigger.type.d.ts

@@ -0,0 +1,98 @@
+import { ReactNode, CSSProperties } from 'react';
+export type TriggerSize = 'XL' | 'L' | 'M' | 'S' | 'XS';
+/**
+ * Состояния отображения label в компоненте Trigger
+ */
+export declare enum LabelState {
+    /** Обычное отображение label */
+    NORMAL = "normal",
+    /** Floating label (для XL размера с контентом) */
+    FLOATING = "floating",
+    /** Скрытый label (для не-XL размеров с контентом) */
+    HIDDEN = "hidden"
+}
+/**
+ * Основные пропсы компонента Trigger
+ */
+export type TriggerCommonProps = {
+    /** Состояние триггера  */
+    open: boolean;
+    /** Контент, отображаемый в триггере */
+    content?: string;
+    /** Заголовок label */
+    label?: string;
+    /** Размер компонента */
+    size?: TriggerSize;
+    /** Описание под компонентом */
+    description?: string;
+    /** Растянуть компонент на всю ширину */
+    stretched?: boolean;
+    /** Стиль выделения: 'selected' - обычное состояние, 'applied' - применённое с возможностью очистки */
+    selectionStyle?: 'selected' | 'applied';
+    /** Показывать ли иконку очистки (XIcon) при selectionStyle = 'selected' */
+    clearable?: boolean;
+    /** Иконка перед контентом */
+    prefixIcon?: ReactNode;
+    /** Текст после контента */
+    postfixTitle?: string;
+    /** Текст ошибки */
+    error?: string;
+    /** Дизейбл компонент */
+    disabled?: boolean;
+    /** Обработчик очистки поля (вызывается при клике на X-иконку в режиме 'applied') */
+    onClear?: () => void;
+    /**
+     * Дополнительные классы для:
+     * @wrapper для обертки
+     * @triggerContainer для контейнера триггера
+     * @chevronIcon для иконки состояния открытия
+     * @prefixIconContainer для контейнера префиксной иконки
+     * @clearIcon для иконки очистки
+     * @triggerContent для контейнера контента
+     * @content для контента
+     * @label для лейбла
+     * @postfixTitle для постфикса
+     * @description для описания
+     * @error для ошибки
+     */
+    classNames?: {
+        wrapper?: string;
+        triggerContainer?: string;
+        chevronIcon?: string;
+        prefixIconContainer?: string;
+        clearIcon?: string;
+        triggerContent?: string;
+        content?: string;
+        label?: string;
+        postfixTitle?: string;
+        description?: string;
+        error?: string;
+    };
+    /**
+     * Дополнительные стили для:
+     * @wrapper для обертки
+     * @triggerContainer для контейнера триггера
+     * @chevronIcon для иконки состояния открытия
+     * @prefixIconContainer для контейнера префиксной иконки
+     * @clearIcon для иконки очистки
+     * @triggerContent для контейнера контента
+     * @content для контента
+     * @label для лейбла
+     * @postfixTitle для постфикса
+     * @description для описания
+     * @error для ошибки
+     */
+    styles?: {
+        wrapper?: CSSProperties;
+        triggerContainer?: CSSProperties;
+        chevronIcon?: CSSProperties;
+        prefixIconContainer?: CSSProperties;
+        clearIcon?: CSSProperties;
+        triggerContent?: CSSProperties;
+        content?: CSSProperties;
+        label?: CSSProperties;
+        postfixTitle?: CSSProperties;
+        description?: CSSProperties;
+        error?: CSSProperties;
+    };
+};

package/dist/components/Trigger/assets/ChevronIcon.d.ts

@@ -0,0 +1,16 @@
+export interface ChevronIconProps {
+    /** Дополнительные CSS классы */
+    className?: string;
+    /** Инлайн стили */
+    style?: React.CSSProperties;
+    /** Размер иконки */
+    size?: 'xxxs' | 'xxs' | 'xs' | 'sm' | 'md' | 'lg';
+    /** Цвет иконки */
+    color?: string;
+    /** Дополнительные пропсы */
+    [key: string]: unknown;
+}
+/**
+ * Компонент иконки ^
+ */
+export declare const ChevronIcon: React.FC<ChevronIconProps>;

package/dist/components/Trigger/assets/index.d.ts

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

package/dist/components/Trigger/index.d.ts

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

package/dist/components/Trigger/lib/utils.d.ts

@@ -0,0 +1,29 @@
+import { TypographySize } from '../../Typography/Typography.type';
+import { LabelState, TriggerSize } from '../Trigger.type';
+/**
+ * Определяет состояние label на основе параметров компонента
+ *
+ * @param size - размер компонента
+ * @param hasContent - есть ли контент в триггере
+ * @returns состояние label
+ */
+export declare const getLabelState: (size: TriggerSize, hasContent: boolean) => LabelState;
+/**
+ * Определяет размер типографики для label в зависимости от размера компонента
+ */
+export declare const getLabelTypographySize: (size: TriggerSize, isFloating: boolean) => TypographySize;
+/**
+ * Определяет размер типографики для контента в зависимости от размера компонента
+ */
+export declare const getContentTypographySize: (size: TriggerSize) => TypographySize;
+/**
+ * Определяет размер иконки в зависимости от размера компонента
+ */
+export declare const getIconSize: (size: TriggerSize) => "xs" | "sm";
+/**
+ * Обрезает текст content если он превышает 30 символов
+ *
+ * @param content - текст для обрезки
+ * @returns обрезанный текст с многоточием или исходный текст
+ */
+export declare const truncateContent: (content: string) => string;

package/dist/components/Trigger/lib/utils.test.d.ts

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