(Btw, I love this game engine. Thanks for all the work.)

Reference: src/engine/Util/StateMachine.ts

consider this state machine:

import { StateMachine, StateMachineDescription } from "excalibur";

type Data = { counter: number }

const data: Data = { counter: 0 };

const description: StateMachineDescription = {
  start: "Idle",
  states: {
    Idle: {
      transitions: [],
      onEnter: ({ data }) => { // data is `any`
        console.log("data is", data);
      },
    },
  },
};

const stateMachine: StateMachine<'Idle', Data> = StateMachine.create(description, { counter: 0 });

Since neither StateMachineDescription nor State have any type parameters, they can't know the Data parameter of the StateMachine that they're used in.

Instead I expected the types to be defined StateMachineDescription<States, Data> and State<Data> which would have to match StateMachine<States, Data> so that you can write type-safe states.

Aside, shouldn't there be a stateMachine.start(data) method to kick off the machine starting at startingState?