// Commander X16 Emulator
// Copyright (c) 2022 Michael Steil
// All rights reserved. License: 2-clause BSD

#pragma once

#include <stdint.h>
#include <stdbool.h>

#define IEEE_HISTORY_MAX 64

typedef enum {
	IEEE_OP_OPEN        = 0,
	IEEE_OP_OPEN_FAILED = 1,
	IEEE_OP_CLOSE       = 2,
	IEEE_OP_DIR         = 3,
	IEEE_OP_COMMAND     = 4,
	IEEE_OP_STATUS      = 5,
} ieee_op_kind_t;

typedef struct {
	uint32_t seq;           /* monotonic; 0 means "empty slot" */
	uint8_t  kind;          /* ieee_op_kind_t */
	int8_t   channel;       /* -1 when not channel-specific */
	bool     read;
	bool     write;
	char     name[80];      /* filename, command text, or status text */
	char     status[48];    /* resulting DOS status, "" if none yet */
	uint32_t bytes_read;
	uint32_t bytes_written;
} ieee_history_entry_t;

#ifdef __cplusplus
extern "C" {
#endif

void ieee_init();
int SECOND(uint8_t a);
int TKSA(uint8_t a);
int ACPTR(uint8_t *a);
int CIOUT(uint8_t a);
int UNTLK(void);
int UNLSN(void);
int LISTEN(uint8_t a);
int TALK(uint8_t a);
int MACPTR(uint16_t addr, uint16_t *count, uint8_t stream_mode);
int MCIOUT(uint16_t addr, uint16_t *count, uint8_t stream_mode);
int XMACPTR(uint8_t stream_mode);
int XMCIOUT(uint8_t stream_mode);

// ─── Debugger accessor ───────────────────────────────────────────────────────
// Side-effect-free snapshot of IEEE/hostfs state. Safe to call every frame
// from the debugger while the emulation is running.
//
// All strings are NUL-terminated copies; no pointers into emulator state.
// Per-channel bytes_read/bytes_written are cumulative since the channel was
// last opened.

typedef struct {
	bool     is_open;          // channel has an active file handle
	bool     read;             // channel is open for reading
	bool     write;            // channel is open for writing
	char     name[80];         // filename as seen by the DOS layer (NUL-terminated)
	uint32_t bytes_read;       // bytes successfully read from this channel
	uint32_t bytes_written;    // bytes successfully written to this channel
} ieee_channel_debug_t;

typedef struct {
	bool     using_hostfs;              // hostfs is active (vs CMDR-DOS block device)
	int      ieee_unit;                 // emulated device number (usually 8)
	char     hostfscwd[512];            // current host working directory (NUL-terminated)
	int      channel;                   // currently addressed channel (secondary address)
	bool     listening;                 // device is in LISTEN state
	bool     talking;                   // device is in TALK state
	bool     opening;                   // currently accumulating a filename (OPEN in progress)
	char     cmd[256];                  // last DOS command received on channel 15
	int      cmdlen;                    // valid bytes in cmd[]
	char     error_str[256];            // current error string (channel 15 status)
	ieee_channel_debug_t channels[16]; // per-channel state
	int                  history_count;                    // valid entries, oldest first
	ieee_history_entry_t history[IEEE_HISTORY_MAX];
} ieee_debug_state_t;

void ieee_debug_get_state(ieee_debug_state_t *out);

#ifdef __cplusplus
}
#endif