fix(macos): restore native fullscreen controls

Equalize titlebar gaps, use Control-Command-F for fullscreen, and keep native traffic lights available when the system fullscreen titlebar reveals.

Author: reycn

electron/main/windows/window-controller.mjs

@@ -58,9 +58,13 @@ export function createWindowController({
   };
   const updateWindowButtons = (target) => {
     if (process.platform !== 'darwin' || !target || target.isDestroyed()) return;
-    const visible = !target.isFullScreen() && !registry.stateFor(target)?.headerHidden;
+    const fullscreen = target.isFullScreen();
+    // Fullscreen's native titlebar reveals with the system menu bar, even
+    // while the reader hides its own toolbar. Do not hide its standard buttons.
+    const visible = fullscreen || !registry.stateFor(target)?.headerHidden;
     target.setWindowButtonVisibility(visible);
-    if (visible) target.setWindowButtonPosition(windowChromeOptions('darwin').trafficLightPosition);
+    if (visible && !fullscreen)
+      target.setWindowButtonPosition(windowChromeOptions('darwin').trafficLightPosition);
   };
   const hideNativeMenuBar = (target) => {
     if (!['win32', 'linux'].includes(process.platform) || !target || target.isDestroyed()) return;

shared/commands/shortcuts.mjs

@@ -29,7 +29,10 @@ export function shortcutAction(platform, input) {
     if (key === 'pagedown' || (input.shift && ['arrowdown', 'arrowright'].includes(key)))
       return 'page-next';
   }
-  if (key === 'f11' && !input.meta && !input.control && !input.alt) return 'toggle-fullscreen';
+  if (platform !== 'darwin' && key === 'f11' && !input.meta && !input.control && !input.alt)
+    return 'toggle-fullscreen';
+  if (platform === 'darwin' && key === 'f' && input.meta && input.control && !input.alt && !input.shift)
+    return 'toggle-fullscreen';
   if (platform === 'darwin') {
     if (key === 'w' && input.control && !input.meta && !input.alt && !input.shift)
       return 'close-window';

src/ui/styles/features/reader/layered/toolbar.css

@@ -177,6 +177,14 @@
   grid-template-columns: minmax(0, 1fr) max-content;
 }
 
+/* Native lights start at x=18 and span 52px (three 12px lights, 20px apart).
+   Match the window inset, lights-to-button gap, and button-to-title gap. */
+.desktop[data-platform='darwin'] .toolbar {
+  --macos-titlebar-gap: 18px;
+  padding-left: calc(52px + 2 * var(--macos-titlebar-gap));
+  column-gap: var(--macos-titlebar-gap);
+}
+
 .desktop .toolbar > .icon-button:first-of-type {
   margin: 0;
 }