// MoonBit 增值 API(非上游 emojis 0.9.1 API 面,@since 0.1.0 moonbit)。
// 基于数据表 default_idxs(默认肤色子集,CLDR 顺序)。

///|
/// 按名称精确查询 emoji(默认肤色子集内的 CLDR 名称,如 "rocket");
/// 多个同名时返回 CLDR 顺序第一个。
///
/// Lookup an emoji by exact CLDR name within the default skin tone subset.
/// Returns the first match in CLDR order.
/// (MoonBit-specific, @since 0.1.0 moonbit)
pub fn get_by_name(name : String) -> Emoji? {
  let mut i = 0
  while i < @data.default_idxs.length() {
    let idx = @data.default_idxs[i]
    if @data.emojis_names[idx] == name {
      return Some(emoji_at(idx))
    }
    i += 1
  }
  None
}

///|
/// 按 CLDR 名称大小写不敏感子串搜索 emoji(默认肤色子集,CLDR 顺序)。
///
/// Search emojis whose CLDR name contains the given term
/// (case-insensitive, default skin tone subset, CLDR order).
/// (MoonBit-specific, @since 0.1.0 moonbit)
pub fn search(term : String) -> Array[Emoji] {
  let t = term.to_lower()
  let arr : Array[Emoji] = []
  let mut i = 0
  while i < @data.default_idxs.length() {
    let idx = @data.default_idxs[i]
    if @data.emojis_names[idx].to_lower().contains(t) {
      arr.push(emoji_at(idx))
    }
    i += 1
  }
  arr
}

///|
/// 随机取一个默认肤色 emoji(使用系统随机源,每次调用独立)。
///
/// Pick a random emoji from the default skin tone subset using a fresh
/// random source. (MoonBit-specific, @since 0.1.0 moonbit)
pub fn random() -> Emoji? {
  let r : @random.Rand = @random.Rand::Rand()
  random_with(r)
}

///|
/// 用给定随机源随机取一个 emoji(可复现:如 `@random.Rand::chacha8(seed)`)。
///
/// Pick a random emoji using the given random source; reproducible with
/// a seeded source such as chacha8.
/// (MoonBit-specific, @since 0.1.0 moonbit)
pub fn random_with(r : @random.Rand) -> Emoji? {
  let c = @data.default_idxs.length()
  if c == 0 {
    return None
  }
  Some(emoji_at(@data.default_idxs[r.int(limit=c)]))
}

///|
/// 迭代 Unicode 版本 >= v 的默认肤色 emoji(CLDR 顺序)。
///
/// Iterate emojis whose Unicode version is greater than or equal to v
/// (default skin tone subset, CLDR order). Mirrors the upstream
/// recommendation of filtering by `unicode_version()`.
/// (MoonBit-specific, @since 0.1.0 moonbit)
pub fn iter_version_ge(v : Version) -> Iter[Emoji] {
  iter().filter(fn(e) { e.unicode_version() >= v })
}