@feezal/feezal-element 3.0.9 → 3.0.11

package/feezal-element.js

@@ -502,6 +502,32 @@ export const publishLocalAttribute = {
     help: 'Publish page-locally instead of to the broker: the payload reaches only subscribers in THIS browser tab (dialog triggers, view switches, wiring elements together). Nothing is sent over MQTT, nothing is retained, and it works while disconnected.'
 };
 
+/**
+ * E142: shared descriptor for a dialog's editor-only `label` — spread into every
+ * dialog element's `feezal.attributes` so the wording never drifts. The element
+ * declares `label: {type: String, reflect: true}` and renders its placeholder
+ * text through `dialogPlaceholderLabel()`. Distinct from a dialog's `title`,
+ * which IS shown to the user as the heading — `label` is never rendered in the
+ * viewer; it exists purely to tell multiple dialogs apart on the canvas.
+ */
+export const dialogLabelAttribute = {
+    name: 'label',
+    type: 'string',
+    default: '',
+    help: 'Editor-only label shown on the canvas placeholder to tell multiple dialogs apart (e.g. "Dialog: Confirm delete"). Never shown in the viewer — unlike "title", which is the dialog heading users see.'
+};
+
+/**
+ * E142: editor-only placeholder text for a dialog pseudo-element. Appends the
+ * disambiguating `label` when set ("Dialog" → "Dialog: Confirm delete"), else
+ * returns the base word unchanged. Used only inside the `feezal.isEditor`
+ * placeholder branch — never in the viewer.
+ */
+export function dialogPlaceholderLabel(base, label) {
+    const l = (label || '').trim();
+    return l ? `${base}: ${l}` : base;
+}
+
 /**
  * E137 — payload comparison, cross-controller shared machinery: string
  * coercion (case-insensitive) plus boolean true/false matching the HA/z2m

package/feezal-friendly-name.js

@@ -0,0 +1,24 @@
+// Shared friendly-label normalization (U62 / E135 device-health).
+//
+// Lives in @feezal/feezal-element so BOTH the editor (discovery stamping,
+// www/src/feezal-discovery-stamp.js re-exports this) and element packages
+// (e.g. the device-health inspector building its device list) derive labels
+// the SAME way. Pure, dependency-free.
+//
+// Normalize a discovered device/entity name into a friendly, human label:
+//   1. strip a trailing Homematic channel suffix (`…:14` / `…:0` → drop only a
+//      trailing `:<digits>`, never a colon elsewhere),
+//   2. underscores → spaces, collapse whitespace runs,
+//   3. capitalize the first letter of each *all-lowercase* word — words that
+//      already carry an uppercase letter are left entirely alone, so acronyms
+//      and units survive (`kWh`, `CO2`, `WLED` unchanged; `licht` → `Licht`),
+//   4. idempotent — an already-friendly name (`Wohnzimmer Lampe`) is unchanged.
+export function friendlyName(raw) {
+    let s = String(raw ?? '').trim();
+    if (!s) return '';
+    s = s.replace(/:\d+$/, '');                 // 1. trailing HM channel suffix
+    s = s.replace(/_/g, ' ').replace(/\s+/g, ' ').trim();   // 2. underscores → spaces
+    // 3. capitalize the first letter only of words with no existing uppercase.
+    s = s.replace(/\S+/g, w => (/[A-Z]/.test(w) ? w : w.charAt(0).toUpperCase() + w.slice(1)));
+    return s;
+}

package/package.json

@@ -15,6 +15,7 @@
     "files": [
         "feezal-element.js",
         "feezal-conditions.js",
+        "feezal-friendly-name.js",
         "feezal-polymer-element.js",
         "feezal-topic-input.js",
         "LICENSE"
@@ -35,5 +36,5 @@
         "url": "git+https://github.com/feezal/feezal.git",
         "directory": "www/packages/@feezal/feezal-element"
     },
-    "version": "3.0.9"
+    "version": "3.0.11"
 }