@veltra/sheet 2.4.0 → 2.5.0

package/src/report/__test__/connector.test.ts

@@ -1,239 +0,0 @@
-import { afterEach, describe, expect, it, vi } from 'vitest'
-
-import { createHttpConnector, resolvePortOnTypeChange } from '../connector'
-import type { DataConnection } from '../connector'
-import type { ParamValues } from '../types'
-
-const CONNECTION: DataConnection = {
-  id: 'demo',
-  label: '演示业务库',
-  type: 'mysql',
-  host: '127.0.0.1',
-  port: 3306,
-  database: 'demo_business',
-  username: 'demo',
-  password: 'demo'
-}
-
-const SQL = 'SELECT customer, amount FROM orders WHERE region = ${region}'
-const VALUES: ParamValues = { region: '华东' }
-
-const ENDPOINT = 'https://api.example.com/report'
-
-interface FetchCall {
-  url: string
-  method: string
-  headers: Headers
-  body: unknown
-}
-
-function stubFetch(respond: (url: string, init: RequestInit) => Promise<unknown>): FetchCall[] {
-  const calls: FetchCall[] = []
-  const fetchMock = vi.fn(async (input: RequestInfo | URL, init?: RequestInit) => {
-    const url = String(input)
-    const method = init?.method ?? 'GET'
-    const headers = new Headers(init?.headers)
-    const body = typeof init?.body === 'string' ? (JSON.parse(init.body) as unknown) : undefined
-    calls.push({ url, method, headers, body })
-    const payload = await respond(url, init ?? {})
-    return new Response(JSON.stringify(payload), {
-      status: 200,
-      headers: { 'Content-Type': 'application/json' }
-    })
-  })
-  vi.stubGlobal('fetch', fetchMock)
-  return calls
-}
-
-afterEach(() => {
-  vi.unstubAllGlobals()
-})
-
-describe('createHttpConnector', () => {
-  it('test：POST {endpoint}/test，请求体为 { connection }，成功返回 ok 且无 data', async () => {
-    const calls = stubFetch(async () => ({ ok: true }))
-    const connector = createHttpConnector({ endpoint: ENDPOINT })
-
-    const result = await connector.test(CONNECTION)
-
-    expect(result).toEqual({ ok: true, data: undefined })
-    expect(calls).toHaveLength(1)
-    expect(calls[0]!.url).toBe(`${ENDPOINT}/test`)
-    expect(calls[0]!.method).toBe('POST')
-    expect(calls[0]!.headers.get('content-type')).toBe('application/json')
-    expect(calls[0]!.body).toEqual({ connection: CONNECTION })
-  })
-
-  it('describe：POST {endpoint}/describe，请求体 { connection, sql }，fields 归一化为 DatasetField', async () => {
-    const calls = stubFetch(async () => ({
-      ok: true,
-      fields: [{ name: 'customer' }, { name: 'amount', type: 'number' }]
-    }))
-    const connector = createHttpConnector({ endpoint: ENDPOINT })
-
-    const result = await connector.describe(CONNECTION, SQL)
-
-    expect(result).toEqual({
-      ok: true,
-      data: [
-        { name: 'customer', label: 'customer', type: 'string' },
-        { name: 'amount', label: 'amount', type: 'number' }
-      ]
-    })
-    expect(calls[0]!.url).toBe(`${ENDPOINT}/describe`)
-    expect(calls[0]!.body).toEqual({ connection: CONNECTION, sql: SQL })
-  })
-
-  it('describe：服务端返回 label 时保留中文显示名', async () => {
-    stubFetch(async () => ({
-      ok: true,
-      fields: [
-        { name: 'customer', label: '客户名称', type: 'string' },
-        { name: 'amount', label: '金额', type: 'number' }
-      ]
-    }))
-    const connector = createHttpConnector({ endpoint: ENDPOINT })
-
-    const result = await connector.describe(CONNECTION, SQL)
-
-    expect(result).toEqual({
-      ok: true,
-      data: [
-        { name: 'customer', label: '客户名称', type: 'string' },
-        { name: 'amount', label: '金额', type: 'number' }
-      ]
-    })
-  })
-
-  it('query：POST {endpoint}/query，请求体 { connection, sql, values }，返回 fields + rows', async () => {
-    const calls = stubFetch(async () => ({
-      ok: true,
-      fields: [{ name: 'customer', type: 'string' }],
-      rows: [{ customer: '甲公司' }]
-    }))
-    const connector = createHttpConnector({ endpoint: ENDPOINT })
-
-    const result = await connector.query(CONNECTION, SQL, VALUES)
-
-    expect(result).toEqual({
-      ok: true,
-      data: {
-        fields: [{ name: 'customer', label: 'customer', type: 'string' }],
-        rows: [{ customer: '甲公司' }]
-      }
-    })
-    expect(calls[0]!.url).toBe(`${ENDPOINT}/query`)
-    expect(calls[0]!.body).toEqual({ connection: CONNECTION, sql: SQL, values: VALUES })
-  })
-
-  it('业务错误分叉：200 + { ok: false, error } 原样透传（三端点一致）', async () => {
-    stubFetch(async () => ({
-      ok: false,
-      error: { code: 'CONNECTION_REFUSED', message: '无法连接到数据库' }
-    }))
-    const connector = createHttpConnector({ endpoint: ENDPOINT })
-
-    const testResult = await connector.test(CONNECTION)
-    expect(testResult).toEqual({
-      ok: false,
-      error: { code: 'CONNECTION_REFUSED', message: '无法连接到数据库' }
-    })
-
-    const describeResult = await connector.describe(CONNECTION, SQL)
-    expect(describeResult).toEqual({
-      ok: false,
-      error: { code: 'CONNECTION_REFUSED', message: '无法连接到数据库' }
-    })
-
-    const queryResult = await connector.query(CONNECTION, SQL, VALUES)
-    expect(queryResult).toEqual({
-      ok: false,
-      error: { code: 'CONNECTION_REFUSED', message: '无法连接到数据库' }
-    })
-  })
-
-  it('传输层错误：非 2xx 折叠为 HTTP_<status> 错误结果', async () => {
-    const fetchMock = vi.fn(async () => new Response('Internal Server Error', { status: 500 }))
-    vi.stubGlobal('fetch', fetchMock)
-    const connector = createHttpConnector({ endpoint: ENDPOINT })
-
-    const result = await connector.test(CONNECTION)
-
-    expect(result).toEqual({
-      ok: false,
-      error: { code: 'HTTP_500', message: '请求失败（HTTP 500）' }
-    })
-  })
-
-  it('网络异常：fetch reject 折叠为 NETWORK_ERROR', async () => {
-    vi.stubGlobal(
-      'fetch',
-      vi.fn(async () => Promise.reject(new Error('fetch failed')))
-    )
-    const connector = createHttpConnector({ endpoint: ENDPOINT })
-
-    const result = await connector.test(CONNECTION)
-
-    expect(result).toEqual({ ok: false, error: { code: 'NETWORK_ERROR', message: 'fetch failed' } })
-  })
-
-  it('响应不可解析：非 JSON / 缺字段折叠为 BAD_RESPONSE', async () => {
-    const notJson = vi.fn(async () => new Response('<html>oops</html>', { status: 200 }))
-    vi.stubGlobal('fetch', notJson)
-    const connector = createHttpConnector({ endpoint: ENDPOINT })
-
-    const invalidJson = await connector.describe(CONNECTION, SQL)
-    expect(invalidJson).toEqual({
-      ok: false,
-      error: { code: 'BAD_RESPONSE', message: '响应不是合法 JSON' }
-    })
-
-    vi.stubGlobal(
-      'fetch',
-      vi.fn(async () => new Response(JSON.stringify({ ok: true }), { status: 200 }))
-    )
-    const missingFields = await connector.describe(CONNECTION, SQL)
-    expect(missingFields).toEqual({
-      ok: false,
-      error: { code: 'BAD_RESPONSE', message: 'describe 响应缺少合法的 fields 数组' }
-    })
-
-    vi.stubGlobal(
-      'fetch',
-      vi.fn(async () => new Response(JSON.stringify({ ok: true, fields: [] }), { status: 200 }))
-    )
-    const missingRows = await connector.query(CONNECTION, SQL, VALUES)
-    expect(missingRows).toEqual({
-      ok: false,
-      error: { code: 'BAD_RESPONSE', message: 'query 响应缺少 rows 数组' }
-    })
-  })
-
-  it('ok:false 但 error 形状非法时回退 SERVER_ERROR', async () => {
-    stubFetch(async () => ({ ok: false, error: 'oops' }))
-    const connector = createHttpConnector({ endpoint: ENDPOINT })
-
-    const result = await connector.test(CONNECTION)
-
-    expect(result).toEqual({
-      ok: false,
-      error: { code: 'SERVER_ERROR', message: '服务端返回未知错误' }
-    })
-  })
-})
-
-describe('resolvePortOnTypeChange', () => {
-  it('默认端口随类型切换：MySQL 3306 ↔ PostgreSQL 5432', () => {
-    expect(resolvePortOnTypeChange('mysql', 'postgresql', 3306)).toBe(5432)
-    expect(resolvePortOnTypeChange('postgresql', 'mysql', 5432)).toBe(3306)
-  })
-
-  it('自定义端口不随类型切换而改变', () => {
-    expect(resolvePortOnTypeChange('mysql', 'postgresql', 3307)).toBe(3307)
-    expect(resolvePortOnTypeChange('postgresql', 'mysql', 5433)).toBe(5433)
-  })
-
-  it('端口为 0 时切到新类型默认端口', () => {
-    expect(resolvePortOnTypeChange('mysql', 'postgresql', 0)).toBe(5432)
-  })
-})

package/src/report/__test__/drill.test.ts

@@ -1,194 +0,0 @@
-import { Sheet, cellKey } from '@veltra/sheet-core'
-import { describe, expect, it } from 'vitest'
-
-import { REPORT_META_NAMESPACE } from '../binding'
-import {
-  buildDrillHitMap,
-  createDrillStack,
-  currentDrillLayer,
-  popDrillLayer,
-  pushDrillLayer,
-  resolveDrillParams
-} from '../drill'
-import { createReportTemplate, type ReportTemplate } from '../template'
-import type { ReportBinding, ReportDrillConfig } from '../types'
-
-// ---- 内联 fixtures ----
-
-/** 最小 Report Template：下钻栈只关心引用与参数，不消费快照内容 */
-function makeTemplate(rows: number): ReportTemplate {
-  return {
-    version: 1,
-    cells: [],
-    styles: [],
-    merges: [],
-    frozen: { rows: 0, cols: 0 },
-    rows,
-    cols: 0
-  }
-}
-
-const TPL_A = makeTemplate(10)
-const TPL_B = makeTemplate(20)
-const TPL_C = makeTemplate(30)
-
-const DRILL: ReportDrillConfig = {
-  target: 'tpl-detail',
-  mapping: { region: 'p_region', amount: 'p_amount' },
-  openMode: 'switch'
-}
-
-describe('resolveDrillParams', () => {
-  it('按映射从记录取值为详情报参数', () => {
-    const values = resolveDrillParams(DRILL, { region: '华东', amount: 100 })
-    expect(values).toEqual({ p_region: '华东', p_amount: 100 })
-  })
-
-  it('记录缺字段时跳过对应参数，null 值保留', () => {
-    const values = resolveDrillParams(DRILL, { region: '华东', amount: null })
-    expect(values).toEqual({ p_region: '华东', p_amount: null })
-    expect(
-      'p_missing' in resolveDrillParams({ ...DRILL, mapping: { missing: 'p_missing' } }, {})
-    ).toBe(false)
-  })
-
-  it('空映射返回空参数', () => {
-    expect(resolveDrillParams({ ...DRILL, mapping: {} }, { region: '华东' })).toEqual({})
-  })
-})
-
-describe('下钻栈', () => {
-  it('根层即当前层', () => {
-    const stack = createDrillStack({ template: TPL_A, params: { p: 'a0' } })
-    expect(stack).toHaveLength(1)
-    expect(currentDrillLayer(stack)).toEqual({ template: TPL_A, params: { p: 'a0' } })
-  })
-
-  it('push 后当前层为新层，前层参数定格为离开时的值', () => {
-    const stack = createDrillStack({ template: TPL_A, params: { p: 'a0' } })
-    const next = pushDrillLayer(stack, { template: TPL_B, params: { p: 'b1' } }, { p: 'a1' })
-    expect(next).toHaveLength(2)
-    expect(currentDrillLayer(next)).toEqual({ template: TPL_B, params: { p: 'b1' } })
-    expect(next[0]).toEqual({ template: TPL_A, params: { p: 'a1' } })
-    // 不可变更新：原栈不受影响
-    expect(stack).toHaveLength(1)
-  })
-
-  it('push 缺省 currentParams 时保留前层原参数', () => {
-    const stack = createDrillStack({ template: TPL_A, params: { p: 'a0' } })
-    const next = pushDrillLayer(stack, { template: TPL_B, params: {} })
-    expect(next[0]).toEqual({ template: TPL_A, params: { p: 'a0' } })
-  })
-
-  it('pop 逐级回退并保留各层当时参数', () => {
-    let stack = createDrillStack({ template: TPL_A, params: { p: 'a0' } })
-    stack = pushDrillLayer(stack, { template: TPL_B, params: { p: 'b1' } }, { p: 'a1' })
-    stack = pushDrillLayer(stack, { template: TPL_C, params: { p: 'c1' } }, { p: 'b2' })
-
-    stack = popDrillLayer(stack)
-    expect(currentDrillLayer(stack)).toEqual({ template: TPL_B, params: { p: 'b2' } })
-    stack = popDrillLayer(stack)
-    expect(currentDrillLayer(stack)).toEqual({ template: TPL_A, params: { p: 'a1' } })
-  })
-
-  it('仅剩根层时 pop 原样返回', () => {
-    const stack = createDrillStack({ template: TPL_A, params: {} })
-    expect(popDrillLayer(stack)).toBe(stack)
-  })
-
-  it('指向自身照常压栈，靠 pop 逐级退出', () => {
-    let stack = createDrillStack({ template: TPL_A, params: { p: 'a0' } })
-    stack = pushDrillLayer(stack, { template: TPL_A, params: { p: 'a1' } })
-    stack = pushDrillLayer(stack, { template: TPL_A, params: { p: 'a2' } })
-    expect(stack).toHaveLength(3)
-
-    stack = popDrillLayer(stack)
-    expect(currentDrillLayer(stack)).toEqual({ template: TPL_A, params: { p: 'a1' } })
-    stack = popDrillLayer(stack)
-    expect(currentDrillLayer(stack)).toEqual({ template: TPL_A, params: { p: 'a0' } })
-  })
-
-  it('成环照常压栈，回退沿压栈路径逐级退出', () => {
-    let stack = createDrillStack({ template: TPL_A, params: { p: 'root' } })
-    stack = pushDrillLayer(stack, { template: TPL_B, params: { p: 'b1' } })
-    stack = pushDrillLayer(stack, { template: TPL_A, params: { p: 'a-from-b' } })
-    stack = pushDrillLayer(stack, { template: TPL_B, params: { p: 'b2' } })
-    expect(stack.map((layer) => layer.template)).toEqual([TPL_A, TPL_B, TPL_A, TPL_B])
-
-    stack = popDrillLayer(stack)
-    expect(currentDrillLayer(stack)).toEqual({ template: TPL_A, params: { p: 'a-from-b' } })
-    stack = popDrillLayer(stack)
-    expect(currentDrillLayer(stack)).toEqual({ template: TPL_B, params: { p: 'b1' } })
-    stack = popDrillLayer(stack)
-    expect(currentDrillLayer(stack)).toEqual({ template: TPL_A, params: { p: 'root' } })
-  })
-})
-
-describe('buildDrillHitMap 与上下文解析', () => {
-  it('分组格与汇总聚合格均生成正确命中上下文（含汇总格自身聚合值）', () => {
-    const sheet = new Sheet()
-    sheet.setCellMeta({ row: 0, col: 0 }, REPORT_META_NAMESPACE, {
-      dataset: 'ds',
-      field: 'region',
-      aggregate: 'group',
-      expand: 'down',
-      drill: { target: 't2', mapping: { region: 'p_region' }, openMode: 'switch' }
-    })
-    sheet.setCellMeta({ row: 0, col: 1 }, REPORT_META_NAMESPACE, {
-      dataset: 'ds',
-      field: 'amount',
-      aggregate: 'sum',
-      expand: 'none',
-      rowParent: { row: 0, col: 0 },
-      drill: {
-        target: 't2',
-        mapping: { region: 'p_region', amount: 'p_amount' },
-        openMode: 'dialog'
-      }
-    })
-
-    const template = sheet.snapshot()
-    const data = {
-      ds: [
-        { region: '华东', amount: 100 },
-        { region: '华东', amount: 200 },
-        { region: '华南', amount: 50 }
-      ]
-    }
-
-    const hitMap = buildDrillHitMap(template, data)
-    // 华东分组格 (0,0)
-    const hitGroup0 = hitMap.get(cellKey({ row: 0, col: 0 }))
-    expect(hitGroup0?.record).toEqual({ region: '华东' })
-
-    // 华东汇总格 (0,1) 拥有祖先分组 region 与自身的求和计算值 300
-    const hitSum0 = hitMap.get(cellKey({ row: 0, col: 1 }))
-    expect(hitSum0?.record).toEqual({ region: '华东', amount: 300 })
-    expect(resolveDrillParams(hitSum0!.config, hitSum0!.record)).toEqual({
-      p_region: '华东',
-      p_amount: 300
-    })
-
-    // 华南汇总格 (1,1)
-    const hitSum1 = hitMap.get(cellKey({ row: 1, col: 1 }))
-    expect(hitSum1?.record).toEqual({ region: '华南', amount: 50 })
-    expect(resolveDrillParams(hitSum1!.config, hitSum1!.record)).toEqual({
-      p_region: '华南',
-      p_amount: 50
-    })
-  })
-})
-
-describe('旧绑定兼容', () => {
-  it('无 drill 字段的旧绑定序列化往返后不出现 drill 键', () => {
-    const binding: ReportBinding = {
-      dataset: 'orders',
-      field: 'region',
-      expand: 'down',
-      aggregate: 'list'
-    }
-    const restored = JSON.parse(JSON.stringify(binding)) as ReportBinding
-    expect('drill' in restored).toBe(false)
-    expect(restored.drill).toBeUndefined()
-  })
-})

package/src/report/__test__/export-xlsx.test.ts

@@ -1,96 +0,0 @@
-import { Sheet } from '@veltra/sheet-core'
-import { importXlsx } from '@veltra/sheet-core/core/io/import'
-import { describe, expect, it } from 'vitest'
-
-import { REPORT_META_NAMESPACE, createReportBinding } from '../binding'
-import { exportFilledReportXlsx } from '../export-xlsx'
-import { renderReport } from '../render'
-import type { DatasetCatalogItem } from '../types'
-
-// ---- 内联 fixtures ----
-
-const ORDERS_DATASET: DatasetCatalogItem = {
-  id: 'orders',
-  label: '销售明细',
-  fields: [
-    { name: 'customer', label: '客户', type: 'string' },
-    { name: 'amount', label: '金额', type: 'number' }
-  ]
-}
-
-const ORDER_ROWS: Record<string, unknown>[] = [
-  { customer: '甲公司', amount: 100 },
-  { customer: '乙公司', amount: 400 }
-]
-
-/** 金额 > 300 标红（条件样式打平进快照后随导出保真） */
-const RED_RULE = { operator: 'gt' as const, value: 300, style: { font: { color: '#DC2626' } } }
-
-/** 分组（客户）+ 明细（金额，带条件规则）模板 */
-function buildFilledSheet(): Sheet {
-  const sheet = new Sheet()
-  sheet.setCells([
-    { addr: { row: 0, col: 0 }, data: { v: '客户' } },
-    { addr: { row: 0, col: 1 }, data: { v: '金额' } }
-  ])
-  sheet.setCellStyle(
-    { start: { row: 0, col: 0 }, end: { row: 0, col: 1 } },
-    { font: { bold: true }, fill: { color: '#E8EEF7' } }
-  )
-
-  const groupAddr = { row: 1, col: 0 }
-  const group = createReportBinding(ORDERS_DATASET, 'customer')
-  group.preset = 'groupHeader'
-  group.aggregate = 'group'
-  group.expand = 'down'
-  sheet.setCellMeta(groupAddr, REPORT_META_NAMESPACE, group)
-
-  const amount = createReportBinding(ORDERS_DATASET, 'amount')
-  amount.rowParent = groupAddr
-  amount.conditionalRules = [RED_RULE]
-  sheet.setCellMeta({ row: 1, col: 1 }, REPORT_META_NAMESPACE, amount)
-
-  const filled = renderReport(sheet.snapshot(), { orders: ORDER_ROWS })
-  const filledSheet = new Sheet()
-  filledSheet.restore(filled)
-  filledSheet.restoreContent(filled)
-  return filledSheet
-}
-
-describe('exportFilledReportXlsx', () => {
-  it('导出保真 XLSX：值 / 表头样式 / 条件样式打平后随快照导出', async () => {
-    const filled = buildFilledSheet()
-    filled.setColWidth(0, 120)
-    filled.setColWidth(1, 140)
-    const buffer = await exportFilledReportXlsx(filled)
-
-    // 合法 ZIP（xlsx）字节
-    expect(buffer[0]).toBe(0x50)
-    expect(buffer[1]).toBe(0x4b)
-
-    const workbook = await importXlsx(buffer)
-    const sheet = workbook.getSheets()[0]!
-
-    // 展开值保真（分组头 + 明细值）
-    const values: unknown[] = []
-    for (const [, data] of sheet.store.entries()) values.push(data.v)
-    expect(values).toContain('甲公司')
-    expect(values).toContain('乙公司')
-    expect(values).toContain(400)
-
-    // 条件样式打平：amount=400（>300）的明细格带红字
-    let redFound = false
-    for (const [, data] of sheet.store.entries()) {
-      if (data.v !== 400 || data.s == null) continue
-      const style = sheet.stylePool.get(data.s)
-      if (style?.font?.color === '#DC2626') redFound = true
-    }
-    expect(redFound).toBe(true)
-
-    // 表头静态样式保真（加粗 + 底色）
-    const header = sheet.getCellData({ row: 0, col: 0 })
-    const headerStyle = header?.s != null ? sheet.stylePool.get(header.s) : undefined
-    expect(headerStyle?.font?.bold).toBe(true)
-    expect(headerStyle?.fill?.color).toBe('#E8EEF7')
-  })
-})

package/src/report/__test__/filter-bar.test.ts

@@ -1,58 +0,0 @@
-import { describe, expect, it } from 'vitest'
-
-import { parseDateRangeValue, patchParamValues, resolveNumberParamValue } from '../filter-bar'
-
-describe('parseDateRangeValue', () => {
-  it('解析数组形式的日期范围', () => {
-    expect(parseDateRangeValue(['2024-01-01', '2024-12-31'])).toEqual(['2024-01-01', '2024-12-31'])
-  })
-
-  it('解析 from/to 对象形式', () => {
-    expect(parseDateRangeValue({ from: '2024-03-01', to: '2024-03-31' })).toEqual([
-      '2024-03-01',
-      '2024-03-31'
-    ])
-  })
-
-  it('解析 start/end 对象形式', () => {
-    expect(parseDateRangeValue({ start: '2024-06-01', end: '2024-06-30' })).toEqual([
-      '2024-06-01',
-      '2024-06-30'
-    ])
-  })
-
-  it('空值回退为空字符串元组', () => {
-    expect(parseDateRangeValue(undefined)).toEqual(['', ''])
-    expect(parseDateRangeValue(null)).toEqual(['', ''])
-    expect(parseDateRangeValue('')).toEqual(['', ''])
-  })
-})
-
-describe('resolveNumberParamValue', () => {
-  it('保留有限数字', () => {
-    expect(resolveNumberParamValue(42)).toBe(42)
-    expect(resolveNumberParamValue('12.5')).toBe(12.5)
-  })
-
-  it('空值与非法值返回 undefined', () => {
-    expect(resolveNumberParamValue('')).toBeUndefined()
-    expect(resolveNumberParamValue(null)).toBeUndefined()
-    expect(resolveNumberParamValue(undefined)).toBeUndefined()
-    expect(resolveNumberParamValue('abc')).toBeUndefined()
-  })
-})
-
-describe('patchParamValues', () => {
-  it('合并单参数变更且保留其余值', () => {
-    const next = patchParamValues({ region: '华东', qty: 10 }, 'region', '华南')
-    expect(next).toEqual({ region: '华南', qty: 10 })
-  })
-
-  it('支持 date-range 元组写入', () => {
-    const next = patchParamValues({ dateRange: ['2024-01-01', '2024-01-31'] }, 'dateRange', [
-      '2024-02-01',
-      '2024-02-28'
-    ])
-    expect(next.dateRange).toEqual(['2024-02-01', '2024-02-28'])
-  })
-})