/**
 * 质量组件注册表 → AI 积木清单
 * <p>
 * 清单是注册表的**派生视图**：剥掉 icon / buildContent / validate 这些不可序列化的成员，
 * 只留下模型需要知道的「有哪些组件、每个组件能填哪些字段」。
 * <p>
 * 这份清单随请求传给后端拼进提示词，但它<b>不是</b>合法性的判据：真正把关的是装配器
 * 对着活注册表查 getQualityComponent。模型即便编出清单外的 type，也只会被跳过，
 * 永远变不成任意 HTML（清单里不含任何 HTML 能力的描述）。
 */
import type { QualityFieldSchema } from './types';

import { listQualityComponents } from './registry';

/** 清单里的一个可填字段，与后端 QcReportComponentSpecVO.Field 一一对应 */
export interface QualityCatalogField {
  key: string;
  label: string;
  type: QualityFieldSchema['type'];
  required?: boolean;
  bindable?: boolean;
  /**
   * 枚举候选项。
   * <p>
   * 用 {label, value} 成对给出：只给 label 模型会照着输出中文标签，
   * 只给 value 又不知道含义。成对给出，它才知道该输出哪个字面量。
   */
  enumOptions?: { label: string; value: number | string }[];
}

/** 一个组件积木 */
export interface QualityComponentCatalog {
  type: string;
  label: string;
  /** 组件分类的中文显示名，帮模型理解组件用途 */
  category: string;
  /**
   * 组件的选型说明，来自注册表的 aiHint。
   * <p>
   * 只有 label 时，模型面对「报告抬头」这类内容会在 Heading / Text / ReportHeader 之间瞎猜，
   * 且总会挑字段最简单的基础组件。这段文字就是给它划边界的，不是给人看的。
   */
  hint?: string;
  fields: QualityCatalogField[];
}

/** 从活注册表生成积木清单，顺序与设计器左侧面板一致 */
export function buildQualityComponentCatalog(): QualityComponentCatalog[] {
  const definitions = listQualityComponents();
  // 注册表要显式调用 registerAllQualityComponents() 才有内容（设计器在 init 时做）。
  // 空清单会被后端判为入参非法，报出来的错和真实原因隔了好几层，所以在这里就说清楚。
  if (definitions.length === 0) {
    throw new Error('质量组件注册表为空，请先调用 registerAllQualityComponents()');
  }
  return definitions.map((definition) => {
    const item: QualityComponentCatalog = {
      type: definition.type,
      label: definition.label,
      category: definition.category,
      fields: definition.propertySchema.map(toCatalogField),
    };
    // 缺席即省略，与 toCatalogField 同一风格：省掉的字段能明显缩小提示词
    if (definition.aiHint) {
      item.hint = definition.aiHint;
    }
    return item;
  });
}

function toCatalogField(field: QualityFieldSchema): QualityCatalogField {
  const item: QualityCatalogField = {
    key: field.key,
    label: field.label,
    type: field.type,
  };
  // 缺席即「否」，省掉的字段能明显缩小提示词
  if (field.required) {
    item.required = true;
  }
  if (field.bindable) {
    item.bindable = true;
  }
  if (field.options?.length) {
    item.enumOptions = field.options.map((option) => ({
      label: option.label,
      value: option.value,
    }));
  }
  return item;
}