weaver-e10-builder 1.1.9 → 1.2.3

package/dist/services/workflow-assign-flow.js

@@ -0,0 +1,311 @@
+/**
+ * 节点指定流转（工作流术语：开一窗流转）。
+ *
+ * 页面在「基础设置」和「目标节点通用设置」两个页签，各有一份动态 Form；
+ * **保存时必须合并成一个 JSON** 发 `assignFlow/saveBaseSetForm`，分两次发会互相覆盖。
+ *
+ * 这里最大的坑是**读写形状不对称**（2026-09-22 对 eteams 逐项二分出来的）：
+ *
+ * | 字段 | GET 回读形状 | 写入要求 |
+ * |---|---|---|
+ * | `nodeBrowser` / `mustMultiNode` | 对象数组 `[{id,dataId,content,…}]` | **逗号分隔字符串**，写数组直接 500 |
+ * | `ccRequired` | 数组 `["0"]` | **标量** `0/1`，写数组直接 500 |
+ * | `singleOperator` | 数组 `["0"]` | **数组**（`["1"]` 开 / `[]` 关）—— 这个两个方向都是数组 |
+ *
+ * 所以「读回来原样写回去」在这三个字段上必挂。读回后必须按上表归一。
+ */
+const BASE = '/api/bs/workflow/pathdef';
+/** 目标节点选择范围 */
+export const RANGE_TYPES = {
+    out: '0', // 按出口选择
+    free: '1', // 自由选择
+    nodes: '2', // 指定节点范围
+};
+export const RANGE_TYPE_LABELS = {
+    '0': '按出口选择', '1': '自由选择', '2': '指定节点范围',
+};
+/** 按出口时，可选出口范围 */
+export const NODE_RANGE_TYPES = {
+    all: '0', // 所有出口
+    condition: '1', // 满足条件的出口
+};
+export const NODE_RANGE_TYPE_LABELS = {
+    '0': '所有出口', '1': '满足条件的出口',
+};
+/** 自动流转 */
+export const AUTO_FLOW_TYPES = {
+    none: '0', // 不启用
+    must: '1', // 自动流转至必经节点
+    first: '2', // 自动流转至第一个满足出口条件的节点
+};
+export const AUTO_FLOW_TYPE_LABELS = {
+    '0': '不启用', '1': '自动流转至必经节点', '2': '自动流转至第一个满足出口条件的节点',
+};
+/** 会签关系（新字段，页面以它为准） */
+export const SIGN_RELATION_TYPES = {
+    user: '0', // 用户选择
+    countersign: '1', // 会签
+    non: '2', // 非会签
+    order: '3', // 依次
+    node: '4', // 节点设置
+    parallel: '5', // 并行分流
+};
+export const SIGN_RELATION_LABELS = {
+    '0': '用户选择', '1': '会签', '2': '非会签', '3': '依次', '4': '节点设置', '5': '并行分流',
+};
+/** 抄送方式 */
+export const CC_TYPES = {
+    user: '0', // 用户选择
+    off: '1', // 不启用
+    submit: '2', // 需提交
+    auto: '3', // 不需提交
+};
+export const CC_TYPE_LABELS = {
+    '0': '用户选择', '1': '不启用', '2': '需提交', '3': '不需提交',
+};
+/** 节点类型里真正能配指定流转的（排除结束节点与分流/合流点） */
+export const ASSIGN_FLOW_NODE_TYPES = new Set(['0', '1', '2', '5', '7', '8']);
+/** 浏览器节点对象 / 数组 → 逗号分隔 ID 串 */
+function toIdList(value) {
+    if (typeof value === 'string')
+        return value;
+    if (!Array.isArray(value))
+        return '';
+    return value
+        .map((v) => String(v?.id ?? v?.dataId ?? v ?? ''))
+        .filter(Boolean)
+        .join(',');
+}
+/** 数组取首元素；别的原样 */
+function toScalar(value) {
+    if (Array.isArray(value))
+        return String(value[0] ?? '0');
+    if (value === undefined || value === null)
+        return '0';
+    return String(value);
+}
+const asBool = (v) => v === true || v === 1 || v === '1';
+/** 合并两份 Form 的 data，并按写入要求归一形状 */
+export function normalizeSettings(baseData, commonData) {
+    const b = baseData || {};
+    const c = commonData || {};
+    return {
+        enable: asBool(b.enable),
+        rangeType: String(b.rangeType ?? '0'),
+        nodeBrowser: toIdList(b.nodeBrowser),
+        nodeRangeType: String(b.nodeRangeType ?? '0'),
+        autoFirstNode: asBool(b.autoFirstNode),
+        forbidModifyTargetNode: asBool(b.forbidModifyTargetNode),
+        enableNodeAlone: asBool(b.enableNodeAlone),
+        enableOpenDialog: asBool(b.enableOpenDialog),
+        enableComments: asBool(b.enableComments),
+        alwaysShowComments: asBool(b.alwaysShowComments),
+        enableAutoFlow: String(b.enableAutoFlow ?? '0'),
+        mustMultiNode: toIdList(b.mustMultiNode),
+        useCommonDestination: asBool(b.useCommonDestination),
+        modifyOperator: asBool(c.modifyOperator),
+        autoOperator: asBool(c.autoOperator),
+        signRelationship: String(c.signRelationship ?? '0'),
+        signRelationshipNew: String(c.signRelationshipNew ?? '0'),
+        singleOperator: Array.isArray(c.singleOperator) ? c.singleOperator.map(String) : [],
+        useCc: asBool(c.useCc),
+        autoCcOperator: asBool(c.autoCcOperator),
+        modifyCcOperator: asBool(c.modifyCcOperator),
+        ccType: String(c.ccType ?? '0'),
+        ccRequired: toScalar(c.ccRequired),
+        defaultCcType: String(c.defaultCcType ?? '2'),
+        autoFlowSignType: String(c.autoFlowSignType ?? '4'),
+        autoFlowCCType: String(c.autoFlowCCType ?? '4'),
+    };
+}
+export async function getAssignFlowSettings(client, baseUrl, workflowId, nodeId) {
+    const [b, c] = await Promise.all([
+        client.get(`${baseUrl}${BASE}/assignFlow/getBaseSetForm?workflowId=${workflowId}&nodeId=${nodeId}`),
+        client.get(`${baseUrl}${BASE}/assignFlow/getCommonSetForm?workflowId=${workflowId}&nodeId=${nodeId}`),
+    ]);
+    if (b?.code !== 200 || !b?.status)
+        throw new Error(`读取指定流转基础设置失败: ${b?.msg || '未知错误'}`);
+    if (c?.code !== 200 || !c?.status)
+        throw new Error(`读取指定流转通用设置失败: ${c?.msg || '未知错误'}`);
+    return normalizeSettings(b?.data?.data, c?.data?.data);
+}
+/** 归一后的设置 → 保存报文。基础与通用合并成一个 JSON。 */
+export function buildSavePayload(workflowId, nodeId, s) {
+    return {
+        workflowId, nodeId,
+        enable: s.enable,
+        rangeType: s.rangeType,
+        nodeBrowser: s.nodeBrowser,
+        nodeRangeType: s.nodeRangeType,
+        autoFirstNode: s.autoFirstNode,
+        forbidModifyTargetNode: s.forbidModifyTargetNode,
+        enableNodeAlone: s.enableNodeAlone,
+        enableOpenDialog: s.enableOpenDialog,
+        enableComments: s.enableComments,
+        alwaysShowComments: s.alwaysShowComments,
+        enableAutoFlow: s.enableAutoFlow,
+        mustMultiNode: s.mustMultiNode,
+        useCommonDestination: s.useCommonDestination,
+        modifyOperator: s.modifyOperator,
+        autoOperator: s.autoOperator,
+        signRelationship: s.signRelationship,
+        signRelationshipNew: s.signRelationshipNew,
+        singleOperator: s.singleOperator,
+        useCc: s.useCc,
+        autoCcOperator: s.autoCcOperator,
+        modifyCcOperator: s.modifyCcOperator,
+        ccType: s.ccType,
+        ccRequired: s.ccRequired,
+        defaultCcType: s.defaultCcType,
+        autoFlowSignType: s.autoFlowSignType,
+        autoFlowCCType: s.autoFlowCCType,
+        isChanged: true,
+        isSync: false,
+    };
+}
+/**
+ * 清掉当前取值下不再适用的字段。
+ *
+ * 只清 `nodeBrowser` —— 范围类型不是「指定节点范围」时**平台自己也会把它清成空**
+ * （实测：发 rangeType=0 + 残留节点清单，平台收下、回读是空串）。我们跟上这一步，
+ * 否则本地以为写的是 A、回读是 B，保存后的回读比对会误报。
+ *
+ * `mustMultiNode` **不清**：实测平台会原样保留，浏览器也一样 —— 页面报文里
+ * `enableAutoFlow` 是 `"0"`、`mustMultiNode` 却带着值。用户临时关掉自动流转再打开，
+ * 必经节点还得在。这里"顺手清掉"等于悄悄吃掉配置。
+ */
+export function coerceSettings(s) {
+    return { ...s, nodeBrowser: s.rangeType === '2' ? s.nodeBrowser : '' };
+}
+/** 提交前的组合校验。返回错误文案数组（空 = 通过）。 */
+export function validateSettings(s) {
+    const errors = [];
+    if (s.rangeType === '2' && !s.nodeBrowser) {
+        errors.push('目标节点选择范围为「指定节点范围」时必须给 --nodes 指定至少一个节点');
+    }
+    if (s.enableAutoFlow === '1' && !s.mustMultiNode) {
+        errors.push('自动流转为「自动流转至必经节点」时必须给 --must-nodes 指定至少一个节点');
+    }
+    if (!(s.rangeType in RANGE_TYPE_LABELS))
+        errors.push(`未知的目标节点选择范围: ${s.rangeType}`);
+    if (!(s.nodeRangeType in NODE_RANGE_TYPE_LABELS))
+        errors.push(`未知的出口范围: ${s.nodeRangeType}`);
+    if (!(s.enableAutoFlow in AUTO_FLOW_TYPE_LABELS))
+        errors.push(`未知的自动流转类型: ${s.enableAutoFlow}`);
+    if (!(s.signRelationshipNew in SIGN_RELATION_LABELS))
+        errors.push(`未知的会签关系: ${s.signRelationshipNew}`);
+    if (!(s.ccType in CC_TYPE_LABELS))
+        errors.push(`未知的抄送方式: ${s.ccType}`);
+    return errors;
+}
+/** 保存。返回**实际写出去的**设置（已按取值归一），调用方拿它做回读比对。 */
+export async function saveAssignFlowSettings(client, baseUrl, workflowId, nodeId, raw) {
+    const s = coerceSettings(raw);
+    const errors = validateSettings(s);
+    if (errors.length)
+        throw new Error(errors.join('；'));
+    const res = await client.post(`${baseUrl}${BASE}/assignFlow/saveBaseSetForm`, buildSavePayload(workflowId, nodeId, s));
+    if (res?.code !== 200 || res?.status === false || res?.data === false) {
+        throw new Error(`保存指定流转设置失败: ${res?.msg || '未知错误'}`);
+    }
+    return s;
+}
+/** 保存后回读比对，返回不一致的字段说明。 */
+export function diffSettings(before, after) {
+    const out = [];
+    for (const key of Object.keys(before)) {
+        const a = before[key];
+        const b = after[key];
+        const same = Array.isArray(a) ? JSON.stringify(a) === JSON.stringify(b) : a === b;
+        if (!same)
+            out.push(`${key}: 期望 ${JSON.stringify(a)}，回读 ${JSON.stringify(b)}`);
+    }
+    return out;
+}
+export async function listAssignTargetNodes(client, baseUrl, workflowId, nodeId) {
+    const res = await client.get(`${baseUrl}${BASE}/assignFlow/getTargetNodeList?workflowId=${workflowId}&nodeId=${nodeId}&current=1&pageSize=200`);
+    if (res?.code !== 200 || !res?.status)
+        throw new Error(`读取指定流转目标节点失败: ${res?.msg || '未知错误'}`);
+    const rows = res?.data?.datas || [];
+    return rows.map((r) => ({
+        id: String(r.id ?? ''),
+        targetNodeId: String(r.targetNodeId ?? ''),
+        targetNodeName: String(r.targetNodeName ?? ''),
+        receiverRangeKey: String(r.receiverRangeKey ?? ''),
+        raw: r,
+    }));
+}
+/** 新增目标节点独立设置。已存在的目标节点会被跳过（不重复新增）。 */
+export async function addAssignTargetNodes(client, baseUrl, workflowId, nodeId, targetNodeIds) {
+    const existing = await listAssignTargetNodes(client, baseUrl, workflowId, nodeId);
+    const have = new Set(existing.map((t) => t.targetNodeId));
+    const added = targetNodeIds.map(String).filter((id) => !have.has(id));
+    const skipped = targetNodeIds.map(String).filter((id) => have.has(id));
+    if (!added.length)
+        return { added, skipped };
+    const res = await client.post(`${baseUrl}${BASE}/assignFlow/batchAddTargetNodeSet`, {
+        workflowId, nodeId, targetNodeIds: added.join(','),
+        modifyOperator: true, autoOperator: true,
+        signRelationship: 0, signRelationshipNew: 0, singleOperator: false,
+        useCc: true, autoCcOperator: true, modifyCcOperator: true,
+        ccType: 0, ccRequired: 0, defaultCcType: 2, autoFlowSignType: 4, autoFlowCCType: 4,
+    });
+    if (res?.code !== 200 || res?.status === false || res?.data === false) {
+        throw new Error(`新增目标节点失败: ${res?.msg || '未知错误'}`);
+    }
+    return { added, skipped };
+}
+export function normalizeReceiverRange(data) {
+    const d = data || {};
+    return {
+        mainId: String(d.mainId ?? ''),
+        isopen: asBool(d.isopen),
+        modetype: String(d.modetype ?? '0'),
+        limitOperatorRange: asBool(d.limitOperatorRange),
+        enableSecurityLevel: asBool(d.enableSecurityLevel),
+        isUpgrade: asBool(d.isUpgrade),
+    };
+}
+/**
+ * 读指定流转目标节点的接收范围。
+ *
+ * `mainId` 优先用调用方给的 `receiverRangeKey`（目标节点列表里回读到的稳定值）；
+ * 它是 `"0"` 或空时说明这条记录还没有自己的范围设置，再按 scene=7 现读一份。
+ */
+export async function getReceiverRange(client, baseUrl, workflowId, nodeId) {
+    const res = await client.get(`${baseUrl}${BASE}/receiverRange/getBaseSetForm?workflowId=${workflowId}&nodeId=${nodeId}&scene=7`);
+    if (res?.code !== 200 || !res?.status)
+        throw new Error(`读取接收人可选范围失败: ${res?.msg || '未知错误'}`);
+    return normalizeReceiverRange(res?.data?.data);
+}
+export async function saveReceiverRange(client, baseUrl, workflowId, nodeId, r) {
+    if (!r.mainId || r.mainId === '0') {
+        throw new Error('缺少接收范围 mainId，请先读取当前场景设置（不要用 0 覆盖已有设置）');
+    }
+    const res = await client.post(`${baseUrl}${BASE}/receiverRange/saveBaseSetForm`, {
+        mainId: r.mainId, workflowId, nodeId, scene: 7,
+        isopen: r.isopen, modetype: r.modetype, limitOperatorRange: r.limitOperatorRange,
+        enableSecurityLevel: r.enableSecurityLevel, isUpgrade: r.isUpgrade,
+        isChanged: true,
+    });
+    if (res?.code !== 200 || res?.status === false || res?.data === false) {
+        throw new Error(`保存接收人可选范围失败: ${res?.msg || '未知错误'}`);
+    }
+}
+/** 取全流程节点（含类型），供 --all-nodes 用。 */
+export async function listWorkflowNodes(client, baseUrl, workflowId) {
+    const res = await client.get(`${baseUrl}${BASE}/nodeBase/getNodeEditTable?workflowId=${workflowId}`);
+    if (res?.code !== 200 || !res?.status)
+        throw new Error(`读取流程节点失败: ${res?.msg || '未知错误'}`);
+    const rows = res?.data?.data || [];
+    return rows.map((n) => ({
+        id: String(n.id ?? n.nodeId ?? ''),
+        name: String(n.nodeName ?? n.name ?? ''),
+        nodeType: String(n.nodeType ?? ''),
+    }));
+}
+/** 能配指定流转的节点（排除结束节点、分流/合流点） */
+export function assignFlowCapableNodes(nodes) {
+    return nodes.filter((n) => ASSIGN_FLOW_NODE_TYPES.has(n.nodeType) && n.id);
+}
+//# sourceMappingURL=workflow-assign-flow.js.map

package/dist/services/workflow-assign-flow.js.map

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

package/dist/services/workflow-node-layout.d.ts

@@ -0,0 +1,214 @@
+/**
+ * 流程节点独立布局 —— 节点上挂一套自己的表单布局，与表单默认布局并存。
+ *
+ * 关系是**互斥**的：一个节点同时只属于一套布局。把节点从 A 挪到 B 时，
+ * 服务端会自动把它从 A 摘掉，摘掉后该节点回落到表单默认布局（`layoutId` 置空）。
+ * 所以「绑定」这件事在接口层是**整集合覆盖**，不是增量追加：
+ *   1. 读目标布局当前的引用节点全集；
+ *   2. 加上/去掉本次要动的节点；
+ *   3. `updateQuoteNode(nodeIds=新集合, sourceNodeIds=旧集合)` 整包提交。
+ *
+ * 端点分工（同一件事的三个视角）：
+ * - 节点视角：`nodeLayout/getDisplayLayoutForm` → 这个节点挂的是哪套；
+ * - 布局视角：`pathLayoutManage/getLayoutInfoParams` → 每套布局被哪些节点引用；
+ * - 列表视角：`ebuilder/flow/form/layout/list` → 这个表单有哪些布局。
+ */
+import type { ApiClient } from '../core/client.js';
+/** 终端类型。移动端的「独立布局」与 PC 是两套独立的关系。 */
+export type Terminal = 'PC' | 'MOBILE';
+/**
+ * 布局类型：`FLOW` = 流式，`EXCEL` = 表格式。
+ *
+ * ⚠️ 流程表单建表后**不能**再切换布局类型，只有新建布局时能选。
+ */
+export type LayoutType = 'FLOW' | 'EXCEL';
+/** `layout/list` 一行。 */
+export interface FormLayoutRow {
+    id: string;
+    name: string;
+    terminalType: string;
+    layoutType: string;
+    isDefault: boolean;
+    describe?: string;
+    versionId?: string | number;
+    isSys?: boolean;
+    readOnly?: boolean;
+    simple?: boolean;
+    [k: string]: unknown;
+}
+/** 一套布局 + 它被哪些节点引用。 */
+export interface LayoutWithNodes extends FormLayoutRow {
+    /** 引用该布局的节点 id。 */
+    nodeIds: string[];
+    /** 同名节点顺序对应 `nodeIds`。 */
+    nodeNames: string[];
+}
+/** 节点上的布局设置（`getDisplayLayoutForm` 的摘取）。 */
+export interface NodeLayoutSetting {
+    nodeId: string;
+    nodeName: string;
+    formId: string;
+    /** 节点 PC 端独立布局；空串 = 用默认布局。 */
+    layoutId: string;
+    /** 表单默认布局。 */
+    defaultLayoutId: string;
+    /** 移动端独立布局（空 = 未设）。 */
+    mLayoutId: string;
+    mLayoutIdValue?: string;
+    mDefaultLayoutId?: string;
+    /** 移动端显示布局：`0` 独立布局 / `1` 读取 PC 端布局。 */
+    mLayoutMode: string;
+    nodeFormRelateId: string;
+    permissionId: string;
+    hasNodePermissionSet: boolean;
+    [k: string]: unknown;
+}
+/** 这个表单有哪些布局（含默认布局）。 */
+export declare function listFormLayouts(client: ApiClient, formId: string, opts?: {
+    workflowId?: string;
+    terminal?: Terminal;
+}): Promise<FormLayoutRow[]>;
+/**
+ * 每套布局被哪些节点引用（`layoutReferNodeInfo`）。
+ *
+ * 这是「查引用节点」的**读**接口 —— 比浏览框省事得多，一次拿全。
+ */
+export declare function getLayoutReferNodes(client: ApiClient, workflowId: string, terminal?: Terminal): Promise<{
+    /** 该工作流的表单 id —— 表单级接口（`layout/list`）都要它。 */
+    formId: string;
+    pcLayoutIds: string[];
+    mobileLayoutIds: string[];
+    pcDefaultLayoutId: string;
+    byLayout: Map<string, {
+        nodeIds: string[];
+        nodeNames: string[];
+    }>;
+}>;
+/** 布局列表 + 每套引用了哪些节点（合并上面两个接口，CLI 展示用）。 */
+export declare function listLayoutsWithNodes(client: ApiClient, formId: string, workflowId: string, terminal?: Terminal): Promise<LayoutWithNodes[]>;
+/** 节点当前挂的布局设置。 */
+export declare function getNodeLayout(client: ApiClient, workflowId: string, nodeId: string): Promise<NodeLayoutSetting>;
+/** 把一批节点设为某布局的**全部**引用节点（整集合覆盖）。 */
+export declare function updateQuoteNode(client: ApiClient, opts: {
+    workflowId: string;
+    layoutId: string;
+    nodeIds: string[];
+    sourceNodeIds: string[];
+    terminal?: Terminal;
+}): Promise<void>;
+/**
+ * 把一个节点挂到指定布局上。
+ *
+ * 先读该布局现有的引用节点全集，加上这个节点，再整包提交 ——
+ * 服务端会同时把它从原来那套布局摘掉（互斥，不残留）。
+ * 节点本来就在这套布局上时是幂等的。
+ */
+export declare function bindNodeLayout(client: ApiClient, opts: {
+    workflowId: string;
+    nodeId: string;
+    layoutId: string;
+    terminal?: Terminal;
+}): Promise<{
+    changed: boolean;
+    nodeIds: string[];
+    sourceNodeIds: string[];
+}>;
+/**
+ * 把节点从它当前的独立布局上摘下来（回落表单默认布局）。
+ *
+ * 节点本来就没挂独立布局时是幂等的（直接返回 changed=false）。
+ */
+export declare function unbindNodeLayout(client: ApiClient, opts: {
+    workflowId: string;
+    nodeId: string;
+    terminal?: Terminal;
+}): Promise<{
+    changed: boolean;
+    layoutId: string;
+    nodeIds: string[];
+}>;
+/**
+ * 复制来源时可勾的配置项。平台全勾时是四项全 `true`。
+ *
+ * 少传这两项（`viewLinkage`/`displayFormat`）时，复制出来的布局会缺视图关联与显示格式，
+ * 体积只有完整复制的五分之一左右。
+ */
+export interface CopyConfig {
+    formDataLinkage: boolean;
+    excelLinkage: boolean;
+    viewLinkage: boolean;
+    displayFormat: boolean;
+}
+/**
+ * 新建一套布局。返回新布局。
+ *
+ * **`from` 传不传差别很大**（同一份默认布局实测）：
+ * - 传 → 完整复制来源布局（内容体积 ≈ 来源本身），拿到手就能用/微调；
+ * - 不传 → 建出的是**空布局**（体积约为完整复制的 1/5，字段与排版都要重新配）。
+ *
+ * 平台设计器「新建」按钮走的就是不传 `sourceId` 的空布局分支。
+ */
+export declare function createFormLayout(client: ApiClient, opts: {
+    formId: string;
+    workflowId: string;
+    name: string;
+    /** 未指定时跟随来源布局的类型（不复制则默认 FLOW）。 */
+    layoutType?: LayoutType;
+    terminal?: Terminal;
+    describe?: string;
+    /** 建完直接把这几套节点挂上去。 */
+    nodeIds?: string[];
+    /** 复制来源布局 ID（`formLayoutMultiple.id`）；不传 = 建空布局。 */
+    from?: string;
+    copyConfig?: Partial<CopyConfig>;
+}): Promise<FormLayoutRow>;
+/** 读某套布局的内容（不传 layoutId 读默认布局）。 */
+export declare function getLayoutContent(client: ApiClient, formId: string, layoutId?: string): Promise<{
+    layout: any;
+    meta: FormLayoutRow;
+}>;
+/** 每套布局的可摆字段（`getConfig` 与布局无关，恒返回表单全量字段）。 */
+export interface LayoutFieldOption {
+    /** 传给 `--fields` 的引用（显示名）。 */
+    label: string;
+    id: string;
+    system: boolean;
+}
+/**
+ * 布局重建的开关。
+ *
+ * `fields` 不传 = 把表单**全部**字段摆上去；传了 = **只摆这些**，
+ * 其余字段只是在这套布局里不出现，**字段本身仍在表单上**（其它布局照旧显示）。
+ */
+export interface InitLayoutOptions {
+    formId: string;
+    workflowId: string;
+    /** 目标布局（`formLayoutMultiple.id`）。 */
+    layoutId: string;
+    /** 只摆这些字段（显示名或字段 id）；不传=全摆。 */
+    fields?: string[];
+    /** 样式模板 id/名；缺省按布局类型取（FLOW=流式标准版 / EXCEL=表格式表格版）。 */
+    styleTemplateId?: string;
+    required?: boolean;
+    readOnly?: boolean;
+    singleRow?: boolean;
+}
+/** 读某套布局的可摆字段清单。 */
+export declare function listLayoutFields(client: ApiClient, formId: string): Promise<LayoutFieldOption[]>;
+/**
+ * 重建某套布局（`initLayout`），可只摆指定字段。
+ *
+ * **只动目标布局**：`getFormLayout` 按 `layoutMultiId` 精确定位到目标布局，
+ * `initLayout` 的 `formLayoutMultiple` 也带同一个 id。表单默认布局与其它布局不受影响。
+ *
+ * ⚠️ 必须走 **ebuilder 路径**（`/api/ebuilder/form/...` + `module:'ebuilderform'`）。
+ * 流程表单那套 `/api/workflow/core/form/...` 在 eb 表关联流程的表单上会直接
+ * 「无工作流修改权限或工作流维护权限」500，用不了。
+ */
+export declare function initNodeLayout(client: ApiClient, opts: InitLayoutOptions): Promise<{
+    comps: number;
+    placed: string[];
+    layoutType: string;
+    styleTemplateId: string;
+}>;
+//# sourceMappingURL=workflow-node-layout.d.ts.map

package/dist/services/workflow-node-layout.d.ts.map

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