gloomberb 0.9.0 → 0.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gloomberb",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Market research and portfolio tracker for the terminal",
   "module": "src/index.tsx",
   "type": "module",
@@ -21,6 +21,7 @@
     "desktop:dev": "electrobun dev --watch",
     "desktop:build": "electrobun build",
     "desktop:release": "electrobun build --env=stable",
+    "desktop:release:windows": "electrobun build --env=stable --targets=win-x64",
     "test": "bun test",
     "release": "./scripts/release.sh"
   },
@@ -40,6 +41,8 @@
     "@types/bun": "^1.3.14",
     "@types/react-dom": "^19.2.3",
     "electrobun": "^1.18.1",
+    "png-to-ico": "^2.1.8",
+    "rcedit": "^4.0.1",
     "react-dom": "19.2.7"
   },
   "peerDependencies": {
@@ -59,6 +62,7 @@
     "web-tree-sitter": "0.25.10"
   },
   "patchedDependencies": {
-    "@opentui/core@0.3.2": "patches/@opentui%2Fcore@0.3.2.patch"
+    "@opentui/core@0.3.2": "patches/@opentui%2Fcore@0.3.2.patch",
+    "electrobun@1.18.1": "patches/electrobun@1.18.1.patch"
   }
 }

package/patches/electrobun@1.18.1.patch

@@ -0,0 +1,85 @@
+diff --git a/dist/api/bun/core/BrowserWindow.ts b/dist/api/bun/core/BrowserWindow.ts
+index c26c2c977ee1fc25a8dc144b85bac8626a45f572..8920a2905380228c23cba66c20d9bfd19ee13e02 100644
+--- a/dist/api/bun/core/BrowserWindow.ts
++++ b/dist/api/bun/core/BrowserWindow.ts
+@@ -8,9 +8,18 @@ import { type RPCWithTransport } from "../../shared/rpc.js";
+ import { getNextWindowId } from "./windowIds";
+ import { GpuWindowMap } from "./GpuWindow";
+ import { WGPUView } from "./WGPUView";
++import { existsSync } from "fs";
++import { resolve } from "path";
+ 
+ const buildConfig = await BuildConfig.get();
+ 
++function defaultWindowIconPath(): string | null {
++	if (process.platform !== "win32") return null;
++
++	const iconPath = resolve("../Resources/app.ico");
++	return existsSync(iconPath) ? iconPath : null;
++}
++
+ export type WindowOptionsType<T = undefined> = {
+ 	trafficLightOffset?: {
+ 		x: number;
+@@ -28,6 +37,7 @@ export type WindowOptionsType<T = undefined> = {
+ 	html: string | null;
+ 	preload: string | null;
+ 	viewsRoot: string | null;
++	iconPath?: string | null;
+ 	renderer: "native" | "cef";
+ 	rpc?: T;
+ 	styleMask?: {};
+@@ -124,6 +134,7 @@ export class BrowserWindow<T extends RPCWithTransport = RPCWithTransport> {
+ 	html: string | null = null;
+ 	preload: string | null = null;
+ 	viewsRoot: string | null = null;
++	iconPath: string | null = null;
+ 	renderer: "native" | "cef" = "native";
+ 	transparent: boolean = false;
+ 	passthrough: boolean = false;
+@@ -155,6 +166,7 @@ export class BrowserWindow<T extends RPCWithTransport = RPCWithTransport> {
+ 		this.html = options.html || null;
+ 		this.preload = options.preload || null;
+ 		this.viewsRoot = options.viewsRoot || null;
++		this.iconPath = options.iconPath ?? defaultWindowIconPath();
+ 		this.renderer = options.renderer || defaultOptions.renderer;
+ 		this.transparent = options.transparent ?? false;
+ 		this.passthrough = options.passthrough ?? false;
+@@ -181,6 +193,7 @@ export class BrowserWindow<T extends RPCWithTransport = RPCWithTransport> {
+ 			id: this.id,
+ 			title: this.title,
+ 			url: this.url || "",
++			iconPath: this.iconPath,
+ 			frame: {
+ 				width: this.frame.width,
+ 				height: this.frame.height,
+diff --git a/dist/api/bun/proc/native.ts b/dist/api/bun/proc/native.ts
+index f0f6c2532ba2eb467ec1d452a25c835b6db72661..ae77cf58d32392ad4cc8e2103ac7ed27baae8bea 100644
+--- a/dist/api/bun/proc/native.ts
++++ b/dist/api/bun/proc/native.ts
+@@ -829,6 +829,7 @@ const _ffiImpl = {
+ 			id: number;
+ 			url: string | null;
+ 			title: string;
++			iconPath?: string | null;
+ 			frame: {
+ 				width: number;
+ 				height: number;
+@@ -862,6 +863,7 @@ const _ffiImpl = {
+ 				id,
+ 				url: _url,
+ 				title,
++				iconPath,
+ 				frame: { x, y, width, height },
+ 				styleMask: {
+ 					Borderless,
+@@ -926,6 +928,9 @@ const _ffiImpl = {
+ 			}
+ 
+ 			native_.symbols.setWindowTitle(windowPtr, toCString(title));
++			if (iconPath) {
++				native_.symbols.setWindowIcon(windowPtr, toCString(iconPath));
++			}
+ 			if (!hidden) {
+ 				native_.symbols.showWindow(windowPtr, activate);
+ 			}

package/src/app/global-shortcuts.test.tsx

@@ -135,6 +135,18 @@ describe("useAppGlobalShortcuts", () => {
     expect(event.propagationStopped).toBe(true);
   });
 
+  test("toggles the command bar with Ctrl-K", async () => {
+    const actions: AppAction[] = [];
+    const state = createInitialState(createDefaultConfig("/tmp/gloomberb-global-shortcuts"));
+    await renderHarness(state, createRegistry(), (action) => actions.push(action));
+
+    const event = await emitKeypress({ name: "k", ctrl: true });
+
+    expect(actions).toEqual([{ type: "TOGGLE_COMMAND_BAR" }]);
+    expect(event.defaultPrevented).toBe(true);
+    expect(event.propagationStopped).toBe(true);
+  });
+
   test("opens ticker search with backtick", async () => {
     const actions: AppAction[] = [];
     const state = createInitialState(createDefaultConfig("/tmp/gloomberb-global-shortcuts"));

package/src/app/global-shortcuts.ts

@@ -52,7 +52,7 @@ export function useAppGlobalShortcuts({
 
     if (!isDetachedWindow && (
       (event.name === "p" && event.ctrl)
-      || (event.name === "k" && (event.meta || event.super))
+      || (event.name === "k" && (event.ctrl || event.meta || event.super))
     )) {
       event.preventDefault();
       event.stopPropagation();

package/src/components/layout/detached-pane-shell.tsx

@@ -12,7 +12,8 @@ import { PaneBodyFrame, getPaneWindowAttributes } from "./pane/frame";
 import { PaneContent } from "./pane/content";
 import { resolvePaneBodyFrame } from "./pane/sizing";
 import { getPaneDisplayTitle } from "./pane/title";
-import { TITLEBAR_OVERLAY_HEIGHT_PX, TITLEBAR_TRAFFIC_LIGHT_WIDTH } from "./titlebar-overlay";
+import { TITLEBAR_OVERLAY_HEIGHT_PX, getTitlebarLeadingInset } from "./titlebar-overlay";
+import { WindowControls } from "./window-controls";
 import {
   createDoubleEscapeCloseState,
   recordDoubleEscapeClose,
@@ -41,7 +42,9 @@ export function DetachedPaneShell({ pluginRegistry, desktopWindowBridge }: Detac
     typeof document === "undefined" ? true : document.hasFocus()
   ));
   const { width, height } = useViewport();
-  const { cellHeightPx = 18, nativePaneChrome, titleBarOverlay } = useUiCapabilities();
+  const { cellHeightPx = 18, nativePaneChrome, titleBarOverlay, windowControls } = useUiCapabilities();
+  const showWindowControls = windowControls === "windows";
+  const titlebarLeadingInset = titleBarOverlay ? getTitlebarLeadingInset() : 0;
   const instance = useAppSelector((state) => findPaneInstance(state.config.layout, desktopWindowBridge.paneId) ?? null);
   const paneDef = instance ? pluginRegistry.panes.get(instance.paneId) ?? null : null;
   const hasPaneSettings = !!instance && pluginRegistry.hasPaneSettings(instance.instanceId);
@@ -171,8 +174,8 @@ export function DetachedPaneShell({ pluginRegistry, desktopWindowBridge }: Detac
                 alignItems="center"
                 flexGrow={1}
                 minWidth={0}
-                paddingLeft={titleBarOverlay ? TITLEBAR_TRAFFIC_LIGHT_WIDTH : 1}
-                paddingRight={1}
+                paddingLeft={titleBarOverlay ? titlebarLeadingInset : 1}
+                paddingRight={showWindowControls ? 0 : 1}
               >
                 <Box flexGrow={1} minWidth={0} overflow="hidden">
                   <Text fg={paneTitleText(focused, true)} selectable={false} data-gloom-role="pane-title">{title}</Text>
@@ -189,6 +192,7 @@ export function DetachedPaneShell({ pluginRegistry, desktopWindowBridge }: Detac
                     {" ... "}
                   </Text>
                 )}
+                {showWindowControls ? <WindowControls /> : null}
               </Box>
             </Box>
             <PaneBodyFrame layoutProps={bodyFrame.layoutProps} backgroundColor={background}>

package/src/components/layout/header.tsx

@@ -17,7 +17,8 @@ import { formatPercentRaw } from "../../utils/format";
 import { formatMarketPrice } from "../../market-data/market/format";
 import { marketStateLabel, marketStateColor, getActiveQuoteDisplay } from "../../market-data/market/status";
 import { VERSION } from "../../version";
-import { TITLEBAR_TRAFFIC_LIGHT_WIDTH } from "./titlebar-overlay";
+import { getTitlebarLeadingInset } from "./titlebar-overlay";
+import { WindowControls } from "./window-controls";
 
 const SPY_REFRESH_MS = 5 * 60_000; // 5 min
 const UPDATE_NOTICE_DURATION_MS = 5_000;
@@ -125,7 +126,9 @@ export function Header() {
   useThemeColors();
   const baseCurrency = useAppSelector(selectBaseCurrency);
   const appActive = useAppActive();
-  const { titleBarOverlay } = useUiCapabilities();
+  const { titleBarOverlay, windowControls } = useUiCapabilities();
+  const showWindowControls = windowControls === "windows";
+  const titlebarLeadingInset = titleBarOverlay ? getTitlebarLeadingInset() : 0;
   const spyQuoteEntry = useQuoteEntry("SPY", null);
   const spyQuote = useResolvedEntryValue(spyQuoteEntry);
 
@@ -165,10 +168,10 @@ export function Header() {
         style={{
           boxShadow: `0 -1px 0 ${colors.header}, inset 0 1px 0 ${colors.header}`,
           paddingLeft: 8,
-          paddingRight: 12,
+          paddingRight: showWindowControls ? 0 : 12,
         }}
       >
-        <Box paddingLeft={TITLEBAR_TRAFFIC_LIGHT_WIDTH} flexDirection="row" alignItems="center" gap={1}>
+        <Box paddingLeft={titlebarLeadingInset} flexDirection="row" alignItems="center" gap={1}>
           <Text attributes={TextAttributes.BOLD} fg={colors.headerText}>
             Gloomberb
           </Text>
@@ -195,7 +198,10 @@ export function Header() {
         <Box paddingRight={1}>
           <Text fg={spyColor}>{spyText}</Text>
         </Box>
-        <Text fg={colors.headerText}>{baseCurrency}</Text>
+        <Box paddingRight={showWindowControls ? 1 : 0}>
+          <Text fg={colors.headerText}>{baseCurrency}</Text>
+        </Box>
+        {showWindowControls ? <WindowControls /> : null}
       </Box>
     );
   }
@@ -209,7 +215,7 @@ export function Header() {
       data-titlebar-overlay={titleBarOverlay ? "true" : undefined}
       className={titleBarOverlay ? "electrobun-webkit-app-region-drag" : undefined}
     >
-      <Box paddingLeft={titleBarOverlay ? TITLEBAR_TRAFFIC_LIGHT_WIDTH : 1}>
+      <Box paddingLeft={titleBarOverlay ? titlebarLeadingInset : 1}>
         <Text attributes={TextAttributes.BOLD} fg={colors.headerText}>
           Gloomberb v{VERSION}
         </Text>
@@ -230,6 +236,7 @@ export function Header() {
           {baseCurrency}
         </Text>
       </Box>
+      {showWindowControls ? <WindowControls /> : null}
     </Box>
   );
 }

package/src/components/layout/titlebar-overlay.ts

@@ -1,2 +1,18 @@
 export const TITLEBAR_TRAFFIC_LIGHT_WIDTH = 8;
 export const TITLEBAR_OVERLAY_HEIGHT_PX = 28;
+
+function currentPlatform(): string {
+  const globalWithNavigator = globalThis as typeof globalThis & {
+    navigator?: {
+      platform?: string;
+      userAgentData?: { platform?: string };
+    };
+  };
+  return globalWithNavigator.navigator?.userAgentData?.platform
+    ?? globalWithNavigator.navigator?.platform
+    ?? "";
+}
+
+export function getTitlebarLeadingInset(platform = currentPlatform()): number {
+  return /mac/i.test(platform) ? TITLEBAR_TRAFFIC_LIGHT_WIDTH : 0;
+}

package/src/components/layout/window-controls.tsx

@@ -0,0 +1,90 @@
+import { Box, useRendererHost } from "../../ui";
+import { useCallback } from "react";
+
+const WINDOWS_CONTROL_WIDTH_PX = 30;
+const WINDOWS_CONTROL_TRAILING_PADDING_PX = 10;
+
+type WindowControlAction = "minimize" | "toggle-maximize" | "close";
+
+const WINDOWS_CONTROLS: Array<{
+  action: WindowControlAction;
+  label: string;
+}> = [
+  { action: "minimize", label: "Minimize" },
+  { action: "toggle-maximize", label: "Maximize" },
+  { action: "close", label: "Close" },
+];
+
+function stopMouse(event: { stopPropagation?: () => void; preventDefault?: () => void }) {
+  event.stopPropagation?.();
+  event.preventDefault?.();
+}
+
+function WindowControlIcon({ action }: { action: WindowControlAction }) {
+  if (action === "minimize") {
+    return (
+      <svg viewBox="0 0 12 12" width="10" height="10" fill="none" aria-hidden="true">
+        <path d="M2.5 6.5H9.5" stroke="currentColor" strokeWidth="1.25" strokeLinecap="square" />
+      </svg>
+    );
+  }
+
+  if (action === "toggle-maximize") {
+    return (
+      <svg viewBox="0 0 12 12" width="10" height="10" fill="none" aria-hidden="true">
+        <rect x="3" y="3" width="6" height="6" stroke="currentColor" strokeWidth="1.25" />
+      </svg>
+    );
+  }
+
+  return (
+    <svg viewBox="0 0 12 12" width="10" height="10" fill="none" aria-hidden="true">
+      <path d="M3 3L9 9M9 3L3 9" stroke="currentColor" strokeWidth="1.35" strokeLinecap="round" />
+    </svg>
+  );
+}
+
+export function WindowControls() {
+  const rendererHost = useRendererHost();
+
+  const controlWindow = useCallback((action: WindowControlAction, event: { stopPropagation?: () => void; preventDefault?: () => void }) => {
+    stopMouse(event);
+    void rendererHost.controlWindow?.(action);
+  }, [rendererHost]);
+
+  return (
+    <Box
+      flexDirection="row"
+      alignItems="stretch"
+      flexShrink={0}
+      className="electrobun-webkit-app-region-no-drag"
+      data-gloom-role="window-controls"
+      aria-hidden={false}
+      style={{
+        paddingRight: WINDOWS_CONTROL_TRAILING_PADDING_PX,
+      }}
+    >
+      {WINDOWS_CONTROLS.map((control) => (
+        <Box
+          key={control.action}
+          alignItems="center"
+          justifyContent="center"
+          data-gloom-role="window-control"
+          data-window-control-action={control.action}
+          data-gloom-interactive="true"
+          role="button"
+          aria-label={control.label}
+          title={control.label}
+          className="electrobun-webkit-app-region-no-drag"
+          onMouseDown={(event: { stopPropagation?: () => void; preventDefault?: () => void }) => controlWindow(control.action, event)}
+          style={{
+            width: WINDOWS_CONTROL_WIDTH_PX,
+            height: "100%",
+          }}
+        >
+          <WindowControlIcon action={control.action} />
+        </Box>
+      ))}
+    </Box>
+  );
+}

package/src/renderers/electrobun/bun/application-menu/index.test.ts

@@ -0,0 +1,12 @@
+import { describe, expect, test } from "bun:test";
+import { buildApplicationMenu, buildDesktopApplicationMenu } from "./index";
+
+describe("desktop application menu", () => {
+  test("hides the application menu on Windows to preserve vertical space", () => {
+    expect(buildDesktopApplicationMenu("win32")).toEqual([]);
+  });
+
+  test("keeps the native application menu on macOS", () => {
+    expect(buildDesktopApplicationMenu("darwin")).toEqual(buildApplicationMenu());
+  });
+});

package/src/renderers/electrobun/bun/application-menu/index.ts

@@ -121,3 +121,7 @@ export function buildApplicationMenu(): ApplicationMenuItemConfig[] {
     },
   ];
 }
+
+export function buildDesktopApplicationMenu(platform = process.platform): ApplicationMenuItemConfig[] {
+  return platform === "win32" ? [] : buildApplicationMenu();
+}

package/src/renderers/electrobun/bun/desktop/detached-windows.ts

@@ -12,6 +12,7 @@ import {
 import {
   detachedRpcKey,
   focusWindowForRpcKey,
+  paneIdFromDetachedRpcKey,
 } from "../window/focus";
 import {
   applyWindowMoveEvent,
@@ -22,6 +23,11 @@ import {
   type WindowResizeEvent,
 } from "./window-events";
 import type { DesktopStateBroadcaster, DesktopStateRpc } from "./state-broadcaster";
+import { applyWindowsWindowIcon } from "./windows-icons";
+import { desktopTitleBarStyle } from "./window-style";
+
+const INITIAL_DOCK_SUPPRESSION_MS = 800;
+const WINDOW_CONTROL_DOCK_SUPPRESSION_MS = 5_000;
 
 interface DesktopDetachedWindowManagerOptions<Rpc extends DesktopStateRpc> {
   createRpc: (key: string) => Rpc;
@@ -45,6 +51,8 @@ export class DesktopDetachedWindowManager<Rpc extends DesktopStateRpc> {
   private readonly dockTimers = new Map<string, ReturnType<typeof setTimeout>>();
   private readonly closingPanes = new Set<string>();
   private readonly pendingMoveFlush = new Set<string>();
+  private readonly suppressDockUntil = new Map<string, number>();
+  private readonly windowControlDockSuppressed = new Set<string>();
 
   constructor(private readonly options: DesktopDetachedWindowManagerOptions<Rpc>) {}
 
@@ -56,6 +64,19 @@ export class DesktopDetachedWindowManager<Rpc extends DesktopStateRpc> {
     return focusWindowForRpcKey(rpcKey, this.options.getMainWindow(), this.windows);
   }
 
+  getWindowForRpcKey(rpcKey: string | undefined): BrowserWindow | null {
+    const paneId = paneIdFromDetachedRpcKey(rpcKey);
+    return paneId ? this.windows.get(paneId) ?? null : null;
+  }
+
+  suppressAutoDockForRpcKey(rpcKey: string | undefined): void {
+    const paneId = paneIdFromDetachedRpcKey(rpcKey);
+    if (!paneId || !this.windows.has(paneId)) return;
+    this.windowControlDockSuppressed.add(paneId);
+    this.suppressDockUntil.set(paneId, Date.now() + WINDOW_CONTROL_DOCK_SUPPRESSION_MS);
+    this.options.stateBroadcaster.clearDockPreview(paneId);
+  }
+
   resolveFrame(instanceId: string): WindowFrame {
     const detachedEntry = this.options.getConfig().layout.detached.find((entry) => entry.instanceId === instanceId);
     if (detachedEntry) {
@@ -151,6 +172,8 @@ export class DesktopDetachedWindowManager<Rpc extends DesktopStateRpc> {
     this.clearTimer(this.frameTimers, instanceId);
     this.clearTimer(this.dockTimers, instanceId);
     this.pendingMoveFlush.delete(instanceId);
+    this.suppressDockUntil.delete(instanceId);
+    this.windowControlDockSuppressed.delete(instanceId);
     this.options.unregisterWindowRpc(detachedRpcKey(instanceId));
   }
 
@@ -160,18 +183,21 @@ export class DesktopDetachedWindowManager<Rpc extends DesktopStateRpc> {
   ): BrowserWindow {
     const rpc = this.options.createRpc(detachedRpcKey(instanceId));
     const initialFrame = normalizeWindowFrameWithMinimum(frame, DEFAULT_WINDOW_FRAME, DETACHED_WINDOW_MIN_SIZE);
+    const title = this.resolveTitle(instanceId);
     const window = new BrowserWindow({
-      title: this.resolveTitle(instanceId),
+      title,
       frame: initialFrame,
       url: "views://mainview/index.html",
       renderer: "native",
       rpc: rpc as never,
-      titleBarStyle: "hiddenInset",
+      titleBarStyle: desktopTitleBarStyle(),
       navigationRules: JSON.stringify(["views://*"]),
       sandbox: false,
     });
+    applyWindowsWindowIcon(title);
     updateWindowFrameCache(window, initialFrame, DETACHED_WINDOW_MIN_SIZE);
     this.windows.set(instanceId, window);
+    this.suppressDockUntil.set(instanceId, Date.now() + INITIAL_DOCK_SUPPRESSION_MS);
 
     (window as any).on?.("close", () => {
       const shouldIgnore = this.closingPanes.delete(instanceId);
@@ -230,6 +256,21 @@ export class DesktopDetachedWindowManager<Rpc extends DesktopStateRpc> {
     }, 120));
 
     this.clearTimer(this.dockTimers, instanceId);
+    if (this.windowControlDockSuppressed.has(instanceId)) {
+      this.options.stateBroadcaster.clearDockPreview(instanceId);
+      if (!edge) {
+        this.windowControlDockSuppressed.delete(instanceId);
+      }
+      return;
+    }
+
+    const suppressDockUntil = this.suppressDockUntil.get(instanceId) ?? 0;
+    if (Date.now() < suppressDockUntil) {
+      this.options.stateBroadcaster.clearDockPreview(instanceId);
+      return;
+    }
+    this.suppressDockUntil.delete(instanceId);
+
     if (!edge) {
       this.options.stateBroadcaster.clearDockPreview(instanceId);
       return;

package/src/renderers/electrobun/bun/desktop/host-requests.ts

@@ -3,10 +3,13 @@ import { ContextMenu, Utils, type BrowserWindow } from "electrobun/bun";
 import { buildSoundCommand } from "../../../../notifications/app-notifier";
 import type { DesktopRestartMessage } from "../../shared/protocol";
 import { getContextMenuRequestId, normalizeContextMenuItems } from "../context-menu/normalize";
+import { MAIN_WINDOW_RPC_KEY } from "../window/focus";
+import type { DesktopWindowControlAction } from "./window-controls";
 
 interface DesktopHostRequestOptions<TRpc> {
   clearMainWindow: () => void;
   closeAllDetachedWindows: () => void;
+  controlWindowForRpcKey: (windowKey: string | undefined, action: DesktopWindowControlAction) => boolean;
   focusWindowForRpcKey: (windowKey: string) => void;
   getMainWindow: () => BrowserWindow | null;
   getRpcWindowKey: (rpc: TRpc) => string | undefined;
@@ -37,9 +40,17 @@ function playNotificationSound(sound: string | undefined): void {
   }
 }
 
+function normalizeWindowControlAction(action: unknown): DesktopWindowControlAction {
+  if (action === "minimize" || action === "toggle-maximize" || action === "close") {
+    return action;
+  }
+  throw new Error("host.windowControl requires a valid action.");
+}
+
 export function handleDesktopHostRequest<TRpc>({
   clearMainWindow,
   closeAllDetachedWindows,
+  controlWindowForRpcKey,
   focusWindowForRpcKey,
   getMainWindow,
   getRpcWindowKey,
@@ -69,6 +80,26 @@ export function handleDesktopHostRequest<TRpc>({
       Utils.quit();
       return null;
     }
+    case "host.windowControl": {
+      const action = normalizeWindowControlAction(payload.action);
+      const windowKey = getRpcWindowKey(rpc);
+      if (action === "close" && windowKey === MAIN_WINDOW_RPC_KEY) {
+        closeAllDetachedWindows();
+        teardownServices();
+        const mainWindow = getMainWindow();
+        if (mainWindow) {
+          mainWindow.close();
+          clearMainWindow();
+          return null;
+        }
+        Utils.quit();
+        return null;
+      }
+      if (!controlWindowForRpcKey(windowKey, action)) {
+        throw new Error("No desktop window is registered for this request.");
+      }
+      return null;
+    }
     case "host.openExternal":
       if (typeof payload.url !== "string") {
         throw new Error("host.openExternal requires a URL.");

package/src/renderers/electrobun/bun/desktop/window-controls.test.ts

@@ -0,0 +1,53 @@
+import { describe, expect, test } from "bun:test";
+import { applyDesktopWindowControl } from "./window-controls";
+
+type WindowCall =
+  | { type: "close" }
+  | { type: "minimize" }
+  | { type: "maximize" }
+  | { type: "unmaximize" }
+  | { type: "setFrame"; frame: { x: number; y: number; width: number; height: number } };
+
+function createWindow() {
+  const calls: WindowCall[] = [];
+  const frame = { x: 120, y: 80, width: 640, height: 420 };
+  return {
+    calls,
+    window: {
+      frame,
+      close: () => calls.push({ type: "close" }),
+      minimize: () => calls.push({ type: "minimize" }),
+      maximize: () => calls.push({ type: "maximize" }),
+      unmaximize: () => calls.push({ type: "unmaximize" }),
+      getFrame: () => frame,
+      setFrame: (x: number, y: number, width: number, height: number) => calls.push({
+        type: "setFrame",
+        frame: { x, y, width, height },
+      }),
+    },
+  };
+}
+
+describe("applyDesktopWindowControl", () => {
+  test("minimizes and closes windows", () => {
+    const target = createWindow();
+
+    applyDesktopWindowControl(target.window, "minimize");
+    applyDesktopWindowControl(target.window, "close");
+
+    expect(target.calls).toEqual([{ type: "minimize" }, { type: "close" }]);
+  });
+
+  test("toggles maximize from the custom control state", () => {
+    const target = createWindow();
+
+    applyDesktopWindowControl(target.window, "toggle-maximize");
+    applyDesktopWindowControl(target.window, "toggle-maximize");
+
+    expect(target.calls).toEqual([
+      { type: "maximize" },
+      { type: "unmaximize" },
+      { type: "setFrame", frame: { x: 120, y: 80, width: 640, height: 420 } },
+    ]);
+  });
+});

package/src/renderers/electrobun/bun/desktop/window-controls.ts

@@ -0,0 +1,64 @@
+export type DesktopWindowControlAction = "minimize" | "toggle-maximize" | "close";
+
+interface DesktopWindowFrame {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+
+export interface ControllableDesktopWindow {
+  frame?: Partial<DesktopWindowFrame> | null;
+  close?: () => void;
+  minimize?: () => void;
+  maximize?: () => void;
+  unmaximize?: () => void;
+  getFrame?: () => Partial<DesktopWindowFrame> | null;
+  setFrame?: (x: number, y: number, width: number, height: number) => void;
+}
+
+const maximizedWindowRestoreFrames = new WeakMap<ControllableDesktopWindow, DesktopWindowFrame | null>();
+
+function normalizeFrame(frame: Partial<DesktopWindowFrame> | null | undefined): DesktopWindowFrame | null {
+  if (!frame) return null;
+  const { x, y, width, height } = frame;
+  if (!Number.isFinite(x) || !Number.isFinite(y) || !Number.isFinite(width) || !Number.isFinite(height)) {
+    return null;
+  }
+  return { x, y, width, height };
+}
+
+function readWindowFrame(window: ControllableDesktopWindow): DesktopWindowFrame | null {
+  return normalizeFrame(window.getFrame?.() ?? window.frame);
+}
+
+function restoreWindowFrame(window: ControllableDesktopWindow, frame: DesktopWindowFrame | null): void {
+  if (!frame) return;
+  window.setFrame?.(frame.x, frame.y, frame.width, frame.height);
+}
+
+export function applyDesktopWindowControl(
+  window: ControllableDesktopWindow,
+  action: DesktopWindowControlAction,
+): void {
+  if (action === "close") {
+    maximizedWindowRestoreFrames.delete(window);
+    window.close?.();
+    return;
+  }
+
+  if (action === "minimize") {
+    window.minimize?.();
+    return;
+  }
+
+  const restoreFrame = maximizedWindowRestoreFrames.get(window);
+  if (maximizedWindowRestoreFrames.has(window)) {
+    maximizedWindowRestoreFrames.delete(window);
+    window.unmaximize?.();
+    restoreWindowFrame(window, restoreFrame);
+    return;
+  }
+  maximizedWindowRestoreFrames.set(window, readWindowFrame(window));
+  window.maximize?.();
+}