SprPoP: автономное приложение, выделенное из roomtest

Порт PoP переехал в applications/SprPoP — приложение, которое собирается
само: код, оригинальные данные, конверторы ресурсов и сборка внутри одной
папки.  Наружу знает единственный путь — корень тулчейна (SPRINTER_ROOT,
по умолчанию ../..).  applications/PoP/roomtest ЗАМОРОЖЕНА и остаётся
архивом закрытых задач, багов и исполненных планов.

Скопировано из applications/PoP/roomtest@4b74478.  Перенос проверен
побайтово: собранный sprpop.exe совпал с roomtest.exe того же коммита,
все 39 дисковых ресурсов и все 16 генерируемых заголовков — тоже, host-
тесты зелёные (15/15).

Раскладка:
  src/           рукописный C (roomtest.c -> sprpop.c)
  gen/           генерируемые заголовки, в репозитории
  assets/orig/   оригинальные данные игры, вне репозитория (копирайт)
  assets/packed/ то, что ложится на диск, в раскладке диска
  tools/         конверторы; все пути — в одном tools/paths.py
  build/         выход: exe, каталоги ресурсов, hdd/, промежуточные atl/

Сборка ресурсов: assets/packed и gen — версионируемые ВХОДЫ, а не то, что
пересчитывается каждым make.  Автоматика построена на ОТСУТСТВИИ файла, а
не на таймстемпах: git не хранит времена, и в свежем клоне сравнение по
времени превращалось бы в лотерею.  Недостающий ресурс или заголовок
чинится сам, рекурсивным вызовом в ветку генерации.

Музыка собирается из любого из четырёх наборов записей (make music-mp3,
music-mt32, ...); набор входит в имя stamp'а, поэтому смена набора сама
делает музыку устаревшей.  Длины реплик больше не захардкожены: упаковщик
печатает их в gen/pop_music_ticks.h, и шкала сцены выражена через них —
иначе mt32 (реплики на 6% длиннее) молча ломал катсцену.

Тулчейн: в app.mk два обратносовместимых крючка (SRC_DIR/BUILD_DIR),
HDD_IMG стал ?=; команда сборки roomtest не изменилась.  Корневой
make host-tests переключён на SprPoP.

Подгонка тайминга катсцены с принцессой (PV_MAGIC_LEAD): сцена
render-bound и идёт ~49 тиков/с вместо 60, из-за чего кода реплики
приходила раньше молнии.  Это обход, а не лечение; разбор с замерами —
docs/BUGS_OPEN.md, записи SND-PACE-DEAD, PV-RENDER-BOUND, MUS-LEFT-TEAR.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

applications/SprPoP/src/pop_menu.h

@@ -0,0 +1,45 @@
+/*
+ * pop_menu.h — контракт pause menu (план docs/menu_settings_plan.md §10.3,
+ * этап MS0).
+ *
+ * UI НЕ вызывает gameplay-модули напрямую: меню формирует КОМАНДУ, а
+ * исполнение остаётся в главном цикле (sprpop.c).  Вся работа с меню —
+ * код, шрифты и таблицы строк — живёт в БАНКЕ 9. Флаг запроса принадлежит
+ * главному циклу (W2): это единственная резидентная граница UI.
+ */
+#ifndef POP_MENU_H
+#define POP_MENU_H
+
+#include <stdint.h>
+
+typedef enum {
+    POP_MENU_NONE = 0,          /* меню не открывалось / пункт-заглушка     */
+    POP_MENU_RESUME,            /* закрыть меню, продолжить игру            */
+    POP_MENU_QUICKSAVE,         /* то же, что F6                            */
+    POP_MENU_QUICKLOAD,         /* то же, что F9                            */
+    POP_MENU_RESTART_LEVEL,     /* штатный reset текущего уровня (без CFG)  */
+    POP_MENU_RESTART_GAME,      /* новая игра с уровня 1, настройки и SAV   */
+    POP_MENU_QUIT,              /* выход из программы (после подтверждения) */
+    POP_MENU_QUICKLOAD_BACKUP,  /* загрузить подтверждённый POP.BAK          */
+    POP_MENU_SETTINGS           /* внутренний экран Settings (не возвращается) */
+} pop_menu_cmd_t;
+
+/* Флаг запроса в sprpop.c (W2); банк читает напрямую. */
+extern uint8_t pop_menu_request;
+
+/* Загрузить/освободить EMM-атлас исходных шрифтов SDLPoP.  Вызывается из
+ * холодного boot/shutdown, не из кадрового пути. */
+int  pop_menu_init(void) __banked;
+void pop_menu_free(void) __banked;
+
+/* Граница кадра.  Запроса нет — мгновенный POP_MENU_NONE.  Меню МОДАЛЬНО:
+ * пока открыто, не возвращается (игра стоит — логика, таймер и звуковой
+ * насос главного цикла просто не выполняются); по выбору пользователя
+ * отдаёт pop_menu_cmd_t. */
+int8_t pop_menu_process(void) __banked;
+
+/* Экран Sprinter build, если он включён в POP.CFG. Вызывается после
+ * открытия raw-клавиатуры и до первого игрового кадра. */
+void pop_build_info_show(void) __banked;
+
+#endif