@veltra/sheet 2.0.1 → 2.2.0

package/src/components/sheet/__test__/formula-bar.test.ts

@@ -0,0 +1,474 @@
+import { parseRange } from '@veltra/sheet-core/core/address'
+import { Workbook } from '@veltra/sheet-core/core/workbook'
+import { afterEach, describe, expect, it } from 'vitest'
+import { createApp, h, nextTick, type App } from 'vue'
+
+import { USheet } from '../../../index'
+import { createSheetContext } from '../../../tools/context'
+import type { SheetExposed } from '../../../types'
+import UFormulaBar from '../formula-bar.vue'
+
+const apps: App[] = []
+const containers: HTMLElement[] = []
+
+function mount(
+  props: () => Record<string, unknown> = () => ({}),
+  exposedRef?: { value: SheetExposed | undefined }
+) {
+  const el = document.createElement('div')
+  el.style.width = '800px'
+  el.style.height = '600px'
+  document.body.appendChild(el)
+  containers.push(el)
+  const app = createApp({
+    render: () =>
+      h(USheet, {
+        ...props(),
+        ref: (value: unknown) => {
+          if (exposedRef) exposedRef.value = value as SheetExposed | undefined
+        }
+      })
+  })
+  app.mount(el)
+  apps.push(app)
+  return { app, el }
+}
+
+function mountFormulaBar(sheet: Workbook['activeSheet']) {
+  const el = document.createElement('div')
+  document.body.appendChild(el)
+  containers.push(el)
+  const exposed: { value: InstanceType<typeof UFormulaBar> | undefined } = { value: undefined }
+  const app = createApp({
+    render: () =>
+      h(UFormulaBar, {
+        sheet,
+        context: createSheetContext(sheet),
+        ref: (value: unknown) => {
+          exposed.value = value as InstanceType<typeof UFormulaBar> | undefined
+        }
+      })
+  })
+  app.mount(el)
+  apps.push(app)
+  return { el, exposed }
+}
+
+function createWorkbook() {
+  const workbook = new Workbook()
+  workbook.addSheet('Sheet2')
+  return workbook
+}
+
+afterEach(() => {
+  while (apps.length) apps.pop()!.unmount()
+  while (containers.length) containers.pop()!.remove()
+})
+
+function nameBox(el: HTMLElement): HTMLInputElement {
+  return el.querySelector<HTMLInputElement>('.u-sheet__name-box')!
+}
+
+function fxInput(el: HTMLElement): HTMLTextAreaElement {
+  return el.querySelector<HTMLTextAreaElement>('.u-sheet__fx-input')!
+}
+
+/** 名称框输入并按键（默认 Enter） */
+function typeName(el: HTMLElement, text: string, key = 'Enter'): void {
+  const input = nameBox(el)
+  input.value = text
+  input.dispatchEvent(new Event('input', { bubbles: true }))
+  if (key) input.dispatchEvent(new KeyboardEvent('keydown', { key, bubbles: true }))
+}
+
+/** fx 输入栏聚焦 → 输入 → 按键（key = null 时不按键，保持编辑态） */
+function typeFx(el: HTMLElement, text: string, key: string | null = null): void {
+  const input = fxInput(el)
+  input.dispatchEvent(new FocusEvent('focus'))
+  input.value = text
+  input.dispatchEvent(new Event('input', { bubbles: true }))
+  if (key) input.dispatchEvent(new KeyboardEvent('keydown', { key, bubbles: true }))
+}
+
+describe('USheet 公式栏（名称框 + fx 输入栏）', () => {
+  it('选区变化 → 名称框 / 输入栏内容正确（普通值 / 公式原文 / 空 / 合并格锚点）', async () => {
+    const workbook = new Workbook()
+    const sheet = workbook.activeSheet
+    const { el } = mount(() => ({ workbook, rows: 20, cols: 8 }))
+    await nextTick()
+
+    // 默认选区 A1：名称框显示 A1，fx 输入栏可用
+    expect(nameBox(el).value).toBe('A1')
+    expect(fxInput(el).disabled).toBe(false)
+    expect(fxInput(el).value).toBe('')
+
+    // 普通值 → 原始值文本
+    sheet.setCellValue({ row: 0, col: 0 }, 'hello')
+    await nextTick()
+    expect(fxInput(el).value).toBe('hello')
+
+    // 公式格 → '=' + f 原文
+    sheet.setCellFormula({ row: 0, col: 0 }, '=SUM(1,2)')
+    await nextTick()
+    expect(fxInput(el).value).toBe('=SUM(1,2)')
+
+    // 区域选区 → A1:B2 序列化；活动格（区域起点）为空 → 输入栏空
+    sheet.selectRange({ start: { row: 1, col: 1 }, end: { row: 3, col: 3 } })
+    await nextTick()
+    expect(nameBox(el).value).toBe('B2:D4')
+    expect(fxInput(el).value).toBe('')
+
+    // 合并格锚点：点被覆盖格 → 名称框显示锚点地址（B2）
+    sheet.mergeCells({ start: { row: 1, col: 1 }, end: { row: 2, col: 2 } })
+    sheet.selectCell({ row: 2, col: 2 })
+    await nextTick()
+    expect(sheet.getSelection().activeCell).toEqual({ row: 1, col: 1 })
+    expect(nameBox(el).value).toBe('B2')
+  })
+
+  it('输入 =SUM(A1:A2) 提交 → 模型公式与计算值正确；普通文本原样存储；Esc 不改模型', async () => {
+    const workbook = new Workbook()
+    const sheet = workbook.activeSheet
+    sheet.setCellValue({ row: 0, col: 0 }, 1)
+    sheet.setCellValue({ row: 1, col: 0 }, 2)
+    const { el } = mount(() => ({ workbook, rows: 20, cols: 8 }))
+    await nextTick()
+    sheet.selectCell({ row: 2, col: 0 })
+    await nextTick()
+
+    // 公式提交：'=' 前缀自动公式路径；计算值正确；提交后显示公式原文；选区保持
+    typeFx(el, '=SUM(A1:A2)', 'Enter')
+    await nextTick()
+    expect(sheet.getCellData({ row: 2, col: 0 })).toMatchObject({ f: 'SUM(A1:A2)', v: 3, t: 'n' })
+    expect(sheet.getDisplayValue({ row: 2, col: 0 })).toBe(3)
+    expect(fxInput(el).value).toBe('=SUM(A1:A2)')
+    expect(sheet.getSelection().activeCell).toEqual({ row: 2, col: 0 })
+
+    // 普通文本原样存储（首尾空格不 trim）
+    typeFx(el, '  hello  ', 'Enter')
+    await nextTick()
+    expect(sheet.getCellData({ row: 2, col: 0 })).toMatchObject({ v: '  hello  ', t: 's' })
+
+    // Esc 取消：不改模型，输入栏还原为模型内容
+    typeFx(el, 'zzz', 'Escape')
+    await nextTick()
+    expect(sheet.getCellData({ row: 2, col: 0 })).toMatchObject({ v: '  hello  ' })
+    expect(fxInput(el).value).toBe('  hello  ')
+
+    // 失焦提交（Excel 语义：点击网格等场景自然提交）
+    typeFx(el, 'blur-submit')
+    fxInput(el).dispatchEvent(new FocusEvent('blur'))
+    await nextTick()
+    expect(sheet.getCellData({ row: 2, col: 0 })).toMatchObject({ v: 'blur-submit' })
+  })
+
+  it('名称框输入 B3 / B3:D5 跳转正确；非法输入被拒绝', async () => {
+    const workbook = new Workbook()
+    const sheet = workbook.activeSheet
+    const { el } = mount(() => ({ workbook, rows: 20, cols: 8 }))
+    await nextTick()
+
+    // 单格地址 → selectCell 跳转
+    typeName(el, 'B3')
+    await nextTick()
+    expect(sheet.getSelection().activeCell).toEqual({ row: 2, col: 1 })
+    expect(nameBox(el).value).toBe('B3')
+
+    // 区域 → selectRange 跳转
+    typeName(el, 'B3:D5')
+    await nextTick()
+    expect(sheet.getSelection().ranges[0]).toEqual({
+      start: { row: 2, col: 1 },
+      end: { row: 4, col: 3 }
+    })
+    expect(nameBox(el).value).toBe('B3:D5')
+
+    // 非法：不跳转、不写入，名称框还原为当前选区地址
+    typeName(el, 'INVALID!')
+    await nextTick()
+    expect(sheet.getSelection().ranges[0]).toEqual({
+      start: { row: 2, col: 1 },
+      end: { row: 4, col: 3 }
+    })
+    expect(nameBox(el).value).toBe('B3:D5')
+
+    // Esc：还原显示
+    typeName(el, 'X99', 'Escape')
+    await nextTick()
+    expect(sheet.getSelection().ranges[0]).toEqual({
+      start: { row: 2, col: 1 },
+      end: { row: 4, col: 3 }
+    })
+    expect(nameBox(el).value).toBe('B3:D5')
+  })
+
+  it('公式栏编辑期间网格事件不打断输入；提交后网格渲染计算值', async () => {
+    const workbook = new Workbook()
+    const sheet = workbook.activeSheet
+    const exposed: { value: SheetExposed | undefined } = { value: undefined }
+    sheet.setCellValue({ row: 0, col: 0 }, 1)
+    sheet.setCellValue({ row: 1, col: 0 }, 2)
+    const { el } = mount(() => ({ workbook, rows: 20, cols: 8 }), exposed)
+    await nextTick()
+    sheet.selectCell({ row: 2, col: 0 })
+    await nextTick()
+
+    // 聚焦进入编辑态并输入（不按键）
+    typeFx(el, '=SUM(A1:A2)')
+    // 网格侧选区变化（编辑态锁：输入内容不被覆盖）
+    sheet.selectCell({ row: 5, col: 5 })
+    await nextTick()
+    expect(fxInput(el).value).toBe('=SUM(A1:A2)')
+
+    // 提交 → 写进入编辑时的格（A3），而非当前选区格（F6）
+    fxInput(el).dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', bubbles: true }))
+    await nextTick()
+    expect(sheet.getCellData({ row: 2, col: 0 })).toMatchObject({ f: 'SUM(A1:A2)', v: 3 })
+
+    // 提交后网格渲染计算值（模型 A3 → 表格坐标 (1,3)）
+    expect(exposed.value?.getGrid()?.getTable().getCellValue(1, 3)).toBe(3)
+  })
+
+  it('网格侧编辑提交（change_cell_value）后公式栏同步显示', async () => {
+    const workbook = new Workbook()
+    const sheet = workbook.activeSheet
+    const exposed: { value: SheetExposed | undefined } = { value: undefined }
+    const { el } = mount(() => ({ workbook, rows: 20, cols: 8 }), exposed)
+    await nextTick()
+    sheet.selectCell({ row: 0, col: 0 })
+    await nextTick()
+
+    // 模拟网格双击编辑提交（与 grid 测试同一路径：change_cell_value → 模型回写）
+    exposed.value?.getGrid()?.getTable().changeCellValue(1, 1, 'grid-edited', false, true)
+    await nextTick()
+    expect(fxInput(el).value).toBe('grid-edited')
+  })
+
+  it('网格编辑器打开（startEditCell）→ 公式栏镜像显示公式原文，提交后退出镜像', async () => {
+    const workbook = new Workbook()
+    const sheet = workbook.activeSheet
+    const exposed: { value: SheetExposed | undefined } = { value: undefined }
+    sheet.setCellFormula({ row: 0, col: 0 }, '=SUM(1,2)')
+    const { el } = mount(() => ({ workbook, rows: 20, cols: 8 }), exposed)
+    await nextTick()
+    sheet.selectCell({ row: 0, col: 0 })
+    await nextTick()
+
+    // 程序化进入网格编辑（表格坐标 (1,1) = 模型 A1）
+    exposed.value?.getGrid()?.getTable().startEditCell(1, 1)
+    await nextTick()
+    expect(fxInput(el).readOnly).toBe(true)
+    expect(fxInput(el).value).toBe('=SUM(1,2)')
+
+    // 提交 → 编辑器 onEnd → 公式栏退出镜像（显示模型内容）
+    exposed.value?.getGrid()?.getTable().completeEditCell()
+    await nextTick()
+    expect(sheet.getCellData({ row: 0, col: 0 })).toMatchObject({ f: 'SUM(1,2)' })
+    expect(fxInput(el).readOnly).toBe(false)
+    expect(fxInput(el).value).toBe('=SUM(1,2)')
+  })
+
+  it('tab 切换：重绑订阅并刷新（新 sheet 的选区 / 单元格内容回显）', async () => {
+    const workbook = createWorkbook()
+    const sheet1 = workbook.activeSheet
+    const sheet2 = workbook.getSheet('Sheet2')!
+    const { el } = mount(() => ({ workbook, rows: 20, cols: 8 }))
+    await nextTick()
+    // Sheet1 默认选区 A1
+    expect(nameBox(el).value).toBe('A1')
+
+    // Sheet2 的选区不影响公式栏（订阅的是 Sheet1）
+    sheet2.selectCell({ row: 1, col: 1 })
+    await nextTick()
+    expect(nameBox(el).value).toBe('A1')
+
+    workbook.activateSheet('Sheet2')
+    await nextTick()
+    expect(nameBox(el).value).toBe('B2')
+
+    sheet2.setCellValue({ row: 1, col: 1 }, 's2')
+    await nextTick()
+    expect(fxInput(el).value).toBe('s2')
+
+    // 切回 Sheet1：公式栏跟随
+    workbook.activateSheet('Sheet1')
+    await nextTick()
+    expect(nameBox(el).value).toBe('A1')
+  })
+
+  it('fx 编辑中切换 tab：编辑态重置，草稿不写入任何 sheet', async () => {
+    const workbook = createWorkbook()
+    const sheet1 = workbook.activeSheet
+    const sheet2 = workbook.getSheet('Sheet2')!
+    const { el } = mount(() => ({ workbook, rows: 20, cols: 8 }))
+    await nextTick()
+    sheet1.selectCell({ row: 0, col: 0 })
+    await nextTick()
+
+    // 进入 fx 编辑态并输入草稿
+    const input = fxInput(el)
+    input.dispatchEvent(new Event('focus', { bubbles: true }))
+    input.value = 'draft'
+    input.dispatchEvent(new Event('input', { bubbles: true }))
+    await nextTick()
+
+    // 切 tab → 编辑态重置（editing=false、editAddr=null）
+    workbook.activateSheet('Sheet2')
+    await nextTick()
+    // fx 显示新 sheet 内容（空），不再显示草稿
+    expect(input.value).toBe('')
+    // Enter 提交：编辑态已重置 → 不写入
+    input.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', bubbles: true }))
+    await nextTick()
+    expect(sheet2.getCellData({ row: 0, col: 0 })).toBeUndefined()
+    expect(sheet1.getCellData({ row: 0, col: 0 })).toBeUndefined()
+  })
+
+  it('showFormulaBar=false 隐藏公式栏', async () => {
+    const { el } = mount(() => ({ showFormulaBar: false }))
+    await nextTick()
+    expect(el.querySelector('.u-sheet__formula-bar')).toBeNull()
+  })
+})
+
+/** 设置 fx 文本并同步光标到末尾（触发补全 / 引用选择上下文） */
+function setFxText(el: HTMLElement, text: string): HTMLTextAreaElement {
+  const input = fxInput(el)
+  input.dispatchEvent(new FocusEvent('focus'))
+  input.value = text
+  input.dispatchEvent(new Event('input', { bubbles: true }))
+  input.setSelectionRange(text.length, text.length)
+  input.dispatchEvent(new Event('keyup', { bubbles: true }))
+  return input
+}
+
+function suggestList(el: HTMLElement): HTMLElement | null {
+  return el.querySelector('.u-sheet__fx-suggest')
+}
+
+describe('USheet 公式栏：函数补全与引用选择', () => {
+  it('输入 = 弹出候选含 SUM；SU 过滤到 SUM；↓+Enter 替换为 =SUM() 且光标在括号内', async () => {
+    const workbook = new Workbook()
+    const { el } = mount(() => ({ workbook, rows: 20, cols: 8 }))
+    await nextTick()
+
+    setFxText(el, '=')
+    await nextTick()
+    expect(suggestList(el)).not.toBeNull()
+    const emptyPrefixNames = [...el.querySelectorAll('.u-sheet__fx-suggest-item')].map(
+      (n) => n.querySelector('.u-sheet__fx-suggest-sig')!.textContent
+    )
+    expect(emptyPrefixNames.length).toBeGreaterThan(0)
+    expect(emptyPrefixNames.some((t) => t?.startsWith('SUM('))).toBe(true)
+
+    setFxText(el, '=SU')
+    await nextTick()
+    const items = [...el.querySelectorAll('.u-sheet__fx-suggest-item')].map(
+      (n) => n.querySelector('.u-sheet__fx-suggest-sig')!.textContent
+    )
+    expect(items.some((t) => t?.startsWith('SUM('))).toBe(true)
+
+    const input = fxInput(el)
+    input.dispatchEvent(new KeyboardEvent('keydown', { key: 'ArrowDown', bubbles: true }))
+    input.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', bubbles: true }))
+    await nextTick()
+    expect(input.value).toBe('=SUM()')
+    expect(input.selectionStart).toBe(5)
+    expect(suggestList(el)).toBeNull()
+  })
+
+  it('Esc 分层：先关候选再取消编辑；候选开着时 Enter 确认而非提交', async () => {
+    const workbook = new Workbook()
+    const sheet = workbook.activeSheet
+    sheet.setCellValue({ row: 0, col: 0 }, 'keep')
+    const { el } = mount(() => ({ workbook, rows: 20, cols: 8 }))
+    await nextTick()
+
+    const input = setFxText(el, '=S')
+    await nextTick()
+    expect(suggestList(el)).not.toBeNull()
+
+    input.dispatchEvent(new KeyboardEvent('keydown', { key: 'Escape', bubbles: true }))
+    await nextTick()
+    expect(suggestList(el)).toBeNull()
+    expect(input.value).toBe('=S') // 仍在编辑
+
+    input.dispatchEvent(new KeyboardEvent('keydown', { key: 'Escape', bubbles: true }))
+    await nextTick()
+    expect(input.value).toBe('keep') // 取消还原
+    expect(sheet.getCellData({ row: 0, col: 0 })).toMatchObject({ v: 'keep' })
+  })
+
+  it('引用插入文本与光标位置；blur 抑制；非引用选择失焦仍提交', async () => {
+    const workbook = new Workbook()
+    const sheet = workbook.activeSheet
+    const exposed: { value: SheetExposed | undefined } = { value: undefined }
+    const { el } = mount(() => ({ workbook, rows: 20, cols: 8 }), exposed)
+    await nextTick()
+    sheet.selectCell({ row: 2, col: 0 })
+    await nextTick()
+
+    const input = setFxText(el, '=SUM(')
+    await nextTick()
+
+    // pointerdown on grid → blur 不提交（引用选择）；监听绑定在实例容器（LRU 缓存）
+    const gridEl = el.querySelector('.u-sheet__grid-instance')!
+    gridEl.dispatchEvent(new PointerEvent('pointerdown', { bubbles: true }))
+    input.dispatchEvent(new FocusEvent('blur'))
+    await nextTick()
+    expect(sheet.getCellData({ row: 2, col: 0 })).toBeUndefined()
+    expect(input.value).toBe('=SUM(')
+
+    // 网格选区拦截 → handleRefSelect 路径（VTable 时序见 sheet-core selection-debug）
+    const { el: barEl, exposed: barExposed } = mountFormulaBar(sheet)
+    await nextTick()
+    setFxText(barEl, '=SUM(')
+    await nextTick()
+    barExposed.value!.handleRefSelect(parseRange('A1:B2'))
+    await nextTick()
+    const barInput = fxInput(barEl)
+    expect(barInput.value).toBe('=SUM(A1:B2')
+    expect(barInput.selectionStart).toBe('=SUM(A1:B2'.length)
+
+    // 非引用选择场景失焦提交
+    setFxText(el, 'plain')
+    await nextTick()
+    fxInput(el).dispatchEvent(new FocusEvent('blur'))
+    await nextTick()
+    expect(sheet.getCellData({ row: 2, col: 0 })).toMatchObject({ v: 'plain' })
+  })
+
+  it('网格镜像期不弹补全', async () => {
+    const workbook = new Workbook()
+    const sheet = workbook.activeSheet
+    const exposed: { value: SheetExposed | undefined } = { value: undefined }
+    sheet.setCellFormula({ row: 0, col: 0 }, '=SUM(1,2)')
+    const { el } = mount(() => ({ workbook, rows: 20, cols: 8 }), exposed)
+    await nextTick()
+    sheet.selectCell({ row: 0, col: 0 })
+    await nextTick()
+
+    exposed.value?.getGrid()?.getTable().startEditCell(1, 1)
+    await nextTick()
+    expect(fxInput(el).readOnly).toBe(true)
+    expect(fxInput(el).value).toBe('=SUM(1,2)')
+    expect(suggestList(el)).toBeNull()
+
+    exposed.value?.getGrid()?.getTable().completeEditCell()
+    await nextTick()
+  })
+
+  it('连续引用选择：=A1+ 后再插入 B1', async () => {
+    const sheet = new Workbook().activeSheet
+    const { el, exposed } = mountFormulaBar(sheet)
+    await nextTick()
+    sheet.selectCell({ row: 2, col: 0 })
+    await nextTick()
+
+    setFxText(el, '=A1+')
+    await nextTick()
+    exposed.value!.handleRefSelect(parseRange('B1'))
+    await nextTick()
+    expect(fxInput(el).value).toBe('=A1+B1')
+  })
+})

package/src/components/sheet/__test__/import-file.test.ts

@@ -0,0 +1,183 @@
+import type { Sheet } from '@veltra/sheet-core/core/sheet'
+import { Workbook } from '@veltra/sheet-core/core/workbook'
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import { ref } from 'vue'
+
+import { IMPORT_FILE_ACCEPT, importFromFile, pickAndImportFile } from '../import-file'
+
+const mocks = vi.hoisted(() => {
+  const message = vi.fn(() => ({ close: vi.fn(), id: 'loading', onClosed: Promise.resolve() }))
+  for (const type of ['success', 'warn', 'info', 'error', 'default']) {
+    message[type] = vi.fn()
+  }
+  return {
+    message,
+    messageConfirm: { danger: vi.fn() },
+    importCsv: vi.fn(),
+    importXlsx: vi.fn(() =>
+      Promise.resolve({
+        getSheets: () => [{ name: 'S1', snapshot: () => EMPTY_SNAPSHOT }],
+        activeSheetIndex: 0
+      })
+    ),
+    replaceWorkbookWithSnapshots: vi.fn()
+  }
+})
+
+/** 空表快照（快照数组路径的源数据） */
+const EMPTY_SNAPSHOT = {
+  cells: [],
+  styles: [],
+  merges: [],
+  frozen: { rows: 0, cols: 0 },
+  rows: 0,
+  cols: 0
+}
+
+vi.mock('@veltra/desktop', () => ({ message: mocks.message, messageConfirm: mocks.messageConfirm }))
+
+vi.mock('@veltra/sheet-core/core/io/import', () => ({
+  importCsv: mocks.importCsv,
+  importXlsx: mocks.importXlsx,
+  replaceWorkbookWithSnapshots: mocks.replaceWorkbookWithSnapshots
+}))
+
+function makeOptions(
+  overrides: {
+    onWorkbookReplaced?: () => void
+    onCsvImported?: () => void
+    parsing?: ReturnType<typeof ref<boolean>>
+  } = {}
+) {
+  const workbook = new Workbook()
+  const activeSheet = workbook.activeSheet as Sheet
+  return {
+    workbook,
+    activeSheet,
+    parsing: overrides.parsing ?? ref(false),
+    parseProgress: ref({ done: 0, total: 0 }),
+    onCsvImported: overrides.onCsvImported,
+    onWorkbookReplaced: overrides.onWorkbookReplaced
+  }
+}
+
+/** 触发 xlsx 导入并等异步链（arrayBuffer → importXlsx → danger）完成 */
+async function triggerXlsxAndAwait(
+  options: ReturnType<typeof makeOptions>,
+  name = 'test.xlsx'
+): Promise<void> {
+  const file = {
+    name,
+    arrayBuffer: () => Promise.resolve(new ArrayBuffer(8)),
+    text: () => Promise.resolve('')
+  } as File
+  importFromFile(file, options)
+  await Promise.resolve()
+  await Promise.resolve()
+  await Promise.resolve()
+}
+
+/** 取 messageConfirm.danger 注册的 onClosed 回调 */
+function getOnClosed(): (action: string) => void {
+  const opts = mocks.messageConfirm.danger.mock.calls[0]![1] as {
+    onClosed: (action: string) => void
+  }
+  return opts.onClosed
+}
+
+afterEach(() => {
+  vi.clearAllMocks()
+  document.body.querySelectorAll('input[type="file"]').forEach((el) => el.remove())
+})
+
+describe('importFromFile 导入确认兜底', () => {
+  it('确认后：loading 提示 → replaceWorkbookWithSnapshots → 成功提示', async () => {
+    const replaced = vi.fn()
+    const parsingRef = ref(false)
+    const options = makeOptions({ onWorkbookReplaced: replaced, parsing: parsingRef })
+    await triggerXlsxAndAwait(options)
+    const onClosed = getOnClosed()
+    await onClosed('confirm')
+
+    expect(parsingRef.value).toBe(false)
+    expect(mocks.message).toHaveBeenCalledWith(
+      expect.objectContaining({ message: '正在导入…', duration: 0 })
+    )
+    expect(mocks.replaceWorkbookWithSnapshots).toHaveBeenCalledTimes(1)
+    expect(mocks.replaceWorkbookWithSnapshots).toHaveBeenCalledWith(
+      expect.anything(),
+      [{ name: 'S1', snapshot: EMPTY_SNAPSHOT }],
+      0
+    )
+    expect(replaced).toHaveBeenCalledTimes(1)
+    await new Promise((resolve) =>
+      requestAnimationFrame(() => requestAnimationFrame(() => resolve()))
+    )
+    expect(mocks.message.success).toHaveBeenCalledWith('导入完成')
+  })
+
+  it('replaceWorkbookWithSnapshots 抛错：报错提示 + 不误报成功 + 不通知宿主', async () => {
+    const replaced = vi.fn()
+    const options = makeOptions({ onWorkbookReplaced: replaced, parsing: ref(false) })
+    await triggerXlsxAndAwait(options)
+    const loadingClose = vi.fn()
+    mocks.message.mockReturnValueOnce({
+      close: loadingClose,
+      id: 'loading',
+      onClosed: Promise.resolve()
+    })
+    mocks.replaceWorkbookWithSnapshots.mockImplementationOnce(() => {
+      throw new Error('内存不足 boom')
+    })
+
+    const onClosed = getOnClosed()
+    await onClosed('confirm')
+
+    expect(mocks.replaceWorkbookWithSnapshots).toHaveBeenCalledTimes(1)
+    expect(replaced).not.toHaveBeenCalled()
+    expect(mocks.message.error).toHaveBeenCalledWith('导入失败：内存不足 boom')
+    expect(mocks.message.success).not.toHaveBeenCalled()
+    expect(loadingClose).toHaveBeenCalledTimes(1)
+  })
+
+  it('取消（非 confirm）：不触发导入', async () => {
+    const options = makeOptions({ parsing: ref(false) })
+    await triggerXlsxAndAwait(options)
+    const onClosed = getOnClosed()
+    await onClosed('cancel')
+    expect(mocks.replaceWorkbookWithSnapshots).not.toHaveBeenCalled()
+    expect(mocks.message.success).not.toHaveBeenCalled()
+    expect(mocks.message.error).not.toHaveBeenCalled()
+  })
+
+  it('csv：写入活动表并回调 onCsvImported', async () => {
+    const csvImported = vi.fn()
+    const options = makeOptions({ onCsvImported: csvImported })
+    const file = {
+      name: 'data.csv',
+      text: () => Promise.resolve('a,b\n1,2'),
+      arrayBuffer: () => Promise.resolve(new ArrayBuffer(0))
+    } as File
+    importFromFile(file, options)
+    await Promise.resolve()
+    await Promise.resolve()
+    expect(mocks.importCsv).toHaveBeenCalledWith('a,b\n1,2', options.activeSheet)
+    expect(csvImported).toHaveBeenCalledTimes(1)
+    expect(mocks.message.success).toHaveBeenCalledWith(
+      expect.stringContaining('已从 data.csv 导入')
+    )
+  })
+})
+
+describe('pickAndImportFile', () => {
+  it('创建隐藏 file input（同一 accept）并 click', () => {
+    const click = vi.spyOn(HTMLInputElement.prototype, 'click').mockImplementation(() => {})
+    pickAndImportFile(makeOptions())
+    const input = document.body.querySelector<HTMLInputElement>('input[type="file"]')
+    expect(input).toBeTruthy()
+    expect(input!.accept).toBe(IMPORT_FILE_ACCEPT)
+    expect(input!.hidden).toBe(true)
+    expect(click).toHaveBeenCalled()
+    click.mockRestore()
+  })
+})