i2bSrSSKJr SSKJr SSKJr SSKJrJ r J r J r J r J r JrJrJrJrJr S SjrS S jrS S jrS!S"S jjrS!S#S jjrS!S$S jjrS!S%SjjrS&SjrS'SjrS(SjrS)SjrS)SjrS)SjrS*Sjr S+Sjr!S,Sjr"S-Sjr#S.Sjr$S.Sjr%S.Sjr&S/Sjr'S0Sjr(S1Sjr)g)2zJPhase 10 evaluation: group validation, hit checking, scoring, card naming.) annotations)Card) Localization) PhaseRequirement TableGroup GROUP_SET GROUP_RUN GROUP_COLOR P10_RANK_WILD P10_RANK_SKIPP10_COLOR_NAMESPHASESPHASE_DESC_KEYS EVEN_PHASESc(UR[:H$N)rankr cards =C:\Users\dbart\PlayPalace11\server\games\phase10\evaluator.pyis_wildr 99 %%c(UR[:H$r)rrrs ris_skiprrrc@SURs=:*=(a S:*$s $)Nr rrs r is_numberedr!"s   R  rc[U5(a[R"US5$[U5(a[R"US5$[R"UR S5nU(a[R"X5O[ UR 5n[R"USURUS9$)z+Return the spoken name for a Phase 10 card.zphase10-card-wildzphase10-card-skipzphase10-card-numbered)numbercolor)rrgetrrsuitstrr)rlocale color_keyr%s r p10_card_namer++st}}(;<<t}}(;<<##DIIr2I3sh xx9(9KK xx9(9KK   F$7syy IIrct[R"US5nU(a[R"X5$SU3$)z@Full spoken description of a phase, e.g. 'Phase 1: 2 sets of 3'.r#zPhase )rr&r) phase_numr)keys rphase_descriptionr:Gs3   i ,C,/<  F (Ivi[5IIrcj[U5(ag[U5(agURS:agg)z=Penalty point value of a card remaining in hand at round end. )rrrrs r score_cardr@Rs+t}}t}} yyB rc&[SU55$)z)Total penalty points for a list of cards.c38# UHn[U5v M g7fr)r@.0r/s r score_hand.._s,ez!}}e)sum)r.s r score_handrI]s ,e, ,,rcVUVs/sHn[U5(aMUPM sn$s snfr)r)r.r/s r _naturalsrKgs  /u!GAJAu // /s&&c^[U5U:ag[U5nU(dgUSRm[U4SjU55(agg)zEValidate that cards form a valid set (same rank, at least 1 natural).Fzphase10-err-need-cardsFzphase10-err-need-naturalrc3@># UHoRT:gv M g7frr )rDr/ref_ranks rrE&_validate_set_cards..ss ,t!66X t)Fzphase10-err-invalid-setTr#)lenrKrany)r. min_countnatsrPs @r_validate_set_cardsrXksF 5zI. U D 0Aw||H ,t ,,,/ rc[U5U:ag[U5nU(dg[SU55(ag[SU55(ag[U5[U5- n[SU55n[U5[[ U55:wagUSUSpeXe- S -[U5- nXs:agg ) zValidate that cards form a valid run (consecutive numbers, at least 1 natural). Wilds fill internal gaps and may extend the run at either end. The combined span must be achievable with the available wilds. rMrNc38# UHn[U5v M g7fr)rrCs rrE&_validate_run_cards..s $t!71::trG)Fzphase10-err-invalid-runc3B# UHn[U5(+v M g7frr!rCs rrEr[s ,t!{1~  tsc38# UHoRv M g7frr rCs rrEr[s,t!vvtrGrrrS)rTrKrUsortedset)r.rVrW wild_count nat_ranksmin_rmax_r internal_gapss r_validate_run_cardsrgxs  5zI. U D 0 $t $$$/ ,t ,,,/Uc$i'J,t,,I 9~S^,,/Q<25]Q&#i.8M!/ rc^[U5U:ag[U5nU(dgUSRm[U4SjU55(agg)z;Validate that cards are all one color (at least 1 natural).rMrNrc3@># UHoRT:gv M g7fr)r')rDr/ ref_colors rrE(_validate_color_cards..s -166Y rR)Fzphase10-err-invalid-colorrS)rTrKr'rU)r.rVrWrjs @r_validate_color_cardsrlsF 5zI. U D 0Q I - ---1 rcUR[:Xa[XR5$UR[:Xa[ XR5$[ XR5$)zValidate a list of cards against a phase requirement. Returns: (True, "") on success or (False, error_ftl_key) on failure. )r4r rXr3r rgrl)r.r5s rvalidate_grouprnsI  xx9"5))44 xx9"5))44  22rc[U5(a?URR[:XagURR[:Xagg[ U5(agURR[:Xa;[ UR5nU(aURUSR:waggURR[:Xa0URU/-n[U[U55upEU(dgg[ UR5nU(aURUSR:wagg)zCheck whether new_card can legally be added to an existing table group. Returns: (True, "") if valid, (False, reason_ftl_key) otherwise. )Fzphase10-hit-invalid-set)Fzphase10-hit-invalid-run)Fzphase10-hit-invalid-colorrSr) r requirementr4r r rrKr.rrgrTr')groupnew_cardrWtestok_s r can_hit_grouprvs x    ! !Y .3    ! !Y .31x *% HMMT!W\\13 *{{hZ'#D#d)43 U[[ !D  a-1 rcUVs/sHn[U5(aMUPM nn/nUH>n[X55nUc gURU5 UHnURU5 M M@ U$s snf)aoTry to find a valid assignment of hand cards to phase requirements. Returns a list of card groups (one per requirement) if successful, else None. Only numbered cards and wilds are candidates; skips are excluded from phases. Uses a greedy approach: satisfy requirements in order, preferring naturals before committing wilds. Good enough for bot use; not exhaustive. N)r _pick_groupappendremove)hand phase_reqsr/ availablegroupsr5rqs rfind_phase_assignmentrso!3Dq DI3!FI+ = eA   Q   M4s A-A-cUVs/sHn[U5(dMUPM nnUVs/sH)n[U5(aM[U5(aM'UPM+ nnUR[:Xa[ XCUR 5$UR[ :Xa[XCUR 5$[XCUR 5$s snfs snf)zBGreedily pick cards from available to satisfy req, or return None.) rrr4r _pick_setr3r _pick_run _pick_color)r}r5r/wildsrWs rrxrxs! 0 1WQZQ E 0 Fy! A71:AyD F xx9cii00 xx9cii00 tCII .. 1 FsCCC C C c jSSKJn 0nUH.nURUR/5R U5 M0 SnSnUR 5HUup[ U 5n [SX*- 5n U [ U5::dM/X:dM6XS[SU[ U 5- 5-nU nMW Ub[ U5U:asUVs/sH8oURUSR:XdM![US5(aM6UPM: n n[SU[ U 5- 5n U [ U5::aXSU -$gs snf)Nr)Counterr_) collectionsr setdefaultrryitemsrTmaxr) rWrr3r rank_groupsr/bestbest_nat_countrr. nat_count needed_wilds nat_for_ranks rrr s'#)+K qvvr*11!4#DN"((* J 1e/0 3u: %)*D!<#aU);"<==D&N + CI.#'Z4a66T!W\\+AQUVWQXIY4 Z1ec,&778 3u: % "66 6  [s D0$D09D0ch^ ^[SU5SS9nU(dgSn[[SU555n[[U55Hn/mSnXVS- n[XVS5Hm [ U U4S jU5S5n U (aT nTR U 5 OU[U5:aUS- nT nO OB[T5U-n X:dMcUSUn TU -n Ub[U 5[U5:dMU nM U(dM[U5U:dMUs $ U(a[U5U:aU$S$) z0Find a run of at least `count` among nats+wilds.c3J# UHn[U5(dMUv M g7frr]rCs rrE_pick_run..(s9$Q+a.qq$s# #cUR$rr )r/s r_pick_run..(sr)r9Nc38# UHoRv M g7frr rCs rrEr.s5HqFFHrGrr c3Z># UH oRT:XdMUT;dMUv M" g7frr )rDr/rrun_natss rrEr8s% ]Hq$1T\K\Hs ++ +)r`rarangerTnextry)rWrr3numberedr seen_ranks start_idx wilds_used prev_rankrtotal used_wilds candidaterrs @@rrr&s-9$9?OPH #D5H556J3z?+ ! )A- */4D ]H ]_cdL  -c%j(a  MJ.E~";J/ $z1 <3y>CI#=$D'5* 4CI&K9,<CI.48D8rc*SSKJn U"[5nUH2n[U5(dMXERR U5 M4 UR 5H5upg[SU[U5- 5nU[U5::dM.XqSU-s $ g)z'Find a color group of at least `count`.r) defaultdictN) rrlistr!r'ryrrrT) rWrr3r color_groupsr/r%r.rs rrrQs'*5d*;L  q>>  ' ' *%**, 1ec%j01 3u: %,// /- rcFU(a[$[[SS55$)zCReturn the ordered list of phase numbers used in this game variant.r )rrr even_onlys r active_phasesrfs#;;eArl);;rc[U5nURU5nUS-[U5:aX#S-$S$![a gf=f)zrsP"$1    &&& \7JJ -0 D  3$$X &4 /6(9V *< 'r