skillgrid 0.0.45-dev-34237-snackbar.1313454 → 0.0.46-dev-45386-progress-bar.1324867

package/dist/components/Progress/Progress.d.ts

@@ -0,0 +1,25 @@
+import { default as React } from 'react';
+import { ProgressBarProps } from './Progress.type';
+export declare const Progress: React.ForwardRefExoticComponent<ProgressBarProps & React.RefAttributes<HTMLDivElement>> & {
+    Bar: React.ForwardRefExoticComponent<ProgressBarProps & React.RefAttributes<HTMLDivElement>>;
+    Circle: React.ForwardRefExoticComponent<{
+        value: number;
+        max?: number;
+        size?: number;
+        strokeWidth?: number;
+    } & {
+        className?: string;
+        classNames?: {
+            indicator?: string;
+        };
+        style?: React.CSSProperties;
+        progressStyle?: import('./Progress.type').ProgressStyleValue;
+        finishColor?: import('./Progress.type').FinishColor;
+        trackColor?: string;
+        indicatorLabel?: React.ReactNode;
+        formatValue?: (value: number, max: number) => React.ReactNode;
+        'data-testid'?: string;
+        'aria-label'?: string;
+        'aria-labelledby'?: string;
+    } & React.RefAttributes<HTMLDivElement>>;
+};

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

@@ -0,0 +1,80 @@
+import { default as React } from 'react';
+/** Стили прогресс-бара */
+export type ProgressStyle = 'accent' | 'blue' | 'positive' | 'special' | 'warning' | 'negative';
+type CustomColor = string & {
+    __customColor?: never;
+};
+/** Стиль прогресс-бара. Может быть одним из предопределенных стилей или кастомным цветом. */
+export type ProgressStyleValue = ProgressStyle | CustomColor;
+/** Цвет для завершенного состояния прогресс-бара. Может быть одним из предопределенных стилей или кастомным цветом. */
+export type FinishColor = ProgressStyle | CustomColor;
+export declare const isProgressStyle: (value: unknown) => value is ProgressStyle;
+/** Общие свойства для всех типов прогресс-баров */
+type CommonProgressProps = {
+    /** Дополнительные CSS классы */
+    className?: string;
+    /** CSS классы для отдельных частей прогресс-бара */
+    classNames?: {
+        /** CSS класс для индикатора значения */
+        indicator?: string;
+    };
+    /** Inline-стили */
+    style?: React.CSSProperties;
+    /** Стиль прогресс-бара. Может быть одним из предопределенных стилей или кастомным цветом. */
+    progressStyle?: ProgressStyleValue;
+    /** Цвет для завершенного состояния (применяется когда прогресс достиг максимума). Может быть одним из предопределенных стилей или кастомным цветом. */
+    finishColor?: FinishColor;
+    /** Кастомный цвет трека (фона) прогресс-бара */
+    trackColor?: string;
+    /** Кастомный текст индикатора значения. Если передан, индикатор показывается автоматически. */
+    indicatorLabel?: React.ReactNode;
+    /** Функция для форматирования значения индикатора */
+    formatValue?: (value: number, max: number) => React.ReactNode;
+    /** Идентификатор для тестирования */
+    'data-testid'?: string;
+    /** ARIA метка для доступности */
+    'aria-label'?: string;
+    /** ARIA ID элемента, который описывает прогресс-бар */
+    'aria-labelledby'?: string;
+};
+/** Пропсы для линейного (несегментированного) прогресс-бара */
+export type ProgressBarLinearProps = {
+    /** Режим сегментирования (false для линейного режима) */
+    segmented?: false;
+    /** Текущее значение прогресса */
+    value: number;
+    /** Максимальное значение прогресса */
+    max?: number;
+} & CommonProgressProps;
+/** Пропсы для сегментированного прогресс-бара */
+export type ProgressBarSegmentedProps = {
+    /** Режим сегментирования (true для сегментированного режима) */
+    segmented: true;
+    /** Текущее значение прогресса (количество заполненных сегментов) */
+    value: number;
+    /** Общее количество сегментов */
+    segments?: number;
+} & CommonProgressProps;
+/** Пропсы для прогресс-бара. Может быть либо линейным, либо сегментированным. */
+export type ProgressBarProps = ProgressBarLinearProps | ProgressBarSegmentedProps;
+/**
+ * Проверяет, является ли переданный объект пропсов сегментированным прогресс-баром
+ * @param props - Пропсы прогресс-бара
+ * @returns true, если прогресс-бар сегментированный
+ */
+export declare const isSegmentedProps: (props: ProgressBarProps) => props is ProgressBarSegmentedProps;
+export type ProgressCircleSize = 24 | 32 | 36 | 40 | 48 | 56 | 64 | 84 | 96 | 120;
+export type ProgressCircleProps = {
+    /** Текущее значение прогресса */
+    value: number;
+    /** Максимальное значение прогресса */
+    max?: number;
+    /** Размер компонента в px */
+    size?: number;
+    /**
+     * Толщина обводки в px.
+     * Если не задано, берётся значение по умолчанию для ближайшего размера из гайдлайна.
+     */
+    strokeWidth?: number;
+} & CommonProgressProps;
+export {};

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

@@ -0,0 +1,2 @@
+export { Progress } from './Progress';
+export type { ProgressBarProps, ProgressBarLinearProps, ProgressBarSegmentedProps, ProgressCircleProps, ProgressCircleSize, ProgressStyle, ProgressStyleValue, FinishColor, } from './Progress.type';

package/dist/components/Progress/lib/clamp-to-range.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Ограничивает число диапазоном [min, max].
+ * Например: clampToRange(150, 0, 100) => 100
+ */
+export declare const clampToRange: (value: number, min: number, max: number) => number;

package/dist/components/Progress/lib/clamp-to-range.test.d.ts

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

package/dist/components/Progress/lib/get-circle-indicator-typography-key.d.ts

@@ -0,0 +1,6 @@
+export type CircleIndicatorTypographyKey = 'circleIndicator32' | 'circleIndicator36' | 'circleIndicator40' | 'typography-label-1-regular' | 'typography-label-2-regular' | 'typography-label-3-regular' | 'typography-label-5-regular';
+/**
+ * Возвращает ключ типографики для центрального индикатора.
+ * Часть размеров использует токены типографики, а для 32/36/40 — кастом (по гайду).
+ */
+export declare const getCircleIndicatorTypographyKey: (size: number) => CircleIndicatorTypographyKey;

package/dist/components/Progress/lib/get-circle-indicator-typography-key.test.d.ts

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

package/dist/components/Progress/lib/get-closest-circle-size.d.ts

@@ -0,0 +1,6 @@
+import { ProgressCircleSize } from '../Progress.type';
+/**
+ * Возвращает ближайший размер из гайда (используется для дефолтов, когда size кастомный).
+ * При равной дистанции выбирается меньший размер (потому что массив отсортирован по возрастанию).
+ */
+export declare const getClosestCircleSize: (size: number) => ProgressCircleSize;

package/dist/components/Progress/lib/get-closest-circle-size.test.d.ts

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

package/dist/components/Progress/lib/get-default-circle-stroke-width.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Толщины обводки.
+ * Если size кастомный — используем ближайший пресетный размер.
+ */
+export declare const getDefaultCircleStrokeWidth: (size: number) => number;

package/dist/components/Progress/lib/get-default-circle-stroke-width.test.d.ts

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

package/dist/components/Progress/lib/get-indicator-label.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+type Params = {
+    indicatorLabel?: React.ReactNode;
+    formatValue?: (value: number, max: number) => React.ReactNode;
+    clampedValue: number;
+    total: number;
+};
+export declare const getIndicatorLabel: ({ indicatorLabel, formatValue, clampedValue, total, }: Params) => React.ReactNode;
+export {};

package/dist/components/Progress/lib/get-indicator-label.test.d.ts

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

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

@@ -0,0 +1,8 @@
+export { clampToRange } from './clamp-to-range';
+export { getIndicatorLabel } from './get-indicator-label';
+export { getClosestCircleSize } from './get-closest-circle-size';
+export { getDefaultCircleStrokeWidth } from './get-default-circle-stroke-width';
+export { getCircleIndicatorTypographyKey } from './get-circle-indicator-typography-key';
+export type { CircleIndicatorTypographyKey } from './get-circle-indicator-typography-key';
+export { resolveActiveProgressStyleClass } from './resolve-active-progress-style-class';
+export { resolveCircleIndicatorClassName } from './resolve-circle-indicator-class-name';

package/dist/components/Progress/lib/resolve-active-progress-style-class.d.ts

@@ -0,0 +1,14 @@
+import { ProgressStyle } from '../Progress.type';
+type Params = {
+    progressStyle?: unknown;
+    finishColor?: unknown;
+    isFinished: boolean;
+};
+/**
+ * Возвращает активный класс стиля прогресса:
+ * - при завершении (isFinished) и если finishColor — стандартный стиль, берём finishColor
+ * - иначе, если progressStyle — стандартный стиль, берём progressStyle
+ * - иначе 'accent'
+ */
+export declare const resolveActiveProgressStyleClass: ({ progressStyle, finishColor, isFinished, }: Params) => ProgressStyle;
+export {};

package/dist/components/Progress/lib/resolve-active-progress-style-class.test.d.ts

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

package/dist/components/Progress/lib/resolve-circle-indicator-class-name.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Разрешает имя класса для индикатора кругового прогресса.
+ * Если key начинается с 'typography-', ищет в typographyCss, иначе в progressCss.
+ */
+export declare const resolveCircleIndicatorClassName: (key: string | undefined, typographyCss: Record<string, string>, progressCss: Record<string, string>) => string | undefined;

package/dist/components/Progress/lib/resolve-circle-indicator-class-name.test.d.ts

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