@fses/workbench-app 0.2.0 → 0.2.1

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

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview 工作台图表主题适配 - 从宿主 CSS 变量读取主题并应用到 ECharts option。
+ * @author seadon
+ * @created 2026-07-11
+ */
+import type { EChartsOption } from 'echarts';
+export interface WorkbenchChartThemeTokens {
+    colors: string[];
+    axisColor?: string;
+    axisLabelColor?: string;
+    splitLineColor?: string;
+    legendTextColor?: string;
+    tooltipBg?: string;
+    tooltipTextColor?: string;
+    backgroundColor?: string;
+    textColor?: string;
+}
+/**
+ * 从 DOM 元素继承到的 CSS 变量读取工作台图表主题。
+ * @param element - 图表容器元素。
+ * @returns 有有效色板时返回主题 token，否则返回 null。
+ */
+export declare function readWorkbenchChartThemeTokens(element: HTMLElement | null): WorkbenchChartThemeTokens | null;
+/**
+ * 查找工作台主题变化的监听根节点。
+ * @param element - 图表容器元素。
+ * @returns 最近的工作台根节点或文档根节点。
+ */
+export declare function resolveWorkbenchChartThemeRoot(element: HTMLElement | null): HTMLElement | null;
+/**
+ * 把工作台主题 token 合并到 ECharts option 的默认视觉项上。
+ * @param option - 原始 ECharts option。
+ * @param tokens - 工作台主题 token。
+ * @returns 新的 ECharts option；无主题时返回原 option。
+ */
+export declare function applyWorkbenchChartThemeToOption(option: EChartsOption, tokens: WorkbenchChartThemeTokens | null): EChartsOption;

package/node_modules/@fses/workbench-card/dist/renderers/custom-canvas/canvasLayoutBindings.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview 自定义画布布局绑定 - 提供 customCanvas 子卡片布局、绝对定位和外壳样式 helper。
+ * @author seadon
+ * @created 2026-05-20
+ */
+import type { CSSProperties } from 'vue';
+import type { CustomCanvasData, CustomCanvasNestedBlock, WorkbenchBlock } from '../../types';
+import type { WorkbenchBlockRendererProps } from '../useWorkbenchBlockRendererBindings';
+type CanvasLayoutContext = Record<string, any> & {
+    props: WorkbenchBlockRendererProps;
+};
+type NestedStackTailPlacement = {
+    start: number;
+    span: number;
+};
+/**
+ * Creates layout helpers for customCanvas and nested previews.
+ * @param context - Shared renderer helpers and state.
+ * @returns Layout and shell helper functions.
+ */
+export declare function createCanvasLayoutBindings(context: CanvasLayoutContext): {
+    customCanvasNestedStackContainerStyle: (data: CustomCanvasData) => CSSProperties | undefined;
+    customCanvasNestedStackColumnWeights: (data: CustomCanvasData) => number[];
+    customCanvasReadableNestedStackColumnWeights: (weights: number[]) => number[];
+    nestedBlockCanvasStyle: (block: CustomCanvasNestedBlock, data: CustomCanvasData, usesAbsolute: boolean) => CSSProperties;
+    nestedBlockStackGridStyle: (block: CustomCanvasNestedBlock, data: CustomCanvasData) => CSSProperties;
+    customCanvasNestedLayoutItem: (blockId: string, data: CustomCanvasData) => {
+        rowSpan: number;
+        columnSpan: number;
+    };
+    customCanvasRegularNestedStackGrid: (data: CustomCanvasData) => {
+        tailRowIndex: number;
+        placements: Map<string, NestedStackTailPlacement>;
+    } | undefined;
+    nestedBlockStackTailPlacementStyle: (block: CustomCanvasNestedBlock, data: CustomCanvasData) => CSSProperties;
+    nestedBlockHasLayout: (block: CustomCanvasNestedBlock) => boolean;
+    customCanvasAbsoluteNestedBox: (block: CustomCanvasNestedBlock, data: CustomCanvasData) => {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    } | undefined;
+    customCanvasAbsoluteNestedOverlapArea: (boxes: Array<{
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>) => number;
+    customCanvasAbsoluteNestedWidthSpan: (boxes: Array<{
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }>) => number;
+    customCanvasSparseAbsoluteNestedRowFill: (block: CustomCanvasNestedBlock, data: CustomCanvasData) => boolean;
+    customCanvasAbsoluteNestedRows: (data: CustomCanvasData) => Array<Array<{
+        block: CustomCanvasNestedBlock;
+        box: {
+            x: number;
+            y: number;
+            w: number;
+            h: number;
+        };
+    }>>;
+    absoluteNestedBlockGridTailPlacementStyle: (block: CustomCanvasNestedBlock, data: CustomCanvasData) => {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    } | undefined;
+    customCanvasSparseAbsoluteNestedTopOffset: (data: CustomCanvasData) => number;
+    layoutPercent: (value: number) => string;
+    nestedBlockUsesGlobalCoordinates: (layout: Record<string, unknown>, basis: Record<string, unknown>) => boolean;
+    nestedBlockLocalCoordinate: (value: number, offset: number, usesGlobalCoordinates: boolean) => number;
+    nestedBlockAbsoluteStyle: (block: CustomCanvasNestedBlock, data: CustomCanvasData) => CSSProperties;
+    nestedBlockAccentStyle: (block: CustomCanvasNestedBlock) => CSSProperties | undefined;
+    customCanvasPercent: (value: unknown) => string | undefined;
+    customCanvasSafeElementStyle: (style: unknown) => CSSProperties;
+    customCanvasElementStyle: (element: CustomCanvasData["elements"][number]) => CSSProperties;
+    customCanvasElementClasses: (element: CustomCanvasData["elements"][number]) => string[];
+    customCanvasStyle: (block: WorkbenchBlock, data: CustomCanvasData) => CSSProperties;
+    callCustomCanvasPageHeaderBlock: (block: WorkbenchBlock, data: CustomCanvasData) => boolean;
+    customCanvasShellClasses: (block: WorkbenchBlock) => string[];
+    nestedBlockShellClasses: (block: CustomCanvasNestedBlock, absoluteLayout?: boolean, denseStack?: boolean, naturalGrid?: boolean) => string[];
+};
+export {};

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

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview Workbench renderer host bridge - describes app-owned services injected into reusable card renderers.
+ * @author seadon
+ * @created 2026-05-20
+ */
+import type { Component } from 'vue';
+import type { FdeCustomComponentData, MaterializedBlock, RoleId } from '../types';
+import type { WorkbenchChartRefreshContext, WorkbenchChartRefreshRuntime } from './chart/types';
+export interface WorkbenchRendererDataBindingRefreshRuntime extends WorkbenchChartRefreshRuntime {
+    currentConversationId?: string;
+    currentRoleId?: RoleId | string;
+    currentUserId?: string;
+}
+export interface WorkbenchRendererManualReplacementView {
+    reason: string;
+    suggestedKind: string;
+    suggestedKindLabel: string;
+    confidenceLabel: string;
+    regionLabel: string;
+    suggestedCapabilityId?: string;
+    suggestedCapabilityLabel?: string;
+}
+export interface WorkbenchRendererCustomComponentEntry {
+    componentRef: string;
+    componentName?: string;
+    packageName?: string;
+    version?: string;
+    exportName?: string;
+    enabled?: boolean;
+    component: Component;
+    validateProps?: (props: Record<string, unknown>, data: FdeCustomComponentData) => boolean | string;
+}
+export interface WorkbenchRendererCustomComponentRegistry {
+    /**
+     * Resolves a host-registered npm component for an FDE custom component card.
+     * @param data - Card renderer data containing componentRef and props.
+     * @returns Registered component entry, or null when it is not allowlisted.
+     */
+    resolve: (data: FdeCustomComponentData) => WorkbenchRendererCustomComponentEntry | null;
+    /**
+     * Validates host-provided props before rendering the registered component.
+     * @param entry - Matched custom component registry entry.
+     * @param props - Props projected by the host or run-agent.
+     * @param data - Full FDE custom component card data.
+     * @returns true/undefined when valid, false or a message when invalid.
+     */
+    validateProps?: (entry: WorkbenchRendererCustomComponentEntry, props: Record<string, unknown>, data: FdeCustomComponentData) => boolean | string;
+}
+export interface WorkbenchRendererHostBridge {
+    WelcomeBanner?: Component;
+    formatMetricValue?: (value: number, format?: string) => string;
+    businessGapDiagnosticSummary?: (input: {
+        message?: unknown;
+        fallback?: string;
+        diagnostics?: unknown;
+    }) => string;
+    manualReplacementViewForBlock?: (block: MaterializedBlock) => WorkbenchRendererManualReplacementView | null;
+    customComponentRegistry?: WorkbenchRendererCustomComponentRegistry;
+    refreshRuntime?: WorkbenchRendererDataBindingRefreshRuntime;
+}
+export type { WorkbenchChartRefreshContext };

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

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview workbench-card renderer entry - exports reusable chart renderers and chart runtime helpers.
+ * @author seadon
+ * @created 2026-05-20
+ */
+export { default as ChartRegistryRenderer } from './chart/ChartRegistry.vue';
+export { default as EChartsProtocolRenderer } from './chart/EChartsProtocolRenderer.vue';
+export { default as WorkbenchBlockRenderer } from './WorkbenchBlockRenderer.vue';
+export { EChartsProtocolAdapter, deepMergeOption } from './chart/echarts-protocol';
+export * from './chart/chartRendererRegistry';
+export * from './chart/dynamicEchartOption';
+export * from './chart/echarts-protocol/types';
+export * from './chart/echartsTitle';
+export * from './chart/types';
+export * from './hostBridge';
+export * from './resizableTable';
+export { chartNarrative, chartTheme, normalizeChartRendererKey, optionFromWorkbenchData, prepareWorkbenchChartOption, useEchart, type WorkbenchEchartClickParams, } from './chart/useEchart';

package/node_modules/@fses/workbench-card/dist/renderers/native/nativeBindings.d.ts

@@ -0,0 +1,145 @@
+/**
+ * @fileoverview 原生卡片绑定 - 提供表单、问卷、指标、列表、天气和普通图表 helper。
+ * @author seadon
+ * @created 2026-05-20
+ */
+import type { Component } from 'vue';
+import type { ActionGroupData, BlockVisualOptions, CategoryRankingData, CustomCanvasData, DisplayBlockData, FormBlockData, FormField, MetricSummaryData, ReportBlockData, SurveyBlockData, TaskSummaryData, WeatherCurrentData, WorkbenchBlock, WorkflowBlockData } from '../../types';
+import type { WorkbenchBlockRendererProps } from '../useWorkbenchBlockRendererBindings';
+type NativeBindingsContext = {
+    props: WorkbenchBlockRendererProps;
+    formValuesByBlock: Record<string, Record<string, unknown>>;
+    surveyAnswersByBlock: Record<string, Record<string, unknown>>;
+    formatMetricValue: (value: number, format?: string) => string;
+    isRecord: (value: unknown) => value is Record<string, unknown>;
+    dataBindingNeedsHumanIntervention: () => (block: WorkbenchBlock) => boolean;
+    imageComposeAlertRankingCard: () => (block: WorkbenchBlock, data: CategoryRankingData) => boolean;
+    imageComposeCompactCard: () => (block: WorkbenchBlock) => boolean;
+    imageComposeBusinessGapBadgeLabel: () => (block: WorkbenchBlock) => string;
+    referenceCompositeLooksLikeChairmanRiskDirectContext: () => (block: WorkbenchBlock, data: CustomCanvasData) => boolean;
+    CircleCheck: Component;
+    UserRound: Component;
+    LayoutDashboard: Component;
+    Bot: Component;
+    CloudRain: Component;
+    CloudSun: Component;
+};
+type ImageComposeMetricLeadingVisualKind = 'icon' | 'bars' | 'sparkline';
+type ImageComposeChartPreviewKind = 'line' | 'bar' | 'mixed' | 'donut';
+type ImageComposeChartPreviewBar = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    fill: string;
+    opacity: number;
+    label: string;
+};
+export interface ImageComposeChartPreviewHeader {
+    label: string;
+    metric: string;
+    status: string;
+}
+/**
+ * Resolves display columns for normal rows and object-row image fallbacks.
+ * @param columns - Optional declared table columns.
+ * @param rows - Table rows that may omit cells and columns.
+ * @returns Columns safe for rendering.
+ */
+export declare function tableColumnsFromRows(columns: unknown, rows: unknown): string[];
+/**
+ * Resolves visible cells from a declared row.cells array or key-value object row fallback.
+ * @param row - Table row payload.
+ * @param columns - Visible table columns.
+ * @returns Cell texts safe for Vue template iteration.
+ */
+export declare function tableRowCells(row: unknown, columns: string[]): string[];
+/**
+ * Creates native card helpers used by WorkbenchBlockRenderer.
+ * @param context - Shared renderer state and utilities.
+ * @returns Native renderer helper functions.
+ */
+export declare function createNativeBindings(context: NativeBindingsContext): {
+    isFormBlockData: (value: unknown) => value is FormBlockData;
+    isSurveyBlockData: (value: unknown) => value is SurveyBlockData;
+    isActionGroupData: (value: unknown) => value is ActionGroupData;
+    isWorkflowBlockData: (value: unknown) => value is WorkflowBlockData;
+    isReportBlockData: (value: unknown) => value is ReportBlockData;
+    textValue: (value: unknown, fallback?: string) => string;
+    numberValue: (value: unknown, fallback?: number) => number;
+    listValue: (value: unknown) => Record<string, unknown>[];
+    metaRecord: (block: WorkbenchBlock, key: string) => Record<string, unknown>;
+    metaList: (block: WorkbenchBlock, key: string) => Record<string, unknown>[];
+    welcomeBannerMetrics: (block: WorkbenchBlock) => {
+        label: string;
+        value: string;
+        hint: string;
+    }[];
+    tierKeyForDensity: (density: "thumbnail" | "compact" | "standard" | "expanded") => "compact" | "standard" | "expanded";
+    applyResponsiveTier: (block: WorkbenchBlock, density: "thumbnail" | "compact" | "standard" | "expanded") => WorkbenchBlock;
+    formValues: (blockId: string) => Record<string, unknown>;
+    surveyAnswers: (blockId: string) => Record<string, unknown>;
+    compactLimit: <T>(items: T[] | undefined | null, thumbnail: number, compact: number) => T[];
+    toggleMultiValue: (currentValue: unknown, option: string) => string[];
+    formCompletedCount: (blockId: string, data: FormBlockData) => number;
+    renderFieldType: (field: FormField) => "text" | "number" | "date";
+    updateMatrixAnswer: (blockId: string, questionId: string, row: string, option: string) => void;
+    matrixAnswerValue: (blockId: string, questionId: string, row: string) => unknown;
+    multipleAnswerIncludes: (blockId: string, questionId: string, option: string) => boolean;
+    taskStatusClass: (status: TaskSummaryData["items"][number]["status"]) => string;
+    taskTypeLabel: (type: TaskSummaryData["items"][number]["type"]) => string;
+    taskStatusLabel: (status: TaskSummaryData["items"][number]["status"]) => string;
+    tableRowsPreviewVisualKind: (data: DisplayBlockData | undefined, block?: WorkbenchBlock) => string;
+    tableRowsPreviewCard: (block: WorkbenchBlock, data: DisplayBlockData | undefined) => boolean;
+    tableRowsPreviewRecords: (data: DisplayBlockData | undefined) => Array<Record<string, string>>;
+    tableRowsPreviewCell: (row: Record<string, string>, column: string) => string;
+    tableRowsTimelinePrimaryCell: (row: Record<string, string>, columns: string[]) => string;
+    tableRowsTimelineBadgeCell: (row: Record<string, string>, columns: string[]) => string;
+    tableRowsPreviewGridStyle: (columns: string[]) => Record<string, string>;
+    formatWeatherTemp: (value: number | null | undefined) => string;
+    weatherIcon: (condition: WeatherCurrentData["condition"]) => Component;
+    isChartShape: (data?: DisplayBlockData) => boolean;
+    imageComposeEmptyChartPreview: (block: WorkbenchBlock, data?: DisplayBlockData) => boolean;
+    imageComposeChartPreview: (block: WorkbenchBlock, data?: DisplayBlockData) => boolean;
+    imageComposeMetricLeadingVisualKind: (block: WorkbenchBlock) => ImageComposeMetricLeadingVisualKind;
+    imageComposeChartPreviewKind: (block: WorkbenchBlock, data?: DisplayBlockData) => ImageComposeChartPreviewKind;
+    imageComposeChartPreviewLabel: (block: WorkbenchBlock, data?: DisplayBlockData) => string;
+    imageComposeChartPreviewMetric: (block: WorkbenchBlock, data?: DisplayBlockData) => string;
+    imageComposeChartPreviewStatus: (_block: WorkbenchBlock, data?: DisplayBlockData) => string;
+    imageComposeChartPreviewHeader: (block: WorkbenchBlock, data?: DisplayBlockData) => ImageComposeChartPreviewHeader;
+    imageComposeChartPreviewBars: (block: WorkbenchBlock, data?: DisplayBlockData) => ImageComposeChartPreviewBar[];
+    imageComposeChartPreviewDonutStyle: (block: WorkbenchBlock, data?: DisplayBlockData) => Record<string, string>;
+    imageComposeEmptyRankingPreview: (block: WorkbenchBlock, data: CategoryRankingData) => boolean;
+    imageComposeEmptyRankingStatus: (block: WorkbenchBlock, data: CategoryRankingData & Record<string, unknown>) => string;
+    imageComposeEmptyRankingDetail: (block: WorkbenchBlock) => string;
+    imageComposeRankingPreviewItems: (block: WorkbenchBlock, data: CategoryRankingData) => Array<Record<string, unknown>>;
+    imageComposeRankingPreviewLabel: (item: Record<string, unknown>, index: number) => string;
+    imageComposeRankingPreviewDetail: (item: Record<string, unknown>) => string;
+    imageComposeRankingPreviewValue: (item: Record<string, unknown>, data: CategoryRankingData) => string;
+    imageComposeRankingPreviewAvatar: (item: Record<string, unknown>, index: number) => string;
+    imageComposeRankingPreviewAvatarClass: (item: Record<string, unknown>, index: number) => string[];
+    imageComposeRankingPreviewValueClass: (item: Record<string, unknown>, index: number) => string[];
+    activeTabFor: (block: WorkbenchBlock) => Record<string, unknown>;
+    tabsFor: (block: WorkbenchBlock) => Record<string, unknown>[];
+    orgMetricValues: (block: WorkbenchBlock) => {
+        label: string;
+        value: number;
+        icon: Component;
+    }[];
+    visualFor: (block: WorkbenchBlock) => BlockVisualOptions;
+    visualForScene: (block: WorkbenchBlock, data?: CustomCanvasData) => BlockVisualOptions;
+    rowGrid: (columns: string[]) => {
+        gridTemplateColumns: string;
+    };
+    tableColumnsFromRows: typeof tableColumnsFromRows;
+    tableRowCells: typeof tableRowCells;
+    metricSummaryDisplayValue: (data: MetricSummaryData & Record<string, unknown>) => string;
+    metricSummaryUnitLabel: (data: MetricSummaryData & Record<string, unknown>) => string;
+    imageComposeMetricSubText: (data: MetricSummaryData & Record<string, unknown>) => string;
+    imageComposeMetricFooterStatus: (data: MetricSummaryData & Record<string, unknown>) => string;
+    imageComposeMetricFooterMain: (data: MetricSummaryData & Record<string, unknown>) => string;
+    imageComposeMetricFooterStatusClass: (status: string) => string[];
+    imageComposeMetricStatusDotClass: (status: string) => string[];
+    chartRendererKey: (block: WorkbenchBlock) => string;
+};
+export {};

package/node_modules/@fses/workbench-card/dist/renderers/nested/nestedBlockBindings.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @fileoverview 嵌套卡片预览绑定 - 提供 customCanvas 子卡片的数据归一化、语义分类和样式 helper。
+ * @author seadon
+ * @created 2026-05-20
+ */
+import type { CSSProperties } from 'vue';
+import type { CustomCanvasData, CustomCanvasNestedBlock, BlockVisualOptions, WorkbenchBlock } from '../../types';
+type TextValueHelper = (value: unknown, fallback?: string) => string;
+type NumberValueHelper = (value: unknown, fallback?: number) => number;
+type NestedBlockContext = {
+    textValue: TextValueHelper;
+    numberValue: NumberValueHelper;
+    isRecord: (value: unknown) => value is Record<string, unknown>;
+    formatMetricValue: (value: number, format?: string) => string;
+    businessGapDiagnosticSummary: (input: {
+        message?: unknown;
+        fallback?: string;
+        diagnostics?: unknown;
+    }) => string;
+    dataBindingHumanInterventionFromRecord: (value: unknown) => Record<string, unknown> | undefined;
+    recordHasImageComposeSource: (value: unknown) => boolean;
+    customCanvasGeneratedElement: (element: unknown) => boolean;
+    nestedBlockRendererKey: (block: CustomCanvasNestedBlock) => string;
+    nestedBlockComposeSource: (block: CustomCanvasNestedBlock) => string;
+    nestedBlockSummaryEntry: (key: string, value: unknown) => string;
+    visualForScene: (block: WorkbenchBlock, data?: CustomCanvasData) => BlockVisualOptions;
+    referenceCompositeLooksLikeChairmanRiskDirectContext: () => (block: WorkbenchBlock, data: CustomCanvasData) => boolean;
+    referenceCompositeLooksLikeChairmanRiskContext: () => (block: WorkbenchBlock, data: CustomCanvasData) => boolean;
+    referenceOpsTrendItems: () => (data: CustomCanvasData) => Array<Record<string, unknown>>;
+};
+/**
+ * Creates helpers for nested customCanvas card previews.
+ * @param context - Shared renderer helpers from the main workbench block binding.
+ * @returns Nested card helper functions consumed by the block renderer template.
+ */
+export declare function createNestedBlockBindings(context: NestedBlockContext): {
+    nestedBlockMetricValue: (block: CustomCanvasNestedBlock) => string;
+    nestedBlockClassifierText: (block: CustomCanvasNestedBlock) => string;
+    nestedBlockDeclaredVisualKind: (block: CustomCanvasNestedBlock) => ("table" | "metric" | "chart" | "summary" | "donut" | "simpleList" | "progressList" | "todoGrid" | "quickLinks" | "statusList" | "resourceBars" | "incidentList" | "securityScore" | "list") | "";
+    nestedBlockVisualKind: (block: CustomCanvasNestedBlock) => "table" | "metric" | "chart" | "summary" | "donut" | "simpleList" | "progressList" | "todoGrid" | "quickLinks" | "statusList" | "resourceBars" | "incidentList" | "securityScore" | "list";
+    nestedBlockItemRecords: (value: unknown) => Array<Record<string, unknown>>;
+    nestedBlockItemEmpty: (item: Record<string, unknown>) => boolean;
+    nestedBlockItemLooksWeak: (item: Record<string, unknown>) => boolean;
+    nestedBlockItemsLookTooWeak: (items: Array<Record<string, unknown>>) => boolean;
+    nestedBlockItemsLookTooWeakForVisualKind: (items: Array<Record<string, unknown>>, visualKind: "table" | "metric" | "chart" | "summary" | "donut" | "simpleList" | "progressList" | "todoGrid" | "quickLinks" | "statusList" | "resourceBars" | "incidentList" | "securityScore" | "list") => boolean;
+    nestedBlockRawItems: (block: CustomCanvasNestedBlock) => Array<Record<string, unknown>>;
+    nestedBlockElementItems: (block: CustomCanvasNestedBlock, visualKind: "table" | "metric" | "chart" | "summary" | "donut" | "simpleList" | "progressList" | "todoGrid" | "quickLinks" | "statusList" | "resourceBars" | "incidentList" | "securityScore" | "list") => Array<Record<string, unknown>>;
+    nestedBlockToneFromStatus: (status: string) => "info" | "warning" | "neutral" | "violet" | "healthy" | "critical";
+    nestedBlockToneFromProgress: (label: string, value: number) => "info" | "warning" | "neutral" | "violet" | "healthy" | "critical";
+    nestedBlockFallbackDomain: (text: string) => "risk" | "hr" | "it" | "marketing" | "business";
+    nestedBlockFallbackClassifierText: (block: CustomCanvasNestedBlock) => string;
+    nestedBlockFallbackItems: (block: CustomCanvasNestedBlock, visualKind: "table" | "metric" | "chart" | "summary" | "donut" | "simpleList" | "progressList" | "todoGrid" | "quickLinks" | "statusList" | "resourceBars" | "incidentList" | "securityScore" | "list") => Array<Record<string, unknown>>;
+    nestedBlockItems: (block: CustomCanvasNestedBlock) => Array<Record<string, unknown>>;
+    nestedBlockBarItems: (block: CustomCanvasNestedBlock) => Array<Record<string, unknown>>;
+    nestedBlockTileItems: (block: CustomCanvasNestedBlock) => Array<Record<string, unknown>>;
+    nestedBlockDisplayValue: (value: unknown, fallback?: string) => string;
+    nestedBlockItemLabel: (item: Record<string, unknown>, index: number) => string;
+    nestedBlockItemValue: (item: Record<string, unknown>) => string;
+    nestedBlockItemDetail: (item: Record<string, unknown>) => string;
+    nestedBlockItemTitle: (item: Record<string, unknown>, index: number) => string;
+    nestedBlockItemSeverity: (item: Record<string, unknown>) => string;
+    nestedBlockItemTime: (item: Record<string, unknown>) => string;
+    nestedBlockNumber: (value: unknown, fallback?: number) => number;
+    nestedBlockPercent: (value: unknown, fallback?: number) => string;
+    nestedBlockItemProgress: (item: Record<string, unknown>, fallback?: number) => string;
+    nestedBlockOptionalNumber: (value: unknown) => number | undefined;
+    referenceOpsTrendCount: (item: Record<string, unknown>) => number;
+    referenceOpsTrendBarHeight: (item: Record<string, unknown>, items: Array<Record<string, unknown>>) => string;
+    referenceOpsTrendChartItems: (data: CustomCanvasData) => Array<Record<string, unknown>>;
+    nestedBlockTone: (item: Record<string, unknown>) => "info" | "warning" | "neutral" | "violet" | "healthy" | "critical";
+    nestedBlockToneClass: (item: Record<string, unknown>) => "info" | "warning" | "neutral" | "violet" | "healthy" | "critical";
+    customCanvasRiskSummaryBand: (block: WorkbenchBlock, data: CustomCanvasData) => boolean;
+    customCanvasExplicitImageHeaderBlock: (block: WorkbenchBlock, data: CustomCanvasData) => boolean;
+    customCanvasEffectiveVisual: (block: WorkbenchBlock, data: CustomCanvasData) => BlockVisualOptions;
+    nestedBlockStatusSummary: (block: CustomCanvasNestedBlock) => Array<{
+        tone: "info" | "warning" | "neutral" | "violet" | "healthy" | "critical";
+        count: number;
+    }>;
+    nestedBlockStatusSummaryLabel: (tone: "info" | "warning" | "neutral" | "violet" | "healthy" | "critical") => string;
+    nestedBlockPillClasses: (item: Record<string, unknown>) => string[];
+    nestedBlockDotClasses: (item: Record<string, unknown>) => string[];
+    nestedBlockBarClasses: (item: Record<string, unknown>) => string[];
+    referenceOpsTrendBarClasses: (item: Record<string, unknown>) => string[];
+    nestedBlockBarStyle: (item: Record<string, unknown>, fallback?: number) => CSSProperties;
+    nestedBlockProgressStage: (item: Record<string, unknown>, index: number) => string;
+    nestedBlockSecurityScore: (block: CustomCanvasNestedBlock) => string;
+    nestedBlockSecurityScoreRingLabel: (block: CustomCanvasNestedBlock) => string;
+    nestedBlockSecurityMetrics: (block: CustomCanvasNestedBlock) => Array<Record<string, unknown>>;
+    nestedBlockNormalizedDonutItems: (items: Array<Record<string, unknown>>) => Array<Record<string, unknown>>;
+    nestedBlockDonutItems: (block: CustomCanvasNestedBlock) => Array<Record<string, unknown>>;
+    nestedBlockDonutStyle: (block: CustomCanvasNestedBlock) => CSSProperties;
+    nestedBlockQuickIconLabel: (item: Record<string, unknown>, index: number) => string;
+    nestedBlockQuickLinksGridStyle: (block: CustomCanvasNestedBlock) => CSSProperties;
+    nestedBlockRows: (block: CustomCanvasNestedBlock) => Array<Record<string, unknown>>;
+    nestedBlockColumns: (block: CustomCanvasNestedBlock) => string[];
+    nestedBlockRankingItems: (block: CustomCanvasNestedBlock) => Record<string, unknown>[];
+    nestedBlockCell: (row: Record<string, unknown>, column: string) => string;
+    nestedBlockPreviewKind: (block: CustomCanvasNestedBlock) => "table" | "metric" | "chart" | "summary" | "list";
+    nestedBlockCompactPreview: (block: CustomCanvasNestedBlock) => boolean;
+    nestedBlockGridMinHeightClass: (block: CustomCanvasNestedBlock, denseStack?: boolean) => string;
+    nestedBlockStatusLabel: (block: CustomCanvasNestedBlock) => string;
+    nestedBlockEmptyImageContainer: (block: CustomCanvasNestedBlock) => boolean;
+    nestedBlockFailureReason: (block: CustomCanvasNestedBlock) => string;
+    nestedBlockBusinessGapReason: (block: CustomCanvasNestedBlock) => string;
+    nestedBlockQueryIntent: (block: CustomCanvasNestedBlock) => string;
+};
+export {};

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

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview 快捷入口显示工具 - 清洗图生卡入口标题并保持目标项去重。
+ * @author seadon
+ * @created 2026-06-22
+ */
+/**
+ * Removes repeated shortcut-container chrome from a candidate shortcut label.
+ * @param label - Raw OCR/model shortcut label.
+ * @returns Destination label, or an empty string when only container chrome remains.
+ */
+export declare function normalizeQuickLinkItemLabel(label: string): string;
+/**
+ * Checks whether a shortcut label is container chrome rather than a real destination.
+ * @param label - Candidate quick-link text.
+ * @returns True when the text should be hidden from the shortcut row.
+ */
+export declare function quickLinkLabelLooksLikeContainerChrome(label: string): boolean;
+/**
+ * Drops empty/chrome-only shortcuts and keeps one item per normalized destination.
+ * @param items - Candidate shortcut records.
+ * @param readLabel - Label reader for each candidate.
+ * @returns Records with cleaned labels and duplicate destinations removed.
+ */
+export declare function uniqueQuickLinkItems<T extends Record<string, unknown>>(items: T[], readLabel: (item: T, index: number) => string): T[];