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

homeassistant-stubs/components/openai_conversation/entity.pyi

@@ -1,6 +1,6 @@
 import voluptuous as vol
 from . import OpenAIConfigEntry as OpenAIConfigEntry
-from .const import CONF_CHAT_MODEL as CONF_CHAT_MODEL, CONF_CODE_INTERPRETER as CONF_CODE_INTERPRETER, CONF_MAX_TOKENS as CONF_MAX_TOKENS, CONF_REASONING_EFFORT as CONF_REASONING_EFFORT, CONF_TEMPERATURE as CONF_TEMPERATURE, CONF_TOP_P as CONF_TOP_P, CONF_VERBOSITY as CONF_VERBOSITY, CONF_WEB_SEARCH as CONF_WEB_SEARCH, CONF_WEB_SEARCH_CITY as CONF_WEB_SEARCH_CITY, CONF_WEB_SEARCH_CONTEXT_SIZE as CONF_WEB_SEARCH_CONTEXT_SIZE, CONF_WEB_SEARCH_COUNTRY as CONF_WEB_SEARCH_COUNTRY, CONF_WEB_SEARCH_REGION as CONF_WEB_SEARCH_REGION, CONF_WEB_SEARCH_TIMEZONE as CONF_WEB_SEARCH_TIMEZONE, CONF_WEB_SEARCH_USER_LOCATION as CONF_WEB_SEARCH_USER_LOCATION, DOMAIN as DOMAIN, LOGGER as LOGGER, RECOMMENDED_CHAT_MODEL as RECOMMENDED_CHAT_MODEL, RECOMMENDED_MAX_TOKENS as RECOMMENDED_MAX_TOKENS, RECOMMENDED_REASONING_EFFORT as RECOMMENDED_REASONING_EFFORT, RECOMMENDED_TEMPERATURE as RECOMMENDED_TEMPERATURE, RECOMMENDED_TOP_P as RECOMMENDED_TOP_P, RECOMMENDED_VERBOSITY as RECOMMENDED_VERBOSITY, RECOMMENDED_WEB_SEARCH_CONTEXT_SIZE as RECOMMENDED_WEB_SEARCH_CONTEXT_SIZE
+from .const import CONF_CHAT_MODEL as CONF_CHAT_MODEL, CONF_CODE_INTERPRETER as CONF_CODE_INTERPRETER, CONF_IMAGE_MODEL as CONF_IMAGE_MODEL, CONF_MAX_TOKENS as CONF_MAX_TOKENS, CONF_REASONING_EFFORT as CONF_REASONING_EFFORT, CONF_TEMPERATURE as CONF_TEMPERATURE, CONF_TOP_P as CONF_TOP_P, CONF_VERBOSITY as CONF_VERBOSITY, CONF_WEB_SEARCH as CONF_WEB_SEARCH, CONF_WEB_SEARCH_CITY as CONF_WEB_SEARCH_CITY, CONF_WEB_SEARCH_CONTEXT_SIZE as CONF_WEB_SEARCH_CONTEXT_SIZE, CONF_WEB_SEARCH_COUNTRY as CONF_WEB_SEARCH_COUNTRY, CONF_WEB_SEARCH_INLINE_CITATIONS as CONF_WEB_SEARCH_INLINE_CITATIONS, CONF_WEB_SEARCH_REGION as CONF_WEB_SEARCH_REGION, CONF_WEB_SEARCH_TIMEZONE as CONF_WEB_SEARCH_TIMEZONE, CONF_WEB_SEARCH_USER_LOCATION as CONF_WEB_SEARCH_USER_LOCATION, DOMAIN as DOMAIN, LOGGER as LOGGER, RECOMMENDED_CHAT_MODEL as RECOMMENDED_CHAT_MODEL, RECOMMENDED_IMAGE_MODEL as RECOMMENDED_IMAGE_MODEL, RECOMMENDED_MAX_TOKENS as RECOMMENDED_MAX_TOKENS, RECOMMENDED_REASONING_EFFORT as RECOMMENDED_REASONING_EFFORT, RECOMMENDED_TEMPERATURE as RECOMMENDED_TEMPERATURE, RECOMMENDED_TOP_P as RECOMMENDED_TOP_P, RECOMMENDED_VERBOSITY as RECOMMENDED_VERBOSITY, RECOMMENDED_WEB_SEARCH_CONTEXT_SIZE as RECOMMENDED_WEB_SEARCH_CONTEXT_SIZE, RECOMMENDED_WEB_SEARCH_INLINE_CITATIONS as RECOMMENDED_WEB_SEARCH_INLINE_CITATIONS, UNSUPPORTED_EXTENDED_CACHE_RETENTION_MODELS as UNSUPPORTED_EXTENDED_CACHE_RETENTION_MODELS
 from _typeshed import Incomplete
 from collections.abc import AsyncGenerator, Callable as Callable, Iterable
 from homeassistant.components import conversation as conversation
@@ -21,7 +21,7 @@ def _adjust_schema(schema: dict[str, Any]) -> None: ...
 def _format_structured_output(schema: vol.Schema, llm_api: llm.APIInstance | None) -> dict[str, Any]: ...
 def _format_tool(tool: llm.Tool, custom_serializer: Callable[[Any], Any] | None) -> FunctionToolParam: ...
 def _convert_content_to_param(chat_content: Iterable[conversation.Content]) -> ResponseInputParam: ...
-async def _transform_stream(chat_log: conversation.ChatLog, stream: AsyncStream[ResponseStreamEvent]) -> AsyncGenerator[conversation.AssistantContentDeltaDict | conversation.ToolResultContentDeltaDict]: ...
+async def _transform_stream(chat_log: conversation.ChatLog, stream: AsyncStream[ResponseStreamEvent], remove_citations: bool = False) -> AsyncGenerator[conversation.AssistantContentDeltaDict | conversation.ToolResultContentDeltaDict]: ...
 
 class OpenAIBaseLLMEntity(Entity):
     _attr_has_entity_name: bool
@@ -31,6 +31,6 @@ class OpenAIBaseLLMEntity(Entity):
     _attr_unique_id: Incomplete
     _attr_device_info: Incomplete
     def __init__(self, entry: OpenAIConfigEntry, subentry: ConfigSubentry) -> None: ...
-    async def _async_handle_chat_log(self, chat_log: conversation.ChatLog, structure_name: str | None = None, structure: vol.Schema | None = None) -> None: ...
+    async def _async_handle_chat_log(self, chat_log: conversation.ChatLog, structure_name: str | None = None, structure: vol.Schema | None = None, force_image: bool = False) -> None: ...
 
-async def async_prepare_files_for_prompt(hass: HomeAssistant, files: list[Path]) -> ResponseInputMessageContentListParam: ...
+async def async_prepare_files_for_prompt(hass: HomeAssistant, files: list[tuple[Path, str | None]]) -> ResponseInputMessageContentListParam: ...

homeassistant-stubs/components/openuv/__init__.pyi

@@ -1,5 +1,5 @@
 from .const import CONF_FROM_WINDOW as CONF_FROM_WINDOW, CONF_TO_WINDOW as CONF_TO_WINDOW, DATA_PROTECTION_WINDOW as DATA_PROTECTION_WINDOW, DATA_UV as DATA_UV, DEFAULT_FROM_WINDOW as DEFAULT_FROM_WINDOW, DEFAULT_TO_WINDOW as DEFAULT_TO_WINDOW, DOMAIN as DOMAIN, LOGGER as LOGGER
-from .coordinator import OpenUvCoordinator as OpenUvCoordinator
+from .coordinator import OpenUvCoordinator as OpenUvCoordinator, OpenUvProtectionWindowCoordinator as OpenUvProtectionWindowCoordinator
 from _typeshed import Incomplete
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import CONF_API_KEY as CONF_API_KEY, CONF_BINARY_SENSORS as CONF_BINARY_SENSORS, CONF_ELEVATION as CONF_ELEVATION, CONF_LATITUDE as CONF_LATITUDE, CONF_LONGITUDE as CONF_LONGITUDE, CONF_SENSORS as CONF_SENSORS, Platform as Platform

homeassistant-stubs/components/openuv/binary_sensor.pyi

@@ -6,7 +6,7 @@ from homeassistant.components.binary_sensor import BinarySensorEntity as BinaryS
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
-from homeassistant.util.dt import as_local as as_local, parse_datetime as parse_datetime, utcnow as utcnow
+from homeassistant.util.dt import as_local as as_local
 
 ATTR_PROTECTION_WINDOW_ENDING_TIME: str
 ATTR_PROTECTION_WINDOW_ENDING_UV: str
@@ -19,5 +19,5 @@ async def async_setup_entry(hass: HomeAssistant, entry: ConfigEntry, async_add_e
 class OpenUvBinarySensor(OpenUvEntity, BinarySensorEntity):
     @callback
     def _handle_coordinator_update(self) -> None: ...
-    _attr_is_on: bool
+    _attr_is_on: Incomplete
     def _update_attrs(self) -> None: ...

homeassistant-stubs/components/openuv/coordinator.pyi

@@ -1,11 +1,13 @@
+import datetime as dt
 from .const import LOGGER as LOGGER
 from _typeshed import Incomplete
 from collections.abc import Awaitable, Callable as Callable
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
-from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.core import CALLBACK_TYPE as CALLBACK_TYPE, HomeAssistant as HomeAssistant, callback as callback
 from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed
 from homeassistant.helpers.debounce import Debouncer as Debouncer
 from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
+from homeassistant.util.dt import parse_datetime as parse_datetime, utcnow as utcnow
 from typing import Any
 
 DEFAULT_DEBOUNCER_COOLDOWN_SECONDS: Incomplete
@@ -17,3 +19,14 @@ class OpenUvCoordinator(DataUpdateCoordinator[dict[str, Any]]):
     longitude: Incomplete
     def __init__(self, hass: HomeAssistant, *, entry: ConfigEntry, name: str, latitude: str, longitude: str, update_method: Callable[[], Awaitable[dict[str, Any]]]) -> None: ...
     async def _async_update_data(self) -> dict[str, Any]: ...
+
+class OpenUvProtectionWindowCoordinator(OpenUvCoordinator):
+    _reprocess_listener: CALLBACK_TYPE | None
+    async def _async_update_data(self) -> dict[str, Any]: ...
+    def _parse_data(self, data: dict[str, Any]) -> dict[str, Any]: ...
+    def _process_data(self, data: dict[str, Any]) -> dict[str, Any]: ...
+    def _schedule_reprocessing(self, data: dict[str, Any]) -> None: ...
+    def _async_cancel_reprocess_listener(self) -> None: ...
+    data: Incomplete
+    @callback
+    def _async_handle_reprocess_event(self, now: dt.datetime) -> None: ...

homeassistant-stubs/components/opnsense/__init__.pyi

@@ -0,0 +1,11 @@
+from .const import CONF_API_SECRET as CONF_API_SECRET, CONF_INTERFACE_CLIENT as CONF_INTERFACE_CLIENT, CONF_TRACKER_INTERFACES as CONF_TRACKER_INTERFACES, DOMAIN as DOMAIN, OPNSENSE_DATA as OPNSENSE_DATA
+from _typeshed import Incomplete
+from homeassistant.const import CONF_API_KEY as CONF_API_KEY, CONF_URL as CONF_URL, CONF_VERIFY_SSL as CONF_VERIFY_SSL, Platform as Platform
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.discovery import load_platform as load_platform
+from homeassistant.helpers.typing import ConfigType as ConfigType
+
+_LOGGER: Incomplete
+CONFIG_SCHEMA: Incomplete
+
+def setup(hass: HomeAssistant, config: ConfigType) -> bool: ...

homeassistant-stubs/components/opnsense/const.pyi

@@ -0,0 +1,5 @@
+DOMAIN: str
+OPNSENSE_DATA = DOMAIN
+CONF_API_SECRET: str
+CONF_INTERFACE_CLIENT: str
+CONF_TRACKER_INTERFACES: str

homeassistant-stubs/components/opnsense/device_tracker.pyi

@@ -0,0 +1,23 @@
+from .const import CONF_INTERFACE_CLIENT as CONF_INTERFACE_CLIENT, CONF_TRACKER_INTERFACES as CONF_TRACKER_INTERFACES, OPNSENSE_DATA as OPNSENSE_DATA
+from _typeshed import Incomplete
+from homeassistant.components.device_tracker import DeviceScanner as DeviceScanner
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.typing import ConfigType as ConfigType
+from pyopnsense import diagnostics as diagnostics
+from typing import Any
+
+DeviceDetails: Incomplete
+DeviceDetailsByMAC: Incomplete
+
+async def async_get_scanner(hass: HomeAssistant, config: ConfigType) -> DeviceScanner | None: ...
+
+class OPNsenseDeviceScanner(DeviceScanner):
+    last_results: dict[str, Any]
+    client: Incomplete
+    interfaces: Incomplete
+    def __init__(self, client: diagnostics.InterfaceClient, interfaces: list[str]) -> None: ...
+    def _get_mac_addrs(self, devices: list[DeviceDetails]) -> DeviceDetailsByMAC | dict: ...
+    def scan_devices(self) -> list[str]: ...
+    def get_device_name(self, device: str) -> str | None: ...
+    def update_info(self) -> bool: ...
+    def get_extra_attributes(self, device: str) -> dict[Any, Any]: ...

homeassistant-stubs/components/opower/coordinator.pyi

@@ -9,6 +9,7 @@ from homeassistant.core import HomeAssistant as HomeAssistant, callback as callb
 from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed
 from homeassistant.helpers.aiohttp_client import async_create_clientsession as async_create_clientsession
 from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
+from homeassistant.util.unit_conversion import EnergyConverter as EnergyConverter, VolumeConverter as VolumeConverter
 from opower import Account as Account, CostRead as CostRead, Forecast
 
 _LOGGER: Incomplete

homeassistant-stubs/components/overseerr/coordinator.pyi

@@ -1,4 +1,5 @@
 from .const import DOMAIN as DOMAIN, LOGGER as LOGGER
+from .models import OverseerrData as OverseerrData
 from _typeshed import Incomplete
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import CONF_API_KEY as CONF_API_KEY, CONF_HOST as CONF_HOST, CONF_PORT as CONF_PORT, CONF_SSL as CONF_SSL
@@ -6,13 +7,12 @@ from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed
 from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
 from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
-from python_overseerr import RequestCount
 
 type OverseerrConfigEntry = ConfigEntry[OverseerrCoordinator]
-class OverseerrCoordinator(DataUpdateCoordinator[RequestCount]):
+class OverseerrCoordinator(DataUpdateCoordinator[OverseerrData]):
     config_entry: OverseerrConfigEntry
     client: Incomplete
     url: Incomplete
     push: bool
     def __init__(self, hass: HomeAssistant, entry: OverseerrConfigEntry) -> None: ...
-    async def _async_update_data(self) -> RequestCount: ...
+    async def _async_update_data(self) -> OverseerrData: ...

homeassistant-stubs/components/overseerr/models.pyi

@@ -0,0 +1,7 @@
+from dataclasses import dataclass
+from python_overseerr import IssueCount as IssueCount, RequestCount as RequestCount
+
+@dataclass
+class OverseerrData:
+    requests: RequestCount
+    issues: IssueCount

homeassistant-stubs/components/overseerr/sensor.pyi

@@ -1,19 +1,19 @@
 from .const import REQUESTS as REQUESTS
 from .coordinator import OverseerrConfigEntry as OverseerrConfigEntry, OverseerrCoordinator as OverseerrCoordinator
 from .entity import OverseerrEntity as OverseerrEntity
+from .models import OverseerrData as OverseerrData
 from _typeshed import Incomplete
 from collections.abc import Callable as Callable
 from dataclasses import dataclass
 from homeassistant.components.sensor import SensorEntity as SensorEntity, SensorEntityDescription as SensorEntityDescription, SensorStateClass as SensorStateClass
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
-from python_overseerr import RequestCount as RequestCount
 
 PARALLEL_UPDATES: int
 
 @dataclass(frozen=True, kw_only=True)
 class OverseerrSensorEntityDescription(SensorEntityDescription):
-    value_fn: Callable[[RequestCount], int]
+    value_fn: Callable[[OverseerrData], int]
 
 SENSORS: tuple[OverseerrSensorEntityDescription, ...]
 

homeassistant-stubs/components/ping/__init__.pyi

@@ -12,6 +12,7 @@ CONFIG_SCHEMA: Incomplete
 PLATFORMS: Incomplete
 DATA_PRIVILEGED_KEY: HassKey[bool | None]
 
+async def async_migrate_entry(hass: HomeAssistant, entry: PingConfigEntry) -> bool: ...
 async def async_setup(hass: HomeAssistant, config: ConfigType) -> bool: ...
 async def async_setup_entry(hass: HomeAssistant, entry: PingConfigEntry) -> bool: ...
 async def async_unload_entry(hass: HomeAssistant, entry: PingConfigEntry) -> bool: ...

homeassistant-stubs/components/ping/config_flow.pyi

@@ -14,6 +14,7 @@ def _clean_user_input(user_input: dict[str, Any]) -> dict[str, Any]: ...
 
 class PingConfigFlow(ConfigFlow, domain=DOMAIN):
     VERSION: int
+    MINOR_VERSION: int
     async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
     @staticmethod
     @callback

homeassistant-stubs/components/ping/device_tracker.pyi

@@ -1,4 +1,4 @@
-from .const import CONF_IMPORTED_BY as CONF_IMPORTED_BY
+from .const import CONF_IMPORTED_BY as CONF_IMPORTED_BY, DOMAIN as DOMAIN
 from .coordinator import PingConfigEntry as PingConfigEntry, PingUpdateCoordinator as PingUpdateCoordinator
 from _typeshed import Incomplete
 from datetime import datetime
@@ -14,7 +14,8 @@ class PingDeviceTracker(CoordinatorEntity[PingUpdateCoordinator], ScannerEntity)
     _attr_name: Incomplete
     config_entry: Incomplete
     _consider_home_interval: Incomplete
-    def __init__(self, config_entry: PingConfigEntry, coordinator: PingUpdateCoordinator) -> None: ...
+    device_entry: Incomplete
+    def __init__(self, hass: HomeAssistant, config_entry: PingConfigEntry, coordinator: PingUpdateCoordinator) -> None: ...
     @property
     def ip_address(self) -> str: ...
     @property

homeassistant-stubs/components/ping/entity.pyi

@@ -1,3 +1,4 @@
+from .const import DOMAIN as DOMAIN
 from .coordinator import PingConfigEntry as PingConfigEntry, PingUpdateCoordinator as PingUpdateCoordinator
 from _typeshed import Incomplete
 from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo

homeassistant-stubs/components/ping/sensor.pyi

@@ -4,7 +4,7 @@ from collections.abc import Callable as Callable
 from dataclasses import dataclass
 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 EntityCategory as EntityCategory, UnitOfTime as UnitOfTime
+from homeassistant.const import EntityCategory as EntityCategory, PERCENTAGE as PERCENTAGE, UnitOfTime as UnitOfTime
 from homeassistant.core import HomeAssistant as HomeAssistant
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
 

homeassistant-stubs/components/plugwise/__init__.pyi

@@ -1,4 +1,4 @@
-from .const import DOMAIN as DOMAIN, LOGGER as LOGGER, PLATFORMS as PLATFORMS
+from .const import DEV_CLASS as DEV_CLASS, DOMAIN as DOMAIN, LOGGER as LOGGER, PLATFORMS as PLATFORMS
 from .coordinator import PlugwiseConfigEntry as PlugwiseConfigEntry, PlugwiseDataUpdateCoordinator as PlugwiseDataUpdateCoordinator
 from homeassistant.const import Platform as Platform
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback

homeassistant-stubs/components/plugwise/climate.pyi

@@ -3,21 +3,35 @@ from .coordinator import PlugwiseConfigEntry as PlugwiseConfigEntry, PlugwiseDat
 from .entity import PlugwiseEntity as PlugwiseEntity
 from .util import plugwise_command as plugwise_command
 from _typeshed import Incomplete
+from dataclasses import dataclass
 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, ClimateEntityFeature as ClimateEntityFeature, HVACAction as HVACAction, HVACMode as HVACMode
-from homeassistant.const import ATTR_TEMPERATURE as ATTR_TEMPERATURE, UnitOfTemperature as UnitOfTemperature
+from homeassistant.const import ATTR_TEMPERATURE as ATTR_TEMPERATURE, STATE_OFF as STATE_OFF, STATE_ON as STATE_ON, UnitOfTemperature as UnitOfTemperature
 from homeassistant.core import HomeAssistant as HomeAssistant, callback as callback
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
 from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from homeassistant.helpers.restore_state import ExtraStoredData as ExtraStoredData, RestoreEntity as RestoreEntity
 from typing import Any
 
+ERROR_NO_SCHEDULE: str
 PARALLEL_UPDATES: int
 
+@dataclass
+class PlugwiseClimateExtraStoredData(ExtraStoredData):
+    last_active_schedule: str | None
+    previous_action_mode: str | None
+    def as_dict(self) -> dict[str, Any]: ...
+    @classmethod
+    def from_dict(cls, restored: dict[str, Any]) -> PlugwiseClimateExtraStoredData: ...
+
 async def async_setup_entry(hass: HomeAssistant, entry: PlugwiseConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
 
-class PlugwiseClimateEntity(PlugwiseEntity, ClimateEntity):
+class PlugwiseClimateEntity(PlugwiseEntity, ClimateEntity, RestoreEntity):
     _attr_name: Incomplete
     _attr_temperature_unit: Incomplete
     _attr_translation_key = DOMAIN
-    _previous_mode: str
+    _last_active_schedule: str | None
+    _previous_action_mode: str | None
+    async def async_added_to_hass(self) -> None: ...
     _attr_unique_id: Incomplete
     _gateway_data: Incomplete
     _location: Incomplete
@@ -27,10 +41,11 @@ class PlugwiseClimateEntity(PlugwiseEntity, ClimateEntity):
     _attr_max_temp: Incomplete
     _attr_target_temperature_step: Incomplete
     def __init__(self, coordinator: PlugwiseDataUpdateCoordinator, device_id: str) -> None: ...
-    def _previous_action_mode(self, coordinator: PlugwiseDataUpdateCoordinator) -> None: ...
     @property
     def current_temperature(self) -> float: ...
     @property
+    def extra_restore_state_data(self) -> PlugwiseClimateExtraStoredData: ...
+    @property
     def target_temperature(self) -> float: ...
     @property
     def target_temperature_high(self) -> float: ...

homeassistant-stubs/components/plugwise/config_flow.pyi

@@ -1,5 +1,5 @@
 import voluptuous as vol
-from .const import DEFAULT_PORT as DEFAULT_PORT, DEFAULT_USERNAME as DEFAULT_USERNAME, DOMAIN as DOMAIN, FLOW_SMILE as FLOW_SMILE, FLOW_STRETCH as FLOW_STRETCH, SMILE as SMILE, STRETCH as STRETCH, STRETCH_USERNAME as STRETCH_USERNAME, ZEROCONF_MAP as ZEROCONF_MAP
+from .const import ANNA_WITH_ADAM as ANNA_WITH_ADAM, DEFAULT_PORT as DEFAULT_PORT, DEFAULT_USERNAME as DEFAULT_USERNAME, DOMAIN as DOMAIN, FLOW_SMILE as FLOW_SMILE, FLOW_STRETCH as FLOW_STRETCH, SMILE as SMILE, SMILE_OPEN_THERM as SMILE_OPEN_THERM, SMILE_THERMO as SMILE_THERMO, STRETCH as STRETCH, STRETCH_USERNAME as STRETCH_USERNAME, UNKNOWN_SMILE as UNKNOWN_SMILE, ZEROCONF_MAP as ZEROCONF_MAP
 from _typeshed import Incomplete
 from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult, SOURCE_USER as SOURCE_USER
 from homeassistant.const import ATTR_CONFIGURATION_URL as ATTR_CONFIGURATION_URL, CONF_BASE as CONF_BASE, CONF_HOST as CONF_HOST, CONF_NAME as CONF_NAME, CONF_PASSWORD as CONF_PASSWORD, CONF_PORT as CONF_PORT, CONF_USERNAME as CONF_USERNAME

homeassistant-stubs/components/plugwise/const.pyi

@@ -1,11 +1,13 @@
 from _typeshed import Incomplete
-from datetime import timedelta
 from homeassistant.const import Platform as Platform
 from typing import Final, Literal
 
 DOMAIN: Final[str]
 LOGGER: Incomplete
+ANNA_WITH_ADAM: Final[str]
 API: Final[str]
+AVAILABLE: Final[str]
+DEV_CLASS: Final[str]
 FLOW_SMILE: Final[str]
 FLOW_STRETCH: Final[str]
 FLOW_TYPE: Final[str]
@@ -14,16 +16,25 @@ LOCATION: Final[str]
 PW_TYPE: Final[str]
 REBOOT: Final[str]
 SMILE: Final[str]
+SMILE_OPEN_THERM: Final[str]
+SMILE_THERMO: Final[str]
 STRETCH: Final[str]
 STRETCH_USERNAME: Final[str]
+UNKNOWN_SMILE: Final[str]
 PLATFORMS: Final[list[str]]
 ZEROCONF_MAP: Final[dict[str, str]]
 type NumberType = Literal['maximum_boiler_temperature', 'max_dhw_temperature', 'temperature_offset']
-type SelectType = Literal['select_dhw_mode', 'select_gateway_mode', 'select_regulation_mode', 'select_schedule']
-type SelectOptionsType = Literal['dhw_modes', 'gateway_modes', 'regulation_modes', 'available_schedules']
+type SelectType = Literal['select_dhw_mode', 'select_gateway_mode', 'select_regulation_mode', 'select_schedule', 'select_zone_profile']
+type SelectOptionsType = Literal['available_schedules', 'dhw_modes', 'gateway_modes', 'regulation_modes', 'zone_profiles']
 DEFAULT_MAX_TEMP: Final[int]
 DEFAULT_MIN_TEMP: Final[int]
 DEFAULT_PORT: Final[int]
-DEFAULT_SCAN_INTERVAL: Final[dict[str, timedelta]]
+DEFAULT_UPDATE_INTERVAL: Incomplete
 DEFAULT_USERNAME: Final[str]
+P1_UPDATE_INTERVAL: Incomplete
 MASTER_THERMOSTATS: Final[list[str]]
+SELECT_DHW_MODE: Final[str]
+SELECT_GATEWAY_MODE: Final[str]
+SELECT_REGULATION_MODE: Final[str]
+SELECT_SCHEDULE: Final[str]
+SELECT_ZONE_PROFILE: Final[str]

homeassistant-stubs/components/plugwise/coordinator.pyi

@@ -1,4 +1,4 @@
-from .const import DEFAULT_PORT as DEFAULT_PORT, DEFAULT_USERNAME as DEFAULT_USERNAME, DOMAIN as DOMAIN, LOGGER as LOGGER
+from .const import DEFAULT_PORT as DEFAULT_PORT, DEFAULT_UPDATE_INTERVAL as DEFAULT_UPDATE_INTERVAL, DEFAULT_USERNAME as DEFAULT_USERNAME, DOMAIN as DOMAIN, LOGGER as LOGGER, P1_UPDATE_INTERVAL as P1_UPDATE_INTERVAL
 from _typeshed import Incomplete
 from homeassistant.config_entries import ConfigEntry as ConfigEntry
 from homeassistant.const import CONF_HOST as CONF_HOST, CONF_PASSWORD as CONF_PASSWORD, CONF_PORT as CONF_PORT, CONF_USERNAME as CONF_USERNAME
@@ -12,12 +12,15 @@ from plugwise import GwEntityData
 type PlugwiseConfigEntry = ConfigEntry[PlugwiseDataUpdateCoordinator]
 class PlugwiseDataUpdateCoordinator(DataUpdateCoordinator[dict[str, GwEntityData]]):
     _connected: bool
-    config_entry: PlugwiseConfigEntry
-    api: Incomplete
     _current_devices: set[str]
+    _stored_devices: set[str]
     new_devices: set[str]
+    config_entry: PlugwiseConfigEntry
+    api: Incomplete
     def __init__(self, hass: HomeAssistant, config_entry: PlugwiseConfigEntry) -> None: ...
+    update_interval: Incomplete
     async def _connect(self) -> None: ...
+    async def _async_setup(self) -> None: ...
     async def _async_update_data(self) -> dict[str, GwEntityData]: ...
     def _async_add_remove_devices(self, data: dict[str, GwEntityData]) -> None: ...
     def _async_remove_devices(self, data: dict[str, GwEntityData]) -> None: ...

homeassistant-stubs/components/plugwise/entity.pyi

@@ -1,10 +1,10 @@
-from .const import DOMAIN as DOMAIN
+from .const import AVAILABLE as AVAILABLE, DOMAIN as DOMAIN
 from .coordinator import PlugwiseDataUpdateCoordinator as PlugwiseDataUpdateCoordinator
 from _typeshed import Incomplete
 from homeassistant.const import ATTR_NAME as ATTR_NAME, ATTR_VIA_DEVICE as ATTR_VIA_DEVICE, CONF_HOST as CONF_HOST
 from homeassistant.helpers.device_registry import CONNECTION_NETWORK_MAC as CONNECTION_NETWORK_MAC, CONNECTION_ZIGBEE as CONNECTION_ZIGBEE, DeviceInfo as DeviceInfo
 from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
-from plugwise.constants import GwEntityData as GwEntityData
+from plugwise import GwEntityData as GwEntityData
 
 class PlugwiseEntity(CoordinatorEntity[PlugwiseDataUpdateCoordinator]):
     _attr_has_entity_name: bool

homeassistant-stubs/components/plugwise/select.pyi

@@ -1,4 +1,4 @@
-from .const import SelectOptionsType as SelectOptionsType, SelectType as SelectType
+from .const import SELECT_DHW_MODE as SELECT_DHW_MODE, SELECT_GATEWAY_MODE as SELECT_GATEWAY_MODE, SELECT_REGULATION_MODE as SELECT_REGULATION_MODE, SELECT_SCHEDULE as SELECT_SCHEDULE, SELECT_ZONE_PROFILE as SELECT_ZONE_PROFILE, SelectOptionsType as SelectOptionsType, SelectType as SelectType
 from .coordinator import PlugwiseConfigEntry as PlugwiseConfigEntry, PlugwiseDataUpdateCoordinator as PlugwiseDataUpdateCoordinator
 from .entity import PlugwiseEntity as PlugwiseEntity
 from .util import plugwise_command as plugwise_command

homeassistant-stubs/components/portainer/__init__.pyi

@@ -0,0 +1,12 @@
+from .coordinator import PortainerCoordinator as PortainerCoordinator
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.const import CONF_API_KEY as CONF_API_KEY, CONF_API_TOKEN as CONF_API_TOKEN, CONF_HOST as CONF_HOST, CONF_URL as CONF_URL, CONF_VERIFY_SSL as CONF_VERIFY_SSL, Platform as Platform
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.aiohttp_client import async_create_clientsession as async_create_clientsession
+
+_PLATFORMS: list[Platform]
+type PortainerConfigEntry = ConfigEntry[PortainerCoordinator]
+
+async def async_setup_entry(hass: HomeAssistant, entry: PortainerConfigEntry) -> bool: ...
+async def async_unload_entry(hass: HomeAssistant, entry: PortainerConfigEntry) -> bool: ...
+async def async_migrate_entry(hass: HomeAssistant, entry: PortainerConfigEntry) -> bool: ...

homeassistant-stubs/components/portainer/binary_sensor.pyi

@@ -0,0 +1,41 @@
+from . import PortainerConfigEntry as PortainerConfigEntry
+from .coordinator import PortainerContainerData as PortainerContainerData, PortainerCoordinator as PortainerCoordinator
+from .entity import PortainerContainerEntity as PortainerContainerEntity, PortainerCoordinatorData as PortainerCoordinatorData, PortainerEndpointEntity as PortainerEndpointEntity
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.components.binary_sensor import BinarySensorDeviceClass as BinarySensorDeviceClass, BinarySensorEntity as BinarySensorEntity, BinarySensorEntityDescription as BinarySensorEntityDescription
+from homeassistant.const import EntityCategory as EntityCategory
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+
+@dataclass(frozen=True, kw_only=True)
+class PortainerContainerBinarySensorEntityDescription(BinarySensorEntityDescription):
+    state_fn: Callable[[PortainerContainerData], bool | None]
+
+@dataclass(frozen=True, kw_only=True)
+class PortainerEndpointBinarySensorEntityDescription(BinarySensorEntityDescription):
+    state_fn: Callable[[PortainerCoordinatorData], bool | None]
+
+CONTAINER_SENSORS: tuple[PortainerContainerBinarySensorEntityDescription, ...]
+ENDPOINT_SENSORS: tuple[PortainerEndpointBinarySensorEntityDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: PortainerConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class PortainerEndpointSensor(PortainerEndpointEntity, BinarySensorEntity):
+    entity_description: PortainerEndpointBinarySensorEntityDescription
+    _attr_unique_id: Incomplete
+    def __init__(self, coordinator: PortainerCoordinator, entity_description: PortainerEndpointBinarySensorEntityDescription, device_info: PortainerCoordinatorData) -> None: ...
+    @property
+    def available(self) -> bool: ...
+    @property
+    def is_on(self) -> bool | None: ...
+
+class PortainerContainerSensor(PortainerContainerEntity, BinarySensorEntity):
+    entity_description: PortainerContainerBinarySensorEntityDescription
+    _attr_unique_id: Incomplete
+    def __init__(self, coordinator: PortainerCoordinator, entity_description: PortainerContainerBinarySensorEntityDescription, device_info: PortainerContainerData, via_device: PortainerCoordinatorData) -> None: ...
+    @property
+    def available(self) -> bool: ...
+    @property
+    def is_on(self) -> bool | None: ...

homeassistant-stubs/components/portainer/button.pyi

@@ -0,0 +1,28 @@
+from . import PortainerConfigEntry as PortainerConfigEntry
+from .const import DOMAIN as DOMAIN
+from .coordinator import PortainerContainerData as PortainerContainerData, PortainerCoordinator as PortainerCoordinator, PortainerCoordinatorData as PortainerCoordinatorData
+from .entity import PortainerContainerEntity as PortainerContainerEntity
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable, Coroutine
+from dataclasses import dataclass
+from homeassistant.components.button import ButtonDeviceClass as ButtonDeviceClass, ButtonEntity as ButtonEntity, ButtonEntityDescription as ButtonEntityDescription
+from homeassistant.const import EntityCategory as EntityCategory
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers.entity_platform import AddConfigEntryEntitiesCallback as AddConfigEntryEntitiesCallback
+from pyportainer import Portainer as Portainer
+from typing import Any
+
+@dataclass(frozen=True, kw_only=True)
+class PortainerButtonDescription(ButtonEntityDescription):
+    press_action: Callable[[Portainer, int, str], Coroutine[Any, Any, None]]
+
+BUTTONS: tuple[PortainerButtonDescription, ...]
+
+async def async_setup_entry(hass: HomeAssistant, entry: PortainerConfigEntry, async_add_entities: AddConfigEntryEntitiesCallback) -> None: ...
+
+class PortainerButton(PortainerContainerEntity, ButtonEntity):
+    entity_description: PortainerButtonDescription
+    _attr_unique_id: Incomplete
+    def __init__(self, coordinator: PortainerCoordinator, entity_description: PortainerButtonDescription, device_info: PortainerContainerData, via_device: PortainerCoordinatorData) -> None: ...
+    async def async_press(self) -> None: ...

homeassistant-stubs/components/portainer/config_flow.pyi

@@ -0,0 +1,25 @@
+from .const import DOMAIN as DOMAIN
+from _typeshed import Incomplete
+from collections.abc import Mapping
+from homeassistant.config_entries import ConfigFlow as ConfigFlow, ConfigFlowResult as ConfigFlowResult
+from homeassistant.const import CONF_API_TOKEN as CONF_API_TOKEN, CONF_URL as CONF_URL, CONF_VERIFY_SSL as CONF_VERIFY_SSL
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import HomeAssistantError as HomeAssistantError
+from homeassistant.helpers.aiohttp_client import async_get_clientsession as async_get_clientsession
+from typing import Any
+
+_LOGGER: Incomplete
+STEP_USER_DATA_SCHEMA: Incomplete
+
+async def _validate_input(hass: HomeAssistant, data: dict[str, Any]) -> None: ...
+
+class PortainerConfigFlow(ConfigFlow, domain=DOMAIN):
+    VERSION: int
+    async def async_step_user(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_reauth(self, entry_data: Mapping[str, Any]) -> ConfigFlowResult: ...
+    async def async_step_reauth_confirm(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+    async def async_step_reconfigure(self, user_input: dict[str, Any] | None = None) -> ConfigFlowResult: ...
+
+class CannotConnect(HomeAssistantError): ...
+class InvalidAuth(HomeAssistantError): ...
+class PortainerTimeout(HomeAssistantError): ...

homeassistant-stubs/components/portainer/const.pyi

@@ -0,0 +1,3 @@
+DOMAIN: str
+DEFAULT_NAME: str
+ENDPOINT_STATUS_DOWN: int

homeassistant-stubs/components/portainer/coordinator.pyi

@@ -0,0 +1,44 @@
+from .const import DOMAIN as DOMAIN, ENDPOINT_STATUS_DOWN as ENDPOINT_STATUS_DOWN
+from _typeshed import Incomplete
+from collections.abc import Callable as Callable
+from dataclasses import dataclass
+from homeassistant.config_entries import ConfigEntry as ConfigEntry
+from homeassistant.const import CONF_URL as CONF_URL
+from homeassistant.core import HomeAssistant as HomeAssistant
+from homeassistant.exceptions import ConfigEntryAuthFailed as ConfigEntryAuthFailed, ConfigEntryNotReady as ConfigEntryNotReady
+from homeassistant.helpers.update_coordinator import DataUpdateCoordinator as DataUpdateCoordinator, UpdateFailed as UpdateFailed
+from pyportainer import Portainer as Portainer
+from pyportainer.models.docker import DockerContainer as DockerContainer, DockerContainerStats as DockerContainerStats
+from pyportainer.models.docker_inspect import DockerInfo as DockerInfo, DockerVersion as DockerVersion
+from pyportainer.models.portainer import Endpoint as Endpoint
+
+type PortainerConfigEntry = ConfigEntry[PortainerCoordinator]
+_LOGGER: Incomplete
+DEFAULT_SCAN_INTERVAL: Incomplete
+
+@dataclass
+class PortainerCoordinatorData:
+    id: int
+    name: str | None
+    endpoint: Endpoint
+    containers: dict[str, PortainerContainerData]
+    docker_version: DockerVersion
+    docker_info: DockerInfo
+
+@dataclass(slots=True)
+class PortainerContainerData:
+    container: DockerContainer
+    stats: DockerContainerStats
+    stats_pre: DockerContainerStats | None
+
+class PortainerCoordinator(DataUpdateCoordinator[dict[int, PortainerCoordinatorData]]):
+    config_entry: PortainerConfigEntry
+    portainer: Incomplete
+    known_endpoints: set[int]
+    known_containers: set[tuple[int, str]]
+    new_endpoints_callbacks: list[Callable[[list[PortainerCoordinatorData]], None]]
+    new_containers_callbacks: list[Callable[[list[tuple[PortainerCoordinatorData, PortainerContainerData]]], None]]
+    def __init__(self, hass: HomeAssistant, config_entry: PortainerConfigEntry, portainer: Portainer) -> None: ...
+    async def _async_setup(self) -> None: ...
+    async def _async_update_data(self) -> dict[int, PortainerCoordinatorData]: ...
+    def _async_add_remove_endpoints(self, mapped_endpoints: dict[int, PortainerCoordinatorData]) -> None: ...

homeassistant-stubs/components/portainer/diagnostics.pyi

@@ -0,0 +1,12 @@
+from . import PortainerConfigEntry as PortainerConfigEntry
+from .coordinator import PortainerCoordinator as PortainerCoordinator
+from _typeshed import Incomplete
+from homeassistant.components.diagnostics import async_redact_data as async_redact_data
+from homeassistant.const import CONF_API_TOKEN as CONF_API_TOKEN
+from homeassistant.core import HomeAssistant as HomeAssistant
+from typing import Any
+
+TO_REDACT: Incomplete
+
+def _serialize_coordinator(coordinator: PortainerCoordinator) -> dict[str, Any]: ...
+async def async_get_config_entry_diagnostics(hass: HomeAssistant, config_entry: PortainerConfigEntry) -> dict[str, Any]: ...

homeassistant-stubs/components/portainer/entity.pyi

@@ -0,0 +1,25 @@
+from .const import DEFAULT_NAME as DEFAULT_NAME, DOMAIN as DOMAIN
+from .coordinator import PortainerContainerData as PortainerContainerData, PortainerCoordinator as PortainerCoordinator, PortainerCoordinatorData as PortainerCoordinatorData
+from _typeshed import Incomplete
+from homeassistant.const import CONF_URL as CONF_URL
+from homeassistant.helpers.device_registry import DeviceInfo as DeviceInfo
+from homeassistant.helpers.update_coordinator import CoordinatorEntity as CoordinatorEntity
+
+class PortainerCoordinatorEntity(CoordinatorEntity[PortainerCoordinator]):
+    _attr_has_entity_name: bool
+
+class PortainerEndpointEntity(PortainerCoordinatorEntity):
+    _device_info: Incomplete
+    device_id: Incomplete
+    _attr_device_info: Incomplete
+    def __init__(self, device_info: PortainerCoordinatorData, coordinator: PortainerCoordinator) -> None: ...
+
+class PortainerContainerEntity(PortainerCoordinatorEntity):
+    _device_info: Incomplete
+    device_id: Incomplete
+    endpoint_id: Incomplete
+    device_name: Incomplete
+    _attr_device_info: Incomplete
+    def __init__(self, device_info: PortainerContainerData, coordinator: PortainerCoordinator, via_device: PortainerCoordinatorData) -> None: ...
+    @property
+    def container_data(self) -> PortainerContainerData: ...