# Для AI-агентів
Каталог, документація, вихідний код і завантаження компонентів без доступу до Git.
Достатньо передати агенту адресу цього сайту. Усе для вибору та перенесення
компонентів доступне через звичайні HTTP-запити, без клонування репозиторію,
авторизації чи запуску JavaScript у браузері.
## Швидкий старт
1. Прочитайте [llms.txt](https://ui.tatet.net/llms.txt) — точку входу для агентів.
2. Знайдіть потрібні компоненти в [JSON-каталозі](https://ui.tatet.net/registry/index.json).
3. Прочитайте документацію та API за полями `markdown` і `api` компонента.
4. Отримайте його `registry` JSON або скачайте ZIP за полем `download`.
5. Перенесіть файли, підключіть CSS і встановіть зовнішні залежності, якщо вони є.
Для читання всієї документації одним запитом є [llms-full.txt](https://ui.tatet.net/llms-full.txt).
У Markdown живі демо замінені повним кодом прикладів; посилання на JSON API
дають актуальні props, події, слоти та методи. Описи подій також містяться
в тексті документації та на звичайній сторінці компонента.
## Приклад HTTP-запитів
Замініть `https://your-tatetui-site.example` на адресу відкритого сайту:
```bash
curl -fsSL https://your-tatetui-site.example/llms.txt
curl -fsSL https://your-tatetui-site.example/registry/index.json
curl -fsSL https://your-tatetui-site.example/registry/components/button.json
curl -fsSL https://your-tatetui-site.example/registry/downloads/button.zip -o button.zip
unzip button.zip -d ./tatetui-button
```
Спочатку розпакуйте в окрему папку й порівняйте зі своїм проєктом. Не
перезаписуйте вже адаптовані компоненти або токени без перегляду змін.
## Формат каталогу
[Каталог](https://ui.tatet.net/registry/index.json) має `schemaVersion: 1` і масив `components`.
Кожен елемент містить `name`, `component`, `title`, `description`, `status`,
`docs`, `markdown`, `api`, `registry` та `download`. Усі URL у JSON починаються
з `/` — додавайте origin того сайту, з якого отримали каталог.
JSON окремого компонента додатково містить:
| Поле | Призначення |
| --- | --- |
| `files` | Повний набір вихідних файлів, включно з вкладеними залежностями та базовими стилями |
| `files[].path` | Шлях у структурі Nuxt 4, наприклад `app/components/ui/UiButton.vue` |
| `files[].content` | Повний текст файлу — можна зберегти без додаткового запиту |
| `files[].url` | Пряме посилання на той самий вихідний код як текст |
| `files[].sha256` | SHA-256 вмісту для перевірки завантаження |
| `dependencies` | Зовнішні пакети та їхні версії для `bun add` |
| `peerDependencies` | Вимоги до Vue та Tailwind у цільовому проєкті |
| `overrides` | Узгодження версій, потрібне, зокрема, TipTap / ProseMirror |
| `integration` | Додаткові вимоги, наприклад NuxtLink |
| `revision` | SHA-256 набору файлів і залежностей для порівняння версій |
Архів містить ті самі вихідні файли, `registry.json`, README та документацію
компонентів і основ. Залежності визначаються за реальними імпортами рекурсивно
та доповнюються `dependsOn` з документації. Це включає внутрішні компоненти,
утиліти, composables і CSS, які не видно в одному `.vue`-файлі.
## Підключення в Nuxt 4 з Tailwind 4
Збережіть структуру `app/` з архіву. Аліас `~` має вказувати на `app/`.
У наявний CSS-файл, який уже підключено в Nuxt, додайте:
```css
@import 'tailwindcss';
@import './tokens.css';
@import './theme.css';
@import './components.css';
```
Шляхи в прикладі припускають, що CSS-файли лежать разом у `app/assets/css/`.
`components.css` містить базові стилі, утиліти прокрутки й підтримку
`prefers-reduced-motion`. Не додавайте `tailwindcss` вдруге, якщо він уже імпортований.
Tailwind має сканувати скопійовані `.vue` та `.ts` файли; для файлів поза
стандартним деревом джерел додайте `@source` у свій CSS entry point.
Для Prose та RichTextEditor також підключіть `ui-prose.css` з архіву:
```css
@import './ui-prose.css';
```
Встановіть пакети з `dependencies`; для більшості компонентів цей об'єкт
порожній. Для RichTextEditor перенесіть також `overrides` у `package.json`.
Приклад використання та доступний API беріть зі сторінки компонента.
Один раз додайте `viewport-fit=cover` до meta viewport. Тема перемикається
класом `.dark` на ``. Для перекладів підключіть
`setUiTextTranslator()` з `useUiText.ts`; деталі в [інструкції перенесення](https://ui.tatet.net/docs/copy-guide).
## Vue / Vite, Nuxt 3 та Tailwind 3
У Nuxt 3 і Vue/Vite змініть корінь файлів під структуру свого проєкту та
налаштуйте `~` на відповідний каталог джерел. У Vue/Vite компоненти імпортуються
явно; Vue API в самих компонентах уже імпортовано.
Якщо `integration` вказує на `#components`, у Vue/Vite замініть імпорт
`NuxtLink` обгорткою над Vue Router `RouterLink`, яка підтримує `to`.
Це потрібно для Button, Breadcrumb, NavigationMenu, PageHeader та StatCard,
а також для компонентів, які використовують їх усередині.
Готовий CSS в архівах орієнтований на Tailwind 4. На Tailwind 3 потрібна
адаптація `theme.css`, `@utility` та варіантів на кшталт `pointer-coarse:`.
Дивіться [Токени](https://ui.tatet.net/docs/foundations/tokens) і перевіряйте згенеровані стилі
в цільовому проєкті.
## Перевірка після перенесення
Запустіть перевірку типів і збірку цільового проєкту. Перевірте світлу та
темну теми, клавіатуру, мобільний viewport і потрібні сценарії компонента.
Дотримуйтеся статусу з каталогу: `wip` означає, що API ще змінюється.
Каталог, Markdown, вихідні тексти та ZIP генеруються під час кожної збірки
сайту з того самого коду. Для оновлень порівнюйте `revision` та хеші файлів;
спільні composables оверлеїв мають залишатися в одному екземплярі.
Source: https://ui.tatet.net/docs/agents
---
# Accordion
Розкривні секції з анімацією висоти без JS-вимірювань.
Акордеон для секцій, які мають бути під рукою, але не на виду: розкривні
налаштування, FAQ, деревоподібні фільтри. Типово кілька секцій можуть
бути відкриті одночасно; `single` лишає рівно одну — для FAQ і майстрів,
де секції взаємовиключні.
## Приклад
Example (app/demos/accordion/AccordionBasic.vue):
```vue
Назва сайту, мови версій, головна сторінка. Типові поля, які потрібні
рідко, але мають бути під рукою.
Ця секція деактивована — приклад disabled-стану.
```
## API
[Props, events, slots, exposed API (JSON)](https://ui.tatet.net/api/component-meta/UiAccordion)
## Коли використовувати
Коли вмісту більше, ніж місця, і він не потрібен одночасно весь.
Керований режим через `v-model` — коли стан відкритих секцій треба
читати або писати згори (фільтри в URL, синхронізація між панелями).
У керованому режимі стан приходить **лише** згори: клік емітить
`update:modelValue`, але секція відкриється тільки тоді, коли батько
прийме нове значення. Батько, що відхилив зміну, більше не бачить
відкритої секції, якої немає в його `modelValue`.
## Коли НЕ використовувати
Для навігаційних розділів — навігація має бути видимою, а не схованою
за кліком.
Не вкладайте акордеон в акордеон: замість ієрархії виходить лабіринт.
## Доступність
Кожен заголовок — `