feat: update stubs

Author: wu-vincent

endstone_papi/_papi.cpp

@@ -1,4 +1,5 @@
 #include <endstone_papi/papi.h>
+#include <pybind11/functional.h>
 #include <pybind11/pybind11.h>
 #include <pybind11/stl.h>
 
@@ -44,7 +45,7 @@ class PyPlaceholderAPI : public papi::PlaceholderAPI {
     }
 };
 
-PYBIND11_MODULE(pypapi, m)
+PYBIND11_MODULE(_papi, m)
 {
     py::module_::import("endstone");
     py::module_::import("endstone.plugin");

endstone_papi/_papi.pyi

@@ -1,18 +1,43 @@
-from endstone.plugin import Service
+from __future__ import annotations
 from endstone import Player
+from endstone.plugin import Service, Plugin
+from typing import Callable
 
 __all__ = ["PlaceholderAPI"]
 
 class PlaceholderAPI(Service):
-    def set_placeholders(self, player: Player, text: str) -> str:
+    def __init__(self) -> None: ...
+    def _get_placeholder_pattern(self) -> str:
+        """
+        Get the normal placeholder pattern.
         """
-        Translates all placeholders into their corresponding values.
-        The pattern of a valid placeholder is {<identifier>:<params>}.
 
-        Args:
-            player (Player): Player to parse the placeholders against.
-            text (str): Text to set the placeholder values in.
+    def _get_registered_identifiers(self) -> list[str]:
+        """
+        Get all registered placeholder identifiers.
+        """
 
-        Returns:
-            str: String containing all translated placeholders.
+    def contains_placeholders(self, text: str) -> bool:
+        """
+        Check if a String contains any placeholders.
+        """
+
+    def is_registered(self, identifier: str) -> bool:
+        """
+        Check if a specific placeholder identifier is currently registered.
+        """
+
+    def register_placeholder(
+        self,
+        plugin: Plugin,
+        identifier: str,
+        processor: Callable[[Player, str], str],
+    ) -> bool:
+        """
+        Attempt to register a placeholder.
+        """
+
+    def set_placeholders(self, player: Player, text: str) -> str:
+        """
+        Translates all placeholders into their corresponding values.
         """

endstone_papi/papi.py

@@ -51,10 +51,10 @@ def contains_placeholders(self, text: str) -> bool:
         return self._placeholder_pattern.search(text) is not None
 
     def register_placeholder(
-            self,
-            plugin: Plugin,
-            identifier: str,
-            processor: Callable[[Player, str], str],
+        self,
+        plugin: Plugin,
+        identifier: str,
+        processor: Callable[[Player, str], str],
     ) -> bool:
         # TODO(daoge): duplicate placeholders are not allowed in the current design, shall we implement namespaces?
         if self.is_registered(identifier):

endstone_papi/plugin.py

@@ -1,7 +1,7 @@
 from endstone import Player
 from endstone.plugin import Plugin, ServicePriority
 from endstone.command import Command, CommandSender
-from .pypapi import PlaceholderAPI
+from .papi import PlaceholderAPI
 
 
 class PlaceholderAPIPlugin(Plugin):