homeassistant-stubs 2025.9.4__py3-none-any.whl → 2025.10.0b1__py3-none-any.whl

homeassistant-stubs/helpers/deprecation.pyi

@@ -8,6 +8,7 @@ def deprecated_substitute[_ObjectT: object](substitute_name: str) -> Callable[[C
 def get_deprecated(config: dict[str, Any], new_name: str, old_name: str, default: Any | None = None) -> Any | None: ...
 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 deprecated_hass_argument[**_P, _T](breaks_in_ha_version: str | None = None) -> Callable[[Callable[_P, _T]], Callable[_P, _T]]: ...
 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: ...

homeassistant-stubs/helpers/device_registry.pyi

@@ -133,7 +133,6 @@ class DeviceEntry:
     _suggested_area: str | None
     sw_version: str | None
     via_device_id: str | None
-    is_new: bool
     _cache: dict[str, Any]
     @property
     def disabled(self) -> bool: ...
@@ -145,7 +144,7 @@ class DeviceEntry:
     def as_storage_fragment(self) -> json_fragment: ...
     @property
     def suggested_area(self) -> str | None: ...
-    def __init__(self, area_id, config_entries, config_entries_subentries, 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 __init__(self, area_id, config_entries, config_entries_subentries, 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, cache) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...
@@ -212,7 +211,9 @@ class DeviceRegistry(BaseRegistry[dict[str, list[dict[str, Any]]]]):
     @callback
     def async_get_or_create(self, *, config_entry_id: str, config_subentry_id: str | None | UndefinedType = ..., 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: ...
     @callback
-    def async_update_device(self, device_id: str, *, add_config_entry_id: str | UndefinedType = ..., add_config_subentry_id: str | None | 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 = ..., remove_config_subentry_id: str | None | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., _suggested_area: 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 = ..., add_config_subentry_id: str | None | 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 = ..., is_new: bool = False, 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 = ..., remove_config_subentry_id: str | None | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., via_device_id: str | None | UndefinedType = ...) -> DeviceEntry | None: ...
+    @callback
+    def async_update_device(self, device_id: str, *, add_config_entry_id: str | UndefinedType = ..., add_config_subentry_id: str | None | UndefinedType = ..., 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 = ..., remove_config_subentry_id: str | None | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., via_device_id: str | None | UndefinedType = ...) -> DeviceEntry | None: ...
     @callback
     def _validate_connections(self, device_id: str, connections: set[tuple[str, str]], allow_collisions: bool) -> set[tuple[str, str]]: ...
     @callback

homeassistant-stubs/helpers/entity_component.pyi

@@ -7,7 +7,7 @@ from collections.abc import Callable as Callable, Iterable
 from datetime import timedelta
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import CONF_ENTITY_NAMESPACE as CONF_ENTITY_NAMESPACE, CONF_SCAN_INTERVAL as CONF_SCAN_INTERVAL, EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP
-from homeassistant.core import Event as Event, HassJob as HassJob, HassJobType as HassJobType, HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, ServiceResponse as ServiceResponse, SupportsResponse as SupportsResponse, callback as callback
+from homeassistant.core import Event as Event, HassJobType as HassJobType, HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, SupportsResponse as SupportsResponse, callback as callback
 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
@@ -45,8 +45,6 @@ class EntityComponent[_EntityT: entity.Entity = entity.Entity]:
     async def async_unload_entry(self, config_entry: ConfigEntry) -> bool: ...
     async def async_extract_from_service(self, service_call: ServiceCall, expand_group: bool = True) -> list[_EntityT]: ...
     @callback
-    def async_register_legacy_entity_service(self, name: str, schema: VolDictType | VolSchemaType, func: str | Callable[..., Any], required_features: list[int] | None = None, supports_response: SupportsResponse = ...) -> None: ...
-    @callback
     def async_register_entity_service(self, name: str, schema: VolDictType | VolSchemaType | None, func: str | Callable[..., Any], required_features: list[int] | None = None, supports_response: SupportsResponse = ...) -> None: ...
     async def async_setup_platform(self, platform_type: str, platform_config: ConfigType, discovery_info: DiscoveryInfoType | None = None) -> None: ...
     async def _async_reset(self) -> None: ...

homeassistant-stubs/helpers/event.pyi

@@ -5,7 +5,8 @@ from .device_registry import EVENT_DEVICE_REGISTRY_UPDATED as EVENT_DEVICE_REGIS
 from .entity_registry import EVENT_ENTITY_REGISTRY_UPDATED as EVENT_ENTITY_REGISTRY_UPDATED, EventEntityRegistryUpdatedData as EventEntityRegistryUpdatedData
 from .ratelimit import KeyedRateLimit as KeyedRateLimit
 from .sun import get_astral_event_next as get_astral_event_next
-from .template import RenderInfo as RenderInfo, Template as Template, result_as_boolean as result_as_boolean
+from .template import Template as Template, result_as_boolean as result_as_boolean
+from .template.render_info import RenderInfo as RenderInfo
 from .typing import TemplateVarsType as TemplateVarsType
 from _typeshed import Incomplete
 from collections import defaultdict

homeassistant-stubs/helpers/intent.pyi

@@ -2,6 +2,7 @@ import abc
 import asyncio
 import voluptuous as vol
 from . import area_registry as area_registry, device_registry as device_registry, entity_registry as entity_registry, floor_registry as floor_registry
+from .deprecation import EnumWithDeprecatedMembers as EnumWithDeprecatedMembers
 from .typing import VolSchemaType as VolSchemaType
 from _typeshed import Incomplete
 from abc import abstractmethod
@@ -53,7 +54,7 @@ def async_remove(hass: HomeAssistant, intent_type: str) -> None: ...
 @callback
 def async_get(hass: HomeAssistant) -> Iterable[IntentHandler]: ...
 @bind_hass
-async def async_handle(hass: HomeAssistant, platform: str, intent_type: str, slots: _SlotsType | None = None, text_input: str | None = None, context: Context | None = None, language: str | None = None, assistant: str | None = None, device_id: str | None = None, conversation_agent_id: str | None = None) -> IntentResponse: ...
+async def async_handle(hass: HomeAssistant, platform: str, intent_type: str, slots: _SlotsType | None = None, text_input: str | None = None, context: Context | None = None, language: str | None = None, assistant: str | None = None, device_id: str | None = None, satellite_id: str | None = None, conversation_agent_id: str | None = None) -> IntentResponse: ...
 
 class IntentError(HomeAssistantError): ...
 class UnknownIntent(IntentError): ...
@@ -197,10 +198,6 @@ class ServiceIntentHandler(DynamicServiceIntentHandler):
     def __init__(self, intent_type: str, domain: str, service: str, speech: str | None = None, required_slots: _IntentSlotsType | None = None, optional_slots: _IntentSlotsType | None = None, required_domains: set[str] | None = None, required_features: int | None = None, required_states: set[str] | None = None, description: str | None = None, platforms: set[str] | None = None, device_classes: set[type[StrEnum]] | None = None) -> None: ...
     def get_domain_and_service(self, intent_obj: Intent, state: State) -> tuple[str, str]: ...
 
-class IntentCategory(Enum):
-    ACTION = 'action'
-    QUERY = 'query'
-
 class Intent:
     __slots__: Incomplete
     hass: Incomplete
@@ -210,15 +207,15 @@ class Intent:
     text_input: Incomplete
     context: Incomplete
     language: Incomplete
-    category: Incomplete
     assistant: Incomplete
     device_id: Incomplete
+    satellite_id: Incomplete
     conversation_agent_id: Incomplete
-    def __init__(self, hass: HomeAssistant, platform: str, intent_type: str, slots: _SlotsType, text_input: str | None, context: Context, language: str, category: IntentCategory | None = None, assistant: str | None = None, device_id: str | None = None, conversation_agent_id: str | None = None) -> None: ...
+    def __init__(self, hass: HomeAssistant, platform: str, intent_type: str, slots: _SlotsType, text_input: str | None, context: Context, language: str, assistant: str | None = None, device_id: str | None = None, satellite_id: str | None = None, conversation_agent_id: str | None = None) -> None: ...
     @callback
     def create_response(self) -> IntentResponse: ...
 
-class IntentResponseType(Enum):
+class IntentResponseType(Enum, deprecated={'PARTIAL_ACTION_DONE': ('IntentResponseType.ACTION_DONE or IntentResponseType.ERROR', '2026.3.0')}, metaclass=EnumWithDeprecatedMembers):
     ACTION_DONE = 'action_done'
     PARTIAL_ACTION_DONE = 'partial_action_done'
     QUERY_ANSWER = 'query_answer'

homeassistant-stubs/helpers/schema_config_entry_flow.pyi

@@ -6,7 +6,7 @@ from _typeshed import Incomplete
 from abc import ABC, abstractmethod
 from collections.abc import Callable, Container, Coroutine, Mapping
 from dataclasses import dataclass
-from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, OptionsFlow as OptionsFlow
+from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, OptionsFlow as OptionsFlow, OptionsFlowWithReload as OptionsFlowWithReload
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback, split_entity_id as split_entity_id
 from homeassistant.data_entry_flow import UnknownHandler as UnknownHandler
 from typing import Any
@@ -27,6 +27,7 @@ class SchemaFlowFormStep(SchemaFlowStep):
 @dataclass(slots=True)
 class SchemaFlowMenuStep(SchemaFlowStep):
     options: Container[str] | Callable[[SchemaCommonFlowHandler], Coroutine[Any, Any, Container[str]]]
+    sort: bool = ...
 
 class SchemaCommonFlowHandler:
     _flow: Incomplete
@@ -52,6 +53,7 @@ class SchemaCommonFlowHandler:
 class SchemaConfigFlowHandler(ConfigFlow, ABC, metaclass=abc.ABCMeta):
     config_flow: Mapping[str, SchemaFlowStep]
     options_flow: Mapping[str, SchemaFlowStep] | None
+    options_flow_reloads: bool
     VERSION: int
     def __init_subclass__(cls, **kwargs: Any) -> None: ...
     _common_handler: Incomplete
@@ -86,6 +88,8 @@ class SchemaOptionsFlowHandler(OptionsFlow):
     @callback
     def async_create_entry(self, data: Mapping[str, Any], **kwargs: Any) -> ConfigFlowResult: ...
 
+class SchemaOptionsFlowHandlerWithReload(SchemaOptionsFlowHandler, OptionsFlowWithReload): ...
+
 @callback
 def wrapped_entity_config_entry_title(hass: HomeAssistant, entity_id_or_uuid: str) -> str: ...
 @callback

homeassistant-stubs/helpers/selector.pyi

@@ -1,3 +1,4 @@
+import voluptuous as vol
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable, Mapping, Sequence
 from enum import StrEnum
@@ -11,7 +12,7 @@ from typing import Any, Literal, Required, TypedDict
 
 SELECTORS: decorator.Registry[str, type[Selector]]
 
-def _get_selector_class(config: Any) -> type[Selector]: ...
+def _get_selector_type_and_class(config: Any) -> tuple[str, type[Selector]]: ...
 def selector(config: Any) -> Selector: ...
 def validate_selector(config: Any) -> dict: ...
 
@@ -27,14 +28,13 @@ class Selector[_T: Mapping[str, Any]]:
 def _entity_feature_flag(domain: str, enum_name: str, feature_name: str) -> int: ...
 def _validate_supported_feature(supported_feature: str) -> int: ...
 def _validate_supported_features(supported_features: list[str]) -> int: ...
-
-BASE_SELECTOR_CONFIG_SCHEMA: Incomplete
+def make_selector_config_schema(schema_dict: dict | None = None) -> vol.Schema: ...
 
 class BaseSelectorConfig(TypedDict, total=False):
     read_only: bool
 
 ENTITY_FILTER_SELECTOR_CONFIG_SCHEMA: Incomplete
-LEGACY_ENTITY_SELECTOR_CONFIG_SCHEMA: Incomplete
+_LEGACY_ENTITY_SELECTOR_CONFIG_SCHEMA_DICT: Incomplete
 
 class EntityFilterSelectorConfig(TypedDict, total=False):
     integration: str
@@ -43,7 +43,7 @@ class EntityFilterSelectorConfig(TypedDict, total=False):
     supported_features: list[str]
 
 DEVICE_FILTER_SELECTOR_CONFIG_SCHEMA: Incomplete
-LEGACY_DEVICE_SELECTOR_CONFIG_SCHEMA: Incomplete
+_LEGACY_DEVICE_SELECTOR_CONFIG_SCHEMA_DICT: Incomplete
 
 class DeviceFilterSelectorConfig(TypedDict, total=False):
     integration: str
@@ -55,7 +55,7 @@ class ActionSelectorConfig(BaseSelectorConfig): ...
 
 class ActionSelector(Selector[ActionSelectorConfig]):
     selector_type: str
-    CONFIG_SCHEMA = BASE_SELECTOR_CONFIG_SCHEMA
+    CONFIG_SCHEMA: Incomplete
     def __init__(self, config: ActionSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> Any: ...
 
@@ -84,7 +84,7 @@ class AssistPipelineSelectorConfig(BaseSelectorConfig, total=False): ...
 
 class AssistPipelineSelector(Selector[AssistPipelineSelectorConfig]):
     selector_type: str
-    CONFIG_SCHEMA = BASE_SELECTOR_CONFIG_SCHEMA
+    CONFIG_SCHEMA: Incomplete
     def __init__(self, config: AssistPipelineSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str: ...
 
@@ -102,7 +102,7 @@ class BackupLocationSelectorConfig(BaseSelectorConfig, total=False): ...
 
 class BackupLocationSelector(Selector[BackupLocationSelectorConfig]):
     selector_type: str
-    CONFIG_SCHEMA = BASE_SELECTOR_CONFIG_SCHEMA
+    CONFIG_SCHEMA: Incomplete
     def __init__(self, config: BackupLocationSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str: ...
 
@@ -110,7 +110,7 @@ class BooleanSelectorConfig(BaseSelectorConfig): ...
 
 class BooleanSelector(Selector[BooleanSelectorConfig]):
     selector_type: str
-    CONFIG_SCHEMA = BASE_SELECTOR_CONFIG_SCHEMA
+    CONFIG_SCHEMA: Incomplete
     def __init__(self, config: BooleanSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> bool: ...
 
@@ -118,7 +118,7 @@ class ColorRGBSelectorConfig(BaseSelectorConfig): ...
 
 class ColorRGBSelector(Selector[ColorRGBSelectorConfig]):
     selector_type: str
-    CONFIG_SCHEMA = BASE_SELECTOR_CONFIG_SCHEMA
+    CONFIG_SCHEMA: Incomplete
     def __init__(self, config: ColorRGBSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> list[int]: ...
 
@@ -143,7 +143,7 @@ class ConditionSelectorConfig(BaseSelectorConfig): ...
 
 class ConditionSelector(Selector[ConditionSelectorConfig]):
     selector_type: str
-    CONFIG_SCHEMA = BASE_SELECTOR_CONFIG_SCHEMA
+    CONFIG_SCHEMA: Incomplete
     def __init__(self, config: ConditionSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> Any: ...
 
@@ -190,7 +190,7 @@ class DateSelectorConfig(BaseSelectorConfig): ...
 
 class DateSelector(Selector[DateSelectorConfig]):
     selector_type: str
-    CONFIG_SCHEMA = BASE_SELECTOR_CONFIG_SCHEMA
+    CONFIG_SCHEMA: Incomplete
     def __init__(self, config: DateSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> Any: ...
 
@@ -198,7 +198,7 @@ class DateTimeSelectorConfig(BaseSelectorConfig): ...
 
 class DateTimeSelector(Selector[DateTimeSelectorConfig]):
     selector_type: str
-    CONFIG_SCHEMA = BASE_SELECTOR_CONFIG_SCHEMA
+    CONFIG_SCHEMA: Incomplete
     def __init__(self, config: DateTimeSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> Any: ...
 
@@ -421,7 +421,7 @@ class TemplateSelectorConfig(BaseSelectorConfig): ...
 
 class TemplateSelector(Selector[TemplateSelectorConfig]):
     selector_type: str
-    CONFIG_SCHEMA = BASE_SELECTOR_CONFIG_SCHEMA
+    CONFIG_SCHEMA: Incomplete
     def __init__(self, config: TemplateSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str: ...
 
@@ -466,7 +466,7 @@ class TimeSelectorConfig(BaseSelectorConfig): ...
 
 class TimeSelector(Selector[TimeSelectorConfig]):
     selector_type: str
-    CONFIG_SCHEMA = BASE_SELECTOR_CONFIG_SCHEMA
+    CONFIG_SCHEMA: Incomplete
     def __init__(self, config: TimeSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str: ...
 
@@ -474,6 +474,6 @@ class TriggerSelectorConfig(BaseSelectorConfig): ...
 
 class TriggerSelector(Selector[TriggerSelectorConfig]):
     selector_type: str
-    CONFIG_SCHEMA = BASE_SELECTOR_CONFIG_SCHEMA
+    CONFIG_SCHEMA: Incomplete
     def __init__(self, config: TriggerSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> Any: ...

homeassistant-stubs/helpers/service.pyi

@@ -1,6 +1,6 @@
 import logging
 from . import device_registry as device_registry, entity_registry as entity_registry, selector as selector, target as target_helpers, template as template, translation as translation
-from .deprecation import deprecated_class as deprecated_class, deprecated_function as deprecated_function
+from .deprecation import deprecated_class as deprecated_class, deprecated_function as deprecated_function, deprecated_hass_argument as deprecated_hass_argument
 from .entity import Entity as Entity
 from .selector import TargetSelector as TargetSelector
 from .typing import ConfigType as ConfigType, TemplateVarsType as TemplateVarsType, VolDictType as VolDictType, VolSchemaType as VolSchemaType
@@ -58,18 +58,14 @@ async def async_call_from_config(hass: HomeAssistant, config: ConfigType, blocki
 @callback
 @bind_hass
 def async_prepare_call_from_config(hass: HomeAssistant, config: ConfigType, variables: TemplateVarsType = None, validate_config: bool = False) -> ServiceParams: ...
-@bind_hass
-def extract_entity_ids(hass: HomeAssistant, service_call: ServiceCall, expand_group: bool = True) -> set[str]: ...
-@bind_hass
-async def async_extract_entities[_EntityT: Entity](hass: HomeAssistant, entities: Iterable[_EntityT], service_call: ServiceCall, expand_group: bool = True) -> list[_EntityT]: ...
-@bind_hass
-async def async_extract_entity_ids(hass: HomeAssistant, service_call: ServiceCall, expand_group: bool = True) -> set[str]: ...
+def extract_entity_ids(service_call: ServiceCall, expand_group: bool = True) -> set[str]: ...
+async def async_extract_entities[_EntityT: Entity](entities: Iterable[_EntityT], service_call: ServiceCall, expand_group: bool = True) -> list[_EntityT]: ...
+async def async_extract_entity_ids(service_call: ServiceCall, expand_group: bool = True) -> set[str]: ...
 @bind_hass
 def async_extract_referenced_entity_ids(hass: HomeAssistant, service_call: ServiceCall, expand_group: bool = True) -> SelectedEntities: ...
-@bind_hass
-async def async_extract_config_entry_ids(hass: HomeAssistant, service_call: ServiceCall, expand_group: bool = True) -> set[str]: ...
-def _load_services_file(hass: HomeAssistant, integration: Integration) -> JSON_TYPE: ...
-def _load_services_files(hass: HomeAssistant, integrations: Iterable[Integration]) -> dict[str, JSON_TYPE]: ...
+async def async_extract_config_entry_ids(service_call: ServiceCall, expand_group: bool = True) -> set[str]: ...
+def _load_services_file(integration: Integration) -> JSON_TYPE: ...
+def _load_services_files(integrations: Iterable[Integration]) -> dict[str, JSON_TYPE]: ...
 @callback
 def async_get_cached_service_description(hass: HomeAssistant, domain: str, service: str) -> dict[str, Any] | None: ...
 @bind_hass
@@ -81,15 +77,14 @@ def remove_entity_service_fields(call: ServiceCall) -> dict[Any, Any]: ...
 def async_set_service_schema(hass: HomeAssistant, domain: str, service: str, schema: dict[str, Any]) -> None: ...
 def _get_permissible_entity_candidates(call: ServiceCall, entities: dict[str, Entity], entity_perms: Callable[[str, str], bool] | None, target_all_entities: bool, all_referenced: set[str] | None) -> list[Entity]: ...
 @bind_hass
-async def entity_service_call(hass: HomeAssistant, registered_entities: dict[str, Entity], func: str | HassJob, call: ServiceCall, required_features: Iterable[int] | None = None) -> EntityServiceResponse | None: ...
+async def entity_service_call(hass: HomeAssistant, registered_entities: dict[str, Entity] | Callable[[], dict[str, Entity]], func: str | HassJob, call: ServiceCall, required_features: Iterable[int] | None = None) -> EntityServiceResponse | None: ...
 async def _handle_entity_call(hass: HomeAssistant, entity: Entity, func: str | HassJob, data: dict | ServiceCall, context: Context) -> ServiceResponse: ...
 async def _async_admin_handler(hass: HomeAssistant, service_job: HassJob[[ServiceCall], Coroutine[Any, Any, ServiceResponse | EntityServiceResponse] | ServiceResponse | EntityServiceResponse | None], call: ServiceCall) -> ServiceResponse | EntityServiceResponse | None: ...
 @bind_hass
 @callback
 def async_register_admin_service(hass: HomeAssistant, domain: str, service: str, service_func: Callable[[ServiceCall], Coroutine[Any, Any, ServiceResponse | EntityServiceResponse] | ServiceResponse | EntityServiceResponse | None], schema: VolSchemaType = ..., supports_response: SupportsResponse = ...) -> None: ...
-@bind_hass
 @callback
-def verify_domain_control(hass: HomeAssistant, domain: str) -> Callable[[Callable[[ServiceCall], Any]], Callable[[ServiceCall], Any]]: ...
+def verify_domain_control(domain: str) -> Callable[[Callable[[ServiceCall], Any]], Callable[[ServiceCall], Any]]: ...
 
 class ReloadServiceHelper[_T]:
     _service_func: Incomplete
@@ -100,5 +95,8 @@ class ReloadServiceHelper[_T]:
     def __init__(self, service_func: Callable[[ServiceCall], Coroutine[Any, Any, Any]], reload_targets_func: Callable[[ServiceCall], set[_T]]) -> None: ...
     async def execute_service(self, service_call: ServiceCall) -> None: ...
 
+def _validate_entity_service_schema(schema: VolDictType | VolSchemaType | None, service: str) -> VolSchemaType: ...
 @callback
 def async_register_entity_service(hass: HomeAssistant, domain: str, name: str, *, entities: dict[str, Entity], func: str | Callable[..., Any], job_type: HassJobType | None, required_features: Iterable[int] | None = None, schema: VolDictType | VolSchemaType | None, supports_response: SupportsResponse = ...) -> None: ...
+@callback
+def async_register_platform_entity_service(hass: HomeAssistant, service_domain: str, service_name: str, *, entity_domain: str, func: str | Callable[..., Any], required_features: Iterable[int] | None = None, schema: VolDictType | VolSchemaType | None, supports_response: SupportsResponse = ...) -> None: ...

homeassistant-stubs/helpers/service_info/esphome.pyi

@@ -0,0 +1,12 @@
+from dataclasses import dataclass
+from homeassistant.data_entry_flow import BaseServiceInfo as BaseServiceInfo
+
+@dataclass(slots=True)
+class ESPHomeServiceInfo(BaseServiceInfo):
+    name: str
+    zwave_home_id: int | None
+    ip_address: str
+    port: int
+    noise_psk: str | None = ...
+    @property
+    def socket_path(self) -> str: ...

homeassistant-stubs/helpers/{template.pyi → template/__init__.pyi}

@@ -1,20 +1,20 @@
-import collections.abc
 import jinja2
 import weakref
-from . import area_registry as area_registry, device_registry as device_registry, entity_registry as entity_registry, issue_registry as issue_registry, label_registry as label_registry
-from .deprecation import deprecated_function as deprecated_function
-from .singleton import singleton as singleton
-from .translation import async_translate_state as async_translate_state
-from .typing import TemplateVarsType as TemplateVarsType
+from .context import render_with_context as render_with_context, template_context_manager as template_context_manager, template_cv as template_cv
+from .helpers import raise_no_default as raise_no_default
+from .render_info import RenderInfo as RenderInfo, render_info_cv as render_info_cv
 from _typeshed import Incomplete, OptExcInfo as OptExcInfo
-from collections.abc import Callable as Callable, Generator, Iterable, MutableSequence
-from contextlib import AbstractContextManager
-from contextvars import ContextVar
+from collections.abc import Callable as Callable, Generator, Iterable
 from datetime import datetime, timedelta
 from functools import cache
 from homeassistant.const import ATTR_ENTITY_ID as ATTR_ENTITY_ID, ATTR_LATITUDE as ATTR_LATITUDE, ATTR_LONGITUDE as ATTR_LONGITUDE, ATTR_PERSONS as ATTR_PERSONS, ATTR_UNIT_OF_MEASUREMENT as ATTR_UNIT_OF_MEASUREMENT, EVENT_HOMEASSISTANT_START as EVENT_HOMEASSISTANT_START, EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN, UnitOfLength as UnitOfLength
-from homeassistant.core import Context as Context, HomeAssistant as HomeAssistant, ServiceResponse as ServiceResponse, State as State, callback as callback, split_entity_id as split_entity_id, valid_domain as valid_domain, valid_entity_id as valid_entity_id
+from homeassistant.core import Context as Context, HomeAssistant as HomeAssistant, ServiceResponse as ServiceResponse, State as State, callback as callback, valid_domain as valid_domain, valid_entity_id as valid_entity_id
 from homeassistant.exceptions import TemplateError as TemplateError
+from homeassistant.helpers import area_registry as ar
+from homeassistant.helpers.deprecation import deprecated_function as deprecated_function
+from homeassistant.helpers.singleton import singleton as singleton
+from homeassistant.helpers.translation import async_translate_state as async_translate_state
+from homeassistant.helpers.typing import TemplateVarsType as TemplateVarsType
 from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util import convert as convert
 from homeassistant.util.async_ import run_callback_threadsafe as run_callback_threadsafe
@@ -26,8 +26,8 @@ from jinja2 import pass_context
 from jinja2.sandbox import ImmutableSandboxedEnvironment
 from lru import LRU
 from propcache.api import under_cached_property
-from types import CodeType, TracebackType
-from typing import Any, Literal, NoReturn, Self, overload
+from types import CodeType
+from typing import Any, Literal, Self, overload
 
 _LOGGER: Incomplete
 _SENTINEL: Incomplete
@@ -39,10 +39,6 @@ _HASS_LOADER: str
 _IS_NUMERIC: Incomplete
 _RESERVED_NAMES: Incomplete
 _COLLECTABLE_STATE_ATTRIBUTES: Incomplete
-ALL_STATES_RATE_LIMIT: int
-DOMAIN_STATES_RATE_LIMIT: int
-_render_info: ContextVar[RenderInfo | None]
-template_cv: ContextVar[tuple[str, str] | None]
 CACHED_TEMPLATE_STATES: int
 EVAL_CACHE_SIZE: int
 MAX_CUSTOM_TEMPLATE_SIZE: Incomplete
@@ -77,35 +73,8 @@ class TupleWrapper(tuple, ResultWrapper):
 _types: tuple[type[dict | list | set], ...]
 RESULT_WRAPPERS: dict[type, type]
 
-def _true(arg: str) -> bool: ...
-def _false(arg: str) -> bool: ...
 def _cached_parse_result(render_result: str) -> Any: ...
 
-class RenderInfo:
-    __slots__: Incomplete
-    template: Incomplete
-    filter_lifecycle: Callable[[str], bool]
-    filter: Callable[[str], bool]
-    _result: str | None
-    is_static: bool
-    exception: TemplateError | None
-    all_states: bool
-    all_states_lifecycle: bool
-    domains: collections.abc.Set[str]
-    domains_lifecycle: collections.abc.Set[str]
-    entities: collections.abc.Set[str]
-    rate_limit: float | None
-    has_time: bool
-    def __init__(self, template: Template) -> None: ...
-    def __repr__(self) -> str: ...
-    def _filter_domains_and_entities(self, entity_id: str) -> bool: ...
-    def _filter_entities(self, entity_id: str) -> bool: ...
-    def _filter_lifecycle_domains(self, entity_id: str) -> bool: ...
-    def result(self) -> str: ...
-    def _freeze_static(self) -> None: ...
-    def _freeze_sets(self) -> None: ...
-    def _freeze(self) -> None: ...
-
 class Template:
     __slots__: Incomplete
     template: str
@@ -259,7 +228,7 @@ def floor_areas(hass: HomeAssistant, floor_id_or_name: str) -> Iterable[str]: ..
 def floor_entities(hass: HomeAssistant, floor_id_or_name: str) -> Iterable[str]: ...
 def areas(hass: HomeAssistant) -> Iterable[str | None]: ...
 def area_id(hass: HomeAssistant, lookup_value: str) -> str | None: ...
-def _get_area_name(area_reg: area_registry.AreaRegistry, valid_area_id: str) -> str: ...
+def _get_area_name(area_reg: ar.AreaRegistry, valid_area_id: str) -> str: ...
 def area_name(hass: HomeAssistant, lookup_value: str) -> str | None: ...
 def area_entities(hass: HomeAssistant, area_id_or_name: str) -> Iterable[str]: ...
 def area_devices(hass: HomeAssistant, area_id_or_name: str) -> Iterable[str]: ...
@@ -281,22 +250,12 @@ def state_attr(hass: HomeAssistant, entity_id: str, name: str) -> Any: ...
 def has_value(hass: HomeAssistant, entity_id: str) -> bool: ...
 def now(hass: HomeAssistant) -> datetime: ...
 def utcnow(hass: HomeAssistant) -> datetime: ...
-def raise_no_default(function: str, value: Any) -> NoReturn: ...
 def forgiving_round(value, precision: int = 0, method: str = 'common', default=...): ...
 def multiply(value, amount, default=...): ...
 def add(value, amount, default=...): ...
 def apply(value, fn, *args, **kwargs): ...
 def as_function(macro: jinja2.runtime.Macro) -> Callable[..., Any]: ...
-def logarithm(value, base=..., default=...): ...
-def sine(value, default=...): ...
-def cosine(value, default=...): ...
-def tangent(value, default=...): ...
-def arc_sine(value, default=...): ...
-def arc_cosine(value, default=...): ...
-def arc_tangent(value, default=...): ...
-def arc_tangent2(*args, default=...): ...
 def version(value): ...
-def square_root(value, default=...): ...
 def timestamp_custom(value, date_format=..., local: bool = True, default=...): ...
 def timestamp_local(value, default=...): ...
 def timestamp_utc(value, default=...): ...
@@ -306,39 +265,16 @@ def as_timedelta(value: str) -> timedelta | None: ...
 def merge_response(value: ServiceResponse) -> list[Any]: ...
 def strptime(string, fmt, default=...): ...
 def fail_when_undefined(value): ...
-def min_max_from_filter(builtin_filter: Any, name: str) -> Any: ...
-def average(*args: Any, default: Any = ...) -> Any: ...
-def median(*args: Any, default: Any = ...) -> Any: ...
-def statistical_mode(*args: Any, default: Any = ...) -> Any: ...
 def forgiving_float(value, default=...): ...
 def forgiving_float_filter(value, default=...): ...
 def forgiving_int(value, default=..., base: int = 10): ...
 def forgiving_int_filter(value, default=..., base: int = 10): ...
 def is_number(value): ...
-def _is_list(value: Any) -> bool: ...
-def _is_set(value: Any) -> bool: ...
-def _is_tuple(value: Any) -> bool: ...
-def _to_set(value: Any) -> set[Any]: ...
-def _to_tuple(value): ...
 def _is_datetime(value: Any) -> bool: ...
 def _is_string_like(value: Any) -> bool: ...
-def regex_match(value, find: str = '', ignorecase: bool = False): ...
-
-_regex_cache: Incomplete
-
-def regex_replace(value: str = '', find: str = '', replace: str = '', ignorecase: bool = False): ...
-def regex_search(value, find: str = '', ignorecase: bool = False): ...
-def regex_findall_index(value, find: str = '', index: int = 0, ignorecase: bool = False): ...
-def regex_findall(value, find: str = '', ignorecase: bool = False): ...
-def bitwise_and(first_value, second_value): ...
-def bitwise_or(first_value, second_value): ...
-def bitwise_xor(first_value, second_value): ...
 def struct_pack(value: Any | None, format_string: str) -> bytes | None: ...
 def struct_unpack(value: bytes, format_string: str, offset: int = 0) -> Any | None: ...
 def from_hex(value: str) -> bytes: ...
-def base64_encode(value: str | bytes) -> str: ...
-def base64_decode(value: str, encoding: str | None = 'utf-8') -> str | bytes: ...
-def ordinal(value): ...
 def from_json(value, default=...): ...
 def _to_json_default(obj: Any) -> None: ...
 def to_json(value: Any, ensure_ascii: bool = False, pretty_print: bool = False, sort_keys: bool = False) -> str: ...
@@ -348,29 +284,9 @@ def today_at(hass: HomeAssistant, time_str: str = '') -> datetime: ...
 def relative_time(hass: HomeAssistant, value: Any) -> Any: ...
 def time_since(hass: HomeAssistant, value: Any | datetime, precision: int = 1) -> Any: ...
 def time_until(hass: HomeAssistant, value: Any | datetime, precision: int = 1) -> Any: ...
-def urlencode(value): ...
-def slugify(value, separator: str = '_'): ...
 def iif(value: Any, if_true: Any = True, if_false: Any = False, if_none: Any = ...) -> Any: ...
-def shuffle(*args: Any, seed: Any = None) -> MutableSequence[Any]: ...
 def typeof(value: Any) -> Any: ...
-def flatten(value: Iterable[Any], levels: int | None = None) -> list[Any]: ...
-def intersect(value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
-def difference(value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
-def union(value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
-def symmetric_difference(value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
 def combine(*args: Any, recursive: bool = False) -> dict[Any, Any]: ...
-def md5(value: str) -> str: ...
-def sha1(value: str) -> str: ...
-def sha256(value: str) -> str: ...
-def sha512(value: str) -> str: ...
-
-class TemplateContextManager(AbstractContextManager):
-    def set_template(self, template_str: str, action: str) -> None: ...
-    def __exit__(self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None) -> None: ...
-
-_template_context_manager: Incomplete
-
-def _render_with_context(template_str: str, template: jinja2.Template, **kwargs: Any) -> str: ...
 def make_logging_undefined(strict: bool | None, log_fn: Callable[[int, str], None] | None) -> type[jinja2.Undefined]: ...
 async def async_load_custom_templates(hass: HomeAssistant) -> None: ...
 def _load_custom_templates(hass: HomeAssistant) -> dict[str, str]: ...
@@ -388,6 +304,7 @@ class HassLoader(jinja2.BaseLoader):
 
 class TemplateEnvironment(ImmutableSandboxedEnvironment):
     hass: Incomplete
+    limited: Incomplete
     template_cache: weakref.WeakValueDictionary[str | jinja2.nodes.Template, CodeType | None]
     loader: Incomplete
     def __init__(self, hass: HomeAssistant | None, limited: bool | None = False, strict: bool | None = False, log_fn: Callable[[int, str], None] | None = None) -> None: ...

homeassistant-stubs/helpers/template/context.pyi

@@ -0,0 +1,16 @@
+import jinja2
+from _typeshed import Incomplete
+from contextlib import AbstractContextManager
+from contextvars import ContextVar
+from types import TracebackType
+from typing import Any
+
+template_cv: ContextVar[tuple[str, str] | None]
+
+class TemplateContextManager(AbstractContextManager):
+    def set_template(self, template_str: str, action: str) -> None: ...
+    def __exit__(self, exc_type: type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None) -> None: ...
+
+template_context_manager: Incomplete
+
+def render_with_context(template_str: str, template: jinja2.Template, **kwargs: Any) -> str: ...

homeassistant-stubs/helpers/template/extensions/__init__.pyi

@@ -0,0 +1,8 @@
+from .base64 import Base64Extension as Base64Extension
+from .collection import CollectionExtension as CollectionExtension
+from .crypto import CryptoExtension as CryptoExtension
+from .math import MathExtension as MathExtension
+from .regex import RegexExtension as RegexExtension
+from .string import StringExtension as StringExtension
+
+__all__ = ['Base64Extension', 'CollectionExtension', 'CryptoExtension', 'MathExtension', 'RegexExtension', 'StringExtension']

homeassistant-stubs/helpers/template/extensions/base.pyi

@@ -0,0 +1,21 @@
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.helpers.template import TemplateEnvironment as TemplateEnvironment
+from jinja2.ext import Extension
+from jinja2.nodes import Node as Node
+from jinja2.parser import Parser as Parser
+from typing import Any
+
+@dataclass
+class TemplateFunction:
+    name: str
+    func: Callable[..., Any] | Any
+    as_global: bool = ...
+    as_filter: bool = ...
+    as_test: bool = ...
+    limited_ok: bool = ...
+
+class BaseTemplateExtension(Extension):
+    environment: TemplateEnvironment
+    def __init__(self, environment: TemplateEnvironment, *, functions: list[TemplateFunction] | None = None) -> None: ...
+    def parse(self, parser: Parser) -> Node | list[Node]: ...

homeassistant-stubs/helpers/template/extensions/base64.pyi

@@ -0,0 +1,9 @@
+from .base import BaseTemplateExtension as BaseTemplateExtension, TemplateFunction as TemplateFunction
+from homeassistant.helpers.template import TemplateEnvironment as TemplateEnvironment
+
+class Base64Extension(BaseTemplateExtension):
+    def __init__(self, environment: TemplateEnvironment) -> None: ...
+    @staticmethod
+    def base64_encode(value: str | bytes) -> str: ...
+    @staticmethod
+    def base64_decode(value: str, encoding: str | None = 'utf-8') -> str | bytes: ...

homeassistant-stubs/helpers/template/extensions/collection.pyi

@@ -0,0 +1,18 @@
+from .base import BaseTemplateExtension as BaseTemplateExtension, TemplateFunction as TemplateFunction
+from collections.abc import Iterable, MutableSequence
+from homeassistant.helpers.template import TemplateEnvironment as TemplateEnvironment
+from typing import Any
+
+class CollectionExtension(BaseTemplateExtension):
+    def __init__(self, environment: TemplateEnvironment) -> None: ...
+    def flatten(self, value: Iterable[Any], levels: int | None = None) -> list[Any]: ...
+    def shuffle(self, *args: Any, seed: Any = None) -> MutableSequence[Any]: ...
+    def intersect(self, value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
+    def difference(self, value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
+    def union(self, value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
+    def symmetric_difference(self, value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
+    def to_set(self, value: Any) -> set[Any]: ...
+    def to_tuple(self, value: Any) -> tuple[Any, ...]: ...
+    def is_list(self, value: Any) -> bool: ...
+    def is_set(self, value: Any) -> bool: ...
+    def is_tuple(self, value: Any) -> bool: ...