/**
 * 单位换算（界面层）——「字段库单位」这件事唯一的一处实现。
 *
 * 背景（2026-10）：字段库里的单位分两层，写错任何一层都会让策略静默算错：
 *
 * - **基准单位**（`ConditionField.base_unit`）：引擎存储与比较用的单位，由数据源落库口径
 *   决定（总市值=万元、成交额=元、成交量=股），**不可改**。策略 JSON、归档里的
 *   ConditionSpec、引擎求值全部只用基准单位 —— 所以归档永远复现得出来。
 * - **界面单位**（`ConditionField.unit`）：只在输入/显示这一层用的单位，用户可以在字段库里
 *   从 `units` 给定的阶梯里选（万元 ⇄ 亿元）。提交前 ×factor，回显时 ÷factor。
 *
 * 这样「把总市值改成亿元」会立刻生效（输入 5 就是 5 亿元），但不会改动任何已存策略的
 * 含义 —— 库里存的仍是 50000 万元。
 */
import type { ConditionField, UnitOption } from "@/lib/types";

/** 该字段当前界面单位 → 基准单位的换算系数（没有备选单位 → 1）。 */
export function unitScale(meta: ConditionField | undefined | null): number {
  if (!meta?.units?.length || meta.units.length < 2) return 1;
  return meta.units.find((u) => u.unit === meta.unit)?.factor ?? 1;
}

/** 基准单位值 → 界面单位值（除以系数）。 */
export function fromBase(v: number, scale: number): number {
  return !scale || scale === 1 ? v : Number((v / scale).toPrecision(12));
}

/** 界面单位值 → 基准单位值（乘以系数）。 */
export function toBase(v: number, scale: number): number {
  return !scale || scale === 1 ? v : Number((v * scale).toPrecision(12));
}

/** 基准单位（引擎口径）；字段不在库里时为空。 */
export function baseUnitOf(meta: ConditionField | undefined | null): string {
  return meta?.base_unit || meta?.unit || "";
}

/** 界面上该显示的单位后缀：只有真的能换算（有备选且当前不是基准）时才显示。 */
export function displayUnitOf(meta: ConditionField | undefined | null): string {
  return unitScale(meta) === 1 ? "" : (meta?.unit ?? "");
}

/** 单位阶梯的说明文字，如「1 亿元 = 10000 万元」。 */
export function unitNote(meta: ConditionField | undefined | null): string {
  const scale = unitScale(meta);
  if (scale === 1) return "";
  return `1 ${meta?.unit} = ${scale} ${baseUnitOf(meta)}（引擎按基准单位比较）`;
}

/** 某个单位在阶梯里的系数（找不到 → 1）。 */
export function factorOf(units: UnitOption[] | undefined, unit: string): number {
  return units?.find((u) => u.unit === unit)?.factor ?? 1;
}