homeassistant-stubs 2024.10.3__py3-none-any.whl → 2024.11.0__py3-none-any.whl

homeassistant-stubs/components/sleepiq/entity.pyi

@@ -9,6 +9,7 @@ from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo
 from homeassistant.helpers.entity import Entity as Entity
 from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
 
+type _DataCoordinatorType = SleepIQDataUpdateCoordinator | SleepIQPauseUpdateCoordinator
 def device_from_bed(bed: SleepIQBed) -> DeviceInfo: ...
 def sleeper_for_side(bed: SleepIQBed, side: str) -> SleepIQSleeper: ...
 
@@ -17,7 +18,7 @@ class SleepIQEntity(Entity):
     _attr_device_info: Incomplete
     def __init__(self, bed: SleepIQBed) -> None: ...
 
-class SleepIQBedEntity(CoordinatorEntity[_SleepIQCoordinatorT], metaclass=abc.ABCMeta):
+class SleepIQBedEntity[_SleepIQCoordinatorT: _DataCoordinatorType](CoordinatorEntity[_SleepIQCoordinatorT], metaclass=abc.ABCMeta):
     _attr_icon = ICON_OCCUPIED
     bed: Incomplete
     _attr_device_info: Incomplete
@@ -26,7 +27,7 @@ class SleepIQBedEntity(CoordinatorEntity[_SleepIQCoordinatorT], metaclass=abc.AB
     @abstractmethod
     def _async_update_attrs(self) -> None: ...
 
-class SleepIQSleeperEntity(SleepIQBedEntity[_SleepIQCoordinatorT], metaclass=abc.ABCMeta):
+class SleepIQSleeperEntity[_SleepIQCoordinatorT: _DataCoordinatorType](SleepIQBedEntity[_SleepIQCoordinatorT], metaclass=abc.ABCMeta):
     _attr_icon = ICON_OCCUPIED
     sleeper: Incomplete
     _attr_name: Incomplete

homeassistant-stubs/components/smhi/config_flow.pyi

@@ -1,5 +1,5 @@
 from .const import DEFAULT_NAME as DEFAULT_NAME, DOMAIN as DOMAIN, HOME_LOCATION_NAME as HOME_LOCATION_NAME
-from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
+from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
 from homeassistant.const import CONF_LATITUDE as CONF_LATITUDE, CONF_LOCATION as CONF_LOCATION, CONF_LONGITUDE as CONF_LONGITUDE, CONF_NAME as CONF_NAME
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers import aiohttp_client as aiohttp_client
@@ -10,7 +10,5 @@ async def async_check_location(hass: HomeAssistant, longitude: float, latitude:
 
 class SmhiFlowHandler(ConfigFlow, domain=DOMAIN):
     VERSION: int
-    config_entry: ConfigEntry | None
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_reconfigure(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
-    async def async_step_reconfigure_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/smlight/__init__.pyi

@@ -12,6 +12,7 @@ class SmlightData:
     data: SmDataUpdateCoordinator
     firmware: SmFirmwareUpdateCoordinator
     def __init__(self, *, data, firmware) -> None: ...
+type SmConfigEntry = ConfigEntry[SmlightData]
 
 async def async_setup_entry(hass: HomeAssistant, entry: SmConfigEntry) -> bool: ...
 async def async_unload_entry(hass: HomeAssistant, entry: SmConfigEntry) -> bool: ...

homeassistant-stubs/components/smlight/config_flow.pyi

@@ -1,4 +1,3 @@
-from . import SmConfigEntry as SmConfigEntry
 from .const import DOMAIN as DOMAIN
 from _typeshed import Incomplete
 from collections.abc import Mapping
@@ -15,7 +14,6 @@ STEP_AUTH_DATA_SCHEMA: Incomplete
 class SmlightConfigFlow(ConfigFlow, domain=DOMAIN):
     client: Incomplete
     host: Incomplete
-    _reauth_entry: Incomplete
     def __init__(self) -> None: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_auth(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/smlight/coordinator.pyi

@@ -27,7 +27,7 @@ class SmFwData:
     zb_firmware: list[Firmware] | None
     def __init__(self, info, esp_firmware, zb_firmware) -> None: ...
 
-class SmBaseDataUpdateCoordinator(DataUpdateCoordinator[_DataT], metaclass=abc.ABCMeta):
+class SmBaseDataUpdateCoordinator[_DataT](DataUpdateCoordinator[_DataT], metaclass=abc.ABCMeta):
     config_entry: SmConfigEntry
     client: Incomplete
     unique_id: Incomplete

homeassistant-stubs/components/smlight/update.pyi

@@ -1,4 +1,5 @@
 from . import SmConfigEntry as SmConfigEntry
+from .const import LOGGER as LOGGER
 from .coordinator import SmFirmwareUpdateCoordinator as SmFirmwareUpdateCoordinator, SmFwData as SmFwData
 from .entity import SmEntity as SmEntity
 from _typeshed import Incomplete
@@ -17,7 +18,7 @@ from typing import Any, Final
 class SmUpdateEntityDescription(UpdateEntityDescription):
     installed_version: Callable[[Info], str | None]
     fw_list: Callable[[SmFwData], list[Firmware] | None]
-    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., installed_version, fw_list) -> None: ...
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., display_precision=..., installed_version, fw_list) -> None: ...
 
 UPDATE_ENTITIES: Final[Incomplete]
 
@@ -40,8 +41,9 @@ class SmUpdateEntity(SmEntity, UpdateEntity):
     def latest_version(self) -> str | None: ...
     def register_callbacks(self) -> None: ...
     def release_notes(self) -> str | None: ...
-    _attr_in_progress: Incomplete
+    _attr_update_percentage: Incomplete
     def _update_progress(self, progress: MessageEvent) -> None: ...
+    _attr_in_progress: bool
     def _update_done(self) -> None: ...
     def _update_finished(self, event: MessageEvent) -> None: ...
     def _update_failed(self, event: MessageEvent) -> None: ...

homeassistant-stubs/components/solarlog/__init__.pyi

@@ -7,6 +7,7 @@ from homeassistant.core import HomeAssistant as HomeAssistant
 
 _LOGGER: Incomplete
 PLATFORMS: Incomplete
+type SolarlogConfigEntry = ConfigEntry[SolarLogCoordinator]
 
 async def async_setup_entry(hass: HomeAssistant, entry: SolarlogConfigEntry) -> bool: ...
 async def async_unload_entry(hass: HomeAssistant, entry: SolarlogConfigEntry) -> bool: ...

homeassistant-stubs/components/solarlog/config_flow.pyi

@@ -1,4 +1,3 @@
-from . import SolarlogConfigEntry as SolarlogConfigEntry
 from .const import CONF_HAS_PWD as CONF_HAS_PWD, DEFAULT_HOST as DEFAULT_HOST, DEFAULT_NAME as DEFAULT_NAME, DOMAIN as DOMAIN
 from _typeshed import Incomplete
 from collections.abc import Mapping
@@ -10,7 +9,6 @@ from typing import Any
 _LOGGER: Incomplete
 
 class SolarLogConfigFlow(ConfigFlow, domain=DOMAIN):
-    _entry: SolarlogConfigEntry | None
     VERSION: int
     MINOR_VERSION: int
     _errors: Incomplete
@@ -21,7 +19,6 @@ class SolarLogConfigFlow(ConfigFlow, domain=DOMAIN):
     async def _test_extended_data(self, host: str, pwd: str = '') -> bool: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_password(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
-    async def async_step_reconfigure(self, entry_data: Mapping[str, Any]) -> ConfigFlowResult: ...
-    async def async_step_reconfigure_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_reconfigure(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_reauth(self, entry_data: Mapping[str, Any]) -> ConfigFlowResult: ...
     async def async_step_reauth_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/solarlog/coordinator.pyi

@@ -1,14 +1,19 @@
 from . import SolarlogConfigEntry as SolarlogConfigEntry
+from .const import DOMAIN as DOMAIN
 from _typeshed import Incomplete
+from collections.abc import Callable as Callable
 from homeassistant.const import CONF_HOST as CONF_HOST
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed, ConfigEntryNotReady as ConfigEntryNotReady
 from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
+from homeassistant.util import slugify as slugify
 from solarlog_cli.solarlog_models import SolarlogData
 
 _LOGGER: Incomplete
 
 class SolarLogCoordinator(DataUpdateCoordinator[SolarlogData]):
+    new_device_callbacks: Incomplete
+    _devices_last_update: Incomplete
     unique_id: Incomplete
     name: Incomplete
     host: Incomplete
@@ -16,4 +21,5 @@ class SolarLogCoordinator(DataUpdateCoordinator[SolarlogData]):
     def __init__(self, hass: HomeAssistant, entry: SolarlogConfigEntry) -> None: ...
     async def _async_setup(self) -> None: ...
     async def _async_update_data(self) -> SolarlogData: ...
+    def _async_add_remove_devices(self, data: SolarlogData) -> None: ...
     async def renew_authentication(self) -> bool: ...

homeassistant-stubs/components/sonarr/config_flow.pyi

@@ -2,7 +2,7 @@ import voluptuous as vol
 from .const import CONF_UPCOMING_DAYS as CONF_UPCOMING_DAYS, CONF_WANTED_MAX_ITEMS as CONF_WANTED_MAX_ITEMS, DEFAULT_UPCOMING_DAYS as DEFAULT_UPCOMING_DAYS, DEFAULT_VERIFY_SSL as DEFAULT_VERIFY_SSL, DEFAULT_WANTED_MAX_ITEMS as DEFAULT_WANTED_MAX_ITEMS, DOMAIN as DOMAIN
 from _typeshed import Incomplete
 from collections.abc import Mapping
-from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, OptionsFlow as OptionsFlow
+from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, OptionsFlow as OptionsFlow, SOURCE_REAUTH as SOURCE_REAUTH
 from homeassistant.const import CONF_API_KEY as CONF_API_KEY, CONF_URL as CONF_URL, CONF_VERIFY_SSL as CONF_VERIFY_SSL
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
@@ -14,14 +14,11 @@ async def _validate_input(hass: HomeAssistant, data: dict[str, Any]) -> None: ..
 
 class SonarrConfigFlow(ConfigFlow, domain=DOMAIN):
     VERSION: int
-    entry: Incomplete
-    def __init__(self) -> None: ...
     @staticmethod
     def async_get_options_flow(config_entry: ConfigEntry) -> SonarrOptionsFlowHandler: ...
     async def async_step_reauth(self, entry_data: Mapping[str, Any]) -> ConfigFlowResult: ...
     async def async_step_reauth_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
-    async def _async_reauth_update_entry(self, data: dict[str, Any]) -> ConfigFlowResult: ...
     def _get_user_data_schema(self) -> dict[vol.Marker, type]: ...
 
 class SonarrOptionsFlowHandler(OptionsFlow):

homeassistant-stubs/components/speedtestdotnet/__init__.pyi

@@ -1,12 +1,13 @@
 from .coordinator import SpeedTestDataCoordinator as SpeedTestDataCoordinator
 from _typeshed import Incomplete
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigEntryState as ConfigEntryState
 from homeassistant.const import Platform as Platform
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.exceptions import ConfigEntryNotReady as ConfigEntryNotReady
 from homeassistant.helpers.start import async_at_started as async_at_started
 
 PLATFORMS: Incomplete
+type SpeedTestConfigEntry = ConfigEntry[SpeedTestDataCoordinator]
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: SpeedTestConfigEntry) -> bool: ...
 async def async_unload_entry(hass: HomeAssistant, config_entry: ConfigEntry) -> bool: ...

homeassistant-stubs/components/spotify/__init__.pyi

@@ -0,0 +1,5 @@
+from .browse_media import async_browse_media as async_browse_media
+from .const import DOMAIN as DOMAIN
+from .util import is_spotify_media_type as is_spotify_media_type, resolve_spotify_media_type as resolve_spotify_media_type, spotify_uri_from_media_browser_url as spotify_uri_from_media_browser_url
+
+__all__ = ['async_browse_media', 'DOMAIN', 'spotify_uri_from_media_browser_url', 'is_spotify_media_type', 'resolve_spotify_media_type']

homeassistant-stubs/components/spotify/application_credentials.pyi

@@ -0,0 +1,4 @@
+from homeassistant.components.application_credentials import AuthorizationServer as AuthorizationServer
+from homeassistant.core import HomeAssistant as HomeAssistant
+
+async def async_get_authorization_server(hass: HomeAssistant) -> AuthorizationServer: ...

homeassistant-stubs/components/spotify/browse_media.pyi

@@ -0,0 +1,49 @@
+from .const import DOMAIN as DOMAIN, MEDIA_PLAYER_PREFIX as MEDIA_PLAYER_PREFIX, MEDIA_TYPE_SHOW as MEDIA_TYPE_SHOW, PLAYABLE_MEDIA_TYPES as PLAYABLE_MEDIA_TYPES
+from .util import fetch_image_url as fetch_image_url
+from _typeshed import Incomplete
+from enum import StrEnum
+from homeassistant.components.media_player import BrowseError as BrowseError, BrowseMedia as BrowseMedia, MediaClass as MediaClass, MediaType as MediaType
+from homeassistant.config_entries import ConfigEntryState as ConfigEntryState
+from homeassistant.core import HomeAssistant as HomeAssistant
+from spotifyaio import Artist as Artist, BasePlaylist as BasePlaylist, SimplifiedAlbum as SimplifiedAlbum, SimplifiedTrack as SimplifiedTrack, SpotifyClient as SpotifyClient
+from typing import Any, TypedDict
+
+BROWSE_LIMIT: int
+_LOGGER: Incomplete
+
+class ItemPayload(TypedDict):
+    name: str
+    type: str
+    uri: str
+    id: str | None
+    thumbnail: str | None
+
+def _get_artist_item_payload(artist: Artist) -> ItemPayload: ...
+def _get_album_item_payload(album: SimplifiedAlbum) -> ItemPayload: ...
+def _get_playlist_item_payload(playlist: BasePlaylist) -> ItemPayload: ...
+def _get_track_item_payload(track: SimplifiedTrack, show_thumbnails: bool = True) -> ItemPayload: ...
+
+class BrowsableMedia(StrEnum):
+    CURRENT_USER_PLAYLISTS = 'current_user_playlists'
+    CURRENT_USER_FOLLOWED_ARTISTS = 'current_user_followed_artists'
+    CURRENT_USER_SAVED_ALBUMS = 'current_user_saved_albums'
+    CURRENT_USER_SAVED_TRACKS = 'current_user_saved_tracks'
+    CURRENT_USER_SAVED_SHOWS = 'current_user_saved_shows'
+    CURRENT_USER_RECENTLY_PLAYED = 'current_user_recently_played'
+    CURRENT_USER_TOP_ARTISTS = 'current_user_top_artists'
+    CURRENT_USER_TOP_TRACKS = 'current_user_top_tracks'
+    CATEGORIES = 'categories'
+    FEATURED_PLAYLISTS = 'featured_playlists'
+    NEW_RELEASES = 'new_releases'
+
+LIBRARY_MAP: Incomplete
+CONTENT_TYPE_MEDIA_CLASS: dict[str, Any]
+
+class MissingMediaInformation(BrowseError): ...
+class UnknownMediaType(BrowseError): ...
+
+async def async_browse_media(hass: HomeAssistant, media_content_type: str | None, media_content_id: str | None, *, can_play_artist: bool = True) -> BrowseMedia: ...
+async def async_browse_media_internal(hass: HomeAssistant, spotify: SpotifyClient, media_content_type: str | None, media_content_id: str | None, *, can_play_artist: bool = True) -> BrowseMedia: ...
+async def build_item_response(spotify: SpotifyClient, payload: dict[str, str | None], *, can_play_artist: bool) -> BrowseMedia | None: ...
+def item_payload(item: ItemPayload, *, can_play_artist: bool) -> BrowseMedia: ...
+async def library_payload(*, can_play_artist: bool) -> BrowseMedia: ...

homeassistant-stubs/components/spotify/config_flow.pyi

@@ -0,0 +1,19 @@
+import logging
+from .const import DOMAIN as DOMAIN, SPOTIFY_SCOPES as SPOTIFY_SCOPES
+from collections.abc import Mapping
+from homeassistant.config_entries import ConfigFlowResult as ConfigFlowResult, SOURCE_REAUTH as SOURCE_REAUTH
+from homeassistant.const import CONF_ACCESS_TOKEN as CONF_ACCESS_TOKEN, CONF_NAME as CONF_NAME, CONF_TOKEN as CONF_TOKEN
+from homeassistant.helpers import config_entry_oauth2_flow as config_entry_oauth2_flow
+from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
+from typing import Any
+
+class SpotifyFlowHandler(config_entry_oauth2_flow.AbstractOAuth2FlowHandler, domain=DOMAIN):
+    DOMAIN = DOMAIN
+    VERSION: int
+    @property
+    def logger(self) -> logging.Logger: ...
+    @property
+    def extra_authorize_data(self) -> dict[str, Any]: ...
+    async def async_oauth_create_entry(self, data: dict[str, Any]) -> ConfigFlowResult: ...
+    async def async_step_reauth(self, entry_data: Mapping[str, Any]) -> ConfigFlowResult: ...
+    async def async_step_reauth_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/spotify/const.pyi

@@ -0,0 +1,9 @@
+from _typeshed import Incomplete
+from homeassistant.components.media_player import MediaType as MediaType
+
+DOMAIN: str
+LOGGER: Incomplete
+SPOTIFY_SCOPES: Incomplete
+MEDIA_PLAYER_PREFIX: str
+MEDIA_TYPE_SHOW: str
+PLAYABLE_MEDIA_TYPES: Incomplete

homeassistant-stubs/components/spotify/coordinator.pyi

@@ -0,0 +1,34 @@
+from .const import DOMAIN as DOMAIN
+from .models import SpotifyData as SpotifyData
+from _typeshed import Incomplete
+from dataclasses import dataclass
+from datetime import datetime
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
+from spotifyaio import PlaybackState as PlaybackState, Playlist as Playlist, SpotifyClient as SpotifyClient, UserProfile as UserProfile
+from spotifyaio.models import AudioFeatures as AudioFeatures
+
+_LOGGER: Incomplete
+type SpotifyConfigEntry = ConfigEntry[SpotifyData]
+
+@dataclass
+class SpotifyCoordinatorData:
+    current_playback: PlaybackState | None
+    position_updated_at: datetime | None
+    playlist: Playlist | None
+    audio_features: AudioFeatures | None
+    dj_playlist: bool = ...
+    def __init__(self, current_playback, position_updated_at, playlist, audio_features, dj_playlist=...) -> None: ...
+
+SPOTIFY_DJ_PLAYLIST_URI: str
+
+class SpotifyCoordinator(DataUpdateCoordinator[SpotifyCoordinatorData]):
+    current_user: UserProfile
+    config_entry: SpotifyConfigEntry
+    client: Incomplete
+    _playlist: Incomplete
+    _currently_loaded_track: Incomplete
+    def __init__(self, hass: HomeAssistant, client: SpotifyClient) -> None: ...
+    async def _async_setup(self) -> None: ...
+    async def _async_update_data(self) -> SpotifyCoordinatorData: ...

homeassistant-stubs/components/spotify/diagnostics.pyi

@@ -0,0 +1,5 @@
+from .coordinator import SpotifyConfigEntry as SpotifyConfigEntry
+from homeassistant.core import HomeAssistant as HomeAssistant
+from typing import Any
+
+async def async_get_config_entry_diagnostics(hass: HomeAssistant, entry: SpotifyConfigEntry) -> dict[str, Any]: ...

homeassistant-stubs/components/spotify/entity.pyi

@@ -0,0 +1,10 @@
+from .const import DOMAIN as DOMAIN
+from .coordinator import SpotifyCoordinator as SpotifyCoordinator
+from _typeshed import Incomplete
+from homeassistant.helpers.device_registry import DeviceEntryType as DeviceEntryType, DeviceInfo as DeviceInfo
+from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
+
+class SpotifyEntity(CoordinatorEntity[SpotifyCoordinator]):
+    _attr_has_entity_name: bool
+    _attr_device_info: Incomplete
+    def __init__(self, coordinator: SpotifyCoordinator) -> None: ...

homeassistant-stubs/components/spotify/media_player.pyi

@@ -0,0 +1,82 @@
+import datetime as dt
+from .browse_media import async_browse_media_internal as async_browse_media_internal
+from .const import MEDIA_PLAYER_PREFIX as MEDIA_PLAYER_PREFIX, PLAYABLE_MEDIA_TYPES as PLAYABLE_MEDIA_TYPES
+from .coordinator import SpotifyConfigEntry as SpotifyConfigEntry, SpotifyCoordinator as SpotifyCoordinator
+from .entity import SpotifyEntity as SpotifyEntity
+from _typeshed import Incomplete
+from collections.abc import Awaitable, Callable as Callable, Coroutine
+from homeassistant.components.media_player import ATTR_MEDIA_ENQUEUE as ATTR_MEDIA_ENQUEUE, BrowseMedia as BrowseMedia, MediaPlayerEnqueue as MediaPlayerEnqueue, MediaPlayerEntity as MediaPlayerEntity, MediaPlayerEntityFeature as MediaPlayerEntityFeature, MediaPlayerState as MediaPlayerState, MediaType as MediaType, RepeatMode as RepeatMode
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator
+from spotifyaio import Device as Device, Item as Item, PlaybackState as PlaybackState
+from typing import Any, Concatenate
+
+_LOGGER: Incomplete
+SUPPORT_SPOTIFY: Incomplete
+REPEAT_MODE_MAPPING_TO_HA: Incomplete
+REPEAT_MODE_MAPPING_TO_SPOTIFY: Incomplete
+AFTER_REQUEST_SLEEP: int
+
+async def async_setup_entry(hass: HomeAssistant, entry: SpotifyConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+def ensure_item[_R](func: Callable[[SpotifyMediaPlayer, Item], _R]) -> Callable[[SpotifyMediaPlayer], _R | None]: ...
+def async_refresh_after[_T: SpotifyEntity, **_P](func: Callable[Concatenate[_T, _P], Awaitable[None]]) -> Callable[Concatenate[_T, _P], Coroutine[Any, Any, None]]: ...
+
+class SpotifyMediaPlayer(SpotifyEntity, MediaPlayerEntity):
+    _attr_media_image_remotely_accessible: bool
+    _attr_name: Incomplete
+    _attr_translation_key: str
+    devices: Incomplete
+    _attr_unique_id: Incomplete
+    def __init__(self, coordinator: SpotifyCoordinator, device_coordinator: DataUpdateCoordinator[list[Device]]) -> None: ...
+    @property
+    def currently_playing(self) -> PlaybackState | None: ...
+    @property
+    def supported_features(self) -> MediaPlayerEntityFeature: ...
+    @property
+    def state(self) -> MediaPlayerState: ...
+    @property
+    def volume_level(self) -> float | None: ...
+    @property
+    def media_content_id(self, item: Item) -> str: ...
+    @property
+    def media_content_type(self, item: Item) -> str: ...
+    @property
+    def media_duration(self, item: Item) -> int: ...
+    @property
+    def media_position(self) -> int | None: ...
+    @property
+    def media_position_updated_at(self) -> dt.datetime | None: ...
+    @property
+    def media_image_url(self, item: Item) -> str | None: ...
+    @property
+    def media_title(self, item: Item) -> str: ...
+    @property
+    def media_artist(self, item: Item) -> str: ...
+    @property
+    def media_album_name(self, item: Item) -> str: ...
+    @property
+    def media_track(self, item: Item) -> int | None: ...
+    @property
+    def media_playlist(self) -> str | None: ...
+    @property
+    def source(self) -> str | None: ...
+    @property
+    def source_list(self) -> list[str] | None: ...
+    @property
+    def shuffle(self) -> bool | None: ...
+    @property
+    def repeat(self) -> RepeatMode | None: ...
+    async def async_set_volume_level(self, volume: float) -> None: ...
+    async def async_media_play(self) -> None: ...
+    async def async_media_pause(self) -> None: ...
+    async def async_media_previous_track(self) -> None: ...
+    async def async_media_next_track(self) -> None: ...
+    async def async_media_seek(self, position: float) -> None: ...
+    async def async_play_media(self, media_type: MediaType | str, media_id: str, **kwargs: Any) -> None: ...
+    async def async_select_source(self, source: str) -> None: ...
+    async def async_set_shuffle(self, shuffle: bool) -> None: ...
+    async def async_set_repeat(self, repeat: RepeatMode) -> None: ...
+    async def async_browse_media(self, media_content_type: MediaType | str | None = None, media_content_id: str | None = None) -> BrowseMedia: ...
+    def _handle_devices_update(self) -> None: ...
+    async def async_added_to_hass(self) -> None: ...

homeassistant-stubs/components/spotify/models.pyi

@@ -0,0 +1,12 @@
+from .coordinator import SpotifyCoordinator as SpotifyCoordinator
+from dataclasses import dataclass
+from homeassistant.helpers.config_entry_oauth2_flow import OAuth2Session as OAuth2Session
+from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator
+from spotifyaio import Device as Device
+
+@dataclass
+class SpotifyData:
+    coordinator: SpotifyCoordinator
+    session: OAuth2Session
+    devices: DataUpdateCoordinator[list[Device]]
+    def __init__(self, coordinator, session, devices) -> None: ...

homeassistant-stubs/components/spotify/sensor.pyi

@@ -0,0 +1,31 @@
+from .coordinator import SpotifyConfigEntry as SpotifyConfigEntry, SpotifyCoordinator as SpotifyCoordinator
+from .entity import SpotifyEntity as SpotifyEntity
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass, SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription
+from homeassistant.const import PERCENTAGE as PERCENTAGE
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from spotifyaio.models import AudioFeatures as AudioFeatures, Key
+
+@dataclass(frozen=True, kw_only=True)
+class SpotifyAudioFeaturesSensorEntityDescription(SensorEntityDescription):
+    value_fn: Callable[[AudioFeatures], float | str | None]
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., last_reset=..., native_unit_of_measurement=..., options=..., state_class=..., suggested_display_precision=..., suggested_unit_of_measurement=..., value_fn) -> None: ...
+
+KEYS: dict[Key, str]
+KEY_OPTIONS: Incomplete
+
+def _get_key(audio_features: AudioFeatures) -> str | None: ...
+
+AUDIO_FEATURE_SENSORS: tuple[SpotifyAudioFeaturesSensorEntityDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: SpotifyConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+class SpotifyAudioFeatureSensor(SpotifyEntity, SensorEntity):
+    entity_description: SpotifyAudioFeaturesSensorEntityDescription
+    _attr_unique_id: Incomplete
+    def __init__(self, coordinator: SpotifyCoordinator, entity_description: SpotifyAudioFeaturesSensorEntityDescription) -> None: ...
+    @property
+    def native_value(self) -> float | str | None: ...

homeassistant-stubs/components/spotify/system_health.pyi

@@ -0,0 +1,6 @@
+from homeassistant.components import system_health as system_health
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from typing import Any
+
+def async_register(hass: HomeAssistant, register: system_health.SystemHealthRegistration) -> None: ...
+async def system_health_info(hass: HomeAssistant) -> dict[str, Any]: ...

homeassistant-stubs/components/spotify/util.pyi

@@ -0,0 +1,7 @@
+from .const import MEDIA_PLAYER_PREFIX as MEDIA_PLAYER_PREFIX
+from spotifyaio import Image as Image
+
+def is_spotify_media_type(media_content_type: str) -> bool: ...
+def resolve_spotify_media_type(media_content_type: str) -> str: ...
+def fetch_image_url(images: list[Image]) -> str | None: ...
+def spotify_uri_from_media_browser_url(media_content_id: str) -> str: ...

homeassistant-stubs/components/squeezebox/__init__.pyi

@@ -1,5 +1,5 @@
-from .const import CONF_HTTPS as CONF_HTTPS, DISCOVERY_TASK as DISCOVERY_TASK, DOMAIN as DOMAIN, MANUFACTURER as MANUFACTURER, SERVER_MODEL as SERVER_MODEL, STATUS_API_TIMEOUT as STATUS_API_TIMEOUT, STATUS_QUERY_LIBRARYNAME as STATUS_QUERY_LIBRARYNAME, STATUS_QUERY_MAC as STATUS_QUERY_MAC, STATUS_QUERY_UUID as STATUS_QUERY_UUID, STATUS_QUERY_VERSION as STATUS_QUERY_VERSION
-from .coordinator import LMSStatusDataUpdateCoordinator as LMSStatusDataUpdateCoordinator
+from .const import CONF_HTTPS as CONF_HTTPS, DISCOVERY_INTERVAL as DISCOVERY_INTERVAL, DISCOVERY_TASK as DISCOVERY_TASK, DOMAIN as DOMAIN, KNOWN_PLAYERS as KNOWN_PLAYERS, KNOWN_SERVERS as KNOWN_SERVERS, MANUFACTURER as MANUFACTURER, SERVER_MODEL as SERVER_MODEL, SIGNAL_PLAYER_DISCOVERED as SIGNAL_PLAYER_DISCOVERED, SIGNAL_PLAYER_REDISCOVERED as SIGNAL_PLAYER_REDISCOVERED, STATUS_API_TIMEOUT as STATUS_API_TIMEOUT, STATUS_QUERY_LIBRARYNAME as STATUS_QUERY_LIBRARYNAME, STATUS_QUERY_MAC as STATUS_QUERY_MAC, STATUS_QUERY_UUID as STATUS_QUERY_UUID, STATUS_QUERY_VERSION as STATUS_QUERY_VERSION
+from .coordinator import LMSStatusDataUpdateCoordinator as LMSStatusDataUpdateCoordinator, SqueezeBoxPlayerUpdateCoordinator as SqueezeBoxPlayerUpdateCoordinator
 from _typeshed import Incomplete
 from dataclasses import dataclass
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
@@ -8,7 +8,9 @@ from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.exceptions import ConfigEntryNotReady as ConfigEntryNotReady
 from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
 from homeassistant.helpers.device_registry import CONNECTION_NETWORK_MAC as CONNECTION_NETWORK_MAC, DeviceEntryType as DeviceEntryType, format_mac as format_mac
-from pysqueezebox import Server
+from homeassistant.helpers.dispatcher import async_dispatcher_send as async_dispatcher_send
+from homeassistant.helpers.event import async_call_later as async_call_later
+from pysqueezebox import Player as Player, Server
 
 _LOGGER: Incomplete
 PLATFORMS: Incomplete
@@ -18,6 +20,7 @@ class SqueezeboxData:
     coordinator: LMSStatusDataUpdateCoordinator
     server: Server
     def __init__(self, coordinator, server) -> None: ...
+type SqueezeboxConfigEntry = ConfigEntry[SqueezeboxData]
 
 async def async_setup_entry(hass: HomeAssistant, entry: SqueezeboxConfigEntry) -> bool: ...
 async def async_unload_entry(hass: HomeAssistant, entry: SqueezeboxConfigEntry) -> bool: ...

homeassistant-stubs/components/squeezebox/const.pyi

@@ -5,6 +5,7 @@ DISCOVERY_TASK: str
 DOMAIN: str
 DEFAULT_PORT: int
 KNOWN_PLAYERS: str
+KNOWN_SERVERS: str
 MANUFACTURER: str
 PLAYER_DISCOVERY_UNSUB: str
 SENSOR_UPDATE_INTERVAL: int
@@ -27,3 +28,7 @@ STATUS_QUERY_MAC: str
 STATUS_QUERY_UUID: str
 STATUS_QUERY_VERSION: str
 SQUEEZEBOX_SOURCE_STRINGS: Incomplete
+SIGNAL_PLAYER_DISCOVERED: str
+SIGNAL_PLAYER_REDISCOVERED: str
+DISCOVERY_INTERVAL: int
+PLAYER_UPDATE_INTERVAL: int

homeassistant-stubs/components/squeezebox/coordinator.pyi

@@ -1,8 +1,11 @@
-from .const import SENSOR_UPDATE_INTERVAL as SENSOR_UPDATE_INTERVAL, STATUS_API_TIMEOUT as STATUS_API_TIMEOUT, STATUS_SENSOR_LASTSCAN as STATUS_SENSOR_LASTSCAN, STATUS_SENSOR_NEEDSRESTART as STATUS_SENSOR_NEEDSRESTART, STATUS_SENSOR_RESCAN as STATUS_SENSOR_RESCAN
+from .const import PLAYER_UPDATE_INTERVAL as PLAYER_UPDATE_INTERVAL, SENSOR_UPDATE_INTERVAL as SENSOR_UPDATE_INTERVAL, SIGNAL_PLAYER_REDISCOVERED as SIGNAL_PLAYER_REDISCOVERED, STATUS_API_TIMEOUT as STATUS_API_TIMEOUT, STATUS_SENSOR_LASTSCAN as STATUS_SENSOR_LASTSCAN, STATUS_SENSOR_NEEDSRESTART as STATUS_SENSOR_NEEDSRESTART, STATUS_SENSOR_RESCAN as STATUS_SENSOR_RESCAN
 from _typeshed import Incomplete
-from homeassistant.core import HomeAssistant as HomeAssistant
+from collections.abc import Callable as Callable
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers.dispatcher import async_dispatcher_connect as async_dispatcher_connect
 from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
-from pysqueezebox import Server as Server
+from pysqueezebox import Player as Player, Server as Server
+from typing import Any
 
 _LOGGER: Incomplete
 
@@ -12,3 +15,12 @@ class LMSStatusDataUpdateCoordinator(DataUpdateCoordinator):
     def __init__(self, hass: HomeAssistant, lms: Server) -> None: ...
     async def _async_update_data(self) -> dict: ...
     def _prepare_status_data(self, data: dict) -> dict: ...
+
+class SqueezeBoxPlayerUpdateCoordinator(DataUpdateCoordinator[dict[str, Any]]):
+    player: Incomplete
+    available: bool
+    _remove_dispatcher: Incomplete
+    server_uuid: Incomplete
+    def __init__(self, hass: HomeAssistant, player: Player, server_uuid: str) -> None: ...
+    async def _async_update_data(self) -> dict[str, Any]: ...
+    def rediscovered(self, unique_id: str, connected: bool) -> None: ...

homeassistant-stubs/components/squeezebox/media_player.pyi

@@ -1,32 +1,30 @@
 from . import SqueezeboxConfigEntry as SqueezeboxConfigEntry
 from .browse_media import build_item_response as build_item_response, generate_playlist as generate_playlist, library_payload as library_payload, media_source_content_filter as media_source_content_filter
-from .const import DISCOVERY_TASK as DISCOVERY_TASK, DOMAIN as DOMAIN, KNOWN_PLAYERS as KNOWN_PLAYERS, SQUEEZEBOX_SOURCE_STRINGS as SQUEEZEBOX_SOURCE_STRINGS
+from .const import DISCOVERY_TASK as DISCOVERY_TASK, DOMAIN as DOMAIN, KNOWN_PLAYERS as KNOWN_PLAYERS, KNOWN_SERVERS as KNOWN_SERVERS, SIGNAL_PLAYER_DISCOVERED as SIGNAL_PLAYER_DISCOVERED, SQUEEZEBOX_SOURCE_STRINGS as SQUEEZEBOX_SOURCE_STRINGS
+from .coordinator import SqueezeBoxPlayerUpdateCoordinator as SqueezeBoxPlayerUpdateCoordinator
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from datetime import datetime
 from homeassistant.components import media_source as media_source
 from homeassistant.components.media_player import ATTR_MEDIA_ENQUEUE as ATTR_MEDIA_ENQUEUE, BrowseError as BrowseError, BrowseMedia as BrowseMedia, MediaPlayerEnqueue as MediaPlayerEnqueue, MediaPlayerEntity as MediaPlayerEntity, MediaPlayerEntityFeature as MediaPlayerEntityFeature, MediaPlayerState as MediaPlayerState, MediaType as MediaType, RepeatMode as RepeatMode, async_process_play_media_url as async_process_play_media_url
 from homeassistant.config_entries import SOURCE_INTEGRATION_DISCOVERY as SOURCE_INTEGRATION_DISCOVERY
-from homeassistant.const import ATTR_COMMAND as ATTR_COMMAND, CONF_HOST as CONF_HOST, CONF_PORT as CONF_PORT
+from homeassistant.const import ATTR_COMMAND as ATTR_COMMAND, CONF_HOST as CONF_HOST, CONF_PORT as CONF_PORT, Platform as Platform
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import ServiceValidationError as ServiceValidationError
 from homeassistant.helpers import discovery_flow as discovery_flow, entity_platform as entity_platform
 from homeassistant.helpers.device_registry import CONNECTION_NETWORK_MAC as CONNECTION_NETWORK_MAC, DeviceInfo as DeviceInfo, format_mac as format_mac
-from homeassistant.helpers.dispatcher import async_dispatcher_connect as async_dispatcher_connect, async_dispatcher_send as async_dispatcher_send
+from homeassistant.helpers.dispatcher import async_dispatcher_connect as async_dispatcher_connect
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
-from homeassistant.helpers.event import async_call_later as async_call_later
 from homeassistant.helpers.start import async_at_start as async_at_start
+from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
 from homeassistant.util.dt import utcnow as utcnow
-from pysqueezebox import Player as Player, Server as Server
+from pysqueezebox import Server as Server
 from typing import Any
 
 SERVICE_CALL_METHOD: str
 SERVICE_CALL_QUERY: str
 ATTR_QUERY_RESULT: str
-SIGNAL_PLAYER_REDISCOVERED: str
 _LOGGER: Incomplete
-DISCOVERY_INTERVAL: int
-KNOWN_SERVERS: str
 ATTR_PARAMETERS: str
 ATTR_OTHER_PLAYER: str
 ATTR_TO_PROPERTY: Incomplete
@@ -35,24 +33,25 @@ SQUEEZEBOX_MODE: Incomplete
 async def start_server_discovery(hass: HomeAssistant) -> None: ...
 async def async_setup_entry(hass: HomeAssistant, entry: SqueezeboxConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
-class SqueezeBoxEntity(MediaPlayerEntity):
+class SqueezeBoxMediaPlayerEntity(CoordinatorEntity[SqueezeBoxPlayerUpdateCoordinator], MediaPlayerEntity):
     _attr_supported_features: Incomplete
     _attr_has_entity_name: bool
     _attr_name: Incomplete
     _last_update: datetime | None
-    _attr_available: bool
     _player: Incomplete
     _query_result: Incomplete
     _remove_dispatcher: Incomplete
+    _previous_media_position: int
     _attr_unique_id: Incomplete
     _attr_device_info: Incomplete
-    def __init__(self, player: Player, server: Server) -> None: ...
+    def __init__(self, coordinator: SqueezeBoxPlayerUpdateCoordinator) -> None: ...
+    def _handle_coordinator_update(self) -> None: ...
+    @property
+    def available(self) -> bool: ...
     @property
     def extra_state_attributes(self) -> dict[str, Any]: ...
-    def rediscovered(self, unique_id: str, connected: bool) -> None: ...
     @property
     def state(self) -> MediaPlayerState | None: ...
-    async def async_update(self) -> None: ...
     async def async_will_remove_from_hass(self) -> None: ...
     @property
     def volume_level(self) -> float | None: ...