@veltra/sheet 2.4.0 → 2.5.1

package/src/report/drill.ts

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

package/src/report/export-xlsx.ts

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

package/src/report/filter-bar.ts

@@ -1,36 +0,0 @@
-import type { ParamValues } from './types'
-
-// Filter Bar 控件值规范化（自 playground filter-bar-helpers 平移，行为不变）
-
-function toParamString(value: unknown): string {
-  if (value == null || value === '') return ''
-  if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
-    return String(value)
-  }
-  return ''
-}
-
-/** 将运行时 date-range 参数值规范为 [from, to] 字符串元组 */
-export function parseDateRangeValue(raw: unknown): [string, string] {
-  if (Array.isArray(raw)) {
-    return [toParamString(raw[0]), toParamString(raw[1])]
-  }
-  if (raw && typeof raw === 'object') {
-    const obj = raw as Record<string, unknown>
-    return [toParamString(obj.from ?? obj.start), toParamString(obj.to ?? obj.end)]
-  }
-  return ['', '']
-}
-
-/** 将运行时 number 参数值规范为 UNumberInput 可接受的 number | undefined */
-export function resolveNumberParamValue(raw: unknown): number | undefined {
-  if (raw === '' || raw == null) return undefined
-  if (typeof raw === 'number' && Number.isFinite(raw)) return raw
-  const parsed = Number(raw)
-  return Number.isFinite(parsed) ? parsed : undefined
-}
-
-/** 合并单参数变更，保持其余参数值不变 */
-export function patchParamValues(values: ParamValues, id: string, value: unknown): ParamValues {
-  return { ...values, [id]: value }
-}

package/src/report/index.ts

@@ -1,16 +0,0 @@
-// 报表纯 TS 内核（ADR-0003 决策 1）：渲染引擎 / 绑定 / 条件规则 / 查询参数 / 数据连接器 /
-// Report Template（自包含模板与取数）/ Filter Bar 值规范化 / 下钻配置与下钻栈 /
-// Filled Report XLSX 导出与打印 HTML。
-// 框架无关、无 DOM 依赖；组件壳（UReportDesigner / UReportViewer）落 components/report/。
-
-export * from './types'
-export * from './binding'
-export * from './rules'
-export * from './params'
-export * from './render'
-export * from './connector'
-export * from './template'
-export * from './filter-bar'
-export * from './drill'
-export * from './export-xlsx'
-export * from './print'

package/src/report/params.ts

@@ -1,96 +0,0 @@
-import type { QueryParamDef, QueryParamType } from './types'
-
-/** 从 SQL 提取 `${param}` 占位符 id（ADR-0002 决策 2：前端纯函数） */
-export function extractParamIds(sql: string): string[] {
-  const ids: string[] = []
-  const re = /\$\{([^}]+)\}/g
-  let match: RegExpExecArray | null
-  while ((match = re.exec(sql)) !== null) {
-    const id = match[1]!.trim()
-    if (id && !ids.includes(id)) ids.push(id)
-  }
-  return ids
-}
-
-function escapeRegExp(value: string): string {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
-}
-
-/** 从 SQL 上下文推断参数控件类型（BETWEEN/LIKE/数值比较） */
-function inferParamTypeFromSql(sql: string, paramId: string): QueryParamType {
-  const betweenSingle = new RegExp(
-    `\\bBETWEEN\\s+\\$\\{${escapeRegExp(paramId)}\\}(?!\\s+AND)`,
-    'i'
-  )
-  if (betweenSingle.test(sql)) return 'date-range'
-
-  const betweenPair = new RegExp(
-    `\\bBETWEEN\\s+\\$\\{${escapeRegExp(paramId)}\\}\\s+AND\\s+\\$\\{([^}]+)\\}`,
-    'i'
-  )
-  const pairMatch = betweenPair.exec(sql)
-  if (pairMatch && pairMatch[1]!.trim() !== paramId) return 'date'
-
-  const like = new RegExp(`\\bLIKE\\s+\\$\\{${escapeRegExp(paramId)}\\}`, 'i')
-  if (like.test(sql)) return 'text'
-
-  const numericCompare = new RegExp(
-    `[<>=]+\\s+\\$\\{${escapeRegExp(paramId)}\\}|\\$\\{${escapeRegExp(paramId)}\\}\\s*[<>=]+`,
-    'i'
-  )
-  if (numericCompare.test(sql)) return 'number'
-
-  return 'text'
-}
-
-function defaultValueForType(type: QueryParamType): unknown {
-  switch (type) {
-    case 'number':
-      return 0
-    case 'date-range':
-      return ['', '']
-    case 'select':
-      return ''
-    default:
-      return ''
-  }
-}
-
-/**
- * 从 SQL 构建查询参数定义：提取 `${param}` 占位符 + 上下文类型推断，
- * 再叠加数据集编辑器的元数据覆盖（label / 类型 / 默认值 / 选项）。
- */
-export function buildParamDefs(
-  sql: string,
-  overrides?: Record<string, Partial<Omit<QueryParamDef, 'id'>>>
-): QueryParamDef[] {
-  const ids = extractParamIds(sql)
-  return ids.map((id) => {
-    const inferred = inferParamTypeFromSql(sql, id)
-    const override = overrides?.[id]
-    return {
-      id,
-      label: override?.label ?? id,
-      type: override?.type ?? inferred,
-      defaultValue: override?.defaultValue ?? defaultValueForType(override?.type ?? inferred),
-      options: override?.options
-    }
-  })
-}
-
-/** 按绑定的数据集 id 合并查询参数（同名参数先见为准） */
-export function resolveBoundDatasetParams(
-  queryParams: QueryParamDef[],
-  boundDatasetIds: readonly string[],
-  getDatasetParams: (datasetId: string) => QueryParamDef[]
-): QueryParamDef[] {
-  const map = new Map<string, QueryParamDef>()
-  for (const datasetId of boundDatasetIds) {
-    const params = getDatasetParams(datasetId)
-    for (const param of params) {
-      if (!map.has(param.id)) map.set(param.id, param)
-    }
-  }
-  if (map.size > 0) return Array.from(map.values())
-  return queryParams
-}

package/src/report/print.ts

@@ -1,234 +0,0 @@
-import type {
-  BorderLineStyle,
-  CellStyle,
-  Sheet,
-  SheetImage,
-  SheetImageType
-} from '@veltra/sheet-core'
-import { BORDER_SIDES } from '@veltra/sheet-core'
-
-/** 报表打印选项 */
-export interface ReportPrintOptions {
-  /** 打印文档标题（打印对话框标题 / 另存 PDF 文件名）；缺省取 sheet 名，再回落「报表」 */
-  title?: string
-  /** 纸张方向（@page size），默认 portrait */
-  orientation?: 'portrait' | 'landscape'
-}
-
-/**
- * 默认列宽 / 行高（px）：与 grid 层 vtable-theme 的
- * SHEET_DEFAULT_COL_WIDTH / SHEET_DEFAULT_ROW_HEIGHT 对齐；
- * report 内核保持 headless，不引 grid 入口。
- */
-const PRINT_DEFAULT_COL_WIDTH = 80
-const PRINT_DEFAULT_ROW_HEIGHT = 28
-
-const IMAGE_MIME: Record<SheetImageType, string> = {
-  png: 'image/png',
-  jpeg: 'image/jpeg',
-  gif: 'image/gif',
-  svg: 'image/svg+xml',
-  webp: 'image/webp'
-}
-
-/** 模型边框线型 → CSS 线型（thin/medium/thick 为实线粗细分级，宽度由 edge.width 表达） */
-const BORDER_CSS_LINE: Record<BorderLineStyle, string> = {
-  thin: 'solid',
-  medium: 'solid',
-  thick: 'solid',
-  dashed: 'dashed',
-  dotted: 'dotted'
-}
-
-function escapeHtml(text: string): string {
-  return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
-}
-
-function escapeAttr(text: string): string {
-  return escapeHtml(text).replace(/"/g, '&quot;')
-}
-
-/** Uint8Array → base64（分块避免栈溢出；btoa 在浏览器 / Node >=16 / Bun / happy-dom 均可用） */
-function bytesToBase64(data: Uint8Array): string {
-  let binary = ''
-  const CHUNK = 0x8000
-  for (let i = 0; i < data.length; i += CHUNK) {
-    binary += String.fromCharCode(...data.subarray(i, i + CHUNK))
-  }
-  return btoa(binary)
-}
-
-/** 模型有效样式 → td 内联 CSS（字号 pt 直出，与屏幕 px ×4/3 物理尺寸一致） */
-function styleToCss(style: CellStyle): string {
-  const decls: string[] = []
-  if (style.fill?.color) decls.push(`background-color:${style.fill.color}`)
-  for (const side of BORDER_SIDES) {
-    const edge = style.border?.[side]
-    if (edge)
-      decls.push(`border-${side}:${edge.width}px ${BORDER_CSS_LINE[edge.style]} ${edge.color}`)
-  }
-  const font = style.font
-  if (font) {
-    if (font.color) decls.push(`color:${font.color}`)
-    if (font.bold) decls.push('font-weight:bold')
-    if (font.italic) decls.push('font-style:italic')
-    const decoration = [font.underline ? 'underline' : '', font.strikethrough ? 'line-through' : '']
-      .filter(Boolean)
-      .join(' ')
-    if (decoration) decls.push(`text-decoration:${decoration}`)
-    if (typeof font.size === 'number') decls.push(`font-size:${font.size}pt`)
-  }
-  const align = style.align
-  if (align) {
-    if (align.horizontal) decls.push(`text-align:${align.horizontal}`)
-    if (align.vertical) decls.push(`vertical-align:${align.vertical}`)
-    if (align.wrap) decls.push('white-space:normal;word-break:break-all')
-  }
-  return decls.join(';')
-}
-
-interface PrintImageRect {
-  left: number
-  top: number
-  width?: number
-  height?: number
-}
-
-/**
- * 浮动图打印定位（镜像 grid image-layer `computeImageRect`）：
- * left/top = from 格左上 + 格内像素偏移；宽高优先 image.width/height（两者都有才用），
- * 缺失且有 to 时按 from→to 跨度兜底，都缺失则省略尺寸（浏览器取自然尺寸）。
- */
-function computePrintImageRect(
-  image: SheetImage,
-  colWidths: readonly number[],
-  rowHeights: readonly number[]
-): PrintImageRect {
-  const { from, to } = image.anchor
-  let left = from.offsetX ?? 0
-  for (let c = 0; c < from.col; c++) left += colWidths[c] ?? PRINT_DEFAULT_COL_WIDTH
-  let top = from.offsetY ?? 0
-  for (let r = 0; r < from.row; r++) top += rowHeights[r] ?? PRINT_DEFAULT_ROW_HEIGHT
-
-  if (image.width != null && image.height != null) {
-    return { left, top, width: image.width, height: image.height }
-  }
-  if (to) {
-    let width = 0
-    for (let c = from.col; c <= to.col; c++) width += colWidths[c] ?? PRINT_DEFAULT_COL_WIDTH
-    let height = 0
-    for (let r = from.row; r <= to.row; r++) height += rowHeights[r] ?? PRINT_DEFAULT_ROW_HEIGHT
-    return { left, top, width, height }
-  }
-  return { left, top }
-}
-
-/**
- * 将已填充的 Sheet（Filled Report）构建为打印专用 HTML 文档（纯 TS、headless、无 DOM）。
- *
- * 路线说明：网格渲染层是 canvas + 虚拟滚动（视口外不绘制），无法直接 window.print；
- * 这里从模型单一事实源（与 exportFilledReportXlsx 同一读取路径）重建 `<table>`——
- * 矢量文字清晰、浏览器原生分页、合并格天然映射 rowspan/colspan。
- *
- * 保真范围：值 / 合并 / 有效样式（fill + border + font + align/wrap，条件样式已在
- * 展开阶段打平进 StylePool）/ 行高 / 列宽 / 浮动图（data URL 内嵌，跨页被裁剪属预期）。
- * 与 Excel 默认一致：不打印屏幕网格线（仅模型显式边框）。
- */
-export function buildFilledReportPrintHtml(sheet: Sheet, options?: ReportPrintOptions): string {
-  const title = options?.title ?? sheet.name ?? ''
-  const orientation = options?.orientation ?? 'portrait'
-
-  // 打印范围 = 数据 ∪ 行高 ∪ 列宽 ∪ 合并 ∪ 图片锚点 包围盒（与 xlsx 导出收敛逻辑一致 + 合并/图片）
-  let maxRow = -1
-  let maxCol = -1
-  const grow = (row: number, col: number): void => {
-    if (row > maxRow) maxRow = row
-    if (col > maxCol) maxCol = col
-  }
-  for (const [addr] of sheet.store.peekEntries()) grow(addr.row, addr.col)
-  for (const [row] of sheet.getRowHeights()) grow(row, 0)
-  for (const [col] of sheet.getColWidths()) grow(0, col)
-  const merges = sheet.merges.getMerges()
-  for (const range of merges) grow(range.end.row, range.end.col)
-  const images = sheet.getImages()
-  for (const image of images) {
-    grow(image.anchor.from.row, image.anchor.from.col)
-    if (image.anchor.to) grow(image.anchor.to.row, image.anchor.to.col)
-  }
-
-  const colWidths: number[] = []
-  for (let c = 0; c <= maxCol; c++) colWidths.push(sheet.getColWidth(c) ?? PRINT_DEFAULT_COL_WIDTH)
-  const rowHeights: number[] = []
-  for (let r = 0; r <= maxRow; r++)
-    rowHeights.push(sheet.getRowHeight(r) ?? PRINT_DEFAULT_ROW_HEIGHT)
-
-  // 合并：锚点 → 跨度；被覆盖格集合（跳过客格）
-  const spanByAnchor = new Map<string, { rowSpan: number; colSpan: number }>()
-  const covered = new Set<string>()
-  for (const range of merges) {
-    const rowSpan = range.end.row - range.start.row + 1
-    const colSpan = range.end.col - range.start.col + 1
-    spanByAnchor.set(`${range.start.row},${range.start.col}`, { rowSpan, colSpan })
-    for (let r = range.start.row; r <= range.end.row; r++) {
-      for (let c = range.start.col; c <= range.end.col; c++) {
-        if (r !== range.start.row || c !== range.start.col) covered.add(`${r},${c}`)
-      }
-    }
-  }
-
-  const css = [
-    `@page { size: A4 ${orientation}; margin: 12mm; }`,
-    'html, body { margin: 0; padding: 0; }',
-    "body { font-family: Arial, 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif; font-size: 12px; color: #1f2329; -webkit-print-color-adjust: exact; print-color-adjust: exact; }",
-    '.sheet-print-root { position: relative; }',
-    'table { border-collapse: collapse; table-layout: fixed; }',
-    'tr { break-inside: avoid; }',
-    'td { box-sizing: border-box; padding: 2px 6px; overflow: hidden; white-space: nowrap; vertical-align: middle; text-align: left; }',
-    '.sheet-print-root img { position: absolute; }'
-  ].join('\n')
-
-  const parts: string[] = []
-  parts.push('<!doctype html><html><head><meta charset="utf-8">')
-  parts.push(`<title>${escapeHtml(title || '报表')}</title>`)
-  parts.push(`<style>\n${css}\n</style></head><body>`)
-  parts.push('<div class="sheet-print-root">')
-  parts.push('<table>')
-  if (colWidths.length > 0) {
-    parts.push('<colgroup>')
-    for (const width of colWidths) parts.push(`<col style="width:${width}px">`)
-    parts.push('</colgroup>')
-  }
-  for (let r = 0; r <= maxRow; r++) {
-    parts.push(`<tr style="height:${rowHeights[r]}px">`)
-    for (let c = 0; c <= maxCol; c++) {
-      if (covered.has(`${r},${c}`)) continue
-      const attrs: string[] = []
-      const span = spanByAnchor.get(`${r},${c}`)
-      if (span && span.colSpan > 1) attrs.push(`colspan="${span.colSpan}"`)
-      if (span && span.rowSpan > 1) attrs.push(`rowspan="${span.rowSpan}"`)
-      const style = sheet.getEffectiveStyle({ row: r, col: c })
-      const cellCss = style ? styleToCss(style) : ''
-      if (cellCss) attrs.push(`style="${escapeAttr(cellCss)}"`)
-      const value = sheet.getDisplayValue({ row: r, col: c })
-      const text = value == null ? '' : escapeHtml(String(value))
-      parts.push(`<td${attrs.length > 0 ? ` ${attrs.join(' ')}` : ''}>${text}</td>`)
-    }
-    parts.push('</tr>')
-  }
-  parts.push('</table>')
-
-  for (const image of images) {
-    const rect = computePrintImageRect(image, colWidths, rowHeights)
-    const size =
-      rect.width != null && rect.height != null
-        ? `width:${rect.width}px;height:${rect.height}px;`
-        : ''
-    const src = `data:${IMAGE_MIME[image.type]};base64,${bytesToBase64(image.data)}`
-    parts.push(
-      `<img src="${src}" style="left:${rect.left}px;top:${rect.top}px;${size}" alt="${escapeAttr(image.altText ?? '')}">`
-    )
-  }
-
-  parts.push('</div></body></html>')
-  return parts.join('')
-}

package/src/report/render/__test__/aggregate.test.ts

@@ -1,16 +0,0 @@
-import { describe, expect, it } from 'vitest'
-
-import { aggregateField } from '../aggregate'
-
-describe('aggregateField', () => {
-  it('avg 空集返回 undefined，sum 空集仍为 0', () => {
-    expect(aggregateField([], 'amount', 'avg')).toBeUndefined()
-    expect(aggregateField([], 'amount', 'sum')).toBe(0)
-  })
-
-  it('max / min 对数值集求值', () => {
-    const rows = [{ amount: 10 }, { amount: 30 }, { amount: 20 }]
-    expect(aggregateField(rows, 'amount', 'max')).toBe(30)
-    expect(aggregateField(rows, 'amount', 'min')).toBe(10)
-  })
-})