Skip to content

Interface: PlayerOptions<TMachine>

Documentation / @xmachines/play-xstate / PlayerOptions

Defined in: packages/play-xstate/src/types.ts:28

Player lifecycle hooks

Per CONTEXT.md: Rich set of hooks for observability

Type Parameters

Type Parameter
TMachine extends AnyStateMachine

Properties

PropertyTypeDescriptionDefined in
onError?(actor, error) => voidCalled on actor errorspackages/play-xstate/src/types.ts:46
onStart?(actor) => voidCalled when actor startspackages/play-xstate/src/types.ts:30
onStateChange?(actor, state) => voidCalled when state signal changespackages/play-xstate/src/types.ts:43
onStop?(actor) => voidCalled when actor stopspackages/play-xstate/src/types.ts:33
onTransition?(actor, prevState, nextState) => voidCalled on every state transitionpackages/play-xstate/src/types.ts:36
propValidation?"strict" | "lenient"Prop validation failure mode (default: ‘lenient’) - ‘lenient’: On validation failure, call onError hook and render with unvalidated props (current behavior). Documents as explicit trade-off. - ‘strict’: On validation failure, call onError hook and set viewSignal to null (no render). Blocks rendering until machine transitions to a state with valid props.packages/play-xstate/src/types.ts:57