homeassistant-stubs 2025.1.0b9__py3-none-any.whl → 2025.1.2__py3-none-any.whl

homeassistant-stubs/exceptions.pyi

@@ -36,13 +36,11 @@ class ConditionError(HomeAssistantError):
     def _indent(indent: int, message: str) -> str: ...
     def output(self, indent: int) -> Generator[str]: ...
     def __str__(self) -> str: ...
-    def __init__(self, type) -> None: ...
 
 @dataclass(slots=True)
 class ConditionErrorMessage(ConditionError):
     message: str
     def output(self, indent: int) -> Generator[str]: ...
-    def __init__(self, type, message) -> None: ...
 
 @dataclass(slots=True)
 class ConditionErrorIndex(ConditionError):
@@ -50,13 +48,11 @@ class ConditionErrorIndex(ConditionError):
     total: int
     error: ConditionError
     def output(self, indent: int) -> Generator[str]: ...
-    def __init__(self, type, index, total, error) -> None: ...
 
 @dataclass(slots=True)
 class ConditionErrorContainer(ConditionError):
     errors: Sequence[ConditionError]
     def output(self, indent: int) -> Generator[str]: ...
-    def __init__(self, type, errors) -> None: ...
 
 class IntegrationError(HomeAssistantError):
     def __str__(self) -> str: ...

homeassistant-stubs/helpers/area_registry.pyi

@@ -6,11 +6,12 @@ from .storage import Store as Store
 from .typing import UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
 from _typeshed import Incomplete
 from collections.abc import Iterable
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 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
+from propcache import cached_property as under_cached_property
 from typing import Any, Literal, TypedDict
 
 DATA_REGISTRY: HassKey[AreaRegistry]
@@ -43,18 +44,18 @@ class AreaEntry(NormalizedNameBaseRegistryEntry):
     floor_id: str | None
     icon: str | None
     id: str
-    labels: set[str] = ...
+    labels: set[str] = field(default_factory=set)
     picture: str | None
-    _cache: dict[str, Any] = ...
+    _cache: dict[str, Any] = field(default_factory=dict, compare=False, init=False)
+    @under_cached_property
     def json_fragment(self) -> json_fragment: ...
-    def __init__(self, *, name, created_at=..., modified_at=..., aliases, floor_id, icon, id, labels=..., picture) -> None: ...
 
 class AreaRegistryStore(Store[AreasRegistryStoreData]):
     async def _async_migrate_func(self, old_major_version: int, old_minor_version: int, old_data: dict[str, list[dict[str, Any]]]) -> AreasRegistryStoreData: ...
 
 class AreaRegistryItems(NormalizedNameBaseRegistryItems[AreaEntry]):
-    _labels_index: Incomplete
-    _floors_index: Incomplete
+    _labels_index: RegistryIndexType
+    _floors_index: RegistryIndexType
     def __init__(self) -> None: ...
     def _index_entry(self, key: str, entry: AreaEntry) -> None: ...
     def _unindex_entry(self, key: str, replacement_entry: AreaEntry | None = None) -> None: ...

homeassistant-stubs/helpers/category_registry.pyi

@@ -4,7 +4,7 @@ from .storage import Store as Store
 from .typing import UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
 from _typeshed import Incomplete
 from collections.abc import Iterable
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from datetime import datetime
 from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.util.dt import utc_from_timestamp as utc_from_timestamp, utcnow as utcnow
@@ -37,19 +37,18 @@ type EventCategoryRegistryUpdated = Event[EventCategoryRegistryUpdatedData]
 
 @dataclass(slots=True, kw_only=True, frozen=True)
 class CategoryEntry:
-    category_id: str = ...
-    created_at: datetime = ...
+    category_id: str = field(default_factory=ulid_now)
+    created_at: datetime = field(default_factory=utcnow)
     icon: str | None = ...
-    modified_at: datetime = ...
+    modified_at: datetime = field(default_factory=utcnow)
     name: str
-    def __init__(self, *, category_id=..., created_at=..., icon=..., modified_at=..., name) -> None: ...
 
 class CategoryRegistryStore(Store[CategoryRegistryStoreData]):
     async def _async_migrate_func(self, old_major_version: int, old_minor_version: int, old_data: dict[str, dict[str, list[dict[str, Any]]]]) -> CategoryRegistryStoreData: ...
 
 class CategoryRegistry(BaseRegistry[CategoryRegistryStoreData]):
     hass: Incomplete
-    categories: Incomplete
+    categories: dict[str, dict[str, CategoryEntry]]
     _store: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
     def async_get_category(self, *, scope: str, category_id: str) -> CategoryEntry | None: ...

homeassistant-stubs/helpers/check_config.pyi

@@ -1,5 +1,4 @@
 from .typing import ConfigType as ConfigType
-from _typeshed import Incomplete
 from collections import OrderedDict
 from homeassistant import loader as loader
 from homeassistant.config import CONF_PACKAGES as CONF_PACKAGES, YAML_CONFIG_FILE as YAML_CONFIG_FILE, config_per_platform as config_per_platform, extract_domain_configs as extract_domain_configs, format_homeassistant_error as format_homeassistant_error, format_schema_error as format_schema_error, load_yaml_config_file as load_yaml_config_file, merge_packages_config as merge_packages_config
@@ -15,8 +14,8 @@ class CheckConfigError(NamedTuple):
     config: ConfigType | None
 
 class HomeAssistantConfig(OrderedDict):
-    errors: Incomplete
-    warnings: Incomplete
+    errors: list[CheckConfigError]
+    warnings: list[CheckConfigError]
     def __init__(self) -> None: ...
     def add_error(self, message: str, domain: str | None = None, config: ConfigType | None = None) -> Self: ...
     @property

homeassistant-stubs/helpers/collection.pyi

@@ -31,7 +31,6 @@ class CollectionChange:
     item_id: str
     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]]
 
@@ -42,7 +41,7 @@ class ItemNotFound(CollectionError):
     def __init__(self, item_id: str) -> None: ...
 
 class IDManager:
-    collections: Incomplete
+    collections: list[dict[str, Any]]
     def __init__(self) -> None: ...
     def add_collection(self, collection: dict[str, Any]) -> None: ...
     def has_id(self, item_id: str) -> bool: ...
@@ -60,9 +59,9 @@ class CollectionEntity(Entity, metaclass=abc.ABCMeta):
 
 class ObservableCollection[_ItemT](ABC):
     id_manager: Incomplete
-    data: Incomplete
-    listeners: Incomplete
-    change_set_listeners: Incomplete
+    data: dict[str, _ItemT]
+    listeners: list[ChangeListener]
+    change_set_listeners: list[ChangeSetListener]
     def __init__(self, id_manager: IDManager | None) -> None: ...
     def async_items(self) -> list[_ItemT]: ...
     def async_add_listener(self, listener: ChangeListener) -> Callable[[], None]: ...
@@ -136,7 +135,6 @@ class _CollectionLifeCycle(Generic[_EntityT]):
     async def _remove_entity(self, change_set: CollectionChange) -> None: ...
     async def _update_entity(self, change_set: CollectionChange) -> None: ...
     async def _collection_changed(self, change_set: Iterable[CollectionChange]) -> None: ...
-    def __init__(self, domain, platform, entity_component, collection, entity_class, ent_reg, entities) -> None: ...
 
 def sync_entity_lifecycle(hass: HomeAssistant, domain: str, platform: str, entity_component: EntityComponent[_EntityT], collection: StorageCollection | YamlCollection, entity_class: type[CollectionEntity]) -> None: ...
 
@@ -146,8 +144,8 @@ class StorageCollectionWebsocket[_StorageCollectionT: StorageCollection]:
     model_name: Incomplete
     create_schema: Incomplete
     update_schema: Incomplete
-    _remove_subscription: Incomplete
-    _subscribers: Incomplete
+    _remove_subscription: CALLBACK_TYPE | None
+    _subscribers: set[tuple[websocket_api.ActiveConnection, int]]
     def __init__(self, storage_collection: _StorageCollectionT, api_prefix: str, model_name: str, create_schema: VolDictType, update_schema: VolDictType) -> None: ...
     @property
     def item_id_key(self) -> str: ...

homeassistant-stubs/helpers/config_entry_oauth2_flow.pyi

@@ -63,8 +63,8 @@ class LocalOAuth2Implementation(AbstractOAuth2Implementation):
 class AbstractOAuth2FlowHandler(config_entries.ConfigFlow, metaclass=ABCMeta):
     DOMAIN: str
     VERSION: int
-    external_data: Incomplete
-    flow_impl: Incomplete
+    external_data: Any
+    flow_impl: AbstractOAuth2Implementation
     def __init__(self) -> None: ...
     @property
     @abstractmethod

homeassistant-stubs/helpers/debounce.pyi

@@ -1,3 +1,4 @@
+import asyncio
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from homeassistant.core import HassJob as HassJob, HomeAssistant as HomeAssistant, callback as callback
@@ -9,11 +10,11 @@ class Debouncer[_R_co]:
     _function: Incomplete
     cooldown: Incomplete
     immediate: Incomplete
-    _timer_task: Incomplete
+    _timer_task: asyncio.TimerHandle | None
     _execute_at_end_of_timer: bool
     _execute_lock: Incomplete
     _background: Incomplete
-    _job: Incomplete
+    _job: HassJob[[], _R_co] | None
     _shutdown_requested: bool
     def __init__(self, hass: HomeAssistant, logger: Logger, *, cooldown: float, immediate: bool, function: Callable[[], _R_co] | None = None, background: bool = False) -> None: ...
     @property

homeassistant-stubs/helpers/device_registry.pyi

@@ -18,6 +18,7 @@ from homeassistant.util.dt import utc_from_timestamp as utc_from_timestamp, utcn
 from homeassistant.util.event_type import EventType as EventType
 from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.json import format_unserializable_data as format_unserializable_data
+from propcache import cached_property as under_cached_property
 from typing import Any, Literal, TypedDict
 from yarl import URL
 
@@ -128,7 +129,9 @@ class DeviceEntry:
     def disabled(self) -> bool: ...
     @property
     def dict_repr(self) -> dict[str, Any]: ...
+    @under_cached_property
     def json_repr(self) -> bytes | None: ...
+    @under_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, cache) -> None: ...
     def __lt__(self, other): ...
@@ -146,6 +149,7 @@ class DeletedDeviceEntry:
     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: ...
+    @under_cached_property
     def as_storage_fragment(self) -> json_fragment: ...
     def __init__(self, config_entries, connections, identifiers, id, orphaned_timestamp, created_at, modified_at, cache) -> None: ...
     def __lt__(self, other): ...
@@ -159,17 +163,17 @@ 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[_EntryTypeT: (DeviceEntry, DeletedDeviceEntry)](BaseRegistryItems[_EntryTypeT]):
-    _connections: Incomplete
-    _identifiers: Incomplete
+    _connections: dict[tuple[str, str], _EntryTypeT]
+    _identifiers: dict[tuple[str, str], _EntryTypeT]
     def __init__(self) -> None: ...
     def _index_entry(self, key: str, entry: _EntryTypeT) -> None: ...
     def _unindex_entry(self, key: str, replacement_entry: _EntryTypeT | None = None) -> None: ...
     def get_entry(self, identifiers: set[tuple[str, str]] | None, connections: set[tuple[str, str]] | None) -> _EntryTypeT | None: ...
 
 class ActiveDeviceRegistryItems(DeviceRegistryItems[DeviceEntry]):
-    _area_id_index: Incomplete
-    _config_entry_id_index: Incomplete
-    _labels_index: Incomplete
+    _area_id_index: RegistryIndexType
+    _config_entry_id_index: RegistryIndexType
+    _labels_index: RegistryIndexType
     def __init__(self) -> None: ...
     def _index_entry(self, key: str, entry: DeviceEntry) -> None: ...
     def _unindex_entry(self, key: str, replacement_entry: DeviceEntry | None = None) -> None: ...

homeassistant-stubs/helpers/discovery_flow.pyi

@@ -19,7 +19,6 @@ class DiscoveryKey:
     version: int
     @classmethod
     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: 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: ...
@@ -35,7 +34,7 @@ class PendingFlowValue(NamedTuple):
 class FlowDispatcher:
     hass: Incomplete
     started: bool
-    pending_flows: Incomplete
+    pending_flows: dict[PendingFlowKey, list[PendingFlowValue]]
     def __init__(self, hass: HomeAssistant) -> None: ...
     def async_setup(self) -> None: ...
     async def _async_start(self, event: Event) -> None: ...

homeassistant-stubs/helpers/dispatcher.pyi

@@ -12,22 +12,22 @@ 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[*_Ts](hass: HomeAssistant, signal: SignalType[Unpack[_Ts]], target: Callable[[Unpack[_Ts]], None]) -> Callable[[], None]: ...
+def dispatcher_connect[*_Ts](hass: HomeAssistant, signal: SignalType[*_Ts], target: Callable[[*_Ts], None]) -> Callable[[], None]: ...
 @overload
 def dispatcher_connect(hass: HomeAssistant, signal: str, target: Callable[..., None]) -> Callable[[], None]: ...
-def _async_remove_dispatcher[*_Ts](dispatchers: _DispatcherDataType[Unpack[_Ts]], signal: SignalType[Unpack[_Ts]] | str, target: Callable[[Unpack[_Ts]], Any] | Callable[..., Any]) -> None: ...
+def _async_remove_dispatcher[*_Ts](dispatchers: _DispatcherDataType[*_Ts], signal: SignalType[*_Ts] | str, target: Callable[[*_Ts], Any] | Callable[..., Any]) -> None: ...
 @overload
-def async_dispatcher_connect[*_Ts](hass: HomeAssistant, signal: SignalType[Unpack[_Ts]], target: Callable[[Unpack[_Ts]], Any]) -> Callable[[], None]: ...
+def async_dispatcher_connect[*_Ts](hass: HomeAssistant, signal: SignalType[*_Ts], target: Callable[[*_Ts], Any]) -> Callable[[], None]: ...
 @overload
 def async_dispatcher_connect(hass: HomeAssistant, signal: str, target: Callable[..., Any]) -> Callable[[], None]: ...
 @overload
-def dispatcher_send[*_Ts](hass: HomeAssistant, signal: SignalType[Unpack[_Ts]], *args: Unpack[_Ts]) -> None: ...
+def dispatcher_send[*_Ts](hass: HomeAssistant, signal: SignalType[*_Ts], *args: *_Ts) -> None: ...
 @overload
 def dispatcher_send(hass: HomeAssistant, signal: str, *args: Any) -> 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]: ...
+def _format_err[*_Ts](signal: SignalType[*_Ts] | str, target: Callable[[*_Ts], Any] | Callable[..., Any], *args: Any) -> str: ...
+def _generate_job[*_Ts](signal: SignalType[*_Ts] | str, target: Callable[[*_Ts], Any] | Callable[..., Any]) -> HassJob[..., Coroutine[Any, Any, None] | None]: ...
 @overload
-def async_dispatcher_send[*_Ts](hass: HomeAssistant, signal: SignalType[Unpack[_Ts]], *args: Unpack[_Ts]) -> None: ...
+def async_dispatcher_send[*_Ts](hass: HomeAssistant, signal: SignalType[*_Ts], *args: *_Ts) -> None: ...
 @overload
 def async_dispatcher_send(hass: HomeAssistant, signal: str, *args: Any) -> None: ...
-def async_dispatcher_send_internal[*_Ts](hass: HomeAssistant, signal: SignalType[Unpack[_Ts]] | str, *args: Unpack[_Ts]) -> None: ...
+def async_dispatcher_send_internal[*_Ts](hass: HomeAssistant, signal: SignalType[*_Ts] | str, *args: *_Ts) -> None: ...

homeassistant-stubs/helpers/entity.pyi

@@ -11,7 +11,7 @@ from _typeshed import Incomplete
 from abc import ABCMeta
 from collections import deque
 from collections.abc import Callable as Callable, Coroutine, Iterable, Mapping
-from enum import Enum
+from enum import Enum, IntFlag
 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
@@ -19,6 +19,7 @@ from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, I
 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
 from homeassistant.util.frozen_dataclass_compat import FrozenOrThawed as FrozenOrThawed
+from propcache import cached_property
 from typing import Any, Final, Literal, NotRequired, TypedDict
 
 timer = time.time
@@ -57,26 +58,23 @@ _SENTINEL: Incomplete
 
 class EntityDescription(frozen_or_thawed=True, metaclass=FrozenOrThawed):
     key: str
-    device_class: str | None
-    entity_category: EntityCategory | None
-    entity_registry_enabled_default: bool
-    entity_registry_visible_default: bool
-    force_update: bool
-    icon: str | None
-    has_entity_name: bool
-    name: str | UndefinedType | None
-    translation_key: str | None
-    translation_placeholders: Mapping[str, str] | None
-    unit_of_measurement: str | 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=...) -> None: ...
-    def __replace__(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=...) -> None: ...
+    device_class: str | None = ...
+    entity_category: EntityCategory | None = ...
+    entity_registry_enabled_default: bool = ...
+    entity_registry_visible_default: bool = ...
+    force_update: bool = ...
+    icon: str | None = ...
+    has_entity_name: bool = ...
+    name: str | UndefinedType | None = ...
+    translation_key: str | None = ...
+    translation_placeholders: Mapping[str, str] | None = ...
+    unit_of_measurement: str | None = ...
 
 @dataclasses.dataclass(frozen=True, slots=True)
 class CalculatedState:
     state: str
     attributes: dict[str, Any]
     capability_attributes: Mapping[str, Any] | None
-    def __init__(self, state, attributes, capability_attributes) -> None: ...
 
 class CachedProperties(type):
     def __new__(mcs, name: str, bases: tuple[type, ...], namespace: dict[Any, Any], cached_properties: set[str] | None = None, **kwargs: Any) -> Any: ...
@@ -140,40 +138,68 @@ 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: ...
+    @cached_property
     def _unit_of_measurement_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: ...
@@ -212,10 +238,9 @@ class Entity(cached_properties=CACHED_PROPERTIES_WITH_ATTR_, metaclass=ABCCached
     def __repr__(self) -> str: ...
     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: ...
 
-class ToggleEntityDescription(EntityDescription, frozen_or_thawed=True):
-    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=...) -> None: ...
-    def __replace__(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=...) -> None: ...
+class ToggleEntityDescription(EntityDescription, frozen_or_thawed=True): ...
 
 TOGGLE_ENTITY_CACHED_PROPERTIES_WITH_ATTR_: Incomplete
 
@@ -225,6 +250,7 @@ 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_component.pyi

@@ -26,11 +26,11 @@ class EntityComponent(Generic[_EntityT]):
     hass: Incomplete
     domain: Incomplete
     scan_interval: Incomplete
-    config: Incomplete
-    _platforms: Incomplete
+    config: ConfigType | None
+    _platforms: dict[str | tuple[str, timedelta | None, str | None], EntityPlatform]
     async_add_entities: Incomplete
     add_entities: Incomplete
-    _entities: Incomplete
+    _entities: dict[str, entity.Entity]
     def __init__(self, logger: logging.Logger, domain: str, hass: HomeAssistant, scan_interval: timedelta = ...) -> None: ...
     @property
     def entities(self) -> Iterable[_EntityT]: ...

homeassistant-stubs/helpers/entity_platform.pyi

@@ -48,19 +48,19 @@ class EntityPlatform:
     scan_interval: Incomplete
     scan_interval_seconds: Incomplete
     entity_namespace: Incomplete
-    config_entry: Incomplete
-    entities: Incomplete
-    component_translations: Incomplete
-    platform_translations: Incomplete
-    object_id_component_translations: Incomplete
-    object_id_platform_translations: Incomplete
-    default_language_platform_translations: Incomplete
-    _tasks: Incomplete
+    config_entry: config_entries.ConfigEntry | None
+    entities: dict[str, Entity]
+    component_translations: dict[str, str]
+    platform_translations: dict[str, str]
+    object_id_component_translations: dict[str, str]
+    object_id_platform_translations: dict[str, str]
+    default_language_platform_translations: dict[str, str]
+    _tasks: list[asyncio.Task[None]]
     _setup_complete: bool
-    _async_polling_timer: Incomplete
-    _async_cancel_retry_setup: Incomplete
-    _process_updates: Incomplete
-    parallel_updates: Incomplete
+    _async_polling_timer: asyncio.TimerHandle | None
+    _async_cancel_retry_setup: CALLBACK_TYPE | None
+    _process_updates: asyncio.Lock | None
+    parallel_updates: asyncio.Semaphore | None
     _update_in_sequence: bool
     parallel_updates_created: Incomplete
     domain_entities: Incomplete

homeassistant-stubs/helpers/entity_registry.pyi

@@ -19,6 +19,7 @@ from homeassistant.util.event_type import EventType as EventType
 from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.json import format_unserializable_data as format_unserializable_data
 from homeassistant.util.read_only_dict import ReadOnlyDict as ReadOnlyDict
+from propcache import cached_property as under_cached_property
 from typing import Any, Literal, NotRequired, TypedDict
 
 DATA_REGISTRY: HassKey[EntityRegistry]
@@ -99,10 +100,15 @@ class RegistryEntry:
     def hidden(self) -> bool: ...
     @property
     def _as_display_dict(self) -> dict[str, Any] | None: ...
+    @under_cached_property
     def display_json_repr(self) -> bytes | None: ...
+    @under_cached_property
     def as_partial_dict(self) -> dict[str, Any]: ...
+    @under_cached_property
     def extended_dict(self) -> dict[str, Any]: ...
+    @under_cached_property
     def partial_json_repr(self) -> bytes | None: ...
+    @under_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, cache) -> None: ...
@@ -123,6 +129,7 @@ class DeletedRegistryEntry:
     modified_at: datetime
     _cache: dict[str, Any]
     def _domain_default(self) -> str: ...
+    @under_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, cache) -> None: ...
     def __lt__(self, other): ...
@@ -134,12 +141,12 @@ class EntityRegistryStore(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: ...
 
 class EntityRegistryItems(BaseRegistryItems[RegistryEntry]):
-    _entry_ids: Incomplete
-    _index: Incomplete
-    _config_entry_id_index: Incomplete
-    _device_id_index: Incomplete
-    _area_id_index: Incomplete
-    _labels_index: Incomplete
+    _entry_ids: dict[str, RegistryEntry]
+    _index: dict[tuple[str, str, str], str]
+    _config_entry_id_index: RegistryIndexType
+    _device_id_index: RegistryIndexType
+    _area_id_index: RegistryIndexType
+    _labels_index: RegistryIndexType
     def __init__(self) -> None: ...
     def _index_entry(self, key: str, entry: RegistryEntry) -> None: ...
     def _unindex_entry(self, key: str, replacement_entry: RegistryEntry | None = None) -> None: ...

homeassistant-stubs/helpers/entityfilter.pyi

@@ -13,7 +13,7 @@ CONF_EXCLUDE_ENTITIES: str
 CONF_ENTITY_GLOBS: str
 
 class EntityFilter:
-    empty_filter: Incomplete
+    empty_filter: bool
     config: Incomplete
     _include_e: Incomplete
     _exclude_e: Incomplete

homeassistant-stubs/helpers/event.pyi

@@ -41,34 +41,29 @@ class _KeyedEventTracker(Generic[_TypedDictT]):
     event_type: EventType[_TypedDictT] | str
     dispatcher_callable: Callable[[HomeAssistant, dict[str, list[HassJob[[Event[_TypedDictT]], Any]]], Event[_TypedDictT]], None]
     filter_callable: Callable[[HomeAssistant, dict[str, list[HassJob[[Event[_TypedDictT]], Any]]], _TypedDictT], bool]
-    def __init__(self, key, event_type, dispatcher_callable, filter_callable) -> None: ...
 
 @dataclass(slots=True, frozen=True)
 class _KeyedEventData(Generic[_TypedDictT]):
     listener: CALLBACK_TYPE
     callbacks: defaultdict[str, list[HassJob[[Event[_TypedDictT]], Any]]]
-    def __init__(self, listener, callbacks) -> None: ...
 
 @dataclass(slots=True)
 class TrackStates:
     all_states: bool
     entities: set[str]
     domains: set[str]
-    def __init__(self, all_states, entities, domains) -> None: ...
 
 @dataclass(slots=True)
 class TrackTemplate:
     template: Template
     variables: TemplateVarsType
     rate_limit: float | None = ...
-    def __init__(self, template, variables, rate_limit=...) -> None: ...
 
 @dataclass(slots=True)
 class TrackTemplateResult:
     template: Template
     last_result: Any
     result: Any
-    def __init__(self, template, last_result, result) -> None: ...
 
 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: ...
@@ -120,8 +115,8 @@ class _TrackStateChangeFiltered:
     hass: Incomplete
     _action: Incomplete
     _action_as_hassjob: Incomplete
-    _listeners: Incomplete
-    _last_track_states: Incomplete
+    _listeners: dict[str, Callable[[], None]]
+    _last_track_states: TrackStates
     def __init__(self, hass: HomeAssistant, track_states: TrackStates, action: Callable[[Event[EventStateChangedData]], Any]) -> None: ...
     def async_setup(self) -> None: ...
     @property
@@ -144,11 +139,11 @@ class TrackTemplateResultInfo:
     _job: Incomplete
     _track_templates: Incomplete
     _has_super_template: Incomplete
-    _last_result: Incomplete
+    _last_result: dict[Template, bool | str | TemplateError]
     _rate_limit: Incomplete
-    _info: Incomplete
-    _track_state_changes: Incomplete
-    _time_listeners: Incomplete
+    _info: dict[Template, RenderInfo]
+    _track_state_changes: _TrackStateChangeFiltered | None
+    _time_listeners: dict[Template, Callable[[], None]]
     def __init__(self, hass: HomeAssistant, track_templates: Sequence[TrackTemplate], action: TrackTemplateResultListener, has_super_template: bool = False) -> None: ...
     def __repr__(self) -> str: ...
     def async_setup(self, strict: bool = False, log_fn: Callable[[int, str], None] | None = None) -> None: ...
@@ -184,7 +179,6 @@ class _TrackPointUTCTime:
     def async_attach(self) -> None: ...
     def __call__(self) -> None: ...
     def async_cancel(self) -> None: ...
-    def __init__(self, hass, job, utc_point_in_time, expected_fire_timestamp, _cancel_callback=...) -> None: ...
 
 def async_track_point_in_utc_time(hass: HomeAssistant, action: HassJob[[datetime], Coroutine[Any, Any, None] | None] | Callable[[datetime], Coroutine[Any, Any, None] | None], point_in_time: datetime) -> CALLBACK_TYPE: ...
 
@@ -210,7 +204,6 @@ class _TrackTimeInterval:
     def _schedule_timer(self) -> None: ...
     def _interval_listener(self, _: Any) -> None: ...
     def async_cancel(self) -> None: ...
-    def __init__(self, hass, seconds, job_name, action, cancel_on_shutdown, _track_job=..., _run_job=..., _timer_handle=...) -> None: ...
 
 def async_track_time_interval(hass: HomeAssistant, action: Callable[[datetime], Coroutine[Any, Any, None] | None], interval: timedelta, *, name: str | None = None, cancel_on_shutdown: bool | None = None) -> CALLBACK_TYPE: ...
 
@@ -229,7 +222,6 @@ class SunListener:
     def _listen_next_sun_event(self) -> None: ...
     def _handle_sun_event(self, _now: Any) -> None: ...
     def _handle_config_event(self, _event: Any) -> None: ...
-    def __init__(self, hass, job, event, offset, _unsub_sun=..., _unsub_config=...) -> None: ...
 
 def async_track_sunrise(hass: HomeAssistant, action: Callable[[], None], offset: timedelta | None = None) -> CALLBACK_TYPE: ...
 
@@ -255,7 +247,6 @@ class _TrackUTCTimeChange:
     def _calculate_next(self, utc_now: datetime) -> datetime: ...
     def _pattern_time_change_listener(self, _: datetime) -> None: ...
     def async_cancel(self) -> None: ...
-    def __init__(self, hass, time_match_expression, microsecond, local, job, listener_job_name, _pattern_time_change_listener_job=..., _cancel_callback=...) -> None: ...
 
 def async_track_utc_time_change(hass: HomeAssistant, action: Callable[[datetime], Coroutine[Any, Any, None] | None], hour: Any | None = None, minute: Any | None = None, second: Any | None = None, local: bool = False) -> CALLBACK_TYPE: ...