weaver-e10-builder 1.2.5 → 1.5.1

package/dist/services/form-formula-linkage.js

@@ -0,0 +1,546 @@
+/**
+ * 函数联动（`linkageType='excel'`）—— 表单字段之间的公式赋值式联动。
+ *
+ * ## 它是什么
+ *
+ * 设计器里「函数联动」面板配出来的规则：**在哪儿生效 + 什么时候触发 + 谁触发 + 赋值给谁**。
+ * 落库是一条 **FormDataLinkage**，`linkageType: 'excel'` —— 与 `form field-linkage`
+ * （`linkageType: 'template'`，ESB 跨表带出）**共用同一个保存端点** `saveFormDataLinkage`，
+ * 区别只在这几个键：
+ *
+ * | | field-linkage（跨表带出） | 函数联动（本模块） |
+ * |---|---|---|
+ * | `linkageType` | `template` | `excel` |
+ * | 数据源 | `dataSources[].sourceEsb` + `dataSourceId` | `dataSources[].sourceExcel.{excelId, excelName}` |
+ * | `linkageExt.subFormAddType` | `override` | `append` |
+ * | 取值靠 | ESB 应用（application/save + saveDesign） | 一张公式（`/api/excel/formula/save`） |
+ *
+ * 因为取值靠公式，所以建联动前要**先建公式**，`sourceExcel.excelId` 就是那个公式的 id。
+ *
+ * ## 两条容易踩的
+ *
+ * 1. **赋值式**：公式的 `expressSql` 不是纯函数体，是 `{主表.目标}=<函数体>`，且
+ *    `returnType` / `validateType` 都是 `EqualAssign`（普通字段公式是 `Number|String|Date` / `normal`）。
+ *    用户给的通常只有右侧函数体，由 `buildAssignExpression` 拼出左侧。
+ * 2. **模块字段不能作赋值目标**：平台在 `extendParam.unSupportTargets` 里列了 21 个语义键，
+ *    实测**正好等于** `findFormDrivingColumns` 的模块字段桶。那些字段可以出现在公式右侧、
+ *    也可以当触发字段，但**不能**出现在 `=` 左边。判据见 `MODULE_FIELD_KEYS`。
+ */
+export const LINKAGE_API = '/api/ebuilder/form/form/linkage';
+/**
+ * 模块字段（系统字段）语义键 —— 平台在 `extendParam.unSupportTargets` 里原样给出的 21 项。
+ *
+ * 它同时是两条判据：① 哪些列是模块字段（`id` 落在这个集合里）；
+ * ② 哪些字段**不能**作为赋值目标（就是这 21 个）。
+ */
+export const MODULE_FIELD_KEYS = [
+    'name', 'creator', 'createTime', 'updateTime', 'id', 'updater', 'dataStatus', 'formDataId',
+    'addBatchId', 'updateBatchId', 'objId',
+    'system_operator_manage_all_id', 'system_operator_name', 'system_operator_id',
+    'system_operator_sub_company_id', 'system_operator_department_id', 'system_operator_manage_id',
+    'current_date', 'current_date_time', 'form_id', 'form_data_id',
+];
+/** 流程表单那条路由的端点前缀。eb 表是 `LINKAGE_API`。 */
+export const FLOW_LINKAGE_API = '/api/ebuilder/flow/form/linkage';
+/**
+ * 流程表单驱动列里的模块字段（32 个）。
+ * ⚠ 它与下面的「不可作赋值目标」清单**不相等** —— 别拿这一份当判据，见 `FLOW_ASSIGNABLE_SYSTEM_KEYS`。
+ */
+export const FLOW_MODULE_FIELD_KEYS = [
+    'REQUEST_ID', 'WORKFLOW_ID', 'WORKFLOW_NAME', 'WORKFLOW_TYPE', 'WORKFLOW_DESC',
+    'REQ_REQUEST_NAME', 'REQUEST_NO', 'REQUEST_LEVEL', 'PRINT_COUNT',
+    'CREATE_USER', 'CREATE_SUB', 'CREATE_DEPT', 'CREATE_JOB', 'CREATE_RANK',
+    'CREATE_DATE', 'CREATE_TIME', 'FINISH_DATE', 'FINISH_TIME', 'FINISH_DATETIME_FORMULA',
+    'CURRENT_NODE', 'browserCurrentOperator', 'browserCurrentOperatorPartTime',
+    'system_operator_manage_all_id', 'system_operator_name', 'system_operator_id',
+    'system_operator_sub_company_id', 'system_operator_department_id', 'system_operator_manage_id',
+    'current_date', 'current_date_time', 'form_id', 'form_data_id',
+];
+/** 流程表单里**不可作赋值目标**的系统字段（30 个）—— 就是平台的 `unSupportTargets`。 */
+export const FLOW_UNSUPPORTED_TARGET_KEYS = FLOW_MODULE_FIELD_KEYS
+    .filter((k) => !['REQ_REQUEST_NAME', 'REQUEST_LEVEL'].includes(k));
+/**
+ * **是模块字段、却可以作赋值目标**的两个例外：`流程标题` 与 `紧急程度`。
+ *
+ * 这两条是从 `FLOW_MODULE_FIELD_KEYS` 与 `FLOW_UNSUPPORTED_TARGET_KEYS` 的差集里来的 ——
+ * eb 表那边两份清单恰好都是 21、完全一致，所以「是模块字段就不能当目标」这个粗判据当时看不出问题；
+ * 到了流程表单会**误拒**这两个能用的字段。`columns` 命令的漂移告警要豁免它们。
+ */
+export const FLOW_ASSIGNABLE_SYSTEM_KEYS = ['REQ_REQUEST_NAME', 'REQUEST_LEVEL'];
+/** eb 表那条路由。`unsupportedTargets` 与 `moduleFieldKeys` 恰好同为 21 项。 */
+export const EB_ROUTE = {
+    apiBase: LINKAGE_API,
+    module: 'ebuilderform',
+    useApid: true,
+    customParam: (ctx) => ({ appId: ctx.appId, objId: ctx.objId }),
+    requiresRefId: false,
+    unsupportedTargets: MODULE_FIELD_KEYS,
+    moduleFieldKeys: MODULE_FIELD_KEYS,
+    assignableSystemKeys: [],
+    columnsHint: 'form formula-linkage columns',
+};
+/** 流程表单那条路由。`refId` 是 workflowId，`customParam` 是 `{scene:'workflow'}`。 */
+export const FLOW_ROUTE = {
+    apiBase: FLOW_LINKAGE_API,
+    module: 'ebuildercard',
+    useApid: false,
+    customParam: () => ({ scene: 'workflow' }),
+    requiresRefId: true,
+    unsupportedTargets: FLOW_UNSUPPORTED_TARGET_KEYS,
+    moduleFieldKeys: FLOW_MODULE_FIELD_KEYS,
+    assignableSystemKeys: FLOW_ASSIGNABLE_SYSTEM_KEYS,
+    columnsHint: 'wf-form formula-linkage columns',
+};
+/**
+ * 拼联动接口的 URL。两条路由的差别就在「带不带 `?apid=`」这一处，
+ * 集中在这里而不是散在命令文件里拼字符串。
+ */
+export function buildLinkageApiUrl(route, op, ctx = {}) {
+    const url = `${route.apiBase}/${op}`;
+    if (!route.useApid)
+        return url;
+    return `${url}?apid=${ctx.appId ?? ''}`;
+}
+/** 两条路由的公共定位键：`refId`（流程表单要）与 `customParam`。 */
+function routeLocator(route, ctx) {
+    return {
+        ...(route.requiresRefId ? { refId: String(ctx.refId ?? '') } : {}),
+        customParam: route.customParam({ appId: ctx.appId, objId: ctx.objId }),
+    };
+}
+export function buildLinkageListBody(route, ctx) {
+    return {
+        formId: ctx.formId,
+        ...routeLocator(route, ctx),
+        module: route.module,
+        linkageTypeList: ['excel'],
+        keyword: ctx.keyword ?? '',
+        pageNo: ctx.pageNo ?? 1,
+        pageSize: ctx.pageSize ?? 200,
+        orderData: '',
+    };
+}
+export function buildLinkageQueryBody(route, ctx) {
+    return { id: ctx.id, formId: ctx.formId, ...routeLocator(route, ctx), module: route.module };
+}
+export function buildLinkageDeleteBody(route, ctx) {
+    return { idList: ctx.ids, formId: ctx.formId, ...routeLocator(route, ctx), module: route.module, linkageTypeList: ['excel'] };
+}
+export function buildPreCheckBody(route, ctx) {
+    return { module: route.module, formId: ctx.formId, linkageIds: ctx.linkageIds, customParam: route.customParam({ appId: ctx.appId, objId: ctx.objId }) };
+}
+export function buildDrivingEventsBody(route, ctx) {
+    return { formId: ctx.formId, module: route.module, customParam: route.customParam({ appId: ctx.appId, objId: ctx.objId }) };
+}
+/**
+ * 驱动列的请求体。**故意不带** `notComponentKeyList` —— 平台上那个列表是一大串组件名，
+ * 内容未知、硬编风险更大。判据：返回的列与设计器里能看到的源字段对得上，就说明它不影响我们。
+ */
+export function buildDrivingColumnsBody(route, ctx) {
+    return {
+        formId: ctx.formId,
+        module: route.module,
+        subFormId: 0,
+        scenarioType: 'DATA_LINKAGE_SOURCE',
+        needEncryptionFilter: true,
+        needJoinTitle: true,
+        needI18n: true,
+        customParam: route.customParam({ appId: ctx.appId, objId: ctx.objId }),
+    };
+}
+/**
+ * 一个列是不是模块字段（系统字段）。
+ *
+ * ⚠ **只回答「它是不是系统字段」，不回答「能不能作赋值目标」** —— 那两个概念在流程表单上**不重合**
+ * （见 `FLOW_ASSIGNABLE_SYSTEM_KEYS`）。本函数用于公式引用识别与展示分桶，别拿它当拒绝判据。
+ */
+export function isModuleColumn(col, route = EB_ROUTE) {
+    return route.moduleFieldKeys.includes(String(col?.id)) || String(col?.groupId) === 'moduleField';
+}
+/**
+ * 形状自检：模块字段的 `descType` 是全大写、业务字段是驼峰。
+ * 用来发现「平台新增了模块字段但 `MODULE_FIELD_KEYS` 没跟上」——
+ * 只看 `id` 会漏掉它们，`columns` 命令会把这类列标出来。
+ */
+export function looksLikeModuleColumn(col) {
+    return /^[A-Z][A-Z_0-9]*$/.test(String(col?.descType || ''));
+}
+/** 列的裸标签：`主表.订单编号` → `订单编号`；模块字段本来就是裸标签（`主表数据id`），原样返回。 */
+export function toBareLabel(col) {
+    const name = String(col?.name || '');
+    const prefix = col?.address ? `${col.address}.` : '';
+    if (prefix && name.startsWith(prefix))
+        return name.slice(prefix.length);
+    const dot = name.indexOf('.');
+    return dot > 0 ? name.slice(dot + 1) : name;
+}
+/**
+ * 打印一行列，`columns` 命令与歧义报错共用。
+ *
+ * 标注按「能不能作目标」走，不是按「是不是系统字段」—— 流程表单有两个系统字段是能作目标的。
+ */
+export function describeColumn(col, route = EB_ROUTE) {
+    if (!isModuleColumn(col, route))
+        return `  [${col.id}] ${col.name}  ${col.descType || ''}${col.dataKey ? `  ${col.dataKey}` : ''}`;
+    const mark = isAssignableTarget(col, route)
+        ? '  ← 系统模块字段（可作赋值目标）'
+        : '  ← 系统模块字段，不可作赋值目标';
+    return `  [${col.id}] ${col.name}  ${col.descType || ''}${mark}`;
+}
+/**
+ * 按用户输入找事件：先认 `type`，再认中文名。都不中就把可选项全列出来。
+ */
+export function resolveDrivingEvent(events, input) {
+    const q = String(input || '').trim();
+    const byType = events.filter((e) => e.type === q);
+    if (byType.length === 1)
+        return byType[0];
+    const byName = events.filter((e) => e.name === q);
+    if (byName.length === 1)
+        return byName[0];
+    const avail = events.map((e) => `${e.name}(${e.type})`).join('、');
+    throw new Error(`未知事件「${q}」，可用: ${avail}`);
+}
+/**
+ * 按用户输入找列。分级匹配：字段 id → 完整列名（`主表.订单编号`）→ 裸标签（`订单编号`）→ dataKey。
+ *
+ * **同一级命中多条一律报错并列出候选**，不取首条 —— 两张明细表里各有一个「金额」是常态，
+ * 猜错等于把公式接到别的字段上，而且回读时看不出问题。
+ */
+export function resolveDrivingColumn(columns, input, route = EB_ROUTE) {
+    const q = String(input || '').trim();
+    if (!q)
+        throw new Error('字段名为空');
+    const levels = [
+        ['字段 id', columns.filter((c) => String(c.id) === q)],
+        ['完整列名', columns.filter((c) => String(c.name) === q)],
+        ['裸标签', columns.filter((c) => toBareLabel(c) === q)],
+        ['dataKey', columns.filter((c) => c.dataKey && String(c.dataKey) === q)],
+    ];
+    // **跨级合并候选，不是命中一级就返回**：模块字段的 `name` 本身就是裸标签（`标题` 没有 `主表.` 前缀），
+    // 于是「标题」会在「完整列名」这级撞上模块字段、又在「裸标签」这级撞上同名的业务字段。
+    // 只看首个命中的级别 = 静默挑中模块字段 —— 这正是本函数要防的事。
+    const seen = new Map();
+    const hitLevels = [];
+    for (const [label, hits] of levels) {
+        if (!hits.length)
+            continue;
+        hitLevels.push(label);
+        for (const h of hits)
+            seen.set(String(h.id), h);
+    }
+    const candidates = [...seen.values()];
+    if (candidates.length === 1)
+        return candidates[0];
+    if (candidates.length > 1) {
+        throw new Error(`「${q}」在${hitLevels.join('、')}上匹配到 ${candidates.length} 个字段，请改成唯一写法（字段 id 最稳）：\n${candidates.map((c) => describeColumn(c, route)).join('\n')}`);
+    }
+    throw new Error(`未找到字段「${q}」。可用字段见 e10-cli ${route.columnsHint}`);
+}
+/** 按 id 找列，找不到返回 undefined（update 时读回的触发字段可能已经被删了）。 */
+export function findColumnById(columns, id) {
+    return columns.find((c) => String(c.id) === String(id));
+}
+/**
+ * 能不能作赋值目标。**唯一判据 = 该路由的 `unsupportedTargets`**（这份清单同时就是要发给平台的
+ * `extendParam.unSupportTargets`，读写同一份，不会出现「CLI 放行、报文里却写着不可赋值」的自相矛盾）。
+ *
+ * ⚠ **别用「是不是模块字段」判**：流程表单的模块字段桶 32 项、不可作目标的 30 项，
+ * 「流程标题」「紧急程度」这两个系统字段是**可以**赋值的。
+ */
+export function isAssignableTarget(col, route = EB_ROUTE) {
+    return !route.unsupportedTargets.includes(String(col?.id));
+}
+/** 目标字段不能落在该路由的不可赋值清单里。 */
+export function assertAssignableTarget(col, route = EB_ROUTE) {
+    if (isAssignableTarget(col, route))
+        return;
+    throw new Error(`系统模块字段「${toBareLabel(col)}」不能作为赋值目标（平台不允许）；它可以出现在公式右边或当触发字段。可赋值字段见 ${route.columnsHint}`);
+}
+/**
+ * 非阻断诊断：是系统字段、但既不在不可赋值清单里、也不在已知例外里 —— 说明平台的模块字段桶变了。
+ *
+ * **只提示、不拦**。理由是失败的时机很安全：公式保存发生在联动保存**之前**，放行后若平台真拒，
+ * 是在 `/api/excel/formula/save` 处中止，**此时还没有创建任何联动**，不会留下半条规则。
+ * 而硬拦的代价是无解的 —— 「流程标题」这类字段就是反例，用户没有任何绕法。
+ */
+export function targetDriftWarning(col, route = EB_ROUTE) {
+    if (!isModuleColumn(col, route) && !looksLikeModuleColumn(col))
+        return undefined;
+    if (!isAssignableTarget(col, route))
+        return undefined;
+    if (route.assignableSystemKeys.includes(String(col.id)))
+        return undefined;
+    return `「${toBareLabel(col)}」是系统字段（${col.descType}），但它的 id「${col.id}」不在本路由的不可赋值清单里，已按**可赋值**提交。`
+        + '若平台在保存公式时拒绝，说明清单需要更新（见 form-formula-linkage.ts 的 unsupportedTargets）。';
+}
+/**
+ * 从驱动列里挑出模块字段，喂给 `resolveFormulaRefs` 的 `moduleColumns`。
+ * 判据同时看语义键与形状，这样平台新增模块字段时公式引用也不会报「未找到字段」。
+ */
+export function moduleColumnsOf(columns, route = EB_ROUTE) {
+    return columns
+        .filter((c) => isModuleColumn(c, route) || looksLikeModuleColumn(c))
+        .map((c) => ({ id: String(c.id), name: String(c.name), descType: String(c.descType || 'TEXT') }));
+}
+/** 按「可作目标 / 不可作目标 / 漂移」把驱动列分桶，`columns` 命令用。 */
+export function partitionDrivingColumns(columns, route = EB_ROUTE) {
+    return {
+        assignable: columns.filter((c) => isAssignableTarget(c, route)),
+        unassignable: columns.filter((c) => !isAssignableTarget(c, route)),
+        drifted: columns.filter((c) => targetDriftWarning(c, route) !== undefined),
+    };
+}
+/**
+ * 找表达式里**顶层**的赋值等号，返回下标；-1 表示这压根不是赋值式（用户给的是纯函数体）。
+ *
+ * 要排除比较运算符：`>=` `<=` `!=` `==` `<>`。它们的 `=` 要么前面是 `>` `<` `!`，
+ * 要么紧跟着另一个 `=`，都不算赋值。
+ */
+export function findAssignEquals(expression) {
+    const s = String(expression || '');
+    for (let i = 0; i < s.length; i++) {
+        if (s[i] !== '=')
+            continue;
+        const prev = s[i - 1];
+        const next = s[i + 1];
+        if (prev === '>' || prev === '<' || prev === '!' || prev === '=')
+            continue;
+        if (next === '=')
+            continue;
+        return i;
+    }
+    return -1;
+}
+/**
+ * 拼出下发给平台的赋值式 `{主表.目标}=<右侧>`。
+ *
+ * 用户给的通常只有右侧函数体；但**从设计器里整段复制**的话会带上左侧，所以两种都收：
+ * - 没带左侧 → 拼上 `--target` 指定的目标；
+ * - 带了左侧且与 `--target` 指向同一字段 → 沿用右侧，不重复拼；
+ * - 带了左侧但指向**别的**字段 → 报错。**不静默改目标** —— 用户可能根本不知道自己在改哪条规则。
+ *
+ * @returns `stripped` 为真表示输入本身已是赋值式、左侧被剥掉了。
+ */
+export function buildAssignExpression(targetCol, body) {
+    const raw = String(body || '').trim();
+    if (!raw)
+        throw new Error('表达式为空');
+    const targetRef = `{主表.${toBareLabel(targetCol)}}`;
+    const eq = findAssignEquals(raw);
+    if (eq < 0)
+        return { expression: `${targetRef}=${raw}`, stripped: false };
+    const lhs = raw.slice(0, eq).trim();
+    const rhs = raw.slice(eq + 1).trim();
+    const label = toBareLabel(targetCol);
+    // 左侧只允许是**单个**字段引用；用 refs 反查而不是字符串比对，`{主表.x}` 与 `[x]` 都认
+    const inner = lhs.startsWith('{') || lhs.startsWith('[') ? lhs.slice(1, -1).trim() : lhs;
+    const bare = inner.includes('.') ? inner.slice(inner.indexOf('.') + 1).trim() : inner;
+    if (bare !== label && bare !== String(targetCol.id)) {
+        throw new Error(`表达式里写的是一个赋值式，它的左侧是「${bare}」，与 --target「${label}」不一致。`
+            + '要么把 --target 改成一致，要么只给右侧函数体（不带左侧的赋值式写法）');
+    }
+    return { expression: `${targetRef}=${rhs}`, stripped: true };
+}
+/**
+ * 触发动作。形状是**一个触发字段一条 action**，不是一条 action 里塞多个 `monitorFields`
+ * —— 这是实测的平台形状，多个字段时浏览器就是发多条。
+ *
+ * 表单级事件（`selectColumn: false`，如「载入时」）不需要触发字段，返回空数组。
+ */
+export function buildMonitorActions(event, triggerCols) {
+    if (!event.selectColumn)
+        return [];
+    if (!triggerCols.length) {
+        throw new Error(`事件「${event.name}」需要指定触发字段，请加 --trigger <字段名>（可用字段见 form formula-linkage columns）`);
+    }
+    return triggerCols.map((col) => ({
+        actionType: event.type,
+        actionName: event.name,
+        monitorFields: [{ targetField: String(col.id), targetName: toBareLabel(col) }],
+    }));
+}
+/**
+ * 生效范围。缺省「当前表单」（在所有布局、所有关联了该表单的工作流上都生效）；
+ * 也可以给「表单布局」（只对某个布局生效）。
+ *
+ * 维度的取值由 `resolveEffect`（`services/form-linkage-condition.ts`）解析 —— 显隐联动那条链路
+ * 用的同一套，**别在这里另写一份**：布局维度要的是 `multipleLayoutId` 而不是 `formLayout.id`，
+ * 这两个值在同一张表上相邻但不同，发错不报错、只是指向另一个布局。
+ */
+export function buildFdEffect(formId, effect, effectModule = EB_ROUTE.module) {
+    const e = effect || { effectType: 'form', effectName: '当前表单', effectValue: formId };
+    return {
+        formId,
+        effectModule,
+        effectType: e.effectType,
+        effectName: e.effectName,
+        optionList: [{ effectValue: e.effectValue, effectName: e.optionName || e.effectName }],
+    };
+}
+/**
+ * 从读回的记录里还原当前的生效维度 —— `update` 没给 `--effect` 时用它原样续用。
+ * 读回的 `fdEffect` 是服务端形状（带 `id`/`refId`/`tenantKey`/嵌套 id），这里只挑出那 4 个语义值。
+ */
+export function extractEffect(record) {
+    const e = record?.fdEffect;
+    const opt = (e?.optionList || [])[0];
+    if (!e?.effectType || !opt?.effectValue)
+        return undefined;
+    return {
+        effectType: String(e.effectType),
+        effectName: String(e.effectName || e.effectType),
+        effectValue: String(opt.effectValue),
+        optionName: opt.effectName ? String(opt.effectName) : undefined,
+    };
+}
+/** 明细表的写入方式。函数联动用 `append`（跨表带出那条链路用的是 `override`）。 */
+export function buildLinkageExt(overrides = {}) {
+    return {
+        subFormLikeType: 'addSubForm',
+        subFormAddType: 'append',
+        effectContent: '',
+        fissionState: 1,
+        ...overrides,
+    };
+}
+/**
+ * 建公式的报文。与 `form formula set` 的差别就是 `returnType`/`validateType`（`EqualAssign`）
+ * 与 `extendParam`（`isFdLinkage`）这两处 —— 别把这里当成字段公式发出去。
+ *
+ * `formulaId` 传已有 id 就是**原地更新**那张公式（实测：传了不新建，excelId 不变）。
+ */
+export function buildFormulaSavePayload(p) {
+    const route = p.route || EB_ROUTE;
+    return {
+        expressSql: p.expression,
+        name: p.name,
+        parameters: p.parameters,
+        returnType: 'EqualAssign',
+        validateType: 'EqualAssign',
+        referenceType: 'assign',
+        extendParam: JSON.stringify({ isFdLinkage: true, unSupportTargets: [...route.unsupportedTargets], isSaveAs: false }),
+        formulaId: p.formulaId || null,
+        dataSources: [],
+        formulaType: 'normal',
+        mainDataSource: [null],
+        tempVariableList: [],
+        nameAuto: false,
+        module: route.module,
+        multiFuncSepType: 1,
+    };
+}
+/** 建联动的报文（新建走 `saveFormDataLinkage`）。 */
+export function buildLinkageSavePayload(p) {
+    const route = p.route || EB_ROUTE;
+    return {
+        // 流程表单的报文里 refId 在最前；JSON 键顺序无语义，但这样便于和报文逐字对照
+        ...(route.requiresRefId && p.refId ? { refId: p.refId } : {}),
+        formId: p.formId,
+        fdEffect: buildFdEffect(p.formId, p.effect, route.module),
+        linkageModule: route.module,
+        linkageName: p.linkageName,
+        linkageState: p.linkageState !== false,
+        linkageType: 'excel',
+        linkageExt: p.linkageExt || buildLinkageExt(),
+        monitorActions: p.monitorActions,
+        dataSources: [{
+                menuKey: '1',
+                sourceName: '公式配置1',
+                linkageType: 'excel',
+                dataMappings: [],
+                sourceExcel: { excelId: p.excelId, excelName: p.excelName },
+            }],
+        needSqlCompress: 1,
+        customParam: route.customParam({ appId: p.appId, objId: p.objId }),
+    };
+}
+/** 从读回的记录里还原当前的「事件 + 触发字段」，给 `update` 当默认值用。 */
+export function extractTriggerState(record) {
+    const actions = record?.monitorActions || [];
+    return {
+        eventType: String(actions[0]?.actionType || ''),
+        triggerIds: actions
+            .flatMap((a) => (a.monitorFields || []).map((m) => String(m.targetField || '')))
+            .filter(Boolean),
+    };
+}
+/**
+ * 改联动的报文（走 `updateFormDataLinkage`）—— 形状 = 新建报文 + `id`，
+ * 但 `dataSources` 要换成**读回的那份**（带上 `id`/`entityId`/`inFields`/`outFields`），
+ * 否则平台会当成新建一个数据源。
+ *
+ * 两处**不能照抄读回值**，得重建：
+ * - `fdEffect`：读回的是服务端形状（一堆嵌套 id、`refId`、`tenantKey`），下发要的是干净的 5 个键
+ * - `linkageExt`：同理，只要那 4 个业务键
+ * - `customParam`：读回里压根没有，得从调用方参数补
+ */
+export function buildLinkageUpdatePayload(record, p) {
+    const linkExt = record?.linkageExt || {};
+    // 读回的 dataSources 原样回传，只剥掉 sourceExcel.data（那是公式全文，读侧派生的）
+    const dataSources = (record?.dataSources || []).map((ds) => {
+        const { sourceExcel, ...dsRest } = ds;
+        if (!sourceExcel)
+            return dsRest;
+        const { data, ...excelRest } = sourceExcel;
+        return { ...dsRest, sourceExcel: excelRest };
+    });
+    return {
+        id: String(record?.id ?? ''),
+        ...buildLinkageSavePayload({
+            formId: String(record?.formId ?? ''),
+            appId: p.appId,
+            objId: p.objId,
+            linkageName: p.linkageName,
+            excelId: '',
+            excelName: '',
+            monitorActions: p.monitorActions,
+            linkageState: p.linkageState,
+            effect: p.effect,
+            route: p.route,
+            refId: String(p.refId ?? record?.refId ?? ''),
+            linkageExt: buildLinkageExt({
+                subFormLikeType: linkExt.subFormLikeType,
+                subFormAddType: linkExt.subFormAddType,
+                effectContent: linkExt.effectContent,
+                fissionState: linkExt.fissionState,
+            }),
+        }),
+        dataSources,
+    };
+}
+/** 本地时间 `yyyy-MM-dd HH:mm:ss`。平台的联动名用的是这个格式，不是 ISO。 */
+export function formatLocalTimestamp(d) {
+    const p = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}`;
+}
+/** 联动的默认名，与设计器里生成的一致：`<公式名> - 公式_<时间戳>`。 */
+export function buildFormulaLinkageName(excelName, at) {
+    return `${excelName} - 公式_${formatLocalTimestamp(at)}`;
+}
+/**
+ * 把列表/详情记录压成一份统一形状 —— 列表与详情**都能用**：
+ * `fullPageQueryByFormId` 的 `sourceExcel` 不带 `data`（没有公式正文），
+ * 所以那边的 `expression` 会是空串，这是正常的。
+ */
+export function summarizeLinkage(record) {
+    const ds = (record?.dataSources || [])[0] || {};
+    const src = ds.sourceExcel || {};
+    const formula = src.data || {};
+    const actions = record?.monitorActions || [];
+    return {
+        id: String(record?.id ?? ''),
+        name: String(record?.linkageName ?? ''),
+        state: record?.linkageState !== false,
+        type: String(record?.linkageType ?? ''),
+        effect: extractEffect(record),
+        eventNames: [...new Set(actions.map((a) => String(a.actionName || a.actionType || '')))],
+        triggerIds: actions.flatMap((a) => (a.monitorFields || []).map((m) => String(m.targetField || ''))),
+        triggerNames: actions.map((a) => (a.monitorFields || []).map((m) => String(m.targetName || m.targetField || '')).join(',')).filter(Boolean),
+        excelId: String(src.excelId ?? ''),
+        excelName: String(src.excelName ?? ''),
+        expression: String(formula.formula || ''),
+        parameters: formula.parameters || [],
+    };
+}
+//# sourceMappingURL=form-formula-linkage.js.map

package/dist/services/form-formula-linkage.js.map

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

package/dist/services/form-layout-insert.d.ts

@@ -0,0 +1,84 @@
+import type { ApiClient } from '../core/client.js';
+export interface CompPair {
+    label: any;
+    value: any;
+}
+export interface BuildCompPairInput {
+    /** 现有布局的平铺 comp 数组（`pageLayouts[].comps`）。 */
+    comps: any[];
+    /** 新字段的 fieldId（= 值组件的 `config.fieldId` 与 `associatedId`）。 */
+    fieldId: string;
+    /** 新字段标签组件的 `config.fieldId`（平台分配，与字段定义无关，只需布局内唯一）。 */
+    labelFieldId: string;
+    /** 字段标题，写进两个 comp 的 `config.title`。 */
+    title: string;
+    /** 字段定义（`getFormFieldPage` 的记录），用来覆盖抄来的字段定义那一半。 */
+    fieldDef: Record<string, any>;
+    /** 明细字段：明细表的 subFormId。不给就是主表字段。 */
+    subFormId?: string;
+}
+export type BuildOutcome = ({
+    ok: true;
+} & CompPair) | {
+    ok: false;
+    error: string;
+};
+/**
+ * 把新字段的 comp 对构造出来（纯函数，不碰网络）。
+ *
+ * 位置按「同作用域里最大行 + 1」追加 —— 与设计器里手工拖到末尾的落点一致。
+ * 列沿用模板自己的列，这样单选/两列/多列布局都不用另外判断。
+ * 明细表容器**不参与行号计算**：它在顶层作用域里，但行号是自己的（常被摆在字段下面老远），
+ * 算进去会让新字段凭空多跳几行。
+ */
+export declare function buildCompPair(input: BuildCompPairInput): BuildOutcome;
+export interface InsertFieldInput extends Omit<BuildCompPairInput, 'comps'> {
+    /** 顺带改这些布局层属性（`form add-field` 的 --single-row 等）。 */
+    overrides?: Record<string, any>;
+}
+/**
+ * 读快照 → 存回，中间交给 `mutate` 改。**不碰 initLayout**。
+ *
+ * 抽出来是因为读存之间有几个不看代码想不到的约束，只该有一份实现：
+ * - 读和存之间**不能插别的写操作**：平台按 `updateTimeStamp` 做乐观锁，中途被改过就回
+ *   「当前页面不是最新数据，请刷新页面后编辑保存」。所以整段必须一口气跑完。
+ * - `formLayout` 里必须带 `formId`，否则平台在 `Form.getTenantKey()` 上直接 NPE，
+ *   报的是一句和表单八竿子打不着的 `"form" is null`。
+ * - `pageLayoutEncodes` / `formStyleEncodes` 是读侧的派生字段，回写前要删掉。
+ *
+ * `mutate` 拿到 pageLayouts 就地改；返回它想报告的任意信息。
+ */
+export declare function mutateLayout<T>(client: ApiClient, baseUrl: string, formId: string, mutate: (pageLayouts: any[], snapshot: any) => T): Promise<T>;
+/**
+ * 在布局里找某字段的值组件（跳过标签组件）。
+ *
+ * 认 **`config.associatedId`**，不是 `config.fieldId` —— 标签的 `config.fieldId` 是布局
+ * 自己另生成的，与字段定义没有对应关系（详见 `form-layout-comp-mapping` 那份结论）。
+ */
+export declare function findValueComp(comps: any[], fieldId: string): any | null;
+/**
+ * 给某字段的布局层属性打补丁（读 → 改 → 存一次完成）。
+ *
+ * `required` / `readOnly` / `display` / `singleRow` 这些**只存在于布局 comp 里**，
+ * 字段记录里没有对应的键（`getFormFieldPage` 的 53 个字段记录里都没有 `required`）。
+ * 所以「改字段属性」时只写字段记录等于什么都没做 —— 接口回 200、命令报成功、行为不变。
+ */
+export declare function patchFieldLayout(client: ApiClient, baseUrl: string, formId: string, fieldId: string, patch: Record<string, any>): Promise<{
+    updated: number;
+}>;
+export interface InsertFieldResult {
+    row: number;
+    col: number;
+    labelCompId: string;
+    valueCompId: string;
+    /** 兜底提示（不阻断）。 */
+    warnings: string[];
+}
+/**
+ * 造 comp 对 → 插进去 → 存回。**不碰 initLayout**。
+ *
+ * 读快照与存回的约束见 `mutateLayout`（乐观锁、`formLayout.formId`、派生字段）。
+ * comp 对必须在回调里当场构造 —— 位置依赖刚刚读到的 comps，不能拿旧快照算。
+ */
+export declare function insertFieldIntoLayout(client: ApiClient, baseUrl: string, formId: string, input: InsertFieldInput): Promise<InsertFieldResult>;
+//# sourceMappingURL=form-layout-insert.d.ts.map