@veltra/sheet 2.8.1 → 3.0.0

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

@@ -0,0 +1,160 @@
+/**
+ * 公式能力可达性（spec 第 4 项 / 下游 meta 报表合计场景）：
+ * 写公式（setCellFormula / setCellValue '=' 前缀）、读公式（getCellData().f）、
+ * 求值（getDisplayValue）、自定义函数注册（infinitable 主入口）、
+ * 数据填充后自动重算——全部经 USheet 门面路径（getContext() 的 SheetContext）。
+ */
+import { registerFormulaFunction } from 'infinitable'
+import { Workbook } from 'infinitable/sheet'
+import { afterEach, describe, expect, it } from 'vite-plus/test'
+import { createApp, h, nextTick, type App } from 'vue'
+
+import { USheet } from '../../../index'
+import type { SheetContext } from '../../../tools/context'
+import type { SheetExposed } from '../../../types'
+import USheetFunctionsPopup from '../popups/functions-popup.vue'
+import { filterFormulaSuggestions } from '../use-formula-suggest'
+
+const apps: App[] = []
+const containers: HTMLElement[] = []
+
+/** 挂载 USheet（真实组件 + 内部自建工作簿），返回活动门面 SheetContext */
+function mountSheet(): { getContext: () => SheetContext } {
+  const exposed: { value: SheetExposed | undefined } = { value: 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, {
+        workbook: new Workbook(),
+        rows: 10,
+        cols: 6,
+        ref: (value: unknown) => {
+          exposed.value = value as SheetExposed | undefined
+        }
+      })
+  })
+  app.mount(el)
+  apps.push(app)
+  return { getContext: () => exposed.value!.getContext() }
+}
+
+/** 直接挂载函数弹框（与工具栏「函数」按钮 / fx 按钮同一组件） */
+function mountFunctionsPopup(): HTMLElement {
+  const el = document.createElement('div')
+  document.body.appendChild(el)
+  containers.push(el)
+  const app = createApp({ render: () => h(USheetFunctionsPopup) })
+  app.mount(el)
+  apps.push(app)
+  return el
+}
+
+/** 点击左侧分类导航项（等一帧渲染），与 functions-popup.test.ts 同一交互 */
+async function clickCategory(el: HTMLElement, category: string): Promise<void> {
+  const item = [...el.querySelectorAll<HTMLButtonElement>('.u-sheet__functions-nav-item')].find(
+    (button) => button.textContent?.trim() === category
+  )
+  item!.click()
+  await nextTick()
+}
+
+/**
+ * 宿主自定义函数（消费方经 `infinitable` 主入口注册，@veltra/sheet 不转售）：
+ * 数值参数与区域数值求和——报表「合计」类函数的最小形态。
+ */
+function registerCustomTotal(): void {
+  registerFormulaFunction('VELTRATOTAL', {
+    meta: {
+      params: [{ name: 'number1' }, { name: 'number2', optional: true }, { name: '...' }],
+      description: '测试用自定义求和（公式能力可达性）',
+      category: '数学'
+    },
+    impl(args) {
+      let total = 0
+      for (const arg of args) {
+        if (Array.isArray(arg)) {
+          for (const item of arg) if (typeof item === 'number') total += item
+        } else if (typeof arg === 'number') {
+          total += arg
+        }
+      }
+      return total
+    }
+  })
+}
+
+afterEach(() => {
+  while (apps.length) apps.pop()!.unmount()
+  while (containers.length) containers.pop()!.remove()
+})
+
+describe('公式能力可达性（USheet 门面路径）', () => {
+  it('setCellFormula 写入 SUM：getDisplayValue 得计算值；getCellData().f 读回公式（不含 = 前缀）', async () => {
+    const { getContext } = mountSheet()
+    await nextTick()
+    const ctx = getContext()
+
+    ctx.setCellValue({ row: 0, col: 1 }, 10)
+    ctx.setCellValue({ row: 1, col: 1 }, 20)
+    ctx.setCellValue({ row: 2, col: 1 }, 30)
+    ctx.setCellFormula({ row: 0, col: 0 }, '=SUM(B1:B3)')
+
+    expect(ctx.getDisplayValue({ row: 0, col: 0 })).toBe(60)
+    expect(ctx.getCellData({ row: 0, col: 0 })?.f).toBe('SUM(B1:B3)')
+
+    // setCellValue 的 '=' 前缀同样进公式通道（报表配置的另一种写法）
+    ctx.setCellValue({ row: 1, col: 0 }, '=SUM(B1:B2)')
+    expect(ctx.getDisplayValue({ row: 1, col: 0 })).toBe(30)
+    expect(ctx.getCellData({ row: 1, col: 0 })?.f).toBe('SUM(B1:B2)')
+  })
+
+  it('批量 setCells 填充被引用区域后公式自动重算（命令执行后引擎增量重算，无需手动刷新）', async () => {
+    const { getContext } = mountSheet()
+    await nextTick()
+    const ctx = getContext()
+
+    // 先写公式：被引用区域为空 → SUM 空区域为 0
+    ctx.setCellFormula({ row: 0, col: 0 }, '=SUM(B1:B3)')
+    expect(ctx.getDisplayValue({ row: 0, col: 0 })).toBe(0)
+
+    // 报表数据填充：一次 setCells = 一个 undo 单元，填充后合计自动得出
+    ctx.setCells([
+      { addr: { row: 0, col: 1 }, data: { v: 10, t: 'n' } },
+      { addr: { row: 1, col: 1 }, data: { v: 20, t: 'n' } },
+      { addr: { row: 2, col: 1 }, data: { v: 30, t: 'n' } }
+    ])
+    expect(ctx.getDisplayValue({ row: 0, col: 0 })).toBe(60)
+
+    // 修改被引用单元格 → 依赖格重算
+    ctx.setCellValue({ row: 1, col: 1 }, 25)
+    expect(ctx.getDisplayValue({ row: 0, col: 0 })).toBe(65)
+  })
+
+  it('registerFormulaFunction（infinitable 主入口）注册的自定义函数：fx 补全与函数弹框可达、公式求值可用', async () => {
+    registerCustomTotal()
+
+    // fx 输入栏补全列表按前缀命中自定义函数
+    expect(filterFormulaSuggestions('VELTRATOTA').map((item) => item.name)).toEqual(['VELTRATOTAL'])
+
+    // 函数弹框「全部」列出其签名（与内置函数同一列表）
+    const popup = mountFunctionsPopup()
+    await clickCategory(popup, '全部')
+    const signatures = [...popup.querySelectorAll('.u-sheet__functions-signature')].map(
+      (node) => node.textContent
+    )
+    expect(signatures).toContain('VELTRATOTAL(number1, [number2], ...)')
+
+    // 求值：区域参数 + 标量参数混合（args 收到 [数组, 数值]）
+    const { getContext } = mountSheet()
+    await nextTick()
+    const ctx = getContext()
+    ctx.setCellValue({ row: 0, col: 1 }, 10)
+    ctx.setCellValue({ row: 1, col: 1 }, 20)
+    ctx.setCellFormula({ row: 0, col: 0 }, '=VELTRATOTAL(B1:B2, 5)')
+    expect(ctx.getDisplayValue({ row: 0, col: 0 })).toBe(35)
+  })
+})

package/src/components/sheet/__test__/functions-popup.test.ts

@@ -1,7 +1,4 @@
-import {
-  listFormulaFunctions,
-  registerFormulaFunction
-} from '@veltra/sheet-core/core/formula/functions.js'
+import { listFormulaFunctions, registerFormulaFunction } from 'infinitable'
 import { afterEach, describe, expect, it, vi } from 'vite-plus/test'
 import { createApp, h, nextTick, type App } from 'vue'
 
@@ -97,7 +94,7 @@ describe('USheetFunctionsPopup', () => {
 
   it('「全部」列出全部已注册函数；分类项只列声明该分类的函数', async () => {
     registerFormulaFunction('MYTESTFN', {
-      meta: { params: ['value'], description: '测试未分类自定义函数' },
+      meta: { params: [{ name: 'value' }], description: '测试未分类自定义函数' },
       impl: () => 1
     })
     const { el } = mountPopup()
@@ -110,9 +107,12 @@ describe('USheetFunctionsPopup', () => {
     await clickCategory(el, '数学')
     const expected = listFormulaFunctions().filter((fn) => fn.category === '数学')
     expect(items(el).length).toBe(expected.length)
-    expect(signatures(el)).toContain('SUM(number1, number2, ...)')
     expect(signatures(el)).not.toContain('MYTESTFN(value)')
 
+    // SUM 在官方注册表归「常用」分类
+    await clickCategory(el, '常用')
+    expect(signatures(el)).toContain('SUM(number1, [number2], ...)')
+
     // 「常用」也不含未分类自定义函数
     await clickCategory(el, '常用')
     expect(signatures(el)).not.toContain('MYTESTFN(value)')
@@ -120,7 +120,7 @@ describe('USheetFunctionsPopup', () => {
 
   it('搜索跨分类（含未分类函数）：名称 / 描述大小写不敏感；无匹配显空态', async () => {
     registerFormulaFunction('MYTESTFN', {
-      meta: { params: ['value'], description: '测试未分类自定义函数' },
+      meta: { params: [{ name: 'value' }], description: '测试未分类自定义函数' },
       impl: () => 1
     })
     const { el } = mountPopup()

package/src/components/sheet/__test__/grid-setup.ts

@@ -0,0 +1,3 @@
+import { setupCanvasMock } from './canvas-mock'
+
+setupCanvasMock()

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

@@ -0,0 +1,47 @@
+/**
+ * SheetGrid 测试几何与事件工具。几何口径与官方 `infinitable/sheet` 的
+ * grid-theme 取值一致：行号列宽 46、列头高 28、列宽 80、行高 28。
+ */
+
+const ROW_HEADER_WIDTH = 46
+const HEADER_HEIGHT = 28
+const DEFAULT_COL_WIDTH = 80
+const DEFAULT_ROW_HEIGHT = 28
+
+/** 数据格 (col, row) 的层坐标（+5 落在格内而非边线上） */
+export const cellX = (col: number) => ROW_HEADER_WIDTH + col * DEFAULT_COL_WIDTH + 5
+export const cellY = (row: number) => HEADER_HEIGHT + row * DEFAULT_ROW_HEIGHT + 5
+
+/**
+ * 引擎指针事件派发目标：body 层画布。引擎事件源在 canvas 档是挂载容器、
+ * 原生档（scrollbar.mode: 'native'）是滚动容器内的 sticky 视口——body 画布
+ * 在两档下都是其后代，从它派发（冒泡）对两种形态都到达引擎监听。
+ */
+export function gridEventTarget(root: HTMLElement): HTMLElement {
+  return root.querySelector<HTMLElement>(".u-sheet__grid-instance canvas[data-layer-kind='body']")!
+}
+
+/** 向容器派发 DOM 指针类事件（引擎 EventSystem 归一化为场景事件） */
+export function fire(
+  container: HTMLElement,
+  type: string,
+  init: {
+    clientX?: number
+    clientY?: number
+    button?: number
+    bubbles?: boolean
+    ctrlKey?: boolean
+    shiftKey?: boolean
+  } = {}
+): void {
+  const event = new MouseEvent(type, {
+    bubbles: init.bubbles ?? true,
+    cancelable: true,
+    clientX: init.clientX ?? 0,
+    clientY: init.clientY ?? 0,
+    button: init.button ?? 0,
+    ctrlKey: init.ctrlKey ?? false,
+    shiftKey: init.shiftKey ?? false
+  })
+  container.dispatchEvent(event)
+}

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

@@ -1,5 +1,5 @@
-import type { Sheet } from '@veltra/sheet-core/core/sheet.js'
-import { Workbook } from '@veltra/sheet-core/core/workbook.js'
+import type { Sheet } from 'infinitable/sheet'
+import { Workbook } from 'infinitable/sheet'
 import { afterEach, describe, expect, it, vi } from 'vite-plus/test'
 import { ref } from 'vue'
 
@@ -36,11 +36,15 @@ const EMPTY_SNAPSHOT = {
 
 vi.mock('@veltra/desktop', () => ({ message: mocks.message, messageConfirm: mocks.messageConfirm }))
 
-vi.mock('@veltra/sheet-core/core/io/import.js', () => ({
-  importCsv: mocks.importCsv,
-  importXlsx: mocks.importXlsx,
-  replaceWorkbookWithSnapshots: mocks.replaceWorkbookWithSnapshots
-}))
+vi.mock('infinitable/sheet', async (importActual) => {
+  const actual = await importActual<typeof import('infinitable/sheet')>()
+  return {
+    ...actual,
+    importCsv: mocks.importCsv,
+    importXlsx: mocks.importXlsx,
+    replaceWorkbookWithSnapshots: mocks.replaceWorkbookWithSnapshots
+  }
+})
 
 function makeOptions(
   overrides: {

package/src/components/sheet/__test__/insert-image-popup.test.ts

@@ -1,4 +1,4 @@
-import { Sheet } from '@veltra/sheet-core/core/sheet.js'
+import { Sheet } from 'infinitable/sheet'
 import { afterEach, describe, expect, it, vi } from 'vite-plus/test'
 import { createApp, h, type App } from 'vue'
 

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

@@ -1,4 +1,4 @@
-import { Sheet } from '@veltra/sheet-core/core/sheet.js'
+import { Sheet } from 'infinitable/sheet'
 import { afterEach, describe, expect, it, vi } from 'vite-plus/test'
 
 import { createSheetContext } from '../../../tools/context'

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

@@ -1,14 +1,14 @@
-import { createRange } from '@veltra/sheet-core/core/address.js'
-import { Workbook } from '@veltra/sheet-core/core/workbook.js'
+import { createRange } from 'infinitable/sheet'
+import { Workbook } from 'infinitable/sheet'
 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'
+// 引擎指针事件模拟与画布几何（cellX/cellY）：setup 已跨包引用同目录 setup.ts
+import { cellX, cellY, fire, gridEventTarget } from './grid-test-utils'
 
 const apps: App[] = []
 const containers: HTMLElement[] = []
@@ -84,18 +84,8 @@ afterEach(() => {
 })
 
 describe('USheet 组件', () => {
-  it('scrollbar 透传引擎内建滚动条（缺省开启，false 关闭并触发重建）', async () => {
-    const exposedOn: { value: SheetExposed | undefined } = { value: undefined }
-    mount(() => ({}), exposedOn)
-    await nextTick()
-    // 引擎缺省 true（undefined 即开启），无需显式下发
-    expect(exposedOn.value!.getGrid()!.getTable().options.scrollbar).toBeUndefined()
-
-    const exposedOff: { value: SheetExposed | undefined } = { value: undefined }
-    mount(() => ({ scrollbar: false }), exposedOff)
-    await nextTick()
-    expect(exposedOff.value!.getGrid()!.getTable().options.scrollbar).toBe(false)
-  })
+  // scrollbar 形态与语义（缺省原生档 / false / true / 对象透传 / watch 重建）见
+  // 同目录 sheet-scrollbar.test.ts
 
   it('挂载后默认选区 A1：名称框显示 A1、fx 输入栏可用', async () => {
     const workbook = createWorkbook()
@@ -1214,7 +1204,7 @@ describe('USheet colResize（readonly 列宽拖拽）', () => {
     await nextTick()
 
     // 第 0 列右缘（46 + 80 = 126，±4 手柄区）列头带内拖拽：宽 = 起始 80 + 指针位移 42
-    const instance = el.querySelector<HTMLElement>('.u-sheet__grid-instance')!
+    const instance = gridEventTarget(el)
     fire(instance, 'pointerdown', { clientX: 124, clientY: 10 })
     fire(instance, 'pointermove', { clientX: 166, clientY: 10 })
     fire(instance, 'pointerup', { clientX: 166, clientY: 10 })
@@ -1235,7 +1225,7 @@ describe('USheet colResize（readonly 列宽拖拽）', () => {
     }))
     await nextTick()
 
-    const instance = el.querySelector<HTMLElement>('.u-sheet__grid-instance')!
+    const instance = gridEventTarget(el)
     fire(instance, 'pointerdown', { clientX: 124, clientY: 10 })
     fire(instance, 'pointermove', { clientX: 166, clientY: 10 })
     fire(instance, 'pointerup', { clientX: 166, clientY: 10 })
@@ -1277,7 +1267,7 @@ describe('fx 选区锚点', () => {
     fxInput.value = '=SUM('
     fxInput.setSelectionRange(5, 5)
     fxInput.dispatchEvent(new Event('input', { bubbles: true }))
-    const instance = el.querySelector<HTMLElement>('.u-sheet__grid-instance')!
+    const instance = gridEventTarget(el)
     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) })

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

@@ -1,5 +1,5 @@
-import { createRange } from '@veltra/sheet-core/core/address.js'
-import { Sheet } from '@veltra/sheet-core/core/sheet.js'
+import { createRange } from 'infinitable/sheet'
+import { Sheet } from 'infinitable/sheet'
 import { describe, expect, it } from 'vite-plus/test'
 
 import { createSheetContext } from '../../../tools/context'

package/src/components/sheet/__test__/sheet-grow-on-scroll.test.ts

@@ -0,0 +1,105 @@
+import { Workbook } from 'infinitable/sheet'
+import { afterEach, describe, expect, it } from 'vite-plus/test'
+import { createApp, h, nextTick, ref, 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>): {
+  exposed: { value: SheetExposed | undefined }
+  el: HTMLElement
+} {
+  const exposed: { value: SheetExposed | undefined } = { value: 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) => {
+          exposed.value = value as SheetExposed | undefined
+        }
+      })
+  })
+  app.mount(el)
+  apps.push(app)
+  return { exposed, el }
+}
+
+/**
+ * 滚动帧经 requestAnimationFrame 派发（引擎 host.requestFrame）：
+ * 等待 n 帧确保 onScrollFrame → growOnNearEdge 已执行
+ */
+async function nextFrames(count: number): Promise<void> {
+  for (let i = 0; i < count; i++) {
+    await new Promise<void>((resolve) => requestAnimationFrame(() => resolve()))
+  }
+}
+
+/** 滚动到水平最末端（引擎按内容宽度钳制到 maxLeft，可视缓冲触到当前列数） */
+function scrollToLeftEnd(exposed: { value: SheetExposed | undefined }): void {
+  exposed.value!.getGrid()!.getTable().setScrollLeft(Number.MAX_SAFE_INTEGER)
+}
+
+afterEach(() => {
+  while (apps.length) apps.pop()!.unmount()
+  while (containers.length) containers.pop()!.remove()
+})
+
+describe('USheet growOnScroll（近边增长开关透传）', () => {
+  it('缺省：不传保持引擎缺省（true），滚动触界后模型列数扩容', async () => {
+    const { exposed } = mount(() => ({ workbook: new Workbook(), rows: 10, cols: 26 }))
+    await nextTick()
+
+    const sheet = exposed.value!.getActiveSheet()
+    expect(sheet.cols).toBe(26)
+
+    scrollToLeftEnd(exposed)
+    await nextFrames(3)
+    // 引擎 growOnNearEdge：可视缓冲触到 26 列 → 模型与引擎同步扩容
+    expect(sheet.cols).toBeGreaterThan(26)
+  })
+
+  it('growOnScroll: false：固定尺寸网格，滚动触界不扩容', async () => {
+    const { exposed } = mount(() => ({
+      workbook: new Workbook(),
+      rows: 10,
+      cols: 26,
+      growOnScroll: false
+    }))
+    await nextTick()
+
+    const sheet = exposed.value!.getActiveSheet()
+    scrollToLeftEnd(exposed)
+    await nextFrames(3)
+    expect(sheet.cols).toBe(26)
+  })
+
+  it('watch 重建：切换 growOnScroll 触发网格重建', async () => {
+    const state = ref<boolean | undefined>(false)
+    const { exposed } = mount(() => ({
+      workbook: new Workbook(),
+      rows: 10,
+      cols: 26,
+      growOnScroll: state.value
+    }))
+    await nextTick()
+
+    const gridFixed = exposed.value!.getGrid()
+    state.value = undefined
+    await nextTick()
+    const gridGrow = exposed.value!.getGrid()
+    expect(gridGrow).not.toBe(gridFixed)
+
+    // 重建后的实例恢复引擎缺省（近边增长生效）
+    scrollToLeftEnd(exposed)
+    await nextFrames(3)
+    expect(exposed.value!.getActiveSheet().cols).toBeGreaterThan(26)
+  })
+})

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

@@ -0,0 +1,137 @@
+import { Workbook } from 'infinitable/sheet'
+import { afterEach, describe, expect, it } from 'vite-plus/test'
+import { createApp, h, nextTick, ref, 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>): {
+  exposed: { value: SheetExposed | undefined }
+  el: HTMLElement
+} {
+  const exposed: { value: SheetExposed | undefined } = { value: 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) => {
+          exposed.value = value as SheetExposed | undefined
+        }
+      })
+  })
+  app.mount(el)
+  apps.push(app)
+  return { exposed, el }
+}
+
+/** 引擎装配的原生滚动容器（wrapper 带 data-native-scroll 标记，见引擎 NativeScrollbarHost） */
+function nativeScrollHost(el: HTMLElement): HTMLElement | null {
+  return el.querySelector<HTMLElement>('.u-sheet__grid-instance [data-native-scroll]')
+}
+
+afterEach(() => {
+  while (apps.length) apps.pop()!.unmount()
+  while (containers.length) containers.pop()!.remove()
+})
+
+describe('USheet scrollbar（缺省原生档，全形态透传）', () => {
+  it('缺省：原生档配置下发引擎，usesNativeScrollbar 为 true，grid 区装配原生滚动容器', async () => {
+    const { exposed, el } = mount(() => ({ workbook: new Workbook(), rows: 10, cols: 6 }))
+    await nextTick()
+
+    const table = exposed.value!.getGrid()!.getTable()
+    expect(table.options.scrollbar).toEqual({ mode: 'native' })
+    expect(table.usesNativeScrollbar).toBe(true)
+    // DOM 断言：引擎在挂载容器内装配真实 overflow 滚动容器（scrollbar-gutter: stable）
+    expect(nativeScrollHost(el)).not.toBeNull()
+  })
+
+  it('scrollbar: false：整体关闭语义不变，无原生滚动容器', async () => {
+    const { exposed, el } = mount(() => ({
+      workbook: new Workbook(),
+      rows: 10,
+      cols: 6,
+      scrollbar: false
+    }))
+    await nextTick()
+
+    const table = exposed.value!.getGrid()!.getTable()
+    expect(table.options.scrollbar).toBe(false)
+    expect(table.usesNativeScrollbar).toBe(false)
+    expect(nativeScrollHost(el)).toBeNull()
+  })
+
+  it('scrollbar: true：旧语义（画布常驻滚动条）透传，不装配原生容器', async () => {
+    const { exposed, el } = mount(() => ({
+      workbook: new Workbook(),
+      rows: 10,
+      cols: 6,
+      scrollbar: true
+    }))
+    await nextTick()
+
+    const table = exposed.value!.getGrid()!.getTable()
+    expect(table.options.scrollbar).toBe(true)
+    expect(table.usesNativeScrollbar).toBe(false)
+    expect(nativeScrollHost(el)).toBeNull()
+  })
+
+  it('对象形态按引用透传（mode: canvas 显式回画布档）', async () => {
+    const canvasOption = { mode: 'canvas', visibility: 'always' } as const
+    const { exposed, el } = mount(() => ({
+      workbook: new Workbook(),
+      rows: 10,
+      cols: 6,
+      scrollbar: canvasOption
+    }))
+    await nextTick()
+
+    const table = exposed.value!.getGrid()!.getTable()
+    // 引用透传：引擎收到宿主的同一对象（构造期选项，宿主保持稳定引用即可）
+    expect(table.options.scrollbar).toBe(canvasOption)
+    expect(table.usesNativeScrollbar).toBe(false)
+    expect(nativeScrollHost(el)).toBeNull()
+  })
+
+  it('watch 重建：对象引用更替与 boolean 切换都触发网格重建，新配置生效', async () => {
+    const state = ref<boolean | Record<string, unknown>>({ mode: 'native' })
+    const { exposed, el } = mount(() => ({
+      workbook: new Workbook(),
+      rows: 10,
+      cols: 6,
+      scrollbar: state.value
+    }))
+    await nextTick()
+
+    const gridNative = exposed.value!.getGrid()
+    expect(gridNative!.getTable().usesNativeScrollbar).toBe(true)
+
+    // 对象引用更替（native → canvas 常驻）：构造期选项变化 → 重建
+    state.value = { mode: 'canvas', visibility: 'always' }
+    await nextTick()
+    const gridCanvas = exposed.value!.getGrid()
+    expect(gridCanvas).not.toBe(gridNative)
+    expect(gridCanvas!.getTable().options.scrollbar).toEqual({
+      mode: 'canvas',
+      visibility: 'always'
+    })
+    expect(gridCanvas!.getTable().usesNativeScrollbar).toBe(false)
+    expect(nativeScrollHost(el)).toBeNull()
+
+    // boolean 切换（canvas → false）：同样重建，整体关闭
+    state.value = false
+    await nextTick()
+    const gridOff = exposed.value!.getGrid()
+    expect(gridOff).not.toBe(gridCanvas)
+    expect(gridOff!.getTable().options.scrollbar).toBe(false)
+    expect(gridOff!.getTable().usesNativeScrollbar).toBe(false)
+  })
+})

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

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

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

@@ -95,16 +95,16 @@
 
 <script lang="ts" setup>
 import { message, UDropdown } from '@veltra/desktop'
+import { bem } from '@veltra/utils'
 import {
   formatAddress,
   formatRange,
   parseRange,
   type CellAddress,
   type CellRange
-} 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'
+} from 'infinitable/sheet'
+import type { SelectionState } from 'infinitable/sheet'
+import type { Sheet } from 'infinitable/sheet'
 import {
   computed,
   nextTick,

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

@@ -1,12 +1,8 @@
 import { message, messageConfirm } from '@veltra/desktop'
-import {
-  importCsv,
-  importXlsx,
-  replaceWorkbookWithSnapshots
-} 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 { importCsv, importXlsx, replaceWorkbookWithSnapshots } from 'infinitable/sheet'
+import type { Sheet, SheetSnapshot } from 'infinitable/sheet'
+import type { Workbook } from 'infinitable/sheet'
 import type { Ref } from 'vue'
 
 import type { ImportWorkerResponse } from './popups/import.worker'