riichi 0.1.0

Japanese Riichi Mahjong game engine
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176

//! Mappings between various string representations 

use crate::{
    model::*,
    yaku::*,
};

pub static ABORT_STR_TO_ENUM: phf::Map<&'static str, AbortReason> = phf::phf_map! {
  "流局"     => AbortReason::WallExhausted,
  "全員不聴" => AbortReason::WallExhausted,  // legacy code
  "全員聴牌" => AbortReason::WallExhausted,  // legacy code
  "流し満貫" => AbortReason::NagashiMangan,
  "九種九牌" => AbortReason::NineKinds,
  "三家和了" => AbortReason::TripleRon,
  "四風連打" => AbortReason::FourWind,
  "四家立直" => AbortReason::FourRiichi,
  "四槓散了" => AbortReason::FourKan,
};

/// Tenhou round result string => [`AbortReason`].
pub fn abort_from_str(str: &str) -> Option<AbortReason> {
    ABORT_STR_TO_ENUM.get(str).copied()
}

pub const fn abort_to_str(abort_reason: AbortReason) -> &'static str {
    match abort_reason {
        AbortReason::WallExhausted => "流局",
        AbortReason::NagashiMangan => "流し満貫",
        AbortReason::NineKinds => "九種九牌",
        AbortReason::DoubleRon => "",  // I have not seen this in any public Tenhou logs
        AbortReason::TripleRon => "三家和了",
        AbortReason::FourWind => "四風連打",
        AbortReason::FourRiichi => "四家立直",
        AbortReason::FourKan => "四槓散了",
    }
}

/// [`ActionResult`] => Tenhou round result string.
pub const fn action_result_to_str(action_result: ActionResult) -> &'static str {
    match action_result {
        ActionResult::Abort(abort_reason) => abort_to_str(abort_reason),
        ActionResult::Agari(_) => AGARI_STR,
        _ => "",
    }
}

/// Represents either Tsumo-Agari or Ron-Agari.
pub const AGARI_STR: &str = "和了";

/// [`AbortReason::WallExhausted`], except everyone is waiting (legacy format).
pub const ALL_WAITING: &str = "全員聴牌";
/// [`AbortReason::WallExhausted`], except no one is waiting (legacy format).
pub const NONE_WAITING: &str = "全員不聴";

pub const DORA_STR: &str = "ドラ";
pub const AKA_DORA_STR: &str = "赤ドラ";
pub const URA_DORA_STR: &str = "裏ドラ";

// TODO(summivox): Use the `strum` impl inlined into [`Yaku`].
/// Tenhou Yaku string => [`Yaku`].
pub static YAKU_STR_TO_ENUM: phf::Map<&'static str, Yaku> = phf::phf_map! {
    "門前清自摸和" => Yaku::Menzenchintsumohou,
    "立直" => Yaku::Riichi,
    "一発" => Yaku::Ippatsu,
    "槍槓" => Yaku::Chankan,
    "嶺上開花" => Yaku::Rinshankaihou,
    "海底摸月" => Yaku::Haiteimouyue,
    "河底撈魚" => Yaku::Houteiraoyui,
    "平和" => Yaku::Pinfu,
    "断幺九" => Yaku::Tanyaochuu,
    "一盃口" => Yaku::Iipeikou,
    "自風 東" => Yaku::JikazehaiE,
    "自風 南" => Yaku::JikazehaiS,
    "自風 西" => Yaku::JikazehaiW,
    "自風 北" => Yaku::JikazehaiN,
    "場風 東" => Yaku::BakazehaiE,
    "場風 南" => Yaku::BakazehaiS,
    "場風 西" => Yaku::BakazehaiW,
    "場風 北" => Yaku::BakazehaiN,
    "役牌 白" => Yaku::SangenpaiHaku,
    "役牌 發" => Yaku::SangenpaiHatsu,
    "役牌 中" => Yaku::SangenpaiChun,
    "両立直" => Yaku::DoubleRiichi,
    "七対子" => Yaku::Chiitoitsu,
    "混全帯幺九" => Yaku::Honchantaiyaochuu,
    "一気通貫" => Yaku::Ikkitsuukan,
    "三色同順" => Yaku::Sanshokudoujun,
    "三色同刻" => Yaku::Sanshokudoukou,
    "三槓子" => Yaku::Sankantsu,
    "対々和" => Yaku::Toitoihou,
    "三暗刻" => Yaku::Sannankou,
    "小三元" => Yaku::Shousangen,
    "混老頭" => Yaku::Honroutou,
    "二盃口" => Yaku::Ryanpeikou,
    "純全帯幺九" => Yaku::Junchantaiyaochuu,
    "混一色" => Yaku::Honniisou,
    "清一色" => Yaku::Chinniisou,
    "天和" => Yaku::Tenhou,
    "地和" => Yaku::Chiihou,
    "大三元" => Yaku::Daisangen,
    "四暗刻" => Yaku::Suuankou,
    "四暗刻単騎" => Yaku::SuuankouTanki,
    "字一色" => Yaku::Tsuuiisou,
    "緑一色" => Yaku::Ryuuiisou,
    "清老頭" => Yaku::Chinroutou,
    "九蓮宝燈" => Yaku::Chuurenpoutou,
    "純正九蓮宝燈" => Yaku::Junseichuurenpoutou,
    "国士無双" => Yaku::Kokushi,
    "国士無双１３面" => Yaku::Kokushi13,
    "大四喜" => Yaku::Daisuushi,
    "小四喜" => Yaku::Shousuushi,
    "四槓子" => Yaku::Suukantsu,
};

pub fn yaku_from_str(str: &str) -> Option<Yaku> {
    YAKU_STR_TO_ENUM.get(str).copied()
}

/// [`Yaku`] to Tenhou Yaku string.
pub const fn yaku_to_str(yaku: Yaku) -> &'static str {
    match yaku {
        Yaku::Menzenchintsumohou => "門前清自摸和",
        Yaku::Riichi => "立直",
        Yaku::Ippatsu => "一発",
        Yaku::Chankan => "槍槓",
        Yaku::Rinshankaihou => "嶺上開花",
        Yaku::Haiteimouyue => "海底摸月",
        Yaku::Houteiraoyui => "河底撈魚",
        Yaku::Pinfu => "平和",
        Yaku::Tanyaochuu => "断幺九",
        Yaku::Iipeikou => "一盃口",
        Yaku::JikazehaiE => "自風 東",
        Yaku::JikazehaiS => "自風 南",
        Yaku::JikazehaiW => "自風 西",
        Yaku::JikazehaiN => "自風 北",
        Yaku::BakazehaiE => "場風 東",
        Yaku::BakazehaiS => "場風 南",
        Yaku::BakazehaiW => "場風 西",
        Yaku::BakazehaiN => "場風 北",
        Yaku::SangenpaiHaku => "役牌 白",
        Yaku::SangenpaiHatsu => "役牌 發",
        Yaku::SangenpaiChun => "役牌 中",
        Yaku::DoubleRiichi => "両立直",
        Yaku::Chiitoitsu => "七対子",
        Yaku::Honchantaiyaochuu => "混全帯幺九",
        Yaku::Ikkitsuukan => "一気通貫",
        Yaku::Sanshokudoujun => "三色同順",
        Yaku::Sanshokudoukou => "三色同刻",
        Yaku::Sankantsu => "三槓子",
        Yaku::Toitoihou => "対々和",
        Yaku::Sannankou => "三暗刻",
        Yaku::Shousangen => "小三元",
        Yaku::Honroutou => "混老頭",
        Yaku::Ryanpeikou => "二盃口",
        Yaku::Junchantaiyaochuu => "純全帯幺九",
        Yaku::Honniisou => "混一色",
        Yaku::Chinniisou => "清一色",
        Yaku::Tenhou => "天和",
        Yaku::Chiihou => "地和",
        Yaku::Daisangen => "大三元",
        Yaku::Suuankou => "四暗刻",
        Yaku::SuuankouTanki => "四暗刻単騎",
        Yaku::Tsuuiisou => "字一色",
        Yaku::Ryuuiisou => "緑一色",
        Yaku::Chinroutou => "清老頭",
        Yaku::Chuurenpoutou => "九蓮宝燈",
        Yaku::Junseichuurenpoutou => "純正九蓮宝燈",
        Yaku::Kokushi => "国士無双",
        Yaku::Kokushi13 => "国士無双１３面",
        Yaku::Daisuushi => "大四喜",
        Yaku::Shousuushi => "小四喜",
        Yaku::Suukantsu => "四槓子",
        _ => "",
    }
}