basedpyright 1.18.3 → 1.18.4

package/dist/typeshed-fallback/stdlib/weakref.pyi

@@ -1,19 +1,14 @@
 import sys
 from _typeshed import SupportsKeysAndGetItem
-from _weakref import (
-    CallableProxyType as CallableProxyType,
-    ProxyType as ProxyType,
-    ReferenceType as ReferenceType,
-    getweakrefcount as getweakrefcount,
-    getweakrefs as getweakrefs,
-    proxy as proxy,
-    ref as ref,
-)
+from _weakref import getweakrefcount as getweakrefcount, getweakrefs as getweakrefs, proxy as proxy
 from _weakrefset import WeakSet as WeakSet
 from collections.abc import Callable, Iterable, Iterator, Mapping, MutableMapping
-from typing import Any, Generic, TypeVar, overload
+from typing import Any, Generic, TypeVar, final, overload
 from typing_extensions import ParamSpec, Self
 
+if sys.version_info >= (3, 9):
+    from types import GenericAlias
+
 __all__ = [
     "ref",
     "proxy",
@@ -40,11 +35,51 @@ _P = ParamSpec("_P")
 
 ProxyTypes: tuple[type[Any], ...]
 
+# These classes are implemented in C and imported from _weakref at runtime. However,
+# they consider themselves to live in the weakref module for sys.version_info >= (3, 11),
+# so defining their stubs here means we match their __module__ value.
+# Prior to 3.11 they did not declare a module for themselves and ended up looking like they
+# came from the builtin module at runtime, which was just wrong, and we won't attempt to
+# duplicate that.
+
+@final
+class CallableProxyType(Generic[_CallableT]):  # "weakcallableproxy"
+    def __eq__(self, value: object, /) -> bool:
+        """Return self==value."""
+        ...
+    def __getattr__(self, attr: str) -> Any: ...
+    __call__: _CallableT
+
+@final
+class ProxyType(Generic[_T]):  # "weakproxy"
+    def __eq__(self, value: object, /) -> bool:
+        """Return self==value."""
+        ...
+    def __getattr__(self, attr: str) -> Any: ...
+
+class ReferenceType(Generic[_T]):  # "weakref"
+    __callback__: Callable[[ReferenceType[_T]], Any]
+    def __new__(cls, o: _T, callback: Callable[[ReferenceType[_T]], Any] | None = ..., /) -> Self: ...
+    def __call__(self) -> _T | None:
+        """Call self as a function."""
+        ...
+    def __eq__(self, value: object, /) -> bool:
+        """Return self==value."""
+        ...
+    def __hash__(self) -> int:
+        """Return hash(self)."""
+        ...
+    if sys.version_info >= (3, 9):
+        def __class_getitem__(cls, item: Any, /) -> GenericAlias:
+            """See PEP 585"""
+            ...
+
+ref = ReferenceType
+
+# everything below here is implemented in weakref.py
+
 class WeakMethod(ref[_CallableT]):
-    # `ref` is implemented in `C` so positional-only arguments are enforced, but not in `WeakMethod`.
-    def __new__(  # pyright: ignore[reportInconsistentConstructor]
-        cls, meth: _CallableT, callback: Callable[[Self], Any] | None = None
-    ) -> Self: ...
+    def __new__(cls, meth: _CallableT, callback: Callable[[Self], Any] | None = None) -> Self: ...
     def __call__(self) -> _CallableT | None: ...
     def __eq__(self, other: object) -> bool: ...
     def __ne__(self, other: object) -> bool: ...

package/dist/typeshed-fallback/stdlib/xml/parsers/expat/__init__.pyi

@@ -1 +1,7 @@
 from pyexpat import *
+
+# This is actually implemented in the C module pyexpat, but considers itself to live here.
+class ExpatError(Exception):
+    code: int
+    lineno: int
+    offset: int

package/dist/typeshed-fallback/stdlib/xmlrpc/client.pyi

@@ -200,7 +200,7 @@ def dumps(
     allow_none: bool = False,
 ) -> str: ...
 def loads(
-    data: str, use_datetime: bool = False, use_builtin_types: bool = False
+    data: str | ReadableBuffer, use_datetime: bool = False, use_builtin_types: bool = False
 ) -> tuple[tuple[_Marshallable, ...], str | None]: ...
 def gzip_encode(data: ReadableBuffer) -> bytes: ...  # undocumented
 def gzip_decode(data: ReadableBuffer, max_decode: int = 20971520) -> bytes: ...  # undocumented

package/dist/typeshed-fallback/stdlib/xmlrpc/server.pyi

@@ -1,6 +1,7 @@
 import http.server
 import pydoc
 import socketserver
+from _typeshed import ReadableBuffer
 from collections.abc import Callable, Iterable, Mapping
 from re import Pattern
 from typing import Any, ClassVar, Protocol
@@ -48,8 +49,8 @@ class SimpleXMLRPCDispatcher:  # undocumented
     def register_multicall_functions(self) -> None: ...
     def _marshaled_dispatch(
         self,
-        data: str,
-        dispatch_method: Callable[[str | None, tuple[_Marshallable, ...]], Fault | tuple[_Marshallable, ...]] | None = None,
+        data: str | ReadableBuffer,
+        dispatch_method: Callable[[str, tuple[_Marshallable, ...]], Fault | tuple[_Marshallable, ...]] | None = None,
         path: Any | None = None,
     ) -> str: ...  # undocumented
     def system_listMethods(self) -> list[str]: ...  # undocumented

package/dist/typeshed-fallback/stdlib/zoneinfo/__init__.pyi

@@ -1,50 +1,47 @@
-from _typeshed import StrPath
-from collections.abc import Iterable, Sequence
+import sys
+from collections.abc import Iterable
 from datetime import datetime, timedelta, tzinfo
-from typing import Any, Protocol
 from typing_extensions import Self
 
-__all__ = ["ZoneInfo", "reset_tzpath", "available_timezones", "TZPATH", "ZoneInfoNotFoundError", "InvalidTZPathWarning"]
+# TODO: remove this version check
+# In theory we shouldn't need this version check. Pyright complains about the imports
+# from zoneinfo.* when run on 3.8 and 3.7 without this. Updates to typeshed's
+# pyright test script are probably needed, see #11189
+if sys.version_info >= (3, 9):
+    from zoneinfo._common import ZoneInfoNotFoundError as ZoneInfoNotFoundError, _IOBytes
+    from zoneinfo._tzpath import (
+        TZPATH as TZPATH,
+        InvalidTZPathWarning as InvalidTZPathWarning,
+        available_timezones as available_timezones,
+        reset_tzpath as reset_tzpath,
+    )
 
-class _IOBytes(Protocol):
-    def read(self, size: int, /) -> bytes: ...
-    def seek(self, size: int, whence: int = ..., /) -> Any: ...
+    __all__ = ["ZoneInfo", "reset_tzpath", "available_timezones", "TZPATH", "ZoneInfoNotFoundError", "InvalidTZPathWarning"]
 
-class ZoneInfo(tzinfo):
-    @property
-    def key(self) -> str: ...
-    def __init__(self, key: str) -> None: ...
-    @classmethod
-    def no_cache(cls, key: str) -> Self:
-        """Get a new instance of ZoneInfo, bypassing the cache."""
-        ...
-    @classmethod
-    def from_file(cls, fobj: _IOBytes, /, key: str | None = None) -> Self:
-        """Create a ZoneInfo file from a file object."""
-        ...
-    @classmethod
-    def clear_cache(cls, *, only_keys: Iterable[str] | None = None) -> None:
-        """Clear the ZoneInfo cache."""
-        ...
-    def tzname(self, dt: datetime | None, /) -> str | None:
-        """Retrieve a string containing the abbreviation for the time zone that applies in a zone at a given datetime."""
-        ...
-    def utcoffset(self, dt: datetime | None, /) -> timedelta | None:
-        """Retrieve a timedelta representing the UTC offset in a zone at the given datetime."""
-        ...
-    def dst(self, dt: datetime | None, /) -> timedelta | None:
-        """Retrieve a timedelta representing the amount of DST applied in a zone at the given datetime."""
-        ...
+    class ZoneInfo(tzinfo):
+        @property
+        def key(self) -> str: ...
+        def __init__(self, key: str) -> None: ...
+        @classmethod
+        def no_cache(cls, key: str) -> Self:
+            """Get a new instance of ZoneInfo, bypassing the cache."""
+            ...
+        @classmethod
+        def from_file(cls, fobj: _IOBytes, /, key: str | None = None) -> Self:
+            """Create a ZoneInfo file from a file object."""
+            ...
+        @classmethod
+        def clear_cache(cls, *, only_keys: Iterable[str] | None = None) -> None:
+            """Clear the ZoneInfo cache."""
+            ...
+        def tzname(self, dt: datetime | None, /) -> str | None:
+            """Retrieve a string containing the abbreviation for the time zone that applies in a zone at a given datetime."""
+            ...
+        def utcoffset(self, dt: datetime | None, /) -> timedelta | None:
+            """Retrieve a timedelta representing the UTC offset in a zone at the given datetime."""
+            ...
+        def dst(self, dt: datetime | None, /) -> timedelta | None:
+            """Retrieve a timedelta representing the amount of DST applied in a zone at the given datetime."""
+            ...
 
-# Note: Both here and in clear_cache, the types allow the use of `str` where
-# a sequence of strings is required. This should be remedied if a solution
-# to this typing bug is found: https://github.com/python/typing/issues/256
-def reset_tzpath(to: Sequence[StrPath] | None = None) -> None: ...
-def available_timezones() -> set[str]: ...
-
-TZPATH: tuple[str, ...]
-
-class ZoneInfoNotFoundError(KeyError): ...
-class InvalidTZPathWarning(RuntimeWarning): ...
-
-def __dir__() -> list[str]: ...
+    def __dir__() -> list[str]: ...

package/dist/typeshed-fallback/stdlib/zoneinfo/_common.pyi

@@ -0,0 +1,13 @@
+import io
+from typing import Any, Protocol
+
+class _IOBytes(Protocol):
+    def read(self, size: int, /) -> bytes: ...
+    def seek(self, size: int, whence: int = ..., /) -> Any: ...
+
+def load_tzdata(key: str) -> io.BufferedReader: ...
+def load_data(
+    fobj: _IOBytes,
+) -> tuple[tuple[int, ...], tuple[int, ...], tuple[int, ...], tuple[int, ...], tuple[str, ...], bytes | None]: ...
+
+class ZoneInfoNotFoundError(KeyError): ...

package/dist/typeshed-fallback/stdlib/zoneinfo/_tzpath.pyi

@@ -0,0 +1,13 @@
+from _typeshed import StrPath
+from collections.abc import Sequence
+
+# Note: Both here and in clear_cache, the types allow the use of `str` where
+# a sequence of strings is required. This should be remedied if a solution
+# to this typing bug is found: https://github.com/python/typing/issues/256
+def reset_tzpath(to: Sequence[StrPath] | None = None) -> None: ...
+def find_tzfile(key: str) -> str | None: ...
+def available_timezones() -> set[str]: ...
+
+TZPATH: tuple[str, ...]
+
+class InvalidTZPathWarning(RuntimeWarning): ...

package/dist/typeshed-fallback/stubs/Flask-SocketIO/METADATA.toml

@@ -1,3 +1,3 @@
-version = "5.3.*"
+version = "5.4.*"
 requires = ["Flask>=0.9"]
 upstream_repository = "https://github.com/miguelgrinberg/flask-socketio"

package/dist/typeshed-fallback/stubs/braintree/METADATA.toml

@@ -1,2 +1,2 @@
-version = "4.29.*"
+version = "4.30.*"
 upstream_repository = "https://github.com/braintree/braintree_python"

package/dist/typeshed-fallback/stubs/braintree/braintree/error_codes.pyi

@@ -103,6 +103,7 @@ class ErrorCodes:
         ExpirationYearIsInvalid: Final = "81713"
         InvalidParamsForCreditCardUpdate: Final = "91745"
         InvalidVenmoSDKPaymentMethodCode: Final = "91727"
+        NetworkTokenizationAttributeCryptogramIsRequired: Final = "81762"
         NumberHasInvalidLength: Final = "81716"
         NumberLengthIsInvalid: Final = "81716"
         NumberIsInvalid: Final = "81715"

package/dist/typeshed-fallback/stubs/docutils/docutils/__init__.pyi

@@ -1,6 +1,8 @@
 from typing import Any, ClassVar, NamedTuple
 from typing_extensions import Self
 
+from docutils.transforms import Transform
+
 __docformat__: str
 __version__: str
 
@@ -32,7 +34,7 @@ class SettingsSpec:
     config_section_dependencies: ClassVar[tuple[str, ...] | None]
 
 class TransformSpec:
-    def get_transforms(self) -> list[Any]: ...
+    def get_transforms(self) -> list[type[Transform]]: ...
     default_transforms: ClassVar[tuple[Any, ...]]
     unknown_reference_resolvers: ClassVar[list[Any]]
 

package/dist/typeshed-fallback/stubs/docutils/docutils/frontend.pyi

@@ -5,7 +5,6 @@ from configparser import RawConfigParser
 from typing import Any, ClassVar
 
 from docutils import SettingsSpec
-from docutils.parsers import Parser
 from docutils.utils import DependencyList
 
 __docformat__: str
@@ -113,7 +112,7 @@ class OptionParser(optparse.OptionParser, SettingsSpec):
     version_template: ClassVar[str]
     def __init__(
         self,
-        components: Iterable[type[Parser]] = (),
+        components: Iterable[SettingsSpec | type[SettingsSpec]] = (),
         defaults: Mapping[str, Any] | None = None,
         read_config_files: bool | None = False,
         *args,

package/dist/typeshed-fallback/stubs/docutils/docutils/parsers/rst/directives/admonitions.pyi

@@ -1,3 +1,16 @@
-from _typeshed import Incomplete
+from docutils import nodes
+from docutils.parsers.rst import Directive
 
-def __getattr__(name: str) -> Incomplete: ...
+class BaseAdmonition(Directive):
+    node_class: type[nodes.Admonition]  # Subclasses must set this to the appropriate admonition node class.
+
+class Admonition(BaseAdmonition): ...
+class Attention(BaseAdmonition): ...
+class Caution(BaseAdmonition): ...
+class Danger(BaseAdmonition): ...
+class Error(BaseAdmonition): ...
+class Hint(BaseAdmonition): ...
+class Important(BaseAdmonition): ...
+class Note(BaseAdmonition): ...
+class Tip(BaseAdmonition): ...
+class Warning(BaseAdmonition): ...

package/dist/typeshed-fallback/stubs/docutils/docutils/readers/doctree.pyi

@@ -2,6 +2,6 @@ from typing import TypeVar
 
 from docutils import readers
 
-_S = TypeVar("_S")
+_S = TypeVar("_S", bound=str | bytes)
 
 class Reader(readers.ReReader[_S]): ...

package/dist/typeshed-fallback/stubs/docutils/docutils/writers/__init__.pyi

@@ -1,3 +1,22 @@
-from _typeshed import Incomplete
+from typing import Any, Generic, TypeVar
 
-def __getattr__(name: str) -> Incomplete: ...
+from docutils import Component, nodes
+from docutils.io import Output
+from docutils.languages import LanguageImporter
+
+_S = TypeVar("_S")
+
+class Writer(Component, Generic[_S]):
+    parts: dict[str, Any]
+    language: LanguageImporter | None = None
+    def __init__(self) -> None: ...
+    document: nodes.document | None = None
+    destination: Output | None = None
+    output: _S | None = None
+    def assemble_parts(self) -> None: ...
+    def translate(self) -> None: ...
+    def write(self, document: nodes.document, destination: Output) -> str | bytes | None: ...
+
+class UnfilteredWriter(Writer[_S]): ...
+
+def get_writer_class(writer_name: str) -> type[Writer[Any]]: ...

package/dist/typeshed-fallback/stubs/fpdf2/fpdf/fpdf.pyi

@@ -450,7 +450,7 @@ class FPDF(GraphicsStateMixin):
         ln: int | Literal["DEPRECATED"] = "DEPRECATED",
         align: str | Align = ...,
         fill: bool = False,
-        link: str = "",
+        link: str | int = "",
         center: bool = False,
         markdown: bool = False,
         new_x: XPos | str = ...,
@@ -467,7 +467,7 @@ class FPDF(GraphicsStateMixin):
         align: str | Align = ...,
         fill: bool = False,
         split_only: bool = False,
-        link: str = "",
+        link: str | int = "",
         ln: int | Literal["DEPRECATED"] = "DEPRECATED",
         max_line_height: float | None = None,
         markdown: bool = False,
@@ -481,7 +481,7 @@ class FPDF(GraphicsStateMixin):
         padding: int = 0,
     ): ...
     def write(
-        self, h: float | None = None, text: str = "", link: str = "", print_sh: bool = False, wrapmode: WrapMode = ...
+        self, h: float | None = None, text: str = "", link: str | int = "", print_sh: bool = False, wrapmode: WrapMode = ...
     ) -> bool: ...
     def text_columns(
         self,
@@ -507,7 +507,7 @@ class FPDF(GraphicsStateMixin):
         w: float = 0,
         h: float = 0,
         type: str = "",
-        link: str = "",
+        link: str | int = "",
         title: str | None = None,
         alt_text: str | None = None,
         dims: tuple[float, float] | None = None,

package/dist/typeshed-fallback/stubs/greenlet/METADATA.toml

@@ -1,2 +1,2 @@
-version = "3.0.*"
+version = "3.1.*"
 upstream_repository = "https://github.com/python-greenlet/greenlet"

package/dist/typeshed-fallback/stubs/hdbcli/METADATA.toml

@@ -1,2 +1,2 @@
-version = "2.21.*"
+version = "2.22.*"
 # upstream_repository = closed-source

package/dist/typeshed-fallback/stubs/icalendar/METADATA.toml

@@ -1,3 +1,6 @@
-version = "5.0.*"
+version = "6.0.*"
 upstream_repository = "https://github.com/collective/icalendar"
-requires = ["types-pytz"]
+requires = ["types-python-dateutil", "backports.zoneinfo; python_version<'3.9'"]
+
+[tool.stubtest]
+stubtest_requirements = ["pytz"]

package/dist/typeshed-fallback/stubs/icalendar/icalendar/__init__.pyi

@@ -1,8 +1,7 @@
-from typing import Final
-
 from .cal import (
     Alarm as Alarm,
     Calendar as Calendar,
+    Component as Component,
     ComponentFactory as ComponentFactory,
     Event as Event,
     FreeBusy as FreeBusy,
@@ -14,8 +13,6 @@ from .cal import (
 )
 from .parser import Parameters as Parameters, q_join as q_join, q_split as q_split
 from .prop import (
-    FixedOffset as FixedOffset,
-    LocalTimezone as LocalTimezone,
     TypesFactory as TypesFactory,
     vBinary as vBinary,
     vBoolean as vBoolean,
@@ -36,5 +33,52 @@ from .prop import (
     vUTCOffset as vUTCOffset,
     vWeekday as vWeekday,
 )
+from .timezone import use_pytz, use_zoneinfo
+from .version import (
+    __version__ as __version__,
+    __version_tuple__ as __version_tuple__,
+    version as version,
+    version_tuple as version_tuple,
+)
 
-__version__: Final[str]
+__all__ = [
+    "Calendar",
+    "Event",
+    "Todo",
+    "Journal",
+    "Timezone",
+    "TimezoneStandard",
+    "TimezoneDaylight",
+    "FreeBusy",
+    "Alarm",
+    "ComponentFactory",
+    "vBinary",
+    "vBoolean",
+    "vCalAddress",
+    "vDatetime",
+    "vDate",
+    "vDDDTypes",
+    "vDuration",
+    "vFloat",
+    "vInt",
+    "vPeriod",
+    "vWeekday",
+    "vFrequency",
+    "vRecur",
+    "vText",
+    "vTime",
+    "vUri",
+    "vGeo",
+    "vUTCOffset",
+    "Parameters",
+    "q_split",
+    "q_join",
+    "use_pytz",
+    "use_zoneinfo",
+    "__version__",
+    "version",
+    "__version_tuple__",
+    "version_tuple",
+    "TypesFactory",
+    "Component",
+]

package/dist/typeshed-fallback/stubs/icalendar/icalendar/cal.pyi

@@ -1,12 +1,31 @@
+import datetime
 from _typeshed import Incomplete, SupportsItems
+from collections.abc import Callable
 from typing import Any, ClassVar, Final, Literal, overload
 
-from pytz.tzinfo import DstTzInfo
-
 from .caselessdict import CaselessDict
 from .parser import Contentline, Contentlines
 from .prop import TypesFactory
 
+__all__ = [
+    "Alarm",
+    "Calendar",
+    "Component",
+    "ComponentFactory",
+    "Event",
+    "FreeBusy",
+    "INLINE",
+    "Journal",
+    "Timezone",
+    "TimezoneDaylight",
+    "TimezoneStandard",
+    "Todo",
+    "component_factory",
+    "get_example",
+]
+
+def get_example(component_directory: str, example_name: str) -> bytes: ...
+
 class ComponentFactory(CaselessDict[Incomplete]):
     def __init__(self, *args, **kwargs) -> None: ...
 
@@ -27,8 +46,6 @@ class Component(CaselessDict[Incomplete]):
     def __bool__(self) -> bool: ...
     __nonzero__ = __bool__
     def is_empty(self) -> bool: ...
-    @property
-    def is_broken(self) -> bool: ...
     @overload
     def add(self, name: str, value: Any, *, encode: Literal[False]) -> None: ...
     @overload
@@ -41,7 +58,7 @@ class Component(CaselessDict[Incomplete]):
     def get_inline(self, name, decode: bool = True): ...
     def set_inline(self, name, values, encode: bool = True) -> None: ...
     def add_component(self, component: Component) -> None: ...
-    def walk(self, name: Incomplete | None = None): ...
+    def walk(self, name: str | None = None, select: Callable[[Component], bool] = ...): ...
     def property_items(self, recursive: bool = True, sorted: bool = True): ...
     @overload
     @classmethod
@@ -56,6 +73,8 @@ class Component(CaselessDict[Incomplete]):
 
 class Event(Component):
     name: ClassVar[Literal["VEVENT"]]
+    @classmethod
+    def example(cls, name: str) -> Event: ...
 
 class Todo(Component):
     name: ClassVar[Literal["VTODO"]]
@@ -68,7 +87,12 @@ class FreeBusy(Component):
 
 class Timezone(Component):
     name: ClassVar[Literal["VTIMEZONE"]]
-    def to_tz(self) -> DstTzInfo: ...
+    @classmethod
+    def example(cls, name: str) -> Calendar: ...
+    def to_tz(self, tzp=...): ...  # FIXME -> DstTzInfo: ...
+    @property
+    def tz_name(self) -> str: ...
+    def get_transitions(self) -> tuple[list[datetime.datetime], list[tuple[datetime.timedelta, datetime.timedelta, str]]]: ...
 
 class TimezoneStandard(Component):
     name: ClassVar[Literal["STANDARD"]]
@@ -81,6 +105,8 @@ class Alarm(Component):
 
 class Calendar(Component):
     name: ClassVar[Literal["VCALENDAR"]]
+    @classmethod
+    def example(cls, name: str) -> Calendar: ...
 
 types_factory: Final[TypesFactory]
 component_factory: Final[ComponentFactory]

package/dist/typeshed-fallback/stubs/icalendar/icalendar/caselessdict.pyi

@@ -4,6 +4,8 @@ from collections.abc import Iterable, Mapping
 from typing import ClassVar, TypeVar, overload
 from typing_extensions import Self
 
+__all__ = ["canonsort_keys", "canonsort_items", "CaselessDict"]
+
 _T = TypeVar("_T")
 _VT = TypeVar("_VT")
 

package/dist/typeshed-fallback/stubs/icalendar/icalendar/parser.pyi

@@ -7,9 +7,33 @@ from typing_extensions import Self
 
 from .caselessdict import CaselessDict
 
+__all__ = [
+    "Contentline",
+    "Contentlines",
+    "FOLD",
+    "NAME",
+    "NEWLINE",
+    "Parameters",
+    "QUNSAFE_CHAR",
+    "QUOTABLE",
+    "UNSAFE_CHAR",
+    "dquote",
+    "escape_char",
+    "escape_string",
+    "foldline",
+    "param_value",
+    "q_join",
+    "q_split",
+    "uFOLD",
+    "unescape_char",
+    "unescape_list_or_string",
+    "unescape_string",
+    "validate_param_value",
+    "validate_token",
+]
+
 def escape_char(text: str) -> str: ...
 def unescape_char(text: AnyStr) -> AnyStr: ...
-def tzid_from_dt(dt): ...
 def foldline(line: str, limit: int = 75, fold_sep: str = "\r\n ") -> str: ...
 def param_value(value: str | list[str] | tuple[str, ...] | Incomplete) -> str: ...
 

package/dist/typeshed-fallback/stubs/icalendar/icalendar/parser_tools.pyi

@@ -1,14 +1,18 @@
 from typing import Any, Final, TypeVar, overload
+from typing_extensions import TypeAlias
 
 _T = TypeVar("_T")
 
+__all__ = ["DEFAULT_ENCODING", "SEQUENCE_TYPES", "ICAL_TYPE", "data_encode", "from_unicode", "to_unicode"]
+
 SEQUENCE_TYPES: Final[tuple[type[Any], ...]]
 DEFAULT_ENCODING: str
+ICAL_TYPE: TypeAlias = str | bytes
 
-def from_unicode(value: str | bytes, encoding: str = "utf-8") -> bytes: ...
-def to_unicode(value: str | bytes, encoding: str = "utf-8") -> str: ...
+def from_unicode(value: ICAL_TYPE, encoding: str = "utf-8") -> bytes: ...
+def to_unicode(value: ICAL_TYPE, encoding: str = "utf-8-sig") -> str: ...
 @overload
-def data_encode(data: str, encoding: str = ...) -> bytes: ...
+def data_encode(data: ICAL_TYPE, encoding: str = ...) -> bytes: ...
 @overload
 def data_encode(data: dict[Any, Any], encoding: str = ...) -> dict[Any, Any]: ...
 @overload