@fses/workbench-app 0.1.0

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

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview FDE Skill 大屏下钻适配 - 将 dashboard chart/number widget 转为明细可请求意图
+ * @author seadon
+ * @created 2026-07-09
+ */
+import type { FdeSkillNumberCardIntent } from './fdeSkillCardTypes';
+import type { FdeSkillDashboardWidget } from './fdeSkillDashboardTypes';
+import { type FdeSkillProtocolChartCardIntent } from './fdeSkillProtocolChart';
+/**
+ * 将大屏图表 widget 适配为协议图卡意图，供下钻解析与明细请求复用。
+ * 服务型或指标型 + echarts_protocol 可适配。
+ * @param widget - 大屏图表组件。
+ * @returns 图卡意图；不可下钻时为 null。
+ */
+export declare function adaptFdeSkillDashboardChartWidgetToCardIntent(widget: FdeSkillDashboardWidget): FdeSkillProtocolChartCardIntent | null;
+/**
+ * 将大屏数值 widget 适配为指标数值卡意图，供查看明细请求复用。
+ * @param widget - 大屏数值组件。
+ * @returns 数值卡意图；非指标数值卡时为 null。
+ */
+export declare function adaptFdeSkillDashboardNumberWidgetToCardIntent(widget: FdeSkillDashboardWidget): FdeSkillNumberCardIntent | null;

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

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview FDE Skill 大屏 KPI 工具 - 解析头部与数值卡 KPI 展示数据
+ * @author seadon
+ * @created 2026-07-09
+ */
+import type { FdeSkillHeaderKpiItem, FdeSkillHeaderKpiVariant } from './fdeSkillCardTypes';
+/**
+ * 归一化 KPI 展示变体。
+ * @param variant - 原始变体值。
+ * @returns 合法变体。
+ */
+export declare function resolveFdeSkillHeaderKpiVariant(variant?: string): FdeSkillHeaderKpiVariant;
+/**
+ * 将 KPI 数值格式化为展示文本。
+ * @param value - KPI 原始值。
+ * @returns 展示文本。
+ */
+export declare function formatFdeSkillHeaderKpiValue(value: string | number): string;
+/**
+ * 将 KPI 数值拆分为逐字符数组，供翻牌数字格使用。
+ * @param value - KPI 原始值。
+ * @returns 字符数组。
+ */
+export declare function splitFdeSkillHeaderKpiDigits(value: string | number): string[];
+/**
+ * 计算分段进度条的填充比例。
+ * @param item - KPI 配置项。
+ * @returns 0~1 的填充比例。
+ */
+export declare function resolveFdeSkillHeaderKpiProgress(item: FdeSkillHeaderKpiItem): number;
+/**
+ * 归一化 KPI 列表，补齐默认变体。
+ * @param kpis - 原始 KPI 列表。
+ * @returns 归一化后的 KPI 列表。
+ */
+export declare function normalizeFdeSkillHeaderKpis(kpis: FdeSkillHeaderKpiItem[] | undefined): FdeSkillHeaderKpiItem[];

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

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview FDE Skill 大屏布局工具 - 计算栅格坐标与容器尺寸
+ * @author seadon
+ * @created 2026-07-08
+ */
+import type { CSSProperties } from 'vue';
+import type { FdeSkillDashboardLayoutSpec, FdeSkillDashboardManifest, FdeSkillDashboardWidget } from './fdeSkillDashboardTypes';
+/**
+ * 深拷贝大屏协议，避免运行态污染 generated 源数据。
+ * @param dashboard - generated 大屏协议。
+ * @returns 可变副本。
+ */
+export declare function cloneFdeSkillDashboard(dashboard: FdeSkillDashboardManifest): FdeSkillDashboardManifest;
+/**
+ * 计算大屏内容最小高度。
+ * @param widgets - 大屏组件列表。
+ * @param layout - 布局配置。
+ * @returns 最小高度像素值。
+ */
+export declare function resolveFdeSkillDashboardMinHeight(widgets: readonly FdeSkillDashboardWidget[], layout: FdeSkillDashboardLayoutSpec): number;
+/**
+ * 生成单个 widget 的 grid 样式。
+ * @param widget - 大屏组件。
+ * @returns CSS grid 定位样式。
+ */
+export declare function resolveFdeSkillDashboardWidgetStyle(widget: FdeSkillDashboardWidget): CSSProperties;
+/**
+ * 生成大屏栅格容器样式。
+ * @param layout - 布局配置。
+ * @param widgets - 组件列表。
+ * @returns CSS grid 容器样式。
+ */
+export declare function resolveFdeSkillDashboardGridStyle(layout: FdeSkillDashboardLayoutSpec, widgets: readonly FdeSkillDashboardWidget[]): CSSProperties;
+/**
+ * 判断 widget 是否为数据组件。
+ * @param widget - 大屏组件。
+ * @returns 是否需要刷新数据。
+ */
+export declare function isFdeSkillDashboardDataWidget(widget: FdeSkillDashboardWidget): boolean;

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

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview FDE Skill 大屏刷新 - 按 widget 刷新图表、数值和清单数据
+ * @author seadon
+ * @created 2026-07-08
+ */
+import type { FdeSkillRefreshOptions, FdeSkillRefreshQueryContext, FdeSkillRefreshState } from './fdeSkillDataRefresh';
+import type { FdeSkillDashboardWidget } from './fdeSkillDashboardTypes';
+/**
+ * 刷新单个大屏 widget。
+ * @param widget - 待刷新组件。
+ * @param signal - 请求中止信号。
+ * @param queryContext - 查询上下文。
+ * @returns 刷新后的组件。
+ */
+export declare function refreshFdeSkillDashboardWidget(widget: FdeSkillDashboardWidget, signal?: AbortSignal, queryContext?: FdeSkillRefreshQueryContext, options?: FdeSkillRefreshOptions): Promise<FdeSkillDashboardWidget>;
+/**
+ * 刷新大屏全部可执行 widget。
+ * @param widgets - 组件列表。
+ * @param states - 刷新状态表。
+ * @param signal - 请求中止信号。
+ * @param queryContext - 查询上下文。
+ * @returns 刷新后的组件列表。
+ */
+export declare function refreshFdeSkillDashboardWidgets(widgets: FdeSkillDashboardWidget[], states: Record<string, FdeSkillRefreshState>, signal?: AbortSignal, queryContext?: FdeSkillRefreshQueryContext): Promise<FdeSkillDashboardWidget[]>;

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

@@ -0,0 +1,108 @@
+/**
+ * @fileoverview FDE Skill 大屏主题 - 从四套工作台主题派生大屏 token 与图表配色
+ * @author seadon
+ * @created 2026-07-08
+ */
+import type { WorkbenchStyleKey } from '@workbench-internal/lib/workbenchThemes';
+import { type WorkbenchEChartsTheme } from '@workbench-internal/themes/workbenchThemeDefinitions';
+import type { FdeSkillChartTheme } from './fdeSkillChartTheme';
+import type { FdeSkillDashboardThemePreset } from './fdeSkillDashboardTypes';
+export interface FdeSkillDashboardThemeTokens {
+    '--fde-dash-bg': string;
+    '--fde-dash-surface': string;
+    '--fde-dash-border': string;
+    '--fde-dash-panel-border': string;
+    '--fde-dash-title': string;
+    '--fde-dash-text': string;
+    '--fde-dash-muted-text': string;
+    '--fde-dash-accent': string;
+    '--fde-dash-accent-soft': string;
+    '--fde-dash-header-bg': string;
+    '--fde-dash-header-text': string;
+    '--fde-dash-header-muted-text': string;
+    '--fde-dash-header-meta-bg': string;
+    '--fde-dash-header-meta-border': string;
+    '--fde-dash-cockpit-border': string;
+    '--fde-dash-cockpit-accent': string;
+    '--fde-dash-kpi-bg': string;
+    '--fde-dash-kpi-border': string;
+    '--fde-dash-kpi-value': string;
+    '--fde-dash-kpi-digit-bg': string;
+    '--fde-dash-kpi-digit-border': string;
+    '--fde-dash-kpi-digit-text': string;
+    '--fde-dash-kpi-segment-idle': string;
+    '--fde-dash-kpi-segment-active': string;
+    '--fde-dash-shadow': string;
+    '--fde-dash-chart-palette': string;
+}
+/**
+ * 解析工作台 CSS token 文本为键值表。
+ * @param code - `--wb-*` CSS 变量文本。
+ * @returns token 键值表。
+ */
+export declare function parseWorkbenchCssTokens(code: string): Record<string, string>;
+/**
+ * 判断工作台主题是否为深色大屏风格。
+ * @param style - 工作台主题 key。
+ * @returns 是否深色主题。
+ */
+export declare function isDarkWorkbenchDashboardStyle(style: WorkbenchStyleKey): boolean;
+/**
+ * 将工作台 ECharts 主题转为 FDE 图表主题。
+ * @param theme - 工作台 ECharts 主题。
+ * @returns FDE 图表主题。
+ */
+export declare function toFdeSkillChartTheme(theme: WorkbenchEChartsTheme): FdeSkillChartTheme;
+/**
+ * 从四套工作台主题派生大屏 token，保证卡片/文字/图表色与工作台一致。
+ * @param style - 工作台主题 key。
+ * @param overrides - 协议级覆盖项。
+ * @returns 大屏 CSS token。
+ */
+export declare function resolveFdeSkillDashboardTokensFromWorkbenchStyle(style: WorkbenchStyleKey, overrides?: Record<string, string>): FdeSkillDashboardThemeTokens;
+/**
+ * 将工作台主题映射到 manifest 预设（仅用于兼容 generated 协议字段）。
+ * @param style - 工作台主题 key。
+ * @returns 大屏主题预设。
+ */
+export declare function mapWorkbenchStyleToDashboardPreset(style: WorkbenchStyleKey): FdeSkillDashboardThemePreset;
+/**
+ * 从工作台主题读取图表配色。
+ * @param style - 工作台主题 key。
+ * @returns 图表主题配置。
+ */
+export declare function resolveFdeSkillDashboardChartThemeFromWorkbenchStyle(style: WorkbenchStyleKey): FdeSkillChartTheme;
+/**
+ * @deprecated 仅保留给旧代码兼容，请改用 resolveFdeSkillDashboardChartThemeFromWorkbenchStyle。
+ */
+export declare function resolveFdeSkillDashboardChartTheme(preset: FdeSkillDashboardThemePreset): FdeSkillChartTheme;
+/**
+ * @param root - 大屏根节点。
+ * @param style - 工作台主题 key。
+ * @param overrides - 协议级覆盖。
+ * @returns 无返回值。
+ */
+export declare function applyFdeSkillDashboardWorkbenchTheme(root: HTMLElement | null | undefined, style: WorkbenchStyleKey, overrides?: Record<string, string>): void;
+/**
+ * @deprecated 请改用 applyFdeSkillDashboardWorkbenchTheme。
+ */
+export declare function applyFdeSkillDashboardTheme(root: HTMLElement | null | undefined, preset: FdeSkillDashboardThemePreset, overrides?: Record<string, string>): void;
+export declare const FDE_SKILL_DASHBOARD_THEME_HOST_CLASS = "fde-dashboard-theme-host";
+/**
+ * 将大屏主题同步到工作台外层容器，保证边距与问数区背景一致。
+ * @param shell - 大屏外壳节点。
+ * @param style - 工作台主题 key。
+ * @param overrides - 协议级覆盖。
+ * @returns 无返回值。
+ */
+export declare function applyFdeSkillDashboardWorkbenchThemeToAncestors(shell: HTMLElement | null | undefined, style: WorkbenchStyleKey, overrides?: Record<string, string>): void;
+/**
+ * @deprecated 请改用 applyFdeSkillDashboardWorkbenchThemeToAncestors。
+ */
+export declare function applyFdeSkillDashboardThemeToWorkbenchAncestors(shell: HTMLElement | null | undefined, preset: FdeSkillDashboardThemePreset, overrides?: Record<string, string>): void;
+/**
+ * 清理工作台外层容器上的大屏主题内联样式。
+ * @param shell - 大屏外壳节点。
+ * @returns 无返回值。
+ */
+export declare function clearFdeSkillDashboardThemeFromWorkbenchAncestors(shell: HTMLElement | null | undefined): void;

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

@@ -0,0 +1,87 @@
+/**
+ * @fileoverview FDE Skill 大屏报告类型 - 定义可视化大屏布局与组件协议
+ * @author seadon
+ * @created 2026-07-08
+ */
+import type { FdeSkillCardMeta, FdeSkillChartSpec, FdeSkillDataSource, FdeSkillHeaderKpiItem, FdeSkillHeaderSpec, FdeSkillListSpec, FdeSkillNumberSpec, FdeSkillPageFilterBar, FdeSkillQueryCardIntent, FdeSkillServiceDataSource } from './fdeSkillCardTypes';
+export type FdeSkillDashboardThemePreset = 'factory' | 'dark-blue' | 'dark-green' | 'light-report';
+export type FdeSkillDashboardWidgetKind = 'header-band' | 'header-kpi' | 'chart' | 'number' | 'list' | 'list-marquee' | 'text' | 'spacer';
+export interface FdeSkillDashboardLayoutRect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface FdeSkillDashboardLayoutSpec {
+    columns: number;
+    row_height: number;
+    gap: number;
+    min_height?: number;
+}
+export interface FdeSkillDashboardThemeSpec {
+    preset: FdeSkillDashboardThemePreset;
+    overrides?: Record<string, string>;
+}
+export interface FdeSkillDashboardWidgetChrome {
+    show_title?: boolean;
+    show_border?: boolean;
+    title_position?: 'top' | 'inside';
+}
+export interface FdeSkillDashboardWidget {
+    id: string;
+    kind: FdeSkillDashboardWidgetKind;
+    layout: FdeSkillDashboardLayoutRect;
+    card?: FdeSkillCardMeta;
+    chart?: FdeSkillChartSpec;
+    number?: FdeSkillNumberSpec;
+    list?: FdeSkillListSpec;
+    data_source?: FdeSkillDataSource;
+    header?: FdeSkillHeaderSpec;
+    kpi?: FdeSkillHeaderKpiItem;
+    text?: {
+        content: string;
+    };
+    chrome?: FdeSkillDashboardWidgetChrome;
+}
+export interface FdeSkillDashboardSourcePatch {
+    target_project: 'release/web-workbench';
+    container_selector: '.fde-contain';
+    mode: 'insert' | 'update';
+    target_file?: string;
+    target_runtime: 'fde-skill-dashboard-runtime';
+}
+export interface FdeSkillDashboardManifest {
+    version: '1.0';
+    meta: {
+        id: string;
+        title: string;
+        description?: string;
+        generated_at?: string;
+    };
+    layout: FdeSkillDashboardLayoutSpec;
+    theme: FdeSkillDashboardThemeSpec;
+    header?: FdeSkillHeaderSpec;
+    widgets: FdeSkillDashboardWidget[];
+    /** 旧版单查询卡（如全局时间）；优先使用 queries */
+    query?: FdeSkillQueryCardIntent;
+    /** 页面级多筛选器查询卡（与看板报告同源） */
+    queries?: FdeSkillQueryCardIntent[];
+    /** 页面级筛选条；Host 可与 queries 互转 */
+    filter_bar?: FdeSkillPageFilterBar | null;
+    source_patch: FdeSkillDashboardSourcePatch;
+}
+export type FdeSkillDashboardListWidget = FdeSkillDashboardWidget & {
+    kind: 'list' | 'list-marquee';
+    list: FdeSkillListSpec;
+    data_source: FdeSkillServiceDataSource;
+};
+export type FdeSkillDashboardChartWidget = FdeSkillDashboardWidget & {
+    kind: 'chart';
+    chart: FdeSkillChartSpec;
+    data_source: FdeSkillDataSource;
+};
+export type FdeSkillDashboardNumberWidget = FdeSkillDashboardWidget & {
+    kind: 'number';
+    number: FdeSkillNumberSpec;
+    data_source: FdeSkillDataSource;
+};

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

@@ -0,0 +1,71 @@
+/**
+ * @fileoverview FDE Skill 大屏视口分档 - 按容器宽度调整栅格密度与清单可读宽度（不改业务数据）
+ * @author seadon
+ * @created 2026-07-09
+ */
+import type { FdeSkillDashboardLayoutSpec, FdeSkillDashboardWidget } from './fdeSkillDashboardTypes';
+/** 大屏视口密度档位 */
+export type FdeSkillDashboardViewportTier = 'large' | 'laptop' | 'compact';
+/** 大屏档：≥1600px，保持生成布局密度 */
+export declare const FDE_SKILL_DASHBOARD_VIEWPORT_LARGE_MIN = 1600;
+/** 笔记本档：≥1200px */
+export declare const FDE_SKILL_DASHBOARD_VIEWPORT_LAPTOP_MIN = 1200;
+/**
+ * 根据容器宽度解析视口档位。
+ * @param widthPx - 大屏外壳或栅格容器宽度。
+ * @returns large / laptop / compact。
+ */
+export declare function resolveFdeSkillDashboardViewportTier(widthPx: number): FdeSkillDashboardViewportTier;
+/**
+ * 按视口档位解析有效栅格参数（只改 row_height / gap，不改 columns 与业务坐标语义）。
+ * @param layout - 协议布局。
+ * @param tier - 视口档位。
+ * @returns 用于渲染的布局副本。
+ */
+export declare function resolveFdeSkillDashboardLayoutForViewport(layout: FdeSkillDashboardLayoutSpec, tier: FdeSkillDashboardViewportTier): FdeSkillDashboardLayoutSpec;
+/**
+ * 按清单列数解析偏好栅格宽（保底可读）。
+ * @param columnCount - 列数。
+ * @param tier - 视口档位。
+ * @returns 6 / 8 / 12。
+ */
+export declare function resolveFdeSkillDashboardListPreferredWidth(columnCount: number, tier: FdeSkillDashboardViewportTier): 6 | 8 | 12;
+/**
+ * 笔记本/窄屏下为清单卡保底加宽：只向「紧邻右侧」邻居借宽，并同步右移邻居。
+ * 不改 widget id、数据源、图表协议；large 档原样返回副本。
+ * @param widgets - 原 widgets。
+ * @param tier - 视口档位。
+ * @returns 调整后的 widgets 副本。
+ */
+export declare function adaptFdeSkillDashboardWidgetsForViewport(widgets: readonly FdeSkillDashboardWidget[], tier: FdeSkillDashboardViewportTier): FdeSkillDashboardWidget[];
+/** 大屏饼图缺省外半径（协议未写 radius 时，避免走 ECharts 默认偏大） */
+export declare const FDE_SKILL_DASHBOARD_DEFAULT_PIE_RADIUS = "55%";
+/** 大屏环图缺省内外半径 */
+export declare const FDE_SKILL_DASHBOARD_DEFAULT_DOUGHNUT_RADIUS: [string, string];
+/**
+ * 解析饼/环半径缩放（各档整体略缩，避免贴边撑满）。
+ * @param tier - 视口档位。
+ * @returns 半径缩放系数。
+ */
+export declare function resolveFdeSkillDashboardPieRadiusScale(tier: FdeSkillDashboardViewportTier): number;
+/**
+ * 按 chart_id 解析大屏饼/环缺省 radius。
+ * @param chartId - 协议 chart_id。
+ * @returns 缺省 radius。
+ */
+export declare function resolveFdeSkillDashboardDefaultPieRadius(chartId?: string): string | [string, string];
+/**
+ * 按缩放系数调整饼/环 radius（支持 number / 百分比字符串 / 数组）。
+ * @param radius - 原始 radius。
+ * @param scale - 缩放系数。
+ * @returns 缩放后的 radius。
+ */
+export declare function scaleFdeSkillPieRadius(radius: unknown, scale: number): unknown;
+/**
+ * 将视口饼图半径缩放应用到 optionPatch（只改展示，不改协议源数据）。
+ * @param optionPatch - ECharts optionPatch。
+ * @param scale - 半径缩放系数。
+ * @param chartId - 协议 chart_id；缺 radius 时用于补缺省。
+ * @returns 新的 optionPatch。
+ */
+export declare function applyFdeSkillPieRadiusScaleToOptionPatch(optionPatch: Record<string, unknown>, scale: number, chartId?: string): Record<string, unknown>;

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

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview FDE Skill 数据刷新 - 执行服务/chart-data 请求并更新图卡内存态
+ * @author seadon
+ * @created 2026-06-27
+ */
+import type { FdeSkillCardIntent, FdeSkillDataRow, FdeSkillLegacyChartCardIntent, FdeSkillProtocolChartDataRequest, FdeSkillProtocolChartLinkageContext } from './fdeSkillCardTypes';
+import { type FdeSkillQueryCriterion, type FdeSkillQueryValueMap } from './fdeSkillQueryFilters';
+export interface FdeSkillRefreshState {
+    loading: boolean;
+    error: string | null;
+}
+export interface FdeSkillRefreshQueryContext {
+    query_values?: FdeSkillQueryValueMap;
+    applied_query_criteria_by_card_id?: Record<string, FdeSkillQueryCriterion[]>;
+}
+export interface FdeSkillRefreshOptions {
+    page_index?: number;
+    page_size?: number;
+    protocol_linkage?: FdeSkillProtocolChartLinkageContext;
+    metric_request?: FdeSkillProtocolChartDataRequest;
+}
+/**
+ * 深拷贝协议对象，避免刷新过程污染 generated 源数据。
+ * @param cards - generated 协议数组。
+ * @returns 可变的本地协议数组。
+ */
+export declare function cloneFdeSkillCards(cards: readonly FdeSkillCardIntent[]): FdeSkillCardIntent[];
+/**
+ * 用 lookup 服务结果为主服务 rows 补充展示字段。
+ * @param rows - 主服务刷新后的原始 rows。
+ * @param card - 图卡协议。
+ * @param signal - 请求中止信号。
+ * @returns 补充展示字段后的 rows；lookup 失败时返回原 rows。
+ */
+export declare function enrichRowsWithDimensionLookups(rows: FdeSkillDataRow[], card: FdeSkillLegacyChartCardIntent, signal?: AbortSignal): Promise<FdeSkillDataRow[]>;
+/**
+ * 从 protocol_data 抽取指标数值卡主值。
+ * @param protocolData - chart/data 返回的协议数据。
+ * @param valueField - 可选对象字段名。
+ * @returns 主值；无法抽取时返回 undefined。
+ */
+export declare function extractNumberValueFromProtocolData(protocolData: Record<string, unknown>, valueField?: string): number | string | undefined;
+/**
+ * 刷新单张可执行卡片。
+ * @param card - 待刷新的卡片协议。
+ * @param signal - 请求中止信号。
+ * @param queryContext - 当前查询卡上下文。
+ * @param options - 分页刷新选项。
+ * @returns 刷新后的卡片协议。
+ */
+export declare function refreshFdeSkillCard(card: FdeSkillCardIntent, signal?: AbortSignal, queryContext?: FdeSkillRefreshQueryContext, options?: FdeSkillRefreshOptions): Promise<FdeSkillCardIntent>;
+/**
+ * 刷新卡片列表并保留输入顺序。
+ * @param cards - 本地卡片协议数组。
+ * @param states - 卡片状态表。
+ * @param signal - 请求中止信号。
+ * @returns 刷新后的卡片协议数组。
+ */
+export declare function refreshFdeSkillCards(cards: FdeSkillCardIntent[], states: Record<string, FdeSkillRefreshState>, signal?: AbortSignal, queryContext?: FdeSkillRefreshQueryContext): Promise<FdeSkillCardIntent[]>;

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

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview 兼容转发 - FDE 展示标签逻辑已迁移到 @fses/workbench-app。
+ * @author seadon
+ * @created 2026-08-12
+ */
+export * from '../../../../fde-runtime/runtime/fdeSkillDisplayLabel';

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

@@ -0,0 +1,100 @@
+/**
+ * @fileoverview FDE Skill 筛选条对外契约桥 - 向问数发布 catalog 与查询/重置事件
+ * @author seadon
+ * @created 2026-07-13
+ */
+import type { FdeSkillFilterControlType, FdeSkillQueryCardIntent } from './fdeSkillCardTypes';
+import { type FdeSkillFilterRuntimeValue, type FdeSkillQueryValueMap } from './fdeSkillQueryFilters';
+/** 契约版本，与问数关联筛选契约保持一致 */
+export declare const FDE_FILTER_BAR_CONTRACT_VERSION: "1.0";
+/** 对外筛选器清单项 */
+export interface FdeFilterCatalogItem {
+    id: string;
+    control_key: string;
+    name: string;
+    type: FdeSkillFilterControlType;
+}
+/** 对外筛选器清单 */
+export interface FdeFilterCatalog {
+    version: typeof FDE_FILTER_BAR_CONTRACT_VERSION;
+    filters: FdeFilterCatalogItem[];
+}
+/** 查询 / 重置事件载荷 */
+export interface FdeFilterBarEvent {
+    version: typeof FDE_FILTER_BAR_CONTRACT_VERSION;
+    action: 'submit' | 'reset';
+    values: Record<string, FdeSkillFilterRuntimeValue>;
+    filters: FdeFilterCatalogItem[];
+}
+/** 事件监听器 */
+export type FdeFilterBarListener = (event: FdeFilterBarEvent) => void;
+/** 取消订阅函数 */
+export type FdeFilterBarUnsubscribe = () => void;
+/**
+ * 解析对外稳定 filter id：单控件卡用 card.id，多控件卡用 cardId:controlId。
+ * @param cardId - 查询卡 ID。
+ * @param controlId - 控件 ID。
+ * @param controlCount - 该卡控件数量。
+ * @returns 契约 filter.id。
+ */
+export declare function resolveFdeFilterPublicId(cardId: string, controlId: string, controlCount: number): string;
+/**
+ * 从 Host 查询卡构建对外筛选清单。
+ * @param cards - FilterBar 使用的查询卡。
+ * @returns catalog。
+ */
+export declare function buildFdeFilterCatalogFromQueryCards(cards: ReadonlyArray<FdeSkillQueryCardIntent>): FdeFilterCatalog;
+/**
+ * 将内部 query_values（cardId:controlId）映射为契约 values（filter.id）。
+ * @param cards - 当前查询卡。
+ * @param queryValues - Host 内部筛选值。
+ * @returns 契约 values。
+ */
+export declare function mapFdeSkillQueryValuesToFilterBarValues(cards: ReadonlyArray<FdeSkillQueryCardIntent>, queryValues: FdeSkillQueryValueMap): Record<string, FdeSkillFilterRuntimeValue>;
+/**
+ * 读取当前筛选器清单。
+ * @returns catalog 快照。
+ */
+export declare function getFdeFilterCatalog(): FdeFilterCatalog;
+/**
+ * 更新当前筛选器清单（Host 挂载或筛选源变化时调用）。
+ * @param catalog - 新清单；传 null/空则清空。
+ * @returns 无返回值。
+ */
+export declare function setFdeFilterCatalog(catalog: FdeFilterCatalog | null | undefined): void;
+/**
+ * 根据查询卡同步 catalog。
+ * @param cards - Host 当前查询卡。
+ * @returns 写入后的 catalog。
+ */
+export declare function syncFdeFilterCatalogFromQueryCards(cards: ReadonlyArray<FdeSkillQueryCardIntent>): FdeFilterCatalog;
+/**
+ * 订阅筛选条查询/重置事件。
+ * @param listener - 回调。
+ * @returns 取消订阅函数。
+ */
+export declare function subscribeFdeFilterBar(listener: FdeFilterBarListener): FdeFilterBarUnsubscribe;
+/**
+ * 发布筛选条事件。
+ * @param event - 事件载荷。
+ * @returns 无返回值。
+ */
+export declare function publishFdeFilterBarEvent(event: FdeFilterBarEvent): void;
+/**
+ * 发布查询事件（用户点「查询」）。
+ * @param values - 契约 values（key = filter.id）。
+ * @param filters - 可选 catalog 快照；默认用当前清单。
+ * @returns 无返回值。
+ */
+export declare function publishFdeFilterBarSubmit(values: Record<string, FdeSkillFilterRuntimeValue>, filters?: FdeFilterCatalogItem[]): void;
+/**
+ * 发布重置事件（用户点「重置」）。
+ * @param filters - 可选 catalog 快照；默认用当前清单。
+ * @returns 无返回值。
+ */
+export declare function publishFdeFilterBarReset(filters?: FdeFilterCatalogItem[]): void;
+/**
+ * 测试用：清空 catalog 与监听器。
+ * @returns 无返回值。
+ */
+export declare function __resetFdeFilterBarBridgeForTest(): void;

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

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview 从 query 卡收集筛选默认值（时间范围按打开时 now 重算）
+ * @author seadon
+ * @created 2026-07-27
+ */
+import type { FdeSkillQueryCardIntent } from './fdeSkillCardTypes';
+import { type FdeSkillFilterRuntimeValue, type FdeSkillQueryValueMap } from './fdeSkillQueryFilters';
+/**
+ * 解析单个控件的运行态默认值。
+ * @param control - 控件规格。
+ * @param now - 相对时间锚点。
+ * @returns 运行态值；无默认返回 undefined。
+ */
+export declare function resolveFdeSkillControlDefaultValue(control: FdeSkillQueryCardIntent['query']['controls'][number], now?: Date): FdeSkillFilterRuntimeValue;
+/**
+ * 从查询卡列表收集默认筛选值映射。
+ * @param queryCards - 查询卡。
+ * @param now - 相对时间锚点。
+ * @returns valueKey → 默认值。
+ */
+export declare function collectFdeSkillDefaultQueryValues(queryCards: FdeSkillQueryCardIntent[], now?: Date): FdeSkillQueryValueMap;