homeassistant-stubs 2025.9.0b0__py3-none-any.whl → 2026.1.0b0__py3-none-any.whl

homeassistant-stubs/helpers/template/extensions/__init__.pyi

@@ -0,0 +1,14 @@
+from .areas import AreaExtension as AreaExtension
+from .base64 import Base64Extension as Base64Extension
+from .collection import CollectionExtension as CollectionExtension
+from .crypto import CryptoExtension as CryptoExtension
+from .datetime import DateTimeExtension as DateTimeExtension
+from .devices import DeviceExtension as DeviceExtension
+from .floors import FloorExtension as FloorExtension
+from .issues import IssuesExtension as IssuesExtension
+from .labels import LabelExtension as LabelExtension
+from .math import MathExtension as MathExtension
+from .regex import RegexExtension as RegexExtension
+from .string import StringExtension as StringExtension
+
+__all__ = ['AreaExtension', 'Base64Extension', 'CollectionExtension', 'CryptoExtension', 'DateTimeExtension', 'DeviceExtension', 'FloorExtension', 'IssuesExtension', 'LabelExtension', 'MathExtension', 'RegexExtension', 'StringExtension']

homeassistant-stubs/helpers/template/extensions/areas.pyi

@@ -0,0 +1,14 @@
+from .base import BaseTemplateExtension as BaseTemplateExtension, TemplateFunction as TemplateFunction
+from collections.abc import Iterable
+from homeassistant.helpers import area_registry as ar
+from homeassistant.helpers.template import TemplateEnvironment as TemplateEnvironment
+from homeassistant.helpers.template.helpers import resolve_area_id as resolve_area_id
+
+class AreaExtension(BaseTemplateExtension):
+    def __init__(self, environment: TemplateEnvironment) -> None: ...
+    def areas(self) -> Iterable[str | None]: ...
+    def area_id(self, lookup_value: str) -> str | None: ...
+    def _get_area_name(self, area_reg: ar.AreaRegistry, valid_area_id: str) -> str: ...
+    def area_name(self, lookup_value: str) -> str | None: ...
+    def area_entities(self, area_id_or_name: str) -> Iterable[str]: ...
+    def area_devices(self, area_id_or_name: str) -> Iterable[str]: ...

homeassistant-stubs/helpers/template/extensions/base.pyi

@@ -0,0 +1,30 @@
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import TemplateError as TemplateError
+from homeassistant.helpers.template import TemplateEnvironment as TemplateEnvironment
+from jinja2.ext import Extension
+from jinja2.nodes import Node as Node
+from jinja2.parser import Parser as Parser
+from typing import Any, Concatenate, NoReturn
+
+@dataclass
+class TemplateFunction:
+    name: str
+    func: Callable[..., Any] | Any
+    as_global: bool = ...
+    as_filter: bool = ...
+    as_test: bool = ...
+    limited_ok: bool = ...
+    requires_hass: bool = ...
+
+def _pass_context[**_P, _R](func: Callable[Concatenate[Any, _P], _R], jinja_context: Callable[[Callable[Concatenate[Any, _P], _R]], Callable[Concatenate[Any, _P], _R]] = ...) -> Callable[Concatenate[Any, _P], _R]: ...
+
+class BaseTemplateExtension(Extension):
+    environment: TemplateEnvironment
+    def __init__(self, environment: TemplateEnvironment, *, functions: list[TemplateFunction] | None = None) -> None: ...
+    @staticmethod
+    def _create_unsupported_function(name: str) -> Callable[[], NoReturn]: ...
+    @property
+    def hass(self) -> HomeAssistant: ...
+    def parse(self, parser: Parser) -> Node | list[Node]: ...

homeassistant-stubs/helpers/template/extensions/base64.pyi

@@ -0,0 +1,9 @@
+from .base import BaseTemplateExtension as BaseTemplateExtension, TemplateFunction as TemplateFunction
+from homeassistant.helpers.template import TemplateEnvironment as TemplateEnvironment
+
+class Base64Extension(BaseTemplateExtension):
+    def __init__(self, environment: TemplateEnvironment) -> None: ...
+    @staticmethod
+    def base64_encode(value: str | bytes) -> str: ...
+    @staticmethod
+    def base64_decode(value: str, encoding: str | None = 'utf-8') -> str | bytes: ...

homeassistant-stubs/helpers/template/extensions/collection.pyi

@@ -0,0 +1,18 @@
+from .base import BaseTemplateExtension as BaseTemplateExtension, TemplateFunction as TemplateFunction
+from collections.abc import Iterable, MutableSequence
+from homeassistant.helpers.template import TemplateEnvironment as TemplateEnvironment
+from typing import Any
+
+class CollectionExtension(BaseTemplateExtension):
+    def __init__(self, environment: TemplateEnvironment) -> None: ...
+    def flatten(self, value: Iterable[Any], levels: int | None = None) -> list[Any]: ...
+    def shuffle(self, *args: Any, seed: Any = None) -> MutableSequence[Any]: ...
+    def intersect(self, value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
+    def difference(self, value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
+    def union(self, value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
+    def symmetric_difference(self, value: Iterable[Any], other: Iterable[Any]) -> list[Any]: ...
+    def to_set(self, value: Any) -> set[Any]: ...
+    def to_tuple(self, value: Any) -> tuple[Any, ...]: ...
+    def is_list(self, value: Any) -> bool: ...
+    def is_set(self, value: Any) -> bool: ...
+    def is_tuple(self, value: Any) -> bool: ...

homeassistant-stubs/helpers/template/extensions/crypto.pyi

@@ -0,0 +1,13 @@
+from .base import BaseTemplateExtension as BaseTemplateExtension, TemplateFunction as TemplateFunction
+from homeassistant.helpers.template import TemplateEnvironment as TemplateEnvironment
+
+class CryptoExtension(BaseTemplateExtension):
+    def __init__(self, environment: TemplateEnvironment) -> None: ...
+    @staticmethod
+    def md5(value: str) -> str: ...
+    @staticmethod
+    def sha1(value: str) -> str: ...
+    @staticmethod
+    def sha256(value: str) -> str: ...
+    @staticmethod
+    def sha512(value: str) -> str: ...

homeassistant-stubs/helpers/template/extensions/datetime.pyi

@@ -0,0 +1,28 @@
+from .base import BaseTemplateExtension as BaseTemplateExtension, TemplateFunction as TemplateFunction
+from _typeshed import Incomplete
+from datetime import datetime, timedelta
+from homeassistant.helpers.template import TemplateEnvironment as TemplateEnvironment
+from homeassistant.helpers.template.helpers import raise_no_default as raise_no_default
+from homeassistant.helpers.template.render_info import render_info_cv as render_info_cv
+from typing import Any
+
+_SENTINEL: Incomplete
+DATE_STR_FORMAT: str
+
+class DateTimeExtension(BaseTemplateExtension):
+    def __init__(self, environment: TemplateEnvironment) -> None: ...
+    def timestamp_custom(self, value: Any, date_format: str = ..., local: bool = True, default: Any = ...) -> Any: ...
+    def timestamp_local(self, value: Any, default: Any = ...) -> Any: ...
+    def timestamp_utc(self, value: Any, default: Any = ...) -> Any: ...
+    def as_timestamp(self, value: Any, default: Any = ...) -> Any: ...
+    def as_datetime(self, value: Any, default: Any = ...) -> Any: ...
+    def as_timedelta(self, value: str) -> timedelta | None: ...
+    def strptime(self, string: str, fmt: str, default: Any = ...) -> Any: ...
+    def as_local(self, value: datetime) -> datetime: ...
+    def is_datetime(self, value: Any) -> bool: ...
+    def now(self) -> datetime: ...
+    def utcnow(self) -> datetime: ...
+    def today_at(self, time_str: str = '') -> datetime: ...
+    def relative_time(self, value: Any) -> Any: ...
+    def time_since(self, value: Any | datetime, precision: int = 1) -> Any: ...
+    def time_until(self, value: Any | datetime, precision: int = 1) -> Any: ...

homeassistant-stubs/helpers/template/extensions/devices.pyi

@@ -0,0 +1,13 @@
+from .base import BaseTemplateExtension as BaseTemplateExtension, TemplateFunction as TemplateFunction
+from collections.abc import Iterable
+from homeassistant.exceptions import TemplateError as TemplateError
+from homeassistant.helpers.template import TemplateEnvironment as TemplateEnvironment
+from typing import Any
+
+class DeviceExtension(BaseTemplateExtension):
+    def __init__(self, environment: TemplateEnvironment) -> None: ...
+    def device_entities(self, _device_id: str) -> Iterable[str]: ...
+    def device_id(self, entity_id_or_device_name: str) -> str | None: ...
+    def device_name(self, lookup_value: str) -> str | None: ...
+    def device_attr(self, device_or_entity_id: str, attr_name: str) -> Any: ...
+    def is_device_attr(self, device_or_entity_id: str, attr_name: str, attr_value: Any) -> bool: ...

homeassistant-stubs/helpers/template/extensions/floors.pyi

@@ -0,0 +1,14 @@
+from .base import BaseTemplateExtension as BaseTemplateExtension, TemplateFunction as TemplateFunction
+from collections.abc import Iterable
+from homeassistant.helpers.template import TemplateEnvironment as TemplateEnvironment
+from homeassistant.helpers.template.helpers import resolve_area_id as resolve_area_id
+from typing import Any
+
+class FloorExtension(BaseTemplateExtension):
+    def __init__(self, environment: TemplateEnvironment) -> None: ...
+    def floors(self) -> Iterable[str | None]: ...
+    def floor_id(self, lookup_value: Any) -> str | None: ...
+    def floor_name(self, lookup_value: str) -> str | None: ...
+    def _floor_id_or_name(self, floor_id_or_name: str) -> str | None: ...
+    def floor_areas(self, floor_id_or_name: str) -> Iterable[str]: ...
+    def floor_entities(self, floor_id_or_name: str) -> Iterable[str]: ...

homeassistant-stubs/helpers/template/extensions/issues.pyi

@@ -0,0 +1,8 @@
+from .base import BaseTemplateExtension as BaseTemplateExtension, TemplateFunction as TemplateFunction
+from homeassistant.helpers.template import TemplateEnvironment as TemplateEnvironment
+from typing import Any
+
+class IssuesExtension(BaseTemplateExtension):
+    def __init__(self, environment: TemplateEnvironment) -> None: ...
+    def issues(self) -> dict[tuple[str, str], dict[str, Any]]: ...
+    def issue(self, domain: str, issue_id: str) -> dict[str, Any] | None: ...

homeassistant-stubs/helpers/template/extensions/labels.pyi

@@ -0,0 +1,15 @@
+from .base import BaseTemplateExtension as BaseTemplateExtension, TemplateFunction as TemplateFunction
+from collections.abc import Iterable
+from homeassistant.helpers.template import TemplateEnvironment as TemplateEnvironment
+from typing import Any
+
+class LabelExtension(BaseTemplateExtension):
+    def __init__(self, environment: TemplateEnvironment) -> None: ...
+    def labels(self, lookup_value: Any = None) -> Iterable[str | None]: ...
+    def label_id(self, lookup_value: Any) -> str | None: ...
+    def label_name(self, lookup_value: str) -> str | None: ...
+    def label_description(self, lookup_value: str) -> str | None: ...
+    def _label_id_or_name(self, label_id_or_name: str) -> str | None: ...
+    def label_areas(self, label_id_or_name: str) -> Iterable[str]: ...
+    def label_devices(self, label_id_or_name: str) -> Iterable[str]: ...
+    def label_entities(self, label_id_or_name: str) -> Iterable[str]: ...

homeassistant-stubs/helpers/template/extensions/math.pyi

@@ -0,0 +1,49 @@
+from .base import BaseTemplateExtension as BaseTemplateExtension, TemplateFunction as TemplateFunction
+from _typeshed import Incomplete
+from homeassistant.helpers.template import TemplateEnvironment as TemplateEnvironment
+from homeassistant.helpers.template.helpers import raise_no_default as raise_no_default
+from typing import Any, Literal
+
+_SENTINEL: Incomplete
+
+class MathExtension(BaseTemplateExtension):
+    def __init__(self, environment: TemplateEnvironment) -> None: ...
+    @staticmethod
+    def logarithm(value: Any, base: Any = ..., default: Any = ...) -> Any: ...
+    @staticmethod
+    def sine(value: Any, default: Any = ...) -> Any: ...
+    @staticmethod
+    def cosine(value: Any, default: Any = ...) -> Any: ...
+    @staticmethod
+    def tangent(value: Any, default: Any = ...) -> Any: ...
+    @staticmethod
+    def arc_sine(value: Any, default: Any = ...) -> Any: ...
+    @staticmethod
+    def arc_cosine(value: Any, default: Any = ...) -> Any: ...
+    @staticmethod
+    def arc_tangent(value: Any, default: Any = ...) -> Any: ...
+    @staticmethod
+    def arc_tangent2(*args: Any, default: Any = ...) -> Any: ...
+    @staticmethod
+    def square_root(value: Any, default: Any = ...) -> Any: ...
+    @staticmethod
+    def average(*args: Any, default: Any = ...) -> Any: ...
+    @staticmethod
+    def median(*args: Any, default: Any = ...) -> Any: ...
+    @staticmethod
+    def statistical_mode(*args: Any, default: Any = ...) -> Any: ...
+    def min_max_from_filter(self, builtin_filter: Any, name: str) -> Any: ...
+    def min_max_min(self, *args: Any, **kwargs: Any) -> Any: ...
+    def min_max_max(self, *args: Any, **kwargs: Any) -> Any: ...
+    @staticmethod
+    def bitwise_and(first_value: Any, second_value: Any) -> Any: ...
+    @staticmethod
+    def bitwise_or(first_value: Any, second_value: Any) -> Any: ...
+    @staticmethod
+    def bitwise_xor(first_value: Any, second_value: Any) -> Any: ...
+    @staticmethod
+    def clamp(value: Any, min_value: Any, max_value: Any) -> Any: ...
+    @staticmethod
+    def wrap(value: Any, min_value: Any, max_value: Any) -> Any: ...
+    @staticmethod
+    def remap(value: Any, in_min: Any, in_max: Any, out_min: Any, out_max: Any, *, steps: int = 0, edges: Literal['none', 'clamp', 'wrap', 'mirror'] = 'none') -> Any: ...

homeassistant-stubs/helpers/template/extensions/regex.pyi

@@ -0,0 +1,14 @@
+from .base import BaseTemplateExtension as BaseTemplateExtension, TemplateFunction as TemplateFunction
+from _typeshed import Incomplete
+from homeassistant.helpers.template import TemplateEnvironment as TemplateEnvironment
+from typing import Any
+
+_regex_cache: Incomplete
+
+class RegexExtension(BaseTemplateExtension):
+    def __init__(self, environment: TemplateEnvironment) -> None: ...
+    def regex_match(self, value: Any, find: str = '', ignorecase: bool = False) -> bool: ...
+    def regex_replace(self, value: Any = '', find: str = '', replace: str = '', ignorecase: bool = False) -> str: ...
+    def regex_search(self, value: Any, find: str = '', ignorecase: bool = False) -> bool: ...
+    def regex_findall_index(self, value: Any, find: str = '', index: int = 0, ignorecase: bool = False) -> str: ...
+    def regex_findall(self, value: Any, find: str = '', ignorecase: bool = False) -> list[str]: ...

homeassistant-stubs/helpers/template/extensions/string.pyi

@@ -0,0 +1,9 @@
+from .base import BaseTemplateExtension as BaseTemplateExtension, TemplateFunction as TemplateFunction
+from homeassistant.helpers.template import TemplateEnvironment as TemplateEnvironment
+from typing import Any
+
+class StringExtension(BaseTemplateExtension):
+    def __init__(self, environment: TemplateEnvironment) -> None: ...
+    def ordinal(self, value: Any) -> str: ...
+    def slugify(self, value: Any, separator: str = '_') -> str: ...
+    def urlencode(self, value: Any) -> bytes: ...

homeassistant-stubs/helpers/template/helpers.pyi

@@ -0,0 +1,6 @@
+from .context import template_cv as template_cv
+from homeassistant.core import HomeAssistant as HomeAssistant
+from typing import Any, NoReturn
+
+def raise_no_default(function: str, value: Any) -> NoReturn: ...
+def resolve_area_id(hass: HomeAssistant, lookup_value: Any) -> str | None: ...

homeassistant-stubs/helpers/template/render_info.pyi

@@ -0,0 +1,39 @@
+import collections.abc
+from . import Template as Template
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+from contextvars import ContextVar
+from homeassistant.core import split_entity_id as split_entity_id
+from homeassistant.exceptions import TemplateError as TemplateError
+
+ALL_STATES_RATE_LIMIT: int
+DOMAIN_STATES_RATE_LIMIT: int
+render_info_cv: ContextVar[RenderInfo | None]
+
+def _true(entity_id: str) -> bool: ...
+def _false(entity_id: str) -> bool: ...
+
+class RenderInfo:
+    __slots__: Incomplete
+    template: Incomplete
+    filter_lifecycle: Callable[[str], bool]
+    filter: Callable[[str], bool]
+    _result: str | None
+    is_static: bool
+    exception: TemplateError | None
+    all_states: bool
+    all_states_lifecycle: bool
+    domains: collections.abc.Set[str]
+    domains_lifecycle: collections.abc.Set[str]
+    entities: collections.abc.Set[str]
+    rate_limit: float | None
+    has_time: bool
+    def __init__(self, template: Template) -> None: ...
+    def __repr__(self) -> str: ...
+    def _filter_domains_and_entities(self, entity_id: str) -> bool: ...
+    def _filter_entities(self, entity_id: str) -> bool: ...
+    def _filter_lifecycle_domains(self, entity_id: str) -> bool: ...
+    def result(self) -> str: ...
+    def _freeze_static(self) -> None: ...
+    def _freeze_sets(self) -> None: ...
+    def _freeze(self) -> None: ...

homeassistant-stubs/helpers/trigger.pyi

@@ -1,49 +1,157 @@
 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
+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, 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_SELECTOR as CONF_SELECTOR, 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 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 homeassistant.util.yaml import load_yaml_dict as load_yaml_dict
-from typing import Any, Protocol, TypedDict
+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_SCHEMA: Incomplete
-_TRIGGER_SCHEMA: Incomplete
+_FIELD_DESCRIPTION_SCHEMA: Incomplete
+_TRIGGER_DESCRIPTION_SCHEMA: Incomplete
 
 def starts_with_dot(key: str) -> str: ...
 
-_TRIGGERS_SCHEMA: Incomplete
+_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):
-    def __init__(self, hass: HomeAssistant, config: ConfigType) -> None: ...
+    _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
-    async def async_attach(self, action: TriggerActionType, trigger_info: TriggerInfo) -> CALLBACK_TYPE: ...
+    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]]: ...
@@ -51,9 +159,25 @@ class TriggerProtocol(Protocol):
     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
@@ -69,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
@@ -91,6 +215,7 @@ class PluggableAction:
 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]]: ...

homeassistant-stubs/helpers/trigger_template_entity.pyi

@@ -1,6 +1,7 @@
 import voluptuous as vol
 from .entity import Entity as Entity
-from .template import Template as Template, TemplateStateFromEntityId as TemplateStateFromEntityId, _SENTINEL as _SENTINEL, _render_with_context as _render_with_context, render_complex as render_complex, result_as_boolean as result_as_boolean
+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, SensorDeviceClass as SensorDeviceClass, SensorEntity as SensorEntity

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: ...
@@ -214,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: ...