api

type Composable func(Composer) Composer

type Composer interface {
	// frame time
	TimeNow() time.Time

	// --
	GetID() Identifier
	GetPath() NodePath

	modifier.ModifierAwareComposer

	// -- Composition Locals
	StartProviders(values []ProvidedValue) Composer
	EndProviders() Composer
	Consume(key interface{}) interface{}

	// -- id management
	GenerateID() Identifier

	EmitSlot(k string, v any) Composer

	TreeBuilderComposer
	GioLayoutNodeAwareComposer

	state.SupportState

	WithComposable(composable Composable) Composer

	If(condition bool, ifTrue Composable, ifFalse Composable) Composable
	IfLazy(condition bool, ifTrue func() Composable, ifFalse func() Composable) Composable

	When(condition bool, ifTrue Composable) Composable
	WhenLazy(condition bool, ifTrue func() Composable) Composable

	Else(condition bool, ifFalse Composable) Composable
	ElseLazy(condition bool, ifFalse func() Composable) Composable

	Sequence(contents ...Composable) Composable

	// Control Flow
	Key(key any, content Composable) Composable
	Range(count int, fn func(int) Composable) Composable

	// frame lifecycle
	lifecycle.FrameLifecycleAware
}

type ComposerOption func(*ComposerOptions)

type ComposerOptions struct {
	TimeNowFunc func() time.Time
	Store       state.PersistentState

	StartFrameTriggerReceiver func(trigger func())
	EndFrameTriggerReceiver   func(trigger func())
}

type GioLayoutNodeAwareComposer interface {
	//Should this not just emit the constructor to a known key in the slottble?
	SetWidgetConstructor(constructor layoutnode.LayoutNodeWidgetConstructor)
}

type Identifier = idApi.Identifier

type LayoutNode = layoutnode.LayoutNode

type MutableValue = state.MutableValue

type NodePath = node.NodePath

type ProvidedValue struct {
	CompositionLocal interface{}
	Value            interface{}
}

type TreeBuilderComposer interface {
	StartBlock(key string) Composer
	EndBlock() Composer
	Build() LayoutNode
}