/// 时间: 2026-04-02
/// 功能: 拼音处理辅助类
/// 介绍: 使用pinyin库为汉字生成带音调的拼音
/// 最新变化: 2026-04-02 修正API使用方式，避免递归调用

import 'package:pinyin/pinyin.dart' as pinyin;

class PinyinHelper {
  /// 将汉字转换为带音调的拼音
  static String convertToPinyin(String text) {
    if (text.isEmpty) return '';

    try {
      // 使用pinyin库将汉字转换为拼音
      return pinyin.PinyinHelper.getPinyin(
        text,
        separator: ' ',
        format: pinyin.PinyinFormat.WITH_TONE_MARK,
      );
    } catch (e) {
      // 无法转换时返回空字符串
      return '';
    }
  }

  /// 为诗词内容生成拼音
  static String generatePoetryPinyin(String content) {
    if (content.isEmpty) return '';

    // 按行分割诗词
    List<String> lines = content.split('\n');
    List<String> pinyinLines = [];

    // 为每行生成拼音
    for (String line in lines) {
      if (line.trim().isNotEmpty) {
        String linePinyin = convertToPinyin(line);
        pinyinLines.add(linePinyin);
      } else {
        pinyinLines.add('');
      }
    }

    return pinyinLines.join('\n');
  }

  /// 将字符串转换为每个汉字及其对应的拼音的列表
  static List<Map<String, String>> convertToCharPinyinList(String text) {
    if (text.isEmpty) return [];

    List<Map<String, String>> result = [];

    try {
      // 为每个字符生成拼音
      for (int i = 0; i < text.length; i++) {
        String char = text[i];
        String charPinyin = '';

        try {
          charPinyin = pinyin.PinyinHelper.getPinyin(
            char,
            separator: ' ',
            format: pinyin.PinyinFormat.WITH_TONE_MARK,
          );
        } catch (e) {
          // 无法转换时使用空字符串
          charPinyin = '';
        }

        result.add({'char': char, 'pinyin': charPinyin});
      }
    } catch (e) {
      // 发生错误时返回空列表
      return [];
    }

    return result;
  }
}