homeassistant-stubs 2025.4.0b9__py3-none-any.whl → 2026.1.0b0__py3-none-any.whl

homeassistant-stubs/helpers/trigger.pyi

@@ -1,29 +1,183 @@
+import abc
+import asyncio
 import voluptuous as vol
+from . import selector as selector
+from .automation import get_absolute_description_key as get_absolute_description_key, get_relative_description_key as get_relative_description_key, move_options_fields_to_top_level as move_options_fields_to_top_level
+from .integration_platform import async_process_integration_platforms as async_process_integration_platforms
+from .selector import TargetSelector as TargetSelector
+from .target import TargetStateChangedData as TargetStateChangedData, async_track_target_selector_state_change_event as async_track_target_selector_state_change_event
 from .template import Template as Template
 from .typing import ConfigType as ConfigType, TemplateVarsType as TemplateVarsType
 from _typeshed import Incomplete
 from collections import defaultdict
-from collections.abc import Callable, Coroutine
+from collections.abc import Callable, Coroutine, Iterable
 from dataclasses import dataclass, field
-from homeassistant.const import CONF_ALIAS as CONF_ALIAS, CONF_ENABLED as CONF_ENABLED, CONF_ID as CONF_ID, CONF_PLATFORM as CONF_PLATFORM, CONF_VARIABLES as CONF_VARIABLES
-from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Context as Context, HassJob as HassJob, HomeAssistant as HomeAssistant, callback as callback, is_callback as is_callback
+from enum import StrEnum
+from homeassistant.const import ATTR_ENTITY_ID as ATTR_ENTITY_ID, CONF_ABOVE as CONF_ABOVE, CONF_ALIAS as CONF_ALIAS, CONF_BELOW as CONF_BELOW, CONF_ENABLED as CONF_ENABLED, CONF_ID as CONF_ID, CONF_OPTIONS as CONF_OPTIONS, CONF_PLATFORM as CONF_PLATFORM, CONF_SELECTOR as CONF_SELECTOR, CONF_TARGET as CONF_TARGET, CONF_VARIABLES as CONF_VARIABLES, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN
+from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Context as Context, HassJob as HassJob, HassJobType as HassJobType, HomeAssistant as HomeAssistant, State as State, callback as callback, get_hassjob_callable_job_type as get_hassjob_callable_job_type, is_callback as is_callback, split_entity_id as split_entity_id
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, TemplateError as TemplateError
-from homeassistant.loader import IntegrationNotFound as IntegrationNotFound, async_get_integration as async_get_integration
+from homeassistant.loader import Integration as Integration, IntegrationNotFound as IntegrationNotFound, async_get_integration as async_get_integration, async_get_integrations as async_get_integrations
 from homeassistant.util.async_ import create_eager_task as create_eager_task
 from homeassistant.util.hass_dict import HassKey as HassKey
-from typing import Any, Protocol, TypedDict
+from homeassistant.util.yaml import load_yaml_dict as load_yaml_dict
+from typing import Any, Final, Protocol, TypedDict, override
 
+_LOGGER: Incomplete
 _PLATFORM_ALIASES: Incomplete
 DATA_PLUGGABLE_ACTIONS: HassKey[defaultdict[tuple, PluggableActionsEntry]]
+TRIGGER_DESCRIPTION_CACHE: HassKey[dict[str, dict[str, Any] | None]]
+TRIGGER_DISABLED_TRIGGERS: HassKey[set[str]]
+TRIGGER_PLATFORM_SUBSCRIPTIONS: HassKey[list[Callable[[set[str]], Coroutine[Any, Any, None]]]]
+TRIGGERS: HassKey[dict[str, str]]
+_FIELD_DESCRIPTION_SCHEMA: Incomplete
+_TRIGGER_DESCRIPTION_SCHEMA: Incomplete
+
+def starts_with_dot(key: str) -> str: ...
+
+_TRIGGERS_DESCRIPTION_SCHEMA: Incomplete
+
+async def async_setup(hass: HomeAssistant) -> None: ...
+@callback
+def async_subscribe_platform_events(hass: HomeAssistant, on_event: Callable[[set[str]], Coroutine[Any, Any, None]]) -> Callable[[], None]: ...
+async def _register_trigger_platform(hass: HomeAssistant, integration_domain: str, platform: TriggerProtocol) -> None: ...
+
+_TRIGGER_SCHEMA: Incomplete
+
+class Trigger(abc.ABC, metaclass=abc.ABCMeta):
+    _hass: HomeAssistant
+    @classmethod
+    async def async_validate_complete_config(cls, hass: HomeAssistant, complete_config: ConfigType) -> ConfigType: ...
+    @classmethod
+    @abc.abstractmethod
+    async def async_validate_config(cls, hass: HomeAssistant, config: ConfigType) -> ConfigType: ...
+    def __init__(self, hass: HomeAssistant, config: TriggerConfig) -> None: ...
+    async def async_attach_action(self, action: TriggerAction, action_payload_builder: TriggerActionPayloadBuilder) -> CALLBACK_TYPE: ...
+    @abc.abstractmethod
+    async def async_attach_runner(self, run_action: TriggerActionRunner) -> CALLBACK_TYPE: ...
+
+ATTR_BEHAVIOR: Final[str]
+BEHAVIOR_FIRST: Final[str]
+BEHAVIOR_LAST: Final[str]
+BEHAVIOR_ANY: Final[str]
+ENTITY_STATE_TRIGGER_SCHEMA: Incomplete
+ENTITY_STATE_TRIGGER_SCHEMA_FIRST_LAST: Incomplete
+
+class EntityTriggerBase(Trigger, metaclass=abc.ABCMeta):
+    _domain: str
+    _schema: vol.Schema
+    @override
+    @classmethod
+    async def async_validate_config(cls, hass: HomeAssistant, config: ConfigType) -> ConfigType: ...
+    _options: Incomplete
+    _target: Incomplete
+    def __init__(self, hass: HomeAssistant, config: TriggerConfig) -> None: ...
+    def is_valid_transition(self, from_state: State, to_state: State) -> bool: ...
+    @abc.abstractmethod
+    def is_valid_state(self, state: State) -> bool: ...
+    def check_all_match(self, entity_ids: set[str]) -> bool: ...
+    def check_one_match(self, entity_ids: set[str]) -> bool: ...
+    def entity_filter(self, entities: set[str]) -> set[str]: ...
+    @override
+    async def async_attach_runner(self, run_action: TriggerActionRunner) -> CALLBACK_TYPE: ...
+
+class EntityTargetStateTriggerBase(EntityTriggerBase):
+    _to_states: set[str]
+    def is_valid_transition(self, from_state: State, to_state: State) -> bool: ...
+    def is_valid_state(self, state: State) -> bool: ...
+
+class EntityTransitionTriggerBase(EntityTriggerBase):
+    _from_states: set[str]
+    _to_states: set[str]
+    def is_valid_transition(self, from_state: State, to_state: State) -> bool: ...
+    def is_valid_state(self, state: State) -> bool: ...
+
+class EntityOriginStateTriggerBase(EntityTriggerBase):
+    _from_state: str
+    def is_valid_transition(self, from_state: State, to_state: State) -> bool: ...
+    def is_valid_state(self, state: State) -> bool: ...
+
+class EntityTargetStateAttributeTriggerBase(EntityTriggerBase):
+    _attribute: str
+    _attribute_to_state: str
+    def is_valid_transition(self, from_state: State, to_state: State) -> bool: ...
+    def is_valid_state(self, state: State) -> bool: ...
+
+def _validate_range[_T: dict[str, Any]](lower_limit: str, upper_limit: str) -> Callable[[_T], _T]: ...
+
+_NUMBER_OR_ENTITY_CHOOSE_SCHEMA: Incomplete
+
+def _validate_number_or_entity(value: dict | float | str) -> float | str: ...
+
+_number_or_entity: Incomplete
+NUMERICAL_ATTRIBUTE_CHANGED_TRIGGER_SCHEMA: Incomplete
+
+def _get_numerical_value(hass: HomeAssistant, entity_or_float: float | str) -> float | None: ...
+
+class EntityNumericalStateAttributeChangedTriggerBase(EntityTriggerBase):
+    _attribute: str
+    _schema = NUMERICAL_ATTRIBUTE_CHANGED_TRIGGER_SCHEMA
+    _above: None | float | str
+    _below: None | float | str
+    def __init__(self, hass: HomeAssistant, config: TriggerConfig) -> None: ...
+    def is_valid_transition(self, from_state: State, to_state: State) -> bool: ...
+    def is_valid_state(self, state: State) -> bool: ...
+
+CONF_LOWER_LIMIT: str
+CONF_UPPER_LIMIT: str
+CONF_THRESHOLD_TYPE: str
+
+class ThresholdType(StrEnum):
+    ABOVE = 'above'
+    BELOW = 'below'
+    BETWEEN = 'between'
+    OUTSIDE = 'outside'
+
+def _validate_limits_for_threshold_type(value: dict[str, Any]) -> dict[str, Any]: ...
+
+NUMERICAL_ATTRIBUTE_CROSSED_THRESHOLD_SCHEMA: Incomplete
+
+class EntityNumericalStateAttributeCrossedThresholdTriggerBase(EntityTriggerBase):
+    _attribute: str
+    _schema = NUMERICAL_ATTRIBUTE_CROSSED_THRESHOLD_SCHEMA
+    _lower_limit: float | str | None
+    _upper_limit: float | str | None
+    _threshold_type: ThresholdType
+    def __init__(self, hass: HomeAssistant, config: TriggerConfig) -> None: ...
+    def is_valid_transition(self, from_state: State, to_state: State) -> bool: ...
+    def is_valid_state(self, state: State) -> bool: ...
+
+def make_entity_target_state_trigger(domain: str, to_states: str | set[str]) -> type[EntityTargetStateTriggerBase]: ...
+def make_entity_transition_trigger(domain: str, *, from_states: set[str], to_states: set[str]) -> type[EntityTransitionTriggerBase]: ...
+def make_entity_origin_state_trigger(domain: str, *, from_state: str) -> type[EntityOriginStateTriggerBase]: ...
+def make_entity_numerical_state_attribute_changed_trigger(domain: str, attribute: str) -> type[EntityNumericalStateAttributeChangedTriggerBase]: ...
+def make_entity_numerical_state_attribute_crossed_threshold_trigger(domain: str, attribute: str) -> type[EntityNumericalStateAttributeCrossedThresholdTriggerBase]: ...
+def make_entity_target_state_attribute_trigger(domain: str, attribute: str, to_state: str) -> type[EntityTargetStateAttributeTriggerBase]: ...
 
 class TriggerProtocol(Protocol):
+    async def async_get_triggers(self, hass: HomeAssistant) -> dict[str, type[Trigger]]: ...
     TRIGGER_SCHEMA: vol.Schema
     async def async_validate_trigger_config(self, hass: HomeAssistant, config: ConfigType) -> ConfigType: ...
     async def async_attach_trigger(self, hass: HomeAssistant, config: ConfigType, action: TriggerActionType, trigger_info: TriggerInfo) -> CALLBACK_TYPE: ...
 
-class TriggerActionType(Protocol):
+@dataclass(slots=True, frozen=True)
+class TriggerConfig:
+    key: str
+    target: dict[str, Any] | None = ...
+    options: dict[str, Any] | None = ...
+
+class TriggerActionRunner(Protocol):
+    @callback
+    def __call__(self, extra_trigger_payload: dict[str, Any], description: str, context: Context | None = None) -> asyncio.Task[Any]: ...
+
+class TriggerActionPayloadBuilder(Protocol):
+    def __call__(self, extra_trigger_payload: dict[str, Any], description: str) -> dict[str, Any]: ...
+
+class TriggerAction(Protocol):
     async def __call__(self, run_variables: dict[str, Any], context: Context | None = None) -> Any: ...
 
+class TriggerActionType(Protocol):
+    def __call__(self, run_variables: dict[str, Any], context: Context | None = None) -> Coroutine[Any, Any, Any] | Any: ...
+
 class TriggerData(TypedDict):
     id: str
     idx: str
@@ -39,7 +193,7 @@ class TriggerInfo(TypedDict):
 @dataclass(slots=True)
 class PluggableActionsEntry:
     plugs: set[PluggableAction] = field(default_factory=set)
-    actions: dict[object, tuple[HassJob[[dict[str, Any], Context | None], Coroutine[Any, Any, None]], dict[str, Any]]] = field(default_factory=dict)
+    actions: dict[object, tuple[HassJob[[dict[str, Any], Context | None], Coroutine[Any, Any, None] | Any], dict[str, Any]]] = field(default_factory=dict)
 
 class PluggableAction:
     _entry: PluggableActionsEntry | None
@@ -58,7 +212,11 @@ class PluggableAction:
     def async_register(self, hass: HomeAssistant, trigger: dict[str, str]) -> CALLBACK_TYPE: ...
     async def async_run(self, hass: HomeAssistant, context: Context | None = None) -> None: ...
 
-async def _async_get_trigger_platform(hass: HomeAssistant, config: ConfigType) -> TriggerProtocol: ...
+async def _async_get_trigger_platform(hass: HomeAssistant, trigger_key: str) -> tuple[str, TriggerProtocol]: ...
 async def async_validate_trigger_config(hass: HomeAssistant, trigger_config: list[ConfigType]) -> list[ConfigType]: ...
 def _trigger_action_wrapper(hass: HomeAssistant, action: Callable, conf: ConfigType) -> Callable: ...
+async def _async_attach_trigger_cls(hass: HomeAssistant, trigger_cls: type[Trigger], trigger_key: str, conf: ConfigType, action: Callable, trigger_info: TriggerInfo) -> CALLBACK_TYPE: ...
 async def async_initialize_triggers(hass: HomeAssistant, trigger_config: list[ConfigType], action: Callable, domain: str, name: str, log_cb: Callable, home_assistant_start: bool = False, variables: TemplateVarsType = None) -> CALLBACK_TYPE | None: ...
+def _load_triggers_file(integration: Integration) -> dict[str, Any]: ...
+def _load_triggers_files(integrations: Iterable[Integration]) -> dict[str, dict[str, Any]]: ...
+async def async_get_all_descriptions(hass: HomeAssistant) -> dict[str, dict[str, Any] | None]: ...

homeassistant-stubs/helpers/trigger_template_entity.pyi

@@ -1,9 +1,11 @@
 import voluptuous as vol
 from .entity import Entity as Entity
-from .template import TemplateStateFromEntityId as TemplateStateFromEntityId, render_complex as render_complex
+from .template import Template as Template, TemplateStateFromEntityId as TemplateStateFromEntityId, _SENTINEL as _SENTINEL, render_complex as render_complex, result_as_boolean as result_as_boolean
+from .template.context import render_with_context as render_with_context
 from .typing import ConfigType as ConfigType
 from _typeshed import Incomplete
-from homeassistant.components.sensor import CONF_STATE_CLASS as CONF_STATE_CLASS, DEVICE_CLASSES_SCHEMA as DEVICE_CLASSES_SCHEMA, STATE_CLASSES_SCHEMA as STATE_CLASSES_SCHEMA, SensorEntity as SensorEntity
+from homeassistant.components.sensor import CONF_STATE_CLASS as CONF_STATE_CLASS, DEVICE_CLASSES_SCHEMA as DEVICE_CLASSES_SCHEMA, STATE_CLASSES_SCHEMA as STATE_CLASSES_SCHEMA, SensorDeviceClass as SensorDeviceClass, SensorEntity as SensorEntity
+from homeassistant.components.sensor.helpers import async_parse_date_datetime as async_parse_date_datetime
 from homeassistant.const import ATTR_ENTITY_PICTURE as ATTR_ENTITY_PICTURE, ATTR_FRIENDLY_NAME as ATTR_FRIENDLY_NAME, ATTR_ICON as ATTR_ICON, CONF_DEVICE_CLASS as CONF_DEVICE_CLASS, CONF_ICON as CONF_ICON, CONF_NAME as CONF_NAME, CONF_UNIQUE_ID as CONF_UNIQUE_ID, CONF_UNIT_OF_MEASUREMENT as CONF_UNIT_OF_MEASUREMENT
 from homeassistant.core import HomeAssistant as HomeAssistant, State as State, callback as callback
 from homeassistant.exceptions import TemplateError as TemplateError
@@ -17,9 +19,16 @@ CONF_TO_ATTRIBUTE: Incomplete
 TEMPLATE_ENTITY_BASE_SCHEMA: Incomplete
 
 def make_template_entity_base_schema(default_name: str) -> vol.Schema: ...
+def log_triggered_template_error(entity_id: str, err: TemplateError, key: str | None = None, attribute: str | None = None) -> None: ...
 
 TEMPLATE_SENSOR_BASE_SCHEMA: Incomplete
 
+class ValueTemplate(Template):
+    @classmethod
+    def from_template(cls, template: Template) -> ValueTemplate: ...
+    @callback
+    def async_render_as_value_template(self, entity_id: str, variables: dict[str, Any], error_value: Any) -> Any: ...
+
 class TriggerBaseEntity(Entity):
     domain: str
     extra_template_keys: tuple[str, ...] | None
@@ -33,6 +42,8 @@ class TriggerBaseEntity(Entity):
     _rendered: Incomplete
     _parse_result: Incomplete
     _attr_device_class: Incomplete
+    _availability_template: Incomplete
+    _available: bool
     def __init__(self, hass: HomeAssistant, config: ConfigType) -> None: ...
     @property
     def name(self) -> str | None: ...
@@ -48,14 +59,23 @@ class TriggerBaseEntity(Entity):
     def extra_state_attributes(self) -> dict[str, Any] | None: ...
     def _set_unique_id(self, unique_id: str | None) -> None: ...
     def restore_attributes(self, last_state: State) -> None: ...
+    def _template_variables(self, run_variables: dict[str, Any] | None = None) -> dict: ...
+    def _render_single_template(self, key: str, variables: dict[str, Any], strict: bool = False) -> Any: ...
+    def _render_availability_template(self, variables: dict[str, Any]) -> bool: ...
+    def _render_attributes(self, rendered: dict, variables: dict[str, Any]) -> None: ...
+    def _render_single_templates(self, rendered: dict, variables: dict[str, Any], filtered: list[str] | None = None) -> None: ...
     def _render_templates(self, variables: dict[str, Any]) -> None: ...
 
 class ManualTriggerEntity(TriggerBaseEntity):
     def __init__(self, hass: HomeAssistant, config: ConfigType) -> None: ...
+    def _template_variables_with_value(self, value: str | None = None) -> dict[str, Any]: ...
     @callback
-    def _process_manual_data(self, value: Any | None = None) -> None: ...
+    def _process_manual_data(self, variables: dict[str, Any]) -> None: ...
 
 class ManualTriggerSensorEntity(ManualTriggerEntity, SensorEntity):
     _attr_native_unit_of_measurement: Incomplete
     _attr_state_class: Incomplete
     def __init__(self, hass: HomeAssistant, config: ConfigType) -> None: ...
+    _attr_native_value: Incomplete
+    @callback
+    def _set_native_value_with_possible_timestamp(self, value: Any) -> None: ...

homeassistant-stubs/helpers/typing.pyi

@@ -1,5 +1,4 @@
 import voluptuous as vol
-from .deprecation import DeferredDeprecatedAlias as DeferredDeprecatedAlias, all_with_deprecated_constants as all_with_deprecated_constants, check_if_deprecated_constant as check_if_deprecated_constant, dir_with_deprecated_constants as dir_with_deprecated_constants
 from _typeshed import Incomplete
 from collections.abc import Mapping
 from enum import Enum
@@ -19,13 +18,3 @@ class UndefinedType(Enum):
     _singleton = 0
 
 UNDEFINED: Incomplete
-
-def _deprecated_typing_helper(attr: str) -> DeferredDeprecatedAlias: ...
-
-_DEPRECATED_ContextType: Incomplete
-_DEPRECATED_EventType: Incomplete
-_DEPRECATED_HomeAssistantType: Incomplete
-_DEPRECATED_ServiceCallType: Incomplete
-__getattr__: Incomplete
-__dir__: Incomplete
-__all__: Incomplete

homeassistant-stubs/helpers/update_coordinator.pyi

@@ -3,7 +3,6 @@ import asyncio
 import logging
 from . import entity as entity, event as event
 from .debounce import Debouncer as Debouncer
-from .frame import report_usage as report_usage
 from .typing import UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
 from _typeshed import Incomplete
 from abc import abstractmethod
@@ -21,7 +20,9 @@ REQUEST_REFRESH_DEFAULT_COOLDOWN: int
 REQUEST_REFRESH_DEFAULT_IMMEDIATE: bool
 _DataT = TypeVar('_DataT', default=dict[str, Any])
 
-class UpdateFailed(HomeAssistantError): ...
+class UpdateFailed(HomeAssistantError):
+    retry_after: Incomplete
+    def __init__(self, *args: Any, retry_after: float | None = None, **kwargs: Any) -> None: ...
 
 class BaseDataUpdateCoordinatorProtocol(Protocol):
     @callback
@@ -44,8 +45,9 @@ class DataUpdateCoordinator(BaseDataUpdateCoordinatorProtocol, Generic[_DataT]):
     _unsub_refresh: CALLBACK_TYPE | None
     _unsub_shutdown: CALLBACK_TYPE | None
     _request_refresh_task: asyncio.TimerHandle | None
+    _retry_after: float | None
     last_update_success: bool
-    last_exception: Exception | None
+    last_exception: BaseException | None
     _debounced_refresh: Incomplete
     def __init__(self, hass: HomeAssistant, logger: logging.Logger, *, config_entry: config_entries.ConfigEntry | None | UndefinedType = ..., name: str, update_interval: timedelta | None = None, update_method: Callable[[], Awaitable[_DataT]] | None = None, setup_method: Callable[[], Awaitable[None]] | None = None, request_refresh_debouncer: Debouncer[Coroutine[Any, Any, None]] | None = None, always_update: bool = True) -> None: ...
     async def async_register_shutdown(self) -> None: ...
@@ -74,6 +76,7 @@ class DataUpdateCoordinator(BaseDataUpdateCoordinatorProtocol, Generic[_DataT]):
     async def async_request_refresh(self) -> None: ...
     async def _async_update_data(self) -> _DataT: ...
     async def async_config_entry_first_refresh(self) -> None: ...
+    async def _async_config_entry_first_refresh(self) -> None: ...
     async def __wrap_async_setup(self) -> bool: ...
     async def _async_setup(self) -> None: ...
     async def async_refresh(self) -> None: ...

homeassistant-stubs/loader.pyi

@@ -119,6 +119,7 @@ class Manifest(TypedDict, total=False):
     loggers: list[str]
     import_executor: bool
     single_config_entry: bool
+    preview_features: dict[str, dict[str, str]]
 
 def async_setup(hass: HomeAssistant) -> None: ...
 def manifest_from_legacy_module(domain: str, module: ModuleType) -> Manifest: ...
@@ -198,9 +199,13 @@ class Integration:
     @cached_property
     def import_executor(self) -> bool: ...
     @cached_property
-    def has_translations(self) -> bool: ...
+    def has_conditions(self) -> bool: ...
     @cached_property
     def has_services(self) -> bool: ...
+    @cached_property
+    def has_translations(self) -> bool: ...
+    @cached_property
+    def has_triggers(self) -> bool: ...
     @property
     def mqtt(self) -> list[str] | None: ...
     @property
@@ -210,6 +215,8 @@ class Integration:
     @property
     def bluetooth(self) -> list[dict[str, str | int]] | None: ...
     @property
+    def preview_features(self) -> dict[str, dict[str, str]] | None: ...
+    @property
     def dhcp(self) -> list[dict[str, str | bool]] | None: ...
     @property
     def usb(self) -> list[dict[str, str]] | None: ...
@@ -260,7 +267,8 @@ class _ResolveDependenciesCache(_ResolveDependenciesCacheProtocol):
 
 async def resolve_integrations_dependencies(hass: HomeAssistant, integrations: Iterable[Integration]) -> dict[str, set[str]]: ...
 async def resolve_integrations_after_dependencies(hass: HomeAssistant, integrations: Iterable[Integration], possible_after_dependencies: set[str] | None = None, *, ignore_exceptions: bool = False) -> dict[str, set[str]]: ...
-async def _do_resolve_dependencies(itg: Integration, *, cache: _ResolveDependenciesCacheProtocol, possible_after_dependencies: set[str] | None | UndefinedType = ..., ignore_exceptions: bool = False) -> set[str]: ...
+async def _resolve_integrations_dependencies(hass: HomeAssistant, name: str, integrations: Iterable[Integration], *, cache: _ResolveDependenciesCacheProtocol, possible_after_dependencies: set[str] | None | UndefinedType = ..., ignore_exceptions: bool) -> dict[str, set[str]]: ...
+async def _resolve_integration_dependencies(itg: Integration, *, cache: _ResolveDependenciesCacheProtocol, possible_after_dependencies: set[str] | None | UndefinedType = ..., ignore_exceptions: bool = False) -> set[str]: ...
 
 class LoaderError(Exception): ...
 
@@ -276,27 +284,8 @@ class CircularDependency(LoaderError):
     def __init__(self, domain_cycle: list[str]) -> None: ...
     def extend_cycle(self, domain: str) -> None: ...
 
-def _load_file(hass: HomeAssistant, comp_or_platform: str, base_paths: list[str]) -> ComponentProtocol | None: ...
-
-class ModuleWrapper:
-    _hass: Incomplete
-    _module: Incomplete
-    def __init__(self, hass: HomeAssistant, module: ComponentProtocol) -> None: ...
-    def __getattr__(self, attr: str) -> Any: ...
-
-class Components:
-    _hass: Incomplete
-    def __init__(self, hass: HomeAssistant) -> None: ...
-    def __getattr__(self, comp_name: str) -> ModuleWrapper: ...
-
-class Helpers:
-    _hass: Incomplete
-    def __init__(self, hass: HomeAssistant) -> None: ...
-    def __getattr__(self, helper_name: str) -> ModuleWrapper: ...
-
 def bind_hass[_CallableT: Callable[..., Any]](func: _CallableT) -> _CallableT: ...
 def _async_mount_config_dir(hass: HomeAssistant) -> None: ...
-def _lookup_path(hass: HomeAssistant) -> list[str]: ...
 def is_component_module_loaded(hass: HomeAssistant, module: str) -> bool: ...
 @callback
 def async_get_issue_integration(hass: HomeAssistant | None, integration_domain: str | None) -> Integration | None: ...

homeassistant-stubs/requirements.pyi

@@ -2,7 +2,7 @@ import asyncio
 from .core import HomeAssistant as HomeAssistant, callback as callback
 from .exceptions import HomeAssistantError as HomeAssistantError
 from .helpers import singleton as singleton
-from .loader import Integration as Integration, IntegrationNotFound as IntegrationNotFound, async_get_integration as async_get_integration
+from .loader import Integration as Integration, IntegrationNotFound as IntegrationNotFound, async_get_integration as async_get_integration, async_suggest_report_issue as async_suggest_report_issue
 from _typeshed import Incomplete
 from collections.abc import Iterable
 from typing import Any
@@ -12,6 +12,7 @@ MAX_INSTALL_FAILURES: int
 DATA_REQUIREMENTS_MANAGER: str
 CONSTRAINT_FILE: str
 DISCOVERY_INTEGRATIONS: dict[str, Iterable[str]]
+DEPRECATED_PACKAGES: dict[str, tuple[str, str]]
 _LOGGER: Incomplete
 
 class RequirementsNotFound(HomeAssistantError):
@@ -20,7 +21,7 @@ class RequirementsNotFound(HomeAssistantError):
     def __init__(self, domain: str, requirements: list[str]) -> None: ...
 
 async def async_get_integration_with_requirements(hass: HomeAssistant, domain: str) -> Integration: ...
-async def async_process_requirements(hass: HomeAssistant, name: str, requirements: list[str]) -> None: ...
+async def async_process_requirements(hass: HomeAssistant, name: str, requirements: list[str], is_built_in: bool = True) -> None: ...
 async def async_load_installed_versions(hass: HomeAssistant, requirements: set[str]) -> None: ...
 @callback
 def _async_get_manager(hass: HomeAssistant) -> RequirementsManager: ...
@@ -39,7 +40,7 @@ class RequirementsManager:
     def __init__(self, hass: HomeAssistant) -> None: ...
     async def async_get_integration_with_requirements(self, domain: str, done: set[str] | None = None) -> Integration: ...
     async def _async_process_integration(self, integration: Integration, done: set[str]) -> None: ...
-    async def async_process_requirements(self, name: str, requirements: list[str]) -> None: ...
+    async def async_process_requirements(self, name: str, requirements: list[str], is_built_in: bool) -> None: ...
     def _find_missing_requirements(self, requirements: list[str]) -> list[str]: ...
     def _raise_for_failed_requirements(self, integration: str, missing: list[str]) -> None: ...
     async def _async_process_requirements(self, name: str, requirements: list[str]) -> None: ...

homeassistant-stubs/runner.pyi

@@ -1,17 +1,34 @@
 import asyncio
 import dataclasses
 from . import bootstrap as bootstrap
+from .const import __version__ as __version__
 from .core import callback as callback
 from .helpers.frame import warn_use as warn_use
 from .util.executor import InterruptibleThreadPoolExecutor as InterruptibleThreadPoolExecutor
+from .util.resource import set_open_file_descriptor_limit as set_open_file_descriptor_limit
 from .util.thread import deadlock_safe_shutdown as deadlock_safe_shutdown
 from _typeshed import Incomplete
+from collections.abc import Generator
+from contextlib import contextmanager
+from io import TextIOWrapper
+from pathlib import Path
 from typing import Any
 
 MAX_EXECUTOR_WORKERS: int
 TASK_CANCELATION_TIMEOUT: int
+LOCK_FILE_NAME: str
+LOCK_FILE_VERSION: int
 _LOGGER: Incomplete
 
+@dataclasses.dataclass
+class SingleExecutionLock:
+    exit_code: int | None = ...
+
+def _write_lock_info(lock_file: TextIOWrapper) -> None: ...
+def _report_existing_instance(lock_file_path: Path, config_dir: str) -> None: ...
+@contextmanager
+def ensure_single_execution(config_dir: str) -> Generator[SingleExecutionLock]: ...
+
 @dataclasses.dataclass(slots=True)
 class RuntimeConfig:
     config_dir: str
@@ -34,7 +51,7 @@ class HassEventLoopPolicy(asyncio.DefaultEventLoopPolicy):
     def new_event_loop(self) -> asyncio.AbstractEventLoop: ...
 
 @callback
-def _async_loop_exception_handler(_: Any, context: dict[str, Any]) -> None: ...
+def _async_loop_exception_handler(loop: asyncio.AbstractEventLoop, context: dict[str, Any]) -> None: ...
 async def setup_and_run_hass(runtime_config: RuntimeConfig) -> int: ...
 def _enable_posix_spawn() -> None: ...
 def run(runtime_config: RuntimeConfig) -> int: ...

homeassistant-stubs/scripts/check_config.pyi

@@ -15,7 +15,7 @@ C_HEAD: str
 ERROR_STR: str
 WARNING_STR: str
 
-def color(the_color, *args, reset: Incomplete | None = None): ...
+def color(the_color, *args, reset=None): ...
 def run(script_args: list) -> int: ...
 def check(config_dir, secrets: bool = False): ...
 async def async_check_config(config_dir): ...

homeassistant-stubs/setup.pyi

@@ -20,12 +20,12 @@ from typing import Final, TypedDict
 current_setup_group: contextvars.ContextVar[tuple[str, str | None] | None]
 _LOGGER: Incomplete
 ATTR_COMPONENT: Final[str]
-DATA_SETUP: HassKey[dict[str, asyncio.Future[bool]]]
-DATA_SETUP_DONE: HassKey[dict[str, asyncio.Future[bool]]]
-DATA_SETUP_STARTED: HassKey[dict[tuple[str, str | None], float]]
-DATA_SETUP_TIME: HassKey[defaultdict[str, defaultdict[str | None, defaultdict[SetupPhases, float]]]]
-DATA_DEPS_REQS: HassKey[set[str]]
-DATA_PERSISTENT_ERRORS: HassKey[dict[str, str | None]]
+_DATA_SETUP: HassKey[dict[str, asyncio.Future[bool]]]
+_DATA_SETUP_DONE: HassKey[dict[str, asyncio.Future[bool]]]
+_DATA_SETUP_STARTED: HassKey[dict[tuple[str, str | None], float]]
+_DATA_SETUP_TIME: HassKey[defaultdict[str, defaultdict[str | None, defaultdict[SetupPhases, float]]]]
+_DATA_DEPS_REQS: HassKey[set[str]]
+_DATA_PERSISTENT_ERRORS: HassKey[dict[str, str | None]]
 NOTIFY_FOR_TRANSLATION_KEYS: Incomplete
 SLOW_SETUP_WARNING: int
 SLOW_SETUP_MAX_WAIT: int
@@ -72,3 +72,4 @@ def async_start_setup(hass: core.HomeAssistant, integration: str, phase: SetupPh
 def async_get_setup_timings(hass: core.HomeAssistant) -> dict[str, float]: ...
 @callback
 def async_get_domain_setup_times(hass: core.HomeAssistant, domain: str) -> Mapping[str | None, dict[SetupPhases, float]]: ...
+async def async_wait_component(hass: HomeAssistant, domain: str) -> bool: ...

homeassistant-stubs/util/__init__.pyi

@@ -14,6 +14,7 @@ def repr_helper(inp: Any) -> str: ...
 def convert[_T, _U](value: _T | None, to_type: Callable[[_T], _U], default: _U | None = None) -> _U | None: ...
 def ensure_unique_string(preferred_string: str, current_strings: Iterable[str] | KeysView[str]) -> str: ...
 def get_random_string(length: int = 10) -> str: ...
+def snakecase(text: str) -> str: ...
 
 class Throttle:
     min_time: Incomplete

homeassistant-stubs/util/aiohttp.pyi

@@ -10,9 +10,14 @@ class MockStreamReader:
     def __init__(self, content: bytes) -> None: ...
     async def read(self, byte_count: int = -1) -> bytes: ...
 
+class MockStreamReaderChunked(MockStreamReader):
+    async def readchunk(self) -> tuple[bytes, bool]: ...
+
 class MockPayloadWriter:
     def enable_chunking(self) -> None: ...
+    def send_headers(self, *args: Any, **kwargs: Any) -> None: ...
     async def write_headers(self, *args: Any, **kwargs: Any) -> None: ...
+    async def write(self, *args: Any, **kwargs: Any) -> None: ...
 
 _MOCK_PAYLOAD_WRITER: Incomplete
 

homeassistant-stubs/util/async_iterator.pyi

@@ -0,0 +1,33 @@
+import asyncio
+from _typeshed import Incomplete
+from collections.abc import AsyncIterator
+from concurrent.futures import Future
+from typing import Self
+
+class Abort(Exception): ...
+
+class AsyncIteratorReader:
+    _aborted: bool
+    _loop: Incomplete
+    _stream: Incomplete
+    _buffer: bytes | None
+    _next_future: Future[bytes | None] | None
+    _pos: int
+    def __init__(self, loop: asyncio.AbstractEventLoop, stream: AsyncIterator[bytes]) -> None: ...
+    async def _next(self) -> bytes | None: ...
+    def abort(self) -> None: ...
+    def read(self, n: int = -1, /) -> bytes: ...
+    def close(self) -> None: ...
+
+class AsyncIteratorWriter:
+    _aborted: bool
+    _loop: Incomplete
+    _pos: int
+    _queue: asyncio.Queue[bytes | None]
+    _write_future: Future[bytes | None] | None
+    def __init__(self, loop: asyncio.AbstractEventLoop) -> None: ...
+    def __aiter__(self) -> Self: ...
+    async def __anext__(self) -> bytes: ...
+    def abort(self) -> None: ...
+    def tell(self) -> int: ...
+    def write(self, s: bytes, /) -> int: ...

homeassistant-stubs/util/logging.pyi

@@ -11,13 +11,15 @@ _LOGGER: Incomplete
 class HomeAssistantQueueListener(logging.handlers.QueueListener):
     LOG_COUNTS_RESET_INTERVAL: int
     MAX_LOGS_COUNT: int
+    EXCLUDED_LOG_COUNT_MODULES: Incomplete
     _last_reset: float
     _log_counts: dict[str, int]
-    _warned_modules: set[str]
+    _module_log_count_skip_flags: dict[str, bool]
     def __init__(self, queue: SimpleQueue[logging.Handler], *handlers: logging.Handler) -> None: ...
     @override
     def handle(self, record: logging.LogRecord) -> None: ...
     def _reset_counters(self, time_sec: float) -> None: ...
+    def _update_skip_flags(self, module_name: str) -> bool: ...
 
 class HomeAssistantQueueHandler(logging.handlers.QueueHandler):
     listener: logging.handlers.QueueListener | None

homeassistant-stubs/util/resource.pyi

@@ -0,0 +1,7 @@
+from _typeshed import Incomplete
+from typing import Final
+
+_LOGGER: Incomplete
+DEFAULT_SOFT_FILE_LIMIT: Final[int]
+
+def set_open_file_descriptor_limit() -> None: ...

homeassistant-stubs/util/ssl.pyi

@@ -13,6 +13,7 @@ SSL_CIPHER_LISTS: Incomplete
 
 @cache
 def _client_context_no_verify(ssl_cipher_list: SSLCipherList) -> ssl.SSLContext: ...
+def _create_client_context(ssl_cipher_list: SSLCipherList = ...) -> ssl.SSLContext: ...
 @cache
 def _client_context(ssl_cipher_list: SSLCipherList = ...) -> ssl.SSLContext: ...
 
@@ -25,6 +26,7 @@ def get_default_context() -> ssl.SSLContext: ...
 def get_default_no_verify_context() -> ssl.SSLContext: ...
 def client_context_no_verify(ssl_cipher_list: SSLCipherList = ...) -> ssl.SSLContext: ...
 def client_context(ssl_cipher_list: SSLCipherList = ...) -> ssl.SSLContext: ...
+def create_client_context(ssl_cipher_list: SSLCipherList = ...) -> ssl.SSLContext: ...
 def create_no_verify_ssl_context(ssl_cipher_list: SSLCipherList = ...) -> ssl.SSLContext: ...
 def server_context_modern() -> ssl.SSLContext: ...
 def server_context_intermediate() -> ssl.SSLContext: ...

homeassistant-stubs/util/timeout.pyi

@@ -1,6 +1,7 @@
 import asyncio
 import enum
 from .async_ import run_callback_threadsafe as run_callback_threadsafe
+from _typeshed import Incomplete
 from types import TracebackType
 from typing import Any, Self
 
@@ -46,7 +47,8 @@ class _GlobalTaskContext:
     _state: _State
     _cool_down: float
     _cancelling: int
-    def __init__(self, manager: TimeoutManager, task: asyncio.Task[Any], timeout: float, cool_down: float) -> None: ...
+    _cancel_message: Incomplete
+    def __init__(self, manager: TimeoutManager, task: asyncio.Task[Any], timeout: float, cool_down: float, cancel_message: str | None) -> None: ...
     async def __aenter__(self) -> Self: ...
     async def __aexit__(self, exc_type: type[BaseException] | None, exc_val: BaseException | None, exc_tb: TracebackType | None) -> bool | None: ...
     @property
@@ -69,7 +71,8 @@ class _ZoneTaskContext:
     _expiration_time: float | None
     _timeout_handler: asyncio.Handle | None
     _cancelling: int
-    def __init__(self, zone: _ZoneTimeoutManager, task: asyncio.Task[Any], timeout: float) -> None: ...
+    _cancel_message: Incomplete
+    def __init__(self, zone: _ZoneTimeoutManager, task: asyncio.Task[Any], timeout: float, cancel_message: str | None) -> None: ...
     @property
     def state(self) -> _State: ...
     async def __aenter__(self) -> Self: ...
@@ -117,6 +120,6 @@ class TimeoutManager:
     @property
     def global_freezes(self) -> list[_GlobalFreezeContext]: ...
     def drop_zone(self, zone_name: str) -> None: ...
-    def async_timeout(self, timeout: float, zone_name: str = ..., cool_down: float = 0) -> _ZoneTaskContext | _GlobalTaskContext: ...
+    def async_timeout(self, timeout: float, zone_name: str = ..., cool_down: float = 0, cancel_message: str | None = None) -> _ZoneTaskContext | _GlobalTaskContext: ...
     def async_freeze(self, zone_name: str = ...) -> _ZoneFreezeContext | _GlobalFreezeContext: ...
     def freeze(self, zone_name: str = ...) -> _ZoneFreezeContext | _GlobalFreezeContext: ...