runtime

type ConcurrentContext interface {
	corectx.Context
	corectx.ConcurrentContextProvider
	async.Caller
	fmt.Stringer

	// Name 获取名称
	Name() string
	// Id 获取运行时Id
	Id() uid.Id
	// contains filtered or unexported methods
}

type ConcurrentContextProvider = corectx.ConcurrentContextProvider

type Context interface {
	corectx.Context
	corectx.CurrentContextProvider
	reinterpret.InstanceProvider
	extension.AddInProvider
	async.Caller
	GCCollector
	fmt.Stringer

	// Name 获取名称
	Name() string
	// Id 获取运行时Id
	Id() uid.Id
	// Reflected 获取反射值
	Reflected() reflect.Value
	// Frame 获取帧
	Frame() Frame
	// EntityManager 获取实体管理器
	EntityManager() EntityManager
	// EntityTree 获取实体树
	EntityTree() EntityTree
	// Managed 托管事件句柄
	Managed() *event.ManagedHandles

	IContextRunningEventTab
	// contains filtered or unexported methods
}

type ContextBehavior struct {
	corectx.ContextBehavior
	// contains filtered or unexported fields
}

type ContextOptions struct {
	InstanceFace   iface.Face[Context]           // 实例，用于扩展运行时上下文能力
	Context        context.Context               // 父Context
	AutoRecover    bool                          // 是否开启panic时自动恢复
	ReportError    chan error                    // panic时错误写入的error channel
	Name           string                        // 运行时名称
	PersistId      uid.Id                        // 运行时持久化Id
	AddInManager   extension.RuntimeAddInManager // 插件管理器
	RunningEventCB RunningEventCB                // 运行事件回调
}

type CurrentContextProvider = corectx.CurrentContextProvider

type EntityManager interface {
	corectx.CurrentContextProvider

	// AddEntity 添加实体
	AddEntity(entity ec.Entity) error
	// RemoveEntity 删除实体
	RemoveEntity(id uid.Id)
	// GetEntity 查询实体
	GetEntity(id uid.Id) (ec.Entity, bool)
	// RangeEntities 遍历所有实体
	RangeEntities(fun generic.Func1[ec.Entity, bool])
	// EachEntities 遍历每个实体
	EachEntities(fun generic.Action1[ec.Entity])
	// ReversedRangeEntities 反向遍历所有实体
	ReversedRangeEntities(fun generic.Func1[ec.Entity, bool])
	// ReversedEachEntities 反向遍历每个实体
	ReversedEachEntities(fun generic.Action1[ec.Entity])
	// FilterEntities 过滤并获取实体
	FilterEntities(fun generic.Func1[ec.Entity, bool]) []ec.Entity
	// ListEntities 获取所有实体
	ListEntities() []ec.Entity
	// CountEntities 获取实体数量
	CountEntities() int

	IEntityManagerEventTab
}

type EntityTree interface {
	corectx.CurrentContextProvider

	// MakeRoot 创建根节点
	MakeRoot(entityId uid.Id) error
	// AddChild 新增子节点
	AddChild(parentId, childId uid.Id) error
	// RemoveNode 删除子节点，会后序遍历递归删除所有子节点
	RemoveNode(childId uid.Id) error
	// DetachNode 脱离父节点，成为根节点
	DetachNode(childId uid.Id) error
	// MoveNode 修改父节点
	MoveNode(childId, parentId uid.Id) error
	// IsFreedom 是否是自由节点
	IsFreedom(entityId uid.Id) (bool, error)
	// IsRoot 是否是根节点
	IsRoot(entityId uid.Id) (bool, error)
	// IsLeaf 是否是叶子节点
	IsLeaf(entityId uid.Id) (bool, error)
	// GetParent 获取父实体
	GetParent(childId uid.Id) (ec.Entity, error)
	// RangeChildren 遍历所有子节点
	RangeChildren(parentId uid.Id, fun generic.Func1[ec.Entity, bool]) error
	// EachChildren 遍历每个子节点
	EachChildren(parentId uid.Id, fun generic.Action1[ec.Entity]) error
	// ReversedRangeChildren 反向遍历所有子节点
	ReversedRangeChildren(parentId uid.Id, fun generic.Func1[ec.Entity, bool]) error
	// ReversedEachChildren 反向遍历每个子节点
	ReversedEachChildren(parentId uid.Id, fun generic.Action1[ec.Entity]) error
	// FilterChildren 过滤并获取子节点
	FilterChildren(parentId uid.Id, fun generic.Func1[ec.Entity, bool]) ([]ec.Entity, error)
	// ListChildren 获取所有子节点
	ListChildren(parentId uid.Id) ([]ec.Entity, error)
	// CountChildren 获取子节点数量
	CountChildren(parentId uid.Id) (int, error)

	IEntityTreeEventTab
}

type EventContextRunningEvent interface {
	OnContextRunningEvent(ctx Context, runningEvent RunningEvent, args ...any)
}

type EventContextRunningEventHandler func(ctx Context, runningEvent RunningEvent, args ...any)

type EventEntityManagerAddEntity interface {
	OnEntityManagerAddEntity(entityManager EntityManager, entity ec.Entity)
}

type EventEntityManagerAddEntityHandler func(entityManager EntityManager, entity ec.Entity)

type EventEntityManagerEntityAddComponents interface {
	OnEntityManagerEntityAddComponents(entityManager EntityManager, entity ec.Entity, components []ec.Component)
}

type EventEntityManagerEntityAddComponentsHandler func(entityManager EntityManager, entity ec.Entity, components []ec.Component)

type EventEntityManagerEntityComponentEnableChanged interface {
	OnEntityManagerEntityComponentEnableChanged(entityManager EntityManager, entity ec.Entity, component ec.Component, enable bool)
}

type EventEntityManagerEntityComponentEnableChangedHandler func(entityManager EntityManager, entity ec.Entity, component ec.Component, enable bool)

type EventEntityManagerEntityFirstTouchComponent interface {
	OnEntityManagerEntityFirstTouchComponent(entityManager EntityManager, entity ec.Entity, component ec.Component)
}

type EventEntityManagerEntityFirstTouchComponentHandler func(entityManager EntityManager, entity ec.Entity, component ec.Component)

type EventEntityManagerEntityRemoveComponent interface {
	OnEntityManagerEntityRemoveComponent(entityManager EntityManager, entity ec.Entity, component ec.Component)
}

type EventEntityManagerEntityRemoveComponentHandler func(entityManager EntityManager, entity ec.Entity, component ec.Component)

type EventEntityManagerRemoveEntity interface {
	OnEntityManagerRemoveEntity(entityManager EntityManager, entity ec.Entity)
}

type EventEntityManagerRemoveEntityHandler func(entityManager EntityManager, entity ec.Entity)

type EventEntityTreeAddNode interface {
	OnEntityTreeAddNode(entityTree EntityTree, parentId, childId uid.Id)
}

type EventEntityTreeAddNodeHandler func(entityTree EntityTree, parentId, childId uid.Id)

type EventEntityTreeMoveNode interface {
	OnEntityTreeMoveNode(entityTree EntityTree, childId, fromParentId, toParentId uid.Id)
}

type EventEntityTreeMoveNodeHandler func(entityTree EntityTree, childId, fromParentId, toParentId uid.Id)

type EventEntityTreeRemoveNode interface {
	OnEntityTreeRemoveNode(entityTree EntityTree, parentId, childId uid.Id)
}

type EventEntityTreeRemoveNodeHandler func(entityTree EntityTree, parentId, childId uid.Id)

type Frame interface {
	// TargetFPS 获取目标FPS
	TargetFPS() float64
	// CurFPS 获取当前FPS
	CurFPS() float64
	// TotalFrames 获取运行帧数上限
	TotalFrames() int64
	// CurFrames 获取当前帧数
	CurFrames() int64
	// RunningBeginTime 获取运行开始时间
	RunningBeginTime() time.Time
	// RunningElapseTime 获取运行持续时间
	RunningElapseTime() time.Duration
	// LoopBeginTime 获取当前帧循环开始时间（包含异步调用）
	LoopBeginTime() time.Time
	// LastLoopElapseTime 获取上一帧循环耗时（包含异步调用）
	LastLoopElapseTime() time.Duration
	// UpdateBeginTime 获取当前帧更新开始时间
	UpdateBeginTime() time.Time
	// LastUpdateElapseTime 获取上一次帧更新耗时
	LastUpdateElapseTime() time.Duration
}

type GC interface {
	// GC GC
	GC()
	// NeedGC 是否需要GC
	NeedGC() bool
}

type GCCollector interface {
	// CollectGC 收集GC
	CollectGC(gc GC)
}

type IContextRunningEventTab interface {
	EventContextRunningEvent() event.IEvent
}

type IEntityManagerEventTab interface {
	EventEntityManagerAddEntity() event.IEvent
	EventEntityManagerRemoveEntity() event.IEvent
	EventEntityManagerEntityAddComponents() event.IEvent
	EventEntityManagerEntityRemoveComponent() event.IEvent
	EventEntityManagerEntityComponentEnableChanged() event.IEvent
	EventEntityManagerEntityFirstTouchComponent() event.IEvent
}

type IEntityTreeEventTab interface {
	EventEntityTreeAddNode() event.IEvent
	EventEntityTreeRemoveNode() event.IEvent
	EventEntityTreeMoveNode() event.IEvent
}

type RunningEvent int32

type RunningEventCB = generic.ActionVar2[Context, RunningEvent, any] // 运行事件回调