#ifndef PSXRECOMP_MDEC_H
#define PSXRECOMP_MDEC_H

#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

void mdec_init(void);
uint32_t mdec_read(uint32_t addr);
void mdec_write(uint32_t addr, uint32_t value);

void mdec_dma_write_word(uint32_t value);
uint32_t mdec_dma_read_word(void);
/* Contiguous LE bursts — bit-identical to N× word helpers; MotK FMV DMA. */
uint32_t mdec_dma_write_words(const uint32_t *src, uint32_t max_words);
uint32_t mdec_dma_read_words(uint32_t *dst, uint32_t max_words);
int mdec_dma_write_ready(void);
int mdec_dma_read_ready(void);

/* FMV detector: nonzero if a colour (15/24-bit) MDEC decode ran within the
 * last `within_frames` vblanks. Streamed video decodes continuously; the
 * widescreen present pins such frames to native 4:3 (FMVs are authored 4:3
 * and get no GTE squash to compensate the stretch). */
int mdec_recently_active(uint32_t within_frames);
/* Guest cycles since last colour decode; UINT64_MAX if never / reset. */
uint64_t mdec_color_age_cycles(void);

typedef struct MDECDebugState {
    uint32_t command;
    uint32_t expected_halfwords;
    uint32_t input_count;
    uint32_t output_size;
    uint32_t output_pos;
    uint32_t output_depth;
    uint32_t output_signed;
    uint32_t output_bit15;
    uint32_t busy;
    uint32_t input_full;
    uint32_t enable_dma_in;
    uint32_t enable_dma_out;
    uint32_t last_status;
    uint32_t decode_macroblocks;
    uint32_t decode_blocks;
    uint32_t decode_stop_reason;
    uint32_t decode_input_pos;
    uint32_t decode_input_end;
    uint32_t dma_in_words;
    uint32_t dma_out_words;
    uint32_t dma_read_underflows;
} MDECDebugState;

typedef struct MDECDebugEvent {
    uint64_t seq;
    uint32_t frame;
    uint32_t kind;
    uint32_t value;
    uint32_t command;
    uint32_t input_count;
    uint32_t expected_halfwords;
    uint32_t output_size;
    uint32_t output_pos;
    uint32_t macroblocks;
    uint32_t blocks;
    uint32_t stop_reason;
    uint32_t underruns;
} MDECDebugEvent;

/* Monotonic decode-invocation counter — frontend FMV detector samples this
 * per display-frame to detect active MDEC video (FMV) vs idle. */
uint32_t mdec_get_decode_count(void);

void mdec_debug_get_state(MDECDebugState *out);
uint64_t mdec_debug_get_event_total(void);
uint32_t mdec_debug_copy_events(uint64_t seq_lo, uint64_t seq_hi,
                                MDECDebugEvent *out, uint32_t max_count);
void mdec_debug_clear(void);
void mdec_debug_dma_in_start(uint32_t addr, uint32_t words);
void mdec_debug_dma_in_end(uint32_t addr, uint32_t words);
void mdec_debug_dma_out_start(uint32_t addr, uint32_t words);
void mdec_debug_dma_out_end(uint32_t addr, uint32_t words);

/* boot_state / savestate: full MDEC FIFO + tables (required for FMV resume). */
uint32_t mdec_snapshot_bytes(void);
void     mdec_snapshot_write(uint8_t *p);
int      mdec_snapshot_read(const uint8_t *p, uint32_t len);
/* 1 iff mdec_snapshot_read(p, len) would accept the section; mutates nothing. */
int      mdec_snapshot_validate(const uint8_t *p, uint32_t len);

#ifdef __cplusplus
}
#endif

#endif /* PSXRECOMP_MDEC_H */