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

homeassistant-stubs/helpers/entity.pyi

@@ -20,7 +20,7 @@ from homeassistant.loader import async_suggest_report_issue as async_suggest_rep
 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
+from typing import Any, Final, Literal, NotRequired, TypedDict, final
 
 timer = time.time
 _LOGGER: Incomplete
@@ -30,9 +30,13 @@ FLOAT_PRECISION: Incomplete
 CAPABILITIES_UPDATE_LIMIT: int
 CONTEXT_RECENT_TIME_SECONDS: int
 
+@callback
 def async_setup(hass: HomeAssistant) -> None: ...
+@callback
+@bind_hass
 def entity_sources(hass: HomeAssistant) -> dict[str, EntityInfo]: ...
 def generate_entity_id(entity_id_format: str, name: str | None, current_ids: list[str] | None = None, hass: HomeAssistant | None = None) -> str: ...
+@callback
 def async_generate_entity_id(entity_id_format: str, name: str | None, current_ids: Iterable[str] | None = None, hass: HomeAssistant | None = None) -> str: ...
 def get_capability(hass: HomeAssistant, entity_id: str, capability: str) -> Any | None: ...
 def get_device_class(hass: HomeAssistant, entity_id: str) -> str | None: ...
@@ -69,14 +73,12 @@ class EntityDescription(frozen_or_thawed=True, metaclass=FrozenOrThawed):
     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: ...
 
 @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: ...
@@ -201,49 +203,68 @@ class Entity(cached_properties=CACHED_PROPERTIES_WITH_ATTR_, metaclass=ABCCached
     def entity_category(self) -> EntityCategory | None: ...
     @cached_property
     def translation_key(self) -> str | None: ...
+    @final
     @cached_property
     def translation_placeholders(self) -> Mapping[str, str]: ...
     @property
     def enabled(self) -> bool: ...
+    @callback
     def async_set_context(self, context: Context) -> None: ...
     async def async_update_ha_state(self, force_refresh: bool = False) -> None: ...
+    @callback
     def _async_verify_state_writable(self) -> None: ...
+    @callback
     def _async_write_ha_state_from_call_soon_threadsafe(self) -> None: ...
+    @callback
     def async_write_ha_state(self) -> None: ...
     def _stringify_state(self, available: bool) -> str: ...
     def _friendly_name_internal(self) -> str | None: ...
+    @callback
     def _async_calculate_state(self) -> CalculatedState: ...
     def __async_calculate_state(self) -> tuple[str, dict[str, Any], Mapping[str, Any] | None, str | None, int | None]: ...
+    @callback
     def _async_write_ha_state(self) -> None: ...
     def schedule_update_ha_state(self, force_refresh: bool = False) -> None: ...
+    @callback
     def async_schedule_update_ha_state(self, force_refresh: bool = False) -> None: ...
+    @callback
     def _async_slow_update_warning(self) -> None: ...
     async def async_device_update(self, warning: bool = True) -> None: ...
+    @callback
     def async_on_remove(self, func: CALLBACK_TYPE) -> None: ...
     async def async_removed_from_registry(self) -> None: ...
+    @callback
     def add_to_platform_start(self, hass: HomeAssistant, platform: EntityPlatform, parallel_updates: asyncio.Semaphore | None) -> None: ...
     def _call_on_remove_callbacks(self) -> None: ...
+    @callback
     def add_to_platform_abort(self) -> None: ...
     async def add_to_platform_finish(self) -> None: ...
+    @final
     async def async_remove(self, *, force_remove: bool = False) -> None: ...
+    @final
     async def __async_remove_impl(self, force_remove: bool) -> None: ...
     async def async_added_to_hass(self) -> None: ...
     async def async_will_remove_from_hass(self) -> None: ...
+    @callback
     def async_registry_entry_updated(self) -> None: ...
     async def async_internal_added_to_hass(self) -> None: ...
     async def async_internal_will_remove_from_hass(self) -> None: ...
+    @callback
     def _async_registry_updated(self, event: Event[er.EventEntityRegistryUpdatedData]) -> None: ...
     async def _async_process_registry_update_or_remove(self, event: Event[er.EventEntityRegistryUpdatedData]) -> None: ...
+    @callback
     def _async_unsubscribe_device_updates(self) -> None: ...
+    @callback
     def _async_device_registry_updated(self, event: Event[EventDeviceRegistryUpdatedData]) -> None: ...
+    @callback
     def _async_subscribe_device_updates(self) -> None: ...
     def __repr__(self) -> str: ...
     async def async_request_call[_T](self, coro: Coroutine[Any, Any, _T]) -> _T: ...
     def _suggest_report_issue(self) -> str: ...
+    @callback
     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: ...
+class ToggleEntityDescription(EntityDescription, frozen_or_thawed=True): ...
 
 TOGGLE_ENTITY_CACHED_PROPERTIES_WITH_ATTR_: Incomplete
 
@@ -252,6 +273,7 @@ class ToggleEntity(Entity, cached_properties=TOGGLE_ENTITY_CACHED_PROPERTIES_WIT
     _attr_is_on: bool | None
     _attr_state: None
     @property
+    @final
     def state(self) -> Literal['on', 'off'] | None: ...
     @cached_property
     def is_on(self) -> bool | None: ...
@@ -259,5 +281,6 @@ class ToggleEntity(Entity, cached_properties=TOGGLE_ENTITY_CACHED_PROPERTIES_WIT
     async def async_turn_on(self, **kwargs: Any) -> None: ...
     def turn_off(self, **kwargs: Any) -> None: ...
     async def async_turn_off(self, **kwargs: Any) -> None: ...
+    @final
     def toggle(self, **kwargs: Any) -> None: ...
     async def async_toggle(self, **kwargs: Any) -> None: ...

homeassistant-stubs/helpers/entity_component.pyi

@@ -19,6 +19,7 @@ DEFAULT_SCAN_INTERVAL: Incomplete
 DATA_INSTANCES: str
 _EntityT = TypeVar('_EntityT', bound=entity.Entity, default=entity.Entity)
 
+@bind_hass
 async def async_update_entity(hass: HomeAssistant, entity_id: str) -> None: ...
 
 class EntityComponent(Generic[_EntityT]):
@@ -42,11 +43,15 @@ class EntityComponent(Generic[_EntityT]):
     async def async_setup_entry(self, config_entry: ConfigEntry) -> bool: ...
     async def async_unload_entry(self, config_entry: ConfigEntry) -> bool: ...
     async def async_extract_from_service(self, service_call: ServiceCall, expand_group: bool = True) -> list[_EntityT]: ...
+    @callback
     def async_register_legacy_entity_service(self, name: str, schema: VolDictType | VolSchemaType, func: str | Callable[..., Any], required_features: list[int] | None = None, supports_response: SupportsResponse = ...) -> None: ...
+    @callback
     def async_register_entity_service(self, name: str, schema: VolDictType | VolSchemaType | None, func: str | Callable[..., Any], required_features: list[int] | None = None, supports_response: SupportsResponse = ...) -> None: ...
     async def async_setup_platform(self, platform_type: str, platform_config: ConfigType, discovery_info: DiscoveryInfoType | None = None) -> None: ...
     async def _async_reset(self) -> None: ...
     async def async_remove_entity(self, entity_id: str) -> None: ...
     async def async_prepare_reload(self, *, skip_reset: bool = False) -> ConfigType | None: ...
+    @callback
     def _async_init_entity_platform(self, platform_type: str, platform: ModuleType | None, scan_interval: timedelta | None = None, entity_namespace: str | None = None) -> EntityPlatform: ...
+    @callback
     def _async_shutdown(self, event: Event) -> None: ...

homeassistant-stubs/helpers/entity_platform.pyi

@@ -67,34 +67,45 @@ class EntityPlatform:
     domain_platform_entities: Incomplete
     def __init__(self, *, hass: HomeAssistant, logger: Logger, domain: str, platform_name: str, platform: EntityPlatformModule | None, scan_interval: timedelta, entity_namespace: str | None) -> None: ...
     def __repr__(self) -> str: ...
+    @callback
     def _get_parallel_updates_semaphore(self, entity_has_sync_update: bool) -> asyncio.Semaphore | None: ...
     async def async_setup(self, platform_config: ConfigType, discovery_info: DiscoveryInfoType | None = None) -> None: ...
+    @callback
     def async_shutdown(self) -> None: ...
+    @callback
     def async_cancel_retry_setup(self) -> None: ...
     async def async_setup_entry(self, config_entry: config_entries.ConfigEntry) -> bool: ...
     async def _async_setup_platform(self, async_create_setup_awaitable: Callable[[], Awaitable[None]], tries: int = 0) -> bool: ...
     async def _async_get_translations(self, language: str, category: str, integration: str) -> dict[str, str]: ...
     async def async_load_translations(self) -> None: ...
     def _schedule_add_entities(self, new_entities: Iterable[Entity], update_before_add: bool = False) -> None: ...
+    @callback
     def _async_schedule_add_entities(self, new_entities: Iterable[Entity], update_before_add: bool = False) -> None: ...
+    @callback
     def _async_schedule_add_entities_for_entry(self, new_entities: Iterable[Entity], update_before_add: bool = False) -> None: ...
     def add_entities(self, new_entities: Iterable[Entity], update_before_add: bool = False) -> None: ...
     async def _async_add_and_update_entities(self, coros: list[Coroutine[Any, Any, None]], entities: list[Entity], timeout: float) -> None: ...
     async def _async_add_entities(self, coros: list[Coroutine[Any, Any, None]], entities: list[Entity], timeout: float) -> None: ...
     async def async_add_entities(self, new_entities: Iterable[Entity], update_before_add: bool = False) -> None: ...
+    @callback
     def _async_handle_interval_callback(self) -> None: ...
     def _entity_id_already_exists(self, entity_id: str) -> tuple[bool, bool]: ...
     async def _async_add_entity(self, entity: Entity, update_before_add: bool, entity_registry: EntityRegistry) -> None: ...
     async def async_reset(self) -> None: ...
+    @callback
     def async_unsub_polling(self) -> None: ...
+    @callback
     def async_prepare(self) -> None: ...
     async def async_destroy(self) -> None: ...
     async def async_remove_entity(self, entity_id: str) -> None: ...
     async def async_extract_from_service(self, service_call: ServiceCall, expand_group: bool = True) -> list[Entity]: ...
+    @callback
     def async_register_entity_service(self, name: str, schema: VolDictType | VolSchemaType | None, func: str | Callable[..., Any], required_features: Iterable[int] | None = None, supports_response: SupportsResponse = ...) -> None: ...
     async def _async_update_entity_states(self) -> None: ...
 
 current_platform: ContextVar[EntityPlatform | None]
 
+@callback
 def async_get_current_platform() -> EntityPlatform: ...
+@callback
 def async_get_platforms(hass: HomeAssistant, integration_name: str) -> list[EntityPlatform]: ...

homeassistant-stubs/helpers/entity_registry.pyi

@@ -93,6 +93,7 @@ class RegistryEntry:
     translation_key: str | None
     unit_of_measurement: str | None
     _cache: dict[str, Any]
+    @domain.default
     def _domain_default(self) -> str: ...
     @property
     def disabled(self) -> bool: ...
@@ -110,6 +111,7 @@ class RegistryEntry:
     def partial_json_repr(self) -> bytes | None: ...
     @under_cached_property
     def as_storage_fragment(self) -> json_fragment: ...
+    @callback
     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: ...
     def __lt__(self, other): ...
@@ -128,6 +130,7 @@ class DeletedRegistryEntry:
     created_at: datetime
     modified_at: datetime
     _cache: dict[str, Any]
+    @domain.default
     def _domain_default(self) -> str: ...
     @under_cached_property
     def as_storage_fragment(self) -> json_fragment: ...
@@ -167,38 +170,68 @@ class EntityRegistry(BaseRegistry):
     hass: Incomplete
     _store: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
+    @callback
     def async_is_registered(self, entity_id: str) -> bool: ...
+    @callback
     def async_get(self, entity_id_or_uuid: str) -> RegistryEntry | None: ...
+    @callback
     def async_get_entity_id(self, domain: str, platform: str, unique_id: str) -> str | None: ...
+    @callback
     def async_device_ids(self) -> list[str]: ...
     def _entity_id_available(self, entity_id: str, known_object_ids: Container[str] | None) -> bool: ...
+    @callback
     def async_generate_entity_id(self, domain: str, suggested_object_id: str, known_object_ids: Container[str] | None = None) -> str: ...
+    @callback
     def async_get_or_create(self, domain: str, platform: str, unique_id: str, *, known_object_ids: Container[str] | None = None, suggested_object_id: str | None = None, disabled_by: RegistryEntryDisabler | None = None, hidden_by: RegistryEntryHider | None = None, get_initial_options: Callable[[], EntityOptionsType | None] | None = None, capabilities: Mapping[str, Any] | None | UndefinedType = ..., config_entry: ConfigEntry | None | UndefinedType = ..., device_id: str | None | UndefinedType = ..., entity_category: EntityCategory | UndefinedType | None = ..., has_entity_name: bool | UndefinedType = ..., original_device_class: str | None | UndefinedType = ..., original_icon: str | None | UndefinedType = ..., original_name: str | None | UndefinedType = ..., supported_features: int | None | UndefinedType = ..., translation_key: str | None | UndefinedType = ..., unit_of_measurement: str | None | UndefinedType = ...) -> RegistryEntry: ...
+    @callback
     def async_remove(self, entity_id: str) -> None: ...
+    @callback
     def async_device_modified(self, event: Event[EventDeviceRegistryUpdatedData]) -> None: ...
+    @callback
     def _async_update_entity(self, entity_id: str, *, aliases: set[str] | UndefinedType = ..., area_id: str | None | UndefinedType = ..., categories: dict[str, str] | UndefinedType = ..., capabilities: Mapping[str, Any] | None | UndefinedType = ..., config_entry_id: str | None | UndefinedType = ..., device_class: str | None | UndefinedType = ..., device_id: str | None | UndefinedType = ..., disabled_by: RegistryEntryDisabler | None | UndefinedType = ..., entity_category: EntityCategory | None | UndefinedType = ..., hidden_by: RegistryEntryHider | None | UndefinedType = ..., icon: str | None | UndefinedType = ..., has_entity_name: bool | UndefinedType = ..., labels: set[str] | UndefinedType = ..., name: str | None | UndefinedType = ..., new_entity_id: str | UndefinedType = ..., new_unique_id: str | UndefinedType = ..., options: EntityOptionsType | UndefinedType = ..., original_device_class: str | None | UndefinedType = ..., original_icon: str | None | UndefinedType = ..., original_name: str | None | UndefinedType = ..., platform: str | None | UndefinedType = ..., supported_features: int | UndefinedType = ..., translation_key: str | None | UndefinedType = ..., unit_of_measurement: str | None | UndefinedType = ...) -> RegistryEntry: ...
+    @callback
     def async_update_entity(self, entity_id: str, *, aliases: set[str] | UndefinedType = ..., area_id: str | None | UndefinedType = ..., categories: dict[str, str] | UndefinedType = ..., capabilities: Mapping[str, Any] | None | UndefinedType = ..., config_entry_id: str | None | UndefinedType = ..., device_class: str | None | UndefinedType = ..., device_id: str | None | UndefinedType = ..., disabled_by: RegistryEntryDisabler | None | UndefinedType = ..., entity_category: EntityCategory | None | UndefinedType = ..., hidden_by: RegistryEntryHider | None | UndefinedType = ..., icon: str | None | UndefinedType = ..., has_entity_name: bool | UndefinedType = ..., labels: set[str] | UndefinedType = ..., name: str | None | UndefinedType = ..., new_entity_id: str | UndefinedType = ..., new_unique_id: str | UndefinedType = ..., original_device_class: str | None | UndefinedType = ..., original_icon: str | None | UndefinedType = ..., original_name: str | None | UndefinedType = ..., supported_features: int | UndefinedType = ..., translation_key: str | None | UndefinedType = ..., unit_of_measurement: str | None | UndefinedType = ...) -> RegistryEntry: ...
+    @callback
     def async_update_entity_platform(self, entity_id: str, new_platform: str, *, new_config_entry_id: str | UndefinedType = ..., new_unique_id: str | UndefinedType = ..., new_device_id: str | None | UndefinedType = ...) -> RegistryEntry: ...
+    @callback
     def async_update_entity_options(self, entity_id: str, domain: str, options: Mapping[str, Any] | None) -> RegistryEntry: ...
     async def async_load(self) -> None: ...
+    @callback
     def _data_to_save(self) -> dict[str, Any]: ...
+    @callback
     def async_clear_category_id(self, scope: str, category_id: str) -> None: ...
+    @callback
     def async_clear_label_id(self, label_id: str) -> None: ...
+    @callback
     def async_clear_config_entry(self, config_entry_id: str) -> None: ...
+    @callback
     def async_purge_expired_orphaned_entities(self) -> None: ...
+    @callback
     def async_clear_area_id(self, area_id: str) -> None: ...
 
+@callback
 def async_get(hass: HomeAssistant) -> EntityRegistry: ...
 async def async_load(hass: HomeAssistant) -> None: ...
+@callback
 def async_entries_for_device(registry: EntityRegistry, device_id: str, include_disabled_entities: bool = False) -> list[RegistryEntry]: ...
+@callback
 def async_entries_for_area(registry: EntityRegistry, area_id: str) -> list[RegistryEntry]: ...
+@callback
 def async_entries_for_label(registry: EntityRegistry, label_id: str) -> list[RegistryEntry]: ...
+@callback
 def async_entries_for_category(registry: EntityRegistry, scope: str, category_id: str) -> list[RegistryEntry]: ...
+@callback
 def async_entries_for_config_entry(registry: EntityRegistry, config_entry_id: str) -> list[RegistryEntry]: ...
+@callback
 def async_config_entry_disabled_by_changed(registry: EntityRegistry, config_entry: ConfigEntry) -> None: ...
+@callback
 def _async_setup_cleanup(hass: HomeAssistant, registry: EntityRegistry) -> None: ...
+@callback
 def _async_setup_entity_restore(hass: HomeAssistant, registry: EntityRegistry) -> None: ...
 async def async_migrate_entries(hass: HomeAssistant, config_entry_id: str, entry_callback: Callable[[RegistryEntry], dict[str, Any] | None]) -> None: ...
+@callback
 def async_validate_entity_id(registry: EntityRegistry, entity_id_or_uuid: str) -> str: ...
+@callback
 def async_resolve_entity_id(registry: EntityRegistry, entity_id_or_uuid: str) -> str | None: ...
+@callback
 def async_validate_entity_ids(registry: EntityRegistry, entity_ids_or_uuids: list[str]) -> list[str]: ...

homeassistant-stubs/helpers/event.pyi

@@ -41,79 +41,97 @@ 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]: ...
+@callback
+@bind_hass
 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
 
+@bind_hass
 def async_track_state_change_event(hass: HomeAssistant, entity_ids: str | Iterable[str], action: Callable[[Event[EventStateChangedData]], Any], job_type: HassJobType | None = None) -> CALLBACK_TYPE: ...
+@callback
 def _async_dispatch_entity_id_event_soon[_StateEventDataT: EventStateEventData](hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[_StateEventDataT]], Any]]], event: Event[_StateEventDataT]) -> None: ...
+@callback
 def _async_dispatch_entity_id_event[_StateEventDataT: EventStateEventData](hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[_StateEventDataT]], Any]]], event: Event[_StateEventDataT]) -> None: ...
+@callback
 def _async_state_filter[_StateEventDataT: EventStateEventData](hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[_StateEventDataT]], Any]]], event_data: _StateEventDataT) -> bool: ...
 
 _KEYED_TRACK_STATE_CHANGE: Incomplete
 
+@bind_hass
 def _async_track_state_change_event(hass: HomeAssistant, entity_ids: str | Iterable[str], action: Callable[[Event[EventStateChangedData]], Any], job_type: HassJobType | None) -> CALLBACK_TYPE: ...
 
 _KEYED_TRACK_STATE_REPORT: Incomplete
 
 def async_track_state_report_event(hass: HomeAssistant, entity_ids: str | Iterable[str], action: Callable[[Event[EventStateReportedData]], Any], job_type: HassJobType | None = None) -> CALLBACK_TYPE: ...
+@callback
 def _remove_empty_listener() -> None: ...
+@callback
 def _remove_listener(hass: HomeAssistant, tracker: _KeyedEventTracker[_TypedDictT], keys: Iterable[str], job: HassJob[[Event[_TypedDictT]], Any], callbacks: dict[str, list[HassJob[[Event[_TypedDictT]], Any]]]) -> None: ...
 def _async_track_event(tracker: _KeyedEventTracker[_TypedDictT], hass: HomeAssistant, keys: str | Iterable[str], action: Callable[[Event[_TypedDictT]], None], job_type: HassJobType | None) -> CALLBACK_TYPE: ...
+@callback
 def _async_dispatch_old_entity_id_or_entity_id_event(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[EventEntityRegistryUpdatedData]], Any]]], event: Event[EventEntityRegistryUpdatedData]) -> None: ...
+@callback
 def _async_entity_registry_updated_filter(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[EventEntityRegistryUpdatedData]], Any]]], event_data: EventEntityRegistryUpdatedData) -> bool: ...
 
 _KEYED_TRACK_ENTITY_REGISTRY_UPDATED: Incomplete
 
+@bind_hass
+@callback
 def async_track_entity_registry_updated_event(hass: HomeAssistant, entity_ids: str | Iterable[str], action: Callable[[Event[EventEntityRegistryUpdatedData]], Any], job_type: HassJobType | None = None) -> CALLBACK_TYPE: ...
+@callback
 def _async_device_registry_updated_filter(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[EventDeviceRegistryUpdatedData]], Any]]], event_data: EventDeviceRegistryUpdatedData) -> bool: ...
+@callback
 def _async_dispatch_device_id_event(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[EventDeviceRegistryUpdatedData]], Any]]], event: Event[EventDeviceRegistryUpdatedData]) -> None: ...
 
 _KEYED_TRACK_DEVICE_REGISTRY_UPDATED: Incomplete
 
+@callback
 def async_track_device_registry_updated_event(hass: HomeAssistant, device_ids: str | Iterable[str], action: Callable[[Event[EventDeviceRegistryUpdatedData]], Any], job_type: HassJobType | None = None) -> CALLBACK_TYPE: ...
+@callback
 def _async_dispatch_domain_event(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[EventStateChangedData]], Any]]], event: Event[EventStateChangedData]) -> None: ...
+@callback
 def _async_domain_added_filter(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[EventStateChangedData]], Any]]], event_data: EventStateChangedData) -> bool: ...
+@bind_hass
 def async_track_state_added_domain(hass: HomeAssistant, domains: str | Iterable[str], action: Callable[[Event[EventStateChangedData]], Any], job_type: HassJobType | None = None) -> CALLBACK_TYPE: ...
 
 _KEYED_TRACK_STATE_ADDED_DOMAIN: Incomplete
 
+@bind_hass
 def _async_track_state_added_domain(hass: HomeAssistant, domains: str | Iterable[str], action: Callable[[Event[EventStateChangedData]], Any], job_type: HassJobType | None) -> CALLBACK_TYPE: ...
+@callback
 def _async_domain_removed_filter(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[EventStateChangedData]], Any]]], event_data: EventStateChangedData) -> bool: ...
 
 _KEYED_TRACK_STATE_REMOVED_DOMAIN: Incomplete
 
+@bind_hass
 def async_track_state_removed_domain(hass: HomeAssistant, domains: str | Iterable[str], action: Callable[[Event[EventStateChangedData]], Any], job_type: HassJobType | None = None) -> CALLBACK_TYPE: ...
+@callback
 def _async_string_to_lower_list(instr: str | Iterable[str]) -> list[str]: ...
 
 class _TrackStateChangeFiltered:
@@ -123,18 +141,30 @@ class _TrackStateChangeFiltered:
     _listeners: dict[str, Callable[[], None]]
     _last_track_states: TrackStates
     def __init__(self, hass: HomeAssistant, track_states: TrackStates, action: Callable[[Event[EventStateChangedData]], Any]) -> None: ...
+    @callback
     def async_setup(self) -> None: ...
     @property
     def listeners(self) -> dict[str, bool | set[str]]: ...
+    @callback
     def async_update_listeners(self, new_track_states: TrackStates) -> None: ...
+    @callback
     def async_remove(self) -> None: ...
+    @callback
     def _cancel_listener(self, listener_name: str) -> None: ...
+    @callback
     def _setup_entities_listener(self, domains: set[str], entities: set[str]) -> None: ...
+    @callback
     def _state_added(self, event: Event[EventStateChangedData]) -> None: ...
+    @callback
     def _setup_domains_listener(self, domains: set[str]) -> None: ...
+    @callback
     def _setup_all_listener(self) -> None: ...
 
+@callback
+@bind_hass
 def async_track_state_change_filtered(hass: HomeAssistant, track_states: TrackStates, action: Callable[[Event[EventStateChangedData]], Any]) -> _TrackStateChangeFiltered: ...
+@callback
+@bind_hass
 def async_track_template(hass: HomeAssistant, template: Template, action: Callable[[str, State | None, State | None], Coroutine[Any, Any, None] | None], variables: TemplateVarsType | None = None) -> CALLBACK_TYPE: ...
 
 track_template: Incomplete
@@ -154,22 +184,34 @@ class TrackTemplateResultInfo:
     def async_setup(self, strict: bool = False, log_fn: Callable[[int, str], None] | None = None) -> None: ...
     @property
     def listeners(self) -> dict[str, bool | set[str]]: ...
+    @callback
     def _setup_time_listener(self, template: Template, has_time: bool) -> None: ...
+    @callback
     def _update_time_listeners(self) -> None: ...
+    @callback
     def async_remove(self) -> None: ...
+    @callback
     def async_refresh(self) -> None: ...
     def _render_template_if_ready(self, track_template_: TrackTemplate, now: float, event: Event[EventStateChangedData] | None) -> bool | TrackTemplateResult: ...
     @staticmethod
     def _super_template_as_boolean(result: bool | str | TemplateError) -> bool: ...
+    @callback
     def _apply_update(self, updates: list[TrackTemplateResult], update: bool | TrackTemplateResult, template: Template) -> bool: ...
+    @callback
     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]
 
+@callback
+@bind_hass
 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: ...
+@callback
+@bind_hass
 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: ...
 
 track_same_state: Incomplete
 
+@callback
+@bind_hass
 def async_track_point_in_time(hass: HomeAssistant, action: HassJob[[datetime], Coroutine[Any, Any, None] | None] | Callable[[datetime], Coroutine[Any, Any, None] | None], point_in_time: datetime) -> CALLBACK_TYPE: ...
 
 track_point_in_time: Incomplete
@@ -182,16 +224,23 @@ class _TrackPointUTCTime:
     expected_fire_timestamp: float
     _cancel_callback: asyncio.TimerHandle | None = ...
     def async_attach(self) -> None: ...
+    @callback
     def __call__(self) -> None: ...
+    @callback
     def async_cancel(self) -> None: ...
-    def __init__(self, hass, job, utc_point_in_time, expected_fire_timestamp, _cancel_callback=...) -> None: ...
 
+@callback
+@bind_hass
 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: ...
 
 track_point_in_utc_time: Incomplete
 
 def _run_async_call_action(hass: HomeAssistant, job: HassJob[[datetime], Coroutine[Any, Any, None] | None]) -> None: ...
+@callback
+@bind_hass
 def async_call_at(hass: HomeAssistant, action: HassJob[[datetime], Coroutine[Any, Any, None] | None] | Callable[[datetime], Coroutine[Any, Any, None] | None], loop_time: float) -> CALLBACK_TYPE: ...
+@callback
+@bind_hass
 def async_call_later(hass: HomeAssistant, delay: float | timedelta, action: HassJob[[datetime], Coroutine[Any, Any, None] | None] | Callable[[datetime], Coroutine[Any, Any, None] | None]) -> CALLBACK_TYPE: ...
 
 call_later: Incomplete
@@ -208,10 +257,13 @@ class _TrackTimeInterval:
     _timer_handle: asyncio.TimerHandle | None = ...
     def async_attach(self) -> None: ...
     def _schedule_timer(self) -> None: ...
+    @callback
     def _interval_listener(self, _: Any) -> None: ...
+    @callback
     def async_cancel(self) -> None: ...
-    def __init__(self, hass, seconds, job_name, action, cancel_on_shutdown, _track_job=..., _run_job=..., _timer_handle=...) -> None: ...
 
+@callback
+@bind_hass
 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: ...
 
 track_time_interval: Incomplete
@@ -224,17 +276,25 @@ class SunListener:
     offset: timedelta | None
     _unsub_sun: CALLBACK_TYPE | None = ...
     _unsub_config: CALLBACK_TYPE | None = ...
+    @callback
     def async_attach(self) -> None: ...
+    @callback
     def async_detach(self) -> None: ...
+    @callback
     def _listen_next_sun_event(self) -> None: ...
+    @callback
     def _handle_sun_event(self, _now: Any) -> None: ...
+    @callback
     def _handle_config_event(self, _event: Any) -> None: ...
-    def __init__(self, hass, job, event, offset, _unsub_sun=..., _unsub_config=...) -> None: ...
 
+@callback
+@bind_hass
 def async_track_sunrise(hass: HomeAssistant, action: Callable[[], None], offset: timedelta | None = None) -> CALLBACK_TYPE: ...
 
 track_sunrise: Incomplete
 
+@callback
+@bind_hass
 def async_track_sunset(hass: HomeAssistant, action: Callable[[], None], offset: timedelta | None = None) -> CALLBACK_TYPE: ...
 
 track_sunset: Incomplete
@@ -253,22 +313,32 @@ class _TrackUTCTimeChange:
     _cancel_callback: CALLBACK_TYPE | None = ...
     def async_attach(self) -> None: ...
     def _calculate_next(self, utc_now: datetime) -> datetime: ...
+    @callback
     def _pattern_time_change_listener(self, _: datetime) -> None: ...
+    @callback
     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: ...
 
+@callback
+@bind_hass
 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: ...
 
 track_utc_time_change: Incomplete
 
+@callback
+@bind_hass
 def async_track_time_change(hass: HomeAssistant, action: Callable[[datetime], Coroutine[Any, Any, None] | None], hour: Any | None = None, minute: Any | None = None, second: Any | None = None) -> CALLBACK_TYPE: ...
 
 track_time_change: Incomplete
 
 def process_state_match(parameter: str | Iterable[str] | None, invert: bool = False) -> Callable[[str | None], bool]: ...
+@callback
 def _entities_domains_from_render_infos(render_infos: Iterable[RenderInfo]) -> tuple[set[str], set[str]]: ...
+@callback
 def _render_infos_needs_all_listener(render_infos: Iterable[RenderInfo]) -> bool: ...
+@callback
 def _render_infos_to_track_states(render_infos: Iterable[RenderInfo]) -> TrackStates: ...
+@callback
 def _event_triggers_rerender(event: Event[EventStateChangedData], info: RenderInfo) -> bool: ...
+@callback
 def _rate_limit_for_event(event: Event[EventStateChangedData], info: RenderInfo, track_template_: TrackTemplate) -> float | None: ...
 def _suppress_domain_all_in_render_info(render_info: RenderInfo) -> RenderInfo: ...

homeassistant-stubs/helpers/floor_registry.pyi

@@ -41,7 +41,6 @@ class FloorEntry(NormalizedNameBaseRegistryEntry):
     floor_id: str
     icon: str | None = ...
     level: int | 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: ...
@@ -52,15 +51,23 @@ class FloorRegistry(BaseRegistry[FloorRegistryStoreData]):
     hass: Incomplete
     _store: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
+    @callback
     def async_get_floor(self, floor_id: str) -> FloorEntry | None: ...
+    @callback
     def async_get_floor_by_name(self, name: str) -> FloorEntry | None: ...
+    @callback
     def async_list_floors(self) -> Iterable[FloorEntry]: ...
     def _generate_id(self, name: str) -> str: ...
+    @callback
     def async_create(self, name: str, *, aliases: set[str] | None = None, icon: str | None = None, level: int | None = None) -> FloorEntry: ...
+    @callback
     def async_delete(self, floor_id: str) -> None: ...
+    @callback
     def async_update(self, floor_id: str, *, aliases: set[str] | UndefinedType = ..., icon: str | None | UndefinedType = ..., level: int | UndefinedType = ..., name: str | UndefinedType = ...) -> FloorEntry: ...
     async def async_load(self) -> None: ...
+    @callback
     def _data_to_save(self) -> FloorRegistryStoreData: ...
 
+@callback
 def async_get(hass: HomeAssistant) -> FloorRegistry: ...
 async def async_load(hass: HomeAssistant) -> None: ...

homeassistant-stubs/helpers/frame.pyi

@@ -25,7 +25,6 @@ class IntegrationFrame:
     def filename(self) -> str: ...
     @cached_property
     def line(self) -> str: ...
-    def __init__(self, *, custom_integration, integration, module, relative_filename, frame) -> None: ...
 
 def get_integration_logger(fallback_name: str) -> logging.Logger: ...
 def get_current_frame(depth: int = 0) -> FrameType: ...

homeassistant-stubs/helpers/hassio.pyi

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

homeassistant-stubs/helpers/httpx_client.pyi

@@ -17,11 +17,15 @@ limits: Incomplete
 SERVER_SOFTWARE: Incomplete
 USER_AGENT: str
 
+@callback
+@bind_hass
 def get_async_client(hass: HomeAssistant, verify_ssl: bool = True) -> httpx.AsyncClient: ...
 
 class HassHttpXAsyncClient(httpx.AsyncClient):
     async def __aenter__(self) -> Self: ...
     async def __aexit__(self, *args: object) -> None: ...
 
+@callback
 def create_async_httpx_client(hass: HomeAssistant, verify_ssl: bool = True, auto_cleanup: bool = True, ssl_cipher_list: SSLCipherList = ..., **kwargs: Any) -> httpx.AsyncClient: ...
+@callback
 def _async_register_async_client_shutdown(hass: HomeAssistant, client: httpx.AsyncClient, original_aclose: Callable[[], Coroutine[Any, Any, None]]) -> None: ...

homeassistant-stubs/helpers/icon.pyi

@@ -2,6 +2,7 @@ import pathlib
 from .translation import build_resources as build_resources
 from _typeshed import Incomplete
 from collections.abc import Iterable
+from functools import lru_cache
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.loader import Integration as Integration, async_get_integrations as async_get_integrations
 from homeassistant.util.hass_dict import HassKey as HassKey
@@ -25,8 +26,10 @@ class _IconsCache:
     def __init__(self, hass: HomeAssistant) -> None: ...
     async def async_fetch(self, category: str, components: set[str]) -> dict[str, dict[str, Any]]: ...
     async def _async_load(self, components: set[str]) -> None: ...
+    @callback
     def _build_category_cache(self, components: set[str], icons: dict[str, dict[str, Any]]) -> None: ...
 
 async def async_get_icons(hass: HomeAssistant, category: str, integrations: Iterable[str] | None = None) -> dict[str, Any]: ...
+@lru_cache
 def icon_for_battery_level(battery_level: int | None = None, charging: bool = False) -> str: ...
 def icon_for_signal_level(signal_level: int | None = None) -> str: ...