@digitalsee-ai/rcs 2.0.4-beta9 → 2.0.5-beta1

package/dist/components/digitalsee/workflow/Nodes/DeclaredNode.d.ts

@@ -26,7 +26,6 @@ export declare function parseDescriptorTypeKey(type: string): {
  * 取代 13 个仅做 SuperBaseNode 包装的细瘦组件（Action/Trigger/Condition/Loop/...）。
  * 节点之间的差异由 CLASSIC_DESCRIPTORS 描述：
  * - className：驱动 *.less 中的节点变体样式
- * - fallbackIcon：data.icon 为空时的回退图标
  * - inputs / outputs / byProtocol：按 (type, protocol) 的静态端口声明
  *   （经 resolveNodeHandleConfigs 转为端口元数据：id + 位置 + 方向 + 约束）
  * - useNodePackagePorts：是否走 useNodePackagePorts 加载 schema 端口

package/dist/components/digitalsee/workflow/Nodes/SuperBaseNode.d.ts

@@ -23,8 +23,8 @@ export interface BaseNodeProps {
     id: string;
     data: NodeData;
     type?: NodeType;
+    saveType?: string;
     selected?: boolean;
-    fallbackIcon?: React.ReactNode;
     iconUri?: string;
     color?: string;
     inputs?: HandleConfig[];

package/dist/components/digitalsee/workflow/Nodes/components/NodeIcon.d.ts

@@ -0,0 +1,28 @@
+import { IconImageProps } from '../../design-system/IconImage';
+import { NodeType } from '../../types/Node';
+import { default as React } from 'react';
+interface NodeIconProps {
+    /** 容器基础类名（如 workflow-node-icon / node-config-icon），无 icon 时追加 no-icon */
+    className: string;
+    /** 图标地址；缺省或加载失败时按 nodeType 回退默认图标，无匹配类型时回退 name 首字符 */
+    icon?: string;
+    /** 无 icon 时的回退文案来源 */
+    name?: string;
+    /** 节点类型，用于在 icon 加载失败时展示对应类型的默认图标 */
+    nodeType?: NodeType | string;
+    /** 容器透传属性（如 data-category） */
+    containerProps?: IconImageProps['containerProps'];
+}
+/**
+ * @description 节点类型 → 加载失败 / 未配置图标时的默认图标映射。
+ *
+ * 远程图标通常指向公网 CDN，在专网或离线环境下不可达；此时按节点类型展示
+ * 对应的内置图标，避免统一退化成首字母占位，保留节点的类型辨识度。
+ */
+export declare const NODE_TYPE_FALLBACK_ICONS: Record<string, React.ReactNode>;
+/**
+ * @description 节点图标：有 icon 且可达时以图片渲染；缺省或加载失败时按 nodeType 回退默认图标，
+ * 无匹配类型时回退渲染 name 首字符。
+ */
+declare const NodeIcon: React.FC<NodeIconProps>;
+export default NodeIcon;

package/dist/components/digitalsee/workflow/Nodes/nodeTypeRegistry.d.ts

@@ -3,13 +3,11 @@ import { HandleConfig } from './SuperBaseNode';
 import { NodeType } from '../types/Node';
 import { resolveSwitchNodePackagePortSchema, SwitchNodePackageBranch } from '../utils/switchNodePackage';
 import { Node } from '@xyflow/react';
-import { default as React } from 'react';
 import { DipPortSchema } from '../api/dip';
 export type NodeLegacyData = Record<string, unknown> | undefined | null;
 export interface NodeTypeDescriptor {
     type: NodeType | string;
     className: string;
-    fallbackIcon: React.ReactNode;
     /** type 级默认输入端口声明（node.data.protocol 缺失或未命中 byProtocol 时使用） */
     inputs: NodePortSchema[];
     /** type 级默认输出端口声明 */
@@ -67,7 +65,7 @@ export interface RegisterNodeTypeDescriptorOptions {
  *
  * - 缺 nodeKey：console.warn 后返回 null，由调用方回退到 NodeType 经典描述符
  * - 同 id 重复注册视为幂等，不会重复触发 listeners
- * - dynamic 描述符继承 base 描述符的全部字段（className / fallbackIcon /
+ * - dynamic 描述符继承 base 描述符的全部字段（className /
  *   useNodePackagePorts / inputs / outputs / byProtocol），仅 metadata 不同
  */
 export declare function registerNodeTypeDescriptor(options: RegisterNodeTypeDescriptorOptions): string | null;

package/dist/components/digitalsee/workflow/NodesConfig/components/FormFieldRenderer/fields/TextField/index.d.ts

@@ -15,6 +15,7 @@ interface TextFieldProps extends IFieldSuperProps {
     lang?: CodeEditorLanguage;
     onFocus?: () => void;
     onBlur?: () => void;
+    required?: boolean;
 }
 export declare const TextField: (props: TextFieldProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/digitalsee/workflow/design-system/IconImage.d.ts

@@ -0,0 +1,30 @@
+import { default as React } from 'react';
+export interface IconImageProps {
+    /** 远程图标地址；为空或加载失败时展示降级占位。 */
+    src?: string | null;
+    /** 降级占位文案来源（取首字符大写）。 */
+    name?: string;
+    /** 自定义降级内容，优先于首字符占位。 */
+    fallback?: React.ReactNode;
+    /** 图片替代文本。 */
+    alt?: string;
+    /** 容器类名（如 workflow-node-icon / item-icon）。 */
+    className?: string;
+    /** 图片类名。 */
+    imgClassName?: string;
+    /** 容器透传属性（如 data-category）。 */
+    containerProps?: React.HTMLAttributes<HTMLDivElement> & Record<string, unknown>;
+    /** 容器行内样式。 */
+    style?: React.CSSProperties;
+}
+/**
+ * @description 统一图标渲染组件：远程图标可达时展示图片，不可达时降级为首字母占位。
+ *
+ * 相比直接使用 background-image，本组件基于 <img> 的 onError 事件判定失败，
+ * 可在专网 / 离线（无法访问公网 CDN）环境下稳定降级，不会出现空白图标位。
+ *
+ * @param {IconImageProps} props 图标地址、降级文案与容器样式。
+ * @returns {JSX.Element} 图标容器 JSX。
+ */
+declare const IconImage: React.FC<IconImageProps>;
+export default IconImage;

package/dist/components/digitalsee/workflow/design-system/index.d.ts

@@ -1,3 +1,4 @@
 export { type AiFlowNodeTestPanelProps, type AiFlowNodeTestStatus, default as AiFlowNodeTestPanel, } from './AiFlowNodeTestPanel';
 export { type AiFlowVariableNode, type AiFlowVariableSection, type AiFlowVariableTreeProps, type AiFlowVariableType, default as AiFlowVariableTree, } from './AiFlowVariableTree';
+export { default as IconImage, type IconImageProps, } from './IconImage';
 export { AI_FLOW_DESIGN_SYSTEM_VERSION, type AiFlowTokens, aiFlowCssVariables, aiFlowTokens, } from './tokens';

package/dist/components/digitalsee/workflow/hooks/useImageFallback.d.ts

@@ -0,0 +1,25 @@
+export interface UseImageFallbackResult {
+    /** true：应展示降级占位（无地址 / 已失败 / 超时 / 浏览器离线）。 */
+    failed: boolean;
+    /** true：远程图片仍在加载中。 */
+    loading: boolean;
+    /** 供 <img> 的 key 使用：网络恢复后自增，强制浏览器重新发起请求。 */
+    imageKey: string;
+    /** <img> 的 onLoad 回调。 */
+    onLoad: () => void;
+    /** <img> 的 onError 回调。 */
+    onError: () => void;
+}
+/**
+ * @description 远程图片降级 Hook。
+ *
+ * 处理专网 / 离线环境下远程图标不可用的场景：
+ * - 浏览器离线时直接跳过请求，立即降级，避免请求悬挂；
+ * - 加载失败（DNS 失败 / 404 / 防火墙拦截）时降级，并缓存失败地址避免重复请求；
+ * - 加载超时（请求悬挂）时降级，仅影响当前实例，不污染全局缓存；
+ * - 网络恢复（online 事件）后自动重试，恢复真实图标。
+ *
+ * @param {string | null | undefined} src 远程图片地址。
+ * @returns {UseImageFallbackResult} 降级状态与事件回调。
+ */
+export declare function useImageFallback(src?: string | null): UseImageFallbackResult;

package/dist/components/digitalsee/workflow/index.d.ts

@@ -107,6 +107,7 @@ export { NodeStatus, NodeType } from './enums/node';
 export { WorkflowOpStatus } from './enums/workflow';
 export { default as HandleFactory } from './Handles/HandleFactory';
 export { useCanvasLayout } from './hooks/useCanvasLayout';
+export { useImageFallback } from './hooks/useImageFallback';
 export { useUndo } from './hooks/useUndo';
 export { useWorkflow } from './hooks/useWorkflow';
 export { default as AiFlowNodeStatusBadge, type NodeStatusBadgeProps as AiFlowNodeStatusBadgeProps, } from './Nodes/components/NodeStatusBadge';
@@ -116,6 +117,7 @@ export type { CanvasAPI, CanvasEngineConfig, CanvasNavigate, DeepPartial, Histor
 export * from './types/flowVersion';
 export * from './types/Node';
 export * from './types/Workflow';
+export { clearFailedImages, configureImageFallback, type ImageFallbackConfig, isImageFailed, } from './utils/imageFallback';
 export type { LocaleType as WorkflowLocale, TranslateFn as WorkflowTranslateFn, } from '../../../locales';
 export { createTranslator } from '../../../locales';
 export { DigitalseeWorkFlow, defaultCanvasEngineConfig, mergeConfig };

package/dist/components/digitalsee/workflow/utils/imageFallback.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 远程图标降级能力（内网 / 离线 / 无法访问公网场景）。
+ *
+ * 背景：节点、动作、分类的图标均由后端配置下发，URL 通常指向公网 CDN。
+ * 在专网、离线或防火墙拦截的环境下这些图片无法加载，若不做处理会出现：
+ * - CSS background-image 静默失败：图标位置变成空白方块，没有任何提示；
+ * - <img> 加载失败：显示浏览器的破图占位，视觉上明显异常。
+ *
+ * 这里维护一份「已失败 URL」的全局缓存，配合 useImageFallback 使用：
+ * 1. 同一 URL 失败后不再重复发起请求，避免大量节点反复请求不可达地址；
+ * 2. 监听 online 事件，网络恢复后清空缓存并触发重试，图标可自动恢复；
+ * 3. 支持配置全局降级图标（内网可达的本地资源），优先于首字母占位。
+ */
+/** 远程图标加载超时默认值（毫秒）：超过该时长仍未完成即视为失败并降级。 */
+export declare const DEFAULT_IMAGE_LOAD_TIMEOUT = 8000;
+export interface ImageFallbackConfig {
+    /**
+     * 全局降级图标地址。
+     * 建议填写内网可达的本地资源或 data URI，命中后优先于首字母占位展示。
+     */
+    fallbackIconUrl?: string;
+    /** 远程图标加载超时（毫秒），0 表示不启用超时降级。 */
+    timeout?: number;
+    /** 浏览器判定离线时是否直接跳过请求（默认 true，避免请求悬挂）。 */
+    skipWhenOffline?: boolean;
+}
+type ResolvedImageFallbackConfig = Required<ImageFallbackConfig>;
+/**
+ * @description 更新全局降级配置，建议在应用初始化时调用一次。
+ * @param {Partial<ImageFallbackConfig>} next 需要覆盖的配置项。
+ */
+export declare function configureImageFallback(next: Partial<ImageFallbackConfig>): void;
+/**
+ * @description 读取当前生效的降级配置。
+ * @returns {ResolvedImageFallbackConfig} 当前配置快照。
+ */
+export declare function getImageFallbackConfig(): ResolvedImageFallbackConfig;
+/**
+ * @description 订阅配置变更，返回取消订阅函数。
+ * @param {() => void} listener 配置变更回调。
+ * @returns {() => void} 取消订阅函数。
+ */
+export declare function subscribeImageFallbackConfig(listener: () => void): () => void;
+/**
+ * @description 订阅网络恢复事件（浏览器重新联网），返回取消订阅函数。
+ * @param {() => void} listener 网络恢复回调。
+ * @returns {() => void} 取消订阅函数。
+ */
+export declare function subscribeImageRecovery(listener: () => void): () => void;
+/**
+ * @description 浏览器是否处于在线状态；SSR / 不支持 navigator.onLine 时按在线处理。
+ * @returns {boolean} 是否在线。
+ */
+export declare function isBrowserOnline(): boolean;
+/**
+ * @description 判断某个远程图片是否已被判定为加载失败。
+ * @param {string | null | undefined} src 图片地址。
+ * @returns {boolean} 是否已失败（无地址视为不可用）。
+ */
+export declare function isImageFailed(src?: string | null): boolean;
+/**
+ * @description 标记某个远程图片加载失败，后续同地址的实例不再重复请求。
+ * @param {string | null | undefined} src 图片地址。
+ */
+export declare function markImageFailed(src?: string | null): void;
+/**
+ * @description 清空失败缓存（网络恢复或宿主主动重试时调用）。
+ */
+export declare function clearFailedImages(): void;
+/**
+ * @description 读取当前失败缓存内容，便于排查与测试。
+ * @returns {string[]} 已失败的 URL 列表。
+ */
+export declare function getFailedImageUrls(): string[];
+export {};

package/dist/components/dynamic-form/components/ValueModeWrapper/index.d.ts

@@ -84,6 +84,8 @@ export interface ValueModeWrapperProps {
      * 代码编辑器语言（json / javascript）
      */
     lang?: CodeEditorLanguage;
+    /** 是否必填 */
+    required?: boolean;
 }
 export declare const ValueModeWrapper: React.FC<ValueModeWrapperProps>;
 export default ValueModeWrapper;

package/dist/components/dynamic-form/types/field-component.d.ts

@@ -66,6 +66,8 @@ export interface FieldComponentProps<T extends FieldDef = FieldDef, K = unknown>
     onChange?: (value: unknown) => void;
     /** 字段 ID（由 Form.Item 注入） */
     id?: string;
+    /** 是否必填 */
+    required?: boolean;
 }
 /**
  * 字段组件元数据

package/dist/{index-BCflRiZo.mjs → index-CNiN54LX.mjs}

@@ -1,5 +1,5 @@
 import { jsx as t, jsxs as _ } from "react/jsx-runtime";
-import { D as L, V as T, e as E, i as P, t as l, f as R, d as O } from "./index-e5FvUBY-.mjs";
+import { D as L, V as T, e as E, i as P, t as l, f as R, d as O } from "./index-DpaoO6Cc.mjs";
 import { useEventEmitter as B, useReactive as A, useSize as W } from "ahooks";
 import { FormattedMessage as b } from "react-intl";
 import { CloseCircleFilled as H, CheckCircleFilled as G } from "@ant-design/icons";
@@ -285,4 +285,4 @@ function $e(e) {
 export {
   $e as default
 };
-//# sourceMappingURL=index-BCflRiZo.mjs.map
+//# sourceMappingURL=index-CNiN54LX.mjs.map