iobroker.vis-jsontemplate 4.4.3 → 4.4.4

package/README.md

@@ -24,6 +24,28 @@ The jsontemplate widget was previously available in the rssfeed (for vis1) and
 vis-2-widgets-ovarious adapters. The widgets will be removed from these
 adapters in the near future.
 
+## Table of Contents
+
+- [Overview](#overview)
+- [Installation](#installation)
+- [Configuration](#configuration)
+- [vis and widgets](#vis-and-widgets)
+    - [JSON Template](#json-template)
+    - [Advanced use case](#advanced-use-case)
+    - [More Use Cases](#more-use-cases)
+- [Templatesystem](#templatesystem)
+    - [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)
+- [Tags](#tags)
+- [Example object](#example-object)
+- [Development and Debugging](#development-and-debugging)
+    - [Vis1 Widgets](#vis1-widgets)
+    - [Vis2 Widgets](#vis2-widgets)
+- [Todo](#todo)
+- [Changelog](#changelog)
+- [License](#license)
+
 ## Installation
 
 Install the adapter as normal from the stable repository.
@@ -79,7 +101,8 @@ Available data objects in the template:
 
 | object/variable | description                                                              |
 | --------------- | ------------------------------------------------------------------------ |
-| widgetID        | widgetID of the widget.                                                  |
+| widgetid        | widgetid of the widget.                                                  |
+| widgetID        | widgetid of the widget.                                                  |
 | data            | JSON object referenced by the datapoint in json_oid.                     |
 | dp              | Array of the datapoint data, referenced by the additional datapoints     |
 | widget          | internal widget data. object with all available widget settings          |
@@ -148,32 +171,46 @@ a specific layout. Here is an example:
 - [Use Case loading scripts](documentation/usecase-loadingscripts.md)
 - [Use Case Tasklist](documentation/usecase-tasklist.md)
 - [Use Case public-transport](documentation/usecase-public-transport.md)
+- [Use Case simple gauge](documentation/usecase-simplegauge.md)
+- [Use Case Github Issues and PRs](documentation/usecase-githubissues.md)
+- [Use Case FRITZ!Box call list](documentation/usecase-fritzbox-call-list.md)
 
 ## Templatesystem
 
-## Important note for the template system in vis
+### Very Important Note for use in vis / vis-2
 
-In vis, all object notations in the following form are recognized
-and replaced as bindings.
+#### Curly braces in CSS and JSON
 
-Therefore, the opening and closing brackets of all object notations must
-be placed on separate lines:
+The binding mechanism in vis / vis-2 uses the pattern `{ ... }`
+to detect binding expressions within HTML.
+For this reason, when specifying CSS or JSON, the curly braces must
+always be placed on separate lines. Otherwise, the content of
+the vis widget will be overwritten with `undefined`.
 
-Incorrect:
+##### Example
 
-```json
-{ "a": 1, "b": 2 }
+```text
+#w_id_<%- widgetid %> { height: 100%; display: flex; flex-direction: column; overflow: hidden; }
 ```
 
-Correct
+must be written as follows:
 
-```json
-{
-    "a": 1,
-    "b": 2
+```text
+#w_id_<%- widgetid %> {
+    height: 100%; display: flex; flex-direction: column; overflow: hidden;
 }
 ```
 
+#### Use of setInterval
+
+Please do not use `setInterval`. Since the template is re-invoked
+every time a data point changes, any existing `setInterval` calls
+cannot be properly cleared. Consequently, an increasing number
+of overlapping `setInterval` calls accumulate over time; this consumes RAM and
+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`.
+
 ## Tags
 
 The template system works with certain tags.
@@ -364,6 +401,10 @@ Loop over the attributes of an object
   Placeholder for the next version (at the beginning of the line):
   ### **WORK IN PROGRESS**
 -->
+### 4.4.4 (2026-07-22)
+
+- some changes. see readme
+
 ### 4.4.3 (2026-04-21)
 
 - revert repochecker warning about fs/node:fs and path/node:path

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "vis-jsontemplate",
-    "version": "4.4.3",
+    "version": "4.4.4",
     "news": {
+      "4.4.4": {
+        "en": "some changes. see readme",
+        "de": "einige änderungen. siehe readme",
+        "ru": "некоторые изменения. см. readme",
+        "pt": "algumas mudanças. ver lerme",
+        "nl": "wat veranderingen. zie readme",
+        "fr": "quelques changements. voir lecture",
+        "it": "alcuni cambiamenti. vedi leggere",
+        "es": "algunos cambios. ver readme",
+        "pl": "kilka zmian. patrz readme",
+        "uk": "деякі зміни. переглянути файл",
+        "zh-cn": "一些变化。 参见readme"
+      },
       "4.4.3": {
         "en": "- revert repochecker warning about fs/node:fs and path/node:path\n  because of error loading ejs",
         "de": "- revert repochecker warnung über fs/node:fs und pfad/node:path\naufgrund der fehlerbelastung ejs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.vis-jsontemplate",
-  "version": "4.4.3",
+  "version": "4.4.4",
   "description": "vis-jsontemplate",
   "author": {
     "name": "oweitman",
@@ -21,17 +21,17 @@
   ],
   "dependencies": {},
   "devDependencies": {
-    "@alcalzone/release-script": "^5.1.1",
-    "@alcalzone/release-script-plugin-iobroker": "^5.1.2",
-    "@alcalzone/release-script-plugin-license": "^5.1.1",
-    "@alcalzone/release-script-plugin-manual-review": "^5.1.1",
+    "@alcalzone/release-script": "^5.2.1",
+    "@alcalzone/release-script-plugin-iobroker": "^5.2.0",
+    "@alcalzone/release-script-plugin-license": "^5.2.0",
+    "@alcalzone/release-script-plugin-manual-review": "^5.2.0",
     "@iobroker/adapter-dev": "^1.5.0",
     "@iobroker/eslint-config": "^2.2.0",
-    "@iobroker/testing": "^5.2.2",
+    "@iobroker/testing": "^5.3.0",
     "@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.5.2"
+    "@types/node": "^25.9.3"
   },
   "main": "widgets/vis2jsontemplate/customWidgets.js",
   "files": [

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

@@ -58,7 +58,7 @@
   var version;
   var init_package = __esm({
     "../package.json"() {
-      version = "4.4.3";
+      version = "4.4.4";
     }
   });
 
@@ -217,7 +217,14 @@
               try {
                 text = yield ejs.render(
                   template,
-                  { widgetID, data: oiddata, dp: datapoints, widget: data, style },
+                  {
+                    widgetID,
+                    widgetid: widgetID,
+                    data: oiddata,
+                    dp: datapoints,
+                    widget: data,
+                    style
+                  },
                   { async: true }
                 );
               } catch (e) {