# Проверка 002 — этапы 2 и 3 Дата: 2026-11-13. Этапы выполнены вместе по прямому поручению пользователя. Реализация подготовлена к пользовательской приёмке; развёртывание на рабочем сервере и этапы 4–5 не выполнялись. Контракт — [runtime.md](runtime.md), задачи — [tasks.md](tasks.md). ## Реализовано - Файловая тема через site.yaml.theme.file, schema 1, шесть точных preset@1 из исходного дизайна и каталог разрешённых шрифтов в runtime-пакете. Inline tokens получают явную ошибку; отсутствие настройки у нового сайта использует minimal@1 без записи. - Единый resolver dataclass-ядра для валидации, CLI/build и обоих режимов preview. Глубокие overrides, строгие числовые диапазоны/типы, HEX, дополнительные цвета и линейные градиенты, полноценный Custom; диагностика контраста — warning. - Семантические CSS-переменные подключены после defaults. Базовая типографика, кнопки, карточки, поверхности, подписи и границы используют токены. Градиенты Hero/button/CTA применяются адресно и отключаются к однотонному fallback; outline не становится solid. Палитра админки не изменяется. - Manifest фиксирует document/effective_tokens, source_hash/render_hash/fingerprint. Воспроизводимый ID учитывает ресурсы движка и пресеты. Коллизия не перезаписывает исторический каталог, ошибки не переключают current, rollback не меняет workspace. - ContainerSettings и BlockLayout: inherit/boxed/fluid/full, max_width, адаптивные gutters и границы 700/1024. Одно поведение для Page/Entry/Display/fixed/slots, собственные контейнеры вложенных блоков и sticky корни. - Контролы ширины инспектора перенесены из design/assets/builder.js: те же подписи, варианты, классы и пояснение. Существующая цепочка htmx → HTML → JSON API → DocumentService сохраняется. API объявляет BlockLayoutDTO в OpenAPI. Обновление полей до Save не записывает страницу; props/duplicate/move/toggle и Конструктор ↔ Эксперт сохраняют layout. - Исходные конфигурации studio-site и ai-studio переведены на theme.yaml с сохранением основных цветов и тёмного Hero. Пользовательские страницы и design не менялись этой работой. Новый examples/site-studio остаётся этапом 4. ## Автоматические и интеграционные проверки Полная регрессия: **320 тестов, 0 ошибок, 0 падений, 0 пропусков**. Для старых тестов использован git HEAD `examples/studio-site`, извлечённый во временный каталог, с наложенными актуальными site.yaml/theme.yaml. Это исключает зависимость от пользовательских изменений рабочего pages/index.md. Новые проверки используют самостоятельный файловый сайт из tests/theme_fixture.py. Новые **21 проверки темы** охватывают все пресеты, независимость копий каталога, deep merge и Custom, invalid shapes/enums/ranges/boolean/NaN/Inf/огромные числа, запрещённые CSS/URL/Jinja/шрифты, limits/reserved names, stops и отключение градиентов, пути/YAML/symlink, контраст, общий CSS, manifest, воспроизводимость, изменение ресурсов без изменения source_hash, защиту live/истории и rollback. После исправления обработки огромных чисел эти 21 проверки запущены повторно. Ещё **11 проверок ширины и HTTP-интеграции** охватывают строгий BlockLayout, все режимы/наследование, отсутствие общих wrappers и утечек в nested containers, Page/Entry/Display/fixed/slots, схему snapshot/OpenAPI, операции дерева, явное сохранение и reopen, очистку nullable-полей, настоящий HTML → API transform, invalid widths, распространение ошибок темы в API/HTML/preview/publish без переключения live. Штатный validate актуального ai-studio: **0 ошибок, 0 предупреждений**; build: **14 страниц**. Отдельная базовая фикстура собирается и в установленном пакете. Проверки wheel подтверждают наличие containers.css, всех шести пресетов, fonts.json и вложенных фрагментов. Wheel установлен вне checkout и запущен без design/: разрешение всех пресетов, сборка, админская статика/шаблоны/API, ширина и отдельный preview origin с nonce bridge проходят. Ruff изменённых модулей и git diff --check проходят. Прежние broad assertRaises(Exception) в test_security.py не изменялись и проверены с исключением существующего правила B017; изменённая проверка инъекции использует новый theme.yaml/E_THEME_COLOR. OpenAPI повторно экспортирован в specs/001-antirion-admin/openapi.json. ## Настоящий браузер `scripts/qa_theme_002.py` запускает изолированные FastAPI admin/public и отдельный preview origin; данные и учётная запись временные. **Chromium 158, 8 групп приёмки**: 1. Все шесть пресетов: фактические background/text, heading weight, radius кнопки; применение и отключение градиента проверены через computed styles. 2. Три глобальных режима × девять пар section/content × девять ширин: **243 проверки геометрии пар** на 1440/1280/1024/1023/768/700/699/390/360 px. Проверены gutters, max-width, вложенная секция, sticky-header и отсутствие горизонтального overflow. Дополнительно gutters 0 и 96 на 360 px. 3. Контролы инспектора сверены с оригинальным design/builder-antirion.html: варианты/value/подписи и computed font/color/background/border/radius/height/padding совпадают. 4. Выбор секции в дереве локальный, без POST; в preview появляется выделение. 5. Изменение ширины обновляет immutable preview, сохраняя выбранную секцию и scroll (расхождение менее 3 px), файл страницы не записывается. 6. Конструктор ↔ Эксперт сохраняет исходник; изменение props сохраняет layout; Save и reload возвращают те же значения. 7. Админка проверена на 1440/1280/1024/768/390/360 px, без горизонтального overflow. 8. Нет неожиданных JS/console ошибок, нативных диалогов или внутренних API credentials в запросах браузера. Скриншоты desktop/mobile просмотрены: контролы соответствуют исходному дизайну, preview загружен и показывает выделение. Публичный тестовый сайт проверяет поведение движка; он не является переносом нового Site Studio и не подменяет визуальную приёмку этапа 4. ## Артефакты и воспроизведение `/tmp/site-engine-theme-002/`: - browser.json — браузерный отчёт и измерения; - constructor-1440.png, constructor-390.png, reference-controls-1440.png; - public-1440.png, public-390.png, public-360.png; - unittest.json и unittest.log — полная регрессия; - ai-studio-dist/current/ — штатная сборка актуального примера; - baseline/examples/studio-site/ — изолированная базовая фикстура с новыми конфигурациями темы. ```bash PYTHONPATH=src python -m unittest discover -s tests -p 'test_theme.py' -v PYTHONPATH=src python -m unittest discover -s tests -p 'test_block_layout.py' -v PYTHONPATH=src python scripts/qa_theme_002.py PYTHONPATH=src python scripts/verify_package_001.py --site /path/to/isolated-site PYTHONPATH=src python -m site_engine.cli validate examples/ai-studio PYTHONPATH=src python -m site_engine.cli build examples/ai-studio --out /tmp/ai-studio-dist ``` В этой среде использовался `/tmp/flexly-cms-htmx-check/bin/python`. Обычный запуск полной регрессии использует рабочий пример; его результаты могут отличаться при пользовательских изменениях. Системный sandbox bwrap недоступен, поэтому команды выполнялись разрешённым инструментом вне bwrap; браузер работал с loopback и без прокси. ## Пользовательская приёмка Для проверки на сервере нужна пересборка Docker-образа. Если рабочий сайт всё ещё содержит inline theme.tokens, конфигурацию нужно явно перевести на файловый контракт; автоматической миграции нет согласно принятому решению. Изменения текущих рабочих данных, переключение SITE_ROOT, публикация на сервер и коммиты не выполнялись. Root examples не коммитились. Проверить в конструкторе «Макет блока · ширина», пары Full/Boxed и Fluid/Full, вложенный блок, переключение Конструктор ↔ Эксперт, Save/reopen. Проверить файловую тему на своём контенте и отдельную публикацию/откат. Пользовательская приёмка отмечается отдельно; новый Site Studio и Theme Manager к этим этапам не относятся.