<?php

namespace Overtrue\Pinyin;

use InvalidArgumentException;

/**
 * @method static Converter surname()
 * @method static Converter noWords()
 * @method static Converter onlyHans()
 * @method static Converter noAlpha()
 * @method static Converter noNumber()
 * @method static Converter noCleanup()
 * @method static Converter noPunctuation()
 * @method static Converter noTone()
 * @method static Converter useNumberTone()
 * @method static Converter yuToV()
 * @method static Converter yuToU()
 * @method static Converter polyphonic(bool $asList = false)
 * @method static Converter withToneStyle(string $toneStyle = 'symbol')
 * @method static Collection convert(string $string, callable $beforeSplit = null)
 */
class Pinyin
{
    public static function name(string $name, string $toneStyle = Converter::TONE_STYLE_SYMBOL): Collection
    {
        return self::converter()->surname()->withToneStyle($toneStyle)->convert($name);
    }

    public static function passportName(string $name, string $toneStyle = Converter::TONE_STYLE_NONE): Collection
    {
        return self::converter()->surname()->yuToYu()->withToneStyle($toneStyle)->convert($name);
    }

    public static function phrase(string $string, string $toneStyle = Converter::TONE_STYLE_SYMBOL): Collection
    {
        return self::converter()->noPunctuation()->withToneStyle($toneStyle)->convert($string);
    }

    public static function sentence(string $string, string $toneStyle = Converter::TONE_STYLE_SYMBOL): Collection
    {
        return self::converter()->withToneStyle($toneStyle)->convert($string);
    }

    public static function fullSentence(string $string, string $toneStyle = Converter::TONE_STYLE_SYMBOL): Collection
    {
        return self::converter()->noCleanup()->withToneStyle($toneStyle)->convert($string);
    }

    public static function heteronym(string $string, string $toneStyle = Converter::TONE_STYLE_SYMBOL, bool $asList = false): Collection
    {
        return self::converter()->heteronym($asList)->withToneStyle($toneStyle)->convert($string);
    }

    public static function heteronymAsList(string $string, string $toneStyle = Converter::TONE_STYLE_SYMBOL): Collection
    {
        return self::heteronym($string, $toneStyle, true);
    }

    /**
     * @deprecated Use `heteronym` instead.
     *             This method will be removed in the next major version.
     */
    public static function polyphones(string $string, string $toneStyle = Converter::TONE_STYLE_SYMBOL, bool $asList = false): Collection
    {
        return self::heteronym($string, $toneStyle, $asList);
    }

    /**
     * @deprecated Use `heteronymAsList` instead.
     *             This method will be removed in the next major version.
     */
    public static function polyphonesAsArray(string $string, string $toneStyle = Converter::TONE_STYLE_SYMBOL): Collection
    {
        return self::heteronym($string, $toneStyle, true);
    }

    public static function chars(string $string, string $toneStyle = Converter::TONE_STYLE_SYMBOL): Collection
    {
        return self::converter()->onlyHans()->noWords()->withToneStyle($toneStyle)->convert($string);
    }

    public static function permalink(string $string, string $delimiter = '-'): string
    {
        if (! in_array($delimiter, ['_', '-', '.', ''], true)) {
            throw new InvalidArgumentException("Delimiter must be one of: '_', '-', '', '.'.");
        }

        return self::converter()->noPunctuation()->noTone()->convert($string)->join($delimiter);
    }

    public static function nameAbbr(string $string): Collection
    {
        return self::abbr($string, true);
    }

    public static function abbr(string $string, bool $asName = false, bool $preserveEnglishWords = false): Collection
    {
        return self::converter()->noTone()
            ->noPunctuation()
            ->when($asName, fn ($c) => $c->surname())
            ->convert($string)
            ->map(function ($pinyin) use ($string, $preserveEnglishWords) {
                // 如果内容在原字符串中，则直接返回
                if ($preserveEnglishWords && str_contains($string, $pinyin)) {
                    return $pinyin;
                }

                // 常用于电影名称入库索引处理，例如：《晚娘2012》-> WN2012
                return \is_numeric($pinyin) || preg_match('/\d{2,}/', $pinyin) ? $pinyin : \mb_substr($pinyin, 0, 1);
            });
    }

    public static function converter(): Converter
    {
        return Converter::make();
    }

    public static function __callStatic(string $name, array $arguments)
    {
        $converter = self::converter();

        if (\method_exists($converter, $name)) {
            return $converter->$name(...$arguments);
        }

        throw new InvalidArgumentException("Method {$name} does not exist.");
    }
}