@camstack/system 1.2.242 → 1.2.243

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BETx_5mH.js");
+const require_dist = require("../../dist-D6kqBW1G.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_crypto = require("node:crypto");
 let node_path = require("node:path");

package/dist/builtins/addon-pages-aggregator/addon-pages-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { Jt as BaseAddon, bn as EventCategory, k as addonPagesCapability, qt as errMsg } from "../../dist-DkGEz_3L.mjs";
+import { A as addonPagesCapability, Sn as EventCategory, Xt as BaseAddon, Yt as errMsg } from "../../dist-B4htkDVv.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import * as path$1 from "node:path";

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BETx_5mH.js");
+const require_dist = require("../../dist-D6kqBW1G.js");
 const require_settle_sources = require("../../settle-sources-Bhsy57y-.js");
 let node_crypto = require("node:crypto");
 let node_path = require("node:path");

package/dist/builtins/addon-widgets-aggregator/addon-widgets-aggregator.addon.mjs

@@ -1,4 +1,4 @@
-import { Jt as BaseAddon, bn as EventCategory, j as addonWidgetsCapability, qt as errMsg } from "../../dist-DkGEz_3L.mjs";
+import { M as addonWidgetsCapability, Sn as EventCategory, Xt as BaseAddon, Yt as errMsg } from "../../dist-B4htkDVv.mjs";
 import { t as settleSourcesWithTimeout } from "../../settle-sources-CDtNC8ub.mjs";
 import { createHash, randomUUID } from "node:crypto";
 import * as path$1 from "node:path";

package/dist/builtins/alerts/alerts.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BETx_5mH.js");
+const require_dist = require("../../dist-D6kqBW1G.js");
 //#region src/builtins/alerts/prune-policy.ts
 /**
 * Ids older than `cutoffMs`, oldest first.

package/dist/builtins/alerts/alerts.addon.mjs

@@ -1,4 +1,4 @@
-import { Jt as BaseAddon, M as alertsCapability, bn as EventCategory, n as AlertSchema, qt as errMsg, sn as createEvent } from "../../dist-DkGEz_3L.mjs";
+import { N as alertsCapability, Sn as EventCategory, Xt as BaseAddon, Yt as errMsg, ln as createEvent, n as AlertSchema } from "../../dist-B4htkDVv.mjs";
 //#region src/builtins/alerts/prune-policy.ts
 /**
 * Ids older than `cutoffMs`, oldest first.

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BETx_5mH.js");
+const require_dist = require("../../dist-D6kqBW1G.js");
 let node_crypto = require("node:crypto");
 let buffer = require("buffer");
 let node_fs_promises = require("node:fs/promises");

package/dist/builtins/backup-orchestrator/backup-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { Bt as storageOccupancyCapability, Jt as BaseAddon, P as backupCapability, bn as EventCategory, yt as mayWriteToLocation } from "../../dist-DkGEz_3L.mjs";
+import { F as backupCapability, Ht as storageOccupancyCapability, Sn as EventCategory, Xt as BaseAddon, xt as mayWriteToLocation } from "../../dist-B4htkDVv.mjs";
 import { randomBytes, randomUUID } from "node:crypto";
 import { Buffer as Buffer$1 } from "buffer";
 import * as fsp from "node:fs/promises";

package/dist/builtins/console-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BETx_5mH.js");
+const require_dist = require("../../dist-D6kqBW1G.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/console-logging/index.mjs

@@ -1,4 +1,4 @@
-import { Jt as BaseAddon, ht as logDestinationCapability } from "../../dist-DkGEz_3L.mjs";
+import { Xt as BaseAddon, _t as logDestinationCapability } from "../../dist-B4htkDVv.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/core-blocks/core-blocks.addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BETx_5mH.js");
+const require_dist = require("../../dist-D6kqBW1G.js");
 let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 node_fs_promises = require_chunk.__toESM(node_fs_promises);

package/dist/builtins/core-blocks/core-blocks.addon.mjs

@@ -1,4 +1,4 @@
-import { B as coreBlockIdFromAddonId, Jt as BaseAddon, V as coreBlocksCapability, c as CORE_BLOCK_ADDON_PREFIX, d as DeclaredDevices, l as CoreBlockSchema, qt as errMsg, s as CORE_BLOCKS_ADDON_ID, z as coreBlockAddonId } from "../../dist-DkGEz_3L.mjs";
+import { B as coreBlockAddonId, H as coreBlocksCapability, V as coreBlockIdFromAddonId, Xt as BaseAddon, Yt as errMsg, c as CORE_BLOCK_ADDON_PREFIX, d as DeclaredDevices, l as CoreBlockSchema, s as CORE_BLOCKS_ADDON_ID } from "../../dist-B4htkDVv.mjs";
 import { randomUUID } from "node:crypto";
 import * as fs from "node:fs/promises";
 import * as path$1 from "node:path";

package/dist/builtins/device-manager/device-manager.addon.js

@@ -3,8 +3,8 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BETx_5mH.js");
-const require_retired_settings_keys = require("../../retired-settings-keys-BnTBoLTv.js");
+const require_dist = require("../../dist-D6kqBW1G.js");
+const require_retired_settings_keys = require("../../retired-settings-keys-BPIyHR4_.js");
 let node_crypto = require("node:crypto");
 let _camstack_types_node = require("@camstack/types/node");
 //#region src/builtins/device-manager/adoption-job-engine.ts
@@ -3928,7 +3928,8 @@ async function runLocationBackfillAtBoot(pctx, bootRows) {
 * setLocation, setType, setIntegrationId, setLinkDeviceId,
 * setPrimaryChildEntityId, setChildLayout, setRole, setDisplay,
 * applyInitialMeta, setMetadata, setDisabled), and the location registry
-* (listLocations, addLocation, removeLocation).
+* (listLocations, addLocation, removeLocation, renameLocation) with its icon
+* map (listLocationIcons, setLocationIcon).
 *
 * EXACT ordering and side effects preserved — notably registerDevice's
 * name-precedence reconcile + field-preservation spreads, the
@@ -4980,6 +4981,83 @@ async function addLocation(pctx, input) {
 	});
 }
 /**
+* Every location that carries an icon, as `(locationKey, icon)` pairs.
+*
+* ADDITIVE beside `listLocations`, which still answers `string[]` — the
+* autocomplete, the HA adoption import and the recorder all read a list of
+* LABELS and a shape change there would break every one of them. A surface
+* that wants icons asks for them and joins on `locationIconKey`.
+*
+* Returns only what was actually stored. A location with no assignment is
+* ABSENT, never `map-pin`: the fallback belongs to the renderer
+* (`resolveLocationIcon`), and folding it in here would make "the operator
+* picked the pin" indistinguishable from "the operator picked nothing" —
+* which is the difference an icon picker has to draw.
+*/
+async function listLocationIcons(pctx) {
+	const icons = (await pctx.metaStore.readStore()).locationIcons ?? {};
+	return Object.entries(icons).map(([locationKey, icon]) => ({
+		locationKey,
+		icon
+	})).toSorted((a, b) => a.locationKey.localeCompare(b.locationKey));
+}
+/**
+* Set (or clear) the icon of a location label.
+*
+* Keyed on `locationIconKey` — trimmed + lower-cased, the equality the
+* registry matches on everywhere — so a case-only rename keeps the icon and
+* two spellings of one room can never carry two different icons.
+*
+* The label need NOT be registered: `setLocation` accepts a free-form string
+* and `listLocations` folds in whatever devices carry, so requiring
+* registration here would leave exactly the ad-hoc rooms unable to have an
+* icon. An empty label throws — there is no room to name.
+*
+* Same read-modify-write and same lock as `addLocation`: the map is one key of
+* the addon store, and `writeAddonStore` re-inserts the whole key range, so an
+* unordered write carries a stale copy of every other key.
+*/
+async function setLocationIcon(pctx, input) {
+	const trimmed = input.location.trim();
+	if (trimmed.length === 0) throw new Error("[device-manager] setLocationIcon: location must be non-empty");
+	const key = require_dist.locationIconKey(trimmed);
+	await pctx.bindingsDeps.withAddonStoreWriteLock(async () => {
+		const icons = (await pctx.metaStore.readStore()).locationIcons ?? {};
+		if (input.icon === null) {
+			if (!(key in icons)) return;
+			const { [key]: _cleared, ...kept } = icons;
+			await pctx.settings.writeAddonStore({ locationIcons: kept });
+			return;
+		}
+		if (icons[key] === input.icon) return;
+		await pctx.settings.writeAddonStore({ locationIcons: {
+			...icons,
+			[key]: input.icon
+		} });
+	});
+}
+/**
+* Move a location's icon from one key to another, for `renameLocation`.
+*
+* Returns `null` when NOTHING changes, so the caller can leave the key out of
+* its `writeAddonStore` patch instead of re-writing an identical map.
+*
+* A rename onto a room that already has an icon is a MERGE, and the surviving
+* room keeps its own: the operator renaming "Sala" into "Salone" is moving
+* devices into Salone, not restyling it. The source key is dropped either way.
+* Pure — builds a new record, mutates nothing.
+*/
+function renameLocationIcon(icons, fromKey, toKey) {
+	const moved = icons[fromKey];
+	if (moved === void 0) return null;
+	if (fromKey === toKey) return null;
+	const { [fromKey]: _dropped, ...rest } = icons;
+	return toKey in rest ? rest : {
+		...rest,
+		[toKey]: moved
+	};
+}
+/**
 * Remove a label from the curated registry. Match is
 * case-insensitive. Devices that still reference this label keep
 * their `meta.location` value (the registry is a suggestion
@@ -5010,13 +5088,19 @@ async function renameLocation(pctx, input) {
 	const fromKey = from.toLowerCase();
 	const toKey = to.toLowerCase();
 	await pctx.bindingsDeps.withAddonStoreWriteLock(async () => {
-		const current = (await pctx.metaStore.readStore()).locations ?? [];
-		if (!current.some((l) => l.trim().toLowerCase() === fromKey)) return;
+		const store = await pctx.metaStore.readStore();
+		const current = store.locations ?? [];
+		const registered = current.some((l) => l.trim().toLowerCase() === fromKey);
+		const movedIcons = renameLocationIcon(store.locationIcons ?? {}, fromKey, toKey);
+		if (!registered && movedIcons === null) return;
 		const kept = current.filter((l) => {
 			const key = l.trim().toLowerCase();
 			return key !== fromKey && key !== toKey;
 		});
-		await pctx.settings.writeAddonStore({ locations: [...kept, to] });
+		await pctx.settings.writeAddonStore({
+			...registered ? { locations: [...kept, to] } : {},
+			...movedIcons !== null ? { locationIcons: movedIcons } : {}
+		});
 	});
 	const moved = await pctx.metaStore.withMetaWriteLock(async () => {
 		const out = [];
@@ -5054,10 +5138,19 @@ async function removeLocation(pctx, input) {
 	const trimmed = input.name.trim();
 	if (trimmed.length === 0) return;
 	await pctx.bindingsDeps.withAddonStoreWriteLock(async () => {
-		const current = (await pctx.metaStore.readStore()).locations ?? [];
-		const remaining = current.filter((l) => l.toLowerCase() !== trimmed.toLowerCase());
-		if (remaining.length === current.length) return;
-		await pctx.settings.writeAddonStore({ locations: remaining });
+		const store = await pctx.metaStore.readStore();
+		const current = store.locations ?? [];
+		const key = require_dist.locationIconKey(trimmed);
+		const remaining = current.filter((l) => l.toLowerCase() !== key);
+		const droppedLabel = remaining.length !== current.length;
+		const icons = store.locationIcons ?? {};
+		const droppedIcon = key in icons;
+		if (!droppedLabel && !droppedIcon) return;
+		const { [key]: _removedIcon, ...keptIcons } = icons;
+		await pctx.settings.writeAddonStore({
+			...droppedLabel ? { locations: remaining } : {},
+			...droppedIcon ? { locationIcons: keptIcons } : {}
+		});
 	});
 	if (input.cascade !== true) return;
 	const cleared = await pctx.metaStore.withMetaWriteLock(async () => {
@@ -5159,12 +5252,35 @@ function decodeAddonStore(raw) {
 	const nextDeviceId = raw["nextDeviceId"];
 	const locations = raw["locations"];
 	const roleDisplayDefaults = raw["roleDisplayDefaults"];
+	const locationIcons = decodeLocationIcons(raw["locationIcons"]);
 	return {
 		...typeof nextDeviceId === "number" && Number.isFinite(nextDeviceId) ? { nextDeviceId } : {},
 		...Array.isArray(locations) ? { locations: locations.filter((l) => typeof l === "string") } : {},
-		...isRoleDisplayDefaults(roleDisplayDefaults) ? { roleDisplayDefaults } : {}
+		...isRoleDisplayDefaults(roleDisplayDefaults) ? { roleDisplayDefaults } : {},
+		...locationIcons !== null ? { locationIcons } : {}
 	};
 }
+/**
+* Decode the `locationIcons` map, dropping every entry whose value is not a
+* member of the closed vocabulary.
+*
+* Dropping, not passing through: the icon's whole point is that both surfaces
+* can draw it, and an id from a hand-edit or a newer hub is exactly the value
+* that draws nothing. Absent reads as "no icon chosen", which every renderer
+* already degrades to the fallback pin. Returns `null` when the key itself is
+* absent or of the wrong shape, so the field stays OMITTED rather than being
+* written back as an empty object.
+*/
+function decodeLocationIcons(raw) {
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return null;
+	const out = {};
+	for (const [key, value] of Object.entries(raw)) {
+		const parsed = require_dist.LocationIconIdSchema.safeParse(value);
+		if (!parsed.success) continue;
+		out[key] = parsed.data;
+	}
+	return out;
+}
 function isRoleDisplayDefaults(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -6997,6 +7113,8 @@ var DeviceManagerAddon = class extends require_dist.BaseAddon {
 			addLocation: (input) => addLocation(pctx, input),
 			removeLocation: (input) => removeLocation(pctx, input),
 			renameLocation: (input) => renameLocation(pctx, input),
+			listLocationIcons: () => listLocationIcons(pctx),
+			setLocationIcon: (input) => setLocationIcon(pctx, input),
 			listPersistedByAddon: (input) => listPersistedByAddon(pctx, input),
 			listAll: (input) => listAll(pctx, input),
 			getDevice: (input) => getDevice(pctx, input),

package/dist/builtins/device-manager/device-manager.addon.mjs

@@ -1,5 +1,5 @@
-import { $t as DeviceRole, G as deviceManagerCapability, Jt as BaseAddon, K as deviceStateCapability, L as buildStreamParamsConfigSchema, Mt as runtimeStatePolicyFor, Qt as DeviceFeature, S as STREAM_PROFILE_META, St as normalizeUnit, X as enumerateItemArrayFields, Z as enumerateSchemaFields, a as CAMERA_SWITCH_ORDER, bn as EventCategory, en as DeviceType, f as DeviceStatusSchema, fn as isDeviceConfigCap, kt as resolveContainerPrimaryChild, o as CAP_NAMES_WITH_STATUS, q as deviceStatusCapability, qt as errMsg, rn as WELL_KNOWN_TAB_MAP, t as ALL_CAPABILITY_DEFINITIONS, wt as parseStreamParamsFormPatch, yn as sleep$1 } from "../../dist-DkGEz_3L.mjs";
-import { n as purgeRetiredSettingsRows } from "../../retired-settings-keys-BSsaf7n4.mjs";
+import { C as STREAM_PROFILE_META, Et as parseStreamParamsFormPatch, J as deviceStatusCapability, K as deviceManagerCapability, Pt as runtimeStatePolicyFor, Q as enumerateSchemaFields, R as buildStreamParamsConfigSchema, Sn as EventCategory, Xt as BaseAddon, Yt as errMsg, Z as enumerateItemArrayFields, a as CAMERA_SWITCH_ORDER, an as WELL_KNOWN_TAB_MAP, en as DeviceFeature, f as DeviceStatusSchema, gt as locationIconKey, h as LocationIconIdSchema, jt as resolveContainerPrimaryChild, mn as isDeviceConfigCap, nn as DeviceType, o as CAP_NAMES_WITH_STATUS, q as deviceStateCapability, t as ALL_CAPABILITY_DEFINITIONS, tn as DeviceRole, wt as normalizeUnit, xn as sleep$1 } from "../../dist-B4htkDVv.mjs";
+import { n as purgeRetiredSettingsRows } from "../../retired-settings-keys-C9w4b4TV.mjs";
 import { randomUUID } from "node:crypto";
 import { canonicalDeviceFingerprint } from "@camstack/types/node";
 //#region src/builtins/device-manager/adoption-job-engine.ts
@@ -3923,7 +3923,8 @@ async function runLocationBackfillAtBoot(pctx, bootRows) {
 * setLocation, setType, setIntegrationId, setLinkDeviceId,
 * setPrimaryChildEntityId, setChildLayout, setRole, setDisplay,
 * applyInitialMeta, setMetadata, setDisabled), and the location registry
-* (listLocations, addLocation, removeLocation).
+* (listLocations, addLocation, removeLocation, renameLocation) with its icon
+* map (listLocationIcons, setLocationIcon).
 *
 * EXACT ordering and side effects preserved — notably registerDevice's
 * name-precedence reconcile + field-preservation spreads, the
@@ -4975,6 +4976,83 @@ async function addLocation(pctx, input) {
 	});
 }
 /**
+* Every location that carries an icon, as `(locationKey, icon)` pairs.
+*
+* ADDITIVE beside `listLocations`, which still answers `string[]` — the
+* autocomplete, the HA adoption import and the recorder all read a list of
+* LABELS and a shape change there would break every one of them. A surface
+* that wants icons asks for them and joins on `locationIconKey`.
+*
+* Returns only what was actually stored. A location with no assignment is
+* ABSENT, never `map-pin`: the fallback belongs to the renderer
+* (`resolveLocationIcon`), and folding it in here would make "the operator
+* picked the pin" indistinguishable from "the operator picked nothing" —
+* which is the difference an icon picker has to draw.
+*/
+async function listLocationIcons(pctx) {
+	const icons = (await pctx.metaStore.readStore()).locationIcons ?? {};
+	return Object.entries(icons).map(([locationKey, icon]) => ({
+		locationKey,
+		icon
+	})).toSorted((a, b) => a.locationKey.localeCompare(b.locationKey));
+}
+/**
+* Set (or clear) the icon of a location label.
+*
+* Keyed on `locationIconKey` — trimmed + lower-cased, the equality the
+* registry matches on everywhere — so a case-only rename keeps the icon and
+* two spellings of one room can never carry two different icons.
+*
+* The label need NOT be registered: `setLocation` accepts a free-form string
+* and `listLocations` folds in whatever devices carry, so requiring
+* registration here would leave exactly the ad-hoc rooms unable to have an
+* icon. An empty label throws — there is no room to name.
+*
+* Same read-modify-write and same lock as `addLocation`: the map is one key of
+* the addon store, and `writeAddonStore` re-inserts the whole key range, so an
+* unordered write carries a stale copy of every other key.
+*/
+async function setLocationIcon(pctx, input) {
+	const trimmed = input.location.trim();
+	if (trimmed.length === 0) throw new Error("[device-manager] setLocationIcon: location must be non-empty");
+	const key = locationIconKey(trimmed);
+	await pctx.bindingsDeps.withAddonStoreWriteLock(async () => {
+		const icons = (await pctx.metaStore.readStore()).locationIcons ?? {};
+		if (input.icon === null) {
+			if (!(key in icons)) return;
+			const { [key]: _cleared, ...kept } = icons;
+			await pctx.settings.writeAddonStore({ locationIcons: kept });
+			return;
+		}
+		if (icons[key] === input.icon) return;
+		await pctx.settings.writeAddonStore({ locationIcons: {
+			...icons,
+			[key]: input.icon
+		} });
+	});
+}
+/**
+* Move a location's icon from one key to another, for `renameLocation`.
+*
+* Returns `null` when NOTHING changes, so the caller can leave the key out of
+* its `writeAddonStore` patch instead of re-writing an identical map.
+*
+* A rename onto a room that already has an icon is a MERGE, and the surviving
+* room keeps its own: the operator renaming "Sala" into "Salone" is moving
+* devices into Salone, not restyling it. The source key is dropped either way.
+* Pure — builds a new record, mutates nothing.
+*/
+function renameLocationIcon(icons, fromKey, toKey) {
+	const moved = icons[fromKey];
+	if (moved === void 0) return null;
+	if (fromKey === toKey) return null;
+	const { [fromKey]: _dropped, ...rest } = icons;
+	return toKey in rest ? rest : {
+		...rest,
+		[toKey]: moved
+	};
+}
+/**
 * Remove a label from the curated registry. Match is
 * case-insensitive. Devices that still reference this label keep
 * their `meta.location` value (the registry is a suggestion
@@ -5005,13 +5083,19 @@ async function renameLocation(pctx, input) {
 	const fromKey = from.toLowerCase();
 	const toKey = to.toLowerCase();
 	await pctx.bindingsDeps.withAddonStoreWriteLock(async () => {
-		const current = (await pctx.metaStore.readStore()).locations ?? [];
-		if (!current.some((l) => l.trim().toLowerCase() === fromKey)) return;
+		const store = await pctx.metaStore.readStore();
+		const current = store.locations ?? [];
+		const registered = current.some((l) => l.trim().toLowerCase() === fromKey);
+		const movedIcons = renameLocationIcon(store.locationIcons ?? {}, fromKey, toKey);
+		if (!registered && movedIcons === null) return;
 		const kept = current.filter((l) => {
 			const key = l.trim().toLowerCase();
 			return key !== fromKey && key !== toKey;
 		});
-		await pctx.settings.writeAddonStore({ locations: [...kept, to] });
+		await pctx.settings.writeAddonStore({
+			...registered ? { locations: [...kept, to] } : {},
+			...movedIcons !== null ? { locationIcons: movedIcons } : {}
+		});
 	});
 	const moved = await pctx.metaStore.withMetaWriteLock(async () => {
 		const out = [];
@@ -5049,10 +5133,19 @@ async function removeLocation(pctx, input) {
 	const trimmed = input.name.trim();
 	if (trimmed.length === 0) return;
 	await pctx.bindingsDeps.withAddonStoreWriteLock(async () => {
-		const current = (await pctx.metaStore.readStore()).locations ?? [];
-		const remaining = current.filter((l) => l.toLowerCase() !== trimmed.toLowerCase());
-		if (remaining.length === current.length) return;
-		await pctx.settings.writeAddonStore({ locations: remaining });
+		const store = await pctx.metaStore.readStore();
+		const current = store.locations ?? [];
+		const key = locationIconKey(trimmed);
+		const remaining = current.filter((l) => l.toLowerCase() !== key);
+		const droppedLabel = remaining.length !== current.length;
+		const icons = store.locationIcons ?? {};
+		const droppedIcon = key in icons;
+		if (!droppedLabel && !droppedIcon) return;
+		const { [key]: _removedIcon, ...keptIcons } = icons;
+		await pctx.settings.writeAddonStore({
+			...droppedLabel ? { locations: remaining } : {},
+			...droppedIcon ? { locationIcons: keptIcons } : {}
+		});
 	});
 	if (input.cascade !== true) return;
 	const cleared = await pctx.metaStore.withMetaWriteLock(async () => {
@@ -5154,12 +5247,35 @@ function decodeAddonStore(raw) {
 	const nextDeviceId = raw["nextDeviceId"];
 	const locations = raw["locations"];
 	const roleDisplayDefaults = raw["roleDisplayDefaults"];
+	const locationIcons = decodeLocationIcons(raw["locationIcons"]);
 	return {
 		...typeof nextDeviceId === "number" && Number.isFinite(nextDeviceId) ? { nextDeviceId } : {},
 		...Array.isArray(locations) ? { locations: locations.filter((l) => typeof l === "string") } : {},
-		...isRoleDisplayDefaults(roleDisplayDefaults) ? { roleDisplayDefaults } : {}
+		...isRoleDisplayDefaults(roleDisplayDefaults) ? { roleDisplayDefaults } : {},
+		...locationIcons !== null ? { locationIcons } : {}
 	};
 }
+/**
+* Decode the `locationIcons` map, dropping every entry whose value is not a
+* member of the closed vocabulary.
+*
+* Dropping, not passing through: the icon's whole point is that both surfaces
+* can draw it, and an id from a hand-edit or a newer hub is exactly the value
+* that draws nothing. Absent reads as "no icon chosen", which every renderer
+* already degrades to the fallback pin. Returns `null` when the key itself is
+* absent or of the wrong shape, so the field stays OMITTED rather than being
+* written back as an empty object.
+*/
+function decodeLocationIcons(raw) {
+	if (raw === null || typeof raw !== "object" || Array.isArray(raw)) return null;
+	const out = {};
+	for (const [key, value] of Object.entries(raw)) {
+		const parsed = LocationIconIdSchema.safeParse(value);
+		if (!parsed.success) continue;
+		out[key] = parsed.data;
+	}
+	return out;
+}
 function isRoleDisplayDefaults(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -6992,6 +7108,8 @@ var DeviceManagerAddon = class extends BaseAddon {
 			addLocation: (input) => addLocation(pctx, input),
 			removeLocation: (input) => removeLocation(pctx, input),
 			renameLocation: (input) => renameLocation(pctx, input),
+			listLocationIcons: () => listLocationIcons(pctx),
+			setLocationIcon: (input) => setLocationIcon(pctx, input),
 			listPersistedByAddon: (input) => listPersistedByAddon(pctx, input),
 			listAll: (input) => listAll(pctx, input),
 			getDevice: (input) => getDevice(pctx, input),

package/dist/builtins/device-manager/device-meta-actions.d.ts

@@ -212,6 +212,38 @@ export declare function listLocations(pctx: ProviderContext): ReturnType<IDevice
  * meaningful label.
  */
 export declare function addLocation(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['addLocation']>[0]): ReturnType<IDeviceManagerProvider['addLocation']>;
+/**
+ * Every location that carries an icon, as `(locationKey, icon)` pairs.
+ *
+ * ADDITIVE beside `listLocations`, which still answers `string[]` — the
+ * autocomplete, the HA adoption import and the recorder all read a list of
+ * LABELS and a shape change there would break every one of them. A surface
+ * that wants icons asks for them and joins on `locationIconKey`.
+ *
+ * Returns only what was actually stored. A location with no assignment is
+ * ABSENT, never `map-pin`: the fallback belongs to the renderer
+ * (`resolveLocationIcon`), and folding it in here would make "the operator
+ * picked the pin" indistinguishable from "the operator picked nothing" —
+ * which is the difference an icon picker has to draw.
+ */
+export declare function listLocationIcons(pctx: ProviderContext): ReturnType<IDeviceManagerProvider['listLocationIcons']>;
+/**
+ * Set (or clear) the icon of a location label.
+ *
+ * Keyed on `locationIconKey` — trimmed + lower-cased, the equality the
+ * registry matches on everywhere — so a case-only rename keeps the icon and
+ * two spellings of one room can never carry two different icons.
+ *
+ * The label need NOT be registered: `setLocation` accepts a free-form string
+ * and `listLocations` folds in whatever devices carry, so requiring
+ * registration here would leave exactly the ad-hoc rooms unable to have an
+ * icon. An empty label throws — there is no room to name.
+ *
+ * Same read-modify-write and same lock as `addLocation`: the map is one key of
+ * the addon store, and `writeAddonStore` re-inserts the whole key range, so an
+ * unordered write carries a stale copy of every other key.
+ */
+export declare function setLocationIcon(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setLocationIcon']>[0]): ReturnType<IDeviceManagerProvider['setLocationIcon']>;
 /**
  * Remove a label from the curated registry. Match is
  * case-insensitive. Devices that still reference this label keep

package/dist/builtins/device-manager/device-meta-types.d.ts

@@ -1,4 +1,4 @@
-import { ChildLayout, DeviceDisplayOverride, RoleDisplayDefault } from '@camstack/types';
+import { ChildLayout, DeviceDisplayOverride, LocationIconId, RoleDisplayDefault } from '@camstack/types';
 /**
  * Wire shape matching `z.infer<typeof SettingsSchemaWithValuesSchema>` —
  * duplicated as a plain interface because importing the Zod schema across
@@ -161,6 +161,22 @@ export interface AddonStore {
      * the operator forgot to register a label before assigning it.
      */
     locations?: readonly string[];
+    /**
+     * Icon per location, keyed by `locationIconKey(label)` — trimmed and
+     * lower-cased, the same equality the registry itself matches on. Lives HERE,
+     * beside `locations`, because that is where a location exists at all: a
+     * location is a label, not a row, so there is no record to hang an icon on.
+     *
+     * Keyed on the folded label rather than the operator's casing on purpose. A
+     * case-only rename (`cucina` → `Cucina`) is a real edit this repo supports,
+     * and a map keyed on the displayed spelling would silently orphan its entry
+     * on exactly that edit — the icon would vanish and nothing would say why.
+     *
+     * A value outside `LOCATION_ICON_IDS` is DROPPED on decode, not trusted: the
+     * store is JSON on disk and a renderer handed an unknown id can only draw a
+     * hole. Dropping it degrades the location to the fallback pin instead.
+     */
+    locationIcons?: Readonly<Record<string, LocationIconId>>;
     /** Operator-authored per-role display defaults (unit/precision/icon), keyed
      *  by `DeviceRole` string. Resolution merges these UNDER any per-device
      *  `display` override. Written whole-record by `setRoleDisplayDefaults`

package/dist/builtins/doorbell/virtual-doorbell.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BETx_5mH.js");
+const require_dist = require("../../dist-D6kqBW1G.js");
 //#region src/builtins/doorbell/trigger-engine.ts
 /**
 * Pure trigger logic for the virtual-doorbell builtin — edge detection over

package/dist/builtins/doorbell/virtual-doorbell.addon.mjs

@@ -1,4 +1,4 @@
-import { F as bareAddonId, J as doorbellCapability, Jt as BaseAddon, Q as evaluateSensorEdge, b as SOURCE_DEVICE_TYPES, bn as EventCategory, ct as isSameAddonId, en as DeviceType, lt as isSourceCap, qt as errMsg, sn as createEvent, y as SOURCE_CAPS } from "../../dist-DkGEz_3L.mjs";
+import { $ as evaluateSensorEdge, I as bareAddonId, Sn as EventCategory, Xt as BaseAddon, Y as doorbellCapability, Yt as errMsg, b as SOURCE_CAPS, ln as createEvent, lt as isSameAddonId, nn as DeviceType, ut as isSourceCap, x as SOURCE_DEVICE_TYPES } from "../../dist-B4htkDVv.mjs";
 //#region src/builtins/doorbell/trigger-engine.ts
 /**
 * Pure trigger logic for the virtual-doorbell builtin — edge detection over

package/dist/builtins/hub-forwarder/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BETx_5mH.js");
+const require_dist = require("../../dist-D6kqBW1G.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/hub-forwarder/index.mjs

@@ -1,4 +1,4 @@
-import { Jt as BaseAddon, ht as logDestinationCapability } from "../../dist-DkGEz_3L.mjs";
+import { Xt as BaseAddon, _t as logDestinationCapability } from "../../dist-B4htkDVv.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/hub-forwarder/hub-forwarder-destination.ts
 var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;

package/dist/builtins/liveness-monitor/liveness-monitor.addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BETx_5mH.js");
+const require_dist = require("../../dist-D6kqBW1G.js");
 //#region src/builtins/liveness-monitor/liveness-checks.ts
 var NO_DEVICES = "liveness:no-devices";
 var ALL_OFFLINE = "liveness:all-devices-offline";

package/dist/builtins/liveness-monitor/liveness-monitor.addon.mjs

@@ -1,4 +1,4 @@
-import { Jt as BaseAddon, bn as EventCategory, qt as errMsg, sn as createEvent, v as RecordingStatusSchema } from "../../dist-DkGEz_3L.mjs";
+import { Sn as EventCategory, Xt as BaseAddon, Yt as errMsg, ln as createEvent, y as RecordingStatusSchema } from "../../dist-B4htkDVv.mjs";
 //#region src/builtins/liveness-monitor/liveness-checks.ts
 var NO_DEVICES = "liveness:no-devices";
 var ALL_OFFLINE = "liveness:all-devices-offline";

package/dist/builtins/local-auth/local-auth.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BETx_5mH.js");
+const require_dist = require("../../dist-D6kqBW1G.js");
 let node_crypto = require("node:crypto");
 node_crypto = require_chunk.__toESM(node_crypto);
 let crypto$1 = require("crypto");

package/dist/builtins/local-auth/local-auth.addon.mjs

@@ -1,5 +1,5 @@
 import { i as __require, o as __toESM, t as __commonJSMin } from "../../chunk-CNf5ZN-e.mjs";
-import { C as ScopedTokenSchema, Jt as BaseAddon, N as authProviderCapability, O as UserRecordSchema, Ut as userManagementCapability, r as ApiKeyRecordSchema } from "../../dist-DkGEz_3L.mjs";
+import { Gt as userManagementCapability, P as authProviderCapability, Xt as BaseAddon, k as UserRecordSchema, r as ApiKeyRecordSchema, w as ScopedTokenSchema } from "../../dist-B4htkDVv.mjs";
 import * as crypto$2 from "node:crypto";
 import { createHash, randomUUID, timingSafeEqual } from "node:crypto";
 import nodeCrypto from "crypto";