@veltra/sheet 2.0.1 → 2.2.0

package/src/grid/__test__/sheet-grid-formula.test.ts

@@ -1,140 +0,0 @@
-import type { ListTable } from '@visactor/vtable'
-import { describe, expect, it } from 'vitest'
-
-import { Sheet } from '../../core/sheet'
-import { SheetGrid } from '../sheet-grid'
-
-function createContainer(): HTMLElement {
-  const el = document.createElement('div')
-  el.style.width = '800px'
-  el.style.height = '600px'
-  document.body.appendChild(el)
-  return el
-}
-
-function createGrid() {
-  const sheet = new Sheet()
-  const container = createContainer()
-  const grid = new SheetGrid({ container, sheet, rows: 20, cols: 6 })
-  return { sheet, grid, table: grid.getTable(), container }
-}
-
-/** 当前编辑器 input（容器里另有 VTable 内部 input，不能靠 querySelector 取） */
-function editorInput(table: ListTable): HTMLInputElement | undefined {
-  const manager = (
-    table as unknown as {
-      editorManager?: { editingEditor?: { getInputElement?: () => HTMLInputElement } }
-    }
-  ).editorManager
-  return manager?.editingEditor?.getInputElement?.()
-}
-
-describe('SheetGrid 公式集成（happy-dom）', () => {
-  it('公式格显示计算值（模型写入公式 → 表格显示缓存值）', () => {
-    const { sheet, grid, table } = createGrid()
-    try {
-      sheet.setCellValue({ row: 0, col: 0 }, 21)
-      sheet.setCellFormula({ row: 0, col: 1 }, '=A1*2')
-      // 模型 (0,1) → 表格 (2,1)
-      expect(table.getCellValue(2, 1)).toBe(42)
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('编辑提交 = 开头文本 → 模型存公式，表格回推计算值', () => {
-    const { sheet, grid, table } = createGrid()
-    try {
-      sheet.setCellValue({ row: 0, col: 0 }, 5)
-      // 模拟编辑提交（Playwright 无法触发双击编辑，changeCellValue 走同一提交路径）
-      table.changeCellValue(2, 1, '=A1*2', false, true)
-      expect(sheet.getCellData({ row: 0, col: 1 })).toMatchObject({ f: 'A1*2', v: 10, t: 'n' })
-      // VTable 先把输入文本写进 record；回推后必须是计算值而非公式原文
-      expect(table.getCellValue(2, 1)).toBe(10)
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('编辑提交引发的派生变更同步到表格（源格 + 全部依赖格）', () => {
-    const { sheet, grid, table } = createGrid()
-    try {
-      sheet.setCellValue({ row: 0, col: 0 }, 1)
-      sheet.setCellFormula({ row: 0, col: 1 }, '=A1*2')
-      sheet.setCellFormula({ row: 0, col: 2 }, '=B1+1')
-      expect(table.getCellValue(2, 1)).toBe(2)
-      expect(table.getCellValue(3, 1)).toBe(3)
-
-      // 编辑 A1 → B1/C1 派生重算，两格都要同步到表格
-      // （编辑提交回写的是输入文本，A1 落为字符串 '10'；公式按数字文本强转）
-      table.changeCellValue(1, 1, '10', false, true)
-      expect(sheet.getCellData({ row: 0, col: 0 })).toMatchObject({ v: '10' })
-      expect(table.getCellValue(1, 1)).toBe('10')
-      expect(table.getCellValue(2, 1)).toBe(20)
-      expect(table.getCellValue(3, 1)).toBe(21)
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('进入编辑时公式格显示原文，提交新公式后模型与显示更新', () => {
-    const { sheet, grid, table } = createGrid()
-    try {
-      sheet.setCellValue({ row: 0, col: 0 }, 21)
-      sheet.setCellFormula({ row: 0, col: 1 }, '=A1*2')
-
-      // 程序化进入编辑（等价双击）：编辑器文本 = 公式原文
-      table.startEditCell(2, 1)
-      const input = editorInput(table)
-      expect(input).toBeDefined()
-      expect(input!.value).toBe('=A1*2')
-
-      // 输入新公式并提交
-      input!.value = '=A1*3'
-      table.completeEditCell()
-      expect(sheet.getCellData({ row: 0, col: 1 })).toMatchObject({ f: 'A1*3', v: 63 })
-      expect(table.getCellValue(2, 1)).toBe(63)
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('普通格进入编辑显示当前值', () => {
-    const { sheet, grid, table } = createGrid()
-    try {
-      sheet.setCellValue({ row: 0, col: 0 }, 'plain')
-      table.startEditCell(1, 1)
-      expect(editorInput(table)!.value).toBe('plain')
-      table.completeEditCell()
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('公式错误值直接显示（#DIV/0!）', () => {
-    const { sheet, grid, table } = createGrid()
-    try {
-      sheet.setCellFormula({ row: 0, col: 0 }, '=1/0')
-      expect(table.getCellValue(1, 1)).toBe('#DIV/0!')
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('undo 公式编辑后表格恢复显示', () => {
-    const { sheet, grid, table } = createGrid()
-    try {
-      sheet.setCellValue({ row: 0, col: 0 }, 21)
-      sheet.setCellFormula({ row: 0, col: 1 }, '=A1*2')
-      expect(table.getCellValue(2, 1)).toBe(42)
-
-      sheet.undo()
-      expect(table.getCellValue(2, 1)).toBeUndefined()
-
-      sheet.redo()
-      expect(table.getCellValue(2, 1)).toBe(42)
-    } finally {
-      grid.release()
-    }
-  })
-})

package/src/grid/__test__/sheet-grid.test.ts

@@ -1,275 +0,0 @@
-import { ListTable } from '@visactor/vtable'
-import { describe, expect, it } from 'vitest'
-
-import { Sheet } from '../../core/sheet'
-import { SheetGrid } from '../sheet-grid'
-
-function createContainer(): HTMLElement {
-  const el = document.createElement('div')
-  el.style.width = '800px'
-  el.style.height = '600px'
-  document.body.appendChild(el)
-  return el
-}
-
-function createGrid() {
-  const sheet = new Sheet()
-  const grid = new SheetGrid({ container: createContainer(), sheet, rows: 20, cols: 6 })
-  return { sheet, grid, table: grid.getTable() }
-}
-
-describe('SheetGrid（happy-dom smoke）', () => {
-  it('能挂载：列头 A..F + 行号列，坐标带偏移', () => {
-    const { grid, table } = createGrid()
-    try {
-      // (0,*) 为行号列，(*,0) 为列头；模型 (0,0) → 表格 (1,1)
-      expect(table.isSeriesNumber(0, 1)).toBe(true)
-      expect(table.isHeader(1, 0)).toBe(true)
-      expect(table.getCellValue(1, 0)).toBe('A')
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('主题与交互选项：fillHandle / rowResize / clip / 编辑态方向键不换格', () => {
-    const { grid, table } = createGrid()
-    try {
-      const options = table.options
-      expect(options.excelOptions?.fillHandle).toBe(true)
-      expect(options.resize?.columnResizeMode).toBe('header')
-      expect(options.resize?.rowResizeMode).toBe('all')
-      // 列宽：仅列头；行高：仅行号列（body 格不可拖，避免干扰选区/编辑）
-      expect(table._canResizeColumn(1, 0)).toBe(true) // 列头 A
-      expect(table._canResizeColumn(1, 1)).toBe(false) // body
-      expect(table.isSeriesNumber(0, 1)).toBe(true)
-      expect(table._canResizeRow(0, 1)).toBe(true) // 行号列
-      expect(table._canResizeRow(1, 1)).toBe(false) // body
-      expect(options.keyboardOptions?.moveEditCellOnArrowKeys).toBe(false)
-      expect(options.defaultRowHeight).toBe(28)
-      expect(options.eventOptions?.preventDefaultContextMenu).toBe(true)
-      // theme 为 TableTheme 实例（DEFAULT.extends），读运行时解析值
-      const theme = table.theme
-      expect(theme.bodyStyle?.bgColor).toBe('#FFF')
-      expect(theme.bodyStyle?.textOverflow).toBe('clip')
-      expect(theme.defaultStyle?.textOverflow).toBe('clip')
-      expect(theme.defaultStyle?.borderColor).toBe('#E1E4E8')
-      // VTable DEFAULT 为 [10,16,10,16]；收紧后贴近 Excel
-      expect(theme.defaultStyle?.padding).toEqual([2, 6, 2, 6])
-      expect(theme.bodyStyle?.padding).toEqual([2, 6, 2, 6])
-      expect(theme.frameStyle?.borderColor).toBe('#E1E4E8')
-      expect(theme.selectionStyle?.cellBorderColor).toBe('#2170E7')
-      expect(theme.selectionStyle?.cellBorderColor).not.toBe('#000')
-      expect(options.rowSeriesNumber).toMatchObject({
-        width: 46,
-        style: { bgColor: '#F5F5F5', padding: [2, 6, 2, 6], textOverflow: 'clip' }
-      })
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('右键 CONTEXTMENU_CELL → onContextMenu（client 坐标 + 模型地址）', async () => {
-    const sheet = new Sheet()
-    const container = createContainer()
-    const calls: Array<{ x: number; y: number; addr: { row: number; col: number } | null }> = []
-    const grid = new SheetGrid({
-      container,
-      sheet,
-      rows: 20,
-      cols: 6,
-      onContextMenu: (info) => calls.push(info)
-    })
-    try {
-      const table = grid.getTable()
-      // 表格坐标 (2,3) → 模型 B3（colOffset/rowOffset 各 1）
-      table.fireListeners(ListTable.EVENT_TYPE.CONTEXTMENU_CELL, {
-        col: 2,
-        row: 3,
-        event: { clientX: 120, clientY: 80, preventDefault() {} }
-      })
-      await Promise.resolve() // queueMicrotask
-      expect(calls).toHaveLength(1)
-      expect(calls[0]).toMatchObject({ x: 120, y: 80, addr: { row: 2, col: 1 } })
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('行高：RESIZE_ROW_END 写入 Sheet，重建后还原', () => {
-    const container = createContainer()
-    const sheet = new Sheet()
-    let grid = new SheetGrid({ container, sheet, rows: 20, cols: 6 })
-    try {
-      grid.getTable().fireListeners(ListTable.EVENT_TYPE.RESIZE_ROW_END, { row: 2, rowHeight: 48 })
-      expect(sheet.getRowHeight(1)).toBe(48)
-
-      grid.release()
-      grid = new SheetGrid({ container, sheet, rows: 20, cols: 6 })
-      expect(grid.getTable().getRowHeight(2)).toBe(48)
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('填充柄：DRAG_FILL_HANDLE_END 数字序列写入模型', () => {
-    const { sheet, grid, table } = createGrid()
-    try {
-      sheet.setCellValue({ row: 0, col: 0 }, 1)
-      sheet.selectRange({ start: { row: 0, col: 0 }, end: { row: 0, col: 0 } })
-      // 模拟源选区（表格坐标含偏移）
-      table.getSelectedCellRanges = () => [{ start: { col: 1, row: 1 }, end: { col: 1, row: 1 } }]
-      table.fireListeners(ListTable.EVENT_TYPE.MOUSEDOWN_FILL_HANDLE, {})
-      // 拖到底部扩展至 A1:A3
-      table.getSelectedCellRanges = () => [{ start: { col: 1, row: 1 }, end: { col: 1, row: 3 } }]
-      table.fireListeners(ListTable.EVENT_TYPE.DRAG_FILL_HANDLE_END, { direction: 'bottom' })
-      expect(sheet.getCellData({ row: 1, col: 0 })?.v).toBe(2)
-      expect(sheet.getCellData({ row: 2, col: 0 })?.v).toBe(3)
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('模型 → 表格：setCellValue 后表格可见', () => {
-    const { sheet, grid, table } = createGrid()
-    try {
-      sheet.setCellValue({ row: 0, col: 0 }, 'hello')
-      expect(table.getCellValue(1, 1)).toBe('hello')
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('表格 → 模型：change_cell_value 回写 store', () => {
-    const { sheet, grid, table } = createGrid()
-    try {
-      table.changeCellValue(2, 3, 'world', false, true)
-      expect(sheet.getCellData({ row: 2, col: 1 })).toEqual({ v: 'world', t: 's' })
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('合并映射：customMergeCell 反映 MergeManager 的包围盒', () => {
-    const { sheet, grid, table } = createGrid()
-    try {
-      sheet.mergeCells({ start: { row: 1, col: 1 }, end: { row: 2, col: 2 } })
-      // 模型 B2:C3 → 表格坐标 (2..3, 2..3)
-      const merge = table.getCustomMerge(3, 3)
-      expect(merge?.range).toMatchObject({ start: { col: 2, row: 2 }, end: { col: 3, row: 3 } })
-      expect(table.getCustomMerge(1, 1)).toBeUndefined()
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('合并区域是单一可操作单位：被覆盖格的 getCellRange 扩展为整个合并', () => {
-    const { sheet, grid, table } = createGrid()
-    try {
-      sheet.setCellValue({ row: 1, col: 1 }, 'anchor-value')
-      sheet.mergeCells({ start: { row: 1, col: 1 }, end: { row: 2, col: 2 } })
-
-      // 点击被覆盖格（表格坐标 3,3）→ 选区/编辑范围 = 整个合并区域
-      const range = table.getCellRange(3, 3)
-      expect(range).toMatchObject({
-        start: { col: 2, row: 2 },
-        end: { col: 3, row: 3 },
-        isCustom: true
-      })
-
-      // 合并格文本 = 锚点显示值（否则渲染为空）
-      expect(table.getCustomMerge(3, 3)?.text).toBe('anchor-value')
-      expect(table.getCustomMerge(2, 2)?.text).toBe('anchor-value')
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('编辑提交后合并格文本立即刷新（text 读 records，与 VTable 更新次序一致）', () => {
-    const { sheet, grid, table } = createGrid()
-    try {
-      sheet.setCellValue({ row: 1, col: 1 }, 'old')
-      sheet.mergeCells({ start: { row: 1, col: 1 }, end: { row: 2, col: 2 } })
-
-      // 模拟编辑提交：doExit 的 isCustom 分支 → changeCellValue(锚点, 新值)
-      const range = table.getCellRange(3, 3)
-      table.changeCellValue(range.start.col, range.start.row, 'new')
-
-      // 模型已回写；且重绘发生在 change_cell_value 之前，text 必须已是新值
-      expect(sheet.getCellData({ row: 1, col: 1 })).toMatchObject({ v: 'new' })
-      expect(table.getCustomMerge(3, 3)?.text).toBe('new')
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('编辑回写走命令系统：change_cell_value 后可 undo/redo', () => {
-    const { sheet, grid, table } = createGrid()
-    try {
-      table.changeCellValue(1, 1, 'edited', false, true)
-      expect(sheet.getCellData({ row: 0, col: 0 })).toEqual({ v: 'edited', t: 's' })
-
-      expect(sheet.undo()).toBe(true)
-      expect(sheet.getCellData({ row: 0, col: 0 })).toBeUndefined()
-
-      expect(sheet.redo()).toBe(true)
-      expect(sheet.getCellData({ row: 0, col: 0 })).toEqual({ v: 'edited', t: 's' })
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('拖选结束 → 模型选区同步为区域（合并工具的前提）', () => {
-    const { sheet, grid, table } = createGrid()
-    try {
-      // 模拟 VTable 拖选结果（表格坐标含偏移：行号列 1 + 列头行 1）
-      table.getSelectedCellRanges = () => [{ start: { col: 1, row: 1 }, end: { col: 3, row: 2 } }]
-      table.fireListeners(ListTable.EVENT_TYPE.DRAG_SELECT_END, {})
-      expect(sheet.getSelection().ranges[0]).toEqual({
-        start: { row: 0, col: 0 },
-        end: { row: 1, col: 2 }
-      })
-      expect(sheet.getSelection().activeCell).toEqual({ row: 0, col: 0 })
-    } finally {
-      grid.release()
-    }
-  })
-
-  it('键盘绑定：Ctrl+Z undo、Ctrl+Shift+Z / Ctrl+Y redo；编辑器 input 不拦截', () => {
-    const container = createContainer()
-    const sheet = new Sheet()
-    const grid = new SheetGrid({ container, sheet, rows: 20, cols: 6 })
-    try {
-      sheet.setCellValue({ row: 0, col: 0 }, 'x')
-
-      // Ctrl+Z → undo
-      container.dispatchEvent(
-        new KeyboardEvent('keydown', { key: 'z', ctrlKey: true, bubbles: true })
-      )
-      expect(sheet.getCellData({ row: 0, col: 0 })).toBeUndefined()
-
-      // Ctrl+Shift+Z → redo
-      container.dispatchEvent(
-        new KeyboardEvent('keydown', { key: 'z', ctrlKey: true, shiftKey: true, bubbles: true })
-      )
-      expect(sheet.getCellData({ row: 0, col: 0 })).toMatchObject({ v: 'x' })
-
-      // Ctrl+Z → undo；Ctrl+Y → redo
-      container.dispatchEvent(
-        new KeyboardEvent('keydown', { key: 'z', ctrlKey: true, bubbles: true })
-      )
-      container.dispatchEvent(
-        new KeyboardEvent('keydown', { key: 'y', ctrlKey: true, bubbles: true })
-      )
-      expect(sheet.getCellData({ row: 0, col: 0 })).toMatchObject({ v: 'x' })
-
-      // 事件来自编辑器 input（编辑中）→ 不拦截
-      const input = document.createElement('input')
-      container.appendChild(input)
-      sheet.setCellValue({ row: 0, col: 1 }, 'y')
-      input.dispatchEvent(new KeyboardEvent('keydown', { key: 'z', ctrlKey: true, bubbles: true }))
-      expect(sheet.getCellData({ row: 0, col: 1 })).toMatchObject({ v: 'y' })
-    } finally {
-      grid.release()
-    }
-  })
-})