tickloop

type Config struct {
	// Rate is sim ticks per second (e.g. 30).
	Rate int
	// SubRate is sub-ticks per second; must be a positive multiple of Rate
	// or 0 to disable.
	SubRate int
	// MaxCatchup bounds catch-up step count when behind schedule.
	MaxCatchup int
	// Recorder receives per-tick metrics; nil → NoopRecorder.
	Recorder Recorder
	// Clock; nil → wall clock.
	Clock func() time.Time
}

type Frame struct {
	Tick uint64
	Now  time.Time
	Dt   time.Duration
}

type NoopRecorder struct{}

type Recorder interface {
	OnTick(frame Frame, took time.Duration)
	OnSubtick(frame SubtickFrame, took time.Duration)
	OnOverrun(missedTicks int)
}

type Scheduler struct {
	// contains filtered or unexported fields
}

type Subsystem interface {
	Label() string
	Step(frame Frame)
}

type SubtickFrame struct {
	Frame
	SubIndex uint8
}

type SubtickSubsystem interface {
	Subsystem
	SubStep(frame SubtickFrame)
}