homeassistant-stubs 2025.8.3__py3-none-any.whl → 2025.9.0__py3-none-any.whl

homeassistant-stubs/helpers/condition.pyi

@@ -1,5 +1,6 @@
 import abc
 import logging
+from .automation import get_absolute_description_key as get_absolute_description_key, get_relative_description_key as get_relative_description_key
 from .integration_platform import async_process_integration_platforms as async_process_integration_platforms
 from .template import Template as Template, render_complex as render_complex
 from .trace import TraceElement as TraceElement, trace_append_element as trace_append_element, trace_path as trace_path, trace_path_get as trace_path_get, trace_stack_cv as trace_stack_cv, trace_stack_pop as trace_stack_pop, trace_stack_push as trace_stack_push, trace_stack_top as trace_stack_top
@@ -15,7 +16,6 @@ from homeassistant.loader import Integration as Integration, IntegrationNotFound
 from homeassistant.util.async_ import run_callback_threadsafe as run_callback_threadsafe
 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 typing import Any, Protocol
 
 ASYNC_FROM_CONFIG_FORMAT: str
@@ -43,9 +43,9 @@ class Condition(abc.ABC, metaclass=abc.ABCMeta):
     def __init__(self, hass: HomeAssistant, config: ConfigType) -> None: ...
     @classmethod
     @abc.abstractmethod
-    async def async_validate_condition_config(cls, hass: HomeAssistant, config: ConfigType) -> ConfigType: ...
+    async def async_validate_config(cls, hass: HomeAssistant, config: ConfigType) -> ConfigType: ...
     @abc.abstractmethod
-    async def async_condition_from_config(self) -> ConditionCheckerType: ...
+    async def async_get_checker(self) -> ConditionCheckerType: ...
 
 class ConditionProtocol(Protocol):
     async def async_get_conditions(self, hass: HomeAssistant) -> dict[str, type[Condition]]: ...
@@ -57,7 +57,7 @@ def condition_trace_update_result(**kwargs: Any) -> None: ...
 @contextmanager
 def trace_condition(variables: TemplateVarsType) -> Generator[TraceElement]: ...
 def trace_condition_function(condition: ConditionCheckerType) -> ConditionCheckerType: ...
-async def _async_get_condition_platform(hass: HomeAssistant, config: ConfigType) -> ConditionProtocol | None: ...
+async def _async_get_condition_platform(hass: HomeAssistant, condition_key: str) -> tuple[str, ConditionProtocol | None]: ...
 async def async_from_config(hass: HomeAssistant, config: ConfigType) -> ConditionCheckerType: ...
 async def async_and_from_config(hass: HomeAssistant, config: ConfigType) -> ConditionCheckerType: ...
 async def async_or_from_config(hass: HomeAssistant, config: ConfigType) -> ConditionCheckerType: ...
@@ -82,6 +82,6 @@ async def async_conditions_from_config(hass: HomeAssistant, condition_configs: l
 def async_extract_entities(config: ConfigType | Template) -> set[str]: ...
 @callback
 def async_extract_devices(config: ConfigType | Template) -> set[str]: ...
-def _load_conditions_file(hass: HomeAssistant, integration: Integration) -> JSON_TYPE: ...
-def _load_conditions_files(hass: HomeAssistant, integrations: Iterable[Integration]) -> dict[str, JSON_TYPE]: ...
+def _load_conditions_file(integration: Integration) -> dict[str, Any]: ...
+def _load_conditions_files(integrations: Iterable[Integration]) -> dict[str, dict[str, Any]]: ...
 async def async_get_all_descriptions(hass: HomeAssistant) -> dict[str, dict[str, Any] | None]: ...

homeassistant-stubs/helpers/config_validation.pyi

@@ -71,6 +71,7 @@ def ensure_list[_T](value: list[_T]) -> list[_T]: ...
 @overload
 def ensure_list[_T](value: list[_T] | _T) -> list[_T]: ...
 def entity_id(value: Any) -> str: ...
+def strict_entity_id(value: Any) -> str: ...
 def entity_id_or_uuid(value: Any) -> str: ...
 def _entity_ids(value: str | list, allow_uuid: bool) -> list[str]: ...
 def entity_ids(value: str | list) -> list[str]: ...
@@ -108,6 +109,7 @@ positive_time_period: Incomplete
 def remove_falsy[_T](value: list[_T]) -> list[_T]: ...
 def service(value: Any) -> str: ...
 def slug(value: Any) -> str: ...
+def underscore_slug(value: Any) -> str: ...
 def schema_with_slug_keys(value_schema: dict | Callable, *, slug_validator: Callable[[Any], str] = ...) -> Callable: ...
 def slugify(value: Any) -> str: ...
 def string(value: Any) -> str: ...
@@ -158,6 +160,7 @@ def platform_only_config_schema(domain: str) -> Callable[[dict], dict]: ...
 
 PLATFORM_SCHEMA: Incomplete
 PLATFORM_SCHEMA_BASE: Incomplete
+TARGET_FIELDS: VolDictType
 ENTITY_SERVICE_FIELDS: VolDictType
 TARGET_SERVICE_FIELDS: Incomplete
 _HAS_ENTITY_SERVICE_FIELD: Incomplete

homeassistant-stubs/helpers/data_entry_flow.pyi

@@ -10,7 +10,7 @@ _FlowManagerT = TypeVar('_FlowManagerT', bound=data_entry_flow.FlowManager[Any,
 class _BaseFlowManagerView(HomeAssistantView, Generic[_FlowManagerT]):
     _flow_mgr: Incomplete
     def __init__(self, flow_mgr: _FlowManagerT) -> None: ...
-    def _prepare_result_json(self, result: data_entry_flow.FlowResult) -> data_entry_flow.FlowResult: ...
+    def _prepare_result_json(self, result: data_entry_flow.FlowResult) -> dict[str, Any]: ...
 
 class FlowManagerIndexView(_BaseFlowManagerView[_FlowManagerT]):
     async def post(self, request: web.Request, data: dict[str, Any]) -> web.Response: ...

homeassistant-stubs/helpers/device_registry.pyi

@@ -157,7 +157,7 @@ class DeletedDeviceEntry:
     config_entries_subentries: dict[str, set[str | None]]
     connections: set[tuple[str, str]]
     created_at: datetime
-    disabled_by: DeviceEntryDisabler | None
+    disabled_by: DeviceEntryDisabler | UndefinedType | None
     id: str
     identifiers: set[tuple[str, str]]
     labels: set[str]
@@ -165,7 +165,7 @@ class DeletedDeviceEntry:
     name_by_user: str | None
     orphaned_timestamp: float | None
     _cache: dict[str, Any]
-    def to_device_entry(self, config_entry_id: str, config_subentry_id: str | None, connections: set[tuple[str, str]], identifiers: set[tuple[str, str]]) -> DeviceEntry: ...
+    def to_device_entry(self, config_entry: ConfigEntry, config_subentry_id: str | None, connections: set[tuple[str, str]], identifiers: set[tuple[str, str]], disabled_by: DeviceEntryDisabler | UndefinedType | None) -> DeviceEntry: ...
     @under_cached_property
     def as_storage_fragment(self) -> json_fragment: ...
     def __init__(self, area_id, config_entries, config_entries_subentries, connections, created_at, disabled_by, id, identifiers, labels, modified_at, name_by_user, orphaned_timestamp, cache) -> None: ...

homeassistant-stubs/helpers/entity_registry.pyi

@@ -61,6 +61,7 @@ type ReadOnlyEntityOptionsType = ReadOnlyDict[str, ReadOnlyDict[str, Any]]
 DISPLAY_DICT_OPTIONAL: Incomplete
 
 def _protect_entity_options(data: EntityOptionsType | None) -> ReadOnlyEntityOptionsType: ...
+def _protect_optional_entity_options(data: EntityOptionsType | UndefinedType | None) -> ReadOnlyEntityOptionsType | UndefinedType: ...
 
 class RegistryEntry:
     entity_id: str
@@ -132,15 +133,15 @@ class DeletedRegistryEntry:
     config_subentry_id: str | None
     created_at: datetime
     device_class: str | None
-    disabled_by: RegistryEntryDisabler | None
+    disabled_by: RegistryEntryDisabler | UndefinedType | None
     domain: str
-    hidden_by: RegistryEntryHider | None
+    hidden_by: RegistryEntryHider | UndefinedType | None
     icon: str | None
     id: str
     labels: set[str]
     modified_at: datetime
     name: str | None
-    options: ReadOnlyEntityOptionsType
+    options: ReadOnlyEntityOptionsType | UndefinedType
     orphaned_timestamp: float | None
     _cache: dict[str, Any]
     @domain.default

homeassistant-stubs/helpers/json.pyi

@@ -1,18 +1,11 @@
 import json
 import orjson
-from .deprecation import DeprecatedConstant as DeprecatedConstant, all_with_deprecated_constants as all_with_deprecated_constants, check_if_deprecated_constant as check_if_deprecated_constant, deprecated_function as deprecated_function, dir_with_deprecated_constants as dir_with_deprecated_constants
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from homeassistant.util.file import write_utf8_file as write_utf8_file, write_utf8_file_atomic as write_utf8_file_atomic
 from homeassistant.util.json import SerializationError as SerializationError, format_unserializable_data as format_unserializable_data
 from typing import Any, Final
 
-_DEPRECATED_JSON_DECODE_EXCEPTIONS: Incomplete
-_DEPRECATED_JSON_ENCODE_EXCEPTIONS: Incomplete
-json_loads: Incomplete
-__getattr__: Incomplete
-__dir__: Incomplete
-__all__: Incomplete
 _LOGGER: Incomplete
 
 class JSONEncoder(json.JSONEncoder):

homeassistant-stubs/helpers/llm.pyi

@@ -50,6 +50,7 @@ class ToolInput:
     tool_name: str
     tool_args: dict[str, Any]
     id: str = dc_field(default_factory=Incomplete)
+    external: bool = ...
 
 class Tool(metaclass=abc.ABCMeta):
     name: str

homeassistant-stubs/helpers/schema_config_entry_flow.pyi

@@ -26,7 +26,7 @@ class SchemaFlowFormStep(SchemaFlowStep):
 
 @dataclass(slots=True)
 class SchemaFlowMenuStep(SchemaFlowStep):
-    options: Container[str]
+    options: Container[str] | Callable[[SchemaCommonFlowHandler], Coroutine[Any, Any, Container[str]]]
 
 class SchemaCommonFlowHandler:
     _flow: Incomplete
@@ -41,6 +41,7 @@ class SchemaCommonFlowHandler:
     @property
     def flow_state(self) -> dict[str, Any]: ...
     async def async_step(self, step_id: str, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def _get_options(self, form_step: SchemaFlowMenuStep) -> Container[str]: ...
     async def _get_schema(self, form_step: SchemaFlowFormStep) -> vol.Schema | None: ...
     async def _async_form_step(self, step_id: str, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     def _update_and_remove_omitted_optional_keys(self, values: dict[str, Any], user_input: dict[str, Any], data_schema: vol.Schema | None) -> None: ...

homeassistant-stubs/helpers/selector.pyi

@@ -389,12 +389,13 @@ class SelectSelector(Selector[SelectSelectorConfig]):
 class StateSelectorConfig(BaseSelectorConfig, total=False):
     entity_id: str
     hide_states: list[str]
+    multiple: bool
 
 class StateSelector(Selector[StateSelectorConfig]):
     selector_type: str
     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

homeassistant-stubs/helpers/target.pyi

@@ -48,12 +48,13 @@ class TargetStateChangeTracker:
     _hass: Incomplete
     _selector_data: Incomplete
     _action: Incomplete
+    _entity_filter: Incomplete
     _state_change_unsub: CALLBACK_TYPE | None
     _registry_unsubs: list[CALLBACK_TYPE]
-    def __init__(self, hass: HomeAssistant, selector_data: TargetSelectorData, action: Callable[[TargetStateChangedData], Any]) -> None: ...
+    def __init__(self, hass: HomeAssistant, selector_data: TargetSelectorData, action: Callable[[TargetStateChangedData], Any], entity_filter: Callable[[set[str]], set[str]]) -> None: ...
     def async_setup(self) -> Callable[[], None]: ...
     def _track_entities_state_change(self) -> None: ...
     def _setup_registry_listeners(self) -> None: ...
     def _unsubscribe(self) -> None: ...
 
-def async_track_target_selector_state_change_event(hass: HomeAssistant, target_selector_config: ConfigType, action: Callable[[TargetStateChangedData], Any]) -> CALLBACK_TYPE: ...
+def async_track_target_selector_state_change_event(hass: HomeAssistant, target_selector_config: ConfigType, action: Callable[[TargetStateChangedData], Any], entity_filter: Callable[[set[str]], set[str]] = ...) -> CALLBACK_TYPE: ...

homeassistant-stubs/helpers/trigger.pyi

@@ -1,6 +1,7 @@
 import abc
 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 .integration_platform import async_process_integration_platforms as async_process_integration_platforms
 from .selector import TargetSelector as TargetSelector
 from .template import Template as Template
@@ -16,7 +17,6 @@ from homeassistant.loader import Integration as Integration, IntegrationNotFound
 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 homeassistant.util.yaml.loader import JSON_TYPE as JSON_TYPE
 from typing import Any, Protocol, TypedDict
 
 _LOGGER: Incomplete
@@ -41,9 +41,9 @@ class Trigger(abc.ABC, metaclass=abc.ABCMeta):
     def __init__(self, hass: HomeAssistant, config: ConfigType) -> None: ...
     @classmethod
     @abc.abstractmethod
-    async def async_validate_trigger_config(cls, hass: HomeAssistant, config: ConfigType) -> ConfigType: ...
+    async def async_validate_config(cls, hass: HomeAssistant, config: ConfigType) -> ConfigType: ...
     @abc.abstractmethod
-    async def async_attach_trigger(self, action: TriggerActionType, trigger_info: TriggerInfo) -> CALLBACK_TYPE: ...
+    async def async_attach(self, action: TriggerActionType, trigger_info: TriggerInfo) -> CALLBACK_TYPE: ...
 
 class TriggerProtocol(Protocol):
     async def async_get_triggers(self, hass: HomeAssistant) -> dict[str, type[Trigger]]: ...
@@ -88,10 +88,10 @@ class PluggableAction:
     def async_register(self, hass: HomeAssistant, trigger: dict[str, str]) -> CALLBACK_TYPE: ...
     async def async_run(self, hass: HomeAssistant, context: Context | None = None) -> None: ...
 
-async def _async_get_trigger_platform(hass: HomeAssistant, config: ConfigType) -> TriggerProtocol: ...
+async def _async_get_trigger_platform(hass: HomeAssistant, trigger_key: str) -> tuple[str, TriggerProtocol]: ...
 async def async_validate_trigger_config(hass: HomeAssistant, trigger_config: list[ConfigType]) -> list[ConfigType]: ...
 def _trigger_action_wrapper(hass: HomeAssistant, action: Callable, conf: ConfigType) -> Callable: ...
 async def async_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(hass: HomeAssistant, integration: Integration) -> JSON_TYPE: ...
-def _load_triggers_files(hass: HomeAssistant, integrations: Iterable[Integration]) -> dict[str, JSON_TYPE]: ...
+def _load_triggers_file(integration: Integration) -> dict[str, Any]: ...
+def _load_triggers_files(integrations: Iterable[Integration]) -> dict[str, dict[str, Any]]: ...
 async def async_get_all_descriptions(hass: HomeAssistant) -> dict[str, dict[str, Any] | None]: ...

homeassistant-stubs/util/unit_conversion.pyi

@@ -1,7 +1,7 @@
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from functools import lru_cache
-from homeassistant.const import CONCENTRATION_GRAMS_PER_CUBIC_METER as CONCENTRATION_GRAMS_PER_CUBIC_METER, CONCENTRATION_MICROGRAMS_PER_CUBIC_METER as CONCENTRATION_MICROGRAMS_PER_CUBIC_METER, CONCENTRATION_MILLIGRAMS_PER_CUBIC_METER as CONCENTRATION_MILLIGRAMS_PER_CUBIC_METER, CONCENTRATION_PARTS_PER_BILLION as CONCENTRATION_PARTS_PER_BILLION, CONCENTRATION_PARTS_PER_MILLION as CONCENTRATION_PARTS_PER_MILLION, PERCENTAGE as PERCENTAGE, UNIT_NOT_RECOGNIZED_TEMPLATE as UNIT_NOT_RECOGNIZED_TEMPLATE, UnitOfArea as UnitOfArea, UnitOfBloodGlucoseConcentration as UnitOfBloodGlucoseConcentration, UnitOfConductivity as UnitOfConductivity, UnitOfDataRate as UnitOfDataRate, UnitOfElectricCurrent as UnitOfElectricCurrent, UnitOfElectricPotential as UnitOfElectricPotential, UnitOfEnergy as UnitOfEnergy, UnitOfEnergyDistance as UnitOfEnergyDistance, UnitOfInformation as UnitOfInformation, UnitOfLength as UnitOfLength, UnitOfMass as UnitOfMass, UnitOfPower as UnitOfPower, UnitOfPressure as UnitOfPressure, UnitOfReactiveEnergy as UnitOfReactiveEnergy, UnitOfSpeed as UnitOfSpeed, UnitOfTemperature as UnitOfTemperature, UnitOfTime as UnitOfTime, UnitOfVolume as UnitOfVolume, UnitOfVolumeFlowRate as UnitOfVolumeFlowRate, UnitOfVolumetricFlux as UnitOfVolumetricFlux
+from homeassistant.const import CONCENTRATION_GRAMS_PER_CUBIC_METER as CONCENTRATION_GRAMS_PER_CUBIC_METER, CONCENTRATION_MICROGRAMS_PER_CUBIC_METER as CONCENTRATION_MICROGRAMS_PER_CUBIC_METER, CONCENTRATION_MILLIGRAMS_PER_CUBIC_METER as CONCENTRATION_MILLIGRAMS_PER_CUBIC_METER, CONCENTRATION_PARTS_PER_BILLION as CONCENTRATION_PARTS_PER_BILLION, CONCENTRATION_PARTS_PER_MILLION as CONCENTRATION_PARTS_PER_MILLION, PERCENTAGE as PERCENTAGE, UNIT_NOT_RECOGNIZED_TEMPLATE as UNIT_NOT_RECOGNIZED_TEMPLATE, UnitOfApparentPower as UnitOfApparentPower, UnitOfArea as UnitOfArea, UnitOfBloodGlucoseConcentration as UnitOfBloodGlucoseConcentration, UnitOfConductivity as UnitOfConductivity, UnitOfDataRate as UnitOfDataRate, UnitOfElectricCurrent as UnitOfElectricCurrent, UnitOfElectricPotential as UnitOfElectricPotential, UnitOfEnergy as UnitOfEnergy, UnitOfEnergyDistance as UnitOfEnergyDistance, UnitOfInformation as UnitOfInformation, UnitOfLength as UnitOfLength, UnitOfMass as UnitOfMass, UnitOfPower as UnitOfPower, UnitOfPressure as UnitOfPressure, UnitOfReactiveEnergy as UnitOfReactiveEnergy, UnitOfReactivePower as UnitOfReactivePower, UnitOfSpeed as UnitOfSpeed, UnitOfTemperature as UnitOfTemperature, UnitOfTime as UnitOfTime, UnitOfVolume as UnitOfVolume, UnitOfVolumeFlowRate as UnitOfVolumeFlowRate, UnitOfVolumetricFlux as UnitOfVolumetricFlux
 from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 
 _MM_TO_M: float
@@ -119,6 +119,11 @@ class MassConverter(BaseUnitConverter):
     _UNIT_CONVERSION: dict[str | None, float]
     VALID_UNITS: Incomplete
 
+class ApparentPowerConverter(BaseUnitConverter):
+    UNIT_CLASS: str
+    _UNIT_CONVERSION: dict[str | None, float]
+    VALID_UNITS: Incomplete
+
 class PowerConverter(BaseUnitConverter):
     UNIT_CLASS: str
     _UNIT_CONVERSION: dict[str | None, float]
@@ -134,6 +139,11 @@ class ReactiveEnergyConverter(BaseUnitConverter):
     _UNIT_CONVERSION: dict[str | None, float]
     VALID_UNITS: Incomplete
 
+class ReactivePowerConverter(BaseUnitConverter):
+    UNIT_CLASS: str
+    _UNIT_CONVERSION: dict[str | None, float]
+    VALID_UNITS: Incomplete
+
 class SpeedConverter(BaseUnitConverter):
     UNIT_CLASS: str
     _UNIT_CONVERSION: dict[str | None, float]

{homeassistant_stubs-2025.8.3.dist-info → homeassistant_stubs-2025.9.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: homeassistant-stubs
-Version: 2025.8.3
+Version: 2025.9.0
 Summary: PEP 484 typing stubs for Home Assistant Core
 Project-URL: Homepage, https://github.com/KapJI/homeassistant-stubs
 Project-URL: Bug Tracker, https://github.com/KapJI/homeassistant-stubs/issues
@@ -18,7 +18,7 @@ Classifier: Topic :: Home Automation
 Classifier: Topic :: Software Development
 Classifier: Typing :: Typed
 Requires-Python: >=3.13.2
-Requires-Dist: homeassistant==2025.8.3
+Requires-Dist: homeassistant==2025.9.0
 Description-Content-Type: text/markdown
 
 [![CI](https://github.com/KapJI/homeassistant-stubs/actions/workflows/ci.yaml/badge.svg)](https://github.com/KapJI/homeassistant-stubs/actions/workflows/ci.yaml)