change values to None if not received through interaction

Author: NeloBlivion

discord/ui/checkbox.py

@@ -130,7 +130,7 @@ def default(self, value: bool):
 
     @property
     def value(self) -> bool | None:
-        """Whether this checkbox was selected or not by the user."""
+        """Whether this checkbox was selected or not by the user. This will be ``None`` if the checkbox has not been submitted via a modal yet."""
         return self._value
 
     def to_component_dict(self) -> CheckboxComponentPayload:

discord/ui/checkbox_group.py

@@ -98,7 +98,7 @@ def __init__(
         if not isinstance(required, bool):
             raise TypeError(f"required must be bool not {required.__class__.__name__}")  # type: ignore
         custom_id = os.urandom(16).hex() if custom_id is None else custom_id
-        self._selected_values: list[str] = []
+        self._selected_values: list[str] | None = None
 
         self._underlying: CheckboxGroupComponent = self._generate_underlying(
             custom_id=custom_id,
@@ -188,8 +188,8 @@ def required(self, value: bool):
         self.underlying.required = bool(value)
 
     @property
-    def values(self) -> list[str]:
-        """The values selected by the user."""
+    def values(self) -> list[str] | None:
+        """The values selected by the user. This will be ``None`` if the checkbox group has not been submitted in a modal yet."""
         return self._selected_values
 
     @property

discord/ui/file_upload.py

@@ -89,7 +89,7 @@ def __init__(
         if not isinstance(required, bool):
             raise TypeError(f"required must be bool not {required.__class__.__name__}")  # type: ignore
         custom_id = os.urandom(16).hex() if custom_id is None else custom_id
-        self._attachments: list[Attachment] = []
+        self._attachments: list[Attachment] | None = None
 
         self._underlying: FileUploadComponent = self._generate_underlying(
             custom_id=custom_id,
@@ -176,8 +176,8 @@ def required(self, value: bool):
         self.underlying.required = bool(value)
 
     @property
-    def values(self) -> list[Attachment]:
-        """The files that were uploaded to the field."""
+    def values(self) -> list[Attachment] | None:
+        """The files that were uploaded to the field. This will be ``None`` if the file upload has not been submitted via a modal yet."""
         return self._attachments
 
     def to_component_dict(self) -> FileUploadComponentPayload:

discord/ui/select.py

@@ -661,14 +661,14 @@ def append_option(self, option: SelectOption) -> Self:
         return self
 
     @property
-    def values(self) -> list[ST]:
+    def values(self) -> list[ST] | None:
         """List[:class:`str`] | List[:class:`discord.Member` | :class:`discord.User`]] | List[:class:`discord.Role`]] |
         List[:class:`discord.Member` | :class:`discord.User` | :class:`discord.Role`]] | List[:class:`discord.abc.GuildChannel`] | None:
         A list of values that have been selected by the user. This will be ``None`` if the select has not been interacted with yet.
         """
         if self._interaction is None or self._interaction.data is None:
             # The select has not been interacted with yet
-            return []
+            return None
         select_type = self.underlying.type
         if select_type is ComponentType.string_select:
             return self._selected_values  # type: ignore # ST is str