@iobroker/dm-utils 2.0.1 → 3.0.0

package/build/types/common.d.ts

@@ -1,28 +1,24 @@
-export type ApiVersion = 'v1' | 'v2';
+export type ApiVersion = 'v3';
 export type ConfigConnectionType = 'lan' | 'wifi' | 'bluetooth' | 'thread' | 'z-wave' | 'zigbee' | 'other';
+export interface ComplexDeviceId {
+    [key: string | number]: string | number | ComplexDeviceId;
+}
+export type DeviceId = string | number | ComplexDeviceId;
 export type ValueOrObject<T> = T | {
     objectId: string;
     property: string;
 };
-export type ValueOrState<T, M = {
-    [value: string | number]: string;
-}> = T | {
+export type ValueOrState<T> = T | {
     stateId: string;
-    mapping?: M;
+    mapping?: Record<string | number, T>;
 };
 export type ValueOrStateOrObject<T> = T | ValueOrObject<T> | ValueOrState<T>;
 export type DeviceStatus = 'connected' | 'disconnected' | {
-    battery?: ValueOrState<number | boolean | 'charging' | string>;
-    connection?: ValueOrState<'connected' | 'disconnected', {
-        [value: string]: 'connected' | 'disconnected';
-    }>;
+    battery?: ValueOrState<number | boolean | 'charging' | (string & {})>;
+    connection?: ValueOrState<'connected' | 'disconnected'>;
     rssi?: ValueOrState<number>;
     warning?: ValueOrState<ioBroker.StringOrTranslated | boolean>;
 };
-export type DeviceRefresh = 'device' | 'instance' | false | true;
-export type RefreshResponse = {
-    refresh: DeviceRefresh;
-};
 export type ErrorResponse = {
     error: {
         code: number;
@@ -30,18 +26,26 @@ export type ErrorResponse = {
     };
 };
 export type RetVal<T> = T | Promise<T>;
+export interface ProgressOptions {
+    indeterminate?: boolean;
+    value?: number;
+    label?: ioBroker.StringOrTranslated;
+}
+export interface ProgressUpdate extends ProgressOptions {
+    title?: ioBroker.StringOrTranslated;
+}
 type CustomCSSProperties = Record<string, any>;
 interface ObjectBrowserCustomFilter {
     type?: ioBroker.ObjectType | ioBroker.ObjectType[];
     common?: {
         type?: ioBroker.CommonType | ioBroker.CommonType[];
         role?: string | string[];
-        custom?: '_' | '_dataSources' | true | string | string[];
+        custom?: '_' | '_dataSources' | true | (string & {}) | string[];
     };
 }
 export type ObjectBrowserType = 'state' | 'instance' | 'channel' | 'device' | 'chart';
-export type ConfigItemType = 'accordion' | 'alive' | 'autocomplete' | 'autocompleteSendTo' | 'certCollection' | 'certificate' | 'certificates' | 'checkDocker' | 'checkLicense' | 'checkbox' | 'chips' | 'color' | 'coordinates' | 'cron' | 'custom' | 'datePicker' | 'deviceManager' | 'divider' | 'file' | 'fileSelector' | 'func' | 'header' | 'image' | 'imageSendTo' | 'infoBox' | 'instance' | 'interface' | 'ip' | 'jsonEditor' | 'language' | 'license' | 'number' | 'oauth2' | 'objectId' | 'panel' | 'password' | 'pattern' | 'port' | 'qrCode' | 'room' | 'select' | 'selectSendTo' | 'sendto' | 'setState' | 'slider' | 'state' | 'staticImage' | 'staticInfo' | 'staticLink' | 'staticText' | 'table' | 'tabs' | 'text' | 'textSendTo' | 'timePicker' | 'topic' | 'user' | 'uuid';
-export type ConfigIconType = 'add' | 'backlight' | 'book' | 'delete' | 'dimmer' | 'edit' | 'error' | 'group' | 'help' | 'identify' | 'info' | 'light' | 'lines' | 'next' | 'pair' | 'pause' | 'play' | 'previous' | 'qrcode' | 'refresh' | 'search' | 'send' | 'settings' | 'socket' | 'stop' | 'unpair' | 'update' | 'upload' | 'user' | 'warning' | 'web' | string;
+export type ConfigItemType = 'accordion' | 'alive' | 'autocomplete' | 'autocompleteSendTo' | 'certCollection' | 'certificate' | 'certificates' | 'checkDocker' | 'checkLicense' | 'checkbox' | 'chips' | 'color' | 'coordinates' | 'cron' | 'custom' | 'datePicker' | 'deviceManager' | 'divider' | 'file' | 'fileSelector' | 'func' | 'header' | 'iframe' | 'iframeSendTo' | 'image' | 'imageSendTo' | 'infoBox' | 'instance' | 'interface' | 'ip' | 'jsonEditor' | 'language' | 'license' | 'number' | 'oauth2' | 'objectId' | 'panel' | 'password' | 'pattern' | 'port' | 'qrCode' | 'room' | 'select' | 'selectSendTo' | 'sendto' | 'setState' | 'slider' | 'state' | 'staticImage' | 'staticInfo' | 'staticLink' | 'staticText' | 'table' | 'tabs' | 'text' | 'textSendTo' | 'timePicker' | 'topic' | 'user' | 'uuid' | 'yamlEditor';
+export type ConfigIconType = 'add' | 'backlight' | 'book' | 'delete' | 'dimmer' | 'edit' | 'error' | 'group' | 'help' | 'identify' | 'info' | 'light' | 'lines' | 'next' | 'pair' | 'pause' | 'play' | 'previous' | 'qrcode' | 'refresh' | 'search' | 'send' | 'settings' | 'socket' | 'stop' | 'unpair' | 'upload' | 'user' | 'warning' | 'web' | string;
 export interface ConfigItemConfirmData {
     condition: string;
     text?: ioBroker.StringOrTranslated;
@@ -89,7 +93,7 @@ export interface ConfigItem {
     default?: boolean | number | string;
     defaultFunc?: string;
     defaultSendTo?: string;
-    /** Allow saving of configuration even with error */
+    /** Allow saving of configuration even with an error */
     allowSaveWithError?: boolean;
     data?: string | number | boolean;
     jsonData?: string;
@@ -121,20 +125,20 @@ interface ConfigItemIndexed extends ConfigItem {
 }
 interface ConfigItemTableIndexed extends ConfigItem {
     attr?: string;
-    /** show filter options in the header of table */
+    /** show filter options in the header of the table */
     filter?: boolean;
-    /** show sorting options in the header of table */
+    /** show sorting options in the header of the table */
     sort?: boolean;
-    /** tooltip in the header of table */
+    /** tooltip in the header of the table */
     title?: string;
 }
 export interface ConfigItemAlive extends ConfigItem {
     type: 'alive';
-    /** check if the instance is alive. If not defined, it will be used current instance. You can use `${data.number}` pattern in the text. */
+    /** check if the instance is alive. If not defined, it will be used current instance. You can use the ` $ {data.number} ` pattern in the text. */
     instance?: string;
-    /** default text is `Instance %s is alive`, where %s will be replaced by `ADAPTER.0`. The translation must exist in i18n files. */
+    /** the default text is `Instance %s is alive`, where %s will be replaced by `ADAPTER.0`. The translation must exist in i18n files. */
     textAlive?: string;
-    /** default text is `Instance %s is not alive`, where %s will be replaced by `ADAPTER.0`. The translation must exist in i18n files. */
+    /** the default text is `Instance %s is not alive`, where %s will be replaced by `ADAPTER.0`. The translation must exist in i18n files. */
     textNotAlive?: string;
 }
 export interface ConfigItemSelectOption {
@@ -188,17 +192,17 @@ export interface ConfigItemTabs extends ConfigItem {
 }
 export interface ConfigItemText extends ConfigItem {
     type: 'text';
-    /** max length of the text in field */
+    /** max length of the text in the field */
     maxLength?: number;
     /** @deprecated use maxLength */
     max?: number;
     /** read-only field */
     readOnly?: boolean;
-    /** show copy to clipboard button, but only if disabled or read-only */
+    /** show copy-to-clipboard button, but only if disabled or read-only */
     copyToClipboard?: boolean;
     /** default is true. Set this attribute to `false` if trim is not desired. */
     trim?: boolean;
-    /** default is 1. Set this attribute to `2` or more if you want to have a textarea with more than one row. */
+    /** the default is 1. Set this attribute to `2` or more if you want to have a textarea with more than one row. */
     minRows?: number;
     /** max rows of textarea. Used only if `minRows` > 1. */
     maxRows?: number;
@@ -258,7 +262,7 @@ export interface ConfigItemPassword extends ConfigItem {
     visible?: boolean;
     /** The read-only flag. Visible is automatically true if readOnly is true */
     readOnly?: boolean;
-    /** max length of the text in field */
+    /** max length of the text in the field */
     maxLength?: number;
     /** @deprecated use maxLength */
     max?: number;
@@ -306,7 +310,7 @@ export interface ConfigItemSlider extends ConfigItem {
 }
 export interface ConfigItemTopic extends ConfigItem {
     type: 'topic';
-    /** max length of the text in field */
+    /** max length of the text in the field */
     maxLength?: number;
     /** @deprecated use maxLength */
     max?: number;
@@ -349,11 +353,11 @@ export interface ConfigItemStaticText extends Omit<ConfigItem, 'button'> {
     label?: ioBroker.StringOrTranslated;
     /** link. Link could be dynamic like `#tab-objects/customs/${data.parentId} */
     href?: string;
-    /** target of the link: _self, _blank or window name. For relative links default is _self and for absolute - _blank */
+    /** target of the link: _self, _blank or window name. For relative links the default is _self and for absolute - _blank */
     target?: string;
     /** If the GUI should be closed after a link was opened (only if the target is equal to '_self') */
     close?: boolean;
-    /** show a link as button */
+    /** show a link as a button */
     button?: boolean;
     /** type of button (`outlined`, `contained`, `text`) */
     variant?: 'contained' | 'outlined' | 'text';
@@ -374,13 +378,13 @@ export interface ConfigItemStaticInfo extends Omit<ConfigItem, 'data'> {
     unit?: ioBroker.StringOrTranslated;
     /** Normally, the title and value are shown on the left and right of the line. With this flag, the value will appear just after the label*/
     narrow?: boolean;
-    /** Add to label the colon at the end if not exist in label */
+    /** Add to the label the colon at the end if not exist in the label */
     addColon?: boolean;
     /** Value should blink when updated (true or color) */
     blinkOnUpdate?: boolean | string;
     /** Value should blink continuously (true or color) */
     blink?: boolean | string;
-    /** Show copy to clipboard button for value */
+    /** Show a copy-to-clipboard button for value */
     copyToClipboard?: boolean;
     /** Label style */
     styleLabel?: CustomCSSProperties;
@@ -392,7 +396,7 @@ export interface ConfigItemStaticInfo extends Omit<ConfigItem, 'data'> {
     size?: number | 'small' | 'normal' | 'large';
     /** Highlight line on mouse over */
     highlight?: boolean;
-    /** Show boolean values as checkbox */
+    /** Show boolean values as a checkbox */
     booleanAsCheckbox?: boolean;
     /** Show string values as HTML */
     html?: boolean;
@@ -438,7 +442,7 @@ export interface ConfigItemSelect extends ConfigItem {
     attr?: string;
     /** If multiple selection is possible. In this case, the value will be an array */
     multiple?: boolean;
-    /** show item even if no label was found for it (by multiple), default=`true` */
+    /** show an item even if no label was found for it (by multiple), default=`true` */
     showAllValues?: boolean;
 }
 export interface ConfigItemAutocomplete extends ConfigItem {
@@ -454,7 +458,7 @@ export interface ConfigItemSetState extends ConfigItem {
     ack?: boolean;
     /** '${data.myText}_test' or number. Type will be detected automatically from the state type and converting done too */
     val: ioBroker.StateValue;
-    /** Alert which will be shown by pressing the button */
+    /** Alert, which will be shown by pressing the button */
     okText?: ioBroker.StringOrTranslated;
     variant?: 'contained' | 'outlined';
     color?: 'primary' | 'secondary' | 'grey';
@@ -470,7 +474,7 @@ export interface ConfigItemAutocompleteSendTo extends Omit<ConfigItem, 'data'> {
     options?: (string | ConfigItemSelectOption)[];
     data?: Record<string, any>;
     freeSolo?: boolean;
-    /** max length of the text in field */
+    /** max length of the text in the field */
     maxLength?: number;
     /** @deprecated use maxLength */
     max?: string;
@@ -482,7 +486,7 @@ export interface ConfigItemAccordion extends ConfigItem {
     titleAttr?: string;
     /** If delete or add disabled, If noDelete is false, add, delete and move up/down should work */
     noDelete?: boolean;
-    /** If clone button should be shown. If true, the clone button will be shown. If attribute name, this name will be unique. */
+    /** If the clone button should be shown. If true, the clone button will be shown. If attribute name, this name will be unique. */
     clone?: boolean | string;
     /** Items of accordion */
     items: ConfigItemIndexed[];
@@ -509,7 +513,7 @@ export interface ConfigItemCoordinates extends ConfigItem {
     latitudeName?: string;
     /** if defined, the checkbox with "Use system settings" will be shown and latitude, longitude will be read from system.config, a boolean will be saved to the given name */
     useSystemName?: string;
-    /** max length of the text in field */
+    /** max length of the text in the field */
     maxLength?: number;
     /** @deprecated use maxLength */
     max?: number;
@@ -531,7 +535,7 @@ export interface ConfigItemCustom extends ConfigItem {
 }
 export interface ConfigItemDatePicker extends ConfigItem {
     type: 'datePicker';
-    /** max length of the text in field */
+    /** max length of the text in the field */
     maxLength?: number;
     /** @deprecated use maxLength */
     max?: number;
@@ -550,6 +554,25 @@ export interface ConfigItemPort extends ConfigItem {
     max?: number;
     readOnly?: boolean;
 }
+export interface ConfigItemIFrame extends ConfigItem {
+    type: 'iframe';
+    url?: string;
+    sandbox?: string;
+    allowFullscreen?: boolean;
+    frameBorder?: number | string;
+    /** if true, the iframe will be loaded only when it becomes visible */
+    lazyLoad?: 'lazy' | 'eager';
+    /** if true, the iframe will be reloaded every time it becomes visible */
+    reloadOnShow?: boolean;
+    /** CSS Styles in React format (`marginLeft` and not `margin-left`) for the IFrame component */
+    innerStyle?: CustomCSSProperties;
+}
+export interface ConfigItemIFrameSendTo extends Omit<ConfigItemIFrame, 'data' | 'url' | 'type'> {
+    type: 'iframeSendTo';
+    command?: string;
+    alsoDependsOn?: string[];
+    data?: Record<string, any>;
+}
 export interface ConfigItemImageSendTo extends Omit<ConfigItem, 'data'> {
     type: 'imageSendTo';
     command?: string;
@@ -562,8 +585,10 @@ export interface ConfigItemSendTo extends Omit<ConfigItem, 'data'> {
     command?: string;
     jsonData?: string;
     data?: Record<string, any>;
-    result?: string;
-    error?: string;
+    /** Translations for possible result codes. E.g. `{"RESULT_OK": "Operation successful"}`. The translation must exist in i18n files. */
+    result?: Record<string, ioBroker.StringOrTranslated>;
+    /** Translations for possible error codes. E.g. `{"ERR_NO_OBJECT": "Object not found"}`. The translation must exist in i18n files. */
+    error?: Record<string, ioBroker.StringOrTranslated>;
     variant?: 'contained' | 'outlined';
     openUrl?: boolean;
     reloadBrowser?: boolean;
@@ -579,12 +604,12 @@ export interface ConfigItemSendTo extends Omit<ConfigItem, 'data'> {
     alsoDependsOn?: string[];
     container?: 'text' | 'div' | 'html';
     copyToClipboard?: boolean;
-    /** Styles for button itself */
+    /** Styles for the button itself */
     controlStyle?: CustomCSSProperties;
 }
 export interface ConfigItemState extends ConfigItem {
     type: 'state';
-    /** Describes, which object ID should be taken for the controlling. The ID is without `ADAPTER.I.` prefix */
+    /** Describes which object ID should be taken for the controlling. The ID is without `ADAPTER.I.` prefix */
     oid: string;
     /** The `oid` is absolute and no need to add `ADAPTER.I` or `system.adapter.ADAPTER.I.` to oid */
     foreign?: boolean;
@@ -594,7 +619,7 @@ export interface ConfigItemState extends ConfigItem {
     control?: 'text' | 'html' | 'input' | 'slider' | 'select' | 'button' | 'switch' | 'number';
     /** If true, the state will be shown as switch, select, button, slider or text input. Used only if no control property is defined */
     controlled?: boolean;
-    /** Add unit to the value */
+    /** Add a unit to the value */
     unit?: string;
     /** this text will be shown if the value is true */
     trueText?: string;
@@ -624,15 +649,15 @@ export interface ConfigItemState extends ConfigItem {
     labelIcon?: string;
     /** Normally, the title and value are shown on the left and right of the line. With this flag, the value will appear just after the label*/
     narrow?: boolean;
-    /** Add to label the colon at the end if not exist in label */
+    /** Add to the label the colon at the end if not exist in the label */
     addColon?: boolean;
     /** Value should blink when updated (true or color) */
     blinkOnUpdate?: boolean | string;
     /** Font size */
     size?: number | 'small' | 'normal' | 'large';
-    /** Optional value, that will be sent for button */
+    /** Optional value that will be sent for the button */
     buttonValue?: ioBroker.StateValue;
-    /** Show SET button. The value in this case will be sent only when the button is pressed. You can define the text of the button. Default text is "Set" */
+    /** Show the SET button. The value in this case will be sent only when the button is pressed. You can define the text of the button. The default text is "Set" */
     showEnterButton?: boolean | ioBroker.StringOrTranslated;
     /** The value in this case will be sent only when the "Enter" button is pressed. It can be combined with `showEnterButton` */
     setOnEnterKey?: boolean;
@@ -642,7 +667,7 @@ export interface ConfigItemState extends ConfigItem {
 export interface ConfigItemTextSendTo extends Omit<ConfigItem, 'data'> {
     type: 'textSendTo';
     container?: 'text' | 'div';
-    /** if true - show copy to clipboard button */
+    /** if true - show copy-to-clipboard button */
     copyToClipboard?: boolean;
     /** by change of which attributes, the command must be resent */
     alsoDependsOn?: string[];
@@ -655,11 +680,11 @@ export interface ConfigItemTextSendTo extends Omit<ConfigItem, 'data'> {
 }
 export interface ConfigItemSelectSendTo extends Omit<ConfigItem, 'data'> {
     type: 'selectSendTo';
-    /** allow manual editing. Without drop-down menu (if instance is offline). Default `true`. */
+    /** allow manual editing. Without a drop-down menu (if the instance is offline). Default `true`. */
     manual?: boolean;
     /** Multiple choice select */
     multiple?: boolean;
-    /** show item even if no label was found for it (by multiple), default=`true` */
+    /** show an item even if no label was found for it (by multiple), default=`true` */
     showAllValues?: boolean;
     /** if true, the clear button will not be shown */
     noClearButton?: boolean;
@@ -675,21 +700,23 @@ export interface ConfigItemSelectSendTo extends Omit<ConfigItem, 'data'> {
 export interface ConfigItemTable extends ConfigItem {
     type: 'table';
     items?: ConfigItemTableIndexed[];
+    /** Define the name of the attribute of the item which should be shown as a title of the item in cards mode. */
+    titleAttribute?: string;
     /** If delete or add disabled, If noDelete is false, add, delete and move up/down should work */
     noDelete?: boolean;
     /** @deprecated don't use */
     objKeyName?: string;
     /** @deprecated don't use */
     objValueName?: string;
-    /** If add allowed even if filter is set */
+    /** If add allowed even if a filter is set */
     allowAddByFilter?: boolean;
-    /** The number of lines from which the second add button at the bottom of the table will be shown. Default 5 */
+    /** The number of lines from which the second adding button at the bottom of the table will be shown. Default 5 */
     showSecondAddAt?: number;
-    /** Show first plus button on top of the first column and not on the left. */
+    /** Show the first plus button on top of the first column and not on the left. */
     showFirstAddOnTop?: boolean;
-    /** If clone button should be shown. If true, the clone button will be shown. If attribute name, this name will be unique. */
+    /** If the clone button should be shown. If true, the clone button will be shown. If attribute name, this name will be unique. */
     clone?: boolean | string;
-    /** If export button should be shown. Export as csv file. */
+    /** If export button should be shown. Export as a csv file. */
     export?: boolean;
     /** If import button should be shown. Import from csv file. */
     import?: boolean;
@@ -697,7 +724,7 @@ export interface ConfigItemTable extends ConfigItem {
     compact?: boolean;
     /** Specify the 'attr' name of columns which need to be unique */
     uniqueColumns?: string[];
-    /** These items will be encrypted before saving with simple (not SHA) encryption method */
+    /** These items will be encrypted before saving with a simple (not SHA) encryption method */
     encryptedAttributes?: string[];
     /** Breakpoint that will be rendered as cards */
     useCardFor?: ('xs' | 'sm' | 'md' | 'lg' | 'xl')[];
@@ -781,7 +808,18 @@ export interface ConfigItemJsonEditor extends ConfigItem {
     allowEmpty?: boolean;
     /** Allow JSON5 format. Default is disabled */
     json5?: boolean;
-    /** Do not allow to save the value if error in JSON or JSON5 */
+    /** Do not allow saving the value if error in JSON or JSON5 */
+    doNotApplyWithError?: boolean;
+    /** Open the editor in read-only mode - editor can be opened but content cannot be modified */
+    readOnly?: boolean;
+}
+export interface ConfigItemYamlEditor extends ConfigItem {
+    type: 'yamlEditor';
+    /** if false, the text will be not validated as YAML */
+    validateYaml?: boolean;
+    /** if true, the YAML will be validated only if the value is not empty */
+    allowEmpty?: boolean;
+    /** Do not allow saving the value if error in YAML */
     doNotApplyWithError?: boolean;
     /** Open the editor in read-only mode - editor can be opened but content cannot be modified */
     readOnly?: boolean;
@@ -795,7 +833,7 @@ export interface ConfigItemInterface extends ConfigItem {
 }
 export interface ConfigItemImageUpload extends ConfigItem {
     type: 'image';
-    /** name of a file is structure name. In the below example `login-bg.png` is file name for `writeFile("myAdapter.INSTANCE", "login-bg.png")` */
+    /** the name of a file is the structure name. In the below example `login-bg.png` is the file name for `writeFile("myAdapter.INSTANCE", "login-bg.png")` */
     filename?: string;
     /** HTML accept attribute, like `{ 'image/**': [], 'application/pdf': ['.pdf'] }`, default `{ 'image/*': [] }` */
     accept?: Record<string, string[]>;
@@ -803,16 +841,16 @@ export interface ConfigItemImageUpload extends ConfigItem {
     maxSize?: number;
     /** if true, the image will be saved as data-url in attribute, elsewise as binary in file storage */
     base64?: boolean;
-    /** if true, allow user to crop the image */
+    /** if true, allow the user to crop the image */
     crop?: boolean;
 }
 export interface ConfigItemInstanceSelect extends ConfigItem {
     type: 'instance';
-    /** name of adapter. With special name `_dataSources` you can get all adapters with flag `common.getHistory`. */
+    /** name of adapter. With the special name `_dataSources` you can get all adapters with the flag `common.getHistory`. */
     adapter?: string;
-    /** optional list of adapters, that should be shown. If not defined, all adapters will be shown. Only active if `adapter` attribute is not defined. */
+    /** optional list of adapters that should be shown. If not defined, all adapters will be shown. Only active if the ` adapter ` attribute is not defined. */
     adapters?: string[];
-    /** if true. Additional option "deactivate" is shown */
+    /** if true. The additional option "deactivate" is shown */
     allowDeactivate?: boolean;
     /** if true. Only enabled instances will be shown */
     onlyEnabled?: boolean;
@@ -825,7 +863,7 @@ export interface ConfigItemInstanceSelect extends ConfigItem {
 }
 export interface ConfigItemFile extends ConfigItem {
     type: 'file';
-    /** if a user can manually enter the file name and not only through select dialog */
+    /** if a user can manually enter the file name and not only through a select dialog */
     disableEdit?: boolean;
     /** limit selection to one specific object of type `meta` and the following path (not mandatory) */
     limitPath?: string;
@@ -841,7 +879,7 @@ export interface ConfigItemFile extends ConfigItem {
     allowView?: boolean;
     /** show toolbar (default true) */
     showToolbar?: boolean;
-    /** user can select only folders (e.g., for uploading path) */
+    /** user can select only folders (e.g., for the uploading path) */
     selectOnlyFolders?: boolean;
     /** trim the filename */
     trim?: boolean;
@@ -852,15 +890,15 @@ export interface ConfigItemFile extends ConfigItem {
 }
 export interface ConfigItemFileSelector extends ConfigItem {
     type: 'fileSelector';
-    /** File extension pattern. Allowed `**\/*.ext` to show all files from subfolders too, `*.ext` to show from root folder or `folderName\/*.ext` to show all files in sub-folder `folderName`. Default `**\/*.*`. */
+    /** File extension pattern. Allowed `**\/*.ext` to show all files from subfolders too, `*.ext` to show from the root folder or `folderName\/*.ext` to show all files in subfolder `folderName`. Default `**\/*.*`. */
     pattern: string;
     /** type of files: `audio`, `image`, `text` */
     fileTypes?: 'audio' | 'image' | 'text';
-    /** Object ID of type `meta`. You can use special placeholder `%INSTANCE%`: like `myAdapter.%INSTANCE%.files` */
+    /** Object ID of the type `meta`. You can use special placeholder `%INSTANCE%`: like `myAdapter.%INSTANCE%.files` */
     objectID?: string;
     /** path, where the uploaded files will be stored. Like `folderName`. If not defined, no upload field will be shown. To upload in the root, set this field to `/`. */
     upload?: string;
-    /** Show refresh button near the select. */
+    /** Show the refresh button near the select. */
     refresh?: boolean;
     /** max file size (default 2MB) */
     maxSize?: number;
@@ -873,43 +911,7 @@ export interface ConfigItemFileSelector extends ConfigItem {
     /** Do not show the size of files */
     noSize?: boolean;
 }
-export type ConfigItemAny = ConfigItemAlive | ConfigItemAutocomplete | ConfigItemAutocompleteSendTo | ConfigItemPanel | ConfigItemTabs | ConfigItemText | ConfigItemNumber | ConfigItemOAuth2 | ConfigItemColor | ConfigItemCheckbox | ConfigItemSlider | ConfigItemIP | ConfigItemInfoBox | ConfigItemUser | ConfigItemRoom | ConfigItemFunc | ConfigItemSelect | ConfigItemAccordion | ConfigItemCoordinates | ConfigItemDivider | ConfigItemHeader | ConfigItemCustom | ConfigItemDatePicker | ConfigItemDeviceManager | ConfigItemLanguage | ConfigItemPort | ConfigItemSendTo | ConfigItemState | ConfigItemTable | ConfigItemTimePicker | ConfigItemTextSendTo | ConfigItemSelectSendTo | ConfigItemCertCollection | ConfigItemCertificateSelect | ConfigItemCertificates | ConfigItemUUID | ConfigItemCheckDocker | ConfigItemCheckLicense | ConfigItemPattern | ConfigItemChip | ConfigItemCRON | ConfigItemFile | ConfigItemFileSelector | ConfigItemImageSendTo | ConfigItemInstanceSelect | ConfigItemImageUpload | ConfigItemInterface | ConfigItemJsonEditor | ConfigItemLicense | ConfigItemPassword | ConfigItemSetState | ConfigItemStaticDivider | ConfigItemStaticHeader | ConfigItemStaticInfo | ConfigItemStaticImage | ConfigItemStaticText | ConfigItemTopic | ConfigItemObjectId | ConfigItemQrCode;
-export type BackEndCommandType = 'nop' | 'refresh' | 'link' | 'message';
-export interface BackEndCommandGeneric {
-    command: BackEndCommandType;
-    /** New GUI schema */
-    schema?: ConfigItemPanel | ConfigItemTabs;
-    /** New GUI data */
-    data?: Record<string, any>;
-    refresh?: boolean;
-}
-export interface BackEndCommandNoOperation extends BackEndCommandGeneric {
-    command: 'nop';
-}
-export interface BackEndCommandRefresh extends BackEndCommandGeneric {
-    command: 'refresh';
-    /** If refresh the GUI */
-    fullRefresh?: boolean;
-}
-export interface BackEndCommandOpenLink extends BackEndCommandGeneric {
-    command: 'link';
-    /** Link url. Could be relative ('#blabla') or absolute ('https://blabla') */
-    url: string;
-    /** Target of the link. Default is `_self` for relative and '_blank' for absolute links */
-    target?: '_self' | '_blank' | string;
-    /** If GUI should be closed after the link was opened (Only for target='_self') */
-    close?: boolean;
-}
-export interface BackEndCommandMessage extends BackEndCommandGeneric {
-    command: 'message';
-    /** Message text */
-    message: ioBroker.StringOrTranslated;
-    /** If GUI should be closed after the message shown */
-    close?: boolean;
-    /** Type of message. Default is 'popup' */
-    variant: 'popup' | 'dialog';
-}
-export type BackEndCommand = BackEndCommandMessage | BackEndCommandOpenLink | BackEndCommandRefresh;
+export type ConfigItemAny = ConfigItemAlive | ConfigItemAutocomplete | ConfigItemAutocompleteSendTo | ConfigItemPanel | ConfigItemTabs | ConfigItemText | ConfigItemNumber | ConfigItemOAuth2 | ConfigItemColor | ConfigItemCheckbox | ConfigItemSlider | ConfigItemIP | ConfigItemInfoBox | ConfigItemUser | ConfigItemRoom | ConfigItemFunc | ConfigItemSelect | ConfigItemAccordion | ConfigItemCoordinates | ConfigItemDivider | ConfigItemHeader | ConfigItemCustom | ConfigItemDatePicker | ConfigItemDeviceManager | ConfigItemLanguage | ConfigItemPort | ConfigItemSendTo | ConfigItemState | ConfigItemTable | ConfigItemTimePicker | ConfigItemTextSendTo | ConfigItemSelectSendTo | ConfigItemCertCollection | ConfigItemCertificateSelect | ConfigItemCertificates | ConfigItemUUID | ConfigItemCheckDocker | ConfigItemCheckLicense | ConfigItemPattern | ConfigItemChip | ConfigItemCRON | ConfigItemFile | ConfigItemFileSelector | ConfigItemIFrame | ConfigItemIFrameSendTo | ConfigItemImageSendTo | ConfigItemInstanceSelect | ConfigItemImageUpload | ConfigItemInterface | ConfigItemJsonEditor | ConfigItemYamlEditor | ConfigItemLicense | ConfigItemPassword | ConfigItemSetState | ConfigItemStaticDivider | ConfigItemStaticHeader | ConfigItemStaticInfo | ConfigItemStaticImage | ConfigItemStaticText | ConfigItemTopic | ConfigItemObjectId | ConfigItemQrCode;
 export type ActionButton = {
     label: ioBroker.StringOrTranslated;
     type: 'apply' | 'cancel' | 'copyToClipboard';
@@ -941,8 +943,8 @@ export type BackEndCommandJsonFormOptions = {
 };
 export type JsonFormSchema = ConfigItemPanel | ConfigItemTabs;
 export type JsonFormData = Record<string, any>;
-export interface DeviceDetails {
-    id: string;
+export interface DeviceDetails<TId extends DeviceId = DeviceId> {
+    id: TId;
     schema: JsonFormSchema;
     data?: JsonFormData;
 }

package/build/types/index.d.ts

@@ -1,4 +1,4 @@
 export type * from './adapter';
+export { ACTIONS, type ChannelInfo, type Color, type ControlBase, type ControlState, type BackendToGuiCommand, type BackendToGuiCommandAllUpdate, type BackendToGuiCommandDeviceDelete, type BackendToGuiCommandDeviceStatusUpdate, type BackendToGuiCommandDeviceInfoUpdate, } from './base';
 export type * from './common';
 export * from './errorCodes';
-export { type ChannelInfo, type Color, type ControlState, type ControlBase, ACTIONS } from './base';

package/build/types/index.js

@@ -15,6 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ACTIONS = void 0;
-__exportStar(require("./errorCodes"), exports);
 var base_1 = require("./base");
 Object.defineProperty(exports, "ACTIONS", { enumerable: true, get: function () { return base_1.ACTIONS; } });
+__exportStar(require("./errorCodes"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iobroker/dm-utils",
-  "version": "2.0.1",
+  "version": "3.0.0",
   "description": "ioBroker Device Manager utilities for backend",
   "main": "build/index.js",
   "publishConfig": {
@@ -15,7 +15,7 @@
     "build": "tsc -p tsconfig.json",
     "test:package": "node -e \"process.exit(0)\"",
     "lint": "eslint -c eslint.config.mjs src",
-    "updateCommonTs": "node tasks.js",
+    "updateCommonTs": "npx -y tsx tasks.ts",
     "prettier": "prettier -u -w examples src",
     "release": "release-script",
     "release-patch": "release-script patch --yes",
@@ -30,13 +30,17 @@
     "@iobroker/adapter-core": "^3.3.2"
   },
   "devDependencies": {
-    "@alcalzone/release-script": "^5.0.0",
-    "@alcalzone/release-script-plugin-license": "^4.0.0",
+    "@iobroker/types": "^7.1.1-alpha.0-20260127-997e40b73",
+    "@alcalzone/release-script": "^5.1.1",
+    "@alcalzone/release-script-plugin-license": "^5.1.1",
     "@iobroker/eslint-config": "^2.2.0",
-    "@types/node": "^25.0.3",
-    "axios": "^1.13.2",
+    "@types/node": "^25.3.3",
+    "axios": "^1.13.6",
     "typescript": "~5.9.3"
   },
+  "overrides": {
+    "@iobroker/types": "$@iobroker/types"
+  },
   "files": [
     "LICENSE",
     "README.md",