@fses/workbench-app 0.1.3 → 0.2.1

package/node_modules/@fses/workbench-card/dist/registry/echartsTemplateTypes.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview ECharts 系统卡片模板类型 - 定义官方示例模板最小运行时元数据。
+ * @author seadon
+ * @created 2026-06-22
+ */
+import type { BlockSubType, BlockType } from '../types/block';
+import type { CardSizePreset } from '../types/canvas';
+import type { ProtocolType } from '../types/echartsProtocol';
+export type EChartsTemplateDependencyKind = 'echartsGl' | 'bmap' | 'jquery' | 'd3' | 'ecStat' | 'datGui';
+export type EChartsTemplateAssetKind = 'json' | 'geojson' | 'svg' | 'image' | 'binary' | 'script' | 'style';
+export type EChartsTemplateStatus = 'implemented' | 'placeholder';
+export type EChartsTemplateAvailabilitySource = 'staticData' | 'sourceReplay' | 'externalAssets' | 'unknown';
+export interface EChartsMainCategoryDefinition {
+    id: string;
+    name: string;
+    categoryId: string;
+    description: string;
+    officialKeys: string[];
+    seriesTypeKeys: string[];
+    protocolFallbacks: ProtocolType[];
+}
+export interface EChartsTemplateRequires {
+    echartsGl?: boolean;
+    bmap?: boolean;
+    externalAssets?: boolean;
+    timer?: boolean;
+    event?: boolean;
+}
+export interface EChartsTemplateAvailability {
+    insertable: boolean;
+    source: EChartsTemplateAvailabilitySource;
+    dataPointCount: number;
+    reason?: string;
+}
+export interface EChartsTemplateMetadata {
+    exampleId: string;
+    mainCategory: string;
+    tags: string[];
+    protocolType: ProtocolType;
+    seriesTypes: string[];
+    requires: EChartsTemplateRequires;
+    configPath: string;
+    dataPath?: string;
+    iconPath?: string;
+    availability?: EChartsTemplateAvailability;
+}
+export interface EChartsSystemCardTemplateEntry {
+    capabilityId: string;
+    category: string;
+    type: string;
+    title: string;
+    description: string;
+    blockType: BlockType;
+    subType: BlockSubType | string;
+    rendererKey: string;
+    dataShape: string;
+    shell: 'card';
+    styleVariants: string[];
+    defaultSize: CardSizePreset;
+    handlerClassName: 'EChartsExampleTemplateCardAbility';
+    status: EChartsTemplateStatus;
+    echarts: EChartsTemplateMetadata;
+}
+export interface EChartsTemplateDeployManifestEntry {
+    exampleId: string;
+    assetRefs: Array<{
+        kind: EChartsTemplateAssetKind;
+        originalUrl?: string;
+        publicPath: string;
+    }>;
+    dependencyRefs: Array<{
+        kind: EChartsTemplateDependencyKind;
+        loaderKey: string;
+        required: boolean;
+    }>;
+}

package/node_modules/@fses/workbench-card/dist/registry/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview workbench-card registry entry - exports card capability registry APIs.
+ * @author seadon
+ * @created 2026-05-20
+ */
+export * from './cardRegistry';
+export * from './compositeCardPatterns';
+export * from './echartsTemplateCategories';
+export * from './echartsTemplateRegistry';
+export * from './echartsTemplateTypes';

package/node_modules/@fses/workbench-card/dist/renderers/WorkbenchBlockRenderer.vue.d.ts

@@ -0,0 +1,55 @@
+import type { WorkbenchEchartClickParams } from './chart/useEchart';
+import type { WorkbenchRendererHostBridge } from './hostBridge';
+import type { MaterializedBlock, RoleId } from '../types';
+type __VLS_Props = {
+    block: MaterializedBlock;
+    roleId?: RoleId | string;
+    userId?: string;
+    density?: 'thumbnail' | 'compact' | 'standard' | 'expanded';
+    hostBridge?: WorkbenchRendererHostBridge;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    chartClick: (payload: WorkbenchEchartClickParams & {
+        blockId: string;
+        block: MaterializedBlock;
+    }) => any;
+    replaceManualPlaceholder: (payload: {
+        block: MaterializedBlock;
+        overrideCapabilityId?: string;
+    }) => any;
+    focusBlock: (blockId: string) => any;
+    focusNestedBlock: (payload: {
+        parentId: string;
+        childId: string;
+    }) => any;
+    submitForm: (blockId: string, values: Record<string, unknown>) => any;
+    submitSurvey: (blockId: string, answers: Record<string, unknown>) => any;
+    executeAction: (blockId: string, actionId: string, actionLabel: string) => any;
+    generateReport: (blockId: string) => any;
+    workbenchShowcaseTabChange: (tabId: string) => any;
+    runWorkbenchShortcut: (prompt: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onChartClick?: (payload: WorkbenchEchartClickParams & {
+        blockId: string;
+        block: MaterializedBlock;
+    }) => any;
+    onReplaceManualPlaceholder?: (payload: {
+        block: MaterializedBlock;
+        overrideCapabilityId?: string;
+    }) => any;
+    onFocusBlock?: (blockId: string) => any;
+    onFocusNestedBlock?: (payload: {
+        parentId: string;
+        childId: string;
+    }) => any;
+    onSubmitForm?: (blockId: string, values: Record<string, unknown>) => any;
+    onSubmitSurvey?: (blockId: string, answers: Record<string, unknown>) => any;
+    onExecuteAction?: (blockId: string, actionId: string, actionLabel: string) => any;
+    onGenerateReport?: (blockId: string) => any;
+    onWorkbenchShowcaseTabChange?: (tabId: string) => any;
+    onRunWorkbenchShortcut?: (prompt: string) => any;
+}>, {
+    density: "thumbnail" | "compact" | "standard" | "expanded";
+    hostBridge: WorkbenchRendererHostBridge;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/node_modules/@fses/workbench-card/dist/renderers/chart/ChartRegistry.vue.d.ts

@@ -0,0 +1,22 @@
+import type { DisplayBlockData, RoleId } from '@fses/workbench-card/types';
+import type { WorkbenchChartRefreshRuntime } from './types';
+import { type WorkbenchEchartClickParams } from './useEchart';
+type __VLS_Props = {
+    rendererKey: string;
+    data: DisplayBlockData;
+    cardTitle?: string;
+    roleId?: RoleId | string;
+    userId?: string;
+    density?: 'thumbnail' | 'compact' | 'standard' | 'expanded';
+    blockMeta?: Record<string, unknown>;
+    blockSource?: unknown;
+    refreshRuntime?: WorkbenchChartRefreshRuntime;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    chartClick: (payload: WorkbenchEchartClickParams) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onChartClick?: (payload: WorkbenchEchartClickParams) => any;
+}>, {
+    density: "thumbnail" | "compact" | "standard" | "expanded";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/node_modules/@fses/workbench-card/dist/renderers/chart/EChartsProtocolRenderer.vue.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview ECharts protocol renderer - converts protocol config/data
+ * into ECharts options and refreshes bound data through the workbench API.
+ * @author seadon
+ * @created 2026-05-05
+ */
+import type { RoleId } from '@fses/workbench-card/types';
+import type { ProtocolConfigPayload, ProtocolDataPayload } from './echarts-protocol/types';
+import type { WorkbenchChartRefreshRuntime } from './types';
+import { type WorkbenchEchartClickParams } from './useEchart';
+type __VLS_Props = {
+    configPayload: ProtocolConfigPayload;
+    dataPayload?: ProtocolDataPayload;
+    cardTitle?: string;
+    roleId?: RoleId | string;
+    userId?: string;
+    dataBinding?: {
+        id?: string;
+        bindingId?: string;
+        refreshApi?: string;
+        status?: string;
+        params?: Record<string, unknown>;
+        sourceType?: string;
+    };
+    blockMeta?: Record<string, unknown>;
+    blockSource?: unknown;
+    refreshRuntime?: WorkbenchChartRefreshRuntime;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    chartClick: (payload: WorkbenchEchartClickParams) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onChartClick?: (payload: WorkbenchEchartClickParams) => any;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/node_modules/@fses/workbench-card/dist/renderers/chart/chartRendererRegistry.d.ts

@@ -0,0 +1,219 @@
+/**
+ * @fileoverview Chart renderer registry - shared chart renderer keys, prompt labels, and intent detection helpers.
+ * @author seadon
+ * @created 2026-05-20
+ */
+import type { RoleId } from '../../types';
+export type ChartRendererKey = 'bar' | 'line' | 'mixedBarLine' | 'waterfall' | 'heatmap' | 'pie' | 'donut' | 'radar' | 'scatter' | 'bubble' | 'funnel' | 'gauge' | 'map' | 'sankey' | 'tree' | 'gantt' | 'candlestick' | 'kline' | 'boxplot' | 'area' | 'stackedBar' | 'pareto' | 'drilldownTree' | 'network' | 'geoGlobe';
+export interface ChartRendererDefinition {
+    key: ChartRendererKey;
+    title: string;
+    subtitle: string;
+    label: string;
+    aliases: string[];
+    defaultResourceKey: string | ((roleId: RoleId) => string);
+}
+export declare const CHART_RENDERER_DEFINITIONS: readonly [{
+    readonly key: "network";
+    readonly title: "网络关系图";
+    readonly subtitle: "适合展示节点关系、权限关系和影响链路。";
+    readonly label: "网络图";
+    readonly aliases: ["网络图", "关系网络", "network"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "drilldownTree";
+    readonly title: "层级下钻树图";
+    readonly subtitle: "适合表达层级拆解与后续下钻结构。";
+    readonly label: "下钻树图";
+    readonly aliases: ["下钻树图", "drilldownTree"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "pareto";
+    readonly title: "关键少数帕累托图";
+    readonly subtitle: "适合识别关键少数与累计占比。";
+    readonly label: "帕累托图";
+    readonly aliases: ["帕累托图", "pareto"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "stackedBar";
+    readonly title: "堆叠柱状图";
+    readonly subtitle: "适合同时查看构成叠加和总量对比。";
+    readonly label: "堆叠柱状图";
+    readonly aliases: ["堆叠柱状图", "堆叠柱形图", "stackedBar"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "area";
+    readonly title: "经营面积图";
+    readonly subtitle: "适合查看趋势累计和阶段面积变化。";
+    readonly label: "面积图";
+    readonly aliases: ["面积图", "area"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "boxplot";
+    readonly title: "经营分布箱线图";
+    readonly subtitle: "适合查看分布、离散和异常值。";
+    readonly label: "箱线图";
+    readonly aliases: ["箱线图", "boxplot"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "geoGlobe";
+    readonly title: "3D 地球经营卡";
+    readonly subtitle: "适合展示全球节点、飞线和跨区域状态。";
+    readonly label: "3D地球";
+    readonly aliases: ["3D地球", "地球卡", "geoGlobe"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "donut";
+    readonly title: "经营结构环形图";
+    readonly subtitle: "适合展示构成占比与中心核心指标。";
+    readonly label: "环形图";
+    readonly aliases: ["环形图", "donut"];
+    readonly defaultResourceKey: "sales.region_mix";
+}, {
+    readonly key: "pie";
+    readonly title: "经营结构饼图";
+    readonly subtitle: "适合快速判断经营贡献与构成占比。";
+    readonly label: "饼图";
+    readonly aliases: ["饼图", "pie"];
+    readonly defaultResourceKey: "sales.region_mix";
+}, {
+    readonly key: "radar";
+    readonly title: "多维能力雷达图";
+    readonly subtitle: "适合横向比较收入、效率、风险等多个维度。";
+    readonly label: "雷达图";
+    readonly aliases: ["雷达图", "radar"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "bubble";
+    readonly title: "经营分布气泡图";
+    readonly subtitle: "同时呈现两个指标和影响规模。";
+    readonly label: "气泡图";
+    readonly aliases: ["气泡图", "bubble"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "scatter";
+    readonly title: "经营分布散点图";
+    readonly subtitle: "适合识别投入产出分布和离群点。";
+    readonly label: "散点图";
+    readonly aliases: ["散点图", "scatter"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "funnel";
+    readonly title: "流程漏斗图";
+    readonly subtitle: "适合展示从入口到闭环的转化效率。";
+    readonly label: "漏斗图";
+    readonly aliases: ["漏斗图", "funnel"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "gauge";
+    readonly title: "经营健康度仪表盘";
+    readonly subtitle: "适合表达单一核心状态的当前水位。";
+    readonly label: "仪表盘";
+    readonly aliases: ["仪表盘", "gauge"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "map";
+    readonly title: "区域经营地图";
+    readonly subtitle: "适合展示区域贡献与风险热区分布。";
+    readonly label: "地图";
+    readonly aliases: ["地图", "map"];
+    readonly defaultResourceKey: "sales.region_map";
+}, {
+    readonly key: "sankey";
+    readonly title: "经营流向桑基图";
+    readonly subtitle: "适合展示经营来源到结果项之间的流向关系。";
+    readonly label: "桑基图";
+    readonly aliases: ["桑基图", "sankey"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "tree";
+    readonly title: "经营拆解树图";
+    readonly subtitle: "适合展示主题、责任域与下钻层级。";
+    readonly label: "树图";
+    readonly aliases: ["树图", "tree"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "gantt";
+    readonly title: "任务排期甘特图";
+    readonly subtitle: "适合展示跨团队任务时间安排与风险节点。";
+    readonly label: "甘特图";
+    readonly aliases: ["甘特图", "gantt"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "kline";
+    readonly title: "经营指数 K 线图";
+    readonly subtitle: "适合展示开高低收与波动趋势。";
+    readonly label: "K线图";
+    readonly aliases: ["K线图", "k线图", "kline", "candlestick"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "candlestick";
+    readonly title: "经营指数 K 线图";
+    readonly subtitle: "适合展示开高低收与波动趋势。";
+    readonly label: "K线图";
+    readonly aliases: ["candlestick"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "heatmap";
+    readonly title: "经营热力图";
+    readonly subtitle: "适合展示风险、质量或密度分布。";
+    readonly label: "热力图";
+    readonly aliases: ["热力图", "heatmap"];
+    readonly defaultResourceKey: (roleId: RoleId) => string;
+}, {
+    readonly key: "waterfall";
+    readonly title: "经营差异瀑布图";
+    readonly subtitle: "适合展示预算、偏差与实际的桥接关系。";
+    readonly label: "瀑布图";
+    readonly aliases: ["瀑布图", "waterfall"];
+    readonly defaultResourceKey: "finance.cashflow_trend";
+}, {
+    readonly key: "mixedBarLine";
+    readonly title: "经营混合趋势图";
+    readonly subtitle: "适合同时对比趋势与规模。";
+    readonly label: "混合图";
+    readonly aliases: ["混合图", "组合图", "柱线图", "mixed", "mixedbarline"];
+    readonly defaultResourceKey: "sales.trend";
+}, {
+    readonly key: "line";
+    readonly title: "经营折线图";
+    readonly subtitle: "适合观察时间趋势与波动。";
+    readonly label: "折线图";
+    readonly aliases: ["折线图", "line"];
+    readonly defaultResourceKey: "sales.trend";
+}, {
+    readonly key: "bar";
+    readonly title: "经营柱状图";
+    readonly subtitle: "适合比较各阶段或各区域的规模差异。";
+    readonly label: "柱状图";
+    readonly aliases: ["柱状图", "柱形图", "bar"];
+    readonly defaultResourceKey: "sales.trend";
+}];
+export declare const CHART_RENDERER_KEYS: ("tree" | "network" | "bar" | "line" | "geoGlobe" | "donut" | "pie" | "scatter" | "map" | "candlestick" | "radar" | "boxplot" | "heatmap" | "sankey" | "funnel" | "gauge" | "mixedBarLine" | "waterfall" | "bubble" | "gantt" | "kline" | "area" | "stackedBar" | "pareto" | "drilldownTree")[];
+export declare const CHART_RENDERER_PROMPT_KEYS: string;
+export declare const CHART_RENDERER_PROMPT_LABELS: string;
+/**
+ * Normalizes legacy chart renderer aliases to the keys used by option builders.
+ * @param value - Renderer key from card registry, snapshot data, or planner output.
+ * @returns Normalized chart renderer key.
+ */
+export declare function normalizeChartRendererKey(value: string): ChartRendererKey | string;
+/**
+ * Resolves the default data resource key for a chart renderer definition.
+ * @param definition - Chart renderer definition.
+ * @param roleId - Current workbench role id.
+ * @returns Resource key used by chart demos and planner defaults.
+ */
+export declare function resolveChartResourceKey(definition: ChartRendererDefinition, roleId: RoleId): string;
+/**
+ * Detects an explicitly requested chart renderer from free-form user text.
+ * @param text - User prompt or route text.
+ * @param roleId - Current workbench role id.
+ * @returns Detected renderer metadata, or null when the text does not name a chart renderer.
+ */
+export declare function detectChartRenderer(text: string, roleId: RoleId): {
+    rendererKey: "tree" | "network" | "bar" | "line" | "geoGlobe" | "donut" | "pie" | "scatter" | "map" | "candlestick" | "radar" | "boxplot" | "heatmap" | "sankey" | "funnel" | "gauge" | "mixedBarLine" | "waterfall" | "bubble" | "gantt" | "kline" | "area" | "stackedBar" | "pareto" | "drilldownTree";
+    title: string;
+    subtitle: "适合展示节点关系、权限关系和影响链路。" | "适合表达层级拆解与后续下钻结构。" | "适合识别关键少数与累计占比。" | "适合同时查看构成叠加和总量对比。" | "适合查看趋势累计和阶段面积变化。" | "适合查看分布、离散和异常值。" | "适合展示全球节点、飞线和跨区域状态。" | "适合展示构成占比与中心核心指标。" | "适合快速判断经营贡献与构成占比。" | "适合横向比较收入、效率、风险等多个维度。" | "同时呈现两个指标和影响规模。" | "适合识别投入产出分布和离群点。" | "适合展示从入口到闭环的转化效率。" | "适合表达单一核心状态的当前水位。" | "适合展示区域贡献与风险热区分布。" | "适合展示经营来源到结果项之间的流向关系。" | "适合展示主题、责任域与下钻层级。" | "适合展示跨团队任务时间安排与风险节点。" | "适合展示开高低收与波动趋势。" | "适合展示风险、质量或密度分布。" | "适合展示预算、偏差与实际的桥接关系。" | "适合同时对比趋势与规模。" | "适合观察时间趋势与波动。" | "适合比较各阶段或各区域的规模差异。";
+    resourceKey: string;
+};

package/node_modules/@fses/workbench-card/dist/renderers/chart/chartResponsiveLayout.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview 图表自适应布局工具 - 根据数据规模调整卡片内 ECharts 标签、图例和绘图区。
+ * @author seadon
+ * @created 2026-06-18
+ */
+type CartesianResponsiveLayout = {
+    grid: {
+        left: number;
+        right: number;
+        top: number;
+        bottom: number;
+        containLabel: boolean;
+    };
+    xAxis: {
+        axisLabel: Record<string, unknown>;
+    };
+    legend: Record<string, unknown>;
+};
+type PieResponsiveLayout = {
+    legend: Record<string, unknown>;
+    series: {
+        center: [string, string];
+        label: Record<string, unknown>;
+        labelLine: Record<string, unknown>;
+        labelLayout: Record<string, unknown>;
+        minShowLabelAngle?: number;
+    };
+};
+type PieLayoutSlice = {
+    label?: unknown;
+    name?: unknown;
+    value?: unknown;
+};
+/**
+ * 构建柱状图、折线图等类目轴图表的卡片自适应布局。
+ * @param categories - x 轴类目集合。
+ * @param seriesCount - 当前图表的系列数量。
+ * @returns 可合并进 ECharts option 的 grid 和 xAxis.axisLabel 配置。
+ */
+export declare function buildCartesianResponsiveLayout(categories: readonly unknown[], seriesCount?: number): CartesianResponsiveLayout;
+/**
+ * 构建饼图、环形图的卡片自适应布局。
+ * @param slices - 饼图切片数据，兼容 label 和 name 字段。
+ * @returns 可合并进 ECharts option 的 legend 和 series 展示配置。
+ */
+export declare function buildPieResponsiveLayout(slices: readonly PieLayoutSlice[]): PieResponsiveLayout;
+export {};

package/node_modules/@fses/workbench-card/dist/renderers/chart/dynamicEchartOption.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Dynamic ECharts option helpers - fills an ECharts option template from refreshed row data.
+ * @author seadon
+ * @created 2026-05-20
+ */
+import type { EChartsOption } from 'echarts';
+export interface DynamicEchartRowsPayload {
+    rows: Array<Record<string, unknown>>;
+    fieldMapping: {
+        xField?: unknown;
+        yFields?: unknown;
+    };
+}
+export interface DynamicEchartFieldMapping {
+    xField?: string;
+    yFields: string[];
+}
+/**
+ * Normalizes dynamic field mapping metadata into typed chart fields.
+ * @param fieldMapping - Raw binding field mapping.
+ * @returns Normalized x/y field mapping.
+ */
+export declare function normalizeDynamicEchartFieldMapping(fieldMapping: unknown): DynamicEchartFieldMapping;
+/**
+ * Builds a concrete ECharts option from a template and refreshed rows.
+ * @param optionTemplate - ECharts option template from the workbench card.
+ * @param payload - Refreshed row data plus field mapping.
+ * @returns Concrete ECharts option ready for rendering.
+ */
+export declare function buildDynamicEchartOption(optionTemplate: unknown, payload: DynamicEchartRowsPayload): EChartsOption;

package/node_modules/@fses/workbench-card/dist/renderers/chart/echarts-protocol/adapter.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview ECharts 协议适配器 — 将协议配置和数据载荷转换为 ECharts option 的主入口类
+ * @author seadon
+ * @created 2026-05-05
+ */
+import type { EChartsOption } from 'echarts';
+import type { ProtocolConfigPayload, ProtocolDataPayload } from './types';
+/**
+ * ECharts 协议适配器 — 管理协议配置和数据的生命周期，
+ * 将协议载荷转换为 ECharts option 实例。
+ */
+export declare class EChartsProtocolAdapter {
+    /** 当前已生成的 ECharts option */
+    private currentOption;
+    /** 当前保存的协议配置 */
+    private config;
+    /**
+     * 设置协议配置并生成初始 ECharts option。
+     * 若转换器构建 option 失败，会尝试回退到 config 中的 optionPatch。
+     *
+     * @param config - 协议配置载荷，定义图表的骨架结构
+     * @returns 生成的 ECharts option
+     * @throws 当转换器未找到或构建失败且无 optionPatch 可回退时抛出异常
+     */
+    setConfig(config: ProtocolConfigPayload): EChartsOption;
+    /**
+     * 将数据载荷合并到当前 ECharts option 中。
+     * 必须先调用 setConfig 设置配置，否则无法合并数据。
+     * 若合并过程出错，会安全地返回当前未修改的 option。
+     *
+     * @param data - 协议数据载荷，包含图表展示所需的实际数据
+     * @returns 更新后的 ECharts option；若未设置配置或合并失败则返回当前 option
+     */
+    setData(data: ProtocolDataPayload): EChartsOption;
+    /**
+     * 获取当前 ECharts option。
+     *
+     * @returns 当前的 ECharts option，若尚未设置配置则返回 null
+     */
+    getOption(): EChartsOption | null;
+    /**
+     * 重置适配器状态，清空配置和 option。
+     */
+    reset(): void;
+    /**
+     * 根据协议类型从映射表中查找对应的转换器。
+     *
+     * @param protocolType - 协议类型标识
+     * @returns 对应的协议转换器实例
+     * @throws 当协议类型未注册时抛出错误
+     */
+    private resolveConverter;
+    /**
+     * 移除配置中的 optionPatch，让各协议转换器只负责生成基础 option。
+     * @param config - 原始协议配置
+     * @returns 不含 optionPatch 的协议配置
+     */
+    private configWithoutOptionPatch;
+    /**
+     * 将当前配置中的 optionPatch 深合并到 ECharts option。
+     * @param option - 转换器生成或刷新数据后的基础 option
+     * @returns 合并用户展示补丁后的 ECharts option
+     */
+    private applyOptionPatch;
+    /**
+     * 对最终 ECharts option 上的 dataZoom 做一次兜底归一化，覆盖模板 optionPatch 之外的
+     * dataZoom 来源（AI 注入、converter 内联、用户改卡等），保证运行时全量数据默认可见。
+     * @param option - 已合并的最终 ECharts option
+     * @param data - 协议数据载荷，用于判定是否存在真实运行时数据
+     * @returns dataZoom 已被归一化为 start:0,end:100 的 option
+     */
+    private normalizeRuntimeDataZoom;
+}

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

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Composite 协议转换器 — 将多图表组合数据转换为 ECharts option
+ * @author seadon
+ * @created 2026-05-05
+ */
+import type { ProtocolConverter } from '../types';
+/**
+ * Composite 协议转换器，处理混合/多图表组合配置
+ * 支持在同一画布上组合多种图表类型
+ */
+export declare const compositeConverter: ProtocolConverter;

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

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview ConfigOnly 协议转换器 — 纯配置图表转换器，不涉及外部数据
+ * @author seadon
+ * @created 2026-05-05
+ */
+import type { ProtocolConverter } from '../types';
+/**
+ * ConfigOnly 协议转换器，适用于所有数据已内嵌在配置中的图表
+ * buildOption 直接使用 optionPatch 构建 option，mergeData 为空操作
+ */
+export declare const configOnlyConverter: ProtocolConverter;

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

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Geo 协议转换器 — 将地理数据转换为 ECharts option
+ * @author seadon
+ * @created 2026-05-05
+ */
+import type { ProtocolConverter } from '../types';
+/**
+ * Geo 协议转换器，处理地图可视化数据（区域着色、散点叠加、连线叠加）
+ */
+export declare const geoConverter: ProtocolConverter;

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

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Graphic 协议转换器 — 将自定义图形元素数据转换为 ECharts option
+ * @author seadon
+ * @created 2026-05-05
+ */
+import type { ProtocolConverter } from '../types';
+/**
+ * Graphic 协议转换器，处理自定义图形元素（文本、图片、形状等）
+ */
+export declare const graphicConverter: ProtocolConverter;

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

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Layout 协议转换器 — 将网格/仪表板布局描述转换为 ECharts option
+ * @author seadon
+ * @created 2026-05-05
+ */
+import type { ProtocolConverter } from '../types';
+/**
+ * Layout 协议转换器，处理多网格布局的仪表板配置
+ * buildOption 直接使用 optionPatch 作为完整 option
+ */
+export declare const layoutConverter: ProtocolConverter;

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

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Network 协议转换器 — 将关系图/网络数据转换为 ECharts option
+ * @author seadon
+ * @created 2026-05-05
+ */
+import type { ProtocolConverter } from '../types';
+/**
+ * Network 协议转换器，处理节点和边的关系图数据
+ */
+export declare const networkConverter: ProtocolConverter;

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

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Scene3D 协议转换器 — 将 echarts-gl 3D 可视化数据转换为 ECharts option
+ * @author seadon
+ * @created 2026-05-05
+ */
+import type { ProtocolConverter } from '../types';
+/**
+ * Scene3D 协议转换器，处理三维场景可视化数据
+ * 将 dataset 中的通用属性展开为顶层 option 属性以支持 echarts-gl 的配置方式
+ */
+export declare const scene3DConverter: ProtocolConverter;