weaver-e10-builder 1.5.15 → 1.6.0

package/dist/services/form-layout-document-apply.js

@@ -0,0 +1,82 @@
+import { businessData, environmentOrigin, fieldsHash, layoutRoute, layoutSaveBody, readLayoutContext, snapshotHash } from './form-layout-io.js';
+import { compareFormLayoutValues, previewFormLayoutDocument } from './form-layout-document.js';
+import { assert, clone, digest } from './form-layout-source/schema.js';
+function canonical(layout) {
+    const value = clone(layout);
+    delete value.updateTimeStamp;
+    delete value.formId;
+    delete value.pageLayoutEncodes;
+    delete value.formStyleEncodes;
+    for (const page of value.pageLayouts || [])
+        for (const key of ['updateTime', 'updateTimeStamp', 'pageVersion'])
+            delete page[key];
+    return value;
+}
+/** One save request at most. A lost response is resolved by independent readback, never a retry. */
+export async function applyFormLayoutDocument(client, baseUrl, target, document, reviewed) {
+    assert(reviewed?.schemaVersion === 'e10.layout-document-diff/v1', '需要 document diff 保存的完整差异报告');
+    assert(document?.schemaVersion === 'e10.layout-document/v1', '需要完整布局文档');
+    assert(reviewed.origin === environmentOrigin(baseUrl) && document.origin === reviewed.origin, '文档所属环境与当前环境不同');
+    assert(digest(reviewed.target) === digest(target) && digest(document.target) === digest(target), '文档目标与命令目标不同');
+    assert(reviewed.documentHash === digest(document), '文档在差异预览后发生变化，请重新 document diff');
+    assert(reviewed.canApply && Array.isArray(reviewed.changes) && !reviewed.issues?.length, '差异报告存在冲突，不能应用');
+    const current = await readLayoutContext(client, baseUrl, target);
+    const beforeHash = snapshotHash(current.snapshot);
+    assert(beforeHash === document.snapshotHash && beforeHash === reviewed.snapshotHash, '[LAYOUT_SNAPSHOT_CHANGED] 布局快照在文档导出或预览后变化，请重新导出');
+    assert(fieldsHash(current.fields) === document.fieldHash, '[LAYOUT_FIELDS_CHANGED] 字段定义已变化，请重新导出');
+    const preview = previewFormLayoutDocument(current, document);
+    assert(preview.canApply && preview.formLayoutId === reviewed.formLayoutId &&
+        preview.documentHash === reviewed.documentHash && digest(preview.changes) === digest(reviewed.changes), '当前完整布局差异与已审阅报告不一致，请重新 document diff');
+    if (!preview.changes.length)
+        return { saved: true, saveAccepted: null, mutationStarted: false,
+            recoveredAfterUnknownResult: false, verifiedChanges: 0, fullLayoutVerified: true, differences: [],
+            documentHash: preview.documentHash, beforeSnapshotHash: beforeHash, afterSnapshotHash: beforeHash };
+    const planned = clone(current.snapshot);
+    planned.formLayout = clone(document.formLayout);
+    let error;
+    let saveAccepted = null;
+    try {
+        const response = await client.post(`${baseUrl}${layoutRoute(target, 'saveFormAndLayout')}`, layoutSaveBody(target, planned, true), { ebbusinessid: target.formId });
+        saveAccepted = false;
+        businessData(response, '保存完整布局文档', false);
+        saveAccepted = true;
+    }
+    catch (caught) {
+        error = caught.message;
+    }
+    const differences = [];
+    let afterHash;
+    let verifiedChanges = 0;
+    let fullLayoutVerified = false;
+    try {
+        const after = await readLayoutContext(client, baseUrl, target);
+        afterHash = snapshotHash(after.snapshot);
+        const postDiff = compareFormLayoutValues(canonical(document.formLayout), canonical(after.snapshot.formLayout));
+        differences.push(...postDiff);
+        if (fieldsHash(after.fields) !== fieldsHash(current.fields))
+            differences.push({ path: 'fields.businessConfiguration',
+                before: fieldsHash(current.fields), after: fieldsHash(after.fields) });
+        if (digest(after.snapshot.form) !== digest(current.snapshot.form))
+            differences.push({ path: 'form.businessConfiguration',
+                before: digest(current.snapshot.form), after: digest(after.snapshot.form) });
+        fullLayoutVerified = differences.length === 0;
+        if (fullLayoutVerified)
+            verifiedChanges = preview.changes.length;
+        else
+            for (const change of preview.changes) {
+                let actual = after.snapshot.formLayout;
+                for (const segment of change.segments || [])
+                    actual = actual?.[segment];
+                if (digest(actual ?? null) === digest(change.after))
+                    verifiedChanges++;
+            }
+    }
+    catch (caught) {
+        differences.push({ path: 'independentReadback', before: 'READABLE', after: caught.message });
+    }
+    return { saved: fullLayoutVerified, saveAccepted, mutationStarted: true,
+        recoveredAfterUnknownResult: !!error && fullLayoutVerified, verifiedChanges, fullLayoutVerified,
+        differences: differences.slice(0, 10000), documentHash: preview.documentHash, beforeSnapshotHash: beforeHash,
+        ...(afterHash ? { afterSnapshotHash: afterHash } : {}), ...(error ? { error } : {}) };
+}
+//# sourceMappingURL=form-layout-document-apply.js.map

package/dist/services/form-layout-document-apply.js.map

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

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

@@ -0,0 +1,13 @@
+import type { LayoutContext, LayoutTarget } from './form-layout-source/types.js';
+export interface LayoutDocument {
+    schemaVersion: 'e10.layout-document/v1';
+    target: LayoutTarget;
+    origin: string;
+    snapshotHash: string;
+    fieldHash: string;
+    formLayout: any;
+}
+export declare function exportFormLayoutDocument(context: LayoutContext): LayoutDocument;
+export declare function compareFormLayoutValues(before: any, after: any): any[];
+export declare function previewFormLayoutDocument(context: LayoutContext, input: unknown): any;
+//# sourceMappingURL=form-layout-document.d.ts.map

package/dist/services/form-layout-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-layout-document.d.ts","sourceRoot":"","sources":["../../src/services/form-layout-document.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAGjF,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,wBAAwB,CAAC;IACxC,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,GAAG,CAAC;CACjB;AACD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAI/E;AAuHD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,EAAE,CAItE;AACD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,GAAG,GAAG,CA+CrF"}

package/dist/services/form-layout-document.js

@@ -0,0 +1,228 @@
+import { associatedField, flattenComponents } from './form-layout-source/binding.js';
+import { fieldsHash, snapshotHash } from './form-layout-io.js';
+import { clone, digest } from './form-layout-source/schema.js';
+import { assertDesignerReadableLayoutCode } from './form-code.js';
+export function exportFormLayoutDocument(context) {
+    return { schemaVersion: 'e10.layout-document/v1', target: clone(context.target), origin: context.origin,
+        snapshotHash: snapshotHash(context.snapshot), fieldHash: fieldsHash(context.fields),
+        formLayout: clone(context.snapshot.formLayout) };
+}
+function id(value) { return value === undefined || value === null ? '' : String(value); }
+function coordinate(value) { return typeof value === 'string' && !/^\d+$/.test(value) ? NaN : Number(value); }
+function validPoint(row, col, rows, columns) {
+    const r = coordinate(row), c = coordinate(col);
+    return Number.isInteger(r) && Number.isInteger(c) && r >= 0 && c >= 0 && r < rows && c < columns;
+}
+function inspectStructure(layout, fields) {
+    const issues = [];
+    const pages = layout?.pageLayouts;
+    if (!Array.isArray(pages) || !pages.length)
+        return ['formLayout.pageLayouts 必须是非空数组'];
+    const fieldIds = new Set(fields.map(field => id(field.fieldId)));
+    const pageIds = new Set();
+    const terminals = new Set();
+    for (let pi = 0; pi < pages.length; pi++) {
+        const page = pages[pi], prefix = `pageLayouts[${pi}]`;
+        if (!page || typeof page !== 'object') {
+            issues.push(`${prefix} 必须是对象`);
+            continue;
+        }
+        const pageId = id(page.pageId);
+        if (!pageId || pageIds.has(pageId))
+            issues.push(`${prefix} pageId 缺失或重复`);
+        pageIds.add(pageId);
+        const terminal = id(page.terminalType);
+        if (!terminal || terminals.has(terminal))
+            issues.push(`${prefix} terminalType 缺失或重复`);
+        terminals.add(terminal);
+        if (!Array.isArray(page.comps)) {
+            issues.push(`${prefix}.comps 必须是数组`);
+            continue;
+        }
+        const comps = flattenComponents(page.comps), byId = new Map();
+        for (const comp of comps) {
+            const compId = id(comp?.id);
+            if (!compId || byId.has(compId))
+                issues.push(`${prefix} 组件 ID 缺失或重复 ${compId}`);
+            else
+                byId.set(compId, comp);
+            const fieldId = associatedField(comp);
+            if (fieldId && !fieldIds.has(fieldId) && comp.type !== 'InternalTitle' && comp.type !== 'DetailTable')
+                issues.push(`${prefix} 组件 ${compId} 引用不存在的字段 ${fieldId}`);
+        }
+        if (page.layoutType !== 'EXCEL')
+            continue;
+        const workbook = page.config?.workbook;
+        if (!workbook || typeof workbook !== 'object' || Array.isArray(workbook) || !workbook.Sheet1) {
+            issues.push(`${prefix} 缺少表格式主 workbook`);
+            continue;
+        }
+        const detailByNode = new Map(comps.filter(comp => comp.type === 'DetailTable' && comp.config?.excel?.nodeId)
+            .map(comp => [id(comp.config.excel.nodeId), id(comp.id)]));
+        const linkedCells = new Map();
+        for (const [name, sheet] of Object.entries(workbook)) {
+            const label = `${prefix}.config.workbook[${JSON.stringify(name)}]`;
+            if (!sheet || !Array.isArray(sheet.rows) || !Array.isArray(sheet.columns) || !Array.isArray(sheet.cells) || !Array.isArray(sheet.spans)) {
+                issues.push(`${label} 缺少 rows/columns/cells/spans 数组`);
+                continue;
+            }
+            const rows = coordinate(sheet.rowCount), columns = coordinate(sheet.columnCount);
+            if (!Number.isInteger(rows) || !Number.isInteger(columns) || rows < sheet.rows.length || columns < sheet.columns.length ||
+                rows < 1 || columns < 1 || rows > 2000 || columns > 256)
+                issues.push(`${label} rowCount/columnCount 无效或小于行列尺寸数组`);
+            for (const [axis, entries] of [['rows', sheet.rows], ['columns', sheet.columns]])
+                for (let i = 0; i < entries.length; i++)
+                    if (!Number.isFinite(Number(entries[i]?.size)) || Number(entries[i].size) <= 0)
+                        issues.push(`${label}.${axis}[${i}].size 必须大于 0`);
+            const occupied = new Set();
+            const identicalSpans = new Set();
+            for (let si = 0; si < sheet.spans.length; si++) {
+                const span = sheet.spans[si];
+                const row = coordinate(span?.row), col = coordinate(span?.col);
+                const height = coordinate(span?.rowCount), width = coordinate(span?.colCount);
+                if (!validPoint(row, col, rows, columns) || !Number.isInteger(height) || !Number.isInteger(width) ||
+                    height < 1 || width < 1 || row + height > rows || col + width > columns) {
+                    issues.push(`${label}.spans[${si}] 范围无效`);
+                    continue;
+                }
+                const signature = `${row},${col},${height},${width}`;
+                if (identicalSpans.has(signature))
+                    continue;
+                identicalSpans.add(signature);
+                for (let r = row; r < row + height; r++)
+                    for (let c = col; c < col + width; c++) {
+                        const key = `${r},${c}`;
+                        if (occupied.has(key))
+                            issues.push(`${label}.spans 合并区域重叠 ${key}`);
+                        occupied.add(key);
+                    }
+            }
+            const cells = new Set();
+            for (let ci = 0; ci < sheet.cells.length; ci++) {
+                const cell = sheet.cells[ci], row = coordinate(cell?.row), col = coordinate(cell?.col);
+                if (!validPoint(row, col, rows, columns)) {
+                    issues.push(`${label}.cells[${ci}] 坐标越界`);
+                    continue;
+                }
+                const key = `${row},${col}`;
+                if (cells.has(key))
+                    issues.push(`${label}.cells 重复坐标 ${key}`);
+                cells.add(key);
+                const compId = id(cell?.style?.cellType?.comId);
+                if (!compId)
+                    continue;
+                const comp = byId.get(compId);
+                if (!comp)
+                    issues.push(`${label}.cells[${ci}] 引用不存在的组件 ${compId}`);
+                else {
+                    if (cell.style.cellType.type && cell.style.cellType.type !== comp.type)
+                        issues.push(`${label}.cells[${ci}] 组件类型与 ${compId} 不一致`);
+                    const owner = id(comp.config?.excel?.parent);
+                    const expectedSheet = owner === 'ROOT' ? 'Sheet1' : detailByNode.get(owner);
+                    if (expectedSheet !== name)
+                        issues.push(`${label}.cells[${ci}] 组件 ${compId} 属于其他网格`);
+                    if (coordinate(comp.config?.excel?.row) !== row || coordinate(comp.config?.excel?.col) !== col)
+                        issues.push(`${label}.cells[${ci}] 与组件 ${compId} 坐标不一致`);
+                    const matches = linkedCells.get(compId) || [];
+                    matches.push({ sheet: name, row, col });
+                    linkedCells.set(compId, matches);
+                }
+                if (sheet.spans.some((span) => row >= coordinate(span.row) && row < coordinate(span.row) + coordinate(span.rowCount) &&
+                    col >= coordinate(span.col) && col < coordinate(span.col) + coordinate(span.colCount) &&
+                    (row !== coordinate(span.row) || col !== coordinate(span.col))) && compId)
+                    issues.push(`${label}.cells[${ci}] 组件位于合并区域非左上角`);
+            }
+        }
+        for (const comp of comps.filter(comp => comp.config?.excel)) {
+            const count = linkedCells.get(id(comp.id))?.length || 0;
+            if (count !== 1)
+                issues.push(`${prefix} 组件 ${id(comp.id)} 对应 ${count} 个网格单元格`);
+        }
+    }
+    return [...new Set(issues)];
+}
+function compare(before, after, path, segments, changes, limit) {
+    if (changes.length >= limit)
+        return;
+    if (digest(before === undefined ? null : before) === digest(after === undefined ? null : after))
+        return;
+    if (before && after && typeof before === 'object' && typeof after === 'object' && Array.isArray(before) === Array.isArray(after)) {
+        const keys = Array.isArray(before) ? Array.from({ length: Math.max(before.length, after.length) }, (_, i) => String(i)) :
+            [...new Set([...Object.keys(before), ...Object.keys(after)])].sort();
+        for (const key of keys) {
+            const next = Array.isArray(before) ? `${path}[${key}]` : `${path}.${key}`;
+            compare(before[key], after[key], next, [...segments, key], changes, limit);
+            if (changes.length >= limit)
+                break;
+        }
+    }
+    else
+        changes.push({ path, segments, before: before ?? null, after: after ?? null });
+}
+export function compareFormLayoutValues(before, after) {
+    const changes = [];
+    compare(before, after, 'formLayout', [], changes, 10000);
+    return changes;
+}
+export function previewFormLayoutDocument(context, input) {
+    const issues = [];
+    if (!input || typeof input !== 'object' || Array.isArray(input))
+        throw new Error('布局文档必须是对象');
+    const doc = input;
+    if (doc.schemaVersion !== 'e10.layout-document/v1' || Object.keys(doc).some(key => !['schemaVersion', 'target', 'origin', 'snapshotHash', 'fieldHash', 'formLayout'].includes(key)))
+        throw new Error('布局文档版本或外层属性无效');
+    if (!doc.target || typeof doc.target !== 'object' || Array.isArray(doc.target) ||
+        typeof doc.origin !== 'string' || typeof doc.snapshotHash !== 'string' || typeof doc.fieldHash !== 'string')
+        throw new Error('布局文档缺少目标、环境或快照指纹');
+    if (digest(doc.target) !== digest(context.target))
+        issues.push('文档目标与当前查询目标不同');
+    if (doc.origin !== context.origin)
+        issues.push('文档所属环境与当前环境不同');
+    const currentHash = snapshotHash(context.snapshot);
+    if (doc.snapshotHash !== currentHash)
+        issues.push('布局快照已变化，请重新导出文档');
+    if (doc.fieldHash !== fieldsHash(context.fields))
+        issues.push('字段定义已变化，请重新导出文档');
+    const source = context.snapshot.formLayout, draft = doc.formLayout;
+    if (!draft || typeof draft !== 'object' || Array.isArray(draft))
+        issues.push('formLayout 必须是对象');
+    else {
+        for (const property of ['id', 'multipleLayoutId', 'updateTimeStamp'])
+            if (id(draft[property]) !== id(source[property]))
+                issues.push(`formLayout.${property} 是受保护的布局身份或版本信息`);
+        for (const property of ['formId', 'pageLayoutEncodes', 'formStyleEncodes'])
+            if (digest(draft[property] ?? null) !== digest(source[property] ?? null))
+                issues.push(`formLayout.${property} 是受保护的表单身份或派生信息`);
+        if (!Array.isArray(draft.pageLayouts) || draft.pageLayouts.length !== source.pageLayouts.length)
+            issues.push('pageLayouts 页面数量不可改变');
+        else
+            for (let i = 0; i < source.pageLayouts.length; i++) {
+                const old = source.pageLayouts[i], page = draft.pageLayouts[i];
+                for (const property of ['id', 'pageId', 'layoutType', 'terminalType', 'module', 'createTime', 'updateTime',
+                    'creator', 'tenantKey', 'deleteType', 'pageVersion', 'ecodeVersion'])
+                    if (id(page?.[property]) !== id(old?.[property]))
+                        issues.push(`pageLayouts[${i}].${property} 是受保护的页面身份或版本信息`);
+                if (page?.sourceCode?.ecode !== old?.sourceCode?.ecode) {
+                    try {
+                        assertDesignerReadableLayoutCode(page?.sourceCode?.ecode);
+                    }
+                    catch (error) {
+                        issues.push(`pageLayouts[${i}].sourceCode.ecode ${error.message}`);
+                    }
+                }
+            }
+    }
+    const baselineIssues = inspectStructure(source, context.fields);
+    const draftIssues = inspectStructure(draft, context.fields);
+    const baselineSet = new Set(baselineIssues);
+    const introducedIssues = draftIssues.filter(issue => !baselineSet.has(issue));
+    issues.push(...introducedIssues);
+    const changes = compareFormLayoutValues(source, draft);
+    if (changes.length >= 10000)
+        issues.push('差异超过 10000 项，请缩小本次编辑范围');
+    return { schemaVersion: 'e10.layout-document-diff/v1', target: context.target, origin: context.origin,
+        snapshotHash: currentHash, documentHash: digest(doc), formLayoutId: id(source.id),
+        changes, changeCount: changes.length, baselineIssues, introducedIssues, issues, canApply: issues.length === 0,
+        mutationStarted: false };
+}
+//# sourceMappingURL=form-layout-document.js.map

package/dist/services/form-layout-document.js.map

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

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

@@ -0,0 +1,21 @@
+import { type LayoutClient } from './form-layout-io.js';
+import { type LayoutDiffConfig } from './form-layout-diff.js';
+import type { LayoutTarget } from './form-layout-source/types.js';
+export interface ApplyLayoutEditResult {
+    saved: boolean;
+    saveAccepted: boolean | null;
+    mutationStarted: boolean;
+    recoveredAfterUnknownResult: boolean;
+    verifiedChanges: number;
+    differences: Array<{
+        path: string;
+        expected: any;
+        actual: any;
+    }>;
+    beforeSnapshotHash: string;
+    afterSnapshotHash?: string;
+    error?: string;
+}
+/** Save one reviewed edit against a fresh, identical snapshot; never retry an uncertain POST. */
+export declare function applyFormLayoutEdit(client: LayoutClient, baseUrl: string, target: LayoutTarget, terminal: 'PC' | 'MOBILE', config: LayoutDiffConfig, reviewed: any): Promise<ApplyLayoutEditResult>;
+//# sourceMappingURL=form-layout-edit.d.ts.map

package/dist/services/form-layout-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-layout-edit.d.ts","sourceRoot":"","sources":["../../src/services/form-layout-edit.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAErF,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAoCjF,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,eAAe,EAAE,OAAO,CAAC;IAAC,2BAA2B,EAAE,OAAO,CAAC;IAC7G,eAAe,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;IAC1F,kBAAkB,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACxE;AAED,iGAAiG;AACjG,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EACnG,QAAQ,EAAE,IAAI,GAAG,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA+CpG"}

package/dist/services/form-layout-edit.js

@@ -0,0 +1,103 @@
+import { businessData, environmentOrigin, fieldsHash, layoutRoute, layoutSaveBody, readLayoutContext, snapshotHash } from './form-layout-io.js';
+import { previewFormLayoutDiff } from './form-layout-diff.js';
+import { assert, clone, digest } from './form-layout-source/schema.js';
+import { flattenComponents } from './form-layout-source/binding.js';
+function resolveNativePath(snapshot, path) {
+    const compMatch = /^pageLayouts\[(\d+)\]\.comps\[id=("(?:[^"\\]|\\.)*")\]\.config\.excel\.(row|col)$/.exec(path);
+    if (compMatch) {
+        const page = snapshot.formLayout.pageLayouts[Number(compMatch[1])];
+        const id = JSON.parse(compMatch[2]);
+        const matches = flattenComponents(page?.comps || []).filter((comp) => String(comp.id) === id);
+        assert(matches.length === 1 && matches[0].config?.excel, `组件差异路径不唯一或不存在：${path}`);
+        return { owner: matches[0].config.excel, key: compMatch[3] };
+    }
+    const match = /^pageLayouts\[(\d+)\]\.config\.workbook\[("(?:[^"\\]|\\.)*")\]\.(rows|columns|cells)\[(\d+)\]\.(size|type|row|col|style\.(?:backColor|foreColor|font|textDecoration|hAlign|vAlign|wordWrap|textIndent|borderTop|borderRight|borderBottom|borderLeft))$/.exec(path);
+    assert(match, `差异路径不受支持：${path}`);
+    const [, pageIndex, sheetJson, collection, index, suffix] = match;
+    const page = snapshot.formLayout.pageLayouts[Number(pageIndex)];
+    const sheet = page?.config?.workbook?.[JSON.parse(sheetJson)];
+    const entry = sheet?.[collection]?.[Number(index)];
+    assert(entry, `差异路径目标不存在：${path}`);
+    if (suffix.startsWith('style.')) {
+        assert(collection === 'cells', `样式路径目标不是单元格：${path}`);
+        return { owner: entry.style ??= {}, key: suffix.slice(6) };
+    }
+    assert(collection === 'cells' ? ['row', 'col'].includes(suffix) : ['size', 'type'].includes(suffix), `差异路径属性与目标不匹配：${path}`);
+    return { owner: entry, key: suffix };
+}
+function normalized(value) { return value === undefined ? null : value; }
+function expectedChanges(snapshot, changes) {
+    const next = clone(snapshot);
+    for (const item of changes) {
+        const { owner, key } = resolveNativePath(next, item.path);
+        assert(digest(normalized(owner[key])) === digest(item.before), `差异旧值已变化：${item.path}`);
+        if (item.after === null)
+            delete owner[key];
+        else
+            owner[key] = clone(item.after);
+    }
+    return next;
+}
+/** Save one reviewed edit against a fresh, identical snapshot; never retry an uncertain POST. */
+export async function applyFormLayoutEdit(client, baseUrl, target, terminal, config, reviewed) {
+    assert(reviewed?.schemaVersion === 'e10.layout-diff/v1', '需要 diff 命令保存的差异报告');
+    assert(reviewed.origin === environmentOrigin(baseUrl), '预览所属系统与当前环境不同');
+    assert(digest(reviewed.target) === digest(target), '预览目标与命令目标不同');
+    assert(reviewed.terminal === terminal, '预览终端与命令终端不同');
+    assert(reviewed.configHash === digest(config), '配置在预览后发生变化，请重新预览');
+    assert(reviewed.canApply && Array.isArray(reviewed.changes) && !reviewed.issues?.length, '预览存在冲突，不能应用');
+    const current = await readLayoutContext(client, baseUrl, target);
+    const hash = snapshotHash(current.snapshot);
+    assert(hash === reviewed.snapshotHash, '[LAYOUT_SNAPSHOT_CHANGED] 布局快照在预览后发生变化，请重新 diff');
+    assert(fieldsHash(current.fields) === reviewed.layout?.fieldHash, '[LAYOUT_FIELDS_CHANGED] 字段在预览后发生变化，请重新 diff');
+    const actualPreview = previewFormLayoutDiff(current, terminal, config);
+    assert(actualPreview.canApply && digest(actualPreview.changes) === digest(reviewed.changes) &&
+        actualPreview.pageId === reviewed.pageId && actualPreview.layout.id === reviewed.layout?.id &&
+        actualPreview.layout.multipleLayoutId === reviewed.layout?.multipleLayoutId, '当前差异与已审阅报告不一致，请重新 diff');
+    const planned = expectedChanges(current.snapshot, actualPreview.changes);
+    if (!actualPreview.changes.length)
+        return { saved: true, saveAccepted: null, mutationStarted: false,
+            recoveredAfterUnknownResult: false, verifiedChanges: 0, differences: [], beforeSnapshotHash: hash, afterSnapshotHash: hash };
+    let error;
+    let saveAccepted = null;
+    try {
+        const response = await client.post(`${baseUrl}${layoutRoute(target, 'saveFormAndLayout')}`, layoutSaveBody(target, planned, true), { ebbusinessid: target.formId });
+        saveAccepted = false;
+        businessData(response, '保存布局调整', false);
+        saveAccepted = true;
+    }
+    catch (caught) {
+        error = caught.message;
+    }
+    const differences = [];
+    let afterHash;
+    let verifiedChanges = 0;
+    try {
+        const after = await readLayoutContext(client, baseUrl, target);
+        afterHash = snapshotHash(after.snapshot);
+        if (fieldsHash(after.fields) !== fieldsHash(current.fields))
+            differences.push({ path: 'fields.businessConfiguration', expected: fieldsHash(current.fields), actual: fieldsHash(after.fields) });
+        for (const item of actualPreview.changes) {
+            let actual;
+            try {
+                const { owner, key } = resolveNativePath(after.snapshot, item.path);
+                actual = normalized(owner[key]);
+            }
+            catch {
+                actual = 'PATH_NOT_FOUND';
+            }
+            if (digest(actual) === digest(item.after))
+                verifiedChanges++;
+            else
+                differences.push({ path: item.path, expected: item.after, actual });
+        }
+    }
+    catch (caught) {
+        differences.push({ path: 'independentReadback', expected: 'READABLE', actual: caught.message });
+    }
+    return { saved: differences.length === 0, saveAccepted, mutationStarted: true,
+        recoveredAfterUnknownResult: !!error && differences.length === 0,
+        verifiedChanges, differences, beforeSnapshotHash: hash, ...(afterHash ? { afterSnapshotHash: afterHash } : {}),
+        ...(error ? { error } : {}) };
+}
+//# sourceMappingURL=form-layout-edit.js.map

package/dist/services/form-layout-edit.js.map

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

package/dist/services/form-layout-init-plan.d.ts

@@ -0,0 +1,54 @@
+import { type LayoutClient } from './form-layout-io.js';
+import type { LayoutContext, LayoutTarget } from './form-layout-source/types.js';
+import { type EasyTemplateEvidence, type TemplateEvidence } from './form-layout-template-verification.js';
+export interface LayoutInitOptions {
+    styleTemplate?: string;
+    easyTemplate?: string;
+    readOnly?: boolean;
+    required?: boolean;
+    disableEdit?: boolean;
+    singleRow?: boolean;
+    generateCollapse?: boolean;
+    fields?: LayoutInitFieldOption[];
+}
+export interface LayoutInitFieldOption {
+    fieldId: string;
+    readOnly?: boolean;
+    required?: boolean;
+    disableEdit?: boolean;
+    singleRow?: boolean;
+    display?: boolean;
+    show?: boolean;
+}
+export interface LayoutInitPlan {
+    schemaVersion: 'e10.layout-init-plan/v1';
+    target: LayoutTarget;
+    origin: string;
+    snapshotHash: string;
+    fieldHash: string;
+    configHash: string;
+    optionsHash: string;
+    layoutId: string;
+    layoutMultiId: string;
+    layoutName: string;
+    layoutType: string;
+    template: {
+        id: string;
+        name: string;
+    };
+    overrides: Record<string, boolean>;
+    templateEvidence?: TemplateEvidence | EasyTemplateEvidence;
+    fieldOverrides: LayoutInitFieldOption[];
+    configCount: number;
+    componentCountBefore: number;
+    pageCountBefore: number;
+    affectedAreas: string[];
+    mutationStarted: false;
+}
+export declare function prepareLayoutInit(client: LayoutClient, baseUrl: string, target: LayoutTarget, options: LayoutInitOptions): Promise<{
+    context: LayoutContext;
+    plan: LayoutInitPlan;
+    configs: any[];
+}>;
+export declare function applyLayoutInit(client: LayoutClient, baseUrl: string, target: LayoutTarget, options: LayoutInitOptions, reviewed: LayoutInitPlan): Promise<any>;
+//# sourceMappingURL=form-layout-init-plan.d.ts.map

package/dist/services/form-layout-init-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-layout-init-plan.d.ts","sourceRoot":"","sources":["../../src/services/form-layout-init-plan.ts"],"names":[],"mappings":"AACA,OAAO,EAAgF,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGtI,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAEjF,OAAO,EACL,KAAK,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAKnG,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC7G,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACnF;AACD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/E,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACxD;AACD,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,yBAAyB,CAAC;IAAC,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAC/E,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IACjF,QAAQ,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAChF,QAAQ,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3E,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,oBAAoB,CAAC;IAC3D,cAAc,EAAE,qBAAqB,EAAE,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IAAC,oBAAoB,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAC3E,aAAa,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,KAAK,CAAC;CACjD;AAGD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EACjG,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,GAAG,EAAE,CAAA;CAAE,CAAC,CAqGvG;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAC/F,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,CAkEpE"}