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

homeassistant-stubs/components/matrix/__init__.pyi

@@ -1,4 +1,4 @@
-from .const import ATTR_FORMAT as ATTR_FORMAT, ATTR_IMAGES as ATTR_IMAGES, CONF_ROOMS_REGEX as CONF_ROOMS_REGEX, DOMAIN as DOMAIN, FORMAT_HTML as FORMAT_HTML
+from .const import ATTR_FORMAT as ATTR_FORMAT, ATTR_IMAGES as ATTR_IMAGES, ATTR_MESSAGE_ID as ATTR_MESSAGE_ID, ATTR_REACTION as ATTR_REACTION, ATTR_ROOM as ATTR_ROOM, ATTR_THREAD_ID as ATTR_THREAD_ID, CONF_ROOMS_REGEX as CONF_ROOMS_REGEX, DOMAIN as DOMAIN, FORMAT_HTML as FORMAT_HTML
 from .services import async_setup_services as async_setup_services
 from _typeshed import Incomplete
 from collections.abc import Sequence
@@ -10,6 +10,7 @@ from homeassistant.helpers.json import save_json as save_json
 from homeassistant.helpers.typing import ConfigType as ConfigType
 from homeassistant.util.json import JsonObjectType as JsonObjectType, load_json_object as load_json_object
 from nio import AsyncClient, Event, MatrixRoom as MatrixRoom
+from nio.events.room_events import RoomMessageText
 from nio.responses import Response as Response
 from typing import Final, Required, TypedDict
 
@@ -20,11 +21,13 @@ CONF_ROOMS: Final[str]
 CONF_COMMANDS: Final[str]
 CONF_WORD: Final[str]
 CONF_EXPRESSION: Final[str]
+CONF_REACTION: Final[str]
 CONF_USERNAME_REGEX: str
 EVENT_MATRIX_COMMAND: str
 DEFAULT_CONTENT_TYPE: str
 WordCommand: Incomplete
 ExpressionCommand: Incomplete
+ReactionCommand: Incomplete
 RoomAlias: Incomplete
 RoomID: Incomplete
 RoomAnyID = RoomID | RoomAlias
@@ -34,6 +37,7 @@ class ConfigCommand(TypedDict, total=False):
     rooms: list[RoomID]
     word: WordCommand
     expression: ExpressionCommand
+    reaction: ReactionCommand
 
 COMMAND_SCHEMA: Incomplete
 CONFIG_SCHEMA: Incomplete
@@ -52,10 +56,12 @@ class MatrixBot:
     _listening_rooms: dict[RoomAnyID, RoomID]
     _word_commands: dict[RoomID, dict[WordCommand, ConfigCommand]]
     _expression_commands: dict[RoomID, list[ConfigCommand]]
+    _reaction_commands: dict[RoomID, dict[ReactionCommand, ConfigCommand]]
     _unparsed_commands: Incomplete
     def __init__(self, hass: HomeAssistant, config_file: str, homeserver: str, verify_ssl: bool, username: str, password: str, listening_rooms: list[RoomAnyID], commands: list[ConfigCommand]) -> None: ...
     def _load_commands(self, commands: list[ConfigCommand]) -> None: ...
     async def _handle_room_message(self, room: MatrixRoom, message: Event) -> None: ...
+    def _get_thread_parent(self, message: RoomMessageText) -> str | None: ...
     async def _resolve_room_alias(self, room_alias_or_id: RoomAnyID) -> dict[RoomAnyID, RoomID]: ...
     async def _resolve_room_aliases(self, listening_rooms: list[RoomAnyID]) -> None: ...
     async def _join_room(self, room_id: RoomID, room_alias_or_id: RoomAnyID) -> None: ...
@@ -65,6 +71,8 @@ class MatrixBot:
     async def _login(self) -> None: ...
     async def _handle_room_send(self, target_room: RoomAnyID, message_type: str, content: dict) -> None: ...
     async def _handle_multi_room_send(self, target_rooms: Sequence[RoomAnyID], message_type: str, content: dict) -> None: ...
-    async def _send_image(self, image_path: str, target_rooms: Sequence[RoomAnyID]) -> None: ...
+    async def _send_image(self, image_path: str, target_rooms: Sequence[RoomAnyID], thread_id: str | None) -> None: ...
     async def _send_message(self, message: str, target_rooms: list[RoomAnyID], data: dict | None) -> None: ...
+    async def _send_reaction(self, reaction: str, target_room: RoomAnyID, message_id: str) -> None: ...
     async def handle_send_message(self, service: ServiceCall) -> None: ...
+    async def handle_send_reaction(self, service: ServiceCall) -> None: ...

homeassistant-stubs/components/matrix/const.pyi

@@ -1,7 +1,12 @@
 DOMAIN: str
 SERVICE_SEND_MESSAGE: str
+SERVICE_REACT: str
 FORMAT_HTML: str
 FORMAT_TEXT: str
 ATTR_FORMAT: str
 ATTR_IMAGES: str
+ATTR_THREAD_ID: str
+ATTR_REACTION: str
+ATTR_ROOM: str
+ATTR_MESSAGE_ID: str
 CONF_ROOMS_REGEX: str

homeassistant-stubs/components/matrix/services.pyi

@@ -1,5 +1,5 @@
 from . import MatrixBot as MatrixBot
-from .const import ATTR_FORMAT as ATTR_FORMAT, ATTR_IMAGES as ATTR_IMAGES, CONF_ROOMS_REGEX as CONF_ROOMS_REGEX, DOMAIN as DOMAIN, FORMAT_HTML as FORMAT_HTML, FORMAT_TEXT as FORMAT_TEXT, SERVICE_SEND_MESSAGE as SERVICE_SEND_MESSAGE
+from .const import ATTR_FORMAT as ATTR_FORMAT, ATTR_IMAGES as ATTR_IMAGES, ATTR_MESSAGE_ID as ATTR_MESSAGE_ID, ATTR_REACTION as ATTR_REACTION, ATTR_ROOM as ATTR_ROOM, ATTR_THREAD_ID as ATTR_THREAD_ID, CONF_ROOMS_REGEX as CONF_ROOMS_REGEX, DOMAIN as DOMAIN, FORMAT_HTML as FORMAT_HTML, FORMAT_TEXT as FORMAT_TEXT, SERVICE_REACT as SERVICE_REACT, SERVICE_SEND_MESSAGE as SERVICE_SEND_MESSAGE
 from _typeshed import Incomplete
 from homeassistant.components.notify import ATTR_DATA as ATTR_DATA, ATTR_MESSAGE as ATTR_MESSAGE, ATTR_TARGET as ATTR_TARGET
 from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, callback as callback
@@ -7,7 +7,9 @@ from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as Se
 MESSAGE_FORMATS: Incomplete
 DEFAULT_MESSAGE_FORMAT = FORMAT_TEXT
 SERVICE_SCHEMA_SEND_MESSAGE: Incomplete
+SERVICE_SCHEMA_REACT: Incomplete
 
 async def _handle_send_message(call: ServiceCall) -> None: ...
+async def _handle_react(call: ServiceCall) -> None: ...
 @callback
 def async_setup_services(hass: HomeAssistant) -> None: ...

homeassistant-stubs/components/matter/__init__.pyi

@@ -6,6 +6,8 @@ from .const import CONF_INTEGRATION_CREATED_ADDON as CONF_INTEGRATION_CREATED_AD
 from .discovery import SUPPORTED_PLATFORMS as SUPPORTED_PLATFORMS
 from .helpers import MatterEntryData as MatterEntryData, get_matter as get_matter, get_node_from_device_entry as get_node_from_device_entry, node_from_ha_device_id as node_from_ha_device_id
 from .models import MatterDeviceInfo as MatterDeviceInfo
+from .services import async_setup_services as async_setup_services
+from _typeshed import Incomplete
 from functools import cache
 from homeassistant.components.hassio import AddonError as AddonError, AddonManager as AddonManager, AddonState as AddonState
 from homeassistant.config_entries import ConfigEntry as ConfigEntry, ConfigEntryState as ConfigEntryState
@@ -15,14 +17,17 @@ from homeassistant.exceptions import ConfigEntryNotReady as ConfigEntryNotReady
 from homeassistant.helpers import device_registry as dr
 from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
 from homeassistant.helpers.issue_registry import IssueSeverity as IssueSeverity, async_create_issue as async_create_issue, async_delete_issue as async_delete_issue
+from homeassistant.helpers.typing import ConfigType as ConfigType
 from matter_server.client import MatterClient
 
 CONNECT_TIMEOUT: int
 LISTEN_READY_TIMEOUT: int
+CONFIG_SCHEMA: Incomplete
 
 @callback
 @cache
 def get_matter_device_info(hass: HomeAssistant, device_id: str) -> MatterDeviceInfo | None: ...
+async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
 async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...
 async def _client_listen(hass: HomeAssistant, entry: ConfigEntry, matter_client: MatterClient, init_ready: asyncio.Event) -> None: ...
 async def async_unload_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool: ...

homeassistant-stubs/components/matter/binary_sensor.pyi

@@ -13,7 +13,7 @@ from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
-@dataclass(frozen=True)
+@dataclass(frozen=True, kw_only=True)
 class MatterBinarySensorEntityDescription(BinarySensorEntityDescription, MatterEntityDescription): ...
 
 class MatterBinarySensor(MatterEntity, BinarySensorEntity):

homeassistant-stubs/components/matter/button.pyi

@@ -13,7 +13,7 @@ from typing import Any
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
-@dataclass(frozen=True)
+@dataclass(frozen=True, kw_only=True)
 class MatterButtonEntityDescription(ButtonEntityDescription, MatterEntityDescription):
     command: Callable[[], Any] | None = ...
 

homeassistant-stubs/components/matter/climate.pyi

@@ -1,8 +1,9 @@
-from .entity import MatterEntity as MatterEntity
+from .entity import MatterEntity as MatterEntity, MatterEntityDescription as MatterEntityDescription
 from .helpers import get_matter as get_matter
 from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from _typeshed import Incomplete
 from chip.clusters import Objects as clusters
+from dataclasses import dataclass
 from enum import IntEnum
 from homeassistant.components.climate import ATTR_HVAC_MODE as ATTR_HVAC_MODE, ATTR_TARGET_TEMP_HIGH as ATTR_TARGET_TEMP_HIGH, ATTR_TARGET_TEMP_LOW as ATTR_TARGET_TEMP_LOW, ClimateEntity as ClimateEntity, ClimateEntityDescription as ClimateEntityDescription, ClimateEntityFeature as ClimateEntityFeature, DEFAULT_MAX_TEMP as DEFAULT_MAX_TEMP, DEFAULT_MIN_TEMP as DEFAULT_MIN_TEMP, HVACAction as HVACAction, HVACMode as HVACMode
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
@@ -11,6 +12,7 @@ from homeassistant.core import HomeAssistant as HomeAssistant, callback as callb
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
 from typing import Any
 
+HUMIDITY_SCALING_FACTOR: int
 TEMPERATURE_SCALING_FACTOR: int
 HVAC_SYSTEM_MODE_MAP: Incomplete
 SINGLE_SETPOINT_DEVICES: set[tuple[int, int]]
@@ -31,6 +33,9 @@ class ThermostatRunningState(IntEnum):
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
+@dataclass(frozen=True, kw_only=True)
+class MatterClimateEntityDescription(ClimateEntityDescription, MatterEntityDescription): ...
+
 class MatterClimate(MatterEntity, ClimateEntity):
     _attr_temperature_unit: str
     _attr_hvac_mode: HVACMode
@@ -39,6 +44,7 @@ class MatterClimate(MatterEntity, ClimateEntity):
     async def async_set_temperature(self, **kwargs: Any) -> None: ...
     async def async_set_hvac_mode(self, hvac_mode: HVACMode) -> None: ...
     _attr_current_temperature: Incomplete
+    _attr_current_humidity: Incomplete
     _attr_hvac_action: Incomplete
     _attr_target_temperature: Incomplete
     _attr_target_temperature_high: Incomplete

homeassistant-stubs/components/matter/cover.pyi

@@ -1,8 +1,9 @@
 from .const import LOGGER as LOGGER
-from .entity import MatterEntity as MatterEntity
+from .entity import MatterEntity as MatterEntity, MatterEntityDescription as MatterEntityDescription
 from .helpers import get_matter as get_matter
 from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from _typeshed import Incomplete
+from dataclasses import dataclass
 from enum import IntEnum
 from homeassistant.components.cover import ATTR_POSITION as ATTR_POSITION, ATTR_TILT_POSITION as ATTR_TILT_POSITION, CoverDeviceClass as CoverDeviceClass, CoverEntity as CoverEntity, CoverEntityDescription as CoverEntityDescription, CoverEntityFeature as CoverEntityFeature
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
@@ -22,8 +23,11 @@ class OperationalStatus(IntEnum):
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
+@dataclass(frozen=True, kw_only=True)
+class MatterCoverEntityDescription(CoverEntityDescription, MatterEntityDescription): ...
+
 class MatterCover(MatterEntity, CoverEntity):
-    entity_description: CoverEntityDescription
+    entity_description: MatterCoverEntityDescription
     @property
     def is_closed(self) -> bool | None: ...
     async def async_stop_cover(self, **kwargs: Any) -> None: ...

homeassistant-stubs/components/matter/entity.pyi

@@ -17,10 +17,11 @@ from propcache.api import cached_property
 from typing import Any, Concatenate
 
 LOGGER: Incomplete
+VENDOR_LABELING_LIST: dict[int, dict[int, list[str] | None]]
 
 def catch_matter_error[_R, **P](func: Callable[Concatenate[MatterEntity, P], Coroutine[Any, Any, _R]]) -> Callable[Concatenate[MatterEntity, P], Coroutine[Any, Any, _R]]: ...
 
-@dataclass(frozen=True)
+@dataclass(frozen=True, kw_only=True)
 class MatterEntityDescription(EntityDescription):
     device_to_ha: Callable[[Any], Any] | None = ...
     ha_to_device: Callable[[Any], Any] | None = ...
@@ -41,8 +42,9 @@ class MatterEntity(Entity):
     _attr_device_info: Incomplete
     _attr_available: Incomplete
     _attr_translation_key: Incomplete
-    _attr_name: Incomplete
     def __init__(self, matter_client: MatterClient, endpoint: MatterEndpoint, entity_info: MatterEntityInfo) -> None: ...
+    def _find_matching_labels(self) -> list[str]: ...
+    def _get_name_modifier(self) -> str | None: ...
     async def async_added_to_hass(self) -> None: ...
     @cached_property
     def name(self) -> str | UndefinedType | None: ...

homeassistant-stubs/components/matter/event.pyi

@@ -1,7 +1,8 @@
-from .entity import MatterEntity as MatterEntity
+from .entity import MatterEntity as MatterEntity, MatterEntityDescription as MatterEntityDescription
 from .helpers import get_matter as get_matter
 from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from _typeshed import Incomplete
+from dataclasses import dataclass
 from homeassistant.components.event import EventDeviceClass as EventDeviceClass, EventEntity as EventEntity, EventEntityDescription as EventEntityDescription
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import Platform as Platform
@@ -15,6 +16,9 @@ EVENT_TYPES_MAP: Incomplete
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
+@dataclass(frozen=True, kw_only=True)
+class MatterEventEntityDescription(EventEntityDescription, MatterEntityDescription): ...
+
 class MatterEventEntity(MatterEntity, EventEntity):
     _attr_event_types: Incomplete
     def __init__(self, *args: Any, **kwargs: Any) -> None: ...

homeassistant-stubs/components/matter/fan.pyi

@@ -1,7 +1,8 @@
-from .entity import MatterEntity as MatterEntity
+from .entity import MatterEntity as MatterEntity, MatterEntityDescription as MatterEntityDescription
 from .helpers import get_matter as get_matter
 from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from _typeshed import Incomplete
+from dataclasses import dataclass
 from homeassistant.components.fan import DIRECTION_FORWARD as DIRECTION_FORWARD, DIRECTION_REVERSE as DIRECTION_REVERSE, FanEntity as FanEntity, FanEntityDescription as FanEntityDescription, FanEntityFeature as FanEntityFeature
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import Platform as Platform
@@ -23,6 +24,9 @@ PRESET_SLEEP_WIND: str
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
+@dataclass(frozen=True, kw_only=True)
+class MatterFanEntityDescription(FanEntityDescription, MatterEntityDescription): ...
+
 class MatterFan(MatterEntity, FanEntity):
     _last_known_preset_mode: str | None
     _last_known_percentage: int

homeassistant-stubs/components/matter/light.pyi

@@ -1,9 +1,10 @@
 from .const import LOGGER as LOGGER
-from .entity import MatterEntity as MatterEntity
+from .entity import MatterEntity as MatterEntity, MatterEntityDescription as MatterEntityDescription
 from .helpers import get_matter as get_matter
 from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from .util import convert_to_hass_hs as convert_to_hass_hs, convert_to_hass_xy as convert_to_hass_xy, convert_to_matter_hs as convert_to_matter_hs, convert_to_matter_xy as convert_to_matter_xy, renormalize as renormalize
 from _typeshed import Incomplete
+from dataclasses import dataclass
 from homeassistant.components.light import ATTR_BRIGHTNESS as ATTR_BRIGHTNESS, ATTR_COLOR_TEMP_KELVIN as ATTR_COLOR_TEMP_KELVIN, ATTR_HS_COLOR as ATTR_HS_COLOR, ATTR_TRANSITION as ATTR_TRANSITION, ATTR_XY_COLOR as ATTR_XY_COLOR, ColorMode as ColorMode, DEFAULT_MAX_KELVIN as DEFAULT_MAX_KELVIN, DEFAULT_MIN_KELVIN as DEFAULT_MIN_KELVIN, LightEntity as LightEntity, LightEntityDescription as LightEntityDescription, LightEntityFeature as LightEntityFeature, filter_supported_color_modes as filter_supported_color_modes
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import Platform as Platform
@@ -16,8 +17,11 @@ TRANSITION_BLOCKLIST: Incomplete
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
+@dataclass(frozen=True, kw_only=True)
+class MatterLightEntityDescription(LightEntityDescription, MatterEntityDescription): ...
+
 class MatterLight(MatterEntity, LightEntity):
-    entity_description: LightEntityDescription
+    entity_description: MatterLightEntityDescription
     _supports_brightness: bool
     _supports_color: bool
     _supports_color_temperature: bool

homeassistant-stubs/components/matter/lock.pyi

@@ -1,9 +1,10 @@
 import asyncio
 from .const import LOGGER as LOGGER
-from .entity import MatterEntity as MatterEntity
+from .entity import MatterEntity as MatterEntity, MatterEntityDescription as MatterEntityDescription
 from .helpers import get_matter as get_matter
 from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from _typeshed import Incomplete
+from dataclasses import dataclass
 from homeassistant.components.lock import LockEntity as LockEntity, LockEntityDescription as LockEntityDescription, LockEntityFeature as LockEntityFeature
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import ATTR_CODE as ATTR_CODE, Platform as Platform
@@ -17,6 +18,9 @@ DoorLockFeature: Incomplete
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
+@dataclass(frozen=True, kw_only=True)
+class MatterLockEntityDescription(LockEntityDescription, MatterEntityDescription): ...
+
 class MatterLock(MatterEntity, LockEntity):
     _feature_map: int | None
     _optimistic_timer: asyncio.TimerHandle | None

homeassistant-stubs/components/matter/models.pyi

@@ -1,9 +1,9 @@
+from .entity import MatterEntityDescription as MatterEntityDescription
 from _typeshed import Incomplete
 from chip.clusters import Objects as clusters
 from chip.clusters.Objects import Cluster as Cluster, ClusterAttributeDescriptor as ClusterAttributeDescriptor
 from dataclasses import dataclass
 from homeassistant.const import Platform as Platform
-from homeassistant.helpers.entity import EntityDescription as EntityDescription
 from matter_server.client.models.device_types import DeviceType as DeviceType
 from matter_server.client.models.node import MatterEndpoint as MatterEndpoint
 from typing import Any, TypedDict
@@ -23,7 +23,7 @@ class MatterEntityInfo:
     endpoint: MatterEndpoint
     platform: Platform
     attributes_to_watch: list[type[ClusterAttributeDescriptor]]
-    entity_description: EntityDescription
+    entity_description: MatterEntityDescription
     entity_class: type
     discovery_schema: MatterDiscoverySchema
     @property
@@ -32,12 +32,13 @@ class MatterEntityInfo:
 @dataclass
 class MatterDiscoverySchema:
     platform: Platform
-    entity_description: EntityDescription
+    entity_description: MatterEntityDescription
     entity_class: type
     required_attributes: tuple[type[ClusterAttributeDescriptor], ...]
     device_type: tuple[type[DeviceType] | DeviceType, ...] | None = ...
     not_device_type: tuple[type[DeviceType] | DeviceType, ...] | None = ...
     vendor_id: tuple[int, ...] | None = ...
+    product_id: tuple[int, ...] | None = ...
     product_name: tuple[str, ...] | None = ...
     endpoint_id: tuple[int, ...] | None = ...
     absent_attributes: tuple[type[ClusterAttributeDescriptor], ...] | None = ...

homeassistant-stubs/components/matter/number.pyi

@@ -14,7 +14,7 @@ from typing import Any
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
-@dataclass(frozen=True)
+@dataclass(frozen=True, kw_only=True)
 class MatterNumberEntityDescription(NumberEntityDescription, MatterEntityDescription): ...
 
 @dataclass(frozen=True, kw_only=True)

homeassistant-stubs/components/matter/select.pyi

@@ -13,6 +13,8 @@ from homeassistant.const import EntityCategory as EntityCategory, Platform as Pl
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
 
+DOOR_LOCK_OPERATING_MODE_MAP: Incomplete
+DOOR_LOCK_OPERATING_MODE_MAP_REVERSE: Incomplete
 NUMBER_OF_RINSES_STATE_MAP: Incomplete
 NUMBER_OF_RINSES_STATE_MAP_REVERSE: Incomplete
 PUMP_OPERATION_MODE_MAP: Incomplete
@@ -21,7 +23,7 @@ type SelectCluster = clusters.ModeSelect | clusters.OvenMode | clusters.LaundryW
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
-@dataclass(frozen=True)
+@dataclass(frozen=True, kw_only=True)
 class MatterSelectEntityDescription(SelectEntityDescription, MatterEntityDescription): ...
 
 @dataclass(frozen=True, kw_only=True)
@@ -56,6 +58,12 @@ class MatterModeSelectEntity(MatterAttributeSelectEntity):
     @callback
     def _update_from_device(self) -> None: ...
 
+class MatterDoorLockOperatingModeSelectEntity(MatterAttributeSelectEntity):
+    entity_description: MatterMapSelectEntityDescription
+    _attr_options: Incomplete
+    @callback
+    def _update_from_device(self) -> None: ...
+
 class MatterListSelectEntity(MatterEntity, SelectEntity):
     entity_description: MatterListSelectEntityDescription
     async def async_select_option(self, option: str) -> None: ...

homeassistant-stubs/components/matter/sensor.pyi

@@ -5,6 +5,7 @@ from _typeshed import Incomplete
 from chip.clusters.ClusterObjects import ClusterAttributeDescriptor as ClusterAttributeDescriptor
 from chip.clusters.Types import Nullable as Nullable
 from dataclasses import dataclass, field
+from datetime import datetime
 from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass, SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription, SensorStateClass as SensorStateClass
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import CONCENTRATION_MICROGRAMS_PER_CUBIC_METER as CONCENTRATION_MICROGRAMS_PER_CUBIC_METER, CONCENTRATION_PARTS_PER_MILLION as CONCENTRATION_PARTS_PER_MILLION, EntityCategory as EntityCategory, LIGHT_LUX as LIGHT_LUX, PERCENTAGE as PERCENTAGE, Platform as Platform, REVOLUTIONS_PER_MINUTE as REVOLUTIONS_PER_MINUTE, UnitOfApparentPower as UnitOfApparentPower, UnitOfElectricCurrent as UnitOfElectricCurrent, UnitOfElectricPotential as UnitOfElectricPotential, UnitOfEnergy as UnitOfEnergy, UnitOfPower as UnitOfPower, UnitOfPressure as UnitOfPressure, UnitOfReactivePower as UnitOfReactivePower, UnitOfTemperature as UnitOfTemperature, UnitOfTime as UnitOfTime, UnitOfVolume as UnitOfVolume, UnitOfVolumeFlowRate as UnitOfVolumeFlowRate
@@ -16,17 +17,24 @@ AIR_QUALITY_MAP: Incomplete
 CONTAMINATION_STATE_MAP: Incomplete
 EVE_CLUSTER_WEATHER_MAP: Incomplete
 OPERATIONAL_STATE_MAP: Incomplete
+OPERATIONAL_STATE_ERROR_MAP: Incomplete
 RVC_OPERATIONAL_STATE_MAP: Incomplete
+RVC_OPERATIONAL_STATE_ERROR_MAP: Incomplete
 BOOST_STATE_MAP: Incomplete
 CHARGE_STATE_MAP: Incomplete
 DEM_OPT_OUT_STATE_MAP: Incomplete
 ESA_STATE_MAP: Incomplete
 EVSE_FAULT_STATE_MAP: Incomplete
 PUMP_CONTROL_MODE_MAP: Incomplete
+MATTER_2000_TO_UNIX_EPOCH_OFFSET: int
+HUMIDITY_SCALING_FACTOR: int
+TEMPERATURE_SCALING_FACTOR: int
 
+def matter_epoch_seconds_to_utc(x: int | None) -> datetime | None: ...
+def matter_epoch_microseconds_to_utc(x: int | None) -> datetime | None: ...
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
-@dataclass(frozen=True)
+@dataclass(frozen=True, kw_only=True)
 class MatterSensorEntityDescription(SensorEntityDescription, MatterEntityDescription): ...
 
 @dataclass(frozen=True, kw_only=True)

homeassistant-stubs/components/matter/services.pyi

@@ -0,0 +1,11 @@
+from .const import DOMAIN as DOMAIN
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers import service as service
+
+ATTR_DURATION: str
+ATTR_EMERGENCY_BOOST: str
+ATTR_TEMPORARY_SETPOINT: str
+SERVICE_WATER_HEATER_BOOST: str
+
+@callback
+def async_setup_services(hass: HomeAssistant) -> None: ...

homeassistant-stubs/components/matter/switch.pyi

@@ -16,6 +16,9 @@ EVSE_SUPPLY_STATE_MAP: Incomplete
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
+@dataclass(frozen=True, kw_only=True)
+class MatterSwitchEntityDescription(SwitchEntityDescription, MatterEntityDescription): ...
+
 class MatterSwitch(MatterEntity, SwitchEntity):
     _platform_translation_key: str
     async def async_turn_on(self, **kwargs: Any) -> None: ...
@@ -34,13 +37,13 @@ class MatterGenericCommandSwitch(MatterSwitch):
     def _update_from_device(self) -> None: ...
     async def send_device_command(self, command: ClusterCommand, command_timeout: int | None = None, **kwargs: Any) -> None: ...
 
-@dataclass(frozen=True)
+@dataclass(frozen=True, kw_only=True)
 class MatterGenericCommandSwitchEntityDescription(SwitchEntityDescription, MatterEntityDescription):
     on_command: Callable[[], Any] | None = ...
     off_command: Callable[[], Any] | None = ...
     command_timeout: int | None = ...
 
-@dataclass(frozen=True)
+@dataclass(frozen=True, kw_only=True)
 class MatterNumericSwitchEntityDescription(SwitchEntityDescription, MatterEntityDescription): ...
 
 class MatterNumericSwitch(MatterSwitch):

homeassistant-stubs/components/matter/update.pyi

@@ -1,4 +1,4 @@
-from .entity import MatterEntity as MatterEntity
+from .entity import MatterEntity as MatterEntity, MatterEntityDescription as MatterEntityDescription
 from .helpers import get_matter as get_matter
 from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from _typeshed import Incomplete
@@ -28,6 +28,9 @@ class MatterUpdateExtraStoredData(ExtraStoredData):
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
+@dataclass(frozen=True, kw_only=True)
+class MatterUpdateEntityDescription(UpdateEntityDescription, MatterEntityDescription): ...
+
 class MatterUpdate(MatterEntity, UpdateEntity):
     _attr_should_poll: bool
     _software_update: MatterSoftwareVersion | None

homeassistant-stubs/components/matter/vacuum.pyi

@@ -1,8 +1,9 @@
-from .entity import MatterEntity as MatterEntity
+from .entity import MatterEntity as MatterEntity, MatterEntityDescription as MatterEntityDescription
 from .helpers import get_matter as get_matter
 from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from _typeshed import Incomplete
 from chip.clusters import Objects as clusters
+from dataclasses import dataclass
 from enum import IntEnum
 from homeassistant.components.vacuum import StateVacuumEntity as StateVacuumEntity, StateVacuumEntityDescription as StateVacuumEntityDescription, VacuumActivity as VacuumActivity, VacuumEntityFeature as VacuumEntityFeature
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
@@ -28,10 +29,13 @@ class ModeTag(IntEnum):
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
+@dataclass(frozen=True, kw_only=True)
+class MatterStateVacuumEntityDescription(StateVacuumEntityDescription, MatterEntityDescription): ...
+
 class MatterVacuum(MatterEntity, StateVacuumEntity):
     _last_accepted_commands: list[int] | None
     _supported_run_modes: dict[int, clusters.RvcRunMode.Structs.ModeOptionStruct] | None
-    entity_description: StateVacuumEntityDescription
+    entity_description: MatterStateVacuumEntityDescription
     _platform_translation_key: str
     def _get_run_mode_by_tag(self, tag: ModeTag) -> clusters.RvcRunMode.Structs.ModeOptionStruct | None: ...
     async def async_stop(self, **kwargs: Any) -> None: ...

homeassistant-stubs/components/matter/valve.pyi

@@ -1,7 +1,8 @@
-from .entity import MatterEntity as MatterEntity
+from .entity import MatterEntity as MatterEntity, MatterEntityDescription as MatterEntityDescription
 from .helpers import get_matter as get_matter
 from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from _typeshed import Incomplete
+from dataclasses import dataclass
 from homeassistant.components.valve import ValveDeviceClass as ValveDeviceClass, ValveEntity as ValveEntity, ValveEntityDescription as ValveEntityDescription, ValveEntityFeature as ValveEntityFeature
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import Platform as Platform
@@ -13,9 +14,12 @@ ValveStateEnum: Incomplete
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
+@dataclass(frozen=True, kw_only=True)
+class MatterValveEntityDescription(ValveEntityDescription, MatterEntityDescription): ...
+
 class MatterValve(MatterEntity, ValveEntity):
     _feature_map: int | None
-    entity_description: ValveEntityDescription
+    entity_description: MatterValveEntityDescription
     _platform_translation_key: str
     async def async_open_valve(self) -> None: ...
     async def async_close_valve(self) -> None: ...

homeassistant-stubs/components/matter/water_heater.pyi

@@ -1,20 +1,26 @@
-from .entity import MatterEntity as MatterEntity
+from .entity import MatterEntity as MatterEntity, MatterEntityDescription as MatterEntityDescription
 from .helpers import get_matter as get_matter
 from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from _typeshed import Incomplete
 from chip.clusters import Objects as clusters
+from dataclasses import dataclass
 from homeassistant.components.water_heater import STATE_ECO as STATE_ECO, STATE_HIGH_DEMAND as STATE_HIGH_DEMAND, STATE_OFF as STATE_OFF, WaterHeaterEntity as WaterHeaterEntity, WaterHeaterEntityDescription as WaterHeaterEntityDescription, WaterHeaterEntityFeature as WaterHeaterEntityFeature
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import ATTR_TEMPERATURE as ATTR_TEMPERATURE, PRECISION_WHOLE as PRECISION_WHOLE, Platform as Platform, UnitOfTemperature as UnitOfTemperature
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
 from typing import Any
 
 TEMPERATURE_SCALING_FACTOR: int
 WATER_HEATER_SYSTEM_MODE_MAP: Incomplete
+DEFAULT_BOOST_DURATION: int
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
+@dataclass(frozen=True, kw_only=True)
+class MatterWaterHeaterEntityDescription(WaterHeaterEntityDescription, MatterEntityDescription): ...
+
 class MatterWaterHeater(MatterEntity, WaterHeaterEntity):
     _attr_current_temperature: float | None
     _attr_current_operation: str
@@ -24,6 +30,7 @@ class MatterWaterHeater(MatterEntity, WaterHeaterEntity):
     _attr_target_temperature: float | None
     _attr_temperature_unit: Incomplete
     _platform_translation_key: str
+    async def async_set_boost(self, duration: int, emergency_boost: bool = False, temporary_setpoint: int | None = None) -> None: ...
     async def async_set_temperature(self, **kwargs: Any) -> None: ...
     async def async_set_operation_mode(self, operation_mode: str) -> None: ...
     async def async_turn_on(self, **kwargs: Any) -> None: ...

homeassistant-stubs/components/mcp/__init__.pyi

@@ -1,14 +1,9 @@
 from .const import DOMAIN as DOMAIN
 from .coordinator import ModelContextProtocolCoordinator
-from .types import ModelContextProtocolConfigEntry
 from dataclasses import dataclass
-from homeassistant.core import HomeAssistant
 from homeassistant.helpers import llm
 
-__all__ = ['DOMAIN', 'async_setup_entry', 'async_unload_entry']
-
-async def async_setup_entry(hass: HomeAssistant, entry: ModelContextProtocolConfigEntry) -> bool: ...
-async def async_unload_entry(hass: HomeAssistant, entry: ModelContextProtocolConfigEntry) -> bool: ...
+__all__ = ['DOMAIN']
 
 @dataclass(kw_only=True)
 class ModelContextProtocolAPI(llm.API):

homeassistant-stubs/components/mcp/config_flow.pyi

@@ -1,9 +1,10 @@
 from . import async_get_config_entry_implementation as async_get_config_entry_implementation
 from .application_credentials import authorization_server_context as authorization_server_context
-from .const import CONF_ACCESS_TOKEN as CONF_ACCESS_TOKEN, CONF_AUTHORIZATION_URL as CONF_AUTHORIZATION_URL, CONF_TOKEN_URL as CONF_TOKEN_URL, DOMAIN as DOMAIN
+from .const import CONF_ACCESS_TOKEN as CONF_ACCESS_TOKEN, CONF_AUTHORIZATION_URL as CONF_AUTHORIZATION_URL, CONF_SCOPE as CONF_SCOPE, CONF_TOKEN_URL as CONF_TOKEN_URL, DOMAIN as DOMAIN
 from .coordinator import TokenManager as TokenManager, mcp_client as mcp_client
 from _typeshed import Incomplete
 from collections.abc import Mapping
+from dataclasses import dataclass
 from homeassistant.components.application_credentials import AuthorizationServer as AuthorizationServer
 from homeassistant.config_entries import ConfigFlowResult as ConfigFlowResult, SOURCE_REAUTH as SOURCE_REAUTH
 from homeassistant.const import CONF_TOKEN as CONF_TOKEN, CONF_URL as CONF_URL
@@ -16,8 +17,14 @@ _LOGGER: Incomplete
 STEP_USER_DATA_SCHEMA: Incomplete
 OAUTH_DISCOVERY_ENDPOINT: str
 MCP_DISCOVERY_HEADERS: Incomplete
+EXAMPLE_URL: str
 
-async def async_discover_oauth_config(hass: HomeAssistant, mcp_server_url: str) -> AuthorizationServer: ...
+@dataclass
+class OAuthConfig:
+    authorization_server: AuthorizationServer
+    scopes: list[str] | None = ...
+
+async def async_discover_oauth_config(hass: HomeAssistant, mcp_server_url: str) -> OAuthConfig: ...
 async def validate_input(hass: HomeAssistant, data: dict[str, Any], token_manager: TokenManager | None = None) -> dict[str, Any]: ...
 
 class ModelContextProtocolConfigFlow(AbstractOAuth2FlowHandler, domain=DOMAIN):
@@ -25,10 +32,13 @@ class ModelContextProtocolConfigFlow(AbstractOAuth2FlowHandler, domain=DOMAIN):
     DOMAIN = DOMAIN
     logger = _LOGGER
     data: dict[str, Any]
+    oauth_config: OAuthConfig | None
     def __init__(self) -> None: ...
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_auth_discovery(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     def authorization_server(self) -> AuthorizationServer: ...
+    @property
+    def extra_authorize_data(self) -> dict: ...
     async def async_step_credentials_choice(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_new_credentials(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     async def async_step_pick_implementation(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...

homeassistant-stubs/components/mcp/const.pyi

@@ -2,3 +2,4 @@ DOMAIN: str
 CONF_ACCESS_TOKEN: str
 CONF_AUTHORIZATION_URL: str
 CONF_TOKEN_URL: str
+CONF_SCOPE: str

homeassistant-stubs/components/mcp/coordinator.pyi

@@ -15,7 +15,7 @@ from mcp.client.session import ClientSession
 _LOGGER: Incomplete
 UPDATE_INTERVAL: Incomplete
 TIMEOUT: int
-TokenManager = Callable[[], Awaitable[str]]
+type TokenManager = Callable[[], Awaitable[str]]
 
 @asynccontextmanager
 async def mcp_client(url: str, token_manager: TokenManager | None = None) -> AsyncGenerator[ClientSession]: ...