"""Smart locks — cycle-count lubrication duties.

Interval audit 2026-07-19: Nuki's official guidance is ANNUAL cylinder
lubrication — 2,000 cycles ≈ a year at a typical main door (5-6
cycles/day); heavy doors reach it sooner, matching wear.

Data module of the suggested-setups signature catalog — see
``helpers/signatures/_model.py`` for the direction semantics and the
method contract (every entry cites and is verified against the
integration's source; drift-probed weekly)."""

from __future__ import annotations

from ._model import ConsumableSignature, IntegrationSignature
from ._shared import LOCK_CYLINDER_CYCLES

SIGNATURES: dict[str, IntegrationSignature] = {
    "nuki": IntegrationSignature(
        name="Nuki Smart Lock",
        verified="2026-07-18 @ home-assistant/core dev",
        source=(
            "home-assistant/core homeassistant/components/nuki/lock.py "
            "(NukiLockEntity, one lock entity per device). No wear sensor — "
            "the ENGINE counts locking cycles on the lock entity."
        ),
        tasks=(
            LOCK_CYLINDER_CYCLES,
        ),
    ),
    "tedee": IntegrationSignature(
        name="Tedee Smart Lock",
        verified="2026-07-18 @ home-assistant/core dev",
        source=(
            "home-assistant/core homeassistant/components/tedee/lock.py "
            "(lock platform verified present). Locks carry no wear sensor — "
            "the ENGINE counts locking cycles; entity_domain-gated to locks."
        ),
        tasks=(
            LOCK_CYLINDER_CYCLES,
        ),
    ),
    "august": IntegrationSignature(
        name="August lock",
        verified="2026-07-18 @ home-assistant/core dev",
        source=(
            "home-assistant/core homeassistant/components/august/lock.py "
            "(lock platform verified present). Locks carry no wear sensor — "
            "the ENGINE counts locking cycles; entity_domain-gated to locks."
        ),
        tasks=(
            LOCK_CYLINDER_CYCLES,
        ),
    ),
    "yale": IntegrationSignature(
        name="Yale lock",
        verified="2026-07-18 @ home-assistant/core dev",
        source=(
            "home-assistant/core homeassistant/components/yale/lock.py "
            "(lock platform verified present). Locks carry no wear sensor — "
            "the ENGINE counts locking cycles; entity_domain-gated to locks."
        ),
        tasks=(
            LOCK_CYLINDER_CYCLES,
        ),
    ),
    "switchbot": IntegrationSignature(
        name="SwitchBot Lock",
        verified="2026-07-18 @ home-assistant/core dev",
        source=(
            "home-assistant/core homeassistant/components/switchbot/lock.py "
            "(lock platform verified present). Locks carry no wear sensor — "
            "the ENGINE counts locking cycles; entity_domain-gated to locks."
        ),
        tasks=(
            LOCK_CYLINDER_CYCLES,
        ),
    ),
    "loqed": IntegrationSignature(
        name="LOQED Smart Lock",
        verified="2026-07-18 @ home-assistant/core dev",
        source=(
            "home-assistant/core homeassistant/components/loqed/lock.py "
            "(lock platform verified present). Locks carry no wear sensor — "
            "the ENGINE counts locking cycles; entity_domain-gated to locks."
        ),
        tasks=(
            LOCK_CYLINDER_CYCLES,
        ),
    ),
    "homematicip_cloud": IntegrationSignature(
        name="Homematic IP lock",
        verified="2026-07-18 @ home-assistant/core dev",
        source=(
            "home-assistant/core homeassistant/components/homematicip_cloud/lock.py "
            "(lock platform verified present). Locks carry no wear sensor — "
            "the ENGINE counts locking cycles; entity_domain-gated to locks."
        ),
        tasks=(
            LOCK_CYLINDER_CYCLES,
        ),
    ),
    "schlage": IntegrationSignature(
        name="Schlage lock",
        verified="2026-07-18 @ home-assistant/core dev",
        source=(
            "home-assistant/core homeassistant/components/schlage/lock.py "
            "(lock platform verified present) — engine-counted locking cycles."
        ),
        tasks=(
            LOCK_CYLINDER_CYCLES,
        ),
    ),
    "sesame": IntegrationSignature(
        name="Sesame lock",
        verified="2026-07-18 @ home-assistant/core dev",
        source=(
            "home-assistant/core homeassistant/components/sesame/lock.py "
            "(lock platform verified present) — engine-counted locking cycles."
        ),
        tasks=(
            LOCK_CYLINDER_CYCLES,
        ),
    ),
    "yalexs_ble": IntegrationSignature(
        name="Yale/August BLE lock",
        verified="2026-07-18 @ home-assistant/core dev",
        source=(
            "home-assistant/core homeassistant/components/yalexs_ble/lock.py "
            "(lock platform verified present) — engine-counted locking cycles."
        ),
        tasks=(
            LOCK_CYLINDER_CYCLES,
        ),
    ),
    "dormakaba_dkey": IntegrationSignature(
        name="dormakaba dKey lock",
        verified="2026-07-18 @ home-assistant/core dev",
        source=(
            "home-assistant/core homeassistant/components/dormakaba_dkey/lock.py "
            "(lock platform verified present) — engine-counted locking cycles."
        ),
        tasks=(
            LOCK_CYLINDER_CYCLES,
        ),
    ),
    "homematic": IntegrationSignature(
        name="Homematic KeyMatic",
        verified="2026-07-18 @ home-assistant/core dev",
        source=(
            "home-assistant/core homeassistant/components/homematic/lock.py "
            "(lock platform verified present) — engine-counted locking cycles, entity_domain-gated so the hub's other device types are untouched."
        ),
        tasks=(
            LOCK_CYLINDER_CYCLES,
        ),
    ),
    # --- Round 14 (2026-09-25) --------------------------------------------
    "wyzeapi": IntegrationSignature(
        name="Wyze Lock",
        verified="2026-09-25 @ SecKatie/ha-wyzeapi master",
        source=(
            "HACS wyzeapi lock.py (WyzeLock for DeviceTypes.LOCK, WyzeLockBolt "
            "for YD_BT1 — one lock entity per lock device). Engine-counted "
            "locking cycles; entity_domain-gated so the hub's cameras/plugs "
            "are untouched."
        ),
        tasks=(
            LOCK_CYLINDER_CYCLES,
        ),
    ),
    "ttlock": IntegrationSignature(
        name="TTLock",
        verified="2026-09-25 @ jbergler/hass-ttlock develop",
        source=(
            "HACS ttlock lock.py (one Lock entity per lock coordinator, "
            "is_locked from the lock state) — engine-counted locking cycles."
        ),
        tasks=(
            LOCK_CYLINDER_CYCLES,
        ),
    ),
    "kwikset": IntegrationSignature(
        name="Kwikset Smart Locks",
        verified="2026-09-25 @ explosivo22/kwikset-ha main",
        source=(
            "HACS kwikset (not in the default store) lock.py: 'Each physical "
            "lock device exposes a single LockEntity' (KwiksetLock) — "
            "engine-counted locking cycles."
        ),
        tasks=(
            LOCK_CYLINDER_CYCLES,
        ),
    ),
    "nuki_web": IntegrationSignature(
        name="Nuki Web",
        verified="2026-09-25 @ ArnyminerZ/ha-nuki-web master",
        source=(
            "HACS nuki_web lock.py: one NukiLockEntity per smartlock_id — Nuki "
            "OPENERS (type 2) are lock entities too and report 'locked' "
            "whenever the opener is merely online, so they are excluded via "
            "the device model entity.py derives from the type ('Opener')."
        ),
        tasks=(
            ConsumableSignature(
                (),
                "Lubricate Cylinder",
                "cycle_count",
                delta_units=2000,
                entity_domain="lock",
                on_states=("locked",),
                models_exclude=("Opener",),
            ),
        ),
    ),
}