@camstack/addon-admin-ui 1.2.462 → 1.2.464

package/dist/server/addon.js

@@ -41750,6 +41750,381 @@ var _macroLookup = /* @__PURE__ */ new Map();
 for (const [k, v] of Object.entries(YAMNET_TO_MACRO.mapping)) _macroLookup.set(k.toLowerCase(), v);
 for (const [k, v] of Object.entries(APPLE_SA_TO_MACRO.mapping)) _macroLookup.set(k.toLowerCase(), v);
 /**
+* Palette entry ids (D939). Audio is the one gradient; `audio-*` leaves are
+* not entries. `heatmapScrub` is a mark, not an event kind.
+*/
+var PALETTE_ENTRY_IDS = [
+	"motion",
+	"audio",
+	"recording",
+	"live",
+	"heatmapScrub",
+	"person",
+	"vehicle",
+	"animal",
+	"package",
+	"sensor",
+	"control",
+	"face",
+	"plate",
+	"car",
+	"truck",
+	"bus",
+	"motorcycle",
+	"bicycle",
+	"airplane",
+	"boat",
+	"train",
+	"bird",
+	"dog",
+	"cat",
+	"horse",
+	"sheep",
+	"cow",
+	"elephant",
+	"bear",
+	"zebra",
+	"giraffe",
+	"package-delivered",
+	"package-picked-up",
+	"suitcase",
+	"backpack",
+	"handbag",
+	"contact",
+	"motion-sensor",
+	"smoke",
+	"flood",
+	"gas",
+	"carbon-monoxide",
+	"vibration",
+	"tamper",
+	"presence",
+	"enum-sensor",
+	"device-event",
+	"lock",
+	"cover",
+	"switch",
+	"siren",
+	"button",
+	"doorbell"
+];
+var AUDIO_ENTRY_ID = "audio";
+/** Six rungs, quiet → loud. The opaque end is the entry's hex. */
+var AUDIO_GRADIENT_ALPHAS = [
+	.3,
+	.42,
+	.55,
+	.7,
+	.85,
+	1
+];
+var PALETTE_PRESET_IDS = [
+	"camstack",
+	"high-contrast",
+	"okabe-ito"
+];
+/** Frozen palette tables (D939). The spec refuses a table that breaks the rule. */
+var CAMSTACK_HEX = {
+	motion: "#d946ef",
+	audio: "#059eb8",
+	recording: "#ef4444",
+	live: "#8d7a00",
+	heatmapScrub: "#4b32ff",
+	person: "#11a64c",
+	vehicle: "#3b82f6",
+	animal: "#ea6a09",
+	package: "#924667",
+	sensor: "#624bbc",
+	control: "#944d24",
+	face: "#ed4f8d",
+	plate: "#4b7027",
+	car: "#9684cf",
+	truck: "#0f9b89",
+	bus: "#a734a9",
+	motorcycle: "#c1133a",
+	bicycle: "#0e6a9b",
+	airplane: "#7c9928",
+	boat: "#b17933",
+	train: "#ad6ca3",
+	bird: "#0f7c55",
+	dog: "#c82700",
+	cat: "#7268f2",
+	horse: "#cb795e",
+	sheep: "#b8636b",
+	cow: "#cb2969",
+	elephant: "#1158d2",
+	bear: "#8d5e00",
+	zebra: "#0097d6",
+	giraffe: "#8f61bb",
+	"package-delivered": "#cd3f9b",
+	"package-picked-up": "#388a08",
+	suitcase: "#666800",
+	backpack: "#ec5022",
+	handbag: "#a76ef8",
+	contact: "#ab5a49",
+	"motion-sensor": "#b95d1a",
+	smoke: "#dd3858",
+	flood: "#b31e7d",
+	gas: "#5b70b5",
+	"carbon-monoxide": "#7b4e8e",
+	vibration: "#e65bba",
+	tamper: "#98464b",
+	presence: "#3a9468",
+	"enum-sensor": "#7885f8",
+	"device-event": "#8c43c8",
+	lock: "#649653",
+	cover: "#c67597",
+	switch: "#7a812a",
+	siren: "#ac5d7f",
+	button: "#b276cd",
+	doorbell: "#0087ab"
+};
+var CAMSTACK_FALLBACK = [
+	"#b34dc7",
+	"#1d7d34",
+	"#db6b6c",
+	"#a43d29",
+	"#0e6ee6",
+	"#29a10b",
+	"#a98731",
+	"#0181c6"
+];
+var HIGH_CONTRAST_HEX = {
+	motion: "#964360",
+	audio: "#23a132",
+	recording: "#2494ca",
+	live: "#bd7e2b",
+	heatmapScrub: "#ad6eea",
+	person: "#62611e",
+	vehicle: "#f4534c",
+	animal: "#1556cd",
+	package: "#9c4415",
+	sensor: "#066c48",
+	control: "#f2479f",
+	face: "#139d8a",
+	plate: "#909024",
+	car: "#8e35ab",
+	truck: "#bd0b2b",
+	bus: "#7a88ca",
+	motorcycle: "#e26725",
+	bicycle: "#a6679b",
+	airplane: "#7c5720",
+	boat: "#467a1b",
+	train: "#6f65a4",
+	bird: "#cb717f",
+	dog: "#c62490",
+	cat: "#b36850",
+	horse: "#1872ac",
+	sheep: "#927939",
+	cow: "#428a5c",
+	elephant: "#d41160",
+	bear: "#799453",
+	zebra: "#a85455",
+	giraffe: "#746be8",
+	"package-delivered": "#824a80",
+	"package-picked-up": "#614ac1",
+	suitcase: "#2f77f3",
+	backpack: "#fa476d",
+	handbag: "#c14cbe",
+	contact: "#c83921",
+	"motion-sensor": "#a07ebd",
+	smoke: "#a25b13",
+	flood: "#526bab",
+	gas: "#924938",
+	"carbon-monoxide": "#bb7e53",
+	vibration: "#b66182",
+	tamper: "#3c6931",
+	presence: "#6c851d",
+	"enum-sensor": "#ad2d48",
+	"device-event": "#5e9b04",
+	lock: "#00a062",
+	cover: "#ad8624",
+	switch: "#d05259",
+	siren: "#cd67b3",
+	button: "#c9746a",
+	doorbell: "#338eeb"
+};
+var HIGH_CONTRAST_FALLBACK = [
+	"#817f3b",
+	"#a0733e",
+	"#8658b2",
+	"#956301",
+	"#bc652d",
+	"#647331",
+	"#a14c9e",
+	"#d14e71"
+];
+var OKABE_ITO_HEX = {
+	motion: "#b88128",
+	audio: "#1096c8",
+	recording: "#009e73",
+	live: "#9c8c22",
+	heatmapScrub: "#0072b2",
+	person: "#d55e00",
+	vehicle: "#c0739f",
+	animal: "#226d18",
+	package: "#91446c",
+	sensor: "#217b56",
+	control: "#648647",
+	face: "#c22998",
+	plate: "#fa4575",
+	car: "#956301",
+	truck: "#2f77f3",
+	bus: "#7a4e86",
+	motorcycle: "#f54597",
+	bicycle: "#bb3e75",
+	airplane: "#e054c0",
+	boat: "#457942",
+	train: "#867afa",
+	bird: "#88914c",
+	dog: "#1556cd",
+	cat: "#71702c",
+	horse: "#9b4fa4",
+	sheep: "#c0559d",
+	cow: "#d14f65",
+	elephant: "#98470f",
+	bear: "#595896",
+	zebra: "#96790e",
+	giraffe: "#cb717b",
+	"package-delivered": "#139d8a",
+	"package-picked-up": "#906ead",
+	suitcase: "#d02939",
+	backpack: "#d41160",
+	handbag: "#f64f54",
+	contact: "#7258d2",
+	"motion-sensor": "#b66182",
+	smoke: "#627abb",
+	flood: "#b86ae4",
+	gas: "#a95261",
+	"carbon-monoxide": "#c65d3c",
+	vibration: "#7a40b7",
+	tamper: "#914b34",
+	presence: "#9481c3",
+	"enum-sensor": "#ac6d47",
+	"device-event": "#7b6fce",
+	lock: "#c67662",
+	cover: "#a6564d",
+	switch: "#ad2c4e",
+	siren: "#348e08",
+	button: "#d27303",
+	doorbell: "#55770f"
+};
+var OKABE_ITO_FALLBACK = [
+	"#9a3784",
+	"#a7392c",
+	"#409d50",
+	"#6987e7",
+	"#ee5b3d",
+	"#c0430d",
+	"#af79b3",
+	"#4b6628"
+];
+/**
+* The display palette (D939). One table of colours, three presets, one
+* validator. Taxonomy colours and every consumer read this — there is no
+* second hex table.
+*/
+var paletteHexSchema = string().regex(/^#[0-9a-f]{6}$/);
+var paletteSwatchSchema = discriminatedUnion("form", [object({
+	form: literal("solid"),
+	hex: paletteHexSchema
+}), object({
+	form: literal("gradient"),
+	hex: paletteHexSchema,
+	alphas: array(number().gt(0).lte(1)).length(AUDIO_GRADIENT_ALPHAS.length)
+})]);
+var paletteReadySchema = object({
+	status: literal("ready"),
+	presetId: _enum(PALETTE_PRESET_IDS),
+	customized: boolean(),
+	source: _enum(["stored", "unconfigured"]),
+	swatches: record(string(), paletteSwatchSchema),
+	fallbacks: array(paletteHexSchema).length(8)
+});
+var paletteResultSchema = discriminatedUnion("status", [paletteReadySchema, object({
+	status: literal("unknown"),
+	reason: string()
+})]);
+var setPaletteInputSchema = union([object({ presetId: string() }), object({
+	presetId: string(),
+	overrides: record(string(), paletteSwatchSchema)
+})]);
+object({
+	presetId: string(),
+	overrides: record(string(), paletteSwatchSchema)
+});
+function solid(hex) {
+	return {
+		form: "solid",
+		hex
+	};
+}
+function audioGradient(hex) {
+	return {
+		form: "gradient",
+		hex,
+		alphas: [...AUDIO_GRADIENT_ALPHAS]
+	};
+}
+function swatchesFrom(hexes) {
+	const out = {};
+	for (const id of PALETTE_ENTRY_IDS) {
+		const hex = hexes[id];
+		if (hex === void 0) throw new Error(`palette table missing ${id}`);
+		out[id] = id === "audio" ? audioGradient(hex) : solid(hex);
+	}
+	return out;
+}
+function preset(id, name, hexes, fallbacks) {
+	return {
+		id,
+		name,
+		swatches: swatchesFrom(hexes),
+		fallbacks
+	};
+}
+var DISPLAY_PRESETS = [
+	preset("camstack", "CamStack", CAMSTACK_HEX, CAMSTACK_FALLBACK),
+	preset("high-contrast", "High contrast", HIGH_CONTRAST_HEX, HIGH_CONTRAST_FALLBACK),
+	preset("okabe-ito", "Colour-blind safe", OKABE_ITO_HEX, OKABE_ITO_FALLBACK)
+];
+function presetById(id) {
+	return DISPLAY_PRESETS.find((item) => item.id === id);
+}
+function bundledCamstack() {
+	const presetRow = presetById("camstack");
+	if (presetRow === void 0) throw new Error("CamStack preset missing");
+	return readyOf(presetRow, "unconfigured", false);
+}
+function readyOf(row, source, customized) {
+	return {
+		status: "ready",
+		presetId: row.id,
+		customized,
+		source,
+		swatches: row.swatches,
+		fallbacks: [...row.fallbacks]
+	};
+}
+function hashFallback(kind, fallbacks) {
+	let hash = 0;
+	for (let i = 0; i < kind.length; i++) hash = hash * 31 + (kind.codePointAt(i) ?? 0) >>> 0;
+	const hex = fallbacks[hash % fallbacks.length];
+	if (hex === void 0) throw new Error("display palette has no fallback colour");
+	return hex;
+}
+/** Colour a kind paints with. Audio leaves share the audio gradient's hex. */
+function paintHex(swatches, fallbacks, kind) {
+	const key = kind.trim().toLowerCase();
+	if (key.startsWith("audio-")) {
+		const audio = swatches[AUDIO_ENTRY_ID];
+		return audio !== void 0 ? audio.hex : hashFallback(key, fallbacks);
+	}
+	const direct = swatches[key];
+	if (direct !== void 0) return direct.hex;
+	return hashFallback(key, fallbacks);
+}
+/**
 * Unified event-kind taxonomy — THE single source of truth for
 * `kind → { parentKind, category, level, color, iconId, labelKey, label,
 * icon }`.
@@ -41763,109 +42138,88 @@ for (const [k, v] of Object.entries(APPLE_SA_TO_MACRO.mapping)) _macroLookup.set
 *   - `addon-post-analysis/shared/frame/box-drawer.ts` (DEFAULT_COLOR)
 *   - the COCO / audio class maps (macro ↔ sub relationships)
 *
-* The DATA (serializable — color/iconId/labelKey/parentKind) lives here in
-* `@camstack/types`. The UI-side mapping `iconId → lucide component` and
-* `labelKey → t()` lives in `@camstack/ui-library`. UIs never hardcode a
-* color or an icon: they read this dictionary (server descriptors carry the
-* fields inline; the client resolves color/icon/label from `iconId`/`kind`).
+* The DATA (serializable — parentKind / iconId / labelKey) lives here in
+* `@camstack/types`. Colour is NOT a second table: each entry's `color` is
+* the bundled CamStack display palette (D939). The effective cluster palette
+* is the `display-palette` capability. The UI-side mapping `iconId → lucide
+* component` and `labelKey → t()` lives in `@camstack/ui-library`.
 *
 * Two levels only (v1 YAGNI): macro → sub. `person` is a leaf macro.
 */
-var TAXONOMY_COLORS = {
-	motion: "#f59e0b",
-	audio: "#06b6d4",
-	person: "#22c55e",
-	vehicle: "#3b82f6",
-	animal: "#f97316",
-	package: "#a855f7",
-	sensor: "#8b5cf6",
-	control: "#10b981",
-	genericDetection: "#64748b"
-};
-var DETECTION_SUB_COLORS = {
-	car: "#f59e0b",
-	truck: "#d97706",
-	bus: "#b45309",
-	motorcycle: "#eab308",
-	bicycle: "#ca8a04",
-	airplane: "#60a5fa",
-	boat: "#2563eb",
-	train: "#1d4ed8",
-	bird: "#14b8a6",
-	dog: "#84cc16",
-	cat: "#f97316",
-	horse: "#a16207",
-	sheep: "#a3a3a3",
-	cow: "#78716c",
-	elephant: "#6b7280",
-	bear: "#7c2d12",
-	zebra: "#404040",
-	giraffe: "#d4a373"
-};
+var BUNDLED_PALETTE = bundledCamstack();
+function kindColor(kind) {
+	return paintHex(BUNDLED_PALETTE.swatches, BUNDLED_PALETTE.fallbacks, kind);
+}
+function firstFallback(fallbacks) {
+	const hex = fallbacks[0];
+	if (hex === void 0) throw new Error("display palette has no fallback colour");
+	return hex;
+}
+firstFallback(BUNDLED_PALETTE.fallbacks);
 function titleCase(id) {
 	return id.split(/[-_ ]/).filter((p) => p.length > 0).map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join(" ");
 }
 var entries = /* @__PURE__ */ new Map();
-function macro(kind, category, color, iconId, label) {
+function macro(kind, category, iconId, label) {
 	entries.set(kind, {
 		kind,
 		parentKind: null,
 		level: "macro",
 		category,
-		color,
+		color: kindColor(kind),
 		iconId,
 		labelKey: `eventKind.${kind}`,
 		label
 	});
 }
-function sub(kind, parentKind, category, color, iconId, label) {
+function sub(kind, parentKind, category, iconId, label) {
 	entries.set(kind, {
 		kind,
 		parentKind,
 		level: "sub",
 		category,
-		color,
+		color: kindColor(kind),
 		iconId,
 		labelKey: `eventKind.${kind}`,
 		label
 	});
 }
-macro("motion", "motion", TAXONOMY_COLORS.motion, "motion", "Motion");
-macro("audio", "audio", TAXONOMY_COLORS.audio, "audio", "Audio");
-macro("person", "detection", TAXONOMY_COLORS.person, "person", "Person");
-macro("vehicle", "detection", TAXONOMY_COLORS.vehicle, "vehicle", "Vehicle");
-macro("animal", "detection", TAXONOMY_COLORS.animal, "animal", "Animal");
-macro("package", "package", TAXONOMY_COLORS.package, "package", "Package");
-macro("sensor", "sensor", TAXONOMY_COLORS.sensor, "sensor", "Sensor");
-macro("control", "control", TAXONOMY_COLORS.control, "control", "Control");
+macro("motion", "motion", "motion", "Motion");
+macro("audio", "audio", "audio", "Audio");
+macro("person", "detection", "person", "Person");
+macro("vehicle", "detection", "vehicle", "Vehicle");
+macro("animal", "detection", "animal", "Animal");
+macro("package", "package", "package", "Package");
+macro("sensor", "sensor", "sensor", "Sensor");
+macro("control", "control", "control", "Control");
 for (const [cocoClass, macroClass] of Object.entries(COCO_TO_MACRO.mapping)) {
 	if (macroClass !== "vehicle" && macroClass !== "animal") continue;
 	if (entries.has(cocoClass)) continue;
-	sub(cocoClass, macroClass, "detection", DETECTION_SUB_COLORS[cocoClass] ?? TAXONOMY_COLORS.genericDetection, cocoClass, titleCase(cocoClass));
+	sub(cocoClass, macroClass, "detection", cocoClass, titleCase(cocoClass));
 }
-sub("package-delivered", "package", "package", TAXONOMY_COLORS.package, "package", "Package delivered");
-sub("package-picked-up", "package", "package", TAXONOMY_COLORS.package, "package", "Package picked up");
-sub("contact", "sensor", "sensor", "#f59e0b", "door", "Contact");
-sub("motion-sensor", "sensor", "sensor", TAXONOMY_COLORS.sensor, "pir", "Motion sensor");
-sub("smoke", "sensor", "sensor", "#ef4444", "smoke", "Smoke");
-sub("flood", "sensor", "sensor", "#3b82f6", "water", "Water leak");
-sub("gas", "sensor", "sensor", "#ef4444", "gas", "Gas");
-sub("carbon-monoxide", "sensor", "sensor", "#dc2626", "smoke", "Carbon monoxide");
-sub("vibration", "sensor", "sensor", "#eab308", "vibration", "Vibration");
-sub("tamper", "sensor", "sensor", "#f97316", "tamper", "Tamper");
-sub("presence", "sensor", "sensor", "#22c55e", "presence", "Presence");
-sub("enum-sensor", "sensor", "sensor", TAXONOMY_COLORS.sensor, "generic", "Sensor state");
-sub("device-event", "sensor", "sensor", "#10b981", "button", "Device event");
-sub("lock", "control", "control", "#0ea5e9", "lock", "Lock");
-sub("cover", "control", "control", "#0ea5e9", "door", "Cover");
-sub("switch", "control", "control", TAXONOMY_COLORS.control, "switch", "Switch");
-sub("siren", "control", "control", "#dc2626", "siren", "Siren");
-sub("button", "control", "control", "#10b981", "button", "Button");
-sub("doorbell", "control", "control", "#a855f7", "doorbell", "Doorbell");
+sub("package-delivered", "package", "package", "package", "Package delivered");
+sub("package-picked-up", "package", "package", "package", "Package picked up");
+sub("contact", "sensor", "sensor", "door", "Contact");
+sub("motion-sensor", "sensor", "sensor", "pir", "Motion sensor");
+sub("smoke", "sensor", "sensor", "smoke", "Smoke");
+sub("flood", "sensor", "sensor", "water", "Water leak");
+sub("gas", "sensor", "sensor", "gas", "Gas");
+sub("carbon-monoxide", "sensor", "sensor", "smoke", "Carbon monoxide");
+sub("vibration", "sensor", "sensor", "vibration", "Vibration");
+sub("tamper", "sensor", "sensor", "tamper", "Tamper");
+sub("presence", "sensor", "sensor", "presence", "Presence");
+sub("enum-sensor", "sensor", "sensor", "generic", "Sensor state");
+sub("device-event", "sensor", "sensor", "button", "Device event");
+sub("lock", "control", "control", "lock", "Lock");
+sub("cover", "control", "control", "door", "Cover");
+sub("switch", "control", "control", "switch", "Switch");
+sub("siren", "control", "control", "siren", "Siren");
+sub("button", "control", "control", "button", "Button");
+sub("doorbell", "control", "control", "doorbell", "Doorbell");
 for (const l of AUDIO_MACRO_LABELS) {
 	const kind = `audio-${l.id}`;
 	if (entries.has(kind)) continue;
-	sub(kind, "audio", "audio", TAXONOMY_COLORS.audio, kind, l.name);
+	sub(kind, "audio", "audio", kind, l.name);
 }
 /** The complete taxonomy dictionary, keyed by kind. */
 var EVENT_TAXONOMY = Object.freeze(Object.fromEntries(entries));
@@ -54575,6 +54929,30 @@ DeviceType.Camera, method(object({ deviceId: number() }), DayNightOptionsSchema)
 	auth: "admin"
 });
 /**
+* display-palette — the cluster's one colour table (D939).
+*
+* Hub singleton. `getPalette` reports `unknown` when the settings store
+* cannot be read; it does not pretend the bundled preset was stored.
+* `setPalette` refuses a palette that fails the ΔE / contrast rule and names
+* the pairs.
+*/
+var presetSummarySchema = object({
+	id: string(),
+	name: string(),
+	swatches: record(string(), paletteSwatchSchema),
+	fallbacks: array(string())
+});
+method(_void(), paletteResultSchema, {
+	auth: "protected",
+	role: "viewer"
+}), method(_void(), array(presetSummarySchema).readonly(), {
+	auth: "protected",
+	role: "viewer"
+}), method(setPaletteInputSchema, paletteReadySchema, {
+	kind: "mutation",
+	auth: "admin"
+});
+/**
 * Generic device-level status snapshot. Auto-registered by `BaseDevice`
 * for every device, regardless of provider — the kernel needs a uniform
 * cap-keyed slice for the basic device flags every consumer expects to
@@ -65473,6 +65851,27 @@ Object.freeze({
 		access: "create",
 		role: "viewer"
 	},
+	"displayPalette.getPalette": {
+		capName: "display-palette",
+		capScope: "system",
+		addonId: null,
+		access: "view",
+		role: "viewer"
+	},
+	"displayPalette.listPresets": {
+		capName: "display-palette",
+		capScope: "system",
+		addonId: null,
+		access: "view",
+		role: "viewer"
+	},
+	"displayPalette.setPalette": {
+		capName: "display-palette",
+		capScope: "system",
+		addonId: null,
+		access: "create",
+		role: "admin"
+	},
 	"doorbell.getStatus": {
 		capName: "doorbell",
 		capScope: "device",
@@ -75929,6 +76328,7 @@ var SYSTEM_CAP_VOCABULARY = {
 	"device-provider": system(INTERNAL),
 	"device-removal-hook": system(INTERNAL),
 	"device-state": system("the runtime-state mirror every trigger already reads through"),
+	"display-palette": system("the cluster display palette — one colour table for every client, not a device action"),
 	"embedding-encoder": system(ML),
 	"face-gallery": system("the face gallery — curated on its own page"),
 	"failure-contribution": system(INTERNAL),
@@ -80115,7 +80515,7 @@ var AdminUIAddon = class extends BaseAddon {
 			capability: adminUiCapability,
 			provider: {
 				getStaticDir: async () => ({ staticDir: resolveAdminUiDistDir() }),
-				getVersion: async () => ({ version: "1.2.462" })
+				getVersion: async () => ({ version: "1.2.464" })
 			}
 		}];
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-admin-ui",
-  "version": "1.2.462",
+  "version": "1.2.464",
   "private": false,
   "type": "module",
   "description": "Admin UI — Vite frontend build and server-side addon",