fix: prioritize fullscreen escape over focus mode

Author: pallyoung

docs/help/desktop-guide.md

@@ -27,6 +27,7 @@
 - 终端面板切换按钮
 - 文件面板切换按钮
 - 设置按钮
+- 全屏按钮
 
 ### 左侧面板
 
@@ -138,6 +139,12 @@
 
 按 `F` 键进入专注模式，会隐藏左侧面板和底部终端面板，只保留中央工作区。按 `Escape` 退出专注模式。
 
+### 原生全屏
+
+点击设置按钮右侧的全屏按钮可进入浏览器原生全屏。处于全屏时，同一位置的按钮会切换为退出全屏，按 `Escape` 也可以退出。
+
+如果同时开启了专注模式和原生全屏，`Escape` 会先退出原生全屏，再退出专注模式。
+
 ## 常见问题
 
 **Q：如何找回被关闭的面板？**

docs/help/mobile-guide.md

@@ -22,6 +22,7 @@
 
 - 工作区名称（点击打开工作区抽屉，可切换工作区）
 - 设置入口
+- 全屏入口（仅在浏览器支持原生全屏时显示）
 
 ### 当前 Agent 区域
 
@@ -76,6 +77,8 @@
 - 移动端适合"查看"为主，复杂的文件编辑和 Agent 管理建议在桌面端完成
 - 手机键盘弹出时会压缩底部 Dock 区域，操作时注意布局变化
 - 终端操作在小屏幕上可能不便，建议仅在需要时查看
+- 如果浏览器支持原生全屏，可点击顶部栏右侧的全屏按钮进入；再次点击同一位置的按钮可退出
+- 某些移动端浏览器不支持原生全屏，此时不会显示该按钮
 
 ## 常见问题
 

packages/web/src/features/focus-mode/components/focus-mode.test.tsx

@@ -0,0 +1,46 @@
+import { fireEvent, render } from "@testing-library/react";
+import { createStore, Provider } from "jotai";
+import { describe, expect, it } from "vitest";
+import { focusModeAtom } from "../../workspace/atoms";
+import { FocusMode } from "./focus-mode";
+
+function renderFocusModeWithStore(initialFocusMode: boolean) {
+  const store = createStore();
+  store.set(focusModeAtom, initialFocusMode);
+
+  render(
+    <Provider store={store}>
+      <FocusMode />
+    </Provider>
+  );
+
+  return store;
+}
+
+describe("FocusMode escape priority", () => {
+  it("does not close focus mode while native fullscreen is active", () => {
+    Object.defineProperty(document, "fullscreenElement", {
+      configurable: true,
+      get: () => document.body,
+    });
+
+    const store = renderFocusModeWithStore(true);
+
+    fireEvent.keyDown(window, { key: "Escape" });
+
+    expect(store.get(focusModeAtom)).toBe(true);
+  });
+
+  it("still exits focus mode when fullscreen is not active", () => {
+    Object.defineProperty(document, "fullscreenElement", {
+      configurable: true,
+      get: () => null,
+    });
+
+    const store = renderFocusModeWithStore(true);
+
+    fireEvent.keyDown(window, { key: "Escape" });
+
+    expect(store.get(focusModeAtom)).toBe(false);
+  });
+});

packages/web/src/features/focus-mode/components/focus-mode.tsx

@@ -84,6 +84,10 @@ export function FocusMode() {
 
       // Escape key exits focus mode
       if (e.key === "Escape" && focusMode) {
+        if (document.fullscreenElement) {
+          return;
+        }
+
         e.preventDefault();
         setFocusMode(false);
       }