@veltra/sheet 2.4.0 → 2.5.1

package/dist/report/binding.js

@@ -1,334 +0,0 @@
-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" || binding.aggregate === "list");
-}
-function isRowGroupBinding(binding) {
-	return binding.expand === "down" && binding.aggregate === "group";
-}
-function isColGroupBinding(binding) {
-	return binding.expand === "right" && binding.aggregate === "group";
-}
-function isReductionAggregate(aggregate) {
-	return aggregate === "sum" || aggregate === "avg" || aggregate === "count" || aggregate === "max" || aggregate === "min";
-}
-/** 小计 / 汇总 / 交叉格的父格候选只列分组头 */
-function prefersGroupParent(binding) {
-	if (binding.preset === "subtotal" || binding.preset === "grandTotal" || binding.preset === "cross") return true;
-	return binding.expand === "none" && isReductionAggregate(binding.aggregate);
-}
-/** 当前 expand / aggregate 是否仍属于已写入的预设族（同族内改聚合不掉到「自定义」） */
-function presetStillApplies(binding) {
-	const preset = binding.preset;
-	if (!preset) return false;
-	if (preset === "groupHeader") return binding.aggregate === "group" && (binding.expand === "down" || binding.expand === "right");
-	if (preset === "detail") return binding.aggregate === "list" && (binding.expand === "down" || binding.expand === "right");
-	return binding.expand === "none" && isReductionAggregate(binding.aggregate);
-}
-const DEFAULT_SCAN_COLS = 64;
-const DEFAULT_SCAN_ROWS = 64;
-/** 指定模板行是否含纵向扩展绑定（展开带行） */
-function isExpansionBandRow(row, getBindingAt, scanCols = DEFAULT_SCAN_COLS) {
-	for (let col = 0; col < scanCols; col++) {
-		const binding = getBindingAt({
-			row,
-			col
-		});
-		if (binding && isVerticalExpandBinding(binding)) return true;
-	}
-	return false;
-}
-/** 指定模板列是否含横向扩展绑定（展开带列） */
-function isExpansionBandCol(col, getBindingAt, scanRows = DEFAULT_SCAN_ROWS) {
-	for (let row = 0; row < scanRows; row++) {
-		const binding = getBindingAt({
-			row,
-			col
-		});
-		if (binding && isHorizontalExpandBinding(binding)) return true;
-	}
-	return false;
-}
-/** 落格时推断预设：默认明细；数值字段且位于展开带正下方或正右相邻 → 小计 */
-function inferDropPreset(addr, fieldType, getBindingAt) {
-	if (fieldType !== "number") return "detail";
-	if (addr.row > 0 && isExpansionBandRow(addr.row - 1, getBindingAt)) return "subtotal";
-	if (addr.col > 0 && isExpansionBandCol(addr.col - 1, getBindingAt)) return "subtotal";
-	return "detail";
-}
-/** 同数据集纵向扩展绑定格（行方向父格下拉候选） */
-function listRowParentCandidates(binding, entries, options) {
-	const preferGroup = options?.preferGroup === true;
-	const candidates = [];
-	for (const entry of entries) {
-		if (entry.binding.dataset !== binding.dataset) continue;
-		if (preferGroup) {
-			if (!isRowGroupBinding(entry.binding)) continue;
-		} else if (!isVerticalExpandBinding(entry.binding)) continue;
-		candidates.push(entry.addr);
-	}
-	return candidates;
-}
-/** 同数据集横向扩展绑定格（列方向父格下拉候选） */
-function listColParentCandidates(binding, entries, options) {
-	const preferGroup = options?.preferGroup === true;
-	const candidates = [];
-	for (const entry of entries) {
-		if (entry.binding.dataset !== binding.dataset) continue;
-		if (preferGroup) {
-			if (!isColGroupBinding(entry.binding)) continue;
-		} else if (!isHorizontalExpandBinding(entry.binding)) continue;
-		candidates.push(entry.addr);
-	}
-	return candidates;
-}
-function betterHit(current, next) {
-	if (!current) return true;
-	if (next.distance !== current.distance) return next.distance < current.distance;
-	return next.addr.col + next.addr.row < current.addr.col + current.addr.row;
-}
-function pickExpandHit(hits, preferGroup) {
-	let group = null;
-	let expand = null;
-	for (const hit of hits) {
-		if (hit.group && betterHit(group, hit)) group = hit;
-		if (betterHit(expand, hit)) expand = hit;
-	}
-	if (preferGroup) return group?.addr ?? null;
-	return group?.addr ?? expand?.addr ?? null;
-}
-function scanVerticalOnRow(row, originCol, colStart, colEnd, getBindingAt) {
-	const hits = [];
-	for (let col = colStart; col < colEnd; col++) {
-		const binding = getBindingAt({
-			row,
-			col
-		});
-		if (!binding || !isVerticalExpandBinding(binding)) continue;
-		hits.push({
-			addr: {
-				row,
-				col
-			},
-			group: isRowGroupBinding(binding),
-			distance: Math.abs(col - originCol)
-		});
-	}
-	return hits;
-}
-function scanHorizontalOnCol(col, originRow, rowStart, rowEnd, getBindingAt) {
-	const hits = [];
-	for (let row = rowStart; row < rowEnd; row++) {
-		const binding = getBindingAt({
-			row,
-			col
-		});
-		if (!binding || !isHorizontalExpandBinding(binding)) continue;
-		hits.push({
-			addr: {
-				row,
-				col
-			},
-			group: isColGroupBinding(binding),
-			distance: Math.abs(row - originRow)
-		});
-	}
-	return hits;
-}
-/**
-* 行方向父格推断：
-* 1. 同行向左：先找分组头，否则最近纵向扩展格
-* 2. 上方各行整行扫描：每行先找分组头，再退回任意纵向扩展格
-* 小计（preferGroup）禁止把明细当成父格
-*/
-function inferRowParentCandidate(addr, getBindingAt, options) {
-	const preferGroup = options?.preferGroup === true;
-	const sameRow = pickExpandHit(scanVerticalOnRow(addr.row, addr.col, 0, addr.col, getBindingAt), preferGroup);
-	if (sameRow) return sameRow;
-	for (let row = addr.row - 1; row >= 0; row--) {
-		const found = pickExpandHit(scanVerticalOnRow(row, addr.col, 0, DEFAULT_SCAN_COLS, getBindingAt), preferGroup);
-		if (found) return found;
-	}
-	return null;
-}
-/**
-* 列方向父格推断（与行方向对称）：
-* 1. 同列向上：先找列分组头，否则最近横向扩展格
-* 2. 左侧各列整列扫描：每列先找列分组头
-* 列小计（preferGroup）禁止把交叉格/明细当成列父格
-*/
-function inferColParentCandidate(addr, getBindingAt, options) {
-	const preferGroup = options?.preferGroup === true;
-	const sameCol = pickExpandHit(scanHorizontalOnCol(addr.col, addr.row, 0, addr.row, getBindingAt), preferGroup);
-	if (sameCol) return sameCol;
-	for (let col = addr.col - 1; col >= 0; col--) {
-		const found = pickExpandHit(scanHorizontalOnCol(col, addr.row, 0, DEFAULT_SCAN_ROWS, getBindingAt), preferGroup);
-		if (found) return found;
-	}
-	return null;
-}
-function suggestsColumnSubtotal(above) {
-	if (!above) return false;
-	return isHorizontalExpandBinding(above) || !!above.colParent || above.preset === "cross";
-}
-function suggestsRowSubtotal(left) {
-	if (!left) return false;
-	return isVerticalExpandBinding(left) || !!left.rowParent || left.preset === "cross";
-}
-/**
-* 按预设写入落格父格：明细/分组/交叉双方向推断；小计按「下方行小计 / 右侧列小计」只挂对应轴。
-*/
-function inferParentsForPreset(addr, preset, getBindingAt) {
-	if (preset === "grandTotal") return {};
-	const preferGroup = preset === "subtotal" || preset === "cross";
-	const rowParent = inferRowParentCandidate(addr, getBindingAt, { preferGroup }) ?? void 0;
-	const colParent = inferColParentCandidate(addr, getBindingAt, { preferGroup }) ?? void 0;
-	if (preset !== "subtotal") return {
-		...rowParent ? { rowParent } : {},
-		...colParent ? { colParent } : {}
-	};
-	const above = addr.row > 0 ? getBindingAt({
-		row: addr.row - 1,
-		col: addr.col
-	}) : void 0;
-	const left = addr.col > 0 ? getBindingAt({
-		row: addr.row,
-		col: addr.col - 1
-	}) : void 0;
-	const belowBand = addr.row > 0 && isExpansionBandRow(addr.row - 1, getBindingAt);
-	const rightOfBand = addr.col > 0 && isExpansionBandCol(addr.col - 1, getBindingAt);
-	const columnSubtotal = suggestsColumnSubtotal(above) || rightOfBand && !suggestsRowSubtotal(left);
-	const rowSubtotal = suggestsRowSubtotal(left) || belowBand && !columnSubtotal;
-	const result = {};
-	if (rowSubtotal && rowParent) result.rowParent = rowParent;
-	if (columnSubtotal && colParent) result.colParent = colParent;
-	if (!rowSubtotal && !columnSubtotal) {
-		if (belowBand && rowParent) result.rowParent = rowParent;
-		else if (rightOfBand && colParent) result.colParent = colParent;
-		else {
-			if (rowParent) result.rowParent = rowParent;
-			if (colParent) result.colParent = colParent;
-		}
-	}
-	return result;
-}
-/** 从绑定字段推断预设；不匹配任何预设时返回 null（自定义） */
-function inferReportPreset(binding) {
-	if (binding.preset) return binding.preset;
-	if (binding.expand === "none" && isReductionAggregate(binding.aggregate)) {
-		if (binding.rowParent && binding.colParent) return "cross";
-		if (binding.rowParent || binding.colParent) return "subtotal";
-		return "grandTotal";
-	}
-	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 formatBindingPlaceholderParts(binding, resolveLabel) {
-	return {
-		tag: AGGREGATE_PLACEHOLDER_TAG[binding.aggregate],
-		label: resolveFieldLabel(binding.dataset, binding.field, resolveLabel)
-	};
-}
-/** Binding Placeholder 中文可读文案（如「分组 · 客户」） */
-function formatBindingPlaceholder(binding, resolveLabel) {
-	const { tag, label } = formatBindingPlaceholderParts(binding, resolveLabel);
-	return `${tag} · ${label}`;
-}
-/** 父格下拉候选文案（如「分组 · 客户 (A2)」） */
-function formatParentCandidateLabel(addr, binding, resolveLabel) {
-	return `${formatBindingPlaceholder(binding, resolveLabel)} (${formatCellAddress(addr)})`;
-}
-//#endregion
-export { 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 };

package/dist/report/connector.d.ts

@@ -1,66 +0,0 @@
-import { DatasetField, ParamValues } from "./types.js";
-//#region src/report/connector.d.ts
-/** 数据连接类型（ADR-0003 决策 3：收敛为 MySQL / PostgreSQL） */
-type ConnectionType = 'mysql' | 'postgresql';
-/** 各连接类型的默认端口 */
-declare const DEFAULT_CONNECTION_PORTS: Record<ConnectionType, number>;
-/**
- * 切换连接类型时解析端口：若当前端口仍是上一类型的默认值（或 0），则切到新类型默认端口；
- * 用户已自定义的端口保持不变。
- */
-declare function resolvePortOnTypeChange(prevType: ConnectionType, nextType: ConnectionType, currentPort: number): number;
-/**
- * 数据连接（纯序列化对象，仅驻留内存）。
- * 凭据持久化与安全存储由下游负责（ADR-0003 决策 4）。
- */
-interface DataConnection {
-  id: string;
-  label: string;
-  type: ConnectionType;
-  host: string;
-  port: number;
-  database: string;
-  username: string;
-  password: string;
-}
-/** 业务错误（`200 + { ok: false, error }`）或客户端传输层错误 */
-interface ConnectorError {
-  code: string;
-  message: string;
-}
-/** 统一结果：成功携带 data；失败携带 error（连接器不抛异常，调用方只处理一条错误路径） */
-type Result<T> = {
-  ok: true;
-  data: T;
-} | {
-  ok: false;
-  error: ConnectorError;
-};
-/** query 成功结果：字段 schema + 行记录（契约 `{ fields, rows }` 归一化后） */
-interface QueryResult {
-  fields: DatasetField[];
-  rows: Record<string, unknown>[];
-}
-/**
- * 数据连接器（词汇表：Data Connector）：test / describe / query 三方法镜像 HTTP 契约三端点。
- * 真实数据库访问由下游后端以任意语言实现（BYO）。
- */
-interface DataConnector {
-  test(connection: DataConnection): Promise<Result<void>>;
-  describe(connection: DataConnection, sql: string): Promise<Result<DatasetField[]>>;
-  query(connection: DataConnection, sql: string, values: ParamValues): Promise<Result<QueryResult>>;
-}
-interface CreateHttpConnectorOptions {
-  /** 契约端点前缀，如 `https://api.example.com/report`；三端点 = `{endpoint}/test|describe|query`（无版本段） */
-  endpoint: string;
-}
-/**
- * 创建 HTTP 数据连接器：三方法对应 `POST {endpoint}/test|describe|query`。
- * - 请求体 JSON 序列化，`Content-Type: application/json`；
- * - 网络异常与非 2xx（传输层错误）折叠为 `{ ok: false, error }`，不抛异常；
- * - 业务错误（连接失败 / SQL 报错）由服务端以 `200 + { ok: false, error: { code, message } }` 返回并原样透传；
- * - `describe` / `query` 的 fields 归一化为内核 `DatasetField`（label 回退 name，type 缺省 string）。
- */
-declare function createHttpConnector({ endpoint }: CreateHttpConnectorOptions): DataConnector;
-//#endregion
-export { ConnectionType, ConnectorError, CreateHttpConnectorOptions, DEFAULT_CONNECTION_PORTS, DataConnection, DataConnector, QueryResult, Result, createHttpConnector, resolvePortOnTypeChange };

package/dist/report/connector.js

@@ -1,159 +0,0 @@
-//#region src/report/connector.ts
-/** 各连接类型的默认端口 */
-const DEFAULT_CONNECTION_PORTS = {
-	mysql: 3306,
-	postgresql: 5432
-};
-/**
-* 切换连接类型时解析端口：若当前端口仍是上一类型的默认值（或 0），则切到新类型默认端口；
-* 用户已自定义的端口保持不变。
-*/
-function resolvePortOnTypeChange(prevType, nextType, currentPort) {
-	if (prevType === nextType) return currentPort;
-	if (currentPort === DEFAULT_CONNECTION_PORTS[prevType] || currentPort === 0) return DEFAULT_CONNECTION_PORTS[nextType];
-	return currentPort;
-}
-/** 客户端错误：网络不可达 / 非 2xx / 响应不可解析（业务错误由服务端 200 透传） */
-function badResponse(message) {
-	return {
-		ok: false,
-		error: {
-			code: "BAD_RESPONSE",
-			message
-		}
-	};
-}
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function toConnectorError(value) {
-	if (isRecord(value)) {
-		const { code, message } = value;
-		if (typeof code === "string" && typeof message === "string") return {
-			code,
-			message
-		};
-	}
-	return {
-		code: "SERVER_ERROR",
-		message: "服务端返回未知错误"
-	};
-}
-/** 契约字段 → 内核 DatasetField（label 缺省回退 name，type 缺省 string） */
-function normalizeField(field) {
-	return {
-		name: field.name,
-		label: field.label ?? field.name,
-		type: field.type ?? "string"
-	};
-}
-/** 校验并归一化契约 fields；形状不合法返回 null */
-function normalizeFields(fields) {
-	if (!Array.isArray(fields)) return null;
-	const normalized = [];
-	for (const field of fields) {
-		if (!isRecord(field) || typeof field.name !== "string") return null;
-		normalized.push(normalizeField(field));
-	}
-	return normalized;
-}
-/**
-* 创建 HTTP 数据连接器：三方法对应 `POST {endpoint}/test|describe|query`。
-* - 请求体 JSON 序列化，`Content-Type: application/json`；
-* - 网络异常与非 2xx（传输层错误）折叠为 `{ ok: false, error }`，不抛异常；
-* - 业务错误（连接失败 / SQL 报错）由服务端以 `200 + { ok: false, error: { code, message } }` 返回并原样透传；
-* - `describe` / `query` 的 fields 归一化为内核 `DatasetField`（label 回退 name，type 缺省 string）。
-*/
-function createHttpConnector({ endpoint }) {
-	async function postJson(path, body) {
-		let response;
-		try {
-			response = await fetch(`${endpoint}${path}`, {
-				method: "POST",
-				headers: { "Content-Type": "application/json" },
-				body: JSON.stringify(body)
-			});
-		} catch (error) {
-			return {
-				ok: false,
-				error: {
-					code: "NETWORK_ERROR",
-					message: error instanceof Error ? error.message : String(error)
-				}
-			};
-		}
-		if (!response.ok) return {
-			ok: false,
-			error: {
-				code: `HTTP_${response.status}`,
-				message: `请求失败（HTTP ${response.status}）`
-			}
-		};
-		let payload;
-		try {
-			payload = await response.json();
-		} catch {
-			return badResponse("响应不是合法 JSON");
-		}
-		if (!isRecord(payload)) return badResponse("响应不是 JSON 对象");
-		return {
-			ok: true,
-			data: payload
-		};
-	}
-	return {
-		async test(connection) {
-			const result = await postJson("/test", { connection });
-			if (!result.ok) return result;
-			if (result.data.ok === true) return {
-				ok: true,
-				data: void 0
-			};
-			return {
-				ok: false,
-				error: toConnectorError(result.data.error)
-			};
-		},
-		async describe(connection, sql) {
-			const result = await postJson("/describe", {
-				connection,
-				sql
-			});
-			if (!result.ok) return result;
-			if (result.data.ok !== true) return {
-				ok: false,
-				error: toConnectorError(result.data.error)
-			};
-			const fields = normalizeFields(result.data.fields);
-			if (!fields) return badResponse("describe 响应缺少合法的 fields 数组");
-			return {
-				ok: true,
-				data: fields
-			};
-		},
-		async query(connection, sql, values) {
-			const result = await postJson("/query", {
-				connection,
-				sql,
-				values
-			});
-			if (!result.ok) return result;
-			if (result.data.ok !== true) return {
-				ok: false,
-				error: toConnectorError(result.data.error)
-			};
-			const fields = normalizeFields(result.data.fields);
-			if (!fields) return badResponse("query 响应缺少合法的 fields 数组");
-			if (!Array.isArray(result.data.rows)) return badResponse("query 响应缺少 rows 数组");
-			return {
-				ok: true,
-				data: {
-					fields,
-					rows: result.data.rows
-				}
-			};
-		}
-	};
-}
-//#endregion
-export { DEFAULT_CONNECTION_PORTS, createHttpConnector, resolvePortOnTypeChange };

package/dist/report/drill.d.ts

@@ -1,48 +0,0 @@
-import { DatasetRecords, ParamValues, ReportDrillConfig } from "./types.js";
-import { ReportTemplate } from "./template.js";
-import { SheetSnapshot } from "@veltra/sheet-core";
-//#region src/report/drill.d.ts
-/**
- * 宿主模板解析契约：按下钻 target 引用取回目标模板（允许同步/异步）。
- * 失败抛错——查看器提示可读错误并停留当前报；设计器配置对话框据此解析目标模板查询参数。
- */
-type ResolveReportTemplate = (ref: string) => ReportTemplate | Promise<ReportTemplate>;
-/**
- * 按下钻映射从该格对应记录取值，生成详情报 Filter Bar 参数值。
- * 记录缺字段（值为 `undefined`）时跳过对应参数，由详情报回退默认值；空映射返回空参数。
- */
-declare function resolveDrillParams(config: ReportDrillConfig, record: Record<string, unknown>): ParamValues;
-/** 下钻栈层：一张报表模板 + 当时 Filter Bar 参数值（回退时据此恢复并重新取数） */
-interface DrillStackLayer {
-  template: ReportTemplate;
-  params: ParamValues;
-}
-/**
- * 下钻栈：自根（初始报表）到顶的层序列，至少一层。
- * 只经下方纯函数做不可变更新（返回新栈），便于组件层直接挂响应式。
- */
-type DrillStack = DrillStackLayer[];
-/** 以初始报表为根层创建下钻栈 */
-declare function createDrillStack(root: DrillStackLayer): DrillStack;
-/**
- * 压入详情报新层并使其成为当前层；`currentParams` 把当前层参数定格为离开时的值
- * （缺省保留原值）。指向自身或成环不做检测，照常压栈，靠 pop 逐级退出。
- */
-declare function pushDrillLayer(stack: DrillStack, next: DrillStackLayer, currentParams?: ParamValues): DrillStack;
-/** 弹出当前层返回上一层；仅剩根层时原样返回（查看器始终保留一张报表） */
-declare function popDrillLayer(stack: DrillStack): DrillStack;
-/** 当前层（栈顶） */
-declare function currentDrillLayer(stack: DrillStack): DrillStackLayer;
-/** 下钻命中：物理格对应的下钻配置与该格记录 */
-interface DrillHit {
-  config: ReportDrillConfig;
-  record: Record<string, unknown>;
-}
-/**
- * 构建填充报表的物理格 → 下钻命中索引（每次成功取数后重建）。
- * 仅含配了下钻的绑定格落点（含分组/汇总格与展开后的实例格，合并跨度内每格都命中）；
- * 记录由 `resolvePlacementContext` 解析：list 明细取源数据行，分组/汇总取分组上下文。
- */
-declare function buildDrillHitMap(template: SheetSnapshot, data: DatasetRecords): Map<number, DrillHit>;
-//#endregion
-export { DrillHit, DrillStack, DrillStackLayer, ResolveReportTemplate, buildDrillHitMap, createDrillStack, currentDrillLayer, popDrillLayer, pushDrillLayer, resolveDrillParams };

package/dist/report/drill.js

@@ -1,78 +0,0 @@
-import { buildTemplateIndex } from "./render/template-index.js";
-import { computeExpansionLayout } from "./render/coordinate.js";
-import { AggregateIndex, resolvePlacementContext } from "./render/aggregate.js";
-import { cellKey } from "@veltra/sheet-core";
-//#region src/report/drill.ts
-/**
-* 按下钻映射从该格对应记录取值，生成详情报 Filter Bar 参数值。
-* 记录缺字段（值为 `undefined`）时跳过对应参数，由详情报回退默认值；空映射返回空参数。
-*/
-function resolveDrillParams(config, record) {
-	const values = {};
-	for (const [field, paramId] of Object.entries(config.mapping)) {
-		const value = record[field];
-		if (value === void 0) continue;
-		values[paramId] = value;
-	}
-	return values;
-}
-/** 以初始报表为根层创建下钻栈 */
-function createDrillStack(root) {
-	return [{
-		template: root.template,
-		params: { ...root.params }
-	}];
-}
-/**
-* 压入详情报新层并使其成为当前层；`currentParams` 把当前层参数定格为离开时的值
-* （缺省保留原值）。指向自身或成环不做检测，照常压栈，靠 pop 逐级退出。
-*/
-function pushDrillLayer(stack, next, currentParams) {
-	const top = stack[stack.length - 1];
-	const layers = currentParams ? [...stack.slice(0, -1), {
-		template: top.template,
-		params: { ...currentParams }
-	}] : [...stack];
-	layers.push({
-		template: next.template,
-		params: { ...next.params }
-	});
-	return layers;
-}
-/** 弹出当前层返回上一层；仅剩根层时原样返回（查看器始终保留一张报表） */
-function popDrillLayer(stack) {
-	if (stack.length <= 1) return stack;
-	return stack.slice(0, -1);
-}
-/** 当前层（栈顶） */
-function currentDrillLayer(stack) {
-	return stack[stack.length - 1];
-}
-/**
-* 构建填充报表的物理格 → 下钻命中索引（每次成功取数后重建）。
-* 仅含配了下钻的绑定格落点（含分组/汇总格与展开后的实例格，合并跨度内每格都命中）；
-* 记录由 `resolvePlacementContext` 解析：list 明细取源数据行，分组/汇总取分组上下文。
-*/
-function buildDrillHitMap(template, data) {
-	const hits = /* @__PURE__ */ new Map();
-	const index = buildTemplateIndex(template);
-	const layout = computeExpansionLayout(index, data);
-	const aggregateIndex = new AggregateIndex(data);
-	for (const placement of layout.placements) {
-		const config = placement.binding?.drill;
-		if (!config) continue;
-		const record = resolvePlacementContext(placement, index, data, aggregateIndex);
-		if (!record) continue;
-		const hit = {
-			config,
-			record
-		};
-		for (let row = placement.physical.start.row; row <= placement.physical.end.row; row++) for (let col = placement.physical.start.col; col <= placement.physical.end.col; col++) hits.set(cellKey({
-			row,
-			col
-		}), hit);
-	}
-	return hits;
-}
-//#endregion
-export { buildDrillHitMap, createDrillStack, currentDrillLayer, popDrillLayer, pushDrillLayer, resolveDrillParams };