Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

13.3 KB
Raw Blame
import { useEffect, useRef, useState } from 'react';
import { createPortal } from 'react-dom';
import { useTranslation } from 'react-i18next';
import { Minus, Square, X } from 'lucide-react';

import { cn } from '@/lib/utils';
import { Spinner } from '@/components/ui/spinner';
import { ConfirmDialog } from '@/components/ui/confirm-dialog';
import { isSecondaryWindow } from '@/lib/secondaryWindow';
import { isSidebarWindow } from '@/lib/sidebarWindow';
import { isResourceUsageWindow } from '@/lib/resourceUsageWindow';
import type {
  LinuxCloseBehavior,
  WindowsCloseBehavior,
} from '../../../shared/windowBehavior';

type DesktopCloseBehavior = LinuxCloseBehavior | WindowsCloseBehavior;

interface WindowControlsProps {
  /**
   * Tailwind text color class for the icons. Defaults to the title-bar
   * warm-gray token so LoginPage / regular title bars stay unchanged.
   * Splash screens override this with `text-[hsl(var(--splash-text))]`
   * to match the Stone/Silver tones from docs/design-rules/cindy-design-system.md.
   */
  iconClassName?: string;
  /** Override the default minimize action for an auxiliary window. */
  onMinimize?: () => void | Promise<void>;
  /** Hide minimize when the current surface explicitly opts out of that action. */
  showMinimize?: boolean;
  /** Override the default close action for an auxiliary window. */
  onClose?: () => void | Promise<void>;
}

const DEFAULT_ICON_CLASS = 'text-titlebar-icon';

export function WindowControls({
  iconClassName = DEFAULT_ICON_CLASS,
  onMinimize,
  showMinimize = true,
  onClose,
}: WindowControlsProps = {}) {
  const [showCloseDialog, setShowCloseDialog] = useState(false);
  const [showCloseBehaviorDialog, setShowCloseBehaviorDialog] = useState(false);
  const [savingCloseBehavior, setSavingCloseBehavior] = useState(false);
  const savingCloseBehaviorRef = useRef(false);
  const closeBehaviorDialogVisibleRef = useRef(false);
  // 点 X 后 (无论走确认框还是直接关) 进入不可取消的 closing 态:
  //   - 有 in-flight turn 路径: ConfirmDialog 显示 loading spinner + 锁住关闭
  //   - 无 in-flight 路径:      全屏 ClosingOverlay 显示 spinner + "正在关闭…"
  // 期间 main 端走 disposer chain (~4-5s, 受 db.backup 体积影响), 完成后窗口/进程退出。
  // closingRef 与 setClosing 同步设置,用来让 onOpenChange 在 Radix Action
  // 同步触发的 onOpenChange(false) 里也能立刻拦住 (state 还没 flush 到 props)。
  const [closing, setClosing] = useState(false);
  const closingRef = useRef(false);
  const { t } = useTranslation();

  useEffect(() => {
    if (
      onClose ||
      (window.electronAPI.platform !== 'win32' && window.electronAPI.platform !== 'linux') ||
      isSecondaryWindow() ||
      isSidebarWindow() ||
      isResourceUsageWindow()
    )
      return;
    const onCloseBehaviorRequested = (): void => {
      if (closeBehaviorDialogVisibleRef.current) {
        if (window.electronAPI.platform === 'win32') {
          window.electronAPI.windowBehavior.notifyWindowsCloseBehaviorPromptShown();
        } else {
          window.electronAPI.windowBehavior.notifyLinuxCloseBehaviorPromptShown();
        }
        return;
      }
      setShowCloseBehaviorDialog(true);
    };
    return window.electronAPI.platform === 'win32'
      ? window.electronAPI.windowBehavior.onWindowsCloseBehaviorRequested(onCloseBehaviorRequested)
      : window.electronAPI.windowBehavior.onLinuxCloseBehaviorRequested(onCloseBehaviorRequested);
  }, [onClose]);

  useEffect(() => {
    closeBehaviorDialogVisibleRef.current = showCloseBehaviorDialog;
    if (!showCloseBehaviorDialog) return;
    if (window.electronAPI.platform === 'win32') {
      window.electronAPI.windowBehavior.notifyWindowsCloseBehaviorPromptShown();
    } else if (window.electronAPI.platform === 'linux') {
      window.electronAPI.windowBehavior.notifyLinuxCloseBehaviorPromptShown();
    }
  }, [showCloseBehaviorDialog]);

  const controlBase = cn(
    'flex items-center justify-center',
    'h-7 w-7',
    iconClassName,
    'transition-colors',
  );

  const handleMinimizeClick = (): void => {
    if (onMinimize) {
      void onMinimize();
      return;
    }
    window.electronAPI.windowMinimize();
  };

  // 进入 closing 态 + 调 main 端关闭。同时被"点 X 无 in-flight 直走"和 ConfirmDialog
  // 的 onConfirm 调用,共用一份语义。幂等: closingRef 守住重复调用。
  const beginClose = (): void => {
    if (closingRef.current) return;
    closingRef.current = true;
    setClosing(true);
    window.electronAPI.windowClose();
  };

  const continueCloseWithBehavior = async (behavior: DesktopCloseBehavior): Promise<void> => {
    if (behavior === 'tray') {
      window.electronAPI.windowClose();
      return;
    }
    if (behavior === 'minimize') {
      window.electronAPI.windowMinimize();
      return;
    }

    let hasInFlight = false;
    try {
      hasInFlight = await window.electronAPI.anySessionInTurn();
    } catch {
      hasInFlight = false;
    }
    if (hasInFlight) {
      setShowCloseDialog(true);
    } else {
      beginClose();
    }
  };

  const selectCloseBehavior = async (behavior: DesktopCloseBehavior): Promise<void> => {
    if (savingCloseBehaviorRef.current) return;
    savingCloseBehaviorRef.current = true;
    setSavingCloseBehavior(true);
    try {
      if (window.electronAPI.platform === 'linux') {
        await window.electronAPI.windowBehavior.setLinuxCloseBehavior(
          behavior === 'minimize' ? behavior : 'quit',
        );
      } else {
        await window.electronAPI.windowBehavior.setWindowsCloseBehavior(
          behavior === 'tray' ? behavior : 'quit',
        );
      }
      setShowCloseBehaviorDialog(false);
      await continueCloseWithBehavior(behavior);
    } catch {
      // 弹窗尚未关闭;持久化失败时保留它,不带着未知行为进入关闭流程。
    } finally {
      savingCloseBehaviorRef.current = false;
      setSavingCloseBehavior(false);
    }
  };

  // 点 X 的入口: Windows 首次关闭先在 renderer 内选择关闭行为,之后再查是否
  // 有 in-flight turn。系统 Alt+F4 / 任务栏关闭由 main 发同一个 request 事件,
  // 复用这里的自绘弹窗与后续关闭流程。
  //   - 有 → 走 ConfirmDialog 确认 (防止误关丢未完成的 turn)
  //   - 无 → 直接 beginClose, 全屏 overlay 反馈 (跳过一次点击)
  //
  // splash / login 阶段 maker-ipc handler 还没注册, invoke 会 reject ——
  // catch 后当作 false 处理 (那个阶段本来就不可能有 in-flight)。
  const handleCloseClick = async (): Promise<void> => {
    if (onClose) {
      await onClose();
      return;
    }
    // 「在新窗口打开」的副窗口 / 右侧栏子窗口 / 插件面板子窗口:关闭只关本窗
    // (会话活在主进程,不受影响),不退出 app,也没有 disposer chain,所以跳过
    // in-flight 确认框 + 全屏 closing overlay,直接调 windowClose(main 端按
    // sender 解析为 win.close())。
    if (
      isSecondaryWindow() ||
      isSidebarWindow() ||
      isResourceUsageWindow()
    ) {
      window.electronAPI.windowClose();
      return;
    }
    if (window.electronAPI.platform === 'win32') {
      let closeBehavior: WindowsCloseBehavior | null = null;
      try {
        closeBehavior = await window.electronAPI.windowBehavior.getWindowsCloseBehavior();
      } catch {
        // Main close handler remains the final authority for the persisted behavior.
      }
      if (!closeBehavior) {
        setShowCloseBehaviorDialog(true);
        return;
      }
      await continueCloseWithBehavior(closeBehavior);
      return;
    }
    if (window.electronAPI.platform === 'linux') {
      let closeBehavior: LinuxCloseBehavior | null = null;
      try {
        closeBehavior = await window.electronAPI.windowBehavior.getLinuxCloseBehavior();
      } catch {
        // Main close handler remains the final authority for the persisted behavior.
      }
      if (!closeBehavior) {
        setShowCloseBehaviorDialog(true);
        return;
      }
      await continueCloseWithBehavior(closeBehavior);
      return;
    }
    await continueCloseWithBehavior('quit');
  };

  const keepRunningBehavior: Exclude<DesktopCloseBehavior, 'quit'> =
    window.electronAPI.platform === 'linux' ? 'minimize' : 'tray';

  return (
    <>
      <div className="flex gap-0.5">
        {showMinimize && (
          <button
            className={cn(controlBase, 'hover:bg-titlebar-control-hover')}
            onClick={handleMinimizeClick}
            aria-label={t('titleBar.minimize')}
            data-tooltip-exempt="windows-system-control"
          >
            <Minus size={14} />
          </button>
        )}
        <button
          className={cn(controlBase, 'hover:bg-titlebar-control-hover')}
          onClick={() => window.electronAPI.windowMaximize()}
          aria-label={t('titleBar.maximizeOrRestore')}
          data-tooltip-exempt="windows-system-control"
        >
          <Square size={14} />
        </button>
        {closing ? (
          <span
            role="button"
            aria-disabled="true"
            aria-label={t('titleBar.closing.title')}
            tabIndex={0}
            data-tooltip-exempt="windows-system-control"
            className="inline-flex focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--focus-ring)]"
          >
            <button
              className={cn(controlBase, 'hover:bg-[#E81123] hover:text-white')}
              aria-hidden="true"
              disabled
            >
              <X size={14} />
            </button>
          </span>
        ) : (
          <button
            className={cn(controlBase, 'hover:bg-[#E81123] hover:text-white')}
            onClick={() => void handleCloseClick()}
            aria-label={t('titleBar.close')}
            data-tooltip-exempt="windows-system-control"
          >
            <X size={14} />
          </button>
        )}
      </div>
      <ConfirmDialog
        open={showCloseBehaviorDialog}
        onOpenChange={(next) => {
          // Dismissal cancels this close request without saving a choice or closing the window.
          if (savingCloseBehaviorRef.current && !next) return;
          setShowCloseBehaviorDialog(next);
        }}
        showCloseButton
        title={t('settings.windowBehavior.closePrompt.title')}
        description={t('settings.windowBehavior.closePrompt.message')}
        content={
          <p className="text-sm leading-6 text-[var(--confirm-desc)]">
            {t(
              window.electronAPI.platform === 'linux'
                ? 'settings.windowBehavior.closePrompt.linuxDetail'
                : 'settings.windowBehavior.closePrompt.detail',
            )}
          </p>
        }
        confirmText={t(`settings.windowBehavior.closeBehavior.${keepRunningBehavior}`)}
        cancelText={t('settings.windowBehavior.closeBehavior.quit')}
        autoFocusConfirm
        loading={savingCloseBehavior}
        onConfirm={() => void selectCloseBehavior(keepRunningBehavior)}
        onCancel={() => void selectCloseBehavior('quit')}
      />
      <ConfirmDialog
        open={showCloseDialog}
        onOpenChange={(next) => {
          // loading 期间 Radix Action 的同步 onOpenChange(false) / Cancel /
          // 外部状态变化都一律不放过 —— 弹框必须留着直到进程死。
          if (closingRef.current && !next) return;
          setShowCloseDialog(next);
        }}
        title={t('titleBar.closeConfirm.title')}
        description={t('titleBar.closeConfirm.description')}
        confirmText={t('titleBar.closeConfirm.confirm')}
        cancelText={t('titleBar.closeConfirm.cancel')}
        loading={closing}
        onConfirm={beginClose}
      />
      <ClosingOverlay visible={closing && !showCloseDialog} />
    </>
  );
}

/**
 * 全屏 closing 反馈层 —— 无 in-flight 直接关闭路径专用 (有 in-flight 时由 ConfirmDialog
 * 自己显示 loading spinner, 不需要这层避免双层 spinner)。
 *
 * 视觉方案: 整窗轻 dim + 中央 capsule (浮卡 + spinner + 单行文字), 用户选定的方案 B
 * (vs 全屏强 dim 双行文字 vs 顶部进度条 vs 标题栏 inline)。内容可见但锁定操作。
 *
 * 走 Portal 渲染到 document.body, 与 title-bar 解耦, 保证整窗 (含其它 modal 之上) 覆盖。
 * 整窗 dim 用极轻的 rgba(0,0,0,0.2) (比 `--overlay-modal` 的 0.5 更克制),
 * capsule bg 用 `--surface-elevated` 主题 token (规则 18), light/dark 自动适配。
 * 不响应点击 / 键盘 / region drag, 锁住所有交互直到进程退出。
 */
function ClosingOverlay({ visible }: { visible: boolean }) {
  const { t } = useTranslation();
  if (!visible) return null;
  return createPortal(
    <div
      // z-[10000]: 高于 splash 的 z-[9999], 保证退出 overlay 永远在最顶层
      className="fixed inset-0 z-[10000] flex select-none items-center justify-center"
      style={{ background: 'rgba(0, 0, 0, 0.2)' }}
      role="alertdialog"
      aria-live="polite"
      aria-label={t('titleBar.closing.title')}
    >
      <div
        className="flex items-center gap-2 rounded-full border border-[var(--border-default)] px-4 py-2 shadow-sm"
        style={{ background: 'var(--surface-elevated)' }}
      >
        <Spinner size={16} className="text-[var(--text-primary)]" />
        <span className="text-sm text-[var(--text-primary)]">{t('titleBar.closing.title')}</span>
      </div>
    </div>,
    document.body,
  );
}