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

homeassistant-stubs/helpers/collection.pyi

@@ -8,7 +8,7 @@ from .storage import Store as Store
 from .typing import ConfigType as ConfigType, VolDictType as VolDictType
 from _typeshed import Incomplete
 from abc import ABC, abstractmethod
-from collections.abc import Callable, Iterable
+from collections.abc import Awaitable, Callable, Iterable
 from dataclasses import dataclass
 from homeassistant.components import websocket_api as websocket_api
 from homeassistant.const import CONF_ID as CONF_ID
@@ -32,6 +32,8 @@ class CollectionChange:
     item: Any
     item_hash: str | None = ...
     def __init__(self, change_type, item_id, item, item_hash=...) -> None: ...
+type ChangeListener = Callable[[str, str, dict], Awaitable[None]]
+type ChangeSetListener = Callable[[Iterable[CollectionChange]], Awaitable[None]]
 
 class CollectionError(HomeAssistantError): ...
 
@@ -56,7 +58,7 @@ class CollectionEntity(Entity, metaclass=abc.ABCMeta):
     @abstractmethod
     async def async_update_config(self, config: ConfigType) -> None: ...
 
-class ObservableCollection(ABC):
+class ObservableCollection[_ItemT](ABC):
     id_manager: Incomplete
     data: Incomplete
     listeners: Incomplete
@@ -77,7 +79,7 @@ class YamlCollection(ObservableCollection[dict]):
 class SerializedStorageCollection(TypedDict):
     items: list[dict[str, Any]]
 
-class StorageCollection(ObservableCollection[_ItemT], metaclass=abc.ABCMeta):
+class StorageCollection[_ItemT, _StoreT: SerializedStorageCollection](ObservableCollection[_ItemT], metaclass=abc.ABCMeta):
     store: Incomplete
     def __init__(self, store: Store[_StoreT], id_manager: IDManager | None = None) -> None: ...
     @staticmethod
@@ -138,7 +140,7 @@ class _CollectionLifeCycle(Generic[_EntityT]):
 
 def sync_entity_lifecycle(hass: HomeAssistant, domain: str, platform: str, entity_component: EntityComponent[_EntityT], collection: StorageCollection | YamlCollection, entity_class: type[CollectionEntity]) -> None: ...
 
-class StorageCollectionWebsocket:
+class StorageCollectionWebsocket[_StorageCollectionT: StorageCollection]:
     storage_collection: Incomplete
     api_prefix: Incomplete
     model_name: Incomplete

homeassistant-stubs/helpers/condition.pyi

@@ -25,6 +25,7 @@ class ConditionProtocol(Protocol):
     CONDITION_SCHEMA: vol.Schema
     async def async_validate_condition_config(self, hass: HomeAssistant, config: ConfigType) -> ConfigType: ...
     def async_condition_from_config(self, hass: HomeAssistant, config: ConfigType) -> ConditionCheckerType: ...
+type ConditionCheckerType = Callable[[HomeAssistant, TemplateVarsType], bool | None]
 
 def condition_trace_append(variables: TemplateVarsType, path: str) -> TraceElement: ...
 def condition_trace_set_result(result: bool, **kwargs: Any) -> None: ...

homeassistant-stubs/helpers/config_entry_flow.pyi

@@ -1,7 +1,7 @@
 from .service_info.mqtt import MqttServiceInfo as MqttServiceInfo
 from .typing import DiscoveryInfoType as DiscoveryInfoType
 from _typeshed import Incomplete
-from collections.abc import Awaitable
+from collections.abc import Awaitable, Callable
 from homeassistant import config_entries as config_entries
 from homeassistant.components import onboarding as onboarding
 from homeassistant.components.bluetooth import BluetoothServiceInfoBleak as BluetoothServiceInfoBleak
@@ -11,9 +11,10 @@ from homeassistant.components.zeroconf import ZeroconfServiceInfo as ZeroconfSer
 from homeassistant.core import HomeAssistant as HomeAssistant
 from typing import Any
 
+type DiscoveryFunctionType[_R] = Callable[[HomeAssistant], _R]
 _LOGGER: Incomplete
 
-class DiscoveryFlowHandler(config_entries.ConfigFlow):
+class DiscoveryFlowHandler[_R: Awaitable[bool] | bool](config_entries.ConfigFlow):
     VERSION: int
     _domain: Incomplete
     _title: Incomplete

homeassistant-stubs/helpers/config_validation.pyi

@@ -32,7 +32,7 @@ def _async_get_hass_or_none() -> HomeAssistant | None: ...
 
 _validating_async: ContextVar[bool]
 
-def not_async_friendly(validator: Callable[_P, _R]) -> Callable[_P, _R]: ...
+def not_async_friendly[**_P, _R](validator: Callable[_P, _R]) -> Callable[_P, _R]: ...
 
 class UrlProtocolSchema(StrEnum):
     HTTP = 'http'
@@ -64,9 +64,9 @@ def isdir(value: Any) -> str: ...
 @overload
 def ensure_list(value: None) -> list[Any]: ...
 @overload
-def ensure_list(value: list[_T]) -> list[_T]: ...
+def ensure_list[_T](value: list[_T]) -> list[_T]: ...
 @overload
-def ensure_list(value: list[_T] | _T) -> list[_T]: ...
+def ensure_list[_T](value: list[_T] | _T) -> list[_T]: ...
 def entity_id(value: Any) -> str: ...
 def entity_id_or_uuid(value: Any) -> str: ...
 def _entity_ids(value: str | list, allow_uuid: bool) -> list[str]: ...
@@ -96,13 +96,13 @@ def time_period_seconds(value: float | str) -> timedelta: ...
 
 time_period: Incomplete
 
-def match_all(value: _T) -> _T: ...
+def match_all[_T](value: _T) -> _T: ...
 def positive_timedelta(value: timedelta) -> timedelta: ...
 
 positive_time_period_dict: Incomplete
 positive_time_period: Incomplete
 
-def remove_falsy(value: list[_T]) -> list[_T]: ...
+def remove_falsy[_T](value: list[_T]) -> list[_T]: ...
 def service(value: Any) -> str: ...
 def slug(value: Any) -> str: ...
 def schema_with_slug_keys(value_schema: dict | Callable, *, slug_validator: Callable[[Any], str] = ...) -> Callable: ...
@@ -143,7 +143,7 @@ def _deprecated_or_removed(key: str, replacement_key: str | None, default: Any |
 def deprecated(key: str, replacement_key: str | None = None, default: Any | None = None, raise_if_present: bool | None = False) -> Callable[[dict], dict]: ...
 def removed(key: str, default: Any | None = None, raise_if_present: bool | None = True) -> Callable[[dict], dict]: ...
 def key_value_schemas(key: str, value_schemas: dict[Hashable, VolSchemaType | Callable[[Any], dict[str, Any]]], default_schema: VolSchemaType | None = None, default_description: str | None = None) -> Callable[[Any], dict[Hashable, Any]]: ...
-def key_dependency(key: Hashable, dependency: Hashable) -> Callable[[dict[_KT, _VT]], dict[_KT, _VT]]: ...
+def key_dependency[_KT: Hashable, _VT](key: Hashable, dependency: Hashable) -> Callable[[dict[_KT, _VT]], dict[_KT, _VT]]: ...
 def custom_serializer(schema: Any) -> Any: ...
 def _custom_serializer(schema: Any, *, allow_section: bool) -> Any: ...
 def expand_condition_shorthand(value: Any | None) -> Any: ...

homeassistant-stubs/helpers/data_entry_flow.pyi

@@ -6,7 +6,7 @@ from homeassistant.components.http.data_validator import RequestDataValidator as
 from typing import Any, Generic
 from typing_extensions import TypeVar
 
-_FlowManagerT = TypeVar('_FlowManagerT', bound=data_entry_flow.FlowManager[Any], default=data_entry_flow.FlowManager)
+_FlowManagerT = TypeVar('_FlowManagerT', bound=data_entry_flow.FlowManager[Any, Any], default=data_entry_flow.FlowManager)
 
 class _BaseFlowManagerView(HomeAssistantView, Generic[_FlowManagerT]):
     _flow_mgr: Incomplete

homeassistant-stubs/helpers/debounce.pyi

@@ -3,7 +3,7 @@ from collections.abc import Callable as Callable
 from homeassistant.core import HassJob as HassJob, HomeAssistant as HomeAssistant, callback as callback
 from logging import Logger
 
-class Debouncer:
+class Debouncer[_R_co]:
     hass: Incomplete
     logger: Incomplete
     _function: Incomplete

homeassistant-stubs/helpers/deprecation.pyi

@@ -1,15 +1,16 @@
 import functools
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
-from enum import Enum
+from enum import Enum, EnumType, _EnumDict
 from typing import Any, NamedTuple
 
-def deprecated_substitute(substitute_name: str) -> Callable[[Callable[[_ObjectT], Any]], Callable[[_ObjectT], Any]]: ...
+def deprecated_substitute[_ObjectT: object](substitute_name: str) -> Callable[[Callable[[_ObjectT], Any]], Callable[[_ObjectT], Any]]: ...
 def get_deprecated(config: dict[str, Any], new_name: str, old_name: str, default: Any | None = None) -> Any | None: ...
-def deprecated_class(replacement: str, *, breaks_in_ha_version: str | None = None) -> Callable[[Callable[_P, _R]], Callable[_P, _R]]: ...
-def deprecated_function(replacement: str, *, breaks_in_ha_version: str | None = None) -> Callable[[Callable[_P, _R]], Callable[_P, _R]]: ...
+def deprecated_class[**_P, _R](replacement: str, *, breaks_in_ha_version: str | None = None) -> Callable[[Callable[_P, _R]], Callable[_P, _R]]: ...
+def deprecated_function[**_P, _R](replacement: str, *, breaks_in_ha_version: str | None = None) -> Callable[[Callable[_P, _R]], Callable[_P, _R]]: ...
 def _print_deprecation_warning(obj: Any, replacement: str, description: str, verb: str, breaks_in_ha_version: str | None) -> None: ...
 def _print_deprecation_warning_internal(obj_name: str, module_name: str, replacement: str, description: str, verb: str, breaks_in_ha_version: str | None, *, log_when_no_integration_is_found: bool) -> None: ...
+def _print_deprecation_warning_internal_impl(obj_name: str, module_name: str, replacement: str, description: str, verb: str, breaks_in_ha_version: str | None, *, log_when_no_integration_is_found: bool) -> None: ...
 
 class DeprecatedConstant(NamedTuple):
     value: Any
@@ -38,3 +39,7 @@ _PREFIX_DEPRECATED: str
 def check_if_deprecated_constant(name: str, module_globals: dict[str, Any]) -> Any: ...
 def dir_with_deprecated_constants(module_globals_keys: list[str]) -> list[str]: ...
 def all_with_deprecated_constants(module_globals: dict[str, Any]) -> list[str]: ...
+
+class EnumWithDeprecatedMembers(EnumType):
+    def __new__(mcs, cls: str, bases: tuple[type, ...], classdict: _EnumDict, *, deprecated: dict[str, tuple[str, str]], **kwds: Any) -> Any: ...
+    def __getattribute__(cls, name: str) -> Any: ...

homeassistant-stubs/helpers/device_registry.pyi

@@ -10,7 +10,6 @@ from _typeshed import Incomplete
 from collections.abc import Mapping
 from datetime import datetime
 from enum import StrEnum
-from functools import cached_property as cached_property
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import EVENT_HOMEASSISTANT_STARTED as EVENT_HOMEASSISTANT_STARTED, EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP
 from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant, ReleaseChannel as ReleaseChannel, callback as callback, get_release_channel as get_release_channel
@@ -81,6 +80,7 @@ class _EventDeviceRegistryUpdatedData_Update(TypedDict):
     action: Literal['update']
     device_id: str
     changes: dict[str, Any]
+type EventDeviceRegistryUpdatedData = _EventDeviceRegistryUpdatedData_CreateRemove | _EventDeviceRegistryUpdatedData_Update
 
 class DeviceEntryType(StrEnum):
     SERVICE = 'service'
@@ -128,15 +128,14 @@ class DeviceEntry:
     sw_version: str | None
     via_device_id: str | None
     is_new: bool
+    _cache: dict[str, Any]
     @property
     def disabled(self) -> bool: ...
     @property
     def dict_repr(self) -> dict[str, Any]: ...
-    @cached_property
     def json_repr(self) -> bytes | None: ...
-    @cached_property
     def as_storage_fragment(self) -> json_fragment: ...
-    def __init__(self, area_id, config_entries, configuration_url, connections, created_at, disabled_by, entry_type, hw_version, id, identifiers, labels, manufacturer, model, model_id, modified_at, name_by_user, name, primary_config_entry, serial_number, suggested_area, sw_version, via_device_id, is_new) -> None: ...
+    def __init__(self, area_id, config_entries, configuration_url, connections, created_at, disabled_by, entry_type, hw_version, id, identifiers, labels, manufacturer, model, model_id, modified_at, name_by_user, name, primary_config_entry, serial_number, suggested_area, sw_version, via_device_id, is_new, cache) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...
@@ -150,10 +149,10 @@ class DeletedDeviceEntry:
     orphaned_timestamp: float | None
     created_at: datetime
     modified_at: datetime
+    _cache: dict[str, Any]
     def to_device_entry(self, config_entry_id: str, connections: set[tuple[str, str]], identifiers: set[tuple[str, str]]) -> DeviceEntry: ...
-    @cached_property
     def as_storage_fragment(self) -> json_fragment: ...
-    def __init__(self, config_entries, connections, identifiers, id, orphaned_timestamp, created_at, modified_at) -> None: ...
+    def __init__(self, config_entries, connections, identifiers, id, orphaned_timestamp, created_at, modified_at, cache) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...
@@ -164,7 +163,7 @@ def format_mac(mac: str) -> str: ...
 class DeviceRegistryStore(storage.Store[dict[str, list[dict[str, Any]]]]):
     async def _async_migrate_func(self, old_major_version: int, old_minor_version: int, old_data: dict[str, list[dict[str, Any]]]) -> dict[str, Any]: ...
 
-class DeviceRegistryItems(BaseRegistryItems[_EntryTypeT]):
+class DeviceRegistryItems[_EntryTypeT: (DeviceEntry, DeletedDeviceEntry)](BaseRegistryItems[_EntryTypeT]):
     _connections: Incomplete
     _identifiers: Incomplete
     def __init__(self) -> None: ...
@@ -195,7 +194,7 @@ class DeviceRegistry(BaseRegistry[dict[str, list[dict[str, Any]]]]):
     def _async_get_deleted_device(self, identifiers: set[tuple[str, str]], connections: set[tuple[str, str]]) -> DeletedDeviceEntry | None: ...
     def _substitute_name_placeholders(self, domain: str, name: str, translation_placeholders: Mapping[str, str]) -> str: ...
     def async_get_or_create(self, *, config_entry_id: str, configuration_url: str | URL | None | UndefinedType = ..., connections: set[tuple[str, str]] | None | UndefinedType = ..., created_at: str | datetime | UndefinedType = ..., default_manufacturer: str | None | UndefinedType = ..., default_model: str | None | UndefinedType = ..., default_name: str | None | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., identifiers: set[tuple[str, str]] | None | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., model: str | None | UndefinedType = ..., model_id: str | None | UndefinedType = ..., modified_at: str | datetime | UndefinedType = ..., name: str | None | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., translation_key: str | None = None, translation_placeholders: Mapping[str, str] | None = None, via_device: tuple[str, str] | None | UndefinedType = ...) -> DeviceEntry: ...
-    def async_update_device(self, device_id: str, *, add_config_entry: ConfigEntry | UndefinedType = ..., add_config_entry_id: str | UndefinedType = ..., allow_collisions: bool = False, area_id: str | None | UndefinedType = ..., configuration_url: str | URL | None | UndefinedType = ..., device_info_type: str | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., labels: set[str] | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., merge_connections: set[tuple[str, str]] | UndefinedType = ..., merge_identifiers: set[tuple[str, str]] | UndefinedType = ..., model: str | None | UndefinedType = ..., model_id: str | None | UndefinedType = ..., name_by_user: str | None | UndefinedType = ..., name: str | None | UndefinedType = ..., new_connections: set[tuple[str, str]] | UndefinedType = ..., new_identifiers: set[tuple[str, str]] | UndefinedType = ..., remove_config_entry_id: str | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., via_device_id: str | None | UndefinedType = ...) -> DeviceEntry | None: ...
+    def async_update_device(self, device_id: str, *, add_config_entry_id: str | UndefinedType = ..., allow_collisions: bool = False, area_id: str | None | UndefinedType = ..., configuration_url: str | URL | None | UndefinedType = ..., device_info_type: str | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., labels: set[str] | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., merge_connections: set[tuple[str, str]] | UndefinedType = ..., merge_identifiers: set[tuple[str, str]] | UndefinedType = ..., model: str | None | UndefinedType = ..., model_id: str | None | UndefinedType = ..., name_by_user: str | None | UndefinedType = ..., name: str | None | UndefinedType = ..., new_connections: set[tuple[str, str]] | UndefinedType = ..., new_identifiers: set[tuple[str, str]] | UndefinedType = ..., remove_config_entry_id: str | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., via_device_id: str | None | UndefinedType = ...) -> DeviceEntry | None: ...
     def _validate_connections(self, device_id: str, connections: set[tuple[str, str]], allow_collisions: bool) -> set[tuple[str, str]]: ...
     def _validate_identifiers(self, device_id: str, identifiers: set[tuple[str, str]], allow_collisions: bool) -> set[tuple[str, str]]: ...
     def async_remove_device(self, device_id: str) -> None: ...

homeassistant-stubs/helpers/discovery_flow.pyi

@@ -1,7 +1,7 @@
 import dataclasses
 from _typeshed import Incomplete
 from collections.abc import Coroutine
-from homeassistant.config_entries import ConfigFlowResult as ConfigFlowResult
+from homeassistant.config_entries import ConfigFlowContext as ConfigFlowContext, ConfigFlowResult as ConfigFlowResult
 from homeassistant.const import EVENT_HOMEASSISTANT_STARTED as EVENT_HOMEASSISTANT_STARTED
 from homeassistant.core import CoreState as CoreState, Event as Event, HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.loader import bind_hass as bind_hass
@@ -21,15 +21,15 @@ class DiscoveryKey:
     def from_json_dict(cls, json_dict: dict[str, Any]) -> Self: ...
     def __init__(self, *, domain, key, version) -> None: ...
 
-def async_create_flow(hass: HomeAssistant, domain: str, context: dict[str, Any], data: Any, *, discovery_key: DiscoveryKey | None = None) -> None: ...
-def _async_init_flow(hass: HomeAssistant, domain: str, context: dict[str, Any], data: Any) -> Coroutine[None, None, ConfigFlowResult] | None: ...
+def async_create_flow(hass: HomeAssistant, domain: str, context: ConfigFlowContext, data: Any, *, discovery_key: DiscoveryKey | None = None) -> None: ...
+def _async_init_flow(hass: HomeAssistant, domain: str, context: ConfigFlowContext, data: Any) -> Coroutine[None, None, ConfigFlowResult] | None: ...
 
 class PendingFlowKey(NamedTuple):
     domain: str
     source: str
 
 class PendingFlowValue(NamedTuple):
-    context: dict[str, Any]
+    context: ConfigFlowContext
     data: Any
 
 class FlowDispatcher:
@@ -39,4 +39,4 @@ class FlowDispatcher:
     def __init__(self, hass: HomeAssistant) -> None: ...
     def async_setup(self) -> None: ...
     async def _async_start(self, event: Event) -> None: ...
-    def async_create(self, domain: str, context: dict[str, Any], data: Any) -> None: ...
+    def async_create(self, domain: str, context: ConfigFlowContext, data: Any) -> None: ...

homeassistant-stubs/helpers/dispatcher.pyi

@@ -9,24 +9,25 @@ from typing import Any, overload
 
 _LOGGER: Incomplete
 DATA_DISPATCHER: str
+type _DispatcherDataType[*_Ts] = dict[SignalType[*_Ts] | str, dict[Callable[[*_Ts], Any] | Callable[..., Any], HassJob[..., None | Coroutine[Any, Any, None]] | None]]
 
 @overload
-def dispatcher_connect(hass: HomeAssistant, signal: SignalType[Unpack[_Ts]], target: Callable[[Unpack[_Ts]], None]) -> Callable[[], None]: ...
+def dispatcher_connect[*_Ts](hass: HomeAssistant, signal: SignalType[Unpack[_Ts]], target: Callable[[Unpack[_Ts]], None]) -> Callable[[], None]: ...
 @overload
 def dispatcher_connect(hass: HomeAssistant, signal: str, target: Callable[..., None]) -> Callable[[], None]: ...
-def _async_remove_dispatcher(dispatchers: _DispatcherDataType[Unpack[_Ts]], signal: SignalType[Unpack[_Ts]] | str, target: Callable[[Unpack[_Ts]], Any] | Callable[..., Any]) -> None: ...
+def _async_remove_dispatcher[*_Ts](dispatchers: _DispatcherDataType[Unpack[_Ts]], signal: SignalType[Unpack[_Ts]] | str, target: Callable[[Unpack[_Ts]], Any] | Callable[..., Any]) -> None: ...
 @overload
-def async_dispatcher_connect(hass: HomeAssistant, signal: SignalType[Unpack[_Ts]], target: Callable[[Unpack[_Ts]], Any]) -> Callable[[], None]: ...
+def async_dispatcher_connect[*_Ts](hass: HomeAssistant, signal: SignalType[Unpack[_Ts]], target: Callable[[Unpack[_Ts]], Any]) -> Callable[[], None]: ...
 @overload
 def async_dispatcher_connect(hass: HomeAssistant, signal: str, target: Callable[..., Any]) -> Callable[[], None]: ...
 @overload
-def dispatcher_send(hass: HomeAssistant, signal: SignalType[Unpack[_Ts]], *args: Unpack[_Ts]) -> None: ...
+def dispatcher_send[*_Ts](hass: HomeAssistant, signal: SignalType[Unpack[_Ts]], *args: Unpack[_Ts]) -> None: ...
 @overload
 def dispatcher_send(hass: HomeAssistant, signal: str, *args: Any) -> None: ...
-def _format_err(signal: SignalType[Unpack[_Ts]] | str, target: Callable[[Unpack[_Ts]], Any] | Callable[..., Any], *args: Any) -> str: ...
-def _generate_job(signal: SignalType[Unpack[_Ts]] | str, target: Callable[[Unpack[_Ts]], Any] | Callable[..., Any]) -> HassJob[..., Coroutine[Any, Any, None] | None]: ...
+def _format_err[*_Ts](signal: SignalType[Unpack[_Ts]] | str, target: Callable[[Unpack[_Ts]], Any] | Callable[..., Any], *args: Any) -> str: ...
+def _generate_job[*_Ts](signal: SignalType[Unpack[_Ts]] | str, target: Callable[[Unpack[_Ts]], Any] | Callable[..., Any]) -> HassJob[..., Coroutine[Any, Any, None] | None]: ...
 @overload
-def async_dispatcher_send(hass: HomeAssistant, signal: SignalType[Unpack[_Ts]], *args: Unpack[_Ts]) -> None: ...
+def async_dispatcher_send[*_Ts](hass: HomeAssistant, signal: SignalType[Unpack[_Ts]], *args: Unpack[_Ts]) -> None: ...
 @overload
 def async_dispatcher_send(hass: HomeAssistant, signal: str, *args: Any) -> None: ...
-def async_dispatcher_send_internal(hass: HomeAssistant, signal: SignalType[Unpack[_Ts]] | str, *args: Unpack[_Ts]) -> None: ...
+def async_dispatcher_send_internal[*_Ts](hass: HomeAssistant, signal: SignalType[Unpack[_Ts]] | str, *args: Unpack[_Ts]) -> None: ...

homeassistant-stubs/helpers/entity.pyi

@@ -12,10 +12,9 @@ from abc import ABCMeta
 from collections import deque
 from collections.abc import Callable as Callable, Coroutine, Iterable, Mapping
 from enum import Enum, IntFlag
-from functools import cached_property as cached_property
-from homeassistant.config import DATA_CUSTOMIZE as DATA_CUSTOMIZE
 from homeassistant.const import ATTR_ASSUMED_STATE as ATTR_ASSUMED_STATE, ATTR_ATTRIBUTION as ATTR_ATTRIBUTION, ATTR_DEVICE_CLASS as ATTR_DEVICE_CLASS, ATTR_ENTITY_PICTURE as ATTR_ENTITY_PICTURE, ATTR_FRIENDLY_NAME as ATTR_FRIENDLY_NAME, ATTR_ICON as ATTR_ICON, ATTR_SUPPORTED_FEATURES as ATTR_SUPPORTED_FEATURES, ATTR_UNIT_OF_MEASUREMENT as ATTR_UNIT_OF_MEASUREMENT, DEVICE_DEFAULT_NAME as DEVICE_DEFAULT_NAME, EntityCategory as EntityCategory, STATE_OFF as STATE_OFF, STATE_ON as STATE_ON, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN
 from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Context as Context, Event as Event, HassJobType as HassJobType, HomeAssistant as HomeAssistant, ReleaseChannel as ReleaseChannel, callback as callback, get_hassjob_callable_job_type as get_hassjob_callable_job_type, get_release_channel as get_release_channel
+from homeassistant.core_config import DATA_CUSTOMIZE as DATA_CUSTOMIZE
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, InvalidStateError as InvalidStateError, NoEntitySpecifiedError as NoEntitySpecifiedError
 from homeassistant.loader import async_suggest_report_issue as async_suggest_report_issue, bind_hass as bind_hass
 from homeassistant.util import ensure_unique_string as ensure_unique_string, slugify as slugify
@@ -141,66 +140,39 @@ class Entity(cached_properties=CACHED_PROPERTIES_WITH_ATTR_, metaclass=ABCCached
     _attr_unit_of_measurement: str | None
     def __init_subclass__(cls, **kwargs: Any) -> None: ...
     def get_hassjob_type(self, function_name: str) -> HassJobType: ...
-    @cached_property
     def should_poll(self) -> bool: ...
-    @cached_property
     def unique_id(self) -> str | None: ...
-    @cached_property
     def use_device_name(self) -> bool: ...
-    @cached_property
     def has_entity_name(self) -> bool: ...
     def _device_class_name_helper(self, component_translations: dict[str, str]) -> str | None: ...
-    @cached_property
     def _object_id_device_class_name(self) -> str | None: ...
-    @cached_property
     def _device_class_name(self) -> str | None: ...
     def _default_to_device_class_name(self) -> bool: ...
-    @cached_property
     def _name_translation_key(self) -> str | None: ...
     def _substitute_name_placeholders(self, name: str) -> str: ...
     def _name_internal(self, device_class_name: str | None, platform_translations: dict[str, str]) -> str | UndefinedType | None: ...
     @property
     def suggested_object_id(self) -> str | None: ...
-    @cached_property
     def name(self) -> str | UndefinedType | None: ...
-    @cached_property
     def state(self) -> StateType: ...
-    @cached_property
     def capability_attributes(self) -> dict[str, Any] | None: ...
     def get_initial_entity_options(self) -> er.EntityOptionsType | None: ...
-    @cached_property
     def state_attributes(self) -> dict[str, Any] | None: ...
-    @cached_property
     def extra_state_attributes(self) -> Mapping[str, Any] | None: ...
-    @cached_property
     def device_info(self) -> DeviceInfo | None: ...
-    @cached_property
     def device_class(self) -> str | None: ...
-    @cached_property
     def unit_of_measurement(self) -> str | None: ...
-    @cached_property
     def icon(self) -> str | None: ...
-    @cached_property
     def entity_picture(self) -> str | None: ...
-    @cached_property
     def available(self) -> bool: ...
-    @cached_property
     def assumed_state(self) -> bool: ...
-    @cached_property
     def force_update(self) -> bool: ...
-    @cached_property
     def supported_features(self) -> int | None: ...
-    @cached_property
     def entity_registry_enabled_default(self) -> bool: ...
-    @cached_property
     def entity_registry_visible_default(self) -> bool: ...
-    @cached_property
     def attribution(self) -> str | None: ...
-    @cached_property
     def entity_category(self) -> EntityCategory | None: ...
-    @cached_property
     def translation_key(self) -> str | None: ...
-    @cached_property
     def translation_placeholders(self) -> Mapping[str, str]: ...
     @property
     def enabled(self) -> bool: ...
@@ -237,7 +209,7 @@ class Entity(cached_properties=CACHED_PROPERTIES_WITH_ATTR_, metaclass=ABCCached
     def _async_device_registry_updated(self, event: Event[EventDeviceRegistryUpdatedData]) -> None: ...
     def _async_subscribe_device_updates(self) -> None: ...
     def __repr__(self) -> str: ...
-    async def async_request_call(self, coro: Coroutine[Any, Any, _T]) -> _T: ...
+    async def async_request_call[_T](self, coro: Coroutine[Any, Any, _T]) -> _T: ...
     def _suggest_report_issue(self) -> str: ...
     def _report_deprecated_supported_features_values(self, replacement: IntFlag) -> None: ...
 
@@ -253,7 +225,6 @@ class ToggleEntity(Entity, cached_properties=TOGGLE_ENTITY_CACHED_PROPERTIES_WIT
     _attr_state: None
     @property
     def state(self) -> Literal['on', 'off'] | None: ...
-    @cached_property
     def is_on(self) -> bool | None: ...
     def turn_on(self, **kwargs: Any) -> None: ...
     async def async_turn_on(self, **kwargs: Any) -> None: ...

homeassistant-stubs/helpers/entity_registry.pyi

@@ -8,7 +8,6 @@ from _typeshed import Incomplete
 from collections.abc import Callable as Callable, Container, Hashable, KeysView, Mapping
 from datetime import datetime
 from enum import StrEnum
-from functools import cached_property as cached_property
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import ATTR_DEVICE_CLASS as ATTR_DEVICE_CLASS, ATTR_FRIENDLY_NAME as ATTR_FRIENDLY_NAME, ATTR_ICON as ATTR_ICON, ATTR_RESTORED as ATTR_RESTORED, ATTR_SUPPORTED_FEATURES as ATTR_SUPPORTED_FEATURES, ATTR_UNIT_OF_MEASUREMENT as ATTR_UNIT_OF_MEASUREMENT, EVENT_HOMEASSISTANT_START as EVENT_HOMEASSISTANT_START, EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP, EntityCategory as EntityCategory, MAX_LENGTH_STATE_DOMAIN as MAX_LENGTH_STATE_DOMAIN, MAX_LENGTH_STATE_ENTITY_ID as MAX_LENGTH_STATE_ENTITY_ID, Platform as Platform, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN
 from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant, callback as callback, split_entity_id as split_entity_id, valid_entity_id as valid_entity_id
@@ -54,6 +53,9 @@ class _EventEntityRegistryUpdatedData_Update(TypedDict):
     entity_id: str
     changes: dict[str, Any]
     old_entity_id: NotRequired[str]
+type EventEntityRegistryUpdatedData = _EventEntityRegistryUpdatedData_CreateRemove | _EventEntityRegistryUpdatedData_Update
+type EntityOptionsType = Mapping[str, Mapping[str, Any]]
+type ReadOnlyEntityOptionsType = ReadOnlyDict[str, ReadOnlyDict[str, Any]]
 
 DISPLAY_DICT_OPTIONAL: Incomplete
 
@@ -89,6 +91,7 @@ class RegistryEntry:
     supported_features: int
     translation_key: str | None
     unit_of_measurement: str | None
+    _cache: dict[str, Any]
     def _domain_default(self) -> str: ...
     @property
     def disabled(self) -> bool: ...
@@ -96,18 +99,13 @@ class RegistryEntry:
     def hidden(self) -> bool: ...
     @property
     def _as_display_dict(self) -> dict[str, Any] | None: ...
-    @cached_property
     def display_json_repr(self) -> bytes | None: ...
-    @cached_property
     def as_partial_dict(self) -> dict[str, Any]: ...
-    @cached_property
     def extended_dict(self) -> dict[str, Any]: ...
-    @cached_property
     def partial_json_repr(self) -> bytes | None: ...
-    @cached_property
     def as_storage_fragment(self) -> json_fragment: ...
     def write_unavailable_state(self, hass: HomeAssistant) -> None: ...
-    def __init__(self, entity_id, unique_id, platform, previous_unique_id, aliases, area_id, categories, capabilities, config_entry_id, created_at, device_class, device_id, domain, disabled_by, entity_category, hidden_by, icon, id, has_entity_name, labels, modified_at, name, options, original_device_class, original_icon, original_name, supported_features, translation_key, unit_of_measurement) -> None: ...
+    def __init__(self, entity_id, unique_id, platform, previous_unique_id, aliases, area_id, categories, capabilities, config_entry_id, created_at, device_class, device_id, domain, disabled_by, entity_category, hidden_by, icon, id, has_entity_name, labels, modified_at, name, options, original_device_class, original_icon, original_name, supported_features, translation_key, unit_of_measurement, cache) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...
@@ -123,10 +121,10 @@ class DeletedRegistryEntry:
     orphaned_timestamp: float | None
     created_at: datetime
     modified_at: datetime
+    _cache: dict[str, Any]
     def _domain_default(self) -> str: ...
-    @cached_property
     def as_storage_fragment(self) -> json_fragment: ...
-    def __init__(self, entity_id, unique_id, platform, config_entry_id, domain, id, orphaned_timestamp, created_at, modified_at) -> None: ...
+    def __init__(self, entity_id, unique_id, platform, config_entry_id, domain, id, orphaned_timestamp, created_at, modified_at, cache) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...

homeassistant-stubs/helpers/event.pyi

@@ -71,7 +71,7 @@ class TrackTemplateResult:
     result: Any
     def __init__(self, template, last_result, result) -> None: ...
 
-def threaded_listener_factory(async_factory: Callable[Concatenate[HomeAssistant, _P], Any]) -> Callable[Concatenate[HomeAssistant, _P], CALLBACK_TYPE]: ...
+def threaded_listener_factory[**_P](async_factory: Callable[Concatenate[HomeAssistant, _P], Any]) -> Callable[Concatenate[HomeAssistant, _P], CALLBACK_TYPE]: ...
 def async_track_state_change(hass: HomeAssistant, entity_ids: str | Iterable[str], action: Callable[[str, State | None, State | None], Coroutine[Any, Any, None] | None], from_state: str | Iterable[str] | None = None, to_state: str | Iterable[str] | None = None) -> CALLBACK_TYPE: ...
 
 track_state_change: Incomplete
@@ -164,6 +164,7 @@ class TrackTemplateResultInfo:
     def _super_template_as_boolean(result: bool | str | TemplateError) -> bool: ...
     def _apply_update(self, updates: list[TrackTemplateResult], update: bool | TrackTemplateResult, template: Template) -> bool: ...
     def _refresh(self, event: Event[EventStateChangedData] | None, track_templates: Iterable[TrackTemplate] | None = None, replayed: bool | None = False) -> None: ...
+type TrackTemplateResultListener = Callable[[Event[EventStateChangedData] | None, list[TrackTemplateResult]], Coroutine[Any, Any, None] | None]
 
 def async_track_template_result(hass: HomeAssistant, track_templates: Sequence[TrackTemplate], action: TrackTemplateResultListener, strict: bool = False, log_fn: Callable[[int, str], None] | None = None, has_super_template: bool = False) -> TrackTemplateResultInfo: ...
 def async_track_same_state(hass: HomeAssistant, period: timedelta, action: Callable[[], Coroutine[Any, Any, None] | None], async_check_same_func: Callable[[str, State | None, State | None], bool], entity_ids: str | Iterable[str] = ...) -> CALLBACK_TYPE: ...

homeassistant-stubs/helpers/floor_registry.pyi

@@ -1,4 +1,4 @@
-from .normalized_name_base_registry import NormalizedNameBaseRegistryEntry as NormalizedNameBaseRegistryEntry, NormalizedNameBaseRegistryItems as NormalizedNameBaseRegistryItems, normalize_name as normalize_name
+from .normalized_name_base_registry import NormalizedNameBaseRegistryEntry as NormalizedNameBaseRegistryEntry, NormalizedNameBaseRegistryItems as NormalizedNameBaseRegistryItems
 from .registry import BaseRegistry as BaseRegistry
 from .singleton import singleton as singleton
 from .storage import Store as Store
@@ -7,7 +7,6 @@ from _typeshed import Incomplete
 from collections.abc import Iterable
 from dataclasses import dataclass
 from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant, callback as callback
-from homeassistant.util import slugify as slugify
 from homeassistant.util.dt import utc_from_timestamp as utc_from_timestamp, utcnow as utcnow
 from homeassistant.util.event_type import EventType as EventType
 from homeassistant.util.hass_dict import HassKey as HassKey
@@ -34,6 +33,7 @@ class FloorRegistryStoreData(TypedDict):
 class EventFloorRegistryUpdatedData(TypedDict):
     action: Literal['create', 'remove', 'update']
     floor_id: str
+type EventFloorRegistryUpdated = Event[EventFloorRegistryUpdatedData]
 
 @dataclass(slots=True, kw_only=True, frozen=True)
 class FloorEntry(NormalizedNameBaseRegistryEntry):
@@ -41,7 +41,7 @@ class FloorEntry(NormalizedNameBaseRegistryEntry):
     floor_id: str
     icon: str | None = ...
     level: int | None = ...
-    def __init__(self, *, name, normalized_name, created_at=..., modified_at=..., aliases, floor_id, icon=..., level=...) -> None: ...
+    def __init__(self, *, name, created_at=..., modified_at=..., aliases, floor_id, icon=..., level=...) -> None: ...
 
 class FloorRegistryStore(Store[FloorRegistryStoreData]):
     async def _async_migrate_func(self, old_major_version: int, old_minor_version: int, old_data: dict[str, list[dict[str, Any]]]) -> FloorRegistryStoreData: ...

homeassistant-stubs/helpers/frame.pyi

@@ -2,7 +2,6 @@ import logging
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from dataclasses import dataclass
-from functools import cached_property as cached_property
 from homeassistant.core import async_get_hass_or_none as async_get_hass_or_none
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.loader import async_suggest_report_issue as async_suggest_report_issue
@@ -18,11 +17,8 @@ class IntegrationFrame:
     module: str | None
     relative_filename: str
     frame: FrameType
-    @cached_property
     def line_number(self) -> int: ...
-    @cached_property
     def filename(self) -> str: ...
-    @cached_property
     def line(self) -> str: ...
     def __init__(self, *, custom_integration, integration, module, relative_filename, frame) -> None: ...
 
@@ -34,5 +30,5 @@ class MissingIntegrationFrame(HomeAssistantError): ...
 
 def report(what: str, *, exclude_integrations: set[str] | None = None, error_if_core: bool = True, error_if_integration: bool = False, level: int = ..., log_custom_component_only: bool = False) -> None: ...
 def _report_integration(what: str, integration_frame: IntegrationFrame, level: int = ..., error: bool = False) -> None: ...
-def warn_use(func: _CallableT, what: str) -> _CallableT: ...
+def warn_use[_CallableT: Callable](func: _CallableT, what: str) -> _CallableT: ...
 def report_non_thread_safe_operation(what: str) -> None: ...

homeassistant-stubs/helpers/hassio.pyi

@@ -0,0 +1,4 @@
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+
+def is_hassio(hass: HomeAssistant) -> bool: ...
+def get_supervisor_ip() -> str | None: ...

homeassistant-stubs/helpers/http.pyi

@@ -3,6 +3,7 @@ from _typeshed import Incomplete
 from aiohttp import web
 from aiohttp.typedefs import LooseHeaders as LooseHeaders
 from aiohttp.web import AppKey, Request as Request
+from aiohttp.web_urldispatcher import AbstractResource, AbstractRoute
 from collections.abc import Awaitable, Callable
 from contextvars import ContextVar
 from homeassistant import exceptions as exceptions
@@ -13,6 +14,7 @@ from http import HTTPStatus
 from typing import Any, Final
 
 _LOGGER: Incomplete
+type AllowCorsType = Callable[[AbstractRoute | AbstractResource], None]
 KEY_AUTHENTICATED: Final[str]
 KEY_ALLOW_ALL_CORS: Incomplete
 KEY_ALLOW_CONFIGURED_CORS: Incomplete

homeassistant-stubs/helpers/intent.pyi

@@ -5,10 +5,9 @@ from . import area_registry as area_registry, device_registry as device_registry
 from .typing import VolSchemaType as VolSchemaType
 from _typeshed import Incomplete
 from abc import abstractmethod
-from collections.abc import Collection, Iterable
+from collections.abc import Callable, Collection, Iterable
 from dataclasses import dataclass
 from enum import Enum, StrEnum
-from functools import cached_property as cached_property
 from homeassistant.components.homeassistant.exposed_entities import async_should_expose as async_should_expose
 from homeassistant.const import ATTR_DEVICE_CLASS as ATTR_DEVICE_CLASS, ATTR_ENTITY_ID as ATTR_ENTITY_ID, ATTR_SUPPORTED_FEATURES as ATTR_SUPPORTED_FEATURES
 from homeassistant.core import Context as Context, HomeAssistant as HomeAssistant, State as State, callback as callback
@@ -18,6 +17,8 @@ from homeassistant.util.hass_dict import HassKey as HassKey
 from typing import Any
 
 _LOGGER: Incomplete
+type _SlotsType = dict[str, Any]
+type _IntentSlotsType = dict[str | tuple[str, str], VolSchemaType | Callable[[Any], Any]]
 INTENT_TURN_OFF: str
 INTENT_TURN_ON: str
 INTENT_TOGGLE: str
@@ -33,6 +34,7 @@ INTENT_UNPAUSE_TIMER: str
 INTENT_TIMER_STATUS: str
 INTENT_GET_CURRENT_DATE: str
 INTENT_GET_CURRENT_TIME: str
+INTENT_RESPOND: str
 SLOT_SCHEMA: Incomplete
 DATA_KEY: HassKey[dict[str, IntentHandler]]
 SPEECH_TYPE_PLAIN: str
@@ -111,12 +113,13 @@ class NoStatesMatchedError(MatchFailedError):
 @dataclass
 class MatchTargetsCandidate:
     state: State
+    is_exposed: bool
     entity: entity_registry.RegistryEntry | None = ...
     area: area_registry.AreaEntry | None = ...
     floor: floor_registry.FloorEntry | None = ...
     device: device_registry.DeviceEntry | None = ...
     matched_name: str | None = ...
-    def __init__(self, state, entity=..., area=..., floor=..., device=..., matched_name=...) -> None: ...
+    def __init__(self, state, is_exposed, entity=..., area=..., floor=..., device=..., matched_name=...) -> None: ...
 
 def find_areas(name: str, areas: area_registry.AreaRegistry) -> Iterable[area_registry.AreaEntry]: ...
 def find_floors(name: str, floors: floor_registry.FloorRegistry) -> Iterable[floor_registry.FloorEntry]: ...
@@ -137,7 +140,6 @@ class IntentHandler:
     def slot_schema(self) -> dict | None: ...
     def async_can_handle(self, intent_obj: Intent) -> bool: ...
     def async_validate_slots(self, slots: _SlotsType) -> _SlotsType: ...
-    @cached_property
     def _slot_schema(self) -> vol.Schema: ...
     async def async_handle(self, intent_obj: Intent) -> IntentResponse: ...
     def __repr__(self) -> str: ...
@@ -157,7 +159,6 @@ class DynamicServiceIntentHandler(IntentHandler, metaclass=abc.ABCMeta):
     required_slots: Incomplete
     optional_slots: Incomplete
     def __init__(self, intent_type: str, speech: str | None = None, required_slots: _IntentSlotsType | None = None, optional_slots: _IntentSlotsType | None = None, required_domains: set[str] | None = None, required_features: int | None = None, required_states: set[str] | None = None, description: str | None = None, platforms: set[str] | None = None, device_classes: set[type[StrEnum]] | None = None) -> None: ...
-    @cached_property
     def slot_schema(self) -> dict: ...
     @abstractmethod
     def get_domain_and_service(self, intent_obj: Intent, state: State) -> tuple[str, str]: ...

homeassistant-stubs/helpers/json.pyi

@@ -29,6 +29,9 @@ def json_bytes_strip_null(data: Any) -> bytes: ...
 json_fragment = orjson.Fragment
 
 def json_dumps(data: Any) -> str: ...
+
+json_bytes_sorted: Incomplete
+
 def json_dumps_sorted(data: Any) -> str: ...
 
 JSON_DUMP: Final[Incomplete]