@iobroker/json-config 9.0.23 → 9.1.0

package/build/JsonConfigComponent/statePool.js

@@ -0,0 +1,172 @@
+/**
+ * Pool of the ioBroker states, on which the configuration elements depend (see the `dependsOnStates` attribute).
+ *
+ * Every state is subscribed only once, independent of how many elements use it (a table with 100 rows,
+ * that all depend on `adapter.0.info.connection`, produces exactly one subscription), and the value is
+ * cached, so an element that is mounted later gets it without an additional request.
+ */
+export class StatePool {
+    socket;
+    /** All currently subscribed state IDs */
+    states = new Map();
+    /** State IDs and the change handler of every owner (= configuration element) */
+    owners = new Map();
+    destroyed = false;
+    constructor(socket) {
+        this.socket = socket;
+    }
+    /**
+     * Subscribe an owner to the given state IDs. It replaces the IDs, that were requested by this owner before,
+     * because an ID can be built with a `${data.xxx}` pattern and so it can change with the data.
+     *
+     * The promise is resolved as soon as the values of all given states are known, so that the first
+     * calculation of `hidden`/`disabled` does not run with unknown values (and a button does not flicker
+     * from enabled to disabled).
+     *
+     * @param owner the configuration element, that requires the states
+     * @param ids resolved state IDs
+     * @param onChange called if one of the states changed
+     */
+    subscribe = async (owner, ids, onChange) => {
+        if (this.destroyed) {
+            return;
+        }
+        const wanted = [...new Set(ids.filter(id => id))];
+        const registered = this.owners.get(owner);
+        // Nothing to subscribe if this owner is already subscribed to exactly these states
+        if (registered && registered.ids.length === wanted.length && registered.ids.every(id => wanted.includes(id))) {
+            registered.onChange = onChange;
+        }
+        else {
+            this.owners.set(owner, { ids: wanted, onChange });
+            // Release the IDs, that are not required by this owner anymore
+            registered?.ids.filter(id => !wanted.includes(id)).forEach(id => this.releaseId(owner, id));
+            const toSubscribe = [];
+            wanted.forEach(id => {
+                const entry = this.states.get(id);
+                if (entry) {
+                    entry.owners.add(owner);
+                }
+                else {
+                    this.states.set(id, { owners: new Set([owner]), value: null, loaded: false });
+                    toSubscribe.push(id);
+                }
+            });
+            if (toSubscribe.length) {
+                const request = this.requestStates(toSubscribe);
+                toSubscribe.forEach(id => {
+                    const entry = this.states.get(id);
+                    if (entry) {
+                        entry.pending = request;
+                    }
+                });
+            }
+        }
+        // Wait for all running requests, also for those, that were started by another element
+        const pending = wanted.map(id => this.states.get(id)?.pending).filter(p => !!p);
+        if (pending.length) {
+            await Promise.all(pending);
+        }
+    };
+    /** Unsubscribe an owner from all its states */
+    unsubscribe = (owner) => {
+        const registered = this.owners.get(owner);
+        if (!registered) {
+            return;
+        }
+        this.owners.delete(owner);
+        registered.ids.forEach(id => this.releaseId(owner, id));
+    };
+    /**
+     * Get the last known value of a state.
+     *
+     * @param id resolved state ID
+     * @returns `undefined` if the state was not read yet, `null` if it does not exist
+     */
+    getValue = (id) => {
+        const entry = this.states.get(id);
+        if (!entry?.loaded) {
+            return undefined;
+        }
+        return entry.value;
+    };
+    /** Release all subscriptions. The pool cannot be used afterwards */
+    destroy() {
+        this.destroyed = true;
+        const ids = [...this.states.keys()];
+        this.states.clear();
+        this.owners.clear();
+        if (ids.length) {
+            try {
+                this.socket.unsubscribeState(ids, this.onStateChanged);
+            }
+            catch (e) {
+                console.error(`[JsonConfigComponent] Cannot unsubscribe from ${ids.join(', ')}: ${e}`);
+            }
+        }
+    }
+    /**
+     * Subscribe on the given IDs. `subscribeState` reports the current values of all existing states
+     * before it resolves, so no additional `getState` request is required. States, that were not reported,
+     * do not exist and stay `null`.
+     */
+    async requestStates(ids) {
+        try {
+            await this.socket.subscribeState(ids, this.onStateChanged);
+        }
+        catch (e) {
+            console.error(`[JsonConfigComponent] Cannot subscribe on ${ids.join(', ')}: ${e}`);
+        }
+        ids.forEach(id => {
+            const entry = this.states.get(id);
+            if (entry) {
+                entry.pending = undefined;
+                entry.loaded = true;
+            }
+        });
+    }
+    releaseId(owner, id) {
+        const entry = this.states.get(id);
+        if (!entry) {
+            return;
+        }
+        entry.owners.delete(owner);
+        if (!entry.owners.size) {
+            this.states.delete(id);
+            try {
+                this.socket.unsubscribeState(id, this.onStateChanged);
+            }
+            catch (e) {
+                console.error(`[JsonConfigComponent] Cannot unsubscribe from ${id}: ${e}`);
+            }
+        }
+    }
+    /**
+     * The new value is always stored, but the owners are only informed if `val`, `ack` or `q` changed.
+     * A repeated write of the same value (only `ts` changes) does not trigger a recalculation of the GUI.
+     */
+    onStateChanged = (id, state) => {
+        const entry = this.states.get(id);
+        if (!entry) {
+            return;
+        }
+        const value = state ?? null;
+        const changed = !entry.loaded ||
+            entry.value?.val !== value?.val ||
+            entry.value?.ack !== value?.ack ||
+            entry.value?.q !== value?.q;
+        entry.value = value;
+        entry.loaded = true;
+        if (changed) {
+            entry.owners.forEach(owner => {
+                try {
+                    this.owners.get(owner)?.onChange();
+                }
+                catch (e) {
+                    console.error(`[JsonConfigComponent] Cannot process the change of ${id}: ${e}`);
+                }
+            });
+        }
+    };
+}
+//# sourceMappingURL=statePool.js.map

package/build/JsonConfigComponent/statePool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statePool.js","sourceRoot":"src/","sources":["JsonConfigComponent/statePool.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AdminConnection } from '@iobroker/gui-components';\n\n/**\n * Value of a state, that was requested with the `dependsOnStates` attribute:\n * - `undefined` - the state was not read yet,\n * - `null` - the state does not exist,\n * - else the state object.\n */\nexport type SubscribedState = ioBroker.State | null | undefined;\n\ninterface StatePoolEntry {\n    /** Components, that requested this state. The subscription is released with the last one */\n    owners: Set<object>;\n    /** Last known value. `null` if the state does not exist */\n    value: ioBroker.State | null;\n    /** True as soon as the first value (or the information, that the state does not exist) was received */\n    loaded: boolean;\n    /** Running subscription request. Every owner of this ID awaits it, so no element is calculated with an unknown value */\n    pending?: Promise<void>;\n}\n\n/**\n * Pool of the ioBroker states, on which the configuration elements depend (see the `dependsOnStates` attribute).\n *\n * Every state is subscribed only once, independent of how many elements use it (a table with 100 rows,\n * that all depend on `adapter.0.info.connection`, produces exactly one subscription), and the value is\n * cached, so an element that is mounted later gets it without an additional request.\n */\nexport class StatePool {\n    private readonly socket: AdminConnection;\n    /** All currently subscribed state IDs */\n    private readonly states = new Map<string, StatePoolEntry>();\n    /** State IDs and the change handler of every owner (= configuration element) */\n    private readonly owners = new Map<object, { ids: string[]; onChange: () => void }>();\n    private destroyed = false;\n\n    constructor(socket: AdminConnection) {\n        this.socket = socket;\n    }\n\n    /**\n     * Subscribe an owner to the given state IDs. It replaces the IDs, that were requested by this owner before,\n     * because an ID can be built with a `${data.xxx}` pattern and so it can change with the data.\n     *\n     * The promise is resolved as soon as the values of all given states are known, so that the first\n     * calculation of `hidden`/`disabled` does not run with unknown values (and a button does not flicker\n     * from enabled to disabled).\n     *\n     * @param owner the configuration element, that requires the states\n     * @param ids resolved state IDs\n     * @param onChange called if one of the states changed\n     */\n    subscribe = async (owner: object, ids: string[], onChange: () => void): Promise<void> => {\n        if (this.destroyed) {\n            return;\n        }\n        const wanted = [...new Set(ids.filter(id => id))];\n        const registered = this.owners.get(owner);\n\n        // Nothing to subscribe if this owner is already subscribed to exactly these states\n        if (registered && registered.ids.length === wanted.length && registered.ids.every(id => wanted.includes(id))) {\n            registered.onChange = onChange;\n        } else {\n            this.owners.set(owner, { ids: wanted, onChange });\n\n            // Release the IDs, that are not required by this owner anymore\n            registered?.ids.filter(id => !wanted.includes(id)).forEach(id => this.releaseId(owner, id));\n\n            const toSubscribe: string[] = [];\n            wanted.forEach(id => {\n                const entry = this.states.get(id);\n                if (entry) {\n                    entry.owners.add(owner);\n                } else {\n                    this.states.set(id, { owners: new Set([owner]), value: null, loaded: false });\n                    toSubscribe.push(id);\n                }\n            });\n\n            if (toSubscribe.length) {\n                const request = this.requestStates(toSubscribe);\n                toSubscribe.forEach(id => {\n                    const entry = this.states.get(id);\n                    if (entry) {\n                        entry.pending = request;\n                    }\n                });\n            }\n        }\n\n        // Wait for all running requests, also for those, that were started by another element\n        const pending = wanted.map(id => this.states.get(id)?.pending).filter(p => !!p);\n        if (pending.length) {\n            await Promise.all(pending);\n        }\n    };\n\n    /** Unsubscribe an owner from all its states */\n    unsubscribe = (owner: object): void => {\n        const registered = this.owners.get(owner);\n        if (!registered) {\n            return;\n        }\n        this.owners.delete(owner);\n        registered.ids.forEach(id => this.releaseId(owner, id));\n    };\n\n    /**\n     * Get the last known value of a state.\n     *\n     * @param id resolved state ID\n     * @returns `undefined` if the state was not read yet, `null` if it does not exist\n     */\n    getValue = (id: string): SubscribedState => {\n        const entry = this.states.get(id);\n        if (!entry?.loaded) {\n            return undefined;\n        }\n        return entry.value;\n    };\n\n    /** Release all subscriptions. The pool cannot be used afterwards */\n    destroy(): void {\n        this.destroyed = true;\n        const ids = [...this.states.keys()];\n        this.states.clear();\n        this.owners.clear();\n        if (ids.length) {\n            try {\n                this.socket.unsubscribeState(ids, this.onStateChanged);\n            } catch (e) {\n                console.error(`[JsonConfigComponent] Cannot unsubscribe from ${ids.join(', ')}: ${e as Error}`);\n            }\n        }\n    }\n\n    /**\n     * Subscribe on the given IDs. `subscribeState` reports the current values of all existing states\n     * before it resolves, so no additional `getState` request is required. States, that were not reported,\n     * do not exist and stay `null`.\n     */\n    private async requestStates(ids: string[]): Promise<void> {\n        try {\n            await this.socket.subscribeState(ids, this.onStateChanged);\n        } catch (e) {\n            console.error(`[JsonConfigComponent] Cannot subscribe on ${ids.join(', ')}: ${e as Error}`);\n        }\n        ids.forEach(id => {\n            const entry = this.states.get(id);\n            if (entry) {\n                entry.pending = undefined;\n                entry.loaded = true;\n            }\n        });\n    }\n\n    private releaseId(owner: object, id: string): void {\n        const entry = this.states.get(id);\n        if (!entry) {\n            return;\n        }\n        entry.owners.delete(owner);\n        if (!entry.owners.size) {\n            this.states.delete(id);\n            try {\n                this.socket.unsubscribeState(id, this.onStateChanged);\n            } catch (e) {\n                console.error(`[JsonConfigComponent] Cannot unsubscribe from ${id}: ${e as Error}`);\n            }\n        }\n    }\n\n    /**\n     * The new value is always stored, but the owners are only informed if `val`, `ack` or `q` changed.\n     * A repeated write of the same value (only `ts` changes) does not trigger a recalculation of the GUI.\n     */\n    private onStateChanged = (id: string, state: ioBroker.State | null | undefined): void => {\n        const entry = this.states.get(id);\n        if (!entry) {\n            return;\n        }\n        const value = state ?? null;\n        const changed =\n            !entry.loaded ||\n            entry.value?.val !== value?.val ||\n            entry.value?.ack !== value?.ack ||\n            entry.value?.q !== value?.q;\n\n        entry.value = value;\n        entry.loaded = true;\n\n        if (changed) {\n            entry.owners.forEach(owner => {\n                try {\n                    this.owners.get(owner)?.onChange();\n                } catch (e) {\n                    console.error(`[JsonConfigComponent] Cannot process the change of ${id}: ${e as Error}`);\n                }\n            });\n        }\n    };\n}\n"]}

package/build/types.d.ts

@@ -216,6 +216,23 @@ export interface ConfigItem {
     docker?: boolean;
     /** JS function to calculate if the control is disabled. You can write "true" too */
     disabled?: string | boolean;
+    /**
+     * ioBroker states, on which this element depends: `{ "<alias>": "<state ID>" }`.
+     *
+     * The states are subscribed, and if one of them changes, `hidden`, `disabled`, `label`, `help`, `validator`
+     * and `defaultFunc` will be calculated anew. The values are available in all JS functions and in all
+     * `${...}` patterns as `_states.<alias>`, and they contain the whole state object (`_states.running?.val`,
+     * `_states.running?.ts`, ...). `_states.<alias>` is `null` if the state does not exist.
+     *
+     * A state ID, that starts with a dot, addresses the own instance: `.info.connection` => `adapter.0.info.connection`.
+     * Every other ID is used as it is, so states of other adapters can be used too. `${data.xxx}` patterns
+     * are allowed in the ID, wildcards are not.
+     *
+     * The short array form `["adapter.0.info.connection"]` uses the ID itself as an alias.
+     *
+     * @example { "running": ".info.running" } together with `disabled: "_states.running?.val === true"`
+     */
+    dependsOnStates?: Record<string, string> | string[];
     /** Help text of the control */
     help?: ioBroker.StringOrTranslated;
     /** Link that will be opened by clicking on the help text */
@@ -1312,6 +1329,16 @@ export type JsonConfigContext = {
     onValueChange?: (attr: string, value: any, saveConfig: boolean) => void;
     registerOnForceUpdate?: (attr: string, cb?: (data: any) => void) => void;
     getCachedObject?: (id: string) => Promise<ioBroker.Object | null>;
+    /**
+     * Subscribe an element (`owner`) on the given state IDs (see the `dependsOnStates` attribute).
+     * It replaces the IDs, this element was subscribed to before, and it is resolved as soon as the
+     * values of all these states are known.
+     */
+    subscribeStates?: (owner: object, ids: string[], onChange: () => void) => Promise<void>;
+    /** Unsubscribe an element from all states, it was subscribed to */
+    unsubscribeStates?: (owner: object) => void;
+    /** Last known value of a subscribed state. `undefined` - not read yet, `null` - the state does not exist */
+    getStateValue?: (id: string) => ioBroker.State | null | undefined;
     /** Information about the host, on which the configured instance runs */
     hostInfo?: JsonConfigHostInfo;
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iobroker/json-config",
   "description": "This package contains the ioBroker JSON config UI components",
-  "version": "9.0.23",
+  "version": "9.1.0",
   "author": {
     "name": "bluefox",
     "email": "dogafox@gmail.com"
@@ -39,8 +39,8 @@
     "@emotion/styled": "^11.14.1",
     "@iobroker/gui-components": "^10.2.0",
     "@module-federation/runtime": "^2.9.0",
-    "@mui/icons-material": "^9.3.1",
-    "@mui/material": "^9.3.1",
+    "@mui/icons-material": "^9.4.0",
+    "@mui/material": "^9.4.0",
     "@mui/x-date-pickers": "^9.12.0",
     "crypto-js": "^4.2.0",
     "json5": "^2.2.3",