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

homeassistant-stubs/helpers/entity.pyi

@@ -12,10 +12,9 @@ from abc import ABCMeta
 from collections import deque
 from collections.abc import Callable as Callable, Coroutine, Iterable, Mapping
 from enum import Enum, IntFlag
-from functools import cached_property as cached_property
-from homeassistant.config import DATA_CUSTOMIZE as DATA_CUSTOMIZE
 from homeassistant.const import ATTR_ASSUMED_STATE as ATTR_ASSUMED_STATE, ATTR_ATTRIBUTION as ATTR_ATTRIBUTION, ATTR_DEVICE_CLASS as ATTR_DEVICE_CLASS, ATTR_ENTITY_PICTURE as ATTR_ENTITY_PICTURE, ATTR_FRIENDLY_NAME as ATTR_FRIENDLY_NAME, ATTR_ICON as ATTR_ICON, ATTR_SUPPORTED_FEATURES as ATTR_SUPPORTED_FEATURES, ATTR_UNIT_OF_MEASUREMENT as ATTR_UNIT_OF_MEASUREMENT, DEVICE_DEFAULT_NAME as DEVICE_DEFAULT_NAME, EntityCategory as EntityCategory, STATE_OFF as STATE_OFF, STATE_ON as STATE_ON, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN
 from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Context as Context, Event as Event, HassJobType as HassJobType, HomeAssistant as HomeAssistant, ReleaseChannel as ReleaseChannel, callback as callback, get_hassjob_callable_job_type as get_hassjob_callable_job_type, get_release_channel as get_release_channel
+from homeassistant.core_config import DATA_CUSTOMIZE as DATA_CUSTOMIZE
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, InvalidStateError as InvalidStateError, NoEntitySpecifiedError as NoEntitySpecifiedError
 from homeassistant.loader import async_suggest_report_issue as async_suggest_report_issue, bind_hass as bind_hass
 from homeassistant.util import ensure_unique_string as ensure_unique_string, slugify as slugify
@@ -141,66 +140,39 @@ class Entity(cached_properties=CACHED_PROPERTIES_WITH_ATTR_, metaclass=ABCCached
     _attr_unit_of_measurement: str | None
     def __init_subclass__(cls, **kwargs: Any) -> None: ...
     def get_hassjob_type(self, function_name: str) -> HassJobType: ...
-    @cached_property
     def should_poll(self) -> bool: ...
-    @cached_property
     def unique_id(self) -> str | None: ...
-    @cached_property
     def use_device_name(self) -> bool: ...
-    @cached_property
     def has_entity_name(self) -> bool: ...
     def _device_class_name_helper(self, component_translations: dict[str, str]) -> str | None: ...
-    @cached_property
     def _object_id_device_class_name(self) -> str | None: ...
-    @cached_property
     def _device_class_name(self) -> str | None: ...
     def _default_to_device_class_name(self) -> bool: ...
-    @cached_property
     def _name_translation_key(self) -> str | None: ...
     def _substitute_name_placeholders(self, name: str) -> str: ...
     def _name_internal(self, device_class_name: str | None, platform_translations: dict[str, str]) -> str | UndefinedType | None: ...
     @property
     def suggested_object_id(self) -> str | None: ...
-    @cached_property
     def name(self) -> str | UndefinedType | None: ...
-    @cached_property
     def state(self) -> StateType: ...
-    @cached_property
     def capability_attributes(self) -> dict[str, Any] | None: ...
     def get_initial_entity_options(self) -> er.EntityOptionsType | None: ...
-    @cached_property
     def state_attributes(self) -> dict[str, Any] | None: ...
-    @cached_property
     def extra_state_attributes(self) -> Mapping[str, Any] | None: ...
-    @cached_property
     def device_info(self) -> DeviceInfo | None: ...
-    @cached_property
     def device_class(self) -> str | None: ...
-    @cached_property
     def unit_of_measurement(self) -> str | None: ...
-    @cached_property
     def icon(self) -> str | None: ...
-    @cached_property
     def entity_picture(self) -> str | None: ...
-    @cached_property
     def available(self) -> bool: ...
-    @cached_property
     def assumed_state(self) -> bool: ...
-    @cached_property
     def force_update(self) -> bool: ...
-    @cached_property
     def supported_features(self) -> int | None: ...
-    @cached_property
     def entity_registry_enabled_default(self) -> bool: ...
-    @cached_property
     def entity_registry_visible_default(self) -> bool: ...
-    @cached_property
     def attribution(self) -> str | None: ...
-    @cached_property
     def entity_category(self) -> EntityCategory | None: ...
-    @cached_property
     def translation_key(self) -> str | None: ...
-    @cached_property
     def translation_placeholders(self) -> Mapping[str, str]: ...
     @property
     def enabled(self) -> bool: ...
@@ -237,7 +209,7 @@ class Entity(cached_properties=CACHED_PROPERTIES_WITH_ATTR_, metaclass=ABCCached
     def _async_device_registry_updated(self, event: Event[EventDeviceRegistryUpdatedData]) -> None: ...
     def _async_subscribe_device_updates(self) -> None: ...
     def __repr__(self) -> str: ...
-    async def async_request_call(self, coro: Coroutine[Any, Any, _T]) -> _T: ...
+    async def async_request_call[_T](self, coro: Coroutine[Any, Any, _T]) -> _T: ...
     def _suggest_report_issue(self) -> str: ...
     def _report_deprecated_supported_features_values(self, replacement: IntFlag) -> None: ...
 
@@ -253,7 +225,6 @@ class ToggleEntity(Entity, cached_properties=TOGGLE_ENTITY_CACHED_PROPERTIES_WIT
     _attr_state: None
     @property
     def state(self) -> Literal['on', 'off'] | None: ...
-    @cached_property
     def is_on(self) -> bool | None: ...
     def turn_on(self, **kwargs: Any) -> None: ...
     async def async_turn_on(self, **kwargs: Any) -> None: ...

homeassistant-stubs/helpers/entity_registry.pyi

@@ -8,7 +8,6 @@ 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
 from homeassistant.const import ATTR_DEVICE_CLASS as ATTR_DEVICE_CLASS, ATTR_FRIENDLY_NAME as ATTR_FRIENDLY_NAME, ATTR_ICON as ATTR_ICON, ATTR_RESTORED as ATTR_RESTORED, ATTR_SUPPORTED_FEATURES as ATTR_SUPPORTED_FEATURES, ATTR_UNIT_OF_MEASUREMENT as ATTR_UNIT_OF_MEASUREMENT, EVENT_HOMEASSISTANT_START as EVENT_HOMEASSISTANT_START, EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP, EntityCategory as EntityCategory, MAX_LENGTH_STATE_DOMAIN as MAX_LENGTH_STATE_DOMAIN, MAX_LENGTH_STATE_ENTITY_ID as MAX_LENGTH_STATE_ENTITY_ID, Platform as Platform, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN
 from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant, callback as callback, split_entity_id as split_entity_id, valid_entity_id as valid_entity_id
@@ -54,6 +53,9 @@ class _EventEntityRegistryUpdatedData_Update(TypedDict):
     entity_id: str
     changes: dict[str, Any]
     old_entity_id: NotRequired[str]
+type EventEntityRegistryUpdatedData = _EventEntityRegistryUpdatedData_CreateRemove | _EventEntityRegistryUpdatedData_Update
+type EntityOptionsType = Mapping[str, Mapping[str, Any]]
+type ReadOnlyEntityOptionsType = ReadOnlyDict[str, ReadOnlyDict[str, Any]]
 
 DISPLAY_DICT_OPTIONAL: Incomplete
 
@@ -89,6 +91,7 @@ class RegistryEntry:
     supported_features: int
     translation_key: str | None
     unit_of_measurement: str | None
+    _cache: dict[str, Any]
     def _domain_default(self) -> str: ...
     @property
     def disabled(self) -> bool: ...
@@ -96,18 +99,13 @@ class RegistryEntry:
     def hidden(self) -> bool: ...
     @property
     def _as_display_dict(self) -> dict[str, Any] | None: ...
-    @cached_property
     def display_json_repr(self) -> bytes | None: ...
-    @cached_property
     def as_partial_dict(self) -> dict[str, Any]: ...
-    @cached_property
     def extended_dict(self) -> dict[str, Any]: ...
-    @cached_property
     def partial_json_repr(self) -> bytes | None: ...
-    @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, 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 __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, cache) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...
@@ -123,10 +121,10 @@ class DeletedRegistryEntry:
     orphaned_timestamp: float | None
     created_at: datetime
     modified_at: datetime
+    _cache: dict[str, Any]
     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, created_at, modified_at) -> None: ...
+    def __init__(self, entity_id, unique_id, platform, config_entry_id, domain, id, orphaned_timestamp, created_at, modified_at, cache) -> None: ...
     def __lt__(self, other): ...
     def __le__(self, other): ...
     def __gt__(self, other): ...

homeassistant-stubs/helpers/event.pyi

@@ -71,7 +71,7 @@ class TrackTemplateResult:
     result: Any
     def __init__(self, template, last_result, result) -> None: ...
 
-def threaded_listener_factory(async_factory: Callable[Concatenate[HomeAssistant, _P], Any]) -> Callable[Concatenate[HomeAssistant, _P], CALLBACK_TYPE]: ...
+def threaded_listener_factory[**_P](async_factory: Callable[Concatenate[HomeAssistant, _P], Any]) -> Callable[Concatenate[HomeAssistant, _P], CALLBACK_TYPE]: ...
 def async_track_state_change(hass: HomeAssistant, entity_ids: str | Iterable[str], action: Callable[[str, State | None, State | None], Coroutine[Any, Any, None] | None], from_state: str | Iterable[str] | None = None, to_state: str | Iterable[str] | None = None) -> CALLBACK_TYPE: ...
 
 track_state_change: Incomplete
@@ -164,6 +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: ...
+type 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: ...

homeassistant-stubs/helpers/floor_registry.pyi

@@ -1,4 +1,4 @@
-from .normalized_name_base_registry import NormalizedNameBaseRegistryEntry as NormalizedNameBaseRegistryEntry, NormalizedNameBaseRegistryItems as NormalizedNameBaseRegistryItems, normalize_name as normalize_name
+from .normalized_name_base_registry import NormalizedNameBaseRegistryEntry as NormalizedNameBaseRegistryEntry, NormalizedNameBaseRegistryItems as NormalizedNameBaseRegistryItems
 from .registry import BaseRegistry as BaseRegistry
 from .singleton import singleton as singleton
 from .storage import Store as Store
@@ -7,7 +7,6 @@ from _typeshed import Incomplete
 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
@@ -34,6 +33,7 @@ class FloorRegistryStoreData(TypedDict):
 class EventFloorRegistryUpdatedData(TypedDict):
     action: Literal['create', 'remove', 'update']
     floor_id: str
+type EventFloorRegistryUpdated = Event[EventFloorRegistryUpdatedData]
 
 @dataclass(slots=True, kw_only=True, frozen=True)
 class FloorEntry(NormalizedNameBaseRegistryEntry):
@@ -41,7 +41,7 @@ class FloorEntry(NormalizedNameBaseRegistryEntry):
     floor_id: str
     icon: str | None = ...
     level: int | None = ...
-    def __init__(self, *, name, normalized_name, created_at=..., modified_at=..., aliases, floor_id, icon=..., level=...) -> None: ...
+    def __init__(self, *, 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: ...

homeassistant-stubs/helpers/frame.pyi

@@ -2,7 +2,6 @@ import logging
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from dataclasses import dataclass
-from functools import cached_property as cached_property
 from homeassistant.core import async_get_hass_or_none as async_get_hass_or_none
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.loader import async_suggest_report_issue as async_suggest_report_issue
@@ -18,11 +17,8 @@ class IntegrationFrame:
     module: str | None
     relative_filename: str
     frame: FrameType
-    @cached_property
     def line_number(self) -> int: ...
-    @cached_property
     def filename(self) -> str: ...
-    @cached_property
     def line(self) -> str: ...
     def __init__(self, *, custom_integration, integration, module, relative_filename, frame) -> None: ...
 
@@ -34,5 +30,5 @@ class MissingIntegrationFrame(HomeAssistantError): ...
 
 def report(what: str, *, exclude_integrations: set[str] | None = None, error_if_core: bool = True, error_if_integration: bool = False, level: int = ..., log_custom_component_only: bool = False) -> None: ...
 def _report_integration(what: str, integration_frame: IntegrationFrame, level: int = ..., error: bool = False) -> None: ...
-def warn_use(func: _CallableT, what: str) -> _CallableT: ...
+def warn_use[_CallableT: Callable](func: _CallableT, what: str) -> _CallableT: ...
 def report_non_thread_safe_operation(what: str) -> None: ...

homeassistant-stubs/helpers/hassio.pyi

@@ -0,0 +1,4 @@
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+
+def is_hassio(hass: HomeAssistant) -> bool: ...
+def get_supervisor_ip() -> str | None: ...

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,6 +14,7 @@ from http import HTTPStatus
 from typing import Any, Final
 
 _LOGGER: Incomplete
+type AllowCorsType = Callable[[AbstractRoute | AbstractResource], None]
 KEY_AUTHENTICATED: Final[str]
 KEY_ALLOW_ALL_CORS: Incomplete
 KEY_ALLOW_CONFIGURED_CORS: Incomplete

homeassistant-stubs/helpers/intent.pyi

@@ -5,10 +5,9 @@ from . import area_registry as area_registry, device_registry as device_registry
 from .typing import VolSchemaType as VolSchemaType
 from _typeshed import Incomplete
 from abc import abstractmethod
-from collections.abc import Collection, Iterable
+from collections.abc import Callable, Collection, Iterable
 from dataclasses import dataclass
 from enum import Enum, StrEnum
-from functools import cached_property as cached_property
 from homeassistant.components.homeassistant.exposed_entities import async_should_expose as async_should_expose
 from homeassistant.const import ATTR_DEVICE_CLASS as ATTR_DEVICE_CLASS, ATTR_ENTITY_ID as ATTR_ENTITY_ID, ATTR_SUPPORTED_FEATURES as ATTR_SUPPORTED_FEATURES
 from homeassistant.core import Context as Context, HomeAssistant as HomeAssistant, State as State, callback as callback
@@ -18,6 +17,8 @@ from homeassistant.util.hass_dict import HassKey as HassKey
 from typing import Any
 
 _LOGGER: Incomplete
+type _SlotsType = dict[str, Any]
+type _IntentSlotsType = dict[str | tuple[str, str], VolSchemaType | Callable[[Any], Any]]
 INTENT_TURN_OFF: str
 INTENT_TURN_ON: str
 INTENT_TOGGLE: str
@@ -111,12 +112,13 @@ class NoStatesMatchedError(MatchFailedError):
 @dataclass
 class MatchTargetsCandidate:
     state: State
+    is_exposed: bool
     entity: entity_registry.RegistryEntry | None = ...
     area: area_registry.AreaEntry | None = ...
     floor: floor_registry.FloorEntry | None = ...
     device: device_registry.DeviceEntry | None = ...
     matched_name: str | None = ...
-    def __init__(self, state, entity=..., area=..., floor=..., device=..., matched_name=...) -> None: ...
+    def __init__(self, state, is_exposed, entity=..., area=..., floor=..., device=..., matched_name=...) -> None: ...
 
 def find_areas(name: str, areas: area_registry.AreaRegistry) -> Iterable[area_registry.AreaEntry]: ...
 def find_floors(name: str, floors: floor_registry.FloorRegistry) -> Iterable[floor_registry.FloorEntry]: ...
@@ -137,7 +139,6 @@ class IntentHandler:
     def slot_schema(self) -> dict | None: ...
     def async_can_handle(self, intent_obj: Intent) -> bool: ...
     def async_validate_slots(self, slots: _SlotsType) -> _SlotsType: ...
-    @cached_property
     def _slot_schema(self) -> vol.Schema: ...
     async def async_handle(self, intent_obj: Intent) -> IntentResponse: ...
     def __repr__(self) -> str: ...
@@ -157,7 +158,6 @@ class DynamicServiceIntentHandler(IntentHandler, metaclass=abc.ABCMeta):
     required_slots: Incomplete
     optional_slots: Incomplete
     def __init__(self, intent_type: 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: ...
-    @cached_property
     def slot_schema(self) -> dict: ...
     @abstractmethod
     def get_domain_and_service(self, intent_obj: Intent, state: State) -> tuple[str, str]: ...

homeassistant-stubs/helpers/json.pyi

@@ -29,6 +29,9 @@ def json_bytes_strip_null(data: Any) -> bytes: ...
 json_fragment = orjson.Fragment
 
 def json_dumps(data: Any) -> str: ...
+
+json_bytes_sorted: Incomplete
+
 def json_dumps_sorted(data: Any) -> str: ...
 
 JSON_DUMP: Final[Incomplete]

homeassistant-stubs/helpers/label_registry.pyi

@@ -1,4 +1,4 @@
-from .normalized_name_base_registry import NormalizedNameBaseRegistryEntry as NormalizedNameBaseRegistryEntry, NormalizedNameBaseRegistryItems as NormalizedNameBaseRegistryItems, normalize_name as normalize_name
+from .normalized_name_base_registry import NormalizedNameBaseRegistryEntry as NormalizedNameBaseRegistryEntry, NormalizedNameBaseRegistryItems as NormalizedNameBaseRegistryItems
 from .registry import BaseRegistry as BaseRegistry
 from .singleton import singleton as singleton
 from .storage import Store as Store
@@ -7,7 +7,6 @@ from _typeshed import Incomplete
 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
@@ -34,6 +33,7 @@ class LabelRegistryStoreData(TypedDict):
 class EventLabelRegistryUpdatedData(TypedDict):
     action: Literal['create', 'remove', 'update']
     label_id: str
+type EventLabelRegistryUpdated = Event[EventLabelRegistryUpdatedData]
 
 @dataclass(slots=True, frozen=True, kw_only=True)
 class LabelEntry(NormalizedNameBaseRegistryEntry):
@@ -41,7 +41,7 @@ class LabelEntry(NormalizedNameBaseRegistryEntry):
     description: str | None = ...
     color: str | None = ...
     icon: str | None = ...
-    def __init__(self, *, name, normalized_name, created_at=..., modified_at=..., label_id, description=..., color=..., icon=...) -> None: ...
+    def __init__(self, *, name, created_at=..., modified_at=..., label_id, description=..., color=..., icon=...) -> None: ...
 
 class LabelRegistryStore(Store[LabelRegistryStoreData]):
     async def _async_migrate_func(self, old_major_version: int, old_minor_version: int, old_data: dict[str, list[dict[str, Any]]]) -> LabelRegistryStoreData: ...

homeassistant-stubs/helpers/llm.pyi

@@ -93,11 +93,10 @@ class AssistAPI(API):
 
 def _get_exposed_entities(hass: HomeAssistant, assistant: str) -> dict[str, dict[str, Any]]: ...
 def _selector_serializer(schema: Any) -> Any: ...
+def _get_cached_script_parameters(hass: HomeAssistant, entity_id: str) -> tuple[str | None, vol.Schema]: ...
 
 class ScriptTool(Tool):
     name: Incomplete
     _entity_id: Incomplete
-    parameters: Incomplete
-    description: Incomplete
     def __init__(self, hass: HomeAssistant, script_entity_id: str) -> None: ...
     async def async_call(self, hass: HomeAssistant, tool_input: ToolInput, llm_context: LLMContext) -> JsonObjectType: ...

homeassistant-stubs/helpers/network.pyi

@@ -1,3 +1,4 @@
+from .hassio import is_hassio as is_hassio
 from collections.abc import Callable as Callable
 from homeassistant.components import http as http
 from homeassistant.core import HomeAssistant as HomeAssistant

homeassistant-stubs/helpers/normalized_name_base_registry.pyi

@@ -2,20 +2,23 @@ from .registry import BaseRegistryItems as BaseRegistryItems
 from _typeshed import Incomplete
 from dataclasses import dataclass
 from datetime import datetime
+from homeassistant.util import slugify as slugify
 
 @dataclass(slots=True, frozen=True, kw_only=True)
 class NormalizedNameBaseRegistryEntry:
     name: str
-    normalized_name: str
+    normalized_name: str = ...
     created_at: datetime = ...
     modified_at: datetime = ...
-    def __init__(self, *, name, normalized_name, created_at=..., modified_at=...) -> None: ...
+    def __post_init__(self) -> None: ...
+    def __init__(self, *, name, created_at=..., modified_at=...) -> None: ...
 
 def normalize_name(name: str) -> str: ...
 
-class NormalizedNameBaseRegistryItems(BaseRegistryItems[_VT]):
+class NormalizedNameBaseRegistryItems[_VT: NormalizedNameBaseRegistryEntry](BaseRegistryItems[_VT]):
     _normalized_names: Incomplete
     def __init__(self) -> None: ...
     def _unindex_entry(self, key: str, replacement_entry: _VT | None = None) -> None: ...
     def _index_entry(self, key: str, entry: _VT) -> None: ...
     def get_by_name(self, name: str) -> _VT | None: ...
+    def generate_id_from_name(self, name: str) -> str: ...

homeassistant-stubs/helpers/ratelimit.pyi

@@ -13,4 +13,4 @@ class KeyedRateLimit:
     def async_triggered(self, key: Hashable, now: float | None = None) -> None: ...
     def async_cancel_timer(self, key: Hashable) -> None: ...
     def async_remove(self) -> None: ...
-    def async_schedule_action(self, key: Hashable, rate_limit: float | None, now: float, action: Callable[[Unpack[_Ts]], None], *args: Unpack[_Ts]) -> float | None: ...
+    def async_schedule_action[*_Ts](self, key: Hashable, rate_limit: float | None, now: float, action: Callable[[Unpack[_Ts]], None], *args: Unpack[_Ts]) -> float | None: ...

homeassistant-stubs/helpers/redact.pyi

@@ -6,6 +6,6 @@ REDACTED: str
 
 def partial_redact(x: str | Any, unmasked_prefix: int = 4, unmasked_suffix: int = 4) -> str: ...
 @overload
-def async_redact_data(data: Mapping, to_redact: Iterable[Any] | Mapping[Any, Callable[[_ValueT], _ValueT]]) -> dict: ...
+def async_redact_data[_ValueT](data: Mapping, to_redact: Iterable[Any] | Mapping[Any, Callable[[_ValueT], _ValueT]]) -> dict: ...
 @overload
-def async_redact_data(data: _T, to_redact: Iterable[Any] | Mapping[Any, Callable[[_ValueT], _ValueT]]) -> _T: ...
+def async_redact_data[_T, _ValueT](data: _T, to_redact: Iterable[Any] | Mapping[Any, Callable[[_ValueT], _ValueT]]) -> _T: ...

homeassistant-stubs/helpers/registry.pyi

@@ -1,14 +1,16 @@
 import abc
 from .storage import Store as Store
 from abc import ABC, abstractmethod
-from collections import UserDict
+from collections import UserDict, defaultdict
 from collections.abc import Mapping as Mapping, Sequence as Sequence, ValuesView
 from homeassistant.core import CoreState as CoreState, HomeAssistant as HomeAssistant, callback as callback
+from typing import Any, Literal
 
 SAVE_DELAY: int
 SAVE_DELAY_LONG: int
+type RegistryIndexType = defaultdict[str, dict[str, Literal[True]]]
 
-class BaseRegistryItems(UserDict[str, _DataT], ABC, metaclass=abc.ABCMeta):
+class BaseRegistryItems[_DataT](UserDict[str, _DataT], ABC, metaclass=abc.ABCMeta):
     data: dict[str, _DataT]
     def values(self) -> ValuesView[_DataT]: ...
     @abstractmethod
@@ -19,7 +21,7 @@ class BaseRegistryItems(UserDict[str, _DataT], ABC, metaclass=abc.ABCMeta):
     def _unindex_entry_value(self, key: str, value: str, index: RegistryIndexType) -> None: ...
     def __delitem__(self, key: str) -> None: ...
 
-class BaseRegistry(ABC, metaclass=abc.ABCMeta):
+class BaseRegistry[_StoreDataT: Mapping[str, Any] | Sequence[Any]](ABC, metaclass=abc.ABCMeta):
     hass: HomeAssistant
     _store: Store[_StoreDataT]
     def async_schedule_save(self) -> None: ...

homeassistant-stubs/helpers/script.pyi

@@ -15,7 +15,6 @@ from collections.abc import AsyncGenerator, Callable as Callable, Mapping, Seque
 from contextvars import ContextVar
 from dataclasses import dataclass
 from datetime import datetime, timedelta
-from functools import cached_property as cached_property
 from homeassistant import exceptions as exceptions
 from homeassistant.components import scene as scene
 from homeassistant.components.logger import LOGSEVERITY as LOGSEVERITY
@@ -26,6 +25,7 @@ from homeassistant.util.async_ import create_eager_task as create_eager_task
 from homeassistant.util.dt import utcnow as utcnow
 from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.signal_type import SignalType as SignalType, SignalTypeFormat as SignalTypeFormat
+from types import MappingProxyType
 from typing import Any, Literal, TypedDict, overload
 
 SCRIPT_MODE_PARALLEL: str
@@ -110,7 +110,7 @@ class _ScriptRun:
     def _get_timeout_seconds_from_action(self) -> float | None: ...
     async def _async_wait_template_step(self) -> None: ...
     def _async_set_remaining_time_var(self, timeout_handle: asyncio.TimerHandle | None) -> None: ...
-    async def _async_run_long_action(self, long_task: asyncio.Task[_T]) -> _T | None: ...
+    async def _async_run_long_action[_T](self, long_task: asyncio.Task[_T]) -> _T | None: ...
     async def _async_call_service_step(self) -> None: ...
     async def _async_device_step(self) -> None: ...
     async def _async_scene_step(self) -> None: ...
@@ -142,6 +142,7 @@ class _QueuedScriptRun(_ScriptRun):
 def _schedule_stop_scripts_after_shutdown(hass: HomeAssistant) -> None: ...
 async def _async_stop_scripts_after_shutdown(hass: HomeAssistant, point_in_time: datetime) -> None: ...
 async def _async_stop_scripts_at_shutdown(hass: HomeAssistant, event: Event) -> None: ...
+type _VarsType = dict[str, Any] | Mapping[str, Any] | MappingProxyType[str, Any]
 def _referenced_extract_ids(data: Any, key: str, found: set[str]) -> None: ...
 
 class _ChooseData(TypedDict):
@@ -203,19 +204,14 @@ class Script:
     def runs(self) -> int: ...
     @property
     def supports_max(self) -> bool: ...
-    @cached_property
     def referenced_labels(self) -> set[str]: ...
-    @cached_property
     def referenced_floors(self) -> set[str]: ...
-    @cached_property
     def referenced_areas(self) -> set[str]: ...
     @staticmethod
     def _find_referenced_target(target: Literal['area_id', 'floor_id', 'label_id'], referenced: set[str], sequence: Sequence[dict[str, Any]]) -> None: ...
-    @cached_property
     def referenced_devices(self) -> set[str]: ...
     @staticmethod
     def _find_referenced_devices(referenced: set[str], sequence: Sequence[dict[str, Any]]) -> None: ...
-    @cached_property
     def referenced_entities(self) -> set[str]: ...
     @staticmethod
     def _find_referenced_entities(referenced: set[str], sequence: Sequence[dict[str, Any]]) -> None: ...

homeassistant-stubs/helpers/selector.pyi

@@ -14,7 +14,7 @@ def _get_selector_class(config: Any) -> type[Selector]: ...
 def selector(config: Any) -> Selector: ...
 def validate_selector(config: Any) -> dict: ...
 
-class Selector:
+class Selector[_T: Mapping[str, Any]]:
     CONFIG_SCHEMA: Callable
     config: _T
     selector_type: str

homeassistant-stubs/helpers/service.pyi

@@ -70,7 +70,7 @@ def call_from_config(hass: HomeAssistant, config: ConfigType, blocking: bool = F
 async def async_call_from_config(hass: HomeAssistant, config: ConfigType, blocking: bool = False, variables: TemplateVarsType = None, validate_config: bool = True, context: Context | None = None) -> None: ...
 def async_prepare_call_from_config(hass: HomeAssistant, config: ConfigType, variables: TemplateVarsType = None, validate_config: bool = False) -> ServiceParams: ...
 def extract_entity_ids(hass: HomeAssistant, service_call: ServiceCall, expand_group: bool = True) -> set[str]: ...
-async def async_extract_entities(hass: HomeAssistant, entities: Iterable[_EntityT], service_call: ServiceCall, expand_group: bool = True) -> list[_EntityT]: ...
+async def async_extract_entities[_EntityT: Entity](hass: HomeAssistant, entities: Iterable[_EntityT], service_call: ServiceCall, expand_group: bool = True) -> list[_EntityT]: ...
 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]]: ...
 def async_extract_referenced_entity_ids(hass: HomeAssistant, service_call: ServiceCall, expand_group: bool = True) -> SelectedEntities: ...
@@ -88,7 +88,7 @@ async def _async_admin_handler(hass: HomeAssistant, service_job: HassJob[[Servic
 def async_register_admin_service(hass: HomeAssistant, domain: str, service: str, service_func: Callable[[ServiceCall], Awaitable[None] | None], schema: VolSchemaType = ...) -> None: ...
 def verify_domain_control(hass: HomeAssistant, domain: str) -> Callable[[Callable[[ServiceCall], Any]], Callable[[ServiceCall], Any]]: ...
 
-class ReloadServiceHelper:
+class ReloadServiceHelper[_T]:
     _service_func: Incomplete
     _service_running: bool
     _service_condition: Incomplete

homeassistant-stubs/helpers/service_info/hassio.pyi

@@ -0,0 +1,11 @@
+from dataclasses import dataclass
+from homeassistant.data_entry_flow import BaseServiceInfo as BaseServiceInfo
+from typing import Any
+
+@dataclass(slots=True)
+class HassioServiceInfo(BaseServiceInfo):
+    config: dict[str, Any]
+    name: str
+    slug: str
+    uuid: str
+    def __init__(self, config, name, slug, uuid) -> None: ...

homeassistant-stubs/helpers/service_info/mqtt.pyi

@@ -1,6 +1,7 @@
 from dataclasses import dataclass
 from homeassistant.data_entry_flow import BaseServiceInfo as BaseServiceInfo
 
+type ReceivePayloadType = str | bytes
 @dataclass(slots=True)
 class MqttServiceInfo(BaseServiceInfo):
     topic: str

homeassistant-stubs/helpers/significant_change.pyi

@@ -4,10 +4,13 @@ from collections.abc import Callable, Mapping
 from homeassistant.const import STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN
 from homeassistant.core import HomeAssistant as HomeAssistant, State as State, callback as callback
 from homeassistant.util.hass_dict import HassKey as HassKey
+from types import MappingProxyType
 from typing import Any, Protocol
 
 PLATFORM: str
 DATA_FUNCTIONS: HassKey[dict[str, CheckTypeFunc]]
+type CheckTypeFunc = Callable[[HomeAssistant, str, dict | MappingProxyType, str, dict | MappingProxyType], bool | None]
+type ExtraCheckTypeFunc = Callable[[HomeAssistant, str, dict | MappingProxyType, Any, str, dict | MappingProxyType, Any], bool | None]
 
 class SignificantChangeProtocol(Protocol):
     def async_check_significant_change(self, hass: HomeAssistant, old_state: str, old_attrs: Mapping[str, Any], new_state: str, new_attrs: Mapping[str, Any]) -> bool | None: ...

homeassistant-stubs/helpers/singleton.pyi

@@ -4,7 +4,8 @@ from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util.hass_dict import HassKey as HassKey
 from typing import overload
 
+type _FuncType[_T] = Callable[[HomeAssistant], _T]
 @overload
-def singleton(data_key: HassKey[_T]) -> Callable[[_FuncType[_T]], _FuncType[_T]]: ...
+def singleton[_T](data_key: HassKey[_T]) -> Callable[[_FuncType[_T]], _FuncType[_T]]: ...
 @overload
-def singleton(data_key: str) -> Callable[[_FuncType[_T]], _FuncType[_T]]: ...
+def singleton[_T](data_key: str) -> Callable[[_FuncType[_T]], _FuncType[_T]]: ...

homeassistant-stubs/helpers/storage.pyi

@@ -1,7 +1,6 @@
 import asyncio
 from _typeshed import Incomplete
-from collections.abc import Callable as Callable, Iterable, Sequence as Sequence
-from functools import cached_property as cached_property
+from collections.abc import Callable as Callable, Iterable, Mapping, Sequence as Sequence
 from homeassistant.const import EVENT_HOMEASSISTANT_FINAL_WRITE as EVENT_HOMEASSISTANT_FINAL_WRITE, EVENT_HOMEASSISTANT_STARTED as EVENT_HOMEASSISTANT_STARTED, EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP
 from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, CoreState as CoreState, Event as Event, HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
@@ -10,6 +9,7 @@ from homeassistant.util import json as json_util
 from homeassistant.util.file import WriteError as WriteError
 from homeassistant.util.hass_dict import HassKey as HassKey
 from json import JSONEncoder
+from typing import Any
 
 MAX_LOAD_CONCURRENTLY: int
 STORAGE_DIR: str
@@ -18,7 +18,7 @@ STORAGE_SEMAPHORE: HassKey[asyncio.Semaphore]
 STORAGE_MANAGER: HassKey[_StoreManager]
 MANAGER_CLEANUP_DELAY: int
 
-async def async_migrator(hass: HomeAssistant, old_path: str, store: Store[_T], *, old_conf_load_func: Callable | None = None, old_conf_migrate_func: Callable | None = None) -> _T | None: ...
+async def async_migrator[_T: Mapping[str, Any] | Sequence[Any]](hass: HomeAssistant, old_path: str, store: Store[_T], *, old_conf_load_func: Callable | None = None, old_conf_migrate_func: Callable | None = None) -> _T | None: ...
 def get_internal_store_manager(hass: HomeAssistant) -> _StoreManager: ...
 
 class _StoreManager:
@@ -39,7 +39,7 @@ class _StoreManager:
     def _preload(self, keys: Iterable[str]) -> None: ...
     def _initialize_files(self) -> None: ...
 
-class Store:
+class Store[_T: Mapping[str, Any] | Sequence[Any]]:
     version: Incomplete
     minor_version: Incomplete
     key: Incomplete
@@ -56,7 +56,6 @@ class Store:
     _next_write_time: float
     _manager: Incomplete
     def __init__(self, hass: HomeAssistant, version: int, key: str, private: bool = False, *, atomic_writes: bool = False, encoder: type[JSONEncoder] | None = None, minor_version: int = 1, read_only: bool = False) -> None: ...
-    @cached_property
     def path(self): ...
     def make_read_only(self) -> None: ...
     async def async_load(self) -> _T | None: ...

homeassistant-stubs/helpers/sun.pyi

@@ -2,6 +2,7 @@ import astral
 import astral.location
 import datetime
 from _typeshed import Incomplete
+from collections.abc import Callable
 from homeassistant.const import SUN_EVENT_SUNRISE as SUN_EVENT_SUNRISE, SUN_EVENT_SUNSET as SUN_EVENT_SUNSET
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.loader import bind_hass as bind_hass
@@ -9,6 +10,7 @@ from homeassistant.util.hass_dict import HassKey as HassKey
 
 DATA_LOCATION_CACHE: HassKey[dict[tuple[str, str, str, float, float], astral.location.Location]]
 ELEVATION_AGNOSTIC_EVENTS: Incomplete
+type _AstralSunEventCallable = Callable[..., datetime.datetime]
 
 def get_astral_location(hass: HomeAssistant) -> tuple[astral.location.Location, astral.Elevation]: ...
 def get_astral_event_next(hass: HomeAssistant, event: str, utc_point_in_time: datetime.datetime | None = None, offset: datetime.timedelta | None = None) -> datetime.datetime: ...

homeassistant-stubs/helpers/system_info.pyi

@@ -1,3 +1,4 @@
+from .hassio import is_hassio as is_hassio
 from .importlib import async_import_module as async_import_module
 from .singleton import singleton as singleton
 from _typeshed import Incomplete