// SkinTone 肤色枚举与家族展开。

///|
/// emoji 肤色。变体顺序与编号严格对齐上游 `SkinTone`(Default=0 … DarkAndMediumDark=25),
/// 数据表中的肤色族按此顺序连续排列。
///
/// The skin tone of an emoji. Variant order matches upstream `SkinTone`
/// exactly; skin-tone families in the data table are laid out consecutively
/// in this order. (Upstream `SkinTone`)
#derive(Compare, Eq, Debug)
pub(all) enum SkinTone {
  Default
  Light
  MediumLight
  Medium
  MediumDark
  Dark
  LightAndMediumLight
  LightAndMedium
  LightAndMediumDark
  LightAndDark
  MediumLightAndLight
  MediumLightAndMedium
  MediumLightAndMediumDark
  MediumLightAndDark
  MediumAndLight
  MediumAndMediumLight
  MediumAndMediumDark
  MediumAndDark
  MediumDarkAndLight
  MediumDarkAndMediumLight
  MediumDarkAndMedium
  MediumDarkAndDark
  DarkAndLight
  DarkAndMediumLight
  DarkAndMedium
  DarkAndMediumDark
}

///|
pub extend SkinTone with Compare::{op_lt, op_le, op_ge, compare, op_gt}

///|
pub extend SkinTone with Eq::{not_equal, equal}

///|
pub extend SkinTone with @moonbitlang/core/debug.Debug::{to_repr}

///|
/// SkinTone 序号转枚举(数据表 tone_idx 列 → SkinTone)。
fn tone_from_idx(i : Int32) -> SkinTone? {
  if i < 0 || i > 25 {
    return None
  }
  Some(
    match i {
      0 => Default
      1 => Light
      2 => MediumLight
      3 => Medium
      4 => MediumDark
      5 => Dark
      6 => LightAndMediumLight
      7 => LightAndMedium
      8 => LightAndMediumDark
      9 => LightAndDark
      10 => MediumLightAndLight
      11 => MediumLightAndMedium
      12 => MediumLightAndMediumDark
      13 => MediumLightAndDark
      14 => MediumAndLight
      15 => MediumAndMediumLight
      16 => MediumAndMediumDark
      17 => MediumAndDark
      18 => MediumDarkAndLight
      19 => MediumDarkAndMediumLight
      20 => MediumDarkAndMedium
      21 => MediumDarkAndDark
      22 => DarkAndLight
      23 => DarkAndMediumLight
      24 => DarkAndMedium
      _ => DarkAndMediumDark
    },
  )
}

///|
/// 枚举转序号(with_skin_tone 索引用)。
fn tone_to_idx(tone : SkinTone) -> Int32 {
  match tone {
    Default => 0
    Light => 1
    MediumLight => 2
    Medium => 3
    MediumDark => 4
    Dark => 5
    LightAndMediumLight => 6
    LightAndMedium => 7
    LightAndMediumDark => 8
    LightAndDark => 9
    MediumLightAndLight => 10
    MediumLightAndMedium => 11
    MediumLightAndMediumDark => 12
    MediumLightAndDark => 13
    MediumAndLight => 14
    MediumAndMediumLight => 15
    MediumAndMediumDark => 16
    MediumAndDark => 17
    MediumDarkAndLight => 18
    MediumDarkAndMediumLight => 19
    MediumDarkAndMedium => 20
    MediumDarkAndDark => 21
    DarkAndLight => 22
    DarkAndMediumLight => 23
    DarkAndMedium => 24
    DarkAndMediumDark => 25
  }
}

///|
/// 返回当前 emoji 的肤色;肤色不适用时返回 None。
///
/// Returns the skin tone of this emoji, or None when skin tones are not
/// applicable. (Upstream `skin_tone()`)
pub fn Emoji::skin_tone(self : Emoji) -> SkinTone? {
  tone_from_idx(self.tone_idx)
}

///|
/// 迭代该 emoji 及其全部肤色变体(从默认版开始);肤色不适用时返回 None。
///
/// Returns an iterator over the emoji and all related skin tone emojis,
/// starting from the default version; None when not applicable.
/// (Upstream `skin_tones()`)
pub fn Emoji::skin_tones(self : Emoji) -> Iter[Emoji]? {
  if self.base_idx < 0 {
    return None
  }
  let b = self.base_idx
  let n = self.variant_n
  let arr : Array[Emoji] = []
  for i in b..<(b + n) {
    arr.push(emoji_at(i))
  }
  Some(arr.iter())
}

///|
/// 返回指定肤色的变体版本;肤色不适用或族内无该序号时返回 None。
///
/// Returns a version of this emoji with the given skin tone; None when
/// not applicable or the tone is out of the family.
/// (Upstream `with_skin_tone()`)
pub fn Emoji::with_skin_tone(self : Emoji, tone : SkinTone) -> Emoji? {
  if self.base_idx < 0 {
    return None
  }
  let ti = tone_to_idx(tone)
  if ti >= self.variant_n {
    return None
  }
  Some(emoji_at(self.base_idx + ti))
}

///|
/// 返回首个 gemoji 短码;无短码时返回 None。
///
/// Returns the first GitHub shortcode, or None if the emoji has none.
/// (Upstream `shortcode()`)
pub fn Emoji::shortcode(self : Emoji) -> String? {
  if self.shortcodes.length() == 0 {
    None
  } else {
    Some(self.shortcodes[0])
  }
}

///|
/// 人类可读肤色名(与上游 Debug 输出一致)。
///
/// Human-readable skin tone name, matching upstream Debug output.
/// (MoonBit-specific, @since 0.1.0 moonbit)
pub fn SkinTone::to_string(self : SkinTone) -> String {
  match self {
    Default => "Default"
    Light => "Light"
    MediumLight => "MediumLight"
    Medium => "Medium"
    MediumDark => "MediumDark"
    Dark => "Dark"
    LightAndMediumLight => "LightAndMediumLight"
    LightAndMedium => "LightAndMedium"
    LightAndMediumDark => "LightAndMediumDark"
    LightAndDark => "LightAndDark"
    MediumLightAndLight => "MediumLightAndLight"
    MediumLightAndMedium => "MediumLightAndMedium"
    MediumLightAndMediumDark => "MediumLightAndMediumDark"
    MediumLightAndDark => "MediumLightAndDark"
    MediumAndLight => "MediumAndLight"
    MediumAndMediumLight => "MediumAndMediumLight"
    MediumAndMediumDark => "MediumAndMediumDark"
    MediumAndDark => "MediumAndDark"
    MediumDarkAndLight => "MediumDarkAndLight"
    MediumDarkAndMediumLight => "MediumDarkAndMediumLight"
    MediumDarkAndMedium => "MediumDarkAndMedium"
    MediumDarkAndDark => "MediumDarkAndDark"
    DarkAndLight => "DarkAndLight"
    DarkAndMediumLight => "DarkAndMediumLight"
    DarkAndMedium => "DarkAndMedium"
    DarkAndMediumDark => "DarkAndMediumDark"
  }
}