@veltra/sheet 2.5.7 → 2.6.0

package/src/components/sheet/__test__/sheet-component.test.ts

@@ -1,10 +1,14 @@
-import { Workbook } from '@veltra/sheet-core/core/workbook'
-import { afterEach, describe, expect, it, vi } from 'vitest'
-import { createApp, h, nextTick, ref, type App } from 'vue'
+import { createRange } from '@veltra/sheet-core/core/address.js'
+import { Workbook } from '@veltra/sheet-core/core/workbook.js'
+import { afterEach, describe, expect, it, vi } from 'vite-plus/test'
+import { createApp, h, nextTick, ref, type App, type Component } from 'vue'
 
+// 引擎指针事件模拟与画布几何（cellX/cellY）：setup 已跨包引用同目录 setup.ts
+import { cellX, cellY, fire } from '../../../../../sheet-core/src/grid/__test__/grid-test-utils'
 import { USheet } from '../../../index'
 import { registerTool, unregisterTool } from '../../../tools/registry'
 import type { SheetExposed } from '../../../types'
+import { buildColHeaderMenus, buildRowHeaderMenus } from '../sheet-context-menu'
 
 const apps: App[] = []
 const containers: HTMLElement[] = []
@@ -152,7 +156,7 @@ describe('USheet 组件', () => {
     expect(tabs(el).map((tab) => tab.textContent?.trim())).toEqual(['Sheet1', 'Sheet2'])
     expect(tabs(el)[0]!.classList.contains('is-active')).toBe(true)
 
-    // VTable 已挂载到 grid 容器
+    // 引擎表格已挂载到 grid 容器
     expect(el.querySelector('.u-sheet__grid canvas')).not.toBeNull()
 
     // 单行滚动结构：工具按钮全部位于滚动视口内的 list 容器
@@ -212,8 +216,9 @@ describe('USheet 组件', () => {
     await nextTick()
 
     expect(tabs(el)[1]!.classList.contains('is-active')).toBe(true)
-    // grid 实例缓存：切换后旧实例保留（LRU，visibility:hidden），容器内有 2 个 canvas
-    expect(el.querySelectorAll('.u-sheet__grid canvas')).toHaveLength(2)
+    // grid 实例缓存：切换后旧实例保留（LRU，visibility:hidden），容器内有 2 个实例
+    // （引擎画布为 [data-layer-kind] 分层栈，实例数以实例容器为准）
+    expect(el.querySelectorAll('.u-sheet__grid-instance')).toHaveLength(2)
     // 激活实例可见、旧实例隐藏
     const instances = el.querySelectorAll<HTMLElement>('.u-sheet__grid-instance')
     expect(instances[0]!.style.visibility).toBe('hidden')
@@ -222,10 +227,10 @@ describe('USheet 组件', () => {
     // 工具上下文（与工具按钮同一门面）指向切换后的 sheet
     expect(exposed.value?.getContext().sheetName).toBe('Sheet2')
 
-    // grid 已重建到 Sheet2：写入 Sheet2 应在表格可见
+    // grid 已重建到 Sheet2：写入 Sheet2 应在表格可见（引擎数据坐标 (0,0) = 模型 A1）
     workbook.getSheet('Sheet2')!.setCellValue({ row: 0, col: 0 }, 's2')
     await nextTick()
-    expect(exposed.value?.getGrid()?.getTable().getCellValue(1, 1)).toBe('s2')
+    expect(exposed.value?.getGrid()?.getTable().getCellText(0, 0)).toBe('s2')
   })
 
   it('props 变更响应：showToolbar/showTabs 显隐，rows 变化重建 grid', async () => {
@@ -271,11 +276,13 @@ describe('USheet 组件', () => {
     workbook.activeSheet.setCellValue({ row: 0, col: 0 }, 'A1')
     await nextTick()
     const table = exposed.value!.getGrid()!.getTable()
-    expect(table.options.showHeader).toBe(false)
-    expect(table.options.rowSeriesNumber).toBeUndefined()
-    expect(table.columnHeaderLevelCount).toBe(0)
-    expect(table.rowCount).toBe(8)
-    expect(table.getCellValue(0, 0)).toBe('A1')
+    expect(table.options.showRowHeader).toBe(false)
+    expect(table.options.showColHeader).toBe(false)
+    // 行号列与列头折叠：内容原点回落 (0,0)
+    expect(table.getDrawRange().x).toBe(0)
+    expect(table.getDrawRange().y).toBe(0)
+    expect(table.getBodyVisibleCellRange().rows.end).toBe(8)
+    expect(table.getCellText(0, 0)).toBe('A1')
   })
 
   it('删除行后渲染行数跟随模型收缩（不被 props.rows 撑回）', async () => {
@@ -286,14 +293,15 @@ describe('USheet 组件', () => {
 
     const sheet = exposed.value!.getActiveSheet()
     expect(sheet.rows).toBe(10)
-    expect(exposed.value!.getGrid()!.getTable().rowCount).toBe(11) // 列头 + 10
+    // 渲染行数 = 引擎数据行数（无列头 +1；窗口终点被引擎夹取到模型行数）
+    expect(exposed.value!.getGrid()!.getTable().getBodyVisibleCellRange().rows.end).toBe(10)
 
     sheet.deleteRows(0, 2)
     await nextTick()
     await nextTick()
 
     expect(sheet.rows).toBe(8)
-    expect(exposed.value!.getGrid()!.getTable().rowCount).toBe(9) // 列头 + 8
+    expect(exposed.value!.getGrid()!.getTable().getBodyVisibleCellRange().rows.end).toBe(8)
   })
 
   it('resolveCellStyle prop 传入 SheetGrid 视口渲染', async () => {
@@ -325,11 +333,8 @@ describe('USheet 组件', () => {
 
     const table = exposed.value?.getGrid()?.getTable()
     expect(table).toBeDefined()
-    const column = table!.getBodyColumnDefine(2, 2) as {
-      style?: (arg: { row: number; col: number; table: unknown }) => Record<string, unknown>
-    }
-    const rendered = column.style!({ row: 2, col: 2, table })
-    expect(rendered.bgColor).toBe('#FFE0E0')
+    // 引擎公开样式投影：格 (1,1) 命中 resolveCellStyle 补丁（fill → background 覆盖）
+    expect(table!.resolveStyle(1, 1).background).toBe('#FFE0E0')
     expect(sheet.getCellStyle(addr)?.fill?.color).toBe('#CCCCCC')
   })
 
@@ -596,7 +601,7 @@ describe('USheet 组件', () => {
     expect(sheet.getCellStyle({ row: 0, col: 0 })).toBeUndefined()
   })
 
-  it('冻结：模型 setFrozen 驱动 VTable 冻结布局联动（工具栏入口已迁至右键菜单）', async () => {
+  it('冻结：模型 setFrozen 驱动引擎冻结布局联动（工具栏入口已迁至右键菜单）', async () => {
     const workbook = createWorkbook()
     const sheet = workbook.activeSheet
     const exposed: { value: SheetExposed | undefined } = { value: undefined }
@@ -606,17 +611,18 @@ describe('USheet 组件', () => {
     sheet.setFrozen(1, 0)
     await nextTick()
     expect(sheet.frozen).toEqual({ rows: 1, cols: 0 })
-    // 模型 1 行 → frozenRowCount = 2：列头行 + 首行；列保持 1：行号列
-    expect(exposed.value?.getGrid()?.getTable().frozenRowCount).toBe(2)
-    expect(exposed.value?.getGrid()?.getTable().frozenColCount).toBe(1)
+    // 模型冻结数即引擎数据冻结数（行列头不计数，无 ±1）
+    expect(exposed.value?.getGrid()?.getTable().getFrozenRowCount()).toBe(1)
+    expect(exposed.value?.getGrid()?.getTable().getFrozenColCount()).toBe(0)
 
     sheet.setFrozen(1, 1)
     await nextTick()
-    expect(exposed.value?.getGrid()?.getTable().frozenColCount).toBe(2)
+    expect(exposed.value?.getGrid()?.getTable().getFrozenColCount()).toBe(1)
 
     sheet.setFrozen(0, 0)
     await nextTick()
     expect(sheet.frozen).toEqual({ rows: 0, cols: 0 })
+    expect(exposed.value?.getGrid()?.getTable().getFrozenRowCount()).toBe(0)
   })
 
   it('导入：点击直接拉起系统文件选择，不打开弹层、不产生历史条目', async () => {
@@ -1029,3 +1035,284 @@ describe('tabs 栏', () => {
     expect(scrollLeft).toBeGreaterThan(0)
   })
 })
+
+describe('USheet 行高/列宽右键菜单', () => {
+  /**
+   * 触发行号/列头右键：直接调引擎 contextMenuListeners（happy-dom 无法驱动
+   * 引擎画布的 DOM contextmenu 命中），走 SheetGrid → handleContextMenu →
+   * contextmenu.pop 的真实链路。坐标取行号带内 / 列头带内（行高 28 / 行号列宽 46）。
+   */
+  function popHeaderContextMenu(
+    exposed: { value: SheetExposed | undefined },
+    kind: 'row-header' | 'col-header'
+  ): void {
+    const table = exposed.value!.getGrid()!.getTable()
+    const event = {
+      cell: null,
+      region: kind,
+      x: kind === 'row-header' ? 20 : 100,
+      y: kind === 'row-header' ? 40 : 10,
+      originalEvent: new MouseEvent('contextmenu')
+    }
+    for (const listener of table.contextMenuListeners) {
+      listener(event as Parameters<typeof listener>[0])
+    }
+  }
+
+  /**
+   * 最新弹出菜单中含指定文案的菜单项。
+   * happy-dom 无 transition：close 的 leave 不结束，旧弹层不卸载而在 body 累积，
+   * 断言只认 body 中最后一份（每次 pop 追加新根节点）。
+   */
+  function menuItem(text: string): HTMLLIElement | undefined {
+    const roots = document.body.querySelectorAll<HTMLElement>('.u-contextmenu')
+    const latest = roots[roots.length - 1]
+    return latest
+      ? [...latest.querySelectorAll<HTMLLIElement>('.u-contextmenu__item')].find((item) =>
+          item.textContent?.includes(text)
+        )
+      : undefined
+  }
+
+  /** 数值输入项内输入并确认（UInput @input 同步 model，InsertCountMenuItem 点击本体提交） */
+  async function confirmMenuNumber(root: HTMLElement, value: number): Promise<void> {
+    const input = root.querySelector<HTMLInputElement>('input')!
+    input.value = String(value)
+    input.dispatchEvent(new Event('input', { bubbles: true }))
+    await nextTick()
+    root.querySelector<HTMLElement>('.u-sheet__insert-count-menu')!.click()
+    await nextTick()
+  }
+
+  /**
+   * 独立挂载菜单项 render 组件（menuNumberRender → InsertCountMenuItem，与弹出菜单
+   * 同一组合）。弹层 confirm 的 leave 在 happy-dom 不结束，迟到的 destroy 会卸载
+   * 之后 pop 的新菜单，写入路径统一走独立挂载保证确定性。
+   */
+  function mountMenuRender(render: Component): HTMLElement {
+    const host = document.createElement('div')
+    document.body.appendChild(host)
+    containers.push(host)
+    const app = createApp({ render: () => h(render) })
+    apps.push(app)
+    app.mount(host)
+    return host
+  }
+
+  it('行号/列头菜单出现「行高」「列宽」数值项：输入确认写回选区覆盖行/列，重建 grid 后保留', async () => {
+    const workbook = createWorkbook()
+    const exposed: { value: SheetExposed | undefined } = { value: undefined }
+    const state = ref({ rows: 10, cols: 6 })
+    mount(() => ({ workbook, rows: state.value.rows, cols: state.value.cols }), exposed)
+    await nextTick()
+    const ctx = exposed.value!.getContext()
+
+    // 预选 R1C1:R2C2（右键落点在选区内 → 选区保留，不依赖 happy-dom 画布命中）
+    ctx.selectRange(createRange({ row: 0, col: 0 }, { row: 1, col: 1 }))
+
+    // 行号右键（真实链路）：菜单出现「行高」内嵌数值输入
+    popHeaderContextMenu(exposed, 'row-header')
+    await nextTick()
+    const rowItem = menuItem('行高')!
+    expect(rowItem.classList.contains('is-disabled')).toBe(false)
+    expect(rowItem.querySelector('.u-contextmenu__custom')).toBeTruthy()
+    expect(rowItem.querySelector('input')).toBeTruthy()
+
+    // 输入 40 确认（与弹层同一 render 组合）：应用到选区覆盖行 0..1
+    await confirmMenuNumber(
+      mountMenuRender(buildRowHeaderMenus(ctx).find((m) => m.label === '行高')!.render!),
+      40
+    )
+    expect(workbook.activeSheet.getRowHeight(0)).toBe(40)
+    expect(workbook.activeSheet.getRowHeight(1)).toBe(40)
+    expect(workbook.activeSheet.getRowHeight(2)).toBeUndefined()
+    // 确认后活动引擎即时生效（门面写模型 → 活动 grid 引擎 table 同步，无需重建）
+    const activeTable = exposed.value!.getGrid()!.getTable()
+    expect(activeTable.getRowHeight(0)).toBe(40)
+    expect(activeTable.getRowHeight(1)).toBe(40)
+    expect(activeTable.getRowHeight(2)).toBe(28)
+    // 尺寸写入不进 undo（同 rowHeights/冻结先例）
+    expect(ctx.canUndo).toBe(false)
+
+    // 列头右键（真实链路）：菜单出现「列宽」内嵌数值输入。
+    // 预选 cols 0..2 横跨画布命中可能落点——右键列头无论命中 0/1 或 undefined
+    // 都保持选区（happy-dom 画布命中几何不定，不能依赖落点改选）
+    ctx.selectRange(createRange({ row: 0, col: 0 }, { row: 1, col: 2 }))
+    popHeaderContextMenu(exposed, 'col-header')
+    await nextTick()
+    const colItem = menuItem('列宽')!
+    expect(colItem.querySelector('.u-contextmenu__custom')).toBeTruthy()
+    // 输入 120 确认：应用到选区覆盖列 0..2，活动引擎即时生效
+    await confirmMenuNumber(
+      mountMenuRender(buildColHeaderMenus(ctx).find((m) => m.label === '列宽')!.render!),
+      120
+    )
+    expect(workbook.activeSheet.getColWidth(0)).toBe(120)
+    expect(workbook.activeSheet.getColWidth(1)).toBe(120)
+    expect(workbook.activeSheet.getColWidth(2)).toBe(120)
+    expect(workbook.activeSheet.getColWidth(3)).toBeUndefined()
+    expect(activeTable.getColWidth(0)).toBe(120)
+    expect(activeTable.getColWidth(2)).toBe(120)
+    expect(activeTable.getColWidth(3)).toBe(80)
+
+    // 重建 grid（props 变化触发）后从模型还原行列尺寸
+    const gridBefore = exposed.value!.getGrid()
+    state.value = { rows: 12, cols: 6 }
+    await nextTick()
+    expect(exposed.value!.getGrid()).not.toBe(gridBefore)
+    const table = exposed.value!.getGrid()!.getTable()
+    expect(table.getRowHeight(0)).toBe(40)
+    expect(table.getColWidth(1)).toBe(120)
+  })
+
+  it('readonly：「行高」「列宽」菜单项禁用（降级为禁用文本项，无内嵌输入）', async () => {
+    const workbook = createWorkbook()
+    const exposed: { value: SheetExposed | undefined } = { value: undefined }
+    mount(() => ({ workbook, rows: 10, cols: 6, readonly: true }), exposed)
+    await nextTick()
+
+    popHeaderContextMenu(exposed, 'row-header')
+    await nextTick()
+    const rowItem = menuItem('行高')!
+    expect(rowItem.classList.contains('is-disabled')).toBe(true)
+    expect(rowItem.querySelector('.u-contextmenu__custom')).toBeNull()
+    expect(rowItem.querySelector('input')).toBeNull()
+
+    popHeaderContextMenu(exposed, 'col-header')
+    await nextTick()
+    const colItem = menuItem('列宽')!
+    expect(colItem.classList.contains('is-disabled')).toBe(true)
+    expect(colItem.querySelector('input')).toBeNull()
+  })
+})
+
+describe('fx 选区锚点', () => {
+  const A1_ANCHOR = { minCol: 0, minRow: 0, maxCol: 0, maxRow: 0 }
+
+  function mountSheet(exposed: { value: SheetExposed | undefined }): HTMLElement {
+    const workbook = createWorkbook()
+    const { el } = mount(() => ({ workbook, rows: 10, cols: 6 }), exposed)
+    return el
+  }
+
+  function fxInputOf(el: HTMLElement): HTMLTextAreaElement {
+    return el.querySelector<HTMLTextAreaElement>('.u-sheet__fx-input')!
+  }
+
+  it('fx 焦点/插入函数置锚点：画布引用拾取期选区流动，锚点保持', async () => {
+    const exposed: { value: SheetExposed | undefined } = { value: undefined }
+    const el = mountSheet(exposed)
+    await nextTick()
+
+    const table = exposed.value!.getGrid()!.getTable()
+    const fxInput = fxInputOf(el)
+    expect(table.selectionAnchor).toBeNull()
+
+    // fx 焦点进入编辑会话：被编辑格 A1 置锚点
+    fxInput.dispatchEvent(new Event('focus'))
+    await nextTick()
+    expect(table.selectionAnchor).toEqual(A1_ANCHOR)
+
+    // 输入 =SUM( 进入引用拾取上下文，画布拖选 B2:D4：拾取段选区流动、
+    // 抬手引用文本插入公式，锚点仍钉在被编辑格
+    fxInput.value = '=SUM('
+    fxInput.setSelectionRange(5, 5)
+    fxInput.dispatchEvent(new Event('input', { bubbles: true }))
+    const instance = el.querySelector<HTMLElement>('.u-sheet__grid-instance')!
+    fire(instance, 'pointerdown', { clientX: cellX(1), clientY: cellY(1) })
+    fire(instance, 'pointermove', { clientX: cellX(3), clientY: cellY(3) })
+    fire(instance, 'pointerup', { clientX: cellX(3), clientY: cellY(3) })
+    await nextTick()
+    expect(fxInput.value).toBe('=SUM(B2:D4')
+    // 拦截命中：拾取段选区流动被消费为引用（C3 已插入），不落模型选区，
+    // 画布回推模型选区；锚点仍钉在被编辑格 A1
+    expect(exposed.value!.getActiveSheet().getSelection().activeCell).toEqual({ row: 0, col: 0 })
+    expect(table.selectionAnchor).toEqual(A1_ANCHOR)
+
+    // fx 按钮选函数（insertFunction 重置会话内容）：锚点保持在目标格
+    el.querySelector<HTMLButtonElement>('.u-sheet__fx-label')!.click()
+    await flushPopup()
+    const item = document.querySelector<HTMLElement>('.u-sheet__functions-item')
+    expect(item).not.toBeNull()
+    item!.click()
+    await nextTick()
+    expect(fxInput.value).toMatch(/^=\w+\(\)$/)
+    expect(table.selectionAnchor).toEqual(A1_ANCHOR)
+  })
+
+  it('提交（Enter/✓/失焦）与取消（Esc/✗）清锚点', async () => {
+    const exposed: { value: SheetExposed | undefined } = { value: undefined }
+    const el = mountSheet(exposed)
+    await nextTick()
+
+    const table = exposed.value!.getGrid()!.getTable()
+    const fxInput = fxInputOf(el)
+    const commitButton = () => el.querySelectorAll<HTMLButtonElement>('.u-sheet__fx-btn')[0]!
+    const cancelButton = () => el.querySelectorAll<HTMLButtonElement>('.u-sheet__fx-btn')[1]!
+
+    // Enter 提交
+    fxInput.dispatchEvent(new Event('focus'))
+    await nextTick()
+    expect(table.selectionAnchor).toEqual(A1_ANCHOR)
+    fxInput.dispatchEvent(new KeyboardEvent('keydown', { key: 'Enter', bubbles: true }))
+    await nextTick()
+    expect(table.selectionAnchor).toBeNull()
+
+    // ✓ 按钮
+    fxInput.dispatchEvent(new Event('focus'))
+    await nextTick()
+    expect(table.selectionAnchor).toEqual(A1_ANCHOR)
+    commitButton().click()
+    await nextTick()
+    expect(table.selectionAnchor).toBeNull()
+
+    // 失焦提交
+    fxInput.dispatchEvent(new Event('focus'))
+    await nextTick()
+    expect(table.selectionAnchor).toEqual(A1_ANCHOR)
+    fxInput.dispatchEvent(new Event('blur'))
+    await nextTick()
+    expect(table.selectionAnchor).toBeNull()
+
+    // Esc 取消
+    fxInput.dispatchEvent(new Event('focus'))
+    await nextTick()
+    expect(table.selectionAnchor).toEqual(A1_ANCHOR)
+    fxInput.dispatchEvent(new KeyboardEvent('keydown', { key: 'Escape', bubbles: true }))
+    await nextTick()
+    expect(table.selectionAnchor).toBeNull()
+
+    // ✗ 按钮
+    fxInput.dispatchEvent(new Event('focus'))
+    await nextTick()
+    expect(table.selectionAnchor).toEqual(A1_ANCHOR)
+    cancelButton().click()
+    await nextTick()
+    expect(table.selectionAnchor).toBeNull()
+  })
+
+  it('切 sheet 清锚点：切回原表缓存实例无残留高亮', async () => {
+    const exposed: { value: SheetExposed | undefined } = { value: undefined }
+    const el = mountSheet(exposed)
+    await nextTick()
+
+    const fxInput = fxInputOf(el)
+    fxInput.dispatchEvent(new Event('focus'))
+    await nextTick()
+    const sheet1Table = exposed.value!.getGrid()!.getTable()
+    expect(sheet1Table.selectionAnchor).toEqual(A1_ANCHOR)
+
+    // 切到 Sheet2：新实例无锚点，旧实例锚点已清
+    tabs(el)[1]!.click()
+    await nextTick()
+    const sheet2Table = exposed.value!.getGrid()!.getTable()
+    expect(sheet2Table).not.toBe(sheet1Table)
+    expect(sheet2Table.selectionAnchor).toBeNull()
+
+    // 切回 Sheet1：缓存实例复用，无残留锚点
+    tabs(el)[0]!.click()
+    await nextTick()
+    expect(exposed.value!.getGrid()!.getTable()).toBe(sheet1Table)
+    expect(sheet1Table.selectionAnchor).toBeNull()
+  })
+})

package/src/components/sheet/__test__/sheet-context-menu.test.ts

@@ -1,6 +1,6 @@
-import { createRange } from '@veltra/sheet-core/core/address'
-import { Sheet } from '@veltra/sheet-core/core/sheet'
-import { describe, expect, it } from 'vitest'
+import { createRange } from '@veltra/sheet-core/core/address.js'
+import { Sheet } from '@veltra/sheet-core/core/sheet.js'
+import { describe, expect, it } from 'vite-plus/test'
 
 import { createSheetContext } from '../../../tools/context'
 import {
@@ -102,7 +102,7 @@ describe('ensureContextMenuSelection', () => {
 })
 
 describe('build*Menus', () => {
-  it('行号菜单：插入×2 / 删除 / divider / 冻结项；无合并/插入列', () => {
+  it('行号菜单：插入×2 / 删除 / 行高 / divider / 冻结项；无合并/插入列', () => {
     const sheet = new Sheet()
     const ctx = createSheetContext(sheet)
     sheet.selectRange(createRange({ row: 1, col: 0 }, { row: 3, col: 5 }))
@@ -112,11 +112,12 @@ describe('build*Menus', () => {
       '在上方插入行',
       '在下方插入行',
       '删除行',
+      '行高',
       '---',
       '冻结到当前行',
       '取消冻结'
     ])
-    expect(menus.filter((m) => m.keepOpen)).toHaveLength(2)
+    expect(menus.filter((m) => m.keepOpen)).toHaveLength(3)
     expect(menus.some((m) => m.divider)).toBe(true)
     expect(menus.at(-1)?.disabled).toBe(true)
     expect(labels.join()).not.toContain('合并')
@@ -142,12 +143,40 @@ describe('build*Menus', () => {
       '在左侧插入列',
       '在右侧插入列',
       '删除列',
+      '列宽',
       '---',
       '冻结到当前列',
       '取消冻结'
     ])
   })
 
+  it('行高/列宽项：默认内嵌数值输入，readonly 降级为禁用文本项', () => {
+    const sheet = new Sheet()
+    const ctx = createSheetContext(sheet)
+    sheet.selectCell({ row: 0, col: 0 })
+
+    const rowItem = buildRowHeaderMenus(ctx).find((m) => m.label === '行高')!
+    expect(rowItem.keepOpen).toBe(true)
+    expect(rowItem.render).toBeTruthy()
+    expect(rowItem.disabled).toBeFalsy()
+
+    const colItem = buildColHeaderMenus(ctx).find((m) => m.label === '列宽')!
+    expect(colItem.keepOpen).toBe(true)
+    expect(colItem.render).toBeTruthy()
+
+    // readonly：render 内嵌组件自带点击路径，禁用态必须去掉 render 拦死输入
+    const readonlyRow = buildRowHeaderMenus(ctx, { readonly: true }).find(
+      (m) => m.label === '行高'
+    )!
+    expect(readonlyRow.disabled).toBe(true)
+    expect(readonlyRow.render).toBeUndefined()
+    const readonlyCol = buildColHeaderMenus(ctx, { readonly: true }).find(
+      (m) => m.label === '列宽'
+    )!
+    expect(readonlyCol.disabled).toBe(true)
+    expect(readonlyCol.render).toBeUndefined()
+  })
+
   it('body 菜单：合并/取消合并 + 设置数据格式子菜单 + 插入图片，不含行列插入删除', () => {
     const sheet = new Sheet()
     const ctx = createSheetContext(sheet)

package/src/components/sheet/__test__/use-formula-ref-select.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, it } from 'vitest'
+import { describe, expect, it } from 'vite-plus/test'
 
 import { insertRefText, isRefSelectContext } from '../use-formula-ref-select'
 

package/src/components/sheet/__test__/use-formula-suggest.test.ts

@@ -1,5 +1,5 @@
-import { registerFormulaFunction } from '@veltra/sheet-core/core/formula/functions'
-import { describe, expect, it } from 'vitest'
+import { registerFormulaFunction } from '@veltra/sheet-core/core/formula/functions.js'
+import { describe, expect, it } from 'vite-plus/test'
 
 import {
   applySuggest,

package/src/components/sheet/formula-bar.vue

@@ -101,9 +101,9 @@ import {
   parseRange,
   type CellAddress,
   type CellRange
-} from '@veltra/sheet-core/core/address'
-import type { SelectionState } from '@veltra/sheet-core/core/selection'
-import type { Sheet } from '@veltra/sheet-core/core/sheet'
+} from '@veltra/sheet-core/core/address.js'
+import type { SelectionState } from '@veltra/sheet-core/core/selection.js'
+import type { Sheet } from '@veltra/sheet-core/core/sheet.js'
 import { bem } from '@veltra/utils'
 import {
   computed,
@@ -140,7 +140,12 @@ defineOptions({ name: 'UFormulaBar' })
  * - 引用选择：光标在运算符/`(`/`,` 后时，画布点选/拖选插入引用（blur 抑制防误提交）。
  * - 网格编辑镜像：只读显示网格编辑器文本。
  */
-const props = defineProps<{ sheet: Sheet; context: SheetContext }>()
+const props = defineProps<{
+  sheet: Sheet
+  context: SheetContext
+  /** fx 编辑会话置/清引擎选区锚点（use-sheet-grid 经活动实例透传；缺省静默） */
+  setSelectionAnchor?: (addr: CellAddress | null) => void
+}>()
 
 const cls = bem('sheet')
 
@@ -398,6 +403,8 @@ function handleFxFocus(): void {
   mirrorAddr = null
   editing.value = true
   editAddr = selection.value.activeCell
+  // 编辑会话开始：被编辑格置选区锚点，画布引用拾取期选区流动不丢目标格高亮
+  if (editAddr) props.setSelectionAnchor?.(editAddr)
   syncFxCursor()
   scheduleAutosize()
 }
@@ -459,6 +466,8 @@ function commitEdit(): void {
   editing.value = false
   editAddr = null
   suppressBlurCommit = false
+  // 会话结束清锚点（Enter / ✓ / 失焦同路径）
+  props.setSelectionAnchor?.(null)
   closeSuggest()
   if (addr) {
     props.context.setCellValue(addr, fxDraft.value)
@@ -476,6 +485,8 @@ function cancelEdit(): void {
   editing.value = false
   editAddr = null
   suppressBlurCommit = false
+  // 会话结束清锚点（Esc / ✗）
+  props.setSelectionAnchor?.(null)
   closeSuggest()
   refreshFx()
 }
@@ -590,6 +601,8 @@ function insertFunction(name: string): void {
   fxDraft.value = text
   fxCursor.value = cursor
   suppressBlurCommit = false
+  // 插入函数即进入引用拾取会话：目标格置选区锚点
+  props.setSelectionAnchor?.(addr)
   closeSuggest()
   void nextTick(() => {
     const el = fxRef.value

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

@@ -3,9 +3,9 @@ import {
   importCsv,
   importXlsx,
   replaceWorkbookWithSnapshots
-} from '@veltra/sheet-core/core/io/import'
-import type { Sheet, SheetSnapshot } from '@veltra/sheet-core/core/sheet'
-import type { Workbook } from '@veltra/sheet-core/core/workbook'
+} from '@veltra/sheet-core/core/io/import.js'
+import type { Sheet, SheetSnapshot } from '@veltra/sheet-core/core/sheet.js'
+import type { Workbook } from '@veltra/sheet-core/core/workbook.js'
 import { nextFrame } from '@veltra/utils'
 import type { Ref } from 'vue'
 

package/src/components/sheet/insert-image.ts

@@ -1,5 +1,5 @@
 import { message } from '@veltra/desktop'
-import type { SheetImageAnchor, SheetImageType } from '@veltra/sheet-core/core/image'
+import type { SheetImageAnchor, SheetImageType } from '@veltra/sheet-core/core/image.js'
 
 import type { SheetContext } from '../../tools/context'
 

package/src/components/sheet/popup-helpers.ts

@@ -1,6 +1,6 @@
-import type { CellRange } from '@veltra/sheet-core/core/address'
-import type { BorderPreset } from '@veltra/sheet-core/core/style/border-presets'
-import { BORDER_STYLE_WIDTH, type BorderLineStyle } from '@veltra/sheet-core/core/style/types'
+import type { CellRange } from '@veltra/sheet-core/core/address.js'
+import type { BorderPreset } from '@veltra/sheet-core/core/style/border-presets.js'
+import { BORDER_STYLE_WIDTH, type BorderLineStyle } from '@veltra/sheet-core/core/style/types.js'
 
 import type { SheetContext } from '../../tools/context'
 

package/src/components/sheet/popups/border-popup.vue

@@ -35,14 +35,14 @@
 
 <script lang="ts" setup>
 import { UPalette } from '@veltra/desktop'
-import type { SetCellStyleItem } from '@veltra/sheet-core/core/command/set-cell-style'
-import { buildBorderPresetItems } from '@veltra/sheet-core/core/style/border-presets'
+import type { SetCellStyleItem } from '@veltra/sheet-core/core/command/set-cell-style.js'
+import { buildBorderPresetItems } from '@veltra/sheet-core/core/style/border-presets.js'
 import {
   BORDER_STYLE_WIDTH,
   type BorderEdge,
   type BorderLineStyle,
   type CellStylePatch
-} from '@veltra/sheet-core/core/style/types'
+} from '@veltra/sheet-core/core/style/types.js'
 import { bem } from '@veltra/utils'
 import { ref } from 'vue'
 

package/src/components/sheet/popups/find-popup.vue

@@ -69,7 +69,7 @@
 
 <script lang="ts" setup>
 import { UInput } from '@veltra/desktop'
-import type { Sheet } from '@veltra/sheet-core/core/sheet'
+import type { Sheet } from '@veltra/sheet-core/core/sheet.js'
 import { bem } from '@veltra/utils'
 
 import type { SheetContext } from '../../../tools/context'

package/src/components/sheet/popups/functions-popup.vue

@@ -47,7 +47,7 @@ import { UInput, UScroll } from '@veltra/desktop'
 import {
   listFormulaFunctions,
   type FormulaFunctionMeta
-} from '@veltra/sheet-core/core/formula/functions'
+} from '@veltra/sheet-core/core/formula/functions.js'
 import { bem } from '@veltra/utils'
 import { computed, onMounted, ref, useTemplateRef, watch } from 'vue'
 

package/src/components/sheet/popups/import.worker.ts

@@ -15,7 +15,7 @@
  * 注意：必须用**运行时动态 import**——worker 顶层静态 import 在 vite dev 的
  * worker 上下文中会因模块图加载顺序导致 `Workbook is not defined`（实测）。
  */
-import type { SheetSnapshot } from '@veltra/sheet-core/core/sheet'
+import type { SheetSnapshot } from '@veltra/sheet-core/core/sheet.js'
 
 export type ImportWorkerResponse =
   | { type: 'progress'; done: number; total: number }
@@ -31,7 +31,7 @@ self.onmessage = (e: MessageEvent<{ buffer: ArrayBuffer }>): void => {
   const { buffer } = e.data
   void (async () => {
     try {
-      const { importXlsx } = await import('@veltra/sheet-core/core/io/import')
+      const { importXlsx } = await import('@veltra/sheet-core/core/io/import.js')
       // 分片构建：按 10% 粒度回报进度（避免 196 条/秒的消息风暴与文字跳变过快；
       // 模型构建段约 1s，10 次更新肉眼可见数字推进）
       let lastPercent = -1