@sberbusiness/triplex-next-mcp-server 0.36.0-beta0 → 1.40.0-beta

package/bundle/components/Title.md

@@ -0,0 +1,296 @@
+---
+component: Title
+category: Typography
+related: [Text, Caption, CodeText]
+tokens:
+  - --triplex-next-Typography-Primary_Color
+  - --triplex-next-Typography-PrimaryInvert_Color
+  - --triplex-next-Typography-Complementary_Color
+  - --triplex-next-Typography-ComplementaryInvert_Color
+  - --triplex-next-Typography-Secondary_Color
+  - --triplex-next-Typography-SecondaryInvert_Color
+  - --triplex-next-Typography-Tertiary_Color
+  - --triplex-next-Typography-TertiaryInvert_Color
+  - --triplex-next-Typography-Disabled_Color
+  - --triplex-next-Typography-DisabledInvert_Color
+  - --triplex-next-Typography-Brand_Color
+  - --triplex-next-Typography-BrandInvert_Color
+  - --triplex-next-Typography-Info_Color
+  - --triplex-next-Typography-InfoInvert_Color
+  - --triplex-next-Typography-Success_Color
+  - --triplex-next-Typography-SuccessInvert_Color
+  - --triplex-next-Typography-Warning_Color
+  - --triplex-next-Typography-WarningInvert_Color
+  - --triplex-next-Typography-Error_Color
+  - --triplex-next-Typography-ErrorInvert_Color
+  - --triplex-next-Typography-System_Color
+  - --triplex-next-Typography-SystemInvert_Color
+stories: stories/Typography/Title.stories.tsx
+version: "1.0"
+---
+
+# Title
+
+## Назначение
+
+Заголовок (типографика). Рендерит семантический heading `<h1>`–`<h3>` (тег по умолчанию совпадает со значением `size`) со шрифтом SBSansDisplay и цветом из палитры `EFontType`. `margin` у заголовков обнулён — отступы задаёт layout потребителя.
+
+Используй когда: нужен заголовок страницы, секции, карточки или модального окна.
+
+Не используй когда:
+- Нужен обычный текст интерфейса — используй `Text`.
+- Нужна крупная цифра/показатель (32px), не являющаяся заголовком — используй `Caption` с размером `D1`.
+
+---
+
+## Варианты и props
+
+### Обязательные props
+
+| Prop | Тип | Описание |
+|---|---|---|
+| `size` | `ETitleSize` | Размер заголовка: `H1` (28/36px), `H2` (24/32px), `H3` (20/28px). В скобках — font-size/line-height. Значения enum — строки `"h1"`/`"h2"`/`"h3"`. |
+
+### Опциональные props
+
+| Prop | Тип | По умолчанию | Описание |
+|---|---|---|---|
+| `weight` | `EFontWeightTitle` | `SEMIBOLD` | Начертание: `REGULAR` / `MEDIUM` (500) / `SEMIBOLD` (600) / `BOLD` (700). Каждому соответствует своё семейство SBSansDisplay*. |
+| `type` | `EFontType` | `PRIMARY` | Цвет текста из общей палитры типографики (11 базовых + 11 `*_INVERT`). |
+| `underline` | `boolean` | — | Подчёркивание. Совместим со `strikethrough` (оба сразу — `underline line-through`). |
+| `strikethrough` | `boolean` | — | Зачёркивание. |
+| `tag` | `string` | значение `size` | HTML-тег корневого элемента. По умолчанию равен значению `size` (`"h1"`/`"h2"`/`"h3"`) — визуальный размер и уровень heading связаны. Передай `tag` явно, чтобы развязать их (например, `size={ETitleSize.H1} tag="h2"`). |
+
+Компонент типизирован как `TTitleProps<T extends keyof JSX.IntrinsicElements>` и принимает все атрибуты соответствующего HTML-элемента через spread.
+
+### Ограничения
+
+- Внешний тип `forwardRef<HTMLElement, TTitleProps<keyof JSX.IntrinsicElements>>` «растворяет» дженерик: TypeScript не сужает атрибуты под конкретный `tag`. Известное ограничение публичного API, не исправлять без обсуждения (breaking).
+- Дефолт `` tag = `${size}` `` — намеренный трюк (значения `ETitleSize` совпадают с именами тегов); при изменении значений enum сломается и дефолтный тег — ещё одна причина не трогать значения.
+- `EFontType.BRAND` дополнительно задаёт `user-select: none` (особенность стилей `Typography.module.less`).
+
+---
+
+## Дизайн-токены
+
+Цвета — общие CSS-переменные семейства Typography (см. frontmatter): `--triplex-next-Typography-{Type}_Color` и `--triplex-next-Typography-{Type}Invert_Color`.
+
+Размеры шрифта и line-height — фиксированные пиксельные значения в `styles/Title.module.less` (токенов для них нет).
+
+---
+
+## Инварианты
+
+- **`forwardRef`** — обязателен, `ref` пробрасывается на корневой heading-элемент.
+- **Значения enum** `ETitleSize` (строки `"h1"`/`"h2"`/`"h3"`), `EFontWeightTitle`, `EFontType` — публичный API из barrel. Изменение — breaking change; значения `ETitleSize` дополнительно используются как дефолтный `tag`.
+- **`TTitleProps`**, **`ITypographyProps`** — публичные типы.
+- **`displayName = "Title"`** — не убирать.
+- `margin: 0` на `h1`–`h3` в `Title.module.less` — контракт: отступы вокруг заголовка задаёт потребитель.
+- Классы собираются только через `clsx`.
+
+---
+
+## Accessibility
+
+- По умолчанию рендерится настоящий heading (`<h1>`–`<h3>`) — уровень в accessibility-дереве определяется `size`. Следи за иерархией заголовков страницы; если визуальный размер не совпадает с нужным уровнем — задай `tag` явно.
+- Компонент не интерактивный: focus management и keyboard navigation не применимы.
+- Цвет (`type`) не передаёт семантику для screen reader'ов.
+
+---
+
+## Связанные компоненты
+
+- `Text` — основной текст интерфейса (B1–B4, SBSansText).
+- `Caption` — мелкие подписи и крупный показатель D1.
+- `CodeText` — моноширинный текст.
+
+---
+
+## Stories
+
+Основные истории: `stories/Typography/Title.stories.tsx`
+Файлы примеров: `stories/Typography/examples/Title/`
+
+| Story | Example file | Что демонстрирует |
+|---|---|---|
+| `Playground` | `Playground.tsx` | Интерактивный контроль props `size`, `weight`, `type`, `tag`, `underline`, `strikethrough` |
+| `Default` | `Default.tsx` | Минимальное использование |
+| `Sizes` | `Sizes.tsx` | Размеры H1 / H2 / H3 |
+| `Weights` | `Weights.tsx` | Начертания REGULAR / MEDIUM / SEMIBOLD / BOLD |
+| `Types` | `Types.tsx` | Все значения `EFontType`: базовые + инвертированные на тёмной подложке |
+| `Decorations` | `Decorations.tsx` | `underline`, `strikethrough` и их комбинация |
+
+---
+
+## История изменений
+
+| Дата | Изменение |
+|---|---|
+| 2026-07-20 | Создан документ. AI-рефакторинг: decoration-логика вынесена во внутренний хелпер `getTextDecorationClassName` (`utils.ts`), комментарии переведены в JSDoc, unit-тесты расширены (все значения `ETitleSize`/`EFontWeightTitle`, дефолтные heading-теги). Stories переведены на modern pattern (`examples/Title/`). |
+
+---
+
+## Примеры использования
+
+### Default
+
+`stories/Typography/examples/Title/Default.tsx`
+
+```tsx
+import React from "react";
+import { Title, ETitleSize } from "@sberbusiness/triplex-next";
+
+export const Default = () => <Title size={ETitleSize.H1}>Заголовок страницы</Title>;
+```
+
+### Sizes
+
+`stories/Typography/examples/Title/Sizes.tsx`
+
+```tsx
+import React from "react";
+import { Title, ETitleSize } from "@sberbusiness/triplex-next";
+
+export const Sizes = () => (
+    <div style={{ display: "flex", flexDirection: "column", gap: "16px" }}>
+        <Title size={ETitleSize.H1}>Заголовок H1</Title>
+        <Title size={ETitleSize.H2}>Заголовок H2</Title>
+        <Title size={ETitleSize.H3}>Заголовок H3</Title>
+    </div>
+);
+```
+
+### Weights
+
+`stories/Typography/examples/Title/Weights.tsx`
+
+```tsx
+import React from "react";
+import { Title, ETitleSize, EFontWeightTitle } from "@sberbusiness/triplex-next";
+
+export const Weights = () => (
+    <div style={{ display: "flex", flexDirection: "column", gap: "16px" }}>
+        <Title size={ETitleSize.H2} weight={EFontWeightTitle.REGULAR}>
+            Regular - Обычный вес
+        </Title>
+        <Title size={ETitleSize.H2} weight={EFontWeightTitle.MEDIUM}>
+            Medium - Средний вес
+        </Title>
+        <Title size={ETitleSize.H2} weight={EFontWeightTitle.SEMIBOLD}>
+            Semibold - Полужирный
+        </Title>
+        <Title size={ETitleSize.H2} weight={EFontWeightTitle.BOLD}>
+            Bold - Жирный
+        </Title>
+    </div>
+);
+```
+
+### Types
+
+`stories/Typography/examples/Title/Types.tsx`
+
+```tsx
+import React from "react";
+import { Title, ETitleSize, EFontType } from "@sberbusiness/triplex-next";
+
+export const Types = () => (
+    <div style={{ display: "flex", gap: "16px" }}>
+        <div style={{ display: "flex", flexDirection: "column", gap: "16px" }}>
+            <Title size={ETitleSize.H2} type={EFontType.PRIMARY}>
+                Primary
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.COMPLEMENTARY}>
+                Complementary
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.SECONDARY}>
+                Secondary
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.TERTIARY}>
+                Tertiary
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.BRAND}>
+                Brand
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.INFO}>
+                Info
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.SUCCESS}>
+                Success
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.WARNING}>
+                Warning
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.ERROR}>
+                Error
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.DISABLED}>
+                Disabled
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.SYSTEM}>
+                System
+            </Title>
+        </div>
+        <div style={{ display: "flex", flexDirection: "column", gap: "16px", backgroundColor: "#1F1F22" }}>
+            <Title size={ETitleSize.H2} type={EFontType.PRIMARY_INVERT}>
+                Primary Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.COMPLEMENTARY_INVERT}>
+                Complementary Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.SECONDARY_INVERT}>
+                Secondary Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.TERTIARY_INVERT}>
+                Tertiary Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.BRAND_INVERT}>
+                Brand Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.INFO_INVERT}>
+                Info Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.SUCCESS_INVERT}>
+                Success Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.WARNING_INVERT}>
+                Warning Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.ERROR_INVERT}>
+                Error Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.DISABLED_INVERT}>
+                Disabled Invert
+            </Title>
+            <Title size={ETitleSize.H2} type={EFontType.SYSTEM_INVERT}>
+                System Invert
+            </Title>
+        </div>
+    </div>
+);
+```
+
+### Decorations
+
+`stories/Typography/examples/Title/Decorations.tsx`
+
+```tsx
+import React from "react";
+import { Title, ETitleSize } from "@sberbusiness/triplex-next";
+
+export const Decorations = () => (
+    <div style={{ display: "flex", flexDirection: "column", gap: "16px" }}>
+        <Title size={ETitleSize.H2}>Заголовок без декораций</Title>
+        <Title size={ETitleSize.H2} underline>
+            Заголовок с подчеркиванием
+        </Title>
+        <Title size={ETitleSize.H2} strikethrough>
+            Заголовок с зачеркиванием
+        </Title>
+        <Title size={ETitleSize.H2} underline strikethrough>
+            Заголовок с подчеркиванием и зачеркиванием
+        </Title>
+    </div>
+);
+```
+

package/bundle/guides/commits.md

@@ -2,22 +2,40 @@
 
 ---
 
+## Задачи и тикеты
+
+Задачи ведутся в Linear, команда `TRI` (https://linear.app/triplex-next).
+Номер задачи `TRI-XXX` — обязательный префикс веток и коммитов: по нему
+GitHub-интеграция Linear линкует PR и двигает статусы задачи
+(ветка → In Progress, PR → In Review, merge → Done).
+
+**Legacy:** исторические ветки и коммиты используют префикс `TRIPLEX-XXX`.
+Существующие не переименовываем; всё новое — только `TRI-XXX`.
+
+---
+
 ## Именование веток
 
-**Формат:** `TRIPLEX-XXX-короткое-описание`
+**Формат:** `TRI-XXX-короткое-описание`
 
 - Строчные буквы, слова через дефис.
-- Всегда начинается с номера тикета.
+- Всегда начинается с номера задачи Linear.
 
 ```text
-TRIPLEX-844-ai-ready-design-system
-TRIPLEX-901-add-badge-component
-TRIPLEX-912-fix-button-focus-style
+TRI-12-add-badge-component
+TRI-15-fix-button-focus-style
+TRI-21-alert-ai-ready
 ```
 
 **Исключения:**
-- Релизная ветка: `prepare-release-XX` (например, `prepare-release-2`)
-- Перелитие main → release-0: выполняется мейнтейнерами, формат произвольный
+- Релизная ветка: `prerelease-X.Y.Z` (например, `prerelease-1.40.0`) — в неё
+  собираются фиксы релиза и бамп версии, PR идёт в `main`
+- Перелитие main → release-0: выполняется без отдельной ветки, прямым мержем
+
+Исключение касается только **имени ветки**. Коммиты внутри неё подчиняются
+общему правилу `TRI-XXX`: на релиз заводится задача Linear, её номер идёт
+префиксом (`TRI-XXX Подготовка релиза 1.40.0`). Legacy-префикс `TRIPLEX-0`
+для новых релизов не используется.
 
 ---
 
@@ -28,29 +46,34 @@ TRIPLEX-912-fix-button-focus-style
 | `main` | React 18 | `1.xx` | Основная ветка разработки |
 | `release-0` | React 17 | `0.xx` | Поддержка React 17, синхронизируется с main |
 
-**Правило:** все фича-ветки создаются от `main`. Изменения попадают в `release-0` через перелитие — вручную мейнтейнерами. Агент не должен создавать ветки от `release-0` и не должен мерджить в неё напрямую.
+**Правило:** все фича-ветки создаются от `main`. Изменения попадают в `release-0` через перелитие. Агент не должен создавать ветки от `release-0` и не должен мерджить в неё напрямую.
+
+**Единственное исключение** — skill `release-react17` в рамках выпуска релиза:
+он мержит `main` в `release-0` и пушит напрямую, без PR. Там это компенсируется
+обязательными локальными гейтами (`tsc`, `test-unit`, `build`) и показом diff
+разработчику — `ci.yml` триггерится только на `pull_request` и прямой push
+не проверяет. Вне релиза перелитие остаётся за мейнтейнерами.
 
 ---
 
 ## Формат коммитов
 
-**Формат:** `TRIPLEX-XXX Краткое описание`
+**Формат:** `TRI-XXX Краткое описание`
 
 ```text
-TRIPLEX-844 Добавить AI-Ready документацию для компонентов
-TRIPLEX-901 Добавить компонент Badge с темами и размерами
-TRIPLEX-912 Исправить стиль фокуса для Button в теме Link
+TRI-12 Добавить компонент Badge с темами и размерами
+TRI-15 Исправить стиль фокуса для Button в теме Link
 ```
 
 Если нужно уточнение — добавляй через двоеточие:
 
 ```text
-TRIPLEX-844 AI-Ready Design System: фундамент и пилот Button
-TRIPLEX-901 Badge: добавить тему DANGER и размер SM
+TRI-12 Badge: добавить тему DANGER и размер SM
+TRI-21 Alert: AI refactoring + unit-тесты
 ```
 
 **Правила:**
-- Все коммиты в ветке начинаются с одного номера тикета.
+- Все коммиты в ветке начинаются с одного номера задачи.
 - Первая строка — не длиннее 72 символов.
 - Тело коммита опционально (для сложных изменений).
 - Язык: русский или английский — не смешивать в одном коммите.
@@ -99,30 +122,101 @@ npx prettier --write src/components/Button/Button.tsx
 
 ## Когда коммитить и пушить
 
-**Агент не создаёт коммиты самостоятельно.** После завершения задачи — остановиться и показать результат разработчику. Коммит делается только по явной просьбе.
-
-**Агент не пушит ветку самостоятельно.** Пуш — только по явной просьбе разработчика.
+**Вне задачи Linear агент не создаёт коммиты и не пушит самостоятельно.**
+После завершения работы — остановиться и показать результат разработчику.
+Коммит и пуш — только по явной просьбе.
+
+**Исключение — работа по задаче Linear.** Если работа ведётся в ветке задачи
+`TRI-XXX-...` (взятой через skill `take-task`), агент после завершения работ
+и зелёного ревью (`change-reviewer`) **без подтверждения**:
+
+1. делает коммит по конвенциям этого файла (skill `commit-component`);
+2. пушит ветку;
+3. создаёт PR (см. «PR-воркфлоу»);
+4. если менялись stories или визуал компонентов — обновляет baseline-скриншоты
+   через skill `update-visual-baselines` (CI-workflow «Update Visual
+   Snapshots» + чистка orphan-скриншотов);
+5. запускает skill `finish-task` — комментарий-резюме публикуется в задачу
+   без подтверждения, проверяется линковка PR;
+6. запускает агента `pr-reviewer` — независимое ревью PR «с чистого листа»
+   с комментариями в GitHub (только COMMENT, вердикт и мерж за человеком).
+
+Гейты остаются обязательными и в автоматическом режиме — при любом из них
+остановиться и спросить разработчика:
+
+- упавшие проверки (tsc / vitest / eslint);
+- изменение публичного поведения без записи в release notes;
+- блокеры от `change-reviewer`;
+- подозрительные/посторонние файлы в `git status`.
 
 ---
 
-## PR-воркфлоу
+## GitHub-операции от аккаунта бота
+
+Автоматические GitHub-операции (создание PR, комментарии в PR, запуск
+workflow, авторство коммитов автофинала) выполняются от отдельного
+machine-аккаунта, если у разработчика задан его токен:
+
+```bash
+# fine-grained PAT бота: contents:write, pull-requests:write, actions:write
+export TRIPLEX_BOT_GH_TOKEN=...   # в ~/.zshenv (не ~/.zshrc — агент работает
+                                  # в неинтерактивном shell), НЕ в репозитории
+```
+
+**Паттерн для агентов** — в начале Bash-вызова с командами `gh`:
+
+```bash
+if [ -n "$TRIPLEX_BOT_GH_TOKEN" ]; then export GH_TOKEN="$TRIPLEX_BOT_GH_TOKEN"; fi
+gh pr create ...   # выполнится от бота; без токена — от разработчика (fallback)
+```
 
-**Агент пушит ветку — разработчик создаёт PR.**
+**Авторство коммитов автофинала** (identity бота выводится из токена,
+дополнительные переменные не нужны):
 
 ```bash
-git push -u origin TRIPLEX-XXX-feature-name
+if [ -n "$TRIPLEX_BOT_GH_TOKEN" ]; then
+  BOT_LOGIN=$(GH_TOKEN="$TRIPLEX_BOT_GH_TOKEN" gh api user -q .login)
+  BOT_EMAIL=$(GH_TOKEN="$TRIPLEX_BOT_GH_TOKEN" gh api user -q '"\(.id)+\(.login)@users.noreply.github.com"')
+  git -c user.name="$BOT_LOGIN" -c user.email="$BOT_EMAIL" commit -m "..."
+else
+  git commit -m "..."
+fi
 ```
 
-После пуша разработчик сам открывает PR через GitHub UI или `gh pr create`.
+Правила:
+
+- Токен нигде не печатать, не логировать и не коммитить; в репозитории
+  он не хранится ни в каком виде.
+- `git push` остаётся по SSH разработчика — авторство коммита и аккаунт
+  пушащего могут различаться, это нормально.
+- Проверка «кто я» перед автофиналом: `gh api user -q .login`
+  (с учётом паттерна выше) — чтобы в отчёте было видно, от чьего имени
+  созданы PR/комментарии.
+- Действия в Linear выполняются от сессии разработчика — бот на них
+  не распространяется.
 
-**Исключение:** если разработчик явно просит агента создать PR, используй:
+---
+
+## PR-воркфлоу
+
+**Работа по задаче Linear:** после коммита агент сам пушит ветку и создаёт PR:
 
 ```bash
+git push -u origin TRI-XXX-feature-name
 gh pr create \
-  --title "TRIPLEX-XXX Краткое описание" \
+  --title "TRI-XXX Краткое описание" \
   --body "## Что сделано\n- ...\n\n## Как проверить\n- ..."
 ```
 
+После создания PR финал продолжается автоматически: skill
+`update-visual-baselines` (если менялись stories/визуал) и skill
+`finish-task` — комментарий-резюме в задаче Linear и проверка линковки PR
+(GitHub-интеграция Linear подхватит PR по `TRI-XXX` в имени ветки).
+
+**Вне задачи Linear:** агент пушит ветку и создаёт PR только по явной просьбе
+разработчика; по умолчанию PR открывает разработчик через GitHub UI или
+`gh pr create`.
+
 ---
 
 ## Release notes

package/bundle/guides/context.md

@@ -267,7 +267,7 @@ AI-агента.
 
 | Создаём AI.md | Описываем в родителе |
 |---|---|
-| `List`, `ListItem`, `ListItemTable`, `ListItemSelectable`, `ListItemControlsButton`, `ListItemControlsButtonDropdown`, `ListSortable`, `ListSortableItem` | `ListItemControls`, `ListItemContent`, `ListEmptyState`, `ListItemLoading`, `ListItemTailLeft`, `ListItemTailRight`, `ListSortableItemTarget`, `ListSortableItemControls` |
+| `List`, `ListItem`, `ListActionItem`, `ListTableItem`, `ListItemSelectable`, `ListItemControlsButton`, `ListItemControlsButtonDropdown`, `ListSortable`, `ListSortableItem` | `ListItemControls`, `ListItemContent`, `ListEmptyState`, `ListItemLoading`, `ListItemTailLeft`, `ListItemTailRight`, `ListSortableItemTarget`, `ListSortableItemControls` |
 
 В ROADMAP-таблице каждый AI.md-достойный компонент идёт отдельной строкой —
 так считается прогресс покрытия и видны субкомпоненты с собственным API.

package/bundle/guides/tests.md

@@ -38,6 +38,48 @@ src/components/{ComponentName}/__tests__/{ComponentName}.test.tsx
 
 Один файл на компонент. Если компонент имеет субкомпоненты (ButtonIcon, ButtonDropdown), тесты субкомпонентов — в отдельных файлах той же локальной папки тестов.
 
+### Импорты `vitest` — только в `*.test.ts` / `*.test.tsx` ⚠️
+
+**Правило:** `import ... from "vitest"` (а также `@testing-library/*`, `storybook/test`)
+допустим **исключительно** в файлах с постфиксом `.test.ts` / `.test.tsx`,
+в `vitest.setup.ts` и в `test-utils/`. Нигде больше.
+
+Причина — сборка. `vite.config.ts` строит entry-точку из **каждого** файла
+`src/**/*.{ts,tsx}`, кроме исключённых глобом. Любой файл внутри `src/`, который
+импортирует `vitest` и не подпадает под исключения, попадает в бандл, а вместе с
+ним vitest уезжает в общий чанк `vendor` — тот самый, который тянут почти все
+компоненты. Потребитель падает на старте:
+
+```text
+Uncaught Error: Vitest failed to access its internal state.
+```
+
+Именно это произошло в 1.39.0 из-за файла `src/components/Carousel/__tests__/utils.ts`
+(хелпер без постфикса `.test`). Чанк `vendor` вырос с 640 KB до 1.28 MB.
+
+**Общие тестовые хелперы** (моки `ResizeObserver`, фейковые `Touch`, подмена
+размеров элементов и т.п.) кладём в `test-utils/` в корне репозитория — вне `src/`,
+поэтому сборка их физически не видит:
+
+```typescript
+// ✅ src/components/Carousel/__tests__/CarouselRoot.test.tsx
+import { getResizeCallback, mockElementSize } from "../../../../test-utils/dom";
+
+// ❌ src/components/Carousel/__tests__/utils.ts — станет entry-точкой сборки
+import { vi } from "vitest";
+```
+
+Не называй хелпер `utils.ts` рядом с `utils.test.tsx`: `__tests__/utils.test.tsx` —
+это **тесты для `../utils.ts`** компонента, а не тесты хелпера. Хелперы нельзя
+класть и в сам `*.test.tsx`-файл: при импорте из другого теста его `describe`
+зарегистрируется повторно и тесты прогонятся несколько раз.
+
+Страховка на уровне сборки: `npm run build` запускает `scripts/checkBundleSize.js`
+и падает, если в `dist` превышен один из двух лимитов — **700 KB на отдельный
+JS-файл** (ловит распухший `vendor`: всё из `node_modules` сливается в него
+единственным чанком) или **2000 KB суммарно по всем JS-файлам** (ловит утечку
+кода мимо `node_modules` и медленный рост множества мелких файлов).
+
 ### Импорты
 
 ```typescript