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

homeassistant-stubs/helpers/selector.pyi

@@ -1,3 +1,4 @@
+import voluptuous as vol
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable, Mapping, Sequence
 from enum import StrEnum
@@ -11,7 +12,7 @@ from typing import Any, Literal, Required, TypedDict
 
 SELECTORS: decorator.Registry[str, type[Selector]]
 
-def _get_selector_class(config: Any) -> type[Selector]: ...
+def _get_selector_type_and_class(config: Any) -> tuple[str, type[Selector]]: ...
 def selector(config: Any) -> Selector: ...
 def validate_selector(config: Any) -> dict: ...
 
@@ -19,6 +20,7 @@ class Selector[_T: Mapping[str, Any]]:
     CONFIG_SCHEMA: Callable
     config: _T
     selector_type: str
+    allowed_context_keys: dict[str, set[str]]
     def __init__(self, config: Mapping[str, Any] | None = None) -> None: ...
     def __eq__(self, other: object) -> bool: ...
     def serialize(self) -> dict[str, dict[str, _T]]: ...
@@ -26,9 +28,14 @@ class Selector[_T: Mapping[str, Any]]:
 @cache
 def _entity_feature_flag(domain: str, enum_name: str, feature_name: str) -> int: ...
 def _validate_supported_feature(supported_feature: str) -> int: ...
-def _validate_supported_features(supported_features: int | list[str]) -> int: ...
+def _validate_supported_features(supported_features: list[str]) -> int: ...
+def make_selector_config_schema(schema_dict: dict | None = None) -> vol.Schema: ...
+
+class BaseSelectorConfig(TypedDict, total=False):
+    read_only: bool
 
 ENTITY_FILTER_SELECTOR_CONFIG_SCHEMA: Incomplete
+_LEGACY_ENTITY_SELECTOR_CONFIG_SCHEMA_DICT: Incomplete
 
 class EntityFilterSelectorConfig(TypedDict, total=False):
     integration: str
@@ -37,6 +44,7 @@ class EntityFilterSelectorConfig(TypedDict, total=False):
     supported_features: list[str]
 
 DEVICE_FILTER_SELECTOR_CONFIG_SCHEMA: Incomplete
+_LEGACY_DEVICE_SELECTOR_CONFIG_SCHEMA_DICT: Incomplete
 
 class DeviceFilterSelectorConfig(TypedDict, total=False):
     integration: str
@@ -44,7 +52,7 @@ class DeviceFilterSelectorConfig(TypedDict, total=False):
     model: str
     model_id: str
 
-class ActionSelectorConfig(TypedDict): ...
+class ActionSelectorConfig(BaseSelectorConfig): ...
 
 class ActionSelector(Selector[ActionSelectorConfig]):
     selector_type: str
@@ -52,7 +60,7 @@ class ActionSelector(Selector[ActionSelectorConfig]):
     def __init__(self, config: ActionSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> Any: ...
 
-class AddonSelectorConfig(TypedDict, total=False):
+class AddonSelectorConfig(BaseSelectorConfig, total=False):
     name: str
     slug: str
 
@@ -62,7 +70,7 @@ class AddonSelector(Selector[AddonSelectorConfig]):
     def __init__(self, config: AddonSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str: ...
 
-class AreaSelectorConfig(TypedDict, total=False):
+class AreaSelectorConfig(BaseSelectorConfig, total=False):
     entity: EntityFilterSelectorConfig | list[EntityFilterSelectorConfig]
     device: DeviceFilterSelectorConfig | list[DeviceFilterSelectorConfig]
     multiple: bool
@@ -73,7 +81,7 @@ class AreaSelector(Selector[AreaSelectorConfig]):
     def __init__(self, config: AreaSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str | list[str]: ...
 
-class AssistPipelineSelectorConfig(TypedDict, total=False): ...
+class AssistPipelineSelectorConfig(BaseSelectorConfig, total=False): ...
 
 class AssistPipelineSelector(Selector[AssistPipelineSelectorConfig]):
     selector_type: str
@@ -81,17 +89,18 @@ class AssistPipelineSelector(Selector[AssistPipelineSelectorConfig]):
     def __init__(self, config: AssistPipelineSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str: ...
 
-class AttributeSelectorConfig(TypedDict, total=False):
+class AttributeSelectorConfig(BaseSelectorConfig, total=False):
     entity_id: Required[str]
     hide_attributes: list[str]
 
 class AttributeSelector(Selector[AttributeSelectorConfig]):
     selector_type: str
+    allowed_context_keys: Incomplete
     CONFIG_SCHEMA: Incomplete
     def __init__(self, config: AttributeSelectorConfig) -> None: ...
     def __call__(self, data: Any) -> str: ...
 
-class BackupLocationSelectorConfig(TypedDict, total=False): ...
+class BackupLocationSelectorConfig(BaseSelectorConfig, total=False): ...
 
 class BackupLocationSelector(Selector[BackupLocationSelectorConfig]):
     selector_type: str
@@ -99,7 +108,7 @@ class BackupLocationSelector(Selector[BackupLocationSelectorConfig]):
     def __init__(self, config: BackupLocationSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str: ...
 
-class BooleanSelectorConfig(TypedDict): ...
+class BooleanSelectorConfig(BaseSelectorConfig): ...
 
 class BooleanSelector(Selector[BooleanSelectorConfig]):
     selector_type: str
@@ -107,7 +116,23 @@ class BooleanSelector(Selector[BooleanSelectorConfig]):
     def __init__(self, config: BooleanSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> bool: ...
 
-class ColorRGBSelectorConfig(TypedDict): ...
+def reject_nested_choose_selector(config: dict[str, Any]) -> dict[str, Any]: ...
+
+class ChooseSelectorChoiceConfig(TypedDict, total=False):
+    selector: Required[Selector | dict[str, Any]]
+
+class ChooseSelectorConfig(BaseSelectorConfig):
+    choices: Required[dict[str, ChooseSelectorChoiceConfig]]
+    translation_key: str
+
+class ChooseSelector(Selector[ChooseSelectorConfig]):
+    selector_type: str
+    CONFIG_SCHEMA: Incomplete
+    def __init__(self, config: ChooseSelectorConfig | None = None) -> None: ...
+    def serialize(self) -> dict[str, dict[str, ChooseSelectorConfig]]: ...
+    def __call__(self, data: Any) -> Any: ...
+
+class ColorRGBSelectorConfig(BaseSelectorConfig): ...
 
 class ColorRGBSelector(Selector[ColorRGBSelectorConfig]):
     selector_type: str
@@ -115,7 +140,7 @@ class ColorRGBSelector(Selector[ColorRGBSelectorConfig]):
     def __init__(self, config: ColorRGBSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> list[int]: ...
 
-class ColorTempSelectorConfig(TypedDict, total=False):
+class ColorTempSelectorConfig(BaseSelectorConfig, total=False):
     unit: ColorTempSelectorUnit
     min: int
     max: int
@@ -132,7 +157,7 @@ class ColorTempSelector(Selector[ColorTempSelectorConfig]):
     def __init__(self, config: ColorTempSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> int: ...
 
-class ConditionSelectorConfig(TypedDict): ...
+class ConditionSelectorConfig(BaseSelectorConfig): ...
 
 class ConditionSelector(Selector[ConditionSelectorConfig]):
     selector_type: str
@@ -140,7 +165,7 @@ class ConditionSelector(Selector[ConditionSelectorConfig]):
     def __init__(self, config: ConditionSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> Any: ...
 
-class ConfigEntrySelectorConfig(TypedDict, total=False):
+class ConfigEntrySelectorConfig(BaseSelectorConfig, total=False):
     integration: str
 
 class ConfigEntrySelector(Selector[ConfigEntrySelectorConfig]):
@@ -149,7 +174,7 @@ class ConfigEntrySelector(Selector[ConfigEntrySelectorConfig]):
     def __init__(self, config: ConfigEntrySelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str: ...
 
-class ConstantSelectorConfig(TypedDict, total=False):
+class ConstantSelectorConfig(BaseSelectorConfig, total=False):
     label: str
     translation_key: str
     value: str | int | bool
@@ -160,24 +185,7 @@ class ConstantSelector(Selector[ConstantSelectorConfig]):
     def __init__(self, config: ConstantSelectorConfig) -> None: ...
     def __call__(self, data: Any) -> Any: ...
 
-class QrErrorCorrectionLevel(StrEnum):
-    LOW = 'low'
-    MEDIUM = 'medium'
-    QUARTILE = 'quartile'
-    HIGH = 'high'
-
-class QrCodeSelectorConfig(TypedDict, total=False):
-    data: str
-    scale: int
-    error_correction_level: QrErrorCorrectionLevel
-
-class QrCodeSelector(Selector[QrCodeSelectorConfig]):
-    selector_type: str
-    CONFIG_SCHEMA: Incomplete
-    def __init__(self, config: QrCodeSelectorConfig) -> None: ...
-    def __call__(self, data: Any) -> Any: ...
-
-class ConversationAgentSelectorConfig(TypedDict, total=False):
+class ConversationAgentSelectorConfig(BaseSelectorConfig, total=False):
     language: str
 
 class ConversationAgentSelector(Selector[ConversationAgentSelectorConfig]):
@@ -186,7 +194,7 @@ class ConversationAgentSelector(Selector[ConversationAgentSelectorConfig]):
     def __init__(self, config: ConversationAgentSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str: ...
 
-class CountrySelectorConfig(TypedDict, total=False):
+class CountrySelectorConfig(BaseSelectorConfig, total=False):
     countries: list[str]
     no_sort: bool
 
@@ -196,7 +204,7 @@ class CountrySelector(Selector[CountrySelectorConfig]):
     def __init__(self, config: CountrySelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> Any: ...
 
-class DateSelectorConfig(TypedDict): ...
+class DateSelectorConfig(BaseSelectorConfig): ...
 
 class DateSelector(Selector[DateSelectorConfig]):
     selector_type: str
@@ -204,7 +212,7 @@ class DateSelector(Selector[DateSelectorConfig]):
     def __init__(self, config: DateSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> Any: ...
 
-class DateTimeSelectorConfig(TypedDict): ...
+class DateTimeSelectorConfig(BaseSelectorConfig): ...
 
 class DateTimeSelector(Selector[DateTimeSelectorConfig]):
     selector_type: str
@@ -212,7 +220,7 @@ class DateTimeSelector(Selector[DateTimeSelectorConfig]):
     def __init__(self, config: DateTimeSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> Any: ...
 
-class DeviceSelectorConfig(DeviceFilterSelectorConfig, total=False):
+class DeviceSelectorConfig(BaseSelectorConfig, DeviceFilterSelectorConfig, total=False):
     entity: EntityFilterSelectorConfig | list[EntityFilterSelectorConfig]
     multiple: bool
     filter: DeviceFilterSelectorConfig | list[DeviceFilterSelectorConfig]
@@ -223,7 +231,7 @@ class DeviceSelector(Selector[DeviceSelectorConfig]):
     def __init__(self, config: DeviceSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str | list[str]: ...
 
-class DurationSelectorConfig(TypedDict, total=False):
+class DurationSelectorConfig(BaseSelectorConfig, total=False):
     enable_day: bool
     enable_millisecond: bool
     allow_negative: bool
@@ -234,10 +242,11 @@ class DurationSelector(Selector[DurationSelectorConfig]):
     def __init__(self, config: DurationSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> dict[str, float]: ...
 
-class EntitySelectorConfig(EntityFilterSelectorConfig, total=False):
+class EntitySelectorConfig(BaseSelectorConfig, EntityFilterSelectorConfig, total=False):
     exclude_entities: list[str]
     include_entities: list[str]
     multiple: bool
+    reorder: bool
     filter: EntityFilterSelectorConfig | list[EntityFilterSelectorConfig]
 
 class EntitySelector(Selector[EntitySelectorConfig]):
@@ -246,7 +255,16 @@ class EntitySelector(Selector[EntitySelectorConfig]):
     def __init__(self, config: EntitySelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str | list[str]: ...
 
-class FloorSelectorConfig(TypedDict, total=False):
+class FileSelectorConfig(BaseSelectorConfig):
+    accept: str
+
+class FileSelector(Selector[FileSelectorConfig]):
+    selector_type: str
+    CONFIG_SCHEMA: Incomplete
+    def __init__(self, config: FileSelectorConfig) -> None: ...
+    def __call__(self, data: Any) -> str: ...
+
+class FloorSelectorConfig(BaseSelectorConfig, total=False):
     entity: EntityFilterSelectorConfig | list[EntityFilterSelectorConfig]
     device: DeviceFilterSelectorConfig | list[DeviceFilterSelectorConfig]
     multiple: bool
@@ -257,7 +275,7 @@ class FloorSelector(Selector[FloorSelectorConfig]):
     def __init__(self, config: FloorSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str | list[str]: ...
 
-class IconSelectorConfig(TypedDict, total=False):
+class IconSelectorConfig(BaseSelectorConfig, total=False):
     placeholder: str
 
 class IconSelector(Selector[IconSelectorConfig]):
@@ -266,7 +284,7 @@ class IconSelector(Selector[IconSelectorConfig]):
     def __init__(self, config: IconSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str: ...
 
-class LabelSelectorConfig(TypedDict, total=False):
+class LabelSelectorConfig(BaseSelectorConfig, total=False):
     multiple: bool
 
 class LabelSelector(Selector[LabelSelectorConfig]):
@@ -275,7 +293,7 @@ class LabelSelector(Selector[LabelSelectorConfig]):
     def __init__(self, config: LabelSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str | list[str]: ...
 
-class LanguageSelectorConfig(TypedDict, total=False):
+class LanguageSelectorConfig(BaseSelectorConfig, total=False):
     languages: list[str]
     native_name: bool
     no_sort: bool
@@ -286,7 +304,7 @@ class LanguageSelector(Selector[LanguageSelectorConfig]):
     def __init__(self, config: LanguageSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str: ...
 
-class LocationSelectorConfig(TypedDict, total=False):
+class LocationSelectorConfig(BaseSelectorConfig, total=False):
     radius: bool
     icon: str
 
@@ -297,21 +315,25 @@ class LocationSelector(Selector[LocationSelectorConfig]):
     def __init__(self, config: LocationSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> dict[str, float]: ...
 
-class MediaSelectorConfig(TypedDict): ...
+class MediaSelectorConfig(BaseSelectorConfig, total=False):
+    accept: list[str]
+    multiple: bool
 
 class MediaSelector(Selector[MediaSelectorConfig]):
     selector_type: str
+    allowed_context_keys: Incomplete
     CONFIG_SCHEMA: Incomplete
     DATA_SCHEMA: Incomplete
     def __init__(self, config: MediaSelectorConfig | None = None) -> None: ...
-    def __call__(self, data: Any) -> dict[str, float]: ...
+    def __call__(self, data: Any) -> dict[str, str] | list[dict[str, str]]: ...
 
-class NumberSelectorConfig(TypedDict, total=False):
+class NumberSelectorConfig(BaseSelectorConfig, total=False):
     min: float
     max: float
     step: float | Literal['any']
     unit_of_measurement: str
     mode: NumberSelectorMode
+    translation_key: str
 
 class NumberSelectorMode(StrEnum):
     BOX = 'box'
@@ -325,12 +347,40 @@ class NumberSelector(Selector[NumberSelectorConfig]):
     def __init__(self, config: NumberSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> float: ...
 
-class ObjectSelectorConfig(TypedDict): ...
+class ObjectSelectorField(TypedDict, total=False):
+    label: str
+    required: bool
+    selector: Required[Selector | dict[str, Any]]
+
+class ObjectSelectorConfig(BaseSelectorConfig, total=False):
+    fields: dict[str, ObjectSelectorField]
+    multiple: bool
+    label_field: str
+    description_field: str
+    translation_key: str
 
 class ObjectSelector(Selector[ObjectSelectorConfig]):
     selector_type: str
     CONFIG_SCHEMA: Incomplete
     def __init__(self, config: ObjectSelectorConfig | None = None) -> None: ...
+    def serialize(self) -> dict[str, dict[str, ObjectSelectorConfig]]: ...
+    def __call__(self, data: Any) -> Any: ...
+
+class QrErrorCorrectionLevel(StrEnum):
+    LOW = 'low'
+    MEDIUM = 'medium'
+    QUARTILE = 'quartile'
+    HIGH = 'high'
+
+class QrCodeSelectorConfig(BaseSelectorConfig, total=False):
+    data: str
+    scale: int
+    error_correction_level: QrErrorCorrectionLevel
+
+class QrCodeSelector(Selector[QrCodeSelectorConfig]):
+    selector_type: str
+    CONFIG_SCHEMA: Incomplete
+    def __init__(self, config: QrCodeSelectorConfig) -> None: ...
     def __call__(self, data: Any) -> Any: ...
 
 select_option: Incomplete
@@ -343,7 +393,7 @@ class SelectSelectorMode(StrEnum):
     LIST = 'list'
     DROPDOWN = 'dropdown'
 
-class SelectSelectorConfig(TypedDict, total=False):
+class SelectSelectorConfig(BaseSelectorConfig, total=False):
     options: Required[Sequence[SelectOptionDict] | Sequence[str]]
     multiple: bool
     custom_value: bool
@@ -357,18 +407,30 @@ class SelectSelector(Selector[SelectSelectorConfig]):
     def __init__(self, config: SelectSelectorConfig) -> None: ...
     def __call__(self, data: Any) -> Any: ...
 
-class TargetSelectorConfig(TypedDict, total=False):
-    entity: EntityFilterSelectorConfig | list[EntityFilterSelectorConfig]
-    device: DeviceFilterSelectorConfig | list[DeviceFilterSelectorConfig]
-
-class StateSelectorConfig(TypedDict, total=False):
-    entity_id: Required[str]
+class StateSelectorConfig(BaseSelectorConfig, total=False):
+    entity_id: str
+    hide_states: list[str]
+    multiple: bool
 
 class StateSelector(Selector[StateSelectorConfig]):
     selector_type: str
+    allowed_context_keys: Incomplete
     CONFIG_SCHEMA: Incomplete
     def __init__(self, config: StateSelectorConfig) -> None: ...
-    def __call__(self, data: Any) -> str: ...
+    def __call__(self, data: Any) -> str | list[str]: ...
+
+class StatisticSelectorConfig(BaseSelectorConfig, total=False):
+    multiple: bool
+
+class StatisticSelector(Selector[StatisticSelectorConfig]):
+    selector_type: str
+    CONFIG_SCHEMA: Incomplete
+    def __init__(self, config: StatisticSelectorConfig | None = None) -> None: ...
+    def __call__(self, data: Any) -> str | list[str]: ...
+
+class TargetSelectorConfig(BaseSelectorConfig, total=False):
+    entity: EntityFilterSelectorConfig | list[EntityFilterSelectorConfig]
+    device: DeviceFilterSelectorConfig | list[DeviceFilterSelectorConfig]
 
 class TargetSelector(Selector[TargetSelectorConfig]):
     selector_type: str
@@ -377,7 +439,7 @@ class TargetSelector(Selector[TargetSelectorConfig]):
     def __init__(self, config: TargetSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> dict[str, list[str]]: ...
 
-class TemplateSelectorConfig(TypedDict): ...
+class TemplateSelectorConfig(BaseSelectorConfig): ...
 
 class TemplateSelector(Selector[TemplateSelectorConfig]):
     selector_type: str
@@ -385,7 +447,7 @@ class TemplateSelector(Selector[TemplateSelectorConfig]):
     def __init__(self, config: TemplateSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str: ...
 
-class TextSelectorConfig(TypedDict, total=False):
+class TextSelectorConfig(BaseSelectorConfig, total=False):
     multiline: bool
     prefix: str
     suffix: str
@@ -414,7 +476,7 @@ class TextSelector(Selector[TextSelectorConfig]):
     def __init__(self, config: TextSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str | list[str]: ...
 
-class ThemeSelectorConfig(TypedDict): ...
+class ThemeSelectorConfig(BaseSelectorConfig): ...
 
 class ThemeSelector(Selector[ThemeSelectorConfig]):
     selector_type: str
@@ -422,7 +484,7 @@ class ThemeSelector(Selector[ThemeSelectorConfig]):
     def __init__(self, config: ThemeSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str: ...
 
-class TimeSelectorConfig(TypedDict): ...
+class TimeSelectorConfig(BaseSelectorConfig): ...
 
 class TimeSelector(Selector[TimeSelectorConfig]):
     selector_type: str
@@ -430,19 +492,10 @@ class TimeSelector(Selector[TimeSelectorConfig]):
     def __init__(self, config: TimeSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> str: ...
 
-class TriggerSelectorConfig(TypedDict): ...
+class TriggerSelectorConfig(BaseSelectorConfig): ...
 
 class TriggerSelector(Selector[TriggerSelectorConfig]):
     selector_type: str
     CONFIG_SCHEMA: Incomplete
     def __init__(self, config: TriggerSelectorConfig | None = None) -> None: ...
     def __call__(self, data: Any) -> Any: ...
-
-class FileSelectorConfig(TypedDict):
-    accept: str
-
-class FileSelector(Selector[FileSelectorConfig]):
-    selector_type: str
-    CONFIG_SCHEMA: Incomplete
-    def __init__(self, config: FileSelectorConfig) -> None: ...
-    def __call__(self, data: Any) -> str: ...

homeassistant-stubs/helpers/service.pyi

@@ -1,14 +1,14 @@
-import dataclasses
-from . import area_registry as area_registry, device_registry as device_registry, entity_registry as entity_registry, floor_registry as floor_registry, label_registry as label_registry, template as template, translation as translation
+import logging
+from . import device_registry as device_registry, entity_registry as entity_registry, selector as selector, target as target_helpers, template as template
+from .deprecation import deprecated_class as deprecated_class, deprecated_function as deprecated_function, deprecated_hass_argument as deprecated_hass_argument
 from .entity import Entity as Entity
-from .group import expand_entity_ids as expand_entity_ids
 from .selector import TargetSelector as TargetSelector
 from .typing import ConfigType as ConfigType, TemplateVarsType as TemplateVarsType, VolDictType as VolDictType, VolSchemaType as VolSchemaType
 from _typeshed import Incomplete
-from collections.abc import Awaitable, Callable as Callable, Coroutine, Iterable
+from collections.abc import Callable as Callable, Coroutine, Iterable, Mapping
 from functools import cache
 from homeassistant.auth.permissions.const import CAT_ENTITIES as CAT_ENTITIES, POLICY_CONTROL as POLICY_CONTROL
-from homeassistant.const import ATTR_AREA_ID as ATTR_AREA_ID, ATTR_DEVICE_ID as ATTR_DEVICE_ID, ATTR_ENTITY_ID as ATTR_ENTITY_ID, ATTR_FLOOR_ID as ATTR_FLOOR_ID, ATTR_LABEL_ID as ATTR_LABEL_ID, CONF_ACTION as CONF_ACTION, CONF_ENTITY_ID as CONF_ENTITY_ID, CONF_SERVICE_DATA as CONF_SERVICE_DATA, CONF_SERVICE_DATA_TEMPLATE as CONF_SERVICE_DATA_TEMPLATE, CONF_SERVICE_TEMPLATE as CONF_SERVICE_TEMPLATE, CONF_TARGET as CONF_TARGET, ENTITY_MATCH_ALL as ENTITY_MATCH_ALL, ENTITY_MATCH_NONE as ENTITY_MATCH_NONE
+from homeassistant.const import ATTR_ENTITY_ID as ATTR_ENTITY_ID, CONF_ACTION as CONF_ACTION, CONF_ENTITY_ID as CONF_ENTITY_ID, CONF_SELECTOR as CONF_SELECTOR, CONF_SERVICE_DATA as CONF_SERVICE_DATA, CONF_SERVICE_DATA_TEMPLATE as CONF_SERVICE_DATA_TEMPLATE, CONF_SERVICE_TEMPLATE as CONF_SERVICE_TEMPLATE, CONF_TARGET as CONF_TARGET, ENTITY_MATCH_ALL as ENTITY_MATCH_ALL, ENTITY_MATCH_NONE as ENTITY_MATCH_NONE
 from homeassistant.core import Context as Context, EntityServiceResponse as EntityServiceResponse, HassJob as HassJob, HassJobType as HassJobType, HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, ServiceResponse as ServiceResponse, SupportsResponse as SupportsResponse, callback as callback
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, ServiceNotSupported as ServiceNotSupported, TemplateError as TemplateError, Unauthorized as Unauthorized, UnknownUser as UnknownUser
 from homeassistant.loader import Integration as Integration, async_get_integrations as async_get_integrations, bind_hass as bind_hass
@@ -17,7 +17,7 @@ from homeassistant.util.hass_dict import HassKey as HassKey
 from homeassistant.util.yaml import load_yaml_dict as load_yaml_dict
 from homeassistant.util.yaml.loader import JSON_TYPE as JSON_TYPE
 from types import ModuleType
-from typing import Any, TypeGuard, TypedDict
+from typing import Any, TypedDict, override
 
 CONF_SERVICE_ENTITY_ID: str
 _LOGGER: Incomplete
@@ -44,28 +44,12 @@ class ServiceParams(TypedDict):
     service_data: dict[str, Any]
     target: dict | None
 
-class ServiceTargetSelector:
-    __slots__: Incomplete
-    entity_ids: Incomplete
-    device_ids: Incomplete
-    area_ids: Incomplete
-    floor_ids: Incomplete
-    label_ids: Incomplete
+class ServiceTargetSelector(target_helpers.TargetSelection):
     def __init__(self, service_call: ServiceCall) -> None: ...
-    @property
-    def has_any_selector(self) -> bool: ...
 
-@dataclasses.dataclass(slots=True)
-class SelectedEntities:
-    referenced: set[str] = dataclasses.field(default_factory=set)
-    indirectly_referenced: set[str] = dataclasses.field(default_factory=set)
-    missing_devices: set[str] = dataclasses.field(default_factory=set)
-    missing_areas: set[str] = dataclasses.field(default_factory=set)
-    missing_floors: set[str] = dataclasses.field(default_factory=set)
-    missing_labels: set[str] = dataclasses.field(default_factory=set)
-    referenced_devices: set[str] = dataclasses.field(default_factory=set)
-    referenced_areas: set[str] = dataclasses.field(default_factory=set)
-    def log_missing(self, missing_entities: set[str]) -> None: ...
+class SelectedEntities(target_helpers.SelectedEntities):
+    @override
+    def log_missing(self, missing_entities: set[str], logger: logging.Logger | None = None) -> None: ...
 
 @bind_hass
 def call_from_config(hass: HomeAssistant, config: ConfigType, blocking: bool = False, variables: TemplateVarsType = None, validate_config: bool = True) -> None: ...
@@ -74,19 +58,14 @@ async def async_call_from_config(hass: HomeAssistant, config: ConfigType, blocki
 @callback
 @bind_hass
 def async_prepare_call_from_config(hass: HomeAssistant, config: ConfigType, variables: TemplateVarsType = None, validate_config: bool = False) -> ServiceParams: ...
-@bind_hass
-def extract_entity_ids(hass: HomeAssistant, service_call: ServiceCall, expand_group: bool = True) -> set[str]: ...
-@bind_hass
-async def async_extract_entities[_EntityT: Entity](hass: HomeAssistant, entities: Iterable[_EntityT], service_call: ServiceCall, expand_group: bool = True) -> list[_EntityT]: ...
-@bind_hass
-async def async_extract_entity_ids(hass: HomeAssistant, service_call: ServiceCall, expand_group: bool = True) -> set[str]: ...
-def _has_match(ids: str | list[str] | None) -> TypeGuard[str | list[str]]: ...
+def extract_entity_ids(service_call: ServiceCall, expand_group: bool = True) -> set[str]: ...
+async def async_extract_entities[_EntityT: Entity](entities: Iterable[_EntityT], service_call: ServiceCall, expand_group: bool = True) -> list[_EntityT]: ...
+async def async_extract_entity_ids(service_call: ServiceCall, expand_group: bool = True) -> set[str]: ...
 @bind_hass
 def async_extract_referenced_entity_ids(hass: HomeAssistant, service_call: ServiceCall, expand_group: bool = True) -> SelectedEntities: ...
-@bind_hass
-async def async_extract_config_entry_ids(hass: HomeAssistant, service_call: ServiceCall, expand_group: bool = True) -> set[str]: ...
-def _load_services_file(hass: HomeAssistant, integration: Integration) -> JSON_TYPE: ...
-def _load_services_files(hass: HomeAssistant, integrations: Iterable[Integration]) -> list[JSON_TYPE]: ...
+async def async_extract_config_entry_ids(service_call: ServiceCall, expand_group: bool = True) -> set[str]: ...
+def _load_services_file(integration: Integration) -> JSON_TYPE: ...
+def _load_services_files(integrations: Iterable[Integration]) -> dict[str, JSON_TYPE]: ...
 @callback
 def async_get_cached_service_description(hass: HomeAssistant, domain: str, service: str) -> dict[str, Any] | None: ...
 @bind_hass
@@ -98,15 +77,14 @@ def remove_entity_service_fields(call: ServiceCall) -> dict[Any, Any]: ...
 def async_set_service_schema(hass: HomeAssistant, domain: str, service: str, schema: dict[str, Any]) -> None: ...
 def _get_permissible_entity_candidates(call: ServiceCall, entities: dict[str, Entity], entity_perms: Callable[[str, str], bool] | None, target_all_entities: bool, all_referenced: set[str] | None) -> list[Entity]: ...
 @bind_hass
-async def entity_service_call(hass: HomeAssistant, registered_entities: dict[str, Entity], func: str | HassJob, call: ServiceCall, required_features: Iterable[int] | None = None) -> EntityServiceResponse | None: ...
+async def entity_service_call(hass: HomeAssistant, registered_entities: dict[str, Entity] | Callable[[], dict[str, Entity]], func: str | HassJob, call: ServiceCall, required_features: Iterable[int] | None = None, *, entity_device_classes: Iterable[str | None] | None = None) -> EntityServiceResponse | None: ...
 async def _handle_entity_call(hass: HomeAssistant, entity: Entity, func: str | HassJob, data: dict | ServiceCall, context: Context) -> ServiceResponse: ...
-async def _async_admin_handler(hass: HomeAssistant, service_job: HassJob[[ServiceCall], Awaitable[None] | None], call: ServiceCall) -> None: ...
+async def _async_admin_handler(hass: HomeAssistant, service_job: HassJob[[ServiceCall], Coroutine[Any, Any, ServiceResponse | EntityServiceResponse] | ServiceResponse | EntityServiceResponse | None], call: ServiceCall) -> ServiceResponse | EntityServiceResponse | None: ...
 @bind_hass
 @callback
-def async_register_admin_service(hass: HomeAssistant, domain: str, service: str, service_func: Callable[[ServiceCall], Awaitable[None] | None], schema: VolSchemaType = ...) -> None: ...
-@bind_hass
+def async_register_admin_service(hass: HomeAssistant, domain: str, service: str, service_func: Callable[[ServiceCall], Coroutine[Any, Any, ServiceResponse | EntityServiceResponse] | ServiceResponse | EntityServiceResponse | None], schema: VolSchemaType = ..., supports_response: SupportsResponse = ..., *, description_placeholders: Mapping[str, str] | None = None) -> None: ...
 @callback
-def verify_domain_control(hass: HomeAssistant, domain: str) -> Callable[[Callable[[ServiceCall], Any]], Callable[[ServiceCall], Any]]: ...
+def verify_domain_control(domain: str) -> Callable[[Callable[[ServiceCall], Any]], Callable[[ServiceCall], Any]]: ...
 
 class ReloadServiceHelper[_T]:
     _service_func: Incomplete
@@ -117,5 +95,8 @@ class ReloadServiceHelper[_T]:
     def __init__(self, service_func: Callable[[ServiceCall], Coroutine[Any, Any, Any]], reload_targets_func: Callable[[ServiceCall], set[_T]]) -> None: ...
     async def execute_service(self, service_call: ServiceCall) -> None: ...
 
+def _validate_entity_service_schema(schema: VolDictType | VolSchemaType | None, service: str) -> VolSchemaType: ...
+@callback
+def async_register_entity_service(hass: HomeAssistant, domain: str, name: str, *, description_placeholders: Mapping[str, str] | None = None, entity_device_classes: Iterable[str | None] | None = None, entities: dict[str, Entity], func: str | Callable[..., Any], job_type: HassJobType | None, required_features: Iterable[int] | None = None, schema: VolDictType | VolSchemaType | None, supports_response: SupportsResponse = ...) -> None: ...
 @callback
-def async_register_entity_service(hass: HomeAssistant, domain: str, name: str, *, entities: dict[str, Entity], func: str | Callable[..., Any], job_type: HassJobType | None, required_features: Iterable[int] | None = None, schema: VolDictType | VolSchemaType | None, supports_response: SupportsResponse = ...) -> None: ...
+def async_register_platform_entity_service(hass: HomeAssistant, service_domain: str, service_name: str, *, description_placeholders: Mapping[str, str] | None = None, entity_device_classes: Iterable[str | None] | None = None, entity_domain: str, func: str | Callable[..., Any], required_features: Iterable[int] | None = None, schema: VolDictType | VolSchemaType | None, supports_response: SupportsResponse = ...) -> None: ...

homeassistant-stubs/helpers/service_info/esphome.pyi

@@ -0,0 +1,12 @@
+from dataclasses import dataclass
+from homeassistant.data_entry_flow import BaseServiceInfo as BaseServiceInfo
+
+@dataclass(slots=True)
+class ESPHomeServiceInfo(BaseServiceInfo):
+    name: str
+    zwave_home_id: int | None
+    ip_address: str
+    port: int
+    noise_psk: str | None = ...
+    @property
+    def socket_path(self) -> str: ...

homeassistant-stubs/helpers/storage.pyi

@@ -6,7 +6,7 @@ from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, CoreState as Core
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.loader import bind_hass as bind_hass
 from homeassistant.util import json as json_util
-from homeassistant.util.file import WriteError as WriteError
+from homeassistant.util.file import WriteError as WriteError, write_utf8_file as write_utf8_file, write_utf8_file_atomic as write_utf8_file_atomic
 from homeassistant.util.hass_dict import HassKey as HassKey
 from json import JSONEncoder
 from pathlib import Path
@@ -63,7 +63,8 @@ class Store[_T: Mapping[str, Any] | Sequence[Any]]:
     _read_only: Incomplete
     _next_write_time: float
     _manager: Incomplete
-    def __init__(self, hass: HomeAssistant, version: int, key: str, private: bool = False, *, atomic_writes: bool = False, encoder: type[JSONEncoder] | None = None, minor_version: int = 1, read_only: bool = False) -> None: ...
+    _serialize_in_event_loop: Incomplete
+    def __init__(self, hass: HomeAssistant, version: int, key: str, private: bool = False, *, atomic_writes: bool = False, encoder: type[JSONEncoder] | None = None, minor_version: int = 1, read_only: bool = False, serialize_in_event_loop: bool = True) -> None: ...
     @cached_property
     def path(self): ...
     def make_read_only(self) -> None: ...
@@ -86,7 +87,8 @@ class Store[_T: Mapping[str, Any] | Sequence[Any]]:
     async def _async_callback_delayed_write(self) -> None: ...
     async def _async_callback_final_write(self, _event: Event) -> None: ...
     async def _async_handle_write_data(self, *_args) -> None: ...
-    async def _async_write_data(self, path: str, data: dict) -> None: ...
-    def _write_data(self, path: str, data: dict) -> None: ...
+    async def _async_write_data(self, data: dict) -> None: ...
+    def _write_data(self, data: dict) -> None: ...
+    def _write_prepared_data(self, mode: str, json_data: str | bytes) -> None: ...
     async def _async_migrate_func(self, old_major_version, old_minor_version, old_data) -> None: ...
     async def async_remove(self) -> None: ...

homeassistant-stubs/helpers/system_info.pyi

@@ -10,8 +10,10 @@ from typing import Any
 
 _LOGGER: Incomplete
 _DATA_MAC_VER: str
+_DATA_CONTAINER_ARCH: str
 
 async def async_get_mac_ver(hass: HomeAssistant) -> str: ...
+async def async_get_container_arch(hass: HomeAssistant) -> str: ...
 
 cached_get_user: Incomplete