Optimize type hints for maimai.players() method based on Provider type (#38)

* Initial plan

* Implement type hint optimization for maimai.players() method

remove tests

Co-Authored-By: TrueRou <[email protected]>

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: TrueRou <[email protected]>

Author: Copilot

maimai_py/maimai.py

@@ -4,7 +4,7 @@
 import warnings
 from collections import defaultdict
 from functools import cached_property
-from typing import Any, AsyncGenerator, Callable, Generic, Iterable, Literal, Optional, Type, TypeVar
+from typing import Any, AsyncGenerator, Callable, Generic, Iterable, Literal, Optional, Type, TypeVar, Union, overload
 
 from aiocache import BaseCache, SimpleMemoryCache
 from httpx import AsyncClient
@@ -799,6 +799,18 @@ async def songs(
         songs = MaimaiSongs(self)
         return await songs._configure(provider, alias_provider, curve_provider)
 
+    @overload
+    async def players(self, identifier: PlayerIdentifier, provider: DivingFishProvider) -> DivingFishPlayer: ...
+
+    @overload
+    async def players(self, identifier: PlayerIdentifier, provider: LXNSProvider) -> LXNSPlayer: ...
+
+    @overload
+    async def players(self, identifier: PlayerIdentifier, provider: ArcadeProvider) -> ArcadePlayer: ...
+
+    @overload
+    async def players(self, identifier: PlayerIdentifier, provider: WechatProvider) -> WechatPlayer: ...
+
     async def players(
         self,
         identifier: PlayerIdentifier,