homeassistant-stubs 2025.1.3__py3-none-any.whl → 2025.2.0__py3-none-any.whl

homeassistant-stubs/components/tile/binary_sensor.pyi

@@ -0,0 +1,24 @@
+from .coordinator import TileConfigEntry as TileConfigEntry, TileCoordinator as TileCoordinator
+from .entity import TileEntity as TileEntity
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.binary_sensor import BinarySensorEntity as BinarySensorEntity, BinarySensorEntityDescription as BinarySensorEntityDescription
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from pytile.tile import Tile as Tile
+
+@dataclass(frozen=True, kw_only=True)
+class TileBinarySensorEntityDescription(BinarySensorEntityDescription):
+    is_on_fn: Callable[[Tile], bool]
+
+ENTITIES: tuple[TileBinarySensorEntityDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: TileConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+class TileBinarySensor(TileEntity, BinarySensorEntity):
+    entity_description: TileBinarySensorEntityDescription
+    _attr_unique_id: Incomplete
+    def __init__(self, coordinator: TileCoordinator, description: TileBinarySensorEntityDescription) -> None: ...
+    @property
+    def is_on(self) -> bool: ...

homeassistant-stubs/components/tile/config_flow.pyi

@@ -16,7 +16,6 @@ class TileFlowHandler(ConfigFlow, domain=DOMAIN):
     _username: str | None
     def __init__(self) -> None: ...
     async def _async_verify(self, step_id: str, schema: vol.Schema) -> ConfigFlowResult: ...
-    async def async_step_import(self, import_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, str] | None = None) -> ConfigFlowResult: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/tile/coordinator.pyi

@@ -0,0 +1,18 @@
+from .const import LOGGER as LOGGER
+from _typeshed import Incomplete
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.const import CONF_USERNAME as CONF_USERNAME
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed
+from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
+from pytile.api import API as API
+from pytile.tile import Tile as Tile
+
+type TileConfigEntry = ConfigEntry[dict[str, TileCoordinator]]
+class TileCoordinator(DataUpdateCoordinator[None]):
+    config_entry: TileConfigEntry
+    tile: Incomplete
+    client: Incomplete
+    username: Incomplete
+    def __init__(self, hass: HomeAssistant, entry: TileConfigEntry, client: API, tile: Tile) -> None: ...
+    async def _async_update_data(self) -> None: ...

homeassistant-stubs/components/tile/device_tracker.pyi

@@ -1,16 +1,10 @@
-from . import TileData as TileData
-from .const import DOMAIN as DOMAIN
+from .coordinator import TileConfigEntry as TileConfigEntry, TileCoordinator as TileCoordinator
+from .entity import TileEntity as TileEntity
 from _typeshed import Incomplete
-from homeassistant.components.device_tracker import AsyncSeeCallback as AsyncSeeCallback, TrackerEntity as TrackerEntity
-from homeassistant.config_entries import ConfigEntry as ConfigEntry, SOURCE_IMPORT as SOURCE_IMPORT
-from homeassistant.const import CONF_PASSWORD as CONF_PASSWORD, CONF_USERNAME as CONF_USERNAME
+from homeassistant.components.device_tracker import TrackerEntity as TrackerEntity
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
-from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
-from homeassistant.helpers.typing import ConfigType as ConfigType, DiscoveryInfoType as DiscoveryInfoType
-from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity, DataUpdateCoordinator as DataUpdateCoordinator
 from homeassistant.util.dt import as_utc as as_utc
-from pytile.tile import Tile as Tile
 
 _LOGGER: Incomplete
 ATTR_ALTITUDE: str
@@ -23,22 +17,14 @@ ATTR_RING_STATE: str
 ATTR_TILE_NAME: str
 ATTR_VOIP_STATE: str
 
-async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
-async def async_setup_scanner(hass: HomeAssistant, config: ConfigType, async_see: AsyncSeeCallback, discovery_info: DiscoveryInfoType | None = None) -> bool: ...
+async def async_setup_entry(hass: HomeAssistant, entry: TileConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
-class TileDeviceTracker(CoordinatorEntity[DataUpdateCoordinator[None]], TrackerEntity):
-    _attr_has_entity_name: bool
+class TileDeviceTracker(TileEntity, TrackerEntity):
     _attr_name: Incomplete
     _attr_translation_key: str
     _attr_extra_state_attributes: Incomplete
     _attr_unique_id: Incomplete
-    _entry: Incomplete
-    _tile: Incomplete
-    def __init__(self, entry: ConfigEntry, coordinator: DataUpdateCoordinator[None], tile: Tile) -> None: ...
-    @property
-    def available(self) -> bool: ...
-    @property
-    def device_info(self) -> DeviceInfo: ...
+    def __init__(self, coordinator: TileCoordinator) -> None: ...
     @callback
     def _handle_coordinator_update(self) -> None: ...
     _attr_longitude: Incomplete

homeassistant-stubs/components/tile/diagnostics.pyi

@@ -1,8 +1,6 @@
-from . import TileData as TileData
-from .const import DOMAIN as DOMAIN
+from .coordinator import TileConfigEntry as TileConfigEntry
 from _typeshed import Incomplete
 from homeassistant.components.diagnostics import async_redact_data as async_redact_data
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import CONF_LATITUDE as CONF_LATITUDE, CONF_LONGITUDE as CONF_LONGITUDE, CONF_UUID as CONF_UUID
 from homeassistant.core import HomeAssistant as HomeAssistant
 from typing import Any
@@ -10,4 +8,4 @@ from typing import Any
 CONF_ALTITUDE: str
 TO_REDACT: Incomplete
 
-async def async_get_config_entry_diagnostics(hass: HomeAssistant, entry: ConfigEntry) -> dict[str, Any]: ...
+async def async_get_config_entry_diagnostics(hass: HomeAssistant, entry: TileConfigEntry) -> dict[str, Any]: ...

homeassistant-stubs/components/tile/entity.pyi

@@ -0,0 +1,13 @@
+from .const import DOMAIN as DOMAIN
+from .coordinator import TileCoordinator as TileCoordinator
+from _typeshed import Incomplete
+from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo
+from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
+
+class TileEntity(CoordinatorEntity[TileCoordinator]):
+    _attr_has_entity_name: bool
+    _tile: Incomplete
+    _attr_device_info: Incomplete
+    def __init__(self, coordinator: TileCoordinator) -> None: ...
+    @property
+    def available(self) -> bool: ...

homeassistant-stubs/components/time/__init__.pyi

@@ -1,7 +1,7 @@
 from .const import DOMAIN as DOMAIN
 from datetime import time
 from homeassistant.helpers.entity import Entity, EntityDescription
-from propcache import cached_property
+from propcache.api import cached_property
 from typing import final
 
 __all__ = ['DOMAIN', 'TimeEntity', 'TimeEntityDescription']

homeassistant-stubs/components/todo/__init__.pyi

@@ -13,7 +13,7 @@ from homeassistant.helpers.entity import Entity as Entity
 from homeassistant.helpers.entity_component import EntityComponent as EntityComponent
 from homeassistant.helpers.typing import ConfigType as ConfigType
 from homeassistant.util.json import JsonValueType as JsonValueType
-from propcache import cached_property
+from propcache.api import cached_property
 from typing import Any, final
 
 _LOGGER: Incomplete

homeassistant-stubs/components/tolo/config_flow.pyi

@@ -1,9 +1,9 @@
 from .const import DEFAULT_NAME as DEFAULT_NAME, DOMAIN as DOMAIN
 from _typeshed import Incomplete
-from homeassistant.components import dhcp as dhcp
 from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
 from homeassistant.const import CONF_HOST as CONF_HOST
 from homeassistant.helpers.device_registry import format_mac as format_mac
+from homeassistant.helpers.service_info.dhcp import DhcpServiceInfo as DhcpServiceInfo
 from typing import Any
 
 _LOGGER: Incomplete
@@ -14,5 +14,5 @@ class ToloSaunaConfigFlow(ConfigFlow, domain=DOMAIN):
     @staticmethod
     def _check_device_availability(host: str) -> bool: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
-    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_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

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