@veltra/sheet 2.1.1 → 2.3.0

package/dist/{vue → components/sheet}/popups/import.worker.js

@@ -1,4 +1,4 @@
-//#region src/vue/popups/import.worker.ts
+//#region src/components/sheet/popups/import.worker.ts
 self.onmessage = (e) => {
 	const { buffer } = e.data;
 	(async () => {

package/dist/{vue → components/sheet}/popups/insert-image-popup.js

@@ -2,7 +2,7 @@ import { INSERT_IMAGE_ACCEPT, insertImageFromFile } from "../insert-image.js";
 import { createBlock, createElementVNode, createTextVNode, defineComponent, normalizeClass, openBlock, unref, withCtx } from "vue";
 import { UFilePicker } from "@veltra/desktop";
 import { bem } from "@veltra/utils";
-//#region src/vue/popups/insert-image-popup.vue
+//#region src/components/sheet/popups/insert-image-popup.vue
 const _sfc_main = /*@__PURE__*/ defineComponent({
 	name: "USheetInsertImagePopup",
 	__name: "insert-image-popup",

package/dist/{vue → components/sheet}/sheet-context-menu.js

@@ -1,4 +1,4 @@
-import { defaultToolRegistry } from "../tools/registry.js";
+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";
@@ -38,11 +38,14 @@ function wholeColRange(col, rowCount) {
 		col
 	});
 }
-/** 渲染尺寸 = max(props, sheet.rows/cols)，与 SheetGrid 一致 */
+/**
+* 渲染尺寸：模型已声明时以模型为准（删行可低于 props）；未声明时回落 props。
+* 与 SheetGrid / useSheetGrid 一致——避免 ensureTableSize(props) 把删行结果撑回。
+*/
 function resolveRenderSize(propsRows, propsCols, sheetRows, sheetCols) {
 	return {
-		rows: Math.max(propsRows ?? 100, sheetRows),
-		cols: Math.max(propsCols ?? 26, sheetCols)
+		rows: sheetRows > 0 ? sheetRows : propsRows ?? 100,
+		cols: sheetCols > 0 ? sheetCols : propsCols ?? 26
 	};
 }
 function insertCountRender(options) {

package/dist/{vue → components/sheet}/sheet-tabs.js

@@ -3,7 +3,7 @@ import { ArrowLeft, ArrowRight } from "@veltra/icons/normal";
 import { Fragment, createElementBlock, createElementVNode, createVNode, defineComponent, nextTick, normalizeClass, openBlock, ref, renderList, toDisplayString, toRef, unref, useTemplateRef, vModelText, vShow, withCtx, withDirectives, withKeys, withModifiers } from "vue";
 import { UIcon, contextmenu, message, messageConfirm } from "@veltra/desktop";
 import { bem } from "@veltra/utils";
-//#region src/vue/sheet-tabs.vue
+//#region src/components/sheet/sheet-tabs.vue
 const _hoisted_1 = ["disabled"];
 const _hoisted_2 = ["onClick", "onContextmenu"];
 const _hoisted_3 = ["onKeydown"];

package/dist/{vue → components/sheet}/sheet-toolbar.js

@@ -3,7 +3,7 @@ import { ArrowLeft, ArrowRight } from "@veltra/icons/normal";
 import { Fragment, createBlock, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, normalizeClass, openBlock, renderList, resolveComponent, resolveDynamicComponent, toDisplayString, toRef, unref, useTemplateRef, withCtx } from "vue";
 import { UIcon } from "@veltra/desktop";
 import { bem } from "@veltra/utils";
-//#region src/vue/sheet-toolbar.vue
+//#region src/components/sheet/sheet-toolbar.vue
 const _hoisted_1 = ["disabled"];
 const _hoisted_2 = [
 	"data-tool-id",

package/dist/{vue → components/sheet}/sheet.js

@@ -16,7 +16,7 @@ import { useToolPopup } from "./use-tool-popup.js";
 import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, normalizeClass, openBlock, ref, toDisplayString, unref, useTemplateRef, watch, withCtx, withModifiers } from "vue";
 import { UDropdown } from "@veltra/desktop";
 import { bem } from "@veltra/utils";
-//#region src/vue/sheet.vue
+//#region src/components/sheet/sheet.vue
 const _sfc_main = /*@__PURE__*/ defineComponent({
 	name: "USheet",
 	__name: "sheet",
@@ -24,6 +24,9 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 		workbook: {},
 		rows: { default: 100 },
 		cols: { default: 26 },
+		resolveDisplayValue: {},
+		resolveCellStyle: {},
+		resolveCellRenderer: {},
 		showToolbar: {
 			type: Boolean,
 			default: true
@@ -35,6 +38,18 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 		showTabs: {
 			type: Boolean,
 			default: true
+		},
+		showRowHeader: {
+			type: Boolean,
+			default: true
+		},
+		showColHeader: {
+			type: Boolean,
+			default: true
+		},
+		readonly: {
+			type: Boolean,
+			default: false
 		}
 	},
 	emits: ["active-sheet-change"],

package/dist/{vue → components/sheet}/use-find-replace.js

@@ -2,7 +2,7 @@ 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
+//#region src/components/sheet/use-find-replace.ts
 /**
 * 查找条逻辑（关键词 / 上一个 / 下一个 / 命中计数 / 替换）：
 * - 关键词 / 选项变化 → 重新查找并定位第一个命中

package/dist/{vue → components/sheet}/use-formula-ref-select.js

@@ -1,4 +1,4 @@
-//#region src/vue/use-formula-ref-select.ts
+//#region src/components/sheet/use-formula-ref-select.ts
 /** 引用选择上下文：光标前一个非空字符属于此集合时可插入单元格引用 */
 const REF_TRIGGER_CHARS = /* @__PURE__ */ new Set([
 	"=",

package/dist/{vue → components/sheet}/use-sheet-grid.js

@@ -2,7 +2,7 @@ import { buildBodyMenus, buildColHeaderMenus, buildRowHeaderMenus, ensureContext
 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
+//#region src/components/sheet/use-sheet-grid.ts
 /**
 * 缓存容量：最近 N 个 sheet 的 SheetGrid 实例常驻（tab 来回切换零重建）。
 * 大文件多 sheet 场景下切换卡顿的主因是每次重建 VTable（实例创建 + scenegraph
@@ -57,11 +57,18 @@ function useSheetGrid(options) {
 		const el = document.createElement("div");
 		el.className = "u-sheet__grid-instance";
 		host.appendChild(el);
+		const { rows, cols } = resolveRenderSize(props.rows, props.cols, sheet.rows, sheet.cols);
 		const grid = new SheetGrid({
 			container: el,
 			sheet,
-			rows: props.rows,
-			cols: props.cols,
+			rows,
+			cols,
+			readonly: props.readonly,
+			showRowHeader: props.showRowHeader,
+			showColHeader: props.showColHeader,
+			resolveDisplayValue: props.resolveDisplayValue,
+			resolveCellStyle: props.resolveCellStyle,
+			resolveCellRenderer: props.resolveCellRenderer,
 			onContextMenu: handleContextMenu,
 			onEditStart: (addr) => formulaBarRef.value?.mirrorGridEdit(addr),
 			onEditEnd: (addr) => formulaBarRef.value?.exitMirror(addr),
@@ -165,7 +172,18 @@ function useSheetGrid(options) {
 		activateGrid();
 	}
 	onMounted(activateGrid);
-	watch(() => [props.rows, props.cols], rebuildGrid);
+	watch(() => [
+		props.rows,
+		props.cols,
+		props.readonly,
+		props.showRowHeader,
+		props.showColHeader
+	], ([nextRows, nextCols]) => {
+		const sheet = getActiveSheet();
+		if (nextRows != null) sheet.ensureTableSize(nextRows, 0);
+		if (nextCols != null) sheet.ensureTableSize(0, nextCols);
+		rebuildGrid();
+	});
 	onBeforeUnmount(() => {
 		invalidateAll();
 	});

package/dist/{vue → components/sheet}/use-sheet-state.js

@@ -1,8 +1,9 @@
-import { defaultToolRegistry } from "../tools/registry.js";
-import { createSheetContext } from "../tools/context.js";
+import { defaultToolRegistry } from "../../tools/registry.js";
+import { createSheetContext } from "../../tools/context.js";
+import { resolveRenderSize } from "./sheet-context-menu.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
+//#region src/components/sheet/use-sheet-state.ts
 /**
 * USheet 的状态源（单一数据源，其余状态由此推导）：
 * - workbook（外部传入或内部自建单 sheet 工作簿）、sheetList、activeIndex、activeSheet
@@ -19,8 +20,8 @@ function useSheetState(props, emit, hooks) {
 	/** 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);
+	/** 工具上下文：动态解析活动 sheet / 工作簿 / 渲染尺寸，tab 切换后自动指向最新值 */
+	const context = createSheetContext(() => activeSheet.value, () => workbook.value, { resolveGridSize: () => resolveRenderSize(props.rows, props.cols, activeSheet.value.rows, activeSheet.value.cols) });
 	/** 工具栏状态版本号：visible/disabled/active 是 (ctx) => boolean 纯函数，状态源变化时 bump 触发重算 */
 	const stateTick = ref(0);
 	const bump = () => {

package/dist/{vue → components/sheet}/use-sheet-tabs-bar.js

@@ -1,6 +1,6 @@
 import { nextTick, onBeforeUnmount, onMounted, shallowRef, watch } from "vue";
 import { applyWheelHorizontalScroll, computeOverflowNavState, scrollElementIntoView, scrollViewportByStep } from "@veltra/utils";
-//#region src/vue/use-sheet-tabs-bar.ts
+//#region src/components/sheet/use-sheet-tabs-bar.ts
 /**
 * Sheet 底部标签栏溢出滚动（滚动几何/滚轮转横滚/元素滚入视野共享
 * @veltra/utils overflow-nav，见 #17；此处保留事件绑定与 watch 差异）：

package/dist/{vue → components/sheet}/use-tool-groups.js

@@ -1,6 +1,6 @@
-import { defaultToolRegistry } from "../tools/registry.js";
+import { defaultToolRegistry } from "../../tools/registry.js";
 import { computed } from "vue";
-//#region src/vue/use-tool-groups.ts
+//#region src/components/sheet/use-tool-groups.ts
 /**
 * 内置组稳定顺序：history ｜ cell ｜ text ｜ edit ｜ insert ｜ file。
 * 未列出的自定义组按注册先后排在已知组之后。

package/dist/{vue → components/sheet}/use-tool-popup.js

@@ -1,6 +1,6 @@
-import { defaultToolRegistry } from "../tools/registry.js";
+import { defaultToolRegistry } from "../../tools/registry.js";
 import { onBeforeUnmount, onMounted, shallowRef } from "vue";
-//#region src/vue/use-tool-popup.ts
+//#region src/components/sheet/use-tool-popup.ts
 /**
 * 面板打开期间的写入是否合并为一个 undo 单元（关闭时提交）：
 * 填充颜色 / 边框 / 字体颜色 / 字号参与事务；查找（每次替换独立 undo）、

package/dist/{vue → components/sheet}/use-toolbar-scroll.js

@@ -1,6 +1,6 @@
 import { onBeforeUnmount, onMounted, shallowRef, watch } from "vue";
 import { applyWheelHorizontalScroll, computeOverflowNavState, scrollViewportByStep } from "@veltra/utils";
-//#region src/vue/use-toolbar-scroll.ts
+//#region src/components/sheet/use-toolbar-scroll.ts
 /**
 * 工具栏溢出滚动（滚动几何/滚轮转横滚共享 @veltra/utils overflow-nav，见 #17；
 * 无活动项跟随）：

package/dist/index.d.ts

@@ -1,7 +1,21 @@
-import _sfc_main from "./vue/sheet.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 { 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 { InferParentOptions, ListParentCandidateOptions, REPORT_META_NAMESPACE, applyReportPreset, createReportBinding, formatBindingPlaceholder, formatBindingPlaceholderParts, formatCellAddress, formatParentCandidateLabel, inferColParentCandidate, inferDropPreset, inferParentsForPreset, inferReportPreset, inferRowParentCandidate, isColGroupBinding, isExpansionBandCol, isExpansionBandRow, isHorizontalExpandBinding, isReductionAggregate, isRowGroupBinding, isVerticalExpandBinding, listColParentCandidates, listRowParentCandidates, parseCellAddress, prefersGroupParent, presetBindingPatch, presetStillApplies, 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 { ALIGN_STYLE_KEYS, AstNode, AstReference, BORDER_EDGE_DEFAULTS, BORDER_SIDES, BORDER_STYLE_WIDTH, BinaryOperator, BorderEdge, BorderLineStyle, BorderPreset, BorderPresetItem, BorderSide, CellAddress, CellAlign, CellData, CellFont, CellInfo, CellPatch, CellRange, CellSnapshotItem, CellStore, CellStyle, CellStylePatch, CellType, CellValue, Command, CommandContext, CommandResult, DependencyGraph, EvalValue, FONT_STYLE_KEYS, FORMULA_ERROR_CODES, FillDirection, FindMatch, FindOptions, FormulaDependency, FormulaError, FormulaErrorCode, FormulaEvalContext, FormulaFunction, FormulaFunctionMeta, FormulaNode, FormulaOperator, FormulaParseError, FormulaToken, FrozenState, GenerateFillOptions, HistoryManager, HistoryState, HorizontalAlign, ImageInput, ImagePatch, ImageUpdateFields, InsertCellsCommand, InsertCellsParams, InsertImageCommand, InsertImageParams, MergeCellsCommand, MergeCellsParams, MergeManager, MergePatch, MergeResult, MergedCellKind, Mutation, NUMERIC_TEXT_RE, Patch, PatchDirection, RemoveImageCommand, RemoveImageParams, ScalarValue, SelectionModel, SelectionState, SetCellFormulaCommand, SetCellFormulaParams, SetCellStyleCommand, SetCellStyleItem, SetCellStyleParams, SetCellValueCommand, SetCellValueItem, SetCellValueParams, Sheet, SheetEvents, SheetGrid, SheetGridContextMenuInfo, SheetGridContextMenuKind, SheetGridOptions, SheetImage, SheetImageAnchor, SheetImageType, SheetSnapshot, SnapshotPatch, StructureChange, StructurePatch, StyleId, StylePool, UnmergeCellsCommand, UnmergeCellsParams, UpdateImageCommand, UpdateImageParams, VerticalAlign, Workbook, WorkbookEvents, boundingBox, buildBorderPresetItems, cellDataEqual, cellKey, cloneImageAnchor, cloneSheetImage, coerceToBoolean, coerceToNumber, coerceToText, colIndexToName, colNameToIndex, collectReferences, computeFillTargetRange, createImageId, createRange, defaultCommandRegistry, evaluateAst, exportSheetCsv, exportWorkbookXlsx, findAll, findNext, findNextFrom, findPrev, findPrevFrom, formatAddress, formatRange, formulaError, generateFill, importCsv, importXlsx, inferCellType, invokeFormulaFunction, isEmptyCellData, isFormulaError, isFormulaErrorCode, iterateRange, listFormulaFunctions, normalizeInputValue, parseAddress, parseFormula, parseRange, rangeContainsAddress, rangesEqual, rangesIntersect, registerFormulaFunction, replaceWorkbook, tokenizeFormula } from "@veltra/sheet-core";
-export { ALIGN_STYLE_KEYS, type AstNode, type AstReference, BORDER_EDGE_DEFAULTS, BORDER_SIDES, BORDER_STYLE_WIDTH, type BinaryOperator, type BorderEdge, type BorderLineStyle, type BorderPreset, type BorderPresetItem, type BorderSide, type CellAddress, type CellAlign, type CellData, type CellFont, type CellInfo, type CellPatch, type CellRange, type CellSnapshotItem, CellStore, type CellStyle, type CellStylePatch, type CellType, type CellValue, type Command, type CommandContext, type CommandResult, DependencyGraph, type EvalValue, FONT_STYLE_KEYS, FORMULA_ERROR_CODES, type FillDirection, type FindMatch, type FindOptions, type FormulaDependency, type FormulaError, type FormulaErrorCode, type FormulaEvalContext, type FormulaFunction, type FormulaFunctionMeta, type FormulaNode, type FormulaOperator, FormulaParseError, type FormulaToken, type FrozenState, type GenerateFillOptions, HistoryManager, type HistoryState, type HorizontalAlign, type ImageInput, type ImagePatch, type ImageUpdateFields, InsertCellsCommand, type InsertCellsParams, InsertImageCommand, type InsertImageParams, MergeCellsCommand, type MergeCellsParams, MergeManager, type MergePatch, type MergeResult, type MergedCellKind, type Mutation, NUMERIC_TEXT_RE, type Patch, type PatchDirection, RemoveImageCommand, type RemoveImageParams, type ScalarValue, SelectionModel, type SelectionState, SetCellFormulaCommand, type SetCellFormulaParams, SetCellStyleCommand, type SetCellStyleItem, type SetCellStyleParams, SetCellValueCommand, type SetCellValueItem, type SetCellValueParams, Sheet, type SheetContext, type SheetEmits, type SheetEvents, type SheetExposed, SheetGrid, type SheetGridContextMenuInfo, type SheetGridContextMenuKind, type SheetGridOptions, type SheetImage, type SheetImageAnchor, type SheetImageType, type SheetProps, type SheetSnapshot, type SheetTool, type SheetToolGroup, type SheetToolPopupType, type SnapshotPatch, type StructureChange, type StructurePatch, type StyleId, StylePool, _sfc_main as USheet, UnmergeCellsCommand, type UnmergeCellsParams, UpdateImageCommand, type UpdateImageParams, type VerticalAlign, Workbook, type WorkbookEvents, type _SheetExposed, boundingBox, buildBorderPresetItems, cellDataEqual, cellKey, cloneImageAnchor, cloneSheetImage, coerceToBoolean, coerceToNumber, coerceToText, colIndexToName, colNameToIndex, collectReferences, computeFillTargetRange, createImageId, createRange, createSheetContext, defaultCommandRegistry, defaultToolRegistry, evaluateAst, exportSheetCsv, exportWorkbookXlsx, findAll, findNext, findNextFrom, findPrev, findPrevFrom, formatAddress, formatRange, formulaError, generateFill, importCsv, importXlsx, inferCellType, invokeFormulaFunction, isEmptyCellData, isFormulaError, isFormulaErrorCode, iterateRange, listFormulaFunctions, normalizeInputValue, parseAddress, parseFormula, parseRange, rangeContainsAddress, rangesEqual, rangesIntersect, registerFormulaFunction, registerTool, replaceWorkbook, tokenizeFormula, unregisterTool };
+export { type ConditionalEvalContext, ConditionalOperator, ConditionalRule, ConnectionType, ConnectorError, CreateHttpConnectorOptions, DEFAULT_CONNECTION_PORTS, DataConnection, DataConnector, DatasetCatalogItem, DatasetField, DatasetRecords, IncompatibleTemplateVersionError, InferParentOptions, ListParentCandidateOptions, 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, formatBindingPlaceholderParts, formatCellAddress, formatParentCandidateLabel, getBoundDatasetIds, getTemplateDatasets, inferColParentCandidate, inferDropPreset, inferParentsForPreset, inferReportPreset, inferRowParentCandidate, isColGroupBinding, isExpansionBandCol, isExpansionBandRow, isHorizontalExpandBinding, isReductionAggregate, isRowGroupBinding, isVerticalExpandBinding, listColParentCandidates, listRowParentCandidates, mapFilledColWidths, parseCellAddress, parseDateRangeValue, patchParamValues, prefersGroupParent, presetBindingPatch, presetStillApplies, pxToExcelColWidth, registerTool, renderReport, resolveBoundDatasetParams, resolveFilledColWidths, resolveNumberParamValue, resolveParamDefaults, resolvePortOnTypeChange, resolveRuleCompareValue, resolveTemplateParams, setBindingCatalog, toComparableNumber, unregisterTool };

package/dist/index.js

@@ -1,6 +1,16 @@
 import { defaultToolRegistry, registerTool, unregisterTool } from "./tools/registry.js";
 import "./tools/builtin.js";
 import { createSheetContext } from "./tools/context.js";
-import _sfc_main from "./vue/sheet.js";
-import { ALIGN_STYLE_KEYS, BORDER_EDGE_DEFAULTS, BORDER_SIDES, BORDER_STYLE_WIDTH, CellStore, DependencyGraph, FONT_STYLE_KEYS, FORMULA_ERROR_CODES, FormulaParseError, HistoryManager, InsertCellsCommand, InsertImageCommand, MergeCellsCommand, MergeManager, NUMERIC_TEXT_RE, RemoveImageCommand, SelectionModel, SetCellFormulaCommand, SetCellStyleCommand, SetCellValueCommand, Sheet, SheetGrid, StylePool, UnmergeCellsCommand, UpdateImageCommand, Workbook, boundingBox, buildBorderPresetItems, cellDataEqual, cellKey, cloneImageAnchor, cloneSheetImage, coerceToBoolean, coerceToNumber, coerceToText, colIndexToName, colNameToIndex, collectReferences, computeFillTargetRange, createImageId, createRange, defaultCommandRegistry, evaluateAst, exportSheetCsv, exportWorkbookXlsx, findAll, findNext, findNextFrom, findPrev, findPrevFrom, formatAddress, formatRange, formulaError, generateFill, importCsv, importXlsx, inferCellType, invokeFormulaFunction, isEmptyCellData, isFormulaError, isFormulaErrorCode, iterateRange, listFormulaFunctions, normalizeInputValue, parseAddress, parseFormula, parseRange, rangeContainsAddress, rangesEqual, rangesIntersect, registerFormulaFunction, replaceWorkbook, tokenizeFormula } from "@veltra/sheet-core";
-export { ALIGN_STYLE_KEYS, BORDER_EDGE_DEFAULTS, BORDER_SIDES, BORDER_STYLE_WIDTH, CellStore, DependencyGraph, FONT_STYLE_KEYS, FORMULA_ERROR_CODES, FormulaParseError, HistoryManager, InsertCellsCommand, InsertImageCommand, MergeCellsCommand, MergeManager, NUMERIC_TEXT_RE, RemoveImageCommand, SelectionModel, SetCellFormulaCommand, SetCellStyleCommand, SetCellValueCommand, Sheet, SheetGrid, StylePool, _sfc_main as USheet, UnmergeCellsCommand, UpdateImageCommand, Workbook, boundingBox, buildBorderPresetItems, cellDataEqual, cellKey, cloneImageAnchor, cloneSheetImage, coerceToBoolean, coerceToNumber, coerceToText, colIndexToName, colNameToIndex, collectReferences, computeFillTargetRange, createImageId, createRange, createSheetContext, defaultCommandRegistry, defaultToolRegistry, evaluateAst, exportSheetCsv, exportWorkbookXlsx, findAll, findNext, findNextFrom, findPrev, findPrevFrom, formatAddress, formatRange, formulaError, generateFill, importCsv, importXlsx, inferCellType, invokeFormulaFunction, isEmptyCellData, isFormulaError, isFormulaErrorCode, iterateRange, listFormulaFunctions, normalizeInputValue, parseAddress, parseFormula, parseRange, rangeContainsAddress, rangesEqual, rangesIntersect, registerFormulaFunction, registerTool, replaceWorkbook, 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, formatBindingPlaceholderParts, formatCellAddress, formatParentCandidateLabel, inferColParentCandidate, inferDropPreset, inferParentsForPreset, inferReportPreset, inferRowParentCandidate, isColGroupBinding, isExpansionBandCol, isExpansionBandRow, isHorizontalExpandBinding, isReductionAggregate, isRowGroupBinding, isVerticalExpandBinding, listColParentCandidates, listRowParentCandidates, parseCellAddress, prefersGroupParent, presetBindingPatch, presetStillApplies, 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, formatBindingPlaceholderParts, formatCellAddress, formatParentCandidateLabel, getBoundDatasetIds, getTemplateDatasets, inferColParentCandidate, inferDropPreset, inferParentsForPreset, inferReportPreset, inferRowParentCandidate, isColGroupBinding, isExpansionBandCol, isExpansionBandRow, isHorizontalExpandBinding, isReductionAggregate, isRowGroupBinding, isVerticalExpandBinding, listColParentCandidates, listRowParentCandidates, mapFilledColWidths, parseCellAddress, parseDateRangeValue, patchParamValues, prefersGroupParent, presetBindingPatch, presetStillApplies, pxToExcelColWidth, registerTool, renderReport, resolveBoundDatasetParams, resolveFilledColWidths, resolveNumberParamValue, resolveParamDefaults, resolvePortOnTypeChange, resolveRuleCompareValue, resolveTemplateParams, setBindingCatalog, toComparableNumber, unregisterTool };

package/dist/report/binding.d.ts

@@ -0,0 +1,83 @@
+import { DatasetCatalogItem, ReportAggregate, 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 isRowGroupBinding(binding: ReportBinding): boolean;
+declare function isColGroupBinding(binding: ReportBinding): boolean;
+declare function isReductionAggregate(aggregate: ReportAggregate): boolean;
+/** 小计 / 汇总 / 交叉格的父格候选只列分组头 */
+declare function prefersGroupParent(binding: ReportBinding): boolean;
+/** 当前 expand / aggregate 是否仍属于已写入的预设族（同族内改聚合不掉到「自定义」） */
+declare function presetStillApplies(binding: ReportBinding): boolean;
+type GetBindingAt = (addr: CellAddress) => ReportBinding | undefined;
+interface InferParentOptions {
+  /** 小计落格：必须优先分组头，禁止把同列/同行明细当成父格 */
+  preferGroup?: boolean;
+}
+/** 指定模板行是否含纵向扩展绑定（展开带行） */
+declare function isExpansionBandRow(row: number, getBindingAt: GetBindingAt, scanCols?: number): boolean;
+/** 指定模板列是否含横向扩展绑定（展开带列） */
+declare function isExpansionBandCol(col: number, getBindingAt: GetBindingAt, scanRows?: number): boolean;
+/** 落格时推断预设：默认明细；数值字段且位于展开带正下方或正右相邻 → 小计 */
+declare function inferDropPreset(addr: CellAddress, fieldType: DatasetCatalogItem['fields'][number]['type'], getBindingAt: GetBindingAt): ReportPreset;
+interface ListParentCandidateOptions {
+  preferGroup?: boolean;
+}
+/** 同数据集纵向扩展绑定格（行方向父格下拉候选） */
+declare function listRowParentCandidates(binding: ReportBinding, entries: ReadonlyArray<{
+  addr: CellAddress;
+  binding: ReportBinding;
+}>, options?: ListParentCandidateOptions): CellAddress[];
+/** 同数据集横向扩展绑定格（列方向父格下拉候选） */
+declare function listColParentCandidates(binding: ReportBinding, entries: ReadonlyArray<{
+  addr: CellAddress;
+  binding: ReportBinding;
+}>, options?: ListParentCandidateOptions): CellAddress[];
+/**
+ * 行方向父格推断：
+ * 1. 同行向左：先找分组头，否则最近纵向扩展格
+ * 2. 上方各行整行扫描：每行先找分组头，再退回任意纵向扩展格
+ * 小计（preferGroup）禁止把明细当成父格
+ */
+declare function inferRowParentCandidate(addr: CellAddress, getBindingAt: GetBindingAt, options?: InferParentOptions): CellAddress | null;
+/**
+ * 列方向父格推断（与行方向对称）：
+ * 1. 同列向上：先找列分组头，否则最近横向扩展格
+ * 2. 左侧各列整列扫描：每列先找列分组头
+ * 列小计（preferGroup）禁止把交叉格/明细当成列父格
+ */
+declare function inferColParentCandidate(addr: CellAddress, getBindingAt: GetBindingAt, options?: InferParentOptions): CellAddress | null;
+/**
+ * 按预设写入落格父格：明细/分组/交叉双方向推断；小计按「下方行小计 / 右侧列小计」只挂对应轴。
+ */
+declare function inferParentsForPreset(addr: CellAddress, preset: ReportPreset, getBindingAt: GetBindingAt): Pick<ReportBinding, 'rowParent' | 'colParent'>;
+/** 从绑定字段推断预设；不匹配任何预设时返回 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 formatBindingPlaceholderParts(binding: ReportBinding, resolveLabel?: (datasetId: string, fieldName: string) => string): {
+  tag: string;
+  label: string;
+};
+/** Binding Placeholder 中文可读文案（如「分组 · 客户」） */
+declare function formatBindingPlaceholder(binding: ReportBinding, resolveLabel?: (datasetId: string, fieldName: string) => string): string;
+/** 父格下拉候选文案（如「分组 · 客户 (A2)」） */
+declare function formatParentCandidateLabel(addr: CellAddress, binding: ReportBinding, resolveLabel?: (datasetId: string, fieldName: string) => string): string;
+//#endregion
+export { InferParentOptions, ListParentCandidateOptions, REPORT_META_NAMESPACE, applyReportPreset, createReportBinding, formatBindingPlaceholder, formatBindingPlaceholderParts, formatCellAddress, formatParentCandidateLabel, inferColParentCandidate, inferDropPreset, inferParentsForPreset, inferReportPreset, inferRowParentCandidate, isColGroupBinding, isExpansionBandCol, isExpansionBandRow, isHorizontalExpandBinding, isReductionAggregate, isRowGroupBinding, isVerticalExpandBinding, listColParentCandidates, listRowParentCandidates, parseCellAddress, prefersGroupParent, presetBindingPatch, presetStillApplies, setBindingCatalog };