@blueking/bkflow-canvas-editor 1.2.0-beta.1 → 1.2.0-beta.3

package/README.md

@@ -56,7 +56,7 @@ npm install @blueking/bkflow-canvas-editor @blueking/flow-canvas
     mode: 'legacy',
     fetchUserApi: `${window.BK_COMPONENT_API_URL}/api/c/compapi/v2/usermanage/fs_list_users/`,
   };
-  // tenant 模式：使用 @blueking/bk-user-selector（需接入方单独安装该 npm 包）
+  // tenant 模式：使用 @blueking/bk-user-selector（peer 依赖 ^0.1.15，由接入方安装）
   // const memberSelectorConfig = {
   //   mode: 'tenant',
   //   tenantId: 'default',
@@ -1202,7 +1202,7 @@ type MemberSelectorConfig =
   }" />
 ```
 
-> 提示：选择 `tenant` 模式时，接入方需安装可选 peer 依赖 `@blueking/bk-user-selector`。它仅在 tenant 模式下被动态加载，legacy 模式下未安装也不会报错。
+> 提示：`@blueking/bk-user-selector` 是本包的**必需 peer 依赖**（`^0.1.15`，非 optional），由接入方安装。它仅在 tenant 模式下被动态加载，legacy 模式不会触发加载（加载时机与安装约束相互独立）。
 
 组件内部会自动实现所有 API 方法，包括：
 

package/dist/advanced.d.ts

@@ -56,7 +56,7 @@ type PortOrientation = 'Top' | 'Right' | 'Bottom' | 'Left';
 
 type GatewayType = 'ExclusiveGateway' | 'ParallelGateway' | 'ConditionalParallelGateway' | 'ConvergeGateway';
 
-type NodeType = StartEvent | EndEvent | Activity | SubProcessActivity | Gateway;
+type NodeType = StartEvent | EndEvent | Activity | SubProcessActivity | SubCanvasActivity | Gateway;
 
 interface PluginInputDataItem {
   value:
@@ -125,6 +125,7 @@ interface Activity {
   loop?: number | null;
   /** 执行态：生命周期阶段 */
   phase?: number;
+  parent?: string | null;
 }
 
 /**
@@ -216,7 +217,51 @@ interface SubProcessActivity {
   phase?: number;
 }
 
-type ActivityUnion = Activity | SubProcessActivity;
+/**
+ * 循环体容器节点（SubCanvas）节点。
+ */
+interface SubCanvasActivity {
+  id: string;
+  name: string;
+  stage_name?: string;
+  type: 'SubCanvas';
+  incoming: string[];
+  outgoing: string;
+  optional?: boolean;
+  /** 循环执行配置 */
+  loop_config?: LoopConfig;
+  /** 嵌套的完整子流程 */
+  pipeline: PipelineTree;
+  /** 节点标签 */
+  labels?: string[];
+  status?: NodeExecutionStatus;
+  /** 执行态：循环执行次数（未执行时为 null） */
+  loop?: number | null;
+  error_ignorable?: boolean;
+  retryable?: boolean;
+  skippable?: boolean;
+  auto_retry?: {
+    enable: boolean;
+    interval: number;
+    times: number;
+  };
+  timeout_config?: {
+    enable: boolean;
+    seconds: number;
+    action: string;
+  };
+  /** 执行态：实际重试次数 */
+  retry?: number;
+  /** 执行态：是否被跳过 */
+  skip?: boolean;
+  /** 执行态：是否自动忽略错误 */
+  error_ignored?: boolean;
+  /** 执行态：生命周期阶段 */
+  phase?: number;
+  parent?: string | null;
+}
+
+type ActivityUnion = Activity | SubProcessActivity | SubCanvasActivity;
 
 interface StartEvent {
   id: string;
@@ -259,6 +304,7 @@ interface Gateway {
     parse_lang?: 'boolrule' | 'FEEL' | 'MAKO';
   };
   status?: NodeExecutionStatus;
+  parent?: string | null;
 }
 
 interface Flow {
@@ -275,15 +321,20 @@ interface Location {
     | 'endpoint'
     | 'tasknode'
     | 'subflow'
+    | 'SubCanvas'
     | 'branchgateway'
     | 'convergegateway'
     | 'parallelgateway'
     | 'conditionalparallelgateway';
   x: number;
   y: number;
+  /** 容器节点（SubCanvas）resize 后持久化的尺寸 */
+  width?: number;
+  height?: number;
   group?: string;
   icon?: string;
   name?: string;
+  parent?: string | boolean;
 }
 
 interface Line {