@veltra/sheet 2.0.0 → 2.1.1

package/src/tools/export.worker.ts

@@ -0,0 +1,61 @@
+/// <reference lib="webworker" />
+/**
+ * XLSX 导出 Worker：exportWorkbookXlsx（模型 → hucre 序列化 + ZIP 压缩，
+ * 大工作簿为秒级同步重活）移到独立线程，主线程保持空闲。
+ *
+ * 协议：主线程 postMessage({ sheets: [{ name, snapshot }], activeIndex }）
+ * （快照为纯数据，可结构化克隆，行高随 SheetSnapshot.rowHeights 携带）→
+ * worker 返回 { ok: true, buffer }（精确拷贝后 transfer 回主线程）；
+ * 失败返回 { ok: false, error }。
+ *
+ * 与 import.worker.ts 同一约束：必须用**运行时动态 import**——worker 顶层
+ * 静态 import 在 vite dev 的 worker 上下文中会因模块图加载顺序导致
+ * `Workbook is not defined`（实测）。
+ */
+import type { SheetSnapshot } from '@veltra/sheet-core/core/sheet'
+
+export interface ExportWorkerPayload {
+  sheets: { name: string; snapshot: SheetSnapshot }[]
+  activeIndex: number
+}
+
+export interface ExportWorkerResponse {
+  ok: boolean
+  buffer?: Uint8Array
+  error?: string
+}
+
+self.onmessage = (e: MessageEvent<ExportWorkerPayload>): void => {
+  void Promise.all([
+    import('@veltra/sheet-core/core/io/export'),
+    import('@veltra/sheet-core/core/workbook')
+  ])
+    .then(([{ exportWorkbookXlsx }, { Workbook }]) => {
+      const wb = new Workbook()
+      const sheets = e.data.sheets
+      for (let i = 0; i < sheets.length; i++) {
+        const { name, snapshot } = sheets[i]!
+        // 首个 sheet 复用 Workbook 自带的默认表：先改名对齐（空名/重名保持原名，
+        // 导出侧 hucre 1.0 会校验表名合法性）
+        const sheet = i === 0 ? wb.activeSheet : wb.addSheet(name)
+        if (i === 0 && sheet.name !== name) wb.renameSheet(sheet.name, name)
+        sheet.restore(snapshot)
+      }
+      wb.activateSheet(wb.getSheets()[Math.min(e.data.activeIndex, wb.sheetCount - 1)]!.name)
+      return exportWorkbookXlsx(wb)
+    })
+    .then((buffer) => {
+      // transfer 精确视图（writeXlsx 返回的 Uint8Array 理论上独占底层 buffer，
+      // slice 一份拷贝兜底偏移情形，避免 transfer 整个底层 buffer 带出冗余字节）
+      const exact = buffer.slice()
+      const response: ExportWorkerResponse = { ok: true, buffer: exact }
+      ;(self as unknown as Worker).postMessage(response, [exact.buffer])
+    })
+    .catch((err: unknown) => {
+      const response: ExportWorkerResponse = {
+        ok: false,
+        error: err instanceof Error ? err.message : String(err)
+      }
+      ;(self as unknown as Worker).postMessage(response)
+    })
+}

package/src/tools/registry.ts

@@ -1,4 +1,5 @@
-import { TypedEventEmitter } from '../core/events'
+import { TypedEventEmitter } from '@veltra/sheet-core/core/events'
+
 import type { SheetContext } from './context'
 
 /**
@@ -12,6 +13,16 @@ import type { SheetContext } from './context'
  *   （与 defaultCommandRegistry 同语义；每个实例的 SheetContext 各自绑定当前 sheet）
  */
 
+/** 弹层型工具类型：vue 层按类型渲染弹层面板（面板交互走 SheetContext 命令入口） */
+export type SheetToolPopupType =
+  | 'fill-color'
+  | 'border'
+  | 'font-color'
+  | 'font-size'
+  | 'find'
+  | 'insert-image'
+  | 'export'
+
 /** 工具定义 */
 export interface SheetTool {
   /** 唯一 id；同 id 重复注册视为替换（保留原位置） */
@@ -30,6 +41,10 @@ export interface SheetTool {
   visible?(ctx: SheetContext): boolean
   /** 是否禁用（工具栏状态刷新时求值）；缺省可用 */
   disabled?(ctx: SheetContext): boolean
+  /** 是否处于激活/高亮状态（工具栏状态刷新时求值，vue 层渲染 is-active）；缺省 false */
+  active?(ctx: SheetContext): boolean
+  /** 弹层型工具：vue 层渲染弹层面板，onClick 不执行（面板交互走 SheetContext） */
+  popup?: SheetToolPopupType
   /** 点击执行；ctx 是唯一操作入口（写操作全走命令系统，天然可撤销） */
   onClick(ctx: SheetContext): void
 }

package/src/types/index.ts

@@ -1 +1,7 @@
 export * from './sheet'
+export type {
+  SheetImageType,
+  SheetImageAnchor,
+  SheetImage,
+  ImageInput
+} from '@veltra/sheet-core/core/image'

package/src/types/sheet.ts

@@ -1,9 +1,9 @@
+import type { Sheet } from '@veltra/sheet-core/core/sheet'
+import type { Workbook } from '@veltra/sheet-core/core/workbook'
+import type { SheetGrid } from '@veltra/sheet-core/grid/sheet-grid'
 import type { DeconstructValue } from '@veltra/utils'
 import type { ComputedRef } from 'vue'
 
-import type { Sheet } from '../core/sheet'
-import type { Workbook } from '../core/workbook'
-import type { SheetGrid } from '../grid/sheet-grid'
 import type { SheetContext } from '../tools/context'
 
 /** 电子表格组件属性 */
@@ -16,6 +16,8 @@ export interface SheetProps {
   cols?: number
   /** 是否显示工具栏，默认 true */
   showToolbar?: boolean
+  /** 是否显示顶部公式栏（名称框 + fx 输入栏），默认 true */
+  showFormulaBar?: boolean
   /** 是否显示底部 sheet 标签栏，默认 true */
   showTabs?: boolean
 }

package/src/vue/__test__/formula-bar.test.ts

@@ -0,0 +1,455 @@
+import { Workbook } from '@veltra/sheet-core/core/workbook'
+import { ListTable } from '@visactor/vtable'
+import { afterEach, describe, expect, it } from 'vitest'
+import { createApp, h, nextTick, type App } from 'vue'
+
+import { USheet } from '../../index'
+import type { SheetExposed } from '../../types'
+
+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 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(')
+
+    // 与 grid 选区测试同路径：selectCells 设视觉选区 + fire SELECTED_CELL
+    const table = exposed.value!.getGrid()!.getTable()
+    table.selectCells([{ start: { col: 1, row: 1 }, end: { col: 2, row: 2 } }])
+    table.fireListeners(ListTable.EVENT_TYPE.SELECTED_CELL, { col: 2, row: 2 })
+    await nextTick()
+    expect(input.value).toBe('=SUM(A1:B2')
+    expect(input.selectionStart).toBe('=SUM(A1:B2'.length)
+    // intercept 不写模型选区
+    expect(sheet.getSelection().activeCell).toEqual({ row: 2, col: 0 })
+
+    // 非引用选择场景失焦提交
+    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 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()
+
+    setFxText(el, '=A1+')
+    await nextTick()
+    const table = exposed.value!.getGrid()!.getTable()
+    table.selectCells([{ start: { col: 2, row: 1 }, end: { col: 2, row: 1 } }])
+    table.fireListeners(ListTable.EVENT_TYPE.SELECTED_CELL, { col: 2, row: 1 })
+    await nextTick()
+    expect(fxInput(el).value).toBe('=A1+B1')
+  })
+})