tethertest

type ComponentHarness[C tether.Component] struct {
	// contains filtered or unexported fields
}

type Config[S any] struct {
	// State is the initial state for each test interaction.
	State S

	// Render builds a node tree from the current state. Optional  -
	// only required when calling [Harness.HTML], [Harness.Render],
	// or [Harness.RenderNode].
	Render tether.RenderFunc[S]

	// Handle processes a client event and returns the new state.
	Handle func(session tether.Session, state S, event tether.Event) S

	// Middleware wraps the Handle function with cross-cutting
	// behaviour. Applied outermost-first: the first entry in the
	// slice is the outermost layer of the chain. Optional.
	Middleware []tether.Middleware[S]

	// OnNavigate processes URL parameters. Optional.
	OnNavigate func(session tether.Session, state S, params tether.Params) S

	// OnConnect is called when [Harness.Connect] is called. Use this
	// to test session registration logic (e.g. joining a [tether.Group]
	// or starting background tasks). Optional.
	OnConnect func(session tether.Session)

	// OnDisconnect is called when [Harness.Disconnect] is called. Use
	// this to test cleanup logic (e.g. removing from a [tether.Group]
	// or decrementing counters). Optional.
	OnDisconnect func(session tether.Session)

	// Components declares component mounts for automatic event routing.
	// Events matching a mount's prefix are dispatched to the component
	// before Handle runs - mirroring [tether.StatefulConfig].Components.
	// Optional.
	Components []tether.ComponentMount[S]

	// Layout wraps the rendered content for [Harness.Render] and
	// [Harness.HTML], mirroring [tether.StatefulConfig].Layout. Optional  -
	// when absent, only the content node is rendered.
	Layout func(S, node.Node) node.Node

	// Session provides a custom [tether.CaptureSession] for each
	// event dispatch. Use this to inject error conditions that the
	// default harness cannot simulate:
	//
	//   - Set PushErr to test push notification error handling
	//   - Set Ctx to a cancelled context to test context-aware handlers
	//
	// When nil, the harness creates a default CaptureSession with
	// ID "tethertest" and no error conditions.
	Session func() *tether.CaptureSession
}

type Harness[S any] struct {
	// contains filtered or unexported fields
}