@veltra/sheet 2.4.0 → 2.5.0

package/src/components/report/__test__/report-viewer.test.ts

@@ -1,400 +0,0 @@
-import { Sheet, Workbook } from '@veltra/sheet-core'
-import { afterEach, describe, expect, it, vi } from 'vitest'
-import { createApp, h, nextTick, type App } from 'vue'
-
-import { UReportViewer } from '../../../index'
-import { REPORT_META_NAMESPACE } from '../../../report/binding'
-import type { DataConnection, DataConnector } from '../../../report/connector'
-import { createReportTemplate } from '../../../report/template'
-import type { ReportDatasetDef, ReportTemplate } from '../../../report/template'
-import type { ParamValues, ReportBinding } from '../../../report/types'
-import type { ReportViewerExposed, SheetExposed } from '../../../types'
-
-// ---- 内联 fixtures：stub connector（实现 DataConnector 接口的内存测试夹具）----
-
-const MYSQL: DataConnection = {
-  id: 'c1',
-  label: 'stub MySQL',
-  type: 'mysql',
-  host: '127.0.0.1',
-  port: 3306,
-  database: 'demo',
-  username: 'root',
-  password: ''
-}
-
-// 覆盖全部 5 种参数控件类型：LIKE→text、>=→number、覆盖→select、
-// BETWEEN ${a} AND ${b} 首参→date、BETWEEN 单参（SQL 末尾）→date-range
-const ORDERS_SQL =
-  'SELECT customer, amount FROM orders ' +
-  'WHERE customer LIKE ${keyword} AND amount >= ${minAmount} AND region = ${region} ' +
-  'AND orderDate BETWEEN ${dateFrom} AND ${dateTo} AND createdAt BETWEEN ${dateRange}'
-
-const ORDERS_DATASET: ReportDatasetDef = {
-  id: 'orders',
-  label: '销售明细',
-  connection: MYSQL,
-  sql: ORDERS_SQL,
-  paramOverrides: {
-    region: {
-      label: '地区',
-      type: 'select',
-      defaultValue: '华东',
-      options: [
-        { label: '华东', value: '华东' },
-        { label: '华南', value: '华南' }
-      ]
-    }
-  }
-}
-
-/** 参数默认值（keyword/dateFrom/dateTo 文本 ''、minAmount 数值 0、region 覆盖默认、dateRange 元组） */
-const DEFAULT_VALUES: ParamValues = {
-  keyword: '',
-  minAmount: 0,
-  region: '华东',
-  dateFrom: '',
-  dateTo: '',
-  dateRange: ['', '']
-}
-
-const ORDER_ROWS: Record<string, unknown>[] = [
-  { customer: '甲公司', amount: 100 },
-  { customer: '甲公司', amount: 200 },
-  { customer: '乙公司', amount: 300 }
-]
-
-/** 带绑定的模板：表头 + 同一扩展带（客户分组 + 金额明细） */
-function createViewerTemplate(datasets: ReportDatasetDef[] = [ORDERS_DATASET]): ReportTemplate {
-  const sheet = new Sheet()
-  sheet.setCells([
-    { addr: { row: 0, col: 0 }, data: { v: '客户' } },
-    { addr: { row: 0, col: 1 }, data: { v: '金额' } }
-  ])
-
-  const group: ReportBinding = {
-    dataset: 'orders',
-    field: 'customer',
-    preset: 'groupHeader',
-    aggregate: 'group',
-    expand: 'down'
-  }
-  sheet.setCellMeta({ row: 1, col: 0 }, REPORT_META_NAMESPACE, group)
-
-  const amount: ReportBinding = {
-    dataset: 'orders',
-    field: 'amount',
-    preset: 'detail',
-    aggregate: 'list',
-    expand: 'down',
-    rowParent: { row: 1, col: 0 }
-  }
-  sheet.setCellMeta({ row: 1, col: 1 }, REPORT_META_NAMESPACE, amount)
-
-  // 模拟设计态 canvas（旧预览用 max(50×10, 快照) 会铺出空白格）
-  sheet.ensureTableSize(50, 10)
-  return createReportTemplate(sheet.snapshot(), datasets)
-}
-
-interface QueryCall {
-  connection: DataConnection
-  sql: string
-  values: ParamValues
-}
-
-type QueryOutcome =
-  | { rows: Record<string, unknown>[] }
-  | { error: { code: string; message: string } }
-
-/** stub connector：记录 query 调用；outcome 可为立即值或手动闸门（loading 测试） */
-function createStubConnector(outcome: QueryOutcome | (() => Promise<QueryOutcome>)) {
-  const calls: QueryCall[] = []
-  const connector: DataConnector = {
-    test: () => Promise.resolve({ ok: true, data: undefined }),
-    describe: () => Promise.resolve({ ok: true, data: [] }),
-    query: async (connection, sql, values) => {
-      calls.push({ connection, sql, values })
-      const resolved = typeof outcome === 'function' ? await outcome() : outcome
-      if ('error' in resolved) return { ok: false, error: resolved.error }
-      return { ok: true, data: { fields: [], rows: resolved.rows } }
-    }
-  }
-  return { connector, calls }
-}
-
-function deferred<T>() {
-  let resolve!: (value: T | PromiseLike<T>) => void
-  const promise = new Promise<T>((r) => {
-    resolve = r
-  })
-  return { promise, resolve }
-}
-
-// ---- 挂载与等待 ----
-
-const apps: App[] = []
-const containers: HTMLElement[] = []
-
-function mountViewer(props: {
-  connector: DataConnector
-  template: ReportTemplate
-  workbook?: Workbook
-}) {
-  const el = document.createElement('div')
-  el.style.width = '800px'
-  el.style.height = '600px'
-  document.body.appendChild(el)
-  containers.push(el)
-  const exposedRef = { value: undefined as ReportViewerExposed | undefined }
-  const app = createApp({
-    render: () =>
-      h(UReportViewer, {
-        ...props,
-        ref: (value: unknown) => {
-          exposedRef.value = value as ReportViewerExposed | undefined
-        }
-      })
-  })
-  app.mount(el)
-  apps.push(app)
-  return { app, el, exposedRef }
-}
-
-/** 内嵌 USheet 的 SheetGrid（报表预览断言行列头 / 渲染尺寸） */
-function nestedSheetGrid(el: HTMLElement) {
-  const sheetEl = el.querySelector('.u-sheet') as
-    | (HTMLElement & { __vueParentComponent?: { exposed?: SheetExposed } })
-    | null
-  return sheetEl?.__vueParentComponent?.exposed?.getGrid()
-}
-
-/** 等待取数（宏/微任务）+ 填充快照应用（watch + nextTick）落定 */
-async function flushViewer(): Promise<void> {
-  await nextTick()
-  await new Promise((resolve) => setTimeout(resolve, 0))
-  await nextTick()
-  await nextTick()
-}
-
-afterEach(() => {
-  while (apps.length) apps.pop()!.unmount()
-  while (containers.length) containers.pop()!.remove()
-})
-
-describe('UReportViewer', () => {
-  it('全流程：带绑定的模板 + stub connector → 参数提取 → Filter Bar → 取数 → 展开渲染', async () => {
-    const { connector, calls } = createStubConnector({ rows: ORDER_ROWS })
-    const workbook = new Workbook()
-    const { el } = mountViewer({ connector, template: createViewerTemplate(), workbook })
-    await flushViewer()
-
-    // 经连接器取数：连接对象 / SQL / 参数默认值原样透传
-    expect(calls).toHaveLength(1)
-    expect(calls[0]).toEqual({ connection: MYSQL, sql: ORDERS_SQL, values: DEFAULT_VALUES })
-
-    // Filter Bar 按参数类型映射控件（text/number/select/date/date-range）
-    const filterBar = el.querySelector('.u-report-filter-bar')!
-    expect(filterBar).toBeTruthy()
-    expect(filterBar.querySelector('.u-input')).toBeTruthy()
-    expect(filterBar.querySelector('.u-number-input')).toBeTruthy()
-    expect(filterBar.querySelector('.u-select')).toBeTruthy()
-    expect(filterBar.querySelector('.u-date-picker')).toBeTruthy()
-    expect(filterBar.querySelector('.u-date-range-picker')).toBeTruthy()
-    // 覆盖元数据的 label 生效
-    expect(filterBar.textContent).toContain('地区')
-
-    // 展开结果落到只读网格（模型断言）：表头 + 甲(2 明细) + 乙(1 明细)
-    const sheet = workbook.activeSheet
-    expect(sheet.getDisplayValue({ row: 0, col: 0 })).toBe('客户')
-    expect(sheet.getDisplayValue({ row: 1, col: 0 })).toBe('甲公司')
-    expect(sheet.getCellData({ row: 1, col: 1 })?.v).toBe(100)
-    expect(sheet.getCellData({ row: 2, col: 1 })?.v).toBe(200)
-    expect(sheet.getDisplayValue({ row: 3, col: 0 })).toBe('乙公司')
-    expect(sheet.getCellData({ row: 3, col: 1 })?.v).toBe(300)
-
-    // 网格铺到内容尺寸（表头 + 3 明细行 × 2 列），不再用 50×10 下限
-    expect(sheet.rows).toBe(4)
-    expect(sheet.cols).toBe(2)
-
-    const table = nestedSheetGrid(el)!.getTable()
-    expect(table.options.showHeader).toBe(false)
-    expect(table.options.rowSeriesNumber).toBeUndefined()
-    expect(table.columnHeaderLevelCount).toBe(0)
-    expect(table.rowCount).toBe(4)
-    expect(table.colCount).toBe(2)
-    // 无行号/列头偏移：表格 (0,0) 即模型 A1
-    expect(table.getCellValue(0, 0)).toBe('客户')
-  })
-
-  it('Filter Bar 改值重新取数，其余参数值保留', async () => {
-    const { connector, calls } = createStubConnector({ rows: ORDER_ROWS })
-    const workbook = new Workbook()
-    const { el } = mountViewer({ connector, template: createViewerTemplate(), workbook })
-    await flushViewer()
-    expect(calls).toHaveLength(1)
-
-    // keyword（text 控件）输入新值
-    const input = el.querySelector<HTMLInputElement>('.u-report-filter-bar .u-input input')!
-    input.value = '甲公司'
-    input.dispatchEvent(
-      new InputEvent('input', { bubbles: true, data: '甲公司', inputType: 'insertText' })
-    )
-    await flushViewer()
-
-    expect(calls).toHaveLength(2)
-    expect(calls[1]!.values).toEqual({ ...DEFAULT_VALUES, keyword: '甲公司' })
-
-    // minAmount（number 控件）输入新值
-    const numberInput = el.querySelector<HTMLInputElement>(
-      '.u-report-filter-bar .u-number-input input'
-    )!
-    numberInput.value = '500'
-    numberInput.dispatchEvent(
-      new InputEvent('input', { bubbles: true, data: '500', inputType: 'insertText' })
-    )
-    await flushViewer()
-
-    expect(calls).toHaveLength(3)
-    expect(calls[2]!.values).toEqual({ ...DEFAULT_VALUES, keyword: '甲公司', minAmount: 500 })
-  })
-
-  it('取数中有 loading；业务错误（ok:false）有可读提示；refresh() 触发重新取数', async () => {
-    let gate = deferred<QueryOutcome>()
-    // 首次取数返回业务错误，refresh 后返回数据
-    let outcome: QueryOutcome = { error: { code: 'CONNECTION_FAILED', message: '数据库连接失败' } }
-    const { connector, calls } = createStubConnector(() => gate.promise)
-    const workbook = new Workbook()
-    const { el, exposedRef } = mountViewer({
-      connector,
-      template: createViewerTemplate(),
-      workbook
-    })
-    await nextTick()
-
-    // 取数中：loading 遮罩可见
-    expect(el.querySelector('.u-report-viewer__loading')).toBeTruthy()
-
-    // 业务错误：可读错误提示可见，网格保留模板静态结构
-    gate.resolve(outcome)
-    await flushViewer()
-    expect(el.querySelector('.u-report-viewer__loading')).toBeNull()
-    const errorBanner = el.querySelector('.u-report-viewer__error')!
-    expect(errorBanner.textContent).toContain('数据库连接失败')
-    expect(workbook.activeSheet.getDisplayValue({ row: 0, col: 0 })).toBe('客户')
-    expect(workbook.activeSheet.getDisplayValue({ row: 1, col: 0 })).toBeUndefined()
-
-    // refresh() 重新取数：成功后错误消失、展开结果渲染
-    outcome = { rows: ORDER_ROWS }
-    gate = deferred<QueryOutcome>()
-    const refreshed = exposedRef.value!.refresh()
-    expect(calls).toHaveLength(2)
-    await nextTick()
-    expect(el.querySelector('.u-report-viewer__loading')).toBeTruthy()
-    gate.resolve(outcome)
-    await refreshed
-    await flushViewer()
-    expect(el.querySelector('.u-report-viewer__error')).toBeNull()
-    expect(workbook.activeSheet.getDisplayValue({ row: 1, col: 0 })).toBe('甲公司')
-    expect(workbook.activeSheet.getCellData({ row: 3, col: 1 })?.v).toBe(300)
-  })
-
-  it('模板无查询参数时不渲染 Filter Bar', async () => {
-    const dataset: ReportDatasetDef = {
-      id: 'orders',
-      label: '销售明细',
-      connection: MYSQL,
-      sql: 'SELECT customer, amount FROM orders'
-    }
-    const { connector } = createStubConnector({ rows: ORDER_ROWS })
-    const { el } = mountViewer({
-      connector,
-      template: createViewerTemplate([dataset]),
-      workbook: new Workbook()
-    })
-    await flushViewer()
-    expect(el.querySelector('.u-report-filter-bar')).toBeNull()
-  })
-
-  it('取数前 exportXlsx() 拒绝；取数失败或未就绪时同样拒绝', async () => {
-    let gate = deferred<QueryOutcome>()
-    let outcome: QueryOutcome = { error: { code: 'CONNECTION_FAILED', message: '数据库连接失败' } }
-    const { connector } = createStubConnector(() => gate.promise)
-    const { exposedRef } = mountViewer({
-      connector,
-      template: createViewerTemplate(),
-      workbook: new Workbook()
-    })
-    await nextTick()
-
-    await expect(exposedRef.value!.exportXlsx()).rejects.toThrow('报表数据加载中')
-
-    gate.resolve(outcome)
-    await flushViewer()
-    await expect(exposedRef.value!.exportXlsx()).rejects.toThrow('报表数据尚未就绪')
-  })
-
-  it('取数后 exportXlsx() 成功产出 blob', async () => {
-    const { connector } = createStubConnector({ rows: ORDER_ROWS })
-    const workbook = new Workbook()
-    const { exposedRef } = mountViewer({ connector, template: createViewerTemplate(), workbook })
-    await flushViewer()
-
-    const exportModule = await import('../../../report/export-xlsx')
-    const catKitFe = await import('@cat-kit/fe')
-    const exportSpy = vi
-      .spyOn(exportModule, 'exportFilledReportXlsx')
-      .mockResolvedValue(new Uint8Array([80, 75, 3, 4]))
-    const saveBlobSpy = vi.spyOn(catKitFe, 'saveBlob').mockImplementation(() => {})
-
-    await exposedRef.value!.exportXlsx()
-
-    expect(exportSpy).toHaveBeenCalled()
-    expect(saveBlobSpy).toHaveBeenCalledWith(expect.any(Blob), expect.stringMatching(/\.xlsx$/))
-
-    exportSpy.mockRestore()
-    saveBlobSpy.mockRestore()
-  })
-
-  it('取数前 print() 拒绝；取数失败或未就绪时同样拒绝', async () => {
-    let gate = deferred<QueryOutcome>()
-    const outcome: QueryOutcome = {
-      error: { code: 'CONNECTION_FAILED', message: '数据库连接失败' }
-    }
-    const { connector } = createStubConnector(() => gate.promise)
-    const { exposedRef } = mountViewer({
-      connector,
-      template: createViewerTemplate(),
-      workbook: new Workbook()
-    })
-    await nextTick()
-
-    expect(() => exposedRef.value!.print()).toThrow('报表数据加载中')
-
-    gate.resolve(outcome)
-    await flushViewer()
-    expect(() => exposedRef.value!.print()).toThrow('报表数据尚未就绪')
-  })
-
-  it('取数后 print() 生成打印 HTML 并送隐藏 iframe 打印', async () => {
-    const { connector } = createStubConnector({ rows: ORDER_ROWS })
-    const workbook = new Workbook()
-    const { exposedRef } = mountViewer({ connector, template: createViewerTemplate(), workbook })
-    await flushViewer()
-
-    const printModule = await import('../../../report/print')
-    const domPrintModule = await import('../print')
-    const buildSpy = vi.spyOn(printModule, 'buildFilledReportPrintHtml')
-    const printSpy = vi.spyOn(domPrintModule, 'printHtmlDocument').mockImplementation(() => {})
-
-    exposedRef.value!.print({ orientation: 'landscape' })
-
-    expect(buildSpy).toHaveBeenCalledWith(workbook.activeSheet, { orientation: 'landscape' })
-    const html = buildSpy.mock.results[0]!.value as string
-    expect(html).toContain('甲公司')
-    expect(html).toContain('@page { size: A4 landscape;')
-    expect(printSpy).toHaveBeenCalledWith(html)
-
-    buildSpy.mockRestore()
-    printSpy.mockRestore()
-  })
-})

package/src/components/report/__test__/topology.test.ts

@@ -1,143 +0,0 @@
-import { describe, expect, it } from 'vitest'
-
-import { createReportBinding } from '../../../report/binding'
-import type { DatasetCatalogItem, ReportBinding } from '../../../report/types'
-import {
-  buildTopologyArcPath,
-  collectTopologyLinks,
-  findCellsWithColParent,
-  findCellsWithRowParent
-} from '../designer/topology'
-
-// ---- 内联 fixtures ----
-
-const ORDERS_DATASET: DatasetCatalogItem = {
-  id: 'orders',
-  label: '销售明细',
-  fields: [
-    { name: 'customer', label: '客户', type: 'string' },
-    { name: 'orderNo', label: '订单号', type: 'string' },
-    { name: 'region', label: '地区', type: 'string' },
-    { name: 'amount', label: '金额', type: 'number' }
-  ]
-}
-
-function bindingMap(cells: Array<{ addr: { row: number; col: number }; binding: ReportBinding }>) {
-  const map = new Map<string, ReportBinding>()
-  for (const { addr, binding } of cells) {
-    map.set(`${addr.row},${addr.col}`, binding)
-  }
-  return (addr: { row: number; col: number }) => map.get(`${addr.row},${addr.col}`)
-}
-
-describe('report topology', () => {
-  it('collectTopologyLinks 沿 rowParent 链上行并包含直接子格', () => {
-    const parentAddr = { row: 1, col: 0 }
-    const parent = createReportBinding(ORDERS_DATASET, 'customer')
-    parent.aggregate = 'group'
-    parent.preset = 'groupHeader'
-
-    const mid = createReportBinding(ORDERS_DATASET, 'orderNo')
-    mid.rowParent = parentAddr
-
-    const detail = createReportBinding(ORDERS_DATASET, 'region')
-    detail.rowParent = { row: 1, col: 1 }
-
-    const subtotal = createReportBinding(ORDERS_DATASET, 'amount')
-    subtotal.aggregate = 'sum'
-    subtotal.expand = 'none'
-    subtotal.rowParent = parentAddr
-
-    const entries = [
-      { addr: parentAddr, binding: parent },
-      { addr: { row: 1, col: 1 }, binding: mid },
-      { addr: { row: 1, col: 2 }, binding: detail },
-      { addr: { row: 2, col: 3 }, binding: subtotal }
-    ]
-    const getBindingAt = bindingMap(entries)
-
-    expect(collectTopologyLinks({ row: 1, col: 2 }, detail, entries, getBindingAt)).toEqual([
-      { from: { row: 1, col: 2 }, to: { row: 1, col: 1 }, direction: 'row' },
-      { from: { row: 1, col: 1 }, to: parentAddr, direction: 'row' }
-    ])
-
-    expect(collectTopologyLinks(parentAddr, parent, entries, getBindingAt)).toEqual([
-      { from: { row: 1, col: 1 }, to: parentAddr, direction: 'row' },
-      { from: { row: 2, col: 3 }, to: parentAddr, direction: 'row' }
-    ])
-  })
-
-  it('collectTopologyLinks 沿 colParent 链上行并包含列方向子格', () => {
-    const rowParentAddr = { row: 1, col: 0 }
-    const colParentAddr = { row: 0, col: 1 }
-
-    const rowGroup = createReportBinding(ORDERS_DATASET, 'customer')
-    rowGroup.aggregate = 'group'
-    rowGroup.expand = 'down'
-
-    const colGroup = createReportBinding(ORDERS_DATASET, 'region')
-    colGroup.aggregate = 'group'
-    colGroup.expand = 'right'
-
-    const cross = createReportBinding(ORDERS_DATASET, 'amount')
-    cross.aggregate = 'sum'
-    cross.expand = 'none'
-    cross.rowParent = rowParentAddr
-    cross.colParent = colParentAddr
-
-    const entries = [
-      { addr: rowParentAddr, binding: rowGroup },
-      { addr: colParentAddr, binding: colGroup },
-      { addr: { row: 1, col: 2 }, binding: cross }
-    ]
-    const getBindingAt = bindingMap(entries)
-
-    expect(collectTopologyLinks({ row: 1, col: 2 }, cross, entries, getBindingAt)).toEqual([
-      { from: { row: 1, col: 2 }, to: rowParentAddr, direction: 'row' },
-      { from: { row: 1, col: 2 }, to: colParentAddr, direction: 'col' }
-    ])
-  })
-
-  it('findCellsWithColParent 仅返回 colParent 指向目标父格的子格', () => {
-    const parentAddr = { row: 0, col: 1 }
-    const parent = createReportBinding(ORDERS_DATASET, 'region')
-    parent.aggregate = 'group'
-    parent.expand = 'right'
-
-    const child = createReportBinding(ORDERS_DATASET, 'amount')
-    child.colParent = parentAddr
-
-    const entries = [
-      { addr: parentAddr, binding: parent },
-      { addr: { row: 1, col: 2 }, binding: child }
-    ]
-
-    expect(findCellsWithColParent(parentAddr, entries)).toEqual([{ row: 1, col: 2 }])
-  })
-
-  it('findCellsWithRowParent 仅返回 rowParent 指向目标父格的子格', () => {
-    const parentAddr = { row: 1, col: 0 }
-    const parent = createReportBinding(ORDERS_DATASET, 'customer')
-    parent.aggregate = 'group'
-    parent.preset = 'groupHeader'
-
-    const child = createReportBinding(ORDERS_DATASET, 'orderNo')
-    child.rowParent = parentAddr
-
-    const other = createReportBinding(ORDERS_DATASET, 'region')
-
-    const entries = [
-      { addr: parentAddr, binding: parent },
-      { addr: { row: 1, col: 1 }, binding: child },
-      { addr: { row: 1, col: 2 }, binding: other }
-    ]
-
-    expect(findCellsWithRowParent(parentAddr, entries)).toEqual([{ row: 1, col: 1 }])
-  })
-
-  it('buildTopologyArcPath 输出合法 SVG 路径', () => {
-    const path = buildTopologyArcPath({ x: 10, y: 20 }, { x: 100, y: 40 })
-    expect(path.startsWith('M 10 20 Q')).toBe(true)
-    expect(path.endsWith('100 40')).toBe(true)
-  })
-})