// 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"
}
}