libbgi: W0-атласы спрайтов — загрузчик, движок, упаковщик (все проверки PASS)

Реализация §3.1/§9в: атлас = один .atl-файл = одна EMM-страница,
подключаемая в W0 на время блита.

- atlas_load: read() файла целиком в страницу через W3 + патч ISR-стаба
  (0x38: JP _gfx_w0_isr; 0x66: RETN); atlas_free/atlas_image/
  atlas_sprite_init; gfx_w0_map/unmap для ручных вызовов.
- _gfx_w0_isr (стаб из tests/w0page): свап на ядро DSS → честный 0x38 →
  restore спрайт-страницы; покрывает IM1 и IM2-чейн.
- sprite_t.page (0 = обычная память); sprite_update в блит-проходе
  мапит страницу по смене (один OUT на атлас), эпилог возвращает DSS
  (+52 Б на движок — цена фичи).
- toolchain/mkatlas.py: PNG (indexed) / raw → .atl; заголовок 0x100,
  каталог 0x68 (19 лент), файл-офсет == офсет страницы == W0-адрес.
- Сплит _gfx_sprite_fns → _gfx_blit_fn.c + _gfx_heal_fn.c (1 указатель
  = 1 модуль): putsprite-only программа не тянет heal-ядро (spriteclip
  ловил +292 Б; теперь −68 Б от эталона).

tests/atlas (MAME dev, PASS): загрузка (count/страница), каталог и
данные по W0-адресам (заголовок ленты через gfx_w0_map), 3 спрайта из
двух лент через движок — пиксели проверены read_vram побайтно
(0x10/0x12/0x21, прозрачный угол = фон).

docs: §9г — предложение авто-анимации (кадровая ±step без умножений,
tween-Брезенхэм порциями, тикер через funcptr) — ОБСУЖДАЕТСЯ.

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

libbgi/_bgi.h

@@ -134,13 +134,27 @@ void _gfx_heal_sprite_noclip(int x, int y, uint8_t w, uint8_t h);
  * а sprite_update/putsprite/movesprite зовут через указатель — один
  * call-site, без if в цикле → тесный codegen (полный выигрыш noclip,
  * см. docs/sprite-api-design.md).  Дефолт (clip-ядра) — статическая
- * инициализация в common/_gfx_sprite_fns.c. */
+ * инициализация; указатели в РАЗДЕЛЬНЫХ data-модулях (_gfx_blit_fn.c,
+ * _gfx_heal_fn.c): putsprite-only программа не тянет heal-ядро. */
 typedef void (*_gfx_blit_fp)(int, int, const void *, int, int,
                              uint8_t, uint8_t);
 typedef void (*_gfx_heal_fp)(int, int, uint8_t, uint8_t);
 extern _gfx_blit_fp _gfx_blit_fn;
 extern _gfx_heal_fp _gfx_heal_fn;
 
+/* ---- Атласы в страницах W0 (sprite.h, §9в дизайна) ---------------- *
+ * _gfx_w0_dss — страница ядра DSS (снимается при первом map/load);
+ * _gfx_w0_cur — какая спрайт-страница должна стоять в W0 (читает
+ * ISR-стаб _gfx_w0_isr для restore после прерывания).
+ * common/_gfx_w0_state.c, _gfx_w0_isr.c. */
+extern uint8_t _gfx_w0_dss;
+extern uint8_t _gfx_w0_cur;
+void _gfx_w0_isr(void);
+
+/* Раскладка .atl-файла/страницы (вариант II, §3.1). */
+#define _ATL_DIR_OFF   0x68u    /* каталог: count × 8 Б (макс 19)     */
+#define _ATL_DATA_OFF  0x100u   /* ленты; = резерв ISR-стаба          */
+
 /* ---- Fill-burst'ы акселератора 256 (register-ABI, asm-only) ------ *
  * Вызываются ТОЛЬКО из asm raw-примитивов; аргументы в регистрах, без
  * глобального скретча в _DATA: