# twitch-panel-bio

Twitch Panel Extension: одна панель (318×496), внутри — несколько документов.
Контент — Markdown из git-репозитория: push → CI собирает → зрители видят новое
через ≤5 минут. Никаких бэкендов и кнопок «обновить».

## Структура

```
viewer.html / config.html      входы (single-file билд, один файл каждый)
src/viewer/                    вьювер: пейджер документов, тема Twitch
src/config/                    панель управления (Creator Dashboard): порядок/скрытие
src/shared/DocRenderer.svelte  рекурсивный рендерер JSON-AST (без {@html})
builder/                       валидация MD по белому списку → JSON-AST, sharp-картинки
content/docs/*.md              документы (front-matter: title обязателен, order/hidden/header)
.github/workflows/publish.yml  CI: push в main → ветка `published` (index.json + docs + img)
config.json                    ← впиши сюда repo: "user/repo"
```

## Команды

| Команда | Что делает |
|---|---|
| `npm run dev` | dev-сервер (HTTPS :8080): `/viewer.html` и `/config.html` |
| `npm run build` | два single-file билда → `dist/pkg/` (viewer.html + config.html) — это zip-билд |
| `npm run build:content` | контент: `content/` → `out/` (index.json, docs/*.json, img/*.webp) |

Локально билдер требует заполненного `config.json`; в CI SHA коммита подставляется автоматически.

## Контент

- Документы: `content/docs/<id>.md`. Front-matter: `title` (обязателен), `order` (число),
  `hidden` (bool), `header` (путь к заголовочной картинке от `content/assets/`).
- Картинки в тексте: `![](картинка.png)` — путь относительно .md; билдер жмёт в WebP
  (макс. ширина 640) и переписывает на иммутабельный jsDelivr-URL. Битые пути = ошибка сборки.
- Заголовочные картинки режутся в 636×340 (панель 318×170 @2x, object-fit: cover).
- Белый список: заголовки, абзацы, **жирный**/*курсив*/~~зачёркнутый~~, списки (включая
  GFM-чекбоксы), ссылки (только http/https), картинки, цитаты, `---`. Всё прочее
  (HTML, код-блоки, таблицы) — ошибка сборки с файлом:строкой.

## Доставка

CI (`push` в `main`) собирает `out/` и коммитит в ветку `published` (peaceiris/actions-gh-pages,
история сохраняется). Вьювер читает `raw.githubusercontent.com/<repo>/published/index.json`
(кэш 5 мин), документы — по абсолютным jsDelivr-URL с SHA коммита (иммутабельные).
Конфиг-сегмент Twitch хранит только per-channel исключения: `{v:1, hidden:[], order:[]}`.

## Чеклист Twitch-консоли (dev.twitch.tv → Console)

1. Create Extension → тип **Panel**, заполнить имя/описание.
2. **Asset Hosting**: Base URI `https://localhost:8080/` (для Local Test);
   Panel Viewer Path = `/viewer.html`; Panel Config Path = `/config.html`.
3. **CSP**: connect-src — `raw.githubusercontent.com`, `cdn.jsdelivr.net`;
   img-src — `cdn.jsdelivr.net` (добавить raw, если картинки будут там).
4. Загрузить zip из `dist/pkg/` (Files → Upload Version).
5. Local Test → Activate на своём канале (ревью не нужно). Публичный релиз —
   Hosted Test → Review (walkthrough + change log).

Pop-out отключить нельзя — это кнопка UI Twitch. Скрипт Helper (`twitch-ext.min.js`)
обязателен в обоих HTML — уже подключён.