homeassistant-stubs 2025.1.4__py3-none-any.whl → 2025.2.0b0__py3-none-any.whl

homeassistant-stubs/components/tplink/__init__.pyi

@@ -1,12 +1,10 @@
 from .const import CONF_AES_KEYS as CONF_AES_KEYS, CONF_CAMERA_CREDENTIALS as CONF_CAMERA_CREDENTIALS, CONF_CONFIG_ENTRY_MINOR_VERSION as CONF_CONFIG_ENTRY_MINOR_VERSION, CONF_CONNECTION_PARAMETERS as CONF_CONNECTION_PARAMETERS, CONF_CREDENTIALS_HASH as CONF_CREDENTIALS_HASH, CONF_DEVICE_CONFIG as CONF_DEVICE_CONFIG, CONF_LIVE_VIEW as CONF_LIVE_VIEW, CONF_USES_HTTP as CONF_USES_HTTP, CONNECT_TIMEOUT as CONNECT_TIMEOUT, DISCOVERY_TIMEOUT as DISCOVERY_TIMEOUT, DOMAIN as DOMAIN, PLATFORMS as PLATFORMS
-from .coordinator import TPLinkDataUpdateCoordinator as TPLinkDataUpdateCoordinator
-from .models import TPLinkData as TPLinkData
+from .coordinator import TPLinkConfigEntry as TPLinkConfigEntry, TPLinkData as TPLinkData, TPLinkDataUpdateCoordinator as TPLinkDataUpdateCoordinator
 from _typeshed import Incomplete
 from aiohttp import ClientSession as ClientSession
 from collections.abc import Iterable
 from homeassistant import config_entries as config_entries
 from homeassistant.components import network as network
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import CONF_ALIAS as CONF_ALIAS, CONF_AUTHENTICATION as CONF_AUTHENTICATION, CONF_DEVICE as CONF_DEVICE, CONF_HOST as CONF_HOST, CONF_MAC as CONF_MAC, CONF_MODEL as CONF_MODEL, CONF_PASSWORD as CONF_PASSWORD, CONF_PORT as CONF_PORT, CONF_USERNAME as CONF_USERNAME
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed, ConfigEntryNotReady as ConfigEntryNotReady
@@ -16,7 +14,6 @@ from homeassistant.helpers.event import async_track_time_interval as async_track
 from homeassistant.helpers.typing import ConfigType as ConfigType
 from kasa import Credentials, Device
 
-type TPLinkConfigEntry = ConfigEntry[TPLinkData]
 DISCOVERY_INTERVAL: Incomplete
 CONFIG_SCHEMA: Incomplete
 _LOGGER: Incomplete
@@ -29,10 +26,10 @@ async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
 async def async_setup_entry(hass: HomeAssistant, entry: TPLinkConfigEntry) -> bool: ...
 async def async_unload_entry(hass: HomeAssistant, entry: TPLinkConfigEntry) -> bool: ...
 def legacy_device_id(device: Device) -> str: ...
-def get_device_name(device: Device, parent: Device | None = None) -> str: ...
+def get_device_name(device: Device, parent: Device | None = None) -> str | None: ...
 async def get_credentials(hass: HomeAssistant) -> Credentials | None: ...
 async def set_credentials(hass: HomeAssistant, username: str, password: str) -> None: ...
 def mac_alias(mac: str) -> str: ...
 def _mac_connection_or_none(device: dr.DeviceEntry) -> str | None: ...
 def _device_id_is_mac_or_none(mac: str, device_ids: Iterable[str]) -> str | None: ...
-async def async_migrate_entry(hass: HomeAssistant, config_entry: ConfigEntry) -> bool: ...
+async def async_migrate_entry(hass: HomeAssistant, config_entry: TPLinkConfigEntry) -> bool: ...

homeassistant-stubs/components/tplink/binary_sensor.pyi

@@ -10,6 +10,7 @@ from typing import Final
 @dataclass(frozen=True, kw_only=True)
 class TPLinkBinarySensorEntityDescription(BinarySensorEntityDescription, TPLinkFeatureEntityDescription): ...
 
+PARALLEL_UPDATES: int
 BINARY_SENSOR_DESCRIPTIONS: Final[Incomplete]
 BINARYSENSOR_DESCRIPTIONS_MAP: Incomplete
 

homeassistant-stubs/components/tplink/button.pyi

@@ -1,5 +1,5 @@
 from . import TPLinkConfigEntry as TPLinkConfigEntry
-from .deprecate import DeprecatedInfo as DeprecatedInfo, async_cleanup_deprecated as async_cleanup_deprecated
+from .deprecate import DeprecatedInfo as DeprecatedInfo
 from .entity import CoordinatedTPLinkFeatureEntity as CoordinatedTPLinkFeatureEntity, TPLinkFeatureEntityDescription as TPLinkFeatureEntityDescription
 from _typeshed import Incomplete
 from dataclasses import dataclass
@@ -11,6 +11,7 @@ from typing import Final
 @dataclass(frozen=True, kw_only=True)
 class TPLinkButtonEntityDescription(ButtonEntityDescription, TPLinkFeatureEntityDescription): ...
 
+PARALLEL_UPDATES: int
 BUTTON_DESCRIPTIONS: Final[Incomplete]
 BUTTON_DESCRIPTIONS_MAP: Incomplete
 

homeassistant-stubs/components/tplink/camera.pyi

@@ -1,7 +1,7 @@
-from . import TPLinkConfigEntry as TPLinkConfigEntry, legacy_device_id as legacy_device_id
+from . import TPLinkConfigEntry as TPLinkConfigEntry
 from .const import CONF_CAMERA_CREDENTIALS as CONF_CAMERA_CREDENTIALS
 from .coordinator import TPLinkDataUpdateCoordinator as TPLinkDataUpdateCoordinator
-from .entity import CoordinatedTPLinkEntity as CoordinatedTPLinkEntity, TPLinkModuleEntityDescription as TPLinkModuleEntityDescription
+from .entity import CoordinatedTPLinkModuleEntity as CoordinatedTPLinkModuleEntity, TPLinkModuleEntityDescription as TPLinkModuleEntityDescription
 from _typeshed import Incomplete
 from aiohttp import web as web
 from dataclasses import dataclass
@@ -11,10 +11,10 @@ from homeassistant.config_entries import ConfigFlowContext as ConfigFlowContext
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.aiohttp_client import async_aiohttp_proxy_stream as async_aiohttp_proxy_stream
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
-from kasa import Credentials as Credentials, Device as Device
-from kasa.smartcam.modules import Camera as CameraModule
+from kasa import Device as Device
 
 _LOGGER: Incomplete
+PARALLEL_UPDATES: int
 
 @dataclass(frozen=True, kw_only=True)
 class TPLinkCameraEntityDescription(CameraEntityDescription, TPLinkModuleEntityDescription): ...
@@ -23,21 +23,21 @@ CAMERA_DESCRIPTIONS: tuple[TPLinkCameraEntityDescription, ...]
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: TPLinkConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
-class TPLinkCameraEntity(CoordinatedTPLinkEntity, Camera):
+class TPLinkCameraEntity(CoordinatedTPLinkModuleEntity, Camera):
     IMAGE_INTERVAL: Incomplete
     _attr_supported_features: Incomplete
     entity_description: TPLinkCameraEntityDescription
+    _ffmpeg_manager: ffmpeg.FFmpegManager
     _camera_module: Incomplete
+    _camera_credentials: Incomplete
     _video_url: Incomplete
     _image: bytes | None
-    _ffmpeg_manager: Incomplete
     _image_lock: Incomplete
     _last_update: float
-    _camera_credentials: Incomplete
     _can_stream: bool
     _http_mpeg_stream_running: bool
-    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator, description: TPLinkCameraEntityDescription, *, camera_module: CameraModule, parent: Device | None = None, ffmpeg_manager: ffmpeg.FFmpegManager, camera_credentials: Credentials | None) -> None: ...
-    def _get_unique_id(self) -> str: ...
+    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator, description: TPLinkCameraEntityDescription, *, parent: Device | None = None) -> None: ...
+    async def async_added_to_hass(self) -> None: ...
     _attr_is_on: Incomplete
     @callback
     def _async_update_attrs(self) -> bool: ...

homeassistant-stubs/components/tplink/climate.pyi

@@ -1,34 +1,41 @@
-from . import TPLinkConfigEntry as TPLinkConfigEntry
-from .const import UNIT_MAPPING as UNIT_MAPPING
+from . import TPLinkConfigEntry as TPLinkConfigEntry, legacy_device_id as legacy_device_id
+from .const import DOMAIN as DOMAIN, UNIT_MAPPING as UNIT_MAPPING
 from .coordinator import TPLinkDataUpdateCoordinator as TPLinkDataUpdateCoordinator
-from .entity import CoordinatedTPLinkEntity as CoordinatedTPLinkEntity, async_refresh_after as async_refresh_after
+from .entity import CoordinatedTPLinkModuleEntity as CoordinatedTPLinkModuleEntity, TPLinkModuleEntityDescription as TPLinkModuleEntityDescription, async_refresh_after as async_refresh_after
 from _typeshed import Incomplete
-from homeassistant.components.climate import ATTR_TEMPERATURE as ATTR_TEMPERATURE, ClimateEntity as ClimateEntity, ClimateEntityFeature as ClimateEntityFeature, HVACAction as HVACAction, HVACMode as HVACMode
-from homeassistant.const import PRECISION_TENTHS as PRECISION_TENTHS
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.climate import ATTR_TEMPERATURE as ATTR_TEMPERATURE, ClimateEntity as ClimateEntity, ClimateEntityDescription as ClimateEntityDescription, ClimateEntityFeature as ClimateEntityFeature, HVACAction as HVACAction, HVACMode as HVACMode
+from homeassistant.const import PRECISION_TENTHS as PRECISION_TENTHS, UnitOfTemperature as UnitOfTemperature
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import ServiceValidationError as ServiceValidationError
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from kasa import Device as Device
 from typing import Any
 
+PARALLEL_UPDATES: int
 STATE_TO_ACTION: Incomplete
 _LOGGER: Incomplete
 
+@dataclass(frozen=True, kw_only=True)
+class TPLinkClimateEntityDescription(ClimateEntityDescription, TPLinkModuleEntityDescription):
+    unique_id_fn: Callable[[Device, TPLinkModuleEntityDescription], str] = ...
+
+CLIMATE_DESCRIPTIONS: tuple[TPLinkClimateEntityDescription, ...]
+
 async def async_setup_entry(hass: HomeAssistant, config_entry: TPLinkConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
-class TPLinkClimateEntity(CoordinatedTPLinkEntity, ClimateEntity):
+class TPLinkClimateEntity(CoordinatedTPLinkModuleEntity, ClimateEntity):
     _attr_name: Incomplete
     _attr_supported_features: Incomplete
     _attr_hvac_modes: Incomplete
     _attr_precision = PRECISION_TENTHS
-    _state_feature: Incomplete
-    _mode_feature: Incomplete
-    _temp_feature: Incomplete
-    _target_feature: Incomplete
+    entity_description: TPLinkClimateEntityDescription
+    _thermostat_module: Incomplete
     _attr_min_temp: Incomplete
     _attr_max_temp: Incomplete
     _attr_temperature_unit: Incomplete
-    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator, *, parent: Device) -> None: ...
+    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator, description: TPLinkClimateEntityDescription, *, parent: Device) -> None: ...
     @async_refresh_after
     async def async_set_temperature(self, **kwargs: Any) -> None: ...
     @async_refresh_after
@@ -43,4 +50,3 @@ class TPLinkClimateEntity(CoordinatedTPLinkEntity, ClimateEntity):
     _attr_hvac_action: Incomplete
     @callback
     def _async_update_attrs(self) -> bool: ...
-    def _get_unique_id(self) -> str: ...

homeassistant-stubs/components/tplink/config_flow.pyi

@@ -2,10 +2,11 @@ from . import async_discover_devices as async_discover_devices, create_async_tpl
 from .const import CONF_AES_KEYS as CONF_AES_KEYS, CONF_CAMERA_CREDENTIALS as CONF_CAMERA_CREDENTIALS, CONF_CONFIG_ENTRY_MINOR_VERSION as CONF_CONFIG_ENTRY_MINOR_VERSION, CONF_CONNECTION_PARAMETERS as CONF_CONNECTION_PARAMETERS, CONF_CREDENTIALS_HASH as CONF_CREDENTIALS_HASH, CONF_LIVE_VIEW as CONF_LIVE_VIEW, CONF_USES_HTTP as CONF_USES_HTTP, CONNECT_TIMEOUT as CONNECT_TIMEOUT, DOMAIN as DOMAIN
 from _typeshed import Incomplete
 from collections.abc import Mapping
-from homeassistant.components import dhcp as dhcp, ffmpeg as ffmpeg, stream as stream
+from homeassistant.components import ffmpeg as ffmpeg, stream as stream
 from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigEntryState as ConfigEntryState, ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, SOURCE_REAUTH as SOURCE_REAUTH, SOURCE_RECONFIGURE as SOURCE_RECONFIGURE
 from homeassistant.const import CONF_ALIAS as CONF_ALIAS, CONF_DEVICE as CONF_DEVICE, CONF_HOST as CONF_HOST, CONF_MAC as CONF_MAC, CONF_MODEL as CONF_MODEL, CONF_NAME as CONF_NAME, CONF_PASSWORD as CONF_PASSWORD, CONF_PORT as CONF_PORT, CONF_USERNAME as CONF_USERNAME
 from homeassistant.core import callback as callback
+from homeassistant.helpers.service_info.dhcp import DhcpServiceInfo as DhcpServiceInfo
 from homeassistant.helpers.typing import DiscoveryInfoType as DiscoveryInfoType
 from kasa import Credentials, Device
 from typing import Any, Self
@@ -23,7 +24,7 @@ class TPLinkConfigFlow(ConfigFlow, domain=DOMAIN):
     _discovered_devices: dict[str, Device]
     _discovered_device: Device | None
     def __init__(self) -> None: ...
-    async def async_step_dhcp(self, discovery_info: dhcp.DhcpServiceInfo) -> ConfigFlowResult: ...
+    async def async_step_dhcp(self, discovery_info: DhcpServiceInfo) -> ConfigFlowResult: ...
     async def async_step_integration_discovery(self, discovery_info: DiscoveryInfoType) -> ConfigFlowResult: ...
     @callback
     def _get_config_updates(self, entry: ConfigEntry, host: str, device: Device | None) -> dict | None: ...

homeassistant-stubs/components/tplink/const.pyi

@@ -1,5 +1,5 @@
 from _typeshed import Incomplete
-from homeassistant.const import Platform as Platform, UnitOfTemperature as UnitOfTemperature
+from homeassistant.const import Platform as Platform, UnitOfArea as UnitOfArea, UnitOfTemperature as UnitOfTemperature
 from typing import Final
 
 DOMAIN: str

homeassistant-stubs/components/tplink/coordinator.pyi

@@ -1,17 +1,33 @@
+from .const import DOMAIN as DOMAIN
 from _typeshed import Incomplete
+from dataclasses import dataclass
 from datetime import timedelta
-from homeassistant import config_entries as config_entries
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed
 from homeassistant.helpers.debounce import Debouncer as Debouncer
 from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
-from kasa import Device as Device
+from kasa import Credentials as Credentials, Device as Device
 
 _LOGGER: Incomplete
+
+@dataclass(slots=True)
+class TPLinkData:
+    parent_coordinator: TPLinkDataUpdateCoordinator
+    camera_credentials: Credentials | None
+    live_view: bool | None
+type TPLinkConfigEntry = ConfigEntry[TPLinkData]
+
 REQUEST_REFRESH_DELAY: float
 
 class TPLinkDataUpdateCoordinator(DataUpdateCoordinator[None]):
-    config_entry: config_entries.ConfigEntry
+    config_entry: TPLinkConfigEntry
     device: Incomplete
-    def __init__(self, hass: HomeAssistant, device: Device, update_interval: timedelta) -> None: ...
+    _update_children: Incomplete
+    _previous_child_device_ids: Incomplete
+    removed_child_device_ids: set[str]
+    _child_coordinators: dict[str, TPLinkDataUpdateCoordinator]
+    def __init__(self, hass: HomeAssistant, device: Device, update_interval: timedelta, config_entry: TPLinkConfigEntry) -> None: ...
     async def _async_update_data(self) -> None: ...
+    async def _process_child_devices(self) -> None: ...
+    def get_child_coordinator(self, child: Device) -> TPLinkDataUpdateCoordinator: ...

homeassistant-stubs/components/tplink/deprecate.pyi

@@ -1,11 +1,13 @@
+from . import legacy_device_id as legacy_device_id
 from .const import DOMAIN as DOMAIN
-from .entity import CoordinatedTPLinkFeatureEntity as CoordinatedTPLinkFeatureEntity, TPLinkFeatureEntityDescription as TPLinkFeatureEntityDescription
+from .entity import CoordinatedTPLinkEntity as CoordinatedTPLinkEntity, TPLinkEntityDescription as TPLinkEntityDescription
 from collections.abc import Sequence
 from dataclasses import dataclass
 from homeassistant.components.automation import automations_with_entity as automations_with_entity
 from homeassistant.components.script import scripts_with_entity as scripts_with_entity
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.issue_registry import IssueSeverity as IssueSeverity, async_create_issue as async_create_issue
+from kasa import Device as Device
 
 @dataclass(slots=True)
 class DeprecatedInfo:
@@ -13,5 +15,5 @@ class DeprecatedInfo:
     new_platform: str
     breaks_in_ha_version: str
 
-def async_check_create_deprecated(hass: HomeAssistant, unique_id: str, entity_description: TPLinkFeatureEntityDescription) -> bool: ...
-def async_cleanup_deprecated(hass: HomeAssistant, platform: str, entry_id: str, entities: Sequence[CoordinatedTPLinkFeatureEntity]) -> None: ...
+def async_check_create_deprecated(hass: HomeAssistant, unique_id: str, entity_description: TPLinkEntityDescription) -> bool: ...
+def async_process_deprecated(hass: HomeAssistant, platform_domain: str, entry_id: str, entities: Sequence[CoordinatedTPLinkEntity], device: Device) -> None: ...

homeassistant-stubs/components/tplink/entity.pyi

@@ -1,11 +1,11 @@
 import abc
 from . import get_device_name as get_device_name, legacy_device_id as legacy_device_id
 from .const import ATTR_CURRENT_A as ATTR_CURRENT_A, ATTR_CURRENT_POWER_W as ATTR_CURRENT_POWER_W, ATTR_TODAY_ENERGY_KWH as ATTR_TODAY_ENERGY_KWH, ATTR_TOTAL_ENERGY_KWH as ATTR_TOTAL_ENERGY_KWH, DOMAIN as DOMAIN, PRIMARY_STATE_ID as PRIMARY_STATE_ID
-from .coordinator import TPLinkDataUpdateCoordinator as TPLinkDataUpdateCoordinator
-from .deprecate import DeprecatedInfo as DeprecatedInfo, async_check_create_deprecated as async_check_create_deprecated
+from .coordinator import TPLinkConfigEntry as TPLinkConfigEntry, TPLinkDataUpdateCoordinator as TPLinkDataUpdateCoordinator
+from .deprecate import DeprecatedInfo as DeprecatedInfo, async_check_create_deprecated as async_check_create_deprecated, async_process_deprecated as async_process_deprecated
 from _typeshed import Incomplete
 from abc import ABC, abstractmethod
-from collections.abc import Awaitable, Callable as Callable, Coroutine, Mapping
+from collections.abc import Awaitable, Callable as Callable, Coroutine, Iterable, Mapping
 from dataclasses import dataclass
 from homeassistant.const import EntityCategory as EntityCategory
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
@@ -25,25 +25,32 @@ EXCLUDED_FEATURES: Incomplete
 LEGACY_KEY_MAPPING: Incomplete
 
 @dataclass(frozen=True, kw_only=True)
-class TPLinkFeatureEntityDescription(EntityDescription):
+class TPLinkEntityDescription(EntityDescription):
     deprecated_info: DeprecatedInfo | None = ...
     available_fn: Callable[[Device], bool] = ...
 
 @dataclass(frozen=True, kw_only=True)
-class TPLinkModuleEntityDescription(EntityDescription):
-    deprecated_info: DeprecatedInfo | None = ...
-    available_fn: Callable[[Device], bool] = ...
+class TPLinkFeatureEntityDescription(TPLinkEntityDescription): ...
+
+@dataclass(frozen=True, kw_only=True)
+class TPLinkModuleEntityDescription(TPLinkEntityDescription):
+    exists_fn: Callable[[Device, TPLinkConfigEntry], bool]
+    unique_id_fn: Callable[[Device, TPLinkModuleEntityDescription], str] = ...
+    entity_name_fn: Callable[[Device, TPLinkModuleEntityDescription], str | None] | None = ...
 
 def async_refresh_after[_T: CoordinatedTPLinkEntity, **_P](func: Callable[Concatenate[_T, _P], Awaitable[None]]) -> Callable[Concatenate[_T, _P], Coroutine[Any, Any, None]]: ...
 
 class CoordinatedTPLinkEntity(CoordinatorEntity[TPLinkDataUpdateCoordinator], ABC, metaclass=abc.ABCMeta):
     _attr_has_entity_name: bool
     _device: Device
+    entity_description: TPLinkEntityDescription
+    _parent: Incomplete
     _feature: Incomplete
     _attr_device_info: Incomplete
     _attr_unique_id: Incomplete
-    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator, *, feature: Feature | None = None, parent: Device | None = None) -> None: ...
+    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator, description: TPLinkEntityDescription, *, feature: Feature | None = None, parent: Device | None = None) -> None: ...
     def _get_unique_id(self) -> str: ...
+    async def async_added_to_hass(self) -> None: ...
     @abstractmethod
     @callback
     def _async_update_attrs(self) -> bool: ...
@@ -58,7 +65,7 @@ class CoordinatedTPLinkEntity(CoordinatorEntity[TPLinkDataUpdateCoordinator], AB
 class CoordinatedTPLinkFeatureEntity(CoordinatedTPLinkEntity, ABC, metaclass=abc.ABCMeta):
     entity_description: TPLinkFeatureEntityDescription
     _feature: Feature
-    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator, *, feature: Feature, description: TPLinkFeatureEntityDescription, parent: Device | None = None) -> None: ...
+    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator, description: TPLinkFeatureEntityDescription, *, feature: Feature, parent: Device | None = None) -> None: ...
     def _get_unique_id(self) -> str: ...
     @staticmethod
     def _get_feature_unique_id(device: Device, entity_description: TPLinkFeatureEntityDescription) -> str: ...
@@ -67,6 +74,18 @@ class CoordinatedTPLinkFeatureEntity(CoordinatedTPLinkEntity, ABC, metaclass=abc
     @classmethod
     def _description_for_feature[_D: EntityDescription](cls, feature: Feature, descriptions: Mapping[str, _D], *, device: Device, parent: Device | None = None) -> _D | None: ...
     @classmethod
-    def _entities_for_device[_E: CoordinatedTPLinkFeatureEntity, _D: TPLinkFeatureEntityDescription](cls, hass: HomeAssistant, device: Device, coordinator: TPLinkDataUpdateCoordinator, *, feature_type: Feature.Type, entity_class: type[_E], descriptions: Mapping[str, _D], parent: Device | None = None) -> list[_E]: ...
+    def _entities_for_device[_E: CoordinatedTPLinkFeatureEntity, _D: TPLinkFeatureEntityDescription](cls, hass: HomeAssistant, device: Device, coordinator: TPLinkDataUpdateCoordinator, *, feature_type: Feature.Type, entity_class: type[_E], descriptions: Mapping[str, _D], platform_domain: str, parent: Device | None = None) -> list[_E]: ...
     @classmethod
-    def entities_for_device_and_its_children[_E: CoordinatedTPLinkFeatureEntity, _D: TPLinkFeatureEntityDescription](cls, hass: HomeAssistant, device: Device, coordinator: TPLinkDataUpdateCoordinator, *, feature_type: Feature.Type, entity_class: type[_E], descriptions: Mapping[str, _D], child_coordinators: list[TPLinkDataUpdateCoordinator] | None = None) -> list[_E]: ...
+    def entities_for_device_and_its_children[_E: CoordinatedTPLinkFeatureEntity, _D: TPLinkFeatureEntityDescription](cls, hass: HomeAssistant, device: Device, coordinator: TPLinkDataUpdateCoordinator, *, feature_type: Feature.Type, entity_class: type[_E], descriptions: Mapping[str, _D], platform_domain: str, known_child_device_ids: set[str], first_check: bool) -> list[_E]: ...
+
+class CoordinatedTPLinkModuleEntity(CoordinatedTPLinkEntity, ABC, metaclass=abc.ABCMeta):
+    entity_description: TPLinkModuleEntityDescription
+    _attr_name: Incomplete
+    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator, description: TPLinkModuleEntityDescription, *, parent: Device | None = None) -> None: ...
+    def _get_unique_id(self) -> str: ...
+    @classmethod
+    def _entities_for_device[_E: CoordinatedTPLinkModuleEntity, _D: TPLinkModuleEntityDescription](cls, hass: HomeAssistant, device: Device, coordinator: TPLinkDataUpdateCoordinator, *, entity_class: type[_E], descriptions: Iterable[_D], platform_domain: str, parent: Device | None = None) -> list[_E]: ...
+    @classmethod
+    def entities_for_device_and_its_children[_E: CoordinatedTPLinkModuleEntity, _D: TPLinkModuleEntityDescription](cls, hass: HomeAssistant, device: Device, coordinator: TPLinkDataUpdateCoordinator, *, entity_class: type[_E], descriptions: Iterable[_D], platform_domain: str, known_child_device_ids: set[str], first_check: bool) -> list[_E]: ...
+
+def _get_new_children(device: Device, coordinator: TPLinkDataUpdateCoordinator, known_child_device_ids: set[str], entity_class_name: str) -> list[Device]: ...

homeassistant-stubs/components/tplink/fan.pyi

@@ -1,28 +1,36 @@
-from . import TPLinkConfigEntry as TPLinkConfigEntry
+from . import TPLinkConfigEntry as TPLinkConfigEntry, legacy_device_id as legacy_device_id
 from .coordinator import TPLinkDataUpdateCoordinator as TPLinkDataUpdateCoordinator
-from .entity import CoordinatedTPLinkEntity as CoordinatedTPLinkEntity, async_refresh_after as async_refresh_after
+from .entity import CoordinatedTPLinkModuleEntity as CoordinatedTPLinkModuleEntity, TPLinkModuleEntityDescription as TPLinkModuleEntityDescription, async_refresh_after as async_refresh_after
 from _typeshed import Incomplete
-from homeassistant.components.fan import FanEntity as FanEntity, FanEntityFeature as FanEntityFeature
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.fan import FanEntity as FanEntity, FanEntityDescription as FanEntityDescription, FanEntityFeature as FanEntityFeature
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from homeassistant.util.percentage import percentage_to_ranged_value as percentage_to_ranged_value, ranged_value_to_percentage as ranged_value_to_percentage
 from homeassistant.util.scaling import int_states_in_range as int_states_in_range
 from kasa import Device as Device
-from kasa.interfaces import Fan as FanInterface
 from typing import Any
 
+PARALLEL_UPDATES: int
 _LOGGER: Incomplete
 
+@dataclass(frozen=True, kw_only=True)
+class TPLinkFanEntityDescription(FanEntityDescription, TPLinkModuleEntityDescription):
+    unique_id_fn: Callable[[Device, TPLinkModuleEntityDescription], str] = ...
+
+FAN_DESCRIPTIONS: tuple[TPLinkFanEntityDescription, ...]
+
 async def async_setup_entry(hass: HomeAssistant, config_entry: TPLinkConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
 SPEED_RANGE: Incomplete
 
-class TPLinkFanEntity(CoordinatedTPLinkEntity, FanEntity):
+class TPLinkFanEntity(CoordinatedTPLinkModuleEntity, FanEntity):
     _attr_speed_count: Incomplete
     _attr_supported_features: Incomplete
+    entity_description: TPLinkFanEntityDescription
     fan_module: Incomplete
-    _attr_name: Incomplete
-    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator, fan_module: FanInterface, parent: Device | None = None) -> None: ...
+    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator, description: TPLinkFanEntityDescription, *, parent: Device | None = None) -> None: ...
     @async_refresh_after
     async def async_turn_on(self, percentage: int | None = None, preset_mode: str | None = None, **kwargs: Any) -> None: ...
     @async_refresh_after

homeassistant-stubs/components/tplink/light.pyi

@@ -1,17 +1,19 @@
 from . import TPLinkConfigEntry as TPLinkConfigEntry, legacy_device_id as legacy_device_id
+from .const import DOMAIN as DOMAIN
 from .coordinator import TPLinkDataUpdateCoordinator as TPLinkDataUpdateCoordinator
-from .entity import CoordinatedTPLinkEntity as CoordinatedTPLinkEntity, async_refresh_after as async_refresh_after
+from .entity import CoordinatedTPLinkModuleEntity as CoordinatedTPLinkModuleEntity, TPLinkModuleEntityDescription as TPLinkModuleEntityDescription, async_refresh_after as async_refresh_after
 from _typeshed import Incomplete
 from collections.abc import Sequence
-from homeassistant.components.light import ATTR_BRIGHTNESS as ATTR_BRIGHTNESS, ATTR_COLOR_TEMP_KELVIN as ATTR_COLOR_TEMP_KELVIN, ATTR_EFFECT as ATTR_EFFECT, ATTR_HS_COLOR as ATTR_HS_COLOR, ATTR_TRANSITION as ATTR_TRANSITION, ColorMode as ColorMode, EFFECT_OFF as EFFECT_OFF, LightEntity as LightEntity, LightEntityFeature as LightEntityFeature, filter_supported_color_modes as filter_supported_color_modes
+from dataclasses import dataclass
+from homeassistant.components.light import ATTR_BRIGHTNESS as ATTR_BRIGHTNESS, ATTR_COLOR_TEMP_KELVIN as ATTR_COLOR_TEMP_KELVIN, ATTR_EFFECT as ATTR_EFFECT, ATTR_HS_COLOR as ATTR_HS_COLOR, ATTR_TRANSITION as ATTR_TRANSITION, ColorMode as ColorMode, EFFECT_OFF as EFFECT_OFF, LightEntity as LightEntity, LightEntityDescription as LightEntityDescription, LightEntityFeature as LightEntityFeature, filter_supported_color_modes as filter_supported_color_modes
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
-from homeassistant.helpers import entity_platform as entity_platform
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from homeassistant.helpers.typing import VolDictType as VolDictType
 from kasa import Device as Device
-from kasa.interfaces import Light as Light, LightEffect
 from typing import Any
 
+PARALLEL_UPDATES: int
 _LOGGER: Incomplete
 SERVICE_RANDOM_EFFECT: str
 SERVICE_SEQUENCE_EFFECT: str
@@ -26,19 +28,26 @@ RANDOM_EFFECT_DICT: VolDictType
 
 @callback
 def _async_build_base_effect(brightness: int, duration: int, transition: int, segments: list[int]) -> dict[str, Any]: ...
+def _get_backwards_compatible_light_unique_id(device: Device, entity_description: TPLinkModuleEntityDescription) -> str: ...
+
+@dataclass(frozen=True, kw_only=True)
+class TPLinkLightEntityDescription(LightEntityDescription, TPLinkModuleEntityDescription):
+    unique_id_fn = _get_backwards_compatible_light_unique_id
+
+LIGHT_DESCRIPTIONS: tuple[TPLinkLightEntityDescription, ...]
+LIGHT_EFFECT_DESCRIPTIONS: tuple[TPLinkLightEntityDescription, ...]
+
 async def async_setup_entry(hass: HomeAssistant, config_entry: TPLinkConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
-class TPLinkLightEntity(CoordinatedTPLinkEntity, LightEntity):
+class TPLinkLightEntity(CoordinatedTPLinkModuleEntity, LightEntity):
     _attr_supported_features: Incomplete
     _fixed_color_mode: ColorMode | None
-    _parent: Incomplete
+    entity_description: TPLinkLightEntityDescription
     _light_module: Incomplete
-    _attr_name: Incomplete
     _attr_min_color_temp_kelvin: Incomplete
     _attr_max_color_temp_kelvin: Incomplete
     _attr_supported_color_modes: Incomplete
-    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator, *, light_module: Light, parent: Device | None = None) -> None: ...
-    def _get_unique_id(self) -> str: ...
+    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator, description: TPLinkLightEntityDescription, *, parent: Device | None = None) -> None: ...
     @callback
     def _async_extract_brightness_transition(self, **kwargs: Any) -> tuple[int | None, int | None]: ...
     async def _async_set_hsv(self, hs_color: tuple[int, int], brightness: int | None, transition: int | None) -> None: ...
@@ -58,9 +67,11 @@ class TPLinkLightEntity(CoordinatedTPLinkEntity, LightEntity):
     def _async_update_attrs(self) -> bool: ...
 
 class TPLinkLightEffectEntity(TPLinkLightEntity):
-    _effect_module: Incomplete
-    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator, *, light_module: Light, effect_module: LightEffect) -> None: ...
     _attr_supported_features: Incomplete
+    _effect_module: Incomplete
+    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator, description: TPLinkLightEntityDescription, *, parent: Device | None = None) -> None: ...
+    async def async_added_to_hass(self) -> None: ...
+    def _register_effects_services(self) -> None: ...
     _attr_effect: Incomplete
     _attr_color_mode: Incomplete
     _attr_effect_list: Incomplete

homeassistant-stubs/components/tplink/number.pyi

@@ -13,6 +13,7 @@ _LOGGER: Incomplete
 @dataclass(frozen=True, kw_only=True)
 class TPLinkNumberEntityDescription(NumberEntityDescription, TPLinkFeatureEntityDescription): ...
 
+PARALLEL_UPDATES: int
 NUMBER_DESCRIPTIONS: Final[Incomplete]
 NUMBER_DESCRIPTIONS_MAP: Incomplete
 

homeassistant-stubs/components/tplink/select.pyi

@@ -11,6 +11,7 @@ from typing import Final
 @dataclass(frozen=True, kw_only=True)
 class TPLinkSelectEntityDescription(SelectEntityDescription, TPLinkFeatureEntityDescription): ...
 
+PARALLEL_UPDATES: int
 SELECT_DESCRIPTIONS: Final[Incomplete]
 SELECT_DESCRIPTIONS_MAP: Incomplete
 

homeassistant-stubs/components/tplink/sensor.pyi

@@ -1,16 +1,21 @@
 from . import TPLinkConfigEntry as TPLinkConfigEntry
 from .const import UNIT_MAPPING as UNIT_MAPPING
-from .deprecate import async_cleanup_deprecated as async_cleanup_deprecated
 from .entity import CoordinatedTPLinkFeatureEntity as CoordinatedTPLinkFeatureEntity, TPLinkFeatureEntityDescription as TPLinkFeatureEntityDescription
 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, SensorStateClass as SensorStateClass
+from homeassistant.const import UnitOfTime as UnitOfTime
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from typing import Any
 
 @dataclass(frozen=True, kw_only=True)
-class TPLinkSensorEntityDescription(SensorEntityDescription, TPLinkFeatureEntityDescription): ...
+class TPLinkSensorEntityDescription(SensorEntityDescription, TPLinkFeatureEntityDescription):
+    convert_fn: Callable[[Any], Any] | None = ...
 
+PARALLEL_UPDATES: int
+_TOTAL_SECONDS_METHOD_CALLER: Incomplete
 SENSOR_DESCRIPTIONS: tuple[TPLinkSensorEntityDescription, ...]
 SENSOR_DESCRIPTIONS_MAP: Incomplete
 

homeassistant-stubs/components/tplink/siren.pyi

@@ -1,25 +1,40 @@
-from . import TPLinkConfigEntry as TPLinkConfigEntry
+from . import TPLinkConfigEntry as TPLinkConfigEntry, legacy_device_id as legacy_device_id
+from .const import DOMAIN as DOMAIN
 from .coordinator import TPLinkDataUpdateCoordinator as TPLinkDataUpdateCoordinator
-from .entity import CoordinatedTPLinkEntity as CoordinatedTPLinkEntity, async_refresh_after as async_refresh_after
+from .entity import CoordinatedTPLinkModuleEntity as CoordinatedTPLinkModuleEntity, TPLinkModuleEntityDescription as TPLinkModuleEntityDescription, async_refresh_after as async_refresh_after
 from _typeshed import Incomplete
-from homeassistant.components.siren import SirenEntity as SirenEntity, SirenEntityFeature as SirenEntityFeature
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.siren import ATTR_DURATION as ATTR_DURATION, ATTR_TONE as ATTR_TONE, ATTR_VOLUME_LEVEL as ATTR_VOLUME_LEVEL, SirenEntity as SirenEntity, SirenEntityDescription as SirenEntityDescription, SirenEntityFeature as SirenEntityFeature, SirenTurnOnServiceParameters as SirenTurnOnServiceParameters
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.exceptions import ServiceValidationError as ServiceValidationError
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from kasa import Device as Device
-from kasa.smart.modules.alarm import Alarm as Alarm
 from typing import Any
 
+PARALLEL_UPDATES: int
+
+@dataclass(frozen=True, kw_only=True)
+class TPLinkSirenEntityDescription(SirenEntityDescription, TPLinkModuleEntityDescription):
+    unique_id_fn: Callable[[Device, TPLinkModuleEntityDescription], str] = ...
+
+SIREN_DESCRIPTIONS: tuple[TPLinkSirenEntityDescription, ...]
+
 async def async_setup_entry(hass: HomeAssistant, config_entry: TPLinkConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
-class TPLinkSirenEntity(CoordinatedTPLinkEntity, SirenEntity):
+class TPLinkSirenEntity(CoordinatedTPLinkModuleEntity, SirenEntity):
     _attr_name: Incomplete
     _attr_supported_features: Incomplete
-    _alarm_module: Alarm
-    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator) -> None: ...
+    entity_description: TPLinkSirenEntityDescription
+    _alarm_module: Incomplete
+    _alarm_volume_max: Incomplete
+    _alarm_duration_max: Incomplete
+    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator, description: TPLinkSirenEntityDescription, *, parent: Device | None = None) -> None: ...
     @async_refresh_after
     async def async_turn_on(self, **kwargs: Any) -> None: ...
     @async_refresh_after
     async def async_turn_off(self, **kwargs: Any) -> None: ...
     _attr_is_on: Incomplete
+    _attr_available_tones: Incomplete
     @callback
     def _async_update_attrs(self) -> bool: ...

homeassistant-stubs/components/tplink/switch.pyi

@@ -12,6 +12,7 @@ _LOGGER: Incomplete
 @dataclass(frozen=True, kw_only=True)
 class TPLinkSwitchEntityDescription(SwitchEntityDescription, TPLinkFeatureEntityDescription): ...
 
+PARALLEL_UPDATES: int
 SWITCH_DESCRIPTIONS: tuple[TPLinkSwitchEntityDescription, ...]
 SWITCH_DESCRIPTIONS_MAP: Incomplete
 

homeassistant-stubs/components/tplink/vacuum.pyi

@@ -0,0 +1,43 @@
+from . import TPLinkConfigEntry as TPLinkConfigEntry
+from .coordinator import TPLinkDataUpdateCoordinator as TPLinkDataUpdateCoordinator
+from .entity import CoordinatedTPLinkModuleEntity as CoordinatedTPLinkModuleEntity, TPLinkModuleEntityDescription as TPLinkModuleEntityDescription, async_refresh_after as async_refresh_after
+from _typeshed import Incomplete
+from dataclasses import dataclass
+from homeassistant.components.vacuum import StateVacuumEntity as StateVacuumEntity, StateVacuumEntityDescription as StateVacuumEntityDescription, VacuumActivity as VacuumActivity, VacuumEntityFeature as VacuumEntityFeature
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from kasa import Device as Device
+from kasa.smart.modules.clean import Clean as Clean
+from typing import Any
+
+PARALLEL_UPDATES: int
+STATUS_TO_ACTIVITY: Incomplete
+
+@dataclass(frozen=True, kw_only=True)
+class TPLinkVacuumEntityDescription(StateVacuumEntityDescription, TPLinkModuleEntityDescription): ...
+
+VACUUM_DESCRIPTIONS: tuple[TPLinkVacuumEntityDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, config_entry: TPLinkConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+class TPLinkVacuumEntity(CoordinatedTPLinkModuleEntity, StateVacuumEntity):
+    _attr_supported_features: Incomplete
+    entity_description: TPLinkVacuumEntityDescription
+    _vacuum_module: Clean
+    _speaker_module: Incomplete
+    _attr_fan_speed_list: Incomplete
+    def __init__(self, device: Device, coordinator: TPLinkDataUpdateCoordinator, description: TPLinkVacuumEntityDescription, *, parent: Device) -> None: ...
+    @async_refresh_after
+    async def async_start(self) -> None: ...
+    @async_refresh_after
+    async def async_pause(self) -> None: ...
+    @async_refresh_after
+    async def async_return_to_base(self, **kwargs: Any) -> None: ...
+    @async_refresh_after
+    async def async_set_fan_speed(self, fan_speed: str, **kwargs: Any) -> None: ...
+    async def async_locate(self, **kwargs: Any) -> None: ...
+    @property
+    def battery_level(self) -> int | None: ...
+    _attr_activity: Incomplete
+    _attr_fan_speed: Incomplete
+    def _async_update_attrs(self) -> bool: ...

homeassistant-stubs/components/tradfri/config_flow.pyi

@@ -1,9 +1,9 @@
 from .const import CONF_GATEWAY_ID as CONF_GATEWAY_ID, CONF_IDENTITY as CONF_IDENTITY, CONF_KEY as CONF_KEY, DOMAIN as DOMAIN
 from _typeshed import Incomplete
-from homeassistant.components import zeroconf as zeroconf
 from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
 from homeassistant.const import CONF_HOST as CONF_HOST
 from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.service_info.zeroconf import ATTR_PROPERTIES_ID as ATTR_PROPERTIES_ID, ZeroconfServiceInfo as ZeroconfServiceInfo
 from typing import Any
 
 KEY_SECURITY_CODE: str
@@ -18,7 +18,7 @@ class FlowHandler(ConfigFlow, domain=DOMAIN):
     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: ...
-    async def async_step_homekit(self, discovery_info: zeroconf.ZeroconfServiceInfo) -> ConfigFlowResult: ...
+    async def async_step_homekit(self, discovery_info: ZeroconfServiceInfo) -> ConfigFlowResult: ...
     async def _entry_from_data(self, data: dict[str, Any]) -> ConfigFlowResult: ...
 
 async def authenticate(hass: HomeAssistant, host: str, security_code: str) -> dict[str, str | bool]: ...