@topvisor/ui 1.0.22-test-ci-cd-10 → 1.2.0

package/.vscode/settings.json

@@ -0,0 +1,45 @@
+{
+    "git.autofetch": true,
+    "git.confirmSync": false,
+    "git.enableSmartCommit": true,
+    "zenMode.hideActivityBar": false,
+    "zenMode.hideLineNumbers": false,
+    "[json]": {
+        "editor.defaultFormatter": "vscode.json-language-features"
+    },
+    "[javascript]": {
+        "editor.defaultFormatter": "vscode.typescript-language-features"
+    },
+    "intelephense.phpdoc.useFullyQualifiedNames": true,
+    "intelephense.format.braces": "k&r",
+    "explorer.confirmDelete": false,
+    "zenMode.hideStatusBar": false,
+    "zenMode.centerLayout": false,
+    "zenMode.fullScreen": false,
+    "editor.lineHeight": 17,
+    // "editor.hover.enabled": false,
+    "editor.hover.delay": 1000,
+    "workbench.tree.indent": 24,
+    "workbench.editor.pinnedTabSizing": "shrink",
+    "workbench.editor.highlightModifiedTabs": true,
+    "editor.rulers": [
+        150
+    ],
+    "editor.formatOnType": true,
+    "git.allowForcePush": false,
+    "npm.packageManager": "npm",
+    "files.eol": "auto",
+    "html.format.wrapAttributes": "force-expand-multiline",
+    "css.format.newlineBetweenRules": false,
+    "css.format.maxPreserveNewLines": 2,
+    "css.format.spaceAroundSelectorSeparator": true,
+    "css.lint.emptyRules": "ignore",
+    "vue.codeLens.enabled": false,
+    "git.useEditorAsCommitInput": false,
+    "git.postCommitCommand": "sync",
+    "files.exclude": {
+        "**/nbproject": true,
+        "**/node_modules": true,
+    },
+    "typescript.tsdk": "node_modules/typescript/lib"
+}

package/CHANGELOG.md

@@ -0,0 +1,223 @@
+# Changelog
+
+Все заметные изменения в этом проекте будут задокументированы в этом файле. См. [standard-version](https://github.com/conventional-changelog/standard-version) для получения рекомендаций по коммитам.
+
+Ссылки на приватный репозиторий скрыты и доступны только в самом репозитории
+
+## [1.2.0](https://www.npmjs.com/package/@topvisor/ui/v/1.2.0) (2025-02-24)
+
+## [1.1.0](https://www.npmjs.com/package/@topvisor/ui/v/1.1.0) (2025-02-24)
+
+
+### Features
+
+* **forms:** Изменен UX TopTextarea expandable версии, теперь высота будет ограничена чуть больше половиной экрана. В TopEditArea добавлена мобильная версия футера и испарвлены мелкие баги в с изменением стилей TopTextArea ([9dea249](9dea2493401567082353ff6895a551adba80b3e1))
+* **npm:** Улучшено определение основного локального ip адреса при запуске storybook dev ([f887025](f8870252618206b753f8c9f297660c3c9b49f11e))
+* **project:** Компонент selectorRegion расширен дилоговым окном для выбора нескольких регионов ([295efba](295efbadaefea88d5d7e2e7ccd21196929da78f8))
+
+### [1.0.22-patch-textarea](https://www.npmjs.com/package/@topvisor/ui/v/1.0.22-patch-textarea) (2025-02-23)
+
+
+### Features
+
+* **forms:** Изменен UX TopTextarea expandable версии, теперь высота будет ограничена чуть больше половиной экрана. В TopEditArea добавлена мобильная версия футера и испарвлены мелкие баги в с изменением стилей TopTextArea ([9dea249](9dea2493401567082353ff6895a551adba80b3e1))
+
+### [1.0.22-selectorRegion-pr](https://www.npmjs.com/package/@topvisor/ui/v/1.0.22-selectorRegion-pr) (2025-02-22)
+
+
+### Features
+
+* **npm:** Улучшено определение основного локального ip адреса при запуске storybook dev ([f887025](f8870252618206b753f8c9f297660c3c9b49f11e))
+* **project:** Компонент selectorRegion расширен дилоговым окном для выбора нескольких регионов ([295efba](295efbadaefea88d5d7e2e7ccd21196929da78f8))
+
+### [1.0.21-pinia-1](https://www.npmjs.com/package/@topvisor/ui/v/1.0.21-pinia-1) (2025-02-21)
+
+
+### Bug Fixes
+
+* **npm:** Исправление команды npm publish --access=public --tag latest ([54d3327](54d3327da7a991d52638e61482899afc73498960))
+
+### [1.0.21](https://www.npmjs.com/package/@topvisor/ui/v/1.0.21) (2025-02-21)
+
+
+### Features
+
+* **npm:** Публикация теперь проходит с явным указанием тега latest ([dc184d3](dc184d35d5e7f67d3e15cffe06af685af35924e2)), closes [/github.com/npm/cli/blob/latest/CHANGELOG.md#1100-pre1-2024-12-06](/)
+
+### [1.0.20-selector2-4](https://www.npmjs.com/package/@topvisor/ui/v/1.0.20-selector2-4) (2025-02-21)
+
+### [1.0.20-selector2-4](https://www.npmjs.com/package/@topvisor/ui/v/1.0.20-selector2-4) (2025-02-21)
+
+### [1.0.20-test](https://www.npmjs.com/package/@topvisor/ui/v/1.0.20-test) (2025-02-21)
+
+### [1.0.20-selector2-3](https://www.npmjs.com/package/@topvisor/ui/v/1.0.20-selector2-3) (2025-02-21)
+
+### [1.0.20-selector2-2](https://www.npmjs.com/package/@topvisor/ui/v/1.0.20-selector2-2) (2025-02-20)
+
+### [1.0.20-selector2-1](https://www.npmjs.com/package/@topvisor/ui/v/1.0.20-selector2-1) (2025-02-20)
+
+### [1.0.20-focus-1](https://www.npmjs.com/package/@topvisor/ui/v/1.0.20-focus-1) (2025-02-19)
+
+
+### Features
+
+* **forms:** Значения чекбоксов и радио теперь могут быть числами ([863834c](863834cea86a9c02887c9f9b4c93479f87dacec9))
+
+### [1.0.20](https://www.npmjs.com/package/@topvisor/ui/v/1.0.20) (2025-02-18)
+
+
+### ⚠ BREAKING CHANGES
+
+* **i18n:** Удалена функция useI18nSetLang()
+
+### Features
+
+* **icomoon:** добавлены иконки sun, cloud, rain, snow, lightning-circle-16 ([cd87e0c](cd87e0cfdf1c25e836c4488bf54f3992aa005f75))
+
+
+### Bug Fixes
+
+* **i18n:** Убрана возможность смены языка без перезагрузки страницы (update [#27400](/{{user}})) ([74ff1f3](74ff1f390c73400e02aa750320c4553e292569aa))
+* **run:** Исправлена ошибка, из-за которой запущенный npm run preview нельзя было завершить, при этом он мешал повторному запуску npm run preview ([13196f4](13196f4631e68a334da5ddd7a7f9576196fdc497))
+
+### [1.0.19](https://www.npmjs.com/package/@topvisor/ui/v/1.0.19) (2025-02-12)
+
+
+### Features
+
+* **Core:** Добавлены функционал предзагрузки компонентов, см, Core.preloaders ([956c182](956c182d0bfa74eec30fc8ec9daaa55b61f1eb76))
+* **i18n:** Добавлена возможность вставлять переревод с подстановкой переменных ([a03dfd4](a03dfd4f620af55d48a8ac005d1d2a8db038707e))
+
+### [1.0.18-fixes-7](https://www.npmjs.com/package/@topvisor/ui/v/1.0.18-fixes-7) (2025-02-09)
+
+### [1.0.18-dialog-footer-6](https://www.npmjs.com/package/@topvisor/ui/v/1.0.18-dialog-footer-6) (2025-02-09)
+
+
+### ⚠ BREAKING CHANGES
+
+* **dialogs:** Прекращается поддержка старой верстки со старыми кнопками в футере
+
+### Features
+
+* **selector2:** Добавлено открытие стрелочками и очистка через delete и backspace ([f090feb](f090feb13906da8011dae36adcf0351cf39427ee))
+
+
+* **dialogs:** Обновлены стили вывода футера, удалены старые стили ([129f9e1](129f9e13a260fa644d44d52cd8b5aad52e1e59ec))
+
+### [1.0.18-ux-5](https://www.npmjs.com/package/@topvisor/ui/v/1.0.18-ux-5) (2025-02-09)
+
+
+### Features
+
+* **ux:** focus topIslandRow и selector2 ([62afd57](62afd57dc77531bca453f2d2eca03f5453e5d8c1))
+
+### [1.0.18-top-info-4](https://www.npmjs.com/package/@topvisor/ui/v/1.0.18-top-info-4) (2025-02-09)
+
+### [1.0.18-autofocus-3](https://www.npmjs.com/package/@topvisor/ui/v/1.0.18-autofocus-3) (2025-02-07)
+
+
+### Features
+
+* **directive:** v-top-focus теперь принимает значение boolean ([e666530](e66653081d616c3962c53da547f68d1da2931957))
+* **focus:** Добавление условной фокусировки и поддержку обработки нескольких запросов на фокусировку ([5502789](55027897681b4a801b7157394b4f580b38cfcda5))
+* **forms:** Добавлен автофокус при ошибках на основных элементах форм ([527bd0a](527bd0afe84df52b755b8d35397487de759e9c34))
+* **forms:** Изменение анимации top-error ([f2664ab](f2664ab168ba7c6339ad3b902049a64890a40e13))
+* **forms:** Улучшение работы стилей top-error при фокусе ([ae877ce](ae877ce5404f8287cbb0b66706301330a3b67088))
+* **selector2:** Добавление фокусировки ([095cb59](095cb59fda697b0b1fdbbdc834805e24b585de77))
+
+### [1.0.18-top-info-2](https://www.npmjs.com/package/@topvisor/ui/v/1.0.18-top-info-2) (2025-02-07)
+
+
+### Features
+
+* **TopInfo:** Добавлен в formsExt ([e8be018](e8be0189e03f13a7e24846478cd72e5ac267dd02))
+
+### [1.0.18-top-info](https://www.npmjs.com/package/@topvisor/ui/v/1.0.18-top-info) (2025-02-06)
+
+
+### Features
+
+* Исправлена верстка компонента info ([f033cd1](f033cd1adbc37b020aba8c52395b8e8be62e024e))
+* **checks:** Добавлен домен .foo ([c561755](c5617556022aab32c85b4ac39eb7781b13765401))
+* update [#26813](/{{user}}) ([444dfea](444dfeafaa7443cbbdfc195a6d1ae4ac4507f5a2))
+* **utils:** randomBySeed ([e1e92f6](e1e92f6c4f5eac183cdfa05c4bb494852db1f094))
+* **v-top-scroll-on-view:** update: [#27235](/{{user}}) - Создана дирректива для скрола при появлении ([b762264](b76226421cd061fc9c4b983b7d9ea0b8d128ef11))
+
+
+### Bug Fixes
+
+* внесены правки в utils/scroll ([d04c6bf](d04c6bfb641638f4ce747a3fa300250e1db140f3))
+* добавил директиву  v-top-scroll-shadow в web-types.json ([2310634](23106344fc2bb59553e270bfa84bca59a4797899))
+* добавил стили для мобильной версии modal-footer диалогового окна ([3152673](3152673bcebaa0df0a83e358ab9125cac4045a28))
+* Правки к TopInfo ([2e6e108](2e6e108da4ec8fc4d78e12cb084497b4c24c45f7))
+* finish [#26813](/{{user}}) - TopSelector2 ([8a91a49](8a91a497ef8cd1903dc1f88f4ec22f05de345588))
+* finish update [#26866](/{{user}}) - 26866-fix-island-row ([ebcbf23](ebcbf23775bca6d34473b72bf9be5ccdf9a4d79e))
+* update [#26812](/{{user}}) ([c8bf753](c8bf75309da88ac2a3a8a9c73d93b703702e4010))
+* update [#26813](/{{user}}) ([6c39a45](6c39a45c5da007ae15ef900682cdbd91a1cf8aa7))
+* update [#26866](/{{user}}): fix topIsland hover ([20768bd](20768bd86b5ba82c3f9d8c263d9935461d4c7b37))
+* **utils:** revert connectScrollShadow ([2619f39](2619f397fdc53ab029be6e281cc6f10047bb1dde))
+
+### [1.0.17](https://www.npmjs.com/package/@topvisor/ui/v/1.0.17) (2024-12-26)
+
+
+### Features
+
+* **checks:** Добавлен домен .foo ([c561755](c5617556022aab32c85b4ac39eb7781b13765401))
+* **utils:** randomBySeed ([e1e92f6](e1e92f6c4f5eac183cdfa05c4bb494852db1f094))
+* Исправлена верстка компонента info ([f033cd1](f033cd1adbc37b020aba8c52395b8e8be62e024e))
+
+### [1.0.16-add-domain-foo](https://www.npmjs.com/package/@topvisor/ui) (2024-12-22)
+
+
+### Features
+
+* **checks:** Добавлен домен .foo ([c561755](c5617556022aab32c85b4ac39eb7781b13765401))
+* **utils:** randomBySeed ([e1e92f6](e1e92f6c4f5eac183cdfa05c4bb494852db1f094))
+
+### [1.0.16](https://www.npmjs.com/package/@topvisor/ui) (2024-12-18)
+
+
+### Bug Fixes
+
+* Исправлены цвета --color-summary-top в темной теме ([3700339](37003393719ef113eedd7f7e7e6a2bef78852e9c))
+* **popup:** recalcPosition() ([0628106](06281063d89e9c3e87f9c349d3eedcda15d99aa9))
+
+### [1.0.15](https://www.npmjs.com/package/@topvisor/ui) (2024-12-10)
+
+
+### Features
+
+* **icomoon:** добавлены иконки Яндекса (ru, eng), добавлена иконка more (горизонтальная версия), обновлена иконка для списка проектов caret (up, down)  ([eca3264](eca3264e812cbd78b190758225869269ab998e61))
+* **TopDialog:** Поддержка TopPopup внутри диалоговых окон, decoratorOnCreate ([680bdec](680bdec7e825898830a804c86926efed1f5b73e6))
+
+### [1.0.14-pinia-prepare-2](https://www.npmjs.com/package/@topvisor/ui) (2024-12-05)
+
+### [1.0.14-pinia-prepare](https://www.npmjs.com/package/@topvisor/ui) (2024-12-05)
+
+
+### Features
+
+* **icomoon:** добавлены иконки Яндекса (ru, eng), добавлена иконка more (горизонтальная версия), обновлена иконка для списка проектов caret (up, down)  ([eca3264](eca3264e812cbd78b190758225869269ab998e61))
+
+### [1.0.14](https://www.npmjs.com/package/@topvisor/ui) (2024-12-03)
+
+
+### Features
+
+* **icomoon:** добавлены иконки Яндекса (ru, eng), добавлена иконка more (горизонтальная версия), обновлена иконка для списка проектов caret (up, down)  ([eca3264](eca3264e812cbd78b190758225869269ab998e61))
+* **TopDialog:** Поддержка TopPopup внутри диалоговых окон, decoratorOnCreate ([680bdec](680bdec7e825898830a804c86926efed1f5b73e6))
+
+### [1.0.13-dialog-top-popup](https://www.npmjs.com/package/@topvisor/ui) (2024-11-13)
+
+
+### Features
+
+* **TopDialog:** Поддержка TopPopup внутри диалоговых окон, decoratorOnCreate ([680bdec](680bdec7e825898830a804c86926efed1f5b73e6))
+
+### [1.0.13](https://www.npmjs.com/package/@topvisor/ui) (2024-11-10)
+
+
+### Features
+
+* Подключение standard-version ([02377e6](02377e69a0c3235491f82b5059721ed460bf220a))
+* TopDialog ([4e771b9](4e771b9b0ba539b27d1cc190ac76dc5f6642f417))

package/NPM.md

@@ -0,0 +1,25 @@
+# Введение в npm
+
+Скачать node.js (npm входит в состав node.js): https://nodejs.org/ru/download
+
+Описание файлов:
+
+- **package.json** - настройки разрабатываемого пакета, а также его
+  зависимости, [документация](https://docs.npmjs.com/cli/v9/configuring-npm/package-json)
+- **package-lock.json** - информация об установленных версиях пакетов, [документация](https://docs.npmjs.com/cli/v9/configuring-npm/package-lock-json)
+
+Описание команд:
+
+- `npm i`: является сокращенной командой `npm install`
+- `npm i -D`: является сокращенной командой `npm install --save-dev`
+- `npm i -g npm@latest`: обновление npm до последней версии
+- `npm i`: установка зависимостей из файла **package.json**
+- `npm- ci i`: установка зависимостей из файла **package-lock.json**
+- `npm i {{ name }}`: установка конкретного пакета
+- `npm i -D {{ name }}`: установка конкретного пакета как dev зависимости
+
+Команду **npm ci** необходимо использовать в случаях, когда есть необходимость загрузки конкретных версий.
+Обычно это нужно для отладки и в сценариях CI/CD, которые обязаны использовать указанные вами версии.
+
+Если вы не знакомы с **npm** рекомендуется прочитать статью на
+хабре: [npm, package.json и package-lock.json](https://habr.com/ru/companies/ruvds/articles/423703/)

package/PUBLISH.md

@@ -0,0 +1,63 @@
+# Публикация в npm
+
+Не путать с публикацией Storybook.
+
+https://www.npmjs.com/package/@topvisor/ui.
+
+Настройки и скрипты сборки см. в папке **./build/**.
+
+- Выполнить сборку: `npm run build`
+- Убедиться, что в сборке нет приватных данных, после публикации все файлы в /dist/ доступны в открытом доступе
+- Прописать новую [версию](#формат-версий) в package.json
+- Опубликовать сборку: `npm run publish`
+
+Перед публикацией будет выполнен `npm run genDocs` для обновления автоматически создаваемой документации в storybook. Если документация
+изменилась, то потребуется сделать дополнительный коммит и повторить публикацию.
+
+Перед каждой публикацией рекомендуется обновить версию storybook.
+
+Периодически необходимо обновлять версии всех зависимостей и проверять работу компонентов после выполнения обновлений.
+
+## Формат версий
+
+**Релизы**:
+
+{{ major }}.{{ minor }}.{{ path }}
+
+**Dev сборки**:
+
+{{ major }}.{{ minor }}.{{ path }}-{{ devName }}-{{ devVersion }}
+
+В dev сборке базовая версия `{{ major }}.{{ minor }}.{{ path }}` не изеняется и всегда берется из master,
+к ней через дефис добавляется dev версия `{{ devName }}-{{ devVersion }}`.
+
+При мерже в сврою версию актуальной master версии, базовую версию нужно переписать, не меняя своей dev версии.
+
+### Пример работы с версиями
+
+Правильный алгоритм упростит понимание того, с какой версией сейчас ведется работа и исключит случайное создание одинаковых версий.
+
+- вы сделали fork от `1.0.0`
+- ваша версия должна быть: `1.0.0-dev-1`
+- вы что-то поменяли и вам нужно сменить версию публикации
+- ваша версия теперь: `1.0.0-dev-2`
+- master версия обновилась до `1.0.1` и вы ее загрузили в свою ветку
+- ваша версия теперь: `1.0.1-dev-2`
+- ваша ветка готова к релизу и ее смержили в master
+- на данном этапе в master могут быть смержены и другие ветки
+- версия в master теперь: `1.0.2`
+
+### Описание версий
+
+- **major**: Обычно всегда равна 1
+- **minor**: Увеличивается на 1 после достижения path = 99
+- **path**: Увеличивается каждый раз на 1 при публикации мастер ветки
+- **devName**: Краткое имя ветки (одно, маскимум два, слова в camelCase), используется при публикации dev ветки
+- **devVersion**: Увеличивается на 1 при пубилации dev ветки
+
+## Публикация в CDN
+
+После публикации в npm пакет будет автоматически доступен на следующих CDN:
+
+- https://unpkg.com/@topvisor/ui/
+- https://cdn.jsdelivr.net/npm/@topvisor/ui/

package/README.md

@@ -1,82 +1,33 @@
-# UI kit Topvisor Vue
+[![pipeline](https://gitlab.topvisor.com/topvisor/ui/badges/master/pipeline.svg)](https://ui.topvisor.com/)
+[![npm version](https://badge.fury.io/js/@topvisor%2Fui.svg)](https://badge.fury.io/js/@topvisor%2Fui)
 
-## Vue компоненты
+# Topvisor UI kit, Vue 3
 
-Компоненты поставляются в двух форматах:
+Документация по работе с UI-kit и разработке компонентов см. здесь: https://ui.topvisor.com/.
 
-- amd (requirejs)
-- es
+npm пакет см. здесь: https://www.npmjs.com/package/@topvisor/ui
 
-Компоненты делятся на разные библиотеки и доступны через импорт этих библиотек.
+В проекте необходимо использовать самую свежую версию node.js LTS и npm.
 
-Каждая библиотека находится в отдельной папке, соответствующей имени библиотеки.
+## Локальный сервер разработки
 
-Все стили модулей находятся в папке /assets/ в файлах соответствующих имени библиотеки.
-В этой же папке располагаются стили для асинхронно загружаемых компонентов.
-Все стили грузятся автоматически вместе с загрузкой компонента.
+Для проверки написанных компонентов в проекте предусмотрена интеграция со Storybook.
 
-Документация и описание всех компонентов: https://ui.topvisor.com/
+Storybook настроен для работы с Vite и Vue с поддержкой Hot Module Replacement.
 
-## Общие стили UI
+Шаги для быстрой настройке локального сервера:
 
-- /assets/core.css - основная палитра цветов и общие стили и модификаторы компонентов
-- /assets/themes/* - стили тем оформления
+1. Установить node.js (npm входит в состав node.js): https://nodejs.org/ru/download
+2. `git clone https://gitlab.topvisor.com/topvisor/ui.git`: склонировать проект или установить его другим удобным способом
+3. `npm i -g npm@latest`: обновить до последней версии npm
+4. `npm i`: установить зависимости
+5. `npm run storybook`: запустить локальный сервер Storybook
 
-## Подключение стилей
+## Серверная сборка
 
-Стили компонентов подгружаются автоматически.
+Адрес сервера: https://ui.topvisor.com  
+Адрес сервера разработки: https://{{ имя-ветки }}.ui.topvisor.com
 
-Стили UI core.css необходимо подгрузить на страницу вручную.
+В названии ветки могут быть только маленькие латинские буквы, цифры и знак "-". Ветки с некорректным названием в репозитории сохранены не будут.
 
-```js
-import '@topvisor/ui/assets/core.css';
-```
-
-```html
-<link href="https://cdn.jsdelivr.net/npm/@topvisor/ui/assets/core.css" rel="stylesheet">
-```
-
-## Подключение стилей темы
-
-Стили темы необходимо подгрузить на страницу вручную.
-
-Для смены темы необходимо подгрузить файл стилей необходимой темы и отключить стили предыдущей темы.
-
-```js
-import '@topvisor/ui/assets/themes/light.css';
-```
-
-```html
-
-<link href="https://cdn.jsdelivr.net/npm/@topvisor/ui/assets/themes/light.css" rel="stylesheet">
-```
-
-## Внешние зависимсоти
-
-Стили icomoon добавлены в пакет и их необходимо подгрузить на страницу вручную.
-
-```js
-import '@topvisor/ui/icomoon/style.css';
-```
-
-```html
-
-<link href="https://cdn.jsdelivr.net/npm/@topvisor/ui/icomoon/style.css" rel="stylesheet">
-```
-
-## Подключение компонентов
-
-Пример подключения библиотеки Forms и компонента Button:
-
-```javascript
-require(['@topvisor/ui/forms/forms.amd'], ({ Button }) => {
-	console.log(Button);
-});
-
-require(['@topvisor/ui/forms/forms.amd'], Forms => {
-	const { Button } = Forms;
-
-	console.log(Forms);
-	console.log(Button);
-});
-```
+Чтобы на сайт проекта выкатились ваши изменения, вам нужно изменить версию в package.json, сделать коммит и запушить в этот репозиторий.

package/STORYBOOK.md

@@ -0,0 +1,48 @@
+# Storybook
+
+https://storybook.js.org/
+
+## Основные команды Storybook
+
+Информация о параметрах dev сервера и сборки: https://storybook.js.org/docs/react/api/cli-options
+
+- `npx storybook@latest upgrade`: обновить Storybook
+- `storybook dev`: запуск локального сервера Storybook
+- `storybook build`: запуск сборки Storybook
+
+## Локальный сервер разработки
+
+- `npm -i`: загрузить все зависимости проекта (выполнять один раз)
+- `npm run storybook`: запуск локального сервера Storybook
+- `npm run storybook-net`: запуск локального сервера Storybook в локальной сети, см. **On your network**
+
+В режиме **On your network** ссылку с этим адресом можно передавать другим пользователям в вашей 
+сети и использовать для тестов с мобильного устройства.
+Однако обратите внимание, что не все функции браузера доступны по адресу без **https**, если это не **localhost**.
+
+## Сборка storybook в статический сайт
+
+Не путать со сборкой проекта @topvisor/ui.
+
+`storybook build`: выполнить сборку
+
+## Сборка storybook на сайт
+
+Сборка storybook производится автоматически через CI/CD и публикуется на сайте. Вам нет необходимости делать сборку самостоятельно.
+
+Адреса сайтов:
+
+- Основной дрес сайта storybook c UI: https://ui.topvisor.com/.
+- Dev сайт сайта со storybook c UI: https://{{ имя-ветки }}.ui.topvisor.com
+
+В названии веток могут быть только маленькие латинские буквы, цифры и знак "-". Ветки с некорректным названием в репозитории сохранены не будут.
+
+В CI/CD будет создана новая версия докер образа, после чего она будет загружена на наши сервера и доступна по неободимым адресам.
+
+Для ускорения сборки докер образа используется кеширование докер слоев. Это кеширование можно выключить, для при коммите в комменатрии к коммиту
+надо указать строку: `@no-cache`.
+
+Например:
+
+- `git commit -m "update #{{ Номер задачи}}; @no-cache"`
+- `git commit -m "hello @no-cache hello"`

package/USE_IN_PROJECT.md

@@ -0,0 +1,32 @@
+[![pipeline status](https://gitlab.topvisor.com/topvisor/ui/badges/master/pipeline.svg)](https://gitlab.topvisor.com/topvisor/ui/-/commits/master)
+[![npm version](https://badge.fury.io/js/@topvisor%2Fui.svg)](https://badge.fury.io/js/@topvisor%2Fui)
+
+# Использование в других проектах
+
+## Использование @topvisor/ui после публикации, пример с topvisor.com
+
+Опубликованный пакет можно сразу использовать через публичный [CDN](PUBLISH.md#публикация-в-cdn).
+
+Подключение js пактов в topvisor.com настраивается в
+файле [requirejs.json](https://gitlab.topvisor.com/topvisor/topvisor.com/-/tree/master/requirejs.json).
+
+## Тестирование сборки @topvisor/ui без публикации
+
+Для тестирования сборки используется локальный сервер предпросмотра **vite preview** с автосборкой vite build --watch.
+
+Получаемые файлы с этого сервера не кешируются.
+
+Режим автосборки автоматически пересобирает проект и новая сборка доступна на сервере предпросмотра.
+
+Адрес севера предпросмотра по умолчанию: http://localhost:4173
+
+- `npm run preview` - запустить сервер предпросмотра с автосборкой
+- пропишите в importmap: `"@localhost/@topvisor/ui/": "http://localhost:4173"`
+- на сайте **topvisor.dev** настроена автоматическое подключение `@localhost/@topvisor/ui/`, если сервер запущен
+
+Пример изменения в пути при запуске **vite preview**: `https://cdn.jsdelivr.net/npm/@topvisor/ui` => `http://localhost:4173`
+
+## Установка в качестве git submodule в topvisor.dev
+
+- ```git submodule init``` - инициализация подмодуля в проекте
+- ```git submodule update``` - загрузка подмодуля, будет произведен clone репозитория подмодуля

package/build/afterBuild.sh

@@ -0,0 +1,11 @@
+echo ''
+echo 'run afterBuild...'
+
+echo '- remove /dist/for-delete/'
+rm -rf dist/for-delete/
+
+echo '- make package.json'
+cp package.json dist/
+npm pkg --prefix dist delete scripts devDependencies
+
+cp web-types.json dist/

package/build/cssModules.ts

@@ -0,0 +1,39 @@
+import stringHash from 'string-hash';
+
+// https://github.com/madyankin/postcss-modules/blob/325f0b33f1b746eae7aa827504a5efd0949022ef/src/scoping.js#L36
+function generateScopedNameDefault(name: string, filename: string, css: string) {
+	const i = css.indexOf(`.${name}`);
+	const lineNumber = css.substr(0, i).split(/[\r\n]/).length;
+	const hash = stringHash(css).toString(36).substr(0, 5);
+
+	return `_${name}_${hash}_${lineNumber}`;
+}
+
+export default {
+	/**
+	 * Оставить глобальные классы без преобразования
+	 * С глобальными классами нельзя работать через css module
+	 * С глобальными классами можно работать, определяя их их в интерфесе vue css module
+	 * @param name - имя класса
+	 * @param filename - файл стилей
+	 * @param css - стили
+	 * @returns Имя класса после предкомпиляции
+	 */
+	generateScopedName: (name: string, filename: string, css: string) => {
+		const isGlobalCSS = (name: string, filename: string) => {
+			// классы topvisor-ui
+			if (name.indexOf('top-') === 0) return true;
+
+			return false;
+		};
+
+		if (isGlobalCSS(name, filename)) {
+			return name;
+		}
+
+		return generateScopedNameDefault(name, filename, css);
+	},
+	// globalModulePaths: [],
+	//	scopeBehaviour: 'global',
+	//	exportGlobals: true,
+};

package/build/genDocs.sh

@@ -0,0 +1,19 @@
+echo ''
+echo 'run genDocs...'
+
+git diff --quiet --cached || echo 'В репозитории не должно быть не закомиченных изменений'
+git diff --quiet --cached || exit 1
+
+npx typedoc --entryPoints "src/core/utils/*.ts" --out "src/core/utils/References" --publicPath "?path=/docs/core-utils-references"
+
+echo ''
+echo 'replace file link to storybook path format'
+
+sed -i 's/%5C/\//g' src/core/utils/References/*.mdx
+sed -i 's/%5C/\//g' src/core/utils/References/*/*.mdx
+
+sed -i 's/\(core-utils-references\)\/\(.\{1,99\}\)\/\(\w\{1,99\}\).mdx/\1-\2-\3--docs/' src/core/utils/References/*.mdx
+sed -i 's/\(core-utils-references\)\/\(.\{1,99\}\)\/\(\w\{1,99\}\)\/\(\w\{1,99\}\).mdx/\1-\2-\3-\4--docs/' src/core/utils/References/*/*.mdx
+
+git add src/core/utils/References
+git diff --quiet --cached || git commit -m "docs: genDocs utils"