fix: fixed #2685

Author: arnog

CHANGELOG.md

@@ -186,6 +186,13 @@
   options like color changes. The context menu event is now prevented before
   showing the menu, ensuring focus is maintained regardless of where the
   right-click occurs.
+- **#2685** Fixed physical keyboard not working after programmatic focus with
+  manual virtual keyboard policy. When calling `mf.focus()` programmatically at
+  page load with `mathVirtualKeyboardPolicy: "manual"`, the physical keyboard
+  would stop working. This was caused by a double `onFocus()` invocation that
+  set up event capture listeners at the wrong time. The fix prevents the second
+  `onFocus()` call when focus is initiated programmatically, ensuring keyboard
+  events are properly routed.
 - **#2686** When deleting a range that includes special mathematical atoms like
   `\sqrt`, `\frac`, or `\enclose`, the special atom structure is now properly
   removed or cleaned up. Previously, deleting content would leave behind empty

src/editor-mathfield/mathfield-private.ts

@@ -202,6 +202,7 @@ export class _Mathfield implements Mathfield, KeyboardDelegateInterface {
   // the `change` event is dispatched
   private valueOnFocus: string;
   private focusBlurInProgress = false;
+  private programmaticFocusInProgress = false;
 
   private geometryChangeTimer: ReturnType<typeof requestAnimationFrame>;
 
@@ -818,7 +819,10 @@ If you are using Vue, this may be because you are using the runtime-only build o
 
     switch (evt.type) {
       case 'focus':
-        this.onFocus({ suppressEvents: true });
+        // Skip handling DOM focus events that result from programmatic focus()
+        // calls to prevent double onFocus() invocation (fixes #2685)
+        if (!this.programmaticFocusInProgress)
+          this.onFocus({ suppressEvents: true });
         break;
 
       case 'blur':
@@ -1349,6 +1353,7 @@ If you are using Vue, this may be because you are using the runtime-only build o
   focus(options?: FocusOptions): void {
     if (this.disabled || this.focusBlurInProgress) return;
     if (!this.hasFocus()) {
+      this.programmaticFocusInProgress = true;
       this.onFocus();
       this.model.announce('line');
     }
@@ -1754,6 +1759,11 @@ If you are using Vue, this may be because you are using the runtime-only build o
         this.focusBlurInProgress = false;
         this.keyboardDelegate.focus();
         this.connectToVirtualKeyboard();
+
+        // Clear the flag after the DOM focus event has been processed
+        setTimeout(() => {
+          this.programmaticFocusInProgress = false;
+        }, 0);
       }
     }, 60);
   }