/**
 * 组件列定义 / 表头跨列的字符串解析。
 * <p>
 * 「列」这件事必须能被编码成**一个标量字符串**：组件业务属性的类型只有
 * boolean / enum / number / string / text（见 {@link QualityFieldSchema}），
 * 最终还会落到画布节点的 attributes 上，而那里也是字符串映射。
 * 用 JSON 编码列数组会要求模型输出转义后的嵌套 JSON，是它出错的重灾区；
 * 一行 `标题=绑定|标题=绑定` 信息量相同，模型、人都好写。
 * <p>
 * 必须单行：这串东西最终是 HTML 属性值，换行在属性里合法但容易被
 * 编辑器/序列化环节改写，统一按单行处理。
 * <p>
 * 解析放在这里而不是各组件内部，是因为校验列与表头跨列都依赖同一套语法，
 * 两份实现迟早漂移，而漂移的表现是「列数对不上」这种很难查的渲染事故。
 */

/** 一列：表头文字 + 行内取值表达式 */
export interface QualityColumnSpec {
  /** 表头文字，已剥掉合并标记前缀 */
  label: string;
  /** 行内取值表达式，如 {{item.itemName}} */
  expr: string;
  /** 是否纵向合并跨住整组（标题前写了 #） */
  merge: boolean;
}

/** 上层表头的一个单元格 */
export interface QualityHeaderSpan {
  label: string;
  span: number;
}

/** 解析结果：能解析出多少算多少，错误逐条回报，由调用方决定是否拦下保存 */
export interface QualitySpecParseResult<T> {
  items: T[];
  errors: string[];
}

/** 列与列之间的分隔符 */
const SEGMENT_SEPARATOR = '|';

/** 合并列的标记前缀 */
const MERGE_MARK = '#';

/** 表头跨列的计数标记 */
const SPAN_MARK = '^';

/**
 * 解析列定义串。
 *
 * @param spec 形如 `序号={{index}}|#检验项目={{item.itemName}}|子项={{item.group.childName}}`
 * @returns 列定义与错误清单；空串返回空数组，由调用方回落到组件默认列
 */
export function parseColumnSpec(spec: string | undefined): QualitySpecParseResult<QualityColumnSpec> {
  const errors: string[] = [];
  const items: QualityColumnSpec[] = [];
  const segments = splitSegments(spec);
  segments.forEach((segment, index) => {
    const position = `第 ${index + 1} 段「${segment}」`;
    const separatorAt = segment.indexOf('=');
    if (separatorAt < 0) {
      errors.push(`${position}缺少「=」，每一列都要写成「列标题=绑定表达式」`);
      return;
    }
    const rawLabel = segment.slice(0, separatorAt).trim();
    const expr = segment.slice(separatorAt + 1).trim();
    const merge = rawLabel.startsWith(MERGE_MARK);
    const label = merge ? rawLabel.slice(MERGE_MARK.length).trim() : rawLabel;
    if (!label) {
      errors.push(`${position}的列标题是空的，请补上打印在表头上的文字`);
      return;
    }
    if (!expr) {
      errors.push(`${position}的绑定表达式是空的，请补上「=」后面的内容，如 {{item.itemName}}`);
      return;
    }
    items.push({ label, expr, merge });
  });
  return { items, errors };
}

/**
 * 解析上层表头串。
 *
 * @param spec        形如 `检验结果^5|结论^1`；写不出 `^N` 的按 1 列算，靠总数校验兜底
 * @param columnCount 下层实际列数，用来校验各段跨列数之和
 */
export function parseHeaderSpans(
  spec: string | undefined,
  columnCount: number,
): QualitySpecParseResult<QualityHeaderSpan> {
  const errors: string[] = [];
  const items: QualityHeaderSpan[] = [];
  const segments = splitSegments(spec);
  // 没填就是「不要上层表头」，不是「跨列数合计为 0」——不能拿它去撞总数校验
  if (segments.length === 0) {
    return { items, errors };
  }
  segments.forEach((segment, index) => {
    const position = `第 ${index + 1} 段「${segment}」`;
    const markAt = segment.lastIndexOf(SPAN_MARK);
    const rawLabel = (markAt < 0 ? segment : segment.slice(0, markAt)).trim();
    const rawSpan = markAt < 0 ? '' : segment.slice(markAt + 1).trim();
    if (!rawLabel) {
      errors.push(`${position}的表头文字是空的，请补上跨越这几列的分组标题`);
      return;
    }
    const span = rawSpan ? Number(rawSpan) : 1;
    if (!Number.isInteger(span) || span < 1) {
      errors.push(`${position}的跨列数「${rawSpan}」不是正整数，请写成如 检验结果^5 的形式`);
      return;
    }
    items.push({ label: rawLabel, span });
  });
  if (errors.length > 0) {
    return { items, errors };
  }
  const total = items.reduce((sum, item) => sum + item.span, 0);
  if (total !== columnCount) {
    errors.push(
      `表头跨列数合计 ${total}，检验表的实际列数为 ${columnCount}，两者必须相等。` +
        `请检查「表头跨列」里各段末尾 ^ 后面的数字`,
    );
  }
  return { items, errors };
}

/** 按 `|` 切段：空段（首尾多写了分隔符）直接跳过，不当作错误，避免手滑就报错 */
function splitSegments(spec: string | undefined): string[] {
  if (!spec) {
    return [];
  }
  return spec
    .split(SEGMENT_SEPARATOR)
    .map((segment) => segment.trim())
    .filter((segment) => segment.length > 0);
}