homeassistant-stubs 2025.1.1__py3-none-any.whl → 2025.1.3__py3-none-any.whl

homeassistant-stubs/helpers/integration_platform.pyi

@@ -19,11 +19,13 @@ class IntegrationPlatform:
     platform_name: str
     process_job: HassJob[[HomeAssistant, str, Any], Awaitable[None] | None]
     seen_components: set[str]
-    def __init__(self, platform_name, process_job, seen_components) -> None: ...
 
+@callback
 def _async_integration_platform_component_loaded(hass: HomeAssistant, integration_platforms: list[IntegrationPlatform], event: Event[EventComponentLoaded]) -> None: ...
 async def _async_process_integration_platforms_for_component(hass: HomeAssistant, integration: Integration, platforms_that_exist: list[str], integration_platforms_by_name: dict[str, IntegrationPlatform]) -> None: ...
+@callback
 def _process_integration_platforms(hass: HomeAssistant, integration: Integration, platforms: dict[str, ModuleType], integration_platforms_by_name: dict[str, IntegrationPlatform]) -> list[asyncio.Future[Awaitable[None] | None]]: ...
 def _format_err(name: str, platform_name: str, *args: Any) -> str: ...
+@bind_hass
 async def async_process_integration_platforms(hass: HomeAssistant, platform_name: str, process_platform: Callable[[HomeAssistant, str, Any], Awaitable[None] | None], wait_for_platforms: bool = False) -> None: ...
 async def _async_process_integration_platforms(hass: HomeAssistant, platform_name: str, top_level_components: set[str], process_job: HassJob) -> None: ...

homeassistant-stubs/helpers/intent.pyi

@@ -6,7 +6,7 @@ from .typing import VolSchemaType as VolSchemaType
 from _typeshed import Incomplete
 from abc import abstractmethod
 from collections.abc import Callable, Collection, Iterable
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from enum import Enum, StrEnum
 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
@@ -42,9 +42,15 @@ DATA_KEY: HassKey[dict[str, IntentHandler]]
 SPEECH_TYPE_PLAIN: str
 SPEECH_TYPE_SSML: str
 
+@callback
+@bind_hass
 def async_register(hass: HomeAssistant, handler: IntentHandler) -> None: ...
+@callback
+@bind_hass
 def async_remove(hass: HomeAssistant, intent_type: str) -> None: ...
+@callback
 def async_get(hass: HomeAssistant) -> Iterable[IntentHandler]: ...
+@bind_hass
 async def async_handle(hass: HomeAssistant, platform: str, intent_type: str, slots: _SlotsType | None = None, text_input: str | None = None, context: Context | None = None, language: str | None = None, assistant: str | None = None, device_id: str | None = None, conversation_agent_id: str | None = None) -> IntentResponse: ...
 
 class IntentError(HomeAssistantError): ...
@@ -84,23 +90,20 @@ class MatchTargetsConstraints:
     allow_duplicate_names: bool = ...
     @property
     def has_constraints(self) -> bool: ...
-    def __init__(self, name=..., area_name=..., floor_name=..., domains=..., device_classes=..., features=..., states=..., assistant=..., allow_duplicate_names=...) -> None: ...
 
 @dataclass
 class MatchTargetsPreferences:
     area_id: str | None = ...
     floor_id: str | None = ...
-    def __init__(self, area_id=..., floor_id=...) -> None: ...
 
 @dataclass
 class MatchTargetsResult:
     is_match: bool
     no_match_reason: MatchFailedReason | None = ...
-    states: list[State] = ...
+    states: list[State] = field(default_factory=list)
     no_match_name: str | None = ...
-    areas: list[area_registry.AreaEntry] = ...
-    floors: list[floor_registry.FloorEntry] = ...
-    def __init__(self, is_match, no_match_reason=..., states=..., no_match_name=..., areas=..., floors=...) -> None: ...
+    areas: list[area_registry.AreaEntry] = field(default_factory=list)
+    floors: list[floor_registry.FloorEntry] = field(default_factory=list)
 
 class MatchFailedError(IntentError):
     result: Incomplete
@@ -121,7 +124,6 @@ class MatchTargetsCandidate:
     floor: floor_registry.FloorEntry | None = ...
     device: device_registry.DeviceEntry | None = ...
     matched_name: str | 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]: ...
@@ -130,8 +132,12 @@ def _filter_by_name(name: str, candidates: Iterable[MatchTargetsCandidate]) -> I
 def _filter_by_features(features: int, candidates: Iterable[MatchTargetsCandidate]) -> Iterable[MatchTargetsCandidate]: ...
 def _filter_by_device_classes(device_classes: Iterable[str], candidates: Iterable[MatchTargetsCandidate]) -> Iterable[MatchTargetsCandidate]: ...
 def _add_areas(areas: area_registry.AreaRegistry, devices: device_registry.DeviceRegistry, candidates: Iterable[MatchTargetsCandidate]) -> None: ...
+@callback
 def async_match_targets(hass: HomeAssistant, constraints: MatchTargetsConstraints, preferences: MatchTargetsPreferences | None = None, states: list[State] | None = None) -> MatchTargetsResult: ...
+@callback
+@bind_hass
 def async_match_states(hass: HomeAssistant, name: str | None = None, area_name: str | None = None, floor_name: str | None = None, domains: Collection[str] | None = None, device_classes: Collection[str] | None = None, states: list[State] | None = None, assistant: str | None = None) -> Iterable[State]: ...
+@callback
 def async_test_feature(state: State, feature: int, feature_name: str) -> None: ...
 
 class IntentHandler:
@@ -140,7 +146,9 @@ class IntentHandler:
     description: str | None
     @property
     def slot_schema(self) -> dict | None: ...
+    @callback
     def async_can_handle(self, intent_obj: Intent) -> bool: ...
+    @callback
     def async_validate_slots(self, slots: _SlotsType) -> _SlotsType: ...
     @cached_property
     def _slot_schema(self) -> vol.Schema: ...
@@ -195,6 +203,7 @@ class Intent:
     device_id: Incomplete
     conversation_agent_id: Incomplete
     def __init__(self, hass: HomeAssistant, platform: str, intent_type: str, slots: _SlotsType, text_input: str | None, context: Context, language: str, category: IntentCategory | None = None, assistant: str | None = None, device_id: str | None = None, conversation_agent_id: str | None = None) -> None: ...
+    @callback
     def create_response(self) -> IntentResponse: ...
 
 class IntentResponseType(Enum):
@@ -223,7 +232,6 @@ class IntentResponseTarget:
     name: str
     type: IntentResponseTargetType
     id: str | None = ...
-    def __init__(self, name, type, id=...) -> None: ...
 
 class IntentResponse:
     language: Incomplete
@@ -240,12 +248,21 @@ class IntentResponse:
     speech_slots: dict[str, Any]
     response_type: Incomplete
     def __init__(self, language: str, intent: Intent | None = None) -> None: ...
+    @callback
     def async_set_speech(self, speech: str, speech_type: str = 'plain', extra_data: Any | None = None) -> None: ...
+    @callback
     def async_set_reprompt(self, speech: str, speech_type: str = 'plain', extra_data: Any | None = None) -> None: ...
+    @callback
     def async_set_card(self, title: str, content: str, card_type: str = 'simple') -> None: ...
+    @callback
     def async_set_error(self, code: IntentResponseErrorCode, message: str) -> None: ...
+    @callback
     def async_set_targets(self, intent_targets: list[IntentResponseTarget]) -> None: ...
+    @callback
     def async_set_results(self, success_results: list[IntentResponseTarget], failed_results: list[IntentResponseTarget] | None = None) -> None: ...
+    @callback
     def async_set_states(self, matched_states: list[State], unmatched_states: list[State] | None = None) -> None: ...
+    @callback
     def async_set_speech_slots(self, speech_slots: dict[str, Any]) -> None: ...
+    @callback
     def as_dict(self) -> dict[str, Any]: ...

homeassistant-stubs/helpers/issue_registry.pyi

@@ -44,7 +44,6 @@ class IssueEntry:
     translation_key: str | None
     translation_placeholders: dict[str, str] | None
     def to_json(self) -> dict[str, Any]: ...
-    def __init__(self, active, breaks_in_ha_version, created, data, dismissed_version, domain, is_fixable, is_persistent, issue_domain, issue_id, learn_more_url, severity, translation_key, translation_placeholders) -> None: ...
 
 class IssueRegistryStore(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, Any]) -> dict[str, Any]: ...
@@ -54,18 +53,28 @@ class IssueRegistry(BaseRegistry):
     issues: dict[tuple[str, str], IssueEntry]
     _store: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
+    @callback
     def async_get_issue(self, domain: str, issue_id: str) -> IssueEntry | None: ...
+    @callback
     def async_get_or_create(self, domain: str, issue_id: str, *, breaks_in_ha_version: str | None = None, data: dict[str, str | int | float | None] | None = None, is_fixable: bool, is_persistent: bool, issue_domain: str | None = None, learn_more_url: str | None = None, severity: IssueSeverity, translation_key: str, translation_placeholders: dict[str, str] | None = None) -> IssueEntry: ...
+    @callback
     def async_delete(self, domain: str, issue_id: str) -> None: ...
+    @callback
     def async_ignore(self, domain: str, issue_id: str, ignore: bool) -> IssueEntry: ...
+    @callback
     def make_read_only(self) -> None: ...
     async def async_load(self) -> None: ...
+    @callback
     def _data_to_save(self) -> dict[str, list[dict[str, str | None]]]: ...
 
+@callback
 def async_get(hass: HomeAssistant) -> IssueRegistry: ...
 async def async_load(hass: HomeAssistant, *, read_only: bool = False) -> None: ...
+@callback
 def async_create_issue(hass: HomeAssistant, domain: str, issue_id: str, *, breaks_in_ha_version: str | None = None, data: dict[str, str | int | float | None] | None = None, is_fixable: bool, is_persistent: bool = False, issue_domain: str | None = None, learn_more_url: str | None = None, severity: IssueSeverity, translation_key: str, translation_placeholders: dict[str, str] | None = None) -> None: ...
 def create_issue(hass: HomeAssistant, domain: str, issue_id: str, *, breaks_in_ha_version: str | None = None, data: dict[str, str | int | float | None] | None = None, is_fixable: bool, is_persistent: bool = False, issue_domain: str | None = None, learn_more_url: str | None = None, severity: IssueSeverity, translation_key: str, translation_placeholders: dict[str, str] | None = None) -> None: ...
+@callback
 def async_delete_issue(hass: HomeAssistant, domain: str, issue_id: str) -> None: ...
 def delete_issue(hass: HomeAssistant, domain: str, issue_id: str) -> None: ...
+@callback
 def async_ignore_issue(hass: HomeAssistant, domain: str, issue_id: str, ignore: bool) -> None: ...

homeassistant-stubs/helpers/label_registry.pyi

@@ -41,7 +41,6 @@ class LabelEntry(NormalizedNameBaseRegistryEntry):
     description: str | None = ...
     color: str | None = ...
     icon: str | 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: ...
@@ -52,15 +51,23 @@ class LabelRegistry(BaseRegistry[LabelRegistryStoreData]):
     hass: Incomplete
     _store: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
+    @callback
     def async_get_label(self, label_id: str) -> LabelEntry | None: ...
+    @callback
     def async_get_label_by_name(self, name: str) -> LabelEntry | None: ...
+    @callback
     def async_list_labels(self) -> Iterable[LabelEntry]: ...
     def _generate_id(self, name: str) -> str: ...
+    @callback
     def async_create(self, name: str, *, color: str | None = None, icon: str | None = None, description: str | None = None) -> LabelEntry: ...
+    @callback
     def async_delete(self, label_id: str) -> None: ...
+    @callback
     def async_update(self, label_id: str, *, color: str | None | UndefinedType = ..., description: str | None | UndefinedType = ..., icon: str | None | UndefinedType = ..., name: str | UndefinedType = ...) -> LabelEntry: ...
     async def async_load(self) -> None: ...
+    @callback
     def _data_to_save(self) -> LabelRegistryStoreData: ...
 
+@callback
 def async_get(hass: HomeAssistant) -> LabelRegistry: ...
 async def async_load(hass: HomeAssistant) -> None: ...

homeassistant-stubs/helpers/llm.pyi

@@ -25,10 +25,14 @@ LLM_API_ASSIST: str
 BASE_PROMPT: str
 DEFAULT_INSTRUCTIONS_PROMPT: str
 
+@callback
 def async_render_no_api_prompt(hass: HomeAssistant) -> str: ...
+@callback
 def _async_get_apis(hass: HomeAssistant) -> dict[str, API]: ...
+@callback
 def async_register_api(hass: HomeAssistant, api: API) -> None: ...
 async def async_get_api(hass: HomeAssistant, api_id: str, llm_context: LLMContext) -> APIInstance: ...
+@callback
 def async_get_apis(hass: HomeAssistant) -> list[API]: ...
 
 @dataclass(slots=True)
@@ -39,13 +43,11 @@ class LLMContext:
     language: str | None
     assistant: str | None
     device_id: str | None
-    def __init__(self, platform, context, user_prompt, language, assistant, device_id) -> None: ...
 
 @dataclass(slots=True)
 class ToolInput:
     tool_name: str
     tool_args: dict[str, Any]
-    def __init__(self, tool_name, tool_args) -> None: ...
 
 class Tool(metaclass=abc.ABCMeta):
     name: str
@@ -63,7 +65,6 @@ class APIInstance:
     tools: list[Tool]
     custom_serializer: Callable[[Any], Any] | None = ...
     async def async_call_tool(self, tool_input: ToolInput) -> JsonObjectType: ...
-    def __init__(self, api, api_prompt, llm_context, tools, custom_serializer=...) -> None: ...
 
 @dataclass(slots=True, kw_only=True)
 class API(ABC, metaclass=abc.ABCMeta):
@@ -72,7 +73,6 @@ class API(ABC, metaclass=abc.ABCMeta):
     name: str
     @abstractmethod
     async def async_get_api_instance(self, llm_context: LLMContext) -> APIInstance: ...
-    def __init__(self, *, hass, id, name) -> None: ...
 
 class IntentTool(Tool):
     name: Incomplete
@@ -87,7 +87,9 @@ class AssistAPI(API):
     cached_slugify: Incomplete
     def __init__(self, hass: HomeAssistant) -> None: ...
     async def async_get_api_instance(self, llm_context: LLMContext) -> APIInstance: ...
+    @callback
     def _async_get_api_prompt(self, llm_context: LLMContext, exposed_entities: dict | None) -> str: ...
+    @callback
     def _async_get_tools(self, llm_context: LLMContext, exposed_entities: dict | None) -> list[Tool]: ...
 
 def _get_exposed_entities(hass: HomeAssistant, assistant: str) -> dict[str, dict[str, Any]]: ...

homeassistant-stubs/helpers/network.pyi

@@ -12,12 +12,18 @@ SUPERVISOR_NETWORK_HOST: str
 
 class NoURLAvailableError(HomeAssistantError): ...
 
+@bind_hass
 def is_internal_request(hass: HomeAssistant) -> bool: ...
+@bind_hass
 def get_supervisor_network_url(hass: HomeAssistant, *, allow_ssl: bool = False) -> str | None: ...
 def is_hass_url(hass: HomeAssistant, url: str) -> bool: ...
+@bind_hass
 def get_url(hass: HomeAssistant, *, require_current_request: bool = False, require_ssl: bool = False, require_standard_port: bool = False, require_cloud: bool = False, allow_internal: bool = True, allow_external: bool = True, allow_cloud: bool = True, allow_ip: bool | None = None, prefer_external: bool | None = None, prefer_cloud: bool = False) -> str: ...
 def _get_request_host() -> str | None: ...
+@bind_hass
 def _get_internal_url(hass: HomeAssistant, *, allow_ip: bool = True, require_current_request: bool = False, require_ssl: bool = False, require_standard_port: bool = False) -> str: ...
+@bind_hass
 def _get_external_url(hass: HomeAssistant, *, allow_cloud: bool = True, allow_ip: bool = True, prefer_cloud: bool = False, require_current_request: bool = False, require_ssl: bool = False, require_standard_port: bool = False, require_cloud: bool = False) -> str: ...
+@bind_hass
 def _get_cloud_url(hass: HomeAssistant, require_current_request: bool = False) -> str: ...
 def is_cloud_connection(hass: HomeAssistant) -> bool: ...

homeassistant-stubs/helpers/normalized_name_base_registry.pyi

@@ -1,16 +1,15 @@
 from .registry import BaseRegistryItems as BaseRegistryItems
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from datetime import datetime
-from homeassistant.util import slugify as slugify
+from homeassistant.util import dt as dt_util, slugify as slugify
 
 @dataclass(slots=True, frozen=True, kw_only=True)
 class NormalizedNameBaseRegistryEntry:
     name: str
-    normalized_name: str = ...
-    created_at: datetime = ...
-    modified_at: datetime = ...
+    normalized_name: str = field(init=False)
+    created_at: datetime = field(default_factory=dt_util.utcnow)
+    modified_at: datetime = field(default_factory=dt_util.utcnow)
     def __post_init__(self) -> None: ...
-    def __init__(self, *, name, created_at=..., modified_at=...) -> None: ...
 
 def normalize_name(name: str) -> str: ...
 

homeassistant-stubs/helpers/ratelimit.pyi

@@ -10,8 +10,13 @@ class KeyedRateLimit:
     _last_triggered: dict[Hashable, float]
     _rate_limit_timers: dict[Hashable, asyncio.TimerHandle]
     def __init__(self, hass: HomeAssistant) -> None: ...
+    @callback
     def async_has_timer(self, key: Hashable) -> bool: ...
+    @callback
     def async_triggered(self, key: Hashable, now: float | None = None) -> None: ...
+    @callback
     def async_cancel_timer(self, key: Hashable) -> None: ...
+    @callback
     def async_remove(self) -> None: ...
+    @callback
     def async_schedule_action[*_Ts](self, key: Hashable, rate_limit: float | None, now: float, action: Callable[[*_Ts], None], *args: *_Ts) -> float | None: ...

homeassistant-stubs/helpers/recorder.pyi

@@ -1,7 +1,8 @@
 import asyncio
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable, Generator
-from dataclasses import dataclass
+from contextlib import contextmanager
+from dataclasses import dataclass, field
 from homeassistant.components.recorder import Recorder as Recorder
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.util.hass_dict import HassKey as HassKey
@@ -14,13 +15,16 @@ DATA_INSTANCE: HassKey[Recorder]
 
 @dataclass(slots=True)
 class RecorderData:
-    recorder_platforms: dict[str, Any] = ...
-    db_connected: asyncio.Future[bool] = ...
-    def __init__(self, recorder_platforms=..., db_connected=...) -> None: ...
+    recorder_platforms: dict[str, Any] = field(default_factory=dict)
+    db_connected: asyncio.Future[bool] = field(default_factory=asyncio.Future)
 
+@callback
 def async_migration_in_progress(hass: HomeAssistant) -> bool: ...
+@callback
 def async_migration_is_live(hass: HomeAssistant) -> bool: ...
+@callback
 def async_initialize_recorder(hass: HomeAssistant) -> None: ...
 async def async_wait_recorder(hass: HomeAssistant) -> bool: ...
 def get_instance(hass: HomeAssistant) -> Recorder: ...
+@contextmanager
 def session_scope(*, hass: HomeAssistant | None = None, session: Session | None = None, exception_filter: Callable[[Exception], bool] | None = None, read_only: bool = False) -> Generator[Session]: ...

homeassistant-stubs/helpers/registry.pyi

@@ -24,6 +24,8 @@ class BaseRegistryItems[_DataT](UserDict[str, _DataT], ABC, metaclass=abc.ABCMet
 class BaseRegistry[_StoreDataT: Mapping[str, Any] | Sequence[Any]](ABC, metaclass=abc.ABCMeta):
     hass: HomeAssistant
     _store: Store[_StoreDataT]
+    @callback
     def async_schedule_save(self) -> None: ...
+    @callback
     @abstractmethod
     def _data_to_save(self) -> _StoreDataT: ...

homeassistant-stubs/helpers/reload.pyi

@@ -25,6 +25,7 @@ async def async_integration_yaml_config(hass: HomeAssistant, integration_name: s
 async def async_integration_yaml_config(hass: HomeAssistant, integration_name: str, *, raise_on_failure: Literal[True]) -> ConfigType: ...
 @overload
 async def async_integration_yaml_config(hass: HomeAssistant, integration_name: str, *, raise_on_failure: Literal[False]) -> ConfigType | None: ...
+@callback
 def async_get_platform_without_config_entry(hass: HomeAssistant, integration_name: str, integration_platform_name: str) -> EntityPlatform | None: ...
 async def async_setup_reload_service(hass: HomeAssistant, domain: str, platforms: Iterable[str]) -> None: ...
 def setup_reload_service(hass: HomeAssistant, domain: str, platforms: Iterable[str]) -> None: ...

homeassistant-stubs/helpers/restore_state.pyi

@@ -41,6 +41,7 @@ class StoredState:
     def from_dict(cls, json_dict: dict) -> Self: ...
 
 async def async_load(hass: HomeAssistant) -> None: ...
+@callback
 def async_get(hass: HomeAssistant) -> RestoreStateData: ...
 
 class RestoreStateData:
@@ -53,15 +54,20 @@ class RestoreStateData:
     def __init__(self, hass: HomeAssistant) -> None: ...
     async def async_setup(self) -> None: ...
     async def async_load(self) -> None: ...
+    @callback
     def async_get_stored_states(self) -> list[StoredState]: ...
     async def async_dump_states(self) -> None: ...
+    @callback
     def async_setup_dump(self, *args: Any) -> None: ...
+    @callback
     def async_restore_entity_added(self, entity: RestoreEntity) -> None: ...
+    @callback
     def async_restore_entity_removed(self, entity_id: str, extra_data: ExtraStoredData | None) -> None: ...
 
 class RestoreEntity(Entity):
     async def async_internal_added_to_hass(self) -> None: ...
     async def async_internal_will_remove_from_hass(self) -> None: ...
+    @callback
     def _async_get_restored_data(self) -> StoredState | None: ...
     async def async_get_last_state(self) -> State | None: ...
     async def async_get_last_extra_data(self) -> ExtraStoredData | None: ...

homeassistant-stubs/helpers/schema_config_entry_flow.pyi

@@ -22,12 +22,10 @@ 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 = ...
-    def __init__(self, schema=..., validate_user_input=..., next_step=..., suggested_values=..., preview=...) -> None: ...
 
 @dataclass(slots=True)
 class SchemaFlowMenuStep(SchemaFlowStep):
     options: Container[str]
-    def __init__(self, options) -> None: ...
 
 class SchemaCommonFlowHandler:
     _flow: Incomplete
@@ -59,14 +57,19 @@ class SchemaConfigFlowHandler(ConfigFlow, ABC, metaclass=abc.ABCMeta):
     @staticmethod
     async def async_setup_preview(hass: HomeAssistant) -> None: ...
     @classmethod
+    @callback
     def async_supports_options_flow(cls, config_entry: ConfigEntry) -> bool: ...
     @staticmethod
     def _async_step(step_id: str) -> Callable[[SchemaConfigFlowHandler, dict[str, Any] | None], Coroutine[Any, Any, ConfigFlowResult]]: ...
     @abstractmethod
+    @callback
     def async_config_entry_title(self, options: Mapping[str, Any]) -> str: ...
+    @callback
     def async_config_flow_finished(self, options: Mapping[str, Any]) -> None: ...
+    @callback
     @staticmethod
     def async_options_flow_finished(hass: HomeAssistant, options: Mapping[str, Any]) -> None: ...
+    @callback
     def async_create_entry(self, data: Mapping[str, Any], **kwargs: Any) -> ConfigFlowResult: ...
 
 class SchemaOptionsFlowHandler(OptionsFlow):
@@ -78,7 +81,10 @@ class SchemaOptionsFlowHandler(OptionsFlow):
     def options(self) -> dict[str, Any]: ...
     @staticmethod
     def _async_step(step_id: str) -> Callable[[SchemaConfigFlowHandler, dict[str, Any] | None], Coroutine[Any, Any, ConfigFlowResult]]: ...
+    @callback
     def async_create_entry(self, data: Mapping[str, Any], **kwargs: Any) -> ConfigFlowResult: ...
 
+@callback
 def wrapped_entity_config_entry_title(hass: HomeAssistant, entity_id_or_uuid: str) -> str: ...
+@callback
 def entity_selector_without_own_entities(handler: SchemaOptionsFlowHandler, entity_selector_config: selector.EntitySelectorConfig) -> selector.EntitySelector: ...

homeassistant-stubs/helpers/script.pyi

@@ -12,6 +12,7 @@ from .trigger import async_initialize_triggers as async_initialize_triggers, asy
 from .typing import ConfigType as ConfigType, TemplateVarsType as TemplateVarsType, UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
 from _typeshed import Incomplete
 from collections.abc import AsyncGenerator, Callable as Callable, Mapping, Sequence
+from contextlib import asynccontextmanager
 from contextvars import ContextVar
 from dataclasses import dataclass
 from datetime import datetime, timedelta
@@ -65,6 +66,7 @@ class ScriptStoppedError(Exception): ...
 
 def _set_result_unless_done(future: asyncio.Future[None]) -> None: ...
 def action_trace_append(variables: dict[str, Any], path: str) -> TraceElement: ...
+@asynccontextmanager
 async def trace_action(hass: HomeAssistant, script_run: _ScriptRun, stop: asyncio.Future[None], variables: dict[str, Any]) -> AsyncGenerator[TraceElement]: ...
 def make_script_schema(schema: Mapping[Any, Any], default_script_mode: str, extra: int = ...) -> vol.Schema: ...
 
@@ -140,6 +142,7 @@ class _QueuedScriptRun(_ScriptRun):
     async def async_run(self) -> None: ...
     def _finish(self) -> None: ...
 
+@callback
 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: ...
@@ -160,7 +163,6 @@ class ScriptRunResult:
     conversation_response: str | None | UndefinedType
     service_response: ServiceResponse
     variables: dict[str, Any]
-    def __init__(self, conversation_response, service_response, variables) -> None: ...
 
 class Script:
     top_level: Incomplete
@@ -198,6 +200,7 @@ class Script:
     def _set_logger(self, logger: logging.Logger | None = None) -> None: ...
     def update_logger(self, logger: logging.Logger | None = None) -> None: ...
     def _changed(self) -> None: ...
+    @callback
     def _chain_change_listener(self, sub_script: Script) -> None: ...
     @property
     def is_running(self) -> bool: ...
@@ -238,10 +241,17 @@ class Script:
     async def _async_get_sequence_script(self, step: int) -> Script: ...
     def _log(self, msg: str, *args: Any, level: int = ..., **kwargs: Any) -> None: ...
 
+@callback
 def breakpoint_clear(hass: HomeAssistant, key: str, run_id: str | None, node: str) -> None: ...
+@callback
 def breakpoint_clear_all(hass: HomeAssistant) -> None: ...
+@callback
 def breakpoint_set(hass: HomeAssistant, key: str, run_id: str | None, node: str) -> None: ...
+@callback
 def breakpoint_list(hass: HomeAssistant) -> list[dict[str, Any]]: ...
+@callback
 def debug_continue(hass: HomeAssistant, key: str, run_id: str) -> None: ...
+@callback
 def debug_step(hass: HomeAssistant, key: str, run_id: str) -> None: ...
+@callback
 def debug_stop(hass: HomeAssistant, key: str, run_id: str) -> None: ...

homeassistant-stubs/helpers/script_variables.pyi

@@ -8,5 +8,6 @@ class ScriptVariables:
     variables: Incomplete
     _has_template: bool | None
     def __init__(self, variables: dict[str, Any]) -> None: ...
+    @callback
     def async_render(self, hass: HomeAssistant, run_variables: Mapping[str, Any] | None, *, render_as_defaults: bool = True, limited: bool = False) -> dict[str, Any]: ...
     def as_dict(self) -> dict[str, Any]: ...

homeassistant-stubs/helpers/selector.pyi

@@ -1,6 +1,7 @@
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable, Mapping, Sequence
 from enum import StrEnum
+from functools import cache
 from homeassistant.const import CONF_MODE as CONF_MODE, CONF_UNIT_OF_MEASUREMENT as CONF_UNIT_OF_MEASUREMENT
 from homeassistant.core import split_entity_id as split_entity_id, valid_entity_id as valid_entity_id
 from homeassistant.generated.countries import COUNTRIES as COUNTRIES
@@ -22,6 +23,7 @@ class Selector[_T: Mapping[str, Any]]:
     def __eq__(self, other: object) -> bool: ...
     def serialize(self) -> dict[str, dict[str, _T]]: ...
 
+@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: ...

homeassistant-stubs/helpers/service.pyi

@@ -6,6 +6,7 @@ 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 Awaitable, 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.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
@@ -23,6 +24,7 @@ _LOGGER: Incomplete
 SERVICE_DESCRIPTION_CACHE: HassKey[dict[tuple[str, str], dict[str, Any] | None]]
 ALL_SERVICE_DESCRIPTIONS_CACHE: HassKey[tuple[set[tuple[str, str]], dict[str, dict[str, Any]]]]
 
+@cache
 def _base_components() -> dict[str, ModuleType]: ...
 def _validate_option_or_feature(option_or_feature: str, label: str) -> Any: ...
 def validate_attribute_option(attribute_option: str) -> Any: ...
@@ -55,37 +57,55 @@ class ServiceTargetSelector:
 
 @dataclasses.dataclass(slots=True)
 class SelectedEntities:
-    referenced: set[str] = ...
-    indirectly_referenced: set[str] = ...
-    missing_devices: set[str] = ...
-    missing_areas: set[str] = ...
-    missing_floors: set[str] = ...
-    missing_labels: set[str] = ...
-    referenced_devices: set[str] = ...
-    referenced_areas: set[str] = ...
+    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: ...
-    def __init__(self, referenced=..., indirectly_referenced=..., missing_devices=..., missing_areas=..., missing_floors=..., missing_labels=..., referenced_devices=..., referenced_areas=...) -> None: ...
 
+@bind_hass
 def call_from_config(hass: HomeAssistant, config: ConfigType, blocking: bool = False, variables: TemplateVarsType = None, validate_config: bool = True) -> None: ...
+@bind_hass
 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: ...
+@callback
+@bind_hass
 def async_prepare_call_from_config(hass: HomeAssistant, config: ConfigType, variables: TemplateVarsType = None, validate_config: bool = False) -> ServiceParams: ...
+@bind_hass
 def extract_entity_ids(hass: HomeAssistant, service_call: ServiceCall, expand_group: bool = True) -> set[str]: ...
+@bind_hass
 async def async_extract_entities[_EntityT: Entity](hass: HomeAssistant, entities: Iterable[_EntityT], service_call: ServiceCall, expand_group: bool = True) -> list[_EntityT]: ...
+@bind_hass
 async def async_extract_entity_ids(hass: HomeAssistant, service_call: ServiceCall, expand_group: bool = True) -> set[str]: ...
 def _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
 async def async_extract_config_entry_ids(hass: HomeAssistant, service_call: ServiceCall, expand_group: bool = True) -> set[str]: ...
 def _load_services_file(hass: HomeAssistant, integration: Integration) -> JSON_TYPE: ...
 def _load_services_files(hass: HomeAssistant, integrations: Iterable[Integration]) -> list[JSON_TYPE]: ...
+@callback
 def async_get_cached_service_description(hass: HomeAssistant, domain: str, service: str) -> dict[str, Any] | None: ...
+@bind_hass
 async def async_get_all_descriptions(hass: HomeAssistant) -> dict[str, dict[str, Any]]: ...
+@callback
 def remove_entity_service_fields(call: ServiceCall) -> dict[Any, Any]: ...
+@callback
+@bind_hass
 def async_set_service_schema(hass: HomeAssistant, domain: str, service: str, schema: dict[str, Any]) -> None: ...
 def _get_permissible_entity_candidates(call: ServiceCall, entities: dict[str, Entity], entity_perms: Callable[[str, str], bool] | None, target_all_entities: bool, all_referenced: set[str] | None) -> list[Entity]: ...
+@bind_hass
 async def entity_service_call(hass: HomeAssistant, registered_entities: dict[str, Entity], func: str | HassJob, call: ServiceCall, required_features: Iterable[int] | None = None) -> EntityServiceResponse | None: ...
 async def _handle_entity_call(hass: HomeAssistant, entity: Entity, func: str | HassJob, data: dict | ServiceCall, context: Context) -> ServiceResponse: ...
 async def _async_admin_handler(hass: HomeAssistant, service_job: HassJob[[ServiceCall], Awaitable[None] | None], call: ServiceCall) -> None: ...
+@bind_hass
+@callback
 def async_register_admin_service(hass: HomeAssistant, domain: str, service: str, service_func: Callable[[ServiceCall], Awaitable[None] | None], schema: VolSchemaType = ...) -> None: ...
+@bind_hass
+@callback
 def verify_domain_control(hass: HomeAssistant, domain: str) -> Callable[[Callable[[ServiceCall], Any]], Callable[[ServiceCall], Any]]: ...
 
 class ReloadServiceHelper[_T]:
@@ -97,4 +117,5 @@ class ReloadServiceHelper[_T]:
     def __init__(self, service_func: Callable[[ServiceCall], Coroutine[Any, Any, Any]], reload_targets_func: Callable[[ServiceCall], set[_T]]) -> None: ...
     async def execute_service(self, service_call: ServiceCall) -> None: ...
 
+@callback
 def async_register_entity_service(hass: HomeAssistant, domain: str, name: str, *, entities: dict[str, Entity], func: str | Callable[..., Any], job_type: HassJobType | None, required_features: Iterable[int] | None = None, schema: VolDictType | VolSchemaType | None, supports_response: SupportsResponse = ...) -> None: ...

homeassistant-stubs/helpers/service_info/hassio.pyi

@@ -8,4 +8,3 @@ class HassioServiceInfo(BaseServiceInfo):
     name: str
     slug: str
     uuid: str
-    def __init__(self, config, name, slug, uuid) -> None: ...

homeassistant-stubs/helpers/service_info/mqtt.pyi

@@ -10,4 +10,3 @@ class MqttServiceInfo(BaseServiceInfo):
     retain: bool
     subscribed_topic: str
     timestamp: float
-    def __init__(self, topic, payload, qos, retain, subscribed_topic, timestamp) -> None: ...

homeassistant-stubs/helpers/signal.pyi

@@ -8,4 +8,6 @@ from homeassistant.util.hass_dict import HassKey as HassKey
 _LOGGER: Incomplete
 KEY_HA_STOP: HassKey[asyncio.Task[None]]
 
+@callback
+@bind_hass
 def async_register_signal_handling(hass: HomeAssistant) -> None: ...

homeassistant-stubs/helpers/significant_change.pyi

@@ -28,4 +28,5 @@ class SignificantlyChangedChecker:
     last_approved_entities: dict[str, tuple[State, Any]]
     extra_significant_check: Incomplete
     def __init__(self, hass: HomeAssistant, extra_significant_check: ExtraCheckTypeFunc | None = None) -> None: ...
+    @callback
     def async_is_significant_change(self, new_state: State, *, extra_arg: Any | None = None) -> bool: ...