homeassistant-stubs 2024.7.4__py3-none-any.whl → 2024.8.0__py3-none-any.whl

homeassistant-stubs/helpers/category_registry.pyi

@@ -5,20 +5,25 @@ from .typing import UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
 from _typeshed import Incomplete
 from collections.abc import Iterable
 from dataclasses import dataclass
+from datetime import datetime
 from homeassistant.core import Event as Event, 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 homeassistant.util.ulid import ulid_now as ulid_now
-from typing import Literal, TypedDict
+from typing import Any, Literal, TypedDict
 
 DATA_REGISTRY: HassKey[CategoryRegistry]
 EVENT_CATEGORY_REGISTRY_UPDATED: EventType[EventCategoryRegistryUpdatedData]
 STORAGE_KEY: str
 STORAGE_VERSION_MAJOR: int
+STORAGE_VERSION_MINOR: int
 
 class _CategoryStoreData(TypedDict):
     category_id: str
+    created_at: str
     icon: str | None
+    modified_at: str
     name: str
 
 class CategoryRegistryStoreData(TypedDict):
@@ -33,9 +38,14 @@ EventCategoryRegistryUpdated = Event[EventCategoryRegistryUpdatedData]
 @dataclass(slots=True, kw_only=True, frozen=True)
 class CategoryEntry:
     category_id: str = ...
+    created_at: datetime = ...
     icon: str | None = ...
+    modified_at: datetime = ...
     name: str
-    def __init__(self, *, category_id, icon, name) -> None: ...
+    def __init__(self, *, category_id=..., created_at=..., icon=..., modified_at=..., name) -> None: ...
+
+class CategoryRegistryStore(Store[CategoryRegistryStoreData]):
+    async def _async_migrate_func(self, old_major_version: int, old_minor_version: int, old_data: dict[str, dict[str, list[dict[str, Any]]]]) -> CategoryRegistryStoreData: ...
 
 class CategoryRegistry(BaseRegistry[CategoryRegistryStoreData]):
     hass: Incomplete

homeassistant-stubs/helpers/condition.pyi

@@ -4,7 +4,7 @@ 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 Container
+from collections.abc import Callable, Container, Generator
 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, SUN_EVENT_SUNRISE as SUN_EVENT_SUNRISE, SUN_EVENT_SUNSET as SUN_EVENT_SUNSET, WEEKDAYS as WEEKDAYS
@@ -13,7 +13,6 @@ from homeassistant.exceptions import ConditionError as ConditionError, Condition
 from homeassistant.loader import IntegrationNotFound as IntegrationNotFound, async_get_integration as async_get_integration
 from homeassistant.util.async_ import run_callback_threadsafe as run_callback_threadsafe
 from typing import Any, Protocol
-from typing_extensions import Generator
 
 ASYNC_FROM_CONFIG_FORMAT: str
 FROM_CONFIG_FORMAT: str
@@ -25,8 +24,7 @@ class ConditionProtocol(Protocol):
     CONDITION_SCHEMA: vol.Schema
     async def async_validate_condition_config(self, hass: HomeAssistant, config: ConfigType) -> ConfigType: ...
     def async_condition_from_config(self, hass: HomeAssistant, config: ConfigType) -> ConditionCheckerType: ...
-
-ConditionCheckerType: Incomplete
+ConditionCheckerType = Callable[[HomeAssistant, TemplateVarsType], bool | None]
 
 def condition_trace_append(variables: TemplateVarsType, path: str) -> TraceElement: ...
 def condition_trace_set_result(result: bool, **kwargs: Any) -> None: ...

homeassistant-stubs/helpers/config_validation.pyi

@@ -7,7 +7,7 @@ from _typeshed import Incomplete
 from collections.abc import Callable as Callable, Hashable
 from datetime import date as date_sys, datetime as datetime_sys, time as time_sys, timedelta
 from enum import Enum, StrEnum
-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_ABOVE as CONF_ABOVE, CONF_ALIAS as CONF_ALIAS, CONF_ATTRIBUTE as CONF_ATTRIBUTE, CONF_BELOW as CONF_BELOW, CONF_CHOOSE as CONF_CHOOSE, CONF_CONDITION as CONF_CONDITION, CONF_CONDITIONS as CONF_CONDITIONS, CONF_CONTINUE_ON_ERROR as CONF_CONTINUE_ON_ERROR, CONF_CONTINUE_ON_TIMEOUT as CONF_CONTINUE_ON_TIMEOUT, CONF_COUNT as CONF_COUNT, CONF_DEFAULT as CONF_DEFAULT, CONF_DELAY as CONF_DELAY, CONF_DEVICE_ID as CONF_DEVICE_ID, CONF_DOMAIN as CONF_DOMAIN, CONF_ELSE as CONF_ELSE, CONF_ENABLED as CONF_ENABLED, CONF_ENTITY_ID as CONF_ENTITY_ID, CONF_ENTITY_NAMESPACE as CONF_ENTITY_NAMESPACE, CONF_ERROR as CONF_ERROR, CONF_EVENT as CONF_EVENT, CONF_EVENT_DATA as CONF_EVENT_DATA, CONF_EVENT_DATA_TEMPLATE as CONF_EVENT_DATA_TEMPLATE, CONF_FOR as CONF_FOR, CONF_FOR_EACH as CONF_FOR_EACH, CONF_ID as CONF_ID, CONF_IF as CONF_IF, CONF_MATCH as CONF_MATCH, CONF_PARALLEL as CONF_PARALLEL, CONF_PLATFORM as CONF_PLATFORM, CONF_REPEAT as CONF_REPEAT, CONF_RESPONSE_VARIABLE as CONF_RESPONSE_VARIABLE, CONF_SCAN_INTERVAL as CONF_SCAN_INTERVAL, CONF_SCENE as CONF_SCENE, CONF_SEQUENCE as CONF_SEQUENCE, CONF_SERVICE as CONF_SERVICE, CONF_SERVICE_DATA as CONF_SERVICE_DATA, CONF_SERVICE_DATA_TEMPLATE as CONF_SERVICE_DATA_TEMPLATE, CONF_SERVICE_TEMPLATE as CONF_SERVICE_TEMPLATE, CONF_SET_CONVERSATION_RESPONSE as CONF_SET_CONVERSATION_RESPONSE, CONF_STATE as CONF_STATE, CONF_STOP as CONF_STOP, CONF_TARGET as CONF_TARGET, CONF_THEN as CONF_THEN, CONF_TIMEOUT as CONF_TIMEOUT, CONF_UNTIL as CONF_UNTIL, CONF_VALUE_TEMPLATE as CONF_VALUE_TEMPLATE, CONF_VARIABLES as CONF_VARIABLES, CONF_WAIT_FOR_TRIGGER as CONF_WAIT_FOR_TRIGGER, CONF_WAIT_TEMPLATE as CONF_WAIT_TEMPLATE, CONF_WHILE as CONF_WHILE, ENTITY_MATCH_ALL as ENTITY_MATCH_ALL, ENTITY_MATCH_ANY as ENTITY_MATCH_ANY, ENTITY_MATCH_NONE as ENTITY_MATCH_NONE, SUN_EVENT_SUNRISE as SUN_EVENT_SUNRISE, SUN_EVENT_SUNSET as SUN_EVENT_SUNSET, UnitOfTemperature as UnitOfTemperature, WEEKDAYS as WEEKDAYS
+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_ABOVE as CONF_ABOVE, CONF_ACTION as CONF_ACTION, CONF_ALIAS as CONF_ALIAS, CONF_ATTRIBUTE as CONF_ATTRIBUTE, CONF_BELOW as CONF_BELOW, CONF_CHOOSE as CONF_CHOOSE, CONF_CONDITION as CONF_CONDITION, CONF_CONDITIONS as CONF_CONDITIONS, CONF_CONTINUE_ON_ERROR as CONF_CONTINUE_ON_ERROR, CONF_CONTINUE_ON_TIMEOUT as CONF_CONTINUE_ON_TIMEOUT, CONF_COUNT as CONF_COUNT, CONF_DEFAULT as CONF_DEFAULT, CONF_DELAY as CONF_DELAY, CONF_DEVICE_ID as CONF_DEVICE_ID, CONF_DOMAIN as CONF_DOMAIN, CONF_ELSE as CONF_ELSE, CONF_ENABLED as CONF_ENABLED, CONF_ENTITY_ID as CONF_ENTITY_ID, CONF_ENTITY_NAMESPACE as CONF_ENTITY_NAMESPACE, CONF_ERROR as CONF_ERROR, CONF_EVENT as CONF_EVENT, CONF_EVENT_DATA as CONF_EVENT_DATA, CONF_EVENT_DATA_TEMPLATE as CONF_EVENT_DATA_TEMPLATE, CONF_FOR as CONF_FOR, CONF_FOR_EACH as CONF_FOR_EACH, CONF_ID as CONF_ID, CONF_IF as CONF_IF, CONF_MATCH as CONF_MATCH, CONF_PARALLEL as CONF_PARALLEL, CONF_PLATFORM as CONF_PLATFORM, CONF_REPEAT as CONF_REPEAT, CONF_RESPONSE_VARIABLE as CONF_RESPONSE_VARIABLE, CONF_SCAN_INTERVAL as CONF_SCAN_INTERVAL, CONF_SCENE as CONF_SCENE, CONF_SEQUENCE as CONF_SEQUENCE, CONF_SERVICE as CONF_SERVICE, CONF_SERVICE_DATA as CONF_SERVICE_DATA, CONF_SERVICE_DATA_TEMPLATE as CONF_SERVICE_DATA_TEMPLATE, CONF_SERVICE_TEMPLATE as CONF_SERVICE_TEMPLATE, CONF_SET_CONVERSATION_RESPONSE as CONF_SET_CONVERSATION_RESPONSE, CONF_STATE as CONF_STATE, CONF_STOP as CONF_STOP, CONF_TARGET as CONF_TARGET, CONF_THEN as CONF_THEN, CONF_TIMEOUT as CONF_TIMEOUT, CONF_UNTIL as CONF_UNTIL, CONF_VALUE_TEMPLATE as CONF_VALUE_TEMPLATE, CONF_VARIABLES as CONF_VARIABLES, CONF_WAIT_FOR_TRIGGER as CONF_WAIT_FOR_TRIGGER, CONF_WAIT_TEMPLATE as CONF_WAIT_TEMPLATE, CONF_WHILE as CONF_WHILE, ENTITY_MATCH_ALL as ENTITY_MATCH_ALL, ENTITY_MATCH_ANY as ENTITY_MATCH_ANY, ENTITY_MATCH_NONE as ENTITY_MATCH_NONE, SUN_EVENT_SUNRISE as SUN_EVENT_SUNRISE, SUN_EVENT_SUNSET as SUN_EVENT_SUNSET, UnitOfTemperature as UnitOfTemperature, WEEKDAYS as WEEKDAYS
 from homeassistant.core import async_get_hass as async_get_hass, async_get_hass_or_none as async_get_hass_or_none, split_entity_id as split_entity_id, valid_entity_id as valid_entity_id
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, TemplateError as TemplateError
 from homeassistant.generated import currencies as currencies
@@ -20,9 +20,9 @@ from typing import Any, overload
 TIME_PERIOD_ERROR: str
 
 class UrlProtocolSchema(StrEnum):
-    HTTP: str
-    HTTPS: str
-    HOMEASSISTANT: str
+    HTTP = 'http'
+    HTTPS = 'https'
+    HOMEASSISTANT = 'homeassistant'
 
 EXTERNAL_URL_PROTOCOL_SCHEMA_LIST: Incomplete
 CONFIGURATION_URL_PROTOCOL_SCHEMA_LIST: Incomplete
@@ -138,7 +138,7 @@ def platform_only_config_schema(domain: str) -> Callable[[dict], dict]: ...
 
 PLATFORM_SCHEMA: Incomplete
 PLATFORM_SCHEMA_BASE: Incomplete
-ENTITY_SERVICE_FIELDS: Incomplete
+ENTITY_SERVICE_FIELDS: VolDictType
 TARGET_SERVICE_FIELDS: Incomplete
 _HAS_ENTITY_SERVICE_FIELD: Incomplete
 
@@ -154,8 +154,11 @@ SCRIPT_VARIABLES_SCHEMA: Incomplete
 def script_action(value: Any) -> dict: ...
 
 SCRIPT_SCHEMA: Incomplete
-SCRIPT_ACTION_BASE_SCHEMA: Incomplete
+SCRIPT_ACTION_BASE_SCHEMA: VolDictType
 EVENT_SCHEMA: Incomplete
+
+def _backward_compat_service_schema(value: Any | None) -> Any: ...
+
 SERVICE_SCHEMA: Incomplete
 NUMERIC_STATE_THRESHOLD_SCHEMA: Incomplete
 CONDITION_BASE_SCHEMA: VolDictType

homeassistant-stubs/helpers/data_entry_flow.pyi

@@ -19,6 +19,6 @@ class FlowManagerIndexView(_BaseFlowManagerView[_FlowManagerT]):
     def get_context(self, data: dict[str, Any]) -> dict[str, Any]: ...
 
 class FlowManagerResourceView(_BaseFlowManagerView[_FlowManagerT]):
-    async def get(self, request: web.Request, flow_id: str) -> web.Response: ...
+    async def get(self, request: web.Request, /, flow_id: str) -> web.Response: ...
     async def post(self, request: web.Request, data: dict[str, Any], flow_id: str) -> web.Response: ...
     async def delete(self, request: web.Request, flow_id: str) -> web.Response: ...

homeassistant-stubs/helpers/device_registry.pyi

@@ -8,6 +8,7 @@ from .singleton import singleton as singleton
 from .typing import UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
 from _typeshed import Incomplete
 from collections.abc import Mapping
+from datetime import datetime
 from enum import StrEnum
 from functools import cached_property as cached_property
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
@@ -15,6 +16,7 @@ from homeassistant.const import EVENT_HOMEASSISTANT_STARTED as EVENT_HOMEASSISTA
 from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant, ReleaseChannel as ReleaseChannel, callback as callback, get_release_channel as get_release_channel
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.loader import async_suggest_report_issue as async_suggest_report_issue
+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 homeassistant.util.json import format_unserializable_data as format_unserializable_data
@@ -37,9 +39,9 @@ RUNTIME_ONLY_ATTRS: Incomplete
 CONFIGURATION_URL_SCHEMES: Incomplete
 
 class DeviceEntryDisabler(StrEnum):
-    CONFIG_ENTRY: str
-    INTEGRATION: str
-    USER: str
+    CONFIG_ENTRY = 'config_entry'
+    INTEGRATION = 'integration'
+    USER = 'user'
 
 _DEPRECATED_DISABLED_CONFIG_ENTRY: Incomplete
 _DEPRECATED_DISABLED_INTEGRATION: Incomplete
@@ -48,6 +50,7 @@ _DEPRECATED_DISABLED_USER: Incomplete
 class DeviceInfo(TypedDict, total=False):
     configuration_url: str | URL | None
     connections: set[tuple[str, str]]
+    created_at: str
     default_manufacturer: str
     default_model: str
     default_name: str
@@ -55,6 +58,8 @@ class DeviceInfo(TypedDict, total=False):
     identifiers: set[tuple[str, str]]
     manufacturer: str | None
     model: str | None
+    model_id: str | None
+    modified_at: str
     name: str | None
     serial_number: str | None
     suggested_area: str | None
@@ -76,11 +81,10 @@ class _EventDeviceRegistryUpdatedData_Update(TypedDict):
     action: Literal['update']
     device_id: str
     changes: dict[str, Any]
-
-EventDeviceRegistryUpdatedData: Incomplete
+EventDeviceRegistryUpdatedData = _EventDeviceRegistryUpdatedData_CreateRemove | _EventDeviceRegistryUpdatedData_Update
 
 class DeviceEntryType(StrEnum):
-    SERVICE: str
+    SERVICE = 'service'
 
 class DeviceInfoError(HomeAssistantError):
     device_info: Incomplete
@@ -106,6 +110,7 @@ class DeviceEntry:
     config_entries: set[str]
     configuration_url: str | None
     connections: set[tuple[str, str]]
+    created_at: datetime
     disabled_by: DeviceEntryDisabler | None
     entry_type: DeviceEntryType | None
     hw_version: str | None
@@ -114,6 +119,8 @@ class DeviceEntry:
     labels: set[str]
     manufacturer: str | None
     model: str | None
+    model_id: str | None
+    modified_at: datetime
     name_by_user: str | None
     name: str | None
     primary_config_entry: str | None
@@ -130,7 +137,7 @@ class DeviceEntry:
     def json_repr(self) -> bytes | None: ...
     @cached_property
     def as_storage_fragment(self) -> json_fragment: ...
-    def __init__(self, area_id, config_entries, configuration_url, connections, disabled_by, entry_type, hw_version, id, identifiers, labels, manufacturer, model, name_by_user, name, primary_config_entry, serial_number, suggested_area, sw_version, via_device_id, is_new) -> None: ...
+    def __init__(self, area_id, config_entries, configuration_url, connections, created_at, disabled_by, entry_type, hw_version, id, identifiers, labels, manufacturer, model, model_id, modified_at, name_by_user, name, primary_config_entry, serial_number, suggested_area, sw_version, via_device_id, is_new) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...
@@ -142,10 +149,12 @@ class DeletedDeviceEntry:
     identifiers: set[tuple[str, str]]
     id: str
     orphaned_timestamp: float | None
+    created_at: datetime
+    modified_at: datetime
     def to_device_entry(self, config_entry_id: str, connections: set[tuple[str, str]], identifiers: set[tuple[str, str]]) -> DeviceEntry: ...
     @cached_property
     def as_storage_fragment(self) -> json_fragment: ...
-    def __init__(self, config_entries, connections, identifiers, id, orphaned_timestamp) -> None: ...
+    def __init__(self, config_entries, connections, identifiers, id, orphaned_timestamp, created_at, modified_at) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...
@@ -186,8 +195,8 @@ class DeviceRegistry(BaseRegistry[dict[str, list[dict[str, Any]]]]):
     def async_get_device(self, identifiers: set[tuple[str, str]] | None = None, connections: set[tuple[str, str]] | None = None) -> DeviceEntry | None: ...
     def _async_get_deleted_device(self, identifiers: set[tuple[str, str]], connections: set[tuple[str, str]]) -> DeletedDeviceEntry | None: ...
     def _substitute_name_placeholders(self, domain: str, name: str, translation_placeholders: Mapping[str, str]) -> str: ...
-    def async_get_or_create(self, *, config_entry_id: str, configuration_url: str | URL | None | UndefinedType = ..., connections: set[tuple[str, str]] | None | UndefinedType = ..., 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 = ..., name: str | None | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., translation_key: str | None = None, translation_placeholders: Mapping[str, str] | None = None, via_device: tuple[str, str] | None | UndefinedType = ...) -> DeviceEntry: ...
-    def async_update_device(self, device_id: str, *, add_config_entry: ConfigEntry | UndefinedType = ..., add_config_entry_id: str | UndefinedType = ..., allow_collisions: bool = False, area_id: str | None | UndefinedType = ..., configuration_url: str | URL | None | UndefinedType = ..., device_info_type: str | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., labels: set[str] | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., merge_connections: set[tuple[str, str]] | UndefinedType = ..., merge_identifiers: set[tuple[str, str]] | UndefinedType = ..., model: str | None | UndefinedType = ..., name_by_user: str | None | UndefinedType = ..., name: str | None | UndefinedType = ..., new_connections: set[tuple[str, str]] | UndefinedType = ..., new_identifiers: set[tuple[str, str]] | UndefinedType = ..., remove_config_entry_id: str | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., via_device_id: str | None | UndefinedType = ...) -> DeviceEntry | None: ...
+    def async_get_or_create(self, *, config_entry_id: str, configuration_url: str | URL | None | UndefinedType = ..., connections: set[tuple[str, str]] | None | UndefinedType = ..., created_at: str | datetime | UndefinedType = ..., default_manufacturer: str | None | UndefinedType = ..., default_model: str | None | UndefinedType = ..., default_name: str | None | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., identifiers: set[tuple[str, str]] | None | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., model: str | None | UndefinedType = ..., model_id: str | None | UndefinedType = ..., modified_at: str | datetime | UndefinedType = ..., name: str | None | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., translation_key: str | None = None, translation_placeholders: Mapping[str, str] | None = None, via_device: tuple[str, str] | None | UndefinedType = ...) -> DeviceEntry: ...
+    def async_update_device(self, device_id: str, *, add_config_entry: ConfigEntry | UndefinedType = ..., add_config_entry_id: str | UndefinedType = ..., allow_collisions: bool = False, area_id: str | None | UndefinedType = ..., configuration_url: str | URL | None | UndefinedType = ..., device_info_type: str | UndefinedType = ..., disabled_by: DeviceEntryDisabler | None | UndefinedType = ..., entry_type: DeviceEntryType | None | UndefinedType = ..., hw_version: str | None | UndefinedType = ..., labels: set[str] | UndefinedType = ..., manufacturer: str | None | UndefinedType = ..., merge_connections: set[tuple[str, str]] | UndefinedType = ..., merge_identifiers: set[tuple[str, str]] | UndefinedType = ..., model: str | None | UndefinedType = ..., model_id: str | None | UndefinedType = ..., name_by_user: str | None | UndefinedType = ..., name: str | None | UndefinedType = ..., new_connections: set[tuple[str, str]] | UndefinedType = ..., new_identifiers: set[tuple[str, str]] | UndefinedType = ..., remove_config_entry_id: str | UndefinedType = ..., serial_number: str | None | UndefinedType = ..., suggested_area: str | None | UndefinedType = ..., sw_version: str | None | UndefinedType = ..., via_device_id: str | None | UndefinedType = ...) -> DeviceEntry | None: ...
     def _validate_connections(self, device_id: str, connections: set[tuple[str, str]], allow_collisions: bool) -> set[tuple[str, str]]: ...
     def _validate_identifiers(self, device_id: str, identifiers: set[tuple[str, str]], allow_collisions: bool) -> set[tuple[str, str]]: ...
     def async_remove_device(self, device_id: str) -> None: ...

homeassistant-stubs/helpers/entity.pyi

@@ -50,9 +50,9 @@ class StateInfo(TypedDict):
     unrecorded_attributes: frozenset[str]
 
 class EntityPlatformState(Enum):
-    NOT_ADDED: Incomplete
-    ADDED: Incomplete
-    REMOVED: Incomplete
+    NOT_ADDED = ...
+    ADDED = ...
+    REMOVED = ...
 
 _SENTINEL: Incomplete
 
@@ -69,15 +69,14 @@ class EntityDescription(frozen_or_thawed=True, metaclass=FrozenOrThawed):
     translation_key: str | None
     translation_placeholders: Mapping[str, str] | None
     unit_of_measurement: str | None
-    def __init__(self, *, key, device_class, entity_category, entity_registry_enabled_default, entity_registry_visible_default, force_update, icon, has_entity_name, name, translation_key, translation_placeholders, unit_of_measurement) -> None: ...
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=...) -> None: ...
 
 @dataclasses.dataclass(frozen=True, slots=True)
 class CalculatedState:
     state: str
     attributes: dict[str, Any]
     capability_attributes: Mapping[str, Any] | None
-    shadowed_attributes: Mapping[str, Any]
-    def __init__(self, state, attributes, capability_attributes, shadowed_attributes) -> None: ...
+    def __init__(self, state, attributes, capability_attributes) -> None: ...
 
 class CachedProperties(type):
     def __new__(mcs, name: str, bases: tuple[type, ...], namespace: dict[Any, Any], cached_properties: set[str] | None = None, **kwargs: Any) -> Any: ...
@@ -212,7 +211,7 @@ class Entity(cached_properties=CACHED_PROPERTIES_WITH_ATTR_, metaclass=ABCCached
     def _stringify_state(self, available: bool) -> str: ...
     def _friendly_name_internal(self) -> str | None: ...
     def _async_calculate_state(self) -> CalculatedState: ...
-    def __async_calculate_state(self) -> tuple[str, dict[str, Any], Mapping[str, Any] | None, Mapping[str, Any]]: ...
+    def __async_calculate_state(self) -> tuple[str, dict[str, Any], Mapping[str, Any] | None, str | None, int | None]: ...
     def _async_write_ha_state(self) -> None: ...
     def schedule_update_ha_state(self, force_refresh: bool = False) -> None: ...
     def async_schedule_update_ha_state(self, force_refresh: bool = False) -> None: ...
@@ -242,7 +241,7 @@ class Entity(cached_properties=CACHED_PROPERTIES_WITH_ATTR_, metaclass=ABCCached
     def _report_deprecated_supported_features_values(self, replacement: IntFlag) -> None: ...
 
 class ToggleEntityDescription(EntityDescription, frozen_or_thawed=True):
-    def __init__(self, *, key, device_class, entity_category, entity_registry_enabled_default, entity_registry_visible_default, force_update, icon, has_entity_name, name, translation_key, translation_placeholders, unit_of_measurement) -> None: ...
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=...) -> None: ...
 
 TOGGLE_ENTITY_CACHED_PROPERTIES_WITH_ATTR_: Incomplete
 

homeassistant-stubs/helpers/entity_platform.pyi

@@ -90,7 +90,7 @@ class EntityPlatform:
     async def async_destroy(self) -> None: ...
     async def async_remove_entity(self, entity_id: str) -> None: ...
     async def async_extract_from_service(self, service_call: ServiceCall, expand_group: bool = True) -> list[Entity]: ...
-    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: ...
+    def async_register_entity_service(self, name: str, schema: VolDictType | VolSchemaType, func: str | Callable[..., Any], required_features: Iterable[int] | None = None, supports_response: SupportsResponse = ...) -> None: ...
     async def _async_update_entity_states(self) -> None: ...
 
 current_platform: ContextVar[EntityPlatform | None]

homeassistant-stubs/helpers/entity_registry.pyi

@@ -6,6 +6,7 @@ from .singleton import singleton as singleton
 from .typing import UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable, Container, Hashable, KeysView, Mapping
+from datetime import datetime
 from enum import StrEnum
 from functools import cached_property as cached_property
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
@@ -14,6 +15,7 @@ from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant, c
 from homeassistant.exceptions import MaxLengthExceeded as MaxLengthExceeded
 from homeassistant.loader import async_suggest_report_issue as async_suggest_report_issue
 from homeassistant.util import slugify as slugify
+from homeassistant.util.dt import utc_from_timestamp as utc_from_timestamp, utcnow as utcnow
 from homeassistant.util.event_type import EventType as EventType
 from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.json import format_unserializable_data as format_unserializable_data
@@ -33,15 +35,15 @@ ENTITY_CATEGORY_INDEX_TO_VALUE: Incomplete
 ENTITY_DESCRIBING_ATTRIBUTES: Incomplete
 
 class RegistryEntryDisabler(StrEnum):
-    CONFIG_ENTRY: str
-    DEVICE: str
-    HASS: str
-    INTEGRATION: str
-    USER: str
+    CONFIG_ENTRY = 'config_entry'
+    DEVICE = 'device'
+    HASS = 'hass'
+    INTEGRATION = 'integration'
+    USER = 'user'
 
 class RegistryEntryHider(StrEnum):
-    INTEGRATION: str
-    USER: str
+    INTEGRATION = 'integration'
+    USER = 'user'
 
 class _EventEntityRegistryUpdatedData_CreateRemove(TypedDict):
     action: Literal['create', 'remove']
@@ -52,8 +54,7 @@ class _EventEntityRegistryUpdatedData_Update(TypedDict):
     entity_id: str
     changes: dict[str, Any]
     old_entity_id: NotRequired[str]
-
-EventEntityRegistryUpdatedData: Incomplete
+EventEntityRegistryUpdatedData = _EventEntityRegistryUpdatedData_CreateRemove | _EventEntityRegistryUpdatedData_Update
 EntityOptionsType = Mapping[str, Mapping[str, Any]]
 ReadOnlyEntityOptionsType = ReadOnlyDict[str, ReadOnlyDict[str, Any]]
 DISPLAY_DICT_OPTIONAL: Incomplete
@@ -70,6 +71,7 @@ class RegistryEntry:
     categories: dict[str, str]
     capabilities: Mapping[str, Any] | None
     config_entry_id: str | None
+    created_at: datetime
     device_class: str | None
     device_id: str | None
     domain: str
@@ -80,6 +82,7 @@ class RegistryEntry:
     id: str
     has_entity_name: bool
     labels: set[str]
+    modified_at: datetime
     name: str | None
     options: ReadOnlyEntityOptionsType
     original_device_class: str | None
@@ -106,7 +109,7 @@ class RegistryEntry:
     @cached_property
     def as_storage_fragment(self) -> json_fragment: ...
     def write_unavailable_state(self, hass: HomeAssistant) -> None: ...
-    def __init__(self, entity_id, unique_id, platform, previous_unique_id, aliases, area_id, categories, capabilities, config_entry_id, device_class, device_id, domain, disabled_by, entity_category, hidden_by, icon, id, has_entity_name, labels, name, options, original_device_class, original_icon, original_name, supported_features, translation_key, unit_of_measurement) -> None: ...
+    def __init__(self, entity_id, unique_id, platform, previous_unique_id, aliases, area_id, categories, capabilities, config_entry_id, created_at, device_class, device_id, domain, disabled_by, entity_category, hidden_by, icon, id, has_entity_name, labels, modified_at, name, options, original_device_class, original_icon, original_name, supported_features, translation_key, unit_of_measurement) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...
@@ -120,10 +123,12 @@ class DeletedRegistryEntry:
     domain: str
     id: str
     orphaned_timestamp: float | None
+    created_at: datetime
+    modified_at: datetime
     def _domain_default(self) -> str: ...
     @cached_property
     def as_storage_fragment(self) -> json_fragment: ...
-    def __init__(self, entity_id, unique_id, platform, config_entry_id, domain, id, orphaned_timestamp) -> None: ...
+    def __init__(self, entity_id, unique_id, platform, config_entry_id, domain, id, orphaned_timestamp, created_at, modified_at) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...

homeassistant-stubs/helpers/event.pyi

@@ -62,7 +62,7 @@ class TrackTemplate:
     template: Template
     variables: TemplateVarsType
     rate_limit: float | None = ...
-    def __init__(self, template, variables, rate_limit) -> None: ...
+    def __init__(self, template, variables, rate_limit=...) -> None: ...
 
 @dataclass(slots=True)
 class TrackTemplateResult:
@@ -77,6 +77,7 @@ def async_track_state_change(hass: HomeAssistant, entity_ids: str | Iterable[str
 track_state_change: Incomplete
 
 def async_track_state_change_event(hass: HomeAssistant, entity_ids: str | Iterable[str], action: Callable[[Event[EventStateChangedData]], Any], job_type: HassJobType | None = None) -> CALLBACK_TYPE: ...
+def _async_dispatch_entity_id_event_soon(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[_StateEventDataT]], Any]]], event: Event[_StateEventDataT]) -> None: ...
 def _async_dispatch_entity_id_event(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[_StateEventDataT]], Any]]], event: Event[_StateEventDataT]) -> None: ...
 def _async_state_filter(hass: HomeAssistant, callbacks: dict[str, list[HassJob[[Event[_StateEventDataT]], Any]]], event_data: _StateEventDataT) -> bool: ...
 
@@ -163,8 +164,7 @@ class TrackTemplateResultInfo:
     def _super_template_as_boolean(result: bool | str | TemplateError) -> bool: ...
     def _apply_update(self, updates: list[TrackTemplateResult], update: bool | TrackTemplateResult, template: Template) -> bool: ...
     def _refresh(self, event: Event[EventStateChangedData] | None, track_templates: Iterable[TrackTemplate] | None = None, replayed: bool | None = False) -> None: ...
-
-TrackTemplateResultListener: Incomplete
+TrackTemplateResultListener = Callable[[Event[EventStateChangedData] | None, list[TrackTemplateResult]], Coroutine[Any, Any, None] | None]
 
 def async_track_template_result(hass: HomeAssistant, track_templates: Sequence[TrackTemplate], action: TrackTemplateResultListener, strict: bool = False, log_fn: Callable[[int, str], None] | None = None, has_super_template: bool = False) -> TrackTemplateResultInfo: ...
 def async_track_same_state(hass: HomeAssistant, period: timedelta, action: Callable[[], Coroutine[Any, Any, None] | None], async_check_same_func: Callable[[str, State | None, State | None], bool], entity_ids: str | Iterable[str] = ...) -> CALLBACK_TYPE: ...
@@ -185,7 +185,7 @@ class _TrackPointUTCTime:
     def async_attach(self) -> None: ...
     def __call__(self) -> None: ...
     def async_cancel(self) -> None: ...
-    def __init__(self, hass, job, utc_point_in_time, expected_fire_timestamp, _cancel_callback) -> None: ...
+    def __init__(self, hass, job, utc_point_in_time, expected_fire_timestamp, _cancel_callback=...) -> None: ...
 
 def async_track_point_in_utc_time(hass: HomeAssistant, action: HassJob[[datetime], Coroutine[Any, Any, None] | None] | Callable[[datetime], Coroutine[Any, Any, None] | None], point_in_time: datetime) -> CALLBACK_TYPE: ...
 
@@ -211,7 +211,7 @@ class _TrackTimeInterval:
     def _schedule_timer(self) -> None: ...
     def _interval_listener(self, _: Any) -> None: ...
     def async_cancel(self) -> None: ...
-    def __init__(self, hass, seconds, job_name, action, cancel_on_shutdown, _track_job, _run_job, _timer_handle) -> None: ...
+    def __init__(self, hass, seconds, job_name, action, cancel_on_shutdown, _track_job=..., _run_job=..., _timer_handle=...) -> None: ...
 
 def async_track_time_interval(hass: HomeAssistant, action: Callable[[datetime], Coroutine[Any, Any, None] | None], interval: timedelta, *, name: str | None = None, cancel_on_shutdown: bool | None = None) -> CALLBACK_TYPE: ...
 
@@ -230,7 +230,7 @@ class SunListener:
     def _listen_next_sun_event(self) -> None: ...
     def _handle_sun_event(self, _now: Any) -> None: ...
     def _handle_config_event(self, _event: Any) -> None: ...
-    def __init__(self, hass, job, event, offset, _unsub_sun, _unsub_config) -> None: ...
+    def __init__(self, hass, job, event, offset, _unsub_sun=..., _unsub_config=...) -> None: ...
 
 def async_track_sunrise(hass: HomeAssistant, action: Callable[[], None], offset: timedelta | None = None) -> CALLBACK_TYPE: ...
 
@@ -256,7 +256,7 @@ class _TrackUTCTimeChange:
     def _calculate_next(self, utc_now: datetime) -> datetime: ...
     def _pattern_time_change_listener(self, _: datetime) -> None: ...
     def async_cancel(self) -> None: ...
-    def __init__(self, hass, time_match_expression, microsecond, local, job, listener_job_name, _pattern_time_change_listener_job, _cancel_callback) -> None: ...
+    def __init__(self, hass, time_match_expression, microsecond, local, job, listener_job_name, _pattern_time_change_listener_job=..., _cancel_callback=...) -> None: ...
 
 def async_track_utc_time_change(hass: HomeAssistant, action: Callable[[datetime], Coroutine[Any, Any, None] | None], hour: Any | None = None, minute: Any | None = None, second: Any | None = None, local: bool = False) -> CALLBACK_TYPE: ...
 

homeassistant-stubs/helpers/floor_registry.pyi

@@ -8,14 +8,16 @@ from collections.abc import Iterable
 from dataclasses import dataclass
 from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.util import slugify as slugify
+from homeassistant.util.dt import utc_from_timestamp as utc_from_timestamp, utcnow as utcnow
 from homeassistant.util.event_type import EventType as EventType
 from homeassistant.util.hass_dict import HassKey as HassKey
-from typing import Literal, TypedDict
+from typing import Any, Literal, TypedDict
 
 DATA_REGISTRY: HassKey[FloorRegistry]
 EVENT_FLOOR_REGISTRY_UPDATED: EventType[EventFloorRegistryUpdatedData]
 STORAGE_KEY: str
 STORAGE_VERSION_MAJOR: int
+STORAGE_VERSION_MINOR: int
 
 class _FloorStoreData(TypedDict):
     aliases: list[str]
@@ -23,6 +25,8 @@ class _FloorStoreData(TypedDict):
     icon: str | None
     level: int | None
     name: str
+    created_at: str
+    modified_at: str
 
 class FloorRegistryStoreData(TypedDict):
     floors: list[_FloorStoreData]
@@ -38,7 +42,10 @@ class FloorEntry(NormalizedNameBaseRegistryEntry):
     floor_id: str
     icon: str | None = ...
     level: int | None = ...
-    def __init__(self, *, name, normalized_name, aliases, floor_id, icon, level) -> None: ...
+    def __init__(self, *, name, normalized_name, created_at=..., modified_at=..., aliases, floor_id, icon=..., level=...) -> None: ...
+
+class FloorRegistryStore(Store[FloorRegistryStoreData]):
+    async def _async_migrate_func(self, old_major_version: int, old_minor_version: int, old_data: dict[str, list[dict[str, Any]]]) -> FloorRegistryStoreData: ...
 
 class FloorRegistry(BaseRegistry[FloorRegistryStoreData]):
     floors: NormalizedNameBaseRegistryItems[FloorEntry]

homeassistant-stubs/helpers/http.pyi

@@ -3,6 +3,7 @@ from _typeshed import Incomplete
 from aiohttp import web
 from aiohttp.typedefs import LooseHeaders as LooseHeaders
 from aiohttp.web import AppKey, Request as Request
+from aiohttp.web_urldispatcher import AbstractResource, AbstractRoute
 from collections.abc import Awaitable, Callable
 from contextvars import ContextVar
 from homeassistant import exceptions as exceptions
@@ -13,7 +14,7 @@ from http import HTTPStatus
 from typing import Any, Final
 
 _LOGGER: Incomplete
-AllowCorsType: Incomplete
+AllowCorsType = Callable[[AbstractRoute | AbstractResource], None]
 KEY_AUTHENTICATED: Final[str]
 KEY_ALLOW_ALL_CORS: Incomplete
 KEY_ALLOW_CONFIGURED_CORS: Incomplete