* no propagation support out of the box
* no intended support for changing the subject
* occurred at
* subject - the event arguments or data (array|Collection)
| Name | Description |
| --- | --- |
| occurred at | when did the event happen |
| name | the unique identifier for this event (I prefer human readable names instead of numbers as long as possible and I want to encourage you to do the same) |
| source | a unique identifier to track down the source where the event was created |
| subject | the event arguments or data, an array or an object like a collection |
whenever you are dealing with events, it is getting complicated quickly since your event is doing to much or carrying to much responsibility
you can use `$event->name()` or `$event instanceof MyEvent` to listen only to a specific event
instead of adding the option to stop the propagation, I would like to encourage you to follow a different way
* create a generic event which fires your real event only under special circumstances (to move the propagation logic into an event)
* create and fire an event which rejects your previous changes
because of the not implemented support for stopping the propagation, we do not need priorities while dispatching (less complexity :-))
extend from `GenericEvent` to add your type hint for the phpdoc block of the `public method source()`
use or extend the `GenericEventBuilder` to set your well defined event name, sources etc.
Using an event is one of the best indicator that your information has to leave the current domain boundraies.
Keep the event simple, the structure of data should be the contract you as emitter and the event listener have agreed on.
I treat an event like a taken statement.
Once articulated, you can not change it since it is emitited and transported by your preferred transmission medium to the receiver.
All you can do is to add explenations or improvments to your statement.
Worst but possible, if you figure out you where wrong, your only chance is to withdraw your statement.
But everything you emit (or say) is another statement (or event).