@fses/workbench-app 0.1.3 → 0.2.1

package/node_modules/@fses/workbench-card/src/renderers/chart/echarts-protocol/converters/composite.converter.ts

@@ -0,0 +1,71 @@
+/**
+ * @fileoverview Composite 协议转换器 — 将多图表组合数据转换为 ECharts option
+ * @author seadon
+ * @created 2026-05-05
+ */
+
+import type { EChartsOption } from 'echarts';
+
+import type {
+  ProtocolConfigPayload,
+  ProtocolConverter,
+  ProtocolDataPayload,
+  CompositeDataPayload,
+} from '../types';
+
+/**
+ * Composite 协议转换器，处理混合/多图表组合配置
+ * 支持在同一画布上组合多种图表类型
+ */
+export const compositeConverter: ProtocolConverter = {
+  /**
+   * 根据协议配置构建组合图表的 ECharts option 骨架
+   * 包含坐标轴、系列、提示框和图例等基础配置
+   * @param config - 协议配置载荷
+   * @returns 包含坐标轴、空系列、提示框和图例的 ECharts option
+   */
+  buildOption(config: ProtocolConfigPayload): EChartsOption {
+    const option: EChartsOption = {
+      xAxis: {
+        type: 'category',
+      },
+      yAxis: {
+        type: 'value',
+      },
+      // SeriesDef.type 为通用 string，需断言为 any 以满足 ECharts SeriesOption 字面量联合类型
+      series: config.series.map((def) => ({
+        id: def.id,
+        type: def.type,
+        data: [],
+      })) as any[],
+      tooltip: {},
+      legend: {},
+    };
+
+    if (config.optionPatch) {
+      Object.assign(option, config.optionPatch);
+    }
+
+    return option;
+  },
+
+  /**
+   * 将组合数据合并到已有的 ECharts option 中
+   * dataset 中的属性会展开为顶层 option 属性
+   * @param option - 已有的 ECharts option
+   * @param data - 协议数据载荷
+   * @returns 更新后的 ECharts option
+   */
+  mergeData(option: EChartsOption, data: ProtocolDataPayload): EChartsOption {
+    const compositeData = data as CompositeDataPayload;
+    const merged = { ...option };
+    const dataset = compositeData.dataset;
+    if (!dataset) return merged;
+
+    // 将 dataset 中除 id/shape 外的属性展开到 option 中
+    const { id: _id, shape: _shape, ...rest } = dataset;
+    Object.assign(merged, rest);
+
+    return merged;
+  },
+};

package/node_modules/@fses/workbench-card/src/renderers/chart/echarts-protocol/converters/configOnly.converter.ts

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview ConfigOnly 协议转换器 — 纯配置图表转换器，不涉及外部数据
+ * @author seadon
+ * @created 2026-05-05
+ */
+
+import type { EChartsOption } from 'echarts';
+
+import type {
+  ProtocolConfigPayload,
+  ProtocolConverter,
+  ProtocolDataPayload,
+} from '../types';
+
+/**
+ * ConfigOnly 协议转换器，适用于所有数据已内嵌在配置中的图表
+ * buildOption 直接使用 optionPatch 构建 option，mergeData 为空操作
+ */
+export const configOnlyConverter: ProtocolConverter = {
+  /**
+   * 直接将 optionPatch 展开为 ECharts option
+   * 此类图表的所有数据已包含在配置中，无需外部数据源
+   * @param config - 协议配置载荷
+   * @returns 由 optionPatch 构建的 ECharts option
+   */
+  buildOption(config: ProtocolConfigPayload): EChartsOption {
+    const option: EChartsOption = {};
+
+    if (config.optionPatch) {
+      Object.assign(option, config.optionPatch);
+    }
+
+    return option;
+  },
+
+  /**
+   * 空操作 — ConfigOnly 协议不处理外部数据
+   * 所有数据已在 buildOption 阶段通过 optionPatch 注入
+   * @param option - 已有的 ECharts option
+   * @returns 原样返回未修改的 option
+   */
+  mergeData(option: EChartsOption, _data: ProtocolDataPayload): EChartsOption {
+    return option;
+  },
+};

package/node_modules/@fses/workbench-card/src/renderers/chart/echarts-protocol/converters/geo.converter.ts

@@ -0,0 +1,97 @@
+/**
+ * @fileoverview Geo 协议转换器 — 将地理数据转换为 ECharts option
+ * @author seadon
+ * @created 2026-05-05
+ */
+
+import type { EChartsOption } from 'echarts';
+
+import type {
+  ProtocolConfigPayload,
+  ProtocolConverter,
+  ProtocolDataPayload,
+  GeoDataPayload,
+} from '../types';
+
+/**
+ * 判断地理 option 是否包含非 map 系列。
+ * @param series - 候选 series 配置。
+ * @returns 需要顶层 geo 坐标系时返回 true。
+ */
+function needsStandaloneGeo(series: unknown): boolean {
+  const seriesItems = Array.isArray(series) ? series : series ? [series] : [];
+  return seriesItems.some((item) => {
+    if (!item || typeof item !== 'object' || Array.isArray(item)) return false;
+    const record = item as Record<string, unknown>;
+    return record.type !== 'map' || record.coordinateSystem === 'geo';
+  });
+}
+
+/**
+ * Geo 协议转换器，处理地图可视化数据（区域着色、散点叠加、连线叠加）
+ */
+export const geoConverter: ProtocolConverter = {
+  /**
+   * 根据协议配置构建地理图表的 ECharts option 骨架
+   * 包含视觉映射组件用于区域着色
+   * @param config - 协议配置载荷
+   * @returns 包含 visualMap 和空系列数据的 ECharts option
+   */
+  buildOption(config: ProtocolConfigPayload): EChartsOption {
+    const option: EChartsOption = {
+      visualMap: {
+        min: 0,
+        max: 100,
+        text: ['High', 'Low'],
+        inRange: {
+          color: ['#e0ffff', '#006edd'],
+        },
+        calculable: true,
+      },
+      // SeriesDef.type 为通用 string，需断言为 any 以满足 ECharts SeriesOption 字面量联合类型
+      series: config.series.map((def) => ({
+        id: def.id,
+        type: def.type,
+        data: [],
+      })) as any[],
+    };
+
+    if (config.optionPatch) {
+      Object.assign(option, config.optionPatch);
+    }
+
+    return option;
+  },
+
+  /**
+   * 将地理数据合并到已有的 ECharts option 中
+   * @param option - 已有的 ECharts option
+   * @param data - 协议数据载荷，包含地图名称和区域数据
+   * @returns 更新后的 ECharts option
+   */
+  mergeData(option: EChartsOption, data: ProtocolDataPayload): EChartsOption {
+    const geoData = data as GeoDataPayload;
+    const merged = { ...option };
+    const dataset = geoData.dataset;
+    if (!dataset || typeof dataset !== 'object') return merged;
+
+    // 设置地图名称
+    if (dataset.mapName && needsStandaloneGeo(merged.series)) {
+      // GeoOption 类型与 Record<string, unknown> 不兼容，需先断言为 unknown
+      merged.geo = {
+        ...((merged.geo as unknown as Record<string, unknown>) || {}),
+        map: dataset.mapName,
+      };
+    }
+
+    // 设置区域数据到系列中
+    if (Array.isArray(merged.series) && Array.isArray(dataset.regions)) {
+      merged.series = merged.series.map((s) => ({
+        ...(s as Record<string, unknown>),
+        data: dataset.regions,
+      }));
+    }
+
+    return merged;
+  },
+};

package/node_modules/@fses/workbench-card/src/renderers/chart/echarts-protocol/converters/graphic.converter.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview Graphic 协议转换器 — 将自定义图形元素数据转换为 ECharts option
+ * @author seadon
+ * @created 2026-05-05
+ */
+
+import type { EChartsOption } from 'echarts';
+
+import type {
+  ProtocolConfigPayload,
+  ProtocolConverter,
+  ProtocolDataPayload,
+  GraphicDataPayload,
+} from '../types';
+
+/**
+ * Graphic 协议转换器，处理自定义图形元素（文本、图片、形状等）
+ */
+export const graphicConverter: ProtocolConverter = {
+  /**
+   * 根据协议配置构建自定义图形的 ECharts option 骨架
+   * @param config - 协议配置载荷
+   * @returns 包含空 graphic.elements 数组的 ECharts option
+   */
+  buildOption(config: ProtocolConfigPayload): EChartsOption {
+    // graphic.elements 类型要求 GraphicComponentElementOption，使用 as any 兼容空数组
+    const option: EChartsOption = {
+      graphic: {
+        elements: [] as any,
+      },
+    };
+
+    if (config.optionPatch) {
+      Object.assign(option, config.optionPatch);
+    }
+
+    return option;
+  },
+
+  /**
+   * 将图形元素数据合并到已有的 ECharts option 中
+   * @param option - 已有的 ECharts option
+   * @param data - 协议数据载荷，包含自定义图形元素描述
+   * @returns 更新后的 ECharts option
+   */
+  mergeData(option: EChartsOption, data: ProtocolDataPayload): EChartsOption {
+    const graphicData = data as GraphicDataPayload;
+    const merged = { ...option };
+    if (!graphicData.dataset) return merged;
+
+    // graphic 接受多种类型，使用 as any 兼容 elements 赋值
+    merged.graphic = {
+      ...((merged.graphic as Record<string, unknown>) || {}),
+      elements: graphicData.dataset.elements as any,
+    };
+
+    return merged;
+  },
+};

package/node_modules/@fses/workbench-card/src/renderers/chart/echarts-protocol/converters/layout.converter.ts

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview Layout 协议转换器 — 将网格/仪表板布局描述转换为 ECharts option
+ * @author seadon
+ * @created 2026-05-05
+ */
+
+import type { EChartsOption } from 'echarts';
+
+import type {
+  ProtocolConfigPayload,
+  ProtocolConverter,
+  ProtocolDataPayload,
+  LayoutDataPayload,
+} from '../types';
+
+/**
+ * Layout 协议转换器，处理多网格布局的仪表板配置
+ * buildOption 直接使用 optionPatch 作为完整 option
+ */
+export const layoutConverter: ProtocolConverter = {
+  /**
+   * 直接将 optionPatch 展开为 ECharts option
+   * 布局类图表完全由 optionPatch 定义结构
+   * @param config - 协议配置载荷
+   * @returns 由 optionPatch 构建的 ECharts option
+   */
+  buildOption(config: ProtocolConfigPayload): EChartsOption {
+    const option: EChartsOption = {};
+
+    if (config.optionPatch) {
+      Object.assign(option, config.optionPatch);
+    }
+
+    return option;
+  },
+
+  /**
+   * 将布局数据合并到已有的 ECharts option 中
+   * @param option - 已有的 ECharts option
+   * @param data - 协议数据载荷，包含网格布局描述
+   * @returns 更新后的 ECharts option
+   */
+  mergeData(option: EChartsOption, data: ProtocolDataPayload): EChartsOption {
+    const layoutData = data as LayoutDataPayload;
+    const merged = { ...option };
+    if (!layoutData.dataset) return merged;
+
+    // GridOption 类型要求严格，grids 为 unknown[] 需断言
+    merged.grid = layoutData.dataset.grids as any;
+
+    return merged;
+  },
+};

package/node_modules/@fses/workbench-card/src/renderers/chart/echarts-protocol/converters/network.converter.ts

@@ -0,0 +1,82 @@
+/**
+ * @fileoverview Network 协议转换器 — 将关系图/网络数据转换为 ECharts option
+ * @author seadon
+ * @created 2026-05-05
+ */
+
+import type { EChartsOption } from 'echarts';
+
+import type {
+  ProtocolConfigPayload,
+  ProtocolConverter,
+  ProtocolDataPayload,
+  NetworkDataPayload,
+} from '../types';
+
+/**
+ * Network 协议转换器，处理节点和边的关系图数据
+ */
+export const networkConverter: ProtocolConverter = {
+  /**
+   * 根据协议配置构建关系图的 ECharts option 骨架
+   * 对 type='graph' 的系列添加力引导布局和漫游支持
+   * @param config - 协议配置载荷
+   * @returns 包含空节点和边数据的 ECharts option
+   */
+  buildOption(config: ProtocolConfigPayload): EChartsOption {
+    // SeriesDef.type 为通用 string，需断言为 any 以满足 ECharts SeriesOption 字面量联合类型
+    const option: EChartsOption = {
+      series: config.series.map((def) => {
+        const seriesItem: Record<string, unknown> = {
+          id: def.id,
+          type: def.type,
+          data: [],
+          links: [],
+        };
+
+        // 力引导图需要配置布局和漫游
+        if (def.type === 'graph') {
+          seriesItem.layout = 'force';
+          seriesItem.roam = true;
+        }
+
+        return seriesItem;
+      }) as any[],
+    };
+
+    if (config.optionPatch) {
+      Object.assign(option, config.optionPatch);
+    }
+
+    return option;
+  },
+
+  /**
+   * 将网络数据合并到已有的 ECharts option 中
+   * @param option - 已有的 ECharts option
+   * @param data - 协议数据载荷，包含节点、边和可选的分组类别
+   * @returns 更新后的 ECharts option
+   */
+  mergeData(option: EChartsOption, data: ProtocolDataPayload): EChartsOption {
+    const networkData = data as NetworkDataPayload;
+    const merged = { ...option };
+    const dataset = networkData.dataset;
+
+    if (Array.isArray(merged.series)) {
+      merged.series = merged.series.map((s) => {
+        const seriesDef = { ...(s as Record<string, unknown>) };
+        seriesDef.data = dataset.nodes;
+        seriesDef.links = dataset.links;
+
+        // 设置分组类别（如果存在）
+        if (dataset.categories) {
+          seriesDef.categories = dataset.categories;
+        }
+
+        return seriesDef;
+      });
+    }
+
+    return merged;
+  },
+};

package/node_modules/@fses/workbench-card/src/renderers/chart/echarts-protocol/converters/scene3D.converter.ts

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview Scene3D 协议转换器 — 将 echarts-gl 3D 可视化数据转换为 ECharts option
+ * @author seadon
+ * @created 2026-05-05
+ */
+
+import type { EChartsOption } from 'echarts';
+
+import type {
+  ProtocolConfigPayload,
+  ProtocolConverter,
+  ProtocolDataPayload,
+  Scene3DDataPayload,
+} from '../types';
+
+/**
+ * Scene3D 协议转换器，处理三维场景可视化数据
+ * 将 dataset 中的通用属性展开为顶层 option 属性以支持 echarts-gl 的配置方式
+ */
+export const scene3DConverter: ProtocolConverter = {
+  /**
+   * 根据协议配置构建 3D 场景的 ECharts option 骨架
+   * @param config - 协议配置载荷
+   * @returns 包含空系列数据的 ECharts option
+   */
+  buildOption(config: ProtocolConfigPayload): EChartsOption {
+    const option: EChartsOption = {
+      // SeriesDef.type 为通用 string，需断言为 any 以满足 ECharts SeriesOption 字面量联合类型
+      series: config.series.map((def) => ({
+        id: def.id,
+        type: def.type,
+        data: [],
+      })) as any[],
+    };
+
+    if (config.optionPatch) {
+      Object.assign(option, config.optionPatch);
+    }
+
+    return option;
+  },
+
+  /**
+   * 将 3D 场景数据合并到已有的 ECharts option 中
+   * dataset 中除 id/shape 外的属性会展开为顶层 option 属性
+   * @param option - 已有的 ECharts option
+   * @param data - 协议数据载荷，包含 3D 场景数据
+   * @returns 更新后的 ECharts option
+   */
+  mergeData(option: EChartsOption, data: ProtocolDataPayload): EChartsOption {
+    const sceneData = data as Scene3DDataPayload;
+    const merged = { ...option };
+    const dataset = sceneData.dataset;
+
+    // 设置系列数据，优先使用 data，其次 points，最后 rows
+    const dataField = (dataset as Record<string, unknown>).data
+      || (dataset as Record<string, unknown>).points
+      || (dataset as Record<string, unknown>).rows;
+
+    if (Array.isArray(merged.series)) {
+      merged.series = merged.series.map((s) => ({
+        ...(s as Record<string, unknown>),
+        data: dataField,
+      }));
+    }
+
+    // 将 dataset 中除 id/shape 外的属性展开为顶层 option 属性
+    const { id: _id, shape: _shape, ...rest } = dataset;
+    Object.assign(merged, rest);
+
+    return merged;
+  },
+};