@qfei-design/make-app-approval 0.0.0-stage → 0.1.0

package/dist/detail.mjs

@@ -0,0 +1,500 @@
+import { jsx as n, jsxs as o, Fragment as we } from "react/jsx-runtime";
+import { useState as u, useRef as Q, useEffect as de, useId as Te } from "react";
+import { ApprovalStatus as Ee } from "./react.mjs";
+import { isApprovalSystemField as Ae } from "./index.mjs";
+const N = (e) => !!e && typeof e == "object" && !Array.isArray(e), b = (e) => typeof e == "string" && e.trim().length > 0, Ne = ["APPROVE", "REJECT", "RETURN", "SUBMIT"], $ = (e) => {
+  if (e === void 0) return [];
+  if (!N(e)) throw new Error("审批字段权限格式无效");
+  if (e.scope === "NONE" && e.fields === void 0) return [];
+  if (e.scope !== "FIELDS" || !Array.isArray(e.fields) || !e.fields.every(b) || new Set(e.fields).size !== e.fields.length)
+    throw new Error("审批字段权限范围无效");
+  return e.fields;
+}, Ie = (e) => N(e) && b(e.key) && b(e.label) && (e.required === void 0 || typeof e.required == "boolean") && (e.schema === void 0 || N(e.schema)), Oe = (e) => {
+  if (!N(e) || !Ne.some((a) => a === e.actionType) || e.commentPolicy !== "REQUIRED" && e.commentPolicy !== "OPTIONAL")
+    return !1;
+  const t = e.returnTargets;
+  return t === void 0 || Array.isArray(t) && t.every((a) => N(a) && b(a.nodeKey) && b(a.nodeName)) && new Set(t.map((a) => a.nodeKey)).size === t.length;
+}, pe = (e) => {
+  if (!N(e) || !b(e.taskId) || !b(e.processInstanceId) || !b(e.taskName) || !b(e.processStatus) || !Array.isArray(e.fields) || !e.fields.every(Ie) || !N(e.formData))
+    throw new Error("审批详情数据不完整");
+  const t = e.fields.map((i) => i.key);
+  if (new Set(t).size !== t.length) throw new Error("审批字段标识重复");
+  if (e.fieldPermission !== void 0 && !N(e.fieldPermission))
+    throw new Error("审批字段权限格式无效");
+  const a = e.fieldPermission, s = $(a?.viewPermission), p = $(a?.editPermission);
+  if (s.some((i) => !t.includes(i)) || p.some((i) => !s.includes(i)))
+    throw new Error("审批字段元数据或权限不一致");
+  const d = e.actions ?? [];
+  if (!Array.isArray(d) || !d.every(Oe) || new Set(d.map((i) => i.actionType)).size !== d.length)
+    throw new Error("审批操作配置无效");
+  return {
+    taskId: e.taskId,
+    processInstanceId: e.processInstanceId,
+    taskName: e.taskName,
+    processStatus: e.processStatus,
+    fields: e.fields,
+    formData: e.formData,
+    actions: d,
+    fieldPermission: {
+      viewPermission: { scope: "FIELDS", fields: s },
+      editPermission: { scope: "FIELDS", fields: p }
+    }
+  };
+}, q = (e) => {
+  const t = new Set(
+    $(e.fieldPermission?.viewPermission)
+  ), a = new Set(
+    $(e.fieldPermission?.editPermission)
+  );
+  return e.fields.filter((s) => t.has(s.key)).map((s) => ({
+    ...s,
+    editable: a.has(s.key) && !Ae(s.key)
+  }));
+};
+class A extends Error {
+  constructor(t, a = {}) {
+    super(t), this.fieldErrors = a, this.name = "ApprovalTaskValidationError";
+  }
+  fieldErrors;
+}
+const G = (e) => e.actionType === "RETURN" || e.actionType === "REJECT" || e.actionType === "SUBMIT" && e.commentPolicy === "REQUIRED", Se = (e, t) => Object.fromEntries(
+  e.filter((a) => {
+    const s = t[a.key];
+    return s == null || typeof s == "string" && !s.trim() || Array.isArray(s) && s.length === 0;
+  }).map((a) => [a.key, `请填写${a.label}`])
+), ce = (e, t, a, s, p) => {
+  const d = e.actions.find((c) => c.actionType === t);
+  if (!d)
+    throw new A("当前节点不允许此操作，请刷新详情");
+  const i = new Set(
+    q(e).filter((c) => c.editable).map((c) => c.key)
+  );
+  if (Object.keys(a).some((c) => !i.has(c)))
+    throw new A("字段权限已变化，请重新加载详情");
+  if (G(d) && !s.trim())
+    throw new A("请填写审批意见");
+  if (s.length > 1024)
+    throw new A("审批意见不能超过 1024 个字符");
+  if (t === "RETURN" && !d.returnTargets?.some((c) => c.nodeKey === p))
+    throw new A("请选择后台配置的退回节点");
+  return {
+    taskId: e.taskId,
+    processInstanceId: e.processInstanceId,
+    actionType: t,
+    comment: s.trim(),
+    recordPatch: { ...a },
+    ...t === "RETURN" ? { targetNodeKey: p } : {}
+  };
+}, f = (e, t) => {
+  try {
+    e ? e(t) : t.phase === "error" ? console.warn("[make-app-approval]", t) : console.info("[make-app-approval]", t);
+  } catch {
+    console.warn("[make-app-approval] diagnostic sink failed");
+  }
+}, H = (e, t) => {
+  if (Object.is(e, t)) return !0;
+  if (e instanceof Date && t instanceof Date)
+    return Object.is(e.getTime(), t.getTime());
+  if (Array.isArray(e) || Array.isArray(t))
+    return Array.isArray(e) && Array.isArray(t) && e.length === t.length && e.every((p, d) => H(p, t[d]));
+  if (!e || !t || typeof e != "object" || typeof t != "object" || ![Object.prototype, null].includes(Object.getPrototypeOf(e)) || ![Object.prototype, null].includes(Object.getPrototypeOf(t))) return !1;
+  const a = e, s = t;
+  return Object.keys(a).length === Object.keys(s).length && Object.keys(a).every((p) => Object.hasOwn(s, p) && H(a[p], s[p]));
+}, D = {
+  APPROVE: "同意",
+  REJECT: "拒绝",
+  RETURN: "退回修改",
+  SUBMIT: "提交"
+}, W = (e, t) => e.taskId === t.reference.taskId && e.processInstanceId === t.reference.processInstanceId, je = ({
+  title: e,
+  actions: t,
+  content: a,
+  footer: s
+}) => /* @__PURE__ */ o("section", { className: "make-app-approval-detail", "aria-label": "审批详情", children: [
+  /* @__PURE__ */ o("header", { className: "make-app-approval-detail-header", children: [
+    e,
+    t
+  ] }),
+  /* @__PURE__ */ n("div", { className: "make-app-approval-detail-content", children: a }),
+  s && /* @__PURE__ */ n("footer", { className: "make-app-approval-detail-footer", children: s })
+] }), le = (e) => /* @__PURE__ */ o("div", { className: "make-app-approval-detail-title", children: [
+  /* @__PURE__ */ n("h2", { children: "审批详情" }),
+  e && /* @__PURE__ */ n(Ee, { value: e })
+] }), Re = (e) => {
+  const [t, a] = u(0), [s, p] = u(), d = Q(e);
+  d.current = e, de(() => {
+    const c = new AbortController(), k = d.current;
+    return f(k.logger, { operation: "detail", phase: "start" }), (async () => {
+      try {
+        const l = pe(
+          await k.provider.loadDetail(k.reference, {
+            signal: c.signal
+          })
+        );
+        if (c.signal.aborted) return;
+        if (!W(l, k))
+          throw new Error("Task identity mismatch");
+        p({ revision: t, detail: l }), f(k.logger, { operation: "detail", phase: "success" });
+      } catch {
+        if (c.signal.aborted) return;
+        p({ revision: t, error: !0 }), f(k.logger, { operation: "detail", phase: "error" });
+      }
+    })(), () => {
+      c.abort(), f(k.logger, { operation: "detail", phase: "cancel" });
+    };
+  }, [t]);
+  const i = s?.revision === t ? s : void 0;
+  return /* @__PURE__ */ n(
+    Pe,
+    {
+      ...e,
+      data: i?.detail,
+      loadError: i?.error === !0,
+      reload: () => a((c) => c + 1)
+    },
+    t
+  );
+}, Pe = (e) => {
+  const {
+    components: { Button: t, Select: a, TextArea: s },
+    renderField: p,
+    reload: d
+  } = e, i = Te(), [c, k] = u(), l = c ?? e.data, [g, B] = u({}), [U, S] = u(), [L, X] = u(""), [x, C] = u(""), [F, J] = u({}), [Y, v] = u(""), [w, Z] = u(!1), [R, me] = u(!1), [j, ye] = u(!1), K = Q(!1), V = Q(new AbortController());
+  de(() => (V.current = new AbortController(), () => V.current.abort()), []);
+  const _ = l ? q(l) : [], T = l?.actions.find((r) => r.actionType === U), ee = T ? G(T) : !1, te = l?.actions.filter(G) ?? [], re = w || R || j, ae = e.renderLayout ?? je, he = async () => {
+    if (!l || !U || K.current || R || j) return;
+    K.current = !0, Z(!0), v(""), J({});
+    const r = V.current.signal, y = U;
+    let I = !1;
+    f(e.logger, {
+      operation: "action",
+      phase: "start",
+      actionType: y
+    });
+    try {
+      ce(l, y, g, L, x);
+      const m = pe(
+        await e.provider.loadDetail(e.reference, { signal: r })
+      );
+      if (r.aborted) return;
+      if (!W(m, e)) throw new Error("Task identity mismatch");
+      const be = q(l), M = q(m);
+      if (JSON.stringify(be) !== JSON.stringify(M) || JSON.stringify(l.actions) !== JSON.stringify(m.actions)) {
+        k(m), B({}), S(void 0), X(""), C(""), v("当前节点的字段或操作权限已变化，请核对后重新操作"), f(e.logger, {
+          operation: "action",
+          phase: "skip",
+          actionType: y
+        });
+        return;
+      }
+      const se = M.filter(
+        (h) => !H(l.formData[h.key], m.formData[h.key])
+      );
+      if (se.length) {
+        const h = new Set(se.map((O) => O.key)), z = Object.keys(g).some((O) => h.has(O));
+        k(m), B(Object.fromEntries(Object.entries(g).filter(([O]) => !h.has(O)))), S(void 0), C(""), v(z ? "申请内容已更新，冲突字段的本地修改已清除，其他修改已保留，请核对后重新操作" : "申请内容已更新，您的修改已保留，请核对后重新操作"), f(e.logger, { operation: "action", phase: "skip", actionType: y });
+        return;
+      }
+      const P = M.filter(
+        (h) => h.editable && h.required === !0
+      ), oe = Object.fromEntries(
+        P.map((h) => [
+          h.key,
+          Object.hasOwn(g, h.key) ? g[h.key] : m.formData[h.key]
+        ])
+      ), ne = Se(
+        P,
+        oe
+      );
+      if (Object.keys(ne).length)
+        throw new A(
+          "请检查表单中标红的字段",
+          ne
+        );
+      const ge = P.length ? await e.validateFields({
+        fields: P,
+        values: oe,
+        actionType: y,
+        signal: r
+      }) : {};
+      if (r.aborted) return;
+      const ie = Object.fromEntries(
+        Object.entries(ge).filter(
+          ([h, z]) => P.some((O) => O.key === h) && !!z
+        )
+      );
+      if (Object.keys(ie).length)
+        throw new A(
+          "请检查表单中标红的字段",
+          ie
+        );
+      const ve = ce(
+        m,
+        y,
+        g,
+        L,
+        x
+      );
+      I = !0;
+      const E = await e.provider.submitAction(ve, { signal: r });
+      if (r.aborted) return;
+      if (!E || !W(E, e) || E.actionType !== y || typeof E.processEnded != "boolean" || typeof E.processStatus != "string" || !E.processStatus.trim())
+        throw new Error("Action result mismatch");
+      ye(!0), S(void 0), k({ ...m, processStatus: E.processStatus }), v("处理成功"), f(e.logger, {
+        operation: "action",
+        phase: "success",
+        actionType: y
+      }), f(e.logger, {
+        operation: "notify",
+        phase: "start",
+        actionType: y
+      });
+      try {
+        await e.onActionSuccess(E), f(e.logger, {
+          operation: "notify",
+          phase: "success",
+          actionType: y
+        });
+      } catch {
+        r.aborted || v("处理已成功，但页面刷新未完成，请刷新列表确认"), f(e.logger, {
+          operation: "notify",
+          phase: "error",
+          actionType: y
+        });
+      }
+    } catch (m) {
+      if (r.aborted) return;
+      !I && m instanceof A ? (v(m.message), J(m.fieldErrors)) : (me(!0), S(void 0), v(
+        I ? "操作结果尚未确认，请重新加载详情核查，勿重复提交" : "审批权限或字段校验暂不可用，请重新加载详情"
+      )), f(e.logger, {
+        operation: "action",
+        phase: "error",
+        actionType: y
+      });
+    } finally {
+      K.current = !1, r.aborted ? f(e.logger, {
+        operation: "action",
+        phase: "cancel",
+        actionType: y
+      }) : Z(!1);
+    }
+  };
+  if (!l)
+    return ae({
+      title: le(),
+      actions: null,
+      footer: null,
+      content: e.loadError ? /* @__PURE__ */ o("div", { className: "make-app-approval-detail-section", role: "alert", children: [
+        "审批详情加载失败，请重试",
+        /* @__PURE__ */ n(t, { htmlType: "button", variant: "default", onClick: d, children: "重新加载详情" })
+      ] }) : /* @__PURE__ */ n("div", { className: "make-app-approval-detail-section", role: "status", children: "正在加载审批详情…" })
+    });
+  const fe = !R && !j && l.actions.length > 0 ? /* @__PURE__ */ n("div", { className: "make-app-approval-detail-actions", "aria-label": "审批操作", children: l.actions.map((r) => /* @__PURE__ */ n(
+    t,
+    {
+      htmlType: "button",
+      variant: r.actionType === "APPROVE" || r.actionType === "SUBMIT" ? "primary" : "default",
+      disabled: w,
+      onClick: () => {
+        S(r.actionType), C(""), v(""), document.getElementById(`${i}-comment`)?.focus();
+      },
+      children: D[r.actionType]
+    },
+    r.actionType
+  )) }) : null, ue = /* @__PURE__ */ o("div", { className: "make-app-approval-detail-content", "aria-busy": w, children: [
+    /* @__PURE__ */ o(
+      "section",
+      {
+        className: "make-app-approval-detail-section",
+        "aria-label": "申请信息",
+        children: [
+          /* @__PURE__ */ n("h3", { children: "申请信息" }),
+          /* @__PURE__ */ o("div", { className: "make-app-approval-detail-fields", children: [
+            _.length === 0 && /* @__PURE__ */ n("p", { children: "当前节点未配置可见字段" }),
+            _.map((r) => /* @__PURE__ */ o(
+              "div",
+              {
+                className: "make-app-approval-detail-field",
+                "data-invalid": !!F[r.key],
+                children: [
+                  /* @__PURE__ */ o("label", { htmlFor: `${i}-${r.key}`, children: [
+                    r.label,
+                    r.required ? /* @__PURE__ */ o(
+                      "span",
+                      {
+                        className: "make-app-approval-required",
+                        "aria-label": "必填",
+                        children: [
+                          " ",
+                          "*"
+                        ]
+                      }
+                    ) : null
+                  ] }),
+                  /* @__PURE__ */ o("div", { className: "make-app-approval-detail-value", children: [
+                    p({
+                      field: r,
+                      id: `${i}-${r.key}`,
+                      value: Object.hasOwn(g, r.key) ? g[r.key] : l.formData[r.key],
+                      readOnly: !r.editable,
+                      disabled: re,
+                      error: F[r.key],
+                      ...r.editable && !re ? {
+                        onChange: (y) => {
+                          B((I) => ({
+                            ...I,
+                            [r.key]: y
+                          })), J((I) => {
+                            const m = { ...I };
+                            return delete m[r.key], m;
+                          });
+                        }
+                      } : {}
+                    }),
+                    F[r.key] && /* @__PURE__ */ n("p", { role: "alert", className: "make-app-approval-detail-error", children: F[r.key] })
+                  ] })
+                ]
+              },
+              r.key
+            ))
+          ] })
+        ]
+      }
+    ),
+    e.history != null && /* @__PURE__ */ o(
+      "section",
+      {
+        className: "make-app-approval-detail-section make-app-approval-detail-history",
+        "aria-label": "审批流程",
+        children: [
+          /* @__PURE__ */ n("h3", { children: "审批流程" }),
+          e.history
+        ]
+      }
+    ),
+    Y && /* @__PURE__ */ n(
+      "p",
+      {
+        role: j ? "status" : "alert",
+        className: `make-app-approval-detail-message${j ? "" : " make-app-approval-detail-error"}`,
+        children: Y
+      }
+    ),
+    R && /* @__PURE__ */ n("div", { className: "make-app-approval-detail-message", children: /* @__PURE__ */ n(t, { htmlType: "button", variant: "default", onClick: d, children: "重新加载详情" }) })
+  ] }), ke = !R && !j && l.actions.length > 0 ? /* @__PURE__ */ o("div", { className: "make-app-approval-detail-section make-app-approval-detail-opinion", children: [
+    /* @__PURE__ */ o("label", { htmlFor: `${i}-comment`, children: [
+      "审批意见",
+      ee && /* @__PURE__ */ o("span", { className: "make-app-approval-required", "aria-label": "必填", children: [
+        " ",
+        "*"
+      ] })
+    ] }),
+    /* @__PURE__ */ n(
+      s,
+      {
+        id: `${i}-comment`,
+        ariaLabel: "审批意见",
+        value: L,
+        onChange: X,
+        placeholder: te.length ? `请输入审批意见，${te.map((r) => D[r.actionType]).join("、")}时必填` : "请输入审批意见",
+        disabled: w,
+        required: ee,
+        maxLength: 1024
+      }
+    ),
+    T && /* @__PURE__ */ o(
+      "section",
+      {
+        className: "make-app-approval-action-confirm",
+        "aria-label": `确认${D[T.actionType]}`,
+        children: [
+          /* @__PURE__ */ o("h3", { children: [
+            "确认",
+            D[T.actionType]
+          ] }),
+          T.actionType === "RETURN" && /* @__PURE__ */ o("div", { className: "make-app-approval-detail-target", children: [
+            /* @__PURE__ */ n("label", { htmlFor: `${i}-target`, children: "退回节点" }),
+            /* @__PURE__ */ n(
+              a,
+              {
+                id: `${i}-target`,
+                ariaLabel: "退回节点",
+                value: x,
+                onChange: C,
+                disabled: w,
+                options: [
+                  { value: "", label: "请选择退回节点" },
+                  ...(T.returnTargets ?? []).map((r) => ({
+                    value: r.nodeKey,
+                    label: r.nodeName
+                  }))
+                ]
+              }
+            )
+          ] }),
+          /* @__PURE__ */ o("div", { className: "make-app-approval-detail-actions", children: [
+            /* @__PURE__ */ o(
+              t,
+              {
+                htmlType: "button",
+                variant: "primary",
+                disabled: w,
+                loading: w,
+                onClick: () => {
+                  he();
+                },
+                children: [
+                  "确认",
+                  D[T.actionType]
+                ]
+              }
+            ),
+            /* @__PURE__ */ n(
+              t,
+              {
+                htmlType: "button",
+                variant: "default",
+                disabled: w,
+                onClick: () => S(void 0),
+                children: "取消"
+              }
+            )
+          ] })
+        ]
+      }
+    )
+  ] }) : null;
+  return ae({
+    title: le(l.processStatus),
+    actions: fe,
+    content: /* @__PURE__ */ o(we, { children: [
+      ue,
+      ke
+    ] }),
+    footer: null
+  });
+}, $e = (e) => {
+  if (!e.scopeKey.trim() || !e.reference.taskId.trim() || !e.reference.processInstanceId.trim())
+    throw new Error("ApprovalTaskDetail requires scopeKey and task reference");
+  for (const t of ["Button", "Select", "TextArea"])
+    if (!e.components?.[t])
+      throw new Error(`ApprovalTaskDetail requires components.${t}`);
+  return /* @__PURE__ */ n(
+    Re,
+    {
+      ...e
+    },
+    JSON.stringify([
+      e.scopeKey,
+      e.reference.processInstanceId,
+      e.reference.taskId
+    ])
+  );
+};
+export {
+  $e as ApprovalTaskDetail,
+  A as ApprovalTaskValidationError,
+  ce as buildApprovalTaskAction,
+  q as getApprovalTaskFields,
+  pe as readApprovalTaskDetail
+};

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=1024,p=e=>{if(typeof e!="string"||!e.trim())return"请填写撤回意见";if(e.trim().length>s)return`撤回意见不能超过 ${s} 个字符`},i="qfei_process_instance_status",l="qfei_is_locked",r={UNSUBMITTED:{label:"—",tone:"neutral"},IN_APPROVAL:{label:"审批中",tone:"processing"},RETURNING:{label:"审批中",tone:"processing"},APPROVED:{label:"已同意",tone:"success"},REJECTED:{label:"已拒绝",tone:"danger"},CANCELLED:{label:"已撤回",tone:"neutral"}},A=e=>e==null?r.UNSUBMITTED:typeof e=="string"&&Object.hasOwn(r,e)?r[e]:{label:"状态未知",tone:"unknown"},c=e=>!!e?.bpmDefinitionKey?.trim(),u=e=>e===i||e===l,t={locked:{reason:"locked",message:"该数据正在审批中，已被锁定，暂不可编辑"},"in-progress":{reason:"in-progress",message:"该数据正在审批中，暂不可编辑"},ended:{reason:"ended",message:"流程已结束，原单只读"},unknown:{reason:"unknown",message:"审批状态暂不可确认，请刷新后重试"}},E=(e,a={})=>{const n=e[i],o=e[l];return o===!0?t.locked:n==="IN_APPROVAL"||n==="RETURNING"?t["in-progress"]:n==="APPROVED"||n==="REJECTED"?t.ended:o!==void 0&&typeof o!="boolean"?t.unknown:n==="UNSUBMITTED"?o===!1?null:t.unknown:n!==void 0||a.approvalEnabled?t.unknown:null};exports.APPROVAL_LOCK_FIELD=l;exports.APPROVAL_STATUS_FIELD=i;exports.APPROVAL_WITHDRAW_COMMENT_MAX_LENGTH=s;exports.getApprovalStatusDisplay=A;exports.getApprovalWithdrawalCommentError=p;exports.getRecordApprovalWriteRestriction=E;exports.hasApprovalDefinition=c;exports.isApprovalSystemField=u;

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export declare const APPROVAL_STATUS_FIELD = "qfei_process_instance_status";
+export declare const APPROVAL_LOCK_FIELD = "qfei_is_locked";
+export type ApprovalProcessStatus = "UNSUBMITTED" | "IN_APPROVAL" | "RETURNING" | "APPROVED" | "REJECTED" | "CANCELLED";
+export type ApprovalStatusDisplay = Readonly<{
+    label: string;
+    tone: "neutral" | "processing" | "success" | "danger" | "unknown";
+}>;
+export declare const getApprovalStatusDisplay: (value: unknown) => ApprovalStatusDisplay;
+export declare const hasApprovalDefinition: (entity: {
+    bpmDefinitionKey?: string;
+} | null | undefined) => boolean;
+export declare const isApprovalSystemField: (key: string) => boolean;
+export type ApprovalWriteRestriction = Readonly<{
+    reason: "locked" | "in-progress" | "ended" | "unknown";
+    message: string;
+}>;
+/** Only guards ordinary record writes. Task actions and list membership are server-owned. */
+export declare const getRecordApprovalWriteRestriction: (record: Readonly<Record<string, unknown>>, options?: {
+    approvalEnabled?: boolean;
+}) => ApprovalWriteRestriction | null;
+export * from "./withdrawal.js";

package/dist/index.mjs

@@ -0,0 +1,30 @@
+const a = 1024, A = (n) => {
+  if (typeof n != "string" || !n.trim()) return "请填写撤回意见";
+  if (n.trim().length > 1024)
+    return "撤回意见不能超过 1024 个字符";
+}, r = "qfei_process_instance_status", i = "qfei_is_locked", s = {
+  UNSUBMITTED: { label: "—", tone: "neutral" },
+  IN_APPROVAL: { label: "审批中", tone: "processing" },
+  RETURNING: { label: "审批中", tone: "processing" },
+  APPROVED: { label: "已同意", tone: "success" },
+  REJECTED: { label: "已拒绝", tone: "danger" },
+  CANCELLED: { label: "已撤回", tone: "neutral" }
+}, c = (n) => n == null ? s.UNSUBMITTED : typeof n == "string" && Object.hasOwn(s, n) ? s[n] : { label: "状态未知", tone: "unknown" }, p = (n) => !!n?.bpmDefinitionKey?.trim(), E = (n) => n === r || n === i, t = {
+  locked: { reason: "locked", message: "该数据正在审批中，已被锁定，暂不可编辑" },
+  "in-progress": { reason: "in-progress", message: "该数据正在审批中，暂不可编辑" },
+  ended: { reason: "ended", message: "流程已结束，原单只读" },
+  unknown: { reason: "unknown", message: "审批状态暂不可确认，请刷新后重试" }
+}, u = (n, l = {}) => {
+  const e = n[r], o = n[i];
+  return o === !0 ? t.locked : e === "IN_APPROVAL" || e === "RETURNING" ? t["in-progress"] : e === "APPROVED" || e === "REJECTED" ? t.ended : o !== void 0 && typeof o != "boolean" ? t.unknown : e === "UNSUBMITTED" ? o === !1 ? null : t.unknown : e !== void 0 || l.approvalEnabled ? t.unknown : null;
+};
+export {
+  i as APPROVAL_LOCK_FIELD,
+  r as APPROVAL_STATUS_FIELD,
+  a as APPROVAL_WITHDRAW_COMMENT_MAX_LENGTH,
+  c as getApprovalStatusDisplay,
+  A as getApprovalWithdrawalCommentError,
+  u as getRecordApprovalWriteRestriction,
+  p as hasApprovalDefinition,
+  E as isApprovalSystemField
+};

package/dist/list/approval-table.d.ts

@@ -0,0 +1,14 @@
+import type { ApprovalListItem, ApprovalListQuery, ApprovalListProvider, ApprovalPage, ApprovalLogger } from "./types.js";
+import type { ApprovalUIComponents } from "./ui-components.js";
+type Props = {
+    components: ApprovalUIComponents;
+    initialPage?: ApprovalPage;
+    query: ApprovalListQuery;
+    provider: ApprovalListProvider;
+    themeKey?: string | number;
+    onOpen: (item: ApprovalListItem) => void;
+    onReload: () => void;
+    logger?: ApprovalLogger;
+};
+export declare const ApprovalTable: (props: Props) => import("react").JSX.Element;
+export {};

package/dist/list/diagnostics.d.ts

@@ -0,0 +1,3 @@
+import type { ApprovalDiagnostic, ApprovalLogger } from "./types.js";
+/** 只传固定事件和数量，不附带查询文字、人员、记录或原始异常。 */
+export declare const reportApproval: (logger: ApprovalLogger | undefined, event: ApprovalDiagnostic) => void;

package/dist/list/index.d.ts

@@ -0,0 +1,3 @@
+export { MyApprovalsPage } from "./my-approvals-page.js";
+export type { ApprovalUIComponents, ApprovalInputProps, ApprovalSelectProps, ApprovalDatePickerProps, ApprovalButtonProps, ApprovalTabsProps, } from "./ui-components.js";
+export type { ApprovalListTab, ApprovalListItem, ApprovalListFilters, ApprovalListQuery, ApprovalPage, ApprovalListProvider, ApprovalStatusOption, ApprovalDiagnostic, ApprovalLogger, MyApprovalsPageProps, } from "./types.js";

package/dist/list/my-approvals-page.d.ts

@@ -0,0 +1,2 @@
+import type { MyApprovalsPageProps } from "./types.js";
+export declare const MyApprovalsPage: (props: MyApprovalsPageProps) => import("react").JSX.Element;

package/dist/list/page-contract.d.ts

@@ -0,0 +1,3 @@
+import type { ApprovalPage } from "./types.js";
+/** 校验分页结构，不按状态筛选、合并、排序或推断任务归属。 */
+export declare const readApprovalPage: (value: unknown, pageSize: number) => ApprovalPage;

package/dist/list/status-label.d.ts

@@ -0,0 +1 @@
+export declare const getApprovalListStatusLabel: (value: unknown) => string;

package/dist/list/types.d.ts

@@ -0,0 +1,71 @@
+import type { ApprovalUIComponents } from "./ui-components.js";
+/** 包与宿主之间的数据约定，不是 BPM 后端接口 DTO。 */
+export type ApprovalListTab = "pending" | "approved";
+export type ApprovalListItem = Readonly<{
+    /** 后端提供的稳定列表行标识，不使用申请单号或数组下标。 */
+    id: string;
+    entityKey: string;
+    recordId: string;
+    taskId?: string;
+    processInstanceId?: string;
+    applicationNo: string;
+    applicationType: string;
+    applicantName: string;
+    /** 宿主按应用时区格式化后的展示文字。 */
+    applicationTime: string;
+    processStatus: string | null;
+}>;
+export type ApprovalListFilters = Readonly<{
+    keyword: string;
+    processStatus: string;
+    /** YYYY-MM-DD，空字符串表示不限；时区与边界转换由 Service 处理。 */
+    startDate: string;
+    endDate: string;
+}>;
+export type ApprovalListQuery = ApprovalListFilters & Readonly<{
+    tab: ApprovalListTab;
+    /** 从 1 开始。 */
+    page: number;
+    pageSize: number;
+}>;
+export type ApprovalPage = Readonly<{
+    rows: readonly ApprovalListItem[];
+    /** 后端完成当前用户、页签和筛选后计算的总数。 */
+    total: number;
+}>;
+export type ApprovalListProvider = Readonly<{
+    loadPage: (query: ApprovalListQuery, context: Readonly<{
+        signal: AbortSignal;
+    }>) => Promise<ApprovalPage>;
+}>;
+export type ApprovalStatusOption = Readonly<{
+    value: string;
+    label: string;
+}>;
+export type ApprovalDiagnostic = Readonly<{
+    operation: "list" | "table" | "open";
+    phase: "start" | "success" | "error" | "cancel" | "skip" | "destroy";
+    tab?: ApprovalListTab;
+    page?: number;
+    pageSize?: number;
+    rowCount?: number;
+}>;
+export type ApprovalLogger = (event: ApprovalDiagnostic) => void;
+export type MyApprovalsPageProps = Readonly<{
+    /** 应用、用户、环境任一变化都必须改变；变化后清空旧数据和筛选。 */
+    scopeKey: string;
+    /** 宿主组件与主题；包只控制功能和布局，不提供原生控件兜底。 */
+    components: ApprovalUIComponents;
+    provider: ApprovalListProvider;
+    onOpenApproval: (item: ApprovalListItem) => void | Promise<void>;
+    /** 后端实际支持的筛选项，未传时只提供“全部流程状态”。 */
+    statusOptions?: readonly ApprovalStatusOption[];
+    /** 每批加载条数，不是页面翻页控件。默认 20。 */
+    pageSize?: number;
+    /** 办理成功后改变，触发当前条件重新查询。关闭详情无需改变。 */
+    refreshKey?: string | number;
+    /** 动态切换主题后改变，重新读取宿主 CSS 变量。 */
+    themeKey?: string | number;
+    logger?: ApprovalLogger;
+    className?: string;
+}>;