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

homeassistant-stubs/components/matrix/__init__.pyi

@@ -1,4 +1,5 @@
-from .const import 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
+from .services import async_setup_services as async_setup_services
 from _typeshed import Incomplete
 from collections.abc import Sequence
 from homeassistant.components.notify import ATTR_DATA as ATTR_DATA, ATTR_MESSAGE as ATTR_MESSAGE, ATTR_TARGET as ATTR_TARGET
@@ -9,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
 
@@ -19,16 +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
-CONF_ROOMS_REGEX: str
 EVENT_MATRIX_COMMAND: str
 DEFAULT_CONTENT_TYPE: str
-MESSAGE_FORMATS: Incomplete
-DEFAULT_MESSAGE_FORMAT = FORMAT_TEXT
-ATTR_FORMAT: str
-ATTR_IMAGES: str
 WordCommand: Incomplete
 ExpressionCommand: Incomplete
+ReactionCommand: Incomplete
 RoomAlias: Incomplete
 RoomID: Incomplete
 RoomAnyID = RoomID | RoomAlias
@@ -38,10 +37,10 @@ class ConfigCommand(TypedDict, total=False):
     rooms: list[RoomID]
     word: WordCommand
     expression: ExpressionCommand
+    reaction: ReactionCommand
 
 COMMAND_SCHEMA: Incomplete
 CONFIG_SCHEMA: Incomplete
-SERVICE_SCHEMA_SEND_MESSAGE: Incomplete
 
 async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
 
@@ -57,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: ...
@@ -70,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,4 +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

@@ -0,0 +1,15 @@
+from . import MatrixBot as MatrixBot
+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
+
+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,13 +17,15 @@ 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):
-    measurement_to_ha: Callable[[Any], Any] | None = ...
-    ha_to_native_value: Callable[[Any], Any] | None = ...
+    device_to_ha: Callable[[Any], Any] | None = ...
+    ha_to_device: Callable[[Any], Any] | None = ...
+    command_timeout: int | None = ...
 
 class MatterEntity(Entity):
     _attr_has_entity_name: bool
@@ -40,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
@@ -32,7 +36,7 @@ class MatterLight(MatterEntity, LightEntity):
     def _get_xy_color(self) -> tuple[float, float]: ...
     def _get_hs_color(self) -> tuple[float, float]: ...
     def _get_color_temperature(self) -> int: ...
-    def _get_brightness(self) -> int: ...
+    def _get_brightness(self) -> int | None: ...
     def _get_color_mode(self) -> ColorMode: ...
     async def async_turn_on(self, **kwargs: Any) -> None: ...
     async def async_turn_off(self, **kwargs: Any) -> None: ...

homeassistant-stubs/components/matter/lock.pyi

@@ -1,24 +1,34 @@
 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
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from matter_server.common.models import EventType, MatterNodeEvent as MatterNodeEvent
 from typing import Any
 
+DOOR_LOCK_OPERATION_SOURCE: Incomplete
 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
     _platform_translation_key: str
+    _attr_changed_by: str
+    async def async_added_to_hass(self) -> None: ...
+    @callback
+    def _on_matter_node_event(self, event: EventType, node_event: MatterNodeEvent) -> None: ...
     @property
     def code_format(self) -> str | None: ...
     _attr_is_locking: bool

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

@@ -2,18 +2,30 @@ from .entity import MatterEntity as MatterEntity, MatterEntityDescription as Mat
 from .helpers import get_matter as get_matter
 from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from _typeshed import Incomplete
+from chip.clusters.ClusterObjects import ClusterAttributeDescriptor as ClusterAttributeDescriptor, ClusterCommand as ClusterCommand
+from collections.abc import Callable as Callable
 from dataclasses import dataclass
 from homeassistant.components.number import NumberDeviceClass as NumberDeviceClass, NumberEntity as NumberEntity, NumberEntityDescription as NumberEntityDescription, NumberMode as NumberMode
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
-from homeassistant.const import EntityCategory as EntityCategory, Platform as Platform, UnitOfLength as UnitOfLength, UnitOfTemperature as UnitOfTemperature, UnitOfTime as UnitOfTime
+from homeassistant.const import EntityCategory as EntityCategory, PERCENTAGE as PERCENTAGE, Platform as Platform, UnitOfLength as UnitOfLength, UnitOfTemperature as UnitOfTemperature, UnitOfTime as UnitOfTime
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+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)
+class MatterRangeNumberEntityDescription(NumberEntityDescription, MatterEntityDescription):
+    ha_to_device: Callable[[Any], Any] = ...
+    min_attribute: type[ClusterAttributeDescriptor] | None = ...
+    max_attribute: type[ClusterAttributeDescriptor]
+    format_min_value: Callable[[float], float] = ...
+    format_max_value: Callable[[float], float] = ...
+    command: Callable[[int], ClusterCommand]
+
 class MatterNumber(MatterEntity, NumberEntity):
     entity_description: MatterNumberEntityDescription
     async def async_set_native_value(self, value: float) -> None: ...
@@ -21,4 +33,20 @@ class MatterNumber(MatterEntity, NumberEntity):
     @callback
     def _update_from_device(self) -> None: ...
 
+class MatterRangeNumber(MatterEntity, NumberEntity):
+    entity_description: MatterRangeNumberEntityDescription
+    async def async_set_native_value(self, value: float) -> None: ...
+    _attr_native_value: Incomplete
+    _attr_native_min_value: Incomplete
+    _attr_native_max_value: Incomplete
+    @callback
+    def _update_from_device(self) -> None: ...
+
+class MatterLevelControlNumber(MatterEntity, NumberEntity):
+    entity_description: MatterNumberEntityDescription
+    async def async_set_native_value(self, value: float) -> None: ...
+    _attr_native_value: Incomplete
+    @callback
+    def _update_from_device(self) -> None: ...
+
 DISCOVERY_SCHEMAS: Incomplete

homeassistant-stubs/components/matter/select.pyi

@@ -13,19 +13,23 @@ 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
-type SelectCluster = clusters.ModeSelect | clusters.OvenMode | clusters.LaundryWasherMode | clusters.RefrigeratorAndTemperatureControlledCabinetMode | clusters.RvcRunMode | clusters.RvcCleanMode | clusters.DishwasherMode | clusters.EnergyEvseMode | clusters.DeviceEnergyManagementMode
+PUMP_OPERATION_MODE_MAP: Incomplete
+PUMP_OPERATION_MODE_MAP_REVERSE: Incomplete
+type SelectCluster = clusters.ModeSelect | clusters.OvenMode | clusters.LaundryWasherMode | clusters.RefrigeratorAndTemperatureControlledCabinetMode | clusters.RvcRunMode | clusters.RvcCleanMode | clusters.DishwasherMode | clusters.EnergyEvseMode | clusters.DeviceEnergyManagementMode | clusters.WaterHeaterMode
 
 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)
 class MatterMapSelectEntityDescription(MatterSelectEntityDescription):
-    measurement_to_ha: Callable[[int], str | None]
-    ha_to_native_value: Callable[[str], int | None]
+    device_to_ha: Callable[[int], str | None]
+    ha_to_device: Callable[[str], int | None]
     list_attribute: type[ClusterAttributeDescriptor]
 
 @dataclass(frozen=True, kw_only=True)
@@ -54,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

@@ -4,21 +4,37 @@ from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from _typeshed import Incomplete
 from chip.clusters.ClusterObjects import ClusterAttributeDescriptor as ClusterAttributeDescriptor
 from chip.clusters.Types import Nullable as Nullable
-from dataclasses import dataclass
+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, UnitOfElectricCurrent as UnitOfElectricCurrent, UnitOfElectricPotential as UnitOfElectricPotential, UnitOfEnergy as UnitOfEnergy, UnitOfPower as UnitOfPower, UnitOfPressure as UnitOfPressure, UnitOfTemperature as UnitOfTemperature, UnitOfVolumeFlowRate as UnitOfVolumeFlowRate
+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
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
 from homeassistant.util import slugify as slugify
 
 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)
@@ -28,6 +44,8 @@ class MatterListSensorEntityDescription(MatterSensorEntityDescription):
 @dataclass(frozen=True, kw_only=True)
 class MatterOperationalStateSensorEntityDescription(MatterSensorEntityDescription):
     state_list_attribute: type[ClusterAttributeDescriptor] = ...
+    state_attribute: type[ClusterAttributeDescriptor] = ...
+    state_map: dict[int, str] = field(default_factory=Incomplete)
 
 class MatterSensor(MatterEntity, SensorEntity):
     entity_description: MatterSensorEntityDescription

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

@@ -2,6 +2,8 @@ from .entity import MatterEntity as MatterEntity, MatterEntityDescription as Mat
 from .helpers import get_matter as get_matter
 from .models import MatterDiscoverySchema as MatterDiscoverySchema
 from _typeshed import Incomplete
+from chip.clusters.Objects import ClusterCommand as ClusterCommand
+from collections.abc import Callable as Callable
 from dataclasses import dataclass
 from homeassistant.components.switch import SwitchDeviceClass as SwitchDeviceClass, SwitchEntity as SwitchEntity, SwitchEntityDescription as SwitchEntityDescription
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
@@ -10,8 +12,13 @@ from homeassistant.core import HomeAssistant as HomeAssistant, callback as callb
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
 from typing import Any
 
+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: ...
@@ -20,7 +27,23 @@ class MatterSwitch(MatterEntity, SwitchEntity):
     @callback
     def _update_from_device(self) -> None: ...
 
-@dataclass(frozen=True)
+class MatterGenericCommandSwitch(MatterSwitch):
+    entity_description: MatterGenericCommandSwitchEntityDescription
+    _platform_translation_key: str
+    async def async_turn_on(self, **kwargs: Any) -> None: ...
+    async def async_turn_off(self, **kwargs: Any) -> None: ...
+    _attr_is_on: Incomplete
+    @callback
+    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, kw_only=True)
+class MatterGenericCommandSwitchEntityDescription(SwitchEntityDescription, MatterEntityDescription):
+    on_command: Callable[[], Any] | None = ...
+    off_command: Callable[[], Any] | None = ...
+    command_timeout: int | None = ...
+
+@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