# Контракт композиции и задание для ИИ

## Монтажный редактор Motion Studio

`/static/motion-studio-engine.js` экспортирует `MotionStudioEngine`. `create(id)` создаёт монтажный документ, `validate(doc)` проверяет и нормализует его, `compile(doc)` превращает в самостоятельный HTML, `decode(html)` возвращает структуру только для поддерживаемых монтажных проектов. Это чистый локальный компилятор: он не вызывает модель и не исполняет пользовательские строки как JavaScript.

Документ версии 1 содержит название, размер, четыре цвета палитры и до 12 сцен. Сцена задаёт вид (`kinetic`, `split`, `orbital`, `steps`, `stats`, `closing`), тексты, длительность 2–15 секунд, переход (`cut`, `wipe`, `iris`, `push`) и необязательное локальное изображение. Суммарная длительность — 2–60 секунд. Заголовок ограничен 90 символами, пояснение — 140, надзаголовок — 40, название показателя — 24. Для шагов разрешено до четырёх строк по 48 символов, суммарно до 200. Превышение отклоняется явно; текст не отрезается при рендере. Имена изображений принимаются только в формате `asset-<32 hex>.webp`; материал должен принадлежать владельцу проекта и быть выбран в его материалах.

Структура хранится в JSON-блоке `vizurai-motion-document` внутри HTML. Символ `<` и разделители скриптов экранируются. Сохранение и экспорт используют прежние поля проекта; новая пользовательская база или отдельная таблица монтажей не создаётся. Чужой HTML без этого блока открывается как исходник и не должен молча заменяться шаблоном.

Монтажные принципы: осмысленный первый акцент, разные планы, общий цветовой мотив, быстрый вход и время для чтения, короткие переходы, спокойный последний кадр. Входы порядка 0,4–0,7 секунды и переходы около 0,4 секунды — стартовые художественные настройки, а не стандарт или гарантия качества. Каждое движение и число вычисляется заново по абсолютному времени; обратный seek должен давать тот же кадр. Демонстрационные показатели следует явно отличать от фактов.

`/static/motion-studio-audio.js` отдельно синтезирует инструментальную WAV-дорожку с фиксированным seed. Аудио не создаётся и не проигрывается из HTML композиции. Загрузка, права владельца, квота, микширование и экспорт остаются в штатном контуре. Новые обращения к платным голосовым или музыкальным моделям требуют обычного подтверждения в соответствующей студии.

Редактор принимает один HTML-документ с CSS и JavaScript. Это собственный seek-контракт VIZURAI, использующий приёмы видео из кода. Он не является полным загрузчиком проектов HyperFrames или Remotion: многофайловые композиции и чужие CLI-скрипты автоматически не исполняются.

## Обязательное API

```javascript
window.CodeVideo = {
  async ready() { /* необязательно: дождаться собственных локальных изображений */ },
  seek(t, frame) {
    // t — секунды, frame — целый номер кадра при 30 fps.
    // Полностью задайте видимое состояние, включая скрытие ненужных элементов.
  }
};
```

Вместо этого допустима `window.__timelines.main = gsap.timeline({paused:true})`. GSAP подключён локально; Manrope доступен через `@font-face`. Внешние библиотеки с CDN не загружаются. Обычный JavaScript, SVG, Canvas, CSS-композиции и CSS 3D не ограничены перечнем стартовых шаблонов. При необходимости собственного кода библиотеки включайте его в допустимый размер исходника и соблюдайте её условия использования.

Рендер может посетить кадры в порядке 0 → середина → конец → 0. Не накапливайте позицию (`x += …`), состояние Canvas очищайте и перерисовывайте полностью. Не используйте время компьютера, незафиксированную случайность, autoplay-циклы или сетевые запросы. Геометрию измеряйте при подготовке, а не в зависимости от уже изменённого DOM. CSS-анимации при seek приостанавливаются и переводятся на заданное время.

## Содержание хорошего задания

1. Аудитория, цель и одна главная мысль.
2. Размер, продолжительность и точные пользовательские факты/числа.
3. Палитра, гарнитура, рисунок/графика, характер движения и запрещённые эффекты.
4. Сцены: интервал, видимый результат, текст, действие, переход и звук.
5. Имена собственных материалов и метки фактической озвучки.
6. Явный контракт seek, локальные ресурсы и критерии проверки.

Например: «Покажи три демонстрационных показателя на общей шкале с нулём. Данные держи в одном массиве. Подписи после появления неподвижны. Не добавляй выдуманные проценты. На последнем кадре — вывод и подпись источника». Для истории вместо списка эффектов задайте связь между сценами: какой объект приводит к следующему действию.

## Приёмка

Проверьте первый/последний кадры, середины сцен и переходы; длинные русские строки и вертикальный формат; начало и конец аудио; обратный и случайный seek. Реальный экспорт отдельно проверяет повторные кадры, размеры, длительность и полное декодирование MP4. Предпросмотр сам по себе не является подтверждением готового файла.

Шесть стартовых примеров написаны для этого режима. Три дополнительные творческие заготовки сохранены в `prompt-templates.json`. Разбор сторонних методик и архив навыков хранятся отдельно как справочные материалы: их команды не являются разрешением на покупки, передачу данных или серверное исполнение.
