homeassistant-stubs 2025.1.4__py3-none-any.whl → 2025.2.0b0__py3-none-any.whl

homeassistant-stubs/helpers/aiohttp_client.pyi

@@ -5,15 +5,17 @@ from .json import json_dumps as json_dumps
 from _typeshed import Incomplete
 from aiohttp import web
 from aiohttp.typedefs import JSONDecoder as JSONDecoder
+from aiohttp_asyncmdnsresolver.api import AsyncMDNSResolver
 from collections.abc import Awaitable, Callable as Callable
 from homeassistant import config_entries as config_entries
+from homeassistant.components import zeroconf as zeroconf
 from homeassistant.const import APPLICATION_NAME as APPLICATION_NAME, EVENT_HOMEASSISTANT_CLOSE as EVENT_HOMEASSISTANT_CLOSE, __version__ as __version__
 from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util import ssl as ssl_util
 from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.json import json_loads as json_loads
-from typing import Any
+from typing import Any, Self
 
 DATA_CONNECTOR: HassKey[dict[tuple[bool, int, str], aiohttp.BaseConnector]]
 DATA_CLIENTSESSION: HassKey[dict[tuple[bool, int, str], aiohttp.ClientSession]]
@@ -26,6 +28,13 @@ MAXIMUM_CONNECTIONS_PER_HOST: int
 class HassClientResponse(aiohttp.ClientResponse):
     async def json(self, *args: Any, loads: JSONDecoder = ..., **kwargs: Any) -> Any: ...
 
+class ChunkAsyncStreamIterator:
+    __slots__: Incomplete
+    _stream: Incomplete
+    def __init__(self, stream: aiohttp.StreamReader) -> None: ...
+    def __aiter__(self) -> Self: ...
+    async def __anext__(self) -> bytes: ...
+
 @callback
 @bind_hass
 def async_get_clientsession(hass: HomeAssistant, verify_ssl: bool = True, family: socket.AddressFamily = ..., ssl_cipher: ssl_util.SSLCipherList = ...) -> aiohttp.ClientSession: ...
@@ -50,3 +59,5 @@ class HomeAssistantTCPConnector(aiohttp.TCPConnector):
 
 @callback
 def _async_get_connector(hass: HomeAssistant, verify_ssl: bool = True, family: socket.AddressFamily = ..., ssl_cipher: ssl_util.SSLCipherList = ...) -> aiohttp.BaseConnector: ...
+@callback
+def _async_make_resolver(hass: HomeAssistant) -> AsyncMDNSResolver: ...

homeassistant-stubs/helpers/area_registry.pyi

@@ -7,11 +7,12 @@ from .typing import UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
 from _typeshed import Incomplete
 from collections.abc import Iterable
 from dataclasses import dataclass, field
+from homeassistant.const import ATTR_DEVICE_CLASS as ATTR_DEVICE_CLASS
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.util.dt import utc_from_timestamp as utc_from_timestamp, utcnow as utcnow
 from homeassistant.util.event_type import EventType as EventType
 from homeassistant.util.hass_dict import HassKey as HassKey
-from propcache import cached_property as under_cached_property
+from propcache.api import cached_property as under_cached_property
 from typing import Any, Literal, TypedDict
 
 DATA_REGISTRY: HassKey[AreaRegistry]
@@ -23,11 +24,13 @@ STORAGE_VERSION_MINOR: int
 class _AreaStoreData(TypedDict):
     aliases: list[str]
     floor_id: str | None
+    humidity_entity_id: str | None
     icon: str | None
     id: str
     labels: list[str]
     name: str
     picture: str | None
+    temperature_entity_id: str | None
     created_at: str
     modified_at: str
 
@@ -42,10 +45,12 @@ class EventAreaRegistryUpdatedData(TypedDict):
 class AreaEntry(NormalizedNameBaseRegistryEntry):
     aliases: set[str]
     floor_id: str | None
+    humidity_entity_id: str | None
     icon: str | None
     id: str
     labels: set[str] = field(default_factory=set)
     picture: str | None
+    temperature_entity_id: str | None
     _cache: dict[str, Any] = field(default_factory=dict, compare=False, init=False)
     @under_cached_property
     def json_fragment(self) -> json_fragment: ...
@@ -78,13 +83,13 @@ class AreaRegistry(BaseRegistry[AreasRegistryStoreData]):
     def async_get_or_create(self, name: str) -> AreaEntry: ...
     def _generate_id(self, name: str) -> str: ...
     @callback
-    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_create(self, name: str, *, aliases: set[str] | None = None, floor_id: str | None = None, humidity_entity_id: str | None = None, icon: str | None = None, labels: set[str] | None = None, picture: str | None = None, temperature_entity_id: str | None = None) -> AreaEntry: ...
     @callback
     def async_delete(self, area_id: str) -> None: ...
     @callback
-    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 = ..., humidity_entity_id: str | None | UndefinedType = ..., icon: str | None | UndefinedType = ..., labels: set[str] | UndefinedType = ..., name: str | UndefinedType = ..., picture: str | None | UndefinedType = ..., temperature_entity_id: str | None | UndefinedType = ...) -> AreaEntry: ...
     @callback
-    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 = ..., humidity_entity_id: str | None | UndefinedType = ..., icon: str | None | UndefinedType = ..., labels: set[str] | UndefinedType = ..., name: str | UndefinedType = ..., picture: str | None | UndefinedType = ..., temperature_entity_id: str | None | UndefinedType = ...) -> AreaEntry: ...
     async def async_load(self) -> None: ...
     @callback
     def _data_to_save(self) -> AreasRegistryStoreData: ...
@@ -98,3 +103,5 @@ async def async_load(hass: HomeAssistant) -> None: ...
 def async_entries_for_floor(registry: AreaRegistry, floor_id: str) -> list[AreaEntry]: ...
 @callback
 def async_entries_for_label(registry: AreaRegistry, label_id: str) -> list[AreaEntry]: ...
+def _validate_temperature_entity(hass: HomeAssistant, entity_id: str) -> None: ...
+def _validate_humidity_entity(hass: HomeAssistant, entity_id: str) -> None: ...

homeassistant-stubs/helpers/collection.pyi

@@ -7,7 +7,7 @@ from .json import json_bytes as json_bytes
 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 abc import abstractmethod
 from collections.abc import Awaitable, Callable, Iterable
 from dataclasses import dataclass
 from homeassistant.components import websocket_api as websocket_api
@@ -15,15 +15,13 @@ from homeassistant.const import CONF_ID as CONF_ID
 from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.util import slugify as slugify
-from typing import Any, Generic, TypedDict
-from typing_extensions import TypeVar
+from typing import Any, TypedDict
 
 STORAGE_VERSION: int
 SAVE_DELAY: int
 CHANGE_ADDED: str
 CHANGE_UPDATED: str
 CHANGE_REMOVED: str
-_EntityT = TypeVar('_EntityT', bound=Entity, default=Entity)
 
 @dataclass(slots=True)
 class CollectionChange:
@@ -57,7 +55,7 @@ class CollectionEntity(Entity, metaclass=abc.ABCMeta):
     @abstractmethod
     async def async_update_config(self, config: ConfigType) -> None: ...
 
-class ObservableCollection[_ItemT](ABC):
+class ObservableCollection[_ItemT]:
     id_manager: Incomplete
     data: dict[str, _ItemT]
     listeners: list[ChangeListener]
@@ -129,7 +127,7 @@ class IDLessCollection(YamlCollection):
 _GROUP_BY_KEY: Incomplete
 
 @dataclass(slots=True, frozen=True)
-class _CollectionLifeCycle(Generic[_EntityT]):
+class _CollectionLifeCycle[_EntityT: Entity = Entity]:
     domain: str
     platform: str
     entity_component: EntityComponent[_EntityT]
@@ -147,7 +145,7 @@ class _CollectionLifeCycle(Generic[_EntityT]):
     async def _collection_changed(self, change_set: Iterable[CollectionChange]) -> None: ...
 
 @callback
-def sync_entity_lifecycle(hass: HomeAssistant, domain: str, platform: str, entity_component: EntityComponent[_EntityT], collection: StorageCollection | YamlCollection, entity_class: type[CollectionEntity]) -> None: ...
+def sync_entity_lifecycle[_EntityT: Entity = Entity](hass: HomeAssistant, domain: str, platform: str, entity_component: EntityComponent[_EntityT], collection: StorageCollection | YamlCollection, entity_class: type[CollectionEntity]) -> None: ...
 
 class StorageCollectionWebsocket[_StorageCollectionT: StorageCollection]:
     storage_collection: Incomplete

homeassistant-stubs/helpers/config_entry_flow.pyi

@@ -1,13 +1,13 @@
+from .service_info.dhcp import DhcpServiceInfo as DhcpServiceInfo
 from .service_info.mqtt import MqttServiceInfo as MqttServiceInfo
+from .service_info.ssdp import SsdpServiceInfo as SsdpServiceInfo
+from .service_info.zeroconf import ZeroconfServiceInfo as ZeroconfServiceInfo
 from .typing import DiscoveryInfoType as DiscoveryInfoType
 from _typeshed import Incomplete
 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
-from homeassistant.components.dhcp import DhcpServiceInfo as DhcpServiceInfo
-from homeassistant.components.ssdp import SsdpServiceInfo as SsdpServiceInfo
-from homeassistant.components.zeroconf import ZeroconfServiceInfo as ZeroconfServiceInfo
 from homeassistant.core import HomeAssistant as HomeAssistant
 from typing import Any
 

homeassistant-stubs/helpers/data_entry_flow.pyi

@@ -3,8 +3,7 @@ from aiohttp import web as web
 from homeassistant import data_entry_flow as data_entry_flow
 from homeassistant.components.http import HomeAssistantView as HomeAssistantView
 from homeassistant.components.http.data_validator import RequestDataValidator as RequestDataValidator
-from typing import Any, Generic
-from typing_extensions import TypeVar
+from typing import Any, Generic, TypeVar
 
 _FlowManagerT = TypeVar('_FlowManagerT', bound=data_entry_flow.FlowManager[Any, Any], default=data_entry_flow.FlowManager)
 

homeassistant-stubs/helpers/deprecation.pyi

@@ -1,7 +1,7 @@
 import functools
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
-from enum import Enum, EnumType, _EnumDict
+from enum import EnumType, IntEnum, IntFlag, StrEnum, _EnumDict
 from typing import Any, NamedTuple
 
 def deprecated_substitute[_ObjectT: object](substitute_name: str) -> Callable[[Callable[[_ObjectT], Any]], Callable[[_ObjectT], Any]]: ...
@@ -18,7 +18,7 @@ class DeprecatedConstant(NamedTuple):
     breaks_in_ha_version: str | None
 
 class DeprecatedConstantEnum(NamedTuple):
-    enum: Enum
+    enum: StrEnum | IntEnum | IntFlag
     breaks_in_ha_version: str | None
 
 class DeprecatedAlias(NamedTuple):

homeassistant-stubs/helpers/device_registry.pyi

@@ -18,7 +18,7 @@ from homeassistant.util.dt import utc_from_timestamp as utc_from_timestamp, utcn
 from homeassistant.util.event_type import EventType as EventType
 from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.json import format_unserializable_data as format_unserializable_data
-from propcache import cached_property as under_cached_property
+from propcache.api import cached_property as under_cached_property
 from typing import Any, Literal, TypedDict
 from yarl import URL
 

homeassistant-stubs/helpers/entity.pyi

@@ -19,7 +19,7 @@ from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, I
 from homeassistant.loader import async_suggest_report_issue as async_suggest_report_issue, bind_hass as bind_hass
 from homeassistant.util import ensure_unique_string as ensure_unique_string, slugify as slugify
 from homeassistant.util.frozen_dataclass_compat import FrozenOrThawed as FrozenOrThawed
-from propcache import cached_property
+from propcache.api import cached_property
 from typing import Any, Final, Literal, NotRequired, TypedDict, final
 
 timer = time.time

homeassistant-stubs/helpers/entity_component.pyi

@@ -12,17 +12,15 @@ from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.loader import async_get_integration as async_get_integration, bind_hass as bind_hass
 from homeassistant.setup import async_prepare_setup_platform as async_prepare_setup_platform
 from types import ModuleType
-from typing import Any, Generic
-from typing_extensions import TypeVar
+from typing import Any
 
 DEFAULT_SCAN_INTERVAL: Incomplete
 DATA_INSTANCES: str
-_EntityT = TypeVar('_EntityT', bound=entity.Entity, default=entity.Entity)
 
 @bind_hass
 async def async_update_entity(hass: HomeAssistant, entity_id: str) -> None: ...
 
-class EntityComponent(Generic[_EntityT]):
+class EntityComponent[_EntityT: entity.Entity = entity.Entity]:
     logger: Incomplete
     hass: Incomplete
     domain: Incomplete

homeassistant-stubs/helpers/entity_registry.pyi

@@ -19,7 +19,7 @@ from homeassistant.util.event_type import EventType as EventType
 from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.json import format_unserializable_data as format_unserializable_data
 from homeassistant.util.read_only_dict import ReadOnlyDict as ReadOnlyDict
-from propcache import cached_property as under_cached_property
+from propcache.api import cached_property as under_cached_property
 from typing import Any, Literal, NotRequired, TypedDict
 
 DATA_REGISTRY: HassKey[EntityRegistry]
@@ -161,7 +161,7 @@ class EntityRegistryItems(BaseRegistryItems[RegistryEntry]):
     def get_entries_for_area_id(self, area_id: str) -> list[RegistryEntry]: ...
     def get_entries_for_label(self, label: str) -> list[RegistryEntry]: ...
 
-def _validate_item(hass: HomeAssistant, domain: str, platform: str, *, disabled_by: RegistryEntryDisabler | None | UndefinedType = None, entity_category: EntityCategory | None | UndefinedType = None, hidden_by: RegistryEntryHider | None | UndefinedType = None, report_non_string_unique_id: bool = True, unique_id: str | Hashable | UndefinedType | Any) -> None: ...
+def _validate_item(hass: HomeAssistant, domain: str, platform: str, *, config_entry_id: str | None | UndefinedType = None, device_id: str | None | UndefinedType = None, disabled_by: RegistryEntryDisabler | None | UndefinedType = None, entity_category: EntityCategory | None | UndefinedType = None, hidden_by: RegistryEntryHider | None | UndefinedType = None, report_non_string_unique_id: bool = True, unique_id: str | Hashable | UndefinedType | Any) -> None: ...
 
 class EntityRegistry(BaseRegistry):
     deleted_entities: dict[tuple[str, str, str], DeletedRegistryEntry]

homeassistant-stubs/helpers/frame.pyi

@@ -6,7 +6,7 @@ from dataclasses import dataclass
 from homeassistant.core import HomeAssistant as HomeAssistant, async_get_hass_or_none as async_get_hass_or_none
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.loader import Integration as Integration, async_get_issue_integration as async_get_issue_integration, async_suggest_report_issue as async_suggest_report_issue
-from propcache import cached_property
+from propcache.api import cached_property
 from types import FrameType
 
 _LOGGER: Incomplete

homeassistant-stubs/helpers/httpx_client.pyi

@@ -7,6 +7,7 @@ from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant, c
 from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.ssl import SSLCipherList as SSLCipherList, client_context as client_context, create_no_verify_ssl_context as create_no_verify_ssl_context
+from types import TracebackType
 from typing import Any, Self
 
 KEEP_ALIVE_TIMEOUT: int
@@ -23,7 +24,7 @@ def get_async_client(hass: HomeAssistant, verify_ssl: bool = True) -> httpx.Asyn
 
 class HassHttpXAsyncClient(httpx.AsyncClient):
     async def __aenter__(self) -> Self: ...
-    async def __aexit__(self, *args: object) -> None: ...
+    async def __aexit__(self, exc_type: type[BaseException] | None = None, exc_value: BaseException | None = None, traceback: TracebackType | None = None) -> None: ...
 
 @callback
 def create_async_httpx_client(hass: HomeAssistant, verify_ssl: bool = True, auto_cleanup: bool = True, ssl_cipher_list: SSLCipherList = ..., **kwargs: Any) -> httpx.AsyncClient: ...

homeassistant-stubs/helpers/intent.pyi

@@ -14,7 +14,7 @@ from homeassistant.core import Context as Context, HomeAssistant as HomeAssistan
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util.hass_dict import HassKey as HassKey
-from propcache import cached_property
+from propcache.api import cached_property
 from typing import Any
 
 _LOGGER: Incomplete
@@ -37,6 +37,7 @@ INTENT_TIMER_STATUS: str
 INTENT_GET_CURRENT_DATE: str
 INTENT_GET_CURRENT_TIME: str
 INTENT_RESPOND: str
+INTENT_BROADCAST: str
 SLOT_SCHEMA: Incomplete
 DATA_KEY: HassKey[dict[str, IntentHandler]]
 SPEECH_TYPE_PLAIN: str
@@ -75,6 +76,7 @@ class MatchFailedReason(Enum):
     INVALID_AREA = ...
     INVALID_FLOOR = ...
     DUPLICATE_NAME = ...
+    MULTIPLE_TARGETS = ...
     def is_no_entities_reason(self) -> bool: ...
 
 @dataclass
@@ -88,6 +90,7 @@ class MatchTargetsConstraints:
     states: Collection[str] | None = ...
     assistant: str | None = ...
     allow_duplicate_names: bool = ...
+    single_target: bool = ...
     @property
     def has_constraints(self) -> bool: ...
 
@@ -121,7 +124,6 @@ class MatchTargetsCandidate:
     is_exposed: bool
     entity: entity_registry.RegistryEntry | None = ...
     area: area_registry.AreaEntry | None = ...
-    floor: floor_registry.FloorEntry | None = ...
     device: device_registry.DeviceEntry | None = ...
     matched_name: str | None = ...
 

homeassistant-stubs/helpers/llm.pyi

@@ -6,8 +6,8 @@ from _typeshed import Incomplete
 from abc import ABC, abstractmethod
 from collections.abc import Callable as Callable
 from dataclasses import dataclass
+from homeassistant.components.calendar import SERVICE_GET_EVENTS as SERVICE_GET_EVENTS
 from homeassistant.components.climate import INTENT_GET_TEMPERATURE as INTENT_GET_TEMPERATURE
-from homeassistant.components.conversation import ConversationTraceEventType as ConversationTraceEventType, async_conversation_trace_append as async_conversation_trace_append
 from homeassistant.components.cover import INTENT_CLOSE_COVER as INTENT_CLOSE_COVER, INTENT_OPEN_COVER as INTENT_OPEN_COVER
 from homeassistant.components.homeassistant import async_should_expose as async_should_expose
 from homeassistant.components.intent import async_device_supports_timers as async_device_supports_timers
@@ -15,12 +15,11 @@ from homeassistant.components.weather import INTENT_GET_WEATHER as INTENT_GET_WE
 from homeassistant.const import ATTR_DOMAIN as ATTR_DOMAIN, ATTR_SERVICE as ATTR_SERVICE, EVENT_HOMEASSISTANT_CLOSE as EVENT_HOMEASSISTANT_CLOSE, EVENT_SERVICE_REMOVED as EVENT_SERVICE_REMOVED
 from homeassistant.core import Context as Context, Event as Event, HomeAssistant as HomeAssistant, callback as callback, split_entity_id as split_entity_id
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
-from homeassistant.util import yaml as yaml
 from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.json import JsonObjectType as JsonObjectType
 from typing import Any
 
-SCRIPT_PARAMETERS_CACHE: HassKey[dict[str, tuple[str | None, vol.Schema]]]
+ACTION_PARAMETERS_CACHE: HassKey[dict[str, dict[str, tuple[str | None, vol.Schema]]]]
 LLM_API_ASSIST: str
 BASE_PROMPT: str
 DEFAULT_INSTRUCTIONS_PROMPT: str
@@ -30,7 +29,7 @@ def async_render_no_api_prompt(hass: HomeAssistant) -> str: ...
 @callback
 def _async_get_apis(hass: HomeAssistant) -> dict[str, API]: ...
 @callback
-def async_register_api(hass: HomeAssistant, api: API) -> None: ...
+def async_register_api(hass: HomeAssistant, api: API) -> Callable[[], None]: ...
 async def async_get_api(hass: HomeAssistant, api_id: str, llm_context: LLMContext) -> APIInstance: ...
 @callback
 def async_get_apis(hass: HomeAssistant) -> list[API]: ...
@@ -94,10 +93,21 @@ class AssistAPI(API):
 
 def _get_exposed_entities(hass: HomeAssistant, assistant: str) -> dict[str, dict[str, Any]]: ...
 def _selector_serializer(schema: Any) -> Any: ...
-def _get_cached_script_parameters(hass: HomeAssistant, entity_id: str) -> tuple[str | None, vol.Schema]: ...
+def _get_cached_action_parameters(hass: HomeAssistant, domain: str, action: str) -> tuple[str | None, vol.Schema]: ...
 
-class ScriptTool(Tool):
-    _object_id: Incomplete
+class ActionTool(Tool):
+    _domain: Incomplete
+    _action: Incomplete
+    name: Incomplete
+    def __init__(self, hass: HomeAssistant, domain: str, action: str) -> None: ...
+    async def async_call(self, hass: HomeAssistant, tool_input: ToolInput, llm_context: LLMContext) -> JsonObjectType: ...
+
+class ScriptTool(ActionTool):
     name: Incomplete
     def __init__(self, hass: HomeAssistant, script_entity_id: str) -> None: ...
+
+class CalendarGetEventsTool(Tool):
+    name: str
+    description: str
+    parameters: Incomplete
     async def async_call(self, hass: HomeAssistant, tool_input: ToolInput, llm_context: LLMContext) -> JsonObjectType: ...

homeassistant-stubs/helpers/script.pyi

@@ -26,7 +26,7 @@ from homeassistant.util.async_ import create_eager_task as create_eager_task
 from homeassistant.util.dt import utcnow as utcnow
 from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.signal_type import SignalType as SignalType, SignalTypeFormat as SignalTypeFormat
-from propcache import cached_property
+from propcache.api import cached_property
 from types import MappingProxyType
 from typing import Any, Literal, TypedDict, overload
 

homeassistant-stubs/helpers/service_info/dhcp.pyi

@@ -0,0 +1,8 @@
+from dataclasses import dataclass
+from homeassistant.data_entry_flow import BaseServiceInfo as BaseServiceInfo
+
+@dataclass(slots=True)
+class DhcpServiceInfo(BaseServiceInfo):
+    ip: str
+    hostname: str
+    macaddress: str

homeassistant-stubs/helpers/service_info/ssdp.pyi

@@ -0,0 +1,34 @@
+from collections.abc import Mapping
+from dataclasses import dataclass, field
+from homeassistant.data_entry_flow import BaseServiceInfo as BaseServiceInfo
+from typing import Any, Final
+
+ATTR_ST: Final[str]
+ATTR_NT: Final[str]
+ATTR_UPNP_DEVICE_TYPE: Final[str]
+ATTR_UPNP_FRIENDLY_NAME: Final[str]
+ATTR_UPNP_MANUFACTURER: Final[str]
+ATTR_UPNP_MANUFACTURER_URL: Final[str]
+ATTR_UPNP_MODEL_DESCRIPTION: Final[str]
+ATTR_UPNP_MODEL_NAME: Final[str]
+ATTR_UPNP_MODEL_NUMBER: Final[str]
+ATTR_UPNP_MODEL_URL: Final[str]
+ATTR_UPNP_SERIAL: Final[str]
+ATTR_UPNP_SERVICE_LIST: Final[str]
+ATTR_UPNP_UDN: Final[str]
+ATTR_UPNP_UPC: Final[str]
+ATTR_UPNP_PRESENTATION_URL: Final[str]
+
+@dataclass(slots=True)
+class SsdpServiceInfo(BaseServiceInfo):
+    ssdp_usn: str
+    ssdp_st: str
+    upnp: Mapping[str, Any]
+    ssdp_location: str | None = ...
+    ssdp_nt: str | None = ...
+    ssdp_udn: str | None = ...
+    ssdp_ext: str | None = ...
+    ssdp_server: str | None = ...
+    ssdp_headers: Mapping[str, Any] = field(default_factory=dict)
+    ssdp_all_locations: set[str] = field(default_factory=set)
+    x_homeassistant_matching_domains: set[str] = field(default_factory=set)

homeassistant-stubs/helpers/service_info/usb.pyi

@@ -0,0 +1,11 @@
+from dataclasses import dataclass
+from homeassistant.data_entry_flow import BaseServiceInfo as BaseServiceInfo
+
+@dataclass(slots=True)
+class UsbServiceInfo(BaseServiceInfo):
+    device: str
+    vid: str
+    pid: str
+    serial_number: str | None
+    manufacturer: str | None
+    description: str | None

homeassistant-stubs/helpers/service_info/zeroconf.pyi

@@ -0,0 +1,20 @@
+from dataclasses import dataclass
+from homeassistant.data_entry_flow import BaseServiceInfo as BaseServiceInfo
+from ipaddress import IPv4Address, IPv6Address
+from typing import Any, Final
+
+ATTR_PROPERTIES_ID: Final[str]
+
+@dataclass(slots=True)
+class ZeroconfServiceInfo(BaseServiceInfo):
+    ip_address: IPv4Address | IPv6Address
+    ip_addresses: list[IPv4Address | IPv6Address]
+    port: int | None
+    hostname: str
+    type: str
+    name: str
+    properties: dict[str, Any]
+    @property
+    def host(self) -> str: ...
+    @property
+    def addresses(self) -> list[str]: ...

homeassistant-stubs/helpers/singleton.pyi

@@ -1,11 +1,15 @@
-from collections.abc import Callable
+from collections.abc import Callable, Coroutine
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util.hass_dict import HassKey as HassKey
-from typing import overload
+from typing import Any, Literal, overload
 
 type _FuncType[_T] = Callable[[HomeAssistant], _T]
+type _Coro[_T] = Coroutine[Any, Any, _T]
+@overload
+def singleton[_T](data_key: HassKey[_T], *, async_: Literal[True]) -> Callable[[_FuncType[_Coro[_T]]], _FuncType[_Coro[_T]]]: ...
 @overload
 def singleton[_T](data_key: HassKey[_T]) -> Callable[[_FuncType[_T]], _FuncType[_T]]: ...
 @overload
 def singleton[_T](data_key: str) -> Callable[[_FuncType[_T]], _FuncType[_T]]: ...
+async def _test_singleton_typing(hass: HomeAssistant) -> None: ...

homeassistant-stubs/helpers/storage.pyi

@@ -10,7 +10,7 @@ from homeassistant.util.file import WriteError as WriteError
 from homeassistant.util.hass_dict import HassKey as HassKey
 from json import JSONEncoder
 from pathlib import Path
-from propcache import cached_property
+from propcache.api import cached_property
 from typing import Any
 
 MAX_LOAD_CONCURRENTLY: int

homeassistant-stubs/helpers/template.pyi

@@ -25,7 +25,7 @@ from homeassistant.util.thread import ThreadWithException as ThreadWithException
 from jinja2 import pass_context
 from jinja2.sandbox import ImmutableSandboxedEnvironment
 from lru import LRU
-from propcache import under_cached_property
+from propcache.api import under_cached_property
 from types import CodeType, TracebackType
 from typing import Any, Literal, NoReturn, Self, overload
 
@@ -268,9 +268,9 @@ def _label_id_or_name(hass: HomeAssistant, label_id_or_name: str) -> str | None:
 def label_areas(hass: HomeAssistant, label_id_or_name: str) -> Iterable[str]: ...
 def label_devices(hass: HomeAssistant, label_id_or_name: str) -> Iterable[str]: ...
 def label_entities(hass: HomeAssistant, label_id_or_name: str) -> Iterable[str]: ...
-def closest(hass, *args): ...
-def closest_filter(hass, *args): ...
-def distance(hass, *args): ...
+def closest(hass: HomeAssistant, *args: Any) -> State | None: ...
+def closest_filter(hass: HomeAssistant, *args: Any) -> State | None: ...
+def distance(hass: HomeAssistant, *args: Any) -> float | None: ...
 def is_hidden_entity(hass: HomeAssistant, entity_id: str) -> bool: ...
 def is_state(hass: HomeAssistant, entity_id: str, state: str | list[str]) -> bool: ...
 def is_state_attr(hass: HomeAssistant, entity_id: str, name: str, value: Any) -> bool: ...

homeassistant-stubs/helpers/update_coordinator.pyi

@@ -14,14 +14,12 @@ from homeassistant.const import EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_
 from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Event as Event, HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed, ConfigEntryError as ConfigEntryError, ConfigEntryNotReady as ConfigEntryNotReady, HomeAssistantError as HomeAssistantError
 from homeassistant.util.dt import utcnow as utcnow
-from propcache import cached_property
-from typing import Any, Generic, Protocol
-from typing_extensions import TypeVar
+from propcache.api import cached_property
+from typing import Any, Generic, Protocol, TypeVar
 
 REQUEST_REFRESH_DEFAULT_COOLDOWN: int
 REQUEST_REFRESH_DEFAULT_IMMEDIATE: bool
 _DataT = TypeVar('_DataT', default=dict[str, Any])
-_DataUpdateCoordinatorT = TypeVar('_DataUpdateCoordinatorT', bound='DataUpdateCoordinator[Any]', default='DataUpdateCoordinator[dict[str, Any]]')
 
 class UpdateFailed(HomeAssistantError): ...
 
@@ -101,7 +99,7 @@ class BaseCoordinatorEntity[_BaseDataUpdateCoordinatorT: BaseDataUpdateCoordinat
     @abstractmethod
     async def async_update(self) -> None: ...
 
-class CoordinatorEntity(BaseCoordinatorEntity[_DataUpdateCoordinatorT]):
+class CoordinatorEntity[_DataUpdateCoordinatorT: DataUpdateCoordinator[Any] = DataUpdateCoordinator[dict[str, Any]]](BaseCoordinatorEntity[_DataUpdateCoordinatorT]):
     def __init__(self, coordinator: _DataUpdateCoordinatorT, context: Any = None) -> None: ...
     @property
     def available(self) -> bool: ...

homeassistant-stubs/loader.pyi

@@ -22,7 +22,7 @@ from _typeshed import Incomplete
 from awesomeversion import AwesomeVersion
 from collections.abc import Callable as Callable, Iterable
 from dataclasses import dataclass
-from propcache import cached_property
+from propcache.api import cached_property
 from types import ModuleType
 from typing import Any, Literal, Protocol, TypedDict
 

homeassistant-stubs/scripts/benchmark/__init__.pyi

@@ -11,18 +11,18 @@ def run(args) -> None: ...
 async def run_benchmark(bench) -> None: ...
 def benchmark[_CallableT: Callable](func: _CallableT) -> _CallableT: ...
 @benchmark
-async def fire_events(hass): ...
+async def fire_events(hass: core.HomeAssistant) -> float: ...
 @benchmark
-async def fire_events_with_filter(hass): ...
+async def fire_events_with_filter(hass: core.HomeAssistant) -> float: ...
 @benchmark
-async def state_changed_helper(hass): ...
+async def state_changed_helper(hass: core.HomeAssistant) -> float: ...
 @benchmark
-async def state_changed_event_helper(hass): ...
+async def state_changed_event_helper(hass: core.HomeAssistant) -> float: ...
 @benchmark
-async def state_changed_event_filter_helper(hass): ...
+async def state_changed_event_filter_helper(hass: core.HomeAssistant) -> float: ...
 @benchmark
-async def filtering_entity_id(hass): ...
+async def filtering_entity_id(hass: core.HomeAssistant) -> float: ...
 @benchmark
-async def valid_entity_id(hass): ...
+async def valid_entity_id(hass: core.HomeAssistant) -> float: ...
 @benchmark
-async def json_serialize_states(hass): ...
+async def json_serialize_states(hass: core.HomeAssistant) -> float: ...

homeassistant-stubs/util/event_type.pyi

@@ -1,6 +1,5 @@
 from collections.abc import Mapping
-from typing import Any, Generic
-from typing_extensions import TypeVar
+from typing import Any, Generic, TypeVar
 
 __all__ = ['EventType']
 

homeassistant-stubs/util/ulid.pyi

@@ -1,5 +1,5 @@
 from ulid_transform import bytes_to_ulid as bytes_to_ulid, bytes_to_ulid_or_none as bytes_to_ulid_or_none, ulid_at_time as ulid_at_time, ulid_hex as ulid_hex, ulid_now as ulid_now, ulid_to_bytes as ulid_to_bytes, ulid_to_bytes_or_none as ulid_to_bytes_or_none
 
-__all__ = ['ulid', 'ulid_hex', 'ulid_at_time', 'ulid_to_bytes', 'bytes_to_ulid', 'ulid_now', 'ulid_to_bytes_or_none', 'bytes_to_ulid_or_none']
+__all__ = ['bytes_to_ulid', 'bytes_to_ulid_or_none', 'ulid', 'ulid_at_time', 'ulid_hex', 'ulid_now', 'ulid_to_bytes', 'ulid_to_bytes_or_none']
 
 def ulid(timestamp: float | None = None) -> str: ...

homeassistant-stubs/util/yaml/__init__.pyi

@@ -4,4 +4,4 @@ from .input import UndefinedSubstitution as UndefinedSubstitution, extract_input
 from .loader import Secrets as Secrets, YamlTypeError as YamlTypeError, load_yaml as load_yaml, load_yaml_dict as load_yaml_dict, parse_yaml as parse_yaml, secret_yaml as secret_yaml
 from .objects import Input as Input
 
-__all__ = ['SECRET_YAML', 'Input', 'dump', 'save_yaml', 'Secrets', 'YamlTypeError', 'load_yaml', 'load_yaml_dict', 'secret_yaml', 'parse_yaml', 'UndefinedSubstitution', 'extract_inputs', 'substitute']
+__all__ = ['SECRET_YAML', 'Input', 'Secrets', 'UndefinedSubstitution', 'YamlTypeError', 'dump', 'extract_inputs', 'load_yaml', 'load_yaml_dict', 'parse_yaml', 'save_yaml', 'secret_yaml', 'substitute']

homeassistant-stubs/util/yaml/loader.pyi

@@ -7,7 +7,7 @@ from collections.abc import Callable as Callable, Iterator
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from io import StringIO
 from pathlib import Path
-from propcache import cached_property
+from propcache.api import cached_property
 from typing import Any, TextIO, overload
 from yaml import SafeLoader as FastestAvailableSafeLoader