Adds pointer capture and disabling support to eventcatcher widget

[saqimtiaz]

This PR introduces three major enhancements to the EventCatcher widget:

1. Optional Pointer Capture Support
   Adds native pointer capture handling to improve pointer event reliability and tracking outside the widget DOM nodes boundaries. When enabled, pointer events such as pointermove, pointerup, and pointercancel are correctly captured and routed to the widget, even if the pointer moves off-screen or outside the element.
   The pointer capture logic supports two modes of event listener attachment for better performance and control.

2. Widget Enable/Disable Control
   Adds a new attribute to enable or disable the EventCatcher widget at runtime. This allows users to temporarily deactivate event handling without removing the widget or disrupting the DOM structure, enhancing flexibility for dynamic UIs.

3. Access to a JSON blob containing event properties via the variable eventJSON. The event.detail related variables have been deprecated as they were always brittle and the seem needs can now be met via eventJSON.

---

User-Facing Attributes

Attribute	Default	Description
enabled	yes	Enables or disables the EventCatcher widget. When set to no, all event listeners are removed.
pointerCapture	no	Enables native pointer capture support (yes, no, dynamic).

---

Detailed Behavior of pointerCapture

When pointerCapture is dynamic

• Attaches pointerdown, pointerup and pointercancel event listeners at the appropriate time even if they are not specified in the widget attributes.
• The pointerdown event listener is attached when the widget is initialized and when a pointerdown occurs, pointer capture is set with setPointerCapture.
• The widget dynamically attaches the following pointer event listeners for the duration of the pointer capture:
  • pointerup
  • pointercancel
  • pointermove (only if the user has specified it in the widget attributes)
• When the interaction ends (pointerup or pointercancel), these active listeners are removed, and pointer capture is released.
• This mode minimizes the number of active event listeners and improves performance by only listening when necessary.

When dynamicPointerListeners is yes

• The widget attaches all event listeners specified in the widget attributes when it is rendered.
• No pointer event listeners are added that are not explicitly specified in the widget attributes.
• If pointerdown has been specified, it initiates pointer capture.
• If pointerup or pointercancel have been specified, they release pointer capture.

---

To Do:

• ensure that we support the use case where no selector attribute has been specified.
• further testing in FF to verify recent changes are compatible
• update documentation
• add examples
• refactor to avoid deprecated utils functions where possible
  • $tw.utils.domMatchesSelector

[netlify]

✅ Deploy Preview for tiddlywiki-previews ready!

Name	Link
🔨 Latest commit	92c41f8
🔍 Latest deploy log	https://app.netlify.com/projects/tiddlywiki-previews/deploys/69767e42d1b4670008469dbb
😎 Deploy Preview	https://deploy-preview-9609--tiddlywiki-previews.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[github-actions]

Confirmed: saqimtiaz has already signed the Contributor License Agreement (see contributing.md)

[github-actions]

📊 Build Size Comparison: empty.html

Branch	Size
Base (master)	2448.0 KB
PR	2453.6 KB

Diff: ⬆️ Increase: +5.6 KB

---

✅ Change Note Status

All change notes are properly formatted and validated!

📝 $:/changenotes/5.4.0/#9609

Type: enhancement | Category: widget
Release: 5.4.0

adds support for pointer capture and enabling/disabling the widget

🔗 #9609

👥 Contributors: saqimtiaz

---

📖 Change Note Guidelines

Change notes help track and communicate changes effectively. See the full documentation for details.

[saqimtiaz]

@Jermolene seeing as how this is a complete rewrite, should we take this opportunity to switch to using JavaScript classes?

class EventWidget extends Widget { ....