libbgi: спрайтовый движок v2 + accel-блит/heal leaf'ы + noclip-путь

Спрайтовая графика поверх accel block-copy (docs/sprite-api-design.md):

- Ядро блиттинга: leaf'ы _bgi_blit_rows_raw (dst фикс, только src-страйд) /
  _bgi_copy_rows_raw (getimage) / _bgi_heal_rows_raw (src==dst). DI один на
  спрайт (санкция: малый спрайт под одним DI аудио не рвёт); src[0]-фикс
  снят (точная MAME подавляет CPU-байт триггера записи — на железе
  перепроверить; для heal был избыточен и снят безусловно).
- Общие bracket-free ядра _gfx_blit_full/_gfx_heal_full (полная ширина:
  клип по экрану + split >256 для putimage) + лин _gfx_blit_sprite/
  _gfx_heal_sprite (кадр ≤64, без split, 8-бит w/h) + noclip-варианты
  (клип-кода нет → полный codegen-win).  Имя *_full (не *_clip) — «clip»
  двусмысленно (sprite-ядра тоже клипуют; различитель — ширина/split).
- Движок retained-модели <sprite.h>: sprite_init/update/flip + inline
  move/frame/show/hide/touch; drawn[2] per-page внутри структуры; кадр —
  двухпроходно heal ВСЕ -> блит ВСЕ под одной W3-скобкой/банком на проход.
- Флаг gfx_sprite_clip(on/off): приложение, само следящее за границами,
  отключает клип (~+19% на анимации; диспетч пока через if — funcptr далее).
- putsprite/movesprite/gfx_blit/putimage(COPY)/getimage переведены на ядро.

Тесты: examples/balls (движок, дабл-буфер, boundary-тест клипа),
tests/sprites (RAM PASS, клип 4 края, атлас), tests/blitw (trig-leak),
tests/spriteclip (hardware-probe: железо НЕ режет за краем -> клип нужен),
tests/blitperf, tests/gfxbanks. size-baseline обновлён (53 программы).

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

docs/libc-reference.md

@@ -190,8 +190,13 @@ wrchar rdchar`; режимы `gettextmode/settextmode` (0x02=40×32,
 
 Setup: `gfx_init(mode,page)→prev`, `gfx_done(prev)`.
 Страницы/банк: `gfx_set/get_visible_page`, `gfx_set/get_draw_page`
-(double buffering), `gfx_set/get_bank` (0x50..0x5F, 0x58 = FF-
-прозрачность).
+(double buffering), `gfx_set/get_bank` (GFX_BANK_NORMAL 0x50 /
+NOSHADOW 0x54 / TRANSPARENT 0x58 / SPRITE 0x5C — аппаратные подрежимы
+записи, действуют на ВСЕ примитивы; см. docs/sprite-api-design.md).
+Блиттинг (Фаза B, 2026-07-11): `gfx_blit(x,y,img)`,
+`gfx_blit_part(x,y,img,sx,sy,w,h)` (атлас), `gfx_heal(x,y,w,h)`
+(восстановить фон из ОЗУ-копии; стирание спрайтов без save-буфера);
+img — getimage-формат, буфер вне W3; клиппинг по экрану есть.
 
 `gfx_wait_vsync()` (2026-07-07, редизайн): ждёт переход бита 5 порта
 0xFE из 1 в 0 — реальное аппаратное состояние луча (Y>256 → начало
@@ -234,8 +239,21 @@ CP), `line(x1,y1,x2,y2)` (не двигает).
 `fillpoly(n,pts)`, `fillellipse(x,y,xr,yr)`.
 Заливка областей (Ф2c): `floodfill(x,y,border)` (медленно, но верно),
 `pieslice(x,y,st,end,r)`, `sector(x,y,st,end,xr,yr)`.
-Спрайты (Ф2d): `imagesize/getimage/putimage` (COPY/XOR/OR/AND/NOT_PUT;
-формат буфера: uint16 w,h + w*h байт).
+Образы (Ф2d): `imagesize/getimage/putimage` (COPY/XOR/OR/AND/NOT_PUT;
+формат буфера: uint16 w,h + w*h байт).  COPY_PUT и getimage — через
+accel block-copy (2026-07-11, Фаза A sprite-api-design), COPY с
+клиппингом и текущим банком; XOR/OR/AND/NOT — per-pixel.
+Спрайты (2026-07-11, Фаза B sprite-api-design): `putsprite(x,y,img)` —
+блит getimage-буфера с аппаратной прозрачностью (0xFF =
+GFX_TRANSPARENT не пишется) банком GFX_BANK_SPRITE (0x5C, фон в
+ОЗУ-копии цел); `movesprite(ox,oy,x,y,img)` — heal старой позиции +
+putsprite новой (save-буфер не нужен).  Низкий уровень в <gfx.h>:
+`gfx_blit(x,y,img)`, `gfx_blit_part(x,y,img,sx,sy,w,h)` (атлас
+кадров), `gfx_heal(x,y,w,h)` (восстановление фона из ОЗУ-копии),
+константы GFX_BANK_NORMAL/NOSHADOW/TRANSPARENT/SPRITE.  Правило: фон
+рисовать банком 0x50, спрайты/оверлеи — putsprite/0x5C; буферы
+образов — вне W3 (< 0xC000).  Тесты: tests/sprites, tests/gfxbanks,
+tests/bgi_img.
 Стиль линий (Ф2d): `setlinestyle(style,upattern,thick)`/`getlinesettings`
 (SOLID/DOTTED/CENTER/DASHED/USERBIT + NORM/THICK) — на line/rectangle/
 drawpoly.