Live robot vacuums, P1 (docs/VACUUM.md)

The base marker never moves — it is the dock. While the robot cleans, a
round pulsing puck (no badge plate) drives the plan over an affine
transform solved from vacuum-map coordinates: auto-calibration matches
the robot's room list against plan rooms by name, and a three-point
wizard covers integrations without room data. The trail rides the
integration's own path when offered (it predates the card being opened)
and a self-recorded thinned buffer otherwise, lingering ten minutes
after docking. Adapters read the Map Extractor / Tasshack / Valetudo
attribute dialects through one tolerant parser. Display only — no
commands, per the owner's decision.

vacuum.ts is pure logic under 8 new unit tests; the marker schema grew
an optional vacuum block (56 backend tests); smoke_vacuum drives 19
browser asserts including the wizard end to end.

src/types.ts

@@ -55,6 +55,15 @@ export interface Marker {
   tap_target?: string | null;
   /** Ask before toggle/run — accidental-tap guard (owner's spec). */
   tap_confirm?: boolean | null;
+  /** live robot vacuum (docs/VACUUM.md); absent on non-vacuum markers */
+  vacuum?: {
+    live?: boolean | null;
+    trail?: boolean | null;
+    room_highlight?: boolean | null;
+    source?: string | null;
+    calibration?: Record<string, number[]>;
+    segment_map?: Record<string, string>;
+  } | null;
   room_id?: string | null; // manual placement into a room WITHOUT an HA area (sub-area rooms)
   display?: 'badge' | 'ripple' | 'icon_ripple' | 'value' | null; // how the device is drawn
   ripple_color?: string | null;