/* pop_intro.h — story/PV intro после оригинальной заставки (FG8). */
#ifndef POP_INTRO_H
#define POP_INTRO_H

#include "pop_flow.h"

/* Показать absence -> Princess/Jaffar -> marry -> credits. Возврат 1 —
 * пользователь прервал цепочку и надо сразу начать FIRST_LEVEL; 0 — intro
 * завершилось штатно и далее запускается attract-demo. */
uint8_t pop_intro_show(void) __banked;

/* Показать одну pre-level сцену 2/4/6/8/9/12. NONE — no-op. После любого
 * skip возвращается затемнённая игровая палитра, далее caller грузит уровень. */
void pop_pre_cutscene_show(pop_pre_cutscene_t scene) __banked;

/* Отдельная сцена истёкшего времени (PV hourglass), после которой автомат
 * возвращается в TITLE. Любой raw-ввод сокращает ожидание. */
void pop_time_expired_show(void) __banked;

/* Финал level 14: Princess room, story-screen HAIL и титульная картинка.
 * Победная тема при выходе ЕЩЁ ЗВУЧИТ: её дослушивает таблица рекордов,
 * как в end_sequence оригинала. */
void pop_ending_show(void) __banked;

/* Фон таблицы рекордов (рамка story + логотип) в заданную СКРЫТУЮ
 * страницу; -1 — ресурс не прочитан.  Ни палитры, ни показа. */
int pop_intro_hof_bg(uint8_t page) __banked;

#endif /* POP_INTRO_H */