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

homeassistant-stubs/components/zwave_js/event.pyi

@@ -20,5 +20,6 @@ class ZwaveEventEntity(ZWaveBaseEntity, EventEntity):
     _attr_event_types: Incomplete
     _attr_name: Incomplete
     def __init__(self, config_entry: ConfigEntry, driver: Driver, info: ZwaveDiscoveryInfo) -> None: ...
+    @callback
     def _async_handle_event(self, value_notification: ValueNotification) -> None: ...
     async def async_added_to_hass(self) -> None: ...

homeassistant-stubs/components/zwave_js/helpers.pyi

@@ -23,7 +23,6 @@ class ZwaveValueID:
     command_class: int
     endpoint: int | None = ...
     property_key: str | int | None = ...
-    def __init__(self, property_, command_class, endpoint=..., property_key=...) -> None: ...
 
 @dataclass
 class ZwaveValueMatcher:
@@ -32,7 +31,6 @@ class ZwaveValueMatcher:
     endpoint: int | None = ...
     property_key: str | int | None = ...
     def __post_init__(self) -> None: ...
-    def __init__(self, property_=..., command_class=..., endpoint=..., property_key=...) -> None: ...
 
 def value_matches_matcher(matcher: ZwaveValueMatcher, value_data: ValueDataType) -> bool: ...
 def get_value_id_from_unique_id(unique_id: str) -> str | None: ...
@@ -46,12 +44,17 @@ def get_unique_id(driver: Driver, value_id: str) -> str: ...
 def get_device_id(driver: Driver, node: ZwaveNode) -> tuple[str, str]: ...
 def get_device_id_ext(driver: Driver, node: ZwaveNode) -> tuple[str, str] | None: ...
 def get_home_and_node_id_from_device_entry(device_entry: dr.DeviceEntry) -> tuple[str, int] | None: ...
+@callback
 def async_get_node_from_device_id(hass: HomeAssistant, device_id: str, dev_reg: dr.DeviceRegistry | None = None) -> ZwaveNode: ...
+@callback
 def async_get_node_from_entity_id(hass: HomeAssistant, entity_id: str, ent_reg: er.EntityRegistry | None = None, dev_reg: dr.DeviceRegistry | None = None) -> ZwaveNode: ...
+@callback
 def async_get_nodes_from_area_id(hass: HomeAssistant, area_id: str, ent_reg: er.EntityRegistry | None = None, dev_reg: dr.DeviceRegistry | None = None) -> set[ZwaveNode]: ...
+@callback
 def async_get_nodes_from_targets(hass: HomeAssistant, val: dict[str, Any], ent_reg: er.EntityRegistry | None = None, dev_reg: dr.DeviceRegistry | None = None, logger: logging.Logger = ...) -> set[ZwaveNode]: ...
 def get_zwave_value_from_config(node: ZwaveNode, config: ConfigType) -> ZwaveValue: ...
 def _zwave_js_config_entry(hass: HomeAssistant, device: dr.DeviceEntry) -> str | None: ...
+@callback
 def async_get_node_status_sensor_entity_id(hass: HomeAssistant, device_id: str, ent_reg: er.EntityRegistry | None = None, dev_reg: dr.DeviceRegistry | None = None) -> str | None: ...
 def remove_keys_with_empty_values(config: ConfigType) -> ConfigType: ...
 def check_type_schema_map(schema_map: dict[str, vol.Schema]) -> Callable[[ConfigType], ConfigType]: ...

homeassistant-stubs/components/zwave_js/humidifier.pyi

@@ -20,7 +20,6 @@ class ZwaveHumidifierEntityDescription(HumidifierEntityDescription):
     on_mode: HumidityControlMode
     inverse_mode: HumidityControlMode
     setpoint_type: HumidityControlSetpointType
-    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=..., on_mode, inverse_mode, setpoint_type) -> None: ...
 
 HUMIDIFIER_ENTITY_DESCRIPTION: Incomplete
 DEHUMIDIFIER_ENTITY_DESCRIPTION: Incomplete

homeassistant-stubs/components/zwave_js/light.pyi

@@ -42,6 +42,7 @@ class ZwaveLight(ZWaveBaseEntity, LightEntity):
     supports_color_transition: Incomplete
     _set_optimistic_state: bool
     def __init__(self, config_entry: ConfigEntry, driver: Driver, info: ZwaveDiscoveryInfo) -> None: ...
+    @callback
     def on_value_update(self) -> None: ...
     @property
     def brightness(self) -> int | None: ...
@@ -62,8 +63,11 @@ class ZwaveLight(ZWaveBaseEntity, LightEntity):
     def _get_new_colors(self, hs_color: tuple[float, float] | None, color_temp_k: int | None, rgbw: tuple[int, int, int, int] | None, brightness_scale: float | None = None) -> dict[ColorComponent, int] | None: ...
     async def _async_set_colors(self, colors: dict[ColorComponent, int], transition: float | None = None) -> None: ...
     async def _async_set_brightness(self, brightness: int | None, transition: float | None = None) -> None: ...
+    @callback
     def _get_color_values(self) -> tuple[Value | None, ...]: ...
+    @callback
     def _calculate_color_support(self) -> None: ...
+    @callback
     def _calculate_color_values(self) -> None: ...
 
 class ZwaveColorOnOffLight(ZwaveLight):

homeassistant-stubs/components/zwave_js/logbook.pyi

@@ -4,4 +4,5 @@ from homeassistant.components.logbook import LOGBOOK_ENTRY_MESSAGE as LOGBOOK_EN
 from homeassistant.const import ATTR_DEVICE_ID as ATTR_DEVICE_ID
 from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant, callback as callback
 
+@callback
 def async_describe_events(hass: HomeAssistant, async_describe_event: Callable[[str, str, Callable[[Event], dict[str, str]]], None]) -> None: ...

homeassistant-stubs/components/zwave_js/migrate.pyi

@@ -23,10 +23,14 @@ class ValueID:
     @staticmethod
     def from_string_id(value_id_str: str) -> ValueID: ...
     def is_same_value_different_endpoints(self, other: ValueID) -> bool: ...
-    def __init__(self, command_class, endpoint, property_, property_key=...) -> None: ...
 
+@callback
 def async_migrate_old_entity(hass: HomeAssistant, ent_reg: er.EntityRegistry, registered_unique_ids: set[str], platform: Platform, device: dr.DeviceEntry, unique_id: str) -> None: ...
+@callback
 def async_migrate_unique_id(ent_reg: er.EntityRegistry, platform: Platform, old_unique_id: str, new_unique_id: str) -> None: ...
+@callback
 def async_migrate_discovered_value(hass: HomeAssistant, ent_reg: er.EntityRegistry, registered_unique_ids: set[str], device: dr.DeviceEntry, driver: Driver, disc_info: ZwaveDiscoveryInfo) -> None: ...
+@callback
 def async_migrate_statistics_sensors(hass: HomeAssistant, driver: Driver, node: Node, key_map: dict[str, str]) -> None: ...
+@callback
 def get_old_value_ids(value: ZwaveValue) -> list[str]: ...

homeassistant-stubs/components/zwave_js/sensor.pyi

@@ -34,7 +34,6 @@ def convert_nested_attr(statistics: ControllerStatistics | NodeStatistics, key:
 class ZWaveJSStatisticsSensorEntityDescription(SensorEntityDescription):
     convert: Callable[[ControllerStatistics | NodeStatistics, str], Any] = ...
     entity_registry_enabled_default: bool = ...
-    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., last_reset=..., native_unit_of_measurement=..., options=..., state_class=..., suggested_display_precision=..., suggested_unit_of_measurement=..., convert=...) -> None: ...
 
 ENTITY_DESCRIPTION_CONTROLLER_STATISTICS_LIST: Incomplete
 CONTROLLER_STATISTICS_KEY_MAP: dict[str, str]
@@ -60,6 +59,7 @@ class ZWaveNumericSensor(ZwaveSensor):
     def __init__(self, config_entry: ConfigEntry, driver: Driver, info: ZwaveDiscoveryInfo, entity_description: SensorEntityDescription, unit_of_measurement: str | None = None) -> None: ...
     entity_description: Incomplete
     _attr_native_unit_of_measurement: Incomplete
+    @callback
     def on_value_update(self) -> None: ...
     @property
     def native_value(self) -> float: ...
@@ -97,6 +97,7 @@ class ZWaveNodeStatusSensor(SensorEntity):
     def __init__(self, config_entry: ConfigEntry, driver: Driver, node: ZwaveNode) -> None: ...
     async def async_poll_value(self, _: bool) -> None: ...
     _attr_native_value: Incomplete
+    @callback
     def _status_changed(self, _: dict) -> None: ...
     async def async_added_to_hass(self) -> None: ...
 
@@ -113,6 +114,7 @@ class ZWaveControllerStatusSensor(SensorEntity):
     def __init__(self, config_entry: ConfigEntry, driver: Driver) -> None: ...
     async def async_poll_value(self, _: bool) -> None: ...
     _attr_native_value: Incomplete
+    @callback
     def _status_changed(self, _: dict) -> None: ...
     async def async_added_to_hass(self) -> None: ...
 
@@ -129,5 +131,6 @@ class ZWaveStatisticsSensor(SensorEntity):
     def __init__(self, config_entry: ConfigEntry, driver: Driver, statistics_src: ZwaveNode | Controller, description: ZWaveJSStatisticsSensorEntityDescription) -> None: ...
     async def async_poll_value(self, _: bool) -> None: ...
     _attr_native_value: Incomplete
+    @callback
     def statistics_updated(self, event_data: dict) -> None: ...
     async def async_added_to_hass(self) -> None: ...

homeassistant-stubs/components/zwave_js/services.pyi

@@ -30,6 +30,7 @@ class ZWaveServices:
     _ent_reg: Incomplete
     _dev_reg: Incomplete
     def __init__(self, hass: HomeAssistant, ent_reg: er.EntityRegistry, dev_reg: dr.DeviceRegistry) -> None: ...
+    @callback
     def async_register(self) -> None: ...
     async def async_set_config_parameter(self, service: ServiceCall) -> None: ...
     async def async_bulk_set_partial_config_parameters(self, service: ServiceCall) -> None: ...

homeassistant-stubs/components/zwave_js/switch.pyi

@@ -32,11 +32,13 @@ class ZWaveBarrierEventSignalingSwitch(ZWaveBaseEntity, SwitchEntity):
     _state: bool | None
     _attr_name: Incomplete
     def __init__(self, config_entry: ConfigEntry, driver: Driver, info: ZwaveDiscoveryInfo) -> None: ...
+    @callback
     def on_value_update(self) -> None: ...
     @property
     def is_on(self) -> bool | None: ...
     async def async_turn_on(self, **kwargs: Any) -> None: ...
     async def async_turn_off(self, **kwargs: Any) -> None: ...
+    @callback
     def _update_state(self) -> None: ...
 
 class ZWaveConfigParameterSwitch(ZWaveSwitch):

homeassistant-stubs/components/zwave_js/triggers/trigger_helpers.pyi

@@ -4,4 +4,5 @@ from homeassistant.const import ATTR_DEVICE_ID as ATTR_DEVICE_ID, ATTR_ENTITY_ID
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.typing import ConfigType as ConfigType
 
+@callback
 def async_bypass_dynamic_config_validation(hass: HomeAssistant, config: ConfigType) -> bool: ...

homeassistant-stubs/components/zwave_js/update.pyi

@@ -29,7 +29,6 @@ class ZWaveNodeFirmwareUpdateExtraStoredData(ExtraStoredData):
     def as_dict(self) -> dict[str, Any]: ...
     @classmethod
     def from_dict(cls, data: dict[str, Any]) -> ZWaveNodeFirmwareUpdateExtraStoredData: ...
-    def __init__(self, latest_version_firmware) -> None: ...
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
@@ -57,11 +56,15 @@ class ZWaveNodeFirmwareUpdate(UpdateEntity):
     def __init__(self, driver: Driver, node: ZwaveNode, delay: timedelta) -> None: ...
     @property
     def extra_restore_state_data(self) -> ZWaveNodeFirmwareUpdateExtraStoredData: ...
+    @callback
     def _update_on_status_change(self, _: dict[str, Any]) -> None: ...
     _attr_in_progress: bool
     _attr_update_percentage: Incomplete
+    @callback
     def _update_progress(self, event: dict[str, Any]) -> None: ...
+    @callback
     def _update_finished(self, event: dict[str, Any]) -> None: ...
+    @callback
     def _unsub_firmware_events_and_reset_progress(self, write_state: bool = True) -> None: ...
     _attr_latest_version: Incomplete
     async def _async_update(self, _: HomeAssistant | datetime | None = None) -> None: ...

homeassistant-stubs/config.pyi

@@ -55,13 +55,11 @@ class ConfigExceptionInfo:
     platform_path: str
     config: ConfigType
     integration_link: str | None
-    def __init__(self, exception, translation_key, platform_path, config, integration_link) -> None: ...
 
 @dataclass
 class IntegrationConfigInfo:
     config: ConfigType | None
     exception_info_list: list[ConfigExceptionInfo]
-    def __init__(self, config, exception_info_list) -> None: ...
 
 def get_default_config_dir() -> str: ...
 async def async_ensure_config_exists(hass: HomeAssistant) -> bool: ...
@@ -70,7 +68,9 @@ def _write_default_config(config_dir: str) -> bool: ...
 async def async_hass_config_yaml(hass: HomeAssistant) -> dict: ...
 def load_yaml_config_file(config_path: str, secrets: Secrets | None = None) -> dict[Any, Any]: ...
 def process_ha_config_upgrade(hass: HomeAssistant) -> None: ...
+@callback
 def async_log_schema_error(exc: vol.Invalid, domain: str, config: dict, hass: HomeAssistant, link: str | None = None) -> None: ...
+@callback
 def async_log_config_validator_error(exc: vol.Invalid | HomeAssistantError, domain: str, config: dict, hass: HomeAssistant, link: str | None = None) -> None: ...
 def _get_annotation(item: Any) -> tuple[str, int | str] | None: ...
 def _get_by_path(data: dict | list, items: list[Hashable]) -> Any: ...
@@ -78,16 +78,21 @@ def find_annotation(config: dict | list, path: list[Hashable]) -> tuple[str, int
 def _relpath(hass: HomeAssistant, path: str) -> str: ...
 def stringify_invalid(hass: HomeAssistant, exc: vol.Invalid, domain: str, config: dict, link: str | None, max_sub_error_length: int) -> str: ...
 def humanize_error(hass: HomeAssistant, validation_error: vol.Invalid, domain: str, config: dict, link: str | None, max_sub_error_length: int = ...) -> str: ...
+@callback
 def format_homeassistant_error(hass: HomeAssistant, exc: HomeAssistantError, domain: str, config: dict, link: str | None = None) -> str: ...
+@callback
 def format_schema_error(hass: HomeAssistant, exc: vol.Invalid, domain: str, config: dict, link: str | None = None) -> str: ...
 def _log_pkg_error(hass: HomeAssistant, package: str, component: str | None, config: dict, message: str) -> None: ...
 def _identify_config_schema(module: ComponentProtocol) -> str | None: ...
 def _validate_package_definition(name: str, conf: Any) -> None: ...
 def _recursive_merge(conf: dict[str, Any], package: dict[str, Any]) -> str | None: ...
 async def merge_packages_config(hass: HomeAssistant, config: dict, packages: dict[str, Any], _log_pkg_error: Callable[[HomeAssistant, str, str | None, dict, str], None] = ...) -> dict: ...
+@callback
 def _get_log_message_and_stack_print_pref(hass: HomeAssistant, domain: str, platform_exception: ConfigExceptionInfo) -> tuple[str | None, bool, dict[str, str]]: ...
 async def async_process_component_and_handle_errors(hass: HomeAssistant, config: ConfigType, integration: Integration, raise_on_failure: bool = False) -> ConfigType | None: ...
+@callback
 def async_drop_config_annotations(integration_config_info: IntegrationConfigInfo, integration: Integration) -> ConfigType | None: ...
+@callback
 def async_handle_component_errors(hass: HomeAssistant, integration_config_info: IntegrationConfigInfo, integration: Integration, raise_on_failure: bool = False) -> None: ...
 def config_per_platform(config: ConfigType, domain: str) -> Iterable[tuple[str | None, ConfigType]]: ...
 def extract_platform_integrations(config: ConfigType, domains: set[str]) -> dict[str, set[str]]: ...
@@ -100,10 +105,10 @@ class _PlatformIntegration:
     integration: Integration
     config: ConfigType
     validated_config: ConfigType
-    def __init__(self, path, name, integration, config, validated_config) -> None: ...
 
 async def _async_load_and_validate_platform_integration(domain: str, integration_docs: str | None, config_exceptions: list[ConfigExceptionInfo], p_integration: _PlatformIntegration) -> ConfigType | None: ...
 async def async_process_component_config(hass: HomeAssistant, config: ConfigType, integration: Integration, component: ComponentProtocol | None = None) -> IntegrationConfigInfo: ...
+@callback
 def config_without_domain(config: ConfigType, domain: str) -> ConfigType: ...
 async def async_check_ha_config_file(hass: HomeAssistant) -> str | None: ...
 def safe_mode_enabled(config_dir: str) -> bool: ...

homeassistant-stubs/config_entries.pyi

@@ -33,6 +33,7 @@ from collections.abc import Callable, Coroutine, Generator, Iterable, Mapping, V
 from contextvars import ContextVar
 from datetime import datetime
 from enum import Enum, StrEnum
+from functools import cache
 from propcache import cached_property
 from types import MappingProxyType
 from typing import Any, Generic, Self
@@ -86,6 +87,7 @@ RECONFIGURE_NOTIFICATION_ID: str
 EVENT_FLOW_DISCOVERED: str
 SIGNAL_CONFIG_ENTRY_CHANGED: Incomplete
 
+@cache
 def signal_discovered_config_entry_removed(discovery_domain: str) -> SignalType[ConfigEntry]: ...
 
 NO_RESET_TRIES_STATES: Incomplete
@@ -181,22 +183,31 @@ class ConfigEntry(Generic[_DataT]):
     def as_storage_fragment(self) -> json_fragment: ...
     async def async_setup(self, hass: HomeAssistant, *, integration: loader.Integration | None = None) -> None: ...
     async def __async_setup_with_context(self, hass: HomeAssistant, integration: loader.Integration | None) -> None: ...
+    @callback
     def _async_setup_again(self, hass: HomeAssistant, *_: Any) -> None: ...
     async def async_setup_locked(self, hass: HomeAssistant, integration: loader.Integration | None = None) -> None: ...
+    @callback
     def async_shutdown(self) -> None: ...
+    @callback
     def async_cancel_retry_setup(self) -> None: ...
     async def async_unload(self, hass: HomeAssistant, *, integration: loader.Integration | None = None) -> bool: ...
     async def async_remove(self, hass: HomeAssistant) -> None: ...
+    @callback
     def _async_set_state(self, hass: HomeAssistant, state: ConfigEntryState, reason: str | None, error_reason_translation_key: str | None = None, error_reason_translation_placeholders: dict[str, str] | None = None) -> None: ...
     async def async_migrate(self, hass: HomeAssistant) -> bool: ...
     def add_update_listener(self, listener: UpdateListenerType) -> CALLBACK_TYPE: ...
     def as_dict(self) -> dict[str, Any]: ...
+    @callback
     def async_on_unload(self, func: Callable[[], Coroutine[Any, Any, None] | None]) -> None: ...
     async def _async_process_on_unload(self, hass: HomeAssistant) -> None: ...
+    @callback
     def async_start_reauth(self, hass: HomeAssistant, context: ConfigFlowContext | None = None, data: dict[str, Any] | None = None) -> None: ...
     async def _async_init_reauth(self, hass: HomeAssistant, context: ConfigFlowContext | None = None, data: dict[str, Any] | None = None) -> None: ...
+    @callback
     def async_get_active_flows(self, hass: HomeAssistant, sources: set[str]) -> Generator[ConfigFlowResult]: ...
+    @callback
     def async_create_task[_R](self, hass: HomeAssistant, target: Coroutine[Any, Any, _R], name: str | None = None, eager_start: bool = True) -> asyncio.Task[_R]: ...
+    @callback
     def async_create_background_task[_R](self, hass: HomeAssistant, target: Coroutine[Any, Any, _R], name: str, eager_start: bool = True) -> asyncio.Task[_R]: ...
 
 current_entry: ContextVar[ConfigEntry | None]
@@ -214,16 +225,21 @@ class ConfigEntriesFlowManager(data_entry_flow.FlowManager[ConfigFlowContext, Co
     _discovery_debouncer: Incomplete
     def __init__(self, hass: HomeAssistant, config_entries: ConfigEntries, hass_config: ConfigType) -> None: ...
     async def async_wait_import_flow_initialized(self, handler: str) -> None: ...
+    @callback
     def _async_has_other_discovery_flows(self, flow_id: str) -> bool: ...
     async def async_init(self, handler: str, *, context: ConfigFlowContext | None = None, data: Any = None) -> ConfigFlowResult: ...
     async def _async_init(self, flow_id: str, handler: str, context: ConfigFlowContext, data: Any) -> tuple[ConfigFlow, ConfigFlowResult]: ...
     def _set_pending_import_done(self, flow: ConfigFlow) -> None: ...
+    @callback
     def async_shutdown(self) -> None: ...
     async def async_finish_flow(self, flow: data_entry_flow.FlowHandler[ConfigFlowContext, ConfigFlowResult], result: ConfigFlowResult) -> ConfigFlowResult: ...
     async def async_create_flow(self, handler_key: str, *, context: ConfigFlowContext | None = None, data: Any = None) -> ConfigFlow: ...
     async def async_post_init(self, flow: data_entry_flow.FlowHandler[ConfigFlowContext, ConfigFlowResult], result: ConfigFlowResult) -> None: ...
+    @callback
     def _async_discovery(self) -> None: ...
+    @callback
     def async_has_matching_discovery_flow(self, handler: str, match_context: ConfigFlowContext, data: Any) -> bool: ...
+    @callback
     def async_has_matching_flow(self, flow: ConfigFlow) -> bool: ...
 
 class ConfigEntryItems(UserDict[str, ConfigEntry]):
@@ -253,26 +269,39 @@ class ConfigEntries:
     _entries: Incomplete
     _store: Incomplete
     def __init__(self, hass: HomeAssistant, hass_config: ConfigType) -> None: ...
+    @callback
     def async_domains(self, include_ignore: bool = False, include_disabled: bool = False) -> list[str]: ...
+    @callback
     def async_get_entry(self, entry_id: str) -> ConfigEntry | None: ...
+    @callback
     def async_get_known_entry(self, entry_id: str) -> ConfigEntry: ...
+    @callback
     def async_entry_ids(self) -> list[str]: ...
+    @callback
     def async_has_entries(self, domain: str, include_ignore: bool = True, include_disabled: bool = True) -> bool: ...
+    @callback
     def async_entries(self, domain: str | None = None, include_ignore: bool = True, include_disabled: bool = True) -> list[ConfigEntry]: ...
+    @callback
     def async_loaded_entries(self, domain: str) -> list[ConfigEntry]: ...
+    @callback
     def async_entry_for_domain_unique_id(self, domain: str, unique_id: str) -> ConfigEntry | None: ...
     async def async_add(self, entry: ConfigEntry) -> None: ...
     async def async_remove(self, entry_id: str) -> dict[str, Any]: ...
     async def _async_remove(self, entry_id: str) -> tuple[bool, ConfigEntry]: ...
+    @callback
     def _async_clean_up(self, entry: ConfigEntry) -> None: ...
+    @callback
     def _async_shutdown(self, event: Event) -> None: ...
     async def async_initialize(self) -> None: ...
     async def async_setup(self, entry_id: str, _lock: bool = True) -> bool: ...
     async def async_unload(self, entry_id: str, _lock: bool = True) -> bool: ...
+    @callback
     def async_schedule_reload(self, entry_id: str) -> None: ...
     async def async_reload(self, entry_id: str) -> bool: ...
     async def async_set_disabled_by(self, entry_id: str, disabled_by: ConfigEntryDisabler | None) -> bool: ...
+    @callback
     def async_update_entry(self, entry: ConfigEntry, *, data: Mapping[str, Any] | UndefinedType = ..., discovery_keys: MappingProxyType[str, tuple[DiscoveryKey, ...]] | UndefinedType = ..., minor_version: int | UndefinedType = ..., options: Mapping[str, Any] | UndefinedType = ..., pref_disable_new_entities: bool | UndefinedType = ..., pref_disable_polling: bool | UndefinedType = ..., title: str | UndefinedType = ..., unique_id: str | None | UndefinedType = ..., version: int | UndefinedType = ...) -> bool: ...
+    @callback
     def _async_dispatch(self, change_type: ConfigEntryChange, entry: ConfigEntry) -> None: ...
     async def async_forward_entry_setups(self, entry: ConfigEntry, platforms: Iterable[Platform | str]) -> None: ...
     async def _async_forward_entry_setups_locked(self, entry: ConfigEntry, platforms: Iterable[Platform | str]) -> None: ...
@@ -280,11 +309,15 @@ class ConfigEntries:
     async def _async_forward_entry_setup(self, entry: ConfigEntry, domain: Platform | str, preload_platform: bool) -> bool: ...
     async def async_unload_platforms(self, entry: ConfigEntry, platforms: Iterable[Platform | str]) -> bool: ...
     async def async_forward_entry_unload(self, entry: ConfigEntry, domain: Platform | str) -> bool: ...
+    @callback
     def _async_schedule_save(self) -> None: ...
+    @callback
     def _data_to_save(self) -> dict[str, list[dict[str, Any]]]: ...
     async def async_wait_component(self, entry: ConfigEntry) -> bool: ...
+    @callback
     def async_update_issues(self) -> None: ...
 
+@callback
 def _async_abort_entries_match(other_entries: list[ConfigEntry], match_dict: dict[str, Any] | None = None) -> None: ...
 
 class ConfigEntryBaseFlow(data_entry_flow.FlowHandler[ConfigFlowContext, ConfigFlowResult]):
@@ -295,22 +328,32 @@ class ConfigFlow(ConfigEntryBaseFlow):
     @property
     def unique_id(self) -> str | None: ...
     @staticmethod
+    @callback
     def async_get_options_flow(config_entry: ConfigEntry) -> OptionsFlow: ...
     @classmethod
+    @callback
     def async_supports_options_flow(cls, config_entry: ConfigEntry) -> bool: ...
+    @callback
     def _async_abort_entries_match(self, match_dict: dict[str, Any] | None = None) -> None: ...
+    @callback
     def _abort_if_unique_id_mismatch(self, *, reason: str = 'unique_id_mismatch', description_placeholders: Mapping[str, str] | None = None) -> None: ...
+    @callback
     def _abort_if_unique_id_configured(self, updates: dict[str, Any] | None = None, reload_on_update: bool = True, *, error: str = 'already_configured') -> None: ...
     async def async_set_unique_id(self, unique_id: str | None = None, *, raise_on_progress: bool = True) -> ConfigEntry | None: ...
+    @callback
     def _set_confirm_only(self) -> None: ...
+    @callback
     def _async_current_entries(self, include_ignore: bool | None = None) -> list[ConfigEntry]: ...
+    @callback
     def _async_current_ids(self, include_ignore: bool = True) -> set[str | None]: ...
+    @callback
     def _async_in_progress(self, include_uninitialized: bool = False, match_context: dict[str, Any] | None = None) -> list[ConfigFlowResult]: ...
     async def async_step_ignore(self, user_input: dict[str, Any]) -> ConfigFlowResult: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def _async_handle_discovery_without_unique_id(self) -> None: ...
     async def _async_step_discovery_without_unique_id(self) -> ConfigFlowResult: ...
     async def async_step_discovery(self, discovery_info: DiscoveryInfoType) -> ConfigFlowResult: ...
+    @callback
     def async_abort(self, *, reason: str, description_placeholders: Mapping[str, str] | None = None) -> ConfigFlowResult: ...
     async def async_step_bluetooth(self, discovery_info: BluetoothServiceInfoBleak) -> ConfigFlowResult: ...
     async def async_step_dhcp(self, discovery_info: DhcpServiceInfo) -> ConfigFlowResult: ...
@@ -321,15 +364,20 @@ class ConfigFlow(ConfigEntryBaseFlow):
     async def async_step_ssdp(self, discovery_info: SsdpServiceInfo) -> ConfigFlowResult: ...
     async def async_step_usb(self, discovery_info: UsbServiceInfo) -> ConfigFlowResult: ...
     async def async_step_zeroconf(self, discovery_info: ZeroconfServiceInfo) -> ConfigFlowResult: ...
+    @callback
     def async_create_entry(self, *, title: str, data: Mapping[str, Any], description: str | None = None, description_placeholders: Mapping[str, str] | None = None, options: Mapping[str, Any] | None = None) -> ConfigFlowResult: ...
+    @callback
     def async_update_reload_and_abort(self, entry: ConfigEntry, *, unique_id: str | None | UndefinedType = ..., title: str | UndefinedType = ..., data: Mapping[str, Any] | UndefinedType = ..., data_updates: Mapping[str, Any] | UndefinedType = ..., options: Mapping[str, Any] | UndefinedType = ..., reason: str | UndefinedType = ..., reload_even_if_entry_is_unchanged: bool = True) -> ConfigFlowResult: ...
+    @callback
     def async_show_form(self, *, step_id: str | None = None, data_schema: vol.Schema | None = None, errors: dict[str, str] | None = None, description_placeholders: Mapping[str, str] | None = None, last_step: bool | None = None, preview: str | None = None) -> ConfigFlowResult: ...
     def is_matching(self, other_flow: Self) -> bool: ...
     @property
     def _reauth_entry_id(self) -> str: ...
+    @callback
     def _get_reauth_entry(self) -> ConfigEntry: ...
     @property
     def _reconfigure_entry_id(self) -> str: ...
+    @callback
     def _get_reconfigure_entry(self) -> ConfigEntry: ...
 
 class OptionsFlowManager(data_entry_flow.FlowManager[ConfigFlowContext, ConfigFlowResult]):
@@ -342,6 +390,7 @@ class OptionsFlowManager(data_entry_flow.FlowManager[ConfigFlowContext, ConfigFl
 class OptionsFlow(ConfigEntryBaseFlow):
     handler: str
     _config_entry: ConfigEntry
+    @callback
     def _async_abort_entries_match(self, match_dict: dict[str, Any] | None = None) -> None: ...
     @property
     def _config_entry_id(self) -> str: ...
@@ -363,10 +412,14 @@ class EntityRegistryDisabledHandler:
     changed: set[str]
     _remove_call_later: Callable[[], None] | None
     def __init__(self, hass: HomeAssistant) -> None: ...
+    @callback
     def async_setup(self) -> None: ...
+    @callback
     def _handle_entry_updated(self, event: Event[er.EventEntityRegistryUpdatedData]) -> None: ...
+    @callback
     def _async_handle_reload(self, _now: Any) -> None: ...
 
+@callback
 def _handle_entry_updated_filter(event_data: er.EventEntityRegistryUpdatedData) -> bool: ...
 async def support_entry_unload(hass: HomeAssistant, domain: str) -> bool: ...
 async def support_remove_from_device(hass: HomeAssistant, domain: str) -> bool: ...

homeassistant-stubs/core.pyi

@@ -2,6 +2,7 @@ import asyncio
 import concurrent.futures
 import datetime
 import enum
+import functools
 import threading
 import voluptuous as vol
 from . import util as util
@@ -84,6 +85,7 @@ class _Hass(threading.local):
 
 _hass: Incomplete
 
+@callback
 def async_get_hass() -> HomeAssistant: ...
 def async_get_hass_or_none() -> HomeAssistant | None: ...
 
@@ -93,6 +95,7 @@ class ReleaseChannel(enum.StrEnum):
     NIGHTLY = 'nightly'
     STABLE = 'stable'
 
+@callback
 def get_release_channel() -> ReleaseChannel: ...
 
 class HassJobType(enum.Enum):
@@ -117,7 +120,6 @@ class HassJob[**_P, _R_co]:
 class HassJobWithArgs:
     job: HassJob[..., Coroutine[Any, Any, Any] | Any]
     args: Iterable[Any]
-    def __init__(self, job, args) -> None: ...
 
 def get_hassjob_callable_job_type(target: Callable[..., Any]) -> HassJobType: ...
 
@@ -168,41 +170,60 @@ class HomeAssistant:
     async def async_start(self) -> None: ...
     def add_job[*_Ts](self, target: Callable[[*_Ts], Any] | Coroutine[Any, Any, Any], *args: *_Ts) -> None: ...
     @overload
+    @callback
     def async_add_job[_R, *_Ts](self, target: Callable[[*_Ts], Coroutine[Any, Any, _R]], *args: *_Ts, eager_start: bool = False) -> asyncio.Future[_R] | None: ...
     @overload
+    @callback
     def async_add_job[_R, *_Ts](self, target: Callable[[*_Ts], Coroutine[Any, Any, _R] | _R], *args: *_Ts, eager_start: bool = False) -> asyncio.Future[_R] | None: ...
     @overload
+    @callback
     def async_add_job[_R](self, target: Coroutine[Any, Any, _R], *args: Any, eager_start: bool = False) -> asyncio.Future[_R] | None: ...
     @overload
+    @callback
     def async_add_hass_job[_R](self, hassjob: HassJob[..., Coroutine[Any, Any, _R]], *args: Any, eager_start: bool = False, background: bool = False) -> asyncio.Future[_R] | None: ...
     @overload
+    @callback
     def async_add_hass_job[_R](self, hassjob: HassJob[..., Coroutine[Any, Any, _R] | _R], *args: Any, eager_start: bool = False, background: bool = False) -> asyncio.Future[_R] | None: ...
     @overload
+    @callback
     def _async_add_hass_job[_R](self, hassjob: HassJob[..., Coroutine[Any, Any, _R]], *args: Any, background: bool = False) -> asyncio.Future[_R] | None: ...
     @overload
+    @callback
     def _async_add_hass_job[_R](self, hassjob: HassJob[..., Coroutine[Any, Any, _R] | _R], *args: Any, background: bool = False) -> asyncio.Future[_R] | None: ...
     def create_task(self, target: Coroutine[Any, Any, Any], name: str | None = None) -> None: ...
+    @callback
     def async_create_task[_R](self, target: Coroutine[Any, Any, _R], name: str | None = None, eager_start: bool = True) -> asyncio.Task[_R]: ...
+    @callback
     def async_create_task_internal[_R](self, target: Coroutine[Any, Any, _R], name: str | None = None, eager_start: bool = True) -> asyncio.Task[_R]: ...
+    @callback
     def async_create_background_task[_R](self, target: Coroutine[Any, Any, _R], name: str, eager_start: bool = True) -> asyncio.Task[_R]: ...
+    @callback
     def async_add_executor_job[*_Ts, _T](self, target: Callable[[*_Ts], _T], *args: *_Ts) -> asyncio.Future[_T]: ...
+    @callback
     def async_add_import_executor_job[*_Ts, _T](self, target: Callable[[*_Ts], _T], *args: *_Ts) -> asyncio.Future[_T]: ...
     @overload
+    @callback
     def async_run_hass_job[_R](self, hassjob: HassJob[..., Coroutine[Any, Any, _R]], *args: Any, background: bool = False) -> asyncio.Future[_R] | None: ...
     @overload
+    @callback
     def async_run_hass_job[_R](self, hassjob: HassJob[..., Coroutine[Any, Any, _R] | _R], *args: Any, background: bool = False) -> asyncio.Future[_R] | None: ...
     @overload
+    @callback
     def async_run_job[_R, *_Ts](self, target: Callable[[*_Ts], Coroutine[Any, Any, _R]], *args: *_Ts) -> asyncio.Future[_R] | None: ...
     @overload
+    @callback
     def async_run_job[_R, *_Ts](self, target: Callable[[*_Ts], Coroutine[Any, Any, _R] | _R], *args: *_Ts) -> asyncio.Future[_R] | None: ...
     @overload
+    @callback
     def async_run_job[_R](self, target: Coroutine[Any, Any, _R], *args: Any) -> asyncio.Future[_R] | None: ...
     def block_till_done(self, wait_background_tasks: bool = False) -> None: ...
     async def async_block_till_done(self, wait_background_tasks: bool = False) -> None: ...
     async def _await_and_log_pending(self, pending: Collection[asyncio.Future[Any]]) -> None: ...
     @overload
+    @callback
     def async_add_shutdown_job(self, hassjob: HassJob[..., Coroutine[Any, Any, Any]], *args: Any) -> CALLBACK_TYPE: ...
     @overload
+    @callback
     def async_add_shutdown_job(self, hassjob: HassJob[..., Coroutine[Any, Any, Any] | Any], *args: Any) -> CALLBACK_TYPE: ...
     def stop(self) -> None: ...
     async def async_stop(self, exit_code: int = 0, *, force: bool = False) -> None: ...
@@ -264,12 +285,13 @@ class _OneTimeListener(Generic[_DataT]):
     hass: HomeAssistant
     listener_job: HassJob[[Event[_DataT]], Coroutine[Any, Any, None] | None]
     remove: CALLBACK_TYPE | None = ...
+    @callback
     def __call__(self, event: Event[_DataT]) -> None: ...
     def __repr__(self) -> str: ...
-    def __init__(self, hass, listener_job, remove=...) -> None: ...
 
 EMPTY_LIST: list[Any]
 
+@functools.lru_cache
 def _verify_event_type_length_or_raise(event_type: EventType[_DataT] | str) -> None: ...
 
 class EventBus:
@@ -279,18 +301,26 @@ class EventBus:
     _hass: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
     _debug: Incomplete
+    @callback
     def _async_logging_changed(self, event: Event | None = None) -> None: ...
+    @callback
     def async_listeners(self) -> dict[EventType[Any] | str, int]: ...
     @property
     def listeners(self) -> dict[EventType[Any] | str, int]: ...
     def fire(self, event_type: EventType[_DataT] | str, event_data: _DataT | None = None, origin: EventOrigin = ..., context: Context | None = None) -> None: ...
+    @callback
     def async_fire(self, event_type: EventType[_DataT] | str, event_data: _DataT | None = None, origin: EventOrigin = ..., context: Context | None = None, time_fired: float | None = None) -> None: ...
+    @callback
     def async_fire_internal(self, event_type: EventType[_DataT] | str, event_data: _DataT | None = None, origin: EventOrigin = ..., context: Context | None = None, time_fired: float | None = None) -> None: ...
     def listen(self, event_type: EventType[_DataT] | str, listener: Callable[[Event[_DataT]], Coroutine[Any, Any, None] | None]) -> CALLBACK_TYPE: ...
+    @callback
     def async_listen(self, event_type: EventType[_DataT] | str, listener: Callable[[Event[_DataT]], Coroutine[Any, Any, None] | None], event_filter: Callable[[_DataT], bool] | None = None, run_immediately: bool | object = ...) -> CALLBACK_TYPE: ...
+    @callback
     def _async_listen_filterable_job(self, event_type: EventType[_DataT] | str, filterable_job: _FilterableJobType[_DataT]) -> CALLBACK_TYPE: ...
     def listen_once(self, event_type: EventType[_DataT] | str, listener: Callable[[Event[_DataT]], Coroutine[Any, Any, None] | None]) -> CALLBACK_TYPE: ...
+    @callback
     def async_listen_once(self, event_type: EventType[_DataT] | str, listener: Callable[[Event[_DataT]], Coroutine[Any, Any, None] | None], run_immediately: bool | object = ...) -> CALLBACK_TYPE: ...
+    @callback
     def _async_remove_listener(self, event_type: EventType[_DataT] | str, filterable_job: _FilterableJobType[_DataT]) -> None: ...
 
 class CompressedState(TypedDict):
@@ -355,18 +385,26 @@ class StateMachine:
     _loop: Incomplete
     def __init__(self, bus: EventBus, loop: asyncio.events.AbstractEventLoop) -> None: ...
     def entity_ids(self, domain_filter: str | None = None) -> list[str]: ...
+    @callback
     def async_entity_ids(self, domain_filter: str | Iterable[str] | None = None) -> list[str]: ...
+    @callback
     def async_entity_ids_count(self, domain_filter: str | Iterable[str] | None = None) -> int: ...
     def all(self, domain_filter: str | Iterable[str] | None = None) -> list[State]: ...
+    @callback
     def async_all(self, domain_filter: str | Iterable[str] | None = None) -> list[State]: ...
     def get(self, entity_id: str) -> State | None: ...
     def is_state(self, entity_id: str, state: str) -> bool: ...
     def remove(self, entity_id: str) -> bool: ...
+    @callback
     def async_remove(self, entity_id: str, context: Context | None = None) -> bool: ...
     def set(self, entity_id: str, new_state: str, attributes: Mapping[str, Any] | None = None, force_update: bool = False, context: Context | None = None) -> None: ...
+    @callback
     def async_reserve(self, entity_id: str) -> None: ...
+    @callback
     def async_available(self, entity_id: str) -> bool: ...
+    @callback
     def async_set(self, entity_id: str, new_state: str, attributes: Mapping[str, Any] | None = None, force_update: bool = False, context: Context | None = None, state_info: StateInfo | None = None, timestamp: float | None = None) -> None: ...
+    @callback
     def async_set_internal(self, entity_id: str, new_state: str, attributes: Mapping[str, Any] | None, force_update: bool, context: Context | None, state_info: StateInfo | None, timestamp: float) -> None: ...
 
 class SupportsResponse(enum.StrEnum):
@@ -399,16 +437,23 @@ class ServiceRegistry:
     def __init__(self, hass: HomeAssistant) -> None: ...
     @property
     def services(self) -> dict[str, dict[str, Service]]: ...
+    @callback
     def async_services(self) -> dict[str, dict[str, Service]]: ...
+    @callback
     def async_services_for_domain(self, domain: str) -> dict[str, Service]: ...
+    @callback
     def async_services_internal(self) -> dict[str, dict[str, Service]]: ...
     def has_service(self, domain: str, service: str) -> bool: ...
     def supports_response(self, domain: str, service: str) -> SupportsResponse: ...
     def register(self, domain: str, service: str, service_func: Callable[[ServiceCall], Coroutine[Any, Any, ServiceResponse] | ServiceResponse | None], schema: vol.Schema | None = None, supports_response: SupportsResponse = ...) -> None: ...
+    @callback
     def async_register(self, domain: str, service: str, service_func: Callable[[ServiceCall], Coroutine[Any, Any, ServiceResponse | EntityServiceResponse] | ServiceResponse | EntityServiceResponse | None], schema: VolSchemaType | None = None, supports_response: SupportsResponse = ..., job_type: HassJobType | None = None) -> None: ...
+    @callback
     def _async_register(self, domain: str, service: str, service_func: Callable[[ServiceCall], Coroutine[Any, Any, ServiceResponse | EntityServiceResponse] | ServiceResponse | EntityServiceResponse | None], schema: VolSchemaType | None = None, supports_response: SupportsResponse = ..., job_type: HassJobType | None = None) -> None: ...
     def remove(self, domain: str, service: str) -> None: ...
+    @callback
     def async_remove(self, domain: str, service: str) -> None: ...
+    @callback
     def _async_remove(self, domain: str, service: str) -> None: ...
     def call(self, domain: str, service: str, service_data: dict[str, Any] | None = None, blocking: bool = False, context: Context | None = None, target: dict[str, Any] | None = None, return_response: bool = False) -> ServiceResponse: ...
     async def async_call(self, domain: str, service: str, service_data: dict[str, Any] | None = None, blocking: bool = False, context: Context | None = None, target: dict[str, Any] | None = None, return_response: bool = False) -> ServiceResponse: ...