@veltra/sheet 2.8.1 → 3.0.0

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.js'
+import type { SheetImageAnchor, SheetImageType } from 'infinitable/sheet'
 
 import type { SheetContext } from '../../tools/context'
 
@@ -24,7 +24,7 @@ const EXT_TO_TYPE: Record<string, SheetImageType> = {
   webp: 'webp'
 }
 
-/** MIME → sheet-core 图片类型（core/image 的 SheetImageType）；MIME 为空时回落扩展名 */
+/** MIME → 引擎图片类型（SheetImageType）；MIME 为空时回落扩展名 */
 export function resolveImageType(file: File): SheetImageType | undefined {
   const mime = file.type.trim().toLowerCase()
   if (mime && MIME_TO_TYPE[mime]) return MIME_TO_TYPE[mime]

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

@@ -1,6 +1,6 @@
-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 { CellRange } from 'infinitable/sheet'
+import type { BorderPreset } from 'infinitable/sheet'
+import { BORDER_STYLE_WIDTH, type BorderLineStyle } from 'infinitable/sheet'
 
 import type { SheetContext } from '../../tools/context'
 

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

@@ -35,15 +35,15 @@
 
 <script lang="ts" setup>
 import { UPalette } from '@veltra/desktop'
-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 { bem } from '@veltra/utils'
+import type { SetCellStyleItem } from 'infinitable/sheet'
+import { buildBorderPresetItems } from 'infinitable/sheet'
 import {
   BORDER_STYLE_WIDTH,
   type BorderEdge,
   type BorderLineStyle,
   type CellStylePatch
-} from '@veltra/sheet-core/core/style/types.js'
-import { bem } from '@veltra/utils'
+} from 'infinitable/sheet'
 import { ref } from 'vue'
 
 import type { SheetContext } from '../../../tools/context'

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

@@ -30,7 +30,7 @@ const cls = bem('sheet')
 function exportXlsx(): void {
   emit('close')
   // 大工作簿序列化在 worker 中进行（数秒）：给常驻反馈，失败（如 sheet 名含
-  // Excel 非法字符，sheet-core 写入校验抛 InvalidArgumentError）明确报错，
+  // Excel 非法字符，引擎写入校验抛 InvalidArgumentError）明确报错，
   // 绝不静默失败
   const loading = message({ message: '正在导出…', duration: 0 })
   exportWorkbookFile(props.context)

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

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

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

@@ -28,9 +28,7 @@
             @click="emit('select', fn.name)"
             @mouseenter="activeIndex = index"
           >
-            <span :class="cls.e('functions-signature')">{{
-              formatFunctionSignature(fn.name, fn.params)
-            }}</span>
+            <span :class="cls.e('functions-signature')">{{ fn.signature }}</span>
             <span v-if="fn.description" :class="cls.e('functions-description')">{{
               fn.description
             }}</span>
@@ -44,16 +42,12 @@
 
 <script lang="ts" setup>
 import { UInput, UScroll } from '@veltra/desktop'
-import {
-  listFormulaFunctions,
-  type FormulaFunctionMeta
-} from '@veltra/sheet-core/core/formula/functions.js'
 import { bem } from '@veltra/utils'
+import { listFormulaFunctions, type FormulaFunctionInfo } from 'infinitable'
 import { computed, onMounted, ref, useTemplateRef, watch } from 'vue'
 
 import {
   COMMON_FORMULA_NAMES,
-  formatFunctionSignature,
   FUNCTION_POPUP_CATEGORIES,
   moveSuggestIndex,
   type FunctionPopupCategory
@@ -68,7 +62,7 @@ defineOptions({ name: 'USheetFunctionsPopup' })
  * 弹框随 v-if 挂载 / 销毁，每次打开都是全新状态（关键词清空、回到「常用」）。
  */
 
-type FunctionItem = { name: string } & FormulaFunctionMeta
+type FunctionItem = FormulaFunctionInfo
 
 const emit = defineEmits<{ select: [name: string] }>()
 

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

@@ -8,14 +8,14 @@
  * - { type: 'done', ok: true, sheets: [{ name, snapshot }], activeIndex }（快照为
  *   纯数据，可结构化克隆）；失败 { type: 'done', ok: false, error }。
  *
- * 解析与构建经 sheet-core importXlsx 完成（hucre 仅由 sheet-core 依赖）；
+ * 解析与构建经 infinitable/sheet importXlsx 完成（hucre 已内联进引擎统一包）；
  * 名字唯一化与活动表对齐在 worker 内完成，主线程直接把快照替换进目标
  * （无 undo 历史——替换语义由确认后的 replaceWorkbookWithSnapshots 负责）。
  *
  * 注意：必须用**运行时动态 import**——worker 顶层静态 import 在 vite dev 的
  * worker 上下文中会因模块图加载顺序导致 `Workbook is not defined`（实测）。
  */
-import type { SheetSnapshot } from '@veltra/sheet-core/core/sheet.js'
+import type { SheetSnapshot } from 'infinitable/sheet'
 
 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.js')
+      const { importXlsx } = await import('infinitable/sheet')
       // 分片构建：按 10% 粒度回报进度（避免 196 条/秒的消息风暴与文字跳变过快；
       // 模型构建段约 1s，10 次更新肉眼可见数字推进）
       let lastPercent = -1

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

@@ -1,6 +1,6 @@
 import type { ContextmenuItem } from '@veltra/desktop'
-import { createRange, type CellAddress, type CellRange } from '@veltra/sheet-core/core/address.js'
-import type { NumFmt } from '@veltra/sheet-core/core/style/types.js'
+import { createRange, type CellAddress, type CellRange } from 'infinitable/sheet'
+import type { NumFmt } from 'infinitable/sheet'
 import { defineComponent, h } from 'vue'
 
 import type { SheetContext } from '../../tools/context'
@@ -20,7 +20,7 @@ export const DECIMAL_PLACES_MAX = 10
 /** 行高/列宽数值项输入上限（下限复用门面 MIN_ROW_COL_SIZE，对齐引擎 resize 最小值） */
 export const AXIS_SIZE_MAX = 1000
 
-/** 数值项默认值回落：未设置自定义尺寸时展示引擎默认行高/列宽（对齐 sheet-core grid-theme） */
+/** 数值项默认值回落：未设置自定义尺寸时展示引擎默认行高/列宽（对齐引擎 grid-theme） */
 export const FALLBACK_ROW_HEIGHT = 28
 export const FALLBACK_COL_WIDTH = 80
 
@@ -247,7 +247,7 @@ export function buildColHeaderMenus(
 
 /**
  * 对当前选区应用 numFmt（经 applyStyle → 命令系统，天然可 undo/redo）。
- * 仅影响显示，单元格恒存原始值（见 sheet-core `core/format.ts`）。
+ * 仅影响显示，单元格恒存原始值（引擎 numFmt 显示约定）。
  */
 export function applyNumFmtToSelection(ctx: SheetContext, numFmt: NumFmt): void {
   for (const range of ctx.getSelection().ranges) ctx.applyStyle(range, { numFmt })

package/src/components/sheet/sheet-tabs.vue

@@ -54,9 +54,9 @@
 <script lang="ts" setup>
 import { contextmenu, message, messageConfirm, UIcon } from '@veltra/desktop'
 import { ArrowLeft, ArrowRight } from '@veltra/icons/normal'
-import type { Sheet } from '@veltra/sheet-core/core/sheet.js'
-import type { Workbook } from '@veltra/sheet-core/core/workbook.js'
 import { bem } from '@veltra/utils'
+import type { Sheet } from 'infinitable/sheet'
+import type { Workbook } from 'infinitable/sheet'
 import { nextTick, ref, toRef, useTemplateRef } from 'vue'
 
 import { useSheetTabsBar } from './use-sheet-tabs-bar'

package/src/components/sheet/sheet.vue

@@ -1,6 +1,6 @@
 <template>
   <div ref="rootRef" :class="cls.b">
-    <div :class="cls.e('toolbar-wrap')">
+    <div ref="toolbarWrapRef" :class="cls.e('toolbar-wrap')">
       <u-sheet-toolbar v-if="showToolbar" :groups="toolGroups" @tool-click="handleToolClick" />
 
       <!-- 弹层型工具面板（填充/边框/字体色/字号/查找/函数/插入图片/导出）：UDropdown（Teleport 到
@@ -113,7 +113,13 @@ const props = withDefaults(defineProps<SheetProps>(), {
   showColHeader: true,
   readonly: false,
   colResize: false,
-  scrollbar: true
+  // 缺省原生档：引擎在 grid 容器内装配真实 DOM 滚动容器（原生滚动条独立
+  // gutter，不遮挡单元格），画布悬浮滚动条不再绘制。对象缺省被所有实例共享，
+  // 只读透传不改动
+  scrollbar: { mode: 'native' },
+  // 显式对齐引擎当前缺省（true 近边增长）：boolean prop 不写 default 会被
+  // Vue 铸成 false，把引擎缺省翻成固定尺寸网格
+  growOnScroll: true
 })
 
 const emit = defineEmits<SheetEmits>()
@@ -123,6 +129,9 @@ const cls = bem('sheet')
 /** 根容器 ref：Ctrl/Cmd+F 判定焦点是否在本实例内（#6，避免劫持浏览器查找） */
 const rootRef = useTemplateRef<HTMLElement>('rootRef')
 
+/** 工具栏容器 ref：工具栏隐藏（showToolbar=false）时查找弹层的回退锚点（0 高贴 sheet 顶） */
+const toolbarWrapRef = useTemplateRef<HTMLElement>('toolbarWrapRef')
+
 // ─── 状态源（workbook / sheet 列表 / 活动 sheet / 工具上下文）────────
 // hooks 引用的 closePopup / rebuildGrid 由下方组合提供：箭头函数在事件触发时才
 // 求值（彼时已完成全部 setup），组合声明顺序不构成循环依赖。
@@ -144,7 +153,7 @@ const {
   popupAnchor,
   closePopup,
   handleToolClick: openOrRunTool
-} = useToolPopup(context, rootRef)
+} = useToolPopup(context, rootRef, () => toolbarWrapRef.value ?? null)
 // xlsx 解析中（worker）：grid 容器显示自绘覆盖层（import-file 写入 parsing /
 // parseProgress；遮罩 + 动画 + 文字同层——动画在上、文字在下）
 const parsing = ref(false)

package/src/components/sheet/use-find-replace.ts

@@ -1,17 +1,13 @@
 import { debounce } from '@cat-kit/core'
-import {
-  inferCellType,
-  normalizeInputValue,
-  type CellData
-} from '@veltra/sheet-core/core/cell-store.js'
+import { inferCellType, normalizeInputValue, type CellData } from 'infinitable/sheet'
 import {
   findAll,
   findNextFrom,
   findPrevFrom,
   type FindMatch,
   type FindOptions
-} from '@veltra/sheet-core/core/find.js'
-import type { Sheet } from '@veltra/sheet-core/core/sheet.js'
+} from 'infinitable/sheet'
+import type { Sheet } from 'infinitable/sheet'
 import { computed, ref, shallowRef, watch } from 'vue'
 
 import type { SheetContext } from '../../tools/context'

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

@@ -1,7 +1,4 @@
-import {
-  listFormulaFunctions,
-  type FormulaFunctionMeta
-} from '@veltra/sheet-core/core/formula/functions.js'
+import { listFormulaFunctions, type FormulaFunctionInfo } from 'infinitable'
 
 /** 补全候选上限 */
 export const FORMULA_SUGGEST_LIMIT = 10
@@ -26,7 +23,7 @@ export const COMMON_FORMULA_NAMES = [
 /**
  * 函数弹框分类导航固定集合（顺序即展示顺序）。
  * 「常用」「全部」是导航概念（非注册表分类）：常用 = COMMON_FORMULA_NAMES 固定清单，
- * 全部 = 全部已注册函数；其余与 sheet-core `FormulaFunctionCategory` 对应。
+ * 全部 = 全部已注册函数；其余与公式注册表 `FormulaFunctionCategory` 对应。
  */
 export const FUNCTION_POPUP_CATEGORIES = [
   '常用',
@@ -131,12 +128,13 @@ export function filterFormulaSuggestions(prefix: string): FormulaSuggestItem[] {
   return items
 }
 
-function toSuggestItem(fn: { name: string } & FormulaFunctionMeta): FormulaSuggestItem {
+function toSuggestItem(fn: FormulaFunctionInfo): FormulaSuggestItem {
+  const params = fn.params.map((p) => p.name)
   return {
     name: fn.name,
-    params: fn.params,
+    params,
     description: fn.description,
-    signature: formatFunctionSignature(fn.name, fn.params)
+    signature: formatFunctionSignature(fn.name, params)
   }
 }
 

package/src/components/sheet/use-sheet-grid.ts

@@ -1,7 +1,7 @@
 import { contextmenu } from '@veltra/desktop'
-import type { CellAddress, CellRange } from '@veltra/sheet-core/core/address.js'
-import type { Sheet } from '@veltra/sheet-core/core/sheet.js'
-import { SheetGrid, type SheetGridContextMenuInfo } from '@veltra/sheet-core/grid'
+import type { CellAddress, CellRange } from 'infinitable/sheet'
+import type { Sheet } from 'infinitable/sheet'
+import { SheetGrid, type SheetGridContextMenuInfo } from 'infinitable/sheet'
 import { onBeforeUnmount, onMounted, watch } from 'vue'
 
 import type { SheetContext } from '../../tools/context'
@@ -132,6 +132,7 @@ export function useSheetGrid(options: UseSheetGridOptions) {
       editors: props.editors,
       colResize: props.colResize,
       scrollbar: props.scrollbar,
+      growOnScroll: props.growOnScroll,
       onContextMenu: handleContextMenu,
       onEditStart: (addr) => formulaBarRef.value?.mirrorGridEdit(addr),
       onEditEnd: (addr) => formulaBarRef.value?.exitMirror(addr),
@@ -275,7 +276,8 @@ export function useSheetGrid(options: UseSheetGridOptions) {
         props.header,
         props.editors,
         props.colResize,
-        props.scrollbar
+        props.scrollbar,
+        props.growOnScroll
       ] as const,
     ([nextRows, nextCols]) => {
       const sheet = getActiveSheet()

package/src/components/sheet/use-sheet-state.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 { computed, onBeforeUnmount, onMounted, ref, shallowRef, watch } from 'vue'
 
 import { createSheetContext } from '../../tools/context'

package/src/components/sheet/use-tool-popup.ts

@@ -31,7 +31,15 @@ function joinsTransaction(tool: SheetTool): boolean {
  * 函数面板选中只进入公式栏编辑态（无直接模型写入），与查找 / 导出一样不参与事务。
  * 导入在 sheet.vue 特殊处理（直接系统文件选择），不经弹层。
  */
-export function useToolPopup(context: SheetContext, rootEl: ElRef) {
+export function useToolPopup(
+  context: SheetContext,
+  rootEl: ElRef,
+  /**
+   * 查找弹层回退锚点（工具栏隐藏时 find 按钮不可达，取 sheet 顶部容器：
+   * 0 高贴 sheet 顶，bottom-start 定位下弹层自 sheet 左上角展开，落在 sheet 视口内）
+   */
+  getFallbackAnchor?: () => HTMLElement | null | undefined
+) {
   /** 当前打开的弹层工具（null = 未打开） */
   const popupTool = shallowRef<SheetTool | null>(null)
   /** 触发按钮元素（打开时的 currentTarget；用于面板 left 对齐按钮） */
@@ -104,6 +112,18 @@ export function useToolPopup(context: SheetContext, rootEl: ElRef) {
     closePopup()
   }
 
+  /**
+   * Ctrl/Cmd+F 的锚点解析：优先工具栏「查找与替换」按钮（与按钮入口完全同锚点，
+   * 弹层同样锚定按钮下方）；按钮不可达（showToolbar 隐藏）时回退 sheet 顶部容器。
+   */
+  function resolveFindAnchor(): HTMLElement | null {
+    const root = rootEl.value
+    if (!root) return null
+    const button = root.querySelector<HTMLElement>('[data-tool-id="find"]')
+    if (button) return button
+    return getFallbackAnchor?.() ?? null
+  }
+
   /** Ctrl/Cmd+F 打开 / 关闭查找条（与工具按钮同一 toggle 逻辑） */
   function onGlobalKeydown(event: KeyboardEvent): void {
     if (!(event.metaKey || event.ctrlKey) || event.key.toLowerCase() !== 'f') return
@@ -131,7 +151,7 @@ export function useToolPopup(context: SheetContext, rootEl: ElRef) {
       closePopup()
       return
     }
-    scheduleOpen(findTool)
+    scheduleOpen(findTool, resolveFindAnchor())
   }
 
   onMounted(() => {

package/src/index.ts

@@ -1,6 +1,8 @@
 import './tools/builtin'
 
-export { createSheetContext, type SheetContext } from './tools/context'
+// SheetContextOptions：createSheetContext（公共导出）的第三参类型——导出函数
+// 签名引用的稳定类型须随函数可达（无头场景宿主需引用该类型），不属引擎符号
+export { createSheetContext, type SheetContext, type SheetContextOptions } from './tools/context'
 
 export {
   defaultToolRegistry,

package/src/tools/__test__/apply-style.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 { classifySelectionStyleTarget, type SelectionStyleTarget } from '../apply-style'

package/src/tools/__test__/builtin.test.ts

@@ -1,8 +1,8 @@
-import { createRange } from '@veltra/sheet-core/core/address.js'
+import { createRange } from 'infinitable/sheet'
 
 import '../builtin'
-import { Sheet } from '@veltra/sheet-core/core/sheet.js'
-import { Workbook } from '@veltra/sheet-core/core/workbook.js'
+import { Sheet } from 'infinitable/sheet'
+import { Workbook } from 'infinitable/sheet'
 import { describe, expect, it, vi } from 'vite-plus/test'
 
 import { createSheetContext } from '../context'
@@ -122,7 +122,7 @@ describe('内置工具（dogfood 扩展机制）', () => {
     }
   })
 
-  it('导出 xlsx：sheet 名含 Excel 非法字符时 reject（sheet-core 写入校验，错误传播给调用方）', async () => {
+  it('导出 xlsx：sheet 名含 Excel 非法字符时 reject（引擎写入校验，错误传播给调用方）', async () => {
     const workbook = new Workbook()
     workbook.renameSheet('Sheet1', 'a:b')
     const ctx = createSheetContext(workbook.activeSheet, workbook)

package/src/tools/__test__/context.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, vi } from 'vite-plus/test'
 
 import { createSheetContext, MIN_ROW_COL_SIZE } from '../context'

package/src/tools/apply-style.ts

@@ -1,6 +1,6 @@
-import type { CellRange } from '@veltra/sheet-core/core/address.js'
-import type { SetAxisStyleItem } from '@veltra/sheet-core/core/command/set-axis-style.js'
-import type { CellStylePatch } from '@veltra/sheet-core/core/style/types.js'
+import type { CellRange } from 'infinitable/sheet'
+import type { SetAxisStyleItem } from 'infinitable/sheet'
+import type { CellStylePatch } from 'infinitable/sheet'
 
 /** 样式写入目标：整行 / 整列默认样式，或逐格 */
 export type SelectionStyleTarget = 'row' | 'col' | 'cell'

package/src/tools/builtin.ts

@@ -24,8 +24,8 @@ import {
   VerticalAlignRight,
   Wrap
 } from '@veltra/icons/normal'
-import { rangesEqual } from '@veltra/sheet-core/core/address.js'
-import type { HorizontalAlign, VerticalAlign } from '@veltra/sheet-core/core/style/types.js'
+import { rangesEqual } from 'infinitable/sheet'
+import type { HorizontalAlign, VerticalAlign } from 'infinitable/sheet'
 
 import type { SheetContext } from './context'
 import { registerTool } from './registry'

package/src/tools/context.ts

@@ -1,14 +1,14 @@
-import type { CellAddress, CellRange } from '@veltra/sheet-core/core/address.js'
-import type { CellData, CellValue } from '@veltra/sheet-core/core/cell-store.js'
-import type { HistoryState } from '@veltra/sheet-core/core/command/history.js'
-import type { ImageUpdateFields } from '@veltra/sheet-core/core/command/image.js'
-import type { SetCellValueItem } from '@veltra/sheet-core/core/command/set-cell-value.js'
-import type { ImageInput, SheetImage } from '@veltra/sheet-core/core/image.js'
-import type { CellInfo } from '@veltra/sheet-core/core/merge-manager.js'
-import type { SelectionState } from '@veltra/sheet-core/core/selection.js'
-import type { FrozenState, Sheet } from '@veltra/sheet-core/core/sheet.js'
-import type { CellStyle, CellStylePatch } from '@veltra/sheet-core/core/style/types.js'
-import type { Workbook } from '@veltra/sheet-core/core/workbook.js'
+import type { CellAddress, CellRange } from 'infinitable/sheet'
+import type { CellData, CellValue } from 'infinitable/sheet'
+import type { HistoryState } from 'infinitable/sheet'
+import type { ImageUpdateFields } from 'infinitable/sheet'
+import type { SetCellValueItem } from 'infinitable/sheet'
+import type { ImageInput, SheetImage } from 'infinitable/sheet'
+import type { CellInfo } from 'infinitable/sheet'
+import type { SelectionState } from 'infinitable/sheet'
+import type { FrozenState, Sheet } from 'infinitable/sheet'
+import type { CellStyle, CellStylePatch } from 'infinitable/sheet'
+import type { Workbook } from 'infinitable/sheet'
 
 import { axisStyleItemsForRange, classifySelectionStyleTarget } from './apply-style'
 

package/src/tools/download.ts

@@ -1,12 +1,12 @@
 import { saveBlob } from '@cat-kit/fe'
-import { exportSheetCsv, exportWorkbookXlsx } from '@veltra/sheet-core/core/io/export.js'
-import type { Workbook } from '@veltra/sheet-core/core/workbook.js'
+import { exportSheetCsv, exportWorkbookXlsx } from 'infinitable/sheet'
+import type { Workbook } from 'infinitable/sheet'
 
 import type { SheetContext } from './context'
 import type { ExportWorkerPayload, ExportWorkerResponse } from './export.worker'
 
 /**
- * 大工作簿的 XLSX 导出（sheet-core 序列化 + ZIP 压缩为秒级同步重活）移入 Web Worker：
+ * 大工作簿的 XLSX 导出（引擎序列化 + ZIP 压缩为秒级同步重活）移入 Web Worker：
  * 主线程只采集快照（结构化克隆友好的纯数据，行高随 SheetSnapshot.rowHeights
  * 携带），序列化与压缩在 worker 线程进行。worker 不可用（极端环境 / 打包产物
  * 缺文件）回退主线程导出——与导入侧 parseXlsxAsync 同一模式。
@@ -55,7 +55,7 @@ async function exportWorkbookXlsxAsync(workbook: Workbook): Promise<Uint8Array>
 /**
  * 导出当前工作簿为 .xlsx（无 workbook 时空操作）。
  * 下载动作复用 @cat-kit/fe 的 saveBlob（#28：不再自研 Object URL + a.click）。
- * 导出侧 sheet-core 的 writeXlsx 会校验 sheet 名（Excel 非法字符 / 超长 / 保留名）并抛
+ * 导出侧引擎的 writeXlsx 会校验 sheet 名（Excel 非法字符 / 超长 / 保留名）并抛
  * InvalidArgumentError——失败经返回的 Promise 传播，调用方（导出面板）负责提示。
  */
 export async function exportWorkbookFile(ctx: SheetContext): Promise<void> {

package/src/tools/export.worker.ts

@@ -1,6 +1,6 @@
 /// <reference lib="webworker" />
 /**
- * XLSX 导出 Worker：sheet-core exportWorkbookXlsx（模型序列化 + ZIP 压缩，
+ * XLSX 导出 Worker：infinitable/sheet exportWorkbookXlsx（模型序列化 + ZIP 压缩，
  * 大工作簿为秒级同步重活）移到独立线程，主线程保持空闲。
  *
  * 协议：主线程 postMessage({ sheets: [{ name, snapshot }], activeIndex }）
@@ -12,7 +12,7 @@
  * 静态 import 在 vite dev 的 worker 上下文中会因模块图加载顺序导致
  * `Workbook is not defined`（实测）。
  */
-import type { SheetSnapshot } from '@veltra/sheet-core/core/sheet.js'
+import type { SheetSnapshot } from 'infinitable/sheet'
 
 export interface ExportWorkerPayload {
   sheets: { name: string; snapshot: SheetSnapshot }[]
@@ -26,17 +26,14 @@ export interface ExportWorkerResponse {
 }
 
 self.onmessage = (e: MessageEvent<ExportWorkerPayload>): void => {
-  void Promise.all([
-    import('@veltra/sheet-core/core/io/export.js'),
-    import('@veltra/sheet-core/core/workbook.js')
-  ])
+  void Promise.all([import('infinitable/sheet'), import('infinitable/sheet')])
     .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 自带的默认表：先改名对齐（空名/重名保持原名，
-        // 导出侧 sheet-core 的 writeXlsx 会校验表名合法性）
+        // 导出侧引擎的 writeXlsx 会校验表名合法性）
         const sheet = i === 0 ? wb.activeSheet : wb.addSheet(name)
         if (i === 0 && sheet.name !== name) wb.renameSheet(sheet.name, name)
         sheet.restore(snapshot)

package/src/tools/registry.ts

@@ -1,4 +1,4 @@
-import { TypedEventEmitter } from '@veltra/sheet-core/core/events.js'
+import { TypedEventEmitter } from 'infinitable/sheet'
 
 import type { SheetContext } from './context'
 

package/src/types/sheet.ts

@@ -1,14 +1,15 @@
-import type { Sheet } from '@veltra/sheet-core/core/sheet.js'
-import type { Workbook } from '@veltra/sheet-core/core/workbook.js'
+import type { DeconstructValue } from '@veltra/utils'
+import type { Sheet } from 'infinitable/sheet'
+import type { Workbook } from 'infinitable/sheet'
 import type {
   ResolveCellRenderer,
   ResolveCellStyleHook,
   ResolveDisplayValue,
+  ScrollbarOptions,
   SheetGrid,
   SheetGridEditorsOptions,
   SheetGridHeaderOptions
-} from '@veltra/sheet-core/grid'
-import type { DeconstructValue } from '@veltra/utils'
+} from 'infinitable/sheet'
 import type { ComputedRef } from 'vue'
 
 import type { SheetContext } from '../tools/context'
@@ -31,7 +32,7 @@ export interface SheetProps {
   resolveCellStyle?: ResolveCellStyleHook
   /**
    * 动态单元格渲染（ADR-0004）：视口布局时按格自定义渲染形态（返回引擎
-   * `CellRenderer`，见 `@veltra/sheet-core/grid`），返回 undefined 回落默认渲染；
+   * `CellRenderer`，见 `infinitable/sheet`），返回 undefined 回落默认渲染；
    * 不写模型、不进快照
    */
   resolveCellRenderer?: ResolveCellRenderer
@@ -63,10 +64,20 @@ export interface SheetProps {
    */
   colResize?: boolean
   /**
-   * 画布滚动条（透传 SheetGrid → 引擎内建）：内容溢出的轴在画布右/下缘绘制滚动条
-   * （可拖拽 / 点按跳转）；缺省 true。变化触发网格重建（构造期选项）
+   * 滚动条（透传 SheetGrid → 引擎内建，构造期选项）：false 整体关闭（不显示任何
+   * 滚动条）；缺省原生档 `{ mode: 'native' }`——浏览器原生滚动条在独立 gutter
+   * 渲染、不遮挡最底行/最右列；true 与对象形态按引擎语义透传（对象可配
+   * `mode: 'canvas'` 回画布悬浮滚动条，及 visibility / hideDelay / reserve 等
+   * canvas 档显示策略）。对象形态引用更替触发网格重建——沿用 header / editors
+   * 的稳定引用约定，宿主勿在模板内联对象字面量
+   */
+  scrollbar?: boolean | ScrollbarOptions
+  /**
+   * 滚动近端动态增长（透传 SheetGrid，构造期选项）：滚动缓冲末端触到当前行列数
+   * 时模型与引擎同步扩容（引擎缺省 true）；false 为固定尺寸网格——内容定尺寸的
+   * 报表 / 表单宿主置 false 后不再滚入空白增长区。变化触发网格重建
    */
-  scrollbar?: boolean
+  growOnScroll?: boolean
 }
 
 export interface SheetEmits {