weaver-e10-builder 1.0.2-beta

package/dist/services/form-create.js

@@ -0,0 +1,835 @@
+import { toColumnName, pinyinInitials, toSubTableName } from '../utils/column-name.js';
+import { getRichType, richIdUnits } from './rich-types.js';
+export const PHYSICAL_TABLE_NAME_PATTERN = /^[A-Za-z][A-Za-z0-9_]*$/;
+/** 日期格式 → 占位中文（yyyy-MM-dd HH:mm → 年-月-日 时:分） */
+export function placeholderFromFormat(format) {
+    if (!format)
+        return '';
+    return format
+        .replace(/yyyy/g, '年')
+        .replace(/MM/g, '月')
+        .replace(/dd/g, '日')
+        .replace(/HH/g, '时')
+        .replace(/mm/g, '分')
+        .replace(/ss/g, '秒');
+}
+/**
+ * 修复 initLayout 的 DetailTable children（明细表"没字段"的根因）。
+ *
+ * getConfig 对**未铺列**的明细表子字段返回 display:false / show:false / readOnly:true，
+ * 直接发给 initLayout 会被当作"隐藏且只读"而不生成列 → 明细表空。
+ * 对齐浏览器 payload：子字段强制 可见 + 可编辑（保留 getConfig 原始 showOrder）。
+ */
+export function normalizeDetailTableChildren(configs) {
+    for (const c of configs) {
+        if (String(c.type) === 'DetailTable' && Array.isArray(c.children)) {
+            c.children = c.children.map((ch) => ({
+                ...ch,
+                display: true, show: true, readOnly: false, required: false,
+                disableEdit: false, singleRow: false, isDelete: false,
+            }));
+        }
+    }
+    return configs;
+}
+/**
+ * 构建 DateRange 日期区间字段对象（对齐浏览器实测 payload）。
+ * 需要 3 个字段 ID：主字段 + 开始时间 + 结束时间（各是一个独立 DateComponent）。
+ */
+function buildDateRangeField(def, ctx) {
+    const format = def.format || 'yyyy-MM-dd';
+    const title = def.fieldName;
+    const defaultPh = placeholderFromFormat(format);
+    const start = {
+        componentKey: 'DateComponent', content: '', describe: '', earlyDate: 'false',
+        format, isDefault: 'false', lateDate: 'false',
+        placeholder: def.startPlaceholder || defaultPh,
+        position: '', relateMultiple: 'false', required: 'false', size: 'medium',
+        title: `${title}(开始时间)`, fieldId: ctx.startId,
+        min: { type: 'currentHour' }, max: { type: 'currentHour' },
+    };
+    const end = {
+        ...start,
+        placeholder: def.endPlaceholder || defaultPh,
+        title: `${title}(结束时间)`,
+        fieldId: ctx.endId,
+    };
+    const obj = {
+        type: 'DateRange', componentKey: 'DateRange', title,
+        isDefault: false,
+        start, end,
+        dataKey: ctx.dataKey, columnName: ctx.columnName,
+        fieldId: ctx.mainId, formId: ctx.formId,
+        showOrder: ctx.showOrder, groupId: '-1',
+        labelObj: {}, status: true, sysField: false,
+        required: Boolean(ctx.required), readOnly: Boolean(ctx.readOnly), unique: Boolean(ctx.unique),
+        hasDisplayFormat: true,
+        rangeInterval: { limitType: 'max', timeUnit: 'day' },
+    };
+    if (ctx.subFormId)
+        obj.subFormId = ctx.subFormId;
+    if (ctx.formTableId)
+        obj.formTableId = ctx.formTableId;
+    return obj;
+}
+function requireSuccess(response, operation) {
+    if (response?.code !== 200 || response?.status === false || response?.fail === true) {
+        throw new Error(response?.msg || `${operation} 未确认成功`);
+    }
+    return response;
+}
+export async function queryFormStorageSetting(client, baseUrl, appId) {
+    const response = requireSuccess(await client.post(`${baseUrl}/api/ebuilder/form/form/comp/queryFormStorageSetting`, { module: 'ebuilderform' }, { ebbusinessid: appId }), 'queryFormStorageSetting');
+    const data = response.data ?? response;
+    const storageSettings = Array.isArray(data.storageSettings) ? data.storageSettings : [];
+    // 物理表环境校验表名长度；共享表(share)环境无物理表名，跳过该校验
+    const mainTablePrefix = String(data.mainTablePrefix ?? '');
+    const physicalTableNameLength = Number(data.physicalTableNameLength || 30);
+    if (storageSettings.includes('physical')) {
+        if (!Number.isInteger(physicalTableNameLength) || physicalTableNameLength <= mainTablePrefix.length) {
+            throw new Error('平台返回的物理表名长度配置无效');
+        }
+    }
+    return { mainTablePrefix, physicalTableNameLength, storageSettings };
+}
+export function resolveCustomPhysicalTableName(requested, setting) {
+    const suffix = requested.startsWith(setting.mainTablePrefix)
+        ? requested.slice(setting.mainTablePrefix.length)
+        : requested;
+    const maxSuffixLength = setting.physicalTableNameLength - setting.mainTablePrefix.length;
+    if (!PHYSICAL_TABLE_NAME_PATTERN.test(suffix)) {
+        throw new Error('--table-name 必须以英文字母开头，且只能包含英文字母、数字和下划线');
+    }
+    if (suffix.length > maxSuffixLength) {
+        throw new Error(`--table-name 自定义部分最多 ${maxSuffixLength} 位（平台前缀 ${setting.mainTablePrefix}，总长度上限 ${setting.physicalTableNameLength}）`);
+    }
+    return {
+        suffix,
+        expectedTableName: `${setting.mainTablePrefix}${suffix}`,
+        maxSuffixLength,
+    };
+}
+export async function verifyCreatedFormTableName(client, baseUrl, appId, objId, expectedTableName) {
+    const encodedAppId = encodeURIComponent(appId);
+    const response = requireSuccess(await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getList/${encodedAppId}?apid=${encodedAppId}`, { ebbusinessid: appId }), '创建后回读表单列表');
+    if (!Array.isArray(response.data))
+        throw new Error('创建后表单列表数据结构异常');
+    const created = response.data.find((form) => String(form.id) === objId);
+    if (!created)
+        throw new Error(`创建后回读未找到表单 objId=${objId}`);
+    const actualTableName = String(created.tableName ?? '');
+    if (actualTableName !== expectedTableName) {
+        throw new Error(`数据库表名回读不一致：期望 ${expectedTableName}，实际 ${actualTableName || '(空)'}`);
+    }
+    return { objId, tableName: actualTableName };
+}
+export async function createCustomPhysicalForm(client, baseUrl, appId, name, requestedTableName, multiView = false, layoutType) {
+    const setting = await queryFormStorageSetting(client, baseUrl, appId);
+    const isPhysical = setting.storageSettings.includes('physical');
+    const encodedAppId = encodeURIComponent(appId);
+    const basePayload = {
+        id: '',
+        status: 0,
+        appId,
+        name,
+        showName: name,
+        description: '',
+        groupId: isPhysical ? '-1' : '-2',
+        dnEnable: '0',
+        openMatter: 0,
+        matterSingle: '0',
+        matterRightPass: 0,
+        matterName: '',
+        matterIcon: 'Icon-e-builder-o',
+        autoSave: 0,
+        quickEdit: 0,
+        enableLog: 0,
+        enableComment: 0,
+        enableFileDelete: 0,
+        // isAdvance:true 会锁死为表格(EXCEL)布局（实测 isAdvance:false 才能建流式），FLOW 时必须 false
+        isAdvance: layoutType === 'FLOW' ? false : true,
+        associatedAuthorization: 0,
+        authorizationFields: '',
+        logTypes: '["1","2","3","4"]',
+        formLogShowType: 'tile',
+        dataLogShowType: 'single',
+        multiView,
+        // 布局类型在 saveOrUpdate 里定（浏览器建表对话框的 checkbox）：FLOW(流式)/EXCEL(表格)。
+        // 实测加 layoutType:'FLOW' 后 getFormLayout 返回 FLOW；不传缺省 EXCEL。建表后不可切换。
+        ...(layoutType ? { layoutType } : {}),
+    };
+    let payload;
+    let resolved = null;
+    if (isPhysical) {
+        resolved = resolveCustomPhysicalTableName(requestedTableName, setting);
+        payload = {
+            ...basePayload,
+            tableName: resolved.suffix,
+            tableType: 'physical',
+            allowAddShare: 0,
+            allowEditShare: 0,
+            readonlyAllowAddShare: 0,
+            enableShare: 0,
+        };
+    }
+    else {
+        // 共享表(虚拟表)：tableType 空、无 tableName、groupId=-2、开启 share 相关字段
+        payload = {
+            ...basePayload,
+            tableType: '',
+            allowAddShare: 1,
+            allowEditShare: 0,
+            readonlyAllowAddShare: 1,
+            enableShare: 0,
+            shareApplyForRemindTarget: { shareType: '0', shareContent: [] },
+            recordOperateLog: '0',
+            matterScope: '{"scopeType":"0","scope":[]}',
+            formDataCreate: false,
+            enableFullSearch: false,
+            autoSaveNewLayout: 0,
+            autoSaveEditLayout: 1,
+        };
+    }
+    const response = requireSuccess(await client.post(`${baseUrl}/api/bs/ebuilder/form/obj/saveOrUpdate?apid=${encodedAppId}`, payload, { ebbusinessid: appId }), isPhysical ? '创建物理表单' : '创建共享表单');
+    const objId = String(response.data?.id ?? response.data?.objId ?? '');
+    const formId = String(response.data?.formId ?? '');
+    if (!objId || !formId)
+        throw new Error(isPhysical ? '创建物理表单未返回 objId/formId' : '创建共享表单未返回 objId/formId');
+    if (isPhysical && resolved) {
+        const verified = await verifyCreatedFormTableName(client, baseUrl, appId, objId, resolved.expectedTableName);
+        return { objId, formId, tableName: verified.tableName, suffix: resolved.suffix, storageType: 'physical' };
+    }
+    return { objId, formId, tableName: '', suffix: '', storageType: 'share' };
+}
+function storageFieldType(componentKey) {
+    const mapping = {
+        FileComponent: 'File',
+        // DateTime 日期-时间：平台 Date 字段（DateComponent），靠 format 带时间，时间默认时:分（HH:mm 不含秒）
+        DateTime: 'Date',
+    };
+    // TextArea 的平台字段 type 就是 "TextArea"（与 componentKey 同形，对齐浏览器抓包）。
+    // 历史上误映射成小写 "Textarea"，FLOW 渲染器按 type 查组件查不到 → 多行文本在流式布局下渲染异常。
+    return mapping[componentKey] ?? componentKey;
+}
+/**
+ * 字段分组分配（updateFormFieldGroup）之后重新 initLayout。
+ * 平台新版 initLayout 据 saveFieldGroup 的分组记录 + configs 顺序自动生成 Collapse 容器，
+ * 但前提是字段已分配到分组（groupId 已设）。create 流程里 initLayout 发生在分配之前，
+ * 所以分配后需再跑一次。对齐浏览器 payload：configs 平铺、分组字段前置（分组→系统→未分组）、
+ * 无 groupFieldIds、styleTemplateId=700000000000000008（EXCEL 表格版）。
+ */
+export async function reapplyGroupLayout(client, baseUrl, appId, formId, objId, groupFieldIdSet, layoutTypeOverride) {
+    const preLayout = requireSuccess(await client.post(`${baseUrl}/api/ebuilder/form/builder/getFormLayout`, { formId, module: 'ebuilderform', customParam: {}, formTableIdList: [],
+        designerParam: { onlyLayout: false, convert: false }, form: { id: formId } }, { ebbusinessid: formId }), '读取布局ID');
+    const layoutMultiId = preLayout.data?.formLayout?.multipleLayoutId || '';
+    const layoutId = preLayout.data?.formLayout?.id || '';
+    const layoutName = preLayout.data?.formLayoutMultiple?.name || preLayout.data?.formLayout?.name || '';
+    const layoutType = layoutTypeOverride || preLayout.data?.formLayoutMultiple?.layoutType || 'EXCEL';
+    // FLOW：分组容器由 initLayout 手动 Collapse config 建好（分配前已建），分配后无需重排；
+    // 重排会平铺 configs，而 FLOW 的 generateCollapse 不生效，分组会丢。
+    if (layoutType === 'FLOW')
+        return false;
+    const configRes = requireSuccess(await client.post(`${baseUrl}/api/ebuilder/form/form/view/relate/getConfig`, { formId, module: 'ebuilderform', apiModule: 'ebuilder/form', layoutId,
+        customParam: { terminal: '', objId: formId }, initMode: 5, groupFieldIds: [],
+        designerParam: { sourceModule: 'ebuilderform' } }, { ebbusinessid: formId }), '获取字段布局配置');
+    let configs = normalizeDetailTableChildren((configRes?.data?.configs || []));
+    // 明细表统一放数组末尾
+    if (configs.some((c) => c.type === 'DetailTable')) {
+        configs = [...configs.filter((c) => c.type !== 'DetailTable'), ...configs.filter((c) => c.type === 'DetailTable')];
+    }
+    // 分组字段前置：分组字段 → 系统字段 → 未分组字段（对齐浏览器 initLayout payload）
+    configs = [
+        ...configs.filter((c) => groupFieldIdSet.has(String(c.id))),
+        ...configs.filter((c) => c.system),
+        ...configs.filter((c) => !groupFieldIdSet.has(String(c.id)) && !c.system),
+    ];
+    requireSuccess(await client.post(`${baseUrl}/api/ebuilder/form/form/view/relate/initLayout?apid=${encodeURIComponent(appId)}`, {
+        formId,
+        module: 'ebuilderform',
+        apiModule: 'ebuilder/form',
+        layoutId,
+        generateCollapse: true,
+        styleTemplateId: layoutType === 'FLOW' ? '820000000000000001' : '700000000000000008',
+        styleTemplateType: 1,
+        configs,
+        addLayout: false,
+        ecodeType: ['js', 'css'],
+        initMode: layoutTypeOverride ? '5' : '1',
+        customParam: { terminal: '', objId: formId },
+        formLayoutMultiple: {
+            isSys: true,
+            id: layoutMultiId,
+            name: layoutName,
+            terminalType: 'PC',
+            layoutType,
+        },
+        designerParam: { onlyLayout: false },
+    }, { ebbusinessid: formId }), '分组后重新布局');
+    return true;
+}
+export async function addInitialFieldsToCustomPhysicalForm(client, baseUrl, appId, objId, formId, definitions, tenantKey = '', layoutTypeOverride) {
+    const mainDefs = definitions.filter(d => d.componentKey !== 'DetailTable');
+    const detailDefs = definitions.filter(d => d.componentKey === 'DetailTable');
+    // Generate IDs for main fields. DateRange 需要 3 个 ID（主 + 开始 + 结束），普通字段 1 个，
+    // 富组件按 richIdUnits（Matrix 需要主+列+选项）。
+    const idUnits = mainDefs.map(d => (d.componentKey === 'DateRange' ? 3 : richIdUnits(d.componentKey, d)));
+    const totalIdUnits = idUnits.reduce((a, b) => a + b, 0);
+    const idResponse = await client.post(`${baseUrl}/api/ebuilder/form/form/freeform/generatorIds?size=${totalIdUnits || 1}`, {}, { ebbusinessid: formId });
+    const allGeneratedIds = (idResponse?.generatorIds ?? idResponse?.data?.generatorIds ?? []).map(String);
+    if (allGeneratedIds.length < totalIdUnits)
+        throw new Error('字段 ID 生成数量不一致');
+    let idCursor = 0;
+    const seenCols = new Map();
+    const mainFieldObjects = [];
+    // fieldId → 分组名（fields.json 里 def.group）。建表后按分组名 saveFieldGroup +
+    // updateFormFieldGroup，initLayout 时把同组字段包进 Collapse config。
+    const groupOfFieldId = new Map();
+    // fieldId → 独占一行（fields.json 里 def.singleRow）。initLayout 时该字段 singleRow:true。
+    const singleRowOfFieldId = new Map();
+    for (let i = 0; i < mainDefs.length; i++) {
+        const def = mainDefs[i];
+        const base = pinyinInitials(def.fieldName);
+        const dup = seenCols.get(base) ?? 0;
+        seenCols.set(base, dup + 1);
+        const dataKey = toColumnName(def.fieldName, dup);
+        const showOrder = `${i}.00`;
+        // DateRange：主 ID + start ID + end ID 共 3 个
+        if (def.componentKey === 'DateRange') {
+            const mainId = allGeneratedIds[idCursor];
+            if (def.group)
+                groupOfFieldId.set(mainId, def.group);
+            mainFieldObjects.push(buildDateRangeField(def, {
+                mainId,
+                startId: allGeneratedIds[idCursor++],
+                endId: allGeneratedIds[idCursor++],
+                formId,
+                dataKey,
+                columnName: dataKey,
+                showOrder,
+                required: def.required,
+                readOnly: def.readOnly,
+                unique: def.unique,
+            }));
+            continue;
+        }
+        const fieldId = allGeneratedIds[idCursor++];
+        if (def.group)
+            groupOfFieldId.set(fieldId, def.group);
+        if (def.singleRow)
+            singleRowOfFieldId.set(fieldId, true);
+        const baseField = {
+            type: storageFieldType(def.componentKey),
+            componentKey: def.componentKey,
+            title: def.fieldName,
+            fieldId,
+            formId,
+            dataKey,
+            showOrder,
+            groupId: '-1',
+            labelObj: {},
+            status: true,
+            sysField: false,
+            required: Boolean(def.required),
+            readOnly: Boolean(def.readOnly),
+            unique: Boolean(def.unique),
+            hidden: def.hidden,
+        };
+        // DateTime 日期-时间：平台 Date 字段（componentKey Date），format 带时间，默认时:分（HH:mm 不含秒）；
+        // fields.json 写 format 可覆盖精度
+        if (def.componentKey === 'DateTime') {
+            baseField.componentKey = 'Date';
+            baseField.format = def.format || 'yyyy-MM-dd HH:mm';
+        }
+        // Date（年月日）：format 缺省 yyyy-MM-dd，fields.json format 覆盖（之前主表 plain Date 没设 format）
+        if (def.componentKey === 'Date') {
+            baseField.format = def.format || 'yyyy-MM-dd';
+        }
+        // 富组件：映射到平台真实 type/componentKey + 附加配置（对齐 batch/save/formField 抓包）
+        const rich = getRichType(def.componentKey);
+        if (rich) {
+            baseField.type = rich.platformType;
+            baseField.componentKey = rich.platformComponentKey;
+            if (rich.build) {
+                const extra = richIdUnits(def.componentKey, def) - 1;
+                const extraIds = allGeneratedIds.slice(idCursor, idCursor + extra);
+                idCursor += extra;
+                const extraCfg = await rich.build({
+                    def, fieldId, formId, formTableId: '', dataKey, columnName: dataKey, showOrder, extraIds,
+                });
+                Object.assign(baseField, extraCfg);
+            }
+        }
+        // Number/Money 精度：fields.json 可写 precision/pointSize（缺省 Number=0 整数、Money=2）。
+        // 不设置会导致平台存 pointSize=sel（无效精度）。
+        // 百分比：percent:true → numberType=percentage（缺省 pointSize=1，对齐浏览器 payload）。
+        // 默认值：defaultValue → content + isDefault:true；实测设默认必须连 isDelimiter/stepMode/step/isCapital，
+        // 否则平台丢默认（只发 content+isDefault 不落库）。
+        // 千分位：delimiter:true → isDelimiter（Money 默认开、Number 默认关）；大写：capital:true → isCapital + capitalFormat。
+        if (def.componentKey === 'Number') {
+            const hasDefault = def.defaultValue !== undefined && def.defaultValue !== null && def.defaultValue !== '';
+            const isDelim = def.delimiter === true;
+            const isCap = def.capital === true;
+            Object.assign(baseField, {
+                numberType: def.percent ? 'percentage' : 'number',
+                pointSize: String(def.precision ?? def.pointSize ?? (def.percent ? '1' : '0')),
+                isDefault: hasDefault,
+                // content 始终带（无默认值时空串）——浏览器抓包 Number 字段 getFormField 恒有 content:""，
+                // 缺 content 在 FLOW 渲染下异常（与多行文本同因）。
+                content: hasDefault ? String(def.defaultValue) : '',
+                ...(hasDefault ? { stepMode: false, step: 1 } : {}),
+                isDelimiter: isDelim,
+                isCapital: isCap,
+                capitalFormat: 'onlyUpperCase',
+                capitalPosition: 'outside',
+                capitalSetting: 'system',
+                capitalPrecision: 'yuan',
+                isExchangeRates: false,
+            });
+        }
+        if (def.componentKey === 'Money') {
+            const isDelim = def.delimiter !== false; // Money 默认千分位；delimiter:false 关闭
+            const isCap = def.capital === true;
+            Object.assign(baseField, {
+                pointSize: String(def.precision ?? def.pointSize ?? '2'),
+                submitSel: false,
+                isDefault: false,
+                capitalFormat: 'onlyUpperCase',
+                capitalPosition: 'outside',
+                isDelimiter: isDelim,
+                capitalSetting: 'system',
+                capitalPrecision: 'yuan',
+                isCapital: isCap,
+                isExchangeRates: false,
+            });
+        }
+        if (def.componentKey === 'TextArea') {
+            // 多行文本：对齐浏览器抓包——content 恒为 ""（无默认值时空串）、maxLen 缺省 4000（fields.json maxLen 覆盖）。
+            // 缺 content 在 FLOW 渲染异常；maxLen 不发则前端最大长度回显异常。
+            Object.assign(baseField, { content: '', maxLen: def.maxLen || 4000 });
+        }
+        if (def.componentKey === 'Text') {
+            // 单行文本最大长度：fields.json maxLen 覆盖，缺省 100（之前主表 Text 没设 maxLen → 标注长度不生效）
+            baseField.maxLen = def.maxLen || 100;
+        }
+        if (def.componentKey === 'City') {
+            // 城市/地区选择（对齐浏览器 payload：region 模式 + 系统级联层级 + 字母索引）
+            Object.assign(baseField, {
+                isSingle: false,
+                levelSetting: 'system',
+                isDefault: false,
+                useLetterIndex: true,
+                mode: 'region',
+            });
+        }
+        mainFieldObjects.push(baseField);
+    }
+    // Date/DateTime 日期限制：minField 最早不得早于 / maxField 最晚不得晚于另一字段。
+    // 对齐抓包 min:{type:'dateField', checkValue:<目标字段fieldId>}（本字段最早不得早于目标字段）。
+    // 所有字段 ID 已生成（mainFieldObjects 完整），按字段名解析目标 fieldId。
+    for (const f of mainFieldObjects) {
+        if (f.type !== 'Date')
+            continue;
+        const def = mainDefs.find((d) => d.fieldName === f.title);
+        if (!def)
+            continue;
+        if (def.minField) {
+            const target = mainFieldObjects.find((x) => x.title === def.minField);
+            if (target) {
+                f.min = { type: 'dateField', checkValue: String(target.fieldId) };
+                f.earlyDate = true; // 启用最早日期限制（对齐抓包 earlyDate:true + min.dateField，否则 min 不生效）
+            }
+        }
+        if (def.maxField) {
+            const target = mainFieldObjects.find((x) => x.title === def.maxField);
+            if (target) {
+                f.max = { type: 'dateField', checkValue: String(target.fieldId) };
+                f.lateDate = true; // 启用最晚日期限制
+            }
+        }
+    }
+    // Detail tables: built via `forms` param in the SAME batch/save/formField call
+    const detailFieldMetas = [];
+    const formsParam = [];
+    const subFieldObjectsForBatch = [];
+    let detailShowOrder = mainDefs.length;
+    for (const dtDef of detailDefs) {
+        // Generate 2 IDs: sub-form formId + physical table formTableId
+        const subIdsRes = await client.post(`${baseUrl}/api/ebuilder/form/form/freeform/generatorIds?size=2`, {}, { ebbusinessid: formId });
+        const subGenIds = (subIdsRes?.generatorIds ?? subIdsRes?.data?.generatorIds ?? []).map(String);
+        const subFormId = subGenIds[0] || '';
+        const subTableId = subGenIds[1] || '';
+        if (!subFormId || !subTableId)
+            throw new Error('子表 ID 生成失败');
+        const subDataKey = toColumnName(dtDef.fieldName, detailShowOrder);
+        const subTableName = toSubTableName(dtDef.fieldName, detailShowOrder);
+        formsParam.push({
+            id: subFormId,
+            tableName: subTableName,
+            name: dtDef.fieldName,
+            describe: dtDef.fieldName,
+            dataKey: subDataKey,
+            dataCount: 0,
+            tableType: 'MAIN',
+            formTableId: subTableId,
+            systemTable: false,
+            orderConfig: [],
+            deleteState: 0,
+            editTable: true,
+            delete: false,
+            isSubForm: true,
+            order: detailShowOrder - mainDefs.length,
+        });
+        // Sub-fields（DateRange 子字段同样需要 3 个 ID）
+        const subFieldCount = (dtDef.formFields || []).length;
+        const seenSub = new Map();
+        if (subFieldCount > 0) {
+            const subIdUnits = (dtDef.formFields || []).map(sf => (sf.componentKey === 'DateRange' ? 3 : 1));
+            const subTotalUnits = subIdUnits.reduce((a, b) => a + b, 0);
+            const sfIdsRes = await client.post(`${baseUrl}/api/ebuilder/form/form/freeform/generatorIds?size=${subTotalUnits}`, {}, { ebbusinessid: formId });
+            const sfIds = (sfIdsRes?.generatorIds ?? sfIdsRes?.data?.generatorIds ?? []).map(String);
+            let sfCursor = 0;
+            for (let si = 0; si < subFieldCount; si++) {
+                const sf = (dtDef.formFields || [])[si];
+                const sfBase = pinyinInitials(sf.fieldName);
+                const sfDup = seenSub.get(sfBase) ?? 0;
+                seenSub.set(sfBase, sfDup + 1);
+                const sfColName = toColumnName(sf.fieldName, sfDup);
+                if (sf.componentKey === 'DateRange') {
+                    subFieldObjectsForBatch.push(buildDateRangeField(sf, {
+                        mainId: sfIds[sfCursor++],
+                        startId: sfIds[sfCursor++],
+                        endId: sfIds[sfCursor++],
+                        formId,
+                        subFormId,
+                        formTableId: subTableId,
+                        dataKey: sfColName,
+                        columnName: sfColName,
+                        showOrder: '99999',
+                    }));
+                    continue;
+                }
+                const sfObj = {
+                    type: storageFieldType(sf.componentKey),
+                    // Date/DateTime 子字段平台组件是 DateComponent（与主表一致），TextArea 子字段 type 存小写 Textarea
+                    componentKey: sf.componentKey === 'TextArea' ? 'Textarea'
+                        : (sf.componentKey === 'Date' || sf.componentKey === 'DateTime' ? 'DateComponent' : sf.componentKey),
+                    title: sf.fieldName,
+                    fieldId: sfIds[sfCursor++],
+                    formId,
+                    subFormId,
+                    formTableId: subTableId,
+                    groupId: '-1',
+                    showOrder: 99999,
+                    dataKey: sfColName,
+                    columnName: sfColName,
+                };
+                // Field-type-specific attributes (matching browser-observed payload)
+                if (sf.componentKey === 'Number') {
+                    const sfDef = sf;
+                    const sfHasDefault = sfDef.defaultValue !== undefined && sfDef.defaultValue !== null && sfDef.defaultValue !== '';
+                    sfObj.numberType = sfDef.percent ? 'percentage' : 'number';
+                    sfObj.pointSize = String(sfDef.precision ?? sfDef.pointSize ?? (sfDef.percent ? '1' : '0'));
+                    sfObj.isDefault = sfHasDefault;
+                    if (sfHasDefault) {
+                        sfObj.content = String(sfDef.defaultValue);
+                        sfObj.isDelimiter = false;
+                        sfObj.stepMode = false;
+                        sfObj.step = 1;
+                        sfObj.isCapital = false;
+                    }
+                    sfObj.capitalPosition = 'outside';
+                    sfObj.capitalSetting = 'system';
+                    sfObj.capitalPrecision = 'yuan';
+                }
+                else if (sf.componentKey === 'Money') {
+                    sfObj.pointSize = String(sf.precision ?? sf.pointSize ?? '2');
+                    sfObj.submitSel = false;
+                    sfObj.isDefault = false;
+                    sfObj.capitalPosition = 'outside';
+                    sfObj.isDelimiter = true;
+                    sfObj.capitalSetting = 'system';
+                    sfObj.capitalPrecision = 'yuan';
+                }
+                else if (sf.componentKey === 'Date' || sf.componentKey === 'DateTime') {
+                    // 明细日期精度：之前误用 dateFormat（错 key，平台不认）→ 精度丢失。浏览器抓包用 format。
+                    // Date 默认 yyyy-MM-dd（年月日）、DateTime 默认 yyyy-MM-dd HH:mm（时:分）；fields.json format 覆盖。
+                    const isDt = sf.componentKey === 'DateTime';
+                    const sfFmt = sf.format || (isDt ? 'yyyy-MM-dd HH:mm' : 'yyyy-MM-dd');
+                    Object.assign(sfObj, {
+                        format: sfFmt,
+                        placeholder: placeholderFromFormat(sfFmt),
+                        timePanelStyle: { type: 'system' },
+                        earlyDate: false,
+                        lateDate: false,
+                        defaultExtend: { date: { type: 'custom' } },
+                        minuteStep: 1,
+                        hasDisplayFormat: false,
+                        columnType: 'VARCHAR',
+                        typeLen: 25,
+                        columnTypeSwitch: false,
+                        isDefault: false,
+                    });
+                }
+                else if (sf.componentKey === 'IDCard') {
+                    // 身份证号：浏览器抓包 payload 极简，无文本长度/唯一/扫码等配置
+                }
+                else {
+                    // Text/TextArea/others
+                    sfObj.maxLen = sf.componentKey === 'TextArea' ? 1000 : 100;
+                    sfObj.unique = false;
+                    sfObj.scan = false;
+                    sfObj.readonlyTransLink = false;
+                }
+                subFieldObjectsForBatch.push(sfObj);
+            }
+        }
+        detailFieldMetas.push({ fieldId: subFormId, subFormId, definition: dtDef, showOrder: detailShowOrder });
+        detailShowOrder++;
+    }
+    // 子表字段日期校验：minField/maxField 可指向主表字段（mainFieldObjects）或子表字段（subFieldObjectsForBatch）。
+    // 先全部生成再统一补（保证同子表后出现的字段也能解析）。对齐抓包 min:{type:'dateField', checkValue} + earlyDate 开关。
+    for (const f of subFieldObjectsForBatch) {
+        if (f.type !== 'Date')
+            continue;
+        const sfDef = detailDefs.flatMap((d) => (d.formFields || [])).find((s) => s.fieldName === f.title);
+        if (!sfDef)
+            continue;
+        if (sfDef.minField) {
+            const target = [...mainFieldObjects, ...subFieldObjectsForBatch].find((x) => x.title === sfDef.minField);
+            if (target) {
+                f.min = { type: 'dateField', checkValue: String(target.fieldId) };
+                f.earlyDate = true;
+            }
+        }
+        if (sfDef.maxField) {
+            const target = [...mainFieldObjects, ...subFieldObjectsForBatch].find((x) => x.title === sfDef.maxField);
+            if (target) {
+                f.max = { type: 'dateField', checkValue: String(target.fieldId) };
+                f.lateDate = true;
+            }
+        }
+    }
+    // One call: main fields + sub-form + sub-fields (matching browser-observed payload)
+    const allFieldObjects = [...mainFieldObjects, ...subFieldObjectsForBatch];
+    if (allFieldObjects.length > 0 || formsParam.length > 0) {
+        requireSuccess(await client.post(`${baseUrl}/api/ebuilder/form/form/field/manage/batch/save/formField?apid=${encodeURIComponent(appId)}`, {
+            module: 'ebuilderform',
+            formId,
+            customParam: { appId, objId },
+            forms: formsParam,
+            ids: [],
+            delSubFormIds: [],
+            delFormTableIdList: [],
+            jsonObjList: allFieldObjects.map(f => JSON.stringify(f)),
+            replaceFieldIdMap: {},
+        }, { ebbusinessid: formId }), '批量创建表单字段及明细表');
+    }
+    // Read back fields
+    const fieldResponse = requireSuccess(await client.post(`${baseUrl}/api/ebuilder/form/form/field/manage/getFormFieldPage?apid=${encodeURIComponent(appId)}`, {
+        pageNo: 1,
+        pageSize: 200,
+        module: 'ebuilderform',
+        customParam: { appId, objId },
+        formFieldSearchEntity: { isDelete: 0, status: 'enable', formId },
+    }, { ebbusinessid: formId }), '字段创建后回读');
+    const fields = fieldResponse.data?.pageDatas?.result;
+    if (!Array.isArray(fields))
+        throw new Error('字段创建后回读结构异常');
+    const savedIds = new Set(fields.map((field) => String(field.fieldId ?? field.id)));
+    const mainOnlyIds = mainFieldObjects.map(f => f.fieldId);
+    const missing = mainOnlyIds.filter((id) => !savedIds.has(id));
+    if (missing.length)
+        throw new Error(`主表字段创建后回读缺少 ${missing.length} 个字段`);
+    // 字段分组：fields.json 里 def.group 同名字段归一组。
+    // 这里只建分组记录（saveFieldGroup，返回 group.id + group.refFieldId），initLayout 时用
+    // refFieldId 包 Collapse config。字段→分组的分配（updateFormFieldGroup）放到 form create
+    // 最末做——选项(Step7)/公式(Step8)等 saveFormFieldNew 会重置 field.groupId，先分配会被冲掉。
+    // refFieldId 是 layout Collapse config id（= group.id - 1，平台先分 layout config 再分 formFieldGroup）。
+    const groupFields = new Map();
+    for (const f of mainFieldObjects) {
+        const g = groupOfFieldId.get(String(f.fieldId));
+        if (!g)
+            continue;
+        if (!groupFields.has(g))
+            groupFields.set(g, []);
+        groupFields.get(g).push(String(f.fieldId));
+    }
+    const groupMeta = new Map();
+    for (const [groupName, fieldIds] of groupFields) {
+        const sg = requireSuccess(await client.post(`${baseUrl}/api/ebuilder/form/form/field/manage/saveFieldGroup?apid=${encodeURIComponent(appId)}`, { module: 'ebuilderform', formFieldGroup: { groupName, formId }, customParam: { appId, objId } }, { ebbusinessid: formId }), `建字段分组 ${groupName}`);
+        const groupId = sg.data?.group?.id;
+        const refFieldId = sg.data?.group?.refFieldId;
+        if (!groupId || !refFieldId)
+            throw new Error(`建分组 ${groupName} 未返回 id/refFieldId`);
+        groupMeta.set(groupName, { groupId, refFieldId });
+    }
+    // 供 form create 末尾统一分配字段到分组（所有 saveFormFieldNew 之后）。
+    const fieldGroups = [...groupFields.entries()].map(([name, fieldIds]) => ({
+        name, fieldIds, groupId: groupMeta.get(name).groupId, refFieldId: groupMeta.get(name).refFieldId,
+    }));
+    // Use system auto-layout (initLayout) — handles EXCEL + DetailTable automatically
+    // Get layout IDs from getFormLayout (more reliable than layout/list)
+    const preLayout = requireSuccess(await client.post(`${baseUrl}/api/ebuilder/form/builder/getFormLayout`, { formId, module: 'ebuilderform', customParam: {}, formTableIdList: [],
+        designerParam: { onlyLayout: false, convert: false }, form: { id: formId } }, { ebbusinessid: formId }), '读取布局ID');
+    const layoutMultiId = preLayout.data?.formLayout?.multipleLayoutId || '';
+    const layoutId = preLayout.data?.formLayout?.id || '';
+    const layoutName = preLayout.data?.formLayoutMultiple?.name || preLayout.data?.formLayout?.name || '';
+    // 表单可能是流式布局(FLOW)或表格布局(EXCEL)，用实际类型，不能用硬编码 EXCEL。
+    // layoutTypeOverride（form create --layout）在建表时显式指定布局类型——布局类型建表后不可切换，
+    // 事后改不了，只能在创建时定（浏览器实测：FLOW 用特殊模板 820000000000000001，跨环境一致）。
+    const layoutType = layoutTypeOverride || preLayout.data?.formLayoutMultiple?.layoutType || 'EXCEL';
+    // Get field configs for initLayout (includes system fields + DetailTable children)
+    const configRes = requireSuccess(await client.post(`${baseUrl}/api/ebuilder/form/form/view/relate/getConfig`, {
+        formId,
+        module: 'ebuilderform',
+        apiModule: 'ebuilder/form',
+        layoutId,
+        customParam: { terminal: '', objId: formId },
+        initMode: 5,
+        groupFieldIds: [],
+        designerParam: { sourceModule: 'ebuilderform' },
+    }, { ebbusinessid: formId }), '获取字段布局配置');
+    // Map field defs by fieldId so fields.json required/readOnly override getConfig defaults.
+    // Business fields default to editable (readOnly=false) — getConfig/008 template otherwise
+    // emit read-only comps.
+    const defByFieldId = new Map(mainFieldObjects.map((f) => [String(f.fieldId), f]));
+    // 布局控制（对齐浏览器 initLayout payload）：
+    // 1. 重排业务字段 showOrder —— getConfig 会把明细表夹在中间（其 subFormId 生成的 ID 早于
+    //    部分普通字段），导致"明细表跳到上面"。普通字段按建表顺序在前、明细表统一在最后。
+    // 2. 落单字段（普通字段奇数个的最后一个）与明细表设 singleRow:true 独占一行 ——
+    //    否则落单字段仍是两列占左列、右列留白（"编号单独一行但没独占"）。
+    const businessOrder = new Map();
+    const mainFieldIdOrder = mainFieldObjects.map((f) => String(f.fieldId));
+    let layoutIdx = 0;
+    for (const id of mainFieldIdOrder)
+        businessOrder.set(id, layoutIdx++);
+    for (const dt of detailFieldMetas)
+        businessOrder.set(String(dt.fieldId), layoutIdx++);
+    // 落单字段（奇数个的最后一个）独占一行，避免右列留白。
+    // 有分组时：分组内字段由 Collapse 容器自行排布，落单只对**未分组字段**（按未分组字段数奇偶）判断；
+    // 否则全局最后一个字段（如未分组字段）被误设 singleRow，把本应两列拼行的未分组字段拆开
+    // （"签订日期下面字段独立成行 → 签订日期没占满一行"）。
+    const hasGroup = groupMeta.size > 0;
+    const ungroupedMainIds = mainFieldObjects
+        .filter((f) => !groupOfFieldId.get(String(f.fieldId)))
+        .map((f) => String(f.fieldId));
+    const loneRowId = hasGroup
+        ? (ungroupedMainIds.length % 2 === 1 ? ungroupedMainIds[ungroupedMainIds.length - 1] : null)
+        : (mainFieldIdOrder.length % 2 === 1 ? mainFieldIdOrder[mainFieldIdOrder.length - 1] : null);
+    let configs = normalizeDetailTableChildren((configRes?.data?.configs || []).map((c) => {
+        const def = defByFieldId.get(String(c.id));
+        const isBusiness = !c.system;
+        const order = businessOrder.get(String(c.id));
+        const isDetail = c.type === 'DetailTable';
+        return {
+            ...c,
+            display: c.system ? c.display : true,
+            // hidden:true → 布局属性"显示"取消（show:false），字段不展示但保留参与计算
+            show: c.system ? c.show : !(def?.hidden),
+            ...(order !== undefined ? { showOrder: order } : {}),
+            ...(isBusiness ? {
+                readOnly: def ? Boolean(def.readOnly) : false,
+                required: def ? Boolean(def.required) : (c.required ?? false),
+                // 独占一行：明细表 + 落单字段 + 字段显式写 singleRow:true（其余普通字段保持两列）
+                singleRow: isDetail || String(c.id) === loneRowId || singleRowOfFieldId.get(String(c.id)) === true,
+            } : {}),
+        };
+    }));
+    // 明细表统一放数组末尾（initLayout 按 configs 数组顺序布局，不看 showOrder；
+    // getConfig 会把明细表夹在中间导致"明细表跳到上面"）
+    if (configs.some((c) => c.type === 'DetailTable')) {
+        configs = [...configs.filter((c) => c.type !== 'DetailTable'), ...configs.filter((c) => c.type === 'DetailTable')];
+    }
+    // 注：FLOW comp 里的 EXCEL 残留属性（componentLevel/index/isReadOnly/isSingle/order/tempId/templateId/
+    //   unique/labelObj/layout.canDel）来自平台 initLayout 按**字段定义 + 模板**重建 comp，与 CLI 发的
+    //   configs 内容无关——实测剥残留 + 补 associatedId 后读回仍带残留、associatedId 仍缺，initLayout 忽略
+    //   这些 comp 层字段。故真正生效的修都在字段定义层（storageFieldType 的 TextArea 大小写、componentKey
+    //   归一、Number/TextArea 的 content/maxLen），comp 层由平台据字段定义生成，字段定义对了 comp 即对。
+    // 分组渲染按布局类型分叉：
+    // EXCEL：平铺 + 分组字段前置，平台 generateCollapse 据 saveFieldGroup 分组记录自动生成 Collapse 容器
+    //   （对齐浏览器 007 payload：configs 全平铺、无 Collapse 组件、无 groupFieldIds）。
+    // FLOW：平台 generateCollapse 对流式布局**不生效**（实测不生成 Collapse），改用手动 Collapse config +
+    //   groupFieldIds（旧逻辑，FLOW 分组曾验证 OK）。
+    const groupFieldIds = [];
+    if (groupMeta.size > 0) {
+        if (layoutType === 'FLOW') {
+            const childrenByGroup = new Map();
+            for (const gname of groupFields.keys())
+                childrenByGroup.set(gname, []);
+            const ungrouped = [];
+            for (const c of configs) {
+                const gname = groupOfFieldId.get(String(c.id));
+                if (gname && groupMeta.has(gname) && !c.system) {
+                    childrenByGroup.get(gname).push(c);
+                }
+                else {
+                    ungrouped.push(c);
+                }
+            }
+            const collapses = [];
+            for (const gname of groupFields.keys()) {
+                const meta = groupMeta.get(gname);
+                const children = childrenByGroup.get(gname) || [];
+                groupFieldIds.push(meta.refFieldId);
+                collapses.push({
+                    id: meta.refFieldId, name: gname, componentKey: 'Fold', display: true, show: true,
+                    readOnly: true, required: false, disableEdit: false, singleRow: false, isDelete: false,
+                    type: 'Collapse', typeDescribe: '分组', dataKey: `f_${meta.refFieldId}`,
+                    children,
+                });
+            }
+            configs = [...collapses, ...ungrouped];
+            let so = 0;
+            for (const c of configs) {
+                c.showOrder = so++;
+                for (const ch of (c.children || []))
+                    ch.showOrder = so++;
+            }
+        }
+        else {
+            // EXCEL：平铺 + 分组字段前置（分组字段 → 系统字段 → 未分组字段）
+            const groupFieldIdSet = new Set();
+            for (const [, fieldIds] of groupFields)
+                for (const id of fieldIds)
+                    groupFieldIdSet.add(String(id));
+            configs = [
+                ...configs.filter((c) => groupFieldIdSet.has(String(c.id))),
+                ...configs.filter((c) => c.system),
+                ...configs.filter((c) => !groupFieldIdSet.has(String(c.id)) && !c.system),
+            ];
+        }
+    }
+    const initResult = requireSuccess(await client.post(`${baseUrl}/api/ebuilder/form/form/view/relate/initLayout?apid=${encodeURIComponent(appId)}`, {
+        formId,
+        module: 'ebuilderform',
+        apiModule: 'ebuilder/form',
+        layoutId,
+        generateCollapse: true,
+        styleTemplateId: layoutType === 'FLOW' ? '820000000000000001' : '700000000000000008',
+        styleTemplateType: 1,
+        configs,
+        addLayout: false,
+        ecodeType: ['js', 'css'],
+        // 显式指定布局时 initMode 用浏览器新建的 '5'（对齐抓包）；缺省路径保持 '1' 防回归
+        initMode: layoutTypeOverride ? '5' : '1',
+        // FLOW 分组用手动 Collapse config，传各分组 refFieldId（layout Collapse config id）；
+        // EXCEL 分组由平台 generateCollapse 自动生成，此数组为空。
+        groupFieldIds,
+        customParam: { terminal: '', objId: formId },
+        formLayoutMultiple: {
+            isSys: true,
+            id: layoutMultiId,
+            name: layoutName,
+            terminalType: 'PC',
+            layoutType,
+        },
+        designerParam: { onlyLayout: false },
+    }, { ebbusinessid: formId }), '系统自动布局');
+    // Use initLayout response's pageLayouts directly (more reliable than separate getFormLayout)
+    const pageLayouts = initResult.data?.pageLayouts || initResult.data?.formLayout?.pageLayouts || [];
+    const comps = pageLayouts.flatMap((p) => Array.isArray(p.comps) ? p.comps : []);
+    if (comps.length === 0)
+        throw new Error('initLayout 返回的布局无组件');
+    return { fieldIds: mainFieldObjects.map(f => f.fieldId), layoutComponentCount: comps.length, detailTables: detailFieldMetas, fieldGroups };
+}
+//# sourceMappingURL=form-create.js.map