homeassistant-stubs 2024.10.4__py3-none-any.whl → 2024.11.0b0__py3-none-any.whl

homeassistant-stubs/core_config.pyi

@@ -0,0 +1,108 @@
+import enum
+from . import auth as auth
+from .components.http import ApiConfig as ApiConfig
+from .const import ATTR_ASSUMED_STATE as ATTR_ASSUMED_STATE, ATTR_FRIENDLY_NAME as ATTR_FRIENDLY_NAME, ATTR_HIDDEN as ATTR_HIDDEN, BASE_PLATFORMS as BASE_PLATFORMS, 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_RADIUS as CONF_RADIUS, 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, CONF_URL as CONF_URL, CONF_USERNAME as CONF_USERNAME, EVENT_CORE_CONFIG_UPDATE as EVENT_CORE_CONFIG_UPDATE, LEGACY_CONF_WHITELIST_EXTERNAL_DIRS as LEGACY_CONF_WHITELIST_EXTERNAL_DIRS, UnitOfLength as UnitOfLength, __version__ as __version__
+from .core import HomeAssistant as HomeAssistant
+from .generated.currencies import HISTORIC_CURRENCIES as HISTORIC_CURRENCIES
+from .helpers.entity_values import EntityValues as EntityValues
+from .helpers.frame import report as report
+from .helpers.storage import Store as Store
+from .helpers.typing import UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
+from .util import location as location
+from .util.hass_dict import HassKey as HassKey
+from .util.package import is_docker_env as is_docker_env
+from .util.unit_system import METRIC_SYSTEM as METRIC_SYSTEM, UnitSystem as UnitSystem, _CONF_UNIT_SYSTEM_IMPERIAL as _CONF_UNIT_SYSTEM_IMPERIAL, _CONF_UNIT_SYSTEM_US_CUSTOMARY as _CONF_UNIT_SYSTEM_US_CUSTOMARY, get_unit_system as get_unit_system, validate_unit_system as validate_unit_system
+from _typeshed import Incomplete
+from collections.abc import Sequence
+from typing import Any, Final
+
+_LOGGER: Incomplete
+DATA_CUSTOMIZE: HassKey[EntityValues]
+CONF_CREDENTIAL: Final[str]
+CONF_ICE_SERVERS: Final[str]
+CONF_WEBRTC: Final[str]
+CORE_STORAGE_KEY: str
+CORE_STORAGE_VERSION: int
+CORE_STORAGE_MINOR_VERSION: int
+
+class ConfigSource(enum.StrEnum):
+    DEFAULT = 'default'
+    DISCOVERED = 'discovered'
+    STORAGE = 'storage'
+    YAML = 'yaml'
+
+def _no_duplicate_auth_provider(configs: Sequence[dict[str, Any]]) -> Sequence[dict[str, Any]]: ...
+def _no_duplicate_auth_mfa_module(configs: Sequence[dict[str, Any]]) -> Sequence[dict[str, Any]]: ...
+def _filter_bad_internal_external_urls(conf: dict) -> dict: ...
+
+_PACKAGES_CONFIG_SCHEMA: Incomplete
+_PACKAGE_DEFINITION_SCHEMA: Incomplete
+_CUSTOMIZE_DICT_SCHEMA: Incomplete
+_CUSTOMIZE_CONFIG_SCHEMA: Incomplete
+
+def _raise_issue_if_historic_currency(hass: HomeAssistant, currency: str) -> None: ...
+def _raise_issue_if_no_country(hass: HomeAssistant, country: str | None) -> None: ...
+def _validate_currency(data: Any) -> Any: ...
+def _validate_stun_or_turn_url(value: Any) -> str: ...
+
+CORE_CONFIG_SCHEMA: Incomplete
+
+async def async_process_ha_core_config(hass: HomeAssistant, config: dict) -> None: ...
+
+class _ComponentSet(set[str]):
+    _top_level_components: Incomplete
+    _all_components: Incomplete
+    def __init__(self, top_level_components: set[str], all_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
+    radius: Incomplete
+    debug: bool
+    location_name: str
+    time_zone: str
+    units: Incomplete
+    internal_url: Incomplete
+    external_url: Incomplete
+    currency: str
+    country: Incomplete
+    language: str
+    config_source: Incomplete
+    skip_pip: bool
+    skip_pip_packages: Incomplete
+    top_level_components: Incomplete
+    all_components: Incomplete
+    components: Incomplete
+    api: Incomplete
+    config_dir: Incomplete
+    allowlist_external_dirs: Incomplete
+    allowlist_external_urls: Incomplete
+    media_dirs: Incomplete
+    recovery_mode: bool
+    legacy_templates: bool
+    safe_mode: bool
+    webrtc: Incomplete
+    def __init__(self, hass: HomeAssistant, config_dir: str) -> None: ...
+    def async_initialize(self) -> None: ...
+    def distance(self, lat: float, lon: float) -> float | None: ...
+    def path(self, *path: str) -> str: ...
+    def is_allowed_external_url(self, url: str) -> bool: ...
+    def is_allowed_path(self, path: str) -> bool: ...
+    def as_dict(self) -> dict[str, Any]: ...
+    async def async_set_time_zone(self, time_zone_str: str) -> None: ...
+    def set_time_zone(self, time_zone_str: str) -> None: ...
+    async def _async_update(self, *, country: str | UndefinedType | None = ..., currency: str | None = None, elevation: int | None = None, external_url: str | UndefinedType | None = ..., internal_url: str | UndefinedType | None = ..., language: str | None = None, latitude: float | None = None, location_name: str | None = None, longitude: float | None = None, radius: int | None = None, source: ConfigSource, time_zone: str | None = None, unit_system: str | None = None) -> None: ...
+    async def async_update(self, **kwargs: Any) -> None: ...
+    async def async_load(self) -> None: ...
+    async def _async_store(self) -> None: ...
+    class _ConfigStore(Store[dict[str, Any]]):
+        _original_unit_system: Incomplete
+        def __init__(self, hass: HomeAssistant) -> None: ...
+        async def _async_migrate_func(self, old_major_version: int, old_minor_version: int, old_data: dict[str, Any]) -> dict[str, Any]: ...
+        async def async_save(self, data: dict[str, Any]) -> None: ...

homeassistant-stubs/data_entry_flow.pyi

@@ -36,7 +36,8 @@ _DEPRECATED_RESULT_TYPE_MENU: Incomplete
 EVENT_DATA_ENTRY_FLOW_PROGRESSED: str
 FLOW_NOT_COMPLETE_STEPS: Incomplete
 STEP_ID_OPTIONAL_STEPS: Incomplete
-_FlowResultT = TypeVar('_FlowResultT', bound='FlowResult[Any]', default='FlowResult')
+_FlowContextT = TypeVar('_FlowContextT', bound='FlowContext', default='FlowContext')
+_FlowResultT = TypeVar('_FlowResultT', bound='FlowResult[Any, Any]', default='FlowResult')
 _HandlerT = TypeVar('_HandlerT', default=str)
 
 @dataclass(slots=True)
@@ -55,8 +56,12 @@ class AbortFlow(FlowError):
     description_placeholders: Incomplete
     def __init__(self, reason: str, description_placeholders: Mapping[str, str] | None = None) -> None: ...
 
-class FlowResult(TypedDict, Generic[_HandlerT], total=False):
-    context: dict[str, Any]
+class FlowContext(TypedDict, total=False):
+    show_advanced_options: bool
+    source: str
+
+class FlowResult(TypedDict, Generic[_FlowContextT, _HandlerT], total=False):
+    context: _FlowContextT
     data_schema: vol.Schema | None
     data: Mapping[str, Any]
     description_placeholders: Mapping[str, str | None] | None
@@ -81,7 +86,7 @@ class FlowResult(TypedDict, Generic[_HandlerT], total=False):
 
 def _map_error_to_schema_errors(schema_errors: dict[str, Any], error: vol.Invalid, data_schema: vol.Schema) -> None: ...
 
-class FlowManager(abc.ABC, Generic[_FlowResultT, _HandlerT], metaclass=abc.ABCMeta):
+class FlowManager(abc.ABC, Generic[_FlowContextT, _FlowResultT, _HandlerT], metaclass=abc.ABCMeta):
     _flow_result: type[_FlowResultT]
     hass: Incomplete
     _preview: Incomplete
@@ -90,35 +95,34 @@ class FlowManager(abc.ABC, Generic[_FlowResultT, _HandlerT], metaclass=abc.ABCMe
     _init_data_process_index: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
     @abc.abstractmethod
-    async def async_create_flow(self, handler_key: _HandlerT, *, context: dict[str, Any] | None = None, data: dict[str, Any] | None = None) -> FlowHandler[_FlowResultT, _HandlerT]: ...
+    async def async_create_flow(self, handler_key: _HandlerT, *, context: _FlowContextT | None = None, data: dict[str, Any] | None = None) -> FlowHandler[_FlowContextT, _FlowResultT, _HandlerT]: ...
     @abc.abstractmethod
-    async def async_finish_flow(self, flow: FlowHandler[_FlowResultT, _HandlerT], result: _FlowResultT) -> _FlowResultT: ...
-    async def async_post_init(self, flow: FlowHandler[_FlowResultT, _HandlerT], result: _FlowResultT) -> None: ...
-    def async_has_matching_flow(self, handler: _HandlerT, match_context: dict[str, Any], data: Any) -> bool: ...
+    async def async_finish_flow(self, flow: FlowHandler[_FlowContextT, _FlowResultT, _HandlerT], result: _FlowResultT) -> _FlowResultT: ...
+    async def async_post_init(self, flow: FlowHandler[_FlowContextT, _FlowResultT, _HandlerT], result: _FlowResultT) -> None: ...
     def async_get(self, flow_id: str) -> _FlowResultT: ...
     def async_progress(self, include_uninitialized: bool = False) -> list[_FlowResultT]: ...
     def async_progress_by_handler(self, handler: _HandlerT, include_uninitialized: bool = False, match_context: dict[str, Any] | None = None) -> list[_FlowResultT]: ...
     def async_progress_by_init_data_type(self, init_data_type: type, matcher: Callable[[Any], bool], include_uninitialized: bool = False) -> list[_FlowResultT]: ...
-    def _async_progress_by_handler(self, handler: _HandlerT, match_context: dict[str, Any] | None) -> list[FlowHandler[_FlowResultT, _HandlerT]]: ...
-    async def async_init(self, handler: _HandlerT, *, context: dict[str, Any] | None = None, data: Any = None) -> _FlowResultT: ...
+    def _async_progress_by_handler(self, handler: _HandlerT, match_context: dict[str, Any] | None) -> list[FlowHandler[_FlowContextT, _FlowResultT, _HandlerT]]: ...
+    async def async_init(self, handler: _HandlerT, *, context: _FlowContextT | None = None, data: Any = None) -> _FlowResultT: ...
     async def async_configure(self, flow_id: str, user_input: dict | None = None) -> _FlowResultT: ...
     async def _async_configure(self, flow_id: str, user_input: dict | None = None) -> _FlowResultT: ...
     def async_abort(self, flow_id: str) -> None: ...
-    def _async_add_flow_progress(self, flow: FlowHandler[_FlowResultT, _HandlerT]) -> None: ...
-    def _async_remove_flow_from_index(self, flow: FlowHandler[_FlowResultT, _HandlerT]) -> None: ...
+    def _async_add_flow_progress(self, flow: FlowHandler[_FlowContextT, _FlowResultT, _HandlerT]) -> None: ...
+    def _async_remove_flow_from_index(self, flow: FlowHandler[_FlowContextT, _FlowResultT, _HandlerT]) -> None: ...
     def _async_remove_flow_progress(self, flow_id: str) -> None: ...
-    async def _async_handle_step(self, flow: FlowHandler[_FlowResultT, _HandlerT], step_id: str, user_input: dict | BaseServiceInfo | None) -> _FlowResultT: ...
-    def _raise_if_step_does_not_exist(self, flow: FlowHandler[_FlowResultT, _HandlerT], step_id: str) -> None: ...
-    async def _async_setup_preview(self, flow: FlowHandler[_FlowResultT, _HandlerT]) -> None: ...
-    def _async_flow_handler_to_flow_result(self, flows: Iterable[FlowHandler[_FlowResultT, _HandlerT]], include_uninitialized: bool) -> list[_FlowResultT]: ...
+    async def _async_handle_step(self, flow: FlowHandler[_FlowContextT, _FlowResultT, _HandlerT], step_id: str, user_input: dict | BaseServiceInfo | None) -> _FlowResultT: ...
+    def _raise_if_step_does_not_exist(self, flow: FlowHandler[_FlowContextT, _FlowResultT, _HandlerT], step_id: str) -> None: ...
+    async def _async_setup_preview(self, flow: FlowHandler[_FlowContextT, _FlowResultT, _HandlerT]) -> None: ...
+    def _async_flow_handler_to_flow_result(self, flows: Iterable[FlowHandler[_FlowContextT, _FlowResultT, _HandlerT]], include_uninitialized: bool) -> list[_FlowResultT]: ...
 
-class FlowHandler(Generic[_FlowResultT, _HandlerT]):
+class FlowHandler(Generic[_FlowContextT, _FlowResultT, _HandlerT]):
     _flow_result: type[_FlowResultT]
     cur_step: _FlowResultT | None
     flow_id: str
     hass: HomeAssistant
     handler: _HandlerT
-    context: dict[str, Any]
+    context: _FlowContextT
     init_step: str
     init_data: Any
     VERSION: int

homeassistant-stubs/helpers/area_registry.pyi

@@ -1,15 +1,13 @@
-import dataclasses
 from .json import json_bytes as json_bytes, json_fragment as json_fragment
-from .normalized_name_base_registry import NormalizedNameBaseRegistryEntry as NormalizedNameBaseRegistryEntry, NormalizedNameBaseRegistryItems as NormalizedNameBaseRegistryItems, normalize_name as normalize_name
+from .normalized_name_base_registry import NormalizedNameBaseRegistryEntry as NormalizedNameBaseRegistryEntry, NormalizedNameBaseRegistryItems as NormalizedNameBaseRegistryItems
 from .registry import BaseRegistry as BaseRegistry, RegistryIndexType as RegistryIndexType
 from .singleton import singleton as singleton
 from .storage import Store as Store
 from .typing import UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
 from _typeshed import Incomplete
 from collections.abc import Iterable
-from functools import cached_property as cached_property
+from dataclasses import dataclass
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
-from homeassistant.util import slugify as slugify
 from homeassistant.util.dt import utc_from_timestamp as utc_from_timestamp, utcnow as utcnow
 from homeassistant.util.event_type import EventType as EventType
 from homeassistant.util.hass_dict import HassKey as HassKey
@@ -39,7 +37,7 @@ class EventAreaRegistryUpdatedData(TypedDict):
     action: Literal['create', 'remove', 'update']
     area_id: str
 
-@dataclasses.dataclass(frozen=True, kw_only=True)
+@dataclass(frozen=True, kw_only=True, slots=True)
 class AreaEntry(NormalizedNameBaseRegistryEntry):
     aliases: set[str]
     floor_id: str | None
@@ -47,9 +45,9 @@ class AreaEntry(NormalizedNameBaseRegistryEntry):
     id: str
     labels: set[str] = ...
     picture: str | None
-    @cached_property
+    _cache: dict[str, Any] = ...
     def json_fragment(self) -> json_fragment: ...
-    def __init__(self, *, name, normalized_name, created_at=..., modified_at=..., aliases, floor_id, icon, id, labels=..., picture) -> None: ...
+    def __init__(self, *, name, created_at=..., modified_at=..., aliases, floor_id, icon, id, labels=..., picture) -> None: ...
 
 class AreaRegistryStore(Store[AreasRegistryStoreData]):
     async def _async_migrate_func(self, old_major_version: int, old_minor_version: int, old_data: dict[str, list[dict[str, Any]]]) -> AreasRegistryStoreData: ...
@@ -73,13 +71,13 @@ class AreaRegistry(BaseRegistry[AreasRegistryStoreData]):
     def async_get_area_by_name(self, name: str) -> AreaEntry | None: ...
     def async_list_areas(self) -> Iterable[AreaEntry]: ...
     def async_get_or_create(self, name: str) -> AreaEntry: ...
+    def _generate_id(self, name: str) -> str: ...
     def async_create(self, name: str, *, aliases: set[str] | None = None, floor_id: str | None = None, icon: str | None = None, labels: set[str] | None = None, picture: str | None = None) -> AreaEntry: ...
     def async_delete(self, area_id: str) -> None: ...
     def async_update(self, area_id: str, *, aliases: set[str] | UndefinedType = ..., floor_id: str | None | UndefinedType = ..., icon: str | None | UndefinedType = ..., labels: set[str] | UndefinedType = ..., name: str | UndefinedType = ..., picture: str | None | UndefinedType = ...) -> AreaEntry: ...
     def _async_update(self, area_id: str, *, aliases: set[str] | UndefinedType = ..., floor_id: str | None | UndefinedType = ..., icon: str | None | UndefinedType = ..., labels: set[str] | UndefinedType = ..., name: str | UndefinedType = ..., picture: str | None | UndefinedType = ...) -> AreaEntry: ...
     async def async_load(self) -> None: ...
     def _data_to_save(self) -> AreasRegistryStoreData: ...
-    def _generate_area_id(self, name: str) -> str: ...
     def _async_setup_cleanup(self) -> None: ...
 
 def async_get(hass: HomeAssistant) -> AreaRegistry: ...

homeassistant-stubs/helpers/category_registry.pyi

@@ -33,6 +33,7 @@ class EventCategoryRegistryUpdatedData(TypedDict):
     action: Literal['create', 'remove', 'update']
     scope: str
     category_id: str
+type EventCategoryRegistryUpdated = Event[EventCategoryRegistryUpdatedData]
 
 @dataclass(slots=True, kw_only=True, frozen=True)
 class CategoryEntry:

homeassistant-stubs/helpers/check_config.pyi

@@ -2,8 +2,9 @@ from .typing import ConfigType as ConfigType
 from _typeshed import Incomplete
 from collections import OrderedDict
 from homeassistant import loader as loader
-from homeassistant.config import CONF_PACKAGES as CONF_PACKAGES, CORE_CONFIG_SCHEMA as CORE_CONFIG_SCHEMA, YAML_CONFIG_FILE as YAML_CONFIG_FILE, config_per_platform as config_per_platform, extract_domain_configs as extract_domain_configs, format_homeassistant_error as format_homeassistant_error, format_schema_error as format_schema_error, load_yaml_config_file as load_yaml_config_file, merge_packages_config as merge_packages_config
+from homeassistant.config import CONF_PACKAGES as CONF_PACKAGES, YAML_CONFIG_FILE as YAML_CONFIG_FILE, config_per_platform as config_per_platform, extract_domain_configs as extract_domain_configs, format_homeassistant_error as format_homeassistant_error, format_schema_error as format_schema_error, load_yaml_config_file as load_yaml_config_file, merge_packages_config as merge_packages_config
 from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.core_config import CORE_CONFIG_SCHEMA as CORE_CONFIG_SCHEMA
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.requirements import RequirementsNotFound as RequirementsNotFound, async_clear_install_history as async_clear_install_history, async_get_integration_with_requirements as async_get_integration_with_requirements
 from typing import NamedTuple, Self

homeassistant-stubs/helpers/collection.pyi

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

homeassistant-stubs/helpers/condition.pyi

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

homeassistant-stubs/helpers/config_entry_flow.pyi

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

homeassistant-stubs/helpers/config_validation.pyi

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

homeassistant-stubs/helpers/data_entry_flow.pyi

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

homeassistant-stubs/helpers/debounce.pyi

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

homeassistant-stubs/helpers/deprecation.pyi

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

homeassistant-stubs/helpers/device_registry.pyi

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

homeassistant-stubs/helpers/discovery_flow.pyi

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

homeassistant-stubs/helpers/dispatcher.pyi

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