Allow split state definitions

[SpaceBison]

Consider the following state machine:

StateMachine.create<String, Int, Nothing> {
	initialState(STATE_A)

	state(STATE_A) {
		on(EVENT_1) {
			transitionTo(STATE_B)
		}

		onExit(firstDefinitionOnExitListener)
	}

	state(STATE_A) {
		on(EVENT_2) {
			transitionTo(STATE_B)
		}

		onExit(secondDefinitionOnExitListener)
	}

	state(STATE_B) {
		onEnter(firstDefinitionOnEnterListener)
	}

	state(STATE_B) {
		onEnter(secondDefinitionOnEnterListener)
	}
}

Currently, trying to transition from STATE_A on EVENT_1 will result in a valid transition, but attempting a transition on EVENT_2 will result in an invalid transition. There's no warning or error given neither for the second STATE_A nor the second STATE_B definitions. A similar behavior can be observed for on exit and on enter listeners - only firstDefinitionOnExitListener and firstDefinitionOnEnterListener will be called when transitioning from STATE_A to STATE_B.

This PR aims to make state machines take into account all the state definitions passed to the graph builder. This is achieved by merging all applicable state definitions when resolving a transition for a given state and event instead of just taking the first one that matches.

[CLAassistant]

All committers have signed the CLA.

[timzaak]

This would be great.

// I can handle an event in one place  for more than one state.
  state(StateMachine.Matcher.any<State, State>().where {
            !(this is State.MachineError)
        })

[JaviRpo]

This change is perfec to me.

[JaviRpo]

I like this change, this also works when we want to have a generic transition

private val stateMachine = StateMachine.create<String, Int, Nothing> {
                initialState(STATE_A)
                state(STATE_A) {
                    on(EVENT_1) {
                        transitionTo(STATE_B)
                    }
                }
                state(STATE_B) {
                    on(EVENT_2) {
                        transitionTo(STATE_A)
                    }
                }
                state<String> {
                    on(EVENT_3) {
                        transitionTo(STATE_C)
                    }
                }
            }

for example, this one, having state<String> or state(any()) we can move from any state to another state with the same event.

[JaviRpo]

What do we need for this PR to be merged and have a version with this change?