@cloud-ru/ds-ai-shimmer 1.0.1 → 1.1.0

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.
package/CHANGELOG.md CHANGED
@@ -3,6 +3,12 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ # 1.1.0 (2026-09-07)
7
+
8
+ ### Features
9
+
10
+ - **AIX-295:** add icon and shimmer props, rework the AiShimmer wave ([323cc8e](https://github.com/cloud-ru-tech/snack-v2/commit/323cc8e3b8d8f1476d2acc74ca8096a97e9048e0))
11
+
6
12
  ## 1.0.1 (2026-08-24)
7
13
 
8
14
  **Note:** Version bump only for package @ds/ai-shimmer
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  `@cloud-ru/ds-ai-shimmer` — Анимированный shimmer-блок для AI-сценариев с типографикой как в `@cloud-ru/ds-typography`.
4
4
 
5
- `AiShimmer` — декоративный shimmer-лоадер из набора AI Components. Shimmer-проход ограничен формой текста через `background-clip: text` на дублирующем текстовом слое; ширина контейнера и размер шрифта задают layout автоматически.
5
+ `AiShimmer` — декоративный shimmer-лоадер из набора AI Components. Брендовая волна обрезается по форме текста через `background-clip: text`; ширина контейнера и размер шрифта задают layout автоматически.
6
6
 
7
7
  ## Когда использовать
8
8
 
@@ -18,11 +18,26 @@
18
18
 
19
19
  ### Animation
20
20
 
21
- AiShimmer всегда рендерится в анимированном режиме, повторяя shimmer-проход из Figma. Градиентный слой анимируется горизонтально и обрезается по контуру текста через `background-clip: text`.
21
+ Волна повторяет спецификацию из Figma: сине-зелёная полоса шириной в две ширины строки идёт слева направо за 3 секунды, затем держит паузу 2 секунды. Цикл — 5 секунд, движение линейное и бесконечное.
22
+
23
+ Технически это градиентный слой поверх приглушённой базы, обрезанный по контуру текста через `background-clip: text`. Путь волны задан в пикселях строки через общую переменную `--ai-shimmer-x`, а не в процентах: процент считался бы от собственного бокса каждого слоя, и волна на иконке разошлась бы с волной на тексте. Ширина строки замеряется через `ResizeObserver` и `document.fonts.ready`.
24
+
25
+ При `prefers-reduced-motion: reduce` движение снимается и остаётся ровная заливка базовым цветом.
22
26
 
23
27
  ### Text
24
28
 
25
- Текст shimmer задаётся через проп `text`. Переносы строк поддерживаются символом `\n`. Многострочный текст автоматически переносится по ширине контейнера. Высота shimmer-слоя синхронизируется с layout через `ResizeObserver` и `document.fonts.ready`.
29
+ Текст shimmer задаётся через проп `text`. Переносы строк поддерживаются символом `\n`. Многострочный текст автоматически переносится по ширине контейнера.
30
+
31
+ ### Icon
32
+
33
+ Ведущая иконка перед текстом заливается той же волной, что и текст, поэтому полоса проходит сплошняком от иконки до конца строки. Размер задаётся пропом `iconSize`, по умолчанию 16 пикселей. Иконку можно передать двумя способами:
34
+
35
+ - `icon` — узел любого компонента, который рендерит `<svg>`: иконка из `@cloud-ru/ds-icons`, `AiIconGiga`, `Sun` из `@cloud-ru/ds-loader`. Узел становится маской волны, как слои `iconMask` и `icon (color)` в Figma; его собственные цвета не важны, а анимация внутри иконки сохраняется. Размер узла должен совпадать с `iconSize`.
36
+ - `iconMask` — готовый силуэт как CSS `mask-image`, обычно `url("data:image/svg+xml,…")`. Силуэт логотипа GigaChat экспортирует `@cloud-ru/ds-ai-icon-giga` под именем `GIGA_MASK_IMAGE`. Используется, когда `icon` не передан.
37
+
38
+ ### Slot after
39
+
40
+ Проп `slotAfter` добавляет хвостовой узел справа от текста — например счётчик или длительность. Волна проходит по нему той же полосой, что по тексту: координата волны общая для всей строки. База слота на тон светлее текста, как второстепенная информация в дизайн-системе. Собственный цвет слоту задавать не нужно: он должен остаться прозрачным, иначе перекроет и базу, и волну.
26
41
 
27
42
  ### Typography
28
43
 
@@ -101,9 +116,11 @@ export function CustomSize() {
101
116
  |------|------|---------|-------------|
102
117
  | `className` | `string` | — | Дополнительный класс корневого контейнера. |
103
118
  | `data-test-id` | `string` | `ai-shimmer` | |
104
- | `iconMask` | `string` | — | Силуэт ведущей иконки как CSS `mask-image` (обычно `url("data:image/svg+xml,…")`). <br/> Если задан — перед текстом рисуется иконка, залитая тем же бегущим градиентом, <br/> что и текст: блеск проходит сплошной полосой «иконка → конец строки», как будто <br/> иконка — часть текста. Иконка не несёт собственного цвета, она наследует <br/> shimmer-покрытие (приглушённая база + блик). |
105
- | `iconSize` | `number` | `16` | Размер ведущей иконки в px (квадрат). Действует только с `iconMask`. По умолчанию `16`. |
119
+ | `icon` | `ReactNode` | — | Ведущая иконка узлом — любой компонент, рендерящий `<svg>`: иконка из `@cloud-ru/ds-icons`, <br/> `AiIconGiga`, `Sun` из `@cloud-ru/ds-loader`. Узел становится маской и заливается той же волной, <br/> что текст; его собственные цвета не важны, анимация внутри иконки сохраняется. Размер <br/> узла должен совпадать с `iconSize`. Имеет приоритет над `iconMask`. |
120
+ | `iconMask` | `string` | — | Силуэт ведущей иконки как CSS `mask-image` (обычно `url("data:image/svg+xml,…")`). <br/> Заливается той же волной, что текст. Используется, когда `icon` не передан. |
121
+ | `iconSize` | `number` | `16` | Размер ведущей иконки в px (квадрат). Действует с `icon` или `iconMask`. По умолчанию `16`. |
106
122
  | `size` | `"l"` \| `"m"` \| `"s"` | `SIZE.m` | Размер типографики (`s`, `m`, `l`), как в `@cloud-ru/ds-typography`. <br/> Задаёт `data-size` и шкалу шрифта для текста shimmer. |
123
+ | `slotAfter` | `ReactNode` | — | Хвостовой слот справа от текста — например счётчик или длительность. Волна идёт <br/> по нему той же полосой; база слота на тон светлее текста. Свой цвет слоту не задавать. |
107
124
  | `text` | `string` | — | Текст, по которому рендерится shimmer. Поддерживает переносы строк через `\n`. |
108
125
  | `variant` | `"body"` \| `"display"` \| `"headline"` \| `"label"` \| `"title"` | `VARIANT.body` | Вариант типографики, как в `@cloud-ru/ds-typography`. Задаёт `data-variant` и шкалу шрифта. |
109
126
  | `weight` | `"mono"` \| `"regular"` \| `"thin"` | `WEIGHT.regular` | Начертание шрифта, как в `@cloud-ru/ds-typography`. Задаёт `data-weight`. |
@@ -1,2 +1,2 @@
1
1
  import { AiShimmerProps } from './types';
2
- export declare function AiShimmer({ text, variant, size, weight, iconMask, iconSize, className, 'data-test-id': dataTestId, ...rest }: AiShimmerProps): import("react/jsx-runtime").JSX.Element;
2
+ export declare function AiShimmer({ text, variant, size, weight, icon, iconMask, iconSize, slotAfter, className, 'data-test-id': dataTestId, ...rest }: AiShimmerProps): import("react/jsx-runtime").JSX.Element;
@@ -10,48 +10,46 @@ const classnames_1 = __importDefault(require("classnames"));
10
10
  const react_1 = require("react");
11
11
  const constants_1 = require("./constants");
12
12
  const styles_module_scss_1 = __importDefault(require('./styles.module.css'));
13
- function AiShimmer({ text, variant = constants_1.DEFAULT_VARIANT, size = constants_1.DEFAULT_SIZE, weight = constants_1.DEFAULT_WEIGHT, iconMask, iconSize = constants_1.DEFAULT_ICON_SIZE, className, 'data-test-id': dataTestId = constants_1.TEST_IDS.root, ...rest }) {
13
+ function AiShimmer({ text, variant = constants_1.DEFAULT_VARIANT, size = constants_1.DEFAULT_SIZE, weight = constants_1.DEFAULT_WEIGHT, icon, iconMask, iconSize = constants_1.DEFAULT_ICON_SIZE, slotAfter, className, 'data-test-id': dataTestId = constants_1.TEST_IDS.root, ...rest }) {
14
14
  const rootRef = (0, react_1.useRef)(null);
15
15
  const textRef = (0, react_1.useRef)(null);
16
- const fallbackHeight = (0, constants_1.fontMetricsForTypography)(variant, size, weight).lineHeight;
17
- const [contentHeight, setContentHeight] = (0, react_1.useState)(fallbackHeight);
16
+ const slotRef = (0, react_1.useRef)(null);
18
17
  const [lineWidth, setLineWidth] = (0, react_1.useState)(constants_1.DEFAULT_ROOT_WIDTH);
19
- const hasIcon = Boolean(iconMask);
18
+ const [slotOffset, setSlotOffset] = (0, react_1.useState)(0);
19
+ const gradientId = (0, react_1.useId)();
20
+ const maskId = (0, react_1.useId)();
21
+ const hasIconNode = icon != null && icon !== false;
22
+ const hasIcon = hasIconNode || Boolean(iconMask);
23
+ const hasSlotAfter = slotAfter != null && slotAfter !== false;
24
+ // Волна задана в пикселях строки, поэтому ширину и отступ слота нужно замерить.
20
25
  const measureLayout = (0, react_1.useCallback)(() => {
21
- const textNode = textRef.current;
22
- if (textNode) {
23
- const measuredContentHeight = Math.ceil(textNode.getBoundingClientRect().height);
24
- setContentHeight(prev => (Math.abs(prev - measuredContentHeight) > 0.5 ? measuredContentHeight : prev));
25
- }
26
26
  const rootNode = rootRef.current;
27
- if (rootNode) {
28
- const measuredWidth = Math.ceil(rootNode.getBoundingClientRect().width);
29
- setLineWidth(prev => (measuredWidth > 0 && Math.abs(prev - measuredWidth) > 0.5 ? measuredWidth : prev));
27
+ if (!rootNode) {
28
+ return;
29
+ }
30
+ const rootRect = rootNode.getBoundingClientRect();
31
+ const measuredWidth = Math.ceil(rootRect.width);
32
+ setLineWidth(prev => (measuredWidth > 0 && Math.abs(prev - measuredWidth) > 0.5 ? measuredWidth : prev));
33
+ const slotNode = slotRef.current;
34
+ if (slotNode) {
35
+ const measuredOffset = slotNode.getBoundingClientRect().left - rootRect.left;
36
+ setSlotOffset(prev => (Math.abs(prev - measuredOffset) > 0.5 ? measuredOffset : prev));
30
37
  }
31
38
  }, []);
32
- (0, utils_1.useLayoutEffect)(() => {
33
- setContentHeight(fallbackHeight);
34
- measureLayout();
35
- const frameId = requestAnimationFrame(() => {
36
- measureLayout();
37
- });
38
- return () => cancelAnimationFrame(frameId);
39
- }, [fallbackHeight, measureLayout, size, text, variant, weight]);
40
39
  (0, react_1.useEffect)(() => {
41
- const textNode = textRef.current;
42
- const parentNode = textRef.current?.parentElement ?? null;
43
- if (typeof ResizeObserver === 'undefined') {
40
+ measureLayout();
41
+ const rootNode = rootRef.current;
42
+ if (typeof ResizeObserver === 'undefined' || !rootNode) {
44
43
  return undefined;
45
44
  }
46
45
  const observer = new ResizeObserver(() => measureLayout());
47
- if (textNode) {
48
- observer.observe(textNode);
49
- }
50
- if (parentNode) {
51
- observer.observe(parentNode);
46
+ observer.observe(rootNode);
47
+ const slotNode = slotRef.current;
48
+ if (slotNode) {
49
+ observer.observe(slotNode);
52
50
  }
53
51
  return () => observer.disconnect();
54
- }, [measureLayout]);
52
+ }, [measureLayout, hasSlotAfter]);
55
53
  (0, react_1.useEffect)(() => {
56
54
  if (typeof document === 'undefined' || !document.fonts?.ready) {
57
55
  return undefined;
@@ -68,15 +66,18 @@ function AiShimmer({ text, variant = constants_1.DEFAULT_VARIANT, size = constan
68
66
  cancelled = true;
69
67
  };
70
68
  }, [measureLayout, size, text, variant, weight]);
71
- const spreadStartHeight = Math.max(contentHeight, fallbackHeight);
72
- const spreadEndHeight = spreadStartHeight + constants_1.END_HEIGHT_EXTRA;
73
69
  const rootStyle = (0, react_1.useMemo)(() => ({
74
- '--ai-shimmer-spread-start-height': `${spreadStartHeight}px`,
75
- '--ai-shimmer-spread-end-height': `${spreadEndHeight}px`,
76
- ...(hasIcon && {
77
- '--ai-shimmer-icon-size': `${iconSize}px`,
78
- '--ai-shimmer-line-width': `${lineWidth}px`,
79
- }),
80
- }), [hasIcon, iconSize, lineWidth, spreadEndHeight, spreadStartHeight]);
81
- return ((0, jsx_runtime_1.jsxs)("div", { ref: rootRef, className: (0, classnames_1.default)(styles_module_scss_1.default.root, className), style: rootStyle, "data-variant": variant, "data-size": size, "data-weight": weight, "data-has-icon": hasIcon || undefined, "data-test-id": dataTestId, ...(0, utils_1.extractSupportProps)(rest), children: [(0, jsx_runtime_1.jsxs)("span", { ref: textRef, className: (0, classnames_1.default)(styles_module_scss_1.default.text, styles_module_scss_1.default.textGhost), "data-test-id": constants_1.TEST_IDS.text, children: [hasIcon && (0, jsx_runtime_1.jsx)("span", { className: styles_module_scss_1.default.lead, "aria-hidden": true }), text] }), (0, jsx_runtime_1.jsx)("span", { className: styles_module_scss_1.default.shimmer, "data-test-id": constants_1.TEST_IDS.shimmer, "aria-hidden": true, children: (0, jsx_runtime_1.jsxs)("span", { className: (0, classnames_1.default)(styles_module_scss_1.default.text, styles_module_scss_1.default.shimmerText), "data-test-id": constants_1.TEST_IDS.spread, children: [hasIcon && ((0, jsx_runtime_1.jsx)("span", { className: (0, classnames_1.default)(styles_module_scss_1.default.lead, styles_module_scss_1.default.shimmerIcon), style: { maskImage: iconMask, WebkitMaskImage: iconMask }, "data-test-id": constants_1.TEST_IDS.icon })), text] }) })] }));
70
+ '--ai-shimmer-wave-gradient': constants_1.WAVE_GRADIENT,
71
+ '--ai-shimmer-wave-width': `${2 * lineWidth}px`,
72
+ ...(hasIcon && { '--ai-shimmer-icon-size': `${iconSize}px` }),
73
+ ...(hasSlotAfter && { '--ai-shimmer-slot-offset': `${slotOffset}px` }),
74
+ }), [hasIcon, hasSlotAfter, iconSize, lineWidth, slotOffset]);
75
+ let lead = null;
76
+ if (hasIconNode) {
77
+ lead = ((0, jsx_runtime_1.jsxs)("svg", { className: styles_module_scss_1.default.leadIcon, "data-test-id": constants_1.TEST_IDS.icon, "aria-hidden": true, children: [(0, jsx_runtime_1.jsxs)("defs", { children: [(0, jsx_runtime_1.jsx)("linearGradient", { id: gradientId, x1: '0', y1: '0', x2: '1', y2: '0', children: constants_1.WAVE_STOPS.map(stop => ((0, jsx_runtime_1.jsx)("stop", { offset: stop.offset, stopColor: (0, constants_1.waveStopColor)(stop), stopOpacity: stop.opacity }, stop.offset))) }), (0, jsx_runtime_1.jsx)("mask", { id: maskId, className: styles_module_scss_1.default.leadMask, maskUnits: 'userSpaceOnUse', x: '0', y: '0', width: '100%', height: '100%', children: icon })] }), (0, jsx_runtime_1.jsxs)("g", { mask: `url(#${maskId})`, children: [(0, jsx_runtime_1.jsx)("rect", { className: styles_module_scss_1.default.leadBase, width: '100%', height: '100%' }), (0, jsx_runtime_1.jsx)("rect", { className: styles_module_scss_1.default.leadWave, height: '100%', fill: `url(#${gradientId})` })] })] }));
78
+ }
79
+ else if (iconMask) {
80
+ lead = ((0, jsx_runtime_1.jsx)("span", { className: styles_module_scss_1.default.lead, style: { maskImage: iconMask, WebkitMaskImage: iconMask }, "data-test-id": constants_1.TEST_IDS.icon, "aria-hidden": true }));
81
+ }
82
+ return ((0, jsx_runtime_1.jsxs)("div", { ref: rootRef, className: (0, classnames_1.default)(styles_module_scss_1.default.root, className), style: rootStyle, "data-variant": variant, "data-size": size, "data-weight": weight, "data-has-icon": hasIcon || undefined, "data-has-slot": hasSlotAfter || undefined, "data-test-id": dataTestId, ...(0, utils_1.extractSupportProps)(rest), children: [(0, jsx_runtime_1.jsxs)("span", { ref: textRef, className: styles_module_scss_1.default.text, "data-test-id": constants_1.TEST_IDS.text, children: [lead, text] }), hasSlotAfter && ((0, jsx_runtime_1.jsx)("span", { ref: slotRef, className: styles_module_scss_1.default.slot, "data-test-id": constants_1.TEST_IDS.slot, children: slotAfter }))] }));
82
83
  }
@@ -1,10 +1,9 @@
1
- import { AiShimmerFontMetrics, AiShimmerSize, AiShimmerVariant, AiShimmerWeight } from './types';
1
+ import { AiShimmerSize, AiShimmerVariant, AiShimmerWeight } from './types';
2
2
  export declare const TEST_IDS: {
3
3
  readonly root: "ai-shimmer";
4
4
  readonly text: "ai-shimmer__text";
5
- readonly shimmer: "ai-shimmer__shimmer";
6
- readonly spread: "ai-shimmer__spread";
7
5
  readonly icon: "ai-shimmer__icon";
6
+ readonly slot: "ai-shimmer__slot";
8
7
  };
9
8
  /** Варианты типографики. */
10
9
  export declare const VARIANT: Record<AiShimmerVariant, AiShimmerVariant>;
@@ -20,28 +19,50 @@ export declare const DEFAULT_SIZE: AiShimmerSize;
20
19
  export declare const DEFAULT_WEIGHT: AiShimmerWeight;
21
20
  /** Размер ведущей иконки по умолчанию (px), когда задан `iconMask`. */
22
21
  export declare const DEFAULT_ICON_SIZE = 16;
23
- /** Fallback-метрики body regular для расчёта высоты до замера DOM. */
24
- export declare const TYPOGRAPHY_FONT_METRICS: Partial<Record<string, AiShimmerFontMetrics>>;
25
- export declare function fontMetricsForTypography(variant?: AiShimmerVariant, size?: AiShimmerSize, weight?: AiShimmerWeight): AiShimmerFontMetrics;
22
+ /** Ширина строки до первого замера DOM (SSR и первый рендер). */
23
+ export declare const DEFAULT_ROOT_WIDTH = 400;
26
24
  /**
27
- * Геометрия SVG-маски shimmer: ширина/смещение маски, типографские метрики строк
28
- * и ограничения по высоте контейнера и "хвоста" анимации.
25
+ * Стопы волны: единственный источник для CSS-градиента текста и SVG-градиента иконки.
26
+ * Цвета литералами — токенов под них в `@cloud-ru/ds-figma-variables` пока нет.
29
27
  */
30
- /** Ширина корня по умолчанию: используется до первого замера (SSR/первый рендер). */
31
- export declare const DEFAULT_ROOT_WIDTH = 400;
32
- /** Горизонтальное смещение маски относительно контейнера. */
33
- export declare const MASK_OFFSET_X = 0.6;
34
- /** Вертикальное смещение маски относительно контейнера. */
35
- export declare const MASK_OFFSET_Y = 3.892;
36
- /** Базовая линия первой текстовой строки в SVG. */
37
- export declare const BASELINE_FIRST_LINE = 9.24;
38
- /** Базовая высота маски для одной строки текста. */
39
- export declare const BASE_MASK_HEIGHT = 11.268;
40
- /** Дополнительная высота для конечной фазы spread-анимации. */
41
- export declare const END_HEIGHT_EXTRA = 40;
42
- /** Размер шрифта текста в SVG-маске. */
43
- export declare const MASK_TEXT_FONT_SIZE = 12;
44
- /** Межбуквенный интервал текста в SVG-маске. */
45
- export declare const MASK_TEXT_LETTER_SPACING = 0.1;
46
- /** Семейство шрифтов текста в SVG-маске. */
47
- export declare const MASK_TEXT_FONT_FAMILY = "'SB Sans Interface','Inter','Segoe UI',sans-serif";
28
+ export declare const WAVE_STOPS: readonly [{
29
+ readonly offset: 0;
30
+ readonly rgb: readonly [51, 140, 235];
31
+ readonly opacity: 0;
32
+ }, {
33
+ readonly offset: 0.3;
34
+ readonly rgb: readonly [51, 140, 235];
35
+ readonly opacity: 0;
36
+ }, {
37
+ readonly offset: 0.4;
38
+ readonly rgb: readonly [51, 140, 235];
39
+ readonly opacity: 1;
40
+ }, {
41
+ readonly offset: 0.48;
42
+ readonly rgb: readonly [59, 174, 209];
43
+ readonly opacity: 1;
44
+ }, {
45
+ readonly offset: 0.54;
46
+ readonly rgb: readonly [67, 208, 183];
47
+ readonly opacity: 1;
48
+ }, {
49
+ readonly offset: 0.6;
50
+ readonly rgb: readonly [52, 203, 151];
51
+ readonly opacity: 1;
52
+ }, {
53
+ readonly offset: 0.68;
54
+ readonly rgb: readonly [36, 198, 118];
55
+ readonly opacity: 1;
56
+ }, {
57
+ readonly offset: 0.78;
58
+ readonly rgb: readonly [36, 198, 118];
59
+ readonly opacity: 0;
60
+ }, {
61
+ readonly offset: 1;
62
+ readonly rgb: readonly [36, 198, 118];
63
+ readonly opacity: 0;
64
+ }];
65
+ /** Цвет стопа как CSS `rgb()`: без альфы для SVG `stop-color`, с альфой — для градиента. */
66
+ export declare function waveStopColor({ rgb: [r, g, b], opacity }: (typeof WAVE_STOPS)[number], withAlpha?: boolean): string;
67
+ /** Те же стопы как CSS `linear-gradient` — уходит в стили через `--ai-shimmer-wave-gradient`. */
68
+ export declare const WAVE_GRADIENT: string;
@@ -1,13 +1,12 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.MASK_TEXT_FONT_FAMILY = exports.MASK_TEXT_LETTER_SPACING = exports.MASK_TEXT_FONT_SIZE = exports.END_HEIGHT_EXTRA = exports.BASE_MASK_HEIGHT = exports.BASELINE_FIRST_LINE = exports.MASK_OFFSET_Y = exports.MASK_OFFSET_X = exports.DEFAULT_ROOT_WIDTH = exports.TYPOGRAPHY_FONT_METRICS = exports.DEFAULT_ICON_SIZE = exports.DEFAULT_WEIGHT = exports.DEFAULT_SIZE = exports.DEFAULT_VARIANT = exports.WEIGHT = exports.SIZE = exports.VARIANT = exports.TEST_IDS = void 0;
4
- exports.fontMetricsForTypography = fontMetricsForTypography;
3
+ exports.WAVE_GRADIENT = exports.WAVE_STOPS = exports.DEFAULT_ROOT_WIDTH = exports.DEFAULT_ICON_SIZE = exports.DEFAULT_WEIGHT = exports.DEFAULT_SIZE = exports.DEFAULT_VARIANT = exports.WEIGHT = exports.SIZE = exports.VARIANT = exports.TEST_IDS = void 0;
4
+ exports.waveStopColor = waveStopColor;
5
5
  exports.TEST_IDS = {
6
6
  root: 'ai-shimmer',
7
7
  text: 'ai-shimmer__text',
8
- shimmer: 'ai-shimmer__shimmer',
9
- spread: 'ai-shimmer__spread',
10
8
  icon: 'ai-shimmer__icon',
9
+ slot: 'ai-shimmer__slot',
11
10
  };
12
11
  /** Варианты типографики. */
13
12
  exports.VARIANT = {
@@ -37,40 +36,26 @@ exports.DEFAULT_SIZE = exports.SIZE.m;
37
36
  exports.DEFAULT_WEIGHT = exports.WEIGHT.regular;
38
37
  /** Размер ведущей иконки по умолчанию (px), когда задан `iconMask`. */
39
38
  exports.DEFAULT_ICON_SIZE = 16;
40
- const DEFAULT_FONT_METRICS = {
41
- fontSize: 16,
42
- lineHeight: 24,
43
- fontWeight: '400',
44
- };
45
- /** Fallback-метрики body regular для расчёта высоты до замера DOM. */
46
- exports.TYPOGRAPHY_FONT_METRICS = {
47
- 'regular-body-s': { fontSize: 14, lineHeight: 20, fontWeight: '400' },
48
- 'regular-body-m': DEFAULT_FONT_METRICS,
49
- 'regular-body-l': { fontSize: 20, lineHeight: 28, fontWeight: '400' },
50
- };
51
- function fontMetricsForTypography(variant = exports.DEFAULT_VARIANT, size = exports.DEFAULT_SIZE, weight = exports.DEFAULT_WEIGHT) {
52
- const key = `${weight}-${variant}-${size}`;
53
- return exports.TYPOGRAPHY_FONT_METRICS[key] ?? DEFAULT_FONT_METRICS;
54
- }
39
+ /** Ширина строки до первого замера DOM (SSR и первый рендер). */
40
+ exports.DEFAULT_ROOT_WIDTH = 400;
55
41
  /**
56
- * Геометрия SVG-маски shimmer: ширина/смещение маски, типографские метрики строк
57
- * и ограничения по высоте контейнера и "хвоста" анимации.
42
+ * Стопы волны: единственный источник для CSS-градиента текста и SVG-градиента иконки.
43
+ * Цвета литералами — токенов под них в `@cloud-ru/ds-figma-variables` пока нет.
58
44
  */
59
- /** Ширина корня по умолчанию: используется до первого замера (SSR/первый рендер). */
60
- exports.DEFAULT_ROOT_WIDTH = 400;
61
- /** Горизонтальное смещение маски относительно контейнера. */
62
- exports.MASK_OFFSET_X = 0.6;
63
- /** Вертикальное смещение маски относительно контейнера. */
64
- exports.MASK_OFFSET_Y = 3.892;
65
- /** Базовая линия первой текстовой строки в SVG. */
66
- exports.BASELINE_FIRST_LINE = 9.24;
67
- /** Базовая высота маски для одной строки текста. */
68
- exports.BASE_MASK_HEIGHT = 11.268;
69
- /** Дополнительная высота для конечной фазы spread-анимации. */
70
- exports.END_HEIGHT_EXTRA = 40;
71
- /** Размер шрифта текста в SVG-маске. */
72
- exports.MASK_TEXT_FONT_SIZE = 12;
73
- /** Межбуквенный интервал текста в SVG-маске. */
74
- exports.MASK_TEXT_LETTER_SPACING = 0.1;
75
- /** Семейство шрифтов текста в SVG-маске. */
76
- exports.MASK_TEXT_FONT_FAMILY = "'SB Sans Interface','Inter','Segoe UI',sans-serif";
45
+ exports.WAVE_STOPS = [
46
+ { offset: 0, rgb: [51, 140, 235], opacity: 0 },
47
+ { offset: 0.3, rgb: [51, 140, 235], opacity: 0 },
48
+ { offset: 0.4, rgb: [51, 140, 235], opacity: 1 },
49
+ { offset: 0.48, rgb: [59, 174, 209], opacity: 1 },
50
+ { offset: 0.54, rgb: [67, 208, 183], opacity: 1 },
51
+ { offset: 0.6, rgb: [52, 203, 151], opacity: 1 },
52
+ { offset: 0.68, rgb: [36, 198, 118], opacity: 1 },
53
+ { offset: 0.78, rgb: [36, 198, 118], opacity: 0 },
54
+ { offset: 1, rgb: [36, 198, 118], opacity: 0 },
55
+ ];
56
+ /** Цвет стопа как CSS `rgb()`: без альфы для SVG `stop-color`, с альфой — для градиента. */
57
+ function waveStopColor({ rgb: [r, g, b], opacity }, withAlpha = false) {
58
+ return withAlpha ? `rgb(${r} ${g} ${b} / ${opacity * 100}%)` : `rgb(${r} ${g} ${b})`;
59
+ }
60
+ /** Те же стопы как CSS `linear-gradient` — уходит в стили через `--ai-shimmer-wave-gradient`. */
61
+ exports.WAVE_GRADIENT = `linear-gradient(90deg, ${exports.WAVE_STOPS.map(stop => `${waveStopColor(stop, true)} ${stop.offset * 100}%`).join(', ')})`;
@@ -1,11 +1,9 @@
1
- @charset "UTF-8";
2
- @property --ai-shimmer-x{
1
+ @property --ai-shimmer-progress{
3
2
  inherits:true;
4
- initial-value:-124px;
5
- syntax:"<length>";
3
+ initial-value:-0.75;
4
+ syntax:"<number>";
6
5
  }
7
6
  .root{
8
- position:relative;
9
7
  display:block;
10
8
  box-sizing:border-box;
11
9
  width:100%;
@@ -14,12 +12,21 @@
14
12
  }
15
13
 
16
14
  .text{
15
+ animation:ai-shimmer-wave 5s linear infinite;
16
+ background-image:var(--ai-shimmer-wave-gradient), linear-gradient(var(--sn-theme-color-available-version-textSecondary, var(--sn-brand-color-text-version-secondary, rgba(65, 66, 78, 0.8))), var(--sn-theme-color-available-version-textSecondary, var(--sn-brand-color-text-version-secondary, rgba(65, 66, 78, 0.8))));
17
+ background-repeat:no-repeat;
18
+ background-position:calc(var(--ai-shimmer-progress) * var(--ai-shimmer-wave-width, 800px)) 0, 0 0;
19
+ background-origin:border-box;
20
+ background-size:var(--ai-shimmer-wave-width, 800px) 100%, 100% 100%;
17
21
  display:block;
18
22
  width:100%;
19
23
  min-width:0;
20
24
  max-width:100%;
25
+ color:transparent;
21
26
  overflow-wrap:anywhere;
22
27
  white-space:pre-line;
28
+ -webkit-background-clip:text;
29
+ background-clip:text;
23
30
  }
24
31
 
25
32
  .root[data-weight=regular][data-variant=display][data-size=s] .text{
@@ -385,76 +392,127 @@
385
392
  paragraph-spacing:var(--sn-mono-body-l-paragraphSpacing, var(--sn-primitive-font-paragraphSpacing-byFontSize16, 8px));
386
393
  }
387
394
 
388
- .textGhost{
389
- color:transparent;
395
+ .lead{
396
+ animation:ai-shimmer-wave 5s linear infinite;
397
+ background-image:var(--ai-shimmer-wave-gradient), linear-gradient(var(--sn-theme-color-available-version-textSecondary, var(--sn-brand-color-text-version-secondary, rgba(65, 66, 78, 0.8))), var(--sn-theme-color-available-version-textSecondary, var(--sn-brand-color-text-version-secondary, rgba(65, 66, 78, 0.8))));
398
+ background-repeat:no-repeat;
399
+ background-position:calc(var(--ai-shimmer-progress) * var(--ai-shimmer-wave-width, 800px)) 0, 0 0;
400
+ background-origin:border-box;
401
+ background-size:var(--ai-shimmer-wave-width, 800px) 100%, 100% 100%;
402
+ display:block;
403
+ flex-shrink:0;
404
+ width:var(--ai-shimmer-icon-size, var(--sn-primitive-dimension-16, 16px));
405
+ height:var(--ai-shimmer-icon-size, var(--sn-primitive-dimension-16, 16px));
406
+ margin-right:var(--sn-primitive-dimension-4, 4px);
407
+ -webkit-mask-repeat:no-repeat;
408
+ mask-repeat:no-repeat;
409
+ -webkit-mask-position:center;
410
+ mask-position:center;
411
+ -webkit-mask-size:var(--ai-shimmer-icon-size) var(--ai-shimmer-icon-size);
412
+ mask-size:var(--ai-shimmer-icon-size) var(--ai-shimmer-icon-size);
390
413
  }
391
414
 
392
- .shimmer{
393
- pointer-events:none;
394
- position:absolute;
395
- inset:0;
415
+ .leadIcon{
416
+ display:block;
417
+ flex-shrink:0;
418
+ width:var(--ai-shimmer-icon-size, var(--sn-primitive-dimension-16, 16px));
419
+ height:var(--ai-shimmer-icon-size, var(--sn-primitive-dimension-16, 16px));
420
+ margin-right:var(--sn-primitive-dimension-4, 4px);
421
+ animation:ai-shimmer-wave 5s linear infinite;
396
422
  overflow:hidden;
423
+ color:var(--sn-theme-color-available-version-textSecondary, var(--sn-brand-color-text-version-secondary, rgba(65, 66, 78, 0.8)));
424
+ }
425
+
426
+ .leadMask{
427
+ mask-type:alpha;
428
+ }
429
+
430
+ .leadBase{
431
+ fill:var(--sn-theme-color-available-version-textSecondary, var(--sn-brand-color-text-version-secondary, rgba(65, 66, 78, 0.8)));
397
432
  }
398
433
 
399
- .shimmerText{
400
- background-image:radial-gradient(ellipse at 66% 22%, rgb(51, 140, 235) 15%, rgb(59, 174, 209) 30%, rgb(67, 208, 183) 45%, rgb(52, 203, 151) 55%, rgb(36, 198, 118) 65%, rgba(36, 198, 118, 0) 100%), linear-gradient(var(--sn-theme-color-available-version-textSecondary, var(--sn-brand-color-text-version-secondary, rgba(65, 66, 78, 0.8))), var(--sn-theme-color-available-version-textSecondary, var(--sn-brand-color-text-version-secondary, rgba(65, 66, 78, 0.8))));
434
+ .leadWave{
435
+ transform:translateX(calc(var(--ai-shimmer-progress) * var(--ai-shimmer-wave-width, 800px)));
436
+ width:var(--ai-shimmer-wave-width, 800px);
437
+ }
438
+
439
+ .slot{
440
+ animation:ai-shimmer-wave 5s linear infinite;
441
+ background-image:var(--ai-shimmer-wave-gradient), linear-gradient(var(--sn-theme-color-available-version-textTertiary, var(--sn-brand-color-text-version-tertiary, rgba(65, 66, 78, 0.5490196078))), var(--sn-theme-color-available-version-textTertiary, var(--sn-brand-color-text-version-tertiary, rgba(65, 66, 78, 0.5490196078))));
401
442
  background-repeat:no-repeat;
402
- background-position:-124px 0, 0 0;
443
+ background-position:calc(var(--ai-shimmer-progress) * var(--ai-shimmer-wave-width, 800px)) 0, 0 0;
403
444
  background-origin:border-box;
404
- background-size:108px var(--ai-shimmer-spread-start-height), 100% 100%;
405
- animation:shimmer-text-move 3.75s linear infinite;
445
+ background-size:var(--ai-shimmer-wave-width, 800px) 100%, 100% 100%;
446
+ flex-shrink:0;
406
447
  color:transparent;
448
+ background-position:calc(calc(var(--ai-shimmer-progress) * var(--ai-shimmer-wave-width, 800px)) - var(--ai-shimmer-slot-offset, 0px)) 0, 0 0;
407
449
  -webkit-background-clip:text;
408
450
  background-clip:text;
409
451
  }
410
- .lead{
411
- display:inline-block;
412
- width:var(--ai-shimmer-icon-size, 16px);
413
- height:var(--ai-shimmer-icon-size, 16px);
414
- margin-right:var(--sn-primitive-dimension-4, 4px);
415
- vertical-align:middle;
416
- }
417
452
 
418
- .shimmerIcon{
419
- background-image:radial-gradient(ellipse at 66% 22%, rgb(51, 140, 235) 15%, rgb(59, 174, 209) 30%, rgb(67, 208, 183) 45%, rgb(52, 203, 151) 55%, rgb(36, 198, 118) 65%, rgba(36, 198, 118, 0) 100%), linear-gradient(var(--sn-theme-color-available-version-textTertiary, var(--sn-brand-color-text-version-tertiary, rgba(65, 66, 78, 0.5490196078))), var(--sn-theme-color-available-version-textTertiary, var(--sn-brand-color-text-version-tertiary, rgba(65, 66, 78, 0.5490196078))));
420
- background-repeat:no-repeat;
421
- background-position:-124px 0, 0 0;
422
- background-origin:border-box;
423
- background-size:108px var(--ai-shimmer-spread-start-height), 100% 100%;
424
- animation:shimmer-text-move 3.75s linear infinite;
425
- -webkit-mask-repeat:no-repeat;
426
- mask-repeat:no-repeat;
427
- -webkit-mask-position:center;
428
- mask-position:center;
429
- -webkit-mask-size:var(--ai-shimmer-icon-size) var(--ai-shimmer-icon-size);
430
- mask-size:var(--ai-shimmer-icon-size) var(--ai-shimmer-icon-size);
453
+ .root[data-has-icon],
454
+ .root[data-has-slot]{
455
+ display:flex;
456
+ align-items:center;
457
+ width:-moz-fit-content;
458
+ width:fit-content;
459
+ max-width:100%;
431
460
  }
432
- .root[data-has-icon] .shimmerText,
433
- .root[data-has-icon] .shimmerIcon{
434
- background-position:var(--ai-shimmer-x) 0, 0 0;
435
- background-size:108px var(--ai-shimmer-spread-start-height), 100% 100%;
436
- animation-name:shimmer-line-move;
461
+ .root[data-has-icon] .text,
462
+ .root[data-has-slot] .text{
463
+ display:flex;
464
+ align-items:center;
465
+ width:auto;
466
+ max-width:100%;
467
+ overflow-wrap:normal;
468
+ white-space:nowrap;
437
469
  }
438
470
 
439
- @keyframes shimmer-text-move{
471
+ @keyframes ai-shimmer-wave{
440
472
  0%{
441
- background-position:-124px 0, 0 0;
442
- background-size:108px var(--ai-shimmer-spread-start-height), 100% 100%;
473
+ --ai-shimmer-progress:-0.75;
474
+ }
475
+ 60%, 100%{
476
+ --ai-shimmer-progress:0.25;
477
+ }
478
+ }
479
+ @media (prefers-reduced-motion: reduce){
480
+ .text,
481
+ .lead,
482
+ .leadIcon,
483
+ .slot{
484
+ animation:none;
443
485
  }
444
- 50%{
445
- background-position:calc(100% + 124px) 0, 0 0;
446
- background-size:108px var(--ai-shimmer-spread-end-height), 100% 100%;
486
+ .text,
487
+ .lead{
488
+ background-image:linear-gradient(var(--sn-theme-color-available-version-textSecondary, var(--sn-brand-color-text-version-secondary, rgba(65, 66, 78, 0.8))), var(--sn-theme-color-available-version-textSecondary, var(--sn-brand-color-text-version-secondary, rgba(65, 66, 78, 0.8))));
447
489
  }
448
- 100%{
449
- background-position:calc(100% + 124px) 0, 0 0;
450
- background-size:108px var(--ai-shimmer-spread-end-height), 100% 100%;
490
+ .slot{
491
+ background-image:linear-gradient(var(--sn-theme-color-available-version-textTertiary, var(--sn-brand-color-text-version-tertiary, rgba(65, 66, 78, 0.5490196078))), var(--sn-theme-color-available-version-textTertiary, var(--sn-brand-color-text-version-tertiary, rgba(65, 66, 78, 0.5490196078))));
492
+ }
493
+ .leadWave{
494
+ display:none;
451
495
  }
452
496
  }
453
- @keyframes shimmer-line-move{
454
- 0%{
455
- --ai-shimmer-x:-124px;
497
+ @media (forced-colors: active){
498
+ .text,
499
+ .slot{
500
+ color:CanvasText;
501
+ background-image:none;
502
+ animation:none;
503
+ }
504
+ .lead{
505
+ background-color:CanvasText;
506
+ background-image:none;
507
+ animation:none;
508
+ }
509
+ .leadIcon{
510
+ animation:none;
511
+ }
512
+ .leadBase{
513
+ fill:CanvasText;
456
514
  }
457
- 50%, 100%{
458
- --ai-shimmer-x:calc(var(--ai-shimmer-line-width, 400px) + 124px);
515
+ .leadWave{
516
+ display:none;
459
517
  }
460
518
  }