weaver-e10-builder 1.5.13 → 1.5.14

package/dist/services/form-layout-template-advanced.js

@@ -0,0 +1,1437 @@
+import { randomBytes } from 'node:crypto';
+import { isDeepStrictEqual } from 'node:util';
+import { assertDesignerReadableLayoutCode, decodeLayoutCode, encodeLayoutCode, updateCode } from './form-code.js';
+const ROOT = '/api/form/form/layout/template';
+const MODULE = 'form';
+export function validateAdvancedLayoutEditPatch(input) {
+    const patch = object(input, '布局修改配置');
+    keys(patch, ['edits'], '布局修改配置');
+    if (!Array.isArray(patch.edits) || patch.edits.length === 0)
+        throw new Error('edits 必须是非空数组');
+    for (const edit of patch.edits) {
+        const item = object(edit, 'edits 项');
+        keys(item, ['op', 'path', 'value'], 'edits 项');
+        if (item.op !== 'set' && item.op !== 'remove')
+            throw new Error('edits.op 只能是 set 或 remove');
+        parseLayoutPath(item.path);
+        if (item.op === 'set' && !Object.hasOwn(item, 'value'))
+            throw new Error('set 操作必须提供 value');
+        if (item.op === 'remove' && Object.hasOwn(item, 'value'))
+            throw new Error('remove 操作不能提供 value');
+    }
+    return patch;
+}
+export function validateAdvancedTemplateCreateConfig(input) {
+    const config = object(input, '模板新建配置');
+    if (config.sourceTemplateId === undefined && config.layoutInfo === undefined && config.edits === undefined)
+        return validateMinimalAdvancedDesign(input);
+    keys(config, ['templateName', 'sourceTemplateId', 'layoutInfo', 'edits', 'layoutStyle', 'grid', 'coverFileId', 'cssSource'], '模板新建配置');
+    if (typeof config.templateName !== 'string' || !config.templateName.trim() || config.templateName.length > 100)
+        throw new Error('templateName 必须是 1–100 字的名称');
+    if ((config.sourceTemplateId === undefined) === (config.layoutInfo === undefined))
+        throw new Error('sourceTemplateId 与 layoutInfo 必须且只能提供一个');
+    if (config.sourceTemplateId !== undefined && (typeof config.sourceTemplateId !== 'string' || !/^\d+$/.test(config.sourceTemplateId)))
+        throw new Error('sourceTemplateId 必须是模板 ID');
+    if (config.layoutInfo !== undefined)
+        object(config.layoutInfo, 'layoutInfo');
+    if (config.edits !== undefined)
+        validateAdvancedLayoutEditPatch({ edits: config.edits });
+    if (config.layoutStyle !== undefined)
+        validateAdvancedLayoutStylePatch(config.layoutStyle);
+    if (config.grid !== undefined)
+        validateAdvancedGridPatch(config.grid);
+    if (config.coverFileId !== undefined && typeof config.coverFileId !== 'string')
+        throw new Error('coverFileId 必须是字符串');
+    if (config.cssSource !== undefined && typeof config.cssSource !== 'string')
+        throw new Error('cssSource 必须是 CSS 文字');
+    return config;
+}
+function parseLayoutPath(path) {
+    if (typeof path !== 'string' || !path.startsWith('/') || path === '/')
+        throw new Error('edits.path 必须是指向 layoutInfo 内属性的 JSON Pointer');
+    const parts = path.slice(1).split('/').map(part => {
+        if (/~(?![01])/.test(part))
+            throw new Error('edits.path 转义无效');
+        return part.replace(/~1/g, '/').replace(/~0/g, '~');
+    });
+    if (parts.some(part => !part || ['__proto__', 'prototype', 'constructor'].includes(part)))
+        throw new Error('edits.path 包含不允许的路径');
+    return parts;
+}
+export function applyAdvancedLayoutEdits(layoutInfo, edits) {
+    for (const edit of edits || []) {
+        const parts = parseLayoutPath(edit.path);
+        let parent = layoutInfo;
+        for (const part of parts.slice(0, -1)) {
+            if (!plain(parent) && !Array.isArray(parent))
+                throw new Error(`路径不存在：${edit.path}`);
+            parent = parent[part];
+            if (parent === undefined)
+                throw new Error(`路径不存在：${edit.path}`);
+        }
+        const leaf = parts.at(-1);
+        if (!plain(parent) && !Array.isArray(parent))
+            throw new Error(`路径不存在：${edit.path}`);
+        if (Array.isArray(parent) && (!/^\d+$/.test(leaf) || Number(leaf) >= parent.length))
+            throw new Error(`数组位置不存在：${edit.path}`);
+        if (edit.op === 'remove') {
+            if (Array.isArray(parent) || !Object.hasOwn(parent, leaf))
+                throw new Error(`不能删除该路径：${edit.path}`);
+            delete parent[leaf];
+        }
+        else
+            parent[leaf] = structuredClone(edit.value);
+    }
+}
+function verifyAdvancedLayoutEdits(expectedLayout, savedLayout, edits, id) {
+    const normalize = (value) => {
+        if (Array.isArray(value))
+            return value.map(normalize);
+        if (!plain(value))
+            return value;
+        const result = {};
+        for (const [key, item] of Object.entries(value)) {
+            if ((key === 'id' && value.type && value.config) || (key === 'comId' && value.allowOverflow !== undefined && value.type))
+                continue;
+            result[key] = normalize(item);
+        }
+        return result;
+    };
+    for (const edit of edits || []) {
+        const parts = parseLayoutPath(edit.path);
+        const read = (obj, path) => path.reduce((value, part) => value?.[part], obj);
+        const expected = read(expectedLayout, parts);
+        let actual = read(savedLayout, parts);
+        if (actual === undefined && parts[0] === 'pageLayouts' && parts[2] === 'config' && parts[3] === 'workbook' && parts[4] !== 'Sheet1') {
+            const index = expectedLayout.pageLayouts?.[Number(parts[1])]?.comps?.findIndex((comp) => comp.id === parts[4]);
+            const savedKey = savedLayout.pageLayouts?.[Number(parts[1])]?.comps?.[index]?.id;
+            if (savedKey)
+                actual = read(savedLayout, [...parts.slice(0, 4), savedKey, ...parts.slice(5)]);
+        }
+        if (!isDeepStrictEqual(normalize(actual), normalize(expected)))
+            throw new Error(`模板 ${id} 的 ${edit.path} 回读不一致`);
+    }
+}
+const plain = (value) => Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+const cssColor = (value, label) => {
+    if (typeof value !== 'string' || !/^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/.test(value))
+        throw new Error(`${label} 必须是 #RGB、#RRGGBB 或 #RRGGBBAA`);
+    return value;
+};
+const borderColor = (value, label) => value === 'transparent' ? 'transparent' : cssColor(value, label);
+const pixel = (value, label) => {
+    if (!Number.isInteger(value) || Number(value) < 0 || Number(value) > 2000)
+        throw new Error(`${label} 必须是 0–2000 的整数`);
+    return Number(value);
+};
+function keys(value, allowed, label) {
+    for (const key of Object.keys(value))
+        if (!allowed.includes(key))
+            throw new Error(`${label} 不支持 ${key}`);
+}
+function object(value, label) {
+    if (!plain(value))
+        throw new Error(`${label} 必须是对象`);
+    return value;
+}
+function dimension(value, label) {
+    if (typeof value !== 'string' || !/^(100|[1-9]?\d)%$|^[1-9]\d{0,3}px$/.test(value))
+        throw new Error(`${label} 必须是百分比或正整数 px`);
+    return value;
+}
+function spacing(value, allowed, label, signed = false) {
+    const item = object(value, label);
+    keys(item, allowed, label);
+    for (const [key, val] of Object.entries(item)) {
+        if (signed && key.startsWith('margin') && Number.isInteger(val) && val >= -2000 && val <= 2000)
+            continue;
+        pixel(val, `${label}.${key}`);
+    }
+    return item;
+}
+function solidBorder(value, label) {
+    const border = object(value, label);
+    keys(border, ['widthPx', 'color'], label);
+    if (border.widthPx === undefined || border.color === undefined)
+        throw new Error(`${label} 需要 widthPx 和 color`);
+    pixel(border.widthPx, `${label}.widthPx`);
+    cssColor(border.color, `${label}.color`);
+}
+function noBorder(value, label) {
+    if (value !== 'none')
+        throw new Error(`${label} 目前只支持 none`);
+}
+function validateInputStyle(value, label, widthKey) {
+    const item = object(value, label);
+    keys(item, [...(widthKey ? [widthKey] : []), 'backgroundColor', 'border'], label);
+    if (widthKey && item[widthKey] !== undefined)
+        dimension(item[widthKey], `${label}.${widthKey}`);
+    if (item.backgroundColor !== undefined)
+        cssColor(item.backgroundColor, `${label}.backgroundColor`);
+    if (item.border !== undefined)
+        noBorder(item.border, `${label}.border`);
+}
+function validatePageRegion(value, label) {
+    const region = object(value, label);
+    keys(region, ['backgroundColor', 'borders', 'radiusPx', 'cornerRadius'], label);
+    if (region.backgroundColor !== undefined)
+        cssColor(region.backgroundColor, `${label}.backgroundColor`);
+    if (region.radiusPx !== undefined)
+        pixel(region.radiusPx, `${label}.radiusPx`);
+    if (region.cornerRadius !== undefined)
+        spacing(region.cornerRadius, ['topLeftPx', 'topRightPx', 'bottomLeftPx', 'bottomRightPx'], `${label}.cornerRadius`);
+    if (region.borders !== undefined) {
+        const borders = object(region.borders, `${label}.borders`);
+        keys(borders, ['all', 'top', 'right', 'bottom', 'left'], `${label}.borders`);
+        for (const [side, raw] of Object.entries(borders)) {
+            const border = object(raw, `${label}.borders.${side}`);
+            keys(border, ['widthPx', 'line', 'color'], `${label}.borders.${side}`);
+            pixel(border.widthPx, `${label}.borders.${side}.widthPx`);
+            if (!['none', 'solid', 'dashed', 'dotted'].includes(border.line))
+                throw new Error(`${label}.borders.${side}.line 无效`);
+            borderColor(border.color, `${label}.borders.${side}.color`);
+        }
+    }
+}
+export function validateAdvancedGridPatch(value) {
+    const patch = object(value, 'grid');
+    keys(patch, ['main', 'detail'], 'grid');
+    if (!Object.keys(patch).length)
+        throw new Error('grid 至少需要 main 或 detail');
+    for (const [scope, raw] of Object.entries(patch)) {
+        const sheet = object(raw, `grid.${scope}`);
+        keys(sheet, ['rowHeights', 'columns', 'cells', 'merge', 'split'], `grid.${scope}`);
+        for (const kind of ['rowHeights', 'columns', 'cells', 'merge', 'split'])
+            if (sheet[kind] !== undefined && !Array.isArray(sheet[kind]))
+                throw new Error(`grid.${scope}.${kind} 必须是数组`);
+        for (const item of sheet.rowHeights || []) {
+            const row = object(item, `${scope}.rowHeights`);
+            keys(row, ['row', 'px'], `${scope}.rowHeights`);
+            pixel(row.row, 'rowHeights.row');
+            pixel(row.px, 'rowHeights.px');
+            if (row.px === 0)
+                throw new Error('rowHeights.px 必须大于 0');
+        }
+        for (const item of sheet.columns || []) {
+            const col = object(item, `${scope}.columns`);
+            keys(col, ['col', 'unit', 'value'], `${scope}.columns`);
+            pixel(col.col, 'columns.col');
+            if (!['percent', 'fixed'].includes(col.unit))
+                throw new Error('columns.unit 只能是 percent 或 fixed');
+            pixel(col.value, 'columns.value');
+            if (col.value === 0)
+                throw new Error('columns.value 必须大于 0');
+            if (col.unit === 'percent' && col.value > 100)
+                throw new Error('百分比列宽不能大于 100');
+        }
+        for (const item of sheet.cells || []) {
+            const cell = object(item, `${scope}.cells`);
+            keys(cell, ['row', 'col', 'text', 'systemParameter', 'backgroundColor', 'textColor', 'font', 'fontFamily', 'fontSizePx',
+                'bold', 'italic', 'underline', 'horizontalAlign', 'verticalAlign', 'wordWrap', 'textIndent', 'borders'], `${scope}.cells`);
+            pixel(cell.row, 'cells.row');
+            pixel(cell.col, 'cells.col');
+            if (cell.text !== undefined && (typeof cell.text !== 'string' || cell.text.length > 10000))
+                throw new Error('cells.text 必须是长度不超过 10000 的文字');
+            if (cell.systemParameter !== undefined && cell.systemParameter !== 'formTitle')
+                throw new Error('cells.systemParameter 目前只支持 formTitle');
+            if (cell.text !== undefined && cell.systemParameter !== undefined)
+                throw new Error('cells.text 与 systemParameter 不能同时设置');
+            if (cell.backgroundColor !== undefined)
+                cssColor(cell.backgroundColor, 'cells.backgroundColor');
+            if (cell.textColor !== undefined)
+                cssColor(cell.textColor, 'cells.textColor');
+            if (cell.font !== undefined && (typeof cell.font !== 'string' || !/^(?:italic )?(?:[1-9]00 )?\d{1,3}px [\p{L}\p{N} _-]+$/u.test(cell.font)))
+                throw new Error('cells.font 格式如 italic 700 14px 宋体');
+            if (cell.font !== undefined && ['fontFamily', 'fontSizePx', 'bold', 'italic'].some(key => cell[key] !== undefined))
+                throw new Error('cells.font 不能与独立字体设置同时使用');
+            if (cell.fontFamily !== undefined && (typeof cell.fontFamily !== 'string' || !/^[\p{L}\p{N} _-]{1,100}$/u.test(cell.fontFamily)))
+                throw new Error('cells.fontFamily 格式无效');
+            if (cell.fontSizePx !== undefined && (pixel(cell.fontSizePx, 'cells.fontSizePx') < 1 || cell.fontSizePx > 999))
+                throw new Error('cells.fontSizePx 必须是 1–999 的整数');
+            for (const key of ['bold', 'italic', 'underline', 'wordWrap'])
+                if (cell[key] !== undefined && typeof cell[key] !== 'boolean')
+                    throw new Error(`cells.${key} 必须是布尔值`);
+            if (cell.horizontalAlign !== undefined && !['left', 'center', 'right'].includes(cell.horizontalAlign))
+                throw new Error('cells.horizontalAlign 无效');
+            if (cell.verticalAlign !== undefined && !['top', 'middle', 'bottom'].includes(cell.verticalAlign))
+                throw new Error('cells.verticalAlign 无效');
+            if (cell.textIndent !== undefined)
+                pixel(cell.textIndent, 'cells.textIndent');
+            if (cell.borders !== undefined) {
+                const borders = object(cell.borders, 'cells.borders');
+                keys(borders, ['top', 'right', 'bottom', 'left'], 'cells.borders');
+                for (const [side, rawBorder] of Object.entries(borders)) {
+                    const border = object(rawBorder, `cells.borders.${side}`);
+                    keys(border, ['color', 'line'], `cells.borders.${side}`);
+                    if (!['none', 'thin', 'medium', 'thick', 'dashed', 'dotted', 'double'].includes(border.line))
+                        throw new Error(`cells.borders.${side}.line 无效`);
+                    if (border.line !== 'none')
+                        cssColor(border.color, `cells.borders.${side}.color`);
+                    else if (border.color !== undefined)
+                        cssColor(border.color, `cells.borders.${side}.color`);
+                }
+            }
+        }
+        for (const item of sheet.merge || []) {
+            const merge = object(item, `${scope}.merge`);
+            keys(merge, ['row', 'col', 'rowCount', 'colCount'], `${scope}.merge`);
+            for (const key of ['row', 'col', 'rowCount', 'colCount'])
+                pixel(merge[key], `merge.${key}`);
+            if (!merge.rowCount || !merge.colCount || (merge.rowCount === 1 && merge.colCount === 1))
+                throw new Error('merge 至少覆盖两个单元格');
+        }
+        for (const item of sheet.split || []) {
+            const split = object(item, `${scope}.split`);
+            keys(split, ['row', 'col'], `${scope}.split`);
+            pixel(split.row, 'split.row');
+            pixel(split.col, 'split.col');
+        }
+    }
+    return patch;
+}
+export function applyAdvancedGridPatch(layoutInfo, value) {
+    const patch = validateAdvancedGridPatch(value);
+    const workbook = layoutInfo.pageLayouts?.[0]?.config?.workbook;
+    if (!plain(workbook) || !workbook.Sheet1)
+        throw new Error('模板缺少 PC 表格式主网格');
+    for (const scope of ['main', 'detail']) {
+        const item = patch[scope];
+        if (!item)
+            continue;
+        const sheetName = scope === 'main' ? 'Sheet1' : Object.keys(workbook).find(key => key !== 'Sheet1');
+        const sheet = sheetName && workbook[sheetName];
+        if (!sheet)
+            throw new Error(`模板没有${scope === 'main' ? '主表' : '明细表'}网格`);
+        for (const row of item.rowHeights || []) {
+            if (!sheet.rows[row.row])
+                throw new Error(`${scope} 第 ${row.row} 行不存在`);
+            sheet.rows[row.row].size = row.px;
+        }
+        for (const col of item.columns || []) {
+            if (!sheet.columns[col.col])
+                throw new Error(`${scope} 第 ${col.col} 列不存在`);
+            sheet.columns[col.col] = { ...sheet.columns[col.col], type: col.unit, size: col.value };
+        }
+        if (sheet.columns.every((col) => col.type === 'percent') && sheet.columns.reduce((n, col) => n + col.size, 0) !== 100)
+            throw new Error(`${scope} 百分比列宽之和必须为 100`);
+        const cellsIn = (span) => sheet.cells.filter((c) => Number(c.row) >= span.row && Number(c.row) < span.row + span.rowCount &&
+            Number(c.col) >= span.col && Number(c.col) < span.col + span.colCount);
+        const overlap = (a, b) => a.row < b.row + b.rowCount && a.row + a.rowCount > b.row &&
+            a.col < b.col + b.colCount && a.col + a.colCount > b.col;
+        for (const change of item.split || []) {
+            const index = sheet.spans.findIndex((span) => span.row === change.row && span.col === change.col);
+            if (index < 0)
+                throw new Error(`${scope} ${change.row},${change.col} 不是合并区域的左上角`);
+            const span = sheet.spans[index];
+            if (cellsIn(span).some((cell) => cell.style?.cellType))
+                throw new Error('不能拆分包含字段组件或重复标记的区域');
+            sheet.spans.splice(index, 1);
+        }
+        for (const span of item.merge || []) {
+            if (span.row + span.rowCount > sheet.rows.length || span.col + span.colCount > sheet.columns.length)
+                throw new Error(`${scope} 合并范围超出网格`);
+            if (sheet.spans.some((existing) => overlap(existing, span)))
+                throw new Error(`${scope} 合并范围与已有合并区域重叠`);
+            const covered = cellsIn(span);
+            if (covered.some((cell) => cell.style?.cellType ||
+                ((Number(cell.row) !== span.row || Number(cell.col) !== span.col) && cell.value !== undefined && cell.value !== null && cell.value !== '')))
+                throw new Error('合并范围包含字段组件、重复标记或非左上角文字');
+            sheet.spans.push({ row: span.row, rowCount: span.rowCount, col: span.col, colCount: span.colCount });
+        }
+        for (const change of item.cells || []) {
+            if (!sheet.rows[change.row] || !sheet.columns[change.col])
+                throw new Error(`${scope} 单元格 ${change.row},${change.col} 超出网格`);
+            let cell = sheet.cells.find((c) => Number(c.row) === change.row && Number(c.col) === change.col);
+            if (!cell) {
+                cell = { row: String(change.row), col: String(change.col), style: {} };
+                sheet.cells.push(cell);
+            }
+            const style = cell.style ??= {};
+            if (change.text !== undefined || change.systemParameter !== undefined) {
+                if (style.cellType)
+                    throw new Error('不能将静态文字或系统参数写入字段组件单元格');
+                if (sheet.spans.some((span) => change.row >= span.row && change.row < span.row + span.rowCount &&
+                    change.col >= span.col && change.col < span.col + span.colCount && (change.row !== span.row || change.col !== span.col)))
+                    throw new Error('合并区域中的文字只能写在左上角单元格');
+                cell.value = change.systemParameter === 'formTitle' ? '#[formTitle]#' : change.text;
+            }
+            if (change.backgroundColor !== undefined)
+                style.backColor = change.backgroundColor;
+            if (change.textColor !== undefined)
+                style.foreColor = change.textColor;
+            if (change.font !== undefined)
+                style.font = change.font;
+            if (['fontFamily', 'fontSizePx', 'bold', 'italic'].some(key => change[key] !== undefined)) {
+                const old = /^(italic )?(?:([1-9]00) )?(\d{1,3})px (.+)$/u.exec(style.font || '12px Arial');
+                if (!old)
+                    throw new Error('原字体格式未知，需同时指定完整 font');
+                const italic = change.italic ?? Boolean(old[1]);
+                const weight = change.bold === undefined ? old[2] : change.bold ? '700' : undefined;
+                const size = change.fontSizePx ?? Number(old[3]);
+                const family = change.fontFamily ?? old[4];
+                style.font = `${italic ? 'italic ' : ''}${weight ? `${weight} ` : ''}${size}px ${family}`;
+            }
+            if (change.underline !== undefined)
+                style.textDecoration = change.underline ? 1 : 0;
+            if (change.horizontalAlign !== undefined)
+                style.hAlign = { center: 1, right: 2, left: 3 }[change.horizontalAlign];
+            if (change.verticalAlign !== undefined)
+                style.vAlign = { top: 0, middle: 1, bottom: 2 }[change.verticalAlign];
+            if (change.wordWrap !== undefined)
+                style.wordWrap = change.wordWrap;
+            if (change.textIndent !== undefined)
+                style.textIndent = change.textIndent;
+            const lineCodes = { thin: 1, medium: 2, thick: 5, dashed: 3, dotted: 4, double: 6 };
+            for (const [side, border] of Object.entries(change.borders || {})) {
+                const key = `border${side[0].toUpperCase()}${side.slice(1)}`;
+                if (border.line === 'none')
+                    delete style[key];
+                else
+                    style[key] = { color: border.color, style: lineCodes[border.line] };
+            }
+        }
+    }
+    return layoutInfo;
+}
+export function validateAdvancedLayoutStylePatch(value) {
+    const style = object(value, 'layoutStyle');
+    keys(style, ['page', 'field', 'detailTable', 'detailFields', 'group'], 'layoutStyle');
+    if (style.page !== undefined) {
+        const page = object(style.page, 'page');
+        keys(page, ['backgroundColor', 'showReadOnlyPlaceholder', 'showReadOnlyBackground', 'readOnlyType', 'tabStyleConfigId', 'outer', 'form', 'spacing'], 'page');
+        if (page.backgroundColor !== undefined)
+            cssColor(page.backgroundColor, 'page.backgroundColor');
+        for (const key of ['showReadOnlyPlaceholder', 'showReadOnlyBackground'])
+            if (page[key] !== undefined && typeof page[key] !== 'boolean')
+                throw new Error(`page.${key} 必须是布尔值`);
+        if (page.readOnlyType !== undefined && page.readOnlyType !== 'disabled')
+            throw new Error('page.readOnlyType 目前只支持 disabled');
+        if (page.tabStyleConfigId !== undefined && (typeof page.tabStyleConfigId !== 'string' || !/^\d+$/.test(page.tabStyleConfigId)))
+            throw new Error('page.tabStyleConfigId 必须是样式 ID');
+        if (page.outer !== undefined)
+            validatePageRegion(page.outer, 'page.outer');
+        if (page.form !== undefined)
+            validatePageRegion(page.form, 'page.form');
+        if (page.spacing !== undefined)
+            spacing(page.spacing, ['marginTopPx', 'marginRightPx', 'marginBottomPx', 'marginLeftPx', 'paddingTopPx', 'paddingRightPx', 'paddingBottomPx', 'paddingLeftPx'], 'page.spacing');
+    }
+    if (style.field !== undefined) {
+        const field = object(style.field, 'field');
+        keys(field, ['contentRightMarginPx', 'spacingBottomPx', 'content', 'input', 'browser'], 'field');
+        if (field.contentRightMarginPx !== undefined)
+            pixel(field.contentRightMarginPx, 'field.contentRightMarginPx');
+        if (field.spacingBottomPx !== undefined)
+            pixel(field.spacingBottomPx, 'field.spacingBottomPx');
+        if (field.content !== undefined) {
+            const item = object(field.content, 'field.content');
+            keys(item, ['border', 'radiusPx', 'paddingLeftPx', 'paddingRightPx', 'paddingTopPx', 'paddingBottomPx'], 'field.content');
+            if (item.border !== undefined)
+                solidBorder(item.border, 'field.content.border');
+            for (const [key, val] of Object.entries(item))
+                if (key !== 'border')
+                    pixel(val, `field.content.${key}`);
+        }
+        if (field.input !== undefined)
+            validateInputStyle(field.input, 'field.input', 'width');
+        if (field.browser !== undefined)
+            validateInputStyle(field.browser, 'field.browser', 'minWidth');
+    }
+    if (style.detailTable !== undefined)
+        spacing(style.detailTable, ['paddingTopPx', 'paddingBottomPx', 'paddingLeftPx', 'paddingRightPx'], 'detailTable');
+    if (style.detailFields !== undefined) {
+        const detail = object(style.detailFields, 'detailFields');
+        keys(detail, ['contentRightMarginPx', 'spacingRightPx', 'spacingBottomPx', 'content', 'input', 'browser'], 'detailFields');
+        for (const key of ['contentRightMarginPx', 'spacingRightPx', 'spacingBottomPx'])
+            if (detail[key] !== undefined)
+                pixel(detail[key], `detailFields.${key}`);
+        for (const kind of ['input', 'browser'])
+            if (detail[kind] !== undefined)
+                validateInputStyle(detail[kind], `detailFields.${kind}`);
+        if (detail.content !== undefined) {
+            const content = object(detail.content, 'detailFields.content');
+            keys(content, ['paddingRightPx', 'border'], 'detailFields.content');
+            if (content.paddingRightPx !== undefined)
+                pixel(content.paddingRightPx, 'detailFields.content.paddingRightPx');
+            if (content.border !== undefined)
+                noBorder(content.border, 'detailFields.content.border');
+        }
+    }
+    if (style.group !== undefined) {
+        const group = object(style.group, 'group');
+        keys(group, ['title', 'icon', 'background', 'content', 'spacing'], 'group');
+        if (group.title !== undefined) {
+            const title = object(group.title, 'group.title');
+            keys(title, ['fontWeight', 'backgroundColor', 'leftBorder', 'bottomBorder', 'paddingTopPx', 'paddingBottomPx', 'paddingLeftPx', 'marginBottomPx'], 'group.title');
+            for (const [key, val] of Object.entries(title)) {
+                if (key === 'fontWeight') {
+                    if (!Number.isInteger(val) || val < 100 || val > 900 || val % 100)
+                        throw new Error('group.title.fontWeight 必须是 100–900 的百位整数');
+                }
+                else if (key === 'backgroundColor')
+                    cssColor(val, `group.title.${key}`);
+                else if (key === 'leftBorder' || key === 'bottomBorder')
+                    solidBorder(val, `group.title.${key}`);
+                else
+                    pixel(val, `group.title.${key}`);
+            }
+        }
+        if (group.icon !== undefined) {
+            const icon = object(group.icon, 'group.icon');
+            keys(icon, ['path', 'fontSizePx', 'color', 'radiusPx', 'fillType', 'borderColor', 'backgroundColor', 'displayType'], 'group.icon');
+            if (typeof icon.path !== 'string' || !/^#Icon-[\w-]+$/.test(icon.path))
+                throw new Error('group.icon.path 格式无效');
+            for (const key of ['fontSizePx', 'radiusPx'])
+                if (icon[key] !== undefined)
+                    pixel(icon[key], `group.icon.${key}`);
+            for (const key of ['color', 'borderColor', 'backgroundColor'])
+                if (icon[key] !== undefined)
+                    cssColor(icon[key], `group.icon.${key}`);
+            if (icon.fillType !== undefined && icon.fillType !== 'none')
+                throw new Error('group.icon.fillType 目前只支持 none');
+            if (icon.displayType !== undefined && icon.displayType !== 'suffer')
+                throw new Error('group.icon.displayType 目前只支持 suffer');
+        }
+        if (group.background !== undefined) {
+            const bg = object(group.background, 'group.background');
+            keys(bg, ['color', 'radiusPx'], 'group.background');
+            if (bg.color !== undefined)
+                cssColor(bg.color, 'group.background.color');
+            if (bg.radiusPx !== undefined)
+                pixel(bg.radiusPx, 'group.background.radiusPx');
+        }
+        if (group.content !== undefined)
+            spacing(group.content, ['marginLeftPx', 'marginRightPx', 'paddingTopPx', 'paddingBottomPx'], 'group.content', true);
+        if (group.spacing !== undefined)
+            spacing(group.spacing, ['marginTopPx', 'marginBottomPx', 'paddingTopPx', 'paddingLeftPx', 'paddingRightPx'], 'group.spacing', true);
+    }
+    return style;
+}
+const set = (root, path, value) => {
+    let node = root;
+    for (const key of path.slice(0, -1))
+        node = node[key] ??= {};
+    node[path.at(-1)] = value;
+};
+const spacingNames = { marginLeftPx: 'margin-left', marginRightPx: 'margin-right',
+    marginTopPx: 'margin-top', marginBottomPx: 'margin-bottom', paddingLeftPx: 'padding-left',
+    paddingRightPx: 'padding-right', paddingTopPx: 'padding-top', paddingBottomPx: 'padding-bottom' };
+function applySpacing(style, path, values) {
+    if (!values)
+        return;
+    for (const [key, value] of Object.entries(values))
+        set(style, [...path, 'spacing', spacingNames[key]], `${value}px`);
+}
+function applyNoBorder(style, path) {
+    for (const key of ['border', 'borderTop', 'borderBottom', 'borderLeft', 'borderRight'])
+        set(style, [...path, 'border', key], '0px none transparent');
+}
+function applySolidBorder(style, path, border) {
+    for (const key of ['border', 'borderTop', 'borderBottom', 'borderLeft', 'borderRight'])
+        set(style, [...path, 'border', key], `${border.widthPx}px solid ${border.color}`);
+}
+function applyInputStyle(style, path, item) {
+    if (!item)
+        return;
+    if (item.width !== undefined)
+        set(style, [...path, 'width'], item.width);
+    if (item.minWidth !== undefined)
+        set(style, [...path, 'min-width'], item.minWidth);
+    if (item.backgroundColor !== undefined)
+        set(style, [...path, 'background-color'], item.backgroundColor);
+    if (item.border === 'none')
+        applyNoBorder(style, path);
+}
+function applyPageRegion(style, path, region) {
+    if (!region)
+        return;
+    if (region.backgroundColor !== undefined)
+        set(style, [...path, 'background-color'], region.backgroundColor);
+    const borderKeys = { all: 'border', top: 'borderTop', right: 'borderRight', bottom: 'borderBottom', left: 'borderLeft' };
+    for (const [side, border] of Object.entries(region.borders || {}))
+        set(style, [...path, 'border', borderKeys[side]], `${border.widthPx}px ${border.line} ${border.color}`);
+    if (region.radiusPx !== undefined)
+        set(style, [...path, 'border-radius', 'borderRadius'], `${region.radiusPx}px`);
+    const cornerKeys = { topLeftPx: 'borderTopLeftRadius', topRightPx: 'borderTopRightRadius',
+        bottomLeftPx: 'borderBottomLeftRadius', bottomRightPx: 'borderBottomRightRadius' };
+    for (const [key, value] of Object.entries(region.cornerRadius || {}))
+        set(style, [...path, 'border-radius', cornerKeys[key]], `${value}px`);
+}
+export function applyAdvancedLayoutStyle(layoutInfo, value) {
+    const patch = validateAdvancedLayoutStylePatch(value);
+    const existing = layoutInfo.formStyle?.styleConfig;
+    const style = existing ? JSON.parse(existing) : {};
+    if (!plain(style))
+        throw new Error('模板布局样式格式未知');
+    const page = patch.page;
+    if (page?.backgroundColor !== undefined)
+        set(style, ['formLayout', 'background', 'background-color'], page.backgroundColor);
+    if (page?.showReadOnlyPlaceholder !== undefined)
+        set(style, ['formLayout', 'typeSetting', 'showReadOnlyPlaceholder'], page.showReadOnlyPlaceholder);
+    if (page?.showReadOnlyBackground !== undefined)
+        set(style, ['formLayout', 'typeSetting', 'showReadOnlyBackground'], page.showReadOnlyBackground);
+    if (page?.readOnlyType !== undefined)
+        set(style, ['formLayout', 'typeSetting', 'readOnlyType'], page.readOnlyType);
+    if (page?.tabStyleConfigId !== undefined)
+        set(style, ['formLayout', 'typeSetting', 'tabStyleConfigId'], page.tabStyleConfigId);
+    applyPageRegion(style, ['formLayout', 'background'], page?.outer);
+    applyPageRegion(style, ['formLayout', 'formBackground'], page?.form);
+    applySpacing(style, ['formLayout', 'layoutSpacing'], page?.spacing);
+    const field = patch.field;
+    if (field?.contentRightMarginPx !== undefined)
+        set(style, ['field', 'content', 'spacing', 'margin-right'], `${field.contentRightMarginPx}px`);
+    if (field?.spacingBottomPx !== undefined)
+        set(style, ['field', 'fieldSpacing', 'spacing', 'margin-bottom'], `${field.spacingBottomPx}px`);
+    if (field?.content?.border)
+        applySolidBorder(style, ['field', 'content'], field.content.border);
+    if (field?.content?.radiusPx !== undefined)
+        set(style, ['field', 'content', 'border-radius', 'borderRadius'], `${field.content.radiusPx}px`);
+    for (const key of ['paddingLeftPx', 'paddingRightPx', 'paddingTopPx', 'paddingBottomPx'])
+        if (field?.content?.[key] !== undefined)
+            set(style, ['field', 'content', 'spacing', spacingNames[key]], `${field.content[key]}px`);
+    applyInputStyle(style, ['field', 'inputStyle'], field?.input);
+    applyInputStyle(style, ['field', 'browserStyle'], field?.browser);
+    applySpacing(style, ['layout', 'detailTable', 'fieldSpacing'], patch.detailTable);
+    if (patch.detailFields?.contentRightMarginPx !== undefined)
+        set(style, ['layout', 'detailTableFields', 'content', 'spacing', 'margin-right'], `${patch.detailFields.contentRightMarginPx}px`);
+    if (patch.detailFields?.spacingRightPx !== undefined)
+        set(style, ['layout', 'detailTableFields', 'fieldSpacing', 'spacing', 'margin-right'], `${patch.detailFields.spacingRightPx}px`);
+    if (patch.detailFields?.spacingBottomPx !== undefined)
+        set(style, ['layout', 'detailTableFields', 'fieldSpacing', 'spacing', 'margin-bottom'], `${patch.detailFields.spacingBottomPx}px`);
+    if (patch.detailFields?.content?.paddingRightPx !== undefined)
+        set(style, ['layout', 'detailTableFields', 'content', 'spacing', 'padding-right'], `${patch.detailFields.content.paddingRightPx}px`);
+    if (patch.detailFields?.content?.border === 'none')
+        applyNoBorder(style, ['layout', 'detailTableFields', 'content']);
+    applyInputStyle(style, ['layout', 'detailTableFields', 'inputStyle'], patch.detailFields?.input);
+    applyInputStyle(style, ['layout', 'detailTableFields', 'browserStyle'], patch.detailFields?.browser);
+    const title = patch.group?.title;
+    if (title?.fontWeight !== undefined)
+        set(style, ['layout', 'collapse', 'title', 'font-weight'], String(title.fontWeight));
+    if (title?.backgroundColor !== undefined)
+        set(style, ['layout', 'collapse', 'title', 'background-color'], title.backgroundColor);
+    if (title?.leftBorder)
+        set(style, ['layout', 'collapse', 'title', 'border', 'borderLeft'], `${title.leftBorder.widthPx}px solid ${title.leftBorder.color}`);
+    if (title?.bottomBorder)
+        set(style, ['layout', 'collapse', 'title', 'border', 'borderBottom'], `${title.bottomBorder.widthPx}px solid ${title.bottomBorder.color}`);
+    for (const [key, native] of [['paddingTopPx', 'padding-top'], ['paddingBottomPx', 'padding-bottom'], ['paddingLeftPx', 'padding-left'], ['marginBottomPx', 'margin-bottom']]) {
+        if (title?.[key] !== undefined)
+            set(style, ['layout', 'collapse', 'title', 'spacing', native], `${title[key]}px`);
+    }
+    const icon = patch.group?.icon;
+    if (icon) {
+        const base = ['layout', 'collapse', 'groupIconSetting', 'groupIcon'];
+        set(style, [...base, 'path'], icon.path);
+        if (icon.fontSizePx !== undefined)
+            set(style, [...base, 'style', 'fontSize'], icon.fontSizePx);
+        if (icon.color !== undefined)
+            set(style, [...base, 'style', 'color'], icon.color);
+        if (icon.radiusPx !== undefined)
+            set(style, [...base, 'style', 'radius'], `${icon.radiusPx}px`);
+        if (icon.fillType !== undefined)
+            set(style, [...base, 'style', 'fillType'], icon.fillType);
+        if (icon.borderColor !== undefined)
+            set(style, [...base, 'style', 'borderColor'], icon.borderColor);
+        if (icon.backgroundColor !== undefined)
+            set(style, [...base, 'style', 'bgColor'], icon.backgroundColor);
+        if (icon.displayType !== undefined)
+            set(style, ['layout', 'collapse', 'groupIconSetting', 'iconDisplayType'], icon.displayType);
+    }
+    if (patch.group?.background?.color !== undefined)
+        set(style, ['layout', 'collapse', 'background', 'background-color'], patch.group.background.color);
+    if (patch.group?.background?.radiusPx !== undefined)
+        set(style, ['layout', 'collapse', 'background', 'border-radius', 'borderRadius'], `${patch.group.background.radiusPx}px`);
+    applySpacing(style, ['layout', 'collapse', 'content'], patch.group?.content);
+    applySpacing(style, ['layout', 'collapse', 'fieldSpacing'], patch.group?.spacing);
+    layoutInfo.formStyle ??= {};
+    layoutInfo.formStyle.styleConfig = JSON.stringify(style);
+    return layoutInfo;
+}
+function result(response, action) {
+    if (response?.code !== 200 || response?.status !== true)
+        throw new Error(`${action}失败：${response?.msg || '接口返回异常'}`);
+    return response.data;
+}
+function size(value, label, fallback) {
+    const actual = value === undefined ? fallback : Number(value);
+    if (!Number.isInteger(actual) || actual < 1 || actual > 2000)
+        throw new Error(`${label} 必须是 1–2000 的整数`);
+    return actual;
+}
+export function validateMinimalAdvancedDesign(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new Error('高级模板设计必须是 JSON 对象');
+    const input = value;
+    const allowed = new Set(['templateName', 'fieldPairsPerRow', 'fieldRows', 'fieldPlacements', 'headerTitle', 'headerTitlePlacement', 'sectionTitle', 'group', 'detailTable', 'columnWidthsPercent',
+        'rowHeight', 'titleWidthPx', 'fieldWidthPx', 'coverFileId', 'layoutStyle', 'grid', 'cssSource']);
+    for (const key of Object.keys(input))
+        if (!allowed.has(key))
+            throw new Error(`最小高级模板暂不支持 ${key}`);
+    const templateName = String(input.templateName ?? '').trim();
+    if (!templateName || templateName.length > 150)
+        throw new Error('templateName 必填且不能超过 150 个字符');
+    const fieldPairsPerRow = input.fieldPairsPerRow === undefined ? 1 : input.fieldPairsPerRow;
+    if (fieldPairsPerRow !== 1 && fieldPairsPerRow !== 2)
+        throw new Error('fieldPairsPerRow 只能是 1 或 2');
+    if (input.fieldPlacements !== undefined) {
+        if (input.fieldRows !== undefined || input.fieldPairsPerRow !== undefined || !Array.isArray(input.fieldPlacements) ||
+            input.fieldPlacements.length < 1 || input.fieldPlacements.length > 4)
+            throw new Error('fieldPlacements 需要 1–4 组，并与 fieldRows、fieldPairsPerRow 三选一');
+        const pairs = input.fieldPlacements.map(item => object(item, 'fieldPlacements 项').pair);
+        if (new Set(pairs).size !== pairs.length || pairs.some((_, index) => !pairs.includes(index + 1)))
+            throw new Error('fieldPlacements 须使用从 1 开始的标题字段对，且不能重复或跳号');
+        for (const item of input.fieldPlacements) {
+            const entry = object(item, 'fieldPlacements 项');
+            keys(entry, ['pair', 'title', 'field'], 'fieldPlacements 项');
+            for (const key of ['title', 'field']) {
+                const p = object(entry[key], `fieldPlacements.${key}`);
+                keys(p, ['row', 'col', 'colSpan'], `fieldPlacements.${key}`);
+                if (!Number.isInteger(p.row) || p.row < 0 || p.row > 19 ||
+                    !Number.isInteger(p.col) || p.col < 0 || p.col > 19 ||
+                    (p.colSpan !== undefined && (!Number.isInteger(p.colSpan) || p.colSpan < 1 || p.colSpan > 20)))
+                    throw new Error('fieldPlacements 行列及跨列须为有效正整数');
+            }
+        }
+        const occupied = new Set();
+        for (const item of input.fieldPlacements)
+            for (const p of [item.title, item.field]) {
+                if (!p)
+                    throw new Error('fieldPlacements 缺少 title 或 field 位置');
+                for (let col = p.col; col < p.col + (p.colSpan || 1); col++) {
+                    const key = `${p.row},${col}`;
+                    if (occupied.has(key))
+                        throw new Error(`fieldPlacements 单元格或跨列范围重叠：${key}`);
+                    occupied.add(key);
+                }
+            }
+    }
+    if (input.fieldRows !== undefined) {
+        if (input.fieldPairsPerRow !== undefined || input.fieldPlacements !== undefined || !Array.isArray(input.fieldRows) || !input.fieldRows.length ||
+            input.fieldRows.length > 4 || input.fieldRows.some(row => !Array.isArray(row) || row.length < 1 || row.length > 4 ||
+            row.some(pair => !Number.isInteger(pair) || pair < 1 || pair > 4)))
+            throw new Error('fieldRows 需要 1–4 行，每行 1–4 个字段对，且不能与 fieldPairsPerRow 同时使用');
+        const pairs = input.fieldRows.flat();
+        if (new Set(pairs).size !== pairs.length || pairs.some((pair, index) => !pairs.includes(index + 1)))
+            throw new Error('fieldRows 须使用从 1 开始的标题字段对，且不能重复或跳号');
+    }
+    const maxSlots = input.fieldRows ? Math.max(...input.fieldRows.map(row => row.length)) : fieldPairsPerRow;
+    const explicit = input.fieldPlacements;
+    if (input.headerTitle !== undefined && input.headerTitle !== 'formTitle')
+        throw new Error('headerTitle 目前只支持 formTitle');
+    if (input.headerTitlePlacement !== undefined && !['full', 'content'].includes(input.headerTitlePlacement))
+        throw new Error('headerTitlePlacement 只能是 full 或 content');
+    if (input.headerTitlePlacement !== undefined && input.headerTitle === undefined)
+        throw new Error('headerTitlePlacement 需要同时设置 headerTitle');
+    if (input.sectionTitle !== undefined && (typeof input.sectionTitle !== 'string' || !input.sectionTitle.trim() || input.sectionTitle.length > 100))
+        throw new Error('sectionTitle 必须是 1–100 字的文字');
+    if (input.sectionTitle !== undefined && maxSlots < 2 && !explicit)
+        throw new Error('sectionTitle 目前只用于有两列以上字段的布局');
+    if (input.group !== undefined) {
+        const group = object(input.group, 'group');
+        keys(group, ['enabled'], 'group');
+        if (group.enabled !== true)
+            throw new Error('group.enabled 只能为 true；不需要分组时省略 group');
+    }
+    if (input.detailTable !== undefined) {
+        const detail = object(input.detailTable, 'detailTable');
+        keys(detail, ['enabled', 'title', 'rowHeightPx', 'columnWidthsPx', 'fieldRepeatDirection',
+            'fieldTitlePosition', 'fieldRepeatPosition', 'controlPositions'], 'detailTable');
+        if (detail.enabled !== true)
+            throw new Error('detailTable.enabled 只能为 true；不需要明细表时省略 detailTable');
+        if (detail.title !== undefined && (typeof detail.title !== 'string' || !detail.title.trim() || detail.title.length > 100))
+            throw new Error('detailTable.title 必须是 1–100 字的文字');
+        if (detail.rowHeightPx !== undefined)
+            size(detail.rowHeightPx, 'detailTable.rowHeightPx', 30);
+        if (detail.columnWidthsPx !== undefined && (!Array.isArray(detail.columnWidthsPx) || detail.columnWidthsPx.length < 3 || detail.columnWidthsPx.length > 20))
+            throw new Error('detailTable.columnWidthsPx 必须提供 3–20 个 px 宽度');
+        for (const width of detail.columnWidthsPx || [])
+            size(width, 'detailTable.columnWidthsPx', 180);
+        if (detail.fieldRepeatDirection !== undefined && !['horizontal', 'vertical'].includes(String(detail.fieldRepeatDirection)))
+            throw new Error('detailTable.fieldRepeatDirection 只能是 horizontal 或 vertical');
+        const point = (value, label) => {
+            const p = object(value, label);
+            keys(p, ['row', 'col'], label);
+            if (!Number.isInteger(p.row) || !Number.isInteger(p.col) || p.row < 0 || p.col < 0 ||
+                p.row > 39 || p.col > 19)
+                throw new Error(`${label} 行列须为有效的非负整数`);
+        };
+        if (detail.fieldTitlePosition !== undefined)
+            point(detail.fieldTitlePosition, 'fieldTitlePosition');
+        if (detail.fieldRepeatPosition !== undefined)
+            point(detail.fieldRepeatPosition, 'fieldRepeatPosition');
+        if (detail.controlPositions !== undefined) {
+            const controls = object(detail.controlPositions, 'controlPositions');
+            keys(controls, ['de_title', 'de_tail', 'de_titletext', 'de_btn', 'de_checkall',
+                'de_checksingle', 'de_serialtitle', 'de_serialnum'], 'controlPositions');
+            for (const [name, value] of Object.entries(controls))
+                point(value, `controlPositions.${name}`);
+        }
+    }
+    if (input.columnWidthsPercent !== undefined) {
+        const expectedColumns = explicit ? input.columnWidthsPercent instanceof Array ? input.columnWidthsPercent.length : 0 : maxSlots * 2 + 2;
+        if ((maxSlots < 2 && !input.fieldRows && !explicit) || !Array.isArray(input.columnWidthsPercent) ||
+            input.columnWidthsPercent.length !== expectedColumns ||
+            input.columnWidthsPercent.some(v => !Number.isInteger(v) || v <= 0 || v > 100) ||
+            input.columnWidthsPercent.reduce((n, v) => n + v, 0) !== 100)
+            throw new Error(`columnWidthsPercent 需提供 ${expectedColumns} 个正整数，合计 100`);
+    }
+    if (explicit && (!Array.isArray(input.columnWidthsPercent) || input.columnWidthsPercent.length < 3 ||
+        input.columnWidthsPercent.length > 20 || explicit.some(item => [item.title, item.field].some(p => p.col + (p.colSpan || 1) > input.columnWidthsPercent.length))))
+        throw new Error('fieldPlacements 必须配合足够列数的 columnWidthsPercent');
+    if (input.coverFileId !== undefined && !/^\d+$/.test(String(input.coverFileId)))
+        throw new Error('coverFileId 必须是上传文件返回的 ID');
+    return { templateName,
+        ...(input.fieldRows === undefined && input.fieldPlacements === undefined ? { fieldPairsPerRow } : {}),
+        ...(input.fieldRows !== undefined ? { fieldRows: input.fieldRows } : {}),
+        ...(input.fieldPlacements !== undefined ? { fieldPlacements: input.fieldPlacements } : {}),
+        ...(input.headerTitle !== undefined ? { headerTitle: 'formTitle' } : {}),
+        ...(input.headerTitlePlacement !== undefined ? { headerTitlePlacement: input.headerTitlePlacement } : {}),
+        ...(input.sectionTitle !== undefined ? { sectionTitle: input.sectionTitle.trim() } : {}),
+        ...(input.group !== undefined ? { group: { enabled: true } } : {}),
+        ...(input.detailTable !== undefined ? { detailTable: { enabled: true,
+                ...(input.detailTable.title !== undefined ? { title: input.detailTable.title.trim() } : {}),
+                ...(input.detailTable.rowHeightPx !== undefined ? { rowHeightPx: input.detailTable.rowHeightPx } : {}),
+                ...(input.detailTable.columnWidthsPx !== undefined ? { columnWidthsPx: input.detailTable.columnWidthsPx } : {}),
+                ...(input.detailTable.fieldRepeatDirection !== undefined ? { fieldRepeatDirection: input.detailTable.fieldRepeatDirection } : {}),
+                ...(input.detailTable.fieldTitlePosition !== undefined ? { fieldTitlePosition: input.detailTable.fieldTitlePosition } : {}),
+                ...(input.detailTable.fieldRepeatPosition !== undefined ? { fieldRepeatPosition: input.detailTable.fieldRepeatPosition } : {}),
+                ...(input.detailTable.controlPositions !== undefined ? { controlPositions: input.detailTable.controlPositions } : {}) } } : {}),
+        ...(input.columnWidthsPercent !== undefined ? { columnWidthsPercent: input.columnWidthsPercent } : {}),
+        rowHeight: size(input.rowHeight, 'rowHeight', 30),
+        titleWidthPx: size(input.titleWidthPx, 'titleWidthPx', 180),
+        fieldWidthPx: size(input.fieldWidthPx, 'fieldWidthPx', 180),
+        ...(input.coverFileId !== undefined ? { coverFileId: String(input.coverFileId) } : {}),
+        ...(input.cssSource !== undefined ? { cssSource: input.cssSource } : {}),
+        ...(input.layoutStyle !== undefined ? { layoutStyle: validateAdvancedLayoutStylePatch(input.layoutStyle) } : {}),
+        ...(input.grid !== undefined ? { grid: validateAdvancedGridPatch(input.grid) } : {}) };
+}
+const hex = () => randomBytes(16).toString('hex');
+const nodeId = () => randomBytes(9).toString('base64url');
+/** 只取设计器提供的主表占位字段身份，不继承任何现成模板的样式。 */
+export function buildMinimalAdvancedLayout(scaffold, input) {
+    const design = validateMinimalAdvancedDesign(input);
+    const page = scaffold?.layoutInfo?.pageLayouts?.[0];
+    const palette = scaffold?.fields?.flatMap((group) => group.comps || []) || [];
+    const field = palette.find((comp) => comp.tcomId === 'main_field1' && comp.type === 'FakeField');
+    const fieldRows = design.fieldRows || [Array.from({ length: design.fieldPairsPerRow || 1 }, (_, i) => (i + 1))];
+    const pairCount = design.fieldPlacements?.length || fieldRows.flat().length;
+    const maxSlots = Math.max(...fieldRows.map(row => row.length));
+    for (let i = 2; i <= pairCount; i++)
+        if (!palette.some((comp) => comp.tcomId === `main_field${i}` &&
+            comp.type === 'FakeField' && comp.associatedId === `main_field${i}`))
+            throw new Error(`平台未提供第 ${i} 组主表字段占位符`);
+    const groupField = palette.find((comp) => comp.tcomId === 'group_name' && comp.type === 'FakeField');
+    const detailField = palette.find((comp) => comp.tcomId === 'main_detailarea' && comp.type === 'DetailTable');
+    if (page?.layoutType !== 'EXCEL' || page?.terminalType !== 'PC' || !field || field.associatedId !== 'main_field1') {
+        throw new Error('平台未提供预期的 PC 表格式新建设计器底稿');
+    }
+    if (design.group && !groupField)
+        throw new Error('平台未提供分组名称占位符');
+    if (design.detailTable && !detailField)
+        throw new Error('平台未提供明细表区域占位符');
+    const position = (row, col) => ({ row, col, parent: 'ROOT', nodeId: nodeId(), nodes: [], linkedNodes: {} });
+    const core = () => ({ refCompId: '', id: hex(), category: String(field.category || '1'),
+        package: String(field.package || '@weapp/formbuilder'), isCover: 0 });
+    const markComp = (id, name, row) => ({
+        ...core(), type: 'RepeatMark', applyStyle: '1',
+        config: { title: name, tcomId: id, type: 'RepeatMark', name,
+            layout: { hidden: false, wrapped: false }, excel: position(row, 0) },
+    });
+    const percentMode = maxSlots >= 2 || Boolean(design.fieldRows) || Boolean(design.fieldPlacements);
+    const lastCol = design.fieldPlacements ? design.columnWidthsPercent.length : percentMode ? maxSlots * 2 + 2 : 10;
+    const mainStartRow = design.group ? 4 : 2;
+    const fieldRow = mainStartRow + 1;
+    const endRow = design.fieldPlacements ? fieldRow + Math.max(...design.fieldPlacements.flatMap(item => [item.title.row, item.field.row])) + 1 : design.fieldRows ? fieldRow + fieldRows.length : mainStartRow + (maxSlots === 2 ? 2 : 3);
+    const groupStart = design.group ? markComp('group_start', '分组开始标识', 2) : undefined;
+    const groupName = design.group ? { ...core(), type: 'FakeField', applyStyle: '1',
+        config: { tcomId: 'group_name', comId: 'group_name', title: '分组名称', type: 'FakeField', name: '分组名称',
+            layout: { hidden: false, wrapped: false }, excel: position(3, 1) } } : undefined;
+    const groupEndRow = design.group ? endRow + 1 : undefined;
+    const groupEnd = design.group ? markComp('group_end', '分组结束标识', groupEndRow) : undefined;
+    const start = markComp('main_repeat_start', '主表字段重复开始标识', mainStartRow);
+    const fieldComps = [];
+    const placements = design.fieldPlacements || fieldRows.flatMap((row, rowOffset) => row.map((pair, slot) => ({ pair,
+        title: { row: rowOffset, col: percentMode ? slot * 2 + 1 : 0 },
+        field: { row: rowOffset, col: percentMode ? slot * 2 + 2 : 1 } })));
+    for (const placement of placements) {
+        const i = placement.pair;
+        const associatedId = `main_field${i}`;
+        fieldComps.push({ ...core(), type: 'InternalTitle',
+            config: { type: 'InternalTitle', name: `主表字段标题${i}`, title: `主表字段标题${i}`, associatedId,
+                layout: { hidden: false, wrapped: false }, excel: position(fieldRow + placement.title.row, placement.title.col) } });
+        fieldComps.push({ ...core(), type: 'FakeField', applyStyle: '1',
+            config: { tcomId: associatedId, title: `主表字段${i}`, type: 'FakeField', name: `主表字段${i}`,
+                associatedId, layout: { hidden: false, wrapped: false }, excel: position(fieldRow + placement.field.row, placement.field.col) } });
+    }
+    const end = markComp('main_repeat_end', '主表字段重复结束标识', endRow);
+    const detailStartRow = design.detailTable ? (groupEndRow ?? endRow) + 2 : undefined;
+    const detailRow = detailStartRow === undefined ? undefined : detailStartRow + 1;
+    const detailEndRow = detailRow === undefined ? undefined : detailRow + 1;
+    const detailStart = design.detailTable ? markComp('detail_repeat_start', '明细表重复开始标识', detailStartRow) : undefined;
+    const detailEnd = design.detailTable ? markComp('detail_repeat_end', '明细表重复结束标识', detailEndRow) : undefined;
+    const defaultControls = {
+        de_titletext: { row: 0, col: 0 }, de_btn: { row: 0, col: 2 },
+        de_checkall: { row: 1, col: 0 }, de_serialtitle: { row: 1, col: 1 },
+        de_title: { row: 2, col: 0 }, de_checksingle: { row: 3, col: 0 },
+        de_serialnum: { row: 3, col: 1 }, de_tail: { row: 4, col: 0 },
+    };
+    const controls = { ...defaultControls, ...(design.detailTable?.controlPositions || {}) };
+    const detailTitlePoint = design.detailTable?.fieldTitlePosition || { row: 1, col: 2 };
+    const detailRepeatPoint = design.detailTable?.fieldRepeatPosition || { row: 3, col: 2 };
+    const detailPoints = [...Object.entries(controls).map(([name, point]) => ({ name, ...point })),
+        { name: 'detail_field_title', ...detailTitlePoint }, { name: 'detail_field_repeat', ...detailRepeatPoint }];
+    if (design.detailTable && new Set(detailPoints.map(p => `${p.row},${p.col}`)).size !== detailPoints.length)
+        throw new Error('明细子网格的系统控件、字段标题和字段迭代不能占用同一单元格');
+    const detailColCount = design.detailTable?.columnWidthsPx?.length ||
+        Math.max(3, ...detailPoints.map(point => point.col + 1));
+    if (design.detailTable && detailPoints.some(point => point.col >= detailColCount))
+        throw new Error('明细子网格中的位置超出 columnWidthsPx 列数');
+    if (design.detailTable && (controls.de_title.row === controls.de_tail.row ||
+        detailPoints.some(point => !['de_title', 'de_tail'].includes(point.name) &&
+            [controls.de_title.row, controls.de_tail.row].includes(point.row))))
+        throw new Error('明细表头、表尾各占独立的一整行');
+    const detailComp = design.detailTable ? { ...core(), type: 'DetailTable', applyStyle: '1',
+        config: { defaultPageSize: '20', duplicatedField: [], showSerial: true, defaultRows: '0', allowAdd: true,
+            totalLine: [], type: 'DetailTable', title: design.detailTable.title || '明细表', required: false,
+            mergedFields: [], tcomId: 'main_detailarea', thArray: [233, 233], maxRows: '', isLayOut: true,
+            mobileScroll: true, allowEdit: true, comId: 'main_detailarea', layoutDetail: ['0', '1'],
+            componentKey: 'DataTable', isImport: false, allowDelete: true, display: true, enableCardEdit: true,
+            frozenColumn: '', enablePaging: false, layout: { hidden: false, wrapped: false },
+            excel: { ...position(detailRow, 1), excelTable: Object.entries(controls).map(([type, point]) => ({ ...point, type })) },
+            requiredRows: '1', pcScroll: true, name: '明细表区域', allowCopy: true, describe: '' } } : undefined;
+    const detailTitle = detailComp ? { ...core(), type: 'FakeField', applyStyle: '1',
+        config: { layout: { hidden: false, wrapped: false }, excel: { ...position(detailTitlePoint.row, detailTitlePoint.col), parent: detailComp.config.excel.nodeId },
+            tcomId: 'detail_field_title', name: '明细表字段标题', title: '明细表字段标题', type: 'FakeField' } } : undefined;
+    const detailRepeat = detailComp ? { ...core(), type: 'FakeField', applyStyle: '1',
+        config: { layout: { hidden: false, wrapped: false }, excel: { ...position(detailRepeatPoint.row, detailRepeatPoint.col), parent: detailComp.config.excel.nodeId },
+            tcomId: design.detailTable?.fieldRepeatDirection === 'vertical' ? 'detail_field_repeat_y' : 'detail_field_repeat_x',
+            t_Type: 'd_repeat', name: design.detailTable?.fieldRepeatDirection === 'vertical' ? '明细表字段纵向迭代' : '明细表字段横向迭代',
+            title: design.detailTable?.fieldRepeatDirection === 'vertical' ? '明细表字段纵向迭代' : '明细表字段横向迭代', type: 'FakeField' } } : undefined;
+    const cell = (row, col, comp) => ({ row: String(row), col: String(col),
+        style: { ...(row >= fieldRow && row < endRow && comp.type === 'FakeField' ? { font: '12px Arial' } : {}),
+            cellType: { allowOverflow: false, comId: comp.id, type: comp.type } } });
+    const sheet = { rows: Array.from({ length: Math.max(11, (detailEndRow ?? groupEndRow ?? endRow) + 1) }, () => ({ size: design.rowHeight, visible: true })),
+        columns: percentMode ? (design.columnWidthsPercent || (maxSlots === 1 ? [4, 18, 74, 4] :
+            maxSlots === 2 ? [4, 12, 34, 12, 34, 4] : maxSlots === 3 ? [2, 10, 21, 10, 21, 10, 21, 5] :
+                [2, 8, 15, 8, 15, 8, 15, 8, 15, 6])).map(size => ({ type: 'percent', size, visible: true }))
+            : Array.from({ length: 10 }, (_, col) => ({ type: 'fixed', size: col === 0 ? design.titleWidthPx : col === 1 ? design.fieldWidthPx : 180, visible: true })),
+        cells: [
+            ...(groupStart ? [cell(2, 0, groupStart), cell(3, 1, groupName)] : []),
+            cell(mainStartRow, 0, start), ...fieldComps.map(comp => cell(comp.config.excel.row, comp.config.excel.col, comp)), cell(endRow, 0, end),
+            ...(groupEnd ? [cell(groupEndRow, 0, groupEnd)] : []),
+            ...(detailStart ? [cell(detailStartRow, 0, detailStart), cell(detailRow, 1, detailComp), cell(detailEndRow, 0, detailEnd)] : [])
+        ],
+        rowCount: 39, columnCount: lastCol,
+        spans: [
+            ...(groupStart ? [{ row: 2, rowCount: 1, col: 0, colCount: lastCol }, { row: groupEndRow, rowCount: 1, col: 0, colCount: lastCol }] : []),
+            { row: mainStartRow, rowCount: 1, col: 0, colCount: lastCol }, { row: endRow, rowCount: 1, col: 0, colCount: lastCol },
+            ...(groupStart ? [{ row: 3, rowCount: 1, col: 1, colCount: lastCol - 2 }] : []),
+            ...placements.flatMap(placement => [placement.title, placement.field].filter(p => 'colSpan' in p &&
+                typeof p.colSpan === 'number' && p.colSpan > 1).map(p => ({ row: fieldRow + p.row,
+                rowCount: 1, col: p.col, colCount: p.colSpan }))),
+            ...(detailStart ? [{ row: detailStartRow, rowCount: 1, col: 0, colCount: lastCol },
+                { row: detailRow, rowCount: 1, col: 1, colCount: lastCol - 2 },
+                { row: detailEndRow, rowCount: 1, col: 0, colCount: lastCol }] : [])
+        ] };
+    if (design.headerTitle) {
+        sheet.rows[0].size = 72;
+        const titleCol = design.headerTitlePlacement === 'content' ? 1 : 0;
+        const titleColCount = design.headerTitlePlacement === 'content' ? lastCol - 2 : lastCol;
+        sheet.cells.unshift({ row: '0', col: String(titleCol), value: '#[formTitle]#',
+            style: { font: '700 20px Arial', hAlign: 1, vAlign: 1 } });
+        sheet.spans.push({ row: 0, rowCount: 1, col: titleCol, colCount: titleColCount });
+    }
+    if (design.sectionTitle) {
+        sheet.rows[1].size = 42;
+        sheet.cells.push({ row: '1', col: '1', value: design.sectionTitle, style: { font: '700 14px Arial' } });
+        sheet.spans.push({ row: 1, rowCount: 1, col: 1, colCount: lastCol - 2 });
+    }
+    const mark = (row, id, name, icon) => ({ row, col: 0, item: { id, name, icon } });
+    const workbook = { Sheet1: sheet };
+    if (detailComp && detailTitle && detailRepeat) {
+        const height = design.detailTable?.rowHeightPx || 30;
+        const detailRowCount = Math.max(5, ...detailPoints.map(point => point.row + 1));
+        workbook[detailComp.id] = { rows: Array.from({ length: detailRowCount }, () => ({ size: height, visible: true })),
+            columns: (design.detailTable?.columnWidthsPx || Array.from({ length: detailColCount }, () => 180)).map(width => ({ type: 'fixed', size: width, visible: true })),
+            cells: [
+                ...Object.entries(controls).map(([type, point]) => ({
+                    row: String(point.row), col: String(point.col), value: null,
+                    style: { cellType: { allowOverflow: false, type } }
+                })),
+                cell(detailTitlePoint.row, detailTitlePoint.col, detailTitle),
+                cell(detailRepeatPoint.row, detailRepeatPoint.col, detailRepeat)
+            ],
+            rowCount: Math.max(40, detailRowCount), columnCount: detailColCount,
+            spans: [...(controls.de_titletext.row === controls.de_btn.row && controls.de_btn.col > controls.de_titletext.col + 1 &&
+                    !detailPoints.some(point => !['de_titletext', 'de_btn'].includes(point.name) &&
+                        point.row === controls.de_titletext.row && point.col > controls.de_titletext.col && point.col < controls.de_btn.col) ?
+                    [{ row: controls.de_titletext.row, rowCount: 1, col: controls.de_titletext.col,
+                            colCount: controls.de_btn.col - controls.de_titletext.col }] : []),
+                { row: controls.de_title.row, rowCount: 1, col: controls.de_title.col, colCount: detailColCount - controls.de_title.col },
+                { row: controls.de_tail.row, rowCount: 1, col: controls.de_tail.col, colCount: detailColCount - controls.de_tail.col }] };
+    }
+    return { pageLayouts: [{ ...page, comps: [
+                    ...(groupStart ? [groupStart, groupName] : []), start, ...fieldComps, end,
+                    ...(groupEnd ? [groupEnd] : []), ...(detailStart ? [detailStart, detailComp, detailEnd, detailTitle, detailRepeat] : [])
+                ],
+                config: { workbook, ebCodeFileTypes: [], dataset: [] } }],
+        marks: {
+            ...(groupStart ? { group_start: mark(2, 'group_start', '分组开始标识', 'Icon-bd-groupstart'),
+                group_end: mark(groupEndRow, 'group_end', '分组结束标识', 'Icon-bd-groupend') } : {}),
+            main_repeat_start: mark(mainStartRow, 'main_repeat_start', '主表字段重复开始标识', 'Icon-bd-formstart'),
+            main_repeat_end: mark(endRow, 'main_repeat_end', '主表字段重复结束标识', 'Icon-bd-formend'),
+            ...(detailStart ? { detail_repeat_start: mark(detailStartRow, 'detail_repeat_start', '明细表重复开始标识', 'Icon-bd-liststart'),
+                detail_repeat_end: mark(detailEndRow, 'detail_repeat_end', '明细表重复结束标识', 'Icon-bd-listend') } : {}),
+        }, formStyle: { styleConfig: JSON.stringify({ formLayout: { typeSetting: { readOnlyType: 'disabled' } } }) } };
+}
+export function verifyMinimalAdvancedLayout(layout) {
+    const page = layout?.pageLayouts?.[0], sheet = page?.config?.workbook?.Sheet1;
+    if (page?.layoutType !== 'EXCEL' || page?.terminalType !== 'PC' || !sheet || !Array.isArray(page.comps))
+        return false;
+    const marks = layout.marks || {};
+    if (!marks.main_repeat_start || !marks.main_repeat_end)
+        return false;
+    const group = Boolean(marks.group_start || marks.group_end);
+    const detail = Boolean(marks.detail_repeat_start || marks.detail_repeat_end);
+    if (group && (!marks.group_start || !marks.group_end))
+        return false;
+    if (detail && (!marks.detail_repeat_start || !marks.detail_repeat_end))
+        return false;
+    if (Object.keys(marks).length !== 2 + (group ? 2 : 0) + (detail ? 2 : 0))
+        return false;
+    const kinds = page.comps.map((c) => `${c.type}:${c.config?.tcomId || c.config?.associatedId || ''}`);
+    const fieldComps = page.comps.filter((comp) => comp.type === 'InternalTitle' ||
+        (comp.type === 'FakeField' && /^main_field[1-4]$/.test(comp.config?.tcomId || '')));
+    const pairIds = fieldComps.filter((comp) => comp.type === 'InternalTitle').map((comp) => comp.config?.associatedId);
+    if (!pairIds.length || pairIds.length > 4 || new Set(pairIds).size !== pairIds.length ||
+        pairIds.some((_, index) => !pairIds.includes(`main_field${index + 1}`)))
+        return false;
+    const expected = [...(group ? ['RepeatMark:group_start', 'FakeField:group_name'] : []), 'RepeatMark:main_repeat_start'];
+    for (const id of pairIds)
+        expected.push(`InternalTitle:${id}`, `FakeField:${id}`);
+    expected.push('RepeatMark:main_repeat_end');
+    if (group)
+        expected.push('RepeatMark:group_end');
+    if (detail)
+        expected.push('RepeatMark:detail_repeat_start', 'DetailTable:main_detailarea', 'RepeatMark:detail_repeat_end', 'FakeField:detail_field_title', kinds.includes('FakeField:detail_field_repeat_y') ? 'FakeField:detail_field_repeat_y' : 'FakeField:detail_field_repeat_x');
+    if (kinds.join('|') !== expected.join('|'))
+        return false;
+    for (const comp of page.comps) {
+        const target = comp.config?.excel?.parent === 'ROOT' ? sheet : page.config.workbook[page.comps.find((item) => item.type === 'DetailTable' && item.config?.excel?.nodeId === comp.config?.excel?.parent)?.id];
+        const cell = target?.cells?.find((c) => Number(c.row) === Number(comp.config.excel.row) && Number(c.col) === Number(comp.config.excel.col));
+        if (!cell || cell.style?.cellType?.comId !== comp.id)
+            return false;
+    }
+    return true;
+}
+export class AdvancedTemplateService {
+    client;
+    baseUrl;
+    constructor(client, baseUrl) {
+        this.client = client;
+        this.baseUrl = baseUrl;
+    }
+    url(path) { return `${this.baseUrl}${ROOT}/${path}`; }
+    async scaffold() {
+        return result(await this.client.post(this.url('getTemplateAdvancedDesigner'), { id: '-1', module: MODULE }), '读取高级模板新建设计器');
+    }
+    async list() {
+        const rows = [];
+        let pageNo = 1;
+        while (true) {
+            const data = result(await this.client.post(this.url('listTemplateAdvancedByPage'), {
+                pageNo, pageSize: 100, clientType: '0', module: MODULE,
+            }), '查询高级模板');
+            if (!Array.isArray(data?.result))
+                throw new Error('高级模板列表格式未知');
+            rows.push(...data.result);
+            if (rows.length >= Number(data.totalCount || 0))
+                break;
+            if (!data.result.length || ++pageNo > 1000)
+                throw new Error('高级模板分页提前结束');
+        }
+        return rows.map(row => ({ id: String(row.id), templateName: String(row.templateName || ''),
+            system: String(row.isSys) === '1', ...(row.templateStatus === undefined ? {} : { status: Number(row.templateStatus) }) }));
+    }
+    async customTargets(ids) {
+        if (!ids.length || ids.some(id => !/^[1-9]\d*$/.test(id)) || new Set(ids).size !== ids.length)
+            throw new Error('请提供不重复的高级模板 ID');
+        const all = await this.list();
+        return ids.map(id => {
+            const item = all.find(row => row.id === id);
+            if (!item)
+                throw new Error(`高级模板 ${id} 不存在于当前模板列表`);
+            if (item.system)
+                throw new Error(`系统高级模板 ${id} 不能修改或删除`);
+            return item;
+        });
+    }
+    async setStatus(ids, status) {
+        if (status !== 0 && status !== 1)
+            throw new Error('templateStatus 只能是 0 或 1');
+        await this.customTargets(ids);
+        const response = result(await this.client.post(this.url('batchUpdateAdvancedStatus'), {
+            templateIdList: ids, templateStatus: status,
+        }), '更新高级模板状态');
+        if (Number(response?.executeNum) !== ids.length)
+            throw new Error('模板状态操作数量与请求不一致，请重新查询');
+        const after = await this.list();
+        if (ids.some(id => after.find(row => row.id === id)?.status !== status))
+            throw new Error('模板状态回读不一致，请重新查询');
+        return { ids, status, verified: true };
+    }
+    async delete(ids) {
+        await this.customTargets(ids);
+        const check = result(await this.client.post(this.url('batchDeleteAdvancedCheck'), { templateIdList: ids }), '检查高级模板删除');
+        if (!check || typeof check.check !== 'string' || !/可以删除|可删除/.test(check.check) || /不可以删除|不能删除|不可删除/.test(check.check))
+            throw new Error(`高级模板未通过删除检查：${check?.check || '结果未知'}`);
+        result(await this.client.post(this.url('batchDeleteTemplateAdvanced'), { templateIdList: ids }), '删除高级模板');
+        const after = await this.list();
+        if (ids.some(id => after.some(row => row.id === id)))
+            throw new Error('高级模板删除后仍出现在列表中');
+        return { ids, verified: true };
+    }
+    async get(id) {
+        const data = result(await this.client.post(this.url('getTemplateAdvancedDesigner'), { id, module: MODULE }), '读取高级模板');
+        if (String(data?.id) !== id)
+            throw new Error('高级模板回读 ID 不一致');
+        return data;
+    }
+    async showCss(id) {
+        const data = await this.get(id);
+        const code = decodeLayoutCode(data.layoutInfo?.pageLayouts?.[0]?.sourceCode?.ecode);
+        return { id, cssSource: code.css.content, compiledCss: code.css.compiledContent };
+    }
+    async copySaved(sourceId, templateName) {
+        const source = await this.get(sourceId);
+        if (source.layoutInfo?.pageLayouts?.[0]?.layoutType !== 'EXCEL' ||
+            source.layoutInfo?.pageLayouts?.[0]?.terminalType !== 'PC')
+            throw new Error('只能复制高级 PC 表格式模板');
+        const nameOk = result(await this.client.post(this.url('checkTemplateAdvancedName'), {
+            id: sourceId, templateName, templateLabelObj: '', clientType: '0', module: MODULE,
+        }), '校验高级模板名称');
+        if (nameOk !== true)
+            throw new Error(`模板名称不可用：${templateName}`);
+        const copied = result(await this.client.post(this.url('copyTemplateAdvanced'), {
+            id: sourceId, showOrder: source.showOrder ?? 999999, templateName,
+            templateStatus: source.templateStatus ?? 1, templateImgDef: source.templateImgDef || '',
+            clientType: '0', src: 'copy', module: MODULE,
+        }), '复制高级模板');
+        if (copied !== true)
+            throw new Error('复制结果不确定；先按名称查询，避免重复创建');
+        const matches = (await this.list()).filter(item => item.templateName === templateName && item.id !== sourceId);
+        if (matches.length !== 1)
+            throw new Error(`无法唯一确定复制模板 ${templateName} 的 ID；请按名称查询`);
+        const id = matches[0].id;
+        const clone = await this.get(id);
+        if (clone.layoutInfo?.pageLayouts?.[0]?.comps?.length !== source.layoutInfo.pageLayouts[0].comps.length)
+            throw new Error(`复制模板 ${id} 的组件结构回读不一致`);
+        const css = decodeLayoutCode(source.layoutInfo.pageLayouts[0].sourceCode?.ecode).css.content;
+        if (css)
+            await this.saveCss(id, css);
+        return id;
+    }
+    async copy(id, templateName) {
+        if (typeof templateName !== 'string' || !templateName.trim() || templateName.length > 100)
+            throw new Error('templateName 必须是 1–100 字的名称');
+        const newId = await this.copySaved(id, templateName.trim());
+        const preview = result(await this.client.post(`${this.baseUrl}/api/form/local/initLayout`, {
+            initMode: 0, styleTemplateType: 1, styleTemplateId: newId, generateCollapse: false, layoutType: 'EXCEL', module: MODULE,
+        }), '生成高级模板布局预览');
+        if (!Array.isArray(preview?.pageLayouts))
+            throw new Error(`模板 ${newId} 已复制，但应用预览格式未知`);
+        return { id: newId, verified: true, preview: { persisted: false, pageCount: preview.pageLayouts.length } };
+    }
+    async saveCss(id, cssSource) {
+        const source = await this.get(id);
+        if (String(source.isSys) === '1')
+            throw new Error('系统模板不能修改');
+        const layoutInfo = structuredClone(source.layoutInfo);
+        const page = layoutInfo?.pageLayouts?.[0];
+        if (page?.layoutType !== 'EXCEL' || page?.terminalType !== 'PC')
+            throw new Error('CSS 源码仅适用于高级 PC 表格式模板');
+        const code = updateCode(decodeLayoutCode(page.sourceCode?.ecode), { css: cssSource }, 'layout', id);
+        if (code.js.pageId !== undefined)
+            code.js.pageId = `if (${id} == String(props.pageId))`;
+        page.sourceCode = { ...(page.sourceCode || {}), ecode: encodeLayoutCode(code) };
+        page.config.ebCodeFileTypes = [...new Set([...(page.config.ebCodeFileTypes || []), 'css'])];
+        const savedId = String(result(await this.client.post(this.url('saveTemplateAdvanced'), {
+            templateName: source.templateName, labelObj: source.labelObj || '{}', clientType: String(source.clientType ?? '0'),
+            ...(source.showOrder !== undefined ? { showOrder: source.showOrder } : {}),
+            ...(source.templateStatus !== undefined ? { templateStatus: source.templateStatus } : {}),
+            ...(source.templateImg !== undefined ? { templateImg: source.templateImg } : {}),
+            layoutInfo, id, module: MODULE,
+        }), '保存高级模板 CSS 源码') || '');
+        if (savedId !== id)
+            throw new Error(`保存返回 ID ${savedId} 与目标模板 ${id} 不一致`);
+        const saved = await this.get(id);
+        const encoded = saved.layoutInfo?.pageLayouts?.[0]?.sourceCode?.ecode;
+        assertDesignerReadableLayoutCode(encoded);
+        const readback = decodeLayoutCode(encoded);
+        if (readback.css.content.replace(/\r\n?/g, '\n') !== code.css.content.replace(/\r\n?/g, '\n') ||
+            readback.css.compiledContent.replace(/\r\n?/g, '\n') !== code.css.compiledContent.replace(/\r\n?/g, '\n'))
+            throw new Error(`模板 ${id} 保存后 CSS 源码回读不一致`);
+    }
+    async updateCss(id, cssSource) {
+        if (typeof cssSource !== 'string')
+            throw new Error('CSS 源码必须是文字');
+        await this.saveCss(id, cssSource);
+        const preview = result(await this.client.post(`${this.baseUrl}/api/form/local/initLayout`, {
+            initMode: 0, styleTemplateType: 1, styleTemplateId: id, generateCollapse: false, layoutType: 'EXCEL', module: MODULE,
+        }), '生成高级模板布局预览');
+        if (!Array.isArray(preview?.pageLayouts))
+            throw new Error(`模板 ${id} 已保存，但应用预览格式未知`);
+        return { id, verified: true, preview: { persisted: false, pageCount: preview.pageLayouts.length } };
+    }
+    async createConfigured(input) {
+        const config = validateAdvancedTemplateCreateConfig(input);
+        if (!('sourceTemplateId' in config) && !('layoutInfo' in config))
+            return this.createMinimal(config);
+        if (config.sourceTemplateId) {
+            const id = await this.copySaved(config.sourceTemplateId, config.templateName);
+            if (config.edits || config.layoutStyle || config.grid || config.coverFileId !== undefined) {
+                const copied = await this.get(id);
+                const layoutInfo = structuredClone(copied.layoutInfo);
+                applyAdvancedLayoutEdits(layoutInfo, config.edits);
+                if (config.layoutStyle)
+                    applyAdvancedLayoutStyle(layoutInfo, config.layoutStyle);
+                if (config.grid)
+                    applyAdvancedGridPatch(layoutInfo, config.grid);
+                const savedId = String(result(await this.client.post(this.url('saveTemplateAdvanced'), {
+                    templateName: copied.templateName, labelObj: copied.labelObj || '{}', clientType: String(copied.clientType ?? '0'),
+                    ...(copied.showOrder !== undefined ? { showOrder: copied.showOrder } : {}),
+                    ...(copied.templateStatus !== undefined ? { templateStatus: copied.templateStatus } : {}),
+                    ...((config.coverFileId ?? copied.templateImg) !== undefined ? { templateImg: config.coverFileId ?? copied.templateImg } : {}),
+                    layoutInfo, id, module: MODULE,
+                }), '保存复制后的高级模板') || '');
+                if (savedId !== id)
+                    throw new Error(`保存返回 ID ${savedId} 与目标模板 ${id} 不一致`);
+                const saved = await this.get(id);
+                if (config.layoutStyle)
+                    verifyAdvancedStylePatch(layoutInfo, saved.layoutInfo);
+                if (config.grid)
+                    verifyAdvancedGridChanges(layoutInfo, saved.layoutInfo, config.grid);
+                verifyAdvancedLayoutEdits(layoutInfo, saved.layoutInfo, config.edits, id);
+            }
+            if (config.cssSource !== undefined)
+                await this.saveCss(id, config.cssSource);
+            const preview = result(await this.client.post(`${this.baseUrl}/api/form/local/initLayout`, {
+                initMode: 0, styleTemplateType: 1, styleTemplateId: id, generateCollapse: false, layoutType: 'EXCEL', module: MODULE,
+            }), '生成高级模板布局预览');
+            if (!Array.isArray(preview?.pageLayouts))
+                throw new Error(`模板 ${id} 已复制，但应用预览格式未知`);
+            return { id, verified: true, preview: { persisted: false, pageCount: preview.pageLayouts.length } };
+        }
+        const source = config.sourceTemplateId ? await this.get(config.sourceTemplateId) : undefined;
+        const layoutInfo = structuredClone(config.layoutInfo || source?.layoutInfo);
+        if (!layoutInfo)
+            throw new Error('模板布局数据缺失');
+        if (plain(layoutInfo.formStyle?.styleConfig))
+            layoutInfo.formStyle.styleConfig = JSON.stringify(layoutInfo.formStyle.styleConfig);
+        applyAdvancedLayoutEdits(layoutInfo, config.edits);
+        if (config.layoutStyle)
+            applyAdvancedLayoutStyle(layoutInfo, config.layoutStyle);
+        if (config.grid)
+            applyAdvancedGridPatch(layoutInfo, config.grid);
+        const pages = layoutInfo.pageLayouts;
+        if (!Array.isArray(pages) || pages.length !== 1 || pages[0]?.layoutType !== 'EXCEL' || pages[0]?.terminalType !== 'PC' ||
+            !pages[0]?.config?.workbook?.Sheet1 || !Array.isArray(pages[0]?.comps))
+            throw new Error('layoutInfo 必须是完整的高级 PC 表格式布局');
+        const nameOk = result(await this.client.post(this.url('checkTemplateAdvancedName'), {
+            id: '-1', templateName: config.templateName, templateLabelObj: {}, clientType: 0, module: MODULE,
+        }), '校验高级模板名称');
+        if (nameOk !== true)
+            throw new Error(`模板名称不可用：${config.templateName}`);
+        const id = String(result(await this.client.post(this.url('saveTemplateAdvanced'), {
+            templateName: config.templateName, labelObj: '{}', clientType: 0, layoutInfo, id: '-1',
+            templateImg: config.coverFileId ?? source?.templateImg ?? '', module: MODULE,
+        }), '保存高级模板') || '');
+        if (!id || id === '-1')
+            throw new Error('保存结果未返回模板 ID；先按名称查询，避免重复创建');
+        const saved = await this.get(id);
+        if (saved.templateName !== config.templateName || saved.layoutInfo?.pageLayouts?.[0]?.comps?.length !== pages[0].comps.length)
+            throw new Error(`模板 ${id} 保存后基本结构回读不一致`);
+        if (config.layoutStyle)
+            verifyAdvancedStylePatch(layoutInfo, saved.layoutInfo);
+        if (config.grid)
+            verifyAdvancedGridChanges(layoutInfo, saved.layoutInfo, config.grid);
+        verifyAdvancedLayoutEdits(layoutInfo, saved.layoutInfo, config.edits, id);
+        const existingCss = decodeLayoutCode(pages[0].sourceCode?.ecode).css.content;
+        if (config.cssSource !== undefined || existingCss)
+            await this.saveCss(id, config.cssSource ?? existingCss);
+        const preview = result(await this.client.post(`${this.baseUrl}/api/form/local/initLayout`, {
+            initMode: 0, styleTemplateType: 1, styleTemplateId: id, generateCollapse: false, layoutType: 'EXCEL', module: MODULE,
+        }), '生成高级模板布局预览');
+        if (!Array.isArray(preview?.pageLayouts) || preview.pageLayouts.length < 1)
+            throw new Error(`模板 ${id} 已保存，但应用预览格式未知`);
+        return { id, verified: true, preview: { persisted: false, pageCount: preview.pageLayouts.length,
+                componentCount: preview.pageLayouts.reduce((n, page) => n + (page.comps?.length || 0), 0) } };
+    }
+    async createMinimal(input) {
+        const design = validateMinimalAdvancedDesign(input);
+        const layoutInfo = buildMinimalAdvancedLayout(await this.scaffold(), design);
+        if (design.layoutStyle)
+            applyAdvancedLayoutStyle(layoutInfo, design.layoutStyle);
+        if (design.grid)
+            applyAdvancedGridPatch(layoutInfo, design.grid);
+        if (!verifyMinimalAdvancedLayout(layoutInfo))
+            throw new Error('最小高级模板结构校验失败');
+        const nameOk = result(await this.client.post(this.url('checkTemplateAdvancedName'), {
+            id: '-1', templateName: design.templateName, templateLabelObj: {}, clientType: 0, module: MODULE,
+        }), '校验高级模板名称');
+        if (nameOk !== true)
+            throw new Error(`模板名称不可用：${design.templateName}`);
+        const id = String(result(await this.client.post(this.url('saveTemplateAdvanced'), {
+            templateName: design.templateName, labelObj: '{}', clientType: 0, layoutInfo, id: '-1', templateImg: design.coverFileId || '', module: MODULE,
+        }), '保存高级模板') || '');
+        if (!id || id === '-1')
+            throw new Error('保存结果未返回模板 ID；先按名称查询，避免重复创建');
+        const saved = await this.get(id);
+        if (!verifyMinimalAdvancedLayout(saved.layoutInfo))
+            throw new Error(`模板 ${id} 保存后结构回读不一致`);
+        if (design.layoutStyle)
+            verifyAdvancedStylePatch(layoutInfo, saved.layoutInfo);
+        if (design.grid)
+            verifyAdvancedGridChanges(layoutInfo, saved.layoutInfo, design.grid);
+        if (design.cssSource !== undefined)
+            await this.saveCss(id, design.cssSource);
+        const preview = result(await this.client.post(`${this.baseUrl}/api/form/local/initLayout`, {
+            initMode: 0, styleTemplateType: 1, styleTemplateId: id, generateCollapse: false, layoutType: 'EXCEL', module: MODULE,
+        }), '生成高级模板布局预览');
+        if (!Array.isArray(preview?.pageLayouts) || preview.pageLayouts.length < 1)
+            throw new Error(`模板 ${id} 已保存，但应用预览格式未知`);
+        return { id, verified: true, preview: { persisted: false, pageCount: preview.pageLayouts.length,
+                componentCount: preview.pageLayouts.reduce((n, page) => n + (page.comps?.length || 0), 0) } };
+    }
+    async updateLayout(id, input) {
+        const patch = validateAdvancedLayoutEditPatch(input);
+        const source = await this.get(id);
+        if (String(source.isSys) === '1')
+            throw new Error('系统模板不能修改');
+        const layoutInfo = structuredClone(source.layoutInfo);
+        applyAdvancedLayoutEdits(layoutInfo, patch.edits);
+        const page = layoutInfo.pageLayouts?.[0];
+        if (page?.layoutType !== 'EXCEL' || page?.terminalType !== 'PC' || !page.config?.workbook?.Sheet1)
+            throw new Error('修改后的布局必须保留高级 PC 表格式主网格');
+        const savedId = String(result(await this.client.post(this.url('saveTemplateAdvanced'), {
+            templateName: source.templateName, labelObj: source.labelObj || '{}', clientType: String(source.clientType ?? '0'),
+            ...(source.showOrder !== undefined ? { showOrder: source.showOrder } : {}),
+            ...(source.templateStatus !== undefined ? { templateStatus: source.templateStatus } : {}),
+            ...(source.templateImg !== undefined ? { templateImg: source.templateImg } : {}),
+            layoutInfo, id, module: MODULE,
+        }), '保存高级模板布局') || '');
+        if (savedId !== id)
+            throw new Error(`保存返回 ID ${savedId} 与目标模板 ${id} 不一致`);
+        const saved = await this.get(id);
+        verifyAdvancedLayoutEdits(layoutInfo, saved.layoutInfo, patch.edits, id);
+        const preview = result(await this.client.post(`${this.baseUrl}/api/form/local/initLayout`, {
+            initMode: 0, styleTemplateType: 1, styleTemplateId: id, generateCollapse: false, layoutType: 'EXCEL', module: MODULE,
+        }), '生成高级模板布局预览');
+        if (!Array.isArray(preview?.pageLayouts) || preview.pageLayouts.length < 1)
+            throw new Error(`模板 ${id} 已保存，但应用预览格式未知`);
+        return { id, verified: true, preview: { persisted: false, pageCount: preview.pageLayouts.length,
+                componentCount: preview.pageLayouts.reduce((n, item) => n + (item.comps?.length || 0), 0) } };
+    }
+    async updateLayoutStyle(id, patch) {
+        validateAdvancedLayoutStylePatch(patch);
+        const source = await this.get(id);
+        if (String(source.isSys) === '1')
+            throw new Error('系统模板不能修改');
+        const layoutInfo = structuredClone(source.layoutInfo);
+        applyAdvancedLayoutStyle(layoutInfo, patch);
+        const savedId = String(result(await this.client.post(this.url('saveTemplateAdvanced'), {
+            templateName: source.templateName, labelObj: source.labelObj || '{}', clientType: String(source.clientType ?? '0'),
+            ...(source.showOrder !== undefined ? { showOrder: source.showOrder } : {}),
+            ...(source.templateStatus !== undefined ? { templateStatus: source.templateStatus } : {}),
+            ...(source.templateImg !== undefined ? { templateImg: source.templateImg } : {}),
+            layoutInfo, id, module: MODULE,
+        }), '保存高级模板布局样式') || '');
+        if (savedId !== id)
+            throw new Error(`保存返回 ID ${savedId} 与目标模板 ${id} 不一致`);
+        const saved = await this.get(id);
+        verifyAdvancedStylePatch(layoutInfo, saved.layoutInfo);
+        const preview = result(await this.client.post(`${this.baseUrl}/api/form/local/initLayout`, {
+            initMode: 0, styleTemplateType: 1, styleTemplateId: id, generateCollapse: false, layoutType: 'EXCEL', module: MODULE,
+        }), '生成高级模板布局预览');
+        if (!Array.isArray(preview?.pageLayouts))
+            throw new Error(`模板 ${id} 已保存，但应用预览格式未知`);
+        return { id, verified: true, preview: { persisted: false, pageCount: preview.pageLayouts.length } };
+    }
+    async updateGrid(id, patch) {
+        validateAdvancedGridPatch(patch);
+        const source = await this.get(id);
+        if (String(source.isSys) === '1')
+            throw new Error('系统模板不能修改');
+        const layoutInfo = structuredClone(source.layoutInfo);
+        applyAdvancedGridPatch(layoutInfo, patch);
+        const savedId = String(result(await this.client.post(this.url('saveTemplateAdvanced'), {
+            templateName: source.templateName, labelObj: source.labelObj || '{}', clientType: String(source.clientType ?? '0'),
+            ...(source.showOrder !== undefined ? { showOrder: source.showOrder } : {}),
+            ...(source.templateStatus !== undefined ? { templateStatus: source.templateStatus } : {}),
+            ...(source.templateImg !== undefined ? { templateImg: source.templateImg } : {}),
+            layoutInfo, id, module: MODULE,
+        }), '保存高级模板网格样式') || '');
+        if (savedId !== id)
+            throw new Error(`保存返回 ID ${savedId} 与目标模板 ${id} 不一致`);
+        const saved = await this.get(id);
+        verifyAdvancedGridChanges(layoutInfo, saved.layoutInfo, patch);
+        const preview = result(await this.client.post(`${this.baseUrl}/api/form/local/initLayout`, {
+            initMode: 0, styleTemplateType: 1, styleTemplateId: id, generateCollapse: false, layoutType: 'EXCEL', module: MODULE,
+        }), '生成高级模板布局预览');
+        if (!Array.isArray(preview?.pageLayouts))
+            throw new Error(`模板 ${id} 已保存，但应用预览格式未知`);
+        return { id, verified: true, preview: { persisted: false, pageCount: preview.pageLayouts.length } };
+    }
+}
+function verifyAdvancedGridChanges(expectedLayout, savedLayout, patch) {
+    for (const scope of ['main', 'detail']) {
+        if (!patch[scope])
+            continue;
+        const expectedBook = expectedLayout.pageLayouts[0].config.workbook;
+        const savedBook = savedLayout.pageLayouts[0].config.workbook;
+        const expectedKey = scope === 'main' ? 'Sheet1' : Object.keys(expectedBook).find(name => name !== 'Sheet1');
+        const savedKey = scope === 'main' ? 'Sheet1' : Object.keys(savedBook).find(name => name !== 'Sheet1');
+        const a = expectedBook[expectedKey], b = savedBook[savedKey];
+        if (!b)
+            throw new Error(`${scope} 网格回读缺失`);
+        for (const row of patch[scope].rowHeights || [])
+            if (b.rows?.[row.row]?.size !== row.px)
+                throw new Error(`${scope} 第 ${row.row} 行高回读不一致`);
+        for (const col of patch[scope].columns || [])
+            if (b.columns?.[col.col]?.type !== col.unit || b.columns?.[col.col]?.size !== col.value)
+                throw new Error(`${scope} 第 ${col.col} 列宽回读不一致`);
+        for (const span of patch[scope].merge || [])
+            if (!b.spans?.some((actual) => actual.row === span.row && actual.col === span.col &&
+                actual.rowCount === span.rowCount && actual.colCount === span.colCount))
+                throw new Error(`${scope} 合并范围回读缺失`);
+        for (const span of patch[scope].split || [])
+            if (b.spans?.some((actual) => actual.row === span.row && actual.col === span.col))
+                throw new Error(`${scope} 拆分范围回读未生效`);
+        for (const change of patch[scope].cells || []) {
+            const expected = a.cells.find((c) => Number(c.row) === change.row && Number(c.col) === change.col);
+            const actual = b.cells.find((c) => Number(c.row) === change.row && Number(c.col) === change.col);
+            if (!actual)
+                throw new Error(`${scope} 单元格 ${change.row},${change.col} 回读缺失`);
+            if ((change.text !== undefined || change.systemParameter !== undefined) && actual.value !== expected.value)
+                throw new Error(`${scope} 单元格 ${change.row},${change.col} 的文字回读不一致`);
+            for (const [name, val] of Object.entries(expected.style))
+                if (name !== 'cellType' && JSON.stringify(actual.style?.[name]) !== JSON.stringify(val))
+                    throw new Error(`${scope} 单元格 ${change.row},${change.col} 的 ${name} 回读不一致`);
+            for (const [side, border] of Object.entries(change.borders || {}))
+                if (border.line === 'none' &&
+                    actual.style?.[`border${side[0].toUpperCase()}${side.slice(1)}`] !== undefined)
+                    throw new Error(`${scope} 单元格 ${change.row},${change.col} 的 ${side} 边框清除未生效`);
+        }
+    }
+}
+function verifyAdvancedStylePatch(expectedLayout, savedLayout) {
+    const expected = JSON.parse(expectedLayout.formStyle.styleConfig);
+    const saved = JSON.parse(savedLayout.formStyle?.styleConfig || '{}');
+    const visit = (a, b, path) => {
+        if (plain(a))
+            for (const [key, value] of Object.entries(a))
+                visit(value, b?.[key], `${path}.${key}`);
+        else if (a !== b)
+            throw new Error(`布局样式回读不一致：${path}`);
+    };
+    visit(expected, saved, 'styleConfig');
+}
+//# sourceMappingURL=form-layout-template-advanced.js.map