homeassistant-stubs 2025.7.3__py3-none-any.whl → 2025.8.0__py3-none-any.whl

homeassistant-stubs/const.pyi

@@ -210,6 +210,7 @@ CONF_PLATFORM: Final[str]
 CONF_PORT: Final[str]
 CONF_PREFIX: Final[str]
 CONF_PROFILE_NAME: Final[str]
+CONF_PROMPT: Final[str]
 CONF_PROTOCOL: Final[str]
 CONF_PROXY_SSL: Final[str]
 CONF_QUOTE: Final[str]
@@ -569,6 +570,7 @@ class UnitOfPrecipitationDepth(StrEnum):
     MILLIMETERS = 'mm'
     CENTIMETERS = 'cm'
 
+CONCENTRATION_GRAMS_PER_CUBIC_METER: Final[str]
 CONCENTRATION_MICROGRAMS_PER_CUBIC_METER: Final[str]
 CONCENTRATION_MILLIGRAMS_PER_CUBIC_METER: Final[str]
 CONCENTRATION_MICROGRAMS_PER_CUBIC_FOOT: Final[str]

homeassistant-stubs/core.pyi

@@ -50,12 +50,14 @@ class ConfigSource(enum.StrEnum, deprecated={'DEFAULT': ('core_config.ConfigSour
 
 class EventStateEventData(TypedDict):
     entity_id: str
-    new_state: State | None
 
 class EventStateChangedData(EventStateEventData):
+    new_state: State | None
     old_state: State | None
 
 class EventStateReportedData(EventStateEventData):
+    last_reported: datetime.datetime
+    new_state: State
     old_last_reported: datetime.datetime
 
 def _deprecated_core_config() -> Any: ...
@@ -328,15 +330,17 @@ class CompressedState(TypedDict):
     lu: NotRequired[float]
 
 class State:
+    entity_id: str
+    domain: str
+    object_id: str
+    state: str
+    attributes: ReadOnlyDict[str, Any]
+    last_changed: datetime.datetime
+    last_reported: datetime.datetime
+    last_updated: datetime.datetime
+    context: Context
     __slots__: Incomplete
     _cache: dict[str, Any]
-    entity_id: Incomplete
-    state: Incomplete
-    attributes: Incomplete
-    last_reported: Incomplete
-    last_updated: Incomplete
-    last_changed: Incomplete
-    context: Incomplete
     state_info: Incomplete
     last_updated_timestamp: Incomplete
     def __init__(self, entity_id: str, state: str, attributes: Mapping[str, Any] | None = None, last_changed: datetime.datetime | None = None, last_reported: datetime.datetime | None = None, last_updated: datetime.datetime | None = None, context: Context | None = None, validate_entity_id: bool | None = True, state_info: StateInfo | None = None, last_updated_timestamp: float | None = None) -> None: ...

homeassistant-stubs/helpers/condition.pyi

@@ -1,25 +1,43 @@
 import abc
 import logging
+from .integration_platform import async_process_integration_platforms as async_process_integration_platforms
 from .template import Template as Template, render_complex as render_complex
 from .trace import TraceElement as TraceElement, trace_append_element as trace_append_element, trace_path as trace_path, trace_path_get as trace_path_get, trace_stack_cv as trace_stack_cv, trace_stack_pop as trace_stack_pop, trace_stack_push as trace_stack_push, trace_stack_top as trace_stack_top
 from .typing import ConfigType as ConfigType, TemplateVarsType as TemplateVarsType
 from _typeshed import Incomplete
-from collections.abc import Callable, Container, Generator
+from collections.abc import Callable, Container, Coroutine, Generator, Iterable
 from contextlib import contextmanager
 from datetime import time as dt_time, timedelta
-from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass
-from homeassistant.const import ATTR_DEVICE_CLASS as ATTR_DEVICE_CLASS, ATTR_GPS_ACCURACY as ATTR_GPS_ACCURACY, ATTR_LATITUDE as ATTR_LATITUDE, ATTR_LONGITUDE as ATTR_LONGITUDE, CONF_ABOVE as CONF_ABOVE, CONF_AFTER as CONF_AFTER, CONF_ATTRIBUTE as CONF_ATTRIBUTE, CONF_BEFORE as CONF_BEFORE, CONF_BELOW as CONF_BELOW, CONF_CONDITION as CONF_CONDITION, CONF_DEVICE_ID as CONF_DEVICE_ID, CONF_ENABLED as CONF_ENABLED, CONF_ENTITY_ID as CONF_ENTITY_ID, CONF_FOR as CONF_FOR, CONF_ID as CONF_ID, CONF_MATCH as CONF_MATCH, CONF_STATE as CONF_STATE, CONF_VALUE_TEMPLATE as CONF_VALUE_TEMPLATE, CONF_WEEKDAY as CONF_WEEKDAY, CONF_ZONE as CONF_ZONE, ENTITY_MATCH_ALL as ENTITY_MATCH_ALL, ENTITY_MATCH_ANY as ENTITY_MATCH_ANY, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN, WEEKDAYS as WEEKDAYS
+from homeassistant.const import ATTR_DEVICE_CLASS as ATTR_DEVICE_CLASS, CONF_ABOVE as CONF_ABOVE, CONF_AFTER as CONF_AFTER, CONF_ATTRIBUTE as CONF_ATTRIBUTE, CONF_BEFORE as CONF_BEFORE, CONF_BELOW as CONF_BELOW, CONF_CONDITION as CONF_CONDITION, CONF_DEVICE_ID as CONF_DEVICE_ID, CONF_ENABLED as CONF_ENABLED, CONF_ENTITY_ID as CONF_ENTITY_ID, CONF_FOR as CONF_FOR, CONF_ID as CONF_ID, CONF_MATCH as CONF_MATCH, CONF_STATE as CONF_STATE, CONF_VALUE_TEMPLATE as CONF_VALUE_TEMPLATE, CONF_WEEKDAY as CONF_WEEKDAY, ENTITY_MATCH_ALL as ENTITY_MATCH_ALL, ENTITY_MATCH_ANY as ENTITY_MATCH_ANY, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN, WEEKDAYS as WEEKDAYS
 from homeassistant.core import HomeAssistant as HomeAssistant, State as State, callback as callback
 from homeassistant.exceptions import ConditionError as ConditionError, ConditionErrorContainer as ConditionErrorContainer, ConditionErrorIndex as ConditionErrorIndex, ConditionErrorMessage as ConditionErrorMessage, HomeAssistantError as HomeAssistantError, TemplateError as TemplateError
-from homeassistant.loader import IntegrationNotFound as IntegrationNotFound, async_get_integration as async_get_integration
+from homeassistant.loader import Integration as Integration, IntegrationNotFound as IntegrationNotFound, async_get_integration as async_get_integration, async_get_integrations as async_get_integrations
 from homeassistant.util.async_ import run_callback_threadsafe as run_callback_threadsafe
+from homeassistant.util.hass_dict import HassKey as HassKey
+from homeassistant.util.yaml import load_yaml_dict as load_yaml_dict
+from homeassistant.util.yaml.loader import JSON_TYPE as JSON_TYPE
 from typing import Any, Protocol
 
 ASYNC_FROM_CONFIG_FORMAT: str
 FROM_CONFIG_FORMAT: str
 VALIDATE_CONFIG_FORMAT: str
+_LOGGER: Incomplete
 _PLATFORM_ALIASES: dict[str | None, str | None]
 INPUT_ENTITY_ID: Incomplete
+CONDITION_DESCRIPTION_CACHE: HassKey[dict[str, dict[str, Any] | None]]
+CONDITION_PLATFORM_SUBSCRIPTIONS: HassKey[list[Callable[[set[str]], Coroutine[Any, Any, None]]]]
+CONDITIONS: HassKey[dict[str, str]]
+_FIELD_SCHEMA: Incomplete
+_CONDITION_SCHEMA: Incomplete
+
+def starts_with_dot(key: str) -> str: ...
+
+_CONDITIONS_SCHEMA: Incomplete
+
+async def async_setup(hass: HomeAssistant) -> None: ...
+@callback
+def async_subscribe_platform_events(hass: HomeAssistant, on_event: Callable[[set[str]], Coroutine[Any, Any, None]]) -> Callable[[], None]: ...
+async def _register_condition_platform(hass: HomeAssistant, integration_domain: str, platform: ConditionProtocol) -> None: ...
 
 class Condition(abc.ABC, metaclass=abc.ABCMeta):
     def __init__(self, hass: HomeAssistant, config: ConfigType) -> None: ...
@@ -54,8 +72,6 @@ def async_template(hass: HomeAssistant, value_template: Template, variables: Tem
 def async_template_from_config(config: ConfigType) -> ConditionCheckerType: ...
 def time(hass: HomeAssistant, before: dt_time | str | None = None, after: dt_time | str | None = None, weekday: str | Container[str] | None = None) -> bool: ...
 def time_from_config(config: ConfigType) -> ConditionCheckerType: ...
-def zone(hass: HomeAssistant, zone_ent: str | State | None, entity: str | State | None) -> bool: ...
-def zone_from_config(config: ConfigType) -> ConditionCheckerType: ...
 async def async_trigger_from_config(hass: HomeAssistant, config: ConfigType) -> ConditionCheckerType: ...
 def numeric_state_validate_config(hass: HomeAssistant, config: ConfigType) -> ConfigType: ...
 def state_validate_config(hass: HomeAssistant, config: ConfigType) -> ConfigType: ...
@@ -66,3 +82,6 @@ async def async_conditions_from_config(hass: HomeAssistant, condition_configs: l
 def async_extract_entities(config: ConfigType | Template) -> set[str]: ...
 @callback
 def async_extract_devices(config: ConfigType | Template) -> set[str]: ...
+def _load_conditions_file(hass: HomeAssistant, integration: Integration) -> JSON_TYPE: ...
+def _load_conditions_files(hass: HomeAssistant, integrations: Iterable[Integration]) -> dict[str, JSON_TYPE]: ...
+async def async_get_all_descriptions(hass: HomeAssistant) -> dict[str, dict[str, Any] | None]: ...

homeassistant-stubs/helpers/config_validation.pyi

@@ -190,11 +190,9 @@ STATE_CONDITION_ATTRIBUTE_SCHEMA: Incomplete
 
 def STATE_CONDITION_SCHEMA(value: Any) -> dict[str, Any]: ...
 
-SUN_CONDITION_SCHEMA: Incomplete
 TEMPLATE_CONDITION_SCHEMA: Incomplete
 TIME_CONDITION_SCHEMA: Incomplete
 TRIGGER_CONDITION_SCHEMA: Incomplete
-ZONE_CONDITION_SCHEMA: Incomplete
 AND_CONDITION_SCHEMA: Incomplete
 AND_CONDITION_SHORTHAND_SCHEMA: Incomplete
 OR_CONDITION_SCHEMA: Incomplete

homeassistant-stubs/helpers/device.pyi

@@ -4,6 +4,8 @@ from homeassistant.core import HomeAssistant as HomeAssistant, callback as callb
 @callback
 def async_entity_id_to_device_id(hass: HomeAssistant, entity_id_or_uuid: str) -> str | None: ...
 @callback
+def async_entity_id_to_device(hass: HomeAssistant, entity_id_or_uuid: str) -> dr.DeviceEntry | None: ...
+@callback
 def async_device_info_to_link_from_entity(hass: HomeAssistant, entity_id_or_uuid: str) -> dr.DeviceInfo | None: ...
 @callback
 def async_device_info_to_link_from_device_id(hass: HomeAssistant, device_id: str | None) -> dr.DeviceInfo | None: ...

homeassistant-stubs/helpers/device_registry.pyi

@@ -1,5 +1,6 @@
 from . import entity_registry as entity_registry, storage as storage, translation as translation
 from .debounce import Debouncer as Debouncer
+from .deprecation import deprecated_function as deprecated_function
 from .frame import ReportBehavior as ReportBehavior, report_usage as report_usage
 from .json import JSON_DUMP as JSON_DUMP, find_paths_unserializable_data as find_paths_unserializable_data, json_bytes as json_bytes, json_fragment as json_fragment
 from .registry import BaseRegistry as BaseRegistry, BaseRegistryItems as BaseRegistryItems, RegistryIndexType as RegistryIndexType
@@ -68,15 +69,20 @@ DEVICE_INFO_TYPES: Incomplete
 DEVICE_INFO_KEYS: Incomplete
 LOW_PRIO_CONFIG_ENTRY_DOMAINS: Incomplete
 
-class _EventDeviceRegistryUpdatedData_CreateRemove(TypedDict):
-    action: Literal['create', 'remove']
+class _EventDeviceRegistryUpdatedData_Create(TypedDict):
+    action: Literal['create']
     device_id: str
 
+class _EventDeviceRegistryUpdatedData_Remove(TypedDict):
+    action: Literal['remove']
+    device_id: str
+    device: dict[str, Any]
+
 class _EventDeviceRegistryUpdatedData_Update(TypedDict):
     action: Literal['update']
     device_id: str
     changes: dict[str, Any]
-type EventDeviceRegistryUpdatedData = _EventDeviceRegistryUpdatedData_CreateRemove | _EventDeviceRegistryUpdatedData_Update
+type EventDeviceRegistryUpdatedData = _EventDeviceRegistryUpdatedData_Create | _EventDeviceRegistryUpdatedData_Remove | _EventDeviceRegistryUpdatedData_Update
 
 class DeviceEntryType(StrEnum):
     SERVICE = 'service'
@@ -99,6 +105,9 @@ def _validate_device_info(config_entry: ConfigEntry, device_info: DeviceInfo) ->
 _cached_parse_url: Incomplete
 
 def _validate_configuration_url(value: Any) -> str | None: ...
+def format_mac(mac: str) -> str: ...
+def _normalize_connections(connections: Iterable[tuple[str, str]]) -> set[tuple[str, str]]: ...
+def _normalize_connections_validator(instance: Any, attribute: Any, connections: Iterable[tuple[str, str]]) -> None: ...
 
 class DeviceEntry:
     area_id: str | None
@@ -121,7 +130,7 @@ class DeviceEntry:
     name: str | None
     primary_config_entry: str | None
     serial_number: str | None
-    suggested_area: str | None
+    _suggested_area: str | None
     sw_version: str | None
     via_device_id: str | None
     is_new: bool
@@ -134,6 +143,8 @@ class DeviceEntry:
     def json_repr(self) -> bytes | None: ...
     @under_cached_property
     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 __lt__(self, other): ...
     def __le__(self, other): ...
@@ -163,8 +174,6 @@ class DeletedDeviceEntry:
     def __gt__(self, other): ...
     def __ge__(self, other): ...
 
-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]: ...
 
@@ -203,7 +212,7 @@ 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 = ..., 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 = ..., 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: ...
     @callback
     def _validate_connections(self, device_id: str, connections: set[tuple[str, str]], allow_collisions: bool) -> set[tuple[str, str]]: ...
     @callback
@@ -239,4 +248,3 @@ def async_config_entry_disabled_by_changed(registry: DeviceRegistry, config_entr
 def async_cleanup(hass: HomeAssistant, dev_reg: DeviceRegistry, ent_reg: entity_registry.EntityRegistry) -> None: ...
 @callback
 def async_setup_cleanup(hass: HomeAssistant, dev_reg: DeviceRegistry) -> None: ...
-def _normalize_connections(connections: set[tuple[str, str]]) -> set[tuple[str, str]]: ...

homeassistant-stubs/helpers/entity.pyi

@@ -3,7 +3,7 @@ import dataclasses
 import time
 from . import device_registry as dr, entity_registry as er, singleton as singleton
 from .device_registry import DeviceInfo as DeviceInfo, EventDeviceRegistryUpdatedData as EventDeviceRegistryUpdatedData
-from .entity_platform import EntityPlatform as EntityPlatform
+from .entity_platform import EntityPlatform as EntityPlatform, PlatformData as PlatformData
 from .event import async_track_device_registry_updated_event as async_track_device_registry_updated_event, async_track_entity_registry_updated_event as async_track_entity_registry_updated_event
 from .frame import report_non_thread_safe_operation as report_non_thread_safe_operation
 from .typing import StateType as StateType, UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
@@ -54,6 +54,7 @@ class StateInfo(TypedDict):
 
 class EntityPlatformState(Enum):
     NOT_ADDED = ...
+    ADDING = ...
     ADDED = ...
     REMOVED = ...
 
@@ -91,6 +92,7 @@ class Entity(cached_properties=CACHED_PROPERTIES_WITH_ATTR_, metaclass=ABCCached
     entity_id: str
     hass: HomeAssistant
     platform: EntityPlatform
+    platform_data: PlatformData
     entity_description: EntityDescription
     _slow_reported: bool
     _deprecated_supported_features_reported: bool

homeassistant-stubs/helpers/entity_platform.pyi

@@ -1,5 +1,6 @@
 import asyncio
 from . import device_registry as dev_reg, service as service, translation as translation
+from .deprecation import deprecated_function as deprecated_function
 from .entity import Entity as Entity
 from .entity_registry import EntityRegistry as EntityRegistry, RegistryEntryDisabler as RegistryEntryDisabler, RegistryEntryHider as RegistryEntryHider
 from .event import async_call_later as async_call_later
@@ -42,22 +43,28 @@ class EntityPlatformModule(Protocol):
     def setup_platform(self, hass: HomeAssistant, config: ConfigType, add_entities: AddEntitiesCallback, discovery_info: DiscoveryInfoType | None = None) -> None: ...
     async def async_setup_entry(self, hass: HomeAssistant, entry: config_entries.ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
-class EntityPlatform:
+class PlatformData:
     hass: Incomplete
-    logger: Incomplete
     domain: Incomplete
     platform_name: Incomplete
+    component_translations: dict[str, str]
+    platform_translations: dict[str, str]
+    object_id_component_translations: dict[str, str]
+    object_id_platform_translations: dict[str, str]
+    default_language_platform_translations: dict[str, str]
+    def __init__(self, hass: HomeAssistant, *, domain: str, platform_name: str) -> None: ...
+    async def _async_get_translations(self, language: str, category: str, integration: str) -> dict[str, str]: ...
+    async def async_load_translations(self) -> None: ...
+
+class EntityPlatform:
+    hass: Incomplete
+    logger: Incomplete
     platform: Incomplete
     scan_interval: Incomplete
     scan_interval_seconds: Incomplete
     entity_namespace: Incomplete
     config_entry: config_entries.ConfigEntry | None
     entities: dict[str, Entity]
-    component_translations: dict[str, str]
-    platform_translations: dict[str, str]
-    object_id_component_translations: dict[str, str]
-    object_id_platform_translations: dict[str, str]
-    default_language_platform_translations: dict[str, str]
     _tasks: list[asyncio.Task[None]]
     _setup_complete: bool
     _async_polling_timer: asyncio.TimerHandle | None
@@ -68,6 +75,7 @@ class EntityPlatform:
     parallel_updates_created: Incomplete
     domain_entities: Incomplete
     domain_platform_entities: Incomplete
+    platform_data: Incomplete
     def __init__(self, *, hass: HomeAssistant, logger: Logger, domain: str, platform_name: str, platform: EntityPlatformModule | None, scan_interval: timedelta, entity_namespace: str | None) -> None: ...
     def __repr__(self) -> str: ...
     @callback
@@ -79,8 +87,6 @@ class EntityPlatform:
     def async_cancel_retry_setup(self) -> None: ...
     async def async_setup_entry(self, config_entry: config_entries.ConfigEntry) -> bool: ...
     async def _async_setup_platform(self, async_create_setup_awaitable: Callable[[], Awaitable[None]], tries: int = 0) -> bool: ...
-    async def _async_get_translations(self, language: str, category: str, integration: str) -> dict[str, str]: ...
-    async def async_load_translations(self) -> None: ...
     def _schedule_add_entities(self, new_entities: Iterable[Entity], update_before_add: bool = False) -> None: ...
     @callback
     def _async_schedule_add_entities(self, new_entities: Iterable[Entity], update_before_add: bool = False) -> None: ...
@@ -105,6 +111,21 @@ class EntityPlatform:
     @callback
     def async_register_entity_service(self, name: str, schema: VolDictType | VolSchemaType | None, func: str | Callable[..., Any], required_features: Iterable[int] | None = None, supports_response: SupportsResponse = ...) -> None: ...
     async def _async_update_entity_states(self) -> None: ...
+    @property
+    def domain(self) -> str: ...
+    @property
+    def platform_name(self) -> str: ...
+    @property
+    def component_translations(self) -> dict[str, str]: ...
+    @property
+    def platform_translations(self) -> dict[str, str]: ...
+    @property
+    def object_id_component_translations(self) -> dict[str, str]: ...
+    @property
+    def object_id_platform_translations(self) -> dict[str, str]: ...
+    @property
+    def default_language_platform_translations(self) -> dict[str, str]: ...
+    async def async_load_translations(self) -> None: ...
 
 @callback
 def async_calculate_suggested_object_id(entity: Entity, device: dev_reg.DeviceEntry | None) -> str | None: ...

homeassistant-stubs/helpers/frame.pyi

@@ -47,7 +47,7 @@ class ReportBehavior(enum.Enum):
     ERROR = ...
 
 def report_usage(what: str, *, breaks_in_ha_version: str | None = None, core_behavior: ReportBehavior = ..., core_integration_behavior: ReportBehavior = ..., custom_integration_behavior: ReportBehavior = ..., exclude_integrations: set[str] | None = None, integration_domain: str | None = None, level: int = ...) -> None: ...
-def _report_usage(hass: HomeAssistant, what: str, *, breaks_in_ha_version: str | None, core_behavior: ReportBehavior, core_integration_behavior: ReportBehavior, custom_integration_behavior: ReportBehavior, exclude_integrations: set[str] | None, integration_domain: str | None, level: int) -> None: ...
+def _report_usage(hass: HomeAssistant, what: str, *, breaks_in_ha_version: str | None, core_behavior: ReportBehavior, core_integration_behavior: ReportBehavior, custom_integration_behavior: ReportBehavior, integration_domain: str | None, integration_frame: IntegrationFrame | None, integration_frame_err: MissingIntegrationFrame | None, level: int) -> None: ...
 def _report_usage_integration_domain(hass: HomeAssistant | None, what: str, breaks_in_ha_version: str | None, integration: Integration, core_integration_behavior: ReportBehavior, custom_integration_behavior: ReportBehavior, level: int) -> None: ...
 def _report_usage_integration_frame(hass: HomeAssistant, what: str, breaks_in_ha_version: str | None, integration_frame: IntegrationFrame, level: int = ..., error: bool = False) -> None: ...
 def _report_usage_no_integration(what: str, core_behavior: ReportBehavior, breaks_in_ha_version: str | None, err: MissingIntegrationFrame | None) -> None: ...

homeassistant-stubs/helpers/helper_integration.pyi

@@ -3,4 +3,5 @@ from collections.abc import Callable as Callable, Coroutine
 from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Event as Event, HomeAssistant as HomeAssistant, valid_entity_id as valid_entity_id
 from typing import Any
 
-def async_handle_source_entity_changes(hass: HomeAssistant, *, helper_config_entry_id: str, set_source_entity_id_or_uuid: Callable[[str], None], source_device_id: str | None, source_entity_id_or_uuid: str, source_entity_removed: Callable[[], Coroutine[Any, Any, None]]) -> CALLBACK_TYPE: ...
+def async_handle_source_entity_changes(hass: HomeAssistant, *, add_helper_config_entry_to_device: bool = True, helper_config_entry_id: str, set_source_entity_id_or_uuid: Callable[[str], None], source_device_id: str | None, source_entity_id_or_uuid: str, source_entity_removed: Callable[[], Coroutine[Any, Any, None]] | None = None) -> CALLBACK_TYPE: ...
+def async_remove_helper_config_entry_from_source_device(hass: HomeAssistant, *, helper_config_entry_id: str, source_device_id: str) -> None: ...

homeassistant-stubs/helpers/llm.pyi

@@ -84,6 +84,10 @@ class IntentTool(Tool):
     def __init__(self, name: str, intent_handler: intent.IntentHandler) -> None: ...
     async def async_call(self, hass: HomeAssistant, tool_input: ToolInput, llm_context: LLMContext) -> JsonObjectType: ...
 
+class IntentResponseDict(dict):
+    original: Incomplete
+    def __init__(self, intent_response: Any) -> None: ...
+
 class NamespacedTool(Tool):
     namespace: Incomplete
     name: Incomplete
@@ -114,7 +118,7 @@ class AssistAPI(API):
     def _async_get_tools(self, llm_context: LLMContext, exposed_entities: dict | None) -> list[Tool]: ...
 
 def _get_exposed_entities(hass: HomeAssistant, assistant: str, include_state: bool = True) -> dict[str, dict[str, dict[str, Any]]]: ...
-def _selector_serializer(schema: Any) -> Any: ...
+def selector_serializer(schema: Any) -> Any: ...
 def _get_cached_action_parameters(hass: HomeAssistant, domain: str, action: str) -> tuple[str | None, vol.Schema]: ...
 
 class ActionTool(Tool):

homeassistant-stubs/helpers/schema_config_entry_flow.pyi

@@ -22,6 +22,7 @@ class SchemaFlowFormStep(SchemaFlowStep):
     next_step: Callable[[dict[str, Any]], Coroutine[Any, Any, str | None]] | str | None = ...
     suggested_values: Callable[[SchemaCommonFlowHandler], Coroutine[Any, Any, dict[str, Any]]] | None | UndefinedType = ...
     preview: str | None = ...
+    description_placeholders: Callable[[SchemaCommonFlowHandler], Coroutine[Any, Any, dict[str, str]]] | UndefinedType = ...
 
 @dataclass(slots=True)
 class SchemaFlowMenuStep(SchemaFlowStep):

homeassistant-stubs/helpers/selector.pyi

@@ -26,7 +26,7 @@ class Selector[_T: Mapping[str, Any]]:
 @cache
 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: int | list[str]) -> int: ...
+def _validate_supported_features(supported_features: list[str]) -> int: ...
 
 BASE_SELECTOR_CONFIG_SCHEMA: Incomplete
 
@@ -34,6 +34,7 @@ class BaseSelectorConfig(TypedDict, total=False):
     read_only: bool
 
 ENTITY_FILTER_SELECTOR_CONFIG_SCHEMA: Incomplete
+LEGACY_ENTITY_SELECTOR_CONFIG_SCHEMA: Incomplete
 
 class EntityFilterSelectorConfig(TypedDict, total=False):
     integration: str
@@ -42,6 +43,7 @@ class EntityFilterSelectorConfig(TypedDict, total=False):
     supported_features: list[str]
 
 DEVICE_FILTER_SELECTOR_CONFIG_SCHEMA: Incomplete
+LEGACY_DEVICE_SELECTOR_CONFIG_SCHEMA: Incomplete
 
 class DeviceFilterSelectorConfig(TypedDict, total=False):
     integration: str
@@ -165,23 +167,6 @@ class ConstantSelector(Selector[ConstantSelectorConfig]):
     def __init__(self, config: ConstantSelectorConfig) -> None: ...
     def __call__(self, data: Any) -> Any: ...
 
-class QrErrorCorrectionLevel(StrEnum):
-    LOW = 'low'
-    MEDIUM = 'medium'
-    QUARTILE = 'quartile'
-    HIGH = 'high'
-
-class QrCodeSelectorConfig(BaseSelectorConfig, total=False):
-    data: str
-    scale: int
-    error_correction_level: QrErrorCorrectionLevel
-
-class QrCodeSelector(Selector[QrCodeSelectorConfig]):
-    selector_type: str
-    CONFIG_SCHEMA: Incomplete
-    def __init__(self, config: QrCodeSelectorConfig) -> None: ...
-    def __call__(self, data: Any) -> Any: ...
-
 class ConversationAgentSelectorConfig(BaseSelectorConfig, total=False):
     language: str
 
@@ -243,6 +228,7 @@ class EntitySelectorConfig(BaseSelectorConfig, EntityFilterSelectorConfig, total
     exclude_entities: list[str]
     include_entities: list[str]
     multiple: bool
+    reorder: bool
     filter: EntityFilterSelectorConfig | list[EntityFilterSelectorConfig]
 
 class EntitySelector(Selector[EntitySelectorConfig]):
@@ -251,6 +237,15 @@ class EntitySelector(Selector[EntitySelectorConfig]):
     def __init__(self, config: EntitySelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str | list[str]: ...
 
+class FileSelectorConfig(BaseSelectorConfig):
+    accept: str
+
+class FileSelector(Selector[FileSelectorConfig]):
+    selector_type: str
+    CONFIG_SCHEMA: Incomplete
+    def __init__(self, config: FileSelectorConfig) -> None: ...
+    def __call__(self, data: Any) -> str: ...
+
 class FloorSelectorConfig(BaseSelectorConfig, total=False):
     entity: EntityFilterSelectorConfig | list[EntityFilterSelectorConfig]
     device: DeviceFilterSelectorConfig | list[DeviceFilterSelectorConfig]
@@ -310,7 +305,7 @@ class MediaSelector(Selector[MediaSelectorConfig]):
     CONFIG_SCHEMA: Incomplete
     DATA_SCHEMA: Incomplete
     def __init__(self, config: MediaSelectorConfig | None = None) -> None: ...
-    def __call__(self, data: Any) -> dict[str, float]: ...
+    def __call__(self, data: Any) -> dict[str, str]: ...
 
 class NumberSelectorConfig(BaseSelectorConfig, total=False):
     min: float
@@ -318,6 +313,7 @@ class NumberSelectorConfig(BaseSelectorConfig, total=False):
     step: float | Literal['any']
     unit_of_measurement: str
     mode: NumberSelectorMode
+    translation_key: str
 
 class NumberSelectorMode(StrEnum):
     BOX = 'box'
@@ -349,6 +345,23 @@ class ObjectSelector(Selector[ObjectSelectorConfig]):
     def __init__(self, config: ObjectSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> Any: ...
 
+class QrErrorCorrectionLevel(StrEnum):
+    LOW = 'low'
+    MEDIUM = 'medium'
+    QUARTILE = 'quartile'
+    HIGH = 'high'
+
+class QrCodeSelectorConfig(BaseSelectorConfig, total=False):
+    data: str
+    scale: int
+    error_correction_level: QrErrorCorrectionLevel
+
+class QrCodeSelector(Selector[QrCodeSelectorConfig]):
+    selector_type: str
+    CONFIG_SCHEMA: Incomplete
+    def __init__(self, config: QrCodeSelectorConfig) -> None: ...
+    def __call__(self, data: Any) -> Any: ...
+
 select_option: Incomplete
 
 class SelectOptionDict(TypedDict):
@@ -373,6 +386,16 @@ class SelectSelector(Selector[SelectSelectorConfig]):
     def __init__(self, config: SelectSelectorConfig) -> None: ...
     def __call__(self, data: Any) -> Any: ...
 
+class StateSelectorConfig(BaseSelectorConfig, total=False):
+    entity_id: str
+    hide_states: list[str]
+
+class StateSelector(Selector[StateSelectorConfig]):
+    selector_type: str
+    CONFIG_SCHEMA: Incomplete
+    def __init__(self, config: StateSelectorConfig) -> None: ...
+    def __call__(self, data: Any) -> str: ...
+
 class StatisticSelectorConfig(BaseSelectorConfig, total=False):
     multiple: bool
 
@@ -386,15 +409,6 @@ class TargetSelectorConfig(BaseSelectorConfig, total=False):
     entity: EntityFilterSelectorConfig | list[EntityFilterSelectorConfig]
     device: DeviceFilterSelectorConfig | list[DeviceFilterSelectorConfig]
 
-class StateSelectorConfig(BaseSelectorConfig, total=False):
-    entity_id: Required[str]
-
-class StateSelector(Selector[StateSelectorConfig]):
-    selector_type: str
-    CONFIG_SCHEMA: Incomplete
-    def __init__(self, config: StateSelectorConfig) -> None: ...
-    def __call__(self, data: Any) -> str: ...
-
 class TargetSelector(Selector[TargetSelectorConfig]):
     selector_type: str
     CONFIG_SCHEMA: Incomplete
@@ -462,12 +476,3 @@ class TriggerSelector(Selector[TriggerSelectorConfig]):
     CONFIG_SCHEMA = BASE_SELECTOR_CONFIG_SCHEMA
     def __init__(self, config: TriggerSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> Any: ...
-
-class FileSelectorConfig(BaseSelectorConfig):
-    accept: str
-
-class FileSelector(Selector[FileSelectorConfig]):
-    selector_type: str
-    CONFIG_SCHEMA: Incomplete
-    def __init__(self, config: FileSelectorConfig) -> None: ...
-    def __call__(self, data: Any) -> str: ...

homeassistant-stubs/helpers/service.pyi

@@ -1,14 +1,14 @@
-import dataclasses
-from . import area_registry as area_registry, device_registry as device_registry, entity_registry as entity_registry, floor_registry as floor_registry, label_registry as label_registry, template as template, translation as translation
+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 .entity import Entity as Entity
-from .group import expand_entity_ids as expand_entity_ids
 from .selector import TargetSelector as TargetSelector
 from .typing import ConfigType as ConfigType, TemplateVarsType as TemplateVarsType, VolDictType as VolDictType, VolSchemaType as VolSchemaType
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable, Coroutine, Iterable
 from functools import cache
 from homeassistant.auth.permissions.const import CAT_ENTITIES as CAT_ENTITIES, POLICY_CONTROL as POLICY_CONTROL
-from homeassistant.const import ATTR_AREA_ID as ATTR_AREA_ID, ATTR_DEVICE_ID as ATTR_DEVICE_ID, ATTR_ENTITY_ID as ATTR_ENTITY_ID, ATTR_FLOOR_ID as ATTR_FLOOR_ID, ATTR_LABEL_ID as ATTR_LABEL_ID, CONF_ACTION as CONF_ACTION, CONF_ENTITY_ID as CONF_ENTITY_ID, CONF_SERVICE_DATA as CONF_SERVICE_DATA, CONF_SERVICE_DATA_TEMPLATE as CONF_SERVICE_DATA_TEMPLATE, CONF_SERVICE_TEMPLATE as CONF_SERVICE_TEMPLATE, CONF_TARGET as CONF_TARGET, ENTITY_MATCH_ALL as ENTITY_MATCH_ALL, ENTITY_MATCH_NONE as ENTITY_MATCH_NONE
+from homeassistant.const import ATTR_ENTITY_ID as ATTR_ENTITY_ID, CONF_ACTION as CONF_ACTION, CONF_ENTITY_ID as CONF_ENTITY_ID, CONF_SELECTOR as CONF_SELECTOR, CONF_SERVICE_DATA as CONF_SERVICE_DATA, CONF_SERVICE_DATA_TEMPLATE as CONF_SERVICE_DATA_TEMPLATE, CONF_SERVICE_TEMPLATE as CONF_SERVICE_TEMPLATE, CONF_TARGET as CONF_TARGET, ENTITY_MATCH_ALL as ENTITY_MATCH_ALL, ENTITY_MATCH_NONE as ENTITY_MATCH_NONE
 from homeassistant.core import Context as Context, EntityServiceResponse as EntityServiceResponse, HassJob as HassJob, HassJobType as HassJobType, HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, ServiceResponse as ServiceResponse, SupportsResponse as SupportsResponse, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, ServiceNotSupported as ServiceNotSupported, TemplateError as TemplateError, Unauthorized as Unauthorized, UnknownUser as UnknownUser
 from homeassistant.loader import Integration as Integration, async_get_integrations as async_get_integrations, bind_hass as bind_hass
@@ -17,7 +17,7 @@ from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.yaml import load_yaml_dict as load_yaml_dict
 from homeassistant.util.yaml.loader import JSON_TYPE as JSON_TYPE
 from types import ModuleType
-from typing import Any, TypeGuard, TypedDict
+from typing import Any, TypedDict, override
 
 CONF_SERVICE_ENTITY_ID: str
 _LOGGER: Incomplete
@@ -44,28 +44,12 @@ class ServiceParams(TypedDict):
     service_data: dict[str, Any]
     target: dict | None
 
-class ServiceTargetSelector:
-    __slots__: Incomplete
-    entity_ids: Incomplete
-    device_ids: Incomplete
-    area_ids: Incomplete
-    floor_ids: Incomplete
-    label_ids: Incomplete
+class ServiceTargetSelector(target_helpers.TargetSelectorData):
     def __init__(self, service_call: ServiceCall) -> None: ...
-    @property
-    def has_any_selector(self) -> bool: ...
 
-@dataclasses.dataclass(slots=True)
-class SelectedEntities:
-    referenced: set[str] = dataclasses.field(default_factory=set)
-    indirectly_referenced: set[str] = dataclasses.field(default_factory=set)
-    missing_devices: set[str] = dataclasses.field(default_factory=set)
-    missing_areas: set[str] = dataclasses.field(default_factory=set)
-    missing_floors: set[str] = dataclasses.field(default_factory=set)
-    missing_labels: set[str] = dataclasses.field(default_factory=set)
-    referenced_devices: set[str] = dataclasses.field(default_factory=set)
-    referenced_areas: set[str] = dataclasses.field(default_factory=set)
-    def log_missing(self, missing_entities: set[str]) -> None: ...
+class SelectedEntities(target_helpers.SelectedEntities):
+    @override
+    def log_missing(self, missing_entities: set[str], logger: logging.Logger | None = None) -> None: ...
 
 @bind_hass
 def call_from_config(hass: HomeAssistant, config: ConfigType, blocking: bool = False, variables: TemplateVarsType = None, validate_config: bool = True) -> None: ...
@@ -80,7 +64,6 @@ def extract_entity_ids(hass: HomeAssistant, service_call: ServiceCall, expand_gr
 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 _has_match(ids: str | list[str] | None) -> TypeGuard[str | list[str]]: ...
 @bind_hass
 def async_extract_referenced_entity_ids(hass: HomeAssistant, service_call: ServiceCall, expand_group: bool = True) -> SelectedEntities: ...
 @bind_hass