@yugu-ui/flow-ui 0.0.0-stage → 0.1.0

package/dist/timeline/ApprovalModal.d.ts

@@ -0,0 +1,47 @@
+import { UploadResource } from './types';
+import { FlowNodeItem } from './FlowNode';
+type __VLS_Props = {
+    /** 审批类型：approve=同意 / reject=驳回（决定弹窗标题） */
+    type?: 'approve' | 'reject';
+    /** 流程节点数据（驳回时用于选择驳回目标） */
+    nodes?: FlowNodeItem[];
+};
+type __VLS_ModelProps = {
+    'visible'?: boolean;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:visible": (value: boolean) => any;
+} & {
+    submitted: (value: {
+        opinion: string;
+        attachments: UploadResource[];
+        /** 驳回目标节点名称（仅驳回时存在） */
+        rejectNode?: string;
+        /** 驳回目标人员名称（仅驳回时存在） */
+        rejectUser?: string;
+        /** 驳回目标节点 ID（驳回接口 reject_node_id） */
+        rejectNodeId?: string;
+        /** 驳回目标人员 ID（驳回接口 reject_user_id，仅审批人节点携带） */
+        rejectUserId?: string;
+    }, done: (shouldClose?: boolean) => void) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:visible"?: ((value: boolean) => any) | undefined;
+    onSubmitted?: ((value: {
+        opinion: string;
+        attachments: UploadResource[];
+        /** 驳回目标节点名称（仅驳回时存在） */
+        rejectNode?: string;
+        /** 驳回目标人员名称（仅驳回时存在） */
+        rejectUser?: string;
+        /** 驳回目标节点 ID（驳回接口 reject_node_id） */
+        rejectNodeId?: string;
+        /** 驳回目标人员 ID（驳回接口 reject_user_id，仅审批人节点携带） */
+        rejectUserId?: string;
+    }, done: (shouldClose?: boolean) => void) => any) | undefined;
+}>, {
+    type: "approve" | "reject";
+    nodes: FlowNodeItem[];
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/timeline/FlowAvatar.d.ts

@@ -0,0 +1,11 @@
+type __VLS_Props = {
+    /** 姓名（占位头像取首字并生成背景色） */
+    name: string;
+    /** 头像地址（为空时用姓名首字占位） */
+    avatar?: string;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    avatar: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/timeline/FlowLayout.d.ts

@@ -0,0 +1,42 @@
+import { WflowTodoDetail } from '../adapter/wflow';
+/** 页面加载状态（透传给 BaseCard，控制内容区 loading 遮罩）；flowId=流程 ID（display 模式传流程实例 ID 仅作标识，同意/驳回接口入参为详情返回的 undo_id；form 模式作为提交数据 flow_id） */
+type __VLS_Props = {
+    loading?: boolean;
+    flowId?: string | number;
+    /** 渲染模式：display=审批详情（同意/驳回）；form=发起流程（节点无状态、自选审批人为选择器、底部提交） */
+    mode?: 'display' | 'form';
+    /** form 模式提交前置校验钩子：返回 false 阻止提交（页面注入表单必填校验） */
+    beforeSubmit?: () => Promise<boolean> | boolean;
+    /** form 模式提交数据获取钩子：校验全部通过后调用，返回页面表单数据用于组装并打印提交数据 */
+    getFormData?: () => Record<string, unknown>;
+    /** display 模式原始数据：流程实例详情（节点快照自带任务状态与每人处理结果 + status/finished 实例状态 + undo_id 待办审批记录 ID + undo_finished 处理状态），组件内部映射为审批时间线并对接同意/驳回接口，页面无需转换；nodes 为空时节点区展示空态提示 */
+    timelineData?: Pick<WflowTodoDetail, 'nodes' | 'finished' | 'status' | 'undo_id' | 'undo_finished'>;
+};
+/** 条件字段是否全部填写完成：条件字段值取自父组件表单数据（数组非空 / 非 null / 非空串；流程无条件字段时视为填齐），暴露给父组件提交校验调用 */
+declare function isConditionsFilled(): boolean;
+/** 请求流程节点（暴露给父组件在表单变化防抖后调用）：先等待流程配置就绪（条件字段提取完成）再校验条件字段填齐，随后携带整份表单数据 + 流程 ID 请求，后端按表单值匹配条件分支；条件字段未填齐/请求失败/返回为空时节点链保持不变（节点区空态提示） */
+declare function fetchFlowNodes(): Promise<void>;
+declare var __VLS_10: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_10) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {
+    fetchFlowNodes: typeof fetchFlowNodes;
+    isConditionsFilled: typeof isConditionsFilled;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    success: () => any;
+    close: () => any;
+    submitted: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSuccess?: (() => any) | undefined;
+    onClose?: (() => any) | undefined;
+    onSubmitted?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/timeline/FlowNode.d.ts

@@ -0,0 +1,103 @@
+import { SelectedItem } from '../person-selector/types';
+/** 流程节点类型 */
+export type FlowNodeType = 'start' | 'approver' | 'cc' | 'end';
+/** 节点状态 */
+export type FlowNodeStatus = 'done' | 'doing' | 'rejected' | 'pending';
+/** 审批方式（审批人节点） */
+export type FlowApproveMode = 'countersign' | 'orsign' | 'sequence';
+/** 审批附件 */
+export interface FlowNodeAttachment {
+    /** 文件名 */
+    name: string;
+    /** 文件地址 */
+    url?: string;
+}
+/** 人员操作记录（display 审批详情：同一人员可有多条，含审批成功与驳回） */
+export interface FlowNodeUserRecord {
+    /** 记录类型：approve=审批成功 / reject=驳回 */
+    type: 'approve' | 'reject';
+    /** 操作时间（成功=审批时间 / 驳回=驳回时间） */
+    time?: string;
+    /** 驳回目标人员名（本人主动驳回记录，来自 rejecters，展示「驳回到 xxx」） */
+    rejectNode?: string;
+    /** 驳回人名（被驳回记录，来自记录操作人 user_name，展示「被 xxx 驳回」） */
+    rejectBy?: string;
+    /** 审批意见 */
+    opinion?: string;
+    /** 附件列表 */
+    attachments?: FlowNodeAttachment[];
+}
+/** 流程节点人员 */
+export interface FlowNodeUser {
+    /** 人员主键（form 发起模式接口注入带 id，display 审批详情 mock 不带） */
+    id?: number | string;
+    /** 姓名 */
+    name: string;
+    /** 头像（为空时用姓名首字生成占位头像） */
+    avatar?: string;
+    /** 人员审批状态（未标注则不做状态区分） */
+    status?: FlowNodeStatus;
+    /** 存在未处理任务行（当前轮次待办未完成，不能作为驳回目标） */
+    pendingTask?: boolean;
+    /** 操作记录列表（多条，有记录才可点击查看弹层） */
+    records?: FlowNodeUserRecord[];
+}
+/** 流程节点（时间线数据项） */
+export interface FlowNodeItem {
+    /** 节点 ID（display 详情模式来自节点快照，审批驳回接口 reject_node_id 取值） */
+    id?: string;
+    /** 节点类型 */
+    type: FlowNodeType;
+    /** 节点状态 */
+    status?: FlowNodeStatus;
+    /** 节点名称 */
+    name: string;
+    /** 节点描述（审批人节点可省略，由 mode 生成标准文案） */
+    desc?: string;
+    /** 审批方式（仅审批人节点） */
+    mode?: FlowApproveMode;
+    /** 自选审批人标记（表单模式下人员区域渲染为人员选择器） */
+    selfSelect?: boolean;
+    /** 节点人员列表 */
+    users: FlowNodeUser[];
+    /** 发生时间（未发生为空） */
+    time?: string;
+}
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import('vue').DefineComponent<{
+    /** 节点数据 */
+    node: FlowNodeItem;
+    /** 模式：display=展示 / select=可选择 / form=表单 */
+    mode?: "display" | "select" | "form";
+    /** 当前选中项（节点ID::人员ID），仅 select 模式 */
+    selectedKey?: string | null;
+    /** 人员折叠阈值：超出该人数时默认折叠展示，尾部显示展开/收起按钮 */
+    collapseCount?: number;
+} & {
+    /** 表单模式自选审批人：已选人员（v-model:selectedUsers 双向绑定供父组件获取，未绑定时组件内自持） */
+    selectedUsers?: SelectedItem[];
+}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:selectedUsers": (value: SelectedItem[]) => any;
+} & {
+    select: (key: string) => any;
+}, string, import('vue').PublicProps, Readonly<{
+    /** 节点数据 */
+    node: FlowNodeItem;
+    /** 模式：display=展示 / select=可选择 / form=表单 */
+    mode?: "display" | "select" | "form";
+    /** 当前选中项（节点ID::人员ID），仅 select 模式 */
+    selectedKey?: string | null;
+    /** 人员折叠阈值：超出该人数时默认折叠展示，尾部显示展开/收起按钮 */
+    collapseCount?: number;
+} & {
+    /** 表单模式自选审批人：已选人员（v-model:selectedUsers 双向绑定供父组件获取，未绑定时组件内自持） */
+    selectedUsers?: SelectedItem[];
+}> & Readonly<{
+    onSelect?: ((key: string) => any) | undefined;
+    "onUpdate:selectedUsers"?: ((value: SelectedItem[]) => any) | undefined;
+}>, {
+    mode: "display" | "select" | "form";
+    selectedKey: string | null;
+    collapseCount: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;

package/dist/timeline/flowUserKey.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 时间线人员选项唯一 key 共享模块
+ *
+ * 契约：`${节点ID ?? 节点名称}::${人员ID ?? 人员名称}`
+ * 拼接侧（FlowNode select 模式上抛选中项）与解析侧（ApprovalModal 驳回目标反查）共用。
+ */
+/** 节点/人员的最小结构（仅 id 与 name，FlowNodeItem / FlowNodeUser 天然兼容） */
+interface KeySource {
+    /** 主键（缺省回落名称） */
+    id?: number | string;
+    /** 名称 */
+    name: string;
+}
+/** 拼接人员选项 key：节点ID::人员ID（缺省回落名称） */
+export declare function getUserKey(node: KeySource, user: KeySource): string;
+/** 解析人员选项 key：返回 [节点 key, 人员 key] */
+export declare function parseUserKey(key: string): [string, string];
+export {};

package/dist/timeline/types.d.ts

@@ -0,0 +1,9 @@
+/** 附件资源（流程审批附件列表项，与宿主文件上传组件导出的同名接口契约一致） */
+export interface UploadResource {
+    id: number | string;
+    file_name: string;
+    original_filename: string;
+    url: string;
+    size: number;
+    content_type: string;
+}

package/dist/utils/common.d.ts

@@ -0,0 +1,4 @@
+/** 判断是否为空（undefined/null/空字符串） */
+export declare function isNull(value: any): boolean;
+/** 时间格式化：兼容 10/13 位时间戳、字符串与 Date，空值返回 '--' */
+export declare function formatTime(value: any, format?: string): string;

package/package.json

@@ -1,6 +1,57 @@
 {
   "name": "@yugu-ui/flow-ui",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "堉古商城流程组件库：流程设计器（config）/ 审批时间线（timeline）/ 流程列表（FlowList）",
+  "type": "module",
+  "license": "UNLICENSED",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./style.css": "./dist/style.css"
+  },
+  "peerDependencies": {
+    "@antv/x6": ">=3.1.0",
+    "@antv/x6-vue-shape": ">=3.0.0",
+    "naive-ui": ">=2.40.0",
+    "vue": ">=3.3.0"
+  },
+  "dependencies": {
+    "dayjs": "1.11.20"
+  },
+  "devDependencies": {
+    "@antv/x6": "^3.1.8",
+    "@antv/x6-vue-shape": "^3.0.2",
+    "@vitejs/plugin-vue": "6.0.6",
+    "naive-ui": "2.44.1",
+    "typescript": "6.0.3",
+    "unocss": "^66.6.8",
+    "unplugin-dts": "^1.1.2",
+    "unplugin-vue-components": "32.0.0",
+    "vite": "8.0.12",
+    "vue": "3.5.34",
+    "vue-tsc": "3.2.8",
+    "@sa/uno-preset": "2.2.0"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "vite build --config vite.lib.config.ts",
+    "typecheck": "vue-tsc --noEmit --skipLibCheck"
+  }
 }