@fses/workbench-app 0.1.0

package/dist/internal/personal-workbench/lib/workbenchAttachmentUpload.d.ts

@@ -0,0 +1,47 @@
+export interface WorkbenchAttachmentUploadResult {
+    fileId: string;
+    fileName: string;
+    downloadUrl?: string;
+    url?: string;
+}
+export interface WorkbenchChatAttachmentUploadPayload {
+    downloadUrl?: string;
+    file?: File;
+    fileId?: string;
+    fileName: string;
+    mimeType?: string;
+    type?: 'file' | 'image';
+}
+export interface WorkbenchPromptAttachmentReference {
+    id?: string;
+    name: string;
+    type: string;
+    url?: string;
+}
+/**
+ * 解析聊天附件引用；本地文件先上传，已有引用则直接复用。
+ * @param input - 聊天附件事件载荷和运行态身份请求头。
+ * @returns 可传给工作台问答流的附件引用；无法解析时返回 null。
+ */
+export declare function resolveWorkbenchChatAttachmentReference(input: {
+    headers?: Record<string, string>;
+    payload: WorkbenchChatAttachmentUploadPayload;
+}): Promise<WorkbenchPromptAttachmentReference | null>;
+/**
+ * 上传工作台聊天附件，返回 SP 可读取的附件引用。
+ * @param input - 附件文件和运行态身份请求头。
+ * @returns 上传后的附件 ID、名称和下载地址。
+ */
+export declare function uploadWorkbenchChatAttachment(input: {
+    file: File;
+    headers?: Record<string, string>;
+}): Promise<WorkbenchAttachmentUploadResult>;
+/**
+ * 上传业务行动图片附件，保留旧调用名兼容已有业务行动链路。
+ * @param input - 图片文件和运行态身份请求头。
+ * @returns 上传后的附件 ID、名称和下载地址。
+ */
+export declare function uploadWorkbenchDataActionImageAttachment(input: {
+    file: File;
+    headers?: Record<string, string>;
+}): Promise<WorkbenchAttachmentUploadResult>;

package/dist/internal/personal-workbench/lib/workbenchAutoRefreshSession.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview 工作台自动刷新会话锁 - 防止同一页面会话内同一数据绑定反复触发 query
+ * @author seadon
+ * @created 2026-05-14
+ */
+export interface WorkbenchAutoRefreshIdentity {
+    bindingId?: string;
+    refreshApi?: string;
+    renderer?: string;
+    roleId?: string;
+}
+/**
+ * Claims the automatic refresh slot for one binding in the current page session.
+ * @param identity - Data binding identity for the pending automatic refresh.
+ * @returns True only for the first automatic refresh attempt for this binding.
+ */
+export declare function claimWorkbenchAutoRefresh(identity: WorkbenchAutoRefreshIdentity): boolean;
+/**
+ * Resets automatic refresh claims for focused regression tests.
+ */
+export declare function resetWorkbenchAutoRefreshClaims(): void;

package/dist/internal/personal-workbench/lib/workbenchBusinessGapDiagnostics.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview 工作台业务口径缺口诊断工具 - 将向量召回诊断压缩成卡片和徽标可展示的行动提示
+ * @author seadon
+ * @created 2026-05-13
+ */
+export interface BusinessGapDiagnosticSummaryInput {
+    message?: unknown;
+    fallback?: string;
+    diagnostics?: unknown;
+}
+/**
+ * Builds one concise diagnostic sentence for a business-mouthpiece gap.
+ * @param input - Business message and data-binding diagnostics.
+ * @returns User-facing diagnostic summary with fallback message first.
+ */
+export declare function businessGapDiagnosticSummary(input: BusinessGapDiagnosticSummaryInput): string;

package/dist/internal/personal-workbench/lib/workbenchCanvasBusinessGapChecklist.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @fileoverview 工作台业务口径检查清单 - 纯函数模块
+ * 从 WorkbenchCanvas.vue 提取的业务口径检查清单构建、状态标签、校验相关纯函数。
+ * @author seadon
+ * @created 2026-05-31
+ */
+import type { MaterializedBlock } from '@fses/workbench-app/types';
+/** 业务口径检查列表项的类型（与 WorkbenchCanvas.vue 中的类型一致） */
+export type BusinessGapChecklistItem = {
+    id: string;
+    cardId: string;
+    title: string;
+    detail: string;
+    bindingId: string;
+    reason: string;
+    location: 'top_level' | 'nested';
+    status: 'pending' | 'running' | 'ready' | 'error';
+};
+/** 批量提交业务口径时传递给上层的真实问数请求项。 */
+export type BusinessGapWordingSubmission = {
+    cardId: string;
+    bindingId: string;
+    title: string;
+    businessWording: string;
+    location: BusinessGapChecklistItem['location'];
+    fieldMapping?: Record<string, unknown>;
+    fieldLabels?: Record<string, unknown>;
+    cardConfig?: Record<string, unknown>;
+    selectedConfig?: Record<string, unknown>;
+};
+/** User-facing supplement examples that map screenshot cards to runtime query clues. */
+export declare const BUSINESS_GAP_WORDING_REQUIREMENT = "\u76F4\u63A5\u7528\u81EA\u7136\u8BED\u8A00\u8BF4\u660E\u8FD9\u5F20\u5361\u8981\u67E5\u4EC0\u4E48\uFF0C\u4F8B\u5982\u201C\u67E5\u4E00\u4E0B\u672C\u6708\u603B\u652F\u51FA\u91D1\u989D\u201D\uFF1B\u77E5\u9053\u6307\u6807\u3001\u8868\u540D\u3001\u5B57\u6BB5\u6216\u7CFB\u7EDF\u65F6\u53EF\u4EE5\u9644\u5728\u540E\u9762\u3002";
+/**
+ * 解析顶级卡片的业务口径生命周期状态。
+ * @param block - 画布卡片。
+ * @returns 归一化后的检查清单状态。
+ */
+export declare function blockBusinessGapStatus(block: MaterializedBlock): BusinessGapChecklistItem['status'];
+/**
+ * 解析嵌套预览的业务口径生命周期状态。
+ * @param nestedBlock - 自定义画布嵌套预览记录。
+ * @returns 归一化后的检查清单状态。
+ */
+export declare function nestedBusinessGapStatus(nestedBlock: Record<string, unknown>): BusinessGapChecklistItem['status'];
+/**
+ * 构建嵌套业务口径行的诊断文本。
+ * @param nestedBlock - 自定义画布嵌套预览记录。
+ * @returns 紧凑诊断文本。
+ */
+export declare function nestedBusinessGapDiagnostics(nestedBlock: Record<string, unknown>): string;
+/**
+ * 解析嵌套业务口径行的后端原因码。
+ * @param nestedBlock - 自定义画布嵌套预览记录。
+ * @returns 后端原因码。
+ */
+export declare function nestedBusinessGapReason(nestedBlock: Record<string, unknown>): string;
+/**
+ * 检查嵌套预览是否属于当前父卡片。
+ * @param nestedBlock - 嵌套预览记录。
+ * @param parentId - 当前父卡片 ID。
+ * @returns 无归属或归属匹配时返回 true。
+ */
+export declare function nestedRecordBelongsToParent(nestedBlock: Record<string, unknown>, parentId: string): boolean;
+/**
+ * 收集顶级和嵌套业务口径行，构建非侵入式检查清单。
+ * @param blocks - 当前渲染的画布卡片。
+ * @param sortFn - 布局排序函数（由组件注入）。
+ * @returns 排序后的检查清单行。
+ */
+export declare function buildBusinessGapItems(blocks: MaterializedBlock[], sortFn: (blocks: MaterializedBlock[]) => MaterializedBlock[]): BusinessGapChecklistItem[];
+/**
+ * 构建业务口径措辞输入的帮助文本。
+ * @param item - 正在编辑的检查清单项。
+ * @returns 带示例的输入引导文本。
+ */
+export declare function businessGapWordingHelp(item: BusinessGapChecklistItem): string;
+/**
+ * 根据待补清单项生成可提交的自然语言问数口径。
+ * @param item - 待补业务口径项。
+ * @returns 可用于真实问数刷新接口的补充口径。
+ */
+export declare function suggestedBusinessGapWording(item: BusinessGapChecklistItem): string;
+/**
+ * 将待补清单批量转换为真实问数补充请求。
+ * @param items - 当前待补业务口径清单。
+ * @returns 已过滤无效项后的批量问数请求。
+ */
+export declare function buildBusinessGapWordingSubmissions(items: BusinessGapChecklistItem[]): BusinessGapWordingSubmission[];
+/**
+ * 检查补充口径措辞是否足够具体以启动查询。
+ * @param value - 用户输入的措辞。
+ * @returns 措辞不为空且包含业务信号词时返回 true。
+ */
+export declare function validBusinessWording(value: string): boolean;
+/**
+ * 返回业务口径检查清单行的紧凑状态标签。
+ * @param item - 检查清单项。
+ * @returns 中文状态标签。
+ */
+export declare function businessGapItemStatusLabel(item: BusinessGapChecklistItem): string;
+/**
+ * 返回业务口径检查清单状态的色调类名。
+ * @param item - 检查清单项。
+ * @returns Tailwind 类名字符串。
+ */
+export declare function businessGapItemStatusClass(item: BusinessGapChecklistItem): string;

package/dist/internal/personal-workbench/lib/workbenchCanvasClassification.d.ts

@@ -0,0 +1,119 @@
+/**
+ * @fileoverview 工作台卡片分类与尺寸推断 - 纯函数模块
+ * 从 WorkbenchCanvas.vue 提取的卡片类型判断、尺寸推断和共享工具函数。
+ * @author seadon
+ * @created 2026-05-31
+ */
+import type { CardSizePreset } from '@fses/workbench-app/canvas/api/types';
+import type { MaterializedBlock } from '@fses/workbench-app/types';
+/**
+ * 读取块布局数值，非数字时返回 fallback。
+ * @param value - 布局值（可能是数字或字符串）。
+ * @param fallback - 非数字时的默认值。
+ * @returns 解析后的数值。
+ */
+export declare function numericLayoutValue(value: unknown, fallback?: number): number;
+/**
+ * 读取块 textMeta 中的指定 key 值。
+ * @param block - 物化卡片。
+ * @param key - textMeta 中的键名。
+ * @returns 字符串值，不存在时返回空字符串。
+ */
+export declare function textMetaValue(block: MaterializedBlock, key: string): string;
+/**
+ * 将未知值归一化为可读的对象记录。
+ * @param value - 未知来源值。
+ * @returns 对象记录，非对象时返回空对象。
+ */
+export declare function recordValue(value: unknown): Record<string, unknown>;
+/**
+ * 从记录中读取已修剪的文本字段。
+ * @param record - 源对象记录。
+ * @param key - 字段名。
+ * @returns 修剪后的字符串，不存在时返回空字符串。
+ */
+export declare function textRecordValue(record: Record<string, unknown>, key: string): string;
+/**
+ * 将卡片渲染数据读取为安全记录。
+ * @param block - 画布卡片。
+ * @returns 卡片数据记录或空对象。
+ */
+export declare function blockDataRecord(block: MaterializedBlock): Record<string, unknown>;
+/**
+ * 为重复图片占位符检测构建稳定的显示标题。
+ * @param block - 候选物化卡片。
+ * @returns 修剪后的业务标题。
+ */
+export declare function blockDisplayTitle(block: MaterializedBlock): string;
+/**
+ * 判断卡片是否为分类导航卡。
+ * @param block - 物化卡片。
+ * @returns 是否为分类导航卡。
+ */
+export declare function isCategoryNavigatorCard(block: MaterializedBlock): boolean;
+/**
+ * 判断卡片是否为全量校验分组卡。
+ * @param block - 物化卡片。
+ * @returns 是否为全量校验分组卡。
+ */
+export declare function isFullValidationGroupCard(block: MaterializedBlock): boolean;
+/**
+ * 判断卡片是否为 Banner 横幅卡。
+ * @param block - 物化卡片。
+ * @returns 是否为 Banner 卡。
+ */
+export declare function isWorkbenchBannerBlock(block: MaterializedBlock): boolean;
+/**
+ * 判断卡片是否为组织型分组卡（包含分类导航和全量校验分组）。
+ * @param block - 物化卡片。
+ * @returns 是否为组织型分组卡。
+ */
+export declare function isWorkbenchGroupBlock(block: MaterializedBlock): boolean;
+/**
+ * 获取组织卡片的固定尺寸（banner 或 group）。
+ * @param block - 物化卡片。
+ * @returns 固定尺寸或 null（非组织卡片时）。
+ */
+export declare function fixedWorkbenchOrganizationSize(block: MaterializedBlock): {
+    readonly w: 100;
+    readonly h: 16;
+} | {
+    readonly w: 100;
+    readonly h: 6;
+};
+/**
+ * 获取卡片的能力 ID（capabilityId 或 source.resourceKey）。
+ * @param block - 物化卡片。
+ * @returns 能力 ID 字符串。
+ */
+export declare function capabilityIdForBlock(block: MaterializedBlock): string;
+/**
+ * 从 layoutBasis 元数据推断卡片预设尺寸。
+ * @param block - 物化卡片。
+ * @returns 预设尺寸或 null。
+ */
+export declare function layoutBasisSizeForBlock(block: MaterializedBlock): CardSizePreset | null;
+/**
+ * 根据卡片属性推断预设尺寸（不依赖注册表）。
+ * @param block - 物化卡片。
+ * @returns 推断的预设尺寸。
+ */
+export declare function inferredPresetForBlock(block: MaterializedBlock): CardSizePreset;
+/**
+ * 获取卡片的综合预设尺寸（优先 textMeta > layoutBasis > 注册表 > 推断）。
+ * @param block - 物化卡片。
+ * @returns 预设尺寸。
+ */
+export declare function presetForBlock(block: MaterializedBlock): CardSizePreset | null;
+/**
+ * 判断卡片是否为手动替换占位卡。
+ * @param block - 物化卡片。
+ * @returns 是否为占位卡。
+ */
+export declare function isManualReplacementPlaceholderBlock(block: MaterializedBlock): boolean;
+/**
+ * 判断卡片是否为组织型卡片（banner、group、categoryNavigator 等）。
+ * @param block - 物化卡片。
+ * @returns 是否为组织型卡片。
+ */
+export declare function isWorkbenchOrganizationLikeBlock(block: MaterializedBlock): boolean;

package/dist/internal/personal-workbench/lib/workbenchCanvasDiagnostics.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @fileoverview 工作台数据绑定诊断与业务口径检测 - 纯函数模块
+ * 从 WorkbenchCanvas.vue 提取的数据绑定状态读取、业务口径缺口检测相关纯函数。
+ * @author seadon
+ * @created 2026-05-31
+ */
+import type { MaterializedBlock } from '@fses/workbench-app/types';
+/** 业务口径检查列表项的类型（与 WorkbenchCanvas.vue 中的类型一致） */
+type BusinessGapChecklistStatus = 'pending' | 'running' | 'ready' | 'error';
+/**
+ * 读取物化卡片的归一化数据绑定元数据。
+ * @param block - 画布卡片。
+ * @returns 数据绑定记录或空对象。
+ */
+export declare function blockDataBindingRecord(block: MaterializedBlock): Record<string, unknown>;
+/**
+ * 解析用于真实浏览器诊断的稳定数据绑定 ID。
+ * @param block - 画布卡片。
+ * @returns 绑定 ID，未绑定时返回空字符串。
+ */
+export declare function blockDataBindingId(block: MaterializedBlock): string;
+/**
+ * 解析用于真实浏览器诊断的稳定数据绑定状态。
+ * @param block - 画布卡片。
+ * @returns 绑定状态或卡片生命周期状态。
+ */
+export declare function blockDataBindingStatus(block: MaterializedBlock): string;
+/**
+ * 解析用于浏览器语义诊断的卡片类型。
+ * @param block - 画布卡片。
+ * @returns V2 类型、渲染器子类型或 block 子类型。
+ */
+export declare function blockKindForDiagnostics(block: MaterializedBlock): string;
+/**
+ * 解析用于浏览器语义诊断的渲染器键。
+ * @param block - 画布卡片。
+ * @returns 一级渲染器键或元数据中的键。
+ */
+export declare function blockRendererKeyForDiagnostics(block: MaterializedBlock): string;
+/**
+ * 解析用于浏览器 setData 诊断的数据形状。
+ * @param block - 画布卡片。
+ * @returns 卡片元数据或渲染数据中的数据形状。
+ */
+export declare function blockDataShapeForDiagnostics(block: MaterializedBlock): string;
+/**
+ * Checks whether an image-composed card already has renderer data from the uploaded screenshot.
+ * @param block - Canvas card.
+ * @returns True when query lifecycle chrome should not cover the reconstructed card body.
+ */
+export declare function imageComposeHasRenderableSnapshot(block: MaterializedBlock): boolean;
+/**
+ * Checks whether a top-level card can be filled by a real query result.
+ * @param block - Canvas card.
+ * @returns True when the card is a data-bearing leaf.
+ */
+export declare function blockIsActionableDataBearing(block: MaterializedBlock): boolean;
+/**
+ * Checks whether a nested customCanvas preview can be filled by a real query result.
+ * @param nestedBlock - Nested preview record.
+ * @returns True when the nested row is a data-bearing leaf.
+ */
+export declare function nestedRecordIsActionableDataBearing(nestedBlock: Record<string, unknown>): boolean;
+/**
+ * 检查卡片是否代表可操作的业务口径缺口。
+ * @param block - 画布卡片。
+ * @returns 当后端人工干预元数据存在时返回 true。
+ */
+export declare function blockNeedsBusinessGap(block: MaterializedBlock): boolean;
+/**
+ * 为浏览器构建结构化的业务口径诊断文本。
+ * @param block - 画布卡片。
+ * @returns 可用的候选/搜索/分数差距文本。
+ */
+export declare function blockBusinessGapDiagnostics(block: MaterializedBlock): string;
+/**
+ * 解析业务口径诊断的人工干预原因。
+ * @param block - 画布卡片。
+ * @returns 用于浏览器制品的稳定后端原因代码。
+ */
+export declare function blockBusinessGapReason(block: MaterializedBlock): string;
+/**
+ * 将后端诊断文本转换为面向业务的简洁措辞。
+ * @param detail - 来自数据绑定元数据的原始诊断文本。
+ * @returns 产品友好的文本，使下一步操作清晰明了。
+ */
+export declare function businessGapDisplayDetail(detail: string): string;
+/**
+ * 检查嵌套预览是否带有人工干预元数据。
+ * @param nestedBlock - 自定义画布嵌套预览记录。
+ * @returns 嵌套行在查询可信前需要业务措辞时返回 true。
+ */
+export declare function nestedRecordNeedsBusinessGap(nestedBlock: Record<string, unknown>): boolean;
+/**
+ * 为检查列表行读取简洁的数据绑定生命周期状态。
+ * @param status - 来自渲染器数据、绑定元数据或卡片状态的原始状态。
+ * @returns 可见检查列表使用的归一化状态。
+ */
+export declare function normalizeBusinessGapStatus(status: string): BusinessGapChecklistStatus;
+export {};

package/dist/internal/personal-workbench/lib/workbenchCanvasImageCardVisual.d.ts

@@ -0,0 +1,168 @@
+/**
+ * @fileoverview 图片卡片身份识别链 + 视觉分类纯函数模块
+ *   从 WorkbenchCanvas.vue 提取，负责判断卡片是否属于图片合成源（身份识别链）
+ *   以及基于文本/元数据对图片卡片进行视觉语义分类（页头、风险总览、告警排名等）。
+ * @author seadon
+ * @created 2026-05-31
+ */
+import type { MaterializedBlock } from '@fses/workbench-app/types';
+/**
+ * Checks whether an image customCanvas card is a standalone quick-entry strip.
+ * @param block - Candidate image-composed card.
+ * @returns True when the card must not be promoted into a tall reference composite panel.
+ */
+export declare function imageCustomCanvasLooksLikeStandaloneQuickLinks(block: MaterializedBlock): boolean;
+export declare function roundLayoutValue(value: number): number;
+/**
+ * 从 block.source.params 中按 key 取字符串值
+ * @param block - 物化卡片对象
+ * @param key - 要读取的参数键名
+ * @returns 参数值字符串，不存在或非字符串时返回空串
+ */
+export declare function sourceParamValue(block: MaterializedBlock, key: string): string;
+/**
+ * 判断给定值是否为 image 合成源标识字符串（不区分大小写、忽略首尾空白）
+ * @param value - 待判断的值
+ * @returns 是否为 image 合成源标识
+ */
+export declare function isImageComposeSourceValue(value: unknown): boolean;
+/**
+ * 递归检查 record 中是否含有指向 image 合成源的标识字段
+ * @param value - 待检查的对象（通常为 meta / source / data 等 record 结构）
+ * @returns 只要存在任一合成源字段命中即返回 true
+ */
+export declare function recordHasImageComposeSource(value: unknown): boolean;
+/**
+ * 提取卡片的合成源标识（优先级：meta.composeSource > meta.cardDataSource > source.params.source）
+ * @param block - 物化卡片对象
+ * @returns 合成源字符串，无匹配时返回空串
+ */
+export declare function blockComposeSource(block: MaterializedBlock): string;
+/**
+ * 解析卡片的 layoutBasis 并将其映射到当前画布列数下的逻辑坐标盒
+ * @param block - 物化卡片对象
+ * @returns 包含 x/y/w/hasExplicitX/hasExplicitY 的坐标盒对象，basis 无效时返回 null
+ */
+export declare function imageLayoutBasisBox(block: MaterializedBlock): {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    hasExplicitX: boolean;
+    hasExplicitY: boolean;
+};
+/**
+ * 判断卡片是否具备图片合成源的身份特征
+ *   检查维度：blockComposeSource / meta / source / data / dataBinding / resourceKey / id 模式
+ * @param block - 物化卡片对象
+ * @returns 是否为图片合成源卡片
+ */
+export declare function imageComposeSourceOrigin(block: MaterializedBlock): boolean;
+/**
+ * 判断卡片是否为图片合成画布卡片（当前与 imageComposeSourceOrigin 语义等价）
+ * @param block - 物化卡片对象
+ * @returns 是否为画布卡片
+ */
+export declare function imageComposeCanvasCard(block: MaterializedBlock): boolean;
+/**
+ * 判断卡片是否为从嵌套保存中恢复的"仅展示"图片卡片
+ *   recoveredFromNestedBadSave === true 的卡片不算仅展示卡片
+ * @param block - 物化卡片对象
+ * @returns 是否为恢复的仅展示卡片
+ */
+export declare function imageRecoveredDisplayOnlyBlock(block: MaterializedBlock): boolean;
+/**
+ * 判断图片卡片是否在视觉上看起来像页面顶部标题头
+ *   基于 meta 显式身份标识或文本关键词匹配
+ * @param block - 物化卡片对象
+ * @returns 是否为页头样式的卡片
+ */
+export declare function imageCustomCanvasLooksLikePageHeader(block: MaterializedBlock): boolean;
+/**
+ * 检查卡片是否具有显式的页头身份标识（resourceKey / capabilityId 匹配页头模式）
+ * @param block - 物化卡片对象
+ * @returns 是否具有显式页头身份
+ */
+export declare function imageCustomCanvasHasExplicitPageHeaderIdentity(block: MaterializedBlock): boolean;
+/**
+ * 判断卡片标题是否为风险总览/风险概览类型的标题文本
+ * @param block - 物化卡片对象
+ * @returns 标题是否匹配风险总览模式
+ */
+export declare function imageCustomCanvasLooksLikeRiskSummaryTitle(block: MaterializedBlock): boolean;
+/**
+ * 提取图片卡片的直接文本内容（标题、副标题、叙事文本、元素文本等聚合）
+ * @param block - 物化卡片对象
+ * @returns 拼接后的文本串
+ */
+export declare function imageCustomCanvasDirectText(block: MaterializedBlock): string;
+/**
+ * 判断文本中是否包含董事长/高管风险上下文关键词
+ * @param text - 待检测文本
+ * @returns 是否包含高管风险上下文关键词
+ */
+export declare function imageCustomCanvasHasChairmanRiskContext(text: string): boolean;
+/**
+ * 判断卡片是否为有效的业务摘要带（businessSummaryBand）且包含高管风险上下文
+ * @param block - 物化卡片对象
+ * @returns 是否为有效业务摘要带卡片
+ */
+export declare function isImageEffectiveBusinessSummaryBandBlock(block: MaterializedBlock): boolean;
+/**
+ * 判断卡片是否为图片合成页头横幅（header banner）
+ *   检查维度：visual.themeId / v2.appearance.themeId / 标题关键词 / 页头视觉分类
+ * @param block - 物化卡片对象
+ * @returns 是否为页头横幅卡片
+ */
+export declare function isImageHeaderBannerBlock(block: MaterializedBlock): boolean;
+/**
+ * Checks whether an uploaded-image customCanvas card is only structural page chrome.
+ * @param block - Candidate uploaded-image card.
+ * @returns True when the card should reserve layout space but not paint a business-card shell or query status.
+ */
+export declare function isImageStructureOnlyPageHeaderBlock(block: MaterializedBlock): boolean;
+/**
+ * 判断卡片是否为业务摘要带卡片（当前与 isImageEffectiveBusinessSummaryBandBlock 等价）
+ * @param block - 物化卡片对象
+ * @returns 是否为业务摘要带卡片
+ */
+export declare function isImageBusinessSummaryBandBlock(block: MaterializedBlock): boolean;
+/**
+ * 判断卡片是否为参考复合卡片（基于文本关键词匹配经营健康、雷达、偏差等业务语义）
+ * @param block - 物化卡片对象
+ * @returns 是否为参考复合卡片
+ */
+export declare function isImageReferenceCompositeBlock(block: MaterializedBlock): boolean;
+/**
+ * 基于卡片文本内容推断参考复合卡片的具体业务类型（kind）
+ *   返回值与 IMAGE_COMPOSE_REFERENCE_MIN_LOGICAL_ROWS 中的键名对应
+ * @param block - 物化卡片对象
+ * @returns 业务类型字符串，无法识别时返回空串
+ */
+export declare function imageReferenceCompositeKind(block: MaterializedBlock): "" | "infrastructureOps" | "securityGovernance" | "digitalProject" | "assetCost" | "riskSummary" | "operationHealth" | "healthRadar" | "deviation" | "executiveTodo" | "operationEfficiency";
+/**
+ * 对参考复合卡片进行高度归一化：当卡片未锚定且存在推荐最小行数时，补齐 layout.h / layout.minH
+ * @param block - 物化卡片对象
+ * @param hasAnchor - 外部注入的锚定判断函数，用于解耦对画布布局状态的依赖
+ * @returns 高度归一化后的卡片对象（浅拷贝），无需调整时原样返回
+ */
+export declare function normalizeImageReferenceCompositeHeight(block: MaterializedBlock, hasAnchor: (block: MaterializedBlock) => boolean): MaterializedBlock;
+/**
+ * 判断卡片是否为告警排名类卡片（基于 shape / rendererKey 以及告警关键词）
+ * @param block - 物化卡片对象
+ * @returns 是否为告警排名卡片
+ */
+export declare function isImageAlertRankingCard(block: MaterializedBlock): boolean;
+/**
+ * 判断卡片是否为指标摘要类卡片（metricSummary / metric / metricStrip）
+ * @param block - 物化卡片对象
+ * @returns 是否为指标摘要卡片
+ */
+export declare function isImageMetricSummaryCard(block: MaterializedBlock): boolean;
+/**
+ * 判断卡片是否为需要特殊渲染装饰的画布卡片
+ *   综合页头横幅、业务摘要带、参考复合卡片、告警排名、指标摘要五类判断
+ * @param block - 物化卡片对象
+ * @returns 是否为带装饰渲染的画布卡片
+ */
+export declare function isImageCanvasChromeOnlyBlock(block: MaterializedBlock): boolean;