[stevendejongnl]

Adds a camera.<name>_map entity for X8-Pro-class devices (tested on a
T2276), showing the robot's current cloud floor-plan with one color per
room, the live cleaning route and the rooms of the current map. Also adds
a water level select for the T2276.

What it does

• thing.m.dev.storage.config.get returns short-lived AWS STS
  credentials and a per-device storage path; the current room layout is
  a presigned S3 object at <path>/common/layout/lay.bin.
• The file is a small header (magic 0pam, width, height,
  compressed/uncompressed lengths) wrapping a raw LZ4 block. Decompressed,
  it's one byte per pixel: high 6 bits are the room id, low 2 bits are a
  pixel type — the same room-outline raster already documented in
  martijnpoppen/eufy-clean's p2pdata.proto.
• map_fetch.py implements the fetch/decode chain, including a
  pure-Python LZ4 block decoder instead of depending on the lz4
  package — HA's custom-component requirements install into a container
  with no C compiler and no prebuilt wheel for every Python version,
  which makes that dependency fail to install there.
• camera.py wires this into a DataUpdateCoordinator-backed camera
  entity, one per vacuum that has Eufy account credentials set on its
  config entry item. It does an explicit first refresh on setup rather
  than waiting for the first scheduled interval, so the camera has real
  data from the moment HA starts instead of serving nothing for up to
  the first refresh interval after every restart.
• docs/MAP_CAMERA.md covers enabling the camera and pairing it with
  lovelace-xiaomi-vacuum-map-card for a tap-to-clean room map, using
  calibration_source: identity so room outlines are plain image
  pixels instead of needing vacuum-coordinate calibration.

Live cleaning route

• tuya.m.device.media.latest v3.0 returns only the newest frame of the
  current clean. The camera polls it while the vacuum cleans or returns and
  adds the points to a route (RouteTracker).
• Pose frames are protobuf messages with zigzag x/y offsets from the dock,
  in 1/10 map pixel. The dock position comes from the lay.bin header.
• The route is drawn over the map with a dot for the robot. It is split
  where a point is off the map or jumps more than 60 pixels. Poll answers
  without a record id or frames are ignored.

Room attributes

The camera lists each room of the current map with its id, pixel count and
centre, measured from the dock. The vacuum can give rooms new ids when it
builds a new map, so an automation can find a room again by its position.

Water level select (T2276)

The T2276 reports its mop water level on DPS 105 as Low, Mid or
High, and the mobile app writes the same strings. A new select entity
(select.<name>_water_level) reads and writes that datapoint with the
options Low, Medium and High. It works next to the read-only water level
sensor from #621, and the two do not depend on each other. Both define the
water level command in T2276.py and base.py, so whichever merges second
needs a small conflict fix.

Limitations

• No config-flow UI yet for the Eufy credentials the camera needs —
  they're separate from the local Tuya connection the rest of the
  integration uses, and currently have to be added directly to the
  vacuum's config entry (documented in docs/MAP_CAMERA.md).
• Only verified against a T2276. The lay.bin format and storage-config
  API are expected to be the same across the X8-Pro class, but that's
  unverified on other models.

Also includes one small unrelated fix: tuyalocaldiscovery.py had two
mypy no-any-return errors on a clean checkout of main (the
cryptography library ships no stubs, so bytes.decode() on its
output was typed Any) — fixed by wrapping both returns in str().

🤖 Generated with Claude Code

[stevendejongnl]

Added the live cleaning route to the map camera, plus a rooms attribute.

• While the vacuum is cleaning or returning, the camera polls tuya.m.device.media.latest (v3.0) and draws the robot's route over the map.
• The camera now has a rooms attribute: id, pixel count and centre (relative to the dock) for each room.
• The route resets when a new clean starts. Tests are in tests/test_map_fetch.py.

[stevendejongnl]

Pushed an update:

• Rebased onto main (3cb72dc).
• Added a water level select for the T2276 (DPS 105: Low, Mid, High). On a live T2276 I set Low and then High from the select. The Eufy app showed Low after the first write, and the robot's own status showed High after the second.
• Fixed two mypy errors in the map image renderer. Current Pillow type hints mark Image.load() as optional and no longer list Image.NEAREST.
• Ran the CI commands locally: flake8 custom_components tests, mypy --config-file=pyproject.toml custom_components, the full test suite (825 passed) and markdownlint on docs/MAP_CAMERA.md. All passed.

I also updated the description to cover the live route, the room attributes and the water level select.

🤖 Generated with Claude Code