@stalfh233/omc-cli 0.0.0-stage → 0.4.0

package/dist/form-layout.js

@@ -0,0 +1,111 @@
+/**
+ * CFG-form-layout (borrowed from cpdocs base3.0 `cp-bizsheet/scripts/layout.js`):
+ * a form's rows + control spans must obey the platform's layout invariants.
+ * The pre-fix tools wrote rows/span unchecked, so a malformed layout only
+ * surfaced as a blank or broken designer page — the same failure family as
+ * CFG-26's blank rule canvas.
+ *
+ * Invariants (all local, zero wire):
+ *  1. `span` is one of the platform's allowed widths {6, 8, 12, 16, 18, 24};
+ *  2. each row's spans sum to at most 24;
+ *  3. a full-width control (span 24) occupies its row alone;
+ *  4. every attribute control appears in `rows` exactly once — nothing extra,
+ *     nothing missing, no duplicates.
+ */
+export const ALLOWED_SPANS = new Set([6, 8, 12, 16, 18, 24]);
+export const FULL_SPAN = 24;
+/** Child-table (Sheet 201) column keys, which must live on `columns`, never in rows. */
+function childColumnKeys(attrs) {
+    const keys = new Set();
+    for (const control of Object.values(attrs)) {
+        if (control?.type !== 201 || !Array.isArray(control.columns))
+            continue;
+        for (const column of control.columns)
+            if (typeof column?.key === "string")
+                keys.add(column.key);
+    }
+    return keys;
+}
+/**
+ * The render-shape gate for CALLER-PROVIDED layouts. These read back fine but
+ * blank the 8.6.34 renderer:
+ *  - a control's `options` as a JSON string → the runtime mutates
+ *    `options.name_i18n` on it and throws "Cannot create property 'name_i18n'
+ *    on string". Healthy platform forms carry object options only (0/43 sampled).
+ *  - a non-string viewJson cell.
+ *  - a child-table column key used as a layout row (child keys stay on the 201
+ *    control's `columns`).
+ * Tolerant of a one-sided layout (only rows or only attributes supplied).
+ */
+export function validateFormLayoutShape(rows, attributes) {
+    const violations = [];
+    const attrs = (attributes && typeof attributes === "object" && !Array.isArray(attributes) ? attributes : {});
+    for (const [code, control] of Object.entries(attrs)) {
+        if (control && typeof control === "object" && typeof control.options === "string")
+            violations.push({
+                classification: "control_options_not_object",
+                field: code,
+                message: `控件 ${code} 的 options 是 JSON 字符串；必须是对象（8.6.34 运行时会写 options.name_i18n，字符串会抛 "Cannot create property 'name_i18n' on string" 导致整页空白）`,
+            });
+    }
+    if (Array.isArray(rows)) {
+        rows.forEach((row, rowIndex) => {
+            if (!Array.isArray(row)) {
+                violations.push({ classification: "view_cell_not_string", row: rowIndex + 1, message: `第 ${rowIndex + 1} 行必须是字段 key 数组` });
+                return;
+            }
+            row.forEach((cell, cellIndex) => {
+                if (typeof cell !== "string")
+                    violations.push({ classification: "view_cell_not_string", row: rowIndex + 1, message: `viewJson[${rowIndex}][${cellIndex}] 必须是字符串（字段 key），实为 ${typeof cell}` });
+            });
+        });
+        const childKeys = childColumnKeys(attrs);
+        if (childKeys.size > 0) {
+            const leaked = [...new Set(rows.flat().filter((cell) => typeof cell === "string" && childKeys.has(cell)))];
+            if (leaked.length > 0)
+                violations.push({ classification: "child_column_in_rows", field: leaked.join("、"), message: `子表列 key 不能进 viewJson（应只挂在 201 控件的 columns 上）：${leaked.join("、")}` });
+        }
+    }
+    return violations;
+}
+function spanOf(attributes, code, violations) {
+    const raw = typeof attributes[code]?.options === "object" ? (attributes[code]?.options).span : undefined;
+    const span = Number(raw ?? FULL_SPAN);
+    if (!ALLOWED_SPANS.has(span)) {
+        violations.push({ classification: "layout_invalid_span", field: code, span, message: `控件 ${code} 的 span=${String(raw)} 不在允许宽度 ${[...ALLOWED_SPANS].join("/")}` });
+        return FULL_SPAN;
+    }
+    return span;
+}
+/**
+ * Validate a form layout. Returns [] when the layout is well-formed. `rows` is
+ * the 2-D array of control codes; `attributes` is the control map.
+ */
+export function validateFormLayout(rows, attributes) {
+    const violations = validateFormLayoutShape(rows, attributes);
+    if (!Array.isArray(rows) || rows.some((row) => !Array.isArray(row))) {
+        violations.push({ classification: "layout_coverage_mismatch", message: "rows 必须是二维数组（每行是控件 code 数组）" });
+        return violations;
+    }
+    const attrs = (attributes && typeof attributes === "object" && !Array.isArray(attributes) ? attributes : {});
+    const flat = rows.flat().map((code) => String(code));
+    const attributeCodes = Object.keys(attrs).sort();
+    const unique = new Set(flat);
+    if (unique.size !== flat.length)
+        violations.push({ classification: "layout_coverage_mismatch", message: `rows 中存在重复控件：${flat.filter((code, index) => flat.indexOf(code) !== index).join("、")}` });
+    if (JSON.stringify(attributeCodes) !== JSON.stringify([...flat].sort()))
+        violations.push({ classification: "layout_coverage_mismatch", message: `顶层控件与布局必须完整一一对应：attributes=[${attributeCodes.join(",")}] 而 rows=[${[...flat].sort().join(",")}]` });
+    rows.forEach((row, index) => {
+        const codes = row.map((code) => String(code));
+        const widths = codes.map((code) => spanOf(attrs, code, violations));
+        const total = widths.reduce((sum, width) => sum + width, 0);
+        if (total > FULL_SPAN) {
+            violations.push({ classification: "layout_row_overflow", row: index + 1, message: `第 ${index + 1} 行 span 合计 ${total}，超过 ${FULL_SPAN}（${codes.join(" + ")}）` });
+        }
+        if (codes.length !== 1 && widths.some((width) => width === FULL_SPAN)) {
+            violations.push({ classification: "full_row_control_conflict", row: index + 1, message: `第 ${index + 1} 行含整行控件（span=24），不能与其他控件同行（${codes.join(" + ")}）` });
+        }
+    });
+    return violations;
+}
+//# sourceMappingURL=form-layout.js.map