@veltra/sheet 2.5.7 → 2.6.0

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

@@ -1,9 +1,10 @@
 import type { ContextmenuItem } from '@veltra/desktop'
-import { createRange, type CellAddress, type CellRange } from '@veltra/sheet-core/core/address'
-import type { NumFmt } from '@veltra/sheet-core/core/style/types'
+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 { defineComponent, h } from 'vue'
 
 import type { SheetContext } from '../../tools/context'
+import { MIN_ROW_COL_SIZE } from '../../tools/context'
 import { defaultToolRegistry } from '../../tools/registry'
 import InsertCountMenuItem from './insert-count-menu-item.vue'
 import { pickAndInsertImage } from './insert-image'
@@ -16,6 +17,13 @@ export const INSERT_COUNT_MAX = 1000
 export const DECIMAL_PLACES_MIN = 0
 export const DECIMAL_PLACES_MAX = 10
 
+/** 行高/列宽数值项输入上限（下限复用门面 MIN_ROW_COL_SIZE，对齐引擎 resize 最小值） */
+export const AXIS_SIZE_MAX = 1000
+
+/** 数值项默认值回落：未设置自定义尺寸时展示引擎默认行高/列宽（对齐 sheet-core grid-theme） */
+export const FALLBACK_ROW_HEIGHT = 28
+export const FALLBACK_COL_WIDTH = 80
+
 /** 选区覆盖行/列数 → 插入默认 N（min 1 / max 1000） */
 export function defaultInsertCount(range: CellRange | null, axis: 'row' | 'col'): number {
   if (!range) return INSERT_COUNT_MIN
@@ -94,12 +102,46 @@ function insertCountRender(options: {
   return menuNumberRender({ ...options, min: INSERT_COUNT_MIN, max: INSERT_COUNT_MAX })
 }
 
+/** 行号/列头菜单选项（readonly 时尺寸项禁用） */
+export interface HeaderMenuOptions {
+  /** 只读模式：行高/列宽项禁用（尺寸写入属编辑操作） */
+  readonly?: boolean
+}
+
+/**
+ * 行高/列宽菜单项：内嵌数值输入，确认经门面批量应用到选区覆盖行/列。
+ * readonly 时降级为禁用文本项——render 内嵌组件自带点击路径，disabled 拦不住。
+ */
+function axisSizeMenuItem(options: {
+  label: string
+  disabled: boolean
+  defaultValue: number
+  onConfirm: (n: number) => void
+}): ContextmenuItem {
+  if (options.disabled) return { label: options.label, disabled: true }
+  return {
+    label: options.label,
+    keepOpen: true,
+    render: menuNumberRender({
+      prefix: options.label,
+      suffix: '像素',
+      defaultValue: options.defaultValue,
+      min: MIN_ROW_COL_SIZE,
+      max: AXIS_SIZE_MAX,
+      onConfirm: options.onConfirm
+    })
+  }
+}
+
 function primaryRange(ctx: SheetContext): CellRange | null {
   return ctx.getSelection().ranges[0] ?? null
 }
 
-/** 行号右键菜单：插入×2 / 删除 / divider / 冻结 / 取消冻结 */
-export function buildRowHeaderMenus(ctx: SheetContext): ContextmenuItem[] {
+/** 行号右键菜单：插入×2 / 删除 / 行高 / divider / 冻结 / 取消冻结 */
+export function buildRowHeaderMenus(
+  ctx: SheetContext,
+  options?: HeaderMenuOptions
+): ContextmenuItem[] {
   const range = primaryRange(ctx)
   const startRow = range?.start.row ?? 0
   const endRow = range?.end.row ?? startRow
@@ -130,6 +172,12 @@ export function buildRowHeaderMenus(ctx: SheetContext): ContextmenuItem[] {
       })
     },
     { label: '删除行', callback: () => ctx.deleteRows(startRow, deleteCount) },
+    axisSizeMenuItem({
+      label: '行高',
+      disabled: options?.readonly === true,
+      defaultValue: ctx.getRowHeight(startRow) ?? FALLBACK_ROW_HEIGHT,
+      onConfirm: (n) => ctx.setRowHeightBySelection(n)
+    }),
     { divider: true },
     {
       label: freezeActive ? '✓ 冻结到当前行' : '冻结到当前行',
@@ -143,8 +191,11 @@ export function buildRowHeaderMenus(ctx: SheetContext): ContextmenuItem[] {
   ]
 }
 
-/** 列头右键菜单：插入×2 / 删除 / divider / 冻结 / 取消冻结 */
-export function buildColHeaderMenus(ctx: SheetContext): ContextmenuItem[] {
+/** 列头右键菜单：插入×2 / 删除 / 列宽 / divider / 冻结 / 取消冻结 */
+export function buildColHeaderMenus(
+  ctx: SheetContext,
+  options?: HeaderMenuOptions
+): ContextmenuItem[] {
   const range = primaryRange(ctx)
   const startCol = range?.start.col ?? 0
   const endCol = range?.end.col ?? startCol
@@ -175,6 +226,12 @@ export function buildColHeaderMenus(ctx: SheetContext): ContextmenuItem[] {
       })
     },
     { label: '删除列', callback: () => ctx.deleteCols(startCol, deleteCount) },
+    axisSizeMenuItem({
+      label: '列宽',
+      disabled: options?.readonly === true,
+      defaultValue: ctx.getColWidth(startCol) ?? FALLBACK_COL_WIDTH,
+      onConfirm: (n) => ctx.setColWidthBySelection(n)
+    }),
     { divider: true },
     {
       label: freezeActive ? '✓ 冻结到当前列' : '冻结到当前列',

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

@@ -54,8 +54,8 @@
 <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'
-import type { Workbook } from '@veltra/sheet-core/core/workbook'
+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 { nextTick, ref, toRef, useTemplateRef } from 'vue'
 

package/src/components/sheet/sheet.vue

@@ -56,6 +56,7 @@
       ref="formulaBarRef"
       :sheet="activeSheet"
       :context="context"
+      :set-selection-anchor="setSelectionAnchor"
     />
 
     <div ref="gridRef" :class="cls.e('grid')">
@@ -129,7 +130,9 @@ const { workbook, activeIndex, sheetList, activeSheet, context, stateTick, syncF
     onBeforeSheetChange: () => closePopup(),
     rebuildGrid: () => rebuildGrid(),
     activateGrid: () => activateGrid(),
-    pruneCache: (sheets) => pruneCache(sheets)
+    pruneCache: (sheets) => pruneCache(sheets),
+    // 行高/列宽菜单确认 → 活动 grid 引擎尺寸即时生效（getGrid 声明于下方，事件时才求值）
+    syncAxisSizes: (axis, indexes) => getGrid()?.applyAxisSizes(axis, indexes)
   })
 
 // ─── 弹层型工具编排（打开 / 关闭 / 面板事务）─────────────────────
@@ -205,7 +208,7 @@ const toolGroups = useToolGroups(context, stateTick)
 const gridRef = useTemplateRef<HTMLElement>('gridRef')
 const formulaBarRef = useTemplateRef<InstanceType<typeof UFormulaBar>>('formulaBarRef')
 
-const { rebuildGrid, activateGrid, pruneCache, getGrid } = useSheetGrid({
+const { rebuildGrid, activateGrid, pruneCache, getGrid, setSelectionAnchor } = useSheetGrid({
   props,
   gridRef,
   getActiveSheet: () => activeSheet.value,

package/src/components/sheet/style.scss

@@ -147,7 +147,7 @@
     gap: fn.use-var(gap, small);
     padding: fn.use-var(gap, small);
     border-bottom: 1px solid fn.use-var(border, muted-color);
-    // 浮起的 fx 输入面板 / 候选列表需盖住下方 grid 与浮动图片叠层（image-layer z-index:1）
+    // 浮起的 fx 输入面板 / 候选列表需盖住下方 grid 与浮动图片叠层（引擎画布分层 z 序）
     position: relative;
     z-index: 30;
   }
@@ -717,7 +717,7 @@
   }
 
   /* LRU 缓存实例容器：absolute 堆叠于 grid 区，非激活实例 visibility:hidden
-     （保持尺寸不触发 VTable resize，切回仅翻转可见性 + 选区回驱） */
+     （保持尺寸不触发引擎表格 resize，切回仅翻转可见性 + 选区回驱） */
   @include m.e(grid-instance) {
     position: absolute;
     inset: 0;

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

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

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

@@ -1,7 +1,7 @@
 import {
   listFormulaFunctions,
   type FormulaFunctionMeta
-} from '@veltra/sheet-core/core/formula/functions'
+} from '@veltra/sheet-core/core/formula/functions.js'
 
 /** 补全候选上限 */
 export const FORMULA_SUGGEST_LIMIT = 10

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

@@ -1,6 +1,6 @@
 import { contextmenu } from '@veltra/desktop'
-import type { CellAddress, CellRange } from '@veltra/sheet-core/core/address'
-import type { Sheet } from '@veltra/sheet-core/core/sheet'
+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 { onBeforeUnmount, onMounted, watch } from 'vue'
 
@@ -55,9 +55,9 @@ interface CachedGrid {
 
 /**
  * 缓存容量：最近 N 个 sheet 的 SheetGrid 实例常驻（tab 来回切换零重建）。
- * 大文件多 sheet 场景下切换卡顿的主因是每次重建 VTable（实例创建 + scenegraph
+ * 大文件多 sheet 场景下切换卡顿的主因是每次重建引擎表格（实例创建 + 画布分层
  * 首屏构建 ~300ms）；缓存命中时仅切换容器可见性 + 选区回驱（≈0）。
- * 每实例持有一个 canvas + scenegraph，容量即内存上限（含隐藏实例的渲染开销）。
+ * 每实例持有一组 [data-layer-kind] 分层画布，容量即内存上限（含隐藏实例的渲染开销）。
  */
 const GRID_CACHE_CAPACITY = 3
 
@@ -84,9 +84,9 @@ export function useSheetGrid(options: UseSheetGridOptions) {
 
     const menus =
       info.kind === 'row-header'
-        ? buildRowHeaderMenus(context)
+        ? buildRowHeaderMenus(context, { readonly: props.readonly })
         : info.kind === 'col-header'
-          ? buildColHeaderMenus(context)
+          ? buildColHeaderMenus(context, { readonly: props.readonly })
           : buildBodyMenus(context)
 
     // 最小宽度兜底；实际宽度由最长菜单项撑开（勿固定 240 导致空白过大）
@@ -126,6 +126,8 @@ export function useSheetGrid(options: UseSheetGridOptions) {
       resolveDisplayValue: props.resolveDisplayValue,
       resolveCellStyle: props.resolveCellStyle,
       resolveCellRenderer: props.resolveCellRenderer,
+      header: props.header,
+      editors: props.editors,
       onContextMenu: handleContextMenu,
       onEditStart: (addr) => formulaBarRef.value?.mirrorGridEdit(addr),
       onEditEnd: (addr) => formulaBarRef.value?.exitMirror(addr),
@@ -198,13 +200,18 @@ export function useSheetGrid(options: UseSheetGridOptions) {
    * 命中时校验实例是否过期（隐藏期间程序化 structure-change——插入/删除/undo
    * 行列——vue 层只绑定激活 sheet 的 structure-change，隐藏实例靠自持订阅标记
    * dirty）；过期则释放重建。命中且未过期只翻可见性：隐藏实例的 cell/merge/
-   * content-reset 已在 GridSyncManager 置脏，setVisible(true) 时一次性 flush，
-   * 不必每次切 tab 都 syncFromModel（会重放全部列宽）。
+   * content-reset 已在 SheetGrid 内部置脏，setVisible(true) 时一次性全量同步，
+   * 无需宿主补推送。
    */
   function activateGrid(): void {
     const sheet = getActiveSheet()
     const host = gridRef.value
     if (!host) return
+    // 换实例前清旧实例的选区锚点：fx 编辑会话随切 sheet 结束（公式栏同步复位
+    // 编辑态），缓存实例复用时不得残留上次会话的高亮
+    if (active && active.sheet !== sheet) {
+      active.grid.setSelectionAnchor(null)
+    }
     const cached = cache.get(sheet)
     if (cached && !cached.dirty) {
       cached.lastUsed = ++seq
@@ -249,10 +256,20 @@ export function useSheetGrid(options: UseSheetGridOptions) {
 
   onMounted(activateGrid)
 
-  // props 尺寸显式增大时先扩张模型，再重建（删行缩小不走这条路径）
+  // props 尺寸显式增大时先扩张模型，再重建（删行缩小不走这条路径）；
+  // header / editors 按引用更替判定（机制对象构造期装配，变化即重建——宿主用
+  // computed 持稳定引用，勿在模板内联对象字面量）
   watch(
     () =>
-      [props.rows, props.cols, props.readonly, props.showRowHeader, props.showColHeader] as const,
+      [
+        props.rows,
+        props.cols,
+        props.readonly,
+        props.showRowHeader,
+        props.showColHeader,
+        props.header,
+        props.editors
+      ] as const,
     ([nextRows, nextCols]) => {
       const sheet = getActiveSheet()
       if (nextRows != null) sheet.ensureTableSize(nextRows, 0)
@@ -265,5 +282,10 @@ export function useSheetGrid(options: UseSheetGridOptions) {
     invalidateAll()
   })
 
-  return { rebuildGrid, activateGrid, pruneCache, getGrid: () => active?.grid }
+  /** fx 引用拾取会话置/清选区锚点（公式栏 → 活动实例透传；无活动实例时静默） */
+  function setSelectionAnchor(addr: CellAddress | null): void {
+    active?.grid.setSelectionAnchor(addr)
+  }
+
+  return { rebuildGrid, activateGrid, pruneCache, getGrid: () => active?.grid, setSelectionAnchor }
 }

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

@@ -1,5 +1,5 @@
-import type { Sheet } from '@veltra/sheet-core/core/sheet'
-import { Workbook } from '@veltra/sheet-core/core/workbook'
+import type { Sheet } from '@veltra/sheet-core/core/sheet.js'
+import { Workbook } from '@veltra/sheet-core/core/workbook.js'
 import { computed, onBeforeUnmount, onMounted, ref, shallowRef, watch } from 'vue'
 
 import { createSheetContext } from '../../tools/context'
@@ -21,6 +21,8 @@ export interface SheetStateHooks {
   activateGrid: () => void
   /** sheet 列表变化（增删）后清理已删除 sheet 的缓存实例 */
   pruneCache?: (sheets: ReadonlyArray<Sheet>) => void
+  /** 行列尺寸经门面写模型后同步活动 grid 引擎 table（菜单数值项画面即时生效） */
+  syncAxisSizes: (axis: 'row' | 'col', indexes: number[]) => void
 }
 
 type Emit = (event: 'active-sheet-change', payload: { sheet: Sheet; index: number }) => void
@@ -51,7 +53,9 @@ export function useSheetState(props: SheetProps, emit: Emit, hooks: SheetStateHo
     () => workbook.value,
     {
       resolveGridSize: () =>
-        resolveRenderSize(props.rows, props.cols, activeSheet.value.rows, activeSheet.value.cols)
+        resolveRenderSize(props.rows, props.cols, activeSheet.value.rows, activeSheet.value.cols),
+      // 行高/列宽菜单写入模型后同步活动 grid 引擎尺寸（Sheet 尺寸 API 不发事件）
+      syncAxisSizes: (axis, indexes) => hooks.syncAxisSizes(axis, indexes)
     }
   )
 

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

@@ -107,15 +107,16 @@ export function useToolPopup(context: SheetContext, rootEl: ElRef) {
   /** Ctrl/Cmd+F 打开 / 关闭查找条（与工具按钮同一 toggle 逻辑） */
   function onGlobalKeydown(event: KeyboardEvent): void {
     if (!(event.metaKey || event.ctrlKey) || event.key.toLowerCase() !== 'f') return
-    // 仅当焦点/事件源落在本实例容器内才响应（#6）：容器外不得 preventDefault，
+    // 仅当事件源落在本实例容器内才响应（#6）：容器外不得 preventDefault，
     // 否则劫持浏览器原生查找（页面任意位置按 Ctrl+F 都被屏蔽）；同页多实例
     // 也各只响应自己容器内的按键，不再每个实例都弹出查找条
     const root = rootEl.value
     if (root) {
+      // 只认事件源：真实键盘事件 target 恒为焦点元素；activeElement 兜底会把
+      // 「容器程序化聚焦后（SheetGrid 挂载即聚焦）的异源合成按键」误判为本实例
+      // 按键，重新劫持容器外的浏览器查找
       const target = event.target instanceof Node ? event.target : null
-      const active = document.activeElement instanceof Node ? document.activeElement : null
-      const inside =
-        (target !== null && root.contains(target)) || (active !== null && root.contains(active))
+      const inside = target !== null && root.contains(target)
       // 例外：弹层 Teleport 到 body 级 #pop-container（不在 root 内），本实例弹层
       // 打开期间焦点在弹层输入框里（如查找条内再按 Ctrl+F）——同样视为本实例的
       // 按键，否则查找条无法 toggle 关闭，且放行浏览器原生查找盖在上面。

package/src/index.ts

@@ -11,6 +11,6 @@ export {
   type SheetToolGroup
 } from './tools/registry'
 
-export { type SheetProps, type SheetEmits, type _SheetExposed, type SheetExposed } from './types'
+export { type SheetProps, type SheetEmits, type SheetExposed } from './types'
 
 export { USheet } from './components/sheet'

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

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

@@ -1,9 +1,9 @@
-import { createRange } from '@veltra/sheet-core/core/address'
+import { createRange } from '@veltra/sheet-core/core/address.js'
 
 import '../builtin'
-import { Sheet } from '@veltra/sheet-core/core/sheet'
-import { Workbook } from '@veltra/sheet-core/core/workbook'
-import { describe, expect, it, vi } from 'vitest'
+import { Sheet } from '@veltra/sheet-core/core/sheet.js'
+import { Workbook } from '@veltra/sheet-core/core/workbook.js'
+import { describe, expect, it, vi } from 'vite-plus/test'
 
 import { createSheetContext } from '../context'
 import { exportSheetCsvFile, exportWorkbookFile } from '../download'

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

@@ -1,8 +1,8 @@
-import { createRange } from '@veltra/sheet-core/core/address'
-import { Sheet } from '@veltra/sheet-core/core/sheet'
-import { describe, expect, it, vi } from 'vitest'
+import { createRange } from '@veltra/sheet-core/core/address.js'
+import { Sheet } from '@veltra/sheet-core/core/sheet.js'
+import { describe, expect, it, vi } from 'vite-plus/test'
 
-import { createSheetContext } from '../context'
+import { createSheetContext, MIN_ROW_COL_SIZE } from '../context'
 import type { SheetTool } from '../registry'
 
 describe('SheetContext', () => {
@@ -180,6 +180,70 @@ describe('SheetContext', () => {
     expect(sheet.getCellData({ row: 0, col: 0 })).toEqual({ v: 'keep', t: 's' })
   })
 
+  it('行列尺寸门面：读取 + 按选区覆盖行/列批量应用，不进 undo', () => {
+    const sheet = new Sheet()
+    const ctx = createSheetContext(sheet)
+
+    // 未设置自定义尺寸时读取为 undefined（视图层用默认行高/列宽）
+    expect(ctx.getRowHeight(1)).toBeUndefined()
+    expect(ctx.getColWidth(2)).toBeUndefined()
+
+    ctx.selectRange(createRange({ row: 1, col: 2 }, { row: 3, col: 4 }))
+    ctx.setRowHeightBySelection(40)
+    ctx.setColWidthBySelection(120)
+    // 选区覆盖行 1..3 全部生效，行 0 不受影响
+    expect(ctx.getRowHeight(1)).toBe(40)
+    expect(ctx.getRowHeight(2)).toBe(40)
+    expect(ctx.getRowHeight(3)).toBe(40)
+    expect(ctx.getRowHeight(0)).toBeUndefined()
+    // 选区覆盖列 2..4 全部生效，列 5 不受影响
+    expect(ctx.getColWidth(2)).toBe(120)
+    expect(ctx.getColWidth(3)).toBe(120)
+    expect(ctx.getColWidth(4)).toBe(120)
+    expect(ctx.getColWidth(5)).toBeUndefined()
+
+    // 同 rowHeights/冻结先例：尺寸写入不进 undo 历史
+    expect(ctx.canUndo).toBe(false)
+  })
+
+  it('行列尺寸门面：下限钳制到引擎最小值 20；空选区无操作', () => {
+    const sheet = new Sheet()
+    const ctx = createSheetContext(sheet)
+
+    ctx.selectRange(createRange({ row: 2, col: 3 }, { row: 2, col: 4 }))
+    ctx.setRowHeightBySelection(10)
+    ctx.setColWidthBySelection(5)
+    expect(ctx.getRowHeight(2)).toBe(MIN_ROW_COL_SIZE)
+    expect(ctx.getColWidth(3)).toBe(MIN_ROW_COL_SIZE)
+    expect(ctx.getColWidth(4)).toBe(MIN_ROW_COL_SIZE)
+
+    // 空选区：无写入目标，不产生任何尺寸
+    sheet.selection.clear()
+    ctx.setRowHeightBySelection(60)
+    ctx.setColWidthBySelection(200)
+    expect(ctx.getRowHeight(0)).toBeUndefined()
+    expect(ctx.getColWidth(0)).toBeUndefined()
+  })
+
+  it('行列尺寸门面：写入后经 syncAxisSizes 同步钩子（携带选区覆盖行/列；空选区不触发）', () => {
+    const sheet = new Sheet()
+    const syncAxisSizes = vi.fn()
+    const ctx = createSheetContext(sheet, undefined, { syncAxisSizes })
+
+    ctx.selectRange(createRange({ row: 1, col: 2 }, { row: 2, col: 3 }))
+    ctx.setRowHeightBySelection(40)
+    expect(syncAxisSizes).toHaveBeenCalledWith('row', [1, 2])
+    ctx.setColWidthBySelection(120)
+    expect(syncAxisSizes).toHaveBeenCalledWith('col', [2, 3])
+
+    // 空选区：模型无写入，同步钩子不触发
+    syncAxisSizes.mockClear()
+    sheet.selection.clear()
+    ctx.setRowHeightBySelection(60)
+    ctx.setColWidthBySelection(60)
+    expect(syncAxisSizes).not.toHaveBeenCalled()
+  })
+
   it('图片门面：insertImage / removeImage / updateImage / getImages / onImageChange，经命令可 undo', () => {
     const sheet = new Sheet()
     const ctx = createSheetContext(sheet)

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

@@ -1,4 +1,4 @@
-import { describe, expect, it, vi } from 'vitest'
+import { describe, expect, it, vi } from 'vite-plus/test'
 
 import type { SheetTool } from '../registry'
 import { DEFAULT_TOOL_GROUP, ToolRegistry } from '../registry'

package/src/tools/apply-style.ts

@@ -1,6 +1,6 @@
-import type { CellRange } from '@veltra/sheet-core/core/address'
-import type { SetAxisStyleItem } from '@veltra/sheet-core/core/command/set-axis-style'
-import type { CellStylePatch } from '@veltra/sheet-core/core/style/types'
+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'
 
 /** 样式写入目标：整行 / 整列默认样式，或逐格 */
 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'
-import type { HorizontalAlign, VerticalAlign } from '@veltra/sheet-core/core/style/types'
+import { rangesEqual } from '@veltra/sheet-core/core/address.js'
+import type { HorizontalAlign, VerticalAlign } from '@veltra/sheet-core/core/style/types.js'
 
 import type { SheetContext } from './context'
 import { registerTool } from './registry'

package/src/tools/context.ts

@@ -1,17 +1,20 @@
-import type { CellAddress, CellRange } from '@veltra/sheet-core/core/address'
-import type { CellData, CellValue } from '@veltra/sheet-core/core/cell-store'
-import type { HistoryState } from '@veltra/sheet-core/core/command/history'
-import type { ImageUpdateFields } from '@veltra/sheet-core/core/command/image'
-import type { SetCellValueItem } from '@veltra/sheet-core/core/command/set-cell-value'
-import type { ImageInput, SheetImage } from '@veltra/sheet-core/core/image'
-import type { CellInfo } from '@veltra/sheet-core/core/merge-manager'
-import type { SelectionState } from '@veltra/sheet-core/core/selection'
-import type { FrozenState, Sheet } from '@veltra/sheet-core/core/sheet'
-import type { CellStyle, CellStylePatch } from '@veltra/sheet-core/core/style/types'
-import type { Workbook } from '@veltra/sheet-core/core/workbook'
+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 { axisStyleItemsForRange, classifySelectionStyleTarget } from './apply-style'
 
+/** 行列尺寸下限：对齐引擎 resize 最小值（`MIN_ROW_HEIGHT` / `MIN_COL_WIDTH` = 20） */
+export const MIN_ROW_COL_SIZE = 20
+
 /**
  * SheetContext：工具的唯一操作门面。
  *
@@ -100,6 +103,16 @@ export interface SheetContext {
   /** 设置冻结行列数（不进 undo，同 rowHeights 先例） */
   setFrozen(rows: number, cols: number): void
 
+  // ─── 行列尺寸（模型状态，不进 undo；随快照序列化） ─────────
+  /** 读取自定义行高；未设置返回 undefined（视图层用默认行高） */
+  getRowHeight(row: number): number | undefined
+  /** 读取自定义列宽；未设置返回 undefined（视图层用默认列宽） */
+  getColWidth(col: number): number | undefined
+  /** 按选区覆盖行批量设置行高（下限钳到 MIN_ROW_COL_SIZE；不进 undo，同 rowHeights 先例） */
+  setRowHeightBySelection(height: number): void
+  /** 按选区覆盖列批量设置列宽（下限钳到 MIN_ROW_COL_SIZE；不进 undo，同 colWidths 先例） */
+  setColWidthBySelection(width: number): void
+
   // ─── 行列插入/删除（结构变更，可 undo） ──────────────────
   /** 插入 count 行到 at 行之前 */
   insertRows(at: number, count?: number): void
@@ -135,6 +148,12 @@ export interface SheetContextOptions {
    * applyStyle / clearStyle 用其判定整行/整列；缺省时不走行列默认样式。
    */
   resolveGridSize?: () => { rows: number; cols: number }
+  /**
+   * 行列尺寸写模型后的即时同步钩子：`Sheet.setRowHeight`/`setColWidth` 不发事件，
+   * 宿主经此把尺寸落到活动 SheetGrid 引擎 table（菜单数值项画面即时生效）；
+   * 缺省（无头 / 测试直挂 Sheet）时仅写模型。
+   */
+  syncAxisSizes?: (axis: 'row' | 'col', indexes: number[]) => void
 }
 
 /**
@@ -146,6 +165,7 @@ export interface SheetContextOptions {
  *   上下文始终解析到**当前**工作簿（#2：旧实现取构造时值快照，宿主切换
  *   workbook prop 后导出工具仍导出旧工作簿）
  * @param options.resolveGridSize 渲染尺寸解析器（整行/整列样式路由）
+ * @param options.syncAxisSizes 行列尺寸写模型后的即时同步钩子（USheet 接活动 grid）
  */
 export function createSheetContext(
   resolveSheet: Sheet | (() => Sheet),
@@ -156,6 +176,7 @@ export function createSheetContext(
   const resolveWorkbook =
     typeof workbook === 'function' ? workbook : workbook != null ? () => workbook : undefined
   const resolveGridSize = options?.resolveGridSize
+  const syncAxisSizes = options?.syncAxisSizes
   const resolveTarget = (range: CellRange) => {
     const size = resolveGridSize?.()
     return size ? classifySelectionStyleTarget(range, size.rows, size.cols) : 'cell'
@@ -216,6 +237,32 @@ export function createSheetContext(
       return sheet().frozen
     },
     setFrozen: (rows, cols) => sheet().setFrozen(rows, cols),
+
+    getRowHeight: (row) => sheet().getRowHeight(row),
+    getColWidth: (col) => sheet().getColWidth(col),
+    setRowHeightBySelection: (height) => {
+      const size = Math.max(MIN_ROW_COL_SIZE, height)
+      const rows: number[] = []
+      for (const range of sheet().getSelection().ranges) {
+        for (let row = range.start.row; row <= range.end.row; row++) {
+          sheet().setRowHeight(row, size)
+          rows.push(row)
+        }
+      }
+      // 写模型后即时同步活动 grid（Sheet.setRowHeight 不发事件）
+      if (rows.length > 0) syncAxisSizes?.('row', rows)
+    },
+    setColWidthBySelection: (width) => {
+      const size = Math.max(MIN_ROW_COL_SIZE, width)
+      const cols: number[] = []
+      for (const range of sheet().getSelection().ranges) {
+        for (let col = range.start.col; col <= range.end.col; col++) {
+          sheet().setColWidth(col, size)
+          cols.push(col)
+        }
+      }
+      if (cols.length > 0) syncAxisSizes?.('col', cols)
+    },
     insertRows: (at, count) => sheet().insertRows(at, count),
     insertCols: (at, count) => sheet().insertCols(at, count),
     deleteRows: (at, count) => sheet().deleteRows(at, count),

package/src/tools/download.ts

@@ -1,6 +1,6 @@
 import { saveBlob } from '@cat-kit/fe'
-import { exportSheetCsv, exportWorkbookXlsx } from '@veltra/sheet-core/core/io/export'
-import type { Workbook } from '@veltra/sheet-core/core/workbook'
+import { exportSheetCsv, exportWorkbookXlsx } from '@veltra/sheet-core/core/io/export.js'
+import type { Workbook } from '@veltra/sheet-core/core/workbook.js'
 
 import type { SheetContext } from './context'
 import type { ExportWorkerPayload, ExportWorkerResponse } from './export.worker'

package/src/tools/export.worker.ts

@@ -12,7 +12,7 @@
  * 静态 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 interface ExportWorkerPayload {
   sheets: { name: string; snapshot: SheetSnapshot }[]
@@ -27,8 +27,8 @@ export interface ExportWorkerResponse {
 
 self.onmessage = (e: MessageEvent<ExportWorkerPayload>): void => {
   void Promise.all([
-    import('@veltra/sheet-core/core/io/export'),
-    import('@veltra/sheet-core/core/workbook')
+    import('@veltra/sheet-core/core/io/export.js'),
+    import('@veltra/sheet-core/core/workbook.js')
   ])
     .then(([{ exportWorkbookXlsx }, { Workbook }]) => {
       const wb = new Workbook()

package/src/tools/registry.ts

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