weaver-e10-builder 1.2.2 → 1.2.3

package/dist/services/formula-detail.js

@@ -1,66 +1,132 @@
+/**
+ * 扫出表达式里的全部字段引用，**两种写法都认**：
+ * - `{主表.字段名}` / `{明细表名.字段名}` —— 平台存储格式
+ * - `[字段名]` / `[表名.字段名]` —— 设计器编辑器的写法
+ *
+ * 重复出现**不去重** —— 每个出现位置都要单独一个参数（见文件头说明）。
+ * 不做字符串字面量剔除：公式里写 `"["` 这种极端情况不在支持范围，误判会在解析阶段
+ * 报「未找到字段」，比静默错绑安全。
+ */
+export function parseFormulaRefs(expression) {
+    const refs = [];
+    const re = /\{([^{}]+)\}|\[([^\[\]]+)\]/g;
+    let m;
+    while ((m = re.exec(expression)) !== null) {
+        const inner = (m[1] ?? m[2] ?? '').trim();
+        if (!inner)
+            continue;
+        const dot = inner.indexOf('.');
+        const hasTable = dot > 0 && dot < inner.length - 1;
+        refs.push({
+            table: hasTable ? inner.slice(0, dot).trim() : null,
+            field: (hasTable ? inner.slice(dot + 1) : inner).trim(),
+            raw: m[0],
+            index: m.index,
+            length: m[0].length,
+        });
+    }
+    return refs;
+}
+/**
+ * 按目标字段的类型给出合适的公式返回类型。
+ *
+ * 此前 fields.json 里 `formula` 写成字符串时**一律按 `Number` 提交**，
+ * 于是「给单行文本挂公式」必然被平台拒（「公式计算结果必须为: 数字」）——
+ * 报错说的是真话：我们替用户要了个数字。
+ */
+export function defaultReturnType(fieldKey) {
+    const k = String(fieldKey || '');
+    if (/^(Number|Money|Percentage)/.test(k))
+        return 'Number';
+    if (/^(Date|DateTime|Time)/.test(k))
+        return 'Date';
+    return 'String';
+}
 export async function buildFormulaParameters(client, baseUrl, objId, appId, formId, expression) {
     const errors = [];
+    const warnings = [];
     const parameters = [];
     const refNames = [];
-    // 1. 解析 {主表.x} 或 {明细表名.x}
-    const refRegex = /\{(?:主表|([^.}]+))\.([^}]+)\}/g;
-    const refs = [];
-    let m;
-    while ((m = refRegex.exec(expression)) !== null) {
-        const table = m[1] ? m[1].trim() : '主表';
-        const field = m[2].trim();
-        if (!refs.some((r) => r.table === table && r.field === field))
-            refs.push({ table, field });
-    }
+    const refs = parseFormulaRefs(expression);
     if (refs.length === 0) {
-        errors.push('表达式中未找到 {主表.字段名} 或 {明细表名.字段名} 引用');
-        return { parameters, refNames, errors };
+        // 纯常量公式（如 CONCAT("甲","乙")）平台**接受**，实测保存成功且参数为空。
+        // 早期版本在这里直接报错退出，把「平台允许的用法」当成非法输入拦掉了。
+        warnings.push('表达式中没有字段引用（纯常量公式）。平台允许这种写法，将按原样保存。');
     }
-    // 2. getEbField 取主表 + 明细结构
-    const mainFields = [];
-    const detailTables = [];
+    // getEbField 取主表 + 明细结构（主表字段用于反查不带表名的 `[字段]`）
+    let mainFields = [];
+    let detailTables = [];
     try {
         const eb = await client.post(`${baseUrl}/api/bs/esb/setting/component/getEbField`, { tableId: objId, appId });
-        mainFields.push(...(eb?.data?.main || []));
-        detailTables.push(...(eb?.data?.detail || []));
+        mainFields = eb?.data?.main || [];
+        detailTables = eb?.data?.detail || [];
     }
     catch { /* 拉取失败由解析报错兜底 */ }
     const mainFind = (name) => mainFields.find((f) => String(f.id) === name || f.showName === name || f.dataKey === name);
+    const detailOf = (table) => detailTables.find((d) => d.tableName === table || String(d.detailTableId) === table);
+    const fieldIn = (dt, name) => (dt?.fields || []).find((x) => String(x.id) === name || x.showName === name || x.dataKey === name);
+    /** 归一化：把每个引用改写成 `{表.字段}`。反查不到时保留原文（后续会报错）。 */
+    const pieces = [];
+    let cursor = 0;
     for (const ref of refs) {
-        refNames.push(`${ref.table}.${ref.field}`);
-        if (ref.table === '主表') {
-            const f = mainFind(ref.field);
-            if (!f) {
-                errors.push(`未找到主表字段: "${ref.field}"，可用: ${mainFields.map((x) => x.showName).join(', ')}`);
-                continue;
+        let table = ref.table;
+        let resolved;
+        if (table === '主表' || table === null) {
+            resolved = mainFind(ref.field);
+            if (!resolved && table === null) {
+                // 不带表名的 `[字段]`：主表没有就找明细表
+                const owners = detailTables.filter((d) => fieldIn(d, ref.field));
+                if (owners.length > 1) {
+                    errors.push(`字段「${ref.field}」在多个明细表中存在（${owners.map((d) => d.tableName).join('、')}），请写成 [明细表名.${ref.field}] 指明是哪个`);
+                    continue;
+                }
+                if (owners.length === 1) {
+                    table = owners[0].tableName;
+                    resolved = fieldIn(owners[0], ref.field);
+                }
+            }
+            if (resolved && (table === null || table === '主表')) {
+                table = '主表';
             }
-            parameters.push({
-                dataTemplateId: '', fieldId: String(f.id), formId, module: 'ebuilderform',
-                properKey: f.componentKey || 'Text',
-                title: f.showName || ref.field, name: f.showName || ref.field,
-                appId, id: null,
-            });
         }
         else {
-            const dt = detailTables.find((d) => d.tableName === ref.table);
+            const dt = detailOf(table);
             if (!dt) {
-                errors.push(`未找到明细表: "${ref.table}"，可用: ${detailTables.map((d) => d.tableName).join(', ')}`);
+                errors.push(`未找到明细表: "${table}"，可用: ${detailTables.map((d) => d.tableName).join(', ')}`);
                 continue;
             }
-            const f = (dt.fields || []).find((x) => String(x.id) === ref.field || x.showName === ref.field || x.dataKey === ref.field);
-            if (!f) {
-                errors.push(`明细表「${ref.table}」中未找到字段: "${ref.field}"，可用: ${(dt.fields || []).map((x) => x.showName).join(', ')}`);
-                continue;
-            }
-            parameters.push({
-                dataTemplateId: '', fieldId: String(f.id), formId, module: 'ebuilderform',
-                properKey: f.componentKey || 'Text',
-                sFormId: String(dt.detailTableId), sFormName: dt.tableName,
-                title: f.showName || ref.field, name: f.showName || ref.field,
-                appId, id: null,
-            });
+            resolved = fieldIn(dt, ref.field);
+            table = dt.tableName;
+        }
+        if (!resolved) {
+            const where = ref.table === '主表' ? '主表' : ref.table ? `明细表「${ref.table}」` : '主表或任一明细表';
+            const avail = ref.table && ref.table !== '主表'
+                ? (detailOf(ref.table)?.fields || []).map((x) => x.showName).join(', ')
+                : mainFields.map((x) => x.showName).join(', ');
+            errors.push(`在${where}中未找到字段: "${ref.field}"，可用: ${avail}`);
+            continue;
         }
+        // 走到这里 table 必然已定型：要么 '主表'，要么是某个明细表名（带表名的引用校验过、不带表名的已反查过）
+        const tableName = table;
+        const isDetail = tableName !== '主表';
+        const dt = isDetail ? detailOf(tableName) : null;
+        parameters.push({
+            dataTemplateId: '', fieldId: String(resolved.id), formId, module: 'ebuilderform',
+            properKey: resolved.componentKey || resolved.fieldKey || 'Text',
+            ...(dt ? { sFormId: String(dt.detailTableId), sFormName: dt.tableName } : {}),
+            title: resolved.showName || resolved.title || ref.field,
+            name: resolved.showName || resolved.field || ref.field,
+            appId, id: null,
+        });
+        refNames.push(`${table}.${ref.field}`);
+        pieces.push(expression.slice(cursor, ref.index));
+        pieces.push(`{${table}.${ref.field}}`);
+        cursor = ref.index + ref.length;
     }
-    return { parameters, refNames, errors };
+    pieces.push(expression.slice(cursor));
+    return {
+        parameters, refNames, errors, warnings,
+        normalizedExpression: errors.length ? expression : pieces.join(''),
+    };
 }
 //# sourceMappingURL=formula-detail.js.map

package/dist/services/formula-detail.js.map

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

@@ -0,0 +1,114 @@
+import type { ApiClient } from '../core/client.js';
+/** 目标节点选择范围 */
+export declare const RANGE_TYPES: Record<string, string>;
+export declare const RANGE_TYPE_LABELS: Record<string, string>;
+/** 按出口时，可选出口范围 */
+export declare const NODE_RANGE_TYPES: Record<string, string>;
+export declare const NODE_RANGE_TYPE_LABELS: Record<string, string>;
+/** 自动流转 */
+export declare const AUTO_FLOW_TYPES: Record<string, string>;
+export declare const AUTO_FLOW_TYPE_LABELS: Record<string, string>;
+/** 会签关系（新字段，页面以它为准） */
+export declare const SIGN_RELATION_TYPES: Record<string, string>;
+export declare const SIGN_RELATION_LABELS: Record<string, string>;
+/** 抄送方式 */
+export declare const CC_TYPES: Record<string, string>;
+export declare const CC_TYPE_LABELS: Record<string, string>;
+/** 节点类型里真正能配指定流转的（排除结束节点与分流/合流点） */
+export declare const ASSIGN_FLOW_NODE_TYPES: Set<string>;
+export interface AssignFlowSettings {
+    enable: boolean;
+    rangeType: string;
+    /** 逗号分隔的节点 ID；空串表示未指定 */
+    nodeBrowser: string;
+    nodeRangeType: string;
+    autoFirstNode: boolean;
+    forbidModifyTargetNode: boolean;
+    enableNodeAlone: boolean;
+    enableOpenDialog: boolean;
+    enableComments: boolean;
+    alwaysShowComments: boolean;
+    enableAutoFlow: string;
+    /** 逗号分隔的节点 ID；空串表示未指定 */
+    mustMultiNode: string;
+    useCommonDestination: boolean;
+    modifyOperator: boolean;
+    autoOperator: boolean;
+    signRelationship: string;
+    signRelationshipNew: string;
+    /** `['1']` 开启单选 / `[]` 关闭 */
+    singleOperator: string[];
+    useCc: boolean;
+    autoCcOperator: boolean;
+    modifyCcOperator: boolean;
+    ccType: string;
+    /** 标量 `0/1` */
+    ccRequired: string;
+    defaultCcType: string;
+    autoFlowSignType: string;
+    autoFlowCCType: string;
+}
+/** 合并两份 Form 的 data，并按写入要求归一形状 */
+export declare function normalizeSettings(baseData: any, commonData: any): AssignFlowSettings;
+export declare function getAssignFlowSettings(client: ApiClient, baseUrl: string, workflowId: string, nodeId: string): Promise<AssignFlowSettings>;
+/** 归一后的设置 → 保存报文。基础与通用合并成一个 JSON。 */
+export declare function buildSavePayload(workflowId: string, nodeId: string, s: AssignFlowSettings): Record<string, unknown>;
+/**
+ * 清掉当前取值下不再适用的字段。
+ *
+ * 只清 `nodeBrowser` —— 范围类型不是「指定节点范围」时**平台自己也会把它清成空**
+ * （实测：发 rangeType=0 + 残留节点清单，平台收下、回读是空串）。我们跟上这一步，
+ * 否则本地以为写的是 A、回读是 B，保存后的回读比对会误报。
+ *
+ * `mustMultiNode` **不清**：实测平台会原样保留，浏览器也一样 —— 页面报文里
+ * `enableAutoFlow` 是 `"0"`、`mustMultiNode` 却带着值。用户临时关掉自动流转再打开，
+ * 必经节点还得在。这里"顺手清掉"等于悄悄吃掉配置。
+ */
+export declare function coerceSettings(s: AssignFlowSettings): AssignFlowSettings;
+/** 提交前的组合校验。返回错误文案数组（空 = 通过）。 */
+export declare function validateSettings(s: AssignFlowSettings): string[];
+/** 保存。返回**实际写出去的**设置（已按取值归一），调用方拿它做回读比对。 */
+export declare function saveAssignFlowSettings(client: ApiClient, baseUrl: string, workflowId: string, nodeId: string, raw: AssignFlowSettings): Promise<AssignFlowSettings>;
+/** 保存后回读比对，返回不一致的字段说明。 */
+export declare function diffSettings(before: AssignFlowSettings, after: AssignFlowSettings): string[];
+export interface AssignTargetNode {
+    /** 独立设置记录的稳定 ID（改已有目标节点时用它，不要重复新增） */
+    id: string;
+    targetNodeId: string;
+    targetNodeName: string;
+    receiverRangeKey: string;
+    raw: Record<string, any>;
+}
+export declare function listAssignTargetNodes(client: ApiClient, baseUrl: string, workflowId: string, nodeId: string): Promise<AssignTargetNode[]>;
+/** 新增目标节点独立设置。已存在的目标节点会被跳过（不重复新增）。 */
+export declare function addAssignTargetNodes(client: ApiClient, baseUrl: string, workflowId: string, nodeId: string, targetNodeIds: string[]): Promise<{
+    added: string[];
+    skipped: string[];
+}>;
+export interface ReceiverRange {
+    mainId: string;
+    isopen: boolean;
+    modetype: string;
+    limitOperatorRange: boolean;
+    enableSecurityLevel: boolean;
+    isUpgrade: boolean;
+}
+export declare function normalizeReceiverRange(data: any): ReceiverRange;
+/**
+ * 读指定流转目标节点的接收范围。
+ *
+ * `mainId` 优先用调用方给的 `receiverRangeKey`（目标节点列表里回读到的稳定值）；
+ * 它是 `"0"` 或空时说明这条记录还没有自己的范围设置，再按 scene=7 现读一份。
+ */
+export declare function getReceiverRange(client: ApiClient, baseUrl: string, workflowId: string, nodeId: string): Promise<ReceiverRange>;
+export declare function saveReceiverRange(client: ApiClient, baseUrl: string, workflowId: string, nodeId: string, r: ReceiverRange): Promise<void>;
+export interface WorkflowNodeRef {
+    id: string;
+    name: string;
+    nodeType: string;
+}
+/** 取全流程节点（含类型），供 --all-nodes 用。 */
+export declare function listWorkflowNodes(client: ApiClient, baseUrl: string, workflowId: string): Promise<WorkflowNodeRef[]>;
+/** 能配指定流转的节点（排除结束节点、分流/合流点） */
+export declare function assignFlowCapableNodes(nodes: WorkflowNodeRef[]): WorkflowNodeRef[];
+//# sourceMappingURL=workflow-assign-flow.d.ts.map

package/dist/services/workflow-assign-flow.d.ts.map

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