@fses/workbench-app 0.2.0 → 0.2.1

package/node_modules/@fses/workbench-card/src/registry/echartsTemplateCategories.ts

@@ -0,0 +1,74 @@
+/**
+ * @fileoverview ECharts 模板主类别归类 - 将官方 category、seriesTypes 和 protocolType 映射到系统卡片分类。
+ * @author seadon
+ * @created 2026-06-22
+ */
+import type { ProtocolType } from '../types/echartsProtocol';
+import type { EChartsMainCategoryDefinition } from './echartsTemplateTypes';
+
+export interface ResolveEChartsMainCategoryInput {
+  category: string[];
+  seriesTypes: string[];
+  protocolType: ProtocolType;
+}
+
+export const ECHARTS_AUXILIARY_TAGS = new Set([
+  'dataset',
+  'transform',
+  'dataZoom',
+  'visualMap',
+  'animation',
+  'animtion',
+  'graphic',
+  'rich',
+]);
+
+export const ECHARTS_MAIN_CATEGORIES: EChartsMainCategoryDefinition[] = [
+  { id: 'line', name: '折线图', categoryId: 'card.echarts.line', description: '折线、面积、趋势类 ECharts 模板。', officialKeys: ['line'], seriesTypeKeys: ['line'], protocolFallbacks: [] },
+  { id: 'bar', name: '柱状图', categoryId: 'card.echarts.bar', description: '柱状、堆叠、瀑布、排序柱图模板。', officialKeys: ['bar'], seriesTypeKeys: ['bar'], protocolFallbacks: [] },
+  { id: 'pie', name: '饼图', categoryId: 'card.echarts.pie', description: '饼图、环图和占比结构模板。', officialKeys: ['pie'], seriesTypeKeys: ['pie'], protocolFallbacks: [] },
+  { id: 'scatter', name: '散点图', categoryId: 'card.echarts.scatter', description: '散点、气泡和分布类模板。', officialKeys: ['scatter'], seriesTypeKeys: ['scatter', 'effectScatter', 'scatterGL'], protocolFallbacks: [] },
+  { id: 'geoMap', name: '地理坐标/地图', categoryId: 'card.echarts.geoMap', description: '地图、地理坐标和区域分布模板。', officialKeys: ['map', 'geo'], seriesTypeKeys: ['map'], protocolFallbacks: ['geo'] },
+  { id: 'candlestick', name: 'K 线图', categoryId: 'card.echarts.candlestick', description: 'K 线和金融走势模板。', officialKeys: ['candlestick'], seriesTypeKeys: ['candlestick'], protocolFallbacks: [] },
+  { id: 'radar', name: '雷达图', categoryId: 'card.echarts.radar', description: '雷达指标模板。', officialKeys: ['radar'], seriesTypeKeys: ['radar'], protocolFallbacks: [] },
+  { id: 'boxplot', name: '盒须图', categoryId: 'card.echarts.boxplot', description: '箱线、离群值和统计分布模板。', officialKeys: ['boxplot'], seriesTypeKeys: ['boxplot'], protocolFallbacks: [] },
+  { id: 'heatmap', name: '热力图', categoryId: 'card.echarts.heatmap', description: '热力矩阵、日历热力和笛卡尔热力模板。', officialKeys: ['heatmap'], seriesTypeKeys: ['heatmap'], protocolFallbacks: [] },
+  { id: 'graph', name: '关系图', categoryId: 'card.echarts.graph', description: '关系、力导向和网络节点模板。', officialKeys: ['graph', 'chord'], seriesTypeKeys: ['graph', 'graphGL', 'chord'], protocolFallbacks: ['network'] },
+  { id: 'lines', name: '路径图', categoryId: 'card.echarts.lines', description: '飞线、轨迹和路径模板。', officialKeys: ['lines'], seriesTypeKeys: ['lines', 'lines3D', 'linesGL'], protocolFallbacks: [] },
+  { id: 'tree', name: '树图', categoryId: 'card.echarts.tree', description: '树形层级模板。', officialKeys: ['tree'], seriesTypeKeys: ['tree'], protocolFallbacks: ['tree'] },
+  { id: 'treemap', name: '矩形树图', categoryId: 'card.echarts.treemap', description: '矩形树图和面积占比层级模板。', officialKeys: ['treemap'], seriesTypeKeys: ['treemap'], protocolFallbacks: [] },
+  { id: 'sunburst', name: '旭日图', categoryId: 'card.echarts.sunburst', description: '旭日层级占比模板。', officialKeys: ['sunburst'], seriesTypeKeys: ['sunburst'], protocolFallbacks: [] },
+  { id: 'parallel', name: '平行坐标', categoryId: 'card.echarts.parallel', description: '多变量平行坐标模板。', officialKeys: ['parallel'], seriesTypeKeys: ['parallel'], protocolFallbacks: [] },
+  { id: 'sankey', name: '桑基图', categoryId: 'card.echarts.sankey', description: '流向、能量流和路径转化模板。', officialKeys: ['sankey'], seriesTypeKeys: ['sankey'], protocolFallbacks: [] },
+  { id: 'funnel', name: '漏斗图', categoryId: 'card.echarts.funnel', description: '转化漏斗和分阶段流失模板。', officialKeys: ['funnel'], seriesTypeKeys: ['funnel'], protocolFallbacks: [] },
+  { id: 'gauge', name: '仪表盘', categoryId: 'card.echarts.gauge', description: '仪表盘和进度仪表模板。', officialKeys: ['gauge'], seriesTypeKeys: ['gauge'], protocolFallbacks: [] },
+  { id: 'pictorialBar', name: '象形柱图', categoryId: 'card.echarts.pictorialBar', description: '象形柱、符号柱和图形化柱图模板。', officialKeys: ['pictorialBar'], seriesTypeKeys: ['pictorialBar'], protocolFallbacks: [] },
+  { id: 'themeRiver', name: '主题河流图', categoryId: 'card.echarts.themeRiver', description: '主题河流和时序构成模板。', officialKeys: ['themeRiver'], seriesTypeKeys: ['themeRiver'], protocolFallbacks: [] },
+  { id: 'calendar', name: '日历坐标', categoryId: 'card.echarts.calendar', description: '日历热力和日历坐标模板。', officialKeys: ['calendar'], seriesTypeKeys: [], protocolFallbacks: [] },
+  { id: 'custom', name: '自定义系列', categoryId: 'card.echarts.custom', description: 'custom series 和自由绘制模板。', officialKeys: ['custom'], seriesTypeKeys: ['custom'], protocolFallbacks: ['graphic', 'layout', 'composite', 'configOnly', 'transition'] },
+  { id: 'gl3d', name: '3D/GL 图表', categoryId: 'card.echarts.gl3d', description: '3D 散点、曲面、地球和 GL 模板。', officialKeys: ['3D', 'gl', 'globe'], seriesTypeKeys: ['bar3D', 'scatter3D', 'surface', 'lines3D', 'line3D', 'map3D', 'scatterGL', 'linesGL', 'graphGL'], protocolFallbacks: ['scene3D'] },
+];
+
+/**
+ * 解析 ECharts 示例主类别。
+ * @param input - 官方 category、seriesTypes 和协议类型。
+ * @returns 匹配到的主类别定义。
+ */
+export function resolveEChartsMainCategory(input: ResolveEChartsMainCategoryInput): EChartsMainCategoryDefinition | undefined {
+  const normalizedCategory = input.category.filter((key) => !ECHARTS_AUXILIARY_TAGS.has(key));
+  const glCategory = ECHARTS_MAIN_CATEGORIES.find((category) => category.id === 'gl3d');
+  if (
+    glCategory
+    && (
+      glCategory.officialKeys.some((key) => normalizedCategory.includes(key))
+      || glCategory.seriesTypeKeys.some((key) => input.seriesTypes.includes(key))
+      || glCategory.protocolFallbacks.includes(input.protocolType)
+    )
+  ) {
+    return glCategory;
+  }
+
+  return ECHARTS_MAIN_CATEGORIES.find((category) => category.officialKeys.some((key) => normalizedCategory.includes(key)))
+    ?? ECHARTS_MAIN_CATEGORIES.find((category) => category.seriesTypeKeys.some((key) => input.seriesTypes.includes(key)))
+    ?? ECHARTS_MAIN_CATEGORIES.find((category) => category.protocolFallbacks.includes(input.protocolType));
+}