libbgi: funcptr-диспетч clip/noclip спрайтовых ядер + снятие src[0]-фикса

Диспетчеризация clip/noclip через указатели _gfx_blit_fn/_gfx_heal_fn
(common/_gfx_sprite_fns.c, дефолт clip): gfx_sprite_clip() — теперь
модуль, переключает указатели один раз; sprite_update/putsprite/
movesprite зовут через указатель — ветка if(clip) из горячего цикла
убрана (съедала половину выигрыша noclip). Программа без вызова
gfx_sprite_clip() noclip-ядра не линкует.

Замер dev-MAME (16 шаров, uncapped): clip 50 → noclip 60-61 fps
(+20-22%). Регресс tests/sprites (A/B PASS), size-check OK
(balls −237 Б, sprites −3177 Б — отвязались лишние ядра).

Фикс CPU-байта write-триггера (preread + EX AF,AF') снят: точная
dev-MAME эмулирует ПЛМ, подавляющую CPU-байт при активном burst'е —
подтверждено по байтам VRAM (tests/blitw col0 = GREEN через
read_vram MCP-моста). Для heal фикс был избыточен всегда (банк 0x50
перезаписывает dst[0]). Строки фикса оставлены закомментированными
в трёх leaf'ах на случай отличий реального железа; шапки и §9а/§9б
дизайна обновлены. НА ЖЕЛЕЗЕ ПЕРЕПРОВЕРИТЬ.

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

docs/TODO.md

@@ -150,19 +150,18 @@ Quick wins:
       blitw/bgi_img/sprites/balls — 1:1.  Остатки разрыва с asm-
       референсом — C-обвязка вызовов (batch-пасс, см. ниже) и спец-
       blit-leaf (dstride 0: −30Т/строку — делать по замеру).
-- [ ] **batch-пасс для спрайтов** (движок v2, §9.1) — В РАБОТЕ 2026-07-12.
-      Разрыв ~2× с asm-референсом (docs/samples/balls) — это НЕ
-      W3-скобка (_bgi_begin = 5 инструкций, ~35Т), а per-call
-      C-обвязка, повторяемая 2×N раз: полный клип (528/362 Б),
-      парс заголовка img, save/restore банка, SDCC-фрейм 7-арг вызова.
-      Референс всё это платит ОДИН раз на проход: W3 замаплен на видео
-      на всю программу (в цикле не трогает), банк-подрежим ставит один
-      `out` на проход (0x5C рисовать всё → 0x50 лечить всё), DI держит
-      на весь проход.  Движок v2 повторяет это (per-pass W3/банк/клип-
-      fast-path, адресация из кэша w,h в структуре), НО DI оставляем
-      гранулярным (по строке в leaf) — референс держит длинный DI
-      только потому, что у него нет аудио-ISR; под CBL/IM2 длинный DI
-      сорвёт звук (docs/accel-fill-budget.md).
+- [x] ~~**batch-пасс для спрайтов** (движок v2, §9.1)~~ — СДЕЛАНО
+      2026-07-12/13: движок v2 (sprite.h: sprite_init/update/flip,
+      retained per-page dirty), два прохода heal→blit под одной
+      W3-скобкой/банком, спец-leaf'ы `_bgi_blit_rows_raw` (dstride 0,
+      SMC sstride) и `_bgi_heal_rows_raw`, лин-ядра ≤64×64, ОДИН DI на
+      спрайт (санкция 2026-07-12), noclip-ядра + funcptr-диспетч
+      `_gfx_blit_fn`/`_gfx_heal_fn` (см. sprite-api-design §9б).
+      Замер dev-MAME 16 шаров uncapped: clip 50 → noclip 60-61 fps
+      (+20-22%); с vsync-капом кадр < 20 мс.  Исходный уровень был
+      24 fps.  (Диагноз разрыва с asm-референсом — per-call C-обвязка,
+      не W3-скобка — и путь оптимизации описаны в sprite-api-design
+      §9-9б.)  На железе перепроверить снятие src[0]-фикса (§9а).
 - [ ] клип fast-path «прямоугольник целиком на экране» в gfx_blit_part
       (4 сравнения вместо полного пути) — делается в _gfx_blit_full/
       _gfx_heal_full вместе с batch-пассом.

docs/size_baseline.tsv

@@ -3,7 +3,7 @@ accfill	3772
 argv	3431
 assrtest	3847
 attrprob	4087
-balls	6393
+balls	6156
 banked	1056
 bankedbg	1067
 banklocl	4683
@@ -44,7 +44,7 @@ seek	4188
 simple	955
 solidt	11531
 spriteclip	4187
-sprites	9968
+sprites	6791
 stattest	7549
 stdlib	6643
 stest2	3644

docs/sprite-api-design.md

@@ -562,13 +562,44 @@ for (;;) {
 невидима (burst перезаписывает dst[0] правильным src[0]), но при
 0x58/0x5C, если src[0] == 0xFF, перезапись скипается — на экране
 вертикальная полоса цвета последних байтов строк (симптом: клипнутые
-спрайты в tests/sprites).  Нейтрализовано в `_bgi_copy_rows_raw`:
-src[0] предчитывается до армирования и подставляется в A через
-EX AF,AF' перед триггером — CPU-байт становится src[0], корректным при
-любом банке и любой семантике первого цикла.  Регресс: tests/blitw
-(визуальная секция «trig leak»).  Подтверждено в MAME 0.283; на железе
-проверить вместе с остальным (полоса цвета — маркер, что железо делает
-так же; чистый col0 — что CPU-цикл триггера подавляется ПЛМ).
+спрайты в tests/sprites).  Было нейтрализовано в `_bgi_copy_rows_raw`:
+src[0] предчитывался до армирования и подставлялся в A через EX AF,AF'
+перед триггером.
+
+**ФИКС СНЯТ 2026-07-13.** Точная dev-MAME (сборка разработчиков
+Sprinter, `mame/sources/MAME`) эмулирует ПЛМ, подавляющую CPU-байт
+триггера при активном burst'е — квирк был артефактом стоковой MAME
+0.283.  Проверено pixel-точно: tests/blitw, col0 @(200,150) = 0x02
+GREEN по байтам VRAM (read_vram через MCP-мост).  Для heal фикс был
+избыточен всегда (банк 0x50 перезаписывает dst[0]).  Строки фикса
+оставлены закомментированными в трёх leaf'ах (_bgi_copy_rows_raw,
+_bgi_blit_rows_raw, _bgi_heal_rows_raw) — восстановить, если реальное
+железо поведёт себя как MAME 0.283 (маркер: вертикальная полоса цвета
+последних байтов строк на клипнутых/прозрачных спрайтах).  Регресс:
+tests/blitw (визуальная секция «trig leak»).  НА ЖЕЛЕЗЕ ПЕРЕПРОВЕРИТЬ.
+
+## 9б. Клип спрайтов: noclip-ядра + funcptr-диспетч (2026-07-12/13)
+
+Клип в спрайтовых ядрах стоит не только сравнений (~0.85 мс/кадр на 16
+шаров), но и codegen-эффекта: клип-код раздувает регистровое давление
+всей функции (спиллы) — поэтому рантайм-скип внутри общего ядра
+возвращает лишь малую часть.  Полный выигрыш даёт ФИЗИЧЕСКИ отдельная
+функция без клип-кода: `_gfx_blit_sprite_noclip` / `_gfx_heal_sprite_noclip`.
+
+Выбор ядра — НЕ веткой в горячем цикле (ветка `if (clip)` в
+sprite_update съедала половину выигрыша: 52 вместо 57 fps на старой
+MAME), а перенаправлением указателей `_gfx_blit_fn`/`_gfx_heal_fn`
+(common/_gfx_sprite_fns.c, дефолт — clip-ядра) один раз в
+`gfx_sprite_clip()`; sprite_update/putsprite/movesprite зовут через
+указатель.  Программа без вызова `gfx_sprite_clip()` не линкует
+noclip-ядра (на них ссылается только модуль gfx_sprite_clip.c).
+
+Замер на точной dev-MAME (16 шаров, uncapped, A/B 2026-07-13):
+clip 50 fps → noclip-funcptr 60-61 fps (**+20-22%**) — полный выигрыш
+noclip доехал до приложения.  С vsync-капом оба варианта упираются в
+~48-50 (кадр < 20 мс) — выигрыш конвертируется в запас кадра.
+ВНИМАНИЕ: noclip требует гарантии приложения, что спрайты целиком на
+экране — выход за край портит соседнюю память (tests/spriteclip).
 
 ## 10. Риски / что проверить артефактом (Фаза 0)