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

homeassistant-stubs/components/knx/cover.pyi

@@ -1,28 +1,27 @@
-from . import KNXModule as KNXModule
-from .const import KNX_MODULE_KEY as KNX_MODULE_KEY
-from .entity import KnxYamlEntity as KnxYamlEntity
+from .const import CONF_SYNC_STATE as CONF_SYNC_STATE, CoverConf as CoverConf, DOMAIN as DOMAIN, KNX_MODULE_KEY as KNX_MODULE_KEY
+from .entity import KnxUiEntity as KnxUiEntity, KnxUiEntityPlatformController as KnxUiEntityPlatformController, KnxYamlEntity as KnxYamlEntity
+from .knx_module import KNXModule as KNXModule
 from .schema import CoverSchema as CoverSchema
+from .storage.const import CONF_ENTITY as CONF_ENTITY, CONF_GA_ANGLE as CONF_GA_ANGLE, CONF_GA_POSITION_SET as CONF_GA_POSITION_SET, CONF_GA_POSITION_STATE as CONF_GA_POSITION_STATE, CONF_GA_STEP as CONF_GA_STEP, CONF_GA_STOP as CONF_GA_STOP, CONF_GA_UP_DOWN as CONF_GA_UP_DOWN
+from .storage.util import ConfigExtractor as ConfigExtractor
 from _typeshed import Incomplete
-from collections.abc import Callable as Callable
 from homeassistant import config_entries as config_entries
 from homeassistant.components.cover import ATTR_POSITION as ATTR_POSITION, ATTR_TILT_POSITION as ATTR_TILT_POSITION, CoverDeviceClass as CoverDeviceClass, CoverEntity as CoverEntity, CoverEntityFeature as CoverEntityFeature
 from homeassistant.const import CONF_DEVICE_CLASS as CONF_DEVICE_CLASS, CONF_ENTITY_CATEGORY as CONF_ENTITY_CATEGORY, CONF_NAME as CONF_NAME, Platform as Platform
 from homeassistant.core import HomeAssistant as HomeAssistant
-from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback, async_get_current_platform as async_get_current_platform
 from homeassistant.helpers.typing import ConfigType as ConfigType
 from typing import Any
+from xknx import XKNX as XKNX
 from xknx.devices import Cover as XknxCover
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: config_entries.ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
-class KNXCover(KnxYamlEntity, CoverEntity):
+class _KnxCover(CoverEntity):
     _device: XknxCover
-    _unsubscribe_auto_updater: Callable[[], None] | None
-    _attr_entity_category: Incomplete
     _attr_supported_features: Incomplete
     _attr_device_class: Incomplete
-    _attr_unique_id: Incomplete
-    def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
+    def init_base(self) -> None: ...
     @property
     def current_cover_position(self) -> int | None: ...
     @property
@@ -41,3 +40,16 @@ class KNXCover(KnxYamlEntity, CoverEntity):
     async def async_open_cover_tilt(self, **kwargs: Any) -> None: ...
     async def async_close_cover_tilt(self, **kwargs: Any) -> None: ...
     async def async_stop_cover_tilt(self, **kwargs: Any) -> None: ...
+
+class KnxYamlCover(_KnxCover, KnxYamlEntity):
+    _device: XknxCover
+    _attr_entity_category: Incomplete
+    _attr_unique_id: Incomplete
+    _attr_device_class: Incomplete
+    def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
+
+def _create_ui_cover(xknx: XKNX, knx_config: ConfigType, name: str) -> XknxCover: ...
+
+class KnxUiCover(_KnxCover, KnxUiEntity):
+    _device: XknxCover
+    def __init__(self, knx_module: KNXModule, unique_id: str, config: dict[str, Any]) -> None: ...

homeassistant-stubs/components/knx/date.pyi

@@ -1,27 +1,35 @@
-from . import KNXModule as KNXModule
-from .const import CONF_RESPOND_TO_READ as CONF_RESPOND_TO_READ, CONF_STATE_ADDRESS as CONF_STATE_ADDRESS, CONF_SYNC_STATE as CONF_SYNC_STATE, KNX_ADDRESS as KNX_ADDRESS, KNX_MODULE_KEY as KNX_MODULE_KEY
-from .entity import KnxYamlEntity as KnxYamlEntity
+from .const import CONF_RESPOND_TO_READ as CONF_RESPOND_TO_READ, CONF_STATE_ADDRESS as CONF_STATE_ADDRESS, CONF_SYNC_STATE as CONF_SYNC_STATE, DOMAIN as DOMAIN, KNX_ADDRESS as KNX_ADDRESS, KNX_MODULE_KEY as KNX_MODULE_KEY
+from .entity import KnxUiEntity as KnxUiEntity, KnxUiEntityPlatformController as KnxUiEntityPlatformController, KnxYamlEntity as KnxYamlEntity
+from .knx_module import KNXModule as KNXModule
+from .storage.const import CONF_ENTITY as CONF_ENTITY, CONF_GA_DATE as CONF_GA_DATE
+from .storage.util import ConfigExtractor as ConfigExtractor
 from _typeshed import Incomplete
 from datetime import date as dt_date
 from homeassistant import config_entries as config_entries
 from homeassistant.components.date import DateEntity as DateEntity
 from homeassistant.const import CONF_ENTITY_CATEGORY as CONF_ENTITY_CATEGORY, CONF_NAME as CONF_NAME, Platform as Platform, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN
 from homeassistant.core import HomeAssistant as HomeAssistant
-from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback, async_get_current_platform as async_get_current_platform
 from homeassistant.helpers.restore_state import RestoreEntity as RestoreEntity
 from homeassistant.helpers.typing import ConfigType as ConfigType
-from xknx import XKNX as XKNX
+from typing import Any
 from xknx.devices import DateDevice as XknxDateDevice
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: config_entries.ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
-def _create_xknx_device(xknx: XKNX, config: ConfigType) -> XknxDateDevice: ...
 
-class KNXDateEntity(KnxYamlEntity, DateEntity, RestoreEntity):
+class _KNXDate(DateEntity, RestoreEntity):
     _device: XknxDateDevice
-    _attr_entity_category: Incomplete
-    _attr_unique_id: Incomplete
-    def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
     async def async_added_to_hass(self) -> None: ...
     @property
     def native_value(self) -> dt_date | None: ...
     async def async_set_value(self, value: dt_date) -> None: ...
+
+class KnxYamlDate(_KNXDate, KnxYamlEntity):
+    _device: XknxDateDevice
+    _attr_entity_category: Incomplete
+    _attr_unique_id: Incomplete
+    def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
+
+class KnxUiDate(_KNXDate, KnxUiEntity):
+    _device: XknxDateDevice
+    def __init__(self, knx_module: KNXModule, unique_id: str, config: dict[str, Any]) -> None: ...

homeassistant-stubs/components/knx/datetime.pyi

@@ -1,27 +1,35 @@
-from . import KNXModule as KNXModule
-from .const import CONF_RESPOND_TO_READ as CONF_RESPOND_TO_READ, CONF_STATE_ADDRESS as CONF_STATE_ADDRESS, CONF_SYNC_STATE as CONF_SYNC_STATE, KNX_ADDRESS as KNX_ADDRESS, KNX_MODULE_KEY as KNX_MODULE_KEY
-from .entity import KnxYamlEntity as KnxYamlEntity
+from .const import CONF_RESPOND_TO_READ as CONF_RESPOND_TO_READ, CONF_STATE_ADDRESS as CONF_STATE_ADDRESS, CONF_SYNC_STATE as CONF_SYNC_STATE, DOMAIN as DOMAIN, KNX_ADDRESS as KNX_ADDRESS, KNX_MODULE_KEY as KNX_MODULE_KEY
+from .entity import KnxUiEntity as KnxUiEntity, KnxUiEntityPlatformController as KnxUiEntityPlatformController, KnxYamlEntity as KnxYamlEntity
+from .knx_module import KNXModule as KNXModule
+from .storage.const import CONF_ENTITY as CONF_ENTITY, CONF_GA_DATETIME as CONF_GA_DATETIME
+from .storage.util import ConfigExtractor as ConfigExtractor
 from _typeshed import Incomplete
 from datetime import datetime
 from homeassistant import config_entries as config_entries
 from homeassistant.components.datetime import DateTimeEntity as DateTimeEntity
 from homeassistant.const import CONF_ENTITY_CATEGORY as CONF_ENTITY_CATEGORY, CONF_NAME as CONF_NAME, Platform as Platform, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN
 from homeassistant.core import HomeAssistant as HomeAssistant
-from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback, async_get_current_platform as async_get_current_platform
 from homeassistant.helpers.restore_state import RestoreEntity as RestoreEntity
 from homeassistant.helpers.typing import ConfigType as ConfigType
-from xknx import XKNX as XKNX
+from typing import Any
 from xknx.devices import DateTimeDevice as XknxDateTimeDevice
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: config_entries.ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
-def _create_xknx_device(xknx: XKNX, config: ConfigType) -> XknxDateTimeDevice: ...
 
-class KNXDateTimeEntity(KnxYamlEntity, DateTimeEntity, RestoreEntity):
+class _KNXDateTime(DateTimeEntity, RestoreEntity):
     _device: XknxDateTimeDevice
-    _attr_entity_category: Incomplete
-    _attr_unique_id: Incomplete
-    def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
     async def async_added_to_hass(self) -> None: ...
     @property
     def native_value(self) -> datetime | None: ...
     async def async_set_value(self, value: datetime) -> None: ...
+
+class KnxYamlDateTime(_KNXDateTime, KnxYamlEntity):
+    _device: XknxDateTimeDevice
+    _attr_entity_category: Incomplete
+    _attr_unique_id: Incomplete
+    def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
+
+class KnxUiDateTime(_KNXDateTime, KnxUiEntity):
+    _device: XknxDateTimeDevice
+    def __init__(self, knx_module: KNXModule, unique_id: str, config: dict[str, Any]) -> None: ...

homeassistant-stubs/components/knx/dpt.pyi

@@ -0,0 +1,26 @@
+from _typeshed import Incomplete
+from collections.abc import Mapping
+from functools import cache
+from homeassistant.components.sensor import SensorDeviceClass as SensorDeviceClass, SensorStateClass as SensorStateClass
+from typing import TypedDict
+from xknx.dpt import DPTBase
+
+HaDptClass: Incomplete
+
+class DPTInfo(TypedDict):
+    dpt_class: HaDptClass
+    main: int
+    sub: int | None
+    name: str | None
+    unit: str | None
+    sensor_device_class: SensorDeviceClass | None
+    sensor_state_class: SensorStateClass | None
+
+@cache
+def get_supported_dpts() -> Mapping[str, DPTInfo]: ...
+def _ha_dpt_class(dpt_cls: type[DPTBase]) -> HaDptClass: ...
+
+_sensor_device_classes: Mapping[str, SensorDeviceClass]
+_sensor_state_class_overrides: Mapping[str, SensorStateClass | None]
+
+def _get_sensor_state_class(ha_dpt_class: HaDptClass, dpt_number_str: str) -> SensorStateClass | None: ...

homeassistant-stubs/components/knx/entity.pyi

@@ -1,5 +1,5 @@
-from . import KNXModule as KNXModule
 from .const import DOMAIN as DOMAIN
+from .knx_module import KNXModule as KNXModule
 from .storage.config_store import PlatformControllerBase as PlatformControllerBase
 from .storage.const import CONF_DEVICE_INFO as CONF_DEVICE_INFO
 from _typeshed import Incomplete

homeassistant-stubs/components/knx/fan.pyi

@@ -1,38 +1,51 @@
-from . import KNXModule as KNXModule
-from .const import KNX_ADDRESS as KNX_ADDRESS, KNX_MODULE_KEY as KNX_MODULE_KEY
-from .entity import KnxYamlEntity as KnxYamlEntity
+from .const import CONF_SYNC_STATE as CONF_SYNC_STATE, DOMAIN as DOMAIN, FanConf as FanConf, KNX_ADDRESS as KNX_ADDRESS, KNX_MODULE_KEY as KNX_MODULE_KEY
+from .entity import KnxUiEntity as KnxUiEntity, KnxUiEntityPlatformController as KnxUiEntityPlatformController, KnxYamlEntity as KnxYamlEntity
+from .knx_module import KNXModule as KNXModule
 from .schema import FanSchema as FanSchema
+from .storage.const import CONF_ENTITY as CONF_ENTITY, CONF_GA_OSCILLATION as CONF_GA_OSCILLATION, CONF_GA_SPEED as CONF_GA_SPEED, CONF_GA_STEP as CONF_GA_STEP, CONF_GA_SWITCH as CONF_GA_SWITCH, CONF_SPEED as CONF_SPEED
+from .storage.util import ConfigExtractor as ConfigExtractor
 from _typeshed import Incomplete
 from homeassistant import config_entries as config_entries
 from homeassistant.components.fan import FanEntity as FanEntity, FanEntityFeature as FanEntityFeature
 from homeassistant.const import CONF_ENTITY_CATEGORY as CONF_ENTITY_CATEGORY, CONF_NAME as CONF_NAME, Platform as Platform
 from homeassistant.core import HomeAssistant as HomeAssistant
-from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback, async_get_current_platform as async_get_current_platform
 from homeassistant.helpers.typing import ConfigType as ConfigType
 from homeassistant.util.percentage import percentage_to_ranged_value as percentage_to_ranged_value, ranged_value_to_percentage as ranged_value_to_percentage
 from homeassistant.util.scaling import int_states_in_range as int_states_in_range
-from typing import Any, Final
+from propcache.api import cached_property
+from typing import Any
 from xknx.devices import Fan as XknxFan
 
-DEFAULT_PERCENTAGE: Final[int]
-
 async def async_setup_entry(hass: HomeAssistant, config_entry: config_entries.ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
-class KNXFan(KnxYamlEntity, FanEntity):
+class _KnxFan(FanEntity):
     _device: XknxFan
     _step_range: tuple[int, int] | None
-    _attr_entity_category: Incomplete
-    _attr_unique_id: Incomplete
-    def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
+    def _get_knx_speed(self, percentage: int) -> int: ...
     async def async_set_percentage(self, percentage: int) -> None: ...
-    @property
+    @cached_property
     def supported_features(self) -> FanEntityFeature: ...
     @property
     def percentage(self) -> int | None: ...
-    @property
+    @cached_property
     def speed_count(self) -> int: ...
+    @property
+    def is_on(self) -> bool: ...
     async def async_turn_on(self, percentage: int | None = None, preset_mode: str | None = None, **kwargs: Any) -> None: ...
     async def async_turn_off(self, **kwargs: Any) -> None: ...
     async def async_oscillate(self, oscillating: bool) -> None: ...
     @property
     def oscillating(self) -> bool | None: ...
+
+class KnxYamlFan(_KnxFan, KnxYamlEntity):
+    _device: XknxFan
+    _step_range: tuple[int, int] | None
+    _attr_entity_category: Incomplete
+    _attr_unique_id: Incomplete
+    def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
+
+class KnxUiFan(_KnxFan, KnxUiEntity):
+    _device: XknxFan
+    _step_range: tuple[int, int] | None
+    def __init__(self, knx_module: KNXModule, unique_id: str, config: dict[str, Any]) -> None: ...

homeassistant-stubs/components/knx/knx_module.pyi

@@ -0,0 +1,47 @@
+from .const import CONF_KNX_CONNECTION_TYPE as CONF_KNX_CONNECTION_TYPE, CONF_KNX_INDIVIDUAL_ADDRESS as CONF_KNX_INDIVIDUAL_ADDRESS, CONF_KNX_KNXKEY_FILENAME as CONF_KNX_KNXKEY_FILENAME, CONF_KNX_KNXKEY_PASSWORD as CONF_KNX_KNXKEY_PASSWORD, CONF_KNX_LOCAL_IP as CONF_KNX_LOCAL_IP, CONF_KNX_MCAST_GRP as CONF_KNX_MCAST_GRP, CONF_KNX_MCAST_PORT as CONF_KNX_MCAST_PORT, CONF_KNX_RATE_LIMIT as CONF_KNX_RATE_LIMIT, CONF_KNX_ROUTE_BACK as CONF_KNX_ROUTE_BACK, CONF_KNX_ROUTING as CONF_KNX_ROUTING, CONF_KNX_ROUTING_BACKBONE_KEY as CONF_KNX_ROUTING_BACKBONE_KEY, CONF_KNX_ROUTING_SECURE as CONF_KNX_ROUTING_SECURE, CONF_KNX_ROUTING_SYNC_LATENCY_TOLERANCE as CONF_KNX_ROUTING_SYNC_LATENCY_TOLERANCE, CONF_KNX_SECURE_DEVICE_AUTHENTICATION as CONF_KNX_SECURE_DEVICE_AUTHENTICATION, CONF_KNX_SECURE_USER_ID as CONF_KNX_SECURE_USER_ID, CONF_KNX_SECURE_USER_PASSWORD as CONF_KNX_SECURE_USER_PASSWORD, CONF_KNX_STATE_UPDATER as CONF_KNX_STATE_UPDATER, CONF_KNX_TELEGRAM_LOG_SIZE as CONF_KNX_TELEGRAM_LOG_SIZE, CONF_KNX_TUNNELING as CONF_KNX_TUNNELING, CONF_KNX_TUNNELING_TCP as CONF_KNX_TUNNELING_TCP, CONF_KNX_TUNNELING_TCP_SECURE as CONF_KNX_TUNNELING_TCP_SECURE, CONF_KNX_TUNNEL_ENDPOINT_IA as CONF_KNX_TUNNEL_ENDPOINT_IA, KNX_ADDRESS as KNX_ADDRESS, TELEGRAM_LOG_DEFAULT as TELEGRAM_LOG_DEFAULT
+from .device import KNXInterfaceDevice as KNXInterfaceDevice
+from .expose import KNXExposeSensor as KNXExposeSensor, KNXExposeTime as KNXExposeTime
+from .project import KNXProject as KNXProject
+from .repairs import data_secure_group_key_issue_dispatcher as data_secure_group_key_issue_dispatcher
+from .storage.config_store import KNXConfigStore as KNXConfigStore
+from .telegrams import Telegrams as Telegrams
+from _typeshed import Incomplete
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.const import CONF_EVENT as CONF_EVENT, CONF_HOST as CONF_HOST, CONF_PORT as CONF_PORT, CONF_TYPE as CONF_TYPE, EVENT_HOMEASSISTANT_STOP as EVENT_HOMEASSISTANT_STOP
+from homeassistant.core import Event as Event, HomeAssistant as HomeAssistant
+from homeassistant.helpers.storage import STORAGE_DIR as STORAGE_DIR
+from homeassistant.helpers.typing import ConfigType as ConfigType
+from xknx.core import XknxConnectionState
+from xknx.core.telegram_queue import TelegramQueue as TelegramQueue
+from xknx.dpt import DPTBase
+from xknx.io import ConnectionConfig
+from xknx.telegram import AddressFilter, Telegram as Telegram
+from xknx.telegram.address import DeviceGroupAddress as DeviceGroupAddress
+
+_LOGGER: Incomplete
+
+class KNXModule:
+    hass: Incomplete
+    config_yaml: Incomplete
+    connected: bool
+    exposures: list[KNXExposeSensor | KNXExposeTime]
+    service_exposures: dict[str, KNXExposeSensor | KNXExposeTime]
+    entry: Incomplete
+    project: Incomplete
+    config_store: Incomplete
+    xknx: Incomplete
+    telegrams: Incomplete
+    interface_device: Incomplete
+    _address_filter_transcoder: dict[AddressFilter, type[DPTBase]]
+    group_address_transcoder: dict[DeviceGroupAddress, type[DPTBase]]
+    group_address_entities: dict[DeviceGroupAddress, set[tuple[str, str]]]
+    knx_event_callback: TelegramQueue.Callback
+    def __init__(self, hass: HomeAssistant, config: ConfigType, entry: ConfigEntry) -> None: ...
+    async def start(self) -> None: ...
+    async def stop(self, event: Event | None = None) -> None: ...
+    def connection_config(self) -> ConnectionConfig: ...
+    def add_to_group_address_entities(self, group_addresses: set[DeviceGroupAddress], identifier: tuple[str, str]) -> None: ...
+    def remove_from_group_address_entities(self, group_addresses: set[DeviceGroupAddress], identifier: tuple[str, str]) -> None: ...
+    def connection_state_changed_cb(self, state: XknxConnectionState) -> None: ...
+    def telegram_received_cb(self, telegram: Telegram) -> None: ...
+    def register_event_callback(self) -> TelegramQueue.Callback: ...

homeassistant-stubs/components/knx/light.pyi

@@ -1,9 +1,10 @@
-from . import KNXModule as KNXModule
 from .const import CONF_SYNC_STATE as CONF_SYNC_STATE, ColorTempModes as ColorTempModes, DOMAIN as DOMAIN, KNX_ADDRESS as KNX_ADDRESS, KNX_MODULE_KEY as KNX_MODULE_KEY
 from .entity import KnxUiEntity as KnxUiEntity, KnxUiEntityPlatformController as KnxUiEntityPlatformController, KnxYamlEntity as KnxYamlEntity
+from .knx_module import KNXModule as KNXModule
 from .schema import LightSchema as LightSchema
-from .storage.const import CONF_COLOR_TEMP_MAX as CONF_COLOR_TEMP_MAX, CONF_COLOR_TEMP_MIN as CONF_COLOR_TEMP_MIN, CONF_DPT as CONF_DPT, CONF_ENTITY as CONF_ENTITY, CONF_GA_BLUE_BRIGHTNESS as CONF_GA_BLUE_BRIGHTNESS, CONF_GA_BLUE_SWITCH as CONF_GA_BLUE_SWITCH, CONF_GA_BRIGHTNESS as CONF_GA_BRIGHTNESS, CONF_GA_COLOR as CONF_GA_COLOR, CONF_GA_COLOR_TEMP as CONF_GA_COLOR_TEMP, CONF_GA_GREEN_BRIGHTNESS as CONF_GA_GREEN_BRIGHTNESS, CONF_GA_GREEN_SWITCH as CONF_GA_GREEN_SWITCH, CONF_GA_HUE as CONF_GA_HUE, CONF_GA_PASSIVE as CONF_GA_PASSIVE, CONF_GA_RED_BRIGHTNESS as CONF_GA_RED_BRIGHTNESS, CONF_GA_RED_SWITCH as CONF_GA_RED_SWITCH, CONF_GA_SATURATION as CONF_GA_SATURATION, CONF_GA_STATE as CONF_GA_STATE, CONF_GA_SWITCH as CONF_GA_SWITCH, CONF_GA_WHITE_BRIGHTNESS as CONF_GA_WHITE_BRIGHTNESS, CONF_GA_WHITE_SWITCH as CONF_GA_WHITE_SWITCH, CONF_GA_WRITE as CONF_GA_WRITE
+from .storage.const import CONF_COLOR as CONF_COLOR, CONF_COLOR_TEMP_MAX as CONF_COLOR_TEMP_MAX, CONF_COLOR_TEMP_MIN as CONF_COLOR_TEMP_MIN, CONF_ENTITY as CONF_ENTITY, CONF_GA_BLUE_BRIGHTNESS as CONF_GA_BLUE_BRIGHTNESS, CONF_GA_BLUE_SWITCH as CONF_GA_BLUE_SWITCH, CONF_GA_BRIGHTNESS as CONF_GA_BRIGHTNESS, CONF_GA_COLOR as CONF_GA_COLOR, CONF_GA_COLOR_TEMP as CONF_GA_COLOR_TEMP, CONF_GA_GREEN_BRIGHTNESS as CONF_GA_GREEN_BRIGHTNESS, CONF_GA_GREEN_SWITCH as CONF_GA_GREEN_SWITCH, CONF_GA_HUE as CONF_GA_HUE, CONF_GA_RED_BRIGHTNESS as CONF_GA_RED_BRIGHTNESS, CONF_GA_RED_SWITCH as CONF_GA_RED_SWITCH, CONF_GA_SATURATION as CONF_GA_SATURATION, CONF_GA_SWITCH as CONF_GA_SWITCH, CONF_GA_WHITE_BRIGHTNESS as CONF_GA_WHITE_BRIGHTNESS, CONF_GA_WHITE_SWITCH as CONF_GA_WHITE_SWITCH
 from .storage.entity_store_schema import LightColorMode as LightColorMode
+from .storage.util import ConfigExtractor as ConfigExtractor
 from _typeshed import Incomplete
 from homeassistant import config_entries as config_entries
 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_RGBW_COLOR as ATTR_RGBW_COLOR, ATTR_RGB_COLOR as ATTR_RGB_COLOR, ATTR_XY_COLOR as ATTR_XY_COLOR, ColorMode as ColorMode, LightEntity as LightEntity

homeassistant-stubs/components/knx/notify.pyi

@@ -1,6 +1,6 @@
-from . import KNXModule as KNXModule
 from .const import KNX_ADDRESS as KNX_ADDRESS, KNX_MODULE_KEY as KNX_MODULE_KEY
 from .entity import KnxYamlEntity as KnxYamlEntity
+from .knx_module import KNXModule as KNXModule
 from _typeshed import Incomplete
 from homeassistant import config_entries as config_entries
 from homeassistant.components.notify import NotifyEntity as NotifyEntity

homeassistant-stubs/components/knx/number.pyi

@@ -1,6 +1,6 @@
-from . import KNXModule as KNXModule
 from .const import CONF_RESPOND_TO_READ as CONF_RESPOND_TO_READ, CONF_STATE_ADDRESS as CONF_STATE_ADDRESS, KNX_ADDRESS as KNX_ADDRESS, KNX_MODULE_KEY as KNX_MODULE_KEY
 from .entity import KnxYamlEntity as KnxYamlEntity
+from .knx_module import KNXModule as KNXModule
 from .schema import NumberSchema as NumberSchema
 from _typeshed import Incomplete
 from homeassistant import config_entries as config_entries

homeassistant-stubs/components/knx/repairs.pyi

@@ -0,0 +1,26 @@
+from .const import CONF_KNX_KNXKEY_PASSWORD as CONF_KNX_KNXKEY_PASSWORD, DOMAIN as DOMAIN, KNXConfigEntryData as KNXConfigEntryData, REPAIR_ISSUE_DATA_SECURE_GROUP_KEY as REPAIR_ISSUE_DATA_SECURE_GROUP_KEY
+from .knx_module import KNXModule as KNXModule
+from .storage.keyring import DEFAULT_KNX_KEYRING_FILENAME as DEFAULT_KNX_KEYRING_FILENAME, save_uploaded_knxkeys_file as save_uploaded_knxkeys_file
+from .telegrams import SIGNAL_KNX_DATA_SECURE_ISSUE_TELEGRAM as SIGNAL_KNX_DATA_SECURE_ISSUE_TELEGRAM, TelegramDict as TelegramDict
+from collections.abc import Callable as Callable
+from homeassistant import data_entry_flow as data_entry_flow
+from homeassistant.components.repairs import RepairsFlow as RepairsFlow
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers import selector as selector
+from homeassistant.helpers.dispatcher import async_dispatcher_connect as async_dispatcher_connect
+from typing import Any, Final
+from xknx.telegram import Telegram as Telegram
+
+CONF_KEYRING_FILE: Final[str]
+
+async def async_create_fix_flow(hass: HomeAssistant, issue_id: str, data: dict[str, str | int | float | None] | None) -> RepairsFlow: ...
+@callback
+def data_secure_group_key_issue_dispatcher(knx_module: KNXModule) -> Callable[[], None]: ...
+@callback
+def _data_secure_group_key_issue_handler(knx_module: KNXModule, telegram: Telegram, telegram_dict: TelegramDict) -> None: ...
+
+class DataSecureGroupIssueRepairFlow(RepairsFlow):
+    async def async_step_init(self, user_input: dict[str, str] | None = None) -> data_entry_flow.FlowResult: ...
+    async def async_step_secure_knxkeys(self, user_input: dict[str, Any] | None = None) -> data_entry_flow.FlowResult: ...
+    @callback
+    def finish_flow(self, new_entry_data: KNXConfigEntryData) -> data_entry_flow.FlowResult: ...

homeassistant-stubs/components/knx/scene.pyi

@@ -1,22 +1,32 @@
-from . import KNXModule as KNXModule
-from .const import KNX_ADDRESS as KNX_ADDRESS, KNX_MODULE_KEY as KNX_MODULE_KEY
-from .entity import KnxYamlEntity as KnxYamlEntity
+from .const import DOMAIN as DOMAIN, KNX_ADDRESS as KNX_ADDRESS, KNX_MODULE_KEY as KNX_MODULE_KEY, SceneConf as SceneConf
+from .entity import KnxUiEntity as KnxUiEntity, KnxUiEntityPlatformController as KnxUiEntityPlatformController, KnxYamlEntity as KnxYamlEntity, _KnxEntityBase as _KnxEntityBase
+from .knx_module import KNXModule as KNXModule
 from .schema import SceneSchema as SceneSchema
+from .storage.const import CONF_ENTITY as CONF_ENTITY, CONF_GA_SCENE as CONF_GA_SCENE
+from .storage.util import ConfigExtractor as ConfigExtractor
 from _typeshed import Incomplete
 from homeassistant import config_entries as config_entries
-from homeassistant.components.scene import Scene as Scene
+from homeassistant.components.scene import BaseScene as BaseScene
 from homeassistant.const import CONF_ENTITY_CATEGORY as CONF_ENTITY_CATEGORY, CONF_NAME as CONF_NAME, Platform as Platform
 from homeassistant.core import HomeAssistant as HomeAssistant
-from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback, async_get_current_platform as async_get_current_platform
 from homeassistant.helpers.typing import ConfigType as ConfigType
 from typing import Any
-from xknx.devices import Scene as XknxScene
+from xknx.devices import Device as XknxDevice, Scene as XknxScene
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: config_entries.ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
-class KNXScene(KnxYamlEntity, Scene):
+class _KnxScene(BaseScene, _KnxEntityBase):
+    _device: XknxScene
+    async def _async_activate(self, **kwargs: Any) -> None: ...
+    def after_update_callback(self, device: XknxDevice) -> None: ...
+
+class KnxYamlScene(_KnxScene, KnxYamlEntity):
     _device: XknxScene
     _attr_entity_category: Incomplete
     _attr_unique_id: Incomplete
     def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
-    async def async_activate(self, **kwargs: Any) -> None: ...
+
+class KnxUiScene(_KnxScene, KnxUiEntity):
+    _device: XknxScene
+    def __init__(self, knx_module: KNXModule, unique_id: str, config: ConfigType) -> None: ...

homeassistant-stubs/components/knx/schema.pyi

@@ -1,5 +1,5 @@
 import voluptuous as vol
-from .const import CONF_CONTEXT_TIMEOUT as CONF_CONTEXT_TIMEOUT, CONF_IGNORE_INTERNAL_STATE as CONF_IGNORE_INTERNAL_STATE, CONF_INVERT as CONF_INVERT, CONF_KNX_EXPOSE as CONF_KNX_EXPOSE, CONF_PAYLOAD_LENGTH as CONF_PAYLOAD_LENGTH, CONF_RESET_AFTER as CONF_RESET_AFTER, CONF_RESPOND_TO_READ as CONF_RESPOND_TO_READ, CONF_STATE_ADDRESS as CONF_STATE_ADDRESS, CONF_SYNC_STATE as CONF_SYNC_STATE, ColorTempModes as ColorTempModes, FanZeroMode as FanZeroMode, KNX_ADDRESS as KNX_ADDRESS
+from .const import CONF_CONTEXT_TIMEOUT as CONF_CONTEXT_TIMEOUT, CONF_IGNORE_INTERNAL_STATE as CONF_IGNORE_INTERNAL_STATE, CONF_INVERT as CONF_INVERT, CONF_KNX_EXPOSE as CONF_KNX_EXPOSE, CONF_PAYLOAD_LENGTH as CONF_PAYLOAD_LENGTH, CONF_RESET_AFTER as CONF_RESET_AFTER, CONF_RESPOND_TO_READ as CONF_RESPOND_TO_READ, CONF_STATE_ADDRESS as CONF_STATE_ADDRESS, CONF_SYNC_STATE as CONF_SYNC_STATE, ClimateConf as ClimateConf, ColorTempModes as ColorTempModes, CoverConf as CoverConf, FanConf as FanConf, FanZeroMode as FanZeroMode, KNX_ADDRESS as KNX_ADDRESS, SceneConf as SceneConf
 from .validation import backwards_compatible_xknx_climate_enum_member as backwards_compatible_xknx_climate_enum_member, dpt_base_type_validator as dpt_base_type_validator, ga_list_validator as ga_list_validator, ga_validator as ga_validator, numeric_type_validator as numeric_type_validator, sensor_type_validator as sensor_type_validator, string_type_validator as string_type_validator, sync_state_validator as sync_state_validator
 from _typeshed import Incomplete
 from abc import ABC
@@ -46,10 +46,7 @@ class ClimateSchema(KNXPlatformSchema):
     CONF_SETPOINT_SHIFT_ADDRESS: str
     CONF_SETPOINT_SHIFT_STATE_ADDRESS: str
     CONF_SETPOINT_SHIFT_MODE: str
-    CONF_SETPOINT_SHIFT_MAX: str
-    CONF_SETPOINT_SHIFT_MIN: str
     CONF_TEMPERATURE_ADDRESS: str
-    CONF_TEMPERATURE_STEP: str
     CONF_TARGET_TEMPERATURE_ADDRESS: str
     CONF_TARGET_TEMPERATURE_STATE_ADDRESS: str
     CONF_OPERATION_MODE_ADDRESS: str
@@ -65,19 +62,10 @@ class ClimateSchema(KNXPlatformSchema):
     CONF_OPERATION_MODE_NIGHT_ADDRESS: str
     CONF_OPERATION_MODE_COMFORT_ADDRESS: str
     CONF_OPERATION_MODE_STANDBY_ADDRESS: str
-    CONF_OPERATION_MODES: str
-    CONF_CONTROLLER_MODES: str
-    CONF_DEFAULT_CONTROLLER_MODE: str
     CONF_ON_OFF_ADDRESS: str
     CONF_ON_OFF_STATE_ADDRESS: str
-    CONF_ON_OFF_INVERT: str
-    CONF_MIN_TEMP: str
-    CONF_MAX_TEMP: str
     CONF_FAN_SPEED_ADDRESS: str
     CONF_FAN_SPEED_STATE_ADDRESS: str
-    CONF_FAN_MAX_STEP: str
-    CONF_FAN_SPEED_MODE: str
-    CONF_FAN_ZERO_MODE: str
     CONF_HUMIDITY_STATE_ADDRESS: str
     CONF_SWING_ADDRESS: str
     CONF_SWING_STATE_ADDRESS: str
@@ -101,11 +89,6 @@ class CoverSchema(KNXPlatformSchema):
     CONF_POSITION_STATE_ADDRESS: str
     CONF_ANGLE_ADDRESS: str
     CONF_ANGLE_STATE_ADDRESS: str
-    CONF_TRAVELLING_TIME_DOWN: str
-    CONF_TRAVELLING_TIME_UP: str
-    CONF_INVERT_UPDOWN: str
-    CONF_INVERT_POSITION: str
-    CONF_INVERT_ANGLE: str
     DEFAULT_TRAVEL_TIME: int
     DEFAULT_NAME: str
     ENTITY_SCHEMA: Incomplete
@@ -140,7 +123,8 @@ class FanSchema(KNXPlatformSchema):
     CONF_STATE_ADDRESS = CONF_STATE_ADDRESS
     CONF_OSCILLATION_ADDRESS: str
     CONF_OSCILLATION_STATE_ADDRESS: str
-    CONF_MAX_STEP: str
+    CONF_SWITCH_ADDRESS: str
+    CONF_SWITCH_STATE_ADDRESS: str
     DEFAULT_NAME: str
     ENTITY_SCHEMA: Incomplete
 

homeassistant-stubs/components/knx/select.pyi

@@ -1,6 +1,6 @@
-from . import KNXModule as KNXModule
 from .const import CONF_PAYLOAD_LENGTH as CONF_PAYLOAD_LENGTH, CONF_RESPOND_TO_READ as CONF_RESPOND_TO_READ, CONF_STATE_ADDRESS as CONF_STATE_ADDRESS, CONF_SYNC_STATE as CONF_SYNC_STATE, KNX_ADDRESS as KNX_ADDRESS, KNX_MODULE_KEY as KNX_MODULE_KEY
 from .entity import KnxYamlEntity as KnxYamlEntity
+from .knx_module import KNXModule as KNXModule
 from .schema import SelectSchema as SelectSchema
 from _typeshed import Incomplete
 from homeassistant import config_entries as config_entries

homeassistant-stubs/components/knx/sensor.pyi

@@ -1,22 +1,24 @@
-from . import KNXModule as KNXModule
-from .const import ATTR_SOURCE as ATTR_SOURCE, KNX_MODULE_KEY as KNX_MODULE_KEY
-from .entity import KnxYamlEntity as KnxYamlEntity
+from .const import ATTR_SOURCE as ATTR_SOURCE, CONF_SYNC_STATE as CONF_SYNC_STATE, DOMAIN as DOMAIN, KNX_MODULE_KEY as KNX_MODULE_KEY
+from .dpt import get_supported_dpts as get_supported_dpts
+from .entity import KnxUiEntity as KnxUiEntity, KnxUiEntityPlatformController as KnxUiEntityPlatformController, KnxYamlEntity as KnxYamlEntity, _KnxEntityBase as _KnxEntityBase
+from .knx_module import KNXModule as KNXModule
 from .schema import SensorSchema as SensorSchema
+from .storage.const import CONF_ALWAYS_CALLBACK as CONF_ALWAYS_CALLBACK, CONF_ENTITY as CONF_ENTITY, CONF_GA_SENSOR as CONF_GA_SENSOR
+from .storage.util import ConfigExtractor as ConfigExtractor
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from dataclasses import dataclass
 from datetime import datetime
 from homeassistant import config_entries as config_entries
-from homeassistant.components.sensor import CONF_STATE_CLASS as CONF_STATE_CLASS, SensorDeviceClass as SensorDeviceClass, SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription, SensorStateClass as SensorStateClass
-from homeassistant.const import CONF_DEVICE_CLASS as CONF_DEVICE_CLASS, CONF_ENTITY_CATEGORY as CONF_ENTITY_CATEGORY, CONF_NAME as CONF_NAME, CONF_TYPE as CONF_TYPE, EntityCategory as EntityCategory, Platform as Platform
+from homeassistant.components.sensor import CONF_STATE_CLASS as CONF_STATE_CLASS, RestoreSensor as RestoreSensor, SensorDeviceClass as SensorDeviceClass, SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription, SensorStateClass as SensorStateClass
+from homeassistant.const import CONF_DEVICE_CLASS as CONF_DEVICE_CLASS, CONF_ENTITY_CATEGORY as CONF_ENTITY_CATEGORY, CONF_NAME as CONF_NAME, CONF_TYPE as CONF_TYPE, CONF_UNIT_OF_MEASUREMENT as CONF_UNIT_OF_MEASUREMENT, EntityCategory as EntityCategory, Platform as Platform, STATE_UNAVAILABLE as STATE_UNAVAILABLE, STATE_UNKNOWN as STATE_UNKNOWN
 from homeassistant.core import HomeAssistant as HomeAssistant
-from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback, async_get_current_platform as async_get_current_platform
 from homeassistant.helpers.typing import ConfigType as ConfigType, StateType as StateType
 from homeassistant.util.enum import try_parse_enum as try_parse_enum
 from typing import Any
-from xknx import XKNX as XKNX
 from xknx.core.connection_state import XknxConnectionState
-from xknx.devices import Sensor as XknxSensor
+from xknx.devices import Device as XknxDevice, Sensor as XknxSensor
 
 SCAN_INTERVAL: Incomplete
 
@@ -31,9 +33,14 @@ class KNXSystemEntityDescription(SensorEntityDescription):
 SYSTEM_ENTITY_DESCRIPTIONS: Incomplete
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: config_entries.ConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
-def _create_sensor(xknx: XKNX, config: ConfigType) -> XknxSensor: ...
 
-class KNXSensor(KnxYamlEntity, SensorEntity):
+class _KnxSensor(RestoreSensor, _KnxEntityBase):
+    _device: XknxSensor
+    _attr_native_value: Incomplete
+    async def async_added_to_hass(self) -> None: ...
+    def after_update_callback(self, device: XknxDevice) -> None: ...
+
+class KnxYamlSensor(_KnxSensor, KnxYamlEntity):
     _device: XknxSensor
     _attr_device_class: Incomplete
     _attr_force_update: Incomplete
@@ -41,11 +48,17 @@ class KNXSensor(KnxYamlEntity, SensorEntity):
     _attr_unique_id: Incomplete
     _attr_native_unit_of_measurement: Incomplete
     _attr_state_class: Incomplete
+    _attr_extra_state_attributes: Incomplete
     def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
-    @property
-    def native_value(self) -> StateType: ...
-    @property
-    def extra_state_attributes(self) -> dict[str, Any] | None: ...
+
+class KnxUiSensor(_KnxSensor, KnxUiEntity):
+    _device: XknxSensor
+    _attr_device_class: Incomplete
+    _attr_state_class: Incomplete
+    _attr_native_unit_of_measurement: Incomplete
+    _attr_force_update: Incomplete
+    _attr_extra_state_attributes: Incomplete
+    def __init__(self, knx_module: KNXModule, unique_id: str, config: dict[str, Any]) -> None: ...
 
 class KNXSystemSensor(SensorEntity):
     _attr_has_entity_name: bool

homeassistant-stubs/components/knx/services.pyi

@@ -1,6 +1,6 @@
-from . import KNXModule as KNXModule
 from .const import DOMAIN as DOMAIN, KNX_ADDRESS as KNX_ADDRESS, KNX_MODULE_KEY as KNX_MODULE_KEY, SERVICE_KNX_ATTR_PAYLOAD as SERVICE_KNX_ATTR_PAYLOAD, SERVICE_KNX_ATTR_REMOVE as SERVICE_KNX_ATTR_REMOVE, SERVICE_KNX_ATTR_RESPONSE as SERVICE_KNX_ATTR_RESPONSE, SERVICE_KNX_ATTR_TYPE as SERVICE_KNX_ATTR_TYPE, SERVICE_KNX_EVENT_REGISTER as SERVICE_KNX_EVENT_REGISTER, SERVICE_KNX_EXPOSURE_REGISTER as SERVICE_KNX_EXPOSURE_REGISTER, SERVICE_KNX_READ as SERVICE_KNX_READ, SERVICE_KNX_SEND as SERVICE_KNX_SEND
 from .expose import create_knx_exposure as create_knx_exposure
+from .knx_module import KNXModule as KNXModule
 from .schema import ExposeSchema as ExposeSchema, dpt_base_type_validator as dpt_base_type_validator, ga_validator as ga_validator
 from _typeshed import Incomplete
 from homeassistant.const import CONF_TYPE as CONF_TYPE, SERVICE_RELOAD as SERVICE_RELOAD
@@ -9,9 +9,10 @@ from homeassistant.exceptions import HomeAssistantError as HomeAssistantError, S
 from homeassistant.helpers.service import async_register_admin_service as async_register_admin_service
 
 _LOGGER: Incomplete
+_DESCRIPTION_PLACEHOLDERS: Incomplete
 
 @callback
-def register_knx_services(hass: HomeAssistant) -> None: ...
+def async_setup_services(hass: HomeAssistant) -> None: ...
 @callback
 def get_knx_module(hass: HomeAssistant) -> KNXModule: ...
 

homeassistant-stubs/components/knx/storage/config_store.pyi

@@ -1,6 +1,7 @@
 import abc
 from ..const import DOMAIN as DOMAIN
 from .const import CONF_DATA as CONF_DATA
+from .migration import migrate_1_to_2 as migrate_1_to_2, migrate_2_1_to_2_2 as migrate_2_1_to_2_2
 from _typeshed import Incomplete
 from abc import ABC, abstractmethod
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
@@ -13,6 +14,7 @@ from typing import Any, Final, TypedDict
 
 _LOGGER: Incomplete
 STORAGE_VERSION: Final[int]
+STORAGE_VERSION_MINOR: Final[int]
 STORAGE_KEY: Final[Incomplete]
 type KNXPlatformStoreModel = dict[str, dict[str, Any]]
 type KNXEntityStoreModel = dict[str, KNXPlatformStoreModel]
@@ -26,6 +28,9 @@ class PlatformControllerBase(ABC, metaclass=abc.ABCMeta):
     @abstractmethod
     async def update_entity(self, entity_entry: er.RegistryEntry, config: dict[str, Any]) -> None: ...
 
+class _KNXConfigStoreStorage(Store[KNXConfigStoreModel]):
+    async def _async_migrate_func(self, old_major_version: int, old_minor_version: int, old_data: dict[str, Any]) -> dict[str, Any]: ...
+
 class KNXConfigStore:
     hass: Incomplete
     config_entry: Incomplete