@digitalsee-ai/rcs 1.1.2 → 1.1.4

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

@@ -0,0 +1,48 @@
+import { PortConnectionValidationResult } from './portConnectionValidator';
+import { TranslateFn } from '../../../../locales';
+/** 供选择器、自动连线和已有边检查复用的 connectable 界面文案。 */
+export declare const CONNECTABLE_UI_MESSAGE_IDS: {
+    readonly categoryUnavailable: "link.flow.connectable.category_unavailable";
+    readonly connectorUnavailable: "link.flow.connectable.connector_unavailable";
+    readonly actionUnavailable: "link.flow.connectable.action_unavailable";
+    readonly loadFailed: "link.flow.connectable.load_failed";
+    readonly noCompatibleNodes: "link.flow.connectable.no_compatible_nodes";
+    readonly noCompatibleInput: "link.flow.connectable.no_compatible_input";
+    readonly noCompatibleOutput: "link.flow.connectable.no_compatible_output";
+    readonly noBidirectionalCompatiblePort: "link.flow.connectable.no_bidirectional_compatible_port";
+    readonly schemaUnavailable: "link.flow.connectable.schema_unavailable";
+    readonly existingEdgeInvalid: "link.flow.connectable.existing_edge_invalid";
+};
+/**
+ * 端口校验错误码与 RCS 内置文案的唯一映射。
+ *
+ * 使用 `satisfies` 保证校验器新增 code 时这里会产生类型错误，避免界面静默回退成中文
+ * `reason`。`reason` 仍保留给未知后端规则或版本不一致场景作运行时兜底。
+ */
+export declare const PORT_CONNECTION_VALIDATION_MESSAGE_IDS: {
+    readonly SOURCE_NODE_NOT_FOUND: "link.flow.connectable.validation.source_node_not_found";
+    readonly TARGET_NODE_NOT_FOUND: "link.flow.connectable.validation.target_node_not_found";
+    readonly SOURCE_PORT_NOT_FOUND: "link.flow.connectable.validation.source_port_not_found";
+    readonly TARGET_PORT_NOT_FOUND: "link.flow.connectable.validation.target_port_not_found";
+    readonly PORT_TYPE_MISMATCH: "link.flow.connectable.validation.port_type_mismatch";
+    readonly SOURCE_NODE_NOT_ALLOWED: "link.flow.connectable.validation.source_node_not_allowed";
+    readonly TARGET_NODE_NOT_ALLOWED: "link.flow.connectable.validation.target_node_not_allowed";
+    readonly SOURCE_NODE_DENIED: "link.flow.connectable.validation.source_node_denied";
+    readonly TARGET_NODE_DENIED: "link.flow.connectable.validation.target_node_denied";
+    readonly SOURCE_MAX_CONNECTIONS_REACHED: "link.flow.connectable.validation.source_max_connections_reached";
+    readonly TARGET_MAX_CONNECTIONS_REACHED: "link.flow.connectable.validation.target_max_connections_reached";
+    readonly SELF_CONNECTION_NOT_ALLOWED: "link.flow.connectable.validation.self_connection_not_allowed";
+};
+/**
+ * 将端口连接校验结果转为当前 locale 的用户文案。
+ *
+ * @example
+ * ```ts
+ * const intl = useIntl();
+ * const text = formatPortConnectionValidationMessage(
+ *   validationResult,
+ *   (id, values) => intl.formatMessage({ id }, values),
+ * );
+ * ```
+ */
+export declare const formatPortConnectionValidationMessage: (result: PortConnectionValidationResult, translate: TranslateFn) => string;

package/dist/components/digitalsee/workflow/utils/portConnectionValidationMessages.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,66 @@
+import { DipPortSchema } from '../api/dip.types';
+export declare const DEFAULT_PORT_CONNECTION_TYPE = "main";
+/** 已完成运行时默认值归一化的端口 Schema。 */
+export interface NormalizedDipPortSchema extends DipPortSchema {
+    type: string;
+}
+/**
+ * 校验器所需的最小节点结构，可直接接收 ReactFlow Node。
+ *
+ * 节点 schema key 必须放在 data.action_key/actionKey/nodeKey/node_key 中；
+ * ReactFlow 的 node.type 只是渲染类型，不能作为连接白名单身份。
+ */
+export interface PortConnectionNode {
+    id: string;
+    data?: Record<string, unknown> | null;
+}
+/** 校验器所需的最小边结构，可直接接收 ReactFlow Edge。 */
+export interface PortConnectionEdge {
+    id?: string;
+    source: string;
+    target: string;
+    sourceHandle?: string | null;
+    targetHandle?: string | null;
+}
+export interface PortConnectionValidationOptions {
+    /**
+     * 显式兼容旧 CLASSIC handle：source `output`、target `input` 映射到 Schema `main`。
+     * nodepackage 节点必须保持默认 false，避免把真实的 `input/output/main` 端口混为一谈。
+     */
+    allowLegacyMainHandleAliases?: boolean;
+}
+export interface ValidatePortConnectionInput {
+    sourceNode?: PortConnectionNode | null;
+    targetNode?: PortConnectionNode | null;
+    sourceHandle?: string | null;
+    targetHandle?: string | null;
+    /** 源节点的 output Schema 列表。 */
+    sourcePorts?: readonly DipPortSchema[] | null;
+    /** 目标节点的 input Schema 列表。 */
+    targetPorts?: readonly DipPortSchema[] | null;
+    /** 当前画布已有边；新建边本身不应提前加入此列表。 */
+    edges?: readonly PortConnectionEdge[] | null;
+    options?: PortConnectionValidationOptions;
+}
+export type PortConnectionValidationCode = 'VALID' | 'SOURCE_NODE_NOT_FOUND' | 'TARGET_NODE_NOT_FOUND' | 'SOURCE_PORT_NOT_FOUND' | 'TARGET_PORT_NOT_FOUND' | 'PORT_TYPE_MISMATCH' | 'SOURCE_NODE_NOT_ALLOWED' | 'TARGET_NODE_NOT_ALLOWED' | 'SOURCE_NODE_DENIED' | 'TARGET_NODE_DENIED' | 'SOURCE_MAX_CONNECTIONS_REACHED' | 'TARGET_MAX_CONNECTIONS_REACHED' | 'SELF_CONNECTION_NOT_ALLOWED';
+export interface PortConnectionValidationResult {
+    valid: boolean;
+    code: PortConnectionValidationCode;
+    /** 可直接用于调试的中文兜底原因；界面层应优先按 code 映射 i18n 文案。 */
+    reason: string;
+    sourcePort: NormalizedDipPortSchema | null;
+    targetPort: NormalizedDipPortSchema | null;
+}
+/**
+ * 将端口运行时默认值和 ACM SNAKE_CASE 响应统一为内部 camelCase，不修改原始对象。
+ */
+export declare const normalizePortSchema: (port: DipPortSchema) => NormalizedDipPortSchema;
+/** 从 ReactFlow 节点 data 中解析用于黑白名单判断的 NodePackage schema key。 */
+export declare const getPortConnectionNodeIdentity: (node?: PortConnectionNode | null) => string | null;
+/**
+ * 按 NodePackage PortSchema 校验一条准备创建的连接。
+ *
+ * 本函数拒绝直接自连，但不校验多节点环路、MCP 等画布专项规则；调用方应按
+ * “通用图结构规则 → Schema 规则 → 专项规则”的顺序组合。
+ */
+export declare const validatePortConnection: ({ sourceNode, targetNode, sourceHandle, targetHandle, sourcePorts, targetPorts, edges, options, }: ValidatePortConnectionInput) => PortConnectionValidationResult;

package/dist/components/digitalsee/workflow/utils/portConnectionValidator.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,43 @@
+import { FormSchema } from '../../../dynamic-form/types/form-schema';
+import { DipNodeSchema } from '../api/dip';
+export declare const SWITCH_NODE_PACKAGE_KEY = "dip.core.flow.switch";
+export interface SwitchNodePackageBranch extends Record<string, unknown> {
+    id: string;
+    name: string;
+}
+interface NormalizedSwitchBranches {
+    branches: SwitchNodePackageBranch[];
+    changed: boolean;
+}
+interface NormalizedSwitchProperties extends NormalizedSwitchBranches {
+    properties: Record<string, unknown>;
+}
+/** 判断 NodeSchema 是否为当前 nodepackage Switch 节点。 */
+export declare function isSwitchNodePackageKey(nodeKey: unknown): nodeKey is string;
+/**
+ * 从 CLASSIC 画布节点数据中读取 Switch 的实际配置。
+ *
+ * ACM 历史数据可能把业务参数直接放在 config_schema/properties，也可能再包一层
+ * properties/params。读取时兼容这些形态，但始终返回扁平业务参数。
+ */
+export declare function getSwitchNodePackageProperties(data: Record<string, unknown>): Record<string, unknown>;
+/** 修复缺失、重复或后端无法路由的 Switch 分支标识。 */
+export declare function normalizeSwitchNodePackageBranches(value: unknown): NormalizedSwitchBranches;
+/** 将分支修复结果合并回节点业务参数。 */
+export declare function normalizeSwitchNodePackageProperties(value: unknown): NormalizedSwitchProperties;
+/**
+ * 用实例 branches 派生 Switch 输出端口。
+ *
+ * Schema 中第一个非 default 输出作为动态分支模板，连接数和目标节点约束会复制到
+ * 每个实例分支；default 端口保持后端原始定义。
+ */
+export declare function resolveSwitchNodePackagePortSchema(schema: DipNodeSchema, branches: SwitchNodePackageBranch[]): Pick<DipNodeSchema, 'inputs' | 'outputs'>;
+/** 将节点实例中的 branches 应用到完整 Switch NodeSchema。 */
+export declare function resolveSwitchNodePackageInstanceSchema(schema: DipNodeSchema, data: Record<string, unknown>): DipNodeSchema;
+/**
+ * 为 Switch 的 branches ARRAY_OBJECT 注入节点专用的新增项工厂。
+ *
+ * DynamicForm 仍保持通用；唯一 ID、默认分支名和最小条件结构由 Switch 自己负责。
+ */
+export declare function enhanceSwitchNodePackageFormSchema(schema: FormSchema, nodeKey: unknown): FormSchema;
+export {};

package/dist/components/digitalsee/workflow/utils/switchNodePackage.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,20 @@
+import { EngineMode } from '../enums/workflow';
+import { EdgeConfig, EdgeRulesConfig, NodeSelectorConnectableConfig } from '../types/engine';
+import { Edge, IsValidConnection, Node } from '@xyflow/react';
+interface ValidateWorkflowConnectionInput {
+    edge: EdgeConfig;
+    nodes: Node[];
+    edges: Edge[];
+    engineMode?: EngineMode;
+    connectable?: Pick<NodeSelectorConnectableConfig, 'enabled' | 'debug'>;
+    validators?: EdgeRulesConfig['validators'];
+    nativeIsValidConnection?: IsValidConnection;
+}
+/**
+ * 校验一条准备创建的画布连接。
+ *
+ * 手动拖线与程序化新增都传入各自的节点/边快照，从而复用 NodePackage、MCP、
+ * 宿主 edgeRules 和 ReactFlow native validator。边中插入可由调用方先从快照移除旧边。
+ */
+export declare function validateWorkflowConnection({ edge, nodes, edges, engineMode, connectable, validators, nativeIsValidConnection, }: ValidateWorkflowConnectionInput): boolean;
+export {};

package/dist/components/digitalsee/workflow/utils/workflowConnectionValidator.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/dynamic-form/DynamicForm.d.ts

@@ -8,9 +8,15 @@ import * as React from 'react';
 export type PresetTheme = 'default' | 'apple' | 'google' | 'preline';
 export type DynamicFormProps<T = Record<string, unknown>> = {
     schema: FormSchema;
+    /** 是否禁用整个动态表单 */
+    disabled?: boolean;
     initialValues?: Partial<T>;
     onSubmit?: (values: T) => void | Promise<void>;
     onChange?: (changedValues: Partial<T>, allValues: T) => void;
+    /**
+     * 观察表单的完整值变化，包括 setFieldValue 等不会触发 onValuesChange 的程序化更新。
+     */
+    onValuesObserved?: (allValues: T) => void;
     submitLabel?: string;
     showReset?: boolean;
     resetLabel?: string;
@@ -54,4 +60,4 @@ export type DynamicFormProps<T = Record<string, unknown>> = {
     /** 是否启用事件系统调试日志（默认 false） */
     debugEvents?: boolean;
 };
-export declare function DynamicForm<T extends Record<string, unknown>>({ schema, initialValues, onSubmit, onChange, submitLabel, showReset, resetLabel, onReset, form: externalForm, showSubmit, optionsLoader, nodeId, mcpMode, validateVariable, renderVariableTag, renderVariableTooltip, availableVariables, theme, customTheme, locale, prefixCls, events, customHandlers, maxExecutionDepth, debugEvents, }: DynamicFormProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function DynamicForm<T extends Record<string, unknown>>({ schema, disabled: disabledProp, initialValues, onSubmit, onChange, onValuesObserved, submitLabel, showReset, resetLabel, onReset, form: externalForm, showSubmit, optionsLoader, nodeId, mcpMode, validateVariable, renderVariableTag, renderVariableTooltip, availableVariables, theme, customTheme, locale, prefixCls, events, customHandlers, maxExecutionDepth, debugEvents, }: DynamicFormProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/components/dynamic-form/components/ValueModeWrapper/ValueModePolicy.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -1,14 +1,26 @@
+import { ValueModePolicy } from '../../types/form-schema';
 import * as React from 'react';
 export type ValueMode = 'normal' | 'expression' | 'code';
+export declare function getValueModePolicyConfig(policy: ValueModePolicy): {
+    availableModes: ValueMode[];
+    defaultMode: ValueMode;
+};
 export declare function isEncodedExpressionValue(value: unknown): value is string;
-export declare function encodeValueForMode(inputValue: string, mode: ValueMode, encodeExpressionValue: boolean): string;
-export declare function decodeValueForMode(value: string, mode: ValueMode, encodeExpressionValue: boolean): string;
+/**
+ * 将节点配置中的历史值统一转换为输入组件可消费的字符串。
+ * 后端 Schema 允许配置值保留 number/boolean/object，不能依赖 TypeScript 类型断言。
+ */
+export declare function normalizeValueModeInput(value: unknown): string;
+export declare function encodeValueForMode(inputValue: unknown, mode: ValueMode, encodeExpressionValue: boolean): string;
+export declare function decodeValueForMode(value: unknown, mode: ValueMode, encodeExpressionValue: boolean): string;
 export declare function inferValueModeFromValue(value: unknown, defaultMode: ValueMode, encodeExpressionValue: boolean, availableModes?: ValueMode[]): ValueMode;
 export interface ValueModeWrapperProps {
     /** 当前值 */
-    value?: string;
+    value?: unknown;
     /** 值变化回调 */
     onChange?: (value: string) => void;
+    /** 文本/表达式输入策略 */
+    valueModePolicy?: ValueModePolicy;
     /** 可用的模式列表，默认全部可用 */
     availableModes?: ValueMode[];
     /** 初始模式 */
@@ -51,6 +63,14 @@ export interface ValueModeWrapperProps {
         readOnly?: boolean;
         placeholder?: string;
     }) => React.ReactNode;
+    /** 自定义渲染表达式模式的组件 */
+    renderExpressionMode?: (props: {
+        value?: string;
+        onChange?: (value: string) => void;
+        disabled?: boolean;
+        readOnly?: boolean;
+        placeholder?: string;
+    }) => React.ReactNode;
     /** 普通模式下要渲染的子组件（会通过 cloneElement 传递 value/onChange） */
     children?: React.ReactElement<any>;
     /** 隐藏模式切换器 */

package/dist/components/dynamic-form/registry/createFieldComponent.d.ts

@@ -5,7 +5,7 @@ import type * as React from 'react';
  * 创建标准字段组件定义
  *
  * 这是一个工厂函数，用于将原始组件包装为标准的字段组件定义。
- * 它会根据组件的元数据自动处理 variableInsert 和 aiFillable 的包装逻辑。
+ * 它会根据组件的元数据自动处理 valueModePolicy 和 aiFillable 的包装逻辑。
  *
  * @param Component - 原始字段组件
  * @param meta - 组件元数据
@@ -17,13 +17,13 @@ import type * as React from 'react';
  * }
  *
  * export const TextField = createFieldComponent(TextFieldControl, {
- *   supportsVariableInsert: false, // 由 HOC 处理 variableInsert
+ *   supportsVariableInsert: false, // 由 HOC 处理 valueModePolicy
  * })
  *
  * @example
- * // 组件内部已处理 variableInsert
+ * // 组件内部已处理 valueModePolicy
  * const TextFieldControl: React.FC<FieldComponentProps> = ({ field, disabled, readOnly, context }) => {
- *   if (field.variableInsert) {
+ *   if (field.valueModePolicy) {
  *     return (
  *       <ValueModeWrapper validateVariable={context.validateVariable} ...>
  *         <Input />

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

@@ -73,7 +73,7 @@ export interface FieldComponentProps<T extends FieldDef = FieldDef, K = unknown>
  */
 export interface FieldComponentMeta {
     /**
-     * 组件内部是否已处理 variableInsert 特性
+     * 组件内部是否已处理值模式策略和变量输入特性
      * 如果为 true，FieldRenderer 不会额外包装 ValueModeWrapper
      */
     supportsVariableInsert?: boolean;

package/dist/components/dynamic-form/types/form-schema.d.ts

@@ -7,6 +7,8 @@ export type Option = {
     children?: Option[];
 };
 export type ValueMode = 'string' | 'jsExpr' | 'code' | 'variable';
+/** 字段值输入策略 */
+export type ValueModePolicy = 'TEXT' | 'EXPRESSION' | 'BOTH';
 export type OptionsSource = {
     kind: 'static';
     items: Option[];
@@ -59,6 +61,8 @@ export declare enum DynamicFormField {
     LABEL = "LABEL",// 纯文本展示
     HIDDEN = "HIDDEN",// 隐藏字段
     JSON = "JSON",// JSON 编辑器
+    CODE = "CODE",// 工作流代码/JSON 编辑器（由宿主作用域注册）
+    PROXY = "PROXY",// 工作流代理网关选择器（由宿主作用域注册）
     DIVIDER = "DIVIDER",// 分割线
     INFO_CARD = "INFO_CARD",// 展示卡片
     ARRAY = "ARRAY",// 简单数组
@@ -78,7 +82,7 @@ export type BaseField = {
     helpText?: string;
     readOnly?: boolean | ConditionNode;
     aiFillable?: boolean;
-    variableInsert?: boolean;
+    valueModePolicy?: ValueModePolicy;
     disabled?: boolean | ConditionNode;
     required?: boolean | ConditionNode;
     visibleWhen?: VisibleWhen;
@@ -285,6 +289,11 @@ export type ArrayObjectField = BaseField & {
     backgroundColor?: string;
     /** 多层 ARRAY_OBJECT 背景色列表。嵌套层会按深度自动取色。 */
     levelBackgroundColors?: string[];
+    /** 新增数组项时创建初始对象；用于需要唯一标识或业务默认结构的字段。 */
+    createItem?: (context: {
+        index: number;
+        items: Record<string, unknown>[];
+    }) => Record<string, unknown>;
 };
 /** 字段定义联合类型 */
 export type FieldDef = BaseField | TextareaField | SelectField | RadioField | CheckboxGroupField | DateField | DateRangeField | TimeField | TimeRangeField | NumberField | UploadField | SliderField | RateField | CascaderField | TreeSelectField | AutoCompleteField | SwitchField | InfoCardField | ArrayField | ObjectField | KeyValueField | ArrayObjectField;