@fses/workbench-app 0.1.0

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillCardTypes.d.ts

@@ -0,0 +1,514 @@
+/**
+ * @fileoverview FDE Skill 卡片类型 - 定义独立图卡运行时协议
+ * @author seadon
+ * @created 2026-06-27
+ */
+import type { FdeSkillTimeRangeDefaultPreset } from './fdeSkillTimeRangeDefault';
+export type FdeSkillCardKind = 'chart' | 'number' | 'query' | 'header' | 'list';
+export type FdeSkillChartType = 'bar' | 'line' | 'area' | 'grouped_bar' | 'stacked_bar' | 'percent_stacked_bar' | 'stacked_area' | 'horizontal_bar' | 'waterfall_bar' | 'mixed_line_bar' | 'dual_axis' | 'pie' | 'donut' | 'rose_pie' | 'funnel' | 'scatter' | 'bubble' | 'heatmap' | 'gauge';
+export type FdeSkillDataRow = Record<string, unknown>;
+export type FdeSkillChartVariant = 'multi_line' | 'smooth_line' | 'step_line' | 'half_donut';
+export interface FdeSkillLinePresentation {
+    smooth?: boolean;
+    step?: 'start' | 'middle' | 'end';
+    show_symbol?: boolean;
+}
+export interface FdeSkillPiePresentation {
+    start_angle?: number;
+    end_angle?: number;
+    rose_type?: 'radius' | 'area';
+}
+export interface FdeSkillBarPresentation {
+    sort?: 'asc' | 'desc';
+    limit?: number;
+}
+export interface FdeSkillChartPresentation {
+    line?: FdeSkillLinePresentation;
+    pie?: FdeSkillPiePresentation;
+    bar?: FdeSkillBarPresentation;
+}
+export type FdeSkillEchartsProtocolType = 'series' | 'table' | 'tuple' | 'tree' | 'network' | 'geo' | 'scene3D' | 'timeline' | 'transition' | 'graphic' | 'layout' | 'composite' | 'configOnly';
+export interface FdeSkillChartPalette {
+    colors?: string[];
+    paletteId?: string;
+}
+export interface FdeSkillCardMeta {
+    id: string;
+    kind: FdeSkillCardKind;
+    title: string;
+    description?: string;
+}
+export interface FdeSkillCardChrome {
+    show_title?: boolean;
+    show_border?: boolean;
+    title_position?: 'top' | 'inside';
+}
+export interface FdeSkillExecuteRequest {
+    endpoint: string;
+    method: 'POST';
+    body: Record<string, unknown>;
+}
+export interface FdeSkillNormalization {
+    rows_path: 'value';
+    display_rows_path?: 'display_value';
+    total_path?: 'total';
+}
+export interface FdeSkillDimensionLookup {
+    target_mapping_field: string;
+    source_field: string;
+    display_field: string;
+    lookup_app_id?: string;
+    lookup_model_code?: string;
+    lookup_service_code: string;
+    lookup_key_field: string;
+    lookup_label_field: string;
+    execute_request: FdeSkillExecuteRequest;
+    normalization?: FdeSkillNormalization;
+}
+/** 筛选器控件类型（六种） */
+export type FdeSkillFilterControlType = 'text' | 'time_range' | 'select' | 'multi_select' | 'person' | 'department';
+/**
+ * 数据卡查询绑定：指向某筛选器控件，并声明业务过滤字段。
+ * 清单/服务数值灌入 query_criteria；协议图灌入 query_context.query_criteria。
+ */
+export interface FdeSkillQueryBinding {
+    /** 筛选器卡 / Filter 实例 ID */
+    source_card_id: string;
+    /** 控件键（内置 control_key / control.id） */
+    control_id: string;
+    type: FdeSkillFilterControlType;
+    /** 业务过滤字段；图表侧即 query_criteria.column_name */
+    field_code: string;
+    field_name?: string;
+    /** 等于 eq / in / time_range / like 等 */
+    operator: string;
+    /** 平台 query_type：0 等于、3 in、4 like、5 范围…；清单通道使用 */
+    query_type: number;
+    /** 清单/指标灌入路径；协议图可显式写 query_context.query_criteria */
+    query_path?: 'body.query.query_criteria' | 'body.query_criteria' | 'query_context.query_criteria';
+    value_format?: 'epoch_millis' | 'raw' | string;
+    field_type?: 'timestamp' | 'datetime' | string;
+    field_source?: 'svc_output' | 'svc_input' | 'metric_query_filter' | string;
+    data_code?: string;
+    operators?: string[];
+}
+/** @deprecated 兼容旧命名，等同 FdeSkillQueryBinding 且 type=time_range */
+export type FdeSkillTimeRangeQueryBinding = FdeSkillQueryBinding & {
+    type: 'time_range';
+    operator: 'time_range' | string;
+    query_type: 5 | number;
+};
+export interface FdeSkillServiceDataSource {
+    type: 'service';
+    app_id: string;
+    app_name?: string;
+    model_code: string;
+    model_name?: string;
+    service_code: string;
+    service_mode?: string;
+    service_op_mode?: string;
+    execute_request?: FdeSkillExecuteRequest;
+    normalization?: FdeSkillNormalization;
+    dimension_lookups?: FdeSkillDimensionLookup[];
+    query_bindings?: FdeSkillQueryBinding[];
+    refresh_policy?: {
+        on_mount?: boolean;
+        mode?: 'stale_while_revalidate';
+    };
+}
+export interface FdeSkillMetricDataSource {
+    type: 'metric';
+    app_id: string;
+    app_name?: string;
+    model_code?: string;
+    model_name?: string | null;
+    metric_id?: string;
+    metric_code?: string;
+    metric_name?: string;
+    /**
+     * 指标历史绑定的模型服务编码；指标查看明细已改为传 metric_code 进入 handleSvcForAi 指标分支。
+     * 取数仍走 chart/data（METRIC），不走该服务执行口。
+     */
+    service_code?: string;
+    /** @deprecated 已废弃；指标取数统一走 number.data_request / chart.data_request → chart/data */
+    metric_execute_request?: FdeSkillExecuteRequest;
+    query_bindings?: FdeSkillQueryBinding[];
+    refresh_policy?: {
+        on_mount?: boolean;
+        mode?: 'stale_while_revalidate';
+    };
+}
+export type FdeSkillDataSource = FdeSkillServiceDataSource | FdeSkillMetricDataSource;
+export interface FdeSkillChartMapping {
+    x_field?: string;
+    x_display_field?: string;
+    x_value_field?: string;
+    y_fields?: string[];
+    y_field?: string;
+    y_display_field?: string;
+    y_value_field?: string;
+    bar_fields?: string[];
+    line_fields?: string[];
+    left_y_fields?: string[];
+    right_y_fields?: string[];
+    series_field?: string;
+    series_display_field?: string;
+    series_chart_types?: Record<string, 'bar' | 'line'>;
+    value_field?: string;
+    delta_field?: string;
+    size_field?: string;
+    stack_name?: string;
+    category_field?: string;
+    category_display_field?: string;
+    sort?: 'asc' | 'desc';
+    limit?: number;
+    name_field?: string;
+    name_display_field?: string;
+    stage_field?: string;
+    stage_display_field?: string;
+    stage_order?: string[];
+    initial_value?: number;
+    total_label?: string;
+    left_unit?: string;
+    right_unit?: string;
+    unit?: string;
+    min?: number;
+    max?: number;
+}
+export interface FdeSkillDrilldownSpec {
+    enabled: boolean;
+    mode: 'service_execute_rows';
+    trigger: 'item' | 'card';
+    detail_service_code?: string;
+    page_size?: number;
+    dimension_query_type?: number;
+}
+export interface FdeSkillProtocolChartLinkageContext {
+    source_component_id: string;
+    trigger_field: string;
+    trigger_value: unknown;
+    trigger_label?: string;
+    series_name?: unknown;
+    data_index?: number;
+}
+export interface FdeSkillMetricStorageValue {
+    type: string;
+    value: unknown;
+}
+export interface FdeSkillMetricDimensionMeta {
+    dimension_code: string;
+    dimension_name?: string;
+    storage_type?: string;
+    display_mode?: string;
+    filter_operators?: string[];
+    group_supported?: boolean;
+    drilldown_supported?: boolean;
+    member_query_supported?: boolean;
+}
+export interface FdeSkillMetricDimensionValue {
+    display_value?: unknown;
+    raw_value?: unknown;
+    storage_value?: FdeSkillMetricStorageValue;
+}
+export interface FdeSkillMetricRowContext {
+    row_index?: number;
+    dimension_values?: Record<string, FdeSkillMetricDimensionValue>;
+}
+export interface FdeSkillMetricDrillPathRequestItem {
+    dimension_code: string;
+    storage_value: FdeSkillMetricStorageValue;
+}
+export interface FdeSkillMetricContext {
+    source_id?: string;
+    metric_id?: string;
+    metric_code?: string;
+    current_dimensions?: string[];
+    row_contexts?: FdeSkillMetricRowContext[];
+    supported_dimensions?: FdeSkillMetricDimensionMeta[];
+    remaining_drill_dimensions?: FdeSkillMetricDimensionMeta[];
+    result_page?: Record<string, unknown>;
+    semantic_contract_hash?: string;
+    query_context_signature?: string;
+    detail_enabled?: boolean;
+    detail_supported?: boolean;
+    detail_reason_code?: string;
+}
+export interface FdeSkillDrilldownCondition {
+    field: string;
+    value: unknown;
+    label?: string;
+    field_type?: string;
+}
+export interface FdeSkillDrilldownColumn {
+    key: string;
+    title: string;
+    dataIndex?: string;
+}
+export interface FdeSkillDrilldownContext {
+    card_id: string;
+    card_title: string;
+    chart_type?: FdeSkillChartType;
+    data_source_type: 'service' | 'metric';
+    app_id: string;
+    model_code?: string;
+    source_code: string;
+    conditions: FdeSkillDrilldownCondition[];
+    raw_item?: FdeSkillDataRow;
+}
+export interface FdeSkillDrilldownResult {
+    rows: FdeSkillDataRow[];
+    raw_rows: FdeSkillDataRow[];
+    columns: FdeSkillDrilldownColumn[];
+    total: number;
+}
+export interface FdeSkillProtocolChartDataRequest {
+    endpoint: string;
+    method: 'POST';
+    body: {
+        app_id: string;
+        page_id?: string;
+        component_id: string;
+        /** 排障用卡片标题，与 card.title 一致；不参与取数逻辑 */
+        card_name?: string;
+        chart_id: string;
+        protocol_type: FdeSkillEchartsProtocolType;
+        reload_token?: number;
+        query_context?: Record<string, unknown>;
+        data_config: {
+            data_sources: Array<Record<string, unknown>>;
+            binding: Record<string, unknown>;
+        };
+        options?: Record<string, unknown>;
+    };
+}
+export interface FdeSkillProtocolChartSpec {
+    renderer_type: 'echarts_protocol';
+    chart_id: string;
+    example_id?: string;
+    title_cn?: string;
+    title?: string;
+    protocol_type: FdeSkillEchartsProtocolType;
+    protocol_config: Record<string, unknown>;
+    protocol_data?: Record<string, unknown>;
+    data_request: FdeSkillProtocolChartDataRequest;
+    diagnostics?: Record<string, unknown>;
+    render_precheck?: Record<string, unknown>;
+}
+export interface FdeSkillLegacyChartSpec {
+    type: FdeSkillChartType;
+    variant?: FdeSkillChartVariant;
+    presentation?: FdeSkillChartPresentation;
+    color?: string[];
+    palette?: string[] | FdeSkillChartPalette;
+    mapping: FdeSkillChartMapping;
+    rows: FdeSkillDataRow[];
+    echarts_option?: Record<string, unknown>;
+}
+export type FdeSkillChartSpec = FdeSkillLegacyChartSpec | FdeSkillProtocolChartSpec;
+export type FdeSkillNumberFormat = 'number' | 'currency' | 'percent';
+export type FdeSkillNumberTemplate = 'large-amount' | 'header-kpi';
+export interface FdeSkillNumberSpec {
+    value_field?: string;
+    value: number | string;
+    unit?: string;
+    precision?: number;
+    format?: FdeSkillNumberFormat;
+    template?: FdeSkillNumberTemplate;
+    display?: FdeSkillNumberDisplaySpec;
+    style?: {
+        color?: string;
+    };
+    /** 指标数值卡运行态请求（chart/data）；服务数值卡不使用 */
+    data_request?: FdeSkillProtocolChartDataRequest;
+    /**
+     * 指标数值卡最近一次 chart/data 返回的 protocol_data。
+     * 用于保留 extension.metric_context（含 detail_enabled / detail_supported），支撑查看明细。
+     */
+    protocol_data?: Record<string, unknown>;
+}
+export interface FdeSkillHeaderMetaItem {
+    label: string;
+    value: string;
+}
+export type FdeSkillHeaderTemplate = 'dashboard-summary' | 'dashboard-cockpit';
+export type FdeSkillHeaderKpiVariant = 'stat-chip' | 'digit-box' | 'segment-progress';
+export interface FdeSkillHeaderKpiItem {
+    label: string;
+    value: string | number;
+    variant?: FdeSkillHeaderKpiVariant;
+    suffix?: string;
+    prefix?: string;
+    max?: number;
+}
+export interface FdeSkillHeaderSpec {
+    template: FdeSkillHeaderTemplate;
+    layout?: 'title-center-kpi-row';
+    meta?: FdeSkillHeaderMetaItem[];
+    kpis?: FdeSkillHeaderKpiItem[];
+}
+export interface FdeSkillNumberDisplaySpec {
+    variant?: FdeSkillHeaderKpiVariant;
+    zone?: 'header' | 'body';
+}
+export interface FdeSkillListColumn {
+    field: string;
+    title: string;
+    width?: number;
+}
+export interface FdeSkillListSummaryBadge {
+    label: string;
+    value_source: 'total';
+}
+/**
+ * 动态清单（自动滚动）展示配置。
+ * 凡 `list.marquee.enabled=true` 的清单卡（模板页 / 卡片流 / 大屏）均消费，不按画布类型分流。
+ */
+export interface FdeSkillListMarqueeSpec {
+    enabled: boolean;
+    /** 滚动速度，像素/秒；默认 42 */
+    speed_px_per_sec?: number;
+    /** 鼠标移入是否暂停；默认 true */
+    pause_on_hover?: boolean;
+    /** 单次最多展示行数；默认 20，硬上限 50 */
+    max_rows?: number;
+    /** 最多展示列数；默认 4，硬上限 6 */
+    max_columns?: number;
+}
+export interface FdeSkillListSpec {
+    rows: FdeSkillDataRow[];
+    columns: FdeSkillListColumn[];
+    total: number;
+    page_index: number;
+    page_size: number;
+    row_key_field?: string;
+    summary_badge?: FdeSkillListSummaryBadge;
+    /** 动态清单滚动配置；enabled 时统一走滚动清单渲染 */
+    marquee?: FdeSkillListMarqueeSpec;
+}
+/** 下拉/人员/部门选项项 */
+export interface FdeSkillFilterOptionItem {
+    label: string;
+    value: string | number;
+}
+/** 筛选器选项来源 */
+export interface FdeSkillFilterOptionsSource {
+    source: 'none' | 'manual' | 'service' | 'person' | 'department';
+    manual_options?: FdeSkillFilterOptionItem[];
+    /** 查多服务拉选项（人员/部门同此） */
+    service?: {
+        app_id: string;
+        svc_code: string;
+        value_field: string;
+        label_field: string;
+        /** 选项集自身过滤，写入 handleSvcForAi.query.query_criteria */
+        query_criteria?: Array<{
+            column_name: string;
+            query_type: number;
+            value: unknown[];
+        }>;
+    };
+}
+export interface FdeSkillQueryControlSpec {
+    id: string;
+    type: FdeSkillFilterControlType;
+    label: string;
+    /** 时间控件格式；非时间可省略 */
+    format?: 'YYYY-MM-DD HH:mm:ss' | string;
+    show_time?: boolean;
+    placeholder?: string | [string, string];
+    default_value?: unknown;
+    /**
+     * 时间范围默认预设：相对按打开时 now 重算；绝对配合 default_value。
+     */
+    default_preset?: FdeSkillTimeRangeDefaultPreset | null;
+    options?: FdeSkillFilterOptionsSource | null;
+}
+export interface FdeSkillQuerySpec {
+    /** 主类型；多控件时可与 controls[].type 一致或为聚合标记 */
+    type: FdeSkillFilterControlType;
+    layout: 'top_full_row' | string;
+    controls: FdeSkillQueryControlSpec[];
+    /** 单卡自带按钮（旧）；页面级 FilterBar 共用按钮时可不写 */
+    actions?: {
+        submit_text?: string;
+        reset_text?: string;
+    };
+}
+/**
+ * 页面级筛选条：多筛选器 + 共用查询/重置。
+ */
+export interface FdeSkillPageFilterBar {
+    id: string;
+    filters: Array<{
+        id: string;
+        name: string;
+        type: FdeSkillFilterControlType;
+        control_key: string;
+        default_value?: unknown;
+        default_preset?: FdeSkillQueryControlSpec['default_preset'];
+        options?: FdeSkillFilterOptionsSource | null;
+        format?: string;
+        show_time?: boolean;
+        placeholder?: string | [string, string];
+    }>;
+    actions?: {
+        submit_text?: string;
+        reset_text?: string;
+    };
+}
+export interface FdeSkillSourcePatch {
+    target_project: 'release/web-workbench';
+    container_selector: '.fde-contain';
+    mode: 'insert' | 'update';
+    target_file?: string;
+    target_runtime?: 'fde-skill-runtime';
+}
+export interface FdeSkillChartCardIntent<TChart extends FdeSkillChartSpec = FdeSkillChartSpec, TDataSource extends FdeSkillDataSource = FdeSkillDataSource> {
+    version: '1.0';
+    card: FdeSkillCardMeta & {
+        kind: 'chart';
+    };
+    data_source: TDataSource;
+    drilldown?: FdeSkillDrilldownSpec;
+    chart: TChart;
+    chrome?: FdeSkillCardChrome;
+    source_patch: FdeSkillSourcePatch;
+}
+export type FdeSkillLegacyChartCardIntent = FdeSkillChartCardIntent<FdeSkillLegacyChartSpec, FdeSkillServiceDataSource>;
+export interface FdeSkillNumberCardIntent {
+    version: '1.0';
+    card: FdeSkillCardMeta & {
+        kind: 'number';
+    };
+    data_source: FdeSkillDataSource;
+    number: FdeSkillNumberSpec;
+    chrome?: FdeSkillCardChrome;
+    source_patch: FdeSkillSourcePatch;
+}
+export interface FdeSkillQueryCardIntent {
+    version: '1.0';
+    card: FdeSkillCardMeta & {
+        kind: 'query';
+    };
+    query: FdeSkillQuerySpec;
+    source_patch: FdeSkillSourcePatch;
+}
+export interface FdeSkillHeaderCardIntent {
+    version: '1.0';
+    card: FdeSkillCardMeta & {
+        kind: 'header';
+    };
+    header: FdeSkillHeaderSpec;
+    source_patch: FdeSkillSourcePatch;
+}
+export interface FdeSkillListCardIntent {
+    version: '1.0';
+    card: FdeSkillCardMeta & {
+        kind: 'list';
+    };
+    data_source: FdeSkillServiceDataSource;
+    list: FdeSkillListSpec;
+    chrome?: FdeSkillCardChrome;
+    source_patch: FdeSkillSourcePatch;
+}
+export type FdeSkillCardIntent = FdeSkillHeaderCardIntent | FdeSkillChartCardIntent<FdeSkillChartSpec, FdeSkillDataSource> | FdeSkillNumberCardIntent | FdeSkillQueryCardIntent | FdeSkillListCardIntent;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillChartDataRequestMeta.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview FDE Skill chart/data 请求元数据 - 注入排障字段 card_name
+ * @author seadon
+ * @created 2026-07-14
+ */
+import type { FdeSkillProtocolChartDataRequest } from './fdeSkillCardTypes';
+/**
+ * 为 chart/data 请求体注入 card_name，便于 Network 与后端日志对照画布标题。
+ * @param request - 原始 data_request。
+ * @param cardName - 卡片标题（card.title）。
+ * @returns 注入后的请求副本；标题为空时不写入 card_name。
+ */
+export declare function applyCardNameToChartDataRequest(request: FdeSkillProtocolChartDataRequest, cardName: string | undefined): FdeSkillProtocolChartDataRequest;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillChartDensityFit.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @fileoverview FDE Skill 图表密度适配 - 按布局场景与类目数调整柱宽/轴标签/饼半径缺省
+ * @author seadon
+ * @created 2026-07-10
+ */
+/** 图表布局适配场景：卡片流细柱；模板 embed / 大屏放宽 */
+export type FdeSkillChartLayoutFit = 'card' | 'embed' | 'dashboard';
+/** 柱图密度缺省 */
+export interface FdeSkillBarDensityDefaults {
+    barWidth: string;
+    barMaxWidth: number;
+    barCategoryGap: string;
+}
+/**
+ * 统计图表类目数（优先 protocol_data，其次 optionPatch 轴 data）。
+ * @param input - 协议配置与数据。
+ * @returns 类目数，未知时为 0。
+ */
+export declare function countFdeSkillChartCategories(input: {
+    optionPatch?: Record<string, unknown> | null;
+    protocolData?: unknown;
+}): number;
+/**
+ * 按类目数与布局场景解析柱图密度缺省。
+ * 卡片流保持细柱；模板/大屏按类目数放宽，避免宽坑位里「三根细针」。
+ * @param categoryCount - 类目数；0 表示未知，embed/dashboard 走中档。
+ * @param layoutFit - 布局场景。
+ * @returns 柱宽缺省。
+ */
+export declare function resolveFdeSkillBarDensityDefaults(categoryCount: number, layoutFit?: FdeSkillChartLayoutFit): FdeSkillBarDensityDefaults;
+/**
+ * 是否应对类目轴启用防重叠标签策略。
+ * embed/dashboard：类目 ≥ 5 即启用（长中文类目在中等坑位也会挤）。
+ * @param categoryCount - 类目数。
+ * @param layoutFit - 布局场景。
+ * @returns 是否启用。
+ */
+export declare function shouldApplyDenseAxisLabelFit(categoryCount: number, layoutFit: FdeSkillChartLayoutFit): boolean;
+/**
+ * 解析模板 embed 场景的饼半径缩放（无 dashboard viewport 时使用）。
+ * @param layoutFit - 布局场景。
+ * @returns 缩放系数；card 返回 null 表示不缩放。
+ */
+export declare function resolveFdeSkillEmbedPieRadiusScale(layoutFit: FdeSkillChartLayoutFit): number | null;
+/**
+ * 将密度缺省合并进柱系列（仅填未显式指定的字段）。
+ * @param series - bar 系列。
+ * @param density - 密度缺省。
+ * @returns 合并后的系列。
+ */
+export declare function mergeBarDensityIntoSeries(series: Record<string, unknown>, density: FdeSkillBarDensityDefaults): Record<string, unknown>;
+/**
+ * embed/dashboard 下 containLabel 与过大数值 bottom 互斥：后者会在图下留空洞。
+ * 将 ≥40px 的 bottom 钳制为 3%（对齐瀑布图模板），已有百分比 bottom 不改。
+ * @param optionPatch - optionPatch。
+ * @param layoutFit - 布局场景。
+ * @returns 处理后的 optionPatch。
+ */
+export declare function normalizeEmbedContainLabelGrid(optionPatch: Record<string, unknown>, layoutFit: FdeSkillChartLayoutFit): Record<string, unknown>;
+/**
+ * 对 optionPatch 应用轴标签密度适配。
+ * @param optionPatch - ECharts optionPatch。
+ * @param categoryCount - 类目数。
+ * @param layoutFit - 布局场景。
+ * @returns 新的 optionPatch（可能为原引用的浅拷贝）。
+ */
+export declare function applyFdeSkillAxisDensityFitToOptionPatch(optionPatch: Record<string, unknown>, categoryCount: number, layoutFit: FdeSkillChartLayoutFit): Record<string, unknown>;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillChartOptions.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview FDE Skill 图卡选项 - 从协议 rows 和映射生成 ECharts 配置
+ * @author seadon
+ * @created 2026-06-27
+ */
+import type { FdeSkillLegacyChartCardIntent as FdeSkillChartCardIntent } from './fdeSkillCardTypes';
+import type { FdeSkillChartTheme } from './fdeSkillChartTheme';
+export type FdeSkillChartOption = Record<string, unknown>;
+/**
+ * 根据图卡协议生成 ECharts option。
+ * @param intent - 图卡协议。
+ * @returns ECharts option。
+ */
+export declare function buildFdeSkillChartOption(intent: FdeSkillChartCardIntent, theme?: FdeSkillChartTheme): FdeSkillChartOption;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillChartTheme.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview FDE Skill 图表主题 - 从工作台 CSS 变量读取 ECharts 颜色
+ * @author seadon
+ * @created 2026-07-03
+ */
+import { type FdeSkillChartLayoutFit } from './fdeSkillChartDensityFit';
+export type { FdeSkillChartLayoutFit } from './fdeSkillChartDensityFit';
+/** 主题合并可选参数：布局场景与类目数影响柱宽/轴标签密度 */
+export interface MergeFdeSkillChartThemeOptions {
+    layoutFit?: FdeSkillChartLayoutFit;
+    categoryCount?: number;
+    protocolData?: unknown;
+}
+export interface FdeSkillChartTheme {
+    colors: string[];
+    axisColor: string;
+    axisLabelColor: string;
+    splitLineColor: string;
+    legendTextColor: string;
+    tooltipBg: string;
+    tooltipTextColor: string;
+}
+export declare const DEFAULT_FDE_SKILL_CHART_THEME: FdeSkillChartTheme;
+/**
+ * 归一化图表主题，缺失字段时回退到默认主题。
+ * @param theme - 候选主题，可能不完整或误传 Ref。
+ * @param fallback - 兜底主题。
+ * @returns 可安全用于 ECharts 的主题配置。
+ */
+export declare function resolveFdeSkillChartTheme(theme?: Partial<FdeSkillChartTheme> | null, fallback?: FdeSkillChartTheme): FdeSkillChartTheme;
+/**
+ * 判断是否为单体维度柱图（单系列、非堆叠 bar）。
+ * 此类图占大区域时粗柱难看，需细柱 + 轻渐变样式。
+ * @param optionPatch - ECharts optionPatch。
+ * @returns 是否为单体柱图。
+ */
+export declare function isMonoDimensionBarOptionPatch(optionPatch: Record<string, unknown>): boolean;
+/**
+ * 从工作台根节点读取 FDE skill 图表主题。
+ * @param root - `.workbench-root` 根节点。
+ * @returns ECharts 可用主题配置。
+ */
+export declare function readFdeSkillChartTheme(root: HTMLElement | null | undefined): FdeSkillChartTheme;
+/**
+ * 将工作台主题合并到 ECharts protocol config。
+ * @param config - 后端或 generated 中的协议 config。
+ * @param theme - 当前工作台图表主题。
+ * @param options - 布局密度选项（embed/dashboard 放宽柱宽）。
+ * @returns 可交给 EChartsProtocolRenderer 的新协议 config。
+ */
+export declare function mergeFdeSkillChartThemeIntoProtocolConfig<T extends object>(config: T, theme?: FdeSkillChartTheme, options?: MergeFdeSkillChartThemeOptions): T;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillDashboardContext.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview FDE Skill 大屏上下文 - 提供全局主题与报告元信息
+ * @author seadon
+ * @created 2026-07-08
+ */
+import type { InjectionKey, Ref } from 'vue';
+import type { FdeSkillChartTheme } from './fdeSkillChartTheme';
+import type { FdeSkillHeaderSpec } from './fdeSkillCardTypes';
+import type { FdeSkillDashboardManifest, FdeSkillDashboardThemePreset } from './fdeSkillDashboardTypes';
+import type { FdeSkillDashboardViewportTier } from './fdeSkillDashboardViewport';
+export interface FdeSkillDashboardContext {
+    themePreset: Ref<FdeSkillDashboardThemePreset>;
+    chartTheme: Ref<FdeSkillChartTheme>;
+    meta: FdeSkillDashboardManifest['meta'];
+    header?: FdeSkillHeaderSpec;
+    /** 视口密度档位：只影响栅格密度与图表展示，不改业务数据 */
+    viewportTier: Ref<FdeSkillDashboardViewportTier>;
+}
+export declare const FDE_SKILL_DASHBOARD_CONTEXT_KEY: InjectionKey<FdeSkillDashboardContext>;