@apocaliss92/nodedreame 1.11.5 → 1.11.6

package/dist/index.d.cts

@@ -1815,6 +1815,14 @@ declare enum MowerFault {
     PauseTimeoutReturning = 72,// INFO
     TopCoverOpen = 73
 }
+/** Severity class of a mower DEVICE_CODE (2:2 / {@link MowerFault}). */
+type MowerFaultSeverity = 'info' | 'warning' | 'error';
+/**
+ * Classify a mower device-code by severity, matching the INFO/WARNING/ERROR
+ * annotations on {@link MowerFault}. Most codes are status/INFO (e.g. 50
+ * TaskStart); only a subset are actionable. Unknown codes default to `info`.
+ */
+declare function mowerFaultSeverity(code: number | null): MowerFaultSeverity;
 
 /**
  * Cast-free mower decoders. Re-exports the shared numeric primitives, and adds
@@ -1891,6 +1899,28 @@ interface MowerHeartbeat {
  * main state there is no active mowing task (returns `taskSubState: null`).
  */
 declare function parseMowerHeartbeat(value: unknown): MowerHeartbeat | null;
+/** Decoded mowing-progress signal from the POSE_COVERAGE (1:4) `task` block. */
+interface MowerMowingProgress {
+    /** 0..100 — overall mowing completion. */
+    readonly progressPercent: number;
+    /** Already-finished area in m². */
+    readonly currentAreaSqm: number;
+    /** Total target area in m². */
+    readonly totalAreaSqm: number;
+}
+/**
+ * Locate the 10-byte `task` block inside a POSE_COVERAGE (1:4) frame and decode
+ * the mowing progress. Frame shapes (ported from antondaubert/dreame-mower
+ * `pose_coverage.py`):
+ *   - sentinel-framed `[CE] pose(6) trace(15) task(10) [CE]` (33B) / `…task(10) trace2(11) [CE]` (44B)
+ *     → task at offset 22;
+ *   - alt `task(10) [CE] [+trace]` (no leading sentinel, ≥11B) → task at offset 0.
+ * The 22B `[CE] pose trace` and 13B `[CE] pose extra` shapes carry NO task → null.
+ *
+ * `task` layout: `[2:4] percent u16LE (value×100) [4:7] total u24LE (centi-m²)
+ * [7:10] finished u24LE (centi-m²)`.
+ */
+declare function parseMowingProgress(value: unknown): MowerMowingProgress | null;
 
 /**
  * Per-model mower capability records + a resolver adapting the rich record into
@@ -2110,6 +2140,17 @@ declare class MowerDevice extends BaseDevice {
      * This is the P4 progress surface; the byte-accurate pose-track % is P5.
      */
     get coverageTargetPct(): number | null;
+    /**
+     * Live mowing PROGRESS decoded from the POSE_COVERAGE (1:4) task block —
+     * `{progressPercent, currentAreaSqm, totalAreaSqm}` — or null when 1:4 carries
+     * no task block (idle / pose-only frame). This is the byte-accurate progress
+     * the Dreamehome app shows (vs {@link coverageTargetPct}, the task TARGET).
+     */
+    get mowingProgress(): MowerMowingProgress | null;
+    /** Mowing completion percent (0..100) from {@link mowingProgress}, or null. */
+    get mowingProgressPct(): number | null;
+    /** Severity of the current DEVICE_CODE (2:2) — info / warning / error. */
+    get faultSeverity(): MowerFaultSeverity;
     /** Parsed per-zone control status (2:56), or null. */
     get controlStatus(): MowerControlState | null;
     get controlAction(): MowerControlAction | null;
@@ -2187,6 +2228,9 @@ declare class MowerDevice extends BaseDevice {
     static readonly DEFAULT_PROPS: readonly [{
         readonly siid: 1;
         readonly piid: 1;
+    }, {
+        readonly siid: 1;
+        readonly piid: 4;
     }, {
         readonly siid: 2;
         readonly piid: 1;
@@ -2546,4 +2590,4 @@ declare function createDumper(target: DumperDevice, options?: DumperOptions): Du
  */
 declare function createClientDumper(client: Nodreame, options?: DumperOptions): Dumper[];
 
-export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, AUTO_SWITCH_JSON_KEY, type AiDetectionRaw, type AutoSwitchKey, type AutoSwitchRaw, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DefaultCapabilityResolver, type DeviceCapabilities, type DeviceDump, type DeviceEvent, type DreameAiFeature, DreameApiError, DreameAuthError, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, type DumperOptions, LIBRARY_NAME, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, MOWER_TASK_SUBSTATES, type MapBoundingBox, type MapCleanedAreaOverlay, type MapColorScheme, type MapDimensions, type MapFrameType, type MapLayer, type MapLayerType, type MapLowLyingArea, type MapObstacle, type MapPath, type MapPathType, type MapPoint, type MapPose, type MapRestrictedArea, type MapRoom, type MapRoomWall, type MapRun, type MapSegment, type MapStorey, type MapVirtualWall, type MapWallsInfo, type MiotAction, MiotError, type MiotProp, MiotState, type MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerConsumableKey, type MowerConsumableReading, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerHeartbeat, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerTaskSubState, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OssFetchInput, type OssFetcherLike, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type StateChangedEvent, SuctionLevel, TaskStatus, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, WaterVolume, consumableSpec, createClientDumper, createDumper, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, encodeAiFeatureWrite, encodeAutoSwitchWrite, extractMowerConsumableValues, getMowerCapabilities, getVacuumCapabilities, isDreameConsumableKey, mowerConsumableIndex, parseMowerConsumables, parseMowerHeartbeat, renderMowerSvg, renderVacuumPng, resolveCapabilities, supportedAutoSwitchKeys };
+export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, AUTO_SWITCH_JSON_KEY, type AiDetectionRaw, type AutoSwitchKey, type AutoSwitchRaw, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DefaultCapabilityResolver, type DeviceCapabilities, type DeviceDump, type DeviceEvent, type DreameAiFeature, DreameApiError, DreameAuthError, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, type DumperOptions, LIBRARY_NAME, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, MOWER_TASK_SUBSTATES, type MapBoundingBox, type MapCleanedAreaOverlay, type MapColorScheme, type MapDimensions, type MapFrameType, type MapLayer, type MapLayerType, type MapLowLyingArea, type MapObstacle, type MapPath, type MapPathType, type MapPoint, type MapPose, type MapRestrictedArea, type MapRoom, type MapRoomWall, type MapRun, type MapSegment, type MapStorey, type MapVirtualWall, type MapWallsInfo, type MiotAction, MiotError, type MiotProp, MiotState, type MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerConsumableKey, type MowerConsumableReading, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerFaultSeverity, type MowerHeartbeat, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerMowingProgress, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerTaskSubState, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OssFetchInput, type OssFetcherLike, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type StateChangedEvent, SuctionLevel, TaskStatus, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, WaterVolume, consumableSpec, createClientDumper, createDumper, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, encodeAiFeatureWrite, encodeAutoSwitchWrite, extractMowerConsumableValues, getMowerCapabilities, getVacuumCapabilities, isDreameConsumableKey, mowerConsumableIndex, mowerFaultSeverity, parseMowerConsumables, parseMowerHeartbeat, parseMowingProgress, renderMowerSvg, renderVacuumPng, resolveCapabilities, supportedAutoSwitchKeys };

package/dist/index.d.ts

@@ -1815,6 +1815,14 @@ declare enum MowerFault {
     PauseTimeoutReturning = 72,// INFO
     TopCoverOpen = 73
 }
+/** Severity class of a mower DEVICE_CODE (2:2 / {@link MowerFault}). */
+type MowerFaultSeverity = 'info' | 'warning' | 'error';
+/**
+ * Classify a mower device-code by severity, matching the INFO/WARNING/ERROR
+ * annotations on {@link MowerFault}. Most codes are status/INFO (e.g. 50
+ * TaskStart); only a subset are actionable. Unknown codes default to `info`.
+ */
+declare function mowerFaultSeverity(code: number | null): MowerFaultSeverity;
 
 /**
  * Cast-free mower decoders. Re-exports the shared numeric primitives, and adds
@@ -1891,6 +1899,28 @@ interface MowerHeartbeat {
  * main state there is no active mowing task (returns `taskSubState: null`).
  */
 declare function parseMowerHeartbeat(value: unknown): MowerHeartbeat | null;
+/** Decoded mowing-progress signal from the POSE_COVERAGE (1:4) `task` block. */
+interface MowerMowingProgress {
+    /** 0..100 — overall mowing completion. */
+    readonly progressPercent: number;
+    /** Already-finished area in m². */
+    readonly currentAreaSqm: number;
+    /** Total target area in m². */
+    readonly totalAreaSqm: number;
+}
+/**
+ * Locate the 10-byte `task` block inside a POSE_COVERAGE (1:4) frame and decode
+ * the mowing progress. Frame shapes (ported from antondaubert/dreame-mower
+ * `pose_coverage.py`):
+ *   - sentinel-framed `[CE] pose(6) trace(15) task(10) [CE]` (33B) / `…task(10) trace2(11) [CE]` (44B)
+ *     → task at offset 22;
+ *   - alt `task(10) [CE] [+trace]` (no leading sentinel, ≥11B) → task at offset 0.
+ * The 22B `[CE] pose trace` and 13B `[CE] pose extra` shapes carry NO task → null.
+ *
+ * `task` layout: `[2:4] percent u16LE (value×100) [4:7] total u24LE (centi-m²)
+ * [7:10] finished u24LE (centi-m²)`.
+ */
+declare function parseMowingProgress(value: unknown): MowerMowingProgress | null;
 
 /**
  * Per-model mower capability records + a resolver adapting the rich record into
@@ -2110,6 +2140,17 @@ declare class MowerDevice extends BaseDevice {
      * This is the P4 progress surface; the byte-accurate pose-track % is P5.
      */
     get coverageTargetPct(): number | null;
+    /**
+     * Live mowing PROGRESS decoded from the POSE_COVERAGE (1:4) task block —
+     * `{progressPercent, currentAreaSqm, totalAreaSqm}` — or null when 1:4 carries
+     * no task block (idle / pose-only frame). This is the byte-accurate progress
+     * the Dreamehome app shows (vs {@link coverageTargetPct}, the task TARGET).
+     */
+    get mowingProgress(): MowerMowingProgress | null;
+    /** Mowing completion percent (0..100) from {@link mowingProgress}, or null. */
+    get mowingProgressPct(): number | null;
+    /** Severity of the current DEVICE_CODE (2:2) — info / warning / error. */
+    get faultSeverity(): MowerFaultSeverity;
     /** Parsed per-zone control status (2:56), or null. */
     get controlStatus(): MowerControlState | null;
     get controlAction(): MowerControlAction | null;
@@ -2187,6 +2228,9 @@ declare class MowerDevice extends BaseDevice {
     static readonly DEFAULT_PROPS: readonly [{
         readonly siid: 1;
         readonly piid: 1;
+    }, {
+        readonly siid: 1;
+        readonly piid: 4;
     }, {
         readonly siid: 2;
         readonly piid: 1;
@@ -2546,4 +2590,4 @@ declare function createDumper(target: DumperDevice, options?: DumperOptions): Du
  */
 declare function createClientDumper(client: Nodreame, options?: DumperOptions): Dumper[];
 
-export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, AUTO_SWITCH_JSON_KEY, type AiDetectionRaw, type AutoSwitchKey, type AutoSwitchRaw, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DefaultCapabilityResolver, type DeviceCapabilities, type DeviceDump, type DeviceEvent, type DreameAiFeature, DreameApiError, DreameAuthError, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, type DumperOptions, LIBRARY_NAME, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, MOWER_TASK_SUBSTATES, type MapBoundingBox, type MapCleanedAreaOverlay, type MapColorScheme, type MapDimensions, type MapFrameType, type MapLayer, type MapLayerType, type MapLowLyingArea, type MapObstacle, type MapPath, type MapPathType, type MapPoint, type MapPose, type MapRestrictedArea, type MapRoom, type MapRoomWall, type MapRun, type MapSegment, type MapStorey, type MapVirtualWall, type MapWallsInfo, type MiotAction, MiotError, type MiotProp, MiotState, type MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerConsumableKey, type MowerConsumableReading, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerHeartbeat, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerTaskSubState, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OssFetchInput, type OssFetcherLike, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type StateChangedEvent, SuctionLevel, TaskStatus, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, WaterVolume, consumableSpec, createClientDumper, createDumper, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, encodeAiFeatureWrite, encodeAutoSwitchWrite, extractMowerConsumableValues, getMowerCapabilities, getVacuumCapabilities, isDreameConsumableKey, mowerConsumableIndex, parseMowerConsumables, parseMowerHeartbeat, renderMowerSvg, renderVacuumPng, resolveCapabilities, supportedAutoSwitchKeys };
+export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, AUTO_SWITCH_JSON_KEY, type AiDetectionRaw, type AutoSwitchKey, type AutoSwitchRaw, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DefaultCapabilityResolver, type DeviceCapabilities, type DeviceDump, type DeviceEvent, type DreameAiFeature, DreameApiError, DreameAuthError, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, type DumperOptions, LIBRARY_NAME, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, MOWER_TASK_SUBSTATES, type MapBoundingBox, type MapCleanedAreaOverlay, type MapColorScheme, type MapDimensions, type MapFrameType, type MapLayer, type MapLayerType, type MapLowLyingArea, type MapObstacle, type MapPath, type MapPathType, type MapPoint, type MapPose, type MapRestrictedArea, type MapRoom, type MapRoomWall, type MapRun, type MapSegment, type MapStorey, type MapVirtualWall, type MapWallsInfo, type MiotAction, MiotError, type MiotProp, MiotState, type MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerConsumableKey, type MowerConsumableReading, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerFaultSeverity, type MowerHeartbeat, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerMowingProgress, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerTaskSubState, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OssFetchInput, type OssFetcherLike, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type StateChangedEvent, SuctionLevel, TaskStatus, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, WaterVolume, consumableSpec, createClientDumper, createDumper, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, encodeAiFeatureWrite, encodeAutoSwitchWrite, extractMowerConsumableValues, getMowerCapabilities, getVacuumCapabilities, isDreameConsumableKey, mowerConsumableIndex, mowerFaultSeverity, parseMowerConsumables, parseMowerHeartbeat, parseMowingProgress, renderMowerSvg, renderVacuumPng, resolveCapabilities, supportedAutoSwitchKeys };

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/support/version.ts
 var LIBRARY_NAME = "nodedreame";
-var LIBRARY_VERSION = "1.11.5";
+var LIBRARY_VERSION = "1.11.6";
 
 // src/transport/errors.ts
 var DreameError = class extends Error {
@@ -2771,18 +2771,27 @@ function decodeVacuumMap(input, opts = {}) {
   const pixelGrid = inflated.subarray(pixelStart, pixelEnd);
   const canDecodePixels = header.frameType === "I" && pixelGrid.length === header.width * header.height;
   const layers = canDecodePixels ? decodePixelGridFsm1(pixelGrid, header.width, header.height) : [];
-  const segments = canDecodePixels ? collectSegments(layers, dimensions, tail) : [];
   const paths = parsePathTr(tail.tr ?? "");
   const obstacles = parseObstacles(tail.ai_obstacle ?? []);
   let geometry = parseTailGeometry(tail);
-  if (!isGeometryComplete(geometry) && typeof tail.rism === "string" && tail.rism.length > 0) {
+  let segTail = tail;
+  const outerHasNames = Object.values(tail.seg_inf ?? {}).some(
+    (m) => typeof m?.name === "string" && m.name.length > 0
+  );
+  if ((!isGeometryComplete(geometry) || !outerHasNames) && typeof tail.rism === "string" && tail.rism.length > 0) {
     try {
       const innerInflated = unwrapEnvelope(tail.rism);
       const { tail: innerTail } = parseFrame(innerInflated);
-      geometry = coalesceGeometry(geometry, parseTailGeometry(innerTail));
+      if (!isGeometryComplete(geometry)) {
+        geometry = coalesceGeometry(geometry, parseTailGeometry(innerTail));
+      }
+      if (!outerHasNames && innerTail.seg_inf) {
+        segTail = mergeSegInfNames(tail, innerTail.seg_inf);
+      }
     } catch {
     }
   }
+  const segments = canDecodePixels ? collectSegments(layers, dimensions, segTail) : [];
   const cleanedArea = typeof tail.decmap === "string" ? parseCleanedAreaOverlay(tail.decmap) : null;
   return {
     mapId: header.mapId,
@@ -2806,6 +2815,18 @@ function applyVacuumPFrame(prev, pframe, opts = {}) {
   const merged = typeof prev === "string" || typeof pframe === "string" ? mergePFrameEnvelope(prev, pframe, opts.prev, opts.pframe) : mergePFrame(prev, pframe);
   return { buffer: merged, data: decodeVacuumMap(merged) };
 }
+function mergeSegInfNames(tail, innerSegInf) {
+  const outer = tail.seg_inf ?? {};
+  const ids = /* @__PURE__ */ new Set([...Object.keys(outer), ...Object.keys(innerSegInf)]);
+  const merged = {};
+  for (const id of ids) {
+    const o = outer[id] ?? {};
+    const inner = innerSegInf[id] ?? {};
+    const name = typeof o.name === "string" && o.name.length > 0 ? o.name : inner.name;
+    merged[id] = { ...inner, ...o, ...name !== void 0 ? { name } : {} };
+  }
+  return { ...tail, seg_inf: merged };
+}
 function mergeDimensions(header, tail) {
   const left = tail.origin?.[0] ?? header.left;
   const top = tail.origin?.[1] ?? header.top;
@@ -2966,8 +2987,12 @@ function renderVacuumPng(map, opts = {}) {
     const byType = opts.colorObstaclesByType !== false;
     for (const ob of map.obstacles) {
       const p = worldToPx(ob.x, ob.y, dim, scale);
-      const color = byType ? obstacleColor(ob.type) : pal.obstacle;
-      drawDiamond(png, p.x, p.y, Math.max(2, scale * 2), color);
+      const r = Math.max(2, scale * 2);
+      if (byType) {
+        drawObstacleShape(png, p.x, p.y, r, ob.type, obstacleColor(ob.type));
+      } else {
+        drawDiamond(png, p.x, p.y, r, pal.obstacle);
+      }
     }
   }
   if (opts.showCharger !== false && map.dock !== null) {
@@ -3128,6 +3153,32 @@ function obstacleColor(type) {
   const hue = Math.abs(Math.trunc(type)) * 47 % 360;
   return hsvToRgba(hue, 0.85, 0.95);
 }
+function drawSquare(png, cx, cy, r, color) {
+  fillRect(png, cx - r, cy - r, cx + r, cy + r, color);
+}
+function drawTriangle(png, cx, cy, r, color) {
+  for (let dy = -r; dy <= r; dy += 1) {
+    const w = Math.round((dy + r) / (2 * r) * r);
+    for (let dx = -w; dx <= w; dx += 1) {
+      setPixel(png, cx + dx, cy + dy, color);
+    }
+  }
+}
+function drawObstacleShape(png, cx, cy, r, type, color) {
+  switch (Math.abs(Math.trunc(type)) % 4) {
+    case 0:
+      drawDiamond(png, cx, cy, r, color);
+      return;
+    case 1:
+      drawSquare(png, cx, cy, r, color);
+      return;
+    case 2:
+      drawTriangle(png, cx, cy, r, color);
+      return;
+    default:
+      drawDisk(png, cx, cy, r, color);
+  }
+}
 var FURNITURE_LINE = [150, 110, 200, 235];
 function paintFurnitureZone(png, points, dim, scale) {
   if (points.length < 2) return;
@@ -4112,6 +4163,12 @@ var MowerFault = /* @__PURE__ */ ((MowerFault2) => {
   MowerFault2[MowerFault2["TopCoverOpen"] = 73] = "TopCoverOpen";
   return MowerFault2;
 })(MowerFault || {});
+function mowerFaultSeverity(code) {
+  if (code === null) return "info";
+  if (code >= 1 && code <= 30 || code === 37 || code === 73) return "error";
+  if (code >= 31 && code <= 36 || code >= 38 && code <= 45) return "warning";
+  return "info";
+}
 
 // src/models/mower/decode.ts
 function isRecord2(v) {
@@ -4322,6 +4379,37 @@ function parseMowerHeartbeat(value) {
   const taskSubState = mainState === HEARTBEAT_MAIN_STATE_MOWING ? MOWER_TASK_SUBSTATES[subStateRaw - HEARTBEAT_SUBSTATE_BASE] ?? null : null;
   return { rawBattery, mainState, subStateRaw, taskSubState };
 }
+var POSE_SENTINEL = 206;
+function poseBytes(value) {
+  if (!Array.isArray(value)) return null;
+  const bytes = [];
+  for (const b of value) {
+    if (typeof b !== "number") return null;
+    bytes.push(b);
+  }
+  return bytes;
+}
+function parseMowingProgress(value) {
+  const bytes = poseBytes(value);
+  if (bytes === null || bytes.length < 11) return null;
+  const last = bytes[bytes.length - 1];
+  const head = bytes[0];
+  let offset = null;
+  if (head !== POSE_SENTINEL && last === POSE_SENTINEL) {
+    offset = 0;
+  } else if (head === POSE_SENTINEL && last === POSE_SENTINEL && bytes.length >= 33) {
+    offset = 22;
+  }
+  if (offset === null || offset + 10 > bytes.length) return null;
+  const rawPercent = (bytes[offset + 2] ?? 0) | (bytes[offset + 3] ?? 0) << 8;
+  const total = (bytes[offset + 4] ?? 0) | (bytes[offset + 5] ?? 0) << 8 | (bytes[offset + 6] ?? 0) << 16;
+  const finish = (bytes[offset + 7] ?? 0) | (bytes[offset + 8] ?? 0) << 8 | (bytes[offset + 9] ?? 0) << 16;
+  return {
+    progressPercent: rawPercent ? Math.min(100, rawPercent / 100) : 0,
+    currentAreaSqm: finish / 100,
+    totalAreaSqm: total / 100
+  };
+}
 
 // src/models/mower/capabilities.ts
 var FALLBACK2 = {
@@ -5021,6 +5109,25 @@ var MowerDevice = class _MowerDevice extends BaseDevice {
   get coverageTargetPct() {
     return this.task?.coverageTarget ?? null;
   }
+  /**
+   * Live mowing PROGRESS decoded from the POSE_COVERAGE (1:4) task block —
+   * `{progressPercent, currentAreaSqm, totalAreaSqm}` — or null when 1:4 carries
+   * no task block (idle / pose-only frame). This is the byte-accurate progress
+   * the Dreamehome app shows (vs {@link coverageTargetPct}, the task TARGET).
+   */
+  get mowingProgress() {
+    return parseMowingProgress(
+      this.getProperty(MOWER_PROP.POSE_COVERAGE.siid, MOWER_PROP.POSE_COVERAGE.piid)?.value
+    );
+  }
+  /** Mowing completion percent (0..100) from {@link mowingProgress}, or null. */
+  get mowingProgressPct() {
+    return this.mowingProgress?.progressPercent ?? null;
+  }
+  /** Severity of the current DEVICE_CODE (2:2) — info / warning / error. */
+  get faultSeverity() {
+    return mowerFaultSeverity(this.faultRaw);
+  }
   /** Parsed per-zone control status (2:56), or null. */
   get controlStatus() {
     return parseControlStatus(
@@ -5200,6 +5307,7 @@ var MowerDevice = class _MowerDevice extends BaseDevice {
   /** Props worth seeding on start() / polling — exported for the facade. */
   static DEFAULT_PROPS = [
     MOWER_PROP.HEARTBEAT,
+    MOWER_PROP.POSE_COVERAGE,
     MOWER_PROP.STATUS,
     MOWER_PROP.DEVICE_CODE,
     MOWER_PROP.BATTERY,
@@ -5858,8 +5966,10 @@ export {
   getVacuumCapabilities,
   isDreameConsumableKey,
   mowerConsumableIndex,
+  mowerFaultSeverity,
   parseMowerConsumables,
   parseMowerHeartbeat,
+  parseMowingProgress,
   renderMowerSvg,
   renderVacuumPng,
   resolveCapabilities,