@shmidko61/lc-ui-kit 0.17.0 → 0.17.1

package/README.md

@@ -7,24 +7,41 @@
 Из каталога `apps`:
 
 ```bash
-corepack pnpm --filter @shmidko61/lc-ui-kit verify:package
+corepack pnpm release:check:ui-kit
 ```
 
-Команда последовательно проверяет типы исходников, ESLint (включая Storybook),
-форматирование, production-сборку, публичные типы с `skipLibCheck: false`,
-саму защиту релиза на негативных примерах, ESM/CJS exports, все `.d.ts`,
-production safelist, hover, состав npm tarball и сборку Storybook.
-
-`prepublishOnly` запускает тот же `verify:package`. Если любая стадия падает,
-проверка завершается с ненулевым кодом и публикация не продолжается.
-`pack:check` использует локальный `npm pack --dry-run --ignore-scripts`:
-авторизация в registry не требуется, lifecycle не запускается повторно.
-
-Отдельные проверки доступны как `typecheck`, `lint`, `format:check`,
-`typecheck:package`, `test:checks`, `test:package`, `test:hover`, `pack:check`
-`test:states` и `storybook:build`. Проверки собранного пакета запускаются после `build`.
-ESLint использует отдельный `tsconfig.eslint.json`; конфигурация source
-typecheck и публичные props компонентов не меняются.
+Команда устанавливает зависимости по frozen lockfile, удаляет старый `dist`,
+запускает lint, typecheck, тесты, сборку и Storybook. Затем `npm pack` создаёт
+реальный tarball в `.release/ui-kit`; пакет устанавливается в отдельный временный
+consumer без workspace-ссылок. Зависимости consumer фиксирует собственный
+`package-lock.json`.
+
+Проверяются все exports (ESM/CJS/types), декларации, файлы stylesheet, safelist,
+каждый CSS-файл через Lightning CSS с минификацией и запрет `${…}` в декларациях
+CSS. Consumer компилирует `contentInnerProps`, padding заголовка, md/lg/xl и
+собирается на Vite 7.3.6 и 8.3.5 с `cssMinify: 'lightningcss'`. Chromium проверяет
+реальный padding, нулевые значения, responsive/reset/style, клавиатуру, ARIA,
+динамическую высоту и анимации на всех breakpoint. Негативные регрессии проверяют
+невалидный CSS и исчезновение публичного prop.
+
+Для браузерных проверок Chromium устанавливается автоматически. Можно задать
+`CHROME_BIN` на существующий Chrome. На Linux нужны системные зависимости
+Playwright/Chromium (в CI используется Chrome из ubuntu-latest).
+При ошибке лог содержит этап `[release:…]` и путь consumer для диагностики.
+
+`corepack pnpm publish:ui-kit` проверяет npm-пользователя, выполняет весь pipeline
+и публикует **тот же tarball**, сверяя SHA-256 с `verified.json`. Повторной сборки
+между проверкой и публикацией нет. Ввода PUBLISH нет; npm может запросить 2FA.
+Прямая публикация из каталога пакета блокируется `prepublishOnly`.
+
+CI workflow **UI-kit artifact gate** выполняет обязательный verify job;
+публикация при ручном запуске с `publish=true` зависит от него и скачивает
+проверенный tarball. Для npm нужен секрет `NPM_TOKEN`. Чтобы запретить merge при
+ошибке, назначьте job `verify` обязательным в branch protection репозитория.
+Никакие проверки не используют `allow_failure`/`continue-on-error`.
+
+`verify:package` остаётся быстрым набором локальных проверок исходников и dist;
+он не заменяет обязательную проверку релизного tarball.
 
 ## Установка