fix: fix what a shit

BallanceTasSonnet/python/blctas/_blctas/__init__.pyi

@@ -0,0 +1,9 @@
+"""
+Provides functionality for handling Ballance TAS works.
+"""
+
+from . import tasfile
+
+__all__ = [
+    "tasfile",
+]

BallanceTasSonnet/python/blctas/_blctas/tasfile.pyi

@@ -1,28 +1,88 @@
-import tasfile
-import typing
+"""
+Provides functionality for handling Ballance TAS files loading, saving and editing.
+"""
+
 
 class TasFile:
-    def append(self, /, count: int, delta_time: float) -> typing.Any: ...
-    def batchly_clear_key_pressed(self, /, index_from: int, index_to: int) -> typing.Any: ...
-    def batchly_flip_key_pressed(self, /, index_from: int, index_to: int, key: tasfile.TasKey) -> typing.Any: ...
-    def batchly_set_delta_time(self, /, index_from: int, index_to: int, delta_time: float) -> typing.Any: ...
-    def batchly_set_key_pressed(self, /, index_from: int, index_to: int, key: tasfile.TasKey, pressed: bool) -> typing.Any: ...
-    def clear(self, /) -> typing.Any: ...
-    def clear_key_pressed(self, /, index: int) -> typing.Any: ...
-    def flip_key_pressed(self, /, index: int, key: tasfile.TasKey) -> typing.Any: ...
+    """
+    Represents a TAS file containing a sequence of frames.
+    
+    This class provides methods for manipulating TAS files including adding, removing,
+    modifying frames, and getting/setting key press states.
+    Each frame contains key press information and delta time for Ballance gameplay.
+    """
+    def append(self, /, count: int, delta_time: float) -> None: ...
+    def batchly_clear_key_pressed(self, /, index_from: int, index_to: int) -> None: ...
+    def batchly_flip_key_pressed(self, /, index_from: int, index_to: int, key: TasKey) -> None: ...
+    def batchly_set_delta_time(self, /, index_from: int, index_to: int, delta_time: float) -> None: ...
+    def batchly_set_key_pressed(self, /, index_from: int, index_to: int, key: TasKey, pressed: bool) -> None: ...
+    def clear(self, /) -> None: ...
+    def clear_key_pressed(self, /, index: int) -> None: ...
+    def flip_key_pressed(self, /, index: int, key: TasKey) -> None: ...
     def get_count(self, /) -> int: ...
     def get_delta_time(self, /, index: int) -> float: ...
-    def insert(self, /, index: int, count: int, delta_time: float) -> typing.Any: ...
+    def insert(self, /, index: int, count: int, delta_time: float) -> None: ...
     def is_empty(self, /) -> bool: ...
-    def is_key_pressed(self, /, index: int, key: tasfile.TasKey) -> bool: ...
-    def remove(self, /, index_from: int, index_to: int) -> typing.Any: ...
-    def set_delta_time(self, /, index: int, delta_time: float) -> typing.Any: ...
-    def set_key_pressed(self, /, index: int, key: tasfile.TasKey, pressed: bool) -> typing.Any: ...
+    def is_key_pressed(self, /, index: int, key: TasKey) -> bool: ...
+    def remove(self, /, index_from: int, index_to: int) -> None: ...
+    def set_delta_time(self, /, index: int, delta_time: float) -> None: ...
+    def set_key_pressed(self, /, index: int, key: TasKey, pressed: bool) -> None: ...
 
 class TasKey:
+    """
+    Represents the different keys that can be pressed in a TAS frame.
+    """
+    KEY_UP: TasKey = ...
+    """Up arrow key"""
+    KEY_DOWN: TasKey = ...
+    """Down arrow key"""
+    KEY_LEFT: TasKey = ...
+    """Left arrow key"""
+    KEY_RIGHT: TasKey = ...
+    """Right arrow key"""
+    KEY_SHIFT: TasKey = ...
+    """Shift key"""
+    KEY_SPACE: TasKey = ...
+    """Space key"""
+    KEY_Q: TasKey = ...
+    """Q key"""
+    KEY_ESC: TasKey = ...
+    """Escape key"""
+    KEY_ENTER: TasKey = ...
+    """Enter key"""
     def __eq__(self, /, other: TasKey | int) -> bool: ...
     def __ne__(self, /, other: TasKey | int) -> bool: ...
 
-def create(count: int, delta_time: float) -> tasfile.TasFile: ...
-def load(filename: str) -> tasfile.TasFile: ...
-def save(file: tasfile.TasFile, filename: str) -> typing.Any: ...
+def create(count: int, delta_time: float) -> TasFile: ...
+"""
+Creates a new TAS file with a specified number of frames, all having the same delta time.
+
+:param count: The number of frames to create in the new TAS file.
+:type count: int
+:param delta_time: The delta time value for all frames in the new TAS file.
+:type delta_time: float
+:returns: A new TasFile instance with the specified number of frames.
+:rtype: TasFile
+"""
+def load(filename: str) -> TasFile: ...
+"""
+Loads a TAS file from disk.
+
+:param filename: The path to the TAS file to load.
+:type filename: str
+:returns: A TasFile instance loaded from the specified file.
+:rtype: TasFile
+:raises RuntimeError: If the file cannot be loaded or is invalid.
+"""
+def save(file: TasFile, filename: str) -> None: ...
+"""
+Saves a TAS file to disk.
+
+:param file: The TasFile instance to save.
+:type file: TasFile
+:param filename: The path where the TAS file should be saved.
+:type filename: str
+:returns: None
+:rtype: None
+:raises RuntimeError: If the file cannot be saved.
+"""