homeassistant-stubs 2024.7.3__py3-none-any.whl → 2024.8.0__py3-none-any.whl

homeassistant-stubs/components/knx/const.pyi

@@ -81,11 +81,12 @@ class KNXConfigEntryData(TypedDict, total=False):
     telegram_log_size: int
 
 class ColorTempModes(Enum):
-    ABSOLUTE: str
-    ABSOLUTE_FLOAT: str
-    RELATIVE: str
+    ABSOLUTE = '7.600'
+    ABSOLUTE_FLOAT = '9'
+    RELATIVE = '5.001'
 
-SUPPORTED_PLATFORMS: Final[Incomplete]
+SUPPORTED_PLATFORMS_YAML: Final[Incomplete]
+SUPPORTED_PLATFORMS_UI: Final[Incomplete]
 CONTROLLER_MODES: Final[Incomplete]
 CURRENT_HVAC_ACTIONS: Final[Incomplete]
 PRESET_MODES: Final[Incomplete]

homeassistant-stubs/components/knx/cover.pyi

@@ -1,5 +1,6 @@
+from . import KNXModule as KNXModule
 from .const import DATA_KNX_CONFIG as DATA_KNX_CONFIG, DOMAIN as DOMAIN
-from .knx_entity import KnxEntity as KnxEntity
+from .knx_entity import KnxYamlEntity as KnxYamlEntity
 from .schema import CoverSchema as CoverSchema
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
@@ -10,19 +11,18 @@ from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 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: AddEntitiesCallback) -> None: ...
 
-class KNXCover(KnxEntity, CoverEntity):
+class KNXCover(KnxYamlEntity, CoverEntity):
     _device: XknxCover
     _unsubscribe_auto_updater: Incomplete
     _attr_entity_category: Incomplete
     _attr_supported_features: Incomplete
     _attr_device_class: Incomplete
     _attr_unique_id: Incomplete
-    def __init__(self, xknx: XKNX, config: ConfigType) -> None: ...
+    def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
     @property
     def current_cover_position(self) -> int | None: ...
     @property

homeassistant-stubs/components/knx/date.pyi

@@ -1,5 +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, CONF_SYNC_STATE as CONF_SYNC_STATE, DATA_KNX_CONFIG as DATA_KNX_CONFIG, DOMAIN as DOMAIN, KNX_ADDRESS as KNX_ADDRESS
-from .knx_entity import KnxEntity as KnxEntity
+from .knx_entity import KnxYamlEntity as KnxYamlEntity
 from _typeshed import Incomplete
 from datetime import date as dt_date
 from homeassistant import config_entries as config_entries
@@ -9,20 +10,17 @@ from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from homeassistant.helpers.restore_state import RestoreEntity as RestoreEntity
 from homeassistant.helpers.typing import ConfigType as ConfigType
-from typing import Final
 from xknx import XKNX as XKNX
-from xknx.devices import DateTime as XknxDateTime
-
-_DATE_TRANSLATION_FORMAT: Final[str]
+from xknx.devices import DateDevice as XknxDateDevice
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: config_entries.ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
-def _create_xknx_device(xknx: XKNX, config: ConfigType) -> XknxDateTime: ...
+def _create_xknx_device(xknx: XKNX, config: ConfigType) -> XknxDateDevice: ...
 
-class KNXDate(KnxEntity, DateEntity, RestoreEntity):
-    _device: XknxDateTime
+class KNXDateEntity(KnxYamlEntity, DateEntity, RestoreEntity):
+    _device: XknxDateDevice
     _attr_entity_category: Incomplete
     _attr_unique_id: Incomplete
-    def __init__(self, xknx: XKNX, config: ConfigType) -> None: ...
+    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: ...

homeassistant-stubs/components/knx/datetime.pyi

@@ -1,5 +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, CONF_SYNC_STATE as CONF_SYNC_STATE, DATA_KNX_CONFIG as DATA_KNX_CONFIG, DOMAIN as DOMAIN, KNX_ADDRESS as KNX_ADDRESS
-from .knx_entity import KnxEntity as KnxEntity
+from .knx_entity import KnxYamlEntity as KnxYamlEntity
 from _typeshed import Incomplete
 from datetime import datetime
 from homeassistant import config_entries as config_entries
@@ -10,16 +11,16 @@ from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEnti
 from homeassistant.helpers.restore_state import RestoreEntity as RestoreEntity
 from homeassistant.helpers.typing import ConfigType as ConfigType
 from xknx import XKNX as XKNX
-from xknx.devices import DateTime as XknxDateTime
+from xknx.devices import DateTimeDevice as XknxDateTimeDevice
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: config_entries.ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
-def _create_xknx_device(xknx: XKNX, config: ConfigType) -> XknxDateTime: ...
+def _create_xknx_device(xknx: XKNX, config: ConfigType) -> XknxDateTimeDevice: ...
 
-class KNXDateTime(KnxEntity, DateTimeEntity, RestoreEntity):
-    _device: XknxDateTime
+class KNXDateTimeEntity(KnxYamlEntity, DateTimeEntity, RestoreEntity):
+    _device: XknxDateTimeDevice
     _attr_entity_category: Incomplete
     _attr_unique_id: Incomplete
-    def __init__(self, xknx: XKNX, config: ConfigType) -> None: ...
+    def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
     async def async_added_to_hass(self) -> None: ...
     @property
     def native_value(self) -> datetime | None: ...

homeassistant-stubs/components/knx/device.pyi

@@ -8,6 +8,7 @@ from xknx.core import XknxConnectionState
 from xknx.io.gateway_scanner import GatewayDescriptor as GatewayDescriptor
 
 class KNXInterfaceDevice:
+    hass: Incomplete
     device_registry: Incomplete
     gateway_descriptor: Incomplete
     xknx: Incomplete
@@ -15,4 +16,4 @@ class KNXInterfaceDevice:
     device_info: Incomplete
     def __init__(self, hass: HomeAssistant, entry: ConfigEntry, xknx: XKNX) -> None: ...
     async def update(self) -> None: ...
-    async def connection_state_changed_cb(self, state: XknxConnectionState) -> None: ...
+    def connection_state_changed_cb(self, state: XknxConnectionState) -> None: ...

homeassistant-stubs/components/knx/expose.pyi

@@ -9,7 +9,6 @@ from homeassistant.helpers.event import async_track_state_change_event as async_
 from homeassistant.helpers.template import Template as Template
 from homeassistant.helpers.typing import ConfigType as ConfigType, StateType as StateType
 from xknx import XKNX as XKNX
-from xknx.devices import DateTime, ExposeSensor
 
 _LOGGER: Incomplete
 
@@ -26,9 +25,9 @@ class KNXExposeSensor:
     _remove_listener: Incomplete
     device: Incomplete
     def __init__(self, hass: HomeAssistant, xknx: XKNX, config: ConfigType) -> None: ...
-    def async_register(self, config: ConfigType) -> ExposeSensor: ...
+    def async_register(self) -> None: ...
     def _init_expose_state(self) -> None: ...
-    def shutdown(self) -> None: ...
+    def async_remove(self) -> None: ...
     def _get_expose_value(self, state: State | None) -> bool | int | float | str | None: ...
     async def _async_entity_changed(self, event: Event[EventStateChangedData]) -> None: ...
     async def _async_set_knx_value(self, value: StateType) -> None: ...
@@ -37,5 +36,5 @@ class KNXExposeTime:
     xknx: Incomplete
     device: Incomplete
     def __init__(self, xknx: XKNX, config: ConfigType) -> None: ...
-    def async_register(self, config: ConfigType) -> DateTime: ...
-    def shutdown(self) -> None: ...
+    def async_register(self) -> None: ...
+    def async_remove(self) -> None: ...

homeassistant-stubs/components/knx/fan.pyi

@@ -1,5 +1,6 @@
+from . import KNXModule as KNXModule
 from .const import DATA_KNX_CONFIG as DATA_KNX_CONFIG, DOMAIN as DOMAIN, KNX_ADDRESS as KNX_ADDRESS
-from .knx_entity import KnxEntity as KnxEntity
+from .knx_entity import KnxYamlEntity as KnxYamlEntity
 from .schema import FanSchema as FanSchema
 from _typeshed import Incomplete
 from homeassistant import config_entries as config_entries
@@ -11,19 +12,19 @@ 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 xknx import XKNX as XKNX
 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: AddEntitiesCallback) -> None: ...
 
-class KNXFan(KnxEntity, FanEntity):
+class KNXFan(KnxYamlEntity, FanEntity):
     _device: XknxFan
+    _enable_turn_on_off_backwards_compatibility: bool
     _step_range: Incomplete
     _attr_entity_category: Incomplete
     _attr_unique_id: Incomplete
-    def __init__(self, xknx: XKNX, config: ConfigType) -> None: ...
+    def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
     async def async_set_percentage(self, percentage: int) -> None: ...
     @property
     def supported_features(self) -> FanEntityFeature: ...

homeassistant-stubs/components/knx/knx_entity.pyi

@@ -1,17 +1,41 @@
+import abc
 from . import KNXModule as KNXModule
-from .const import DOMAIN as DOMAIN
+from .storage.config_store import PlatformControllerBase as PlatformControllerBase
 from _typeshed import Incomplete
+from abc import ABC, abstractmethod
 from homeassistant.helpers.entity import Entity as Entity
+from homeassistant.helpers.entity_platform import EntityPlatform as EntityPlatform
+from homeassistant.helpers.entity_registry import RegistryEntry as RegistryEntry
+from typing import Any
 from xknx.devices import Device as XknxDevice
 
-class KnxEntity(Entity):
+class KnxUiEntityPlatformController(PlatformControllerBase):
+    _knx_module: Incomplete
+    _entity_platform: Incomplete
+    _entity_class: Incomplete
+    def __init__(self, knx_module: KNXModule, entity_platform: EntityPlatform, entity_class: type[KnxUiEntity]) -> None: ...
+    async def create_entity(self, unique_id: str, config: dict[str, Any]) -> None: ...
+    async def update_entity(self, entity_entry: RegistryEntry, config: dict[str, Any]) -> None: ...
+
+class _KnxEntityBase(Entity):
     _attr_should_poll: bool
-    _device: Incomplete
-    def __init__(self, device: XknxDevice) -> None: ...
+    _knx_module: KNXModule
+    _device: XknxDevice
     @property
     def name(self) -> str: ...
     @property
     def available(self) -> bool: ...
     async def async_update(self) -> None: ...
-    async def after_update_callback(self, device: XknxDevice) -> None: ...
+    def after_update_callback(self, _device: XknxDevice) -> None: ...
     async def async_added_to_hass(self) -> None: ...
+    async def async_will_remove_from_hass(self) -> None: ...
+
+class KnxYamlEntity(_KnxEntityBase):
+    _knx_module: Incomplete
+    _device: Incomplete
+    def __init__(self, knx_module: KNXModule, device: XknxDevice) -> None: ...
+
+class KnxUiEntity(_KnxEntityBase, ABC, metaclass=abc.ABCMeta):
+    _attr_unique_id: str
+    @abstractmethod
+    def __init__(self, knx_module: KNXModule, unique_id: str, config: dict[str, Any]): ...

homeassistant-stubs/components/knx/light.pyi

@@ -1,28 +1,29 @@
-from .const import ColorTempModes as ColorTempModes, DATA_KNX_CONFIG as DATA_KNX_CONFIG, DOMAIN as DOMAIN, KNX_ADDRESS as KNX_ADDRESS
-from .knx_entity import KnxEntity as KnxEntity
+from . import KNXModule as KNXModule
+from .const import CONF_SYNC_STATE as CONF_SYNC_STATE, ColorTempModes as ColorTempModes, DATA_KNX_CONFIG as DATA_KNX_CONFIG, DOMAIN as DOMAIN, KNX_ADDRESS as KNX_ADDRESS
+from .knx_entity import KnxUiEntity as KnxUiEntity, KnxUiEntityPlatformController as KnxUiEntityPlatformController, KnxYamlEntity as KnxYamlEntity
 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_DEVICE_INFO as CONF_DEVICE_INFO, 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.entity_store_schema import LightColorMode as LightColorMode
 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
 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 AddEntitiesCallback as AddEntitiesCallback
+from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo
+from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback, 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.light import Light as XknxLight
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: config_entries.ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
-def _create_light(xknx: XKNX, config: ConfigType) -> XknxLight: ...
+def _create_yaml_light(xknx: XKNX, config: ConfigType) -> XknxLight: ...
+def _create_ui_light(xknx: XKNX, knx_config: ConfigType, name: str) -> XknxLight: ...
 
-class KNXLight(KnxEntity, LightEntity):
+class _KnxLight(LightEntity):
+    _attr_max_color_temp_kelvin: int
+    _attr_min_color_temp_kelvin: int
     _device: XknxLight
-    _attr_max_color_temp_kelvin: Incomplete
-    _attr_min_color_temp_kelvin: Incomplete
-    _attr_entity_category: Incomplete
-    _attr_unique_id: Incomplete
-    def __init__(self, xknx: XKNX, config: ConfigType) -> None: ...
-    def _device_unique_id(self) -> str: ...
     @property
     def is_on(self) -> bool: ...
     @property
@@ -43,3 +44,23 @@ class KNXLight(KnxEntity, LightEntity):
     def supported_color_modes(self) -> set[ColorMode]: ...
     async def async_turn_on(self, **kwargs: Any) -> None: ...
     async def async_turn_off(self, **kwargs: Any) -> None: ...
+
+class KnxYamlLight(_KnxLight, KnxYamlEntity):
+    _device: XknxLight
+    _attr_max_color_temp_kelvin: Incomplete
+    _attr_min_color_temp_kelvin: Incomplete
+    _attr_entity_category: Incomplete
+    _attr_unique_id: Incomplete
+    def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
+    def _device_unique_id(self) -> str: ...
+
+class KnxUiLight(_KnxLight, KnxUiEntity):
+    _attr_has_entity_name: bool
+    _device: XknxLight
+    _knx_module: Incomplete
+    _attr_max_color_temp_kelvin: Incomplete
+    _attr_min_color_temp_kelvin: Incomplete
+    _attr_entity_category: Incomplete
+    _attr_unique_id: Incomplete
+    _attr_device_info: Incomplete
+    def __init__(self, knx_module: KNXModule, unique_id: str, config: ConfigType) -> None: ...

homeassistant-stubs/components/knx/notify.pyi

@@ -1,5 +1,6 @@
+from . import KNXModule as KNXModule
 from .const import DATA_KNX_CONFIG as DATA_KNX_CONFIG, DOMAIN as DOMAIN, KNX_ADDRESS as KNX_ADDRESS
-from .knx_entity import KnxEntity as KnxEntity
+from .knx_entity import KnxYamlEntity as KnxYamlEntity
 from _typeshed import Incomplete
 from homeassistant import config_entries as config_entries
 from homeassistant.components.notify import BaseNotificationService as BaseNotificationService, NotifyEntity as NotifyEntity, migrate_notify_issue as migrate_notify_issue
@@ -25,9 +26,9 @@ class KNXNotificationService(BaseNotificationService):
 async def async_setup_entry(hass: HomeAssistant, config_entry: config_entries.ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 def _create_notification_instance(xknx: XKNX, config: ConfigType) -> XknxNotification: ...
 
-class KNXNotify(KnxEntity, NotifyEntity):
+class KNXNotify(KnxYamlEntity, NotifyEntity):
     _device: XknxNotification
     _attr_entity_category: Incomplete
     _attr_unique_id: Incomplete
-    def __init__(self, xknx: XKNX, config: ConfigType) -> None: ...
+    def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
     async def async_send_message(self, message: str, title: str | None = None) -> None: ...

homeassistant-stubs/components/knx/number.pyi

@@ -1,5 +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, DATA_KNX_CONFIG as DATA_KNX_CONFIG, DOMAIN as DOMAIN, KNX_ADDRESS as KNX_ADDRESS
-from .knx_entity import KnxEntity as KnxEntity
+from .knx_entity import KnxYamlEntity as KnxYamlEntity
 from .schema import NumberSchema as NumberSchema
 from _typeshed import Incomplete
 from homeassistant import config_entries as config_entries
@@ -14,7 +15,7 @@ from xknx.devices import NumericValue
 async def async_setup_entry(hass: HomeAssistant, config_entry: config_entries.ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 def _create_numeric_value(xknx: XKNX, config: ConfigType) -> NumericValue: ...
 
-class KNXNumber(KnxEntity, RestoreNumber):
+class KNXNumber(KnxYamlEntity, RestoreNumber):
     _device: NumericValue
     _attr_native_max_value: Incomplete
     _attr_native_min_value: Incomplete
@@ -23,7 +24,7 @@ class KNXNumber(KnxEntity, RestoreNumber):
     _attr_entity_category: Incomplete
     _attr_unique_id: Incomplete
     _attr_native_unit_of_measurement: Incomplete
-    def __init__(self, xknx: XKNX, config: ConfigType) -> None: ...
+    def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
     async def async_added_to_hass(self) -> None: ...
     @property
     def native_value(self) -> float: ...

homeassistant-stubs/components/knx/project.pyi

@@ -6,8 +6,10 @@ from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.storage import Store as Store
 from typing import Final
+from xknx import XKNX as XKNX
 from xknx.dpt import DPTBase
-from xknxproject.models import Device as Device, GroupAddress as GroupAddressModel, KNXProject as KNXProjectModel, ProjectInfo as ProjectInfo
+from xknx.telegram.address import DeviceAddressableType as DeviceAddressableType
+from xknxproject.models import DPTType as DPTType, Device as Device, GroupAddress as GroupAddressModel, KNXProject as KNXProjectModel, ProjectInfo as ProjectInfo
 
 _LOGGER: Incomplete
 STORAGE_VERSION: Final[int]
@@ -34,7 +36,7 @@ class KNXProject:
     _store: Incomplete
     def __init__(self, hass: HomeAssistant, entry: ConfigEntry) -> None: ...
     def initial_state(self) -> None: ...
-    async def load_project(self, data: KNXProjectModel | None = None) -> None: ...
-    async def process_project_file(self, file_id: str, password: str) -> None: ...
+    async def load_project(self, xknx: XKNX, data: KNXProjectModel | None = None) -> None: ...
+    async def process_project_file(self, xknx: XKNX, file_id: str, password: str) -> None: ...
     async def remove_project_file(self) -> None: ...
     async def get_knxproject(self) -> KNXProjectModel | None: ...

homeassistant-stubs/components/knx/scene.pyi

@@ -1,5 +1,6 @@
+from . import KNXModule as KNXModule
 from .const import DATA_KNX_CONFIG as DATA_KNX_CONFIG, DOMAIN as DOMAIN, KNX_ADDRESS as KNX_ADDRESS
-from .knx_entity import KnxEntity as KnxEntity
+from .knx_entity import KnxYamlEntity as KnxYamlEntity
 from .schema import SceneSchema as SceneSchema
 from _typeshed import Incomplete
 from homeassistant import config_entries as config_entries
@@ -9,14 +10,13 @@ from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.entity_platform import AddEntitiesCallback as AddEntitiesCallback
 from homeassistant.helpers.typing import ConfigType as ConfigType
 from typing import Any
-from xknx import XKNX as XKNX
 from xknx.devices import Scene as XknxScene
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: config_entries.ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 
-class KNXScene(KnxEntity, Scene):
+class KNXScene(KnxYamlEntity, Scene):
     _device: XknxScene
     _attr_entity_category: Incomplete
     _attr_unique_id: Incomplete
-    def __init__(self, xknx: XKNX, config: ConfigType) -> None: ...
+    def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
     async def async_activate(self, **kwargs: Any) -> None: ...

homeassistant-stubs/components/knx/schema.pyi

@@ -1,6 +1,6 @@
 import voluptuous as vol
-from .const import 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, CONTROLLER_MODES as CONTROLLER_MODES, ColorTempModes as ColorTempModes, KNX_ADDRESS as KNX_ADDRESS, PRESET_MODES as PRESET_MODES
-from .validation import 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 .const import 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, KNX_ADDRESS as KNX_ADDRESS
+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
 from collections import OrderedDict
@@ -122,6 +122,9 @@ class ExposeSchema(KNXPlatformSchema):
     CONF_KNX_EXPOSE_BINARY: str
     CONF_KNX_EXPOSE_COOLDOWN: str
     CONF_KNX_EXPOSE_DEFAULT: str
+    CONF_TIME: str
+    CONF_DATE: str
+    CONF_DATETIME: str
     EXPOSE_TIME_TYPES: Final[Incomplete]
     EXPOSE_TIME_SCHEMA: Incomplete
     EXPOSE_SENSOR_SCHEMA: Incomplete

homeassistant-stubs/components/knx/select.pyi

@@ -1,5 +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, DATA_KNX_CONFIG as DATA_KNX_CONFIG, DOMAIN as DOMAIN, KNX_ADDRESS as KNX_ADDRESS
-from .knx_entity import KnxEntity as KnxEntity
+from .knx_entity import KnxYamlEntity as KnxYamlEntity
 from .schema import SelectSchema as SelectSchema
 from _typeshed import Incomplete
 from homeassistant import config_entries as config_entries
@@ -15,15 +16,15 @@ from xknx.devices import Device as XknxDevice, RawValue
 async def async_setup_entry(hass: HomeAssistant, config_entry: config_entries.ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 def _create_raw_value(xknx: XKNX, config: ConfigType) -> RawValue: ...
 
-class KNXSelect(KnxEntity, SelectEntity, RestoreEntity):
+class KNXSelect(KnxYamlEntity, SelectEntity, RestoreEntity):
     _device: RawValue
     _option_payloads: Incomplete
     _attr_options: Incomplete
     _attr_current_option: Incomplete
     _attr_entity_category: Incomplete
     _attr_unique_id: Incomplete
-    def __init__(self, xknx: XKNX, config: ConfigType) -> None: ...
+    def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
     async def async_added_to_hass(self) -> None: ...
-    async def after_update_callback(self, device: XknxDevice) -> None: ...
+    def after_update_callback(self, device: XknxDevice) -> None: ...
     def option_from_payload(self, payload: int | None) -> str | None: ...
     async def async_select_option(self, option: str) -> None: ...

homeassistant-stubs/components/knx/sensor.pyi

@@ -1,6 +1,6 @@
 from . import KNXModule as KNXModule
 from .const import ATTR_SOURCE as ATTR_SOURCE, DATA_KNX_CONFIG as DATA_KNX_CONFIG, DOMAIN as DOMAIN
-from .knx_entity import KnxEntity as KnxEntity
+from .knx_entity import KnxYamlEntity as KnxYamlEntity
 from .schema import SensorSchema as SensorSchema
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
@@ -27,14 +27,14 @@ class KNXSystemEntityDescription(SensorEntityDescription):
     has_entity_name: bool = ...
     should_poll: bool = ...
     value_fn: Callable[[KNXModule], StateType | datetime] = ...
-    def __init__(self, *, key, device_class, entity_category, entity_registry_enabled_default, entity_registry_visible_default, force_update, icon, has_entity_name, name, translation_key, translation_placeholders, unit_of_measurement, last_reset, native_unit_of_measurement, options, state_class, suggested_display_precision, suggested_unit_of_measurement, always_available, should_poll, value_fn) -> None: ...
+    def __init__(self, *, key, device_class=..., entity_category=..., entity_registry_enabled_default=..., entity_registry_visible_default=..., force_update=..., icon=..., has_entity_name=..., name=..., translation_key=..., translation_placeholders=..., unit_of_measurement=..., last_reset=..., native_unit_of_measurement=..., options=..., state_class=..., suggested_display_precision=..., suggested_unit_of_measurement=..., always_available=..., should_poll=..., value_fn=...) -> None: ...
 
 SYSTEM_ENTITY_DESCRIPTIONS: Incomplete
 
 async def async_setup_entry(hass: HomeAssistant, config_entry: config_entries.ConfigEntry, async_add_entities: AddEntitiesCallback) -> None: ...
 def _create_sensor(xknx: XKNX, config: ConfigType) -> XknxSensor: ...
 
-class KNXSensor(KnxEntity, SensorEntity):
+class KNXSensor(KnxYamlEntity, SensorEntity):
     _device: XknxSensor
     _attr_device_class: Incomplete
     _attr_force_update: Incomplete
@@ -42,7 +42,7 @@ class KNXSensor(KnxEntity, SensorEntity):
     _attr_unique_id: Incomplete
     _attr_native_unit_of_measurement: Incomplete
     _attr_state_class: Incomplete
-    def __init__(self, xknx: XKNX, config: ConfigType) -> None: ...
+    def __init__(self, knx_module: KNXModule, config: ConfigType) -> None: ...
     @property
     def native_value(self) -> StateType: ...
     @property
@@ -61,5 +61,5 @@ class KNXSystemSensor(SensorEntity):
     def native_value(self) -> StateType | datetime: ...
     @property
     def available(self) -> bool: ...
-    async def after_update_callback(self, _: XknxConnectionState) -> None: ...
+    def after_update_callback(self, _: XknxConnectionState) -> None: ...
     async def async_added_to_hass(self) -> None: ...

homeassistant-stubs/components/knx/services.pyi

@@ -1,7 +1,7 @@
 from . import KNXModule as KNXModule
 from .const import DOMAIN as DOMAIN, KNX_ADDRESS as KNX_ADDRESS, 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 .schema import ExposeSchema as ExposeSchema, ga_validator as ga_validator, sensor_type_validator as sensor_type_validator
+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
 from homeassistant.core import HomeAssistant as HomeAssistant, ServiceCall as ServiceCall, callback as callback

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

@@ -0,0 +1,44 @@
+import abc
+from ..const import DOMAIN as DOMAIN
+from .const import CONF_DATA as CONF_DATA
+from _typeshed import Incomplete
+from abc import ABC, abstractmethod
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.const import CONF_PLATFORM as CONF_PLATFORM, Platform as Platform
+from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.helpers import entity_registry as er
+from homeassistant.helpers.storage import Store as Store
+from homeassistant.util.ulid import ulid_now as ulid_now
+from typing import Any, Final, TypedDict
+
+_LOGGER: Incomplete
+STORAGE_VERSION: Final[int]
+STORAGE_KEY: Final[Incomplete]
+KNXPlatformStoreModel = dict[str, dict[str, Any]]
+KNXEntityStoreModel = dict[str, KNXPlatformStoreModel]
+
+class KNXConfigStoreModel(TypedDict):
+    entities: KNXEntityStoreModel
+
+class PlatformControllerBase(ABC, metaclass=abc.ABCMeta):
+    @abstractmethod
+    async def create_entity(self, unique_id: str, config: dict[str, Any]) -> None: ...
+    @abstractmethod
+    async def update_entity(self, entity_entry: er.RegistryEntry, config: dict[str, Any]) -> None: ...
+
+class KNXConfigStore:
+    hass: Incomplete
+    config_entry: Incomplete
+    _store: Incomplete
+    data: Incomplete
+    _platform_controllers: Incomplete
+    def __init__(self, hass: HomeAssistant, config_entry: ConfigEntry) -> None: ...
+    async def load_data(self) -> None: ...
+    def add_platform(self, platform: Platform, controller: PlatformControllerBase) -> None: ...
+    async def create_entity(self, platform: Platform, data: dict[str, Any]) -> str | None: ...
+    def get_entity_config(self, entity_id: str) -> dict[str, Any]: ...
+    async def update_entity(self, platform: Platform, entity_id: str, data: dict[str, Any]) -> None: ...
+    async def delete_entity(self, entity_id: str) -> None: ...
+    def get_entity_entries(self) -> list[er.RegistryEntry]: ...
+
+class ConfigStoreException(Exception): ...

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

@@ -0,0 +1,25 @@
+from typing import Final
+
+CONF_DATA: Final[str]
+CONF_ENTITY: Final[str]
+CONF_DEVICE_INFO: Final[str]
+CONF_GA_WRITE: Final[str]
+CONF_GA_STATE: Final[str]
+CONF_GA_PASSIVE: Final[str]
+CONF_DPT: Final[str]
+CONF_GA_SWITCH: Final[str]
+CONF_GA_COLOR_TEMP: Final[str]
+CONF_COLOR_TEMP_MIN: Final[str]
+CONF_COLOR_TEMP_MAX: Final[str]
+CONF_GA_BRIGHTNESS: Final[str]
+CONF_GA_COLOR: Final[str]
+CONF_GA_RED_BRIGHTNESS: Final[str]
+CONF_GA_RED_SWITCH: Final[str]
+CONF_GA_GREEN_BRIGHTNESS: Final[str]
+CONF_GA_GREEN_SWITCH: Final[str]
+CONF_GA_BLUE_BRIGHTNESS: Final[str]
+CONF_GA_BLUE_SWITCH: Final[str]
+CONF_GA_WHITE_BRIGHTNESS: Final[str]
+CONF_GA_WHITE_SWITCH: Final[str]
+CONF_GA_HUE: Final[str]
+CONF_GA_SATURATION: Final[str]

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

@@ -0,0 +1,36 @@
+from ..const import CONF_INVERT as CONF_INVERT, CONF_RESPOND_TO_READ as CONF_RESPOND_TO_READ, CONF_SYNC_STATE as CONF_SYNC_STATE, ColorTempModes as ColorTempModes, DOMAIN as DOMAIN, SUPPORTED_PLATFORMS_UI as SUPPORTED_PLATFORMS_UI
+from ..validation import sync_state_validator as sync_state_validator
+from .const import CONF_COLOR_TEMP_MAX as CONF_COLOR_TEMP_MAX, CONF_COLOR_TEMP_MIN as CONF_COLOR_TEMP_MIN, CONF_DATA as CONF_DATA, CONF_DEVICE_INFO as CONF_DEVICE_INFO, 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 .knx_selector import GASelector as GASelector
+from _typeshed import Incomplete
+from enum import StrEnum
+from homeassistant.const import CONF_ENTITY_CATEGORY as CONF_ENTITY_CATEGORY, CONF_ENTITY_ID as CONF_ENTITY_ID, CONF_NAME as CONF_NAME, CONF_PLATFORM as CONF_PLATFORM, Platform as Platform
+from homeassistant.helpers.entity import ENTITY_CATEGORIES_SCHEMA as ENTITY_CATEGORIES_SCHEMA
+from homeassistant.helpers.typing import VolDictType as VolDictType, VolSchemaType as VolSchemaType
+
+BASE_ENTITY_SCHEMA: Incomplete
+
+def optional_ga_schema(key: str, ga_selector: GASelector) -> VolDictType: ...
+
+SWITCH_SCHEMA: Incomplete
+
+class LightColorMode(StrEnum):
+    RGB = '232.600'
+    RGBW = '251.600'
+    XYY = '242.600'
+
+class LightColorModeSchema(StrEnum):
+    DEFAULT = 'default'
+    INDIVIDUAL = 'individual'
+    HSV = 'hsv'
+
+_LIGHT_COLOR_MODE_SCHEMA: str
+_COMMON_LIGHT_SCHEMA: Incomplete
+_DEFAULT_LIGHT_SCHEMA: Incomplete
+_INDIVIDUAL_LIGHT_SCHEMA: Incomplete
+_HSV_LIGHT_SCHEMA: Incomplete
+LIGHT_KNX_SCHEMA: Incomplete
+LIGHT_SCHEMA: Incomplete
+ENTITY_STORE_DATA_SCHEMA: VolSchemaType
+CREATE_ENTITY_BASE_SCHEMA: VolDictType
+UPDATE_ENTITY_BASE_SCHEMA: Incomplete

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

@@ -0,0 +1,25 @@
+import voluptuous as vol
+from .entity_store_schema import ENTITY_STORE_DATA_SCHEMA as ENTITY_STORE_DATA_SCHEMA
+from _typeshed import Incomplete
+from typing import Literal, TypedDict
+
+class _ErrorDescription(TypedDict):
+    path: list[str] | None
+    error_message: str
+    error_class: str
+
+class EntityStoreValidationError(TypedDict):
+    success: Literal[False]
+    error_base: str
+    errors: list[_ErrorDescription]
+
+class EntityStoreValidationSuccess(TypedDict):
+    success: Literal[True]
+    entity_id: str | None
+
+def parse_invalid(exc: vol.Invalid) -> _ErrorDescription: ...
+def validate_entity_data(entity_data: dict) -> dict: ...
+
+class EntityStoreValidationException(Exception):
+    validation_error: Incomplete
+    def __init__(self, validation_error: EntityStoreValidationError) -> None: ...