@vkontakte/vkui-tokens 4.19.1 → 4.20.0

package/build/compilers/docs/__test__/emptyTheme.d.ts

@@ -0,0 +1,9 @@
+export interface BaseTheme {
+    /**
+     * @tag empty description
+     */
+    prop: string;
+    propWithoutDoc: string;
+}
+export interface EmptyTheme extends BaseTheme {
+}

package/build/compilers/docs/__test__/emptyTheme.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/compilers/docs/__test__/testBaseForBase.d.ts

@@ -0,0 +1,8 @@
+export interface BaseTheme {
+    /**
+     * @desc Short desc tag
+     * @tag tag1
+     * @tag tag2
+     */
+    importedBaseProp: string;
+}

package/build/compilers/docs/__test__/testBaseForBase.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/compilers/docs/__test__/testBaseTheme.d.ts

@@ -0,0 +1 @@
+export { BaseTheme as BaseTheme1 } from './testBaseForBase';

package/build/compilers/docs/__test__/testBaseTheme.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/compilers/docs/__test__/testRecursiveReexport.d.ts

@@ -0,0 +1 @@
+export { BaseTheme1 as BaseTheme } from './testBaseTheme';

package/build/compilers/docs/__test__/testRecursiveReexport.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/compilers/docs/__test__/testTheme.d.ts

@@ -0,0 +1,15 @@
+import { EmptyTheme } from './emptyTheme';
+import { BaseTheme1 } from './testBaseTheme';
+export interface BaseTheme2 {
+    /**
+     * @desc Empty tags
+     */
+    localBaseProp: string;
+}
+export interface ThemeTest extends BaseTheme1, BaseTheme2, EmptyTheme {
+    /**
+     * @description Long description tag
+     * @tags tagListItem1, tagListItem2,tagListItem3
+     */
+    derivedProp: string;
+}

package/build/compilers/docs/__test__/testTheme.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/compilers/docs/compileDocsJSON.d.ts

@@ -0,0 +1,37 @@
+import { SpecialTokens, Theme } from '../../../interfaces/general';
+export interface ThemePropertyDoc {
+    tags: string[];
+    desc: string;
+}
+export declare type ThemeDocs = {
+    [name: string]: ThemePropertyDoc;
+};
+export declare function getTypeDocs(filePath: string, name: string): ThemeDocs;
+/**
+ * Компилирует документацию для полей интерфейса темы и возвращает сериализованный JSON
+ *
+ * Собирает из jsDoc комментариев над полями интерфейса темы следующего следующие теги:
+ * 	 - @desc/@description <desc> – описание поля
+ * 	 - @tag <tag> – добавить тег (можно использовать несколько раз)
+ * 	 - @tags <tag>, <tag>, ... – задать список тегов, разделённых запятой
+ *
+ * По итогу компиляции формирует JSON вида:
+ * 	 {
+ * 	   "<property>": {
+ * 	   	 "desc": "<desc>",
+ * 	     "tags": ["<tag>", "<tag>", ...]
+ * 	   },
+ * 	   ...
+ * 	 }
+ *
+ * Умеет работать с выражениями вида:
+ * 	 - export interface MyTheme { ... }
+ * 	 - interface BaseTheme1 { ... }
+ * 	   interface BaseTheme2 { ... }
+ * 	 	 export interface MyTheme extends BaseTheme1, BaseTheme2 { ... }
+ * 	 - import { AnotherBaseTheme } from 'path/to/baseTheme.ts'
+ *   	 import { MyTheme, BaseTheme } from 'path/to/myTheme.ts'
+ * 	   export interface MyDarkTheme extends MyTheme, BaseTheme, AnotherBaseTheme
+ * 	 - export { BaseTheme as MyTheme } from 'path/to/baseTheme.ts'
+ */
+export declare function compileDocsJSON<T extends SpecialTokens = Theme>(theme: T): string;

package/build/compilers/docs/compileDocsJSON.js

@@ -0,0 +1,120 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileDocsJSON = exports.getTypeDocs = void 0;
+var path_1 = __importDefault(require("path"));
+var ts_morph_1 = require("ts-morph");
+var capitalize_1 = require("../../helpers/capitalize");
+function getTagText(tag) {
+    return tag
+        .getText()
+        .map(function (part) { return part.text; })
+        .join(' ');
+}
+function resolveDeclaration(declaration) {
+    if (ts_morph_1.Node.isExportSpecifier(declaration)) {
+        // export { A as B } from 'path/to/module.ts'
+        var declarations = declaration
+            .getNameNode()
+            .getSymbol()
+            .getDeclarations();
+        return resolveDeclarations(declarations);
+    }
+    return [declaration];
+}
+function resolveDeclarations(declarations) {
+    return declarations.reduce(function (all, declaration) {
+        return all.concat(resolveDeclaration(declaration));
+    }, []);
+}
+function getExportedTypeDeclarations(file, typeName) {
+    var exportSymbol = file.getExportSymbols().find(function (symbol) {
+        return symbol.getName() === typeName;
+    });
+    var declarations = exportSymbol.getDeclarations();
+    return resolveDeclarations(declarations);
+}
+function mapJsDocTagsToThemePropertyDoc(tags) {
+    var doc = {
+        tags: [],
+        desc: '',
+    };
+    tags.forEach(function (tag) {
+        var tagName = tag.getName();
+        var tagText = getTagText(tag);
+        if (tagName === 'desc' || tagName === 'description') {
+            doc.desc = tagText;
+        }
+        else if (tagName === 'tags') {
+            doc.tags = tagText.split(',').map(function (tag) { return tag.trim(); });
+        }
+        else if (tagName === 'tag') {
+            doc.tags.push(tagText);
+        }
+    });
+    return doc;
+}
+function getTypeDocs(filePath, name) {
+    var project = new ts_morph_1.Project({
+        tsConfigFilePath: 'tsconfig.json',
+        skipAddingFilesFromTsConfig: true,
+    });
+    var file = project.addSourceFileAtPath(filePath);
+    var declarations = getExportedTypeDeclarations(file, name);
+    return declarations.reduce(function (all, declaration) {
+        var properties = declaration.getType().getApparentProperties();
+        var docs = properties.reduce(function (all, prop) {
+            all[prop.getName()] = mapJsDocTagsToThemePropertyDoc(prop.getJsDocTags());
+            return all;
+        }, {});
+        return __assign(__assign({}, all), docs);
+    }, {});
+}
+exports.getTypeDocs = getTypeDocs;
+/**
+ * Компилирует документацию для полей интерфейса темы и возвращает сериализованный JSON
+ *
+ * Собирает из jsDoc комментариев над полями интерфейса темы следующего следующие теги:
+ * 	 - @desc/@description <desc> – описание поля
+ * 	 - @tag <tag> – добавить тег (можно использовать несколько раз)
+ * 	 - @tags <tag>, <tag>, ... – задать список тегов, разделённых запятой
+ *
+ * По итогу компиляции формирует JSON вида:
+ * 	 {
+ * 	   "<property>": {
+ * 	   	 "desc": "<desc>",
+ * 	     "tags": ["<tag>", "<tag>", ...]
+ * 	   },
+ * 	   ...
+ * 	 }
+ *
+ * Умеет работать с выражениями вида:
+ * 	 - export interface MyTheme { ... }
+ * 	 - interface BaseTheme1 { ... }
+ * 	   interface BaseTheme2 { ... }
+ * 	 	 export interface MyTheme extends BaseTheme1, BaseTheme2 { ... }
+ * 	 - import { AnotherBaseTheme } from 'path/to/baseTheme.ts'
+ *   	 import { MyTheme, BaseTheme } from 'path/to/myTheme.ts'
+ * 	   export interface MyDarkTheme extends MyTheme, BaseTheme, AnotherBaseTheme
+ * 	 - export { BaseTheme as MyTheme } from 'path/to/baseTheme.ts'
+ */
+function compileDocsJSON(theme) {
+    var themeFilePath = path_1.default.resolve("src/interfaces/themes/" + theme.themeName + "/index.ts");
+    var themeInterfaceName = "Theme" + capitalize_1.capitalize(theme.themeName);
+    var docs = getTypeDocs(themeFilePath, themeInterfaceName);
+    return JSON.stringify(docs, null, '  ');
+}
+exports.compileDocsJSON = compileDocsJSON;

package/build/compilers/docs/compileDocsJSON.test.d.ts

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

package/build/compilers/docs/compileDocsJSON.test.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var compileDocsJSON_1 = require("./compileDocsJSON");
+describe('compileDocsJSON', function () {
+    it('should correct compile documentation with reexported interface', function () {
+        var docs = compileDocsJSON_1.getTypeDocs('src/build/compilers/docs/__test__/testRecursiveReexport.ts', 'BaseTheme');
+        expect(docs).toEqual({
+            importedBaseProp: {
+                desc: 'Short desc tag',
+                tags: ['tag1', 'tag2'],
+            },
+        });
+    });
+    it('should correct compile documentation with imports', function () {
+        var docs = compileDocsJSON_1.getTypeDocs('src/build/compilers/docs/__test__/testTheme.ts', 'ThemeTest');
+        expect(docs).toEqual({
+            prop: {
+                desc: '',
+                tags: ['empty description'],
+            },
+            propWithoutDoc: {
+                desc: '',
+                tags: [],
+            },
+            localBaseProp: {
+                desc: 'Empty tags',
+                tags: [],
+            },
+            importedBaseProp: {
+                desc: 'Short desc tag',
+                tags: ['tag1', 'tag2'],
+            },
+            derivedProp: {
+                desc: 'Long description tag',
+                tags: ['tagListItem1', 'tagListItem2', 'tagListItem3'],
+            },
+        });
+    });
+});

package/build/compilers/index.d.ts

@@ -1,9 +1,11 @@
 import { PixelifyTheme, SpecialTokens, Theme, ThemeCssVarsWide } from '../../interfaces/general';
 declare type ThemeBuildType = 'root' | 'subtheme' | 'flat' | 'cssVars' | 'cssVarsPseudoRoot';
+declare function writeStructJsonFile<T = Theme>(themePath: string, theme: T, _?: ThemeBuildType): void;
 declare function writeJsonFile<T = Theme>(themePath: string, theme: T, _?: ThemeBuildType): void;
 declare function writeTsFile<T extends SpecialTokens = Theme>(themePath: string, theme: T, type: ThemeBuildType, themeName?: string): void;
 declare function writeStyleFiles<PT extends PixelifyTheme = PixelifyTheme>(themePath: string, theme: PT): void;
 declare function writeCssVarsSourceFile<PT extends PixelifyTheme = PixelifyTheme>(themePath: string, theme: PT, cssVarsTheme: any, themeBase?: PT): void;
 declare function writeCssVarsSourceMediaFile<T = ThemeCssVarsWide>(themePath: string, theme: T): void;
 declare function writeCssVarsJsUtils<T = Theme>(themePath: string, theme: ThemeCssVarsWide<T>): void;
-export { writeCssVarsJsUtils, writeCssVarsSourceFile, writeCssVarsSourceMediaFile, writeJsonFile, writeStyleFiles, writeTsFile, };
+declare function writeDocsFiles<T extends SpecialTokens = Theme>(themePath: string, theme: T): void;
+export { writeCssVarsJsUtils, writeCssVarsSourceFile, writeCssVarsSourceMediaFile, writeDocsFiles, writeJsonFile, writeStructJsonFile, writeStyleFiles, writeTsFile, };

package/build/compilers/index.js

@@ -3,15 +3,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.writeTsFile = exports.writeStyleFiles = exports.writeJsonFile = exports.writeCssVarsSourceMediaFile = exports.writeCssVarsSourceFile = exports.writeCssVarsJsUtils = void 0;
+exports.writeTsFile = exports.writeStyleFiles = exports.writeStructJsonFile = exports.writeJsonFile = exports.writeDocsFiles = exports.writeCssVarsSourceMediaFile = exports.writeCssVarsSourceFile = exports.writeCssVarsJsUtils = void 0;
 var fs_extra_1 = __importDefault(require("fs-extra"));
 var path_1 = __importDefault(require("path"));
 var compileGetDeclarationString_1 = require("./cssVars/jsUtils/compileGetDeclarationString");
+var compileDocsJSON_1 = require("./docs/compileDocsJSON");
 var compileJSON_1 = require("./json/compileJSON");
 var compileStyles_1 = require("./styles/compileStyles");
 var compileTypeScript_1 = require("./ts/compileTypeScript");
 var capitalize_1 = require("../helpers/capitalize");
 var compileBreakpointsCssVarsDeclaration_1 = require("./cssVars/declarations/compileBreakpointsCssVarsDeclaration");
+var compileStructJSON_1 = require("./structJSON/compileStructJSON");
 var cssModes = [
     { mode: 'default', fileName: 'index.css' },
     { mode: 'onlyVariables', fileName: 'onlyVariables.css' },
@@ -25,6 +27,15 @@ var cssModes = [
     { mode: 'noSizes', fileName: 'noSizes.css' },
     { mode: 'noColors', fileName: 'noColors.css' },
 ];
+function writeStructJsonFile(themePath, theme, _) {
+    console.log("\u043A\u043E\u043C\u043F\u0438\u043B\u0438\u0440\u0443\u0435\u043C \u0441\u0442\u0440\u0443\u043A\u0442\u0443\u0440\u043D\u044B\u0439 json...");
+    var fileName = "struct.json";
+    var filePath = path_1.default.resolve(themePath, fileName);
+    var content = compileStructJSON_1.compileStructJSON(theme);
+    fs_extra_1.default.writeFileSync(filePath, content);
+    console.log("\u0443\u0441\u043F\u0435\u0448\u043D\u043E \u0437\u0430\u043F\u0438\u0441\u0430\u043B\u0438 \u0444\u0430\u0439\u043B " + fileName);
+}
+exports.writeStructJsonFile = writeStructJsonFile;
 function writeJsonFile(themePath, theme, _) {
     console.log("\u043A\u043E\u043C\u043F\u0438\u043B\u0438\u0440\u0443\u0435\u043C json...");
     var fileName = "index.json";
@@ -125,3 +136,12 @@ function writeCssVarsJsUtils(themePath, theme) {
     });
 }
 exports.writeCssVarsJsUtils = writeCssVarsJsUtils;
+function writeDocsFiles(themePath, theme) {
+    console.log("\u043A\u043E\u043C\u043F\u0438\u043B\u0438\u0440\u0443\u0435\u043C \u0434\u043E\u043A\u0443\u043C\u0435\u043D\u0442\u0430\u0446\u0438\u044E...");
+    var fileName = "docs.json";
+    var filePath = path_1.default.resolve(themePath, fileName);
+    var content = compileDocsJSON_1.compileDocsJSON(theme);
+    fs_extra_1.default.writeFileSync(filePath, content);
+    console.log("\u0443\u0441\u043F\u0435\u0448\u043D\u043E \u0437\u0430\u043F\u0438\u0441\u0430\u043B\u0438 \u0444\u0430\u0439\u043B " + fileName);
+}
+exports.writeDocsFiles = writeDocsFiles;

package/build/compilers/structJSON/compileStructJSON.d.ts

@@ -0,0 +1,6 @@
+import type { Theme } from '../../../interfaces/general';
+export declare type ValuesOf<T extends any[]> = T[number];
+/**
+ * Компилирует структурируемый json с темой
+ */
+export declare const compileStructJSON: <T = Theme>(theme: T) => string;

package/build/compilers/structJSON/compileStructJSON.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileStructJSON = void 0;
+var groups = [
+    'fontFamily',
+    'fontWeight',
+    'colorsScheme',
+    'size',
+    'opacity',
+    'elevation',
+    'gradient',
+    'animation',
+    'color',
+    'font',
+    'theme',
+    'other',
+];
+/**
+ * Компилирует структурируемый json с темой
+ */
+var compileStructJSON = function (theme) {
+    var structTheme = {};
+    Object.keys(theme).forEach(function (key) {
+        var group = groups.find(function (predicate) { return key.startsWith(predicate); }) || 'other';
+        if (!structTheme[group]) {
+            structTheme[group] = {};
+        }
+        structTheme[group][key] = theme[key];
+    });
+    return JSON.stringify(structTheme, null, '\t');
+};
+exports.compileStructJSON = compileStructJSON;

package/build/compilers/structJSON/compileStructJSON.test.d.ts

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

package/build/compilers/structJSON/compileStructJSON.test.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var compileStructJSON_1 = require("./compileStructJSON");
+describe('compileJSON', function () {
+    it('should correct stringify', function () {
+        var testData = {
+            colorA: '#fff',
+            colorsScheme: 'scheme',
+            randomToken: 123,
+        };
+        expect(compileStructJSON_1.compileStructJSON(testData)).toBe("{\n\t\"color\": {\n\t\t\"colorA\": \"#fff\"\n\t},\n\t\"colorsScheme\": {\n\t\t\"colorsScheme\": \"scheme\"\n\t},\n\t\"other\": {\n\t\t\"randomToken\": 123\n\t}\n}");
+    });
+});

package/build/helpers/cssHelpers.d.ts

@@ -4,7 +4,7 @@ export declare function isColorDescriptionCallable(value: unknown): value is Col
 export declare function isColorDescriptionStatic(value: unknown): value is ColorDescriptionStatic;
 /**
  * @deprecated
- * use toneOpacity
+ * @use toneOpacity
  * TODO: remove
  */
 export declare function getRGBA(color: ColorDescription, opacity: number): ColorDescription;

package/build/helpers/cssHelpers.js

@@ -25,7 +25,7 @@ function isColorDescriptionStatic(value) {
 exports.isColorDescriptionStatic = isColorDescriptionStatic;
 /**
  * @deprecated
- * use toneOpacity
+ * @use toneOpacity
  * TODO: remove
  */
 function getRGBA(color, opacity) {

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

@@ -3,6 +3,10 @@ import { Property } from 'csstype';
  * Переменные отвечающие за параметры анимаций
  */
 export interface Animations {
+    /**
+     * @desc Параметры кривой анимации по умолчанию
+     * @tags animation
+     */
     animationEasingDefault: Property.TransitionTimingFunction;
     animationEasingPlatform: Property.TransitionTimingFunction;
     animationDurationS: string;

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

@@ -74,6 +74,10 @@ export interface ColorsDescriptionStruct {
     colorIconContrastSecondary: ColorDescription;
     colorIconPositive: ColorDescription;
     colorIconNegative: ColorDescription;
+    /**
+     * @desc Цвет акцентной обводки
+     * @tags color,stroke
+     */
     colorStrokeAccent: ColorDescription;
     colorStrokeAccentThemed: ColorDescription;
     colorStrokePositive: ColorDescription;

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

@@ -1,5 +1,9 @@
 import { Property } from 'csstype';
 export interface Elevation {
+    /**
+     * @desc Параметры тени уровень 4
+     * @tags elevation
+     */
     elevation4: Property.BoxShadow;
     elevation3: Property.BoxShadow;
     elevation2: Property.BoxShadow;

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

@@ -60,6 +60,10 @@ export interface Sizes {
     sizeButtonTertiaryLargePaddingHorizontalIcon: number;
     sizeButtonMinimumWidth: number;
     sizeFormItemPaddingVertical: number;
+    /**
+     * @desc Отступ для компонента SplitCol
+     * @tags size,component
+     */
     sizeSplitColPaddingHorizontal: number;
     sizeSubnavigationBarGap: number;
     sizeSubnavigationBarPaddingVertical: number;

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

@@ -1,5 +1,9 @@
 export declare type GradientPoints = string;
 export interface Gradients {
+    /**
+     * @desc Параметры градиента черного цвета
+     * @tags gradient
+     */
     gradientBlack: GradientPoints;
     gradientWhite: GradientPoints;
     gradientTint: GradientPoints;

package/interfaces/general/index.d.ts

@@ -17,6 +17,11 @@ declare type AdaptiveTokens = {
     [key in keyof AdaptiveInterfaceValues]: Adaptive<AdaptiveInterfaceValues[key]>;
 };
 export interface ColorsScheme {
+    /**
+     * @desc Legacy
+     * @tags color,legacy
+     * @deprecated
+     */
     colorsScheme: 'light' | 'dark';
 }
 export interface ColorsDescription<T extends {
@@ -27,6 +32,10 @@ export interface ColorsDescription<T extends {
 export interface ColorsFinal extends Colors, ColorsScheme {
 }
 export interface SpecialTokens {
+    /**
+     * @desc Legacy
+     * @tags legacy
+     */
     themeName: string;
     themeNameBase?: string;
     themeInheritsFrom?: string;
@@ -49,6 +58,11 @@ export interface ThemeDescription extends Tokens<ThemeGeneral>, ColorsDescriptio
  * Основной интерфейс темы
  */
 export interface Theme extends ThemeGeneral, ColorsFinal {
+    /**
+     * @desc Legacy
+     * @tags legacy
+     * @deprecated
+     */
     themeType: 'root';
 }
 /**

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

@@ -1,4 +1,8 @@
 export interface ToneValues {
+    /**
+     * @desc Основное значение прозрачности
+     * @tags opacity
+     */
     opacityDisable: number;
     opacityDisableAccessibility: number;
 }

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

@@ -19,6 +19,8 @@ export interface Fonts {
     fontTitle2: Font;
     fontTitle3: Font;
     /**
+     * @desc Legacy. Сейчас не используется в компонентах
+     * @tags font
      * @deprecated
      * @see fontHeadline1
      */
@@ -41,6 +43,10 @@ export interface Fonts {
  * Глобальные переменные типографии, которые можно использовать вне групп
  */
 export interface TypographyBaseProps {
+    /**
+     * @desc Семейство шрифтов для заголовков
+     * @tags font
+     */
     fontFamilyAccent: Property.FontFamily;
     fontFamilyBase: Property.FontFamily;
     fontWeightAccent1: Property.FontWeight;

package/interfaces/namespaces/paradigm/index.d.ts

@@ -10,7 +10,15 @@ export interface LocalParadigmColorsDescriptionStruct {
     colorButtonContrastAlpha: ColorDescription;
     colorRating: ColorDescription;
     colorThumbErrorBackgroundAlpha: ColorDescription;
+    /**
+     * @desc Тонированный акцентный фон с прозрачностью меняется на белый в темной теме
+     * @tags color,background,alpha,themed
+     */
     colorBackgroundAccentTintThemedAlpha: ColorDescription;
+    /**
+     * @desc Тонированный акцентный фон с прозрачностью
+     * @tags color,background,alpha
+     */
     colorBackgroundAccentTintAlpha: ColorDescription;
     colorBackgroundAccentTintThemed: ColorDescription;
     colorBackgroundWarningTintThemedAlpha: ColorDescription;
@@ -31,6 +39,11 @@ export interface ParadigmLocalSizes {
     sizeArrowHeight: number;
     sizeArrowWidth: number;
     sizeBasePadding: number;
+    /**
+     * @desc Legacy
+     * @tags size,legacy
+     * @deprecated
+     */
     sizeBorderWidthTab: number;
     sizeBorderWidthBar: number;
     sizeBorderWidthAccent: number;
@@ -82,6 +95,11 @@ export interface ParadigmLocalSizes {
     sizeIllustrationXXL: number;
 }
 export interface ParadigmToneValues {
+    /**
+     * @desc Legacy. Значение прозрачности
+     * @tags legacy
+     * @deprecated
+     */
     toneValueOverlay: number;
     toneValueViewer: number;
     toneValueToolbar: number;
@@ -90,15 +108,30 @@ export interface ParadigmToneValues {
     toneValueFocus: number;
 }
 export interface ParadigmBorders {
+    /**
+     * @desc Legacy
+     * @tags legacy
+     * @deprecated
+     */
     typeBorderButton: Property.BorderStyle;
     typeBorderPosition: Property.BorderStyle;
 }
 export interface ParadigmLocalFonts {
+    /**
+     * @desc Legacy. Крупный заголовок из темы Paradigm
+     * @tags font
+     * @deprecated
+     */
     fontH0: Font;
     fontH1: Font;
     fontH2: Font;
 }
 export interface ParadigmHelpers {
+    /**
+     * @desc Legacy
+     * @tags legacy,size
+     * @deprecated
+     */
     sizeBase: number;
     sizeGrid: number;
     x0: number;

package/interfaces/themes/search/index.d.ts

@@ -28,6 +28,9 @@ export declare type SearchLocalFonts = {
     searchFontSearchBigTextBold: Adaptive<Font>;
     searchFontSearchTextBold: Adaptive<Font>;
     searchFontSearchTextMailSans: Adaptive<Font>;
+    searchFontForAdvertisingBold: Adaptive<Font>;
+    searchFontGreenURL: Adaptive<Font>;
+    searchFontParagraphBold: Adaptive<Font>;
 };
 export interface LocalSearchColorsDescriptionStruct {
     searchColorTextLinkPositive: ColorDescription;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/vkui-tokens",
-  "version": "4.19.1",
+  "version": "4.20.0",
   "description": "Репозиторий, который содержит в себе дизайн-токены и другие инструменты объединенной дизайн-системы VKUI и Paradigm",
   "license": "MIT",
   "main": "utils/descriptions.js",
@@ -26,7 +26,7 @@
   },
   "repository": "https://github.com/VKCOM/vkui-tokens.git",
   "dependencies": {
-    "csstype": "3.1.0"
+    "csstype": "3.1.1"
   },
   "devDependencies": {
     "@types/color": "3.0.1",
@@ -36,15 +36,15 @@
     "@types/node": "15.0.1",
     "@typescript-eslint/eslint-plugin": "4.33.0",
     "@typescript-eslint/parser": "4.22.0",
-    "@vkontakte/appearance": "https://github.com/VKCOM/Appearance#v9.51.0",
+    "@vkontakte/appearance": "https://github.com/VKCOM/Appearance#v9.51.4",
     "color": "3.1.3",
     "common-tags": "1.8.2",
     "css.escape": "1.5.1",
     "eslint": "7.25.0",
-    "eslint-config-prettier": "8.3.0",
+    "eslint-config-prettier": "8.5.0",
     "eslint-config-silence": "1.0.0",
     "eslint-import-resolver-alias": "1.1.2",
-    "eslint-plugin-compat": "3.9.0",
+    "eslint-plugin-compat": "4.0.2",
     "eslint-plugin-import": "2.26.0",
     "eslint-plugin-jasmine": "4.1.2",
     "eslint-plugin-prettier": "3.4.0",
@@ -55,9 +55,9 @@
     "jest-junit": "12.0.0",
     "lodash": "4.17.21",
     "prettier": "2.7.1",
-    "release-it": "14.10.0",
     "rimraf": "3.0.2",
     "ts-jest": "26.5.5",
+    "ts-morph": "16.0.0",
     "ts-node": "10.9.1",
     "tsconfig-paths": "4.1.0",
     "tscpaths": "0.0.9",