extra-figma-code-connect

.github/workflows/npm-publish.yml

@@ -26,13 +26,11 @@ jobs:
         with:
           version: ${{github.ref_name}}
       - name: Sync src/lib/package.json version with root package.json
+        # Only sync the file in the working tree — the build/publish read it from here.
+        # Do NOT commit/push back: `main` is a protected branch and rejects direct pushes
+        # (GH013: Changes must be made through a pull request).
         run: |
           node -e "const fs=require('fs'); const path='src/lib/package.json'; const root=JSON.parse(fs.readFileSync('package.json')); const lib=JSON.parse(fs.readFileSync(path)); if(lib.version!==root.version){ lib.version=root.version; fs.writeFileSync(path, JSON.stringify(lib,null,2)+'\n'); }"
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-          git add src/lib/package.json
-          # commit only if there are staged changes
-          git diff --cached --quiet || (git commit -m "chore(release): sync src/lib package version to ${{github.ref_name}}" && git push origin HEAD:refs/heads/${{ github.event.release.target_commitish }})
       - run: npm run build:lib
       - name: Prepare dist/package.json
         run: |

.gitignore

@@ -59,3 +59,5 @@ src/assets/components/themes
 .playwright-mcp/*
 
 .claude/*
+.qwen
+.worktrees/

.storybook/preview.ts

@@ -5,7 +5,6 @@ import docJson from '../documentation.json';
 import { providePrimeNG } from 'primeng/config';
 import { provideAnimationsAsync } from '@angular/platform-browser/animations/async';
 import { GalleriaItemSlot } from 'primeng/galleria';
-import { RU_TRANSLATION } from '../src/prime-preset/locale/ru';
 // Fix PrimeNG bug: GalleriaItemSlot's main item slot has no `type` attribute,
 // so the `item` setter's forEach loop never matches and context stays stale on updates.
 (function patchGalleriaItemSlot() {
@@ -27,6 +26,7 @@ import { RU_TRANSLATION } from '../src/prime-preset/locale/ru';
 import Preset from '../src/lib/providers/prime-preset/theme.preset';
 
 import '!style-loader!css-loader!postcss-loader!sass-loader!../src/styles.scss';
+import { RU_TRANSLATION } from '../src/lib/providers/prime-preset/locale/ru';
 
 setCompodocJson(docJson);
 

README.md

@@ -70,6 +70,63 @@ import { ExtraButtonComponent, ExtraTagComponent } from '@cdek-it/angular-ui-kit
 export class AppExample {}
 ```
 
+## Tailwind v4: вся дизайн-система из кита
+
+Кит публикует готовую **Tailwind v4 CSS-first тему** (`@theme`), **полностью сгенерированную из
+своих дизайн-токенов** (`tokens.json` — тот же источник, что и тема PrimeNG). Это единая точка
+истины: поменяли токен в ките → consumer'у достаточно bump'нуть версию, чтобы получить обновление,
+согласованное с компонентами `extra-*`. Никаких JS-пресетов/`@config`/v3 — только v4 CSS-first.
+
+Генерация: `npm run generate:tailwind` (входит в `build:lib`). Артефакт: `tailwind/theme.css`.
+
+### Подключение (одна строка)
+
+В `styles.scss` проекта:
+
+```scss
+@use "tailwindcss";
+@use "@cdek-it/angular-ui-kit/tailwind";
+```
+
+### Что отдаёт кит (утилиты из токенов)
+
+| Namespace | Токены | Утилиты |
+|---|---|---|
+| colors | палитра + semantic | `bg-primary`, `text-danger`, `bg-surface-ground`, `border-surface-border`, `text-zinc-500`, … |
+| fonts | `fontFamily` | `font-heading` (TT Fellows), `font-base` (PT Sans) |
+| font-weight | `fontWeight` | `font-regular/medium/demibold/bold` |
+| text (font-size) | `fontSize` | `text-100…text-1000` |
+| leading (line-height) | `lineHeight` | `leading-100…leading-1000`, `leading-auto` |
+| radius | `borderRadius` | `rounded-100…rounded-500`, `rounded-none`, `rounded-max` |
+| shadow | `shadows` | `shadow-100…shadow-500`, `shadow-none` |
+| ease | `transition.easing` | `ease-in/out/inOut` (плюс дефолтный `ease-linear`) |
+| spacing | `spacing["1x"]` | одна ручка `--spacing` (множитель); из неё v4 выводит `p/m/w/h/gap/inset/space/translate` |
+
+Semantic-цвета (`primary`, `surface-ground`, `text`, …) ссылаются на runtime-переменные PrimeNG
+(`--p-*`) и **трекают `provideExtraThemes()`**; оттенки палитры — статический слепок (их runtime-имена
+нестандартны, поэтому зафиксированы в ките).
+
+> Не вошли в `@theme` (нет v4-namespace): `sizing`, `borderWidth` (только `--default-border-width`),
+> `opacity`, `transition.duration`. Для них — дефолты v4 или произвольные значения
+> (`border-[3px]`, `w-[15rem]`, `opacity-[.25]`).
+
+### Кастомизация (без болей) — локальный `@theme` поверх
+
+```scss
+@use "tailwindcss";
+@use "@cdek-it/angular-ui-kit/tailwind";
+
+@theme {
+  --color-primary: #ff0000;   /* перебить */
+  --color-brand: #123456;     /* добавить */
+  --breakpoint-xs: 480px;     /* расширить */
+}
+```
+v4 мержит `@theme`-блоки (last-wins) — конфликта нет, кит править не нужно. Разделение: кит владеет
+дизайн-токенами, проект — build-конфигом (`content`-сканирование в v4 автоматическое, плагины через `@plugin`).
+
+---
+
 ## Используемые технологии и связанные зависимости
 
 ---