@veltra/sheet 2.0.1 → 2.2.0

package/dist/components/sheet/use-sheet-tabs-bar.js

@@ -0,0 +1,90 @@
+import { nextTick, onBeforeUnmount, onMounted, shallowRef, watch } from "vue";
+import { applyWheelHorizontalScroll, computeOverflowNavState, scrollElementIntoView, scrollViewportByStep } from "@veltra/utils";
+//#region src/components/sheet/use-sheet-tabs-bar.ts
+/**
+* Sheet 底部标签栏溢出滚动（滚动几何/滚轮转横滚/元素滚入视野共享
+* @veltra/utils overflow-nav，见 #17；此处保留事件绑定与 watch 差异）：
+* - showNav / canPrev / canNext
+* - 箭头按视口宽度 ~80% 步进
+* - 活动 tab 滚入视野
+* - 纵向滚轮转横滚；触控板横滑不拦截
+* - 原生 ResizeObserver（不引入 @veltra/compositions peer）
+*/
+function useSheetTabsBar(options) {
+	const { viewportRef, listRef, sheetList, activeIndex } = options;
+	const showNav = shallowRef(false);
+	const canPrev = shallowRef(false);
+	const canNext = shallowRef(false);
+	let resizeObserver;
+	const updateNavState = () => {
+		const vp = viewportRef.value;
+		if (!vp) return;
+		const state = computeOverflowNavState(vp);
+		showNav.value = state.overflowing;
+		canPrev.value = state.canPrev;
+		canNext.value = state.canNext;
+	};
+	const scrollByStep = (dir) => {
+		const vp = viewportRef.value;
+		if (!vp) return;
+		scrollViewportByStep(vp, dir);
+	};
+	const ensureActiveVisible = () => {
+		const vp = viewportRef.value;
+		const list = listRef.value;
+		if (!vp || !list) return;
+		const index = activeIndex.value;
+		if (index < 0) return;
+		const el = list.children[index];
+		if (!el) return;
+		scrollElementIntoView(vp, el);
+	};
+	/** 鼠标滚轮（纵向）驱动水平滚动；触控板横滑（已有 deltaX）不拦截 */
+	const handleWheel = (e) => {
+		const vp = viewportRef.value;
+		if (!vp) return;
+		applyWheelHorizontalScroll(e, vp, showNav.value);
+	};
+	watch(activeIndex, async () => {
+		await nextTick();
+		ensureActiveVisible();
+		updateNavState();
+	});
+	watch(sheetList, async () => {
+		await nextTick();
+		updateNavState();
+		ensureActiveVisible();
+	}, { deep: false });
+	onMounted(() => {
+		const vp = viewportRef.value;
+		const list = listRef.value;
+		if (vp) {
+			vp.addEventListener("wheel", handleWheel, { passive: false });
+			vp.addEventListener("scroll", updateNavState, { passive: true });
+		}
+		if (typeof ResizeObserver !== "undefined") {
+			resizeObserver = new ResizeObserver(() => updateNavState());
+			if (vp) resizeObserver.observe(vp);
+			if (list) resizeObserver.observe(list);
+		}
+		updateNavState();
+		nextTick(ensureActiveVisible);
+	});
+	onBeforeUnmount(() => {
+		const vp = viewportRef.value;
+		if (vp) {
+			vp.removeEventListener("wheel", handleWheel);
+			vp.removeEventListener("scroll", updateNavState);
+		}
+		resizeObserver?.disconnect();
+		resizeObserver = void 0;
+	});
+	return {
+		showNav,
+		canPrev,
+		canNext,
+		scrollByStep
+	};
+}
+//#endregion
+export { useSheetTabsBar };

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

@@ -0,0 +1,42 @@
+import { defaultToolRegistry } from "../../tools/registry.js";
+import { computed } from "vue";
+//#region src/components/sheet/use-tool-groups.ts
+/**
+* 内置组稳定顺序：history ｜ cell ｜ text ｜ edit ｜ insert ｜ file。
+* 未列出的自定义组按注册先后排在已知组之后。
+*/
+const BUILTIN_GROUP_ORDER = [
+	"history",
+	"cell",
+	"text",
+	"edit",
+	"insert",
+	"file"
+];
+/**
+* 工具栏分组视图模型：工具的 visible/disabled/active 是 (ctx) => boolean 纯函数，
+* 依赖 stateTick 版本号（选区 / 历史 / 单元格 / 合并 / 冻结 / 注册表变化时 bump）触发重算。
+*/
+function useToolGroups(context, stateTick) {
+	return computed(() => {
+		stateTick.value;
+		const groups = defaultToolRegistry.getGroups().map((group) => ({
+			name: group.name,
+			tools: group.tools.map((tool) => ({
+				tool,
+				visible: tool.visible?.(context) ?? true,
+				disabled: tool.disabled?.(context) ?? false,
+				active: tool.active?.(context) ?? false
+			})).filter((item) => item.visible)
+		})).filter((group) => group.tools.length > 0);
+		const orderIndex = new Map(BUILTIN_GROUP_ORDER.map((name, index) => [name, index]));
+		return groups.sort((a, b) => {
+			const ai = orderIndex.get(a.name) ?? BUILTIN_GROUP_ORDER.length;
+			const bi = orderIndex.get(b.name) ?? BUILTIN_GROUP_ORDER.length;
+			if (ai !== bi) return ai - bi;
+			return 0;
+		});
+	});
+}
+//#endregion
+export { useToolGroups };

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

@@ -0,0 +1,123 @@
+import { defaultToolRegistry } from "../../tools/registry.js";
+import { onBeforeUnmount, onMounted, shallowRef } from "vue";
+//#region src/components/sheet/use-tool-popup.ts
+/**
+* 面板打开期间的写入是否合并为一个 undo 单元（关闭时提交）：
+* 填充颜色 / 边框 / 字体颜色 / 字号参与事务；查找（每次替换独立 undo）、
+* 导出（下载侧效应，无模型写入）不参与。导入无弹层，不经此路径。
+*/
+function joinsTransaction(tool) {
+	return tool.popup === "fill-color" || tool.popup === "border" || tool.popup === "font-color" || tool.popup === "font-size";
+}
+/**
+* 弹层型工具编排（填充颜色 / 边框 / 查找 / 插入图片 / 导出）：
+* - popupTool：当前打开的弹层工具（null = 未打开）
+* - popupAnchor：触发按钮元素（面板定位参照，见 sheet.vue 的 left 计算）
+* - 打开 / 关闭时的事务包裹（面板期间写入合并为一个 undo 单元，关闭时提交）
+* - 点击面板外关闭（面板内 @click.stop 不冒泡到 window）
+* - Ctrl/Cmd+F 开合查找条（与工具按钮同一 toggle 逻辑）
+* 导入在 sheet.vue 特殊处理（直接系统文件选择），不经弹层。
+*/
+function useToolPopup(context, rootEl) {
+	/** 当前打开的弹层工具（null = 未打开） */
+	const popupTool = shallowRef(null);
+	/** 触发按钮元素（打开时的 currentTarget；用于面板 left 对齐按钮） */
+	const popupAnchor = shallowRef(null);
+	/** 延迟打开定时器（#23：组件卸载后不再执行 openPopup） */
+	let openTimer = null;
+	function openPopup(tool, anchor) {
+		closePopup();
+		popupTool.value = tool;
+		popupAnchor.value = anchor ?? null;
+		if (joinsTransaction(tool)) context.beginTransaction();
+	}
+	/**
+	* 延迟到本次点击事件流结束后打开（setTimeout 宏任务，避开冒泡到 window 时
+	* onWindowClick 误关——queueMicrotask 会在事件传播中途的 microtask checkpoint
+	* 执行，面板会被同一 click 关闭）。保存 timer id，卸载/提前关闭时取消。
+	*/
+	function scheduleOpen(tool, anchor) {
+		if (openTimer !== null) clearTimeout(openTimer);
+		openTimer = setTimeout(() => {
+			openTimer = null;
+			openPopup(tool, anchor);
+		}, 0);
+	}
+	/** 关闭弹层并提交面板期间的事务（无写入则空事务，不入历史） */
+	function closePopup() {
+		if (openTimer !== null) {
+			clearTimeout(openTimer);
+			openTimer = null;
+		}
+		const tool = popupTool.value;
+		if (!tool) return;
+		popupTool.value = null;
+		popupAnchor.value = null;
+		if (!joinsTransaction(tool)) return;
+		try {
+			context.commit();
+		} catch {
+			context.rollback();
+		}
+	}
+	function handleToolClick(tool, event) {
+		if (tool.disabled?.(context)) return;
+		if (tool.popup) {
+			if (popupTool.value?.id === tool.id) {
+				closePopup();
+				return;
+			}
+			scheduleOpen(tool, event?.currentTarget instanceof HTMLElement ? event.currentTarget : null);
+			return;
+		}
+		tool.onClick(context);
+	}
+	/**
+	* 点击面板外任意处关闭。面板内部 @click.stop 不冒泡到 window；
+	* 触发按钮本身的点击由 handleToolClick 同步处理（打开/关闭 toggle），
+	* 冒泡到达这里时 popupTool 已更新，不会误关。
+	*/
+	function onWindowClick() {
+		if (!popupTool.value) return;
+		closePopup();
+	}
+	/** Ctrl/Cmd+F 打开 / 关闭查找条（与工具按钮同一 toggle 逻辑） */
+	function onGlobalKeydown(event) {
+		if (!(event.metaKey || event.ctrlKey) || event.key.toLowerCase() !== "f") return;
+		const root = rootEl.value;
+		if (root) {
+			const target = event.target instanceof Node ? event.target : null;
+			const active = document.activeElement instanceof Node ? document.activeElement : null;
+			if (!(target !== null && root.contains(target) || active !== null && root.contains(active)) && popupTool.value === null) return;
+		}
+		event.preventDefault();
+		const findTool = defaultToolRegistry.get("find");
+		if (!findTool) return;
+		if (popupTool.value?.id === findTool.id) {
+			closePopup();
+			return;
+		}
+		scheduleOpen(findTool);
+	}
+	onMounted(() => {
+		window.addEventListener("click", onWindowClick);
+		window.addEventListener("keydown", onGlobalKeydown);
+	});
+	onBeforeUnmount(() => {
+		if (openTimer !== null) {
+			clearTimeout(openTimer);
+			openTimer = null;
+		}
+		closePopup();
+		window.removeEventListener("click", onWindowClick);
+		window.removeEventListener("keydown", onGlobalKeydown);
+	});
+	return {
+		popupTool,
+		popupAnchor,
+		closePopup,
+		handleToolClick
+	};
+}
+//#endregion
+export { useToolPopup };

package/dist/components/sheet/use-toolbar-scroll.js

@@ -0,0 +1,72 @@
+import { onBeforeUnmount, onMounted, shallowRef, watch } from "vue";
+import { applyWheelHorizontalScroll, computeOverflowNavState, scrollViewportByStep } from "@veltra/utils";
+//#region src/components/sheet/use-toolbar-scroll.ts
+/**
+* 工具栏溢出滚动（滚动几何/滚轮转横滚共享 @veltra/utils overflow-nav，见 #17；
+* 无活动项跟随）：
+* - 内容超出视口宽度时显示左右箭头（showNav / canPrev / canNext）
+* - 箭头按视口宽度 ~80% 步进
+* - 纵向滚轮转横滚；触控板横滑不拦截
+* - 原生 ResizeObserver（不引入 @veltra/compositions peer）
+*/
+function useToolbarScroll(options) {
+	const { viewportRef, listRef, content } = options;
+	const showNav = shallowRef(false);
+	const canPrev = shallowRef(false);
+	const canNext = shallowRef(false);
+	let resizeObserver;
+	const updateNavState = () => {
+		const vp = viewportRef.value;
+		if (!vp) return;
+		const state = computeOverflowNavState(vp);
+		showNav.value = state.overflowing;
+		canPrev.value = state.canPrev;
+		canNext.value = state.canNext;
+	};
+	const scrollByStep = (dir) => {
+		const vp = viewportRef.value;
+		if (!vp) return;
+		scrollViewportByStep(vp, dir);
+	};
+	/** 鼠标滚轮（纵向）驱动水平滚动；触控板横滑（已有 deltaX）不拦截 */
+	const handleWheel = (e) => {
+		const vp = viewportRef.value;
+		if (!vp) return;
+		applyWheelHorizontalScroll(e, vp, showNav.value);
+	};
+	watch(content, async () => {
+		await Promise.resolve();
+		updateNavState();
+	}, { deep: false });
+	onMounted(() => {
+		const vp = viewportRef.value;
+		if (vp) {
+			vp.addEventListener("wheel", handleWheel, { passive: false });
+			vp.addEventListener("scroll", updateNavState, { passive: true });
+		}
+		if (typeof ResizeObserver !== "undefined") {
+			resizeObserver = new ResizeObserver(() => updateNavState());
+			if (vp) resizeObserver.observe(vp);
+			const list = listRef.value;
+			if (list) resizeObserver.observe(list);
+		}
+		updateNavState();
+	});
+	onBeforeUnmount(() => {
+		const vp = viewportRef.value;
+		if (vp) {
+			vp.removeEventListener("wheel", handleWheel);
+			vp.removeEventListener("scroll", updateNavState);
+		}
+		resizeObserver?.disconnect();
+		resizeObserver = void 0;
+	});
+	return {
+		showNav,
+		canPrev,
+		canNext,
+		scrollByStep
+	};
+}
+//#endregion
+export { useToolbarScroll };

package/dist/index.d.ts

@@ -1,29 +1,21 @@
-import { COL_KEY_BASE, CellAddress, CellRange, addressFromKey, addressesEqual, boundingBox, cellKey, colIndexToName, colNameToIndex, createRange, formatAddress, formatRange, iterateRange, parseAddress, parseRange, rangeContainsAddress, rangeContainsRange, rangeSize, rangesEqual, rangesIntersect } from "./core/address.js";
-import { CellData, CellSnapshotItem, CellStore, CellType, CellValue, cellDataEqual, inferCellType, isEmptyCellData } from "./core/cell-store.js";
-import { DEFAULT_HISTORY_CAPACITY, HistoryManager, HistoryState } from "./core/command/history.js";
-import { AstNode, AstReference, BinaryOperator, collectReferences } from "./core/formula/ast.js";
-import { DependencyGraph, FormulaDependency, FormulaNode } from "./core/formula/dependency-graph.js";
-import { CellInfo, MergeManager, MergeResult, MergedCellKind } from "./core/merge-manager.js";
-import { SelectionModel, SelectionState } from "./core/selection.js";
-import { Sheet, SheetEvents } from "./core/sheet.js";
-import { CellPatch, Command, CommandContext, CommandResult, MergePatch, Mutation, Patch, PatchDirection } from "./core/command/types.js";
-import { SetCellValueCommand, SetCellValueItem, SetCellValueParams } from "./core/command/set-cell-value.js";
-import { FillDirection, GenerateFillOptions, computeFillTargetRange, generateFill, shiftFormulaRefs } from "./core/fill.js";
-import { Workbook, WorkbookEvents } from "./core/workbook.js";
-import { CommandRegistry } from "./core/command/registry.js";
-import { SetCellFormulaCommand, SetCellFormulaParams } from "./core/command/set-cell-formula.js";
-import { MergeCellsCommand, MergeCellsParams, UnmergeCellsCommand, UnmergeCellsParams } from "./core/command/merge-cells.js";
-import { defaultCommandRegistry } from "./core/command/default-registry.js";
-import { FORMULA_ERROR_CODES, FormulaError, FormulaErrorCode, formulaError, isFormulaError, isFormulaErrorCode } from "./core/formula/errors.js";
-import { FormulaOperator, FormulaParseError, FormulaToken, tokenizeFormula } from "./core/formula/tokenizer.js";
-import { parseFormula } from "./core/formula/parser.js";
-import { EvalValue, FormulaEvalContext, ScalarValue, coerceToBoolean, coerceToNumber, coerceToText, compareScalars, evaluateAst } from "./core/formula/evaluator.js";
-import { FormulaFunction, getFormulaFunction, invokeFormulaFunction, registerFormulaFunction } from "./core/formula/functions.js";
-import { SheetGrid, SheetGridContextMenuInfo, SheetGridOptions } from "./grid/sheet-grid.js";
+import _sfc_main$2 from "./components/sheet/sheet.js";
+import _sfc_main$1 from "./components/report/report-viewer.js";
+import _sfc_main from "./components/report/report-designer.js";
 import { SheetContext, createSheetContext } from "./tools/context.js";
-import { DEFAULT_TOOL_GROUP, SheetTool, SheetToolGroup, ToolRegistry, defaultToolRegistry, registerTool, unregisterTool } from "./tools/registry.js";
+import { SheetTool, SheetToolGroup, SheetToolPopupType, defaultToolRegistry, registerTool, unregisterTool } from "./tools/registry.js";
 import { SheetEmits, SheetExposed, SheetProps, _SheetExposed } from "./types/sheet.js";
+import { ConditionalOperator, ConditionalRule, DatasetCatalogItem, DatasetField, DatasetRecords, ParamValues, QueryParamDef, QueryParamOption, QueryParamType, ReportAggregate, ReportBinding, ReportExpand, ReportPreset, ReportSort } from "./report/types.js";
+import { REPORT_META_NAMESPACE, applyReportPreset, createReportBinding, formatBindingPlaceholder, formatCellAddress, inferColParentCandidate, inferDropPreset, inferReportPreset, inferRowParentCandidate, isExpansionBandRow, isHorizontalExpandBinding, isVerticalExpandBinding, listColParentCandidates, listRowParentCandidates, parseCellAddress, presetBindingPatch, setBindingCatalog } from "./report/binding.js";
+import { ConditionalEvalContext, evaluateCondition, evaluateConditionalStyle, resolveRuleCompareValue, toComparableNumber } from "./report/rules/evaluate.js";
+import { buildParamDefs, extractParamIds, resolveBoundDatasetParams } from "./report/params.js";
+import { ReportColWidthEntry, buildColumnDefs, exportFilledReportXlsx, pxToExcelColWidth } from "./report/export-xlsx.js";
+import { mapFilledColWidths } from "./report/render/builder.js";
+import { renderReport, resolveFilledColWidths } from "./report/render/index.js";
+import { ConnectionType, ConnectorError, CreateHttpConnectorOptions, DEFAULT_CONNECTION_PORTS, DataConnection, DataConnector, QueryResult, Result, createHttpConnector, resolvePortOnTypeChange } from "./report/connector.js";
+import { IncompatibleTemplateVersionError, REPORT_TEMPLATE_VERSION, ReportDatasetDef, ReportTemplate, assertCompatibleTemplateVersion, createReportTemplate, fetchTemplateRecords, getBoundDatasetIds, getTemplateDatasets, resolveParamDefaults, resolveTemplateParams } from "./report/template.js";
+import { parseDateRangeValue, patchParamValues, resolveNumberParamValue } from "./report/filter-bar.js";
+import "./report/index.js";
+import { ReportViewerExposed, ReportViewerProps, _ReportViewerExposed } from "./types/report-viewer.js";
+import { ReportDesignerEmits, ReportDesignerExposed, ReportDesignerProps, _ReportDesignerExposed } from "./types/report-designer.js";
 import "./types/index.js";
-import _default from "./vue/sheet.vue.js";
-import "./vue/index.js";
-export { AstNode, AstReference, BinaryOperator, COL_KEY_BASE, CellAddress, CellData, CellInfo, CellPatch, CellRange, CellSnapshotItem, CellStore, CellType, CellValue, Command, CommandContext, CommandRegistry, CommandResult, DEFAULT_HISTORY_CAPACITY, DEFAULT_TOOL_GROUP, DependencyGraph, EvalValue, FORMULA_ERROR_CODES, FillDirection, FormulaDependency, FormulaError, FormulaErrorCode, FormulaEvalContext, FormulaFunction, FormulaNode, FormulaOperator, FormulaParseError, FormulaToken, GenerateFillOptions, HistoryManager, HistoryState, MergeCellsCommand, MergeCellsParams, MergeManager, MergePatch, MergeResult, MergedCellKind, Mutation, Patch, PatchDirection, ScalarValue, SelectionModel, SelectionState, SetCellFormulaCommand, SetCellFormulaParams, SetCellValueCommand, SetCellValueItem, SetCellValueParams, Sheet, SheetContext, SheetEmits, SheetEvents, SheetExposed, SheetGrid, SheetGridContextMenuInfo, SheetGridOptions, SheetProps, SheetTool, SheetToolGroup, ToolRegistry, _default as USheet, UnmergeCellsCommand, UnmergeCellsParams, Workbook, WorkbookEvents, _SheetExposed, addressFromKey, addressesEqual, boundingBox, cellDataEqual, cellKey, coerceToBoolean, coerceToNumber, coerceToText, colIndexToName, colNameToIndex, collectReferences, compareScalars, computeFillTargetRange, createRange, createSheetContext, defaultCommandRegistry, defaultToolRegistry, evaluateAst, formatAddress, formatRange, formulaError, generateFill, getFormulaFunction, inferCellType, invokeFormulaFunction, isEmptyCellData, isFormulaError, isFormulaErrorCode, iterateRange, parseAddress, parseFormula, parseRange, rangeContainsAddress, rangeContainsRange, rangeSize, rangesEqual, rangesIntersect, registerFormulaFunction, registerTool, shiftFormulaRefs, tokenizeFormula, unregisterTool };
+export { type ConditionalEvalContext, ConditionalOperator, ConditionalRule, ConnectionType, ConnectorError, CreateHttpConnectorOptions, DEFAULT_CONNECTION_PORTS, DataConnection, DataConnector, DatasetCatalogItem, DatasetField, DatasetRecords, IncompatibleTemplateVersionError, ParamValues, QueryParamDef, QueryParamOption, QueryParamType, QueryResult, REPORT_META_NAMESPACE, REPORT_TEMPLATE_VERSION, ReportAggregate, ReportBinding, ReportColWidthEntry, ReportDatasetDef, type ReportDesignerEmits, type ReportDesignerExposed, type ReportDesignerProps, ReportExpand, ReportPreset, ReportSort, ReportTemplate, type ReportViewerExposed, type ReportViewerProps, Result, type SheetContext, type SheetEmits, type SheetExposed, type SheetProps, type SheetTool, type SheetToolGroup, type SheetToolPopupType, _sfc_main as UReportDesigner, _sfc_main$1 as UReportViewer, _sfc_main$2 as USheet, type _ReportDesignerExposed, type _ReportViewerExposed, type _SheetExposed, applyReportPreset, assertCompatibleTemplateVersion, buildColumnDefs, buildParamDefs, createHttpConnector, createReportBinding, createReportTemplate, createSheetContext, defaultToolRegistry, evaluateCondition, evaluateConditionalStyle, exportFilledReportXlsx, extractParamIds, fetchTemplateRecords, formatBindingPlaceholder, formatCellAddress, getBoundDatasetIds, getTemplateDatasets, inferColParentCandidate, inferDropPreset, inferReportPreset, inferRowParentCandidate, isExpansionBandRow, isHorizontalExpandBinding, isVerticalExpandBinding, listColParentCandidates, listRowParentCandidates, mapFilledColWidths, parseCellAddress, parseDateRangeValue, patchParamValues, presetBindingPatch, pxToExcelColWidth, registerTool, renderReport, resolveBoundDatasetParams, resolveFilledColWidths, resolveNumberParamValue, resolveParamDefaults, resolvePortOnTypeChange, resolveRuleCompareValue, resolveTemplateParams, setBindingCatalog, toComparableNumber, unregisterTool };

package/dist/index.js

@@ -1,26 +1,16 @@
-import { COL_KEY_BASE, addressFromKey, addressesEqual, boundingBox, cellKey, colIndexToName, colNameToIndex, createRange, formatAddress, formatRange, iterateRange, parseAddress, parseRange, rangeContainsAddress, rangeContainsRange, rangeSize, rangesEqual, rangesIntersect } from "./core/address.js";
-import { DEFAULT_TOOL_GROUP, ToolRegistry, defaultToolRegistry, registerTool, unregisterTool } from "./tools/registry.js";
+import { defaultToolRegistry, registerTool, unregisterTool } from "./tools/registry.js";
 import "./tools/builtin.js";
-import { CellStore, cellDataEqual, inferCellType, isEmptyCellData } from "./core/cell-store.js";
-import { computeFillTargetRange, generateFill, shiftFormulaRefs } from "./core/fill.js";
-import { MergeManager } from "./core/merge-manager.js";
-import { SelectionModel } from "./core/selection.js";
-import { MergeCellsCommand, UnmergeCellsCommand } from "./core/command/merge-cells.js";
-import { CommandRegistry } from "./core/command/registry.js";
-import { SetCellFormulaCommand } from "./core/command/set-cell-formula.js";
-import { SetCellValueCommand } from "./core/command/set-cell-value.js";
-import { defaultCommandRegistry } from "./core/command/default-registry.js";
-import { DEFAULT_HISTORY_CAPACITY, HistoryManager } from "./core/command/history.js";
-import { collectReferences } from "./core/formula/ast.js";
-import { FORMULA_ERROR_CODES, formulaError, isFormulaError, isFormulaErrorCode } from "./core/formula/errors.js";
-import { coerceToBoolean, coerceToNumber, coerceToText, compareScalars, evaluateAst } from "./core/formula/evaluator.js";
-import { getFormulaFunction, invokeFormulaFunction, registerFormulaFunction } from "./core/formula/functions.js";
-import { FormulaParseError, tokenizeFormula } from "./core/formula/tokenizer.js";
-import { parseFormula } from "./core/formula/parser.js";
-import { DependencyGraph } from "./core/formula/dependency-graph.js";
-import { Sheet } from "./core/sheet.js";
-import { Workbook } from "./core/workbook.js";
-import { SheetGrid } from "./grid/sheet-grid.js";
 import { createSheetContext } from "./tools/context.js";
-import _sfc_main from "./vue/sheet.js";
-export { COL_KEY_BASE, CellStore, CommandRegistry, DEFAULT_HISTORY_CAPACITY, DEFAULT_TOOL_GROUP, DependencyGraph, FORMULA_ERROR_CODES, FormulaParseError, HistoryManager, MergeCellsCommand, MergeManager, SelectionModel, SetCellFormulaCommand, SetCellValueCommand, Sheet, SheetGrid, ToolRegistry, _sfc_main as USheet, UnmergeCellsCommand, Workbook, addressFromKey, addressesEqual, boundingBox, cellDataEqual, cellKey, coerceToBoolean, coerceToNumber, coerceToText, colIndexToName, colNameToIndex, collectReferences, compareScalars, computeFillTargetRange, createRange, createSheetContext, defaultCommandRegistry, defaultToolRegistry, evaluateAst, formatAddress, formatRange, formulaError, generateFill, getFormulaFunction, inferCellType, invokeFormulaFunction, isEmptyCellData, isFormulaError, isFormulaErrorCode, iterateRange, parseAddress, parseFormula, parseRange, rangeContainsAddress, rangeContainsRange, rangeSize, rangesEqual, rangesIntersect, registerFormulaFunction, registerTool, shiftFormulaRefs, tokenizeFormula, unregisterTool };
+import _sfc_main$2 from "./components/sheet/sheet.js";
+import { buildColumnDefs, exportFilledReportXlsx, pxToExcelColWidth } from "./report/export-xlsx.js";
+import { parseDateRangeValue, patchParamValues, resolveNumberParamValue } from "./report/filter-bar.js";
+import { REPORT_META_NAMESPACE, applyReportPreset, createReportBinding, formatBindingPlaceholder, formatCellAddress, inferColParentCandidate, inferDropPreset, inferReportPreset, inferRowParentCandidate, isExpansionBandRow, isHorizontalExpandBinding, isVerticalExpandBinding, listColParentCandidates, listRowParentCandidates, parseCellAddress, presetBindingPatch, setBindingCatalog } from "./report/binding.js";
+import { evaluateCondition, evaluateConditionalStyle, resolveRuleCompareValue, toComparableNumber } from "./report/rules/evaluate.js";
+import { mapFilledColWidths } from "./report/render/builder.js";
+import { renderReport, resolveFilledColWidths } from "./report/render/index.js";
+import { buildParamDefs, extractParamIds, resolveBoundDatasetParams } from "./report/params.js";
+import { IncompatibleTemplateVersionError, REPORT_TEMPLATE_VERSION, assertCompatibleTemplateVersion, createReportTemplate, fetchTemplateRecords, getBoundDatasetIds, getTemplateDatasets, resolveParamDefaults, resolveTemplateParams } from "./report/template.js";
+import _sfc_main$1 from "./components/report/report-viewer.js";
+import { DEFAULT_CONNECTION_PORTS, createHttpConnector, resolvePortOnTypeChange } from "./report/connector.js";
+import _sfc_main from "./components/report/report-designer.js";
+export { DEFAULT_CONNECTION_PORTS, IncompatibleTemplateVersionError, REPORT_META_NAMESPACE, REPORT_TEMPLATE_VERSION, _sfc_main as UReportDesigner, _sfc_main$1 as UReportViewer, _sfc_main$2 as USheet, applyReportPreset, assertCompatibleTemplateVersion, buildColumnDefs, buildParamDefs, createHttpConnector, createReportBinding, createReportTemplate, createSheetContext, defaultToolRegistry, evaluateCondition, evaluateConditionalStyle, exportFilledReportXlsx, extractParamIds, fetchTemplateRecords, formatBindingPlaceholder, formatCellAddress, getBoundDatasetIds, getTemplateDatasets, inferColParentCandidate, inferDropPreset, inferReportPreset, inferRowParentCandidate, isExpansionBandRow, isHorizontalExpandBinding, isVerticalExpandBinding, listColParentCandidates, listRowParentCandidates, mapFilledColWidths, parseCellAddress, parseDateRangeValue, patchParamValues, presetBindingPatch, pxToExcelColWidth, registerTool, renderReport, resolveBoundDatasetParams, resolveFilledColWidths, resolveNumberParamValue, resolveParamDefaults, resolvePortOnTypeChange, resolveRuleCompareValue, resolveTemplateParams, setBindingCatalog, toComparableNumber, unregisterTool };

package/dist/report/binding.d.ts

@@ -0,0 +1,45 @@
+import { DatasetCatalogItem, ReportBinding, ReportPreset } from "./types.js";
+import { CellAddress } from "@veltra/sheet-core";
+//#region src/report/binding.d.ts
+declare function setBindingCatalog(catalog: DatasetCatalogItem[]): void;
+declare const REPORT_META_NAMESPACE = "report";
+/** 预设 → 绑定字段补丁（父格除 grandTotal 外均保留推断值） */
+declare function presetBindingPatch(preset: ReportPreset, options?: {
+  transpose?: boolean;
+}): Partial<ReportBinding>;
+/** 将预设写入绑定（grandTotal 清空双父格；其余保留既有父格） */
+declare function applyReportPreset(binding: ReportBinding, preset: ReportPreset, options?: {
+  transpose?: boolean;
+}): ReportBinding;
+declare function isVerticalExpandBinding(binding: ReportBinding): boolean;
+declare function isHorizontalExpandBinding(binding: ReportBinding): boolean;
+/** 指定模板行是否含纵向扩展绑定（展开带行） */
+declare function isExpansionBandRow(row: number, getBindingAt: (addr: CellAddress) => ReportBinding | undefined, scanCols?: number): boolean;
+/** 落格时推断预设：默认明细；数值字段且位于展开带正下方相邻行 → 小计 */
+declare function inferDropPreset(addr: CellAddress, fieldType: DatasetCatalogItem['fields'][number]['type'], getBindingAt: (addr: CellAddress) => ReportBinding | undefined): ReportPreset;
+/** 同数据集纵向扩展绑定格（行方向父格下拉候选） */
+declare function listRowParentCandidates(binding: ReportBinding, entries: ReadonlyArray<{
+  addr: CellAddress;
+  binding: ReportBinding;
+}>): CellAddress[];
+/** 同数据集横向扩展绑定格（列方向父格下拉候选） */
+declare function listColParentCandidates(binding: ReportBinding, entries: ReadonlyArray<{
+  addr: CellAddress;
+  binding: ReportBinding;
+}>): CellAddress[];
+/** 同列向上找最近的纵向扩展绑定，作为 rowParent 候选 */
+declare function inferRowParentCandidate(addr: CellAddress, getBindingAt: (addr: CellAddress) => ReportBinding | undefined): CellAddress | null;
+/** 同行向左找最近的横向扩展绑定，作为 colParent 候选 */
+declare function inferColParentCandidate(addr: CellAddress, getBindingAt: (addr: CellAddress) => ReportBinding | undefined): CellAddress | null;
+/** 从绑定字段推断预设；不匹配任何预设时返回 null（自定义） */
+declare function inferReportPreset(binding: ReportBinding): ReportPreset | null;
+/** 默认明细 + 纵向扩展 */
+declare function createReportBinding(dataset: DatasetCatalogItem, fieldName: string): ReportBinding;
+/** 设计地址 → A1 标签（支持多字母列） */
+declare function formatCellAddress(addr: CellAddress): string;
+/** A1 标签 → 设计地址；非法输入返回 null */
+declare function parseCellAddress(label: string): CellAddress | null;
+/** Binding Placeholder 中文可读文案（如「分组 · 客户」） */
+declare function formatBindingPlaceholder(binding: ReportBinding, resolveLabel?: (datasetId: string, fieldName: string) => string): string;
+//#endregion
+export { REPORT_META_NAMESPACE, applyReportPreset, createReportBinding, formatBindingPlaceholder, formatCellAddress, inferColParentCandidate, inferDropPreset, inferReportPreset, inferRowParentCandidate, isExpansionBandRow, isHorizontalExpandBinding, isVerticalExpandBinding, listColParentCandidates, listRowParentCandidates, parseCellAddress, presetBindingPatch, setBindingCatalog };

package/dist/report/binding.js

@@ -0,0 +1,175 @@
+import { formatAddress, parseAddress } from "@veltra/sheet-core";
+//#region src/report/binding.ts
+/** 字段 label 解析用的 catalog（由宿主注入） */
+let bindingCatalog = [];
+function setBindingCatalog(catalog) {
+	bindingCatalog = catalog;
+}
+const REPORT_META_NAMESPACE = "report";
+const AGGREGATE_PLACEHOLDER_TAG = {
+	list: "明细",
+	group: "分组",
+	sum: "求和",
+	avg: "平均",
+	count: "计数",
+	max: "最大",
+	min: "最小"
+};
+/** 预设 → 绑定字段补丁（父格除 grandTotal 外均保留推断值） */
+function presetBindingPatch(preset, options) {
+	const expand = options?.transpose ? "right" : "down";
+	switch (preset) {
+		case "groupHeader": return {
+			preset,
+			expand,
+			aggregate: "group"
+		};
+		case "detail": return {
+			preset,
+			expand,
+			aggregate: "list"
+		};
+		case "subtotal": return {
+			preset,
+			expand: "none",
+			aggregate: "sum"
+		};
+		case "grandTotal": return {
+			preset,
+			expand: "none",
+			aggregate: "sum",
+			rowParent: void 0,
+			colParent: void 0
+		};
+		case "cross": return {
+			preset,
+			expand: "none",
+			aggregate: "sum"
+		};
+	}
+}
+/** 将预设写入绑定（grandTotal 清空双父格；其余保留既有父格） */
+function applyReportPreset(binding, preset, options) {
+	const patch = presetBindingPatch(preset, options);
+	const next = {
+		...binding,
+		...patch
+	};
+	if (preset === "grandTotal") {
+		delete next.rowParent;
+		delete next.colParent;
+	}
+	return next;
+}
+function isVerticalExpandBinding(binding) {
+	return binding.expand === "down" && (binding.aggregate === "group" || binding.aggregate === "list");
+}
+function isHorizontalExpandBinding(binding) {
+	return binding.expand === "right" && binding.aggregate === "group";
+}
+/** 指定模板行是否含纵向扩展绑定（展开带行） */
+function isExpansionBandRow(row, getBindingAt, scanCols = 64) {
+	for (let col = 0; col < scanCols; col++) {
+		const binding = getBindingAt({
+			row,
+			col
+		});
+		if (binding && isVerticalExpandBinding(binding)) return true;
+	}
+	return false;
+}
+/** 落格时推断预设：默认明细；数值字段且位于展开带正下方相邻行 → 小计 */
+function inferDropPreset(addr, fieldType, getBindingAt) {
+	if (fieldType === "number" && addr.row > 0 && isExpansionBandRow(addr.row - 1, getBindingAt)) return "subtotal";
+	return "detail";
+}
+/** 同数据集纵向扩展绑定格（行方向父格下拉候选） */
+function listRowParentCandidates(binding, entries) {
+	const candidates = [];
+	for (const entry of entries) {
+		if (entry.binding.dataset !== binding.dataset) continue;
+		if (!isVerticalExpandBinding(entry.binding)) continue;
+		candidates.push(entry.addr);
+	}
+	return candidates;
+}
+/** 同数据集横向扩展绑定格（列方向父格下拉候选） */
+function listColParentCandidates(binding, entries) {
+	const candidates = [];
+	for (const entry of entries) {
+		if (entry.binding.dataset !== binding.dataset) continue;
+		if (!isHorizontalExpandBinding(entry.binding)) continue;
+		candidates.push(entry.addr);
+	}
+	return candidates;
+}
+/** 同列向上找最近的纵向扩展绑定，作为 rowParent 候选 */
+function inferRowParentCandidate(addr, getBindingAt) {
+	for (let row = addr.row - 1; row >= 0; row--) {
+		const binding = getBindingAt({
+			row,
+			col: addr.col
+		});
+		if (binding && isVerticalExpandBinding(binding)) return {
+			row,
+			col: addr.col
+		};
+	}
+	return null;
+}
+/** 同行向左找最近的横向扩展绑定，作为 colParent 候选 */
+function inferColParentCandidate(addr, getBindingAt) {
+	for (let col = addr.col - 1; col >= 0; col--) {
+		const binding = getBindingAt({
+			row: addr.row,
+			col
+		});
+		if (binding && isHorizontalExpandBinding(binding)) return {
+			row: addr.row,
+			col
+		};
+	}
+	return null;
+}
+/** 从绑定字段推断预设；不匹配任何预设时返回 null（自定义） */
+function inferReportPreset(binding) {
+	if (binding.preset) return binding.preset;
+	if (binding.expand === "none" && binding.aggregate === "sum" && binding.rowParent && binding.colParent) return "cross";
+	if (binding.expand === "none" && binding.aggregate === "sum" && !binding.rowParent && !binding.colParent) return "grandTotal";
+	if (binding.expand === "none" && binding.aggregate === "sum" && binding.rowParent && !binding.colParent) return "subtotal";
+	if (binding.aggregate === "group" && (binding.expand === "down" || binding.expand === "right")) return "groupHeader";
+	if (binding.aggregate === "list" && (binding.expand === "down" || binding.expand === "right")) return "detail";
+	return null;
+}
+/** 默认明细 + 纵向扩展 */
+function createReportBinding(dataset, fieldName) {
+	return {
+		dataset: dataset.id,
+		field: fieldName,
+		aggregate: "list",
+		expand: "down",
+		preset: "detail",
+		sort: "none",
+		conditionalRules: []
+	};
+}
+/** 设计地址 → A1 标签（支持多字母列） */
+function formatCellAddress(addr) {
+	return formatAddress(addr);
+}
+/** A1 标签 → 设计地址；非法输入返回 null */
+function parseCellAddress(label) {
+	return parseAddress(label);
+}
+/** 解析字段中文标签（找不到时回退字段名）；可传入报表配置中的 label */
+function resolveFieldLabel(datasetId, fieldName, resolveLabel) {
+	const override = resolveLabel?.(datasetId, fieldName);
+	if (override) return override;
+	return (bindingCatalog.find((d) => d.id === datasetId)?.fields.find((f) => f.name === fieldName))?.label ?? fieldName;
+}
+/** Binding Placeholder 中文可读文案（如「分组 · 客户」） */
+function formatBindingPlaceholder(binding, resolveLabel) {
+	return `${AGGREGATE_PLACEHOLDER_TAG[binding.aggregate]} · ${resolveFieldLabel(binding.dataset, binding.field, resolveLabel)}`;
+}
+//#endregion
+export { REPORT_META_NAMESPACE, applyReportPreset, createReportBinding, formatBindingPlaceholder, formatCellAddress, inferColParentCandidate, inferDropPreset, inferReportPreset, inferRowParentCandidate, isExpansionBandRow, isHorizontalExpandBinding, isVerticalExpandBinding, listColParentCandidates, listRowParentCandidates, parseCellAddress, presetBindingPatch, setBindingCatalog };