homeassistant-stubs 2024.4.4__py3-none-any.whl → 2024.5.0b0__py3-none-any.whl

homeassistant-stubs/components/withings/__init__.pyi

@@ -1,4 +1,4 @@
-from .const import CONF_PROFILES as CONF_PROFILES, CONF_USE_WEBHOOK as CONF_USE_WEBHOOK, DEFAULT_TITLE as DEFAULT_TITLE, DOMAIN as DOMAIN, LOGGER as LOGGER
+from .const import DEFAULT_TITLE as DEFAULT_TITLE, DOMAIN as DOMAIN, LOGGER as LOGGER
 from .coordinator import WithingsActivityDataUpdateCoordinator as WithingsActivityDataUpdateCoordinator, WithingsBedPresenceDataUpdateCoordinator as WithingsBedPresenceDataUpdateCoordinator, WithingsDataUpdateCoordinator as WithingsDataUpdateCoordinator, WithingsGoalsDataUpdateCoordinator as WithingsGoalsDataUpdateCoordinator, WithingsMeasurementDataUpdateCoordinator as WithingsMeasurementDataUpdateCoordinator, WithingsSleepDataUpdateCoordinator as WithingsSleepDataUpdateCoordinator, WithingsWorkoutDataUpdateCoordinator as WithingsWorkoutDataUpdateCoordinator
 from _typeshed import Incomplete
 from aiohttp.web import Request as Request, Response as Response
@@ -6,26 +6,20 @@ from aiowithings import WithingsClient
 from collections.abc import Awaitable, Callable as Callable
 from dataclasses import dataclass
 from homeassistant.components import cloud as cloud
-from homeassistant.components.application_credentials import ClientCredential as ClientCredential, async_import_client_credential as async_import_client_credential
 from homeassistant.components.http import HomeAssistantView as HomeAssistantView
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
-from homeassistant.const import CONF_ACCESS_TOKEN as CONF_ACCESS_TOKEN, CONF_CLIENT_ID as CONF_CLIENT_ID, CONF_CLIENT_SECRET as CONF_CLIENT_SECRET, CONF_TOKEN as CONF_TOKEN, CONF_WEBHOOK_ID as CONF_WEBHOOK_ID, EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP, Platform as Platform
+from homeassistant.const import CONF_ACCESS_TOKEN as CONF_ACCESS_TOKEN, CONF_TOKEN as CONF_TOKEN, CONF_WEBHOOK_ID as CONF_WEBHOOK_ID, EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP, Platform as Platform
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
 from homeassistant.helpers.config_entry_oauth2_flow import OAuth2Session as OAuth2Session, async_get_config_entry_implementation as async_get_config_entry_implementation
 from homeassistant.helpers.event import async_call_later as async_call_later
-from homeassistant.helpers.issue_registry import IssueSeverity as IssueSeverity, async_create_issue as async_create_issue
-from homeassistant.helpers.typing import ConfigType as ConfigType
 from typing import Any
 
 PLATFORMS: Incomplete
-CONFIG_SCHEMA: Incomplete
 SUBSCRIBE_DELAY: Incomplete
 UNSUBSCRIBE_DELAY: Incomplete
 CONF_CLOUDHOOK_URL: str
 
-async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
-
 @dataclass(slots=True)
 class WithingsData:
     client: WithingsClient

homeassistant-stubs/components/withings/config_flow.pyi

@@ -1,5 +1,5 @@
 import logging
-from .const import CONF_USE_WEBHOOK as CONF_USE_WEBHOOK, DEFAULT_TITLE as DEFAULT_TITLE, DOMAIN as DOMAIN
+from .const import DEFAULT_TITLE as DEFAULT_TITLE, DOMAIN as DOMAIN
 from collections.abc import Mapping
 from homeassistant.components.webhook import async_generate_id as async_generate_id
 from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigFlowResult as ConfigFlowResult

homeassistant-stubs/components/withings/const.pyi

@@ -2,8 +2,6 @@ from _typeshed import Incomplete
 
 LOGGER: Incomplete
 DEFAULT_TITLE: str
-CONF_PROFILES: str
-CONF_USE_WEBHOOK: str
 DOMAIN: str
 SCORE_POINTS: str
 UOM_BEATS_PER_MINUTE: str

homeassistant-stubs/components/zone/__init__.pyi

@@ -3,7 +3,7 @@ from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from homeassistant import config_entries as config_entries
 from homeassistant.const import ATTR_EDITABLE as ATTR_EDITABLE, ATTR_LATITUDE as ATTR_LATITUDE, ATTR_LONGITUDE as ATTR_LONGITUDE, ATTR_PERSONS as ATTR_PERSONS, CONF_ICON as CONF_ICON, CONF_ID as CONF_ID, CONF_LATITUDE as CONF_LATITUDE, CONF_LONGITUDE as CONF_LONGITUDE, CONF_NAME as CONF_NAME, CONF_RADIUS as CONF_RADIUS, EVENT_CORE_CONFIG_UPDATE as EVENT_CORE_CONFIG_UPDATE, SERVICE_RELOAD as SERVICE_RELOAD, STATE_HOME as STATE_HOME, STATE_NOT_HOME as STATE_NOT_HOME, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN
-from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, State as State, callback as callback
+from homeassistant.core import Event as Event, EventStateChangedData as EventStateChangedData, HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, State as State, callback as callback
 from homeassistant.helpers import collection as collection, entity_component as entity_component, event as event, service as service, storage as storage
 from homeassistant.helpers.typing import ConfigType as ConfigType
 from homeassistant.loader import bind_hass as bind_hass
@@ -47,27 +47,25 @@ async def async_unload_entry(hass: HomeAssistant, config_entry: config_entries.C
 
 class Zone(collection.CollectionEntity):
     editable: bool
+    _attr_should_poll: bool
     _config: Incomplete
     _attrs: Incomplete
     _remove_listener: Incomplete
     _persons_in_zone: Incomplete
     def __init__(self, config: ConfigType) -> None: ...
+    _attr_name: Incomplete
+    _case_folded_name: Incomplete
+    _attr_unique_id: Incomplete
+    _attr_icon: Incomplete
+    def _set_attrs_from_config(self) -> None: ...
     @classmethod
     def from_storage(cls, config: ConfigType) -> Self: ...
     @classmethod
     def from_yaml(cls, config: ConfigType) -> Self: ...
     @property
     def state(self) -> int: ...
-    @property
-    def name(self) -> str: ...
-    @property
-    def unique_id(self) -> str | None: ...
-    @property
-    def icon(self) -> str | None: ...
-    @property
-    def should_poll(self) -> bool: ...
     async def async_update_config(self, config: ConfigType) -> None: ...
-    def _person_state_change_listener(self, evt: Event[event.EventStateChangedData]) -> None: ...
+    def _person_state_change_listener(self, evt: Event[EventStateChangedData]) -> None: ...
     async def async_added_to_hass(self) -> None: ...
     _attr_extra_state_attributes: Incomplete
     def _generate_attrs(self) -> None: ...

homeassistant-stubs/components/zone/trigger.pyi

@@ -1,8 +1,8 @@
 from _typeshed import Incomplete
 from homeassistant.const import ATTR_FRIENDLY_NAME as ATTR_FRIENDLY_NAME, CONF_ENTITY_ID as CONF_ENTITY_ID, CONF_EVENT as CONF_EVENT, CONF_PLATFORM as CONF_PLATFORM, CONF_ZONE as CONF_ZONE
-from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Event as Event, HassJob as HassJob, HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Event as Event, EventStateChangedData as EventStateChangedData, HassJob as HassJob, HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers import condition as condition, location as location
-from homeassistant.helpers.event import EventStateChangedData as EventStateChangedData, async_track_state_change_event as async_track_state_change_event
+from homeassistant.helpers.event import async_track_state_change_event as async_track_state_change_event
 from homeassistant.helpers.trigger import TriggerActionType as TriggerActionType, TriggerInfo as TriggerInfo
 from homeassistant.helpers.typing import ConfigType as ConfigType
 

homeassistant-stubs/components/zwave_js/config_flow.pyi

@@ -51,7 +51,7 @@ class BaseZwaveJSFlow(ConfigEntryBaseFlow, ABC, metaclass=abc.ABCMeta):
     def __init__(self) -> None: ...
     @property
     @abstractmethod
-    def flow_manager(self) -> FlowManager[ConfigFlowResult, str]: ...
+    def flow_manager(self) -> FlowManager[ConfigFlowResult]: ...
     async def async_step_install_addon(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_install_failed(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_start_addon(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/config.pyi

@@ -1,6 +1,6 @@
 import voluptuous as vol
 from . import auth as auth
-from .const import ATTR_ASSUMED_STATE as ATTR_ASSUMED_STATE, ATTR_FRIENDLY_NAME as ATTR_FRIENDLY_NAME, ATTR_HIDDEN as ATTR_HIDDEN, CONF_ALLOWLIST_EXTERNAL_DIRS as CONF_ALLOWLIST_EXTERNAL_DIRS, CONF_ALLOWLIST_EXTERNAL_URLS as CONF_ALLOWLIST_EXTERNAL_URLS, CONF_AUTH_MFA_MODULES as CONF_AUTH_MFA_MODULES, CONF_AUTH_PROVIDERS as CONF_AUTH_PROVIDERS, CONF_COUNTRY as CONF_COUNTRY, CONF_CURRENCY as CONF_CURRENCY, CONF_CUSTOMIZE as CONF_CUSTOMIZE, CONF_CUSTOMIZE_DOMAIN as CONF_CUSTOMIZE_DOMAIN, CONF_CUSTOMIZE_GLOB as CONF_CUSTOMIZE_GLOB, CONF_ELEVATION as CONF_ELEVATION, CONF_EXTERNAL_URL as CONF_EXTERNAL_URL, CONF_ID as CONF_ID, CONF_INTERNAL_URL as CONF_INTERNAL_URL, CONF_LANGUAGE as CONF_LANGUAGE, CONF_LATITUDE as CONF_LATITUDE, CONF_LEGACY_TEMPLATES as CONF_LEGACY_TEMPLATES, CONF_LONGITUDE as CONF_LONGITUDE, CONF_MEDIA_DIRS as CONF_MEDIA_DIRS, CONF_NAME as CONF_NAME, CONF_PACKAGES as CONF_PACKAGES, CONF_PLATFORM as CONF_PLATFORM, CONF_TEMPERATURE_UNIT as CONF_TEMPERATURE_UNIT, CONF_TIME_ZONE as CONF_TIME_ZONE, CONF_TYPE as CONF_TYPE, CONF_UNIT_SYSTEM as CONF_UNIT_SYSTEM, LEGACY_CONF_WHITELIST_EXTERNAL_DIRS as LEGACY_CONF_WHITELIST_EXTERNAL_DIRS, __version__ as __version__
+from .const import ATTR_ASSUMED_STATE as ATTR_ASSUMED_STATE, ATTR_FRIENDLY_NAME as ATTR_FRIENDLY_NAME, ATTR_HIDDEN as ATTR_HIDDEN, CONF_ALLOWLIST_EXTERNAL_DIRS as CONF_ALLOWLIST_EXTERNAL_DIRS, CONF_ALLOWLIST_EXTERNAL_URLS as CONF_ALLOWLIST_EXTERNAL_URLS, CONF_AUTH_MFA_MODULES as CONF_AUTH_MFA_MODULES, CONF_AUTH_PROVIDERS as CONF_AUTH_PROVIDERS, CONF_COUNTRY as CONF_COUNTRY, CONF_CURRENCY as CONF_CURRENCY, CONF_CUSTOMIZE as CONF_CUSTOMIZE, CONF_CUSTOMIZE_DOMAIN as CONF_CUSTOMIZE_DOMAIN, CONF_CUSTOMIZE_GLOB as CONF_CUSTOMIZE_GLOB, CONF_DEBUG as CONF_DEBUG, CONF_ELEVATION as CONF_ELEVATION, CONF_EXTERNAL_URL as CONF_EXTERNAL_URL, CONF_ID as CONF_ID, CONF_INTERNAL_URL as CONF_INTERNAL_URL, CONF_LANGUAGE as CONF_LANGUAGE, CONF_LATITUDE as CONF_LATITUDE, CONF_LEGACY_TEMPLATES as CONF_LEGACY_TEMPLATES, CONF_LONGITUDE as CONF_LONGITUDE, CONF_MEDIA_DIRS as CONF_MEDIA_DIRS, CONF_NAME as CONF_NAME, CONF_PACKAGES as CONF_PACKAGES, CONF_PLATFORM as CONF_PLATFORM, CONF_TEMPERATURE_UNIT as CONF_TEMPERATURE_UNIT, CONF_TIME_ZONE as CONF_TIME_ZONE, CONF_TYPE as CONF_TYPE, CONF_UNIT_SYSTEM as CONF_UNIT_SYSTEM, LEGACY_CONF_WHITELIST_EXTERNAL_DIRS as LEGACY_CONF_WHITELIST_EXTERNAL_DIRS, __version__ as __version__
 from .core import ConfigSource as ConfigSource, HomeAssistant as HomeAssistant, callback as callback
 from .exceptions import ConfigValidationError as ConfigValidationError, HomeAssistantError as HomeAssistantError
 from .generated.currencies import HISTORIC_CURRENCIES as HISTORIC_CURRENCIES

homeassistant-stubs/config_entries.pyi

@@ -118,25 +118,27 @@ class ConfigEntry:
     unique_id: str | None
     state: ConfigEntryState
     reason: str | None
+    error_reason_translation_key: str | None
+    error_reason_translation_placeholders: dict[str, Any] | None
     pref_disable_new_entities: bool
     pref_disable_polling: bool
     version: int
+    source: str
     minor_version: int
-    source: Incomplete
-    disabled_by: Incomplete
-    supports_unload: Incomplete
-    supports_remove_device: Incomplete
-    _supports_options: Incomplete
-    _supports_reconfigure: Incomplete
-    update_listeners: Incomplete
-    _async_cancel_retry_setup: Incomplete
-    _on_unload: Incomplete
-    reload_lock: Incomplete
-    _reauth_lock: Incomplete
-    _reconfigure_lock: Incomplete
-    _tasks: Incomplete
-    _background_tasks: Incomplete
-    _integration_for_domain: Incomplete
+    disabled_by: ConfigEntryDisabler | None
+    supports_unload: bool | None
+    supports_remove_device: bool | None
+    _supports_options: bool | None
+    _supports_reconfigure: bool | None
+    update_listeners: list[UpdateListenerType]
+    _async_cancel_retry_setup: Callable[[], Any] | None
+    _on_unload: list[Callable[[], Coroutine[Any, Any, None] | None]] | None
+    reload_lock: asyncio.Lock
+    _reauth_lock: asyncio.Lock
+    _reconfigure_lock: asyncio.Lock
+    _tasks: set[asyncio.Future[Any]]
+    _background_tasks: set[asyncio.Future[Any]]
+    _integration_for_domain: loader.Integration | None
     _tries: int
     def __init__(self, *, version: int, minor_version: int, domain: str, title: str, data: Mapping[str, Any], source: str, pref_disable_new_entities: bool | None = None, pref_disable_polling: bool | None = None, options: Mapping[str, Any] | None = None, unique_id: str | None = None, entry_id: str | None = None, state: ConfigEntryState = ..., disabled_by: ConfigEntryDisabler | None = None) -> None: ...
     def __repr__(self) -> str: ...
@@ -150,11 +152,12 @@ class ConfigEntry:
     def as_json_fragment(self) -> json_fragment: ...
     async def async_setup(self, hass: HomeAssistant, *, integration: loader.Integration | None = None) -> None: ...
     def _async_setup_again(self, hass: HomeAssistant, *_: Any) -> None: ...
+    async def _async_setup_retry(self, hass: HomeAssistant) -> None: ...
     def async_shutdown(self) -> None: ...
     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: ...
-    def _async_set_state(self, hass: HomeAssistant, state: ConfigEntryState, reason: str | None) -> None: ...
+    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]: ...
@@ -165,14 +168,14 @@ class ConfigEntry:
     def async_start_reconfigure(self, hass: HomeAssistant, context: dict[str, Any] | None = None, data: dict[str, Any] | None = None) -> None: ...
     async def _async_init_reconfigure(self, hass: HomeAssistant, context: dict[str, Any] | None = None, data: dict[str, Any] | None = None) -> None: ...
     def async_get_active_flows(self, hass: HomeAssistant, sources: set[str]) -> Generator[ConfigFlowResult, None, None]: ...
-    def async_create_task(self, hass: HomeAssistant, target: Coroutine[Any, Any, _R], name: str | None = None, eager_start: bool = False) -> asyncio.Task[_R]: ...
-    def async_create_background_task(self, hass: HomeAssistant, target: Coroutine[Any, Any, _R], name: str, eager_start: bool = False) -> asyncio.Task[_R]: ...
+    def async_create_task(self, hass: HomeAssistant, target: Coroutine[Any, Any, _R], name: str | None = None, eager_start: bool = True) -> asyncio.Task[_R]: ...
+    def async_create_background_task(self, hass: HomeAssistant, target: Coroutine[Any, Any, _R], name: str, eager_start: bool = True) -> asyncio.Task[_R]: ...
 
 current_entry: ContextVar[ConfigEntry | None]
 
 class FlowCancelledError(Exception): ...
 
-class ConfigEntriesFlowManager(data_entry_flow.FlowManager[ConfigFlowResult, str]):
+class ConfigEntriesFlowManager(data_entry_flow.FlowManager[ConfigFlowResult]):
     _flow_result = ConfigFlowResult
     config_entries: Incomplete
     _hass_config: Incomplete
@@ -185,9 +188,9 @@ class ConfigEntriesFlowManager(data_entry_flow.FlowManager[ConfigFlowResult, str
     async def async_init(self, handler: str, *, context: dict[str, Any] | None = None, data: Any = None) -> ConfigFlowResult: ...
     async def _async_init(self, flow_id: str, handler: str, context: dict, data: Any) -> tuple[ConfigFlow, ConfigFlowResult]: ...
     def async_shutdown(self) -> None: ...
-    async def async_finish_flow(self, flow: data_entry_flow.FlowHandler[ConfigFlowResult, str], result: ConfigFlowResult) -> ConfigFlowResult: ...
+    async def async_finish_flow(self, flow: data_entry_flow.FlowHandler[ConfigFlowResult], result: ConfigFlowResult) -> ConfigFlowResult: ...
     async def async_create_flow(self, handler_key: str, *, context: dict | None = None, data: Any = None) -> ConfigFlow: ...
-    async def async_post_init(self, flow: data_entry_flow.FlowHandler[ConfigFlowResult, str], result: ConfigFlowResult) -> None: ...
+    async def async_post_init(self, flow: data_entry_flow.FlowHandler[ConfigFlowResult], result: ConfigFlowResult) -> None: ...
     def _async_discovery(self) -> None: ...
 
 class ConfigEntryItems(UserDict[str, ConfigEntry]):
@@ -240,7 +243,7 @@ class ConfigEntries:
 async def _old_conf_migrator(old_config: dict[str, Any]) -> dict[str, Any]: ...
 def _async_abort_entries_match(other_entries: list[ConfigEntry], match_dict: dict[str, Any] | None = None) -> None: ...
 
-class ConfigEntryBaseFlow(data_entry_flow.FlowHandler[ConfigFlowResult, str]):
+class ConfigEntryBaseFlow(data_entry_flow.FlowHandler[ConfigFlowResult]):
     _flow_result = ConfigFlowResult
 
 class ConfigFlow(ConfigEntryBaseFlow):
@@ -275,14 +278,14 @@ class ConfigFlow(ConfigEntryBaseFlow):
     async def async_step_usb(self, discovery_info: UsbServiceInfo) -> ConfigFlowResult: ...
     async def async_step_zeroconf(self, discovery_info: ZeroconfServiceInfo) -> ConfigFlowResult: ...
     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: ...
-    def async_update_reload_and_abort(self, entry: ConfigEntry, *, unique_id: str | None | UndefinedType = ..., title: str | UndefinedType = ..., data: Mapping[str, Any] | UndefinedType = ..., options: Mapping[str, Any] | UndefinedType = ..., reason: str = 'reauth_successful') -> ConfigFlowResult: ...
+    def async_update_reload_and_abort(self, entry: ConfigEntry, *, unique_id: str | None | UndefinedType = ..., title: str | UndefinedType = ..., data: Mapping[str, Any] | UndefinedType = ..., options: Mapping[str, Any] | UndefinedType = ..., reason: str = 'reauth_successful', reload_even_if_entry_is_unchanged: bool = True) -> ConfigFlowResult: ...
 
-class OptionsFlowManager(data_entry_flow.FlowManager[ConfigFlowResult, str]):
+class OptionsFlowManager(data_entry_flow.FlowManager[ConfigFlowResult]):
     _flow_result = ConfigFlowResult
     def _async_get_config_entry(self, config_entry_id: str) -> ConfigEntry: ...
     async def async_create_flow(self, handler_key: str, *, context: dict[str, Any] | None = None, data: dict[str, Any] | None = None) -> OptionsFlow: ...
-    async def async_finish_flow(self, flow: data_entry_flow.FlowHandler[ConfigFlowResult, str], result: ConfigFlowResult) -> ConfigFlowResult: ...
-    async def _async_setup_preview(self, flow: data_entry_flow.FlowHandler[ConfigFlowResult, str]) -> None: ...
+    async def async_finish_flow(self, flow: data_entry_flow.FlowHandler[ConfigFlowResult], result: ConfigFlowResult) -> ConfigFlowResult: ...
+    async def _async_setup_preview(self, flow: data_entry_flow.FlowHandler[ConfigFlowResult]) -> None: ...
 
 class OptionsFlow(ConfigEntryBaseFlow):
     handler: str
@@ -304,10 +307,10 @@ class EntityRegistryDisabledHandler:
     _remove_call_later: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
     def async_setup(self) -> None: ...
-    def _handle_entry_updated(self, event: Event) -> None: ...
-    async def _handle_reload(self, _now: Any) -> None: ...
+    def _handle_entry_updated(self, event: Event[entity_registry.EventEntityRegistryUpdatedData]) -> None: ...
+    def _async_handle_reload(self, _now: Any) -> None: ...
 
-def _handle_entry_updated_filter(event_data: Mapping[str, Any]) -> bool: ...
+def _handle_entry_updated_filter(event_data: entity_registry.EventEntityRegistryUpdatedData) -> bool: ...
 async def support_entry_unload(hass: HomeAssistant, domain: str) -> bool: ...
 async def support_remove_from_device(hass: HomeAssistant, domain: str) -> bool: ...
 async def _support_single_config_entry_only(hass: HomeAssistant, domain: str) -> bool: ...

homeassistant-stubs/const.pyi

@@ -1,4 +1,7 @@
+from .core import EventStateChangedData as EventStateChangedData
 from .helpers.deprecation import DeprecatedConstant as DeprecatedConstant, DeprecatedConstantEnum as DeprecatedConstantEnum, all_with_deprecated_constants as all_with_deprecated_constants, check_if_deprecated_constant as check_if_deprecated_constant, dir_with_deprecated_constants as dir_with_deprecated_constants
+from .helpers.typing import NoEventData as NoEventData
+from .util.event_type import EventType as EventType
 from .util.signal_type import SignalType as SignalType
 from _typeshed import Incomplete
 from enum import StrEnum
@@ -23,6 +26,7 @@ class Platform(StrEnum):
     CALENDAR: str
     CAMERA: str
     CLIMATE: str
+    CONVERSATION: str
     COVER: str
     DATE: str
     DATETIME: str
@@ -260,21 +264,22 @@ CONF_WHILE: Final[str]
 CONF_WHITELIST: Final[str]
 CONF_ALLOWLIST_EXTERNAL_DIRS: Final[str]
 LEGACY_CONF_WHITELIST_EXTERNAL_DIRS: Final[str]
+CONF_DEBUG: Final[str]
 CONF_XY: Final[str]
 CONF_ZONE: Final[str]
 EVENT_CALL_SERVICE: Final[str]
 EVENT_COMPONENT_LOADED: Final[str]
 EVENT_CORE_CONFIG_UPDATE: Final[str]
-EVENT_HOMEASSISTANT_CLOSE: Final[str]
-EVENT_HOMEASSISTANT_START: Final[str]
-EVENT_HOMEASSISTANT_STARTED: Final[str]
-EVENT_HOMEASSISTANT_STOP: Final[str]
-EVENT_HOMEASSISTANT_FINAL_WRITE: Final[str]
+EVENT_HOMEASSISTANT_CLOSE: EventType[NoEventData]
+EVENT_HOMEASSISTANT_START: EventType[NoEventData]
+EVENT_HOMEASSISTANT_STARTED: EventType[NoEventData]
+EVENT_HOMEASSISTANT_STOP: EventType[NoEventData]
+EVENT_HOMEASSISTANT_FINAL_WRITE: EventType[NoEventData]
 EVENT_LOGBOOK_ENTRY: Final[str]
 EVENT_LOGGING_CHANGED: Final[str]
 EVENT_SERVICE_REGISTERED: Final[str]
 EVENT_SERVICE_REMOVED: Final[str]
-EVENT_STATE_CHANGED: Final[str]
+EVENT_STATE_CHANGED: EventType[EventStateChangedData]
 EVENT_STATE_REPORTED: Final[str]
 EVENT_THEMES_UPDATED: Final[str]
 EVENT_PANELS_UPDATED: Final[str]

homeassistant-stubs/core.pyi

@@ -3,18 +3,19 @@ import datetime
 import enum
 import threading
 import voluptuous as vol
-from . import block_async_io as block_async_io, util as util
+from . import util as util
 from .auth import AuthManager as AuthManager
 from .components.http import ApiConfig as ApiConfig, HomeAssistantHTTP as HomeAssistantHTTP
 from .config_entries import ConfigEntries as ConfigEntries
 from .const import ATTR_DOMAIN as ATTR_DOMAIN, ATTR_FRIENDLY_NAME as ATTR_FRIENDLY_NAME, ATTR_SERVICE as ATTR_SERVICE, ATTR_SERVICE_DATA as ATTR_SERVICE_DATA, COMPRESSED_STATE_ATTRIBUTES as COMPRESSED_STATE_ATTRIBUTES, COMPRESSED_STATE_CONTEXT as COMPRESSED_STATE_CONTEXT, COMPRESSED_STATE_LAST_CHANGED as COMPRESSED_STATE_LAST_CHANGED, COMPRESSED_STATE_LAST_UPDATED as COMPRESSED_STATE_LAST_UPDATED, COMPRESSED_STATE_STATE as COMPRESSED_STATE_STATE, EVENT_CALL_SERVICE as EVENT_CALL_SERVICE, EVENT_CORE_CONFIG_UPDATE as EVENT_CORE_CONFIG_UPDATE, EVENT_HOMEASSISTANT_CLOSE as EVENT_HOMEASSISTANT_CLOSE, EVENT_HOMEASSISTANT_FINAL_WRITE as EVENT_HOMEASSISTANT_FINAL_WRITE, EVENT_HOMEASSISTANT_START as EVENT_HOMEASSISTANT_START, EVENT_HOMEASSISTANT_STARTED as EVENT_HOMEASSISTANT_STARTED, EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP, EVENT_LOGGING_CHANGED as EVENT_LOGGING_CHANGED, EVENT_SERVICE_REGISTERED as EVENT_SERVICE_REGISTERED, EVENT_SERVICE_REMOVED as EVENT_SERVICE_REMOVED, EVENT_STATE_CHANGED as EVENT_STATE_CHANGED, EVENT_STATE_REPORTED as EVENT_STATE_REPORTED, MATCH_ALL as MATCH_ALL, MAX_LENGTH_EVENT_EVENT_TYPE as MAX_LENGTH_EVENT_EVENT_TYPE, MAX_LENGTH_STATE_STATE as MAX_LENGTH_STATE_STATE, UnitOfLength as UnitOfLength, __version__ as __version__
-from .exceptions import HomeAssistantError as HomeAssistantError, InvalidEntityFormatError as InvalidEntityFormatError, InvalidStateError as InvalidStateError, MaxLengthExceeded as MaxLengthExceeded, ServiceNotFound as ServiceNotFound, Unauthorized as Unauthorized
+from .exceptions import HomeAssistantError as HomeAssistantError, InvalidEntityFormatError as InvalidEntityFormatError, InvalidStateError as InvalidStateError, MaxLengthExceeded as MaxLengthExceeded, ServiceNotFound as ServiceNotFound, ServiceValidationError as ServiceValidationError, Unauthorized as Unauthorized
 from .helpers.deprecation import DeprecatedConstantEnum as DeprecatedConstantEnum, all_with_deprecated_constants as all_with_deprecated_constants, check_if_deprecated_constant as check_if_deprecated_constant, dir_with_deprecated_constants as dir_with_deprecated_constants
 from .helpers.entity import StateInfo as StateInfo
 from .helpers.json import json_bytes as json_bytes, json_fragment as json_fragment
 from .helpers.storage import Store as Store
 from .util import location as location
 from .util.async_ import cancelling as cancelling, create_eager_task as create_eager_task, run_callback_threadsafe as run_callback_threadsafe, shutdown_run_callback_threadsafe as shutdown_run_callback_threadsafe
+from .util.event_type import EventType as EventType
 from .util.executor import InterruptibleThreadPoolExecutor as InterruptibleThreadPoolExecutor
 from .util.json import JsonObjectType as JsonObjectType
 from .util.read_only_dict import ReadOnlyDict as ReadOnlyDict
@@ -26,7 +27,7 @@ from collections import UserDict
 from collections.abc import Callable, Collection, Coroutine, Iterable, KeysView, Mapping, ValuesView
 from dataclasses import dataclass
 from functools import cached_property as cached_property
-from typing import Any, Generic, Literal, NotRequired, ParamSpec, Self, TypeVarTuple, TypedDict, overload
+from typing import Any, Generic, NotRequired, ParamSpec, Self, TypeVarTuple, TypedDict, overload
 from typing_extensions import TypeVar
 
 STOPPING_STAGE_SHUTDOWN_TIMEOUT: int
@@ -39,6 +40,7 @@ _R_co = TypeVar('_R_co', covariant=True)
 _P = ParamSpec('_P')
 _Ts = TypeVarTuple('_Ts')
 _UNDEF: dict[Any, Any]
+_SENTINEL: Incomplete
 _CallableT = TypeVar('_CallableT', bound=Callable[..., Any])
 _DataT = TypeVar('_DataT', bound=Mapping[str, Any], default=Mapping[str, Any])
 CALLBACK_TYPE = Callable[[], None]
@@ -56,6 +58,11 @@ class ConfigSource(enum.StrEnum):
     STORAGE: str
     YAML: str
 
+class EventStateChangedData(TypedDict):
+    entity_id: str
+    old_state: State | None
+    new_state: State | None
+
 _DEPRECATED_SOURCE_DISCOVERED: Incomplete
 _DEPRECATED_SOURCE_STORAGE: Incomplete
 _DEPRECATED_SOURCE_YAML: Incomplete
@@ -84,7 +91,14 @@ class _Hass(threading.local):
 _hass: Incomplete
 
 def async_get_hass() -> HomeAssistant: ...
-def get_release_channel() -> Literal['beta', 'dev', 'nightly', 'stable']: ...
+
+class ReleaseChannel(enum.StrEnum):
+    BETA: str
+    DEV: str
+    NIGHTLY: str
+    STABLE: str
+
+def get_release_channel() -> ReleaseChannel: ...
 
 class HassJobType(enum.Enum):
     Coroutinefunction: int
@@ -124,7 +138,7 @@ class HomeAssistant:
     auth: AuthManager
     http: HomeAssistantHTTP
     config_entries: ConfigEntries
-    def __new__(cls, config_dir: str) -> HomeAssistant: ...
+    def __new__(cls, config_dir: str) -> Self: ...
     def __repr__(self) -> str: ...
     data: Incomplete
     loop: Incomplete
@@ -144,6 +158,7 @@ class HomeAssistant:
     _shutdown_jobs: Incomplete
     import_executor: Incomplete
     def __init__(self, config_dir: str) -> None: ...
+    def verify_event_loop_thread(self, what: str) -> None: ...
     @property
     def _active_tasks(self) -> set[asyncio.Future[Any]]: ...
     @cached_property
@@ -165,9 +180,13 @@ class HomeAssistant:
     def async_add_hass_job(self, hassjob: HassJob[..., Coroutine[Any, Any, _R]], *args: Any, eager_start: bool = False, background: bool = False) -> asyncio.Future[_R] | None: ...
     @overload
     def async_add_hass_job(self, hassjob: HassJob[..., Coroutine[Any, Any, _R] | _R], *args: Any, eager_start: bool = False, background: bool = False) -> asyncio.Future[_R] | None: ...
+    @overload
+    def _async_add_hass_job(self, hassjob: HassJob[..., Coroutine[Any, Any, _R]], *args: Any, eager_start: bool = False, background: bool = False) -> asyncio.Future[_R] | None: ...
+    @overload
+    def _async_add_hass_job(self, hassjob: HassJob[..., Coroutine[Any, Any, _R] | _R], *args: Any, eager_start: bool = False, background: bool = False) -> asyncio.Future[_R] | None: ...
     def create_task(self, target: Coroutine[Any, Any, Any], name: str | None = None) -> None: ...
-    def async_create_task(self, target: Coroutine[Any, Any, _R], name: str | None = None, eager_start: bool = False) -> asyncio.Task[_R]: ...
-    def async_create_background_task(self, target: Coroutine[Any, Any, _R], name: str, eager_start: bool = False) -> asyncio.Task[_R]: ...
+    def async_create_task(self, target: Coroutine[Any, Any, _R], name: str | None = None, eager_start: bool = True) -> asyncio.Task[_R]: ...
+    def async_create_background_task(self, target: Coroutine[Any, Any, _R], name: str, eager_start: bool = True) -> asyncio.Task[_R]: ...
     def async_add_executor_job(self, target: Callable[[Unpack[_Ts]], _T], *args: Unpack[_Ts]) -> asyncio.Future[_T]: ...
     def async_add_import_executor_job(self, target: Callable[[Unpack[_Ts]], _T], *args: Unpack[_Ts]) -> asyncio.Future[_T]: ...
     @overload
@@ -198,7 +217,7 @@ class Context:
     parent_id: Incomplete
     origin_event: Incomplete
     def __init__(self, user_id: str | None = None, parent_id: str | None = None, id: str | None = None) -> None: ...
-    def __eq__(self, other: Any) -> bool: ...
+    def __eq__(self, other: object) -> bool: ...
     @cached_property
     def _as_dict(self) -> dict[str, str | None]: ...
     def as_dict(self) -> ReadOnlyDict[str, str | None]: ...
@@ -218,7 +237,7 @@ class Event(Generic[_DataT]):
     origin: Incomplete
     time_fired_timestamp: Incomplete
     context: Incomplete
-    def __init__(self, event_type: str, data: _DataT | None = None, origin: EventOrigin = ..., time_fired_timestamp: float | None = None, context: Context | None = None) -> None: ...
+    def __init__(self, event_type: EventType[_DataT] | str, data: _DataT | None = None, origin: EventOrigin = ..., time_fired_timestamp: float | None = None, context: Context | None = None) -> None: ...
     @cached_property
     def time_fired(self) -> datetime.datetime: ...
     @cached_property
@@ -230,21 +249,23 @@ class Event(Generic[_DataT]):
     def json_fragment(self) -> json_fragment: ...
     def __repr__(self) -> str: ...
 
-def _event_repr(event_type: str, origin: EventOrigin, data: Mapping[str, Any] | None) -> str: ...
+def _event_repr(event_type: EventType[_DataT] | str, origin: EventOrigin, data: _DataT | None) -> str: ...
 
 _FilterableJobType: Incomplete
 
 @dataclass(slots=True)
-class _OneTimeListener:
+class _OneTimeListener(Generic[_DataT]):
     hass: HomeAssistant
-    listener_job: HassJob[[Event], Coroutine[Any, Any, None] | None]
+    listener_job: HassJob[[Event[_DataT]], Coroutine[Any, Any, None] | None]
     remove: CALLBACK_TYPE | None = ...
-    def __call__(self, event: Event) -> None: ...
+    def __call__(self, event: Event[_DataT]) -> None: ...
     def __repr__(self) -> str: ...
     def __init__(self, hass, listener_job, remove) -> None: ...
 
 EMPTY_LIST: list[Any]
 
+def _verify_event_type_length_or_raise(event_type: EventType[_DataT] | str) -> None: ...
+
 class EventBus:
     __slots__: Incomplete
     _listeners: Incomplete
@@ -253,18 +274,18 @@ class EventBus:
     def __init__(self, hass: HomeAssistant) -> None: ...
     _debug: Incomplete
     def _async_logging_changed(self, event: Event | None = None) -> None: ...
-    def async_listeners(self) -> dict[str, int]: ...
+    def async_listeners(self) -> dict[EventType[Any] | str, int]: ...
     @property
-    def listeners(self) -> dict[str, int]: ...
-    def fire(self, event_type: str, event_data: Mapping[str, Any] | None = None, origin: EventOrigin = ..., context: Context | None = None) -> None: ...
-    def async_fire(self, event_type: str, event_data: Mapping[str, Any] | None = None, origin: EventOrigin = ..., context: Context | None = None, time_fired: float | None = None) -> None: ...
-    def _async_fire(self, event_type: str, event_data: Mapping[str, Any] | None = None, origin: EventOrigin = ..., context: Context | None = None, time_fired: float | None = None) -> None: ...
-    def listen(self, event_type: str, listener: Callable[[Event[Any]], Coroutine[Any, Any, None] | None]) -> CALLBACK_TYPE: ...
-    def async_listen(self, event_type: str, listener: Callable[[Event[_DataT]], Coroutine[Any, Any, None] | None], event_filter: Callable[[_DataT], bool] | None = None, run_immediately: bool = False) -> CALLBACK_TYPE: ...
-    def _async_listen_filterable_job(self, event_type: str, filterable_job: _FilterableJobType[Any]) -> CALLBACK_TYPE: ...
-    def listen_once(self, event_type: str, listener: Callable[[Event[Any]], Coroutine[Any, Any, None] | None]) -> CALLBACK_TYPE: ...
-    def async_listen_once(self, event_type: str, listener: Callable[[Event[Any]], Coroutine[Any, Any, None] | None], run_immediately: bool = False) -> CALLBACK_TYPE: ...
-    def _async_remove_listener(self, event_type: str, filterable_job: _FilterableJobType) -> None: ...
+    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: ...
+    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: ...
+    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: ...
+    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: ...
+    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: ...
+    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: ...
+    def _async_remove_listener(self, event_type: EventType[_DataT] | str, filterable_job: _FilterableJobType[_DataT]) -> None: ...
 
 class CompressedState(TypedDict):
     s: str
@@ -376,19 +397,29 @@ class ServiceRegistry:
     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: ...
     def async_register(self, domain: str, service: str, service_func: Callable[[ServiceCall], Coroutine[Any, Any, ServiceResponse | EntityServiceResponse] | ServiceResponse | EntityServiceResponse | None], schema: vol.Schema | None = None, supports_response: SupportsResponse = ..., job_type: HassJobType | None = None) -> None: ...
+    def _async_register(self, domain: str, service: str, service_func: Callable[[ServiceCall], Coroutine[Any, Any, ServiceResponse | EntityServiceResponse] | ServiceResponse | EntityServiceResponse | None], schema: vol.Schema | None = None, supports_response: SupportsResponse = ..., job_type: HassJobType | None = None) -> None: ...
     def remove(self, domain: str, service: str) -> None: ...
     def async_remove(self, domain: str, service: str) -> None: ...
+    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: ...
     async def _run_service_call_catch_exceptions(self, coro_or_task: Coroutine[Any, Any, Any] | asyncio.Task[Any], service_call: ServiceCall) -> None: ...
     async def _execute_service(self, handler: Service, service_call: ServiceCall) -> ServiceResponse: ...
 
+class _ComponentSet(set[str]):
+    _top_level_components: Incomplete
+    def __init__(self, top_level_components: set[str]) -> None: ...
+    def add(self, component: str) -> None: ...
+    def remove(self, component: str) -> None: ...
+    def discard(self, component: str) -> None: ...
+
 class Config:
     _store: Config._ConfigStore
     hass: Incomplete
     latitude: int
     longitude: int
     elevation: int
+    debug: bool
     location_name: str
     time_zone: str
     units: Incomplete
@@ -400,6 +431,7 @@ class Config:
     config_source: Incomplete
     skip_pip: bool
     skip_pip_packages: Incomplete
+    top_level_components: Incomplete
     components: Incomplete
     api: Incomplete
     config_dir: Incomplete

homeassistant-stubs/data_entry_flow.pyi

@@ -7,7 +7,7 @@ from .helpers.deprecation import DeprecatedConstantEnum as DeprecatedConstantEnu
 from .helpers.frame import report as report
 from .loader import async_suggest_report_issue as async_suggest_report_issue
 from _typeshed import Incomplete
-from collections.abc import Callable as Callable, Iterable, Mapping
+from collections.abc import Callable as Callable, Container, Iterable, Mapping
 from dataclasses import dataclass
 from enum import StrEnum
 from typing import Any, Generic, Required, TypedDict
@@ -66,7 +66,7 @@ class FlowResult(TypedDict, Generic[_HandlerT], total=False):
     flow_id: Required[str]
     handler: Required[_HandlerT]
     last_step: bool | None
-    menu_options: list[str] | dict[str, str]
+    menu_options: Container[str]
     options: Mapping[str, Any]
     preview: str | None
     progress_action: str
@@ -139,7 +139,7 @@ class FlowHandler(Generic[_FlowResultT, _HandlerT]):
     def async_external_step_done(self, *, next_step_id: str) -> _FlowResultT: ...
     def async_show_progress(self, *, step_id: str | None = None, progress_action: str, description_placeholders: Mapping[str, str] | None = None, progress_task: asyncio.Task[Any] | None = None) -> _FlowResultT: ...
     def async_show_progress_done(self, *, next_step_id: str) -> _FlowResultT: ...
-    def async_show_menu(self, *, step_id: str | None = None, menu_options: list[str] | dict[str, str], description_placeholders: Mapping[str, str] | None = None) -> _FlowResultT: ...
+    def async_show_menu(self, *, step_id: str | None = None, menu_options: Container[str], description_placeholders: Mapping[str, str] | None = None) -> _FlowResultT: ...
     def async_remove(self) -> None: ...
     @staticmethod
     async def async_setup_preview(hass: HomeAssistant) -> None: ...

homeassistant-stubs/exceptions.pyi

@@ -1,7 +1,9 @@
 from .core import Context as Context
+from .util.event_type import EventType as EventType
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable, Generator, Sequence
 from dataclasses import dataclass
+from typing import Any
 
 _function_cache: dict[str, Callable[[str, str, dict[str, str] | None], str]]
 
@@ -76,7 +78,7 @@ class Unauthorized(HomeAssistantError):
 
 class UnknownUser(Unauthorized): ...
 
-class ServiceNotFound(HomeAssistantError):
+class ServiceNotFound(ServiceValidationError):
     domain: Incomplete
     service: Incomplete
     generate_message: bool
@@ -87,7 +89,7 @@ class MaxLengthExceeded(HomeAssistantError):
     property_name: Incomplete
     max_length: Incomplete
     generate_message: bool
-    def __init__(self, value: str, property_name: str, max_length: int) -> None: ...
+    def __init__(self, value: EventType[Any] | str, property_name: str, max_length: int) -> None: ...
 
 class DependencyError(HomeAssistantError):
     failed_dependencies: Incomplete

homeassistant-stubs/helpers/aiohttp_client.pyi

@@ -1,4 +1,5 @@
 import aiohttp
+from .backports.aiohttp_resolver import AsyncResolver as AsyncResolver
 from .frame import warn_use as warn_use
 from .json import json_dumps as json_dumps
 from _typeshed import Incomplete