@yiyi_zhang/reactflow-ui 1.0.0 → 1.2.0

package/dist/template/types.d.ts

@@ -0,0 +1,99 @@
+import type { WorkflowDef } from '../types/conductor';
+/**
+ * 模板分类枚举：
+ * - compute: 资源交付与计算管理
+ * - security: 安全备份与应急合规
+ * - cost: 资源节能与成本优化
+ * - ops: 日常运维与自动自愈
+ */
+export type TemplateCategory = 'compute' | 'security' | 'cost' | 'ops';
+/**
+ * 模板变量定义（填空向导中的表单字段）
+ */
+export interface TemplateVariable {
+    /** 变量唯一键名 */
+    key: string;
+    /** 中文业务标签名称，如 "通知目标群组" */
+    label: string;
+    /** 字段辅助提示说明 */
+    help?: string;
+    /** 变量输入控件类型 */
+    type: 'text' | 'number' | 'select' | 'boolean' | 'account' | 'cron-friendly';
+    /** 默认值 */
+    defaultValue?: any;
+    /** 下拉选项 */
+    options?: {
+        label: string;
+        value: any;
+    }[];
+    /** 是否必填 */
+    required?: boolean;
+    /** 占位提示文案 */
+    placeholder?: string;
+    /**
+     * 变量注入路径列表：
+     * 支持通过 JSONPath 或属性链将该值灌入 WorkflowDef 中对应的任务参数，
+     * 例如: ["tasks[0].inputParameters.instanceName", "tasks[1].inputParameters.title"]
+     */
+    bindings: string[];
+}
+/**
+ * 模板内置的高保真拟真沙盒数据场景
+ */
+export interface MockScenario {
+    /** 场景名称，如 "默认成功场景"、"高负载触发升配场景" */
+    name: string;
+    /** 场景业务说明 */
+    description?: string;
+    /** 该场景下的工作流全局入参 */
+    workflowInput: Record<string, any>;
+    /** 任务级拟真输出覆盖映射 (taskReferenceName -> outputData) */
+    taskOutputs?: Record<string, any>;
+}
+/**
+ * 场景化工作流模板标准模型
+ */
+export interface WorkflowTemplate {
+    /** 模板唯一标识 ID */
+    id: string;
+    /** 模板版本号 */
+    version: string;
+    /** 模板中文标题，如 "核心云主机每日定时快照备份" */
+    title: string;
+    /** 所属业务分类 */
+    category: TemplateCategory;
+    /** 模板视觉图标 Emoji */
+    icon: string;
+    /** 一句话核心业务价值主张（拒绝技术罗列，讲清节省的时间与业务成效） */
+    valueProposition: string;
+    /** 详细场景背景说明 */
+    description: string;
+    /** 所需连接器图标或名称标识，如 ["cloud_host", "dingtalk"] */
+    connectors: string[];
+    /** 投资回报与提效收益指标 (ROI) */
+    roi: {
+        /** 单次执行预估节省人工分钟数 */
+        minutesSavedPerRun: number;
+        /** 典型业务每周触发频次 */
+        typicalRunsPerWeek: number;
+        /** 模板热度/累计使用次数 */
+        popularityCount?: number;
+    };
+    /** 上手难度等级 */
+    difficulty: 'starter' | 'intermediate' | 'advanced';
+    /** 填空式启用向导的必填变量清单 (2~4 项最佳) */
+    variables: TemplateVariable[];
+    /** 经过剪枝与参数化的标准 Conductor 工作流骨架 */
+    definition: WorkflowDef;
+    /** 拟真业务沙盒数据集（用于无需授权即可一键本地试跑体验） */
+    mockDataset: {
+        scenarios: MockScenario[];
+    };
+    /** 模板溯源与发布审计信息 */
+    provenance?: {
+        source: 'official' | 'extracted';
+        author?: string;
+        publishedAt?: string;
+        extractedFromWorkflowId?: string;
+    };
+}

package/dist/types/conductor.d.ts

@@ -74,6 +74,17 @@ export interface TaskDef {
     timeoutSeconds?: number;
     timeoutPolicy?: 'RETRY' | 'TIME_OUT_WF' | 'ALERT_ONLY' | 'FAIL_WORKFLOW';
 }
+/**
+ * Conductor 标准 Schema 定义（WorkflowDef / TaskDef 的 inputSchema / outputSchema）。
+ * 仅 JSON 类型会被服务端真正校验；data 为 JSON Schema 文档本身。
+ */
+export interface SchemaDef {
+    name?: string;
+    version?: number;
+    type?: 'JSON' | 'AVRO' | 'PROTOBUF' | string;
+    data?: Record<string, any>;
+    externalRef?: string;
+}
 /**
  * 工作流入参定义（结构化，向后兼容 string[] 旧格式）
  */
@@ -133,15 +144,9 @@ export interface WorkflowDef {
         concurrentExecLimit?: number;
     };
     /** 输入 Schema 定义 */
-    inputSchema?: {
-        name?: string;
-        type?: string;
-    };
+    inputSchema?: SchemaDef;
     /** 输出 Schema 定义 */
-    outputSchema?: {
-        name?: string;
-        type?: string;
-    };
+    outputSchema?: SchemaDef;
     /** 是否强制 Schema 校验 */
     enforceSchema?: boolean;
 }

package/dist/types/workflow.d.ts

@@ -205,6 +205,11 @@ export interface WorkflowState {
     isSimRunning: boolean;
     /** 每次 setWorkflow() 调用时递增，用于触发 WorkflowDesigner 的 fitView */
     workflowLoadKey: number;
+    /**
+     * 画布数据（nodes/edges/taskMap）是否落后于 workflowDef。
+     * 业务卡片视图下画布未挂载，编辑只更新定义（setWorkflowDefOnly），切回画布前再 refreshGraph()。
+     */
+    graphStale: boolean;
     /** P4.2 执行触发状态 */
     runState: RunState;
     pendingExecutionId: string | null;
@@ -237,6 +242,10 @@ export interface WorkflowState {
  */
 export interface WorkflowActions {
     setWorkflow: (workflowJson: any, direction?: LayoutDirection) => void;
+    /** 仅更新定义与校验结果，不重建画布（业务卡片视图下的高频编辑使用）；画布数据标记为过期 */
+    setWorkflowDefOnly: (workflowJson: any) => void;
+    /** 画布数据过期时，按当前定义重新解析并布局；未过期则什么都不做 */
+    refreshGraph: () => void;
     setMode: (mode: EditorMode) => void;
     setExecutionData: (data: Record<string, TaskExecutionData> | null) => void;
     updateTaskStatus: (taskRef: string, status: ExecutionStatus) => void;

package/dist/types/workflowLibrary.d.ts

@@ -17,6 +17,8 @@ export type WorkflowLevel = 'L1' | 'L2' | 'L3';
 export interface WorkflowLibraryItem {
     workflowName: string;
     workflowLevel: WorkflowLevel;
+    /** 业务域展示名（可选，如「通知协助」） */
+    domain?: string;
     version: string;
     description: string;
     tags: string[];

package/dist/utils/friendlyErrorTranslator.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 生活化错误诊断结构
+ */
+export interface FriendlyErrorDiagnosis {
+    /** 错误分类类型 */
+    type: 'auth' | 'timeout' | 'missing_data' | 'quota' | 'script_fail' | 'network' | 'unknown';
+    /** 大白话标题 */
+    title: string;
+    /** 通俗易懂的业务原因解释（普通人能看懂） */
+    explanation: string;
+    /** 系统给出的可行动建议方案 */
+    suggestion: string;
+    /** 一键快捷恢复动作文案（可选） */
+    actionLabel?: string;
+    /** 快捷动作标识（可选） */
+    actionKey?: 'reauth' | 'retry' | 'inspect_upstream' | 'change_spec' | 'contact_admin';
+}
+/**
+ * 将技术错误日志、HTTP 状态码或调用栈翻译为普通业务人员可理解的生活化诊断
+ *
+ * @param errorMessage 底层技术报错信息或异常原因 (reasonForIncompletion)
+ * @param statusCode HTTP 响应状态码 (可选)
+ * @param taskName 任务名称 (可选)
+ * @returns 业务化诊断卡片数据
+ */
+export declare function translateTechnicalError(errorMessage?: string, statusCode?: number, taskName?: string): FriendlyErrorDiagnosis;

package/dist/utils/taskTypeMeta.d.ts

@@ -1,9 +1,9 @@
 /**
  * Task Type Meta — business-friendly labels for Conductor task types
  *
- * Shared by BusinessCanvas and ProposalPreviewCard so both surfaces speak the
- * same business language for the same task type (extracted from BusinessCanvas
- * during the UX Phase A proposal-preview work).
+ * Used by ProposalPreviewCard so AI proposals speak business language for each
+ * task type (originally extracted from the former BusinessCanvas, which the AI IDE
+ * business view replaced with StepFlowEditor in 1.2.x).
  */
 export interface TaskTypeMeta {
     label: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yiyi_zhang/reactflow-ui",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Conductor Workflow IDE — Next-Gen AI-Native visual workflow designer with W-LSP data lineage, deterministic in-browser sandbox dry-run, time-travel waterfall debugger, and live split-view sync built with React 19, ReactFlow and Zustand.",
   "keywords": [
     "conductor",

package/dist/components/AiNative/BusinessCanvas.d.ts

@@ -1,15 +0,0 @@
-/**
- * BusinessCanvas — renders a WorkflowDef as business-friendly step cards
- * for non-technical users (business view mode).
- */
-import React from 'react';
-import type { WorkflowDef } from '../../types/conductor';
-interface BusinessCanvasProps {
-    workflowDef: WorkflowDef | null;
-    /** Task statuses from execution (ref → status) */
-    executionStatus?: Record<string, string>;
-    /** Called when user clicks a step to ask AI about it */
-    onStepClick?: (taskRef: string, taskType: string) => void;
-}
-declare const BusinessCanvas: React.FC<BusinessCanvasProps>;
-export default BusinessCanvas;

package/dist/components/Controls/ModeSlider.d.ts

@@ -1,2 +0,0 @@
-import './ModeSlider.css';
-export default function ModeSlider(): import("react/jsx-runtime").JSX.Element;