/*
 * pop_guard.h — СОСТОЯНИЕ стража и точки входа в его логику.
 *
 * Разделение по окнам (docs/layout_plan_v2.md §4, подтверждено пробником
 * tests/w3bankgfx):
 *   - СОСТОЯНИЕ живёт здесь, в W1/W2.  Писучие статики __banked-модуля
 *     линкуются В СТРАНИЦУ БАНКА и снаружи не читаются, поэтому банк —
 *     только код;
 *   - ЛОГИКА (ИИ, боёвка) — в guards.c, собираемом как --bank 1=guards.c;
 *   - ОТРИСОВКА стража — в pop_gdraw.c, РЕЗИДЕНТЕ W3 (--w3): её зовёт
 *     только главный цикл, а из банка резидент недостижим.  Так код
 *     отрисовки не занимает дефицитные W1/W2 (куча).
 *
 * Поля char_type — как в оригинале (types.h:302), чтобы порт seg005/seg006
 * ложился один в один.
 */
#ifndef POP_GUARD_H
#define POP_GUARD_H

#include <stdint.h>
#include "kid_data.h"          /* kframe */

/* charids (types.h:320) — нужны хотя бы для «скелет не убивается читом». */
#define CHARID_0_KID       0
#define CHARID_1_SHADOW    1
#define CHARID_2_GUARD     2
#define CHARID_4_SKELETON  4
#define CHARID_5_PRINCESS  5

typedef struct {
    uint8_t frame;
    uint8_t x, y;
    int8_t  direction;
    int8_t  curr_col, curr_row;
    uint8_t action;
    int8_t  fall_x, fall_y;
    uint8_t room;
    uint8_t repeat;
    uint8_t charid;
    uint8_t sword;
    int8_t  alive;          /* -1 = жив (как в оригинале), 0 = убит */
    uint16_t curr_seq;
} pop_char_t;

extern pop_char_t Guard;            /* страж ТЕКУЩЕЙ комнаты (как в оригинале) */
extern uint8_t  guardhp_curr, guardhp_max;
extern int8_t   guardhp_delta;      /* <0 = в этом кадре отняли HP */

/* Текущий кадр стража (порт cur_frame для Char): заполняет логика в W1/W2,
 * читает отрисовка в резиденте W3.  image == 255 — рисовать нечего. */
extern kframe pop_gframe;
void pop_guard_load_frame(void);

/* Есть ли живой страж в отрисованной комнате (для главного цикла). */
uint8_t pop_guard_present(void);

/* Атласы стража (GUARD\\g0..g4.atl) — грузить ДО initgraph, как Kid.
 * 0 — OK, -1 — ошибка (тогда страж просто не рисуется). */
int  pop_guard_load(void);
void pop_guard_free(void);

/* Вход в комнату: поднять стража из данных уровня (порт enter_guard,
 * seg002:0112) либо убрать его, если в комнате стража нет. */
void pop_guard_enter(uint8_t room);

/* Нарисовать текущий кадр стража на back-странице (банк GFX_BANK_SPRITE,
 * как kid_draw) и стереть прошлый (heal).  Реализация — pop_gdraw.c
 * (резидент W3), поэтому звать ТОЛЬКО из главного цикла, не из банка. */
void pop_guard_heal(void);
void pop_guard_draw(void);

/* Убрать стража со сцены (смена комнаты / инициализация). */
void pop_guard_reset(void);

/* Чит «убить стража» (seg000:786, K): скелета не берёт.  Вызывать только
 * при включённых читах — проверку делает вызывающий. */
void pop_guard_kill(void);

/* Тик логики стража — В БАНКЕ (guards.c).  Состояние берёт отсюда. */
void pop_guard_tick(void) __banked;

#endif