weaver-e10-builder 1.5.10 → 1.5.12

package/dist/services/form-layout-source/image-style.js

@@ -0,0 +1,539 @@
+import { assert, clone, safeTree, stable } from './schema.js';
+import { extent } from './source-grid.js';
+const KEYS = ['color', 'backgroundColor', 'fontFamily', 'fontSize', 'fontUnit', 'fontWeight', 'fontStyle', 'textAlign', 'verticalAlign', 'wordWrap', 'underline', 'height', 'width', 'border', 'borderTop', 'borderBottom', 'borderLeft', 'borderRight', 'align', 'bold'];
+const objectKeys = (v, keys, label) => assert(v && typeof v === 'object' && !Array.isArray(v) && Object.keys(v).every(k => keys.includes(k)), `${label} 包含未支持属性`);
+function nativeFont(value) {
+    if (!value)
+        return undefined;
+    const match = /^(.*?)\s*(\d+(?:\.\d+)?)(px|pt)\s+(.+)$/.exec(value);
+    assert(match, '图片 font 需要字号单位和字体家族，例如 bold 18pt SimSun');
+    const tokens = match[1].trim().split(/\s+/).filter(Boolean);
+    assert(tokens.every(t => ['italic', 'normal', 'bold'].includes(t) || /^[1-9]00$/.test(t)), '图片 font 前缀不支持');
+    const weight = tokens.find(t => t === 'bold' || /^[1-9]00$/.test(t));
+    return normalizeObservedStyle({ fontFamily: match[4], fontSize: Number(match[2]), fontUnit: match[3], fontWeight: weight === 'bold' ? 'bold' : weight ? Number(weight) : 400, fontStyle: tokens.includes('italic') ? 'italic' : 'normal' });
+}
+export function imageColor(value) {
+    const named = { red: '#FF0000', white: '#FFFFFF', black: '#000000', blue: '#0000FF', gray: '#808080', grey: '#808080', green: '#008000' };
+    assert(typeof value === 'string', '图片颜色必须是字符串');
+    const v = value.trim().toLowerCase();
+    if (named[v])
+        return named[v];
+    if (/^#[0-9a-f]{3}$/.test(v))
+        return '#' + v.slice(1).split('').map(c => c + c).join('').toUpperCase();
+    if (/^#[0-9a-f]{6}$/.test(v))
+        return v.toUpperCase();
+    const rgb = /^rgb\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*\)$/.exec(v);
+    assert(rgb && rgb.slice(1).every(n => Number(n) <= 255), `图片颜色无法规范化 ${value}`);
+    return '#' + rgb.slice(1).map(n => Number(n).toString(16).padStart(2, '0')).join('').toUpperCase();
+}
+export function normalizeObservedStyle(input) {
+    safeTree(input);
+    objectKeys(input, KEYS, '图片样式');
+    const s = clone(input);
+    if (s.align !== undefined) {
+        assert(s.textAlign === undefined || s.textAlign === s.align, 'align 与 textAlign 冲突');
+        s.textAlign = s.align;
+        delete s.align;
+    }
+    if (s.bold !== undefined) {
+        assert(typeof s.bold === 'boolean', 'bold 必须是布尔值');
+        const weight = s.bold ? 700 : 400;
+        assert(s.fontWeight === undefined || s.fontWeight === weight || s.fontWeight === (s.bold ? 'bold' : 'normal'), 'bold 与 fontWeight 冲突');
+        s.fontWeight = weight;
+        delete s.bold;
+    }
+    for (const key of ['color', 'backgroundColor'])
+        if (s[key] !== undefined)
+            s[key] = imageColor(s[key]);
+    if (s.fontFamily !== undefined)
+        assert(typeof s.fontFamily === 'string' && s.fontFamily.length > 0 && s.fontFamily.length <= 100 && !/[;{}<>\r\n()]|url|expression/i.test(s.fontFamily), '字体名称无效');
+    if (s.fontSize !== undefined)
+        assert(Number.isFinite(s.fontSize) && s.fontSize >= 1 && s.fontSize <= (s.fontUnit === 'pt' ? 150 : 200), '字号无效');
+    assert(s.fontUnit === undefined || ['px', 'pt'].includes(s.fontUnit) && s.fontSize !== undefined, 'fontUnit 需要字号及 px/pt 单位');
+    if (s.fontWeight !== undefined)
+        assert(['normal', 'bold'].includes(s.fontWeight) || Number.isInteger(s.fontWeight) && s.fontWeight >= 100 && s.fontWeight <= 900 && s.fontWeight % 100 === 0, '字体粗细无效');
+    for (const [key, allowed] of [['fontStyle', ['normal', 'italic']], ['textAlign', ['left', 'center', 'right']], ['verticalAlign', ['top', 'middle', 'bottom']]])
+        assert(s[key] === undefined || allowed.includes(s[key]), `${key} 无效`);
+    for (const key of ['wordWrap', 'underline'])
+        assert(s[key] === undefined || typeof s[key] === 'boolean', `${key} 必须是布尔值`);
+    for (const key of ['height', 'width'])
+        if (s[key] !== undefined)
+            assert(Number.isFinite(s[key]) && s[key] > 0 && s[key] <= 2000, `${key} 无效`);
+    for (const key of ['border', 'borderTop', 'borderBottom', 'borderLeft', 'borderRight'])
+        if (s[key] !== undefined) {
+            const b = s[key];
+            objectKeys(b, ['color', 'width', 'line'], '图片边框');
+            b.color = imageColor(b.color);
+            assert([1, 2, 3].includes(b.width) && ['solid', 'dashed', 'dotted', 'double'].includes(b.line), '边框宽度或线型无效');
+            assert(b.line === 'solid' || b.width <= 2, '非实线边框最多支持宽度 2，不能静默降为细线');
+        }
+    return s;
+}
+function validateImageGeometry(geometry, source) {
+    objectKeys(geometry, ['imageWidth', 'imageHeight', 'sheets'], '图片几何证据');
+    assert([geometry.imageWidth, geometry.imageHeight].every(n => Number.isInteger(n) && n > 0 && n <= 100000), '图片像素尺寸无效');
+    assert(Array.isArray(geometry.sheets) && geometry.sheets.length > 0 && geometry.sheets.length <= source.sheets.length, '图片几何 Sheet 数量无效');
+    const names = new Set();
+    for (const grid of geometry.sheets) {
+        objectKeys(grid, ['sheet', 'xLines', 'yLines', 'regions'], '图片几何网格');
+        const sheet = source.sheets.find(s => s.name === grid.sheet);
+        assert(sheet && !names.has(grid.sheet), '图片几何 Sheet 缺失或重复');
+        names.add(grid.sheet);
+        for (const [lines, count, limit] of [[grid.xLines, sheet.columnCount, geometry.imageWidth], [grid.yLines, sheet.rowCount, geometry.imageHeight]]) {
+            assert(Array.isArray(lines) && lines.length === count + 1 && lines.every((n, i) => Number.isFinite(n) && n >= 0 && n <= limit && (!i || n > lines[i - 1] && n - lines[i - 1] <= 10000)), '图片边界坐标必须严格递增、匹配行列数且位于原图内');
+        }
+        assert(sheet.rowCount * sheet.columnCount <= 100000 && Array.isArray(grid.regions) && grid.regions.length <= 100000, '图片几何区域数量超限');
+        const occupied = new Set();
+        for (const region of grid.regions) {
+            objectKeys(region, ['row', 'col', 'rowCount', 'colCount', 'style'], '图片可见区域');
+            assert([region.row, region.col, region.rowCount, region.colCount].every(Number.isInteger) && region.row >= 0 && region.col >= 0 && region.rowCount > 0 && region.colCount > 0 && region.row + region.rowCount <= sheet.rowCount && region.col + region.colCount <= sheet.columnCount, '图片可见区域越界');
+            if (region.style) {
+                const style = normalizeObservedStyle(region.style);
+                assert(style.width === undefined && style.height === undefined, '图片区域尺寸由像素边界决定');
+            }
+            for (let r = region.row; r < region.row + region.rowCount; r++)
+                for (let c = region.col; c < region.col + region.colCount; c++) {
+                    const key = `${r},${c}`;
+                    assert(!occupied.has(key), '图片可见区域重叠');
+                    occupied.add(key);
+                }
+        }
+        assert(occupied.size === sheet.rowCount * sheet.columnCount, '图片区域分割不完整：空白区域也必须描述，不能遗漏合并和值区域');
+    }
+}
+/** 像素边界是几何来源，不从字段数或默认两字段模板推定网格。 */
+export function geometrySheet(source, selected, mergedAnchorBorders = false, preserveBorders = false) {
+    const sheet = clone(selected), geometry = source.imageStyles?.geometry;
+    if (!geometry)
+        return sheet;
+    validateImageGeometry(geometry, source);
+    const grid = geometry.sheets.find(s => s.sheet === sheet.name);
+    if (!grid)
+        return sheet;
+    assert(sheet.rows.every(r => r.visible) && sheet.columns.every(c => c.visible), '图片像素网格不接受隐藏行列');
+    sheet.columns = grid.xLines.slice(1).map((x, i) => ({ size: x - grid.xLines[i], visible: true }));
+    sheet.rows = grid.yLines.slice(1).map((y, i) => ({ size: y - grid.yLines[i], visible: true }));
+    sheet.spans = grid.regions.filter(r => r.rowCount > 1 || r.colCount > 1).map(({ row, col, rowCount, colCount }) => ({ row, col, rowCount, colCount }));
+    const cells = new Map(sheet.cells.map(c => [`${Number(c.row)},${Number(c.col)}`, c]));
+    const get = (r, c) => { const key = `${r},${c}`; if (!cells.has(key)) {
+        const cell = { row: String(r), col: String(c), style: {} };
+        sheet.cells.push(cell);
+        cells.set(key, cell);
+    } return cells.get(key); };
+    for (const region of grid.regions) {
+        const native = observedNative(region.style || {}, get(region.row, region.col).style || {});
+        if (preserveBorders) {
+            const anchor = get(region.row, region.col), anchorStyle = clone(anchor.style || {});
+            const perimeter = [];
+            for (let r = region.row; r < region.row + region.rowCount; r++)
+                for (let c = region.col; c < region.col + region.colCount; c++) {
+                    const cell = get(r, c);
+                    assert(cell === anchor || (!cell.formula && (cell.value === undefined || cell.value === '')), '图片合并区域覆盖了非锚点文字或公式，必须修正观察和映射');
+                    for (const [key, edge] of [['borderTop', r === region.row], ['borderBottom', r === region.row + region.rowCount - 1], ['borderLeft', c === region.col], ['borderRight', c === region.col + region.colCount - 1]]) {
+                        const border = native[key] || cell.style?.[key] || (key === 'borderRight' || key === 'borderBottom' ? anchorStyle[key] : undefined);
+                        if (edge && border)
+                            perimeter.push({ row: r, col: c, key, border: clone(border) });
+                    }
+                }
+            for (let r = region.row; r < region.row + region.rowCount; r++)
+                for (let c = region.col; c < region.col + region.colCount; c++) {
+                    const cell = get(r, c);
+                    cell.style ||= {};
+                    for (const key of ['borderTop', 'borderBottom', 'borderLeft', 'borderRight'])
+                        delete cell.style[key];
+                }
+            const { borderTop, borderBottom, borderLeft, borderRight, ...text } = native;
+            Object.assign(anchor.style, text);
+            for (const edge of perimeter)
+                get(edge.row, edge.col).style[edge.key] = edge.border;
+            if (mergedAnchorBorders)
+                for (const [key, count] of [['borderBottom', region.colCount], ['borderRight', region.rowCount]]) {
+                    const edges = perimeter.filter(e => e.key === key);
+                    if (edges.length === count && edges.every(e => stable(e.border) === stable(edges[0].border)))
+                        anchor.style[key] = clone(edges[0].border);
+                }
+            continue;
+        }
+        for (let r = region.row; r < region.row + region.rowCount; r++)
+            for (let c = region.col; c < region.col + region.colCount; c++) {
+                const cell = get(r, c);
+                cell.style ||= {};
+                const anchor = r === region.row && c === region.col;
+                assert(anchor || (!cell.formula && (cell.value === undefined || cell.value === '')), '图片合并区域覆盖了非锚点文字或公式，必须修正观察和映射');
+                for (const key of ['borderTop', 'borderBottom', 'borderLeft', 'borderRight'])
+                    delete cell.style[key];
+                if (anchor) {
+                    const { borderTop, borderBottom, borderLeft, borderRight, ...text } = native;
+                    Object.assign(cell.style, text);
+                    if (mergedAnchorBorders && region.rowCount > 1 && borderBottom)
+                        cell.style.borderBottom = clone(borderBottom);
+                    if (mergedAnchorBorders && region.colCount > 1 && borderRight)
+                        cell.style.borderRight = clone(borderRight);
+                }
+                for (const [key, edge] of [['borderTop', r === region.row], ['borderBottom', r === region.row + region.rowCount - 1], ['borderLeft', c === region.col], ['borderRight', c === region.col + region.colCount - 1]])
+                    if (edge && native[key])
+                        cell.style[key] = clone(native[key]);
+            }
+    }
+    return sheet;
+}
+export function validateImageStyles(profile, source) {
+    safeTree(profile);
+    objectKeys(profile, ['schemaVersion', 'componentStyles', 'geometry', 'page', 'cells', 'fields', 'issues', 'notes', 'tableBorders'], '图片样式观察');
+    assert(source.sourceType === 'image' && profile.schemaVersion === 'e10.image-styles/v1', '样式观察只用于图片，版本必须为 e10.image-styles/v1');
+    if (profile.geometry)
+        validateImageGeometry(profile.geometry, source);
+    assert(profile.tableBorders === undefined || Array.isArray(profile.tableBorders) && profile.tableBorders.length <= 1000, '表格外框观察数量超限');
+    for (const table of profile.tableBorders || []) {
+        objectKeys(table, ['sheet', 'row', 'col', 'rowCount', 'colCount', 'top', 'right', 'bottom', 'left'], '表格外框观察');
+        const sheet = source.sheets.find(s => s.name === table.sheet);
+        assert(sheet && [table.row, table.col, table.rowCount, table.colCount].every(Number.isInteger) && table.row >= 0 && table.col >= 0 && table.rowCount > 0 && table.colCount > 0 && table.row + table.rowCount <= sheet.rowCount && table.col + table.colCount <= sheet.columnCount, '表格外框必须明确正文范围且位于源网格内');
+        for (const side of ['top', 'right', 'bottom', 'left']) {
+            assert(table[side] !== undefined, '表格外框必须逐侧记录 top/right/bottom/left，未知用 unknown，无边框用 none');
+            if (table[side] !== 'none' && table[side] !== 'unknown')
+                normalizeObservedStyle({ border: table[side] });
+        }
+    }
+    assert(profile.componentStyles === undefined || ['merge', 'replace', 'workbookOnly'].includes(profile.componentStyles), '组件样式策略无效');
+    assert(Array.isArray(profile.issues) && profile.issues.length <= 1000 && profile.issues.every(s => typeof s === 'string' && s.length > 0), '图片样式 issues 无效');
+    assert(profile.notes === undefined || Array.isArray(profile.notes) && profile.notes.length <= 1000 && profile.notes.every(s => typeof s === 'string' && s.length > 0), '图片样式 notes 无效');
+    if (profile.page) {
+        objectKeys(profile.page, ['backgroundColor'], '页面样式');
+        imageColor(profile.page.backgroundColor);
+    }
+    assert(profile.cells === undefined || Array.isArray(profile.cells) && profile.cells.length <= 100000, '图片单元格样式数量超限');
+    const positions = new Set();
+    for (const c of profile.cells || []) {
+        objectKeys(c, ['sheet', 'row', 'col', 'style'], '图片单元格样式');
+        const sheet = source.sheets.find(s => s.name === c.sheet);
+        assert(sheet && Number.isInteger(c.row) && Number.isInteger(c.col) && c.row >= 0 && c.row < sheet.rowCount && c.col >= 0 && c.col < sheet.columnCount, '图片样式位置超出网格');
+        extent(sheet, { row: c.row, col: c.col });
+        const key = `${c.sheet}:${c.row},${c.col}`;
+        assert(!positions.has(key), '重复图片样式位置');
+        positions.add(key);
+        const style = normalizeObservedStyle(c.style);
+        assert(style.height === undefined && style.width === undefined, '网格高度和宽度应通过 rows/columns 描述');
+    }
+    assert(profile.fields === undefined || Array.isArray(profile.fields) && profile.fields.length <= 1000, '图片字段样式数量超限');
+    for (const f of profile.fields || []) {
+        objectKeys(f, ['fieldId', 'fieldName', 'subFormId', 'displayTitle', 'inputTarget', 'title', 'content', 'input', 'textArea'], '图片字段样式');
+        assert(typeof f.fieldId === 'string' && /^[1-9]\d*$/.test(f.fieldId) || typeof f.fieldName === 'string' && f.fieldName.length > 0, '图片字段样式需要精确字段身份');
+        assert(f.subFormId === undefined || typeof f.subFormId === 'string' && /^[1-9]\d*$/.test(f.subFormId), '图片字段样式明细身份无效');
+        assert(f.title || f.content || f.input || f.textArea || f.displayTitle, '图片字段样式不能为空');
+        if (f.displayTitle !== undefined)
+            assert(typeof f.fieldId === 'string' && typeof f.displayTitle === 'string' && f.displayTitle.trim() === f.displayTitle && f.displayTitle.length > 0 && f.displayTitle.length <= 200 && !/[<>\r\n]/.test(f.displayTitle), '展示标题必须绑定真实 fieldId，且为纯文本');
+        assert(f.inputTarget === undefined || !!f.input && ['component', 'cell'].includes(f.inputTarget), 'inputTarget 必须有 input 样式且为 component/cell');
+        if (f.inputTarget === 'cell')
+            assert(f.input.height === undefined && f.input.width === undefined, '单元格投影不接受输入框宽高；网格尺寸用 geometry 或 rows/columns');
+        assert(profile.componentStyles !== 'workbookOnly' || !f.input || f.inputTarget === 'cell', 'workbookOnly 下 input 必须显式选择 cell；不能静默丢弃控件样式');
+        if (f.textArea) {
+            objectKeys(f.textArea, ['rows', 'fitCell', 'autoHeight'], '多行文本展示');
+            assert(Number.isInteger(f.textArea.rows) && f.textArea.rows > 0 && f.textArea.rows <= 50, '多行文本 rows 必须为 1～50');
+            for (const key of ['fitCell', 'autoHeight'])
+                assert(f.textArea[key] === undefined || typeof f.textArea[key] === 'boolean', `多行文本 ${key} 必须为布尔值`);
+        }
+        for (const style of [f.title, f.content, f.input])
+            if (style)
+                normalizeObservedStyle(style);
+        for (const style of [f.title, f.content])
+            if (style)
+                assert(style.height === undefined && style.width === undefined, '标题/内容区域宽高使用 rows/columns；输入框尺寸使用 input');
+        if (f.input)
+            assert(!Object.keys(f.input).some(k => ['color', 'fontFamily', 'fontSize', 'fontUnit', 'fontWeight', 'fontStyle', 'textAlign', 'align', 'bold', 'verticalAlign', 'wordWrap', 'underline', 'borderTop', 'borderBottom', 'borderLeft', 'borderRight'].includes(k)), 'input 仅描述文本框外观和统一 border；文字样式用 content，分边边框用单元格样式');
+    }
+}
+export function observedCss(input) {
+    const s = normalizeObservedStyle(input), css = {};
+    for (const [from, to] of [['color', 'color'], ['backgroundColor', 'background-color'], ['fontFamily', 'font-family'], ['fontStyle', 'font-style'], ['textAlign', 'text-align']])
+        if (s[from] !== undefined)
+            css[to] = s[from];
+    if (s.fontSize !== undefined)
+        css['font-size'] = `${Number((s.fontSize * (s.fontUnit === 'pt' ? 96 / 72 : 1)).toFixed(1))}px`;
+    if (s.fontWeight !== undefined)
+        css['font-weight'] = String(s.fontWeight === 'bold' ? 700 : s.fontWeight === 'normal' ? 400 : s.fontWeight);
+    for (const key of ['height', 'width'])
+        if (s[key] !== undefined)
+            css[key] = `${s[key]}px`;
+    if (s.border)
+        css.border = `${s.border.width}px ${s.border.line} ${s.border.color}`;
+    // 网格对齐/换行由 SpreadJS 承载；不向原生组件传未登记的 CSS 属性。
+    return css;
+}
+export function observedNative(input, existing = {}) {
+    const s = normalizeObservedStyle(input), native = {};
+    if (s.color !== undefined)
+        native.foreColor = s.color;
+    if (s.backgroundColor !== undefined)
+        native.backColor = s.backgroundColor;
+    const oldFont = nativeFont(existing.font);
+    const hasFont = [s.fontSize, s.fontFamily, s.fontWeight, s.fontStyle].some(v => v !== undefined);
+    const size = s.fontSize !== undefined ? Number((s.fontSize * (s.fontUnit === 'pt' ? 96 / 72 : 1)).toFixed(1)) : oldFont ? Number((oldFont.fontSize * (oldFont.fontUnit === 'pt' ? 96 / 72 : 1)).toFixed(1)) : undefined;
+    if (hasFont && size !== undefined) {
+        const weight = s.fontWeight ?? oldFont?.fontWeight ?? 400, fontStyle = s.fontStyle ?? oldFont?.fontStyle;
+        native.font = `${fontStyle === 'italic' ? 'italic ' : ''}${weight === 'bold' ? 700 : weight === 'normal' ? 400 : weight} ${size}px ${s.fontFamily || oldFont?.fontFamily || 'sans-serif'}`;
+    }
+    if (s.textAlign !== undefined)
+        native.hAlign = ['left', 'center', 'right'].indexOf(s.textAlign);
+    if (s.verticalAlign !== undefined)
+        native.vAlign = ['top', 'middle', 'bottom'].indexOf(s.verticalAlign);
+    if (s.wordWrap !== undefined)
+        native.wordWrap = s.wordWrap;
+    if (s.underline !== undefined)
+        native.textDecoration = s.underline ? 1 : 0;
+    for (const key of ['borderTop', 'borderBottom', 'borderLeft', 'borderRight']) {
+        const b = s[key] || s.border;
+        if (!b)
+            continue;
+        native[key] = { color: b.color, style: b.line === 'solid' ? ({ 1: 1, 2: 2, 3: 5 }[b.width]) : b.line === 'dashed' && b.width === 2 ? 8 : ({ dashed: 3, dotted: 4, double: 6 }[b.line]) };
+    }
+    return native;
+}
+/** 图像单元格键别名规范化，仅在 extract 图片入口使用，Excel 与旧产物不变。 */
+export function normalizeImageCells(source) {
+    const copy = clone(source);
+    safeTree(copy);
+    copy.imageStyles ??= { schemaVersion: 'e10.image-styles/v1', issues: [] };
+    const initialRules = copy.imageStyles.cells || (copy.imageStyles.cells = []);
+    assert(Array.isArray(initialRules), '图片单元格样式必须为数组');
+    const ruleIndex = new Map(initialRules.map(r => [`${r.sheet}:${r.row},${r.col}`, r]));
+    for (const sheet of copy.sheets || [])
+        for (const cell of sheet.cells || []) {
+            const style = cell.style || {}, semantic = {};
+            for (const key of KEYS)
+                if (style[key] !== undefined && !['wordWrap', 'borderTop', 'borderBottom', 'borderLeft', 'borderRight', 'underline'].includes(key)) {
+                    semantic[key] = style[key];
+                    delete style[key];
+                }
+            if (semantic.bold !== undefined || semantic.fontWeight !== undefined || semantic.fontStyle !== undefined || semantic.fontFamily !== undefined) {
+                const match = nativeFont(style.font);
+                semantic.fontSize ??= match?.fontSize;
+                semantic.fontFamily ??= match?.fontFamily;
+                if (semantic.fontSize !== undefined)
+                    semantic.fontUnit ??= match?.fontUnit;
+                semantic.fontStyle ??= match?.fontStyle;
+            }
+            assert(semantic.height === undefined && semantic.width === undefined, '单元格宽高应通过 rows/columns 描述');
+            if (Object.keys(semantic).length) {
+                Object.assign(style, observedNative(semantic, style));
+                const rules = initialRules, key = `${sheet.name}:${Number(cell.row)},${Number(cell.col)}`;
+                const hit = ruleIndex.get(key);
+                if (hit)
+                    hit.style = { ...semantic, ...hit.style };
+                else {
+                    const added = { sheet: sheet.name, row: Number(cell.row), col: Number(cell.col), style: semantic };
+                    rules.push(added);
+                    ruleIndex.set(key, added);
+                }
+            }
+            for (const key of ['foreColor', 'backColor'])
+                if (style[key] !== undefined)
+                    style[key] = imageColor(style[key]);
+            cell.style = style;
+        }
+    return copy;
+}
+export function prepareImageStyleSheet(source, selected, mergedAnchorBorders = false, preserveBorders = false) {
+    const sheet = geometrySheet(source, selected, mergedAnchorBorders, preserveBorders);
+    const cellIndex = new Map(sheet.cells.map(c => [`${Number(c.row)},${Number(c.col)}`, c]));
+    if (source.imageStyles)
+        for (const cell of sheet.cells) {
+            for (const key of ['foreColor', 'backColor'])
+                if (cell.style?.[key] !== undefined)
+                    cell.style[key] = imageColor(cell.style[key]);
+            if (cell.style?.font)
+                cell.style.font = observedNative(nativeFont(cell.style.font)).font;
+        }
+    for (const rule of source.imageStyles?.cells || []) {
+        assert(rule.sheet === selected.name, '图片样式包含未选择的 Sheet，需要分别编译');
+        const key = `${rule.row},${rule.col}`;
+        const cell = cellIndex.get(key) || { row: String(rule.row), col: String(rule.col), style: {} };
+        cell.style = { ...(cell.style || {}), ...observedNative(rule.style, cell.style) };
+        if (!cellIndex.has(key)) {
+            sheet.cells.push(cell);
+            cellIndex.set(key, cell);
+        }
+    }
+    return sheet;
+}
+function nativeTextCss(style, effectiveText = false) {
+    const css = {};
+    if (style.foreColor !== undefined)
+        css.color = imageColor(style.foreColor);
+    if (effectiveText && style.backColor !== undefined)
+        css['background-color'] = imageColor(style.backColor);
+    const font = nativeFont(style.font);
+    if (font)
+        Object.assign(css, observedCss(font));
+    if (style.hAlign !== undefined && style.hAlign <= 2)
+        css['text-align'] = ['left', 'center', 'right'][style.hAlign];
+    if (effectiveText && style.vAlign !== undefined && style.vAlign <= 2)
+        css['align-items'] = ['flex-start', 'center', 'flex-end'][style.vAlign];
+    return css;
+}
+export function projectImageField(source, binding, title, content, projection, used, sheetName, effectiveDisplay = false, effectiveText = false) {
+    if (!source.imageStyles)
+        return;
+    const f = binding.field, sub = String(f.subFormId || '');
+    const rules = (source.imageStyles.fields || []).filter(r => (r.fieldId ? r.fieldId === f.fieldId : r.fieldName === String(f.title || f.fieldName)) && (r.subFormId ? r.subFormId === sub : ['', '0', '-1'].includes(sub)));
+    assert(rules.length <= 1, `重复图片字段样式 ${f.fieldId}`);
+    const rule = rules[0];
+    if (rule) {
+        if (rule.fieldName)
+            assert(rule.fieldName === String(f.title || f.fieldName), '图片样式字段名与 ID 不一致');
+        used.add(rule);
+    }
+    if (rule?.displayTitle !== undefined) {
+        assert(binding.value.config, '字段缺少原生展示配置');
+        assert(binding.value.config.displayName === undefined || binding.value.config.displayName && typeof binding.value.config.displayName === 'object' && !Array.isArray(binding.value.config.displayName), '原生展示标题形状无效');
+        const properties = { enableDisplayName: true, displayName: { ...(binding.value.config.displayName || {}), nameAlias: rule.displayTitle } };
+        Object.assign(binding.value.config, properties);
+        projection.entries.push({ layer: 'componentConfig', componentId: String(binding.value.id), source: `field:${f.fieldId}.displayTitle`, properties: clone(properties) });
+    }
+    if (rule?.textArea) {
+        assert(binding.value.type === 'TextArea' && binding.value.config?.richEditor !== true, 'textArea 展示只支持普通 TextArea，不转换字段或富文本');
+        const properties = effectiveDisplay && rule.textArea.fitCell === true ? {} : { height: rule.textArea.rows };
+        if (effectiveDisplay && rule.textArea.fitCell === true)
+            (projection.notes ||= []).push(`字段 ${f.fieldId} 使用 fullHeight 撑满单元格；rows=${rule.textArea.rows} 不作为独立显示高度写入`);
+        if (rule.textArea.fitCell !== undefined)
+            properties.fullHeight = rule.textArea.fitCell;
+        if (rule.textArea.autoHeight !== undefined)
+            properties.disableAutoHeight = !rule.textArea.autoHeight;
+        Object.assign(binding.value.config, properties);
+        projection.entries.push({ layer: 'componentConfig', componentId: String(binding.value.id), source: `field:${f.fieldId}.textArea`, properties });
+    }
+    for (const [cell, style] of [[title, rule?.title], [content, rule?.content]])
+        if (style)
+            cell.style = { ...(cell.style || {}), ...observedNative(style, cell.style) };
+    if (rule?.input && rule.inputTarget === 'cell')
+        content.style = { ...(content.style || {}), ...observedNative(rule.input, content.style) };
+    if (source.imageStyles.componentStyles === 'replace' || source.imageStyles.componentStyles === 'workbookOnly') {
+        delete binding.title.config.styles;
+        delete binding.value.config.styles;
+    }
+    if (source.imageStyles.componentStyles === 'workbookOnly')
+        return;
+    const cellCss = (cell) => { const r = source.imageStyles?.cells?.find(r => r.row === Number(cell.row) && r.col === Number(cell.col)); return r ? observedCss(r.style) : {}; };
+    const originalCss = (cell) => {
+        const candidates = source.sheets.filter(s => s.name === sheetName).flatMap(s => s.cells).filter(c => Number(c.row) === Number(cell.row) && Number(c.col) === Number(cell.col));
+        return candidates.length === 1 ? nativeTextCss(candidates[0].style || {}) : {};
+    };
+    // CSS 只投影实际观察属性；SpreadJS 字体缺省值不能冒充图片已识别的字体属性。
+    const groups = { title: { ...originalCss(title), ...cellCss(title), ...(rule?.title ? observedCss(rule.title) : {}) }, content: { ...originalCss(content), ...cellCss(content), ...(rule?.content ? observedCss(rule.content) : {}) } };
+    if (effectiveText) {
+        Object.assign(groups.title, nativeTextCss(title.style || {}, true));
+        Object.assign(groups.content, nativeTextCss(content.style || {}, true));
+    }
+    if (rule?.input && rule.inputTarget !== 'cell')
+        groups.inputStyle = observedCss(rule.input);
+    for (const key of Object.keys(groups))
+        if (!Object.keys(groups[key]).length)
+            delete groups[key];
+    if (!Object.keys(groups).length)
+        return;
+    const comp = binding.value, categories = Array.isArray(comp.applyStyle) ? comp.applyStyle.map(String) : String(comp.applyStyle || '').split(',').filter(Boolean);
+    if (categories.length !== 1 || !comp.styleCategoryCompKey || !comp.config) {
+        projection.issues.push(`字段 ${f.fieldId} 缺少唯一原生样式分类，组件样式未投影`);
+        return;
+    }
+    const auditedCategories = ['InputStyleConfig', 'TextAreaStyleConfig', 'UploadStyleConfig', 'OptionStyleConfig', 'InputOptionStyleConfig', 'ImageOptionStyleConfig', 'DateStyleConfig', 'DateInputStyleConfig', 'RelateStyleConfig', 'OtherStyleConfig1', 'OtherStyleConfig2', 'BaseFieldStyleConfig'];
+    if (!auditedCategories.includes(comp.styleCategoryCompKey) || comp.styleCategoryPackage && comp.styleCategoryPackage !== '@weapp/formbuilder') {
+        projection.issues.push(`字段 ${f.fieldId} 的样式分类 ${comp.styleCategoryCompKey} 尚未核对原生渲染契约`);
+        return;
+    }
+    if (groups.inputStyle && !['InputStyleConfig', 'DateInputStyleConfig', 'TextAreaStyleConfig', 'InputOptionStyleConfig'].includes(comp.styleCategoryCompKey)) {
+        projection.issues.push(`字段 ${f.fieldId} 的原生分类不支持 inputStyle`);
+        delete groups.inputStyle;
+    }
+    if (groups.inputStyle?.height && comp.styleCategoryCompKey === 'TextAreaStyleConfig') {
+        projection.issues.push(`字段 ${f.fieldId} 的 TextArea 高度需专门原生契约，未写 inputStyle.height`);
+        delete groups.inputStyle.height;
+    }
+    assert(comp.config.styles === undefined || Array.isArray(comp.config.styles), '原生组件 styles 形状无效');
+    const styles = comp.config.styles || (comp.config.styles = []), category = categories[0];
+    const matches = styles.filter((s) => String(s.category) === category);
+    assert(matches.length <= 1, '原生样式分类重复');
+    const row = matches[0] || { category, useCustom: true, customStyle: {} };
+    row.useCustom = true;
+    row.customStyle ||= {};
+    if (Array.isArray(comp.applyStyle))
+        row.category = comp.applyStyle[0];
+    for (const [group, properties] of Object.entries(groups)) {
+        row.customStyle[group] = { ...(row.customStyle[group] || {}), ...properties };
+        projection.entries.push({ layer: 'component', componentId: String(comp.id), category, group, source: `field:${f.fieldId}.${group}`, properties: clone(properties) });
+    }
+    if (!matches.length)
+        styles.push(row);
+}
+export function projectImagePage(source, layout, projection) {
+    if (!source.imageStyles?.page)
+        return;
+    const parse = (v, label) => {
+        const value = typeof v === 'string' ? (v.trim() ? JSON.parse(v) : {}) : clone(v || {});
+        assert(value && typeof value === 'object' && !Array.isArray(value), `${label} 必须为 JSON 对象`);
+        safeTree(value);
+        return value;
+    };
+    const style = parse(layout.formStyle, 'formStyle'), config = parse(style.styleConfig, 'styleConfig');
+    config.formLayout ||= {};
+    config.formLayout.background ||= {};
+    assert(typeof config.formLayout === 'object' && !Array.isArray(config.formLayout) && typeof config.formLayout.background === 'object' && !Array.isArray(config.formLayout.background), 'formLayout/background 必须为 JSON 对象');
+    const properties = { 'background-color': imageColor(source.imageStyles.page.backgroundColor) };
+    Object.assign(config.formLayout.background, properties);
+    // 原生 FormStyle.styleConfig 是 Java String；内部修改用对象，保存必须编码回 JSON 字符串。
+    style.styleConfig = JSON.stringify(config);
+    layout.formStyle = style;
+    projection.entries.push({ layer: 'page', source: 'page.backgroundColor', group: 'background', properties });
+}
+export function canonicalImageFormStyle(value) {
+    if (value === undefined)
+        return undefined;
+    const style = typeof value === 'string' ? JSON.parse(value) : clone(value);
+    if (style && typeof style.styleConfig === 'string')
+        style.styleConfig = JSON.parse(style.styleConfig);
+    safeTree(style);
+    return style;
+}
+export function imageStyleReport(projection, pages, formStyle) {
+    const scope = { verificationScope: 'OBSERVATION_TO_NATIVE_READBACK', sourceImageCompared: false };
+    if (!projection)
+        return { ...scope, projectionVerified: false, status: 'NOT_OBSERVED', comparedProperties: 0, matchedProperties: 0, differences: [], issues: [] };
+    let comparedProperties = 0, matchedProperties = 0;
+    const differences = [];
+    const parse = (v) => { try {
+        return typeof v === 'string' ? JSON.parse(v) : v || {};
+    }
+    catch {
+        return {};
+    } };
+    const comps = [];
+    const flatten = (list) => { for (const c of list) {
+        comps.push(c);
+        flatten(c.children || []);
+        flatten(c.config?.children || []);
+    } };
+    pages?.forEach(p => flatten(p.comps || []));
+    for (const entry of projection.entries) {
+        let actual = {};
+        if (pages) {
+            if (entry.layer === 'page')
+                actual = parse(parse(formStyle).styleConfig).formLayout?.[entry.group] || {};
+            else if (entry.layer === 'componentConfig')
+                actual = comps.find(c => String(c.id) === entry.componentId)?.config || {};
+            else if (entry.layer === 'component')
+                actual = comps.find(c => String(c.id) === entry.componentId)?.config?.styles?.find((s) => String(s.category) === entry.category)?.customStyle?.[entry.group] || {};
+            else
+                actual = pages.flatMap(p => p.config?.workbook?.[entry.sheet]?.cells || []).find(c => Number(c.row) === entry.row && Number(c.col) === entry.col)?.style || {};
+        }
+        for (const [property, expected] of Object.entries(entry.properties)) {
+            comparedProperties++;
+            if (!pages)
+                continue;
+            if (stable(expected) === stable(actual[property]))
+                matchedProperties++;
+            else if (differences.length < 100)
+                differences.push({ source: entry.source, layer: entry.layer, property, expected, actual: actual[property] ?? null });
+        }
+    }
+    return { ...scope, projectionVerified: !!pages && !projection.issues.length && !differences.length && comparedProperties > 0, status: projection.issues.length ? 'INCOMPLETE' : !pages ? 'COMPILED' : differences.length ? 'MISMATCH' : comparedProperties > 0 ? 'VERIFIED' : 'INCOMPLETE', comparedProperties, matchedProperties, differences, issues: clone(projection.issues), ...(projection.notes ? { notes: clone(projection.notes) } : {}) };
+}
+//# sourceMappingURL=image-style.js.map