feat(super-editor): add pointer event observability (#2801)

Author: mattConnHarbour

packages/super-editor/src/editors/v1/core/Editor.ts

@@ -426,6 +426,9 @@ export class Editor extends EventEmitter<EditorEventMap> {
     onCommentsLoaded: () => null,
     onCommentClicked: () => null,
     onCommentLocationsUpdate: () => null,
+    onPointerDown: () => null,
+    onPointerUp: () => null,
+    onRightClick: () => null,
     onDocumentLocked: () => null,
     onFirstRender: () => null,
     onCollaborationReady: () => null,
@@ -763,6 +766,9 @@ export class Editor extends EventEmitter<EditorEventMap> {
     this.on('list-definitions-change', this.options.onListDefinitionsChange!);
     this.on('fonts-resolved', this.options.onFontsResolved!);
     this.on('exception', this.options.onException!);
+    this.on('pointerDown', this.options.onPointerDown!);
+    this.on('pointerUp', this.options.onPointerUp!);
+    this.on('rightClick', this.options.onRightClick!);
   }
 
   /**
@@ -1161,6 +1167,9 @@ export class Editor extends EventEmitter<EditorEventMap> {
     this.on('list-definitions-change', this.options.onListDefinitionsChange!);
     this.on('fonts-resolved', this.options.onFontsResolved!);
     this.on('exception', this.options.onException!);
+    this.on('pointerDown', this.options.onPointerDown!);
+    this.on('pointerUp', this.options.onPointerUp!);
+    this.on('rightClick', this.options.onRightClick!);
 
     if (!shouldMountRenderer) {
       this.#emitCreateAsync();
@@ -1237,6 +1246,9 @@ export class Editor extends EventEmitter<EditorEventMap> {
     this.on('commentClick', this.options.onCommentClicked!);
     this.on('locked', this.options.onDocumentLocked!);
     this.on('list-definitions-change', this.options.onListDefinitionsChange!);
+    this.on('pointerDown', this.options.onPointerDown!);
+    this.on('pointerUp', this.options.onPointerUp!);
+    this.on('rightClick', this.options.onRightClick!);
 
     if (!shouldMountRenderer) {
       this.#emitCreateAsync();

packages/super-editor/src/editors/v1/core/presentation-editor/pointer-events/EditorInputManager.ts

@@ -1273,6 +1273,16 @@ export class EditorInputManager {
   #handlePointerDown(event: PointerEvent): void {
     if (!this.#deps) return;
 
+    // Emit local-only pointer events for external consumers (e.g. debugging trackpad issues)
+    // Emit directly on the Editor instance so consumers can use editor.on('pointerDown', ...)
+    const bodyEditor = this.#deps.getEditor();
+    bodyEditor.emit?.('pointerDown', { editor: bodyEditor, event });
+
+    // Emit rightClick for secondary button (button 2) or Ctrl+Click on Mac
+    if (event.button === 2 || (event.ctrlKey && navigator.platform.includes('Mac'))) {
+      bodyEditor.emit?.('rightClick', { editor: bodyEditor, event });
+    }
+
     // Return early for non-left clicks
     if (event.button !== 0) return;
 
@@ -1304,7 +1314,6 @@ export class EditorInputManager {
       return;
     }
 
-    const bodyEditor = this.#deps.getEditor();
     const layoutState = this.#deps.getLayoutState();
     const clickedNoteTarget = this.#resolveRenderedNoteTargetAtPointer(target, event.clientX, event.clientY);
 
@@ -1676,6 +1685,11 @@ export class EditorInputManager {
   #handlePointerUp(event: PointerEvent): void {
     if (!this.#deps) return;
 
+    // Emit local-only pointer event for external consumers (e.g. debugging trackpad issues)
+    // Emit directly on the Editor instance so consumers can use editor.on('pointerUp', ...)
+    const editor = this.#deps.getEditor();
+    editor.emit?.('pointerUp', { editor, event });
+
     this.#suppressFocusInFromDraggable = false;
 
     if (!this.#isDragging) {

packages/super-editor/src/editors/v1/core/types/EditorConfig.ts

@@ -564,6 +564,15 @@ export interface EditorOptions {
   /** Host-provided permission hook */
   permissionResolver?: ((params: PermissionParams) => boolean | undefined) | null;
 
+  /** Called on pointer down events (local only, not broadcast via collaboration) */
+  onPointerDown?: (params: { editor: Editor; event: PointerEvent }) => void;
+
+  /** Called on pointer up events (local only, not broadcast via collaboration) */
+  onPointerUp?: (params: { editor: Editor; event: PointerEvent }) => void;
+
+  /** Called on right-click (local only, not broadcast via collaboration) */
+  onRightClick?: (params: { editor: Editor; event: PointerEvent }) => void;
+
   /**
    * Custom resolver for the link click popover.
    * Called when a user clicks a link to determine which popover to show.

packages/super-editor/src/editors/v1/core/types/EditorEvents.ts

@@ -221,4 +221,13 @@ export interface EditorEventMap extends DefaultEventMap {
    * more story caches are invalidated.
    */
   'tracked-changes-changed': [TrackedChangesChangedPayload];
+
+  /** Called on pointer down (local only, not broadcast via collaboration) */
+  pointerDown: [{ editor: Editor; event: PointerEvent }];
+
+  /** Called on pointer up (local only, not broadcast via collaboration) */
+  pointerUp: [{ editor: Editor; event: PointerEvent }];
+
+  /** Called on right-click (local only, not broadcast via collaboration) */
+  rightClick: [{ editor: Editor; event: PointerEvent }];
 }

packages/superdoc/src/dev/components/SuperdocDev.vue

@@ -1102,6 +1102,19 @@ const onEditorCreate = ({ editor }) => {
   editor.on('fieldAnnotationDoubleClicked', (params) => {
     console.log('fieldAnnotationDoubleClicked', { params });
   });
+
+  // SD-2494: Pointer event observability for debugging trackpad/right-click selection issues
+  editor.on('pointerDown', (params) => {
+    console.log('pointerDown', { params });
+  });
+
+  editor.on('pointerUp', (params) => {
+    console.log('pointerUp', { params });
+  });
+
+  editor.on('rightClick', (params) => {
+    console.log('rightClick', { params });
+  });
 };
 
 watch(