@robot-admin/naive-ui-components 0.10.3 → 0.11.0

package/dist/useWorkflowValidation.d.cts

@@ -0,0 +1,1051 @@
+import * as vue from "vue";
+import { Component, Ref } from "vue";
+
+//#region src/components/C_WorkFlow/types.d.ts
+/**
+ * 工作流相关类型定义
+ */
+interface User {
+  id: string;
+  name: string;
+  avatar?: string;
+  department: string;
+  role: string;
+  email?: string;
+  phone?: string;
+}
+interface Role {
+  id: string;
+  name: string;
+  description?: string;
+  level?: number;
+}
+interface Department {
+  id: string;
+  name: string;
+  parentId?: string;
+  manager?: string;
+}
+interface Condition {
+  id: string;
+  name: string;
+  field: string;
+  operator: 'equals' | 'not_equals' | 'greater_than' | 'less_than' | 'contains';
+  value: string;
+}
+type NodeStatus = 'pending' | 'approved' | 'rejected' | 'active' | 'completed';
+type NodeType = 'start' | 'approval' | 'copy' | 'condition';
+type ApprovalMode = 'any' | 'all' | 'sequence';
+type ValidationErrorType = 'required' | 'invalid' | 'incomplete' | 'warning' | 'error' | 'custom';
+interface BaseNodeData {
+  title: string;
+  status?: NodeStatus;
+  config?: Record<string, unknown>;
+  initiators?: User[];
+}
+interface StartNodeData extends BaseNodeData {
+  title: string;
+  status: 'active';
+}
+interface ApprovalNodeData extends BaseNodeData {
+  approvers?: User[];
+  approvalMode?: ApprovalMode;
+}
+interface CopyNodeData extends BaseNodeData {
+  copyUsers?: User[];
+}
+interface ConditionNodeData extends BaseNodeData {
+  conditions?: Condition[];
+}
+type NodeData = StartNodeData | ApprovalNodeData | CopyNodeData | ConditionNodeData;
+interface WorkflowNode {
+  id: string;
+  type: NodeType;
+  position: {
+    x: number;
+    y: number;
+  };
+  data: NodeData;
+  selected?: boolean;
+  dragging?: boolean;
+  connectable?: boolean;
+  selectable?: boolean;
+  deletable?: boolean;
+  dragHandle?: string;
+  width?: number;
+  height?: number;
+  parentNode?: string;
+  zIndex?: number;
+  extent?: 'parent' | [[number, number], [number, number]];
+  expandParent?: boolean;
+}
+interface WorkflowEdge {
+  id: string;
+  source: string;
+  target: string;
+  sourceHandle?: string | null;
+  targetHandle?: string | null;
+  type?: string;
+  animated?: boolean;
+  hidden?: boolean;
+  deletable?: boolean;
+  selectable?: boolean;
+  data?: unknown;
+  style?: Record<string, string | number>;
+  label?: string;
+  labelStyle?: Record<string, string | number>;
+  labelShowBg?: boolean;
+  labelBgStyle?: Record<string, string | number>;
+  labelBgPadding?: [number, number];
+  labelBgBorderRadius?: number;
+  markerStart?: string;
+  markerEnd?: string;
+}
+interface WorkflowData {
+  nodes: WorkflowNode[];
+  edges: WorkflowEdge[];
+  config?: {
+    title?: string;
+    description?: string;
+    version?: string;
+    createdAt?: string;
+    updatedAt?: string;
+  };
+}
+interface WorkflowProps {
+  users?: User[];
+  roles?: Role[];
+  departments?: Department[];
+  modelValue?: WorkflowData;
+  readonly?: boolean;
+  theme?: 'light' | 'dark';
+}
+interface WorkflowEmits {
+  'update:modelValue': [value: WorkflowData];
+  change: [value: WorkflowData];
+  'node-click': [node: WorkflowNode];
+  'edge-click': [edge: WorkflowEdge];
+  save: [data: WorkflowData];
+  'validate-error': [errors: ValidationError[]];
+}
+interface ValidationError {
+  nodeId: string;
+  nodeName: string;
+  field: string;
+  message: string;
+  type: ValidationErrorType;
+  details?: string;
+  severity?: 'low' | 'medium' | 'high';
+  fixSuggestion?: string;
+}
+interface MenuPosition {
+  x: number;
+  y: number;
+}
+interface NodeConfigFormData {
+  approval?: {
+    selectedUsers: string[];
+    approvalMode: ApprovalMode;
+  };
+  copy?: {
+    selectedUsers: string[];
+  };
+  condition?: {
+    conditions: Condition[];
+  };
+}
+interface ValidationRule {
+  field: string;
+  type: 'required' | 'min' | 'max' | 'pattern' | 'custom';
+  message: string;
+  validator?: (value: unknown, data: unknown) => boolean;
+}
+interface WorkflowConfig {
+  title?: string;
+  description?: string;
+  version?: string;
+  allowedNodeTypes?: NodeType[];
+  maxNodes?: number;
+  enableValidation?: boolean;
+  validationRules?: Record<string, ValidationRule[]>;
+  theme?: {
+    primaryColor?: string;
+    backgroundColor?: string;
+    nodeColors?: Record<NodeType, string>;
+  };
+}
+interface WorkflowStats {
+  totalNodes: number;
+  approvalNodes: number;
+  copyNodes: number;
+  conditionNodes: number;
+  totalEdges: number;
+  validationErrors: number;
+  lastModified?: string;
+}
+interface NodeTemplate {
+  id: string;
+  name: string;
+  type: NodeType;
+  description?: string;
+  defaultData: Partial<NodeData>;
+  icon?: string;
+  category?: string;
+}
+interface WorkflowUtils {
+  validateWorkflow: (data: WorkflowData) => ValidationError[];
+  exportWorkflow: (data: WorkflowData, format?: 'json' | 'yaml') => string;
+  importWorkflow: (content: string, format?: 'json' | 'yaml') => WorkflowData;
+  generateNodeId: (type: NodeType) => string;
+  generateEdgeId: (sourceId: string, targetId: string) => string;
+  cloneWorkflow: (data: WorkflowData) => WorkflowData;
+  mergeWorkflows: (workflows: WorkflowData[]) => WorkflowData;
+}
+interface WorkflowApiResponse<T = unknown> {
+  success: boolean;
+  data?: T;
+  message?: string;
+  errors?: ValidationError[];
+  timestamp?: string;
+}
+interface WorkflowHistory {
+  id: string;
+  workflowId: string;
+  version: number;
+  data: WorkflowData;
+  changes: {
+    type: 'create' | 'update' | 'delete';
+    nodeId?: string;
+    edgeId?: string;
+    description: string;
+  }[];
+  createdBy: string;
+  createdAt: string;
+}
+//#endregion
+//#region src/components/C_WorkFlow/index.vue.d.ts
+declare const __VLS_export: vue.DefineComponent<WorkflowProps, {
+  validateWorkflow: () => ValidationError[];
+  getCurrentWorkflowData: () => WorkflowData;
+  saveWorkflow: () => void;
+  previewWorkflow: () => void;
+  deleteNode: (nodeId: string) => void;
+  stats: vue.ComputedRef<{
+    totalNodes: number;
+    approvalNodes: number;
+    copyNodes: number;
+    conditionNodes: number;
+  }>;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
+  "update:modelValue": (value: WorkflowData) => any;
+  change: (value: WorkflowData) => any;
+  save: (data: WorkflowData) => any;
+  "node-click": (node: WorkflowNode) => any;
+  "validate-error": (errors: ValidationError[]) => any;
+  "edge-click": (edge: WorkflowEdge) => any;
+}, string, vue.PublicProps, Readonly<WorkflowProps> & Readonly<{
+  "onUpdate:modelValue"?: ((value: WorkflowData) => any) | undefined;
+  onChange?: ((value: WorkflowData) => any) | undefined;
+  onSave?: ((data: WorkflowData) => any) | undefined;
+  "onNode-click"?: ((node: WorkflowNode) => any) | undefined;
+  "onValidate-error"?: ((errors: ValidationError[]) => any) | undefined;
+  "onEdge-click"?: ((edge: WorkflowEdge) => any) | undefined;
+}>, {
+  theme: "light" | "dark";
+  readonly: boolean;
+  users: User[];
+  roles: Role[];
+  departments: Department[];
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+//#endregion
+//#region src/components/C_WorkFlow/composables/useWorkflowNodes.d.ts
+type EmitFn = <Event extends keyof WorkflowEmits>(event: Event, ...args: WorkflowEmits[Event]) => void;
+/** 工作流节点管理 —— 封装节点 CRUD、provide/inject、边重连、画布操作等逻辑 */
+declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn, vueFlowRef: Ref): {
+  nodes: Ref<{
+    id: string;
+    type: NodeType;
+    position: {
+      x: number;
+      y: number;
+    };
+    data: {
+      title: string;
+      status: "active";
+      config?: Record<string, unknown> | undefined;
+      initiators?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+    } | {
+      approvers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+      approvalMode?: ApprovalMode | undefined;
+      title: string;
+      status?: NodeStatus | undefined;
+      config?: Record<string, unknown> | undefined;
+      initiators?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+    } | {
+      copyUsers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+      title: string;
+      status?: NodeStatus | undefined;
+      config?: Record<string, unknown> | undefined;
+      initiators?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+    } | {
+      conditions?: {
+        id: string;
+        name: string;
+        field: string;
+        operator: "equals" | "not_equals" | "greater_than" | "less_than" | "contains";
+        value: string;
+      }[] | undefined;
+      title: string;
+      status?: NodeStatus | undefined;
+      config?: Record<string, unknown> | undefined;
+      initiators?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+    };
+    selected?: boolean | undefined;
+    dragging?: boolean | undefined;
+    connectable?: boolean | undefined;
+    selectable?: boolean | undefined;
+    deletable?: boolean | undefined;
+    dragHandle?: string | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+    parentNode?: string | undefined;
+    zIndex?: number | undefined;
+    extent?: "parent" | [[number, number], [number, number]] | undefined;
+    expandParent?: boolean | undefined;
+  }[], WorkflowNode[] | {
+    id: string;
+    type: NodeType;
+    position: {
+      x: number;
+      y: number;
+    };
+    data: {
+      title: string;
+      status: "active";
+      config?: Record<string, unknown> | undefined;
+      initiators?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+    } | {
+      approvers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+      approvalMode?: ApprovalMode | undefined;
+      title: string;
+      status?: NodeStatus | undefined;
+      config?: Record<string, unknown> | undefined;
+      initiators?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+    } | {
+      copyUsers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+      title: string;
+      status?: NodeStatus | undefined;
+      config?: Record<string, unknown> | undefined;
+      initiators?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+    } | {
+      conditions?: {
+        id: string;
+        name: string;
+        field: string;
+        operator: "equals" | "not_equals" | "greater_than" | "less_than" | "contains";
+        value: string;
+      }[] | undefined;
+      title: string;
+      status?: NodeStatus | undefined;
+      config?: Record<string, unknown> | undefined;
+      initiators?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+    };
+    selected?: boolean | undefined;
+    dragging?: boolean | undefined;
+    connectable?: boolean | undefined;
+    selectable?: boolean | undefined;
+    deletable?: boolean | undefined;
+    dragHandle?: string | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+    parentNode?: string | undefined;
+    zIndex?: number | undefined;
+    extent?: "parent" | [[number, number], [number, number]] | undefined;
+    expandParent?: boolean | undefined;
+  }[]>;
+  edges: Ref<{
+    id: string;
+    source: string;
+    target: string;
+    sourceHandle?: string | null | undefined;
+    targetHandle?: string | null | undefined;
+    type?: string | undefined;
+    animated?: boolean | undefined;
+    hidden?: boolean | undefined;
+    deletable?: boolean | undefined;
+    selectable?: boolean | undefined;
+    data?: unknown;
+    style?: Record<string, string | number> | undefined;
+    label?: string | undefined;
+    labelStyle?: Record<string, string | number> | undefined;
+    labelShowBg?: boolean | undefined;
+    labelBgStyle?: Record<string, string | number> | undefined;
+    labelBgPadding?: [number, number] | undefined;
+    labelBgBorderRadius?: number | undefined;
+    markerStart?: string | undefined;
+    markerEnd?: string | undefined;
+  }[], WorkflowEdge[] | {
+    id: string;
+    source: string;
+    target: string;
+    sourceHandle?: string | null | undefined;
+    targetHandle?: string | null | undefined;
+    type?: string | undefined;
+    animated?: boolean | undefined;
+    hidden?: boolean | undefined;
+    deletable?: boolean | undefined;
+    selectable?: boolean | undefined;
+    data?: unknown;
+    style?: Record<string, string | number> | undefined;
+    label?: string | undefined;
+    labelStyle?: Record<string, string | number> | undefined;
+    labelShowBg?: boolean | undefined;
+    labelBgStyle?: Record<string, string | number> | undefined;
+    labelBgPadding?: [number, number] | undefined;
+    labelBgBorderRadius?: number | undefined;
+    markerStart?: string | undefined;
+    markerEnd?: string | undefined;
+  }[]>;
+  showAddMenu: Ref<boolean, boolean>;
+  menuPosition: Ref<{
+    x: number;
+    y: number;
+  }, MenuPosition | {
+    x: number;
+    y: number;
+  }>;
+  showNodeConfig: Ref<boolean, boolean>;
+  currentNode: Ref<{
+    id: string;
+    type: NodeType;
+    position: {
+      x: number;
+      y: number;
+    };
+    data: {
+      title: string;
+      status: "active";
+      config?: Record<string, unknown> | undefined;
+      initiators?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+    } | {
+      approvers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+      approvalMode?: ApprovalMode | undefined;
+      title: string;
+      status?: NodeStatus | undefined;
+      config?: Record<string, unknown> | undefined;
+      initiators?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+    } | {
+      copyUsers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+      title: string;
+      status?: NodeStatus | undefined;
+      config?: Record<string, unknown> | undefined;
+      initiators?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+    } | {
+      conditions?: {
+        id: string;
+        name: string;
+        field: string;
+        operator: "equals" | "not_equals" | "greater_than" | "less_than" | "contains";
+        value: string;
+      }[] | undefined;
+      title: string;
+      status?: NodeStatus | undefined;
+      config?: Record<string, unknown> | undefined;
+      initiators?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+    };
+    selected?: boolean | undefined;
+    dragging?: boolean | undefined;
+    connectable?: boolean | undefined;
+    selectable?: boolean | undefined;
+    deletable?: boolean | undefined;
+    dragHandle?: string | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+    parentNode?: string | undefined;
+    zIndex?: number | undefined;
+    extent?: "parent" | [[number, number], [number, number]] | undefined;
+    expandParent?: boolean | undefined;
+  } | null, WorkflowNode | {
+    id: string;
+    type: NodeType;
+    position: {
+      x: number;
+      y: number;
+    };
+    data: {
+      title: string;
+      status: "active";
+      config?: Record<string, unknown> | undefined;
+      initiators?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+    } | {
+      approvers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+      approvalMode?: ApprovalMode | undefined;
+      title: string;
+      status?: NodeStatus | undefined;
+      config?: Record<string, unknown> | undefined;
+      initiators?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+    } | {
+      copyUsers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+      title: string;
+      status?: NodeStatus | undefined;
+      config?: Record<string, unknown> | undefined;
+      initiators?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+    } | {
+      conditions?: {
+        id: string;
+        name: string;
+        field: string;
+        operator: "equals" | "not_equals" | "greater_than" | "less_than" | "contains";
+        value: string;
+      }[] | undefined;
+      title: string;
+      status?: NodeStatus | undefined;
+      config?: Record<string, unknown> | undefined;
+      initiators?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+    };
+    selected?: boolean | undefined;
+    dragging?: boolean | undefined;
+    connectable?: boolean | undefined;
+    selectable?: boolean | undefined;
+    deletable?: boolean | undefined;
+    dragHandle?: string | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+    parentNode?: string | undefined;
+    zIndex?: number | undefined;
+    extent?: "parent" | [[number, number], [number, number]] | undefined;
+    expandParent?: boolean | undefined;
+  } | null>;
+  nodeTypes: vue.ComputedRef<Record<string, Component>>;
+  workflowStats: vue.ComputedRef<{
+    totalNodes: number;
+    approvalNodes: number;
+    copyNodes: number;
+    conditionNodes: number;
+  }>;
+  addNode: (type: NodeType) => void;
+  onNodeClick: (event: {
+    node: WorkflowNode;
+  }) => void;
+  closeAddMenu: () => void;
+  handleConfigSave: (configData: Record<string, unknown>) => void;
+  resetNodes: () => void;
+  getCurrentWorkflowData: () => WorkflowData;
+  fitView: () => void;
+  deleteNode: (nodeId: string) => void;
+};
+//#endregion
+//#region src/components/C_WorkFlow/composables/useWorkflowPreview.d.ts
+/** 详情项类型 */
+type DetailItemType = 'text' | 'mode' | 'users' | 'warning';
+/** 结构化详情项 */
+interface DetailItem {
+  type: DetailItemType;
+  label: string;
+  value?: string;
+  users?: {
+    name: string;
+    department?: string;
+  }[];
+  modeKey?: string;
+}
+/** 流程步骤（已排序） */
+interface FlowStep {
+  order: number;
+  node: WorkflowNode;
+  nodeTypeLabel: string;
+  icon: string;
+  colorClass: string;
+  details: DetailItem[];
+  children?: FlowStep[];
+}
+/** 预览统计信息 */
+interface PreviewStats {
+  totalNodes: number;
+  approvalNodes: number;
+  copyNodes: number;
+  conditionNodes: number;
+  totalEdges: number;
+}
+/** 工作流预览 —— 封装流程预览逻辑、节点排序和步骤展示 */
+declare function useWorkflowPreview(nodes: Ref<WorkflowNode[]>, edges: Ref<WorkflowEdge[]>): {
+  showPreview: Ref<boolean, boolean>;
+  previewSteps: Ref<{
+    order: number;
+    node: {
+      id: string;
+      type: NodeType;
+      position: {
+        x: number;
+        y: number;
+      };
+      data: {
+        title: string;
+        status: "active";
+        config?: Record<string, unknown> | undefined;
+        initiators?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
+      } | {
+        approvers?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
+        approvalMode?: ApprovalMode | undefined;
+        title: string;
+        status?: NodeStatus | undefined;
+        config?: Record<string, unknown> | undefined;
+        initiators?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
+      } | {
+        copyUsers?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
+        title: string;
+        status?: NodeStatus | undefined;
+        config?: Record<string, unknown> | undefined;
+        initiators?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
+      } | {
+        conditions?: {
+          id: string;
+          name: string;
+          field: string;
+          operator: "equals" | "not_equals" | "greater_than" | "less_than" | "contains";
+          value: string;
+        }[] | undefined;
+        title: string;
+        status?: NodeStatus | undefined;
+        config?: Record<string, unknown> | undefined;
+        initiators?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
+      };
+      selected?: boolean | undefined;
+      dragging?: boolean | undefined;
+      connectable?: boolean | undefined;
+      selectable?: boolean | undefined;
+      deletable?: boolean | undefined;
+      dragHandle?: string | undefined;
+      width?: number | undefined;
+      height?: number | undefined;
+      parentNode?: string | undefined;
+      zIndex?: number | undefined;
+      extent?: "parent" | [[number, number], [number, number]] | undefined;
+      expandParent?: boolean | undefined;
+    };
+    nodeTypeLabel: string;
+    icon: string;
+    colorClass: string;
+    details: {
+      type: DetailItemType;
+      label: string;
+      value?: string | undefined;
+      users?: {
+        name: string;
+        department?: string | undefined;
+      }[] | undefined;
+      modeKey?: string | undefined;
+    }[];
+    children?: /*elided*/any[] | undefined;
+  }[], FlowStep[] | {
+    order: number;
+    node: {
+      id: string;
+      type: NodeType;
+      position: {
+        x: number;
+        y: number;
+      };
+      data: {
+        title: string;
+        status: "active";
+        config?: Record<string, unknown> | undefined;
+        initiators?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
+      } | {
+        approvers?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
+        approvalMode?: ApprovalMode | undefined;
+        title: string;
+        status?: NodeStatus | undefined;
+        config?: Record<string, unknown> | undefined;
+        initiators?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
+      } | {
+        copyUsers?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
+        title: string;
+        status?: NodeStatus | undefined;
+        config?: Record<string, unknown> | undefined;
+        initiators?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
+      } | {
+        conditions?: {
+          id: string;
+          name: string;
+          field: string;
+          operator: "equals" | "not_equals" | "greater_than" | "less_than" | "contains";
+          value: string;
+        }[] | undefined;
+        title: string;
+        status?: NodeStatus | undefined;
+        config?: Record<string, unknown> | undefined;
+        initiators?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
+      };
+      selected?: boolean | undefined;
+      dragging?: boolean | undefined;
+      connectable?: boolean | undefined;
+      selectable?: boolean | undefined;
+      deletable?: boolean | undefined;
+      dragHandle?: string | undefined;
+      width?: number | undefined;
+      height?: number | undefined;
+      parentNode?: string | undefined;
+      zIndex?: number | undefined;
+      extent?: "parent" | [[number, number], [number, number]] | undefined;
+      expandParent?: boolean | undefined;
+    };
+    nodeTypeLabel: string;
+    icon: string;
+    colorClass: string;
+    details: {
+      type: DetailItemType;
+      label: string;
+      value?: string | undefined;
+      users?: {
+        name: string;
+        department?: string | undefined;
+      }[] | undefined;
+      modeKey?: string | undefined;
+    }[];
+    children?: /*elided*/any[] | undefined;
+  }[]>;
+  previewStats: Ref<{
+    totalNodes: number;
+    approvalNodes: number;
+    copyNodes: number;
+    conditionNodes: number;
+    totalEdges: number;
+  }, PreviewStats | {
+    totalNodes: number;
+    approvalNodes: number;
+    copyNodes: number;
+    conditionNodes: number;
+    totalEdges: number;
+  }>;
+  openPreview: () => void;
+  closePreview: () => void;
+};
+//#endregion
+//#region src/components/C_WorkFlow/composables/useWorkflowValidation.d.ts
+interface WorkflowValidationOptions {
+  /** 定位错误节点后打开配置弹窗的回调 */
+  onShowNodeConfig?: (node: WorkflowNode) => void;
+  /** 验证失败时的外部回调（通常用于 emit） */
+  onValidateError?: (errors: ValidationError[]) => void;
+}
+/** 工作流验证 —— 封装流程校验逻辑、错误展示和节点定位 */
+declare function useWorkflowValidation(nodes: Ref<WorkflowNode[]>, edges: Ref<WorkflowEdge[]>, vueFlowRef: Ref, options?: WorkflowValidationOptions): {
+  validationErrors: Ref<{
+    nodeId: string;
+    nodeName: string;
+    field: string;
+    message: string;
+    type: ValidationErrorType;
+    details?: string | undefined;
+    severity?: "low" | "medium" | "high" | undefined;
+    fixSuggestion?: string | undefined;
+  }[], ValidationError[] | {
+    nodeId: string;
+    nodeName: string;
+    field: string;
+    message: string;
+    type: ValidationErrorType;
+    details?: string | undefined;
+    severity?: "low" | "medium" | "high" | undefined;
+    fixSuggestion?: string | undefined;
+  }[]>;
+  showValidationErrors: Ref<boolean, boolean>;
+  validateWorkflow: () => ValidationError[];
+  validateCurrentWorkflow: () => void;
+  jumpToErrorNode: (nodeId: string) => void;
+  getFieldDisplayName: (field: string) => string;
+  getErrorTypeText: (type: string) => string;
+  resetValidation: () => void;
+};
+//#endregion
+export { WorkflowProps as A, WorkflowApiResponse as C, WorkflowEmits as D, WorkflowEdge as E, WorkflowUtils as M, WorkflowHistory as O, ValidationErrorType as S, WorkflowData as T, NodeType as _, ApprovalMode as a, User as b, Condition as c, Department as d, MenuPosition as f, NodeTemplate as g, NodeStatus as h, _default as i, WorkflowStats as j, WorkflowNode as k, ConditionNodeData as l, NodeData as m, useWorkflowPreview as n, ApprovalNodeData as o, NodeConfigFormData as p, useWorkflowNodes as r, BaseNodeData as s, useWorkflowValidation as t, CopyNodeData as u, Role as v, WorkflowConfig as w, ValidationError as x, StartNodeData as y };