Complete client UI i18n migration

Adds client-side i18n support, language settings, translated UI copy, and locale parity coverage.
2026-06-11 14:15:35 +08:00
parent 41cf070fd8
commit 08ebe5e7e1
199 changed files with 16426 additions and 1821 deletions
@@ -27,6 +27,7 @@ import {
  type MutableRefObject,
  type Ref,
 } from "react";
+import { useTranslation } from "react-i18next";
 import { router, usePathname, type Href } from "expo-router";
 import {
  navigateToWorkspace,
@@ -123,7 +124,10 @@ import {
  requireWorkspaceExecutionDirectory,
  resolveWorkspaceExecutionDirectory,
 } from "@/utils/workspace-execution";
-import { confirmRiskyWorktreeArchive } from "@/git/worktree-archive-warning";
+import {
+  confirmRiskyWorktreeArchive,
+  type WorktreeArchiveWarningLabels,
+} from "@/git/worktree-archive-warning";
 import {
  archiveWorkspaceOptimistically,
  archiveWorkspacesOptimistically,
@@ -183,6 +187,40 @@ const syncedLoaderColorMapping = (theme: Theme) => ({
      : theme.colors.palette.amber[500],
 });

+function getWorktreeArchiveWarningLabels(
+  t: (key: string, options?: Record<string, unknown>) => string,
+): WorktreeArchiveWarningLabels {
+  return {
+    title: (worktreeName) => t("workspace.git.actions.archiveWarning.title", { worktreeName }),
+    confirm: t("workspace.git.actions.archiveWarning.confirm"),
+    cancel: t("workspace.git.actions.archiveWarning.cancel"),
+    uncommittedChanges: t("workspace.git.actions.archiveWarning.uncommittedChanges"),
+    uncommittedChangesWithDiff: (diffStat) =>
+      t("workspace.git.actions.archiveWarning.uncommittedChangesWithDiff", { diffStat }),
+    addedLine: (count) =>
+      t(
+        count === 1
+          ? "workspace.git.actions.archiveWarning.addedLine"
+          : "workspace.git.actions.archiveWarning.addedLines",
+        { count },
+      ),
+    deletedLine: (count) =>
+      t(
+        count === 1
+          ? "workspace.git.actions.archiveWarning.deletedLine"
+          : "workspace.git.actions.archiveWarning.deletedLines",
+        { count },
+      ),
+    unpushedCommit: (count) =>
+      t(
+        count === 1
+          ? "workspace.git.actions.archiveWarning.unpushedCommit"
+          : "workspace.git.actions.archiveWarning.unpushedCommits",
+        { count },
+      ),
+  };
+}
+
 function getPrIconUniMapping(state: PrHint["state"]) {
  switch (state) {
    case "merged":
@@ -307,6 +345,7 @@ function getWorkspaceArchiveStatus(
 }

 export function PrBadge({ hint }: { hint: PrHint }) {
+  const { t } = useTranslation();
  const [isHovered, setIsHovered] = useState(false);

  const handlePressIn = useCallback((event: GestureResponderEvent) => {
@@ -330,7 +369,9 @@ export function PrBadge({ hint }: { hint: PrHint }) {
  return (
    <Pressable
      accessibilityRole="link"
-      accessibilityLabel={`Pull request #${hint.number}`}
+      accessibilityLabel={t("workspace.git.pr.accessibility.pullRequest", {
+        number: hint.number,
+      })}
      hitSlop={4}
      onPressIn={handlePressIn}
      onPress={handlePress}
@@ -572,6 +613,7 @@ function ProjectKebabMenu({
  onRemoveProject: () => void;
  removeProjectStatus: "idle" | "pending" | "success";
 }) {
+  const { t } = useTranslation();
  const toast = useToast();
  const handleOpenProjectSettings = useCallback(() => {
    if (projectKey.trim().length === 0) return;
@@ -589,16 +631,16 @@ function ProjectKebabMenu({
      ?.window?.openNew?.({ pendingOpenProjectPath: trimmedPath })
      ?.catch((error) => {
        console.warn("[sidebar] openNew failed", error);
-        toast.error("Couldn't open a new window");
+        toast.error(t("sidebar.project.actions.openNewWindowFailed"));
      });
-  }, [projectPath, toast]);
+  }, [projectPath, t, toast]);
  return (
    <DropdownMenu>
      <DropdownMenuTrigger
        hitSlop={8}
        style={projectKebabStyle}
        accessibilityRole={platformIsWeb ? undefined : "button"}
-        accessibilityLabel="Project actions"
+        accessibilityLabel={t("sidebar.project.actions.menu")}
        testID={`sidebar-project-kebab-${projectKey}`}
      >
        {renderKebabTriggerIcon}
@@ -610,7 +652,7 @@ function ProjectKebabMenu({
            leading={settingsLeadingIcon}
            onSelect={handleOpenProjectSettings}
          >
-            Open project settings
+            {t("sidebar.project.actions.openSettings")}
          </DropdownMenuItem>
        ) : null}
        {canOpenInNewWindow ? (
@@ -619,17 +661,17 @@ function ProjectKebabMenu({
            leading={openInNewWindowLeadingIcon}
            onSelect={handleOpenInNewWindow}
          >
-            Open in new window
+            {t("sidebar.project.actions.openNewWindow")}
          </DropdownMenuItem>
        ) : null}
        <DropdownMenuItem
          testID={`sidebar-project-menu-remove-${projectKey}`}
          leading={trash2LeadingIcon}
          status={removeProjectStatus}
-          pendingLabel="Removing..."
+          pendingLabel={t("sidebar.project.actions.removing")}
          onSelect={onRemoveProject}
        >
-          Remove project
+          {t("sidebar.project.actions.remove")}
        </DropdownMenuItem>
      </DropdownMenuContent>
    </DropdownMenu>
@@ -669,13 +711,16 @@ function WorkspaceRowRightGroup({
  onCopyPath?: () => void;
  onRename?: () => void;
 }) {
+  const { t } = useTranslation();
  const showShortcut = showShortcutBadge && shortcutNumber !== null;
  const showKebab = Boolean(onArchive && (isHovered || isTouchPlatform));
  const showKebabInSlot = showKebab && !showShortcut;
  const shouldRenderActionSlot = Boolean(onArchive || workspace.diffStat);
  return (
    <>
-      {isCreating ? <Text style={styles.workspaceCreatingText}>Creating...</Text> : null}
+      {isCreating ? (
+        <Text style={styles.workspaceCreatingText}>{t("sidebar.workspace.status.creating")}</Text>
+      ) : null}
      {shouldRenderActionSlot ? (
        <SidebarWorkspaceTrailingActionSlot>
          <SidebarWorkspaceTrailingActionBase
@@ -733,6 +778,7 @@ function WorkspaceKebabMenu({
  archivePendingLabel?: string;
  archiveShortcutKeys?: ShortcutKey[][] | null;
 }) {
+  const { t } = useTranslation();
  const archiveTrailing = useMemo(
    () => (archiveShortcutKeys ? <Shortcut chord={archiveShortcutKeys} /> : null),
    [archiveShortcutKeys],
@@ -743,7 +789,7 @@ function WorkspaceKebabMenu({
        hitSlop={8}
        style={workspaceKebabStyle}
        accessibilityRole={platformIsWeb ? undefined : "button"}
-        accessibilityLabel="Workspace actions"
+        accessibilityLabel={t("sidebar.workspace.actions.menu")}
        testID={`sidebar-workspace-kebab-${workspaceKey}`}
      >
        {renderKebabTriggerIcon}
@@ -755,7 +801,7 @@ function WorkspaceKebabMenu({
            leading={copyLeadingIcon}
            onSelect={onCopyPath}
          >
-            Copy path
+            {t("sidebar.workspace.actions.copyPath")}
          </DropdownMenuItem>
        ) : null}
        {onCopyBranchName ? (
@@ -764,7 +810,7 @@ function WorkspaceKebabMenu({
            leading={copyLeadingIcon}
            onSelect={onCopyBranchName}
          >
-            Copy branch name
+            {t("sidebar.workspace.actions.copyBranchName")}
          </DropdownMenuItem>
        ) : null}
        {onRename ? (
@@ -773,7 +819,7 @@ function WorkspaceKebabMenu({
            leading={renameLeadingIcon}
            onSelect={onRename}
          >
-            Rename workspace
+            {t("sidebar.workspace.actions.rename")}
          </DropdownMenuItem>
        ) : null}
        {onMarkAsRead ? (
@@ -793,7 +839,7 @@ function WorkspaceKebabMenu({
          pendingLabel={archivePendingLabel}
          onSelect={onArchive}
        >
-          {archiveLabel ?? "Archive"}
+          {archiveLabel ?? t("sidebar.workspace.actions.archive")}
        </DropdownMenuItem>
      </DropdownMenuContent>
    </DropdownMenu>
@@ -912,6 +958,7 @@ function NewWorktreeButton({
  testID: string;
  showShortcutHint?: boolean;
 }) {
+  const { t } = useTranslation();
  const newWorktreeKeys = useShortcutKeys("new-worktree");

  const pressableStyle = useCallback(
@@ -940,7 +987,9 @@ function NewWorktreeButton({
            onPress={handlePress}
            disabled={loading}
            accessibilityRole={platformIsWeb ? undefined : "button"}
-            accessibilityLabel={`Create a new workspace for ${displayName}`}
+            accessibilityLabel={t("sidebar.workspace.actions.createWorkspaceFor", {
+              projectName: displayName,
+            })}
            testID={testID}
          >
            {({ hovered, pressed }) =>
@@ -959,7 +1008,9 @@ function NewWorktreeButton({
        </TooltipTrigger>
        <TooltipContent side="bottom" align="center" offset={8}>
          <View style={styles.projectActionTooltipRow}>
-            <Text style={styles.projectActionTooltipText}>New workspace</Text>
+            <Text style={styles.projectActionTooltipText}>
+              {t("sidebar.workspace.actions.newWorkspace")}
+            </Text>
            {showShortcutHint && newWorktreeKeys ? (
              <Shortcut chord={newWorktreeKeys} style={styles.projectActionTooltipShortcut} />
            ) : null}
@@ -1481,6 +1532,7 @@ function WorkspaceRowWithMenu({
  canCopyBranchName: boolean;
  isCreating?: boolean;
 }) {
+  const { t } = useTranslation();
  const toast = useToast();
  const archiveWorktree = useCheckoutGitActionsStore((state) => state.archiveWorktree);
  const queryClient = useQueryClient();
@@ -1513,12 +1565,15 @@ function WorkspaceRowWithMenu({
      return;
    }

-    const confirmed = await confirmRiskyWorktreeArchive({
-      worktreeName: workspace.name,
-      isDirty: workspace.archiveHasUncommittedChanges,
-      aheadOfOrigin: workspace.archiveUnpushedCommitCount,
-      diffStat: workspace.diffStat,
-    });
+    const confirmed = await confirmRiskyWorktreeArchive(
+      {
+        worktreeName: workspace.name,
+        isDirty: workspace.archiveHasUncommittedChanges,
+        aheadOfOrigin: workspace.archiveUnpushedCommitCount,
+        diffStat: workspace.diffStat,
+      },
+      getWorktreeArchiveWarningLabels(t),
+    );

    if (!confirmed) {
      return;
@@ -1530,12 +1585,16 @@ function WorkspaceRowWithMenu({
        workspaceDirectory: workspace.workspaceDirectory,
      });
    } catch (error) {
-      toast.error(error instanceof Error ? error.message : "Workspace path not available");
+      toast.error(
+        error instanceof Error
+          ? error.message
+          : t("sidebar.workspace.toasts.workspacePathUnavailable"),
+      );
      return;
    }

    if (!archiveDirectory) {
-      toast.error("Workspace path not available");
+      toast.error(t("sidebar.workspace.toasts.workspacePathUnavailable"));
      return;
    }

@@ -1546,10 +1605,11 @@ function WorkspaceRowWithMenu({
      cwd: archiveDirectory,
      worktreePath: archiveDirectory,
    }).catch((error) => {
-      const message = error instanceof Error ? error.message : "Failed to archive worktree";
+      const message =
+        error instanceof Error ? error.message : t("sidebar.workspace.toasts.archiveFailed");
      toast.error(message);
    });
-  }, [archiveWorktree, isArchiving, redirectAfterArchive, toast, workspace]);
+  }, [archiveWorktree, isArchiving, redirectAfterArchive, t, toast, workspace]);

  const handleArchiveWorktree = useCallback(() => {
    void archiveWorktreeAfterConfirmation();
@@ -1561,10 +1621,10 @@ function WorkspaceRowWithMenu({
    }

    const confirmed = await confirmDialog({
-      title: "Hide workspace?",
-      message: `Hide "${workspace.name}" from the sidebar?\n\nFiles on disk will not be changed.`,
-      confirmLabel: "Hide",
-      cancelLabel: "Cancel",
+      title: t("sidebar.workspace.confirmations.hideTitle"),
+      message: t("sidebar.workspace.confirmations.hideMessage", { workspaceName: workspace.name }),
+      confirmLabel: t("sidebar.workspace.confirmations.hideConfirm"),
+      cancelLabel: t("sidebar.workspace.confirmations.cancel"),
      destructive: true,
    });
    if (!confirmed) {
@@ -1573,7 +1633,7 @@ function WorkspaceRowWithMenu({

    const client = getHostRuntimeStore().getClient(workspace.serverId);
    if (!client) {
-      toast.error("Host is not connected");
+      toast.error(t("sidebar.workspace.toasts.hostDisconnected"));
      return;
    }

@@ -1585,11 +1645,13 @@ function WorkspaceRowWithMenu({
        afterHide: redirectAfterArchive,
      });
    } catch (error) {
-      toast.error(error instanceof Error ? error.message : "Failed to hide workspace");
+      toast.error(
+        error instanceof Error ? error.message : t("sidebar.workspace.toasts.hideFailed"),
+      );
    } finally {
      setIsArchivingWorkspace(false);
    }
-  }, [isArchivingWorkspace, redirectAfterArchive, toast, workspace]);
+  }, [isArchivingWorkspace, redirectAfterArchive, t, toast, workspace]);

  const handleArchiveWorkspace = useCallback(() => {
    void hideWorkspaceAfterConfirmation();
@@ -1603,23 +1665,27 @@ function WorkspaceRowWithMenu({
        workspaceDirectory: workspace.workspaceDirectory,
      });
    } catch (error) {
-      toast.error(error instanceof Error ? error.message : "Workspace path not available");
+      toast.error(
+        error instanceof Error
+          ? error.message
+          : t("sidebar.workspace.toasts.workspacePathUnavailable"),
+      );
      return;
    }
    void Clipboard.setStringAsync(copyTargetDirectory);
-    toast.copied("Path copied");
-  }, [toast, workspace.workspaceDirectory, workspace.workspaceId]);
+    toast.copied(t("sidebar.workspace.toasts.pathCopied"));
+  }, [t, toast, workspace.workspaceDirectory, workspace.workspaceId]);

  const handleCopyBranchName = useCallback(() => {
    void Clipboard.setStringAsync(workspace.name);
-    toast.copied("Branch name copied");
-  }, [toast, workspace.name]);
+    toast.copied(t("sidebar.workspace.toasts.branchNameCopied"));
+  }, [t, toast, workspace.name]);

  const renameMutation = useMutation({
    mutationFn: async (branch: string) => {
      const client = getHostRuntimeStore().getClient(workspace.serverId);
      if (!client) {
-        throw new Error("Host is not connected");
+        throw new Error(t("sidebar.workspace.toasts.hostDisconnected"));
      }
      const targetCwd = requireWorkspaceExecutionDirectory({
        workspaceId: workspace.workspaceId,
@@ -1627,7 +1693,7 @@ function WorkspaceRowWithMenu({
      });
      const payload = await client.renameBranch({ cwd: targetCwd, branch });
      if (!payload.success || payload.error) {
-        throw new Error(payload.error?.message ?? "Failed to rename branch");
+        throw new Error(payload.error?.message ?? t("sidebar.workspace.rename.invalidBranchName"));
      }
      return { targetCwd };
    },
@@ -1654,11 +1720,14 @@ function WorkspaceRowWithMenu({
    [renameMutation],
  );

-  const validateRenameSlug = useCallback((value: string): string | null => {
-    const result = validateBranchSlug(slugify(value));
-    if (result.valid) return null;
-    return result.error ?? "Invalid branch name";
-  }, []);
+  const validateRenameSlug = useCallback(
+    (value: string): string | null => {
+      const result = validateBranchSlug(slugify(value));
+      if (result.valid) return null;
+      return result.error ?? t("sidebar.workspace.rename.invalidBranchName");
+    },
+    [t],
+  );

  const archiveShortcutKeys = useShortcutKeys("archive-worktree");
  const { hasClearableAttention, clearAttention } = useClearWorkspaceAttention({
@@ -1700,9 +1769,17 @@ function WorkspaceRowWithMenu({
        isCreating={isCreating}
        dragHandleProps={dragHandleProps}
        menuController={null}
-        archiveLabel={isWorktree ? "Archive worktree" : "Hide from sidebar"}
+        archiveLabel={
+          isWorktree
+            ? t("sidebar.workspace.actions.archiveWorktree")
+            : t("sidebar.workspace.actions.hideFromSidebar")
+        }
        archiveStatus={getWorkspaceArchiveStatus(isWorktree, archiveStatus, isArchivingWorkspace)}
-        archivePendingLabel={isWorktree ? "Archiving..." : "Hiding..."}
+        archivePendingLabel={
+          isWorktree
+            ? t("sidebar.workspace.actions.archiving")
+            : t("sidebar.workspace.actions.hiding")
+        }
        onArchive={isWorktree ? handleArchiveWorktree : handleArchiveWorkspace}
        onCopyBranchName={canCopyBranchName ? handleCopyBranchName : undefined}
        onCopyPath={handleCopyPath}
@@ -1712,10 +1789,10 @@ function WorkspaceRowWithMenu({
      />
      <AdaptiveRenameModal
        visible={isRenameOpen}
-        title="Rename workspace"
+        title={t("sidebar.workspace.rename.title")}
        initialValue={workspace.name}
        placeholder="branch-name"
-        submitLabel="Rename"
+        submitLabel={t("sidebar.workspace.rename.submit")}
        validate={validateRenameSlug}
        maxLength={MAX_SLUG_LENGTH}
        onClose={handleCloseRename}
@@ -1751,6 +1828,7 @@ function NonGitProjectRowWithMenuContent({
  isDragging: boolean;
  dragHandleProps?: DraggableListDragHandleProps;
 }) {
+  const { t } = useTranslation();
  const toast = useToast();
  const contextMenu = useContextMenu();
  const [isArchivingWorkspace, setIsArchivingWorkspace] = useState(false);
@@ -1769,10 +1847,12 @@ function NonGitProjectRowWithMenuContent({

    void (async () => {
      const confirmed = await confirmDialog({
-        title: "Hide workspace?",
-        message: `Hide "${workspace.name}" from the sidebar?\n\nFiles on disk will not be changed.`,
-        confirmLabel: "Hide",
-        cancelLabel: "Cancel",
+        title: t("sidebar.workspace.confirmations.hideTitle"),
+        message: t("sidebar.workspace.confirmations.hideMessage", {
+          workspaceName: workspace.name,
+        }),
+        confirmLabel: t("sidebar.workspace.confirmations.hideConfirm"),
+        cancelLabel: t("sidebar.workspace.confirmations.cancel"),
        destructive: true,
      });
      if (!confirmed) {
@@ -1781,7 +1861,7 @@ function NonGitProjectRowWithMenuContent({

      const client = getHostRuntimeStore().getClient(workspace.serverId);
      if (!client) {
-        toast.error("Host is not connected");
+        toast.error(t("sidebar.workspace.toasts.hostDisconnected"));
        return;
      }

@@ -1794,13 +1874,15 @@ function NonGitProjectRowWithMenuContent({
            afterHide: redirectAfterArchive,
          });
        } catch (error) {
-          toast.error(error instanceof Error ? error.message : "Failed to hide workspace");
+          toast.error(
+            error instanceof Error ? error.message : t("sidebar.workspace.toasts.hideFailed"),
+          );
        } finally {
          setIsArchivingWorkspace(false);
        }
      })();
    })();
-  }, [isArchivingWorkspace, redirectAfterArchive, toast, workspace]);
+  }, [isArchivingWorkspace, redirectAfterArchive, t, toast, workspace]);

  return (
    <>
@@ -1831,11 +1913,11 @@ function NonGitProjectRowWithMenuContent({
        <ContextMenuItem
          testID={`sidebar-workspace-context-${workspace.workspaceKey}-archive`}
          status={isArchivingWorkspace ? "pending" : "idle"}
-          pendingLabel="Hiding..."
+          pendingLabel={t("sidebar.workspace.actions.hiding")}
          destructive
          onSelect={handleArchiveWorkspace}
        >
-          Hide from sidebar
+          {t("sidebar.workspace.actions.hideFromSidebar")}
        </ContextMenuItem>
      </ContextMenuContent>
    </>
@@ -2212,6 +2294,7 @@ function ProjectBlock({
  );

  const toast = useToast();
+  const { t } = useTranslation();
  const [isRemovingProject, setIsRemovingProject] = useState(false);

  const handleRemoveProject = useCallback(() => {
@@ -2221,10 +2304,10 @@ function ProjectBlock({

    void (async () => {
      const confirmed = await confirmDialog({
-        title: "Remove project?",
-        message: `Remove "${displayName}" from the sidebar?\n\nFiles on disk will not be changed.`,
-        confirmLabel: "Remove",
-        cancelLabel: "Cancel",
+        title: t("sidebar.project.confirmations.removeTitle"),
+        message: t("sidebar.project.confirmations.removeMessage", { projectName: displayName }),
+        confirmLabel: t("sidebar.project.confirmations.removeConfirm"),
+        cancelLabel: t("sidebar.project.confirmations.cancel"),
        destructive: true,
      });
      if (!confirmed) {
@@ -2233,7 +2316,7 @@ function ProjectBlock({

      const client = getHostRuntimeStore().getClient(serverId);
      if (!client) {
-        toast.error("Host is not connected");
+        toast.error(t("sidebar.project.toasts.hostDisconnected"));
        return;
      }

@@ -2243,13 +2326,13 @@ function ProjectBlock({
        workspaces: project.workspaces,
      }).then((failures) => {
        if (failures.length > 0) {
-          toast.error("Failed to remove some workspaces");
+          toast.error(t("sidebar.project.toasts.removeFailed"));
        }
        setIsRemovingProject(false);
        return;
      });
    })();
-  }, [isRemovingProject, serverId, displayName, toast, project.workspaces]);
+  }, [isRemovingProject, serverId, displayName, t, toast, project.workspaces]);

  const flattenedRowWorkspaceId =
    rowModel.kind === "workspace_link" ? rowModel.workspace.workspaceId : null;
@@ -2476,6 +2559,7 @@ function ProjectModeList({
 }: Omit<SidebarWorkspaceListProps, "groupMode" | "isRefreshing" | "onRefresh"> & {
  pathname: string;
 }) {
+  const { t } = useTranslation();
  const [creatingWorkspaceIds, setCreatingWorkspaceIds] = useState<Set<string>>(() => new Set());
  const creatingWorkspaceTimeoutsRef = useRef<Map<string, ReturnType<typeof setTimeout>>>(
    new Map(),
@@ -2688,10 +2772,10 @@ function ProjectModeList({
    <>
      {projects.length === 0 ? (
        <View style={styles.emptyContainer}>
-          <Text style={styles.emptyTitle}>No projects yet</Text>
-          <Text style={styles.emptyText}>Add a project to get started</Text>
+          <Text style={styles.emptyTitle}>{t("sidebar.project.empty.title")}</Text>
+          <Text style={styles.emptyText}>{t("sidebar.project.empty.description")}</Text>
          <Button variant="ghost" size="sm" leftIcon={Plus} onPress={onAddProject}>
-            Add project
+            {t("sidebar.actions.addProject")}
          </Button>
        </View>
      ) : (