fix: show Private BLE friendly name instead of MAC on map/follow/devices

Private BLE devices (iPhones, Apple Watches) now display their resolved
name (e.g. "Adam's iPhone") via the private_ble_name field instead of
the raw rotating MAC address.  Applies to all label chains in overview
(2D map, 3D ISO, room chips, tooltips), follow view, and devices list.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: gbroeckling

CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to PadSpan HA are documented here.
 
 ---
 
+## 0.17.3 — Bug Fix (2026-03-24)
+
+### Fixed
+- **Private BLE devices show friendly name instead of MAC** — map, follow, and devices views now use the resolved `private_ble_name` (e.g., "Adam's iPhone") when no user label is set, instead of displaying the raw rotating MAC address. Affects overview (2D, 3D, room chips, ISO stack), follow view, and devices list.
+
+---
+
 ## 0.17.2 — Bug Fix (2026-03-24)
 
 ### Fixed

VERSION.txt

@@ -1 +1 @@
-padspanHA package version: 0.17.2
+padspanHA package version: 0.17.3

custom_components/padspan_ha/manifest.json

@@ -20,5 +20,5 @@
   "issue_tracker": "https://github.com/gbroeckling/padspanHA/issues",
   "requirements": [],
   "single_config_entry": true,
-  "version": "0.17.2"
+  "version": "0.17.3"
 }

custom_components/padspan_ha/www/padspan-ha/views/devices.js

@@ -49,7 +49,7 @@ export function render(ctx) {
         id: stableId,
         padspan_id: o.padspan_id || "",
         type: o.kind,
-        name: o.user_label || o.name || o.address || "Unknown",
+        name: o.user_label || o.private_ble_name || o.name || o.address || "Unknown",
         room: o.room || "",
         stateRaw: o.room || (o.age_s != null ? `seen ${Math.round(o.age_s)}s ago` : ""),
         missing: false,

custom_components/padspan_ha/www/padspan-ha/views/follow.js

@@ -124,7 +124,7 @@ function _buildSelector(ctx, el, helpBtn, allObjects, currentAddr, isBasic) {
     if (!id) continue;
     if (_isScanner(o)) continue;
     if (_quietMode && !o.user_label && !o.identified && !ctx.actions.followedHas(id)) continue;
-    const name = o.user_label || o.name || o.entity_id || id;
+    const name = o.user_label || o.private_ble_name || o.name || o.entity_id || id;
     const room = o.room ? ` · ${o.room}` : "";
     const rssiStr = o.rssi != null ? ` (${o.rssi} dBm)` : "";
     const kind = o.kind === "entity" ? "[Entity]" : (o.identified ? "[Tagged]" : "[Unidentified]");

custom_components/padspan_ha/www/padspan-ha/views/overview.js

@@ -885,7 +885,7 @@ export function render(ctx){
           continue;
         }
 
-        const lbl = (o.user_label || o.name || "").substring(0, 14);
+        const lbl = (o.user_label || o.private_ble_name || o.name || "").substring(0, 14);
         const _oKey = _esc(o.key || o.address || o.entity_id || "");
 
         if (isFollowed) {
@@ -1802,7 +1802,7 @@ export function render(ctx){
       // ── Helper: build tooltip string for any object ────────────────────────
       const _objTip = (o) => {
         const parts = [];
-        const n = o.user_label || o.name || o.address || o.entity_id || "Unknown";
+        const n = o.user_label || o.private_ble_name || o.name || o.address || o.entity_id || "Unknown";
         parts.push(n);
         if(o.kind) parts.push(`Kind: ${o.kind}`);
         if(o.address && o.address !== n) parts.push(`Addr: ${o.address}`);
@@ -1834,7 +1834,7 @@ export function render(ctx){
         const isGhost = o._ghost || o._stale;
         const ageS = typeof o.age_s === "number" ? o.age_s : 0;
         const isAway = isGhost && (o.rssi == null) && (ageS > _awayTimeoutS2);
-        const lbl = (o.user_label||o.name||"?").substring(0,14);
+        const lbl = (o.user_label||o.private_ble_name||o.name||"?").substring(0,14);
         let bx, by;
         let posConf = 0;  // confidence for dashed circle
 
@@ -1948,7 +1948,7 @@ export function render(ctx){
           const _awayThresh = ((ctx.state.settings && ctx.state.settings.away_timeout_m != null)
             ? Number(ctx.state.settings.away_timeout_m) : 5) * 60;
           const isAway = typeof obj.age_s === "number" && obj.age_s > _awayThresh;
-          const objLabel = obj.user_label || obj.name || "";
+          const objLabel = obj.user_label || obj.private_ble_name || obj.name || "";
 
           // Position: server k-NN first, then high-confidence fingerprint, then room centroid + stagger
           let px, py;
@@ -2224,7 +2224,7 @@ export function render(ctx){
         for(const o of (rr.objects||[]).slice(0,6)){
           const oKey = o.address || o.entity_id || "";
           const isF = ctx.actions.followedHas(oKey);
-          const lbl = (o.user_label || o.name || o.address || "?").substring(0,16);
+          const lbl = (o.user_label || o.private_ble_name || o.name || o.address || "?").substring(0,16);
           const oc = isF ? "#fbbf24" : (o.identified ? "#5eead488" : "#f59e0b88");
           const chip = el("span",{style:`font-size:10px;padding:1px 5px;border-radius:3px;background:${oc}22;color:${isF?"#fbbf24":"#94a3b8"};border:1px solid ${oc};white-space:nowrap${isF?";font-weight:700":""}`}, isF ? lbl + " \u25C9" : lbl);
           objChips.appendChild(chip);
@@ -2678,7 +2678,7 @@ export function render(ctx){
         const ox = x + BW - 16 - oi * 28, oy = y + 100;
         const oc = o.identified ? "#5eead4" : "#f59e0b";
         s += `<circle cx="${ox}" cy="${oy}" r="7" fill="${oc}" opacity="0.9"/>`;
-        const lbl = (o.user_label || o.name || "?").substring(0, 6);
+        const lbl = (o.user_label || o.private_ble_name || o.name || "?").substring(0, 6);
         s += `<text x="${ox}" y="${oy + 18}" text-anchor="middle" fill="${oc}" font-size="9">${_esc(lbl)}</text>`;
       });