commonMain.mahjongutils.shanten.CommonShantenArgs.kt Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of mahjong-utils Show documentation

Mahjong Utils (for Japanese Riichi Mahjong)

The newest version!

package mahjongutils.shanten

import kotlinx.serialization.Serializable
import mahjongutils.ErrorInfo
import mahjongutils.ValidationException
import mahjongutils.models.Furo
import mahjongutils.models.Tile
import mahjongutils.models.countAsCodeArray


/**
 * 向听分析参数
 * @param tiles 门前的牌
 * @param furo 副露（对向听分析本身无用，但若需要将结果用于和了分析则需要传入）
 * @param bestShantenOnly 仅计算最优向听数的打法（不计算退向打法）
 * @param mode 向听分析模式
 *
 * @see [ShantenMode]
 */
@Serializable
data class CommonShantenArgs(
    val tiles: List,
    val furo: List = emptyList(),
    val bestShantenOnly: Boolean = false
)

enum class CommonShantenArgsErrorInfo(override val message: String) : ErrorInfo {
    tilesIsEmpty("tiles is empty"),
    tooManyFuro("you have too many furo"),
    tooManyTiles("you have too many tiles"),
    anyTileMoreThan4("you cannot have any tile more than 4"),
    tilesNumIllegal("you should have 3n+1 or 3n+2 tiles for shanten calculation")
}

class CommonShantenArgsValidationException(
    val args: CommonShantenArgs,
    errors: Collection
) : ValidationException(errors)

fun CommonShantenArgs.validate(): Collection = buildList {
    if (tiles.isEmpty()) {
        add(CommonShantenArgsErrorInfo.tilesIsEmpty)
    }

    if (furo.size > 4) {
        add(CommonShantenArgsErrorInfo.tooManyFuro)
    }

    if (tiles.size + furo.size * 3 > 14) {
        add(CommonShantenArgsErrorInfo.tooManyTiles)
    }

    if ((tiles + furo.flatMap { it.tiles }).countAsCodeArray().any { it > 4 }) {
        add(CommonShantenArgsErrorInfo.anyTileMoreThan4)
    }

    if (tiles.size % 3 == 0) {
        add(CommonShantenArgsErrorInfo.tilesNumIllegal)
    }
}

@Throws(CommonShantenArgsValidationException::class)
fun CommonShantenArgs.throwOnValidationError() {
    val errors = validate()
    if (errors.isNotEmpty()) {
        throw CommonShantenArgsValidationException(this, errors)
    }
}