IiBSrSSKJr SSKJr SSKJrJr SSKJ r SSK J r SSK J r \ (a\"S S \ 55r\"S S \ 55r"S S5r/SQrg)z Reusable team management utility for team-based games. Provides Team dataclass and TeamManager for handling team assignments, scoring, and elimination (for inverse game modes). ) OrderedDict)Mapping) dataclassfield) TYPE_CHECKING)DataClassJSONMixin) Localizationcj\rSrSr%Sr\\S'\"\S9r \\ \S'Sr \\S'Sr \\S'S r \\S 'S rg ) TeamaTeam container for team-based games. Attributes: index: Team index (0-based). members: Player names on the team. round_score: Points earned this round. total_score: Total points across rounds. eliminated: True if eliminated (inverse modes). indexdefault_factorymembersr round_score total_scoreF eliminatedN)__name__ __module__ __qualname____firstlineno____doc__int__annotations__rlistrstrrrrbool__static_attributes__r6c:\Users\dbart\PlayPalace11\server\game_utils\teams.pyr r s? Jt4GT#Y4KKJr!r c &\rSrSr%Sr\"\S9r\\\ S'Sr \ \ S'\"\ S9r \ \ \4\ S'S\\ S S 4S jrS \ S \\4S jrS\ S \S -4SjrS\ S \4SjrS\ S \\ 4SjrS\ S \\ 4SjrS\ S\S S 4SjrS\ S\S S 4SjrS4SjrS4SjrS4SjrS \\4SjrS\S S 4SjrS\ S S 4SjrS\ S \4SjrS\S \\4SjrS \S -4S jr S5S\S!\ S \ 4S"jjr!S6S#\S$\S \\4S%jjr"\#S5S \ S!\ S \ 4S&jj5r$\#S'\ S \ 4S(j5r%\#S)\S \\ 4S*j5r&\#S5S)\S!\ S \\ 4S+jj5r'\#S,\S-\S \\ 4S.j5r(\#S5S,\S-\S!\ S \\)\ \ 44S/jj5r*\#S\ S)\S \4S0j5r+S5S!\ S \ 4S1jjr,S5S!\ S \\ 4S2jjr-S3r.g )7 TeamManager(zManage team assignments and scoring for games. Supports individual mode (teams of 1) and common team configurations like 2v2, 3v3, 2v2v2, etc. rteams individual team_mode_player_to_team player_namesreturnNc>/Ul0UlURS:XaH[U5H8up#[ X#/S9nURR U5 X RU'M: gUR UR5n[U5n[U5Vs/sHn/PM nn[U5H*upX-n XR U5 XRU'M, [U5H)up[ XS9nURR U5 M+ gs snf)zw Create teams based on team_mode and assign players. Args: player_names: List of player names to assign to teams. r')rrN) r&r)r( enumerater append_parse_team_modelenrange) selfr*inameteam team_sizes num_teams_ team_members player_idxteam_idxrs r" setup_teamsTeamManager.setup_teams4s  ! >>\ )$\2!V4 !!$'-.$$T*3 ..t~~>JJI:?y9I,J9IAR9IL,J%.l$; %1&--d3-5$$T*%< &/|%<!(< !!$'&=-Ks DmodecUS:Xa/$UR5RS5nUVs/sH$o3R5(dM[U5PM& sn$s snf)z Parse a team mode string into list of team sizes. Examples: "2v2" -> [2, 2] "3v3" -> [3, 3] "2v2v2" -> [2, 2, 2] "2v3" -> [2, 3] r'v)lowersplitisdigitr)r2r>partsps r"r/TeamManager._parse_team_modeWsK < I ""3' %51A555s AA player_namecURRU5nUb(U[UR5:aURU$g)z!Get the team a player belongs to.N)r)getr0r&)r2rGr;s r"get_teamTeamManager.get_teamfs?''++K8  Hs4::$>::h' 'r!c:URRUS5$)z1Get the team index for a player (0 if not found).r)r)rI)r2rGs r"get_team_indexTeamManager.get_team_indexms##'' Q77r!cURU5nU(a$URVs/sH o3U:wdM UPM sn$/$s snf)z1Get names of player's teammates (excluding self).)rJr)r2rGr5ms r" get_teammatesTeamManager.get_teammatesqs<}}[) #||@|!K/?A|@ @ As ??cbURU5nU(a[UR5$U/$)z;Get names of all players on the same team (including self).)rJrrr2rGr5s r"get_team_membersTeamManager.get_team_membersxs*}}[)  % %}r!pointsc`URU5nU(aU=RU- slgg)z*Add points to a player's team total score.N)rJrr2rGrWr5s r"add_to_team_scoreTeamManager.add_to_team_score)}}[)     &  r!c`URU5nU(aU=RU- slgg)z*Add points to a player's team round score.N)rJrrYs r"add_to_team_round_score#TeamManager.add_to_team_round_scorer\r!cvURH)nU=RUR- slSUlM+ g)z.TeamManager.get_leading_team..sQ]]r!key)r&max)r2s r"get_leading_teamTeamManager.get_leading_teamszz4::#:;;r!localecURS:Xa UR(aURS$[UR5S:XaURS$SURS-3$)z Get a display name for a team. For individual mode, returns the player name. For team mode, returns "Team N" or lists members. r'rzTeam )r(rr0r)r2r5rs r" get_team_nameTeamManager.get_team_namesY >>\ )dll<<? " t||  !<<? "tzzA~&''r!by_score descendingcDU(aSOSn[URX2S9$)z Get teams sorted by score or index. Args: by_score: If True, sort by total_score. Otherwise by index. descending: If True, highest first. cUR$r~rrs r"r.TeamManager.get_sorted_teams..sr!cUR$r~)rrs r"rrsAGGr!)rreverse)sortedr&)r2rrrs r"get_sorted_teamsTeamManager.get_sorted_teamss ,4&:Kdjjc>>r!cUS:Xa[R"US5$UR5RS5nUVs/sH$o3R 5(dM[ U5PM& nnU(dU$[ [U55S:Xa'[ U5nUSn[R"USUUS9$SRSU55$s snf) u Convert internal team mode format to user-friendly localized display format. Examples: "individual" -> "Individual" (en) / "Individual" (pt) / "个人" (zh) "2v2" -> "2 teams of 2" (en) / "2 equipes de 2" (pt) / "2 个 2 人团队" (zh) "3v3" -> "2 teams of 3" "2v2v2" -> "3 teams of 2" "2v2v2v2" -> "4 teams of 2" Args: mode: Internal team mode string. locale: Language code for localization (default: "en"). Returns: User-friendly localized display string. r'zgame-team-mode-individualr@rrzgame-team-mode-x-teams-of-y)r7 team_sizec38# UHn[U5v M g7fr~)r).0ss r" ;TeamManager.format_team_mode_for_display..s7JqCFFJs) r rIrArBrCrr0setjoin)r>rrDrEr6r7rs r"format_team_mode_for_display(TeamManager.format_team_mode_for_displays& < ##F,GH H ""3'&+;eyy{fc!fe ;K s: 1 $JI"1 I##-##  887J77 7% "individual" - "2 teams of 2" / "2 equipes de 2" / "2 个 2 人团队" -> "2v2" - "3 teams of 2" -> "2v2v2" - "4 teams of 2" -> "2v2v2v2" Args: display: User-friendly display string (possibly localized). Returns: Internal team mode string. rNr'c3@# UHoR5v M g7fr~)rC)rchars r"r9TeamManager.parse_display_to_team_mode..s5YQXllnnQXsz\d+r rr@)rerAanyfindallr0rrr)rrnumbersr7rs r"parse_display_to_team_mode&TeamManager.parse_display_to_team_modes"  7==? *#5YQX5Y2Y2Y **VW- w<1 GAJIGAJI88S^,y89 9r! num_playerscS/nUS:aU$[SUS-S-5HHnX-nUS:dMX2-U:XdMSR[U5/U-5nURU5 MJ U$)z Get valid team mode options for a given number of players. Returns internal format strings. Args: num_players: Number of players in the game. Returns: List of valid team mode strings in internal format. r'r rr@)r1rrr.)rmodesrr7r>s r"(get_team_modes_for_player_count_internal4TeamManager.get_team_modes_for_player_count_internal%sz ?Lq+"2Q"67I#0IA~)"7;"FxxY 09 <= T" 8 r!c[RU5nUVs/sHn[RX15PM sn$s snf)a# Get valid team mode options for a given number of players. Returns localized display strings. Args: num_players: Number of players in the game. locale: Language code for localization (default: "en"). Returns: List of valid team mode strings in user-friendly localized format. )r$rr)rrinternal_modesr>s r"get_team_modes_for_player_count+TeamManager.get_team_modes_for_player_countBs9%MMkZSabSa4 88FSabbbs< min_players max_playersc[5n[XS-5H)n[RU5nUR U5 M+ S[ S[ 4Sjn[X%S9$)a  Get all possible team mode options for a range of player counts. Returns internal format strings. Args: min_players: Minimum number of players. max_players: Maximum number of players. Returns: Sorted list of unique team mode strings in internal format. rr>r+c^US:XagURS5n[SU55nSX 4$)z6Sort key for team modes (individual first, then size).r')rrr@c3d# UH&oR5(dM[U5v M( g7fr~)rCr)rrEs r"rCTeamManager.get_all_team_modes..sort_key..js=1As00r)rBsum)r>rDtotals r"sort_key0TeamManager.get_all_team_modes..sort_keyes5|#!JJsOE===Eu# #r!r)rr1r$rupdatertupler)rr all_modescountrrs r"get_all_team_modesTeamManager.get_all_team_modesRs\E ;a8EHHOE   U #9  $3 $5 $i..r!c[RX5nUVs/sHn[RXB5U4PM sn$s snf)a] Get all possible team mode options for a range of player counts. Returns (display_string, internal_value) tuples for UI. Args: min_players: Minimum number of players. max_players: Maximum number of players. locale: Language code for localization (default: "en"). Returns: List of (display, value) tuples sorted by internal value. )r$rr)rrrrr>s r"get_all_team_modes_for_display*TeamManager.get_all_team_modes_for_displayosK %77 Q' & 5 5d CT J&   s!>c4[RU5nX;$)a Check if a team mode is valid for the given number of players. Args: team_mode: Internal team mode string (e.g., "individual", "2v2"). num_players: Number of players in the game. Returns: True if the team mode is valid for the player count, False otherwise. )r$r)r(r valid_modess r"is_valid_team_modeTeamManager.is_valid_team_modes"JJ;W ''r!cURSSS9n/nUH4nURXA5nURUSUR35 M6 SR U5S-$)zt Format scores as a brief single-line string for speaking. Returns something like: "Alice: 5. Bob: 3. Charlie: 1." Trr: . .)rrr.rr)r2r sorted_teamsrDr5r4s r"format_scores_briefTeamManager.format_scores_briefsl ,,dt,L  D%%d3D LLD6D$4$4#56 7!yy#%%r!cURSSS9n/nUHJnURXA5n[R"USURS9nUR USU35 ML U$)a  Format localized scores as a list of lines for a status box. Returns something like (English): ["Alice: 5 points", "Bob: 3 points", ...] The points label is localized via the "game-points" Fluent key. No header needed - screen readers speak list items directly. Tr game-pointsrr)rrr rIrr.)r2rrlinesr5r4rWs r"format_scores_detailed"TeamManager.format_scores_detailedsp,,dt,L  D%%d3D!%%fm4CSCSTF LLD6F8, -! r!)r)r&)r+N)en)TT)/rrrrrrrr&r rr(rdictr)rr<r/rJrMrQrUrZr^rbrerhrlrorsrrvrzrrr staticmethodrrrrrrrrrrr rr!r"r$r$(s& d3E4:3!Is!&+D&AOT#s(^A!(S !(d!(F 6S 6T#Y 6CD4K8#8#8cCDI'S'#'$' '3''' ! ! $;d;4D#s#t# 2c2d2 B#B$t*B<$+< ($ ( (s ( ? ?$ ?RVW[R\ ?)83)8)8s)8)8V#C#C##Jcd3i8 cS c# cQUVYQZ c c//#/$s)//8:>  '* 47 eCHo   * (c ( ( ( ($ &# & &SDIr!r$c`\rSrSrSr\S\4Sj5r\S\S\ \\ 4S\ \4Sj5r S r g ) TeamResultBuilderiz:Helpers for summarizing and formatting team-based results. team_managercURSSS9nU(aUSOSn[5nUH"nURU5nURX5'M$ XU4$)z9Return (sorted_teams, winner, ordered final_scores dict).TrrN)rrrr)rrwinner final_scoresr5r4s r" summarizeTeamResultBuilder.summarizesb$44dt4T $0ad.9m  D--d3D!%!1!1L !\11r!rrr+c[R"US5/n[UR5S5H7unupE[R"USUS9nUR USUSU35 M9 U$)z#Format localized final score lines.zgame-final-scoresrrrrr)r rIr-itemsr.)rrrrr4scorerWs r"format_final_scores%TeamResultBuilder.format_final_scoresst!!&*=>?$-l.@.@.BA$F E=D!%%fm5IF LLE7"TF"VH5 6%G r!rN)rrrrrrr$rrrrrrr rr!r"rrsUD2 22CwsCx7HTRUYr!r)r r$rN)r collectionsrcollections.abcr dataclassesrrtypingrmashumaro.mixins.jsonrmessages.localizationr r r$r__all__rr!r"rsq$#( 40   $ L$L L^ 0 7r!