weaver-e10-builder 1.2.2 → 1.2.5

package/dist/services/menu-catalog.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 应用菜单目录：把 `allMenus` 的原始返回**递归展开**成可查询的节点表，并构造改名的写报文。
+ *
+ * 两件事非做不可，都是踩过的坑：
+ *
+ * 1. **菜单是棵树，不是一层。** `allMenus` 返回的每条记录带 `children`（实测嵌套到三层，
+ *    如「设置 → 个人设置 → 个人菜单设置」）。只映射顶层数组会把嵌套菜单全丢掉 ——
+ *    调用方据此断言「这个应用没有这个菜单」，是**没取到 ≠ 不存在**的那类假否定。
+ *
+ * 2. **改名不能把读回来的那条记录原样写回去。** 读侧是扁平记录，写侧读的是**嵌套的
+ *    `page: {pageId, pageName, pageType, …}`** 对象；直接回写会把菜单写坏
+ *    （实测 LINK → EMPTY、pageId 清空、menuType 归零）。必须重建 `page`。
+ *    `menuUrl` 同理：记录里有就原样带，没有就**整个省略** —— 拿 pageId 顶替会把菜单写脏，
+ *    而服务端只在它为空时才肯写这个键。
+ */
+/** 读侧派生 / 只读键：回写会造成干扰（与 fields/表单一侧的只读键同理）。 */
+export declare const MENU_READONLY_KEYS: readonly ["children", "createTime", "updateTime", "creator", "tenantKey", "deleteType"];
+/**
+ * 改名后**必须原样不变**的字段。任一不等即视为写坏 —— 这正是「扁平记录直接回写」
+ * 那次事故的形状（pageType 被改成 EMPTY、menuType 归零）。
+ */
+export declare const MENU_GUARD_KEYS: readonly ["pageType", "pageId", "menuUrl", "menuType", "linkType", "openMode", "showType", "showOrder", "pid", "type", "sysMenuId", "tabs", "pageExtend", "filterCondition"];
+export interface MenuNode {
+    id: string;
+    name: string;
+    pageType: string;
+    pageId: string;
+    menuUrl: string;
+    menuType: string;
+    sysMenuId: string;
+    parentId: string;
+    depth: number;
+    raw: Record<string, any>;
+}
+export type MenuBucket = 'ebAppMenus' | 'cusAppMenus';
+export declare function menuNameOf(raw: Record<string, any>): string;
+/**
+ * 递归展开菜单树。`depth` 从 0 起，`parentId` 取记录自带的 pid/parentId，
+ * 缺失时回落到所在层的父节点 id。
+ */
+export declare function flattenMenus(nodes: any[], depth?: number, parentId?: string): MenuNode[];
+/**
+ * 选桶。两桶装的是同一批菜单的两种形状（`ebAppMenus` 用 `content`/`pid`，
+ * `cusAppMenus` 用 `menuName`/`parentId`），**不能合并**（会翻倍）。
+ * 优先 `ebAppMenus` —— 它的键集就是写报文（`savePublishMenu` 的 navigation）的形状。
+ */
+export declare function pickMenuBucket(data: any): {
+    nodes: MenuNode[];
+    bucket: MenuBucket;
+};
+/**
+ * 按 id 或名称找菜单。id 精确命中优先；否则返回**所有**同名节点
+ * （真实数据里同一个应用存在两条「合同门户页面」—— 调用方必须据此报歧义，不能擅自挑一条）。
+ */
+export declare function findMenus(nodes: MenuNode[], query: string): MenuNode[];
+/** 按名称模糊找候选（用于「找不到」时给提示）。 */
+export declare function similarMenus(nodes: MenuNode[], query: string, limit?: number): MenuNode[];
+/**
+ * 平台系统项（回收站 / 设置 / 个人设置 …）。这些菜单由平台维护、指向内置页面，
+ * 改名没有语义，调用方应拒绝。
+ */
+export declare function isSystemMenu(node: MenuNode): boolean;
+/**
+ * 构造改名的写报文：以读回的记录为底，只动名字，再**补上写侧要的嵌套 `page`**。
+ *
+ * 关键取舍：
+ * - 读侧派生键一律摘掉（`children` 等），它们不是 navigation 的一部分。
+ * - `page` 必须重建：记录里没有这个键，而写侧认它。缺了就是「LINK 变 EMPTY」那次事故。
+ * - `menuUrl` **只在记录里本来就有非空值时**带上；没有就整个省略。服务端只在它为空时才写它，
+ *   拿 pageId 顶替会把菜单写脏。
+ * - `filterCondition` / `tabs` / `pageExtend` 等一律沿用记录原值，不重造 ——
+ *   改名不该顺手改掉别人的筛选条件。
+ */
+export declare function buildRenameNavigation(node: MenuNode, newName: string, appId: string): Record<string, any>;
+/**
+ * 比对改名前后，返回**名字之外**发生变化的守卫字段。
+ * 返回空数组才算改名干净；非空即调用方应硬失败并点名。
+ */
+export declare function diffMenuGuard(before: MenuNode, after: MenuNode): string[];
+/** 把节点表按层级渲染成缩进行（对齐 `role` 命令的树形打印）。 */
+export declare function renderMenuTree(nodes: MenuNode[]): string[];
+/** 嵌套（非顶层）节点数。 */
+export declare function nestedCount(nodes: MenuNode[]): number;
+//# sourceMappingURL=menu-catalog.d.ts.map

package/dist/services/menu-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-catalog.d.ts","sourceRoot":"","sources":["../../src/services/menu-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,+CAA+C;AAC/C,eAAO,MAAM,kBAAkB,yFAOrB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,eAAe,8KAGlB,CAAC;AAEX,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC1B;AAED,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,aAAa,CAAC;AAWtD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,KAAK,SAAI,EAAE,QAAQ,SAAM,GAAG,QAAQ,EAAE,CAsBhF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,GAAG;IAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAMnF;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CAMtE;AAED,6BAA6B;AAC7B,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,QAAQ,EAAE,CAOrF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA2BzG;AAOD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE,CAQzE;AAED,wCAAwC;AACxC,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAE1D;AAED,kBAAkB;AAClB,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAErD"}

package/dist/services/menu-catalog.js

@@ -0,0 +1,183 @@
+/**
+ * 应用菜单目录：把 `allMenus` 的原始返回**递归展开**成可查询的节点表，并构造改名的写报文。
+ *
+ * 两件事非做不可，都是踩过的坑：
+ *
+ * 1. **菜单是棵树，不是一层。** `allMenus` 返回的每条记录带 `children`（实测嵌套到三层，
+ *    如「设置 → 个人设置 → 个人菜单设置」）。只映射顶层数组会把嵌套菜单全丢掉 ——
+ *    调用方据此断言「这个应用没有这个菜单」，是**没取到 ≠ 不存在**的那类假否定。
+ *
+ * 2. **改名不能把读回来的那条记录原样写回去。** 读侧是扁平记录，写侧读的是**嵌套的
+ *    `page: {pageId, pageName, pageType, …}`** 对象；直接回写会把菜单写坏
+ *    （实测 LINK → EMPTY、pageId 清空、menuType 归零）。必须重建 `page`。
+ *    `menuUrl` 同理：记录里有就原样带，没有就**整个省略** —— 拿 pageId 顶替会把菜单写脏，
+ *    而服务端只在它为空时才肯写这个键。
+ */
+/** 两个桶的字段名不同，取值时两组都要认。 */
+const NAME_KEYS = ['content', 'menuName', 'showName', 'alias', 'nameAlias', 'realName'];
+const PARENT_KEYS = ['pid', 'parentId'];
+/** 读侧派生 / 只读键：回写会造成干扰（与 fields/表单一侧的只读键同理）。 */
+export const MENU_READONLY_KEYS = [
+    'children',
+    'createTime',
+    'updateTime',
+    'creator',
+    'tenantKey',
+    'deleteType',
+];
+/**
+ * 改名后**必须原样不变**的字段。任一不等即视为写坏 —— 这正是「扁平记录直接回写」
+ * 那次事故的形状（pageType 被改成 EMPTY、menuType 归零）。
+ */
+export const MENU_GUARD_KEYS = [
+    'pageType', 'pageId', 'menuUrl', 'menuType', 'linkType', 'openMode',
+    'showType', 'showOrder', 'pid', 'type', 'sysMenuId', 'tabs', 'pageExtend', 'filterCondition',
+];
+/** 逐层取值：两个桶的键名不同，谁的先命中用谁。 */
+function firstOf(raw, keys) {
+    for (const k of keys) {
+        const v = raw?.[k];
+        if (v !== undefined && v !== null && String(v) !== '')
+            return String(v);
+    }
+    return '';
+}
+export function menuNameOf(raw) {
+    return firstOf(raw, NAME_KEYS);
+}
+/**
+ * 递归展开菜单树。`depth` 从 0 起，`parentId` 取记录自带的 pid/parentId，
+ * 缺失时回落到所在层的父节点 id。
+ */
+export function flattenMenus(nodes, depth = 0, parentId = '0') {
+    const out = [];
+    for (const raw of nodes || []) {
+        if (!raw || typeof raw !== 'object')
+            continue;
+        const id = String(raw.id ?? '');
+        out.push({
+            id,
+            name: menuNameOf(raw),
+            pageType: String(raw.pageType ?? ''),
+            pageId: String(raw.pageId ?? ''),
+            menuUrl: String(raw.menuUrl ?? ''),
+            menuType: String(raw.menuType ?? ''),
+            sysMenuId: String(raw.sysMenuId ?? ''),
+            parentId: firstOf(raw, PARENT_KEYS) || String(parentId),
+            depth,
+            raw,
+        });
+        if (Array.isArray(raw.children) && raw.children.length) {
+            out.push(...flattenMenus(raw.children, depth + 1, id));
+        }
+    }
+    return out;
+}
+/**
+ * 选桶。两桶装的是同一批菜单的两种形状（`ebAppMenus` 用 `content`/`pid`，
+ * `cusAppMenus` 用 `menuName`/`parentId`），**不能合并**（会翻倍）。
+ * 优先 `ebAppMenus` —— 它的键集就是写报文（`savePublishMenu` 的 navigation）的形状。
+ */
+export function pickMenuBucket(data) {
+    const eb = data?.ebAppMenus;
+    const cus = data?.cusAppMenus;
+    if (Array.isArray(eb) && eb.length)
+        return { nodes: flattenMenus(eb), bucket: 'ebAppMenus' };
+    if (Array.isArray(cus) && cus.length)
+        return { nodes: flattenMenus(cus), bucket: 'cusAppMenus' };
+    return { nodes: [], bucket: 'ebAppMenus' };
+}
+/**
+ * 按 id 或名称找菜单。id 精确命中优先；否则返回**所有**同名节点
+ * （真实数据里同一个应用存在两条「合同门户页面」—— 调用方必须据此报歧义，不能擅自挑一条）。
+ */
+export function findMenus(nodes, query) {
+    const q = String(query ?? '').trim();
+    if (!q)
+        return [];
+    const byId = nodes.filter((n) => n.id === q);
+    if (byId.length)
+        return byId;
+    return nodes.filter((n) => n.name === q);
+}
+/** 按名称模糊找候选（用于「找不到」时给提示）。 */
+export function similarMenus(nodes, query, limit = 10) {
+    const q = String(query ?? '').trim();
+    if (!q)
+        return [];
+    return nodes
+        .filter((n) => n.name.includes(q) || q.includes(n.name))
+        .filter((n) => n.name)
+        .slice(0, limit);
+}
+/**
+ * 平台系统项（回收站 / 设置 / 个人设置 …）。这些菜单由平台维护、指向内置页面，
+ * 改名没有语义，调用方应拒绝。
+ */
+export function isSystemMenu(node) {
+    return node.pageType === 'setting' || node.pageType === 'BASE';
+}
+/**
+ * 构造改名的写报文：以读回的记录为底，只动名字，再**补上写侧要的嵌套 `page`**。
+ *
+ * 关键取舍：
+ * - 读侧派生键一律摘掉（`children` 等），它们不是 navigation 的一部分。
+ * - `page` 必须重建：记录里没有这个键，而写侧认它。缺了就是「LINK 变 EMPTY」那次事故。
+ * - `menuUrl` **只在记录里本来就有非空值时**带上；没有就整个省略。服务端只在它为空时才写它，
+ *   拿 pageId 顶替会把菜单写脏。
+ * - `filterCondition` / `tabs` / `pageExtend` 等一律沿用记录原值，不重造 ——
+ *   改名不该顺手改掉别人的筛选条件。
+ */
+export function buildRenameNavigation(node, newName, appId) {
+    const nav = { ...node.raw };
+    for (const k of MENU_READONLY_KEYS)
+        delete nav[k];
+    nav.id = node.id;
+    // 两个桶的名字键名不同，记录里有哪个就改哪个；content 是写侧主键，始终给。
+    nav.content = newName;
+    for (const k of ['alias', 'nameAlias', 'realName', 'menuName', 'showName']) {
+        if (k in nav)
+            nav[k] = newName;
+    }
+    nav.page = {
+        pageId: node.pageId,
+        pageName: String(node.raw.pageName || newName),
+        pageType: node.pageType,
+        terminalScopes: String(node.raw.terminalScopes ?? ''),
+        appid: appId,
+    };
+    // 有才带，没有就省略 —— 不要用 pageId 合成
+    if (node.raw.menuUrl !== undefined && String(node.raw.menuUrl) !== '') {
+        nav.menuUrl = String(node.raw.menuUrl);
+    }
+    else {
+        delete nav.menuUrl;
+    }
+    return nav;
+}
+/** 归一化比较值：`undefined` 与 `''` 视为等价（键存在与否不代表语义差异）。 */
+function norm(v) {
+    return v === undefined || v === null ? '' : String(v);
+}
+/**
+ * 比对改名前后，返回**名字之外**发生变化的守卫字段。
+ * 返回空数组才算改名干净；非空即调用方应硬失败并点名。
+ */
+export function diffMenuGuard(before, after) {
+    const changed = [];
+    for (const k of MENU_GUARD_KEYS) {
+        if (norm(before.raw?.[k]) !== norm(after.raw?.[k])) {
+            changed.push(`${k}: ${JSON.stringify(norm(before.raw?.[k]))} → ${JSON.stringify(norm(after.raw?.[k]))}`);
+        }
+    }
+    return changed;
+}
+/** 把节点表按层级渲染成缩进行（对齐 `role` 命令的树形打印）。 */
+export function renderMenuTree(nodes) {
+    return nodes.map((n) => `${'  '.repeat(n.depth + 1)}${n.name}`);
+}
+/** 嵌套（非顶层）节点数。 */
+export function nestedCount(nodes) {
+    return nodes.filter((n) => n.depth > 0).length;
+}
+//# sourceMappingURL=menu-catalog.js.map

package/dist/services/menu-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-catalog.js","sourceRoot":"","sources":["../../src/services/menu-catalog.ts"],"names":[],"mappings":"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"}

package/dist/services/rich-text.d.ts

@@ -0,0 +1,33 @@
+/** 展开 `{{}}` 时需要的最少字段信息（ds/fields 的字段对象即可直接传）。 */
+export interface FieldRefSource {
+    id?: string;
+    fieldId?: string;
+    text?: string;
+    showName?: string;
+    fieldGroup?: {
+        name?: string;
+    };
+}
+export interface ExpandResult {
+    html: string;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * 生成一个字段引用标记。字段缺 id 时返回 null（调用方据此报错）。
+ * `formTitle` 取不到时占位文本退化成只有字段名 —— 那只是显示文本，平台渲染时会按 data-val 取值。
+ */
+export declare function fieldRefSpan(objId: string, field: FieldRefSource): string | null;
+/**
+ * 展开富文本里的 `{{字段名}}` / `{{fieldId}}` 为平台字段引用标记。
+ *
+ * 同一字段出现多次会各展开一份（平台按出现位置逐个记引用，不能去重）。
+ * 有 error 时 **html 原样返回** —— 调用方据此中止，不把半截内容写进视图。
+ */
+export declare function expandFieldRefs(html: string, objId: string, fields: FieldRefSource[]): ExpandResult;
+/**
+ * 校验富文本里**已展开**的字段引用标记：data-val 里的 fieldId 是否真的在这张表单里。
+ * 用于手写 HTML（不走 `{{}}`）的场景，把「静默显示不出值」提前变成一条警告。
+ */
+export declare function auditFieldRefs(html: string, knownFieldIds: Set<string>): string[];
+//# sourceMappingURL=rich-text.d.ts.map

package/dist/services/rich-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rich-text.d.ts","sourceRoot":"","sources":["../../src/services/rich-text.ts"],"names":[],"mappings":"AAuBA,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAiBD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAUhF;AAiBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GACpD,YAAY,CAkCd;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CA0BjF"}

package/dist/services/rich-text.js

@@ -0,0 +1,134 @@
+/**
+ * 自定义文本（富文本列）里的**表单字段引用**。
+ *
+ * 表单的列表式视图（台账）能加一列「自定义文本」：内容是一段富文本，除了固定文字和图片，
+ * 还能通过工具栏的字段图标**插入表单字段**。平台存下来的是一段 HTML，
+ * 插入字段的位置是一个 contenteditable=false 的 span：
+ *
+ * ```html
+ * <span contenteditable="false" data-type="list" data-val="{objId.fieldId}">{表名.字段名}</span>
+ * ```
+ *
+ * 其中 `data-val` 里的 `objId.fieldId` 才是身份（平台按它取值），span 里的 `{表名.字段名}`
+ * 只是占位显示。**两个值都写错时不报错、只是静默显示不出值**，所以不让调用方直接拼这段 HTML：
+ * 模板里写 `{{字段名}}` 或 `{{fieldId}}`，由本模块查表单元数据展开成完整 span。
+ */
+/** 模板里插入字段的写法：`{{字段名}}` / `{{fieldId}}`。 */
+const TOKEN_RE = /\{\{\s*([^{}]+?)\s*\}\}/g;
+/** 平台自带的字段引用标记（已展开的 span）。先认 span，再单独解析 data-val ——
+ * 合成一条正则的话，data-val 写坏时整个匹配不上，等于把「静默显示不出值」漏报掉。 */
+const SPAN_RE = /<span\b[^>]*\bdata-type="list"[^>]*>[\s\S]*?<\/span>/g;
+const DATA_VAL_RE = /\bdata-val="\{([^}]*)\}"/;
+/** HTML 文本节点转义：字段名里可能有 `&`/`<` 之类字符。 */
+function escapeText(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+/** 字段在表单里的显示名（text 优先，退回 showName）。 */
+function titleOf(f) {
+    return String(f.text || f.showName || '').trim();
+}
+/** 字段所属表名（平台放在 fieldGroup.name）。 */
+function formTitleOf(f) {
+    return String(f.fieldGroup?.name || '').trim();
+}
+/**
+ * 生成一个字段引用标记。字段缺 id 时返回 null（调用方据此报错）。
+ * `formTitle` 取不到时占位文本退化成只有字段名 —— 那只是显示文本，平台渲染时会按 data-val 取值。
+ */
+export function fieldRefSpan(objId, field) {
+    const fieldId = String(field.fieldId || field.id || '').trim();
+    if (!fieldId || !objId)
+        return null;
+    const formTitle = formTitleOf(field);
+    const fieldTitle = titleOf(field);
+    const label = formTitle ? `{${formTitle}.${fieldTitle}}` : `{${fieldTitle}}`;
+    return ('<span contenteditable="false" data-type="list"' +
+        ` data-val="{${objId}.${fieldId}}">${escapeText(label)}</span>`);
+}
+/** 按 token 找字段：先 id/fieldId 精确命中，再按显示名；显示名重复时报歧义。 */
+function matchField(token, fields) {
+    const byId = fields.find((f) => String(f.fieldId || '') === token || String(f.id || '') === token);
+    if (byId)
+        return { field: byId };
+    const byName = fields.filter((f) => titleOf(f) === token);
+    if (byName.length === 1)
+        return { field: byName[0] };
+    if (byName.length > 1) {
+        return { error: `字段名「${token}」在该表单内不唯一（${byName.length} 个），请改用 fieldId` };
+    }
+    return { error: `未找到字段「${token}」（可用字段名或 fieldId；字段列表用 form read 查）` };
+}
+/**
+ * 展开富文本里的 `{{字段名}}` / `{{fieldId}}` 为平台字段引用标记。
+ *
+ * 同一字段出现多次会各展开一份（平台按出现位置逐个记引用，不能去重）。
+ * 有 error 时 **html 原样返回** —— 调用方据此中止，不把半截内容写进视图。
+ */
+export function expandFieldRefs(html, objId, fields) {
+    const errors = [];
+    const warnings = [];
+    if (typeof html !== 'string' || !html)
+        return { html: html || '', errors, warnings };
+    // fieldMap 里同一字段会有 id / fieldId 两个键，先把重复项去掉再判歧义
+    const seen = new Set();
+    const uniq = [];
+    for (const f of fields) {
+        const key = String(f.fieldId || f.id || '');
+        if (!key || seen.has(key))
+            continue;
+        seen.add(key);
+        uniq.push(f);
+    }
+    const out = html.replace(TOKEN_RE, (raw, token) => {
+        const name = String(token).trim();
+        const hit = matchField(name, uniq);
+        if (hit.error) {
+            errors.push(hit.error);
+            return raw;
+        }
+        const span = fieldRefSpan(objId, hit.field);
+        if (!span) {
+            errors.push(`字段「${name}」缺少 fieldId，无法生成引用`);
+            return raw;
+        }
+        if (!formTitleOf(hit.field)) {
+            warnings.push(`字段「${name}」的表名缺失，引用标记的占位文本只写了字段名（不影响取值）`);
+        }
+        return span;
+    });
+    return { html: errors.length ? html : out, errors, warnings };
+}
+/**
+ * 校验富文本里**已展开**的字段引用标记：data-val 里的 fieldId 是否真的在这张表单里。
+ * 用于手写 HTML（不走 `{{}}`）的场景，把「静默显示不出值」提前变成一条警告。
+ */
+export function auditFieldRefs(html, knownFieldIds) {
+    const warnings = [];
+    if (typeof html !== 'string' || !html)
+        return warnings;
+    const seen = new Set();
+    let m;
+    SPAN_RE.lastIndex = 0;
+    while ((m = SPAN_RE.exec(html)) !== null) {
+        const vm = DATA_VAL_RE.exec(m[0]);
+        if (!vm) {
+            warnings.push('自定义文本里有一个字段引用标记读不出 data-val（格式应为 data-val="{objId.fieldId}"），平台会静默显示不出值');
+            continue;
+        }
+        const ref = vm[1];
+        const dot = ref.lastIndexOf('.');
+        if (dot <= 0) {
+            warnings.push(`字段引用标记 data-val="{${ref}}" 格式不是 {objId.fieldId}`);
+            continue;
+        }
+        const fieldId = ref.slice(dot + 1);
+        if (seen.has(fieldId))
+            continue;
+        seen.add(fieldId);
+        if (!knownFieldIds.has(fieldId)) {
+            warnings.push(`自定义文本里引用了 fieldId=${fieldId}，但该表单查不到这个字段（平台会静默显示不出值）`);
+        }
+    }
+    return warnings;
+}
+//# sourceMappingURL=rich-text.js.map

package/dist/services/rich-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rich-text.js","sourceRoot":"","sources":["../../src/services/rich-text.ts"],"names":[],"mappings":"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"}

package/dist/services/workflow-add-step.d.ts

@@ -0,0 +1,45 @@
+import type { ApiClient } from '../core/client.js';
+/** 加签接收人选择方式 */
+export declare const SELECT_MODES: Record<string, number>;
+export declare const SELECT_MODE_LABELS: Record<number, string>;
+/** 默认环节类型 */
+export declare const NODE_TYPES: Record<string, number>;
+export declare const NODE_TYPE_LABELS: Record<number, string>;
+/** 默认会签属性 */
+export declare const SIGN_ATTRS: Record<string, number>;
+export declare const SIGN_ATTR_LABELS: Record<number, string>;
+/** 流转结束后默认流转方式 */
+export declare const FLOW_TYPES: Record<string, number>;
+export declare const FLOW_TYPE_LABELS: Record<number, string>;
+/** 回到本节点后的流转方式 */
+export declare const BACK_FLOW_TYPES: Record<string, number>;
+export declare const BACK_FLOW_TYPE_LABELS: Record<number, string>;
+/** 加签人字段权限 */
+export declare const FIELD_AUTH_TYPES: Record<string, number>;
+export declare const FIELD_AUTH_TYPE_LABELS: Record<number, string>;
+export interface AddStepSettings {
+    selectMode: number;
+    defNodeType: number;
+    defSignAttr: number;
+    defFlowType: number;
+    backFlowType: number;
+    fieldauthType: number;
+    /** 允许修改流程表单内容：0 关闭 / 1 开启 */
+    defModifyForm: number;
+    /** 限制接收范围（只开开关，范围明细另行保存） */
+    limitReceiveRange: boolean;
+}
+export declare const DEFAULT_ADD_STEP: AddStepSettings;
+/** 回读归一：字符串枚举 → 数字，布尔 → 布尔 */
+export declare function normalizeAddStep(data: any): AddStepSettings;
+export declare function getAddStepSettings(client: ApiClient, baseUrl: string, workflowId: string, nodeId: string): Promise<AddStepSettings>;
+/** 枚举越界检查。返回错误文案数组（空 = 通过）。 */
+export declare function validateAddStep(s: AddStepSettings): string[];
+/**
+ * 保存。**枚举一律发数字** —— 把 GET 回读的字符串原样发出去会 500。
+ * 返回实际写出的设置，供调用方回读比对。
+ */
+export declare function saveAddStepSettings(client: ApiClient, baseUrl: string, workflowId: string, nodeId: string, s: AddStepSettings): Promise<AddStepSettings>;
+/** 回读比对，返回不一致项 */
+export declare function diffAddStep(before: AddStepSettings, after: AddStepSettings): string[];
+//# sourceMappingURL=workflow-add-step.d.ts.map

package/dist/services/workflow-add-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-add-step.d.ts","sourceRoot":"","sources":["../../src/services/workflow-add-step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAkBnD,gBAAgB;AAChB,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAoC,CAAC;AACrF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAwC,CAAC;AAE/F,aAAa;AACb,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAuC,CAAC;AACtF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAiC,CAAC;AAEtF,aAAa;AACb,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAwC,CAAC;AACvF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAsC,CAAC;AAE3F,kBAAkB;AAClB,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAwB,CAAC;AACvE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAiC,CAAC;AAEtF,kBAAkB;AAClB,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAwC,CAAC;AAC5F,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAExD,CAAC;AAEF,cAAc;AACd,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAuB,CAAC;AAC5E,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAmC,CAAC;AAE9F,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,gBAAgB,EAAE,eAG9B,CAAC;AAEF,8BAA8B;AAC9B,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,GAAG,eAAe,CAkB3D;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GACrE,OAAO,CAAC,eAAe,CAAC,CAQ1B;AAED,+BAA+B;AAC/B,wBAAgB,eAAe,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,EAAE,CAe5D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,eAAe,GACzF,OAAO,CAAC,eAAe,CAAC,CAoB1B;AAED,kBAAkB;AAClB,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,GAAG,MAAM,EAAE,CAMrF"}

package/dist/services/workflow-add-step.js

@@ -0,0 +1,122 @@
+/**
+ * 节点加签设置（操作菜单「加签」按钮的内部设置）。
+ *
+ * GET `addstep/getNodeAddStepSetForm` 的返回多包一层：`data.addStepForm.data`。
+ *
+ * **回读的值不能直接写回去**（2026-09-22 实测）：GET 把这些枚举回读成**字符串**
+ * `"0"/"1"/"2"`、`limitReceiveRange` 回读成布尔 `false`，原样提交直接 500「系统错误」。
+ * 全部转成数字再发就通 —— 与指定流转、节点菜单是同一类读写形状不对称。
+ *
+ * 另一处文档与实际不符：接口库写 `fieldauthType` 是「1 所有字段权限 / 2 与当前节点一致」，
+ * 线上实际枚举是 **0 所有字段权限 / 1 与当前节点保持一致**（页面默认值就是 `"1"`）。
+ * 照文档发 `2` 是个枚举里不存在的值。
+ */
+const BASE = '/api/bs/workflow/pathdef';
+/** 加签接收人选择方式 */
+export const SELECT_MODES = { simple: 0, list: 1, chart: 2 };
+export const SELECT_MODE_LABELS = { 0: '简易模式', 1: '列表模式', 2: '流程图模式' };
+/** 默认环节类型 */
+export const NODE_TYPES = { approve: 0, confirm: 1, view: 2 };
+export const NODE_TYPE_LABELS = { 0: '审批', 1: '确认', 2: '查阅' };
+/** 默认会签属性 */
+export const SIGN_ATTRS = { countersign: 0, non: 1, order: 2 };
+export const SIGN_ATTR_LABELS = { 0: '会签', 1: '非会签', 2: '依次逐个处理' };
+/** 流转结束后默认流转方式 */
+export const FLOW_TYPES = { next: 0, back: 1 };
+export const FLOW_TYPE_LABELS = { 0: '自动流转下一节点', 1: '回到本节点' };
+/** 回到本节点后的流转方式 */
+export const BACK_FLOW_TYPES = { operator: 0, next: 1, addstep: 2 };
+export const BACK_FLOW_TYPE_LABELS = {
+    0: '由当前节点操作者选择', 1: '流转至下一节点', 2: '流转至加签环节',
+};
+/** 加签人字段权限 */
+export const FIELD_AUTH_TYPES = { all: 0, same: 1 };
+export const FIELD_AUTH_TYPE_LABELS = { 0: '所有字段权限', 1: '与当前节点保持一致' };
+export const DEFAULT_ADD_STEP = {
+    selectMode: 1, defNodeType: 0, defSignAttr: 0, defFlowType: 0,
+    backFlowType: 0, fieldauthType: 1, defModifyForm: 0, limitReceiveRange: false,
+};
+/** 回读归一：字符串枚举 → 数字，布尔 → 布尔 */
+export function normalizeAddStep(data) {
+    const d = data || {};
+    const num = (v, fallback) => {
+        if (v === undefined || v === null || v === '')
+            return fallback;
+        if (typeof v === 'boolean')
+            return v ? 1 : 0;
+        const n = Number(v);
+        return Number.isFinite(n) ? n : fallback;
+    };
+    return {
+        selectMode: num(d.selectMode, DEFAULT_ADD_STEP.selectMode),
+        defNodeType: num(d.defNodeType, DEFAULT_ADD_STEP.defNodeType),
+        defSignAttr: num(d.defSignAttr, DEFAULT_ADD_STEP.defSignAttr),
+        defFlowType: num(d.defFlowType, DEFAULT_ADD_STEP.defFlowType),
+        backFlowType: num(d.backFlowType, DEFAULT_ADD_STEP.backFlowType),
+        fieldauthType: num(d.fieldauthType, DEFAULT_ADD_STEP.fieldauthType),
+        defModifyForm: num(d.defModifyForm, DEFAULT_ADD_STEP.defModifyForm),
+        limitReceiveRange: d.limitReceiveRange === true || d.limitReceiveRange === 1 || d.limitReceiveRange === '1',
+    };
+}
+export async function getAddStepSettings(client, baseUrl, workflowId, nodeId) {
+    const res = await client.get(`${baseUrl}${BASE}/addstep/getNodeAddStepSetForm?workflowId=${workflowId}&nodeId=${nodeId}`);
+    if (res?.code !== 200 || !res?.status)
+        throw new Error(`读取加签设置失败: ${res?.msg || '未知错误'}`);
+    const form = res?.data?.addStepForm;
+    if (!form?.data)
+        throw new Error(`加签设置返回结构异常（缺 addStepForm.data），节点 ${nodeId} 可能不支持加签`);
+    return normalizeAddStep(form.data);
+}
+/** 枚举越界检查。返回错误文案数组（空 = 通过）。 */
+export function validateAddStep(s) {
+    const errors = [];
+    const check = (label, value, labels) => {
+        if (!(value in labels)) {
+            errors.push(`${label} 不支持 ${value}，可选: ${Object.entries(labels).map(([k, v]) => `${k}=${v}`).join(' / ')}`);
+        }
+    };
+    check('选择方式', s.selectMode, SELECT_MODE_LABELS);
+    check('环节类型', s.defNodeType, NODE_TYPE_LABELS);
+    check('会签属性', s.defSignAttr, SIGN_ATTR_LABELS);
+    check('流转方式', s.defFlowType, FLOW_TYPE_LABELS);
+    check('回到本节点后流转方式', s.backFlowType, BACK_FLOW_TYPE_LABELS);
+    check('字段权限', s.fieldauthType, FIELD_AUTH_TYPE_LABELS);
+    check('允许修改表单内容', s.defModifyForm, { 0: '关闭', 1: '开启' });
+    return errors;
+}
+/**
+ * 保存。**枚举一律发数字** —— 把 GET 回读的字符串原样发出去会 500。
+ * 返回实际写出的设置，供调用方回读比对。
+ */
+export async function saveAddStepSettings(client, baseUrl, workflowId, nodeId, s) {
+    const errors = validateAddStep(s);
+    if (errors.length)
+        throw new Error(errors.join('；'));
+    const payload = {
+        workflowId, nodeId,
+        selectMode: Number(s.selectMode),
+        defNodeType: Number(s.defNodeType),
+        defSignAttr: Number(s.defSignAttr),
+        defFlowType: Number(s.defFlowType),
+        backFlowType: Number(s.backFlowType),
+        fieldauthType: Number(s.fieldauthType),
+        defModifyForm: Number(s.defModifyForm),
+        limitReceiveRange: s.limitReceiveRange ? 1 : 0,
+        isSync: false,
+    };
+    const res = await client.post(`${baseUrl}${BASE}/addstep/saveNodeAddStepSetInfo`, payload);
+    if (res?.code !== 200 || res?.status === false) {
+        throw new Error(`保存加签设置失败: ${res?.msg || '未知错误'}`);
+    }
+    return s;
+}
+/** 回读比对，返回不一致项 */
+export function diffAddStep(before, after) {
+    const out = [];
+    for (const key of Object.keys(before)) {
+        if (before[key] !== after[key])
+            out.push(`${key}: 期望 ${String(before[key])}，回读 ${String(after[key])}`);
+    }
+    return out;
+}
+//# sourceMappingURL=workflow-add-step.js.map