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

package/README.md

@@ -1,3 +1,344 @@
-# Temporary Holding Version
+# @yugu-ui/flow-ui
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+ygmops 工作流 UI 组件库（Vue 3 + naive-ui），提供流程列表、流程设计器、审批时间线三大能力：
+
+| 组件 | 用途 |
+| --- | --- |
+| `FlowList` | 流程分组卡片列表（浏览 / 发起 / 设计入口） |
+| `FlowConfig` / `FlowConfigField` / `FlowConfigMore` | 流程设计器（字段配置 / 流程画布 / 更多设置 三页签） |
+| `FlowLayout` / `FlowNode` / `ApprovalModal` | 审批时间线（审批详情 `display` 模式 / 发起流程 `form` 模式） |
+| `PersonSelector` | 人员 / 部门 / 角色选择器 |
+| `createFlowUI` / `useFlowUI` | 全局注入协议（请求能力、人员选择接口、能力组件） |
+
+ESM-only，附带完整 TypeScript 类型（`dist/index.d.ts`）。
+
+## 环境要求
+
+- Node.js >= 20.19.0
+- Vue >= 3.3.0
+- naive-ui >= 2.40.0
+
+## 安装
+
+```bash
+pnpm add @yugu-ui/flow-ui
+```
+
+`dayjs` 为普通依赖，随本包自动安装。以下 peer 依赖需宿主工程自行提供（通常已有）：
+
+| 包 | 版本要求 | 说明 |
+| --- | --- | --- |
+| `vue` | >= 3.3.0 | |
+| `naive-ui` | >= 2.40.0 | 组件均基于其主题体系与基础组件 |
+| `@antv/x6` | >= 3.1.0 | 仅流程画布用到（`FlowConfig`） |
+| `@antv/x6-vue-shape` | >= 3.0.0 | 仅流程画布用到（`FlowConfig`） |
+
+```bash
+pnpm add vue naive-ui @antv/x6 @antv/x6-vue-shape
+```
+
+### 文件预览（可选）
+
+流程节点附件预览支持图片、视频与 office 文档。图片 / 视频开箱即用；**pdf / docx / excel / pptx** 依赖 `@vue-office/*` 按需动态加载：
+
+```bash
+# 按需安装需要的格式即可
+pnpm add @vue-office/pdf @vue-office/docx @vue-office/excel @vue-office/pptx
+```
+
+未安装时文档类预览自动降级为「不支持预览该文件，请下载后查看」并保留下载按钮，不影响其他功能。
+
+> 生产部署提示：文档类预览的文件 URL 若属于 `https://download.yugu8.com` 域，会被改写为 `/download-proxy/...` 同域路径以规避跨域。dev 环境由 vite proxy 转发，**生产环境需在 nginx 配置同名 `/download-proxy` 反向代理**。
+
+## 快速开始
+
+### 1. 引入样式（一次即可）
+
+```ts
+// main.ts
+import '@yugu-ui/flow-ui/style.css';
+```
+
+`style.css` 包含 UnoCSS 工具类产物与全部组件样式，一次引入即完整，无需额外配置。
+
+> **引入顺序要求**：包样式中含通用工具类（如 `.hidden` 等 UnoCSS 产物）。请确保 `import '@yugu-ui/flow-ui/style.css'` 位于宿主自身的 UnoCSS 入口（`import 'uno.css'`）与全局样式**之前**——第三方库样式先注入、宿主规则后注入，否则同名类会以同优先级「后到覆盖」宿主规则（例如宿主页面的 `hidden xl:block` 响应式显隐可能失效）。
+
+### 2. 注入 createFlowUI
+
+包内组件的请求能力、人员选择接口均从注入协议获取。在 `NConfigProvider` **之内**（应用根组件）完成安装：
+
+```ts
+// main.ts
+import { createFlowUI } from '@yugu-ui/flow-ui';
+import { request } from '@/service'; // 宿主的请求封装
+import { getAuthorization } from '@/service/request/helpers';
+import FileUpload from '@/components/custom/file-upload.vue'; // 附件上传组件（能力注入）
+
+const app = createApp(App);
+
+app.use(
+  createFlowUI({
+    /** 必填：请求函数（平面函数式），约定签名 (config) => Promise<{ data, error }> */
+    request,
+    /** 返回完整 Authorization 头值（含 scheme 前缀），缺省返回空串 */
+    getToken: () => getAuthorization() ?? '',
+    /** 接口 baseURL，缺省空串（走相对路径） */
+    baseURL: import.meta.env.VITE_SERVICE_BASE_URL,
+    /** 人员选择接口，缺省 GET /system/person-selector */
+    // personSelectorApi: '/system/person-selector',
+    /** 能力组件注入：包内附件上传场景动态消费 */
+    components: { FileUpload }
+  })
+);
+```
+
+所有配置项均可通过 `useFlowUI()` 在 setup 上下文中读取；未注入时组件发出一次 DEV 告警并降级运行（请求走 error 分支），不会抛错阻断渲染。
+
+### 3. 使用 FlowList
+
+`FlowList` 数据完全由外部传入（分组接口为宿主自有），典型接入：
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { useRouter } from 'vue-router';
+import { FlowList } from '@yugu-ui/flow-ui';
+import type { FlowGroup, FlowItem } from '@yugu-ui/flow-ui';
+import { fetchGetWflowCenter } from '@/service/api'; // 宿主分组列表接口
+
+const router = useRouter();
+const groups = ref<FlowGroup[]>([]);
+
+/** 后端返回结构映射为 FlowGroup[] */
+async function fetchCenter() {
+  const { data, error } = await fetchGetWflowCenter();
+  if (!error && data) {
+    groups.value = data.map(group => ({
+      id: String(group.id),
+      title: group.name ?? '',
+      items: (group.flows ?? []).map(flow => ({
+        id: String(flow.id),
+        code: flow.code || '',
+        name: flow.name ?? '',
+        icon: flow.icon || '' // 图标图片 URL，为空时卡片兜底默认图标
+      }))
+    }));
+  }
+}
+fetchCenter();
+
+function handleItemClick(item: FlowItem) {
+  // 点击流程卡片：跳转发起流程页等
+  console.log('item-click', item);
+}
+
+function handleDesign(item: FlowItem) {
+  // 点击设计按钮：跳转设计页
+  router.push({ path: '/business-config/flow-design', query: { id: item.id, name: item.name } });
+}
+</script>
+
+<template>
+  <FlowList :groups="groups" @item-click="handleItemClick" @design="handleDesign" />
+</template>
+```
+
+## 主题要求（重要）
+
+所有组件的配色变量（`--fc-*` / `--fl-*`）在运行时从 naive-ui `useThemeVars()` 读取，经组件根节点 `:style` 注入。因此：
+
+1. **组件必须渲染在 `<n-config-provider>` 作用域之内**，否则拿不到主题变量（静态 CSS 中变量只有使用、没有定义）；
+2. 变量跟随宿主主题自动切换，**暗黑模式无需任何额外处理**；
+3. 宿主无需手动定义任何 `--fc-*` / `--fl-*` 变量。
+
+## 全局提示依赖 window.\$message
+
+组件内部的轻提示（提交成功、校验告警等）统一调用 `window.$message`（naive-ui Message API）。宿主需在应用初始化时挂载，例如在 `NMessageProvider` 作用域内：
+
+```ts
+// app-provider.vue
+import { useMessage } from 'naive-ui';
+window.$message = useMessage();
+```
+
+未挂载时提示静默跳过（内部均为可选链调用），功能不受影响。
+
+## 组件 API
+
+### FlowList — 流程列表
+
+```ts
+interface Props {
+  /** 分组数据（必填） */
+  groups: FlowGroup[];
+  /** 是否展示卡片右下角「设计」操作，默认 true */
+  showActions?: boolean;
+  /** 卡片是否可点击（item-click 生效），默认 false */
+  clickable?: boolean;
+}
+
+interface Emits {
+  /** 点击流程卡片（clickable=true 时） */
+  itemClick: [item: FlowItem];
+  /** 点击「设计」按钮 */
+  design: [item: FlowItem];
+}
+```
+
+```ts
+// 数据类型
+interface FlowItem {
+  id: string;        // 唯一标识
+  code?: string;     // 流程编码
+  name: string;      // 流程名称
+  icon?: string;     // 图标图片 URL
+}
+interface FlowGroup {
+  id: string;        // 唯一标识
+  title: string;     // 分组标题
+  items: FlowItem[]; // 组内流程项
+}
+```
+
+### FlowLayout — 审批时间线
+
+页面级组件，底部自带确认 / 关闭操作区。
+
+```ts
+interface Props {
+  /** 页面加载状态（控制内容区 loading 遮罩） */
+  loading?: boolean;
+  /** 流程 ID：display 模式传流程实例 ID（仅作标识）；form 模式作为提交数据 flow_id */
+  flowId?: string | number;
+  /** display=审批详情（同意/驳回）；form=发起流程（自选审批人为选择器、底部提交）。默认 display */
+  mode?: 'display' | 'form';
+  /** form 模式提交前置校验钩子：返回 false 阻止提交（页面注入表单必填校验） */
+  beforeSubmit?: () => Promise<boolean> | boolean;
+  /** form 模式提交数据获取钩子：校验全部通过后调用，返回页面表单数据 */
+  getFormData?: () => Record<string, unknown>;
+  /** display 模式原始数据：直接传待办详情接口返回数据，组件内部映射为审批时间线 */
+  timelineData?: Pick<WflowTodoDetail, 'nodes' | 'finished' | 'status' | 'undo_id' | 'undo_finished'>;
+}
+
+interface Emits {
+  /** 审批同意/驳回接口调用成功：通知页面刷新详情 */
+  success: [];
+  /** 点击关闭按钮：display=关闭详情页，form=取消发起 */
+  close: [];
+  /** form 模式流程提交成功 */
+  submitted: [];
+}
+```
+
+**`submitted` / `close` 回调关页签说明**：组件已与路由和页签机制解耦，提交成功（`submitted`）与关闭（`close`）时只通知消费页，**当前页签的关闭 / 跳转由宿主自行处理**：
+
+```vue
+<template>
+  <FlowLayout
+    mode="form"
+    :flow-id="flowId"
+    :before-submit="validateForm"
+    :get-form-data="getFormData"
+    @submitted="handleSubmitted"
+    @close="handleClose"
+  />
+</template>
+
+<script setup lang="ts">
+// 组件内部已 toast「流程提交成功」，页面只需收尾：
+function handleSubmitted() {
+  router.back();
+  // 或接入宿主页签机制，如 tabStore.removeTab(route.fullPath)
+}
+function handleClose() {
+  router.back();
+}
+</script>
+```
+
+`display` 模式接入示例（审批详情页）：
+
+```vue
+<FlowLayout
+  :loading="loading"
+  :flow-id="instanceId"
+  :timeline-data="detail ?? undefined"
+  @success="getDetail"
+/>
+```
+
+### FlowConfig — 流程设计器
+
+```ts
+interface Props {
+  flowName?: string;
+  /** 初始页签：'form' | 'flow' | 'more' */
+  activeTab?: 'form' | 'flow' | 'more';
+  /** 回显数据：此前保存打印的 { fields, flow, more } 结构，flow 为嵌套子节点链（链首 start 节点） */
+  data?: Record<string, any> | null;
+  /** 父组件保存落库中（保存按钮联动 loading，publish 后由父组件回传状态） */
+  publishing?: boolean;
+  /** 外部流程标识：1=隐藏内置配置项，0=展示全部（缺省默认） */
+  isExternal?: 0 | 1;
+}
+
+interface Emits {
+  formChange: [data: any];
+  flowChange: [data: any];
+  moreChange: [data: any];
+  /** 保存：携带完整 { fields, flow, more }，父组件负责落库并将结果回传 publishing */
+  publish: [data: { fields: unknown[]; flow: Record<string, unknown>; more: Record<string, unknown> }];
+}
+```
+
+## 其他导出
+
+- **接口层**（wflow 协议内置实现）：`fetchGetWflowConfigDetail`、`fetchGetWflowFlowNodes`、`fetchLaunchWflowFlow`、`fetchWflowUndoApprove`、`fetchWflowUndoReject`，配套 `WflowConfigDetail`、`WflowFlowLaunchParams`、`WflowTodoDetail` 等类型；
+- **人员选择器**：`PersonSelector` 组件及 `SelectedItem`、`PersonSelectorData` 等类型；
+- **注入协议**：`createFlowUI`、`useFlowUI`、`FLOW_UI_KEY` 及 `FlowUIOptions`、`FlowUIRequest` 等类型；
+- **审批时间线类型**：`FlowNodeItem`、`FlowNodeStatus`、`UploadResource` 等。
+
+## Tree-shaking
+
+纯 ESM 产物，`sideEffects` 仅声明 CSS。各组件按需引入即可裁剪：
+
+- 仅使用 `FlowList` 时，包代码约 **7.8 kB**（gzip 后约 2 kB），`@antv/x6`（流程画布引擎）整体摇除，naive-ui 仅保留列表用到的少量组件；
+- 全量引入（含设计器）时包代码约 260 kB（gzip 后约 68 kB）。
+
+> 注：默认 tree-shaking 配置下 external 依赖（如 `@antv/x6`）可能残留 bare import 语句（模块副作用保守保留，属标准行为，不影响运行）；如需严格摇除，可在消费方构建配置中启用 `treeshake: { moduleSideEffects: 'no-external' }`。
+
+## 维护与版本约定
+
+### 版本策略（SemVer）
+
+| 变更类型 | 版本号 | 示例 |
+| --- | --- | --- |
+| Bug 修复、样式微调、类型修正 | patch（0.1.x） | 修复条件分支节点回显丢失 |
+| 组件增强、新增 Props / Emits / 导出、可选依赖能力 | minor（0.x.0） | FlowList 新增 `loading` prop；新增 `FlowStep` 组件 |
+| 破坏性变更：删除/改名导出、Props 语义变化、注入协议结构变化、样式类名契约变化 | major（x.0.0） | `createFlowUI` 协议字段调整；`submitted` 事件语义变化 |
+
+- minor 及以下升级宿主可直接跟进；**major 升级前必读本 CHANGELOG 的「迁移必读」**；
+- 当前处于 0.x 阶段：minor 亦可能包含破坏性变更（SemVer 惯例），0.x 期间每次升级均需浏览 CHANGELOG。
+
+### 发版流程
+
+1. 包目录（`packages/flow-ui`）修改代码 → `pnpm build` 产出 dist；
+2. 按「版本策略」更新 `package.json` version，并在 `CHANGELOG.md` 顶部追加对应版本条目（含迁移必读，若有）；
+3. `npm pack --dry-run` 核对发布内容（应只含 dist 与 manifest）；
+4. 发布：`pnpm publish`（publishConfig 已定稿公共 npm——`registry.npmjs.org` + `access: public`，沿 `@yugu-ui/ui` 惯例；登录 `npm login` 与发布均在用户终端执行，首次发布需账号拥有 `@yugu-ui` scope，即用户现有组织）；
+5. 宿主工程验证：安装新版本后跑流程设置 / 发起流程 / 待办详情三个冒烟页。
+
+### 宿主升级流程（ygmops_pc）
+
+1. 查看本包 CHANGELOG，确认无破坏性变更（或按迁移必读调整消费页）；
+2. `packages/flow-ui` 内开发期间宿主以 `workspace:*` 直链源码包（dist 需先行 build）；
+3. 升级后运行 `pnpm install` 刷新链接，重点回归：B1 列表渲染、B5 表单提交链路、B9 关页签承接（详见包内 IMPLEMENTATION.md 附录 B）。
+
+### 跨应用复用路线
+
+本包定位为集团内多应用共享的工作流 UI 层，后续按需接入：
+
+- **ygmplt**（平台端）：预计首先复用 `FlowConfig` 设计器（流程模板管理场景）；
+- **ygmtms** / **ygmwms**：复用 `FlowList` + `FlowLayout`（发起与审批场景）。
+
+接入步骤：目标应用安装本包 → 按 README「快速开始」完成 style.css 引入与 `createFlowUI` 注入（传各自工程的 request/getToken/FileUpload）→ 在 `<n-config-provider>` 作用域内使用组件。各应用仅需保证注入协议兼容，包内不携带任何宿主专属逻辑。

package/dist/adapter/wflow.d.ts

@@ -0,0 +1,260 @@
+/**
+ * 工作流（wflow）adapter：包内组件用到的 5 个接口。
+ * ⚠️ URL 前缀规则：注入 request 的 baseURL 已包含 `/ygm/api/ygmpc`，
+ * 后端文档里的 `/ygmpc/wflow/*` 在此只写 `/wflow/*`；
+ * tenant_no / operator 由注入 request（宿主实例）自动填充，无需传递。
+ */
+/** 流程配置详情 */
+export interface WflowConfigDetail {
+    id: number;
+    code?: string;
+    name?: string;
+    group_id?: string;
+    icon?: string;
+    status?: number;
+    version?: number;
+    created_at?: number | null;
+    updated_at?: number | null;
+    /** 设计器整份 JSON（{ fields, flow, more }），原样回显 */
+    config?: Record<string, unknown>;
+    /** 外部流程标识：0=非外部展示全部配置项（缺省默认），1=外部默认隐藏内置配置 */
+    isExternal?: number;
+}
+/** 获取流程配置详情（GET /wflow/config/{config_id}） */
+export declare function fetchGetWflowConfigDetail(configId: number): Promise<import('..').FlowUIResponse<WflowConfigDetail>>;
+/** 流程节点请求参数：form 为整份表单数据（后端按表单值匹配条件分支）；tenant_no/initor_id/initor_name 后端自动取当前登录租户/用户，无需传递 */
+export interface WflowFlowNodesParams {
+    flow_id: number;
+    form: Record<string, unknown>;
+}
+/** 流程节点（form 发起模式：接口不返回 end 结束节点，前端渲染时自行追加） */
+export interface WflowFlowNode {
+    type: 'start' | 'approver' | 'cc';
+    name: string;
+    /** 节点描述（如"发起人自选"） */
+    desc?: string;
+    /** 审批方式：sequence=依次审批 countersign=会签 orsign=或签（type=approver 时有值） */
+    mode?: 'sequence' | 'countersign' | 'orsign';
+    /** 发起人自选审批人节点 */
+    selfSelect?: boolean;
+    /** 节点人员（id 为人员主键，name 为展示名；提交发起时原样回传） */
+    users: Array<{
+        id: number;
+        name: string;
+    }>;
+}
+/** 获取流程节点响应：nodes 按执行顺序排列，供发起页时间线渲染 */
+export interface WflowFlowNodesResult {
+    flow_id: number;
+    flow_name?: string;
+    nodes: WflowFlowNode[];
+}
+/** 获取流程节点（POST /wflow/flow/nodes：整份表单数据 + 流程 ID，后端按表单值匹配条件分支得到节点链） */
+export declare function fetchGetWflowFlowNodes(data: WflowFlowNodesParams): Promise<import('..').FlowUIResponse<WflowFlowNodesResult>>;
+/** 发起流程请求参数（tenant_no 后端自动取当前登录租户无需传递） */
+export interface WflowFlowLaunchParams {
+    flow_id: number;
+    /** 表单业务数据（透传存储，不强约束） */
+    form: Record<string, unknown>;
+    /** 完整流程节点数组（start/approver/cc，不含 end 结束节点，发起页时间线整份回传） */
+    nodes: Array<{
+        type: 'start' | 'approver' | 'cc';
+        name: string;
+        desc?: string;
+        /** 审批方式：sequence=依次审批 countersign=会签 orsign=或签（type=approver 时有值） */
+        mode?: 'sequence' | 'countersign' | 'orsign';
+        /** 发起人自选审批人节点 */
+        selfSelect?: boolean;
+        /** 节点处理人（id 为人员主键，自选节点为字符串；name 为展示名） */
+        users: Array<{
+            type?: string;
+            id?: number | string;
+            name?: string;
+        }>;
+    }>;
+}
+/** 发起流程结果：创建成功的流程实例与当前待办节点 */
+export interface WflowFlowLaunchResult {
+    instance_id: number;
+    flow_id: number;
+    flow_name?: string;
+    /** 流程标题（取自表单 reason 等） */
+    title?: string;
+    /** 流程状态：1 审批中 */
+    status?: number;
+    /** 当前待办节点 ID */
+    node_id?: string;
+    /** 当前待办节点名称 */
+    node_name?: string;
+}
+/** 发起流程（POST /wflow/flow/launch：创建流程实例与首个审批节点任务） */
+export declare function fetchLaunchWflowFlow(data: WflowFlowLaunchParams): Promise<import('..').FlowUIResponse<WflowFlowLaunchResult>>;
+/** 待办详情-表单字段定义（渲染只读表单） */
+export interface WflowTodoField {
+    /** 字段标签 */
+    label: string;
+    /** 字段 key */
+    key: string;
+    /** 是否为条件字段 */
+    condition?: boolean;
+    /** 条件字段控件类型，如 select */
+    conditionType?: string;
+    /** 是否在列表展示 */
+    list?: boolean;
+    /** 选项列表 */
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+}
+/** 待办详情-流程节点快照（时间线渲染；节点自带任务状态与每人处理结果） */
+export interface WflowTodoNode {
+    /** 节点 ID */
+    node_id: string;
+    /** 节点名称 */
+    name: string;
+    /** 节点类型：start/approver/cc */
+    type: 'start' | 'approver' | 'cc';
+    /** 节点描述 */
+    desc?: string | null;
+    /** 审批方式：sequence=依次审批 countersign=会签 orsign=或签（type=approver 时有值） */
+    mode?: 'sequence' | 'countersign' | 'orsign';
+    /** 是否发起人自选 */
+    selfSelect?: boolean;
+    /** 节点处理时间（毫秒时间戳） */
+    created_time?: number;
+    /** 节点总成员数（start/cc 节点无任务为 0） */
+    member_count?: number;
+    /** 未完成数 */
+    un_complete_num?: number;
+    /** 已同意数 */
+    agree_num?: number;
+    /** 是否会签：0 否 1 是 */
+    counter_sign?: number;
+    /** 任务状态：1 待处理（start/cc 节点无任务为 0；status=1 的 approver 节点即当前待处理节点） */
+    status?: number;
+    /** 节点是否已完成：0 否 1 是（start/cc 节点无任务为 0） */
+    finished?: number;
+    /** 认领时间（毫秒时间戳，未认领为 null） */
+    claim_time?: number | null;
+    /** 节点处理人列表（只含 id/name 身份信息，具体操作在 records 内） */
+    users: Array<{
+        /** 人员主键 */
+        id?: number;
+        /** 姓名 */
+        name: string;
+        /** 该用户在该节点上的全部审批/抄送处理记录（按处理时间倒序） */
+        records?: WflowTodoRecord[];
+    }>;
+}
+/** 待办详情-处理记录 */
+export interface WflowTodoRecord {
+    /** 记录 ID */
+    id: number;
+    /** 记录类型 */
+    type?: number;
+    /** 处理结果 */
+    result?: number;
+    /** 是否已处理：1 是 */
+    finished?: number;
+    /** 处理时间（毫秒时间戳） */
+    assertion_time?: number;
+    /** 审批意见 */
+    suggest?: string;
+    /** 是否驳回：0 否 1 是 */
+    is_reject?: number;
+    /** 审批附件（CDN 文件记录：original_filename 原始文件名 / file_name 存储文件名 / url 访问地址） */
+    attachments?: Array<{
+        id?: number | string;
+        file_name?: string;
+        original_filename?: string;
+        url?: string;
+    }>;
+    /** 记录操作人 ID（驳回记录上=该次驳回的驳回人，与记录挂载人员 id 比对判定主动/被动驳回：相等=本人主动驳回、不等=本人被驳回） */
+    user_id?: number | string;
+    /** 记录操作人姓名（被驳回记录展示「被 xxx 驳回」） */
+    user_name?: string;
+    /** 驳回目标人员（仅 result=3/is_reject=1 驳回记录上返回：该次驳回的真实目标人员，展示「驳回到 name」；其余记录为空对象 {}） */
+    rejecters?: {
+        undo_id?: number | string;
+        reject_undo_id?: number | string;
+        id?: string;
+        name?: string;
+    };
+}
+/** 待办详情数据：实例信息 + 表单 + 节点快照 + 处理记录 */
+export interface WflowTodoDetail {
+    /** 流程实例 ID */
+    instance_id: number;
+    /** 流程配置 ID（字符串） */
+    flow_id: string;
+    /** 流程名称 */
+    flow_name?: string;
+    /** 流程标题 */
+    title?: string;
+    /** 流程图标 */
+    icon?: string;
+    /** 流程状态 */
+    status?: number;
+    /** 是否已结束：0 否 1 是 */
+    finished?: number;
+    /** 发起时间（毫秒时间戳） */
+    start_time?: number;
+    /** 结束时间（毫秒时间戳，未结束为 null） */
+    stop_time?: number | null;
+    /** 流程耗时（分钟） */
+    duration?: number;
+    /** 发起人 ID */
+    initor_id?: string;
+    /** 发起人姓名 */
+    initor_name?: string;
+    /** 表单字段定义 */
+    fields?: WflowTodoField[];
+    /** 表单业务数据 */
+    form?: Record<string, unknown>;
+    /** 流程节点快照（时间线渲染） */
+    nodes?: WflowTodoNode[];
+    /** 当前用户能否处理 */
+    can_handle?: boolean;
+    /** 当前用户是否发起人 */
+    is_initor?: boolean;
+    /** 当前用户在本实例当前任务上的待办审批记录 ID（同意/驳回接口入参，非处理人时为 null） */
+    undo_id?: number | null;
+    /** 当前用户本条待办审批记录是否已处理：0 否 1 是 */
+    undo_finished?: number;
+}
+/** 审批同意请求参数（意见与附件可为空；tenant_no 后端自动取当前登录租户，无需传递） */
+export interface WflowUndoApproveParams {
+    /** 待办审批记录 ID（todo/list 或 todo/{instance_id} 返回的 undo_id） */
+    undo_id: number;
+    /** 审批意见（同意时可为空，最长 255 字符） */
+    suggest?: string;
+    /** 审批意见+附件组列表（CDN 文件），可为空，组内字段原样透传 */
+    attachments?: Array<Record<string, unknown>>;
+}
+/** 审批驳回请求参数（意见必填；仅传 reject_node_id=整节点重置，同时传 reject_user_id=人级驳回仅该用户重新审批） */
+export interface WflowUndoRejectParams {
+    /** 待办审批记录 ID（todo/list 或 todo/{instance_id} 返回的 undo_id） */
+    undo_id: number;
+    /** 驳回目标节点 ID（发起人 start 节点或历史审批人节点；驳回到发起人=终止流程，驳回到历史节点=该节点起重置重审） */
+    reject_node_id: string;
+    /** 驳回目标审批人 ID（可选，须为 reject_node_id 节点下的审批人；指定时仅该用户重新审批，同节点其他人保留结果） */
+    reject_user_id?: string | null;
+    /** 审批意见（驳回时必填，最长 255 字符） */
+    suggest: string;
+    /** 审批意见+附件组列表（CDN 文件），可为空，组内字段原样透传 */
+    attachments?: Array<Record<string, unknown>>;
+}
+/** 审批处理结果：处理后的流程实例/当前任务快照 */
+export interface WflowUndoResult {
+    instance_id: number;
+    status?: number;
+    finished?: number;
+    node_id?: string;
+    node_name?: string;
+    task_id?: number;
+}
+/** 审批同意（POST /wflow/undo/approve：或签任一人同意即过，依次/会签全员同意后推进下一节点，末节点通过后流程完成） */
+export declare function fetchWflowUndoApprove(data: WflowUndoApproveParams): Promise<import('..').FlowUIResponse<WflowUndoResult>>;
+/** 审批驳回（POST /wflow/undo/reject：驳回到发起人=终止流程，驳回到历史审批节点=该节点起重置重审） */
+export declare function fetchWflowUndoReject(data: WflowUndoRejectParams): Promise<import('..').FlowUIResponse<WflowUndoResult>>;

package/dist/base-ui/base-card-item.d.ts

@@ -0,0 +1,26 @@
+type __VLS_Props = {
+    title?: string;
+    subtitle?: string;
+    contentPadding?: number | string;
+};
+declare var __VLS_9: {}, __VLS_11: {}, __VLS_13: {};
+type __VLS_Slots = {} & {
+    subtitle?: (props: typeof __VLS_9) => any;
+} & {
+    'header-extra'?: (props: typeof __VLS_11) => any;
+} & {
+    default?: (props: typeof __VLS_13) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    title: string;
+    subtitle: string;
+    contentPadding: number | string;
+}, {}, {}, {}, 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;
+    };
+};