Function useWindowControls

src/web-ui/src/app/hooks/useWindowControls.ts:46–399

(options?: { isToolbarMode?: boolean })

 * behavior to maximize/restore UI.
 */
export const useWindowControls = (options?: { isToolbarMode?: boolean }) => {
  const { t } = useI18n('errors');
  const isToolbarMode = options?.isToolbarMode ?? false;
  const canUseNativeWindowControls = supportsNativeWindowControls();
  const { hasWorkspace, closeWorkspace } = useWorkspaceContext();
  
  // Maximized state: ordinary OS window maximize/restore, not fullscreen.
  const [isMaximized, setIsMaximized] = useState(false);
  // OS fullscreen state: entire Desktop window fullscreen, not panel fullscreen.
  const [isFullscreen, setIsFullscreen] = useState(false);
  
  // Debounce guard to prevent rapid toggles
  const isMaximizeInProgress = useRef(false);
  const isFullscreenInProgress = useRef(false);
  
  // Skip state updates during manual operations
  const shouldSkipStateUpdate = useRef(false);

  const restoreMacOSOverlayTitlebar = useCallback(async (appWindow: any) => {
    if (!isMacOSDesktopRuntime() || isToolbarMode) return;
    try {
      if (typeof appWindow.setTitleBarStyle === 'function') {
        await appWindow.setTitleBarStyle('overlay');
      }
    } catch {
      // Ignore failures during window animation/state changes.
    }
  }, [isToolbarMode]);

  const updateWindowState = useCallback(async (appWindow: any, skipVisibilityCheck = false) => {
    if (shouldSkipStateUpdate.current) {
      return;
    }

    try {
      if (!skipVisibilityCheck) {
        const isVisible = await appWindow.isVisible();
        if (!isVisible) {
          return;
        }
      }

      const [maximized, fullscreen] = await Promise.all([
        appWindow.isMaximized(),
        appWindow.isFullscreen(),
      ]);
      setIsMaximized(maximized);
      setIsFullscreen(fullscreen);
    } catch (_error) {
      // Ignore errors to avoid noise when the window is minimized or transitioning.
    }
  }, []);

  // Listen for window state changes
  useEffect(() => {
    if (!canUseNativeWindowControls) return;

    let unlistenResized: (() => void) | undefined;