@fses/workbench-app 0.2.17 → 0.2.20

package/dist/index-DkGYPLLJ.js

@@ -0,0 +1,34 @@
+const o = "workbench.drawer.open", s = "workbench.drawer.close", d = "workbench.diagnostics.drawer", t = "workbench.drawer.open", a = "workbench.drawer.close";
+function c(e) {
+  const r = e && typeof e == "object" ? e.drawerId : void 0;
+  if (typeof r != "string" || !r.trim())
+    throw new Error("WORKBENCH_DRAWER_ID_REQUIRED");
+  return r.trim();
+}
+function E() {
+  return {
+    id: "workbench.core.drawer-commands",
+    kernelApiVersion: 1,
+    setup(e) {
+      e.commands.register({
+        id: o,
+        execute: async (r) => {
+          const n = c(r);
+          return await e.events.emit(t, { drawerId: n }), { drawerId: n, opened: !0 };
+        }
+      }), e.commands.register({
+        id: s,
+        execute: async () => (await e.events.emit(a), { closed: !0 })
+      });
+    },
+    version: "1.0.0"
+  };
+}
+export {
+  o as W,
+  d as a,
+  s as b,
+  E as c,
+  a as d,
+  t as e
+};

package/dist/index.d.ts

@@ -29,8 +29,17 @@ export * from './runtime/data-binding/workbenchDataBindingRefreshPolicy';
 export * from './fde-runtime/runtime/fdeSkillDisplayLabel';
 export { createWorkbenchAppContext, WORKBENCH_APP_CONTEXT_KEY, useWorkbenchAppContext } from './runtime/context/workbenchAppContext';
 export type { WorkbenchAppContext, WorkbenchAppContextSource } from './runtime/context/workbenchAppContext';
+export { createWorkbenchHostContext } from './kernel/createWorkbenchHostContext';
+export type { CreateWorkbenchHostContextOptions, WorkbenchHostContext, WorkbenchHostDefinition, } from './kernel/createWorkbenchHostContext';
+export { WORKBENCH_HOST_CONTEXT_KEY, useWorkbenchHostContext } from './kernel/workbenchHostContext';
+export { createWorkbenchFeatureRoute } from './routing/createWorkbenchFeatureRoute';
+export type { CreateWorkbenchFeatureRouteOptions } from './routing/createWorkbenchFeatureRoute';
+export type { WorkbenchFeatureRouteResolution } from './routing/resolveWorkbenchFeatureRoute';
 export type { WorkbenchRuntimeFacade } from './runtime/store/workbenchRuntimeFacade';
-export { useWorkbenchRuntime, useWorkbenchRuntimeStore } from './runtime';
+export { createWorkbenchRuntimeStoreDefinition, useWorkbenchRuntime, useWorkbenchRuntimeStore, } from './runtime';
+export type { CreateWorkbenchRuntimeStoreDefinitionOptions } from './runtime';
+export { createWorkbenchRuntimeScope } from './runtime/scope/createWorkbenchRuntimeScope';
+export type { WorkbenchRuntimeScope } from './runtime/scope/createWorkbenchRuntimeScope';
 export { ensurePlatformUserSessionReady } from './internal/personal-workbench/lib/platformFetchClient';
 export { formatAmount } from './internal/personal-workbench/lib/formatters';
 export * from './internal/personal-workbench/lib/agentMemoryClient';

package/dist/internal/personal-workbench/components/workbench/WorkbenchCanvas.vue.d.ts

@@ -136,6 +136,8 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     requestRefreshConfigDraftBlock: typeof requestRefreshConfigDraftBlock;
     requestCardRenderedSize: typeof requestCardRenderedSize;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    insertSystemCard: (selection: SystemCardPromptSelection) => any;
+    insertCustomCard: (entry: WorkbenchCustomCardCatalogEntry) => any;
     focusBlock: (blockId: string) => any;
     metricDetail: (payload: WorkbenchMetricDetailPayload) => any;
     focusNestedBlock: (payload: {
@@ -150,8 +152,6 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     cardPresetSizeConfigChange: (config: WorkbenchCardPresetSizeConfig) => any;
     canvasGapPresetChange: (preset: WorkbenchCanvasGapPreset) => any;
     pasteCardPrompt: (selection: SystemCardPromptSelection) => any;
-    insertSystemCard: (selection: SystemCardPromptSelection) => any;
-    insertCustomCard: (entry: WorkbenchCustomCardCatalogEntry) => any;
     layoutChange: (layout: readonly LayoutChangeItem[]) => any;
     configModeChange: (active: boolean) => any;
     configDirtyChange: (dirty: boolean) => any;
@@ -192,6 +192,8 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     canvasNoticeAction: (actionId: string) => any;
     autoArrangeFeedback: (payload: AutoArrangeFeedbackPayload) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onInsertSystemCard?: (selection: SystemCardPromptSelection) => any;
+    onInsertCustomCard?: (entry: WorkbenchCustomCardCatalogEntry) => any;
     onFocusBlock?: (blockId: string) => any;
     onMetricDetail?: (payload: WorkbenchMetricDetailPayload) => any;
     onFocusNestedBlock?: (payload: {
@@ -206,8 +208,6 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     onCardPresetSizeConfigChange?: (config: WorkbenchCardPresetSizeConfig) => any;
     onCanvasGapPresetChange?: (preset: WorkbenchCanvasGapPreset) => any;
     onPasteCardPrompt?: (selection: SystemCardPromptSelection) => any;
-    onInsertSystemCard?: (selection: SystemCardPromptSelection) => any;
-    onInsertCustomCard?: (entry: WorkbenchCustomCardCatalogEntry) => any;
     onLayoutChange?: (layout: readonly LayoutChangeItem[]) => any;
     onConfigModeChange?: (active: boolean) => any;
     onConfigDirtyChange?: (dirty: boolean) => any;

package/dist/internal/personal-workbench/components/workbench/WorkbenchCanvasSettingsMenu.vue.d.ts

@@ -14,23 +14,23 @@ type __VLS_Props = {
     saving?: boolean;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    insertSystemCard: (selection: SystemCardPromptSelection) => any;
+    insertCustomCard: (entry: WorkbenchCustomCardCatalogEntry) => any;
     workbenchStyleChange: (style: WorkbenchStyleKey) => any;
     workbenchStyleCodeSave: (style: WorkbenchStyleKey, code: string) => any;
     cardStyleConfigChange: (config: WorkbenchCardStyleConfig) => any;
     cardPresetSizeConfigChange: (config: WorkbenchCardPresetSizeConfig) => any;
     canvasGapPresetChange: (preset: WorkbenchCanvasGapPreset) => any;
     pasteCardPrompt: (selection: SystemCardPromptSelection) => any;
-    insertSystemCard: (selection: SystemCardPromptSelection) => any;
-    insertCustomCard: (entry: WorkbenchCustomCardCatalogEntry) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onInsertSystemCard?: (selection: SystemCardPromptSelection) => any;
+    onInsertCustomCard?: (entry: WorkbenchCustomCardCatalogEntry) => any;
     onWorkbenchStyleChange?: (style: WorkbenchStyleKey) => any;
     onWorkbenchStyleCodeSave?: (style: WorkbenchStyleKey, code: string) => any;
     onCardStyleConfigChange?: (config: WorkbenchCardStyleConfig) => any;
     onCardPresetSizeConfigChange?: (config: WorkbenchCardPresetSizeConfig) => any;
     onCanvasGapPresetChange?: (preset: WorkbenchCanvasGapPreset) => any;
     onPasteCardPrompt?: (selection: SystemCardPromptSelection) => any;
-    onInsertSystemCard?: (selection: SystemCardPromptSelection) => any;
-    onInsertCustomCard?: (entry: WorkbenchCustomCardCatalogEntry) => any;
 }>, {
     cardStyleConfig: WorkbenchCardStyleConfig;
     cardPresetSizeConfig: WorkbenchCardPresetSizeConfig;

package/dist/internal/personal-workbench/components/workbench/WorkbenchFdeImageComposeDrawer.vue.d.ts

@@ -0,0 +1,19 @@
+type __VLS_Props = {
+    fileName?: string;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    close: () => any;
+    drawerElementChange: (element: HTMLElement) => any;
+    fileChange: (event: Event) => any;
+    fileInputElementChange: (element: HTMLInputElement) => any;
+    focusout: (event: FocusEvent) => any;
+    triggerUpload: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: () => any;
+    onDrawerElementChange?: (element: HTMLElement) => any;
+    onFileChange?: (event: Event) => any;
+    onFileInputElementChange?: (element: HTMLInputElement) => any;
+    onFocusout?: (event: FocusEvent) => any;
+    onTriggerUpload?: () => any;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/internal/personal-workbench/components/workbench/WorkbenchFdeToolbar.vue.d.ts

@@ -0,0 +1,36 @@
+import type { WorkbenchFdeVersionOption } from '../../controllers/workbenchFdeVersionController';
+type FdeToolbarTool = 'imageCompose' | 'cardCenter';
+type __VLS_Props = {
+    activeTool: '' | 'imageCompose';
+    busy: boolean;
+    cardCenterActive: boolean;
+    contextReady: boolean;
+    dirty: boolean;
+    fallbackName?: string;
+    resourceName?: string;
+    versionLabel: string;
+    versionMenuOpen: boolean;
+    versions: WorkbenchFdeVersionOption[];
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    restoreVersion: (versionNo: string | number) => any;
+    save: () => any;
+    saveAs: () => any;
+    toolClick: (tool: FdeToolbarTool, event: MouseEvent) => any;
+    toolPointerDown: (tool: FdeToolbarTool) => any;
+    toolsElementChange: (element: HTMLElement) => any;
+    versionMenuElementChange: (element: HTMLElement) => any;
+    versionMenuFocusout: (event: FocusEvent) => any;
+    versionMenuOpenChange: (open: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onRestoreVersion?: (versionNo: string | number) => any;
+    onSave?: () => any;
+    onSaveAs?: () => any;
+    onToolClick?: (tool: FdeToolbarTool, event: MouseEvent) => any;
+    onToolPointerDown?: (tool: FdeToolbarTool) => any;
+    onToolsElementChange?: (element: HTMLElement) => any;
+    onVersionMenuElementChange?: (element: HTMLElement) => any;
+    onVersionMenuFocusout?: (event: FocusEvent) => any;
+    onVersionMenuOpenChange?: (open: boolean) => any;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/internal/personal-workbench/components/workbench/WorkbenchStudio.vue.d.ts

@@ -1,12 +1,13 @@
 import { type WorkbenchCardStyleConfig } from "@workbench-internal/lib/cardStyleConfig";
 import { type WorkbenchChatHistoryMessage } from "@workbench-internal/lib/workbenchChatHistory";
+import type { RestoredConversationTurn } from "@workbench-internal/lib/vueRuntimeAdapters";
 import { type MetricWorkbenchCardSpec } from "@workbench-internal/lib/aiMetricCardSpec";
 import { type WorkbenchCanvasGapPreset, type WorkbenchCardPresetSizeConfig } from "@workbench-internal/lib/cardSizeConfig";
 import { type WorkbenchActionPayload } from "@workbench-internal/lib/workbenchApi";
 import type { WorkbenchStyleCodeMap, WorkbenchStyleKey } from "@workbench-internal/lib/workbenchThemes";
 import type { SystemCardPromptSelection, SystemCardWorkbenchPromptParams } from "@workbench-internal/lib/workbenchSystemCardPrompt";
 import type { CardRecommendationChooseFeedback, CardRecommendationItem, ChatAttachment, FsesAiChatQuickEntry } from "@fses/workbench-app/types";
-import type { AssistantPersonaKey, ConversationGroupSummary, ConversationTurn, LayoutConfig, WorkbenchIntentChannel, WorkbenchTemplate } from '@fses/workbench-app/types';
+import type { AssistantPersonaKey, ConversationGroupSummary, LayoutConfig, WorkbenchIntentChannel, WorkbenchTemplate } from '@fses/workbench-app/types';
 import type { BusinessGroupContext } from "@fses/workbench-app/types";
 import type { ChartCardSpec } from "@fses/workbench-app/types";
 type UploadedChatAttachmentPayload = {
@@ -35,7 +36,7 @@ type __VLS_Props = {
     input: string;
     planning: boolean;
     saving: boolean;
-    turns: ConversationTurn[];
+    turns: RestoredConversationTurn[];
     activeTurnId?: string | null;
     activeConversationId?: string;
     conversations?: ConversationGroupSummary[];
@@ -117,13 +118,13 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
     openWorkbenchHistory: typeof openWorkbenchHistory;
     openWorkbenchSettings: typeof openWorkbenchSettings;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    insertSystemCard: (selection: SystemCardPromptSelection) => any;
     workbenchStyleChange: (style: WorkbenchStyleKey) => any;
     workbenchStyleCodeSave: (style: WorkbenchStyleKey, code: string) => any;
     cardStyleConfigChange: (config: WorkbenchCardStyleConfig) => any;
     cardPresetSizeConfigChange: (config: WorkbenchCardPresetSizeConfig) => any;
     canvasGapPresetChange: (preset: WorkbenchCanvasGapPreset) => any;
     pasteCardPrompt: (selection: SystemCardPromptSelection) => any;
-    insertSystemCard: (selection: SystemCardPromptSelection) => any;
     inputChange: (value: string) => any;
     send: (payload?: WorkbenchChatSendPayload) => any;
     stop: (turnId?: string) => any;
@@ -186,13 +187,13 @@ declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
     }) => any;
     clearSelectedPatchTarget: () => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onInsertSystemCard?: (selection: SystemCardPromptSelection) => any;
     onWorkbenchStyleChange?: (style: WorkbenchStyleKey) => any;
     onWorkbenchStyleCodeSave?: (style: WorkbenchStyleKey, code: string) => any;
     onCardStyleConfigChange?: (config: WorkbenchCardStyleConfig) => any;
     onCardPresetSizeConfigChange?: (config: WorkbenchCardPresetSizeConfig) => any;
     onCanvasGapPresetChange?: (preset: WorkbenchCanvasGapPreset) => any;
     onPasteCardPrompt?: (selection: SystemCardPromptSelection) => any;
-    onInsertSystemCard?: (selection: SystemCardPromptSelection) => any;
     onInputChange?: (value: string) => any;
     onSend?: (payload?: WorkbenchChatSendPayload) => any;
     onStop?: (turnId?: string) => any;

package/dist/internal/personal-workbench/components/workbench/controllers/canvasConfigController.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview WorkbenchCanvas 配置 controller - 解析 card.data JSON、iframe 和 ECharts script 草稿。
+ * @author seadon
+ * @created 2026-09-01
+ */
+export interface CanvasCardDataDraftInput {
+    draft: string;
+    nativeEcharts: boolean;
+    rootPath: string;
+    messages: {
+        empty: string;
+        invalid: string;
+        invalidObject: string;
+        nativeNarrative: string;
+        nativeGlNarrative: string;
+    };
+}
+/** 判断 script 是否需要 echarts-gl。 */
+export declare function scriptRequiresEchartsGl(script: string): boolean;
+/** 归一化可编辑 card.data。 */
+export declare function normalizeEditedCardData(data: Record<string, unknown>): Record<string, unknown>;
+/** 解析 card.data 编辑草稿。 */
+export declare function normalizeCanvasCardDataDraft(input: CanvasCardDataDraftInput): Record<string, unknown>;

package/dist/internal/personal-workbench/components/workbench/controllers/canvasLayoutController.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview WorkbenchCanvas 布局 controller - 提供稳定排序、范围夹取和布局签名。
+ * @author seadon
+ * @created 2026-09-01
+ */
+import type { MaterializedBlock } from '@fses/workbench-app/types';
+/** 按当前画布 y/x/id 稳定排序。 */
+export declare function sortedByCurrentLayout(blocks: MaterializedBlock[]): MaterializedBlock[];
+/** 将自动排列值限制在给定范围。 */
+export declare function clampArrangeValue(value: number, min: number, max: number): number;
+/** 生成只包含 ID 和布局关键字段的稳定签名。 */
+export declare function arrangeLayoutSignature(blocks: MaterializedBlock[]): string;

package/dist/internal/personal-workbench/components/workbench/controllers/canvasRefreshController.d.ts

@@ -0,0 +1,11 @@
+import type { MaterializedBlock } from '@fses/workbench-app/types';
+export interface CanvasRefreshControllerOptions {
+    businessGapDiagnostics(block: MaterializedBlock): string;
+    isImageBusinessGapBadge(block: MaterializedBlock): boolean;
+    needsBusinessGap(block: MaterializedBlock): boolean;
+}
+/** 创建 data-binding badge 提示 controller。 */
+export declare function createCanvasRefreshController(options: CanvasRefreshControllerOptions): {
+    dataBindingBadgeHintDetail(block: MaterializedBlock, badgeTitle?: string): string;
+    dataBindingBadgeHintTitle(block: MaterializedBlock, label: string): string;
+};

package/dist/internal/personal-workbench/components/workbench/controllers/canvasSelectionController.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview WorkbenchCanvas 选择 controller - 隔离交互控件过滤和静态卡片命中。
+ * @author seadon
+ * @created 2026-09-01
+ */
+/** 判断目标是否应跳过拖拽编辑。 */
+export declare function isCanvasEditIgnoredTarget(target: EventTarget | null): boolean;
+/** 判断目标是否应跳过普通卡片选择。 */
+export declare function isCanvasCardFocusIgnoredTarget(target: EventTarget | null): boolean;
+/** 从左键 pointer 事件解析静态卡片 ID。 */
+export declare function canvasCardIdFromPointerEvent(event: PointerEvent): string;

package/dist/internal/personal-workbench/components/workbench/showcase/WorkbenchShowcase.vue.d.ts

@@ -116,6 +116,8 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     requestRefreshConfigDraftBlock: typeof requestRefreshConfigDraftBlock;
     requestCardRenderedSize: typeof requestCardRenderedSize;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    insertSystemCard: (selection: SystemCardPromptSelection) => any;
+    insertCustomCard: (entry: WorkbenchCustomCardCatalogEntry) => any;
     focusBlock: (blockId: string) => any;
     metricDetail: (payload: WorkbenchMetricDetailPayload) => any;
     focusNestedBlock: (payload: {
@@ -130,8 +132,6 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     cardPresetSizeConfigChange: (config: WorkbenchCardPresetSizeConfig) => any;
     canvasGapPresetChange: (preset: WorkbenchCanvasGapPreset) => any;
     pasteCardPrompt: (selection: SystemCardPromptSelection) => any;
-    insertSystemCard: (selection: SystemCardPromptSelection) => any;
-    insertCustomCard: (entry: WorkbenchCustomCardCatalogEntry) => any;
     layoutChange: (layout: readonly {
         i: string;
         x: number;
@@ -177,6 +177,8 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     }) => any;
     runShortcut: (prompt: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onInsertSystemCard?: (selection: SystemCardPromptSelection) => any;
+    onInsertCustomCard?: (entry: WorkbenchCustomCardCatalogEntry) => any;
     onFocusBlock?: (blockId: string) => any;
     onMetricDetail?: (payload: WorkbenchMetricDetailPayload) => any;
     onFocusNestedBlock?: (payload: {
@@ -191,8 +193,6 @@ declare const _default: import("vue").DefineComponent<__VLS_Props, {
     onCardPresetSizeConfigChange?: (config: WorkbenchCardPresetSizeConfig) => any;
     onCanvasGapPresetChange?: (preset: WorkbenchCanvasGapPreset) => any;
     onPasteCardPrompt?: (selection: SystemCardPromptSelection) => any;
-    onInsertSystemCard?: (selection: SystemCardPromptSelection) => any;
-    onInsertCustomCard?: (entry: WorkbenchCustomCardCatalogEntry) => any;
     onLayoutChange?: (layout: readonly {
         i: string;
         x: number;

package/dist/internal/personal-workbench/controllers/workbenchBuiltinPluginBridge.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Workspace 内置插件桥接控制器 - 隔离插件命令、事件校验和订阅生命周期。
+ * @author seadon
+ * @created 2026-09-01
+ */
+import type { WorkbenchCustomCardCatalogEntry } from '@fses/workbench-app/types';
+import type { WorkbenchHostContext } from '../../../kernel/createWorkbenchHostContext';
+import type { SystemCardPromptSelection } from '../lib/workbenchSystemCardPrompt';
+import type { WorkbenchStyleKey } from '../lib/workbenchThemes';
+export interface WorkbenchBuiltinPluginBridgeOptions {
+    hostContext: WorkbenchHostContext;
+    onInsertCustomCard(entry: WorkbenchCustomCardCatalogEntry): void | Promise<void>;
+    onInsertSystemCard(selection: SystemCardPromptSelection): void | Promise<void>;
+    onSettingsClose(): void;
+    onSettingsOpen(): void;
+    onSettingsSave(done?: (ok: boolean) => void): void;
+    onThemeApply(themeKey: WorkbenchStyleKey): void;
+}
+export interface WorkbenchBuiltinPluginBridge {
+    dispose(): void;
+    requestCardCenterOpen(): Promise<void>;
+    requestSettingsClose(): Promise<void>;
+    requestSettingsOpen(): Promise<void>;
+    requestSettingsSave(done?: (ok: boolean) => void): Promise<void>;
+    requestThemeApply(themeKey: WorkbenchStyleKey): Promise<void>;
+}
+/**
+ * 创建 Workspace 内置插件桥接控制器。
+ * @param options - 当前实例上下文和既有业务 handler。
+ * @returns 可请求插件命令并统一释放订阅的控制器。
+ */
+export declare function createWorkbenchBuiltinPluginBridge(options: WorkbenchBuiltinPluginBridgeOptions): WorkbenchBuiltinPluginBridge;

package/dist/internal/personal-workbench/controllers/workbenchChartConfigModel.d.ts

@@ -0,0 +1,68 @@
+import type { MaterializedBlock, WorkbenchLayoutV4 } from '@fses/workbench-app/types';
+export type ChartConfigDataRange = 'metric' | 'model_service' | 'list';
+export interface WorkbenchCardRenderedSize {
+    height: number;
+    width: number;
+}
+/**
+ * 将未知值收敛为普通记录。
+ * @param value - 候选记录。
+ * @returns 普通记录或空对象。
+ */
+export declare function chartConfigRecord(value: unknown): Record<string, unknown>;
+/**
+ * 读取记录中的非空字符串字段。
+ * @param record - 来源记录。
+ * @param key - 字段 key。
+ * @returns 去除首尾空白的字符串。
+ */
+export declare function chartConfigString(record: Record<string, unknown>, key: string): string;
+/**
+ * 读取图表配置抽屉使用的卡片标题。
+ * @param block - 当前卡片。
+ * @param fallback - 无标题时的国际化兜底文案。
+ * @returns 可编辑标题。
+ */
+export declare function chartConfigInitialTitle(block: MaterializedBlock, fallback?: string): string;
+/**
+ * 读取卡片标题初始隐藏状态。
+ * @param block - 当前卡片。
+ * @returns 标题是否隐藏。
+ */
+export declare function chartConfigInitialHideTitle(block: MaterializedBlock): boolean;
+/**
+ * 归一化图表配置数据范围。
+ * @param value - 持久化数据范围。
+ * @returns 受支持的数据范围。
+ */
+export declare function normalizeChartConfigDataRange(value: unknown): ChartConfigDataRange;
+/**
+ * 按可见标签和值过滤异步下拉选项。
+ * @param input - 用户搜索文本。
+ * @param option - 下拉选项。
+ * @returns 选项是否匹配。
+ */
+export declare function filterChartConfigSelectOption(input: string, option?: {
+    label?: unknown;
+    value?: unknown;
+}): boolean;
+/**
+ * 读取异步选项 ID。
+ * @param value - 持久化选项值。
+ * @returns 去除首尾空白的选项 ID。
+ */
+export declare function chartConfigDynamicOptionValue(value: unknown): string;
+/**
+ * 读取有限正数。
+ * @param value - 候选数值。
+ * @param fallback - 非法时的兜底值。
+ * @returns 有限正数。
+ */
+export declare function chartConfigPositiveNumber(value: unknown, fallback: number): number;
+/**
+ * 根据 GridStack 元数据估算卡片像素尺寸。
+ * @param block - 当前卡片。
+ * @param layoutTree - 可选布局树。
+ * @returns 宽高像素值。
+ */
+export declare function chartConfigEstimatedSizePx(block: MaterializedBlock, layoutTree?: WorkbenchLayoutV4 | null): WorkbenchCardRenderedSize;

package/dist/internal/personal-workbench/controllers/workbenchChartDataSourceController.d.ts

@@ -0,0 +1,100 @@
+import type { MaterializedBlock } from '@fses/workbench-app/types';
+import type { WorkbenchApplicationOption, WorkbenchChartListOption, WorkbenchChartMetricOption, WorkbenchChartModelServiceOption } from '../lib/workbenchApi';
+import { type ChartConfigDataRange } from './workbenchChartConfigModel';
+export interface ChartConfigDataSourceDraft {
+    applicationId: string;
+    dataRange: ChartConfigDataRange;
+    listId: string;
+    metricId: string;
+    modelServiceId: string;
+}
+export interface WorkbenchChartDataSourceServices {
+    loadApplications(): Promise<WorkbenchApplicationOption[]>;
+    loadLists(appId: string): Promise<WorkbenchChartListOption[]>;
+    loadMetrics(appId: string): Promise<WorkbenchChartMetricOption[]>;
+    loadModelServices(appId: string): Promise<WorkbenchChartModelServiceOption[]>;
+}
+export interface WorkbenchChartDataSourceControllerOptions {
+    isActive(): boolean;
+    services: WorkbenchChartDataSourceServices;
+}
+/**
+ * 创建图表数据源选项控制器。
+ * @param options - 抽屉激活读取器和实例请求端口。
+ * @returns reactive 表单状态、异步加载和草稿投影操作。
+ */
+export declare function createWorkbenchChartDataSourceController(options: WorkbenchChartDataSourceControllerOptions): {
+    applicationId: import("vue").Ref<string, string>;
+    applicationOptions: import("vue").Ref<{
+        value: string;
+        label: string;
+    }[], WorkbenchApplicationOption[] | {
+        value: string;
+        label: string;
+    }[]>;
+    applicationSelectOptions: import("vue").ComputedRef<WorkbenchApplicationOption[]>;
+    applicationsError: import("vue").Ref<string, string>;
+    applicationsLoaded: import("vue").Ref<boolean, boolean>;
+    applicationsLoading: import("vue").Ref<boolean, boolean>;
+    dataRange: import("vue").Ref<ChartConfigDataRange, ChartConfigDataRange>;
+    dispose: import("vue").WatchHandle;
+    draft: () => ChartConfigDataSourceDraft;
+    hydrate: (block: MaterializedBlock) => void;
+    listId: import("vue").Ref<string, string>;
+    listOptions: import("vue").Ref<{
+        value: string;
+        label: string;
+        appId: string;
+        dataCode: string;
+        formKey: string;
+    }[], WorkbenchChartListOption[] | {
+        value: string;
+        label: string;
+        appId: string;
+        dataCode: string;
+        formKey: string;
+    }[]>;
+    listSelectOptions: import("vue").ComputedRef<WorkbenchChartListOption[]>;
+    listsError: import("vue").Ref<string, string>;
+    listsLoading: import("vue").Ref<boolean, boolean>;
+    loadApplications: () => Promise<void>;
+    loadDependentOptions: () => Promise<void>;
+    loadLists: () => Promise<void>;
+    loadMetrics: () => Promise<void>;
+    loadModelServices: () => Promise<void>;
+    metricId: import("vue").Ref<string, string>;
+    metricOptions: import("vue").Ref<{
+        value: string;
+        label: string;
+        appId: string;
+        metricCode: string;
+    }[], WorkbenchChartMetricOption[] | {
+        value: string;
+        label: string;
+        appId: string;
+        metricCode: string;
+    }[]>;
+    metricSelectOptions: import("vue").ComputedRef<WorkbenchChartMetricOption[]>;
+    metricsError: import("vue").Ref<string, string>;
+    metricsLoading: import("vue").Ref<boolean, boolean>;
+    modelServiceId: import("vue").Ref<string, string>;
+    modelServiceOptions: import("vue").Ref<{
+        value: string;
+        label: string;
+        appId: string;
+        dataCode: string;
+        svcCode: string;
+        dataSvcMode: string;
+    }[], WorkbenchChartModelServiceOption[] | {
+        value: string;
+        label: string;
+        appId: string;
+        dataCode: string;
+        svcCode: string;
+        dataSvcMode: string;
+    }[]>;
+    modelServiceSelectOptions: import("vue").ComputedRef<WorkbenchChartModelServiceOption[]>;
+    modelServicesError: import("vue").Ref<string, string>;
+    modelServicesLoading: import("vue").Ref<boolean, boolean>;
+    resetDependentOptions: () => void;
+};

package/dist/internal/personal-workbench/controllers/workbenchChartDrilldownController.d.ts

@@ -0,0 +1,96 @@
+import type { MaterializedBlock, WorkbenchEchartClickParams } from '@fses/workbench-app/types';
+import type { TableColumnsType } from 'ant-design-vue';
+import { type ComputedRef, type Ref } from 'vue';
+import type { WorkbenchMetricDetailColumn, WorkbenchMetricDetailPageRequest, WorkbenchMetricDetailPageResult, WorkbenchMetricFilter } from '../lib/workbenchMetricDetailApi';
+export type WorkbenchChartClickPayload = WorkbenchEchartClickParams & {
+    blockId: string;
+    block: MaterializedBlock;
+};
+export type WorkbenchMetricDetailPayload = {
+    blockId: string;
+    block: MaterializedBlock;
+};
+export type ChartDrilldownTableRow = Record<string, unknown> & {
+    __rowKey: string;
+};
+export interface WorkbenchChartDrilldownTarget {
+    bindingId: string;
+    block: MaterializedBlock;
+    cardId: string;
+    categoryValue: unknown;
+    filters?: WorkbenchMetricFilter[];
+    label: string;
+    metricName: string;
+}
+export interface WorkbenchChartDrilldownAction extends WorkbenchChartDrilldownTarget {
+    left: number;
+    top: number;
+}
+export interface WorkbenchChartDrilldownControllerOptions {
+    isConfigDrawerOpen(): boolean;
+    loadPage(request: WorkbenchMetricDetailPageRequest): Promise<WorkbenchMetricDetailPageResult>;
+    notify: {
+        error(message: string): void;
+        info(message: string): void;
+        warning(message: string): void;
+    };
+    onSelectBlock(blockId: string): void;
+    resolveBindingId(block: MaterializedBlock): string;
+    supportsDetail?: (block: MaterializedBlock | null | undefined) => boolean;
+    workspaceId(): string;
+}
+export interface WorkbenchChartDrilldownController {
+    action: Ref<WorkbenchChartDrilldownAction | null>;
+    closeAction(): void;
+    closeModal(): void;
+    columns: Ref<WorkbenchMetricDetailColumn[]>;
+    dispose(): void;
+    error: Ref<string>;
+    handleChartClick(payload: WorkbenchChartClickPayload): Promise<void>;
+    handleColumnResize(width: number, column: unknown): void;
+    handleMetricDetail(payload: WorkbenchMetricDetailPayload): Promise<void>;
+    handleOutsidePointerDown(event: PointerEvent): void;
+    handlePageChange(pageIndex: number): Promise<void>;
+    handlePageSizeChange(current: number, pageSize: number): Promise<void>;
+    initialLoading: ComputedRef<boolean>;
+    loading: Ref<boolean>;
+    modalOpen: Ref<boolean>;
+    openActionDetail(): Promise<void>;
+    openTarget(target: WorkbenchChartDrilldownTarget): Promise<void>;
+    pageIndex: Ref<number>;
+    pageSize: Ref<number>;
+    pageSizeOptions: string[];
+    paginationLocale: {
+        items_per_page: string;
+    };
+    rows: Ref<Array<Record<string, unknown>>>;
+    setActionElement(element: unknown): void;
+    setTableElement(element: unknown): void;
+    tableColumns: ComputedRef<TableColumnsType<ChartDrilldownTableRow>>;
+    tableHasHorizontalScroll: ComputedRef<boolean>;
+    tableLocale: ComputedRef<{
+        emptyText: string;
+    }>;
+    tableNeedsVerticalScroll: ComputedRef<boolean>;
+    tableRows: ComputedRef<ChartDrilldownTableRow[]>;
+    tableScroll: ComputedRef<{
+        x: number;
+        y?: string;
+    }>;
+    target: Ref<WorkbenchChartDrilldownTarget | null>;
+    total: Ref<number>;
+    windowHeight: Ref<number>;
+}
+/**
+ * 规范化详情列，接口缺少 columns 时从首行推导。
+ * @param columns - 接口列定义。
+ * @param rows - 当前页数据行。
+ * @returns 可渲染列定义。
+ */
+export declare function chartDrilldownColumnsFromResult(columns: WorkbenchMetricDetailPageResult['columns'], rows: Array<Record<string, unknown>>): WorkbenchMetricDetailColumn[];
+/**
+ * 创建图表明细控制器。
+ * @param options - 查询、binding、选中和通知端口。
+ * @returns 明细状态、动作、分页与 DOM 生命周期操作。
+ */
+export declare function createWorkbenchChartDrilldownController(options: WorkbenchChartDrilldownControllerOptions): WorkbenchChartDrilldownController;