homeassistant-stubs 2025.2.4__py3-none-any.whl → 2025.3.0__py3-none-any.whl

homeassistant-stubs/components/heos/coordinator.pyi

@@ -7,7 +7,7 @@ from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, HassJob as HassJo
 from homeassistant.exceptions import ConfigEntryNotReady as ConfigEntryNotReady
 from homeassistant.helpers.event import async_call_later as async_call_later
 from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator
-from pyheos import HeosNowPlayingMedia as HeosNowPlayingMedia, MediaItem as MediaItem, PlayerUpdateResult as PlayerUpdateResult
+from pyheos import HeosNowPlayingMedia as HeosNowPlayingMedia, HeosPlayer as HeosPlayer, MediaItem as MediaItem, PlayerUpdateResult as PlayerUpdateResult
 from typing import Any
 
 _LOGGER: Incomplete
@@ -16,6 +16,7 @@ type HeosConfigEntry = ConfigEntry[HeosCoordinator]
 class HeosCoordinator(DataUpdateCoordinator[None]):
     host: str
     heos: Incomplete
+    _platform_callbacks: list[Callable[[Sequence[HeosPlayer]], None]]
     _update_sources_pending: bool
     _source_list: list[str]
     _favorites: dict[int, MediaItem]
@@ -28,6 +29,8 @@ class HeosCoordinator(DataUpdateCoordinator[None]):
     async def async_setup(self) -> None: ...
     async def async_shutdown(self) -> None: ...
     def async_add_listener(self, update_callback: CALLBACK_TYPE, context: Any = None) -> Callable[[], None]: ...
+    def async_add_platform_callback(self, add_entities_callback: Callable[[Sequence[HeosPlayer]], None]) -> None: ...
+    def _async_handle_player_update_result(self, update_result: PlayerUpdateResult) -> None: ...
     async def _async_on_auth_failure(self) -> None: ...
     async def _async_on_disconnected(self) -> None: ...
     async def _async_on_reconnected(self) -> None: ...

homeassistant-stubs/components/heos/media_player.pyi

@@ -1,14 +1,16 @@
+from .const import SERVICE_GROUP_VOLUME_DOWN as SERVICE_GROUP_VOLUME_DOWN, SERVICE_GROUP_VOLUME_SET as SERVICE_GROUP_VOLUME_SET, SERVICE_GROUP_VOLUME_UP as SERVICE_GROUP_VOLUME_UP
 from .coordinator import HeosConfigEntry as HeosConfigEntry, HeosCoordinator as HeosCoordinator
 from _typeshed import Incomplete
 from collections.abc import Awaitable, Callable, Coroutine
 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, 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.components.media_player import ATTR_MEDIA_ENQUEUE as ATTR_MEDIA_ENQUEUE, ATTR_MEDIA_VOLUME_LEVEL as ATTR_MEDIA_VOLUME_LEVEL, 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.const import Platform as Platform
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, ServiceValidationError as ServiceValidationError
+from homeassistant.helpers import entity_platform as entity_platform
 from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo
-from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
 from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
 from homeassistant.util.dt import utcnow as utcnow
 from pyheos import HeosPlayer as HeosPlayer
@@ -22,7 +24,7 @@ HA_HEOS_ENQUEUE_MAP: Incomplete
 HEOS_HA_REPEAT_TYPE_MAP: Incomplete
 HA_HEOS_REPEAT_TYPE_MAP: Incomplete
 
-async def async_setup_entry(hass: HomeAssistant, entry: HeosConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+async def async_setup_entry(hass: HomeAssistant, entry: HeosConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 type _FuncType[**_P] = Callable[_P, Awaitable[Any]]
 type _ReturnFuncType[**_P] = Callable[_P, Coroutine[Any, Any, None]]
 def catch_action_error[**_P](action: str) -> Callable[[_FuncType[_P]], _ReturnFuncType[_P]]: ...
@@ -62,6 +64,9 @@ class HeosMediaPlayer(CoordinatorEntity[HeosCoordinator], MediaPlayerEntity):
     async def async_set_repeat(self, repeat: RepeatMode) -> None: ...
     async def async_set_shuffle(self, shuffle: bool) -> None: ...
     async def async_set_volume_level(self, volume: float) -> None: ...
+    async def async_set_group_volume_level(self, volume_level: float) -> None: ...
+    async def async_group_volume_down(self) -> None: ...
+    async def async_group_volume_up(self) -> None: ...
     async def async_join_players(self, group_members: list[str]) -> None: ...
     async def async_unjoin_player(self) -> None: ...
     @property

homeassistant-stubs/components/here_travel_time/coordinator.pyi

@@ -2,6 +2,7 @@ from .const import DEFAULT_SCAN_INTERVAL as DEFAULT_SCAN_INTERVAL, DOMAIN as DOM
 from .model import HERETravelTimeConfig as HERETravelTimeConfig, HERETravelTimeData as HERETravelTimeData
 from _typeshed import Incomplete
 from datetime import datetime, time
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import UnitOfLength as UnitOfLength
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.location import find_coordinates as find_coordinates
@@ -13,17 +14,19 @@ BACKOFF_MULTIPLIER: float
 _LOGGER: Incomplete
 
 class HERERoutingDataUpdateCoordinator(DataUpdateCoordinator[HERETravelTimeData]):
+    config_entry: ConfigEntry
     _api: Incomplete
     config: Incomplete
-    def __init__(self, hass: HomeAssistant, api_key: str, config: HERETravelTimeConfig) -> None: ...
+    def __init__(self, hass: HomeAssistant, config_entry: ConfigEntry, api_key: str, config: HERETravelTimeConfig) -> None: ...
     update_interval: Incomplete
     async def _async_update_data(self) -> HERETravelTimeData: ...
     def _parse_routing_response(self, response: dict[str, Any]) -> HERETravelTimeData: ...
 
 class HERETransitDataUpdateCoordinator(DataUpdateCoordinator[HERETravelTimeData | None]):
+    config_entry: ConfigEntry
     _api: Incomplete
     config: Incomplete
-    def __init__(self, hass: HomeAssistant, api_key: str, config: HERETravelTimeConfig) -> None: ...
+    def __init__(self, hass: HomeAssistant, config_entry: ConfigEntry, api_key: str, config: HERETravelTimeConfig) -> None: ...
     update_interval: Incomplete
     async def _async_update_data(self) -> HERETravelTimeData | None: ...
     def _parse_transit_response(self, response: dict[str, Any]) -> HERETravelTimeData: ...

homeassistant-stubs/components/here_travel_time/sensor.pyi

@@ -7,14 +7,14 @@ from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import ATTR_ATTRIBUTION as ATTR_ATTRIBUTION, ATTR_LATITUDE as ATTR_LATITUDE, ATTR_LONGITUDE as ATTR_LONGITUDE, CONF_MODE as CONF_MODE, CONF_NAME as CONF_NAME, UnitOfLength as UnitOfLength, UnitOfTime as UnitOfTime
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.device_registry import DeviceEntryType as DeviceEntryType, DeviceInfo as DeviceInfo
-from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
 from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
 from typing import Any
 
 SCAN_INTERVAL: Incomplete
 
 def sensor_descriptions(travel_mode: str) -> tuple[SensorEntityDescription, ...]: ...
-async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
 class HERETravelTimeSensor(CoordinatorEntity[HERERoutingDataUpdateCoordinator | HERETransitDataUpdateCoordinator], RestoreSensor):
     _attr_has_entity_name: bool

homeassistant-stubs/components/history_stats/sensor.pyi

@@ -11,7 +11,7 @@ from homeassistant.const import CONF_ENTITY_ID as CONF_ENTITY_ID, CONF_NAME as C
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import PlatformNotReady as PlatformNotReady
 from homeassistant.helpers.device import async_device_info_to_link_from_entity as async_device_info_to_link_from_entity
-from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback, AddEntitiesCallback as AddEntitiesCallback
 from homeassistant.helpers.reload import async_setup_reload_service as async_setup_reload_service
 from homeassistant.helpers.template import Template as Template
 from homeassistant.helpers.typing import ConfigType as ConfigType, DiscoveryInfoType as DiscoveryInfoType
@@ -26,7 +26,7 @@ def exactly_two_period_keys[_T: dict[str, Any]](conf: _T) -> _T: ...
 PLATFORM_SCHEMA: Incomplete
 
 async def async_setup_platform(hass: HomeAssistant, config: ConfigType, async_add_entities: AddEntitiesCallback, discovery_info: DiscoveryInfoType | None = None) -> None: ...
-async def async_setup_entry(hass: HomeAssistant, entry: HistoryStatsConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+async def async_setup_entry(hass: HomeAssistant, entry: HistoryStatsConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
 class HistoryStatsSensorBase(CoordinatorEntity[HistoryStatsUpdateCoordinator], SensorEntity, metaclass=abc.ABCMeta):
     _attr_icon = ICON

homeassistant-stubs/components/holiday/calendar.pyi

@@ -7,11 +7,11 @@ from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import CONF_COUNTRY as CONF_COUNTRY
 from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.device_registry import DeviceEntryType as DeviceEntryType, DeviceInfo as DeviceInfo
-from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
 from homeassistant.helpers.event import async_track_point_in_utc_time as async_track_point_in_utc_time
 
 def _get_obj_holidays_and_language(country: str, province: str | None, language: str, selected_categories: list[str] | None) -> tuple[HolidayBase, str]: ...
-async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
 class HolidayCalendarEntity(CalendarEntity):
     _attr_has_entity_name: bool

homeassistant-stubs/components/home_connect/__init__.pyi

@@ -0,0 +1,32 @@
+from .api import AsyncConfigEntryAuth as AsyncConfigEntryAuth
+from .const import AFFECTS_TO_ACTIVE_PROGRAM as AFFECTS_TO_ACTIVE_PROGRAM, AFFECTS_TO_SELECTED_PROGRAM as AFFECTS_TO_SELECTED_PROGRAM, ATTR_AFFECTS_TO as ATTR_AFFECTS_TO, ATTR_KEY as ATTR_KEY, ATTR_PROGRAM as ATTR_PROGRAM, ATTR_UNIT as ATTR_UNIT, ATTR_VALUE as ATTR_VALUE, DOMAIN as DOMAIN, OLD_NEW_UNIQUE_ID_SUFFIX_MAP as OLD_NEW_UNIQUE_ID_SUFFIX_MAP, PROGRAM_ENUM_OPTIONS as PROGRAM_ENUM_OPTIONS, SERVICE_OPTION_ACTIVE as SERVICE_OPTION_ACTIVE, SERVICE_OPTION_SELECTED as SERVICE_OPTION_SELECTED, SERVICE_PAUSE_PROGRAM as SERVICE_PAUSE_PROGRAM, SERVICE_RESUME_PROGRAM as SERVICE_RESUME_PROGRAM, SERVICE_SELECT_PROGRAM as SERVICE_SELECT_PROGRAM, SERVICE_SETTING as SERVICE_SETTING, SERVICE_SET_PROGRAM_AND_OPTIONS as SERVICE_SET_PROGRAM_AND_OPTIONS, SERVICE_START_PROGRAM as SERVICE_START_PROGRAM, SVE_TRANSLATION_PLACEHOLDER_KEY as SVE_TRANSLATION_PLACEHOLDER_KEY, SVE_TRANSLATION_PLACEHOLDER_PROGRAM as SVE_TRANSLATION_PLACEHOLDER_PROGRAM, SVE_TRANSLATION_PLACEHOLDER_VALUE as SVE_TRANSLATION_PLACEHOLDER_VALUE, TRANSLATION_KEYS_PROGRAMS_MAP as TRANSLATION_KEYS_PROGRAMS_MAP
+from .coordinator import HomeConnectConfigEntry as HomeConnectConfigEntry, HomeConnectCoordinator as HomeConnectCoordinator
+from .utils import bsh_key_to_translation_key as bsh_key_to_translation_key, get_dict_from_home_connect_error as get_dict_from_home_connect_error
+from _typeshed import Incomplete
+from aiohomeconnect.client import Client as HomeConnectClient
+from homeassistant.const import ATTR_DEVICE_ID as ATTR_DEVICE_ID, Platform as Platform
+from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, callback as callback
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, ServiceValidationError as ServiceValidationError
+from homeassistant.helpers import config_entry_oauth2_flow as config_entry_oauth2_flow
+from homeassistant.helpers.entity_registry import RegistryEntry as RegistryEntry, async_migrate_entries as async_migrate_entries
+from homeassistant.helpers.issue_registry import IssueSeverity as IssueSeverity, async_create_issue as async_create_issue, async_delete_issue as async_delete_issue
+from homeassistant.helpers.typing import ConfigType as ConfigType
+
+_LOGGER: Incomplete
+CONFIG_SCHEMA: Incomplete
+PROGRAM_OPTIONS: Incomplete
+SERVICE_SETTING_SCHEMA: Incomplete
+SERVICE_OPTION_SCHEMA: Incomplete
+SERVICE_PROGRAM_SCHEMA: Incomplete
+
+def _require_program_or_at_least_one_option(data: dict) -> dict: ...
+
+SERVICE_PROGRAM_AND_OPTIONS_SCHEMA: Incomplete
+SERVICE_COMMAND_SCHEMA: Incomplete
+PLATFORMS: Incomplete
+
+async def _get_client_and_ha_id(hass: HomeAssistant, device_id: str) -> tuple[HomeConnectClient, str]: ...
+async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
+async def async_setup_entry(hass: HomeAssistant, entry: HomeConnectConfigEntry) -> bool: ...
+async def async_unload_entry(hass: HomeAssistant, entry: HomeConnectConfigEntry) -> bool: ...
+async def async_migrate_entry(hass: HomeAssistant, entry: HomeConnectConfigEntry) -> bool: ...

homeassistant-stubs/components/home_connect/api.pyi

@@ -0,0 +1,11 @@
+from _typeshed import Incomplete
+from aiohomeconnect.client import AbstractAuth
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers import config_entry_oauth2_flow as config_entry_oauth2_flow
+from homeassistant.helpers.httpx_client import get_async_client as get_async_client
+
+class AsyncConfigEntryAuth(AbstractAuth):
+    hass: Incomplete
+    session: Incomplete
+    def __init__(self, hass: HomeAssistant, oauth_session: config_entry_oauth2_flow.OAuth2Session) -> None: ...
+    async def async_get_access_token(self) -> str: ...

homeassistant-stubs/components/home_connect/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/home_connect/binary_sensor.pyi

@@ -0,0 +1,46 @@
+from .common import setup_home_connect_entry as setup_home_connect_entry
+from .const import BSH_DOOR_STATE_CLOSED as BSH_DOOR_STATE_CLOSED, BSH_DOOR_STATE_LOCKED as BSH_DOOR_STATE_LOCKED, BSH_DOOR_STATE_OPEN as BSH_DOOR_STATE_OPEN, DOMAIN as DOMAIN, REFRIGERATION_STATUS_DOOR_CLOSED as REFRIGERATION_STATUS_DOOR_CLOSED, REFRIGERATION_STATUS_DOOR_OPEN as REFRIGERATION_STATUS_DOOR_OPEN
+from .coordinator import HomeConnectApplianceData as HomeConnectApplianceData, HomeConnectConfigEntry as HomeConnectConfigEntry, HomeConnectCoordinator as HomeConnectCoordinator
+from .entity import HomeConnectEntity as HomeConnectEntity
+from _typeshed import Incomplete
+from dataclasses import dataclass
+from homeassistant.components.automation import automations_with_entity as automations_with_entity
+from homeassistant.components.binary_sensor import BinarySensorDeviceClass as BinarySensorDeviceClass, BinarySensorEntity as BinarySensorEntity, BinarySensorEntityDescription as BinarySensorEntityDescription
+from homeassistant.components.script import scripts_with_entity as scripts_with_entity
+from homeassistant.const import EntityCategory as EntityCategory
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from homeassistant.helpers.issue_registry import IssueSeverity as IssueSeverity, async_create_issue as async_create_issue, async_delete_issue as async_delete_issue
+
+PARALLEL_UPDATES: int
+REFRIGERATION_DOOR_BOOLEAN_MAP: Incomplete
+
+@dataclass(frozen=True, kw_only=True)
+class HomeConnectBinarySensorEntityDescription(BinarySensorEntityDescription):
+    boolean_map: dict[str, bool] | None = ...
+
+BINARY_SENSORS: Incomplete
+CONNECTED_BINARY_ENTITY_DESCRIPTION: Incomplete
+
+def _get_entities_for_appliance(entry: HomeConnectConfigEntry, appliance: HomeConnectApplianceData) -> list[HomeConnectEntity]: ...
+async def async_setup_entry(hass: HomeAssistant, entry: HomeConnectConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class HomeConnectBinarySensor(HomeConnectEntity, BinarySensorEntity):
+    entity_description: HomeConnectBinarySensorEntityDescription
+    _attr_is_on: Incomplete
+    def update_native_value(self) -> None: ...
+
+class HomeConnectConnectivityBinarySensor(HomeConnectEntity, BinarySensorEntity):
+    _attr_entity_category: Incomplete
+    _attr_is_on: Incomplete
+    def update_native_value(self) -> None: ...
+    @property
+    def available(self) -> bool: ...
+
+class HomeConnectDoorBinarySensor(HomeConnectBinarySensor):
+    _attr_has_entity_name: bool
+    _attr_unique_id: Incomplete
+    _attr_name: Incomplete
+    def __init__(self, coordinator: HomeConnectCoordinator, appliance: HomeConnectApplianceData) -> None: ...
+    async def async_added_to_hass(self) -> None: ...
+    async def async_will_remove_from_hass(self) -> None: ...

homeassistant-stubs/components/home_connect/button.pyi

@@ -0,0 +1,36 @@
+from .common import setup_home_connect_entry as setup_home_connect_entry
+from .const import APPLIANCES_WITH_PROGRAMS as APPLIANCES_WITH_PROGRAMS, DOMAIN as DOMAIN
+from .coordinator import HomeConnectApplianceData as HomeConnectApplianceData, HomeConnectConfigEntry as HomeConnectConfigEntry, HomeConnectCoordinator as HomeConnectCoordinator
+from .entity import HomeConnectEntity as HomeConnectEntity
+from .utils import get_dict_from_home_connect_error as get_dict_from_home_connect_error
+from _typeshed import Incomplete
+from aiohomeconnect.model import CommandKey
+from homeassistant.components.button import ButtonEntity as ButtonEntity, ButtonEntityDescription as ButtonEntityDescription
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+
+PARALLEL_UPDATES: int
+
+class HomeConnectCommandButtonEntityDescription(ButtonEntityDescription):
+    key: CommandKey
+
+COMMAND_BUTTONS: Incomplete
+
+def _get_entities_for_appliance(entry: HomeConnectConfigEntry, appliance: HomeConnectApplianceData) -> list[HomeConnectEntity]: ...
+async def async_setup_entry(hass: HomeAssistant, entry: HomeConnectConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class HomeConnectButtonEntity(HomeConnectEntity, ButtonEntity):
+    entity_description: ButtonEntityDescription
+    appliance: Incomplete
+    unique_id: Incomplete
+    def __init__(self, coordinator: HomeConnectCoordinator, appliance: HomeConnectApplianceData, desc: ButtonEntityDescription) -> None: ...
+    def update_native_value(self) -> None: ...
+
+class HomeConnectCommandButtonEntity(HomeConnectButtonEntity):
+    entity_description: HomeConnectCommandButtonEntityDescription
+    async def async_press(self) -> None: ...
+
+class HomeConnectStopProgramButtonEntity(HomeConnectButtonEntity):
+    def __init__(self, coordinator: HomeConnectCoordinator, appliance: HomeConnectApplianceData) -> None: ...
+    async def async_press(self) -> None: ...

homeassistant-stubs/components/home_connect/common.pyi

@@ -0,0 +1,9 @@
+from .coordinator import HomeConnectApplianceData as HomeConnectApplianceData, HomeConnectConfigEntry as HomeConnectConfigEntry
+from .entity import HomeConnectEntity as HomeConnectEntity, HomeConnectOptionEntity as HomeConnectOptionEntity
+from collections.abc import Callable as Callable
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+
+def _create_option_entities(entry: HomeConnectConfigEntry, appliance: HomeConnectApplianceData, known_entity_unique_ids: dict[str, str], get_option_entities_for_appliance: Callable[[HomeConnectConfigEntry, HomeConnectApplianceData], list[HomeConnectOptionEntity]], async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+def _handle_paired_or_connected_appliance(entry: HomeConnectConfigEntry, known_entity_unique_ids: dict[str, str], get_entities_for_appliance: Callable[[HomeConnectConfigEntry, HomeConnectApplianceData], list[HomeConnectEntity]], get_option_entities_for_appliance: Callable[[HomeConnectConfigEntry, HomeConnectApplianceData], list[HomeConnectOptionEntity]] | None, changed_options_listener_remove_callbacks: dict[str, list[Callable[[], None]]], async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+def _handle_depaired_appliance(entry: HomeConnectConfigEntry, known_entity_unique_ids: dict[str, str], changed_options_listener_remove_callbacks: dict[str, list[Callable[[], None]]]) -> None: ...
+def setup_home_connect_entry(entry: HomeConnectConfigEntry, get_entities_for_appliance: Callable[[HomeConnectConfigEntry, HomeConnectApplianceData], list[HomeConnectEntity]], async_add_entities: AddConfigEntryEntitiesCallback, get_option_entities_for_appliance: Callable[[HomeConnectConfigEntry, HomeConnectApplianceData], list[HomeConnectOptionEntity]] | None = None) -> None: ...

homeassistant-stubs/components/home_connect/config_flow.pyi

@@ -0,0 +1,15 @@
+import logging
+from .const import DOMAIN as DOMAIN
+from collections.abc import Mapping
+from homeassistant.config_entries import ConfigFlowResult as ConfigFlowResult, SOURCE_REAUTH as SOURCE_REAUTH
+from homeassistant.helpers import config_entry_oauth2_flow as config_entry_oauth2_flow
+from typing import Any
+
+class OAuth2FlowHandler(config_entry_oauth2_flow.AbstractOAuth2FlowHandler, domain=DOMAIN):
+    DOMAIN = DOMAIN
+    MINOR_VERSION: int
+    @property
+    def logger(self) -> logging.Logger: ...
+    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_oauth_create_entry(self, data: dict) -> ConfigFlowResult: ...

homeassistant-stubs/components/home_connect/const.pyi

@@ -0,0 +1,62 @@
+from .utils import bsh_key_to_translation_key as bsh_key_to_translation_key
+from _typeshed import Incomplete
+from homeassistant.const import UnitOfTemperature as UnitOfTemperature, UnitOfTime as UnitOfTime, UnitOfVolume as UnitOfVolume
+
+DOMAIN: str
+APPLIANCES_WITH_PROGRAMS: Incomplete
+UNIT_MAP: Incomplete
+BSH_POWER_ON: str
+BSH_POWER_OFF: str
+BSH_POWER_STANDBY: str
+BSH_EVENT_PRESENT_STATE_PRESENT: str
+BSH_EVENT_PRESENT_STATE_CONFIRMED: str
+BSH_EVENT_PRESENT_STATE_OFF: str
+BSH_OPERATION_STATE_RUN: str
+BSH_OPERATION_STATE_PAUSE: str
+BSH_OPERATION_STATE_FINISHED: str
+REFRIGERATION_STATUS_DOOR_CLOSED: str
+REFRIGERATION_STATUS_DOOR_OPEN: str
+BSH_AMBIENT_LIGHT_COLOR_CUSTOM_COLOR: str
+BSH_DOOR_STATE_CLOSED: str
+BSH_DOOR_STATE_LOCKED: str
+BSH_DOOR_STATE_OPEN: str
+SERVICE_OPTION_ACTIVE: str
+SERVICE_OPTION_SELECTED: str
+SERVICE_PAUSE_PROGRAM: str
+SERVICE_RESUME_PROGRAM: str
+SERVICE_SELECT_PROGRAM: str
+SERVICE_SET_PROGRAM_AND_OPTIONS: str
+SERVICE_SETTING: str
+SERVICE_START_PROGRAM: str
+ATTR_AFFECTS_TO: str
+ATTR_KEY: str
+ATTR_PROGRAM: str
+ATTR_UNIT: str
+ATTR_VALUE: str
+AFFECTS_TO_ACTIVE_PROGRAM: str
+AFFECTS_TO_SELECTED_PROGRAM: str
+SVE_TRANSLATION_KEY_SET_SETTING: str
+SVE_TRANSLATION_PLACEHOLDER_APPLIANCE_NAME: str
+SVE_TRANSLATION_PLACEHOLDER_ENTITY_ID: str
+SVE_TRANSLATION_PLACEHOLDER_PROGRAM: str
+SVE_TRANSLATION_PLACEHOLDER_KEY: str
+SVE_TRANSLATION_PLACEHOLDER_VALUE: str
+TRANSLATION_KEYS_PROGRAMS_MAP: Incomplete
+PROGRAMS_TRANSLATION_KEYS_MAP: Incomplete
+AVAILABLE_MAPS_ENUM: Incomplete
+CLEANING_MODE_OPTIONS: Incomplete
+BEAN_AMOUNT_OPTIONS: Incomplete
+COFFEE_TEMPERATURE_OPTIONS: Incomplete
+BEAN_CONTAINER_OPTIONS: Incomplete
+FLOW_RATE_OPTIONS: Incomplete
+COFFEE_MILK_RATIO_OPTIONS: Incomplete
+HOT_WATER_TEMPERATURE_OPTIONS: Incomplete
+DRYING_TARGET_OPTIONS: Incomplete
+VENTING_LEVEL_OPTIONS: Incomplete
+INTENSIVE_LEVEL_OPTIONS: Incomplete
+WARMING_LEVEL_OPTIONS: Incomplete
+TEMPERATURE_OPTIONS: Incomplete
+SPIN_SPEED_OPTIONS: Incomplete
+VARIO_PERFECT_OPTIONS: Incomplete
+PROGRAM_ENUM_OPTIONS: Incomplete
+OLD_NEW_UNIQUE_ID_SUFFIX_MAP: Incomplete

homeassistant-stubs/components/home_connect/coordinator.pyi

@@ -0,0 +1,53 @@
+from .const import APPLIANCES_WITH_PROGRAMS as APPLIANCES_WITH_PROGRAMS, DOMAIN as DOMAIN
+from .utils import get_dict_from_home_connect_error as get_dict_from_home_connect_error
+from _typeshed import Incomplete
+from aiohomeconnect.client import Client as HomeConnectClient
+from aiohomeconnect.model import CommandKey as CommandKey, Event, EventKey, EventMessage as EventMessage, GetSetting, HomeAppliance as HomeAppliance, OptionKey as OptionKey, ProgramKey, SettingKey, Status, StatusKey
+from aiohomeconnect.model.program import EnumerateProgram as EnumerateProgram, ProgramDefinitionOption as ProgramDefinitionOption
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed
+from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
+from propcache.api import cached_property
+from typing import Any
+
+_LOGGER: Incomplete
+type HomeConnectConfigEntry = ConfigEntry[HomeConnectCoordinator]
+
+@dataclass(frozen=True, kw_only=True)
+class HomeConnectApplianceData:
+    commands: set[CommandKey]
+    events: dict[EventKey, Event]
+    info: HomeAppliance
+    options: dict[OptionKey, ProgramDefinitionOption]
+    programs: list[EnumerateProgram]
+    settings: dict[SettingKey, GetSetting]
+    status: dict[StatusKey, Status]
+    def update(self, other: HomeConnectApplianceData) -> None: ...
+
+class HomeConnectCoordinator(DataUpdateCoordinator[dict[str, HomeConnectApplianceData]]):
+    config_entry: HomeConnectConfigEntry
+    client: Incomplete
+    _special_listeners: dict[CALLBACK_TYPE, tuple[CALLBACK_TYPE, tuple[EventKey, ...]]]
+    device_registry: Incomplete
+    data: Incomplete
+    def __init__(self, hass: HomeAssistant, config_entry: HomeConnectConfigEntry, client: HomeConnectClient) -> None: ...
+    @cached_property
+    def context_listeners(self) -> dict[tuple[str, EventKey], list[CALLBACK_TYPE]]: ...
+    @callback
+    def async_add_listener(self, update_callback: CALLBACK_TYPE, context: Any = None) -> Callable[[], None]: ...
+    @callback
+    def async_add_special_listener(self, update_callback: CALLBACK_TYPE, context: tuple[EventKey, ...]) -> Callable[[], None]: ...
+    @callback
+    def start_event_listener(self) -> None: ...
+    async def _event_listener(self) -> None: ...
+    @callback
+    def _call_event_listener(self, event_message: EventMessage) -> None: ...
+    @callback
+    def _call_all_event_listeners_for_appliance(self, ha_id: str) -> None: ...
+    async def _async_update_data(self) -> dict[str, HomeConnectApplianceData]: ...
+    async def _get_appliance_data(self, appliance: HomeAppliance, appliance_data_to_update: HomeConnectApplianceData | None = None) -> HomeConnectApplianceData: ...
+    async def get_options_definitions(self, ha_id: str, program_key: ProgramKey) -> dict[OptionKey, ProgramDefinitionOption]: ...
+    async def update_options(self, ha_id: str, event_key: EventKey, program_key: ProgramKey) -> None: ...

homeassistant-stubs/components/home_connect/diagnostics.pyi

@@ -0,0 +1,10 @@
+from .const import DOMAIN as DOMAIN
+from .coordinator import HomeConnectApplianceData as HomeConnectApplianceData, HomeConnectConfigEntry as HomeConnectConfigEntry
+from aiohomeconnect.client import Client as HomeConnectClient
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.device_registry import DeviceEntry as DeviceEntry
+from typing import Any
+
+async def _generate_appliance_diagnostics(client: HomeConnectClient, appliance: HomeConnectApplianceData) -> dict[str, Any]: ...
+async def async_get_config_entry_diagnostics(hass: HomeAssistant, entry: HomeConnectConfigEntry) -> dict[str, Any]: ...
+async def async_get_device_diagnostics(hass: HomeAssistant, entry: HomeConnectConfigEntry, device: DeviceEntry) -> dict[str, Any]: ...

homeassistant-stubs/components/home_connect/entity.pyi

@@ -0,0 +1,41 @@
+import abc
+from .const import DOMAIN as DOMAIN
+from .coordinator import HomeConnectApplianceData as HomeConnectApplianceData, HomeConnectCoordinator as HomeConnectCoordinator
+from .utils import get_dict_from_home_connect_error as get_dict_from_home_connect_error
+from _typeshed import Incomplete
+from abc import abstractmethod
+from aiohomeconnect.model import OptionKey
+from homeassistant.const import STATE_UNAVAILABLE as STATE_UNAVAILABLE
+from homeassistant.core import callback as callback
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo
+from homeassistant.helpers.entity import EntityDescription as EntityDescription
+from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
+
+_LOGGER: Incomplete
+
+class HomeConnectEntity(CoordinatorEntity[HomeConnectCoordinator], metaclass=abc.ABCMeta):
+    _attr_should_poll: bool
+    _attr_has_entity_name: bool
+    appliance: Incomplete
+    entity_description: Incomplete
+    _attr_unique_id: Incomplete
+    _attr_device_info: Incomplete
+    def __init__(self, coordinator: HomeConnectCoordinator, appliance: HomeConnectApplianceData, desc: EntityDescription) -> None: ...
+    @abstractmethod
+    def update_native_value(self) -> None: ...
+    @callback
+    def _handle_coordinator_update(self) -> None: ...
+    @property
+    def bsh_key(self) -> str: ...
+    @property
+    def available(self) -> bool: ...
+
+class HomeConnectOptionEntity(HomeConnectEntity, metaclass=abc.ABCMeta):
+    @property
+    def available(self) -> bool: ...
+    @property
+    def option_value(self) -> str | int | float | bool | None: ...
+    async def async_set_option(self, value: str | float | bool) -> None: ...
+    @property
+    def bsh_key(self) -> OptionKey: ...

homeassistant-stubs/components/home_connect/light.pyi

@@ -0,0 +1,48 @@
+from .common import setup_home_connect_entry as setup_home_connect_entry
+from .const import BSH_AMBIENT_LIGHT_COLOR_CUSTOM_COLOR as BSH_AMBIENT_LIGHT_COLOR_CUSTOM_COLOR, DOMAIN as DOMAIN, SVE_TRANSLATION_PLACEHOLDER_ENTITY_ID as SVE_TRANSLATION_PLACEHOLDER_ENTITY_ID
+from .coordinator import HomeConnectApplianceData as HomeConnectApplianceData, HomeConnectConfigEntry as HomeConnectConfigEntry, HomeConnectCoordinator as HomeConnectCoordinator
+from .entity import HomeConnectEntity as HomeConnectEntity
+from .utils import get_dict_from_home_connect_error as get_dict_from_home_connect_error
+from _typeshed import Incomplete
+from aiohomeconnect.model import SettingKey
+from dataclasses import dataclass
+from homeassistant.components.light import ATTR_BRIGHTNESS as ATTR_BRIGHTNESS, ATTR_HS_COLOR as ATTR_HS_COLOR, ATTR_RGB_COLOR as ATTR_RGB_COLOR, ColorMode as ColorMode, LightEntity as LightEntity, LightEntityDescription as LightEntityDescription
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from typing import Any
+
+_LOGGER: Incomplete
+PARALLEL_UPDATES: int
+
+@dataclass(frozen=True, kw_only=True)
+class HomeConnectLightEntityDescription(LightEntityDescription):
+    brightness_key: SettingKey | None = ...
+    color_key: SettingKey | None = ...
+    enable_custom_color_value_key: str | None = ...
+    custom_color_key: SettingKey | None = ...
+    brightness_scale: tuple[float, float] = ...
+
+LIGHTS: tuple[HomeConnectLightEntityDescription, ...]
+
+def _get_entities_for_appliance(entry: HomeConnectConfigEntry, appliance: HomeConnectApplianceData) -> list[HomeConnectEntity]: ...
+async def async_setup_entry(hass: HomeAssistant, entry: HomeConnectConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class HomeConnectLight(HomeConnectEntity, LightEntity):
+    entity_description: LightEntityDescription
+    _brightness_key: Incomplete
+    _custom_color_key: Incomplete
+    _color_key: Incomplete
+    _enable_custom_color_value_key: Incomplete
+    _brightness_scale: Incomplete
+    _attr_color_mode: Incomplete
+    _attr_supported_color_modes: Incomplete
+    def __init__(self, coordinator: HomeConnectCoordinator, appliance: HomeConnectApplianceData, desc: HomeConnectLightEntityDescription) -> None: ...
+    async def async_turn_on(self, **kwargs: Any) -> None: ...
+    async def async_turn_off(self, **kwargs: Any) -> None: ...
+    async def async_added_to_hass(self) -> None: ...
+    _attr_is_on: Incomplete
+    _attr_brightness: Incomplete
+    _attr_rgb_color: Incomplete
+    _attr_hs_color: Incomplete
+    def update_native_value(self) -> None: ...

homeassistant-stubs/components/home_connect/number.pyi

@@ -0,0 +1,41 @@
+from .common import setup_home_connect_entry as setup_home_connect_entry
+from .const import DOMAIN as DOMAIN, SVE_TRANSLATION_KEY_SET_SETTING as SVE_TRANSLATION_KEY_SET_SETTING, SVE_TRANSLATION_PLACEHOLDER_ENTITY_ID as SVE_TRANSLATION_PLACEHOLDER_ENTITY_ID, SVE_TRANSLATION_PLACEHOLDER_KEY as SVE_TRANSLATION_PLACEHOLDER_KEY, SVE_TRANSLATION_PLACEHOLDER_VALUE as SVE_TRANSLATION_PLACEHOLDER_VALUE, UNIT_MAP as UNIT_MAP
+from .coordinator import HomeConnectApplianceData as HomeConnectApplianceData, HomeConnectConfigEntry as HomeConnectConfigEntry
+from .entity import HomeConnectEntity as HomeConnectEntity, HomeConnectOptionEntity as HomeConnectOptionEntity
+from .utils import get_dict_from_home_connect_error as get_dict_from_home_connect_error
+from _typeshed import Incomplete
+from aiohomeconnect.model import GetSetting as GetSetting
+from homeassistant.components.number import NumberDeviceClass as NumberDeviceClass, NumberEntity as NumberEntity, NumberEntityDescription as NumberEntityDescription
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+
+_LOGGER: Incomplete
+PARALLEL_UPDATES: int
+NUMBERS: Incomplete
+NUMBER_OPTIONS: Incomplete
+
+def _get_entities_for_appliance(entry: HomeConnectConfigEntry, appliance: HomeConnectApplianceData) -> list[HomeConnectEntity]: ...
+def _get_option_entities_for_appliance(entry: HomeConnectConfigEntry, appliance: HomeConnectApplianceData) -> list[HomeConnectOptionEntity]: ...
+async def async_setup_entry(hass: HomeAssistant, entry: HomeConnectConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class HomeConnectNumberEntity(HomeConnectEntity, NumberEntity):
+    async def async_set_native_value(self, value: float) -> None: ...
+    async def async_fetch_constraints(self) -> None: ...
+    _attr_native_max_value: Incomplete
+    _attr_native_min_value: Incomplete
+    _attr_native_step: Incomplete
+    def set_constraints(self, setting: GetSetting) -> None: ...
+    _attr_native_value: Incomplete
+    def update_native_value(self) -> None: ...
+    _attr_native_unit_of_measurement: Incomplete
+    async def async_added_to_hass(self) -> None: ...
+
+class HomeConnectOptionNumberEntity(HomeConnectOptionEntity, NumberEntity):
+    async def async_set_native_value(self, value: float) -> None: ...
+    _attr_native_value: Incomplete
+    _attr_native_unit_of_measurement: Incomplete
+    _attr_native_min_value: Incomplete
+    _attr_native_max_value: Incomplete
+    _attr_native_step: Incomplete
+    def update_native_value(self) -> None: ...