@vkontakte/vkui-tokens 4.25.0 → 4.25.1

package/interfaces/general/elevation/index.d.ts

@@ -5,8 +5,25 @@ export interface Elevation {
      * @tags elevation
      */
     elevation4: Property.BoxShadow;
+    /**
+     * @desc Параметры тени уровень 3
+     * @tags elevation
+     */
     elevation3: Property.BoxShadow;
+    /**
+     * @desc Параметры тени уровень 2
+     * @tags elevation
+     */
     elevation2: Property.BoxShadow;
+    /**
+     * @desc Параметры тени уровень 1. Самая маленькая
+     * @tags elevation
+     */
     elevation1: Property.BoxShadow;
+    /**
+     * @desc Параметры тени уровень 1. Самая маленькая. Инвертированная.
+     *       Для элементов появляющихся в нижней части окна
+     * @tags elevation
+     */
     elevation1InvertY: Property.BoxShadow;
 }

package/interfaces/general/geometry/index.d.ts

@@ -1,70 +1,349 @@
 export interface Sizes {
+    /**
+     * @desc Legacy
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeSelectIconPadding: number;
+    /**
+     * @desc Legacy
+     * @tags size, legacy
+     * @deprecated
+     */
     sizePopupBasePadding: number;
+    /**
+     * @desc Legacy
+     * @tags size, legacy
+     * @deprecated
+     */
     sizePopupHeaderPadding: number;
+    /**
+     * @desc Legacy
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeFieldHorizontalPadding: number;
+    /**
+     * @desc Legacy
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeButtonPaddingHorizontal: number;
+    /**
+     * @desc Legacy
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeArrowPadding: number;
+    /**
+     * @desc Значение основного радиуса закругления
+     * @tags size, stroke
+     */
     sizeBorderRadius: number;
+    /**
+     * @desc Legacy
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeCheckBorderRadius: number;
+    /**
+     * @desc Значение основного радиуса закругления
+     * @tags size, stroke
+     */
     sizeBorderRadiusPaper: number;
+    /**
+     * @desc Значение радиуса закругления всплывающих окон и промо плашек
+     * @tags size, stroke
+     */
     sizeBorderRadiusPromo: number;
+    /**
+     * @desc Высота полей ввода, селектов и других похожих компонентов
+     * @tags size, component
+     */
     sizeFieldHeight: number;
+    /**
+     * @desc Высота маленьких кнопок
+     * @tags size, component
+     */
     sizeButtonSmallHeight: number;
+    /**
+     * @desc Высота больших кнопок
+     * @tags size, component
+     */
     sizeButtonLargeHeight: number;
+    /**
+     * @desc Высота средних кнопок
+     * @tags size, component
+     */
     sizeButtonMediumHeight: number;
+    /**
+     * @desc Legacy
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeCheckbox: number;
+    /**
+     * @desc Legacy
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeArrow: number;
+    /**
+     * @desc Legacy
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeArrowPromo: number;
+    /**
+     * @desc Legacy
+     * @tags size, legacy
+     * @deprecated
+     */
     sizePopupSmall: number;
+    /**
+     * @desc Legacy
+     * @tags size, legacy
+     * @deprecated
+     */
     sizePopupMedium: number;
+    /**
+     * @desc Legacy
+     * @tags size, legacy
+     * @deprecated
+     */
     sizePopupLarge: number;
+    /**
+     * @desc Legacy
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeLabelHorizontalMargin: number;
+    /**
+     * @desc Legacy
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeTooltipMargin: number;
+    /**
+     * @desc Legacy
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeIconUI: number;
+    /**
+     * @desc Legacy. Размер аватара. В компоненте VKUI задается вручную, токен не используется
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeAvatarXS: number;
+    /**
+     * @desc Legacy. Размер аватара. В компоненте VKUI задается вручную, токен не используется
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeAvatarS: number;
+    /**
+     * @desc Legacy. Размер аватара. В компоненте VKUI задается вручную, токен не используется
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeAvatarM: number;
+    /**
+     * @desc Legacy. Размер аватара. В компоненте VKUI задается вручную, токен не используется
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeAvatarL: number;
+    /**
+     * @desc Legacy. Размер аватара. В компоненте VKUI задается вручную, токен не используется
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeAvatarXL: number;
+    /**
+     * @desc Legacy. Размер беджа. В компоненте VKUI задается вручную, токен не используется
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeBadgeXS: number;
+    /**
+     * @desc Legacy. Размер беджа. В компоненте VKUI задается вручную, токен не используется
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeBadgeS: number;
+    /**
+     * @desc Legacy. Размер беджа. В компоненте VKUI задается вручную, токен не используется
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeBadgeM: number;
+    /**
+     * @desc Legacy. Размер беджа. В компоненте VKUI задается вручную, токен не используется
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeBadgeL: number;
+    /**
+     * @desc Legacy. Размер беджа. В компоненте VKUI задается вручную, токен не используется
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeBadgeXL: number;
+    /**
+     * @desc Основной отступ между карточками в компоненте Card
+     * @tags size, component
+     */
     sizeCardgridPadding: number;
+    /**
+     * @desc Радиус закругления в компоненте Card
+     * @tags size, component
+     */
     sizeCardBorderRadius: number;
+    /**
+     * @desc Вертикальный отступ в компоненте Card
+     * @tags size, component
+     */
     sizeCardgridPaddingVertical: number;
+    /**
+     * @desc Основной горизонтальный отступ
+     * @tags size
+     */
     sizeBasePaddingHorizontal: number;
+    /**
+     * @desc Основной вертикальный отступ
+     * @tags size
+     */
     sizeBasePaddingVertical: number;
+    /**
+     * @desc Отступ между кнопками в компоненте ButtonGroup заданный вручную
+     * @tags size, component
+     */
     sizeButtonGroupGapSpace: number;
+    /**
+     * @desc Отступ между кнопками в компоненте ButtonGroup маленький
+     * @tags size, component
+     */
     sizeButtonGroupGapSmall: number;
+    /**
+     * @desc Отступ между кнопками в компоненте ButtonGroup средний
+     * @tags size, component
+     */
     sizeButtonGroupGapMedium: number;
+    /**
+     * @desc Размер отступа в выпадающих списках для создания иерархии
+     * @tags size, component
+     */
     sizeOptionHierarchy: number;
+    /**
+     * @desc Высота компонента Switch
+     * @tags size, component
+     */
     sizeSwitchHeight: number;
+    /**
+     * @desc Ширина компонента Switch
+     * @tags size, component
+     */
     sizeSwitchWidth: number;
+    /**
+     * @desc Размер пина компонента Switch
+     * @tags size, component
+     */
     sizeSwitchPin: number;
+    /**
+     * @desc Высота компонента PanelHeader
+     * @tags size, component
+     */
     sizePanelHeaderHeight: number;
+    /**
+     * @desc Legacy
+     * @tags size, legacy
+     * @deprecated
+     */
     sizeSearchHeight: number;
+    /**
+     * @desc Горизонтальный отступ для маленьких кнопок до текста
+     * @tags size, component
+     */
     sizeButtonBaseSmallPaddingHorizontal: number;
+    /**
+     * @desc Горизонтальный отступ для средних кнопок до текста
+     * @tags size, component
+     */
     sizeButtonBaseMediumPaddingHorizontal: number;
+    /**
+     * @desc Горизонтальный отступ для больших кнопок до текста
+     * @tags size, component
+     */
     sizeButtonBaseLargePaddingHorizontal: number;
+    /**
+     * @desc Горизонтальный отступ для маленьких кнопок до иконок
+     * @tags size, component
+     */
     sizeButtonBaseSmallPaddingHorizontalIcon: number;
+    /**
+     * @desc Горизонтальный отступ для средних кнопок до иконок
+     * @tags size, component
+     */
     sizeButtonBaseMediumPaddingHorizontalIcon: number;
+    /**
+     * @desc Горизонтальный отступ для больших кнопок до иконок
+     * @tags size, component
+     */
     sizeButtonBaseLargePaddingHorizontalIcon: number;
+    /**
+     * @desc Горизонтальный отступ в третичных маленьких кнопках
+     * @tags size, component
+     */
     sizeButtonTertiarySmallPaddingHorizontal: number;
+    /**
+     * @desc Горизонтальный отступ в третичных средних кнопках
+     * @tags size, component
+     */
     sizeButtonTertiaryMediumPaddingHorizontal: number;
+    /**
+     * @desc Горизонтальный отступ в третичных больших кнопках
+     * @tags size, component
+     */
     sizeButtonTertiaryLargePaddingHorizontal: number;
+    /**
+     * @desc Горизонтальный отступ в третичных маленьких кнопках до иконок
+     * @tags size, component
+     */
     sizeButtonTertiarySmallPaddingHorizontalIcon: number;
+    /**
+     * @desc Горизонтальный отступ в третичных средних кнопках до иконок
+     * @tags size, component
+     */
     sizeButtonTertiaryMediumPaddingHorizontalIcon: number;
+    /**
+     * @desc Горизонтальный отступ в третичных больших кнопках до иконок
+     * @tags size, component
+     */
     sizeButtonTertiaryLargePaddingHorizontalIcon: number;
+    /**
+     * @desc Минимальная ширина в компоненте Button
+     * @tags size, component
+     */
     sizeButtonMinimumWidth: number;
+    /**
+     * @desc Вертикальный отступ в компоненте FormItem
+     * @tags size, component
+     */
     sizeFormItemPaddingVertical: number;
     /**
      * @desc Отступ для компонента SplitCol
-     * @tags size,component
+     * @tags size, component
      */
     sizeSplitColPaddingHorizontal: number;
+    /**
+     * @desc Расстояние между элементами в компоненте SubnavigationBar
+     * @tags size, component
+     */
     sizeSubnavigationBarGap: number;
+    /**
+     * @desc Вертикальный отступ в компоненте SubnavigationBar
+     * @tags size, component
+     */
     sizeSubnavigationBarPaddingVertical: number;
 }

package/interfaces/general/gradients/index.d.ts

@@ -5,6 +5,14 @@ export interface Gradients {
      * @tags gradient
      */
     gradientBlack: GradientPoints;
+    /**
+     * @desc Параметры градиента белого цвета
+     * @tags gradient
+     */
     gradientWhite: GradientPoints;
+    /**
+     * @desc Параметры градиента нейтрального цвета
+     * @tags gradient
+     */
     gradientTint: GradientPoints;
 }

package/interfaces/general/index.d.ts

@@ -18,8 +18,8 @@ type AdaptiveTokens = {
 };
 export interface ColorsScheme {
     /**
-     * @desc Legacy
-     * @tags color,legacy
+     * @desc Цветовая схема темы
+     * @tags service
      * @deprecated
      */
     colorsScheme: 'light' | 'dark';
@@ -33,12 +33,24 @@ export interface ColorsFinal extends Colors, ColorsScheme {
 }
 export interface SpecialTokens {
     /**
-     * @desc Legacy
-     * @tags legacy
+     * @desc Имя темы
+     * @tags service
      */
     themeName: string;
+    /**
+     * @desc Имя темы, от которой наследуется текущая
+     * @tags service
+     */
     themeNameBase?: string;
+    /**
+     * @desc Имя темы, от которой наследуются значения при инкрементальной сборке
+     * @tags service
+     */
     themeInheritsFrom?: string;
+    /**
+     * @desc Префикс токенов
+     * @tags service
+     */
     prefix?: string;
 }
 export interface WithThemeType {
@@ -59,9 +71,8 @@ export interface ThemeDescription extends Tokens<ThemeGeneral>, ColorsDescriptio
  */
 export interface Theme extends ThemeGeneral, ColorsFinal {
     /**
-     * @desc Legacy
-     * @tags legacy
-     * @deprecated
+     * @desc Тип темы. Используется только при компиляции
+     * @tags service
      */
     themeType: 'root';
 }

package/interfaces/general/toneValues/index.d.ts

@@ -4,5 +4,9 @@ export interface ToneValues {
      * @tags opacity
      */
     opacityDisable: number;
+    /**
+     * @desc Значение прозрачности подходящее под параметры аксесабилити
+     * @tags opacity
+     */
     opacityDisableAccessibility: number;
 }