add docs to Token class

src/token.py

@@ -3,8 +3,24 @@
 
 @dataclass
 class Token:
+    """
+    Represents a lexical token with a type and value.
+
+    Attributes:
+        type_ (str): The type/category of the token (e.g., 'MEMBER', 'SCOPE').
+        value (str): The string value of the token.
+    """
     type_: str
     value: str
 
     def __eq__(self, other: object) -> bool:
+        """
+        Compare this token to another for equality.
+
+        Args:
+            other (object): Another object to compare with.
+
+        Returns:
+            bool: True if `other` is a Token with the same type and value, False otherwise.
+        """
         return isinstance(other, Token) and self.type_ == other.type_ and self.value == other.value