@veltra/sheet 2.8.0 → 3.0.0

package/dist/components/sheet/formula-bar.js

@@ -2,7 +2,7 @@ import _sfc_main$1 from "./formula-suggest-list.js";
 import { applySuggest, filterFormulaSuggestions, getSuggestContext, moveSuggestIndex } from "./use-formula-suggest.js";
 import _sfc_main$2 from "./popups/functions-popup.js";
 import { insertRefText, isRefSelectContext } from "./use-formula-ref-select.js";
-import { formatAddress, formatRange, parseRange } from "@veltra/sheet-core/core/address.js";
+import { formatAddress, formatRange, parseRange } from "infinitable/sheet";
 import { computed, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, nextTick, normalizeClass, onBeforeUnmount, onMounted, openBlock, ref, shallowRef, unref, useTemplateRef, vModelText, watch, withCtx, withDirectives, withModifiers } from "vue";
 import { UDropdown, message } from "@veltra/desktop";
 import { bem } from "@veltra/utils";

package/dist/components/sheet/import-file.js

@@ -1,6 +1,6 @@
+import { importCsv, importXlsx, replaceWorkbookWithSnapshots } from "infinitable/sheet";
 import { message, messageConfirm } from "@veltra/desktop";
 import { nextFrame } from "@veltra/utils";
-import { importCsv, importXlsx, replaceWorkbookWithSnapshots } from "@veltra/sheet-core/core/io/import.js";
 //#region src/components/sheet/import-file.ts
 /** 导入文件 accept（工具栏直接选文件） */
 const IMPORT_FILE_ACCEPT = ".xlsx,.csv";

package/dist/components/sheet/insert-image.js

@@ -18,7 +18,7 @@ const EXT_TO_TYPE = {
 	svg: "svg",
 	webp: "webp"
 };
-/** MIME → sheet-core 图片类型（core/image 的 SheetImageType）；MIME 为空时回落扩展名 */
+/** MIME → 引擎图片类型（SheetImageType）；MIME 为空时回落扩展名 */
 function resolveImageType(file) {
 	const mime = file.type.trim().toLowerCase();
 	if (mime && MIME_TO_TYPE[mime]) return MIME_TO_TYPE[mime];

package/dist/components/sheet/popup-helpers.js

@@ -1,4 +1,4 @@
-import { BORDER_STYLE_WIDTH } from "@veltra/sheet-core/core/style/types.js";
+import { BORDER_STYLE_WIDTH } from "infinitable/sheet";
 //#region src/components/sheet/popup-helpers.ts
 /** 当前选区（ranges[0] 优先；无区域选区时用活动格单格） */
 function currentRange(context) {

package/dist/components/sheet/popups/border-popup.js

@@ -1,10 +1,9 @@
 import { BORDER_LINE_STYLES, BORDER_LINE_TITLES, BORDER_PRESETS, currentRange, lineSwatchStyle } from "../popup-helpers.js";
 import _sfc_main$1 from "./border-preset-glyph.js";
+import { BORDER_STYLE_WIDTH, buildBorderPresetItems } from "infinitable/sheet";
 import { Fragment, createElementBlock, createElementVNode, createVNode, defineComponent, normalizeClass, normalizeStyle, openBlock, ref, renderList, unref } from "vue";
 import { UPalette } from "@veltra/desktop";
 import { bem } from "@veltra/utils";
-import { buildBorderPresetItems } from "@veltra/sheet-core/core/style/border-presets.js";
-import { BORDER_STYLE_WIDTH } from "@veltra/sheet-core/core/style/types.js";
 //#region src/components/sheet/popups/border-popup.vue
 const _hoisted_1 = ["title", "onClick"];
 const _hoisted_2 = ["title", "onClick"];

package/dist/components/sheet/popups/functions-popup.js

@@ -1,8 +1,8 @@
-import { COMMON_FORMULA_NAMES, FUNCTION_POPUP_CATEGORIES, formatFunctionSignature, moveSuggestIndex } from "../use-formula-suggest.js";
+import { COMMON_FORMULA_NAMES, FUNCTION_POPUP_CATEGORIES, moveSuggestIndex } from "../use-formula-suggest.js";
 import { Fragment, computed, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, normalizeClass, onMounted, openBlock, ref, renderList, toDisplayString, unref, useTemplateRef, watch, withCtx } from "vue";
 import { UInput, UScroll } from "@veltra/desktop";
 import { bem } from "@veltra/utils";
-import { listFormulaFunctions } from "@veltra/sheet-core/core/formula/functions.js";
+import { listFormulaFunctions } from "infinitable";
 //#region src/components/sheet/popups/functions-popup.vue
 const _hoisted_1 = ["onClick"];
 const _hoisted_2 = ["onClick", "onMouseenter"];
@@ -99,7 +99,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 							class: normalizeClass([unref(cls).e("functions-item"), unref(bem).is("active", index === activeIndex.value)]),
 							onClick: ($event) => emit("select", fn.name),
 							onMouseenter: ($event) => activeIndex.value = index
-						}, [createElementVNode("span", { class: normalizeClass(unref(cls).e("functions-signature")) }, toDisplayString(unref(formatFunctionSignature)(fn.name, fn.params)), 3), fn.description ? (openBlock(), createElementBlock("span", {
+						}, [createElementVNode("span", { class: normalizeClass(unref(cls).e("functions-signature")) }, toDisplayString(fn.signature), 3), fn.description ? (openBlock(), createElementBlock("span", {
 							key: 0,
 							class: normalizeClass(unref(cls).e("functions-description"))
 						}, toDisplayString(fn.description), 3)) : createCommentVNode("v-if", true)], 42, _hoisted_2);

package/dist/components/sheet/popups/import.worker.d.ts

@@ -1,4 +1,4 @@
-import { SheetSnapshot } from "@veltra/sheet-core/core/sheet.js";
+import { SheetSnapshot } from "infinitable/sheet";
 //#region src/components/sheet/popups/import.worker.d.ts
 export type ImportWorkerResponse = {
   type: 'progress';

package/dist/components/sheet/popups/import.worker.js

@@ -3,7 +3,7 @@ self.onmessage = (e) => {
 	const { buffer } = e.data;
 	(async () => {
 		try {
-			const { importXlsx } = await import("@veltra/sheet-core/core/io/import.js");
+			const { importXlsx } = await import("infinitable/sheet");
 			let lastPercent = -1;
 			const wb = await importXlsx(new Uint8Array(buffer), (done, total) => {
 				const percent = total > 0 ? Math.floor(done / total * 10) : 10;

package/dist/components/sheet/sheet-context-menu.js

@@ -1,7 +1,7 @@
 import { defaultToolRegistry } from "../../tools/registry.js";
 import { pickAndInsertImage } from "./insert-image.js";
 import _sfc_main from "./insert-count-menu-item.js";
-import { createRange } from "@veltra/sheet-core/core/address.js";
+import { createRange } from "infinitable/sheet";
 import { defineComponent, h } from "vue";
 const INSERT_COUNT_MAX = 1e3;
 /** 行高/列宽数值项输入上限（下限复用门面 MIN_ROW_COL_SIZE，对齐引擎 resize 最小值） */
@@ -204,7 +204,7 @@ function buildColHeaderMenus(ctx, options) {
 }
 /**
 * 对当前选区应用 numFmt（经 applyStyle → 命令系统，天然可 undo/redo）。
-* 仅影响显示，单元格恒存原始值（见 sheet-core `core/format.ts`）。
+* 仅影响显示，单元格恒存原始值（引擎 numFmt 显示约定）。
 */
 function applyNumFmtToSelection(ctx, numFmt) {
 	for (const range of ctx.getSelection().ranges) ctx.applyStyle(range, { numFmt });

package/dist/components/sheet/sheet.js

@@ -59,6 +59,10 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 			default: false
 		},
 		scrollbar: {
+			type: [Boolean, Object],
+			default: { mode: "native" }
+		},
+		growOnScroll: {
 			type: Boolean,
 			default: true
 		}
@@ -70,6 +74,8 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 		const cls = bem("sheet");
 		/** 根容器 ref：Ctrl/Cmd+F 判定焦点是否在本实例内（#6，避免劫持浏览器查找） */
 		const rootRef = useTemplateRef("rootRef");
+		/** 工具栏容器 ref：工具栏隐藏（showToolbar=false）时查找弹层的回退锚点（0 高贴 sheet 顶） */
+		const toolbarWrapRef = useTemplateRef("toolbarWrapRef");
 		const { workbook, activeIndex, sheetList, activeSheet, context, stateTick, syncFromWorkbook } = useSheetState(props, emit, {
 			onBeforeSheetChange: () => closePopup(),
 			rebuildGrid: () => rebuildGrid(),
@@ -77,7 +83,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 			pruneCache: (sheets) => pruneCache(sheets),
 			syncAxisSizes: (axis, indexes) => getGrid()?.applyAxisSizes(axis, indexes)
 		});
-		const { popupTool, popupAnchor, closePopup, handleToolClick: openOrRunTool } = useToolPopup(context, rootRef);
+		const { popupTool, popupAnchor, closePopup, handleToolClick: openOrRunTool } = useToolPopup(context, rootRef, () => toolbarWrapRef.value ?? null);
 		const parsing = ref(false);
 		const parseProgress = ref({
 			done: 0,
@@ -140,7 +146,11 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 				ref: rootRef,
 				class: normalizeClass(unref(cls).b)
 			}, [
-				createElementVNode("div", { class: normalizeClass(unref(cls).e("toolbar-wrap")) }, [
+				createElementVNode("div", {
+					ref_key: "toolbarWrapRef",
+					ref: toolbarWrapRef,
+					class: normalizeClass(unref(cls).e("toolbar-wrap"))
+				}, [
 					__props.showToolbar ? (openBlock(), createBlock(_sfc_main$11, {
 						key: 0,
 						groups: unref(toolGroups),

package/dist/components/sheet/use-find-replace.js

@@ -1,7 +1,6 @@
+import { findAll, findNextFrom, findPrevFrom, inferCellType, normalizeInputValue } from "infinitable/sheet";
 import { computed, ref, shallowRef, watch } from "vue";
 import { debounce } from "@cat-kit/core";
-import { inferCellType, normalizeInputValue } from "@veltra/sheet-core/core/cell-store.js";
-import { findAll, findNextFrom, findPrevFrom } from "@veltra/sheet-core/core/find.js";
 //#region src/components/sheet/use-find-replace.ts
 /**
 * 查找条逻辑（关键词 / 上一个 / 下一个 / 命中计数 / 替换）：

package/dist/components/sheet/use-formula-suggest.js

@@ -1,4 +1,4 @@
-import { listFormulaFunctions } from "@veltra/sheet-core/core/formula/functions.js";
+import { listFormulaFunctions } from "infinitable";
 /**
 * 空前缀时优先展示的常用函数（其余按名称升序补齐至上限）。
 * 纯字典序会把 SUM / OR / ROUND 挤出前 10（ABS…NOT），导致输入 `=` 看不到 SUM。
@@ -18,7 +18,7 @@ const COMMON_FORMULA_NAMES = [
 /**
 * 函数弹框分类导航固定集合（顺序即展示顺序）。
 * 「常用」「全部」是导航概念（非注册表分类）：常用 = COMMON_FORMULA_NAMES 固定清单，
-* 全部 = 全部已注册函数；其余与 sheet-core `FormulaFunctionCategory` 对应。
+* 全部 = 全部已注册函数；其余与公式注册表 `FormulaFunctionCategory` 对应。
 */
 const FUNCTION_POPUP_CATEGORIES = [
 	"常用",
@@ -115,11 +115,12 @@ function filterFormulaSuggestions(prefix) {
 	return items;
 }
 function toSuggestItem(fn) {
+	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)
 	};
 }
 /** 将 [start, end) 的 token 替换为 `NAME()`，光标入括号内（免手动补右括号） */

package/dist/components/sheet/use-sheet-grid.js

@@ -1,7 +1,7 @@
 import { buildBodyMenus, buildColHeaderMenus, buildRowHeaderMenus, ensureContextMenuSelection, resolveRenderSize } from "./sheet-context-menu.js";
+import { SheetGrid } from "infinitable/sheet";
 import { onBeforeUnmount, onMounted, watch } from "vue";
 import { contextmenu } from "@veltra/desktop";
-import { SheetGrid } from "@veltra/sheet-core/grid";
 //#region src/components/sheet/use-sheet-grid.ts
 /**
 * 缓存容量：最近 N 个 sheet 的 SheetGrid 实例常驻（tab 来回切换零重建）。
@@ -73,6 +73,7 @@ function useSheetGrid(options) {
 			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),
@@ -187,7 +188,8 @@ function useSheetGrid(options) {
 		props.header,
 		props.editors,
 		props.colResize,
-		props.scrollbar
+		props.scrollbar,
+		props.growOnScroll
 	], ([nextRows, nextCols]) => {
 		const sheet = getActiveSheet();
 		if (nextRows != null) sheet.ensureTableSize(nextRows, 0);

package/dist/components/sheet/use-sheet-state.js

@@ -1,8 +1,8 @@
 import { defaultToolRegistry } from "../../tools/registry.js";
 import { createSheetContext } from "../../tools/context.js";
 import { resolveRenderSize } from "./sheet-context-menu.js";
+import { Workbook } from "infinitable/sheet";
 import { computed, onBeforeUnmount, onMounted, ref, shallowRef, watch } from "vue";
-import { Workbook } from "@veltra/sheet-core/core/workbook.js";
 //#region src/components/sheet/use-sheet-state.ts
 /**
 * USheet 的状态源（单一数据源，其余状态由此推导）：

package/dist/components/sheet/use-tool-popup.js

@@ -20,7 +20,7 @@ function joinsTransaction(tool) {
 * 函数面板选中只进入公式栏编辑态（无直接模型写入），与查找 / 导出一样不参与事务。
 * 导入在 sheet.vue 特殊处理（直接系统文件选择），不经弹层。
 */
-function useToolPopup(context, rootEl) {
+function useToolPopup(context, rootEl, getFallbackAnchor) {
 	/** 当前打开的弹层工具（null = 未打开） */
 	const popupTool = shallowRef(null);
 	/** 触发按钮元素（打开时的 currentTarget；用于面板 left 对齐按钮） */
@@ -83,6 +83,17 @@ function useToolPopup(context, rootEl) {
 		if (!popupTool.value) return;
 		closePopup();
 	}
+	/**
+	* Ctrl/Cmd+F 的锚点解析：优先工具栏「查找与替换」按钮（与按钮入口完全同锚点，
+	* 弹层同样锚定按钮下方）；按钮不可达（showToolbar 隐藏）时回退 sheet 顶部容器。
+	*/
+	function resolveFindAnchor() {
+		const root = rootEl.value;
+		if (!root) return null;
+		const button = root.querySelector("[data-tool-id=\"find\"]");
+		if (button) return button;
+		return getFallbackAnchor?.() ?? null;
+	}
 	/** Ctrl/Cmd+F 打开 / 关闭查找条（与工具按钮同一 toggle 逻辑） */
 	function onGlobalKeydown(event) {
 		if (!(event.metaKey || event.ctrlKey) || event.key.toLowerCase() !== "f") return;
@@ -98,7 +109,7 @@ function useToolPopup(context, rootEl) {
 			closePopup();
 			return;
 		}
-		scheduleOpen(findTool);
+		scheduleOpen(findTool, resolveFindAnchor());
 	}
 	onMounted(() => {
 		window.addEventListener("click", onWindowClick);

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import _sfc_main from "./components/sheet/sheet.js";
-import { SheetContext, createSheetContext } from "./tools/context.js";
+import { SheetContext, SheetContextOptions, createSheetContext } from "./tools/context.js";
 import { SheetTool, SheetToolGroup, SheetToolPopupType, defaultToolRegistry, registerTool, unregisterTool } from "./tools/registry.js";
 import { SheetEmits, SheetExposed, SheetProps } from "./types/sheet.js";
 import "./types/index.js";
-export { type SheetContext, type SheetEmits, type SheetExposed, type SheetProps, type SheetTool, type SheetToolGroup, type SheetToolPopupType, _sfc_main as USheet, createSheetContext, defaultToolRegistry, registerTool, unregisterTool };
+export { type SheetContext, type SheetContextOptions, type SheetEmits, type SheetExposed, type SheetProps, type SheetTool, type SheetToolGroup, type SheetToolPopupType, _sfc_main as USheet, createSheetContext, defaultToolRegistry, registerTool, unregisterTool };

package/dist/tools/builtin.js

@@ -1,7 +1,7 @@
 import { registerTool } from "./registry.js";
 import { FontColor } from "@veltra/icons/colorful";
 import { AlignBottom, AlignCenter, AlignTop, Bold, Border, Download, Fill, FontSize, Italic, MergeCells, PictureRounded, Rollback, Rollfront, Search, Strikethrough, Underline, UnmergeCells, Upload, Variable, VerticalAlignCenter, VerticalAlignLeft, VerticalAlignRight, Wrap } from "@veltra/icons/normal";
-import { rangesEqual } from "@veltra/sheet-core/core/address.js";
+import { rangesEqual } from "infinitable/sheet";
 //#region src/tools/builtin.ts
 /** 取活动格所在首选区；无选区返回 null */
 function selectionRange(ctx) {

package/dist/tools/context.d.ts

@@ -1,14 +1,4 @@
-import { CellAddress, CellRange } from "@veltra/sheet-core/core/address.js";
-import { CellStyle, CellStylePatch } from "@veltra/sheet-core/core/style/types.js";
-import { CellData, CellValue } from "@veltra/sheet-core/core/cell-store.js";
-import { Workbook } from "@veltra/sheet-core/core/workbook.js";
-import { FrozenState, Sheet } from "@veltra/sheet-core/core/sheet.js";
-import { HistoryState } from "@veltra/sheet-core/core/command/history.js";
-import { ImageUpdateFields } from "@veltra/sheet-core/core/command/image.js";
-import { SetCellValueItem } from "@veltra/sheet-core/core/command/set-cell-value.js";
-import { ImageInput, SheetImage } from "@veltra/sheet-core/core/image.js";
-import { CellInfo } from "@veltra/sheet-core/core/merge-manager.js";
-import { SelectionState } from "@veltra/sheet-core/core/selection.js";
+import { CellAddress, CellData, CellInfo, CellRange, CellStyle, CellStylePatch, CellValue, FrozenState, HistoryState, ImageInput, ImageUpdateFields, SelectionState, SetCellValueItem, Sheet, SheetImage, Workbook } from "infinitable/sheet";
 //#region src/tools/context.d.ts
 /**
  * SheetContext：工具的唯一操作门面。

package/dist/tools/download.js

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

package/dist/tools/export.worker.d.ts

@@ -1,4 +1,4 @@
-import { SheetSnapshot } from "@veltra/sheet-core/core/sheet.js";
+import { SheetSnapshot } from "infinitable/sheet";
 //#region src/tools/export.worker.d.ts
 export interface ExportWorkerPayload {
   sheets: {

package/dist/tools/export.worker.js

@@ -1,6 +1,6 @@
 //#region src/tools/export.worker.ts
 self.onmessage = (e) => {
-	Promise.all([import("@veltra/sheet-core/core/io/export.js"), import("@veltra/sheet-core/core/workbook.js")]).then(([{ exportWorkbookXlsx }, { Workbook }]) => {
+	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++) {

package/dist/tools/registry.js

@@ -1,4 +1,4 @@
-import { TypedEventEmitter } from "@veltra/sheet-core/core/events.js";
+import { TypedEventEmitter } from "infinitable/sheet";
 //#region src/tools/registry.ts
 /** 缺省分组名 */
 const DEFAULT_TOOL_GROUP = "default";

package/dist/types/sheet.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veltra/sheet",
-  "version": "2.8.0",
+  "version": "3.0.0",
   "homepage": "https://github.com/cabinet-fe/ultra-ui#readme",
   "bugs": {
     "url": "https://github.com/cabinet-fe/ultra-ui/issues"
@@ -34,14 +34,13 @@
     }
   },
   "dependencies": {
-    "infinitable": "^0.1.2"
+    "infinitable": "^0.1.4"
   },
   "peerDependencies": {
     "@cat-kit/core": ">=1.2.1",
     "@cat-kit/fe": ">=1.2.1",
     "@veltra/desktop": "^1.7.14",
     "@veltra/icons": "^1.5.0",
-    "@veltra/sheet-core": "^2.5.7",
     "@veltra/styles": "^1.7.14",
     "@veltra/utils": "^1.7.14",
     "vue": ">=3.5.43"

package/src/components/sheet/__test__/canvas-mock.ts

@@ -0,0 +1,49 @@
+/**
+ * happy-dom 不实现 canvas 2d 上下文（getContext 返回 null），
+ * 这里用 Proxy 提供最小可用的 mock，让引擎渲染宿主能在无头环境
+ * 完成挂载与文本测量调用。仅用于测试（vp test setupFiles）。
+ */
+
+type Context2dMock = Record<string | symbol, unknown>
+
+function createContext2dMock(canvas: HTMLCanvasElement): Context2dMock {
+  const store: Context2dMock = { canvas }
+
+  return new Proxy(store, {
+    get(target, prop) {
+      if (prop in target) return target[prop]
+      if (prop === 'measureText') return (text: unknown) => ({ width: String(text).length * 8 })
+      if (prop === 'getImageData')
+        return () => ({ data: new Uint8ClampedArray(0), width: 0, height: 0 })
+      if (
+        prop === 'createLinearGradient' ||
+        prop === 'createRadialGradient' ||
+        prop === 'createPattern'
+      ) {
+        return () => ({ addColorStop: () => {} })
+      }
+      if (prop === 'getLineDash') return () => []
+      // 其余一律视为无操作绘制方法
+      return () => {}
+    },
+    set(target, prop, value) {
+      target[prop] = value
+      return true
+    }
+  })
+}
+
+/** 补丁 HTMLCanvasElement，使 getContext('2d') 返回可用 mock */
+export function setupCanvasMock(): void {
+  const getContext = function (this: HTMLCanvasElement, contextId: string): unknown {
+    if (contextId !== '2d') return null
+    return createContext2dMock(this)
+  }
+
+  HTMLCanvasElement.prototype.getContext =
+    getContext as unknown as typeof HTMLCanvasElement.prototype.getContext
+
+  if (typeof HTMLCanvasElement.prototype.toDataURL !== 'function') {
+    HTMLCanvasElement.prototype.toDataURL = () => 'data:,'
+  }
+}

package/src/components/sheet/__test__/find-shortcut-anchor.test.ts

@@ -0,0 +1,117 @@
+import { afterEach, describe, expect, it, vi } from 'vite-plus/test'
+import { createApp, h, nextTick, type App } from 'vue'
+
+import { USheet } from '../../../index'
+
+/** UDropdownStub 的 open 调用 trigger 记录（vi.mock 工厂提升，需 hoisted） */
+const dropdownState = vi.hoisted(() => ({
+  openTriggers: [] as Array<HTMLElement | null | undefined>
+}))
+
+// 只替换 UDropdown 为记录 open 传参的桩（断言锚定 reference），其余 desktop 组件保持真实实现
+vi.mock('@veltra/desktop', async (importActual) => {
+  const actual = await importActual<Record<string, unknown>>()
+  const { defineComponent, h } = await import('vue')
+  return {
+    ...actual,
+    UDropdown: defineComponent({
+      name: 'UDropdownStub',
+      props: ['visible', 'trigger', 'width'],
+      setup(props, { expose, slots }) {
+        expose({
+          open(config?: { trigger?: HTMLElement }) {
+            dropdownState.openTriggers.push(config?.trigger ?? null)
+          },
+          close() {}
+        })
+        return () => h('div', { class: 'dropdown-stub' }, props.visible ? slots.content?.() : null)
+      }
+    })
+  }
+})
+
+const apps: App[] = []
+const containers: HTMLElement[] = []
+
+function mount(props: () => Record<string, unknown> = () => ({})) {
+  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()) })
+  app.mount(el)
+  apps.push(app)
+  return { el }
+}
+
+/** 等待 scheduleOpen 的 setTimeout(0) 宏任务（避免同次事件冒泡误关）+ 渲染 */
+async function flushPopup(): Promise<void> {
+  await nextTick()
+  await new Promise((resolve) => setTimeout(resolve, 0))
+  await nextTick()
+}
+
+/** 聚焦 grid（事件源在实例容器内）派发 Ctrl+F，冒泡到 window 的 onGlobalKeydown */
+function pressCtrlF(el: HTMLElement): KeyboardEvent {
+  const grid = el.querySelector<HTMLElement>('.u-sheet__grid')!
+  const event = new KeyboardEvent('keydown', {
+    key: 'f',
+    ctrlKey: true,
+    bubbles: true,
+    cancelable: true
+  })
+  grid.dispatchEvent(event)
+  return event
+}
+
+function lastOpenTrigger(): HTMLElement | null | undefined {
+  return dropdownState.openTriggers[dropdownState.openTriggers.length - 1]
+}
+
+afterEach(() => {
+  while (apps.length) apps.pop()!.unmount()
+  while (containers.length) containers.pop()!.remove()
+  dropdownState.openTriggers.length = 0
+})
+
+describe('Ctrl+F 查找弹窗锚定', () => {
+  it('工具栏可见：聚焦 grid 按 Ctrl+F 打开，锚定「查找与替换」按钮（与按钮入口同锚点）；再按关闭', async () => {
+    const { el } = mount()
+    await nextTick()
+
+    const event = pressCtrlF(el)
+    await flushPopup()
+    // 拦截浏览器原生查找 + 查找弹层打开
+    expect(event.defaultPrevented).toBe(true)
+    expect(el.querySelector('.u-sheet__find-input')).not.toBeNull()
+    // 锚定 reference 非空且指向工具栏 find 按钮（HTMLElement，与按钮入口完全同锚点）
+    const findButton = el.querySelector<HTMLElement>('[data-tool-id="find"]')!
+    expect(findButton).not.toBeNull()
+    expect(lastOpenTrigger()).toBe(findButton)
+
+    // 再按一次 Ctrl+F：toggle 关闭（不回归）
+    pressCtrlF(el)
+    await nextTick()
+    expect(el.querySelector('.u-sheet__find-input')).toBeNull()
+  })
+
+  it('工具栏隐藏（showToolbar=false）：Ctrl+F 锚定回退 sheet 顶部容器（锚点非空且在 sheet 根内）', async () => {
+    const { el } = mount(() => ({ showToolbar: false }))
+    await nextTick()
+
+    pressCtrlF(el)
+    await flushPopup()
+    expect(el.querySelector('.u-sheet__find-input')).not.toBeNull()
+    // 锚定 reference 非空、指向 sheet 根内元素：工具栏容器（0 高贴 sheet 顶，
+    // bottom-start 定位下弹层自 sheet 左上角展开，落在 sheet 视口内而非视口原点）
+    const anchor = lastOpenTrigger()
+    expect(anchor).toBeInstanceOf(HTMLElement)
+    expect(el.contains(anchor as HTMLElement)).toBe(true)
+    expect((anchor as HTMLElement).classList.contains('u-sheet__toolbar-wrap')).toBe(true)
+
+    pressCtrlF(el)
+    await nextTick()
+    expect(el.querySelector('.u-sheet__find-input')).toBeNull()
+  })
+})

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

@@ -1,6 +1,6 @@
-import { parseRange } from '@veltra/sheet-core/core/address.js'
-import { Workbook } from '@veltra/sheet-core/core/workbook.js'
-import type { SheetGrid } from '@veltra/sheet-core/grid'
+import { parseRange } from 'infinitable/sheet'
+import { Workbook } from 'infinitable/sheet'
+import type { SheetGrid } from 'infinitable/sheet'
 import { afterEach, describe, expect, it } from 'vite-plus/test'
 import { createApp, h, nextTick, type App } from 'vue'
 
@@ -8,6 +8,7 @@ import { USheet } from '../../../index'
 import { createSheetContext } from '../../../tools/context'
 import type { SheetExposed } from '../../../types'
 import UFormulaBar from '../formula-bar.vue'
+import { gridEventTarget } from './grid-test-utils'
 
 const apps: App[] = []
 const containers: HTMLElement[] = []
@@ -551,11 +552,12 @@ describe('USheet 公式栏：函数补全与引用选择', () => {
     await nextTick()
 
     // 画布数据格点选（引擎选区事件管线）→ 引用插入 + blur 挂起（引用选择）；
-    // 引用拾取为手势收敛语义（按下起手记录、抬手一次回交，见 sheet-core
-    // grid-selection），故插入断言在 pointerup 之后。pointerdown 监听绑定在
-    // 实例容器（LRU 缓存）。画布几何口径与 sheet-core grid-theme 一致
-    // （行号列 46、列头 28、列宽 80、行高 28）→ (51, 117) 命中 A4
-    const gridEl = el.querySelector('.u-sheet__grid-instance')!
+    // 引用拾取为手势收敛语义（按下起手记录、抬手一次回交，见引擎
+    // grid-selection），故插入断言在 pointerup 之后。指针事件派发到 body 层
+    // 画布（canvas 档与原生档的事件源后代，见 gridEventTarget）。画布几何口径
+    // 与引擎 grid-theme 一致（行号列 46、列头 28、列宽 80、行高 28）→
+    // (51, 117) 命中 A4
+    const gridEl = gridEventTarget(el)
     gridEl.dispatchEvent(
       new PointerEvent('pointerdown', { clientX: 51, clientY: 117, bubbles: true })
     )
@@ -576,7 +578,7 @@ describe('USheet 公式栏：函数补全与引用选择', () => {
     expect(sheet.getCellData({ row: 2, col: 0 })).toBeUndefined()
     expect(input.value).toBe('=SUM(A4')
 
-    // 网格选区拦截 → handleRefSelect 路径（引擎选区事件管线，见 sheet-core grid-selection）
+    // 网格选区拦截 → handleRefSelect 路径（引擎选区事件管线，见引擎 grid-selection）
     const { el: barEl, exposed: barExposed } = mountFormulaBar(sheet)
     await nextTick()
     setFxText(barEl, '=SUM(')