weaver-e10-builder 1.1.8 → 1.2.2

package/dist/services/report/validate.js

@@ -0,0 +1,685 @@
+/**
+ * 报表配置校验规则引擎（本地，不落库）。
+ *
+ * 这些规则都是"写错了不会报错、但设计器上表现异常"的那一类 ——
+ * 比如 `between` 引擎不认（会静默不生成条件格式）、`transType=person` 被废弃、
+ * 超链接里混进全角 `？` 导致点击无反应。所以在写之前先拦住。
+ */
+import { FONT_SIZES, NUMBER_FORMATS, DEFAULT_BODY_STYLE, DEFAULT_HEADER_STYLE, DEFAULT_TITLE_STYLE, resolveLayerStyles, } from './constants.js';
+function result() {
+    return { ok: true, errors: [], warnings: [], infos: [] };
+}
+function err(r, message, suggestion) {
+    r.errors.push({ level: 'error', message, suggestion });
+    r.ok = false;
+}
+function warn(r, message, suggestion) {
+    r.warnings.push({ level: 'warning', message, suggestion });
+}
+function info(r, message) {
+    r.infos.push({ level: 'info', message });
+}
+// ── 基础信息 ────────────────────────────────────────────────
+export const BASE_DEFAULTS = { groupId: '0', showOrder: '1', nameLabelId: '-1', systemType: '1' };
+const CONTROL_CHARS = /[\u0000-\u001F\u007F]/;
+/**
+ * 报表名/分组等基础字段的写入规范。
+ *
+ * `nameLabelId` 传空串会在平台 `Long.parseLong` 处炸成「报表内部错误」，
+ * 所以无多语言时必须显式写 `-1`。
+ */
+export function validateBaseMeta(opts) {
+    const r = result();
+    const name = String(opts.name ?? '');
+    const trimmed = name.trim();
+    if (!name)
+        err(r, 'name 不能为空（建报表必填）');
+    else if (!trimmed)
+        err(r, 'name trim 后为空');
+    else if (CONTROL_CHARS.test(name)) {
+        err(r, 'name 含控制字符（\\r\\n\\t 等），须去掉');
+    }
+    else if (name !== trimmed) {
+        err(r, 'name 含首尾空白，写入前必须 trim');
+    }
+    let nameLabelId = String(opts.nameLabelId ?? '');
+    if (!nameLabelId) {
+        err(r, 'nameLabelId 不能为空；无多语言时必须显式传 "-1"');
+        nameLabelId = '-1';
+    }
+    else if (CONTROL_CHARS.test(nameLabelId)) {
+        err(r, 'nameLabelId 含控制字符（会导致列表解析失败 → 报表内部错误）');
+    }
+    else if (nameLabelId !== '-1' && !/^\d{6,}$/.test(nameLabelId)) {
+        err(r, 'nameLabelId 必须是 "-1" 或纯数字多语言 ID');
+    }
+    let groupId = String(opts.groupId ?? '');
+    if (!groupId) {
+        err(r, 'groupId 不能为空；新建未指定分组时传平台默认 "0"');
+        groupId = '0';
+    }
+    else if (!/^-?\d+$/.test(groupId)) {
+        err(r, 'groupId 必须是整数数字字符串');
+    }
+    let showOrder = String(opts.showOrder ?? '');
+    if (!showOrder)
+        showOrder = BASE_DEFAULTS.showOrder;
+    else if (Number.isNaN(Number(showOrder)))
+        err(r, 'showOrder 必须是数字');
+    return {
+        ...r,
+        normalized: { name: trimmed, nameLabelId, groupId, showOrder },
+    };
+}
+/** 分层样式的默认值，供 `validate style --list` 输出。 */
+export function styleCatalog() {
+    return {
+        DEFAULT_BODY_STYLE,
+        DEFAULT_TITLE_STYLE,
+        DEFAULT_HEADER_STYLE,
+        fontSizes: FONT_SIZES,
+        numberFormats: NUMBER_FORMATS,
+    };
+}
+export { resolveLayerStyles };
+// ── 条件格式 ────────────────────────────────────────────────
+/** 引擎认识的 relation（`highlight:` 前缀之后的部分）。 */
+export const ALLOWED_RELATIONS = new Set([
+    'greater',
+    'greaterAndEquals',
+    'less',
+    'lessAndEquals',
+    'equals',
+    'noEquals',
+    'interval',
+    'include',
+    'happenDate',
+    'sameValue',
+]);
+/** 常见误写 → 引擎真名。`between` 就是最典型的坑：引擎只认 `interval`。 */
+export const RELATION_ALIAS_FIX = {
+    between: 'interval',
+    gt: 'greater',
+    gte: 'greaterAndEquals',
+    lt: 'less',
+    lte: 'lessAndEquals',
+    eq: 'equals',
+    ne: 'noEquals',
+    neq: 'noEquals',
+};
+const NUMERIC_SINGLE = ['greater', 'greaterAndEquals', 'less', 'lessAndEquals', 'equals', 'noEquals'];
+function normalizeRelation(raw) {
+    const stripped = String(raw ?? '').replace(/^highlight:/i, '');
+    return { stripped, full: stripped ? `highlight:${stripped}` : '' };
+}
+/** 校验并规范化一条 `conditionRule`。 */
+export function validateConditionRule(input, label = 'conditionRule') {
+    const r = result();
+    let rule = input;
+    if (typeof rule === 'string') {
+        try {
+            rule = JSON.parse(rule);
+        }
+        catch {
+            err(r, `${label}: conditionRule 不是合法 JSON`);
+            return { ...r, normalized: {} };
+        }
+    }
+    if (Array.isArray(rule))
+        rule = { highlightDatas: rule };
+    if (!rule || typeof rule !== 'object') {
+        warn(r, `${label}: conditionRule 为空或非对象，已跳过`);
+        return { ...r, normalized: {} };
+    }
+    const out = {};
+    if (rule.highlightDatas !== undefined) {
+        if (!Array.isArray(rule.highlightDatas)) {
+            err(r, `${label}: highlightDatas 必须是数组`);
+        }
+        else {
+            const norm = [];
+            rule.highlightDatas.forEach((h, i) => {
+                const { stripped, full } = normalizeRelation(h?.relation);
+                if (!h?.relation) {
+                    err(r, `${label}[#${i}]: 缺 relation`);
+                    return;
+                }
+                if (!ALLOWED_RELATIONS.has(stripped)) {
+                    const fix = RELATION_ALIAS_FIX[stripped];
+                    if (fix) {
+                        err(r, `${label}[#${i}]: relation "${stripped}" 引擎不识别（会静默不生成规则）。请改为 highlight:${fix}`, { reason: '别名修正', to: `highlight:${fix}` });
+                    }
+                    else {
+                        err(r, `${label}[#${i}]: relation "${stripped}" 不在白名单。支持: ${[...ALLOWED_RELATIONS]
+                            .map((x) => `highlight:${x}`)
+                            .join(', ')}。若为复合逻辑，请拆成多条互不重叠规则或改用「介于」。`, { reason: '不支持 —— 需要用户确认拆规则还是放弃' });
+                    }
+                    return;
+                }
+                if (stripped === 'interval') {
+                    if (h.value1 == null || String(h.value1) === '' || h.value2 == null || String(h.value2) === '') {
+                        err(r, `${label}[#${i}]: interval（介于）必须同时有 value1（下界）与 value2（上界）`);
+                        return;
+                    }
+                    const lo = Number(h.value1);
+                    const hi = Number(h.value2);
+                    if (Number.isFinite(lo) && Number.isFinite(hi) && lo > hi) {
+                        warn(r, `${label}[#${i}]: interval 下界 ${lo} 大于上界 ${hi}`);
+                    }
+                }
+                else if (NUMERIC_SINGLE.includes(stripped)) {
+                    if (h.value1 == null || String(h.value1) === '') {
+                        err(r, `${label}[#${i}]: ${stripped} 需要 value1`);
+                        return;
+                    }
+                }
+                norm.push({
+                    ...h,
+                    relation: full,
+                    conditionType: h.conditionType || 'currCell',
+                    index: h.index ?? i,
+                });
+            });
+            // 区间重叠：多条「大于」样式不同会互相盖住
+            const styleKey = (h) => `${h.foreColor ?? ''}|${h.backColor ?? ''}|${!!h.bold}`;
+            const greaters = norm.filter((h) => /greater(AndEquals)?$/.test(h.relation));
+            if (greaters.length >= 2 && new Set(greaters.map(styleKey)).size > 1) {
+                warn(r, `${label}: 多条「大于/大于等于」且样式不同，高值区间会重叠命中。` +
+                    '建议低档改用 interval 与高档错开。示例：interval(1,5) 红 + greater(5) 蓝', { reason: '冲突 —— 请用户确认是否改为 interval + greater' });
+            }
+            const g1 = norm.filter((h) => h.relation === 'highlight:greater');
+            const l1 = norm.filter((h) => h.relation === 'highlight:less');
+            if (g1.length === 1 && l1.length === 1 && styleKey(g1[0]) === styleKey(l1[0])) {
+                warn(r, `${label}: 检测到 greater + less 同样式。多条规则是**或**不是**且**，无法实现「大于且小于」。` +
+                    '请改为一条 highlight:interval。', {
+                    reason: 'OR ≠ AND —— 建议合并为 interval',
+                    to: { relation: 'highlight:interval', value1: String(g1[0].value1), value2: String(l1[0].value1) },
+                });
+            }
+            out.highlightDatas = norm;
+        }
+    }
+    if (rule.lineDatas !== undefined) {
+        if (!Array.isArray(rule.lineDatas))
+            err(r, `${label}: lineDatas 必须是数组`);
+        else {
+            out.lineDatas = rule.lineDatas.map((d, i) => {
+                const leftType = d.leftType || 'min';
+                const rightType = d.rightType || 'max';
+                const gradient = d.gradient || 'gradient';
+                if (!['min', 'max', 'custom'].includes(leftType))
+                    err(r, `${label}[#${i}]: leftType 非法（min|max|custom）`);
+                if (!['min', 'max', 'custom'].includes(rightType))
+                    err(r, `${label}[#${i}]: rightType 非法（min|max|custom）`);
+                if (!['gradient', 'solid'].includes(gradient))
+                    err(r, `${label}[#${i}]: gradient 须为 gradient|solid`);
+                if (leftType === 'custom' && (d.leftValue == null || d.leftValue === '')) {
+                    err(r, `${label}[#${i}]: leftType=custom 需要 leftValue`);
+                }
+                if (rightType === 'custom' && (d.rightValue == null || d.rightValue === '')) {
+                    err(r, `${label}[#${i}]: rightType=custom 需要 rightValue`);
+                }
+                if (!d.color)
+                    warn(r, `${label}[#${i}]: 建议设置 color`);
+                return {
+                    ...d,
+                    leftType,
+                    rightType,
+                    gradient,
+                    color: d.color || '#6495ED',
+                    negativeFillColor: d.negativeFillColor || '#FF0000',
+                };
+            });
+        }
+    }
+    if (rule.iconSets !== undefined && rule.iconDatas === undefined) {
+        warn(r, `${label}: 键名应为 iconDatas（引擎字段名），不是 iconSets`);
+    }
+    if (rule.iconDatas !== undefined) {
+        if (!Array.isArray(rule.iconDatas))
+            err(r, `${label}: iconDatas 必须是数组`);
+        else {
+            out.iconDatas = rule.iconDatas.map((d, i) => {
+                if (d.iconSetType == null)
+                    err(r, `${label}[#${i}]: 缺 iconSetType（字符串，如 "0"）`);
+                if (!Array.isArray(d.iconCriteria))
+                    err(r, `${label}[#${i}]: iconCriteria 必须是数组`);
+                return d;
+            });
+        }
+    }
+    return { ...r, normalized: out };
+}
+/**
+ * 把用户口语映射成条件格式规则（不落库，只帮用户确认意图）。
+ */
+export function mapNaturalPhrase(phrase) {
+    const r = result();
+    const s = String(phrase || '').trim();
+    const databar = (solid) => ({
+        lineDatas: [
+            {
+                leftType: 'min',
+                rightType: 'max',
+                gradient: solid ? 'solid' : 'gradient',
+                color: '#6495ED',
+                negativeFillColor: '#FF0000',
+            },
+        ],
+    });
+    if (/实心\s*数据条|数据条.*实心/.test(s))
+        return { ...r, normalized: databar(true) };
+    if (/数据条|databar|data\s*bar/i.test(s))
+        return { ...r, normalized: databar(false) };
+    if (/图标集|icon\s*set|三色箭头/i.test(s)) {
+        return {
+            ...r,
+            normalized: {
+                iconDatas: [
+                    {
+                        iconSetType: '0',
+                        iconCriteria: [
+                            { iconValue: '67', isGreaterThanOrEqualTo: true, iconValueType: 1 },
+                            { iconValue: '33', isGreaterThanOrEqualTo: true, iconValueType: 1 },
+                        ],
+                    },
+                ],
+            },
+        };
+    }
+    const intervals = [
+        /介于\s*([\d.]+)\s*(?:和|与|,|，|~|-|–|—|\s+)\s*([\d.]+)/,
+        /([\d.]+)\s*[-~～–—]\s*([\d.]+)/,
+        /大于\s*([\d.]+)\s*(?:且|and)\s*小于\s*([\d.]+)/i,
+    ];
+    for (const re of intervals) {
+        const m = s.match(re);
+        if (m) {
+            return { ...r, normalized: { relation: 'highlight:interval', value1: m[1], value2: m[2] } };
+        }
+    }
+    const singles = [
+        [/大于等于\s*([\d.]+)|≥\s*([\d.]+)/, 'highlight:greaterAndEquals'],
+        [/小于等于\s*([\d.]+)|≤\s*([\d.]+)/, 'highlight:lessAndEquals'],
+        [/大于\s*([\d.]+)|>\s*([\d.]+)/, 'highlight:greater'],
+        [/小于\s*([\d.]+)|<\s*([\d.]+)/, 'highlight:less'],
+    ];
+    for (const [re, relation] of singles) {
+        const m = s.match(re);
+        if (m)
+            return { ...r, normalized: { relation, value1: m[1] ?? m[2] } };
+    }
+    const eq = s.match(/等于\s*(.+)/);
+    if (eq)
+        return { ...r, normalized: { relation: 'highlight:equals', value1: eq[1].trim() } };
+    err(r, `无法映射「${s}」。支持：大于/小于/介于、数据条、图标集等。`);
+    return { ...r, normalized: null };
+}
+// ── 单元格格式 ──────────────────────────────────────────────
+export const FORMAT_CATALOG = [
+    { label: '常规', formatter: 'General', key1: 'common' },
+    { label: '数值', formatter: '0.00_);[Red](0.00)', key1: 'value' },
+    { label: '货币', formatter: '"￥"#,##0.00_);[Red]("￥"#,##0.00)', key1: 'huobi' },
+    { label: '会计专用', formatter: '_ "￥"* #,##0.00_ ;_ "￥"* -#,##0.00_ ;_ "￥"* "-"??_ ;_ @_ ', key1: 'kuaiji' },
+    { label: '短日期', formatter: 'yyyy/m/d;@__@', key1: 'shortdate' },
+    { label: '长日期', formatter: 'yyyy"年"m"月"d"日";@', key1: 'longdate' },
+    { label: '时间', formatter: 'h:mm:ss;@', key1: 'time' },
+    { label: '百分比', formatter: '0.00%', key1: 'percent' },
+    { label: '分数', formatter: '# ?/?', key1: 'fenshu' },
+    { label: '科学计数法', formatter: '0.00E+00', key1: 'kexuejishu' },
+    { label: '文本', formatter: '@', key1: 'text' },
+];
+export const GROUP_TYPE_ALIAS = {
+    不设置: 'none',
+    无: 'none',
+    none: 'none',
+    年份: 'year',
+    年: 'year',
+    year: 'year',
+    年月: 'yearmonth',
+    yearmonth: 'yearmonth',
+    yearAndMonth: 'yearmonth',
+    月份: 'month',
+    month: 'month',
+    年月日: 'yearmonthday',
+    yearmonthday: 'yearmonthday',
+    年周: 'yearweekday',
+    yearweekday: 'yearweekday',
+    月周: 'monthweekday',
+    monthweekday: 'monthweekday',
+};
+export const SUPPORTED_FONTS = new Set([
+    '微软雅黑', '宋体', '黑体', '楷体', '仿宋',
+    'Arial', 'Calibri', 'Times New Roman', 'Tahoma', 'Verdana', 'sans-serif',
+]);
+export const DEFAULT_FONT = '微软雅黑';
+export const DEFAULT_FONT_SIZE = 12;
+/** 数字格式规范化：非目录全等值会被设计器当成「其他数字格式」回显。 */
+export function normalizeNumberFormat(input) {
+    const r = result();
+    const label = input.map;
+    if (label) {
+        const hit = FORMAT_CATALOG.find((f) => f.label === label || f.key1 === label) ||
+            FORMAT_CATALOG.find((f) => f.key1 === String(label).toLowerCase());
+        if (!hit) {
+            err(r, `无法映射数字格式「${label}」到设计器目录`);
+            return { ...r, normalized: null };
+        }
+        return { ...r, normalized: { formatter: hit.formatter, formatterType: [hit.key1], label: hit.label } };
+    }
+    const ft0 = Array.isArray(input.formatterType)
+        ? input.formatterType[0]
+        : String(input.formatterType ?? '');
+    const fmt = String(input.formatter ?? '');
+    if (!fmt || fmt === 'General') {
+        if (ft0 && ft0 !== 'common') {
+            warn(r, `formatter 是常规，但 formatterType[0]=${ft0}，已规范为 common`);
+        }
+        return { ...r, normalized: { formatter: 'General', formatterType: ['common'], label: '常规' } };
+    }
+    const exact = FORMAT_CATALOG.find((f) => f.formatter === fmt);
+    if (exact) {
+        if (ft0 && ft0 !== exact.key1) {
+            warn(r, `formatter 已是「${exact.label}」目录值，但 formatterType[0]=${ft0}，已规范为 ${exact.key1}`);
+        }
+        return { ...r, normalized: { formatter: exact.formatter, formatterType: [exact.key1], label: exact.label } };
+    }
+    warn(r, `formatter「${fmt}」未在标准目录中，将按「其他数字格式」回显；若想让工具栏显示「货币」等，请改用目录全等值`);
+    return { ...r, normalized: { formatter: fmt, formatterType: ['custom'], label: '其他数字格式' } };
+}
+export function normalizeGroupType(raw) {
+    const r = result();
+    const s = String(raw ?? '').trim();
+    if (!s)
+        return { ...r, normalized: { groupType: 'none', label: '不设置' } };
+    const hit = GROUP_TYPE_ALIAS[s] || GROUP_TYPE_ALIAS[s.toLowerCase()];
+    if (!hit) {
+        warn(r, `无法映射日期分组「${s}」。支持：不设置/年份/年月/月份/年月日/年周/月周（或 year/yearmonth/...）`);
+        return { ...r, normalized: null };
+    }
+    if (s === 'yearAndMonth')
+        warn(r, 'UI 别名 yearAndMonth 已规范为落库值 yearmonth');
+    const label = FORMAT_GROUP_LABEL[hit] || hit;
+    return { ...r, normalized: { groupType: hit, label } };
+}
+const FORMAT_GROUP_LABEL = {
+    none: '不设置',
+    year: '年份',
+    yearmonth: '年月',
+    month: '月份',
+    yearmonthday: '年月日',
+    yearweekday: '年周',
+    monthweekday: '月周',
+};
+/** 字体规范化：目录外的字号/字体回退默认值并提示（不中断）。 */
+export function normalizeFont(font) {
+    const r = result();
+    const s = String(font ?? '');
+    const m = s.match(/(\d+(?:\.\d+)?)px\s+(.+)$/);
+    let size = m ? Number(m[1]) : DEFAULT_FONT_SIZE;
+    let family = m ? m[2].trim() : DEFAULT_FONT;
+    if (!FONT_SIZES.includes(size)) {
+        warn(r, `报表不支持 ${size} 号字体，已按默认字号 ${DEFAULT_FONT_SIZE} 展示（不中断）`);
+        size = DEFAULT_FONT_SIZE;
+    }
+    if (!SUPPORTED_FONTS.has(family)) {
+        warn(r, `字体「${family}」不在常用支持列表，已回退为 ${DEFAULT_FONT}（不中断）`);
+        family = DEFAULT_FONT;
+    }
+    return { ...r, normalized: { font: family, fontSize: size } };
+}
+/** 整表全量设置样式一律拦下 —— 会覆盖用户已有的逐格设置。 */
+export function validateCellPatch(patch) {
+    const r = result();
+    if (patch?.wholeSheetStyle || patch?.wholeSheetBorder || patch?.applyToEntireReport) {
+        err(r, '不支持对整个报表全量设置单元格样式或边框样式。请指定区域（如 B3:H5），并让用户确认范围。');
+    }
+    return r;
+}
+// ── 转换面板 ────────────────────────────────────────────────
+export const BROWSER_PRESETS = {
+    人员: 'HrmEmployeeComInfo',
+    部门: 'HrmDepartmentComInfo',
+    部门全路径: 'HrmDepartmentAllPathComInfo',
+    '部门（全路径）': 'HrmDepartmentAllPathComInfo',
+    HrmEmployeeComInfo: 'HrmEmployeeComInfo',
+    HrmDepartmentComInfo: 'HrmDepartmentComInfo',
+    HrmDepartmentAllPathComInfo: 'HrmDepartmentAllPathComInfo',
+};
+/** 已废弃的 `transType` 写法 —— 写进去设计器不认，必须换成新写法。 */
+export const TRANS_MAP = {
+    无: { transType: 'default' },
+    不转换: { transType: 'default' },
+    default: { transType: 'default' },
+    none: { transType: 'default', warn: 'none → default（不要用 none 落库）' },
+    人员: { transType: 'browser', browserType: [{ id: 'HrmEmployeeComInfo' }] },
+    person: { error: '禁止 transType=person；人员应写 browser + HrmEmployeeComInfo' },
+    hrm: { error: '遗留 hrm 禁止新写；人员应写 browser + HrmEmployeeComInfo' },
+    部门: { transType: 'browser', browserType: [{ id: 'HrmDepartmentComInfo' }] },
+    department: { error: '禁止 transType=department；部门应写 browser + HrmDepartmentComInfo' },
+    dept: { error: '遗留 dept 禁止新写；部门应写 browser + HrmDepartmentComInfo' },
+    部门全路径: { transType: 'browser', browserType: [{ id: 'HrmDepartmentAllPathComInfo' }] },
+    '部门（全路径）': { transType: 'browser', browserType: [{ id: 'HrmDepartmentAllPathComInfo' }] },
+    checkbox: { transType: 'checkbox' },
+    Checkbox: { transType: 'checkbox' },
+    选择框: { transType: 'select' },
+    select: { transType: 'select' },
+    颜色选择框: { transType: 'colorSelect' },
+    colorSelect: { transType: 'colorSelect' },
+    分值图标: { transType: 'scoreIcon' },
+    scoreIcon: { transType: 'scoreIcon' },
+    斜线文字: { transType: 'slashWord' },
+    slashWord: { transType: 'slashWord' },
+    关联类型: { transType: 'browser', note: '须另填 browserType' },
+    browser: { transType: 'browser' },
+    图片: { transType: 'picture' },
+    picture: { transType: 'picture' },
+    image: { error: '禁止 image；图片应写 picture' },
+};
+export const QR_MAP = {
+    无: 'no', no: 'no', 条码: 'barcode', barcode: 'barcode', 二维码: 'qrcode', qrcode: 'qrcode',
+};
+export const DIR_MAP = {
+    从左向右: 'FromLeftToRight',
+    FromLeftToRight: 'FromLeftToRight',
+    从右向左: 'FromRightToLeft',
+    FromRightToLeft: 'FromRightToLeft',
+    竖排: 'VerticalArrangement',
+    VerticalArrangement: 'VerticalArrangement',
+    顺时针旋转90: 'CW',
+    '顺时针旋转90°': 'CW',
+    CW: 'CW',
+    逆时针旋转90: 'CCW',
+    '逆时针旋转90°': 'CCW',
+    CCW: 'CCW',
+};
+const BOOL_MAP = { 否: '0', 是: '1', '0': '0', '1': '1' };
+const FORBIDDEN_TRANS = new Set([
+    'person', 'department', 'image', 'html', 'barcode', 'qrcode', 'hidden', 'none',
+]);
+/** 校验并规范化转换面板设置。 */
+export function normalizeTransform(input) {
+    const r = result();
+    const src = input || {};
+    const out = {};
+    if (src.transType != null) {
+        const tt = String(src.transType);
+        if (FORBIDDEN_TRANS.has(tt)) {
+            err(r, `非法 transType=${tt}（已废弃写法）。人员/部门用 browser + browserType，图片用 picture。`);
+            return { ...r, normalized: null };
+        }
+        out.transType = tt;
+    }
+    if (src.browserType != null) {
+        let bt = src.browserType;
+        if (typeof bt === 'string') {
+            try {
+                bt = JSON.parse(bt);
+            }
+            catch {
+                err(r, 'browserType 不是合法 JSON');
+                return { ...r, normalized: null };
+            }
+        }
+        out.browserType = bt;
+    }
+    if (out.transType === 'browser' && (!out.browserType || !out.browserType.length)) {
+        warn(r, 'transType=browser 但 browserType 为空（关联类型需要具体对象）');
+    }
+    if (src.isHtml != null) {
+        const v = BOOL_MAP[String(src.isHtml)];
+        if (v == null)
+            err(r, `isHtml 非法: ${src.isHtml}（须 0|1 / 否|是）`);
+        else
+            out.isHtml = v;
+    }
+    if (src.qrcodeType != null) {
+        const v = QR_MAP[String(src.qrcodeType)];
+        if (!v)
+            err(r, `qrcodeType 非法: ${src.qrcodeType}（须 no|barcode|qrcode）`);
+        else
+            out.qrcodeType = v;
+    }
+    if (src.prefixAndSuffix != null) {
+        if (!Array.isArray(src.prefixAndSuffix) || src.prefixAndSuffix.length < 2) {
+            err(r, 'prefixAndSuffix 须为长度 ≥2 的数组 ["前缀","后缀"]');
+        }
+        else
+            out.prefixAndSuffix = src.prefixAndSuffix;
+    }
+    if (src.hideContent != null && src.hiddenContext == null) {
+        warn(r, '键名应为 hiddenContext（不是 hideContent）');
+    }
+    if (src.hiddenContext != null || src.hideContent != null) {
+        const raw = src.hiddenContext ?? src.hideContent;
+        const v = BOOL_MAP[String(raw)];
+        if (v == null)
+            err(r, `hiddenContext 非法: ${raw}`);
+        else
+            out.hiddenContext = v;
+    }
+    if (src.textDirection != null) {
+        const v = DIR_MAP[String(src.textDirection)];
+        if (!v)
+            err(r, `textDirection 非法: ${src.textDirection}`);
+        else
+            out.textDirection = v;
+    }
+    return { ...r, normalized: out };
+}
+// ── 事件超链接 ──────────────────────────────────────────────
+export const OPEN_TYPE_MAP = {
+    弹出页: 'blank',
+    弹窗: 'blank',
+    弹层: 'blank',
+    新页签: 'blank',
+    blank: 'blank',
+    当前页: 'self',
+    self: 'self',
+    执行js代码: 'jsscript',
+    执行JS代码: 'jsscript',
+    jsscript: 'jsscript',
+    js: 'jsscript',
+};
+const FORBIDDEN_OPEN = new Set(['popup', 'window', 'new', 'modal', 'redirect']);
+const FORBIDDEN_PARAM_NAMES = new Set(['id', 'name']);
+/** 全角 `？`/`＆` 会让链接点击无反应，统一换成 ASCII。 */
+export function sanitizeHrefString(s) {
+    return String(s ?? '')
+        .replace(/？/g, '?')
+        .replace(/＆/g, '&')
+        .replace(/　/g, ' ')
+        .trim();
+}
+export function normalizeHref(input, opts = {}) {
+    const r = result();
+    const src = input || {};
+    const out = { ...src };
+    if (src.map != null) {
+        const t = OPEN_TYPE_MAP[String(src.map)];
+        if (t)
+            out.openType = t;
+        else if (!src.pcHreflink && !src.openType) {
+            err(r, `无法映射打开方式「${src.map}」。支持：弹出页/当前页/执行js代码（blank/self/jsscript）`);
+        }
+    }
+    if (src.openType != null) {
+        const raw = String(src.openType);
+        if (FORBIDDEN_OPEN.has(raw))
+            err(r, `禁止 openType=${raw}；请用 blank|self|jsscript`);
+        else if (OPEN_TYPE_MAP[raw])
+            out.openType = OPEN_TYPE_MAP[raw];
+        else if (['blank', 'self', 'jsscript'].includes(raw))
+            out.openType = raw;
+        else
+            err(r, `非法 openType=${raw}`);
+    }
+    else if (src.pcHreflink || src.h5Hreflink) {
+        out.openType = 'blank';
+        warn(r, '未指定 openType，默认 blank（弹出页）');
+    }
+    const checkLink = (raw, key) => {
+        if (raw == null || raw === '')
+            return '';
+        let s = String(raw);
+        if (/[？＆]/.test(s)) {
+            const msg = `链接含全角 ？/＆（会导致点击无反应）。必须用 ASCII ? 与 &。`;
+            if (opts.fix) {
+                s = sanitizeHrefString(s);
+                warn(r, `${key}: ${msg}（已自动替换为 ASCII）`);
+            }
+            else {
+                err(r, `${key}: ${msg}`);
+            }
+        }
+        const pathCell = /\{[A-Za-z]+\d+\}/.test(s);
+        const isConst = src.cellType === 'Const' || src.typeName === 'ConstCellType';
+        if (pathCell && isConst) {
+            if (src.leftX == null || src.leftY == null || (Number(src.leftX) === -1 && Number(src.leftY) === -1)) {
+                err(r, `${key}: 路径含 {坐标} 时，Const 左父格须指向数据格（不能是默认的 -1,-1）`);
+            }
+            else if (Number(src.leftX) === 0 && Number(src.leftY) === 0) {
+                err(r, `${key}: 禁止伪自定义父格 (0,0)`);
+            }
+        }
+        const queryCell = s.match(/[?&]([^=&]+)=([A-Za-z]+\d+)\b/g) || [];
+        for (const q of queryCell) {
+            const pname = q.replace(/^[?&]/, '').split('=')[0];
+            if (FORBIDDEN_PARAM_NAMES.has(pname.toLowerCase())) {
+                warn(r, `${key}: 参数名「${pname}」易与系统关键字冲突，建议改用 zclb/zcmc 等`);
+            }
+        }
+        if (/[?&][^=]+=\{[A-Za-z]+\d+\}/.test(s)) {
+            err(r, `${key}: 查询串单元格传参不要写 param={D7}；应为 param=D7（无花括号）。花括号只用于路径占位。`);
+        }
+        if (/\{[^{}]*searchfield\d+/.test(s)) {
+            warn(r, `${key}: 含查询条件占位 {searchfield00x}，请确认 asIndex 与条件配置一致`);
+        }
+        if (/\$[^$]+\.[^$]+\$/.test(s)) {
+            warn(r, `${key}: 含 $数据集.字段$ 老写法；引擎可用，但推荐查询串「参数名=坐标」或路径「/{坐标}」`);
+        }
+        return s;
+    };
+    if (src.pcHreflink !== undefined || src.hreflink !== undefined) {
+        out.pcHreflink = checkLink(src.pcHreflink ?? src.hreflink, 'pcHreflink');
+    }
+    if (src.h5Hreflink !== undefined || src.mbhreflink !== undefined) {
+        out.h5Hreflink = checkLink(src.h5Hreflink ?? src.mbhreflink, 'h5Hreflink');
+    }
+    return { ...r, normalized: out };
+}
+/** 超链接写法速查（`validate href --list`）。 */
+export function hrefCatalog() {
+    return {
+        openTypes: OPEN_TYPE_MAP,
+        rules: {
+            queryCell: '参数名=坐标（无花括号），如 zclb=D7&zcmc=E7',
+            pathCell: '/sp/.../card/0/{id}/{C4}',
+            queryCondition: '{searchfield001}',
+            asciiOnly: '禁止全角 ？＆；必须 ASCII ? &',
+            avoidParamNames: ['id', 'name'],
+            parentChain: '仅当前格 + 左/上父格（父格的父格也算）',
+        },
+    };
+}
+//# sourceMappingURL=validate.js.map