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

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 import * as vue from 'vue';
-import { Component, ComputedRef, Ref } from 'vue';
+import { Component, ComputedRef, Ref, App } from 'vue';
 import { AxiosInstance, AxiosRequestConfig } from 'axios';
 import * as _blueking_flow_canvas from '@blueking/flow-canvas';
 import { ZoomToFitOptions, CanvasUiEvent, QuickAddConfig, CanvasSchema, FlowModel, FlowNodeModel, NodeActionsConfig, ConnectionValidator, CanvasPlugin, CanvasToolbarItem, CommandEnvelope } from '@blueking/flow-canvas';
+export { Locale, MessageTree, Translator, getLocale, registerMessages, setLocale, setTranslator, t } from '@blueking/flow-canvas';
+import { defaultRootConfig } from 'bkui-vue/lib/config-provider';
 
 /**
  * Flow API 配置接口
@@ -68,7 +70,7 @@ declare namespace __mock_vue {
   };
 }
 
-type NodeExecutionStatus = 'CREATED' | 'RUNNING' | 'FINISHED' | 'FAILED' | 'SUSPENDED' | 'REVOKED' | 'SKIP';
+type NodeExecutionStatus = 'CREATED' | 'RUNNING' | 'FINISHED' | 'FAILED' | 'SUSPENDED' | 'REVOKED' | 'INVALID' | 'SKIP';
 type ExecutionNodeAction = 'retry' | 'skip' | 'resume' | 'approve' | 'forceFail' | 'gatewaySkip';
 interface NodeExecutionState {
     status: NodeExecutionStatus;
@@ -149,13 +151,26 @@ interface ActivityComponent {
   api_meta?: {
     id: string;
     name: string;
+    /** 项目内 uniform_api 仍可能写入；标准运维 V4 对齐 bkflow，不再落这个字段 */
     alias?: string;
-    meta_url: string;
+    /** 目录项有 meta_url 才写；V4 开放插件通常只有 meta_url_template */
+    meta_url?: string;
     api_key: string;
     category: {
       id: string;
       name: string;
     };
+    // 标准运维 V4 开放插件的落库字段，对齐 bkflow NodeConfig.vue `if (isV4)` 保存分支
+    plugin_source?: string;
+    plugin_code?: string;
+    plugin_version?: string;
+    wrapper_version?: string;
+    versions?: string[];
+    meta_url_template?: string;
+    latest_version?: string;
+    default_version?: string;
+    desc?: string;
+    source_key?: string;
   };
 }
 
@@ -223,7 +238,7 @@ interface LoopConfig {
 }
 
 /**
- * 子流程（SubProcess）活动节点。
+ * 子流程（SubProcess）活动节点
  */
 interface SubProcessActivity {
   id: string;
@@ -234,6 +249,8 @@ interface SubProcessActivity {
   type: 'SubProcess';
   /** 被引用的模板 ID */
   template_id: string | number;
+  /** 模板名称 */
+  template_name?: string;
   /** 模板版本 */
   version?: string;
   /** 变量映射常量 */
@@ -633,15 +650,20 @@ interface FlowDraftDetail {
     md5sum: string;
     pipeline_tree: PipelineTree;
 }
+interface SpaceUniformApiEntry {
+    meta_apis: string;
+    api_categories?: string;
+    display_name?: string;
+    source_key?: string;
+    catalog_mode?: 'remote' | 'cache_first' | 'cache_only';
+    headers?: Record<string, string>;
+}
 interface SpaceFlowConfig {
     gateway_expression?: 'boolrule' | 'FEEL' | 'MAKO';
-    uiform_api?: {
-        api: Record<string, {
-            api_category: string;
-            display_name: string;
-            meta_apis: string;
-        }>;
-    };
+    uniform_api?: {
+        api?: Record<string, SpaceUniformApiEntry | null>;
+        common?: SpaceUniformApiEntry | null;
+    } | null;
 }
 interface UpdateFlowParams {
     name: string;
@@ -671,6 +693,88 @@ interface PluginMetaItem {
     icon?: string;
     category_id: string;
 }
+interface SopsPluginSourceItem {
+    id: string;
+    name: string;
+    /** 空间配置 uniform_api.api[api_name].source_key，缺省时等于 api_name */
+    source_key?: string;
+}
+interface SopsPluginCategory {
+    id: string;
+    name: string;
+}
+interface SopsPluginItem {
+    id: string;
+    name: string;
+    category?: string;
+    category_name?: string;
+    description?: string;
+    meta_url?: string;
+    meta_url_template?: string;
+    plugin_source?: string;
+    plugin_code?: string;
+    source_key?: string;
+    wrapper_version?: string;
+    default_version?: string;
+    latest_version?: string;
+    versions?: string[];
+}
+interface SopsPluginListResult {
+    total: number;
+    apis: SopsPluginItem[];
+}
+/**
+ * 统一插件详情里的表单描述符（bkflow V4 开放插件协议）。
+ * component_js / renderform(string) 走 $.atoms 注册链路，key 即注册用的 atom key；
+ * is_embedded 为 false 时 data 是脚本地址，否则 data 是脚本源码。
+ */
+type SopsPluginFormDescriptor = {
+    type: 'component_js';
+    key: string;
+    data: string;
+    base?: string;
+    is_embedded?: boolean;
+} | {
+    type: 'renderform';
+    key?: string;
+    data: string | RenderformInputsItem[] | Record<string, unknown>;
+    base?: string;
+    is_embedded?: boolean;
+} | {
+    type: 'jsonschema';
+    data: JsonschemaformInputs;
+} | {
+    type: 'api_plugin_json';
+    data?: Record<string, unknown>;
+};
+interface SopsPluginDetail {
+    plugin_type: 'component' | 'remote_plugin' | 'uniform_api';
+    plugin_code: string;
+    plugin_version: string;
+    source_key: string;
+    plugin_source?: string;
+    protocol?: string;
+    wrapper_version?: string;
+    name: string;
+    description?: string;
+    inputs?: UniformApiPluginInputsItem[];
+    outputs?: PluginOutputItem[];
+    credentials?: Record<string, unknown> | null;
+    forms?: {
+        input?: SopsPluginFormDescriptor | null;
+        output?: SopsPluginFormDescriptor | null;
+    } | null;
+    form_schema?: Record<string, unknown> | null;
+    /** 表单脚本运行所需的上下文（site_url / project 等），由插件提供方下发 */
+    form_context?: Record<string, unknown> | null;
+    execution_kind?: string;
+    url?: string;
+    methods?: string[];
+    response_data_path?: string;
+    polling?: Record<string, any> | null;
+    callback?: Record<string, any> | null;
+    credential_key?: string;
+}
 interface BkflowThirdPartyPluginGroupItem {
     code_name: string;
     id: number;
@@ -754,7 +858,7 @@ interface BkflowThirdPartyPluginAppDetail {
     };
 }
 interface GroupsPluginItem extends PluginGroupConfig {
-    children: (PluginMetaItem | BkflowThirdPartyPluginGroupItem)[];
+    children: (PluginMetaItem | BkflowThirdPartyPluginGroupItem | SopsPluginSourceItem)[];
 }
 interface DndNodeItem {
     type: string;
@@ -857,14 +961,29 @@ interface PluginOutputItem {
     type: string;
     name: string;
 }
-interface PluginDetailCommon {
+/**
+ * 输入表单的渲染方式与表单项数据。
+ *
+ * 两者必须配对：renderform 的表单项以 tag_code 标识、uniformApiForm 用 key，jsonschemaform
+ * 给的则是一个 schema 对象而非数组。做成判别联合，取默认值、取字段名、选渲染组件这些地方
+ * 就必须先按 inputParamsFormType 收窄，漏掉一种由编译器报出来，而不是在遍历时崩掉。
+ */
+type PluginInputForm = {
+    inputParamsFormType: 'renderform';
+    inputs: RenderformInputsItem[];
+} | {
+    inputParamsFormType: 'jsonschemaform';
+    inputs: JsonschemaformInputs;
+} | {
+    inputParamsFormType: 'uniformApiForm';
+    inputs: UniformApiPluginInputsItem[];
+};
+interface PluginDetailBase {
     code: string;
     name: string;
     desc: string;
     version: string;
-    inputs: UniformApiPluginInputsItem[] | RenderformInputsItem[] | JsonschemaformInputs;
     outputs: PluginOutputItem[];
-    inputParamsFormType: string;
     versions?: string[];
     category?: string;
     group?: string;
@@ -872,10 +991,20 @@ interface PluginDetailCommon {
     methods?: string[];
     uniformApiName?: string;
     polling?: Record<string, any>;
+    callback?: Record<string, any>;
+    response_data_path?: string;
     credential_key?: string;
+    /** V4 开放插件身份，执行时引擎从 component.data 的同名隐藏字段读取 */
+    openPluginIdentity?: {
+        pluginId: string;
+        pluginVersion: string;
+        sourceKey: string;
+        wrapperVersion: string;
+    };
     component_type?: string;
     displayGroupName?: string;
 }
+type PluginDetailCommon = PluginDetailBase & PluginInputForm;
 interface CustomVariableType {
     name: string;
     form: string;
@@ -901,8 +1030,10 @@ interface CustomVariableType {
  */
 interface FilterVariableSourceNodeComponent {
     code?: string;
+    /** `name` 是插件的稳定标识（如 log_plugin）；`id` 随环境变化，不能用来做判断 */
     api_meta?: {
         id?: string;
+        name?: string;
     };
     data?: Record<string, {
         value?: unknown;
@@ -980,6 +1111,49 @@ interface FilterVariableConfig {
  */
 declare function provideFilterVariableConfig(config?: FilterVariableConfig): void;
 
+interface CreateVariablePayload {
+    keyword?: string;
+    cursorIndex?: number;
+    defaultCustomType?: string;
+}
+/**
+ * 宿主自定义的候选项来源标识。
+ *
+ * 编辑器**不解释**它的内容，只做原样存储与回传：`key` 用于让宿主找到自己的加载器，
+ * `params` 放宿主拉取时需要的补充信息。
+ *
+ * 之所以由宿主带进来而不是编辑器从 pipeline_tree 反查关联节点的插件：节点配置尚未
+ * 保存时，`activities[nodeId].component` 还是换插件之前的那个，反查会拿到错的插件。
+ */
+interface SelectRelatedOptionSourceRef {
+    key: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * select 变量「关联数据」的来源，由宿主在节点表单里发起受控创建时锁定。
+ * 与 filter 的 FilterVariableSourceContext 平行。
+ */
+interface SelectRelatedSourceContext {
+    sourceNodeId: string;
+    /**
+     * 关联来源在「关联数据」栏展示的名字，由宿主决定放什么（bk-incident 放当前选中的插件名）。
+     *
+     * 它**优先于**画布实时解析的节点名：select 的关联源连同候选项来源一起冻结在创建时刻，
+     * 展示名跟着来源走而不是跟着节点实例走。不传则回落实时节点名、再回落裸 nodeId——
+     * 而空节点选插件后配置尚未写回 pipeline_tree，实时节点名恰恰是空的。
+     */
+    sourceNodeName?: string;
+    /** 关联表单项稳定 KEY，例如 index_set_id */
+    sourceFieldKey: string;
+    /**
+     * 关联表单项的展示名，例如「查询条件」——即节点表单上那一栏的标题，不是 fieldKey 本身。
+     * 全局变量侧滑没有加载插件 schema 的时机，不带进来就只能显示裸 fieldKey。
+     */
+    sourceFieldName?: string;
+    /** 候选项从哪来。缺省则该变量没有可拉取的候选项 */
+    optionSource?: SelectRelatedOptionSourceRef;
+}
+
 /**
  * filter（复合条件选择）变量的领域逻辑。
  *
@@ -1027,12 +1201,16 @@ type FilterWhereValue = FilterWhereItem[];
  *
  * filter 变量不能从普通「新建变量」入口创建——它必须携带关联节点与关联字段，
  * 所以对外只暴露这一个方法，由宿主在节点表单里发起。
+ *
+ * select 的「关联数据」态同样只能受控创建（`selectRelatedContext`），但它是**可选**的：
+ * select 缺少关联源时退化为「手动输入」，仍是一个可用的变量，不像 filter 那样必须锁定。
  */
 
 interface OpenFilterVariableCreateRequest {
     defaultCustomType: 'filter';
     /** 关联来源，filter 场景必填 */
     filterContext: FilterVariableSourceContext;
+    selectRelatedContext?: never;
     keyword?: string;
     /**
      * 可选：把宿主表单里已配好的真实维度条件带进来作为默认值。
@@ -1044,6 +1222,11 @@ interface OpenFilterVariableCreateRequest {
 interface OpenStandardVariableCreateRequest {
     defaultCustomType?: string;
     filterContext?: never;
+    /**
+     * 可选：把 select 变量初始化成「关联数据」态并锁定关联源。
+     * 不传则 select 按「手动输入」初始化。
+     */
+    selectRelatedContext?: SelectRelatedSourceContext;
     keyword?: string;
     cursorIndex?: number;
     onCreated?: (variable: Variable) => void;
@@ -1110,9 +1293,13 @@ interface DebugConditionResult {
 }
 interface DebugContextNode {
     node_id: string;
+    /** 节点显示名称；后端逐步补齐，旧版本可能缺失。 */
+    node_name?: string;
     node_type: string;
     execution_mode: DebugExecutionMode;
     status: DebugNodeStatus;
+    /** 节点配置变更后，已有调试结果是否失效。 */
+    config_changed?: boolean;
     can_step: boolean;
     missing_vars: DebugMissingVar[];
     waiting_reason?: string | null;
@@ -1136,6 +1323,26 @@ interface DebugContextNode {
     /** 条件网关每个分支的表达式与命中结果。 */
     condition_results?: DebugConditionResult[];
 }
+interface DebugSnapshotNode {
+    node_id: string;
+    node_name: string;
+    node_type: string;
+    execution_mode: DebugExecutionMode;
+    status: DebugNodeStatus;
+    waiting_reason?: string | null;
+    inputs: Record<string, unknown>;
+    outputs: Record<string, unknown>;
+    duration_ms?: number | null;
+    error_detail?: DebugErrorDetail | string | null;
+    log_ref?: DebugContextNode['log_ref'];
+    operator: string;
+    last_run_at?: string | null;
+    config_changed: boolean;
+    node_deleted: boolean;
+}
+interface DebugSnapshot {
+    nodes: DebugSnapshotNode[];
+}
 /**
  * /debug_context/ 顶层结构。
  *
@@ -1159,6 +1366,7 @@ interface DebugContext {
     global_vars: Record<string, unknown>;
     missing_vars?: DebugMissingVar[];
     nodes: DebugContextNode[];
+    debug_snapshot: DebugSnapshot | null;
 }
 interface DebugInputSchemaField {
     key: string;
@@ -1255,6 +1463,45 @@ interface DebugApiServices {
     resetDebugResult(params: ResetDebugResultParams): Promise<DebugResetResult>;
 }
 
+/** 版本列表条目。列表接口不返回 pipeline_tree，取流程内容要走 preview_task_tree。 */
+interface FlowVersionSnapshot {
+    id: number;
+    template_id: number;
+    /** 草稿行为 null；已发布行为 semver 字符串 */
+    version: string | null;
+    desc: string | null;
+    draft: boolean;
+    creator: string;
+    operator: string;
+    /** pipeline 内容指纹 */
+    md5sum: string;
+    create_time: string;
+    update_time: string;
+}
+interface FlowVersionListResult {
+    count: number;
+    results: FlowVersionSnapshot[];
+}
+interface ReleaseFlowVersionParams {
+    version: string;
+    desc?: string;
+}
+interface RollbackFlowVersionParams {
+    version: string;
+}
+interface FlowVersionApiServices {
+    /** 版本列表。固定以 limit=-1 请求全量，不做分页 UI */
+    fetchFlowVersionList: (templateId: string) => Promise<FlowVersionListResult>;
+    /** 计算下一个建议版本号。基于当前线上版本 bump，无历史版本时返回 1.0.0 */
+    calculateNextFlowVersion: (templateId: string) => Promise<{
+        version: string;
+    }>;
+    /** 发布上线。作用于 DB 里的草稿行，调用前必须确保草稿已落库 */
+    releaseFlowVersion: (templateId: string, params: ReleaseFlowVersionParams) => Promise<FlowTemplate>;
+    /** 把历史版本加载至草稿，会覆盖当前草稿内容 */
+    rollbackFlowVersion: (templateId: string, params: RollbackFlowVersionParams) => Promise<unknown>;
+}
+
 interface DrawPipelineParams {
     pipeline_tree: PipelineTree;
     canvas_width: number;
@@ -1305,10 +1552,38 @@ interface OperateTaskNodeParams {
 interface GetFlowTaskDetailParams {
     task_id: number | string;
 }
+interface SopsPluginCategoryParams {
+    template_id: number | string;
+    /** 空间 uniform_api 配置里的 api_name，如 sops_builtin / sops_third_party */
+    api_name: string;
+}
+interface SopsPluginListParams extends SopsPluginCategoryParams {
+    category?: string;
+    /** 插件名称搜索关键字 */
+    key?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * 统一插件详情请求参数。
+ * 后端 serializer 会拒绝契约外字段（不是静默忽略），调用方不要附加额外参数；
+ * space_id / scope_type / scope_value 由 service 从 scopeData 补齐。
+ */
+interface SopsPluginDetailParams {
+    template_id: number | string;
+    plugin_type: 'component' | 'remote_plugin' | 'uniform_api';
+    /** 标准运维网关 plugin id：内置为 `builtin__<code>`，第三方即裸 code */
+    plugin_code: string;
+    plugin_version: string;
+    /** uniform_api 必填，缺失时后端直接 400 */
+    source_key?: string;
+}
 interface FlowTaskDetail {
     id: number | string;
     template_id: number;
     pipeline_tree: PipelineTree;
+    /** 调试任务执行人。 */
+    executor?: string;
     /** 任务已耗时（秒），调试摘要弹层刷新恢复用。 */
     elapsed_time?: number;
     [key: string]: unknown;
@@ -1470,6 +1745,9 @@ interface FlowEditApiConfig extends FlowViewApiConfig {
         count: number;
     }>;
     enableThirdPlugin?: boolean;
+    fetchSopsPluginCategories?: (params: SopsPluginCategoryParams) => Promise<SopsPluginCategory[]>;
+    fetchSopsPluginList?: (params: SopsPluginListParams) => Promise<SopsPluginListResult>;
+    fetchSopsPluginDetail?: (params: SopsPluginDetailParams) => Promise<SopsPluginDetail>;
     fetchPluginDetail?: (id: string) => Promise<UniformApiPluginDetail>;
     fetchApplyInstructionData?: (params: any) => Promise<any>;
     drawPipeline?: (params: DrawPipelineParams) => Promise<{
@@ -1501,7 +1779,7 @@ interface FlowEditApiConfig extends FlowViewApiConfig {
     fetchTaskNodeLog?: (params: FetchTaskNodeLogParams) => Promise<unknown>;
     getFlowTaskDetail?: (params: GetFlowTaskDetailParams) => Promise<FlowTaskDetail>;
 }
-interface FlowDetailApiConfig extends FlowEditApiConfig, Partial<DebugApiServices> {
+interface FlowDetailApiConfig extends FlowEditApiConfig, Partial<DebugApiServices>, Partial<FlowVersionApiServices> {
 }
 
 /**
@@ -1512,6 +1790,7 @@ interface SelectPanelConfig {
     agentResourceUrl?: string;
     agentButtonText?: string;
     knowledgebaseResourceUrl?: string;
+    sopsCategoryWhitelist?: string;
 }
 /**
  * 人员选择器配置
@@ -1750,6 +2029,68 @@ declare namespace __execute_vue {
   };
 }
 
+/**
+ * select 变量「关联数据」候选来源的领域逻辑。
+ *
+ * 关联标识落在 `meta.related` 的 `node_id` / `field_key` 上，不复用 `source_info`——
+ * 那里表达的是「哪些节点表单项 hook 了本变量」，两种语义混在一起会让节点删除时的
+ * 清理逻辑误伤。
+ *
+ * 与 filter 的差异是刻意的：filter 脱离关联节点就无法执行，所以它锁定类型、并在
+ * 节点删除时连变量一起清理；select 关联失效后退回「手动输入」就能继续用，而且可能
+ * 已被多处引用，因此这里既不锁类型也不做清理，只把「关联节点已不存在」暴露给配置态。
+ */
+
+/** 关联标识。select 恒为单节点单表单项 */
+interface SelectRelatedSource {
+    nodeId: string;
+    fieldKey: string;
+}
+/** 关联来源的完整信息：标识 + 宿主自定义的来源引用 */
+interface SelectRelatedSourceInfo extends SelectRelatedSource {
+    optionSource?: SelectRelatedOptionSourceRef;
+}
+
+/**
+ * 关联态 select 的候选项来源：由宿主注入。
+ *
+ * 编辑器不认识具体插件与接口，只要 `{ id, name }[]`——「调哪条指令、响应怎么解析」
+ * 是宿主的知识，放进来就得在编辑器里写死插件名。
+ *
+ * 契约刻意比 FilterVariableConfig 小：filter 需要注入依赖组件、字段与候选值三件套，
+ * select 只需要一次列表拉取。
+ */
+
+interface SelectRelatedOptionItem {
+    id: string;
+    name: string;
+}
+interface SelectRelatedOptionSource extends SelectRelatedSourceInfo {
+    /**
+     * 关联节点当前 component，仅在节点配置**已写回** pipeline_tree 时才反映真实插件。
+     * 从节点配置面板发起创建时它还是换插件之前的那个，所以宿主必须核对后再用，
+     * 不能把它当作插件标识的唯一来源。
+     */
+    nodeComponent?: FilterVariableSourceNodeComponent;
+}
+interface SelectRelatedOptionConfig {
+    getOptions(source: SelectRelatedOptionSource): Promise<SelectRelatedOptionItem[]>;
+    /**
+     * 关联来源在「关联数据」栏的展示名（如「查询条件」）。
+     *
+     * 由宿主实时提供而不是沿用创建时的快照：那个文案属于宿主的节点表单，改了之后已存
+     * 变量也该跟着显示新的。不实现或返回空时回落快照。
+     */
+    resolveSourceLabel?(source: SelectRelatedSourceInfo): string | undefined;
+}
+/**
+ * 在顶层组件中提供候选项来源。
+ *
+ * 与 `provideFilterVariableConfig` 一致：config 为 undefined 时不调用 provide，
+ * 避免遮蔽父级已提供的配置。
+ */
+declare function provideSelectRelatedOptionConfig(config?: SelectRelatedOptionConfig): void;
+
 type __VLS_Slots$4 = {
     customFormContent?: (props: {
         customFormData: Record<string, any>;
@@ -1769,6 +2110,8 @@ type __VLS_Props$4 = {
     memberSelectorConfig?: MemberSelectorConfig;
     /** 执行时填写 filter 变量条件所需的能力；不传则这类变量退化为只读文本 */
     filterVariableConfig?: FilterVariableConfig;
+    /** 执行时关联态 select 变量的候选项来源；不传则这类变量的下拉为空 */
+    selectRelatedOptionConfig?: SelectRelatedOptionConfig;
 };
 declare const __VLS_base$4: vue.DefineComponent<__VLS_Props$4, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
     close: (...args: any[]) => void;
@@ -1801,18 +2144,12 @@ declare namespace __create_task_vue {
   };
 }
 
-interface CreateVariablePayload {
-    keyword?: string;
-    cursorIndex?: number;
-    defaultCustomType?: string;
-}
-
 type __VLS_Slots$3 = {
     header?: () => any;
     inputParams?: (props: {
         node: any;
         pluginDetail: PluginDetailCommon | null;
-        inputs: any[];
+        inputs: PluginInputForm['inputs'];
         editable: boolean;
         fullVariableList: {
             key: string;
@@ -1847,6 +2184,8 @@ type __VLS_Props$3 = {
     memberSelectorConfig?: MemberSelectorConfig;
     /** 复合条件选择（filter）变量的宿主配置；不传则该类型变量不可用，其余功能不受影响 */
     filterVariableConfig?: FilterVariableConfig;
+    /** 关联态 select 变量的候选项来源；不传则这类变量的下拉为空，其余功能不受影响 */
+    selectRelatedOptionConfig?: SelectRelatedOptionConfig;
     onSave?: (flowData: FlowTemplate) => void;
     onSaveSuccess?: () => void;
     onBack?: () => void;
@@ -1931,7 +2270,7 @@ type __VLS_Slots$2 = {
     inputParams?: (props: {
         node: any;
         pluginDetail: PluginDetailCommon | null;
-        inputs: any[];
+        inputs: PluginInputForm['inputs'];
         editable: boolean;
         fullVariableList: {
             key: string;
@@ -2034,10 +2373,15 @@ interface FlowDetailPermissions {
 
 type __VLS_Slots$1 = {
     header?: () => any;
+    /** 头部右侧操作区追加宿主自定义按钮，位于内置「保存」「执行流程」之后 */
+    headerActions?: (props: {
+        savePending: boolean;
+        canMutateFlow: boolean;
+    }) => any;
     inputParams?: (props: {
         node: any;
         pluginDetail: PluginDetailCommon | null;
-        inputs: any[];
+        inputs: PluginInputForm['inputs'];
         editable: boolean;
         fullVariableList: {
             key: string;
@@ -2062,6 +2406,13 @@ type __VLS_Props$1 = {
     permissions?: Partial<FlowDetailPermissions>;
     enableVersion?: boolean;
     flowVersion?: string;
+    /**
+     * 是否启用版本管理 UI（头部版本选择器 + 版本历史 + 发布 + 回滚），默认 false。
+     *
+     * 开启即隐含 `enableVersion` 的数据加载语义（草稿/指定版本读取），消费方只需传这一个。
+     * 组件无法自检空间的 flow_versioning 开关，由消费方保证只在开启版本管理的空间传 true。
+     */
+    enableVersionManagement?: boolean;
     defaultZoom?: number;
     bkflowSaasUrl?: string;
     enableThirdPlugin?: boolean;
@@ -2071,6 +2422,8 @@ type __VLS_Props$1 = {
     memberSelectorConfig?: MemberSelectorConfig;
     /** 复合条件选择（filter）变量的宿主配置；不传则该类型变量不可用，其余功能不受影响 */
     filterVariableConfig?: FilterVariableConfig;
+    /** 关联态 select 变量的候选项来源；不传则这类变量的下拉为空，其余功能不受影响 */
+    selectRelatedOptionConfig?: SelectRelatedOptionConfig;
     onSave?: (flowData: FlowTemplate) => void;
     onSaveSuccess?: () => void;
     onExecuteSuccess?: (result: FlowTaskExecuteSuccessResult) => void;
@@ -2092,18 +2445,21 @@ declare const __VLS_base$1: vue.DefineComponent<__VLS_Props$1, {
     saveSuccess: () => any;
     createVariable: (payload: CreateVariablePayload) => any;
     executeSuccess: (result: FlowTaskExecuteSuccessResult) => any;
+    "update:flowVersion": (version: string | undefined) => any;
 }, string, vue.PublicProps, Readonly<__VLS_Props$1> & Readonly<{
     onBack?: (() => any) | undefined;
     onSave?: ((flowData: FlowTemplate) => any) | undefined;
     onSaveSuccess?: (() => any) | undefined;
     onCreateVariable?: ((payload: CreateVariablePayload) => any) | undefined;
     onExecuteSuccess?: ((result: FlowTaskExecuteSuccessResult) => any) | undefined;
+    "onUpdate:flowVersion"?: ((version: string | undefined) => any) | undefined;
 }>, {
     quickAdd: QuickAddConfig;
     enableThirdPlugin: boolean;
     hideTrigger: boolean;
     defaultZoom: number;
     enableVersion: boolean;
+    enableVersionManagement: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$1: __VLS_WithSlots$1<typeof __VLS_base$1, __VLS_Slots$1>;
 declare const _default$2: typeof __VLS_export$1;
@@ -2419,7 +2775,7 @@ declare function exportToPipelineTree(flowModel: FlowModel): PipelineTree;
  *  - edge.reconnect：若源从条件网关迁出，清理旧条件
  *  - node.remove：主动查找将被级联删除的边，清理对应网关条件；
  *    若删除的是分支网关，级联删除关联的 placeholder 节点；
- *    同时清理全局变量中对被删除节点的 source_info 引用，并删除已无引用的变量
+ *    同时清理全局变量中对被删除节点的 source_info 引用，并删除已无引用的派生变量
  *  - node.move / node.set-extensions(parentId)：循环容器大小自适应（子节点移动后容器包住内容）
  */
 declare function createBkflowPlugin(): CanvasPlugin;
@@ -2443,6 +2799,28 @@ declare function createExecutionStatusPlugin(stateRef: Ref<TaskExecutionStates>)
  */
 declare function resolveExecutionActions(state: NodeExecutionState | undefined, nodeType: string): ExecutionNodeAction[];
 
+type BkuiLocale = typeof defaultRootConfig.locale;
+/** 取当前语言对应的 bkui-vue 语言包；消费方注册的第三语言从 registry 取。 */
+declare function resolveBkuiLocale(locale: string): BkuiLocale | undefined;
+/**
+ * 顶层 Flow 组件 setup 内调用：在本组件子树内应用语言（含 Teleport 弹层），
+ * 并改写 defaultRootConfig 覆盖脱离组件树的命令式 Message / InfoBox。
+ *
+ * 约束 1：必须先读 useGlobalConfig() 再合并。provideGlobalConfig 内部是
+ *   merge(defaultRootConfig, config)，直接传 { locale } 会拿 defaultRootConfig.prefix
+ *   覆盖宿主自定义的 prefix。
+ * 约束 2：zh-cn 时整段跳过，保证现有消费方零行为变化，也不会把已设为英文的宿主拽回中文。
+ *   代价是不会把 defaultRootConfig 改回中文——语言切换本就要求宿主刷新页面。
+ *
+ * 注意 defaultRootConfig 是 bkui-vue 的模块级单例，这一行的**影响范围是整个宿主应用**，
+ * 不限于本组件子树：宿主在别处调用的 bkui-vue 命令式弹窗语言也会随之变化。
+ * 这是覆盖命令式组件的唯一手段（它们没有组件上下文可供 inject），已在
+ * docs/usage.md「对宿主 bkui-vue 全局配置的影响」中对消费方说明。
+ */
+declare function applyBkuiLocaleToTree(): void;
+/** 自建 createApp 调用：该 app 脱离宿主 provide 链，从 defaultRootConfig 起步合并。 */
+declare function applyBkuiLocale(app: App): void;
+
 declare const _default: {
     FlowView: () => Promise<typeof __view_vue>;
     FlowEdit: () => Promise<typeof __edit_vue>;
@@ -2456,5 +2834,5 @@ declare const _default: {
     FlowMockDebug: () => Promise<typeof __mock_vue>;
 };
 
-export { _default$1 as BkFlowCanvas, BkFlowModelAccessor, BkFlowNodeAccessor, _default$5 as FlowCreateTask, _default$7 as FlowDebug, _default$2 as FlowDetail, _default$4 as FlowEdit, _default$6 as FlowExecute, _default$8 as FlowMockDebug, _default$3 as FlowView, bkflowConnectionValidator, createBkflowPlugin, createBkflowSchema, createExecutionStatusPlugin, _default as default, exportToPipelineTree, generateId, getUniformApiPluginFormValue, getVariableDefaultConfig, importFromPipelineTree, isMockableNode, mergeOutputs, normalizePluginOutputItems, provideFilterVariableConfig, provideFlowApiConfig, provideMemberSelectorConfig, provideSelectPanelConfig, random4, resolveExecutionActions, resolveMockFormControl, useFlowApiConfig, useFlowEditApiConfig, useFlowViewApiConfig, useMemberSelectorConfig, useSelectPanelConfig, validatePipelineTree };
-export type { Activity, CanvasViewportExpose, CreateFlowTaskResult, DndNodeItem, ExecuteFlowTaskResult, ExecutionNodeAction, FilterCandidateQuery, FilterConditionOptions, FilterConditionValue, FilterVariableConfig, FilterVariableSourceContext, FilterVariableSourceNodeComponent, FilterWhereItem, FilterWhereValue, FlowApiConfig, FlowDetailExpose, FlowDetailPermissions, FlowEditExpose, FlowTaskExecuteSuccessResult, FlowTemplate, FlowViewExpose, Gateway, GatewayCondition, GlobalVariableCreateExpose, MemberSelectorConfig, MockOutputField, NodeExecutionState, NodeExecutionStatus, NodeMockConfig, NotifyConfig, OpenFilterVariableCreateRequest, OpenGlobalVariableCreateRequest, OpenStandardVariableCreateRequest, PipelineTree, PluginDetailCommon, PluginInputDataItem, RetrievalFilterField, SelectPanelConfig, SimulateDebugCanvasContext, SimulateDebugStage, SimulateDebugState, SpaceFlowConfig, TaskExecutionStates, TemplateConfigs, TriggerCron, TriggerItem, UniformApiPluginInputsItem, UpdateFlowParams, Variable, VariableReference };
+export { _default$1 as BkFlowCanvas, BkFlowModelAccessor, BkFlowNodeAccessor, _default$5 as FlowCreateTask, _default$7 as FlowDebug, _default$2 as FlowDetail, _default$4 as FlowEdit, _default$6 as FlowExecute, _default$8 as FlowMockDebug, _default$3 as FlowView, applyBkuiLocale, applyBkuiLocaleToTree, bkflowConnectionValidator, createBkflowPlugin, createBkflowSchema, createExecutionStatusPlugin, _default as default, exportToPipelineTree, generateId, getUniformApiPluginFormValue, getVariableDefaultConfig, importFromPipelineTree, isMockableNode, mergeOutputs, normalizePluginOutputItems, provideFilterVariableConfig, provideFlowApiConfig, provideMemberSelectorConfig, provideSelectPanelConfig, provideSelectRelatedOptionConfig, random4, resolveBkuiLocale, resolveExecutionActions, resolveMockFormControl, useFlowApiConfig, useFlowEditApiConfig, useFlowViewApiConfig, useMemberSelectorConfig, useSelectPanelConfig, validatePipelineTree };
+export type { Activity, CanvasViewportExpose, CreateFlowTaskResult, DndNodeItem, ExecuteFlowTaskResult, ExecutionNodeAction, FilterCandidateQuery, FilterConditionOptions, FilterConditionValue, FilterVariableConfig, FilterVariableSourceContext, FilterVariableSourceNodeComponent, FilterWhereItem, FilterWhereValue, FlowApiConfig, FlowDetailExpose, FlowDetailPermissions, FlowEditExpose, FlowTaskExecuteSuccessResult, FlowTemplate, FlowViewExpose, Gateway, GatewayCondition, GlobalVariableCreateExpose, MemberSelectorConfig, MockOutputField, NodeExecutionState, NodeExecutionStatus, NodeMockConfig, NotifyConfig, OpenFilterVariableCreateRequest, OpenGlobalVariableCreateRequest, OpenStandardVariableCreateRequest, PipelineTree, PluginDetailCommon, PluginInputDataItem, RetrievalFilterField, SelectPanelConfig, SelectRelatedOptionConfig, SelectRelatedOptionItem, SelectRelatedOptionSource, SelectRelatedOptionSourceRef, SelectRelatedSourceContext, SimulateDebugCanvasContext, SimulateDebugStage, SimulateDebugState, SpaceFlowConfig, TaskExecutionStates, TemplateConfigs, TriggerCron, TriggerItem, UniformApiPluginInputsItem, UpdateFlowParams, Variable, VariableReference };