iobroker.vis-jsontemplate 4.4.5 → 4.6.0

package/README.md

@@ -37,6 +37,7 @@ adapters in the near future.
     - [Very Important Note for use in vis / vis-2](#very-important-note-for-use-in-vis--vis-2)
     - [Curly braces in CSS and JSON](#curly-braces-in-css-and-json)
     - [Use of setInterval](#use-of-setinterval)
+    - [Developing templates with AI](#developing-templates-with-ai)
 - [Tags](#tags)
 - [Example object](#example-object)
 - [Development and Debugging](#development-and-debugging)
@@ -90,6 +91,7 @@ JSONTemplate now supports async calls with await.
 | json_oid         | Selection of the data point with the corresponding JSON data.                                                                                                                                                                                                                     |
 | json_dpCount     | Number of data points to be made available in the template.                                                                                                                                                                                                                       |
 | json_dp          | Datapoint ID to be made available.                                                                                                                                                                                                                                                |
+| json_dp_variable | Optional JavaScript variable name. The variable contains the datapoint ID; the same name with `_value` appended contains its current value.                                                                                                                                       |
 | json_scriptCount | Number of JavaScript URLs to be loaded                                                                                                                                                                                                                                            |
 | json_script[]    | JavaScript URL to be loaded. See example below.                                                                                                                                                                                                                                   |
 | json_cssCount    | Number of CSS URLs to be loaded.                                                                                                                                                                                                                                                  |
@@ -123,6 +125,15 @@ B) Indexnumber of the datapoint (the number always start with 0)
 <%- dp[Object.keys(dp)[1]] %>
 ```
 
+C) An optional variable name configured for the datapoint. For a datapoint
+`0_userdata.0.selectwrite`, variable name `dpwrite`, and value `abc`:
+
+```javascript
+<%- dpwrite %>          <!-- 0_userdata.0.selectwrite -->
+<%- dpwrite_value %>    <!-- abc -->
+<%- dp[dpwrite] %>      <!-- abc -->
+```
+
 Example output of data, widget and style in the template
 
 ```ejs
@@ -190,13 +201,13 @@ the vis widget will be overwritten with `undefined`.
 ##### Example
 
 ```text
-#w_id_<%- widgetid %> { height: 100%; display: flex; flex-direction: column; overflow: hidden; }
+#<%- widgetid %> { height: 100%; display: flex; flex-direction: column; overflow: hidden; }
 ```
 
 must be written as follows:
 
 ```text
-#w_id_<%- widgetid %> {
+#<%- widgetid %> {
     height: 100%; display: flex; flex-direction: column; overflow: hidden;
 }
 ```
@@ -211,6 +222,14 @@ can lead to unpredictable side effects. While reloading the page can resolve
 this issue, the code should not be implemented in this manner.
 As an alternative, such scenarios should be implemented using `setTimeout`.
 
+#### Developing templates with AI
+
+To simplify the process of creating templates for everyone,
+I have prepared detailed documentation including prompts and descriptions:
+
+- [English](documentation/AI-EN.md)
+- [German](documentation/KI-DE.md)
+
 ## Tags
 
 The template system works with certain tags.
@@ -401,6 +420,25 @@ Loop over the attributes of an object
   Placeholder for the next version (at the beginning of the line):
   ### **WORK IN PROGRESS**
 -->
+### 4.6.0 (2026-07-30)
+
+- some changes. see readme/below
+
+#### Changes 2026-07-30
+
+- add optional variable names to extra datapoints
+
+### 4.5.0 (2026-07-29)
+
+- some changes. see readme/below
+
+#### Changes 2026-07-29
+
+- repair widget rendering
+- add search and fullscreen to ejs-edit for vis-2 widget
+- improve ki documentation for regex expressions
+- improve vis-2 ejs edit theme for dark mode
+
 ### 4.4.5 (2026-07-22)
 
 - fix packages for vis-2
@@ -422,15 +460,6 @@ Loop over the attributes of an object
 - revert repochecker warning about fs/node:fs and path/node:path
   because of error loading ejs
 
-### 4.4.2 (2026-04-13)
-
-- fix runtime
-
-### 4.4.1 (2026-04-13)
-
-- fix regression
-- update packages
-
 [Older changelogs can be found there](CHANGELOG_OLD.md)
 
 ## License

package/io-package.json

@@ -1,8 +1,34 @@
 {
   "common": {
     "name": "vis-jsontemplate",
-    "version": "4.4.5",
+    "version": "4.6.0",
     "news": {
+      "4.6.0": {
+        "en": "- some changes. see readme/below",
+        "de": "- einige änderungen. siehe readme/unten",
+        "ru": "- некоторые изменения. см. readme/low",
+        "pt": "- algumas mudanças. ver lerme/abaixo",
+        "nl": "- wat veranderingen. zie readme/onder",
+        "fr": "- quelques changements. voir lecture/ci-dessous",
+        "it": "- qualche cambiamento. vedi readme/below",
+        "es": "- algunos cambios. ver readme/below",
+        "pl": "- kilka zmian. patrz readme / poniżej",
+        "uk": "- деякі зміни. переглянути файл",
+        "zh-cn": "- 一些变化。 见readme/以下"
+      },
+      "4.5.0": {
+        "en": "- some changes. see readme/below\n\n#### Changes 2026-07-29\n\n- repair widget rendering\n- add search and fullscreen to ejs-edit for vis-2 widget\n- improve ki documentation for regex expressions\n- improve vis-2 ejs edit theme for dark mode",
+        "de": "- einige änderungen. siehe readme/unten\n\nÄnderungen 2026-07-29\n\n- reparatur widget rendering\n- hinzufügen von suche und vollbild zu ejs-edit für vis-2 widget\n- verbesserung der ki-dokumentation für regex-ausdrücke\n- verbesserung von vis-2 ejs edit theme für den dunklen modus",
+        "ru": "- некоторые изменения. см. readme/low\n\n#### Изменения 2026-07-29\n\n- реконструкция виджета\n- добавить поиск и полноэкранный редактор для виджета vis-2\n- улучшить документацию ки для выражений регекса\nулучшение темы редактирования vis-2 ejs в темном режиме",
+        "pt": "- algumas mudanças. ver lerme/abaixo\n\n### # Mudanças 2026-07-29\n\n- renderização de widget de reparação\n- adicionar pesquisa e tela cheia ao ejs-edit para widget vis-2\n- melhorar a documentação ki para expressões regex\n- melhorar o tema de edição vis-2 ejs para o modo escuro",
+        "nl": "- wat veranderingen. zie readme/onder\n\nVeranderingen 2026-07-29\n\n- repareren widget rendering\n- zoekopdracht en volledig scherm toevoegen aan ejs-edit voor vis-2 widget\n- verbetering van ki documentatie voor regex expressies\n- vis-2 ejs bewerken thema voor donkere modus",
+        "fr": "- quelques changements. voir lecture/ci-dessous\n\nChangements 2026-07-29\n\n- rendu de widget de réparation\n- ajouter recherche et plein écran à ejs-edit pour vis-2 widget\n- améliorer la documentation ki pour les expressions regex\n- améliorer le thème d'édition vis-2 ejs pour mode sombre",
+        "it": "- qualche cambiamento. vedi readme/below\n\n##### Changes 2026-07-29\n\n- riparazione widget rendering\n- aggiungere ricerca e schermo intero a ejs-edit per widget vis-2\n- migliorare la documentazione ki per le espressioni regex\n- migliorare il tema vis-2 ejs edit per la modalità dark",
+        "es": "- algunos cambios. ver readme/below\n\n### Cambios 2026-07-29\n\n- reparación de widget rendering\n- añadir búsqueda y pantalla completa a ejs-edit para vis-2 widget\n- mejorar la documentación de ki para expresiones regex\n- mejorar vis-2 ejs tema de edición para modo oscuro",
+        "pl": "- kilka zmian. patrz readme / poniżej\n\nZmiana 2026- 07- 29\n\n- renderowanie widżetu naprawy\n- dodaj wyszukiwanie i pełnoekranowy do ejs- edit dla vis-2 widget\n- ulepszenie dokumentacji ki dla wyrażeń regex\n- poprawić vis-2 ejs edycji tematu dla trybu ciemnego",
+        "uk": "- деякі зміни. переглянути файл\n\n##### Зміни 2026-07-29\n\n- відремонтування віджету\n- додати пошук і повноекранний до ejs-edit для віджету vis-2\n- покращувати ki документацію для виразів regex\n- поліпшуйте вік-2 ejs редагування теми для темного режиму",
+        "zh-cn": "- 一些变化。 见readme/以下\n\n* 变动 2026-07-29\n\n- 修理部件渲染\n- 在 ejs 编辑器中添加搜索和全屏,以显示相对于 2 部件\n- 改进用于regex表达式的 ki 文档\n- 改进对-2 ejs 为暗模式编辑主题"
+      },
       "4.4.5": {
         "en": "fix packages for vis-2",
         "de": "Pakete für vis-2 korrigieren",
@@ -67,32 +93,6 @@
         "pl": "naprawić regresję\naktualizacja pakietów",
         "uk": "фіксація регресія\nоновлення пакетів",
         "zh-cn": "修复回归\n更新软件包"
-      },
-      "4.4.0": {
-        "en": "- optimize lib size\n- The ability to load additional JavaScript and CSS files\n  has been added (also for vis2).\n- Improve react components\n- align translation for vis2 widget",
-        "de": "- optimierung der lib-größe\n- Die Möglichkeit, zusätzliche JavaScript- und CSS-Dateien zu laden\nwurde hinzugefügt (auch für vis2).\n- Reaktionskomponenten verbessern\n- übersetzung ausrichten für vis2 widget",
-        "ru": "оптимизируйте размер lib\nВозможность загрузки дополнительных файлов JavaScript и CSS\nдобавлено (также для vis2).\nУлучшение компонентов реакции\nперевод для vis2 widget",
-        "pt": "- otimizar o tamanho da lib\n- A capacidade de carregar arquivos adicionais de JavaScript e CSS\nfoi adicionado (também para vis2).\n- Melhorar os componentes de reacção\n- alinhar a tradução para o widget vis2",
-        "nl": "- optimalisatie van de grootte van de lib\n- De mogelijkheid om extra JavaScript- en CSS-bestanden te laden\nis toegevoegd (ook voor vis2).\n- Verbeter reactiecomponenten\n- align vertaling voor vis2 widget",
-        "fr": "- optimiser la taille de la lib\n- La possibilité de charger des fichiers supplémentaires JavaScript et CSS\na été ajouté (également pour vis2).\n- Améliorer les composants de réaction\n- traduction alignée pour le widget vis2",
-        "it": "- ottimizza la dimensione lib\n- La capacità di caricare ulteriori file JavaScript e CSS\nè stato aggiunto (anche per vis2).\n- Migliorare i componenti reattivi\n- traduzione allineare per widget vis2",
-        "es": "- optimizar el tamaño de la lib\n- La capacidad de cargar archivos adicionales JavaScript y CSS\nse ha añadido (también para vis2).\n- Mejorar los componentes de reacción\n- traducción alineada para vis2 widget",
-        "pl": "- optymalizacja rozmiaru lib\n- Możliwość wczytania dodatkowych plików JavaScript i CSS\nzostał dodany (także dla vis2).\n- Poprawa składników reakcji\n- tłumaczenie wyrównawcze dla vis2 widget",
-        "uk": "- оптимізація розміру lib\n- Можливість завантаження додаткових файлів JavaScript та CSS\nдодано (також для vis2).\n- Покращити компоненти реакції\n- вирівняти переклад для віджету vis2",
-        "zh-cn": "- 优化自由体积\n- 装入额外的 JavaScript 和 CSS 文件的能力\n已添加(也用于对比2).\n- 改进反应组件\n- 对齐粘合元件的翻译"
-      },
-      "4.3.11": {
-        "en": "check test release workflow",
-        "de": "testfreigabe workflow",
-        "ru": "проверка рабочего процесса выпуска",
-        "pt": "verificar o fluxo de trabalho de lançamento do teste",
-        "nl": "test-ontgrendelingsworkflow controleren",
-        "fr": "vérifier le déroulement du test de libération",
-        "it": "controllo del flusso di lavoro di rilascio del test",
-        "es": "check test de liberación flujo de trabajo",
-        "pl": "sprawdzić przepływ pracy uwalniania próby",
-        "uk": "контрольний процес тестування",
-        "zh-cn": "检查测试发布工作流程"
       }
     },
     "titleLang": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.vis-jsontemplate",
-  "version": "4.4.5",
+  "version": "4.6.0",
   "description": "vis-jsontemplate",
   "author": {
     "name": "oweitman",
@@ -31,7 +31,7 @@
     "@iobroker/build-tools": "^3.0.1",
     "@iobroker/vis-2-widgets-react-dev": "^4.0.4",
     "@iobroker/vis-2-widgets-testing": "^1.0.6",
-    "@types/node": "^25.9.3"
+    "@types/node": "^25.9.5"
   },
   "main": "widgets/vis2jsontemplate/customWidgets.js",
   "files": [

package/widgets/vis-jsontemplate/dist/jsontemplate-dist.js

@@ -1,10 +1,27 @@
 (() => {
   var __create = Object.create;
   var __defProp = Object.defineProperty;
+  var __defProps = Object.defineProperties;
   var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+  var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
   var __getOwnPropNames = Object.getOwnPropertyNames;
+  var __getOwnPropSymbols = Object.getOwnPropertySymbols;
   var __getProtoOf = Object.getPrototypeOf;
   var __hasOwnProp = Object.prototype.hasOwnProperty;
+  var __propIsEnum = Object.prototype.propertyIsEnumerable;
+  var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+  var __spreadValues = (a, b) => {
+    for (var prop in b || (b = {}))
+      if (__hasOwnProp.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    if (__getOwnPropSymbols)
+      for (var prop of __getOwnPropSymbols(b)) {
+        if (__propIsEnum.call(b, prop))
+          __defNormalProp(a, prop, b[prop]);
+      }
+    return a;
+  };
+  var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
   var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
     get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
   }) : x)(function(x) {
@@ -58,7 +75,7 @@
   var version;
   var init_package = __esm({
     "../package.json"() {
-      version = "4.4.5";
+      version = "4.6.0";
     }
   });
 
@@ -71,6 +88,104 @@
         const i18n = yield res.json();
         $.extend(true, systemDictionary, i18n);
       }));
+      var EJS_CONTEXT_NAMES = /* @__PURE__ */ new Set(["widgetid", "widgetID", "data", "dp", "style", "widget", "I18n"]);
+      var RESERVED_WORDS = /* @__PURE__ */ new Set([
+        "await",
+        "break",
+        "case",
+        "catch",
+        "class",
+        "const",
+        "continue",
+        "debugger",
+        "default",
+        "delete",
+        "do",
+        "else",
+        "enum",
+        "export",
+        "extends",
+        "false",
+        "finally",
+        "for",
+        "function",
+        "if",
+        "implements",
+        "import",
+        "in",
+        "instanceof",
+        "interface",
+        "let",
+        "new",
+        "null",
+        "package",
+        "private",
+        "protected",
+        "public",
+        "return",
+        "static",
+        "super",
+        "switch",
+        "this",
+        "throw",
+        "true",
+        "try",
+        "typeof",
+        "var",
+        "void",
+        "while",
+        "with",
+        "yield"
+      ]);
+      function isValidJavaScriptIdentifier(value) {
+        if (typeof value !== "string" || !value) {
+          return false;
+        }
+        return /^[$_\p{ID_Start}][$\u200C\u200D_\p{ID_Continue}]*$/u.test(value) && !RESERVED_WORDS.has(value);
+      }
+      function getDatapointVariableName(data, index) {
+        var _a, _b;
+        const value = (_b = (_a = data == null ? void 0 : data[`json_dp_variable${index}`]) != null ? _a : data == null ? void 0 : data[`json_dp_variable-${index}`]) != null ? _b : "";
+        return typeof value === "string" ? value.trim() : "";
+      }
+      function buildDatapointVariables(data, dpCount) {
+        const variables = {};
+        const usedNames = /* @__PURE__ */ new Set();
+        for (let i = 1; i <= dpCount; i++) {
+          const name = getDatapointVariableName(data, i);
+          if (!name) {
+            continue;
+          }
+          if (!isValidJavaScriptIdentifier(name)) {
+            throw new Error(`Invalid JavaScript variable name: ${name}`);
+          }
+          const valueName = `${name}_value`;
+          if (EJS_CONTEXT_NAMES.has(name) || EJS_CONTEXT_NAMES.has(valueName)) {
+            throw new Error(`Variable name is already used by the template context: ${name}`);
+          }
+          if (usedNames.has(name) || usedNames.has(valueName)) {
+            throw new Error(`Variable name is used more than once: ${name}`);
+          }
+          usedNames.add(name);
+          usedNames.add(valueName);
+          const oid = data[`json_dp${i}`];
+          if (oid) {
+            Object.defineProperty(variables, name, {
+              value: oid,
+              enumerable: true,
+              configurable: true,
+              writable: true
+            });
+            Object.defineProperty(variables, valueName, {
+              value: vis.states.attr(`${oid}.val`),
+              enumerable: true,
+              configurable: true,
+              writable: true
+            });
+          }
+        }
+        return variables;
+      }
       vis.binds["jsontemplate"] = {
         version,
         _assetCache: vis.binds["jsontemplate"] && vis.binds["jsontemplate"]._assetCache || /* @__PURE__ */ new Map(),
@@ -215,16 +330,17 @@
               }
               let text = "";
               try {
+                const datapointVariables = buildDatapointVariables(data, dpCount);
                 text = yield ejs.render(
                   template,
-                  {
+                  __spreadProps(__spreadValues({}, datapointVariables), {
                     widgetID,
                     widgetid: widgetID,
                     data: oiddata,
                     dp: datapoints,
                     widget: data,
                     style
-                  },
+                  }),
                   { async: true }
                 );
               } catch (e) {