homeassistant-stubs 2024.9.2__py3-none-any.whl → 2024.10.0__py3-none-any.whl

homeassistant-stubs/components/ring/__init__.pyi

@@ -1,13 +1,12 @@
-from .const import DOMAIN as DOMAIN, PLATFORMS as PLATFORMS
-from .coordinator import RingDataCoordinator as RingDataCoordinator, RingNotificationsCoordinator as RingNotificationsCoordinator
+from .const import CONF_LISTEN_CREDENTIALS as CONF_LISTEN_CREDENTIALS, DOMAIN as DOMAIN, PLATFORMS as PLATFORMS
+from .coordinator import RingDataCoordinator as RingDataCoordinator, RingListenCoordinator as RingListenCoordinator
 from _typeshed import Incomplete
 from dataclasses import dataclass
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
-from homeassistant.const import APPLICATION_NAME as APPLICATION_NAME, CONF_TOKEN as CONF_TOKEN, __version__ as __version__
-from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, callback as callback
-from homeassistant.helpers import device_registry as dr
+from homeassistant.const import APPLICATION_NAME as APPLICATION_NAME, CONF_TOKEN as CONF_TOKEN
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers import device_registry as dr, instance_id as instance_id
 from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
-from homeassistant.helpers.issue_registry import IssueSeverity as IssueSeverity, async_create_issue as async_create_issue
 from ring_doorbell import Ring, RingDevices as RingDevices
 
 _LOGGER: Incomplete
@@ -17,10 +16,12 @@ class RingData:
     api: Ring
     devices: RingDevices
     devices_coordinator: RingDataCoordinator
-    notifications_coordinator: RingNotificationsCoordinator
-    def __init__(self, api, devices, devices_coordinator, notifications_coordinator) -> None: ...
+    listen_coordinator: RingListenCoordinator
+    def __init__(self, api, devices, devices_coordinator, listen_coordinator) -> None: ...
+RingConfigEntry = ConfigEntry[RingData]
 
-async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
+async def get_auth_agent_id(hass: HomeAssistant) -> tuple[str, str]: ...
+async def async_setup_entry(hass: HomeAssistant, entry: RingConfigEntry) -> bool: ...
 async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
 async def async_remove_config_entry_device(hass: HomeAssistant, config_entry: ConfigEntry, device_entry: dr.DeviceEntry) -> bool: ...
 async def _migrate_old_unique_ids(hass: HomeAssistant, entry_id: str) -> None: ...

homeassistant-stubs/components/ring/binary_sensor.pyi

@@ -1,35 +1,39 @@
-from . import RingData as RingData
-from .const import DOMAIN as DOMAIN
-from .coordinator import RingNotificationsCoordinator as RingNotificationsCoordinator
-from .entity import RingBaseEntity as RingBaseEntity
+from . import RingConfigEntry as RingConfigEntry
+from .coordinator import RingListenCoordinator as RingListenCoordinator
+from .entity import DeprecatedInfo as DeprecatedInfo, RingBaseEntity as RingBaseEntity, RingDeviceT as RingDeviceT, RingEntityDescription as RingEntityDescription, async_check_create_deprecated as async_check_create_deprecated
 from _typeshed import Incomplete
-from collections.abc import Callable as Callable, Mapping
+from collections.abc import Mapping
 from dataclasses import dataclass
 from homeassistant.components.binary_sensor import BinarySensorDeviceClass as BinarySensorDeviceClass, BinarySensorEntity as BinarySensorEntity, BinarySensorEntityDescription as BinarySensorEntityDescription
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
-from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.const import Platform as Platform
+from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
-from ring_doorbell import Ring as Ring, RingEvent as RingEvent, RingGeneric as RingGeneric
-from typing import Any
+from homeassistant.helpers.event import async_call_at as async_call_at
+from ring_doorbell import RingCapability, RingEvent as RingEvent
+from typing import Any, Generic
 
 @dataclass(frozen=True, kw_only=True)
-class RingBinarySensorEntityDescription(BinarySensorEntityDescription):
-    exists_fn: Callable[[RingGeneric], bool]
-    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., exists_fn) -> None: ...
+class RingBinarySensorEntityDescription(BinarySensorEntityDescription, RingEntityDescription, Generic[RingDeviceT]):
+    capability: RingCapability
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., deprecated_info=..., capability) -> None: ...
 
 BINARY_SENSOR_TYPES: tuple[RingBinarySensorEntityDescription, ...]
 
-async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+async def async_setup_entry(hass: HomeAssistant, entry: RingConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
-class RingBinarySensor(RingBaseEntity[RingNotificationsCoordinator], BinarySensorEntity):
+class RingBinarySensor(RingBaseEntity[RingListenCoordinator, RingDeviceT], BinarySensorEntity):
     _active_alert: RingEvent | None
-    entity_description: RingBinarySensorEntityDescription
-    _ring: Incomplete
+    entity_description: Incomplete
     _attr_unique_id: Incomplete
-    def __init__(self, ring: Ring, device: RingGeneric, coordinator: RingNotificationsCoordinator, description: RingBinarySensorEntityDescription) -> None: ...
-    def _handle_coordinator_update(self, _: Any = None) -> None: ...
-    def _update_alert(self) -> None: ...
+    _attr_is_on: bool
+    _cancel_callback: Incomplete
+    def __init__(self, device: RingDeviceT, coordinator: RingListenCoordinator, description: RingBinarySensorEntityDescription[RingDeviceT]) -> None: ...
+    def _async_handle_event(self, alert: RingEvent) -> None: ...
+    def _async_cancel_event(self, _now: Any) -> None: ...
+    def _get_coordinator_alert(self) -> RingEvent | None: ...
+    def _handle_coordinator_update(self) -> None: ...
     @property
-    def is_on(self) -> bool: ...
+    def available(self) -> bool: ...
+    async def async_update(self) -> None: ...
     @property
     def extra_state_attributes(self) -> Mapping[str, Any] | None: ...

homeassistant-stubs/components/ring/button.pyi

@@ -1,17 +1,15 @@
-from . import RingData as RingData
-from .const import DOMAIN as DOMAIN
+from . import RingConfigEntry as RingConfigEntry
 from .coordinator import RingDataCoordinator as RingDataCoordinator
 from .entity import RingEntity as RingEntity, exception_wrap as exception_wrap
 from _typeshed import Incomplete
 from homeassistant.components.button import ButtonEntity as ButtonEntity, ButtonEntityDescription as ButtonEntityDescription
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from ring_doorbell import RingOther
 
 BUTTON_DESCRIPTION: Incomplete
 
-async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+async def async_setup_entry(hass: HomeAssistant, entry: RingConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
 class RingDoorButton(RingEntity[RingOther], ButtonEntity):
     entity_description: Incomplete

homeassistant-stubs/components/ring/camera.pyi

@@ -1,12 +1,10 @@
-from . import RingData as RingData
-from .const import DOMAIN as DOMAIN
+from . import RingConfigEntry as RingConfigEntry
 from .coordinator import RingDataCoordinator as RingDataCoordinator
 from .entity import RingEntity as RingEntity, exception_wrap as exception_wrap
 from _typeshed import Incomplete
 from aiohttp import web as web
 from homeassistant.components import ffmpeg as ffmpeg
 from homeassistant.components.camera import Camera as Camera
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
 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
@@ -17,7 +15,7 @@ FORCE_REFRESH_INTERVAL: Incomplete
 MOTION_DETECTION_CAPABILITY: str
 _LOGGER: Incomplete
 
-async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+async def async_setup_entry(hass: HomeAssistant, entry: RingConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
 class RingCam(RingEntity[RingDoorBell], Camera):
     _attr_name: Incomplete

homeassistant-stubs/components/ring/config_flow.pyi

@@ -1,8 +1,9 @@
+from . import get_auth_agent_id as get_auth_agent_id
 from .const import CONF_2FA as CONF_2FA, DOMAIN as DOMAIN
 from _typeshed import Incomplete
 from collections.abc import Mapping
 from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
-from homeassistant.const import APPLICATION_NAME as APPLICATION_NAME, CONF_PASSWORD as CONF_PASSWORD, CONF_TOKEN as CONF_TOKEN, CONF_USERNAME as CONF_USERNAME
+from homeassistant.const import CONF_PASSWORD as CONF_PASSWORD, CONF_TOKEN as CONF_TOKEN, CONF_USERNAME as CONF_USERNAME
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession

homeassistant-stubs/components/ring/const.pyi

@@ -8,5 +8,5 @@ DOMAIN: str
 DEFAULT_ENTITY_NAMESPACE: str
 PLATFORMS: Incomplete
 SCAN_INTERVAL: Incomplete
-NOTIFICATIONS_SCAN_INTERVAL: Incomplete
 CONF_2FA: str
+CONF_LISTEN_CREDENTIALS: str

homeassistant-stubs/components/ring/coordinator.pyi

@@ -1,10 +1,11 @@
-from .const import NOTIFICATIONS_SCAN_INTERVAL as NOTIFICATIONS_SCAN_INTERVAL, SCAN_INTERVAL as SCAN_INTERVAL
+from .const import SCAN_INTERVAL as SCAN_INTERVAL
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable, Coroutine
-from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant import config_entries as config_entries
+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 ring_doorbell import Ring as Ring, RingDevices
+from homeassistant.helpers.update_coordinator import BaseDataUpdateCoordinatorProtocol as BaseDataUpdateCoordinatorProtocol, DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
+from ring_doorbell import Ring as Ring, RingDevices, RingEvent as RingEvent
 from typing import Any
 
 _LOGGER: Incomplete
@@ -17,7 +18,21 @@ class RingDataCoordinator(DataUpdateCoordinator[RingDevices]):
     def __init__(self, hass: HomeAssistant, ring_api: Ring) -> None: ...
     async def _async_update_data(self) -> RingDevices: ...
 
-class RingNotificationsCoordinator(DataUpdateCoordinator[None]):
+class RingListenCoordinator(BaseDataUpdateCoordinatorProtocol):
+    config_entry: config_entries.ConfigEntry
+    hass: Incomplete
+    logger: Incomplete
     ring_api: Incomplete
-    def __init__(self, hass: HomeAssistant, ring_api: Ring) -> None: ...
-    async def _async_update_data(self) -> None: ...
+    event_listener: Incomplete
+    _listeners: Incomplete
+    _listen_callback_id: Incomplete
+    start_timeout: int
+    def __init__(self, hass: HomeAssistant, ring_api: Ring, listen_credentials: dict[str, Any] | None, listen_credentials_updater: Callable[[dict[str, Any]], None]) -> None: ...
+    alerts: Incomplete
+    def index_alerts(self) -> None: ...
+    async def async_shutdown(self) -> None: ...
+    async def _async_stop_listen(self) -> None: ...
+    async def _async_start_listen(self) -> None: ...
+    def _on_event(self, event: RingEvent) -> None: ...
+    def _async_update_listeners(self, doorbot_id: int | None = None) -> None: ...
+    def async_add_listener(self, update_callback: CALLBACK_TYPE, context: Any = None) -> Callable[[], None]: ...

homeassistant-stubs/components/ring/diagnostics.pyi

@@ -1,11 +1,9 @@
-from . import RingData as RingData
-from .const import DOMAIN as DOMAIN
+from . import RingConfigEntry as RingConfigEntry
 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.core import HomeAssistant as HomeAssistant
 from typing import Any
 
 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: RingConfigEntry) -> dict[str, Any]: ...

homeassistant-stubs/components/ring/entity.pyi

@@ -1,21 +1,41 @@
+import abc
 from .const import ATTRIBUTION as ATTRIBUTION, DOMAIN as DOMAIN
-from .coordinator import RingDataCoordinator as RingDataCoordinator, RingNotificationsCoordinator as RingNotificationsCoordinator
+from .coordinator import RingDataCoordinator as RingDataCoordinator, RingListenCoordinator as RingListenCoordinator
 from _typeshed import Incomplete
-from collections.abc import Callable as Callable, Coroutine
-from homeassistant.core import callback as callback
+from collections.abc import Awaitable as Awaitable, Callable as Callable, Coroutine
+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.const import Platform as Platform
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo
-from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
+from homeassistant.helpers.entity import EntityDescription as EntityDescription
+from homeassistant.helpers.issue_registry import IssueSeverity as IssueSeverity, async_create_issue as async_create_issue
+from homeassistant.helpers.update_coordinator import BaseCoordinatorEntity as BaseCoordinatorEntity, CoordinatorEntity as CoordinatorEntity
 from ring_doorbell import RingDevices as RingDevices, RingGeneric
 from typing import Any, Concatenate, Generic
 from typing_extensions import TypeVar
 
 RingDeviceT = TypeVar('RingDeviceT', bound=RingGeneric, default=RingGeneric)
-_RingCoordinatorT = TypeVar('_RingCoordinatorT', bound=RingDataCoordinator | RingNotificationsCoordinator)
+_RingCoordinatorT = TypeVar('_RingCoordinatorT', bound=RingDataCoordinator | RingListenCoordinator)
+
+@dataclass(slots=True)
+class DeprecatedInfo:
+    new_platform: Platform
+    breaks_in_ha_version: str
+    def __init__(self, new_platform, breaks_in_ha_version) -> None: ...
+
+@dataclass(frozen=True, kw_only=True)
+class RingEntityDescription(EntityDescription):
+    deprecated_info: DeprecatedInfo | None = ...
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., deprecated_info=...) -> None: ...
 
 def exception_wrap(async_func: Callable[Concatenate[_RingBaseEntityT, _P], Coroutine[Any, Any, _R]]) -> Callable[Concatenate[_RingBaseEntityT, _P], Coroutine[Any, Any, _R]]: ...
+def refresh_after(func: Callable[Concatenate[_RingEntityT, _P], Awaitable[None]]) -> Callable[Concatenate[_RingEntityT, _P], Coroutine[Any, Any, None]]: ...
+def async_check_create_deprecated(hass: HomeAssistant, platform: Platform, unique_id: str, entity_description: RingEntityDescription) -> bool: ...
 
-class RingBaseEntity(CoordinatorEntity[_RingCoordinatorT], Generic[_RingCoordinatorT, RingDeviceT]):
+class RingBaseEntity(BaseCoordinatorEntity[_RingCoordinatorT], Generic[_RingCoordinatorT, RingDeviceT], metaclass=abc.ABCMeta):
     _attr_attribution = ATTRIBUTION
     _attr_should_poll: bool
     _attr_has_entity_name: bool
@@ -24,7 +44,7 @@ class RingBaseEntity(CoordinatorEntity[_RingCoordinatorT], Generic[_RingCoordina
     _attr_device_info: Incomplete
     def __init__(self, device: RingDeviceT, coordinator: _RingCoordinatorT) -> None: ...
 
-class RingEntity(RingBaseEntity[RingDataCoordinator, RingDeviceT]):
+class RingEntity(RingBaseEntity[RingDataCoordinator, RingDeviceT], CoordinatorEntity):
     def _get_coordinator_data(self) -> RingDevices: ...
     _device: Incomplete
     def _handle_coordinator_update(self) -> None: ...

homeassistant-stubs/components/ring/event.pyi

@@ -0,0 +1,30 @@
+from . import RingConfigEntry as RingConfigEntry
+from .coordinator import RingListenCoordinator as RingListenCoordinator
+from .entity import RingBaseEntity as RingBaseEntity, RingDeviceT as RingDeviceT
+from _typeshed import Incomplete
+from dataclasses import dataclass
+from homeassistant.components.event import EventDeviceClass as EventDeviceClass, EventEntity as EventEntity, EventEntityDescription as EventEntityDescription
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from ring_doorbell import RingCapability, RingEvent as RingAlert
+from typing import Generic
+
+@dataclass(frozen=True, kw_only=True)
+class RingEventEntityDescription(EventEntityDescription, Generic[RingDeviceT]):
+    capability: RingCapability
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., event_types=..., capability) -> None: ...
+
+EVENT_DESCRIPTIONS: tuple[RingEventEntityDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: RingConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+class RingEvent(RingBaseEntity[RingListenCoordinator, RingDeviceT], EventEntity):
+    entity_description: RingEventEntityDescription[RingDeviceT]
+    _attr_unique_id: Incomplete
+    def __init__(self, device: RingDeviceT, coordinator: RingListenCoordinator, description: RingEventEntityDescription[RingDeviceT]) -> None: ...
+    def _async_handle_event(self, event: str) -> None: ...
+    def _get_coordinator_alert(self) -> RingAlert | None: ...
+    def _handle_coordinator_update(self) -> None: ...
+    @property
+    def available(self) -> bool: ...
+    async def async_update(self) -> None: ...

homeassistant-stubs/components/ring/light.pyi

@@ -1,11 +1,9 @@
-from . import RingData as RingData
-from .const import DOMAIN as DOMAIN
+from . import RingConfigEntry as RingConfigEntry
 from .coordinator import RingDataCoordinator as RingDataCoordinator
 from .entity import RingEntity as RingEntity, exception_wrap as exception_wrap
 from _typeshed import Incomplete
 from enum import StrEnum
 from homeassistant.components.light import ColorMode as ColorMode, LightEntity as LightEntity
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from ring_doorbell import RingStickUpCam
@@ -18,7 +16,7 @@ class OnOffState(StrEnum):
     ON = ...
     OFF = ...
 
-async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+async def async_setup_entry(hass: HomeAssistant, entry: RingConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
 class RingLight(RingEntity[RingStickUpCam], LightEntity):
     _attr_color_mode: Incomplete

homeassistant-stubs/components/ring/number.pyi

@@ -0,0 +1,33 @@
+from . import RingConfigEntry as RingConfigEntry
+from .coordinator import RingDataCoordinator as RingDataCoordinator
+from .entity import RingDeviceT as RingDeviceT, RingEntity as RingEntity, refresh_after as refresh_after
+from _typeshed import Incomplete
+from collections.abc import Awaitable, Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.number import NumberEntity as NumberEntity, NumberEntityDescription as NumberEntityDescription, NumberMode as NumberMode
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
+from homeassistant.helpers.typing import StateType as StateType
+from ring_doorbell import RingGeneric as RingGeneric
+from typing import Any, Generic
+
+async def async_setup_entry(hass: HomeAssistant, entry: RingConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+@dataclass(frozen=True, kw_only=True)
+class RingNumberEntityDescription(NumberEntityDescription, Generic[RingDeviceT]):
+    value_fn: Callable[[RingDeviceT], StateType]
+    setter_fn: Callable[[RingDeviceT, float], Awaitable[None]]
+    exists_fn: Callable[[RingGeneric], bool]
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., max_value=..., min_value=..., mode=..., native_max_value=..., native_min_value=..., native_step=..., native_unit_of_measurement=..., step=..., value_fn, setter_fn, exists_fn) -> None: ...
+
+NUMBER_TYPES: tuple[RingNumberEntityDescription[Any], ...]
+
+class RingNumber(RingEntity[RingDeviceT], NumberEntity):
+    entity_description: RingNumberEntityDescription[RingDeviceT]
+    _attr_unique_id: Incomplete
+    def __init__(self, device: RingDeviceT, coordinator: RingDataCoordinator, description: RingNumberEntityDescription[RingDeviceT]) -> None: ...
+    _attr_native_value: Incomplete
+    def _update_native_value(self) -> None: ...
+    _device: Incomplete
+    def _handle_coordinator_update(self) -> None: ...
+    async def async_set_native_value(self, value: float) -> None: ...

homeassistant-stubs/components/ring/sensor.pyi

@@ -1,20 +1,18 @@
-from . import RingData as RingData
-from .const import DOMAIN as DOMAIN
+from . import RingConfigEntry as RingConfigEntry
 from .coordinator import RingDataCoordinator as RingDataCoordinator
-from .entity import RingDeviceT as RingDeviceT, RingEntity as RingEntity
+from .entity import DeprecatedInfo as DeprecatedInfo, RingDeviceT as RingDeviceT, RingEntity as RingEntity, RingEntityDescription as RingEntityDescription, async_check_create_deprecated as async_check_create_deprecated
 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.config_entries import ConfigEntry as ConfigEntry
-from homeassistant.const import EntityCategory as EntityCategory, PERCENTAGE as PERCENTAGE, SIGNAL_STRENGTH_DECIBELS_MILLIWATT as SIGNAL_STRENGTH_DECIBELS_MILLIWATT
+from homeassistant.const import EntityCategory as EntityCategory, PERCENTAGE as PERCENTAGE, Platform as Platform, SIGNAL_STRENGTH_DECIBELS_MILLIWATT as SIGNAL_STRENGTH_DECIBELS_MILLIWATT
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from homeassistant.helpers.typing import StateType as StateType
 from ring_doorbell import RingEventKind, RingGeneric
 from typing import Any, Generic
 
-async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+async def async_setup_entry(hass: HomeAssistant, entry: RingConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
 class RingSensor(RingEntity[RingDeviceT], SensorEntity):
     entity_description: RingSensorEntityDescription[RingDeviceT]
@@ -30,10 +28,10 @@ def _get_last_event(history_data: list[dict[str, Any]], kind: RingEventKind | No
 def _get_last_event_attrs(history_data: list[dict[str, Any]], kind: RingEventKind | None) -> dict[str, Any] | None: ...
 
 @dataclass(frozen=True, kw_only=True)
-class RingSensorEntityDescription(SensorEntityDescription, Generic[RingDeviceT]):
+class RingSensorEntityDescription(SensorEntityDescription, RingEntityDescription, Generic[RingDeviceT]):
     value_fn: Callable[[RingDeviceT], StateType] = ...
     exists_fn: Callable[[RingGeneric], bool] = ...
     extra_state_attributes_fn: Callable[[RingDeviceT], dict[str, Any] | None] = ...
-    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., last_reset=..., native_unit_of_measurement=..., options=..., state_class=..., suggested_display_precision=..., suggested_unit_of_measurement=..., value_fn=..., exists_fn=..., extra_state_attributes_fn=...) -> None: ...
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., deprecated_info=..., last_reset=..., native_unit_of_measurement=..., options=..., state_class=..., suggested_display_precision=..., suggested_unit_of_measurement=..., value_fn=..., exists_fn=..., extra_state_attributes_fn=...) -> None: ...
 
 SENSOR_TYPES: tuple[RingSensorEntityDescription[Any], ...]

homeassistant-stubs/components/ring/siren.pyi

@@ -1,23 +1,39 @@
-from . import RingData as RingData
-from .const import DOMAIN as DOMAIN
+from . import RingConfigEntry as RingConfigEntry
 from .coordinator import RingDataCoordinator as RingDataCoordinator
-from .entity import RingEntity as RingEntity, exception_wrap as exception_wrap
+from .entity import RingDeviceT as RingDeviceT, RingEntity as RingEntity, RingEntityDescription as RingEntityDescription, async_check_create_deprecated as async_check_create_deprecated, refresh_after as refresh_after
 from _typeshed import Incomplete
-from homeassistant.components.siren import ATTR_TONE as ATTR_TONE, SirenEntity as SirenEntity, SirenEntityFeature as SirenEntityFeature
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
-from homeassistant.core import HomeAssistant as HomeAssistant
+from collections.abc import Callable as Callable, Coroutine
+from dataclasses import dataclass
+from homeassistant.components.siren import ATTR_TONE as ATTR_TONE, SirenEntity as SirenEntity, SirenEntityDescription as SirenEntityDescription, SirenEntityFeature as SirenEntityFeature, SirenTurnOnServiceParameters as SirenTurnOnServiceParameters
+from homeassistant.const import Platform as Platform
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
-from ring_doorbell import RingChime
-from typing import Any
+from ring_doorbell import RingGeneric as RingGeneric
+from typing import Any, Generic
 
 _LOGGER: Incomplete
 
-async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+@dataclass(frozen=True, kw_only=True)
+class RingSirenEntityDescription(SirenEntityDescription, RingEntityDescription, Generic[RingDeviceT]):
+    exists_fn: Callable[[RingGeneric], bool]
+    unique_id_fn: Callable[[RingDeviceT], str] = ...
+    is_on_fn: Callable[[RingDeviceT], bool] | None = ...
+    turn_on_fn: Callable[[RingDeviceT, SirenTurnOnServiceParameters], Coroutine[Any, Any, Any]] | None = ...
+    turn_off_fn: Callable[[RingDeviceT], Coroutine[Any, Any, None]] | None = ...
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., deprecated_info=..., available_tones=..., exists_fn, unique_id_fn=..., is_on_fn=..., turn_on_fn=..., turn_off_fn=...) -> None: ...
 
-class RingChimeSiren(RingEntity[RingChime], SirenEntity):
-    _attr_available_tones: Incomplete
-    _attr_supported_features: Incomplete
-    _attr_translation_key: str
+SIRENS: tuple[RingSirenEntityDescription[Any], ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: RingConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+
+class RingSiren(RingEntity[RingDeviceT], SirenEntity):
+    entity_description: RingSirenEntityDescription[RingDeviceT]
     _attr_unique_id: Incomplete
-    def __init__(self, device: RingChime, coordinator: RingDataCoordinator) -> None: ...
+    _attr_is_on: Incomplete
+    _attr_supported_features: Incomplete
+    def __init__(self, device: RingDeviceT, coordinator: RingDataCoordinator, description: RingSirenEntityDescription[RingDeviceT]) -> None: ...
+    async def _async_set_siren(self, siren_on: bool, **kwargs: Any) -> None: ...
     async def async_turn_on(self, **kwargs: Any) -> None: ...
+    async def async_turn_off(self, **kwargs: Any) -> None: ...
+    _device: Incomplete
+    def _handle_coordinator_update(self) -> None: ...

homeassistant-stubs/components/ring/switch.pyi

@@ -1,31 +1,39 @@
-from . import RingData as RingData
-from .const import DOMAIN as DOMAIN
+from . import RingConfigEntry as RingConfigEntry
 from .coordinator import RingDataCoordinator as RingDataCoordinator
-from .entity import RingEntity as RingEntity, exception_wrap as exception_wrap
+from .entity import DeprecatedInfo as DeprecatedInfo, RingDeviceT as RingDeviceT, RingEntity as RingEntity, RingEntityDescription as RingEntityDescription, async_check_create_deprecated as async_check_create_deprecated, refresh_after as refresh_after
 from _typeshed import Incomplete
-from homeassistant.components.switch import SwitchEntity as SwitchEntity
-from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from collections.abc import Callable as Callable, Coroutine, Sequence
+from dataclasses import dataclass
+from homeassistant.components.switch import SwitchEntity as SwitchEntity, SwitchEntityDescription as SwitchEntityDescription
+from homeassistant.const import Platform as Platform
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
-from ring_doorbell import RingStickUpCam
-from typing import Any
+from typing import Any, Generic, Self
 
 _LOGGER: Incomplete
-SKIP_UPDATES_DELAY: Incomplete
+IN_HOME_CHIME_IS_PRESENT: Incomplete
 
-async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
+@dataclass(frozen=True, kw_only=True)
+class RingSwitchEntityDescription(SwitchEntityDescription, RingEntityDescription, Generic[RingDeviceT]):
+    exists_fn: Callable[[RingDeviceT], bool]
+    unique_id_fn: Callable[[Self, RingDeviceT], str] = ...
+    is_on_fn: Callable[[RingDeviceT], bool]
+    turn_on_fn: Callable[[RingDeviceT], Coroutine[Any, Any, None]]
+    turn_off_fn: Callable[[RingDeviceT], Coroutine[Any, Any, None]]
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., deprecated_info=..., exists_fn, unique_id_fn=..., is_on_fn, turn_on_fn, turn_off_fn) -> None: ...
 
-class BaseRingSwitch(RingEntity[RingStickUpCam], SwitchEntity):
-    _device_type: Incomplete
-    _attr_unique_id: Incomplete
-    def __init__(self, device: RingStickUpCam, coordinator: RingDataCoordinator, device_type: str) -> None: ...
+SWITCHES: Sequence[RingSwitchEntityDescription[Any]]
+
+async def async_setup_entry(hass: HomeAssistant, entry: RingConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
-class SirenSwitch(BaseRingSwitch):
-    _attr_translation_key: str
+class RingSwitch(RingEntity[RingDeviceT], SwitchEntity):
+    entity_description: RingSwitchEntityDescription[RingDeviceT]
     _no_updates_until: Incomplete
+    _attr_unique_id: Incomplete
     _attr_is_on: Incomplete
-    def __init__(self, device: RingStickUpCam, coordinator: RingDataCoordinator) -> None: ...
+    def __init__(self, device: RingDeviceT, coordinator: RingDataCoordinator, description: RingSwitchEntityDescription[RingDeviceT]) -> None: ...
+    _device: Incomplete
     def _handle_coordinator_update(self) -> None: ...
-    async def _async_set_switch(self, new_state: int) -> None: ...
+    async def _async_set_switch(self, switch_on: bool) -> None: ...
     async def async_turn_on(self, **kwargs: Any) -> None: ...
     async def async_turn_off(self, **kwargs: Any) -> None: ...

homeassistant-stubs/components/roborock/binary_sensor.pyi

@@ -1,6 +1,6 @@
 from . import RoborockConfigEntry as RoborockConfigEntry
 from .coordinator import RoborockDataUpdateCoordinator as RoborockDataUpdateCoordinator
-from .device import RoborockCoordinatedEntityV1 as RoborockCoordinatedEntityV1
+from .entity import RoborockCoordinatedEntityV1 as RoborockCoordinatedEntityV1
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from dataclasses import dataclass

homeassistant-stubs/components/roborock/button.pyi

@@ -1,6 +1,6 @@
 from . import RoborockConfigEntry as RoborockConfigEntry
 from .coordinator import RoborockDataUpdateCoordinator as RoborockDataUpdateCoordinator
-from .device import RoborockEntityV1 as RoborockEntityV1
+from .entity import RoborockEntityV1 as RoborockEntityV1
 from _typeshed import Incomplete
 from dataclasses import dataclass
 from homeassistant.components.button import ButtonEntity as ButtonEntity, ButtonEntityDescription as ButtonEntityDescription

homeassistant-stubs/components/roborock/diagnostics.pyi

@@ -1,6 +1,6 @@
 from . import RoborockConfigEntry as RoborockConfigEntry
 from _typeshed import Incomplete
-from homeassistant.components.diagnostics.util import async_redact_data as async_redact_data
+from homeassistant.components.diagnostics import async_redact_data as async_redact_data
 from homeassistant.const import CONF_UNIQUE_ID as CONF_UNIQUE_ID
 from homeassistant.core import HomeAssistant as HomeAssistant
 from typing import Any

homeassistant-stubs/components/roborock/image.pyi

@@ -1,7 +1,7 @@
 from . import RoborockConfigEntry as RoborockConfigEntry
 from .const import DEFAULT_DRAWABLES as DEFAULT_DRAWABLES, DOMAIN as DOMAIN, DRAWABLES as DRAWABLES, IMAGE_CACHE_INTERVAL as IMAGE_CACHE_INTERVAL, MAP_SLEEP as MAP_SLEEP
 from .coordinator import RoborockDataUpdateCoordinator as RoborockDataUpdateCoordinator
-from .device import RoborockCoordinatedEntityV1 as RoborockCoordinatedEntityV1
+from .entity import RoborockCoordinatedEntityV1 as RoborockCoordinatedEntityV1
 from _typeshed import Incomplete
 from datetime import datetime
 from homeassistant.components.image import ImageEntity as ImageEntity

homeassistant-stubs/components/roborock/number.pyi

@@ -1,12 +1,13 @@
-from . import RoborockConfigEntry as RoborockConfigEntry
+from . import DOMAIN as DOMAIN, RoborockConfigEntry as RoborockConfigEntry
 from .coordinator import RoborockDataUpdateCoordinator as RoborockDataUpdateCoordinator
-from .device import RoborockEntityV1 as RoborockEntityV1
+from .entity import RoborockEntityV1 as RoborockEntityV1
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable, Coroutine
 from dataclasses import dataclass
 from homeassistant.components.number import NumberEntity as NumberEntity, NumberEntityDescription as NumberEntityDescription
 from homeassistant.const import EntityCategory as EntityCategory, PERCENTAGE as PERCENTAGE
 from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from roborock.command_cache import CacheableAttribute
 from roborock.version_1_apis.roborock_client_v1 import AttributeCache as AttributeCache

homeassistant-stubs/components/roborock/select.pyi

@@ -1,6 +1,7 @@
 from . import RoborockConfigEntry as RoborockConfigEntry
+from .const import MAP_SLEEP as MAP_SLEEP
 from .coordinator import RoborockDataUpdateCoordinator as RoborockDataUpdateCoordinator
-from .device import RoborockCoordinatedEntityV1 as RoborockCoordinatedEntityV1
+from .entity import RoborockCoordinatedEntityV1 as RoborockCoordinatedEntityV1
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from dataclasses import dataclass

homeassistant-stubs/components/roborock/sensor.pyi

@@ -1,7 +1,7 @@
 import datetime
 from . import RoborockConfigEntry as RoborockConfigEntry
 from .coordinator import RoborockDataUpdateCoordinator as RoborockDataUpdateCoordinator, RoborockDataUpdateCoordinatorA01 as RoborockDataUpdateCoordinatorA01
-from .device import RoborockCoordinatedEntityA01 as RoborockCoordinatedEntityA01, RoborockCoordinatedEntityV1 as RoborockCoordinatedEntityV1
+from .entity import RoborockCoordinatedEntityA01 as RoborockCoordinatedEntityA01, RoborockCoordinatedEntityV1 as RoborockCoordinatedEntityV1
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from dataclasses import dataclass

homeassistant-stubs/components/roborock/switch.pyi

@@ -1,12 +1,13 @@
-from . import RoborockConfigEntry as RoborockConfigEntry
+from . import DOMAIN as DOMAIN, RoborockConfigEntry as RoborockConfigEntry
 from .coordinator import RoborockDataUpdateCoordinator as RoborockDataUpdateCoordinator
-from .device import RoborockEntityV1 as RoborockEntityV1
+from .entity import RoborockEntityV1 as RoborockEntityV1
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable, Coroutine
 from dataclasses import dataclass
 from homeassistant.components.switch import SwitchEntity as SwitchEntity, SwitchEntityDescription as SwitchEntityDescription
 from homeassistant.const import EntityCategory as EntityCategory
 from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from roborock.command_cache import CacheableAttribute
 from roborock.version_1_apis.roborock_client_v1 import AttributeCache as AttributeCache