fix(core,web): resolve focus chain and signal propagation in multi-layered iframes

Author: coocoodaegap

packages/core/src/entities/TargetZoneCore.ts

@@ -131,8 +131,19 @@ export class TargetZoneCore
   public handleSignal(signal: InputActionSignal): void {
     const { type, payload } = signal;
 
-    // 每一条信号触发前，先确保焦点回归游戏区域 / Ensure focus is reclaimed before processing any signal
-    this.ensureFocus();
+    // 只有离散的意图性动作才触发回焦检查，确保焦点回归游戏区域：
+    // 键盘按键、鼠标按下、或者是第一次移动时
+    // Only discrete, intentional actions trigger a focus check to ensure the focus returns to the game area: 
+    // keyboard presses, mouse clicks, or the first movement.
+    const isIntentionalAction =
+      type === ACTION_TYPES.KEYDOWN ||
+      type === ACTION_TYPES.MOUSEDOWN ||
+      type === ACTION_TYPES.CLICK ||
+      (type === ACTION_TYPES.MOUSEMOVE && !this.state.isPointerDown && !this.state.isVisible);
+
+    if (isIntentionalAction) {
+      this.ensureFocus();
+    }
 
     // 调度执行不同的输入动作 / Dispatch and execute different input actions
     switch (type) {

packages/web/src/dom/action.ts

@@ -69,6 +69,12 @@ export const reclaimFocusAtPos = (x: number, y: number, callback?: () => void):
   const target = getDeepElement(x, y) as HTMLElement;
   if (!target) return;
 
+  // If an iframe is found, first send a reclaim request to the iframe
+  // 如果找到的是 iframe，先往 iframe 发送回焦请求
+  if (target.tagName.toLowerCase() === 'iframe') {
+    IframeManager.getInstance().forwardFocusReclaim(target as HTMLIFrameElement, x, y);
+  }
+
   // Identify the current truly active element across all Shadow Roots
   // 识别当前页面中真正获得焦点的最深层元素（跨越所有 Shadow Root）
   const currentActive = getDeepActiveElement();
@@ -78,10 +84,6 @@ export const reclaimFocusAtPos = (x: number, y: number, callback?: () => void):
   if (currentActive !== target) {
     focusElement(target);
 
-    if (target.tagName.toLowerCase() === 'iframe') {
-      IframeManager.getInstance().forwardFocusReclaim(target as HTMLIFrameElement, x, y);
-    }
-
     callback?.();
   }
 };