import type { BackthinkItem } from "../../lib/types";

/**
 * 后台思考行「紧急度 / 穿透安静时段」标记的**纯逻辑**（契约 v0.70 §4.10(b)）。
 *
 * 三种态必须画得**不一样**，否则就是把猜当事实：
 *   - **精确档位**：后端 `urgency` 就是该轮实际生效的档位（随记录落库，`urgencyLowerBound` 缺席）；
 *   - **≥ 下限**：`urgencyLowerBound:true` ⇒ 该行没有落库档位（旧行 / 未走到档位判定点的行），
 *     此值由安静时段窗口规则推导：`≥ 高` = 至少 high、可能更高；`≥ 例常` = 只确定不低于最低档；
 *   - **未知**：`urgency` 键缺席 ⇒ 存档里没有这个事实（**不是**「例常」）。
 *   - `quietHoursBypassed` 只在 true 时渲染「穿透安静时段」。
 */

export type UrgencyTagTone = "ok" | "warn" | "err" | "neutral" | "accent";

export interface UrgencyTag {
  label: string;
  tone: UrgencyTagTone;
  /** 悬停说明（为什么是这个档位 / 为什么只是下限 / 为什么未知），给人看的口径。 */
  hint: string;
}

/** 档位未知时的标签（键缺席 = 后端没有这个事实）。 */
export const URGENCY_UNKNOWN_LABEL = "档位未知";

/** 下限标签的前缀：推导值一律带它，保证与精确档位**一眼可辨**。 */
export const URGENCY_LOWER_BOUND_PREFIX = "≥ ";

/** 穿透安静时段的标签。 */
export const QUIET_HOURS_BYPASS_LABEL = "穿透安静时段";

/** 精确档位的标签：后端 `urgency` 词汇 → 人话。 */
const EXACT_LABEL: Record<string, string> = {
  routine: "例常",
  warning: "紧急（高）",
  critical: "紧急·安全域",
};

/** 精确档位的色调（安全域 err / 高 warn / 其余中性）。 */
function exactTone(level: string): UrgencyTagTone {
  if (level === "critical") return "err";
  if (level === "warning") return "warn";
  return "neutral";
}

/** 下限的悬停说明：点明它是怎么推出来的、以及为什么它**不是**精确值。 */
const LOWER_BOUND_HINT =
  "这一行没有存档档位（档位列出现之前的旧记录，或从未走到档位判定点的行）⇒ 精确档位已无从得知，" +
  "此值是安静时段窗口规则推导出的下限：窗口内被放行 ⇒ 至少 high（可能是安全域）；" +
  "被扣下 ⇒ 只确定不低于最低档。不是精确档位。";

/** urgencyTag 把后端 `urgency` + `urgencyLowerBound` 映射成标签。 */
export function urgencyTag(item: Pick<BackthinkItem, "urgency" | "urgencyLowerBound">): UrgencyTag {
  const level = item.urgency;
  if (level === undefined || level === "") {
    return {
      label: URGENCY_UNKNOWN_LABEL,
      tone: "neutral",
      hint: "这一轮的档位在存档里不存在（该行没有落库档位，且不在安静时段窗口内 —— 窗口之外判定不看档位）——不是「例常」",
    };
  }
  if (item.urgencyLowerBound === true) {
    return {
      // 未知取值原样显示（后端加了本面板不认识的档位时不猜一个更好听的词），但下限前缀照加。
      label: URGENCY_LOWER_BOUND_PREFIX + (EXACT_LABEL[level] ?? level),
      tone: exactTone(level),
      hint: LOWER_BOUND_HINT,
    };
  }
  const exact = EXACT_LABEL[level];
  if (exact === undefined) {
    return { label: level, tone: "neutral", hint: "后端给了本面板不认识的档位，原样显示" };
  }
  return { label: exact, tone: exactTone(level), hint: `该轮实际生效的档位（精确值）：${level}` };
}

/** quietHoursBypassTag 只在后端确实标记了穿透时返回标签。 */
export function quietHoursBypassTag(item: Pick<BackthinkItem, "quietHoursBypassed">): UrgencyTag | null {
  if (item.quietHoursBypassed !== true) return null;
  return {
    label: QUIET_HOURS_BYPASS_LABEL,
    tone: "accent",
    hint: "这一轮落在安静时段窗口内、但仍被放行发出（档位 ≥ high）",
  };
}