Add event delegation for link click tracking (#1325)

* link-click-tracking: event delegation

- Global event listeners are now used instead of per-element listeners
- `refreshLinkClickTracking` is now deprecated and does nothing as it
  should no longer be required (but still exists for API compatibility)
- There is now a `disableLinkClickTracking` method to balance
  `enableLinkClickTracking`
- `trackLinkClick` can now optionally be passed a link element directly,
  rather than requiring manual construction of the event payload
- Event listeners now use the capture phase instead of bubble
- Link URIs are no longer unescaped
- Additional unit tests for link click tracking

Author: jethron

common/changes/@snowplow/browser-plugin-link-click-tracking/PE-4138-link-delegation_2024-07-05-06-32.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@snowplow/browser-plugin-link-click-tracking",
+      "comment": "Update plugin to use global rather than per-element event listeners",
+      "type": "none"
+    }
+  ],
+  "packageName": "@snowplow/browser-plugin-link-click-tracking"
+}

plugins/browser-plugin-link-click-tracking/README.md

@@ -42,11 +42,18 @@ newTracker('sp1', '{{collector}}', { plugins: [ LinkClickTrackingPlugin() ] });
 Then use the available functions from this package to track to all trackers which have been initialized with this plugin:
 
 ```js
-import { enableLinkClickTracking, refreshLinkClickTracking } from '@snowplow/browser-plugin-link-click-tracking';
+import { enableLinkClickTracking } from '@snowplow/browser-plugin-link-click-tracking';
 
 enableLinkClickTracking({ options: { ... }, psuedoClicks: true });
+```
+
+You can also explicitly track a click without installing listeners:
+
+```js
+import { trackLinkClick } from '@snowplow/browser-plugin-link-click-tracking';
 
-refreshLinkClickTracking();
+trackLinkClick({ element: document.querySelector("a, area") });
+trackLinkClick({ targetUrl: "http://example.com/" });
 ```
 
 ## Copyright and license