@veltra/sheet 2.4.0 → 2.5.1

package/dist/components/report/use-report-designer.js

@@ -1,387 +0,0 @@
-import { REPORT_META_NAMESPACE, applyReportPreset, createReportBinding, formatCellAddress, inferDropPreset, inferParentsForPreset, isColGroupBinding, isHorizontalExpandBinding, isRowGroupBinding, isVerticalExpandBinding, listColParentCandidates, listRowParentCandidates, prefersGroupParent, presetStillApplies } from "../../report/binding.js";
-import { buildParamDefs } from "../../report/params.js";
-import { assertCompatibleTemplateVersion, createReportTemplate, getTemplateDatasets, resolveParamDefaults } from "../../report/template.js";
-import { createBindingBadgeRenderer, createBindingBadgeStyleResolver } from "./binding-badge.js";
-import { computed, onScopeDispose, ref, watch } from "vue";
-import { Workbook } from "@veltra/sheet-core";
-//#region src/components/report/use-report-designer.ts
-/**
-* UReportDesigner 的 headless 编排：连接 / 数据集状态、绑定写 Cell Meta、
-* 角色徽章渲染 hook、`getTemplate()` 模板吐出。不持有 DOM / 网格引用。
-*/
-function useReportDesigner(options) {
-	const { props, connections } = options;
-	/** 设计态工作簿：宿主可注入（USheet / UReportViewer 先例），缺省内部自建 */
-	const internalWorkbook = new Workbook();
-	const workbook = computed(() => props.workbook ?? internalWorkbook);
-	const datasets = ref([]);
-	/** meta 变更计数：boundKeys 等派生状态的响应式触发（绑定经命令系统写入后由模型发 meta-change） */
-	const metaTick = ref(0);
-	const parentPick = ref(null);
-	const offMeta = workbook.value.activeSheet.on("meta-change", () => {
-		metaTick.value++;
-	});
-	onScopeDispose(offMeta);
-	/** 稳定选区地址引用（值未变时不替换对象，避免触发下游 watcher） */
-	const activeCell = ref(null);
-	function syncActiveCell() {
-		const next = workbook.value.activeSheet.getSelection().activeCell ?? null;
-		const prev = activeCell.value;
-		if (!next) {
-			activeCell.value = null;
-			return;
-		}
-		if (prev && prev.row === next.row && prev.col === next.col) return;
-		activeCell.value = {
-			row: next.row,
-			col: next.col
-		};
-	}
-	const offSelection = workbook.value.activeSheet.on("selection-change", syncActiveCell);
-	onScopeDispose(offSelection);
-	syncActiveCell();
-	const selectionLabel = computed(() => activeCell.value ? formatCellAddress(activeCell.value) : "—");
-	const catalog = computed(() => datasets.value.map((dataset) => ({
-		id: dataset.id,
-		label: dataset.label,
-		fields: (dataset.fields ?? []).map((field) => ({
-			...field,
-			label: dataset.fieldOverrides?.[field.name]?.label ?? field.label
-		}))
-	})));
-	/** 字段 label 的 O(1) 查找表（徽章 hook 性能契约） */
-	const fieldLabelMap = computed(() => {
-		const map = /* @__PURE__ */ new Map();
-		for (const dataset of catalog.value) for (const field of dataset.fields) map.set(`${dataset.id}:${field.name}`, field.label);
-		return map;
-	});
-	function resolveFieldLabel(datasetId, fieldName) {
-		return fieldLabelMap.value.get(`${datasetId}:${fieldName}`) ?? fieldName;
-	}
-	const boundKeys = computed(() => {
-		metaTick.value;
-		const keys = /* @__PURE__ */ new Set();
-		for (const [, namespace, payload] of workbook.value.activeSheet.entriesCellMeta()) {
-			if (namespace !== "report") continue;
-			const binding = payload;
-			keys.add(`${binding.dataset}:${binding.field}`);
-		}
-		return keys;
-	});
-	function getBindingAt(addr) {
-		return workbook.value.activeSheet.getCellMeta(addr, REPORT_META_NAMESPACE);
-	}
-	function bindField(datasetId, fieldName, addr) {
-		const dataset = catalog.value.find((item) => item.id === datasetId);
-		if (!dataset) return;
-		const field = dataset.fields.find((item) => item.name === fieldName);
-		const target = addr ?? workbook.value.activeSheet.getSelection().activeCell;
-		if (!target) return;
-		const preset = inferDropPreset(target, field?.type ?? "string", getBindingAt);
-		let binding = createReportBinding(dataset, fieldName);
-		binding = applyReportPreset(binding, preset);
-		const parents = inferParentsForPreset(target, preset, getBindingAt);
-		if (parents.rowParent) binding.rowParent = parents.rowParent;
-		if (parents.colParent) binding.colParent = parents.colParent;
-		workbook.value.activeSheet.setCellMeta(target, REPORT_META_NAMESPACE, binding);
-	}
-	const activeBinding = computed(() => {
-		metaTick.value;
-		const cell = activeCell.value;
-		if (!cell) return void 0;
-		return getBindingAt(cell);
-	});
-	const activeFieldType = computed(() => {
-		const binding = activeBinding.value;
-		if (!binding) return "number";
-		return (catalog.value.find((item) => item.id === binding.dataset)?.fields.find((item) => item.name === binding.field))?.type ?? "number";
-	});
-	const activeDatasetFields = computed(() => {
-		const binding = activeBinding.value;
-		if (!binding) return [];
-		return catalog.value.find((item) => item.id === binding.dataset)?.fields ?? [];
-	});
-	const resolvedRowParentLabel = computed(() => {
-		metaTick.value;
-		const binding = activeBinding.value;
-		if (!binding?.rowParent) return "—";
-		return formatCellAddress(binding.rowParent);
-	});
-	const resolvedColParentLabel = computed(() => {
-		metaTick.value;
-		const binding = activeBinding.value;
-		if (!binding?.colParent) return "—";
-		return formatCellAddress(binding.colParent);
-	});
-	const rowParentCandidates = computed(() => {
-		metaTick.value;
-		const binding = activeBinding.value;
-		if (!binding) return [];
-		return listRowParentCandidates(binding, bindingEntries.value, { preferGroup: prefersGroupParent(binding) });
-	});
-	const colParentCandidates = computed(() => {
-		metaTick.value;
-		const binding = activeBinding.value;
-		if (!binding) return [];
-		return listColParentCandidates(binding, bindingEntries.value, { preferGroup: prefersGroupParent(binding) });
-	});
-	const bindingEntries = computed(() => {
-		metaTick.value;
-		const entries = [];
-		for (const [addr, namespace, payload] of workbook.value.activeSheet.entriesCellMeta()) {
-			if (namespace !== "report") continue;
-			entries.push({
-				addr,
-				binding: payload
-			});
-		}
-		return entries;
-	});
-	function parentNeedsCorrection(addr) {
-		if (!addr) return true;
-		const parent = getBindingAt(addr);
-		return !parent || parent.aggregate === "list";
-	}
-	function patchActiveBinding(patch) {
-		const cell = activeCell.value;
-		const binding = activeBinding.value;
-		if (!cell || !binding) return;
-		const next = {
-			...binding,
-			...patch
-		};
-		if ("rowParent" in patch && patch.rowParent === void 0) delete next.rowParent;
-		if ("colParent" in patch && patch.colParent === void 0) delete next.colParent;
-		if ("drill" in patch && patch.drill === void 0) delete next.drill;
-		if (("aggregate" in patch || "expand" in patch) && !("preset" in patch) && !presetStillApplies(next)) delete next.preset;
-		if (patch.preset === "subtotal") {
-			const inferred = inferParentsForPreset(cell, "subtotal", getBindingAt);
-			if (parentNeedsCorrection(next.rowParent)) {
-				if (inferred.rowParent) next.rowParent = inferred.rowParent;
-				else delete next.rowParent;
-			}
-			if (parentNeedsCorrection(next.colParent)) {
-				if (inferred.colParent) next.colParent = inferred.colParent;
-				else delete next.colParent;
-			}
-		}
-		workbook.value.activeSheet.setCellMeta(cell, REPORT_META_NAMESPACE, next);
-	}
-	function startParentPick(mode) {
-		const cell = activeCell.value;
-		if (!cell || !activeBinding.value) return;
-		parentPick.value = {
-			mode,
-			source: {
-				row: cell.row,
-				col: cell.col
-			}
-		};
-	}
-	function cancelParentPick() {
-		parentPick.value = null;
-	}
-	function isValidParentTarget(mode, source, target) {
-		if (!target) return false;
-		if (target.dataset !== source.dataset) return false;
-		const groupOnly = prefersGroupParent(source);
-		if (mode === "row") return groupOnly ? isRowGroupBinding(target) : isVerticalExpandBinding(target);
-		return groupOnly ? isColGroupBinding(target) : isHorizontalExpandBinding(target);
-	}
-	function pickParentAt(target) {
-		const pick = parentPick.value;
-		if (!pick) return;
-		if (target.row === pick.source.row && target.col === pick.source.col) return;
-		const sourceBinding = getBindingAt(pick.source);
-		if (!sourceBinding) {
-			parentPick.value = null;
-			return;
-		}
-		const targetBinding = getBindingAt(target);
-		if (!isValidParentTarget(pick.mode, sourceBinding, targetBinding)) {
-			workbook.value.activeSheet.selectCell(pick.source);
-			return;
-		}
-		const patch = pick.mode === "row" ? { rowParent: { ...target } } : { colParent: { ...target } };
-		const next = {
-			...sourceBinding,
-			...patch
-		};
-		workbook.value.activeSheet.setCellMeta(pick.source, REPORT_META_NAMESPACE, next);
-		parentPick.value = null;
-		workbook.value.activeSheet.selectCell(pick.source);
-	}
-	function clearParent(mode) {
-		if (mode === "row") patchActiveBinding({ rowParent: void 0 });
-		else patchActiveBinding({ colParent: void 0 });
-	}
-	function removeActiveBinding() {
-		const cell = activeCell.value;
-		if (!cell) return;
-		workbook.value.activeSheet.clearCellMeta(cell, REPORT_META_NAMESPACE);
-	}
-	function addConnection(connection) {
-		connections.value = [...connections.value, connection];
-	}
-	function updateConnection(connection) {
-		connections.value = connections.value.map((item) => item.id === connection.id ? connection : item);
-	}
-	function removeConnection(connectionId) {
-		connections.value = connections.value.filter((item) => item.id !== connectionId);
-		datasets.value = datasets.value.filter((dataset) => dataset.connectionId !== connectionId);
-	}
-	let datasetSeq = 0;
-	function addDataset(connectionId) {
-		const dataset = {
-			id: `dataset-${Date.now()}-${datasetSeq++}`,
-			label: "新数据集",
-			connectionId,
-			sql: ""
-		};
-		datasets.value = [...datasets.value, dataset];
-		return dataset;
-	}
-	function updateDataset(datasetId, patch) {
-		datasets.value = datasets.value.map((item) => item.id === datasetId ? {
-			...item,
-			...patch
-		} : item);
-	}
-	function removeDataset(datasetId) {
-		datasets.value = datasets.value.filter((item) => item.id !== datasetId);
-	}
-	function resolveDatasetConnection(dataset) {
-		return connections.value.find((item) => item.id === dataset.connectionId);
-	}
-	function datasetNotFound() {
-		return {
-			ok: false,
-			error: {
-				code: "DATASET_NOT_FOUND",
-				message: "数据集不存在"
-			}
-		};
-	}
-	function connectionNotFound() {
-		return {
-			ok: false,
-			error: {
-				code: "CONNECTION_NOT_FOUND",
-				message: "数据集所属连接不存在"
-			}
-		};
-	}
-	function testConnection(connection) {
-		return props.connector.test(connection);
-	}
-	async function describeDataset(datasetId) {
-		const dataset = datasets.value.find((item) => item.id === datasetId);
-		if (!dataset) return datasetNotFound();
-		const connection = resolveDatasetConnection(dataset);
-		if (!connection) return connectionNotFound();
-		const sql = dataset.sql;
-		const result = await props.connector.describe(connection, sql);
-		if (result.ok) {
-			const current = datasets.value.find((item) => item.id === datasetId);
-			if (current && current.sql === sql) updateDataset(datasetId, { fields: result.data });
-		}
-		return result;
-	}
-	async function previewDataset(datasetId) {
-		const dataset = datasets.value.find((item) => item.id === datasetId);
-		if (!dataset) return datasetNotFound();
-		const connection = resolveDatasetConnection(dataset);
-		if (!connection) return connectionNotFound();
-		const values = resolveParamDefaults(buildParamDefs(dataset.sql, dataset.paramOverrides));
-		return props.connector.query(connection, dataset.sql, values);
-	}
-	const resolveCellStyle = createBindingBadgeStyleResolver(getBindingAt);
-	const resolveCellRenderer = createBindingBadgeRenderer(getBindingAt, resolveFieldLabel, (addr) => workbook.value.activeSheet.getEffectiveStyle(addr)?.align);
-	function getTemplate() {
-		const resolved = datasets.value.flatMap((dataset) => {
-			const connection = resolveDatasetConnection(dataset);
-			if (!connection) return [];
-			return [{
-				id: dataset.id,
-				label: dataset.label,
-				connection: { ...connection },
-				sql: dataset.sql,
-				...dataset.paramOverrides ? { paramOverrides: dataset.paramOverrides } : {},
-				...dataset.fieldOverrides ? { fieldOverrides: dataset.fieldOverrides } : {}
-			}];
-		});
-		return createReportTemplate(workbook.value.activeSheet.snapshot(), resolved);
-	}
-	/**
-	* 载入既有 Report Template 继续设计（`template` prop）：
-	* 快照恢复网格绑定（restore + restoreContent 与查看器同路径）；
-	* 内嵌数据集定义还原为设计态（connectionId 引用），内嵌连接按 id 合并进
-	* v-model 连接列表（仅缺省追加，宿主列表是单一事实源）；
-	* describe 恢复字段缓存（字段面板数据源），业务错误忽略（字段留空，可在数据中枢重试）。
-	*/
-	function loadTemplate(template) {
-		assertCompatibleTemplateVersion(template);
-		const sheet = workbook.value.activeSheet;
-		sheet.restore(template);
-		sheet.restoreContent(template);
-		sheet.history.clear();
-		syncActiveCell();
-		const defs = getTemplateDatasets(template);
-		datasets.value = defs.map((def) => ({
-			id: def.id,
-			label: def.label,
-			connectionId: def.connection.id,
-			sql: def.sql,
-			...def.paramOverrides ? { paramOverrides: def.paramOverrides } : {},
-			...def.fieldOverrides ? { fieldOverrides: def.fieldOverrides } : {}
-		}));
-		const missing = defs.map((def) => def.connection).filter((connection) => !connections.value.some((item) => item.id === connection.id));
-		if (missing.length > 0) connections.value = [...connections.value, ...missing.map((connection) => ({ ...connection }))];
-		for (const dataset of datasets.value) if (dataset.sql.trim()) describeDataset(dataset.id);
-	}
-	watch(() => props.template, (template) => {
-		if (template) loadTemplate(template);
-	}, { immediate: true });
-	return {
-		workbook,
-		connections,
-		datasets,
-		catalog,
-		boundKeys,
-		activeCell,
-		selectionLabel,
-		activeBinding,
-		activeFieldType,
-		activeDatasetFields,
-		resolvedRowParentLabel,
-		resolvedColParentLabel,
-		parentPick,
-		rowParentCandidates,
-		colParentCandidates,
-		bindingEntries,
-		metaTick,
-		getBindingAt,
-		resolveFieldLabel,
-		bindField,
-		patchActiveBinding,
-		startParentPick,
-		cancelParentPick,
-		pickParentAt,
-		clearParent,
-		removeActiveBinding,
-		resolveCellStyle,
-		resolveCellRenderer,
-		getTemplate,
-		addConnection,
-		updateConnection,
-		removeConnection,
-		addDataset,
-		updateDataset,
-		removeDataset,
-		testConnection,
-		describeDataset,
-		previewDataset
-	};
-}
-//#endregion
-export { useReportDesigner };

package/dist/components/report/use-report-viewer.js

@@ -1,140 +0,0 @@
-import { buildDrillHitMap, createDrillStack, currentDrillLayer, popDrillLayer, pushDrillLayer, resolveDrillParams } from "../../report/drill.js";
-import { renderReport, resolveFilledColWidths } from "../../report/render/index.js";
-import { fetchTemplateRecords, resolveParamDefaults, resolveTemplateParams } from "../../report/template.js";
-import { computed, ref, shallowRef, watch } from "vue";
-import { cellKey } from "@veltra/sheet-core";
-//#region src/components/report/use-report-viewer.ts
-/**
-* UReportViewer 的 headless 编排：参数提取 → 取数 → renderReport 展开。
-* 不持有 DOM / 网格引用；填充快照经 `filledSnapshot` 交给组件壳应用。
-* 下钻：openMode 'switch' 栈式切换当前层；'dialog' 由组件壳解析目标后嵌套独立查看器。
-* 导出 / 打印始终作用于当前可见层。
-*/
-function useReportViewer(props) {
-	const loading = ref(false);
-	const error = shallowRef(null);
-	const filledSnapshot = shallowRef(null);
-	const filledColWidths = shallowRef(void 0);
-	const drillStack = shallowRef(null);
-	const drillHits = shallowRef(/* @__PURE__ */ new Map());
-	const currentTemplate = computed(() => {
-		const stack = drillStack.value;
-		return stack ? currentDrillLayer(stack).template : props.template;
-	});
-	const drillDepth = computed(() => (drillStack.value?.length ?? 1) - 1);
-	const canDrillBack = computed(() => drillDepth.value > 0);
-	const params = computed(() => resolveTemplateParams(currentTemplate.value));
-	const values = shallowRef({});
-	let fetchSeq = 0;
-	async function refresh() {
-		const current = ++fetchSeq;
-		const template = currentTemplate.value;
-		loading.value = true;
-		error.value = null;
-		const result = await fetchTemplateRecords(props.connector, template, values.value);
-		if (current !== fetchSeq) return;
-		loading.value = false;
-		if (!result.ok) {
-			error.value = result.error;
-			filledColWidths.value = void 0;
-			return;
-		}
-		filledSnapshot.value = renderReport(template, result.data);
-		filledColWidths.value = template.colWidths?.length ? resolveFilledColWidths(template, result.data, template.colWidths) : void 0;
-		drillHits.value = props.resolveTemplate ? buildDrillHitMap(template, result.data) : /* @__PURE__ */ new Map();
-	}
-	/** 切层共有收尾：清填充结果与命中索引，写入新层参数并重新取数 */
-	function transitionTo(layerParams) {
-		filledSnapshot.value = null;
-		filledColWidths.value = void 0;
-		drillHits.value = /* @__PURE__ */ new Map();
-		values.value = layerParams;
-		return refresh();
-	}
-	async function resolveDrillTarget(config, record) {
-		const resolve = props.resolveTemplate;
-		if (!resolve) return null;
-		let target;
-		try {
-			target = await resolve(config.target);
-		} catch (err) {
-			error.value = {
-				code: "DRILL_RESOLVE_FAILED",
-				message: err instanceof Error ? err.message : String(err)
-			};
-			return null;
-		}
-		if (!target) {
-			error.value = {
-				code: "DRILL_RESOLVE_FAILED",
-				message: `下钻目标模板解析失败：${config.target}`
-			};
-			return null;
-		}
-		error.value = null;
-		return {
-			template: target,
-			params: {
-				...resolveParamDefaults(resolveTemplateParams(target)),
-				...resolveDrillParams(config, record)
-			}
-		};
-	}
-	async function drillInto(config, record) {
-		const next = await resolveDrillTarget(config, record);
-		if (!next) return;
-		const base = drillStack.value ?? createDrillStack({
-			template: props.template,
-			params: values.value
-		});
-		drillStack.value = pushDrillLayer(base, {
-			template: next.template,
-			params: next.params
-		}, values.value);
-		await transitionTo(next.params);
-	}
-	async function drillBack() {
-		const stack = drillStack.value;
-		if (!stack || stack.length <= 1) return;
-		const next = popDrillLayer(stack);
-		drillStack.value = next;
-		await transitionTo({ ...currentDrillLayer(next).params });
-	}
-	function resolveDrillHit(addr) {
-		return drillHits.value.get(cellKey(addr)) ?? null;
-	}
-	function setValues(next) {
-		values.value = next;
-		refresh();
-	}
-	watch(() => props.template, () => {
-		drillStack.value = null;
-		drillHits.value = /* @__PURE__ */ new Map();
-		filledSnapshot.value = null;
-		filledColWidths.value = void 0;
-		values.value = {
-			...resolveParamDefaults(params.value),
-			...props.initialValues
-		};
-		refresh();
-	}, { immediate: true });
-	return {
-		params,
-		values,
-		loading,
-		error,
-		filledSnapshot,
-		filledColWidths,
-		currentTemplate,
-		drillDepth,
-		canDrillBack,
-		resolveDrillHit,
-		resolveDrillTarget,
-		drillInto,
-		drillBack,
-		refresh,
-		setValues
-	};
-}
-//#endregion
-export { useReportViewer };

package/dist/report/binding.d.ts

@@ -1,83 +0,0 @@
-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 };