iobroker.alias-workbench 0.10.0 → 0.12.0

package/admin/js/werte.js

@@ -15,14 +15,17 @@ import './entwurf.js';
 /* MQTT uebernimmt die Schreibweise des Themas. Dasselbe Geraetemodell
    meldet mal cmnd.POWER1, mal cmnd.power1 — deshalb erst genau suchen,
    dann ohne Ruecksicht auf Gross- und Kleinschreibung. */
+/* Die Namen kommen aus `geraetePunkte`, nicht aus dem Pfad: bei einem
+   zerlegten MQTT-Geraet liegen die Punkte in Geschwisterzweigen, heissen
+   relativ aber genauso wie bei der anderen Bauform. Damit findet
+   `hatPunkt('cmnd.POWER')` sie in beiden Faellen — und die
+   Geraetevorlagen, die nur relativ adressieren, brauchen nichts davon zu
+   wissen. */
 export function kleinKarte(kanal) {
   if (S.kleinIndex[kanal]) { return S.kleinIndex[kanal]; }
   var karte = {};
-  var pre = kanal + '.';
-  S.keysSorted.forEach(function (k) {
-    if (k.indexOf(pre) !== 0) { return; }
-    if (!S.objects[k] || S.objects[k].type !== 'state') { return; }
-    karte[k.slice(pre.length).toLowerCase()] = k;
+  geraetePunkte(kanal).forEach(function (p) {
+    karte[p.rel.toLowerCase()] = p.id;
   });
   S.kleinIndex[kanal] = karte;
   return karte;
@@ -101,6 +104,292 @@ export function direkteZustaende(kanal) {
   return kindZustaende(kanal).filter(function (k) { return k.slice(pre.length).indexOf('.') === -1; });
 }
 
+/* ---- Werteliste: Anfang (test/vorpruefung.js schneidet hier) ----
+
+   `common.states` ist eine Karte Wert → Text: `{"0":"CLOSED","1":"OPEN"}`.
+   In der Oberflaeche steht sie als eine Zeile je Eintrag, `wert = text`,
+   weil neun Eintraege (HmIP-Ventilzustand) in kein einzeiliges Feld
+   passen.
+
+   Beim Lesen wird grosszuegig verfahren, beim Schreiben streng: ein `=`
+   trennt, Leerraum aussen faellt weg, leere Zeilen werden uebergangen.
+   Ein Schluessel ohne Text ist keiner — sonst entstuende `{"0":""}`, und
+   der Admin zeigte ein leeres Auswahlfeld. */
+export function statesText(states) {
+  if (!states || typeof states !== 'object') { return ''; }
+  return Object.keys(states).map(function (k) { return k + ' = ' + states[k]; }).join('\n');
+}
+
+export function textStates(text) {
+  var raus = {};
+  var leer = true;
+  String(text === null || text === undefined ? '' : text).split('\n').forEach(function (z) {
+    var i = z.indexOf('=');
+    if (i < 0) { return; }
+    var k = z.slice(0, i).trim();
+    var t = z.slice(i + 1).trim();
+    if (!k || !t) { return; }
+    raus[k] = t;
+    leer = false;
+  });
+  /* Nichts drin heisst: keine Werteliste. `undefined`, nicht `{}` —
+     ein leeres Objekt wuerde geschrieben und ergaebe am Alias eine
+     Auswahlliste ohne Eintraege. */
+  return leer ? undefined : raus;
+}
+
+/* Zwei Wertelisten vergleichen — fuer die Abweichungsanzeige. */
+export function statesGleich(a, b) {
+  var ka = a ? Object.keys(a) : [];
+  var kb = b ? Object.keys(b) : [];
+  if (ka.length !== kb.length) { return false; }
+  return ka.every(function (k) { return String(a[k]) === String(b ? b[k] : undefined); });
+}
+/* ---- Werteliste: Ende ---- */
+
+/* ---- Geraetepunkte: Anfang (test/vorpruefung.js schneidet hier) ----
+
+/* ================== Ein Geraet, auch wenn es in Zweigen liegt ==================
+
+   Tasmotas `FullTopic` bestimmt, in welcher Reihenfolge Praefix (cmnd,
+   stat, tele) und Geraetename im Thema stehen — und weil mqtt und
+   mqtt-client das Thema eins zu eins auf den Objektpfad abbilden,
+   bestimmt es auch den Bau des Objektbaums:
+
+     %topic%/%prefix%/   →  …Bastelzimmer_Licht.tele.STATE     ein Knoten
+     %prefix%/%topic%/   →  …SmartHome_Test.tele.Weihnachten_aussen.STATE
+                            …SmartHome_Test.stat.Weihnachten_aussen.POWER
+                            …SmartHome_Test.cmnd.Weihnachten_aussen.POWER
+
+   Die zweite Form ist Tasmotas Werkseinstellung. Dort gibt es keinen
+   Knoten, unter dem das Geraet als Ganzes steht: es liegt in zwei bis
+   drei Geschwisterzweigen, die nur der gleichlautende Namensteil in der
+   Mitte verbindet.
+
+   Diese Funktion beantwortet als einzige Stelle, welche Punkte zu einem
+   Geraet gehoeren und wie sie relativ heissen. Beide Formen ergeben
+   dieselben relativen Namen (`tele.STATE`, `cmnd.POWER`) — und damit
+   greifen die Geraetevorlagen unveraendert, denn sie adressieren nur
+   relativ. Gemessen am 30.09.2026 an einem umgestellten Tasmota
+   (Weihnachten_aussen): vorher fand `mqttGeraet()` am Geraeteknoten
+   nichts und legte am Knoten darueber `…SmartHome_Test.cmnd.POWER` an —
+   eine Kennung ohne Geraeteebene, die sich das zweite Geraet am selben
+   Praefix mit dem ersten geteilt haette. */
+
+/* Praefixe, wie Tasmota sie ab Werk vergibt. Nur als Saatkorn fuer den
+   Fall, dass erst ein einziger Zweig da ist: sie lassen sich am Geraet
+   umbenennen (Prefix1-3), deshalb entscheidet zuerst der Bau des Baums
+   und erst danach diese Liste. */
+var TASMOTA_PRAEFIX = /^(cmnd|stat|tele)$/i;
+
+/* Das MQTT-Thema eines Punktes. Dieselbe Ablesung wie `mqttEinstellung`,
+   hier noch einmal in Kurzform: mqtt.js importiert dieses Modul, der
+   umgekehrte Weg ergaebe einen Ring. Gebraucht wird hier nur das Thema,
+   nicht die Frage, ob gesendet werden darf. */
+function themaVon(id) {
+  var o = S.objects[id];
+  if (!o || !o.common) { return ''; }
+  var cu = o.common.custom || {};
+  var t = '';
+  Object.keys(cu).forEach(function (x) {
+    if (!t && /^mqtt/.test(x) && cu[x] && cu[x].topic) { t = cu[x].topic; }
+  });
+  return t || ((o.native || {}).topic || '');
+}
+
+/* Die Punkte unmittelbar unterhalb eines Knotens, mit ihrem relativen
+   Namen. */
+function eigenePunkte(kanal) {
+  var pre = kanal + '.';
+  var raus = [];
+  mitVorspann(pre).forEach(function (k) {
+    if (!S.objects[k] || S.objects[k].type !== 'state') { return; }
+    raus.push({ id: k, rel: k.slice(pre.length) });
+  });
+  return raus;
+}
+
+/* Steht `[praefix, ...geraetPfad]` im Thema unmittelbar vor dem
+   Datenpunkt? Das ist der Beleg dafuer, dass die Ebene ueber dem Geraet
+   wirklich ein Praefix ist und nicht bloss ein Ordner.
+
+   Ohne diese Pruefung wuerde die Zusammenfassung auch dort greifen, wo
+   nichts zusammengehoert: `hm-rpc.0.ABC123.1` und `hm-rpc.0.DEF456.1`
+   sehen im Baum genauso aus wie zwei Praefixzweige desselben Geraets.
+   Homematic-Punkte tragen aber kein Thema, und damit ist die Frage
+   entschieden, bevor sie gestellt wird. */
+function themaPasst(punkte, praefix, geraetPfad) {
+  var muster = [praefix].concat(geraetPfad);
+  return punkte.length > 0 && punkte.every(function (pt) {
+    var t = themaVon(pt.id);
+    if (!t) { return false; }
+    var tt = t.split('/');
+    var ab = tt.length - 1 - muster.length;
+    if (ab < 0) { return false; }
+    /* Der letzte Teil des Themas ist der Datenpunkt. Bei mqtt-client ist
+       das genau eine Ebene; liegt im Objektbaum mehr darunter, passt die
+       Form nicht und wir fassen nichts zusammen. */
+    if (tt[tt.length - 1] !== pt.rel) { return false; }
+    for (var i = 0; i < muster.length; i++) {
+      if (tt[ab + i] !== muster[i]) { return false; }
+    }
+    return true;
+  });
+}
+
+/* Alle Zweige unter `eltern`, die denselben Geraetepfad tragen, je
+   Praefix gesammelt. */
+function zweigePunkte(eltern, geraetPfad) {
+  var pre = eltern + '.';
+  var n = geraetPfad.length;
+  var schwanz = geraetPfad.join('.');
+  var raus = {};
+  mitVorspann(pre).forEach(function (k) {
+    if (!S.objects[k] || S.objects[k].type !== 'state') { return; }
+    var rest = k.slice(pre.length).split('.');
+    if (rest.length < n + 2) { return; }
+    if (rest.slice(1, 1 + n).join('.') !== schwanz) { return; }
+    var x = rest[0];
+    var punkt = rest.slice(1 + n).join('.');
+    (raus[x] = raus[x] || []).push({ id: k, rel: punkt });
+  });
+  return raus;
+}
+
+/* Liegt dieses Geraet zerlegt in mehreren Praefixzweigen? Dann die
+   Punkte aller Zweige mit ihrem zusammengesetzten Namen. */
+function zerlegtesGeraet(kanal) {
+  var eigene = eigenePunkte(kanal);
+  if (!eigene.length) { return null; }
+  /* Liegt unter dem Knoten noch eine Ebene, ist er selbst schon das
+     Geraet (Form „Geraet zuerst") — da gibt es nichts einzusammeln. */
+  if (eigene.some(function (p) { return p.rel.indexOf('.') > -1; })) { return null; }
+
+  var teile = kanal.split('.');
+  /* Das Praefix muss nicht unmittelbar ueber dem Geraet sitzen:
+     `tele/haus/og/lampe/STATE` ist ein gueltiges FullTopic. Also jede
+     Ebene daraufhin ansehen — und unter den moeglichen die richtige
+     waehlen, nicht die erstbeste. */
+  var kandidaten = [];
+  for (var p = 2; p <= teile.length - 2; p++) {
+    var praefix = teile[p];
+    var geraetPfad = teile.slice(p + 1);
+    var eltern = teile.slice(0, p).join('.');
+    /* Ein Werksname im Geraetepfad heisst: hier ist etwas verrutscht.
+       Wer im Baum den Praefixknoten selbst anklickt
+       (`…Bastelzimmer_Licht.tele`), bekaeme sonst `geraetPfad = ['tele']`
+       und als „Zweige" alle Geraete des Raums — `3D_Drucker`,
+       `Bastelzimmer_Licht`, `Steckdosenleiste_Drucker` sehen von dort aus
+       aus wie Praefixe. Der Entwurf haette dann die Punkte eines halben
+       Zimmers in einem Geraet. Ein Geraet heisst nicht cmnd, stat oder
+       tele. */
+    if (geraetPfad.some(function (x) { return TASMOTA_PRAEFIX.test(x); })) { continue; }
+    if (!themaPasst(eigene, praefix, geraetPfad)) { continue; }
+    var zweige = zweigePunkte(eltern, geraetPfad);
+    var namen = Object.keys(zweige).filter(function (x) {
+      return themaPasst(zweige[x], x, geraetPfad);
+    });
+    if (!namen.length) { continue; }
+    kandidaten.push({ praefix: praefix, geraetPfad: geraetPfad, eltern: eltern,
+                      zweige: zweige, namen: namen });
+  }
+  if (!kandidaten.length) { return null; }
+
+  /* Zuerst die Werksnamen. Sie entscheiden, sobald einer passt — und das
+     tun sie fast immer, denn `cmnd/stat/tele` aendert kaum jemand.
+
+     Ohne diesen Vorrang griff am 30.09.2026 die falsche Ebene: das
+     umgestellte Weihnachtsgeraet lag noch als Leiche unter seiner alten
+     Wurzel, `…SmartHome.tele.Weihnachten_aussen` und
+     `…SmartHome_Test.tele.Weihnachten_aussen` enden gleich, und damit
+     galten die beiden Themenwurzeln als Praefixzweige eines Geraets.
+     Gemessen kam `basis: "tele/Weihnachten_aussen"` heraus und ein
+     Sendepunkt haette `mqtt-client.0.cmnd.tele.…` heissen sollen. */
+  var gewaehlt = null;
+  kandidaten.forEach(function (k) {
+    if (!gewaehlt && TASMOTA_PRAEFIX.test(k.praefix)) { gewaehlt = k; }
+  });
+
+  /* Und sonst gar nichts.
+
+     Hier stand bis zum 02.10.2026 ein struktureller Rueckfall: zwei
+     Zweige mit demselben Geraetepfad darunter, die noch ein zweites
+     Geraet teilen, galten auch ohne Werksnamen als Praefixe. Gedacht war
+     er fuer umbenannte `Prefix1-3`.
+
+     Am Produktivbestand gemessen hat er 50 Knoten falsch zusammengefasst
+     — durchweg Victron und Wechselrichter, keine einzige Tasmota:
+     `…system.0.Ac.Grid.L1` hat zwei eigene Punkte (Current, Power), der
+     Entwurf bekam **achtzehn**, naemlich die L1-Phase von Grid, Genset,
+     Consumption, PvOnGrid und allen uebrigen in einem Geraet. `Grid`
+     galt als Praefix, weil die Nachbarzweige ebenfalls ein `L1` fuehren
+     und das Thema dazu passt.
+
+     Die Regel laesst sich nicht so verschaerfen, dass sie Victron
+     aussperrt und umbenannte Tasmota-Praefixe einlaesst — beide sehen im
+     Baum gleich aus. Also entscheidet nur, was belegt ist: die
+     Werksnamen. Wer seine Praefixe umbenannt hat, bekommt die
+     Zusammenfassung nicht; das ist derselbe Stand wie vorher und nimmt
+     niemandem etwas weg, der sie schon hatte. */
+  if (!gewaehlt) { return null; }
+
+  var raus = [];
+  gewaehlt.namen.forEach(function (x) {
+    gewaehlt.zweige[x].forEach(function (pt) { raus.push({ id: pt.id, rel: x + '.' + pt.rel }); });
+  });
+  raus.sort(function (a, b) { return ZEILEN_VERGLEICH.compare(a.rel, b.rel); });
+  return { punkte: raus, eltern: gewaehlt.eltern, geraetPfad: gewaehlt.geraetPfad };
+}
+
+
+/* Punkte und Bauform in einem, je Knoten einmal gerechnet. */
+function geraeteBild(kanal) {
+  if (S.geraeteIndex[kanal]) { return S.geraeteIndex[kanal]; }
+  var bild = zerlegtesGeraet(kanal);
+  if (!bild) {
+    var pre = kanal + '.';
+    bild = {
+      punkte: kindZustaende(kanal).map(function (id) {
+        return { id: id, rel: id.slice(pre.length) };
+      }),
+      eltern: null, geraetPfad: null
+    };
+  }
+  S.geraeteIndex[kanal] = bild;
+  return bild;
+}
+
+/* Die Punkte eines Geraets mit ihrem relativen Namen — egal, in welcher
+   Form der Adapter sie abgelegt hat. */
+export function geraetePunkte(kanal) {
+  return geraeteBild(kanal).punkte;
+}
+
+/* Liegt dieses Geraet zerlegt vor? Fuer die Stellen, die es sagen
+   wollen, statt es nur stillschweigend zu koennen. */
+export function istZerlegt(kanal) {
+  return !!geraeteBild(kanal).eltern;
+}
+
+/* Welche Kennung haette ein Punkt mit diesem relativen Namen an diesem
+   Geraet — auch wenn es ihn noch nicht gibt?
+
+   Genau daran scheiterte das Anlegen: `kanal + '.cmnd.' + name` traf bei
+   der zerlegten Form neben das Geraet. Zwei Tasmotas unter demselben
+   Praefix bekamen dieselbe Kennung, die zweite haette die erste samt
+   ihrem Thema ueberschrieben. */
+export function punktKennung(kanal, rel) {
+  var bild = geraeteBild(kanal);
+  if (!bild.eltern) { return kanal + '.' + rel; }
+  var t = String(rel).split('.');
+  if (t.length < 2) { return kanal + '.' + rel; }
+  var praefix = t[0];
+  var punkt = t.slice(1).join('.');
+  return bild.eltern + '.' + praefix + '.' + bild.geraetPfad.join('.') + '.' + punkt;
+}
+
+/* ---- Geraetepunkte: Ende ---- */
+
 /* Wohin schreibt dieser Aliaspunkt?
 
    Fuenfmal woertlich gleich ausprogrammiert gewesen — dreimal in

package/admin/js/zielleiste.js

@@ -11,7 +11,7 @@ import { el } from './basis.js';
 import { tr } from './sprache.js';
 import { enumListe } from './aufzaehlungen.js';
 import { enumZeile, setzeZiel } from './zuordnung.js';
-import { aliasFuer, ausgangsQuellen, ordnerUnterAlias, kennungtauglich, knotenDa } from './entwurf.js';
+import { aliasFuer, ausgangsQuellen, ordnerUnterAlias, kennungtauglich, knotenDa, ohneUmlaute } from './entwurf.js';
 import { zeichneErgebnis, entwurfAngefasst, angebotFrisch } from './ergebnis.js';
 import { zeigeVerlegen } from './schreiben.js';
 
@@ -63,6 +63,7 @@ export function baueZielleiste(host, e) {
       iO.value = '';
       S.fokusOrdnerfeld = true;
       e.zielOrdner = 'alias.0';
+      e.ordnerRoh = '';
       e.ordnerVonHand = true;
       e.zuletzt = 'ordner';
       entwurfAngefasst();
@@ -76,16 +77,21 @@ export function baueZielleiste(host, e) {
     zb.appendChild(wrap);
 
     var saeubern = function (t) {
-      return String(t).trim()
-        .replace(/[^\w.\- äöüÄÖÜß]/g, '_')
+      return ohneUmlaute(t).trim()
+        .replace(/[^\w.\- ]/g, '_')
         .replace(/\s+/g, '_')
         .replace(/\.{2,}/g, '.')
         .replace(/^\.+|\.+$/g, '');
     };
     var uebernehmen = function () {
-      var t = saeubern(iO.value);
+      /* Der Ordner ist eine Kennung, der Raum nicht. „Küche" wird als
+         Ablageort zu Kueche, als Raumvorschlag bleibt es Küche. */
+      var roh = String(iO.value || '').trim();
+      var t = saeubern(roh);
       var neuerOrdner = t ? ('alias.0.' + t) : 'alias.0';
-      if (neuerOrdner === e.zielOrdner) { return; }
+      var rohNeu = (roh && roh.indexOf('.') === -1) ? roh : '';
+      if (neuerOrdner === e.zielOrdner && rohNeu === (e.ordnerRoh || '')) { return; }
+      e.ordnerRoh = rohNeu;
       e.zielOrdner = neuerOrdner;
       /* Ab jetzt gehoert der Ordner dem Nutzer - der Raum schreibt ihn
          nicht mehr um. Angeboten wird die Uebernahme trotzdem, aber in
@@ -328,17 +334,20 @@ export function baueZielleiste(host, e) {
     if (e.zuletzt === 'ordner') {
       var otx = String(e.zielOrdner || '').slice('alias.0.'.length);
       if (otx && otx.indexOf('.') === -1) {
+        /* Getippt wurde vielleicht „Küche", in der Kennung steht
+           Kueche. Der Raum bekommt den getippten Namen. */
+        var nameFuerRaum = e.ordnerRoh || otx;
         var vorhandenerRaum = enumListe('rooms', true).filter(function (r) {
-          return r.name.toLowerCase() === otx.toLowerCase() ||
-                 r.kurz.toLowerCase() === otx.toLowerCase();
+          return r.name.toLowerCase() === nameFuerRaum.toLowerCase() ||
+                 r.kurz.toLowerCase() === nameFuerRaum.toLowerCase();
         })[0];
-        var raumId = vorhandenerRaum ? vorhandenerRaum.id : ('enum.rooms.' + otx);
+        var raumId = vorhandenerRaum ? vorhandenerRaum.id : ('enum.rooms.' + nameFuerRaum);
         if (raumId !== e.raum) {
           var az = el('div', 'uebernahme' +
             (angebotFrisch('ordner:' + raumId) ? ' frisch' : ''));
           az.appendChild(el('span', 'zq', vorhandenerRaum
-            ? tr('target.alsoRoom', otx)
-            : tr('target.alsoRoomNew', otx)));
+            ? tr('target.alsoRoom', nameFuerRaum)
+            : tr('target.alsoRoomNew', nameFuerRaum)));
           var ab = el('button', 'btn mini wichtig', tr('target.yes'));
           ab.addEventListener('click', function () {
             e.raum = raumId;

package/admin/js/zuordnung.js

@@ -17,7 +17,7 @@ import { enumVorlagen, katalogFehlt, ikonCache, ikonErlaubt, ikonNachtrag,
 import { kindZustaende, aliasQuellen, holeEinzelne,
          zeileAusAlias } from './werte.js';
 import { aliasFuer, ausgangsQuellen, zielId, knotenDa,
-         aboErgaenzen, quellenVonEntwurf } from './entwurf.js';
+         kennungtauglich, aboErgaenzen, quellenVonEntwurf } from './entwurf.js';
 import { zeichneErgebnis, entwurfAngefasst, angebotFrisch } from './ergebnis.js';
 
 
@@ -452,11 +452,12 @@ export function setzeEnums(e) {
   }
 }
 
-/* Der Name einer Aufzaehlung, so wie er als Ordner taugen wuerde.
+/* Der Name einer Aufzaehlung, so wie er als Ordner unter alias.0 taugt.
 
-   Ein Ordner unter `alias.0` darf keine Punkte enthalten - sie wuerden
-   eine weitere Ebene aufmachen. Alles andere bleibt, wie der Nutzer es
-   kennt: „Wohnkueche“ heisst auch im Pfad „Wohnkueche“. */
+   Dieselbe Regel wie beim Alias-Namen: kennungtauglich. Umlaute werden
+   zu ae, oe, ue und ss, ein Punkt wuerde sonst eine weitere Ebene
+   aufmachen. Der Raum bleibt „Wohnküche“, der Ordner heisst
+   „Wohnkueche“. */
 export function enumAlsOrdner(id) {
   if (!id) { return ''; }
   var o = enums[id];
@@ -468,7 +469,7 @@ export function enumAlsOrdner(id) {
     n = v ? (txt(v.name) || '') : '';
   }
   if (!n) { n = id.split('.').pop(); }
-  return String(n).replace(/\./g, '_').trim();
+  return kennungtauglich(n);
 }
 
 export function setzeZiel(e) {
@@ -862,7 +863,7 @@ export function unterschiede(e) {
   var aliasDa = knotenDa(zielBasis);
 
   e.states.forEach(function (s) {
-    if (s.manuell) { raus.push({ n: s.n || '(ohne Namen)', was: tr('diff.newByHand') }); return; }
+    if (s.manuell) { raus.push({ n: s.n || tr('diff.noName'), was: tr('diff.newByHand') }); return; }
 
     var imAlias = !!S.objects[zielBasis + '.' + s.n];
     var grundlinieAn = aliasDa ? imAlias : warVorgabeAn(s);

package/admin/js/zustand.js

@@ -14,6 +14,10 @@ export var S = {
   objects: {},
   keysSorted: [],
   kleinIndex: {},
+  /* Je Knoten die Punkte des Geraets samt relativem Namen — bei
+     zerlegten MQTT-Geraeten aus mehreren Zweigen zusammengetragen.
+     Verfaellt zusammen mit `kleinIndex`. */
+  geraeteIndex: {},
   /* Zaehlt jede Aenderung an S.objects. Wer sich etwas aus den Objekten
      merkt (die Karte Quelle -> Alias in entwurf.js), vergleicht hiermit
      statt mit der Zahl der Schluessel — beim Verlegen verschwinden genau
@@ -24,6 +28,25 @@ export var S = {
   aliasKaputt: {},
   werte: {},
   current: null,
+  /* Mehrere Zweige als EIN Geraet.
+
+     Manche Adapter verteilen ein Geraet auf Geschwisterzweige: Matter
+     legt eine Steckdose als Ordner mit zwei `device` darunter ab - der
+     Schalter in `OnOffPlugInUnit-1`, die Messwerte in
+     `ElectricalSensor-2` (gemessen am Produktivsystem 13.10.2026). Der
+     Ordner selbst traegt keine Datenpunkte und ist damit nicht
+     waehlbar, und jeder Endpoint einzeln ergibt ein halbes Geraet.
+
+     `S.current` bleibt EIN Knoten - hier der gemeinsame Elternknoten -,
+     und `S.zweige` sagt, welche seiner Zweige dazugehoeren. `null`
+     heisst „alle", also genau das bisherige Verhalten. Eine Liste
+     daraus zu machen haette `S.current` an 91 Stellen beruehrt, ohne
+     dass irgendeine davon besser geworden waere.
+
+     Die Auswahl ist fluechtig: sie ueberlebt keinen Seitenneustart. */
+  zweige: null,
+  /* Einmalige Rueckmeldung aus dem Baum an die rechte Seite. */
+  zweigMeldung: '',
   openRow: null,
   entwurf: null,
   baum: null,
@@ -46,6 +69,15 @@ export var S = {
   tauschPlan: null,
   tauschWeg: {},
   tauschFilter: '',
+  /* Fuer welches Ziel die Werte schon geholt sind - Stufe 5 braucht sie. */
+  tauschWerte: null,
+  /* Von Hand benannte Ziele beim Tausch: Alias-Punkt -> Punkt am neuen Geraet. */
+  tauschHand: {},
+  /* Was beim Tausch mit einer gewechselten Einheit geschehen soll:
+     Alias-Punkt -> nichts | einheit | rechnen. */
+  tauschEinheit: {},
+  /* Soll der Tausch die Formeln des neuen Geraets uebernehmen? */
+  tauschMerkung: null,
   loeschListe: [],
   loeschZiel: null,
   loeschAlleAusgaenge: false,

package/admin/js/zustandsliste.js

@@ -8,7 +8,7 @@
 
 import { S } from './zustand.js';
 import { el, $ } from './basis.js';
-import { tr } from './sprache.js';
+import { tr, sprachtext } from './sprache.js';
 import { erkenneEntwurf, musterVon, rolleVonPlatz, typKonflikte, plaetzeFuerRolle, typPasstZuPlatz, fehlendePflicht } from './erkennung.js';
 import { kindZustaende, wertVon, fmt } from './werte.js';
 import { steuerKanaele, vorlagenAbweichung, bestandsAbweichung, waehle, quelleHier, quellenVerteilung } from './entwurf.js';
@@ -505,7 +505,14 @@ export function baueListe(host, e, pl, rateKnopf, musterBlock) {
        „geaendert", „weicht ab") wurde sie damit zu voll, und Rolle und
        Wert rutschten nach rechts weg (Ricardo, 08.09.2026). Die Kennung
        traegt jetzt den Hinweis; sichtbar bleibt sie im Detail. */
-    if (s.caption && s.caption !== s.n) { n3.title = s.caption; }
+    /* Beschriftung und der Hinweis aus der Vorlage. Der Hinweis ist
+       eine Zeichenkette oder { de, en }; sprachtext nimmt die
+       eingestellte Sprache, sonst Englisch. */
+    var titel = [];
+    if (s.caption && s.caption !== s.n) { titel.push(s.caption); }
+    var zeilenHinweis = sprachtext(s.hinweis);
+    if (zeilenHinweis) { titel.push(zeilenHinweis); }
+    if (titel.length) { n3.title = titel.join('\n\n'); }
     if (s.manuell) { n3.appendChild(el('span', 'hand', tr('list.byHand'))); }
     if (s.geaendert) { n3.appendChild(el('span', 'geae', tr('list.changed'))); }
     /* Was die Vorlage anders will, steht an der Zeile - sonst sieht man

package/admin/tab.html

@@ -166,6 +166,30 @@
   <div class="dfoot"><button class="btn" data-close>Close</button></div>
 </dialog>
 
+<!-- Vor dem Ausgeben einer Attrappe: was geht in die Datei. Die Texte
+     werden zur Laufzeit gesetzt. -->
+<dialog id="dlg-mock" style="max-width:880px;width:calc(100% - 32px);">
+  <h3 id="mock-titel">Export as mock device</h3>
+  <div class="dbody" id="mock-body"></div>
+  <div class="dfoot">
+    <button class="btn" data-close>Close</button>
+    <button class="btn primary" id="btn-mock-go">Save file</button>
+  </div>
+</dialog>
+
+<!-- Eine Attrappe einlesen: was entstehen wuerde, steht vorher da. Ein
+     eigener Dialog, nicht der Trockenlauf des Alias — der verlangt
+     `alias.` als Ziel, die Attrappe landet unter 0_userdata.0. -->
+<dialog id="dlg-mockin" style="max-width:880px;width:calc(100% - 32px);">
+  <h3 id="mockin-titel">Import mock device</h3>
+  <div class="dbody" id="mockin-body"></div>
+  <div class="dfoot">
+    <button class="btn" data-close>Close</button>
+    <button class="btn primary" id="btn-mockin-go">Create now</button>
+  </div>
+</dialog>
+<input type="file" id="datei-attrappe" accept=".json,application/json" hidden>
+
 <!-- Wer im Baum weiterklickt, verlor bis zum 06.09.2026 seine Aenderungen
      ohne ein Wort (Ricardo). Der Text wird zur Laufzeit gesetzt. -->
 <dialog id="dlg-leave">

package/admin/vorlagen/hm-dimmer.json

@@ -17,7 +17,10 @@
       "1.LEVEL",
       "1.LEVEL_REAL"
     ],
-    "hinweis": "1.LEVEL_REAL ist der Unterschied zum Rollladenaktor, der ebenfalls ein 1.LEVEL hat, aber keine Ruecklesung - und zur Zentrale HM-RCV-50, die fuenfzig blanke LEVEL-Kanaele fuehrt."
+    "hinweis": {
+      "de": "1.LEVEL_REAL ist der Unterschied zum Rollladenaktor, der ebenfalls ein 1.LEVEL hat, aber keine Ruecklesung - und zur Zentrale HM-RCV-50, die fuenfzig blanke LEVEL-Kanaele fuehrt.",
+      "en": "1.LEVEL_REAL is what sets this apart from the roller-shutter actuator, which also has a 1.LEVEL but no position feedback — and from the HM-RCV-50 central unit, which carries fifty bare LEVEL channels."
+    }
   },
   "zustaende": [
     {
@@ -27,7 +30,10 @@
       "einheit": "%",
       "lesen": "1.LEVEL",
       "schreiben": "1.LEVEL",
-      "hinweis": "Die Quelle steht schon auf 0 bis 100, also keine Umrechnung noetig."
+      "hinweis": {
+        "de": "Die Quelle steht schon auf 0 bis 100, also keine Umrechnung noetig.",
+        "en": "The source is already on a 0 to 100 scale, so no conversion is needed."
+      }
     },
     {
       "name": "ACTUAL",
@@ -36,7 +42,10 @@
       "einheit": "%",
       "lesen": "1.LEVEL_REAL",
       "optional": true,
-      "hinweis": "Der tatsaechlich erreichte Wert. Waehrend einer Rampe laeuft er dem Sollwert hinterher."
+      "hinweis": {
+        "de": "Der tatsaechlich erreichte Wert. Waehrend einer Rampe laeuft er dem Sollwert hinterher.",
+        "en": "The value actually reached. During a ramp it lags behind the setpoint."
+      }
     },
     {
       "name": "WORKING",
@@ -44,7 +53,10 @@
       "typ": "boolean",
       "lesen": "1.WORKING",
       "optional": true,
-      "hinweis": "true, solange die Rampe laeuft."
+      "hinweis": {
+        "de": "true, solange die Rampe laeuft.",
+        "en": "true while the ramp is running."
+      }
     },
     {
       "name": "DIRECTION",
@@ -53,7 +65,10 @@
       "lesen": "1.DIRECTION",
       "optional": true,
       "vorgabeAus": true,
-      "hinweis": "0 steht, 1 heller, 2 dunkler, 3 unbekannt."
+      "hinweis": {
+        "de": "0 steht, 1 heller, 2 dunkler, 3 unbekannt.",
+        "en": "0 is idle, 1 brighter, 2 darker, 3 unknown."
+      }
     },
     {
       "name": "RAMP_TIME",
@@ -64,7 +79,10 @@
       "schreiben": "1.RAMP_TIME",
       "optional": true,
       "vorgabeAus": true,
-      "hinweis": "Wie lange der naechste Uebergang dauern soll. Vor dem Setzen von LEVEL schreiben."
+      "hinweis": {
+        "de": "Wie lange der naechste Uebergang dauern soll. Vor dem Setzen von LEVEL schreiben.",
+        "en": "How long the next transition should take. Write this before setting LEVEL."
+      }
     },
     {
       "name": "ON_TIME",
@@ -84,7 +102,10 @@
       "schreiben": "1.INHIBIT",
       "optional": true,
       "vorgabeAus": true,
-      "hinweis": "Sperrt den Aktor. Solange true, nimmt er keine Befehle an - auch nicht vom Taster."
+      "hinweis": {
+        "de": "Sperrt den Aktor. Solange true, nimmt er keine Befehle an - auch nicht vom Taster.",
+        "en": "Locks the actuator. While true it accepts no commands — not even from the wall switch."
+      }
     },
     {
       "name": "UNREACH",
@@ -104,7 +125,10 @@
       "lesenSonst": {
         "punkt": "0.RSSI_PEER"
       },
-      "hinweis": "RSSI_DEVICE steht zuerst: es ist der Pegel, den die Zentrale vom Geraet empfaengt. RSSI_PEER ist bei Batteriegeraeten oft unbelegt und traegt dann Grenzwerte wie -2147483648."
+      "hinweis": {
+        "de": "RSSI_DEVICE steht zuerst: es ist der Pegel, den die Zentrale vom Geraet empfaengt. RSSI_PEER ist bei Batteriegeraeten oft unbelegt und traegt dann Grenzwerte wie -2147483648.",
+        "en": "RSSI_DEVICE comes first: it is the level the central unit receives from the device. RSSI_PEER is often empty on battery devices and then carries sentinel values such as -2147483648."
+      }
     }
   ],
   "weiterePunkte": {