@camstack/types 1.2.432 → 1.2.433

package/CHANGELOG.md

@@ -7,11 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.433] - 2026-10-28
+
+### Changed
+
+- Unknown event kinds, state words and class names read as words instead of raw ids
+
 ## [1.2.432] - 2026-10-28
 
 ### Changed
 
 - The vendor login proxy is served on one shared vendor-login prefix that cannot shadow an addon's own routes
+- Unknown event kinds and state words now read as a humanized label ("Delivery truck") instead of the raw id
 
 ## [1.2.431] - 2026-10-27
 

package/dist/client.js

@@ -32032,7 +32032,41 @@ function packagePickerItems(packages) {
 	return [...pinned, ...addons];
 }
 //#endregion
+//#region src/i18n/humanize-id.ts
+/**
+* Make a raw wire id readable when no dictionary knows it: `delivery_truck`
+* becomes "Delivery truck", `open-door` becomes "Open door". It invents no
+* translation — the words stay the id's own, only separators and the first
+* letter change. An empty id stays empty.
+*/
+function humanizeId(id) {
+	const spaced = id.replace(/[_-]+/g, " ").replace(/\s+/g, " ").trim();
+	return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+}
+//#endregion
 //#region src/i18n/state-labels.ts
+/**
+* ONE dictionary of human labels for the state words the rule editors show
+* (R7, D690).
+*
+* A device-state gate offers the words the engine compares against —
+* `armed_away`, `not_home`, `unlocking` — and both rule editors printed them
+* verbatim. The words are the WIRE vocabulary and must stay what they are (a
+* rule stores them); what the operator reads is a label, and two editors that
+* each translate on their own are two editors that disagree. Both the admin UI
+* and the viewer resolve through {@link stateLabel}.
+*
+* Keys are the raw values themselves, flat: the vocabularies are disjoint where
+* they differ and agree where they overlap (`open` is the same word on a cover
+* and on a contact). An OPEN vocabulary (a presence zone the operator named,
+* a cover state a new integration invents) falls back to the raw word — never
+* an exception, never an empty chip.
+*
+* Covered, and held to their sources by the spec: the alarm panel's states,
+* the cover's, the lock's, the boolean readers' words
+* (`DEVICE_STATE_READERS`), presence's canonical `home`/`not_home`, and the
+* scene gate's verdicts and read modes.
+*/
 /** Every key the dictionary answers for, in a stable order. */
 var STATE_LABEL_KEYS = [
 	"disarmed",
@@ -32193,7 +32227,7 @@ function isStateLabelKey(key) {
 * dictionary does not know it. Never throws.
 */
 function stateLabel(key, locale) {
-	return isStateLabelKey(key) ? STATE_LABELS[key][locale] : key;
+	return isStateLabelKey(key) ? STATE_LABELS[key][locale] : humanizeId(key);
 }
 //#endregion
 //#region src/notification/timelapse-rule.ts

package/dist/client.mjs

@@ -32031,7 +32031,41 @@ function packagePickerItems(packages) {
 	return [...pinned, ...addons];
 }
 //#endregion
+//#region src/i18n/humanize-id.ts
+/**
+* Make a raw wire id readable when no dictionary knows it: `delivery_truck`
+* becomes "Delivery truck", `open-door` becomes "Open door". It invents no
+* translation — the words stay the id's own, only separators and the first
+* letter change. An empty id stays empty.
+*/
+function humanizeId(id) {
+	const spaced = id.replace(/[_-]+/g, " ").replace(/\s+/g, " ").trim();
+	return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+}
+//#endregion
 //#region src/i18n/state-labels.ts
+/**
+* ONE dictionary of human labels for the state words the rule editors show
+* (R7, D690).
+*
+* A device-state gate offers the words the engine compares against —
+* `armed_away`, `not_home`, `unlocking` — and both rule editors printed them
+* verbatim. The words are the WIRE vocabulary and must stay what they are (a
+* rule stores them); what the operator reads is a label, and two editors that
+* each translate on their own are two editors that disagree. Both the admin UI
+* and the viewer resolve through {@link stateLabel}.
+*
+* Keys are the raw values themselves, flat: the vocabularies are disjoint where
+* they differ and agree where they overlap (`open` is the same word on a cover
+* and on a contact). An OPEN vocabulary (a presence zone the operator named,
+* a cover state a new integration invents) falls back to the raw word — never
+* an exception, never an empty chip.
+*
+* Covered, and held to their sources by the spec: the alarm panel's states,
+* the cover's, the lock's, the boolean readers' words
+* (`DEVICE_STATE_READERS`), presence's canonical `home`/`not_home`, and the
+* scene gate's verdicts and read modes.
+*/
 /** Every key the dictionary answers for, in a stable order. */
 var STATE_LABEL_KEYS = [
 	"disarmed",
@@ -32192,7 +32226,7 @@ function isStateLabelKey(key) {
 * dictionary does not know it. Never throws.
 */
 function stateLabel(key, locale) {
-	return isStateLabelKey(key) ? STATE_LABELS[key][locale] : key;
+	return isStateLabelKey(key) ? STATE_LABELS[key][locale] : humanizeId(key);
 }
 //#endregion
 //#region src/notification/timelapse-rule.ts

package/dist/i18n/humanize-id.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Make a raw wire id readable when no dictionary knows it: `delivery_truck`
+ * becomes "Delivery truck", `open-door` becomes "Open door". It invents no
+ * translation — the words stay the id's own, only separators and the first
+ * letter change. An empty id stays empty.
+ */
+export declare function humanizeId(id: string): string;

package/dist/index.js

@@ -113507,7 +113507,41 @@ function packagePickerItems(packages) {
 	return [...pinned, ...addons];
 }
 //#endregion
+//#region src/i18n/humanize-id.ts
+/**
+* Make a raw wire id readable when no dictionary knows it: `delivery_truck`
+* becomes "Delivery truck", `open-door` becomes "Open door". It invents no
+* translation — the words stay the id's own, only separators and the first
+* letter change. An empty id stays empty.
+*/
+function humanizeId(id) {
+	const spaced = id.replace(/[_-]+/g, " ").replace(/\s+/g, " ").trim();
+	return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+}
+//#endregion
 //#region src/i18n/state-labels.ts
+/**
+* ONE dictionary of human labels for the state words the rule editors show
+* (R7, D690).
+*
+* A device-state gate offers the words the engine compares against —
+* `armed_away`, `not_home`, `unlocking` — and both rule editors printed them
+* verbatim. The words are the WIRE vocabulary and must stay what they are (a
+* rule stores them); what the operator reads is a label, and two editors that
+* each translate on their own are two editors that disagree. Both the admin UI
+* and the viewer resolve through {@link stateLabel}.
+*
+* Keys are the raw values themselves, flat: the vocabularies are disjoint where
+* they differ and agree where they overlap (`open` is the same word on a cover
+* and on a contact). An OPEN vocabulary (a presence zone the operator named,
+* a cover state a new integration invents) falls back to the raw word — never
+* an exception, never an empty chip.
+*
+* Covered, and held to their sources by the spec: the alarm panel's states,
+* the cover's, the lock's, the boolean readers' words
+* (`DEVICE_STATE_READERS`), presence's canonical `home`/`not_home`, and the
+* scene gate's verdicts and read modes.
+*/
 /** Every key the dictionary answers for, in a stable order. */
 var STATE_LABEL_KEYS = [
 	"disarmed",
@@ -113668,11 +113702,23 @@ function isStateLabelKey(key) {
 * dictionary does not know it. Never throws.
 */
 function stateLabel(key, locale) {
-	return isStateLabelKey(key) ? STATE_LABELS[key][locale] : key;
+	return isStateLabelKey(key) ? STATE_LABELS[key][locale] : humanizeId(key);
 }
 //#endregion
 //#region src/i18n/event-kind-labels.ts
 /**
+* ONE dictionary of human labels for event kinds (detection macros/subs,
+* sensors, audio macros, …) — the same vocabulary the viewer filters and the
+* notification centre speak (R7).
+*
+* Wire ids stay raw (`cat`, `animal`, `audio-dog`). What a human reads is a
+* label, and a surface that translates on its own is a surface that disagrees
+* with the next one. Admin UI, viewer and NC resolve through {@link eventKindLabel}.
+*
+* Keys match {@link EVENT_TAXONOMY}. An OPEN kind (a custom model class) falls
+* back to the raw word — never an exception, never an empty chip.
+*/
+/**
 * Every kind the dictionary answers for. Order is stable; the set is held to
 * {@link EVENT_TAXONOMY} by the spec.
 */
@@ -114042,7 +114088,7 @@ function isEventKindLabelKey(key) {
 */
 function eventKindLabel(kind, locale) {
 	const key = kind.trim().toLowerCase();
-	return isEventKindLabelKey(key) ? EVENT_KIND_LABELS[key][locale] : kind;
+	return isEventKindLabelKey(key) ? EVENT_KIND_LABELS[key][locale] : humanizeId(kind);
 }
 //#endregion
 //#region src/i18n/translation.ts

package/dist/index.mjs

@@ -113506,7 +113506,41 @@ function packagePickerItems(packages) {
 	return [...pinned, ...addons];
 }
 //#endregion
+//#region src/i18n/humanize-id.ts
+/**
+* Make a raw wire id readable when no dictionary knows it: `delivery_truck`
+* becomes "Delivery truck", `open-door` becomes "Open door". It invents no
+* translation — the words stay the id's own, only separators and the first
+* letter change. An empty id stays empty.
+*/
+function humanizeId(id) {
+	const spaced = id.replace(/[_-]+/g, " ").replace(/\s+/g, " ").trim();
+	return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+}
+//#endregion
 //#region src/i18n/state-labels.ts
+/**
+* ONE dictionary of human labels for the state words the rule editors show
+* (R7, D690).
+*
+* A device-state gate offers the words the engine compares against —
+* `armed_away`, `not_home`, `unlocking` — and both rule editors printed them
+* verbatim. The words are the WIRE vocabulary and must stay what they are (a
+* rule stores them); what the operator reads is a label, and two editors that
+* each translate on their own are two editors that disagree. Both the admin UI
+* and the viewer resolve through {@link stateLabel}.
+*
+* Keys are the raw values themselves, flat: the vocabularies are disjoint where
+* they differ and agree where they overlap (`open` is the same word on a cover
+* and on a contact). An OPEN vocabulary (a presence zone the operator named,
+* a cover state a new integration invents) falls back to the raw word — never
+* an exception, never an empty chip.
+*
+* Covered, and held to their sources by the spec: the alarm panel's states,
+* the cover's, the lock's, the boolean readers' words
+* (`DEVICE_STATE_READERS`), presence's canonical `home`/`not_home`, and the
+* scene gate's verdicts and read modes.
+*/
 /** Every key the dictionary answers for, in a stable order. */
 var STATE_LABEL_KEYS = [
 	"disarmed",
@@ -113667,11 +113701,23 @@ function isStateLabelKey(key) {
 * dictionary does not know it. Never throws.
 */
 function stateLabel(key, locale) {
-	return isStateLabelKey(key) ? STATE_LABELS[key][locale] : key;
+	return isStateLabelKey(key) ? STATE_LABELS[key][locale] : humanizeId(key);
 }
 //#endregion
 //#region src/i18n/event-kind-labels.ts
 /**
+* ONE dictionary of human labels for event kinds (detection macros/subs,
+* sensors, audio macros, …) — the same vocabulary the viewer filters and the
+* notification centre speak (R7).
+*
+* Wire ids stay raw (`cat`, `animal`, `audio-dog`). What a human reads is a
+* label, and a surface that translates on its own is a surface that disagrees
+* with the next one. Admin UI, viewer and NC resolve through {@link eventKindLabel}.
+*
+* Keys match {@link EVENT_TAXONOMY}. An OPEN kind (a custom model class) falls
+* back to the raw word — never an exception, never an empty chip.
+*/
+/**
 * Every kind the dictionary answers for. Order is stable; the set is held to
 * {@link EVENT_TAXONOMY} by the spec.
 */
@@ -114041,7 +114087,7 @@ function isEventKindLabelKey(key) {
 */
 function eventKindLabel(kind, locale) {
 	const key = kind.trim().toLowerCase();
-	return isEventKindLabelKey(key) ? EVENT_KIND_LABELS[key][locale] : kind;
+	return isEventKindLabelKey(key) ? EVENT_KIND_LABELS[key][locale] : humanizeId(kind);
 }
 //#endregion
 //#region src/i18n/translation.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.432",
+  "version": "1.2.433",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",