SprPoP: финал больше не убивает программу — прямой вызов в чужой банк

Пройденная игра доходила до таблицы рекордов и умирала: программа
исчезала, машина следом вставала намертво (di;halt на 0x0000) либо уходила
в reset.  Одинаково из Flex Navigator и из голого DSS.

КОРЕНЬ.  pop_ui.h объявлял группу pop_text_*_mapped БЕЗ __banked.  Пока
pop_hof.c лежал в банке 9 рядом с pop_ui.c, прямой call был верен; после
переноса pop_hof/pop_config/pop_pal в банк 10 тот же call стал уходить в
пустой хвост чужого банка.  Процессор полз по 0xFF до 0x0000, где ловушка
DSS ставит B=0x27 и сворачивает процесс — подмена страниц W1/W2/W3,
которую было видно на трупе, оказалась уборкой, а не причиной.

Точную инструкцию (call $E503 = _pop_text_map банка 9) дала трассировка
MAME на узком участке: trace включалась брейкпоинтом на входе в
pop_hof_show и выключалась на процедуре завершения процесса DSS (0x1E56).

ЧТО СДЕЛАНО

* pop_ui.h/.c — группа text_*_mapped помечена __banked.
* toolchain/check_bank_calls.py — две проверки банкового кода:
  1) прямой call в чужой банк (доказательна, ВАЛИТ сборку — проверено
     намеренной поломкой);
  2) указатель на данные своего банка, отданный в чужой (эвристика по
     форме кода, только предупреждает).
  Встроена в app.mk, запускается сразу после линковки.
* pop_hof.c — курсор ввода строится на стеке: литерал "_" лежал в _BANK10
  и после пометки __banked уезжал из-под ног чужому банку, заливая экран
  знаками вопроса.
* libc: kbd_raw_keypad_as_ext() — kbd_raw_sync переносит голые коды
  нумпада в EXT-половину карты.  Лечит залипание стрелок (потерянный
  префикс E0 сажал make в PLAIN как код нумпада, и снять его было нечем),
  заодно нумпад стал управлением: 7/8/9, 4/6, 2 и 5 = вниз.
* pop_pace.c — цикл ожидания луча зовёт тот же idle-хук, что и
  gfx_wait_vsync: без этого F10 в геймплее не работал вовсе.
* pop_hof.c — Esc в таблице рекордов отменяет запись (расхождение с
  оригиналом записано в docs/impl_diff.md).
* Экран версии показывается только через Menu/Settings/About: стартовый
  показ и Ctrl+V убраны, мёртвый код снят.
* sprpop_cold.c — pop_start_level зовёт pop_hp_invalidate: после Ctrl+A с
  выросшим за уровень максимумом полоса HP моргала между страницами.

Разбор всех четырёх багов — в applications/PoP/roomtest/BUGS_CLOSED.md
(FINAL-BANKCALL, FINAL-HOF-GARBAGE, KBD-ARROW-PHANTOM, F10-GAMEPLAY),
правило про банки — в applications/SprPoP/CLAUDE.md.

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

libc/kbd/_kbdraw.h

@@ -57,4 +57,28 @@ extern uint8_t _kbdraw_overrun;     /* 1 = ISR поймал Rx-overrun SIO (по
  * читает kbd_raw_down(). */
 extern uint8_t _kbdraw_down[64];
 
+/* ГОЛЫЕ КОДЫ НУМПАДА = ТЕ ЖЕ КЛАВИШИ, ЧТО И РАСШИРЕННЫЕ
+ * (взводит kbd_raw_keypad_as_ext).
+ *
+ * Стрелки приходят как E0 6B / E0 72 / E0 74 / E0 75, то есть в EXT-половину
+ * карты.  Если префикс E0 потерян (переполнение 3-байтового FIFO SIO в
+ * длинном DI-окне), make садится в PLAIN-половину как код нумпада, а его
+ * break приходит уже с префиксом и снимает бит в EXT-половине — PLAIN-бит
+ * остаётся зажатым НАВСЕГДА (BUG-KBD: 0x72 2026-08-24, 0x6B 2026-08-27).
+ *
+ * Лечится перекладкой: kbd_raw_sync() переносит биты голых кодов нумпада
+ * в EXT-половину и гасит их в PLAIN.  Тогда make без префикса ставит ТОТ ЖЕ
+ * бит, который потом снимет обычный break `E0 F0 xx`, — залипание исчезает,
+ * а нумпад заодно работает как навигационные клавиши (в PS/2 это и есть
+ * одни и те же физические клавиши).  Позиции бит совпадают: EXT — те же
+ * байты карты плюс 32.
+ *
+ * Диапазон Set 2 — 0x69..0x7D, но ESC (0x76) и F11 (0x78) лежат внутри и
+ * перекладке НЕ подлежат.
+ *
+ * Чего это не лечит: потерю префикса у BREAK (`E0 F0 6B` -> `F0 6B`).  Тогда
+ * бит остаётся стоять уже в EXT-половине, то есть выглядит как реально
+ * зажатая клавиша; снимается перенажатием или typematic-повтором. */
+extern uint8_t _kbdraw_keypad_ext;
+
 #endif