fui-material 2.8.4 → 2.8.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,67 @@
1
+ import { FC, ReactNode } from "react";
2
+ /**
3
+ * Варианты цветового оформления бейджа статуса из фирменной палитры fui-kit.
4
+ */
5
+ export type StatusBadgeVariant = "primary" | "secondary" | "success" | "danger" | "warning" | "info" | "light" | "dark";
6
+ /**
7
+ * Варианты размеров бейджа.
8
+ */
9
+ export type StatusBadgeSize = "sm" | "md" | "lg";
10
+ /**
11
+ * Параметры компонента FStatusBadge.
12
+ */
13
+ export interface IFStatusBadge {
14
+ /**
15
+ * Текстовое содержимое или дочерние элементы бейджа.
16
+ */
17
+ children: ReactNode;
18
+ /**
19
+ * Фирменная цветовая схема индикатора статуса.
20
+ * По умолчанию — `"secondary"`.
21
+ */
22
+ variant?: StatusBadgeVariant;
23
+ /**
24
+ * Размер бейджа (`"sm"` — компактный для плотных таблиц, `"md"` — стандартный, `"lg"` — крупный для карточек).
25
+ * По умолчанию — `"md"`.
26
+ */
27
+ size?: StatusBadgeSize;
28
+ /**
29
+ * Флаг отображения точки-индикатора перед текстом.
30
+ * По умолчанию — `true`.
31
+ */
32
+ showDot?: boolean;
33
+ /**
34
+ * Включает плавную пульсирующую анимацию для точки-индикатора.
35
+ * По умолчанию — `false`.
36
+ */
37
+ pulseDot?: boolean;
38
+ /**
39
+ * Дополнительные CSS-классы для кастомизации.
40
+ */
41
+ className?: string;
42
+ }
43
+ /**
44
+ * Компонент `FStatusBadge` — компактный бейдж-индикатор статуса в палитре fui-kit с поддержкой размеров и пульсации.
45
+ *
46
+ * @component
47
+ * @example
48
+ * <FStatusBadge variant="warning" pulseDot>
49
+ * На регистрации
50
+ * </FStatusBadge>
51
+ *
52
+ * @example
53
+ * <FStatusBadge variant="success" size="sm" showDot={false}>
54
+ * Действует
55
+ * </FStatusBadge>
56
+ *
57
+ * @param {ReactNode} children - Текст или элементы, отображаемые внутри бейджа.
58
+ * @param {StatusBadgeVariant} [variant="secondary"] - Цветовая схема из палитры fui-kit.
59
+ * @param {StatusBadgeSize} [size="md"] - Размер бейджа (`"sm"` | `"md"` | `"lg"`).
60
+ * @param {boolean} [showDot=true] - Отображать ли цветовую точку-индикатор.
61
+ * @param {boolean} [pulseDot=false] - Включить эффект мягкой пульсации точки.
62
+ * @param {string} [className=""] - Пользовательский CSS-класс.
63
+ *
64
+ * @returns {JSX.Element} Стилизованный inline-бейдж статуса.
65
+ */
66
+ declare const FStatusBadge: FC<IFStatusBadge>;
67
+ export default FStatusBadge;
@@ -0,0 +1 @@
1
+ export { default } from "./FStatusBadge";
@@ -6,27 +6,27 @@ import React, { FC } from "react";
6
6
  */
7
7
  export interface IFTableDataCell extends React.TdHTMLAttributes<HTMLTableCellElement> {
8
8
  /**
9
- * Дополнительные стили для ячейки таблицы.
9
+ * Дополнительные инлайн-стили для ячейки таблицы.
10
10
  * @type {React.CSSProperties}
11
11
  */
12
12
  st?: React.CSSProperties;
13
13
  /**
14
- * Значение rowspan для объединения строк.
14
+ * Значение rowspan для объединения строк по вертикали.
15
15
  * @type {number | undefined}
16
16
  */
17
17
  row?: number;
18
18
  /**
19
- * Значение colspan для объединения столбцов.
19
+ * Значение colspan для объединения столбцов по горизонтали.
20
20
  * @type {number | undefined}
21
21
  */
22
22
  col?: number;
23
23
  /**
24
- * Дочерние элементы (например, текст или другие компоненты).
24
+ * Дочернее содержимое ячейки (текст, число или React-элементы).
25
25
  * @type {React.ReactNode}
26
26
  */
27
27
  children?: React.ReactNode;
28
28
  /**
29
- * Выравнивание текста внутри ячейки.
29
+ * Горизонтальное выравнивание содержимого ячейки.
30
30
  * @type {'left' | 'right' | 'center' | 'justify'}
31
31
  * @default 'left'
32
32
  */
@@ -37,33 +37,54 @@ export interface IFTableDataCell extends React.TdHTMLAttributes<HTMLTableCellEle
37
37
  * @default 'auto'
38
38
  */
39
39
  height?: number | string;
40
- /** Сокращение текста; false отменяет truncateAt тела таблицы. */
40
+ /**
41
+ * Флаг сокращения текста.
42
+ * Если установлен в `false`, отменяет сокращение, даже если активен TruncateContext.
43
+ * Если `true` — включает сокращение длинного текста до правого края ячейки.
44
+ * @type {boolean | undefined}
45
+ */
41
46
  truncate?: boolean;
42
- /** Уникальный ключ столбца, совпадающий с sortKey заголовка. */
47
+ /**
48
+ * Уникальный ключ столбца, совпадающий с `sortKey` соответствующего заголовка.
49
+ * @type {string | undefined}
50
+ */
43
51
  sortKey?: string;
44
- /** Исходное значение для сортировки чисел, дат и JSX. */
52
+ /**
53
+ * Исходное нормализованное значение для сортировки чисел, дат или JSX.
54
+ * @type {string | number | undefined}
55
+ */
45
56
  sortValue?: string | number;
46
- /** Текст для поиска в пользовательском содержимом. */
57
+ /**
58
+ * Строка для фильтрации и текстового поиска по содержимому ячейки.
59
+ * @type {string | undefined}
60
+ */
47
61
  searchValue?: string;
48
62
  }
49
63
  /**
50
- * Компонент FTableDataCell представляет собой ячейку данных таблицы (`<td>`).
51
- * Он поддерживает настройку стилей, объединение строк и столбцов, а также обработку событий.
64
+ * Компонент `FTableDataCell` представляет собой ячейку данных таблицы (`<td>`).
65
+ *
66
+ * Поддерживает:
67
+ * - Выравнивание и кастомные стили;
68
+ * - Объединение строк (`rowSpan`) и столбцов (`colSpan`);
69
+ * - Автоматическое сокращение текста до самого правого края ячейки с многоточием;
70
+ * - Плавное разворачивание полного текста по клику;
71
+ * - Всплывающую подсказку (Tooltip) при наведении на сокращённый текст.
52
72
  *
53
73
  * @component
54
74
  * @example
55
- * <FTableDataCell
56
- * textAlignment="center"
57
- * height="50px"
58
- * row={2}
59
- * col={3}
60
- * onClick={() => console.log('Cell clicked!')}
61
- * >
62
- * Ячейка данных
75
+ * // Простая текстовая ячейка
76
+ * <FTableDataCell textAlignment="center" height="40px">
77
+ * 15.09.2026
78
+ * </FTableDataCell>
79
+ *
80
+ * @example
81
+ * // Ячейка с автоматическим сокращением длинного текста до правого края
82
+ * <FTableDataCell truncate textAlignment="left">
83
+ * Свияжка от истока до города Ульяновск с прилегающими водоохранными зонами
63
84
  * </FTableDataCell>
64
85
  *
65
- * @param {IFTableDataCell} props - Пропсы компонента.
66
- * @returns {JSX.Element} - Элемент данных таблицы.
86
+ * @param {IFTableDataCell} props - Входные параметры ячейки таблицы.
87
+ * @returns {JSX.Element} Отрендеренный элемент `<td>`.
67
88
  */
68
89
  declare const FTableDataCell: FC<IFTableDataCell>;
69
90
  export default FTableDataCell;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "fui-material",
3
- "version": "2.8.4",
3
+ "version": "2.8.6",
4
4
  "type": "module",
5
5
  "publishConfig": {
6
6
  "access": "public",