add mq.isUserSelecting() method to check if a mouse selection is active

Author: mikehaverstock

src/controller.ts

@@ -26,6 +26,7 @@ class ControllerBase {
   editable: boolean | undefined;
   _ariaAlertTimeout: number;
   KIND_OF_MQ: KIND_OF_MQ;
+  isMouseSelecting: boolean = false;
 
   textarea: HTMLElement | undefined;
   private textareaEventListeners: Partial<{

src/mathquill.d.ts

@@ -64,6 +64,7 @@ declare namespace MathQuill {
       setAriaPostLabel: (str: string, timeout?: number) => EditableMathQuill;
       ignoreNextMousedown: (func: () => boolean) => EditableMathQuill;
       clickAt: (x: number, y: number, el: HTMLElement) => EditableMathQuill;
+      isUserSelecting: () => boolean;
     }
 
     interface API {

src/publicapi.ts

@@ -490,6 +490,9 @@ function getInterface(v: number): MathQuill.v3.API | MathQuill.v1.API {
       this.__controller.cursor.options.ignoreNextMousedown = fn;
       return this;
     }
+    isUserSelecting() {
+      return this.__controller.isMouseSelecting;
+    }
   }
 
   var APIClasses: APIClasses = {

src/services/mouse.ts

@@ -84,6 +84,7 @@ class Controller_mouse extends Controller_latex {
       ownerDocument?.removeEventListener('mousemove', onDocumentMouseMove);
       ownerDocument?.removeEventListener('mouseup', onDocumentMouseUp);
       cancelSelectionOnEdit = undefined;
+      ctrlr.isMouseSelecting = false;
     }
 
     function updateCursor() {
@@ -125,6 +126,7 @@ class Controller_mouse extends Controller_latex {
     }
 
     cursor.blink = noop;
+    ctrlr.isMouseSelecting = true;
     ctrlr
       .seek(e.target as HTMLElement | null, e.clientX, e.clientY)
       .cursor.startSelection();

test/unit/publicapi.test.js

@@ -253,6 +253,35 @@ suite('Public API', function () {
       assert.equal(mq.getAriaPostLabel(), '');
     });
 
+    test('.isUserSelecting()', function () {
+      mq.latex('x+y');
+
+      // Initially should not be selecting
+      assert.equal(mq.isUserSelecting(), false);
+
+      // Simulate mouse down event to start selection
+      var mouseDownEvent = new MouseEvent('mousedown', {
+        clientX: 10,
+        clientY: 10,
+        bubbles: true
+      });
+      mq.el().dispatchEvent(mouseDownEvent);
+
+      // Should be selecting during mouse down
+      assert.equal(mq.isUserSelecting(), true);
+
+      // Simulate mouse up event to end selection
+      var mouseUpEvent = new MouseEvent('mouseup', {
+        clientX: 20,
+        clientY: 10,
+        bubbles: true
+      });
+      document.dispatchEvent(mouseUpEvent);
+
+      // Should not be selecting after mouse up
+      assert.equal(mq.isUserSelecting(), false);
+    });
+
     test('.mathspeak()', function () {
       function assertMathSpeakEqual(a, b) {
         assert.equal(normalize(a), normalize(b));