feat: added events option with onClick

[JoshuaKGoldberg]

PR Checklist

• Addresses an existing open issue: fixes 🚀 Feature: Allow an onClick option for clicking emojis #136
• That issue was marked as accepting prs
• Steps in CONTRIBUTING.md were taken

Overview

Replaces the tagName option with an events object. So far, per #136, it just has an onClick optional property.

This notably means that users are now provided the actor: EmojiActor for the first (intentional) time ever. Actors now have an update() function that can take in a new opacity and/or velocity. Applies a couple of refactors in support of that:

• Switches the Animator class to just an animate function, since there was no reason to expose the start or tick methods to consumers before
• Switches actor state to # privates with getters on top of them, so that the types can mark them as Readonly<...>

One nifty thing is the domNodesToActors: WeakMap<EventTarget, EmojiActor>. It maps from click event targets back to the emoji actor in the library.

[codecov]

Codecov Report

Merging #137 (11afce7) into main (8e64673) will decrease coverage by 0.33%.
The diff coverage is 0.00%.

@@           Coverage Diff            @@
##            main    #137      +/-   ##
========================================
- Coverage   2.94%   2.61%   -0.33%     
========================================
  Files         13      14       +1     
  Lines        849     955     +106     
========================================
  Hits          25      25              
- Misses       824     930     +106     

Impacted Files	Coverage Δ
src/actor.ts	0.00% <0.00%> (ø)
src/animate.ts	0.00% <0.00%> (ø)
src/emojisplosion.ts	0.00% <0.00%> (ø)
src/events.ts	0.00% <0.00%> (ø)
src/styles.ts	0.00% <0.00%> (ø)

... and 1 file with indirect coverage changes

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more