@veltra/sheet 2.3.4 → 2.5.0

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/export-xlsx.d.ts

@@ -1,13 +0,0 @@
-import { Sheet } from "@veltra/sheet-core";
-//#region src/report/export-xlsx.d.ts
-/** 列宽条目：模型列索引 → 像素宽（与 SheetSnapshot.colWidths 同构） */
-type ReportColWidthEntry = readonly [number, number];
-/**
- * 将已填充的 Sheet（Filled Report）导出为保真 XLSX（合并 / 样式 / 行高 / 列宽 / 浮动图）。
- * 组装与序列化委托 sheet-core `exportSheetXlsx`（与 `exportWorkbookXlsx` 同一套单表逻辑）；
- * 条件样式颜色已在 renderReport 展开阶段打平进 StylePool（ADR-0001 决策 2）。
- * 列宽取自 sheet 模型（`getColWidths`）。
- */
-declare function exportFilledReportXlsx(sheet: Sheet): Promise<Uint8Array>;
-//#endregion
-export { ReportColWidthEntry, exportFilledReportXlsx };

package/dist/report/export-xlsx.js

@@ -1,13 +0,0 @@
-import { exportSheetXlsx } from "@veltra/sheet-core/core/io/export";
-//#region src/report/export-xlsx.ts
-/**
-* 将已填充的 Sheet（Filled Report）导出为保真 XLSX（合并 / 样式 / 行高 / 列宽 / 浮动图）。
-* 组装与序列化委托 sheet-core `exportSheetXlsx`（与 `exportWorkbookXlsx` 同一套单表逻辑）；
-* 条件样式颜色已在 renderReport 展开阶段打平进 StylePool（ADR-0001 决策 2）。
-* 列宽取自 sheet 模型（`getColWidths`）。
-*/
-function exportFilledReportXlsx(sheet) {
-	return exportSheetXlsx(sheet, { fallbackName: "报表" });
-}
-//#endregion
-export { exportFilledReportXlsx };

package/dist/report/filter-bar.d.ts

@@ -1,10 +0,0 @@
-import { ParamValues } from "./types.js";
-//#region src/report/filter-bar.d.ts
-/** 将运行时 date-range 参数值规范为 [from, to] 字符串元组 */
-declare function parseDateRangeValue(raw: unknown): [string, string];
-/** 将运行时 number 参数值规范为 UNumberInput 可接受的 number | undefined */
-declare function resolveNumberParamValue(raw: unknown): number | undefined;
-/** 合并单参数变更，保持其余参数值不变 */
-declare function patchParamValues(values: ParamValues, id: string, value: unknown): ParamValues;
-//#endregion
-export { parseDateRangeValue, patchParamValues, resolveNumberParamValue };

package/dist/report/filter-bar.js

@@ -1,31 +0,0 @@
-//#region src/report/filter-bar.ts
-function toParamString(value) {
-	if (value == null || value === "") return "";
-	if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return String(value);
-	return "";
-}
-/** 将运行时 date-range 参数值规范为 [from, to] 字符串元组 */
-function parseDateRangeValue(raw) {
-	if (Array.isArray(raw)) return [toParamString(raw[0]), toParamString(raw[1])];
-	if (raw && typeof raw === "object") {
-		const obj = raw;
-		return [toParamString(obj.from ?? obj.start), toParamString(obj.to ?? obj.end)];
-	}
-	return ["", ""];
-}
-/** 将运行时 number 参数值规范为 UNumberInput 可接受的 number | undefined */
-function resolveNumberParamValue(raw) {
-	if (raw === "" || raw == null) return void 0;
-	if (typeof raw === "number" && Number.isFinite(raw)) return raw;
-	const parsed = Number(raw);
-	return Number.isFinite(parsed) ? parsed : void 0;
-}
-/** 合并单参数变更，保持其余参数值不变 */
-function patchParamValues(values, id, value) {
-	return {
-		...values,
-		[id]: value
-	};
-}
-//#endregion
-export { parseDateRangeValue, patchParamValues, resolveNumberParamValue };

package/dist/report/index.d.ts

@@ -1,12 +0,0 @@
-import { ConditionalOperator, ConditionalRule, DatasetCatalogItem, DatasetField, DatasetRecords, ParamValues, QueryParamDef, QueryParamOption, QueryParamType, ReportAggregate, ReportBinding, ReportExpand, ReportPreset, ReportSort } from "./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 "./binding.js";
-import { ConditionalEvalContext, evaluateCondition, evaluateConditionalStyle, resolveRuleCompareValue, toComparableNumber } from "./rules/evaluate.js";
-import "./rules/index.js";
-import { buildParamDefs, extractParamIds, resolveBoundDatasetParams } from "./params.js";
-import { ReportColWidthEntry, exportFilledReportXlsx } from "./export-xlsx.js";
-import { mapFilledColWidths } from "./render/builder.js";
-import { renderReport, resolveFilledColWidths } from "./render/index.js";
-import { ConnectionType, ConnectorError, CreateHttpConnectorOptions, DEFAULT_CONNECTION_PORTS, DataConnection, DataConnector, QueryResult, Result, createHttpConnector, resolvePortOnTypeChange } from "./connector.js";
-import { IncompatibleTemplateVersionError, REPORT_TEMPLATE_VERSION, ReportDatasetDef, ReportTemplate, assertCompatibleTemplateVersion, createReportTemplate, fetchTemplateRecords, getBoundDatasetIds, getTemplateDatasets, resolveParamDefaults, resolveTemplateParams } from "./template.js";
-import { parseDateRangeValue, patchParamValues, resolveNumberParamValue } from "./filter-bar.js";
-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, ReportExpand, ReportPreset, ReportSort, ReportTemplate, Result, applyReportPreset, assertCompatibleTemplateVersion, buildParamDefs, createHttpConnector, createReportBinding, createReportTemplate, 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, renderReport, resolveBoundDatasetParams, resolveFilledColWidths, resolveNumberParamValue, resolveParamDefaults, resolvePortOnTypeChange, resolveRuleCompareValue, resolveTemplateParams, setBindingCatalog, toComparableNumber };

package/dist/report/params.d.ts

@@ -1,13 +0,0 @@
-import { QueryParamDef } from "./types.js";
-//#region src/report/params.d.ts
-/** 从 SQL 提取 `${param}` 占位符 id（ADR-0002 决策 2：前端纯函数） */
-declare function extractParamIds(sql: string): string[];
-/**
- * 从 SQL 构建查询参数定义：提取 `${param}` 占位符 + 上下文类型推断，
- * 再叠加数据集编辑器的元数据覆盖（label / 类型 / 默认值 / 选项）。
- */
-declare function buildParamDefs(sql: string, overrides?: Record<string, Partial<Omit<QueryParamDef, 'id'>>>): QueryParamDef[];
-/** 按绑定的数据集 id 合并查询参数（同名参数先见为准） */
-declare function resolveBoundDatasetParams(queryParams: QueryParamDef[], boundDatasetIds: readonly string[], getDatasetParams: (datasetId: string) => QueryParamDef[]): QueryParamDef[];
-//#endregion
-export { buildParamDefs, extractParamIds, resolveBoundDatasetParams };