@epxing/utils 0.0.0-stage → 5.3.0-beta.1

package/package.json

@@ -1,6 +1,112 @@
 {
   "name": "@epxing/utils",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "5.3.0-beta.1",
+  "description": "工具函数（util/fieldFactory/meta/formula/pdf 等；深路径 @epxing/utils/src/* 为公共 API）",
+  "type": "module",
+  "main": "./dist/src/public.js",
+  "module": "./dist/src/public.js",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "import": "./dist/src/public.js",
+      "default": "./dist/src/public.js"
+    },
+    "./src": "./dist/src/legacy.js",
+    "./config": {
+      "types": "./types/Config.d.ts",
+      "import": "./dist/src/Config.js",
+      "default": "./dist/src/Config.js"
+    },
+    "./page": {
+      "types": "./types/page.d.ts",
+      "import": "./dist/src/page.js",
+      "default": "./dist/src/page.js"
+    },
+    "./placeholder": {
+      "types": "./types/placeholder.d.ts",
+      "import": "./dist/src/placeholder.js",
+      "default": "./dist/src/placeholder.js"
+    },
+    "./storage": {
+      "types": "./types/storage.d.ts",
+      "import": "./dist/src/storage.js",
+      "default": "./dist/src/storage.js"
+    },
+    "./date": {
+      "types": "./types/date-helper.d.ts",
+      "import": "./dist/src/date-helper.js",
+      "default": "./dist/src/date-helper.js"
+    },
+    "./dom": {
+      "types": "./types/dom-helper.d.ts",
+      "import": "./dist/src/dom-helper.js",
+      "default": "./dist/src/dom-helper.js"
+    },
+    "./date-time": {
+      "types": "./types/moment-compat.d.ts",
+      "import": "./dist/src/moment-compat.js",
+      "default": "./dist/src/moment-compat.js"
+    },
+    "./collection": {
+      "types": "./types/collection.d.ts",
+      "import": "./dist/src/collection.js",
+      "default": "./dist/src/collection.js"
+    },
+    "./src/*.css": "./src/*.css",
+    "./src/*.scss": "./src/*.scss",
+    "./src/*.png": "./src/*.png",
+    "./src/*.svg": "./src/*.svg",
+    "./src/*.jpg": "./src/*.jpg",
+    "./src/*.gif": "./src/*.gif",
+    "./src/*.woff": "./src/*.woff",
+    "./src/*.woff2": "./src/*.woff2",
+    "./src/*.ttf": "./src/*.ttf",
+    "./src/*.js": "./dist/src/*.js",
+    "./src/*.jsx": "./dist/src/*.js",
+    "./src/*.vue": "./dist/src/*.js",
+    "./src/*": "./dist/src/*.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "types",
+    "API.md"
+  ],
+  "dependencies": {
+    "dayjs": "^1.11.21",
+    "highlight.js": "^11.11.1",
+    "lodash-es": "^4.17.23"
+  },
+  "peerDependencies": {
+    "@epxing/core": "^5.3.0-beta",
+    "mermaid": "^11.17.2"
+  },
+  "peerDependenciesMeta": {
+    "@epxing/core": {
+      "optional": true
+    },
+    "mermaid": {
+      "optional": true
+    }
+  },
+  "types": "./types/index.d.ts",
+  "sideEffects": [
+    "**/*.css",
+    "**/*.scss",
+    "**/*.vue",
+    "./dist/src/app.js",
+    "./dist/src/plugins/**",
+    "./dist/src/store/**",
+    "./dist/src/mixins/**",
+    "./dist/src/runtime-utils/util.js",
+    "./dist/src/runtime-services.js"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "cd ../.. && cross-env PKG=utils vite build -c build/vite.pkg.config.mjs"
+  }
 }

package/src/Config.js

@@ -0,0 +1,25 @@
+import { isObject } from 'lodash-es'
+
+class Config {
+  // 设置配置
+  set (config) {
+    for (const key in config) {
+      try {
+        if (isObject(config[key])) {
+          if (Array.isArray(config[key])) {
+            this[key] = [...config[key]]
+          } else {
+            if (!this[key]) this[key] = {}
+            this[key] = { ...this[key], ...config[key] }
+          }
+        } else {
+          this[key] = config[key]
+        }
+      } catch (error) {
+        this[key] = config[key]
+      }
+    }
+  }
+}
+
+export default Config

package/src/asset-images.js

@@ -0,0 +1,16 @@
+// 动态路径图片资产表（Vite 版）—— 与 asset-images.js（webpack 版）保持同步！
+// vite.config alias 把 '@/utils/asset-images.js' 切到本文件（webpack 4 不认 import.meta，无法单文件双兼容）。
+const hall = import.meta.glob('@/assets/images/hall/*.png', { eager: true, query: '?url', import: 'default' })
+const root = import.meta.glob('@/assets/images/*.png', { eager: true, query: '?url', import: 'default' })
+const ce = import.meta.glob('@/assets/images/canvas-editor/*.{png,svg}', { eager: true, query: '?url', import: 'default' })
+
+const map = {}
+const strip = key => key.split('/assets/images/')[1]
+Object.keys(hall).forEach(key => { map[strip(key)] = hall[key] })
+Object.keys(root).forEach(key => { map[strip(key)] = root[key] })
+Object.keys(ce).forEach(key => { map[strip(key)] = ce[key] })
+
+// 按相对路径取图片 URL，如 imageAsset(`hall/${key}.png`)
+export function imageAsset (relPath) {
+  return map[relPath]
+}

package/src/chart-config-update.js

@@ -0,0 +1,16 @@
+// Unknown outer settings conservatively retain the designer's existing reload behavior.
+const visualKeys = new Set(['chartConfig', 'theme', 'color', 'componentName', 'title', 'title_i18n', 'height', 'minHeight', 'backgroundColor', 'backgroundStyle', 'backgroundImage', 'items', 'showFullscreenBtn'])
+const dataConfig = config => {
+  const chart = config.chartConfig || {}
+  const map = chart['series-map'] || {}
+  return {
+    ...Object.fromEntries(Object.entries(config).filter(([key]) => !visualKeys.has(key))),
+    refresh: chart.realtimeRefresh,
+    mapDimension: map.dimension,
+    mapAdcode: map.adcode
+  }
+}
+
+export function chartConfigRequiresReload (before, after, isEqual) {
+  return !isEqual(dataConfig(before || {}), dataConfig(after || {}))
+}

package/src/chart-data-adapters.js

@@ -0,0 +1,106 @@
+// New types reuse verified report protocols. No data snapshots are written to chartConfig.
+export function excludeBoxplotMissingValues (params) {
+  const fields = [...new Set((params.chartData?.statisticalList || []).map(item => item.fieldCode).filter(Boolean))]
+  if (!fields.length) return
+  const scopes = JSON.parse(params.scopeParams || '[]').map(item => ({ ...item }))
+  if (scopes.length) {
+    scopes[0].lb = '(' + (scopes[0].lb || '')
+    const last = scopes[scopes.length - 1]
+    last.rb = (last.rb || '') + ')'
+    last.link = 'and'
+  }
+  fields.forEach(field => scopes.push({ field, mode: 'not_null', link: 'and' }))
+  scopes[scopes.length - 1].link = ''
+  params.scopeParams = JSON.stringify(scopes)
+}
+
+const numeric = value => {
+  if (value === undefined || value === null || String(value).trim() === '') return null
+  const number = typeof value === 'number' ? value : Number(String(value ?? '').replace(/%$/, ''))
+  return Number.isFinite(number) && value !== null && value !== '' ? number : null
+}
+const failure = message => ({ hasData: false, message })
+const quantile = (sorted, p) => {
+  const index = (sorted.length - 1) * p
+  const lower = Math.floor(index)
+  return sorted[lower] + (sorted[Math.ceil(index)] - sorted[lower]) * (index - lower)
+}
+
+export function summarizeBoxplot (values) {
+  const sorted = values.map(numeric).filter(value => value !== null).sort((a, b) => a - b)
+  if (!sorted.length) return null
+  const q1 = quantile(sorted, 0.25)
+  const median = quantile(sorted, 0.5)
+  const q3 = quantile(sorted, 0.75)
+  const gap = (q3 - q1) * 1.5
+  const retained = sorted.filter(value => value >= q1 - gap && value <= q3 + gap)
+  return { value: [retained[0], q1, median, q3, retained[retained.length - 1]], outliers: sorted.filter(value => value < q1 - gap || value > q3 + gap), count: sorted.length }
+}
+
+export function buildAdvancedChartOption (type, data, config = {}, chartData = {}, theme = '') {
+  const option = Object.fromEntries(Object.entries(config).filter(([key]) => key !== 'title' && !key.startsWith('series-') && key !== 'echartsOptionOverride'))
+  option.tooltip = { trigger: 'item', confine: true, ...option.tooltip }
+  if (option.legend?._orient) {
+    const { direction = 'bottom', horizontal = 'center', vertical = 'center' } = option.legend._orient
+    const across = direction === 'top' || direction === 'bottom'
+    option.legend = { ...option.legend, orient: across ? 'horizontal' : 'vertical', top: direction === 'top' ? '20px' : !across && vertical === 'top' ? '20px' : !across && vertical === 'center' ? 'center' : 'auto', bottom: direction === 'bottom' || (!across && vertical === 'bottom') ? '20px' : 'auto', left: direction === 'left' || (across && horizontal === 'left') ? '20px' : across && horizontal === 'center' ? 'center' : 'auto', right: direction === 'right' || (across && horizontal === 'right') ? '20px' : 'auto' }
+    delete option.legend._orient
+  }
+  if (option.dataZoom?.show) {
+    option.dataZoom = [{ type: 'slider', startValue: 0, ...option.dataZoom, endValue: Number(option.dataZoom.endValue || 5) - 1 }]
+  } else if (option.dataZoom && !Array.isArray(option.dataZoom)) delete option.dataZoom
+  if (type === 'boxplot') {
+    if (chartData.categoryList?.length || chartData.statisticalList?.length !== 2) return failure('箱线图需要两个数字统计字段，并且不设置分类维度')
+    if (chartData.statisticalList.some(item => item.type !== 'indexField' || !item.fieldCode || item.fieldCode === 'record')) return failure('箱线图请使用数字字段，不支持记录数或自定义统计项')
+    const rows = data?.data
+    if (!Array.isArray(rows) || !rows.length) return failure()
+    if (rows.some(row => !Array.isArray(row) || row.length !== 2)) return failure('箱线图需要原始数字对数据')
+    const summaries = [0, 1].map(index => summarizeBoxplot(rows.map(row => row[index])))
+    if (summaries.some(item => !item)) return failure()
+    const names = chartData.statisticalList.map((item, index) => item.name || `指标 ${index + 1}`)
+    option.grid = { containLabel: true, left: 30, right: 20, top: 30, bottom: 30, ...option.grid }
+    option.xAxis = { ...option.xAxis, type: 'category', data: names }
+    option.yAxis = { type: 'value', ...option.yAxis }
+    option.series = [{ type: 'boxplot', name: '箱线', ...config['series-boxplot'], data: summaries.map((item, index) => ({ name: names[index], value: item.value })) }]
+    const outliers = summaries.flatMap((item, index) => item.outliers.map(value => [index, value]))
+    option.series.push({ type: 'scatter', name: '离群值', data: outliers })
+    return { hasData: true, option }
+  }
+  const series = data?.series
+  if (!Array.isArray(series) || !series.length || series.every(item => !item.data?.length)) return failure()
+  if (series.some(row => !Array.isArray(row.data) || row.data.some(item => numeric(item.value) === null))) return failure('当前统计结果包含非数值，不能生成此图表')
+  if (type === 'gauge') {
+    const cells = series.flatMap(row => row.data)
+    if (cells.length !== 1) return failure('仪表盘需要单个统计值；请设置一个指标且不拆分分类')
+    const cell = cells[0]
+    const value = numeric(cell.value)
+    option.series = [{ type: 'gauge', min: Math.min(0, value), max: Math.max(100, value), progress: { show: true }, detail: { formatter: '{value}' }, ...config['series-gauge'], data: [{ ...cell, value }] }]
+    if (['dark', 'technology'].includes(theme)) {
+      const gauge = option.series[0]
+      gauge.axisLabel = { color: '#d9e1ec', ...gauge.axisLabel }
+      gauge.detail = { color: '#d9e1ec', ...gauge.detail }
+      gauge.title = { color: '#d9e1ec', ...gauge.title }
+    }
+    if (!(Number(option.series[0].max) > Number(option.series[0].min))) return failure('仪表盘最大刻度必须大于最小刻度')
+    delete option.xAxis
+    delete option.yAxis
+    delete option.grid
+  } else if (type === 'treemap') {
+    if (series.some(row => row.data.some(item => numeric(item.value) < 0))) return failure('矩形树图的统计值不能为负数')
+    option.series = [{ type: 'treemap', roam: false, breadcrumb: { show: true }, ...config['series-treemap'], data: series.map((row, index) => ({ name: row.name || `指标 ${index + 1}`, children: row.data.map(cell => ({ ...cell, value: numeric(cell.value) })) })) }]
+    delete option.xAxis
+    delete option.yAxis
+    delete option.grid
+  } else if (type === 'heatmap') {
+    const categories = series[0].data.map(item => item.name || '')
+    if (series.some(row => row.data.length !== categories.length || row.data.some((cell, index) => (cell.name || '') !== categories[index]))) return failure('热力图要求各指标使用同一组分类维度')
+    const cells = series.flatMap((row, rowIndex) => row.data.map((cell, colIndex) => ({ ...cell, value: [colIndex, rowIndex, numeric(cell.value)] })))
+    const values = cells.map(cell => cell.value[2])
+    option.grid = { containLabel: true, left: 30, right: 30, top: 30, bottom: 60, ...option.grid }
+    option.xAxis = { type: 'category', splitArea: { show: true }, ...option.xAxis, data: categories }
+    option.yAxis = { type: 'category', splitArea: { show: true }, ...option.yAxis, data: series.map((row, index) => row.name || `指标 ${index + 1}`) }
+    option.visualMap = { min: values.reduce((min, value) => Math.min(min, value), Infinity), max: values.reduce((max, value) => Math.max(max, value), 1), calculable: true, orient: 'horizontal', left: 'center', bottom: 0, ...option.visualMap }
+    option.series = [{ type: 'heatmap', label: { show: false }, ...config['series-heatmap'], data: cells }]
+  } else return failure('不支持的图表类型')
+  return { hasData: true, option }
+}

package/src/chart-option-override.js

@@ -0,0 +1,126 @@
+import { getChartType } from './chart-registry'
+
+const own = (value, key) => Object.prototype.hasOwnProperty.call(value, key)
+const object = value => value !== null && typeof value === 'object' && !Array.isArray(value)
+const unsafeKeys = new Set(['__proto__', 'prototype', 'constructor'])
+const MAX_OVERRIDE_BYTES = 64 * 1024
+
+// The override is JSON option syntax. Platform statistics still own all data arrays.
+export function validateChartOptionOverride (override, baseOption = {}, chartType = '') {
+  const errors = []
+  if (!object(override)) return [{ path: '$', message: '覆盖层必须是 JSON 对象' }]
+  let encoded
+  try { encoded = JSON.stringify(override) } catch { return [{ path: '$', message: '覆盖层必须是可序列化的 JSON 对象' }] }
+  const size = new TextEncoder().encode(encoded).length
+  if (size > MAX_OVERRIDE_BYTES) errors.push({ path: '$', message: '覆盖层不能超过 64 KB' })
+  const visit = (value, path, depth = 0) => {
+    if (depth > 64) {
+      errors.push({ path, message: '配置层级不能超过 64 层' })
+      return
+    }
+    if (Array.isArray(value)) {
+      value.forEach((item, index) => visit(item, `${path}[${index}]`, depth + 1))
+      return
+    }
+    if (!object(value)) return
+    for (const [key, child] of Object.entries(value)) {
+      const childPath = path === '$' ? key : `${path}.${key}`
+      if (unsafeKeys.has(key)) errors.push({ path: childPath, message: '不支持的属性名' })
+      if (key === 'source' && (path === 'dataset' || /^dataset\[\d+\]$/.test(path))) errors.push({ path: childPath, message: '数据源由平台维护' })
+      if (key === 'data' && /^series\[\d+\]$/.test(path)) errors.push({ path: childPath, message: '系列数据由平台维护' })
+      visit(child, childPath, depth + 1)
+    }
+  }
+  visit(override, '$')
+
+  if (own(override, 'series')) {
+    const baseSeries = Array.isArray(baseOption.series) ? baseOption.series : [baseOption.series].filter(Boolean)
+    if (!Array.isArray(override.series) || override.series.length !== baseSeries.length || !override.series.every(object)) {
+      errors.push({ path: 'series', message: `系列覆盖必须与当前 ${baseSeries.length} 个系列逐项对应` })
+    } else {
+      override.series.forEach((series, index) => {
+        if (own(series, 'type') && series.type !== baseSeries[index]?.type) errors.push({ path: `series[${index}].type`, message: '不能改变平台系列类型' })
+        if (own(series, 'coordinateSystem')) {
+          const coordinate = baseSeries[index]?.coordinateSystem || getChartType(chartType)?.coordinate
+          if (series.coordinateSystem !== coordinate) errors.push({ path: `series[${index}].coordinateSystem`, message: '不能改变平台坐标系' })
+        }
+      })
+    }
+  }
+  if (Array.isArray(override.dataset)) errors.push({ path: 'dataset', message: '暂不支持替换数据集数组' })
+  if (own(override, 'dataset') && (!object(override.dataset) || Array.isArray(baseOption.dataset))) errors.push({ path: 'dataset', message: '不能替换平台数据集结构' })
+  for (const axis of ['xAxis', 'yAxis']) {
+    if (own(override, axis) && !(object(override[axis]) || (Array.isArray(override[axis]) && override[axis].length && override[axis].every(object)))) {
+      errors.push({ path: axis, message: '坐标轴必须是对象或非空对象数组' })
+    }
+  }
+  if (getChartType(chartType) && getChartType(chartType).coordinate !== 'cartesian2d') {
+    for (const axis of ['xAxis', 'yAxis', 'grid', 'dataZoom']) {
+      if (own(override, axis)) errors.push({ path: axis, message: '当前图表类型不使用直角坐标系' })
+    }
+  }
+  return errors
+}
+
+function mergeObject (base, patch) {
+  const result = object(base) ? { ...base } : {}
+  for (const [key, value] of Object.entries(patch)) {
+    if (object(value)) result[key] = mergeObject(result[key], value)
+    else if (Array.isArray(value)) result[key] = value.map(item => object(item) ? mergeObject({}, item) : item)
+    else result[key] = value
+  }
+  return result
+}
+
+export function applyChartOptionOverride (baseOption, override, chartType = '') {
+  // Identity is intentional: charts saved before code mode keep the old option.
+  if (override === undefined) return baseOption
+  const errors = validateChartOptionOverride(override, baseOption, chartType)
+  if (errors.length) return baseOption
+  const { series, ...other } = override
+  const result = mergeObject(baseOption, other)
+  // Native component patches preserve platform axes/data; ordinary arrays still replace.
+  for (const key of ['xAxis', 'yAxis', 'grid', 'legend', 'visualMap', 'dataZoom']) {
+    if (Array.isArray(other[key])) {
+      const base = Array.isArray(baseOption[key]) ? baseOption[key] : [baseOption[key]].filter(Boolean)
+      result[key] = Array.from({ length: Math.max(base.length, other[key].length) }, (_, index) => mergeObject(base[index], other[key][index] || {}))
+    } else if (object(other[key]) && Array.isArray(baseOption[key])) {
+      result[key] = baseOption[key].map((item, index) => index === 0 ? mergeObject(item, other[key]) : item)
+    }
+  }
+  if (series) {
+    result.series = baseOption.series.map((item, index) => mergeObject(item, series[index]))
+  }
+  return result
+}
+
+export function setChartOption (host, baseOption, override) {
+  host.chartOption = applyChartOptionOverride(baseOption, override, host.chartType)
+  if (host.designMode && host.$refs?.container) {
+    host.$refs.container.dispatchEvent(new CustomEvent('epx-chart-option-built', {
+      bubbles: true,
+      detail: { base: baseOption, effective: host.chartOption }
+    }))
+  }
+}
+
+// Render an explicit editor preview in a temporary host; the visible chart stays untouched on failure.
+export function validateChartOptionRendering (option, echarts) {
+  if (!echarts) return [{ path: '$', message: '等待图表加载后再预览' }]
+  const element = document.createElement('div')
+  element.style.cssText = 'position:fixed;left:-10000px;top:0;width:800px;height:400px;visibility:hidden;pointer-events:none'
+  document.body.appendChild(element)
+  let chart
+  try {
+    chart = echarts.init(element)
+    chart.setOption(option, { notMerge: true })
+    const expected = Array.isArray(option.series) ? option.series.length : option.series ? 1 : 0
+    if (chart.getOption && (chart.getOption().series?.length || 0) !== expected) throw new Error('当前 ECharts 未能加载全部系列类型')
+    return []
+  } catch (error) {
+    return [{ path: '$', message: `图表预览失败：${error.message}` }]
+  } finally {
+    if (chart) chart.dispose()
+    element.remove()
+  }
+}

package/src/chart-option-paths.js

@@ -0,0 +1,63 @@
+// Maps legacy visual fields to the native option paths they actually control.
+export function chartOverridePaths (key, base = {}, patch = {}) {
+  if (key === 'title' || key.startsWith('title.')) return []
+  if (key.startsWith('series-')) {
+    const [group, ...parts] = key.split('.')
+    const type = group.slice(7) === 'wordcloud' ? 'wordCloud' : group.slice(7)
+    if (['total', 'totalText'].includes(parts[0])) return []
+    const native = parts[0] === 'showArea' ? ['areaStyle'] : parts[0] === 'barType' ? ['stack'] : parts.join('.') === 'label.customFormatter' ? ['label', 'formatter'] : parts
+    return (base.series || []).flatMap((series, index) => series.type === type ? [['series', index, ...native]] : [])
+  }
+  if (/^yAxis\.(leftAxis|rightAxis)\./.test(key)) {
+    const [, side, ...parts] = key.split('.')
+    return [['yAxis', side === 'leftAxis' ? 0 : 1, ...parts]]
+  }
+  if (['yAxis.leftName', 'yAxis.rightName'].includes(key)) return [['yAxis', key === 'yAxis.leftName' ? 0 : 1, 'name']]
+  if (key.startsWith('legend._orient.')) {
+    const fields = key.endsWith('.horizontal') ? ['left', 'right'] : key.endsWith('.vertical') ? ['top', 'bottom'] : ['orient', 'left', 'right', 'top', 'bottom']
+    return fields.map(field => ['legend', field])
+  }
+  const [root, ...parts] = key.split('.')
+  if (Array.isArray(patch[root])) return patch[root].map((_, index) => [root, index, ...parts])
+  return [[root, ...parts]]
+}
+
+const readPath = (value, path) => {
+  if (!path.length) return value
+  if (Array.isArray(value) && typeof path[0] !== 'number') return value.map(item => readPath(item, path)).find(item => item !== undefined)
+  if (!Array.isArray(value) && typeof path[0] === 'number') return path[0] === 0 ? readPath(value, path.slice(1)) : undefined
+  return readPath(value?.[path[0]], path.slice(1))
+}
+
+export function isChartPathOverridden (patch, key, base) {
+  return chartOverridePaths(key, base, patch).some(path => readPath(patch, path) !== undefined)
+}
+
+export function clearChartOverridePath (patch, key, base) {
+  const remove = (value, path) => {
+    if (!value || !path.length) return
+    if (Array.isArray(value) && typeof path[0] !== 'number') {
+      value.forEach(item => remove(item, path))
+      return
+    }
+    if (!Array.isArray(value) && typeof path[0] === 'number') {
+      if (path[0] === 0) remove(value, path.slice(1))
+      return
+    }
+    const [part, ...rest] = path
+    if (!rest.length) {
+      if (Array.isArray(value)) value[part] = {}
+      else delete value[part]
+    } else {
+      remove(value[part], rest)
+      if (value[part] && !Array.isArray(value[part]) && typeof value[part] === 'object' && !Object.keys(value[part]).length && !Array.isArray(value)) delete value[part]
+    }
+  }
+  const paths = chartOverridePaths(key, base, patch)
+  for (const path of paths) remove(patch, path)
+  for (const root of new Set(paths.map(path => path[0]))) {
+    const value = patch[root]
+    if (Array.isArray(value) && value.every(item => item && typeof item === 'object' && !Object.keys(item).length)) delete patch[root]
+  }
+  return patch
+}

package/src/chart-registry.js

@@ -0,0 +1,41 @@
+// Shared metadata; persisted type names and backend request types retain their existing meaning.
+export const chartTypes = [
+  { type: 'table', text: '统计表', icon: 'epx-icon-tongjibiao', component: 'chart-table', requestType: 'table', coordinate: 'none' },
+  { type: 'pie', text: '饼状图', icon: 'epx-icon-bingzhuangtu', component: 'chart-common', requestType: 'pie', coordinate: 'none' },
+  { type: 'circularPie', text: '环形饼图', icon: 'epx-icon-bingzhuangtu', component: 'chart-common', requestType: 'pie', coordinate: 'none' },
+  { type: 'line', text: '折线图', icon: 'epx-icon-zhexiantu', component: 'chart-common', requestType: 'line', coordinate: 'cartesian2d' },
+  { type: 'column', text: '柱状图', icon: 'epx-icon-zhuzhuangtu', component: 'chart-common', requestType: 'bar', coordinate: 'cartesian2d' },
+  { type: 'horiColumn', text: '横向柱图', icon: 'epx-icon-zhuzhuangtu', component: 'chart-common', requestType: 'bar', cellScopeType: 'column', coordinate: 'cartesian2d' },
+  { type: 'funnel', text: '漏斗图', icon: 'epx-icon-loudoutu', component: 'chart-common', requestType: 'funnel', coordinate: 'none' },
+  { type: 'wordcloud', text: '词云', icon: 'epx-icon-ciyun', component: 'chart-wordcloud', requestType: 'wordCloud', coordinate: 'none' },
+  { type: 'radar', text: '雷达图', icon: 'epx-icon-leidatu', component: 'chart-radar', requestType: 'radar', coordinate: 'radar' },
+  { type: 'columnAndLine', text: '折柱混合', icon: 'epx-icon-zhezhutu', component: 'chart-common', requestType: 'bar', coordinate: 'cartesian2d' },
+  { type: 'scatter', text: '散点图', icon: 'epx-icon-sandiantu', component: 'chart-scatter', requestType: 'scatter', coordinate: 'cartesian2d', binding: 'numericPairs', drill: false },
+  { type: 'map', text: '地图', icon: 'epx-icon-ditu', component: 'chart-map', requestType: 'map', coordinate: 'geo' },
+  { type: 'gauge', text: '仪表盘', icon: 'epx-icon-leidatu', component: 'chart-advanced', requestType: 'bar', cellScopeType: 'column', coordinate: 'none', dataHint: '单个统计值；设置一个指标且不拆分分类。' },
+  { type: 'treemap', text: '矩形树图', icon: 'epx-icon-tongjibiao', component: 'chart-advanced', requestType: 'bar', cellScopeType: 'column', coordinate: 'none', dataHint: '按指标、分类组成两层矩形树，使用非负统计值；叶子支持钻取。' },
+  { type: 'heatmap', text: '热力图', icon: 'epx-icon-zhuzhuangtu', component: 'chart-advanced', requestType: 'bar', cellScopeType: 'column', coordinate: 'cartesian2d', dataHint: '横轴为分类，纵轴为指标；各指标使用同一组分类。' },
+  { type: 'boxplot', text: '箱线图', selectable: false, icon: 'epx-icon-zhexiantu', component: 'chart-advanced', requestType: 'scatter', coordinate: 'cartesian2d', binding: 'numericPairs', drill: false, dataHint: '选择两个数字统计字段，不设置分类；使用原始值计算四分位数与 1.5 倍四分位距的离群值，不支持钻取。' }
+]
+
+export const selectableChartTypes = chartTypes.filter(item => item.selectable !== false)
+
+export function getChartType (type) {
+  return chartTypes.find(item => item.type === (type === 'bar' ? 'column' : type))
+}
+
+export const chartConfigCategories = [
+  { key: 'all', label: '全部' },
+  { key: 'appearance', label: '外观' }, { key: 'axis', label: '坐标与刻度' },
+  { key: 'shape', label: '图形' }, { key: 'label', label: '标签与提示' },
+  { key: 'interaction', label: '交互' }, { key: 'advanced', label: '高级' }
+]
+
+export function getChartConfigCategory (key) {
+  if (['title', 'grid', 'color', 'backgroundColor'].includes(key)) return 'appearance'
+  if (['xAxis', 'yAxis', 'dualAxes', 'dataZoom'].includes(key)) return 'axis'
+  if (key.startsWith('series-') || ['series.map', 'radar', 'scatter', 'table', 'visualMap'].includes(key)) return 'shape'
+  if (['legend', 'tooltip'].includes(key)) return 'label'
+  if (key === 'toolbox') return 'interaction'
+  return 'advanced'
+}

package/src/chart-render-host.js

@@ -0,0 +1,56 @@
+// Shared lifecycle for inline charts and saved report charts.
+import { getChartType } from './chart-registry'
+
+const registeredThemes = new WeakSet()
+export function registerChartThemes (echarts, themes) {
+  if (registeredThemes.has(echarts)) return
+  for (const key in themes) echarts.registerTheme(key, themes[key])
+  registeredThemes.add(echarts)
+}
+export function disposeChartHost (host) {
+  if (host.observedChartDom) {
+    host.resizeObserver?.unobserve(host.observedChartDom)
+    host.observedChartDom = null
+  }
+  if (!host.myChart) return
+  host.myChart.off('click', host.openPivotPage)
+  host.myChart.dispose()
+  host.myChart = null
+  host.renderedChartTheme = null
+}
+
+export function renderChartHost (host, option, settings) {
+  const element = host.$refs?.chart
+  if (!element || !host.echarts || !option) return false
+  const { width, height } = element.getBoundingClientRect()
+  if (width <= 0 || height <= 0) return false
+
+  const staleDom = host.myChart && host.myChart.getDom && host.myChart.getDom() !== element
+  const theme = settings && Object.prototype.hasOwnProperty.call(settings, 'theme') ? settings.theme : host.chartTheme
+  const changedTheme = host.myChart && host.renderedChartTheme !== theme
+  if (staleDom || changedTheme) disposeChartHost(host)
+  if (!host.myChart) {
+    host.myChart = host.echarts.init(element, theme)
+    host.renderedChartTheme = theme
+    if (host.openClickEvent) host.myChart.on('click', host.openPivotPage)
+  }
+  // Header/search controls can change the plot height while the outer card stays fixed.
+  if (host.resizeObserver && host.observedChartDom !== element) {
+    if (host.observedChartDom) host.resizeObserver.unobserve(host.observedChartDom)
+    host.resizeObserver.observe(element)
+    host.observedChartDom = element
+  }
+  // Old code disposed on every update, so notMerge preserves its full-replacement semantics.
+  try {
+    host.myChart.setOption(option, { notMerge: true })
+    const expected = Array.isArray(option.series) ? option.series.length : option.series ? 1 : 0
+    const enforceSeries = getChartType(host.chartType)?.component === 'chart-advanced' || host.chartConfigs?.chartConfig?.echartsOptionOverride !== undefined
+    if (enforceSeries && host.myChart.getOption && (host.myChart.getOption().series?.length || 0) !== expected) throw new Error('未能加载全部系列类型')
+  } catch (error) {
+    disposeChartHost(host)
+    host.error = true
+    host.chartErrorText = `图表配置无法渲染：${error.message}`
+    return false
+  }
+  return true
+}