[🚀esl-event-listener]: ability to receive additional event information related to listener (element target, selected target)

[ala-n]

As an ESL consumer, I want to be able to access current event delegated target.

Use Case: event delegation
Shortcut for

@listen({ event: 'some', selector: '.delegate.selector' })
onSomeEvent(e: Event) {
  const {target} = e;
  const $delegate = target && target.closest('.delegate.selector'); // <- that one
  ...
}

Additional context: the ability to receive event listener as handler parameter was lost in bounds of #983 request implementation
It is rejected originally to have common information in simple cases for debugging reasons and receive listeners in general by API reasons.
Nevertheless, the delegation case is more specific and can be extended (by second param or original event mixing)

---

Architecture proposal (by @ala-n)

• Mix additional information just for delegation cases.
• Make sure the original handler is used if the selector option is not provided (by debug reason mentioned in [🚀 esl-event-listener]: add possibility to see event handler code in the browser #983 )
• Information should be safely mixed into the original event

User API:

  @listen({ event: 'some', selector: '.delegate.selector' })
  onSomeEvent(e: DelegatedEvent<EventType>) {
    const {$delegate} = e; // available out of the box
    ...
  }

[ala-n]

🎉 This issue has been resolved in version 4.7.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀