@veltra/sheet 2.0.1 → 2.1.1

package/dist/vue/use-find-replace.js

@@ -0,0 +1,161 @@
+import { computed, ref, shallowRef, watch } from "vue";
+import { debounce } from "@cat-kit/core";
+import { inferCellType, normalizeInputValue } from "@veltra/sheet-core/core/cell-store";
+import { findAll, findNextFrom, findPrevFrom } from "@veltra/sheet-core/core/find";
+//#region src/vue/use-find-replace.ts
+/**
+* 查找条逻辑（关键词 / 上一个 / 下一个 / 命中计数 / 替换）：
+* - 关键词 / 选项变化 → 重新查找并定位第一个命中
+* - Enter = 下一个、Shift+Enter = 上一个（行主序、到边界循环）
+* - 替换当前 = 一次 setCells（一个 undo 单元）；全部替换 = 一次批量 = 单 undo 单元
+* - 公式格不参与替换（写入 {v,t} 会覆盖公式原文 f，导致公式丢失）
+*/
+function useFindReplace(options) {
+	const { getSheet, context } = options;
+	const findQuery = ref("");
+	const findReplace = ref("");
+	const caseSensitive = ref(false);
+	const wholeCell = ref(false);
+	const searchIn = ref("value");
+	/** 全部命中（行主序；core/find 纯逻辑，无头可测） */
+	const findMatches = shallowRef([]);
+	/** 当前命中在 findMatches 中的下标；-1 = 无命中 */
+	const findCursor = ref(-1);
+	const canFind = computed(() => findMatches.value.length > 0);
+	const canReplace = computed(() => canFind.value && findCursor.value >= 0);
+	const findCountText = computed(() => {
+		const total = findMatches.value.length;
+		if (total === 0) return "0 / 0";
+		return `${Math.min(findCursor.value + 1, total)} / ${total}`;
+	});
+	function findOptions() {
+		return {
+			caseSensitive: caseSensitive.value,
+			wholeCell: wholeCell.value,
+			searchIn: searchIn.value
+		};
+	}
+	/** 上次全扫时的关键词 / 选项快照（识别防抖窗口内的脏缓存，见 ensureFreshMatches） */
+	let scannedQuery = "";
+	let scannedOptions = "";
+	function optionsSnapshot() {
+		return `${caseSensitive.value}|${wholeCell.value}|${searchIn.value}`;
+	}
+	/** 关键词或选项变化：重新查找并定位第一个命中（否则保持当前位置附近） */
+	function refreshFind(initial) {
+		const matches = findAll(getSheet(), findQuery.value, findOptions());
+		scannedQuery = findQuery.value;
+		scannedOptions = optionsSnapshot();
+		findMatches.value = matches;
+		if (matches.length === 0) {
+			findCursor.value = -1;
+			return;
+		}
+		if (initial) {
+			findCursor.value = 0;
+			context.selectCell(matches[0].addr);
+		} else findCursor.value = Math.min(findCursor.value, matches.length - 1);
+	}
+	/**
+	* 防抖窗口内（关键词已输入、尚未触发全扫）Enter 导航 / 替换仍持有旧关键词的
+	* 命中缓存——先同步补扫一次，保证导航与替换作用于当前输入框里的关键词
+	* （否则「全部替换」会把旧关键词的命中集批量改写，与屏幕上看到的查找词不符）
+	*/
+	function ensureFreshMatches() {
+		if (findQuery.value !== scannedQuery || optionsSnapshot() !== scannedOptions) refreshFind(false);
+	}
+	/** 定位到 findMatches 中与目标地址相同的命中（找不到则保持） */
+	function locateMatch(match) {
+		const index = findMatches.value.findIndex((item) => item.addr.row === match.addr.row && item.addr.col === match.addr.col);
+		if (index >= 0) findCursor.value = index;
+		context.selectCell(match.addr);
+	}
+	function findForward() {
+		ensureFreshMatches();
+		const matches = findMatches.value;
+		if (matches.length === 0) return;
+		const active = context.getSelection().activeCell;
+		const next = active ? findNextFrom(matches, active) : matches[0];
+		if (!next) return;
+		locateMatch(next);
+	}
+	function findPrevious() {
+		ensureFreshMatches();
+		const matches = findMatches.value;
+		if (matches.length === 0) return;
+		const active = context.getSelection().activeCell;
+		const prev = active ? findPrevFrom(matches, active) : matches[matches.length - 1];
+		if (!prev) return;
+		locateMatch(prev);
+	}
+	/** Enter = 下一个；Shift+Enter = 上一个（UInput 的 keydown 透传到外层容器，冒泡可达） */
+	function handleFindKeydown(event) {
+		if (event.key !== "Enter") return;
+		event.preventDefault();
+		if (event.shiftKey) findPrevious();
+		else findForward();
+	}
+	/** 替换文本 → CellData（空字符串 = 清除单元格；数字/布尔文本规范化后推断类型） */
+	function replaceData() {
+		if (findReplace.value === "") return void 0;
+		const normalized = normalizeInputValue(findReplace.value);
+		const t = inferCellType(normalized);
+		return t ? {
+			v: normalized,
+			t
+		} : { v: normalized };
+	}
+	/** 公式格不参与替换（写入 {v,t} 会覆盖公式原文 f，导致公式丢失） */
+	function isReplaceable(match) {
+		return !context.getCellData(match.addr)?.f;
+	}
+	/** 替换当前命中格（一次 setCells = 一个 undo 单元）；替换后重新查找 */
+	function replaceCurrent() {
+		ensureFreshMatches();
+		const match = findMatches.value[findCursor.value];
+		if (!match || !isReplaceable(match)) return;
+		context.setCells([{
+			addr: match.addr,
+			data: replaceData()
+		}]);
+		refreshFind(false);
+	}
+	/** 全部替换（一次 setCells 批量 = 单 undo 单元，undo 一次全部还原）；公式格自动跳过 */
+	function replaceAll() {
+		ensureFreshMatches();
+		const matches = findMatches.value.filter(isReplaceable);
+		if (matches.length === 0) return;
+		context.setCells(matches.map((match) => ({
+			addr: match.addr,
+			data: replaceData()
+		})));
+		refreshFind(false);
+	}
+	const refreshFindDebounced = debounce(() => {
+		if (findQuery.value === scannedQuery && optionsSnapshot() === scannedOptions) return;
+		refreshFind(true);
+	}, 300, false);
+	watch([
+		findQuery,
+		caseSensitive,
+		wholeCell,
+		searchIn
+	], refreshFindDebounced);
+	return {
+		findQuery,
+		findReplace,
+		caseSensitive,
+		wholeCell,
+		searchIn,
+		canFind,
+		canReplace,
+		findCountText,
+		findForward,
+		findPrevious,
+		handleFindKeydown,
+		replaceCurrent,
+		replaceAll
+	};
+}
+//#endregion
+export { useFindReplace };

package/dist/vue/use-formula-ref-select.js

@@ -0,0 +1,37 @@
+//#region src/vue/use-formula-ref-select.ts
+/** 引用选择上下文：光标前一个非空字符属于此集合时可插入单元格引用 */
+const REF_TRIGGER_CHARS = /* @__PURE__ */ new Set([
+	"=",
+	"(",
+	",",
+	"+",
+	"-",
+	"*",
+	"/",
+	"^",
+	"&",
+	"<",
+	">"
+]);
+/**
+* 判定是否处于「可插入引用」位置（无状态：每次按文本 + 光标重算）。
+* `-` 的一元/二元歧义基础版不区分（`A1-` 后框选 → `A1-B2`，合法且误判无害）。
+*/
+function isRefSelectContext(text, cursor) {
+	if (cursor < 0 || cursor > text.length) return false;
+	if (!text.startsWith("=")) return false;
+	const before = text.slice(0, cursor).replace(/\s+$/, "");
+	if (before.length === 0) return false;
+	return REF_TRIGGER_CHARS.has(before[before.length - 1]);
+}
+/** 在光标处插入引用文本（替换空选区；有选区时覆盖选区） */
+function insertRefText(text, cursor, rangeText, selectionEnd = cursor) {
+	const start = Math.min(cursor, selectionEnd);
+	const end = Math.max(cursor, selectionEnd);
+	return {
+		text: text.slice(0, start) + rangeText + text.slice(end),
+		cursor: start + rangeText.length
+	};
+}
+//#endregion
+export { insertRefText, isRefSelectContext };

package/dist/vue/use-formula-suggest.js

@@ -0,0 +1,126 @@
+import { listFormulaFunctions } from "@veltra/sheet-core/core/formula/functions";
+/**
+* 空前缀时优先展示的常用函数（其余按名称升序补齐至上限）。
+* 纯字典序会把 SUM / OR / ROUND 挤出前 10（ABS…NOT），导致输入 `=` 看不到 SUM。
+*/
+const COMMON_FORMULA_NAMES = [
+	"SUM",
+	"AVERAGE",
+	"COUNT",
+	"MAX",
+	"MIN",
+	"IF",
+	"ROUND",
+	"ABS",
+	"AND",
+	"OR"
+];
+/** 函数名 token 前合法的「触发」字符（= / 运算符 / ( / ,） */
+const SUGGEST_TRIGGER_CHARS = /* @__PURE__ */ new Set([
+	"=",
+	"(",
+	",",
+	"+",
+	"-",
+	"*",
+	"/",
+	"^",
+	"&",
+	"<",
+	">"
+]);
+/** 格式化函数签名；无 params 时仅返回名称 */
+function formatFunctionSignature(name, params) {
+	if (params.length === 0) return name;
+	return `${name}(${params.join(", ")})`;
+}
+/**
+* 判定补全上下文：光标前向匹配函数名 token（或紧跟 `=` 的空前缀），
+* 且 token 前一个非空字符 ∈ 触发字符集。
+* 镜像只读期由调用方跳过，本函数不做只读判断。
+*/
+function getSuggestContext(text, cursor) {
+	if (cursor < 0 || cursor > text.length) return null;
+	const before = text.slice(0, cursor);
+	const tokenMatch = /[A-Za-z][A-Za-z0-9_.]*$/.exec(before);
+	const prefix = tokenMatch?.[0] ?? "";
+	const start = tokenMatch ? cursor - prefix.length : cursor;
+	if (!tokenMatch) {
+		const trimmed = before.replace(/\s+$/, "");
+		if (!trimmed.endsWith("=")) return null;
+		if (trimmed.endsWith("<=") || trimmed.endsWith(">=")) return null;
+		return {
+			prefix: "",
+			start,
+			end: cursor
+		};
+	}
+	const beforeToken = before.slice(0, start).replace(/\s+$/, "");
+	if (beforeToken.length === 0) return null;
+	const last = beforeToken[beforeToken.length - 1];
+	if (!SUGGEST_TRIGGER_CHARS.has(last)) return null;
+	return {
+		prefix,
+		start,
+		end: cursor
+	};
+}
+/**
+* 前缀过滤函数表（大小写不敏感），上限 FORMULA_SUGGEST_LIMIT。
+* 空前缀：常用函数优先，其余名称升序补齐；有前缀：名称升序。
+*/
+function filterFormulaSuggestions(prefix) {
+	const upper = prefix.toUpperCase();
+	const all = listFormulaFunctions();
+	if (!upper) {
+		const byName = new Map(all.map((fn) => [fn.name, fn]));
+		const items = [];
+		const used = /* @__PURE__ */ new Set();
+		for (const name of COMMON_FORMULA_NAMES) {
+			const fn = byName.get(name);
+			if (!fn) continue;
+			items.push(toSuggestItem(fn));
+			used.add(name);
+			if (items.length >= 10) return items;
+		}
+		for (const fn of all) {
+			if (used.has(fn.name)) continue;
+			items.push(toSuggestItem(fn));
+			if (items.length >= 10) break;
+		}
+		return items;
+	}
+	const items = [];
+	for (const fn of all) {
+		if (!fn.name.startsWith(upper)) continue;
+		items.push(toSuggestItem(fn));
+		if (items.length >= 10) break;
+	}
+	return items;
+}
+function toSuggestItem(fn) {
+	return {
+		name: fn.name,
+		params: fn.params,
+		description: fn.description,
+		signature: formatFunctionSignature(fn.name, fn.params)
+	};
+}
+/** 将 [start, end) 的 token 替换为 `NAME()`，光标入括号内（免手动补右括号） */
+function applySuggest(text, start, end, name) {
+	const insert = `${name}()`;
+	return {
+		text: text.slice(0, start) + insert + text.slice(end),
+		cursor: start + name.length + 1
+	};
+}
+/**
+* 键盘导航：↑↓ 循环；返回新的高亮下标。
+* activeIndex 越界时按 0 处理。
+*/
+function moveSuggestIndex(activeIndex, length, delta) {
+	if (length <= 0) return 0;
+	return ((activeIndex % length + length) % length + delta + length) % length;
+}
+//#endregion
+export { COMMON_FORMULA_NAMES, applySuggest, filterFormulaSuggestions, formatFunctionSignature, getSuggestContext, moveSuggestIndex };

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

@@ -0,0 +1,180 @@
+import { buildBodyMenus, buildColHeaderMenus, buildRowHeaderMenus, ensureContextMenuSelection, resolveRenderSize } from "./sheet-context-menu.js";
+import { onBeforeUnmount, onMounted, watch } from "vue";
+import { contextmenu } from "@veltra/desktop";
+import { SheetGrid } from "@veltra/sheet-core/grid/sheet-grid";
+//#region src/vue/use-sheet-grid.ts
+/**
+* 缓存容量：最近 N 个 sheet 的 SheetGrid 实例常驻（tab 来回切换零重建）。
+* 大文件多 sheet 场景下切换卡顿的主因是每次重建 VTable（实例创建 + scenegraph
+* 首屏构建 ~300ms）；缓存命中时仅切换容器可见性 + 选区回驱（≈0）。
+* 每实例持有一个 canvas + scenegraph，容量即内存上限（含隐藏实例的渲染开销）。
+*/
+const GRID_CACHE_CAPACITY = 3;
+/**
+* SheetGrid 生命周期与网格右键菜单（LRU 实例缓存）：
+* - activateGrid：tab 切换入口——命中缓存 → 显示 + 模型同步（零重建）；
+*   未命中 → 新建实例入缓存，超容量淘汰最久未用（release + 移除容器）
+* - rebuildGrid：强制重建激活实例并清空缓存（structure-change / props 尺寸
+*   变化 / 工作簿切换 / 导入替换——这些场景下缓存实例的 columns / 数据源失效）
+* - 右键菜单：body / 行号 / 列头
+* - 公式栏引用选择：interceptSelection 拦截选区回写 + pointerdown 挂起 blur
+*/
+function useSheetGrid(options) {
+	const { props, gridRef, getActiveSheet, context, formulaBarRef } = options;
+	const cache = /* @__PURE__ */ new Map();
+	let active;
+	let seq = 0;
+	let detachPointerDown;
+	function handleContextMenu(info) {
+		const sheet = getActiveSheet();
+		const renderSize = resolveRenderSize(props.rows, props.cols, sheet.rows, sheet.cols);
+		ensureContextMenuSelection(context, info, renderSize);
+		const menus = info.kind === "row-header" ? buildRowHeaderMenus(context) : info.kind === "col-header" ? buildColHeaderMenus(context) : buildBodyMenus(context);
+		contextmenu.pop({
+			mousePosition: {
+				x: info.x,
+				y: info.y
+			},
+			width: "max-content",
+			menus
+		});
+	}
+	function bindGridPointerDown(container) {
+		detachPointerDown?.();
+		const onPointerDown = () => {
+			formulaBarRef.value?.beginBlurSuppress();
+		};
+		container.addEventListener("pointerdown", onPointerDown, true);
+		detachPointerDown = () => {
+			container.removeEventListener("pointerdown", onPointerDown, true);
+			detachPointerDown = void 0;
+		};
+	}
+	/** 新建实例：创建独立容器 div（absolute 堆叠于 grid 区内）并构造 SheetGrid */
+	function createGrid(sheet) {
+		const host = gridRef.value;
+		if (!host) throw new Error("useSheetGrid: grid 容器未挂载");
+		const el = document.createElement("div");
+		el.className = "u-sheet__grid-instance";
+		host.appendChild(el);
+		const grid = new SheetGrid({
+			container: el,
+			sheet,
+			rows: props.rows,
+			cols: props.cols,
+			onContextMenu: handleContextMenu,
+			onEditStart: (addr) => formulaBarRef.value?.mirrorGridEdit(addr),
+			onEditEnd: (addr) => formulaBarRef.value?.exitMirror(addr),
+			interceptSelection: () => formulaBarRef.value?.isRefSelecting() ?? false,
+			onSelectionIntercept: (range) => formulaBarRef.value?.handleRefSelect(range)
+		});
+		let dirty = false;
+		const offStructureChange = sheet.on("structure-change", () => {
+			dirty = true;
+		});
+		const release = () => {
+			offStructureChange();
+			grid.release();
+			el.remove();
+		};
+		return {
+			sheet,
+			grid,
+			el,
+			lastUsed: ++seq,
+			release,
+			get dirty() {
+				return dirty;
+			}
+		};
+	}
+	/** 切换激活实例：显示目标、隐藏其余（visibility:hidden 保持尺寸，canvas 不重建） */
+	function showOnly(target) {
+		for (const item of cache.values()) {
+			const on = item === target;
+			item.el.style.visibility = on ? "visible" : "hidden";
+			item.grid.setVisible(on);
+		}
+	}
+	/** 淘汰最久未用的缓存实例（保留激活实例） */
+	function evict() {
+		while (cache.size > GRID_CACHE_CAPACITY) {
+			let oldest;
+			for (const item of cache.values()) {
+				if (item === active) continue;
+				if (!oldest || item.lastUsed < oldest.lastUsed) oldest = item;
+			}
+			if (!oldest) break;
+			cache.delete(oldest.sheet);
+			oldest.release();
+		}
+	}
+	/** 清空全部缓存实例（workbook 切换 / 导入替换 / 渲染尺寸变化 / 结构变更） */
+	function invalidateAll() {
+		for (const item of cache.values()) item.release();
+		cache.clear();
+		active = void 0;
+		detachPointerDown?.();
+	}
+	/**
+	* tab 切换：优先复用缓存实例（零重建）。
+	* 命中时校验实例是否过期（隐藏期间程序化 structure-change——插入/删除/undo
+	* 行列——vue 层只绑定激活 sheet 的 structure-change，隐藏实例靠自持订阅标记
+	* dirty）；过期则释放重建，否则同步模型状态（选区回驱 + 冻结校正；数据/样式/
+	* 行高由实例常驻的 sheet 事件订阅持续同步，隐藏期间跨表重算等模型变更不丢）。
+	*/
+	function activateGrid() {
+		const sheet = getActiveSheet();
+		if (!gridRef.value) return;
+		const cached = cache.get(sheet);
+		if (cached && !cached.dirty) {
+			cached.lastUsed = ++seq;
+			cached.grid.syncFromModel();
+			showOnly(cached);
+			active = cached;
+			bindGridPointerDown(cached.el);
+			return;
+		}
+		if (cached) {
+			cache.delete(sheet);
+			cached.release();
+		}
+		const created = createGrid(sheet);
+		cache.set(sheet, created);
+		created.lastUsed = ++seq;
+		showOnly(created);
+		active = created;
+		bindGridPointerDown(created.el);
+		evict();
+	}
+	/**
+	* 清理已不存在的 sheet 的缓存实例（workbook 删除 sheet 后及时释放，
+	* 避免条目与事件订阅残留到容量淘汰）。
+	*/
+	function pruneCache(sheets) {
+		const alive = new Set(sheets);
+		for (const [sheet, item] of cache) {
+			if (alive.has(sheet) || item === active) continue;
+			cache.delete(sheet);
+			item.release();
+		}
+	}
+	/** 强制重建激活实例并清空缓存（structure-change / props / 工作簿替换） */
+	function rebuildGrid() {
+		invalidateAll();
+		activateGrid();
+	}
+	onMounted(activateGrid);
+	watch(() => [props.rows, props.cols], rebuildGrid);
+	onBeforeUnmount(() => {
+		invalidateAll();
+	});
+	return {
+		rebuildGrid,
+		activateGrid,
+		pruneCache,
+		getGrid: () => active?.grid
+	};
+}
+//#endregion
+export { useSheetGrid };

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

@@ -0,0 +1,122 @@
+import { defaultToolRegistry } from "../tools/registry.js";
+import { createSheetContext } from "../tools/context.js";
+import { computed, onBeforeUnmount, onMounted, ref, shallowRef, watch } from "vue";
+import { Workbook } from "@veltra/sheet-core/core/workbook";
+//#region src/vue/use-sheet-state.ts
+/**
+* USheet 的状态源（单一数据源，其余状态由此推导）：
+* - workbook（外部传入或内部自建单 sheet 工作簿）、sheetList、activeIndex、activeSheet
+* - SheetContext 工具门面（动态解析活动 sheet，tab 切换后自动指向当前 sheet）
+* - stateTick：工具 visible/disabled/active 等纯函数的状态源版本号（bump 触发重算）
+* - 工作簿 / 活动 sheet 的事件绑定（tab 切换、工作簿 prop 变更时重绑）
+*/
+function useSheetState(props, emit, hooks) {
+	/** 工作簿：外部传入或内部自建（单 sheet） */
+	const internalWorkbook = new Workbook();
+	const workbook = computed(() => props.workbook ?? internalWorkbook);
+	/** 激活 sheet 索引（镜像 workbook.activeSheetIndex，经事件同步） */
+	const activeIndex = ref(workbook.value.activeSheetIndex);
+	/** sheet 列表（tabs 渲染；由 sheets-change 同步） */
+	const sheetList = shallowRef(workbook.value.getSheets());
+	const activeSheet = computed(() => sheetList.value[activeIndex.value] ?? workbook.value.activeSheet);
+	/** 工具上下文：动态解析活动 sheet 与当前工作簿，tab 切换 / workbook prop 切换后自动指向最新值 */
+	const context = createSheetContext(() => activeSheet.value, () => workbook.value);
+	/** 工具栏状态版本号：visible/disabled/active 是 (ctx) => boolean 纯函数，状态源变化时 bump 触发重算 */
+	const stateTick = ref(0);
+	const bump = () => {
+		stateTick.value++;
+	};
+	let disposeSheetEvents = [];
+	/** 订阅活动 sheet 的状态源（tab 切换 / 工作簿变更时重绑） */
+	function bindSheetEvents(sheet) {
+		for (const dispose of disposeSheetEvents) dispose();
+		let tickScheduled = false;
+		const scheduleBump = () => {
+			if (tickScheduled) return;
+			tickScheduled = true;
+			queueMicrotask(() => {
+				tickScheduled = false;
+				bump();
+			});
+		};
+		disposeSheetEvents = [
+			sheet.on("selection-change", bump),
+			sheet.on("history-change", bump),
+			sheet.on("cell-change", bump),
+			sheet.on("merge-change", bump),
+			sheet.on("frozen-change", bump),
+			sheet.on("content-reset", scheduleBump),
+			sheet.on("structure-change", hooks.rebuildGrid)
+		];
+	}
+	let disposeWorkbookEvents = [];
+	function bindWorkbookEvents(wb) {
+		for (const dispose of disposeWorkbookEvents) dispose();
+		disposeWorkbookEvents = [
+			wb.on("sheets-change", ({ sheets }) => {
+				sheetList.value = sheets;
+				hooks.pruneCache?.(sheets);
+				bump();
+			}),
+			wb.on("sheet-rename", () => {
+				sheetList.value = workbook.value.getSheets();
+				bump();
+			}),
+			wb.on("active-sheet-change", ({ sheet, index }) => {
+				hooks.onBeforeSheetChange();
+				activeIndex.value = index;
+				bindSheetEvents(sheet);
+				hooks.activateGrid();
+				hooks.pruneCache?.(workbook.value.getSheets());
+				bump();
+				emit("active-sheet-change", {
+					sheet,
+					index
+				});
+			})
+		];
+	}
+	/**
+	* 工作簿内容被结构性替换后同步（如导入 xlsx 的 replaceWorkbook）：
+	* replaceWorkbook 未必触发 active-sheet-change（同 index），需显式同步 tabs、
+	* 重绑 sheet 事件并重建网格。
+	*/
+	function syncFromWorkbook() {
+		sheetList.value = workbook.value.getSheets();
+		activeIndex.value = workbook.value.activeSheetIndex;
+		bindSheetEvents(activeSheet.value);
+		hooks.rebuildGrid();
+		bump();
+	}
+	const offRegistryChange = defaultToolRegistry.onChange(bump);
+	onMounted(() => {
+		bindWorkbookEvents(workbook.value);
+		bindSheetEvents(activeSheet.value);
+	});
+	watch(() => props.workbook, (wb, prev) => {
+		if (wb === prev) return;
+		hooks.onBeforeSheetChange();
+		activeIndex.value = workbook.value.activeSheetIndex;
+		sheetList.value = workbook.value.getSheets();
+		bindWorkbookEvents(workbook.value);
+		bindSheetEvents(activeSheet.value);
+		hooks.rebuildGrid();
+		bump();
+	});
+	onBeforeUnmount(() => {
+		offRegistryChange();
+		for (const dispose of disposeWorkbookEvents) dispose();
+		for (const dispose of disposeSheetEvents) dispose();
+	});
+	return {
+		workbook,
+		activeIndex,
+		sheetList,
+		activeSheet,
+		context,
+		stateTick,
+		syncFromWorkbook
+	};
+}
+//#endregion
+export { useSheetState };