homeassistant-stubs 2023.8.4__py3-none-any.whl → 2023.9.0__py3-none-any.whl

homeassistant-stubs/data_entry_flow.pyi

@@ -30,9 +30,7 @@ RESULT_TYPE_SHOW_PROGRESS_DONE: str
 RESULT_TYPE_MENU: str
 EVENT_DATA_ENTRY_FLOW_PROGRESSED: str
 
-class BaseServiceInfo:
-    def __mypy-replace() -> None: ...
-
+class BaseServiceInfo: ...
 class FlowError(HomeAssistantError): ...
 class UnknownHandler(FlowError): ...
 class UnknownFlow(FlowError): ...
@@ -56,6 +54,7 @@ class FlowResult(TypedDict, total=False):
     last_step: bool | None
     menu_options: list[str] | dict[str, str]
     options: Mapping[str, Any]
+    preview: str | None
     progress_action: str
     reason: str
     required: bool
@@ -70,6 +69,7 @@ def _async_flow_handler_to_flow_result(flows: Iterable[FlowHandler], include_uni
 
 class FlowManager(abc.ABC, metaclass=abc.ABCMeta):
     hass: Incomplete
+    _preview: Incomplete
     _progress: Incomplete
     _handler_progress_index: Incomplete
     _init_data_process_index: Incomplete
@@ -92,6 +92,7 @@ class FlowManager(abc.ABC, metaclass=abc.ABCMeta):
     def _async_remove_flow_from_index(self, flow: FlowHandler) -> None: ...
     def _async_remove_flow_progress(self, flow_id: str) -> None: ...
     async def _async_handle_step(self, flow: FlowHandler, step_id: str, user_input: dict | BaseServiceInfo | None) -> FlowResult: ...
+    async def _async_setup_preview(self, flow: FlowHandler) -> None: ...
 
 class FlowHandler:
     cur_step: FlowResult | None
@@ -107,7 +108,7 @@ class FlowHandler:
     @property
     def show_advanced_options(self) -> bool: ...
     def add_suggested_values_to_schema(self, data_schema: vol.Schema, suggested_values: Mapping[str, Any] | None) -> vol.Schema: ...
-    def async_show_form(self, *, step_id: str, data_schema: vol.Schema | None = ..., errors: dict[str, str] | None = ..., description_placeholders: Mapping[str, str | None] | None = ..., last_step: bool | None = ...) -> FlowResult: ...
+    def async_show_form(self, *, step_id: str, data_schema: vol.Schema | None = ..., errors: dict[str, str] | None = ..., description_placeholders: Mapping[str, str | None] | None = ..., last_step: bool | None = ..., preview: str | None = ...) -> FlowResult: ...
     def async_create_entry(self, *, title: str | None = ..., data: Mapping[str, Any], description: str | None = ..., description_placeholders: Mapping[str, str] | None = ...) -> FlowResult: ...
     def async_abort(self, *, reason: str, description_placeholders: Mapping[str, str] | None = ...) -> FlowResult: ...
     def async_external_step(self, *, step_id: str, url: str, description_placeholders: Mapping[str, str] | None = ...) -> FlowResult: ...
@@ -116,5 +117,7 @@ class FlowHandler:
     def async_show_progress_done(self, *, next_step_id: str) -> FlowResult: ...
     def async_show_menu(self, *, step_id: str, menu_options: list[str] | dict[str, str], description_placeholders: Mapping[str, str] | None = ...) -> FlowResult: ...
     def async_remove(self) -> None: ...
+    @staticmethod
+    async def async_setup_preview(hass: HomeAssistant) -> None: ...
 
 def _create_abort_data(flow_id: str, handler: str, reason: str, description_placeholders: Mapping[str, str] | None = ...) -> FlowResult: ...

homeassistant-stubs/exceptions.pyi

@@ -16,13 +16,11 @@ class ConditionError(HomeAssistantError):
     def output(self, indent: int) -> Generator[str, None, None]: ...
     def __str__(self) -> str: ...
     def __init__(self, type) -> None: ...
-    def __mypy-replace(*, type) -> None: ...
 
 class ConditionErrorMessage(ConditionError):
     message: str
     def output(self, indent: int) -> Generator[str, None, None]: ...
     def __init__(self, type, message) -> None: ...
-    def __mypy-replace(*, type, message) -> None: ...
 
 class ConditionErrorIndex(ConditionError):
     index: int
@@ -30,13 +28,11 @@ class ConditionErrorIndex(ConditionError):
     error: ConditionError
     def output(self, indent: int) -> Generator[str, None, None]: ...
     def __init__(self, type, index, total, error) -> None: ...
-    def __mypy-replace(*, type, index, total, error) -> None: ...
 
 class ConditionErrorContainer(ConditionError):
     errors: Sequence[ConditionError]
     def output(self, indent: int) -> Generator[str, None, None]: ...
     def __init__(self, type, errors) -> None: ...
-    def __mypy-replace(*, type, errors) -> None: ...
 
 class IntegrationError(HomeAssistantError):
     def __str__(self) -> str: ...

homeassistant-stubs/helpers/collection.pyi

@@ -31,7 +31,6 @@ class CollectionChangeSet:
     item_id: str
     item: Any
     def __init__(self, change_type, item_id, item) -> None: ...
-    def __mypy-replace(*, change_type, item_id, item) -> None: ...
 ChangeListener = Callable[[str, str, dict], Awaitable[None]]
 ChangeSetListener = Callable[[Iterable[CollectionChangeSet]], Awaitable[None]]
 

homeassistant-stubs/helpers/deprecation.pyi

@@ -1,10 +1,11 @@
 from ..helpers.frame import MissingIntegrationFrame as MissingIntegrationFrame, get_integration_frame as get_integration_frame
+from _typeshed import Incomplete
 from collections.abc import Callable as Callable
-from typing import Any, ParamSpec, TypeVar
+from typing import Any, TypeVar
 
 _ObjectT = TypeVar('_ObjectT', bound=object)
 _R = TypeVar('_R')
-_P = ParamSpec('_P')
+_P: Incomplete
 
 def deprecated_substitute(substitute_name: str) -> Callable[[Callable[[_ObjectT], Any]], Callable[[_ObjectT], Any]]: ...
 def get_deprecated(config: dict[str, Any], new_name: str, old_name: str, default: Any | None = ...) -> Any | None: ...

homeassistant-stubs/helpers/device_registry.pyi

@@ -1,6 +1,5 @@
 from . import entity_registry as entity_registry, storage as storage
 from .debounce import Debouncer as Debouncer
-from .entity import DeviceInfo as DeviceInfo
 from .frame import report as report
 from .json import JSON_DUMP as JSON_DUMP, find_paths_unserializable_data as find_paths_unserializable_data
 from .typing import UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
@@ -40,6 +39,23 @@ class DeviceEntryDisabler(StrEnum):
 DISABLED_CONFIG_ENTRY: Incomplete
 DISABLED_INTEGRATION: Incomplete
 DISABLED_USER: Incomplete
+
+class DeviceInfo(TypedDict, total=False):
+    configuration_url: str | URL | None
+    connections: set[tuple[str, str]]
+    default_manufacturer: str
+    default_model: str
+    default_name: str
+    entry_type: DeviceEntryType | None
+    identifiers: set[tuple[str, str]]
+    manufacturer: str | None
+    model: str | None
+    name: str | None
+    suggested_area: str | None
+    sw_version: str | None
+    hw_version: str | None
+    via_device: tuple[str, str]
+
 DEVICE_INFO_TYPES: Incomplete
 DEVICE_INFO_KEYS: Incomplete
 
@@ -62,7 +78,7 @@ class DeviceInfoError(HomeAssistantError):
     domain: Incomplete
     def __init__(self, domain: str, device_info: DeviceInfo, message: str) -> None: ...
 
-def _validate_device_info(config_entry: ConfigEntry | None, device_info: DeviceInfo) -> str: ...
+def _validate_device_info(config_entry: ConfigEntry, device_info: DeviceInfo) -> str: ...
 def _validate_configuration_url(value: Any) -> str | None: ...
 
 class DeviceEntry:

homeassistant-stubs/helpers/entity.pyi

@@ -1,6 +1,6 @@
 import asyncio
 from . import device_registry as dr, entity_registry as er
-from .device_registry import DeviceEntryType as DeviceEntryType, EventDeviceRegistryUpdatedData as EventDeviceRegistryUpdatedData
+from .device_registry import DeviceInfo as DeviceInfo, EventDeviceRegistryUpdatedData as EventDeviceRegistryUpdatedData
 from .entity_platform import EntityPlatform as EntityPlatform
 from .event import async_track_device_registry_updated_event as async_track_device_registry_updated_event, async_track_entity_registry_updated_event as async_track_entity_registry_updated_event
 from .typing import EventType as EventType, StateType as StateType, UNDEFINED as UNDEFINED, UndefinedType as UndefinedType
@@ -13,11 +13,10 @@ from homeassistant.backports.functools import cached_property as cached_property
 from homeassistant.config import DATA_CUSTOMIZE as DATA_CUSTOMIZE
 from homeassistant.const import ATTR_ASSUMED_STATE as ATTR_ASSUMED_STATE, ATTR_ATTRIBUTION as ATTR_ATTRIBUTION, ATTR_DEVICE_CLASS as ATTR_DEVICE_CLASS, ATTR_ENTITY_PICTURE as ATTR_ENTITY_PICTURE, ATTR_FRIENDLY_NAME as ATTR_FRIENDLY_NAME, ATTR_ICON as ATTR_ICON, ATTR_SUPPORTED_FEATURES as ATTR_SUPPORTED_FEATURES, ATTR_UNIT_OF_MEASUREMENT as ATTR_UNIT_OF_MEASUREMENT, DEVICE_DEFAULT_NAME as DEVICE_DEFAULT_NAME, EntityCategory as EntityCategory, STATE_OFF as STATE_OFF, STATE_ON as STATE_ON, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN
 from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, Context as Context, HomeAssistant as HomeAssistant, callback as callback
-from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, NoEntitySpecifiedError as NoEntitySpecifiedError
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, InvalidStateError as InvalidStateError, NoEntitySpecifiedError as NoEntitySpecifiedError
 from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util import ensure_unique_string as ensure_unique_string, slugify as slugify
-from typing import Any, Final, Literal, TypeVar, TypedDict
-from yarl import URL
+from typing import Any, Final, Literal, TypeVar
 
 _T = TypeVar('_T')
 _LOGGER: Incomplete
@@ -36,22 +35,6 @@ def get_device_class(hass: HomeAssistant, entity_id: str) -> str | None: ...
 def get_supported_features(hass: HomeAssistant, entity_id: str) -> int: ...
 def get_unit_of_measurement(hass: HomeAssistant, entity_id: str) -> str | None: ...
 
-class DeviceInfo(TypedDict, total=False):
-    configuration_url: str | URL | None
-    connections: set[tuple[str, str]]
-    default_manufacturer: str
-    default_model: str
-    default_name: str
-    entry_type: DeviceEntryType | None
-    identifiers: set[tuple[str, str]]
-    manufacturer: str | None
-    model: str | None
-    name: str | None
-    suggested_area: str | None
-    sw_version: str | None
-    hw_version: str | None
-    via_device: tuple[str, str]
-
 ENTITY_CATEGORIES_SCHEMA: Final[Incomplete]
 
 class EntityPlatformState(Enum):
@@ -72,7 +55,6 @@ class EntityDescription:
     translation_key: str | None
     unit_of_measurement: str | None
     def __init__(self, key, device_class, entity_category, entity_registry_enabled_default, entity_registry_visible_default, force_update, icon, has_entity_name, name, translation_key, unit_of_measurement) -> None: ...
-    def __mypy-replace(*, key, device_class, entity_category, entity_registry_enabled_default, entity_registry_visible_default, force_update, icon, has_entity_name, name, translation_key, unit_of_measurement) -> None: ...
 
 class Entity(ABC):
     entity_id: str
@@ -182,6 +164,7 @@ class Entity(ABC):
     def async_write_ha_state(self) -> None: ...
     def _stringify_state(self, available: bool) -> str: ...
     def _friendly_name_internal(self) -> str | None: ...
+    def _async_generate_attributes(self) -> tuple[str, dict[str, Any]]: ...
     def _async_write_ha_state(self) -> None: ...
     def schedule_update_ha_state(self, force_refresh: bool = ...) -> None: ...
     def async_schedule_update_ha_state(self, force_refresh: bool = ...) -> None: ...
@@ -209,7 +192,6 @@ class Entity(ABC):
 
 class ToggleEntityDescription(EntityDescription):
     def __init__(self, key, device_class, entity_category, entity_registry_enabled_default, entity_registry_visible_default, force_update, icon, has_entity_name, name, translation_key, unit_of_measurement) -> None: ...
-    def __mypy-replace(*, key, device_class, entity_category, entity_registry_enabled_default, entity_registry_visible_default, force_update, icon, has_entity_name, name, translation_key, unit_of_measurement) -> None: ...
 
 class ToggleEntity(Entity):
     entity_description: ToggleEntityDescription

homeassistant-stubs/helpers/entity_registry.pyi

@@ -13,8 +13,7 @@ from homeassistant.exceptions import MaxLengthExceeded as MaxLengthExceeded
 from homeassistant.util import slugify as slugify
 from homeassistant.util.json import format_unserializable_data as format_unserializable_data
 from homeassistant.util.read_only_dict import ReadOnlyDict as ReadOnlyDict
-from typing import Any, Literal, TypeVar, TypedDict
-from typing_extensions import NotRequired
+from typing import Any, Literal, NotRequired, TypeVar, TypedDict
 
 T = TypeVar('T')
 DATA_REGISTRY: str

homeassistant-stubs/helpers/event.pyi

@@ -13,7 +13,7 @@ from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, HassJob as HassJo
 from homeassistant.exceptions import TemplateError as TemplateError
 from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util.async_ import run_callback_threadsafe as run_callback_threadsafe
-from typing import Any, Concatenate, ParamSpec, TypeVar, TypedDict
+from typing import Any, Concatenate, TypeVar, TypedDict
 
 TRACK_STATE_CHANGE_CALLBACKS: str
 TRACK_STATE_CHANGE_LISTENER: str
@@ -32,28 +32,25 @@ _LOGGER: Incomplete
 RANDOM_MICROSECOND_MIN: int
 RANDOM_MICROSECOND_MAX: int
 _TypedDictT = TypeVar('_TypedDictT', bound=Mapping[str, Any])
-_P = ParamSpec('_P')
+_P: Incomplete
 
 class TrackStates:
     all_states: bool
     entities: set[str]
     domains: set[str]
     def __init__(self, all_states, entities, domains) -> None: ...
-    def __mypy-replace(*, all_states, entities, domains) -> None: ...
 
 class TrackTemplate:
     template: Template
     variables: TemplateVarsType
     rate_limit: timedelta | None
     def __init__(self, template, variables, rate_limit) -> None: ...
-    def __mypy-replace(*, template, variables, rate_limit) -> None: ...
 
 class TrackTemplateResult:
     template: Template
     last_result: Any
     result: Any
     def __init__(self, template, last_result, result) -> None: ...
-    def __mypy-replace(*, template, last_result, result) -> None: ...
 
 class EventStateChangedData(TypedDict):
     entity_id: str
@@ -121,7 +118,7 @@ class TrackTemplateResultInfo:
     _time_listeners: Incomplete
     def __init__(self, hass: HomeAssistant, track_templates: Sequence[TrackTemplate], action: TrackTemplateResultListener, has_super_template: bool = ...) -> None: ...
     def __repr__(self) -> str: ...
-    def async_setup(self, raise_on_template_error: bool, strict: bool = ...) -> None: ...
+    def async_setup(self, raise_on_template_error: bool, strict: bool = ..., log_fn: Callable[[int, str], None] | None = ...) -> None: ...
     @property
     def listeners(self) -> dict[str, bool | set[str]]: ...
     def _setup_time_listener(self, template: Template, has_time: bool) -> None: ...
@@ -135,7 +132,7 @@ class TrackTemplateResultInfo:
 
 TrackTemplateResultListener: Incomplete
 
-def async_track_template_result(hass: HomeAssistant, track_templates: Sequence[TrackTemplate], action: TrackTemplateResultListener, raise_on_template_error: bool = ..., strict: bool = ..., has_super_template: bool = ...) -> TrackTemplateResultInfo: ...
+def async_track_template_result(hass: HomeAssistant, track_templates: Sequence[TrackTemplate], action: TrackTemplateResultListener, raise_on_template_error: bool = ..., strict: bool = ..., log_fn: Callable[[int, str], None] | None = ..., has_super_template: bool = ...) -> TrackTemplateResultInfo: ...
 def async_track_same_state(hass: HomeAssistant, period: timedelta, action: Callable[[], Coroutine[Any, Any, None] | None], async_check_same_func: Callable[[str, State | None, State | None], bool], entity_ids: str | Iterable[str] = ...) -> CALLBACK_TYPE: ...
 
 track_same_state: Incomplete
@@ -148,6 +145,7 @@ def async_track_point_in_utc_time(hass: HomeAssistant, action: HassJob[[datetime
 
 track_point_in_utc_time: Incomplete
 
+def async_call_at(hass: HomeAssistant, action: HassJob[[datetime], Coroutine[Any, Any, None] | None] | Callable[[datetime], Coroutine[Any, Any, None] | None], loop_time: float) -> CALLBACK_TYPE: ...
 def async_call_later(hass: HomeAssistant, delay: float | timedelta, action: HassJob[[datetime], Coroutine[Any, Any, None] | None] | Callable[[datetime], Coroutine[Any, Any, None] | None]) -> CALLBACK_TYPE: ...
 
 call_later: Incomplete

homeassistant-stubs/helpers/integration_platform.pyi

@@ -14,7 +14,6 @@ class IntegrationPlatform:
     process_platform: Callable[[HomeAssistant, str, Any], Awaitable[None]]
     seen_components: set[str]
     def __init__(self, platform_name, process_platform, seen_components) -> None: ...
-    def __mypy-replace(*, platform_name, process_platform, seen_components) -> None: ...
 
 async def _async_process_single_integration_platform_component(hass: HomeAssistant, component_name: str, integration: Integration | Exception, integration_platform: IntegrationPlatform) -> None: ...
 async def async_process_integration_platform_for_component(hass: HomeAssistant, component_name: str) -> None: ...

homeassistant-stubs/helpers/intent.pyi

@@ -106,7 +106,6 @@ class IntentResponseTarget:
     type: IntentResponseTargetType
     id: str | None
     def __init__(self, name, type, id) -> None: ...
-    def __mypy-replace(*, name, type, id) -> None: ...
 
 class IntentResponse:
     language: Incomplete

homeassistant-stubs/helpers/issue_registry.pyi

@@ -35,7 +35,6 @@ class IssueEntry:
     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: ...
-    def __mypy-replace(*, 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]: ...
@@ -43,8 +42,9 @@ class IssueRegistryStore(Store[dict[str, list[dict[str, Any]]]]):
 class IssueRegistry:
     hass: Incomplete
     issues: Incomplete
+    _read_only: Incomplete
     _store: Incomplete
-    def __init__(self, hass: HomeAssistant) -> None: ...
+    def __init__(self, hass: HomeAssistant, *, read_only: bool = ...) -> None: ...
     def async_get_issue(self, domain: str, issue_id: str) -> IssueEntry | None: ...
     def async_get_or_create(self, domain: str, issue_id: str, *, breaks_in_ha_version: str | None = ..., data: dict[str, str | int | float | None] | None = ..., is_fixable: bool, is_persistent: bool, issue_domain: str | None = ..., learn_more_url: str | None = ..., severity: IssueSeverity, translation_key: str, translation_placeholders: dict[str, str] | None = ...) -> IssueEntry: ...
     def async_delete(self, domain: str, issue_id: str) -> None: ...
@@ -54,7 +54,7 @@ class IssueRegistry:
     def _data_to_save(self) -> dict[str, list[dict[str, str | None]]]: ...
 
 def async_get(hass: HomeAssistant) -> IssueRegistry: ...
-async def async_load(hass: HomeAssistant) -> None: ...
+async def async_load(hass: HomeAssistant, *, read_only: bool = ...) -> None: ...
 def async_create_issue(hass: HomeAssistant, domain: str, issue_id: str, *, breaks_in_ha_version: str | None = ..., data: dict[str, str | int | float | None] | None = ..., is_fixable: bool, is_persistent: bool = ..., issue_domain: str | None = ..., learn_more_url: str | None = ..., severity: IssueSeverity, translation_key: str, translation_placeholders: dict[str, str] | None = ...) -> None: ...
 def create_issue(hass: HomeAssistant, domain: str, issue_id: str, *, breaks_in_ha_version: str | None = ..., data: dict[str, str | int | float | None] | None = ..., is_fixable: bool, is_persistent: bool = ..., issue_domain: str | None = ..., learn_more_url: str | None = ..., severity: IssueSeverity, translation_key: str, translation_placeholders: dict[str, str] | None = ...) -> None: ...
 def async_delete_issue(hass: HomeAssistant, domain: str, issue_id: str) -> None: ...

homeassistant-stubs/helpers/recorder.pyi

@@ -8,7 +8,6 @@ class RecorderData:
     recorder_platforms: dict[str, Any]
     db_connected: asyncio.Future
     def __init__(self, recorder_platforms, db_connected) -> None: ...
-    def __mypy-replace(*, recorder_platforms, db_connected) -> None: ...
 
 def async_migration_in_progress(hass: HomeAssistant) -> bool: ...
 def async_initialize_recorder(hass: HomeAssistant) -> None: ...

homeassistant-stubs/helpers/schema_config_entry_flow.pyi

@@ -11,22 +11,19 @@ from homeassistant.data_entry_flow import FlowResult as FlowResult, UnknownHandl
 from typing import Any
 
 class SchemaFlowError(Exception): ...
-
-class SchemaFlowStep:
-    def __mypy-replace() -> None: ...
+class SchemaFlowStep: ...
 
 class SchemaFlowFormStep(SchemaFlowStep):
     schema: vol.Schema | Callable[[SchemaCommonFlowHandler], Coroutine[Any, Any, vol.Schema | None]] | None
     validate_user_input: Callable[[SchemaCommonFlowHandler, dict[str, Any]], Coroutine[Any, Any, dict[str, Any]]] | None
     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
-    def __init__(self, schema, validate_user_input, next_step, suggested_values) -> None: ...
-    def __mypy-replace(*, schema, validate_user_input, next_step, suggested_values) -> None: ...
+    preview: str | None
+    def __init__(self, schema, validate_user_input, next_step, suggested_values, preview) -> None: ...
 
 class SchemaFlowMenuStep(SchemaFlowStep):
     options: list[str] | dict[str, str]
     def __init__(self, options) -> None: ...
-    def __mypy-replace(*, options) -> None: ...
 
 class SchemaCommonFlowHandler:
     _flow: Incomplete
@@ -54,6 +51,8 @@ class SchemaConfigFlowHandler(config_entries.ConfigFlow, ABC, metaclass=abc.ABCM
     def __init_subclass__(cls, **kwargs: Any) -> None: ...
     _common_handler: Incomplete
     def __init__(self) -> None: ...
+    @staticmethod
+    async def async_setup_preview(hass: HomeAssistant) -> None: ...
     @classmethod
     def async_supports_options_flow(cls, config_entry: config_entries.ConfigEntry) -> bool: ...
     @staticmethod
@@ -68,7 +67,7 @@ class SchemaConfigFlowHandler(config_entries.ConfigFlow, ABC, metaclass=abc.ABCM
 class SchemaOptionsFlowHandler(config_entries.OptionsFlowWithConfigEntry):
     _common_handler: Incomplete
     _async_options_flow_finished: Incomplete
-    def __init__(self, config_entry: config_entries.ConfigEntry, options_flow: Mapping[str, SchemaFlowStep], async_options_flow_finished: Callable[[HomeAssistant, Mapping[str, Any]], None] | None = ...) -> None: ...
+    def __init__(self, config_entry: config_entries.ConfigEntry, options_flow: Mapping[str, SchemaFlowStep], async_options_flow_finished: Callable[[HomeAssistant, Mapping[str, Any]], None] | None = ..., async_setup_preview: Callable[[HomeAssistant], Coroutine[Any, Any, None]] | None = ...) -> None: ...
     @staticmethod
     def _async_step(step_id: str) -> Callable: ...
     def async_create_entry(self, data: Mapping[str, Any], **kwargs: Any) -> FlowResult: ...

homeassistant-stubs/helpers/script.pyi

@@ -83,7 +83,7 @@ class _ScriptRun:
     async def _async_get_condition(self, config): ...
     def _log(self, msg: str, *args: Any, level: int = ..., **kwargs: Any) -> None: ...
     def _step_log(self, default_message, timeout: Incomplete | None = ...) -> None: ...
-    async def async_run(self) -> ServiceResponse: ...
+    async def async_run(self) -> ScriptRunResult | None: ...
     async def _async_step(self, log_exceptions) -> None: ...
     def _finish(self) -> None: ...
     async def async_stop(self) -> None: ...
@@ -130,6 +130,11 @@ class _IfData(TypedDict):
     if_then: Script
     if_else: Script | None
 
+class ScriptRunResult:
+    service_response: ServiceResponse
+    variables: dict
+    def __init__(self, service_response, variables) -> None: ...
+
 class Script:
     top_level: Incomplete
     _hass: Incomplete
@@ -185,7 +190,7 @@ class Script:
     @staticmethod
     def _find_referenced_entities(referenced: set[str], sequence: Sequence[dict[str, Any]]) -> None: ...
     def run(self, variables: _VarsType | None = ..., context: Context | None = ...) -> None: ...
-    async def async_run(self, run_variables: _VarsType | None = ..., context: Context | None = ..., started_action: Callable[..., Any] | None = ...) -> ServiceResponse: ...
+    async def async_run(self, run_variables: _VarsType | None = ..., context: Context | None = ..., started_action: Callable[..., Any] | None = ...) -> ScriptRunResult | None: ...
     async def _async_stop(self, aws: list[asyncio.Task], update_state: bool, spare: _ScriptRun | None) -> None: ...
     async def async_stop(self, update_state: bool = ..., spare: _ScriptRun | None = ...) -> None: ...
     async def _async_get_condition(self, config): ...

homeassistant-stubs/helpers/selector.pyi

@@ -289,6 +289,7 @@ class SelectSelectorConfig(TypedDict, total=False):
     custom_value: bool
     mode: SelectSelectorMode
     translation_key: str
+    sort: bool
 
 class SelectSelector(Selector[SelectSelectorConfig]):
     selector_type: str

homeassistant-stubs/helpers/sensor.pyi

@@ -1,4 +1,4 @@
-from .entity import DeviceInfo as DeviceInfo
+from .device_registry import DeviceInfo as DeviceInfo
 from homeassistant import const as const
 from sensor_state_data import SensorDeviceInfo as SensorDeviceInfo
 

homeassistant-stubs/helpers/service.pyi

@@ -53,7 +53,6 @@ class SelectedEntities:
     referenced_devices: set[str]
     def log_missing(self, missing_entities: set[str]) -> None: ...
     def __init__(self, referenced, indirectly_referenced, missing_devices, missing_areas, referenced_devices) -> None: ...
-    def __mypy-replace(*, referenced, indirectly_referenced, missing_devices, missing_areas, referenced_devices) -> None: ...
 
 def call_from_config(hass: HomeAssistant, config: ConfigType, blocking: bool = ..., variables: TemplateVarsType = ..., validate_config: bool = ...) -> None: ...
 async def async_call_from_config(hass: HomeAssistant, config: ConfigType, blocking: bool = ..., variables: TemplateVarsType = ..., validate_config: bool = ..., context: Context | None = ...) -> None: ...

homeassistant-stubs/helpers/service_info/mqtt.pyi

@@ -12,4 +12,3 @@ class MqttServiceInfo(BaseServiceInfo):
     subscribed_topic: str
     timestamp: dt.datetime
     def __init__(self, topic, payload, qos, retain, subscribed_topic, timestamp) -> None: ...
-    def __mypy-replace(*, topic, payload, qos, retain, subscribed_topic, timestamp) -> None: ...

homeassistant-stubs/helpers/storage.pyi

@@ -28,7 +28,8 @@ class Store(Generic[_T]):
     _load_task: Incomplete
     _encoder: Incomplete
     _atomic_writes: Incomplete
-    def __init__(self, hass: HomeAssistant, version: int, key: str, private: bool = ..., *, atomic_writes: bool = ..., encoder: type[JSONEncoder] | None = ..., minor_version: int = ...) -> None: ...
+    _read_only: Incomplete
+    def __init__(self, hass: HomeAssistant, version: int, key: str, private: bool = ..., *, atomic_writes: bool = ..., encoder: type[JSONEncoder] | None = ..., minor_version: int = ..., read_only: bool = ...) -> None: ...
     @property
     def path(self): ...
     async def async_load(self) -> _T | None: ...

homeassistant-stubs/helpers/template.pyi

@@ -17,7 +17,7 @@ from homeassistant.util.read_only_dict import ReadOnlyDict as ReadOnlyDict
 from homeassistant.util.thread import ThreadWithException as ThreadWithException
 from jinja2.sandbox import ImmutableSandboxedEnvironment
 from types import CodeType
-from typing import Any, Literal, NoReturn, ParamSpec, TypeVar, overload
+from typing import Any, Literal, NoReturn, TypeVar, overload
 
 _LOGGER: Incomplete
 _SENTINEL: Incomplete
@@ -34,7 +34,7 @@ _ZONE_DOMAIN_PREFIX: str
 _COLLECTABLE_STATE_ATTRIBUTES: Incomplete
 _T = TypeVar('_T')
 _R = TypeVar('_R')
-_P = ParamSpec('_P')
+_P: Incomplete
 ALL_STATES_RATE_LIMIT: Incomplete
 DOMAIN_STATES_RATE_LIMIT: Incomplete
 _render_info: ContextVar[RenderInfo | None]
@@ -109,6 +109,7 @@ class Template:
     _exc_info: Incomplete
     _limited: Incomplete
     _strict: Incomplete
+    _log_fn: Incomplete
     _hash_cache: Incomplete
     _renders: int
     def __init__(self, template: str, hass: HomeAssistant | None = ...) -> None: ...
@@ -116,13 +117,13 @@ class Template:
     def _env(self) -> TemplateEnvironment: ...
     def ensure_valid(self) -> None: ...
     def render(self, variables: TemplateVarsType = ..., parse_result: bool = ..., limited: bool = ..., **kwargs: Any) -> Any: ...
-    def async_render(self, variables: TemplateVarsType = ..., parse_result: bool = ..., limited: bool = ..., strict: bool = ..., **kwargs: Any) -> Any: ...
+    def async_render(self, variables: TemplateVarsType = ..., parse_result: bool = ..., limited: bool = ..., strict: bool = ..., log_fn: Callable[[int, str], None] | None = ..., **kwargs: Any) -> Any: ...
     def _parse_result(self, render_result: str) -> Any: ...
-    async def async_render_will_timeout(self, timeout: float, variables: TemplateVarsType = ..., strict: bool = ..., **kwargs: Any) -> bool: ...
-    def async_render_to_info(self, variables: TemplateVarsType = ..., strict: bool = ..., **kwargs: Any) -> RenderInfo: ...
+    async def async_render_will_timeout(self, timeout: float, variables: TemplateVarsType = ..., strict: bool = ..., log_fn: Callable[[int, str], None] | None = ..., **kwargs: Any) -> bool: ...
+    def async_render_to_info(self, variables: TemplateVarsType = ..., strict: bool = ..., log_fn: Callable[[int, str], None] | None = ..., **kwargs: Any) -> RenderInfo: ...
     def render_with_possible_json_value(self, value, error_value=...): ...
     def async_render_with_possible_json_value(self, value: Any, error_value: Any = ..., variables: dict[str, Any] | None = ...) -> Any: ...
-    def _ensure_compiled(self, limited: bool = ..., strict: bool = ...) -> jinja2.Template: ...
+    def _ensure_compiled(self, limited: bool = ..., strict: bool = ..., log_fn: Callable[[int, str], None] | None = ...) -> jinja2.Template: ...
     def __eq__(self, other): ...
     def __hash__(self) -> int: ...
     def __repr__(self) -> str: ...
@@ -297,14 +298,7 @@ def slugify(value, separator: str = ...): ...
 def iif(value: Any, if_true: Any = ..., if_false: Any = ..., if_none: Any = ...) -> Any: ...
 def set_template(template_str: str, action: str) -> Generator: ...
 def _render_with_context(template_str: str, template: jinja2.Template, **kwargs: Any) -> str: ...
-
-class LoggingUndefined(jinja2.Undefined):
-    def _log_message(self) -> None: ...
-    def _fail_with_undefined_error(self, *args, **kwargs): ...
-    def __str__(self) -> str: ...
-    def __iter__(self): ...
-    def __bool__(self) -> bool: ...
-
+def make_logging_undefined(strict: bool | None, log_fn: Callable[[int, str], None] | None) -> type[jinja2.Undefined]: ...
 async def async_load_custom_templates(hass: HomeAssistant) -> None: ...
 def _load_custom_templates(hass: HomeAssistant) -> dict[str, str]: ...
 def _get_hass_loader(hass: HomeAssistant) -> HassLoader: ...
@@ -321,7 +315,7 @@ class TemplateEnvironment(ImmutableSandboxedEnvironment):
     hass: Incomplete
     template_cache: Incomplete
     loader: Incomplete
-    def __init__(self, hass, limited: bool = ..., strict: bool = ...) -> None: ...
+    def __init__(self, hass: HomeAssistant | None, limited: bool | None = ..., strict: bool | None = ..., log_fn: Callable[[int, str], None] | None = ...) -> None: ...
     def is_safe_callable(self, obj): ...
     def is_safe_attribute(self, obj, attr, value): ...
     @overload

homeassistant-stubs/helpers/trigger.pyi

@@ -35,7 +35,6 @@ class PluggableActionsEntry:
     plugs: set[PluggableAction]
     actions: dict[object, tuple[HassJob[[dict[str, Any], Context | None], Coroutine[Any, Any, None]], dict[str, Any]]]
     def __init__(self, plugs, actions) -> None: ...
-    def __mypy-replace(*, plugs, actions) -> None: ...
 
 class PluggableAction:
     _entry: PluggableActionsEntry | None

homeassistant-stubs/helpers/trigger_template_entity.pyi

@@ -0,0 +1,62 @@
+import voluptuous as vol
+from .entity import Entity as Entity
+from .template import render_complex as render_complex
+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.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
+from homeassistant.util.json import JSON_DECODE_EXCEPTIONS as JSON_DECODE_EXCEPTIONS, json_loads as json_loads
+from typing import Any
+
+CONF_AVAILABILITY: str
+CONF_ATTRIBUTES: str
+CONF_PICTURE: str
+CONF_TO_ATTRIBUTE: Incomplete
+TEMPLATE_ENTITY_BASE_SCHEMA: Incomplete
+
+def make_template_entity_base_schema(default_name: str) -> vol.Schema: ...
+
+TEMPLATE_SENSOR_BASE_SCHEMA: Incomplete
+
+class TriggerBaseEntity(Entity):
+    domain: str
+    extra_template_keys: tuple[str, ...] | None
+    extra_template_keys_complex: tuple[str, ...] | None
+    _unique_id: str | None
+    hass: Incomplete
+    _config: Incomplete
+    _static_rendered: Incomplete
+    _to_render_simple: Incomplete
+    _to_render_complex: Incomplete
+    _rendered: Incomplete
+    _parse_result: Incomplete
+    def __init__(self, hass: HomeAssistant, config: ConfigType) -> None: ...
+    @property
+    def name(self) -> str | None: ...
+    @property
+    def unique_id(self) -> str | None: ...
+    @property
+    def device_class(self): ...
+    @property
+    def icon(self) -> str | None: ...
+    @property
+    def entity_picture(self) -> str | None: ...
+    @property
+    def available(self) -> bool: ...
+    @property
+    def extra_state_attributes(self) -> dict[str, Any] | None: ...
+    async def async_added_to_hass(self) -> None: ...
+    def _set_unique_id(self, unique_id: str | None) -> None: ...
+    def restore_attributes(self, last_state: State) -> None: ...
+    def _render_templates(self, variables: dict[str, Any]) -> None: ...
+
+class ManualTriggerEntity(TriggerBaseEntity):
+    def __init__(self, hass: HomeAssistant, config: ConfigType) -> None: ...
+    def _process_manual_data(self, value: Any | None = ...) -> None: ...
+
+class ManualTriggerSensorEntity(ManualTriggerEntity, SensorEntity):
+    _attr_native_unit_of_measurement: Incomplete
+    _attr_state_class: Incomplete
+    def __init__(self, hass: HomeAssistant, config: ConfigType) -> None: ...

homeassistant-stubs/helpers/update_coordinator.pyi

@@ -32,6 +32,8 @@ class DataUpdateCoordinator(BaseDataUpdateCoordinatorProtocol, Generic[_DataT]):
     update_interval: Incomplete
     _shutdown_requested: bool
     config_entry: Incomplete
+    always_update: Incomplete
+    _next_refresh: Incomplete
     data: Incomplete
     _microsecond: Incomplete
     _listeners: Incomplete
@@ -42,7 +44,7 @@ class DataUpdateCoordinator(BaseDataUpdateCoordinatorProtocol, Generic[_DataT]):
     last_update_success: bool
     last_exception: Incomplete
     _debounced_refresh: Incomplete
-    def __init__(self, hass: HomeAssistant, logger: logging.Logger, *, name: str, update_interval: timedelta | None = ..., update_method: Callable[[], Awaitable[_DataT]] | None = ..., request_refresh_debouncer: Debouncer[Coroutine[Any, Any, None]] | None = ...) -> None: ...
+    def __init__(self, hass: HomeAssistant, logger: logging.Logger, *, name: str, update_interval: timedelta | None = ..., update_method: Callable[[], Awaitable[_DataT]] | None = ..., request_refresh_debouncer: Debouncer[Coroutine[Any, Any, None]] | None = ..., always_update: bool = ...) -> None: ...
     async def async_register_shutdown(self) -> None: ...
     def async_add_listener(self, update_callback: CALLBACK_TYPE, context: Any = ...) -> Callable[[], None]: ...
     def async_update_listeners(self) -> None: ...
@@ -61,6 +63,10 @@ class DataUpdateCoordinator(BaseDataUpdateCoordinatorProtocol, Generic[_DataT]):
     def async_set_update_error(self, err: Exception) -> None: ...
     def async_set_updated_data(self, data: _DataT) -> None: ...
 
+class TimestampDataUpdateCoordinator(DataUpdateCoordinator[_DataT]):
+    last_update_success_time: datetime | None
+    async def _async_refresh(self, log_failures: bool = ..., raise_on_auth_failed: bool = ..., scheduled: bool = ..., raise_on_entry_error: bool = ...) -> None: ...
+
 class BaseCoordinatorEntity(entity.Entity, Generic[_BaseDataUpdateCoordinatorT], metaclass=abc.ABCMeta):
     coordinator: Incomplete
     coordinator_context: Incomplete