scene

type Attrs struct {

	// MaxHeight specifies maximum height of element.
	MaxHeight basic.Opt[basic.Float]

	// MaxWidth specifies maximum width of element.
	MaxWidth basic.Opt[basic.Float]

	// MinHeight specifies minimum height of element.
	MinHeight basic.Opt[basic.Float]

	// MinWidth specifies minimum width of element.
	MinWidth basic.Opt[basic.Float]

	// PreHeight specifies preliminary height of element.
	PreHeight basic.Opt[basic.Float]

	// PreWidth specifies preliminary width of element.
	PreWidth basic.Opt[basic.Float]
}

type BaseElement[S, T, P any] struct {
	// contains filtered or unexported fields
}

type Element[S, T any] interface {

	// Trait returns trait of element.
	//
	// Trait result is valid only after refresh stage.
	Trait() T

	// IsOff reports whether element is off.
	//
	// IsOff result is valid only after refresh stage.
	IsOff() bool

	// Attrs returns attrs of element.
	//
	// Attrs result is valid only after prepare stage.
	Attrs() Attrs

	// Refresh refreshes element, e.g. by recalculating its trait and props.
	//
	// Containers should refresh all items at this stage, regardless of their statuses.
	Refresh()

	// Prepare prepares element for this iteration, e.g. by precalculating some parameters.
	//
	// Containers should prepare visible items and exclude hidden ones at this stage.
	Prepare()

	// Exclude excludes element for this iteration, e.g. by cleaning up some resources for idle time.
	//
	// Containers should exclude all items at this stage, regardless of their statuses.
	Exclude()

	// Arrange arranges element content within given bounding box, e.g. by executing layout algorithm.
	//
	// Containers should arrange visible items at this stage.
	Arrange(bbox basic.Rect)

	// Actuate actuates element, e.g. by handling input.
	//
	// Containers should actuate interactive items and inhibit other ones at this stage.
	//
	// Containers should iterate through items in reverse order at this stage.
	Actuate()

	// Inhibit inhibits element, e.g. by ignoring input.
	//
	// Containers should inhibit all items at this stage, regardless of their statuses.
	//
	// Containers should iterate through items in reverse order at this stage.
	Inhibit()

	// Update updates element.
	//
	// Containers should update visible items at this stage.
	Update()

	// Draw draws element on given screen.
	//
	// Containers should draw visible items at this stage.
	Draw(screen S)

	// Dispose disposes element.
	//
	// Containers should dispose all items at this stage, regardless of their statuses.
	Dispose()
}

type PropsFunc[P any] func(P) P

type TraitFunc[T any] func(T) T