feat: multi-selection on ui

ui/components/MenuBar.tsx

@@ -20,7 +20,7 @@ import { useScene } from '@/hooks/useScene'
 import { getConfig, startPipeline } from '@/lib/api/default/default'
 import { isTauri, openExternalUrl } from '@/lib/backend'
 import { exportCurrentProjectAs, importPages } from '@/lib/io/pagesIo'
-import { closeProject, redoOp, undoOp } from '@/lib/io/scene'
+import { closeProject, redoOp, selectAllTextNodesOnCurrentPage, undoOp } from '@/lib/io/scene'
 import { useEditorUiStore } from '@/lib/stores/editorUiStore'
 import { usePreferencesStore } from '@/lib/stores/preferencesStore'
 import { useSelectionStore } from '@/lib/stores/selectionStore'
@@ -275,6 +275,16 @@ export function MenuBar() {
               {t('menu.redo')}
               <MenubarShortcut>{isMacOS() ? '⇧⌘Z' : 'Ctrl+Shift+Z'}</MenubarShortcut>
             </MenubarItem>
+            <MenubarSeparator />
+            <MenubarItem
+              data-testid='menu-edit-select-all'
+              className='text-[13px]'
+              disabled={!hasPage}
+              onSelect={() => selectAllTextNodesOnCurrentPage()}
+            >
+              {t('menu.selectAll')}
+              <MenubarShortcut>{isMacOS() ? '⌘A' : 'Ctrl+A'}</MenubarShortcut>
+            </MenubarItem>
           </MenubarContent>
         </MenubarMenu>
         {menus.map(({ label, items, triggerTestId }) => (

ui/components/canvas/TextBlockLayer.tsx

@@ -80,7 +80,7 @@ export function TextBlockLayer({ showSprites, scale, style }: TextBlockLayerProp
           scale={scale}
           selected={selectedIds.has(n.id)}
           interactive={interactive}
-          onSelect={(id) => select(id, false)}
+          onSelect={(id, additive) => select(id, additive)}
           onCommit={(t) => void updateTransform(n.id, t)}
         />
       ))}
@@ -94,10 +94,16 @@ type TextBlockItemProps = {
   scale: number
   selected: boolean
   interactive: boolean
-  onSelect: (id: string) => void
+  onSelect: (id: string, additive: boolean) => void
   onCommit: (transform: Transform) => void
 }
 
+const isAdditiveEvent = (event: unknown): boolean => {
+  if (!event || typeof event !== 'object') return false
+  const e = event as { shiftKey?: boolean; metaKey?: boolean; ctrlKey?: boolean }
+  return !!(e.shiftKey || e.metaKey || e.ctrlKey)
+}
+
 const RESIZE_HANDLE_SIZE = 8
 
 type ResizeEdge = { top: boolean; bottom: boolean; left: boolean; right: boolean }
@@ -130,8 +136,9 @@ function TextBlockItem({
     ({ first, last, movement: [mx, my], event, tap }) => {
       if (!interactive) return
       event?.stopPropagation()
+      const additive = isAdditiveEvent(event)
       if (tap) {
-        onSelect(node.id)
+        onSelect(node.id, additive)
         return
       }
       if (first) {
@@ -141,7 +148,9 @@ function TextBlockItem({
           w: t.width * scale,
           h: t.height * scale,
         }
-        onSelect(node.id)
+        // Keep multi-selection intact when dragging a node that's already selected;
+        // otherwise this click is a single-select (unless the modifier is held).
+        if (additive || !selected) onSelect(node.id, additive)
       }
       const { x: sx, y: sy, w: sw, h: sh } = dragStart.current
       const edge = edgeRef.current

ui/components/panels/RenderControlsPanel.tsx

@@ -18,11 +18,18 @@ import { ColorPicker } from '@/components/ui/color-picker'
 import { FontSelect } from '@/components/ui/font-select'
 import { Input } from '@/components/ui/input'
 import { Tooltip, TooltipContent, TooltipTrigger } from '@/components/ui/tooltip'
-import { useCurrentPage, useSelectedTextNode, useTextNodes } from '@/hooks/useCurrentPage'
+import {
+  useCurrentPage,
+  useSelectedTextNode,
+  useSelectedTextNodes,
+  useTextNodes,
+  type TextNodeEntry,
+} from '@/hooks/useCurrentPage'
 import { useGetGoogleFontsCatalog, useListFonts } from '@/lib/api/default/default'
 import type {
   FontFaceInfo,
   FontPrediction,
+  Op,
   TextAlign,
   TextShaderEffect,
   TextStrokeStyle,
@@ -124,6 +131,7 @@ export function RenderControlsPanel() {
   const page = useCurrentPage()
   const textNodes = useTextNodes()
   const selectedNode = useSelectedTextNode()
+  const selectedNodes = useSelectedTextNodes()
   const { data: availableFonts = [] } = useListFonts()
   useGetGoogleFontsCatalog() // prefetch catalog so picker can decorate Google entries
   const appDefaultFont = usePreferencesStore((s) => s.defaultFont)
@@ -180,49 +188,47 @@ export function RenderControlsPanel() {
   // Mutations
   // ---------------------------------------------------------------------------
 
-  const applyStyleToNode = async (nodeId: string, updates: Partial<TextStyle>) => {
-    if (!page) return
-    const existing = page.nodes[nodeId]
-    if (!existing || !('text' in existing.kind)) return
-    const current = existing.kind.text.style ?? undefined
+  const buildStyleOp = (n: TextNodeEntry, updates: Partial<TextStyle>): Op => {
+    const current = n.data.style
     const nextStyle: TextStyle = {
       fontFamilies: updates.fontFamilies ?? current?.fontFamilies ?? [],
       fontSize: updates.fontSize ?? current?.fontSize ?? null,
-      color: updates.color ?? effectiveColorOf(current, existing.kind.text.fontPrediction),
+      color: updates.color ?? effectiveColorOf(current, n.data.fontPrediction),
       effect: updates.effect ?? current?.effect ?? null,
       stroke: updates.stroke ?? current?.stroke ?? null,
       textAlign: updates.textAlign ?? current?.textAlign ?? null,
     }
-    await applyOp(
-      ops.updateNode(page.id, nodeId, {
-        data: { text: { style: nextStyle } } as never,
-      }),
+    return ops.updateNode(page!.id, n.id, {
+      data: { text: { style: nextStyle } } as never,
+    })
+  }
+
+  const applyStyleToNodes = (
+    nodes: TextNodeEntry[],
+    updates: Partial<TextStyle>,
+    label: string,
+  ) => {
+    if (!page || nodes.length === 0) return
+    if (nodes.length === 1) {
+      void applyOp(buildStyleOp(nodes[0], updates))
+      return
+    }
+    void applyOp(
+      ops.batch(
+        label,
+        nodes.map((n) => buildStyleOp(n, updates)),
+      ),
     )
   }
 
   const applyStyleToSelected = (updates: Partial<TextStyle>): boolean => {
-    if (!selectedNode) return false
-    void applyStyleToNode(selectedNode.id, updates)
+    if (selectedNodes.length === 0) return false
+    applyStyleToNodes(selectedNodes, updates, 'Multi-block style update')
     return true
   }
 
   const applyStyleToAll = (updates: Partial<TextStyle>) => {
-    if (!hasNodes || !page) return
-    const batch = textNodes.map((n) => {
-      const current = n.data.style
-      const nextStyle: TextStyle = {
-        fontFamilies: updates.fontFamilies ?? current?.fontFamilies ?? [],
-        fontSize: updates.fontSize ?? current?.fontSize ?? null,
-        color: updates.color ?? effectiveColorOf(current, n.data.fontPrediction),
-        effect: updates.effect ?? current?.effect ?? null,
-        stroke: updates.stroke ?? current?.stroke ?? null,
-        textAlign: updates.textAlign ?? current?.textAlign ?? null,
-      }
-      return ops.updateNode(page.id, n.id, {
-        data: { text: { style: nextStyle } } as never,
-      })
-    })
-    void applyOp(ops.batch('Bulk style update', batch))
+    applyStyleToNodes(textNodes, updates, 'Bulk style update')
   }
 
   const applyStrokeSetting = (nextStroke: TextStrokeStyle) => {
@@ -257,11 +263,14 @@ export function RenderControlsPanel() {
     { value: 'right', label: t('render.alignRight'), Icon: AlignRightIcon },
   ]
 
-  const scopeLabel = selectedNode
-    ? t('render.fontScopeBlockIndex', {
-        index: textNodes.findIndex((n) => n.id === selectedNode.id) + 1,
-      })
-    : t('render.fontScopeGlobal')
+  const scopeLabel =
+    selectedNodes.length > 1
+      ? t('render.fontScopeBlocksCount', { count: selectedNodes.length })
+      : selectedNode
+        ? t('render.fontScopeBlockIndex', {
+            index: textNodes.findIndex((n) => n.id === selectedNode.id) + 1,
+          })
+        : t('render.fontScopeGlobal')
   const scopeToneClass = selectedNode
     ? 'border-primary/20 bg-primary/10 text-primary'
     : 'border-border/60 bg-muted text-muted-foreground'

ui/components/panels/TextBlocksPanel.tsx

@@ -122,6 +122,7 @@ export function TextBlocksPanel() {
                   node={node}
                   index={index}
                   selected={selectedIds.has(node.id)}
+                  onToggleSelect={() => select(node.id, true)}
                   onPatch={(patch) => void patchText(node.id, patch)}
                   onDelete={() => void removeNode(node.id)}
                   onGenerate={() => void generate()}
@@ -141,6 +142,7 @@ type BlockCardProps = {
   node: TextNodeEntry
   index: number
   selected: boolean
+  onToggleSelect: () => void
   onPatch: (patch: TextDataPatch) => void
   onDelete: () => void
   onGenerate: () => void
@@ -152,6 +154,7 @@ function BlockCard({
   node,
   index,
   selected,
+  onToggleSelect,
   onPatch,
   onDelete,
   onGenerate,
@@ -176,7 +179,16 @@ function BlockCard({
         data-selected={selected}
         className='overflow-hidden rounded-md bg-card/90 text-xs ring-1 ring-border data-[selected=true]:ring-primary'
       >
-        <AccordionTrigger className='flex w-full cursor-pointer items-center gap-1.5 px-2 py-1.5 text-left transition outline-none hover:no-underline data-[state=open]:bg-accent [&>svg]:hidden'>
+        <AccordionTrigger
+          onClick={(e) => {
+            if (e.shiftKey || e.ctrlKey || e.metaKey) {
+              e.preventDefault()
+              e.stopPropagation()
+              onToggleSelect()
+            }
+          }}
+          className='flex w-full cursor-pointer items-center gap-1.5 px-2 py-1.5 text-left transition outline-none hover:no-underline data-[state=open]:bg-accent [&>svg]:hidden'
+        >
           <span
             className={`shrink-0 rounded-md px-1.5 py-0.5 text-center text-[10px] font-medium text-white tabular-nums ${
               selected ? 'bg-primary' : 'bg-muted-foreground/60'

ui/hooks/useCurrentPage.ts

@@ -125,3 +125,23 @@ export function useSelectedTextNode(): TextNodeEntry | null {
     return null
   }, [page, nodeIds, epoch])
 }
+
+/** All selected text nodes in stacking order (for batch edits). */
+export function useSelectedTextNodes(): TextNodeEntry[] {
+  const page = useCurrentPage()
+  const nodeIds = useSelectionStore((s) => s.nodeIds)
+  const { epoch } = useScene()
+  return useMemo(() => {
+    if (!page) return []
+    const out: TextNodeEntry[] = []
+    for (const [id, node] of Object.entries(page.nodes)) {
+      if (!nodeIds.has(id) || !isTextNode(node)) continue
+      out.push({
+        id,
+        transform: node.transform ?? { x: 0, y: 0, width: 0, height: 0 },
+        data: node.kind.text,
+      })
+    }
+    return out
+  }, [page, nodeIds, epoch])
+}

ui/hooks/useKeyboardShortcuts.ts

@@ -2,7 +2,7 @@
 
 import { useEffect, useMemo } from 'react'
 
-import { redoOp, undoOp } from '@/lib/io/scene'
+import { redoOp, selectAllTextNodesOnCurrentPage, undoOp } from '@/lib/io/scene'
 import { getPlatform, formatShortcut, isModifierKey } from '@/lib/shortcutUtils'
 import { useEditorUiStore } from '@/lib/stores/editorUiStore'
 import { usePreferencesStore } from '@/lib/stores/preferencesStore'
@@ -34,6 +34,14 @@ export function useKeyboardShortcuts() {
         return
       }
 
+      // Select all text blocks on the current page. Runs outside text fields;
+      // inside a textarea/input the browser's native "select all text" wins.
+      if (mod && (event.key === 'a' || event.key === 'A') && !inTextField) {
+        event.preventDefault()
+        selectAllTextNodesOnCurrentPage()
+        return
+      }
+
       // Every other shortcut is tool-level and should not fire while typing.
       if (inTextField) return
 

ui/lib/io/scene.ts

@@ -23,8 +23,10 @@ import type {
   Op,
   OpenProjectRequest,
   ProjectSummary,
+  SceneSnapshot,
 } from '@/lib/api/schemas'
 import { queryClient } from '@/lib/queryClient'
+import { useSelectionStore } from '@/lib/stores/selectionStore'
 
 /**
  * Imperative action helpers. Every mutation below is a thin wrapper that
@@ -59,6 +61,20 @@ export async function redoOp(): Promise<void> {
   await invalidateScene()
 }
 
+/** Select every text node on the active page. No-op if no project/page open. */
+export function selectAllTextNodesOnCurrentPage(): void {
+  const pageId = useSelectionStore.getState().pageId
+  if (!pageId) return
+  const snap = queryClient.getQueryData<SceneSnapshot>(getGetSceneJsonQueryKey())
+  const page = snap?.scene?.pages?.[pageId]
+  if (!page) return
+  const ids: string[] = []
+  for (const [id, node] of Object.entries(page.nodes)) {
+    if (node && 'text' in node.kind) ids.push(id)
+  }
+  useSelectionStore.getState().selectMany(ids)
+}
+
 // Project lifecycle ----------------------------------------------------------
 
 export async function createAndOpenProject(req: CreateProjectRequest): Promise<ProjectSummary> {

ui/public/locales/en-US/translation.json

@@ -20,6 +20,7 @@
     "edit": "Edit",
     "undo": "Undo",
     "redo": "Redo",
+    "selectAll": "Select All",
     "exportGroup": "Export",
     "export": "Export...",
     "exportPsd": "Export PSD...",
@@ -205,7 +206,8 @@
     "fontSizeLabel": "Size",
     "fontScopeGlobal": "Global",
     "fontScopeBlock": "Per block",
-    "fontScopeBlockIndex": "Block {{index}}"
+    "fontScopeBlockIndex": "Block {{index}}",
+    "fontScopeBlocksCount": "{{count}} blocks"
   },
   "textBlocks": {
     "emptyPrompt": "Open an image to see text blocks.",

ui/public/locales/es-ES/translation.json

@@ -18,6 +18,7 @@
     "edit": "Editar",
     "undo": "Deshacer",
     "redo": "Rehacer",
+    "selectAll": "Seleccionar todo",
     "export": "Exportar...",
     "exportPsd": "Exportar PSD...",
     "exportAllInpainted": "Exportar todo lo rellenado...",
@@ -198,6 +199,7 @@
     "fontScopeGlobal": "Global",
     "fontScopeBlock": "Por bloque",
     "fontScopeBlockIndex": "Bloque {{index}}",
+    "fontScopeBlocksCount": "{{count}} bloques",
     "effectItalic": "Cursiva",
     "effectBold": "Negrita",
     "effectBorder": "Borde",

ui/public/locales/ja-JP/translation.json

@@ -18,6 +18,7 @@
     "edit": "編集",
     "undo": "元に戻す",
     "redo": "やり直し",
+    "selectAll": "すべて選択",
     "export": "エクスポート...",
     "exportPsd": "PSD を書き出し...",
     "exportAllInpainted": "インペイント画像をすべてエクスポート...",
@@ -198,6 +199,7 @@
     "fontScopeGlobal": "全体",
     "fontScopeBlock": "ブロックごと",
     "fontScopeBlockIndex": "ブロック {{index}}",
+    "fontScopeBlocksCount": "{{count}} ブロック",
     "effectItalic": "斜体",
     "effectBold": "太字",
     "effectBorder": "縁取り",

ui/public/locales/ko-KR/translation.json

@@ -18,6 +18,7 @@
     "edit": "편집",
     "undo": "실행 취소",
     "redo": "다시 실행",
+    "selectAll": "모두 선택",
     "export": "내보내기...",
     "exportPsd": "PSD 내보내기...",
     "exportAllInpainted": "모든 인페인트 이미지 내보내기...",
@@ -202,7 +203,8 @@
     "fontSizeLabel": "크기",
     "fontScopeGlobal": "전역",
     "fontScopeBlock": "블록별",
-    "fontScopeBlockIndex": "블록 {{index}}"
+    "fontScopeBlockIndex": "블록 {{index}}",
+    "fontScopeBlocksCount": "블록 {{count}}개"
   },
   "textBlocks": {
     "emptyPrompt": "텍스트 블록을 보려면 이미지를 열어주세요.",

ui/public/locales/pt-BR/translation.json

@@ -19,6 +19,7 @@
     "edit": "Editar",
     "undo": "Desfazer",
     "redo": "Refazer",
+    "selectAll": "Selecionar tudo",
     "export": "Exportar...",
     "exportPsd": "Exportar PSD...",
     "exportAllInpainted": "Exportar todos os inpaintings...",
@@ -203,7 +204,8 @@
     "fontSizeLabel": "Tamanho",
     "fontScopeGlobal": "Global",
     "fontScopeBlock": "Por bloco",
-    "fontScopeBlockIndex": "Bloco {{index}}"
+    "fontScopeBlockIndex": "Bloco {{index}}",
+    "fontScopeBlocksCount": "{{count}} blocos"
   },
   "textBlocks": {
     "emptyPrompt": "Abra uma imagem para ver os blocos de texto.",

ui/public/locales/ru-RU/translation.json

@@ -18,6 +18,7 @@
     "edit": "Правка",
     "undo": "Отменить",
     "redo": "Повторить",
+    "selectAll": "Выделить всё",
     "export": "Экспортировать...",
     "exportPsd": "Экспортировать PSD...",
     "exportAllInpainted": "Экспортировать все изображения после инпейнтинга...",
@@ -198,6 +199,7 @@
     "fontScopeGlobal": "Глобально",
     "fontScopeBlock": "Для блока",
     "fontScopeBlockIndex": "Блок {{index}}",
+    "fontScopeBlocksCount": "Блоков: {{count}}",
     "effectItalic": "Курсив",
     "effectBold": "Жирный",
     "effectBorder": "Обводка",

ui/public/locales/tr-TR/translation.json

@@ -18,6 +18,7 @@
     "edit": "Düzenle",
     "undo": "Geri Al",
     "redo": "Yinele",
+    "selectAll": "Tümünü Seç",
     "export": "Dışa Aktar...",
     "exportPsd": "PSD Olarak Dışa Aktar...",
     "exportAllInpainted": "Tüm İnpaint Görsellerini Dışa Aktar...",
@@ -202,7 +203,8 @@
     "fontSizeLabel": "Boyut",
     "fontScopeGlobal": "Genel",
     "fontScopeBlock": "Blok bazında",
-    "fontScopeBlockIndex": "Blok {{index}}"
+    "fontScopeBlockIndex": "Blok {{index}}",
+    "fontScopeBlocksCount": "{{count}} blok"
   },
   "textBlocks": {
     "emptyPrompt": "Metin bloklarını görmek için bir görsel açın.",

ui/public/locales/zh-CN/translation.json

@@ -18,6 +18,7 @@
     "edit": "编辑",
     "undo": "撤销",
     "redo": "重做",
+    "selectAll": "全选",
     "export": "导出...",
     "exportPsd": "导出 PSD...",
     "exportAllInpainted": "导出所有修复后的图像...",
@@ -198,6 +199,7 @@
     "fontScopeGlobal": "全局",
     "fontScopeBlock": "按文本块",
     "fontScopeBlockIndex": "文本块 {{index}}",
+    "fontScopeBlocksCount": "{{count}} 个文本块",
     "effectItalic": "斜体",
     "effectBold": "粗体",
     "effectBorder": "描边",

ui/public/locales/zh-TW/translation.json

@@ -18,6 +18,7 @@
     "edit": "編輯",
     "undo": "復原",
     "redo": "重做",
+    "selectAll": "全選",
     "export": "匯出...",
     "exportPsd": "匯出 PSD...",
     "exportAllInpainted": "匯出所有修補後的影像...",
@@ -198,6 +199,7 @@
     "fontScopeGlobal": "全域",
     "fontScopeBlock": "依文字區塊",
     "fontScopeBlockIndex": "文字區塊 {{index}}",
+    "fontScopeBlocksCount": "{{count}} 個文字區塊",
     "effectItalic": "斜體",
     "effectBold": "粗體",
     "effectBorder": "描邊",

ui/tests/hooks/useKeyboardShortcuts.test.tsx

@@ -0,0 +1,65 @@
+import { renderHook } from '@testing-library/react'
+import { fireEvent } from '@testing-library/react'
+import { beforeEach, describe, expect, it } from 'vitest'
+
+import { useKeyboardShortcuts } from '@/hooks/useKeyboardShortcuts'
+import { getGetSceneJsonQueryKey } from '@/lib/api/default/default'
+import type { Node, Page, SceneSnapshot } from '@/lib/api/schemas'
+import { queryClient } from '@/lib/queryClient'
+import { useSelectionStore } from '@/lib/stores/selectionStore'
+
+function textNode(id: string): Node {
+  return {
+    id,
+    transform: { x: 0, y: 0, width: 10, height: 10, rotationDeg: 0 },
+    visible: true,
+    kind: { text: { raw: `t-${id}` } },
+  } as unknown as Node
+}
+
+function seedScene(): SceneSnapshot {
+  const page: Page = {
+    id: 'p-1',
+    name: 'P',
+    width: 10,
+    height: 10,
+    nodes: { t1: textNode('t1'), t2: textNode('t2') },
+  } as unknown as Page
+  return {
+    epoch: 1,
+    scene: { pages: { 'p-1': page }, project: { name: 'P' } as never } as never,
+  }
+}
+
+describe('useKeyboardShortcuts — Ctrl+A', () => {
+  beforeEach(() => {
+    useSelectionStore.getState().setPage(null)
+    queryClient.clear()
+  })
+
+  it('Ctrl+A selects every text node on the active page', () => {
+    queryClient.setQueryData(getGetSceneJsonQueryKey(), seedScene())
+    useSelectionStore.getState().setPage('p-1')
+    renderHook(() => useKeyboardShortcuts())
+
+    fireEvent.keyDown(window, { key: 'a', ctrlKey: true })
+
+    expect([...useSelectionStore.getState().nodeIds].sort()).toEqual(['t1', 't2'])
+  })
+
+  it('Ctrl+A is a no-op while typing inside a textarea', () => {
+    queryClient.setQueryData(getGetSceneJsonQueryKey(), seedScene())
+    useSelectionStore.getState().setPage('p-1')
+    renderHook(() => useKeyboardShortcuts())
+
+    const textarea = document.createElement('textarea')
+    document.body.appendChild(textarea)
+    textarea.focus()
+
+    fireEvent.keyDown(textarea, { key: 'a', ctrlKey: true })
+
+    expect(useSelectionStore.getState().nodeIds.size).toBe(0)
+
+    document.body.removeChild(textarea)
+  })
+})

ui/tests/lib/io/selectAll.test.ts

@@ -0,0 +1,81 @@
+import { beforeEach, describe, expect, it } from 'vitest'
+
+import { getGetSceneJsonQueryKey } from '@/lib/api/default/default'
+import type { Node, Page, SceneSnapshot } from '@/lib/api/schemas'
+import { selectAllTextNodesOnCurrentPage } from '@/lib/io/scene'
+import { queryClient } from '@/lib/queryClient'
+import { useSelectionStore } from '@/lib/stores/selectionStore'
+
+function textNode(id: string): Node {
+  return {
+    id,
+    transform: { x: 0, y: 0, width: 10, height: 10, rotationDeg: 0 },
+    visible: true,
+    kind: { text: { raw: `t-${id}` } },
+  } as unknown as Node
+}
+
+function imageNode(id: string): Node {
+  return {
+    id,
+    transform: { x: 0, y: 0, width: 10, height: 10, rotationDeg: 0 },
+    visible: true,
+    kind: {
+      image: { role: 'source', blob: `b-${id}`, opacity: 1, naturalWidth: 1, naturalHeight: 1 },
+    },
+  } as unknown as Node
+}
+
+function seedScene(): SceneSnapshot {
+  const page: Page = {
+    id: 'p-1',
+    name: 'P',
+    width: 10,
+    height: 10,
+    nodes: {
+      src: imageNode('src'),
+      t1: textNode('t1'),
+      t2: textNode('t2'),
+      rend: imageNode('rend'),
+    },
+  } as unknown as Page
+  return {
+    epoch: 1,
+    scene: { pages: { 'p-1': page }, project: { name: 'P' } as never } as never,
+  }
+}
+
+describe('selectAllTextNodesOnCurrentPage', () => {
+  beforeEach(() => {
+    useSelectionStore.getState().setPage(null)
+    queryClient.clear()
+  })
+
+  it('is a no-op when no page is selected', () => {
+    queryClient.setQueryData(getGetSceneJsonQueryKey(), seedScene())
+    selectAllTextNodesOnCurrentPage()
+    expect(useSelectionStore.getState().nodeIds.size).toBe(0)
+  })
+
+  it('is a no-op when the scene snapshot is not cached', () => {
+    useSelectionStore.getState().setPage('p-1')
+    selectAllTextNodesOnCurrentPage()
+    expect(useSelectionStore.getState().nodeIds.size).toBe(0)
+  })
+
+  it('selects only text nodes on the active page', () => {
+    queryClient.setQueryData(getGetSceneJsonQueryKey(), seedScene())
+    useSelectionStore.getState().setPage('p-1')
+    selectAllTextNodesOnCurrentPage()
+    expect([...useSelectionStore.getState().nodeIds].sort()).toEqual(['t1', 't2'])
+  })
+
+  it('replaces existing selection with the full text-node set', () => {
+    queryClient.setQueryData(getGetSceneJsonQueryKey(), seedScene())
+    useSelectionStore.getState().setPage('p-1')
+    useSelectionStore.getState().select('src', false)
+    expect(useSelectionStore.getState().nodeIds.has('src')).toBe(true)
+    selectAllTextNodesOnCurrentPage()
+    expect([...useSelectionStore.getState().nodeIds].sort()).toEqual(['t1', 't2'])
+  })
+})