AD не доходит до рендера — контракт props v2

Безопасные зоны кадра (1080×1920)

Три зоны не пересекаются. Accent живёт над фреймом, субтитры — ниже. Главный панч (крупная цифра) всегда читается.

1 · DichVideoProps v2 (TypeScript)

export type KB = "in" | "out" | "left" | "right" | "up" | "down";

export type Shot = {
  from:  number;        // старт бита, сек
  dur:   number;        // длина бита, сек
  kind:  "framed" | "caption" | "meme";
  src?:  string;        // framed/meme: файл в public/
  // ── НОВОЕ (AD-пропагация на framed) ──────────────────
  accent?: string;     // beat.text_accent — КРУПНОЕ число/слово поверх кадра (верхняя треть)
  kb?:   KB;           // beat.kenburns — направление движения кадра (было всегда "in")
  // ── существующее (caption/meme) ──────────────────────
  big?:  string;  sub?:   string;  color?: string;
  side?: "left" | "right";
};

export type Grade = {
  look: "noir" | "none";
  // noir: desaturate + contrast + cool-tint + тяжёлая виньетка
  // чистый CSS, без видео-оверлея
};

export type DichVideoProps = {
  bg:         string;    // bg_haze.mp4 (noir, дефолт) | bg_dots.mp4 | bg_flow.mp4 — НЕ bg_digital
  grade?:     Grade;    // НОВОЕ: грейд-слой по concept.look
  shots:      Shot[];
  words:      WordT[];
  audio:      AudioCfg;
  accentWords?: string[]; // авто-акцентируются в Subs
  transition?: string;
};

2 · Порядок слоёв рендера (снизу → вверх)

3 · Props-билдер remotion_props.py (НОВЫЙ, TDD)

Сигнатура:

def build_props(
    spec: ScriptSpec,
    voice: VoiceResult,
    asset_refs: list[AssetRef]
) -> dict: ...

def write_props(props: dict, slug: str) -> Path:
    # → outputs/<slug>/remotion_props.json
    ...

Маппинг полей:

Тесты (pytest · фикстура Mars)

Фикстура: outputs/mars-orbiter-metric-mixup/{script.json, voice/voice.json, assets.json}

# 8 акцентов не теряются
def test_accent_propagated(props):
    for i, beat in enumerate(spec.beats):
        assert props["shots"][i]["accent"] == beat.text_accent

# bg = bg_haze (look noir), НЕ bg_digital
def test_bg_is_haze_not_digital(props):
    assert props["bg"] == "bg_haze.mp4"

# grade.look == "noir"
def test_grade_noir(props):
    assert props["grade"]["look"] == "noir"

# kb пробрасывается
def test_kb_propagated(props):
    for i, beat in enumerate(spec.beats):
        assert props["shots"][i]["kb"] == beat.kenburns

# from/dur соответствуют voice.beats
def test_timing_from_voice_beats(props):
    for i, vbeat in enumerate(voice.beats):
        assert props["shots"][i]["from"]  == vbeat.start
        assert props["shots"][i]["dur"]   == vbeat.end - vbeat.start

# accentWords непустой
def test_accent_words_nonempty(props):
    assert len(props["accentWords"]) > 0

# music/voice basenames корректны
def test_audio_basenames(props):
    assert props["audio"]["voice"].endswith(".mp3")
    assert props["audio"]["music"] == "bed_dich.mp3"

# musicVolume voice>>music
def test_music_volume_quiet(props):
    assert props["audio"]["musicVolume"] <= 0.25

• Структура Bg / Framed / Subs / Meme / Vush / аудио-микс — только расширяем, не переписываем
• compose.py — legacy ffmpeg-путь, не наш, не трогаем
• Голос shadow — зафиксирован как дефолт, не менять
• Субтитры boxed + мейн-паттерн фрейма — геометрия неприкосновенна

• Акценты — главный панч. Раньше было 0 крупных цифр поверх кадра. Теперь каждый бит несёт visual punch через text_accent.
• Noir-грейд. documentary/investigative look пропагируется без ручного CSS. Один флаг в ScriptSpec — полный visual mood.
• Ken Burns варьируется. Кадр движется осмысленно под содержание бита, не всегда «zoom in».
• TDD обязателен. 8 тестов по Mars-фикстуре гарантируют что пропасть не откроется снова.

Что дальше

• Создать remotion_props.py — новый файл pipeline/remotion_props.py, TDD-first (8 тестов → реализация)
• Расширить DichVideo.tsx — добавить accent? + kb? в Shot, добавить grade? в DichVideoProps, создать <GradeOverlay> компонент, accent-оверлей в Framed
• Прогнать Mars — запустить remotion_props.py на фикстуре Mars-Orbiter, сверить JSON, рендер с полным AD
• Зафиксировать accent-font — подобрать и залочить шрифт для #FFC23D цифр (кандидат: Impact / Black Condensed)