state

type CacheLineState struct {
	Address uint64
	State   string
	Tag     uint64
}

type CacheState struct {
	Hits       uint64
	Misses     uint64
	Accesses   uint64
	Evictions  uint64
	Writebacks uint64
	// Lines is populated only if DetailLevel >= DetailLevelFull
	Lines []CacheLineState
}

type DetailLevel int

type DirectoryEntryState struct {
	Address uint64
	State   string
	Sharers []int
	Owner   int // -1 if no owner
}

type DirectoryState struct {
	// Entries is populated only if DetailLevel >= DetailLevelFull
	Entries []DirectoryEntryState
}

type ExportConfig struct {
	DetailLevel DetailLevel
}

type Exporter[T any] interface {
	ExportState(cfg ExportConfig) T
}

type LinkState struct {
	SourceID     int
	TargetID     int
	CurrentCycle int
	Latency      int
	Bandwidth    int
	// Occupancy shows the number of packets in each time slot.
	Occupancy []int
}

type NetworkState struct {
	CurrentCycle int
	Nodes        []NodeState
	Links        []LinkState
}

type NodeState struct {
	ID           int
	Type         string // e.g., "WorkerNode", "Router"
	CurrentCycle int
	Inputs       []QueueState
	Outputs      []QueueState
	Caches       []CacheState
	Directories  []DirectoryState
	CustomData   map[string]interface{}
}

type PacketState struct {
	// PktID is a unique identifier if avail, or derived hash.
	Src   int
	Dst   int
	Cycle int    // Creation or Injection cycle
	Msg   string // Payload summary
	Type  string // Type of the packet (e.g., "Req", "Resp")
}

type QueueState struct {
	Type      string // "Input" or "Output"
	Length    int
	Capacity  int
	Bandwidth int
	Bitmap    string // "1010..." representation of occupied slots
	// Packets is a list of packet summaries.
	// In Summary mode, this might be empty or partial.
	Packets []PacketState
}